worldwide 1.25.6 → 1.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9995bb8a7911cba1d7e0602921122a2101d9fb4c1420259b8466f9f175f4a72e
-  data.tar.gz: 8c0702f3d76fd8eafd7683b31de542e655a33157b9c9c8ff1881cf816c4d75bf
+  metadata.gz: 60cb3f293340533a39f8316ec7dbc1fe4dfb35483f2603cf348240db5c34ae8c
+  data.tar.gz: 74fc4ebce8fc936e6f0c80c5fab79a6c7d8534c5a4aae289a0784b2a9f9ebee1
 SHA512:
-  metadata.gz: 1f07d3fd68d9438584c69c46330df60ae256a4ccd86b1fc8120c43165fa3a1ee4c69a9fed8a292791eeefe18ac9a68a0245e526bb58d99e6f2e6d129b3e2ac15
-  data.tar.gz: 77f7959d3aa5d385f6f6012cc9acdfd4e0d7502bb6f2b47bb6a37411a009f394389af071e9948f86d83d7250ab88cc0eadcb35cd99fe56be1fa946f18bbdde3a
+  metadata.gz: 3e347d426de7e52e23504e3632a8fb4ad3e3473994138f2506859696e78b04e6ceaf2bbbab9074d34c2cbcc0828427227d2ff9eea630b97aafa2ddd5379a66be
+  data.tar.gz: 7107f99efa3ca3a9532585f69cfee927b619988bedb31f470bf46fc6b05b6ec28ba7a9f1ac2aa8fc1246922b29c83d7ba9a3ca8168c396fbd371d9cd954a814b

data/.github/workflows/ci-typescript.yml

@@ -15,7 +15,7 @@ jobs:
         working-directory: lang/typescript
     steps:
       - name: Check out code
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
       - name: Setup Node
         uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
         with:

data/.github/workflows/ci.yml

@@ -20,9 +20,9 @@ jobs:
       BUNDLE_GEMFILE: ${{ matrix.gemfile }}
     steps:
     - name: Check out code
-      uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
     - name: Set up Ruby ${{ matrix.ruby }}
-      uses: ruby/setup-ruby@09a7688d3b55cf0e976497ff046b70949eeaccfd # v1.288.0
+      uses: ruby/setup-ruby@a30dfa457ad68707b8b910ac3a244714b61c0626 # v1.320.0
       with:
         ruby-version: ${{ matrix.ruby }}
         bundler-cache: true

data/.github/workflows/npm-release.yml

@@ -20,7 +20,7 @@ jobs:
         working-directory: lang/typescript
     steps:
       - name: Checkout Repo
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           token: ${{ secrets.SHOPIFY_GH_ACCESS_TOKEN }}
       - name: Setup Node

data/.rubocop.yml

@@ -2,8 +2,10 @@
 inherit_gem:
   rubocop-shopify: rubocop.yml
 
-require:
+plugins:
   - rubocop-minitest
+
+require:
   - rubocop-performance
   - rubocop-rake
 

data/CHANGELOG.md

@@ -29,6 +29,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ---
 
