@m5kdev/frontend 0.8.2 → 0.8.4

package/dist/src/modules/file/hooks/useS3Upload.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useS3Upload.mjs","names":[],"sources":["../../../../../src/modules/file/hooks/useS3Upload.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\r\n\r\nexport type S3UploadStatus = \"idle\" | \"uploading\" | \"success\" | \"error\";\r\n\r\nasync function getPresignedUrl(\r\n  filename: string,\r\n  filetype: string,\r\n  serverUrl = \"\"\r\n): Promise<string> {\r\n  const res = await fetch(`${serverUrl}/upload/s3-presigned-url`, {\r\n    method: \"POST\",\r\n    headers: { \"Content-Type\": \"application/json\" },\r\n    body: JSON.stringify({ filename, filetype }),\r\n  });\r\n  if (!res.ok) throw new Error(\"Failed to get presigned URL\");\r\n  const data = (await res.json()) as { url: string };\r\n  return data.url;\r\n}\r\n\r\nexport function useS3Upload(serverUrl = \"\") {\r\n  const [progress, setProgress] = useState<number>(0);\r\n  const [status, setStatus] = useState<S3UploadStatus>(\"idle\");\r\n  const [error, setError] = useState<string | null>(null);\r\n  const [uploadedUrl, setUploadedUrl] = useState<string | null>(null);\r\n\r\n  const upload = useCallback(async (file: File | Blob, prefix?: string) => {\r\n    setProgress(0);\r\n    setStatus(\"uploading\");\r\n    setError(null);\r\n    setUploadedUrl(null);\r\n    try {\r\n      const originalFilename = file instanceof File ? file.name : `upload-${Date.now()}`;\r\n      const extension = originalFilename.split(\".\").pop() || \"\";\r\n      const uuid = crypto.randomUUID();\r\n      const filename = prefix\r\n        ? `${prefix}/${uuid}.${extension}`\r\n        : `${uuid}.${extension}`;\r\n      const filetype = file instanceof File ? file.type : \"application/octet-stream\";\r\n      const presignedUrl = await getPresignedUrl(filename, filetype, serverUrl);\r\n\r\n      return await new Promise<string>((resolve, reject) => {\r\n        const xhr = new XMLHttpRequest();\r\n        xhr.open(\"PUT\", presignedUrl);\r\n        xhr.setRequestHeader(\"Content-Type\", filetype);\r\n\r\n        xhr.upload.onprogress = (event) => {\r\n          if (event.lengthComputable) {\r\n            setProgress(Math.round((event.loaded * 100) / event.total));\r\n          }\r\n        };\r\n\r\n        xhr.onload = () => {\r\n          if (xhr.status >= 200 && xhr.status < 300) {\r\n            setProgress(100);\r\n            setStatus(\"success\");\r\n            // Remove query params to get the public URL\r\n            setUploadedUrl(presignedUrl.split(\"?\")[0]);\r\n            resolve(filename);\r\n          } else {\r\n            setStatus(\"error\");\r\n            setError(`Upload failed with status ${xhr.status}`);\r\n            reject(new Error(`Upload failed with status ${xhr.status}`));\r\n          }\r\n        };\r\n\r\n        xhr.onerror = () => {\r\n          setStatus(\"error\");\r\n          setError(\"Network error during upload\");\r\n          reject(new Error(\"Network error during upload\"));\r\n        };\r\n\r\n        xhr.send(file);\r\n      });\r\n    } catch (err: any) {\r\n      setStatus(\"error\");\r\n      setError(err?.message || \"Unknown error\");\r\n      return Promise.reject(err);\r\n    }\r\n  }, [serverUrl]);\r\n\r\n  const reset = useCallback(() => {\r\n    setProgress(0);\r\n    setStatus(\"idle\");\r\n    setError(null);\r\n    setUploadedUrl(null);\r\n  }, []);\r\n\r\n  return { upload, progress, status, error, uploadedUrl, reset };\r\n}\r\n"],"mappings":";;AAIA,eAAe,gBACb,UACA,UACA,YAAY,IACK;CACjB,MAAM,MAAM,MAAM,MAAM,GAAG,UAAU,2BAA2B;EAC9D,QAAQ;EACR,SAAS,EAAE,gBAAgB,oBAAoB;EAC/C,MAAM,KAAK,UAAU;GAAE;GAAU;GAAU,CAAC;EAC7C,CAAC;AACF,KAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,8BAA8B;AAE3D,SADc,MAAM,IAAI,MAAM,EAClB;;AAGd,SAAgB,YAAY,YAAY,IAAI;CAC1C,MAAM,CAAC,UAAU,eAAe,SAAiB,EAAE;CACnD,MAAM,CAAC,QAAQ,aAAa,SAAyB,OAAO;CAC5D,MAAM,CAAC,OAAO,YAAY,SAAwB,KAAK;CACvD,MAAM,CAAC,aAAa,kBAAkB,SAAwB,KAAK;AAgEnE,QAAO;EAAE,QA9DM,YAAY,OAAO,MAAmB,WAAoB;AACvE,eAAY,EAAE;AACd,aAAU,YAAY;AACtB,YAAS,KAAK;AACd,kBAAe,KAAK;AACpB,OAAI;IAEF,MAAM,aADmB,gBAAgB,OAAO,KAAK,OAAO,UAAU,KAAK,KAAK,IAC7C,MAAM,IAAI,CAAC,KAAK,IAAI;IACvD,MAAM,OAAO,OAAO,YAAY;IAChC,MAAM,WAAW,SACb,GAAG,OAAO,GAAG,KAAK,GAAG,cACrB,GAAG,KAAK,GAAG;IACf,MAAM,WAAW,gBAAgB,OAAO,KAAK,OAAO;IACpD,MAAM,eAAe,MAAM,gBAAgB,UAAU,UAAU,UAAU;AAEzE,WAAO,MAAM,IAAI,SAAiB,SAAS,WAAW;KACpD,MAAM,MAAM,IAAI,gBAAgB;AAChC,SAAI,KAAK,OAAO,aAAa;AAC7B,SAAI,iBAAiB,gBAAgB,SAAS;AAE9C,SAAI,OAAO,cAAc,UAAU;AACjC,UAAI,MAAM,iBACR,aAAY,KAAK,MAAO,MAAM,SAAS,MAAO,MAAM,MAAM,CAAC;;AAI/D,SAAI,eAAe;AACjB,UAAI,IAAI,UAAU,OAAO,IAAI,SAAS,KAAK;AACzC,mBAAY,IAAI;AAChB,iBAAU,UAAU;AAEpB,sBAAe,aAAa,MAAM,IAAI,CAAC,GAAG;AAC1C,eAAQ,SAAS;aACZ;AACL,iBAAU,QAAQ;AAClB,gBAAS,6BAA6B,IAAI,SAAS;AACnD,8BAAO,IAAI,MAAM,6BAA6B,IAAI,SAAS,CAAC;;;AAIhE,SAAI,gBAAgB;AAClB,gBAAU,QAAQ;AAClB,eAAS,8BAA8B;AACvC,6BAAO,IAAI,MAAM,8BAA8B,CAAC;;AAGlD,SAAI,KAAK,KAAK;MACd;YACK,KAAU;AACjB,cAAU,QAAQ;AAClB,aAAS,KAAK,WAAW,gBAAgB;AACzC,WAAO,QAAQ,OAAO,IAAI;;KAE3B,CAAC,UAAU,CAAC;EASE;EAAU;EAAQ;EAAO;EAAa,OAPzC,kBAAkB;AAC9B,eAAY,EAAE;AACd,aAAU,OAAO;AACjB,YAAS,KAAK;AACd,kBAAe,KAAK;KACnB,EAAE,CAAC;EAEwD"}

