@janit/fu 0.0.2

package/dist/plugins.js

@@ -0,0 +1,246 @@
+import { parseSync, transformSync } from "rolldown/experimental";
+import { transform as lightning } from "lightningcss";
+import * as fs from "node:fs";
+import * as path from "node:path";
+/** Files a source transform must never touch. */
+function isInternal(id) {
+    return id.includes("node_modules") ||
+        id.startsWith("\0") ||
+        id.includes("rolldown") ||
+        id.endsWith("hmr-runtime.js");
+}
+/**
+ * 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 function jsx(opts = {}) {
+    return {
+        name: "fu:jsx",
+        transform: {
+            filter: { id: /\.[tj]sx?$/ },
+            handler(code, id) {
+                // Mangling rolldown's own runtime module breaks its internal symbols
+                // (RUNTIME_MODULE_SYMBOL_NOT_FOUND), so bail on anything internal.
+                if (isInternal(id))
+                    return null;
+                const out = transformSync(id, code, {
+                    jsx: { runtime: "automatic", importSource: "preact" },
+                    lang: /\.tsx$/.test(id) ? "tsx" : /\.ts$/.test(id) ? "ts" : "jsx",
+                });
+                let js = out.code;
+                let map = out.map ?? null;
+                const islandKey = islandKeyOf(id);
+                if (islandKey) {
+                    if (opts.stampIslands) {
+                        const stamped = stampIslands(js, islandKey, id);
+                        js = stamped.code;
+                        // Naming an anonymous default export shifts every later position.
+                        if (stamped.rewrote)
+                            map = null;
+                    }
+                    if (opts.hmr)
+                        js += acceptSelf(islandKey);
+                }
+                return { code: js, map };
+            },
+        },
+    };
+}
+function islandKeyOf(id) {
+    const i = id.indexOf("/islands/");
+    return i === -1 ? null : "/islands/" + id.slice(i + "/islands/".length).split("?")[0];
+}
+const NAMED_DECLARATIONS = new Set(["FunctionDeclaration", "ClassDeclaration"]);
+/**
+ * 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 function stampIslands(js, key, id) {
+    const parsed = parseSync(id, js, { sourceType: "module", lang: "tsx" });
+    const body = parsed.program.body ?? [];
+    const names = [];
+    let rewrote = false;
+    let out = js;
+    for (const node of body) {
+        // `export type {...}`, `export interface`: no runtime binding.
+        if (node.exportKind === "type")
+            continue;
+        if (node.type === "ExportNamedDeclaration") {
+            // `export ... from "./x"` re-exports nothing into local scope.
+            if (node.source)
+                continue;
+            const decl = node.declaration;
+            if (decl?.type === "VariableDeclaration") {
+                for (const d of decl.declarations ?? []) {
+                    if (d.id?.name)
+                        names.push(d.id.name);
+                }
+            }
+            else if (decl && NAMED_DECLARATIONS.has(decl.type)) {
+                if (decl.id?.name)
+                    names.push(decl.id.name);
+            }
+            else {
+                for (const sp of node.specifiers ?? []) {
+                    if (sp.local?.name)
+                        names.push(sp.local.name);
+                }
+            }
+            continue;
+        }
+        if (node.type === "ExportDefaultDeclaration") {
+            const decl = node.declaration;
+            if (decl && NAMED_DECLARATIONS.has(decl.type) && decl.id?.name) {
+                names.push(decl.id.name);
+            }
+            else if (decl) {
+                // `export default <expression>` — give it a name so it can be stamped.
+                const head = js.slice(node.start, decl.start);
+                if (head.includes("export default")) {
+                    out = out.slice(0, node.start) +
+                        head.replace("export default", "const __fu_default =") +
+                        out.slice(decl.start);
+                    names.push("__fu_default");
+                    rewrote = true;
+                }
+            }
+        }
+    }
+    if (names.length === 0)
+        return { code: out, rewrote };
+    const tail = names
+        .map((n) => `try{${n}.__island=${JSON.stringify(key)}}catch{}`)
+        .join("\n");
+    const reexport = rewrote ? "\nexport default __fu_default;" : "";
+    return { code: `${out}${reexport}\n${tail}\n`, rewrote };
+}
+/** Accept our own updates so rolldown patches the module instead of reloading. */
+function acceptSelf(key) {
+    return `\nif (import.meta.hot) { import.meta.hot.accept((mod) => { ` +
+        `globalThis.__fu_hmr__ && globalThis.__fu_hmr__(${JSON.stringify(key)}, mod); ` +
+        `}); }\n`;
+}
+/**
+ * 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 function css(collected) {
+    return {
+        name: "fu:css",
+        transform: {
+            filter: { id: /\.css$/ },
+            handler(code, id) {
+                const isModule = /\.module\.css$/.test(id.split("?")[0]);
+                const out = lightning({
+                    filename: id,
+                    code: Buffer.from(code),
+                    minify: true,
+                    cssModules: isModule,
+                });
+                const text = out.code.toString();
+                collected.set(id, text);
+                // The emitted JS must change when the stylesheet does. Class names hash
+                // from the *filename*, so without this stamp an edit produces
+                // byte-identical JS, rolldown correctly emits no update, and CSS HMR
+                // silently never fires.
+                const stamp = `export const __css = ${JSON.stringify(hash(text))};`;
+                if (!isModule)
+                    return { code: `export default {};\n${stamp}`, map: null };
+                // `composes` yields SEVERAL class names; dropping the extras loses the
+                // composed styles with no error.
+                const names = Object.fromEntries(Object.entries(out.exports ?? {}).map(([k, v]) => [
+                    k,
+                    [v.name, ...(v.composes ?? []).map((c) => c.name)].join(" "),
+                ]));
+                return { code: `export default ${JSON.stringify(names)};\n${stamp}`, map: null };
+            },
+        },
+    };
+}
+/** Serve generated modules by exact id. */
+export function virtual(mods) {
+    return {
+        name: "fu:virtual",
+        resolveId: (id) => (id in mods ? "\0" + id : null),
+        load: (id) => (id.startsWith("\0") && id.slice(1) in mods ? mods[id.slice(1)] : null),
+    };
+}
+export function hash(s) {
+    let h = 7;
+    for (let i = 0; i < s.length; i++)
+        h = (Math.imul(h, 31) + s.charCodeAt(i)) >>> 0;
+    return h.toString(36);
+}
+/**
+ * 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 function walk(root, dir, out = []) {
+    if (!fs.existsSync(dir))
+        return out;
+    for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+        const f = path.join(dir, e.name);
+        if (e.isDirectory())
+            walk(root, f, out);
+        else if (/\.[tj]sx?$/.test(e.name) && !e.name.startsWith("_")) {
+            out.push("/" + path.relative(root, f).split(path.sep).join("/"));
+        }
+    }
+    return out;
+}
+/** Absolute path to an optional project file, or null when absent. */
+export function optional(root, ...names) {
+    for (const n of names) {
+        const p = path.resolve(root, n);
+        if (fs.existsSync(p))
+            return p;
+    }
+    return null;
+}
+/** Generated module bodies both drivers need. */
+export function bootModule(clientPath, islandFiles, root) {
+    return `
+import { hydrateIslands } from ${JSON.stringify(clientPath)};
+hydrateIslands({
+${islandFiles.map((f) => `  ${JSON.stringify(f)}: () => import(${JSON.stringify(path.resolve(root, "." + f))})`).join(",\n")}
+});
+`;
+}
+export function ssrModule(o) {
+    const lines = [
+        `import { createHandler } from ${JSON.stringify(o.renderPath)};`,
+    ];
+    if (o.appPath)
+        lines.push(`import app from ${JSON.stringify(o.appPath)};`);
+    if (o.shellPath)
+        lines.push(`import Shell from ${JSON.stringify(o.shellPath)};`);
+    if (o.errorPath)
+        lines.push(`import ErrorPage from ${JSON.stringify(o.errorPath)};`);
+    lines.push(`const routes = {`, o.routeFiles
+        .map((f) => `  ${JSON.stringify(f)}: () => import(${JSON.stringify(path.resolve(o.root, "." + f))})`)
+        .join(",\n"), `};`, `const assets = ${o.assets};`, `const handler = createHandler({`, `  manifest: routes,`, `  assets,`, o.appPath ? `  app,` : `  app: undefined,`, o.shellPath ? `  Shell,` : `  Shell: undefined,`, o.errorPath ? `  ErrorPage,` : `  ErrorPage: undefined,`, `});`, 
+    // Nitro invokes the handler with an H3Event, not a Request. The event
+    // exposes `url`/`headers` directly — which is why routing worked long
+    // before anyone read a body — but has no json()/text()/formData(). The
+    // real Request is `event.req`.
+    `const toRequest = (input) => input instanceof Request ? input : (input?.req ?? input);`, `export default (input) => handler(toRequest(input));`, ``);
+    return lines.join("\n");
+}
+//# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

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

