@fluixi/start 0.1.0-alpha.63 → 0.1.0-alpha.64

package/dist/generated-server-fns.js

@@ -0,0 +1,26 @@
+/**
+ * The registry of `"use server"` functions found in this app.
+ *
+ * ```ts
+ * import { isServerFnRequest, handleServerFn } from '@fluixi/start/server-fns';
+ * ```
+ *
+ * A typed stand-in: the compiler's server-function plugin intercepts this specifier and
+ * serves the generated registry. It exists as a real module so the types ship with the
+ * package instead of an ambient `declare module` written into your `src/`.
+ *
+ * `virtual:fluixi-server-fns` still resolves.
+ */
+function missingPlugin() {
+    throw new Error("[fluixi] '@fluixi/start/server-fns' was imported but the server-function plugin did not " +
+        'replace it. Build with `fluixi build`/`fluixi dev`, or add the @fluixi/start plugins to ' +
+        'your Vite config.');
+}
+/** Whether this request is an RPC call to a `"use server"` function. */
+export function isServerFnRequest(_request) {
+    missingPlugin();
+}
+/** Run the addressed server function and return its response. */
+export function handleServerFn(_request) {
+    missingPlugin();
+}

package/dist/handler-core.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The request handler, assembled from things already in memory.
+ *
+ * `createProdHandler` reads the template off disk and imports the server entry by
+ * path — fine on Node, impossible in a worker, where there is no filesystem and
+ * every module has to be part of the bundle. So the assembly lives here and takes
+ * the template and the module as arguments; the platform entry a deploy adapter
+ * generates imports both statically and calls this.
+ *
+ * One assembly, so an edge deploy cannot quietly behave differently from `fluixi
+ * start` — the dispatch order (server functions, then API routes, then render,
+ * all under middleware) is a property of the framework, not of the host.
+ */
+import type { ResolvedConfig } from './config.js';
+import { type FetchHandler } from './handler.js';
+/** The shape a built `entry-server.js` exposes. Every field is optional. */
+export interface ServerModule {
+    render?: (url: string, request: Request) => string | Promise<string>;
+    default?: (url: string, request: Request) => string | Promise<string>;
+    renderStream?: (url: string, request: Request) => unknown;
+    isServerFnRequest?: (request: Request) => boolean;
+    handleServerFn?: (request: Request) => Response | Promise<Response>;
+    isApiRequest?: (request: Request) => boolean;
+    handleApiRequest?: (request: Request) => Response | Promise<Response>;
+}
+export interface HandlerParts {
+    /** `dist/client/index.html`, as a string. */
+    template: string;
+    /** The imported server entry. `{}` for an SPA that ships none. */
+    mod: ServerModule;
+    cfg: Pick<ResolvedConfig, 'ssr' | 'mountId'>;
+    /** The imported `middleware.js`, if the app has one. */
+    middleware?: unknown;
+}
+export declare function createHandlerFrom({ template, mod, cfg, middleware }: HandlerParts): FetchHandler;
+//# sourceMappingURL=handler-core.d.ts.map

package/dist/handler-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-core.d.ts","sourceRoot":"","sources":["../src/handler-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAGvF,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IAC1D,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IAClD,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpE,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IAC7C,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,GAAG,EAAE,YAAY,CAAC;IAClB,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC;IAC7C,wDAAwD;IACxD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,YAAY,GAAG,YAAY,CAwChG"}

package/dist/handler-core.js

@@ -0,0 +1,40 @@
+import { injectAppAndHead, splitTemplate, guardHandler } from './document.js';
+import { createRequestHandler, streamDocument } from './handler.js';
+import { composeMiddleware, normalizeMiddleware } from './middleware.js';
+export function createHandlerFrom({ template, mod, cfg, middleware }) {
+    // Streaming when the entry exports `renderStream` (a body stream): flush the split
+    // template head first, pipe the body, then the tail. Else inject the string render.
+    let core;
+    if (!cfg.ssr) {
+        // SPA: the page is the static shell; the client entry renders it. Server functions +
+        // middleware still run through this handler — there's just no SSR render pass.
+        core = createRequestHandler(async () => template);
+    }
+    else if (typeof mod.renderStream === 'function') {
+        const { head, tail } = splitTemplate(template, cfg.mountId);
+        core = async (request) => {
+            const url = new URL(request.url);
+            const body = await mod.renderStream(url.pathname + url.search, request);
+            return streamDocument(head, body, tail);
+        };
+    }
+    else {
+        const render = mod.render ?? mod.default;
+        core = createRequestHandler(async (url, request) => injectAppAndHead(template, await render(url, request), cfg.mountId));
+    }
+    // Server-function RPC dispatch. The entry-server module re-exports the dispatcher, so
+    // it shares the registry that the app's "use server" modules populated (a separate
+    // import would have an empty registry).
+    if (typeof mod.handleServerFn === 'function' && typeof mod.isServerFnRequest === 'function') {
+        const render = core;
+        core = async (request) => mod.isServerFnRequest(request) ? mod.handleServerFn(request) : render(request);
+    }
+    // File-based API routes, re-exported by the entry from `@fluixi/start/api-routes`.
+    if (typeof mod.handleApiRequest === 'function' && typeof mod.isApiRequest === 'function') {
+        const next = core;
+        core = async (request) => mod.isApiRequest(request) ? mod.handleApiRequest(request) : next(request);
+    }
+    if (!middleware)
+        return guardHandler(core);
+    return guardHandler(composeMiddleware(normalizeMiddleware(middleware), core));
+}