package/dist/src/modules/file/hooks/useUpload.d.mts

@@ -0,0 +1,33 @@
+//#region src/modules/file/hooks/useUpload.d.ts
+type UploadStatus = "pending" | "uploading" | "completed" | "error";
+interface UploadFileTask {
+  id: string;
+  file: File;
+  progress: number;
+  status: UploadStatus;
+  errorMessage?: string;
+  bytesUploaded: number;
+  totalBytes: number;
+}
+declare function useFileUpload(): {
+  upload: <T>(type: string, file: File) => Promise<T>;
+  reset: () => void;
+  id?: string | undefined;
+  file?: File | undefined;
+  progress?: number | undefined;
+  status?: UploadStatus | undefined;
+  errorMessage?: string;
+  bytesUploaded?: number | undefined;
+  totalBytes?: number | undefined;
+};
+declare function useMultipartUpload(): {
+  uploadQueue: UploadFileTask[];
+  overallProgress: number;
+  uploadFiles: (type: string, files: File[]) => Promise<void>;
+  reset: () => void;
+  getTotalBytes: () => number;
+  getTotalBytesUploaded: () => number;
+};
+//#endregion
+export { UploadFileTask, UploadStatus, useFileUpload, useMultipartUpload };
+//# sourceMappingURL=useUpload.d.mts.map

