@barefootjs/jinja 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;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,eAAO,MAAM,eAAe,EAAE,eAwF7B,CAAA"}
+{"version":3,"file":"conformance-pins.d.ts","sourceRoot":"","sources":["../src/conformance-pins.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,eAAO,MAAM,eAAe,EAAE,eAmG7B,CAAA"}

package/dist/index.d.ts

@@ -6,4 +6,5 @@
 export { JinjaAdapter, jinjaAdapter } from './adapter/index.ts';
 export type { JinjaAdapterOptions } 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;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAC/D,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAC/D,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/index.js

@@ -189109,9 +189109,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,
   jinjaAdapter,
   conformancePins,
   JinjaAdapter

package/dist/render-divergences.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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 on real Python jinja2.
+ *
+ * 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;;;;;;;;;;;;GAYG;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/jinja",
-  "version": "0.18.0",
+  "version": "0.18.2",
   "description": "Jinja2 adapter for BarefootJS — compiles IR to .jinja templates and ships the Python BarefootJS rendering runtime; runs under any Python web framework (Flask, etc.)",
   "type": "module",
   "main": "./dist/index.js",
@@ -53,14 +53,14 @@
     "directory": "packages/adapter-jinja"
   },
   "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/python/README.md

@@ -0,0 +1,43 @@
+# barefootjs
+
+Python runtime for [BarefootJS](https://barefootjs.dev/) marked templates, targeting [Jinja2](https://jinja.palletsprojects.com/).
+
+[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 package is the server half for Python — it renders the `.jinja` templates produced by the `@barefootjs/jinja` adapter.
+
+## Installation
+
+```sh
+pip install barefootjs
+```
+
+The only dependency is `jinja2`; everything else is stdlib.
+
+## Quick start
+
+Generated `.jinja` templates call the `BarefootJS` instance as a `bf` object (`{{ bf.scope_attr() }}`, `{{ bf.json(x) }}`, `{{ bf.spread_attrs(bag) }}`):
+
+```python
+from barefootjs import BarefootJS, JinjaBackend
+
+backend = JinjaBackend(paths=["templates"])
+bf = BarefootJS(None, {"backend": backend})
+html = backend.render_named("counter", bf, {"count": 0})
+```
+
+## Package layout
+
+| Module | Role |
+|--------|------|
+| `runtime.py` | the engine-agnostic `bf` object |
+| `evaluator.py` | ParsedExpr evaluator for the `*_eval` helpers |
+| `search_params.py` | `searchParams()` SSR reader |
+| `backend_jinja.py` | the Jinja2 engine backend |
+
+## Documentation
+
+- [barefootjs.dev](https://barefootjs.dev/) — core documentation
+- [GitHub: piconic-ai/barefootjs](https://github.com/piconic-ai/barefootjs) — monorepo (this package lives at `packages/adapter-jinja/python`)
+
+## License
+
+MIT

package/python/pyproject.toml

@@ -6,6 +6,7 @@ build-backend = "setuptools.build_meta"
 name = "barefootjs"
 dynamic = ["version"]
 description = "Python runtime for the @barefootjs/jinja adapter"
+readme = "README.md"
 license = {text = "MIT"}
 requires-python = ">=3.10"
 authors = [{ name = "kobaken", email = "kentafly88@gmail.com" }]

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

@@ -16,11 +16,19 @@ import { runAdapterConformanceTests } from '@barefootjs/adapter-tests'
 import { JinjaAdapter } from '../adapter'
 import { renderJinjaComponent, PythonNotAvailableError } from '../test-render'
 import { conformancePins } from '../conformance-pins'
+import { renderDivergences } from '../render-divergences'
 
 runAdapterConformanceTests({
   name: 'jinja',
   factory: () => new JinjaAdapter(),
   render: renderJinjaComponent,
+  // 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 Jinja adapter
   // intentionally refuses to lower. Lives in `../conformance-pins` —
   // mirrors xslate's set (the lowering gates are shared code paths in

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

@@ -7,3 +7,4 @@
 export { JinjaAdapter, jinjaAdapter } from './adapter/index.ts'
 export type { JinjaAdapterOptions } from './adapter/index.ts'
 export { conformancePins } from './conformance-pins.ts'
+export { renderDivergences } from './render-divergences.ts'

package/src/render-divergences.ts

@@ -0,0 +1,44 @@
+/**
+ * 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 on real Python jinja2.
+ *
+ * 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)',
+}