@barefootjs/jinja 0.21.4 → 0.24.1

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.4",
+  "version": "0.24.1",
   "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.4"
+    "@barefootjs/shared": "0.24.1"
   },
   "peerDependencies": {
     "@barefootjs/jsx": ">=0.2.0"
   },
   "devDependencies": {
     "@barefootjs/adapter-tests": "0.1.0",
-    "@barefootjs/jsx": "0.21.4",
+    "@barefootjs/jsx": "0.24.1",
     "typescript": "^5.0.0"
   }
 }

package/python/barefootjs/runtime.py

@@ -958,6 +958,133 @@ class BarefootJS:
             )
         return 0
 
+    _FORMAT_DATE_TZ_RE = re.compile(r"^([+-])(\d{2}):(\d{2})$")
+    _FORMAT_DATE_TOKEN_RE = re.compile(r"YYYY|MMMM|MMM|MM|DD|dddd|ddd|M|D")
+
+    # `names`-table section offsets (spec/template-helpers.md "format_date",
+    # #2334) -- mirrors packages/client/src/format-date.ts's
+    # MONTHS_WIDE/MONTHS_ABBR/WEEKDAYS_WIDE/WEEKDAYS_ABBR constants.
+    _FORMAT_DATE_MONTHS_WIDE = 0
+    _FORMAT_DATE_MONTHS_ABBR = 12
+    _FORMAT_DATE_WEEKDAYS_WIDE = 24
+    _FORMAT_DATE_WEEKDAYS_ABBR = 31
+
+    def format_date(
+        self, recv: Any, pattern: str, tz: str, names: Optional[list] = None
+    ) -> str:
+        """`format_date(recv, pattern, tz, names)` -- the lowering target for
+        a `formatDate(date, pattern, timeZone, names)` call (#2324 numeric
+        tokens, #2334 name tokens; 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. Canonical arity is
+        4 -- the lowering always supplies `tz` and `names` (defaulting
+        `'UTC'` and `[]`).
+
+        `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"). The weekday used by `dddd`/
+        `ddd` comes from the SAME integer path -- `(shifted_ms // 86_400_000
+        + 4) % 7` (Python floor division; `+4` because epoch day 0,
+        1970-01-01, is a Thursday, and the table is Sunday-first so
+        `weekday == 0` must mean Sunday) -- rather than re-deriving it from
+        `yoe`/`doy`, so it stays correct across the same year-10000
+        overflow boundary the civil-from-days math above already handles.
+
+        `pattern` is scanned longest-match over
+        `YYYY|MMMM|MMM|MM|DD|dddd|ddd|M|D` (`_FORMAT_DATE_TOKEN_RE`,
+        alternation ordered so longer tokens win before their shorter
+        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. `MMMM`/`MMM` read `names[month-1]`
+        / `names[12+month-1]` (wide/abbreviated month name); `dddd`/`ddd`
+        read `names[24+weekday]` / `names[31+weekday]` (wide/abbreviated
+        weekday name, Sunday-first) -- `names` is the flat table documented
+        on the module's `formatDate` JS sibling: `[0..11]` wide months,
+        `[12..23]` abbreviated months, `[24..30]` wide weekdays, `[31..37]`
+        abbreviated weekdays. An index past the end of (or an altogether
+        missing) `names` table renders `''` for that token, never an
+        `IndexError`."""
+        names = names or []
+
+        def _name_at(index: int) -> str:
+            return names[index] if 0 <= index < len(names) else ""
+
+        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}"
+        # Weekday from the SAME integer path as the civil-from-days fields
+        # above (NOT re-derived from yoe/doy) -- 0=Sunday, matching the
+        # table's Sunday-first layout. `(shifted_ms // 86_400_000)` is the
+        # signed epoch-day count (Python floor division, exact for negative
+        # epochs); `+4` anchors it since epoch day 0 (1970-01-01) is a
+        # Thursday.
+        days = shifted_ms // 86_400_000
+        weekday = (days + 4) % 7
+
+        def _sub(match: "re.Match[str]") -> str:
+            token = match.group(0)
+            if token == "YYYY":
+                return yyyy
+            if token == "MMMM":
+                return _name_at(self._FORMAT_DATE_MONTHS_WIDE + month - 1)
+            if token == "MMM":
+                return _name_at(self._FORMAT_DATE_MONTHS_ABBR + month - 1)
+            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)
+            if token == "dddd":
+                return _name_at(self._FORMAT_DATE_WEEKDAYS_WIDE + weekday)
+            if token == "ddd":
+                return _name_at(self._FORMAT_DATE_WEEKDAYS_ABBR + weekday)
+            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, names=None: bf.format_date(recv, pattern, tz, names),
     "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