@nifrajs/web-solid 2.10.0 → 2.11.0

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { type MountRouterOptions, type RenderProps } from "@nifrajs/web";
+import type { MountRouterOptions, RenderProps } from "@nifrajs/web";
 export { errorBoundary } from "./error.js";
 /** Hydrate a server-rendered Solid layout `chain` (with the loader `props`) inside `container`. */
 export declare function hydrate(chain: readonly unknown[], props: RenderProps, container: unknown): void;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAiB,MAAM,cAAc,CAAA;AAgBvF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAE/F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CA+D7D"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAmBnE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAE/F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CA+D7D"}

package/dist/client.js

@@ -1,4 +1,6 @@
-import { searchOfChain } from "@nifrajs/web";
+// `/client`, not the root: the root's graph carries the server, and Vite's dev server evaluates it
+// instead of tree-shaking it - which broke hydration before the browser ran a line of app code.
+import { searchOfChain } from "@nifrajs/web/client";
 /**
  * @nifrajs/web-solid/client - Solid client runtime. `hydrate` hydrates a single SSR'd route;
  * `mountRouter` hydrates the initial route then drives navigation through a Solid signal - so a

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -7,6 +7,9 @@ export declare const solidAdapter: RenderAdapter;
  * for the server, `"dom"` for the client, `hydratable` so SSR and hydrate align. Solid's
  * reactive-JSX compiler ships only as a Babel plugin (no swc/native port); this runs at
  * build time, on `.tsx` files only.
+ *
+ * Under a dev server the client half additionally runs `solid-refresh`, which is what makes an edit
+ * patch the running component tree instead of reloading the page - see {@link setupSolidRefresh}.
  */
 export declare function solidBunPlugin(generate: "dom" | "ssr"): BunPlugin;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAUpC,6EAA6E;AAC7E,eAAO,MAAM,YAAY,EAAE,aAsB1B,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAqBjE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAIjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAWpC,6EAA6E;AAC7E,eAAO,MAAM,YAAY,EAAE,aAsB1B,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CA0BjE"}

package/dist/index.js

@@ -7,10 +7,12 @@
 import { transformAsync } from "@babel/core";
 // @ts-expect-error - no type declarations published
 import presetTypeScript from "@babel/preset-typescript";
+import { devServerCompile, rewriteSsrImports } from "@nifrajs/web/plugins/kit";
 // @ts-expect-error - no type declarations published
 import presetSolid from "babel-preset-solid";
 import { generateHydrationScript, renderToStream as solidRenderToStream, renderToString as solidRenderToString, } from "solid-js/web";
 import { compose } from "./compose.js";
+import solidRefreshBunHot, { SOLID_HOT_MODULE } from "./refresh-babel.js";
 const HYDRATION_HEAD = generateHydrationScript();
 /** The Solid server render adapter - pass to @nifrajs/web's `renderPage`. */
 export const solidAdapter = {
@@ -41,11 +43,15 @@ export const solidAdapter = {
  * for the server, `"dom"` for the client, `hydratable` so SSR and hydrate align. Solid's
  * reactive-JSX compiler ships only as a Babel plugin (no swc/native port); this runs at
  * build time, on `.tsx` files only.
+ *
+ * Under a dev server the client half additionally runs `solid-refresh`, which is what makes an edit
+ * patch the running component tree instead of reloading the page - see {@link setupSolidRefresh}.
  */
 export function solidBunPlugin(generate) {
     return {
         name: `nifra-solid-${generate}`,
         setup(build) {
+            const refresh = generate === "dom" && devServerCompile() ? setupSolidRefresh(build) : undefined;
             // Match `.tsx`, tolerating a `?query` suffix (dev servers append one to bust Bun's import
             // cache); strip it before reading the file off disk.
             build.onLoad({ filter: /\.tsx(\?|$)/ }, async (args) => {
@@ -58,10 +64,53 @@ export function solidBunPlugin(generate) {
                         [presetSolid, { generate, hydratable: true }],
                         [presetTypeScript, { onlyRemoveTypeImports: true }],
                     ],
+                    ...(refresh !== undefined
+                        ? { plugins: [[await refresh.babel(), REFRESH_OPTIONS], solidRefreshBunHot] }
+                        : {}),
                 });
-                return { contents: result?.code ?? "", loader: "js" };
+                return { contents: rewriteSsrImports(result?.code ?? "", path, generate), loader: "js" };
             });
         },
     };
 }