package/dist/render.d.ts

@@ -0,0 +1,38 @@
+import { type ComponentType } from "preact";
+import type { App } from "./app.ts";
+import type { Assets, Ctx, Head, RouteManifest } from "./types.ts";
+/** Optional root wrapper (`routes/_app.tsx`) around every page. */
+export interface ShellProps<S = Record<string, unknown>> {
+    ctx: Ctx<S>;
+    children: unknown;
+}
+export interface HandlerParts<S> {
+    manifest: RouteManifest<S>;
+    assets: Assets;
+    /** Middleware chain. Omit for no middleware. */
+    app?: App<S>;
+    /** `routes/_app.tsx` default export, if the project has one. */
+    Shell?: ComponentType<ShellProps<S>>;
+    /**
+     * `routes/_error.tsx` default export, if the project has one. It receives
+     * `ctx` exactly like a page component, with `ctx.error` set.
+     */
+    ErrorPage?: (ctx: Ctx<S>) => unknown;
+    /** Initial state for each request. Shallow-copied per request. */
+    initialState?: () => S;
+}
+/**
+ * Build the request handler: middleware chain wrapped around routing + render.
+ *
+ * Middleware runs before routing so it can answer a request no route matches.
+ */
+export declare function createHandler<S = Record<string, unknown>>(parts: HandlerParts<S>): (req: Request) => Promise<Response>;
+/**
+ * Turn a failure into a response. Rendered through `routes/_error.tsx` when the
+ * project has one, so it inherits the app's markup and styling; otherwise plain
+ * text. Either way it goes back out through the middleware chain as a normal
+ * response, so security headers and logging still apply.
+ */
+export declare function renderError<S>(ctx: Ctx<S>, err: unknown, parts: HandlerParts<S>): Promise<Response>;
+/** Assemble the HTML document from the page body, head metadata and assets. */
+export declare function document(body: string, head: Head, assets: Assets): string;

