human_number 0.1.9 → 0.2.0

data/lib/human_number.rb

@@ -8,6 +8,7 @@ require_relative "human_number/version"
 require_relative "human_number/locale_support"
 require_relative "human_number/formatters/number"
 require_relative "human_number/formatters/currency"
+require_relative "human_number/number_system"
 
 module HumanNumber
   class Error < StandardError; end
@@ -179,6 +180,70 @@ module HumanNumber
       Formatters::Currency.format(formatted_number, currency_code:, locale:)
     end
 
+    # Determines the number system used for a given locale.
+    #
+    # This method identifies which cultural number system (Western, East Asian, or Indian)
+    # is used for formatting numbers in the specified locale.
+    #
+    # @param locale [Symbol, String] The locale for system determination (default: current I18n locale)
+    #   Determines which cultural number system to use for formatting
+    #
+    # @return [Symbol] The number system identifier
+    #   - `:default` - Western system (K/M/B/T for thousand/million/billion/trillion)
+    #   - `:east_asian` - East Asian system (만/억/조 or 万/億/兆)
+    #   - `:indian` - Indian subcontinent system (thousand/lakh/crore)
+    #
+    # @example Basic usage
+    #   HumanNumber.number_system(locale: :en)     #=> :default
+    #   HumanNumber.number_system(locale: :ko)     #=> :east_asian
+    #   HumanNumber.number_system(locale: :hi)     #=> :indian
+    #
+    # @example Cultural system examples
+    #   HumanNumber.number_system(locale: :ja)     #=> :east_asian (Japanese: 万/億/兆)
+    #   HumanNumber.number_system(locale: :"zh-CN") #=> :east_asian (Chinese: 万/億/兆)
+    #   HumanNumber.number_system(locale: :"en-IN") #=> :indian (Indian English: lakh/crore)
+    #
+    # @see NumberSystem.number_system The underlying implementation
+    def number_system(locale: I18n.locale)
+      validate_locale!(locale)
+      NumberSystem.number_system(locale:)
+    end
+
+    # Determines the number system used for a given currency.
+    #
+    # This method identifies which cultural number system is typically used
+    # when formatting amounts in the specified currency, based on the currency's
+    # primary cultural and linguistic context.
+    #
+    # @param currency_code [String] ISO 4217 currency code (e.g., 'USD', 'KRW', 'INR')
+    #   The currency code to determine the number system for
+    #
+    # @return [Symbol] The number system identifier
+    #   - `:default` - Western system (K/M/B/T for thousand/million/billion/trillion)
+    #   - `:east_asian` - East Asian system (만/억/조 or 万/億/兆)
+    #   - `:indian` - Indian subcontinent system (thousand/lakh/crore)
+    #
+    # @example Basic usage
+    #   HumanNumber.currency_number_system(currency_code: 'USD') #=> :default
+    #   HumanNumber.currency_number_system(currency_code: 'KRW') #=> :east_asian
+    #   HumanNumber.currency_number_system(currency_code: 'INR') #=> :indian
+    #
+    # @example East Asian currencies
+    #   HumanNumber.currency_number_system(currency_code: 'JPY') #=> :east_asian
+    #   HumanNumber.currency_number_system(currency_code: 'CNY') #=> :east_asian
+    #   HumanNumber.currency_number_system(currency_code: 'HKD') #=> :east_asian
+    #
+    # @example Default system currencies
+    #   HumanNumber.currency_number_system(currency_code: 'EUR') #=> :default
+    #   HumanNumber.currency_number_system(currency_code: 'GBP') #=> :default
+    #   HumanNumber.currency_number_system(currency_code: 'CAD') #=> :default
+    #
+    # @see NumberSystem.currency_number_system The underlying implementation
+    def currency_number_system(currency_code:)
+      validate_currency_code!(currency_code)
+      NumberSystem.currency_number_system(currency_code:)
+    end
+
     private
 
     # Input validation methods - minimal validation for stability

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: human_number
 version: !ruby/object:Gem::Version
-  version: 0.1.9
+  version: 0.2.0
 platform: ruby
 authors:
 - Ether Moon
@@ -82,6 +82,7 @@ files:
 - lib/human_number/formatters/currency.rb
 - lib/human_number/formatters/number.rb
 - lib/human_number/locale_support.rb
+- lib/human_number/number_system.rb
 - lib/human_number/rails/helpers.rb
 - lib/human_number/railtie.rb
 - lib/human_number/version.rb