barefoot_js 0.21.4 → 0.24.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b7b1139c42325379799c479340b9fb822a001e32ebfbb3ae62e9a15d0f565aa
-  data.tar.gz: fdcdeb39b7ee15dbb96b11f3dd24513fcc516bf242c8cc1f2e589be85b4e779f
+  metadata.gz: cd41229b2fa03f5b1e052a7ad7e21bbc5f81a9034740eb6f12055afd473b4b67
+  data.tar.gz: 0d175251cb5880996149e5dde87c17278855c3dac477fb698e4cee265788823c
 SHA512:
-  metadata.gz: b0b956eed7b39587d7f9d07182c6285e7ad5846e34c495ec369043517c10048afe714a593d2f7ce8f47584f20b3d3ef6759d249cadd412c1fba036a8e26df6b0
-  data.tar.gz: f5de21fb61748e44d7ebe311a65acac1d7e48f29ef6cf1f489f19c801307610fb3cda0bc7a7574e761781aeb78af6a966ab656ea6b320e4fb7c83f7f7b9f3ce2
+  metadata.gz: e430505c608b87a7bf80fbeecd433afa4a3495534ff17af683655fabcd06533a79811d5ded241f530a9da25a529ac3b98e2caf926dbb3da0d1e8a2a2121f9daa
+  data.tar.gz: 5a4e93faa339dbe79856153eeed378a3c8f369dba85f35df3ef9755f284fc844a3c0b629bf87094e82e709c0a5579741fbdea52ed08f6220e7a34b2cae2de4a2

data/lib/barefoot_js.rb

@@ -529,6 +529,105 @@ module BarefootJS
       end
     end
 