+/**
+ * `"esm"` is the closest of `solid-refresh`'s bundler modes to what Bun implements: one
+ * `accept(mod => …)` per module, falling back to `invalidate()` when a component's signature changed too
+ * much to patch in place. `"vite"` differs only by also calling a bare `accept()` first, which would make
+ * every module self-accepting twice over. The call it emits is still Vite-shaped, and
+ * `solidRefreshBunHot` translates it.
+ *
+ * `jsx: false` turns OFF the pass that lifts a component's returned JSX into a second, nested component.
+ * That extra component is an extra hydration level on the client and none on the server, so with it on,
+ * every hydratable page dies on `Unable to find DOM nodes for hydration key` before a single edit. It buys
+ * finer-grained patching of markup-only edits; correct hydration is worth more.
+ */
+const REFRESH_OPTIONS = { bundler: "esm", jsx: false };
+/**
+ * Wire `solid-refresh` into a dev-server client compile.
+ *
+ * Solid components are compiled reactive closures, not functions re-run on render, so a new module
+ * version cannot simply replace the old one - `solid-refresh` wraps every component in a registry and, on
+ * an update, patches the live instances, keeping signal state. Without it the update finds no accepting
+ * module, bubbles up to the generated entry, and Bun reloads the whole page.
+ *
+ * The Babel half loads lazily: it is dev-only, and this module is the adapter root every Solid SSR
+ * server imports.
+ *
+ * Both runtime specifiers need pinning, because the transform emits them INTO the app's own files, where
+ * a bare specifier resolves against the app. `solid-refresh` is only a transitive dependency there and
+ * need not be hoisted; `nifra:solid-hot` is this package's own bridge module and has no app-side name at
+ * all. Resolving both here is what keeps the emitted imports working without an app depending on either.
+ */
+function setupSolidRefresh(build) {
+    const runtime = Bun.resolveSync("solid-refresh", import.meta.dir);
+    build.onResolve({ filter: /^solid-refresh$/ }, () => ({ path: runtime }));
+    // `.ts` from source (Bun takes the package's `bun` export condition), `.js` from the published build.
+    const bridge = `${import.meta.dir}/refresh-hot${import.meta.path.endsWith(".ts") ? ".ts" : ".js"}`;
+    build.onResolve({ filter: new RegExp(`^${SOLID_HOT_MODULE}$`) }, () => ({ path: bridge }));
+    let babel;
+    return {
+        babel: () => (babel ??= import("solid-refresh/babel").then((m) => m.default)),
+    };
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,oDAAoD;AACpD,OAAO,gBAAgB,MAAM,0BAA0B,CAAA;AAEvD,oDAAoD;AACpD,OAAO,WAAW,MAAM,oBAAoB,CAAA;AAE5C,OAAO,EACL,uBAAuB,EACvB,cAAc,IAAI,mBAAmB,EACrC,cAAc,IAAI,mBAAmB,GACtC,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,cAAc,GAAG,uBAAuB,EAAE,CAAA;AAEhD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,gGAAgG;IAChG,mFAAmF;IACnF,4FAA4F;IAC5F,iGAAiG;IACjG,kEAAkE;IAClE,cAAc,CAAC,KAAK,EAAE,KAAK;QACzB,OAAO,mBAAmB,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;IACnD,CAAC;IACD,cAAc,CAAC,KAAK,EAAE,KAAK;QACzB,uFAAuF;QACvF,2FAA2F;QAC3F,6FAA6F;QAC7F,4FAA4F;QAC5F,iCAAiC;QACjC,MAAM,EAAE,GAAG,IAAI,eAAe,EAA0B,CAAA;QACxD,mBAAmB,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAA;QAC9D,OAAO,EAAE,CAAC,QAAQ,CAAA;IACpB,CAAC;IACD,aAAa;QACX,OAAO,cAAc,CAAA;IACvB,CAAC;CACF,CAAA;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,QAAuB;IACpD,OAAO;QACL,IAAI,EAAE,eAAe,QAAQ,EAAE;QAC/B,KAAK,CAAC,KAAK;YACT,0FAA0F;YAC1F,qDAAqD;YACrD,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACrD,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,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE;oBAC1C,QAAQ,EAAE,IAAI;oBACd,+EAA+E;oBAC/E,OAAO,EAAE;wBACP,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;wBAC7C,CAAC,gBAAgB,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC;qBACpD;iBACF,CAAC,CAAA;gBACF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;YACvD,CAAC,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}
+{"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;AASpC;sEACsE;AACtE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAmCpE"}
+{"version":3,"file":"mdx.d.ts","sourceRoot":"","sources":["../src/mdx.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AASpC;sEACsE;AACtE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAmCpE"}

package/dist/mdx.js

@@ -17,6 +17,7 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
 import { transformAsync } from "@babel/core";
 // @ts-expect-error - no type declarations published
 import presetTypeScript from "@babel/preset-typescript";
+import { rewriteSsrImports } from "@nifrajs/web/plugins/kit";
 // @ts-expect-error - no type declarations published
 import presetSolid from "babel-preset-solid";
 // Non-literal so tsc/consumers don't need `@mdx-js/mdx`'s types to typecheck this file (optional peer).
@@ -51,7 +52,7 @@ export function solidMdxBunPlugin(generate) {
                     babelrc: false,
                     configFile: false,
                 });
-                return { contents: result?.code ?? "", loader: "js" };
+                return { contents: rewriteSsrImports(result?.code ?? "", path, generate), loader: "js" };
             });
         },
     };

package/dist/mdx.js.map

@@ -1 +1 @@
-{"version":3,"file":"mdx.js","sourceRoot":"","sources":["../src/mdx.ts"],"names":[],"mappings":";;;;;;;;AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,oDAAoD;AACpD,OAAO,gBAAgB,MAAM,0BAA0B,CAAA;AACvD,oDAAoD;AACpD,OAAO,WAAW,MAAM,oBAAoB,CAAA;AAG5C,wGAAwG;AACxG,MAAM,UAAU,GAAG,aAAa,CAAA;AAMhC;sEACsE;AACtE,MAAM,UAAU,iBAAiB,CAAC,QAAuB;IACvD,OAAO;QACL,IAAI,EAAE,mBAAmB,QAAQ,EAAE;QACnC,KAAK,CAAC,KAAK,CAAC,KAAK;YACf,IAAI,OAA+B,CAAA;YACnC,IAAI,CAAC;gBACH,OAAO,GAAI,CAAC,MAAM,MAAM,kCAAC,UAAU,EAAC,CAAiB,CAAC,OAAO,CAAA;YAC/D,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CACb,gHAAgH,CACjH,CAAA;YACH,CAAC;YACD,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACrD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAA;gBACjD,0FAA0F;gBAC1F,MAAM,GAAG,GAAG,MAAM,CAChB,MAAM,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;oBACzC,GAAG,EAAE,IAAI;oBACT,oBAAoB,EAAE,gCAAgC;iBACvD,CAAC,CACH,CAAA;gBACD,4EAA4E;gBAC5E,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE;oBACvC,QAAQ,EAAE,GAAG,IAAI,MAAM;oBACvB,OAAO,EAAE;wBACP,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;wBAC7C,CAAC,gBAAgB,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC;qBACpD;oBACD,OAAO,EAAE,KAAK;oBACd,UAAU,EAAE,KAAK;iBAClB,CAAC,CAAA;gBACF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;YACvD,CAAC,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"mdx.js","sourceRoot":"","sources":["../src/mdx.ts"],"names":[],"mappings":";;;;;;;;AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,oDAAoD;AACpD,OAAO,gBAAgB,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,oDAAoD;AACpD,OAAO,WAAW,MAAM,oBAAoB,CAAA;AAG5C,wGAAwG;AACxG,MAAM,UAAU,GAAG,aAAa,CAAA;AAMhC;sEACsE;AACtE,MAAM,UAAU,iBAAiB,CAAC,QAAuB;IACvD,OAAO;QACL,IAAI,EAAE,mBAAmB,QAAQ,EAAE;QACnC,KAAK,CAAC,KAAK,CAAC,KAAK;YACf,IAAI,OAA+B,CAAA;YACnC,IAAI,CAAC;gBACH,OAAO,GAAI,CAAC,MAAM,MAAM,kCAAC,UAAU,EAAC,CAAiB,CAAC,OAAO,CAAA;YAC/D,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CACb,gHAAgH,CACjH,CAAA;YACH,CAAC;YACD,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACrD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAA;gBACjD,0FAA0F;gBAC1F,MAAM,GAAG,GAAG,MAAM,CAChB,MAAM,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;oBACzC,GAAG,EAAE,IAAI;oBACT,oBAAoB,EAAE,gCAAgC;iBACvD,CAAC,CACH,CAAA;gBACD,4EAA4E;gBAC5E,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE;oBACvC,QAAQ,EAAE,GAAG,IAAI,MAAM;oBACvB,OAAO,EAAE;wBACP,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;wBAC7C,CAAC,gBAAgB,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC;qBACpD;oBACD,OAAO,EAAE,KAAK;oBACd,UAAU,EAAE,KAAK;iBAClB,CAAC,CAAA;gBACF,OAAO,EAAE,QAAQ,EAAE,iBAAiB,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;YAC1F,CAAC,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}

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-solid/query` - Solid bindings for the keyed query-cache. `createQuery(key, fn)` bridges a
  * query's `subscribe`/`snapshot` store into a Solid signal and fetches on mount; `useQueryClient`

package/dist/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AACnF;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAoC,MAAM,UAAU,CAAA;AAS1E,wGAAwG;AACxG,wBAAgB,cAAc,IAAI,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAEvE;AAUD,wDAAwD;AACxD,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,uGAAuG;IACvG,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IACvC,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAA;CACnC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAgBvF"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAI3D;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,QAAQ,EAAoC,MAAM,UAAU,CAAA;AAS1E,wGAAwG;AACxG,wBAAgB,cAAc,IAAI,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAEvE;AAUD,wDAAwD;AACxD,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,uGAAuG;IACvG,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IACvC,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAA;CACnC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAgBvF"}

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-solid/query` - Solid bindings for the keyed query-cache. `createQuery(key, fn)` bridges a
  * query's `subscribe`/`snapshot` store into a Solid signal and fetches on mount; `useQueryClient`

