@vertz/ui 0.2.28 → 0.2.30

package/dist/shared/{chunk-djvarb8r.js → chunk-1j59xzqm.js}

@@ -5,6 +5,7 @@ import {
   styleObjectToString
 } from "./chunk-h1fsr8kv.js";
 import {
+  advanceCursor,
   claimComment,
   claimElement,
   claimText,
@@ -19,7 +20,7 @@ import {
   pushScope,
   resumeHydration,
   runCleanups
-} from "./chunk-ppr06jgn.js";
+} from "./chunk-1yd6jfw5.js";
 
 // src/dom/dom-adapter.ts
 function createDOMAdapter() {
@@ -131,18 +132,26 @@ function __child(fn) {
   if (getIsHydrating()) {
     const claimed = claimComment();
     if (claimed) {
+      if (typeof process !== "undefined" && true && claimed.data.trim() !== "child") {
+        console.warn(`[hydrate] __child expected <!--child--> but claimed <!--${claimed.data}-->. ` + "Cursor may be misaligned.");
+      }
       const anchor2 = claimed;
       const managed2 = [];
       const childCleanups2 = { value: [] };
       let sibling = anchor2.nextSibling;
       while (sibling) {
+        const next = sibling.nextSibling;
+        if (sibling.nodeType === 8 && sibling.data.trim() === "/child") {
+          sibling.parentNode?.removeChild(sibling);
+          break;
+        }
         if (sibling.nodeType === 8 && sibling.data.trim() === "child") {
           break;
         }
-        const next = sibling.nextSibling;
         sibling.parentNode?.removeChild(sibling);
         sibling = next;
       }
+      advanceCursor(anchor2.nextSibling);
       pauseHydration();
       try {
         const dispose2 = childEffect(anchor2, ((originalFn) => () => {
@@ -169,8 +178,10 @@ function __child(fn) {
     }
   }
   const anchor = getAdapter().createComment("child");
+  const endMarker = getAdapter().createComment("/child");
   const fragment = getAdapter().createDocumentFragment();
   fragment.appendChild(anchor);
+  fragment.appendChild(endMarker);
   const managed = [];
   const childCleanups = { value: [] };
   const dispose = childEffect(anchor, fn, managed, childCleanups);

package/dist/shared/{chunk-ppr06jgn.js → chunk-1yd6jfw5.js}

@@ -368,6 +368,9 @@ function pauseHydration() {
 function resumeHydration() {
   isHydrating = true;
 }
+function advanceCursor(node) {
+  currentNode = node;
+}
 function claimElement(tag) {
   const upperTag = tag.toUpperCase();
   const savedNode = currentNode;
@@ -469,8 +472,15 @@ function findUnclaimedNodes(root, claimed) {
       if (child.nodeType === Node.COMMENT_NODE && claimed.has(child) && child.data.trim() === "child") {
         child = child.nextSibling;
         while (child) {
-          if (child.nodeType === Node.COMMENT_NODE && child.data.trim() === "child") {
-            break;
+          if (child.nodeType === Node.COMMENT_NODE) {
+            const data = child.data.trim();
+            if (data === "/child") {
+              child = child.nextSibling;
+              break;
+            }
+            if (data === "child") {
+              break;
+            }
           }
           child = child.nextSibling;
         }
@@ -502,10 +512,7 @@ function describeNode(node) {
     const preview = data.length > 20 ? data.slice(0, 20) + "..." : data;
     return `text("${preview}")`;
   }
-  if (node.nodeType === Node.COMMENT_NODE) {
-    return `<!-- ${node.data} -->`;
-  }
-  return `[node type=${node.nodeType}]`;
+  return `<!-- ${node.data} -->`;
 }
 
 // src/runtime/signal.ts
@@ -722,4 +729,4 @@ function lifecycleEffect(fn) {
   return dispose;
 }
 
-export { registerSSRResolver, getSSRContext, hasSSRResolver, createContext, useContext, getContextScope, setContextScope, startHydration, endHydration, discardDeferredEffects, getIsHydrating, pauseHydration, resumeHydration, claimElement, claimText, claimComment, enterChildren, exitChildren, DisposalScopeError, onCleanup, _tryOnCleanup, pushScope, popScope, runCleanups, batch, setReadValueCallback, untrack, startSignalCollection, stopSignalCollection, signal, computed, domEffect, deferredDomEffect, lifecycleEffect };
+export { registerSSRResolver, getSSRContext, hasSSRResolver, createContext, useContext, getContextScope, setContextScope, startHydration, endHydration, discardDeferredEffects, getIsHydrating, pauseHydration, resumeHydration, advanceCursor, claimElement, claimText, claimComment, enterChildren, exitChildren, DisposalScopeError, onCleanup, _tryOnCleanup, pushScope, popScope, runCleanups, batch, setReadValueCallback, untrack, startSignalCollection, stopSignalCollection, signal, computed, domEffect, deferredDomEffect, lifecycleEffect };

package/dist/shared/{chunk-1jgws7rs.js → chunk-5vcnmqck.js}

@@ -3,10 +3,10 @@ import {
 } from "./chunk-jrtrk5z4.js";
 import {
   registerActiveQuery
-} from "./chunk-09ntccdx.js";
+} from "./chunk-pv0apt9z.js";
 import {
   isBrowser
-} from "./chunk-xs5s8gqe.js";
+} from "./chunk-sjypbv24.js";
 import {
   _tryOnCleanup,
   batch,
@@ -16,7 +16,7 @@ import {
   setReadValueCallback,
   signal,
   untrack
-} from "./chunk-ppr06jgn.js";
+} from "./chunk-1yd6jfw5.js";
 
 // src/query/cache.ts
 class MemoryCache {
@@ -1144,6 +1144,8 @@ function query(source, options = {}) {
     getInflight().delete(key);
     refetchTrigger.value = refetchTrigger.peek() + 1;
   }
+  let unsubscribeBus;
+  let unregisterFromRegistry;
   let disposeFn;
   let isFirst = true;
   disposeFn = lifecycleEffect(() => {
@@ -1332,9 +1334,7 @@ function query(source, options = {}) {
       getQueryEnvelopeStore().delete(queryKey);
     };
   }
-  let unsubscribeBus;
-  let unregisterFromRegistry;
-  if (entityMeta && !isSSR()) {
+  if (entityMeta && !isSSR() && !unsubscribeBus) {
     unsubscribeBus = getMutationEventBus().subscribe(entityMeta.entityType, refetch);
     unregisterFromRegistry = registerActiveQuery(entityMeta, refetch, createClearData(entityMeta));
   }

package/dist/shared/{chunk-2krx4aqe.js → chunk-5xm1w16j.js}

@@ -3,7 +3,7 @@ import {
   beginDeferringMounts,
   discardDeferredMounts,
   flushDeferredMounts
-} from "./chunk-svvqjmyy.js";
+} from "./chunk-mntc8w0g.js";
 import {
   __append,
   __classList,
@@ -11,13 +11,13 @@ import {
   __enterChildren,
   __exitChildren,
   __staticText
-} from "./chunk-djvarb8r.js";
+} from "./chunk-1j59xzqm.js";
 import {
   RouterContext
-} from "./chunk-7nr2ebrf.js";
+} from "./chunk-9p84cvet.js";
 import {
   isBrowser
-} from "./chunk-xs5s8gqe.js";
+} from "./chunk-sjypbv24.js";
 import {
   _tryOnCleanup,
   createContext,
@@ -32,7 +32,7 @@ import {
   startHydration,
   untrack,
   useContext
-} from "./chunk-ppr06jgn.js";
+} from "./chunk-1yd6jfw5.js";
 
 // src/component/error-boundary-context.ts
 var handlerStack = [];
@@ -551,8 +551,12 @@ function parseSearchParams(urlParams, schema) {
   }
   return raw;
 }
-function useSearchParams(searchSignal) {
-  return searchSignal.value;
+function useSearchParams() {
+  const router = useContext(RouterContext);
+  if (!router) {
+    throw new Error("useSearchParams() must be called within RouterContext.Provider");
+  }
+  return router._reactiveSearchParams;
 }
 
 export { getCurrentErrorHandler, ErrorBoundary, createLink, Link, OutletContext, Outlet, RouterView, parseSearchParams, useSearchParams };

package/dist/shared/{chunk-7nr2ebrf.js → chunk-9p84cvet.js}

@@ -1,7 +1,7 @@
 import {
   createContext,
   useContext
-} from "./chunk-ppr06jgn.js";
+} from "./chunk-1yd6jfw5.js";
 
 // src/router/router-context.ts
 var RouterContext = createContext(undefined, "@vertz/ui::RouterContext");

package/dist/shared/{chunk-am9zaw4h.js → chunk-ah86rm07.js}

@@ -76,8 +76,10 @@ function matchRoute(routes, url) {
     }
   }
   let search = {};
+  let foundSchema = false;
   for (const m of matched) {
     if (m.route.searchParams) {
+      foundSchema = true;
       const raw = {};
       for (const [key, value] of searchParams.entries()) {
         raw[key] = value;
@@ -89,6 +91,11 @@ function matchRoute(routes, url) {
       break;
     }
   }
+  if (!foundSchema) {
+    for (const [key, value] of searchParams.entries()) {
+      search[key] = value;
+    }
+  }
   return {
     matched,
     params: allParams,

package/dist/shared/{chunk-h2sjma78.js → chunk-hcgnfw27.js}

@@ -1,7 +1,7 @@
 import {
   computed,
   signal
-} from "./chunk-ppr06jgn.js";
+} from "./chunk-1yd6jfw5.js";
 
 // src/form/field-state.ts
 function createFieldState(_name, initialValue) {

package/dist/shared/{chunk-e09mdqcx.js → chunk-mm9ms792.js}

@@ -1,17 +1,128 @@
 import {
   executeLoaders,
   matchRoute
-} from "./chunk-am9zaw4h.js";
+} from "./chunk-ah86rm07.js";
 import {
   prefetchNavData
 } from "./chunk-jrtrk5z4.js";
 import {
   isBrowser
-} from "./chunk-xs5s8gqe.js";
+} from "./chunk-sjypbv24.js";
 import {
   getSSRContext,
   signal
-} from "./chunk-ppr06jgn.js";
+} from "./chunk-1yd6jfw5.js";
+
+// src/router/reactive-search-params.ts
+function shallowEqual(a, b) {
+  const keysA = Object.keys(a);
+  const keysB = Object.keys(b);
+  if (keysA.length !== keysB.length)
+    return false;
+  for (const key of keysA) {
+    if (a[key] !== b[key])
+      return false;
+  }
+  return true;
+}
+function buildMergedSearch(current, pending) {
+  const merged = { ...current };
+  for (const [key, value] of Object.entries(pending)) {
+    if (value === undefined || value === null) {
+      delete merged[key];
+    } else {
+      merged[key] = value;
+    }
+  }
+  return merged;
+}
+function currentPathname() {
+  return typeof window !== "undefined" ? window.location.pathname : "/";
+}
+function createReactiveSearchParams(rawSearchParamsSignal, navigateFn) {
+  let pending = null;
+  let capturedPathname = null;
+  function flush() {
+    if (!pending)
+      return;
+    const merged = buildMergedSearch(rawSearchParamsSignal.value, pending);
+    const pathname = capturedPathname ?? currentPathname();
+    pending = null;
+    capturedPathname = null;
+    if (shallowEqual(merged, rawSearchParamsSignal.value))
+      return;
+    navigateFn({
+      to: pathname,
+      search: merged,
+      replace: true
+    });
+  }
+  function navigateWithOptions(partial, options) {
+    pending = null;
+    capturedPathname = null;
+    const merged = buildMergedSearch(rawSearchParamsSignal.value, partial);
+    navigateFn({
+      to: currentPathname(),
+      search: merged,
+      replace: !options?.push
+    });
+  }
+  return new Proxy({}, {
+    get(_target, key) {
+      if (key === "navigate")
+        return navigateWithOptions;
+      if (typeof key === "symbol")
+        return;
+      if (pending && key in pending)
+        return pending[key];
+      return rawSearchParamsSignal.value[key];
+    },
+    set(_target, key, value) {
+      if (typeof key === "symbol")
+        return false;
+      if (!pending) {
+        pending = {};
+        capturedPathname = currentPathname();
+        queueMicrotask(flush);
+      }
+      pending[key] = value;
+      return true;
+    },
+    deleteProperty(_target, key) {
+      if (typeof key === "symbol")
+        return false;
+      if (!pending) {
+        pending = {};
+        capturedPathname = currentPathname();
+        queueMicrotask(flush);
+      }
+      pending[key] = undefined;
+      return true;
+    },
+    ownKeys() {
+      const current = pending ? buildMergedSearch(rawSearchParamsSignal.value, pending) : rawSearchParamsSignal.value;
+      return Object.keys(current);
+    },
+    getOwnPropertyDescriptor(_target, key) {
+      if (typeof key === "symbol")
+        return;
+      const val = pending && key in pending ? pending[key] : rawSearchParamsSignal.value[key];
+      if (val === undefined || val === null)
+        return;
+      return { configurable: true, enumerable: true, writable: true, value: val };
+    },
+    has(_target, key) {
+      if (typeof key === "symbol")
+        return false;
+      if (key === "navigate")
+        return true;
+      if (pending && key in pending) {
+        return pending[key] !== undefined && pending[key] !== null;
+      }
+      return key in rawSearchParamsSignal.value;
+    }
+  });
+}
 
 // src/router/view-transitions.ts
 var transitionGen = 0;
@@ -124,7 +235,82 @@ function createRouter(routes, initialUrlOrOptions, maybeOptions) {
     };
     const ssrUrl = initialUrl ?? ssrCtx?.url ?? "/";
     const fallbackMatch = matchRoute(routes, ssrUrl);
+    const ssrSearchParamsSignal = {
+      get value() {
+        const ctx = getSSRContext();
+        if (ctx) {
+          const m = matchRoute(routes, ctx.url);
+          return m?.search ?? {};
+        }
+        return fallbackMatch?.search ?? {};
+      },
+      peek() {
+        const ctx = getSSRContext();
+        if (ctx) {
+          const m = matchRoute(routes, ctx.url);
+          return m?.search ?? {};
+        }
+        return fallbackMatch?.search ?? {};
+      },
+      notify() {}
+    };
+    const ssrReactiveSearchParams = new Proxy({}, {
+      get(_target, key) {
+        if (key === "navigate") {
+          return () => {
+            if (true) {
+              throw new Error("useSearchParams().navigate() is not supported during SSR. " + "Use schema defaults for initial values.");
+            }
+          };
+        }
+        if (typeof key === "symbol")
+          return;
+        const ctx = getSSRContext();
+        if (ctx) {
+          const m = matchRoute(routes, ctx.url);
+          return m?.search?.[key];
+        }
+        return fallbackMatch?.search?.[key];
+      },
+      set() {
+        if (true) {
+          throw new Error("useSearchParams() writes are not supported during SSR. " + "Use schema defaults for initial values.");
+        }
+        return true;
+      },
+      deleteProperty() {
+        if (true) {
+          throw new Error("useSearchParams() writes are not supported during SSR. " + "Use schema defaults for initial values.");
+        }
+        return true;
+      },
+      ownKeys() {
+        const ctx = getSSRContext();
+        const search = ctx ? matchRoute(routes, ctx.url)?.search ?? {} : fallbackMatch?.search ?? {};
+        return Object.keys(search);
+      },
+      getOwnPropertyDescriptor(_target, key) {
+        if (typeof key === "symbol")
+          return;
+        const ctx = getSSRContext();
+        const search = ctx ? matchRoute(routes, ctx.url)?.search ?? {} : fallbackMatch?.search ?? {};
+        const val = search[key];
+        if (val === undefined)
+          return;
+        return { configurable: true, enumerable: true, writable: true, value: val };
+      },
+      has(_target, key) {
+        if (typeof key === "symbol")
+          return false;
+        if (key === "navigate")
+          return true;
+        const ctx = getSSRContext();
+        const search = ctx ? matchRoute(routes, ctx.url)?.search ?? {} : fallbackMatch?.search ?? {};
+        return key in search;
+      }
+    });
     return {
+      _reactiveSearchParams: ssrReactiveSearchParams,
       current: {
         get value() {
           const ctx = getSSRContext();
@@ -142,25 +328,7 @@ function createRouter(routes, initialUrlOrOptions, maybeOptions) {
         },
         notify() {}
       },
-      searchParams: {
-        get value() {
-          const ctx = getSSRContext();
-          if (ctx) {
-            const m = matchRoute(routes, ctx.url);
-            return m?.search ?? {};
-          }
-          return fallbackMatch?.search ?? {};
-        },
-        peek() {
-          const ctx = getSSRContext();
-          if (ctx) {
-            const m = matchRoute(routes, ctx.url);
-            return m?.search ?? {};
-          }
-          return fallbackMatch?.search ?? {};
-        },
-        notify() {}
-      },
+      searchParams: ssrSearchParamsSignal,
       loaderData: { value: [], peek: () => [], notify() {} },
       loaderError: { value: null, peek: () => null, notify() {} },
       navigate: () => Promise.resolve(),
@@ -367,7 +535,9 @@ function createRouter(routes, initialUrlOrOptions, maybeOptions) {
       activePrefetchUrl = null;
     }
   }
+  const _reactiveSearchParams = createReactiveSearchParams(_searchParams, navigate);
   return {
+    _reactiveSearchParams,
     current,
     dispose,
     loaderData,

package/dist/shared/{chunk-svvqjmyy.js → chunk-mntc8w0g.js}

@@ -5,7 +5,7 @@ import {
   pushScope,
   runCleanups,
   untrack
-} from "./chunk-ppr06jgn.js";
+} from "./chunk-1yd6jfw5.js";
 
 // src/component/lifecycle.ts
 var mountFrames = [];

package/dist/shared/{chunk-ymc3wwam.js → chunk-n824qrvk.js}

@@ -1,9 +1,9 @@
 import {
   injectCSS
-} from "./chunk-j1a7t906.js";
+} from "./chunk-pwmjtxpn.js";
 import {
   createContext
-} from "./chunk-ppr06jgn.js";
+} from "./chunk-1yd6jfw5.js";
 
 // src/dom/animation.ts
 function onAnimationsComplete(el, callback) {

package/dist/shared/{chunk-09ntccdx.js → chunk-pv0apt9z.js}

@@ -1,6 +1,6 @@
 import {
   getSSRContext
-} from "./chunk-ppr06jgn.js";
+} from "./chunk-1yd6jfw5.js";
 
 // src/query/invalidate.ts
 var registry = new Set;

package/dist/shared/{chunk-j1a7t906.js → chunk-pwmjtxpn.js}

@@ -4,10 +4,10 @@ import {
   __element,
   __enterChildren,
   __exitChildren
-} from "./chunk-djvarb8r.js";
+} from "./chunk-1j59xzqm.js";
 import {
   getSSRContext
-} from "./chunk-ppr06jgn.js";
+} from "./chunk-1yd6jfw5.js";
 
 // src/component/children.ts
 var MAX_RESOLVE_DEPTH = 100;

package/dist/shared/{chunk-xs5s8gqe.js → chunk-sjypbv24.js}

@@ -1,6 +1,6 @@
 import {
   hasSSRResolver
-} from "./chunk-ppr06jgn.js";
+} from "./chunk-1yd6jfw5.js";
 
 // src/env/is-browser.ts
 function isBrowser() {

package/dist/src/auth/public.d.ts

@@ -76,6 +76,7 @@ interface DenialMeta {
 	requiredRoles?: string[];
 	disabledFlags?: string[];
 	limit?: {
+		key?: string;
 		max: number;
 		consumed: number;
 		remaining: number;
@@ -91,7 +92,10 @@ interface AccessCheckData {
 interface AccessSet {
 	entitlements: Record<string, AccessCheckData>;
 	flags: Record<string, boolean>;
+	/** @deprecated Use `plans` for multi-level. Kept for backward compat. */
 	plan: string | null;
+	/** Plan per billing level. Keys are entity names. */
+	plans: Record<string, string | null>;
 	computedAt: string;
 }
 /** Public return type of can(). All properties are ReadonlySignal (compiler auto-unwraps). */

package/dist/src/auth/public.js

@@ -1,12 +1,12 @@
 import {
   RouterContext
-} from "../../shared/chunk-7nr2ebrf.js";
+} from "../../shared/chunk-9p84cvet.js";
 import {
   invalidateTenantQueries
-} from "../../shared/chunk-09ntccdx.js";
+} from "../../shared/chunk-pv0apt9z.js";
 import {
   isBrowser
-} from "../../shared/chunk-xs5s8gqe.js";
+} from "../../shared/chunk-sjypbv24.js";
 import {
   _tryOnCleanup,
   computed,
@@ -14,7 +14,7 @@ import {
   getSSRContext,
   signal,
   useContext
-} from "../../shared/chunk-ppr06jgn.js";
+} from "../../shared/chunk-1yd6jfw5.js";
 
 // src/auth/access-context.ts
 var AccessContext = createContext(undefined, "@vertz/ui::AccessContext");

package/dist/src/css/public.js

@@ -8,10 +8,10 @@ import {
   globalCss,
   s,
   variants
-} from "../../shared/chunk-j1a7t906.js";
-import"../../shared/chunk-djvarb8r.js";
+} from "../../shared/chunk-pwmjtxpn.js";
+import"../../shared/chunk-1j59xzqm.js";
 import"../../shared/chunk-h1fsr8kv.js";
-import"../../shared/chunk-ppr06jgn.js";
+import"../../shared/chunk-1yd6jfw5.js";
 export {
   variants,
   s,

package/dist/src/form/public.js

@@ -3,8 +3,8 @@ import {
   form,
   formDataToObject,
   validate
-} from "../../shared/chunk-h2sjma78.js";
-import"../../shared/chunk-ppr06jgn.js";
+} from "../../shared/chunk-hcgnfw27.js";
+import"../../shared/chunk-1yd6jfw5.js";
 export {
   validate,
   formDataToObject,

package/dist/src/index.d.ts

@@ -1423,6 +1423,20 @@ type TypedRoutes<T extends Record<string, RouteConfigLike> = RouteDefinitionMap>
 * Usage: `useRouter<InferRouteMap<typeof routes>>()`
 */
 type InferRouteMap<T> = T extends TypedRoutes<infer R> ? R : T;
+/**
+* Extract the search params type from a route definition map for a given path.
+*
+* If the route at `TPath` has a `searchParams` schema, resolves to the schema's
+* output type `T`. Otherwise resolves to `Record<string, string>` (raw URL params).
+*
+* Parallel to `ExtractParams<TPath>` which extracts path params from the URL pattern.
+*/
+type ExtractSearchParams<
+	TPath extends string,
+	TMap extends Record<string, RouteConfigLike> = RouteDefinitionMap
+> = TPath extends keyof TMap ? TMap[TPath] extends {
+	searchParams: SearchParamSchema<infer T>;
+} ? T : Record<string, string> : Record<string, string>;
 /** Internal compiled route. */
 interface CompiledRoute {
 	/** The original path pattern. */
@@ -1526,6 +1540,13 @@ declare function createLink(currentPath: ReadonlySignal<string>, navigate: (url:
 * Just use `<Link href="/about">About</Link>` inside a router-provided tree.
 */
 declare function Link({ href, children, activeClass, class: classProp, className }: LinkProps): HTMLAnchorElement;
+interface ReactiveSearchParams<T = Record<string, unknown>> {
+	/** Batch-navigate with explicit push/replace option. Merges partial with current params. */
+	navigate(partial: Partial<T>, options?: {
+		push?: boolean;
+	}): void;
+	[key: string]: unknown;
+}
 type NavigateSearchValue = string | number | boolean | null | undefined;
 type NavigateSearch = string | URLSearchParams | Record<string, NavigateSearchValue | readonly NavigateSearchValue[]>;
 /** Options for router.navigate(). */
@@ -1600,6 +1621,8 @@ interface Router<T extends Record<string, RouteConfigLike> = RouteDefinitionMap>
 	loaderError: Signal<Error | null>;
 	/** Parsed search params from the current route (reactive signal). */
 	searchParams: Signal<Record<string, unknown>>;
+	/** @internal Reactive search params proxy — accessed via useSearchParams(). */
+	_reactiveSearchParams: ReactiveSearchParams;
 	/** Navigate to a route pattern, interpolating params and search into the final URL. */
 	navigate<TPath extends RoutePattern<T>>(input: NavigateInput<TPath>): Promise<void>;
 	/** Re-run all loaders for the current route. */
@@ -1688,13 +1711,27 @@ declare function RouterView({ router, fallback, errorFallback }: RouterViewProps
 */
 declare function parseSearchParams<T = Record<string, string>>(urlParams: URLSearchParams, schema?: SearchParamSchema<T>): T;
 /**
-* Read the current search params from a reactive signal.
-* Intended to be called inside a reactive context (effect/computed).
+* Read the current search params as a reactive, writable proxy.
 *
-* @param searchSignal - Signal holding the current parsed search params
-* @returns The current search params value
+* Overload 1: `useSearchParams<'/search'>()` — infers search param types from
+* the route's `searchParams` schema via `ExtractSearchParams`. Requires codegen
+* augmentation or explicit `TMap` generic for full type inference.
+*
+* Overload 2: `useSearchParams<{ q: string; page: number }>()` — explicit type.
+*
+* Overload 3: `useSearchParams()` — no generic, returns `Record<string, string>`.
+*
+* Reads are reactive (trigger signal tracking), writes batch-navigate
+* to update the URL. Must be called within a `RouterContext.Provider`.
+*/
+declare function useSearchParams<
+	TPath extends string = string,
+	TMap extends Record<string, RouteConfigLike> = RouteDefinitionMap
+>(): ReactiveSearchParams<ExtractSearchParams<TPath, TMap>>;
+/**
+* Read the current search params with an explicit type assertion.
 */
-declare function useSearchParams<T>(searchSignal: ReadonlySignal<T>): T;
+declare function useSearchParams<T extends Record<string, unknown>>(): ReactiveSearchParams<T>;
 /**
 * Error thrown when `onCleanup()` is called outside a disposal scope.
 * Similar to React's invalid hook call error — fail-fast so developers
@@ -2074,4 +2111,4 @@ interface RegisterThemeInput {
 * ```
 */
 declare function registerTheme(resolved: RegisterThemeInput): void;
-export { zoomOut, zoomIn, variants, validate, useSearchParams, useRouter, useParams, useDialogStack, useDialog, useContext, untrack, slideOutToTop, slideOutToRight, slideOutToLeft, slideOutToBottom, slideInFromTop, slideInFromRight, slideInFromLeft, slideInFromBottom, signal, setAdapter, s, resolveChildren, resetRelationSchemas_TEST_ONLY, resetInjectedStyles, registerTheme, registerRelationSchema, ref, query, parseSearchParams, palettes, onMount2 as onMount, onCleanup, onAnimationsComplete, mount, keyframes, isRenderNode, isQueryDescriptor, isBrowser, invalidateTenantQueries, invalidate, injectCSS, hydrateIslands, hydrate, globalCss, getRelationSchema, getQueryEnvelopeStore, getInjectedCSS, getEntityStore, getAdapter, formatRelativeTime, formDataToObject, form, font, fadeOut, fadeIn, defineTheme, defineRoutes, css, createTestStore, createRouter, createOptimisticHandler, createLink, createFieldState, createDialogStack, createDOMAdapter, createContext, configureImageOptimizer, computed, compileTheme, compileFonts, children, buildOptimizedUrl, batch, accordionUp, accordionDown, __staticText, __exitChildren, __enterChildren, __element, __append, VariantsConfig, VariantProps, VariantFunction, ValidationResult, UnwrapSignals, TypedRoutes, TypedRouter, ThemeProviderProps, ThemeProvider, ThemeInput, Theme, SuspenseProps, Suspense, StyleValue, StyleEntry, Signal, SerializedStore, SearchParamSchema, SdkMethodWithMeta, SdkMethod, RouterViewProps, RouterView, RouterOptions, RouterContext, Router, RoutePattern, RoutePaths, RouteMatch, RouteDefinitionMap, RouteConfig, RenderText, RenderNode, RenderElement, RenderAdapter, RelativeTimeProps, RelativeTime, RelationSchema, RelationFieldDef, RegisterThemeInput, Ref, ReadonlySignal, RENDER_NODE_BRAND, QueryResult, QueryOptions, QueryEnvelopeStore, QueryEnvelope, QueryDescriptor3 as QueryDescriptor, PresenceProps, Presence, PreloadItem, PathWithParams, ParamSchema, OutletContextValue, OutletContext, Outlet, NavigateOptions, NavigateInput, MountOptions, MountHandle, MergeSelectOptions, MatchedRoute, LoaderData, ListAnimationHooks, ListAnimationContext, LinkProps, LinkFactoryOptions, Link, IslandRegistry, IslandProps, Island, InferRouteMap, ImageProps, Image, GlobalCSSOutput, GlobalCSSInput, FormatRelativeTimeOptions, FormSchema, FormOptions, FormInstance, FormDataOptions, ForeignProps, Foreign, FontSrc, FontOptions, FontFallbackMetrics, FontDescriptor, FieldState, FieldSelectionTracker, FallbackFontName, ExtractParams, ErrorFallbackProps, ErrorBoundaryProps, ErrorBoundary, EntityStoreOptions, EntityStore, DisposeFn, DisposalScopeError, DialogStackProvider, DialogStackContext, DialogStack, DialogResult, DialogOpenOptions, DialogIdContext, DialogHandleContext, DialogHandle, DialogComponent, DefaultErrorFallback, DateInput, Context, ConfirmOptions, Computed, ComponentRegistry, ComponentLoader, ComponentFunction, CompiledTheme, CompiledRoute, CompiledFonts, CompileThemeOptions, CompileFontsOptions, ColorPalette, ChildrenAccessor, ChildValue, CacheStore, CSSOutput, CSSInput, ANIMATION_EASING, ANIMATION_DURATION };
+export { zoomOut, zoomIn, variants, validate, useSearchParams, useRouter, useParams, useDialogStack, useDialog, useContext, untrack, slideOutToTop, slideOutToRight, slideOutToLeft, slideOutToBottom, slideInFromTop, slideInFromRight, slideInFromLeft, slideInFromBottom, signal, setAdapter, s, resolveChildren, resetRelationSchemas_TEST_ONLY, resetInjectedStyles, registerTheme, registerRelationSchema, ref, query, parseSearchParams, palettes, onMount2 as onMount, onCleanup, onAnimationsComplete, mount, keyframes, isRenderNode, isQueryDescriptor, isBrowser, invalidateTenantQueries, invalidate, injectCSS, hydrateIslands, hydrate, globalCss, getRelationSchema, getQueryEnvelopeStore, getInjectedCSS, getEntityStore, getAdapter, formatRelativeTime, formDataToObject, form, font, fadeOut, fadeIn, defineTheme, defineRoutes, css, createTestStore, createRouter, createOptimisticHandler, createLink, createFieldState, createDialogStack, createDOMAdapter, createContext, configureImageOptimizer, computed, compileTheme, compileFonts, children, buildOptimizedUrl, batch, accordionUp, accordionDown, __staticText, __exitChildren, __enterChildren, __element, __append, VariantsConfig, VariantProps, VariantFunction, ValidationResult, UnwrapSignals, TypedRoutes, TypedRouter, ThemeProviderProps, ThemeProvider, ThemeInput, Theme, SuspenseProps, Suspense, StyleValue, StyleEntry, Signal, SerializedStore, SearchParamSchema, SdkMethodWithMeta, SdkMethod, RouterViewProps, RouterView, RouterOptions, RouterContext, Router, RoutePattern, RoutePaths, RouteMatch, RouteDefinitionMap, RouteConfig, RenderText, RenderNode, RenderElement, RenderAdapter, RelativeTimeProps, RelativeTime, RelationSchema, RelationFieldDef, RegisterThemeInput, Ref, ReadonlySignal, ReactiveSearchParams, RENDER_NODE_BRAND, QueryResult, QueryOptions, QueryEnvelopeStore, QueryEnvelope, QueryDescriptor3 as QueryDescriptor, PresenceProps, Presence, PreloadItem, PathWithParams, ParamSchema, OutletContextValue, OutletContext, Outlet, NavigateOptions, NavigateInput, MountOptions, MountHandle, MergeSelectOptions, MatchedRoute, LoaderData, ListAnimationHooks, ListAnimationContext, LinkProps, LinkFactoryOptions, Link, IslandRegistry, IslandProps, Island, InferRouteMap, ImageProps, Image, GlobalCSSOutput, GlobalCSSInput, FormatRelativeTimeOptions, FormSchema, FormOptions, FormInstance, FormDataOptions, ForeignProps, Foreign, FontSrc, FontOptions, FontFallbackMetrics, FontDescriptor, FieldState, FieldSelectionTracker, FallbackFontName, ExtractSearchParams, ExtractParams, ErrorFallbackProps, ErrorBoundaryProps, ErrorBoundary, EntityStoreOptions, EntityStore, DisposeFn, DisposalScopeError, DialogStackProvider, DialogStackContext, DialogStack, DialogResult, DialogOpenOptions, DialogIdContext, DialogHandleContext, DialogHandle, DialogComponent, DefaultErrorFallback, DateInput, Context, ConfirmOptions, Computed, ComponentRegistry, ComponentLoader, ComponentFunction, CompiledTheme, CompiledRoute, CompiledFonts, CompileThemeOptions, CompileFontsOptions, ColorPalette, ChildrenAccessor, ChildValue, CacheStore, CSSOutput, CSSInput, ANIMATION_EASING, ANIMATION_DURATION };

package/dist/src/index.js

@@ -25,7 +25,7 @@ import {
   slideOutToTop,
   zoomIn,
   zoomOut
-} from "../shared/chunk-ymc3wwam.js";
+} from "../shared/chunk-n824qrvk.js";
 import {
   ErrorBoundary,
   Link,
@@ -36,25 +36,25 @@ import {
   getCurrentErrorHandler,
   parseSearchParams,
   useSearchParams
-} from "../shared/chunk-2krx4aqe.js";
+} from "../shared/chunk-5xm1w16j.js";
 import {
   beginDeferringMounts,
   discardDeferredMounts,
   flushDeferredMounts,
   onMount
-} from "../shared/chunk-svvqjmyy.js";
+} from "../shared/chunk-mntc8w0g.js";
 import {
   createRouter
-} from "../shared/chunk-e09mdqcx.js";
+} from "../shared/chunk-mm9ms792.js";
 import {
   defineRoutes
-} from "../shared/chunk-am9zaw4h.js";
+} from "../shared/chunk-ah86rm07.js";
 import {
   createFieldState,
   form,
   formDataToObject,
   validate
-} from "../shared/chunk-h2sjma78.js";
+} from "../shared/chunk-hcgnfw27.js";
 import {
   EntityStore,
   FieldSelectionTracker,
@@ -66,7 +66,7 @@ import {
   query,
   registerRelationSchema,
   resetRelationSchemas_TEST_ONLY
-} from "../shared/chunk-1jgws7rs.js";
+} from "../shared/chunk-5vcnmqck.js";
 import"../shared/chunk-jrtrk5z4.js";
 import {
   ThemeProvider,
@@ -83,7 +83,7 @@ import {
   resolveChildren,
   s,
   variants
-} from "../shared/chunk-j1a7t906.js";
+} from "../shared/chunk-pwmjtxpn.js";
 import {
   RENDER_NODE_BRAND,
   __append,
@@ -96,20 +96,20 @@ import {
   getAdapter,
   isRenderNode,
   setAdapter
-} from "../shared/chunk-djvarb8r.js";
+} from "../shared/chunk-1j59xzqm.js";
 import"../shared/chunk-h1fsr8kv.js";
 import {
   RouterContext,
   useParams,
   useRouter
-} from "../shared/chunk-7nr2ebrf.js";
+} from "../shared/chunk-9p84cvet.js";
 import {
   invalidate,
   invalidateTenantQueries
-} from "../shared/chunk-09ntccdx.js";
+} from "../shared/chunk-pv0apt9z.js";
 import {
   isBrowser
-} from "../shared/chunk-xs5s8gqe.js";
+} from "../shared/chunk-sjypbv24.js";
 import {
   DisposalScopeError,
   _tryOnCleanup,
@@ -134,7 +134,7 @@ import {
   startHydration,
   untrack,
   useContext
-} from "../shared/chunk-ppr06jgn.js";
+} from "../shared/chunk-1yd6jfw5.js";
 // src/component/default-error-fallback.ts
 function DefaultErrorFallback({ error, retry }) {
   const container = document.createElement("div");

package/dist/src/internals.js

@@ -3,24 +3,24 @@ import {
   deserializeProps,
   onAnimationsComplete,
   resolveComponent
-} from "../shared/chunk-ymc3wwam.js";
+} from "../shared/chunk-n824qrvk.js";
 import {
   __discardMountFrame,
   __flushMountFrame,
   __on,
   __pushMountFrame
-} from "../shared/chunk-svvqjmyy.js";
+} from "../shared/chunk-mntc8w0g.js";
 import {
   executeLoaders,
   matchPath,
   matchRoute
-} from "../shared/chunk-am9zaw4h.js";
+} from "../shared/chunk-ah86rm07.js";
 import {
   EntityStore,
   MemoryCache,
   QueryEnvelopeStore,
   deriveKey
-} from "../shared/chunk-1jgws7rs.js";
+} from "../shared/chunk-5vcnmqck.js";
 import"../shared/chunk-jrtrk5z4.js";
 import {
   ALIGNMENT_MAP,
@@ -41,7 +41,7 @@ import {
   SIZE_KEYWORDS,
   SPACING_SCALE,
   compileTheme
-} from "../shared/chunk-j1a7t906.js";
+} from "../shared/chunk-pwmjtxpn.js";
 import {
   RENDER_NODE_BRAND,
   __append,
@@ -60,16 +60,16 @@ import {
   getAdapter,
   isRenderNode,
   setAdapter
-} from "../shared/chunk-djvarb8r.js";
+} from "../shared/chunk-1j59xzqm.js";
 import {
   SVG_NS,
   normalizeSVGAttr,
   styleObjectToString
 } from "../shared/chunk-h1fsr8kv.js";
-import"../shared/chunk-09ntccdx.js";
+import"../shared/chunk-pv0apt9z.js";
 import {
   isBrowser
-} from "../shared/chunk-xs5s8gqe.js";
+} from "../shared/chunk-sjypbv24.js";
 import {
   _tryOnCleanup,
   claimComment,
@@ -90,7 +90,7 @@ import {
   startSignalCollection,
   stopSignalCollection,
   useContext
-} from "../shared/chunk-ppr06jgn.js";
+} from "../shared/chunk-1yd6jfw5.js";
 // src/dom/conditional.ts
 function clearBetween(start, end) {
   let current = start.nextSibling;

package/dist/src/query/public.js

@@ -1,10 +1,10 @@
 import {
   query
-} from "../../shared/chunk-1jgws7rs.js";
+} from "../../shared/chunk-5vcnmqck.js";
 import"../../shared/chunk-jrtrk5z4.js";
-import"../../shared/chunk-09ntccdx.js";
-import"../../shared/chunk-xs5s8gqe.js";
-import"../../shared/chunk-ppr06jgn.js";
+import"../../shared/chunk-pv0apt9z.js";
+import"../../shared/chunk-sjypbv24.js";
+import"../../shared/chunk-1yd6jfw5.js";
 
 // src/query/public.ts
 import { isQueryDescriptor } from "@vertz/fetch";

package/dist/src/router/public.d.ts

@@ -161,6 +161,20 @@ type TypedRoutes<T extends Record<string, RouteConfigLike> = RouteDefinitionMap>
 * Usage: `useRouter<InferRouteMap<typeof routes>>()`
 */
 type InferRouteMap<T> = T extends TypedRoutes<infer R> ? R : T;
+/**
+* Extract the search params type from a route definition map for a given path.
+*
+* If the route at `TPath` has a `searchParams` schema, resolves to the schema's
+* output type `T`. Otherwise resolves to `Record<string, string>` (raw URL params).
+*
+* Parallel to `ExtractParams<TPath>` which extracts path params from the URL pattern.
+*/
+type ExtractSearchParams<
+	TPath extends string,
+	TMap extends Record<string, RouteConfigLike> = RouteDefinitionMap
+> = TPath extends keyof TMap ? TMap[TPath] extends {
+	searchParams: SearchParamSchema<infer T>;
+} ? T : Record<string, string> : Record<string, string>;
 /** Internal compiled route. */
 interface CompiledRoute {
 	/** The original path pattern. */
@@ -307,6 +321,13 @@ declare function createLink(currentPath: ReadonlySignal<string>, navigate: (url:
 * Just use `<Link href="/about">About</Link>` inside a router-provided tree.
 */
 declare function Link({ href, children, activeClass, class: classProp, className }: LinkProps): HTMLAnchorElement;
+interface ReactiveSearchParams<T = Record<string, unknown>> {
+	/** Batch-navigate with explicit push/replace option. Merges partial with current params. */
+	navigate(partial: Partial<T>, options?: {
+		push?: boolean;
+	}): void;
+	[key: string]: unknown;
+}
 type NavigateSearchValue = string | number | boolean | null | undefined;
 type NavigateSearch = string | URLSearchParams | Record<string, NavigateSearchValue | readonly NavigateSearchValue[]>;
 /** Options for router.navigate(). */
@@ -381,6 +402,8 @@ interface Router<T extends Record<string, RouteConfigLike> = RouteDefinitionMap>
 	loaderError: Signal<Error | null>;
 	/** Parsed search params from the current route (reactive signal). */
 	searchParams: Signal<Record<string, unknown>>;
+	/** @internal Reactive search params proxy — accessed via useSearchParams(). */
+	_reactiveSearchParams: ReactiveSearchParams;
 	/** Navigate to a route pattern, interpolating params and search into the final URL. */
 	navigate<TPath extends RoutePattern<T>>(input: NavigateInput<TPath>): Promise<void>;
 	/** Re-run all loaders for the current route. */
@@ -497,11 +520,25 @@ declare function RouterView({ router, fallback, errorFallback }: RouterViewProps
 */
 declare function parseSearchParams<T = Record<string, string>>(urlParams: URLSearchParams, schema?: SearchParamSchema<T>): T;
 /**
-* Read the current search params from a reactive signal.
-* Intended to be called inside a reactive context (effect/computed).
+* Read the current search params as a reactive, writable proxy.
+*
+* Overload 1: `useSearchParams<'/search'>()` — infers search param types from
+* the route's `searchParams` schema via `ExtractSearchParams`. Requires codegen
+* augmentation or explicit `TMap` generic for full type inference.
 *
-* @param searchSignal - Signal holding the current parsed search params
-* @returns The current search params value
+* Overload 2: `useSearchParams<{ q: string; page: number }>()` — explicit type.
+*
+* Overload 3: `useSearchParams()` — no generic, returns `Record<string, string>`.
+*
+* Reads are reactive (trigger signal tracking), writes batch-navigate
+* to update the URL. Must be called within a `RouterContext.Provider`.
+*/
+declare function useSearchParams<
+	TPath extends string = string,
+	TMap extends Record<string, RouteConfigLike> = RouteDefinitionMap
+>(): ReactiveSearchParams<ExtractSearchParams<TPath, TMap>>;
+/**
+* Read the current search params with an explicit type assertion.
 */
-declare function useSearchParams<T>(searchSignal: ReadonlySignal<T>): T;
-export { useSearchParams, useRouter, useParams, parseSearchParams, defineRoutes, createRouter, createLink, TypedRoutes, TypedRouter, SearchParamSchema, RouterViewProps, RouterView, RouterContext, Router, RoutePattern, RoutePaths, RouteMatch, RouteDefinitionMap, RouteConfig, PathWithParams, ParamSchema, OutletContextValue, OutletContext, Outlet, NavigateOptions, NavigateInput, MatchedRoute, LoaderData, LinkProps, Link, InferRouteMap, ExtractParams, CompiledRoute };
+declare function useSearchParams<T extends Record<string, unknown>>(): ReactiveSearchParams<T>;
+export { useSearchParams, useRouter, useParams, parseSearchParams, defineRoutes, createRouter, createLink, TypedRoutes, TypedRouter, SearchParamSchema, RouterViewProps, RouterView, RouterContext, Router, RoutePattern, RoutePaths, RouteMatch, RouteDefinitionMap, RouteConfig, ReactiveSearchParams, PathWithParams, ParamSchema, OutletContextValue, OutletContext, Outlet, NavigateOptions, NavigateInput, MatchedRoute, LoaderData, LinkProps, Link, InferRouteMap, ExtractSearchParams, ExtractParams, CompiledRoute };

package/dist/src/router/public.js

@@ -6,24 +6,24 @@ import {
   createLink,
   parseSearchParams,
   useSearchParams
-} from "../../shared/chunk-2krx4aqe.js";
-import"../../shared/chunk-svvqjmyy.js";
+} from "../../shared/chunk-5xm1w16j.js";
+import"../../shared/chunk-mntc8w0g.js";
 import {
   createRouter
-} from "../../shared/chunk-e09mdqcx.js";
+} from "../../shared/chunk-mm9ms792.js";
 import {
   defineRoutes
-} from "../../shared/chunk-am9zaw4h.js";
+} from "../../shared/chunk-ah86rm07.js";
 import"../../shared/chunk-jrtrk5z4.js";
-import"../../shared/chunk-djvarb8r.js";
+import"../../shared/chunk-1j59xzqm.js";
 import"../../shared/chunk-h1fsr8kv.js";
 import {
   RouterContext,
   useParams,
   useRouter
-} from "../../shared/chunk-7nr2ebrf.js";
-import"../../shared/chunk-xs5s8gqe.js";
-import"../../shared/chunk-ppr06jgn.js";
+} from "../../shared/chunk-9p84cvet.js";
+import"../../shared/chunk-sjypbv24.js";
+import"../../shared/chunk-1yd6jfw5.js";
 export {
   useSearchParams,
   useRouter,

package/dist/src/test/index.d.ts

@@ -298,6 +298,13 @@ interface Signal<T> {
 	/** Manually notify all subscribers (useful after mutating the value in place). */
 	notify(): void;
 }
+interface ReactiveSearchParams<T = Record<string, unknown>> {
+	/** Batch-navigate with explicit push/replace option. Merges partial with current params. */
+	navigate(partial: Partial<T>, options?: {
+		push?: boolean;
+	}): void;
+	[key: string]: unknown;
+}
 type NavigateSearchValue = string | number | boolean | null | undefined;
 type NavigateSearch = string | URLSearchParams | Record<string, NavigateSearchValue | readonly NavigateSearchValue[]>;
 /** Options for router.navigate(). */
@@ -345,6 +352,8 @@ interface Router<T extends Record<string, RouteConfigLike> = RouteDefinitionMap>
 	loaderError: Signal<Error | null>;
 	/** Parsed search params from the current route (reactive signal). */
 	searchParams: Signal<Record<string, unknown>>;
+	/** @internal Reactive search params proxy — accessed via useSearchParams(). */
+	_reactiveSearchParams: ReactiveSearchParams;
 	/** Navigate to a route pattern, interpolating params and search into the final URL. */
 	navigate<TPath extends RoutePattern<T>>(input: NavigateInput<TPath>): Promise<void>;
 	/** Re-run all loaders for the current route. */

package/dist/src/test/index.js

@@ -1,12 +1,12 @@
 import {
   createRouter
-} from "../../shared/chunk-e09mdqcx.js";
+} from "../../shared/chunk-mm9ms792.js";
 import {
   defineRoutes
-} from "../../shared/chunk-am9zaw4h.js";
+} from "../../shared/chunk-ah86rm07.js";
 import"../../shared/chunk-jrtrk5z4.js";
-import"../../shared/chunk-xs5s8gqe.js";
-import"../../shared/chunk-ppr06jgn.js";
+import"../../shared/chunk-sjypbv24.js";
+import"../../shared/chunk-1yd6jfw5.js";
 
 // src/test/interactions.ts
 async function click(el) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertz/ui",
-  "version": "0.2.28",
+  "version": "0.2.30",
   "type": "module",
   "license": "MIT",
   "description": "Vertz UI framework — signals, components, JSX runtime",
@@ -74,11 +74,11 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@vertz/fetch": "^0.2.25"
+    "@vertz/fetch": "^0.2.29"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.7.0",
-    "@vertz/schema": "^0.2.25",
+    "@vertz/schema": "^0.2.29",
     "bunup": "^0.16.31",
     "happy-dom": "^20.7.0",
     "typescript": "^5.7.0"

package/reactivity.json

@@ -50,6 +50,12 @@
       "reactivity": {
         "type": "reactive-source"
       }
+    },
+    "useSearchParams": {
+      "kind": "function",
+      "reactivity": {
+        "type": "reactive-source"
+      }
     }
   },
   "filePath": "@vertz/ui",