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

package/dist/adapter.d.ts

@@ -10,7 +10,7 @@ export declare function createProdHandler(config?: FluixiConfig): Promise<FetchH
 /**
  * The shell the server renders into.
  *
- * `dist/client/index.html` is it, until the app prerenders `/` — then that path holds a
+ * `dist/client/index.html` is it, until the app prerenders `/`, then that path holds a
  * rendered page and the build stashes the shell in `dist/server/template.html` first.
  * Rendering into the page instead puts the home page's markup and head around every
  * SSR response, and leaves hydration two mount elements to choose between.
@@ -35,7 +35,7 @@ export interface AdapterBuildContext {
     hasServer: boolean;
     /**
      * Bundle a generated entry into one self-contained file. Adapters emit a small
-     * platform entry — the worker's `fetch` export, the function's handler — and this
+     * platform entry: the worker's `fetch` export, the function's handler, and this
      * pulls the server bundle and the template into it, because none of these
      * platforms can resolve a module or read a file at runtime.
      */
@@ -45,7 +45,7 @@ export interface AdapterBuildContext {
  * A deploy target.
  *
  * The runtime-neutral fetch handler is the portable core; an adapter packages it for a
- * platform — how the server is bundled (`bundle`), how it is served in development or
+ * platform: how the server is bundled (`bundle`), how it is served in development or
  * on a long-running host (`serve`), and what a deploy actually needs on disk
  * (`build`): a worker entry, a function manifest, a routing config.
  */
@@ -55,10 +55,10 @@ export interface Adapter {
      * How `fluixi build` bundles the framework into the server output. The choice is a
      * property of the deploy target, not of the app:
      *
-     * - `'external'` — `@fluixi/*` stays as bare imports, resolved from `node_modules` at
+     * - `'external'`: `@fluixi/*` stays as bare imports, resolved from `node_modules` at
      *   runtime. Smaller output, faster build; requires the dependencies to be installed
      *   next to it. Right for a long-running Node/Bun/Deno process.
-     * - `'inline'` — everything is bundled into one self-contained file that resolves
+     * - `'inline'`: everything is bundled into one self-contained file that resolves
      *   nothing at runtime. Right for edge/serverless, where there is no `node_modules`.
      *
      * Unset leaves Vite's own heuristic alone (installed deps external, linked ones bundled).
@@ -73,10 +73,10 @@ export interface Adapter {
      */
     build?(ctx: AdapterBuildContext): Promise<void> | void;
 }
-/** Reference filesystem adapter — Node `http` + static files from dist/client. */
+/** Reference filesystem adapter: Node `http` + static files from dist/client. */
 export declare const nodeAdapter: Adapter;
 export { cloudflareAdapter, netlifyAdapter, vercelAdapter } from './adapters/platforms.js';
-/** Reference edge/web adapter — export `{ fetch }`; the platform serves assets. */
+/** Reference edge/web adapter: export `{ fetch }`; the platform serves assets. */
 export declare const webAdapter: Adapter;
 /**
  * The Vite `ssr` options for a build, given the configured adapter's `bundle` mode.
@@ -91,9 +91,9 @@ export declare const webAdapter: Adapter;
  * only honours an *exact* id in `ssr.external`. A bare package name falls through to a
  * resolvability probe that does not externalize deep imports here, and the result is the
  * worst of both worlds: `@fluixi/core` an import, `@fluixi/core/router` copied into
- * the bundle — two routers, two sets of module state, in one server.
+ * the bundle: two routers, two sets of module state, in one server.
  *
- * `ssrNoExternal` always wins — it is the app saying "this one must be bundled".
+ * `ssrNoExternal` always wins: it is the app saying "this one must be bundled".
  */
 export declare function ssrBuildOptions(cfg: ResolvedConfig): {
     noExternal?: string[] | true;

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAI7E;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAiBxF;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxF;AAoBD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,CAAC;IACtB,GAAG,EAAE,cAAc,CAAC;IACpB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,cAAc,CAAC;IACpB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC/B,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG;QAAE,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC;IACpE;;;OAGG;IACH,KAAK,CAAC,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACxD;AAED,kFAAkF;AAClF,eAAO,MAAM,WAAW,EAAE,OAWzB,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE3F,mFAAmF;AACnF,eAAO,MAAM,UAAU,EAAE,OAQxB,CAAC;AAUF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG;IACpD,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAoBA"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAI7E;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAiBxF;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxF;AAoBD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,CAAC;IACtB,GAAG,EAAE,cAAc,CAAC;IACpB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,cAAc,CAAC;IACpB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC/B,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG;QAAE,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC;IACpE;;;OAGG;IACH,KAAK,CAAC,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACxD;AAED,iFAAiF;AACjF,eAAO,MAAM,WAAW,EAAE,OAWzB,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE3F,kFAAkF;AAClF,eAAO,MAAM,UAAU,EAAE,OAQxB,CAAC;AAUF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG;IACpD,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAoBA"}

package/dist/adapter.js

@@ -18,7 +18,7 @@ export async function createProdHandler(config = {}) {
     const clientDir = resolve(cfg.root, 'dist/client');
     const template = await readTemplate(clientDir, resolve(cfg.root, 'dist/server'));
     const serverEntry = resolve(cfg.root, 'dist/server', 'entry-server.js');
-    // SPA apps may ship no server entry (or one only for server functions) — import if present.
+    // SPA apps may ship no server entry (or one only for server functions), import if present.
     const mod = existsSync(serverEntry)
         ? await import(/* @vite-ignore */ pathToFileURL(serverEntry).href)
         : {};
@@ -32,7 +32,7 @@ export async function createProdHandler(config = {}) {
 /**
  * The shell the server renders into.
  *
- * `dist/client/index.html` is it, until the app prerenders `/` — then that path holds a
+ * `dist/client/index.html` is it, until the app prerenders `/`, then that path holds a
  * rendered page and the build stashes the shell in `dist/server/template.html` first.
  * Rendering into the page instead puts the home page's markup and head around every
  * SSR response, and leaves hydration two mount elements to choose between.
@@ -59,7 +59,7 @@ async function loadPreloader(cfg) {
         return undefined;
     }
 }
-/** Reference filesystem adapter — Node `http` + static files from dist/client. */
+/** Reference filesystem adapter: Node `http` + static files from dist/client. */
 export const nodeAdapter = {
     name: 'node',
     // A Node server runs from the app directory, so node_modules is right there: keep the
@@ -73,7 +73,7 @@ export const nodeAdapter = {
     },
 };
 export { cloudflareAdapter, netlifyAdapter, vercelAdapter } from './adapters/platforms.js';
-/** Reference edge/web adapter — export `{ fetch }`; the platform serves assets. */
+/** Reference edge/web adapter: export `{ fetch }`; the platform serves assets. */
 export const webAdapter = {
     name: 'web',
     // An edge/serverless runtime uploads a file, not an install: nothing may be left to
@@ -87,7 +87,7 @@ export const webAdapter = {
  * Subpaths that only look like package entries: a Vite plugin replaces them with the
  * app's generated route/server-fn/API tables, and the real file in the package is a stub
  * that throws. Externalizing one would ship the stub. The plugins run with
- * `enforce: 'pre'` so they win anyway — this list is the second lock on that door.
+ * `enforce: 'pre'` so they win anyway: this list is the second lock on that door.
  */
 const GENERATED_SUBPATHS = new Set(['./routes', './server-fns', './api-routes']);
 /**
@@ -103,9 +103,9 @@ const GENERATED_SUBPATHS = new Set(['./routes', './server-fns', './api-routes'])
  * only honours an *exact* id in `ssr.external`. A bare package name falls through to a
  * resolvability probe that does not externalize deep imports here, and the result is the
  * worst of both worlds: `@fluixi/core` an import, `@fluixi/core/router` copied into
- * the bundle — two routers, two sets of module state, in one server.
+ * the bundle: two routers, two sets of module state, in one server.
  *
- * `ssrNoExternal` always wins — it is the app saying "this one must be bundled".
+ * `ssrNoExternal` always wins: it is the app saying "this one must be bundled".
  */
 export function ssrBuildOptions(cfg) {
     const noExternal = cfg.ssrNoExternal.length ? cfg.ssrNoExternal : undefined;
@@ -121,7 +121,7 @@ export function ssrBuildOptions(cfg) {
         // Silently building an inlined bundle here would look identical to a working one
         // until someone measures it, so say why nothing was externalized.
         console.warn(`  fluixi: adapter "${cfg.adapter?.name}" builds an externalized server, but no ` +
-            `fluixi or @fluixi/* dependency was found in ${join(cfg.root, 'package.json')} — bundling everything.`);
+            `fluixi or @fluixi/* dependency was found in ${join(cfg.root, 'package.json')}, bundling everything.`);
     }
     return { noExternal, external: external.length ? external : undefined };
 }
@@ -136,7 +136,7 @@ function frameworkDeps(root) {
     return Object.keys(declared).filter((id) => id === '@fluixi/core' || id.startsWith('@fluixi/'));
 }
 /**
- * `['@fluixi/core', '@fluixi/core/router', …]` — the package plus every static subpath it
+ * `['@fluixi/core', '@fluixi/core/router', …]`: the package plus every static subpath it
  * exports. Wildcard entries (`./lib/*`) cannot be enumerated and are left to Vite; an
  * app importing through one gets it bundled, which is the safe direction.
  */
@@ -164,7 +164,7 @@ function resolvePackage(root, name) {
         return readPackage(createRequire(join(root, 'index.js')).resolve(`${name}/package.json`));
     }
     catch {
-        /* not exported — fall through */
+        /* not exported: fall through */
     }
     for (let dir = root;; dir = dirname(dir)) {
         const pkg = readPackage(join(dir, 'node_modules', name, 'package.json'));