package/dist/query.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAqC,MAAM,cAAc,CAAA;AACnF;;;;;;;;;GASG;AACH,OAAO,EAAiB,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAE1E,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,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;AAUF;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAI,GAAY,EAAE,EAAoB;IAC/D,MAAM,MAAM,GAAG,SAAS,EAAE,EAAE,KAAK,CAAI,GAAG,EAAE,EAAE,CAAC,CAAA;IAC7C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,YAAY,CAAgB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACxF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAA;QACpE,OAAO,CAAC,GAAG,EAAE;YACX,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAChC,CAAC,CAAC,CAAA;QACF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAA;IAC3C,CAAC;IACD,OAAO;QACL,KAAK;QACL,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAA;QAChG,CAAC;KACF,CAAA;AACH,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;;;;;;;;;GASG;AACH,OAAO,EAAiB,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAE1E,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,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;AAUF;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAI,GAAY,EAAE,EAAoB;IAC/D,MAAM,MAAM,GAAG,SAAS,EAAE,EAAE,KAAK,CAAI,GAAG,EAAE,EAAE,CAAC,CAAA;IAC7C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,YAAY,CAAgB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACxF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAA;QACpE,OAAO,CAAC,GAAG,EAAE;YACX,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAChC,CAAC,CAAC,CAAA;QACF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAA;IAC3C,CAAC;IACD,OAAO;QACL,KAAK;QACL,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAA;QAChG,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/refresh-babel.d.ts

@@ -0,0 +1,32 @@
+/**
+ * A Babel pass that runs AFTER `solid-refresh` and rewrites the one call it emits into the dialect
+ * Bun's dev server speaks. Dev-server client compiles only (`solidBunPlugin("dom")`).
+ *
+ * `solid-refresh` ends every component module with
+ *
+ *     if (import.meta.hot) { _$$refresh("esm", import.meta.hot, _REGISTRY) }
+ *
+ * which is a Vite assumption: that `import.meta.hot` is an object you can pass around. Bun's bundler
+ * instead rewrites `import.meta.hot.<prop>` where it can see it and substitutes, for every other use, a
+ * proxy that throws `import.meta.hot.<prop> cannot be used indirectly` on the first property read. So the
+ * argument has to become something built from member accesses Bun CAN see, and the rest of the
+ * adaptation moves into `./refresh-hot` (which also supplies the cross-version store and the reload that
+ * stands in for Bun's unimplemented `invalidate`):
+ *
+ *     if (import.meta.hot) { _ref(import.meta.url, (cb) => import.meta.hot.accept(cb), _REGISTRY) }
+ *
+ * Rewriting rather than string-replacing matters: the identifier `solid-refresh` picks is uniquified
+ * against the module's own scope, so it is not a fixed string, and a silent miss would leave a module
+ * that throws on load.
+ */
+import type { types as BabelTypes, PluginObj, PluginPass } from "@babel/core";
+/**
+ * The virtual specifier for `./refresh-hot`, resolved by `solidBunPlugin` against THIS package. The
+ * import lands in an app's own file, where a relative path would be wrong and a bare `@nifrajs/web-solid`
+ * subpath would depend on how the app's install happens to be laid out.
+ */
+export declare const SOLID_HOT_MODULE = "nifra:solid-hot";
+export default function solidRefreshBunHot({ types: t, }: {
+    types: typeof BabelTypes;
+}): PluginObj<PluginPass>;
+//# sourceMappingURL=refresh-babel.d.ts.map

package/dist/refresh-babel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-babel.d.ts","sourceRoot":"","sources":["../src/refresh-babel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAa,KAAK,IAAI,UAAU,EAAY,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAElG;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,oBAAoB,CAAA;AAgEjD,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,EACzC,KAAK,EAAE,CAAC,GACT,EAAE;IACD,KAAK,EAAE,OAAO,UAAU,CAAA;CACzB,GAAG,SAAS,CAAC,UAAU,CAAC,CAoCxB"}

package/dist/refresh-babel.js

