worldwide 2.0.1 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1e48911b7e2ca19bd024f14a60068270a55cc29cedd342129cfaace9a963780
-  data.tar.gz: f09993a550d2fc95ff3cb95b1c26682cd4e04acf00579c771db8d9d2171f7a17
+  metadata.gz: de8a80d57087c079ab1c023b73df7bab83b8e4d4efca610ada4fc1b36bf8a1fa
+  data.tar.gz: cb20c9fecdf12aaa8b8833deb5c19e7322e0799aa2f9bdb3fabba01d398d48f1
 SHA512:
-  metadata.gz: efbf75640ba7d6281b7dd1ef56a0e1f9a01d8fb5ecbb5cf92d30b139cbe2d0f01d82622d17c841228ca39de9846b6486d4ac9c716d5ea70fa859d3861726190c
-  data.tar.gz: 9962e78b12862e4bcfe3aa79a709b575dc0a405e402e23514c852ff14447109672d60d8a066d29d0941764dbf340204b531fed23d201c40ca3a1414475a75f4b
+  metadata.gz: 7bdd5c312d07f9ecf26be0ee0946d62d1d88980f9c071e8285972e85d68aa2cae9b236d053a6103098ceeef3246c7edf245c34873f3e06ad1b5cf86bc85869bf
+  data.tar.gz: b0a9fad71543e55efcb30e3fc3a2523602ca6f66e8f7455f19f5ab4101f6b0aadbe9f520259fc4d9776308d65fd9602fd0f98682cfa3faee6f5caa3bd434de2a

data/.github/dependabot.yml

@@ -13,6 +13,12 @@ updates:
         update-types:
           - minor
           - patch
+    ignore:
+      # Dependabot resolves the bundle with Ruby 3.1.7, the lowest version
+      # worldwide.gemspec allows. pry-byebug >= 3.12 requires Ruby >= 3.2, so
+      # every attempt to update it fails. The Gemfile also caps it at < 3.12.
+      - dependency-name: "pry-byebug"
+        versions: [">= 3.12"]
   - package-ecosystem: npm
     directory: "/lang/typescript"
     schedule:

data/CHANGELOG.md

@@ -29,6 +29,14 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ---
 
+## [2.1.0] - 2026-11-10
+
+- Accept Panama's 10-character postal codes (`XXXXX-XXXXX`, for example `ADC96-M8H44`), as well as the 4-digit codes. `Zip.normalize` puts the hyphen after the 5th character. [#678](https://github.com/Shopify/worldwide/pull/678)
+- Add street-first `address1` formats for AR, AT, BE, BR, CH, CL, CZ, ES, FI, HU, MX, NO, PT, SE, and UY.
+- Add the XCG (Caribbean guilder) currency, which replaced ANG in Curaçao and Sint Maarten on 2025-03-31. XCG has English, Dutch and Spanish names, the symbol `Cg` and 2 decimal places. ANG is unchanged and still available. XCG has no numeric code yet, because ISO gives it 532, the code ANG uses, so `Worldwide::Currencies.alpha_code_for(532)` still returns `"ANG"`.
+
+---
+
 ## [2.0.1] - 2026-10-27
 
 - Dependabot now groups minor and patch updates into one pull request per ecosystem (bundler, npm, GitHub Actions) and limits open pull requests to 5. [#655](https://github.com/Shopify/worldwide/pull/655)

data/Gemfile

@@ -20,7 +20,10 @@ group :development do
   gem "rubocop-shopify", require: false
   gem "rubocop", require: false
   gem "ruby-lsp", require: false
-  gem "pry-byebug", require: false
+  # pry-byebug >= 3.12 requires Ruby >= 3.2, but the gemspec still supports Ruby 3.1.
+  # Keep the lockfile installable on Ruby 3.1. Dependabot ignores newer versions
+  # via .github/dependabot.yml.
+  gem "pry-byebug", "< 3.12", require: false
 end
 
 group :test do

data/Gemfile.lock

@@ -13,7 +13,7 @@ GIT
 PATH
   remote: .
   specs:
-    worldwide (2.0.1)
+    worldwide (2.1.0)
       activesupport (>= 7.0)
       i18n (>= 1.15)
       phonelib (~> 0.8)
@@ -82,7 +82,7 @@ GEM
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.4.2)
-    rake-compiler (1.3.1)
+    rake-compiler (1.3.3)
       rake
     rbs (3.10.4)
       logger
