@janit/fu 0.0.2

package/dist/dev.js

@@ -0,0 +1,167 @@
+// Dev driver: rolldown DevEngine (HMR patches) + crossws (transport) +
+// nitro dev server (SSR). No Vite anywhere.
+import { DevEngine } from "rolldown/experimental";
+import { serve } from "crossws/server";
+import { build as nitroBuild, createDevServer, createNitro, prepare } from "nitro/builder";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { bootModule, css, jsx, optional, ssrModule, virtual, walk } from "./plugins.js";
+/**
+ * Directory holding the framework's own runtime modules, whose paths are handed
+ * to rolldown. `import.meta.dirname` is undefined when this module is loaded
+ * from a remote URL, and a bundler cannot fetch `https:` modules anyway — so
+ * fail with the reason rather than a TypeError three frames later.
+ */
+const HERE = import.meta.dirname ?? remoteFrameworkError();
+/**
+ * Extension of the framework's own runtime modules: `.ts` when running from
+ * source (this repo, or JSR), `.js` when running from the compiled npm build.
+ */
+const EXT = import.meta.url.endsWith(".js") ? ".js" : ".ts";
+function remoteFrameworkError() {
+    throw new Error("fu: the framework is loaded from a remote URL (" + import.meta.url + "), " +
+        "so its runtime modules cannot be handed to the bundler. Install it " +
+        "instead — `npm:@janit/fu` in a Deno import map, or `npm i @janit/fu` — " +
+        "so it resolves to a real directory.");
+}
+export async function dev(opts) {
+    const root = path.resolve(opts.root);
+    const port = opts.port ?? 1337;
+    // Bind all interfaces so the dev server is reachable from other machines
+    // and from inside containers, not just loopback.
+    const hostname = opts.hostname ?? "0.0.0.0";
+    const hmrPort = port + 1;
+    const clientDir = path.join(root, "dist/client");
+    const genDir = path.join(root, ".fu");
+    const routeFiles = walk(root, path.join(root, "routes"));
+    const islandFiles = walk(root, path.join(root, "islands"));
+    fs.rmSync(clientDir, { recursive: true, force: true });
+    fs.mkdirSync(clientDir, { recursive: true });
+    const sheets = new Map();
+    const peers = new Map();
+    let cssVersion = 0;
+    const writeSheets = () => {
+        if (sheets.size)
+            fs.writeFileSync(path.join(clientDir, "style.css"), [...sheets.values()].join("\n"));
+    };
+    // `implement` takes the runtime SOURCE, not a path — a path gets inlined
+    // literally and parsed as a regex. `$ADDR` is only substituted in rolldown's
+    // own default runtime, so do it here.
+    const hmrRuntime = fs.readFileSync(path.join(HERE, "hmr-runtime.js"), "utf8")
+        .replaceAll("$ADDR", `localhost:${hmrPort}`);
+    const engine = await DevEngine.create({
+        input: { boot: "fu:boot" },
+        plugins: [
+            virtual({ "fu:boot": bootModule(path.join(HERE, `client${EXT}`), islandFiles, root) }),
+            css(sheets),
+            jsx({ hmr: true }),
+        ],
+        platform: "browser",
+        moduleTypes: { ".css": "js" },
+        experimental: { devMode: { host: "localhost", port: hmrPort, implement: hmrRuntime } },
+    }, { dir: clientDir, format: "esm", entryFileNames: "[name].js", chunkFileNames: "[name].js" }, {
+        watch: { enabled: true },
+        onOutput(o) {
+            if (o instanceof Error)
+                return console.error("[fu] client build failed:", o.message);
+            writeSheets();
+        },
+        onHmrUpdates(r) {
+            if (r instanceof Error)
+                return console.error("[fu] hmr error:", r.message);
+            writeSheets();
+            for (const { clientId, update } of r.updates) {
+                const peer = peers.get(clientId);
+                if (!peer || update.type === "Noop")
+                    continue;
+                if (update.type === "FullReload") {
+                    peer.send(JSON.stringify({ type: "hmr:reload" }));
+                    continue;
+                }
+                // Always deliver the patch for real. Reporting a payload as delivered
+                // when it was not corrupts per-client shipped-state and updates stop
+                // firing silently.
+                fs.writeFileSync(path.join(clientDir, update.filename), update.code);
+                peer.send(JSON.stringify({
+                    type: "hmr:update",
+                    path: "/" + update.filename,
+                    url: "/" + update.filename,
+                    changedIds: update.changedIds,
+                }));
+                engine.notifyPayloadDelivered(update.filename);
+                if ((update.changedIds ?? []).some((id) => id.endsWith(".css"))) {
+                    peer.send(JSON.stringify({ type: "fu:css", href: `/style.css?v=${++cssVersion}` }));
+                }
+            }
+        },
+    });
+    await engine.run();
+    await engine.ensureLatestBuildOutput();
+    // Transport. Inline hooks behave uniformly across node/deno/bun; returning a
+    // plain `{crossws}` object from `fetch` fails on Deno.
+    const clientIdOf = (peer) => {
+        const raw = peer?.request?.url;
+        if (!raw)
+            return null;
+        try {
+            return new URL(raw, "http://localhost").searchParams.get("clientId");
+        }
+        catch {
+            return null;
+        }
+    };
+    serve({
+        port: hmrPort,
+        fetch: () => new Response("fu hmr"),
+        websocket: {
+            async open(peer) {
+                const id = clientIdOf(peer);
+                if (!id)
+                    return;
+                peers.set(id, peer);
+                await engine.registerClient(id);
+                peer.send(JSON.stringify({ type: "connected" }));
+            },
+            async close(peer) {
+                const id = clientIdOf(peer);
+                if (!id)
+                    return;
+                peers.delete(id);
+                await engine.removeClient(id);
+            },
+        },
+    });
+    // SSR.
+    fs.rmSync(genDir, { recursive: true, force: true });
+    fs.mkdirSync(genDir, { recursive: true });
+    const ssrEntry = path.join(genDir, "ssr.ts");
+    const assets = `{ js: [{ href: "/boot.js" }], css: [{ href: "/style.css" }] }`;
+    fs.writeFileSync(ssrEntry, ssrModule({
+        renderPath: path.join(HERE, `render${EXT}`),
+        routeFiles,
+        root,
+        assets,
+        appPath: optional(root, "app.ts", "app.tsx"),
+        shellPath: optional(root, "routes/_app.tsx"),
+        errorPath: optional(root, "routes/_error.tsx"),
+    }));
+    const nitro = await createNitro({
+        dev: true,
+        rootDir: root,
+        serverDir: genDir,
+        scanDirs: [],
+        publicAssets: [{ dir: clientDir, baseURL: "/" }],
+        handlers: [{ route: "/**", handler: ssrEntry, format: "web", lazy: false }],
+        rollupConfig: {
+            plugins: [css(new Map()), jsx({ stampIslands: true })],
+            moduleTypes: { ".css": "js" },
+        },
+    });
+    const server = createDevServer(nitro);
+    server.listen({ port, hostname });
+    // Order matters: listen -> prepare -> build. `build` starts the dev runner.
+    await prepare(nitro);
+    await nitroBuild(nitro);
+    console.log(`[fu] dev http://localhost:${port} (bound ${hostname}:${port})`);
+}
+//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,4CAA4C;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,KAAK,IAAI,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAGxF;;;;;GAKG;AACH,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,OAAO,IAAI,oBAAoB,EAAE,CAAC;AAE3D;;;GAGG;AACH,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AAE5D,SAAS,oBAAoB;IAC3B,MAAM,IAAI,KAAK,CACb,iDAAiD,GAAG,OAAO,IAAI,CAAC,GAAG,GAAG,KAAK;QACzE,qEAAqE;QACrE,yEAAyE;QACzE,qCAAqC,CACxC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAe;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;IAC/B,yEAAyE;IACzE,iDAAiD;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC;IACzB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAEtC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAE3D,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwC,CAAC;IAC9D,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,IAAI,MAAM,CAAC,IAAI;YAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACxG,CAAC,CAAC;IAEF,yEAAyE;IACzE,6EAA6E;IAC7E,sCAAsC;IACtC,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;SAC1E,UAAU,CAAC,OAAO,EAAE,aAAa,OAAO,EAAE,CAAC,CAAC;IAE/C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CACnC;QACE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC1B,OAAO,EAAE;YACP,OAAO,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC;YACtF,GAAG,CAAC,MAAM,CAAC;YACX,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;SACnB;QACD,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAC7B,YAAY,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE;KAC7C,EAC3C,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,EAC3F;QACE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QACxB,QAAQ,CAAC,CAAC;YACR,IAAI,CAAC,YAAY,KAAK;gBAAE,OAAO,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YACrF,WAAW,EAAE,CAAC;QAChB,CAAC;QACD,YAAY,CAAC,CAAC;YACZ,IAAI,CAAC,YAAY,KAAK;gBAAE,OAAO,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YAC3E,WAAW,EAAE,CAAC;YACd,KAAK,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACjC,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;oBAAE,SAAS;gBAC9C,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBACjC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;oBAClD,SAAS;gBACX,CAAC;gBACD,sEAAsE;gBACtE,qEAAqE;gBACrE,mBAAmB;gBACnB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;oBACvB,IAAI,EAAE,YAAY;oBAClB,IAAI,EAAE,GAAG,GAAG,MAAM,CAAC,QAAQ;oBAC3B,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC,QAAQ;oBAC1B,UAAU,EAAE,MAAM,CAAC,UAAU;iBAC9B,CAAC,CAAC,CAAC;gBACJ,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC/C,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;oBAChE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;gBACtF,CAAC;YACH,CAAC;QACH,CAAC;KACF,CACF,CAAC;IACF,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;IACnB,MAAM,MAAM,CAAC,uBAAuB,EAAE,CAAC;IAEvC,6EAA6E;IAC7E,uDAAuD;IACvD,MAAM,UAAU,GAAG,CAAC,IAAoC,EAAiB,EAAE;QACzE,MAAM,GAAG,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC;QAC/B,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,IAAI,CAAC;YAAC,OAAO,IAAI,GAAG,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IACtG,CAAC,CAAC;IACF,KAAK,CAAC;QACJ,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC;QACnC,SAAS,EAAE;YACT,KAAK,CAAC,IAAI,CAAC,IAAI;gBACb,MAAM,EAAE,GAAG,UAAU,CAAC,IAAa,CAAC,CAAC;gBACrC,IAAI,CAAC,EAAE;oBAAE,OAAO;gBAChB,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAa,CAAC,CAAC;gBAC7B,MAAM,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;gBAC/B,IAA2C,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;YAC3F,CAAC;YACD,KAAK,CAAC,KAAK,CAAC,IAAI;gBACd,MAAM,EAAE,GAAG,UAAU,CAAC,IAAa,CAAC,CAAC;gBACrC,IAAI,CAAC,EAAE;oBAAE,OAAO;gBAChB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACjB,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAChC,CAAC;SACF;KAC6B,CAAC,CAAC;IAElC,OAAO;IACP,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,+DAA+D,CAAC;IAC/E,EAAE,CAAC,aAAa,CACd,QAAQ,EACR,SAAS,CAAC;QACR,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,CAAC;QAC3C,UAAU;QACV,IAAI;QACJ,MAAM;QACN,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC;QAC5C,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;QAC5C,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;KAC/C,CAAC,CACH,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC;QAC9B,GAAG,EAAE,IAAI;QACT,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,MAAM;QACjB,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAChD,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAC3E,YAAY,EAAE;YACZ,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;SAC9B;KACmC,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClC,4EAA4E;IAC5E,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;IACrB,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,WAAW,QAAQ,IAAI,IAAI,GAAG,CAAC,CAAC;AAC/E,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,20 @@
+import type { RouteError } from "./types.ts";
+/**
+ * Throw from a handler or middleware to produce a specific status.
+ *
+ * ```ts
+ * if (!session) throw new HttpError(403, "Not your todo");
+ * ```
+ */
+export declare class HttpError extends Error {
+    readonly status: number;
+    constructor(status: number, message?: string);
+}
+export declare function statusText(status: number): string;
+/**
+ * Normalise anything thrown into a status and a message.
+ *
+ * A `status` property is honoured wherever it appears, so errors from other
+ * libraries (h3, fetch wrappers) map sensibly instead of collapsing to 500.
+ */
+export declare function toRouteError(err: unknown): RouteError;

