worldwide 1.27.0 → 1.28.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 49d1675cfafac47dc58a9af5c3fc11bf4f3926b81acae2475136046642c762a2
-  data.tar.gz: bacfd6668d53c592656ed70c1fddff894a748b4009e7a9934e55a58dd7a47408
+  metadata.gz: afc3540f3eaf751ee10b556f119aaee8388238ae648242af64cc87df2eb8faa4
+  data.tar.gz: bc26455e86b23aa4ce3446966fb61dd96ec4fa7b463d5df9903e8f5654a4ff3d
 SHA512:
-  metadata.gz: 4715015cdf99318440751f709a90fea983674a52564f1fc2d8c6b9e67bbac388222c0664fba5ceaefe5dfe0ccce2fb0b315400357665b53b554a670a01de25cc
-  data.tar.gz: b2921509899d3dd2f249d258315f5ea97c186b05a65eb92a57007fb75a61fe9be02a8340d96f3182a21baf5849e9555ab6a0ac50f24b839c5e90c0e88d92fb66
+  metadata.gz: dd96594b69a597d00ada229bc983892e9e117d248edbdd7f2c3bb3ea9a83265b7dedaa3f396744d247566dfdfaa418bf80c31e42647fcd6732ff25e28c446fe8
+  data.tar.gz: 717ad7d14a176b38563072f8dbff0fe8b182c3fc92926b660357d9cfd511051514891e820baf146feae5805359ea3d3f8663d0ab875f2a645194259a3531031f

data/.github/CODEOWNERS

