npm - @fluixi/start - Versions diffs - 0.1.0-alpha.73 → 0.1.0-alpha.75 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (123) hide show

package/dist/adapter.cjs +750 -0
package/dist/adapter.d.ts +9 -9
package/dist/adapter.d.ts.map +1 -1
package/dist/adapter.js +10 -10
package/dist/adapter.mjs +719 -0
package/dist/adapters/entry.cjs +122 -0
package/dist/adapters/entry.js +1 -1
package/dist/adapters/entry.mjs +95 -0
package/dist/adapters/platforms.cjs +311 -0
package/dist/adapters/platforms.d.ts +2 -2
package/dist/adapters/platforms.js +8 -8
package/dist/adapters/platforms.mjs +284 -0
package/dist/api-HD7KU3BS.mjs +114 -0
package/dist/api.cjs +145 -0
package/dist/api.js +1 -1
package/dist/api.mjs +116 -0
package/dist/commands/api-HD7KU3BS.mjs +114 -0
package/dist/commands/api-PBT4QZ34.mjs +16 -0
package/dist/commands/api-PJL37LV3.mjs +17 -0
package/dist/commands/build.cjs +877 -0
package/dist/commands/build.js +6 -6
package/dist/commands/build.mjs +717 -0
package/dist/commands/chunk-GFQ4MUIC.mjs +117 -0
package/dist/commands/chunk-MTM6M3TC.mjs +115 -0
package/dist/commands/dev.cjs +670 -0
package/dist/commands/dev.js +3 -3
package/dist/commands/dev.mjs +512 -0
package/dist/commands/index.cjs +1145 -0
package/dist/commands/index.d.ts +1 -1
package/dist/commands/index.js +1 -1
package/dist/commands/index.mjs +982 -0
package/dist/commands/prerender.cjs +404 -0
package/dist/commands/prerender.d.ts +1 -1
package/dist/commands/prerender.js +2 -2
package/dist/commands/prerender.mjs +377 -0
package/dist/commands/start.cjs +463 -0
package/dist/commands/start.d.ts +1 -1
package/dist/commands/start.js +2 -2
package/dist/commands/start.mjs +428 -0
package/dist/config.cjs +150 -0
package/dist/config.d.ts +24 -7
package/dist/config.d.ts.map +1 -1
package/dist/config.js +8 -6
package/dist/config.mjs +114 -0
package/dist/define-config.cjs +32 -0
package/dist/define-config.d.ts +12 -0
package/dist/define-config.d.ts.map +1 -0
package/dist/define-config.js +3 -0
package/dist/define-config.mjs +7 -0
package/dist/di.cjs +200 -0
package/dist/di.d.ts +4 -4
package/dist/di.d.ts.map +1 -1
package/dist/di.js +9 -9
package/dist/di.mjs +169 -0
package/dist/document.cjs +115 -0
package/dist/document.d.ts +1 -1
package/dist/document.js +1 -1
package/dist/document.mjs +86 -0
package/dist/generated-api.cjs +43 -0
package/dist/generated-api.js +1 -1
package/dist/generated-api.mjs +18 -0
package/dist/generated-server-fns.cjs +43 -0
package/dist/generated-server-fns.mjs +18 -0
package/dist/handler-core.cjs +211 -0
package/dist/handler-core.d.ts +2 -2
package/dist/handler-core.js +2 -2
package/dist/handler-core.mjs +185 -0
package/dist/handler.cjs +182 -0
package/dist/handler.d.ts +3 -3
package/dist/handler.js +3 -3
package/dist/handler.mjs +152 -0
package/dist/head.cjs +25 -0
package/dist/head.d.ts +1 -1
package/dist/head.js +1 -1
package/dist/head.mjs +4 -0
package/dist/image-loader.cjs +37 -0
package/dist/image-loader.d.ts +25 -0
package/dist/image-loader.d.ts.map +1 -0
package/dist/image-loader.js +18 -0
package/dist/image-loader.mjs +12 -0
package/dist/image.cjs +151 -0
package/dist/image.d.ts +2 -19
package/dist/image.d.ts.map +1 -1
package/dist/image.js +5 -21
package/dist/image.mjs +126 -0
package/dist/index.cjs +303 -0
package/dist/index.d.ts +28 -8
package/dist/index.d.ts.map +1 -1
package/dist/index.js +33 -17
package/dist/index.mjs +262 -0
package/dist/interceptors.cjs +72 -0
package/dist/interceptors.js +1 -1
package/dist/interceptors.mjs +44 -0
package/dist/internal.cjs +393 -0
package/dist/internal.d.ts +6 -6
package/dist/internal.d.ts.map +1 -1
package/dist/internal.js +23 -15
package/dist/internal.mjs +223 -0
package/dist/middleware.cjs +58 -0
package/dist/middleware.d.ts +3 -3
package/dist/middleware.d.ts.map +1 -1
package/dist/middleware.js +1 -1
package/dist/middleware.mjs +31 -0
package/dist/preload.cjs +42 -0
package/dist/preload.js +1 -1
package/dist/preload.mjs +18 -0
package/dist/router.cjs +25 -0
package/dist/router.d.ts +3 -3
package/dist/router.js +3 -3
package/dist/router.mjs +4 -0
package/dist/server-fn-setup.cjs +46 -0
package/dist/server-fn-setup.d.ts +1 -1
package/dist/server-fn-setup.js +2 -2
package/dist/server-fn-setup.mjs +22 -0
package/dist/server-fn.cjs +109 -0
package/dist/server-fn.d.ts +2 -2
package/dist/server-fn.js +2 -2
package/dist/server-fn.mjs +79 -0
package/dist/tsconfig.lib.tsbuildinfo +1 -1
package/dist/ui.cjs +123 -0
package/dist/ui.js +1 -1
package/dist/ui.mjs +93 -0
package/package.json +63 -25

