human_number 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ab664232472a72c0114441a528ec9e72b1287d2cb0123d993b24324aeaa4f6f
-  data.tar.gz: '080aabbc217c4fc67ca01d4d9aa99791d8826e96bb83c2adb418ac09d7d6e27f'
+  metadata.gz: 7e0d600c4f0ff53b38dcd26865c3b55ef28f3a2f22e3ea69cdea9e22b8f81a41
+  data.tar.gz: 8da74420bb439d1d5ccc331d9e96b6c0936aefe2f9b5e2df3762201bd5745198
 SHA512:
-  metadata.gz: d1ad60597131895ef985c4f513d9f14842fa05b64310e947631dd1f34bdf5eb9c823cce3643534ffb06aa7c93015eec7118a5569c03d76263040c1127274d825
-  data.tar.gz: e12a574d465e336e25e95151dd007afe9a2065f8fec9652f7a59824fe1094120b75f5c8f715ae2d4948587037fbf5b162a6897cbec0753e6f6848879770133dc
+  metadata.gz: 3a2f779396168c7519591e82e4c79358cd84143dea4c8665e13a16d71ed946b9dc2b7d0790daeaac52b083e1c45c13f767910ca498b36f2943fd6e3be1ead350
+  data.tar.gz: ac05daeca413e08338aec8b0776accee0abdb3ecfad05cab004d83c31084d4f9faec622e6069d7578256c801882311c6e2f2e64bdaf425711d358ace7339cc1b

data/.rubocop.yml

@@ -59,5 +59,3 @@ Metrics/MethodLength:
 
 Metrics/ParameterLists:
   Max: 6
-
-# RSpec rules removed - using basic RuboCop only

data/BUILD.md

@@ -0,0 +1,246 @@
+# Build and Publish Guide
+
+This project provides three different ways to build and publish the gem, choose the one that best fits your workflow:
+
+## 🔧 Option 1: Rake Tasks (Recommended for Ruby developers)
+
+The most Ruby-native approach using rake tasks.
+
+### Available Tasks
+```bash
+# List all gem-related tasks
+rake -T gem
+
+# Run validations only
+rake gem:validate
+
+# Build gem with full validations
+rake gem:build
+
+# Quick build without validations (for testing)  
+rake gem:build_quick
+
+# Publish to RubyGems with full validations
+rake gem:publish
+
+# Show gem information
+rake gem:info
+
+# Clean build artifacts
+rake gem:clean
+
+# Bump version interactively and commit
+rake gem:bump
+
+# Convenient aliases
+rake build      # Same as gem:build
+rake release    # Same as gem:publish
+```
+
+### Examples
+```bash
+# Full build and publish workflow
+rake gem:validate    # Run tests, linting, git checks
+rake gem:build       # Build the gem 
+rake gem:publish     # Publish to RubyGems
+
+# Or use the all-in-one command
+rake gem:publish     # Does validation + build + publish
+
+# Quick development testing
+rake gem:build_quick # Build without validations
+```
+
+## 🐚 Option 2: Shell Script (Cross-platform compatible)
+
+A bash script that works on any Unix-like system.
+
+### Available Commands
+```bash
+# Show help
+./scripts/build_and_publish.sh help
+
+# Run validations only
+./scripts/build_and_publish.sh validate
+
+# Build gem with full validations
+./scripts/build_and_publish.sh build
+
+# Quick build without validations (for testing)
+./scripts/build_and_publish.sh build-quick
+
+# Publish to RubyGems with full validations
+./scripts/build_and_publish.sh publish
+
+# Show gem information
+./scripts/build_and_publish.sh info
+
+# Clean build artifacts
+./scripts/build_and_publish.sh clean
+
+# Bump version interactively and commit
+./scripts/build_and_publish.sh bump
+```
+
+### Examples
+```bash
+# Full build and publish workflow
+./scripts/build_and_publish.sh validate  # Run all checks
+./scripts/build_and_publish.sh build     # Build the gem
+./scripts/build_and_publish.sh publish   # Publish to RubyGems
+
+# Quick development testing
+./scripts/build_and_publish.sh build-quick
+```
+
+## ⚙️ Option 3: Makefile (Traditional build tool)
+
+Standard make targets for those who prefer Makefiles.
+
+### Available Targets
+```bash
+# Show help
+make help
+
+# Run individual validations
+make test       # Run tests only
+make lint       # Run RuboCop only
+make validate   # Run all validations
+
+# Build gem with full validations
+make build
+
+# Quick build without validations (for testing)
+make build-quick
+
+# Publish to RubyGems with full validations  
+make publish
+
+# Show gem information
+make info
+
+# Clean build artifacts
+make clean
+
+# Bump version interactively and commit
+make bump
+
+# Install dependencies
+make install
+```
+
+### Examples
+```bash
+# Full build and publish workflow
+make validate   # Run tests, linting, git checks
+make build      # Build the gem
+make publish    # Publish to RubyGems
+
+# Quick development testing
+make build-quick
+```
+
+## 🔍 What Each Validation Includes
+
+All three build systems perform the same comprehensive validations:
+
+### ✅ Test Validation
+- Runs the complete RSpec test suite
+- Ensures 100% test coverage
+- Validates all functionality works correctly
+
+### ✅ Code Quality Validation  
+- Runs RuboCop linting
+- Enforces consistent code style
+- Checks for potential issues
+
+### ✅ Git Validation
+- Ensures working directory is clean (no uncommitted changes)
+- Warns if not on `main` branch (with option to continue)
+- Prevents accidental releases from dirty state
+
+### ✅ Build Validation
+- Verifies gemspec is valid
+- Checks all required files are included
+- Ensures gem can be built successfully
+
+## 📦 Build Artifacts
+
+All build methods create gems in the `pkg/` directory:
+- `pkg/human_number-<version>.gem` - The built gem file
+
+Use `make clean`, `rake gem:clean`, or `./scripts/build_and_publish.sh clean` to remove build artifacts.
+
+## 🚀 Publishing Process
+
+When you run the publish command (any of the three options), it will:
+
+1. **Validate**: Run all tests, linting, and git checks
+2. **Build**: Create the gem file
+3. **Tag**: Create a git tag for the version  
+4. **Push**: Push the tag to the remote repository
+5. **Publish**: Upload the gem to RubyGems.org
+
+## 🔖 Version Management
+
+All three build systems include interactive version bumping functionality:
+
+### Version Bump Commands
+
+| Tool | Command | Description |
+|------|---------|-------------|
+| **Rake** | `rake gem:bump` | Interactive version bump with commit |
+| **Shell Script** | `./scripts/build_and_publish.sh bump` | Interactive version bump with commit |
+| **Make** | `make bump` | Interactive version bump with commit |
+
+### Version Bump Process
+
+When you run any version bump command, it will:
+
+1. **Display Current Version**: Shows the current version from `lib/human_number/version.rb`
+2. **Interactive Input**: Prompts you to enter the new version
+3. **Validation**: Ensures semantic versioning format (e.g., `1.2.3` or `1.2.3-alpha.1`)
+4. **Update File**: Modifies the version file with the new version
+5. **Git Commit**: Creates a commit with message `chore: bump version to X.Y.Z`
+6. **Next Steps**: Provides guidance on building and publishing
+
+### Example Workflow
+
+```bash
+# Using rake (recommended for Ruby developers)
+rake gem:bump
+# Current version: 0.1.2
+# Enter new version: 0.2.0
+# ✅ Updated version to 0.2.0
+# ✅ Version bump committed successfully!
+
+# Build and publish
+rake gem:publish
+```
+
+## ⚠️ Prerequisites
+
+Before publishing:
+
+1. **RubyGems Account**: Ensure you have a RubyGems.org account
+2. **API Key**: Configure your RubyGems API key (`gem signin`)
+3. **Version Bump**: Use interactive version bump commands or manually update `lib/human_number/version.rb`
+4. **Clean Git**: Commit all changes before publishing (version bump commands handle this automatically)
+5. **Main Branch**: Recommended to publish from `main` branch
+
+## 🔧 Configuration Changes
+
+**Important**: This setup has removed MFA requirement from the gemspec to simplify the publishing process. If you need MFA, you can re-enable it by adding this line to `human_number.gemspec`:
+
+```ruby
+spec.metadata["rubygems_mfa_required"] = "true"
+```
+
+## 💡 Recommendations
+
+- **For Ruby developers**: Use rake tasks (most native)
+- **For CI/CD pipelines**: Use shell script (most portable)  
+- **For traditional workflows**: Use Makefile (universal)
+- **For quick testing**: Use the `*-quick` variants to skip validations
+
+Choose the tool that best fits your development workflow and team preferences!