@@ -0,0 +1,7 @@
+# CODEOWNERS file for worldwide
+# This file defines code owners for specific files/patterns in this repository
+
+# Address team reviews all changes except Gemfile.lock and RBI files
+* @Shopify/address
+Gemfile.lock
+sorbet/rbi/gems/**

data/CHANGELOG.md

@@ -29,6 +29,23 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ---
 
+## [1.28.1] - 2026-09-23
+
+- Accept `USDC` as the only supported non-ISO currency code, while malformed and other unknown codes stay out of the currency cache. [#607](https://github.com/Shopify/worldwide/pull/607)
+- Apply CLDR fallbacks for hosts that read `I18n.fallbacks` from `Thread.current`, which stopped seeing them in 1.25.6. [#607](https://github.com/Shopify/worldwide/pull/607)
+
+---
+
+## [1.28.0] - 2026-09-21
+
+- Add `Region#iso_3166_code_assigned?` to distinguish currently assigned ISO 3166-1 alpha-2 codes from other region codes. [#598](https://github.com/Shopify/worldwide/pull/598)
+- Reject malformed currency codes before caching. [#596](https://github.com/Shopify/worldwide/pull/596)
+- Add IE Eircode routing keys `N39` (Longford) and `N41` (Carrick-on-Shannon) to each other's `zips_crossing_provinces` entries, so both are valid for Longford and Leitrim. [#601](https://github.com/Shopify/worldwide/pull/601)
+- Avoid retaining unknown locale codes in the global locale cache. [#597](https://github.com/Shopify/worldwide/pull/597)
+- Avoid excessive backtracking in Dutch address fallback parsing. [#599](https://github.com/Shopify/worldwide/pull/599)
+
+---
+
 ## [1.27.0] - 2026-09-11
 - Add the 81 province (il) zones for Türkiye (`TR-01`..`TR-81`), staged behind `ignore_provinces` and `hide_provinces_from_addresses`. Each zone carries its plaka number as a `zip_prefix`, so a province can be inferred from the postal code. Address forms and validation are unchanged until the flags are removed.
 

data/Gemfile.lock

@@ -13,7 +13,7 @@ GIT
 PATH
   remote: .
   specs:
-    worldwide (1.27.0)
+    worldwide (1.28.1)
       activesupport (>= 7.0)
       i18n (>= 1.15)
       phonelib (~> 0.8)

data/README.md

@@ -230,6 +230,7 @@ and also answer questions about its status:
   - `continent?`: is this region a continent?
   - `country?`: is this region a "country"?  (Note that, for backward compatibility with legacy code in Shopify's ecosystem,  we do not consider dependent territories of Spain and the United States to be countries, but we do consider dependencies of Australia, Britain, Denmark, Finland, France and Norway to be "countries")
   - `deprecated?`: has this territory ceased to exist? (e.g. `AN` which dissolved in 2010)
+  - `iso_3166_code_assigned?`: is this region's own code currently assigned in ISO 3166-1 alpha-2? Returns false for reserved, withdrawn, user-assigned, unknown, subdivision, and numeric region codes. This checks the resolved region's code, not the original lookup input.
 
 ```ruby
 $ ca = Worldwide.region(code: "CA")

data/data/iso_3166_assigned_country_codes.yml

@@ -0,0 +1,252 @@
+---
+# Currently assigned ISO 3166-1 alpha-2 codes, checked on 2026-09-17.
+# https://www.iso.org/iso-3166-country-codes.html
+- AD
+- AE
+- AF
+- AG
+- AI
+- AL
+- AM
+- AO
+- AQ
+- AR
+- AS
+- AT
+- AU
+- AW
+- AX
+- AZ
+- BA
+- BB
+- BD
+- BE
+- BF
+- BG
+- BH
+- BI
+- BJ
+- BL
+- BM
+- BN
+- BO
+- BQ
+- BR
+- BS
+- BT
+- BV
+- BW
+- BY
+- BZ
+- CA
+- CC
+- CD
+- CF
+- CG
+- CH
+- CI
+- CK
+- CL
+- CM
+- CN
+- CO
+- CR
+- CU
+- CV
+- CW
+- CX
+- CY
+- CZ
+- DE
+- DJ
+- DK
+- DM
+- DO
+- DZ
+- EC
+- EE
+- EG
+- EH
+- ER
+- ES
+- ET
+- FI
+- FJ
+- FK
+- FM
+- FO
+- FR
+- GA
+- GB
+- GD
+- GE
+- GF
+- GG
+- GH
+- GI
+- GL
+- GM
+- GN
+- GP
+- GQ
+- GR
+- GS
+- GT
+- GU
+- GW
+- GY
+- HK
+- HM
+- HN
+- HR
+- HT
+- HU
+- ID
+- IE
+- IL
+- IM
+- IN
+- IO
+- IQ
+- IR
+- IS
+- IT
+- JE
+- JM
+- JO
+- JP
+- KE
+- KG
+- KH
+- KI
+- KM
+- KN
+- KP
+- KR
+- KW
+- KY
+- KZ
+- LA
+- LB
+- LC
+- LI
+- LK
+- LR
+- LS
+- LT
+- LU
+- LV
+- LY
+- MA
+- MC
+- MD
+- ME
+- MF
+- MG
+- MH
+- MK
+- ML
+- MM
+- MN
+- MO
+- MP
+- MQ
+- MR
+- MS
+- MT
+- MU
+- MV
+- MW
+- MX
+- MY
+- MZ
+- NA
+- NC
+- NE
+- NF
+- NG
+- NI
+- NL
+- 'NO'
+- NP
+- NR
+- NU
+- NZ
+- OM
+- PA
+- PE
+- PF
+- PG
+- PH
+- PK
+- PL
+- PM
+- PN
+- PR
+- PS
+- PT
+- PW
+- PY
+- QA
+- RE
+- RO
+- RS
+- RU
+- RW
+- SA
+- SB
+- SC
+- SD
+- SE
+- SG
+- SH
+- SI
+- SJ
+- SK
+- SL
+- SM
+- SN
+- SO
+- SR
+- SS
+- ST
+- SV
+- SX
+- SY
+- SZ
+- TC
+- TD
+- TF
+- TG
+- TH
+- TJ
+- TK
+- TL
+- TM
+- TN
+- TO
+- TR
+- TT
+- TV
+- TW
+- TZ
+- UA
+- UG
+- UM
+- US
+- UY
+- UZ
+- VA
+- VC
+- VE
+- VG
+- VI
+- VN
+- VU
+- WF
+- WS
+- YE
+- YT
+- ZA
+- ZM
+- ZW

data/data/regions/IE.yml

@@ -643,10 +643,12 @@ zips_crossing_provinces:
   - LD
   - CN
   - RN
+  - LM
   N41:
   - LM
   - CN
   - RN
+  - LD
   P36:
   - CO
   - WD

data/data/regions/NL.yml

@@ -33,7 +33,8 @@ format:
 format_extended:
   edit: "{country}_{firstName}{lastName}_{company}_{streetName}{streetNumber}_{address2}_{zip}{city}_{phone}"
 address1_regex:
-  - "^(?<streetName>(?:\\d+[a-z]+\\s+)?[^\\d]+)\\s+(?<streetNumber>\\d+(?:-[A-Za-z0-9]+)?(?: ?[A-Za-z])?)$"
+  # streetName already consumes extra whitespace; repeated separators cause backtracking.
+  - "^(?<streetName>(?:\\d+[a-z]+\\s)?[^\\d]+)\\s(?<streetNumber>\\d+(?:-[A-Za-z0-9]+)?(?: ?[A-Za-z])?)$"
 additional_address_fields:
   - name: streetName
     required: true

data/lib/worldwide/cldr.rb

@@ -82,15 +82,20 @@ module Worldwide
         # application's global fallbacks.
         original_config = STORAGE.config
         original_fallbacks = STORAGE.fallbacks
+        # Some hosts patch I18n.fallbacks to keep reading Thread.current, the slot
+        # used before i18n 1.15, so they must also see the CLDR fallbacks.
+        original_thread_fallbacks = Thread.current[:i18n_fallbacks]
         locale = I18n.locale
 
         STORAGE.config = config
         STORAGE.fallbacks = fallbacks
+        Thread.current[:i18n_fallbacks] = fallbacks
 
         I18n.with_locale(locale, &block)
       ensure
         STORAGE.config = original_config
         STORAGE.fallbacks = original_fallbacks
+        Thread.current[:i18n_fallbacks] = original_thread_fallbacks
       end
     end
   end

data/lib/worldwide/currency.rb

@@ -6,9 +6,11 @@ module Worldwide
     include PluralizationHelper
 
     EXCEPTIONS = { HKD: "HK$" }
+    # Extended codes must be explicit so the process cache remains bounded.
+    SUPPORTED_NON_ISO_CODES = ["USDC"].freeze
     SUPPORTED_ALTERNATE_FORMATS = [:japan]
     TEXT_ENCLOSED_BY_PARENTHESES = /\((.)+\)/
-    private_constant :TEXT_ENCLOSED_BY_PARENTHESES
+    private_constant :SUPPORTED_NON_ISO_CODES, :TEXT_ENCLOSED_BY_PARENTHESES
 
     class << self
       def digits_and_rounding
@@ -28,10 +30,10 @@ module Worldwide
 
     def initialize(code:)
       adjusted_code = code.to_s.upcase.rjust(3, "0")
-      if adjusted_code.match?(/[A-Z][A-Z][A-Z]/)
+      if adjusted_code.match?(/\A[A-Z]{3}\z/) || SUPPORTED_NON_ISO_CODES.include?(adjusted_code)
         @currency_code = adjusted_code
         @numeric_code = Currencies.numeric_code_for(adjusted_code)
-      elsif adjusted_code.match?(/[0-9]+/)
+      elsif adjusted_code.match?(/\A[0-9]{3}\z/)
         @currency_code = Currencies.alpha_code_for(adjusted_code)
         @numeric_code = adjusted_code
       else

data/lib/worldwide/region.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "set"
+
 module Worldwide
   class Region
     # When faced with the question, "Is a postal code required in this country?", we treat the answer
@@ -9,6 +11,12 @@ module Worldwide
     RECOMMENDED = "recommended"
     OPTIONAL = "optional"
 
+    ISO_3166_ASSIGNED_COUNTRY_CODES = YAML.safe_load_file(
+      File.join(Worldwide::Paths::DATA_ROOT, "iso_3166_assigned_country_codes.yml"),
+      freeze: true,
+    ).to_set.freeze
+    private_constant :ISO_3166_ASSIGNED_COUNTRY_CODES
+
     # Accpetable format types of the postal code.
     FORMAT_TYPES = {
       ALPHANUMERIC: "ALPHANUMERIC",
@@ -372,6 +380,11 @@ module Worldwide
       @deprecated
     end
 
+    # Is this region's own code currently assigned in ISO 3166-1 alpha-2?
+    def iso_3166_code_assigned?
+      ISO_3166_ASSIGNED_COUNTRY_CODES.include?(iso_code)
+    end
+
     # An Worldwide::Field that can be used to ask about the field, including
     # labels, error messages, and an autofill value if there is one.
     def field(key:)

data/lib/worldwide/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Worldwide
-  VERSION = "1.27.0"
+  VERSION = "1.28.1"
 end

data/lib/worldwide.rb

@@ -69,7 +69,11 @@ module Worldwide
     end
 
     def locale(code:)
-      @locales_cache[code] ||= Locale.new(code)
+      @locales_cache.fetch(code) do
+        locale = Locale.new(code)
+        @locales_cache[code] = locale if locales.include?(locale.code)
+        locale
+      end
     end
 
     def locales

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: worldwide
 version: !ruby/object:Gem::Version
-  version: 1.27.0
+  version: 1.28.1
 platform: ruby
 authors:
 - Shopify
@@ -59,6 +59,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/CODEOWNERS"
 - ".github/CODE_OF_CONDUCT.md"
 - ".github/CONTRIBUTING.md"
 - ".github/dependabot.yml"
@@ -4715,6 +4716,7 @@ files:
 - data/country_codes.yml
 - data/extant_outcodes.yml
 - data/iana_to_rails_time_zone.yml
+- data/iso_3166_assigned_country_codes.yml
 - data/other/currency/bg.yml
 - data/other/currency/cs.yml
 - data/other/currency/da.yml
@@ -8736,7 +8738,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.19
+rubygems_version: 4.0.21
 specification_version: 4
 summary: Internationalization and localization APIs
 test_files: []