@timber-js/app 0.2.0-alpha.122 → 0.2.0-alpha.124

package/dist/routing/index.js

@@ -1,4 +1,4 @@
 import { i as INTERCEPTION_MARKERS, n as classifyUrlSegment, r as DEFAULT_PAGE_EXTENSIONS, t as classifySegment } from "../_chunks/segment-classify-BjfuctV2.js";
-import { p as scanRoutes } from "../_chunks/cli-schema-sync-VcCf1TFY.js";
-import { a as generateRouteMap, i as collectInterceptionRewrites, n as collectDynamicSegmentsFromTree, r as validateSchemaAgainstRoutes, t as collectLeafRoutes } from "../_chunks/walkers-tkw7sDlj.js";
+import { m as scanRoutes } from "../_chunks/cli-schema-sync-DFHBj6yZ.js";
+import { a as generateRouteMap, i as collectInterceptionRewrites, n as collectDynamicSegmentsFromTree, r as validateSchemaAgainstRoutes, t as collectLeafRoutes } from "../_chunks/walkers-DMSGZeCk.js";
 export { DEFAULT_PAGE_EXTENSIONS, INTERCEPTION_MARKERS, classifySegment, classifyUrlSegment, collectDynamicSegmentsFromTree, collectInterceptionRewrites, collectLeafRoutes, generateRouteMap, scanRoutes, validateSchemaAgainstRoutes };

package/dist/segment-params/define.d.ts

@@ -14,12 +14,6 @@
  */
 import type { Codec } from '../codec.js';
 import { type StandardSchemaV1 } from '../schema-bridge.js';
-/**
- * Register the client useSegmentParams hook.
- * Called by client entry at module load time to avoid require() at call time.
- * @internal
- */
-export declare function _registerUseSegmentParams(hook: () => Record<string, string | string[]>): void;
 /**
  * Register the getSegmentParams function. Called once at module load time
  * from request-context.ts to avoid dynamic import at call time.

package/dist/segment-params/define.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/segment-params/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,qBAAqB,CAAC;AAW7B;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CAE7F;AAcD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CAExF;AAgBD,8DAA8D;AAC9D,MAAM,MAAM,eAAe,CAAC,CAAC,IAC3B,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEjF,6EAA6E;AAC7E,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAErE,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,2EAA2E;IAC3E,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IAEjD,mEAAmE;IACnE,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7C;;;;;;;;;;;;;;;OAeG;IACH,GAAG,IAAI,CAAC,CAAC;IAET;;;;;;;;;;OAUG;IACH,gBAAgB,IAAI,CAAC,CAAC;IAEtB,2BAA2B;IAC3B,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;CACzC;AA+FD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACtE,MAAM,EAAE,CAAC,GACR,gBAAgB,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,CA8F7D"}
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/segment-params/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,qBAAqB,CAAC;AAW7B;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CAExF;AAgBD,8DAA8D;AAC9D,MAAM,MAAM,eAAe,CAAC,CAAC,IAC3B,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEjF,6EAA6E;AAC7E,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAErE,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,2EAA2E;IAC3E,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IAEjD,mEAAmE;IACnE,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7C;;;;;;;;;;;;;;;OAeG;IACH,GAAG,IAAI,CAAC,CAAC;IAET;;;;;;;;;;OAUG;IACH,gBAAgB,IAAI,CAAC,CAAC;IAEtB,2BAA2B;IAC3B,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;CACzC;AA+FD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACtE,MAAM,EAAE,CAAC,GACR,gBAAgB,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,CAwF7D"}

package/dist/segment-params/index.js

@@ -1,2 +1,2 @@
-import { r as defineSegmentParams } from "../_chunks/define-CPVQaWbx.js";
+import { n as defineSegmentParams } from "../_chunks/define-BJMwm0c4.js";
 export { defineSegmentParams };

package/dist/server/index.js

@@ -1,6 +1,6 @@
 import { a as getSpanId, d as withSpan, o as getTraceId, p as formFlashAls, t as addSpanEvent, v as isDebug, y as isDevMode } from "../_chunks/tracing-DvKLzCFa.js";
 import { t as formatSize } from "../_chunks/format-BjN9HLu9.js";
-import { D as getCookieJar, a as revalidateTag, b as getSegmentParams, c as DenySignal, f as deny, h as waitUntil, i as revalidatePath, l as RedirectSignal, m as redirectExternal, o as coerce, p as redirect, s as parseFormData, u as RedirectType, v as getHeaders } from "../_chunks/actions-Dy8vOjFt.js";
+import { D as getCookieJar, a as revalidateTag, b as getSegmentParams, c as DenySignal, f as deny, h as waitUntil, i as revalidatePath, l as RedirectSignal, m as redirectExternal, o as coerce, p as redirect, s as parseFormData, u as RedirectType, v as getHeaders } from "../_chunks/actions-418ygYKC.js";
 //#region src/server/sensitive-fields.ts
 /**
 * Sensitive field stripping — removes password/token/CVV-style fields

package/dist/server/internal.js

@@ -3,10 +3,10 @@ import { a as warnRedirectInSuspense, c as warnSuspenseWrappingChildren, i as wa
 import { i as getMetadataRouteServePath, n as classifyMetadataRoute, r as getMetadataRouteAutoLink, t as METADATA_ROUTE_CONVENTIONS } from "../_chunks/metadata-routes-DESG8uk5.js";
 import { n as classifyUrlSegment } from "../_chunks/segment-classify-BjfuctV2.js";
 import { a as logProxyError, c as logRequestReceived, d as logSwrRefetchFailed, f as logWaitUntilRejected, h as swallow, i as logMiddlewareShortCircuit, l as logRouteError, m as setLogger, n as logCacheMiss, o as logRenderError, p as logWaitUntilUnsupported, r as logMiddlewareError, s as logRequestCompleted, t as getLogger, u as logSlowRequest } from "../_chunks/logger-DDmK5skc.js";
-import { C as setMatchedSegmentPath, E as getCookie, O as getSetCookieHeaders, S as runWithRequestContext, T as setSegmentParams, _ as getHeader, b as getSegmentParams, c as DenySignal, d as RenderError, g as applyRequestHeaderOverlay, l as RedirectSignal, n as executeAction, o as coerce, r as isRscActionRequest, t as buildNoJsResponse, w as setMutableCookieContext, x as markResponseFlushed, y as getSearchParams } from "../_chunks/actions-Dy8vOjFt.js";
+import { C as setMatchedSegmentPath, E as getCookie, O as getSetCookieHeaders, S as runWithRequestContext, T as setSegmentParams, _ as getHeader, b as getSegmentParams, c as DenySignal, d as RenderError, g as applyRequestHeaderOverlay, l as RedirectSignal, n as executeAction, o as coerce, r as isRscActionRequest, t as buildNoJsResponse, w as setMutableCookieContext, x as markResponseFlushed, y as getSearchParams } from "../_chunks/actions-418ygYKC.js";
 import "../client/error-boundary.js";
-import { n as toBracketKey } from "../_chunks/resolve-schema-cURaYvaD.js";
-import "../_chunks/segment-context-EsfQpS--.js";
+import { n as toBracketKey } from "../_chunks/resolve-schema-DU2nbVOi.js";
+import "../_chunks/segment-context-Bg0pFbLT.js";
 import { readFile } from "node:fs/promises";
 import "node:crypto";
 import { createElement } from "react";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timber-js/app",
-  "version": "0.2.0-alpha.122",
+  "version": "0.2.0-alpha.124",
   "description": "Vite-native React framework built for Servers and Serverless Platforms — correct HTTP semantics, real status codes, pages that work without JavaScript",
   "keywords": [
     "cloudflare-workers",
@@ -114,11 +114,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "vite build --config vite.lib.config.ts && tsc --emitDeclarationOnly --project tsconfig.json --outDir dist",
-    "typecheck": "tsgo --noEmit",
-    "prepublishOnly": "pnpm run build"
-  },
   "dependencies": {
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/context-async-hooks": "^2.6.1",
@@ -162,5 +157,9 @@
   },
   "engines": {
     "node": ">=22.12.0"
+  },
+  "scripts": {
+    "build": "vite build --config vite.lib.config.ts && tsc --emitDeclarationOnly --project tsconfig.json --outDir dist",
+    "typecheck": "tsgo --noEmit"
   }
-}
+}

package/src/cli-schema-sync.ts

@@ -1,8 +1,7 @@
 /**
- * `timber schema sync` — scan filesystem for dynamic segments and append
- * missing entries to app/schema.ts with `codec.string` defaults.
- *
- * Only adds, never removes or modifies existing entries.
+ * `timber schema sync` — scan filesystem for dynamic segments, append
+ * missing entries with `codec.string` defaults, and remove stale entries
+ * whose segments no longer exist in the filesystem.
  *
  * Design doc: design/41-global-params.md §Auto-Scaffolding
  */
