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

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

@@ -0,0 +1,69 @@
+import { type ComponentResolverRule } from '../resolve/component-resolver.cjs';
+import type { IRNode } from '../ir/nodes.cjs';
+import { type TemplateHole } from './template.cjs';
+export type { TemplateHole };
+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
+     * before the first `${`, between each pair, and after the last `}`.
+     */
+    statics: readonly string[];
+    /** One descriptor per `${…}`, in source order. */
+    holes: readonly TemplateHole[];
+}
+export interface CompileTemplateOptions {
+    /** An `` svg`...` `` root, which changes how the parser namespaces tags. */
+    svg?: boolean;
+    /** Clone static subtrees from a template instead of building them element by element. */
+    templateClone?: boolean;
+    /** Also clone subtrees whose structure is static but which contain holes. */
+    partialTemplates?: boolean;
+    /** Rules that resolve an unbound capitalised tag to a module. */
+    resolve?: readonly ComponentResolverRule[];
+    /** Where control-flow components are imported from. @default '@fluixi/dom' */
+    controlFlowModule?: string;
+    /** Where core-only components (Suspense, Portal) come from. @default '@fluixi/core' */
+    coreModule?: string;
+    /** Where router components come from. @default '@fluixi/core/router' */
+    routerModule?: string;
+    /**
+     * Leave static templates as `_tmpl$N` references and hand them back, for a
+     * caller that has a module scope to declare them in. Off inlines them.
+     */
+    hoistTemplates?: boolean;
+    /**
+     * 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
+     * ones in a component with no mark of their own, and they take whichever one was left.
+     */
+    sourceFile?: string;
+    positionAt?: (offset: number) => {
+        line: number;
+        column: number;
+    };
+}
+export interface CompileTemplateResult {
+    /** A JavaScript expression that builds the DOM when evaluated. */
+    code: string;
+    /** Runtime symbols the code refers to, for the caller to import. */
+    imports: string[];
+    /** The IR it was emitted from, for a caller that wants to inspect or transform it. */
+    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
+     * scope to hoist into.
+     */
+    templates?: StaticTemplate[];
+}
+export declare function compileTemplate(source: TemplateSource, options?: CompileTemplateOptions): CompileTemplateResult;
+/**
+ * Same pipeline entered with pieces that already carry real source offsets, so a
+ * caller reading a file keeps its positions instead of the synthetic ones derived
+ * from the static runs.
+ */
+export declare function compilePieces(pieces: Piece[], holes: readonly TemplateHole[], options?: CompileTemplateOptions): CompileTemplateResult;

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

@@ -33,6 +33,18 @@ export interface CompileTemplateOptions {
      * caller that has a module scope to declare them in. Off inlines them.
      */
     hoistTemplates?: boolean;
+    /**
+     * 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
+     * ones in a component with no mark of their own, and they take whichever one was left.
+     */
+    sourceFile?: string;
+    positionAt?: (offset: number) => {
+        line: number;
+        column: number;
+    };
 }
 export interface CompileTemplateResult {
     /** A JavaScript expression that builds the DOM when evaluated. */

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

@@ -1 +1 @@
-{"version":3,"file":"compile-template.d.ts","sourceRoot":"","sources":["../../src/lower/compile-template.ts"],"names":[],"mappings":"AAcA,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACvG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EAAE,YAAY,EAAE,CAAC;AAC7B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,kDAAkD;IAClD,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,yFAAyF;IACzF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iEAAiE;IACjE,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3C,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sFAAsF;IACtF,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B;AAqBD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CASvB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,KAAK,EAAE,EACf,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CA0BvB"}
+{"version":3,"file":"compile-template.d.ts","sourceRoot":"","sources":["../../src/lower/compile-template.ts"],"names":[],"mappings":"AAcA,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACvG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EAAE,YAAY,EAAE,CAAC;AAC7B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,kDAAkD;IAClD,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,yFAAyF;IACzF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iEAAiE;IACjE,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3C,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACnE;AAED,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sFAAsF;IACtF,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B;AAqBD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CASvB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,KAAK,EAAE,EACf,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CA8BvB"}

package/dist/lower/compile-template.js

@@ -46,7 +46,11 @@ export function compileTemplate(source, options = {}) {
  */
 export function compilePieces(pieces, holes, options = {}) {
     const used = new Set();
-    const ir = lowerTemplate(pieces, [...holes], used, { svg: options.svg });
+    const ir = lowerTemplate(pieces, [...holes], used, {
+        svg: options.svg,
+        ...(options.sourceFile ? { sourceFile: options.sourceFile } : {}),
+        ...(options.positionAt ? { positionAt: options.positionAt } : {}),
+    });
     analyzeStatic(ir);
     // Same order as the Babel front-end: decide where each component reference
     // comes from, then drop deferred boundaries around modules already in the chunk.