+    # `tz` shapes FORMAT_DATE_OFFSET_RE matches: a fixed UTC offset `±HH:MM`
+    # (`'+09:00'`, `'-05:30'`) -- the ONLY non-UTC shape `format_date`
+    # recognizes (mirrors OFFSET_RE in packages/client/src/format-date.ts).
+    FORMAT_DATE_OFFSET_RE = /\A([+-])(\d{2}):(\d{2})\z/
+
+    # Longest-match pattern-token alternation (mirrors TOKEN_RE in
+    # packages/client/src/format-date.ts). Order matters: Onigmo, like JS's
+    # regex engine, resolves alternation leftmost-first (not POSIX
+    # leftmost-longest), so every multi-char token must be listed before any
+    # shorter alternative it prefixes -- YYYY before (nothing shorter
+    # shares its prefix), MMMM before MMM before MM before M, DD before D,
+    # dddd before ddd. (#2334)
+    FORMAT_DATE_TOKEN_RE = /YYYY|MMMM|MMM|MM|DD|dddd|ddd|M|D/
+
+    # `names`-table section offsets (spec/template-helpers.md "format_date",
+    # #2334) -- mirrors MONTHS_WIDE/MONTHS_ABBR/WEEKDAYS_WIDE/WEEKDAYS_ABBR in
+    # packages/client/src/format-date.ts.
+    FORMAT_DATE_MONTHS_WIDE = 0
+    FORMAT_DATE_MONTHS_ABBR = 12
+    FORMAT_DATE_WEEKDAYS_WIDE = 24
+    FORMAT_DATE_WEEKDAYS_ABBR = 31
+
+    # `format_date(recv, pattern, tz, names)` (#2324/#2334, spec entry
+    # "format_date" in spec/template-helpers.md) -- the lowering target for
+    # `formatDate(date, pattern, timeZone, names)`
+    # (packages/client/src/format-date.ts, the JS-normative reference this
+    # must match byte-for-byte). Total and deterministic: no locale, no host
+    # timezone, no `Time.now`.
+    #
+    # recv: the same receiver contract as `date` above -- a native `Time` or
+    # an ISO-8601 string, normalized identically. A nil / unparseable
+    # receiver renders '' (never raises mid-render).
+    #
+    # tz: a fixed UTC offset `±HH:MM` shifts the instant by
+    # sign*(HH*60+MM) minutes; ANY other value -- 'UTC', an IANA zone name
+    # ('Asia/Tokyo'), or a malformed offset ('+9:00') -- normalizes to a
+    # zero-minute shift (UTC), so every backend degrades identically instead
+    # of dragging in host tzdata. The shifted instant's UTC calendar fields
+    # (not the original instant's) are what pattern tokens read -- the
+    # shifted UTC clock face IS the local clock face at that offset. `Time`
+    # arithmetic here is exact (Ruby represents the instant as a Rational,
+    # not a floor-divided epoch-millis integer), so there's no pre-1970
+    # negative-epoch floor-division trap to dodge the way a naive
+    # epoch-millis-div-86400000 implementation would hit; the shifted
+    # `Time#wday` (0 = Sunday) is likewise exact across the epoch boundary,
+    # so it doubles directly as the weekday-name table index.
+    #
+    # names: the flat table (#2334) -- `[0..11]` wide months, `[12..23]`
+    # abbreviated months, `[24..30]` wide weekdays (Sunday-first, matching
+    # the shifted `Time#wday`), `[31..37]` abbreviated weekdays. The caller
+    # owns the values (locale selection is never this method's job). An
+    # index past a missing/short table renders '' rather than raising.
+    #
+    # pattern: longest-match token substitution
+    # (`YYYY|MMMM|MMM|MM|DD|dddd|ddd|M|D`); 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 the month's wide/abbreviated name; `dddd`/`ddd` read the shifted
+    # weekday's wide/abbreviated name.
+    def format_date(recv, pattern, tz, names = [])
+      t =
+        if recv.is_a?(Time)
+          recv
+        else
+          begin
+            Time.iso8601(recv.to_s)
+          rescue ArgumentError
+            nil
+          end
+        end
+      return '' if t.nil?
+
+      m = FORMAT_DATE_OFFSET_RE.match(tz.to_s)
+      offset_minutes = m ? (m[1] == '-' ? -1 : 1) * ((m[2].to_i * 60) + m[3].to_i) : 0
+
+      shifted = (t.utc + (offset_minutes * 60)).utc
+      year = shifted.year
+      month = shifted.mon
+      day = shifted.mday
+      weekday = shifted.wday # 0 = Sunday, matching the table's Sunday-first layout
+      yyyy = (year.negative? ? '-' : '') + year.abs.to_s.rjust(4, '0')
+      name_at = ->(index) { (names[index] || '').to_s }
+
+      pattern.gsub(FORMAT_DATE_TOKEN_RE) do |token|
+        case token
+        when 'YYYY' then yyyy
+        when 'MMMM' then name_at.call(FORMAT_DATE_MONTHS_WIDE + month - 1)
+        when 'MMM' then name_at.call(FORMAT_DATE_MONTHS_ABBR + month - 1)
+        when 'MM' then format('%02d', month)
+        when 'M' then month.to_s
+        when 'DD' then format('%02d', day)
+        when 'D' then day.to_s
+        when 'dddd' then name_at.call(FORMAT_DATE_WEEKDAYS_WIDE + weekday)
+        when 'ddd' then name_at.call(FORMAT_DATE_WEEKDAYS_ABBR + weekday)
+        end
+      end
+    end
+
     # -----------------------------------------------------------------
     # Array / String method helpers
     # -----------------------------------------------------------------

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: barefoot_js
 version: !ruby/object:Gem::Version
-  version: 0.21.4
+  version: 0.24.1
 platform: ruby
 authors:
 - kobaken
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-17 00:00:00.000000000 Z
+date: 2026-07-20 00:00:00.000000000 Z
 dependencies: []
 description: Engine-agnostic BarefootJS server runtime targeting ERB, ported from
   packages/adapter-perl/lib/BarefootJS.pm.