@querykitjs/web 1.0.0

package/dist/index.js

@@ -0,0 +1,261 @@
+import { createFilters as createFilters$1, DEFAULT_LIMIT, DEFAULT_PER_PAGE } from '@querykitjs/core';
+export { f } from '@querykitjs/core';
+
+// src/filters.ts
+function createFilters() {
+  return createFilters$1();
+}
+var DEFAULTS = {
+  filterField: "filter",
+  sortField: "sort",
+  columnsField: "columns",
+  withField: "with",
+  withDeletedField: "withDeleted",
+  pageField: "page",
+  perPageField: "perPage",
+  limitField: "limit",
+  offsetField: "offset",
+  cursorField: "cursor",
+  defaultPerPage: DEFAULT_PER_PAGE,
+  defaultLimit: DEFAULT_LIMIT,
+  defaultSort: { name: "createdAt", direction: "desc" },
+  pruneEmpty: true
+};
+function isEmptyValue(value) {
+  if (value === void 0 || value === null || value === "") return true;
+  if (Array.isArray(value) && value.length === 0) return true;
+  return false;
+}
+function normalizeSort(input, fallback) {
+  if (input === void 0 || input === "") return fallback;
+  if (typeof input === "string") {
+    const desc = input.startsWith("-");
+    return { name: desc ? input.slice(1) : input, direction: desc ? "desc" : "asc" };
+  }
+  return { name: input.name ?? fallback.name, direction: input.direction ?? fallback.direction };
+}
+function normalizeCondition(condition, prune) {
+  const operation = condition.operation ?? "=";
+  const noValue = operation === "isNull" || operation === "isNotNull";
+  const value = condition.value;
+  if (!noValue && prune && isEmptyValue(value)) return void 0;
+  const out = { key: condition.key, operation };
+  if (!noValue) out.value = value;
+  return out;
+}
+function normalizeNode(node, prune) {
+  if ("and" in node) {
+    const kids = node.and.map((n) => normalizeNode(n, prune)).filter((n) => !!n);
+    return kids.length ? { and: kids } : void 0;
+  }
+  if ("or" in node) {
+    const kids = node.or.map((n) => normalizeNode(n, prune)).filter((n) => !!n);
+    return kids.length ? { or: kids } : void 0;
+  }
+  if ("not" in node) {
+    const inner = normalizeNode(node.not, prune);
+    return inner ? { not: inner } : void 0;
+  }
+  return normalizeCondition(node, prune);
+}
+function normalizeFilter(filter, prune) {
+  if (!filter) return [];
+  if (Array.isArray(filter)) {
+    return filter.map((c) => normalizeCondition(c, prune)).filter((c) => !!c);
+  }
+  return normalizeNode(filter, prune) ?? [];
+}
+function buildBase(input, cfg) {
+  const base = {
+    [cfg.filterField]: normalizeFilter(input.filter, cfg.pruneEmpty),
+    [cfg.columnsField]: input.columns ?? {},
+    [cfg.withField]: input.with ?? {}
+  };
+  if (input.withDeleted !== void 0) base[cfg.withDeletedField] = input.withDeleted;
+  return base;
+}
+function clampInt(value, fallback) {
+  return value === void 0 || value < 1 || Number.isNaN(value) ? fallback : Math.trunc(value);
+}
+function build(input, cfg) {
+  return { ...buildBase(input, cfg), [cfg.sortField]: normalizeSort(input.sort, cfg.defaultSort) };
+}
+function buildList(input, cfg) {
+  return {
+    ...build(input, cfg),
+    [cfg.pageField]: clampInt(input.page, 1),
+    // page >= 1 (kasr/0/manfiy → 1)
+    [cfg.perPageField]: clampInt(input.perPage, cfg.defaultPerPage)
+  };
+}
+function buildInfinite(input, cfg) {
+  return {
+    ...build(input, cfg),
+    [cfg.limitField]: clampInt(input.limit, cfg.defaultLimit),
+    [cfg.offsetField]: input.offset && input.offset > 0 ? Math.trunc(input.offset) : 0
+  };
+}
+function buildCursor(input, cfg) {
+  const payload = {
+    ...buildBase(input, cfg),
+    [cfg.limitField]: clampInt(input.limit, cfg.defaultLimit),
+    [cfg.cursorField]: input.cursor ?? null,
+    order: input.order ?? "asc",
+    direction: input.direction ?? "forward"
+  };
+  if (input.cursorKey !== void 0) payload.cursorKey = input.cursorKey;
+  return payload;
+}
+function createQuery(config = {}) {
+  const cfg = { ...DEFAULTS, ...config };
+  return {
+    params: (input = {}) => build(input, cfg),
+    list: (input = {}) => buildList(input, cfg),
+    infinite: (input = {}) => buildInfinite(input, cfg),
+    cursor: (input = {}) => buildCursor(input, cfg)
+  };
+}
+function buildParams(input = {}) {
+  return build(input, DEFAULTS);
+}
+function buildListParams(input = {}) {
+  return buildList(input, DEFAULTS);
+}
+function buildInfiniteParams(input = {}) {
+  return buildInfinite(input, DEFAULTS);
+}
+function buildCursorParams(input = {}) {
+  return buildCursor(input, DEFAULTS);
+}
+
+// src/meta.ts
+function mapMeta(raw) {
+  return {
+    totalPages: raw?.total_pages ?? 0,
+    totalCount: raw?.total_items ?? 0,
+    currentPage: raw?.current_page ?? 0,
+    perPage: raw?.per_page ?? 0,
+    hasNext: raw?.has_next ?? false,
+    hasPrev: raw?.has_prev ?? false
+  };
+}
+function mapInfiniteMeta(raw) {
+  return {
+    limit: raw?.limit ?? 0,
+    offset: raw?.offset ?? 0,
+    count: raw?.count ?? 0,
+    hasMore: raw?.has_more ?? false,
+    nextOffset: raw?.next_offset ?? null
+  };
+}
+function mapCursorMeta(raw) {
+  return {
+    limit: raw?.limit ?? 0,
+    hasNext: raw?.has_next ?? false,
+    hasPrev: raw?.has_prev ?? false,
+    nextCursor: raw?.next_cursor ?? null,
+    prevCursor: raw?.prev_cursor ?? null
+  };
+}
+
+// src/schema.ts
+function defineListSchema(schema) {
+  return schema;
+}
+
+// src/url.ts
+var URL_DEFAULTS = {
+  pageParam: "page",
+  sizeParam: "size",
+  sortParam: "sortType"
+};
+function decodeSort(value) {
+  if (!value) return void 0;
+  const desc = value.startsWith("-");
+  return { name: desc ? value.slice(1) : value, direction: desc ? "desc" : "asc" };
+}
+function encodeSort(sort) {
+  if (!sort.name) return "";
+  return (sort.direction === "desc" ? "-" : "") + sort.name;
+}
+function schemaToFilter(schema, searchParams) {
+  const out = [];
+  for (const [param, descriptor] of Object.entries(schema)) {
+    const key = descriptor.key ?? param;
+    if (descriptor.range) {
+      const [fromParam, toParam] = descriptor.range;
+      const from = searchParams.get(fromParam);
+      const to = searchParams.get(toParam);
+      if (from) out.push(cond(key, ">=", from));
+      if (to) out.push(cond(key, "<=", to));
+      continue;
+    }
+    let value = searchParams.get(param);
+    if (value === null || value === "") continue;
+    if (descriptor.trim) value = value.trim();
+    if (value === "") continue;
+    out.push(cond(key, descriptor.operation ?? "=", value));
+  }
+  return out;
+}
+function cond(key, operation, value) {
+  return { key, operation, value };
+}
+function readListParams(schema, searchParams, url = {}) {
+  const cfg = { ...URL_DEFAULTS, ...url };
+  const size = searchParams.get(cfg.sizeParam);
+  return {
+    filter: schemaToFilter(schema, searchParams),
+    sort: searchParams.get(cfg.sortParam) ?? void 0,
+    page: Number(searchParams.get(cfg.pageParam)) || 1,
+    perPage: size ? Number(size) : void 0
+  };
+}
+function searchParamsToPayload(schema, searchParams, url) {
+  return buildListParams(readListParams(schema, searchParams, url));
+}
+function clone(searchParams) {
+  return new URLSearchParams(searchParams);
+}
+function setParam(searchParams, name, value, url = {}) {
+  const cfg = { ...URL_DEFAULTS, ...url };
+  const next = clone(searchParams);
+  next.delete(cfg.pageParam);
+  if (value === null || value === void 0 || value === "") next.delete(name);
+  else next.set(name, value);
+  return next;
+}
+function setPage(searchParams, page, url = {}) {
+  const cfg = { ...URL_DEFAULTS, ...url };
+  const next = clone(searchParams);
+  next.set(cfg.pageParam, String(page));
+  return next;
+}
+function setSize(searchParams, size, url = {}) {
+  const cfg = { ...URL_DEFAULTS, ...url };
+  const next = clone(searchParams);
+  next.delete(cfg.pageParam);
+  next.set(cfg.sizeParam, String(size));
+  return next;
+}
+function setSort(searchParams, sort, url = {}) {
+  const cfg = { ...URL_DEFAULTS, ...url };
+  const next = clone(searchParams);
+  next.delete(cfg.pageParam);
+  const encoded = typeof sort === "string" ? sort : encodeSort(sort);
+  if (encoded) next.set(cfg.sortParam, encoded);
+  else next.delete(cfg.sortParam);
+  return next;
+}
+function resetParams(searchParams, keep = []) {
+  const next = new URLSearchParams();
+  for (const key of keep) {
+    const value = searchParams.get(key);
+    if (value !== null) next.set(key, value);
+  }
+  return next;
+}
+
+export { buildCursorParams, buildInfiniteParams, buildListParams, buildParams, createFilters, createQuery, decodeSort, defineListSchema, encodeSort, mapCursorMeta, mapInfiniteMeta, mapMeta, normalizeFilter, normalizeSort, readListParams, resetParams, schemaToFilter, searchParamsToPayload, setPage, setParam, setSize, setSort };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/filters.ts","../src/query.ts","../src/meta.ts","../src/schema.ts","../src/url.ts"],"names":["coreCreateFilters"],"mappings":"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","file":"index.js","sourcesContent":["import { createFilters as coreCreateFilters, f } from \"@querykitjs/core\";\n\nimport type { FieldKey } from \"./types\";\n\n/**\n * Filter shartlarini tipli, ergonomik quruvchilar to'plamini qaytaradi. Entity\n * tipiga bog'lasangiz, maydon nomlari uchun autocomplete ishlaydi.\n * `@querykitjs/core`ning builder'i ustidagi qobiq.\n *\n * @typeParam T - list qilinadigan entity tipi (`Buyer`, `Product`, ...).\n * @example\n * ```ts\n * const f = createFilters<Buyer>();\n * const filter = f.and(f.contains(\"buyerName\", s), f.eq(\"status\", st));\n * ```\n */\nexport function createFilters<T = Record<string, unknown>>() {\n  return coreCreateFilters<FieldKey<T>>();\n}\n\n/** Tipsiz (entity'ga bog'lanmagan) filter quruvchilar — tez foydalanish uchun. */\nexport { f };\n","import { DEFAULT_LIMIT, DEFAULT_PER_PAGE } from \"@querykitjs/core\";\n\nimport type {\n  CursorParams,\n  CursorPayload,\n  FieldCondition,\n  Filter,\n  FilterNode,\n  FilterValue,\n  InfiniteParams,\n  InfinitePayload,\n  ListParams,\n  ListPayload,\n  Params,\n  QueryPayload,\n  Sort,\n  SortInput,\n} from \"./types\";\n\n/** {@link createQuery} sozlamalari — wire field nomlari va default qiymatlar. */\nexport interface QueryConfig {\n  filterField?: string;\n  sortField?: string;\n  columnsField?: string;\n  withField?: string;\n  withDeletedField?: string;\n  pageField?: string;\n  perPageField?: string;\n  limitField?: string;\n  offsetField?: string;\n  cursorField?: string;\n  defaultPerPage?: number;\n  defaultLimit?: number;\n  defaultSort?: Sort;\n  /** Bo'sh qiymatli filterlarni tashlash (default `true`). */\n  pruneEmpty?: boolean;\n}\n\nconst DEFAULTS: Required<QueryConfig> = {\n  filterField: \"filter\",\n  sortField: \"sort\",\n  columnsField: \"columns\",\n  withField: \"with\",\n  withDeletedField: \"withDeleted\",\n  pageField: \"page\",\n  perPageField: \"perPage\",\n  limitField: \"limit\",\n  offsetField: \"offset\",\n  cursorField: \"cursor\",\n  defaultPerPage: DEFAULT_PER_PAGE,\n  defaultLimit: DEFAULT_LIMIT,\n  defaultSort: { name: \"createdAt\", direction: \"desc\" },\n  pruneEmpty: true,\n};\n\n/** Bo'sh (yuborilmaydigan) qiymatmi: undefined/null/\"\"/[] . `false`/`0` — bo'sh emas. */\nfunction isEmptyValue(value: FilterValue | undefined): boolean {\n  if (value === undefined || value === null || value === \"\") return true;\n  if (Array.isArray(value) && value.length === 0) return true;\n  return false;\n}\n\n/** `\"-createdAt\"` yoki `{ name, direction }` → `{ name, direction }`. */\nexport function normalizeSort(input: SortInput | undefined, fallback: Sort): Sort {\n  if (input === undefined || input === \"\") return fallback;\n  if (typeof input === \"string\") {\n    const desc = input.startsWith(\"-\");\n    return { name: desc ? input.slice(1) : input, direction: desc ? \"desc\" : \"asc\" };\n  }\n  return { name: input.name ?? fallback.name, direction: input.direction ?? fallback.direction };\n}\n\nfunction normalizeCondition(condition: FieldCondition, prune: boolean): FieldCondition | undefined {\n  const operation = condition.operation ?? \"=\";\n  const noValue = operation === \"isNull\" || operation === \"isNotNull\";\n  const value = condition.value as FilterValue;\n\n  if (!noValue && prune && isEmptyValue(value)) return undefined;\n\n  const out: FieldCondition = { key: condition.key, operation };\n  if (!noValue) out.value = value;\n  return out;\n}\n\nfunction normalizeNode(node: FilterNode, prune: boolean): FilterNode | undefined {\n  if (\"and\" in node) {\n    const kids = node.and.map(n => normalizeNode(n, prune)).filter((n): n is FilterNode => !!n);\n    return kids.length ? { and: kids } : undefined;\n  }\n  if (\"or\" in node) {\n    const kids = node.or.map(n => normalizeNode(n, prune)).filter((n): n is FilterNode => !!n);\n    return kids.length ? { or: kids } : undefined;\n  }\n  if (\"not\" in node) {\n    const inner = normalizeNode(node.not, prune);\n    return inner ? { not: inner } : undefined;\n  }\n  return normalizeCondition(node, prune);\n}\n\n/** Filterni normalizatsiya qiladi: bo'sh shartlarni prune. Massiv → flat massiv. */\nexport function normalizeFilter(filter: Filter | undefined, prune: boolean): FieldCondition[] | FilterNode {\n  if (!filter) return [];\n  if (Array.isArray(filter)) {\n    return filter.map(c => normalizeCondition(c, prune)).filter((c): c is FieldCondition => !!c);\n  }\n  return normalizeNode(filter, prune) ?? [];\n}\n\n/** Umumiy qism: filter/columns/with (+ withDeleted). Sort qo'shilmaydi. */\nfunction buildBase(input: Params, cfg: Required<QueryConfig>): Record<string, unknown> {\n  const base: Record<string, unknown> = {\n    [cfg.filterField]: normalizeFilter(input.filter, cfg.pruneEmpty),\n    [cfg.columnsField]: input.columns ?? {},\n    [cfg.withField]: input.with ?? {},\n  };\n  if (input.withDeleted !== undefined) base[cfg.withDeletedField] = input.withDeleted;\n  return base;\n}\n\nfunction clampInt(value: number | undefined, fallback: number): number {\n  return value === undefined || value < 1 || Number.isNaN(value) ? fallback : Math.trunc(value);\n}\n\nfunction build(input: Params, cfg: Required<QueryConfig>): Record<string, unknown> {\n  return { ...buildBase(input, cfg), [cfg.sortField]: normalizeSort(input.sort, cfg.defaultSort) };\n}\n\nfunction buildList(input: ListParams, cfg: Required<QueryConfig>): Record<string, unknown> {\n  return {\n    ...build(input, cfg),\n    [cfg.pageField]: clampInt(input.page, 1), // page >= 1 (kasr/0/manfiy → 1)\n    [cfg.perPageField]: clampInt(input.perPage, cfg.defaultPerPage),\n  };\n}\n\nfunction buildInfinite(input: InfiniteParams, cfg: Required<QueryConfig>): Record<string, unknown> {\n  return {\n    ...build(input, cfg),\n    [cfg.limitField]: clampInt(input.limit, cfg.defaultLimit),\n    [cfg.offsetField]: input.offset && input.offset > 0 ? Math.trunc(input.offset) : 0,\n  };\n}\n\nfunction buildCursor(input: CursorParams, cfg: Required<QueryConfig>): Record<string, unknown> {\n  const payload: Record<string, unknown> = {\n    ...buildBase(input, cfg),\n    [cfg.limitField]: clampInt(input.limit, cfg.defaultLimit),\n    [cfg.cursorField]: input.cursor ?? null,\n    order: input.order ?? \"asc\",\n    direction: input.direction ?? \"forward\",\n  };\n  if (input.cursorKey !== undefined) payload.cursorKey = input.cursorKey;\n  return payload;\n}\n\n/**\n * Config bilan bog'langan query quruvchilarni qaytaradi. Boshqa backend field\n * nomlari (masalan `perPage`, `withPopulates`) uchun.\n *\n * @example\n * ```ts\n * const q = createQuery({ withField: \"withPopulates\", defaultPerPage: 20 });\n * const params = q.list({ filter, page, perPage });\n * ```\n */\nexport function createQuery(config: QueryConfig = {}) {\n  const cfg = { ...DEFAULTS, ...config };\n  return {\n    params: (input: Params = {}) => build(input, cfg),\n    list: (input: ListParams = {}) => buildList(input, cfg),\n    infinite: (input: InfiniteParams = {}) => buildInfinite(input, cfg),\n    cursor: (input: CursorParams = {}) => buildCursor(input, cfg),\n  };\n}\n\n/**\n * Params'ni normalizatsiya qiladi (paginatsiyasiz): filter prune, sort decode,\n * `with`/`columns` pass-through. Default querykit wire-format.\n *\n * @example\n * ```ts\n * const payload = buildParams({\n *   filter: [{ key: \"name\", operation: \"%_%\", value: s }],\n *   sort: \"-createdAt\",\n *   with: { supervisor: true },\n * });\n * ```\n */\nexport function buildParams(input: Params = {}): QueryPayload {\n  return build(input, DEFAULTS) as unknown as QueryPayload;\n}\n\n/**\n * {@link buildParams} + `page`/`perPage` (default `perPage = 20`, `@querykitjs/core`).\n *\n * @example\n * ```ts\n * const payload = buildListParams({ filter, sort: \"-createdAt\", page: 2, perPage: 20 });\n * // -> { filter, sort:{name,direction}, columns, with, page, perPage }\n * ```\n */\nexport function buildListParams(input: ListParams = {}): ListPayload {\n  return buildList(input, DEFAULTS) as unknown as ListPayload;\n}\n\n/**\n * Infinite-scroll payload — {@link buildParams} + `limit`/`offset` (default\n * `limit = 20`).\n *\n * @example\n * ```ts\n * const payload = buildInfiniteParams({ filter, limit: 20, offset: 40 });\n * // -> { filter, sort, columns, with, limit, offset }\n * ```\n */\nexport function buildInfiniteParams(input: InfiniteParams = {}): InfinitePayload {\n  return buildInfinite(input, DEFAULTS) as unknown as InfinitePayload;\n}\n\n/**\n * Cursor (keyset) payload — `sort` o'rniga `order`/`direction`. `cursor`\n * oldingi javob meta'sidagi `next_cursor`/`prev_cursor` tokeni.\n *\n * @example\n * ```ts\n * const payload = buildCursorParams({ filter, limit: 20, cursor, order: \"asc\" });\n * // -> { filter, columns, with, limit, cursor, order, direction }\n * ```\n */\nexport function buildCursorParams(input: CursorParams = {}): CursorPayload {\n  return buildCursor(input, DEFAULTS) as unknown as CursorPayload;\n}\n","import type { CursorMeta, InfiniteMeta, Meta, RawCursorMeta, RawInfiniteMeta, RawMeta } from \"./types\";\n\n/**\n * **Offset** (list) meta'sini snake_case → camelCase map qiladi.\n *\n * @example\n * ```ts\n * const { data, meta } = (await http.post(\"/buyers/list\", params)).data;\n * setMeta(mapMeta(meta)); // { totalPages, totalCount, currentPage, perPage, hasNext, hasPrev }\n * ```\n */\nexport function mapMeta(raw?: RawMeta | null): Meta {\n  return {\n    totalPages: raw?.total_pages ?? 0,\n    totalCount: raw?.total_items ?? 0,\n    currentPage: raw?.current_page ?? 0,\n    perPage: raw?.per_page ?? 0,\n    hasNext: raw?.has_next ?? false,\n    hasPrev: raw?.has_prev ?? false,\n  };\n}\n\n/**\n * **Infinite-scroll** meta'sini map qiladi.\n *\n * @example\n * ```ts\n * const m = mapInfiniteMeta(res.meta); // { limit, offset, count, hasMore, nextOffset }\n * if (m.hasMore) load(m.nextOffset);\n * ```\n */\nexport function mapInfiniteMeta(raw?: RawInfiniteMeta | null): InfiniteMeta {\n  return {\n    limit: raw?.limit ?? 0,\n    offset: raw?.offset ?? 0,\n    count: raw?.count ?? 0,\n    hasMore: raw?.has_more ?? false,\n    nextOffset: raw?.next_offset ?? null,\n  };\n}\n\n/**\n * **Cursor** (keyset) meta'sini map qiladi.\n *\n * @example\n * ```ts\n * const m = mapCursorMeta(res.meta); // { limit, hasNext, hasPrev, nextCursor, prevCursor }\n * ```\n */\nexport function mapCursorMeta(raw?: RawCursorMeta | null): CursorMeta {\n  return {\n    limit: raw?.limit ?? 0,\n    hasNext: raw?.has_next ?? false,\n    hasPrev: raw?.has_prev ?? false,\n    nextCursor: raw?.next_cursor ?? null,\n    prevCursor: raw?.prev_cursor ?? null,\n  };\n}\n","import type { FilterOperator } from \"./types\";\n\n/**\n * Bitta list maydonining deklarativ ta'rifi: URL param → filter shartiga qanday\n * aylantirilishi. `key` berilmasa param nomi ishlatiladi; `operation` default `=`.\n */\nexport interface FieldDescriptor {\n  /** Backend ustun kaliti (default — schema'dagi param nomi). */\n  key?: string;\n  /** Filter operatori (default `\"=\"`). */\n  operation?: FilterOperator;\n  /** String qiymatni trim qilish. */\n  trim?: boolean;\n  /** Diapazon: `[fromParam, toParam]` URL param nomlari → `>=` va `<=` shartlar. */\n  range?: [string, string];\n}\n\n/** URL param → {@link FieldDescriptor} tavsiflar to'plami. */\nexport type ListSchema = Record<string, FieldDescriptor>;\n\n/**\n * List filter schema'sini e'lon qiladi (identity helper — tiplarni saqlaydi).\n * URL param'larni `{key, operation}` shartlariga bog'laydi, shu bilan har\n * sahifada qo'lda `IFilter[]` qurishni bartaraf qiladi.\n *\n * @example\n * ```ts\n * const buyersSchema = defineListSchema({\n *   id: { operation: \"=\" },\n *   buyerName: { operation: \"%_%\", trim: true },\n *   status: { operation: \"=\" },\n *   createdAt: { range: [\"fromDate\", \"toDate\"] },\n * });\n * ```\n */\nexport function defineListSchema<S extends ListSchema>(schema: S): S {\n  return schema;\n}\n","import { buildListParams } from \"./query\";\nimport type { FieldDescriptor, ListSchema } from \"./schema\";\nimport type { FieldCondition, ListParams, ListPayload, Sort, SortInput } from \"./types\";\n\n/** URL param nomlari (sahifa/o'lcham/sort) — sozlanadigan. */\nexport interface UrlConfig {\n  pageParam?: string;\n  sizeParam?: string;\n  sortParam?: string;\n}\n\nconst URL_DEFAULTS: Required<UrlConfig> = {\n  pageParam: \"page\",\n  sizeParam: \"size\",\n  sortParam: \"sortType\",\n};\n\n/** `\"-createdAt\"` → `{ name, direction }` (bo'sh bo'lsa `undefined`). */\nexport function decodeSort(value: string | null | undefined): Sort | undefined {\n  if (!value) return undefined;\n  const desc = value.startsWith(\"-\");\n  return { name: desc ? value.slice(1) : value, direction: desc ? \"desc\" : \"asc\" };\n}\n\n/** `{ name, direction }` → `\"-createdAt\"` / `\"createdAt\"` (nomsiz bo'lsa `\"\"`). */\nexport function encodeSort(sort: Sort): string {\n  if (!sort.name) return \"\";\n  return (sort.direction === \"desc\" ? \"-\" : \"\") + sort.name;\n}\n\n/** Schema + searchParams → `FieldCondition[]` (bo'sh param'lar tashlanadi). */\nexport function schemaToFilter(schema: ListSchema, searchParams: URLSearchParams): FieldCondition[] {\n  const out: FieldCondition[] = [];\n\n  for (const [param, descriptor] of Object.entries(schema) as [string, FieldDescriptor][]) {\n    const key = descriptor.key ?? param;\n\n    if (descriptor.range) {\n      const [fromParam, toParam] = descriptor.range;\n      const from = searchParams.get(fromParam);\n      const to = searchParams.get(toParam);\n      if (from) out.push(cond(key, \">=\", from));\n      if (to) out.push(cond(key, \"<=\", to));\n      continue;\n    }\n\n    let value = searchParams.get(param);\n    if (value === null || value === \"\") continue;\n    if (descriptor.trim) value = value.trim();\n    if (value === \"\") continue;\n    out.push(cond(key, descriptor.operation ?? \"=\", value));\n  }\n\n  return out;\n}\n\nfunction cond(key: string, operation: FieldCondition[\"operation\"], value: string): FieldCondition {\n  return { key, operation, value };\n}\n\n/** searchParams → normalizatsiyalanmagan {@link ListParams} (filter/sort/page/perPage). */\nexport function readListParams(schema: ListSchema, searchParams: URLSearchParams, url: UrlConfig = {}): ListParams {\n  const cfg = { ...URL_DEFAULTS, ...url };\n  const size = searchParams.get(cfg.sizeParam);\n  return {\n    filter: schemaToFilter(schema, searchParams),\n    sort: searchParams.get(cfg.sortParam) ?? undefined,\n    page: Number(searchParams.get(cfg.pageParam)) || 1,\n    perPage: size ? Number(size) : undefined,\n  };\n}\n\n/** searchParams → to'liq, yuborishga tayyor {@link ListPayload}. */\nexport function searchParamsToPayload(schema: ListSchema, searchParams: URLSearchParams, url?: UrlConfig): ListPayload {\n  return buildListParams(readListParams(schema, searchParams, url));\n}\n\n/* ------------------------- URL yozish (immutable) ------------------------- */\n/* Har biri YANGI URLSearchParams qaytaradi; filter/sort o'zgarsa `page` reset. */\n\nfunction clone(searchParams: URLSearchParams): URLSearchParams {\n  return new URLSearchParams(searchParams);\n}\n\n/** Filter param'ini o'rnatadi/o'chiradi va `page`ni reset qiladi. */\nexport function setParam(searchParams: URLSearchParams, name: string, value: string | null | undefined, url: UrlConfig = {}): URLSearchParams {\n  const cfg = { ...URL_DEFAULTS, ...url };\n  const next = clone(searchParams);\n  next.delete(cfg.pageParam);\n  if (value === null || value === undefined || value === \"\") next.delete(name);\n  else next.set(name, value);\n  return next;\n}\n\n/** Sahifani o'rnatadi (`page` reset qilinmaydi). */\nexport function setPage(searchParams: URLSearchParams, page: number, url: UrlConfig = {}): URLSearchParams {\n  const cfg = { ...URL_DEFAULTS, ...url };\n  const next = clone(searchParams);\n  next.set(cfg.pageParam, String(page));\n  return next;\n}\n\n/** Sahifa o'lchamini o'rnatadi va `page`ni reset qiladi. */\nexport function setSize(searchParams: URLSearchParams, size: number, url: UrlConfig = {}): URLSearchParams {\n  const cfg = { ...URL_DEFAULTS, ...url };\n  const next = clone(searchParams);\n  next.delete(cfg.pageParam);\n  next.set(cfg.sizeParam, String(size));\n  return next;\n}\n\n/** Sortni o'rnatadi (`\"-createdAt\"` yoki `{name,direction}`) va `page`ni reset qiladi. */\nexport function setSort(searchParams: URLSearchParams, sort: SortInput, url: UrlConfig = {}): URLSearchParams {\n  const cfg = { ...URL_DEFAULTS, ...url };\n  const next = clone(searchParams);\n  next.delete(cfg.pageParam);\n  const encoded = typeof sort === \"string\" ? sort : encodeSort(sort);\n  if (encoded) next.set(cfg.sortParam, encoded);\n  else next.delete(cfg.sortParam);\n  return next;\n}\n\n/** Barcha list param'larini tozalaydi (ixtiyoriy saqlanadigan kalitlar bilan). */\nexport function resetParams(searchParams: URLSearchParams, keep: string[] = []): URLSearchParams {\n  const next = new URLSearchParams();\n  for (const key of keep) {\n    const value = searchParams.get(key);\n    if (value !== null) next.set(key, value);\n  }\n  return next;\n}\n"]}