package/dist/commands/start.mjs ADDED Viewed

@@ -0,0 +1,428 @@
+// src/commands/start.ts
+import { resolve as resolve3 } from "node:path";
+// src/config.ts
+import { resolve, isAbsolute } from "node:path";
+function resolveConfig(config = {}) {
+  const root = resolve(config.root ?? process.cwd());
+  return {
+    root,
+    ssr: config.ssr ?? true,
+    port: config.port ?? 3e3,
+    serverEntry: config.serverEntry ?? "src/entry-server.ts",
+    clientEntry: config.clientEntry ?? "src/entry-client.ts",
+    template: config.template ?? "index.html",
+    mountId: config.mountId ?? "root",
+    routesDir: config.routesDir ?? "src/routes",
+    apiDir: config.apiDir ?? "src/api",
+    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)
+  };
+}
+function resolvePrerender(prerender) {
+  if (!prerender) return false;
+  const opts = typeof prerender === "object" ? prerender : {};
+  return {
+    routes: opts.routes?.length ? opts.routes : ["/"],
+    crawl: opts.crawl ?? true
+  };
+}
+function resolveI18n(i18n) {
+  if (i18n === false) return false;
+  const opts = typeof i18n === "object" ? i18n : {};
+  return {
+    dir: opts.dir ?? "src/i18n",
+    defaultLocale: opts.defaultLocale,
+    locales: opts.locales
+  };
+}
+// src/document.ts
+import { extractHeadMarker } from "@fluixi/head";
+function injectApp(template, appHtml, mountId = "root") {
+  const mount = new RegExp(`<div id=["']${mountId}["']\\s*>\\s*</div>`);
+  if (mount.test(template)) {
+    return template.replace(mount, `<div id="${mountId}">${appHtml}</div>`);
+  }
+  if (template.includes("<!--ssr-outlet-->")) {
+    return template.replace("<!--ssr-outlet-->", appHtml);
+  }
+  return template.replace("</body>", `<div id="${mountId}">${appHtml}</div></body>`);
+}
+function splitTemplate(template, mountId = "root") {
+  const mount = new RegExp(`<div id=["']${mountId}["']\\s*>\\s*</div>`);
+  const m = template.match(mount);
+  if (m && m.index !== void 0) {
+    return {
+      head: template.slice(0, m.index) + `<div id="${mountId}">`,
+      tail: `</div>` + template.slice(m.index + m[0].length)
+    };
+  }
+  const outlet = template.indexOf("<!--ssr-outlet-->");
+  if (outlet !== -1) {
+    return {
+      head: template.slice(0, outlet),
+      tail: template.slice(outlet + "<!--ssr-outlet-->".length)
+    };
+  }
+  const body = template.indexOf("</body>");
+  if (body !== -1) {
+    return {
+      head: template.slice(0, body) + `<div id="${mountId}">`,
+      tail: `</div>` + template.slice(body)
+    };
+  }
+  return { head: template, tail: "" };
+}
+function injectPreload(template, files) {
+  const tags = files.filter((file) => !template.includes(file)).map(
+    (file) => file.endsWith(".css") ? `<link rel="stylesheet" href="${file}">` : (
+      // `modulepreload` also fetches the chunk's own static imports.
+      `<link rel="modulepreload" href="${file}">`
+    )
+  );
+  if (tags.length === 0) return template;
+  const head = template.indexOf("</head>");
+  if (head === -1) return template;
+  return template.slice(0, head) + tags.join("") + template.slice(head);
+}
+function setHtmlAttr(html, name, value) {
+  const existing = new RegExp(`(<html\\b[^>]*?)\\s${name}="[^"]*"`, "i");
+  if (existing.test(html)) return html.replace(existing, `$1 ${name}="${value}"`);
+  return html.replace(/<html\b/i, `<html ${name}="${value}"`);
+}
+function injectAppAndHead(template, rendered, mountId = "root") {
+  const { head, body } = extractHeadMarker(rendered);
+  let html = injectApp(template, body, mountId);
+  if (head) {
+    if (head.headHtml) {
+      if (/<title[\s>]/i.test(head.headHtml)) html = html.replace(/<title>[\s\S]*?<\/title>/i, "");
+      html = html.replace("</head>", `${head.headHtml}</head>`);
+    }
+    for (const [k, v] of Object.entries(head.htmlAttrs)) html = setHtmlAttr(html, k, v);
+  }
+  return html;
+}
+function guardHandler(handler, onError) {
+  return async (request) => {
+    try {
+      return await handler(request);
+    } catch (e) {
+      onError?.(e);
+      return new Response(String(e?.stack || e), {
+        status: 500,
+        headers: { "content-type": "text/plain; charset=utf-8" }
+      });
+    }
+  };
+}
+// src/internal.ts
+async function loadServerEnv(root, mode) {
+  const { loadEnv } = await import("vite");
+  const env = loadEnv(mode, root, "");
+  for (const [k, v] of Object.entries(env)) {
+    if (process.env[k] === void 0) process.env[k] = v;
+  }
+}
+var _guardsInstalled = false;
+function installCrashGuards() {
+  if (_guardsInstalled) return;
+  _guardsInstalled = true;
+  process.on(
+    "unhandledRejection",
+    (reason) => console.warn("[fluixi] unhandled rejection (backend likely down) —", reason?.message || reason)
+  );
+  process.on(
+    "uncaughtException",
+    (err) => console.warn("[fluixi] uncaught exception —", err?.message || err)
+  );
+}
+// src/adapter.ts
+import { readFile } from "node:fs/promises";
+import { existsSync, readFileSync } from "node:fs";
+import { resolve as resolve2, join as join2, dirname } from "node:path";
+import { pathToFileURL } from "node:url";
+// 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);
+  };
+}
+// src/middleware.ts
+function normalizeMiddleware(mod) {
+  const def = mod?.default ?? mod;
+  if (def == null) return [];
+  if (Array.isArray(def)) return def.filter((m) => typeof m === "function");
+  return typeof def === "function" ? [def] : [];
+}
+function composeMiddleware(middlewares, core) {
+  if (middlewares.length === 0) return core;
+  return (request) => {
+    let lastCalled = -1;
+    const dispatch = (i) => {
+      if (i <= lastCalled) {
+        return Promise.reject(new Error("middleware called next() more than once"));
+      }
+      lastCalled = i;
+      const mw = middlewares[i];
+      if (!mw) return Promise.resolve(core(request));
+      return Promise.resolve(mw(request, () => dispatch(i + 1)));
+    };
+    return dispatch(0);
+  };
+}
+// src/handler-core.ts
+function createHandlerFrom({ template, mod, cfg, middleware, preload }) {
+  const withPreload = (html, pathname) => preload ? injectPreload(html, preload(pathname)) : html;
+  let core;
+  if (!cfg.ssr) {
+    core = createRequestHandler(async (url) => withPreload(template, url.split("?")[0]));
+  } else if (typeof mod.renderStream === "function") {
+    core = async (request) => {
+      const url = new URL(request.url);
+      const { head, tail } = splitTemplate(withPreload(template, url.pathname), cfg.mountId);
+      const body = await mod.renderStream(url.pathname + url.search, request);
+      return streamDocument(head, body, tail);
+    };
+  } else {
+    const render = mod.render ?? mod.default;
+    core = createRequestHandler(
+      async (url, request) => (
+        // `url` here is `pathname + search`; matching only ever wants the path.
+        injectAppAndHead(withPreload(template, url.split("?")[0]), await render(url, request), cfg.mountId)
+      )
+    );
+  }
+  if (typeof mod.handleServerFn === "function" && typeof mod.isServerFnRequest === "function") {
+    const render = core;
+    core = async (request) => mod.isServerFnRequest(request) ? mod.handleServerFn(request) : render(request);
+  }
+  if (typeof mod.handleApiRequest === "function" && typeof mod.isApiRequest === "function") {
+    const next = core;
+    core = async (request) => mod.isApiRequest(request) ? mod.handleApiRequest(request) : next(request);
+  }
+  if (!middleware) return guardHandler(core);
+  return guardHandler(composeMiddleware(normalizeMiddleware(middleware), core));
+}
+// src/preload.ts
+import { matchRoutes } from "@fluixi/core/router";
+function createPreloader(assets) {
+  const patterns = Object.keys(assets ?? {});
+  if (!patterns.length) return () => [];
+  const routes = patterns.map((path) => ({ path, meta: { path } }));
+  return (pathname) => {
+    const matched = matchRoutes(routes, pathname)?.matched;
+    const leaf = matched?.[matched.length - 1];
+    const pattern = leaf?.route.meta?.path;
+    return pattern ? assets[pattern] ?? [] : [];
+  };
+}
+// src/adapter.ts
+async function createProdHandler(config = {}) {
+  const cfg = resolveConfig(config);
+  const clientDir = resolve2(cfg.root, "dist/client");
+  const template = await readTemplate(clientDir, resolve2(cfg.root, "dist/server"));
+  const serverEntry = resolve2(cfg.root, "dist/server", "entry-server.js");
+  const mod = existsSync(serverEntry) ? await import(
+    /* @vite-ignore */
+    pathToFileURL(serverEntry).href
+  ) : {};
+  const mwFile = resolve2(cfg.root, "dist/server", "middleware.js");
+  const middleware = existsSync(mwFile) ? await import(
+    /* @vite-ignore */
+    pathToFileURL(mwFile).href
+  ) : void 0;
+  return createHandlerFrom({ template, mod, cfg, middleware, preload: await loadPreloader(cfg) });
+}
+async function readTemplate(clientDir, serverDir) {
+  const stashed = join2(serverDir, "template.html");
+  return readFile(existsSync(stashed) ? stashed : join2(clientDir, "index.html"), "utf-8");
+}
+async function loadPreloader(cfg) {
+  const file = resolve2(cfg.root, "dist/server", "route-assets.json");
+  if (!existsSync(file)) return void 0;
+  try {
+    return createPreloader(JSON.parse(await readFile(file, "utf-8")));
+  } catch {
+    return void 0;
+  }
+}
+var nodeAdapter = {
+  name: "node",
+  // A Node server runs from the app directory, so node_modules is right there: keep the
+  // framework as imports instead of copying it into the bundle.
+  bundle: "external",
+  async serve({ handler, cfg, clientDir }) {
+    serveNode(withStaticFiles(handler, clientDir), {
+      port: cfg.port,
+      onListen: (p) => console.log(`  fluixi start (node) → http://localhost:${p}`)
+    });
+  }
+};
+// src/commands/start.ts
+async function start(config = {}) {
+  const cfg = resolveConfig(config);
+  installCrashGuards();
+  await loadServerEnv(cfg.root, "production");
+  const clientDir = resolve3(cfg.root, "dist/client");
+  const handler = await createProdHandler(cfg);
+  const adapter = cfg.adapter ?? nodeAdapter;
+  const served = await adapter.serve({ handler, cfg, clientDir });
+  if (served && typeof served === "object" && "fetch" in served) {
+    console.log(
+      `  fluixi: the "${adapter.name}" adapter exports a fetch handler — there is no server to start. Deploy dist/ and let the platform invoke it, or run \`fluixi start\` with a filesystem adapter (nodeAdapter).`
+    );
+  }
+}
+export {
+  start
+};