@@ -66,6 +65,12 @@ export function findSchemaFile(appDir: string): string | undefined {
   return undefined;
 }
 
+export function defaultCodecForSegment(seg: string): string {
+  if (seg.startsWith('[[...')) return 'codec.optionalCatchAll(codec.string)';
+  if (seg.startsWith('[...')) return 'codec.stringArray';
+  return 'codec.string';
+}
+
 /**
  * Generate the content for a new app/schema.ts with the given segment keys.
  */
@@ -77,7 +82,7 @@ function generateNewSchema(segments: string[]): string {
   lines.push('export default defineSchema({');
   lines.push('  segmentParams: {');
   for (const seg of segments) {
-    lines.push(`    '${seg}': codec.string,`);
+    lines.push(`    '${seg}': ${defaultCodecForSegment(seg)},`);
   }
   lines.push('  },');
   lines.push('});');
@@ -147,7 +152,9 @@ function appendToSchema(content: string, newSegments: string[]): string {
   const indent = existingLine ? existingLine[1] : '    ';
 
   // Build insertion text
-  const insertion = newSegments.map((seg) => `${indent}'${seg}': codec.string,`).join('\n');
+  const insertion = newSegments
+    .map((seg) => `${indent}'${seg}': ${defaultCodecForSegment(seg)},`)
+    .join('\n');
 
   // Insert before the closing brace
   const before = content.slice(0, closeBrace);
@@ -159,6 +166,54 @@ function appendToSchema(content: string, newSegments: string[]): string {
   return before + separator + insertion + '\n' + after;
 }
 
+/**
+ * Remove entries from the segmentParams block whose keys match `staleSegments`.
+ * Removes the entire line including trailing comma/whitespace.
+ */
+function removeFromSchema(content: string, staleSegments: string[]): string {
+  for (const seg of staleSegments) {
+    const escaped = seg.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const keyRe = new RegExp(`^[ \t]*['"]${escaped}['"][ \t]*:`, 'gm');
+    let m: RegExpExecArray | null;
+    while ((m = keyRe.exec(content)) !== null) {
+      const start = m.index;
+      let i = m.index + m[0].length;
+      let depth = 0;
+      let inString: string | null = null;
+
+      while (i < content.length) {
+        const ch = content[i];
+        if (inString) {
+          if (ch === '\\') {
+            i++;
+          } else if (ch === inString) {
+            inString = null;
+          }
+        } else if (ch === '"' || ch === "'" || ch === '`') {
+          inString = ch;
+        } else if (ch === '(' || ch === '{' || ch === '[') {
+          depth++;
+        } else if (ch === ')' || ch === '}' || ch === ']') {
+          depth--;
+        } else if (depth === 0 && ch === ',') {
+          i++;
+          break;
+        } else if (depth === 0 && (ch === '\n' || ch === '}')) {
+          break;
+        }
+        i++;
+      }
+
+      // Consume trailing newline
+      if (i < content.length && content[i] === '\n') i++;
+
+      content = content.slice(0, start) + content.slice(i);
+      keyRe.lastIndex = start;
+    }
+  }
+  return content;
+}
+
 export interface SchemaSyncResult {
   /** Segments found in the filesystem. */
   filesystemSegments: string[];
@@ -166,6 +221,8 @@ export interface SchemaSyncResult {
   existingSegments: string[];
   /** Segments that were added. */
   addedSegments: string[];
+  /** Segments that were removed (no longer in filesystem). */
+  removedSegments: string[];
   /** Whether a new schema file was created. */
   created: boolean;
 }
@@ -178,17 +235,18 @@ export function runSchemaSync(projectRoot: string): SchemaSyncResult {
 
   const filesystemSegments = collectDynamicSegments(appDir);
 
-  if (filesystemSegments.length === 0) {
+  const schemaPath = findSchemaFile(appDir);
+
+  if (filesystemSegments.length === 0 && !schemaPath) {
     return {
       filesystemSegments: [],
       existingSegments: [],
       addedSegments: [],
+      removedSegments: [],
       created: false,
     };
   }
 
-  const schemaPath = findSchemaFile(appDir);
-
   if (!schemaPath) {
     // Create new schema file
     const newPath = join(appDir, 'schema.ts');
@@ -197,32 +255,41 @@ export function runSchemaSync(projectRoot: string): SchemaSyncResult {
       filesystemSegments,
       existingSegments: [],
       addedSegments: filesystemSegments,
+      removedSegments: [],
       created: true,
     };
   }
 
-  // Read existing schema and find missing segments
+  // Read existing schema and diff
   const content = readFileSync(schemaPath, 'utf-8');
   const existingSegments = parseExistingSchemaKeys(content);
   const missing = filesystemSegments.filter((seg) => !existingSegments.includes(seg));
+  const stale = existingSegments.filter((seg) => !filesystemSegments.includes(seg));
 
-  if (missing.length === 0) {
+  if (missing.length === 0 && stale.length === 0) {
     return {
       filesystemSegments,
       existingSegments,
       addedSegments: [],
+      removedSegments: [],
       created: false,
     };
   }
 
-  // Append missing segments
-  const updated = appendToSchema(content, missing);
+  let updated = content;
+  if (stale.length > 0) {
+    updated = removeFromSchema(updated, stale);
+  }
+  if (missing.length > 0) {
+    updated = appendToSchema(updated, missing);
+  }
   writeFileSync(schemaPath, updated, 'utf-8');
 
   return {
     filesystemSegments,
     existingSegments,
     addedSegments: missing,
+    removedSegments: stale,
     created: false,
   };
 }

package/src/cli.ts

@@ -188,7 +188,7 @@ export async function runCheck(options: CommandOptions): Promise<void> {
 
 /**
  * `timber schema sync` — scan filesystem for dynamic segments, diff against
- * app/schema.ts, and append missing entries with codec.string default.
+ * app/schema.ts, and append missing entries with type-appropriate codec defaults.
  *
  * See design/41-global-params.md §Auto-Scaffolding
  */
@@ -201,7 +201,7 @@ export async function runSchema(args: string[]): Promise<void> {
     );
   }
 
-  const { runSchemaSync } = await import('./cli-schema-sync.js');
+  const { runSchemaSync, defaultCodecForSegment } = await import('./cli-schema-sync.js');
   const result = runSchemaSync(process.cwd());
 
   if (result.filesystemSegments.length === 0) {
@@ -212,19 +212,30 @@ export async function runSchema(args: string[]): Promise<void> {
   if (result.created) {
     console.log(`[timber] Created app/schema.ts with ${result.addedSegments.length} segment(s):`);
     for (const seg of result.addedSegments) {
-      console.log(`  + ${seg}: codec.string`);
+      console.log(`  + ${seg}: ${defaultCodecForSegment(seg)}`);
     }
     return;
   }
 
-  if (result.addedSegments.length === 0) {
+  if (result.addedSegments.length === 0 && result.removedSegments.length === 0) {
     console.log('[timber] Schema is up to date — all segments are registered.');
     return;
   }
 
-  console.log(`[timber] Added ${result.addedSegments.length} segment(s) to app/schema.ts:`);
-  for (const seg of result.addedSegments) {
-    console.log(`  + ${seg}: codec.string`);
+  if (result.addedSegments.length > 0) {
+    console.log(`[timber] Added ${result.addedSegments.length} segment(s) to app/schema.ts:`);
+    for (const seg of result.addedSegments) {
+      console.log(`  + ${seg}: ${defaultCodecForSegment(seg)}`);
+    }
+  }
+
+  if (result.removedSegments.length > 0) {
+    console.log(
+      `[timber] Removed ${result.removedSegments.length} stale segment(s) from app/schema.ts:`
+    );
+    for (const seg of result.removedSegments) {
+      console.log(`  - ${seg}`);
+    }
   }
 }
 

package/src/client/browser-entry/action-dispatch.ts

@@ -15,7 +15,7 @@
  */
 
 import { setServerCallback, encodeReply, createFromFetch } from '../../rsc-runtime/browser.js';
-import { getRouter } from '#client-internal';
+import { getRouter, getRouterOrNull } from '#client-internal';
 import { setHardNavigating } from '../navigation-root.js';
 import { isStaleClientReference, triggerStaleReload } from '../stale-reload.js';
 import { getClientDeploymentId, DEPLOYMENT_ID_HEADER, RELOAD_HEADER } from '../rsc-fetch.js';
@@ -96,15 +96,14 @@ export function setupServerActions(): void {
       // Piggybacked response: wrapper object { _action, _tree }
       // Apply the revalidated tree directly — no separate router.refresh() needed.
       const wrapper = decoded as { _action: unknown; _tree: unknown };
-      try {
-        const router = getRouter();
-        const headElements = headElementsJson ? JSON.parse(headElementsJson) : null;
-        router.applyRevalidation(wrapper._tree, headElements);
-      } catch (e) {
-        console.debug(
-          '[timber] action revalidation: router not ready',
-          e instanceof Error ? e.message : e
-        );
+      const router = getRouterOrNull();
+      if (router) {
+        try {
+          const headElements = headElementsJson ? JSON.parse(headElementsJson) : null;
+          router.applyRevalidation(wrapper._tree, headElements);
+        } catch (e) {
+          console.error('[timber] applyRevalidation failed after server action', e);
+        }
       }
       return wrapper._action;
     }

package/src/client/browser-entry/hydrate.ts

@@ -50,12 +50,14 @@ export function runPreHydration(): void {
     setNavigationState({
       params: earlyParams as Record<string, string | string[]>,
       pathname: window.location.pathname,
+      search: window.location.search,
     });
     delete (self as unknown as Record<string, unknown>).__timber_params;
   } else {
     setNavigationState({
       params: {},
       pathname: window.location.pathname,
+      search: window.location.search,
     });
   }
 }

package/src/client/browser-entry/post-hydration.ts

@@ -58,12 +58,18 @@ export function setupPostHydration({
     delete (self as unknown as Record<string, unknown>).__timber_segments;
   }
 
-  // NOTE: We do NOT cache segment elements from the initial RSC payload here.
-  // The decoded element from createFromReadableStream is a thenable/lazy
-  // element that React resolves during render — the segment walker can't
-  // traverse it. The element cache is populated lazily after the first SPA
-  // navigation (via mergeAndCachePayload in renderViaTransition), when
-  // the decoded payload is a fully resolved React element tree.
+  // Cache segment elements from the initial RSC payload after hydration.
+  // The element from createFromReadableStream is a Flight thenable that
+  // React resolves during hydration. Once resolved (status='fulfilled'),
+  // its .value contains the React element tree we can walk.
+  // Use requestAnimationFrame to run after hydration commits.
+  if (initialElement != null) {
+    requestAnimationFrame(() => {
+      const el = initialElement as { status?: string; value?: unknown };
+      const resolved = el.status === 'fulfilled' && el.value != null ? el.value : initialElement;
+      router.cacheElementTree(resolved);
+    });
+  }
 
   // If the hydration path was skipped (no RSC payload), populate the
   // fallback params from server embed here.
@@ -73,6 +79,7 @@ export function setupPostHydration({
     setNavigationState({
       params: lateTimberParams as Record<string, string | string[]>,
       pathname: window.location.pathname,
+      search: window.location.search,
     });
     delete (self as unknown as Record<string, unknown>).__timber_params;
   }

package/src/client/index.ts

@@ -66,6 +66,7 @@ export type { LinkStatus } from './use-link-status';
 export { useRouter } from './use-router';
 export type { AppRouterInstance } from './use-router';
 export { usePathname } from './use-pathname';
+export { replaceUrl } from './shallow-url';
 // useSearchParams removed from public exports — lives in next/navigation shim only.
 export { useSelectedLayoutSegment, useSelectedLayoutSegments } from './use-selected-layout-segment';
 
@@ -82,8 +83,3 @@ export { useSegmentParams } from './use-segment-params';
 // Cookies — useCookie lives on defineCookie().useCookie().
 // Types still exported for advanced use.
 export type { ClientCookieOptions, CookieSetter } from './use-cookie';
-
-// Register the client useSegmentParams hook with defineSegmentParams.
-import { useSegmentParams as _useSegmentParams } from './use-segment-params.js';
-import { _registerUseSegmentParams } from '../segment-params/define.js';
-_registerUseSegmentParams(_useSegmentParams);

package/src/client/link.tsx

@@ -384,20 +384,28 @@ export function resolveHref(
         | SearchParamsDefinition<Record<string, unknown>>
         | undefined;
       values = searchParams;
-      if (!definition) {
-        throw new Error(
-          `<Link> received a flat searchParams object for href "${href}", but no ` +
-            `SearchParamsDefinition is registered for that route. ` +
-            `Either the route does not export \`searchParams\` from its \`params.ts\`/\`page.tsx\`, ` +
-            `or the search-params registry module was not loaded. ` +
-            `For external or computed hrefs, pass the legacy \`{ definition, values }\` shape instead.`
-        );
-      }
     }
 
-    const qs = definition.serialize(values);
-    if (qs) {
-      resolvedPath = `${resolvedPath}?${qs}`;
+    if (definition) {
+      const qs = definition.serialize(values);
+      if (qs) {
+        resolvedPath = `${resolvedPath}?${qs}`;
+      }
+    } else {
+      // No registered definition — serialize flat object as plain query params.
+      const usp = new URLSearchParams();
+      for (const [key, val] of Object.entries(values)) {
+        if (val === undefined || val === null) continue;
+        if (Array.isArray(val)) {
+          for (const item of val) usp.append(key, String(item));
+        } else {
+          usp.set(key, String(val));
+        }
+      }
+      const qs = usp.toString();
+      if (qs) {
+        resolvedPath = `${resolvedPath}?${qs}`;
+      }
     }
   }
 
@@ -591,6 +599,11 @@ export const Link: LinkFunction = function LinkImpl(props: any) {
           return;
         }
 
+        // Hash-only hrefs — let the browser handle scroll-to-anchor natively.
+        // The Navigation API path already skips these via event.hashChange;
+        // this covers the fallback (Safari/Firefox) where we drive navigation manually.
+        if (resolvedHref.startsWith('#')) return;
+
         // History API fallback — prevent default and navigate via router
         event.preventDefault();
 

package/src/client/navigation-context.ts

@@ -48,6 +48,7 @@ import React, { createElement, type ReactNode } from 'react';
 export interface NavigationState {
   params: Record<string, string | string[]>;
   pathname: string;
+  search: string;
 }
 
 // ---------------------------------------------------------------------------
@@ -153,7 +154,7 @@ const NAV_STATE_KEY = Symbol.for('__timber_nav_state');
 function _getNavStateStore(): { current: NavigationState } {
   const g = globalThis as Record<symbol, unknown>;
   if (!g[NAV_STATE_KEY]) {
-    g[NAV_STATE_KEY] = { current: { params: {}, pathname: '/' } };
+    g[NAV_STATE_KEY] = { current: { params: {}, pathname: '/', search: '' } };
   }
   return g[NAV_STATE_KEY] as { current: NavigationState };
 }