package/dist/react/index.cjs

@@ -0,0 +1,195 @@
+'use strict';
+
+var react = require('react');
+var core = require('@querykitjs/core');
+
+// src/react/use-list-params.ts
+var DEFAULTS = {
+  filterField: "filter",
+  sortField: "sort",
+  columnsField: "columns",
+  withField: "with",
+  withDeletedField: "withDeleted",
+  pageField: "page",
+  perPageField: "perPage",
+  defaultPerPage: core.DEFAULT_PER_PAGE,
+  defaultSort: { name: "createdAt", direction: "desc" },
+  pruneEmpty: true
+};
+function isEmptyValue(value) {
+  if (value === void 0 || value === null || value === "") return true;
+  if (Array.isArray(value) && value.length === 0) return true;
+  return false;
+}
+function normalizeSort(input, fallback) {
+  if (input === void 0 || input === "") return fallback;
+  if (typeof input === "string") {
+    const desc = input.startsWith("-");
+    return { name: desc ? input.slice(1) : input, direction: desc ? "desc" : "asc" };
+  }
+  return { name: input.name ?? fallback.name, direction: input.direction ?? fallback.direction };
+}
+function normalizeCondition(condition, prune) {
+  const operation = condition.operation ?? "=";
+  const noValue = operation === "isNull" || operation === "isNotNull";
+  const value = condition.value;
+  if (!noValue && prune && isEmptyValue(value)) return void 0;
+  const out = { key: condition.key, operation };
+  if (!noValue) out.value = value;
+  return out;
+}
+function normalizeNode(node, prune) {
+  if ("and" in node) {
+    const kids = node.and.map((n) => normalizeNode(n, prune)).filter((n) => !!n);
+    return kids.length ? { and: kids } : void 0;
+  }
+  if ("or" in node) {
+    const kids = node.or.map((n) => normalizeNode(n, prune)).filter((n) => !!n);
+    return kids.length ? { or: kids } : void 0;
+  }
+  if ("not" in node) {
+    const inner = normalizeNode(node.not, prune);
+    return inner ? { not: inner } : void 0;
+  }
+  return normalizeCondition(node, prune);
+}
+function normalizeFilter(filter, prune) {
+  if (!filter) return [];
+  if (Array.isArray(filter)) {
+    return filter.map((c) => normalizeCondition(c, prune)).filter((c) => !!c);
+  }
+  return normalizeNode(filter, prune) ?? [];
+}
+function buildBase(input, cfg) {
+  const base = {
+    [cfg.filterField]: normalizeFilter(input.filter, cfg.pruneEmpty),
+    [cfg.columnsField]: input.columns ?? {},
+    [cfg.withField]: input.with ?? {}
+  };
+  if (input.withDeleted !== void 0) base[cfg.withDeletedField] = input.withDeleted;
+  return base;
+}
+function clampInt(value, fallback) {
+  return value === void 0 || value < 1 || Number.isNaN(value) ? fallback : Math.trunc(value);
+}
+function build(input, cfg) {
+  return { ...buildBase(input, cfg), [cfg.sortField]: normalizeSort(input.sort, cfg.defaultSort) };
+}
+function buildList(input, cfg) {
+  return {
+    ...build(input, cfg),
+    [cfg.pageField]: clampInt(input.page, 1),
+    // page >= 1 (kasr/0/manfiy → 1)
+    [cfg.perPageField]: clampInt(input.perPage, cfg.defaultPerPage)
+  };
+}
+function buildListParams(input = {}) {
+  return buildList(input, DEFAULTS);
+}
+
+// src/url.ts
+var URL_DEFAULTS = {
+  pageParam: "page",
+  sizeParam: "size",
+  sortParam: "sortType"
+};
+function encodeSort(sort) {
+  if (!sort.name) return "";
+  return (sort.direction === "desc" ? "-" : "") + sort.name;
+}
+function schemaToFilter(schema, searchParams) {
+  const out = [];
+  for (const [param, descriptor] of Object.entries(schema)) {
+    const key = descriptor.key ?? param;
+    if (descriptor.range) {
+      const [fromParam, toParam] = descriptor.range;
+      const from = searchParams.get(fromParam);
+      const to = searchParams.get(toParam);
+      if (from) out.push(cond(key, ">=", from));
+      if (to) out.push(cond(key, "<=", to));
+      continue;
+    }
+    let value = searchParams.get(param);
+    if (value === null || value === "") continue;
+    if (descriptor.trim) value = value.trim();
+    if (value === "") continue;
+    out.push(cond(key, descriptor.operation ?? "=", value));
+  }
+  return out;
+}
+function cond(key, operation, value) {
+  return { key, operation, value };
+}
+function readListParams(schema, searchParams, url = {}) {
+  const cfg = { ...URL_DEFAULTS, ...url };
+  const size = searchParams.get(cfg.sizeParam);
+  return {
+    filter: schemaToFilter(schema, searchParams),
+    sort: searchParams.get(cfg.sortParam) ?? void 0,
+    page: Number(searchParams.get(cfg.pageParam)) || 1,
+    perPage: size ? Number(size) : void 0
+  };
+}
+function searchParamsToPayload(schema, searchParams, url) {
+  return buildListParams(readListParams(schema, searchParams, url));
+}
+function clone(searchParams) {
+  return new URLSearchParams(searchParams);
+}
+function setParam(searchParams, name, value, url = {}) {
+  const cfg = { ...URL_DEFAULTS, ...url };
+  const next = clone(searchParams);
+  next.delete(cfg.pageParam);
+  if (value === null || value === void 0 || value === "") next.delete(name);
+  else next.set(name, value);
+  return next;
+}
+function setPage(searchParams, page, url = {}) {
+  const cfg = { ...URL_DEFAULTS, ...url };
+  const next = clone(searchParams);
+  next.set(cfg.pageParam, String(page));
+  return next;
+}
+function setSize(searchParams, size, url = {}) {
+  const cfg = { ...URL_DEFAULTS, ...url };
+  const next = clone(searchParams);
+  next.delete(cfg.pageParam);
+  next.set(cfg.sizeParam, String(size));
+  return next;
+}
+function setSort(searchParams, sort, url = {}) {
+  const cfg = { ...URL_DEFAULTS, ...url };
+  const next = clone(searchParams);
+  next.delete(cfg.pageParam);
+  const encoded = typeof sort === "string" ? sort : encodeSort(sort);
+  if (encoded) next.set(cfg.sortParam, encoded);
+  else next.delete(cfg.sortParam);
+  return next;
+}
+function resetParams(searchParams, keep = []) {
+  const next = new URLSearchParams();
+  for (const key of keep) {
+    const value = searchParams.get(key);
+    if (value !== null) next.set(key, value);
+  }
+  return next;
+}
+
+// src/react/use-list-params.ts
+function useListParams(options) {
+  const { searchParams, setSearchParams, schema, url } = options;
+  const params = react.useMemo(() => searchParamsToPayload(schema, searchParams, url), [schema, searchParams, url]);
+  return {
+    params,
+    searchParams,
+    setParam: react.useCallback((name, value) => setSearchParams(setParam(searchParams, name, value, url)), [searchParams, setSearchParams, url]),
+    setPage: react.useCallback((page) => setSearchParams(setPage(searchParams, page, url)), [searchParams, setSearchParams, url]),
+    setSize: react.useCallback((size) => setSearchParams(setSize(searchParams, size, url)), [searchParams, setSearchParams, url]),
+    setSort: react.useCallback((sort) => setSearchParams(setSort(searchParams, sort, url)), [searchParams, setSearchParams, url]),
+    reset: react.useCallback((keep) => setSearchParams(resetParams(searchParams, keep)), [searchParams, setSearchParams])
+  };
+}
+
+exports.useListParams = useListParams;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/react/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/query.ts","../../src/url.ts","../../src/react/use-list-params.ts"],"names":["DEFAULT_PER_PAGE","useMemo","useCallback"],"mappings":"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","file":"index.cjs","sourcesContent":["import { DEFAULT_LIMIT, DEFAULT_PER_PAGE } from \"@querykitjs/core\";\n\nimport type {\n  CursorParams,\n  CursorPayload,\n  FieldCondition,\n  Filter,\n  FilterNode,\n  FilterValue,\n  InfiniteParams,\n  InfinitePayload,\n  ListParams,\n  ListPayload,\n  Params,\n  QueryPayload,\n  Sort,\n  SortInput,\n} from \"./types\";\n\n/** {@link createQuery} sozlamalari — wire field nomlari va default qiymatlar. */\nexport interface QueryConfig {\n  filterField?: string;\n  sortField?: string;\n  columnsField?: string;\n  withField?: string;\n  withDeletedField?: string;\n  pageField?: string;\n  perPageField?: string;\n  limitField?: string;\n  offsetField?: string;\n  cursorField?: string;\n  defaultPerPage?: number;\n  defaultLimit?: number;\n  defaultSort?: Sort;\n  /** Bo'sh qiymatli filterlarni tashlash (default `true`). */\n  pruneEmpty?: boolean;\n}\n\nconst DEFAULTS: Required<QueryConfig> = {\n  filterField: \"filter\",\n  sortField: \"sort\",\n  columnsField: \"columns\",\n  withField: \"with\",\n  withDeletedField: \"withDeleted\",\n  pageField: \"page\",\n  perPageField: \"perPage\",\n  limitField: \"limit\",\n  offsetField: \"offset\",\n  cursorField: \"cursor\",\n  defaultPerPage: DEFAULT_PER_PAGE,\n  defaultLimit: DEFAULT_LIMIT,\n  defaultSort: { name: \"createdAt\", direction: \"desc\" },\n  pruneEmpty: true,\n};\n\n/** Bo'sh (yuborilmaydigan) qiymatmi: undefined/null/\"\"/[] . `false`/`0` — bo'sh emas. */\nfunction isEmptyValue(value: FilterValue | undefined): boolean {\n  if (value === undefined || value === null || value === \"\") return true;\n  if (Array.isArray(value) && value.length === 0) return true;\n  return false;\n}\n\n/** `\"-createdAt\"` yoki `{ name, direction }` → `{ name, direction }`. */\nexport function normalizeSort(input: SortInput | undefined, fallback: Sort): Sort {\n  if (input === undefined || input === \"\") return fallback;\n  if (typeof input === \"string\") {\n    const desc = input.startsWith(\"-\");\n    return { name: desc ? input.slice(1) : input, direction: desc ? \"desc\" : \"asc\" };\n  }\n  return { name: input.name ?? fallback.name, direction: input.direction ?? fallback.direction };\n}\n\nfunction normalizeCondition(condition: FieldCondition, prune: boolean): FieldCondition | undefined {\n  const operation = condition.operation ?? \"=\";\n  const noValue = operation === \"isNull\" || operation === \"isNotNull\";\n  const value = condition.value as FilterValue;\n\n  if (!noValue && prune && isEmptyValue(value)) return undefined;\n\n  const out: FieldCondition = { key: condition.key, operation };\n  if (!noValue) out.value = value;\n  return out;\n}\n\nfunction normalizeNode(node: FilterNode, prune: boolean): FilterNode | undefined {\n  if (\"and\" in node) {\n    const kids = node.and.map(n => normalizeNode(n, prune)).filter((n): n is FilterNode => !!n);\n    return kids.length ? { and: kids } : undefined;\n  }\n  if (\"or\" in node) {\n    const kids = node.or.map(n => normalizeNode(n, prune)).filter((n): n is FilterNode => !!n);\n    return kids.length ? { or: kids } : undefined;\n  }\n  if (\"not\" in node) {\n    const inner = normalizeNode(node.not, prune);\n    return inner ? { not: inner } : undefined;\n  }\n  return normalizeCondition(node, prune);\n}\n\n/** Filterni normalizatsiya qiladi: bo'sh shartlarni prune. Massiv → flat massiv. */\nexport function normalizeFilter(filter: Filter | undefined, prune: boolean): FieldCondition[] | FilterNode {\n  if (!filter) return [];\n  if (Array.isArray(filter)) {\n    return filter.map(c => normalizeCondition(c, prune)).filter((c): c is FieldCondition => !!c);\n  }\n  return normalizeNode(filter, prune) ?? [];\n}\n\n/** Umumiy qism: filter/columns/with (+ withDeleted). Sort qo'shilmaydi. */\nfunction buildBase(input: Params, cfg: Required<QueryConfig>): Record<string, unknown> {\n  const base: Record<string, unknown> = {\n    [cfg.filterField]: normalizeFilter(input.filter, cfg.pruneEmpty),\n    [cfg.columnsField]: input.columns ?? {},\n    [cfg.withField]: input.with ?? {},\n  };\n  if (input.withDeleted !== undefined) base[cfg.withDeletedField] = input.withDeleted;\n  return base;\n}\n\nfunction clampInt(value: number | undefined, fallback: number): number {\n  return value === undefined || value < 1 || Number.isNaN(value) ? fallback : Math.trunc(value);\n}\n\nfunction build(input: Params, cfg: Required<QueryConfig>): Record<string, unknown> {\n  return { ...buildBase(input, cfg), [cfg.sortField]: normalizeSort(input.sort, cfg.defaultSort) };\n}\n\nfunction buildList(input: ListParams, cfg: Required<QueryConfig>): Record<string, unknown> {\n  return {\n    ...build(input, cfg),\n    [cfg.pageField]: clampInt(input.page, 1), // page >= 1 (kasr/0/manfiy → 1)\n    [cfg.perPageField]: clampInt(input.perPage, cfg.defaultPerPage),\n  };\n}\n\nfunction buildInfinite(input: InfiniteParams, cfg: Required<QueryConfig>): Record<string, unknown> {\n  return {\n    ...build(input, cfg),\n    [cfg.limitField]: clampInt(input.limit, cfg.defaultLimit),\n    [cfg.offsetField]: input.offset && input.offset > 0 ? Math.trunc(input.offset) : 0,\n  };\n}\n\nfunction buildCursor(input: CursorParams, cfg: Required<QueryConfig>): Record<string, unknown> {\n  const payload: Record<string, unknown> = {\n    ...buildBase(input, cfg),\n    [cfg.limitField]: clampInt(input.limit, cfg.defaultLimit),\n    [cfg.cursorField]: input.cursor ?? null,\n    order: input.order ?? \"asc\",\n    direction: input.direction ?? \"forward\",\n  };\n  if (input.cursorKey !== undefined) payload.cursorKey = input.cursorKey;\n  return payload;\n}\n\n/**\n * Config bilan bog'langan query quruvchilarni qaytaradi. Boshqa backend field\n * nomlari (masalan `perPage`, `withPopulates`) uchun.\n *\n * @example\n * ```ts\n * const q = createQuery({ withField: \"withPopulates\", defaultPerPage: 20 });\n * const params = q.list({ filter, page, perPage });\n * ```\n */\nexport function createQuery(config: QueryConfig = {}) {\n  const cfg = { ...DEFAULTS, ...config };\n  return {\n    params: (input: Params = {}) => build(input, cfg),\n    list: (input: ListParams = {}) => buildList(input, cfg),\n    infinite: (input: InfiniteParams = {}) => buildInfinite(input, cfg),\n    cursor: (input: CursorParams = {}) => buildCursor(input, cfg),\n  };\n}\n\n/**\n * Params'ni normalizatsiya qiladi (paginatsiyasiz): filter prune, sort decode,\n * `with`/`columns` pass-through. Default querykit wire-format.\n *\n * @example\n * ```ts\n * const payload = buildParams({\n *   filter: [{ key: \"name\", operation: \"%_%\", value: s }],\n *   sort: \"-createdAt\",\n *   with: { supervisor: true },\n * });\n * ```\n */\nexport function buildParams(input: Params = {}): QueryPayload {\n  return build(input, DEFAULTS) as unknown as QueryPayload;\n}\n\n/**\n * {@link buildParams} + `page`/`perPage` (default `perPage = 20`, `@querykitjs/core`).\n *\n * @example\n * ```ts\n * const payload = buildListParams({ filter, sort: \"-createdAt\", page: 2, perPage: 20 });\n * // -> { filter, sort:{name,direction}, columns, with, page, perPage }\n * ```\n */\nexport function buildListParams(input: ListParams = {}): ListPayload {\n  return buildList(input, DEFAULTS) as unknown as ListPayload;\n}\n\n/**\n * Infinite-scroll payload — {@link buildParams} + `limit`/`offset` (default\n * `limit = 20`).\n *\n * @example\n * ```ts\n * const payload = buildInfiniteParams({ filter, limit: 20, offset: 40 });\n * // -> { filter, sort, columns, with, limit, offset }\n * ```\n */\nexport function buildInfiniteParams(input: InfiniteParams = {}): InfinitePayload {\n  return buildInfinite(input, DEFAULTS) as unknown as InfinitePayload;\n}\n\n/**\n * Cursor (keyset) payload — `sort` o'rniga `order`/`direction`. `cursor`\n * oldingi javob meta'sidagi `next_cursor`/`prev_cursor` tokeni.\n *\n * @example\n * ```ts\n * const payload = buildCursorParams({ filter, limit: 20, cursor, order: \"asc\" });\n * // -> { filter, columns, with, limit, cursor, order, direction }\n * ```\n */\nexport function buildCursorParams(input: CursorParams = {}): CursorPayload {\n  return buildCursor(input, DEFAULTS) as unknown as CursorPayload;\n}\n","import { buildListParams } from \"./query\";\nimport type { FieldDescriptor, ListSchema } from \"./schema\";\nimport type { FieldCondition, ListParams, ListPayload, Sort, SortInput } from \"./types\";\n\n/** URL param nomlari (sahifa/o'lcham/sort) — sozlanadigan. */\nexport interface UrlConfig {\n  pageParam?: string;\n  sizeParam?: string;\n  sortParam?: string;\n}\n\nconst URL_DEFAULTS: Required<UrlConfig> = {\n  pageParam: \"page\",\n  sizeParam: \"size\",\n  sortParam: \"sortType\",\n};\n\n/** `\"-createdAt\"` → `{ name, direction }` (bo'sh bo'lsa `undefined`). */\nexport function decodeSort(value: string | null | undefined): Sort | undefined {\n  if (!value) return undefined;\n  const desc = value.startsWith(\"-\");\n  return { name: desc ? value.slice(1) : value, direction: desc ? \"desc\" : \"asc\" };\n}\n\n/** `{ name, direction }` → `\"-createdAt\"` / `\"createdAt\"` (nomsiz bo'lsa `\"\"`). */\nexport function encodeSort(sort: Sort): string {\n  if (!sort.name) return \"\";\n  return (sort.direction === \"desc\" ? \"-\" : \"\") + sort.name;\n}\n\n/** Schema + searchParams → `FieldCondition[]` (bo'sh param'lar tashlanadi). */\nexport function schemaToFilter(schema: ListSchema, searchParams: URLSearchParams): FieldCondition[] {\n  const out: FieldCondition[] = [];\n\n  for (const [param, descriptor] of Object.entries(schema) as [string, FieldDescriptor][]) {\n    const key = descriptor.key ?? param;\n\n    if (descriptor.range) {\n      const [fromParam, toParam] = descriptor.range;\n      const from = searchParams.get(fromParam);\n      const to = searchParams.get(toParam);\n      if (from) out.push(cond(key, \">=\", from));\n      if (to) out.push(cond(key, \"<=\", to));\n      continue;\n    }\n\n    let value = searchParams.get(param);\n    if (value === null || value === \"\") continue;\n    if (descriptor.trim) value = value.trim();\n    if (value === \"\") continue;\n    out.push(cond(key, descriptor.operation ?? \"=\", value));\n  }\n\n  return out;\n}\n\nfunction cond(key: string, operation: FieldCondition[\"operation\"], value: string): FieldCondition {\n  return { key, operation, value };\n}\n\n/** searchParams → normalizatsiyalanmagan {@link ListParams} (filter/sort/page/perPage). */\nexport function readListParams(schema: ListSchema, searchParams: URLSearchParams, url: UrlConfig = {}): ListParams {\n  const cfg = { ...URL_DEFAULTS, ...url };\n  const size = searchParams.get(cfg.sizeParam);\n  return {\n    filter: schemaToFilter(schema, searchParams),\n    sort: searchParams.get(cfg.sortParam) ?? undefined,\n    page: Number(searchParams.get(cfg.pageParam)) || 1,\n    perPage: size ? Number(size) : undefined,\n  };\n}\n\n/** searchParams → to'liq, yuborishga tayyor {@link ListPayload}. */\nexport function searchParamsToPayload(schema: ListSchema, searchParams: URLSearchParams, url?: UrlConfig): ListPayload {\n  return buildListParams(readListParams(schema, searchParams, url));\n}\n\n/* ------------------------- URL yozish (immutable) ------------------------- */\n/* Har biri YANGI URLSearchParams qaytaradi; filter/sort o'zgarsa `page` reset. */\n\nfunction clone(searchParams: URLSearchParams): URLSearchParams {\n  return new URLSearchParams(searchParams);\n}\n\n/** Filter param'ini o'rnatadi/o'chiradi va `page`ni reset qiladi. */\nexport function setParam(searchParams: URLSearchParams, name: string, value: string | null | undefined, url: UrlConfig = {}): URLSearchParams {\n  const cfg = { ...URL_DEFAULTS, ...url };\n  const next = clone(searchParams);\n  next.delete(cfg.pageParam);\n  if (value === null || value === undefined || value === \"\") next.delete(name);\n  else next.set(name, value);\n  return next;\n}\n\n/** Sahifani o'rnatadi (`page` reset qilinmaydi). */\nexport function setPage(searchParams: URLSearchParams, page: number, url: UrlConfig = {}): URLSearchParams {\n  const cfg = { ...URL_DEFAULTS, ...url };\n  const next = clone(searchParams);\n  next.set(cfg.pageParam, String(page));\n  return next;\n}\n\n/** Sahifa o'lchamini o'rnatadi va `page`ni reset qiladi. */\nexport function setSize(searchParams: URLSearchParams, size: number, url: UrlConfig = {}): URLSearchParams {\n  const cfg = { ...URL_DEFAULTS, ...url };\n  const next = clone(searchParams);\n  next.delete(cfg.pageParam);\n  next.set(cfg.sizeParam, String(size));\n  return next;\n}\n\n/** Sortni o'rnatadi (`\"-createdAt\"` yoki `{name,direction}`) va `page`ni reset qiladi. */\nexport function setSort(searchParams: URLSearchParams, sort: SortInput, url: UrlConfig = {}): URLSearchParams {\n  const cfg = { ...URL_DEFAULTS, ...url };\n  const next = clone(searchParams);\n  next.delete(cfg.pageParam);\n  const encoded = typeof sort === \"string\" ? sort : encodeSort(sort);\n  if (encoded) next.set(cfg.sortParam, encoded);\n  else next.delete(cfg.sortParam);\n  return next;\n}\n\n/** Barcha list param'larini tozalaydi (ixtiyoriy saqlanadigan kalitlar bilan). */\nexport function resetParams(searchParams: URLSearchParams, keep: string[] = []): URLSearchParams {\n  const next = new URLSearchParams();\n  for (const key of keep) {\n    const value = searchParams.get(key);\n    if (value !== null) next.set(key, value);\n  }\n  return next;\n}\n","import { useCallback, useMemo } from \"react\";\n\nimport type { ListSchema } from \"../schema\";\nimport type { ListPayload, SortInput } from \"../types\";\nimport type { UrlConfig } from \"../url\";\nimport { resetParams, searchParamsToPayload, setPage, setParam, setSize, setSort } from \"../url\";\n\nexport interface UseListParamsOptions {\n  /** Joriy URL search params (react-router `useSearchParams` yoki boshqa manba). */\n  searchParams: URLSearchParams;\n  /** Yangi search params'ni qo'llovchi setter (`(next) => void`). */\n  setSearchParams: (next: URLSearchParams) => void;\n  /** List filter schema'si ({@link defineListSchema}). Memoize qiling. */\n  schema: ListSchema;\n  /** URL param nomlari (page/size/sortType) — ixtiyoriy. Memoize qiling. */\n  url?: UrlConfig;\n}\n\nexport interface UseListParamsResult {\n  /** Yuborishga tayyor normalizatsiyalangan payload. */\n  params: ListPayload;\n  searchParams: URLSearchParams;\n  /** Filter param'ini o'rnatadi/o'chiradi (`page` reset). */\n  setParam: (name: string, value: string | null | undefined) => void;\n  setPage: (page: number) => void;\n  setSize: (size: number) => void;\n  setSort: (sort: SortInput) => void;\n  reset: (keep?: string[]) => void;\n}\n\n/**\n * List sahifasi uchun URL-state sync hook'i. `searchParams`ni tashqaridan oladi\n * (router-agnostik), schema'dan yuborishga tayyor `params` quradi va URL'ga\n * yozuvchi setter'lar beradi (filter/sort o'zgarsa `page` avtomatik reset).\n *\n * @example\n * ```tsx\n * const [searchParams, setSearchParams] = useSearchParams(); // react-router\n * const { params, setParam, setPage, setSort } = useListParams({\n *   searchParams, setSearchParams, schema: buyersSchema,\n * });\n * // params -> http.post(\"/buyers/list\", params)\n * ```\n */\nexport function useListParams(options: UseListParamsOptions): UseListParamsResult {\n  const { searchParams, setSearchParams, schema, url } = options;\n\n  const params = useMemo(() => searchParamsToPayload(schema, searchParams, url), [schema, searchParams, url]);\n\n  return {\n    params,\n    searchParams,\n    setParam: useCallback((name, value) => setSearchParams(setParam(searchParams, name, value, url)), [searchParams, setSearchParams, url]),\n    setPage: useCallback((page: number) => setSearchParams(setPage(searchParams, page, url)), [searchParams, setSearchParams, url]),\n    setSize: useCallback((size: number) => setSearchParams(setSize(searchParams, size, url)), [searchParams, setSearchParams, url]),\n    setSort: useCallback((sort: SortInput) => setSearchParams(setSort(searchParams, sort, url)), [searchParams, setSearchParams, url]),\n    reset: useCallback((keep?: string[]) => setSearchParams(resetParams(searchParams, keep)), [searchParams, setSearchParams]),\n  };\n}\n"]}

