@timber-js/app 0.1.7 → 0.1.9

package/dist/_chunks/use-query-states-Dd9PVu-L.js

@@ -0,0 +1,102 @@
+import { useQueryStates } from "nuqs";
+//#region src/search-params/registry.ts
+var registry = /* @__PURE__ */ new Map();
+/**
+* Register a route's search params definition.
+* Called by the generated route manifest loader when a route's modules load.
+*/
+function registerSearchParams(route, definition) {
+	registry.set(route, definition);
+}
+/**
+* Look up a route's search params definition.
+* Returns undefined if the route hasn't been loaded yet.
+*/
+function getSearchParams(route) {
+	return registry.get(route);
+}
+//#endregion
+//#region src/client/use-query-states.ts
+/**
+* useQueryStates — client-side hook for URL-synced search params.
+*
+* Delegates to nuqs for URL synchronization, batching, React 19 transitions,
+* and throttled URL writes. Bridges timber's SearchParamCodec protocol to
+* nuqs-compatible parsers.
+*
+* Design doc: design/23-search-params.md §"Codec Bridge"
+*/
+/**
+* Bridge a timber SearchParamCodec to a nuqs-compatible SingleParser.
+*
+* nuqs parsers: { parse(string) → T|null, serialize?(T) → string, eq?, defaultValue? }
+* timber codecs: { parse(string|string[]|undefined) → T, serialize(T) → string|null }
+*/
+function bridgeCodec(codec) {
+	return {
+		parse: (v) => codec.parse(v),
+		serialize: (v) => codec.serialize(v) ?? "",
+		defaultValue: codec.parse(void 0),
+		eq: (a, b) => codec.serialize(a) === codec.serialize(b)
+	};
+}
+/**
+* Bridge an entire codec map to nuqs-compatible parsers.
+*/
+function bridgeCodecs(codecs) {
+	const result = {};
+	for (const key of Object.keys(codecs)) result[key] = bridgeCodec(codecs[key]);
+	return result;
+}
+/**
+* Read and write typed search params from/to the URL.
+*
+* Delegates to nuqs internally. The timber nuqs adapter (auto-injected in
+* browser-entry.ts) handles RSC navigation on non-shallow updates.
+*
+* Usage:
+* ```ts
+* // Via a SearchParamsDefinition
+* const [params, setParams] = definition.useQueryStates()
+*
+* // Standalone with inline codecs
+* const [params, setParams] = useQueryStates({
+*   page: fromSchema(z.coerce.number().int().min(1).default(1)),
+* })
+* ```
+*/
+function useQueryStates$1(codecsOrRoute, _options, urlKeys) {
+	let codecs;
+	let resolvedUrlKeys = urlKeys;
+	if (typeof codecsOrRoute === "string") {
+		const definition = getSearchParams(codecsOrRoute);
+		if (!definition) throw new Error(`useQueryStates('${codecsOrRoute}'): no search params registered for this route. Either the route has no search-params.ts file, or it hasn't been loaded yet. For cross-route usage, import the definition explicitly.`);
+		codecs = definition.codecs;
+		resolvedUrlKeys = definition.urlKeys;
+	} else codecs = codecsOrRoute;
+	const bridged = bridgeCodecs(codecs);
+	const nuqsOptions = {};
+	if (resolvedUrlKeys && Object.keys(resolvedUrlKeys).length > 0) nuqsOptions.urlKeys = resolvedUrlKeys;
+	const [values, setValues] = useQueryStates(bridged, nuqsOptions);
+	const setParams = (partial, setOptions) => {
+		const nuqsSetOptions = {};
+		if (setOptions?.shallow !== void 0) nuqsSetOptions.shallow = setOptions.shallow;
+		if (setOptions?.scroll !== void 0) nuqsSetOptions.scroll = setOptions.scroll;
+		if (setOptions?.history !== void 0) nuqsSetOptions.history = setOptions.history;
+		setValues(partial, nuqsSetOptions);
+	};
+	return [values, setParams];
+}
+/**
+* Create a useQueryStates binding for a SearchParamsDefinition.
+* This is used internally by SearchParamsDefinition.useQueryStates().
+*/
+function bindUseQueryStates(definition) {
+	return (options) => {
+		return useQueryStates$1(definition.codecs, options, definition.urlKeys);
+	};
+}
+//#endregion
+export { registerSearchParams as i, useQueryStates$1 as n, getSearchParams as r, bindUseQueryStates as t };
+
+//# sourceMappingURL=use-query-states-Dd9PVu-L.js.map

package/dist/_chunks/use-query-states-Dd9PVu-L.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-query-states-Dd9PVu-L.js","names":[],"sources":["../../src/search-params/registry.ts","../../src/client/use-query-states.ts"],"sourcesContent":["/**\n * Runtime registry for route-scoped search params definitions.\n *\n * When a route's modules load, the framework registers its search-params\n * definition here. useQueryStates('/route') resolves codecs from this map.\n *\n * Design doc: design/23-search-params.md §\"Runtime: Registration at Route Load\"\n */\n\nimport type { SearchParamsDefinition } from './create.js';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst registry = new Map<string, SearchParamsDefinition<any>>();\n\n/**\n * Register a route's search params definition.\n * Called by the generated route manifest loader when a route's modules load.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function registerSearchParams(route: string, definition: SearchParamsDefinition<any>): void {\n  registry.set(route, definition);\n}\n\n/**\n * Look up a route's search params definition.\n * Returns undefined if the route hasn't been loaded yet.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function getSearchParams(route: string): SearchParamsDefinition<any> | undefined {\n  return registry.get(route);\n}\n","/**\n * useQueryStates — client-side hook for URL-synced search params.\n *\n * Delegates to nuqs for URL synchronization, batching, React 19 transitions,\n * and throttled URL writes. Bridges timber's SearchParamCodec protocol to\n * nuqs-compatible parsers.\n *\n * Design doc: design/23-search-params.md §\"Codec Bridge\"\n */\n\n'use client';\n\nimport { useQueryStates as nuqsUseQueryStates } from 'nuqs';\nimport type { SingleParser } from 'nuqs';\nimport type {\n  SearchParamCodec,\n  SearchParamsDefinition,\n  SetParams,\n  QueryStatesOptions,\n} from '#/search-params/create.js';\nimport { getSearchParams } from '#/search-params/registry.js';\n\n// ─── Codec Bridge ─────────────────────────────────────────────────\n\n/**\n * Bridge a timber SearchParamCodec to a nuqs-compatible SingleParser.\n *\n * nuqs parsers: { parse(string) → T|null, serialize?(T) → string, eq?, defaultValue? }\n * timber codecs: { parse(string|string[]|undefined) → T, serialize(T) → string|null }\n */\nfunction bridgeCodec<T>(codec: SearchParamCodec<T>): SingleParser<T> & { defaultValue: T } {\n  return {\n    parse: (v: string) => codec.parse(v),\n    serialize: (v: T) => codec.serialize(v) ?? '',\n    defaultValue: codec.parse(undefined) as T,\n    eq: (a: T, b: T) => codec.serialize(a) === codec.serialize(b),\n  };\n}\n\n/**\n * Bridge an entire codec map to nuqs-compatible parsers.\n */\nfunction bridgeCodecs<T extends Record<string, unknown>>(codecs: {\n  [K in keyof T]: SearchParamCodec<T[K]>;\n}) {\n  const result: Record<string, SingleParser<unknown> & { defaultValue: unknown }> = {};\n  for (const key of Object.keys(codecs)) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    result[key] = bridgeCodec(codecs[key as keyof T]) as any;\n  }\n  return result as { [K in keyof T]: SingleParser<T[K]> & { defaultValue: T[K] } };\n}\n\n// ─── Hook ─────────────────────────────────────────────────────────\n\n/**\n * Read and write typed search params from/to the URL.\n *\n * Delegates to nuqs internally. The timber nuqs adapter (auto-injected in\n * browser-entry.ts) handles RSC navigation on non-shallow updates.\n *\n * Usage:\n * ```ts\n * // Via a SearchParamsDefinition\n * const [params, setParams] = definition.useQueryStates()\n *\n * // Standalone with inline codecs\n * const [params, setParams] = useQueryStates({\n *   page: fromSchema(z.coerce.number().int().min(1).default(1)),\n * })\n * ```\n */\nexport function useQueryStates<T extends Record<string, unknown>>(\n  codecsOrRoute: { [K in keyof T]: SearchParamCodec<T[K]> } | string,\n  _options?: QueryStatesOptions,\n  urlKeys?: Readonly<Record<string, string>>\n): [T, SetParams<T>] {\n  // Route-string overload: resolve codecs from the registry\n  let codecs: { [K in keyof T]: SearchParamCodec<T[K]> };\n  let resolvedUrlKeys = urlKeys;\n  if (typeof codecsOrRoute === 'string') {\n    const definition = getSearchParams(codecsOrRoute);\n    if (!definition) {\n      throw new Error(\n        `useQueryStates('${codecsOrRoute}'): no search params registered for this route. ` +\n          `Either the route has no search-params.ts file, or it hasn't been loaded yet. ` +\n          `For cross-route usage, import the definition explicitly.`\n      );\n    }\n    codecs = definition.codecs as { [K in keyof T]: SearchParamCodec<T[K]> };\n    resolvedUrlKeys = definition.urlKeys;\n  } else {\n    codecs = codecsOrRoute;\n  }\n\n  const bridged = bridgeCodecs(codecs);\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const nuqsOptions: any = {};\n  if (resolvedUrlKeys && Object.keys(resolvedUrlKeys).length > 0) {\n    nuqsOptions.urlKeys = resolvedUrlKeys;\n  }\n\n  const [values, setValues] = nuqsUseQueryStates(bridged, nuqsOptions);\n\n  // Wrap the nuqs setter to match timber's SetParams<T> signature.\n  // nuqs's setter accepts Partial<Nullable<Values>> | UpdaterFn | null.\n  // timber's setter accepts Partial<T> with optional SetParamsOptions.\n  const setParams: SetParams<T> = (partial, setOptions?) => {\n    const nuqsSetOptions: Record<string, unknown> = {};\n    if (setOptions?.shallow !== undefined) nuqsSetOptions.shallow = setOptions.shallow;\n    if (setOptions?.scroll !== undefined) nuqsSetOptions.scroll = setOptions.scroll;\n    if (setOptions?.history !== undefined) nuqsSetOptions.history = setOptions.history;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    void setValues(partial as any, nuqsSetOptions);\n  };\n\n  return [values as T, setParams];\n}\n\n// ─── Definition binding ───────────────────────────────────────────\n\n/**\n * Create a useQueryStates binding for a SearchParamsDefinition.\n * This is used internally by SearchParamsDefinition.useQueryStates().\n */\nexport function bindUseQueryStates<T extends Record<string, unknown>>(\n  definition: SearchParamsDefinition<T>\n): (options?: QueryStatesOptions) => [T, SetParams<T>] {\n  return (options?: QueryStatesOptions) => {\n    return useQueryStates<T>(definition.codecs, options, definition.urlKeys);\n  };\n}\n"],"mappings":";;AAYA,IAAM,2BAAW,IAAI,KAA0C;;;;;AAO/D,SAAgB,qBAAqB,OAAe,YAA+C;AACjG,UAAS,IAAI,OAAO,WAAW;;;;;;AAQjC,SAAgB,gBAAgB,OAAwD;AACtF,QAAO,SAAS,IAAI,MAAM;;;;;;;;;;;;;;;;;;;ACC5B,SAAS,YAAe,OAAmE;AACzF,QAAO;EACL,QAAQ,MAAc,MAAM,MAAM,EAAE;EACpC,YAAY,MAAS,MAAM,UAAU,EAAE,IAAI;EAC3C,cAAc,MAAM,MAAM,KAAA,EAAU;EACpC,KAAK,GAAM,MAAS,MAAM,UAAU,EAAE,KAAK,MAAM,UAAU,EAAE;EAC9D;;;;;AAMH,SAAS,aAAgD,QAEtD;CACD,MAAM,SAA4E,EAAE;AACpF,MAAK,MAAM,OAAO,OAAO,KAAK,OAAO,CAEnC,QAAO,OAAO,YAAY,OAAO,KAAgB;AAEnD,QAAO;;;;;;;;;;;;;;;;;;;AAsBT,SAAgB,iBACd,eACA,UACA,SACmB;CAEnB,IAAI;CACJ,IAAI,kBAAkB;AACtB,KAAI,OAAO,kBAAkB,UAAU;EACrC,MAAM,aAAa,gBAAgB,cAAc;AACjD,MAAI,CAAC,WACH,OAAM,IAAI,MACR,mBAAmB,cAAc,uLAGlC;AAEH,WAAS,WAAW;AACpB,oBAAkB,WAAW;OAE7B,UAAS;CAGX,MAAM,UAAU,aAAa,OAAO;CAGpC,MAAM,cAAmB,EAAE;AAC3B,KAAI,mBAAmB,OAAO,KAAK,gBAAgB,CAAC,SAAS,EAC3D,aAAY,UAAU;CAGxB,MAAM,CAAC,QAAQ,aAAa,eAAmB,SAAS,YAAY;CAKpE,MAAM,aAA2B,SAAS,eAAgB;EACxD,MAAM,iBAA0C,EAAE;AAClD,MAAI,YAAY,YAAY,KAAA,EAAW,gBAAe,UAAU,WAAW;AAC3E,MAAI,YAAY,WAAW,KAAA,EAAW,gBAAe,SAAS,WAAW;AACzE,MAAI,YAAY,YAAY,KAAA,EAAW,gBAAe,UAAU,WAAW;AAEtE,YAAU,SAAgB,eAAe;;AAGhD,QAAO,CAAC,QAAa,UAAU;;;;;;AASjC,SAAgB,mBACd,YACqD;AACrD,SAAQ,YAAiC;AACvC,SAAO,iBAAkB,WAAW,QAAQ,SAAS,WAAW,QAAQ"}

package/dist/client/index.js

@@ -1,10 +1,9 @@
 "use client";
 import { TimberErrorBoundary } from "./error-boundary.js";
 import { i as setSsrData, n as clearSsrData, r as getSsrData, t as useCookie } from "../_chunks/use-cookie-HcvNlW4L.js";
-import { t as getSearchParams$1 } from "../_chunks/registry-BfPM41ri.js";
+import { n as useQueryStates, t as bindUseQueryStates } from "../_chunks/use-query-states-Dd9PVu-L.js";
 import { createContext, createElement, useActionState as useActionState$1, useContext, useEffect, useMemo, useRef, useSyncExternalStore, useTransition } from "react";
 import { jsxDEV } from "react/jsx-dev-runtime";
-import { useQueryStates as useQueryStates$1 } from "nuqs";
 //#region src/client/link-navigate-interceptor.tsx
 var _jsxFileName$2 = "/Users/dsaewitz/y/timber-js-fresh/packages/timber-app/src/client/link-navigate-interceptor.tsx";
 /** Symbol used to store the onNavigate callback on anchor elements. */
@@ -1133,87 +1132,6 @@ function useFormErrors(result) {
 	};
 }
 //#endregion
-//#region src/client/use-query-states.ts
-/**
-* useQueryStates — client-side hook for URL-synced search params.
-*
-* Delegates to nuqs for URL synchronization, batching, React 19 transitions,
-* and throttled URL writes. Bridges timber's SearchParamCodec protocol to
-* nuqs-compatible parsers.
-*
-* Design doc: design/23-search-params.md §"Codec Bridge"
-*/
-/**
-* Bridge a timber SearchParamCodec to a nuqs-compatible SingleParser.
-*
-* nuqs parsers: { parse(string) → T|null, serialize?(T) → string, eq?, defaultValue? }
-* timber codecs: { parse(string|string[]|undefined) → T, serialize(T) → string|null }
-*/
-function bridgeCodec(codec) {
-	return {
-		parse: (v) => codec.parse(v),
-		serialize: (v) => codec.serialize(v) ?? "",
-		defaultValue: codec.parse(void 0),
-		eq: (a, b) => codec.serialize(a) === codec.serialize(b)
-	};
-}
-/**
-* Bridge an entire codec map to nuqs-compatible parsers.
-*/
-function bridgeCodecs(codecs) {
-	const result = {};
-	for (const key of Object.keys(codecs)) result[key] = bridgeCodec(codecs[key]);
-	return result;
-}
-/**
-* Read and write typed search params from/to the URL.
-*
-* Delegates to nuqs internally. The timber nuqs adapter (auto-injected in
-* browser-entry.ts) handles RSC navigation on non-shallow updates.
-*
-* Usage:
-* ```ts
-* // Via a SearchParamsDefinition
-* const [params, setParams] = definition.useQueryStates()
-*
-* // Standalone with inline codecs
-* const [params, setParams] = useQueryStates({
-*   page: fromSchema(z.coerce.number().int().min(1).default(1)),
-* })
-* ```
-*/
-function useQueryStates(codecsOrRoute, _options, urlKeys) {
-	let codecs;
-	let resolvedUrlKeys = urlKeys;
-	if (typeof codecsOrRoute === "string") {
-		const definition = getSearchParams$1(codecsOrRoute);
-		if (!definition) throw new Error(`useQueryStates('${codecsOrRoute}'): no search params registered for this route. Either the route has no search-params.ts file, or it hasn't been loaded yet. For cross-route usage, import the definition explicitly.`);
-		codecs = definition.codecs;
-		resolvedUrlKeys = definition.urlKeys;
-	} else codecs = codecsOrRoute;
-	const bridged = bridgeCodecs(codecs);
-	const nuqsOptions = {};
-	if (resolvedUrlKeys && Object.keys(resolvedUrlKeys).length > 0) nuqsOptions.urlKeys = resolvedUrlKeys;
-	const [values, setValues] = useQueryStates$1(bridged, nuqsOptions);
-	const setParams = (partial, setOptions) => {
-		const nuqsSetOptions = {};
-		if (setOptions?.shallow !== void 0) nuqsSetOptions.shallow = setOptions.shallow;
-		if (setOptions?.scroll !== void 0) nuqsSetOptions.scroll = setOptions.scroll;
-		if (setOptions?.history !== void 0) nuqsSetOptions.history = setOptions.history;
-		setValues(partial, nuqsSetOptions);
-	};
-	return [values, setParams];
-}
-/**
-* Create a useQueryStates binding for a SearchParamsDefinition.
-* This is used internally by SearchParamsDefinition.useQueryStates().
-*/
-function bindUseQueryStates(definition) {
-	return (options) => {
-		return useQueryStates(definition.codecs, options, definition.urlKeys);
-	};
-}
-//#endregion
 export { HistoryStack, Link, LinkStatusContext, PrefetchCache, SegmentCache, SegmentProvider, TimberErrorBoundary, bindUseQueryStates, buildLinkProps, clearSsrData, createRouter, getRouter, getSsrData, interpolateParams, resolveHref, setCurrentParams, setSsrData, useActionState, useCookie, useFormAction, useFormErrors, useLinkStatus, useNavigationPending, useParams, usePathname, useQueryStates, useRouter, useSearchParams, useSegmentContext, useSelectedLayoutSegment, useSelectedLayoutSegments, validateLinkHref };
 
 //# sourceMappingURL=index.js.map