@fluixi/start 0.1.0-alpha.74 → 0.1.0-alpha.75

package/dist/define-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.d.ts","sourceRoot":"","sources":["../src/define-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAE/D"}

package/dist/define-config.js

@@ -0,0 +1,3 @@
+export function defineConfig(config) {
+    return config;
+}

package/dist/define-config.mjs

@@ -0,0 +1,7 @@
+// src/define-config.ts
+function defineConfig(config) {
+  return config;
+}
+export {
+  defineConfig
+};

package/dist/di.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/di.d.ts

@@ -44,20 +44,20 @@ export declare class Injector {
 export declare function inject<T>(token: Token<T>): T;
 /**
  * Provide services for the CURRENT component/route and its descendants (owner-scoped). The
- * injector is disposed — running each service's `onDestroy()` — when the component unmounts.
+ * injector is disposed: running each service's `onDestroy()`, when the component unmounts.
  */
 export declare function provide(providers: ReadonlyArray<Provider>): Injector;
 /**
  * Provide app-wide services. On the client these are singletons; during SSR each request gets
- * its OWN instances (the root injector is per-request) — so a stateful root service can never
+ * its OWN instances (the root injector is per-request), so a stateful root service can never
  * leak between concurrent requests. Call at module load (e.g. in entry-client / entry-server).
  */
 export declare function provideRoot(providers: ReadonlyArray<Provider>): void;
 /** Run `fn` with an explicit injector as the injection context (e.g. inside a server function). */
 export declare function runInInjectionContext<R>(injector: Injector, fn: () => R): R;
-/** The injector for the current scope (advanced — for passing to runInInjectionContext later). */
+/** The injector for the current scope (advanced: for passing to runInInjectionContext later). */
 export declare function getInjector(): Injector;
-/** A standalone injector (parent defaults to the root) — for tests / manual hierarchies. */
+/** A standalone injector (parent defaults to the root), for tests / manual hierarchies. */
 export declare function createInjector(providers: ReadonlyArray<Provider>, parent?: Injector | null): Injector;
 export {};
 //# sourceMappingURL=di.d.ts.map

package/dist/di.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"di.d.ts","sourceRoot":"","sources":["../src/di.ts"],"names":[],"mappings":"AAiCA,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mGAAmG;IACnG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;CAC5B;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAEzF;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,GAAG,IACxB;IAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,EAAE,CAAC,CAAA;CAAE,GAClC;IAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;CAAE,GAC5F;IAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAAC,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;CAAE,GAC1F;IAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC;AAIjD,UAAU,GAAG;IACX,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,QAAQ;;IAEP,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAD5C,QAAQ,CAAC,OAAO,mBAA0B;gBACrB,MAAM,GAAE,QAAQ,GAAG,IAAW;IAEnD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,IAAI;IAOlD,iGAAiG;IACjG,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IA4C1B,4FAA4F;IAC5F,OAAO,IAAI,IAAI;CAahB;AAoDD,+DAA+D;AAC/D,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAE5C;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAapE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,IAAI,CAKpE;AAED,mGAAmG;AACnG,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQ3E;AAED,kGAAkG;AAClG,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,CAErG"}
+{"version":3,"file":"di.d.ts","sourceRoot":"","sources":["../src/di.ts"],"names":[],"mappings":"AAiCA,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mGAAmG;IACnG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;CAC5B;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAEzF;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,GAAG,IACxB;IAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,EAAE,CAAC,CAAA;CAAE,GAClC;IAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;CAAE,GAC5F;IAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAAC,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;CAAE,GAC1F;IAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC;AAIjD,UAAU,GAAG;IACX,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,QAAQ;;IAEP,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAD5C,QAAQ,CAAC,OAAO,mBAA0B;gBACrB,MAAM,GAAE,QAAQ,GAAG,IAAW;IAEnD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,IAAI;IAOlD,iGAAiG;IACjG,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IA4C1B,4FAA4F;IAC5F,OAAO,IAAI,IAAI;CAahB;AAoDD,+DAA+D;AAC/D,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAE5C;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAapE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,IAAI,CAKpE;AAED,mGAAmG;AACnG,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQ3E;AAED,iGAAiG;AACjG,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,CAErG"}

package/dist/di.js

