@fluixi/compiler 1.0.0-alpha.84 → 1.0.0-alpha.85

package/dist/integrations.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/compiler v1.0.0-alpha.84 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/compiler v1.0.0-alpha.85 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -157,7 +157,7 @@ var init_intrinsics = __esm({
       $store: { export: "store", module: "@fluixi/reactive/store", returns: "store-handle" },
       $resource: { export: "resource", module: REACTIVE_MODULE, returns: "resource-handle" },
       // No short runtime form for these yet, so the intrinsic stands for the `create*`
-      // name. Still worth having — no import to write — and when a shorter form is
+      // name. Still worth having: no import to write, and when a shorter form is
       // designed, the change is this line rather than a compiler pass.
       $selector: { export: "createSelector", module: REACTIVE_MODULE, returns: "memo-accessor" },
       $deferred: { export: "createDeferred", module: REACTIVE_MODULE, returns: "memo-accessor" },
@@ -1596,7 +1596,7 @@ var init_template = __esm({
           }
         ];
       }
-      /** A plain attribute (incl. lit `?bool`, mixed values) — old `mkProp` behavior. */
+      /** A plain attribute (incl. lit `?bool`, mixed values), old `mkProp` behavior. */
       plainAttr(a) {
         const v = a.value;
         let name = a.name;
@@ -2102,7 +2102,7 @@ function buildIR(node, used = /* @__PURE__ */ new Set(), onNested) {
   const ir = buildJsxIR(node, {
     code: (n) => (
       // A member-expression tag (`<ns.Foo/>`) is not an Expression, so it cannot go
-      // through the nested-JSX compile — it only ever needs printing.
+      // through the nested-JSX compile: it only ever needs printing.
       n.type === "JSXMemberExpression" ? gen2(n) : genExpr(n, used, onNested)
     ),
     used
@@ -2556,7 +2556,7 @@ var init_plugin = __esm({
                           import_core3.types.identifier(name),
                           // Just the HTML. Parsing is deferred to `templateNode`, which
                           // knows whether this is a server render, a hydration or a fresh
-                          // client render — a module-scope `createTemplate` would touch
+                          // client render: a module-scope `createTemplate` would touch
                           // `document` at import time and break SSR outright.
                           import_core3.types.stringLiteral(html)
                         )
@@ -3872,7 +3872,7 @@ function componentGlobals(rules, options = {}) {
     return target.export === "default" ? `  const ${name}: typeof ${ns}.default;` : `  export import ${name} = ${ns}.${target.export};`;
   });
   const note = shadowedByDom.length > 0 ? `//
-// Import these explicitly — lib.dom already declares the name, so an ambient
+// Import these explicitly: lib.dom already declares the name, so an ambient
 // declaration cannot win:
 ` + shadowedByDom.map((n) => {
     const module2 = resolver.resolve(n)?.module;
@@ -3888,7 +3888,7 @@ function componentGlobals(rules, options = {}) {
 // a pattern matches unboundedly many names, so there is no list to emit. Those
 // tags still resolve at build time; declare them by hand if the editor needs them.
 ` : "";
-  const source = `// GENERATED by ${generator} — do not edit.
+  const source = `// GENERATED by ${generator}, do not edit.
 //
 // The components \`resolve\` supplies without an import. This describes what the
 // compiler already does; it does not enable it.
@@ -4252,6 +4252,10 @@ function createESBuildPlugin(options = {}) {
   };
 }
 var SERVER_FNS_VMOD = "virtual:fluixi-server-fns";
+function hasServerDirective(source) {
+  const withoutComments = source.replace(/\/\*[\s\S]*?\*\//g, " ").replace(/(^|[^:])\/\/[^\n]*/g, "$1");
+  return /(^|[\s;{(,])['"]use server['"]/.test(withoutComments);
+}
 function findServerFnModules(dir, out = []) {
   let entries;
   try {
@@ -4265,7 +4269,7 @@ function findServerFnModules(dir, out = []) {
     if (e.isDirectory()) findServerFnModules(full, out);
     else if (/\.[jt]sx?$/.test(e.name)) {
       try {
-        if ((0, import_node_fs2.readFileSync)(full, "utf8").includes("use server")) out.push(full);
+        if (hasServerDirective((0, import_node_fs2.readFileSync)(full, "utf8"))) out.push(full);
       } catch {
       }
     }

package/dist/integrations.d.cts

@@ -3,7 +3,7 @@
  * @module @fluixi/compiler/integrations
  *
  * vite, webpack, rollup and esbuild adapters. Each is a few lines around
- * `compileModule`, which rewrites the source in place — JSX and `` html`` `` both
+ * `compileModule`, which rewrites the source in place, JSX and `` html`` `` both
  * lower to the shared IR and the imperative backend. fluixi re-exports
  * createVitePlugin from here.
  *
@@ -24,7 +24,7 @@ export interface CompilerOptions {
      *
      * Relative to the project root; `false` turns generation off. Without this file every
      * resolved tag is a `Cannot find name` error in the editor and in `tsc`, because the
-     * import only exists after compilation. Committing it is intended — it is what makes a
+     * import only exists after compilation. Committing it is intended, it is what makes a
      * fresh clone type-check before anyone runs the dev server.
      *
      * It must be covered by `include` in tsconfig.json, which for the default means adding
@@ -56,7 +56,7 @@ export interface CompilerOptions {
     development?: boolean;
     /**
      * Where the JSX *types* come from, and the `jsxImportSource` handed to esbuild
-     * and TypeScript. The compiler never emits `jsx()` calls itself — this is for
+     * and TypeScript. The compiler never emits `jsx()` calls itself, this is for
      * type resolution and for any JSX the Fluixi transform does not consume.
      * @default '@fluixi/jsx'
      */
@@ -69,13 +69,13 @@ export interface CompilerOptions {
     format?: 'jsx' | 'lit' | 'both';
     /**
      * Record where each reactive node is created, and serve the running app's graph to a tool
-     * that asks for it. Development only — a build never carries either.
+     * that asks for it. Development only: a build never carries either.
      *
      * On by default when the dev server is running and @fluixi/devtools is installed. The
      * marks are what turn `m5` into `double @ src/app.tsx:6`, and the endpoint is what an
      * editor or a graph panel reads.
      *
-     * `{ external: true }` marks dependencies too — node_modules and anything outside the
+     * `{ external: true }` marks dependencies too: node_modules and anything outside the
      * project. That is for working on the framework itself: the graph then shows which nodes
      * a library created and which the application did, at the cost of a mark per node in code
      * you are not editing.
@@ -89,7 +89,7 @@ export interface CompilerOptions {
      * The default path parses once and splices the emitted code over the spans it
      * replaces: nothing is reprinted, edits carry a source map, and types are left
      * for esbuild to strip. Babel is kept for the cases that need to sit inside its
-     * pipeline — a `babel.config.js` with other plugins that have to see the
+     * pipeline: a `babel.config.js` with other plugins that have to see the
      * output. It needs `@babel/core` and friends installed; they are optional peers.
      * @default false
      */
@@ -102,11 +102,11 @@ export interface CompilerOptions {
     /**
      * Rewrite a component's destructured props into property reads, so
      * `function Card({ title })` keeps updating instead of reading `title` once.
-     * Applies to JSX and html`` alike — it rewrites the function body before either is
+     * Applies to JSX and html`` alike: it rewrites the function body before either is
      * compiled. A pattern it can't prove is left as written, so `splitProps` keeps
      * working wherever it's still needed.
      *
-     * Turn it off for a package that ships its source to be compiled by the consumer —
+     * Turn it off for a package that ships its source to be compiled by the consumer ,
      * rewriting there would bake property reads into what you publish.
      *
      * @default true
@@ -195,7 +195,7 @@ export type { ServerFnTransformOptions } from './frontend/babel/server-functions
 import type { ComponentResolverRule } from './resolve/component-resolver.cjs';
 /**
  * Vite plugin for `"use server"`: applies the transform (client→RPC stub, server→register
- * the body), and provides `virtual:fluixi-server-fns` — side-effect imports of every
+ * the body), and provides `virtual:fluixi-server-fns`, side-effect imports of every
  * module that defines a server function. The server entry imports it so ALL server
  * functions register at startup (including those in lazy routes, which would otherwise
  * register only when their chunk loads → an RPC registry miss). The client never imports

package/dist/integrations.d.ts

@@ -3,7 +3,7 @@
  * @module @fluixi/compiler/integrations
  *
  * vite, webpack, rollup and esbuild adapters. Each is a few lines around
- * `compileModule`, which rewrites the source in place — JSX and `` html`` `` both
+ * `compileModule`, which rewrites the source in place, JSX and `` html`` `` both
  * lower to the shared IR and the imperative backend. fluixi re-exports
  * createVitePlugin from here.
  *
@@ -24,7 +24,7 @@ export interface CompilerOptions {
      *
      * Relative to the project root; `false` turns generation off. Without this file every
      * resolved tag is a `Cannot find name` error in the editor and in `tsc`, because the
-     * import only exists after compilation. Committing it is intended — it is what makes a
+     * import only exists after compilation. Committing it is intended, it is what makes a
      * fresh clone type-check before anyone runs the dev server.
      *
      * It must be covered by `include` in tsconfig.json, which for the default means adding
@@ -56,7 +56,7 @@ export interface CompilerOptions {
     development?: boolean;
     /**
      * Where the JSX *types* come from, and the `jsxImportSource` handed to esbuild
-     * and TypeScript. The compiler never emits `jsx()` calls itself — this is for
+     * and TypeScript. The compiler never emits `jsx()` calls itself, this is for
      * type resolution and for any JSX the Fluixi transform does not consume.
      * @default '@fluixi/jsx'
      */
@@ -69,13 +69,13 @@ export interface CompilerOptions {
     format?: 'jsx' | 'lit' | 'both';
     /**
      * Record where each reactive node is created, and serve the running app's graph to a tool
-     * that asks for it. Development only — a build never carries either.
+     * that asks for it. Development only: a build never carries either.
      *
      * On by default when the dev server is running and @fluixi/devtools is installed. The
      * marks are what turn `m5` into `double @ src/app.tsx:6`, and the endpoint is what an
      * editor or a graph panel reads.
      *
-     * `{ external: true }` marks dependencies too — node_modules and anything outside the
+     * `{ external: true }` marks dependencies too: node_modules and anything outside the
      * project. That is for working on the framework itself: the graph then shows which nodes
      * a library created and which the application did, at the cost of a mark per node in code
      * you are not editing.
@@ -89,7 +89,7 @@ export interface CompilerOptions {
      * The default path parses once and splices the emitted code over the spans it
      * replaces: nothing is reprinted, edits carry a source map, and types are left
      * for esbuild to strip. Babel is kept for the cases that need to sit inside its
-     * pipeline — a `babel.config.js` with other plugins that have to see the
+     * pipeline: a `babel.config.js` with other plugins that have to see the
      * output. It needs `@babel/core` and friends installed; they are optional peers.
      * @default false
      */
@@ -102,11 +102,11 @@ export interface CompilerOptions {
     /**
      * Rewrite a component's destructured props into property reads, so
      * `function Card({ title })` keeps updating instead of reading `title` once.
-     * Applies to JSX and html`` alike — it rewrites the function body before either is
+     * Applies to JSX and html`` alike: it rewrites the function body before either is
      * compiled. A pattern it can't prove is left as written, so `splitProps` keeps
      * working wherever it's still needed.
      *
-     * Turn it off for a package that ships its source to be compiled by the consumer —
+     * Turn it off for a package that ships its source to be compiled by the consumer ,
      * rewriting there would bake property reads into what you publish.
      *
      * @default true
@@ -195,7 +195,7 @@ export type { ServerFnTransformOptions } from './frontend/babel/server-functions
 import type { ComponentResolverRule } from './resolve/component-resolver.js';
 /**
  * Vite plugin for `"use server"`: applies the transform (client→RPC stub, server→register
- * the body), and provides `virtual:fluixi-server-fns` — side-effect imports of every
+ * the body), and provides `virtual:fluixi-server-fns`, side-effect imports of every
  * module that defines a server function. The server entry imports it so ALL server
  * functions register at startup (including those in lazy routes, which would otherwise
  * register only when their chunk loads → an RPC registry miss). The client never imports

package/dist/integrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../src/integrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3C;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACzB,6FAA6F;IAC7F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAEhC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAE5C;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,eAAoB;;;;;;;;;;;;;;;;;GAwCpE;AAMD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,eAAoB,aAIpD,GAAG,MAAM,YAAY,GAAG,SAkB5C;AAqCD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,CAAC,CAsHpE;AAoID;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,eAAoB,IACxC,MAAM,GAAG,EAAE,QAAQ,MAAM,mBAUjD;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,eAAoB;;oBAItC,MAAM,MAAM,MAAM;;;;;;;;;;;;EAK3C;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,eAAoB;;iBAIhD,GAAG;EAwBnB;AAWD,YAAY,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AA8B7E;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,CAAC,CAqCvF;;;;;;;;;AAED,wBAOE"}
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../src/integrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3C;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACzB,6FAA6F;IAC7F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAEhC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAE5C;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,eAAoB;;;;;;;;;;;;;;;;;GAwCpE;AAMD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,eAAoB,aAIpD,GAAG,MAAM,YAAY,GAAG,SAkB5C;AAqCD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,CAAC,CAsHpE;AAoID;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,eAAoB,IACxC,MAAM,GAAG,EAAE,QAAQ,MAAM,mBAUjD;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,eAAoB;;oBAItC,MAAM,MAAM,MAAM;;;;;;;;;;;;EAK3C;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,eAAoB;;iBAIhD,GAAG;EAwBnB;AAWD,YAAY,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAoD7E;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,CAAC,CAqCvF;;;;;;;;;AAED,wBAOE"}

package/dist/integrations.js

@@ -3,7 +3,7 @@
  * @module @fluixi/compiler/integrations
  *
  * vite, webpack, rollup and esbuild adapters. Each is a few lines around
- * `compileModule`, which rewrites the source in place — JSX and `` html`` `` both
+ * `compileModule`, which rewrites the source in place, JSX and `` html`` `` both
  * lower to the shared IR and the imperative backend. fluixi re-exports
  * createVitePlugin from here.
  *
@@ -161,7 +161,7 @@ export function createVitePlugin(options = {}) {
                 if (!babel) {
                     // No silent fallback. This front-end compiles through babel; without it
                     // there is no transform, and emitting the source unchanged would ship a
-                    // build whose JSX and html`` templates were never compiled — a failure
+                    // build whose JSX and html`` templates were never compiled, a failure
                     // that looks exactly like success until the page is opened.
                     throw new Error(`[fluixi] @babel/core is required to compile ${id} but could not be loaded. ` +
                         `Install it alongside @fluixi/compiler.`);
@@ -189,7 +189,7 @@ export function createVitePlugin(options = {}) {
                         ]);
                     }
                 }
-                // Only our custom babel plugin handles JSX — never @babel/preset-react, which
+                // Only our custom babel plugin handles JSX, never @babel/preset-react, which
                 // rewrites spreads with Object.assign and breaks store-proxy reactivity.
                 if (babelPlugin && babelPlugin.plugin) {
                     plugins.push([babelPlugin.plugin, babelPlugin.getOptions()]);
@@ -285,7 +285,7 @@ const reported = new Set();
  * All of these build cleanly and fail at runtime, which is why they are worth printing: an
  * unresolved tag renders nothing, a `load:` it cannot act on ships the chunk eagerly, and a
  * props pattern the rewrite refused reads its value once instead of tracking it. None leaves
- * a trace anywhere else — the last one is a stale value on screen and nothing in the build.
+ * a trace anywhere else: the last one is a stale value on screen and nothing in the build.
  *
  * `console.warn`, deliberately, not a plugin's `this.warn`: that only exists in the
  * rollup/vite context, and this runs for the esbuild and webpack adapters too. A
@@ -407,6 +407,27 @@ import { readdirSync, readFileSync } from 'node:fs';
 import { join as _join } from 'node:path';
 const SERVER_FNS_VMOD = 'virtual:fluixi-server-fns';
 /** Recursively find source files containing the `"use server"` directive under `dir`. */
+/**
+ * Whether a file actually carries a `"use server"` directive.
+ *
+ * Every module this matches is side-effect imported into the server bundle, so a false
+ * positive does more than waste a line: it runs that file on the server. A plain
+ * `includes('use server')` matched the words wherever they appeared, and a client entry
+ * that merely *mentioned* the directive in a comment was imported into the SSR graph and
+ * called `startClient` there, which fails with `document is not defined` from a line
+ * nobody wrote.
+ *
+ * Comments are stripped before the test rather than parsed around, because the answer
+ * only has to be good enough to decide whether the real transform should look at the
+ * file. A directive inside a string literal still matches, which costs an extra import
+ * and nothing else.
+ */
+function hasServerDirective(source) {
+    const withoutComments = source
+        .replace(/\/\*[\s\S]*?\*\//g, ' ')
+        .replace(/(^|[^:])\/\/[^\n]*/g, '$1');
+    return /(^|[\s;{(,])['"]use server['"]/.test(withoutComments);
+}
 function findServerFnModules(dir, out = []) {
     let entries;
     try {
@@ -423,11 +444,11 @@ function findServerFnModules(dir, out = []) {
             findServerFnModules(full, out);
         else if (/\.[jt]sx?$/.test(e.name)) {
             try {
-                if (readFileSync(full, 'utf8').includes('use server'))
+                if (hasServerDirective(readFileSync(full, 'utf8')))
                     out.push(full);
             }
             catch {
-                /* unreadable — skip */
+                /* unreadable: skip */
             }
         }
     }
@@ -435,7 +456,7 @@ function findServerFnModules(dir, out = []) {
 }
 /**
  * Vite plugin for `"use server"`: applies the transform (client→RPC stub, server→register
- * the body), and provides `virtual:fluixi-server-fns` — side-effect imports of every
+ * the body), and provides `virtual:fluixi-server-fns`, side-effect imports of every
  * module that defines a server function. The server entry imports it so ALL server
  * functions register at startup (including those in lazy routes, which would otherwise
  * register only when their chunk loads → an RPC registry miss). The client never imports
@@ -461,7 +482,7 @@ export function serverFunctionsVitePlugin(options = {}) {
             // First wire the request-context bridge (server-only), then side-effect import each
             // server-fn module so its top-level $$registerServerFn(...) runs, then re-export the
             // dispatcher so the host can route /_server through THIS module graph (sharing the
-            // registry the imports populated) — apps don't need to re-export it from entry-server.
+            // registry the imports populated), apps don't need to re-export it from entry-server.
             const setup = `import '@fluixi/start/server-fn-setup';\n`;
             const imports = mods.map((m) => `import ${JSON.stringify(m)};`).join('\n');
             const dispatcher = `\nexport { isServerFnRequest, handleServerFn } from '@fluixi/start/server-fn';\n`;

package/dist/integrations.mjs

@@ -1,12 +1,12 @@
-/*! @fluixi/compiler v1.0.0-alpha.84 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/compiler v1.0.0-alpha.85 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 import {
   INTRINSICS,
   builtinComponentMap,
   createComponentResolver
-} from "./chunk-MJV3UXIL.mjs";
+} from "./chunk-4PLHS2FP.mjs";
 import {
   __require
-} from "./chunk-3YKZ4GNH.mjs";
+} from "./chunk-G6QC2WRJ.mjs";
 
 // src/resolve/write-globals.ts
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
@@ -86,7 +86,7 @@ function componentGlobals(rules, options = {}) {
     return target.export === "default" ? `  const ${name}: typeof ${ns}.default;` : `  export import ${name} = ${ns}.${target.export};`;
   });
   const note = shadowedByDom.length > 0 ? `//
-// Import these explicitly — lib.dom already declares the name, so an ambient
+// Import these explicitly: lib.dom already declares the name, so an ambient
 // declaration cannot win:
 ` + shadowedByDom.map((n) => {
     const module = resolver.resolve(n)?.module;
@@ -102,7 +102,7 @@ function componentGlobals(rules, options = {}) {
 // a pattern matches unboundedly many names, so there is no list to emit. Those
 // tags still resolve at build time; declare them by hand if the editor needs them.
 ` : "";
-  const source = `// GENERATED by ${generator} — do not edit.
+  const source = `// GENERATED by ${generator}, do not edit.
 //
 // The components \`resolve\` supplies without an import. This describes what the
 // compiler already does; it does not enable it.
@@ -204,7 +204,7 @@ import { join as _join } from "node:path";
 async function createBabelPlugin(options = {}) {
   let pluginModule = null;
   try {
-    pluginModule = await import("./babel-NRW4EFTG.mjs");
+    pluginModule = await import("./babel-TGY76XJ7.mjs");
   } catch (e) {
     console.warn("Could not load the babel front-end:", e);
   }
@@ -375,7 +375,7 @@ function transformOptions(options, id) {
 }
 async function rewriteProps(code, id, options) {
   if (options.propsDestructure === false) return code;
-  const { transformProps } = await import("./transform-BT4MMASR.mjs");
+  const { transformProps } = await import("./transform-RWDTQUF5.mjs");
   const result = transformProps(code, id);
   reportDiagnostics({ propsDiagnostics: result.diagnostics }, id);
   return result.rewritten > 0 ? result.code : code;
@@ -398,7 +398,7 @@ function reportDiagnostics(result, id) {
 }
 async function compileModule(code, id, options) {
   if (!options.babel) {
-    const { transformTemplates } = await import("./transform-BT4MMASR.mjs");
+    const { transformTemplates } = await import("./transform-RWDTQUF5.mjs");
     const result2 = transformTemplates(code, id, transformOptions(options, id));
     reportDiagnostics(result2, id);
     return result2;
@@ -466,6 +466,10 @@ function createESBuildPlugin(options = {}) {
   };
 }
 var SERVER_FNS_VMOD = "virtual:fluixi-server-fns";
+function hasServerDirective(source) {
+  const withoutComments = source.replace(/\/\*[\s\S]*?\*\//g, " ").replace(/(^|[^:])\/\/[^\n]*/g, "$1");
+  return /(^|[\s;{(,])['"]use server['"]/.test(withoutComments);
+}
 function findServerFnModules(dir, out = []) {
   let entries;
   try {
@@ -479,7 +483,7 @@ function findServerFnModules(dir, out = []) {
     if (e.isDirectory()) findServerFnModules(full, out);
     else if (/\.[jt]sx?$/.test(e.name)) {
       try {
-        if (readFileSync2(full, "utf8").includes("use server")) out.push(full);
+        if (hasServerDirective(readFileSync2(full, "utf8"))) out.push(full);
       } catch {
       }
     }
@@ -513,10 +517,10 @@ export { isServerFnRequest, handleServerFn } from '@fluixi/start/server-fn';
       if (!code.includes("use server")) return null;
       const args = { ssr: !!opts?.ssr, filename: id, root };
       if (options.babel) {
-        const { transformServerFunctions } = await import("./server-functions-V6D6DRIA.mjs");
+        const { transformServerFunctions } = await import("./server-functions-PCERFA7A.mjs");
         return transformServerFunctions(code, args);
       }
-      const { transformServerFns } = await import("./server-fns-4ZXN6DYU.mjs");
+      const { transformServerFns } = await import("./server-fns-ZYWQTSZU.mjs");
       return transformServerFns(code, args);
     }
   };

package/dist/ir/nodes.d.cts

@@ -1,7 +1,7 @@
 /**
  * Normalized, host-agnostic IR. Both the babel and (future) swc front-ends
  * produce this; codegen backends consume it. This is the stable contract
- * between parsing and code generation — the layer your own improvements
+ * between parsing and code generation: the layer your own improvements
  * (hoisting, islands, resumability hints) transform.
  */
 import type { IRLoadStrategy } from '../resolve/load-directive.cjs';
@@ -43,7 +43,7 @@ export interface IRProp {
     directive?: string;
     /**
      * `expr` is an inline JSX element/fragment passed as a component prop (e.g.
-     * `<Suspense fallback={<div/>}>`). Emitted as a LAZY getter — like children — so the DOM is
+     * `<Suspense fallback={<div/>}>`). Emitted as a LAZY getter, like children, so the DOM is
      * built only when the component reads the prop, not eagerly when the props object is
      * constructed (which during hydration would walk the cursor and duplicate the tree).
      */
@@ -77,7 +77,7 @@ export interface IRElement {
 /**
  * Where a component reference comes from, attached to the reference itself.
  *
- * A capitalised tag with no binding in the file is supplied by the compiler — from a
+ * A capitalised tag with no binding in the file is supplied by the compiler, from a
  * `resolve` rule, or from the built-in control-flow/router sets. That decision used to
  * live only in the Babel plugin's state, which meant the IR could not see which
  * components a template referenced: no pass could vary a decision per usage, group
@@ -96,7 +96,7 @@ export interface IRComponentSource {
     origin: 'rule' | 'builtin';
     /**
      * When the module is fetched. Set from a `load:` directive at the usage site, and
-     * `eager` otherwise — resolution decides where a component comes from, this decides
+     * `eager` otherwise: resolution decides where a component comes from, this decides
      * when, and the two vary independently.
      */
     loading: IRLoadStrategy;
@@ -110,7 +110,7 @@ export interface IRComponent {
     children: IRNode[];
     /**
      * Set by the resolve pass when the compiler supplies this reference. Absent when the
-     * name is bound in the file — an ordinary import the author wrote — or when nothing
+     * name is bound in the file: an ordinary import the author wrote, or when nothing
      * claims it, which is a diagnostic rather than a resolution.
      */
     source?: IRComponentSource;
@@ -124,7 +124,7 @@ export interface IRComponent {
         column: number;
     };
     /**
-     * Where the `${…}` that drives this subtree was written — the condition of an `if=`,
+     * Where the `${…}` that drives this subtree was written, the condition of an `if=`,
      * the list of an `each=`. The insert that adds and removes the subtree is a reactive
      * binding, and this is the position it reports. Distinct from `at`, which marks the
      * node itself rather than the binding that places it.

package/dist/ir/nodes.d.ts

@@ -1,7 +1,7 @@
 /**
  * Normalized, host-agnostic IR. Both the babel and (future) swc front-ends
  * produce this; codegen backends consume it. This is the stable contract
- * between parsing and code generation — the layer your own improvements
+ * between parsing and code generation: the layer your own improvements
  * (hoisting, islands, resumability hints) transform.
  */
 import type { IRLoadStrategy } from '../resolve/load-directive.js';
@@ -43,7 +43,7 @@ export interface IRProp {
     directive?: string;
     /**
      * `expr` is an inline JSX element/fragment passed as a component prop (e.g.
-     * `<Suspense fallback={<div/>}>`). Emitted as a LAZY getter — like children — so the DOM is
+     * `<Suspense fallback={<div/>}>`). Emitted as a LAZY getter, like children, so the DOM is
      * built only when the component reads the prop, not eagerly when the props object is
      * constructed (which during hydration would walk the cursor and duplicate the tree).
      */
@@ -77,7 +77,7 @@ export interface IRElement {
 /**
  * Where a component reference comes from, attached to the reference itself.
  *
- * A capitalised tag with no binding in the file is supplied by the compiler — from a
+ * A capitalised tag with no binding in the file is supplied by the compiler, from a
  * `resolve` rule, or from the built-in control-flow/router sets. That decision used to
  * live only in the Babel plugin's state, which meant the IR could not see which
  * components a template referenced: no pass could vary a decision per usage, group
@@ -96,7 +96,7 @@ export interface IRComponentSource {
     origin: 'rule' | 'builtin';
     /**
      * When the module is fetched. Set from a `load:` directive at the usage site, and
-     * `eager` otherwise — resolution decides where a component comes from, this decides
+     * `eager` otherwise: resolution decides where a component comes from, this decides
      * when, and the two vary independently.
      */
     loading: IRLoadStrategy;
@@ -110,7 +110,7 @@ export interface IRComponent {
     children: IRNode[];
     /**
      * Set by the resolve pass when the compiler supplies this reference. Absent when the
-     * name is bound in the file — an ordinary import the author wrote — or when nothing
+     * name is bound in the file: an ordinary import the author wrote, or when nothing
      * claims it, which is a diagnostic rather than a resolution.
      */
     source?: IRComponentSource;
@@ -124,7 +124,7 @@ export interface IRComponent {
         column: number;
     };
     /**
-     * Where the `${…}` that drives this subtree was written — the condition of an `if=`,
+     * Where the `${…}` that drives this subtree was written, the condition of an `if=`,
      * the list of an `each=`. The insert that adds and removes the subtree is a reactive
      * binding, and this is the position it reports. Distinct from `at`, which marks the
      * node itself rather than the binding that places it.

package/dist/lower/compile-template.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/compiler v1.0.0-alpha.84 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/compiler v1.0.0-alpha.85 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -469,7 +469,7 @@ var INTRINSICS = {
   $store: { export: "store", module: "@fluixi/reactive/store", returns: "store-handle" },
   $resource: { export: "resource", module: REACTIVE_MODULE, returns: "resource-handle" },
   // No short runtime form for these yet, so the intrinsic stands for the `create*`
-  // name. Still worth having — no import to write — and when a shorter form is
+  // name. Still worth having: no import to write, and when a shorter form is
   // designed, the change is this line rather than a compiler pass.
   $selector: { export: "createSelector", module: REACTIVE_MODULE, returns: "memo-accessor" },
   $deferred: { export: "createDeferred", module: REACTIVE_MODULE, returns: "memo-accessor" },
@@ -1259,7 +1259,7 @@ var Lowerer = class {
       }
     ];
   }
-  /** A plain attribute (incl. lit `?bool`, mixed values) — old `mkProp` behavior. */
+  /** A plain attribute (incl. lit `?bool`, mixed values), old `mkProp` behavior. */
   plainAttr(a) {
     const v = a.value;
     let name = a.name;

package/dist/lower/compile-template.d.cts

@@ -6,7 +6,7 @@ import type { Piece } from '@fluixi/template-parser';
 import type { StaticTemplate } from '../codegen/backend.cjs';
 export interface TemplateSource {
     /**
-     * The static text runs, in order. Always one more than `holes` — the text
+     * The static text runs, in order. Always one more than `holes`, the text
      * before the first `${`, between each pair, and after the last `}`.
      */
     statics: readonly string[];
@@ -37,7 +37,7 @@ export interface CompileTemplateOptions {
      * The author's file, and a way to turn the parser's offsets into positions in it.
      *
      * Only when the host asked for source locations. Together they let a tag written inside a
-     * template carry the same mark a JSX tag does — without it the nodes it makes are the only
+     * template carry the same mark a JSX tag does: without it the nodes it makes are the only
      * ones in a component with no mark of their own, and they take whichever one was left.
      */
     sourceFile?: string;
@@ -55,7 +55,7 @@ export interface CompileTemplateResult {
     ir: IRNode;
     /**
      * Static templates the code refers to by local `_tmpl$N` id, when the caller
-     * asked to hoist them. `compileTemplate` inlines them instead — it has no module
+     * asked to hoist them. `compileTemplate` inlines them instead, it has no module
      * scope to hoist into.
      */
     templates?: StaticTemplate[];

package/dist/lower/compile-template.d.ts

@@ -6,7 +6,7 @@ import type { Piece } from '@fluixi/template-parser';
 import type { StaticTemplate } from '../codegen/backend.js';
 export interface TemplateSource {
     /**
-     * The static text runs, in order. Always one more than `holes` — the text
+     * The static text runs, in order. Always one more than `holes`, the text
      * before the first `${`, between each pair, and after the last `}`.
      */
     statics: readonly string[];
@@ -37,7 +37,7 @@ export interface CompileTemplateOptions {
      * The author's file, and a way to turn the parser's offsets into positions in it.
      *
      * Only when the host asked for source locations. Together they let a tag written inside a
-     * template carry the same mark a JSX tag does — without it the nodes it makes are the only
+     * template carry the same mark a JSX tag does: without it the nodes it makes are the only
      * ones in a component with no mark of their own, and they take whichever one was left.
      */
     sourceFile?: string;
@@ -55,7 +55,7 @@ export interface CompileTemplateResult {
     ir: IRNode;
     /**
      * Static templates the code refers to by local `_tmpl$N` id, when the caller
-     * asked to hoist them. `compileTemplate` inlines them instead — it has no module
+     * asked to hoist them. `compileTemplate` inlines them instead, it has no module
      * scope to hoist into.
      */
     templates?: StaticTemplate[];

package/dist/lower/compile-template.js

@@ -6,7 +6,7 @@
  *
  * Finding templates in a module and describing each hole still needs a front-end;
  * everything after that point is here. Passes run in the same order as
- * `emitLitViaIR` — compile-template.spec.ts compares the two.
+ * `emitLitViaIR`: compile-template.spec.ts compares the two.
  */
 import { analyzeStatic } from '../optimize/analyze-static.js';
 import { collapseStrategies } from '../optimize/collapse-strategies.js';

package/dist/lower/compile-template.mjs

@@ -1,4 +1,4 @@
-/*! @fluixi/compiler v1.0.0-alpha.84 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/compiler v1.0.0-alpha.85 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/optimize/analyze-static.ts
 function propReason(prop) {
@@ -443,7 +443,7 @@ var INTRINSICS = {
   $store: { export: "store", module: "@fluixi/reactive/store", returns: "store-handle" },
   $resource: { export: "resource", module: REACTIVE_MODULE, returns: "resource-handle" },
   // No short runtime form for these yet, so the intrinsic stands for the `create*`
-  // name. Still worth having — no import to write — and when a shorter form is
+  // name. Still worth having: no import to write, and when a shorter form is
   // designed, the change is this line rather than a compiler pass.
   $selector: { export: "createSelector", module: REACTIVE_MODULE, returns: "memo-accessor" },
   $deferred: { export: "createDeferred", module: REACTIVE_MODULE, returns: "memo-accessor" },
@@ -1235,7 +1235,7 @@ var Lowerer = class {
       }
     ];
   }
-  /** A plain attribute (incl. lit `?bool`, mixed values) — old `mkProp` behavior. */
+  /** A plain attribute (incl. lit `?bool`, mixed values), old `mkProp` behavior. */
   plainAttr(a) {
     const v = a.value;
     let name = a.name;