barefoot_js 0.21.4 → 0.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b7b1139c42325379799c479340b9fb822a001e32ebfbb3ae62e9a15d0f565aa
-  data.tar.gz: fdcdeb39b7ee15dbb96b11f3dd24513fcc516bf242c8cc1f2e589be85b4e779f
+  metadata.gz: c491246ea9391fca494777435815f8dccaa0be41243f3c87b761f93bcde0f43f
+  data.tar.gz: ee67f4181d862e7bcce29dfeeb94f261e6528a20239c5492892d7c7afacae5d0
 SHA512:
-  metadata.gz: b0b956eed7b39587d7f9d07182c6285e7ad5846e34c495ec369043517c10048afe714a593d2f7ce8f47584f20b3d3ef6759d249cadd412c1fba036a8e26df6b0
-  data.tar.gz: f5de21fb61748e44d7ebe311a65acac1d7e48f29ef6cf1f489f19c801307610fb3cda0bc7a7574e761781aeb78af6a966ab656ea6b320e4fb7c83f7f7b9f3ce2
+  metadata.gz: ba5295b8b075327c8a99e27b4031d7027a4fd49acc66f770c8d4a8e0f93a87af27825d2bb3f984b9b50adddbd208da4a7269a68647f6d7b6158403f56ae5e8a6
+  data.tar.gz: bf4741049a215dd6b02324294eef094d4cf3b7fabeee5c413e5390c52349c6077c45bd2bb217e9864add8a83a18cbb40a33c1f7e2d4db4e2e0ca64aebcf96496

data/lib/barefoot_js.rb

@@ -529,6 +529,80 @@ 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: MM before M and DD
+    # before D so the 2-char token wins at a position where either could
+    # match -- Ruby's Onigmo engine, like JS's regex engine, resolves
+    # alternation leftmost-first (not POSIX leftmost-longest), so listing the
+    # longer alternative first is what makes "MM" consume both characters
+    # instead of two "M" matches.
+    FORMAT_DATE_TOKEN_RE = /YYYY|MM|DD|M|D/
+
+    # `format_date(recv, pattern, tz)` (#2324, spec entry "format_date" in
+    # spec/template-helpers.md) -- the lowering target for
+    # `formatDate(date, pattern, timeZone)` (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.
+    #
+    # pattern: longest-match token substitution (`YYYY|MM|DD|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.
+    def format_date(recv, pattern, tz)
+      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
+      yyyy = (year.negative? ? '-' : '') + year.abs.to_s.rjust(4, '0')
+
+      pattern.gsub(FORMAT_DATE_TOKEN_RE) do |token|
+        case token
+        when 'YYYY' then yyyy
+        when 'MM' then format('%02d', month)
+        when 'M' then month.to_s
+        when 'DD' then format('%02d', day)
+        when 'D' then day.to_s
+        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.23.0
 platform: ruby
 authors:
 - kobaken
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-17 00:00:00.000000000 Z
+date: 2026-07-19 00:00:00.000000000 Z
 dependencies: []
 description: Engine-agnostic BarefootJS server runtime targeting ERB, ported from
   packages/adapter-perl/lib/BarefootJS.pm.