fuzor 0.3.0 → 0.5.0

package/dist/create-delegate.d.ts

@@ -0,0 +1,17 @@
+export type CreateArguments = {
+    readonly directory?: string;
+    readonly yes?: boolean;
+    readonly install?: boolean;
+};
+/** `npm exec` arguments that run the creator released with this exact framework version. */
+export declare function creatorArguments(version: string, args: CreateArguments): string[];
+export declare class CreatorError extends Error {
+    readonly _tag = "CreatorError";
+}
+/** Runs the creator and reports npm availability, failure exits and interruption distinctly. */
+export declare function runCreator(version: string, args: CreateArguments, options?: {
+    readonly npm?: string;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly stdio?: "inherit" | "ignore";
+}): Promise<void>;
+//# sourceMappingURL=create-delegate.d.ts.map

package/dist/create-delegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-delegate.d.ts","sourceRoot":"","sources":["../src/create-delegate.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAElH,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE,CAOjF;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,kBAAkB;CAChC;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BlM"}

package/dist/create-delegate.js

@@ -0,0 +1,48 @@
+import { spawn } from "node:child_process";
+/** `npm exec` arguments that run the creator released with this exact framework version. */
+export function creatorArguments(version, args) {
+    const command = ["exec", "--yes", "--package", `create-fuzor@${version}`, "--", "create-fuzor"];
+    // `--` above stops npm option parsing, so directories that look like flags reach the creator intact.
+    if (args.directory)
+        command.push(args.directory);
+    if (args.yes)
+        command.push("--yes");
+    if (args.install)
+        command.push("--install");
+    return command;
+}
+export class CreatorError extends Error {
+    _tag = "CreatorError";
+}
+/** Runs the creator and reports npm availability, failure exits and interruption distinctly. */
+export function runCreator(version, args, options = {}) {
+    const npm = options.npm ?? (process.platform === "win32" ? "npm.cmd" : "npm");
+    return new Promise((resolve, reject) => {
+        const windows = process.platform === "win32";
+        // Node requires a shell for npm.cmd on Windows; quote arguments because the shell does not.
+        const argv = creatorArguments(version, args).map(value => windows && /[\s"&|<>^()%!]/.test(value) ? `"${value.replaceAll('"', '""')}"` : value);
+        const child = spawn(npm, argv, { stdio: options.stdio ?? "inherit", env: options.env ?? process.env, shell: windows });
+        const forward = (signal) => () => { child.kill(signal); };
+        const onInt = forward("SIGINT");
+        const onTerm = forward("SIGTERM");
+        process.once("SIGINT", onInt);
+        process.once("SIGTERM", onTerm);
+        const cleanup = () => { process.removeListener("SIGINT", onInt); process.removeListener("SIGTERM", onTerm); };
+        child.once("error", error => {
+            cleanup();
+            reject(error.code === "ENOENT"
+                ? new CreatorError(`npm was not found. Install Node.js with npm, or run "pnpm dlx create-fuzor@${version}" instead.`)
+                : new CreatorError(`Could not start create-fuzor@${version}: ${error.message}`));
+        });
+        child.once("exit", (code, signal) => {
+            cleanup();
+            if (code === 0)
+                resolve();
+            else if (signal)
+                reject(new CreatorError(`create-fuzor@${version} was interrupted (${signal}). No dependencies were installed by Fuzor; remove a partially created directory before retrying.`));
+            else
+                reject(new CreatorError(`create-fuzor@${version} exited with code ${code}. Check the npm output above; offline installs need create-fuzor@${version} in the npm cache.`));
+        });
+    });
+}
+//# sourceMappingURL=create-delegate.js.map

package/dist/create-delegate.js.map

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

package/dist/electron.d.ts

@@ -0,0 +1,5 @@
+/** Source for the small, dependency-free Electron host emitted by an electron build. */
+export declare function electronMainSource(preload?: string): string;
+export declare function electronPreloadSource(): string;
+export declare function writeElectronScaffold(directory: string): Promise<void>;
+//# sourceMappingURL=electron.d.ts.map

package/dist/electron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"electron.d.ts","sourceRoot":"","sources":["../src/electron.ts"],"names":[],"mappings":"AAGA,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,OAAO,SAAgB,GAAG,MAAM,CAalE;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAM9C;AAED,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5E"}

package/dist/electron.js

@@ -0,0 +1,32 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+/** Source for the small, dependency-free Electron host emitted by an electron build. */
+export function electronMainSource(preload = "preload.mjs") {
+    return `import { app, BrowserWindow } from "electron";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const root = path.dirname(fileURLToPath(import.meta.url));
+const createWindow = () => {
+  const window = new BrowserWindow({ webPreferences: { contextIsolation: true, nodeIntegration: false, preload: path.join(root, ${JSON.stringify(preload)}) } });
+  return window.loadFile(path.join(root, "index.html"));
+};
+app.whenReady().then(createWindow);
+app.on("window-all-closed", () => { if (process.platform !== "darwin") app.quit(); });
+app.on("activate", () => { if (BrowserWindow.getAllWindows().length === 0) void createWindow(); });
+`;
+}
+export function electronPreloadSource() {
+    return `import { contextBridge, ipcRenderer } from "electron";
+contextBridge.exposeInMainWorld("electronAPI", {
+  invoke: (channel, ...args) => ipcRenderer.invoke(channel, ...args)
+});
+`;
+}
+export async function writeElectronScaffold(directory) {
+    await mkdir(directory, { recursive: true });
+    await Promise.all([
+        writeFile(path.join(directory, "main.mjs"), electronMainSource(), "utf8"),
+        writeFile(path.join(directory, "preload.mjs"), electronPreloadSource(), "utf8")
+    ]);
+}
+//# sourceMappingURL=electron.js.map

package/dist/electron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"electron.js","sourceRoot":"","sources":["../src/electron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAC,OAAO,GAAG,aAAa;IACxD,OAAO;;;;;kIAKyH,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;;;;;;CAMxJ,CAAC;AACF,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;CAIR,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,SAAiB;IAC3D,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,kBAAkB,EAAE,EAAE,MAAM,CAAC;QACzE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,qBAAqB,EAAE,EAAE,MAAM,CAAC;KAChF,CAAC,CAAC;AACL,CAAC"}

package/dist/html-escape.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Output boundaries for build-time HTML assembly.
+ *
+ * Inline module scripts: `\x3C` is `<` inside JS strings, template literals and regular expressions,
+ * so replacing `<` in `</script` and `<!--` preserves semantics while preventing the HTML parser from
+ * closing the element early or entering the double-escaped script state. Module code cannot contain
+ * those sequences outside strings, comments or regular expressions.
+ */
+export declare function inlineScript(source: string): string;
+/** `\3C ` is `<` in CSS strings and identifiers; outside those `</style` is not valid CSS. */
+export declare function inlineStyle(source: string): string;
+/** JSON inside `<script type="application/json">`; `<` escapes cover `</script` and `<!--`. */
+export declare function jsonScript(value: unknown): string;
+export declare function escapeAttribute(value: string): string;
+export declare function escapeText(value: string): string;
+//# sourceMappingURL=html-escape.d.ts.map

package/dist/html-escape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-escape.d.ts","sourceRoot":"","sources":["../src/html-escape.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,8FAA8F;AAC9F,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,+FAA+F;AAC/F,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/html-escape.js

@@ -0,0 +1,26 @@
+/**
+ * Output boundaries for build-time HTML assembly.
+ *
+ * Inline module scripts: `\x3C` is `<` inside JS strings, template literals and regular expressions,
+ * so replacing `<` in `</script` and `<!--` preserves semantics while preventing the HTML parser from
+ * closing the element early or entering the double-escaped script state. Module code cannot contain
+ * those sequences outside strings, comments or regular expressions.
+ */
+export function inlineScript(source) {
+    return source.replace(/<(?=\/script|!--)/gi, "\\x3C");
+}
+/** `\3C ` is `<` in CSS strings and identifiers; outside those `</style` is not valid CSS. */
+export function inlineStyle(source) {
+    return source.replace(/<(?=\/style)/gi, "\\3C ");
+}
+/** JSON inside `<script type="application/json">`; `<` escapes cover `</script` and `<!--`. */
+export function jsonScript(value) {
+    return JSON.stringify(value).replaceAll("<", "\\u003c").replaceAll("\u2028", "\\u2028").replaceAll("\u2029", "\\u2029");
+}
+export function escapeAttribute(value) {
+    return value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("<", "&lt;");
+}
+export function escapeText(value) {
+    return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;");
+}
+//# sourceMappingURL=html-escape.js.map

package/dist/html-escape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-escape.js","sourceRoot":"","sources":["../src/html-escape.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC1H,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC"}

package/dist/index.d.ts

@@ -1,8 +1,10 @@
-export { compileProject, compileProjectEffect } from "./compiler/index.js";
-export { CompilerError, CompilerFileSystem, CompilerFileSystemLive } from "./compiler/index.js";
-export type { CompiledProject, CompiledRoute } from "./compiler/index.js";
+export { compileProject, compileProjectEffect, CompileCache } from "./compiler/index.js";
+export { CompilerError, CompilerFileSystem, CompilerFileSystemLive, isDocsDir, officialDocsLayout } from "./compiler/index.js";
+export type { CompiledProject, CompiledRoute, CompileOptions } from "./compiler/index.js";
 export { fuzorPlugin } from "./vite.js";
 export type { FuzorPluginOptions } from "./vite.js";
+export { createEnvironmentModuleRuntime, detectViteEnvironmentApi, FUZOR_ENVIRONMENTS, invalidateEnvironmentModule, normalizeEnvironmentConfiguration } from "./vite-environments.js";
+export type { FuzorEnvironmentConfiguration, FuzorEnvironmentName, ViteEnvironmentCapability } from "./vite-environments.js";
 export * as Schema from "effect/Schema";
-export { Effect } from "effect";
+export * as Effect from "effect/Effect";
 //# 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":"AAAA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAChG,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC/H,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,iCAAiC,EAAE,MAAM,wBAAwB,CAAC;AACtL,YAAY,EAAE,6BAA6B,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAC7H,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,6 +1,7 @@
-export { compileProject, compileProjectEffect } from "./compiler/index.js";
-export { CompilerError, CompilerFileSystem, CompilerFileSystemLive } from "./compiler/index.js";
+export { compileProject, compileProjectEffect, CompileCache } from "./compiler/index.js";
+export { CompilerError, CompilerFileSystem, CompilerFileSystemLive, isDocsDir, officialDocsLayout } from "./compiler/index.js";
 export { fuzorPlugin } from "./vite.js";
+export { createEnvironmentModuleRuntime, detectViteEnvironmentApi, FUZOR_ENVIRONMENTS, invalidateEnvironmentModule, normalizeEnvironmentConfiguration } from "./vite-environments.js";
 export * as Schema from "effect/Schema";
-export { Effect } from "effect";
+export * as Effect from "effect/Effect";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEhG,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE/H,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,iCAAiC,EAAE,MAAM,wBAAwB,CAAC;AAEtL,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC"}

package/dist/islands/hydration.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Build-time previews and client output can differ (dates, random values, browser-only branches). Fuzor's
+ * policy: keep the island working by rendering on the client, and report the mismatch as a warning plus a
+ * bubbling `fuzor:hydration-mismatch` event whose detail is `{ island, framework, error }`.
+ */
+export declare function reportHydrationMismatch(host: HTMLElement, framework: "react" | "solid" | "vue", error: unknown): void;
+//# sourceMappingURL=hydration.d.ts.map

package/dist/islands/hydration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydration.d.ts","sourceRoot":"","sources":["../../src/islands/hydration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,KAAK,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAKrH"}

package/dist/islands/hydration.js

@@ -0,0 +1,12 @@
+/**
+ * Build-time previews and client output can differ (dates, random values, browser-only branches). Fuzor's
+ * policy: keep the island working by rendering on the client, and report the mismatch as a warning plus a
+ * bubbling `fuzor:hydration-mismatch` event whose detail is `{ island, framework, error }`.
+ */
+export function reportHydrationMismatch(host, framework, error) {
+    const island = host.getAttribute("src") ?? "unknown";
+    console.warn(`[fuzor] Hydration mismatch in ${framework} island "${island}": the browser output differs from the build-time preview, so it was rendered on the client. Avoid dates, random values and browser-only branches during the first render.`, error);
+    const View = host.ownerDocument.defaultView?.CustomEvent ?? CustomEvent;
+    host.dispatchEvent(new View("fuzor:hydration-mismatch", { bubbles: true, detail: { island, framework, error } }));
+}
+//# sourceMappingURL=hydration.js.map

package/dist/islands/hydration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydration.js","sourceRoot":"","sources":["../../src/islands/hydration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAiB,EAAE,SAAoC,EAAE,KAAc;IAC7G,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;IACrD,OAAO,CAAC,IAAI,CAAC,iCAAiC,SAAS,YAAY,MAAM,4KAA4K,EAAE,KAAK,CAAC,CAAC;IAC9P,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,WAAW,IAAI,WAAW,CAAC;IACxE,IAAI,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,0BAA0B,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;AACpH,CAAC"}

package/dist/islands/react.d.ts

@@ -1,8 +1,15 @@
-import { type ComponentType } from "react";
+import { type ComponentType, type ReactElement } from "react";
+import type { ClientOperation, ClientConnection } from "../server-components/browser.js";
 export declare function reactIsland<Props extends Record<string, unknown>>(Component: ComponentType<Props>): {
-    mount: ((host: HTMLElement, props: Props) => () => void) & {
+    mount: ((host: HTMLElement, props: Props) => Promise<() => void>) & {
         component: ComponentType<Props>;
+        element: (props: Props) => ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
         framework: "react";
     };
+    mountPersistent: (host: HTMLElement, props: Props, operation?: ClientOperation) => Promise<{
+        update: (next: Props, update?: ClientOperation) => Promise<void>;
+        dispose: () => void;
+    }>;
+    connected: ClientConnection;
 };
 //# sourceMappingURL=react.d.ts.map

package/dist/islands/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/islands/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAG1D,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC;mBAC7D,WAAW,SAAS,KAAK;;;;EAc7D"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/islands/react.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiF,KAAK,aAAa,EAAE,KAAK,YAAY,EAAkB,MAAM,OAAO,CAAC;AAG7J,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAwBzF,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC;mBAsC7D,WAAW,SAAS,KAAK;;yBACnB,KAAK;;;4BA7Bf,WAAW,SAAS,KAAK,cAAc,eAAe;uBAuBhE,KAAK,WAAW,eAAe;;;;EASrD"}

package/dist/islands/react.js

@@ -1,19 +1,78 @@
-import { createElement } from "react";
+import * as Effect from "effect/Effect";
+import * as Semaphore from "effect/Semaphore";
+import { Component as ReactComponent, Fragment, createElement, useLayoutEffect, useRef } from "react";
+import { createPortal } from "react-dom";
 import { createRoot, hydrateRoot } from "react-dom/client";
+import { reportHydrationMismatch } from "./hydration.js";
+function IslandRoot(props) {
+    useLayoutEffect(() => { props.onCommit?.(); }, [props.onCommit]);
+    return props.children;
+}
+class IslandBoundary extends ReactComponent {
+    state = { failed: false };
+    static getDerivedStateFromError() { return { failed: true }; }
+    componentDidCatch(error) { this.props.onError(error); }
+    render() { return this.state.failed ? null : this.props.children; }
+}
+/** The server DOM remains owned by Fuzor; portals keep descendant React context connected. */
+function ServerSlot(props) {
+    const ref = useRef(null);
+    useLayoutEffect(() => {
+        const wrapper = ref.current;
+        wrapper.append(props.host);
+        return () => { props.host.remove(); };
+    }, [props.host]);
+    return createElement("fuzor-connected-slot", { ref }, props.children);
+}
 export function reactIsland(Component) {
-    const mount = Object.assign((host, props) => {
-        const element = createElement(Component, props);
-        const id = host.getAttribute("data-fuzor-island-id");
-        if (host.hasAttribute("data-fuzor-prerendered")) {
-            const root = hydrateRoot(host, element, id ? { identifierPrefix: `fuzor-${id}-` } : {});
-            return () => root.unmount();
-        }
-        const root = createRoot(host);
-        root.render(element);
-        return () => root.unmount();
-    }, { component: Component, framework: "react" });
-    return {
-        mount
+    const component = (props, children) => createElement(Component, { ...props, ...(children === undefined ? {} : { children: children }) });
+    const element = (props, onCommit, children) => createElement(IslandRoot, { onCommit, children: component(props, children) });
+    const connected = {
+        family: createElement,
+        element: (props, children) => component(props, children),
+        portal: (host, child, key) => createPortal(child, host, key),
+        group: (key, children) => createElement(Fragment, { key }, children),
+        slot: (host, children) => createElement(ServerSlot, { host, children: children }),
+    };
+    const mountPersistent = (host, props, operation) => {
+        let root;
+        let disposed = false;
+        const lock = Semaphore.makeUnsafe(1);
+        const commit = (props, children) => Effect.callback(resume => {
+            if (disposed) {
+                resume(Effect.fail(new Error("React island disposed")));
+                return;
+            }
+            const tree = createElement(IslandBoundary, { onError: error => resume(Effect.fail(error)), children: element(props, () => resume(Effect.void), children) });
+            try {
+                if (root)
+                    root.render(tree);
+                else {
+                    const id = host.getAttribute("data-fuzor-island-id");
+                    root = host.hasAttribute("data-fuzor-prerendered")
+                        ? hydrateRoot(host, tree, { ...(id ? { identifierPrefix: `fuzor-${id}-` } : {}), onRecoverableError: error => reportHydrationMismatch(host, "react", error) })
+                        : createRoot(host);
+                    if (!host.hasAttribute("data-fuzor-prerendered"))
+                        root.render(tree);
+                }
+            }
+            catch (error) {
+                resume(Effect.fail(error));
+            }
+        });
+        const dispose = () => { if (!disposed) {
+            disposed = true;
+            root?.unmount();
+        } };
+        return Effect.runPromise(commit(props, operation?.children).pipe(Effect.timeout("10 seconds"), Effect.onExit(exit => Effect.sync(() => { if (exit._tag === "Failure")
+            dispose(); })), Effect.map(() => ({
+            update: (next, update) => Effect.runPromise(lock.withPermit(commit(next, update?.children)).pipe(Effect.timeout("10 seconds")), update ? { signal: update.signal } : undefined),
+            dispose,
+        }))), operation ? { signal: operation.signal } : undefined);
     };
+    const mount = Object.assign((host, props) => mountPersistent(host, props).then(instance => () => instance.dispose()), {
+        component: Component, element: (props) => element(props), framework: "react",
+    });
+    return { mount, mountPersistent, connected };
 }
 //# sourceMappingURL=react.js.map

package/dist/islands/react.js.map

@@ -1 +1 @@
-{"version":3,"file":"react.js","sourceRoot":"","sources":["../../src/islands/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAsB,MAAM,OAAO,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,UAAU,WAAW,CAAwC,SAA+B;IAChG,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAiB,EAAE,KAAY,EAAE,EAAE;QAC9D,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC;QACrD,IAAI,IAAI,CAAC,YAAY,CAAC,wBAAwB,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACxF,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,OAAgB,EAAE,CAAC,CAAC;IAC1D,OAAO;QACL,KAAK;KACN,CAAC;AACJ,CAAC"}
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../src/islands/react.ts"],"names":[],"mappings":"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"}

package/dist/islands/solid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"solid.d.ts","sourceRoot":"","sources":["../../src/islands/solid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAG3D,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC;mBACzD,WAAW,SAAS,KAAK;;;;EAU7D"}
+{"version":3,"file":"solid.d.ts","sourceRoot":"","sources":["../../src/islands/solid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAI3D,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC;mBACzD,WAAW,SAAS,KAAK;;;;EAiB7D"}

package/dist/islands/solid.js

@@ -1,10 +1,19 @@
 import { createComponent } from "solid-js";
 import { hydrate, render } from "solid-js/web";
+import { reportHydrationMismatch } from "./hydration.js";
 export function solidIsland(Component) {
     const mount = Object.assign((host, props) => {
         if (host.hasAttribute("data-fuzor-prerendered")) {
             const id = host.getAttribute("data-fuzor-island-id");
-            return hydrate(() => createComponent(Component, props), host, id ? { renderId: id } : {});
+            try {
+                return hydrate(() => createComponent(Component, props), host, id ? { renderId: id } : {});
+            }
+            catch (error) {
+                // Solid throws when the preview does not contain the nodes it expects; render fresh instead.
+                reportHydrationMismatch(host, "solid", error);
+                host.replaceChildren();
+                return render(() => createComponent(Component, props), host);
+            }
         }
         return render(() => createComponent(Component, props), host);
     }, { component: Component, framework: "solid" });

package/dist/islands/solid.js.map

@@ -1 +1 @@
-{"version":3,"file":"solid.js","sourceRoot":"","sources":["../../src/islands/solid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkB,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,UAAU,WAAW,CAAwC,SAA2B;IAC5F,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAiB,EAAE,KAAY,EAAE,EAAE;QAC9D,IAAI,IAAI,CAAC,YAAY,CAAC,wBAAwB,CAAC,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC;YACrD,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IAC/D,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,OAAgB,EAAE,CAAC,CAAC;IAC1D,OAAO;QACL,KAAK;KACN,CAAC;AACJ,CAAC"}
+{"version":3,"file":"solid.js","sourceRoot":"","sources":["../../src/islands/solid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkB,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,MAAM,UAAU,WAAW,CAAwC,SAA2B;IAC5F,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAiB,EAAE,KAAY,EAAE,EAAE;QAC9D,IAAI,IAAI,CAAC,YAAY,CAAC,wBAAwB,CAAC,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC;YACrD,IAAI,CAAC;gBACH,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5F,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,6FAA6F;gBAC7F,uBAAuB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC9C,IAAI,CAAC,eAAe,EAAE,CAAC;gBACvB,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IAC/D,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,OAAgB,EAAE,CAAC,CAAC;IAC1D,OAAO;QACL,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/islands/vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../../src/islands/vue.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,KAAK,CAAC;AAE9D,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS;gBAE9B,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAQ1D"}
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../../src/islands/vue.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,KAAK,CAAC;AAG9D,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS;gBAE9B,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAgB1D"}

package/dist/islands/vue.js

@@ -1,10 +1,22 @@
 import { createApp, createSSRApp } from "vue";
+import { reportHydrationMismatch } from "./hydration.js";
 export function vueIsland(Component) {
     return {
         mount(host, props) {
-            const app = host.hasAttribute("data-fuzor-prerendered")
-                ? createSSRApp(Component, props)
-                : createApp(Component, props);
+            const prerendered = host.hasAttribute("data-fuzor-prerendered");
+            const app = prerendered ? createSSRApp(Component, props) : createApp(Component, props);
+            if (prerendered) {
+                // Vue patches mismatches itself. Its warnings (development builds) are forwarded as Fuzor reports.
+                const previous = app.config.warnHandler;
+                app.config.warnHandler = (message, instance, trace) => {
+                    if (/hydration/i.test(message))
+                        reportHydrationMismatch(host, "vue", new Error(message));
+                    else if (previous)
+                        previous(message, instance, trace);
+                    else
+                        console.warn(`[Vue warn]: ${message}${trace}`);
+                };
+            }
             app.mount(host);
             return () => app.unmount();
         }

package/dist/islands/vue.js.map

@@ -1 +1 @@
-{"version":3,"file":"vue.js","sourceRoot":"","sources":["../../src/islands/vue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAkB,MAAM,KAAK,CAAC;AAE9D,MAAM,UAAU,SAAS,CAAC,SAAoB;IAC5C,OAAO;QACL,KAAK,CAAC,IAAiB,EAAE,KAA8B;YACrD,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,wBAAwB,CAAC;gBACrD,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC;gBAChC,CAAC,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAChC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChB,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"vue.js","sourceRoot":"","sources":["../../src/islands/vue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAkB,MAAM,KAAK,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,MAAM,UAAU,SAAS,CAAC,SAAoB;IAC5C,OAAO;QACL,KAAK,CAAC,IAAiB,EAAE,KAA8B;YACrD,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,wBAAwB,CAAC,CAAC;YAChE,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACvF,IAAI,WAAW,EAAE,CAAC;gBAChB,mGAAmG;gBACnG,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC;gBACxC,GAAG,CAAC,MAAM,CAAC,WAAW,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;oBACpD,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC;wBAAE,uBAAuB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;yBACpF,IAAI,QAAQ;wBAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;;wBACjD,OAAO,CAAC,IAAI,CAAC,eAAe,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC;gBACtD,CAAC,CAAC;YACJ,CAAC;YACD,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChB,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/module-specifiers.d.ts

@@ -0,0 +1,5 @@
+import MagicString from "magic-string";
+/** Edit only module syntax. Strings, templates, regexes and comments are application data. */
+export declare function rewriteModuleSpecifiers(source: string, map: (specifier: string) => string | undefined, file?: string, jsxSource?: readonly [string, string]): string;
+export declare function editModuleSpecifiers(source: string, map: (specifier: string) => string | undefined, file?: string, jsxSource?: readonly [string, string]): MagicString;
+//# sourceMappingURL=module-specifiers.d.ts.map

package/dist/module-specifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-specifiers.d.ts","sourceRoot":"","sources":["../src/module-specifiers.ts"],"names":[],"mappings":"AAEA,OAAO,WAAW,MAAM,cAAc,CAAC;AAEvC,8FAA8F;AAC9F,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EAAE,IAAI,SAAK,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAEhK;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EAAE,IAAI,SAAK,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,CA+ClK"}

package/dist/module-specifiers.js

@@ -0,0 +1,80 @@
+import { parse } from "@babel/parser";
+import MagicString from "magic-string";
+/** Edit only module syntax. Strings, templates, regexes and comments are application data. */
+export function rewriteModuleSpecifiers(source, map, file = "", jsxSource) {
+    return editModuleSpecifiers(source, map, file, jsxSource).toString();
+}
+export function editModuleSpecifiers(source, map, file = "", jsxSource) {
+    const ast = parse(source, {
+        sourceType: "unambiguous", allowReturnOutsideFunction: true, allowUndeclaredExports: true,
+        createImportExpressions: true,
+        plugins: ["typescript", "decorators-legacy", "deprecatedImportAssert", ...(/\.[jt]sx(?:\?|$)/.test(file) ? ["jsx"] : [])]
+    });
+    const edits = [];
+    const replace = (node) => {
+        if (!node || node.start == null || node.end == null)
+            return;
+        const original = node.type === "StringLiteral" ? node.value : node.expressions.length === 0 ? node.quasis[0]?.value.cooked : undefined;
+        if (original == null)
+            return;
+        const value = map(original);
+        if (value !== undefined && value !== original)
+            edits.push({ start: node.start, end: node.end, value: JSON.stringify(value) });
+    };
+    const visit = (node) => {
+        switch (node.type) {
+            case "ImportDeclaration":
+            case "ExportNamedDeclaration":
+            case "ExportAllDeclaration":
+                replace(node.source);
+                break;
+            case "ImportExpression":
+                if (node.source.type === "StringLiteral" || node.source.type === "TemplateLiteral")
+                    replace(node.source);
+                break;
+            case "TSImportType":
+                replace(node.argument);
+                break;
+            case "CallExpression":
+                if (node.callee.type === "Identifier" && node.callee.name === "require" && (node.arguments[0]?.type === "StringLiteral" || node.arguments[0]?.type === "TemplateLiteral"))
+                    replace(node.arguments[0]);
+                break;
+            case "TSExternalModuleReference":
+                if (node.expression.type === "StringLiteral")
+                    replace(node.expression);
+                break;
+        }
+        for (const [key, value] of Object.entries(node)) {
+            if (["loc", "extra", "comments", "leadingComments", "trailingComments", "innerComments"].includes(key))
+                continue;
+            if (Array.isArray(value)) {
+                for (const child of value)
+                    if (child && typeof child.type === "string")
+                        visit(child);
+            }
+            else if (value && typeof value === "object" && "type" in value)
+                visit(value);
+        }
+    };
+    visit(ast.program);
+    let hasPragma = false;
+    if (jsxSource)
+        for (const comment of ast.comments ?? []) {
+            const match = /@jsxImportSource\s+([^\s*]+)/.exec(comment.value);
+            if (!match)
+                continue;
+            hasPragma = true;
+            if (match[1] === jsxSource[0] && comment.start != null && comment.end != null) {
+                edits.push({ start: comment.start, end: comment.end, value: source.slice(comment.start, comment.end).replace(/@jsxImportSource\s+[^\s*]+/, `@jsxImportSource ${jsxSource[1]}`) });
+            }
+        }
+    const result = new MagicString(source);
+    for (const edit of edits)
+        result.overwrite(edit.start, edit.end, edit.value);
+    if (jsxSource && !hasPragma) {
+        const position = ast.program.interpreter?.end ?? 0;
+        result.appendLeft(position, `\n/** @jsxImportSource ${jsxSource[1]} */\n`);
+    }
+    return result;
+}
+//# sourceMappingURL=module-specifiers.js.map

package/dist/module-specifiers.js.map

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

package/dist/route-path.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Route key policy shared by the compiler, generated servers and the client router.
+ *
+ * - Keys start and end with `/`; the root route is `/`.
+ * - Empty segments are ignored, so `//docs///guide` matches `/docs/guide/`.
+ * - Each segment is decoded, normalized to Unicode NFC and re-encoded with
+ *   `encodeURIComponent`, so `/a+b/`, `/a%2Bb/` and `/caf%c3%a9/` match the
+ *   folders `a+b` and `café` regardless of how a client encoded them.
+ * - Dot segments are resolved by URL parsing before a pathname reaches this
+ *   function. Segments that decode to `.`, `..` or contain `/` or NUL cannot be
+ *   folder names and never match a route.
+ */
+export declare function routeKey(pathname: string): string | undefined;
+/** Route key for a compiled folder path made of unencoded filesystem segments. */
+export declare function routeKeyFromSegments(segments: readonly string[]): string;
+/**
+ * Deployment base path policy. Path bases such as Vite's `base: "/docs-site/"` prefix every document
+ * URL. Relative (`./`) and absolute-URL bases only affect asset URLs, so routes stay at the origin root.
+ */
+export declare function normalizeBase(base: string | undefined): string;
+/** Removes a normalized base path; returns undefined for URLs outside the deployment. */
+export declare function stripBase(pathname: string, base: string): string | undefined;
+/** Prefixes a root-relative logical URL (path, query and hash) with a normalized base path. */
+export declare function withBase(href: string, base: string): string;
+/** Selects the boundary scope (a route key prefix) nearest to a route key. */
+export declare function nearestScope(route: string, scopes: Iterable<string>): string | undefined;
+/** Server data for a page is served below this path, inside the deployment base. */
+export declare const serverDataPrefix = "/_fuzor/data";
+/** Data endpoint URL for a route key, for example `/docs-site/_fuzor/data/notes/hello/`. */
+export declare function serverDataUrl(route: string, base: string): string;
+/** Same logical URL policy for parser-time selection and the hash navigation adapter. */
+export declare function hashRouteUrl(transport: URL, base: URL, initialPath?: string): URL;
+//# sourceMappingURL=route-path.d.ts.map

package/dist/route-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-path.d.ts","sourceRoot":"","sources":["../src/route-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW7D;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAGxE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI9D;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI5E;AAED,+FAA+F;AAC/F,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,CAMxF;AAED,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,GAAG,CAGjF"}