package/dist/react/index.d.cts

@@ -0,0 +1,41 @@
+import { p as ListSchema, U as UrlConfig, c as ListPayload, g as SortInput } from '../url-BpslCTRx.cjs';
+import '@querykitjs/core';
+
+interface UseListParamsOptions {
+    /** Joriy URL search params (react-router `useSearchParams` yoki boshqa manba). */
+    searchParams: URLSearchParams;
+    /** Yangi search params'ni qo'llovchi setter (`(next) => void`). */
+    setSearchParams: (next: URLSearchParams) => void;
+    /** List filter schema'si ({@link defineListSchema}). Memoize qiling. */
+    schema: ListSchema;
+    /** URL param nomlari (page/size/sortType) — ixtiyoriy. Memoize qiling. */
+    url?: UrlConfig;
+}
+interface UseListParamsResult {
+    /** Yuborishga tayyor normalizatsiyalangan payload. */
+    params: ListPayload;
+    searchParams: URLSearchParams;
+    /** Filter param'ini o'rnatadi/o'chiradi (`page` reset). */
+    setParam: (name: string, value: string | null | undefined) => void;
+    setPage: (page: number) => void;
+    setSize: (size: number) => void;
+    setSort: (sort: SortInput) => void;
+    reset: (keep?: string[]) => void;
+}
+/**
+ * List sahifasi uchun URL-state sync hook'i. `searchParams`ni tashqaridan oladi
+ * (router-agnostik), schema'dan yuborishga tayyor `params` quradi va URL'ga
+ * yozuvchi setter'lar beradi (filter/sort o'zgarsa `page` avtomatik reset).
+ *
+ * @example
+ * ```tsx
+ * const [searchParams, setSearchParams] = useSearchParams(); // react-router
+ * const { params, setParam, setPage, setSort } = useListParams({
+ *   searchParams, setSearchParams, schema: buyersSchema,
+ * });
+ * // params -> http.post("/buyers/list", params)
+ * ```
+ */
+declare function useListParams(options: UseListParamsOptions): UseListParamsResult;
+
+export { type UseListParamsOptions, type UseListParamsResult, useListParams };

package/dist/react/index.d.ts

@@ -0,0 +1,41 @@
+import { p as ListSchema, U as UrlConfig, c as ListPayload, g as SortInput } from '../url-BpslCTRx.js';
+import '@querykitjs/core';
+
+interface UseListParamsOptions {
+    /** Joriy URL search params (react-router `useSearchParams` yoki boshqa manba). */
+    searchParams: URLSearchParams;
+    /** Yangi search params'ni qo'llovchi setter (`(next) => void`). */
+    setSearchParams: (next: URLSearchParams) => void;
+    /** List filter schema'si ({@link defineListSchema}). Memoize qiling. */
+    schema: ListSchema;
+    /** URL param nomlari (page/size/sortType) — ixtiyoriy. Memoize qiling. */
+    url?: UrlConfig;
+}
+interface UseListParamsResult {
+    /** Yuborishga tayyor normalizatsiyalangan payload. */
+    params: ListPayload;
+    searchParams: URLSearchParams;
+    /** Filter param'ini o'rnatadi/o'chiradi (`page` reset). */
+    setParam: (name: string, value: string | null | undefined) => void;
+    setPage: (page: number) => void;
+    setSize: (size: number) => void;
+    setSort: (sort: SortInput) => void;
+    reset: (keep?: string[]) => void;
+}
+/**
+ * List sahifasi uchun URL-state sync hook'i. `searchParams`ni tashqaridan oladi
+ * (router-agnostik), schema'dan yuborishga tayyor `params` quradi va URL'ga
+ * yozuvchi setter'lar beradi (filter/sort o'zgarsa `page` avtomatik reset).
+ *
+ * @example
+ * ```tsx
+ * const [searchParams, setSearchParams] = useSearchParams(); // react-router
+ * const { params, setParam, setPage, setSort } = useListParams({
+ *   searchParams, setSearchParams, schema: buyersSchema,
+ * });
+ * // params -> http.post("/buyers/list", params)
+ * ```
+ */
+declare function useListParams(options: UseListParamsOptions): UseListParamsResult;
+
+export { type UseListParamsOptions, type UseListParamsResult, useListParams };