@barefootjs/xslate 0.8.0

package/dist/adapter/xslate-adapter.d.ts

@@ -0,0 +1,176 @@
+/**
+ * BarefootJS Text::Xslate (Kolon) Template Adapter
+ *
+ * Generates Text::Xslate Kolon template files (.tx) from BarefootJS IR.
+ *
+ * Near-mechanical port of the Mojolicious EP adapter
+ * (packages/adapter-mojolicious/src/adapter/mojo-adapter.ts) from Mojo EP
+ * syntax to Kolon syntax. The expression-lowering pipeline (JS → Perl
+ * scalars / `$bf.helper(...)` calls) is shared in spirit with the Mojo
+ * adapter; only the surrounding template syntax differs:
+ *
+ *   Mojo `<%= EXPR %>`        → Kolon `<: EXPR :>`            (HTML-escaped)
+ *   Mojo `<%== EXPR %>`       → Kolon `<: EXPR | mark_raw :>` (raw)
+ *   Mojo `bf->method(args)`   → Kolon `$bf.method(args)`
+ *   Mojo `% if (C) { ... % }` → Kolon `: if (C) { ... : }`    (line statements)
+ *   Mojo `% for ... { ... % }`→ Kolon `: for $arr -> $x { ... : }`
+ *
+ * Kolon auto-escapes `<: ... :>` interpolations (the backend builds the
+ * engine with `type => 'html'`); helpers that emit markup are piped through
+ * `| mark_raw` so they survive verbatim — mirroring Mojo EP's `<%==` vs `<%=`.
+ */
+import type { ComponentIR, IRNode, IRElement, IRText, IRExpression, IRConditional, IRLoop, IRComponent, IRFragment, IRSlot, IRIfStatement, IRProvider, IRAsync, TemplatePrimitiveRegistry } from '@barefootjs/jsx';
+import { BaseAdapter, type AdapterOutput, type AdapterGenerateOptions, type IRNodeEmitter, type EmitIRNode } from '@barefootjs/jsx';
+/**
+ * Xslate adapter's IRNode render context. Like the Mojo adapter, Kolon's
+ * lowering doesn't consume any render-position flags, so the Ctx is empty.
+ * Kept as a named alias so future flags can extend it without changing the
+ * `IRNodeEmitter` interface.
+ */
+type XslateRenderCtx = Record<string, never>;
+import type { ParsedExpr } from '@barefootjs/jsx';
+export interface XslateAdapterOptions {
+    /** Base path for client JS files (default: '/static/components/') */
+    clientJsBasePath?: string;
+    /** Path to barefoot.js runtime (default: '/static/components/barefoot.js') */
+    barefootJsPath?: string;
+}
+export declare class XslateAdapter extends BaseAdapter implements IRNodeEmitter<XslateRenderCtx> {
+    name: string;
+    extension: string;
+    templatesPerComponent: boolean;
+    importMapInjection: 'html-snippet';
+    /**
+     * Identifier-path callees the Xslate runtime can render in template scope.
+     * The relocate pass consults this map to mark matching calls as
+     * template-safe; the SSR template emitter substitutes the JS call with the
+     * registered `$bf.NAME(...)` helper invocation.
+     */
+    templatePrimitives: TemplatePrimitiveRegistry;
+    private componentName;
+    private options;
+    private errors;
+    private inLoop;
+    /**
+     * SolidJS-style props identifier (`function(props: P)`) and the
+     * analyzer-extracted prop names. Stashed at `generate()` entry so the
+     * per-attribute `emitSpread` callback can build a propsObject spread bag as
+     * an inline Kolon hashref literal without re-walking the IR.
+     */
+    private propsObjectName;
+    private propsParams;
+    /**
+     * Names (signal getters + props) whose value is a string, so `===`/`!==`
+     * against them lowers to Perl `eq`/`ne` rather than numeric `==`/`!=`.
+     * Kolon comparison operators delegate to Perl semantics, so the same
+     * string-vs-numeric distinction the Mojo adapter makes applies here.
+     */
+    private stringValueNames;
+    constructor(options?: XslateAdapterOptions);
+    generate(ir: ComponentIR, options?: AdapterGenerateOptions): AdapterOutput;
+    private generateScriptRegistrations;
+    private hasClientInteractivity;
+    /**
+     * Public entry point for node rendering. Delegates to the shared
+     * `IRNodeEmitter` dispatcher; per-kind logic lives in the `IRNodeEmitter`
+     * methods below.
+     */
+    renderNode(node: IRNode): string;
+    emitElement(node: IRElement, _ctx: XslateRenderCtx, _emit: EmitIRNode<XslateRenderCtx>): string;
+    emitText(node: IRText): string;
+    emitExpression(node: IRExpression): string;
+    emitConditional(node: IRConditional, _ctx: XslateRenderCtx, _emit: EmitIRNode<XslateRenderCtx>): string;
+    emitLoop(node: IRLoop, _ctx: XslateRenderCtx, _emit: EmitIRNode<XslateRenderCtx>): string;
+    emitComponent(node: IRComponent, _ctx: XslateRenderCtx, _emit: EmitIRNode<XslateRenderCtx>): string;
+    emitFragment(node: IRFragment, _ctx: XslateRenderCtx, _emit: EmitIRNode<XslateRenderCtx>): string;
+    emitSlot(node: IRSlot): string;
+    emitIfStatement(node: IRIfStatement, _ctx: XslateRenderCtx, _emit: EmitIRNode<XslateRenderCtx>): string;
+    emitProvider(node: IRProvider, _ctx: XslateRenderCtx, _emit: EmitIRNode<XslateRenderCtx>): string;
+    emitAsync(node: IRAsync, _ctx: XslateRenderCtx, _emit: EmitIRNode<XslateRenderCtx>): string;
+    renderElement(element: IRElement): string;
+    renderExpression(expr: IRExpression): string;
+    renderConditional(cond: IRConditional): string;
+    private renderNodeOrNull;
+    /**
+     * Add bf-c attribute to the first HTML element in a branch.
+     * If no element found, wrap with comment markers.
+     */
+    private addCondMarkerToFirstElement;
+    /**
+     * Push a `BF103` diagnostic for every component reference inside a loop body
+     * whose name is imported from a relative-path module. Mirror of the Mojo
+     * adapter's check — the Xslate adapter has the same cross-template-
+     * registration constraint at request time.
+     */
+    private checkImportedLoopChildComponents;
+    renderLoop(loop: IRLoop): string;
+    /**
+     * AttrValue lowering for component invocation props (Kolon hashref-entry
+     * form). Kolon CANNOT splat a hash into positional args, so every prop is
+     * emitted as a `key => value` entry that the caller collects into ONE
+     * hashref literal passed to `$bf.render_child(name, { ... })`.
+     *
+     * `jsx-children` returns empty — children are captured via a Kolon macro
+     * below, not threaded through the hashref entry list.
+     */
+    private readonly componentPropEmitter;
+    renderComponent(comp: IRComponent): string;
+    private childrenCaptureCounter;
+    private toTemplateName;
+    private renderIfStatement;
+    private renderFragment;
+    private renderSlot;
+    renderAsync(node: IRAsync): string;
+    /**
+     * AttrValue lowering for intrinsic-element attributes (Kolon).
+     */
+    private readonly elementAttrEmitter;
+    private renderAttributes;
+    renderScopeMarker(_instanceIdExpr: string): string;
+    renderSlotMarker(slotId: string): string;
+    renderCondMarker(condId: string): string;
+    /**
+     * Convert a ParsedExpr AST to a Kolon expression string for filter
+     * predicates. Wraps the shared ParsedExpr dispatcher with an
+     * `XslateFilterEmitter` carrying the predicate's loop param and any
+     * block-body local var aliases.
+     */
+    private renderKolonFilterExpr;
+    /**
+     * Render a complex block body filter into a Kolon condition.
+     * Handles patterns like: filter(t => { const f = filter(); if (...) return ...; })
+     */
+    private renderBlockBodyCondition;
+    private collectReturnPaths;
+    private buildSinglePathCondition;
+    private renderConditionsAnd;
+    private convertTemplateLiteralPartsToKolon;
+    /**
+     * Translate `${EXPR}` interpolations in a static template-part string into
+     * Kolon variable references and concatenate them with the surrounding
+     * literal text.
+     */
+    private substituteJsInterpolationsToKolon;
+    /**
+     * Refuse JS expression shapes that have no idiomatic Kolon representation:
+     * object literals (`style={{...}}`) and tagged-template-literal call
+     * expressions (`cn\`base \${tone()}\``). Records `BF101`. Returns `true`
+     * when the shape was rejected (caller should drop the attribute).
+     */
+    private refuseUnsupportedAttrExpression;
+    private convertExpressionToKolon;
+    /**
+     * Render a full ParsedExpr tree to Kolon for top-level (non-filter)
+     * expressions where identifiers are signals / template vars.
+     */
+    private renderParsedExprToKolon;
+    /** Whether `name` (a signal getter or prop) holds a string value, so an
+     *  equality comparison against it should use Perl `eq`/`ne`. */
+    _isStringValueName(name: string): boolean;
+    _recordExprBF101(message: string, reason?: string): void;
+    /** Internal hook for higher-order: predicate body re-uses the filter emitter. */
+    _renderKolonFilterExprPublic(expr: ParsedExpr, param: string): string;
+}
+export declare const xslateAdapter: XslateAdapter;
+export {};
+//# sourceMappingURL=xslate-adapter.d.ts.map

