barefoot_js 0.25.0 → 0.30.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01c03141b87505bcc2834d5acbf460b92def83f0932ab62845fcfdc4ea1a5b45
-  data.tar.gz: f51524718fa1c54848ffe68bdbf1ea7f48ef899a5eaaf879ec47ae5ffc436ff4
+  metadata.gz: ca797efa51cecb1fa7eb049f0689fa0fff77996e0d97ccee9102639c359f13f7
+  data.tar.gz: eba717d9c886f1569ce5882a9ef43b5ebcf5a444da4dcd050f51e6a3009cad45
 SHA512:
-  metadata.gz: 92165ba796d909d7995b962a3074f537d7709344817abdb78eb1818c76bcec761fcb6d033d7c4660e26bc624dcf91c85978455c7cdcf85e7231ccd43478ae514
-  data.tar.gz: 97beda0b52738f73a9b25b3910ce2a6e0eb3c8b274c7613a2ec332147114dcb4c72133310ee5cff89a0f86caa46d63940afae249148323e5b66238044d74dfb7
+  metadata.gz: 4cc5ee0e33f116f6142cc85a41be5f28b62ccdfaa07781570f8db776f6bb438e158ecad23dd56366ea0764625d31bdaef0a0918d9cbd6f803f4277ff1fbbb9a5
+  data.tar.gz: 85d238ab63966d116da0ba390b990ae2088a3010d6a866f0a06302b159af3ba46fa1d04012ce2c4b836649384a75504ad2d91edca99df18f2682825df2ebf63b

data/lib/barefoot_js.rb

@@ -530,9 +530,12 @@ module BarefootJS
     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/
+    # within ECMA-402's valid range -- hours 00-23, minutes 00-59
+    # (`'+09:00'`, `'-05:30'`) -- one of the three `tz` shapes `format_date`
+    # accepts (mirrors OFFSET_RE in packages/client/src/format-date.ts). An
+    # out-of-range shape (`'+25:00'`) falls through to the tzdata lookup,
+    # fails it, and raises -- matching the JS reference's RangeError (#2344).
+    FORMAT_DATE_OFFSET_RE = /\A([+-])([01]\d|2[0-3]):([0-5]\d)\z/
 
     # Longest-match pattern-token alternation (mirrors TOKEN_RE in
     # packages/client/src/format-date.ts). Order matters: Onigmo, like JS's
@@ -562,13 +565,20 @@ module BarefootJS
     # 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`
+    # tz (#2344): 'UTC', a range-valid fixed offset `±HH:MM` (shifts the
+    # instant by sign*(HH*60+MM) minutes), or a canonical IANA zone name
+    # ('Asia/Tokyo') resolved through tzdata via the tzinfo gem -- the
+    # zone's UTC offset AT THE INSTANT being formatted (DST-aware,
+    # historical-transition-aware, seconds precision: pre-standard LMT
+    # offsets like Tokyo's +09:18:59 count). ANY other value -- an unknown
+    # zone, a non-canonical spelling, a malformed or out-of-range offset
+    # ('+9:00', '+25:00') -- raises ArgumentError, aborting the render
+    # loudly: the JS reference throws a RangeError there, and a silently
+    # substituted timezone is the one failure mode this helper must not
+    # have (the pre-#2344 normalize-to-UTC total function is gone). 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 in that zone. `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
@@ -602,10 +612,19 @@ module BarefootJS
         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
+      tz_s = tz.to_s
+      offset_seconds = 0
+      if tz_s != 'UTC'
+        m = FORMAT_DATE_OFFSET_RE.match(tz_s)
+        offset_seconds =
+          if m
+            (m[1] == '-' ? -1 : 1) * ((m[2].to_i * 60) + m[3].to_i) * 60
+          else
+            format_date_zone_offset(tz_s, t)
+          end
+      end
 
-      shifted = (t.utc + (offset_minutes * 60)).utc
+      shifted = (t.utc + offset_seconds).utc
       year = shifted.year
       month = shifted.mon
       day = shifted.mday
@@ -628,6 +647,29 @@ module BarefootJS
       end
     end
 
