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

package/dist/transform/templates.d.cts

@@ -0,0 +1,69 @@
+import MagicString from 'magic-string';
+import { type CompileTemplateOptions } from '../lower/compile-template.cjs';
+import type { IRLoadStrategy } from '../ir/nodes.cjs';
+import { type PropsDiagnostic } from './props.cjs';
+import { type IntrinsicDiagnostic } from './intrinsics.cjs';
+export interface TransformOptions extends CompileTemplateOptions {
+    /**
+     * Which authoring syntaxes to compile. Both lower to the same IR, so this is
+     * about which source forms are touched, not about output.
+     * @default 'both'
+     */
+    format?: 'jsx' | 'lit' | 'both';
+    /** Tag marking a template for compilation. @default 'html' */
+    litTag?: string;
+    /** Module the emitted runtime symbols are imported from. @default '@fluixi/dom' */
+    runtimeModule?: string;
+    /** Where reactive primitives come from. @default '@fluixi/reactive/signal' */
+    reactiveModule?: string;
+    /**
+     * Rewrite a component's destructured props into property reads, so
+     * `function Card({ title })` keeps updating instead of reading `title` once.
+     * The edits go into the same string as the template edits, so the map still points
+     * at what the author wrote.
+     * @default true
+     */
+    propsDestructure?: boolean;
+    /**
+     * Record where each reactive primitive was created, so the devtools graph can say where a
+     * node comes from. Development tooling: leave it off for production, which then carries
+     * none of it.
+     * @default false
+     */
+    sourceLocations?: boolean;
+    /**
+     * Trim this prefix off the file name a source mark records, so a location reads
+     * `src/app.tsx:5:16` rather than an absolute path that means nothing to whoever opens it.
+     */
+    sourceRoot?: string;
+    /**
+     * Compile the `$` reactive intrinsics: `$signal`, `$memo`, `$effect`, `$store`, into
+     * the runtime calls they stand for, importing what they need.
+     * @default true
+     */
+    intrinsics?: boolean;
+}
+export interface UnresolvedDiagnostic {
+    /** The tag nothing supplies. */
+    name: string;
+    message: string;
+}
+export interface LoadDiagnostic {
+    /** The component the directive was written on. */
+    name: string;
+    strategy: IRLoadStrategy;
+    message: string;
+}
+export interface TransformResult {
+    code: string;
+    map: ReturnType<MagicString['generateMap']>;
+    /** Props patterns the rewrite refused, when `propsDestructure` is on. */
+    propsDiagnostics?: PropsDiagnostic[];
+    /** `$` names the module bound itself, so the intrinsic did not fire. */
+    intrinsicDiagnostics?: IntrinsicDiagnostic[];
+    /** `load:` directives that could not take effect, and why. */
+    loadDiagnostics?: LoadDiagnostic[];
+    /** Capitalised tags nothing supplies: they compile to an undefined reference. */
+    unresolvedDiagnostics?: UnresolvedDiagnostic[];
+}
+export declare function transformTemplates(code: string, id: string, options?: TransformOptions): TransformResult | null;

package/dist/transform/templates.d.ts

@@ -37,7 +37,7 @@ export interface TransformOptions extends CompileTemplateOptions {
      */
     sourceRoot?: string;
     /**
-     * Compile the `$` reactive intrinsics — `$signal`, `$memo`, `$effect`, `$store` — into
+     * Compile the `$` reactive intrinsics: `$signal`, `$memo`, `$effect`, `$store`, into
      * the runtime calls they stand for, importing what they need.
      * @default true
      */
@@ -63,7 +63,7 @@ export interface TransformResult {
     intrinsicDiagnostics?: IntrinsicDiagnostic[];
     /** `load:` directives that could not take effect, and why. */
     loadDiagnostics?: LoadDiagnostic[];
-    /** Capitalised tags nothing supplies — they compile to an undefined reference. */
+    /** Capitalised tags nothing supplies: they compile to an undefined reference. */
     unresolvedDiagnostics?: UnresolvedDiagnostic[];
 }
 export declare function transformTemplates(code: string, id: string, options?: TransformOptions): TransformResult | null;

package/dist/transform/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/transform/templates.ts"],"names":[],"mappings":"AASA,OAAO,WAAW,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAiB,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAG1F,OAAO,KAAK,EAAqB,cAAc,EAAU,MAAM,gBAAgB,CAAC;AAWhF,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAA2C,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAoBpG,MAAM,WAAW,gBAAiB,SAAQ,sBAAsB;IAC9D;;;;OAIG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAChC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5C,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC7C,8DAA8D;IAC9D,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,kFAAkF;IAClF,qBAAqB,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAChD;AAwTD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,gBAAqB,GAC7B,eAAe,GAAG,IAAI,CAiNxB"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/transform/templates.ts"],"names":[],"mappings":"AASA,OAAO,WAAW,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAiB,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAG1F,OAAO,KAAK,EAAqB,cAAc,EAAU,MAAM,gBAAgB,CAAC;AAWhF,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAA2C,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAoBpG,MAAM,WAAW,gBAAiB,SAAQ,sBAAsB;IAC9D;;;;OAIG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAChC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5C,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC7C,8DAA8D;IAC9D,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,iFAAiF;IACjF,qBAAqB,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAChD;AAwTD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,gBAAqB,GAC7B,eAAe,GAAG,IAAI,CAiNxB"}

package/dist/transform/templates.js

@@ -25,7 +25,7 @@ import { collectSourceEdits, mayHaveReactiveCall } from './source-locations.js';
 import { mayHaveIntrinsic } from '../analyze/intrinsics.js';
 import { declaredNames } from '../analyze/reactive-bindings.js';
 import { DOM_CONTROL_FLOW, CORE_CONTROL_FLOW, ROUTER_COMPONENTS } from '../resolve/builtins.js';
-// Which builtin comes from which module is published by resolve/builtins.ts —
+// Which builtin comes from which module is published by resolve/builtins.ts , 
 // the same lists the resolve pass and the TS plugin read. Restating them here is
 // how `Await` ended up imported from the dom runtime, which does not export it.
 const CONTROL_FLOW = new Set(DOM_CONTROL_FLOW);
@@ -56,7 +56,7 @@ const isJsx = (node) => node.type === 'JSXElement' || node.type === 'JSXFragment
 /**
  * A JSX node the transform compiles on its own.
  *
- * A direct child — `<li>` in `<ul><li/></ul>` — is not one: the builder recurses
+ * A direct child: `<li>` in `<ul><li/></ul>`: is not one: the builder recurses
  * into it, and compiling it separately would splice its output into the middle of
  * its parent's. JSX reached through an expression or an attribute value *is* one,
  * because the builder asks for that expression as source text and needs it
@@ -88,7 +88,7 @@ function outermost(list) {
  * Apply edits to a slice of the source.
  *
  * Only the outermost ones: a contained edit was already folded into its
- * container's emitted code, and applying both would splice it twice — the second
+ * container's emitted code, and applying both would splice it twice, the second
  * write landing at an offset the first has already moved.
  */
 function slice(code, start, end, edits) {
@@ -131,7 +131,7 @@ function bindHole(code, expr, edits, keepPosition = false) {
  *
  * Hoisted names deliberately do not use the backend's `_tmpl$N` namespace. Roots
  * are emitted innermost first and spliced into their parent, so by the time the
- * outer one is renamed its code already contains hoisted names — and with a
+ * outer one is renamed its code already contains hoisted names, and with a
  * shared prefix the rename rewrites those too, pointing two templates at one
  * string. A separate prefix makes the two impossible to confuse.
  */
@@ -186,7 +186,7 @@ function collectNeeds(node, out) {
  * chunk splits like any other.
  *
  * Only when the name is used **exclusively as a tag**. JSX element names are
- * `JSXIdentifier`, so a component used only in markup has zero `Identifier` references —
+ * `JSXIdentifier`, so a component used only in markup has zero `Identifier` references ,
  * which makes the check exact rather than a guess. Anything else (passed to a function,
  * re-exported, `Chart.displayName`) keeps its import and its warning: replacing the real
  * binding with a lazy wrapper would change what those sites see.
@@ -221,7 +221,7 @@ function hasNamespaceImport(program, name) {
     }
     return false;
 }
-/** Whether `name` is referenced as a value anywhere — a tag alone does not count. */
+/** Whether `name` is referenced as a value anywhere, a tag alone does not count. */
 function usedAsValue(program, name, specifier) {
     let seen = false;
     walk(program, (node) => {
@@ -338,7 +338,7 @@ export function transformTemplates(code, id, options = {}) {
     const sources = options.sourceLocations === true
         ? collectSourceEdits(ast.program, sourceName)
         : { edits: [], marked: 0 };
-    // Nothing to emit still returns a result when there's something to say — a shadowed
+    // Nothing to emit still returns a result when there's something to say, a shadowed
     // intrinsic is a diagnostic even though the code comes back untouched.
     const silent = found.length === 0 &&
         props.edits.length === 0 &&