data/CHANGELOG.md

@@ -13,7 +13,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Human-readable number formatting** with intelligent, culturally-appropriate abbreviations
 - **Three cultural number systems** automatically selected by locale:
   - **Western System**: K/M/B/T (thousand/million/billion/trillion) for English, German, French, Spanish, Italian, Portuguese, Russian, Dutch, Swedish, Danish, Norwegian
-  - **East Asian System**: 천/만/억/조 (Korean) and 千/万/億/兆 (Japanese/Chinese) for ko, ja, zh, zh-CN, zh-TW locales
+  - **East Asian System**: 만/억/조 (Korean) and 万/億/兆 (Japanese/Chinese) for ko, ja, zh, zh-CN, zh-TW locales
   - **Indian System**: thousand/lakh/crore for Hindi, Urdu, Bengali, and Indian English (hi, ur, bn, en-IN)
 
 #### Currency Formatting
@@ -86,4 +86,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Formatters::Currency**: Currency symbol and format string application
 - **Clean separation**: Number formatting independent of currency concerns
 
-[0.1.0]: https://github.com/yourusername/human_number/releases/tag/v0.1.0
+[0.1.0]: https://github.com/ether-moon/human_number/releases/tag/v0.1.0

data/CLAUDE.md

@@ -87,10 +87,10 @@ The gem automatically selects appropriate number systems based on locale:
   - Used by: English, German, French, Spanish, Italian, Portuguese, Russian, Dutch, Swedish, Danish, Norwegian
   - Target locales: `%i[en es fr de it pt ru nl sv da no]`
 
-- **East Asian System** (`EastAsianSystem`): 천/만/억/조 or 千/万/億/兆
+- **East Asian System** (`EastAsianSystem`): 만/억/조 or 万/億/兆
   - Used by: Korean, Japanese, Chinese
   - Target locales: `%i[ko ja zh zh-CN zh-TW]`
-  - Units: 천/千 (thousand), 만/万 (ten thousand), 억/億 (hundred million), 조/兆 (trillion)
+  - Units: 만/万 (ten thousand), 억/億 (hundred million), 조/兆 (trillion)
 
 - **Indian System** (`IndianSystem`): thousand/lakh/crore
   - Used by: Hindi, Urdu, Bengali, Indian English
