@vertz/ui 0.2.35 → 0.2.37

package/dist/shared/{chunk-25nwt5fm.js → chunk-4eatzp0p.js}

@@ -86,6 +86,13 @@ class MemoryCache {
     this._refs.set(key, count);
     this._orphans.delete(key);
   }
+  findByPrefix(prefix) {
+    for (const [k, v] of this._store) {
+      if (k.startsWith(prefix))
+        return { key: k, value: v };
+    }
+    return;
+  }
   release(key) {
     const current = this._refs.get(key);
     if (current === undefined)
@@ -864,6 +871,13 @@ function query(source, options = {}) {
   function getCacheKey() {
     return cacheKeyComputed.value;
   }
+  function resolveCurrentCacheKey() {
+    if (currentEffectKey) {
+      const depHash = depHashSignal.peek();
+      return depHash ? `${currentEffectKey}:${depHash}` : currentEffectKey;
+    }
+    return getCacheKey();
+  }
   let currentRetainedKey = null;
   const retainable = "retain" in cache && "release" in cache;
   function retainKey(key) {
@@ -904,6 +918,7 @@ function query(source, options = {}) {
   const error = signal(undefined);
   const idle = signal(initialData === undefined);
   const entityBacked = signal(false);
+  let currentEffectKey;
   function normalizeToEntityStore(result) {
     if (!entityMeta)
       return;
@@ -1020,6 +1035,7 @@ function query(source, options = {}) {
   if (!isSSR() && initialData === undefined) {
     let hydrationKey;
     const hasSSRData = !!globalThis.__VERTZ_SSR_DATA__;
+    let initDescriptorKey;
     if (customKey) {
       hydrationKey = customKey;
     } else if (hasSSRData) {
@@ -1027,6 +1043,7 @@ function query(source, options = {}) {
         const raw = callThunkWithCapture();
         if (raw !== null) {
           if (isQueryDescriptor(raw)) {
+            initDescriptorKey = raw._key;
             if (raw._entity && !entityMeta) {
               entityMeta = raw._entity;
             }
@@ -1058,6 +1075,25 @@ function query(source, options = {}) {
           loading.value = false;
           ssrHydrated = true;
         }
+      } else {
+        const cached = cache.get(hydrationKey);
+        if (cached !== undefined) {
+          retainKey(hydrationKey);
+          normalizeToEntityStore(cached);
+          rawData.value = cached;
+          loading.value = false;
+          ssrHydrated = true;
+        } else if (initDescriptorKey && "findByPrefix" in cache) {
+          const mc = cache;
+          const found = mc.findByPrefix(initDescriptorKey + "&") ?? mc.findByPrefix(initDescriptorKey + ":");
+          if (found) {
+            retainKey(found.key);
+            normalizeToEntityStore(found.value);
+            rawData.value = found.value;
+            loading.value = false;
+            ssrHydrated = true;
+          }
+        }
       }
     }
     if (!ssrHydrated && ssrHydrationCleanup !== null && isNavPrefetchActive()) {
@@ -1161,7 +1197,7 @@ function query(source, options = {}) {
     handleFetchPromise(fetchPromise, id, key);
   }
   function refetch() {
-    const key = getCacheKey();
+    const key = resolveCurrentCacheKey();
     currentRetainedKey = null;
     cache.delete(key);
     getInflight().delete(key);
@@ -1205,10 +1241,12 @@ function query(source, options = {}) {
           isFirst = false;
           return;
         }
-        if (!isQueryDescriptor(trackRaw)) {
+        const descriptorKey = isQueryDescriptor(trackRaw) ? trackRaw._key : undefined;
+        if (!descriptorKey) {
           trackRaw.catch(() => {});
         }
-        const derivedKey = untrack(() => getCacheKey());
+        const depHash2 = untrack(() => depHashSignal.value);
+        const derivedKey = descriptorKey ? depHash2 ? `${descriptorKey}:${depHash2}` : descriptorKey : untrack(() => getCacheKey());
         const cached = untrack(() => cache.get(derivedKey));
         if (cached !== undefined) {
           retainKey(derivedKey);
@@ -1219,6 +1257,20 @@ function query(source, options = {}) {
           isFirst = false;
           return;
         }
+        if (descriptorKey && "findByPrefix" in cache) {
+          const mc = cache;
+          const found = untrack(() => mc.findByPrefix(descriptorKey + "&") ?? mc.findByPrefix(descriptorKey + ":"));
+          if (found) {
+            retainKey(found.key);
+            untrack(() => {
+              normalizeToEntityStore(found.value);
+              rawData.value = found.value;
+              loading.value = false;
+            });
+            isFirst = false;
+            return;
+          }
+        }
       }
       isFirst = false;
       return;
@@ -1274,7 +1326,9 @@ function query(source, options = {}) {
     untrack(() => {
       idle.value = false;
     });
-    const key = effectKey ?? untrack(() => getCacheKey());
+    const depHash = untrack(() => depHashSignal.value);
+    currentEffectKey = effectKey;
+    const key = effectKey ? depHash ? `${effectKey}:${depHash}` : effectKey : untrack(() => getCacheKey());
     if (!customKey && !effectKey) {
       const existing = untrack(() => getInflight().get(key));
       if (existing) {
@@ -1360,7 +1414,7 @@ function query(source, options = {}) {
         rawData.value = undefined;
         loading.value = true;
       });
-      const cacheKey = untrack(() => getCacheKey());
+      const cacheKey = untrack(() => resolveCurrentCacheKey());
       cache.delete(cacheKey);
       const queryKey = customKey ?? meta.entityType;
       getEntityStore().queryIndices.clear(queryKey);

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

@@ -9,6 +9,7 @@ import {
   isBrowser
 } from "./chunk-sjypbv24.js";
 import {
+  batch,
   getSSRContext,
   signal
 } from "./chunk-1yd6jfw5.js";
@@ -458,7 +459,7 @@ function createRouter(routes, initialUrlOrOptions, maybeOptions) {
       }
     }
   }
-  async function applyNavigation(url2, preMatch, transitionConfig) {
+  async function applyNavigation(url2, preMatch, transitionConfig, skipLoaders) {
     if (currentAbort) {
       currentAbort.abort();
     }
@@ -466,29 +467,38 @@ function createRouter(routes, initialUrlOrOptions, maybeOptions) {
     const abort = new AbortController;
     currentAbort = abort;
     const match = preMatch !== undefined ? preMatch : matchRoute(routes, url2);
+    if (match) {
+      visitedUrls.add(normalizeUrl(url2));
+    }
     if (transitionConfig) {
       await withViewTransition(() => {
-        current.value = match;
+        batch(() => {
+          searchParams.value = match?.search ?? {};
+          current.value = match;
+        });
       }, transitionConfig);
     } else {
-      current.value = match;
+      batch(() => {
+        searchParams.value = match?.search ?? {};
+        current.value = match;
+      });
     }
     if (match) {
-      visitedUrls.add(normalizeUrl(url2));
-      searchParams.value = match.search;
-      await runLoaders(match, gen, abort.signal);
-    } else {
-      searchParams.value = {};
-      if (gen === navigationGen) {
-        loaderData.value = [];
-        loaderError.value = null;
+      if (!skipLoaders) {
+        await runLoaders(match, gen, abort.signal);
       }
+    } else if (gen === navigationGen) {
+      loaderData.value = [];
+      loaderError.value = null;
     }
   }
   async function navigate(input) {
     const navUrl = buildNavigationUrl(input.to, input);
+    const navMatch = matchRoute(routes, navUrl);
+    const navPathname = navUrl.split("?")[0]?.split("#")[0] || "/";
+    const isSearchParamOnly = window.location.pathname === navPathname;
     const gen = ++navigateGen;
-    const handle = startPrefetch(navUrl);
+    const handle = isSearchParamOnly ? null : startPrefetch(navUrl);
     if (input.replace) {
       window.history.replaceState(null, "", navUrl);
     } else {
@@ -500,9 +510,8 @@ function createRouter(routes, initialUrlOrOptions, maybeOptions) {
     }
     if (gen !== navigateGen)
       return;
-    const match = matchRoute(routes, navUrl);
-    const transitionConfig = input.viewTransition ?? match?.route.viewTransition ?? options?.viewTransition;
-    await applyNavigation(navUrl, match, transitionConfig);
+    const transitionConfig = isSearchParamOnly ? undefined : input.viewTransition ?? navMatch?.route.viewTransition ?? options?.viewTransition;
+    await applyNavigation(navUrl, navMatch, transitionConfig, isSearchParamOnly);
   }
   async function revalidate() {
     const match = current.value;

package/dist/shared/{chunk-zkh9sysw.js → chunk-g60cswzm.js}

@@ -680,12 +680,15 @@ var vertzSheets = new Set;
 function injectCSS(cssText) {
   if (!cssText)
     return;
-  const isSSR = getSSRContext() !== undefined;
+  const ssrCtx = getSSRContext();
+  const isSSR = ssrCtx !== undefined;
   if (!isSSR && injectedCSS.has(cssText))
     return;
   injectedCSS.add(cssText);
-  if (isSSR)
+  if (isSSR) {
+    ssrCtx.cssTracker?.add(cssText);
     return;
+  }
   if (typeof document === "undefined")
     return;
   if (typeof CSSStyleSheet !== "undefined" && document.adoptedStyleSheets !== undefined) {
@@ -1135,56 +1138,52 @@ function variants(config) {
   const { base, variants: variantDefs, defaultVariants, compoundVariants } = config;
   const filePath = deriveConfigKey(config);
   const baseResult = css({ base }, filePath);
-  const variantResults = {};
+  const variantCache = new Map;
+  const variantStyles = {};
   for (const [variantName, options] of Object.entries(variantDefs)) {
-    variantResults[variantName] = {};
+    variantStyles[variantName] = {};
     for (const [optionName, styles] of Object.entries(options)) {
       if (styles.length > 0) {
-        const blockName = `${variantName}_${optionName}`;
-        const result = css({ [blockName]: styles }, filePath);
-        const className = result[blockName];
-        if (className) {
-          variantResults[variantName][optionName] = {
-            className,
-            css: result.css
-          };
-        }
+        variantStyles[variantName][optionName] = styles;
       }
     }
   }
-  const compoundResults = [];
-  if (compoundVariants) {
-    for (let i = 0;i < compoundVariants.length; i++) {
-      const compound = compoundVariants[i];
-      if (!compound)
-        continue;
-      const { styles, ...conditions } = compound;
-      if (styles.length > 0) {
-        const blockName = `compound_${i}`;
-        const result = css({ [blockName]: styles }, filePath);
-        const className = result[blockName];
-        if (className) {
-          compoundResults.push({
-            conditions,
-            className,
-            css: result.css
-          });
-        }
-      }
+  const compoundCache = new Map;
+  function ensureVariantOption(variantName, optionName) {
+    const cacheKey = `${variantName}::${optionName}`;
+    const cached = variantCache.get(cacheKey);
+    if (cached)
+      return cached.className;
+    const styles = variantStyles[variantName]?.[optionName];
+    if (!styles)
+      return;
+    const blockName = cacheKey;
+    const result = css({ [blockName]: styles }, filePath);
+    const className = result[blockName];
+    if (className) {
+      variantCache.set(cacheKey, { className, css: result.css });
+      return className;
     }
+    return;
   }
-  const allCss = [];
-  if (baseResult.css)
-    allCss.push(baseResult.css);
-  for (const options of Object.values(variantResults)) {
-    for (const result of Object.values(options)) {
-      if (result.css)
-        allCss.push(result.css);
+  function ensureCompoundVariant(index, compound, resolved) {
+    const { styles, ...conditions } = compound;
+    const matches = Object.entries(conditions).every(([key, value]) => resolved[key] === String(value));
+    if (!matches)
+      return;
+    const cached = compoundCache.get(index);
+    if (cached)
+      return cached.className;
+    if (styles.length === 0)
+      return;
+    const blockName = `compound_${index}`;
+    const result = css({ [blockName]: styles }, filePath);
+    const className = result[blockName];
+    if (className) {
+      compoundCache.set(index, { className, css: result.css });
+      return className;
     }
-  }
-  for (const result of compoundResults) {
-    if (result.css)
-      allCss.push(result.css);
+    return;
   }
   const fn = (props) => {
     const classNames = [];
@@ -1208,26 +1207,43 @@ function variants(config) {
       }
     }
     for (const [variantName, optionName] of Object.entries(resolved)) {
-      const variantGroup = variantResults[variantName];
-      if (variantGroup) {
-        const result = variantGroup[optionName];
-        if (result) {
-          classNames.push(result.className);
-        }
+      const className = ensureVariantOption(variantName, optionName);
+      if (className) {
+        classNames.push(className);
       }
     }
-    for (const compound of compoundResults) {
-      const matches = Object.entries(compound.conditions).every(([key, value]) => {
-        return resolved[key] === String(value);
-      });
-      if (matches) {
-        classNames.push(compound.className);
+    if (compoundVariants) {
+      for (let i = 0;i < compoundVariants.length; i++) {
+        const compound = compoundVariants[i];
+        if (!compound)
+          continue;
+        const className = ensureCompoundVariant(i, compound, resolved);
+        if (className) {
+          classNames.push(className);
+        }
       }
     }
     return classNames.join(" ");
   };
-  fn.css = allCss.join(`
+  Object.defineProperty(fn, "css", {
+    get() {
+      const parts = [];
+      if (baseResult.css)
+        parts.push(baseResult.css);
+      for (const entry of variantCache.values()) {
+        if (entry.css)
+          parts.push(entry.css);
+      }
+      for (const entry of compoundCache.values()) {
+        if (entry.css)
+          parts.push(entry.css);
+      }
+      return parts.join(`
 `);
+    },
+    enumerable: false,
+    configurable: false
+  });
   return fn;
 }
 

package/dist/shared/{chunk-xyg724n1.js → chunk-rxx916ae.js}

@@ -1,6 +1,6 @@
 import {
   injectCSS
-} from "./chunk-zkh9sysw.js";
+} from "./chunk-g60cswzm.js";
 import {
   createContext
 } from "./chunk-1yd6jfw5.js";

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

@@ -287,12 +287,16 @@ interface VariantsConfig<V extends VariantDefinitions> {
 /** The function returned by variants(). Takes optional variant props and returns a className string. */
 interface VariantFunction<V extends VariantDefinitions> {
 	(props?: VariantProps<V>): string;
-	/** The extracted CSS for all variant combinations. */
+	/** @internal The extracted CSS for variant combinations compiled so far. */
 	css: string;
 }
 /**
 * Create a typed variant function from a config object.
 *
+* Variant option CSS is compiled lazily on first use — only the base styles
+* are compiled eagerly. This ensures unused variant options never produce CSS,
+* reducing SSR response size for pages that use a subset of available variants.
+*
 * @param config - Variant configuration (base, variants, defaultVariants, compoundVariants).
 * @returns A function that accepts variant props and returns a className string.
 */

package/dist/src/css/public.js

@@ -8,7 +8,7 @@ import {
   globalCss,
   s,
   variants
-} from "../../shared/chunk-zkh9sysw.js";
+} from "../../shared/chunk-g60cswzm.js";
 import"../../shared/chunk-dh32wkrv.js";
 import"../../shared/chunk-h1fsr8kv.js";
 import"../../shared/chunk-1yd6jfw5.js";

package/dist/src/index.d.ts

@@ -632,12 +632,16 @@ interface VariantsConfig<V extends VariantDefinitions> {
 /** The function returned by variants(). Takes optional variant props and returns a className string. */
 interface VariantFunction<V extends VariantDefinitions> {
 	(props?: VariantProps<V>): string;
-	/** The extracted CSS for all variant combinations. */
+	/** @internal The extracted CSS for variant combinations compiled so far. */
 	css: string;
 }
 /**
 * Create a typed variant function from a config object.
 *
+* Variant option CSS is compiled lazily on first use — only the base styles
+* are compiled eagerly. This ensures unused variant options never produce CSS,
+* reducing SSR response size for pages that use a subset of available variants.
+*
 * @param config - Variant configuration (base, variants, defaultVariants, compoundVariants).
 * @returns A function that accepts variant props and returns a className string.
 */
@@ -1296,8 +1300,27 @@ type ExtractParams<T extends string> = [ExtractParamsFromSegments<WithoutWildcar
 * - Fallback: `string` → `string` (backward compat)
 */
 type PathWithParams<T extends string> = T extends `${infer Before}*` ? `${PathWithParams<Before>}${string}` : T extends `${infer Before}:${string}/${infer After}` ? `${Before}${string}/${PathWithParams<`${After}`>}` : T extends `${infer Before}:${string}` ? `${Before}${string}` : T;
-/** Union of route pattern keys from a route map. */
-type RoutePattern<TRouteMap extends Record<string, unknown>> = keyof TRouteMap & string;
+/**
+* Join parent and child route path segments.
+* - `JoinPaths<'/', '/brands'>` → `'/brands'`
+* - `JoinPaths<'/admin', '/settings'>` → `'/admin/settings'`
+* - `JoinPaths<'', '/brands'>` → `'/brands'`
+*/
+type JoinPaths<
+	Parent extends string,
+	Child extends string
+> = Parent extends "" | "/" ? Child : Child extends "/" ? Parent : `${Parent}${Child}`;
+/**
+* Union of all route pattern keys from a route map, including nested children.
+* Recursively walks `children` and concatenates parent + child paths.
+* Short-circuits to `string` for index signatures (backward compat).
+*/
+type RoutePattern<
+	TRouteMap extends Record<string, unknown>,
+	_Prefix extends string = ""
+> = string extends keyof TRouteMap ? string : { [K in keyof TRouteMap & string] : JoinPaths<_Prefix, K> | (TRouteMap[K] extends {
+	children: infer C extends Record<string, unknown>;
+} ? RoutePattern<C, JoinPaths<_Prefix, K>> : never) }[keyof TRouteMap & string];
 /**
 * Union of all valid URL shapes for a route map.
 * Maps each route pattern key through `PathWithParams` to produce the accepted URL shapes.
@@ -1424,8 +1447,22 @@ type TypedRoutes<T extends Record<string, RouteConfigLike> = RouteDefinitionMap>
 */
 type InferRouteMap<T> = T extends TypedRoutes<infer R> ? R : T;
 /**
+* Search nested children for a route's search params schema.
+* Returns the schema output type if found, `never` if not found.
+*/
+type FindSearchParamsInChildren<
+	TPath extends string,
+	TMap extends Record<string, RouteConfigLike>,
+	_Prefix extends string = ""
+> = string extends keyof TMap ? never : { [K in keyof TMap & string] : JoinPaths<_Prefix, K> extends TPath ? TMap[K] extends {
+	searchParams: SearchParamSchema<infer S>;
+} ? S : never : TMap[K] extends {
+	children: infer C extends Record<string, RouteConfigLike>;
+} ? FindSearchParamsInChildren<TPath, C, JoinPaths<_Prefix, K>> : never }[keyof TMap & string];
+/**
 * Extract the search params type from a route definition map for a given path.
 *
+* Recursively searches nested `children` when the path is not a top-level key.
 * 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).
 *
@@ -1436,7 +1473,7 @@ type ExtractSearchParams<
 	TMap extends Record<string, RouteConfigLike> = RouteDefinitionMap
 > = TPath extends keyof TMap ? TMap[TPath] extends {
 	searchParams: SearchParamSchema<infer T>;
-} ? T : Record<string, string> : Record<string, string>;
+} ? T : Record<string, string> : [FindSearchParamsInChildren<TPath, TMap>] extends [never] ? Record<string, string> : FindSearchParamsInChildren<TPath, TMap>;
 /** Internal compiled route. */
 interface CompiledRoute {
 	/** The original path pattern. */

package/dist/src/index.js

@@ -25,7 +25,7 @@ import {
   slideOutToTop,
   zoomIn,
   zoomOut
-} from "../shared/chunk-xyg724n1.js";
+} from "../shared/chunk-rxx916ae.js";
 import {
   ErrorBoundary,
   Link,
@@ -45,7 +45,7 @@ import {
 } from "../shared/chunk-mntc8w0g.js";
 import {
   createRouter
-} from "../shared/chunk-mm9ms792.js";
+} from "../shared/chunk-9ybtmy8t.js";
 import {
   defineRoutes
 } from "../shared/chunk-ah86rm07.js";
@@ -66,7 +66,7 @@ import {
   query,
   registerRelationSchema,
   resetRelationSchemas_TEST_ONLY
-} from "../shared/chunk-25nwt5fm.js";
+} from "../shared/chunk-4eatzp0p.js";
 import"../shared/chunk-jrtrk5z4.js";
 import {
   ThemeProvider,
@@ -83,7 +83,7 @@ import {
   resolveChildren,
   s,
   variants
-} from "../shared/chunk-zkh9sysw.js";
+} from "../shared/chunk-g60cswzm.js";
 import {
   RENDER_NODE_BRAND,
   __append,

package/dist/src/internals.d.ts

@@ -609,6 +609,11 @@ declare class MemoryCache<T = unknown> implements CacheStore<T> {
 	clear(): void;
 	/** Mark a cache key as actively used by a query instance. */
 	retain(key: string): void;
+	/** Find the first entry whose key starts with `prefix`. */
+	findByPrefix(prefix: string): {
+		key: string;
+		value: T;
+	} | undefined;
 	/** Release a cache key when a query instance disposes or changes key. */
 	release(key: string): void;
 }
@@ -1134,6 +1139,13 @@ interface SSRRenderContext {
 	ssrRedirect?: {
 		to: string;
 	};
+	/**
+	* Per-request CSS tracker for render-scoped collection.
+	* Populated by injectCSS() during SSR render. collectCSS() reads
+	* from this Set instead of the global injectedCSS to ensure each
+	* response only includes CSS for components actually rendered.
+	*/
+	cssTracker?: Set<string>;
 }
 /** Auth state injected into SSRRenderContext by the server. */
 type SSRAuth = ({

package/dist/src/internals.js

@@ -3,7 +3,7 @@ import {
   deserializeProps,
   onAnimationsComplete,
   resolveComponent
-} from "../shared/chunk-xyg724n1.js";
+} from "../shared/chunk-rxx916ae.js";
 import {
   __discardMountFrame,
   __flushMountFrame,
@@ -20,7 +20,7 @@ import {
   MemoryCache,
   QueryEnvelopeStore,
   deriveKey
-} from "../shared/chunk-25nwt5fm.js";
+} from "../shared/chunk-4eatzp0p.js";
 import"../shared/chunk-jrtrk5z4.js";
 import {
   ALIGNMENT_MAP,
@@ -41,7 +41,7 @@ import {
   SIZE_KEYWORDS,
   SPACING_SCALE,
   compileTheme
-} from "../shared/chunk-zkh9sysw.js";
+} from "../shared/chunk-g60cswzm.js";
 import {
   RENDER_NODE_BRAND,
   __append,

package/dist/src/query/public.js

@@ -1,6 +1,6 @@
 import {
   query
-} from "../../shared/chunk-25nwt5fm.js";
+} from "../../shared/chunk-4eatzp0p.js";
 import"../../shared/chunk-jrtrk5z4.js";
 import"../../shared/chunk-pv0apt9z.js";
 import"../../shared/chunk-sjypbv24.js";

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

@@ -34,8 +34,27 @@ type ExtractParams<T extends string> = [ExtractParamsFromSegments<WithoutWildcar
 * - Fallback: `string` → `string` (backward compat)
 */
 type PathWithParams<T extends string> = T extends `${infer Before}*` ? `${PathWithParams<Before>}${string}` : T extends `${infer Before}:${string}/${infer After}` ? `${Before}${string}/${PathWithParams<`${After}`>}` : T extends `${infer Before}:${string}` ? `${Before}${string}` : T;
-/** Union of route pattern keys from a route map. */
-type RoutePattern<TRouteMap extends Record<string, unknown>> = keyof TRouteMap & string;
+/**
+* Join parent and child route path segments.
+* - `JoinPaths<'/', '/brands'>` → `'/brands'`
+* - `JoinPaths<'/admin', '/settings'>` → `'/admin/settings'`
+* - `JoinPaths<'', '/brands'>` → `'/brands'`
+*/
+type JoinPaths<
+	Parent extends string,
+	Child extends string
+> = Parent extends "" | "/" ? Child : Child extends "/" ? Parent : `${Parent}${Child}`;
+/**
+* Union of all route pattern keys from a route map, including nested children.
+* Recursively walks `children` and concatenates parent + child paths.
+* Short-circuits to `string` for index signatures (backward compat).
+*/
+type RoutePattern<
+	TRouteMap extends Record<string, unknown>,
+	_Prefix extends string = ""
+> = string extends keyof TRouteMap ? string : { [K in keyof TRouteMap & string] : JoinPaths<_Prefix, K> | (TRouteMap[K] extends {
+	children: infer C extends Record<string, unknown>;
+} ? RoutePattern<C, JoinPaths<_Prefix, K>> : never) }[keyof TRouteMap & string];
 /**
 * Union of all valid URL shapes for a route map.
 * Maps each route pattern key through `PathWithParams` to produce the accepted URL shapes.
@@ -162,8 +181,22 @@ type TypedRoutes<T extends Record<string, RouteConfigLike> = RouteDefinitionMap>
 */
 type InferRouteMap<T> = T extends TypedRoutes<infer R> ? R : T;
 /**
+* Search nested children for a route's search params schema.
+* Returns the schema output type if found, `never` if not found.
+*/
+type FindSearchParamsInChildren<
+	TPath extends string,
+	TMap extends Record<string, RouteConfigLike>,
+	_Prefix extends string = ""
+> = string extends keyof TMap ? never : { [K in keyof TMap & string] : JoinPaths<_Prefix, K> extends TPath ? TMap[K] extends {
+	searchParams: SearchParamSchema<infer S>;
+} ? S : never : TMap[K] extends {
+	children: infer C extends Record<string, RouteConfigLike>;
+} ? FindSearchParamsInChildren<TPath, C, JoinPaths<_Prefix, K>> : never }[keyof TMap & string];
+/**
 * Extract the search params type from a route definition map for a given path.
 *
+* Recursively searches nested `children` when the path is not a top-level key.
 * 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).
 *
@@ -174,7 +207,7 @@ type ExtractSearchParams<
 	TMap extends Record<string, RouteConfigLike> = RouteDefinitionMap
 > = TPath extends keyof TMap ? TMap[TPath] extends {
 	searchParams: SearchParamSchema<infer T>;
-} ? T : Record<string, string> : Record<string, string>;
+} ? T : Record<string, string> : [FindSearchParamsInChildren<TPath, TMap>] extends [never] ? Record<string, string> : FindSearchParamsInChildren<TPath, TMap>;
 /** Internal compiled route. */
 interface CompiledRoute {
 	/** The original path pattern. */

package/dist/src/router/public.js

@@ -10,7 +10,7 @@ import {
 import"../../shared/chunk-mntc8w0g.js";
 import {
   createRouter
-} from "../../shared/chunk-mm9ms792.js";
+} from "../../shared/chunk-9ybtmy8t.js";
 import {
   defineRoutes
 } from "../../shared/chunk-ah86rm07.js";

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

@@ -138,8 +138,27 @@ type ExtractParams<T extends string> = [ExtractParamsFromSegments<WithoutWildcar
 } : Record<string, never> : HasWildcard<T> extends true ? { [K in ExtractParamsFromSegments<WithoutWildcard<T>>] : string } & {
 	"*": string;
 } : { [K in ExtractParamsFromSegments<WithoutWildcard<T>>] : string };
-/** Union of route pattern keys from a route map. */
-type RoutePattern<TRouteMap extends Record<string, unknown>> = keyof TRouteMap & string;
+/**
+* Join parent and child route path segments.
+* - `JoinPaths<'/', '/brands'>` → `'/brands'`
+* - `JoinPaths<'/admin', '/settings'>` → `'/admin/settings'`
+* - `JoinPaths<'', '/brands'>` → `'/brands'`
+*/
+type JoinPaths<
+	Parent extends string,
+	Child extends string
+> = Parent extends "" | "/" ? Child : Child extends "/" ? Parent : `${Parent}${Child}`;
+/**
+* Union of all route pattern keys from a route map, including nested children.
+* Recursively walks `children` and concatenates parent + child paths.
+* Short-circuits to `string` for index signatures (backward compat).
+*/
+type RoutePattern<
+	TRouteMap extends Record<string, unknown>,
+	_Prefix extends string = ""
+> = string extends keyof TRouteMap ? string : { [K in keyof TRouteMap & string] : JoinPaths<_Prefix, K> | (TRouteMap[K] extends {
+	children: infer C extends Record<string, unknown>;
+} ? RoutePattern<C, JoinPaths<_Prefix, K>> : never) }[keyof TRouteMap & string];
 /**
 * View Transitions API integration.
 *

package/dist/src/test/index.js

@@ -1,6 +1,6 @@
 import {
   createRouter
-} from "../../shared/chunk-mm9ms792.js";
+} from "../../shared/chunk-9ybtmy8t.js";
 import {
   defineRoutes
 } from "../../shared/chunk-ah86rm07.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertz/ui",
-  "version": "0.2.35",
+  "version": "0.2.37",
   "description": "Vertz UI framework — signals, components, JSX runtime",
   "license": "MIT",
   "repository": {
@@ -77,11 +77,11 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@vertz/fetch": "^0.2.31"
+    "@vertz/fetch": "^0.2.35"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.7.0",
-    "@vertz/schema": "^0.2.31",
+    "@vertz/schema": "^0.2.35",
     "bunup": "^0.16.31",
     "happy-dom": "^20.7.0",
     "typescript": "^5.7.0"