package/dist/render.js

@@ -0,0 +1,189 @@
+import { h, options } from "preact";
+import { renderToStringAsync } from "preact-render-to-string";
+import { buildRoutes, match } from "./router.js";
+import { HttpError, statusText, toRouteError } from "./errors.js";
+/** Property the SSR transform stamps onto island exports. */
+const ISLAND = "__island";
+const wrapped = new WeakMap();
+let hookInstalled = false;
+/**
+ * Intercept island components during render. Preact's `options.vnode` hook
+ * fires for every vnode created, so an island is recognised from the stamp the
+ * SSR transform left on the component itself — no separate registry.
+ *
+ * The wrapper forwards to an arrow that does NOT carry the stamp, so rendering
+ * the island's own output does not re-enter this branch.
+ */
+function installIslandHook() {
+    if (hookInstalled)
+        return;
+    hookInstalled = true;
+    const prev = options.vnode;
+    options.vnode = (vnode) => {
+        const type = vnode.type;
+        if (typeof type === "function" && type[ISLAND]) {
+            let w = wrapped.get(type);
+            if (!w) {
+                const key = type[ISLAND];
+                const Inner = ((props) => type(props));
+                w = ((props) => h("div", {
+                    "data-island": key,
+                    "data-props": JSON.stringify(props ?? {}),
+                }, h(Inner, props)));
+                wrapped.set(type, w);
+            }
+            vnode.type = w;
+        }
+        prev?.(vnode);
+    };
+}
+/**
+ * Build the request handler: middleware chain wrapped around routing + render.
+ *
+ * Middleware runs before routing so it can answer a request no route matches.
+ */
+export function createHandler(parts) {
+    installIslandHook();
+    const routes = buildRoutes(parts.manifest);
+    const terminal = (ctx) => renderRoute(ctx, routes, parts);
+    const run = parts.app ? parts.app.compose(terminal) : composeBare(terminal);
+    return (req) => {
+        const ctx = {
+            req,
+            url: new URL(req.url),
+            params: {},
+            state: (parts.initialState?.() ?? {}),
+            head: {},
+            next: () => Promise.reject(new Error("fu: next() outside the chain")),
+        };
+        // Middleware runs outside renderRoute's try, so a throw up there would
+        // otherwise escape to the server as an unhandled 500.
+        return run(ctx).catch((err) => renderError(ctx, err, parts));
+    };
+}
+function composeBare(terminal) {
+    return (ctx) => Promise.resolve(terminal(ctx));
+}
+async function renderRoute(ctx, routes, parts) {
+    try {
+        const m = match(routes, ctx.url.pathname);
+        if (!m)
+            throw new HttpError(404);
+        ctx.params = m.params;
+        const mod = await m.route.load();
+        if (mod.handlers) {
+            const fn = mod.handlers[ctx.req.method];
+            if (!fn)
+                throw new HttpError(405);
+            const result = await fn(ctx);
+            if (result instanceof Response)
+                return result;
+            ctx.data = result;
+        }
+        const Page = mod.default;
+        if (!Page)
+            throw new HttpError(404);
+        return htmlResponse(await renderTree(ctx, h(Page, ctx), parts), ctx, parts);
+    }
+    catch (err) {
+        return renderError(ctx, err, parts);
+    }
+}
+/** Render the page, wrapped in `routes/_app.tsx` when the project has one. */
+async function renderTree(ctx, page, parts) {
+    const tree = parts.Shell
+        ? h(parts.Shell, { ctx, children: page })
+        : page;
+    return await renderToStringAsync(tree);
+}
+function htmlResponse(body, ctx, parts, status = 200) {
+    const headers = { "content-type": "text/html; charset=utf-8" };
+    // No failure may be cached: during a deploy a valid URL can 404 for a few
+    // seconds, and a shared cache would pin that.
+    if (status >= 400)
+        headers["cache-control"] = "no-store";
+    // `document` is called after rendering, so a component can still set ctx.head.
+    return new Response(document(body, ctx.head, parts.assets), { status, headers });
+}
+/**
+ * Turn a failure into a response. Rendered through `routes/_error.tsx` when the
+ * project has one, so it inherits the app's markup and styling; otherwise plain
+ * text. Either way it goes back out through the middleware chain as a normal
+ * response, so security headers and logging still apply.
+ */
+export async function renderError(ctx, err, parts) {
+    const error = toRouteError(err);
+    ctx.error = error;
+    // The underlying cause is logged, never rendered: a 500's message can carry
+    // connection strings, file paths and query text.
+    if (error.status >= 500)
+        console.error(`[fu] ${ctx.url.pathname}`, error.cause ?? err);
+    if (parts.ErrorPage) {
+        try {
+            ctx.head.title ??= `${error.status} ${statusText(error.status)}`;
+            ctx.head.robots ??= "noindex";
+            const body = await renderTree(ctx, h(parts.ErrorPage, ctx), parts);
+            return htmlResponse(body, ctx, parts, error.status);
+        }
+        catch (pageErr) {
+            // An error page that throws must not mask the original failure.
+            console.error("[fu] the error page itself threw", pageErr);
+        }
+    }
+    return new Response(`${error.status} ${error.message}`, {
+        status: error.status,
+        headers: { "content-type": "text/plain; charset=utf-8", "cache-control": "no-store" },
+    });
+}
+const escapes = {
+    "&": "&",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+};
+function esc(s) {
+    return s.replace(/[&<>"]/g, (c) => escapes[c]);
+}
+function tag(name, attrs) {
+    const a = Object.entries(attrs)
+        .map(([k, v]) => ` ${k}="${esc(v)}"`)
+        .join("");
+    return `<${name}${a}>`;
+}
+/** Assemble the HTML document from the page body, head metadata and assets. */
+export function document(body, head, assets) {
+    const parts = [
+        '<meta charset="utf-8">',
+        '<meta name="viewport" content="width=device-width,initial-scale=1">',
+    ];
+    if (head.title)
+        parts.push(`<title>${esc(head.title)}</title>`);
+    if (head.description) {
+        parts.push(tag("meta", { name: "description", content: head.description }));
+    }
+    if (head.robots)
+        parts.push(tag("meta", { name: "robots", content: head.robots }));
+    if (head.canonical)
+        parts.push(tag("link", { rel: "canonical", href: head.canonical }));
+    if (head.title)
+        parts.push(tag("meta", { property: "og:title", content: head.title }));
+    if (head.description) {
+        parts.push(tag("meta", { property: "og:description", content: head.description }));
+    }
+    if (head.image)
+        parts.push(tag("meta", { property: "og:image", content: head.image }));
+    for (const link of head.links ?? [])
+        parts.push(tag("link", link));
+    for (const a of assets.css ?? [])
+        parts.push(tag("link", { rel: "stylesheet", href: a.href }));
+    if (head.jsonLd !== undefined) {
+        // `<` escaped so a string value cannot close the script element early.
+        const json = JSON.stringify(head.jsonLd).replace(/</g, "\\u003c");
+        parts.push(`<script type="application/ld+json">${json}</script>`);
+    }
+    const js = (assets.js ?? [])
+        .map((a) => tag("script", { type: "module", src: a.href }) + "</script>")
+        .join("");
+    return `<!doctype html><html lang="${esc(head.lang ?? "en")}"><head>${parts.join("")}</head><body>${body}${js}</body></html>`;
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/router.d.ts

@@ -0,0 +1,21 @@
+import type { RouteManifest, RouteModule } from "./types.ts";
+export interface Route<S = Record<string, unknown>> {
+    /** URLPattern pathname, e.g. "/blog/:slug". */
+    pattern: string;
+    urlPattern: URLPattern;
+    load: () => Promise<RouteModule<S>>;
+    /** Lower sorts first: static beats dynamic beats wildcard. */
+    score: number;
+}
+export interface Matched<S = Record<string, unknown>> {
+    route: Route<S>;
+    params: Record<string, string>;
+}
+/**
+ * `/routes/blog/[slug].tsx` -> `/blog/:slug`
+ * `/routes/files/[...rest].tsx` -> `/files/:rest*`
+ * `/routes/index.tsx` -> `/`
+ */
+export declare function filePathToPattern(file: string): string;
+export declare function buildRoutes<S = Record<string, unknown>>(manifest: RouteManifest<S>): Route<S>[];
+export declare function match<S = Record<string, unknown>>(routes: Route<S>[], pathname: string): Matched<S> | null;

package/dist/router.js

@@ -0,0 +1,48 @@
+if (typeof globalThis.URLPattern === "undefined") {
+    await import("urlpattern-polyfill");
+}
+/**
+ * `/routes/blog/[slug].tsx` -> `/blog/:slug`
+ * `/routes/files/[...rest].tsx` -> `/files/:rest*`
+ * `/routes/index.tsx` -> `/`
+ */
+export function filePathToPattern(file) {
+    let p = file.replace(/^\/routes/, "").replace(/\.[tj]sx?$/, "");
+    if (p.endsWith("/index"))
+        p = p.slice(0, -"/index".length);
+    if (p === "/index" || p === "")
+        p = "/";
+    const out = p
+        .split("/")
+        .map((s) => s.startsWith("[...") && s.endsWith("]")
+        ? ":" + s.slice(4, -1) + "*"
+        : s.startsWith("[") && s.endsWith("]")
+            ? ":" + s.slice(1, -1)
+            : s)
+        .join("/");
+    return out || "/";
+}
+export function buildRoutes(manifest) {
+    const out = [];
+    for (const [file, load] of Object.entries(manifest)) {
+        const pattern = filePathToPattern(file);
+        const score = pattern.includes("*") ? 2 : pattern.includes(":") ? 1 : 0;
+        out.push({ pattern, urlPattern: new URLPattern({ pathname: pattern }), load, score });
+    }
+    return out.sort((a, b) => a.score - b.score || b.pattern.split("/").length - a.pattern.split("/").length);
+}
+export function match(routes, pathname) {
+    for (const route of routes) {
+        const m = route.urlPattern.exec({ pathname });
+        if (!m)
+            continue;
+        const params = {};
+        for (const [k, v] of Object.entries(m.pathname.groups)) {
+            if (v !== undefined)
+                params[k] = decodeURIComponent(v);
+        }
+        return { route, params };
+    }
+    return null;
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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