package/dist/src/modules/file/hooks/useUpload.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpload.d.mts","names":[],"sources":["../../../../../src/modules/file/hooks/useUpload.ts"],"mappings":";KAEY,YAAA;AAAA,UAEK,cAAA;EACf,EAAA;EACA,IAAA,EAAM,IAAA;EACN,QAAA;EACA,MAAA,EAAQ,YAAA;EACR,YAAA;EACA,aAAA;EACA,UAAA;AAAA;AAAA,iBAoEc,aAAA,CAAA;cAGqB,IAAA,UAAc,IAAA,EAAQ,IAAA,KAAO,OAAA,CAAQ,CAAA;;;;;;;;;;iBAiD1D,kBAAA,CAAA;;;8BA6DO,KAAA,EAAS,IAAA,OAAM,OAAA"}

package/dist/src/modules/file/hooks/useUpload.mjs

@@ -0,0 +1,158 @@
+import { useCallback, useState } from "react";
+//#region src/modules/file/hooks/useUpload.ts
+const createUploadPromise = (type, file, callbacks) => {
+	return new Promise((resolve, reject) => {
+		const xhr = new XMLHttpRequest();
+		xhr.upload.onprogress = (event) => {
+			if (event.lengthComputable) {
+				const progress = Math.round(event.loaded * 100 / event.total);
+				callbacks.onProgress(progress, event.loaded);
+			}
+		};
+		xhr.onload = () => {
+			if (xhr.status === 200) {
+				callbacks.onComplete();
+				if (xhr.getResponseHeader("Content-Type")?.includes("application/json")) resolve(JSON.parse(xhr.response));
+				else resolve(xhr.response);
+			} else {
+				const errorMessage = `Upload failed with status ${xhr.status}`;
+				callbacks.onError(errorMessage);
+				reject(new Error(errorMessage));
+			}
+		};
+		xhr.onerror = () => {
+			const errorMessage = "Network error during upload";
+			callbacks.onError(errorMessage);
+			reject(new Error(errorMessage));
+		};
+		xhr.open("POST", `${import.meta.env.VITE_SERVER_URL}/upload/file/${type}`);
+		const formData = new FormData();
+		formData.append("file", file);
+		xhr.send(formData);
+	});
+};
+const createUploadTask = (file) => ({
+	id: typeof crypto !== "undefined" && crypto.randomUUID ? crypto.randomUUID() : Math.random().toString(36).substr(2, 9),
+	file,
+	progress: 0,
+	status: "pending",
+	bytesUploaded: 0,
+	totalBytes: file.size
+});
+function useFileUpload() {
+	const [uploadTask, setUploadTask] = useState(null);
+	const upload = useCallback(async (type, file) => {
+		setUploadTask(createUploadTask(file));
+		return createUploadPromise(type, file, {
+			onProgress: (progress, bytesUploaded) => {
+				setUploadTask((prev) => prev ? {
+					...prev,
+					progress,
+					bytesUploaded,
+					status: "uploading"
+				} : null);
+			},
+			onComplete: () => {
+				setUploadTask((prev) => prev ? {
+					...prev,
+					status: "completed",
+					progress: 100
+				} : null);
+			},
+			onError: (errorMessage) => {
+				setUploadTask((prev) => prev ? {
+					...prev,
+					status: "error",
+					errorMessage,
+					progress: 0
+				} : null);
+			}
+		});
+	}, []);
+	const reset = useCallback(() => {
+		setUploadTask(null);
+	}, []);
+	return {
+		...uploadTask,
+		upload,
+		reset
+	};
+}
+function useMultipartUpload() {
+	const [uploadQueue, setUploadQueue] = useState([]);
+	const [overallProgress, setOverallProgress] = useState(0);
+	const updateTask = useCallback((id, changes) => {
+		setUploadQueue((prev) => prev.map((task) => task.id === id ? {
+			...task,
+			...changes
+		} : task));
+	}, []);
+	const updateOverallProgress = useCallback((queue) => {
+		if (queue.length === 0) {
+			setOverallProgress(100);
+			return;
+		}
+		const totalBytes = queue.reduce((sum, task) => sum + task.file.size, 0);
+		const uploadedBytes = queue.reduce((sum, task) => {
+			if (task.status === "completed") return sum + task.file.size;
+			if (task.status === "uploading") return sum + task.progress / 100 * task.file.size;
+			return sum;
+		}, 0);
+		setOverallProgress(Math.floor(uploadedBytes / totalBytes * 100));
+	}, []);
+	const uploadSingleFile = useCallback(async (type, task) => {
+		return createUploadPromise(type, task.file, {
+			onProgress: (progress, bytesUploaded) => {
+				updateTask(task.id, {
+					progress,
+					bytesUploaded,
+					status: "uploading"
+				});
+				setUploadQueue((currentQueue) => {
+					const updatedQueue = currentQueue.map((q) => q.id === task.id ? {
+						...q,
+						progress,
+						bytesUploaded
+					} : q);
+					updateOverallProgress(updatedQueue);
+					return updatedQueue;
+				});
+			},
+			onComplete: () => {
+				updateTask(task.id, {
+					status: "completed",
+					progress: 100
+				});
+			},
+			onError: (errorMessage) => {
+				updateTask(task.id, {
+					status: "error",
+					errorMessage,
+					progress: 0
+				});
+			}
+		});
+	}, [updateTask, updateOverallProgress]);
+	return {
+		uploadQueue,
+		overallProgress,
+		uploadFiles: useCallback(async (type, files) => {
+			const initialQueue = files.map(createUploadTask);
+			setUploadQueue(initialQueue);
+			updateOverallProgress(initialQueue);
+			for (const task of initialQueue) try {
+				await uploadSingleFile(type, task);
+			} catch (_error) {}
+		}, [uploadSingleFile, updateOverallProgress]),
+		reset: useCallback(() => {
+			setUploadQueue([]);
+			setOverallProgress(0);
+		}, []),
+		getTotalBytes: () => uploadQueue.reduce((sum, task) => sum + task.totalBytes, 0),
+		getTotalBytesUploaded: () => uploadQueue.reduce((sum, task) => sum + task.bytesUploaded, 0)
+	};
+}
+//#endregion
+export { useFileUpload, useMultipartUpload };
+
+//# sourceMappingURL=useUpload.mjs.map

package/dist/src/modules/file/hooks/useUpload.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpload.mjs","names":[],"sources":["../../../../../src/modules/file/hooks/useUpload.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\r\n\r\nexport type UploadStatus = \"pending\" | \"uploading\" | \"completed\" | \"error\";\r\n\r\nexport interface UploadFileTask {\r\n  id: string;\r\n  file: File;\r\n  progress: number;\r\n  status: UploadStatus;\r\n  errorMessage?: string;\r\n  bytesUploaded: number;\r\n  totalBytes: number;\r\n}\r\n\r\ninterface UploadCallbacks {\r\n  onProgress: (progress: number, bytesUploaded: number) => void;\r\n  onComplete: () => void;\r\n  onError: (error: string) => void;\r\n}\r\n\r\n// Shared utility function to create upload promise\r\nconst createUploadPromise = <T>(\r\n  type: string,\r\n  file: File,\r\n  callbacks: UploadCallbacks\r\n): Promise<T> => {\r\n  return new Promise((resolve, reject) => {\r\n    const xhr = new XMLHttpRequest();\r\n\r\n    xhr.upload.onprogress = (event: ProgressEvent<EventTarget>) => {\r\n      if (event.lengthComputable) {\r\n        const progress = Math.round((event.loaded * 100) / event.total);\r\n        callbacks.onProgress(progress, event.loaded);\r\n      }\r\n    };\r\n\r\n    xhr.onload = () => {\r\n      if (xhr.status === 200) {\r\n        callbacks.onComplete();\r\n        // if response has json header, parse it\r\n        if (xhr.getResponseHeader(\"Content-Type\")?.includes(\"application/json\")) {\r\n          resolve(JSON.parse(xhr.response) as T);\r\n        } else {\r\n          resolve(xhr.response as T);\r\n        }\r\n      } else {\r\n        const errorMessage = `Upload failed with status ${xhr.status}`;\r\n        callbacks.onError(errorMessage);\r\n        reject(new Error(errorMessage));\r\n      }\r\n    };\r\n\r\n    xhr.onerror = () => {\r\n      const errorMessage = \"Network error during upload\";\r\n      callbacks.onError(errorMessage);\r\n      reject(new Error(errorMessage));\r\n    };\r\n\r\n    xhr.open(\"POST\", `${import.meta.env.VITE_SERVER_URL}/upload/file/${type}`);\r\n    const formData = new FormData();\r\n    formData.append(\"file\", file);\r\n    xhr.send(formData);\r\n  });\r\n};\r\n\r\n// Shared utility to create a task\r\nconst createUploadTask = (file: File): UploadFileTask => ({\r\n  id:\r\n    typeof crypto !== \"undefined\" && crypto.randomUUID\r\n      ? crypto.randomUUID()\r\n      : Math.random().toString(36).substr(2, 9),\r\n  file,\r\n  progress: 0,\r\n  status: \"pending\",\r\n  bytesUploaded: 0,\r\n  totalBytes: file.size,\r\n});\r\n\r\n// Hook for single file upload\r\nexport function useFileUpload() {\r\n  const [uploadTask, setUploadTask] = useState<UploadFileTask | null>(null);\r\n\r\n  const upload = useCallback(async <T>(type: string, file: File): Promise<T> => {\r\n    const task = createUploadTask(file);\r\n    setUploadTask(task);\r\n\r\n    const callbacks: UploadCallbacks = {\r\n      onProgress: (progress, bytesUploaded) => {\r\n        setUploadTask((prev) =>\r\n          prev\r\n            ? {\r\n                ...prev,\r\n                progress,\r\n                bytesUploaded,\r\n                status: \"uploading\",\r\n              }\r\n            : null\r\n        );\r\n      },\r\n      onComplete: () => {\r\n        setUploadTask((prev) => (prev ? { ...prev, status: \"completed\", progress: 100 } : null));\r\n      },\r\n      onError: (errorMessage) => {\r\n        setUploadTask((prev) =>\r\n          prev\r\n            ? {\r\n                ...prev,\r\n                status: \"error\",\r\n                errorMessage,\r\n                progress: 0,\r\n              }\r\n            : null\r\n        );\r\n      },\r\n    };\r\n\r\n    return createUploadPromise<T>(type, file, callbacks);\r\n  }, []);\r\n\r\n  const reset = useCallback(() => {\r\n    setUploadTask(null);\r\n  }, []);\r\n\r\n  return {\r\n    ...uploadTask,\r\n    upload,\r\n    reset,\r\n  };\r\n}\r\n\r\n// Hook for multiple file uploads\r\nexport function useMultipartUpload() {\r\n  const [uploadQueue, setUploadQueue] = useState<UploadFileTask[]>([]);\r\n  const [overallProgress, setOverallProgress] = useState<number>(0);\r\n\r\n  const updateTask = useCallback((id: string, changes: Partial<UploadFileTask>) => {\r\n    setUploadQueue((prev) => prev.map((task) => (task.id === id ? { ...task, ...changes } : task)));\r\n  }, []);\r\n\r\n  const updateOverallProgress = useCallback((queue: UploadFileTask[]) => {\r\n    if (queue.length === 0) {\r\n      setOverallProgress(100);\r\n      return;\r\n    }\r\n    const totalBytes = queue.reduce((sum, task) => sum + task.file.size, 0);\r\n    const uploadedBytes = queue.reduce((sum, task) => {\r\n      if (task.status === \"completed\") {\r\n        return sum + task.file.size;\r\n      }\r\n      if (task.status === \"uploading\") {\r\n        return sum + (task.progress / 100) * task.file.size;\r\n      }\r\n      return sum;\r\n    }, 0);\r\n    setOverallProgress(Math.floor((uploadedBytes / totalBytes) * 100));\r\n  }, []);\r\n\r\n  const uploadSingleFile = useCallback(\r\n    async <T>(type: string, task: UploadFileTask): Promise<T> => {\r\n      const callbacks: UploadCallbacks = {\r\n        onProgress: (progress, bytesUploaded) => {\r\n          updateTask(task.id, {\r\n            progress,\r\n            bytesUploaded,\r\n            status: \"uploading\",\r\n          });\r\n          setUploadQueue((currentQueue) => {\r\n            const updatedQueue = currentQueue.map((q) =>\r\n              q.id === task.id ? { ...q, progress, bytesUploaded } : q\r\n            );\r\n            updateOverallProgress(updatedQueue);\r\n            return updatedQueue;\r\n          });\r\n        },\r\n        onComplete: () => {\r\n          updateTask(task.id, { status: \"completed\", progress: 100 });\r\n        },\r\n        onError: (errorMessage) => {\r\n          updateTask(task.id, {\r\n            status: \"error\",\r\n            errorMessage,\r\n            progress: 0,\r\n          });\r\n        },\r\n      };\r\n\r\n      return createUploadPromise<T>(type, task.file, callbacks);\r\n    },\r\n    [updateTask, updateOverallProgress]\r\n  );\r\n\r\n  const uploadFiles = useCallback(\r\n    async (type: string, files: File[]) => {\r\n      const initialQueue = files.map(createUploadTask);\r\n      setUploadQueue(initialQueue);\r\n      updateOverallProgress(initialQueue);\r\n\r\n      for (const task of initialQueue) {\r\n        try {\r\n          await uploadSingleFile(type, task);\r\n        } catch (_error) {}\r\n      }\r\n    },\r\n    [uploadSingleFile, updateOverallProgress]\r\n  );\r\n\r\n  const reset = useCallback(() => {\r\n    setUploadQueue([]);\r\n    setOverallProgress(0);\r\n  }, []);\r\n\r\n  return {\r\n    uploadQueue,\r\n    overallProgress,\r\n    uploadFiles,\r\n    reset,\r\n    getTotalBytes: () => uploadQueue.reduce((sum, task) => sum + task.totalBytes, 0),\r\n    getTotalBytesUploaded: () => uploadQueue.reduce((sum, task) => sum + task.bytesUploaded, 0),\r\n  };\r\n}\r\n"],"mappings":"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"}

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

@@ -0,0 +1,34 @@
+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

@@ -0,0 +1 @@
+{"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.mjs

@@ -0,0 +1,30 @@
+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 { filters, setFilters, granularity, setGranularity } = useNuqsQueryParams();
+	const queryResult = useQueryWithParams({
+		getQueryOptions,
+		queryParams,
+		queryState: { filters }
+	});
+	return {
+		params: {
+			filters,
+			setFilters,
+			granularity,
+			setGranularity,
+			grouping: [],
+			setGrouping: () => {}
+		},
+		query: queryResult
+	};
+};
+//#endregion
+export { useDateRangeFilter };
+
+//# sourceMappingURL=useDateRangeFilter.mjs.map

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

@@ -0,0 +1 @@
+{"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  // Get only filters from URL query state\r\n  const { filters, setFilters, granularity, setGranularity } = useNuqsQueryParams();\r\n\r\n  // Get query result\r\n  const queryResult = useQueryWithParams({\r\n    getQueryOptions,\r\n    queryParams,\r\n    queryState: { filters },\r\n  });\r\n\r\n  return {\r\n    params: {\r\n      filters,\r\n      setFilters,\r\n      granularity,\r\n      setGranularity,\r\n      // TODO: Review - just fixing ts errors for now\r\n      grouping: [],\r\n      setGrouping: () => {},\r\n    },\r\n    query: queryResult,\r\n  };\r\n};\r\n"],"mappings":";;;;;;;AAiCA,MAAa,sBAAqC,EAChD,iBACA,cAAc,EAAE,OACyD;CAEzE,MAAM,EAAE,SAAS,YAAY,aAAa,mBAAmB,oBAAoB;CAGjF,MAAM,cAAc,mBAAmB;EACrC;EACA;EACA,YAAY,EAAE,SAAS;EACxB,CAAC;AAEF,QAAO;EACL,QAAQ;GACN;GACA;GACA;GACA;GAEA,UAAU,EAAE;GACZ,mBAAmB;GACpB;EACD,OAAO;EACR"}

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

@@ -0,0 +1,34 @@
+import { SortingState } from "../../../../node_modules/.pnpm/@tanstack_table-core@8.21.2/node_modules/@tanstack/table-core/build/lib/features/RowSorting.mjs";
+import { GroupingState } from "../../../../node_modules/.pnpm/@tanstack_table-core@8.21.2/node_modules/@tanstack/table-core/build/lib/features/ColumnGrouping.mjs";
+import { PaginationState } from "../../../../node_modules/.pnpm/@tanstack_table-core@8.21.2/node_modules/@tanstack/table-core/build/lib/features/RowPagination.mjs";
+import { Updater } from "../../../../node_modules/.pnpm/@tanstack_table-core@8.21.2/node_modules/@tanstack/table-core/build/lib/types.mjs";
+import { QueryFilters } from "@m5kdev/commons/modules/schemas/query.schema";
+
+//#region src/modules/table/hooks/useNuqsQueryParams.d.ts
+type Order = "asc" | "desc";
+type Granularity = "daily" | "weekly" | "monthly" | "yearly";
+interface NuqsQueryParams {
+  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;
+}
+/**
+ * Hook to manage all query parameters via nuqs (URL query parameters)
+ * Manages: filters, sort, order, page, limit, groupBy, granularity
+ * Accepts an optional prefix to namespace params when multiple tables share a view.
+ */
+declare const useNuqsQueryParams: (prefix?: string) => NuqsQueryParams;
+//#endregion
+export { Granularity, NuqsQueryParams, Order, useNuqsQueryParams };
+//# sourceMappingURL=useNuqsQueryParams.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useNuqsQueryParams.d.mts","names":[],"sources":["../../../../../src/modules/table/hooks/useNuqsQueryParams.ts"],"mappings":";;;;;;;KAmBY,KAAA;AAAA,KAEA,WAAA;AAAA,UAEK,eAAA;EACf,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;;;;;;cAQpB,kBAAA,GAAsB,MAAA,cAAkB,eAAA"}

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

