@fluixi/compiler 1.0.0-alpha.100

package/dist/transform/templates.d.cts

@@ -0,0 +1,82 @@
+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';
+import { type CompiledStyle, type StyleDiagnostic, type StyleLiteral, type StyleOptions, type StyleReference } from './styles.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;
+    /**
+     * Compile `<style>` / `<style scoped>` blocks with this CSS processor (the project's
+     * @fluixi-css context). Without it, `<style>` is an ordinary element.
+     */
+    styles?: StyleOptions;
+}
+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[];
+    /** `<style>` blocks taken out of the templates, processed and scoped, for the host to emit. */
+    styles?: CompiledStyle[];
+    styleDiagnostics?: StyleDiagnostic[];
+    /** `css`` values of the module, processed and unscoped, by handle id: emitted where used. */
+    styleLiterals?: StyleLiteral[];
+    /** Style values interpolated from other modules, for the build to resolve. */
+    styleReferences?: StyleReference[];
+}
+export declare function transformTemplates(code: string, id: string, options?: TransformOptions): TransformResult | null;

package/dist/transform/templates.d.ts

@@ -0,0 +1,83 @@
+import MagicString from 'magic-string';
+import { type CompileTemplateOptions } from '../lower/compile-template.js';
+import type { IRLoadStrategy } from '../ir/nodes.js';
+import { type PropsDiagnostic } from './props.js';
+import { type IntrinsicDiagnostic } from './intrinsics.js';
+import { type CompiledStyle, type StyleDiagnostic, type StyleLiteral, type StyleOptions, type StyleReference } from './styles.js';
+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;
+    /**
+     * Compile `<style>` / `<style scoped>` blocks with this CSS processor (the project's
+     * @fluixi-css context). Without it, `<style>` is an ordinary element.
+     */
+    styles?: StyleOptions;
+}
+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[];
+    /** `<style>` blocks taken out of the templates, processed and scoped, for the host to emit. */
+    styles?: CompiledStyle[];
+    styleDiagnostics?: StyleDiagnostic[];
+    /** `css`` values of the module, processed and unscoped, by handle id: emitted where used. */
+    styleLiterals?: StyleLiteral[];
+    /** Style values interpolated from other modules, for the build to resolve. */
+    styleReferences?: StyleReference[];
+}
+export declare function transformTemplates(code: string, id: string, options?: TransformOptions): TransformResult | null;
+//# sourceMappingURL=templates.d.ts.map

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

@@ -0,0 +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,EAAgE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEzH,OAAO,EAAqC,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAkB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAmBrL,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;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;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;IAC/C,+FAA+F;IAC/F,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,6FAA6F;IAC7F,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,8EAA8E;IAC9E,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACpC;AAoTD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,gBAAqB,GAC7B,eAAe,GAAG,IAAI,CAuPxB"}