@@ -216,4 +216,4 @@ This project is based on the following international standards:
 - [Microsoft Globalization - Currency Formats](https://learn.microsoft.com/en-us/globalization/locale/currency-formats)
 - [Unicode CLDR](http://cldr.unicode.org/)
 - [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)
-- [rails-i18n](https://github.com/svenfuchs/rails-i18n)
+- [rails-i18n](https://github.com/svenfuchs/rails-i18n)

data/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Your Name
+Copyright (c) 2025 Ether Moon
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/Makefile

@@ -0,0 +1,142 @@
+# HumanNumber Gem Build and Publish Makefile
+
+.PHONY: help build publish build-quick validate clean info test lint bump
+
+# Default target
+help:
+	@echo "HumanNumber Gem Build and Publish Makefile"
+	@echo ""
+	@echo "Available targets:"
+	@echo "  build        Build gem with full validations (tests, linting, git checks)"
+	@echo "  publish      Publish gem to RubyGems with full validations"
+	@echo "  build-quick  Build gem without validations (for testing)"
+	@echo "  validate     Run all validations without building"
+	@echo "  test         Run tests only"
+	@echo "  lint         Run RuboCop only"
+	@echo "  info         Show gem and repository information"
+	@echo "  clean        Clean build artifacts"
+	@echo "  bump         Bump version interactively and commit"
+	@echo "  help         Show this help message"
+	@echo ""
+	@echo "Examples:"
+	@echo "  make build          # Build gem with validations"
+	@echo "  make publish        # Build and publish to RubyGems"
+	@echo "  make bump           # Bump version interactively"
+	@echo "  make info           # Show current gem info"
+
+# Run tests
+test:
+	@echo "📋 Running tests..."
+	@bundle exec rspec
+	@echo "✅ All tests passed"
+
+# Run linting
+lint:
+	@echo "🧹 Running RuboCop..."
+	@bundle exec rubocop
+	@echo "✅ RuboCop checks passed"
+
+# Validate git status
+validate-git:
+	@echo "📋 Checking git status..."
+	@if [ -n "$$(git status --porcelain)" ]; then \
+		echo "❌ Git working directory is not clean. Please commit all changes first."; \
+		exit 1; \
+	fi
+	@echo "✅ Git working directory is clean"
+	@current_branch=$$(git rev-parse --abbrev-ref HEAD); \
+	if [ "$$current_branch" != "main" ]; then \
+		echo "⚠️  Warning: You're on branch '$$current_branch', not 'main'"; \
+		read -p "Continue anyway? (y/N): " response; \
+		if [ "$$response" != "y" ] && [ "$$response" != "Y" ]; then \
+			echo "❌ Aborted by user"; \
+			exit 1; \
+		fi; \
+	fi
+	@echo "✅ Git branch check passed"
+
+# Run all validations
+validate: test lint validate-git
+	@echo "✅ All validations passed!"
+
+# Build gem with validations
+build: validate
+	@echo "🔨 Building gem..."
+	@bundle exec rake build
+	@echo "✅ Gem built successfully!"
+
+# Build gem without validations (for testing)
+build-quick:
+	@echo "🔨 Quick building gem (no validations)..."
+	@bundle exec rake build
+	@echo "✅ Gem built!"
+
+# Publish gem to RubyGems
+publish: validate
+	@echo "📦 Publishing gem to RubyGems..."
+	@bundle exec rake release
+	@echo "✅ Gem published successfully!"
+
+# Show gem information
+info:
+	@echo "📋 Gem Information:"
+	@echo "  Name: human_number"
+	@echo "  Version: $$(ruby -r ./lib/human_number/version -e 'puts HumanNumber::VERSION')"
+	@echo "  Built gems: $$(ls pkg/*.gem 2>/dev/null || echo 'none')"
+	@echo "  Git branch: $$(git rev-parse --abbrev-ref HEAD)"
+	@git_status=$$(git status --porcelain); \
+	if [ -z "$$git_status" ]; then \
+		echo "  Git status: clean"; \
+	else \
+		echo "  Git status: dirty"; \
+	fi
+
+# Clean build artifacts
+clean:
+	@echo "🧹 Cleaning build artifacts..."
+	@rm -rf pkg/
+	@echo "✅ Build artifacts cleaned!"
+
+# Bump version interactively and commit
+bump:
+	@echo "🔖 Version Bump"
+	@current_version=$$(ruby -r ./lib/human_number/version -e 'puts HumanNumber::VERSION'); \
+	echo "Current version: $$current_version"; \
+	echo ""; \
+	read -p "Enter new version: " new_version; \
+	if [ -z "$$new_version" ]; then \
+		echo "❌ No version entered. Aborting."; \
+		exit 1; \
+	fi; \
+	if ! echo "$$new_version" | grep -qE "^[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.-]+)?$$"; then \
+		echo "❌ Invalid version format. Please use semantic versioning (e.g., 1.2.3 or 1.2.3-alpha.1)"; \
+		exit 1; \
+	fi; \
+	if [ "$$new_version" = "$$current_version" ]; then \
+		echo "❌ New version is the same as current version. Aborting."; \
+		exit 1; \
+	fi; \
+	version_file="lib/human_number/version.rb"; \
+	sed -i.bak "s/VERSION = \".*\"/VERSION = \"$$new_version\"/" "$$version_file" && rm "$$version_file.bak"; \
+	echo "✅ Updated version to $$new_version"; \
+	echo ""; \
+	echo "📝 Creating version bump commit..."; \
+	git add "$$version_file"; \
+	commit_message="chore: bump version to $$new_version"; \
+	if git commit -m "$$commit_message"; then \
+		echo "✅ Version bump committed successfully!"; \
+		echo ""; \
+		echo "📋 Next steps:"; \
+		echo "  - Review the changes: git show"; \
+		echo "  - Build and publish: make publish"; \
+		echo "  - Push to remote: git push && git push --tags"; \
+	else \
+		echo "❌ Failed to create commit"; \
+		exit 1; \
+	fi
+
+# Install dependencies
+install:
+	@echo "📦 Installing dependencies..."
+	@bundle install
+	@echo "✅ Dependencies installed!"

data/README.md

@@ -5,7 +5,7 @@ HumanNumber is a Ruby gem that implements accurate number formatting based on in
 ## Features
 
 - 🌍 **International Standards Compliance**: Based on Microsoft Globalization and Unicode CLDR standards
-- 🔢 **Cultural Number Systems**: Automatic selection of Western (K/M/B/T), East Asian (천/만/억/조), or Indian (lakh/crore) systems
+- 🔢 **Cultural Number Systems**: Automatic selection of Western (K/M/B/T), East Asian (만/억/조), or Indian (lakh/crore) systems
 - 💰 **Currency Formatting**: ISO 4217 currency codes with native locale precision rules
 - 🏗️ **Intelligent Abbreviations**: Culturally-appropriate large number simplification
 - 🔧 **Rails Integration**: Complete compatibility with Rails I18n infrastructure
@@ -34,7 +34,7 @@ HumanNumber.human_number(50_000, locale: :ko) #=> "5만"
 
 # Currency formatting
 HumanNumber.currency(1234.56, currency_code: 'USD', locale: :en) #=> "$1,234.56"
-HumanNumber.human_currency(1_234_567, currency_code: 'USD', locale: :en) #=> "$1.2M"
+HumanNumber.human_currency(1_234_567, currency_code: 'USD', locale: :en) #=> "$1M"
 ```
 
 ## Installation
@@ -71,17 +71,17 @@ HumanNumber.human_number(1_234_567)           #=> "1.2M"
 HumanNumber.human_number(50_000, locale: :ko) #=> "5만"
 HumanNumber.human_number(50_000, locale: :ja) #=> "5万"
 
-# Precision control (default: max_digits: 2)
-HumanNumber.human_number(1_234_567, max_digits: 1)   #=> "1M"
-HumanNumber.human_number(1_234_567, max_digits: 3)   #=> "1.23M"
-HumanNumber.human_number(1_234_567, max_digits: nil) #=> "1M 234K 567"
+# Significant digits control (default: max_digits: 2)  
+HumanNumber.human_number(1_234_567, max_digits: 1)   #=> "1M"     # 1 significant digit
+HumanNumber.human_number(1_234_567, max_digits: 3)   #=> "1.23M"  # 3 significant digits  
+HumanNumber.human_number(1_234_567, max_digits: nil) #=> "1M 234K 567" # Complete breakdown
 
 # Unit preferences (Western locales only)
 HumanNumber.human_number(1_000_000, abbr_units: true)  #=> "1M"
 HumanNumber.human_number(1_000_000, abbr_units: false) #=> "1 million"
 
 # Minimum thresholds
-HumanNumber.human_number(5_000, min_unit: 10_000)  #=> "5000"
+HumanNumber.human_number(5_000, min_unit: 10_000)  #=> "5,000"
 HumanNumber.human_number(50_000, min_unit: 10_000) #=> "50K"
 
 # Zero trimming (default: true)
@@ -115,7 +115,7 @@ HumanNumber.currency(1234.56, currency_code: 'JPY', locale: :en) #=> "1,235円"
 Human-readable currency formatting with cultural abbreviations.
 
 ```ruby
-HumanNumber.human_currency(1_234_567, currency_code: 'USD', locale: :en) #=> "$1.2M"
+HumanNumber.human_currency(1_234_567, currency_code: 'USD', locale: :en) #=> "$1M"
 HumanNumber.human_currency(50_000, currency_code: 'KRW', locale: :ko)    #=> "5만원"
 
 # Combined options
@@ -129,7 +129,7 @@ In Rails applications, helper methods are automatically available:
 
 ```erb
 <%= human_number(1_234_567) %>                         <!-- 1.2M -->
-<%= human_currency(1_234_567, currency_code: 'USD') %> <!-- $1.2M -->
+<%= human_currency(1_234_567, currency_code: 'USD') %> <!-- $1M -->
 <%= currency(1234.56, currency_code: 'USD') %>         <!-- $1,234.56 -->
 
 <!-- With options -->
@@ -155,12 +155,12 @@ HumanNumber.human_number(1_000_000_000, locale: :en) #=> "1B"
 **Used by:** Korean (ko), Japanese (ja), Chinese (zh, zh-CN, zh-TW)
 
 ```ruby
-HumanNumber.human_number(1_234_567, locale: :ko) #=> "123만"  
-HumanNumber.human_number(1_234_567, locale: :ja) #=> "123万"
+HumanNumber.human_number(1_234_567, locale: :ko) #=> "120만"  
+HumanNumber.human_number(1_234_567, locale: :ja) #=> "120万"
 HumanNumber.human_number(100_000_000, locale: :ko) #=> "1억"
 ```
 
-**Units:** 천/千 (thousand), 만/万 (ten thousand), 억/億 (hundred million), 조/兆 (trillion)
+**Units:** 만/万 (ten thousand), 억/億 (hundred million), 조/兆 (trillion)
 
 ### Indian System (lakh/crore)
 **Used by:** Hindi (hi), Urdu (ur), Bengali (bn), Indian English (en-IN)
@@ -277,7 +277,7 @@ $ rake  # Runs both spec and rubocop
 
 ## Contributing
 
-1. Fork it (https://github.com/yourusername/human_number/fork)
+1. Fork it (https://github.com/ether-moon/human_number/fork)
 2. Create your feature branch (`git checkout -b feature/my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin feature/my-new-feature`)
@@ -320,4 +320,4 @@ See [CHANGELOG.md](CHANGELOG.md) for details.
 
 ## Issues
 
-Please report bugs and feature requests at [GitHub Issues](https://github.com/yourusername/human_number/issues).
+Please report bugs and feature requests at [GitHub Issues](https://github.com/ether-moon/human_number/issues).

data/Rakefile

@@ -10,3 +10,138 @@ require "rubocop/rake_task"
 RuboCop::RakeTask.new
 
 task default: %i[spec rubocop]
+
+# Gem build and publish tasks
+namespace :gem do
+  desc "Run all pre-publish validations"
+  task :validate do
+    puts "🔍 Running pre-publish validations..."
+
+    # Run tests
+    puts "\n📋 Running tests..."
+    Rake::Task[:spec].invoke
+
+    # Run linting
+    puts "\n🧹 Running RuboCop..."
+    Rake::Task[:rubocop].invoke
+
+    # Check git status
+    puts "\n📋 Checking git status..."
+    unless `git status --porcelain`.strip.empty?
+      abort "❌ Git working directory is not clean. Please commit all changes first."
+    end
+
+    # Check if we're on main branch
+    current_branch = `git rev-parse --abbrev-ref HEAD`.strip
+    unless current_branch == "main"
+      puts "⚠️  Warning: You're on branch '#{current_branch}', not 'main'"
+      print "Continue anyway? (y/N): "
+      response = $stdin.gets.chomp.downcase
+      abort "❌ Aborted by user" unless %w[y yes].include?(response)
+    end
+
+    puts "✅ All validations passed!"
+  end
+
+  desc "Build the gem"
+  task build: :validate do
+    puts "\n🔨 Building gem..."
+    Rake::Task["build"].invoke
+    puts "✅ Gem built successfully!"
+  end
+
+  desc "Publish gem to RubyGems (with validations)"
+  task publish: :validate do
+    puts "\n📦 Publishing gem to RubyGems..."
+
+    # Build and push
+    Rake::Task["release"].invoke
+    puts "✅ Gem published successfully!"
+  end
+
+  desc "Quick build without validations (for testing)"
+  task :build_quick do
+    puts "🔨 Quick building gem..."
+    Rake::Task["build"].invoke
+    puts "✅ Gem built!"
+  end
+
+  desc "Clean build artifacts"
+  task :clean do
+    puts "🧹 Cleaning build artifacts..."
+    FileUtils.rm_rf("pkg")
+    puts "✅ Build artifacts cleaned!"
+  end
+
+  desc "Show gem info"
+  task :info do
+    require_relative "lib/human_number/version"
+    puts "\n📋 Gem Information:"
+    puts "  Name: human_number"
+    puts "  Version: #{HumanNumber::VERSION}"
+    puts "  Built gems: #{Dir.glob("pkg/*.gem").join(", ")}"
+    puts "  Git branch: #{`git rev-parse --abbrev-ref HEAD`.strip}"
+    puts "  Git status: #{`git status --porcelain`.strip.empty? ? "clean" : "dirty"}"
+  end
+
+  desc "Bump version interactively and commit"
+  task :bump do
+    require_relative "lib/human_number/version"
+
+    puts "🔖 Version Bump"
+    puts "Current version: #{HumanNumber::VERSION}"
+    puts ""
+
+    # Get new version from user
+    print "Enter new version: "
+    new_version = $stdin.gets.chomp.strip
+
+    if new_version.empty?
+      puts "❌ No version entered. Aborting."
+      exit 1
+    end
+
+    # Validate version format (basic semver check)
+    unless new_version.match?(/^\d+\.\d+\.\d+(-[a-zA-Z0-9.-]+)?$/)
+      puts "❌ Invalid version format. Please use semantic versioning (e.g., 1.2.3 or 1.2.3-alpha.1)"
+      exit 1
+    end
+
+    # Check if version is different
+    if new_version == HumanNumber::VERSION
+      puts "❌ New version is the same as current version. Aborting."
+      exit 1
+    end
+
+    # Update version file
+    version_file = "lib/human_number/version.rb"
+    version_content = File.read(version_file)
+    new_content = version_content.gsub(/VERSION = ".*"/, "VERSION = \"#{new_version}\"")
+
+    File.write(version_file, new_content)
+    puts "✅ Updated version to #{new_version}"
+
+    # Create commit
+    puts "\n📝 Creating version bump commit..."
+    system("git add #{version_file}")
+    commit_message = "chore: bump version to #{new_version}"
+
+    if system("git commit -m '#{commit_message}'")
+      puts "✅ Version bump committed successfully!"
+      puts "\n📋 Next steps:"
+      puts "  - Review the changes: git show"
+      puts "  - Build and publish: rake gem:publish"
+      puts "  - Push to remote: git push && git push --tags"
+    else
+      puts "❌ Failed to create commit"
+      exit 1
+    end
+  end
+end
+
+# Convenient aliases
+desc "Build and publish gem (same as gem:publish)"
+task release: "gem:publish"
+
+desc "Build gem only (same as gem:build)"
+task build: "gem:build"

data/human_number.gemspec

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative "lib/human_number/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "human_number"
+  spec.version = HumanNumber::VERSION
+  spec.authors = ["Ether Moon"]
+  spec.email = ["ethermoon42@gmail.com"]
+
+  spec.summary = "International standard-based number formatting for Ruby applications"
+  spec.description = "HumanNumber implements accurate number formatting based on international standards " \
+                     "including Microsoft Globalization documentation and Unicode CLDR. Provides human-readable " \
+                     "number formats with precise locale-specific decimal separators, thousand separators, " \
+                     "currency formats, and cultural number conventions."
+  spec.homepage = "https://github.com/ether-moon/human_number"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.1.0"
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/ether-moon/human_number"
+  spec.metadata["changelog_uri"] = "https://github.com/ether-moon/human_number/blob/main/CHANGELOG.md"
+  spec.metadata["rubygems_mfa_required"] = "true"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # Runtime dependencies
+  spec.add_dependency "actionview", ">= 5.2"
+  spec.add_dependency "i18n", ">= 1.6", "< 2"
+  spec.add_dependency "rails-i18n", ">= 5.1"
+end

data/lib/human_number/formatters/number.rb

@@ -27,7 +27,7 @@ module HumanNumber
         # @param number [Numeric] Number to format
         # @param locale [Symbol, String] Locale for unit system selection
         # @param abbr_units [Boolean] Use abbreviated symbols vs full words
-        # @param max_digits [Integer, nil] Max digits after decimal, nil for complete mode
+        # @param max_digits [Integer, nil] Maximum significant digits to display, nil for complete mode
         # @param min_unit [Integer, nil] Minimum unit threshold for abbreviation
         # @param trim_zeros [Boolean] Remove trailing decimal zeros
         # @return [String] Formatted number string
@@ -80,14 +80,9 @@ module HumanNumber
           }.freeze
         end
 
-        # Default options for currency number formatting (tighter display)
-        def default_currency_number_options
-          {
-            abbr_units: true,
-            max_digits: 1,
-            min_unit: nil,
-            trim_zeros: true,
-          }.freeze
+        # Format numbers below min_unit threshold with locale-appropriate delimiters
+        def format_below_min_unit(number, locale)
+          number_with_delimiter(number, locale: locale) || number.to_s
         end
 
         private
@@ -121,6 +116,9 @@ module HumanNumber
           def format_number(number, locale:, abbr_units: true, min_unit: nil, max_digits: 2, trim_zeros: true)
             return ZERO_STRING if number.zero?
 
+            # Check if number meets minimum unit threshold for human formatting
+            return Number.format_below_min_unit(number, locale) if min_unit && number.abs < min_unit
+
             parts = if max_digits.nil?
                       format_in_complete_mode(number, locale, abbr_units, min_unit)
                     else
@@ -132,22 +130,20 @@ module HumanNumber
             finalize_result(number, parts)
           end
 
-          def format_in_complete_mode(number, locale, abbr_units, min_unit)
+          def format_in_complete_mode(number, locale, abbr_units, _min_unit)
             # Complete mode shows all units: "1M 234K 567"
             unit_breakdown = break_down_into_all_units(number)
-            units_above_threshold = filter_by_minimum_unit_threshold(unit_breakdown, min_unit)
-            return nil if units_above_threshold.empty?
+            return nil if unit_breakdown.empty?
 
-            format_all_unit_parts(units_above_threshold, locale, abbr_units)
+            format_all_unit_parts(unit_breakdown, locale, abbr_units)
           end
 
-          def format_in_abbreviated_mode(number, locale, abbr_units, max_digits, trim_zeros, min_unit)
+          def format_in_abbreviated_mode(number, locale, abbr_units, max_digits, trim_zeros, _min_unit)
             # Abbreviated mode shows single largest unit: "1.2M"
             unit_breakdown = break_down_into_largest_unit(number)
-            units_above_threshold = filter_by_minimum_unit_threshold(unit_breakdown, min_unit)
-            return nil if units_above_threshold.empty?
+            return nil if unit_breakdown.empty?
 
-            format_abbreviated_unit_parts(units_above_threshold, locale, abbr_units, max_digits, trim_zeros)
+            format_abbreviated_unit_parts(unit_breakdown, locale, abbr_units, max_digits, trim_zeros)
           end
 
           private
@@ -204,10 +200,18 @@ module HumanNumber
 
           # Format unit parts for abbreviated display (e.g., "1.2M")
           def format_abbreviated_unit_parts(breakdown, locale, abbr_units, max_digits, trim_zeros)
+            # Check if we're in human formatting mode (any non-:units parts exist)
+            human_formatting_applied = breakdown.any? { |unit_info| unit_info[:unit_key] != :units }
+
             breakdown.map do |unit_info|
               if unit_info[:unit_key] == :units
-                # Raw numbers don't need significant digits rounding
-                format_raw_number_count(unit_info[:count], max_digits, trim_zeros)
+                if human_formatting_applied
+                  # Part of human formatting - no delimiters
+                  unit_info[:count].to_s
+                else
+                  # Numbers below minimum unit threshold - apply locale formatting
+                  Number.format_below_min_unit(unit_info[:count], locale)
+                end
               else
                 # Format with unit symbol (e.g., "1.2" + "M" = "1.2M")
                 format_number_with_unit_symbol(unit_info, locale, abbr_units, max_digits, trim_zeros)
@@ -271,10 +275,13 @@ module HumanNumber
             return handle_edge_cases(number, digits) if should_handle_edge_case?(number, digits)
 
             abs_num = number.abs
-            int_digits = count_integer_digits(abs_num.to_i)
 
-            result = calculate_significant_digits_result(abs_num, digits, int_digits)
-            apply_sign(number, result)
+            # Simple significant digits rounding using scientific notation
+            magnitude = Math.log10(abs_num).floor
+            scale_factor = 10**(digits - 1 - magnitude)
+
+            rounded = (abs_num * scale_factor).round / scale_factor.to_f
+            apply_sign(number, rounded)
           end
 
           def should_handle_edge_case?(number, digits)
@@ -287,14 +294,6 @@ module HumanNumber
             number
           end
 
-          def calculate_significant_digits_result(abs_num, digits, int_digits)
-            if int_digits >= digits
-              truncate_to_digits(abs_num.to_i, digits)
-            else
-              round_with_decimals(abs_num, digits, int_digits)
-            end
-          end
-
           def apply_sign(original_number, result)
             original_number.negative? ? -result : result
           end
@@ -303,15 +302,6 @@ module HumanNumber
             int_part.zero? ? SINGLE_DIGIT_LIMIT : int_part.to_s.length
           end
 
-          def truncate_to_digits(int_part, digits)
-            int_part.to_s[0, digits].to_i.to_f
-          end
-
-          def round_with_decimals(abs_num, digits, int_digits)
-            decimal_places = digits - int_digits
-            (abs_num * (10**decimal_places)).round / (10**decimal_places).to_f
-          end
-
           # Look up the localized symbol for a unit (e.g., 'M' for million)
           def lookup_unit_symbol(locale, unit_key, abbr_units)
             section = abbr_units ? I18N_ABBR_UNITS_SECTION : I18N_UNITS_SECTION
@@ -391,10 +381,18 @@ module HumanNumber
 
           # Format unit parts for complete display (e.g., "1M 234K 567")
           def format_all_unit_parts(breakdown, locale, abbr_units)
+            # Check if we're in human formatting mode (any non-:units parts exist)
+            human_formatting_applied = breakdown.any? { |unit_info| unit_info[:unit_key] != :units }
+
             breakdown.map do |unit_info|
               if unit_info[:unit_key] == :units
-                # Raw numbers shown as integers in complete mode
-                unit_info[:count].to_i.to_s
+                if human_formatting_applied
+                  # Part of human formatting - no delimiters
+                  unit_info[:count].to_i.to_s
+                else
+                  # Numbers below minimum unit threshold - apply locale formatting
+                  Number.format_below_min_unit(unit_info[:count].to_i, locale)
+                end
               else
                 # Format each unit part with its symbol
                 format_complete_unit_with_symbol(unit_info, locale, abbr_units)
@@ -418,7 +416,6 @@ module HumanNumber
           { key: :trillion, divisor: 1_000_000_000_000 },
           { key: :hundred_million, divisor: 100_000_000 },
           { key: :ten_thousand, divisor: 10_000 },
-          { key: :thousand, divisor: 1_000 },
         ].freeze
 
         class << self

data/lib/human_number/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module HumanNumber
-  VERSION = "0.1.2"
+  VERSION = "0.1.4"
 end

data/lib/human_number.rb

@@ -26,7 +26,7 @@ module HumanNumber
     # This method provides culturally-appropriate number formatting with automatic
     # unit system selection based on locale:
     # - **Western locales**: K/M/B/T (thousand/million/billion/trillion)
-    # - **East Asian locales**: 천/만/억/조 or 千/万/億/兆
+    # - **East Asian locales**: 만/억/조 or 万/億/兆
     # - **Indian locales**: thousand/lakh/crore
     #
     # @param number [Numeric] The number to format
@@ -160,7 +160,7 @@ module HumanNumber
     #   HumanNumber.human_currency(50000, currency_code: 'KRW', locale: :ko)   #=> "5만원"
     #
     # @example Precision control
-    #   HumanNumber.human_currency(1234567, currency_code: 'USD', locale: :en, max_digits: 2) #=> "$1.23M"
+    #   HumanNumber.human_currency(1234567, currency_code: 'USD', locale: :en, max_digits: 2) #=> "$1.2M"
     #   HumanNumber.human_currency(1234567, currency_code: 'USD', locale: :en, max_digits: nil) #=> "$1M 234K 567"
     #
     # @example Unit preferences
@@ -179,7 +179,7 @@ module HumanNumber
       validate_currency_code!(currency_code)
       validate_locale!(locale)
 
-      final_options = Formatters::Number.default_currency_number_options.merge(options)
+      final_options = Formatters::Number.default_options.merge(options)
 
       formatted_number = Formatters::Number.format(number, locale:, **final_options)
       Formatters::Currency.format(formatted_number, currency_code:, locale:)

data/scripts/build_and_publish.sh

@@ -0,0 +1,204 @@
+#!/bin/bash
+
+# HumanNumber Gem Build and Publish Script
+# Usage: ./scripts/build_and_publish.sh [build|publish|info|clean]
+
+set -e  # Exit on any error
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Helper functions
+log_info() {
+    echo -e "${BLUE}ℹ️  $1${NC}"
+}
+
+log_success() {
+    echo -e "${GREEN}✅ $1${NC}"
+}
+
+log_warning() {
+    echo -e "${YELLOW}⚠️  $1${NC}"
+}
+
+log_error() {
+    echo -e "${RED}❌ $1${NC}"
+    exit 1
+}
+
+# Validation functions
+validate_git_status() {
+    log_info "Checking git status..."
+    if [ -n "$(git status --porcelain)" ]; then
+        log_error "Git working directory is not clean. Please commit all changes first."
+    fi
+    log_success "Git working directory is clean"
+}
+
+validate_git_branch() {
+    log_info "Checking git branch..."
+    current_branch=$(git rev-parse --abbrev-ref HEAD)
+    if [ "$current_branch" != "main" ]; then
+        log_warning "You're on branch '$current_branch', not 'main'"
+        read -p "Continue anyway? (y/N): " -n 1 -r
+        echo
+        if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+            log_error "Aborted by user"
+        fi
+    fi
+    log_success "Git branch check passed"
+}
+
+run_tests() {
+    log_info "Running tests..."
+    if ! bundle exec rspec; then
+        log_error "Tests failed"
+    fi
+    log_success "All tests passed"
+}
+
+run_linting() {
+    log_info "Running RuboCop..."
+    if ! bundle exec rubocop; then
+        log_error "RuboCop checks failed"
+    fi
+    log_success "RuboCop checks passed"
+}
+
+validate_all() {
+    echo "🔍 Running pre-publish validations..."
+    run_tests
+    run_linting
+    validate_git_status
+    validate_git_branch
+    log_success "All validations passed!"
+}
+
+build_gem() {
+    log_info "Building gem..."
+    if ! bundle exec rake build; then
+        log_error "Gem build failed"
+    fi
+    log_success "Gem built successfully!"
+}
+
+publish_gem() {
+    log_info "Publishing gem to RubyGems..."
+    if ! bundle exec rake release; then
+        log_error "Gem publish failed"
+    fi
+    log_success "Gem published successfully!"
+}
+
+show_info() {
+    echo "📋 Gem Information:"
+    echo "  Name: human_number"
+    echo "  Version: $(ruby -r ./lib/human_number/version -e 'puts HumanNumber::VERSION')"
+    echo "  Built gems: $(ls pkg/*.gem 2>/dev/null || echo 'none')"
+    echo "  Git branch: $(git rev-parse --abbrev-ref HEAD)"
+    echo "  Git status: $([ -z "$(git status --porcelain)" ] && echo 'clean' || echo 'dirty')"
+}
+
+clean_artifacts() {
+    log_info "Cleaning build artifacts..."
+    rm -rf pkg/
+    log_success "Build artifacts cleaned!"
+}
+
+version_bump() {
+    echo "🔖 Version Bump"
+    current_version=$(ruby -r ./lib/human_number/version -e 'puts HumanNumber::VERSION')
+    echo "Current version: $current_version"
+    echo ""
+    
+    # Get new version from user
+    read -p "Enter new version: " new_version
+    
+    if [ -z "$new_version" ]; then
+        log_error "No version entered. Aborting."
+    fi
+    
+    # Validate version format (basic semver check)
+    if ! echo "$new_version" | grep -qE "^[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.-]+)?$"; then
+        log_error "Invalid version format. Please use semantic versioning (e.g., 1.2.3 or 1.2.3-alpha.1)"
+    fi
+    
+    # Check if version is different
+    if [ "$new_version" = "$current_version" ]; then
+        log_error "New version is the same as current version. Aborting."
+    fi
+    
+    # Update version file
+    version_file="lib/human_number/version.rb"
+    sed -i.bak "s/VERSION = \".*\"/VERSION = \"$new_version\"/" "$version_file" && rm "$version_file.bak"
+    log_success "Updated version to $new_version"
+    
+    # Create commit
+    log_info "Creating version bump commit..."
+    git add "$version_file"
+    commit_message="chore: bump version to $new_version"
+    
+    if git commit -m "$commit_message"; then
+        log_success "Version bump committed successfully!"
+        echo ""
+        echo "📋 Next steps:"
+        echo "  - Review the changes: git show"
+        echo "  - Build and publish: $0 publish"
+        echo "  - Push to remote: git push && git push --tags"
+    else
+        log_error "Failed to create commit"
+    fi
+}
+
+# Main script logic
+case "${1:-help}" in
+    "build")
+        validate_all
+        build_gem
+        ;;
+    "publish")
+        validate_all
+        publish_gem
+        ;;
+    "build-quick")
+        log_info "Quick building gem (no validations)..."
+        build_gem
+        ;;
+    "info")
+        show_info
+        ;;
+    "clean")
+        clean_artifacts
+        ;;
+    "validate")
+        validate_all
+        ;;
+    "bump")
+        version_bump
+        ;;
+    "help"|*)
+        echo "HumanNumber Gem Build and Publish Script"
+        echo ""
+        echo "Usage: $0 [command]"
+        echo ""
+        echo "Commands:"
+        echo "  build        Build gem with full validations (tests, linting, git checks)"
+        echo "  publish      Publish gem to RubyGems with full validations"
+        echo "  build-quick  Build gem without validations (for testing)"
+        echo "  validate     Run all validations without building"
+        echo "  info         Show gem and repository information"
+        echo "  clean        Clean build artifacts"
+        echo "  bump         Bump version interactively and commit"
+        echo "  help         Show this help message"
+        echo ""
+        echo "Examples:"
+        echo "  $0 build          # Build gem with validations"
+        echo "  $0 publish        # Build and publish to RubyGems"
+        echo "  $0 bump           # Bump version interactively"
+        echo "  $0 info           # Show current gem info"
+        ;;
+esac

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: human_number
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
-- Your Name
+- Ether Moon
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
@@ -62,17 +62,19 @@ description: HumanNumber implements accurate number formatting based on internat
   human-readable number formats with precise locale-specific decimal separators, thousand
   separators, currency formats, and cultural number conventions.
 email:
-- your.email@example.com
+- ethermoon42@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - ".rspec"
 - ".rubocop.yml"
+- BUILD.md
 - CHANGELOG.md
 - CLAUDE.md
 - Gemfile
 - LICENSE
+- Makefile
 - README.md
 - Rakefile
 - config/locales/bn.yml
@@ -89,6 +91,7 @@ files:
 - config/locales/zh-CN.yml
 - config/locales/zh-TW.yml
 - config/locales/zh.yml
+- human_number.gemspec
 - lib/human_number.rb
 - lib/human_number/formatters/currency.rb
 - lib/human_number/formatters/number.rb
@@ -96,14 +99,15 @@ files:
 - lib/human_number/rails/helpers.rb
 - lib/human_number/railtie.rb
 - lib/human_number/version.rb
-homepage: https://github.com/yourusername/human_number
+- scripts/build_and_publish.sh
+homepage: https://github.com/ether-moon/human_number
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/yourusername/human_number
-  source_code_uri: https://github.com/yourusername/human_number
-  changelog_uri: https://github.com/yourusername/human_number/blob/main/CHANGELOG.md
+  homepage_uri: https://github.com/ether-moon/human_number
+  source_code_uri: https://github.com/ether-moon/human_number
+  changelog_uri: https://github.com/ether-moon/human_number/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: