@farm.js/core 0.1.0-beta.0

package/dist/query/client.d.mts

@@ -0,0 +1,61 @@
+export { R as RouteParamsInput, l as loadRouteParams, p as parseRouteParams } from '../params-ry-lxqmy.mjs';
+import { Parser } from './parsers.mjs';
+export { asArrayOf, asBoolean, asFloat, asInteger, asIsoDate, asIsoDateTime, asJson, asString, createParser, inferParserType } from './parsers.mjs';
+
+/**
+ * Farm.js Client-Side Query State Management
+ *
+ * Type-safe URL search parameter state management - Like useState, but stored in the URL query string.
+ * Client-only hooks for managing query parameters in the browser.
+ * Inspired by nuqs implementation patterns.
+ */
+
+type UrlUpdateType = "push" | "replace";
+type HistoryMethod = "pushState" | "replaceState";
+interface Options {
+    history?: HistoryMethod;
+    shallow?: boolean;
+    scroll?: boolean;
+    throttleMs?: number;
+}
+declare function useQueryState<TParser extends Parser<any>>(key: string, parser: TParser, options?: Options): [
+    NonNullable<ReturnType<TParser["parse"]>> | null,
+    (value: NonNullable<ReturnType<TParser["parse"]>> | null) => void
+];
+declare function useQueryState<T>(key: string, parser: Parser<T>, options?: Options): [T | null, (value: T | null) => void];
+declare function useQueryStates<T extends Record<string, Parser<any>>>(parsers: T, options?: Options): [
+    {
+        [K in keyof T]: ReturnType<T[K]["parse"]>;
+    },
+    (updates: Partial<{
+        [K in keyof T]: ReturnType<T[K]["parse"]> | null;
+    }>) => void
+];
+declare function usePagination(options?: {
+    defaultPage?: number;
+    defaultLimit?: number;
+    pageKey?: string;
+    limitKey?: string;
+}): {
+    page: number;
+    setPage: (value: number | null) => void;
+    limit: number;
+    setLimit: (value: number | null) => void;
+    offset: number;
+    resetPagination: () => void;
+};
+declare function useSearchFilters<T extends Record<string, any>>(options?: {
+    searchKey?: string;
+    defaultFilters?: T;
+    filterKeys?: (keyof T)[];
+}): {
+    search: string | null;
+    setSearch: (value: string | null) => void;
+    filters: T;
+    setFilters: (updates: Partial<{
+        [x: string]: string | null;
+    }>) => void;
+    clearFilters: () => void;
+};
+
+export { type HistoryMethod, type Options, Parser, type UrlUpdateType, usePagination, useQueryState, useQueryStates, useSearchFilters };

package/dist/query/client.d.ts

@@ -0,0 +1,61 @@
+export { R as RouteParamsInput, l as loadRouteParams, p as parseRouteParams } from '../params-BALtrRim.js';
+import { Parser } from './parsers.js';
+export { asArrayOf, asBoolean, asFloat, asInteger, asIsoDate, asIsoDateTime, asJson, asString, createParser, inferParserType } from './parsers.js';
+
+/**
+ * Farm.js Client-Side Query State Management
+ *
+ * Type-safe URL search parameter state management - Like useState, but stored in the URL query string.
+ * Client-only hooks for managing query parameters in the browser.
+ * Inspired by nuqs implementation patterns.
+ */
+
+type UrlUpdateType = "push" | "replace";
+type HistoryMethod = "pushState" | "replaceState";
+interface Options {
+    history?: HistoryMethod;
+    shallow?: boolean;
+    scroll?: boolean;
+    throttleMs?: number;
+}
+declare function useQueryState<TParser extends Parser<any>>(key: string, parser: TParser, options?: Options): [
+    NonNullable<ReturnType<TParser["parse"]>> | null,
+    (value: NonNullable<ReturnType<TParser["parse"]>> | null) => void
+];
+declare function useQueryState<T>(key: string, parser: Parser<T>, options?: Options): [T | null, (value: T | null) => void];
+declare function useQueryStates<T extends Record<string, Parser<any>>>(parsers: T, options?: Options): [
+    {
+        [K in keyof T]: ReturnType<T[K]["parse"]>;
+    },
+    (updates: Partial<{
+        [K in keyof T]: ReturnType<T[K]["parse"]> | null;
+    }>) => void
+];
+declare function usePagination(options?: {
+    defaultPage?: number;
+    defaultLimit?: number;
+    pageKey?: string;
+    limitKey?: string;
+}): {
+    page: number;
+    setPage: (value: number | null) => void;
+    limit: number;
+    setLimit: (value: number | null) => void;
+    offset: number;
+    resetPagination: () => void;
+};
+declare function useSearchFilters<T extends Record<string, any>>(options?: {
+    searchKey?: string;
+    defaultFilters?: T;
+    filterKeys?: (keyof T)[];
+}): {
+    search: string | null;
+    setSearch: (value: string | null) => void;
+    filters: T;
+    setFilters: (updates: Partial<{
+        [x: string]: string | null;
+    }>) => void;
+    clearFilters: () => void;
+};
+
+export { type HistoryMethod, type Options, Parser, type UrlUpdateType, usePagination, useQueryState, useQueryStates, useSearchFilters };