package/dist/index.d.ts

@@ -8,15 +8,13 @@
 export { defineConfig, resolveConfig, loadConfig } from './config.js';
 export type { FluixiConfig, ResolvedConfig } from './config.js';
 export { html, svg } from '@fluixi/core';
-export { dev } from './commands/dev.js';
-export { build } from './commands/build.js';
-export { start } from './commands/start.js';
-export { prerender } from './commands/prerender.js';
-export { injectApp, injectAppAndHead, splitTemplate } from './internal.js';
+export { injectApp, injectAppAndHead, splitTemplate } from './document.js';
 export { createRequestHandler, toNodeHandler, nodeToRequest, sendResponse, serveNode, streamDocument, withStaticFiles, } from './handler.js';
 export type { FetchHandler, RenderFn, StreamRenderFn, ServeNodeOptions } from './handler.js';
-export { createProdHandler, nodeAdapter, webAdapter } from './adapter.js';
-export type { Adapter, AdapterContext } from './adapter.js';
+export { createProdHandler, nodeAdapter, webAdapter, cloudflareAdapter, netlifyAdapter, vercelAdapter, ssrBuildOptions, } from './adapter.js';
+export type { Adapter, AdapterContext, AdapterBuildContext } from './adapter.js';
+export { createHandlerFrom } from './handler-core.js';
+export type { HandlerParts, ServerModule } from './handler-core.js';
 export { defineMiddleware, composeMiddleware, normalizeMiddleware } from './middleware.js';
 export type { Middleware, MiddlewareNext } from './middleware.js';
 export { addInterceptor, clearInterceptors, fetchWithInterceptors } from './interceptors.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,SAAS,EACT,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE7F,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1E,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC7F,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAI9G,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAOzC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,SAAS,EACT,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE7F,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC7F,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAI9G,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -9,15 +9,18 @@ export { defineConfig, resolveConfig, loadConfig } from './config.js';
 // The html``/svg`` template tags — so a meta-framework app can author without JSX:
 // `import { html } from '@fluixi/start'`. Inert markers; the compiler lowers them.
 export { html, svg } from '@fluixi/core';
-export { dev } from './commands/dev.js';
-export { build } from './commands/build.js';
-export { start } from './commands/start.js';
-export { prerender } from './commands/prerender.js';
-export { injectApp, injectAppAndHead, splitTemplate } from './internal.js';
+// The commands live at `@fluixi/start/commands`. Re-exporting them here would put
+// the dev server and the bundler behind every runtime import of this package —
+// and a deploy adapter, which inlines everything its entry can reach, would carry
+// vite into a worker.
+// From the leaf, not internal.js: that one reaches the dev server's env loader,
+// and with it vite, which has no business in a runtime import of this package.
+export { injectApp, injectAppAndHead, splitTemplate } from './document.js';
 // The runtime-neutral request layer — the seam adapters (edge/worker/Bun/Deno) build on.
 export { createRequestHandler, toNodeHandler, nodeToRequest, sendResponse, serveNode, streamDocument, withStaticFiles, } from './handler.js';
 // Deploy adapters: the portable prod handler + the node/web reference adapters.
-export { createProdHandler, nodeAdapter, webAdapter } from './adapter.js';
+export { createProdHandler, nodeAdapter, webAdapter, cloudflareAdapter, netlifyAdapter, vercelAdapter, ssrBuildOptions, } from './adapter.js';
+export { createHandlerFrom } from './handler-core.js';
 // Request middleware — a `(request, next) => Response` chain run before render.
 export { defineMiddleware, composeMiddleware, normalizeMiddleware } from './middleware.js';
 // HTTP interceptors — request/response/error pipeline around fetch (server-fn RPC + app fetch).

package/dist/internal.d.ts

@@ -1,5 +1,4 @@
 import type { ResolvedConfig } from './config.js';
-import type { FetchHandler } from './handler.js';
 /** The virtual module that registers every `"use server"` fn + re-exports the dispatcher. */
 export declare const SERVER_FNS_VMOD = "virtual:fluixi-server-fns";
 /** The virtual module exposing auto-discovered translations: `{ messages, locales, defaultLocale }`. */
@@ -50,34 +49,7 @@ export declare function startTypesPlugin(cfg: ResolvedConfig): any;
  * bits only (optimizeDeps, ssr.noExternal via config, etc.).
  */
 export declare function fluixiPlugins(cfg: ResolvedConfig): Promise<any[]>;
-/**
- * Inject server-rendered app HTML into the template's mount element
- * (`<div id="root"></div>`). Falls back to a `<!--ssr-outlet-->` marker, then to
- * just before `</body>`.
- */
-export declare function injectApp(template: string, appHtml: string, mountId?: string): string;
-/**
- * Split the template at the mount point for streaming: `head` is everything up to and
- * including the open mount tag (flushed first so the browser fetches assets while the
- * server awaits data); `tail` is the close tag onward (client script + `</body>`).
- * Mirrors injectApp's three cases (mount div, `<!--ssr-outlet-->`, before `</body>`).
- */
-export declare function splitTemplate(template: string, mountId?: string): {
-    head: string;
-    tail: string;
-};
-/**
- * Inject the rendered app into the mount point AND lift any @fluixi/head metadata (carried back as
- * a marker by renderRequestAsync) into <head> + <html>. If the page set a title, the template's own
- * <title> is dropped so there's only one. No marker → identical to injectApp.
- */
-export declare function injectAppAndHead(template: string, rendered: string, mountId?: string): string;
-/**
- * Wrap a fetch handler so a thrown/rejected error becomes a 500 instead of an
- * unhandled rejection. `createRequestHandler` already guards the renderer; this
- * covers the middleware chain that wraps it. `onError` lets dev map the stack first.
- */
-export declare function guardHandler(handler: FetchHandler, onError?: (e: unknown) => void): FetchHandler;
+export { injectApp, splitTemplate, injectAppAndHead, guardHandler, } from './document.js';
 /**
  * A render fires the route's data fetches eagerly; if the backend is down those
  * promises can reject AFTER we've already responded, with nothing awaiting them —

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,6FAA6F;AAC7F,eAAO,MAAM,eAAe,8BAA8B,CAAC;AAE3D,wGAAwG;AACxG,eAAO,MAAM,SAAS,wBAAwB,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,GAAG,CAoCrG;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7E;AA6DD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,GAAG,CA4BzD;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAoBvE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,SAAS,GAAG,MAAM,CASrF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAwBhG;AASD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAS,GAAG,MAAM,CAW7F;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,GAC7B,YAAY,CAYd;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CASzC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,6FAA6F;AAC7F,eAAO,MAAM,eAAe,8BAA8B,CAAC;AAE3D,wGAAwG;AACxG,eAAO,MAAM,SAAS,wBAAwB,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,GAAG,CAoCrG;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7E;AA6DD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,GAAG,CA0BzD;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAoBvE;AAED,OAAO,EACL,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,YAAY,GACb,MAAM,eAAe,CAAC;AAIvB;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CASzC"}

package/dist/internal.js

@@ -1,6 +1,5 @@
 import { readdirSync, readFileSync, writeFileSync, existsSync } from 'node:fs';
 import { resolve as resolvePath, relative as relativePath } from 'node:path';
-import { extractHeadMarker } from '@fluixi/head';
 /** The virtual module that registers every `"use server"` fn + re-exports the dispatcher. */
 export const SERVER_FNS_VMOD = 'virtual:fluixi-server-fns';
 /** The virtual module exposing auto-discovered translations: `{ messages, locales, defaultLocale }`. */
