docs: add package godoc and clarify public API

Prepare the extracted library for external consumption with grouped
godoc, extension point docs, and setup requirements. Wire
ErrBadCursorString into decode paths and drop redundant Paginate*Conds
aliases.

Co-authored-by: Cursor <cursoragent@cursor.com>

list_test.go

@@ -60,6 +60,7 @@ func TestConnectionFromRelayArgs(t *testing.T) {
 	bad := "{not-json"
 	_, err = ConnectionFromRelayArgs(&bad, nil, newZero, list)
 	require.Error(err)
+	require.ErrorIs(err, ErrBadCursorString)
 
 	listErr := errors.New("list failed")
 	_, err = ConnectionFromRelayArgs(nil, nil, newZero, func(*Cursor[mysql.IntegerExpression, mysql.ColumnInteger], int) (*Connection[int], error) {
@@ -105,7 +106,7 @@ func TestPageQueryRunSQLSimple(t *testing.T) {
 	)
 
 	stmt := mysql.SELECT(MeetingRoom.AllColumns).FROM(MeetingRoom)
-	stmt.WHERE(mysql.Bool(true).AND(PaginateStringConds(active)))
+	stmt.WHERE(mysql.Bool(true).AND(PaginateConds(active)))
 	stmt.ORDER_BY(OrderByClauses(active)...)
 	sql := stmt.DebugSql()
 
@@ -165,7 +166,7 @@ func TestPageQueryRunSQLFirstPageRoomDefaultCursor(t *testing.T) {
 	)
 
 	stmt := mysql.SELECT(MeetingRoom.AllColumns).FROM(MeetingRoom)
-	stmt.WHERE(mysql.Bool(true).AND(PaginateStringConds(defaultCursor)))
+	stmt.WHERE(mysql.Bool(true).AND(PaginateConds(defaultCursor)))
 	stmt.ORDER_BY(OrderByClauses(defaultCursor)...)
 	sql := stmt.DebugSql()