@barefootjs/mojolicious 0.7.0 → 0.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present BarefootJS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/adapter/index.js

@@ -8,7 +8,10 @@ import {
   identifierPath,
   emitParsedExpr,
   emitIRNode,
-  emitAttrValue
+  emitAttrValue,
+  augmentInheritedPropAccesses,
+  parseRecordIndexAccess,
+  evalStringArrayJoin
 } from "@barefootjs/jsx";
 
 // src/adapter/boolean-result.ts
@@ -95,7 +98,10 @@ function parsePureStringLiteral(source) {
   if (ts.isStringLiteral(init) || ts.isNoSubstitutionTemplateLiteral(init)) {
     return init.text;
   }
-  return null;
+  return evalStringArrayJoin(source);
+}
+function perlHashKey(name) {
+  return /^[A-Za-z_][A-Za-z0-9_]*$/.test(name) ? name : `'${name.replace(/'/g, "\\'")}'`;
 }
 
 class MojoAdapter extends BaseAdapter {
@@ -112,7 +118,9 @@ class MojoAdapter extends BaseAdapter {
   propsParams = [];
   stringValueNames = new Set;
   moduleStringConsts = new Map;
+  localConstants = [];
   loopBoundNames = new Map;
+  nullableOptionalProps = new Set;
   constructor(options = {}) {
     super();
     this.options = {
@@ -123,7 +131,9 @@ class MojoAdapter extends BaseAdapter {
   generate(ir, options) {
     this.componentName = ir.metadata.componentName;
     this.propsObjectName = ir.metadata.propsObjectName ?? null;
+    augmentInheritedPropAccesses(ir);
     this.propsParams = ir.metadata.propsParams.map((p) => ({ name: p.name }));
+    this.nullableOptionalProps = new Set(ir.metadata.propsParams.filter((p) => p.defaultValue === undefined && !p.isRest && p.type?.kind !== "primitive").map((p) => p.name));
     this.stringValueNames = new Set;
     for (const s of ir.metadata.signals) {
       if (isStringTypeInfo(s.type) || isBareStringLiteral(s.initialValue)) {
@@ -135,6 +145,7 @@ class MojoAdapter extends BaseAdapter {
         this.stringValueNames.add(p.name);
     }
     this.moduleStringConsts = this.collectModuleStringConsts(ir.metadata.localConstants);
+    this.localConstants = ir.metadata.localConstants ?? [];
     this.loopBoundNames.clear();
     this.errors = [];
     this.childrenCaptureCounter = 0;
@@ -497,20 +508,20 @@ ${renderedChildren}` : renderedChildren;
 `);
   }
   componentPropEmitter = {
-    emitLiteral: (value, name) => `${name} => '${value.value}'`,
+    emitLiteral: (value, name) => `${perlHashKey(name)} => '${value.value}'`,
     emitExpression: (value, name) => {
       if (value.parts) {
-        return `${name} => ${this.convertTemplateLiteralPartsToPerl(value.parts)}`;
+        return `${perlHashKey(name)} => ${this.convertTemplateLiteralPartsToPerl(value.parts)}`;
       }
-      return `${name} => ${this.convertExpressionToPerl(value.expr)}`;
+      return `${perlHashKey(name)} => ${this.convertExpressionToPerl(value.expr)}`;
     },
     emitSpread: (value) => {
       const perlExpr = this.convertExpressionToPerl(value.expr);
       return perlExpr.startsWith("%") ? perlExpr : `%{${perlExpr}}`;
     },
-    emitTemplate: (value, name) => `${name} => ${this.convertTemplateLiteralPartsToPerl(value.parts)}`,
-    emitBooleanAttr: (_value, name) => `${name} => 1`,
-    emitBooleanShorthand: (_value, name) => `${name} => 1`,
+    emitTemplate: (value, name) => `${perlHashKey(name)} => ${this.convertTemplateLiteralPartsToPerl(value.parts)}`,
+    emitBooleanAttr: (_value, name) => `${perlHashKey(name)} => 1`,
+    emitBooleanShorthand: (_value, name) => `${perlHashKey(name)} => 1`,
     emitJsxChildren: () => ""
   };
   renderComponent(comp) {
@@ -582,6 +593,13 @@ ${children}`;
       if (this.refuseUnsupportedAttrExpression(value.expr, name)) {
         return "";
       }
+      const bareId = value.expr.trim();
+      const normalizedBareId = this.propsObjectName && bareId.startsWith(`${this.propsObjectName}.`) ? bareId.slice(this.propsObjectName.length + 1) : bareId;
+      if (!isBooleanAttr(name) && !value.presenceOrUndefined && /^[A-Za-z_$][\w$]*$/.test(normalizedBareId) && this.nullableOptionalProps.has(normalizedBareId)) {
+        const perl2 = this.convertExpressionToPerl(value.expr);
+        const body = isBooleanResultExpr(value.expr) || isAriaBooleanAttr(name) ? `${name}="<%= bf->bool_str(${perl2}) %>"` : `${name}="<%= ${perl2} %>"`;
+        return `<% if (defined ${perl2}) { %>${body}<% } %>`;
+      }
       if (isBooleanAttr(name) || value.presenceOrUndefined) {
         return `<%= ${this.convertExpressionToPerl(value.expr)} ? '${name}' : '' %>`;
       }
@@ -602,6 +620,22 @@ ${children}`;
         const entries = this.propsParams.map((p) => `${JSON.stringify(p.name)} => $${p.name}`);
         return `<%== bf->spread_attrs({${entries.join(", ")}}) %>`;
       }
+      const ternaryHashref = this.conditionalSpreadToPerl(trimmed);
+      if (ternaryHashref !== null) {
+        return `<%== bf->spread_attrs(${ternaryHashref}) %>`;
+      }
+      if (/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(trimmed)) {
+        const localConst = this.localConstants.find((c) => c.name === trimmed && !c.isModule);
+        if (localConst?.value !== undefined) {
+          const initTrimmed = localConst.value.trim();
+          if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(initTrimmed)) {
+            const resolved = this.conditionalSpreadToPerl(initTrimmed);
+            if (resolved !== null) {
+              return `<%== bf->spread_attrs(${resolved}) %>`;
+            }
+          }
+        }
+      }
       const perlExpr = this.convertExpressionToPerl(value.expr);
       return `<%== bf->spread_attrs(${perlExpr}) %>`;
     },
@@ -766,6 +800,71 @@ ${reason}` : "";
     });
     return true;
   }
+  conditionalSpreadToPerl(expr) {
+    const sf = ts.createSourceFile("__spread.ts", `(${expr})`, ts.ScriptTarget.Latest, true);
+    if (sf.statements.length !== 1)
+      return null;
+    const stmt = sf.statements[0];
+    if (!ts.isExpressionStatement(stmt))
+      return null;
+    let node = stmt.expression;
+    while (ts.isParenthesizedExpression(node))
+      node = node.expression;
+    if (!ts.isConditionalExpression(node))
+      return null;
+    const unwrap = (e) => {
+      let n = e;
+      while (ts.isParenthesizedExpression(n))
+        n = n.expression;
+      return n;
+    };
+    const whenTrue = unwrap(node.whenTrue);
+    const whenFalse = unwrap(node.whenFalse);
+    if (!ts.isObjectLiteralExpression(whenTrue) || !ts.isObjectLiteralExpression(whenFalse)) {
+      return null;
+    }
+    const condPerl = this.convertExpressionToPerl(node.condition.getText(sf));
+    const truePerl = this.objectLiteralToPerlHashref(whenTrue, sf);
+    const falsePerl = this.objectLiteralToPerlHashref(whenFalse, sf);
+    if (truePerl === null || falsePerl === null)
+      return null;
+    return `${condPerl} ? ${truePerl} : ${falsePerl}`;
+  }
+  objectLiteralToPerlHashref(obj, sf) {
+    const entries = [];
+    for (const prop of obj.properties) {
+      if (!ts.isPropertyAssignment(prop))
+        return null;
+      let key;
+      if (ts.isIdentifier(prop.name)) {
+        key = prop.name.text;
+      } else if (ts.isStringLiteral(prop.name) || ts.isNoSubstitutionTemplateLiteral(prop.name)) {
+        key = prop.name.text;
+      } else {
+        return null;
+      }
+      const initNode = (() => {
+        let n = prop.initializer;
+        while (ts.isParenthesizedExpression(n))
+          n = n.expression;
+        return n;
+      })();
+      const indexed = this.recordIndexAccessToPerl(initNode);
+      const valPerl = indexed !== null ? indexed : this.convertExpressionToPerl(prop.initializer.getText(sf));
+      entries.push(`'${key.replace(/'/g, "\\'")}' => ${valPerl}`);
+    }
+    return entries.length === 0 ? "{}" : `{ ${entries.join(", ")} }`;
+  }
+  recordIndexAccessToPerl(val) {
+    const parsed = parseRecordIndexAccess(val, this.localConstants, this.propsParams);
+    if (!parsed)
+      return null;
+    const entries = parsed.entries.map((e) => {
+      const mapVal = e.value.kind === "number" ? e.value.text : `'${e.value.text.replace(/'/g, "\\'")}'`;
+      return `'${e.key.replace(/'/g, "\\'")}' => ${mapVal}`;
+    });
+    return `{ ${entries.join(", ")} }->{$${parsed.indexPropName}}`;
+  }
   convertExpressionToPerl(expr) {
     const trimmed = expr.trim();
     if (trimmed === "")

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

@@ -69,6 +69,14 @@ export declare class MojoAdapter extends BaseAdapter implements IRNodeEmitter<Mo
      * module-scope pure string literals qualify (see `collectModuleStringConsts`).
      */
     private moduleStringConsts;
+    /**
+     * Full local-constant metadata from the entry IR, kept so spread
+     * lowering can resolve a bare-identifier spread (`{...sizeAttrs}`) to
+     * its initializer text and a `Record[propKey]` spread value to the
+     * module-const object literal it indexes (#checkbox / icon). Populated
+     * at `generate()` entry alongside `moduleStringConsts`.
+     */
+    private localConstants;
     /**
      * Names currently bound by an enclosing loop body — the `my $<param>` and
      * `my $<index>` bindings `renderLoop` introduces — ref-counted so nested
@@ -78,6 +86,23 @@ export declare class MojoAdapter extends BaseAdapter implements IRNodeEmitter<Mo
      * loop-var shadowing guards). (#1749 review)
      */
     private loopBoundNames;
+    /**
+     * Prop names whose value is `undef` in the template body when the caller
+     * omits them — so a bare-reference attribute should be dropped rather
+     * than rendered as `attr=""`. The actual population criterion (see
+     * `generate()`) is: NO destructure default (`defaultValue === undefined`)
+     * AND non-rest (`!isRest`) AND non-primitive type (`type.kind !==
+     * 'primitive'`). It deliberately does NOT consult `p.optional`: the
+     * analyzer derives `optional` from the presence of a default initializer,
+     * not the `?` token, so it's not the right witness here. Excluding
+     * concrete primitives (`string`/`number`/`boolean`) mirrors the Go
+     * adapter's scope, which guards only `interface{}` (nillable) fields.
+     * Used by `elementAttrEmitter.emitExpression` to guard such an attribute
+     * with a Perl `defined $x` check (`<textarea>` omits `rows`), matching
+     * Hono's nullish-attribute omission. Concrete/defaulted props are
+     * excluded and always emit unconditionally.
+     */
+    private nullableOptionalProps;
     constructor(options?: MojoAdapterOptions);
     generate(ir: ComponentIR, options?: AdapterGenerateOptions): AdapterOutput;
     /**
@@ -202,6 +227,47 @@ export declare class MojoAdapter extends BaseAdapter implements IRNodeEmitter<Mo
      * should drop the attribute / skip the emit).
      */
     private refuseUnsupportedAttrExpression;
+    /**
+     * Lower a conditional inline-object spread expression
+     *   `(COND ? { 'aria-describedby': describedBy } : {})`
+     * (either branch possibly `{}`) into a Perl inline ternary of
+     * hashrefs for `bf->spread_attrs`:
+     *   `$describedBy ? { 'aria-describedby' => $describedBy } : {}`
+     *
+     * The condition is translated via `convertExpressionToPerl` (a bare
+     * prop ident becomes `$describedBy`; Perl truthiness handles the
+     * test). Object literals become Perl hashrefs with `=>`; string-
+     * literal keys are quoted, values resolve via `convertExpressionToPerl`.
+     *
+     * Returns null when the expression is NOT this shape, or when a part
+     * can't be faithfully lowered (non-static key, etc.) so the caller
+     * falls back to the standard `convertExpressionToPerl` path (which
+     * records BF101). Scoped strictly to ternary-of-object-literals so no
+     * other spread shape regresses.
+     */
+    private conditionalSpreadToPerl;
+    /**
+     * Convert a static object literal into a Perl hashref string for a
+     * conditional spread. Only static string/identifier keys are allowed;
+     * values resolve via `convertExpressionToPerl`. Returns null for any
+     * computed/spread/dynamic key. Empty object → `{}`.
+     */
+    private objectLiteralToPerlHashref;
+    /**
+     * Lower a spread-object VALUE of the form `IDENT[KEY]` where:
+     *   - `IDENT` resolves via `localConstants` to a MODULE-scope object
+     *     literal whose property values are all scalar (number/string)
+     *     literals under static (string-literal or identifier) keys
+     *     (a `Record<staticKeys, scalar>` map like `sizeMap`), AND
+     *   - `KEY` is a bare identifier that is a prop.
+     * Emits an inline indexed Perl hashref:
+     *   `{ 'sm' => 16, 'md' => 20, ... }->{$size}`
+     *
+     * Returns the Perl string when convertible, else `null` so the caller
+     * falls back to its normal value lowering (which records BF101 for an
+     * unsupported shape). Mirror of the Go adapter's `recordIndexAccessToGoMap`.
+     */
+    private recordIndexAccessToPerl;
     private convertExpressionToPerl;
     /**
      * Render a full ParsedExpr tree to Perl for top-level (non-filter)

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":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,WAAW,EAEX,MAAM,EACN,SAAS,EACT,MAAM,EACN,YAAY,EACZ,aAAa,EACb,MAAM,EACN,WAAW,EACX,UAAU,EACV,MAAM,EACN,aAAa,EACb,UAAU,EACV,OAAO,EAMP,yBAAyB,EAC1B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAM3B,KAAK,aAAa,EAClB,KAAK,UAAU,EAUhB,MAAM,iBAAiB,CAAA;AAGxB;;;;;;GAMG;AACH,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAiF,MAAM,iBAAiB,CAAA;AAqDhI,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AA4BD,qBAAa,WAAY,SAAQ,WAAY,YAAW,aAAa,CAAC,aAAa,CAAC;IAClF,IAAI,SAAgB;IACpB,SAAS,SAAa;IACtB,qBAAqB,UAAO;IAG5B,kBAAkB,EAAG,cAAc,CAAS;IAE5C;;;;;;;;;;;OAWG;IACH,kBAAkB,EAAE,yBAAyB,CAA0B;IAEvE,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAiB;IAC/B;;;;;;OAMG;IACH,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,WAAW,CAAyB;IAC5C;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB,CAAyB;IACjD;;;;;;;;;OASG;IACH,OAAO,CAAC,kBAAkB,CAAiC;IAC3D;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc,CAAiC;IAEvD,YAAY,OAAO,GAAE,kBAAuB,EAM3C;IAED,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,aAAa,CAsEzE;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,yBAAyB;IAWjC;;;;;OAKG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOpD;IAMD,OAAO,CAAC,2BAA2B;IAenC,OAAO,CAAC,sBAAsB;IAa9B;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/B;IAMD,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAE1F;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7B;IAED,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAEzC;IAED,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAElG;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAEpF;IAED,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAE9F;IAED,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAE5F;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7B;IAED,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAElG;IAED,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAE5F;IAED,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAEtF;IAMD,aAAa,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAuBxC;IAMD,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAe3C;IAMD,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAsC7C;IAED,OAAO,CAAC,gBAAgB;IAOxB;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAcnC;;;;;OAKG;IACH,OAAO,CAAC,gCAAgC;IA8ExC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuI/B;IAMD;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CA+BpC;IAED,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CA0CzC;IAED,OAAO,CAAC,sBAAsB,CAAI;IAElC,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,UAAU;IAIlB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAgBjC;IAMD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CA8FlC;IAED,OAAO,CAAC,gBAAgB;IA0BxB,iBAAiB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAIjD;IAED,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvC;IAED,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvC;IAMD;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAuBhC,OAAO,CAAC,kBAAkB;IAiC1B,OAAO,CAAC,wBAAwB;IAsBhC,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,iCAAiC;IAmCzC;;;;;;;OAOG;IACH,OAAO,CAAC,gCAAgC;IAmBxC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,+BAA+B;IA+BvC,OAAO,CAAC,uBAAuB;IAqC/B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAI9B;;;;OAIG;IACH;4EACwE;IACxE,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExC;IAED,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAYvD;IAED,iFAAiF;IACjF,2BAA2B,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE;CACF;AAswBD,eAAO,MAAM,WAAW,aAAoB,CAAA"}
+{"version":3,"file":"mojo-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/mojo-adapter.ts"],"names":[],"mappings":"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"}

package/dist/build.js

@@ -8,7 +8,10 @@ import {
   identifierPath,
   emitParsedExpr,
   emitIRNode,
-  emitAttrValue
+  emitAttrValue,
+  augmentInheritedPropAccesses,
+  parseRecordIndexAccess,
+  evalStringArrayJoin
 } from "@barefootjs/jsx";
 
 // src/adapter/boolean-result.ts
@@ -95,7 +98,10 @@ function parsePureStringLiteral(source) {
   if (ts.isStringLiteral(init) || ts.isNoSubstitutionTemplateLiteral(init)) {
     return init.text;
   }
-  return null;
+  return evalStringArrayJoin(source);
+}
+function perlHashKey(name) {
+  return /^[A-Za-z_][A-Za-z0-9_]*$/.test(name) ? name : `'${name.replace(/'/g, "\\'")}'`;
 }
 
 class MojoAdapter extends BaseAdapter {
@@ -112,7 +118,9 @@ class MojoAdapter extends BaseAdapter {
   propsParams = [];
   stringValueNames = new Set;
   moduleStringConsts = new Map;
+  localConstants = [];
   loopBoundNames = new Map;
+  nullableOptionalProps = new Set;
   constructor(options = {}) {
     super();
     this.options = {
@@ -123,7 +131,9 @@ class MojoAdapter extends BaseAdapter {
   generate(ir, options) {
     this.componentName = ir.metadata.componentName;
     this.propsObjectName = ir.metadata.propsObjectName ?? null;
+    augmentInheritedPropAccesses(ir);
     this.propsParams = ir.metadata.propsParams.map((p) => ({ name: p.name }));
+    this.nullableOptionalProps = new Set(ir.metadata.propsParams.filter((p) => p.defaultValue === undefined && !p.isRest && p.type?.kind !== "primitive").map((p) => p.name));
     this.stringValueNames = new Set;
     for (const s of ir.metadata.signals) {
       if (isStringTypeInfo(s.type) || isBareStringLiteral(s.initialValue)) {
@@ -135,6 +145,7 @@ class MojoAdapter extends BaseAdapter {
         this.stringValueNames.add(p.name);
     }
     this.moduleStringConsts = this.collectModuleStringConsts(ir.metadata.localConstants);
+    this.localConstants = ir.metadata.localConstants ?? [];
     this.loopBoundNames.clear();
     this.errors = [];
     this.childrenCaptureCounter = 0;
@@ -497,20 +508,20 @@ ${renderedChildren}` : renderedChildren;
 `);
   }
   componentPropEmitter = {
-    emitLiteral: (value, name) => `${name} => '${value.value}'`,
+    emitLiteral: (value, name) => `${perlHashKey(name)} => '${value.value}'`,
     emitExpression: (value, name) => {
       if (value.parts) {
-        return `${name} => ${this.convertTemplateLiteralPartsToPerl(value.parts)}`;
+        return `${perlHashKey(name)} => ${this.convertTemplateLiteralPartsToPerl(value.parts)}`;
       }
-      return `${name} => ${this.convertExpressionToPerl(value.expr)}`;
+      return `${perlHashKey(name)} => ${this.convertExpressionToPerl(value.expr)}`;
     },
     emitSpread: (value) => {
       const perlExpr = this.convertExpressionToPerl(value.expr);
       return perlExpr.startsWith("%") ? perlExpr : `%{${perlExpr}}`;
     },
-    emitTemplate: (value, name) => `${name} => ${this.convertTemplateLiteralPartsToPerl(value.parts)}`,
-    emitBooleanAttr: (_value, name) => `${name} => 1`,
-    emitBooleanShorthand: (_value, name) => `${name} => 1`,
+    emitTemplate: (value, name) => `${perlHashKey(name)} => ${this.convertTemplateLiteralPartsToPerl(value.parts)}`,
+    emitBooleanAttr: (_value, name) => `${perlHashKey(name)} => 1`,
+    emitBooleanShorthand: (_value, name) => `${perlHashKey(name)} => 1`,
     emitJsxChildren: () => ""
   };
   renderComponent(comp) {
@@ -582,6 +593,13 @@ ${children}`;
       if (this.refuseUnsupportedAttrExpression(value.expr, name)) {
         return "";
       }
+      const bareId = value.expr.trim();
+      const normalizedBareId = this.propsObjectName && bareId.startsWith(`${this.propsObjectName}.`) ? bareId.slice(this.propsObjectName.length + 1) : bareId;
+      if (!isBooleanAttr(name) && !value.presenceOrUndefined && /^[A-Za-z_$][\w$]*$/.test(normalizedBareId) && this.nullableOptionalProps.has(normalizedBareId)) {
+        const perl2 = this.convertExpressionToPerl(value.expr);
+        const body = isBooleanResultExpr(value.expr) || isAriaBooleanAttr(name) ? `${name}="<%= bf->bool_str(${perl2}) %>"` : `${name}="<%= ${perl2} %>"`;
+        return `<% if (defined ${perl2}) { %>${body}<% } %>`;
+      }
       if (isBooleanAttr(name) || value.presenceOrUndefined) {
         return `<%= ${this.convertExpressionToPerl(value.expr)} ? '${name}' : '' %>`;
       }
@@ -602,6 +620,22 @@ ${children}`;
         const entries = this.propsParams.map((p) => `${JSON.stringify(p.name)} => $${p.name}`);
         return `<%== bf->spread_attrs({${entries.join(", ")}}) %>`;
       }
+      const ternaryHashref = this.conditionalSpreadToPerl(trimmed);
+      if (ternaryHashref !== null) {
+        return `<%== bf->spread_attrs(${ternaryHashref}) %>`;
+      }
+      if (/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(trimmed)) {
+        const localConst = this.localConstants.find((c) => c.name === trimmed && !c.isModule);
+        if (localConst?.value !== undefined) {
+          const initTrimmed = localConst.value.trim();
+          if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(initTrimmed)) {
+            const resolved = this.conditionalSpreadToPerl(initTrimmed);
+            if (resolved !== null) {
+              return `<%== bf->spread_attrs(${resolved}) %>`;
+            }
+          }
+        }
+      }
       const perlExpr = this.convertExpressionToPerl(value.expr);
       return `<%== bf->spread_attrs(${perlExpr}) %>`;
     },
@@ -766,6 +800,71 @@ ${reason}` : "";
     });
     return true;
   }
+  conditionalSpreadToPerl(expr) {
+    const sf = ts.createSourceFile("__spread.ts", `(${expr})`, ts.ScriptTarget.Latest, true);
+    if (sf.statements.length !== 1)
+      return null;
+    const stmt = sf.statements[0];
+    if (!ts.isExpressionStatement(stmt))
+      return null;
+    let node = stmt.expression;
+    while (ts.isParenthesizedExpression(node))
+      node = node.expression;
+    if (!ts.isConditionalExpression(node))
+      return null;
+    const unwrap = (e) => {
+      let n = e;
+      while (ts.isParenthesizedExpression(n))
+        n = n.expression;
+      return n;
+    };
+    const whenTrue = unwrap(node.whenTrue);
+    const whenFalse = unwrap(node.whenFalse);
+    if (!ts.isObjectLiteralExpression(whenTrue) || !ts.isObjectLiteralExpression(whenFalse)) {
+      return null;
+    }
+    const condPerl = this.convertExpressionToPerl(node.condition.getText(sf));
+    const truePerl = this.objectLiteralToPerlHashref(whenTrue, sf);
+    const falsePerl = this.objectLiteralToPerlHashref(whenFalse, sf);
+    if (truePerl === null || falsePerl === null)
+      return null;
+    return `${condPerl} ? ${truePerl} : ${falsePerl}`;
+  }
+  objectLiteralToPerlHashref(obj, sf) {
+    const entries = [];
+    for (const prop of obj.properties) {
+      if (!ts.isPropertyAssignment(prop))
+        return null;
+      let key;
+      if (ts.isIdentifier(prop.name)) {
+        key = prop.name.text;
+      } else if (ts.isStringLiteral(prop.name) || ts.isNoSubstitutionTemplateLiteral(prop.name)) {
+        key = prop.name.text;
+      } else {
+        return null;
+      }
+      const initNode = (() => {
+        let n = prop.initializer;
+        while (ts.isParenthesizedExpression(n))
+          n = n.expression;
+        return n;
+      })();
+      const indexed = this.recordIndexAccessToPerl(initNode);
+      const valPerl = indexed !== null ? indexed : this.convertExpressionToPerl(prop.initializer.getText(sf));
+      entries.push(`'${key.replace(/'/g, "\\'")}' => ${valPerl}`);
+    }
+    return entries.length === 0 ? "{}" : `{ ${entries.join(", ")} }`;
+  }
+  recordIndexAccessToPerl(val) {
+    const parsed = parseRecordIndexAccess(val, this.localConstants, this.propsParams);
+    if (!parsed)
+      return null;
+    const entries = parsed.entries.map((e) => {
+      const mapVal = e.value.kind === "number" ? e.value.text : `'${e.value.text.replace(/'/g, "\\'")}'`;
+      return `'${e.key.replace(/'/g, "\\'")}' => ${mapVal}`;
+    });
+    return `{ ${entries.join(", ")} }->{$${parsed.indexPropName}}`;
+  }
   convertExpressionToPerl(expr) {
     const trimmed = expr.trim();
     if (trimmed === "")