+    # Resolve a canonical IANA zone ID's UTC offset (whole seconds) at
+    # instant `t` through the tzinfo gem (#2344) -- TZInfo resolves the
+    # exact-case canonical ID set every backend shares, with full
+    # historical transitions (LMT seconds included). The gem is required
+    # lazily so the fixed-offset/'UTC' paths -- and every other helper --
+    # keep working on a gem-less stdlib install; reaching a named zone
+    # without the gem raises the same loud ArgumentError as an unknown
+    # zone (never a silent UTC fallback).
+    def format_date_zone_offset(tz, t)
+      begin
+        require 'tzinfo'
+      rescue LoadError
+        raise ArgumentError,
+              "format_date: IANA timeZone #{tz.inspect} requires the tzinfo gem (~> 2.0)"
+      end
+      begin
+        zone = TZInfo::Timezone.get(tz)
+      rescue TZInfo::InvalidTimezoneIdentifier
+        raise ArgumentError, "format_date: unresolvable timeZone #{tz.inspect}"
+      end
+      zone.period_for_utc(t.utc).observed_utc_offset
+    end
+
     # -----------------------------------------------------------------
     # Array / String method helpers
     # -----------------------------------------------------------------
@@ -730,6 +772,57 @@ module BarefootJS
       string(recv).each_char.sum { |c| c.ord > 0xFFFF ? 2 : 1 }
     end
 
+    # Runtime-polymorphic element/key access for `arr[index]` /
+    # `hash[key]` (`emitIndexAccessRuby`, expr/operand.ts). Row hashes
+    # deserialize with `symbolize_names: true`, so a dynamic key whose
+    # runtime value is a String (e.g. a destructured `.map()` param used
+    # as a key, `tone[k]`) misses a Symbol-keyed Hash outright -- and the
+    # shared analyzer can't tell at compile time whether an index will
+    # turn out to be a string key or a numeric index (it types a
+    # destructured param `{kind:'unknown'}`), so no compile-time branch
+    # can pick the right access form (#2491). Mirrors `getFieldValue`'s
+    # (Go adapter, bf.go) case-tolerant lookup and Twig's `attribute()`:
+    # for a Hash, try the key as-is, then as a Symbol, then as a String;
+    # for an Array, index numerically; anything else has no lookup to
+    # perform.
+    def get(collection, key)
+      return nil if key.nil?
+
+      case collection
+      when Hash
+        return collection[key] if collection.key?(key)
+
+        sym = key.respond_to?(:to_sym) ? key.to_sym : nil
+        return collection[sym] if sym && collection.key?(sym)
+
+        str = key.to_s
+        return collection[str] if collection.key?(str)
+
+        nil
+      when Array
+        # Only an INTEGRAL index reads an element. `key.to_i` would be
+        # wrong on both ends: it coerces a non-numeric String to 0
+        # (`arr["nope"]` must be nil, not the first element) and it
+        # truncates a fractional number (JS `arr[1.2]` is a property
+        # lookup, i.e. undefined -- not index 1).
+        idx =
+          case key
+          when Integer then key
+          when Numeric then (key % 1).zero? ? key.to_i : nil
+          when String then (key =~ /\A-?\d+\z/ ? key.to_i : nil)
+          end
+        return nil if idx.nil?
+
+        # JS-semantics negative index is "not found" (`arr[-1] ===
+        # undefined`), NOT Ruby's native from-the-end wraparound -- guard
+        # it explicitly so this stays a superset of bracket access rather
+        # than a divergent one.
+        return nil if idx.negative?
+
+        collection[idx]
+      end
+    end
+
     # Mirrors Hono's own CSS-injection guard (`hono/jsx/utils.ts`'s
     # `hasUnsafeStyleValue` -- the ORACLE a dynamic `style={{...}}` value
     # must match, #2261): a hand-rolled structural scan for characters that

metadata

@@ -1,15 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: barefoot_js
 version: !ruby/object:Gem::Version
-  version: 0.25.0
+  version: 0.30.6
 platform: ruby
 authors:
 - kobaken
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-20 00:00:00.000000000 Z
-dependencies: []
+date: 2026-08-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: tzinfo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
 description: Engine-agnostic BarefootJS server runtime targeting ERB, ported from
   packages/adapter-perl/lib/BarefootJS.pm.
 email: