@m5kdev/frontend 0.20.51 → 0.21.0

package/dist/src/modules/table/queryParams.d.ts

@@ -0,0 +1,34 @@
+import { QueryFilter, QueryFilters } from "@m5kdev/commons/modules/schemas/query.schema";
+import { GroupingState, PaginationState, SortingState, Updater } from "@tanstack/react-table";
+
+//#region src/modules/table/queryParams.d.ts
+declare function serializeFiltersParam(rows: string[][]): string;
+declare function parseFiltersParam(value: string): string[][] | null;
+/** Builds URL tuple; omits optional tails when unused (endColumnId requires valueTo slot - may be ""). */
+declare function encodeFilterToTuple(filter: QueryFilter): string[];
+declare function decodeTupleToFilter(parts: readonly string[]): QueryFilter | null;
+declare function decodeFilterTuples(rows: readonly string[][]): QueryFilters;
+type Order = "asc" | "desc";
+type Granularity = "daily" | "weekly" | "monthly" | "yearly";
+interface QueryParamsState {
+  /** Global search string; absent when not set. */
+  q: string | null;
+  setQ: (value: string | null) => void;
+  filters?: QueryFilters;
+  setFilters?: (filters: QueryFilters) => void;
+  granularity?: Granularity;
+  setGranularity?: (value: Granularity) => void;
+  sort?: string;
+  order?: Order | null;
+  setSorting?: (updater: Updater<SortingState>) => void;
+  sorting?: SortingState;
+  page?: number;
+  limit?: number;
+  setPagination?: (updater: Updater<PaginationState>) => void;
+  pagination?: PaginationState;
+  grouping: GroupingState;
+  setGrouping: (updater: Updater<GroupingState>) => void;
+}
+//#endregion
+export { Granularity, Order, QueryParamsState, decodeFilterTuples, decodeTupleToFilter, encodeFilterToTuple, parseFiltersParam, serializeFiltersParam };
+//# sourceMappingURL=queryParams.d.ts.map

package/dist/src/modules/table/queryParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryParams.d.ts","names":[],"sources":["../../../../src/modules/table/queryParams.ts"],"mappings":";;;;iBAyDgB,qBAAA,CAAsB,IAAA;AAAA,iBAOtB,iBAAA,CAAkB,KAAA;AAPlC;AAAA,iBAoGgB,mBAAA,CAAoB,MAAA,EAAQ,WAAA;AAAA,iBAmB5B,mBAAA,CAAoB,KAAA,sBAA2B,WAAA;AAAA,iBAmC/C,kBAAA,CAAmB,IAAA,wBAA4B,YAAA;AAAA,KAQnD,KAAA;AAAA,KAEA,WAAA;AAAA,UAEK,gBAAA;;EAEf,CAAA;EACA,IAAA,GAAO,KAAA;EACP,OAAA,GAAU,YAAA;EACV,UAAA,IAAc,OAAA,EAAS,YAAA;EACvB,WAAA,GAAc,WAAA;EACd,cAAA,IAAkB,KAAA,EAAO,WAAA;EACzB,IAAA;EACA,KAAA,GAAQ,KAAA;EACR,UAAA,IAAc,OAAA,EAAS,OAAA,CAAQ,YAAA;EAC/B,OAAA,GAAU,YAAA;EACV,IAAA;EACA,KAAA;EACA,aAAA,IAAiB,OAAA,EAAS,OAAA,CAAQ,eAAA;EAClC,UAAA,GAAa,eAAA;EACb,QAAA,EAAU,aAAA;EACV,WAAA,GAAc,OAAA,EAAS,OAAA,CAAQ,aAAA;AAAA"}

package/dist/src/modules/table/{hooks/useNuqsQueryParams.js → queryParams.js}

@@ -1,10 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-let react = require("react");
 let _m5kdev_commons_modules_schemas_query_schema = require("@m5kdev/commons/modules/schemas/query.schema");
-let nuqs = require("nuqs");
 let zod = require("zod");
-//#region src/modules/table/hooks/useNuqsQueryParams.ts
-/** Each row: [columnId, type, method, value, valueTo?, endColumnId?] — validated after parse */
+//#region src/modules/table/queryParams.ts
+/** Each row: [columnId, type, method, value, valueTo?, endColumnId?] - validated after parse */
 const filtersRawSchema = zod.z.array(zod.z.array(zod.z.string()).min(4).max(6));
 /** Escape `\`, `|`, `;` so we can split filters without JSON quotes/brackets. */
 function escapeFilterField(raw) {
@@ -67,12 +65,6 @@ function parseFiltersParam(value) {
 	const parsed = filtersRawSchema.safeParse(rows);
 	return parsed.success ? parsed.data : null;
 }
-const parseAsFilterTuples = (0, nuqs.createParser)({
-	parse: (value) => parseFiltersParam(value),
-	serialize: (rows) => serializeFiltersParam(rows),
-	eq: (a, b) => JSON.stringify(a) === JSON.stringify(b)
-}).withDefault([]);
-const parseAsGrouping = (0, nuqs.parseAsArrayOf)(nuqs.parseAsString).withDefault([]);
 const NULLISH_METHODS = new Set([
 	"isEmpty",
 	"isNotEmpty",
@@ -117,7 +109,7 @@ function decodeFilterValue(type, method, valueStr) {
 		default: return valueStr;
 	}
 }
-/** Builds URL tuple; omits optional tails when unused (endColumnId requires valueTo slot — may be ""). */
+/** Builds URL tuple; omits optional tails when unused (endColumnId requires valueTo slot - may be ""). */
 function encodeFilterToTuple(filter) {
 	const tuple = [
 		filter.columnId,
@@ -153,124 +145,16 @@ function decodeTupleToFilter(parts) {
 	const parsed = _m5kdev_commons_modules_schemas_query_schema.filterSchema.safeParse(candidate);
 	return parsed.success ? parsed.data : null;
 }
-/**
-* Hook to manage all query parameters via nuqs (URL query parameters)
-* Manages: `f` (filters as tuple arrays), `q`, `s`/`o`, `p`/`l`, `g`, `r`
-* Accepts an optional prefix to namespace params when multiple tables share a view.
-*/
-const useNuqsQueryParams = (prefix) => {
-	const k = (name) => prefix ? `${prefix}_${name}` : name;
-	const [sort, setSort] = (0, nuqs.useQueryState)(k("s"), nuqs.parseAsString.withDefault(""));
-	const [order, setOrder] = (0, nuqs.useQueryState)(k("o"), (0, nuqs.parseAsStringLiteral)(["asc", "desc"]));
-	const [page, setPage] = (0, nuqs.useQueryState)(k("p"), nuqs.parseAsInteger.withDefault(1));
-	const [limit, setLimit] = (0, nuqs.useQueryState)(k("l"), nuqs.parseAsInteger.withDefault(10));
-	const [qRaw, setQRaw] = (0, nuqs.useQueryState)(k("q"), nuqs.parseAsString);
-	const [filtersRaw, setFiltersRaw] = (0, nuqs.useQueryState)(k("f"), parseAsFilterTuples);
-	const filters = (0, react.useMemo)(() => {
-		const decoded = filtersRaw.map((row) => decodeTupleToFilter(row)).filter((f) => f != null);
-		const parsed = _m5kdev_commons_modules_schemas_query_schema.filtersSchema.safeParse(decoded);
-		return parsed.success ? parsed.data : [];
-	}, [filtersRaw]);
-	const setFilters = (0, react.useCallback)((next) => {
-		setFiltersRaw(next.length === 0 ? null : next.map(encodeFilterToTuple));
-	}, [setFiltersRaw]);
-	const setQ = (0, react.useCallback)((value) => {
-		setQRaw(value === "" || value == null ? null : value);
-	}, [setQRaw]);
-	const [granularity, setGranularity] = (0, nuqs.useQueryState)(k("r"), (0, nuqs.parseAsStringLiteral)([
-		"daily",
-		"weekly",
-		"monthly",
-		"yearly"
-	]).withDefault("daily"));
-	const [groupingRaw, setGroupingRaw] = (0, nuqs.useQueryState)(k("g"), parseAsGrouping);
-	const grouping = groupingRaw;
-	const setGrouping = (0, react.useCallback)((updater) => {
-		const next = typeof updater === "function" ? updater(groupingRaw) : updater;
-		setGroupingRaw(next.length > 0 ? next : null);
-	}, [groupingRaw, setGroupingRaw]);
-	const sorting = (0, react.useMemo)(() => {
-		if (!sort) return [];
-		return [{
-			id: sort,
-			desc: (order ?? "asc") === "desc"
-		}];
-	}, [sort, order]);
-	const pagination = (0, react.useMemo)(() => ({
-		pageIndex: page - 1,
-		pageSize: limit
-	}), [page, limit]);
-	const setSorting = (0, react.useCallback)((updater) => {
-		const first = (typeof updater === "function" ? updater(sort ? [{
-			id: sort,
-			desc: (order ?? "asc") === "desc"
-		}] : []) : updater)[0];
-		if (!first || !first.id) {
-			setSort("");
-			setOrder(null);
-			return;
-		}
-		setSort(first.id);
-		setOrder(first.desc ? "desc" : "asc");
-	}, [
-		sort,
-		order,
-		setSort,
-		setOrder
-	]);
-	(0, react.useEffect)(() => {
-		if (sort && !order) setOrder("asc");
-	}, [
-		sort,
-		order,
-		setOrder
-	]);
-	const setPagination = (0, react.useCallback)((updater) => {
-		const currentState = {
-			pageIndex: page - 1,
-			pageSize: limit
-		};
-		const next = typeof updater === "function" ? updater(currentState) : updater;
-		setPage((next.pageIndex ?? 0) + 1);
-		setLimit(next.pageSize ?? 10);
-	}, [page, limit]);
-	return (0, react.useMemo)(() => ({
-		q: qRaw,
-		setQ,
-		filters,
-		setFilters,
-		granularity,
-		setGranularity,
-		sort,
-		order,
-		setSorting,
-		sorting,
-		page,
-		limit,
-		setPagination,
-		pagination,
-		grouping,
-		setGrouping
-	}), [
-		qRaw,
-		setQ,
-		filters,
-		setFilters,
-		granularity,
-		setGranularity,
-		sort,
-		order,
-		setSorting,
-		sorting,
-		page,
-		limit,
-		setPagination,
-		pagination,
-		grouping,
-		setGrouping
-	]);
-};
+function decodeFilterTuples(rows) {
+	const decoded = rows.map((row) => decodeTupleToFilter(row)).filter((filter) => filter != null);
+	const parsed = _m5kdev_commons_modules_schemas_query_schema.filtersSchema.safeParse(decoded);
+	return parsed.success ? parsed.data : [];
+}
 //#endregion
-exports.useNuqsQueryParams = useNuqsQueryParams;
+exports.decodeFilterTuples = decodeFilterTuples;
+exports.decodeTupleToFilter = decodeTupleToFilter;
+exports.encodeFilterToTuple = encodeFilterToTuple;
+exports.parseFiltersParam = parseFiltersParam;
+exports.serializeFiltersParam = serializeFiltersParam;
 
-//# sourceMappingURL=useNuqsQueryParams.js.map
+//# sourceMappingURL=queryParams.js.map

package/dist/src/modules/table/queryParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryParams.js","names":["z","filterSchema","filtersSchema"],"sources":["../../../../src/modules/table/queryParams.ts"],"sourcesContent":["import type { QueryFilter, QueryFilters } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport { filterSchema, filtersSchema } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport type { GroupingState, PaginationState, SortingState, Updater } from \"@tanstack/react-table\";\r\nimport { z } from \"zod\";\r\n\r\n/** Each row: [columnId, type, method, value, valueTo?, endColumnId?] - validated after parse */\r\nconst filtersRawSchema = z.array(z.array(z.string()).min(4).max(6));\r\n\r\n/** Escape `\\`, `|`, `;` so we can split filters without JSON quotes/brackets. */\r\nfunction escapeFilterField(raw: string): string {\r\n  return raw.replace(/\\\\/g, \"\\\\\\\\\").replace(/\\|/g, \"\\\\|\").replace(/;/g, \"\\\\;\");\r\n}\r\n\r\nfunction unescapeFilterField(encoded: string): string {\r\n  let out = \"\";\r\n  for (let i = 0; i < encoded.length; i++) {\r\n    const c = encoded[i];\r\n    if (c === \"\\\\\" && i + 1 < encoded.length) {\r\n      const next = encoded[i + 1];\r\n      if (next === \"\\\\\" || next === \"|\" || next === \";\") {\r\n        out += next;\r\n        i++;\r\n        continue;\r\n      }\r\n    }\r\n    out += c;\r\n  }\r\n  return out;\r\n}\r\n\r\n/**\r\n * Split on `delimiter` only when not escaped as `\\` + delimiter.\r\n */\r\nfunction splitByEscapedDelimiter(s: string, delimiter: string): string[] {\r\n  if (delimiter.length !== 1) {\r\n    throw new Error(\"splitByEscapedDelimiter expects a single-character delimiter\");\r\n  }\r\n  const parts: string[] = [];\r\n  let buf = \"\";\r\n  for (let i = 0; i < s.length; i++) {\r\n    const c = s[i];\r\n    if (c === \"\\\\\" && i + 1 < s.length) {\r\n      buf += c + s[i + 1];\r\n      i++;\r\n      continue;\r\n    }\r\n    if (c === delimiter) {\r\n      parts.push(unescapeFilterField(buf));\r\n      buf = \"\";\r\n      continue;\r\n    }\r\n    buf += c;\r\n  }\r\n  parts.push(unescapeFilterField(buf));\r\n  return parts;\r\n}\r\n\r\nexport function serializeFiltersParam(rows: string[][]): string {\r\n  if (rows.length === 0) {\r\n    return \"\";\r\n  }\r\n  return rows.map((row) => row.map(escapeFilterField).join(\"|\")).join(\";\");\r\n}\r\n\r\nexport function parseFiltersParam(value: string): string[][] | null {\r\n  const trimmed = value.trim();\r\n  if (trimmed === \"\") {\r\n    return [];\r\n  }\r\n  const rowStrings = splitByEscapedDelimiter(trimmed, \";\");\r\n  const rows: string[][] = [];\r\n  for (const row of rowStrings) {\r\n    if (row === \"\") {\r\n      continue;\r\n    }\r\n    const fields = splitByEscapedDelimiter(row, \"|\");\r\n    if (fields.length >= 4 && fields.length <= 6) {\r\n      rows.push(fields);\r\n    }\r\n  }\r\n  const parsed = filtersRawSchema.safeParse(rows);\r\n  return parsed.success ? parsed.data : null;\r\n}\r\n\r\nconst NULLISH_METHODS: ReadonlySet<QueryFilter[\"method\"]> = new Set([\r\n  \"isEmpty\",\r\n  \"isNotEmpty\",\r\n  \"is_null\",\r\n  \"is_not_null\",\r\n]);\r\n\r\nfunction encodeFilterValue(filter: QueryFilter): string {\r\n  if (NULLISH_METHODS.has(filter.method)) {\r\n    return typeof filter.value === \"string\" ? filter.value : \"\";\r\n  }\r\n  const { type, method, value } = filter;\r\n  switch (type) {\r\n    case \"number\":\r\n      return String(value as number);\r\n    case \"boolean\":\r\n      return (value as boolean) ? \"true\" : \"false\";\r\n    case \"enum\":\r\n    case \"jsonArray\":\r\n      if (method === \"oneOf\" && Array.isArray(value)) {\r\n        return JSON.stringify(value);\r\n      }\r\n      if (Array.isArray(value)) {\r\n        return JSON.stringify(value);\r\n      }\r\n      return String(value);\r\n    default:\r\n      return String(value);\r\n  }\r\n}\r\n\r\nfunction decodeFilterValue(\r\n  type: QueryFilter[\"type\"],\r\n  method: QueryFilter[\"method\"],\r\n  valueStr: string\r\n): QueryFilter[\"value\"] {\r\n  if (NULLISH_METHODS.has(method)) {\r\n    return valueStr;\r\n  }\r\n  switch (type) {\r\n    case \"number\": {\r\n      const n = Number.parseFloat(valueStr);\r\n      return Number.isNaN(n) ? 0 : n;\r\n    }\r\n    case \"boolean\":\r\n      return valueStr === \"true\";\r\n    case \"enum\":\r\n    case \"jsonArray\":\r\n      if (method === \"oneOf\") {\r\n        try {\r\n          const parsed = JSON.parse(valueStr) as unknown;\r\n          return Array.isArray(parsed) ? parsed.map(String) : [];\r\n        } catch {\r\n          return [];\r\n        }\r\n      }\r\n      if (valueStr.startsWith(\"[\")) {\r\n        try {\r\n          const parsed = JSON.parse(valueStr) as unknown;\r\n          if (Array.isArray(parsed)) {\r\n            return parsed.map(String);\r\n          }\r\n        } catch {\r\n          /* use raw string */\r\n        }\r\n      }\r\n      return valueStr;\r\n    default:\r\n      return valueStr;\r\n  }\r\n}\r\n\r\n/** Builds URL tuple; omits optional tails when unused (endColumnId requires valueTo slot - may be \"\"). */\r\nexport function encodeFilterToTuple(filter: QueryFilter): string[] {\r\n  const tuple: string[] = [filter.columnId, filter.type, filter.method, encodeFilterValue(filter)];\r\n  const hasValueTo = filter.valueTo != null && filter.valueTo !== \"\";\r\n  const hasEndColumnId = filter.endColumnId != null && filter.endColumnId !== \"\";\r\n\r\n  if (hasValueTo && filter.valueTo != null) {\r\n    tuple.push(filter.valueTo);\r\n  }\r\n\r\n  if (hasEndColumnId && filter.endColumnId != null) {\r\n    if (!hasValueTo) {\r\n      tuple.push(\"\");\r\n    }\r\n    tuple.push(filter.endColumnId);\r\n  }\r\n\r\n  return tuple;\r\n}\r\n\r\nexport function decodeTupleToFilter(parts: readonly string[]): QueryFilter | null {\r\n  if (parts.length < 4 || parts.length > 6) {\r\n    return null;\r\n  }\r\n\r\n  const [columnId, typeStr, methodStr, valueStr, valueToStr, endColumnIdStr] = parts;\r\n\r\n  const typeParsed = filterSchema.shape.type.safeParse(typeStr);\r\n  const methodParsed = filterSchema.shape.method.safeParse(methodStr);\r\n  if (!typeParsed.success || !methodParsed.success) {\r\n    return null;\r\n  }\r\n\r\n  const type = typeParsed.data;\r\n  const method = methodParsed.data;\r\n  const value = decodeFilterValue(type, method, valueStr);\r\n\r\n  const candidate: QueryFilter = {\r\n    columnId,\r\n    type,\r\n    method,\r\n    value,\r\n  };\r\n\r\n  if (valueToStr !== undefined) {\r\n    candidate.valueTo = valueToStr;\r\n  }\r\n  if (endColumnIdStr !== undefined) {\r\n    candidate.endColumnId = endColumnIdStr;\r\n  }\r\n\r\n  const parsed = filterSchema.safeParse(candidate);\r\n  return parsed.success ? parsed.data : null;\r\n}\r\n\r\nexport function decodeFilterTuples(rows: readonly string[][]): QueryFilters {\r\n  const decoded = rows\r\n    .map((row) => decodeTupleToFilter(row))\r\n    .filter((filter): filter is QueryFilter => filter != null);\r\n  const parsed = filtersSchema.safeParse(decoded);\r\n  return parsed.success ? parsed.data : [];\r\n}\r\n\r\nexport type Order = \"asc\" | \"desc\";\r\n\r\nexport type Granularity = \"daily\" | \"weekly\" | \"monthly\" | \"yearly\";\r\n\r\nexport interface QueryParamsState {\r\n  /** Global search string; absent when not set. */\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"],"mappings":"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"}

package/dist/src/modules/table/{hooks/useNuqsQueryParams.mjs → queryParams.mjs}

@@ -1,9 +1,7 @@
-import { useCallback, useEffect, useMemo } from "react";
 import { filterSchema, filtersSchema } from "@m5kdev/commons/modules/schemas/query.schema";
-import { createParser, parseAsArrayOf, parseAsInteger, parseAsString, parseAsStringLiteral, useQueryState } from "nuqs";
 import { z } from "zod";
-//#region src/modules/table/hooks/useNuqsQueryParams.ts
-/** Each row: [columnId, type, method, value, valueTo?, endColumnId?] — validated after parse */
+//#region src/modules/table/queryParams.ts
+/** Each row: [columnId, type, method, value, valueTo?, endColumnId?] - validated after parse */
 const filtersRawSchema = z.array(z.array(z.string()).min(4).max(6));
 /** Escape `\`, `|`, `;` so we can split filters without JSON quotes/brackets. */
 function escapeFilterField(raw) {
@@ -66,12 +64,6 @@ function parseFiltersParam(value) {
 	const parsed = filtersRawSchema.safeParse(rows);
 	return parsed.success ? parsed.data : null;
 }
-const parseAsFilterTuples = createParser({
-	parse: (value) => parseFiltersParam(value),
-	serialize: (rows) => serializeFiltersParam(rows),
-	eq: (a, b) => JSON.stringify(a) === JSON.stringify(b)
-}).withDefault([]);
-const parseAsGrouping = parseAsArrayOf(parseAsString).withDefault([]);
 const NULLISH_METHODS = new Set([
 	"isEmpty",
 	"isNotEmpty",
@@ -116,7 +108,7 @@ function decodeFilterValue(type, method, valueStr) {
 		default: return valueStr;
 	}
 }
-/** Builds URL tuple; omits optional tails when unused (endColumnId requires valueTo slot — may be ""). */
+/** Builds URL tuple; omits optional tails when unused (endColumnId requires valueTo slot - may be ""). */
 function encodeFilterToTuple(filter) {
 	const tuple = [
 		filter.columnId,
@@ -152,124 +144,12 @@ function decodeTupleToFilter(parts) {
 	const parsed = filterSchema.safeParse(candidate);
 	return parsed.success ? parsed.data : null;
 }
-/**
-* Hook to manage all query parameters via nuqs (URL query parameters)
-* Manages: `f` (filters as tuple arrays), `q`, `s`/`o`, `p`/`l`, `g`, `r`
-* Accepts an optional prefix to namespace params when multiple tables share a view.
-*/
-const useNuqsQueryParams = (prefix) => {
-	const k = (name) => prefix ? `${prefix}_${name}` : name;
-	const [sort, setSort] = useQueryState(k("s"), parseAsString.withDefault(""));
-	const [order, setOrder] = useQueryState(k("o"), parseAsStringLiteral(["asc", "desc"]));
-	const [page, setPage] = useQueryState(k("p"), parseAsInteger.withDefault(1));
-	const [limit, setLimit] = useQueryState(k("l"), parseAsInteger.withDefault(10));
-	const [qRaw, setQRaw] = useQueryState(k("q"), parseAsString);
-	const [filtersRaw, setFiltersRaw] = useQueryState(k("f"), parseAsFilterTuples);
-	const filters = useMemo(() => {
-		const decoded = filtersRaw.map((row) => decodeTupleToFilter(row)).filter((f) => f != null);
-		const parsed = filtersSchema.safeParse(decoded);
-		return parsed.success ? parsed.data : [];
-	}, [filtersRaw]);
-	const setFilters = useCallback((next) => {
-		setFiltersRaw(next.length === 0 ? null : next.map(encodeFilterToTuple));
-	}, [setFiltersRaw]);
-	const setQ = useCallback((value) => {
-		setQRaw(value === "" || value == null ? null : value);
-	}, [setQRaw]);
-	const [granularity, setGranularity] = useQueryState(k("r"), parseAsStringLiteral([
-		"daily",
-		"weekly",
-		"monthly",
-		"yearly"
-	]).withDefault("daily"));
-	const [groupingRaw, setGroupingRaw] = useQueryState(k("g"), parseAsGrouping);
-	const grouping = groupingRaw;
-	const setGrouping = useCallback((updater) => {
-		const next = typeof updater === "function" ? updater(groupingRaw) : updater;
-		setGroupingRaw(next.length > 0 ? next : null);
-	}, [groupingRaw, setGroupingRaw]);
-	const sorting = useMemo(() => {
-		if (!sort) return [];
-		return [{
-			id: sort,
-			desc: (order ?? "asc") === "desc"
-		}];
-	}, [sort, order]);
-	const pagination = useMemo(() => ({
-		pageIndex: page - 1,
-		pageSize: limit
-	}), [page, limit]);
-	const setSorting = useCallback((updater) => {
-		const first = (typeof updater === "function" ? updater(sort ? [{
-			id: sort,
-			desc: (order ?? "asc") === "desc"
-		}] : []) : updater)[0];
-		if (!first || !first.id) {
-			setSort("");
-			setOrder(null);
-			return;
-		}
-		setSort(first.id);
-		setOrder(first.desc ? "desc" : "asc");
-	}, [
-		sort,
-		order,
-		setSort,
-		setOrder
-	]);
-	useEffect(() => {
-		if (sort && !order) setOrder("asc");
-	}, [
-		sort,
-		order,
-		setOrder
-	]);
-	const setPagination = useCallback((updater) => {
-		const currentState = {
-			pageIndex: page - 1,
-			pageSize: limit
-		};
-		const next = typeof updater === "function" ? updater(currentState) : updater;
-		setPage((next.pageIndex ?? 0) + 1);
-		setLimit(next.pageSize ?? 10);
-	}, [page, limit]);
-	return useMemo(() => ({
-		q: qRaw,
-		setQ,
-		filters,
-		setFilters,
-		granularity,
-		setGranularity,
-		sort,
-		order,
-		setSorting,
-		sorting,
-		page,
-		limit,
-		setPagination,
-		pagination,
-		grouping,
-		setGrouping
-	}), [
-		qRaw,
-		setQ,
-		filters,
-		setFilters,
-		granularity,
-		setGranularity,
-		sort,
-		order,
-		setSorting,
-		sorting,
-		page,
-		limit,
-		setPagination,
-		pagination,
-		grouping,
-		setGrouping
-	]);
-};
+function decodeFilterTuples(rows) {
+	const decoded = rows.map((row) => decodeTupleToFilter(row)).filter((filter) => filter != null);
+	const parsed = filtersSchema.safeParse(decoded);
+	return parsed.success ? parsed.data : [];
+}
 //#endregion
-export { useNuqsQueryParams };
+export { decodeFilterTuples, decodeTupleToFilter, encodeFilterToTuple, parseFiltersParam, serializeFiltersParam };
 
-//# sourceMappingURL=useNuqsQueryParams.mjs.map
+//# sourceMappingURL=queryParams.mjs.map

package/dist/src/modules/table/queryParams.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryParams.mjs","names":[],"sources":["../../../../src/modules/table/queryParams.ts"],"sourcesContent":["import type { QueryFilter, QueryFilters } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport { filterSchema, filtersSchema } from \"@m5kdev/commons/modules/schemas/query.schema\";\r\nimport type { GroupingState, PaginationState, SortingState, Updater } from \"@tanstack/react-table\";\r\nimport { z } from \"zod\";\r\n\r\n/** Each row: [columnId, type, method, value, valueTo?, endColumnId?] - validated after parse */\r\nconst filtersRawSchema = z.array(z.array(z.string()).min(4).max(6));\r\n\r\n/** Escape `\\`, `|`, `;` so we can split filters without JSON quotes/brackets. */\r\nfunction escapeFilterField(raw: string): string {\r\n  return raw.replace(/\\\\/g, \"\\\\\\\\\").replace(/\\|/g, \"\\\\|\").replace(/;/g, \"\\\\;\");\r\n}\r\n\r\nfunction unescapeFilterField(encoded: string): string {\r\n  let out = \"\";\r\n  for (let i = 0; i < encoded.length; i++) {\r\n    const c = encoded[i];\r\n    if (c === \"\\\\\" && i + 1 < encoded.length) {\r\n      const next = encoded[i + 1];\r\n      if (next === \"\\\\\" || next === \"|\" || next === \";\") {\r\n        out += next;\r\n        i++;\r\n        continue;\r\n      }\r\n    }\r\n    out += c;\r\n  }\r\n  return out;\r\n}\r\n\r\n/**\r\n * Split on `delimiter` only when not escaped as `\\` + delimiter.\r\n */\r\nfunction splitByEscapedDelimiter(s: string, delimiter: string): string[] {\r\n  if (delimiter.length !== 1) {\r\n    throw new Error(\"splitByEscapedDelimiter expects a single-character delimiter\");\r\n  }\r\n  const parts: string[] = [];\r\n  let buf = \"\";\r\n  for (let i = 0; i < s.length; i++) {\r\n    const c = s[i];\r\n    if (c === \"\\\\\" && i + 1 < s.length) {\r\n      buf += c + s[i + 1];\r\n      i++;\r\n      continue;\r\n    }\r\n    if (c === delimiter) {\r\n      parts.push(unescapeFilterField(buf));\r\n      buf = \"\";\r\n      continue;\r\n    }\r\n    buf += c;\r\n  }\r\n  parts.push(unescapeFilterField(buf));\r\n  return parts;\r\n}\r\n\r\nexport function serializeFiltersParam(rows: string[][]): string {\r\n  if (rows.length === 0) {\r\n    return \"\";\r\n  }\r\n  return rows.map((row) => row.map(escapeFilterField).join(\"|\")).join(\";\");\r\n}\r\n\r\nexport function parseFiltersParam(value: string): string[][] | null {\r\n  const trimmed = value.trim();\r\n  if (trimmed === \"\") {\r\n    return [];\r\n  }\r\n  const rowStrings = splitByEscapedDelimiter(trimmed, \";\");\r\n  const rows: string[][] = [];\r\n  for (const row of rowStrings) {\r\n    if (row === \"\") {\r\n      continue;\r\n    }\r\n    const fields = splitByEscapedDelimiter(row, \"|\");\r\n    if (fields.length >= 4 && fields.length <= 6) {\r\n      rows.push(fields);\r\n    }\r\n  }\r\n  const parsed = filtersRawSchema.safeParse(rows);\r\n  return parsed.success ? parsed.data : null;\r\n}\r\n\r\nconst NULLISH_METHODS: ReadonlySet<QueryFilter[\"method\"]> = new Set([\r\n  \"isEmpty\",\r\n  \"isNotEmpty\",\r\n  \"is_null\",\r\n  \"is_not_null\",\r\n]);\r\n\r\nfunction encodeFilterValue(filter: QueryFilter): string {\r\n  if (NULLISH_METHODS.has(filter.method)) {\r\n    return typeof filter.value === \"string\" ? filter.value : \"\";\r\n  }\r\n  const { type, method, value } = filter;\r\n  switch (type) {\r\n    case \"number\":\r\n      return String(value as number);\r\n    case \"boolean\":\r\n      return (value as boolean) ? \"true\" : \"false\";\r\n    case \"enum\":\r\n    case \"jsonArray\":\r\n      if (method === \"oneOf\" && Array.isArray(value)) {\r\n        return JSON.stringify(value);\r\n      }\r\n      if (Array.isArray(value)) {\r\n        return JSON.stringify(value);\r\n      }\r\n      return String(value);\r\n    default:\r\n      return String(value);\r\n  }\r\n}\r\n\r\nfunction decodeFilterValue(\r\n  type: QueryFilter[\"type\"],\r\n  method: QueryFilter[\"method\"],\r\n  valueStr: string\r\n): QueryFilter[\"value\"] {\r\n  if (NULLISH_METHODS.has(method)) {\r\n    return valueStr;\r\n  }\r\n  switch (type) {\r\n    case \"number\": {\r\n      const n = Number.parseFloat(valueStr);\r\n      return Number.isNaN(n) ? 0 : n;\r\n    }\r\n    case \"boolean\":\r\n      return valueStr === \"true\";\r\n    case \"enum\":\r\n    case \"jsonArray\":\r\n      if (method === \"oneOf\") {\r\n        try {\r\n          const parsed = JSON.parse(valueStr) as unknown;\r\n          return Array.isArray(parsed) ? parsed.map(String) : [];\r\n        } catch {\r\n          return [];\r\n        }\r\n      }\r\n      if (valueStr.startsWith(\"[\")) {\r\n        try {\r\n          const parsed = JSON.parse(valueStr) as unknown;\r\n          if (Array.isArray(parsed)) {\r\n            return parsed.map(String);\r\n          }\r\n        } catch {\r\n          /* use raw string */\r\n        }\r\n      }\r\n      return valueStr;\r\n    default:\r\n      return valueStr;\r\n  }\r\n}\r\n\r\n/** Builds URL tuple; omits optional tails when unused (endColumnId requires valueTo slot - may be \"\"). */\r\nexport function encodeFilterToTuple(filter: QueryFilter): string[] {\r\n  const tuple: string[] = [filter.columnId, filter.type, filter.method, encodeFilterValue(filter)];\r\n  const hasValueTo = filter.valueTo != null && filter.valueTo !== \"\";\r\n  const hasEndColumnId = filter.endColumnId != null && filter.endColumnId !== \"\";\r\n\r\n  if (hasValueTo && filter.valueTo != null) {\r\n    tuple.push(filter.valueTo);\r\n  }\r\n\r\n  if (hasEndColumnId && filter.endColumnId != null) {\r\n    if (!hasValueTo) {\r\n      tuple.push(\"\");\r\n    }\r\n    tuple.push(filter.endColumnId);\r\n  }\r\n\r\n  return tuple;\r\n}\r\n\r\nexport function decodeTupleToFilter(parts: readonly string[]): QueryFilter | null {\r\n  if (parts.length < 4 || parts.length > 6) {\r\n    return null;\r\n  }\r\n\r\n  const [columnId, typeStr, methodStr, valueStr, valueToStr, endColumnIdStr] = parts;\r\n\r\n  const typeParsed = filterSchema.shape.type.safeParse(typeStr);\r\n  const methodParsed = filterSchema.shape.method.safeParse(methodStr);\r\n  if (!typeParsed.success || !methodParsed.success) {\r\n    return null;\r\n  }\r\n\r\n  const type = typeParsed.data;\r\n  const method = methodParsed.data;\r\n  const value = decodeFilterValue(type, method, valueStr);\r\n\r\n  const candidate: QueryFilter = {\r\n    columnId,\r\n    type,\r\n    method,\r\n    value,\r\n  };\r\n\r\n  if (valueToStr !== undefined) {\r\n    candidate.valueTo = valueToStr;\r\n  }\r\n  if (endColumnIdStr !== undefined) {\r\n    candidate.endColumnId = endColumnIdStr;\r\n  }\r\n\r\n  const parsed = filterSchema.safeParse(candidate);\r\n  return parsed.success ? parsed.data : null;\r\n}\r\n\r\nexport function decodeFilterTuples(rows: readonly string[][]): QueryFilters {\r\n  const decoded = rows\r\n    .map((row) => decodeTupleToFilter(row))\r\n    .filter((filter): filter is QueryFilter => filter != null);\r\n  const parsed = filtersSchema.safeParse(decoded);\r\n  return parsed.success ? parsed.data : [];\r\n}\r\n\r\nexport type Order = \"asc\" | \"desc\";\r\n\r\nexport type Granularity = \"daily\" | \"weekly\" | \"monthly\" | \"yearly\";\r\n\r\nexport interface QueryParamsState {\r\n  /** Global search string; absent when not set. */\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"],"mappings":"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"}

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

@@ -1,5 +1,5 @@
-import { CalendarDate } from "@internationalized/date";
 import { QueryFilter } from "@m5kdev/commons/modules/schemas/query.schema";
+import { CalendarDate } from "@internationalized/date";
 import { DateValue } from "@react-types/calendar";
 import { RangeValue } from "@react-types/shared";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m5kdev/frontend",
-  "version": "0.20.51",
+  "version": "0.21.0",
   "license": "GPL-3.0-only",
   "repository": {
     "type": "git",
@@ -21,12 +21,10 @@
     "@trpc/tanstack-react-query": "11.4.3",
     "better-auth": "1.4.18",
     "luxon": "3.7.1",
-    "nuqs": "2.4.3",
-    "posthog-js": "1.258.2",
     "react": "19.2.1",
     "react-dom": "19.2.1",
     "zod": "4.2.1",
-    "@m5kdev/commons": "0.20.51"
+    "@m5kdev/commons": "0.21.0"
   },
   "peerDependencies": {
     "@trpc/server": "11.4.3"
@@ -41,10 +39,20 @@
     "tsdown": "0.21.7",
     "typescript": "6.0.3",
     "vite": "7.0.4",
-    "@m5kdev/backend": "0.20.51",
-    "@m5kdev/config": "0.20.51"
+    "@m5kdev/config": "0.21.0",
+    "@m5kdev/backend": "0.21.0"
   },
   "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/src/index.d.mts",
+        "default": "./dist/src/index.mjs"
+      },
+      "require": {
+        "types": "./dist/src/index.d.ts",
+        "default": "./dist/src/index.js"
+      }
+    },
     "./modules/app/components/*": {
       "import": {
         "types": "./dist/src/modules/app/components/*.d.mts",
@@ -154,6 +162,16 @@
         "types": "./dist/src/utils/*.d.ts",
         "default": "./dist/src/utils/*.js"
       }
+    },
+    "./modules/table/queryParams": {
+      "import": {
+        "types": "./dist/src/modules/table/queryParams.d.mts",
+        "default": "./dist/src/modules/table/queryParams.mjs"
+      },
+      "require": {
+        "types": "./dist/src/modules/table/queryParams.d.ts",
+        "default": "./dist/src/modules/table/queryParams.js"
+      }
     }
   },
   "scripts": {

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

@@ -1,34 +0,0 @@
-import { NuqsQueryParams } from "./useNuqsQueryParams.mjs";
-import { UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
-
-//#region src/modules/table/hooks/useDateRangeFilter.d.ts
-interface DateRangeFilterReturn<TData> {
-  params: NuqsQueryParams;
-  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 DateRangeFilterOptions<TInput, TData> {
-  getQueryOptions: GetQueryOptionsFn<TInput, TData>;
-  queryParams?: TInput;
-}
-/**
- * Hook for charts with URL-synced query parameters and data fetching
- * Similar to useNuqsTable but without rowSelection (not needed for charts)
- */
-declare const useDateRangeFilter: <TInput, TData>({
-  getQueryOptions,
-  queryParams
-}: DateRangeFilterOptions<TInput, TData>) => DateRangeFilterReturn<TData>;
-//#endregion
-export { DateRangeFilterOptions, DateRangeFilterReturn, useDateRangeFilter };
-//# sourceMappingURL=useDateRangeFilter.d.mts.map

package/dist/src/modules/table/hooks/useDateRangeFilter.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useDateRangeFilter.d.mts","names":[],"sources":["../../../../../src/modules/table/hooks/useDateRangeFilter.ts"],"mappings":";;;;UAIiB,qBAAA;EACf,MAAA,EAAQ,eAAA;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,sBAAA;EACf,eAAA,EAAiB,iBAAA,CAAkB,MAAA,EAAQ,KAAA;EAC3C,WAAA,GAAc,MAAA;AAAA;;;;;cAOH,kBAAA;EAAqC,eAAA;EAAA;AAAA,GAG/C,sBAAA,CAAuB,MAAA,EAAQ,KAAA,MAAS,qBAAA,CAAsB,KAAA"}

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

@@ -1,34 +0,0 @@
-import { NuqsQueryParams } from "./useNuqsQueryParams.js";
-import { UseQueryOptions, UseQueryResult } from "@tanstack/react-query";
-
-//#region src/modules/table/hooks/useDateRangeFilter.d.ts
-interface DateRangeFilterReturn<TData> {
-  params: NuqsQueryParams;
-  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 DateRangeFilterOptions<TInput, TData> {
-  getQueryOptions: GetQueryOptionsFn<TInput, TData>;
-  queryParams?: TInput;
-}
-/**
- * Hook for charts with URL-synced query parameters and data fetching
- * Similar to useNuqsTable but without rowSelection (not needed for charts)
- */
-declare const useDateRangeFilter: <TInput, TData>({
-  getQueryOptions,
-  queryParams
-}: DateRangeFilterOptions<TInput, TData>) => DateRangeFilterReturn<TData>;
-//#endregion
-export { DateRangeFilterOptions, DateRangeFilterReturn, useDateRangeFilter };
-//# sourceMappingURL=useDateRangeFilter.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useDateRangeFilter.d.ts","names":[],"sources":["../../../../../src/modules/table/hooks/useDateRangeFilter.ts"],"mappings":";;;;UAIiB,qBAAA;EACf,MAAA,EAAQ,eAAA;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,sBAAA;EACf,eAAA,EAAiB,iBAAA,CAAkB,MAAA,EAAQ,KAAA;EAC3C,WAAA,GAAc,MAAA;AAAA;;;;;cAOH,kBAAA;EAAqC,eAAA;EAAA;AAAA,GAG/C,sBAAA,CAAuB,MAAA,EAAQ,KAAA,MAAS,qBAAA,CAAsB,KAAA"}

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

@@ -1,30 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_src_modules_table_hooks_useNuqsQueryParams = require("./useNuqsQueryParams.js");
-const require_src_modules_table_hooks_useQueryWithParams = require("./useQueryWithParams.js");
-//#region src/modules/table/hooks/useDateRangeFilter.ts
-/**
-* Hook for charts with URL-synced query parameters and data fetching
-* Similar to useNuqsTable but without rowSelection (not needed for charts)
-*/
-const useDateRangeFilter = ({ getQueryOptions, queryParams = {} }) => {
-	const nuqs = require_src_modules_table_hooks_useNuqsQueryParams.useNuqsQueryParams();
-	return {
-		params: nuqs,
-		query: require_src_modules_table_hooks_useQueryWithParams.useQueryWithParams({
-			getQueryOptions,
-			queryParams,
-			queryState: {
-				filters: nuqs.filters,
-				q: nuqs.q,
-				sort: nuqs.sort,
-				order: nuqs.order,
-				page: nuqs.page,
-				limit: nuqs.limit
-			}
-		})
-	};
-};
-//#endregion
-exports.useDateRangeFilter = useDateRangeFilter;
-
-//# sourceMappingURL=useDateRangeFilter.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useDateRangeFilter.js","names":["useNuqsQueryParams","useQueryWithParams"],"sources":["../../../../../src/modules/table/hooks/useDateRangeFilter.ts"],"sourcesContent":["import type { UseQueryOptions, UseQueryResult } from \"@tanstack/react-query\";\r\nimport { type NuqsQueryParams, useNuqsQueryParams } from \"./useNuqsQueryParams\";\r\nimport { useQueryWithParams } from \"./useQueryWithParams\";\r\n\r\nexport interface DateRangeFilterReturn<TData> {\r\n  params: NuqsQueryParams;\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 DateRangeFilterOptions<TInput, TData> {\r\n  getQueryOptions: GetQueryOptionsFn<TInput, TData>;\r\n  queryParams?: TInput;\r\n}\r\n\r\n/**\r\n * Hook for charts with URL-synced query parameters and data fetching\r\n * Similar to useNuqsTable but without rowSelection (not needed for charts)\r\n */\r\nexport const useDateRangeFilter = <TInput, TData>({\r\n  getQueryOptions,\r\n  queryParams = {} as TInput,\r\n}: DateRangeFilterOptions<TInput, TData>): DateRangeFilterReturn<TData> => {\r\n  const nuqs = useNuqsQueryParams();\r\n\r\n  const queryResult = useQueryWithParams({\r\n    getQueryOptions,\r\n    queryParams,\r\n    queryState: {\r\n      filters: nuqs.filters,\r\n      q: nuqs.q,\r\n      sort: nuqs.sort,\r\n      order: nuqs.order,\r\n      page: nuqs.page,\r\n      limit: nuqs.limit,\r\n    },\r\n  });\r\n\r\n  return {\r\n    params: nuqs,\r\n    query: queryResult,\r\n  };\r\n};\r\n"],"mappings":";;;;;;;;AAiCA,MAAa,sBAAqC,EAChD,iBACA,cAAc,EAAE,OACyD;CACzE,MAAM,OAAOA,mDAAAA,oBAAoB;AAejC,QAAO;EACL,QAAQ;EACR,OAfkBC,mDAAAA,mBAAmB;GACrC;GACA;GACA,YAAY;IACV,SAAS,KAAK;IACd,GAAG,KAAK;IACR,MAAM,KAAK;IACX,OAAO,KAAK;IACZ,MAAM,KAAK;IACX,OAAO,KAAK;IACb;GACF,CAAC;EAKD"}

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

@@ -1,29 +0,0 @@
-import { useNuqsQueryParams } from "./useNuqsQueryParams.mjs";
-import { useQueryWithParams } from "./useQueryWithParams.mjs";
-//#region src/modules/table/hooks/useDateRangeFilter.ts
-/**
-* Hook for charts with URL-synced query parameters and data fetching
-* Similar to useNuqsTable but without rowSelection (not needed for charts)
-*/
-const useDateRangeFilter = ({ getQueryOptions, queryParams = {} }) => {
-	const nuqs = useNuqsQueryParams();
-	return {
-		params: nuqs,
-		query: useQueryWithParams({
-			getQueryOptions,
-			queryParams,
-			queryState: {
-				filters: nuqs.filters,
-				q: nuqs.q,
-				sort: nuqs.sort,
-				order: nuqs.order,
-				page: nuqs.page,
-				limit: nuqs.limit
-			}
-		})
-	};
-};
-//#endregion
-export { useDateRangeFilter };
-
-//# sourceMappingURL=useDateRangeFilter.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useDateRangeFilter.mjs","names":[],"sources":["../../../../../src/modules/table/hooks/useDateRangeFilter.ts"],"sourcesContent":["import type { UseQueryOptions, UseQueryResult } from \"@tanstack/react-query\";\r\nimport { type NuqsQueryParams, useNuqsQueryParams } from \"./useNuqsQueryParams\";\r\nimport { useQueryWithParams } from \"./useQueryWithParams\";\r\n\r\nexport interface DateRangeFilterReturn<TData> {\r\n  params: NuqsQueryParams;\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 DateRangeFilterOptions<TInput, TData> {\r\n  getQueryOptions: GetQueryOptionsFn<TInput, TData>;\r\n  queryParams?: TInput;\r\n}\r\n\r\n/**\r\n * Hook for charts with URL-synced query parameters and data fetching\r\n * Similar to useNuqsTable but without rowSelection (not needed for charts)\r\n */\r\nexport const useDateRangeFilter = <TInput, TData>({\r\n  getQueryOptions,\r\n  queryParams = {} as TInput,\r\n}: DateRangeFilterOptions<TInput, TData>): DateRangeFilterReturn<TData> => {\r\n  const nuqs = useNuqsQueryParams();\r\n\r\n  const queryResult = useQueryWithParams({\r\n    getQueryOptions,\r\n    queryParams,\r\n    queryState: {\r\n      filters: nuqs.filters,\r\n      q: nuqs.q,\r\n      sort: nuqs.sort,\r\n      order: nuqs.order,\r\n      page: nuqs.page,\r\n      limit: nuqs.limit,\r\n    },\r\n  });\r\n\r\n  return {\r\n    params: nuqs,\r\n    query: queryResult,\r\n  };\r\n};\r\n"],"mappings":";;;;;;;AAiCA,MAAa,sBAAqC,EAChD,iBACA,cAAc,EAAE,OACyD;CACzE,MAAM,OAAO,oBAAoB;AAejC,QAAO;EACL,QAAQ;EACR,OAfkB,mBAAmB;GACrC;GACA;GACA,YAAY;IACV,SAAS,KAAK;IACd,GAAG,KAAK;IACR,MAAM,KAAK;IACX,OAAO,KAAK;IACZ,MAAM,KAAK;IACX,OAAO,KAAK;IACb;GACF,CAAC;EAKD"}