veryfront 0.1.1127 → 0.1.1132

package/esm/src/html/hydration-script-builder/templates/router.js

@@ -592,7 +592,7 @@ export const getRouterScript = () => `
     // ============================================
     // SPA navigation handler
     // ============================================
-    async function navigateSPA(href, pushState = true, restoreScroll = false) {
+    async function navigateSPA(href, historyMode = 'push', restoreScroll = false) {
       currentAbortController?.abort();
 
       if (isNavigating) return;
@@ -626,14 +626,24 @@ export const getRouterScript = () => `
         // { redirect: { destination } } payload. Follow it with a document
         // navigation to the target (the same net effect as the full-page 302),
         // instead of trying to render a page that does not exist here.
+        // Only follow http(s)/relative destinations: assigning a javascript:/data:
+        // URL to location.href would EXECUTE it (the server also filters these, so
+        // this is defense in depth). Fall through to the normal error path otherwise.
         if (pageData && pageData.redirect && typeof pageData.redirect.destination === 'string') {
-          log('SPA navigation redirect -> ' + pageData.redirect.destination);
-          window.location.href = pageData.redirect.destination;
-          return;
+          try {
+            var redirectTarget = new URL(pageData.redirect.destination, window.location.origin);
+            if (redirectTarget.protocol === 'http:' || redirectTarget.protocol === 'https:') {
+              log('SPA navigation redirect -> ' + redirectTarget.href);
+              window.location.href = redirectTarget.href;
+              return;
+            }
+          } catch (e) { /* invalid destination — do not follow */ }
         }
 