@@ -1,17 +1,17 @@
 /**
- * @fluixi/start/di — dependency injection, the Angular way, but SSR-correct and reactive.
+ * @fluixi/start/di: dependency injection, the Angular way, but SSR-correct and reactive.
  *
  * Three things make this distinct from Angular's DI:
  *
  *  1. **SSR request isolation, for free.** A "root" provider is a singleton on the CLIENT but
- *     a fresh instance PER REQUEST on the server — because the root injector lives in the
+ *     a fresh instance PER REQUEST on the server, because the root injector lives in the
  *     per-request `RequestContext` (the same machinery that isolates resources/markers). So
  *     a stateful root service (a per-user cache, a DB unit-of-work) never leaks across two
  *     concurrent SSR requests. No zone, no `providedIn` ceremony, no manual request injectors.
  *
  *  2. **The reactive owner tree IS the injector hierarchy.** `provide()` in a component
  *     attaches a child injector to that component's reactive owner; descendants `inject()`
- *     by walking the owner chain — exactly how context resolves. Component-scoped services
+ *     by walking the owner chain: exactly how context resolves. Component-scoped services
  *     are disposed with the component (their `onDestroy()` runs on owner cleanup).
  *
  *  3. **Function injection, tree-shakable tokens.** No decorators/reflect-metadata. A token
@@ -119,7 +119,7 @@ const _reqInjectors = new WeakMap(); // per-request root (server)
 const _ownerInjectors = new WeakMap(); // per reactive owner (component scope)
 let _clientRoot = null;
 let _explicit = null;
-/** The root injector — per-request during SSR (isolated), a module singleton on the client. */
+/** The root injector: per-request during SSR (isolated), a module singleton on the client. */
 function rootInjector() {
     const ctx = getRequestContext();
     if (ctx) {
@@ -130,7 +130,7 @@ function rootInjector() {
     }
     return (_clientRoot ??= new Injector(null).register(_rootProviders));
 }
-/** Nearest ancestor owner injector, else the root — the parent of a new component injector. */
+/** Nearest ancestor owner injector, else the root, the parent of a new component injector. */
 function parentInjectorOf(owner) {
     let o = owner?.parent;
     while (o) {
@@ -161,7 +161,7 @@ export function inject(token) {
 }
 /**
  * Provide services for the CURRENT component/route and its descendants (owner-scoped). The
- * injector is disposed — running each service's `onDestroy()` — when the component unmounts.
+ * injector is disposed: running each service's `onDestroy()`, when the component unmounts.
  */
 export function provide(providers) {
     const owner = getOwner();
@@ -179,7 +179,7 @@ export function provide(providers) {
 }
 /**
  * Provide app-wide services. On the client these are singletons; during SSR each request gets
- * its OWN instances (the root injector is per-request) — so a stateful root service can never
+ * its OWN instances (the root injector is per-request), so a stateful root service can never
  * leak between concurrent requests. Call at module load (e.g. in entry-client / entry-server).
  */
 export function provideRoot(providers) {
@@ -200,11 +200,11 @@ export function runInInjectionContext(injector, fn) {
         _explicit = prev;
     }
 }
-/** The injector for the current scope (advanced — for passing to runInInjectionContext later). */
+/** The injector for the current scope (advanced: for passing to runInInjectionContext later). */
 export function getInjector() {
     return currentInjector();
 }
-/** A standalone injector (parent defaults to the root) — for tests / manual hierarchies. */
+/** A standalone injector (parent defaults to the root), for tests / manual hierarchies. */
 export function createInjector(providers, parent) {
     return new Injector(parent === undefined ? rootInjector() : parent).register(providers);
 }

package/dist/di.mjs

@@ -1,4 +1,4 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 var __typeError = (msg) => {
   throw TypeError(msg);
 };

package/dist/document.d.ts

@@ -19,7 +19,7 @@ export declare function splitTemplate(template: string, mountId?: string): {
  * Reference the files this route needs in the document that renders it.
  *
  * A lazily-imported route is its own chunk with its own stylesheet, mentioned nowhere
- * in the shell — without these the browser discovers them when hydration runs the
+ * in the shell: without these the browser discovers them when hydration runs the
  * dynamic import, so the markup paints before the CSS arrives.
  *
  * Files already named in the template are skipped: the entry chunk is in there from

package/dist/document.js

@@ -57,7 +57,7 @@ export function splitTemplate(template, mountId = 'root') {
  * Reference the files this route needs in the document that renders it.
  *
  * A lazily-imported route is its own chunk with its own stylesheet, mentioned nowhere
- * in the shell — without these the browser discovers them when hydration runs the
+ * in the shell: without these the browser discovers them when hydration runs the
  * dynamic import, so the markup paints before the CSS arrives.
  *
  * Files already named in the template are skipped: the entry chunk is in there from

package/dist/generated-api.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/generated-api.js

@@ -8,7 +8,7 @@
  * Named `api-routes` because `@fluixi/start/api` is already the API plumbing you call
  * directly (`createApiHandler`, `imageLoader`, …); this is the generated route table.
  *
- * A typed stand-in — the scan plugin serves the real one. `virtual:fluixi-api` still
+ * A typed stand-in: the scan plugin serves the real one. `virtual:fluixi-api` still
  * resolves.
  */
 function missingPlugin() {

package/dist/generated-api.mjs

@@ -1,4 +1,4 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/generated-api.ts
 function missingPlugin() {

package/dist/generated-server-fns.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/generated-server-fns.mjs

@@ -1,4 +1,4 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/generated-server-fns.ts
 function missingPlugin() {

package/dist/handler-core.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/handler-core.d.ts

@@ -2,13 +2,13 @@
  * 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
+ * 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,
+ * 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';

package/dist/handler-core.js

@@ -8,7 +8,7 @@ export function createHandlerFrom({ template, mod, cfg, middleware, preload }) {
     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. The
+        // middleware still run through this handler: there's just no SSR render pass. The
         // path is still known, though, and the route it names still loads its own chunk, so
         // the shell can say so and save the client a round trip it would otherwise start
         // only after the router had booted.
@@ -18,7 +18,7 @@ export function createHandlerFrom({ template, mod, cfg, middleware, preload }) {
         core = async (request) => {
             const url = new URL(request.url);
             // Split per request rather than once: the preload links belong in the head, and
-            // the head is the part that flushes before the body is known — which is the whole
+            // the head is the part that flushes before the body is known, which is the whole
             // reason streaming wants them, since the browser can start fetching the route's
             // chunk while the server is still awaiting data for it.
             const { head, tail } = splitTemplate(withPreload(template, url.pathname), cfg.mountId);

package/dist/handler-core.mjs

@@ -1,4 +1,4 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/document.ts
 import { extractHeadMarker } from "@fluixi/head";

package/dist/handler.cjs

@@ -1,3 +1,4 @@
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/handler.d.ts

@@ -2,7 +2,7 @@ import { type IncomingMessage, type ServerResponse, type Server } from 'node:htt
 /**
  * The runtime-neutral request layer. Everything renders through a Web
  * `Request → Response` handler, so the same core works in Node, Bun, Deno, and
- * edge/worker runtimes — only the *bridge* (Node http here) is platform-specific.
+ * edge/worker runtimes: only the *bridge* (Node http here) is platform-specific.
  * This is the seam deploy adapters plug into.
  */
 /** Produce page HTML for a request URL (pathname + search). */
@@ -15,7 +15,7 @@ export type StreamRenderFn = (url: string, request: Request) => ReadableStream<U
  * Compose a streamed HTML Response: flush `head` immediately (browser starts fetching
  * assets while the server awaits data), then pipe the app `body` stream into the mount
  * point, then `tail` (client script + closing tags). A render error after the head is
- * flushed can only error the stream (status is already 200) — truncated HTML; callers
+ * flushed can only error the stream (status is already 200), truncated HTML; callers
  * should guard the pre-flush path for a real 500.
  */
 export declare function streamDocument(head: string, body: ReadableStream<Uint8Array>, tail: string): Response;
@@ -34,7 +34,7 @@ export interface ServeNodeOptions {
 /** The reference **Node adapter**: serve a `FetchHandler` over `node:http`. */
 export declare function serveNode(handler: FetchHandler, opts?: ServeNodeOptions): Server;
 /**
- * Wrap a handler to serve static files from `dir` first (for filesystem runtimes —
+ * Wrap a handler to serve static files from `dir` first (for filesystem runtimes ,
  * Node/Bun/Deno). Edge runtimes serve assets via the platform, so they use the bare
  * handler instead.
  */

package/dist/handler.js

@@ -7,7 +7,7 @@ import { join, extname } from 'node:path';
  * Compose a streamed HTML Response: flush `head` immediately (browser starts fetching
  * assets while the server awaits data), then pipe the app `body` stream into the mount
  * point, then `tail` (client script + closing tags). A render error after the head is
- * flushed can only error the stream (status is already 200) — truncated HTML; callers
+ * flushed can only error the stream (status is already 200), truncated HTML; callers
  * should guard the pre-flush path for a real 500.
  */
 export function streamDocument(head, body, tail) {
@@ -70,7 +70,7 @@ export function nodeToRequest(req) {
     const method = req.method ?? 'GET';
     const init = { method, headers };
     if (method !== 'GET' && method !== 'HEAD') {
-        init.body = req; // Node readable — fine for undici/Node fetch
+        init.body = req; // Node readable: fine for undici/Node fetch
         init.duplex = 'half';
     }
     return new Request(url, init);
@@ -124,7 +124,7 @@ const MIME = {
     '.ico': 'image/x-icon', '.woff': 'font/woff', '.woff2': 'font/woff2', '.map': 'application/json',
 };
 /**
- * Wrap a handler to serve static files from `dir` first (for filesystem runtimes —
+ * Wrap a handler to serve static files from `dir` first (for filesystem runtimes ,
  * Node/Bun/Deno). Edge runtimes serve assets via the platform, so they use the bare
  * handler instead.
  */

package/dist/handler.mjs

@@ -1,3 +1,5 @@
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+
 // src/handler.ts
 import { createServer as createHttpServer } from "node:http";
 import { stat } from "node:fs/promises";

package/dist/head.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/head.d.ts

@@ -1,5 +1,5 @@
 /**
- * `@fluixi/start/head` — the app-facing SEO & document-head surface, re-exported from the
+ * `@fluixi/start/head`: the app-facing SEO & document-head surface, re-exported from the
  * framework-agnostic `@fluixi/head` engine. Importing from the meta-framework gives apps a single,
  * stable dependency (like `@fluixi/start/router`) instead of reaching into the engine directly:
  *

package/dist/head.js

@@ -1,5 +1,5 @@
 /**
- * `@fluixi/start/head` — the app-facing SEO & document-head surface, re-exported from the
+ * `@fluixi/start/head`: the app-facing SEO & document-head surface, re-exported from the
  * framework-agnostic `@fluixi/head` engine. Importing from the meta-framework gives apps a single,
  * stable dependency (like `@fluixi/start/router`) instead of reaching into the engine directly:
  *

package/dist/head.mjs

@@ -1,4 +1,4 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/head.ts
 export * from "@fluixi/head";

package/dist/image-loader.cjs

@@ -0,0 +1,37 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/image-loader.ts
+var image_loader_exports = {};
+__export(image_loader_exports, {
+  imageLoader: () => imageLoader
+});
+module.exports = __toCommonJS(image_loader_exports);
+function imageLoader(options = {}) {
+  const path = options.path ?? "/api/image";
+  return ({ src, width, quality }) => {
+    const params = new URLSearchParams({ url: src, w: String(width) });
+    if (quality != null) params.set("q", String(quality));
+    return `${path}?${params.toString()}`;
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  imageLoader
+});

package/dist/image-loader.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The client half of the image support.
+ *
+ * `imageLoader` builds a URL; `createImageHandler` reads files and transforms them. Only
+ * the first belongs in a page, so it lives apart from the half that imports `node:fs`.
+ */
+export interface ImageLoaderOptions {
+    /** Path the image handler route is mounted at. Default `/api/image`. */
+    path?: string;
+}
+/**
+ * A loader for `@fluixi-ui/image` that targets a `createImageHandler` route.
+ *
+ * ```tsx
+ * import { imageLoader } from '@fluixi/start';
+ * const loader = imageLoader({ path: '/api/image' });
+ * <Image src="/mug.jpg" loader={loader} widths={[120, 240, 480]} />
+ * ```
+ */
+export declare function imageLoader(options?: ImageLoaderOptions): (args: {
+    src: string;
+    width: number;
+    quality?: number;
+}) => string;
+//# sourceMappingURL=image-loader.d.ts.map

package/dist/image-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-loader.d.ts","sourceRoot":"","sources":["../src/image-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,OAAO,GAAE,kBAAuB,GAC/B,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,MAAM,CAOpE"}

package/dist/image-loader.js

@@ -0,0 +1,18 @@
+/**
+ * A loader for `@fluixi-ui/image` that targets a `createImageHandler` route.
+ *
+ * ```tsx
+ * import { imageLoader } from '@fluixi/start';
+ * const loader = imageLoader({ path: '/api/image' });
+ * <Image src="/mug.jpg" loader={loader} widths={[120, 240, 480]} />
+ * ```
+ */
+export function imageLoader(options = {}) {
+    const path = options.path ?? '/api/image';
+    return ({ src, width, quality }) => {
+        const params = new URLSearchParams({ url: src, w: String(width) });
+        if (quality != null)
+            params.set('q', String(quality));
+        return `${path}?${params.toString()}`;
+    };
+}

package/dist/image-loader.mjs

@@ -0,0 +1,12 @@
+// src/image-loader.ts
+function imageLoader(options = {}) {
+  const path = options.path ?? "/api/image";
+  return ({ src, width, quality }) => {
+    const params = new URLSearchParams({ url: src, w: String(width) });
+    if (quality != null) params.set("q", String(quality));
+    return `${path}?${params.toString()}`;
+  };
+}
+export {
+  imageLoader
+};

package/dist/image.cjs

@@ -1,3 +1,4 @@
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -26,6 +27,18 @@ __export(image_exports, {
 module.exports = __toCommonJS(image_exports);
 var import_promises = require("node:fs/promises");
 var import_node_path = require("node:path");
+
+// src/image-loader.ts
+function imageLoader(options = {}) {
+  const path = options.path ?? "/api/image";
+  return ({ src, width, quality }) => {
+    const params = new URLSearchParams({ url: src, w: String(width) });
+    if (quality != null) params.set("q", String(quality));
+    return `${path}?${params.toString()}`;
+  };
+}
+
+// src/image.ts
 var DEFAULT_SIZES = [16, 32, 48, 64, 96, 128, 256, 384, 640, 750, 828, 1080, 1200, 1920, 2048, 3840];
 var MIME = {
   ".jpg": "image/jpeg",
@@ -131,14 +144,6 @@ function createImageHandler(options = {}) {
     return imageResponse(body, contentType, maxAge);
   };
 }
-function imageLoader(options = {}) {
-  const path = options.path ?? "/api/image";
-  return ({ src, width, quality }) => {
-    const params = new URLSearchParams({ url: src, w: String(width) });
-    if (quality != null) params.set("q", String(quality));
-    return `${path}?${params.toString()}`;
-  };
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createImageHandler,

package/dist/image.d.ts

@@ -35,7 +35,7 @@ export interface ImageHandlerOptions {
  *
  * ```ts
  * // src/api/image.ts
- * import { createImageHandler } from '@fluixi/start';
+ * import { createImageHandler } from '@fluixi/start/image';
  * export const GET = createImageHandler({ root: 'public', domains: ['cdn.example.com'] });
  * ```
  *
@@ -43,22 +43,5 @@ export interface ImageHandlerOptions {
  * through unchanged (so it's safe to ship either way).
  */
 export declare function createImageHandler(options?: ImageHandlerOptions): (request: Request) => Promise<Response>;
-export interface ImageLoaderOptions {
-    /** Path the {@link createImageHandler} route is mounted at. Default `/api/image`. */
-    path?: string;
-}
-/**
- * A loader for `@fluixi-ui/image` that targets a {@link createImageHandler} route.
- *
- * ```tsx
- * import { imageLoader } from '@fluixi/start';
- * const loader = imageLoader({ path: '/api/image' });
- * <Image src="/mug.jpg" loader={loader} widths={[120, 240, 480]} />
- * ```
- */
-export declare function imageLoader(options?: ImageLoaderOptions): (args: {
-    src: string;
-    width: number;
-    quality?: number;
-}) => string;
+export { imageLoader, type ImageLoaderOptions } from './image-loader.js';
 //# sourceMappingURL=image.d.ts.map

package/dist/image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;IACtD,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,sFAAsF;AACtF,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,kBAAkB,KACrB,OAAO,CAAC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,2FAA2F;IAC3F,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B;AAyCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAoE7G;AAED,MAAM,WAAW,kBAAkB;IACjC,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,MAAM,CAOhI"}
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../src/image.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;IACtD,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,sFAAsF;AACtF,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,kBAAkB,KACrB,OAAO,CAAC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,2FAA2F;IAC3F,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B;AAyCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAoE7G;AAGD,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/image.js

@@ -1,6 +1,6 @@
 // On-demand image optimization: a Web `Request` → `Response` handler that resizes
 // and re-encodes images (to AVIF/WebP by content negotiation), plus a matching
-// `imageLoader` for `@fluixi-ui/image`. The actual codec is pluggable — the
+// `imageLoader` for `@fluixi-ui/image`. The actual codec is pluggable, the
 // default uses `sharp` if it's installed, otherwise it streams the source through
 // unchanged (so the framework never hard-depends on a native module).
 import { readFile } from 'node:fs/promises';
@@ -52,7 +52,7 @@ function imageResponse(body, contentType, maxAge) {
  *
  * ```ts
  * // src/api/image.ts
- * import { createImageHandler } from '@fluixi/start';
+ * import { createImageHandler } from '@fluixi/start/image';
  * export const GET = createImageHandler({ root: 'public', domains: ['cdn.example.com'] });
  * ```
  *
@@ -113,7 +113,7 @@ export function createImageHandler(options = {}) {
             }
             sourceType = MIME[extname(filePath).toLowerCase()] ?? 'application/octet-stream';
         }
-        // Vector / animated sources aren't rasterized — stream them through.
+        // Vector / animated sources aren't rasterized, stream them through.
         if (sourceType === 'image/svg+xml' || sourceType === 'image/gif') {
             return imageResponse(input, sourceType, maxAge);
         }
@@ -134,21 +134,5 @@ export function createImageHandler(options = {}) {
         return imageResponse(body, contentType, maxAge);
     };
 }
-/**
- * A loader for `@fluixi-ui/image` that targets a {@link createImageHandler} route.
- *
- * ```tsx
- * import { imageLoader } from '@fluixi/start';
- * const loader = imageLoader({ path: '/api/image' });
- * <Image src="/mug.jpg" loader={loader} widths={[120, 240, 480]} />
- * ```
- */
-export function imageLoader(options = {}) {
-    const path = options.path ?? '/api/image';
-    return ({ src, width, quality }) => {
-        const params = new URLSearchParams({ url: src, w: String(width) });
-        if (quality != null)
-            params.set('q', String(quality));
-        return `${path}?${params.toString()}`;
-    };
-}
+// The loader lives apart, so a page can import it without this module's `node:fs`.
+export { imageLoader } from './image-loader.js';

package/dist/image.mjs

@@ -1,6 +1,20 @@
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+
 // src/image.ts
 import { readFile } from "node:fs/promises";
 import { resolve as resolvePath, join, extname, sep } from "node:path";
+
+// src/image-loader.ts
+function imageLoader(options = {}) {
+  const path = options.path ?? "/api/image";
+  return ({ src, width, quality }) => {
+    const params = new URLSearchParams({ url: src, w: String(width) });
+    if (quality != null) params.set("q", String(quality));
+    return `${path}?${params.toString()}`;
+  };
+}
+
+// src/image.ts
 var DEFAULT_SIZES = [16, 32, 48, 64, 96, 128, 256, 384, 640, 750, 828, 1080, 1200, 1920, 2048, 3840];
 var MIME = {
   ".jpg": "image/jpeg",
@@ -106,14 +120,6 @@ function createImageHandler(options = {}) {
     return imageResponse(body, contentType, maxAge);
   };
 }
-function imageLoader(options = {}) {
-  const path = options.path ?? "/api/image";
-  return ({ src, width, quality }) => {
-    const params = new URLSearchParams({ url: src, w: String(width) });
-    if (quality != null) params.set("q", String(quality));
-    return `${path}?${params.toString()}`;
-  };
-}
 export {
   createImageHandler,
   imageLoader