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

package/dist/config.d.ts

@@ -2,7 +2,7 @@ import type { Adapter } from './adapter.js';
 import type { ComponentResolverRule } from '@fluixi/compiler';
 /**
  * Fluixi app config. Place in `fluixi.config.{ts,js,mjs}` at the app root and wrap
- * with `defineConfig` for types. Everything is optional — the defaults match the
+ * with `defineConfig` for types. Everything is optional, the defaults match the
  * conventional layout (src/entry-server.ts, src/entry-client.ts, index.html).
  */
 export interface FluixiConfig {
@@ -10,7 +10,7 @@ export interface FluixiConfig {
     root?: string;
     /**
      * Render mode. `true` (default) = SSR: the server entry renders HTML per request. `false`
-     * = SPA: the server serves the static shell and the client renders — but you still get the
+     * = SPA: the server serves the static shell and the client renders, but you still get the
      * full @fluixi/start server (file routing, middleware, env, and `/_server` server functions).
      * The same app code runs either way; flip this to choose where the first paint happens.
      */
@@ -31,7 +31,7 @@ export interface FluixiConfig {
     apiDir?: string;
     /** Request middleware module (default-exports `defineMiddleware([...])`). Default: src/middleware.ts */
     middleware?: string;
-    /** SSR deps Vite must bundle (no-external) — e.g. ESM packages without file extensions. */
+    /** SSR deps Vite must bundle (no-external), e.g. ESM packages without file extensions. */
     ssrNoExternal?: string[];
     /**
      * Where a capitalised tag with no import in scope comes from.
@@ -41,9 +41,26 @@ export interface FluixiConfig {
      * so a whole directory is one rule rather than a list to maintain.
      *
      * Only needed for tags you don't import. A `load:` directive works on your own import
-     * too — see the docs on load strategies.
+     * too: see the docs on load strategies.
      */
     resolve?: readonly ComponentResolverRule[];
+    /**
+     * Options handed to the fluixi vite plugin.
+     *
+     * A start app does not write `fluixi()` into a vite config, the framework adds the
+     * plugin itself, so this is where its options go: `propsDestructure`, and anything
+     * else the compiler takes. `resolve` above is the shorthand for the one most apps
+     * set, and wins over a `resolve` given here.
+     */
+    vitePlugin?: Record<string, unknown>;
+    /**
+     * Extra vite plugins, appended after the framework's own.
+     *
+     * A start app has no vite config of its own, so a plugin it needs but the framework
+     * does not ship, a css engine for instance, is declared here instead of forcing a
+     * second config file into the project.
+     */
+    plugins?: unknown[];
     /**
      * Deploy target. Decides how `fluixi build` bundles the server (see the adapter's
      * `bundle` mode) and how `fluixi start` serves it. Unset keeps Vite's own bundling
@@ -54,7 +71,7 @@ export interface FluixiConfig {
      * Built-in i18n auto-discovery. Scans `<dir>/<locale>.json` and exposes them as
      * `virtual:fluixi-i18n` (`{ messages, locales, defaultLocale }`) to feed `createI18n`.
      * `false` disables it; an object configures the folder / locales / default. Default: enabled
-     * with `src/i18n` — a no-op until that folder has `*.json` files, so it's effectively opt-in.
+     * with `src/i18n`: a no-op until that folder has `*.json` files, so it's effectively opt-in.
      */
     i18n?: boolean | {
         dir?: string;
@@ -91,13 +108,13 @@ export type ResolvedConfig = Required<Omit<FluixiConfig, 'ssrNoExternal' | 'i18n
     adapter?: Adapter;
 };
 /** Identity helper for editor types in `fluixi.config.ts`. */
-export declare function defineConfig(config: FluixiConfig): FluixiConfig;
+export { defineConfig } from './define-config.js';
 /** Apply defaults. */
 export declare function resolveConfig(config?: FluixiConfig): ResolvedConfig;
 /**
  * Load `fluixi.config.{ts,mts,mjs,js}` from the app root. TypeScript configs are
  * bundled on the fly with esbuild and imported; plain ESM is imported directly.
- * No config is fine too — every field has a default.
+ * No config is fine too: every field has a default.
  */
 export declare function loadConfig(root?: string): Promise<FluixiConfig>;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6GAA6G;IAC7G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wGAAwG;IACxG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2FAA2F;IAC3F,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3C;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC9E;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9D;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CACnC,IAAI,CAAC,YAAY,EAAE,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC,CACvE,GAAG;IACF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,YAAY,GAAG,KAAK,CAAC;IAC3B,SAAS,EAAE,iBAAiB,GAAG,KAAK,CAAC;IACrC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAE/D;AAED,sBAAsB;AACtB,wBAAgB,aAAa,CAAC,MAAM,GAAE,YAAiB,GAAG,cAAc,CAmBvE;AAgCD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,SAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAM5E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6GAA6G;IAC7G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wGAAwG;IACxG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3C;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC9E;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9D;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CACnC,IAAI,CAAC,YAAY,EAAE,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC,CACvE,GAAG;IACF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,YAAY,GAAG,KAAK,CAAC;IAC3B,SAAS,EAAE,iBAAiB,GAAG,KAAK,CAAC;IACrC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,8DAA8D;AAG9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,sBAAsB;AACtB,wBAAgB,aAAa,CAAC,MAAM,GAAE,YAAiB,GAAG,cAAc,CAqBvE;AAgCD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,SAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAM5E"}

package/dist/config.js

@@ -3,9 +3,9 @@ import { existsSync } from 'node:fs';
 import { writeFile, unlink } from 'node:fs/promises';
 import { resolve, isAbsolute } from 'node:path';
 /** Identity helper for editor types in `fluixi.config.ts`. */
-export function defineConfig(config) {
-    return config;
-}
+// One implementation, re-exported: the root entry needs it without this module's
+// `node:fs`, and two copies of an identity function is how their signatures drift.
+export { defineConfig } from './define-config.js';
 /** Apply defaults. */
 export function resolveConfig(config = {}) {
     const root = resolve(config.root ?? process.cwd());
@@ -22,6 +22,8 @@ export function resolveConfig(config = {}) {
         middleware: config.middleware ?? 'src/middleware.ts',
         ssrNoExternal: config.ssrNoExternal ?? [],
         resolve: config.resolve ?? [],
+        vitePlugin: config.vitePlugin ?? {},
+        plugins: config.plugins ?? [],
         adapter: config.adapter,
         i18n: resolveI18n(config.i18n),
         prerender: resolvePrerender(config.prerender),
@@ -59,7 +61,7 @@ const CONFIG_NAMES = [
 /**
  * Load `fluixi.config.{ts,mts,mjs,js}` from the app root. TypeScript configs are
  * bundled on the fly with esbuild and imported; plain ESM is imported directly.
- * No config is fine too — every field has a default.
+ * No config is fine too: every field has a default.
  */
 export async function loadConfig(root = process.cwd()) {
     for (const name of CONFIG_NAMES) {
@@ -70,12 +72,12 @@ export async function loadConfig(root = process.cwd()) {
     return {};
 }
 async function loadConfigFile(file) {
-    // Plain ESM (.mjs/.js) — import directly, no transform needed.
+    // Plain ESM (.mjs/.js), import directly, no transform needed.
     if (!/\.[mc]?ts$/.test(file)) {
         const mod = await import(/* @vite-ignore */ pathToFileURL(file).href);
         return (mod.default ?? mod);
     }
-    // TypeScript — bundle with esbuild, keeping bare specifiers external so
+    // TypeScript: bundle with esbuild, keeping bare specifiers external so
     // `import { defineConfig } from '@fluixi/start'` and node builtins resolve from
     // the app. Relative imports (shared constants, env helpers) ARE bundled in. The
     // output is written to a temp `.mjs` beside the source so those externals resolve

package/dist/config.mjs

@@ -1,13 +1,17 @@
-/*! @fluixi/start v0.1.0-alpha.74 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/start v0.1.0-alpha.76 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/config.ts
 import { pathToFileURL } from "node:url";
 import { existsSync } from "node:fs";
 import { writeFile, unlink } from "node:fs/promises";
 import { resolve, isAbsolute } from "node:path";
+
+// src/define-config.ts
 function defineConfig(config) {
   return config;
 }
+
+// src/config.ts
 function resolveConfig(config = {}) {
   const root = resolve(config.root ?? process.cwd());
   return {
@@ -23,6 +27,8 @@ function resolveConfig(config = {}) {
     middleware: config.middleware ?? "src/middleware.ts",
     ssrNoExternal: config.ssrNoExternal ?? [],
     resolve: config.resolve ?? [],
+    vitePlugin: config.vitePlugin ?? {},
+    plugins: config.plugins ?? [],
     adapter: config.adapter,
     i18n: resolveI18n(config.i18n),
     prerender: resolvePrerender(config.prerender)

package/dist/define-config.cjs

@@ -0,0 +1,32 @@
+"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/define-config.ts
+var define_config_exports = {};
+__export(define_config_exports, {
+  defineConfig: () => defineConfig
+});
+module.exports = __toCommonJS(define_config_exports);
+function defineConfig(config) {
+  return config;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineConfig
+});

package/dist/define-config.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `defineConfig`, alone, away from the loader.
+ *
+ * It is an identity function that exists for the types, and it belongs to the root
+ * export because a config file is the first thing an app writes. Keeping it here rather
+ * than in `config.ts` is what lets the root entry stay importable in a browser: that
+ * module reads the filesystem to find and load a config, and a single value imported
+ * from it drags `node:fs` into the client bundle.
+ */
+import type { FluixiConfig } from './config.js';
+export declare function defineConfig(config: FluixiConfig): FluixiConfig;
+//# sourceMappingURL=define-config.d.ts.map

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.76 | (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.76 | (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.76 | (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.76 | (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.76 | (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.76 | (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.76 | (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.76 | (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.76 | (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.76 | (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.76 | (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.76 | (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"}