@fluixi/compiler 1.0.0-alpha.100 → 1.0.0-alpha.102

package/dist/index.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/compiler v1.0.0-alpha.100 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/compiler v1.0.0-alpha.102 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -1007,7 +1007,7 @@ var Lowerer = class {
     for (const s of imports) this.used.add(s);
     return inlineTemplates(code, templates);
   }
-  // --- content ------------------------------------------------------------
+  // content
   lowerRoot(children) {
     const nodes = this.lowerChildren(children);
     if (nodes.length === 1) return nodes[0];
@@ -1136,8 +1136,8 @@ var Lowerer = class {
     }
     return { slots, rest };
   }
-  // --- control-flow sugar -------------------------------------------------
-  /** `<el if=${cond}>…</el>` (+ optional `<el else>`) → `<Show when fallback>`. */
+  // control-flow sugar
+  /** `<el if=${cond}>...</el>` (+ optional `<el else>`) → `<Show when fallback>`. */
   lowerIf(el, condHole, elseEl) {
     const cond = this.hole(condHole);
     const props = [
@@ -1152,8 +1152,8 @@ var Lowerer = class {
     return { kind: "component", name: "Show", props, children: [child], ...at ? { at } : {}, ...cond.at ? { bindAt: cond.at } : {} };
   }
   /**
-   * `<el each=${items} key?>${item => …}</el>` → `<el><For each>{item => …}</For></el>`: the
-   * content is repeated per item. Content that is not a `${item => …}` arrow is repeated as
+   * `<el each=${items} key?>${item => ...}</el>` → `<el><For each>{item => ...}</For></el>`: the
+   * content is repeated per item. Content that is not a `${item => ...}` arrow is repeated as
    * it is. Null when the element has no `each`.
    */
   lowerEach(el) {
@@ -1190,7 +1190,7 @@ var Lowerer = class {
     const clone = { ...el, attributes: el.attributes.filter((a) => !drop(a)) };
     return clone.kind === "Element" ? this.lowerElement(clone) : this.lowerComponent(clone);
   }
-  // --- attributes ---------------------------------------------------------
+  // attributes
   /**
    * `element`: a DOM element, where each class:/style: value that moves is its own accessor.
    * A component gets the object as before, rebuilt whole when any value moves.
@@ -1331,7 +1331,7 @@ var Lowerer = class {
     if (mods.includes("passive")) opts.push("passive: true");
     return opts.length ? `{ ${opts.join(", ")} }` : null;
   }
-  /** `bind:value=${sig}` → `value={read()}` + `onInput={e => write(e…value)}`. */
+  /** `bind:value=${sig}` → `value={read()}` + `onInput={e => write(e...value)}`. */
   bindProps(prop, h) {
     const sigCode = h.code;
     const checked = prop === "checked";
@@ -1357,7 +1357,7 @@ var Lowerer = class {
       }
     ];
   }
-  /** A plain attribute (incl. lit `?bool`, mixed values), old `mkProp` behavior. */
+  /** A plain attribute (incl. html `?bool`, mixed values), old `mkProp` behavior. */
   plainAttr(a) {
     const v = a.value;
     let name = a.name;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-/*! @fluixi/compiler v1.0.0-alpha.100 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/compiler v1.0.0-alpha.102 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/analyze/reactive-expr.ts
 var STABLE_MEMBER = "children";
@@ -960,7 +960,7 @@ var Lowerer = class {
     for (const s of imports) this.used.add(s);
     return inlineTemplates(code, templates);
   }
-  // --- content ------------------------------------------------------------
+  // content
   lowerRoot(children) {
     const nodes = this.lowerChildren(children);
     if (nodes.length === 1) return nodes[0];
@@ -1089,8 +1089,8 @@ var Lowerer = class {
     }
     return { slots, rest };
   }
-  // --- control-flow sugar -------------------------------------------------
-  /** `<el if=${cond}>…</el>` (+ optional `<el else>`) → `<Show when fallback>`. */
+  // control-flow sugar
+  /** `<el if=${cond}>...</el>` (+ optional `<el else>`) → `<Show when fallback>`. */
   lowerIf(el, condHole, elseEl) {
     const cond = this.hole(condHole);
     const props = [
@@ -1105,8 +1105,8 @@ var Lowerer = class {
     return { kind: "component", name: "Show", props, children: [child], ...at ? { at } : {}, ...cond.at ? { bindAt: cond.at } : {} };
   }
   /**
-   * `<el each=${items} key?>${item => …}</el>` → `<el><For each>{item => …}</For></el>`: the
-   * content is repeated per item. Content that is not a `${item => …}` arrow is repeated as
+   * `<el each=${items} key?>${item => ...}</el>` → `<el><For each>{item => ...}</For></el>`: the
+   * content is repeated per item. Content that is not a `${item => ...}` arrow is repeated as
    * it is. Null when the element has no `each`.
    */
   lowerEach(el) {
@@ -1143,7 +1143,7 @@ var Lowerer = class {
     const clone = { ...el, attributes: el.attributes.filter((a) => !drop(a)) };
     return clone.kind === "Element" ? this.lowerElement(clone) : this.lowerComponent(clone);
   }
-  // --- attributes ---------------------------------------------------------
+  // attributes
   /**
    * `element`: a DOM element, where each class:/style: value that moves is its own accessor.
    * A component gets the object as before, rebuilt whole when any value moves.
@@ -1284,7 +1284,7 @@ var Lowerer = class {
     if (mods.includes("passive")) opts.push("passive: true");
     return opts.length ? `{ ${opts.join(", ")} }` : null;
   }
-  /** `bind:value=${sig}` → `value={read()}` + `onInput={e => write(e…value)}`. */
+  /** `bind:value=${sig}` → `value={read()}` + `onInput={e => write(e...value)}`. */
   bindProps(prop, h) {
     const sigCode = h.code;
     const checked = prop === "checked";
@@ -1310,7 +1310,7 @@ var Lowerer = class {
       }
     ];
   }
-  /** A plain attribute (incl. lit `?bool`, mixed values), old `mkProp` behavior. */
+  /** A plain attribute (incl. html `?bool`, mixed values), old `mkProp` behavior. */
   plainAttr(a) {
     const v = a.value;
     let name = a.name;

package/dist/integrations.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/compiler v1.0.0-alpha.100 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/compiler v1.0.0-alpha.102 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -2183,7 +2183,7 @@ var init_template = __esm({
         for (const s of imports) this.used.add(s);
         return inlineTemplates(code, templates);
       }
-      // --- content ------------------------------------------------------------
+      // content
       lowerRoot(children) {
         const nodes = this.lowerChildren(children);
         if (nodes.length === 1) return nodes[0];
@@ -2312,8 +2312,8 @@ var init_template = __esm({
         }
         return { slots, rest };
       }
-      // --- control-flow sugar -------------------------------------------------
-      /** `<el if=${cond}>…</el>` (+ optional `<el else>`) → `<Show when fallback>`. */
+      // control-flow sugar
+      /** `<el if=${cond}>...</el>` (+ optional `<el else>`) → `<Show when fallback>`. */
       lowerIf(el, condHole, elseEl) {
         const cond = this.hole(condHole);
         const props = [
@@ -2328,8 +2328,8 @@ var init_template = __esm({
         return { kind: "component", name: "Show", props, children: [child], ...at ? { at } : {}, ...cond.at ? { bindAt: cond.at } : {} };
       }
       /**
-       * `<el each=${items} key?>${item => …}</el>` → `<el><For each>{item => …}</For></el>`: the
-       * content is repeated per item. Content that is not a `${item => …}` arrow is repeated as
+       * `<el each=${items} key?>${item => ...}</el>` → `<el><For each>{item => ...}</For></el>`: the
+       * content is repeated per item. Content that is not a `${item => ...}` arrow is repeated as
        * it is. Null when the element has no `each`.
        */
       lowerEach(el) {
@@ -2366,7 +2366,7 @@ var init_template = __esm({
         const clone = { ...el, attributes: el.attributes.filter((a) => !drop(a)) };
         return clone.kind === "Element" ? this.lowerElement(clone) : this.lowerComponent(clone);
       }
-      // --- attributes ---------------------------------------------------------
+      // attributes
       /**
        * `element`: a DOM element, where each class:/style: value that moves is its own accessor.
        * A component gets the object as before, rebuilt whole when any value moves.
@@ -2507,7 +2507,7 @@ var init_template = __esm({
         if (mods.includes("passive")) opts.push("passive: true");
         return opts.length ? `{ ${opts.join(", ")} }` : null;
       }
-      /** `bind:value=${sig}` → `value={read()}` + `onInput={e => write(e…value)}`. */
+      /** `bind:value=${sig}` → `value={read()}` + `onInput={e => write(e...value)}`. */
       bindProps(prop, h) {
         const sigCode = h.code;
         const checked = prop === "checked";
@@ -2533,7 +2533,7 @@ var init_template = __esm({
           }
         ];
       }
-      /** A plain attribute (incl. lit `?bool`, mixed values), old `mkProp` behavior. */
+      /** A plain attribute (incl. html `?bool`, mixed values), old `mkProp` behavior. */
       plainAttr(a) {
         const v = a.value;
         let name = a.name;
@@ -2597,7 +2597,7 @@ function bindHole(expr, used, onNested) {
   if (import_core.types.isObjectExpression(expr)) hole.object = true;
   return hole;
 }
-function lowerLitTemplate(node, used, opts = {}) {
+function lowerHtmlTemplate(node, used, opts = {}) {
   const quasi = node.quasi;
   const holes = quasi.expressions.map((e) => bindHole(e, used, opts.onNested));
   return lowerTemplate(buildPieces(quasi), holes, used, opts);
@@ -2706,14 +2706,14 @@ var init_analyze_static = __esm({
   }
 });
 
-// src/frontend/babel/build-ir-lit.ts
-function buildIRFromLit(node, used = /* @__PURE__ */ new Set(), opts = {}) {
-  const ir = lowerLitTemplate(node, used, opts);
+// src/frontend/babel/build-ir-html.ts
+function buildIRFromHtml(node, used = /* @__PURE__ */ new Set(), opts = {}) {
+  const ir = lowerHtmlTemplate(node, used, opts);
   analyzeStatic(ir);
   return ir;
 }
-var init_build_ir_lit = __esm({
-  "src/frontend/babel/build-ir-lit.ts"() {
+var init_build_ir_html = __esm({
+  "src/frontend/babel/build-ir-html.ts"() {
     "use strict";
     init_lower_template();
     init_analyze_static();
@@ -3149,12 +3149,12 @@ function transformNestedJSX(node, used, onNested) {
       const { code, imports, templates } = imperativeBackend.emit(nestedIR, {});
       emitInto(path, inlineTemplates(code, templates), imports);
     },
-    // Nested lit templates compose: ${cond ? html`…` : html`…`},
+    // Nested html templates compose: ${cond ? html`...` : html`...`},
     // ${list.map(x => html`<li>${x}</li>`)}. Compile them the same way.
     TaggedTemplateExpression(path) {
       const tag = path.node.tag;
       if (!import_core2.types.isIdentifier(tag) || tag.name !== "html" && tag.name !== "svg") return;
-      const ir = buildIRFromLit(path.node, used, { svg: tag.name === "svg", onNested });
+      const ir = buildIRFromHtml(path.node, used, { svg: tag.name === "svg", onNested });
       onNested?.(ir);
       const { code, imports, templates } = imperativeBackend.emit(ir, {});
       emitInto(path, inlineTemplates(code, templates), imports);
@@ -3186,7 +3186,7 @@ var init_build_ir = __esm({
     import_core2 = require("@babel/core");
     import_generator2 = __toESM(require("@babel/generator"), 1);
     init_imperative();
-    init_build_ir_lit();
+    init_build_ir_html();
     init_jsx();
     init_reactive_expr();
     init_expr_shape();
@@ -3292,10 +3292,10 @@ function dedupeImports(imports) {
   }
   return out;
 }
-function emitLitViaIR(node, state) {
+function emitHtmlViaIR(node, state) {
   const used = /* @__PURE__ */ new Set();
   const svg = import_core3.types.isIdentifier(node.tag) && node.tag.name === "svg";
-  const ir = buildIRFromLit(node, used, { svg, onNested: nestedHook(state) });
+  const ir = buildIRFromHtml(node, used, { svg, onNested: nestedHook(state) });
   resolveComponentSources(ir, {
     resolver: state.componentResolver,
     modules: {
@@ -3310,7 +3310,7 @@ function emitLitViaIR(node, state) {
   for (const s of imports) used.add(s);
   for (const s of used) state.irImports.add(s);
   collectRuntimeNeeds(ir, state);
-  state.hasLitIR = true;
+  state.hasHtmlIR = true;
   const expression = import_core3.template.expression(adoptTemplates(code, templates, state), {
     placeholderPattern: false,
     plugins: ["typescript"]
@@ -3382,7 +3382,7 @@ var init_plugin = __esm({
     init_builtins();
     import_core3 = require("@babel/core");
     init_build_ir();
-    init_build_ir_lit();
+    init_build_ir_html();
     init_imperative();
     CORE_ONLY_CONTROL_FLOW = new Set(CORE_CONTROL_FLOW);
     ROUTER_COMPONENTS2 = new Set(ROUTER_COMPONENTS);
@@ -3400,11 +3400,11 @@ var init_plugin = __esm({
         // `fluixi()` needs no `format` option. Injected imports are deduped, so a
         // file mixing the two styles won't redeclare a binding.
         format = "both",
-        litTag = "html",
+        htmlTag = "html",
         resolve: resolveRules = []
       } = options;
       const componentResolver = createComponentResolver(resolveRules);
-      const compileLit = format === "lit" || format === "both";
+      const compileHtml = format === "html" || format === "both";
       const pluginState = {
         irImports: /* @__PURE__ */ new Set(),
         libModule: "@fluixi/core",
@@ -3413,7 +3413,7 @@ var init_plugin = __esm({
         templateClone,
         partialTemplates,
         hasJSX: false,
-        hasLitHTML: false,
+        hasHtmlTag: false,
         needsControlFlowImport: false,
         needsCreateMemo: false,
         controlFlowComponents: /* @__PURE__ */ new Set(),
@@ -3437,8 +3437,8 @@ var init_plugin = __esm({
             enter(path, state) {
               Object.assign(state, {
                 hasJSX: false,
-                hasLitHTML: false,
-                hasLitIR: false,
+                hasHtmlTag: false,
+                hasHtmlIR: false,
                 needsControlFlowImport: false,
                 needsCreateMemo: false,
                 controlFlowComponents: /* @__PURE__ */ new Set(),
@@ -3463,7 +3463,7 @@ var init_plugin = __esm({
             },
             exit(path, state) {
               const imports = [];
-              if (state.hasJSX || state.hasLitIR) {
+              if (state.hasJSX || state.hasHtmlIR) {
                 if (state.irImports.size > 0) {
                   const CF = /* @__PURE__ */ new Set([
                     "Show",
@@ -3653,8 +3653,8 @@ var init_plugin = __esm({
             path.replaceWith(emitViaIR(path.node, state));
           },
           TaggedTemplateExpression(path, state) {
-            if (compileLit && import_core3.types.isIdentifier(path.node.tag) && (path.node.tag.name === litTag || path.node.tag.name === "svg")) {
-              path.replaceWith(emitLitViaIR(path.node, state));
+            if (compileHtml && import_core3.types.isIdentifier(path.node.tag) && (path.node.tag.name === htmlTag || path.node.tag.name === "svg")) {
+              path.replaceWith(emitHtmlViaIR(path.node, state));
             }
           }
         }
@@ -3692,7 +3692,7 @@ function createPreset(options = {}) {
           importSource: "@fluixi/jsx",
           development: false,
           detectReactivity: true,
-          useLitHTML: true,
+          useHtmlTag: true,
           hoistStatics: true,
           delegateEvents: true,
           optimizeControlFlow: true,
@@ -3725,7 +3725,7 @@ var init_babel = __esm({
       }),
       minimal: createPreset({
         detectReactivity: false,
-        useLitHTML: false,
+        useHtmlTag: false,
         hoistStatics: false,
         delegateEvents: false,
         optimizeControlFlow: false
@@ -4306,7 +4306,7 @@ function outermost(list) {
     (e) => !list.some(
       (o) => o !== e && o.start <= e.start && o.end >= e.end && o.end - o.start > e.end - e.start && // An insertion at either edge of the container sits beside it, not inside it, so
       // it is not something the container's code already folded in. A statement can
-      // start where its callee starts (`$effect(…)`) and a declarator can end where its
+      // start where its callee starts (`$effect(...)`) and a declarator can end where its
       // JSX ends (`const Row = () => <b/>`).
       !(e.start === e.end && (e.start === o.start || e.start === o.end))
     )
@@ -4323,7 +4323,7 @@ function bindHole2(code, expr, edits, keepPosition = false) {
   const hole = {
     code: slice(code, expr.start, expr.end, edits),
     reactive: isReactiveShape(shapeOf(expr)),
-    // Where the `${…}` is, so a binding made from it can say so. The source map cannot:
+    // Where the `${...}` is, so a binding made from it can say so. The source map cannot:
     // the whole template is one overwrite. Only when source locations were asked for.
     ...at ? { at: { line: at.line, column: at.column } } : {}
   };
@@ -4439,11 +4439,11 @@ function relativeToRoot(id, root) {
   return id.startsWith(base) ? id.slice(base.length) : id;
 }
 function transformTemplates(code, id, options = {}) {
-  const litTag = options.litTag ?? "html";
+  const htmlTag = options.htmlTag ?? "html";
   const format = options.format ?? "both";
-  const wantsLit = format !== "jsx";
-  const wantsJsx = format !== "lit";
-  const mayHaveTemplate = wantsLit && (code.includes(`${litTag}\``) || code.includes("svg`"));
+  const wantsHtml = format !== "jsx";
+  const wantsJsx = format !== "html";
+  const mayHaveTemplate = wantsHtml && (code.includes(`${htmlTag}\``) || code.includes("svg`"));
   const wantsIntrinsics = options.intrinsics !== false && mayHaveIntrinsic(code);
   const wantsSources = options.sourceLocations === true && mayHaveSourceMarks(code);
   const sourceName = relativeToRoot(id, options.sourceRoot);
@@ -4455,12 +4455,12 @@ function transformTemplates(code, id, options = {}) {
     errorRecovery: true
   });
   const intrinsicTags = options.intrinsics === false ? /* @__PURE__ */ new Map() : tagIntrinsics(moduleBindings(ast.program));
-  const templateTags = /* @__PURE__ */ new Map([[litTag, "html"], ["svg", "svg"]]);
+  const templateTags = /* @__PURE__ */ new Map([[htmlTag, "html"], ["svg", "svg"]]);
   for (const [name, tag] of intrinsicTags) if (tag !== "css") templateTags.set(name, tag);
   const cssTags = [...intrinsicTags].filter(([, tag]) => tag === "css").map(([name]) => name);
   const found = [];
   walk7(ast.program, (n, parent, key) => {
-    if (wantsLit && isTemplateTag(n, templateTags)) found.push(n);
+    if (wantsHtml && isTemplateTag(n, templateTags)) found.push(n);
     else if (wantsJsx && isJsxRoot(n, parent, key)) found.push(n);
   });
   const props = options.propsDestructure === false ? { edits: [], diagnostics: [], used: /* @__PURE__ */ new Set() } : collectPropsEdits(ast.program, code, { runtimeModule: options.runtimeModule });
@@ -5356,7 +5356,7 @@ async function createBabelPlugin(options = {}) {
         ...options.resolve ? { resolve: options.resolve } : {},
         ...options.templateClone !== void 0 ? { templateClone: options.templateClone } : {},
         ...options.partialTemplates !== void 0 ? { partialTemplates: options.partialTemplates } : {},
-        ...options.litTag ? { litTag: options.litTag } : {},
+        ...options.htmlTag ? { htmlTag: options.htmlTag } : {},
         ...options.signalModule ? { signalModule: options.signalModule } : {},
         ...options.controlFlowModule ? { controlFlowModule: options.controlFlowModule } : {},
         ...options.routerModule ? { routerModule: options.routerModule } : {},
@@ -5530,7 +5530,7 @@ function marks(options, id) {
 function transformOptions(options, id) {
   return {
     resolve: options.resolve,
-    litTag: options.litTag,
+    htmlTag: options.htmlTag,
     sourceLocations: marks(options, id),
     sourceRoot: options.sourceRoot,
     templateClone: options.templateClone,

package/dist/integrations.d.cts

@@ -1,18 +1,3 @@
-/**
- * @fileoverview Bundler integrations for the Fluixi compiler.
- * @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
- * lower to the shared IR and the imperative backend. fluixi re-exports
- * createVitePlugin from here.
- *
- * `babel: true` routes through the babel front-end instead, for a project whose
- * own babel plugins have to see the output. It is the only thing that needs
- * @babel/core, and it says so rather than degrading: source that was not compiled
- * is source whose templates never became DOM calls, and a build that ships it
- * looks successful until the page is opened.
- */
 export interface CompilerOptions {
     /**
      * Rules that resolve an unbound capitalised tag to a module, so a component can be
@@ -62,11 +47,11 @@ export interface CompilerOptions {
      */
     importSource?: string;
     /**
-     * Authoring syntaxes to compile: 'jsx', 'lit' (only `` html`...` `` templates),
+     * Authoring syntaxes to compile: 'jsx', 'html' (only `` html`...` `` templates),
      * or 'both' (default). Both lower to the same IR and the same backend.
      * @default 'both'
      */
-    format?: 'jsx' | 'lit' | 'both';
+    format?: 'jsx' | 'html' | '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.
@@ -95,10 +80,10 @@ export interface CompilerOptions {
      */
     babel?: boolean;
     /**
-     * Tag name marking a lit template for compilation (when `format` includes lit).
+     * Tag name marking an html template for compilation (when `format` includes html).
      * @default 'html'
      */
-    litTag?: string;
+    htmlTag?: string;
     /**
      * Rewrite a component's destructured props into property reads, so
      * `function Card({ title })` keeps updating instead of reading `title` once.
@@ -123,7 +108,7 @@ export interface CompilerOptions {
      */
     controlFlowModule?: string;
     /**
-     * Module the router components (Router/Outlet/…) are auto-imported from.
+     * Module the router components (Router/Outlet/...) are auto-imported from.
      * @default '@fluixi/core/router'
      */
     routerModule?: string;
@@ -144,11 +129,11 @@ export declare function createBabelPlugin(options?: CompilerOptions): Promise<{
         routerModule?: string | undefined;
         controlFlowModule?: string | undefined;
         signalModule?: string | undefined;
-        litTag?: string | undefined;
+        htmlTag?: string | undefined;
         partialTemplates?: boolean | undefined;
         templateClone?: boolean | undefined;
         resolve?: readonly ComponentResolverRule[] | undefined;
-        format?: "both" | "jsx" | "lit" | undefined;
+        format?: "html" | "both" | "jsx" | undefined;
         importSource: string;
         development: boolean;
         delegateEvents: boolean;

package/dist/integrations.d.ts

@@ -1,18 +1,3 @@
-/**
- * @fileoverview Bundler integrations for the Fluixi compiler.
- * @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
- * lower to the shared IR and the imperative backend. fluixi re-exports
- * createVitePlugin from here.
- *
- * `babel: true` routes through the babel front-end instead, for a project whose
- * own babel plugins have to see the output. It is the only thing that needs
- * @babel/core, and it says so rather than degrading: source that was not compiled
- * is source whose templates never became DOM calls, and a build that ships it
- * looks successful until the page is opened.
- */
 export interface CompilerOptions {
     /**
      * Rules that resolve an unbound capitalised tag to a module, so a component can be
@@ -62,11 +47,11 @@ export interface CompilerOptions {
      */
     importSource?: string;
     /**
-     * Authoring syntaxes to compile: 'jsx', 'lit' (only `` html`...` `` templates),
+     * Authoring syntaxes to compile: 'jsx', 'html' (only `` html`...` `` templates),
      * or 'both' (default). Both lower to the same IR and the same backend.
      * @default 'both'
      */
-    format?: 'jsx' | 'lit' | 'both';
+    format?: 'jsx' | 'html' | '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.
@@ -95,10 +80,10 @@ export interface CompilerOptions {
      */
     babel?: boolean;
     /**
-     * Tag name marking a lit template for compilation (when `format` includes lit).
+     * Tag name marking an html template for compilation (when `format` includes html).
      * @default 'html'
      */
-    litTag?: string;
+    htmlTag?: string;
     /**
      * Rewrite a component's destructured props into property reads, so
      * `function Card({ title })` keeps updating instead of reading `title` once.
@@ -123,7 +108,7 @@ export interface CompilerOptions {
      */
     controlFlowModule?: string;
     /**
-     * Module the router components (Router/Outlet/…) are auto-imported from.
+     * Module the router components (Router/Outlet/...) are auto-imported from.
      * @default '@fluixi/core/router'
      */
     routerModule?: string;
@@ -144,11 +129,11 @@ export declare function createBabelPlugin(options?: CompilerOptions): Promise<{
         routerModule?: string | undefined;
         controlFlowModule?: string | undefined;
         signalModule?: string | undefined;
-        litTag?: string | undefined;
+        htmlTag?: string | undefined;
         partialTemplates?: boolean | undefined;
         templateClone?: boolean | undefined;
         resolve?: readonly ComponentResolverRule[] | undefined;
-        format?: "both" | "jsx" | "lit" | undefined;
+        format?: "html" | "both" | "jsx" | undefined;
         importSource: string;
         development: boolean;
         delegateEvents: boolean;

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,CAqKpE;AAsID;;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;AAqD7E;;;;;;;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":"AAEA,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,MAAM,GAAG,MAAM,CAAC;IAEjC;;;;;;;;;;;;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,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;;;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;AAID;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,eAAoB;;;;;;;;;;;;;;;;;GAwCpE;AAID;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,eAAoB,aAIpD,GAAG,MAAM,YAAY,GAAG,SAkB5C;AAmCD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,CAAC,CA+JpE;AAoID;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,eAAoB,IACxC,MAAM,GAAG,EAAE,QAAQ,MAAM,mBAUjD;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,eAAoB;;oBAItC,MAAM,MAAM,MAAM;;;;;;;;;;;;EAK3C;AAID;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,eAAoB;;iBAIhD,GAAG;EAwBnB;AAMD,YAAY,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAqD7E;;;;;;;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

@@ -1,21 +1,5 @@
-/**
- * @fileoverview Bundler integrations for the Fluixi compiler.
- * @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
- * lower to the shared IR and the imperative backend. fluixi re-exports
- * createVitePlugin from here.
- *
- * `babel: true` routes through the babel front-end instead, for a project whose
- * own babel plugins have to see the output. It is the only thing that needs
- * @babel/core, and it says so rather than degrading: source that was not compiled
- * is source whose templates never became DOM calls, and a build that ships it
- * looks successful until the page is opened.
- */
-// ============================================================================
+// Types
 // Babel Plugin Helpers
-// ============================================================================
 /**
  * Helper for creating a Babel plugin
  */
@@ -48,7 +32,7 @@ export async function createBabelPlugin(options = {}) {
                 ...(options.partialTemplates !== undefined
                     ? { partialTemplates: options.partialTemplates }
                     : {}),
-                ...(options.litTag ? { litTag: options.litTag } : {}),
+                ...(options.htmlTag ? { htmlTag: options.htmlTag } : {}),
                 ...(options.signalModule ? { signalModule: options.signalModule } : {}),
                 ...(options.controlFlowModule
                     ? { controlFlowModule: options.controlFlowModule }
@@ -59,9 +43,7 @@ export async function createBabelPlugin(options = {}) {
         },
     };
 }
-// ============================================================================
 // TypeScript Transformer Helpers
-// ============================================================================
 /**
  * Helper for creating a TypeScript transformer
  */
@@ -104,9 +86,7 @@ function tryRequire(moduleName) {
         return null;
     }
 }
-// ============================================================================
 // Vite Plugin
-// ============================================================================
 /**
  * Subpaths that used to exist, and what to write instead. A rename is cheap to
  * follow once you know it happened; the cost is finding out.
@@ -255,11 +235,6 @@ export function createVitePlugin(options = {}) {
                     plugins: plugins,
                     sourceMaps: options.sourceMaps !== false,
                 });
-                // console.log('[createVitePlugin] Transformation complete for:', id);
-                // console.log(
-                //   '[createVitePlugin] Has mergeProps in output:',
-                //   result?.code?.includes('mergeProps')
-                // );
                 return {
                     code: result?.code || code,
                     map: result?.map,
@@ -295,7 +270,7 @@ function marks(options, id) {
 function transformOptions(options, id) {
     return {
         resolve: options.resolve,
-        litTag: options.litTag,
+        htmlTag: options.htmlTag,
         sourceLocations: marks(options, id),
         sourceRoot: options.sourceRoot,
         templateClone: options.templateClone,
@@ -386,9 +361,7 @@ async function compileModule(code, id, options) {
     });
     return result?.code ? { code: result.code, map: result.map } : null;
 }
-// ============================================================================
 // Webpack Loader
-// ============================================================================
 /**
  * Create a Webpack loader for JSX transformation
  */
@@ -404,9 +377,7 @@ export function createWebpackLoader(options = {}) {
         });
     };
 }
-// ============================================================================
 // Rollup Plugin
-// ============================================================================
 /**
  * Create a Rollup plugin for JSX transformation
  */
@@ -420,9 +391,7 @@ export function createRollupPlugin(options = {}) {
         },
     };
 }
-// ============================================================================
 // ESBuild Plugin
-// ============================================================================
 /**
  * Create an ESBuild plugin for JSX transformation
  */