@timber-js/app 0.1.18 → 0.1.20

package/dist/client/use-params.d.ts

@@ -18,9 +18,24 @@
  * (populated by ssr-entry.ts) to ensure correct per-request isolation
  * across concurrent requests with streaming Suspense.
  *
+ * Reactivity: useParams() uses useSyncExternalStore so that components
+ * in unchanged layouts (e.g., sidebar items) re-render atomically when
+ * params change during client-side navigation. This matches the pattern
+ * used by usePathname() and useSearchParams().
+ *
  * Design doc: design/09-typescript.md §"Typed Routes"
  */
 import type { Routes } from '#/index.js';
+/**
+ * Subscribe to params changes. Called by useSyncExternalStore.
+ * Exported for testing — not intended for direct use by app code.
+ */
+export declare function subscribe(callback: () => void): () => void;
+/**
+ * Get the current params snapshot (client).
+ * Exported for testing — not intended for direct use by app code.
+ */
+export declare function getSnapshot(): Record<string, string | string[]>;
 /**
  * Set the current route params. Called by the framework internals
  * during navigation — not intended for direct use by app code.
@@ -29,6 +44,10 @@ import type { Routes } from '#/index.js';
  * During SSR, params are also available via getSsrData().params
  * (ALS-backed), but setCurrentParams is still called for the
  * module-level fallback path.
+ *
+ * After mutation, all useSyncExternalStore subscribers are notified
+ * so that every mounted useParams() consumer re-renders in the same
+ * React commit — even components in unchanged layouts.
  */
 export declare function setCurrentParams(params: Record<string, string | string[]>): void;
 /**
@@ -38,8 +57,8 @@ export declare function setCurrentParams(params: Record<string, string | string[
  * it does not affect the runtime return value.
  *
  * During SSR, reads from the ALS-backed SSR data context to ensure
- * per-request isolation. On the client, reads from module-level state
- * (set by the segment router on each navigation).
+ * per-request isolation. On the client, subscribes to the module-level
+ * params store via useSyncExternalStore.
  *
  * @overload Typed — when a known route path is passed, returns the
  *   exact params shape from the generated Routes interface.

package/dist/client/use-params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-params.d.ts","sourceRoot":"","sources":["../../src/client/use-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AASzC;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CAEhF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AACjF,wBAAgB,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC"}
+{"version":3,"file":"use-params.d.ts","sourceRoot":"","sources":["../../src/client/use-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAczC;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAG1D;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAE/D;AAeD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CAKhF;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AACjF,wBAAgB,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC"}

package/dist/client/use-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-router.d.ts","sourceRoot":"","sources":["../../src/client/use-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACzD,6DAA6D;IAC7D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5D,sDAAsD;IACtD,OAAO,IAAI,IAAI,CAAC;IAChB,+BAA+B;IAC/B,IAAI,IAAI,IAAI,CAAC;IACb,kCAAkC;IAClC,OAAO,IAAI,IAAI,CAAC;IAChB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,IAAI,iBAAiB,CAyD7C"}
+{"version":3,"file":"use-router.d.ts","sourceRoot":"","sources":["../../src/client/use-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACzD,6DAA6D;IAC7D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5D,sDAAsD;IACtD,OAAO,IAAI,IAAI,CAAC;IAChB,+BAA+B;IAC/B,IAAI,IAAI,IAAI,CAAC;IACb,kCAAkC;IAClC,OAAO,IAAI,IAAI,CAAC;IAChB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,IAAI,iBAAiB,CAuD7C"}

package/dist/index.js

@@ -11752,7 +11752,7 @@ function listenForClientErrors(server, projectRoot) {
 //#endregion
 //#region src/plugins/entries.ts
 var __dirname$1 = dirname(fileURLToPath(import.meta.url));
-var SRC_DIR$1 = existsSync(resolve(__dirname$1, "..", "server", "rsc-entry", "index.ts")) ? resolve(__dirname$1, "..") : resolve(__dirname$1, "..", "src");
+var SRC_DIR = existsSync(resolve(__dirname$1, "..", "server", "rsc-entry", "index.ts")) ? resolve(__dirname$1, "..") : resolve(__dirname$1, "..", "src");
 var VIRTUAL_IDS = {
 	rscEntry: "virtual:timber-rsc-entry",
 	ssrEntry: "virtual:timber-ssr-entry",
@@ -11769,9 +11769,9 @@ var VIRTUAL_IDS = {
 * published package via the `files` field.
 */
 var ENTRY_FILE_MAP = {
-	[VIRTUAL_IDS.rscEntry]: resolve(SRC_DIR$1, "server", "rsc-entry", "index.ts"),
-	[VIRTUAL_IDS.ssrEntry]: resolve(SRC_DIR$1, "server", "ssr-entry.ts"),
-	[VIRTUAL_IDS.browserEntry]: resolve(SRC_DIR$1, "client", "browser-entry.ts")
+	[VIRTUAL_IDS.rscEntry]: resolve(SRC_DIR, "server", "rsc-entry", "index.ts"),
+	[VIRTUAL_IDS.ssrEntry]: resolve(SRC_DIR, "server", "ssr-entry.ts"),
+	[VIRTUAL_IDS.browserEntry]: resolve(SRC_DIR, "client", "browser-entry.ts")
 };
 /** The \0-prefixed resolved ID for virtual:timber-config */
 var RESOLVED_CONFIG_ID = `\0${VIRTUAL_IDS.config}`;