package/dist/query/client.mjs

@@ -0,0 +1,364 @@
+import {
+  loadRouteParams,
+  parseRouteParams
+} from "../chunk-H2FA2SBS.mjs";
+import {
+  asArrayOf,
+  asBoolean,
+  asFloat,
+  asInteger,
+  asIsoDate,
+  asIsoDateTime,
+  asJson,
+  asString,
+  createParser
+} from "../chunk-E2MPIBRE.mjs";
+import {
+  __name
+} from "../chunk-CGILA3WO.mjs";
+
+// src/query/client.ts
+import { useState, useEffect, useCallback, useRef } from "react";
+
+// src/query/sync.ts
+var _Emitter = class _Emitter {
+  constructor() {
+    this.listeners = /* @__PURE__ */ new Map();
+    this.keyListeners = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Emit a global update event (all hooks should sync)
+   */
+  emitUpdate(searchParams) {
+    const listeners = this.listeners.get("update") || /* @__PURE__ */ new Set();
+    listeners.forEach((listener) => listener(searchParams));
+  }
+  /**
+   * Emit a key-specific update (for cross-hook sync)
+   */
+  emitKey(key, payload) {
+    const listeners = this.keyListeners.get(key) || /* @__PURE__ */ new Set();
+    listeners.forEach((listener) => listener(payload));
+  }
+  /**
+   * Subscribe to global updates
+   */
+  on(event, listener) {
+    if (!this.listeners.has(event)) {
+      this.listeners.set(event, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(event).add(listener);
+  }
+  /**
+   * Subscribe to key-specific updates
+   */
+  onKey(key, listener) {
+    if (!this.keyListeners.has(key)) {
+      this.keyListeners.set(key, /* @__PURE__ */ new Set());
+    }
+    this.keyListeners.get(key).add(listener);
+  }
+  /**
+   * Unsubscribe from global updates
+   */
+  off(event, listener) {
+    const listeners = this.listeners.get(event);
+    if (listeners) {
+      listeners.delete(listener);
+    }
+  }
+  /**
+   * Unsubscribe from key-specific updates
+   */
+  offKey(key, listener) {
+    const listeners = this.keyListeners.get(key);
+    if (listeners) {
+      listeners.delete(listener);
+    }
+  }
+};
+__name(_Emitter, "Emitter");
+var Emitter = _Emitter;
+var emitter = new Emitter();
+
+// src/query/client.ts
+var getCurrentSearchParams = /* @__PURE__ */ __name(() => {
+  if (typeof window === "undefined") return new URLSearchParams();
+  return new URLSearchParams(window.location.search);
+}, "getCurrentSearchParams");
+var throttleTimers = /* @__PURE__ */ new Map();
+var applyChange = /* @__PURE__ */ __name((searchParams, updates, keepExisting = true) => {
+  const newParams = keepExisting ? new URLSearchParams(searchParams) : new URLSearchParams();
+  Object.entries(updates).forEach(([key, value]) => {
+    if (value === null || value === void 0 || value === "") {
+      newParams.delete(key);
+    } else {
+      newParams.set(key, value);
+    }
+  });
+  return newParams;
+}, "applyChange");
+var updateURL = /* @__PURE__ */ __name((updates, options = {}, emitUpdate = true) => {
+  if (typeof window === "undefined") return;
+  const { history = "pushState", shallow = true, scroll = false, throttleMs } = options;
+  const url = new URL(window.location.href);
+  const newSearchParams = applyChange(new URLSearchParams(url.search), updates);
+  const newSearch = newSearchParams.toString();
+  const newUrl = url.pathname + (newSearch ? `?${newSearch}` : "") + url.hash;
+  const currentUrl = window.location.pathname + (window.location.search || "") + window.location.hash;
+  if (newUrl !== currentUrl) {
+    const update = /* @__PURE__ */ __name(() => {
+      if (history === "replaceState") {
+        window.history.replaceState(null, "", newUrl);
+      } else {
+        window.history.pushState(null, "", newUrl);
+      }
+      if (emitUpdate) {
+        const actualSearchParams = new URLSearchParams(window.location.search);
+        emitter.emitUpdate(actualSearchParams);
+      }
+      if (shallow) {
+        setTimeout(() => {
+          window.dispatchEvent(new PopStateEvent("popstate"));
+        }, 0);
+      }
+      if (scroll) {
+        window.scrollTo(0, 0);
+      }
+    }, "update");
+    if (throttleMs && throttleMs > 0) {
+      const throttleKey = Object.keys(updates).sort().join(",");
+      const existingTimeout = throttleTimers.get(throttleKey);
+      if (existingTimeout) {
+        clearTimeout(existingTimeout);
+      }
+      const timeout = setTimeout(() => {
+        update();
+        throttleTimers.delete(throttleKey);
+      }, throttleMs);
+      throttleTimers.set(throttleKey, timeout);
+    } else {
+      update();
+    }
+  }
+}, "updateURL");
+function useQueryState(key, parser, options) {
+  const [state, setState] = useState(() => {
+    if (typeof window === "undefined") return parser.parse("");
+    const searchParams = getCurrentSearchParams();
+    const value = searchParams.get(key);
+    const parsed = parser.parse(value ?? "");
+    return parsed;
+  });
+  const stateRef = useRef(state);
+  const isInternalUpdateRef = useRef(false);
+  stateRef.current = state;
+  const setValue = useCallback(
+    (value) => {
+      isInternalUpdateRef.current = true;
+      setState(value);
+      stateRef.current = value;
+      const serialized = value === null ? null : parser.serialize(value);
+      emitter.emitKey(key, { state: value, query: serialized });
+      updateURL({ [key]: serialized }, options, true);
+      setTimeout(() => {
+        isInternalUpdateRef.current = false;
+      }, 10);
+    },
+    [key, parser, options]
+  );
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    const onPopState = /* @__PURE__ */ __name(() => {
+      const searchParams = getCurrentSearchParams();
+      const value = searchParams.get(key);
+      const parsed = parser.parse(value ?? "");
+      if (!Object.is(stateRef.current, parsed)) {
+        setState(parsed);
+        stateRef.current = parsed;
+      }
+    }, "onPopState");
+    const onEmitterUpdate = /* @__PURE__ */ __name((searchParams) => {
+      if (isInternalUpdateRef.current) {
+        return;
+      }
+      const value = searchParams.get(key);
+      const parsed = parser.parse(value ?? "");
+      if (!Object.is(stateRef.current, parsed)) {
+        setState(parsed);
+        stateRef.current = parsed;
+      }
+    }, "onEmitterUpdate");
+    const onKeyUpdate = /* @__PURE__ */ __name((payload) => {
+      if (isInternalUpdateRef.current) {
+        return;
+      }
+      if (!Object.is(stateRef.current, payload.state)) {
+        setState(payload.state);
+        stateRef.current = payload.state;
+      }
+    }, "onKeyUpdate");
+    window.addEventListener("popstate", onPopState);
+    emitter.on("update", onEmitterUpdate);
+    emitter.onKey(key, onKeyUpdate);
+    return () => {
+      window.removeEventListener("popstate", onPopState);
+      emitter.off("update", onEmitterUpdate);
+      emitter.offKey(key, onKeyUpdate);
+    };
+  }, [key, parser]);
+  return [state, setValue];
+}
+__name(useQueryState, "useQueryState");
+function useQueryStates(parsers, options = {}) {
+  const keys = Object.keys(parsers);
+  const watchKeys = keys.join("&");
+  const [state, setState] = useState(() => {
+    const searchParams = typeof window === "undefined" ? new URLSearchParams() : getCurrentSearchParams();
+    const result = {};
+    Object.entries(parsers).forEach(([key, parser]) => {
+      const value = searchParams.get(key);
+      result[key] = parser.parse(value ?? "");
+    });
+    return result;
+  });
+  const stateRef = useRef(state);
+  stateRef.current = state;
+  const setValues = useCallback(
+    (updates) => {
+      const newState = { ...stateRef.current, ...updates };
+      setState(newState);
+      stateRef.current = newState;
+      Object.entries(updates).forEach(([key, value]) => {
+        const parser = parsers[key];
+        if (parser) {
+          const serialized = value === null ? null : parser.serialize(value);
+          emitter.emitKey(key, { state: value, query: serialized });
+        }
+      });
+      const urlUpdates = {};
+      Object.entries(updates).forEach(([key, value]) => {
+        const parser = parsers[key];
+        if (parser) {
+          const serialized = value === null ? null : parser.serialize(value);
+          urlUpdates[key] = serialized;
+        }
+      });
+      updateURL(urlUpdates, options, true);
+    },
+    [parsers, options]
+  );
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    const applyChange2 = /* @__PURE__ */ __name((searchParams, fromEmitter = false) => {
+      const result = {};
+      let hasChanged = false;
+      Object.entries(parsers).forEach(([key, parser]) => {
+        const value = searchParams.get(key);
+        const parsed = parser.parse(value ?? "");
+        const currentValue = stateRef.current[key];
+        if (!Object.is(currentValue, parsed)) {
+          hasChanged = true;
+        }
+        result[key] = parsed;
+      });
+      if (hasChanged) {
+        setState(result);
+        stateRef.current = result;
+      }
+    }, "applyChange");
+    const onPopState = /* @__PURE__ */ __name(() => {
+      const searchParams = getCurrentSearchParams();
+      applyChange2(searchParams, false);
+    }, "onPopState");
+    const onEmitterUpdate = /* @__PURE__ */ __name((searchParams) => {
+      applyChange2(searchParams, true);
+    }, "onEmitterUpdate");
+    window.addEventListener("popstate", onPopState);
+    emitter.on("update", onEmitterUpdate);
+    return () => {
+      window.removeEventListener("popstate", onPopState);
+      emitter.off("update", onEmitterUpdate);
+    };
+  }, [watchKeys, parsers]);
+  return [state, setValues];
+}
+__name(useQueryStates, "useQueryStates");
+function usePagination(options) {
+  const {
+    defaultPage = 1,
+    defaultLimit = 10,
+    pageKey = "page",
+    limitKey = "limit"
+  } = options || {};
+  const [page, setPage] = useQueryState(pageKey, asInteger.withDefault(defaultPage));
+  const [limit, setLimit] = useQueryState(limitKey, asInteger.withDefault(defaultLimit));
+  const currentPage = page ?? defaultPage;
+  const currentLimit = limit ?? defaultLimit;
+  const offset = (currentPage - 1) * currentLimit;
+  return {
+    page: currentPage,
+    setPage,
+    limit: currentLimit,
+    setLimit,
+    offset,
+    resetPagination: /* @__PURE__ */ __name(() => {
+      setPage(defaultPage);
+      setLimit(defaultLimit);
+    }, "resetPagination")
+  };
+}
+__name(usePagination, "usePagination");
+function useSearchFilters(options) {
+  const {
+    searchKey = "search",
+    defaultFilters = {},
+    filterKeys = Object.keys(defaultFilters)
+  } = options || {};
+  const [search, setSearch] = useQueryState(searchKey, asString);
+  const filterParsers = filterKeys.reduce(
+    (acc, key) => {
+      acc[key] = asString;
+      return acc;
+    },
+    {}
+  );
+  const [filters, setFilters] = useQueryStates(filterParsers);
+  const clearFilters = /* @__PURE__ */ __name(() => {
+    setSearch(null);
+    const clearedFilters = filterKeys.reduce(
+      (acc, key) => {
+        acc[key] = null;
+        return acc;
+      },
+      {}
+    );
+    setFilters(clearedFilters);
+  }, "clearFilters");
+  return {
+    search,
+    setSearch,
+    filters,
+    setFilters,
+    clearFilters
+  };
+}
+__name(useSearchFilters, "useSearchFilters");
+export {
+  asArrayOf,
+  asBoolean,
+  asFloat,
+  asInteger,
+  asIsoDate,
+  asIsoDateTime,
+  asJson,
+  asString,
+  createParser,
+  loadRouteParams,
+  parseRouteParams,
+  usePagination,
+  useQueryState,
+  useQueryStates,
+  useSearchFilters
+};
+//# sourceMappingURL=client.mjs.map

package/dist/query/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/query/client.ts","../../src/query/sync.ts"],"sourcesContent":["/**\n * Farm.js Client-Side Query State Management\n *\n * Type-safe URL search parameter state management - Like useState, but stored in the URL query string.\n * Client-only hooks for managing query parameters in the browser.\n * Inspired by nuqs implementation patterns.\n */\n\nimport { useState, useEffect, useCallback, useRef } from \"react\";\nimport { emitter } from \"./sync\";\nexport { parseRouteParams, loadRouteParams, type RouteParamsInput } from \"./params\";\n\nimport { asString as asStringClient, asInteger as asIntegerClient, type Parser } from \"./parsers\";\n\nexport {\n  asString,\n  asInteger,\n  asFloat,\n  asBoolean,\n  asArrayOf,\n  asJson,\n  asIsoDate,\n  asIsoDateTime,\n  createParser,\n  type Parser,\n  type inferParserType,\n} from \"./parsers\";\n\nexport type UrlUpdateType = \"push\" | \"replace\";\nexport type HistoryMethod = \"pushState\" | \"replaceState\";\n\nexport interface Options {\n  history?: HistoryMethod;\n  shallow?: boolean;\n  scroll?: boolean;\n  throttleMs?: number;\n}\n\nconst getCurrentSearchParams = (): URLSearchParams => {\n  if (typeof window === \"undefined\") return new URLSearchParams();\n  return new URLSearchParams(window.location.search);\n};\n\nconst throttleTimers = new Map<string, NodeJS.Timeout>();\n\nconst applyChange = (\n  searchParams: URLSearchParams,\n  updates: Record<string, string | null>,\n  keepExisting = true,\n): URLSearchParams => {\n  const newParams = keepExisting ? new URLSearchParams(searchParams) : new URLSearchParams();\n\n  Object.entries(updates).forEach(([key, value]) => {\n    if (value === null || value === undefined || value === \"\") {\n      newParams.delete(key);\n    } else {\n      newParams.set(key, value);\n    }\n  });\n\n  return newParams;\n};\n\nconst updateURL = (\n  updates: Record<string, string | null>,\n  options: Options = {},\n  emitUpdate = true,\n) => {\n  if (typeof window === \"undefined\") return;\n\n  const { history = \"pushState\", shallow = true, scroll = false, throttleMs } = options;\n  const url = new URL(window.location.href);\n\n  const newSearchParams = applyChange(new URLSearchParams(url.search), updates);\n  const newSearch = newSearchParams.toString();\n  const newUrl = url.pathname + (newSearch ? `?${newSearch}` : \"\") + url.hash;\n  const currentUrl =\n    window.location.pathname + (window.location.search || \"\") + window.location.hash;\n\n  if (newUrl !== currentUrl) {\n    const update = () => {\n      if (history === \"replaceState\") {\n        window.history.replaceState(null, \"\", newUrl);\n      } else {\n        window.history.pushState(null, \"\", newUrl);\n      }\n\n      if (emitUpdate) {\n        const actualSearchParams = new URLSearchParams(window.location.search);\n        emitter.emitUpdate(actualSearchParams);\n      }\n\n      if (shallow) {\n        setTimeout(() => {\n          window.dispatchEvent(new PopStateEvent(\"popstate\"));\n        }, 0);\n      }\n\n      if (scroll) {\n        window.scrollTo(0, 0);\n      }\n    };\n\n    if (throttleMs && throttleMs > 0) {\n      const throttleKey = Object.keys(updates).sort().join(\",\");\n\n      const existingTimeout = throttleTimers.get(throttleKey);\n      if (existingTimeout) {\n        clearTimeout(existingTimeout);\n      }\n\n      const timeout = setTimeout(() => {\n        update();\n        throttleTimers.delete(throttleKey);\n      }, throttleMs);\n\n      throttleTimers.set(throttleKey, timeout);\n    } else {\n      update();\n    }\n  }\n};\n\nexport function useQueryState<TParser extends Parser<any>>(\n  key: string,\n  parser: TParser,\n  options?: Options,\n): [\n  NonNullable<ReturnType<TParser[\"parse\"]>> | null,\n  (value: NonNullable<ReturnType<TParser[\"parse\"]>> | null) => void,\n];\nexport function useQueryState<T>(\n  key: string,\n  parser: Parser<T>,\n  options?: Options,\n): [T | null, (value: T | null) => void];\nexport function useQueryState<TParser extends Parser<any>>(\n  key: string,\n  parser: TParser,\n  options?: Options,\n): [\n  NonNullable<ReturnType<TParser[\"parse\"]>> | null,\n  (value: NonNullable<ReturnType<TParser[\"parse\"]>> | null) => void,\n] {\n  type T = NonNullable<ReturnType<TParser[\"parse\"]>>;\n  const [state, setState] = useState<T | null>(() => {\n    if (typeof window === \"undefined\") return parser.parse(\"\");\n    const searchParams = getCurrentSearchParams();\n    const value = searchParams.get(key);\n    const parsed = parser.parse(value ?? \"\");\n    return parsed;\n  });\n\n  const stateRef = useRef(state);\n  const isInternalUpdateRef = useRef(false);\n  stateRef.current = state;\n\n  const setValue = useCallback(\n    (value: T | null) => {\n      isInternalUpdateRef.current = true;\n\n      setState(value);\n      stateRef.current = value;\n\n      const serialized = value === null ? null : parser.serialize(value);\n\n      emitter.emitKey(key, { state: value, query: serialized });\n\n      updateURL({ [key]: serialized }, options, true);\n\n      setTimeout(() => {\n        isInternalUpdateRef.current = false;\n      }, 10);\n    },\n    [key, parser, options],\n  );\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n\n    const onPopState = () => {\n      const searchParams = getCurrentSearchParams();\n      const value = searchParams.get(key);\n      const parsed = parser.parse(value ?? \"\");\n      if (!Object.is(stateRef.current, parsed)) {\n        setState(parsed);\n        stateRef.current = parsed;\n      }\n    };\n\n    const onEmitterUpdate = (searchParams: URLSearchParams) => {\n      if (isInternalUpdateRef.current) {\n        return;\n      }\n\n      const value = searchParams.get(key);\n      const parsed = parser.parse(value ?? \"\");\n      if (!Object.is(stateRef.current, parsed)) {\n        setState(parsed);\n        stateRef.current = parsed;\n      }\n    };\n\n    const onKeyUpdate = (payload: { state: any; query: string | null }) => {\n      if (isInternalUpdateRef.current) {\n        return;\n      }\n\n      if (!Object.is(stateRef.current, payload.state)) {\n        setState(payload.state);\n        stateRef.current = payload.state;\n      }\n    };\n\n    window.addEventListener(\"popstate\", onPopState);\n    emitter.on(\"update\", onEmitterUpdate);\n    emitter.onKey(key, onKeyUpdate);\n\n    return () => {\n      window.removeEventListener(\"popstate\", onPopState);\n      emitter.off(\"update\", onEmitterUpdate);\n      emitter.offKey(key, onKeyUpdate);\n    };\n  }, [key, parser]);\n\n  return [state, setValue];\n}\n\nexport function useQueryStates<T extends Record<string, Parser<any>>>(\n  parsers: T,\n  options: Options = {},\n): [\n  { [K in keyof T]: ReturnType<T[K][\"parse\"]> },\n  (updates: Partial<{ [K in keyof T]: ReturnType<T[K][\"parse\"]> | null }>) => void,\n] {\n  const keys = Object.keys(parsers);\n  const watchKeys = keys.join(\"&\");\n\n  const [state, setState] = useState<{ [K in keyof T]: ReturnType<T[K][\"parse\"]> }>(() => {\n    const searchParams =\n      typeof window === \"undefined\" ? new URLSearchParams() : getCurrentSearchParams();\n    const result = {} as { [K in keyof T]: ReturnType<T[K][\"parse\"]> };\n\n    Object.entries(parsers).forEach(([key, parser]) => {\n      const value = searchParams.get(key);\n      result[key as keyof T] = parser.parse(value ?? \"\");\n    });\n\n    return result;\n  });\n\n  const stateRef = useRef(state);\n  stateRef.current = state;\n\n  const setValues = useCallback(\n    (updates: Partial<{ [K in keyof T]: ReturnType<T[K][\"parse\"]> | null }>) => {\n      const newState = { ...stateRef.current, ...updates };\n      setState(newState);\n      stateRef.current = newState;\n\n      Object.entries(updates).forEach(([key, value]) => {\n        const parser = parsers[key];\n        if (parser) {\n          const serialized = value === null ? null : parser.serialize(value);\n          emitter.emitKey(key, { state: value, query: serialized });\n        }\n      });\n\n      const urlUpdates: Record<string, string | null> = {};\n      Object.entries(updates).forEach(([key, value]) => {\n        const parser = parsers[key];\n        if (parser) {\n          const serialized = value === null ? null : parser.serialize(value);\n          urlUpdates[key] = serialized;\n        }\n      });\n\n      updateURL(urlUpdates, options, true);\n    },\n    [parsers, options],\n  );\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n\n    const applyChange = (searchParams: URLSearchParams, fromEmitter = false) => {\n      const result = {} as { [K in keyof T]: ReturnType<T[K][\"parse\"]> };\n      let hasChanged = false;\n\n      Object.entries(parsers).forEach(([key, parser]) => {\n        const value = searchParams.get(key);\n        const parsed = parser.parse(value ?? \"\");\n        const currentValue = stateRef.current[key as keyof T];\n\n        if (!Object.is(currentValue, parsed)) {\n          hasChanged = true;\n        }\n        result[key as keyof T] = parsed;\n      });\n\n      if (hasChanged) {\n        setState(result);\n        stateRef.current = result;\n      }\n    };\n\n    const onPopState = () => {\n      const searchParams = getCurrentSearchParams();\n      applyChange(searchParams, false);\n    };\n\n    const onEmitterUpdate = (searchParams: URLSearchParams) => {\n      applyChange(searchParams, true);\n    };\n\n    window.addEventListener(\"popstate\", onPopState);\n    emitter.on(\"update\", onEmitterUpdate);\n\n    return () => {\n      window.removeEventListener(\"popstate\", onPopState);\n      emitter.off(\"update\", onEmitterUpdate);\n    };\n  }, [watchKeys, parsers]);\n\n  return [state, setValues];\n}\n\nexport function usePagination(options?: {\n  defaultPage?: number;\n  defaultLimit?: number;\n  pageKey?: string;\n  limitKey?: string;\n}) {\n  const {\n    defaultPage = 1,\n    defaultLimit = 10,\n    pageKey = \"page\",\n    limitKey = \"limit\",\n  } = options || {};\n\n  const [page, setPage] = useQueryState(pageKey, asIntegerClient.withDefault!(defaultPage));\n  const [limit, setLimit] = useQueryState(limitKey, asIntegerClient.withDefault!(defaultLimit));\n\n  const currentPage = page ?? defaultPage;\n  const currentLimit = limit ?? defaultLimit;\n  const offset = ((currentPage as number) - 1) * (currentLimit as number);\n\n  return {\n    page: currentPage,\n    setPage,\n    limit: currentLimit,\n    setLimit,\n    offset,\n    resetPagination: () => {\n      setPage(defaultPage);\n      setLimit(defaultLimit);\n    },\n  };\n}\n\nexport function useSearchFilters<T extends Record<string, any>>(options?: {\n  searchKey?: string;\n  defaultFilters?: T;\n  filterKeys?: (keyof T)[];\n}) {\n  const {\n    searchKey = \"search\",\n    defaultFilters = {} as T,\n    filterKeys = Object.keys(defaultFilters) as (keyof T)[],\n  } = options || {};\n\n  const [search, setSearch] = useQueryState(searchKey, asStringClient);\n\n  const filterParsers = filterKeys.reduce(\n    (acc, key) => {\n      acc[key as string] = asStringClient;\n      return acc;\n    },\n    {} as Record<string, Parser<string>>,\n  );\n\n  const [filters, setFilters] = useQueryStates(filterParsers);\n\n  const clearFilters = () => {\n    setSearch(null);\n    const clearedFilters = filterKeys.reduce(\n      (acc, key) => {\n        acc[key as string] = null;\n        return acc;\n      },\n      {} as Record<string, null>,\n    );\n    setFilters(clearedFilters);\n  };\n\n  return {\n    search,\n    setSearch,\n    filters: filters as T,\n    setFilters,\n    clearFilters,\n  };\n}\n","/**\n * Cross-hook synchronization system for query state\n * Inspired by nuqs implementation\n */\n\ntype Listener = (searchParams: URLSearchParams) => void;\ntype KeyListener = (payload: { state: any; query: string | null }) => void;\n\nclass Emitter {\n  private listeners: Map<string, Set<Listener>> = new Map();\n  private keyListeners: Map<string, Set<KeyListener>> = new Map();\n\n  /**\n   * Emit a global update event (all hooks should sync)\n   */\n  emitUpdate(searchParams: URLSearchParams): void {\n    const listeners = this.listeners.get(\"update\") || new Set();\n    listeners.forEach((listener) => listener(searchParams));\n  }\n\n  /**\n   * Emit a key-specific update (for cross-hook sync)\n   */\n  emitKey(key: string, payload: { state: any; query: string | null }): void {\n    const listeners = this.keyListeners.get(key) || new Set();\n    listeners.forEach((listener) => listener(payload));\n  }\n\n  /**\n   * Subscribe to global updates\n   */\n  on(event: \"update\", listener: Listener): void {\n    if (!this.listeners.has(event)) {\n      this.listeners.set(event, new Set());\n    }\n    this.listeners.get(event)!.add(listener);\n  }\n\n  /**\n   * Subscribe to key-specific updates\n   */\n  onKey(key: string, listener: KeyListener): void {\n    if (!this.keyListeners.has(key)) {\n      this.keyListeners.set(key, new Set());\n    }\n    this.keyListeners.get(key)!.add(listener);\n  }\n\n  /**\n   * Unsubscribe from global updates\n   */\n  off(event: \"update\", listener: Listener): void {\n    const listeners = this.listeners.get(event);\n    if (listeners) {\n      listeners.delete(listener);\n    }\n  }\n\n  /**\n   * Unsubscribe from key-specific updates\n   */\n  offKey(key: string, listener: KeyListener): void {\n    const listeners = this.keyListeners.get(key);\n    if (listeners) {\n      listeners.delete(listener);\n    }\n  }\n}\n\nexport const emitter = new Emitter();\n"],"mappings":"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","names":["applyChange"]}