package/dist/errors.js

@@ -0,0 +1,54 @@
+/**
+ * Throw from a handler or middleware to produce a specific status.
+ *
+ * ```ts
+ * if (!session) throw new HttpError(403, "Not your todo");
+ * ```
+ */
+export class HttpError extends Error {
+    status;
+    constructor(status, message) {
+        super(message ?? statusText(status));
+        this.name = "HttpError";
+        this.status = status;
+    }
+}
+const TEXT = {
+    400: "Bad Request",
+    401: "Unauthorized",
+    403: "Forbidden",
+    404: "Not Found",
+    405: "Method Not Allowed",
+    409: "Conflict",
+    410: "Gone",
+    422: "Unprocessable Content",
+    429: "Too Many Requests",
+    500: "Internal Server Error",
+    502: "Bad Gateway",
+    503: "Service Unavailable",
+};
+export function statusText(status) {
+    return TEXT[status] ?? (status >= 500 ? "Internal Server Error" : "Error");
+}
+/**
+ * Normalise anything thrown into a status and a message.
+ *
+ * A `status` property is honoured wherever it appears, so errors from other
+ * libraries (h3, fetch wrappers) map sensibly instead of collapsing to 500.
+ */
+export function toRouteError(err) {
+    if (err instanceof HttpError) {
+        return { status: err.status, message: err.message, cause: err };
+    }
+    const status = err?.status;
+    if (typeof status === "number" && status >= 400 && status <= 599) {
+        const message = err.message;
+        return {
+            status,
+            message: typeof message === "string" && message ? message : statusText(status),
+            cause: err,
+        };
+    }
+    return { status: 500, message: statusText(500), cause: err };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,MAAM,CAAS;IAExB,YAAY,MAAc,EAAE,OAAgB;QAC1C,KAAK,CAAC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,IAAI,GAA2B;IACnC,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,qBAAqB;CAC3B,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;QAC7B,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAClE,CAAC;IACD,MAAM,MAAM,GAAI,GAAmC,EAAE,MAAM,CAAC;IAC5D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QACjE,MAAM,OAAO,GAAI,GAA6B,CAAC,OAAO,CAAC;QACvD,OAAO;YACL,MAAM;YACN,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;YAC9E,KAAK,EAAE,GAAG;SACX,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAC/D,CAAC"}

package/dist/hmr-runtime.js

@@ -0,0 +1,112 @@
+// @ts-check
+// Fresh Urquell HMR client runtime. Rolldown's default runtime registers new module
+// factories but never *applies* them; this one does the apply walk:
+// swap the module, re-run its factory, then fire its accept callbacks.
+
+/** @type {any} */
+var BaseDevRuntime = DevRuntime;
+
+class ModuleHotContext {
+  /** @type {{ deps: string[], fn: (mod: any) => void }[]} */
+  acceptCallbacks = [];
+  constructor(moduleId, devRuntime) {
+    this.moduleId = moduleId;
+    this.devRuntime = devRuntime;
+  }
+  accept(...args) {
+    if (args.length === 1) {
+      this.acceptCallbacks.push({ deps: [this.moduleId], fn: args[0] });
+    } else if (args.length !== 0) {
+      throw new Error('Invalid arguments for `import.meta.hot.accept`');
+    }
+  }
+  invalidate() {
+    socket.send(JSON.stringify({ type: 'hmr:invalidate', moduleId: this.moduleId }));
+  }
+}
+
+class FuDevRuntime extends BaseDevRuntime {
+  /** @type {Map<string, ModuleHotContext>} */
+  moduleHotContexts = new Map();
+  createModuleHotContext(moduleId) {
+    const ctx = new ModuleHotContext(moduleId, this);
+    this.moduleHotContexts.set(moduleId, ctx);
+    return ctx;
+  }
+}
+
+const clientId = crypto.randomUUID();
+const addr = new URL('ws://$ADDR');
+addr.searchParams.set('clientId', clientId);
+const socket = new WebSocket(addr);
+
+/** @type {any} */
+const runtime = new FuDevRuntime(clientId);
+globalThis.__rolldown_runtime__ ??= runtime;
+
+/**
+ * Apply one patch: import it (registering new factories), then for every
+ * changed module that accepted itself, drop its cache, re-run the factory and
+ * hand the fresh exports to its accept callbacks. Anything that did not accept
+ * falls back to a full reload.
+ */
+async function applyPatch(url, allChangedIds) {
+  const rt = globalThis.__rolldown_runtime__;
+  // Stylesheets are swapped via the <link>, so they never need to accept and
+  // must not drag the page into a full reload.
+  const changedIds = (allChangedIds || []).filter((id) => !id.endsWith('.css'));
+  const selfAccepting = changedIds.filter((id) => {
+    const ctx = rt.moduleHotContexts.get(id);
+    return ctx && ctx.acceptCallbacks.length > 0;
+  });
+  try {
+    await import(url + (url.includes('?') ? '&' : '?') + 't=' + Date.now());
+  } catch (err) {
+    console.error('[hmr] failed to load patch', url, err);
+    location.reload();
+    return;
+  }
+  if (!changedIds || changedIds.length === 0) return;
+  if (selfAccepting.length !== changedIds.length) {
+    console.debug('[hmr] some modules did not accept; reloading');
+    location.reload();
+    return;
+  }
+  for (const id of selfAccepting) {
+    rt.removeModuleCache(id);
+    rt.initModule(id);
+    const exports = rt.loadExports(id);
+    const ctx = rt.moduleHotContexts.get(id);
+    for (const { fn } of ctx ? ctx.acceptCallbacks : []) fn(exports);
+  }
+  console.debug('[hmr] applied', selfAccepting.join(', '));
+}
+
+/**
+ * Swap the stylesheet in place. A new <link> is inserted and the old one is
+ * only removed once the replacement has loaded, so the page never flashes
+ * unstyled.
+ */
+function swapStylesheet(href) {
+  const links = [...document.querySelectorAll('link[rel="stylesheet"]')];
+  const old = links[links.length - 1];
+  const next = document.createElement('link');
+  next.rel = 'stylesheet';
+  next.href = href;
+  next.onload = () => { if (old && old !== next) old.remove(); };
+  (old ? old.parentNode : document.head).insertBefore(next, old ? old.nextSibling : null);
+  console.debug('[hmr] css swapped ->', href);
+}
+
+socket.onmessage = function (event) {
+  const data = JSON.parse(event.data);
+  if (data.type === 'connected') {
+    console.debug('[hmr] connected');
+  } else if (data.type === 'hmr:update') {
+    applyPatch(data.url, data.changedIds);
+  } else if (data.type === 'fu:css') {
+    swapStylesheet(data.href);
+  } else if (data.type === 'hmr:reload') {
+    location.reload();
+  }
+};

package/dist/mod.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Fresh Urquell — a minimal islands framework on Preact, rolldown and Nitro.
+ *
+ * This entrypoint is the bundler-agnostic core: it needs only a route manifest
+ * and an asset list, both plain data. Drivers live in `./build.ts` and
+ * `./dev.ts`.
+ */
+export { App, compose } from "./app.ts";
+export { HttpError, statusText, toRouteError } from "./errors.ts";
+export { createHandler, document, renderError } from "./render.ts";
+export type { HandlerParts, ShellProps } from "./render.ts";
+export { buildRoutes, filePathToPattern, match } from "./router.ts";
+export type { Matched, Route } from "./router.ts";
+export type { Asset, Assets, Ctx, FuOptions, Head, Middleware, PageContext, RouteError, RouteHandler, RouteManifest, RouteModule, } from "./types.ts";

package/dist/mod.js

@@ -0,0 +1,12 @@
+/**
+ * Fresh Urquell — a minimal islands framework on Preact, rolldown and Nitro.
+ *
+ * This entrypoint is the bundler-agnostic core: it needs only a route manifest
+ * and an asset list, both plain data. Drivers live in `./build.ts` and
+ * `./dev.ts`.
+ */
+export { App, compose } from "./app.js";
+export { HttpError, statusText, toRouteError } from "./errors.js";
+export { createHandler, document, renderError } from "./render.js";
+export { buildRoutes, filePathToPattern, match } from "./router.js";
+//# sourceMappingURL=mod.js.map

package/dist/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC"}

package/dist/plugins.d.ts

@@ -0,0 +1,68 @@
+import type { Plugin } from "rolldown";
+export interface JsxOptions {
+    /** Stamp island exports with their module id (SSR build only). */
+    stampIslands?: boolean;
+    /** Inject `import.meta.hot.accept` into islands (dev client only). */
+    hmr?: boolean;
+}
+/**
+ * TypeScript + Preact JSX via oxc — the same native transform Vite delegates
+ * to. Also carries the two island-specific source rewrites, since both need the
+ * transformed output.
+ */
+export declare function jsx(opts?: JsxOptions): Plugin;
+/**
+ * Mark every exported component so the SSR renderer can spot a hydration
+ * boundary from the component function alone.
+ *
+ * Uses oxc's parser rather than a regex: `export const X = () => {}` is the
+ * most natural way to write a Preact component, and a regex over `export
+ * function` silently misses it — the island renders and then never hydrates,
+ * with no error anywhere.
+ *
+ * An anonymous `export default () => {}` has no binding to stamp, so it is
+ * rewritten into a named const. That is the one case that shifts positions and
+ * therefore invalidates the sourcemap, which the caller drops.
+ */
+export declare function stampIslands(js: string, key: string, id: string): {
+    code: string;
+    rewrote: boolean;
+};
+/**
+ * CSS. Rolldown removed CSS bundling and ships no CSS builtin, so the framework
+ * owns the pipeline via lightningcss:
+ *   `*.module.css` -> CSS Modules (scoped names + JS exports object)
+ *   `*.css`        -> global stylesheet
+ * Native nesting, `@layer` and `color-mix` pass straight through.
+ *
+ * Pair this with `moduleTypes: { ".css": "js" }`, or rolldown classifies the
+ * module by extension and refuses to bundle it.
+ */
+export declare function css(collected: Map<string, string>): Plugin;
+/** Serve generated modules by exact id. */
+export declare function virtual(mods: Record<string, string>): Plugin;
+export declare function hash(s: string): string;
+/**
+ * Recursively list source files under `dir`, as root-relative "/a/b.tsx".
+ * Underscore-prefixed files are skipped: they are framework files
+ * (`routes/_app.tsx`), not routes.
+ */
+export declare function walk(root: string, dir: string, out?: string[]): string[];
+/** Absolute path to an optional project file, or null when absent. */
+export declare function optional(root: string, ...names: string[]): string | null;
+/** Generated module bodies both drivers need. */
+export declare function bootModule(clientPath: string, islandFiles: string[], root: string): string;
+export interface SsrModuleOptions {
+    renderPath: string;
+    routeFiles: string[];
+    root: string;
+    /** Serialized Assets literal. */
+    assets: string;
+    /** Absolute path to the project's `app.ts`, if it has one. */
+    appPath?: string | null;
+    /** Absolute path to the project's `routes/_app.tsx`, if it has one. */
+    shellPath?: string | null;
+    /** Absolute path to the project's `routes/_error.tsx`, if it has one. */
+    errorPath?: string | null;
+}
+export declare function ssrModule(o: SsrModuleOptions): string;