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

package/dist/handler.mjs

@@ -0,0 +1,152 @@
+/*! @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";
+import { createReadStream } from "node:fs";
+import { Readable } from "node:stream";
+import { join, extname } from "node:path";
+function streamDocument(head, body, tail) {
+  const enc = new TextEncoder();
+  const stream = new ReadableStream({
+    async start(controller) {
+      try {
+        controller.enqueue(enc.encode(head));
+        const reader = body.getReader();
+        for (; ; ) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          controller.enqueue(value);
+        }
+        controller.enqueue(enc.encode(tail));
+        controller.close();
+      } catch (err) {
+        controller.error(err);
+      }
+    }
+  });
+  return new Response(stream, {
+    status: 200,
+    headers: { "content-type": "text/html; charset=utf-8" }
+  });
+}
+function createRequestHandler(render) {
+  return async (request) => {
+    const url = new URL(request.url);
+    try {
+      const html = await render(url.pathname + url.search, request);
+      return new Response(html, {
+        status: 200,
+        headers: { "content-type": "text/html; charset=utf-8" }
+      });
+    } catch (e) {
+      return new Response(String(e?.stack || e), {
+        status: 500,
+        headers: { "content-type": "text/plain; charset=utf-8" }
+      });
+    }
+  };
+}
+function nodeToRequest(req) {
+  const host = req.headers.host ?? "localhost";
+  const url = `http://${host}${req.url ?? "/"}`;
+  const headers = new Headers();
+  for (const [k, v] of Object.entries(req.headers)) {
+    if (Array.isArray(v)) v.forEach((x) => headers.append(k, x));
+    else if (v != null) headers.set(k, v);
+  }
+  const method = req.method ?? "GET";
+  const init = { method, headers };
+  if (method !== "GET" && method !== "HEAD") {
+    init.body = req;
+    init.duplex = "half";
+  }
+  return new Request(url, init);
+}
+async function sendResponse(res, response) {
+  res.statusCode = response.status;
+  response.headers.forEach((value, key) => res.setHeader(key, value));
+  const body = response.body;
+  if (!body) {
+    res.end(await response.text().catch(() => ""));
+    return;
+  }
+  const reader = body.getReader();
+  try {
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      res.write(value);
+    }
+  } finally {
+    res.end();
+  }
+}
+function toNodeHandler(handler) {
+  return async (req, res) => {
+    const response = await handler(nodeToRequest(req));
+    await sendResponse(res, response);
+  };
+}
+function serveNode(handler, opts = {}) {
+  const port = opts.port ?? 3e3;
+  const node = toNodeHandler(handler);
+  const server = createHttpServer((req, res) => {
+    node(req, res).catch((e) => {
+      res.statusCode = 500;
+      res.end(String(e?.stack || e));
+    });
+  });
+  server.listen(
+    port,
+    () => opts.onListen ? opts.onListen(port) : console.log(`  fluixi → http://localhost:${port}`)
+  );
+  return server;
+}
+var MIME = {
+  ".js": "text/javascript",
+  ".mjs": "text/javascript",
+  ".css": "text/css",
+  ".html": "text/html",
+  ".json": "application/json",
+  ".svg": "image/svg+xml",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".webp": "image/webp",
+  ".ico": "image/x-icon",
+  ".woff": "font/woff",
+  ".woff2": "font/woff2",
+  ".map": "application/json"
+};
+function withStaticFiles(handler, dir) {
+  return async (request) => {
+    const { pathname } = new URL(request.url);
+    if (pathname !== "/" && extname(pathname)) {
+      const file = join(dir, decodeURIComponent(pathname));
+      try {
+        const s = await stat(file);
+        if (s.isFile()) {
+          const body = Readable.toWeb(createReadStream(file));
+          return new Response(body, {
+            headers: {
+              "content-type": MIME[extname(file).toLowerCase()] ?? "application/octet-stream",
+              "content-length": String(s.size)
+            }
+          });
+        }
+      } catch {
+      }
+    }
+    return handler(request);
+  };
+}
+export {
+  createRequestHandler,
+  nodeToRequest,
+  sendResponse,
+  serveNode,
+  streamDocument,
+  toNodeHandler,
+  withStaticFiles
+};

package/dist/head.cjs

@@ -0,0 +1,25 @@
+/*! @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;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/head.ts
+var head_exports = {};
+module.exports = __toCommonJS(head_exports);
+__reExport(head_exports, require("@fluixi/head"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("@fluixi/head")
+});

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

@@ -0,0 +1,4 @@
+/*! @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

@@ -0,0 +1,151 @@
+/*! @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;
+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.ts
+var image_exports = {};
+__export(image_exports, {
+  createImageHandler: () => createImageHandler,
+  imageLoader: () => imageLoader
+});
+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",
+  ".jpeg": "image/jpeg",
+  ".png": "image/png",
+  ".webp": "image/webp",
+  ".avif": "image/avif",
+  ".gif": "image/gif",
+  ".svg": "image/svg+xml"
+};
+var sharpModule;
+async function loadSharp() {
+  if (sharpModule !== void 0) return sharpModule;
+  try {
+    const name = "sharp";
+    sharpModule = (await import(
+      /* @vite-ignore */
+      name
+    )).default;
+  } catch {
+    sharpModule = null;
+  }
+  return sharpModule;
+}
+var defaultTransform = async (input, { width, quality, format }) => {
+  const sharp = await loadSharp();
+  if (!sharp) return null;
+  const pipe = sharp(input).rotate().resize({ width, withoutEnlargement: true });
+  if (format === "avif") return { data: new Uint8Array(await pipe.avif({ quality }).toBuffer()), contentType: "image/avif" };
+  if (format === "webp") return { data: new Uint8Array(await pipe.webp({ quality }).toBuffer()), contentType: "image/webp" };
+  if (format === "png") return { data: new Uint8Array(await pipe.png().toBuffer()), contentType: "image/png" };
+  return { data: new Uint8Array(await pipe.jpeg({ quality, mozjpeg: true }).toBuffer()), contentType: "image/jpeg" };
+};
+function imageResponse(body, contentType, maxAge) {
+  return new Response(body, {
+    headers: {
+      "content-type": contentType,
+      "cache-control": `public, max-age=${maxAge}, immutable`,
+      vary: "Accept"
+    }
+  });
+}
+function createImageHandler(options = {}) {
+  const root = (0, import_node_path.resolve)(options.root ?? (0, import_node_path.join)(process.cwd(), "public"));
+  const domains = new Set((options.domains ?? []).map((d) => d.toLowerCase()));
+  const sizes = options.sizes ?? DEFAULT_SIZES;
+  const maxQuality = options.quality ?? 80;
+  const maxAge = options.cacheMaxAge ?? 60 * 60 * 24 * 365;
+  const transform = options.transform ?? defaultTransform;
+  const cacheMax = options.cache === false ? 0 : typeof options.cache === "number" ? options.cache : 100;
+  const cache = /* @__PURE__ */ new Map();
+  return async (request) => {
+    const url = new URL(request.url);
+    const src = url.searchParams.get("url") ?? url.searchParams.get("src");
+    const width = Number(url.searchParams.get("w"));
+    const quality = Math.min(Math.max(Number(url.searchParams.get("q")) || maxQuality, 1), 100);
+    if (!src) return new Response('missing "url"', { status: 400 });
+    if (!Number.isInteger(width) || !sizes.includes(width)) return new Response('invalid "w"', { status: 400 });
+    const accept = request.headers.get("accept") ?? "";
+    const format = accept.includes("image/avif") ? "avif" : accept.includes("image/webp") ? "webp" : "original";
+    const key = `${src}|${width}|${quality}|${format}`;
+    const hit = cache.get(key);
+    if (hit) return imageResponse(hit.body, hit.contentType, maxAge);
+    let input;
+    let sourceType;
+    if (/^https?:\/\//i.test(src)) {
+      let host;
+      try {
+        host = new URL(src).hostname.toLowerCase();
+      } catch {
+        return new Response("bad url", { status: 400 });
+      }
+      if (!domains.has(host)) return new Response("domain not allowed", { status: 403 });
+      const res = await fetch(src);
+      if (!res.ok) return new Response("upstream error", { status: 502 });
+      input = new Uint8Array(await res.arrayBuffer());
+      sourceType = res.headers.get("content-type") ?? "application/octet-stream";
+    } else {
+      const filePath = (0, import_node_path.resolve)(root, src.startsWith("/") ? src.slice(1) : src);
+      if (filePath !== root && !filePath.startsWith(root + import_node_path.sep)) return new Response("forbidden", { status: 403 });
+      try {
+        input = new Uint8Array(await (0, import_promises.readFile)(filePath));
+      } catch {
+        return new Response("not found", { status: 404 });
+      }
+      sourceType = MIME[(0, import_node_path.extname)(filePath).toLowerCase()] ?? "application/octet-stream";
+    }
+    if (sourceType === "image/svg+xml" || sourceType === "image/gif") {
+      return imageResponse(input, sourceType, maxAge);
+    }
+    let out = null;
+    try {
+      out = await transform(input, { width, quality, format, contentType: sourceType });
+    } catch {
+      out = null;
+    }
+    const body = out?.data ?? input;
+    const contentType = out?.contentType ?? sourceType;
+    if (cacheMax > 0) {
+      if (cache.size >= cacheMax) cache.delete(cache.keys().next().value);
+      cache.set(key, { body, contentType });
+    }
+    return imageResponse(body, contentType, maxAge);
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createImageHandler,
+  imageLoader
+});

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

