@nifrajs/web-svelte 2.10.0 → 2.12.0

package/dist/Router.svelte

@@ -9,10 +9,20 @@
   reactive root is a component, not a function in `client.ts`.
 -->
 <script>
-  import { searchOfChain } from "@nifrajs/web"
+  // `/client`, not the package root: the root's module graph reaches server-only code (the public-dir
+  // reader and friends), and a bundler that externalizes node builtins for the browser turns that into
+  // a runtime `Module "node:fs/promises" has been externalized` on the first import. `/client` is the
+  // browser-safe half, and it is where every other adapter takes this from.
+  import { searchOfChain } from "@nifrajs/web/client"
   import Chain from "./Chain.svelte"
   let { router, routes, searchSchemas } = $props()
 
+  // Capturing the INITIAL `router` is the intent, not an oversight: one router instance is created
+  // once per page and mounted here, so it never changes identity for this component's lifetime, and
+  // the reactivity that matters is the subscription below - the store pushes, this does not re-read.
+  // Wrapping it in a `$derived` would re-run `snapshot()` and hand `$state` a fresh object on every
+  // change, discarding the very state the subscription is maintaining.
+  // svelte-ignore state_referenced_locally
   let snapshot = $state(router.snapshot())
   $effect(() => router.subscribe(() => { snapshot = router.snapshot() }))
 

package/dist/client.d.ts

@@ -1,7 +1,15 @@
 import type { MountRouterOptions, RenderProps } from "@nifrajs/web";
 export { errorBoundary } from "./error.js";
 /** Hydrate a server-rendered Svelte layout `chain` (with the loader `props`) inside `container`. */