+## [1.26.0] - 2026-07-22
+- Add `Worldwide::BusinessNames.abbreviated` for script-aware abbreviation of a single business name string. [#538](https://github.com/Shopify/worldwide/pull/538) [#553](https://github.com/Shopify/worldwide/pull/553)
+- Add `Worldwide::Names.abbreviated` to abbreviate personal names by script. [#539](https://github.com/Shopify/worldwide/pull/539)
+- Fix trailing whitespace in formatted Japanese addresses when the postal code is blank or excluded. [#548](https://github.com/Shopify/worldwide/pull/548)
+- Fix `Address#format` dropping backslash sequences (e.g. `\2`) in field values. [#533](https://github.com/Shopify/worldwide/pull/533)
+
 ## [1.25.6] - 2026-07-21
 - Bump i18n from 1.14.1 to 1.15.2 (now required as `>= 1.15`) and update `Cldr.with_cldr` to mirror i18n's fiber-aware config and fallbacks storage so the CLDR config still applies on Ruby 3.2+. [#540](https://github.com/Shopify/worldwide/pull/540)
 

data/Gemfile

@@ -9,7 +9,7 @@ gem "ruby-cldr", git: "https://github.com/ruby-i18n/ruby-cldr.git", ref: "86a5d7
 # Specify your gem's dependencies in worldwide.gemspec
 gemspec
 
-gem "rake", "~> 13.0"
+gem "rake", "~> 13.4"
 
 group :development do
   gem "minitest-focus", require: false
@@ -24,7 +24,7 @@ group :development do
 end
 
 group :test do
-  gem "minitest", "~> 5.0"
+  gem "minitest", "~> 5.27"
   gem "minitest-reporters"
   gem "mocha"
 end

data/Gemfile.lock

@@ -13,7 +13,7 @@ GIT
 PATH
   remote: .
   specs:
-    worldwide (1.25.6)
+    worldwide (1.26.0)
       activesupport (>= 7.0)
       i18n (>= 1.15)
       phonelib (~> 0.8)
@@ -21,94 +21,100 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.1.1)
+    activesupport (7.2.3.1)
       base64
+      benchmark (>= 0.3)
       bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+      concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
-      minitest (>= 5.1)
-      mutex_m
-      tzinfo (~> 2.0)
-    ansi (1.5.0)
-    ast (2.4.2)
-    base64 (0.1.1)
-    bigdecimal (3.1.4)
-    builder (3.2.4)
-    byebug (11.1.3)
+      logger (>= 1.4.2)
+      minitest (>= 5.1, < 6)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+    ansi (1.6.0)
+    ast (2.4.3)
+    base64 (0.3.0)
+    benchmark (0.5.0)
+    bigdecimal (4.1.2)
+    builder (3.3.0)
+    byebug (12.0.0)
     coderay (1.1.3)
-    concurrent-ruby (1.3.7)
-    connection_pool (2.4.1)
-    drb (2.1.1)
-      ruby2_keywords
+    concurrent-ruby (1.3.8)
+    connection_pool (2.5.5)
+    drb (2.2.3)
     i18n (1.15.2)
       concurrent-ruby (~> 1.0)
-    json (2.7.1)
+    json (2.21.1)
     language_server-protocol (3.17.0.6)
+    lint_roller (1.1.0)
     logger (1.7.0)
     method_source (1.1.0)
-    minitest (5.17.0)
-    minitest-focus (1.3.1)
-      minitest (>= 4, < 6)
-    minitest-reporters (1.5.0)
+    minitest (5.27.0)
+    minitest-focus (1.4.1)
+      minitest (> 5.0)
+    minitest-reporters (1.8.0)
       ansi
       builder
-      minitest (>= 5.0)
+      minitest (>= 5.0, < 7)
       ruby-progressbar
     mocha (3.1.0)
       ruby2_keywords (>= 0.0.5)
-    mutex_m (0.1.2)
     nokogiri (1.19.3-arm64-darwin)
       racc (~> 1.4)
     nokogiri (1.19.3-x86_64-linux-gnu)
       racc (~> 1.4)
-    parallel (1.24.0)
-    parser (3.3.0.5)
+    parallel (1.28.0)
+    parser (3.3.12.0)
       ast (~> 2.4.1)
       racc
     phonelib (0.10.22)
     prism (1.9.0)
-    pry (0.14.2)
+    pry (0.15.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    pry-byebug (3.10.1)
-      byebug (~> 11.0)
-      pry (>= 0.13, < 0.15)
+    pry-byebug (3.11.0)
+      byebug (~> 12.0)
+      pry (>= 0.13, < 0.16)
     psych (5.1.0)
       stringio
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.0.6)
+    rake (13.4.2)
     rake-compiler (1.3.1)
       rake
     rbs (3.10.4)
       logger
       tsort
-    regexp_parser (2.9.0)
-    rexml (3.4.2)
-    rubocop (1.62.1)
+    regexp_parser (2.12.0)
+    rubocop (1.88.2)
       json (~> 2.3)
-      language_server-protocol (>= 3.17.0)
-      parallel (~> 1.10)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (>= 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.31.2)
-      parser (>= 3.3.0.4)
-    rubocop-minitest (0.27.0)
-      rubocop (>= 0.90, < 2.0)
-    rubocop-performance (1.16.0)
-      rubocop (>= 1.7.0, < 2.0)
-      rubocop-ast (>= 0.4.0)
-    rubocop-rake (0.6.0)
-      rubocop (~> 1.0)
-    rubocop-shopify (2.12.0)
-      rubocop (~> 1.44)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.50.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-minitest (0.40.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+    rubocop-rake (0.7.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1)
+    rubocop-shopify (2.18.0)
+      rubocop (~> 1.62)
     ruby-lsp (0.26.10)
       language_server-protocol (~> 3.17.0)
       prism (>= 1.2, < 2.0)
@@ -116,12 +122,15 @@ GEM
     ruby-progressbar (1.13.0)
     ruby2_keywords (0.0.5)
     rubyzip (2.3.2)
+    securerandom (0.4.1)
     stringio (3.1.0)
     thor (1.2.1)
     tsort (0.2.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (2.5.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
 
 PLATFORMS
   arm64-darwin-21
@@ -131,12 +140,12 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
-  minitest (~> 5.0)
+  minitest (~> 5.27)
   minitest-focus
   minitest-reporters
   mocha
   pry-byebug
-  rake (~> 13.0)
+  rake (~> 13.4)
   rake-compiler
   rubocop
   rubocop-minitest

data/README.md

@@ -91,6 +91,7 @@ Here the list of the features we currently support:
 - [🕰  Localized Timezone](#--localized-timezone)
   - [➡🕰  Map Deprecated Timezone Name to Modern Name](#--map-deprecated-timezone-name-to-modern-name)
 - [👥  Names](#--names)
+- [🏢 Business names](#-business-names)
 - [👥  Lists](#--lists)
 - [❣️   Punctuation](#️---punctuation)
 - [🤑  Currency support](#--currency-support)
@@ -625,6 +626,8 @@ Say, for example, your customer has the given name "Ken" and surname "Tanaka".
 
 `Names.surname_first?` will let you know if the current locale places the surname (family name, last name) before the given name ("first name", forename).
 
+`Names.abbreviated` returns a short form of a personal name based on its writing script. Latin names use the first letters of the given name and surname. Han, Hiragana, and Katakana names use the surname. Hangul names use the given name when it is within `ideal_max_length`, or its first grapheme cluster when it is longer. Thai names use the first grapheme cluster of the given name. The Hangul and Thai rules fall back to the surname when the given name is blank. The method returns `nil` when it cannot abbreviate the name, allowing the caller to fall back to `Names.greeting`.
+
 ```ruby
 I18n.with_locale(:en) { Worldwide.names.full(given: "John", surname: "Smith") }
 => "John Smith"
@@ -636,12 +639,37 @@ I18n.with_locale(:en) { Worldwide.names.greeting(given: "John", surname: "Smith"
 => "John"
 I18n.with_locale(:ja) { Worldwide.names.greeting(given: "John", surname: "Smith") }
 => "Smith様"
+Worldwide.names.abbreviated(given: "John", surname: "Smith")
+=> "JS"
+Worldwide.names.abbreviated(given: "이슬", surname: "재현", ideal_max_length: 1)
+=> "이"
 Worldwide.names.surname_first?("en")
 => false
 Worldwide.names.surname_first?("ja")
 => true
 ```
 
+### 🏢 Business names
+
+`Worldwide::BusinessNames` abbreviates a single business name according to its detected script. The default `ideal_max_length` is 3. The method returns `nil` when the input is blank, uses multiple or unsupported scripts, or cannot be abbreviated by the script's rules. It is also available through `Worldwide.business_names`.
+
+```ruby
+Worldwide.business_names.abbreviated(name: "Shopify")
+=> "Sho"
+Worldwide::BusinessNames.abbreviated(name: "A Better Shop")
+=> "ABS"
+Worldwide::BusinessNames.abbreviated(name: "A Better Looking Shop")
+=> "AS"
+Worldwide::BusinessNames.abbreviated(name: "삼성 한국어", ideal_max_length: 2)
+=> "삼성"
+Worldwide::BusinessNames.abbreviated(name: "任天堂")
+=> "任天堂"
+Worldwide::BusinessNames.abbreviated(name: "อภัADSยวงศ์")
+=> nil
+```
+
+Latin names use the first grapheme clusters of one word, the initials of up to `ideal_max_length` words, or the initials of the first and last words when there are more words. Hangul names use the first `ideal_max_length` grapheme clusters of the first word. Thai names without spaces use the first grapheme cluster. Han, Katakana, and Hiragana names without spaces are returned in full. Thai, Han, Katakana, and Hiragana names with spaces return `nil`.
+
 ### 👥  Lists
 
 This module will offer you a way to display a list while respecting locale preferences.

data/lib/worldwide/address.rb

@@ -296,7 +296,7 @@ module Worldwide
         result << line unless blank?(line.join)
       end
 
-      result + additional_lines.map { |x| [x] }
+      result + additional_lines.zip
     end
 
     # Returns a hash containing the values for each address field
@@ -343,7 +343,7 @@ module Worldwide
 
           replacement ||= ""
 
-          mapped = mapped.gsub("{#{snake_to_camel_case(key)}}", replacement)
+          mapped = mapped.gsub("{#{snake_to_camel_case(key)}}") { replacement }
         end
         mapped
       end
@@ -354,7 +354,7 @@ module Worldwide
     def japan_with_non_japanese_script?
       text = build_formatted_address_data.values.join
 
-      country_code == "JP" && Worldwide::Scripts.identify(text: text).intersection(JAPANESE_SCRIPTS).empty?
+      country_code == "JP" && !Worldwide::Scripts.identify(text: text).intersect?(JAPANESE_SCRIPTS)
     end
 
     def normalize_city
@@ -446,13 +446,11 @@ module Worldwide
     def strip_extra_chars(lines:, excluded_fields:)
       result = []
       lines.each do |components|
-        line = components.filter_map do |component|
-          component unless component.empty?
-        end
-
-        line = strip_extra_japanese_chars(line: line, excluded_fields: excluded_fields)
+        line = strip_extra_japanese_chars(line: components, excluded_fields: excluded_fields)
+        line.map!(&:strip)
+        line.reject!(&:empty?)
 
-        result << line.map(&:strip) unless blank?(line.join(""))
+        result << line unless blank?(line.join(""))
       end
       result
     end
@@ -463,7 +461,7 @@ module Worldwide
     #   - `〒` ("yuubin" mark) is a prefix that's prepended to the postal code (zip)
     # If the associated field is excluded/empty, we need to suppress the associated special character.
     def strip_extra_japanese_chars(line:, excluded_fields:)
-      return nil if line.nil?
+      return if line.nil?
 
       line.map do |field|
         stripped = field

data/lib/worldwide/address_validator.rb

@@ -9,6 +9,7 @@ module Worldwide
 
     class << self
       extend Forwardable
+
       def_delegators :instance, :errors, :valid?
     end
 

data/lib/worldwide/business_names.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Worldwide
+  class BusinessNames
+    class << self
+      # Returns a script aware abbreviation, or nil when the name cannot be abbreviated.
+      def abbreviated(name:, ideal_max_length: 3)
+        name_stripped = name&.strip
+
+        return if Util.blank?(name_stripped)
+        return unless ideal_max_length.is_a?(Integer) && ideal_max_length.positive?
+
+        scripts = Scripts.identify(text: name_stripped)
+        return unless scripts.one?
+
+        case scripts.first
+        when :Latin
+          latin_abbreviation(name_stripped, ideal_max_length)
+        when :Hangul
+          name_stripped.split(" ", 2).first.grapheme_clusters[0, ideal_max_length].join
+        when :Thai
+          # Thai does not use spaces between words.
+          return if name_stripped.include?(" ")
+
+          name_stripped.grapheme_clusters.first
+        when :Han, :Katakana, :Hiragana
+          return if name_stripped.include?(" ")
+
+          name_stripped
+        end
+      end
+
+      private
+
+      def latin_abbreviation(name, ideal_max_length)
+        words = name.split(" ")
+
+        if words.length == 1
+          words.first.grapheme_clusters[0, ideal_max_length].join
+        elsif words.length <= ideal_max_length
+          words.map { |word| word.grapheme_clusters.first }.join
+        else
+          words.first.grapheme_clusters.first + words.last.grapheme_clusters.first
+        end
+      end
+    end
+  end
+end

data/lib/worldwide/cldr/date_format_pattern.rb

@@ -42,36 +42,36 @@ module Worldwide
           tokens
         end
 
-        private
-
         PATTERN_FIELD = /([a-zA-Z])\1*/
         SINGLE_QUOTE_LITERAL = /''/
         QUOTED_LITERAL = /'(([^']|#{SINGLE_QUOTE_LITERAL})*[^'])'/
         UNQUOTED_LITERAL = /[^a-zA-Z']+/
 
+        private
+
         def parse_field(format)
-          return nil unless format.start_with?(PATTERN_FIELD)
+          return unless format.start_with?(PATTERN_FIELD)
 
           match = PATTERN_FIELD.match(format)
           [Field.from(match[0]), match.end(0)]
         end
 
         def parse_single_quote(format)
-          return nil unless format.start_with?(SINGLE_QUOTE_LITERAL)
+          return unless format.start_with?(SINGLE_QUOTE_LITERAL)
 
           match = SINGLE_QUOTE_LITERAL.match(format)
           [Literal.new("'"), match.end(0)]
         end
 
         def parse_quoted_literal(format)
-          return nil unless format.start_with?(QUOTED_LITERAL)
+          return unless format.start_with?(QUOTED_LITERAL)
 
           match = QUOTED_LITERAL.match(format)
           [Literal.new(match[1].gsub(SINGLE_QUOTE_LITERAL, "'")), match.end(0)]
         end
 
         def parse_unquoted_literal(format)
-          return nil unless format.start_with?(UNQUOTED_LITERAL)
+          return unless format.start_with?(UNQUOTED_LITERAL)
 
           match = UNQUOTED_LITERAL.match(format)
           [Literal.new(match[0]), match.end(0)]

data/lib/worldwide/cldr/fallbacks.rb

@@ -38,7 +38,7 @@ module Worldwide
         loop do
           if cldr_defined_parents[ancestors.last]
             ancestors << cldr_defined_parents[ancestors.last]
-          elsif I18n::Locale::Tag.tag(ancestors.last).parents.count > 0
+          elsif I18n::Locale::Tag.tag(ancestors.last).parents.any?
             ancestors << I18n::Locale::Tag.tag(ancestors.last).parents.first.to_sym
           else
             break

data/lib/worldwide/config.rb

@@ -70,7 +70,7 @@ module Worldwide
           # we don't want to trigger the backend resolution until after we've determined whether they have set it explicitly.
           class_variable = "@@#{key}".to_sym
           instance_variable = "@#{key}".to_sym
-          i18n_config.class.class_variables.include?(class_variable) || i18n_config.instance_variables.include?(instance_variable)
+          i18n_config.class.class_variable_defined?(class_variable) || i18n_config.instance_variables.include?(instance_variable)
         else
           i18n_config.key?(key)
         end

data/lib/worldwide/currency.rb

@@ -117,7 +117,7 @@ module Worldwide
       raw_symbol = Worldwide::Cldr.t("currencies.#{@currency_code}.narrow_symbol", default: nil, locale: locale) ||
         Worldwide::Cldr.t("currencies.#{@currency_code}.symbol", default: nil, locale: locale)
 
-      return nil if raw_symbol.nil?
+      return if raw_symbol.nil?
 
       # For some locales (e.g., HK), in-market folks have requested that we leave the CLDR behaviour untouched
       exceptional_symbol = EXCEPTIONS.fetch(@currency_code.to_sym, nil)
@@ -154,7 +154,7 @@ module Worldwide
     private
 
     def combine(amount:, decimal_places:, humanize:, locale:, symbol:)
-      space = if has_space(locale)
+      space = if has_space?(locale)
         # This is U+00A0, the Unicode non-breaking space character
         [160].pack("U*")
       else
@@ -237,7 +237,7 @@ module Worldwide
     end
 
     # Returns true if there should be a space between the amount and the currency symbol
-    def has_space(locale)
+    def has_space?(locale)
       pattern = Worldwide::Cldr.t("numbers.latn.formats.currency.patterns.default.standard", locale: locale)
 
       # Note that CLDR uses these characters in its currency formats:
@@ -250,7 +250,7 @@ module Worldwide
     def minor_symbol
       key = @currency_code
 
-      return nil unless Currency.minor_symbols.key?(key)
+      return unless Currency.minor_symbols.key?(key)
 
       Currency.minor_symbols[key]["symbol"]
     end

data/lib/worldwide/extant_outcodes.rb

@@ -10,6 +10,7 @@ module Worldwide
 
     class << self
       extend Forwardable
+
       def_delegators :instance, :for_country
     end
 

data/lib/worldwide/fields.rb

@@ -12,6 +12,7 @@ module Worldwide
 
     class << self
       extend Forwardable
+
       def_delegators :instance, :field
     end
 

data/lib/worldwide/lists.rb

@@ -3,6 +3,7 @@
 module Worldwide
   module Lists
     extend self
+
     # We assume that the data is expected to returned in the same
     # order as it is received. We are aware of one counter example,
     # Urdu, that we do not support.

data/lib/worldwide/locale.rb

@@ -71,7 +71,7 @@ module Worldwide
       if @name_cache[context].is_a?(I18n::MissingTranslation)
         raise @name_cache[context] if throw
 
-        return nil
+        return
       end
 
       @name_cache[context]
@@ -93,7 +93,7 @@ module Worldwide
       if @endonym.is_a?(I18n::MissingTranslation)
         raise @endonym if throw
 
-        return nil
+        return
       end
 
       @endonym
@@ -113,7 +113,7 @@ module Worldwide
         result = lookup(language, locale: target_locale)
         if result
           transformed = Worldwide::Cldr::ContextTransforms.transform(result, :languages, context, locale: target_locale)
-          break "#{transformed}#{i > 0 ? territories_suffix(code.to_s) : ""}"
+          break "#{transformed}#{territories_suffix(code.to_s) if i > 0}"
         end
       end
     end

data/lib/worldwide/names.rb

@@ -30,6 +30,44 @@ module Worldwide
         names.map { |name| name[0] }
       end
 
+      def abbreviated(given:, surname:, ideal_max_length: 3)
+        given_stripped = given&.strip
+        surname_stripped = surname&.strip
+
+        combined_name = given_stripped.to_s + surname_stripped.to_s
+        return if combined_name.blank? || combined_name.match?(/[\p{Punctuation}\s]/)
+        return unless ideal_max_length.is_a?(Integer) && ideal_max_length.positive?
+
+        scripts = Scripts.identify(text: combined_name)
+        return unless scripts.length == 1
+
+        given_clusters = given_stripped&.grapheme_clusters
+        surname_clusters = surname_stripped&.grapheme_clusters
+
+        # Scripts that Scripts.identify recognizes but that have no abbreviation rule
+        # here (e.g. Arabic) intentionally return nil so callers fall back to a greeting.
+        case scripts.first
+        when :Latin
+          [given_stripped, surname_stripped].reject(&:blank?).map { |name| name[0] }.join
+        when :Han, :Katakana, :Hiragana
+          surname_stripped.presence
+        when :Hangul
+          if given_stripped.blank?
+            surname_stripped
+          elsif given_clusters.length > ideal_max_length
+            given_clusters[0]
+          else
+            given_stripped
+          end
+        when :Thai
+          if given_stripped.present?
+            given_clusters[0]
+          elsif surname_stripped.present?
+            surname_clusters[0]
+          end
+        end
+      end
+
       private
 
       def format_name(format, given, surname)

data/lib/worldwide/phone.rb

@@ -15,7 +15,6 @@ module Worldwide
 
     def initialize(number:, country_code: nil)
       @number = number
-      @country_code = country_code&.to_s&.downcase&.to_sym
       @parsed_number, @extension, @country_code = parse_number(number: @number, country_code: country_code)
     end
 

data/lib/worldwide/region.rb

@@ -375,7 +375,7 @@ module Worldwide
     # 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:)
-      return nil unless country?
+      return unless country?
 
       Worldwide::Fields.field(country_code: iso_code, field_key: key)
     end
@@ -479,7 +479,7 @@ module Worldwide
     #
     # @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?
+      return if zip_example.nil?
 
       if zip_example.match?(/[A-Za-z]/)
         FORMAT_TYPES[:ALPHANUMERIC]
@@ -554,7 +554,7 @@ module Worldwide
       field ? !!field["required"] : false
     end
 
-    def answers_to_cldr_code(search_code)
+    def answers_to_cldr_code?(search_code)
       return false if Util.blank?(search_code) || Util.blank?(cldr_code)
       return true if search_code.casecmp(cldr_code).zero?
 
@@ -562,7 +562,7 @@ module Worldwide
       "#{pc&.cldr_code&.downcase}#{cldr_code.downcase}" == search_code.downcase
     end
 
-    def answers_to_iso_code(search_code)
+    def answers_to_iso_code?(search_code)
       return true if search_code == iso_code
 
       pc = parent_country
@@ -616,9 +616,9 @@ module Worldwide
     #
     # Returns the Region in which the zip belongs based on the prefix, or `nil` if no match is found.
     def search_prefixes_by_normalized_zip(prefixes:, zip:, allow_partial_zip: false)
-      return nil if Worldwide::Util.blank?(prefixes)
-      return nil if Worldwide::Util.blank?(zip)
-      return nil unless allow_partial_zip || passes_country_zip_regexp?(value: zip)
+      return if Worldwide::Util.blank?(prefixes)
+      return if Worldwide::Util.blank?(zip)
+      return unless allow_partial_zip || passes_country_zip_regexp?(value: zip)
 
       stripped = Zip.strip_optional_country_prefix(country_code: iso_code, zip: zip)
 

data/lib/worldwide/regions.rb

@@ -12,6 +12,7 @@ module Worldwide
 
     class << self
       extend Forwardable
+
       def_delegators :instance, :all, :region_by_cldr_code, :region
     end
 

data/lib/worldwide/regions_loader.rb

@@ -225,8 +225,6 @@ module Worldwide
       spec = YAML.safe_load_file(filename)
       code = spec["code"]
 
-      loaded_regions = []
-
       region = Region.new(
         alpha_three: country_codes.dig(code, "alpha3"),
         continent: false,

data/lib/worldwide/version.rb

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

data/lib/worldwide/zip.rb

@@ -50,7 +50,7 @@ module Worldwide
     # @param min_confidence [Integer] The minimum confidence level (between 0-100) that is accepted from a suggestion (optional)
     # @return [Region] which is a "country" if we have a suggestion, or `nil` if we do not.
     def find_country(country_code: nil, zip:, min_confidence: 0)
-      return nil unless Util.present?(zip)
+      return unless Util.present?(zip)
 
       country = Worldwide.region(code: country_code) unless country_code.nil?
       return country if country&.valid_zip?(zip)
@@ -62,7 +62,7 @@ module Worldwide
       return suggestion unless suggestion.nil? || confidence.nil? || confidence < min_confidence
 
       # If our postal code is wholly numeric, we can't make an intelligent suggestion without an alleged country.
-      return nil unless adjusted_zip.match?(/[A-Z]/)
+      return unless adjusted_zip.match?(/[A-Z]/)
 
       # Try a broader-ranging match without considering the alleged country
       # We'll see if we have only a single suggestion and, if so, return it.
@@ -95,7 +95,7 @@ module Worldwide
         return autofill if Util.present?(autofill)
       end
 
-      return nil if zip.nil?
+      return if zip.nil?
 
       # Convert to uppercase
       # Convert numeric and romaji full-width to half-width
@@ -261,8 +261,6 @@ module Worldwide
       end
     end
 
-    private
-
     # Countries that use GB-style postal code spacing, and should normalize the same way as GB
     GB_STYLE_ZIP_COUNTRIES = ["GB", "GG", "GI", "IM", "JE"]
     private_constant :GB_STYLE_ZIP_COUNTRIES
@@ -355,6 +353,8 @@ module Worldwide
     }
     private_constant :OPTIONAL_PREFIX_COUNTRIES
 
+    private
+
     REQUIRED_PREFIX_COUNTRIES = {
       VG: "VG",
     }

data/lib/worldwide.rb

@@ -14,6 +14,7 @@ require "worldwide/extant_outcodes"
 
 require "worldwide/address"
 require "worldwide/address_validator"
+require "worldwide/business_names"
 require "worldwide/calendar"
 require "worldwide/cldr"
 require "worldwide/cldr/context_transforms"
@@ -54,6 +55,10 @@ module Worldwide
       Address.new(**kwargs)
     end
 
+    def business_names
+      BusinessNames
+    end
+
     def currency(code:)
       currency_code = code.to_s.upcase.rjust(3, "0")
       @currencies_cache[currency_code] ||= Currency.new(code: currency_code)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: worldwide
 version: !ruby/object:Gem::Version
-  version: 1.25.6
+  version: 1.26.0
 platform: ruby
 authors:
 - Shopify
@@ -8677,6 +8677,7 @@ files:
 - lib/worldwide.rb
 - lib/worldwide/address.rb
 - lib/worldwide/address_validator.rb
+- lib/worldwide/business_names.rb
 - lib/worldwide/calendar.rb
 - lib/worldwide/calendar/gregorian.rb
 - lib/worldwide/cldr.rb
@@ -8735,7 +8736,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.14
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Internationalization and localization APIs
 test_files: []