@@ -0,0 +1,126 @@
+/*! @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",
+  ".jpeg": "image/jpeg",
+  ".png": "image/png",
+  ".webp": "image/webp",
+  ".avif": "image/avif",
+  ".gif": "image/gif",
+  ".svg": "image/svg+xml"
+};
+var sharpModule;
+async function loadSharp() {
+  if (sharpModule !== void 0) return sharpModule;
+  try {
+    const name = "sharp";
+    sharpModule = (await import(
+      /* @vite-ignore */
+      name
+    )).default;
+  } catch {
+    sharpModule = null;
+  }
+  return sharpModule;
+}
+var defaultTransform = async (input, { width, quality, format }) => {
+  const sharp = await loadSharp();
+  if (!sharp) return null;
+  const pipe = sharp(input).rotate().resize({ width, withoutEnlargement: true });
+  if (format === "avif") return { data: new Uint8Array(await pipe.avif({ quality }).toBuffer()), contentType: "image/avif" };
+  if (format === "webp") return { data: new Uint8Array(await pipe.webp({ quality }).toBuffer()), contentType: "image/webp" };
+  if (format === "png") return { data: new Uint8Array(await pipe.png().toBuffer()), contentType: "image/png" };
+  return { data: new Uint8Array(await pipe.jpeg({ quality, mozjpeg: true }).toBuffer()), contentType: "image/jpeg" };
+};
+function imageResponse(body, contentType, maxAge) {
+  return new Response(body, {
+    headers: {
+      "content-type": contentType,
+      "cache-control": `public, max-age=${maxAge}, immutable`,
+      vary: "Accept"
+    }
+  });
+}
+function createImageHandler(options = {}) {
+  const root = resolvePath(options.root ?? join(process.cwd(), "public"));
+  const domains = new Set((options.domains ?? []).map((d) => d.toLowerCase()));
+  const sizes = options.sizes ?? DEFAULT_SIZES;
+  const maxQuality = options.quality ?? 80;
+  const maxAge = options.cacheMaxAge ?? 60 * 60 * 24 * 365;
+  const transform = options.transform ?? defaultTransform;
+  const cacheMax = options.cache === false ? 0 : typeof options.cache === "number" ? options.cache : 100;
+  const cache = /* @__PURE__ */ new Map();
+  return async (request) => {
+    const url = new URL(request.url);
+    const src = url.searchParams.get("url") ?? url.searchParams.get("src");
+    const width = Number(url.searchParams.get("w"));
+    const quality = Math.min(Math.max(Number(url.searchParams.get("q")) || maxQuality, 1), 100);
+    if (!src) return new Response('missing "url"', { status: 400 });
+    if (!Number.isInteger(width) || !sizes.includes(width)) return new Response('invalid "w"', { status: 400 });
+    const accept = request.headers.get("accept") ?? "";
+    const format = accept.includes("image/avif") ? "avif" : accept.includes("image/webp") ? "webp" : "original";
+    const key = `${src}|${width}|${quality}|${format}`;
+    const hit = cache.get(key);
+    if (hit) return imageResponse(hit.body, hit.contentType, maxAge);
+    let input;
+    let sourceType;
+    if (/^https?:\/\//i.test(src)) {
+      let host;
+      try {
+        host = new URL(src).hostname.toLowerCase();
+      } catch {
+        return new Response("bad url", { status: 400 });
+      }
+      if (!domains.has(host)) return new Response("domain not allowed", { status: 403 });
+      const res = await fetch(src);
+      if (!res.ok) return new Response("upstream error", { status: 502 });
+      input = new Uint8Array(await res.arrayBuffer());
+      sourceType = res.headers.get("content-type") ?? "application/octet-stream";
+    } else {
+      const filePath = resolvePath(root, src.startsWith("/") ? src.slice(1) : src);
+      if (filePath !== root && !filePath.startsWith(root + sep)) return new Response("forbidden", { status: 403 });
+      try {
+        input = new Uint8Array(await readFile(filePath));
+      } catch {
+        return new Response("not found", { status: 404 });
+      }
+      sourceType = MIME[extname(filePath).toLowerCase()] ?? "application/octet-stream";
+    }
+    if (sourceType === "image/svg+xml" || sourceType === "image/gif") {
+      return imageResponse(input, sourceType, maxAge);
+    }
+    let out = null;
+    try {
+      out = await transform(input, { width, quality, format, contentType: sourceType });
+    } catch {
+      out = null;
+    }
+    const body = out?.data ?? input;
+    const contentType = out?.contentType ?? sourceType;
+    if (cacheMax > 0) {
+      if (cache.size >= cacheMax) cache.delete(cache.keys().next().value);
+      cache.set(key, { body, contentType });
+    }
+    return imageResponse(body, contentType, maxAge);
+  };
+}
+export {
+  createImageHandler,
+  imageLoader
+};