@@ -145,7 +145,7 @@ DEPENDENCIES
   minitest-focus
   minitest-reporters
   mocha
-  pry-byebug
+  pry-byebug (< 3.12)
   rake (~> 13.4)
   rake-compiler
   rubocop

data/data/cldr/locales/en/currencies.yml

@@ -1111,6 +1111,10 @@ en:
       name: East Caribbean Dollar
       one: East Caribbean dollar
       other: East Caribbean dollars
+    XCG:
+      name: Caribbean Guilder
+      one: Caribbean guilder
+      other: Caribbean guilders
     XDR:
       name: Special Drawing Rights
       one: special drawing rights

data/data/cldr/locales/es/currencies.yml

@@ -1477,6 +1477,11 @@ es:
       one: dólar del Caribe Oriental
       other: dólares del Caribe Oriental
       symbol: XCD
+    XCG:
+      many: florines caribeños
+      name: florín caribeño
+      one: florín caribeño
+      other: florines caribeños
     XDR:
       name: derechos especiales de giro
     XEU:

data/data/cldr/locales/nl/currencies.yml

@@ -1471,6 +1471,10 @@ nl:
       one: Oost-Caribische dollar
       other: Oost-Caribische dollar
       symbol: EC$
+    XCG:
+      name: Caribische gulden
+      one: Caribische gulden
+      other: Caribische gulden
     XDR:
       name: Special Drawing Rights
       one: Special Drawing Rights

data/data/cldr/locales/root/currencies.yml

@@ -217,6 +217,8 @@ root:
     XCD:
       narrow_symbol: "$"
       symbol: EC$
+    XCG:
+      symbol: Cg
     XOF:
       symbol: F CFA
     XPF:

data/data/other/currency/mappings/codes.yml

@@ -393,6 +393,9 @@ XBD:
   three_digit_code: "958"
 XCD:
   three_digit_code: "951"
+# XCG (Caribbean guilder) has ISO numeric code 532, which it shares with ANG, the currency it replaced in
+# Curaçao and Sint Maarten on 2025-03-31. XCG is left out of this list so that numeric code 532 keeps
+# resolving to ANG until ANG is retired.
 XDR:
   three_digit_code: "960"
 XOF:

data/data/other/currency/mappings/digits.yml

@@ -311,6 +311,8 @@ XAF:
   digits: 0
 XCD:
   digits: 2
+XCG:
+  digits: 2
 XOF:
   digits: 0
 XPF:

data/data/regions/AR.yml

@@ -14,6 +14,7 @@ building_number_required: true
 zip_regex: "^[A-Z]?\\d{4}([A-Z]{3})?$"
 week_start_day: sunday
 format:
+  address1: "{street} {building_num}"
   edit: "{country}_{firstName}{lastName}_{company}_{address1}_{address2}_{zip}{city}{province}_{phone}"
   show: "{firstName} {lastName}_{company}_{address1}_{address2}_{zip} {city} {province}_{country}_{phone}"
 emoji: "\U0001F1E6\U0001F1F7"

data/data/regions/AT.yml

@@ -24,6 +24,7 @@ example_address:
   zip: '1015'
   phone: "+43 1 53410"
 format:
+  address1: "{street} {building_num}"
   edit: "{country}_{firstName}{lastName}_{company}_{address1}_{address2}_{zip}{city}_{phone}"
   show: "{firstName} {lastName}_{company}_{address1}_{address2}_{zip} {city}_{country}_{phone}"
 emoji: "\U0001F1E6\U0001F1F9"

