@janit/fu 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jani Tarvainen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,300 @@
+# Fresh Urquell
+
+A minimal islands framework: file-system routing, SSR and hydration on
+Preact 11, built by [rolldown](https://rolldown.rs) and served by
+[Nitro](https://nitro.build). Runs on **Deno, Node and Bun**.
+
+No Vite, no Babel, no esbuild. The bundler, JSX transform and CSS engine are
+all Rust.
+
+```
+core     ~300 lines   router + render + client + hmr runtime
+drivers  ~400 lines   build + dev + shared rolldown plugins
+```
+
+## What this is
+
+Fresh Urquell is inspired by [Deno Fresh](https://usefresh.dev/), and aims to be
+just a single pint of glue code — enough to form a functional, simple framework
+on top of known good libraries, and no more. The interesting work already lives
+in Preact, rolldown, Nitro and lightningcss; this only binds them together.
+
+It is experimental and primarily just for myself. Use it accordingly.
+
+## Installing it
+
+```sh
+deno add npm:@janit/fu        # or: npm i @janit/fu
+```
+
+Install from **npm**, not JSR. The framework hands its own runtime modules to
+rolldown, and a bundler cannot resolve a remote module — Deno keeps JSR packages
+as `https:` URLs, so `jsr:@janit/fu` builds nothing. npm gives a real directory
+on disk. (The JSR copy exists for reading the API and for runtime-only use.)
+
+The npm package ships compiled JavaScript, because Deno refuses to type-strip
+TypeScript inside `node_modules`.
+
+## Quick start
+
+```sh
+npm install        # once: installs the toolchain (rolldown, nitro, lightningcss)
+
+deno task dev      # example app, dev server with HMR on 0.0.0.0:1337
+deno task build    # example app, production build
+
+deno task todo:dev     # the fu-todo example app
+deno task todo:build
+deno task todo:start   # serve its build on :1337
+
+deno task test     # 41 unit tests
+deno task check    # types + tests + jsr publish dry-run
+```
+
+Both example apps build against **this checkout's `src/`**, never a published
+package, so the framework and the apps can be changed and tested together
+before anything is released. `npm install` at the root is the only setup step;
+it serves the whole repo.
+
+Then run the build on whichever runtime you like — one artifact, three runtimes:
+
+```sh
+node example/.output/server/index.mjs
+bun  example/.output/server/index.mjs
+deno run -A example/.output/server/index.mjs
+```
+
+## Project shape
+
+```
+app.ts                            middleware chain (optional)
+state.ts                          your State type
+middleware/*.ts                   one concern per file
+routes/_app.tsx                   shell wrapping every page (optional)
+routes/index.tsx              ->  /
+routes/about.tsx              ->  /about
+routes/blog/[slug].tsx        ->  /blog/:slug
+routes/files/[...rest].tsx    ->  /files/:rest*
+islands/Counter.tsx               interactive, hydrated on the client
+islands/counter.module.css        CSS Modules, scoped
+```
+
+Files under `routes/` starting with `_` are framework files, not routes.
+
+A route exports a page component, and optionally `handlers`:
+
+```tsx
+export const handlers = {
+  GET: () => ({ renderedAt: new Date().toISOString() }),
+};
+
+export default function About(ctx: PageContext) {
+  return <p>{(ctx.data as { renderedAt: string }).renderedAt}</p>;
+}
+```
+
+Return a `Response` from a handler to short-circuit; return anything else and
+it lands on `ctx.data`.
+
+## Middleware
+
+`app.ts` composes an ordered chain. Registration order is outermost first, so
+the first registered runs first on the way in and **unwinds last** — it has the
+final say on headers, including on short-circuit responses from further in.
+
+```ts
+import { App } from "@janit/fu";
+
+const app = new App<State>();
+
+app.use(async (ctx) => {                 // outermost: unwinds last
+  const res = await ctx.next();
+  res.headers.set("X-Frame-Options", "SAMEORIGIN");
+  return res;
+});
+
+app.use((ctx) =>                         // short-circuit: never calls next()
+  ctx.url.pathname === "/healthz"
+    ? new Response("ok")
+    : ctx.next()
+);
+
+app.use((ctx) => {                       // populate state for everything below
+  ctx.state.tenant = resolveTenant(ctx.req);
+  return ctx.next();
+});
+
+export default app;
+```
+
+A middleware either returns a `Response` (short-circuiting) or returns
+`ctx.next()`. Await `next()` first to inspect or mutate the response. Throwing
+propagates outward past any `await ctx.next()`.
+
+Middleware runs **before** routing, so `ctx.params` is empty inside it — match
+on `ctx.url.pathname`. That is what lets a middleware answer a request no route
+exists for: redirects, `/healthz`, `/robots.txt`.
+
+Redirects need nothing special — read state, read the URL, return a response:
+
+```ts
+export const redirects: Middleware<State> = (ctx) => {
+  const hit = table[ctx.url.pathname];
+  if (!hit) return ctx.next();
+  return new Response(null, { status: hit.status, headers: { location: hit.to } });
+};
+```
+
+## Errors
+
+Anything thrown by a handler, a page or a middleware is turned into a response
+rather than reaching the server as an unhandled crash. So are 404 and 405.
+
+```ts
+import { HttpError } from "@janit/fu";
+
+export const handlers = {
+  GET(ctx) {
+    if (!ctx.state.session) throw new HttpError(403, "Not yours");
+    ...
+  },
+};
+```
+
+An optional `routes/_error.tsx` renders them, receiving `ctx` like any page with
+`ctx.error` set to `{ status, message }`. It is wrapped by `routes/_app.tsx`, so
+error pages inherit the app's markup. Without one you get plain text.
+
+Two things the framework does for you:
+
+- **A 500 never renders its underlying message.** `ctx.error.message` is generic
+  for 5xx; the real error goes to `ctx.error.cause` and is logged, because a
+  thrown error's message routinely carries connection strings and file paths.
+  A `4xx` keeps whatever message you gave it.
+- **No failure is cacheable.** Error responses carry `no-store` and `noindex`.
+  During a deploy a valid URL can 404 for a few seconds, and a shared cache
+  would pin that.
+
+Errors are caught at the route boundary and returned *through* the middleware
+chain, so security headers and logging middleware still see them.
+
+## Page metadata
+
+`ctx.head` is the channel from a route to the document `<head>`. Middleware can
+write to it too.
+
+```ts
+export const handlers = {
+  GET: (ctx: PageContext<State>) => {
+    ctx.head.title = `${ctx.params.slug} — Fresh Urquell`;
+    ctx.head.canonical = `${ctx.url.origin}/blog/${ctx.params.slug}`;
+    ctx.head.jsonLd = { "@context": "https://schema.org", "@type": "BlogPosting" };
+    return null;
+  },
+};
+```
+
+The framework renders `title`, `description`, `canonical`, `robots`, `image`,
+`lang`, arbitrary `links` and a JSON-LD block. An optional `routes/_app.tsx`
+wraps the body markup and can read `ctx.state`.
+
+An island is any component under `islands/`. It renders on the server and
+hydrates on the client:
+
+```tsx
+import { useSignal } from "@preact/signals";
+import styles from "./counter.module.css";
+
+export default function Counter({ start = 0 }) {
+  const n = useSignal(start);
+  return <button class={styles.badge} onClick={() => n.value++}>{n}</button>;
+}
+```
+
+## What works
+
+Routing (static, dynamic and wildcard, via the web-standard `URLPattern`),
+middleware with typed shared state, page metadata, a root shell, SSR, island
+hydration, signals, CSS and CSS Modules with `composes`, native CSS nesting and
+`@layer`, and HMR that preserves component state.
+
+Editing an island hot-swaps its markup **without losing hook state**. Editing
+CSS swaps the stylesheet in place. Editing a route rebuilds the server.
+
+## Architecture
+
+Two layers with a hard boundary. The core is bundler-agnostic — it consumes
+only a route manifest and an asset list, both plain data:
+
+```ts
+type RouteManifest = Record<string, () => Promise<RouteModule>>;
+type Assets = { js: { href: string }[]; css: { href: string }[] };
+```
+
+Everything bundler-specific lives in the drivers (`src/build.ts`, `src/dev.ts`)
+and the shared plugins (`src/plugins.ts`). The same core ran unchanged under a
+Vite driver during prototyping, so swapping the build layer stays cheap.
+
+See [the design doc](docs/design.md) for
+the full rationale and the nine undocumented traps this implementation encodes.
+
+## Tests
+
+```sh
+deno task test
+```
+
+`deno test` over `src/`, no browser needed. The suite is written against the
+failure modes this framework actually hit, so each one guards a real regression:
+
+| area | what it pins down |
+|---|---|
+| router | static beats dynamic beats wildcard; wildcards span segments; params decode |
+| middleware | outer unwinds last and decorates inner short-circuits; `next()` twice rejects; throws propagate |
+| render | head escaping; JSON-LD cannot close its own `<script>`; 404 vs 405; islands get a marker |
+| errors | a 500 never leaks its message; error responses are uncacheable; a broken error page falls back |
+| plugins | `composes` keeps every class name; CSS output changes with content; the JSX transform never touches rolldown's runtime; the H3Event unwrap |
+
+Two of these were found by writing the suite, not before it: `ctx.next()` called
+twice resumed at the wrong depth, and a middleware throwing synchronously
+escaped the chain entirely instead of rejecting.
+
+## Publishing
+
+Two public repos ship from this private one, each as a squashed snapshot so no
+private history leaks:
+
+```sh
+./scripts/publish.sh      --dry-run --tag v0.0.1 "First public release"  # -> janit/fu
+./scripts/publish-todo.sh --dry-run --tag v0.0.1 "First public release"  # -> janit/fu-todo
+```
+
+`scripts/publish-lib.sh` holds the mechanics: a baseline exclude list that is
+the privacy boundary, a staged-tree backstop that refuses the push if anything
+private reaches the index anyway, semver tagging derived from the public repo's
+existing tags, and version stamping so the git tag and `deno.json` cannot drift.
+`fu-todo/` is stripped from `janit/fu`; the framework specifier is rewritten
+from `../src/mod.ts` on the way into `janit/fu-todo`.
+
+## Known gaps
+
+- **Adding or removing a hook** in an island breaks hook order during HMR. It
+  does not crash, but needs a manual refresh.
+- Naming an anonymous `export default () => {}` island shifts source positions,
+  so that one module's sourcemap is dropped rather than left wrong.
+- `urlpattern-polyfill` is bundled even on Deno and Bun, which have
+  `URLPattern` natively — ~24 kB of dead weight there (never executed).
+- No sourcemaps in dev, no error overlay, no prerendering, no per-route CSS
+  splitting.
+- No per-directory `_middleware.ts`. Middleware is registered programmatically
+  in `app.ts`; scope it with a path check. (Measured against a real app: nested
+  middleware had zero uses across 43 middleware.)
+- Deliberately absent: partials, streaming SSR, nested layouts.
+
+## Status
+
+Alpha, and built on deliberately unstable ground: Preact 11 is a release
+candidate, Nitro 3 is beta, and rolldown's `devMode` is marked *"not ready for
+public usage"*. That instability is an accepted trade.
+
+MIT.

package/dist/app.d.ts

@@ -0,0 +1,25 @@
+import type { Ctx, Middleware } from "./types.ts";
+export declare function compose<S>(middleware: readonly Middleware<S>[], terminal: (ctx: Ctx<S>) => Response | Promise<Response>): (ctx: Ctx<S>) => Promise<Response>;
+/**
+ * The application: an ordered middleware chain.
+ *
+ * ```ts
+ * const app = new App<State>();
+ * app.use(securityHeaders);
+ * app.use(resolveTenant);
+ * export default app;
+ * ```
+ *
+ * Middleware runs before routing, so `ctx.params` is empty inside it — match on
+ * `ctx.url.pathname` instead. That is deliberate: it lets a middleware answer a
+ * request (a redirect, `/healthz`, `/robots.txt`) without a route existing.
+ */
+export declare class App<S = Record<string, unknown>> {
+    #private;
+    /** Register a middleware. Returns `this` so calls can chain. */
+    use(middleware: Middleware<S>): this;
+    /** The registered chain, in registration order. */
+    get middleware(): readonly Middleware<S>[];
+    /** Wrap a terminal handler in this app's chain. */
+    compose(terminal: (ctx: Ctx<S>) => Response | Promise<Response>): (ctx: Ctx<S>) => Promise<Response>;
+}

package/dist/app.js

@@ -0,0 +1,80 @@
+/**
+ * Composes a middleware chain around a terminal handler.
+ *
+ * The chain is an onion: the first middleware registered is outermost, so it
+ * runs first on the way in and unwinds last on the way out — which is what lets
+ * it overwrite headers any inner middleware set. A middleware that returns
+ * without calling `ctx.next()` short-circuits everything beneath it.
+ *
+ * `ctx.state` and `ctx.head` are shared by reference across the whole chain, so
+ * mutations are visible both further in and further out. Each level otherwise
+ * gets its own shallow copy, which is what makes `next` per-level.
+ */
+function settle(fn) {
+    try {
+        return Promise.resolve(fn());
+    }
+    catch (err) {
+        return Promise.reject(err);
+    }
+}
+export function compose(middleware, terminal) {
+    return (root) => {
+        const dispatch = (i, prev) => {
+            const mw = middleware[i];
+            // A middleware or handler that throws SYNCHRONOUSLY would otherwise
+            // escape the composed function entirely rather than rejecting, and no
+            // downstream .catch would ever see it.
+            if (!mw)
+                return settle(() => terminal(prev));
+            // Each level gets its own ctx so that `next` is bound to THAT level.
+            // A single shared object cannot work: the inner dispatch would overwrite
+            // `ctx.next`, and an outer middleware calling it a second time would
+            // silently resume at the wrong depth instead of failing.
+            let called = false;
+            const ctx = {
+                ...prev,
+                next: () => {
+                    if (called) {
+                        return Promise.reject(new Error("fu: ctx.next() called more than once in one middleware"));
+                    }
+                    called = true;
+                    return dispatch(i + 1, ctx);
+                },
+            };
+            return settle(() => mw(ctx));
+        };
+        return dispatch(0, root);
+    };
+}
+/**
+ * The application: an ordered middleware chain.
+ *
+ * ```ts
+ * const app = new App<State>();
+ * app.use(securityHeaders);
+ * app.use(resolveTenant);
+ * export default app;
+ * ```
+ *
+ * Middleware runs before routing, so `ctx.params` is empty inside it — match on
+ * `ctx.url.pathname` instead. That is deliberate: it lets a middleware answer a
+ * request (a redirect, `/healthz`, `/robots.txt`) without a route existing.
+ */
+export class App {
+    #middleware = [];
+    /** Register a middleware. Returns `this` so calls can chain. */
+    use(middleware) {
+        this.#middleware.push(middleware);
+        return this;
+    }
+    /** The registered chain, in registration order. */
+    get middleware() {
+        return this.#middleware;
+    }
+    /** Wrap a terminal handler in this app's chain. */
+    compose(terminal) {
+        return compose(this.#middleware, terminal);
+    }
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,SAAS,MAAM,CAAC,EAAsC;IACpD,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,UAAoC,EACpC,QAAuD;IAEvD,OAAO,CAAC,IAAY,EAAqB,EAAE;QACzC,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,IAAY,EAAqB,EAAE;YAC9D,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;YACzB,oEAAoE;YACpE,sEAAsE;YACtE,uCAAuC;YACvC,IAAI,CAAC,EAAE;gBAAE,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YAE7C,qEAAqE;YACrE,yEAAyE;YACzE,qEAAqE;YACrE,yDAAyD;YACzD,IAAI,MAAM,GAAG,KAAK,CAAC;YACnB,MAAM,GAAG,GAAW;gBAClB,GAAG,IAAI;gBACP,IAAI,EAAE,GAAG,EAAE;oBACT,IAAI,MAAM,EAAE,CAAC;wBACX,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CAAC,wDAAwD,CAAC,CACpE,CAAC;oBACJ,CAAC;oBACD,MAAM,GAAG,IAAI,CAAC;oBACd,OAAO,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC9B,CAAC;aACF,CAAC;YACF,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC;QACF,OAAO,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,GAAG;IACL,WAAW,GAAoB,EAAE,CAAC;IAE3C,gEAAgE;IAChE,GAAG,CAAC,UAAyB;QAC3B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mDAAmD;IACnD,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,mDAAmD;IACnD,OAAO,CACL,QAAuD;QAEvD,OAAO,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/build.d.ts

@@ -0,0 +1,4 @@
+import type { FuOptions } from "./types.ts";
+export declare function build(opts: FuOptions): Promise<void>;
+/** Concatenate collected stylesheets into one hashed file. Returns its name. */
+export declare function writeSheets(dir: string, sheets: Map<string, string>): string | null;

package/dist/build.js

@@ -0,0 +1,108 @@
+// Production driver: rolldown builds the client, nitro builds the server.
+import { rolldown } from "rolldown";
+import { build as nitroBuild, copyPublicAssets, createNitro } 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 build(opts) {
+    const root = path.resolve(opts.root);
+    const outDir = opts.outDir ? path.resolve(opts.outDir) : path.join(root, ".output");
+    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"));
+    // ---- client ----
+    fs.rmSync(clientDir, { recursive: true, force: true });
+    fs.mkdirSync(clientDir, { recursive: true });
+    const sheets = new Map();
+    const bundle = await rolldown({
+        input: { boot: "fu:boot" },
+        plugins: [
+            virtual({ "fu:boot": bootModule(path.join(HERE, `client${EXT}`), islandFiles, root) }),
+            css(sheets),
+            jsx(),
+        ],
+        platform: "browser",
+        // rolldown types modules by extension and refuses to bundle CSS; css()
+        // has already replaced their contents with JS.
+        moduleTypes: { ".css": "js" },
+    });
+    const result = await bundle.write({
+        dir: clientDir,
+        format: "esm",
+        entryFileNames: "[name]-[hash].js",
+        chunkFileNames: "[name]-[hash].js",
+    });
+    await bundle.close();
+    const entry = result.output.find((o) => o.type === "chunk" && o.isEntry);
+    if (!entry)
+        throw new Error("fu: client build produced no entry chunk");
+    const cssHref = writeSheets(clientDir, sheets);
+    // ---- server ----
+    fs.rmSync(genDir, { recursive: true, force: true });
+    fs.mkdirSync(genDir, { recursive: true });
+    const assets = {
+        js: [{ href: "/" + entry.fileName }],
+        css: cssHref ? [{ href: "/" + cssHref }] : [],
+    };
+    // nitro path-resolves `handlers[].handler`, so a virtual id would not survive
+    // its routing codegen — generate a real file.
+    const ssrEntry = path.join(genDir, "ssr.ts");
+    fs.writeFileSync(ssrEntry, ssrModule({
+        renderPath: path.join(HERE, `render${EXT}`),
+        routeFiles,
+        root,
+        assets: JSON.stringify(assets),
+        appPath: optional(root, "app.ts", "app.tsx"),
+        shellPath: optional(root, "routes/_app.tsx"),
+        errorPath: optional(root, "routes/_error.tsx"),
+    }));
+    const nitro = await createNitro({
+        rootDir: root,
+        // Point nitro's scanner at the generated dir, never the project root, or it
+        // claims `routes/` as its own server routes and shadows our catch-all.
+        serverDir: genDir,
+        scanDirs: [],
+        output: { dir: outDir },
+        publicAssets: [{ dir: clientDir, baseURL: "/" }],
+        handlers: [{ route: "/**", handler: ssrEntry, format: "web", lazy: false }],
+        rollupConfig: {
+            // Islands are imported on the server too, so SSR needs the same handling.
+            plugins: [css(new Map()), jsx({ stampIslands: true })],
+            moduleTypes: { ".css": "js" },
+        },
+    });
+    await copyPublicAssets(nitro);
+    await nitroBuild(nitro);
+}
+/** Concatenate collected stylesheets into one hashed file. Returns its name. */
+export function writeSheets(dir, sheets) {
+    if (sheets.size === 0)
+        return null;
+    const merged = [...sheets.values()].join("\n");
+    let h = 7;
+    for (let i = 0; i < merged.length; i++)
+        h = (Math.imul(h, 31) + merged.charCodeAt(i)) >>> 0;
+    const name = `style-${h.toString(36)}.css`;
+    fs.writeFileSync(path.join(dir, name), merged);
+    return name;
+}
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env -S deno run -A
+export declare function main(argv: string[]): Promise<void>;

package/dist/cli.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env -S deno run -A
+import { build } from "./build.js";
+import { dev } from "./dev.js";
+export async function main(argv) {
+    const [cmd = "dev", ...rest] = argv;
+    const portArg = rest.find((a) => a.startsWith("--port="));
+    const hostArg = rest.find((a) => a.startsWith("--host="));
+    const rootArg = rest.find((a) => !a.startsWith("-"));
+    const opts = {
+        root: rootArg ?? Deno?.cwd?.() ?? process.cwd(),
+        port: portArg ? Number(portArg.slice("--port=".length)) : undefined,
+        hostname: hostArg ? hostArg.slice("--host=".length) : undefined,
+    };
+    if (cmd === "build")
+        await build(opts);
+    else if (cmd === "dev")
+        await dev(opts);
+    else {
+        console.error(`fu: unknown command "${cmd}" (expected dev|build)`);
+        throw new Error(`unknown command: ${cmd}`);
+    }
+}
+if (import.meta.main)
+    await main(globalThis.process?.argv.slice(2) ?? []);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc;IACvC,MAAM,CAAC,GAAG,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,OAAO,IAAI,IAAI,EAAE,GAAG,EAAE,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE;QAC/C,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QACnE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;KAChE,CAAC;IACF,IAAI,GAAG,KAAK,OAAO;QAAE,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;SAClC,IAAI,GAAG,KAAK,KAAK;QAAE,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;SACnC,CAAC;QACJ,OAAO,CAAC,KAAK,CAAC,wBAAwB,GAAG,wBAAwB,CAAC,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAID,IAAI,OAAO,IAAI,CAAC,IAAI;IAAE,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,7 @@
+import { type FunctionComponent } from "preact";
+type Props = Record<string, unknown>;
+/** Hydrate every `[data-island]` marker the server rendered. */
+export declare function hydrateIslands(manifest: Record<string, () => Promise<{
+    default: FunctionComponent<Props>;
+}>>): Promise<void>;
+export {};

package/dist/client.js

@@ -0,0 +1,59 @@
+import { h, hydrate, render } from "preact";
+const mounted = new Map();
+const proxies = new Map();
+let hmrVersion = 0;
+/**
+ * Wrap an island in a component whose *identity* never changes. Preact keys
+ * hook state to the component type, so swapping the implementation behind a
+ * stable wrapper lets the instance — and therefore its signals — survive HMR
+ * without a Babel-based fast-refresh transform.
+ *
+ * Adding or removing a hook still changes hook order; that case needs a reload.
+ */
+function proxyFor(key, impl) {
+    const existing = proxies.get(key);
+    if (existing) {
+        existing.impl.current = impl;
+        return existing;
+    }
+    const holder = { current: impl };
+    // `__hmr` is a cache-buster: bumping it makes Preact re-render this instance
+    // (same type, so hooks survive) and pick up the swapped implementation. It is
+    // stripped before reaching the island.
+    const Component = ({ __hmr: _ignored, ...props }) => holder.current(props);
+    const entry = { Component, impl: holder };
+    proxies.set(key, entry);
+    return entry;
+}
+/** Hydrate every `[data-island]` marker the server rendered. */
+export async function hydrateIslands(manifest) {
+    for (const el of document.querySelectorAll("[data-island]")) {
+        const key = el.dataset.island;
+        const loader = manifest[key];
+        if (!loader) {
+            console.warn("[fu] no island module for", key);
+            continue;
+        }
+        const mod = await loader();
+        const props = JSON.parse(el.dataset.props || "{}");
+        hydrate(h(proxyFor(key, mod.default).Component, props), el);
+        const list = mounted.get(key) ?? [];
+        list.push({ el, props });
+        mounted.set(key, list);
+    }
+    installHmrHook();
+}
+/** Exposed for the HMR runtime to call after a module is hot-swapped. */
+function installHmrHook() {
+    globalThis.__fu_hmr__ = (key, mod) => {
+        const list = mounted.get(key);
+        if (!list?.length)
+            return;
+        const { Component } = proxyFor(key, mod.default);
+        const stamp = ++hmrVersion;
+        for (const { el, props } of list)
+            render(h(Component, { ...props, __hmr: stamp }), el);
+        console.debug(`[fu] hmr: re-rendered ${list.length}x ${key}`);
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/dev.d.ts

@@ -0,0 +1,2 @@
+import type { FuOptions } from "./types.ts";
+export declare function dev(opts: FuOptions): Promise<void>;