@@ -0,0 +1,111 @@
+import { useCallback, useEffect, useMemo } from "react";
+import { filtersSchema } from "@m5kdev/commons/modules/schemas/query.schema";
+import { parseAsArrayOf, parseAsInteger, parseAsJson, parseAsString, parseAsStringLiteral, useQueryState } from "nuqs";
+//#region src/modules/table/hooks/useNuqsQueryParams.ts
+const parseAsFilters = parseAsJson((value) => filtersSchema.parse(value)).withDefault([]);
+const parseAsGrouping = parseAsArrayOf(parseAsString).withDefault([]);
+/**
+* Hook to manage all query parameters via nuqs (URL query parameters)
+* Manages: filters, sort, order, page, limit, groupBy, granularity
+* 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("sort"), parseAsString.withDefault(""));
+	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 [filters, setFilters] = useQueryState(k("filters"), parseAsFilters);
+	const [granularity, setGranularity] = useQueryState(k("granularity"), parseAsStringLiteral([
+		"daily",
+		"weekly",
+		"monthly",
+		"yearly"
+	]).withDefault("daily"));
+	const [groupingRaw, setGroupingRaw] = useQueryState(k("groupBy"), 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(() => ({
+		filters,
+		setFilters,
+		granularity,
+		setGranularity,
+		sort,
+		order,
+		setSorting,
+		sorting,
+		page,
+		limit,
+		setPagination,
+		pagination,
+		grouping,
+		setGrouping
+	}), [
+		filters,
+		setFilters,
+		granularity,
+		setGranularity,
+		sort,
+		order,
+		setSorting,
+		sorting,
+		page,
+		limit,
+		setPagination,
+		pagination,
+		grouping,
+		setGrouping
+	]);
+};
+//#endregion
+export { useNuqsQueryParams };
+
+//# sourceMappingURL=useNuqsQueryParams.mjs.map

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

@@ -0,0 +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"}

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

@@ -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.mjs";
+import { Updater } from "../../../../node_modules/.pnpm/@tanstack_table-core@8.21.2/node_modules/@tanstack/table-core/build/lib/types.mjs";
+import { NuqsQueryParams } from "./useNuqsQueryParams.mjs";
+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.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useNuqsTable.d.mts","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.mjs

@@ -0,0 +1,58 @@
+import { useNuqsQueryParams } from "./useNuqsQueryParams.mjs";
+import { useQueryWithParams } from "./useQueryWithParams.mjs";
+import { useCallback, useMemo, useState } from "react";
+//#region src/modules/table/hooks/useNuqsTable.ts
+const useNuqsTable = ({ getQueryOptions, queryParams = {}, prefix, additionalFilters, onAdditionalFiltersChange }) => {
+	const queryState = useNuqsQueryParams(prefix);
+	const queryResult = useQueryWithParams({
+		getQueryOptions,
+		queryParams,
+		queryState,
+		grouping: queryState.grouping,
+		additionalFilters
+	});
+	const [rowSelection, setRowSelectionRaw] = useState({});
+	const setRowSelection = useCallback((updater) => {
+		setRowSelectionRaw((prev) => {
+			return typeof updater === "function" ? updater(prev) : updater;
+		});
+	}, []);
+	const displayFilters = useMemo(() => {
+		if (!additionalFilters?.length) return queryState.filters ?? [];
+		return [...additionalFilters, ...queryState.filters ?? []];
+	}, [additionalFilters, queryState.filters]);
+	const additionalColumnIds = useMemo(() => new Set(additionalFilters?.map((f) => f.columnId) ?? []), [additionalFilters]);
+	const wrappedSetFilters = 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: useMemo(() => ({
+			...queryState,
+			filters: displayFilters,
+			setFilters: wrappedSetFilters,
+			rowSelection,
+			setRowSelection
+		}), [
+			queryState,
+			displayFilters,
+			wrappedSetFilters,
+			rowSelection,
+			setRowSelection
+		]),
+		query: queryResult
+	};
+};
+//#endregion
+export { useNuqsTable as default };
+
+//# sourceMappingURL=useNuqsTable.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useNuqsTable.mjs","names":[],"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,aAAa,mBAAmB,OAAO;CAG7C,MAAM,cAAc,mBAAmB;EACrC;EACA;EACA;EACA,UAAU,WAAW;EACrB;EACD,CAAC;CAGF,MAAM,CAAC,cAAc,sBAAsB,SAA4B,EAAE,CAAC;CAE1E,MAAM,kBAAkB,aAAa,YAAwC;AAC3E,sBAAoB,SAA4B;AAE9C,UADa,OAAO,YAAY,aAAa,QAAQ,KAAK,GAAG;IAE7D;IACD,EAAE,CAAC;CAIN,MAAM,iBAAiB,cAA4B;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,sBAAsB,cACpB,IAAI,IAAI,mBAAmB,KAAK,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC,EAC9D,CAAC,kBAAkB,CACpB;CAED,MAAM,oBAAoB,aACvB,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,QAZa,eACN;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

@@ -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.mjs";
+import { NuqsQueryParams } from "./useNuqsQueryParams.mjs";
+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">;
+  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.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useQueryWithParams.d.mts","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"}