data/data/regions/BE.yml

@@ -27,6 +27,7 @@ example_address:
   zip: '1000'
   phone: "+32 (0)2-551.20.20"
 format:
+  address1: "{street} {building_num}"
   edit: "{country}_{firstName}{lastName}_{company}_{address1}_{address2}_{zip}{city}_{phone}"
   show: "{firstName} {lastName}_{company}_{address1}_{address2}_{zip} {city}_{country}_{phone}"
 format_extended:

data/data/regions/BR.yml

@@ -24,6 +24,7 @@ example_address:
   zip: 70050-000
   phone: "+55 61 3224-4073"
 format:
+  address1: "{street}, {building_num}"
   edit: "{country}_{firstName}{lastName}_{company}_{zip}_{address1}_{address2}_{city}{province}_{phone}"
   show: "{firstName} {lastName}_{company}_{address1}_{address2}_{zip} {city} {province}_{country}_{phone}"
 format_extended:

data/data/regions/CH.yml

@@ -28,6 +28,7 @@ example_address:
   zip: '3003'
   phone: "+41 31 377 77 77"
 format:
+  address1: "{street} {building_num}"
   edit: "{country}_{firstName}{lastName}_{company}_{address1}_{address2}_{zip}{city}_{phone}"
   show: "{firstName} {lastName}_{company}_{address1}_{address2}_{zip} {city}_{country}_{phone}"
 emoji: "\U0001F1E8\U0001F1ED"

data/data/regions/CL.yml

@@ -12,6 +12,7 @@ zip_example: '8340457'
 phone_number_prefix: 56
 week_start_day: sunday
 format:
+  address1: "{street} {building_num}"
   edit: "{country}_{firstName}{lastName}_{company}_{address1}_{address2}_{zip}{city}_{province}_{phone}"
   show: "{firstName} {lastName}_{company}_{address1}_{address2}_{zip} {city}_{province}_{country}_{phone}"
 format_extended:

data/data/regions/CZ.yml

@@ -18,6 +18,7 @@ phone_number_prefix: 420
 building_number_required: true
 week_start_day: monday
 format:
+  address1: "{street} {building_num}"
   edit: "{country}_{firstName}{lastName}_{company}_{address1}_{address2}_{zip}{city}_{phone}"
   show: "{firstName} {lastName}_{company}_{address1}_{address2}_{zip} {city}_{country}_{phone}"
 emoji: "\U0001F1E8\U0001F1FF"

data/data/regions/ES.yml

@@ -25,6 +25,7 @@ example_address:
   zip: '28004'
   phone: "+34 91 701 72 67"
 format:
+  address1: "{street} {building_num}"
   edit: "{country}_{firstName}{lastName}_{company}_{address1}_{address2}_{zip}{city}{province}_{phone}"
   show: "{firstName} {lastName}_{company}_{address1}_{address2}_{zip} {city}_{province}_{country}_{phone}"
 format_extended:

data/data/regions/FI.yml

@@ -17,6 +17,7 @@ phone_number_prefix: 358
 building_number_required: true
 week_start_day: monday
 format:
+  address1: "{street} {building_num}"
   edit: "{country}_{firstName}{lastName}_{company}_{address1}_{address2}_{zip}{city}_{phone}"
   show: "{firstName} {lastName}_{company}_{address1}_{address2}_{zip} {city}_{country}_{phone}"
 emoji: "\U0001F1EB\U0001F1EE"

data/data/regions/HU.yml

@@ -14,6 +14,7 @@ phone_number_prefix: 36
 building_number_required: true
 week_start_day: monday
 format:
+  address1: "{street} {building_num}"
   edit: "{country}_{firstName}{lastName}_{company}_{zip}{city}_{address1}_{address2}_{phone}"
   show: "{firstName} {lastName}_{company}_{zip} {city}_{address1}_{address2}_{country}_{phone}"
 tags:

data/data/regions/MX.yml

@@ -14,6 +14,7 @@ phone_number_prefix: 52
 building_number_required: true
 week_start_day: sunday
 format:
+  address1: "{street} {building_num}"
   edit: "{country}_{firstName}{lastName}_{company}_{address1}_{address2}_{zip}{city}{province}_{phone}"
   show: "{firstName} {lastName}_{company}_{address1}_{address2}_{zip} {city} {province}_{country}_{phone}"
 format_extended:

data/data/regions/NO.yml

@@ -24,6 +24,7 @@ example_address:
   zip: '0287'
   phone: "+47 22 13 52 80"
 format:
+  address1: "{street} {building_num}"
   edit: "{country}_{firstName}{lastName}_{company}_{address1}_{address2}_{zip}{city}_{phone}"
   show: "{firstName} {lastName}_{company}_{address1}_{address2}_{zip} {city}_{country}_{phone}"
 emoji: "\U0001F1F3\U0001F1F4"

data/data/regions/PA.yml

@@ -7,8 +7,8 @@ unit_system: metric
 tax_name: ITBMS
 group: Central American Countries
 group_name: Central America
-zip_regex: "^\\d{4}$"
-zip_example: "0801"
+zip_regex: "^(?:\\d{4}|[A-Z0-9]{2}[2-9A-HJ-NP-TV-XZ]{3}[ -]?[2-9A-HJ-NP-TV-XZ]{5})$"
+zip_example: "ADC96-M8H44"
 zip_requirement: optional
 phone_number_prefix: 507
 week_start_day: sunday
@@ -45,7 +45,7 @@ example_address:
   address2: y entre calles 35 y, C. 36 Este, ⁠El Marañón
   city: Panamá
   province_code: PA-8
-  zip: '0815'
+  zip: ADC96-M8H44
   phone: "+507 524-8900"
 zones:
 - name: Bocas del Toro

data/data/regions/PT.yml

@@ -17,6 +17,7 @@ tags:
 - EU-member
 week_start_day: monday
 format:
+  address1: "{street} {building_num}"
   edit: "{country}_{firstName}{lastName}_{company}_{address1}_{address2}_{zip}{city}{province}_{phone}"
   show: "{firstName} {lastName}_{company}_{address1}_{address2}_{zip} {city}_{province}_{country}_{phone}"
 emoji: "\U0001F1F5\U0001F1F9"

data/data/regions/SE.yml

@@ -24,6 +24,7 @@ example_address:
   zip: 103 16
   phone: "+46 8 534 818 00"
 format:
+  address1: "{street} {building_num}"
   edit: "{country}_{firstName}{lastName}_{company}_{address1}_{address2}_{zip}{city}_{phone}"
   show: "{firstName} {lastName}_{company}_{address1}_{address2}_{zip} {city}_{country}_{phone}"
 emoji: "\U0001F1F8\U0001F1EA"

data/data/regions/UY.yml

@@ -11,6 +11,7 @@ zip_example: '11600'
 phone_number_prefix: 598
 week_start_day: monday
 format:
+  address1: "{street} {building_num}"
   edit: "{country}_{firstName}{lastName}_{company}_{address1}_{address2}_{zip}{city}{province}_{phone}"
   show: "{firstName} {lastName}_{company}_{address1}_{address2}_{zip} {city}, {province}_{country}_{phone}"
 emoji: "\U0001F1FA\U0001F1FE"

data/lib/worldwide/version.rb

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

data/lib/worldwide/zip.rb

@@ -396,6 +396,7 @@ module Worldwide
       MT: [[7, " ", 3], [5, " ", 3]],
 
       NL: [[6, " ", 4]],
+      PA: [[10, "-", 5]],
       PL: [[5, "-", 2]],
       PN: [[7, " ", 4]],
       PT: [[7, "-", 4]],
@@ -515,7 +516,6 @@ module Worldwide
       "NP",
       "NZ",
       "OM",
-      "PA",
       "PF",
       "PG",
       "PH",

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: worldwide
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.1.0
 platform: ruby
 authors:
 - Shopify