package/dist/config.cjs ADDED Viewed

@@ -0,0 +1,150 @@
+/*! @fluixi/start v0.1.0-alpha.75 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+// src/config.ts
+var config_exports = {};
+__export(config_exports, {
+  defineConfig: () => defineConfig,
+  loadConfig: () => loadConfig,
+  resolveConfig: () => resolveConfig
+});
+module.exports = __toCommonJS(config_exports);
+var import_node_url = require("node:url");
+var import_node_fs = require("node:fs");
+var import_promises = require("node:fs/promises");
+var import_node_path = require("node:path");
+// src/define-config.ts
+function defineConfig(config) {
+  return config;
+}
+// src/config.ts
+function resolveConfig(config = {}) {
+  const root = (0, import_node_path.resolve)(config.root ?? process.cwd());
+  return {
+    root,
+    ssr: config.ssr ?? true,
+    port: config.port ?? 3e3,
+    serverEntry: config.serverEntry ?? "src/entry-server.ts",
+    clientEntry: config.clientEntry ?? "src/entry-client.ts",
+    template: config.template ?? "index.html",
+    mountId: config.mountId ?? "root",
+    routesDir: config.routesDir ?? "src/routes",
+    apiDir: config.apiDir ?? "src/api",
+    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)
+  };
+}
+function resolvePrerender(prerender) {
+  if (!prerender) return false;
+  const opts = typeof prerender === "object" ? prerender : {};
+  return {
+    routes: opts.routes?.length ? opts.routes : ["/"],
+    crawl: opts.crawl ?? true
+  };
+}
+function resolveI18n(i18n) {
+  if (i18n === false) return false;
+  const opts = typeof i18n === "object" ? i18n : {};
+  return {
+    dir: opts.dir ?? "src/i18n",
+    defaultLocale: opts.defaultLocale,
+    locales: opts.locales
+  };
+}
+var CONFIG_NAMES = [
+  "fluixi.config.ts",
+  "fluixi.config.mts",
+  "fluixi.config.mjs",
+  "fluixi.config.js"
+];
+async function loadConfig(root = process.cwd()) {
+  for (const name of CONFIG_NAMES) {
+    const file = (0, import_node_path.resolve)(root, name);
+    if ((0, import_node_fs.existsSync)(file)) return loadConfigFile(file);
+  }
+  return {};
+}
+async function loadConfigFile(file) {
+  if (!/\.[mc]?ts$/.test(file)) {
+    const mod = await import(
+      /* @vite-ignore */
+      (0, import_node_url.pathToFileURL)(file).href
+    );
+    return mod.default ?? mod;
+  }
+  const esbuild = await import("esbuild");
+  const { outputFiles } = await esbuild.build({
+    entryPoints: [file],
+    bundle: true,
+    write: false,
+    format: "esm",
+    platform: "node",
+    target: `node${process.versions.node.split(".")[0]}`,
+    sourcemap: "inline",
+    plugins: [
+      {
+        name: "fluixi:externalize-bare",
+        setup(b) {
+          b.onResolve({ filter: /.*/ }, (args) => {
+            if (args.kind === "entry-point") return null;
+            if (args.path.startsWith(".") || (0, import_node_path.isAbsolute)(args.path)) return null;
+            return { path: args.path, external: true };
+          });
+        }
+      }
+    ]
+  });
+  const tempFile = `${file}.timestamp-${Date.now()}-${Math.random().toString(16).slice(2)}.mjs`;
+  await (0, import_promises.writeFile)(tempFile, outputFiles[0].text);
+  try {
+    const mod = await import(
+      /* @vite-ignore */
+      (0, import_node_url.pathToFileURL)(tempFile).href
+    );
+    return mod.default ?? mod;
+  } finally {
+    await (0, import_promises.unlink)(tempFile).catch(() => {
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineConfig,
+  loadConfig,
+  resolveConfig
+});

package/dist/config.d.ts CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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"}
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,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"}