@barefootjs/rust 0.18.0 → 0.18.2

package/dist/conformance-pins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conformance-pins.d.ts","sourceRoot":"","sources":["../src/conformance-pins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,eAAO,MAAM,eAAe,EAAE,eAuF7B,CAAA"}
+{"version":3,"file":"conformance-pins.d.ts","sourceRoot":"","sources":["../src/conformance-pins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,eAAO,MAAM,eAAe,EAAE,eAkG7B,CAAA"}

package/dist/index.d.ts

@@ -9,4 +9,5 @@
 export { MinijinjaAdapter, minijinjaAdapter } from './adapter/index.ts';
 export type { MinijinjaAdapterOptions } from './adapter/index.ts';
 export { conformancePins } from './conformance-pins.ts';
+export { renderDivergences } from './render-divergences.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACvE,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACvE,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/index.js

@@ -189103,9 +189103,28 @@ var conformancePins = {
   "filter-nested-find-predicate": [
     { code: "BF101", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2038" }
   ],
-  "array-map-function-reference": [{ code: "BF101", severity: "error" }]
+  "array-map-function-reference": [{ code: "BF101", severity: "error" }],
+  "dangerous-inner-html": [{ code: "BF101", severity: "error" }],
+  "string-replaceall": [{ code: "BF101", severity: "error" }]
+};
+// src/render-divergences.ts
+var renderDivergences = {
+  "arithmetic-text": "`(count() + 2) * 3` renders 10 instead of 18 — the parenthesised sub-expression loses its grouping (silent wrong arithmetic)",
+  "falsy-text-values": '`{false}` renders "false" (Hono drops it); `{null}`/`{undefined}` render empty (Hono renders "null") — neither side matches JSX semantics',
+  "html-entity-text": "`©` in JSX literal text: Hono decodes to `©`, this adapter re-emits the raw entity — same DOM, different bytes",
+  "math-methods": "Math.min/max/abs over a signal render empty (only Math.floor is in the template-primitive registry)",
+  "boolean-attr-literals": 'camelCase boolean alias `readOnly`: Hono SSRs `readOnly="true"`, this adapter emits bare presence',
+  "camelcase-attributes": "`htmlFor` is not lowered to `for` (Hono maps it)",
+  "static-attr-escape": 'static attribute values are not HTML-escaped (`title="Fish & Chips"` emitted raw; Hono escapes)',
+  "svg-icon": "SVG camelCase presentation attrs (`strokeWidth`, `strokeLinecap`) pass through unmapped; Hono lowers to kebab-case",
+  "object-entries-map": "`Object.entries(prop).map(([k, v]) => …)` renders an EMPTY list — the object-shaped prop silently produces zero iterations",
+  "nested-loop-outer-binding": "nested-loop inner items carry `data-key` where the reference emits the depth-suffixed `data-key-1`",
+  "jsx-element-prop": "a JSX element passed as a NON-children prop renders an empty slot — the element value is silently dropped",
+  "string-slice": "`.slice()` on a STRING renders empty (array-slice helper misfires on strings)",
+  "string-trim-sided": "`.trimStart()` / `.trimEnd()` render empty (no lowering)"
 };
 export {
+  renderDivergences,
   minijinjaAdapter,
   conformancePins,
   MinijinjaAdapter

package/dist/render-divergences.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Render-level divergences against the shared conformance corpus
+ * (Priority-12 edge-case sweep, #2168): fixtures that COMPILE clean on
+ * this adapter but whose rendered output diverges from the Hono
+ * reference through the real `bf-render` minijinja binary.
+ * (`string-concat-plus` is NOT here — minijinja's `+` concatenates
+ * strings, unlike Perl/PHP/Twig.)
+ *
+ * Consumed by this package's conformance test (its `skipJsx` set is
+ * derived from these keys, so the skip list and this declaration can't
+ * drift) and by `packages/compat`, which publishes the entries in the
+ * fixture-divergences section of `ui/compat.lock.json` — surfaced on
+ * the docs compatibility-matrix page. Graduating an entry means fixing
+ * the adapter (or the shared compiler layer) and deleting the line.
+ */
+import type { RenderDivergences } from '@barefootjs/jsx';
+export declare const renderDivergences: RenderDivergences;
+//# sourceMappingURL=render-divergences.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render-divergences.d.ts","sourceRoot":"","sources":["../src/render-divergences.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD,eAAO,MAAM,iBAAiB,EAAE,iBA2B/B,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barefootjs/rust",
-  "version": "0.18.0",
+  "version": "0.18.2",
   "description": "minijinja (Rust) adapter for BarefootJS — compiles IR to .j2 templates and ships a Rust rendering runtime (packages/adapter-rust/runtime/); runs under any Rust web framework (axum, etc.)",
   "type": "module",
   "main": "./dist/index.js",
@@ -54,14 +54,14 @@
     "directory": "packages/adapter-rust"
   },
   "dependencies": {
-    "@barefootjs/shared": "0.18.0"
+    "@barefootjs/shared": "0.18.2"
   },
   "peerDependencies": {
     "@barefootjs/jsx": ">=0.2.0"
   },
   "devDependencies": {
     "@barefootjs/adapter-tests": "0.1.0",
-    "@barefootjs/jsx": "0.18.0",
+    "@barefootjs/jsx": "0.18.2",
     "typescript": "^5.0.0"
   }
 }

package/runtime/Cargo.toml

@@ -1,9 +1,14 @@
 [package]
 name = "barefootjs"
+# Placeholder — the crates-release job stamps the @barefootjs/rust version
+# resolved by changesets over this value before `cargo publish`.
 version = "0.1.0"
 edition = "2021"
 description = "Rust runtime for BarefootJS marked templates (minijinja adapter)."
 license = "MIT"
+readme = "README.md"
+homepage = "https://barefootjs.dev"
+repository = "https://github.com/piconic-ai/barefootjs"
 
 [lib]
 name = "barefootjs"

package/runtime/README.md

@@ -0,0 +1,34 @@
+# barefootjs
+
+Rust runtime for [BarefootJS](https://barefootjs.dev/) marked templates, targeting [minijinja](https://crates.io/crates/minijinja).
+
+[BarefootJS](https://github.com/piconic-ai/barefootjs) is a fine-grained reactive TSX compiler: you write components in TSX, and the compiler emits templates for your backend's template engine plus the client-side JS that hydrates them. This crate is the server half for Rust — it renders the templates produced by the `@barefootjs/rust` adapter.
+
+## Installation
+
+```sh
+cargo add barefootjs
+```
+
+## Usage
+
+Build a minijinja environment over the compiled template directory with `backend_minijinja::build_environment`, create a root `BfInstance` for the render (`BfInstance::root`), then render a named component template with `backend_minijinja::render_named`. `load_manifest` / `register_components_from_manifest` wire up the component manifest emitted by the compiler, and a `bf-render` binary is included for rendering from the command line.
+
+Key modules:
+
+| Module | Role |
+|--------|------|
+| `runtime` | the engine-agnostic `bf` object (`BfInstance`, `RenderSession`) |
+| `backend_minijinja` | the minijinja engine backend |
+| `evaluator` | ParsedExpr evaluator for the `*_eval` helpers |
+| `manifest` | component manifest loading and registration |
+| `search_params` | `searchParams()` SSR reader |
+
+## Documentation
+
+- [barefootjs.dev](https://barefootjs.dev/) — core documentation
+- [GitHub: piconic-ai/barefootjs](https://github.com/piconic-ai/barefootjs) — monorepo (this crate lives at `packages/adapter-rust/runtime`)
+
+## License
+
+MIT

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

@@ -20,11 +20,19 @@ import { runAdapterConformanceTests } from '@barefootjs/adapter-tests'
 import { MinijinjaAdapter } from '../adapter'
 import { renderMinijinjaComponent, RustNotAvailableError } from '../test-render'
 import { conformancePins } from '../conformance-pins'
+import { renderDivergences } from '../render-divergences'
 
 runAdapterConformanceTests({
   name: 'minijinja',
   factory: () => new MinijinjaAdapter(),
   render: renderMinijinjaComponent,
+  // Priority-12 edge-case sweep (炙り出し, #2168): render-level
+  // divergences are declared in `../render-divergences` (exported from the
+  // package index and published to `ui/compat.lock.json` / the docs
+  // compatibility-matrix page by `packages/compat`). Deriving the skip
+  // list from that object keeps the public declaration and these test
+  // skips from drifting; each entry's rationale lives there.
+  skipJsx: Object.keys(renderDivergences),
   // Per-fixture build-time contracts for shapes the adapter intentionally
   // refuses to lower. Lives in `../conformance-pins` — mirrors
   // adapter-jinja's set (itself mirroring xslate's); the lowering gates

package/src/conformance-pins.ts

@@ -98,4 +98,15 @@ export const conformancePins: ConformancePins = {
   // "Expression not supported" BF101 rather than emitting a broken
   // template.
   'array-map-function-reference': [{ code: 'BF101', severity: 'error' }],
+  // Edge-case sweep (Priority 12): `dangerouslySetInnerHTML` requires a
+  // deliberate raw-HTML (unescaped) output affordance in the target
+  // template language. No lowering exists yet, so the compiler refuses
+  // the shape loudly instead of emitting entity-escaped markup that
+  // silently renders tags as text.
+  'dangerous-inner-html': [{ code: 'BF101', severity: 'error' }],
+  // Edge-case sweep (Priority 12): `.replaceAll` has no lowering yet —
+  // only first-occurrence `.replace` is wired to the runtime helpers.
+  // Refused with BF101 rather than reusing the first-only lowering,
+  // which would silently change semantics.
+  'string-replaceall': [{ code: 'BF101', severity: 'error' }],
 }

package/src/index.ts

@@ -10,3 +10,4 @@
 export { MinijinjaAdapter, minijinjaAdapter } from './adapter/index.ts'
 export type { MinijinjaAdapterOptions } from './adapter/index.ts'
 export { conformancePins } from './conformance-pins.ts'
+export { renderDivergences } from './render-divergences.ts'

package/src/render-divergences.ts

@@ -0,0 +1,46 @@
+/**
+ * Render-level divergences against the shared conformance corpus
+ * (Priority-12 edge-case sweep, #2168): fixtures that COMPILE clean on
+ * this adapter but whose rendered output diverges from the Hono
+ * reference through the real `bf-render` minijinja binary.
+ * (`string-concat-plus` is NOT here — minijinja's `+` concatenates
+ * strings, unlike Perl/PHP/Twig.)
+ *
+ * Consumed by this package's conformance test (its `skipJsx` set is
+ * derived from these keys, so the skip list and this declaration can't
+ * drift) and by `packages/compat`, which publishes the entries in the
+ * fixture-divergences section of `ui/compat.lock.json` — surfaced on
+ * the docs compatibility-matrix page. Graduating an entry means fixing
+ * the adapter (or the shared compiler layer) and deleting the line.
+ */
+
+import type { RenderDivergences } from '@barefootjs/jsx'
+
+export const renderDivergences: RenderDivergences = {
+  'arithmetic-text':
+    '`(count() + 2) * 3` renders 10 instead of 18 — the parenthesised sub-expression loses its grouping (silent wrong arithmetic)',
+  'falsy-text-values':
+    '`{false}` renders "false" (Hono drops it); `{null}`/`{undefined}` render empty (Hono renders "null") — neither side matches JSX semantics',
+  'html-entity-text':
+    '`©` in JSX literal text: Hono decodes to `©`, this adapter re-emits the raw entity — same DOM, different bytes',
+  'math-methods':
+    'Math.min/max/abs over a signal render empty (only Math.floor is in the template-primitive registry)',
+  'boolean-attr-literals':
+    'camelCase boolean alias `readOnly`: Hono SSRs `readOnly="true"`, this adapter emits bare presence',
+  'camelcase-attributes':
+    '`htmlFor` is not lowered to `for` (Hono maps it)',
+  'static-attr-escape':
+    'static attribute values are not HTML-escaped (`title="Fish & Chips"` emitted raw; Hono escapes)',
+  'svg-icon':
+    'SVG camelCase presentation attrs (`strokeWidth`, `strokeLinecap`) pass through unmapped; Hono lowers to kebab-case',
+  'object-entries-map':
+    '`Object.entries(prop).map(([k, v]) => …)` renders an EMPTY list — the object-shaped prop silently produces zero iterations',
+  'nested-loop-outer-binding':
+    'nested-loop inner items carry `data-key` where the reference emits the depth-suffixed `data-key-1`',
+  'jsx-element-prop':
+    'a JSX element passed as a NON-children prop renders an empty slot — the element value is silently dropped',
+  'string-slice':
+    '`.slice()` on a STRING renders empty (array-slice helper misfires on strings)',
+  'string-trim-sided':
+    '`.trimStart()` / `.trimEnd()` render empty (no lowering)',
+}