@m5kdev/frontend 0.8.7 → 0.8.9

package/dist/src/modules/table/hooks/useNuqsQueryParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNuqsQueryParams.js","names":["filtersSchema","parseAsString","parseAsInteger"],"sources":["../../../../../src/modules/table/hooks/useNuqsQueryParams.ts"],"sourcesContent":["import type { QueryFilters } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport { filtersSchema } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport type { GroupingState, PaginationState, SortingState, Updater } from \"@tanstack/react-table\";\r\nimport {\r\n  parseAsArrayOf,\r\n  parseAsInteger,\r\n  parseAsJson,\r\n  parseAsString,\r\n  parseAsStringLiteral,\r\n  useQueryState,\r\n} from \"nuqs\";\r\nimport { useCallback, useEffect, useMemo } from \"react\";\r\n\r\nconst parseAsFilters = parseAsJson<QueryFilters>((value) => filtersSchema.parse(value)).withDefault(\r\n  []\r\n);\r\n\r\nconst parseAsGrouping = parseAsArrayOf(parseAsString).withDefault([]);\r\n\r\nexport type Order = \"asc\" | \"desc\";\r\n\r\nexport type Granularity = \"daily\" | \"weekly\" | \"monthly\" | \"yearly\";\r\n\r\nexport interface NuqsQueryParams {\r\n  /** Global search string from URL (`q`); absent when not in URL. */\r\n  q: string | null;\r\n  setQ: (value: string | null) => void;\r\n  filters?: QueryFilters;\r\n  setFilters?: (filters: QueryFilters) => void;\r\n  granularity?: Granularity;\r\n  setGranularity?: (value: Granularity) => void;\r\n  sort?: string;\r\n  order?: Order | null;\r\n  setSorting?: (updater: Updater<SortingState>) => void;\r\n  sorting?: SortingState;\r\n  page?: number;\r\n  limit?: number;\r\n  setPagination?: (updater: Updater<PaginationState>) => void;\r\n  pagination?: PaginationState;\r\n  grouping: GroupingState;\r\n  setGrouping: (updater: Updater<GroupingState>) => void;\r\n}\r\n\r\n/**\r\n * Hook to manage all query parameters via nuqs (URL query parameters)\r\n * Manages: filters, q, sort, order, page, limit, groupBy, granularity\r\n * Accepts an optional prefix to namespace params when multiple tables share a view.\r\n */\r\nexport const useNuqsQueryParams = (prefix?: string): NuqsQueryParams => {\r\n  const k = (name: string) => (prefix ? `${prefix}_${name}` : name);\r\n\r\n  const [sort, setSort] = useQueryState<string>(k(\"sort\"), parseAsString.withDefault(\"\"));\r\n  const [order, setOrder] = useQueryState<Order>(k(\"order\"), parseAsStringLiteral([\"asc\", \"desc\"]));\r\n  const [page, setPage] = useQueryState<number>(k(\"page\"), parseAsInteger.withDefault(1));\r\n  const [limit, setLimit] = useQueryState<number>(k(\"limit\"), parseAsInteger.withDefault(10));\r\n  const [qRaw, setQRaw] = useQueryState(k(\"q\"), parseAsString);\r\n  const [filters, setFilters] = useQueryState<QueryFilters>(k(\"filters\"), parseAsFilters);\r\n\r\n  const setQ = useCallback(\r\n    (value: string | null) => {\r\n      void setQRaw(value === \"\" || value == null ? null : value);\r\n    },\r\n    [setQRaw]\r\n  );\r\n  const [granularity, setGranularity] = useQueryState<Granularity>(\r\n    k(\"granularity\"),\r\n    parseAsStringLiteral([\"daily\", \"weekly\", \"monthly\", \"yearly\"]).withDefault(\"daily\")\r\n  );\r\n  const [groupingRaw, setGroupingRaw] = useQueryState<string[]>(k(\"groupBy\"), parseAsGrouping);\r\n  const grouping: GroupingState = groupingRaw;\r\n\r\n  const setGrouping = useCallback(\r\n    (updater: Updater<GroupingState>) => {\r\n      const next = typeof updater === \"function\" ? updater(groupingRaw) : updater;\r\n      setGroupingRaw(next.length > 0 ? next : null);\r\n    },\r\n    [groupingRaw, setGroupingRaw]\r\n  );\r\n\r\n  const sorting = useMemo(() => {\r\n    if (!sort) {\r\n      return [];\r\n    }\r\n    const effectiveOrder = order ?? \"asc\";\r\n    return [{ id: sort, desc: effectiveOrder === \"desc\" }];\r\n  }, [sort, order]);\r\n\r\n  const pagination = useMemo(() => ({ pageIndex: page - 1, pageSize: limit }), [page, limit]);\r\n\r\n  const setSorting = useCallback(\r\n    (updater: Updater<SortingState>) => {\r\n      // Build current sorting state from current values\r\n      const currentSorting: SortingState = sort\r\n        ? [{ id: sort, desc: (order ?? \"asc\") === \"desc\" }]\r\n        : [];\r\n\r\n      const next = typeof updater === \"function\" ? updater(currentSorting) : updater;\r\n      const first = next[0];\r\n\r\n      if (!first || !first.id) {\r\n        setSort(\"\");\r\n        setOrder(null);\r\n        return;\r\n      }\r\n\r\n      setSort(first.id);\r\n      setOrder(first.desc ? \"desc\" : \"asc\");\r\n    },\r\n    [sort, order, setSort, setOrder]\r\n  );\r\n\r\n  // Sync order to \"asc\" if sort is set but order is null (handles URL state inconsistencies)\r\n  useEffect(() => {\r\n    if (sort && !order) {\r\n      setOrder(\"asc\");\r\n    }\r\n  }, [sort, order, setOrder]);\r\n\r\n  // biome-ignore lint/correctness/useExhaustiveDependencies: dependent on page and limit only\r\n  const setPagination = useCallback(\r\n    (updater: Updater<PaginationState>) => {\r\n      // TanStack Table uses 0-based indexing, but URL uses 1-based\r\n      const currentState = { pageIndex: page - 1, pageSize: limit };\r\n      const next = typeof updater === \"function\" ? updater(currentState) : updater;\r\n      // Convert back to 1-based for URL\r\n      setPage((next.pageIndex ?? 0) + 1);\r\n      setLimit(next.pageSize ?? 10);\r\n    },\r\n    [page, limit]\r\n  );\r\n\r\n  return useMemo(\r\n    () => ({\r\n      q: qRaw,\r\n      setQ,\r\n      filters,\r\n      setFilters,\r\n      granularity,\r\n      setGranularity,\r\n      sort,\r\n      order,\r\n      setSorting,\r\n      sorting,\r\n      page,\r\n      limit,\r\n      setPagination,\r\n      pagination,\r\n      grouping,\r\n      setGrouping,\r\n    }),\r\n    [\r\n      qRaw,\r\n      setQ,\r\n      filters,\r\n      setFilters,\r\n      granularity,\r\n      setGranularity,\r\n      sort,\r\n      order,\r\n      setSorting,\r\n      sorting,\r\n      page,\r\n      limit,\r\n      setPagination,\r\n      pagination,\r\n      grouping,\r\n      setGrouping,\r\n    ]\r\n  );\r\n};\r\n"],"mappings":";;;;;AAaA,MAAM,kBAAA,GAAA,KAAA,cAA4C,UAAUA,6CAAAA,cAAc,MAAM,MAAM,CAAC,CAAC,YACtF,EAAE,CACH;AAED,MAAM,mBAAA,GAAA,KAAA,gBAAiCC,KAAAA,cAAc,CAAC,YAAY,EAAE,CAAC;;;;;;AA+BrE,MAAa,sBAAsB,WAAqC;CACtE,MAAM,KAAK,SAAkB,SAAS,GAAG,OAAO,GAAG,SAAS;CAE5D,MAAM,CAAC,MAAM,YAAA,GAAA,KAAA,eAAiC,EAAE,OAAO,EAAEA,KAAAA,cAAc,YAAY,GAAG,CAAC;CACvF,MAAM,CAAC,OAAO,aAAA,GAAA,KAAA,eAAiC,EAAE,QAAQ,GAAA,GAAA,KAAA,sBAAuB,CAAC,OAAO,OAAO,CAAC,CAAC;CACjG,MAAM,CAAC,MAAM,YAAA,GAAA,KAAA,eAAiC,EAAE,OAAO,EAAEC,KAAAA,eAAe,YAAY,EAAE,CAAC;CACvF,MAAM,CAAC,OAAO,aAAA,GAAA,KAAA,eAAkC,EAAE,QAAQ,EAAEA,KAAAA,eAAe,YAAY,GAAG,CAAC;CAC3F,MAAM,CAAC,MAAM,YAAA,GAAA,KAAA,eAAyB,EAAE,IAAI,EAAED,KAAAA,cAAc;CAC5D,MAAM,CAAC,SAAS,eAAA,GAAA,KAAA,eAA0C,EAAE,UAAU,EAAE,eAAe;CAEvF,MAAM,QAAA,GAAA,MAAA,cACH,UAAyB;AACnB,UAAQ,UAAU,MAAM,SAAS,OAAO,OAAO,MAAM;IAE5D,CAAC,QAAQ,CACV;CACD,MAAM,CAAC,aAAa,mBAAA,GAAA,KAAA,eAClB,EAAE,cAAc,GAAA,GAAA,KAAA,sBACK;EAAC;EAAS;EAAU;EAAW;EAAS,CAAC,CAAC,YAAY,QAAQ,CACpF;CACD,MAAM,CAAC,aAAa,mBAAA,GAAA,KAAA,eAA0C,EAAE,UAAU,EAAE,gBAAgB;CAC5F,MAAM,WAA0B;CAEhC,MAAM,eAAA,GAAA,MAAA,cACH,YAAoC;EACnC,MAAM,OAAO,OAAO,YAAY,aAAa,QAAQ,YAAY,GAAG;AACpE,iBAAe,KAAK,SAAS,IAAI,OAAO,KAAK;IAE/C,CAAC,aAAa,eAAe,CAC9B;CAED,MAAM,WAAA,GAAA,MAAA,eAAwB;AAC5B,MAAI,CAAC,KACH,QAAO,EAAE;AAGX,SAAO,CAAC;GAAE,IAAI;GAAM,OADG,SAAS,WACa;GAAQ,CAAC;IACrD,CAAC,MAAM,MAAM,CAAC;CAEjB,MAAM,cAAA,GAAA,MAAA,gBAA4B;EAAE,WAAW,OAAO;EAAG,UAAU;EAAO,GAAG,CAAC,MAAM,MAAM,CAAC;CAE3F,MAAM,cAAA,GAAA,MAAA,cACH,YAAmC;EAOlC,MAAM,SADO,OAAO,YAAY,aAAa,QAJR,OACjC,CAAC;GAAE,IAAI;GAAM,OAAO,SAAS,WAAW;GAAQ,CAAC,GACjD,EAAE,CAE8D,GAAG,SACpD;AAEnB,MAAI,CAAC,SAAS,CAAC,MAAM,IAAI;AACvB,WAAQ,GAAG;AACX,YAAS,KAAK;AACd;;AAGF,UAAQ,MAAM,GAAG;AACjB,WAAS,MAAM,OAAO,SAAS,MAAM;IAEvC;EAAC;EAAM;EAAO;EAAS;EAAS,CACjC;AAGD,EAAA,GAAA,MAAA,iBAAgB;AACd,MAAI,QAAQ,CAAC,MACX,UAAS,MAAM;IAEhB;EAAC;EAAM;EAAO;EAAS,CAAC;CAG3B,MAAM,iBAAA,GAAA,MAAA,cACH,YAAsC;EAErC,MAAM,eAAe;GAAE,WAAW,OAAO;GAAG,UAAU;GAAO;EAC7D,MAAM,OAAO,OAAO,YAAY,aAAa,QAAQ,aAAa,GAAG;AAErE,WAAS,KAAK,aAAa,KAAK,EAAE;AAClC,WAAS,KAAK,YAAY,GAAG;IAE/B,CAAC,MAAM,MAAM,CACd;AAED,SAAA,GAAA,MAAA,gBACS;EACL,GAAG;EACH;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,GACD;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CACF"}