@@ -0,0 +1,84 @@
+/**
+ * The virtual specifier for `./refresh-hot`, resolved by `solidBunPlugin` against THIS package. The
+ * import lands in an app's own file, where a relative path would be wrong and a bare `@nifrajs/web-solid`
+ * subpath would depend on how the app's install happens to be laid out.
+ */
+export const SOLID_HOT_MODULE = "nifra:solid-hot";
+/** `solid-refresh`'s call, under whatever uid Babel gave the import in this module's scope. */
+const REFRESH_CALLEE = /^_*\$\$refresh\d*$/;
+/** Per-file memo of the injected `refresh` import, so a module with many components imports it once. */
+const injected = new WeakMap();
+/**
+ * `import.meta`, in either of the two shapes it can arrive in: the `MetaProperty` a parser produces, and
+ * the plain `import` . `meta` member expression `solid-refresh` hand-builds. Matching only the former is
+ * what a first cut gets wrong - the emitted call reads `import.meta.hot` but is not a `MetaProperty`.
+ */
+const isImportMeta = (t, node) => (t.isMetaProperty(node) && node.meta.name === "import" && node.property.name === "meta") ||
+    (t.isMemberExpression(node) &&
+        !node.computed &&
+        t.isIdentifier(node.object, { name: "import" }) &&
+        t.isIdentifier(node.property, { name: "meta" }));
+/** `import.meta.hot` exactly - the argument this pass replaces. */
+const isImportMetaHot = (t, node) => t.isMemberExpression(node) &&
+    !node.computed &&
+    isImportMeta(t, node.object) &&
+    t.isIdentifier(node.property) &&
+    node.property.name === "hot";
+const importMetaMember = (t, property) => t.memberExpression(t.metaProperty(t.identifier("import"), t.identifier("meta")), t.identifier(property));
+/** `(cb) => import.meta.hot.accept(cb)` - `accept` reached the only way Bun's bundler recognizes. */
+function acceptClosure(t) {
+    const callback = t.identifier("cb");
+    return t.arrowFunctionExpression([callback], t.callExpression(t.memberExpression(importMetaMember(t, "hot"), t.identifier("accept")), [
+        callback,
+    ]));
+}
+function refreshImport(t, path, state) {
+    const existing = injected.get(state);
+    if (existing !== undefined)
+        return existing;
+    const program = path.scope.getProgramParent().path;
+    const local = program.scope.generateUidIdentifier("nifraSolidRefresh");
+    program.node.body.unshift(t.importDeclaration([t.importSpecifier(local, t.identifier("refresh"))], t.stringLiteral(SOLID_HOT_MODULE)));
+    injected.set(state, local);
+    return local;
+}
+export default function solidRefreshBunHot({ types: t, }) {
+    return {
+        name: "nifra-solid-refresh-bun-hot",
+        // Required by the plugin shape, and deliberately empty - see `post` below.
+        visitor: {},
+        // No visitor entries at all: the call this pass rewrites does not exist during the shared traversal.
+        // `solid-refresh` appends it with `pushContainer` from its own `Program` handler, and nodes added
+        // that way are never handed to the other plugins' visitors. `Program.exit` is no better - exit
+        // handlers fire in plugin order, so this one would run BEFORE the append. `post` runs once the
+        // file's whole traversal is finished, which is the first point at which the call is there to see.
+        post(file) {
+            const state = this;
+            file.path.traverse({
+                CallExpression(path) {
+                    const callee = path.node.callee;
+                    if (!t.isIdentifier(callee) || !REFRESH_CALLEE.test(callee.name))
+                        return;
+                    const args = path.node.arguments;
+                    // ("esm", import.meta.hot, registry) - anything else is not the call this pass is for.
+                    if (args.length !== 3)
+                        return;
+                    const hot = args[1];
+                    const registry = args[2];
+                    if (hot === undefined || registry === undefined || !isImportMetaHot(t, hot))
+                        return;
+                    if (!t.isExpression(registry))
+                        return;
+                    // The replacement's callee is the injected uid, which REFRESH_CALLEE never matches, so the
+                    // re-traversal `replaceWith` triggers terminates here.
+                    path.replaceWith(t.callExpression(refreshImport(t, path, state), [
+                        importMetaMember(t, "url"),
+                        acceptClosure(t),
+                        registry,
+                    ]));
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=refresh-babel.js.map

package/dist/refresh-babel.js.map

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

package/dist/refresh-hot.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The `solid-refresh` ↔ Bun-dev-server bridge, client-side. Loaded only by a dev-server client bundle
+ * (`solidBunPlugin("dom")` resolves the `nifra:solid-hot` specifier its Babel pass emits); never part of
+ * `nifra build` output.
+ *
+ * `solid-refresh` expects a Vite-shaped `import.meta.hot` handed to it as a VALUE. Bun does not have one:
+ * it rewrites `import.meta.hot.<prop>` at bundle time and substitutes a proxy that throws
+ * (`import.meta.hot.<prop> cannot be used indirectly`) for every other use - so passing the object to a
+ * library function fails on the first property read, whichever property it is. This module supplies the
+ * value-shaped object instead, built from direct member accesses the plugin emits at the call site.
+ *
+ * Two of the three pieces need more than a pass-through:
+ *
+ * - `data` is where `solid-refresh` keeps the previous version's component registry, so it has to be the
+ *   SAME object across every version of a module. Bun's own `data` is a field on a per-version module
+ *   record, so it is not usable for that; the store below is keyed by module URL and lives in this
+ *   module, which no edit invalidates.
+ * - `invalidate` is not implemented in Bun's HMR runtime (it throws). It is the escape hatch
+ *   `solid-refresh` takes when a component's shape changed too much to patch in place, and a full reload
+ *   is exactly the right answer there - so that is what it does.
+ */
+/**
+ * Run `solid-refresh`'s update handshake for one module.
+ *
+ * `moduleUrl` identifies the module across versions; `accept` is a closure the plugin emits around
+ * `import.meta.hot.accept`, which is the only form Bun's bundler will rewrite. `registry` is the
+ * component registry this version of the module built.
+ */
+export declare function refresh(moduleUrl: string, accept: (callback: (module: unknown) => void) => void, registry: unknown): void;
+//# sourceMappingURL=refresh-hot.d.ts.map

package/dist/refresh-hot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-hot.d.ts","sourceRoot":"","sources":["../src/refresh-hot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAuCH;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,EACrD,QAAQ,EAAE,OAAO,GAChB,IAAI,CAUN"}

package/dist/refresh-hot.js

@@ -0,0 +1,62 @@
+/**
+ * The `solid-refresh` ↔ Bun-dev-server bridge, client-side. Loaded only by a dev-server client bundle
+ * (`solidBunPlugin("dom")` resolves the `nifra:solid-hot` specifier its Babel pass emits); never part of
+ * `nifra build` output.
+ *
+ * `solid-refresh` expects a Vite-shaped `import.meta.hot` handed to it as a VALUE. Bun does not have one:
+ * it rewrites `import.meta.hot.<prop>` at bundle time and substitutes a proxy that throws
+ * (`import.meta.hot.<prop> cannot be used indirectly`) for every other use - so passing the object to a
+ * library function fails on the first property read, whichever property it is. This module supplies the
+ * value-shaped object instead, built from direct member accesses the plugin emits at the call site.
+ *
+ * Two of the three pieces need more than a pass-through:
+ *
+ * - `data` is where `solid-refresh` keeps the previous version's component registry, so it has to be the
+ *   SAME object across every version of a module. Bun's own `data` is a field on a per-version module
+ *   record, so it is not usable for that; the store below is keyed by module URL and lives in this
+ *   module, which no edit invalidates.
+ * - `invalidate` is not implemented in Bun's HMR runtime (it throws). It is the escape hatch
+ *   `solid-refresh` takes when a component's shape changed too much to patch in place, and a full reload
+ *   is exactly the right answer there - so that is what it does.
+ */
+import { $$refresh } from "solid-refresh";
+/**
+ * Registry store per module URL - see the note above on why Bun's own `hot.data` cannot serve.
+ *
+ * On `globalThis`, not in module scope: Bun re-evaluates an updated module's imports along with it, so
+ * this very module is re-instantiated during an update and a module-scoped Map would come back empty
+ * halfway through. The symptom of getting that wrong is not a lost registry but an infinite one -
+ * `patchRegistry` then compares a registry against itself, points a component's signal at its own proxy,
+ * and the next render recurses until the stack blows.
+ */
+const STORES = Symbol.for("nifra.solid-refresh.stores");
+function store(moduleUrl) {
+    const host = globalThis;
+    host[STORES] ??= new Map();
+    const stores = host[STORES];
+    let data = stores.get(moduleUrl);
+    if (data === undefined) {
+        data = {};
+        stores.set(moduleUrl, data);
+    }
+    return data;
+}
+/**
+ * Run `solid-refresh`'s update handshake for one module.
+ *
+ * `moduleUrl` identifies the module across versions; `accept` is a closure the plugin emits around
+ * `import.meta.hot.accept`, which is the only form Bun's bundler will rewrite. `registry` is the
+ * component registry this version of the module built.
+ */
+export function refresh(moduleUrl, accept, registry) {
+    const reload = () => {
+        location.reload();
+    };
+    const hot = { data: store(moduleUrl), accept, invalidate: reload, decline: reload };
+    // `$$refresh`'s published signature is a discriminated tuple over every bundler mode it supports, so
+    // the "esm" arm cannot be selected by a cast on the hot object alone. The mode string and the shape
+    // above are what pin it; the call itself is what has to be re-typed.
+    const esmRefresh = $$refresh;
+    esmRefresh("esm", hot, registry);
+}
+//# sourceMappingURL=refresh-hot.js.map

package/dist/refresh-hot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-hot.js","sourceRoot":"","sources":["../src/refresh-hot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAEzC;;;;;;;;GAQG;AACH,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAA;AAMvD,SAAS,KAAK,CAAC,SAAiB;IAC9B,MAAM,IAAI,GAAG,UAAuB,CAAA;IACpC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,EAAmC,CAAA;IAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;IAC3B,IAAI,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,GAAG,EAAE,CAAA;QACT,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IAC7B,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAUD;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CACrB,SAAiB,EACjB,MAAqD,EACrD,QAAiB;IAEjB,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,QAAQ,CAAC,MAAM,EAAE,CAAA;IACnB,CAAC,CAAA;IACD,MAAM,GAAG,GAAa,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;IAC7F,qGAAqG;IACrG,oGAAoG;IACpG,qEAAqE;IACrE,MAAM,UAAU,GAAG,SAA+E,CAAA;IAClG,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAA;AAClC,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-solid/router` - Solid routing bindings over the agnostic `@nifrajs/web` history layer:
  * `useNavigate` (programmatic navigation), `useBlocker` (the unsaved-changes guard), and `useSearch`
@@ -8,7 +8,7 @@ import { type Blocker, type BlockerFunction, type NavigateFunction } from "@nifr
  * reads the accessor `compose` provides on SSR + client mount alike. Imports only `solid-js`. No JSX.
  */
 import { type Accessor, type Context } from "solid-js";
-export type { Blocker, BlockerFunction, BlockerState, NavigateFunction } from "@nifrajs/web";
+export type { Blocker, BlockerFunction, BlockerState, NavigateFunction };
 export declare const SearchContext: Context<Accessor<Record<string, unknown>> | undefined>;
 /**
  * The route's typed, validated search params as a reactive accessor - the SAME value the loader received

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;AACrB;;;;;;GAMG;AACH,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,OAAO,EAKb,MAAM,UAAU,CAAA;AAEjB,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAiB5F,eAAO,MAAM,aAAa,wDACoE,CAAA;AAG9F;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,KAAK,QAAQ,CAC5F,MAAM,SAAS,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAChF,CAIA;AAED;;kCAEkC;AAClC,wBAAgB,WAAW,IAAI,gBAAgB,CAO9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,OAAO,GAAG,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,CASpF"}
+{"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;AASrB;;;;;;GAMG;AACH,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,OAAO,EAKb,MAAM,UAAU,CAAA;AAEjB,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAA;AAiBxE,eAAO,MAAM,aAAa,wDACoE,CAAA;AAG9F;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,KAAK,QAAQ,CAC5F,MAAM,SAAS,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAChF,CAIA;AAED;;kCAEkC;AAClC,wBAAgB,WAAW,IAAI,gBAAgB,CAO9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,OAAO,GAAG,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,CASpF"}

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";
 /**
  * `@nifrajs/web-solid/router` - Solid routing bindings over the agnostic `@nifrajs/web` history layer:
  * `useNavigate` (programmatic navigation), `useBlocker` (the unsaved-changes guard), and `useSearch`

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;;;;;;GAMG;AACH,OAAO,EAGL,aAAa,EACb,YAAY,EACZ,SAAS,EACT,UAAU,GACX,MAAM,UAAU,CAAA;AAIjB,6FAA6F;AAC7F,MAAM,YAAY,GAAsC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACzE,MAAM,qBAAqB,GAAsC,GAAG,EAAE,CAAC,YAAY,CAAA;AAEnF;;;;;;2BAM2B;AAC3B,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAA;AACxE,MAAM,iBAAiB,GAAG,UAEzB,CAAA;AACD,MAAM,CAAC,MAAM,aAAa,GACxB,iBAAiB,CAAC,mBAAmB,CAAC,IAAI,aAAa,EAAqC,CAAA;AAC9F,iBAAiB,CAAC,mBAAmB,CAAC,GAAG,aAAa,CAAA;AAEtD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS;IAGvB,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAEzD,CAAA;AACH,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,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,YAAY,CAAU,YAAY,CAAC,CAAA;IACjE,SAAS,CACP,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,UAAU,CACX,CACF,CAAA;IACD,OAAO,OAAO,CAAA;AAChB,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;;;;;;GAMG;AACH,OAAO,EAGL,aAAa,EACb,YAAY,EACZ,SAAS,EACT,UAAU,GACX,MAAM,UAAU,CAAA;AAIjB,6FAA6F;AAC7F,MAAM,YAAY,GAAsC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACzE,MAAM,qBAAqB,GAAsC,GAAG,EAAE,CAAC,YAAY,CAAA;AAEnF;;;;;;2BAM2B;AAC3B,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAA;AACxE,MAAM,iBAAiB,GAAG,UAEzB,CAAA;AACD,MAAM,CAAC,MAAM,aAAa,GACxB,iBAAiB,CAAC,mBAAmB,CAAC,IAAI,aAAa,EAAqC,CAAA;AAC9F,iBAAiB,CAAC,mBAAmB,CAAC,GAAG,aAAa,CAAA;AAEtD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS;IAGvB,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAEzD,CAAA;AACH,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,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,YAAY,CAAU,YAAY,CAAC,CAAA;IACjE,SAAS,CACP,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,UAAU,CACX,CACF,CAAA;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nifrajs/web-solid",
-  "version": "2.10.0",
+  "version": "2.11.0",
   "description": "Solid render adapter for @nifrajs/web - SSR + hydration + the Solid Babel build plugin.",
   "keywords": [
     "bun",
@@ -97,11 +97,12 @@
   "dependencies": {
     "@babel/core": "^7.26.0",
     "@babel/preset-typescript": "^7.26.0",
-    "@nifrajs/core": "2.10.0",
-    "@nifrajs/i18n": "2.10.0",
-    "@nifrajs/image": "2.10.0",
-    "@nifrajs/web": "2.10.0",
-    "babel-preset-solid": "^1.9.3"
+    "@nifrajs/core": "2.11.0",
+    "@nifrajs/i18n": "2.11.0",
+    "@nifrajs/image": "2.11.0",
+    "@nifrajs/web": "2.11.0",
+    "babel-preset-solid": "^1.9.3",
+    "solid-refresh": "^0.7.8"
   },
   "peerDependencies": {
     "@mdx-js/mdx": "^3",

package/src/client.ts

@@ -1,4 +1,7 @@
-import { type MountRouterOptions, type RenderProps, searchOfChain } from "@nifrajs/web"
+import type { MountRouterOptions, RenderProps } from "@nifrajs/web"
+// `/client`, not the root: the root's graph carries the server, and Vite's dev server evaluates it
+// instead of tree-shaking it - which broke hydration before the browser ran a line of app code.
+import { searchOfChain } from "@nifrajs/web/client"
 /**
  * @nifrajs/web-solid/client - Solid client runtime. `hydrate` hydrates a single SSR'd route;
  * `mountRouter` hydrates the initial route then drives navigation through a Solid signal - so a

package/src/index.ts

@@ -8,6 +8,7 @@ import { transformAsync } from "@babel/core"
 // @ts-expect-error - no type declarations published
 import presetTypeScript from "@babel/preset-typescript"
 import type { RenderAdapter } from "@nifrajs/web"
+import { devServerCompile, rewriteSsrImports } from "@nifrajs/web/plugins/kit"
 // @ts-expect-error - no type declarations published
 import presetSolid from "babel-preset-solid"
 import type { BunPlugin } from "bun"
@@ -17,6 +18,7 @@ import {
   renderToString as solidRenderToString,
 } from "solid-js/web"
 import { compose } from "./compose.ts"
+import solidRefreshBunHot, { SOLID_HOT_MODULE } from "./refresh-babel.ts"
 
 const HYDRATION_HEAD = generateHydrationScript()
 
@@ -50,11 +52,16 @@ export const solidAdapter: RenderAdapter = {
  * for the server, `"dom"` for the client, `hydratable` so SSR and hydrate align. Solid's
  * reactive-JSX compiler ships only as a Babel plugin (no swc/native port); this runs at
  * build time, on `.tsx` files only.
+ *
+ * Under a dev server the client half additionally runs `solid-refresh`, which is what makes an edit
+ * patch the running component tree instead of reloading the page - see {@link setupSolidRefresh}.
  */
 export function solidBunPlugin(generate: "dom" | "ssr"): BunPlugin {
   return {
     name: `nifra-solid-${generate}`,
     setup(build) {
+      const refresh =
+        generate === "dom" && devServerCompile() ? setupSolidRefresh(build) : undefined
       // Match `.tsx`, tolerating a `?query` suffix (dev servers append one to bust Bun's import
       // cache); strip it before reading the file off disk.
       build.onLoad({ filter: /\.tsx(\?|$)/ }, async (args) => {
@@ -67,9 +74,56 @@ export function solidBunPlugin(generate: "dom" | "ssr"): BunPlugin {
             [presetSolid, { generate, hydratable: true }],
             [presetTypeScript, { onlyRemoveTypeImports: true }],
           ],
+          ...(refresh !== undefined
+            ? { plugins: [[await refresh.babel(), REFRESH_OPTIONS], solidRefreshBunHot] }
+            : {}),
         })
-        return { contents: result?.code ?? "", loader: "js" }
+        return { contents: rewriteSsrImports(result?.code ?? "", path, generate), loader: "js" }
       })
     },
   }
 }
+
+/**
+ * `"esm"` is the closest of `solid-refresh`'s bundler modes to what Bun implements: one
+ * `accept(mod => …)` per module, falling back to `invalidate()` when a component's signature changed too
+ * much to patch in place. `"vite"` differs only by also calling a bare `accept()` first, which would make
+ * every module self-accepting twice over. The call it emits is still Vite-shaped, and
+ * `solidRefreshBunHot` translates it.
+ *
+ * `jsx: false` turns OFF the pass that lifts a component's returned JSX into a second, nested component.
+ * That extra component is an extra hydration level on the client and none on the server, so with it on,
+ * every hydratable page dies on `Unable to find DOM nodes for hydration key` before a single edit. It buys
+ * finer-grained patching of markup-only edits; correct hydration is worth more.
+ */
+const REFRESH_OPTIONS = { bundler: "esm", jsx: false } as const
+
+/**
+ * Wire `solid-refresh` into a dev-server client compile.
+ *
+ * Solid components are compiled reactive closures, not functions re-run on render, so a new module
+ * version cannot simply replace the old one - `solid-refresh` wraps every component in a registry and, on
+ * an update, patches the live instances, keeping signal state. Without it the update finds no accepting
+ * module, bubbles up to the generated entry, and Bun reloads the whole page.
+ *
+ * The Babel half loads lazily: it is dev-only, and this module is the adapter root every Solid SSR
+ * server imports.
+ *
+ * Both runtime specifiers need pinning, because the transform emits them INTO the app's own files, where
+ * a bare specifier resolves against the app. `solid-refresh` is only a transitive dependency there and
+ * need not be hoisted; `nifra:solid-hot` is this package's own bridge module and has no app-side name at
+ * all. Resolving both here is what keeps the emitted imports working without an app depending on either.
+ */
+function setupSolidRefresh(build: Parameters<BunPlugin["setup"]>[0]): {
+  babel: () => Promise<unknown>
+} {
+  const runtime = Bun.resolveSync("solid-refresh", import.meta.dir)
+  build.onResolve({ filter: /^solid-refresh$/ }, () => ({ path: runtime }))
+  // `.ts` from source (Bun takes the package's `bun` export condition), `.js` from the published build.
+  const bridge = `${import.meta.dir}/refresh-hot${import.meta.path.endsWith(".ts") ? ".ts" : ".js"}`
+  build.onResolve({ filter: new RegExp(`^${SOLID_HOT_MODULE}$`) }, () => ({ path: bridge }))
+  let babel: Promise<unknown> | undefined
+  return {
+    babel: () => (babel ??= import("solid-refresh/babel").then((m) => m.default)),
+  }
+}

package/src/mdx.ts

@@ -9,6 +9,7 @@
 import { transformAsync } from "@babel/core"
 // @ts-expect-error - no type declarations published
 import presetTypeScript from "@babel/preset-typescript"
+import { rewriteSsrImports } from "@nifrajs/web/plugins/kit"
 // @ts-expect-error - no type declarations published
 import presetSolid from "babel-preset-solid"
 import type { BunPlugin } from "bun"
@@ -53,7 +54,7 @@ export function solidMdxBunPlugin(generate: "dom" | "ssr"): BunPlugin {
           babelrc: false,
           configFile: false,
         })
-        return { contents: result?.code ?? "", loader: "js" }
+        return { contents: rewriteSsrImports(result?.code ?? "", path, generate), loader: "js" }
       })
     },
   }

package/src/query.ts

@@ -1,4 +1,7 @@
-import { createQueryClient, type QueryClient, type QueryState } from "@nifrajs/web"
+import type { QueryClient, 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-solid/query` - Solid bindings for the keyed query-cache. `createQuery(key, fn)` bridges a
  * query's `subscribe`/`snapshot` store into a Solid signal and fetches on mount; `useQueryClient`

package/src/refresh-babel.ts

@@ -0,0 +1,133 @@
+/**
+ * A Babel pass that runs AFTER `solid-refresh` and rewrites the one call it emits into the dialect
+ * Bun's dev server speaks. Dev-server client compiles only (`solidBunPlugin("dom")`).
+ *
+ * `solid-refresh` ends every component module with
+ *
+ *     if (import.meta.hot) { _$$refresh("esm", import.meta.hot, _REGISTRY) }
+ *
+ * which is a Vite assumption: that `import.meta.hot` is an object you can pass around. Bun's bundler
+ * instead rewrites `import.meta.hot.<prop>` where it can see it and substitutes, for every other use, a
+ * proxy that throws `import.meta.hot.<prop> cannot be used indirectly` on the first property read. So the
+ * argument has to become something built from member accesses Bun CAN see, and the rest of the
+ * adaptation moves into `./refresh-hot` (which also supplies the cross-version store and the reload that
+ * stands in for Bun's unimplemented `invalidate`):
+ *
+ *     if (import.meta.hot) { _ref(import.meta.url, (cb) => import.meta.hot.accept(cb), _REGISTRY) }
+ *
+ * Rewriting rather than string-replacing matters: the identifier `solid-refresh` picks is uniquified
+ * against the module's own scope, so it is not a fixed string, and a silent miss would leave a module
+ * that throws on load.
+ */
+import type { BabelFile, types as BabelTypes, NodePath, PluginObj, PluginPass } from "@babel/core"
+
+/**
+ * The virtual specifier for `./refresh-hot`, resolved by `solidBunPlugin` against THIS package. The
+ * import lands in an app's own file, where a relative path would be wrong and a bare `@nifrajs/web-solid`
+ * subpath would depend on how the app's install happens to be laid out.
+ */
+export const SOLID_HOT_MODULE = "nifra:solid-hot"
+
+/** `solid-refresh`'s call, under whatever uid Babel gave the import in this module's scope. */
+const REFRESH_CALLEE = /^_*\$\$refresh\d*$/
+
+/** Per-file memo of the injected `refresh` import, so a module with many components imports it once. */
+const injected = new WeakMap<PluginPass, BabelTypes.Identifier>()
+
+/**
+ * `import.meta`, in either of the two shapes it can arrive in: the `MetaProperty` a parser produces, and
+ * the plain `import` . `meta` member expression `solid-refresh` hand-builds. Matching only the former is
+ * what a first cut gets wrong - the emitted call reads `import.meta.hot` but is not a `MetaProperty`.
+ */
+const isImportMeta = (t: typeof BabelTypes, node: BabelTypes.Node): boolean =>
+  (t.isMetaProperty(node) && node.meta.name === "import" && node.property.name === "meta") ||
+  (t.isMemberExpression(node) &&
+    !node.computed &&
+    t.isIdentifier(node.object, { name: "import" }) &&
+    t.isIdentifier(node.property, { name: "meta" }))
+
+/** `import.meta.hot` exactly - the argument this pass replaces. */
+const isImportMetaHot = (t: typeof BabelTypes, node: BabelTypes.Node): boolean =>
+  t.isMemberExpression(node) &&
+  !node.computed &&
+  isImportMeta(t, node.object) &&
+  t.isIdentifier(node.property) &&
+  node.property.name === "hot"
+
+const importMetaMember = (t: typeof BabelTypes, property: string): BabelTypes.MemberExpression =>
+  t.memberExpression(
+    t.metaProperty(t.identifier("import"), t.identifier("meta")),
+    t.identifier(property),
+  )
+
+/** `(cb) => import.meta.hot.accept(cb)` - `accept` reached the only way Bun's bundler recognizes. */
+function acceptClosure(t: typeof BabelTypes): BabelTypes.ArrowFunctionExpression {
+  const callback = t.identifier("cb")
+  return t.arrowFunctionExpression(
+    [callback],
+    t.callExpression(t.memberExpression(importMetaMember(t, "hot"), t.identifier("accept")), [
+      callback,
+    ]),
+  )
+}
+
+function refreshImport(
+  t: typeof BabelTypes,
+  path: NodePath<BabelTypes.CallExpression>,
+  state: PluginPass,
+): BabelTypes.Identifier {
+  const existing = injected.get(state)
+  if (existing !== undefined) return existing
+  const program = path.scope.getProgramParent().path as NodePath<BabelTypes.Program>
+  const local = program.scope.generateUidIdentifier("nifraSolidRefresh")
+  program.node.body.unshift(
+    t.importDeclaration(
+      [t.importSpecifier(local, t.identifier("refresh"))],
+      t.stringLiteral(SOLID_HOT_MODULE),
+    ),
+  )
+  injected.set(state, local)
+  return local
+}
+
+export default function solidRefreshBunHot({
+  types: t,
+}: {
+  types: typeof BabelTypes
+}): PluginObj<PluginPass> {
+  return {
+    name: "nifra-solid-refresh-bun-hot",
+    // Required by the plugin shape, and deliberately empty - see `post` below.
+    visitor: {},
+    // No visitor entries at all: the call this pass rewrites does not exist during the shared traversal.
+    // `solid-refresh` appends it with `pushContainer` from its own `Program` handler, and nodes added
+    // that way are never handed to the other plugins' visitors. `Program.exit` is no better - exit
+    // handlers fire in plugin order, so this one would run BEFORE the append. `post` runs once the
+    // file's whole traversal is finished, which is the first point at which the call is there to see.
+    post(this: PluginPass, file: BabelFile) {
+      const state = this
+      file.path.traverse({
+        CallExpression(path) {
+          const callee = path.node.callee
+          if (!t.isIdentifier(callee) || !REFRESH_CALLEE.test(callee.name)) return
+          const args = path.node.arguments
+          // ("esm", import.meta.hot, registry) - anything else is not the call this pass is for.
+          if (args.length !== 3) return
+          const hot = args[1]
+          const registry = args[2]
+          if (hot === undefined || registry === undefined || !isImportMetaHot(t, hot)) return
+          if (!t.isExpression(registry)) return
+          // The replacement's callee is the injected uid, which REFRESH_CALLEE never matches, so the
+          // re-traversal `replaceWith` triggers terminates here.
+          path.replaceWith(
+            t.callExpression(refreshImport(t, path, state), [
+              importMetaMember(t, "url"),
+              acceptClosure(t),
+              registry,
+            ]),
+          )
+        },
+      })
+    },
+  }
+}

package/src/refresh-hot.ts

@@ -0,0 +1,81 @@
+/**
+ * The `solid-refresh` ↔ Bun-dev-server bridge, client-side. Loaded only by a dev-server client bundle
+ * (`solidBunPlugin("dom")` resolves the `nifra:solid-hot` specifier its Babel pass emits); never part of
+ * `nifra build` output.
+ *
+ * `solid-refresh` expects a Vite-shaped `import.meta.hot` handed to it as a VALUE. Bun does not have one:
+ * it rewrites `import.meta.hot.<prop>` at bundle time and substitutes a proxy that throws
+ * (`import.meta.hot.<prop> cannot be used indirectly`) for every other use - so passing the object to a
+ * library function fails on the first property read, whichever property it is. This module supplies the
+ * value-shaped object instead, built from direct member accesses the plugin emits at the call site.
+ *
+ * Two of the three pieces need more than a pass-through:
+ *
+ * - `data` is where `solid-refresh` keeps the previous version's component registry, so it has to be the
+ *   SAME object across every version of a module. Bun's own `data` is a field on a per-version module
+ *   record, so it is not usable for that; the store below is keyed by module URL and lives in this
+ *   module, which no edit invalidates.
+ * - `invalidate` is not implemented in Bun's HMR runtime (it throws). It is the escape hatch
+ *   `solid-refresh` takes when a component's shape changed too much to patch in place, and a full reload
+ *   is exactly the right answer there - so that is what it does.
+ */
+
+import { $$refresh } from "solid-refresh"
+
+/**
+ * Registry store per module URL - see the note above on why Bun's own `hot.data` cannot serve.
+ *
+ * On `globalThis`, not in module scope: Bun re-evaluates an updated module's imports along with it, so
+ * this very module is re-instantiated during an update and a module-scoped Map would come back empty
+ * halfway through. The symptom of getting that wrong is not a lost registry but an infinite one -
+ * `patchRegistry` then compares a registry against itself, points a component's signal at its own proxy,
+ * and the next render recurses until the stack blows.
+ */
+const STORES = Symbol.for("nifra.solid-refresh.stores")
+
+type StoreHost = typeof globalThis & {
+  [STORES]?: Map<string, Record<string, unknown>>
+}
+
+function store(moduleUrl: string): Record<string, unknown> {
+  const host = globalThis as StoreHost
+  host[STORES] ??= new Map<string, Record<string, unknown>>()
+  const stores = host[STORES]
+  let data = stores.get(moduleUrl)
+  if (data === undefined) {
+    data = {}
+    stores.set(moduleUrl, data)
+  }
+  return data
+}
+
+/** The subset of `solid-refresh`'s hot interface its `"esm"` bundler mode actually touches. */
+interface SolidHot {
+  readonly data: Record<string, unknown>
+  accept(callback: (module: unknown) => void): void
+  invalidate(): void
+  decline(): void
+}
+
+/**
+ * Run `solid-refresh`'s update handshake for one module.
+ *
+ * `moduleUrl` identifies the module across versions; `accept` is a closure the plugin emits around
+ * `import.meta.hot.accept`, which is the only form Bun's bundler will rewrite. `registry` is the
+ * component registry this version of the module built.
+ */
+export function refresh(
+  moduleUrl: string,
+  accept: (callback: (module: unknown) => void) => void,
+  registry: unknown,
+): void {
+  const reload = (): void => {
+    location.reload()
+  }
+  const hot: SolidHot = { data: store(moduleUrl), accept, invalidate: reload, decline: reload }
+  // `$$refresh`'s published signature is a discriminated tuple over every bundler mode it supports, so
+  // the "esm" arm cannot be selected by a cast on the hot object alone. The mode string and the shape
+  // above are what pin it; the call itself is what has to be re-typed.
+  const esmRefresh = $$refresh as unknown as (mode: "esm", hot: SolidHot, registry: unknown) => void
+  esmRefresh("esm", hot, registry)
+}

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"
 /**
  * `@nifrajs/web-solid/router` - Solid routing bindings over the agnostic `@nifrajs/web` history layer:
  * `useNavigate` (programmatic navigation), `useBlocker` (the unsaved-changes guard), and `useSearch`
@@ -26,7 +34,7 @@ import {
   useContext,
 } from "solid-js"
 
-export type { Blocker, BlockerFunction, BlockerState, NavigateFunction } from "@nifrajs/web"
+export type { Blocker, BlockerFunction, BlockerState, NavigateFunction }
 
 // Frozen empty search + a stable accessor for a `useSearch` used outside a nifra route tree.
 const EMPTY_SEARCH: Readonly<Record<string, unknown>> = Object.freeze({})