@@ -142,18 +141,17 @@ export function startTypesPlugin(cfg) {
             root = config.root || root;
         },
         buildStart() {
-            const blocks = [
-                `declare module 'virtual:fluixi-server-fns' {`,
-                `  export function isServerFnRequest(request: Request): boolean;`,
-                `  export function handleServerFn(request: Request): Promise<Response>;`,
-                `}`,
-                `declare module 'virtual:fluixi-api' {`,
-                `  export function isApiRequest(request: Request): boolean;`,
-                `  export function handleApiRequest(request: Request): Promise<Response>;`,
-                `}`,
-            ];
+            // Only i18n is generated now. `virtual:fluixi-server-fns` and `virtual:fluixi-api`
+            // have fixed signatures, so they moved to real package entries
+            // (`@fluixi/start/server-fns`, `@fluixi/start/api-routes`) whose types ship with the
+            // package. i18n cannot follow: its `messages` type is derived from the app's own JSON
+            // (`typeof import('./i18n/en.json')`) and its `locales` is a literal tuple — that is
+            // what makes keys autocomplete, and no static entry can express it.
+            const blocks = [];
             if (cfg.i18n)
                 blocks.push(...i18nTypeBlock(root, cfg.i18n));
+            if (blocks.length === 0)
+                return; // no i18n configured — nothing left to declare
             const content = `// Auto-generated by @fluixi/start — do not edit.\n${blocks.join('\n')}\n`;
             const file = resolvePath(root, 'src/fluixi-start-env.d.ts');
             try {
@@ -196,97 +194,7 @@ export async function fluixiPlugins(cfg) {
     plugins.push(startTypesPlugin(cfg));
     return plugins;
 }
-/**
- * Inject server-rendered app HTML into the template's mount element
- * (`<div id="root"></div>`). Falls back to a `<!--ssr-outlet-->` marker, then to
- * just before `</body>`.
- */
-export function injectApp(template, appHtml, mountId = 'root') {
-    const mount = new RegExp(`<div id=["']${mountId}["']\\s*>\\s*</div>`);
-    if (mount.test(template)) {
-        return template.replace(mount, `<div id="${mountId}">${appHtml}</div>`);
-    }
-    if (template.includes('<!--ssr-outlet-->')) {
-        return template.replace('<!--ssr-outlet-->', appHtml);
-    }
-    return template.replace('</body>', `<div id="${mountId}">${appHtml}</div></body>`);
-}
-/**
- * Split the template at the mount point for streaming: `head` is everything up to and
- * including the open mount tag (flushed first so the browser fetches assets while the
- * server awaits data); `tail` is the close tag onward (client script + `</body>`).
- * Mirrors injectApp's three cases (mount div, `<!--ssr-outlet-->`, before `</body>`).
- */
-export function splitTemplate(template, mountId = 'root') {
-    const mount = new RegExp(`<div id=["']${mountId}["']\\s*>\\s*</div>`);
-    const m = template.match(mount);
-    if (m && m.index !== undefined) {
-        return {
-            head: template.slice(0, m.index) + `<div id="${mountId}">`,
-            tail: `</div>` + template.slice(m.index + m[0].length),
-        };
-    }
-    const outlet = template.indexOf('<!--ssr-outlet-->');
-    if (outlet !== -1) {
-        return {
-            head: template.slice(0, outlet),
-            tail: template.slice(outlet + '<!--ssr-outlet-->'.length),
-        };
-    }
-    const body = template.indexOf('</body>');
-    if (body !== -1) {
-        return {
-            head: template.slice(0, body) + `<div id="${mountId}">`,
-            tail: `</div>` + template.slice(body),
-        };
-    }
-    return { head: template, tail: '' };
-}
-/** Set/replace an attribute on the template's <html> tag (e.g. lang). */
-function setHtmlAttr(html, name, value) {
-    const existing = new RegExp(`(<html\\b[^>]*?)\\s${name}="[^"]*"`, 'i');
-    if (existing.test(html))
-        return html.replace(existing, `$1 ${name}="${value}"`);
-    return html.replace(/<html\b/i, `<html ${name}="${value}"`);
-}
-/**
- * Inject the rendered app into the mount point AND lift any @fluixi/head metadata (carried back as
- * a marker by renderRequestAsync) into <head> + <html>. If the page set a title, the template's own
- * <title> is dropped so there's only one. No marker → identical to injectApp.
- */
-export function injectAppAndHead(template, rendered, mountId = 'root') {
-    const { head, body } = extractHeadMarker(rendered);
-    let html = injectApp(template, body, mountId);
-    if (head) {
-        if (head.headHtml) {
-            if (/<title[\s>]/i.test(head.headHtml))
-                html = html.replace(/<title>[\s\S]*?<\/title>/i, '');
-            html = html.replace('</head>', `${head.headHtml}</head>`);
-        }
-        for (const [k, v] of Object.entries(head.htmlAttrs))
-            html = setHtmlAttr(html, k, v);
-    }
-    return html;
-}
-/**
- * Wrap a fetch handler so a thrown/rejected error becomes a 500 instead of an
- * unhandled rejection. `createRequestHandler` already guards the renderer; this
- * covers the middleware chain that wraps it. `onError` lets dev map the stack first.
- */
-export function guardHandler(handler, onError) {
-    return async (request) => {
-        try {
-            return await handler(request);
-        }
-        catch (e) {
-            onError?.(e);
-            return new Response(String(e?.stack || e), {
-                status: 500,
-                headers: { 'content-type': 'text/plain; charset=utf-8' },
-            });
-        }
-    };
-}
+export { injectApp, splitTemplate, injectAppAndHead, guardHandler, } from './document.js';
 let _guardsInstalled = false;
 /**
  * A render fires the route's data fetches eagerly; if the backend is down those