@barefootjs/mojolicious 0.6.1 → 0.7.0

package/dist/adapter/index.js

@@ -1,4 +1,5 @@
 // src/adapter/mojo-adapter.ts
+import ts from "typescript";
 import {
   BaseAdapter,
   isBooleanAttr,
@@ -80,6 +81,22 @@ function resolveJsxChildrenProp(props) {
     return [];
   return prop.value.children;
 }
+function parsePureStringLiteral(source) {
+  const sf = ts.createSourceFile("__const.ts", `const __x = (${source});`, ts.ScriptTarget.Latest, false);
+  const stmt = sf.statements[0];
+  if (!stmt || !ts.isVariableStatement(stmt))
+    return null;
+  const decl = stmt.declarationList.declarations[0];
+  let init = decl?.initializer;
+  while (init && ts.isParenthesizedExpression(init))
+    init = init.expression;
+  if (!init)
+    return null;
+  if (ts.isStringLiteral(init) || ts.isNoSubstitutionTemplateLiteral(init)) {
+    return init.text;
+  }
+  return null;
+}
 
 class MojoAdapter extends BaseAdapter {
   name = "mojolicious";
@@ -94,6 +111,8 @@ class MojoAdapter extends BaseAdapter {
   propsObjectName = null;
   propsParams = [];
   stringValueNames = new Set;
+  moduleStringConsts = new Map;
+  loopBoundNames = new Map;
   constructor(options = {}) {
     super();
     this.options = {
@@ -115,6 +134,8 @@ class MojoAdapter extends BaseAdapter {
       if (isStringTypeInfo(p.type))
         this.stringValueNames.add(p.name);
     }
+    this.moduleStringConsts = this.collectModuleStringConsts(ir.metadata.localConstants);
+    this.loopBoundNames.clear();
     this.errors = [];
     this.childrenCaptureCounter = 0;
     if (!options?.siblingTemplatesRegistered) {
@@ -139,6 +160,27 @@ class MojoAdapter extends BaseAdapter {
       extension: this.extension
     };
   }
+  collectModuleStringConsts(constants) {
+    const map = new Map;
+    for (const c of constants ?? []) {
+      if (!c.isModule)
+        continue;
+      if (c.value === undefined)
+        continue;
+      const literal = parsePureStringLiteral(c.value);
+      if (literal !== null)
+        map.set(c.name, literal);
+    }
+    return map;
+  }
+  resolveModuleStringConst(name) {
+    if (this.loopBoundNames.has(name))
+      return null;
+    const value = this.moduleStringConsts.get(name);
+    if (value === undefined)
+      return null;
+    return `'${value.replace(/[\\']/g, (m) => `\\${m}`)}'`;
+  }
   generateScriptRegistrations(ir, scriptBaseName) {
     const hasInteractivity = this.hasClientInteractivity(ir);
     if (!hasInteractivity)
@@ -405,6 +447,10 @@ ${whenTrue}
     }
     const param = loop.param;
     const indexVar = loop.iterationShape === "keys" ? `$${param}` : loop.index ? `$${loop.index}` : "$_i";
+    const loopBound = loop.iterationShape === "keys" ? [param] : [param, loop.index ?? "_i"];
+    for (const n of loopBound) {
+      this.loopBoundNames.set(n, (this.loopBoundNames.get(n) ?? 0) + 1);
+    }
     const prevInLoop = this.inLoop;
     this.inLoop = true;
     const renderedChildren = this.renderChildren(loop.children);
@@ -438,6 +484,13 @@ ${renderedChildren}` : renderedChildren;
     } else {
       lines.push(children);
     }
+    for (const n of loopBound) {
+      const c = (this.loopBoundNames.get(n) ?? 1) - 1;
+      if (c <= 0)
+        this.loopBoundNames.delete(n);
+      else
+        this.loopBoundNames.set(n, c);
+    }
     lines.push(`% }`);
     lines.push(`<%== bf->comment("/loop:${loop.markerId}") %>`);
     return lines.join(`
@@ -1056,6 +1109,9 @@ class MojoTopLevelEmitter {
     this.adapter = adapter;
   }
   identifier(name) {
+    const inlined = this.adapter.resolveModuleStringConst(name);
+    if (inlined !== null)
+      return inlined;
     return `$${name}`;
   }
   literal(value, literalType) {

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

@@ -58,8 +58,45 @@ export declare class MojoAdapter extends BaseAdapter implements IRNodeEmitter<Mo
      * true — selecting the string operator from the operand's type avoids that.
      */
     private stringValueNames;
+    /**
+     * Module-scope pure string-literal constants (`const X = 'literal'` at
+     * file top-level), keyed by name → resolved literal value. Populated at
+     * `generate()` entry from `ir.metadata.localConstants`. When an identifier
+     * in an expression resolves to one of these, the adapter inlines the
+     * literal instead of emitting `$X` against a stash variable that is never
+     * bound (a module const isn't a prop, signal, or local — the value would
+     * render empty). Hono inlines it for free; this restores parity. Only
+     * module-scope pure string literals qualify (see `collectModuleStringConsts`).
+     */
+    private moduleStringConsts;
+    /**
+     * Names currently bound by an enclosing loop body — the `my $<param>` and
+     * `my $<index>` bindings `renderLoop` introduces — ref-counted so nested
+     * loops compose. `resolveModuleStringConst` consults this so a loop
+     * variable whose name happens to match a module string const is NOT
+     * inlined as the const literal (mirrors the Go adapter's loop-param /
+     * loop-var shadowing guards). (#1749 review)
+     */
+    private loopBoundNames;
     constructor(options?: MojoAdapterOptions);
     generate(ir: ComponentIR, options?: AdapterGenerateOptions): AdapterOutput;
+    /**
+     * Build the module pure-string-const map from the IR's localConstants.
+     * A const qualifies only when it is module-scope (`isModule`) and its
+     * initializer parses to a single string literal (`ts.StringLiteral` or
+     * `ts.NoSubstitutionTemplateLiteral`). Template literals with `${}`,
+     * numeric/object initializers, `Record<T,string>` maps, memos, and
+     * signals are all excluded — only a pure compile-time string can be
+     * inlined byte-for-byte.
+     */
+    private collectModuleStringConsts;
+    /**
+     * Resolve an identifier to its inlined Perl single-quoted string literal
+     * when it names a module pure-string const, else `null` (the caller then
+     * falls back to its normal `$name` stash lowering). Returns the Perl
+     * literal form `'<escaped>'` ready to drop into an expression.
+     */
+    resolveModuleStringConst(name: string): string | null;
     private generateScriptRegistrations;
     private hasClientInteractivity;
     /**

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

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

package/dist/build.js

@@ -1,4 +1,5 @@
 // src/adapter/mojo-adapter.ts
+import ts from "typescript";
 import {
   BaseAdapter,
   isBooleanAttr,
@@ -80,6 +81,22 @@ function resolveJsxChildrenProp(props) {
     return [];
   return prop.value.children;
 }
+function parsePureStringLiteral(source) {
+  const sf = ts.createSourceFile("__const.ts", `const __x = (${source});`, ts.ScriptTarget.Latest, false);
+  const stmt = sf.statements[0];
+  if (!stmt || !ts.isVariableStatement(stmt))
+    return null;
+  const decl = stmt.declarationList.declarations[0];
+  let init = decl?.initializer;
+  while (init && ts.isParenthesizedExpression(init))
+    init = init.expression;
+  if (!init)
+    return null;
+  if (ts.isStringLiteral(init) || ts.isNoSubstitutionTemplateLiteral(init)) {
+    return init.text;
+  }
+  return null;
+}
 
 class MojoAdapter extends BaseAdapter {
   name = "mojolicious";
@@ -94,6 +111,8 @@ class MojoAdapter extends BaseAdapter {
   propsObjectName = null;
   propsParams = [];
   stringValueNames = new Set;
+  moduleStringConsts = new Map;
+  loopBoundNames = new Map;
   constructor(options = {}) {
     super();
     this.options = {
@@ -115,6 +134,8 @@ class MojoAdapter extends BaseAdapter {
       if (isStringTypeInfo(p.type))
         this.stringValueNames.add(p.name);
     }
+    this.moduleStringConsts = this.collectModuleStringConsts(ir.metadata.localConstants);
+    this.loopBoundNames.clear();
     this.errors = [];
     this.childrenCaptureCounter = 0;
     if (!options?.siblingTemplatesRegistered) {
@@ -139,6 +160,27 @@ class MojoAdapter extends BaseAdapter {
       extension: this.extension
     };
   }
+  collectModuleStringConsts(constants) {
+    const map = new Map;
+    for (const c of constants ?? []) {
+      if (!c.isModule)
+        continue;
+      if (c.value === undefined)
+        continue;
+      const literal = parsePureStringLiteral(c.value);
+      if (literal !== null)
+        map.set(c.name, literal);
+    }
+    return map;
+  }
+  resolveModuleStringConst(name) {
+    if (this.loopBoundNames.has(name))
+      return null;
+    const value = this.moduleStringConsts.get(name);
+    if (value === undefined)
+      return null;
+    return `'${value.replace(/[\\']/g, (m) => `\\${m}`)}'`;
+  }
   generateScriptRegistrations(ir, scriptBaseName) {
     const hasInteractivity = this.hasClientInteractivity(ir);
     if (!hasInteractivity)
@@ -405,6 +447,10 @@ ${whenTrue}
     }
     const param = loop.param;
     const indexVar = loop.iterationShape === "keys" ? `$${param}` : loop.index ? `$${loop.index}` : "$_i";
+    const loopBound = loop.iterationShape === "keys" ? [param] : [param, loop.index ?? "_i"];
+    for (const n of loopBound) {
+      this.loopBoundNames.set(n, (this.loopBoundNames.get(n) ?? 0) + 1);
+    }
     const prevInLoop = this.inLoop;
     this.inLoop = true;
     const renderedChildren = this.renderChildren(loop.children);
@@ -438,6 +484,13 @@ ${renderedChildren}` : renderedChildren;
     } else {
       lines.push(children);
     }
+    for (const n of loopBound) {
+      const c = (this.loopBoundNames.get(n) ?? 1) - 1;
+      if (c <= 0)
+        this.loopBoundNames.delete(n);
+      else
+        this.loopBoundNames.set(n, c);
+    }
     lines.push(`% }`);
     lines.push(`<%== bf->comment("/loop:${loop.markerId}") %>`);
     return lines.join(`
@@ -1056,6 +1109,9 @@ class MojoTopLevelEmitter {
     this.adapter = adapter;
   }
   identifier(name) {
+    const inlined = this.adapter.resolveModuleStringConst(name);
+    if (inlined !== null)
+      return inlined;
     return `$${name}`;
   }
   literal(value, literalType) {

package/dist/index.js

@@ -1,4 +1,5 @@
 // src/adapter/mojo-adapter.ts
+import ts from "typescript";
 import {
   BaseAdapter,
   isBooleanAttr,
@@ -80,6 +81,22 @@ function resolveJsxChildrenProp(props) {
     return [];
   return prop.value.children;
 }
+function parsePureStringLiteral(source) {
+  const sf = ts.createSourceFile("__const.ts", `const __x = (${source});`, ts.ScriptTarget.Latest, false);
+  const stmt = sf.statements[0];
+  if (!stmt || !ts.isVariableStatement(stmt))
+    return null;
+  const decl = stmt.declarationList.declarations[0];
+  let init = decl?.initializer;
+  while (init && ts.isParenthesizedExpression(init))
+    init = init.expression;
+  if (!init)
+    return null;
+  if (ts.isStringLiteral(init) || ts.isNoSubstitutionTemplateLiteral(init)) {
+    return init.text;
+  }
+  return null;
+}
 
 class MojoAdapter extends BaseAdapter {
   name = "mojolicious";
@@ -94,6 +111,8 @@ class MojoAdapter extends BaseAdapter {
   propsObjectName = null;
   propsParams = [];
   stringValueNames = new Set;
+  moduleStringConsts = new Map;
+  loopBoundNames = new Map;
   constructor(options = {}) {
     super();
     this.options = {
@@ -115,6 +134,8 @@ class MojoAdapter extends BaseAdapter {
       if (isStringTypeInfo(p.type))
         this.stringValueNames.add(p.name);
     }
+    this.moduleStringConsts = this.collectModuleStringConsts(ir.metadata.localConstants);
+    this.loopBoundNames.clear();
     this.errors = [];
     this.childrenCaptureCounter = 0;
     if (!options?.siblingTemplatesRegistered) {
@@ -139,6 +160,27 @@ class MojoAdapter extends BaseAdapter {
       extension: this.extension
     };
   }
+  collectModuleStringConsts(constants) {
+    const map = new Map;
+    for (const c of constants ?? []) {
+      if (!c.isModule)
+        continue;
+      if (c.value === undefined)
+        continue;
+      const literal = parsePureStringLiteral(c.value);
+      if (literal !== null)
+        map.set(c.name, literal);
+    }
+    return map;
+  }
+  resolveModuleStringConst(name) {
+    if (this.loopBoundNames.has(name))
+      return null;
+    const value = this.moduleStringConsts.get(name);
+    if (value === undefined)
+      return null;
+    return `'${value.replace(/[\\']/g, (m) => `\\${m}`)}'`;
+  }
   generateScriptRegistrations(ir, scriptBaseName) {
     const hasInteractivity = this.hasClientInteractivity(ir);
     if (!hasInteractivity)
@@ -405,6 +447,10 @@ ${whenTrue}
     }
     const param = loop.param;
     const indexVar = loop.iterationShape === "keys" ? `$${param}` : loop.index ? `$${loop.index}` : "$_i";
+    const loopBound = loop.iterationShape === "keys" ? [param] : [param, loop.index ?? "_i"];
+    for (const n of loopBound) {
+      this.loopBoundNames.set(n, (this.loopBoundNames.get(n) ?? 0) + 1);
+    }
     const prevInLoop = this.inLoop;
     this.inLoop = true;
     const renderedChildren = this.renderChildren(loop.children);
@@ -438,6 +484,13 @@ ${renderedChildren}` : renderedChildren;
     } else {
       lines.push(children);
     }
+    for (const n of loopBound) {
+      const c = (this.loopBoundNames.get(n) ?? 1) - 1;
+      if (c <= 0)
+        this.loopBoundNames.delete(n);
+      else
+        this.loopBoundNames.set(n, c);
+    }
     lines.push(`% }`);
     lines.push(`<%== bf->comment("/loop:${loop.markerId}") %>`);
     return lines.join(`
@@ -1056,6 +1109,9 @@ class MojoTopLevelEmitter {
     this.adapter = adapter;
   }
   identifier(name) {
+    const inlined = this.adapter.resolveModuleStringConst(name);
+    if (inlined !== null)
+      return inlined;
     return `$${name}`;
   }
   literal(value, literalType) {

package/dist/test-render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-render.d.ts","sourceRoot":"","sources":["../src/test-render.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKxE;AAkCD,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,OAAO,EAAE,OAAO,iBAAiB,EAAE,eAAe,CAAA;IAClD,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACpC;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA2MjF;AAgND;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAuBT"}
+{"version":3,"file":"test-render.d.ts","sourceRoot":"","sources":["../src/test-render.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKxE;AAkCD,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,OAAO,EAAE,OAAO,iBAAiB,EAAE,eAAe,CAAA;IAClD,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACpC;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA2MjF;AAsOD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAuBT"}

package/lib/BarefootJS/Backend/Mojo.pm

@@ -0,0 +1,91 @@
+package BarefootJS::Backend::Mojo;
+our $VERSION = "0.01";
+use Mojo::Base -base, -signatures;
+
+use Mojo::ByteStream qw(b);
+use Mojo::JSON qw(to_json);
+use Scalar::Util qw(weaken);
+
+# ---------------------------------------------------------------------------
+# Reference rendering backend (Mojolicious / Mojo::Template).
+# ---------------------------------------------------------------------------
+#
+# BarefootJS.pm holds all the template-engine-agnostic logic (the JS-compat
+# value helpers, array/string methods, hydration markers). Everything that is
+# specific to *how a template is rendered* — JSON marshalling, raw-string
+# marking, JSX-children materialisation, and named-template rendering — lives
+# behind this backend object so the same runtime can drive a different Perl
+# template engine (Text::Xslate, Template Toolkit, …) without rewriting the
+# helper surface.
+#
+# A backend MUST implement:
+#   - encode_json($data)            -> string
+#   - mark_raw($str)                -> value the engine emits without escaping
+#   - materialize($value)           -> string (resolve a captured-children ref)
+#   - render_named($name, $bf, \%vars) -> string
+#
+# This Mojo implementation is the reference. To target another engine, write a
+# sibling backend (BarefootJS::Backend::Xslate, …) implementing the same four
+# methods and pass it via `BarefootJS->new($c, { backend => $b })`.
+
+# The Mojolicious controller. Optional: the value-marshalling helpers
+# (`encode_json` / `mark_raw` / `materialize`) work without it; only
+# `render_named` reaches into the controller's renderer + stash.
+has 'c';
+
+# Pluggable JSON encoder (#engine-abstraction). Defaults to
+# `Mojo::JSON::to_json`, which returns a *character* string (not bytes)
+# suitable for embedding in HTML output via `<%==` / Mojo::ByteStream.
+#
+# Override with any `sub ($data) { ... }` to swap in a faster XS encoder —
+# e.g. `json_encoder => sub { Cpanel::JSON::XS->new->canonical->encode($_[0]) }`.
+# The pure-Perl JSON::PP fallback Mojo::JSON uses can be a hot spot for large
+# props payloads; the seam lets a host pick its own implementation without
+# touching the runtime.
+has 'json_encoder' => sub { \&to_json };
+
+# Hold the controller weakly for the same reason BarefootJS does: the
+# controller owns the bf instance (which owns this backend) via its stash,
+# so a strong back-reference would close a per-request cycle the refcount GC
+# can't reclaim. `render_named` only touches `$self->c` mid-render, while the
+# controller is still alive on the request stack.
+sub new ($class, %args) {
+    my $self = $class->SUPER::new(%args);
+    weaken($self->{c}) if $self->{c};
+    return $self;
+}
+
+sub encode_json ($self, $data) {
+    return $self->json_encoder->($data);
+}
+
+# Mark a string as already-safe so the template engine emits it verbatim
+# (no re-escaping). In Mojo this is a Mojo::ByteStream, which the calling
+# template's `<%==` raw-emit passes through unescaped.
+sub mark_raw ($self, $str) {
+    return b($str);
+}
+
+# JSX children / async fallbacks arrive via Mojo's `begin %>...<% end`
+# capture, which produces a CODE ref returning a Mojo::ByteStream. Resolve
+# it to a string before embedding. Plain (already-rendered) strings pass
+# through unchanged.
+sub materialize ($self, $value) {
+    return ref($value) eq 'CODE' ? $value->() : $value;
+}
+
+# Render a named template with `$child_bf` bound as the active runtime
+# instance for that render. The Mojo `bf` helper resolves the current
+# instance off `$c->stash->{'bf.instance'}`; swap it for the duration of
+# the nested render and restore it afterwards so sibling renders are
+# unaffected.
+sub render_named ($self, $template_name, $child_bf, $vars) {
+    my $c = $self->c;
+    my $prev = $c->stash->{'bf.instance'};
+    $c->stash->{'bf.instance'} = $child_bf;
+    my $html = $c->render_to_string(template => $template_name, %$vars);
+    $c->stash->{'bf.instance'} = $prev;
+    return $html;
+}
+
+1;

package/lib/Mojolicious/Plugin/BarefootJS/DevReload.pm

@@ -1,4 +1,5 @@
 package Mojolicious::Plugin::BarefootJS::DevReload;
+our $VERSION = "0.01";
 use Mojo::Base 'Mojolicious::Plugin', -signatures;
 
 =head1 NAME

package/lib/Mojolicious/Plugin/BarefootJS.pm

@@ -1,4 +1,5 @@
 package Mojolicious::Plugin::BarefootJS;
+our $VERSION = "0.01";
 use Mojo::Base 'Mojolicious::Plugin', -signatures;
 
 use Mojo::File qw(path);
@@ -102,3 +103,58 @@ sub _load_manifest ($app, $config) {
 }
 
 1;
+__END__
+
+=encoding utf8
+
+=head1 NAME
+
+Mojolicious::Plugin::BarefootJS - Mojolicious integration for BarefootJS
+
+=head1 SYNOPSIS
+
+    # Mojolicious application
+    $self->plugin('BarefootJS');
+
+    # In a controller / template, the `bf` helper exposes a per-request
+    # BarefootJS runtime backed by BarefootJS::Backend::Mojo.
+
+=head1 DESCRIPTION
+
+Wires the L<BarefootJS> server runtime into L<Mojolicious>. It registers a
+C<bf> controller helper that lazily instantiates one BarefootJS object per
+request (rendering via L<BarefootJS::Backend::Mojo>), and supports rendering
+compiled marked templates as Mojolicious templates.
+
+For non-Mojolicious / PSGI hosts, see L<BarefootJS::Backend::Xslate>, which
+drives the same runtime with Text::Xslate and no web framework.
+
+=head1 METHODS
+
+L<Mojolicious::Plugin::BarefootJS> inherits all methods from
+L<Mojolicious::Plugin> and implements the following new one.
+
+=head2 register
+
+    $plugin->register(Mojolicious->new, \%conf);
+
+Registers the plugin (the C<bf> helper and supporting hooks) in a Mojolicious
+application.
+
+=head1 SEE ALSO
+
+L<BarefootJS>, L<BarefootJS::Backend::Mojo>, L<BarefootJS::Backend::Xslate>,
+L<Mojolicious>, L<https://github.com/piconic-ai/barefootjs>
+
+=head1 AUTHOR
+
+kobaken E<lt>kentafly88@gmail.comE<gt>
+
+=head1 LICENSE
+
+Copyright (c) 2025-present BarefootJS Contributors.
+
+This library is free software; you can redistribute it and/or modify it under
+the MIT License. See the F<LICENSE> file in the distribution for the full text.
+
+=cut

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barefootjs/mojolicious",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Mojolicious EP template adapter for BarefootJS - generates .html.ep files from IR",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,7 +29,7 @@
   ],
   "scripts": {
     "build": "bun run build:js && bun run build:types",
-    "build:js": "bun build ./src/index.ts ./src/adapter/index.ts ./src/build.ts --root ./src --outdir ./dist --format esm --external @barefootjs/jsx --external @barefootjs/shared",
+    "build:js": "bun build ./src/index.ts ./src/adapter/index.ts ./src/build.ts --root ./src --outdir ./dist --format esm --external @barefootjs/jsx --external @barefootjs/shared --external typescript",
     "build:types": "tsgo --emitDeclarationOnly --outDir ./dist",
     "test": "bun test",
     "clean": "rm -rf dist",
@@ -52,14 +52,15 @@
     "directory": "packages/adapter-mojolicious"
   },
   "dependencies": {
-    "@barefootjs/shared": "0.6.1"
+    "@barefootjs/perl": "0.7.0",
+    "@barefootjs/shared": "0.7.0"
   },
   "peerDependencies": {
-    "@barefootjs/jsx": ">=0.2.0"
+    "@barefootjs/jsx": ">=0.2.0",
+    "typescript": "^5.0.0"
   },
   "devDependencies": {
     "@barefootjs/adapter-tests": "0.1.0",
-    "@barefootjs/jsx": "0.6.1",
-    "typescript": "^5.0.0"
+    "@barefootjs/jsx": "0.7.0"
   }
 }

package/src/__tests__/mojo-adapter.test.ts

@@ -69,16 +69,17 @@ runAdapterConformanceTests({
     'toggle-shared',
     'reactive-props',
     'props-reactivity-comparison',
-    // #1467 Phase 2a: first `site/ui` source-root fixture. Button
-    // compiles cleanly on the Mojo adapter (no diagnostic), but its
-    // variant/size class composition (`Record<…>[key]` indexed object
-    // literals) and `applyRestAttrs` spread haven't been validated for
-    // byte-parity against the Hono reference under Mojo's template
-    // semantics. Cross-adapter parity for the `site/ui` corpus is
-    // explicitly Phase 3 ("cross-adapter parity (Mojo/Go templates)"),
-    // so Button participates only in Hono SSR conformance + the
-    // fixture-hydrate runtime layer for now.
-    'button',
+    // #1467 Phase 2b: basic interactive `site/ui` primitives. Cross-adapter
+    // parity for the `site/ui` corpus is Phase 3, so these participate only
+    // in Hono SSR conformance + the fixture-hydrate runtime layer for now.
+    // (`label` and `kbd` are static helpers; `toggle` / `switch` /
+    // `checkbox` carry uncontrolled state; `input` / `textarea` are
+    // pass-through native controls.)
+    'toggle',
+    'switch',
+    'checkbox',
+    'textarea',
+    'kbd',
   ],
   // Per-fixture build-time contracts for shapes the Mojo adapter
   // intentionally refuses to lower. Owned by this adapter test file
@@ -256,6 +257,42 @@ export function Hello() {
     expect(adapter.extension).toBe('.html.ep')
   })
 
+  test('module pure-string const referenced in className inlines the literal (#1467 Phase 2b)', () => {
+    // A module-scope `const X = 'literal'` used inside a className template
+    // literal must inline its value, NOT emit `$X` against a stash variable
+    // that is never bound (the value would render empty). Hono inlines it at
+    // runtime; this restores byte-parity.
+    const result = compileAndGenerate(`
+"use client"
+const labelClasses = 'flex items-center group-data-[disabled=true]:opacity-50'
+export function Label({ className = '' }: { className?: string }) {
+  return <label className={\`\${labelClasses} \${className}\`} />
+}
+`)
+    // Inlined as a Perl single-quoted literal, escaped tokens intact.
+    expect(result.template).toContain(
+      "'flex items-center group-data-[disabled=true]:opacity-50'",
+    )
+    // No stash-variable reference to the const.
+    expect(result.template).not.toContain('$labelClasses')
+  })
+
+  test('module pure-string const is NOT inlined when shadowed by a loop variable (#1749 review)', () => {
+    // A loop param whose name matches a module const must keep its loop
+    // binding (`$label`) inside the body — the const literal must not leak
+    // in. `renderLoop` guards module-const inlining for the loop body.
+    const result = compileAndGenerate(`
+"use client"
+const label = 'MODULE_CONST'
+export function List({ items }: { items: string[] }) {
+  return <ul>{items.map(label => <li>{label}</li>)}</ul>
+}
+`)
+    // Inside the loop the param wins — emit the loop variable, not the const.
+    expect(result.template).toContain('$label')
+    expect(result.template).not.toContain('MODULE_CONST')
+  })
+
   test('generates conditional with Perl if/else', () => {
     const result = compileAndGenerate(`
 "use client"