package/dist/src/modules/table/hooks/useNuqsQueryParams.mjs

@@ -6,7 +6,7 @@ const parseAsFilters = parseAsJson((value) => filtersSchema.parse(value)).withDe
 const parseAsGrouping = parseAsArrayOf(parseAsString).withDefault([]);
 /**
 * Hook to manage all query parameters via nuqs (URL query parameters)
-* Manages: filters, sort, order, page, limit, groupBy, granularity
+* Manages: filters, q, sort, order, page, limit, groupBy, granularity
 * Accepts an optional prefix to namespace params when multiple tables share a view.
 */
 const useNuqsQueryParams = (prefix) => {
@@ -15,7 +15,11 @@ const useNuqsQueryParams = (prefix) => {
 	const [order, setOrder] = useQueryState(k("order"), parseAsStringLiteral(["asc", "desc"]));
 	const [page, setPage] = useQueryState(k("page"), parseAsInteger.withDefault(1));
 	const [limit, setLimit] = useQueryState(k("limit"), parseAsInteger.withDefault(10));
+	const [qRaw, setQRaw] = useQueryState(k("q"), parseAsString);
 	const [filters, setFilters] = useQueryState(k("filters"), parseAsFilters);
+	const setQ = useCallback((value) => {
+		setQRaw(value === "" || value == null ? null : value);
+	}, [setQRaw]);
 	const [granularity, setGranularity] = useQueryState(k("granularity"), parseAsStringLiteral([
 		"daily",
 		"weekly",
@@ -74,6 +78,8 @@ const useNuqsQueryParams = (prefix) => {
 		setLimit(next.pageSize ?? 10);
 	}, [page, limit]);
 	return useMemo(() => ({
+		q: qRaw,
+		setQ,
 		filters,
 		setFilters,
 		granularity,
@@ -89,6 +95,8 @@ const useNuqsQueryParams = (prefix) => {
 		grouping,
 		setGrouping
 	}), [
+		qRaw,
+		setQ,
 		filters,
 		setFilters,
 		granularity,

package/dist/src/modules/table/hooks/useNuqsQueryParams.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useNuqsQueryParams.mjs","names":[],"sources":["../../../../../src/modules/table/hooks/useNuqsQueryParams.ts"],"sourcesContent":["import type { QueryFilters } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport { filtersSchema } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport type { GroupingState, PaginationState, SortingState, Updater } from \"@tanstack/react-table\";\r\nimport {\r\n  parseAsArrayOf,\r\n  parseAsInteger,\r\n  parseAsJson,\r\n  parseAsString,\r\n  parseAsStringLiteral,\r\n  useQueryState,\r\n} from \"nuqs\";\r\nimport { useCallback, useEffect, useMemo } from \"react\";\r\n\r\nconst parseAsFilters = parseAsJson<QueryFilters>((value) => filtersSchema.parse(value)).withDefault(\r\n  []\r\n);\r\n\r\nconst parseAsGrouping = parseAsArrayOf(parseAsString).withDefault([]);\r\n\r\nexport type Order = \"asc\" | \"desc\";\r\n\r\nexport type Granularity = \"daily\" | \"weekly\" | \"monthly\" | \"yearly\";\r\n\r\nexport interface NuqsQueryParams {\r\n  filters?: QueryFilters;\r\n  setFilters?: (filters: QueryFilters) => void;\r\n  granularity?: Granularity;\r\n  setGranularity?: (value: Granularity) => void;\r\n  sort?: string;\r\n  order?: Order | null;\r\n  setSorting?: (updater: Updater<SortingState>) => void;\r\n  sorting?: SortingState;\r\n  page?: number;\r\n  limit?: number;\r\n  setPagination?: (updater: Updater<PaginationState>) => void;\r\n  pagination?: PaginationState;\r\n  grouping: GroupingState;\r\n  setGrouping: (updater: Updater<GroupingState>) => void;\r\n}\r\n\r\n/**\r\n * Hook to manage all query parameters via nuqs (URL query parameters)\r\n * Manages: filters, sort, order, page, limit, groupBy, granularity\r\n * Accepts an optional prefix to namespace params when multiple tables share a view.\r\n */\r\nexport const useNuqsQueryParams = (prefix?: string): NuqsQueryParams => {\r\n  const k = (name: string) => (prefix ? `${prefix}_${name}` : name);\r\n\r\n  const [sort, setSort] = useQueryState<string>(k(\"sort\"), parseAsString.withDefault(\"\"));\r\n  const [order, setOrder] = useQueryState<Order>(k(\"order\"), parseAsStringLiteral([\"asc\", \"desc\"]));\r\n  const [page, setPage] = useQueryState<number>(k(\"page\"), parseAsInteger.withDefault(1));\r\n  const [limit, setLimit] = useQueryState<number>(k(\"limit\"), parseAsInteger.withDefault(10));\r\n  const [filters, setFilters] = useQueryState<QueryFilters>(k(\"filters\"), parseAsFilters);\r\n  const [granularity, setGranularity] = useQueryState<Granularity>(\r\n    k(\"granularity\"),\r\n    parseAsStringLiteral([\"daily\", \"weekly\", \"monthly\", \"yearly\"]).withDefault(\"daily\")\r\n  );\r\n  const [groupingRaw, setGroupingRaw] = useQueryState<string[]>(k(\"groupBy\"), parseAsGrouping);\r\n  const grouping: GroupingState = groupingRaw;\r\n\r\n  const setGrouping = useCallback(\r\n    (updater: Updater<GroupingState>) => {\r\n      const next = typeof updater === \"function\" ? updater(groupingRaw) : updater;\r\n      setGroupingRaw(next.length > 0 ? next : null);\r\n    },\r\n    [groupingRaw, setGroupingRaw]\r\n  );\r\n\r\n  const sorting = useMemo(() => {\r\n    if (!sort) {\r\n      return [];\r\n    }\r\n    const effectiveOrder = order ?? \"asc\";\r\n    return [{ id: sort, desc: effectiveOrder === \"desc\" }];\r\n  }, [sort, order]);\r\n\r\n  const pagination = useMemo(() => ({ pageIndex: page - 1, pageSize: limit }), [page, limit]);\r\n\r\n  const setSorting = useCallback(\r\n    (updater: Updater<SortingState>) => {\r\n      // Build current sorting state from current values\r\n      const currentSorting: SortingState = sort\r\n        ? [{ id: sort, desc: (order ?? \"asc\") === \"desc\" }]\r\n        : [];\r\n\r\n      const next = typeof updater === \"function\" ? updater(currentSorting) : updater;\r\n      const first = next[0];\r\n\r\n      if (!first || !first.id) {\r\n        setSort(\"\");\r\n        setOrder(null);\r\n        return;\r\n      }\r\n\r\n      setSort(first.id);\r\n      setOrder(first.desc ? \"desc\" : \"asc\");\r\n    },\r\n    [sort, order, setSort, setOrder]\r\n  );\r\n\r\n  // Sync order to \"asc\" if sort is set but order is null (handles URL state inconsistencies)\r\n  useEffect(() => {\r\n    if (sort && !order) {\r\n      setOrder(\"asc\");\r\n    }\r\n  }, [sort, order, setOrder]);\r\n\r\n  // biome-ignore lint/correctness/useExhaustiveDependencies: dependent on page and limit only\r\n  const setPagination = useCallback(\r\n    (updater: Updater<PaginationState>) => {\r\n      // TanStack Table uses 0-based indexing, but URL uses 1-based\r\n      const currentState = { pageIndex: page - 1, pageSize: limit };\r\n      const next = typeof updater === \"function\" ? updater(currentState) : updater;\r\n      // Convert back to 1-based for URL\r\n      setPage((next.pageIndex ?? 0) + 1);\r\n      setLimit(next.pageSize ?? 10);\r\n    },\r\n    [page, limit]\r\n  );\r\n\r\n  return useMemo(\r\n    () => ({\r\n      filters,\r\n      setFilters,\r\n      granularity,\r\n      setGranularity,\r\n      sort,\r\n      order,\r\n      setSorting,\r\n      sorting,\r\n      page,\r\n      limit,\r\n      setPagination,\r\n      pagination,\r\n      grouping,\r\n      setGrouping,\r\n    }),\r\n    [\r\n      filters,\r\n      setFilters,\r\n      granularity,\r\n      setGranularity,\r\n      sort,\r\n      order,\r\n      setSorting,\r\n      sorting,\r\n      page,\r\n      limit,\r\n      setPagination,\r\n      pagination,\r\n      grouping,\r\n      setGrouping,\r\n    ]\r\n  );\r\n};\r\n"],"mappings":";;;;AAaA,MAAM,iBAAiB,aAA2B,UAAU,cAAc,MAAM,MAAM,CAAC,CAAC,YACtF,EAAE,CACH;AAED,MAAM,kBAAkB,eAAe,cAAc,CAAC,YAAY,EAAE,CAAC;;;;;;AA4BrE,MAAa,sBAAsB,WAAqC;CACtE,MAAM,KAAK,SAAkB,SAAS,GAAG,OAAO,GAAG,SAAS;CAE5D,MAAM,CAAC,MAAM,WAAW,cAAsB,EAAE,OAAO,EAAE,cAAc,YAAY,GAAG,CAAC;CACvF,MAAM,CAAC,OAAO,YAAY,cAAqB,EAAE,QAAQ,EAAE,qBAAqB,CAAC,OAAO,OAAO,CAAC,CAAC;CACjG,MAAM,CAAC,MAAM,WAAW,cAAsB,EAAE,OAAO,EAAE,eAAe,YAAY,EAAE,CAAC;CACvF,MAAM,CAAC,OAAO,YAAY,cAAsB,EAAE,QAAQ,EAAE,eAAe,YAAY,GAAG,CAAC;CAC3F,MAAM,CAAC,SAAS,cAAc,cAA4B,EAAE,UAAU,EAAE,eAAe;CACvF,MAAM,CAAC,aAAa,kBAAkB,cACpC,EAAE,cAAc,EAChB,qBAAqB;EAAC;EAAS;EAAU;EAAW;EAAS,CAAC,CAAC,YAAY,QAAQ,CACpF;CACD,MAAM,CAAC,aAAa,kBAAkB,cAAwB,EAAE,UAAU,EAAE,gBAAgB;CAC5F,MAAM,WAA0B;CAEhC,MAAM,cAAc,aACjB,YAAoC;EACnC,MAAM,OAAO,OAAO,YAAY,aAAa,QAAQ,YAAY,GAAG;AACpE,iBAAe,KAAK,SAAS,IAAI,OAAO,KAAK;IAE/C,CAAC,aAAa,eAAe,CAC9B;CAED,MAAM,UAAU,cAAc;AAC5B,MAAI,CAAC,KACH,QAAO,EAAE;AAGX,SAAO,CAAC;GAAE,IAAI;GAAM,OADG,SAAS,WACa;GAAQ,CAAC;IACrD,CAAC,MAAM,MAAM,CAAC;CAEjB,MAAM,aAAa,eAAe;EAAE,WAAW,OAAO;EAAG,UAAU;EAAO,GAAG,CAAC,MAAM,MAAM,CAAC;CAE3F,MAAM,aAAa,aAChB,YAAmC;EAOlC,MAAM,SADO,OAAO,YAAY,aAAa,QAJR,OACjC,CAAC;GAAE,IAAI;GAAM,OAAO,SAAS,WAAW;GAAQ,CAAC,GACjD,EAAE,CAE8D,GAAG,SACpD;AAEnB,MAAI,CAAC,SAAS,CAAC,MAAM,IAAI;AACvB,WAAQ,GAAG;AACX,YAAS,KAAK;AACd;;AAGF,UAAQ,MAAM,GAAG;AACjB,WAAS,MAAM,OAAO,SAAS,MAAM;IAEvC;EAAC;EAAM;EAAO;EAAS;EAAS,CACjC;AAGD,iBAAgB;AACd,MAAI,QAAQ,CAAC,MACX,UAAS,MAAM;IAEhB;EAAC;EAAM;EAAO;EAAS,CAAC;CAG3B,MAAM,gBAAgB,aACnB,YAAsC;EAErC,MAAM,eAAe;GAAE,WAAW,OAAO;GAAG,UAAU;GAAO;EAC7D,MAAM,OAAO,OAAO,YAAY,aAAa,QAAQ,aAAa,GAAG;AAErE,WAAS,KAAK,aAAa,KAAK,EAAE;AAClC,WAAS,KAAK,YAAY,GAAG;IAE/B,CAAC,MAAM,MAAM,CACd;AAED,QAAO,eACE;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,GACD;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CACF"}
+{"version":3,"file":"useNuqsQueryParams.mjs","names":[],"sources":["../../../../../src/modules/table/hooks/useNuqsQueryParams.ts"],"sourcesContent":["import type { QueryFilters } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport { filtersSchema } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport type { GroupingState, PaginationState, SortingState, Updater } from \"@tanstack/react-table\";\r\nimport {\r\n  parseAsArrayOf,\r\n  parseAsInteger,\r\n  parseAsJson,\r\n  parseAsString,\r\n  parseAsStringLiteral,\r\n  useQueryState,\r\n} from \"nuqs\";\r\nimport { useCallback, useEffect, useMemo } from \"react\";\r\n\r\nconst parseAsFilters = parseAsJson<QueryFilters>((value) => filtersSchema.parse(value)).withDefault(\r\n  []\r\n);\r\n\r\nconst parseAsGrouping = parseAsArrayOf(parseAsString).withDefault([]);\r\n\r\nexport type Order = \"asc\" | \"desc\";\r\n\r\nexport type Granularity = \"daily\" | \"weekly\" | \"monthly\" | \"yearly\";\r\n\r\nexport interface NuqsQueryParams {\r\n  /** Global search string from URL (`q`); absent when not in URL. */\r\n  q: string | null;\r\n  setQ: (value: string | null) => void;\r\n  filters?: QueryFilters;\r\n  setFilters?: (filters: QueryFilters) => void;\r\n  granularity?: Granularity;\r\n  setGranularity?: (value: Granularity) => void;\r\n  sort?: string;\r\n  order?: Order | null;\r\n  setSorting?: (updater: Updater<SortingState>) => void;\r\n  sorting?: SortingState;\r\n  page?: number;\r\n  limit?: number;\r\n  setPagination?: (updater: Updater<PaginationState>) => void;\r\n  pagination?: PaginationState;\r\n  grouping: GroupingState;\r\n  setGrouping: (updater: Updater<GroupingState>) => void;\r\n}\r\n\r\n/**\r\n * Hook to manage all query parameters via nuqs (URL query parameters)\r\n * Manages: filters, q, sort, order, page, limit, groupBy, granularity\r\n * Accepts an optional prefix to namespace params when multiple tables share a view.\r\n */\r\nexport const useNuqsQueryParams = (prefix?: string): NuqsQueryParams => {\r\n  const k = (name: string) => (prefix ? `${prefix}_${name}` : name);\r\n\r\n  const [sort, setSort] = useQueryState<string>(k(\"sort\"), parseAsString.withDefault(\"\"));\r\n  const [order, setOrder] = useQueryState<Order>(k(\"order\"), parseAsStringLiteral([\"asc\", \"desc\"]));\r\n  const [page, setPage] = useQueryState<number>(k(\"page\"), parseAsInteger.withDefault(1));\r\n  const [limit, setLimit] = useQueryState<number>(k(\"limit\"), parseAsInteger.withDefault(10));\r\n  const [qRaw, setQRaw] = useQueryState(k(\"q\"), parseAsString);\r\n  const [filters, setFilters] = useQueryState<QueryFilters>(k(\"filters\"), parseAsFilters);\r\n\r\n  const setQ = useCallback(\r\n    (value: string | null) => {\r\n      void setQRaw(value === \"\" || value == null ? null : value);\r\n    },\r\n    [setQRaw]\r\n  );\r\n  const [granularity, setGranularity] = useQueryState<Granularity>(\r\n    k(\"granularity\"),\r\n    parseAsStringLiteral([\"daily\", \"weekly\", \"monthly\", \"yearly\"]).withDefault(\"daily\")\r\n  );\r\n  const [groupingRaw, setGroupingRaw] = useQueryState<string[]>(k(\"groupBy\"), parseAsGrouping);\r\n  const grouping: GroupingState = groupingRaw;\r\n\r\n  const setGrouping = useCallback(\r\n    (updater: Updater<GroupingState>) => {\r\n      const next = typeof updater === \"function\" ? updater(groupingRaw) : updater;\r\n      setGroupingRaw(next.length > 0 ? next : null);\r\n    },\r\n    [groupingRaw, setGroupingRaw]\r\n  );\r\n\r\n  const sorting = useMemo(() => {\r\n    if (!sort) {\r\n      return [];\r\n    }\r\n    const effectiveOrder = order ?? \"asc\";\r\n    return [{ id: sort, desc: effectiveOrder === \"desc\" }];\r\n  }, [sort, order]);\r\n\r\n  const pagination = useMemo(() => ({ pageIndex: page - 1, pageSize: limit }), [page, limit]);\r\n\r\n  const setSorting = useCallback(\r\n    (updater: Updater<SortingState>) => {\r\n      // Build current sorting state from current values\r\n      const currentSorting: SortingState = sort\r\n        ? [{ id: sort, desc: (order ?? \"asc\") === \"desc\" }]\r\n        : [];\r\n\r\n      const next = typeof updater === \"function\" ? updater(currentSorting) : updater;\r\n      const first = next[0];\r\n\r\n      if (!first || !first.id) {\r\n        setSort(\"\");\r\n        setOrder(null);\r\n        return;\r\n      }\r\n\r\n      setSort(first.id);\r\n      setOrder(first.desc ? \"desc\" : \"asc\");\r\n    },\r\n    [sort, order, setSort, setOrder]\r\n  );\r\n\r\n  // Sync order to \"asc\" if sort is set but order is null (handles URL state inconsistencies)\r\n  useEffect(() => {\r\n    if (sort && !order) {\r\n      setOrder(\"asc\");\r\n    }\r\n  }, [sort, order, setOrder]);\r\n\r\n  // biome-ignore lint/correctness/useExhaustiveDependencies: dependent on page and limit only\r\n  const setPagination = useCallback(\r\n    (updater: Updater<PaginationState>) => {\r\n      // TanStack Table uses 0-based indexing, but URL uses 1-based\r\n      const currentState = { pageIndex: page - 1, pageSize: limit };\r\n      const next = typeof updater === \"function\" ? updater(currentState) : updater;\r\n      // Convert back to 1-based for URL\r\n      setPage((next.pageIndex ?? 0) + 1);\r\n      setLimit(next.pageSize ?? 10);\r\n    },\r\n    [page, limit]\r\n  );\r\n\r\n  return useMemo(\r\n    () => ({\r\n      q: qRaw,\r\n      setQ,\r\n      filters,\r\n      setFilters,\r\n      granularity,\r\n      setGranularity,\r\n      sort,\r\n      order,\r\n      setSorting,\r\n      sorting,\r\n      page,\r\n      limit,\r\n      setPagination,\r\n      pagination,\r\n      grouping,\r\n      setGrouping,\r\n    }),\r\n    [\r\n      qRaw,\r\n      setQ,\r\n      filters,\r\n      setFilters,\r\n      granularity,\r\n      setGranularity,\r\n      sort,\r\n      order,\r\n      setSorting,\r\n      sorting,\r\n      page,\r\n      limit,\r\n      setPagination,\r\n      pagination,\r\n      grouping,\r\n      setGrouping,\r\n    ]\r\n  );\r\n};\r\n"],"mappings":";;;;AAaA,MAAM,iBAAiB,aAA2B,UAAU,cAAc,MAAM,MAAM,CAAC,CAAC,YACtF,EAAE,CACH;AAED,MAAM,kBAAkB,eAAe,cAAc,CAAC,YAAY,EAAE,CAAC;;;;;;AA+BrE,MAAa,sBAAsB,WAAqC;CACtE,MAAM,KAAK,SAAkB,SAAS,GAAG,OAAO,GAAG,SAAS;CAE5D,MAAM,CAAC,MAAM,WAAW,cAAsB,EAAE,OAAO,EAAE,cAAc,YAAY,GAAG,CAAC;CACvF,MAAM,CAAC,OAAO,YAAY,cAAqB,EAAE,QAAQ,EAAE,qBAAqB,CAAC,OAAO,OAAO,CAAC,CAAC;CACjG,MAAM,CAAC,MAAM,WAAW,cAAsB,EAAE,OAAO,EAAE,eAAe,YAAY,EAAE,CAAC;CACvF,MAAM,CAAC,OAAO,YAAY,cAAsB,EAAE,QAAQ,EAAE,eAAe,YAAY,GAAG,CAAC;CAC3F,MAAM,CAAC,MAAM,WAAW,cAAc,EAAE,IAAI,EAAE,cAAc;CAC5D,MAAM,CAAC,SAAS,cAAc,cAA4B,EAAE,UAAU,EAAE,eAAe;CAEvF,MAAM,OAAO,aACV,UAAyB;AACnB,UAAQ,UAAU,MAAM,SAAS,OAAO,OAAO,MAAM;IAE5D,CAAC,QAAQ,CACV;CACD,MAAM,CAAC,aAAa,kBAAkB,cACpC,EAAE,cAAc,EAChB,qBAAqB;EAAC;EAAS;EAAU;EAAW;EAAS,CAAC,CAAC,YAAY,QAAQ,CACpF;CACD,MAAM,CAAC,aAAa,kBAAkB,cAAwB,EAAE,UAAU,EAAE,gBAAgB;CAC5F,MAAM,WAA0B;CAEhC,MAAM,cAAc,aACjB,YAAoC;EACnC,MAAM,OAAO,OAAO,YAAY,aAAa,QAAQ,YAAY,GAAG;AACpE,iBAAe,KAAK,SAAS,IAAI,OAAO,KAAK;IAE/C,CAAC,aAAa,eAAe,CAC9B;CAED,MAAM,UAAU,cAAc;AAC5B,MAAI,CAAC,KACH,QAAO,EAAE;AAGX,SAAO,CAAC;GAAE,IAAI;GAAM,OADG,SAAS,WACa;GAAQ,CAAC;IACrD,CAAC,MAAM,MAAM,CAAC;CAEjB,MAAM,aAAa,eAAe;EAAE,WAAW,OAAO;EAAG,UAAU;EAAO,GAAG,CAAC,MAAM,MAAM,CAAC;CAE3F,MAAM,aAAa,aAChB,YAAmC;EAOlC,MAAM,SADO,OAAO,YAAY,aAAa,QAJR,OACjC,CAAC;GAAE,IAAI;GAAM,OAAO,SAAS,WAAW;GAAQ,CAAC,GACjD,EAAE,CAE8D,GAAG,SACpD;AAEnB,MAAI,CAAC,SAAS,CAAC,MAAM,IAAI;AACvB,WAAQ,GAAG;AACX,YAAS,KAAK;AACd;;AAGF,UAAQ,MAAM,GAAG;AACjB,WAAS,MAAM,OAAO,SAAS,MAAM;IAEvC;EAAC;EAAM;EAAO;EAAS;EAAS,CACjC;AAGD,iBAAgB;AACd,MAAI,QAAQ,CAAC,MACX,UAAS,MAAM;IAEhB;EAAC;EAAM;EAAO;EAAS,CAAC;CAG3B,MAAM,gBAAgB,aACnB,YAAsC;EAErC,MAAM,eAAe;GAAE,WAAW,OAAO;GAAG,UAAU;GAAO;EAC7D,MAAM,OAAO,OAAO,YAAY,aAAa,QAAQ,aAAa,GAAG;AAErE,WAAS,KAAK,aAAa,KAAK,EAAE;AAClC,WAAS,KAAK,YAAY,GAAG;IAE/B,CAAC,MAAM,MAAM,CACd;AAED,QAAO,eACE;EACL,GAAG;EACH;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,GACD;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CACF"}

package/dist/src/modules/table/hooks/useNuqsTable.d.ts

@@ -0,0 +1,47 @@
+import { RowSelectionState } from "../../../../node_modules/.pnpm/@tanstack_table-core@8.21.2/node_modules/@tanstack/table-core/build/lib/features/RowSelection.js";
+import { Updater } from "../../../../node_modules/.pnpm/@tanstack_table-core@8.21.2/node_modules/@tanstack/table-core/build/lib/types.js";
+import { NuqsQueryParams } from "./useNuqsQueryParams.js";
+import { UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
+import { QueryFilters } from "@m5kdev/commons/modules/schemas/query.schema";
+
+//#region src/modules/table/hooks/useNuqsTable.d.ts
+interface TableParams extends NuqsQueryParams {
+  rowSelection: RowSelectionState;
+  setRowSelection: (updater: Updater<RowSelectionState>) => void;
+}
+/**
+ * Alias for TableParams - used by TablePagination and other table components
+ */
+type TableProps = TableParams;
+interface NuqsTableReturn<TData> {
+  params: TableParams;
+  query: UseQueryResult<TData>;
+}
+/**
+ * Flexible query options type that accepts both standard TanStack Query options
+ * and tRPC's queryOptions function return type.
+ * Uses permissive generics to handle type differences between TanStack Query and tRPC.
+ */
+type QueryOptionsLike<TData> = UseQueryOptions<TData, any, TData, any>;
+/**
+ * Function type that accepts both standard query options functions and tRPC's queryOptions.
+ * tRPC's queryOptions accepts (input, opts?) while standard functions may only accept (input).
+ */
+type GetQueryOptionsFn<TInput, TData> = (input: TInput, ...args: any[]) => QueryOptionsLike<TData>;
+interface NuqsTableOptions<TInput, TData> {
+  getQueryOptions: GetQueryOptionsFn<TInput, TData>;
+  queryParams?: TInput;
+  prefix?: string;
+  additionalFilters?: QueryFilters;
+  onAdditionalFiltersChange?: (filters: QueryFilters) => void;
+}
+declare const useNuqsTable: <TInput, TData>({
+  getQueryOptions,
+  queryParams,
+  prefix,
+  additionalFilters,
+  onAdditionalFiltersChange
+}: NuqsTableOptions<TInput, TData>) => NuqsTableReturn<TData>;
+//#endregion
+export { NuqsTableOptions, NuqsTableReturn, TableParams, TableProps, useNuqsTable as default };
+//# sourceMappingURL=useNuqsTable.d.ts.map

package/dist/src/modules/table/hooks/useNuqsTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNuqsTable.d.ts","names":[],"sources":["../../../../../src/modules/table/hooks/useNuqsTable.ts"],"mappings":";;;;;;;UAOiB,WAAA,SAAoB,eAAA;EACnC,YAAA,EAAc,iBAAA;EACd,eAAA,GAAkB,OAAA,EAAS,OAAA,CAAQ,iBAAA;AAAA;AAFrC;;;AAAA,KAQY,UAAA,GAAa,WAAA;AAAA,UAER,eAAA;EACf,MAAA,EAAQ,WAAA;EACR,KAAA,EAAO,cAAA,CAAe,KAAA;AAAA;;;;;;KASnB,gBAAA,UAA0B,eAAA,CAAgB,KAAA,OAAY,KAAA;;;;;KAOtD,iBAAA,mBAAoC,KAAA,EAAO,MAAA,KAAW,IAAA,YAAgB,gBAAA,CAAiB,KAAA;AAAA,UAE3E,gBAAA;EACf,eAAA,EAAiB,iBAAA,CAAkB,MAAA,EAAQ,KAAA;EAC3C,WAAA,GAAc,MAAA;EACd,MAAA;EACA,iBAAA,GAAoB,YAAA;EACpB,yBAAA,IAA6B,OAAA,EAAS,YAAA;AAAA;AAAA,cAGlC,YAAA;EAA+B,eAAA;EAAA,WAAA;EAAA,MAAA;EAAA,iBAAA;EAAA;AAAA,GAMlC,gBAAA,CAAiB,MAAA,EAAQ,KAAA,MAAS,eAAA,CAAgB,KAAA"}

package/dist/src/modules/table/hooks/useNuqsTable.js

@@ -0,0 +1,58 @@
+const require_src_modules_table_hooks_useNuqsQueryParams = require("./useNuqsQueryParams.js");
+const require_src_modules_table_hooks_useQueryWithParams = require("./useQueryWithParams.js");
+let react = require("react");
+//#region src/modules/table/hooks/useNuqsTable.ts
+const useNuqsTable = ({ getQueryOptions, queryParams = {}, prefix, additionalFilters, onAdditionalFiltersChange }) => {
+	const queryState = require_src_modules_table_hooks_useNuqsQueryParams.useNuqsQueryParams(prefix);
+	const queryResult = require_src_modules_table_hooks_useQueryWithParams.useQueryWithParams({
+		getQueryOptions,
+		queryParams,
+		queryState,
+		grouping: queryState.grouping,
+		additionalFilters
+	});
+	const [rowSelection, setRowSelectionRaw] = (0, react.useState)({});
+	const setRowSelection = (0, react.useCallback)((updater) => {
+		setRowSelectionRaw((prev) => {
+			return typeof updater === "function" ? updater(prev) : updater;
+		});
+	}, []);
+	const displayFilters = (0, react.useMemo)(() => {
+		if (!additionalFilters?.length) return queryState.filters ?? [];
+		return [...additionalFilters, ...queryState.filters ?? []];
+	}, [additionalFilters, queryState.filters]);
+	const additionalColumnIds = (0, react.useMemo)(() => new Set(additionalFilters?.map((f) => f.columnId) ?? []), [additionalFilters]);
+	const wrappedSetFilters = (0, react.useCallback)((newFilters) => {
+		if (!additionalColumnIds.size) {
+			queryState.setFilters?.(newFilters);
+			return;
+		}
+		const ownFilters = newFilters.filter((f) => !additionalColumnIds.has(f.columnId));
+		queryState.setFilters?.(ownFilters);
+		if (onAdditionalFiltersChange) onAdditionalFiltersChange(newFilters.filter((f) => additionalColumnIds.has(f.columnId)));
+	}, [
+		additionalColumnIds,
+		queryState.setFilters,
+		onAdditionalFiltersChange
+	]);
+	return {
+		params: (0, react.useMemo)(() => ({
+			...queryState,
+			filters: displayFilters,
+			setFilters: wrappedSetFilters,
+			rowSelection,
+			setRowSelection
+		}), [
+			queryState,
+			displayFilters,
+			wrappedSetFilters,
+			rowSelection,
+			setRowSelection
+		]),
+		query: queryResult
+	};
+};
+//#endregion
+module.exports = useNuqsTable;
+
+//# sourceMappingURL=useNuqsTable.js.map

package/dist/src/modules/table/hooks/useNuqsTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNuqsTable.js","names":["useNuqsQueryParams","useQueryWithParams"],"sources":["../../../../../src/modules/table/hooks/useNuqsTable.ts"],"sourcesContent":["import type { QueryFilters } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport type { UseQueryOptions, UseQueryResult } from \"@tanstack/react-query\";\r\nimport type { RowSelectionState, Updater } from \"@tanstack/react-table\";\r\nimport { useCallback, useMemo, useState } from \"react\";\r\nimport { type NuqsQueryParams, useNuqsQueryParams } from \"./useNuqsQueryParams\";\r\nimport { useQueryWithParams } from \"./useQueryWithParams\";\r\n\r\nexport interface TableParams extends NuqsQueryParams {\r\n  rowSelection: RowSelectionState;\r\n  setRowSelection: (updater: Updater<RowSelectionState>) => void;\r\n}\r\n\r\n/**\r\n * Alias for TableParams - used by TablePagination and other table components\r\n */\r\nexport type TableProps = TableParams;\r\n\r\nexport interface NuqsTableReturn<TData> {\r\n  params: TableParams;\r\n  query: UseQueryResult<TData>;\r\n}\r\n\r\n/**\r\n * Flexible query options type that accepts both standard TanStack Query options\r\n * and tRPC's queryOptions function return type.\r\n * Uses permissive generics to handle type differences between TanStack Query and tRPC.\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\ntype QueryOptionsLike<TData> = UseQueryOptions<TData, any, TData, any>;\r\n\r\n/**\r\n * Function type that accepts both standard query options functions and tRPC's queryOptions.\r\n * tRPC's queryOptions accepts (input, opts?) while standard functions may only accept (input).\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\ntype GetQueryOptionsFn<TInput, TData> = (input: TInput, ...args: any[]) => QueryOptionsLike<TData>;\r\n\r\nexport interface NuqsTableOptions<TInput, TData> {\r\n  getQueryOptions: GetQueryOptionsFn<TInput, TData>;\r\n  queryParams?: TInput;\r\n  prefix?: string;\r\n  additionalFilters?: QueryFilters;\r\n  onAdditionalFiltersChange?: (filters: QueryFilters) => void;\r\n}\r\n\r\nconst useNuqsTable = <TInput, TData>({\r\n  getQueryOptions,\r\n  queryParams = {} as TInput,\r\n  prefix,\r\n  additionalFilters,\r\n  onAdditionalFiltersChange,\r\n}: NuqsTableOptions<TInput, TData>): NuqsTableReturn<TData> => {\r\n  // Get all URL query state (includes grouping)\r\n  const queryState = useNuqsQueryParams(prefix);\r\n\r\n  // Get query result — passes grouping so limit can be overridden when grouped\r\n  const queryResult = useQueryWithParams({\r\n    getQueryOptions,\r\n    queryParams,\r\n    queryState,\r\n    grouping: queryState.grouping,\r\n    additionalFilters,\r\n  });\r\n\r\n  // Table-specific row selection state\r\n  const [rowSelection, setRowSelectionRaw] = useState<RowSelectionState>({});\r\n\r\n  const setRowSelection = useCallback((updater: Updater<RowSelectionState>) => {\r\n    setRowSelectionRaw((prev: RowSelectionState) => {\r\n      const next = typeof updater === \"function\" ? updater(prev) : updater;\r\n      return next;\r\n    });\r\n  }, []);\r\n\r\n  // Merge additionalFilters into displayed filters so the table UI shows all active filters.\r\n  // On write, strip the additional filters so only the table's own go to the prefixed URL param.\r\n  const displayFilters = useMemo<QueryFilters>(() => {\r\n    if (!additionalFilters?.length) return queryState.filters ?? [];\r\n    return [...additionalFilters, ...(queryState.filters ?? [])];\r\n  }, [additionalFilters, queryState.filters]);\r\n\r\n  const additionalColumnIds = useMemo(\r\n    () => new Set(additionalFilters?.map((f) => f.columnId) ?? []),\r\n    [additionalFilters]\r\n  );\r\n\r\n  const wrappedSetFilters = useCallback(\r\n    (newFilters: QueryFilters) => {\r\n      if (!additionalColumnIds.size) {\r\n        queryState.setFilters?.(newFilters);\r\n        return;\r\n      }\r\n      const ownFilters = newFilters.filter((f) => !additionalColumnIds.has(f.columnId));\r\n      queryState.setFilters?.(ownFilters);\r\n\r\n      if (onAdditionalFiltersChange) {\r\n        const updatedAdditional = newFilters.filter((f) => additionalColumnIds.has(f.columnId));\r\n        onAdditionalFiltersChange(updatedAdditional);\r\n      }\r\n    },\r\n    [additionalColumnIds, queryState.setFilters, onAdditionalFiltersChange]\r\n  );\r\n\r\n  const params = useMemo(\r\n    () => ({\r\n      ...queryState,\r\n      filters: displayFilters,\r\n      setFilters: wrappedSetFilters,\r\n      rowSelection,\r\n      setRowSelection,\r\n    }),\r\n    [queryState, displayFilters, wrappedSetFilters, rowSelection, setRowSelection]\r\n  );\r\n\r\n  return {\r\n    params,\r\n    query: queryResult,\r\n  };\r\n};\r\n\r\nexport default useNuqsTable;\r\n"],"mappings":";;;;AA6CA,MAAM,gBAA+B,EACnC,iBACA,cAAc,EAAE,EAChB,QACA,mBACA,gCAC6D;CAE7D,MAAM,aAAaA,mDAAAA,mBAAmB,OAAO;CAG7C,MAAM,cAAcC,mDAAAA,mBAAmB;EACrC;EACA;EACA;EACA,UAAU,WAAW;EACrB;EACD,CAAC;CAGF,MAAM,CAAC,cAAc,uBAAA,GAAA,MAAA,UAAkD,EAAE,CAAC;CAE1E,MAAM,mBAAA,GAAA,MAAA,cAA+B,YAAwC;AAC3E,sBAAoB,SAA4B;AAE9C,UADa,OAAO,YAAY,aAAa,QAAQ,KAAK,GAAG;IAE7D;IACD,EAAE,CAAC;CAIN,MAAM,kBAAA,GAAA,MAAA,eAA6C;AACjD,MAAI,CAAC,mBAAmB,OAAQ,QAAO,WAAW,WAAW,EAAE;AAC/D,SAAO,CAAC,GAAG,mBAAmB,GAAI,WAAW,WAAW,EAAE,CAAE;IAC3D,CAAC,mBAAmB,WAAW,QAAQ,CAAC;CAE3C,MAAM,uBAAA,GAAA,MAAA,eACE,IAAI,IAAI,mBAAmB,KAAK,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC,EAC9D,CAAC,kBAAkB,CACpB;CAED,MAAM,qBAAA,GAAA,MAAA,cACH,eAA6B;AAC5B,MAAI,CAAC,oBAAoB,MAAM;AAC7B,cAAW,aAAa,WAAW;AACnC;;EAEF,MAAM,aAAa,WAAW,QAAQ,MAAM,CAAC,oBAAoB,IAAI,EAAE,SAAS,CAAC;AACjF,aAAW,aAAa,WAAW;AAEnC,MAAI,0BAEF,2BAD0B,WAAW,QAAQ,MAAM,oBAAoB,IAAI,EAAE,SAAS,CAAC,CAC3C;IAGhD;EAAC;EAAqB,WAAW;EAAY;EAA0B,CACxE;AAaD,QAAO;EACL,SAAA,GAAA,MAAA,gBAXO;GACL,GAAG;GACH,SAAS;GACT,YAAY;GACZ;GACA;GACD,GACD;GAAC;GAAY;GAAgB;GAAmB;GAAc;GAAgB,CAC/E;EAIC,OAAO;EACR"}

package/dist/src/modules/table/hooks/useQueryWithParams.d.mts

@@ -18,7 +18,7 @@ type GetQueryOptionsFn<TInput, TData> = (input: TInput, ...args: any[]) => Query
 interface QueryWithParamsOptions<TInput, TData> {
   getQueryOptions: GetQueryOptionsFn<TInput, TData>;
   queryParams?: TInput;
-  queryState: Pick<NuqsQueryParams, "filters" | "sort" | "order" | "page" | "limit">;
+  queryState: Pick<NuqsQueryParams, "filters" | "sort" | "order" | "page" | "limit" | "q">;
   grouping?: GroupingState;
   additionalFilters?: QueryFilters;
   enabled?: boolean;

package/dist/src/modules/table/hooks/useQueryWithParams.d.ts

@@ -0,0 +1,40 @@
+import { GroupingState } from "../../../../node_modules/.pnpm/@tanstack_table-core@8.21.2/node_modules/@tanstack/table-core/build/lib/features/ColumnGrouping.js";
+import { NuqsQueryParams } from "./useNuqsQueryParams.js";
+import { UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
+import { QueryFilters } from "@m5kdev/commons/modules/schemas/query.schema";
+
+//#region src/modules/table/hooks/useQueryWithParams.d.ts
+/**
+ * Flexible query options type that accepts both standard TanStack Query options
+ * and tRPC's queryOptions function return type.
+ * Uses permissive generics to handle type differences between TanStack Query and tRPC.
+ */
+type QueryOptionsLike<TData> = UseQueryOptions<TData, any, TData, any>;
+/**
+ * Function type that accepts both standard query options functions and tRPC's queryOptions.
+ * tRPC's queryOptions accepts (input, opts?) while standard functions may only accept (input).
+ */
+type GetQueryOptionsFn<TInput, TData> = (input: TInput, ...args: any[]) => QueryOptionsLike<TData>;
+interface QueryWithParamsOptions<TInput, TData> {
+  getQueryOptions: GetQueryOptionsFn<TInput, TData>;
+  queryParams?: TInput;
+  queryState: Pick<NuqsQueryParams, "filters" | "sort" | "order" | "page" | "limit" | "q">;
+  grouping?: GroupingState;
+  additionalFilters?: QueryFilters;
+  enabled?: boolean;
+}
+/**
+ * Hook to integrate query state with React Query
+ * Combines queryParams with queryState and manages data fetching
+ */
+declare const useQueryWithParams: <TInput, TData>({
+  getQueryOptions,
+  queryParams,
+  queryState,
+  grouping,
+  additionalFilters,
+  enabled
+}: QueryWithParamsOptions<TInput, TData>) => UseQueryResult<TData>;
+//#endregion
+export { QueryWithParamsOptions, useQueryWithParams };
+//# sourceMappingURL=useQueryWithParams.d.ts.map

package/dist/src/modules/table/hooks/useQueryWithParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQueryWithParams.d.ts","names":[],"sources":["../../../../../src/modules/table/hooks/useQueryWithParams.ts"],"mappings":";;;;;;;;;AAI4D;;KAQvD,gBAAA,UAA0B,eAAA,CAAgB,KAAA,OAAY,KAAA;;;;;KAOtD,iBAAA,mBAAoC,KAAA,EAAO,MAAA,KAAW,IAAA,YAAgB,gBAAA,CAAiB,KAAA;AAAA,UAI3E,sBAAA;EACf,eAAA,EAAiB,iBAAA,CAAkB,MAAA,EAAQ,KAAA;EAC3C,WAAA,GAAc,MAAA;EACd,UAAA,EAAY,IAAA,CAAK,eAAA;EACjB,QAAA,GAAW,aAAA;EACX,iBAAA,GAAoB,YAAA;EACpB,OAAA;AAAA;;;;;cAOW,kBAAA;EAAqC,eAAA;EAAA,WAAA;EAAA,UAAA;EAAA,QAAA;EAAA,iBAAA;EAAA;AAAA,GAO/C,sBAAA,CAAuB,MAAA,EAAQ,KAAA,MAAS,cAAA,CAAe,KAAA"}

package/dist/src/modules/table/hooks/useQueryWithParams.js

@@ -0,0 +1,61 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let react = require("react");
+let _tanstack_react_query = require("@tanstack/react-query");
+//#region src/modules/table/hooks/useQueryWithParams.ts
+const FETCH_ALL_LIMIT = 99999;
+/**
+* Hook to integrate query state with React Query
+* Combines queryParams with queryState and manages data fetching
+*/
+const useQueryWithParams = ({ getQueryOptions, queryParams = {}, queryState, grouping = [], additionalFilters, enabled = true }) => {
+	const { filters, sort, order, page, limit, q } = queryState;
+	const isGrouped = grouping.length > 0;
+	const input = (0, react.useMemo)(() => {
+		let mergedFilters;
+		if (additionalFilters?.length) {
+			const additionalColumnIds = new Set(additionalFilters.map((f) => f.columnId));
+			const ownFiltersOnly = (filters ?? []).filter((f) => !additionalColumnIds.has(f.columnId));
+			mergedFilters = [...additionalFilters, ...ownFiltersOnly];
+		} else mergedFilters = filters;
+		const qTrimmed = q?.trim();
+		const qPayload = qTrimmed && qTrimmed.length > 0 ? qTrimmed : void 0;
+		return {
+			...queryParams,
+			page: isGrouped ? 1 : page,
+			limit: isGrouped ? FETCH_ALL_LIMIT : limit,
+			sort,
+			order: order ?? void 0,
+			filters: mergedFilters,
+			...qPayload !== void 0 ? { q: qPayload } : {}
+		};
+	}, [
+		queryParams,
+		page,
+		limit,
+		sort,
+		order,
+		filters,
+		isGrouped,
+		additionalFilters,
+		q
+	]);
+	const prevIsGroupedRef = (0, react.useRef)(isGrouped);
+	const groupingTransitioned = prevIsGroupedRef.current !== isGrouped;
+	(0, react.useEffect)(() => {
+		prevIsGroupedRef.current = isGrouped;
+	}, [isGrouped]);
+	return (0, _tanstack_react_query.useQuery)((0, react.useMemo)(() => ({
+		...getQueryOptions(input),
+		placeholderData: groupingTransitioned ? void 0 : (previousData) => previousData,
+		enabled
+	}), [
+		getQueryOptions,
+		input,
+		enabled,
+		groupingTransitioned
+	]));
+};
+//#endregion
+exports.useQueryWithParams = useQueryWithParams;
+
+//# sourceMappingURL=useQueryWithParams.js.map

package/dist/src/modules/table/hooks/useQueryWithParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQueryWithParams.js","names":[],"sources":["../../../../../src/modules/table/hooks/useQueryWithParams.ts"],"sourcesContent":["import type { QueryFilters } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport { type UseQueryOptions, type UseQueryResult, useQuery } from \"@tanstack/react-query\";\r\nimport type { GroupingState } from \"@tanstack/react-table\";\r\nimport { useEffect, useMemo, useRef } from \"react\";\r\nimport type { NuqsQueryParams } from \"./useNuqsQueryParams\";\r\n\r\n/**\r\n * Flexible query options type that accepts both standard TanStack Query options\r\n * and tRPC's queryOptions function return type.\r\n * Uses permissive generics to handle type differences between TanStack Query and tRPC.\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\ntype QueryOptionsLike<TData> = UseQueryOptions<TData, any, TData, any>;\r\n\r\n/**\r\n * Function type that accepts both standard query options functions and tRPC's queryOptions.\r\n * tRPC's queryOptions accepts (input, opts?) while standard functions may only accept (input).\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\ntype GetQueryOptionsFn<TInput, TData> = (input: TInput, ...args: any[]) => QueryOptionsLike<TData>;\r\n\r\nconst FETCH_ALL_LIMIT = 99999;\r\n\r\nexport interface QueryWithParamsOptions<TInput, TData> {\r\n  getQueryOptions: GetQueryOptionsFn<TInput, TData>;\r\n  queryParams?: TInput;\r\n  queryState: Pick<NuqsQueryParams, \"filters\" | \"sort\" | \"order\" | \"page\" | \"limit\" | \"q\">;\r\n  grouping?: GroupingState;\r\n  additionalFilters?: QueryFilters;\r\n  enabled?: boolean;\r\n}\r\n\r\n/**\r\n * Hook to integrate query state with React Query\r\n * Combines queryParams with queryState and manages data fetching\r\n */\r\nexport const useQueryWithParams = <TInput, TData>({\r\n  getQueryOptions,\r\n  queryParams = {} as TInput,\r\n  queryState,\r\n  grouping = [],\r\n  additionalFilters,\r\n  enabled = true,\r\n}: QueryWithParamsOptions<TInput, TData>): UseQueryResult<TData> => {\r\n  const { filters, sort, order, page, limit, q } = queryState;\r\n  const isGrouped = grouping.length > 0;\r\n\r\n  const input = useMemo(() => {\r\n    let mergedFilters: QueryFilters | undefined;\r\n    if (additionalFilters?.length) {\r\n      const additionalColumnIds = new Set(additionalFilters.map((f) => f.columnId));\r\n      const ownFiltersOnly = (filters ?? []).filter((f) => !additionalColumnIds.has(f.columnId));\r\n      mergedFilters = [...additionalFilters, ...ownFiltersOnly];\r\n    } else {\r\n      mergedFilters = filters;\r\n    }\r\n\r\n    const qTrimmed = q?.trim();\r\n    const qPayload = qTrimmed && qTrimmed.length > 0 ? qTrimmed : undefined;\r\n\r\n    return {\r\n      ...queryParams,\r\n      page: isGrouped ? 1 : page,\r\n      limit: isGrouped ? FETCH_ALL_LIMIT : limit,\r\n      sort,\r\n      order: order ?? undefined,\r\n      filters: mergedFilters,\r\n      ...(qPayload !== undefined ? { q: qPayload } : {}),\r\n    };\r\n  }, [queryParams, page, limit, sort, order, filters, isGrouped, additionalFilters, q]);\r\n\r\n  const prevIsGroupedRef = useRef(isGrouped);\r\n\r\n  const groupingTransitioned = prevIsGroupedRef.current !== isGrouped;\r\n\r\n  useEffect(() => {\r\n    prevIsGroupedRef.current = isGrouped;\r\n  }, [isGrouped]);\r\n\r\n  const queryOptions = useMemo(\r\n    () => ({\r\n      ...getQueryOptions(input),\r\n      placeholderData: groupingTransitioned\r\n        ? undefined\r\n        : (previousData: TData | undefined) => previousData,\r\n      enabled,\r\n    }),\r\n    [getQueryOptions, input, enabled, groupingTransitioned]\r\n  );\r\n\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  return useQuery(queryOptions as any) as UseQueryResult<TData>;\r\n};\r\n"],"mappings":";;;;AAqBA,MAAM,kBAAkB;;;;;AAexB,MAAa,sBAAqC,EAChD,iBACA,cAAc,EAAE,EAChB,YACA,WAAW,EAAE,EACb,mBACA,UAAU,WACwD;CAClE,MAAM,EAAE,SAAS,MAAM,OAAO,MAAM,OAAO,MAAM;CACjD,MAAM,YAAY,SAAS,SAAS;CAEpC,MAAM,SAAA,GAAA,MAAA,eAAsB;EAC1B,IAAI;AACJ,MAAI,mBAAmB,QAAQ;GAC7B,MAAM,sBAAsB,IAAI,IAAI,kBAAkB,KAAK,MAAM,EAAE,SAAS,CAAC;GAC7E,MAAM,kBAAkB,WAAW,EAAE,EAAE,QAAQ,MAAM,CAAC,oBAAoB,IAAI,EAAE,SAAS,CAAC;AAC1F,mBAAgB,CAAC,GAAG,mBAAmB,GAAG,eAAe;QAEzD,iBAAgB;EAGlB,MAAM,WAAW,GAAG,MAAM;EAC1B,MAAM,WAAW,YAAY,SAAS,SAAS,IAAI,WAAW,KAAA;AAE9D,SAAO;GACL,GAAG;GACH,MAAM,YAAY,IAAI;GACtB,OAAO,YAAY,kBAAkB;GACrC;GACA,OAAO,SAAS,KAAA;GAChB,SAAS;GACT,GAAI,aAAa,KAAA,IAAY,EAAE,GAAG,UAAU,GAAG,EAAE;GAClD;IACA;EAAC;EAAa;EAAM;EAAO;EAAM;EAAO;EAAS;EAAW;EAAmB;EAAE,CAAC;CAErF,MAAM,oBAAA,GAAA,MAAA,QAA0B,UAAU;CAE1C,MAAM,uBAAuB,iBAAiB,YAAY;AAE1D,EAAA,GAAA,MAAA,iBAAgB;AACd,mBAAiB,UAAU;IAC1B,CAAC,UAAU,CAAC;AAcf,SAAA,GAAA,sBAAA,WAAA,GAAA,MAAA,gBAXS;EACL,GAAG,gBAAgB,MAAM;EACzB,iBAAiB,uBACb,KAAA,KACC,iBAAoC;EACzC;EACD,GACD;EAAC;EAAiB;EAAO;EAAS;EAAqB,CACxD,CAGmC"}

package/dist/src/modules/table/hooks/useQueryWithParams.mjs

@@ -7,7 +7,7 @@ const FETCH_ALL_LIMIT = 99999;
 * Combines queryParams with queryState and manages data fetching
 */
 const useQueryWithParams = ({ getQueryOptions, queryParams = {}, queryState, grouping = [], additionalFilters, enabled = true }) => {
-	const { filters, sort, order, page, limit } = queryState;
+	const { filters, sort, order, page, limit, q } = queryState;
 	const isGrouped = grouping.length > 0;
 	const input = useMemo(() => {
 		let mergedFilters;
@@ -16,13 +16,16 @@ const useQueryWithParams = ({ getQueryOptions, queryParams = {}, queryState, gro
 			const ownFiltersOnly = (filters ?? []).filter((f) => !additionalColumnIds.has(f.columnId));
 			mergedFilters = [...additionalFilters, ...ownFiltersOnly];
 		} else mergedFilters = filters;
+		const qTrimmed = q?.trim();
+		const qPayload = qTrimmed && qTrimmed.length > 0 ? qTrimmed : void 0;
 		return {
 			...queryParams,
 			page: isGrouped ? 1 : page,
 			limit: isGrouped ? FETCH_ALL_LIMIT : limit,
 			sort,
 			order: order ?? void 0,
-			filters: mergedFilters
+			filters: mergedFilters,
+			...qPayload !== void 0 ? { q: qPayload } : {}
 		};
 	}, [
 		queryParams,
@@ -32,7 +35,8 @@ const useQueryWithParams = ({ getQueryOptions, queryParams = {}, queryState, gro
 		order,
 		filters,
 		isGrouped,
-		additionalFilters
+		additionalFilters,
+		q
 	]);
 	const prevIsGroupedRef = useRef(isGrouped);
 	const groupingTransitioned = prevIsGroupedRef.current !== isGrouped;

package/dist/src/modules/table/hooks/useQueryWithParams.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useQueryWithParams.mjs","names":[],"sources":["../../../../../src/modules/table/hooks/useQueryWithParams.ts"],"sourcesContent":["import type { QueryFilters } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport { type UseQueryOptions, type UseQueryResult, useQuery } from \"@tanstack/react-query\";\r\nimport type { GroupingState } from \"@tanstack/react-table\";\r\nimport { useEffect, useMemo, useRef } from \"react\";\r\nimport type { NuqsQueryParams } from \"./useNuqsQueryParams\";\r\n\r\n/**\r\n * Flexible query options type that accepts both standard TanStack Query options\r\n * and tRPC's queryOptions function return type.\r\n * Uses permissive generics to handle type differences between TanStack Query and tRPC.\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\ntype QueryOptionsLike<TData> = UseQueryOptions<TData, any, TData, any>;\r\n\r\n/**\r\n * Function type that accepts both standard query options functions and tRPC's queryOptions.\r\n * tRPC's queryOptions accepts (input, opts?) while standard functions may only accept (input).\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\ntype GetQueryOptionsFn<TInput, TData> = (input: TInput, ...args: any[]) => QueryOptionsLike<TData>;\r\n\r\nconst FETCH_ALL_LIMIT = 99999;\r\n\r\nexport interface QueryWithParamsOptions<TInput, TData> {\r\n  getQueryOptions: GetQueryOptionsFn<TInput, TData>;\r\n  queryParams?: TInput;\r\n  queryState: Pick<NuqsQueryParams, \"filters\" | \"sort\" | \"order\" | \"page\" | \"limit\">;\r\n  grouping?: GroupingState;\r\n  additionalFilters?: QueryFilters;\r\n  enabled?: boolean;\r\n}\r\n\r\n/**\r\n * Hook to integrate query state with React Query\r\n * Combines queryParams with queryState and manages data fetching\r\n */\r\nexport const useQueryWithParams = <TInput, TData>({\r\n  getQueryOptions,\r\n  queryParams = {} as TInput,\r\n  queryState,\r\n  grouping = [],\r\n  additionalFilters,\r\n  enabled = true,\r\n}: QueryWithParamsOptions<TInput, TData>): UseQueryResult<TData> => {\r\n  const { filters, sort, order, page, limit } = queryState;\r\n  const isGrouped = grouping.length > 0;\r\n\r\n  const input = useMemo(() => {\r\n    let mergedFilters: QueryFilters | undefined;\r\n    if (additionalFilters?.length) {\r\n      const additionalColumnIds = new Set(additionalFilters.map((f) => f.columnId));\r\n      const ownFiltersOnly = (filters ?? []).filter((f) => !additionalColumnIds.has(f.columnId));\r\n      mergedFilters = [...additionalFilters, ...ownFiltersOnly];\r\n    } else {\r\n      mergedFilters = filters;\r\n    }\r\n\r\n    return {\r\n      ...queryParams,\r\n      page: isGrouped ? 1 : page,\r\n      limit: isGrouped ? FETCH_ALL_LIMIT : limit,\r\n      sort,\r\n      order: order ?? undefined,\r\n      filters: mergedFilters,\r\n    };\r\n  }, [queryParams, page, limit, sort, order, filters, isGrouped, additionalFilters]);\r\n\r\n  const prevIsGroupedRef = useRef(isGrouped);\r\n\r\n  const groupingTransitioned = prevIsGroupedRef.current !== isGrouped;\r\n\r\n  useEffect(() => {\r\n    prevIsGroupedRef.current = isGrouped;\r\n  }, [isGrouped]);\r\n\r\n  const queryOptions = useMemo(\r\n    () => ({\r\n      ...getQueryOptions(input),\r\n      placeholderData: groupingTransitioned\r\n        ? undefined\r\n        : (previousData: TData | undefined) => previousData,\r\n      enabled,\r\n    }),\r\n    [getQueryOptions, input, enabled, groupingTransitioned]\r\n  );\r\n\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  return useQuery(queryOptions as any) as UseQueryResult<TData>;\r\n};\r\n"],"mappings":";;;AAqBA,MAAM,kBAAkB;;;;;AAexB,MAAa,sBAAqC,EAChD,iBACA,cAAc,EAAE,EAChB,YACA,WAAW,EAAE,EACb,mBACA,UAAU,WACwD;CAClE,MAAM,EAAE,SAAS,MAAM,OAAO,MAAM,UAAU;CAC9C,MAAM,YAAY,SAAS,SAAS;CAEpC,MAAM,QAAQ,cAAc;EAC1B,IAAI;AACJ,MAAI,mBAAmB,QAAQ;GAC7B,MAAM,sBAAsB,IAAI,IAAI,kBAAkB,KAAK,MAAM,EAAE,SAAS,CAAC;GAC7E,MAAM,kBAAkB,WAAW,EAAE,EAAE,QAAQ,MAAM,CAAC,oBAAoB,IAAI,EAAE,SAAS,CAAC;AAC1F,mBAAgB,CAAC,GAAG,mBAAmB,GAAG,eAAe;QAEzD,iBAAgB;AAGlB,SAAO;GACL,GAAG;GACH,MAAM,YAAY,IAAI;GACtB,OAAO,YAAY,kBAAkB;GACrC;GACA,OAAO,SAAS,KAAA;GAChB,SAAS;GACV;IACA;EAAC;EAAa;EAAM;EAAO;EAAM;EAAO;EAAS;EAAW;EAAkB,CAAC;CAElF,MAAM,mBAAmB,OAAO,UAAU;CAE1C,MAAM,uBAAuB,iBAAiB,YAAY;AAE1D,iBAAgB;AACd,mBAAiB,UAAU;IAC1B,CAAC,UAAU,CAAC;AAcf,QAAO,SAZc,eACZ;EACL,GAAG,gBAAgB,MAAM;EACzB,iBAAiB,uBACb,KAAA,KACC,iBAAoC;EACzC;EACD,GACD;EAAC;EAAiB;EAAO;EAAS;EAAqB,CACxD,CAGmC"}
+{"version":3,"file":"useQueryWithParams.mjs","names":[],"sources":["../../../../../src/modules/table/hooks/useQueryWithParams.ts"],"sourcesContent":["import type { QueryFilters } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport { type UseQueryOptions, type UseQueryResult, useQuery } from \"@tanstack/react-query\";\r\nimport type { GroupingState } from \"@tanstack/react-table\";\r\nimport { useEffect, useMemo, useRef } from \"react\";\r\nimport type { NuqsQueryParams } from \"./useNuqsQueryParams\";\r\n\r\n/**\r\n * Flexible query options type that accepts both standard TanStack Query options\r\n * and tRPC's queryOptions function return type.\r\n * Uses permissive generics to handle type differences between TanStack Query and tRPC.\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\ntype QueryOptionsLike<TData> = UseQueryOptions<TData, any, TData, any>;\r\n\r\n/**\r\n * Function type that accepts both standard query options functions and tRPC's queryOptions.\r\n * tRPC's queryOptions accepts (input, opts?) while standard functions may only accept (input).\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\ntype GetQueryOptionsFn<TInput, TData> = (input: TInput, ...args: any[]) => QueryOptionsLike<TData>;\r\n\r\nconst FETCH_ALL_LIMIT = 99999;\r\n\r\nexport interface QueryWithParamsOptions<TInput, TData> {\r\n  getQueryOptions: GetQueryOptionsFn<TInput, TData>;\r\n  queryParams?: TInput;\r\n  queryState: Pick<NuqsQueryParams, \"filters\" | \"sort\" | \"order\" | \"page\" | \"limit\" | \"q\">;\r\n  grouping?: GroupingState;\r\n  additionalFilters?: QueryFilters;\r\n  enabled?: boolean;\r\n}\r\n\r\n/**\r\n * Hook to integrate query state with React Query\r\n * Combines queryParams with queryState and manages data fetching\r\n */\r\nexport const useQueryWithParams = <TInput, TData>({\r\n  getQueryOptions,\r\n  queryParams = {} as TInput,\r\n  queryState,\r\n  grouping = [],\r\n  additionalFilters,\r\n  enabled = true,\r\n}: QueryWithParamsOptions<TInput, TData>): UseQueryResult<TData> => {\r\n  const { filters, sort, order, page, limit, q } = queryState;\r\n  const isGrouped = grouping.length > 0;\r\n\r\n  const input = useMemo(() => {\r\n    let mergedFilters: QueryFilters | undefined;\r\n    if (additionalFilters?.length) {\r\n      const additionalColumnIds = new Set(additionalFilters.map((f) => f.columnId));\r\n      const ownFiltersOnly = (filters ?? []).filter((f) => !additionalColumnIds.has(f.columnId));\r\n      mergedFilters = [...additionalFilters, ...ownFiltersOnly];\r\n    } else {\r\n      mergedFilters = filters;\r\n    }\r\n\r\n    const qTrimmed = q?.trim();\r\n    const qPayload = qTrimmed && qTrimmed.length > 0 ? qTrimmed : undefined;\r\n\r\n    return {\r\n      ...queryParams,\r\n      page: isGrouped ? 1 : page,\r\n      limit: isGrouped ? FETCH_ALL_LIMIT : limit,\r\n      sort,\r\n      order: order ?? undefined,\r\n      filters: mergedFilters,\r\n      ...(qPayload !== undefined ? { q: qPayload } : {}),\r\n    };\r\n  }, [queryParams, page, limit, sort, order, filters, isGrouped, additionalFilters, q]);\r\n\r\n  const prevIsGroupedRef = useRef(isGrouped);\r\n\r\n  const groupingTransitioned = prevIsGroupedRef.current !== isGrouped;\r\n\r\n  useEffect(() => {\r\n    prevIsGroupedRef.current = isGrouped;\r\n  }, [isGrouped]);\r\n\r\n  const queryOptions = useMemo(\r\n    () => ({\r\n      ...getQueryOptions(input),\r\n      placeholderData: groupingTransitioned\r\n        ? undefined\r\n        : (previousData: TData | undefined) => previousData,\r\n      enabled,\r\n    }),\r\n    [getQueryOptions, input, enabled, groupingTransitioned]\r\n  );\r\n\r\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n  return useQuery(queryOptions as any) as UseQueryResult<TData>;\r\n};\r\n"],"mappings":";;;AAqBA,MAAM,kBAAkB;;;;;AAexB,MAAa,sBAAqC,EAChD,iBACA,cAAc,EAAE,EAChB,YACA,WAAW,EAAE,EACb,mBACA,UAAU,WACwD;CAClE,MAAM,EAAE,SAAS,MAAM,OAAO,MAAM,OAAO,MAAM;CACjD,MAAM,YAAY,SAAS,SAAS;CAEpC,MAAM,QAAQ,cAAc;EAC1B,IAAI;AACJ,MAAI,mBAAmB,QAAQ;GAC7B,MAAM,sBAAsB,IAAI,IAAI,kBAAkB,KAAK,MAAM,EAAE,SAAS,CAAC;GAC7E,MAAM,kBAAkB,WAAW,EAAE,EAAE,QAAQ,MAAM,CAAC,oBAAoB,IAAI,EAAE,SAAS,CAAC;AAC1F,mBAAgB,CAAC,GAAG,mBAAmB,GAAG,eAAe;QAEzD,iBAAgB;EAGlB,MAAM,WAAW,GAAG,MAAM;EAC1B,MAAM,WAAW,YAAY,SAAS,SAAS,IAAI,WAAW,KAAA;AAE9D,SAAO;GACL,GAAG;GACH,MAAM,YAAY,IAAI;GACtB,OAAO,YAAY,kBAAkB;GACrC;GACA,OAAO,SAAS,KAAA;GAChB,SAAS;GACT,GAAI,aAAa,KAAA,IAAY,EAAE,GAAG,UAAU,GAAG,EAAE;GAClD;IACA;EAAC;EAAa;EAAM;EAAO;EAAM;EAAO;EAAS;EAAW;EAAmB;EAAE,CAAC;CAErF,MAAM,mBAAmB,OAAO,UAAU;CAE1C,MAAM,uBAAuB,iBAAiB,YAAY;AAE1D,iBAAgB;AACd,mBAAiB,UAAU;IAC1B,CAAC,UAAU,CAAC;AAcf,QAAO,SAZc,eACZ;EACL,GAAG,gBAAgB,MAAM;EACzB,iBAAiB,uBACb,KAAA,KACC,iBAAoC;EACzC;EACD,GACD;EAAC;EAAiB;EAAO;EAAS;EAAqB,CACxD,CAGmC"}

package/dist/src/types.d.ts

@@ -0,0 +1,8 @@
+import { BackendTRPCRouter } from "../packages/backend/dist/src/types.js";
+import { createTRPCContext } from "@trpc/tanstack-react-query";
+
+//#region src/types.d.ts
+type UseBackendTRPC = ReturnType<typeof createTRPCContext<BackendTRPCRouter>>["useTRPC"];
+//#endregion
+export { UseBackendTRPC };
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/types.ts"],"mappings":";;;;KAGY,cAAA,GAAiB,UAAA,QAAkB,iBAAA,CAAkB,iBAAA"}

package/dist/src/utils/date.d.mts

@@ -1,5 +1,5 @@
-import { RangeValue } from "../../node_modules/.pnpm/@react-types_shared@3.32.1_react@19.2.1/node_modules/@react-types/shared/src/inputs.mjs";
-import { DateValue } from "../../node_modules/.pnpm/@react-types_calendar@3.8.1_react@19.2.1/node_modules/@react-types/calendar/src/index.mjs";
+import { RangeValue } from "../../node_modules/.pnpm/@react-types_shared@3.33.1_react@19.2.1/node_modules/@react-types/shared/src/inputs.mjs";
+import { DateValue } from "../../node_modules/.pnpm/@react-types_calendar@3.8.3_react@19.2.1/node_modules/@react-types/calendar/src/index.mjs";
 import { CalendarDate } from "@internationalized/date";
 import { QueryFilter } from "@m5kdev/commons/modules/schemas/query.schema";
 

package/dist/src/utils/date.d.ts

@@ -0,0 +1,29 @@
+import { RangeValue } from "../../node_modules/.pnpm/@react-types_shared@3.33.1_react@19.2.1/node_modules/@react-types/shared/src/inputs.js";
+import { DateValue } from "../../node_modules/.pnpm/@react-types_calendar@3.8.3_react@19.2.1/node_modules/@react-types/calendar/src/index.js";
+import { QueryFilter } from "@m5kdev/commons/modules/schemas/query.schema";
+import { CalendarDate } from "@internationalized/date";
+
+//#region src/utils/date.d.ts
+/**
+ * Convert CalendarDate to UTC ISO string at midnight UTC
+ */
+declare const calendarDateToUTC: (date: CalendarDate) => string;
+/**
+ * Convert CalendarDate to UTC ISO string at end of day UTC
+ */
+declare const calendarDateToUTCEndOfDay: (date: CalendarDate) => string;
+/**
+ * Convert RangeValue<DateValue> to URL string format "startISO,endISO"
+ */
+declare const rangeToUrlString: (range: RangeValue<DateValue> | null) => string | null;
+/**
+ * Convert URL string "startISO,endISO" to RangeValue<DateValue>
+ */
+declare const urlStringToRange: (value: string | null) => RangeValue<DateValue> | null;
+/**
+ * Convert date range to QueryFilter format
+ */
+declare const dateRangeToFilter: (dateRange: RangeValue<DateValue> | null, columnId?: string) => QueryFilter | null;
+//#endregion
+export { calendarDateToUTC, calendarDateToUTCEndOfDay, dateRangeToFilter, rangeToUrlString, urlStringToRange };
+//# sourceMappingURL=date.d.ts.map

package/dist/src/utils/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","names":[],"sources":["../../../src/utils/date.ts"],"mappings":";;;;;;;;;cAQa,iBAAA,GAAqB,IAAA,EAAM,YAAA;AAAxC;;;AAAA,cAOa,yBAAA,GAA6B,IAAA,EAAM,YAAA;;AAAhD;;cAOa,gBAAA,GAAoB,KAAA,EAAO,UAAA,CAAW,SAAA;;;AAAnD;cAkBa,gBAAA,GAAoB,KAAA,oBAAuB,UAAA,CAAW,SAAA;;;;cA0BtD,iBAAA,GACX,SAAA,EAAW,UAAA,CAAW,SAAA,UACtB,QAAA,cACC,WAAA"}

package/dist/src/utils/date.js

@@ -0,0 +1,66 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _internationalized_date = require("@internationalized/date");
+let luxon = require("luxon");
+//#region src/utils/date.ts
+/**
+* Convert CalendarDate to UTC ISO string at midnight UTC
+*/
+const calendarDateToUTC = (date) => {
+	return luxon.DateTime.utc(date.year, date.month, date.day).toISO() ?? "";
+};
+/**
+* Convert CalendarDate to UTC ISO string at end of day UTC
+*/
+const calendarDateToUTCEndOfDay = (date) => {
+	return luxon.DateTime.utc(date.year, date.month, date.day).endOf("day").toISO() ?? "";
+};
+/**
+* Convert RangeValue<DateValue> to URL string format "startISO,endISO"
+*/
+const rangeToUrlString = (range) => {
+	if (!range || !range.start || !range.end) return null;
+	const start = range.start;
+	const end = range.end;
+	if (!start?.year || !end?.year) return null;
+	return `${`${start.year}-${String(start.month).padStart(2, "0")}-${String(start.day).padStart(2, "0")}`},${`${end.year}-${String(end.month).padStart(2, "0")}-${String(end.day).padStart(2, "0")}`}`;
+};
+/**
+* Convert URL string "startISO,endISO" to RangeValue<DateValue>
+*/
+const urlStringToRange = (value) => {
+	if (!value) return null;
+	const [startISO, endISO] = value.split(",");
+	if (!startISO || !endISO) return null;
+	const tz = (0, _internationalized_date.getLocalTimeZone)();
+	const startZoned = (0, _internationalized_date.parseAbsolute)(`${startISO}T00:00:00Z`, tz);
+	const endZoned = (0, _internationalized_date.parseAbsolute)(`${endISO}T00:00:00Z`, tz);
+	if (!startZoned || !endZoned) return null;
+	return {
+		start: new _internationalized_date.CalendarDate(startZoned.year, startZoned.month, startZoned.day),
+		end: new _internationalized_date.CalendarDate(endZoned.year, endZoned.month, endZoned.day)
+	};
+};
+/**
+* Convert date range to QueryFilter format
+*/
+const dateRangeToFilter = (dateRange, columnId = "startedAt") => {
+	if (!dateRange || !dateRange.start || !dateRange.end) return null;
+	const start = dateRange.start;
+	const end = dateRange.end;
+	if (!start?.year || !end?.year) return null;
+	return {
+		columnId,
+		type: "date",
+		method: "between",
+		value: calendarDateToUTC(start),
+		valueTo: calendarDateToUTCEndOfDay(end)
+	};
+};
+//#endregion
+exports.calendarDateToUTC = calendarDateToUTC;
+exports.calendarDateToUTCEndOfDay = calendarDateToUTCEndOfDay;
+exports.dateRangeToFilter = dateRangeToFilter;
+exports.rangeToUrlString = rangeToUrlString;
+exports.urlStringToRange = urlStringToRange;
+
+//# sourceMappingURL=date.js.map

package/dist/src/utils/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","names":["DateTime","CalendarDate"],"sources":["../../../src/utils/date.ts"],"sourcesContent":["import type { DateValue, RangeValue } from \"@heroui/react\";\r\nimport { CalendarDate, getLocalTimeZone, parseAbsolute } from \"@internationalized/date\";\r\nimport type { QueryFilter } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport { DateTime } from \"luxon\";\r\n\r\n/**\r\n * Convert CalendarDate to UTC ISO string at midnight UTC\r\n */\r\nexport const calendarDateToUTC = (date: CalendarDate): string => {\r\n  return DateTime.utc(date.year, date.month, date.day).toISO() ?? \"\";\r\n};\r\n\r\n/**\r\n * Convert CalendarDate to UTC ISO string at end of day UTC\r\n */\r\nexport const calendarDateToUTCEndOfDay = (date: CalendarDate): string => {\r\n  return DateTime.utc(date.year, date.month, date.day).endOf(\"day\").toISO() ?? \"\";\r\n};\r\n\r\n/**\r\n * Convert RangeValue<DateValue> to URL string format \"startISO,endISO\"\r\n */\r\nexport const rangeToUrlString = (range: RangeValue<DateValue> | null): string | null => {\r\n  if (!range || !range.start || !range.end) return null;\r\n\r\n  const start = range.start as unknown as CalendarDate;\r\n  const end = range.end as unknown as CalendarDate;\r\n\r\n  if (!start?.year || !end?.year) return null;\r\n\r\n  // Format as ISO date strings (YYYY-MM-DD)\r\n  const startISO = `${start.year}-${String(start.month).padStart(2, \"0\")}-${String(start.day).padStart(2, \"0\")}`;\r\n  const endISO = `${end.year}-${String(end.month).padStart(2, \"0\")}-${String(end.day).padStart(2, \"0\")}`;\r\n\r\n  return `${startISO},${endISO}`;\r\n};\r\n\r\n/**\r\n * Convert URL string \"startISO,endISO\" to RangeValue<DateValue>\r\n */\r\nexport const urlStringToRange = (value: string | null): RangeValue<DateValue> | null => {\r\n  if (!value) return null;\r\n\r\n  const [startISO, endISO] = value.split(\",\");\r\n  if (!startISO || !endISO) return null;\r\n\r\n  const tz = getLocalTimeZone();\r\n\r\n  // Parse ISO date strings using parseAbsolute for proper timezone handling\r\n  const startZoned = parseAbsolute(`${startISO}T00:00:00Z`, tz);\r\n  const endZoned = parseAbsolute(`${endISO}T00:00:00Z`, tz);\r\n\r\n  if (!startZoned || !endZoned) return null;\r\n\r\n  const startDate = new CalendarDate(startZoned.year, startZoned.month, startZoned.day);\r\n  const endDate = new CalendarDate(endZoned.year, endZoned.month, endZoned.day);\r\n\r\n  return {\r\n    start: startDate as unknown as DateValue,\r\n    end: endDate as unknown as DateValue,\r\n  } as RangeValue<DateValue>;\r\n};\r\n\r\n/**\r\n * Convert date range to QueryFilter format\r\n */\r\nexport const dateRangeToFilter = (\r\n  dateRange: RangeValue<DateValue> | null,\r\n  columnId = \"startedAt\"\r\n): QueryFilter | null => {\r\n  if (!dateRange || !dateRange.start || !dateRange.end) return null;\r\n\r\n  const start = dateRange.start as unknown as CalendarDate;\r\n  const end = dateRange.end as unknown as CalendarDate;\r\n\r\n  if (!start?.year || !end?.year) return null;\r\n\r\n  const startISO = calendarDateToUTC(start);\r\n  const endISO = calendarDateToUTCEndOfDay(end);\r\n\r\n  return {\r\n    columnId,\r\n    type: \"date\",\r\n    method: \"between\",\r\n    value: startISO,\r\n    valueTo: endISO,\r\n  };\r\n};\r\n"],"mappings":";;;;;;;AAQA,MAAa,qBAAqB,SAA+B;AAC/D,QAAOA,MAAAA,SAAS,IAAI,KAAK,MAAM,KAAK,OAAO,KAAK,IAAI,CAAC,OAAO,IAAI;;;;;AAMlE,MAAa,6BAA6B,SAA+B;AACvE,QAAOA,MAAAA,SAAS,IAAI,KAAK,MAAM,KAAK,OAAO,KAAK,IAAI,CAAC,MAAM,MAAM,CAAC,OAAO,IAAI;;;;;AAM/E,MAAa,oBAAoB,UAAuD;AACtF,KAAI,CAAC,SAAS,CAAC,MAAM,SAAS,CAAC,MAAM,IAAK,QAAO;CAEjD,MAAM,QAAQ,MAAM;CACpB,MAAM,MAAM,MAAM;AAElB,KAAI,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAM,QAAO;AAMvC,QAAO,GAHU,GAAG,MAAM,KAAK,GAAG,OAAO,MAAM,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,OAAO,MAAM,IAAI,CAAC,SAAS,GAAG,IAAI,GAGzF,GAFJ,GAAG,IAAI,KAAK,GAAG,OAAO,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI;;;;;AAQtG,MAAa,oBAAoB,UAAuD;AACtF,KAAI,CAAC,MAAO,QAAO;CAEnB,MAAM,CAAC,UAAU,UAAU,MAAM,MAAM,IAAI;AAC3C,KAAI,CAAC,YAAY,CAAC,OAAQ,QAAO;CAEjC,MAAM,MAAA,GAAA,wBAAA,mBAAuB;CAG7B,MAAM,cAAA,GAAA,wBAAA,eAA2B,GAAG,SAAS,aAAa,GAAG;CAC7D,MAAM,YAAA,GAAA,wBAAA,eAAyB,GAAG,OAAO,aAAa,GAAG;AAEzD,KAAI,CAAC,cAAc,CAAC,SAAU,QAAO;AAKrC,QAAO;EACL,OAJgB,IAAIC,wBAAAA,aAAa,WAAW,MAAM,WAAW,OAAO,WAAW,IAAI;EAKnF,KAJc,IAAIA,wBAAAA,aAAa,SAAS,MAAM,SAAS,OAAO,SAAS,IAAI;EAK5E;;;;;AAMH,MAAa,qBACX,WACA,WAAW,gBACY;AACvB,KAAI,CAAC,aAAa,CAAC,UAAU,SAAS,CAAC,UAAU,IAAK,QAAO;CAE7D,MAAM,QAAQ,UAAU;CACxB,MAAM,MAAM,UAAU;AAEtB,KAAI,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAM,QAAO;AAKvC,QAAO;EACL;EACA,MAAM;EACN,QAAQ;EACR,OAPe,kBAAkB,MAAM;EAQvC,SAPa,0BAA0B,IAAI;EAQ5C"}

package/dist/src/utils/query.d.ts

@@ -0,0 +1,10 @@
+//#region src/utils/query.d.ts
+declare class QueryCache {
+  update: <T extends Record<K, any>, A extends string | null = null, K extends string = "id">(element: T | T[], accessor?: A, key?: K) => <D>(data: D) => D;
+  delete: <T extends Record<K, any>, D extends (A extends string ? { [key in A]: T[] } : T[]) | undefined, A extends string | null = null, K extends string = "id">(element: T | T[], accessor?: A, key?: K) => <OriginalD extends D>(data: OriginalD) => OriginalD;
+  create: <T extends Record<string, any>, D extends (A extends string ? { [key in A]: T[] } : T[]) | undefined, A extends string | null = null>(element: T | T[], accessor?: A) => <OriginalD extends D>(data: OriginalD) => OriginalD;
+}
+declare const queryCache: QueryCache;
+//#endregion
+export { queryCache };
+//# sourceMappingURL=query.d.ts.map

package/dist/src/utils/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","names":[],"sources":["../../../src/utils/query.ts"],"mappings":";cAAM,UAAA;EACJ,MAAA,aACa,MAAA,CAAO,CAAA,iEAChB,OAAA,EAAS,CAAA,GAAI,CAAA,IACb,QAAA,GAAU,CAAA,EACV,GAAA,GAAK,CAAA,SAEH,IAAA,EAAM,CAAA,KAAI,CAAA;EAmBhB,MAAA,aAEc,MAAA,CAAO,CAAA,mBACN,CAAA,4BAA6B,CAAA,GAAI,CAAA,OAAQ,CAAA,0EAIpD,OAAA,EAAS,CAAA,GAAI,CAAA,IACb,QAAA,GAAU,CAAA,EACV,GAAA,GAAK,CAAA,wBAEY,CAAA,EAAG,IAAA,EAAM,SAAA,KAAY,SAAA;EAc1C,MAAA,aAEc,MAAA,0BACC,CAAA,4BAA6B,CAAA,GAAI,CAAA,OAAQ,CAAA,iDAGpD,OAAA,EAAS,CAAA,GAAI,CAAA,IACb,QAAA,GAAU,CAAA,wBAEO,CAAA,EAAG,IAAA,EAAM,SAAA,KAAY,SAAA;AAAA;AAAA,cAW/B,UAAA,EAAU,UAAA"}

package/dist/src/utils/query.js

@@ -0,0 +1,44 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/utils/query.ts
+var QueryCache = class {
+	update = (element, accessor = null, key = "id") => (data) => {
+		if (!data) return data;
+		const target = accessor ? data[accessor] : data;
+		if (!Array.isArray(target)) return data;
+		const modified = target.map((item) => {
+			return (Array.isArray(element) ? element.findIndex((el) => el[key] === item[key]) > -1 : element[key] === item[key]) ? {
+				...item,
+				...Array.isArray(element) ? element.find((el) => el[key] === item[key]) : element
+			} : item;
+		});
+		return accessor ? {
+			...data,
+			[accessor]: modified
+		} : modified;
+	};
+	delete = (element, accessor = null, key = "id") => (data) => {
+		if (!data) return data;
+		const target = accessor ? data[accessor] : data;
+		if (!Array.isArray(target)) return data;
+		const modified = target.filter((item) => Array.isArray(element) ? element.findIndex((el) => el[key] === item[key]) === -1 : item[key] !== element[key]);
+		return accessor ? {
+			...data,
+			[accessor]: modified
+		} : modified;
+	};
+	create = (element, accessor = null) => (data) => {
+		if (!data) return data;
+		const target = accessor ? data[accessor] : data;
+		if (!target) return data;
+		const modified = [...target, ...Array.isArray(element) ? element : [element]];
+		return accessor ? {
+			...data,
+			[accessor]: modified
+		} : modified;
+	};
+};
+const queryCache = new QueryCache();
+//#endregion
+exports.queryCache = queryCache;
+
+//# sourceMappingURL=query.js.map