@barefootjs/jinja 0.21.3 → 0.23.0

package/dist/index.js

@@ -189196,18 +189196,18 @@ var jinjaAdapter = new JinjaAdapter;
 // src/conformance-pins.ts
 var conformancePins = {
   "static-array-from-props": [
-    { code: "BF101", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2087" }
+    { code: "BF101", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2321" }
   ],
   "static-array-from-props-with-component": [
-    { code: "BF101", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2087" }
+    { code: "BF101", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2321" }
   ],
   "filter-nested-callback-predicate": [
-    { code: "BF101", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2038" }
+    { code: "BF101", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2320" }
   ],
   "filter-nested-find-predicate": [
-    { code: "BF101", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2038" }
+    { code: "BF101", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2320" }
   ],
-  "dangerous-inner-html-dynamic": [{ code: "BF101", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2215" }],
+  "dangerous-inner-html-dynamic": [{ code: "BF101", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2319" }],
   "date-method-uncatalogued": [{ code: "BF021", severity: "error", issue: "https://github.com/piconic-ai/barefootjs/issues/2274" }]
 };
 // src/render-divergences.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barefootjs/jinja",
-  "version": "0.21.3",
+  "version": "0.23.0",
   "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.21.3"
+    "@barefootjs/shared": "0.23.0"
   },
   "peerDependencies": {
     "@barefootjs/jsx": ">=0.2.0"
   },
   "devDependencies": {
     "@barefootjs/adapter-tests": "0.1.0",
-    "@barefootjs/jsx": "0.21.3",
+    "@barefootjs/jsx": "0.23.0",
     "typescript": "^5.0.0"
   }
 }

package/python/barefootjs/runtime.py

@@ -958,6 +958,85 @@ class BarefootJS:
             )
         return 0
 
+    _FORMAT_DATE_TZ_RE = re.compile(r"^([+-])(\d{2}):(\d{2})$")
+    _FORMAT_DATE_TOKEN_RE = re.compile(r"YYYY|MM|DD|M|D")
+
+    def format_date(self, recv: Any, pattern: str, tz: str) -> str:
+        """`format_date(recv, pattern, tz)` -- the lowering target for a
+        `formatDate(date, pattern, timeZone)` call (#2324, spec entry
+        "format_date"). `recv` follows the same receiver contract as `date`
+        above -- this runtime's own `datetime` or an ISO-8601 string; a nil
+        or unparseable receiver renders `''` (never a crash, never "now").
+        Mirrors packages/client/src/format-date.ts byte-for-byte.
+
+        `tz` is `'UTC'` or a fixed offset matching `±HH:MM`. The helper is
+        total: any other value -- an IANA zone name, a malformed offset --
+        normalizes to a zero-minute shift (UTC), so every backend degrades
+        identically instead of dragging in host tzdata. This is pure
+        arithmetic (`_FORMAT_DATE_TZ_RE` + an epoch-ms shift), never
+        `zoneinfo`. The shifted instant's UTC calendar fields are what the
+        pattern tokens read -- the shifted UTC clock face IS the local
+        clock face at that offset. The shift and field derivation run on
+        integers (Hinnant civil-from-days), NOT on a shifted `datetime`:
+        a positive offset on 9999-12-31 lands in year 10000, past
+        `datetime.max`, and must render `10000-…` like the JS reference
+        instead of overflowing (golden vector "positive offset pushes the
+        far-future instant past year 9999").
+
+        `pattern` is scanned longest-match over `YYYY|MM|DD|M|D`
+        (`_FORMAT_DATE_TOKEN_RE`, alternation ordered so the 2/4-char
+        tokens win before their single-char prefixes); every other
+        character -- including multi-byte ones like 年/月/日 -- passes
+        through literally. `YYYY` is `abs(year)` zero-padded to 4 digits,
+        `-`-prefixed for a negative year; `MM`/`DD` zero-pad to 2; `M`/`D`
+        are bare."""
+        if isinstance(recv, datetime.datetime):
+            dt = recv
+        else:
+            s = str(recv)
+            if s.endswith("Z"):
+                s = s[:-1] + "+00:00"
+            try:
+                dt = datetime.datetime.fromisoformat(s)
+            except ValueError:
+                return ""
+        dt = dt.replace(tzinfo=datetime.timezone.utc) if dt.tzinfo is None else dt.astimezone(datetime.timezone.utc)
+        m = self._FORMAT_DATE_TZ_RE.match(tz)
+        offset_minutes = 0
+        if m:
+            offset_minutes = (-1 if m.group(1) == "-" else 1) * (int(m.group(2)) * 60 + int(m.group(3)))
+        delta = dt - _DATE_EPOCH
+        epoch_ms = (delta.days * 86_400 + delta.seconds) * 1_000 + delta.microseconds // 1_000
+        shifted_ms = epoch_ms + offset_minutes * 60_000
+        # Hinnant civil-from-days over Python's floor division (exact for
+        # negative epochs and for days past datetime.max).
+        z = shifted_ms // 86_400_000 + 719_468
+        era = z // 146_097
+        doe = z - era * 146_097
+        yoe = (doe - doe // 1_460 + doe // 36_524 - doe // 146_096) // 365
+        doy = doe - (365 * yoe + yoe // 4 - yoe // 100)
+        mp = (5 * doy + 2) // 153
+        day = doy - (153 * mp + 2) // 5 + 1
+        month = mp + 3 if mp < 10 else mp - 9
+        year = yoe + era * 400 + (1 if month <= 2 else 0)
+        yyyy = ("-" if year < 0 else "") + f"{abs(year):04d}"
+
+        def _sub(match: "re.Match[str]") -> str:
+            token = match.group(0)
+            if token == "YYYY":
+                return yyyy
+            if token == "MM":
+                return f"{month:02d}"
+            if token == "M":
+                return str(month)
+            if token == "DD":
+                return f"{day:02d}"
+            if token == "D":
+                return str(day)
+            return token
+
+        return self._FORMAT_DATE_TOKEN_RE.sub(_sub, pattern)
+
     # -----------------------------------------------------------------
     # Array / String method helpers (#1448 Tier A)
     # -----------------------------------------------------------------

package/python/tests/test_helper_vectors.py

@@ -139,6 +139,7 @@ BINDINGS = {
     "abs": bf.abs,
     "to_fixed": lambda *a: bf.to_fixed(*a),
     "date": lambda recv, op: bf.date(recv, op),
+    "format_date": lambda recv, pattern, tz: bf.format_date(recv, pattern, tz),
     "lower": bf.lc,
     "upper": bf.uc,
     "trim": bf.trim,

package/src/conformance-pins.ts

@@ -42,15 +42,15 @@ export const conformancePins: ConformancePins = {
   // see the "Loop array `<name>` is a local computed value" diagnostic.
   // Fixing the underlying gap (computed-array-from-props as a loop
   // source) is out of scope for #2087; tracked as a follow-up at
-  // https://github.com/piconic-ai/barefootjs/issues/2087.
+  // https://github.com/piconic-ai/barefootjs/issues/2321.
   'static-array-from-props': [
-    { code: 'BF101', severity: 'error', issue: 'https://github.com/piconic-ai/barefootjs/issues/2087' },
+    { code: 'BF101', severity: 'error', issue: 'https://github.com/piconic-ai/barefootjs/issues/2321' },
   ],
   // BF101 (unresolvable computed loop array, see above) fires; BF103
   // (imported child in the loop body) no longer does now that the
   // conformance harness passes `siblingTemplatesRegistered: true` (#2205).
   'static-array-from-props-with-component': [
-    { code: 'BF101', severity: 'error', issue: 'https://github.com/piconic-ai/barefootjs/issues/2087' },
+    { code: 'BF101', severity: 'error', issue: 'https://github.com/piconic-ai/barefootjs/issues/2321' },
   ],
   // Rest-destructure / structured-path `.map()` callbacks (#2087 Phase B):
   // `isLowerableLoopDestructure` now admits fixed bindings at any
@@ -80,12 +80,12 @@ export const conformancePins: ConformancePins = {
   // lossy, same as xslate. The `/* @client */` twin
   // (`filter-nested-callback-predicate-client`) has no pin here: it must
   // render clean on every adapter, which asserts the suppression contract.
-  // https://github.com/piconic-ai/barefootjs/issues/2038
+  // Faithful lowering tracked: https://github.com/piconic-ai/barefootjs/issues/2320 (successor to #2038)
   'filter-nested-callback-predicate': [
-    { code: 'BF101', severity: 'error', issue: 'https://github.com/piconic-ai/barefootjs/issues/2038' },
+    { code: 'BF101', severity: 'error', issue: 'https://github.com/piconic-ai/barefootjs/issues/2320' },
   ],
   'filter-nested-find-predicate': [
-    { code: 'BF101', severity: 'error', issue: 'https://github.com/piconic-ai/barefootjs/issues/2038' },
+    { code: 'BF101', severity: 'error', issue: 'https://github.com/piconic-ai/barefootjs/issues/2320' },
   ],
   // NB: TOP-LEVEL `.find` / `.findIndex` / `.findLast` / `.findLastIndex`
   // (text position) are NOT pinned here — like xslate (unlike mojo, which
@@ -101,8 +101,8 @@ export const conformancePins: ConformancePins = {
   // `dangerouslySetInnerHTML={{ __html: '...' }}` is spliced directly into
   // the template as trusted raw text (`resolveDangerousInnerHtml`, #2207).
   // A dynamic/signal-derived value still refuses with BF101 — see the
-  // `dangerous-inner-html-dynamic` fixture/pin below (tracked: #2215).
-  'dangerous-inner-html-dynamic': [{ code: 'BF101', severity: 'error', issue: 'https://github.com/piconic-ai/barefootjs/issues/2215' }],
+  // `dangerous-inner-html-dynamic` fixture/pin below (tracked: #2319, successor to #2215).
+  'dangerous-inner-html-dynamic': [{ code: 'BF101', severity: 'error', issue: 'https://github.com/piconic-ai/barefootjs/issues/2319' }],
   // #2273: a method call on a prop typed as a built-in host rich type
   // (Date, Map, …) has no catalogued lowering in any adapter — this is a
   // compiler-level refusal (`checkRichTypeMethodCalls`, wired ahead of