@querykitjs/web 2.0.1 → 3.0.0

package/dist/{registry-DPIEOvLW.d.cts → registry-DbZQk28q.d.cts}

@@ -24,12 +24,15 @@ type FilterNode<T = Record<string, unknown>> = Core.FilterNode<FieldKey<T>>;
  */
 type Filter<T = Record<string, unknown>> = Core.Filter<FieldKey<T>>;
 type SortDirection = Core.SortDirection;
-interface Sort {
-    name?: string;
-    direction?: SortDirection;
-}
-/** Sort kirishi: `"-createdAt"` (sortType string) yoki `{ name, direction }`. */
-type SortInput = string | Sort;
+type SortItem = Core.SortItem;
+/** Sort — **always an array** of `{ key, direction }` (multi-field). */
+type Sort = Core.Sort;
+/**
+ * Sort input — an array where each item is a `{ key, direction }` object OR a
+ * `"-field"` / `"field"` shorthand string (`["-createdAt", "id"]`). Builders map
+ * it to the canonical {@link Sort} (`SortItem[]`).
+ */
+type SortInput = ReadonlyArray<SortItem | string>;
 interface Params<T = Record<string, unknown>> {
     filter?: Filter<T>;
     sort?: SortInput;
@@ -242,10 +245,13 @@ interface UrlConfig {
     sizeParam?: string;
     sortParam?: string;
 }
-/** `"-createdAt"` → `{ name, direction }` (bo'sh bo'lsa `undefined`). */
+/**
+ * `"-createdAt,id,-appNumber"` → `[{ key, direction }, …]` — comma-separated,
+ * order preserved, `-` prefix = `desc` (else `asc`). Empty → `undefined`.
+ */
 declare function decodeSort(value: string | null | undefined): Sort | undefined;
-/** `{ name, direction }` → `"-createdAt"` / `"createdAt"` (nomsiz bo'lsa `""`). */
-declare function encodeSort(sort: Sort): string;
+/** `[{ key, direction }, …]` (or `"-field"` shorthand strings) → `"-createdAt,id,-appNumber"` (empty → `""`). */
+declare function encodeSort(sort: SortInput): string;
 /**
  * Schema + searchParams → filter. Applies `range`/`between`/`search`/`split`/
  * `default`/`trim`; empty/absent params are dropped. Returns a flat
@@ -263,7 +269,7 @@ declare function setParam(searchParams: URLSearchParams, name: string, value: st
 declare function setPage(searchParams: URLSearchParams, page: number, url?: UrlConfig): URLSearchParams;
 /** Sahifa o'lchamini o'rnatadi va `page`ni reset qiladi. */
 declare function setSize(searchParams: URLSearchParams, size: number, url?: UrlConfig): URLSearchParams;
-/** Sortni o'rnatadi (`"-createdAt"` yoki `{name,direction}`) va `page`ni reset qiladi. */
+/** Sortni o'rnatadi (`[{ key, direction }, …]`) va `page`ni reset qiladi. */
 declare function setSort(searchParams: URLSearchParams, sort: SortInput, url?: UrlConfig): URLSearchParams;
 /** Barcha list param'larini tozalaydi (ixtiyoriy saqlanadigan kalitlar bilan). */
 declare function resetParams(searchParams: URLSearchParams, keep?: string[]): URLSearchParams;
@@ -378,7 +384,7 @@ interface RegistryDefaults {
     perPage?: number;
     /** `infinite` + `cursor` page size. */
     limit?: number;
-    /** `list`/`infinite` sort (`"-createdAt"` or `{name,direction}`). */
+    /** `list`/`infinite` sort — `[{key,direction}]` or `["-createdAt", "id"]` shorthand. */
     sort?: SortInput;
     /** Cursor-only defaults. */
     cursor?: {
@@ -407,11 +413,11 @@ interface Registry<A extends AdapterName> {
  *
  * @example
  * ```ts
- * export const qk = createRegistry({ adapter: "mongoose", defaults: { perPage: 20, sort: "-createdAt" } });
+ * export const qk = createRegistry({ adapter: "mongoose", defaults: { perPage: 20, sort: ["-createdAt"] } });
  * const users = qk.resource<IUser>("users");
  * const body = users.list({ filter: users.f.eq("status", "active"), page });
  * ```
  */
 declare function createRegistry<A extends AdapterName>(config: RegistryConfig<A>): Registry<A>;
 
-export { resetParams as $, type AdapterName as A, type ResourceCursorParams as B, type CursorParams as C, type DrizzleWith as D, type ResourceInfiniteParams as E, type Filter as F, type ResourceKeys as G, type ResourceListParams as H, type InfiniteParams as I, type ResourceParams as J, type SortDirection as K, type ListParams as L, type Meta as M, type NotGroup as N, type OrGroup as O, type Params as P, type QueryPayload as Q, type RawCursorMeta as R, type Sort as S, createFilters as T, type UrlConfig as U, createRegistry as V, type WithFor as W, decodeSort as X, defineListSchema as Y, encodeSort as Z, readListParams as _, type CursorPayload as a, schemaToFilter as a0, searchParamsToPayload as a1, setPage as a2, setParam as a3, setSize as a4, setSort as a5, type InfinitePayload as b, type ListPayload as c, type FieldCondition as d, type FilterNode as e, type SortInput as f, type AndGroup as g, type CursorMeta as h, type CursorResult as i, type FieldDescriptor as j, type FieldKey as k, type FilterOperator as l, type FilterScalar as m, type FilterValue as n, type InfiniteMeta as o, type InfiniteResult as p, type ListResult as q, type ListSchema as r, type MongoosePopulate as s, type PrismaInclude as t, type RawInfiniteMeta as u, type RawMeta as v, type Registry as w, type RegistryConfig as x, type RegistryDefaults as y, type Resource as z };
+export { readListParams as $, type AdapterName as A, type ResourceCursorParams as B, type CursorParams as C, type DrizzleWith as D, type ResourceInfiniteParams as E, type Filter as F, type ResourceKeys as G, type ResourceListParams as H, type InfiniteParams as I, type ResourceParams as J, type SortDirection as K, type ListParams as L, type Meta as M, type NotGroup as N, type OrGroup as O, type Params as P, type QueryPayload as Q, type RawCursorMeta as R, type Sort as S, type SortItem as T, type UrlConfig as U, createFilters as V, type WithFor as W, createRegistry as X, decodeSort as Y, defineListSchema as Z, encodeSort as _, type CursorPayload as a, resetParams as a0, schemaToFilter as a1, searchParamsToPayload as a2, setPage as a3, setParam as a4, setSize as a5, setSort as a6, type InfinitePayload as b, type ListPayload as c, type FieldCondition as d, type FilterNode as e, type SortInput as f, type AndGroup as g, type CursorMeta as h, type CursorResult as i, type FieldDescriptor as j, type FieldKey as k, type FilterOperator as l, type FilterScalar as m, type FilterValue as n, type InfiniteMeta as o, type InfiniteResult as p, type ListResult as q, type ListSchema as r, type MongoosePopulate as s, type PrismaInclude as t, type RawInfiniteMeta as u, type RawMeta as v, type Registry as w, type RegistryConfig as x, type RegistryDefaults as y, type Resource as z };

package/dist/{registry-DPIEOvLW.d.ts → registry-DbZQk28q.d.ts}

@@ -24,12 +24,15 @@ type FilterNode<T = Record<string, unknown>> = Core.FilterNode<FieldKey<T>>;
  */
 type Filter<T = Record<string, unknown>> = Core.Filter<FieldKey<T>>;
 type SortDirection = Core.SortDirection;
-interface Sort {
-    name?: string;
-    direction?: SortDirection;
-}
-/** Sort kirishi: `"-createdAt"` (sortType string) yoki `{ name, direction }`. */
-type SortInput = string | Sort;
+type SortItem = Core.SortItem;
+/** Sort — **always an array** of `{ key, direction }` (multi-field). */
+type Sort = Core.Sort;
+/**
+ * Sort input — an array where each item is a `{ key, direction }` object OR a
+ * `"-field"` / `"field"` shorthand string (`["-createdAt", "id"]`). Builders map
+ * it to the canonical {@link Sort} (`SortItem[]`).
+ */
+type SortInput = ReadonlyArray<SortItem | string>;
 interface Params<T = Record<string, unknown>> {
     filter?: Filter<T>;
     sort?: SortInput;
@@ -242,10 +245,13 @@ interface UrlConfig {
     sizeParam?: string;
     sortParam?: string;
 }
-/** `"-createdAt"` → `{ name, direction }` (bo'sh bo'lsa `undefined`). */
+/**
+ * `"-createdAt,id,-appNumber"` → `[{ key, direction }, …]` — comma-separated,
+ * order preserved, `-` prefix = `desc` (else `asc`). Empty → `undefined`.
+ */
 declare function decodeSort(value: string | null | undefined): Sort | undefined;
-/** `{ name, direction }` → `"-createdAt"` / `"createdAt"` (nomsiz bo'lsa `""`). */
-declare function encodeSort(sort: Sort): string;
+/** `[{ key, direction }, …]` (or `"-field"` shorthand strings) → `"-createdAt,id,-appNumber"` (empty → `""`). */
+declare function encodeSort(sort: SortInput): string;
 /**
  * Schema + searchParams → filter. Applies `range`/`between`/`search`/`split`/
  * `default`/`trim`; empty/absent params are dropped. Returns a flat
@@ -263,7 +269,7 @@ declare function setParam(searchParams: URLSearchParams, name: string, value: st
 declare function setPage(searchParams: URLSearchParams, page: number, url?: UrlConfig): URLSearchParams;
 /** Sahifa o'lchamini o'rnatadi va `page`ni reset qiladi. */
 declare function setSize(searchParams: URLSearchParams, size: number, url?: UrlConfig): URLSearchParams;
-/** Sortni o'rnatadi (`"-createdAt"` yoki `{name,direction}`) va `page`ni reset qiladi. */
+/** Sortni o'rnatadi (`[{ key, direction }, …]`) va `page`ni reset qiladi. */
 declare function setSort(searchParams: URLSearchParams, sort: SortInput, url?: UrlConfig): URLSearchParams;
 /** Barcha list param'larini tozalaydi (ixtiyoriy saqlanadigan kalitlar bilan). */
 declare function resetParams(searchParams: URLSearchParams, keep?: string[]): URLSearchParams;
@@ -378,7 +384,7 @@ interface RegistryDefaults {
     perPage?: number;
     /** `infinite` + `cursor` page size. */
     limit?: number;
-    /** `list`/`infinite` sort (`"-createdAt"` or `{name,direction}`). */
+    /** `list`/`infinite` sort — `[{key,direction}]` or `["-createdAt", "id"]` shorthand. */
     sort?: SortInput;
     /** Cursor-only defaults. */
     cursor?: {
@@ -407,11 +413,11 @@ interface Registry<A extends AdapterName> {
  *
  * @example
  * ```ts
- * export const qk = createRegistry({ adapter: "mongoose", defaults: { perPage: 20, sort: "-createdAt" } });
+ * export const qk = createRegistry({ adapter: "mongoose", defaults: { perPage: 20, sort: ["-createdAt"] } });
  * const users = qk.resource<IUser>("users");
  * const body = users.list({ filter: users.f.eq("status", "active"), page });
  * ```
  */
 declare function createRegistry<A extends AdapterName>(config: RegistryConfig<A>): Registry<A>;
 
-export { resetParams as $, type AdapterName as A, type ResourceCursorParams as B, type CursorParams as C, type DrizzleWith as D, type ResourceInfiniteParams as E, type Filter as F, type ResourceKeys as G, type ResourceListParams as H, type InfiniteParams as I, type ResourceParams as J, type SortDirection as K, type ListParams as L, type Meta as M, type NotGroup as N, type OrGroup as O, type Params as P, type QueryPayload as Q, type RawCursorMeta as R, type Sort as S, createFilters as T, type UrlConfig as U, createRegistry as V, type WithFor as W, decodeSort as X, defineListSchema as Y, encodeSort as Z, readListParams as _, type CursorPayload as a, schemaToFilter as a0, searchParamsToPayload as a1, setPage as a2, setParam as a3, setSize as a4, setSort as a5, type InfinitePayload as b, type ListPayload as c, type FieldCondition as d, type FilterNode as e, type SortInput as f, type AndGroup as g, type CursorMeta as h, type CursorResult as i, type FieldDescriptor as j, type FieldKey as k, type FilterOperator as l, type FilterScalar as m, type FilterValue as n, type InfiniteMeta as o, type InfiniteResult as p, type ListResult as q, type ListSchema as r, type MongoosePopulate as s, type PrismaInclude as t, type RawInfiniteMeta as u, type RawMeta as v, type Registry as w, type RegistryConfig as x, type RegistryDefaults as y, type Resource as z };
+export { readListParams as $, type AdapterName as A, type ResourceCursorParams as B, type CursorParams as C, type DrizzleWith as D, type ResourceInfiniteParams as E, type Filter as F, type ResourceKeys as G, type ResourceListParams as H, type InfiniteParams as I, type ResourceParams as J, type SortDirection as K, type ListParams as L, type Meta as M, type NotGroup as N, type OrGroup as O, type Params as P, type QueryPayload as Q, type RawCursorMeta as R, type Sort as S, type SortItem as T, type UrlConfig as U, createFilters as V, type WithFor as W, createRegistry as X, decodeSort as Y, defineListSchema as Z, encodeSort as _, type CursorPayload as a, resetParams as a0, schemaToFilter as a1, searchParamsToPayload as a2, setPage as a3, setParam as a4, setSize as a5, setSort as a6, type InfinitePayload as b, type ListPayload as c, type FieldCondition as d, type FilterNode as e, type SortInput as f, type AndGroup as g, type CursorMeta as h, type CursorResult as i, type FieldDescriptor as j, type FieldKey as k, type FilterOperator as l, type FilterScalar as m, type FilterValue as n, type InfiniteMeta as o, type InfiniteResult as p, type ListResult as q, type ListSchema as r, type MongoosePopulate as s, type PrismaInclude as t, type RawInfiniteMeta as u, type RawMeta as v, type Registry as w, type RegistryConfig as x, type RegistryDefaults as y, type Resource as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@querykitjs/web",
-  "version": "2.0.1",
+  "version": "3.0.0",
   "description": "Frontend query-building for querykit — typed filters, pagination params & URL sync. Zero-dependency; you send the request.",
   "type": "module",
   "author": {
@@ -50,7 +50,7 @@
     "test:smoke": "bun run test/smoke.ts"
   },
   "dependencies": {
-    "@querykitjs/core": "^1.0.0"
+    "@querykitjs/core": "^1.1.0"
   },
   "peerDependencies": {
     "react": ">=18",