@@ -12288,7 +12288,6 @@ function generateManifestModule(tree) {
 //#region src/plugins/shims.ts
 var __dirname = dirname(fileURLToPath(import.meta.url));
 var PKG_ROOT = __dirname.endsWith("plugins") ? resolve(__dirname, "..", "..") : resolve(__dirname, "..");
-var SRC_DIR = resolve(PKG_ROOT, "src");
 var SHIMS_DIR = resolve(PKG_ROOT, "src", "shims");
 /**
 * Virtual module IDs for server-only and client-only poison pills.
@@ -12323,34 +12322,6 @@ function stripJsExtension(id) {
 	return id.endsWith(".js") ? id.slice(0, -3) : id;
 }
 /**
-* Resolve a #/* subpath import to an absolute file path.
-*
-* The package.json "imports" field maps #/* → ./src/*. Vite's resolver
-* handles this via Node.js subpath imports, but in dev mode the resulting
-* module URL can differ from a relative import to the same file. This
-* causes module duplication — the same file loaded as two separate ES
-* modules with separate module-level state.
-*
-* This function resolves #/foo/bar.js to <PKG_ROOT>/src/foo/bar.ts
-* (trying .ts first, then .tsx, then .js, then the raw path).
-* Returns null if the import is not a #/ import or the file doesn't exist.
-*/
-function resolveSubpathImport(id) {
-	if (!id.startsWith("#/")) return null;
-	const basePath = resolve(SRC_DIR, id.slice(2));
-	const withoutJs = stripJsExtension(basePath);
-	for (const ext of [
-		".ts",
-		".tsx",
-		".js"
-	]) {
-		const candidate = withoutJs + ext;
-		if (existsSync(candidate)) return candidate;
-	}
-	if (existsSync(basePath)) return basePath;
-	return null;
-}
-/**
 * Create the timber-shims Vite plugin.
 *
 * Hooks: resolveId, load
@@ -12362,8 +12333,6 @@ function timberShims(_ctx) {
 		resolveId(id) {
 			if (id === "server-only") return SERVER_ONLY_VIRTUAL;
 			if (id === "client-only") return CLIENT_ONLY_VIRTUAL;
-			const subpathResolved = resolveSubpathImport(id);
-			if (subpathResolved) return subpathResolved;
 			const cleanId = stripJsExtension(id);
 			if (cleanId in SHIM_MAP) {
 				if (this.environment?.name === "client" && cleanId === "next/navigation") return resolve(SHIMS_DIR, "navigation-client.ts");