package/dist/adapter/xslate-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xslate-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/xslate-adapter.ts"],"names":[],"mappings":"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"}

package/dist/build.d.ts

@@ -0,0 +1,28 @@
+import type { BuildOptions } from '@barefootjs/jsx';
+import { XslateAdapter } from './adapter';
+import type { XslateAdapterOptions } from './adapter';
+export interface XslateBuildOptions extends BuildOptions {
+    /** Adapter-specific options passed to XslateAdapter */
+    adapterOptions?: XslateAdapterOptions;
+}
+/**
+ * Create a BarefootBuildConfig for Text::Xslate (Kolon) template projects.
+ *
+ * Uses structural typing — does not import BarefootBuildConfig to avoid a
+ * circular dependency between @barefootjs/xslate and @barefootjs/cli.
+ */
+export declare function createConfig(options?: XslateBuildOptions): {
+    adapter: XslateAdapter;
+    paths: import("@barefootjs/jsx").BarefootPaths | undefined;
+    components: string[] | undefined;
+    outDir: string | undefined;
+    minify: boolean | undefined;
+    contentHash: boolean | undefined;
+    externals: Record<string, import("@barefootjs/jsx").ExternalSpec> | undefined;
+    externalsBasePath: string | undefined;
+    bundleEntries: import("@barefootjs/jsx").BundleEntry[] | undefined;
+    localImportPrefixes: string[] | undefined;
+    outputLayout: import("@barefootjs/jsx").OutputLayout;
+    postBuild: ((ctx: import("@barefootjs/jsx").PostBuildContext) => Promise<void> | void) | undefined;
+};
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAErD,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,uDAAuD;IACvD,cAAc,CAAC,EAAE,oBAAoB,CAAA;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,kBAAuB;IAEzD,OAAO;IACP,KAAK;IACL,UAAU;IACV,MAAM;IACN,MAAM;IACN,WAAW;IACX,SAAS;IACT,iBAAiB;IACjB,aAAa;IACb,mBAAmB;IACnB,YAAY;IAKZ,SAAS;EAEZ"}