-        if (pushState) {
+        if (historyMode === 'push') {
           window.history.pushState({ pageData, scrollY: 0 }, '', href);
+        } else if (historyMode === 'replace') {
+          window.history.replaceState({ pageData, scrollY: 0 }, '', href);
         }
 
         // Update the shared router snapshot BEFORE rendering. RouterProvider
@@ -666,7 +676,11 @@ export const getRouterScript = () => `
 
         hideNavigationProgress();
         perfEnd('nav:total:' + href);
-        emitRouteTiming('total', targetPath, navigationStartedAt, { href, pushState, restoreScroll });
+        emitRouteTiming('total', targetPath, navigationStartedAt, {
+          href,
+          historyMode,
+          restoreScroll
+        });
         log('SPA navigation complete');
       } catch (error) {
         hideNavigationProgress();
@@ -1076,10 +1090,10 @@ export const getRouterScript = () => `
       domain: window.location.origin,
       path: window.location.pathname,
       push: (path) => {
-        void navigateSPA(path, true);
+        void navigateSPA(path, 'push');
       },
       replace: (path) => {
-        void navigateSPA(path, false);
+        void navigateSPA(path, 'replace');
       },
       back: () => {
         window.history.back();
@@ -1105,12 +1119,22 @@ export const getRouterScript = () => `
       })(),
       isPreview: false,
       isMounted: true,
-      navigate: (path) => navigateSPA(path, true),
+      navigate: (path) => navigateSPA(path, 'push'),
       reload: () => window.location.reload()
     };
 
     window.__veryfrontRouter = router;
 
+    // Route useRouter().push/replace/navigate (from veryfront/router) through the
+    // same SPA navigator that intercepts <Link> clicks. Without this the shared
+    // navigation store has no navigator registered and its navigate() falls back
+    // to a full-page location.assign (finding #7: push() full-reloads).
+    getNavigationStore().setNavigator((href, options) => {
+      const mode = options && options.history;
+      const historyMode = mode === 'replace' ? 'replace' : mode === 'none' ? 'none' : 'push';
+      return navigateSPA(href, historyMode);
+    });
+
     // ============================================
     // Event handlers
     // ============================================
@@ -1121,7 +1145,7 @@ export const getRouterScript = () => `
       saveScrollPosition(currentPath);
 
       if (!e.state?.pageData) {
-        await navigateSPA(path, false, true);
+        await navigateSPA(path, 'none', true);
         return;
       }
 
@@ -1177,7 +1201,7 @@ export const getRouterScript = () => `
 
       e.preventDefault();
       cancelScheduledPrefetch();
-      void navigateSPA(href, true);
+      void navigateSPA(href, 'push');
     });
 
     document.addEventListener(

package/esm/src/html/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/src/html/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAO1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAgBjF,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAQR;AAaD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AA4DD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGrD,CAAC;AA6KF,UAAU,qBAAqB;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oBAAoB,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACpD;AA+GD,wBAAsB,cAAc,CAClC,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACvD,OAAO,CAAC,cAAc,CAAC,CAmEzB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACvD,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAElF"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/src/html/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAO1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAgBjF,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAQR;AAaD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AA4DD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGrD,CAAC;AAuJF,UAAU,qBAAqB;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oBAAoB,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACpD;AA+GD,wBAAsB,cAAc,CAClC,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACvD,OAAO,CAAC,cAAc,CAAC,CA4DzB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACvD,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAElF"}

package/esm/src/html/utils.js

@@ -70,37 +70,33 @@ export const PLATFORM_UTILITIES = {
     ...CORE_PLATFORM_UTILITIES,
     ...AI_MODULE_UTILITIES,
 };
+// React import-map entries, always from esm.sh — the only CDN that serves React
+// as real ESM. Uses the centralized esmShReact() helper so the URLs stay
+// byte-identical across SSR/client (any mismatch loads a second React instance
+// and hooks fail).
+function esmShReactImports(react) {
+    return {
+        react: esmShReact("react", react),
+        "react-dom": esmShReact("react-dom", react, "", true),
+        "react-dom/client": esmShReact("react-dom", react, "/client", true),
+        "react/jsx-runtime": esmShReact("react", react, "/jsx-runtime", true),
+        "react/jsx-dev-runtime": esmShReact("react", react, "/jsx-dev-runtime", true),
+    };
+}
 const CDN_URL_TEMPLATES = {
     "esm.sh": {
-        // Use centralized esmShReact() helper from package-registry.ts to ensure URL consistency
-        // Any URL mismatch causes esm.sh to serve different modules -> multiple React instances -> hooks fail
-        react: (v) => esmShReact("react", v),
-        reactDom: (v) => esmShReact("react-dom", v, "", true),
-        reactDomClient: (v) => esmShReact("react-dom", v, "/client", true),
-        jsxRuntime: (v) => esmShReact("react", v, "/jsx-runtime", true),
-        jsxDevRuntime: (v) => esmShReact("react", v, "/jsx-dev-runtime", true),
         veryfrontChat: (v) => `https://esm.sh/veryfront@${v}/chat?external=react,react-dom&target=es2022`,
         veryfrontMarkdown: (v) => `https://esm.sh/veryfront@${v}/markdown?external=react,react-dom&target=es2022`,
         veryfrontMdx: (v) => `https://esm.sh/veryfront@${v}/mdx?external=react,react-dom&target=es2022`,
         veryfrontWorkflow: (v) => `https://esm.sh/veryfront@${v}/workflow/react?external=react,react-dom&target=es2022`,
     },
     unpkg: {
-        react: (v) => `https://unpkg.com/react@${v}/umd/react.production.min.js`,
-        reactDom: (v) => `https://unpkg.com/react-dom@${v}/umd/react-dom.production.min.js`,
-        reactDomClient: (v) => `https://unpkg.com/react-dom@${v}/umd/react-dom.production.min.js`,
-        jsxRuntime: (v) => `https://unpkg.com/react@${v}/jsx-runtime`,
-        jsxDevRuntime: (v) => `https://unpkg.com/react@${v}/jsx-dev-runtime`,
         veryfrontChat: (v) => `https://unpkg.com/veryfront@${v}/esm/src/chat/index.js`,
         veryfrontMarkdown: (v) => `https://unpkg.com/veryfront@${v}/esm/src/markdown/index.js`,
         veryfrontMdx: (v) => `https://unpkg.com/veryfront@${v}/esm/src/mdx/index.js`,
         veryfrontWorkflow: (v) => `https://unpkg.com/veryfront@${v}/esm/src/workflow/react/index.js`,
     },
     jsdelivr: {
-        react: (v) => `https://cdn.jsdelivr.net/npm/react@${v}/umd/react.production.min.js`,
-        reactDom: (v) => `https://cdn.jsdelivr.net/npm/react-dom@${v}/umd/react-dom.production.min.js`,
-        reactDomClient: (v) => `https://cdn.jsdelivr.net/npm/react-dom@${v}/umd/react-dom.production.min.js`,
-        jsxRuntime: (v) => `https://cdn.jsdelivr.net/npm/react@${v}/jsx-runtime`,
-        jsxDevRuntime: (v) => `https://cdn.jsdelivr.net/npm/react@${v}/jsx-dev-runtime`,
         veryfrontChat: (v) => `https://cdn.jsdelivr.net/npm/veryfront@${v}/esm/src/chat/index.js`,
         veryfrontMarkdown: (v) => `https://cdn.jsdelivr.net/npm/veryfront@${v}/esm/src/markdown/index.js`,
         veryfrontMdx: (v) => `https://cdn.jsdelivr.net/npm/veryfront@${v}/esm/src/mdx/index.js`,
@@ -117,25 +113,15 @@ function buildCdnImportMapFromTemplates(versions, templates,
 // optionally, the AI modules — never the core runtime.
 includeAiModulesLocally) {
     const { react, veryfront } = versions;
-    // React is ALWAYS served from esm.sh, regardless of the configured CDN
-    // provider. esm.sh is the only CDN that serves React as real ESM; unpkg and
-    // jsdelivr only ship UMD globals (react/umd/react.production.min.js), which
-    // cannot be consumed through an import map at all — the browser rejects them
-    // with a module-resolution/CORS error and hydration never starts. Self-hosted
-    // mode already does exactly this. The `provider` only governs where the
-    // veryfront framework modules load from.
-    const reactTemplates = CDN_URL_TEMPLATES["esm.sh"];
     return {
-        react: reactTemplates.react(react),
-        "react-dom": reactTemplates.reactDom(react),
-        "react-dom/client": reactTemplates.reactDomClient(react),
-        "react/jsx-runtime": reactTemplates.jsxRuntime(react),
-        "react/jsx-dev-runtime": reactTemplates.jsxDevRuntime(react),
+        // React is ALWAYS from esm.sh, regardless of the configured provider (see
+        // esmShReactImports). The `provider` only governs the veryfront modules.
+        ...esmShReactImports(react),
         "veryfront/chat": templates.veryfrontChat(veryfront),
         "veryfront/markdown": templates.veryfrontMarkdown(veryfront),
         "veryfront/mdx": templates.veryfrontMdx(veryfront),
         "veryfront/workflow": templates.veryfrontWorkflow(veryfront),
-        // Core runtime utilities always resolve locally (see comment above).
+        // Core runtime utilities always resolve locally.
         ...CORE_PLATFORM_UTILITIES,
         // AI modules only override the CDN entries when requested.
         ...(includeAiModulesLocally ? AI_MODULE_UTILITIES : {}),
@@ -152,13 +138,8 @@ function getJsdelivrImportMap(versions) {
 }
 function getSelfHostedImportMap(versions) {
     const { react } = versions;
-    const esmShTemplates = CDN_URL_TEMPLATES["esm.sh"];
     return {
-        react: esmShTemplates.react(react),
-        "react-dom": esmShTemplates.reactDom(react),
-        "react-dom/client": esmShTemplates.reactDomClient(react),
-        "react/jsx-runtime": esmShTemplates.jsxRuntime(react),
-        "react/jsx-dev-runtime": esmShTemplates.jsxDevRuntime(react),
+        ...esmShReactImports(react),
         "veryfront/chat": "/_veryfront/lib/chat.js",
         "veryfront/markdown": "/_veryfront/lib/markdown.js",
         "veryfront/mdx": "/_veryfront/lib/mdx.js",
@@ -297,14 +278,7 @@ export async function buildImportMap(options) {
         ? await resolveVersions(projectDir, config)
         : DEFAULT_VERSIONS;
     if (mode === "bundled") {
-        const reactTemplates = CDN_URL_TEMPLATES["esm.sh"];
-        let imports = {
-            react: reactTemplates.react(versions.react),
-            "react-dom": reactTemplates.reactDom(versions.react),
-            "react-dom/client": reactTemplates.reactDomClient(versions.react),
-            "react/jsx-runtime": reactTemplates.jsxRuntime(versions.react),
-            "react/jsx-dev-runtime": reactTemplates.jsxDevRuntime(versions.react),
-        };
+        let imports = { ...esmShReactImports(versions.react) };
         imports = applyManifestDependencies(imports, releaseAssetManifest);
         imports = applyReleaseModuleVersions(imports, releaseAssetManifest);
         imports = { ...imports, ...customImports };

package/esm/src/index.client.d.ts

@@ -1,26 +1,11 @@
 /**
- * Client/SSR-safe mirror of the `veryfront` root barrel ({@link file://./index.ts}).
+ * Browser- and SSR-safe helpers from the `veryfront` package.
  *
- * The root barrel re-exports the server bootstrap surface (`createHandler`,
- * `startServer`, `toNodeHandler`) from `#veryfront/server`. Because the browser
- * and SSR pipelines transform modules per-file (no cross-module tree-shaking),
- * an ESM re-export eagerly loads its source module, so pulling the root barrel
- * into a client chunk drags the entire server graph in, including
- * `src/server/production-server.ts`, which has module top-level `await` and
- * cannot be transformed to the es2020 browser target (HTTP 500 on that chunk,
- * which aborts hydration).
- *
- * A client-reachable module doing a used value import from the barrel, for
- * example `import { getEnv } from "veryfront"`, is not dead-stripped, so it
- * keeps the barrel and the leak. This barrel exposes exactly the same
- * browser-safe surface minus the server bootstrap functions, which no
- * client/SSR page code legitimately calls. The import rewriter redirects
- * `veryfront` to this module for the `browser` and `ssr` targets (see
- * `src/transforms/import-rewriter/strategies/veryfront-strategy.ts`), the same
- * mechanism `veryfront/workflow` already uses.
- *
- * Keep the exports below in sync with {@link file://./index.ts}: everything
- * except the `createHandler` / `startServer` / `toNodeHandler` value exports.
+ * This entrypoint exposes the root package's client-safe configuration,
+ * platform, routing, data, and security helpers without server bootstrap
+ * functions. Most app code can import these helpers from `veryfront`; use this
+ * explicit entrypoint when a browser or SSR module needs to declare that
+ * boundary directly.
  *
  * @example
  * ```ts

package/esm/src/index.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.client.d.ts","sourceRoot":"","sources":["../../src/src/index.client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACpF,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAM7C,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE/F,OAAO,EACL,UAAU,EACV,SAAS,EACT,IAAI,EACJ,QAAQ,IAAI,WAAW,EACvB,QAAQ,IAAI,WAAW,EACvB,WAAW,EACX,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAExF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EACV,WAAW,EACX,uBAAuB,EACvB,YAAY,EACZ,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpE,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.client.d.ts","sourceRoot":"","sources":["../../src/src/index.client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,sBAAsB,CAAC;AAG9B,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACpF,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAM7C,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE/F,OAAO,EACL,UAAU,EACV,SAAS,EACT,IAAI,EACJ,QAAQ,IAAI,WAAW,EACvB,QAAQ,IAAI,WAAW,EACvB,WAAW,EACX,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAExF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EACV,WAAW,EACX,uBAAuB,EACvB,YAAY,EACZ,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpE,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC"}

package/esm/src/index.client.js

@@ -1,26 +1,11 @@
 /**
- * Client/SSR-safe mirror of the `veryfront` root barrel ({@link file://./index.ts}).
+ * Browser- and SSR-safe helpers from the `veryfront` package.
  *
- * The root barrel re-exports the server bootstrap surface (`createHandler`,
- * `startServer`, `toNodeHandler`) from `#veryfront/server`. Because the browser
- * and SSR pipelines transform modules per-file (no cross-module tree-shaking),
- * an ESM re-export eagerly loads its source module, so pulling the root barrel
- * into a client chunk drags the entire server graph in, including
- * `src/server/production-server.ts`, which has module top-level `await` and
- * cannot be transformed to the es2020 browser target (HTTP 500 on that chunk,
- * which aborts hydration).
- *
- * A client-reachable module doing a used value import from the barrel, for
- * example `import { getEnv } from "veryfront"`, is not dead-stripped, so it
- * keeps the barrel and the leak. This barrel exposes exactly the same
- * browser-safe surface minus the server bootstrap functions, which no
- * client/SSR page code legitimately calls. The import rewriter redirects
- * `veryfront` to this module for the `browser` and `ssr` targets (see
- * `src/transforms/import-rewriter/strategies/veryfront-strategy.ts`), the same
- * mechanism `veryfront/workflow` already uses.
- *
- * Keep the exports below in sync with {@link file://./index.ts}: everything
- * except the `createHandler` / `startServer` / `toNodeHandler` value exports.
+ * This entrypoint exposes the root package's client-safe configuration,
+ * platform, routing, data, and security helpers without server bootstrap
+ * functions. Most app code can import these helpers from `veryfront`; use this
+ * explicit entrypoint when a browser or SSR module needs to declare that
+ * boundary directly.
  *
  * @example
  * ```ts

package/esm/src/modules/server/ssr-import-rewriter.d.ts

@@ -1,27 +1,3 @@
-type CacheBuster = number | string;
-export interface SSRImportRewriteTarget {
-    specifier: string;
-    kind: "alias" | "relative";
-    modulePath: string;
-    rewrittenPath: string;
-}
-export declare function stripSSRModuleJsExtension(path: string): string;
-export declare function resolveSSRImportTargetModulePath(target: SSRImportRewriteTarget, currentModulePath: string): string;
-export interface SSRRewriteOptions {
-    /** Project slug for multi-project routing */
-    projectSlug?: string | null;
-    /** Branch name for branch-aware routing */
-    branch?: string | null;
-    /** Cache buster token. When omitted, each rewritten target gets a stable token. */
-    cacheBuster?: CacheBuster;
-    /** Resolve a cache buster token for each rewritten target. */
-    resolveCacheBuster?: (target: SSRImportRewriteTarget) => CacheBuster | null | undefined | Promise<CacheBuster | null | undefined>;
-    /** Cross-project reference (e.g., "demo@0.0") for @/ path rewrites */
-    crossProjectRef?: string;
-    /** React version to use for import rewrites */
-    reactVersion?: string;
-}
-export declare function applySSRImportRewrites(code: string, options?: SSRRewriteOptions): string;
-export declare function applySSRImportRewritesAsync(code: string, options?: SSRRewriteOptions): Promise<string>;
-export {};
+export type { SSRImportRewriteTarget, SSRRewriteOptions, } from "../../transforms/import-rewriter/ssr-adapter.js";
+export { resolveSSRImportTargetModulePathCompat as resolveSSRImportTargetModulePath, rewriteSSRImportsCompat as applySSRImportRewrites, rewriteSSRImportsCompatAsync as applySSRImportRewritesAsync, stripSSRModuleJsExtensionCompat as stripSSRModuleJsExtension, } from "../../transforms/import-rewriter/ssr-adapter.js";
 //# sourceMappingURL=ssr-import-rewriter.d.ts.map

package/esm/src/modules/server/ssr-import-rewriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssr-import-rewriter.d.ts","sourceRoot":"","sources":["../../../../src/src/modules/server/ssr-import-rewriter.ts"],"names":[],"mappings":"AAQA,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnC,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAWD,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,sBAAsB,EAC9B,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAWR;AAED,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mFAAmF;IACnF,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,CACnB,MAAM,EAAE,sBAAsB,KAC3B,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC9E,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAwKD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAK5F;AA+CD,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAKjB"}
+{"version":3,"file":"ssr-import-rewriter.d.ts","sourceRoot":"","sources":["../../../../src/src/modules/server/ssr-import-rewriter.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,sCAAsC,IAAI,gCAAgC,EAC1E,uBAAuB,IAAI,sBAAsB,EACjD,4BAA4B,IAAI,2BAA2B,EAC3D,+BAA+B,IAAI,yBAAyB,GAC7D,MAAM,iDAAiD,CAAC"}

package/esm/src/modules/server/ssr-import-rewriter.js

@@ -1,206 +1 @@
-import { DEFAULT_REACT_VERSION, getReactImportMap, } from "../../transforms/esm/package-registry.js";
-import { isDeno, isNode } from "../../platform/compat/runtime.js";
-import { getLocalReactPaths } from "../../platform/compat/react-paths.js";
-import { hashString } from "../../cache/hash.js";
-export function stripSSRModuleJsExtension(path) {
-    return path.replace(/\.(?:mjs|js)$/i, "");
-}
-function normalizeSSRModulePath(path) {
-    let normalized = path.replace(/^\/+/, "");
-    if (normalized.startsWith("_vf_modules/")) {
-        normalized = normalized.slice("_vf_modules/".length);
-    }
-    if (normalized.startsWith("@/"))
-        normalized = normalized.slice(2);
-    return normalized;
-}
-export function resolveSSRImportTargetModulePath(target, currentModulePath) {
-    if (target.kind === "alias")
-        return normalizeSSRModulePath(target.modulePath);
-    const currentPath = normalizeSSRModulePath(currentModulePath);
-    if (target.specifier.startsWith("/")) {
-        return normalizeSSRModulePath(target.specifier);
-    }
-    const basePath = currentPath.startsWith("/") ? currentPath : `/${currentPath}`;
-    const resolved = new URL(target.specifier, `http://veryfront.local${basePath}`).pathname;
-    return normalizeSSRModulePath(resolved);
-}
-function shouldKeepBareSpecifier(specifier) {
-    // npm: specifiers are only supported in Deno, not Node.js
-    // In Node.js, we need to convert them to esm.sh URLs (handled in rewriteBareImports)
-    if (specifier.startsWith("npm:"))
-        return isDeno;
-    if (specifier.startsWith("http://") ||
-        specifier.startsWith("https://") ||
-        specifier.startsWith("file://") ||
-        specifier.startsWith("node:")) {
-        return true;
-    }
-    if (specifier.startsWith("@/"))
-        return true;
-    if (specifier.startsWith("veryfront/"))
-        return true;
-    return false;
-}
-function resolveReactForRuntime(specifier, version) {
-    // For Bun: Use local React paths from veryfront's node_modules.
-    // Bun handles CJS/ESM interop correctly with file:// URLs.
-    if (!isDeno && !isNode) {
-        const localPath = getLocalReactPaths()[specifier];
-        if (localPath)
-            return localPath;
-        // If not found in local paths, fall through to esm.sh for subpath imports
-    }
-    // For Deno: Use esm.sh URLs (Deno supports HTTP imports natively).
-    // For Node.js: Use esm.sh URLs which will be cached to disk by cacheHttpImportsToLocal.
-    // The cached bundles are ESM-compatible and can be imported via file:// URLs.
-    const v = version ?? DEFAULT_REACT_VERSION;
-    const mapped = getReactImportMap(v)[specifier];
-    if (mapped)
-        return mapped;
-    if (specifier.startsWith("react/")) {
-        const subpath = specifier.slice("react/".length);
-        return `https://esm.sh/react@${v}/${subpath}?external=react&target=es2022`;
-    }
-    if (specifier.startsWith("react-dom/")) {
-        const subpath = specifier.slice("react-dom/".length);
-        return `https://esm.sh/react-dom@${v}/${subpath}?external=react&target=es2022`;
-    }
-    return null;
-}
-function rewriteBareImports(code, version) {
-    const v = version ?? DEFAULT_REACT_VERSION;
-    return code.replace(/from\s+["']([^"'./][^"']*)["']/g, (_match, specifier) => {
-        const bareSpecifier = specifier.startsWith("npm:") ? specifier.slice(4) : specifier;
-        const reactUrl = resolveReactForRuntime(bareSpecifier, v);
-        if (reactUrl)
-            return `from "${reactUrl}"`;
-        if (shouldKeepBareSpecifier(specifier))
-            return `from "${specifier}"`;
-        return `from "https://esm.sh/${bareSpecifier}?external=react&target=es2022"`;
-    });
-}
-function getDefaultCacheBuster(target, options) {
-    return hashString([
-        target.kind,
-        target.modulePath,
-        target.rewrittenPath,
-        options.projectSlug ?? "",
-        options.branch ?? "",
-        options.crossProjectRef ?? "",
-        options.reactVersion ?? "",
-    ].join("\0"));
-}
-function getCacheBusterSync(target, options) {
-    if (options.cacheBuster !== undefined)
-        return String(options.cacheBuster);
-    return getDefaultCacheBuster(target, options);
-}
-async function getCacheBusterAsync(target, options) {
-    if (options.cacheBuster !== undefined)
-        return String(options.cacheBuster);
-    const resolved = await options.resolveCacheBuster?.(target);
-    if (resolved !== undefined && resolved !== null)
-        return String(resolved);
-    return getDefaultCacheBuster(target, options);
-}
-function buildAliasRewrite(specifierPath, options) {
-    const { crossProjectRef } = options;
-    const jsPath = specifierPath.endsWith(".js") ? specifierPath : `${specifierPath}.js`;
-    if (crossProjectRef) {
-        const rewrittenPath = `/_vf_modules/_cross/${crossProjectRef}/@/${jsPath}`;
-        return {
-            target: {
-                specifier: `@/${specifierPath}`,
-                kind: "alias",
-                modulePath: jsPath,
-                rewrittenPath,
-            },
-            prefix: `${rewrittenPath}?ssr=true`,
-        };
-    }
-    const rewrittenPath = `/_vf_modules/${jsPath}`;
-    return {
-        target: {
-            specifier: `@/${specifierPath}`,
-            kind: "alias",
-            modulePath: jsPath,
-            rewrittenPath,
-        },
-        prefix: `${rewrittenPath}?ssr=true`,
-    };
-}
-function buildRelativeRewrite(specifier) {
-    return {
-        target: {
-            specifier,
-            kind: "relative",
-            modulePath: specifier,
-            rewrittenPath: specifier,
-        },
-        prefix: `${specifier}?ssr=true`,
-    };
-}
-function buildScopedParams(options) {
-    const projectParam = options.projectSlug ? `&project=${options.projectSlug}` : "";
-    const branchParam = options.branch ? `&branch=${options.branch}` : "";
-    return `${projectParam}${branchParam}`;
-}
-function rewritePathAliases(code, options) {
-    const scopedParams = buildScopedParams(options);
-    return code.replace(/from\s+["']@\/([^"']+)["']/g, (_match, path) => {
-        const { target, prefix } = buildAliasRewrite(path, options);
-        const cacheBuster = getCacheBusterSync(target, options);
-        return `from "${prefix}${scopedParams}&v=${cacheBuster}"`;
-    });
-}
-function rewriteRelativeImports(code, options) {
-    const scopedParams = buildScopedParams(options);
-    return code.replace(/from\s+["']((?:\.\.?\/|\/)[^"']+\.js)["']/g, (_match, path) => {
-        const { target, prefix } = buildRelativeRewrite(path);
-        const cacheBuster = getCacheBusterSync(target, options);
-        return `from "${prefix}${scopedParams}&v=${cacheBuster}"`;
-    });
-}
-export function applySSRImportRewrites(code, options = {}) {
-    let result = rewriteBareImports(code, options.reactVersion);
-    result = rewritePathAliases(result, options);
-    result = rewriteRelativeImports(result, options);
-    return result;
-}
-async function replaceAsync(code, pattern, replacer) {
-    const chunks = [];
-    let lastIndex = 0;
-    pattern.lastIndex = 0;
-    for (let match = pattern.exec(code); match; match = pattern.exec(code)) {
-        chunks.push(code.slice(lastIndex, match.index));
-        chunks.push(await replacer(match));
-        lastIndex = match.index + match[0].length;
-    }
-    chunks.push(code.slice(lastIndex));
-    return chunks.join("");
-}
-async function rewritePathAliasesAsync(code, options) {
-    const scopedParams = buildScopedParams(options);
-    return await replaceAsync(code, /from\s+["']@\/([^"']+)["']/g, async (match) => {
-        const path = match[1] ?? "";
-        const { target, prefix } = buildAliasRewrite(path, options);
-        const cacheBuster = await getCacheBusterAsync(target, options);
-        return `from "${prefix}${scopedParams}&v=${cacheBuster}"`;
-    });
-}
-async function rewriteRelativeImportsAsync(code, options) {
-    const scopedParams = buildScopedParams(options);
-    return await replaceAsync(code, /from\s+["']((?:\.\.?\/|\/)[^"']+\.js)["']/g, async (match) => {
-        const path = match[1] ?? "";
-        const { target, prefix } = buildRelativeRewrite(path);
-        const cacheBuster = await getCacheBusterAsync(target, options);
-        return `from "${prefix}${scopedParams}&v=${cacheBuster}"`;
-    });
-}
-export async function applySSRImportRewritesAsync(code, options = {}) {
-    let result = rewriteBareImports(code, options.reactVersion);
-    result = await rewritePathAliasesAsync(result, options);
-    result = await rewriteRelativeImportsAsync(result, options);
-    return result;
-}
+export { resolveSSRImportTargetModulePathCompat as resolveSSRImportTargetModulePath, rewriteSSRImportsCompat as applySSRImportRewrites, rewriteSSRImportsCompatAsync as applySSRImportRewritesAsync, stripSSRModuleJsExtensionCompat as stripSSRModuleJsExtension, } from "../../transforms/import-rewriter/ssr-adapter.js";

package/esm/src/react/runtime/core.d.ts

@@ -77,6 +77,28 @@ export interface PageContextProviderProps {
     /** Page context value to expose to descendants. */
     pageContext?: PageContextValue;
 }
+/** How a navigation should affect the history stack. */
+type HistoryMode = "push" | "replace" | "none";
+/** Options accepted by the navigation store's `navigate`. */
+interface NavigateOptions {
+    history?: HistoryMode;
+}
+/**
+ * The cross-bundle navigation store the client router and this React runtime
+ * share. This is an inline mirror of `rendering/client/navigation-store.ts`,
+ * kept here so the public React runtime bundle does not import the rendering
+ * layer. The shared `Symbol.for` key guarantees both bundles resolve the *same*
+ * runtime object regardless of which one evaluates first — so `RouterProvider`
+ * can subscribe synchronously on its first render, with no boot-order race.
+ */
+interface NavigationStore {
+    subscribe(listener: () => void): () => void;
+    getHref(): string;
+    notify(): void;
+    navigate(href: string, options?: NavigateOptions): Promise<void>;
+    setNavigator(navigator: (href: string, options?: NavigateOptions) => Promise<void>): void;
+}
+export declare function getNavigationStore(): NavigationStore;
 /**
  * Provides the router context. `pathname`/`query` track the live URL through the
  * shared navigation store's `useSyncExternalStore` surface; `params`/`domain`

package/esm/src/react/runtime/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/src/react/runtime/core.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/src/react/runtime/core.ts"],"names":[],"mappings":"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"}

package/esm/src/react/runtime/core.js

@@ -50,7 +50,7 @@ function collectHead(data) {
     collector?.(data);
 }
 const NAVIGATION_STORE_KEY = Symbol.for("veryfront.navigation.store.v1");
-function getNavigationStore() {
+export function getNavigationStore() {
     const holder = globalThis;
     const existing = holder[NAVIGATION_STORE_KEY];
     if (existing)

package/esm/src/rendering/orchestrator/module-collection.d.ts

@@ -17,6 +17,14 @@ export declare const MODULE_LOAD_HARD_TIMEOUT_MS = 45000;
 export declare const DATA_FETCH_TIMEOUT_MS = 15000;
 /** Timeout for SSR rendering stage */
 export declare const SSR_RENDER_TIMEOUT_MS = 20000;
+/**
+ * Human-readable label for the module-loading timeout.
+ *
+ * Falls back to the route pathname when the slug is empty — the index route's
+ * slug is `""`, which otherwise produced a blank timeout label
+ * (`"Module loading for "`) that named no route when a cold load stalled.
+ */
+export declare function moduleLoadLabel(slug: string, pathname: string): string;
 /** Module to load for data fetching */
 export interface ModuleToLoad {
     type: "page" | "layout";

package/esm/src/rendering/orchestrator/module-collection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-collection.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/module-collection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mGAAmG;AACnG,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,+DAA+D;AAC/D,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,sCAAsC;AACtC,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,OAAO,EACxB,iBAAiB,EAAE,OAAO,EAC1B,aAAa,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7D,YAAY,EAAE,CAchB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAI7D"}
+{"version":3,"file":"module-collection.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/module-collection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mGAAmG;AACnG,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,+DAA+D;AAC/D,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,sCAAsC;AACtC,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,OAAO,EACxB,iBAAiB,EAAE,OAAO,EAC1B,aAAa,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7D,YAAY,EAAE,CAchB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAI7D"}