worldwide 1.18.0 → 1.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34f7bb3c955716343037d30822b2652a535c68be3fada2a11967cc7d6b40763a
-  data.tar.gz: d4bcd46d48d03279e5e297571a6b65dbefe846e23c877e2a05df526192d5f5eb
+  metadata.gz: 1cbb9e0606b63675d9a783759723f4083661820aae022057574e8abaf4490963
+  data.tar.gz: d94f426622537b52d93c10a0f9be29980ad131915788ba77224d6043f5583284
 SHA512:
-  metadata.gz: c58b180cb67553facc810f2a59a5ba9e2dc16d36ee04f7b8e1961c9cd52484edb2a987739b06551cc7f14326e39f80d1e6afbbcf340f1d5e9c80622fb4dfd029
-  data.tar.gz: 422f9b02f981eecf17bbbbfe2cbd25a8187c12f9f041808f30a7d39eed28ea1bd421c2f97f69016747a744fee60bfd62817e5418c2ec0ab4310dac15cbd537ca
+  metadata.gz: 66cc5d0a9561244ae777703aac0acf90a702cb0f891f88d93e8bdf4c5cf72c000c5ee7c107d348dd90dd2531078f505433ad260c97407c3e4fe63df87840f709
+  data.tar.gz: 208de89a7c70089590460ab0675ff1e212752a6f1297dc57a0403ede1605803d31d8b52c5a1081ecaa604b00fe3abe00379396ade030436a46168145c49501a9

data/CHANGELOG.md

@@ -29,6 +29,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ---
 
+## [1.20.0] - 2025-10-15
+- Add has_provinces? method to Region [#396](https://github.com/Shopify/worldwide/pull/396)
+
+## [1.19.0] - 2025-10-15
+- Add new method zip_type to determine if a postal code is `NUMERIC`, `ALPHANUMERIC`, or `NUMERIC_AND_PUNCTUATION`[#395](https://github.com/Shopify/worldwide/pull/395)
+
 ## [1.18.0] - 2025-10-08
 - Fix broken CLDR data rake tasks [#389](https://github.com/Shopify/worldwide/pull/389)
 - Read paths files in `configure_i18n` instead of at module initialization (ibid.)

data/Gemfile.lock

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

data/lib/worldwide/region.rb

@@ -9,6 +9,13 @@ module Worldwide
     RECOMMENDED = "recommended"
     OPTIONAL = "optional"
 
+    # Accpetable format types of the postal code.
+    FORMAT_TYPES = {
+      ALPHANUMERIC: "ALPHANUMERIC",
+      NUMERIC: "NUMERIC",
+      NUMERIC_AND_PUNCTUATION: "NUMERIC_AND_PUNCTUATION",
+    }
+
     # The default `.inspect` isn't a good fit for Region, because it can end up dumping a lot of info
     # as it walks the hierarchy of descendants.  So, instead, we provide our own `.inspect` that
     # only shows a restricted subset of the object's fields.
@@ -394,6 +401,11 @@ module Worldwide
       !!format["show"]&.include?("{city}")
     end
 
+    # Does this region have provinces in their addresses?
+    def has_provinces?
+      !!format["show"]&.include?("{province}")
+    end
+
     # Is this Region considered a "province" (political subdivision of a "country")?
     def province?
       @province
@@ -460,6 +472,24 @@ module Worldwide
       end
     end
 
+    # Returns the format type of the postal code.
+    # Analyzes the postal code example and regex pattern to determine if it contains
+    # only numbers, alphanumeric characters, or numbers with punctuation/spaces.
+    # Mainly used to determine the type of keyboard to show on mobile views.
+    #
+    # @return [String, nil] One of "ALPHANUMERIC", "NUMERIC", "NUMERIC_AND_PUNCTUATION", or nil if no zip_example
+    def zip_type
+      return nil if zip_example.nil?
+
+      if zip_example.match?(/[A-Za-z]/)
+        FORMAT_TYPES[:ALPHANUMERIC]
+      elsif zip_example.match?(/[[:punct:]\s]/) || zip_regex&.match?(/}-|\\-|-[?+*]|\(-/)
+        FORMAT_TYPES[:NUMERIC_AND_PUNCTUATION]
+      else
+        FORMAT_TYPES[:NUMERIC]
+      end
+    end
+
     # Returns whether (and how firmly) we require a value in the zip field
     # Possible returns:
     #  - "required" means a value must be supplied

data/lib/worldwide/version.rb

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

metadata

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