@barefootjs/mojolicious 0.1.0

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

@@ -0,0 +1,219 @@
+/**
+ * BarefootJS Mojolicious EP Template Adapter
+ *
+ * Generates Mojolicious EP template files (.html.ep) from BarefootJS IR.
+ */
+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';
+/**
+ * Mojo adapter's IRNode render context. Mojo's lowering currently
+ * doesn't consume any render-position flags (`isRootOfClientComponent`
+ * is handled differently here than in Hono/Go), so the Ctx is empty.
+ * Kept as a named alias so future flags can extend it without changing
+ * the `IRNodeEmitter` interface.
+ */
+type MojoRenderCtx = Record<string, never>;
+import type { ParsedExpr } from '@barefootjs/jsx';
+export interface MojoAdapterOptions {
+    /** 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 MojoAdapter extends BaseAdapter implements IRNodeEmitter<MojoRenderCtx> {
+    name: string;
+    extension: string;
+    templatesPerComponent: boolean;
+    /**
+     * Identifier-path callees the Mojo runtime can render in template
+     * scope. The relocate pass consults this map to mark matching
+     * calls as template-safe so the surrounding expression stays
+     * inlinable; the SSR template emitter substitutes the JS call
+     * with the registered Perl helper invocation.
+     *
+     * The per-callee arity is read directly off `MOJO_TEMPLATE_PRIMITIVES`
+     * at substitution time, so this exposed shape stays as the
+     * `TemplateAdapter` interface expects (`emit`-only) without
+     * carrying a parallel arity map.
+     */
+    templatePrimitives: TemplatePrimitiveRegistry;
+    private componentName;
+    private options;
+    private errors;
+    private inLoop;
+    /**
+     * Re-entry guard for `convertHigherOrderExpr` (#1421).
+     *
+     * `MojoTopLevelEmitter.unsupported` falls back to the regex pipeline
+     * via `_convertExpressionToPerlPublic`, which re-detects the
+     * `.filter|every|some` short-circuit and re-enters
+     * `convertHigherOrderExpr` with the same raw text. When the parser
+     * carries the full original expression down to every nested
+     * `unsupported` node (e.g. an array-literal callee that the AST
+     * can't classify), the cycle has no terminator and the JS stack
+     * blows. The guard records the expression on entry, emits BF101 on
+     * second visit, and bails out — so the user sees an actionable
+     * diagnostic instead of `RangeError: Maximum call stack size`.
+     */
+    private higherOrderInFlight;
+    /**
+     * 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 Perl hashref literal without re-walking
+     * the IR (#1407 follow-up).
+     */
+    private propsObjectName;
+    private propsParams;
+    constructor(options?: MojoAdapterOptions);
+    generate(ir: ComponentIR, options?: AdapterGenerateOptions): AdapterOutput;
+    private generateScriptRegistrations;
+    private hasClientInteractivity;
+    /**
+     * Public entry point for node rendering. Delegates to the shared
+     * `IRNodeEmitter` dispatcher (#1290 step 1); per-kind logic lives in
+     * the `IRNodeEmitter` methods below.
+     */
+    renderNode(node: IRNode): string;
+    emitElement(node: IRElement, _ctx: MojoRenderCtx, _emit: EmitIRNode<MojoRenderCtx>): string;
+    emitText(node: IRText): string;
+    emitExpression(node: IRExpression): string;
+    emitConditional(node: IRConditional, _ctx: MojoRenderCtx, _emit: EmitIRNode<MojoRenderCtx>): string;
+    emitLoop(node: IRLoop, _ctx: MojoRenderCtx, _emit: EmitIRNode<MojoRenderCtx>): string;
+    emitComponent(node: IRComponent, _ctx: MojoRenderCtx, _emit: EmitIRNode<MojoRenderCtx>): string;
+    emitFragment(node: IRFragment, _ctx: MojoRenderCtx, _emit: EmitIRNode<MojoRenderCtx>): string;
+    emitSlot(node: IRSlot): string;
+    emitIfStatement(node: IRIfStatement, _ctx: MojoRenderCtx, _emit: EmitIRNode<MojoRenderCtx>): string;
+    emitProvider(node: IRProvider, _ctx: MojoRenderCtx, _emit: EmitIRNode<MojoRenderCtx>): string;
+    emitAsync(node: IRAsync, _ctx: MojoRenderCtx, _emit: EmitIRNode<MojoRenderCtx>): 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 Go adapter's check — the Mojo adapter has the same
+     * cross-template-registration constraint at request time.
+     */
+    private checkImportedLoopChildComponents;
+    renderLoop(loop: IRLoop): string;
+    /**
+     * AttrValue lowering for component invocation props (Mojo / Perl
+     * named-arg form). Routed through the shared dispatcher so a new
+     * AttrValue kind becomes a TS compile error here (#1290 step 2).
+     *
+     * `jsx-children` returns empty — children are captured via Mojo's
+     * `begin %>…<% end` block below, not threaded through the
+     * `render_child` named-arg 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 (Mojo / EP
+     * template). Routed through the shared dispatcher (#1290 step 2).
+     */
+    private readonly elementAttrEmitter;
+    private renderAttributes;
+    renderScopeMarker(_instanceIdExpr: string): string;
+    renderSlotMarker(slotId: string): string;
+    renderCondMarker(condId: string): string;
+    /**
+     * Convert a ParsedExpr AST to Perl expression string for filter
+     * predicates. Wraps the shared ParsedExpr dispatcher with a
+     * `MojoFilterEmitter` carrying the predicate's loop param and
+     * any block-body local var aliases (#1250 phase 1B).
+     */
+    private renderPerlFilterExpr;
+    /**
+     * Render a complex block body filter into a Perl condition.
+     * Handles patterns like: filter(t => { const f = filter(); if (...) return ...; })
+     */
+    private renderBlockBodyCondition;
+    private collectReturnPaths;
+    private buildSinglePathCondition;
+    private renderConditionsAnd;
+    private convertTemplateLiteralPartsToPerl;
+    /**
+     * Translate `${EXPR}` interpolations in a static template-part string
+     * into Perl variable references and concatenate them with the
+     * surrounding literal text. Used by `convertTemplateLiteralPartsToPerl`
+     * when a `string` part still carries unresolved interpolations (e.g.
+     * `${className}` from a destructured prop the IR analyzer couldn't
+     * inline statically).
+     */
+    private substituteJsInterpolationsToPerl;
+    /**
+     * Refuse JS expression shapes that have no idiomatic Mojo template
+     * representation (#1322). Currently catches:
+     *
+     *   - Object literals (`style={{ background: bg(), color: fg() }}`):
+     *     the regex pipeline strips signal calls but leaves the
+     *     surrounding `{ k: v, ... }` syntax intact, producing invalid
+     *     Perl inside `<%= ... %>`.
+     *   - Tagged-template-literal call expressions
+     *     (`className={cn\`base \${tone()}\`}`): regex translation
+     *     produces malformed Perl with no callable target.
+     *
+     * Records `BF101` with the same shape the Go adapter emits via
+     * `convertExpressionToGo`, so cross-adapter diagnostics stay
+     * consistent. Returns `true` when the shape was rejected (caller
+     * should drop the attribute / skip the emit).
+     */
+    private refuseUnsupportedAttrExpression;
+    private convertExpressionToPerl;
+    /**
+     * Walk the parsed AST of `expr` and substitute each registered
+     * primitive call (e.g. `JSON.stringify(props.config)`) with its
+     * Mojo helper-call equivalent (e.g. `bf->json($config)`). All
+     * other shapes round-trip back to source text via
+     * `stringifyParsedExpr`, so the result is still a JS-shaped
+     * string that the existing regex pipeline in
+     * `convertExpressionToPerl` can finish translating.
+     *
+     * Bails out (returns the input unchanged) when:
+     *   - the expression doesn't parse cleanly,
+     *   - no primitive call is found in the AST, or
+     *   - a primitive's arity doesn't match the registered shape
+     *     (BF101 is recorded so the user sees the diagnostic).
+     *
+     * Identifier-path-only matching (#1187 R1) — same constraint the
+     * Go adapter applies in #1188.
+     */
+    private rewriteTemplatePrimitives;
+    /**
+     * Convert expressions containing higher-order array methods to Perl.
+     * Parses the full expression as AST and renders recursively.
+     *
+     * Handles patterns like:
+     * - todos().filter(t => !t.done).length → scalar(grep { !$_->{done} } @{$todos})
+     * - todos().every(t => t.done) → !(grep { !$_->{done} } @{$todos})
+     * - todos().filter(t => t.done).length > 0 → scalar(grep { $_->{done} } @{$todos}) > 0
+     */
+    private convertHigherOrderExpr;
+    /**
+     * Render a full ParsedExpr tree to Perl for top-level (non-filter)
+     * expressions where identifiers are signals / stash vars. Delegates
+     * to the shared ParsedExpr dispatcher with `MojoTopLevelEmitter`
+     * (#1250 phase 1B).
+     */
+    private renderParsedExprToPerl;
+    /** Internal hook exposed to the top-level emitter for unsupported nodes. */
+    _convertExpressionToPerlPublic(raw: string): string;
+    /** Internal hook for higher-order: predicate body re-uses the filter emitter. */
+    _renderPerlFilterExprPublic(expr: ParsedExpr, param: string): string;
+}
+export declare const mojoAdapter: MojoAdapter;
+export {};
+//# sourceMappingURL=mojo-adapter.d.ts.map

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

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

package/dist/build.d.ts

@@ -0,0 +1,28 @@
+import type { BuildOptions } from '@barefootjs/jsx';
+import { MojoAdapter } from './adapter';
+import type { MojoAdapterOptions } from './adapter';
+export interface MojoBuildOptions extends BuildOptions {
+    /** Adapter-specific options passed to MojoAdapter */
+    adapterOptions?: MojoAdapterOptions;
+}
+/**
+ * Create a BarefootBuildConfig for Mojolicious EP template projects.
+ *
+ * Uses structural typing — does not import BarefootBuildConfig to avoid a
+ * circular dependency between @barefootjs/mojolicious and @barefootjs/cli.
+ */
+export declare function createConfig(options?: MojoBuildOptions): {
+    adapter: MojoAdapter;
+    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,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAEnD,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,qDAAqD;IACrD,cAAc,CAAC,EAAE,kBAAkB,CAAA;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,gBAAqB;IAEvD,OAAO;IACP,KAAK;IACL,UAAU;IACV,MAAM;IACN,MAAM;IACN,WAAW;IACX,SAAS;IACT,iBAAiB;IACjB,aAAa;IACb,mBAAmB;IACnB,YAAY;IAKZ,SAAS;EAEZ"}