-export declare function hydrate(chain: readonly unknown[], props: RenderProps, container: unknown): void;
+export interface HydrationAssuranceOptions {
+    readonly onWarning?: (message: string) => void;
+}
+export declare function hydrate(chain: readonly unknown[], props: RenderProps, container: unknown, options?: HydrationAssuranceOptions): void;
+/** Testing hook used by verification runners to observe Svelte warnings and identity. */
+export declare const hydrationAssuranceHook: Readonly<{
+    framework: "svelte";
+    runtimeIdentity: () => object;
+}>;
 /**
  * Hydrate a stateful Svelte Router. The `Router` component holds the store snapshot in `$state` and
  * re-renders the matched layout chain on each store change - so client navigations swap routes without

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAenE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,oGAAoG;AACpG,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAK/F;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAI7D"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAenE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,oGAAoG;AACpG,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/C;AAWD,wBAAgB,OAAO,CACrB,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE,yBAAyB,GAClC,IAAI,CAYN;AAED,yFAAyF;AACzF,eAAO,MAAM,sBAAsB;;2BAEZ,MAAM;EAC3B,CAAA;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAc7D"}

package/dist/client.js

@@ -12,13 +12,34 @@ import Router from "./Router.svelte";
 // The `_error` boundary marker - Chain.svelte renders it as a <svelte:boundary>. Re-exported here so
 // nifra's client codegen resolves it from `@nifrajs/web-svelte/client` alongside `mountRouter`.
 export { errorBoundary } from "./error.js";
-/** Hydrate a server-rendered Svelte layout `chain` (with the loader `props`) inside `container`. */
-export function hydrate(chain, props, container) {
-    svelteHydrate(Chain, {
-        target: container,
-        props: { chain, props, layoutData: props.layoutData },
-    });
+function assuranceWarning() {
+    const value = globalThis[Symbol.for("nifra.hydration.assurance")];
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const callback = value.onWarning;
+    return typeof callback === "function" ? callback : undefined;
 }
+export function hydrate(chain, props, container, options) {
+    const warning = options?.onWarning ?? assuranceWarning();
+    const originalWarn = console.warn;
+    if (warning !== undefined)
+        console.warn = (...args) => warning(args.map(String).join(" "));
+    try {
+        svelteHydrate(Chain, {
+            target: container,
+            props: { chain, props, layoutData: props.layoutData },
+        });
+    }
+    finally {
+        if (warning !== undefined)
+            console.warn = originalWarn;
+    }
+}
+/** Testing hook used by verification runners to observe Svelte warnings and identity. */
+export const hydrationAssuranceHook = Object.freeze({
+    framework: "svelte",
+    runtimeIdentity: () => svelteHydrate,
+});
 /**
  * Hydrate a stateful Svelte Router. The `Router` component holds the store snapshot in `$state` and
  * re-renders the matched layout chain on each store change - so client navigations swap routes without
@@ -28,6 +49,19 @@ export function hydrate(chain, props, container) {
 export function mountRouter(options) {
     const { router, routes, searchSchemas, container } = options;
     setMountedRouter(router); // expose it to useFetcher/useFetchers (same page, client-only)
-    svelteHydrate(Router, { target: container, props: { router, routes, searchSchemas } });
+    const warning = assuranceWarning();
+    const originalWarn = console.warn;
+    if (warning !== undefined)
+        console.warn = (...args) => warning(args.map(String).join(" "));
+    try {
+        svelteHydrate(Router, {
+            target: container,
+            props: { router, routes, searchSchemas },
+        });
+    }
+    finally {
+        if (warning !== undefined)
+            console.warn = originalWarn;
+    }
 }
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,KAAK,MAAM,gBAAgB,CAAA;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,MAAM,MAAM,iBAAiB,CAAA;AAEpC,qGAAqG;AACrG,gGAAgG;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,oGAAoG;AACpG,MAAM,UAAU,OAAO,CAAC,KAAyB,EAAE,KAAkB,EAAE,SAAkB;IACvF,aAAa,CAAC,KAAK,EAAE;QACnB,MAAM,EAAE,SAAoB;QAC5B,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;KACtD,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,OAAO,CAAA;IAC5D,gBAAgB,CAAC,MAAM,CAAC,CAAA,CAAC,+DAA+D;IACxF,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,SAAoB,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,CAAC,CAAA;AACnG,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,KAAK,MAAM,gBAAgB,CAAA;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,MAAM,MAAM,iBAAiB,CAAA;AAEpC,qGAAqG;AACrG,gGAAgG;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAO1C,SAAS,gBAAgB;IACvB,MAAM,KAAK,GAAI,UAAsD,CACnE,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CACxC,CAAA;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAA;IACjE,MAAM,QAAQ,GAAI,KAAiC,CAAC,SAAS,CAAA;IAC7D,OAAO,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAE,QAAsC,CAAC,CAAC,CAAC,SAAS,CAAA;AAC7F,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,KAAyB,EACzB,KAAkB,EAClB,SAAkB,EAClB,OAAmC;IAEnC,MAAM,OAAO,GAAG,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,CAAA;IACxD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAA;IACjC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC1F,IAAI,CAAC;QACH,aAAa,CAAC,KAAK,EAAE;YACnB,MAAM,EAAE,SAAoB;YAC5B,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;SACtD,CAAC,CAAA;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,YAAY,CAAA;IACxD,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC;IAClD,SAAS,EAAE,QAAiB;IAC5B,eAAe,EAAE,GAAW,EAAE,CAAC,aAAa;CAC7C,CAAC,CAAA;AAEF;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,OAAO,CAAA;IAC5D,gBAAgB,CAAC,MAAM,CAAC,CAAA,CAAC,+DAA+D;IACxF,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAA;IAClC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAA;IACjC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC1F,IAAI,CAAC;QACH,aAAa,CAAC,MAAM,EAAE;YACpB,MAAM,EAAE,SAAoB;YAC5B,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE;SACzC,CAAC,CAAA;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,YAAY,CAAA;IACxD,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -1,11 +1,3 @@
-/**
- * @nifrajs/web-svelte - the Svelte 5 render adapter for @nifrajs/web (server side) + the `.svelte` compiler
- * Bun-plugin. SSR via Svelte's `render` (svelte/server), which returns HTML strings (Svelte SSR is
- * string-based, not a stream), wrapped in a one-chunk Web `ReadableStream` (the seam's shape). The
- * layout-chain fold is the recursive `Chain.svelte`. Client hydration lives in `@nifrajs/web-svelte/client`.
- * Svelte components compile from `.svelte` files, so this adapter ships a build plugin (like
- * `@nifrajs/web-solid`'s Babel plugin) - there is no callable-component runtime.
- */
 import type { RenderAdapter } from "@nifrajs/web";
 export { svelteBunPlugin } from "./plugin.js";
 /** The Svelte server render adapter - pass to @nifrajs/web's `renderPage`. */

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAOjD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAa7C,8EAA8E;AAC9E,eAAO,MAAM,aAAa,EAAE,aAqB3B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,cAAc,CAAA;AAM9D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAgF7C,8EAA8E;AAC9E,eAAO,MAAM,aAAa,EAAE,aA8B3B,CAAA"}

package/dist/index.js

@@ -1,9 +1,49 @@
-import { render } from "svelte/server";
-import Chain from "./Chain.svelte";
-// Re-export the compiler plugin for convenience. NOTE: the SSR preload must import it from
-// `@nifrajs/web-svelte/plugin` (not from here) - importing this module eagerly loads `Chain.svelte`,
-// which must be compiled by the already-registered plugin.
+/**
+ * @nifrajs/web-svelte - the Svelte 5 render adapter for @nifrajs/web (server side) + the `.svelte` compiler
+ * Bun-plugin. SSR via Svelte's `render` (svelte/server), which returns HTML strings (Svelte SSR is
+ * string-based, not a stream), wrapped in a one-chunk Web `ReadableStream` (the seam's shape). The
+ * layout-chain fold is the recursive `Chain.svelte`. Client hydration lives in `@nifrajs/web-svelte/client`.
+ * Svelte components compile from `.svelte` files, so this adapter ships a build plugin (like
+ * `@nifrajs/web-solid`'s Babel plugin) - there is no callable-component runtime.
+ */
+import { fileURLToPath } from "node:url";
+import { ssrModuleLoader } from "@nifrajs/web";
+import { render as runtimeRender } from "svelte/server";
+// Re-export the compiler plugin for convenience.
 export { svelteBunPlugin } from "./plugin.js";
+let chainComponent;
+let chainPromise;
+/**
+ * Svelte's server renderer. Normally the runtime's, but it is swapped for the dev server's copy when
+ * `Chain` comes from there - a component compiled by one toolchain has to render through the renderer
+ * that toolchain resolved, or `setContext` writes into a renderer the children never read.
+ */
+let render = runtimeRender;
+/** Resolved `Chain`, or the in-flight load on the very first call. */
+const loadChain = () => {
+    if (chainComponent !== undefined)
+        return chainComponent;
+    // A dev server that owns SSR resolution compiles the app's `.svelte` routes itself, and `Chain` has
+    // to come from that same graph: the runtime has no `.svelte` loader on that pipeline, so a plain
+    // `import` yields the file PATH and SSR dies at `component is not a function`. Registering a second
+    // compiler in the runtime instead is the trap - it gives the tree two Svelte runtimes, and the
+    // renderer `Chain` sets context on is not the one the routes read it from. Taking BOTH the component
+    // and `svelte/server` from the dev server keeps it at one compiler and one runtime.
+    const load = ssrModuleLoader();
+    chainPromise ??= (load !== undefined
+        ? Promise.all([
+            load(fileURLToPath(new URL("./Chain.svelte", import.meta.url))),
+            load("svelte/server"),
+        ]).then(([mod, server]) => {
+            render = server.render;
+            return mod.default;
+        })
+        : import("./Chain.svelte").then((m) => m.default)).then((c) => {
+        chainComponent = c;
+        return c;
+    });
+    return chainPromise;
+};
 // Svelte SSR yields a complete HTML string; the seam wants a stream, so emit it as one chunk.
 function oneChunk(html) {
     const bytes = new TextEncoder().encode(html);
@@ -20,16 +60,25 @@ export const svelteAdapter = {
     // returns the body directly (renderPage buffers it on the non-deferred fast path), and
     // `renderToStream` wraps the same string in a one-chunk stream for the deferred path. No streaming
     // renderer to skip here - but going straight to a string avoids the per-request stream allocation.
+    // The seam allows `string | Promise<string>`, so the first render can resolve `Chain` while every
+    // render after it stays a plain synchronous call - see `loadChain`.
     renderToString(chain, props) {
-        return render(Chain, { props: { chain, props, layoutData: props.layoutData } }).body;
+        const Chain = loadChain();
+        const props$ = { chain, props, layoutData: props.layoutData };
+        return Chain instanceof Promise
+            ? Chain.then((C) => render(C, { props: props$ }).body)
+            : render(Chain, { props: props$ }).body;
     },
     renderToStream(chain, props) {
         // `Chain` folds the layout chain (page innermost gets `props`; layouts wrap via their `children`
         // snippet). Svelte's `render` returns { head, body }; the body goes into #root. (Svelte's dynamic
         // `head` - from <svelte:head> - isn't surfaced through the seam's static `hydrationHead`; nifra's
         // own meta/head API manages the document head instead.)
-        const { body } = render(Chain, { props: { chain, props, layoutData: props.layoutData } });
-        return oneChunk(body);
+        const Chain = loadChain();
+        const props$ = { chain, props, layoutData: props.layoutData };
+        return Chain instanceof Promise
+            ? Chain.then((C) => oneChunk(render(C, { props: props$ }).body))
+            : oneChunk(render(Chain, { props: props$ }).body);
     },
     // Svelte's client `hydrate` reconciles against the existing DOM; no per-document bootstrap script is
     // needed (contrast Solid's generateHydrationScript) - the seam allows the empty string.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,KAAK,MAAM,gBAAgB,CAAA;AAElC,2FAA2F;AAC3F,qGAAqG;AACrG,2DAA2D;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C,8FAA8F;AAC9F,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC5C,OAAO,IAAI,cAAc,CAAC;QACxB,KAAK,CAAC,UAAU;YACd,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YACzB,UAAU,CAAC,KAAK,EAAE,CAAA;QACpB,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,kGAAkG;IAClG,uFAAuF;IACvF,mGAAmG;IACnG,mGAAmG;IACnG,cAAc,CAAC,KAAK,EAAE,KAAK;QACzB,OAAO,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,CAAA;IACtF,CAAC;IACD,cAAc,CAAC,KAAK,EAAE,KAAK;QACzB,iGAAiG;QACjG,kGAAkG;QAClG,kGAAkG;QAClG,wDAAwD;QACxD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;QACzF,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;IACD,qGAAqG;IACrG,wFAAwF;IACxF,aAAa;QACX,OAAO,EAAE,CAAA;IACX,CAAC;CACF,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/mdx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mdx.d.ts","sourceRoot":"","sources":["../src/mdx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAsBpC;uFACuF;AACvF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CA+CrE"}
+{"version":3,"file":"mdx.d.ts","sourceRoot":"","sources":["../src/mdx.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAsBpC;uFACuF;AACvF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CA+CrE"}

package/dist/mdx.js

@@ -6,6 +6,7 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     }
     return path;
 };
+import { rewriteSsrImports } from "@nifrajs/web/plugins/kit";
 import { compile } from "svelte/compiler";
 /**
  * `@nifrajs/web-svelte/mdx` - compile `.mdx` routes/files to **Svelte** components. Svelte has no JSX
@@ -58,7 +59,7 @@ export function svelteMdxBunPlugin(generate) {
                         loader: "js",
                     };
                 }
-                return { contents: js.code, loader: "js" };
+                return { contents: rewriteSsrImports(js.code, path, generate), loader: "js" };
             });
             build.onResolve({ filter: /\?svelte-mdx-css$/ }, (args) => ({
                 path: args.path,

package/dist/mdx.js.map

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

package/dist/plugin.d.ts

@@ -1,3 +1,27 @@
 import type { BunPlugin } from "bun";
+/**
+ * The same hot-patch boundary as the Bun pipeline's, in the shape `@sveltejs/vite-plugin-svelte` takes:
+ *
+ * ```ts
+ * svelte({ dynamicCompileOptions: svelteHmrBoundary })
+ * ```
+ *
+ * Svelte's HMR wrapper resolves the component through a signal, which survives hydration only where
+ * the component is a plain child in a template. A layout or a page is not: the adapter's `Chain` enters
+ * chain members as dynamic components and through snippets, so a wrapper on one leaves the hydration
+ * cursor pointing at markup the wrapped component never claims. Svelte then throws the server's tree
+ * away and re-renders on the client - `hydration_mismatch` in the console, on first load, before any
+ * edit. Left on, the dev server quietly stops exercising hydration at all.
+ *
+ * Views keep hot-patching; route modules fall back to a full reload, which is what they want anyway
+ * (a route module carries the loader and meta the server ran, and re-running those is a navigation).
+ * Outside a nifra dev server nothing is announced and the answer is "no boundary" - a full reload is
+ * always correct, a mispatched tree is not.
+ */
+export declare function svelteHmrBoundary({ filename }: {
+    filename: string;
+}): {
+    hmr: boolean;
+};
 export declare function svelteBunPlugin(generate: "dom" | "ssr"): BunPlugin;
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAsBpC,wBAAgB,eAAe,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAqClE"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAsBpC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,CAEtF;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CA8DlE"}

package/dist/plugin.js

@@ -1,3 +1,4 @@
+import { devHotComponent, devServerCompile, rewriteSsrImports } from "@nifrajs/web/plugins/kit";
 import { compile } from "svelte/compiler";
 /**
  * `@nifrajs/web-svelte/plugin` - the `.svelte` compiler Bun-plugin, in its OWN module (no `.svelte`
@@ -17,6 +18,28 @@ import { compile } from "svelte/compiler";
  */
 const STYLE_SUFFIX = "?svelte-css";
 const STYLE_NS = "nifra-svelte-css";
+/**
+ * The same hot-patch boundary as the Bun pipeline's, in the shape `@sveltejs/vite-plugin-svelte` takes:
+ *
+ * ```ts
+ * svelte({ dynamicCompileOptions: svelteHmrBoundary })
+ * ```
+ *
+ * Svelte's HMR wrapper resolves the component through a signal, which survives hydration only where
+ * the component is a plain child in a template. A layout or a page is not: the adapter's `Chain` enters
+ * chain members as dynamic components and through snippets, so a wrapper on one leaves the hydration
+ * cursor pointing at markup the wrapped component never claims. Svelte then throws the server's tree
+ * away and re-renders on the client - `hydration_mismatch` in the console, on first load, before any
+ * edit. Left on, the dev server quietly stops exercising hydration at all.
+ *
+ * Views keep hot-patching; route modules fall back to a full reload, which is what they want anyway
+ * (a route module carries the loader and meta the server ran, and re-running those is a navigation).
+ * Outside a nifra dev server nothing is announced and the answer is "no boundary" - a full reload is
+ * always correct, a mispatched tree is not.
+ */
+export function svelteHmrBoundary({ filename }) {
+    return { hmr: devHotComponent(filename) };
+}
 export function svelteBunPlugin(generate) {
     // Compiled scoped CSS per `.svelte` file (client build only) - read back by the virtual-module loader.
     const cssByPath = new Map();
@@ -28,10 +51,35 @@ export function svelteBunPlugin(generate) {
             build.onLoad({ filter: /\.svelte(\?|$)/ }, async (args) => {
                 const path = args.path.split("?")[0] ?? args.path;
                 const source = await Bun.file(path).text();
+                // Per compile, not per registration: the CLI registers the SSR plugin before the dev server
+                // exists, and the flag is set by the dev server.
+                //
+                // Svelte's HMR is a compiler feature (`$.hmr` + a self-accepting `import.meta.hot.accept`), and
+                // it is only available under `dev`. `dev` is set on BOTH halves so the server and client builds
+                // stay the same Svelte, while `hmr` stays client-only, there being no `import.meta.hot` on the
+                // server. `nifra build` sets neither, so nothing here reaches a production bundle.
+                //
+                // The server half additionally needs Svelte's own runtime in its dev shape - `dev` output calls
+                // `push_element`, which reads state the runtime only records when ITS `DEV` is true. That flag
+                // resolves through `esm-env`, which falls back to `NODE_ENV` off the export conditions; the dev
+                // server sets it for exactly this reason. Getting that half wrong throws on the first element:
+                // `undefined is not an object (evaluating 'context.function[FILENAME]')`.
+                //
+                // `hmr` narrows further, to the app's own non-route components ({@link devHotComponent}).
+                // Svelte's wrapper replaces the component with a block that resolves it through a signal, and
+                // that survives hydration only where the component is a plain child in a template. A chain
+                // member is not: the adapter's `Chain` enters layouts and pages as dynamic components and
+                // through snippets, and a wrapper on either side of that leaves the hydration cursor pointing
+                // at markup the wrapped component never claims - the whole tree is then thrown away and
+                // re-rendered on the client, silently, before any edit. A view component is the boundary that
+                // works, and it is also the one worth patching.
+                const dev = devServerCompile();
                 const { js, css } = compile(source, {
                     generate: generate === "ssr" ? "server" : "client",
                     filename: path,
                     css: "external", // emit the scoped stylesheet separately (not injected into the JS)
+                    dev,
+                    hmr: dev && generate === "dom" && devHotComponent(path),
                 });
                 if (generate === "dom" && css?.code) {
                     cssByPath.set(path, css.code);
@@ -41,7 +89,7 @@ export function svelteBunPlugin(generate) {
                         loader: "js",
                     };
                 }
-                return { contents: js.code, loader: "js" };
+                return { contents: rewriteSsrImports(js.code, path, generate), loader: "js" };
             });
             // Virtual CSS module: `<file>.svelte?svelte-css` → the compiled scoped stylesheet (css loader).
             build.onResolve({ filter: /\?svelte-css$/ }, (args) => ({

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAEzC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,YAAY,GAAG,aAAa,CAAA;AAClC,MAAM,QAAQ,GAAG,kBAAkB,CAAA;AAEnC,MAAM,UAAU,eAAe,CAAC,QAAuB;IACrD,uGAAuG;IACvG,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAA;IAC3C,OAAO;QACL,IAAI,EAAE,gBAAgB,QAAQ,EAAE;QAChC,KAAK,CAAC,KAAK;YACT,6FAA6F;YAC7F,qDAAqD;YACrD,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAA;gBACjD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;gBAC1C,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE;oBAClC,QAAQ,EAAE,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;oBAClD,QAAQ,EAAE,IAAI;oBACd,GAAG,EAAE,UAAU,EAAE,mEAAmE;iBACrF,CAAC,CAAA;gBACF,IAAI,QAAQ,KAAK,KAAK,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC;oBACpC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;oBAC7B,+FAA+F;oBAC/F,OAAO;wBACL,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI;wBACvE,MAAM,EAAE,IAAI;qBACb,CAAA;gBACH,CAAC;gBACD,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;YAC5C,CAAC,CAAC,CAAA;YACF,gGAAgG;YAChG,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACtD,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,SAAS,EAAE,QAAQ;aACpB,CAAC,CAAC,CAAA;YACH,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC7D,QAAQ,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;gBACvE,MAAM,EAAE,KAAK;aACd,CAAC,CAAC,CAAA;QACL,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}

package/dist/query.d.ts

@@ -1,4 +1,4 @@
-import { type QueryClient, type QueryState } from "@nifrajs/web";
+import type { QueryClient, QueryState } from "@nifrajs/web";
 /**
  * `@nifrajs/web-svelte/query` - Svelte bindings for the keyed query-cache, as **Svelte stores** (plain
  * `.ts`). `useQuery(key, fn)` returns a `Readable<QueryState<T>>` augmented with `refetch` - read it

package/dist/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAA;AACrB;;;;;;;;;;GAUG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,cAAc,CAAA;AAStD,wGAAwG;AACxG,wBAAgB,cAAc,IAAI,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAEvE;AAWD,gFAAgF;AAChF,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG;IACpD,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAA;CACnC,CAAA;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAe7E"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,UAAU,EAAE,MAAM,cAAc,CAAA;AAIxE;;;;;;;;;;GAUG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,cAAc,CAAA;AAStD,wGAAwG;AACxG,wBAAgB,cAAc,IAAI,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAEvE;AAWD,gFAAgF;AAChF,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG;IACpD,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAA;CACnC,CAAA;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAe7E"}

package/dist/query.js

@@ -1,4 +1,6 @@
-import { createQueryClient, } from "@nifrajs/web";
+// `/client`, not the root - these are DOM values, and the root's graph carries the
+// server, which Vite's dev server evaluates rather than tree-shakes.
+import { createQueryClient } from "@nifrajs/web/client";
 /**
  * `@nifrajs/web-svelte/query` - Svelte bindings for the keyed query-cache, as **Svelte stores** (plain
  * `.ts`). `useQuery(key, fn)` returns a `Readable<QueryState<T>>` augmented with `refetch` - read it

package/dist/query.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAIlB,MAAM,cAAc,CAAA;AACrB;;;;;;;;;;GAUG;AACH,OAAO,EAAiB,QAAQ,EAAE,MAAM,cAAc,CAAA;AAEtD,IAAI,MAA+B,CAAA;AACnC,SAAS,SAAS;IAChB,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,SAAS,CAAA,CAAC,wCAAwC;IAC5F,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,GAAG,iBAAiB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IAC/E,OAAO,MAAM,CAAA;AACf,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,cAAc;IAC5B,OAAO,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAA;AACvD,CAAC;AAED,0DAA0D;AAC1D,MAAM,IAAI,GAAsB,MAAM,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,MAAM,CAAC,iBAAiB;CACpC,CAAC,CAAA;AAQF;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAI,GAAY,EAAE,EAAoB;IAC5D,MAAM,MAAM,GAA+B,SAAS,EAAE,EAAE,KAAK,CAAI,GAAG,EAAE,EAAE,CAAC,CAAA;IACzE,MAAM,KAAK,GAAG,QAAQ,CAAgB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;QAC/E,IAAI,MAAM,KAAK,SAAS;YAAE,OAAM;QAChC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;QACtB,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;QAClE,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA,CAAC,iDAAiD;QAChF,OAAO,WAAW,CAAA;IACpB,CAAC,CAAC,CAAA;IACF,MAAM,OAAO,GAAG,MAAM;QACpB,CAAC,CAAC,MAAM,CAAC,OAAO;QAChB,CAAC,CAAE,CAAC,KAAK,IAAI,EAAE;YACX,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAA;QAC9F,CAAC,CAAsB,CAAA;IAC3B,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;AAC1C,CAAC"}
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AACA,mFAAmF;AACnF,qEAAqE;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD;;;;;;;;;;GAUG;AACH,OAAO,EAAiB,QAAQ,EAAE,MAAM,cAAc,CAAA;AAEtD,IAAI,MAA+B,CAAA;AACnC,SAAS,SAAS;IAChB,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,SAAS,CAAA,CAAC,wCAAwC;IAC5F,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,GAAG,iBAAiB,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IAC/E,OAAO,MAAM,CAAA;AACf,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,cAAc;IAC5B,OAAO,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAA;AACvD,CAAC;AAED,0DAA0D;AAC1D,MAAM,IAAI,GAAsB,MAAM,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,MAAM,CAAC,iBAAiB;CACpC,CAAC,CAAA;AAQF;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAI,GAAY,EAAE,EAAoB;IAC5D,MAAM,MAAM,GAA+B,SAAS,EAAE,EAAE,KAAK,CAAI,GAAG,EAAE,EAAE,CAAC,CAAA;IACzE,MAAM,KAAK,GAAG,QAAQ,CAAgB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;QAC/E,IAAI,MAAM,KAAK,SAAS;YAAE,OAAM;QAChC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;QACtB,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;QAClE,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA,CAAC,iDAAiD;QAChF,OAAO,WAAW,CAAA;IACpB,CAAC,CAAC,CAAA;IACF,MAAM,OAAO,GAAG,MAAM;QACpB,CAAC,CAAC,MAAM,CAAC,OAAO;QAChB,CAAC,CAAE,CAAC,KAAK,IAAI,EAAE;YACX,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAA;QAC9F,CAAC,CAAsB,CAAA;IAC3B,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;AAC1C,CAAC"}

package/dist/router.d.ts

@@ -1,5 +1,5 @@
 import type { InferOutput, StandardSchemaV1 } from "@nifrajs/core/server";
-import { type Blocker, type BlockerFunction, type NavigateFunction } from "@nifrajs/web";
+import type { Blocker, BlockerFunction, BlockerState, NavigateFunction } from "@nifrajs/web";
 /**
  * `@nifrajs/web-svelte/router` - Svelte routing bindings over the agnostic `@nifrajs/web` history layer,
  * as plain `.ts` (no runes/compiler needed): `useNavigate` (programmatic navigation), `useBlocker` (the
@@ -9,7 +9,7 @@ import { type Blocker, type BlockerFunction, type NavigateFunction } from "@nifr
  * context on SSR + client alike. Idle before hydration (native `<a>` navigation still works). SSR-safe.
  */
 import { type Readable } from "svelte/store";
-export type { Blocker, BlockerFunction, BlockerState, NavigateFunction } from "@nifrajs/web";
+export type { Blocker, BlockerFunction, BlockerState, NavigateFunction };
 /**
  * The route's typed, validated search params as a reactive accessor - the SAME value the loader received
  * as `ctx.search`. SSR-correct: `Chain.svelte` provides it from the URL server-side and from the

package/dist/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACzE,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,eAAe,EAGpB,KAAK,gBAAgB,EAKtB,MAAM,cAAc,CAAA;AAErB;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,cAAc,CAAA;AAEtD,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAQ5F;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,MAAM,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,KACpD,MAAM,MAAM,SAAS,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzF;AAED;;kCAEkC;AAClC,wBAAgB,WAAW,IAAI,gBAAgB,CAO9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,OAAO,GAAG,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,CAOpF"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAIzE,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EACf,YAAY,EACZ,gBAAgB,EAGjB,MAAM,cAAc,CAAA;AAUrB;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,cAAc,CAAA;AAEtD,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAA;AAQxE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,MAAM,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,KACpD,MAAM,MAAM,SAAS,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzF;AAED;;kCAEkC;AAClC,wBAAgB,WAAW,IAAI,gBAAgB,CAO9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,OAAO,GAAG,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,CAOpF"}

package/dist/router.js

@@ -1,4 +1,6 @@
-import { getBrowserNavigate, IDLE_BLOCKER, registerBlocker, resolveNavigate, } from "@nifrajs/web";
+// `/client`, not the root - these are DOM values, and the root's graph carries the
+// server, which Vite's dev server evaluates rather than tree-shakes.
+import { getBrowserNavigate, IDLE_BLOCKER, registerBlocker, resolveNavigate, } from "@nifrajs/web/client";
 import { getContext } from "svelte";
 /**
  * `@nifrajs/web-svelte/router` - Svelte routing bindings over the agnostic `@nifrajs/web` history layer,

package/dist/router.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,kBAAkB,EAClB,YAAY,EAIZ,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC;;;;;;;GAOG;AACH,OAAO,EAAiB,QAAQ,EAAE,MAAM,cAAc,CAAA;AAItD,uGAAuG;AACvG,oEAAoE;AACpE,MAAM,UAAU,GAAG,4BAA4B,CAAA;AAC/C,MAAM,YAAY,GAAsC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACzE,MAAM,qBAAqB,GAAG,GAA4B,EAAE,CAAC,YAAY,CAAA;AAEzE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS;IAGvB,MAAM,GAAG,GAAG,UAAU,CAA8C,UAAU,CAAC,CAAA;IAC/E,OAAO,CAAC,GAAG,IAAI,qBAAqB,CAET,CAAA;AAC7B,CAAC;AAED;;kCAEkC;AAClC,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,CAAC,EAAyC,EAAE,OAAyB,EAAE,EAAE;QAC/E,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAA;QACrC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAM;QAClC,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IACzC,CAAC,CAAqB,CAAA;AACxB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,WAAsC;IAC/D,OAAO,QAAQ,CAAU,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE,CAC7C,eAAe,CACb,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,EAC/E,GAAG,CACJ,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAYA,mFAAmF;AACnF,qEAAqE;AACrE,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC;;;;;;;GAOG;AACH,OAAO,EAAiB,QAAQ,EAAE,MAAM,cAAc,CAAA;AAItD,uGAAuG;AACvG,oEAAoE;AACpE,MAAM,UAAU,GAAG,4BAA4B,CAAA;AAC/C,MAAM,YAAY,GAAsC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACzE,MAAM,qBAAqB,GAAG,GAA4B,EAAE,CAAC,YAAY,CAAA;AAEzE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS;IAGvB,MAAM,GAAG,GAAG,UAAU,CAA8C,UAAU,CAAC,CAAA;IAC/E,OAAO,CAAC,GAAG,IAAI,qBAAqB,CAET,CAAA;AAC7B,CAAC;AAED;;kCAEkC;AAClC,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,CAAC,EAAyC,EAAE,OAAyB,EAAE,EAAE;QAC/E,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAA;QACrC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAM;QAClC,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IACzC,CAAC,CAAqB,CAAA;AACxB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,WAAsC;IAC/D,OAAO,QAAQ,CAAU,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE,CAC7C,eAAe,CACb,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,EAC/E,GAAG,CACJ,CACF,CAAA;AACH,CAAC"}

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "@nifrajs/web-svelte",
-  "version": "2.10.0",
+  "version": "2.12.0",
   "description": "Svelte 5 render adapter for @nifrajs/web - SSR + hydration + the .svelte compiler Bun-plugin.",
   "keywords": [
     "bun",
     "typescript",
     "nifra",
-    "web-framework",
-    "full-stack",
-    "edge",
-    "ssr"
+    "svelte",
+    "svelte5",
+    "ssr",
+    "hydration",
+    "render-adapter",
+    "full-stack"
   ],
   "type": "module",
   "main": "./dist/index.js",
@@ -98,10 +100,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@nifrajs/core": "2.10.0",
-    "@nifrajs/i18n": "2.10.0",
-    "@nifrajs/image": "2.10.0",
-    "@nifrajs/web": "2.10.0"
+    "@nifrajs/core": "2.12.0",
+    "@nifrajs/i18n": "2.12.0",
+    "@nifrajs/image": "2.12.0",
+    "@nifrajs/web": "2.12.0"
   },
   "peerDependencies": {
     "mdsvex": "^0.12",

package/src/Router.svelte

@@ -9,10 +9,20 @@
   reactive root is a component, not a function in `client.ts`.
 -->
 <script>
-  import { searchOfChain } from "@nifrajs/web"
+  // `/client`, not the package root: the root's module graph reaches server-only code (the public-dir
+  // reader and friends), and a bundler that externalizes node builtins for the browser turns that into
+  // a runtime `Module "node:fs/promises" has been externalized` on the first import. `/client` is the
+  // browser-safe half, and it is where every other adapter takes this from.
+  import { searchOfChain } from "@nifrajs/web/client"
   import Chain from "./Chain.svelte"
   let { router, routes, searchSchemas } = $props()
 
+  // Capturing the INITIAL `router` is the intent, not an oversight: one router instance is created
+  // once per page and mounted here, so it never changes identity for this component's lifetime, and
+  // the reactivity that matters is the subscription below - the store pushes, this does not re-read.
+  // Wrapping it in a `$derived` would re-run `snapshot()` and hand `$state` a fresh object on every
+  // change, discarding the very state the subscription is maintaining.
+  // svelte-ignore state_referenced_locally
   let snapshot = $state(router.snapshot())
   $effect(() => router.subscribe(() => { snapshot = router.snapshot() }))
 

package/src/client.ts

@@ -16,13 +16,44 @@ import Router from "./Router.svelte"
 export { errorBoundary } from "./error.ts"
 
 /** Hydrate a server-rendered Svelte layout `chain` (with the loader `props`) inside `container`. */
-export function hydrate(chain: readonly unknown[], props: RenderProps, container: unknown): void {
-  svelteHydrate(Chain, {
-    target: container as Element,
-    props: { chain, props, layoutData: props.layoutData },
-  })
+export interface HydrationAssuranceOptions {
+  readonly onWarning?: (message: string) => void
 }
 
+function assuranceWarning(): ((message: string) => void) | undefined {
+  const value = (globalThis as unknown as Record<PropertyKey, unknown>)[
+    Symbol.for("nifra.hydration.assurance")
+  ]
+  if (typeof value !== "object" || value === null) return undefined
+  const callback = (value as { onWarning?: unknown }).onWarning
+  return typeof callback === "function" ? (callback as (message: string) => void) : undefined
+}
+
+export function hydrate(
+  chain: readonly unknown[],
+  props: RenderProps,
+  container: unknown,
+  options?: HydrationAssuranceOptions,
+): void {
+  const warning = options?.onWarning ?? assuranceWarning()
+  const originalWarn = console.warn
+  if (warning !== undefined) console.warn = (...args) => warning(args.map(String).join(" "))
+  try {
+    svelteHydrate(Chain, {
+      target: container as Element,
+      props: { chain, props, layoutData: props.layoutData },
+    })
+  } finally {
+    if (warning !== undefined) console.warn = originalWarn
+  }
+}
+
+/** Testing hook used by verification runners to observe Svelte warnings and identity. */
+export const hydrationAssuranceHook = Object.freeze({
+  framework: "svelte" as const,
+  runtimeIdentity: (): object => svelteHydrate,
+})
+
 /**
  * Hydrate a stateful Svelte Router. The `Router` component holds the store snapshot in `$state` and
  * re-renders the matched layout chain on each store change - so client navigations swap routes without
@@ -32,5 +63,15 @@ export function hydrate(chain: readonly unknown[], props: RenderProps, container
 export function mountRouter(options: MountRouterOptions): void {
   const { router, routes, searchSchemas, container } = options
   setMountedRouter(router) // expose it to useFetcher/useFetchers (same page, client-only)
-  svelteHydrate(Router, { target: container as Element, props: { router, routes, searchSchemas } })
+  const warning = assuranceWarning()
+  const originalWarn = console.warn
+  if (warning !== undefined) console.warn = (...args) => warning(args.map(String).join(" "))
+  try {
+    svelteHydrate(Router, {
+      target: container as Element,
+      props: { router, routes, searchSchemas },
+    })
+  } finally {
+    if (warning !== undefined) console.warn = originalWarn
+  }
 }

package/src/index.ts

@@ -6,15 +6,82 @@
  * Svelte components compile from `.svelte` files, so this adapter ships a build plugin (like
  * `@nifrajs/web-solid`'s Babel plugin) - there is no callable-component runtime.
  */
-import type { RenderAdapter } from "@nifrajs/web"
-import { render } from "svelte/server"
-import Chain from "./Chain.svelte"
+import { fileURLToPath } from "node:url"
+import type { RenderAdapter, RenderProps } from "@nifrajs/web"
+import { ssrModuleLoader } from "@nifrajs/web"
+import type { Component } from "svelte"
+import { render as runtimeRender } from "svelte/server"
 
-// Re-export the compiler plugin for convenience. NOTE: the SSR preload must import it from
-// `@nifrajs/web-svelte/plugin` (not from here) - importing this module eagerly loads `Chain.svelte`,
-// which must be compiled by the already-registered plugin.
+// Re-export the compiler plugin for convenience.
 export { svelteBunPlugin } from "./plugin.ts"
 
+/**
+ * `Chain.svelte` is loaded on FIRST RENDER, not at module load.
+ *
+ * A static `import Chain from "./Chain.svelte"` here is unloadable in dev. The CLI's `loadApp` imports
+ * the app's config, which re-exports this adapter, so this module evaluates before any Svelte compiler
+ * is registered in the runtime - and a raw `.svelte` file then loads as a path string, so SSR dies at
+ * render with `component is not a function`, naming the asset rather than the ordering. Bundled builds
+ * never saw it: `Bun.build` compiles the whole graph up front.
+ *
+ * Deferring to first render moves the load AFTER the dev server has registered the app's
+ * `serverPlugins`, which is the only point at which a compiler is guaranteed to exist.
+ *
+ * Exactly ONE render pays for that. `chain` is memoized as a plain value, so every later call takes the
+ * synchronous branch below and allocates no promise - awaiting on the hot path measured as a real 3%
+ * throughput loss on the SSR benchmark, which is not a price worth paying for a one-time import.
+ */
+/**
+ * What `Chain.svelte` destructures from `$props()`.
+ *
+ * A type alias rather than an `interface` on purpose. `.svelte` files are compiled by a bundler, not
+ * by tsc, so they arrive through the ambient shim as `Component<Record<string, unknown>>` and the load
+ * below narrows that to this shape. An interface has no implicit index signature, so that narrowing is
+ * a comparison between two unrelated types and `svelte-check` rejects it; a type alias does have one,
+ * which makes the narrowing legal to state directly instead of laundering it through `unknown`.
+ */
+type ChainProps = {
+  readonly chain: readonly unknown[]
+  readonly props: RenderProps
+  /** Explicitly `| undefined`: the adapter always passes the key, and `RenderProps.layoutData` is
+   * optional, so under `exactOptionalPropertyTypes` the absent case has to be part of the type. */
+  readonly layoutData: readonly unknown[] | undefined
+}
+let chainComponent: Component<ChainProps> | undefined
+let chainPromise: Promise<Component<ChainProps>> | undefined
+/**
+ * Svelte's server renderer. Normally the runtime's, but it is swapped for the dev server's copy when
+ * `Chain` comes from there - a component compiled by one toolchain has to render through the renderer
+ * that toolchain resolved, or `setContext` writes into a renderer the children never read.
+ */
+let render: typeof runtimeRender = runtimeRender
+/** Resolved `Chain`, or the in-flight load on the very first call. */
+const loadChain = (): Component<ChainProps> | Promise<Component<ChainProps>> => {
+  if (chainComponent !== undefined) return chainComponent
+  // A dev server that owns SSR resolution compiles the app's `.svelte` routes itself, and `Chain` has
+  // to come from that same graph: the runtime has no `.svelte` loader on that pipeline, so a plain
+  // `import` yields the file PATH and SSR dies at `component is not a function`. Registering a second
+  // compiler in the runtime instead is the trap - it gives the tree two Svelte runtimes, and the
+  // renderer `Chain` sets context on is not the one the routes read it from. Taking BOTH the component
+  // and `svelte/server` from the dev server keeps it at one compiler and one runtime.
+  const load = ssrModuleLoader()
+  chainPromise ??= (
+    load !== undefined
+      ? Promise.all([
+          load(fileURLToPath(new URL("./Chain.svelte", import.meta.url))),
+          load("svelte/server"),
+        ]).then(([mod, server]) => {
+          render = (server as { render: typeof runtimeRender }).render
+          return (mod as { default: Component<ChainProps> }).default
+        })
+      : import("./Chain.svelte").then((m) => m.default as Component<ChainProps>)
+  ).then((c) => {
+    chainComponent = c
+    return c
+  })
+  return chainPromise
+}
+
 // Svelte SSR yields a complete HTML string; the seam wants a stream, so emit it as one chunk.
 function oneChunk(html: string): ReadableStream<Uint8Array> {
   const bytes = new TextEncoder().encode(html)
@@ -32,16 +99,25 @@ export const svelteAdapter: RenderAdapter = {
   // returns the body directly (renderPage buffers it on the non-deferred fast path), and
   // `renderToStream` wraps the same string in a one-chunk stream for the deferred path. No streaming
   // renderer to skip here - but going straight to a string avoids the per-request stream allocation.
+  // The seam allows `string | Promise<string>`, so the first render can resolve `Chain` while every
+  // render after it stays a plain synchronous call - see `loadChain`.
   renderToString(chain, props) {
-    return render(Chain, { props: { chain, props, layoutData: props.layoutData } }).body
+    const Chain = loadChain()
+    const props$ = { chain, props, layoutData: props.layoutData }
+    return Chain instanceof Promise
+      ? Chain.then((C) => render(C, { props: props$ }).body)
+      : render(Chain, { props: props$ }).body
   },
   renderToStream(chain, props) {
     // `Chain` folds the layout chain (page innermost gets `props`; layouts wrap via their `children`
     // snippet). Svelte's `render` returns { head, body }; the body goes into #root. (Svelte's dynamic
     // `head` - from <svelte:head> - isn't surfaced through the seam's static `hydrationHead`; nifra's
     // own meta/head API manages the document head instead.)
-    const { body } = render(Chain, { props: { chain, props, layoutData: props.layoutData } })
-    return oneChunk(body)
+    const Chain = loadChain()
+    const props$ = { chain, props, layoutData: props.layoutData }
+    return Chain instanceof Promise
+      ? Chain.then((C) => oneChunk(render(C, { props: props$ }).body))
+      : oneChunk(render(Chain, { props: props$ }).body)
   },
   // Svelte's client `hydrate` reconciles against the existing DOM; no per-document bootstrap script is
   // needed (contrast Solid's generateHydrationScript) - the seam allows the empty string.

package/src/mdx.ts

@@ -1,3 +1,4 @@
+import { rewriteSsrImports } from "@nifrajs/web/plugins/kit"
 import type { BunPlugin } from "bun"
 import { compile } from "svelte/compiler"
 
@@ -57,7 +58,7 @@ export function svelteMdxBunPlugin(generate: "dom" | "ssr"): BunPlugin {
             loader: "js",
           }
         }
-        return { contents: js.code, loader: "js" }
+        return { contents: rewriteSsrImports(js.code, path, generate), loader: "js" }
       })
       build.onResolve({ filter: /\?svelte-mdx-css$/ }, (args) => ({
         path: args.path,

package/src/plugin.ts

@@ -1,3 +1,4 @@
+import { devHotComponent, devServerCompile, rewriteSsrImports } from "@nifrajs/web/plugins/kit"
 import type { BunPlugin } from "bun"
 import { compile } from "svelte/compiler"
 
@@ -20,6 +21,29 @@ import { compile } from "svelte/compiler"
 const STYLE_SUFFIX = "?svelte-css"
 const STYLE_NS = "nifra-svelte-css"
 
+/**
+ * The same hot-patch boundary as the Bun pipeline's, in the shape `@sveltejs/vite-plugin-svelte` takes:
+ *
+ * ```ts
+ * svelte({ dynamicCompileOptions: svelteHmrBoundary })
+ * ```
+ *
+ * Svelte's HMR wrapper resolves the component through a signal, which survives hydration only where
+ * the component is a plain child in a template. A layout or a page is not: the adapter's `Chain` enters
+ * chain members as dynamic components and through snippets, so a wrapper on one leaves the hydration
+ * cursor pointing at markup the wrapped component never claims. Svelte then throws the server's tree
+ * away and re-renders on the client - `hydration_mismatch` in the console, on first load, before any
+ * edit. Left on, the dev server quietly stops exercising hydration at all.
+ *
+ * Views keep hot-patching; route modules fall back to a full reload, which is what they want anyway
+ * (a route module carries the loader and meta the server ran, and re-running those is a navigation).
+ * Outside a nifra dev server nothing is announced and the answer is "no boundary" - a full reload is
+ * always correct, a mispatched tree is not.
+ */
+export function svelteHmrBoundary({ filename }: { filename: string }): { hmr: boolean } {
+  return { hmr: devHotComponent(filename) }
+}
+
 export function svelteBunPlugin(generate: "dom" | "ssr"): BunPlugin {
   // Compiled scoped CSS per `.svelte` file (client build only) - read back by the virtual-module loader.
   const cssByPath = new Map<string, string>()
@@ -31,10 +55,35 @@ export function svelteBunPlugin(generate: "dom" | "ssr"): BunPlugin {
       build.onLoad({ filter: /\.svelte(\?|$)/ }, async (args) => {
         const path = args.path.split("?")[0] ?? args.path
         const source = await Bun.file(path).text()
+        // Per compile, not per registration: the CLI registers the SSR plugin before the dev server
+        // exists, and the flag is set by the dev server.
+        //
+        // Svelte's HMR is a compiler feature (`$.hmr` + a self-accepting `import.meta.hot.accept`), and
+        // it is only available under `dev`. `dev` is set on BOTH halves so the server and client builds
+        // stay the same Svelte, while `hmr` stays client-only, there being no `import.meta.hot` on the
+        // server. `nifra build` sets neither, so nothing here reaches a production bundle.
+        //
+        // The server half additionally needs Svelte's own runtime in its dev shape - `dev` output calls
+        // `push_element`, which reads state the runtime only records when ITS `DEV` is true. That flag
+        // resolves through `esm-env`, which falls back to `NODE_ENV` off the export conditions; the dev
+        // server sets it for exactly this reason. Getting that half wrong throws on the first element:
+        // `undefined is not an object (evaluating 'context.function[FILENAME]')`.
+        //
+        // `hmr` narrows further, to the app's own non-route components ({@link devHotComponent}).
+        // Svelte's wrapper replaces the component with a block that resolves it through a signal, and
+        // that survives hydration only where the component is a plain child in a template. A chain
+        // member is not: the adapter's `Chain` enters layouts and pages as dynamic components and
+        // through snippets, and a wrapper on either side of that leaves the hydration cursor pointing
+        // at markup the wrapped component never claims - the whole tree is then thrown away and
+        // re-rendered on the client, silently, before any edit. A view component is the boundary that
+        // works, and it is also the one worth patching.
+        const dev = devServerCompile()
         const { js, css } = compile(source, {
           generate: generate === "ssr" ? "server" : "client",
           filename: path,
           css: "external", // emit the scoped stylesheet separately (not injected into the JS)
+          dev,
+          hmr: dev && generate === "dom" && devHotComponent(path),
         })
         if (generate === "dom" && css?.code) {
           cssByPath.set(path, css.code)
@@ -44,7 +93,7 @@ export function svelteBunPlugin(generate: "dom" | "ssr"): BunPlugin {
             loader: "js",
           }
         }
-        return { contents: js.code, loader: "js" }
+        return { contents: rewriteSsrImports(js.code, path, generate), loader: "js" }
       })
       // Virtual CSS module: `<file>.svelte?svelte-css` → the compiled scoped stylesheet (css loader).
       build.onResolve({ filter: /\?svelte-css$/ }, (args) => ({

package/src/query.ts

@@ -1,9 +1,7 @@
-import {
-  createQueryClient,
-  type QueryClient,
-  type QueryHandle,
-  type QueryState,
-} from "@nifrajs/web"
+import type { QueryClient, QueryHandle, QueryState } from "@nifrajs/web"
+// `/client`, not the root - these are DOM values, and the root's graph carries the
+// server, which Vite's dev server evaluates rather than tree-shakes.
+import { createQueryClient } from "@nifrajs/web/client"
 /**
  * `@nifrajs/web-svelte/query` - Svelte bindings for the keyed query-cache, as **Svelte stores** (plain
  * `.ts`). `useQuery(key, fn)` returns a `Readable<QueryState<T>>` augmented with `refetch` - read it

package/src/router.ts

@@ -1,15 +1,23 @@
 import type { InferOutput, StandardSchemaV1 } from "@nifrajs/core/server"
+// `import type` + a local re-export, NOT `export type { … } from "@nifrajs/web"`: that form leaves a
+// bare `import "@nifrajs/web"` in the output, which pulls the server graph into the browser under
+// Vite's dev server. Sourced from the ROOT so the generated `RouteSearch` augmentation applies.
+import type {
+  Blocker,
+  BlockerFunction,
+  BlockerState,
+  NavigateFunction,
+  NavigateOptions,
+  NavigateTargetInput,
+} from "@nifrajs/web"
+// `/client`, not the root - these are DOM values, and the root's graph carries the
+// server, which Vite's dev server evaluates rather than tree-shakes.
 import {
-  type Blocker,
-  type BlockerFunction,
   getBrowserNavigate,
   IDLE_BLOCKER,
-  type NavigateFunction,
-  type NavigateOptions,
-  type NavigateTargetInput,
   registerBlocker,
   resolveNavigate,
-} from "@nifrajs/web"
+} from "@nifrajs/web/client"
 import { getContext } from "svelte"
 /**
  * `@nifrajs/web-svelte/router` - Svelte routing bindings over the agnostic `@nifrajs/web` history layer,
@@ -21,7 +29,7 @@ import { getContext } from "svelte"
  */
 import { type Readable, readable } from "svelte/store"
 
-export type { Blocker, BlockerFunction, BlockerState, NavigateFunction } from "@nifrajs/web"
+export type { Blocker, BlockerFunction, BlockerState, NavigateFunction }
 
 // Must match the string key `Chain.svelte` passes to `setContext` (a string avoids a `.svelte` → `.ts`
 // import that wouldn't resolve once the .svelte is copied to dist).