human_number 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3464be66cdbc375a6612c468bc7aeffdff928b8bc1af7857d2f261440f4a3f7f
-  data.tar.gz: 6ddf79c2ddd6cf5595b70a798cb035b730a7c5c6ba7c7e5d2dff726993d934c4
+  metadata.gz: a9d2eb9cac5e189aec1c4c4ad86e0c3a248f466bac8a1af782fc53ff918a43a9
+  data.tar.gz: f5e4e6a026ff264ab89583cbef216cdbdf872d967ad7b74859b7cd011c5f7373
 SHA512:
-  metadata.gz: 178108029dc2a438d5a19dc5f66c9b2850d6dd593072c8ceade307549d58749cb809d73094306cd64b8bcfe870bfc3823a0c945d1454c8cc2aef4c703f2a34cd
-  data.tar.gz: c562f9d5ea7abe1bff8b31b6889a5df768f755a62490e7ea2aa6bbaef312e08feb2e29ffc1aa61f9f01f2f35ca452104d5e46dc1ccd7487c12c439196f59f10b
+  metadata.gz: 32ada67f4efa6c18d358a327c18a913b7b18945db2f70f1ca35de0230250f089885e85425cb40547dfeb4aa16a4c0ddd5eb35ea8b65fb5b27919fb2dd5516e8b
+  data.tar.gz: d549da397b45f84dff15e15851ef54d1dfb241462ab041d1c0b384dc9ec5811eb744f0c54c28e7dd10087ceeade9b39346708b28cef5d4d09d0fb9e0594b97d8

data/.rubocop.yml

@@ -60,4 +60,8 @@ Metrics/MethodLength:
 Metrics/ParameterLists:
   Max: 6
 
+# Gemspec
+Gemspec/RequireMFA:
+  Enabled: false
+
 # 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

@@ -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/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

@@ -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,8 +155,8 @@ 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억"
 ```
 
@@ -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,40 @@
+# 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"
+
+  # 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,14 +27,14 @@ 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
         #
         # @api private
         def format(number, locale:, abbr_units:, max_digits:, min_unit:, trim_zeros:)
-          locale = locale.to_sym
+          locale = (locale || I18n.locale).to_sym
 
           # Direct delegation to appropriate system class
           system_class = determine_system_class(locale)
@@ -48,42 +48,41 @@ module HumanNumber
           )
         end
 
-        # Default options for human number formatting
-        def default_options
-          {
-            abbr_units: true,
-            max_digits: 2,
-            min_unit: nil,
-            trim_zeros: true,
-          }.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
-        end
-
         # Formats a number using Rails' currency precision rules for the given currency.
         # This ensures consistent precision regardless of display locale.
         #
         # @param number [Numeric] The number to format
         # @param currency_code [String] ISO 4217 currency code
         # @param locale [Symbol] Display locale (for context)
+        # @param options [Hash] Additional formatting options passed to number_to_currency
         # @return [String] Formatted number with currency-appropriate precision
-        def format_with_currency_precision(number, currency_code:, locale:)
-          locale = locale.to_sym
+        def format_with_currency_precision(number, currency_code:, locale:, **options)
+          locale = (locale || I18n.locale).to_sym
 
-          # Use currency's native locale for precision rules
+          # Use currency's native locale for precision rules unless overridden
           precision_locale = LocaleSupport.currency_precision_locale(currency_code, locale)
 
-          I18n.with_locale(precision_locale) do
-            number_to_currency(number, format: "%n", locale: precision_locale)
-          end
+          # Prepare options for number_to_currency
+          currency_options = options.dup
+          currency_options[:locale] = precision_locale
+          currency_options[:format] = "%n" # Always format as just the number (no currency symbol)
+
+          number_to_currency(number, **currency_options) || ZERO_STRING
+        end
+
+        # Default options for human number formatting
+        def default_options
+          {
+            abbr_units: true,
+            max_digits: 2,
+            min_unit: nil,
+            trim_zeros: true,
+          }.freeze
+        end
+
+        # 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
@@ -117,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
@@ -128,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
@@ -267,10 +267,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)
@@ -283,14 +286,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
@@ -299,15 +294,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

data/lib/human_number/rails/helpers.rb

@@ -7,75 +7,49 @@ module HumanNumber
     # These helpers provide convenient access to HumanNumber functionality
     # within Rails views and controllers with Rails-friendly parameter handling.
     module Helpers
-      # Formats a number with intelligent, locale-aware abbreviations.
-      #
-      # This is a Rails helper wrapper around HumanNumber.human_number that provides
-      # Rails-friendly parameter handling with optional locale detection.
+      # Rails helper for formatting numbers with intelligent abbreviations.
       #
       # @param number [Numeric] The number to format
       # @param locale [Symbol, String, nil] The locale for formatting (default: current I18n locale)
       # @param options [Hash] Additional formatting options
-      # @option options [Boolean] :abbr_units (true) Use abbreviated unit symbols
-      # @option options [Integer, nil] :max_digits (1) Maximum significant digits
-      # @option options [Integer, nil] :min_unit (nil) Minimum unit threshold
-      # @option options [Boolean] :trim_zeros (true) Remove trailing decimal zeros
-      #
-      # @return [String] The formatted number string
       #
       # @example Basic usage in views
-      #   <%= human_number(1234567) %>                    #=> "1.2M"
-      #   <%= human_number(50000, locale: :ko) %>         #=> "5만"
-      #   <%= human_number(1234567, max_digits: 2) %>     #=> "1.23M"
+      #   <%= human_number(1234567) %>            #=> "1.2M"
+      #   <%= human_number(50000, locale: :ko) %> #=> "5만"
       #
-      # @see HumanNumber.human_number Main implementation
+      # @see HumanNumber.human_number For detailed documentation and all available options
       def human_number(number, locale: I18n.locale, **options)
         HumanNumber.human_number(number, locale:, **options)
       end
 
-      # Formats a currency amount using standard Rails currency formatting.
-      #
-      # This helper provides Rails-friendly parameter handling for currency formatting
-      # with automatic locale detection and parameter normalization.
+      # Rails helper for formatting currency amounts with standard precision.
       #
       # @param number [Numeric] The amount to format
       # @param currency_code [String] ISO 4217 currency code (e.g., 'USD', 'EUR')
       # @param locale [Symbol, String, nil] Display locale (default: current I18n locale)
-      #
-      # @return [String] The formatted currency string
+      # @param options [Hash] Additional formatting options
       #
       # @example Basic usage in views
-      #   <%= currency(1234.56, currency_code: 'USD') %>           #=> "$1,234.56"
-      #   <%= currency(50000, currency_code: 'KRW', locale: :ko) %> #=> "50,000원"
-      #   <%= currency(1234.99, currency_code: 'JPY') %>           #=> "1,235円"
+      #   <%= currency(1234.56, currency_code: 'USD') %>    #=> "$1,234.56"
+      #   <%= currency(50000, currency_code: 'KRW') %>      #=> "50,000원"
       #
-      # @see HumanNumber.currency Main implementation
-      def currency(number, currency_code:, locale: I18n.locale)
-        HumanNumber.currency(number, currency_code:, locale:)
+      # @see HumanNumber.currency For detailed documentation and all available options
+      def currency(number, currency_code:, locale: I18n.locale, **options)
+        HumanNumber.currency(number, currency_code:, locale:, **options)
       end
 
-      # Formats a currency amount with intelligent, locale-aware abbreviations.
-      #
-      # This helper combines human-readable number formatting with currency symbols,
-      # providing Rails-friendly access to abbreviated currency formatting.
+      # Rails helper for formatting currency amounts with intelligent abbreviations.
       #
       # @param number [Numeric] The amount to format
       # @param currency_code [String] ISO 4217 currency code (e.g., 'USD', 'EUR')
       # @param locale [Symbol, String, nil] Locale for formatting (default: current I18n locale)
       # @param options [Hash] Additional formatting options
-      # @option options [Boolean] :abbr_units (true) Use abbreviated unit symbols
-      # @option options [Integer, nil] :max_digits (1) Maximum significant digits
-      # @option options [Integer, nil] :min_unit (nil) Minimum unit threshold
-      # @option options [Boolean] :trim_zeros (true) Remove trailing decimal zeros
-      #
-      # @return [String] The formatted currency string with abbreviations
       #
       # @example Basic usage in views
-      #   <%= human_currency(1234567, currency_code: 'USD') %>                    #=> "$1.2M"
-      #   <%= human_currency(50000, currency_code: 'KRW', locale: :ko) %>         #=> "5만원"
-      #   <%= human_currency(1234567, currency_code: 'USD', max_digits: 2) %>     #=> "$1.23M"
-      #   <%= human_currency(1000000, currency_code: 'USD', abbr_units: false) %> #=> "$1 million"
+      #   <%= human_currency(1234567, currency_code: 'USD') %>      #=> "$1.2M"
+      #   <%= human_currency(50000, currency_code: 'KRW') %>        #=> "5만원"
       #
-      # @see HumanNumber.human_currency Main implementation
+      # @see HumanNumber.human_currency For detailed documentation and all available options
       def human_currency(number, currency_code:, locale: I18n.locale, **options)
         HumanNumber.human_currency(number, currency_code:, locale:, **options)
       end

data/lib/human_number/version.rb

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

data/lib/human_number.rb

@@ -66,7 +66,6 @@ module HumanNumber
     #
     # @note Complete mode (max_digits: nil) shows full precision across multiple units
     # @see Formatters::Number.format The underlying formatter implementation
-    # @since 1.0.0
     def human_number(number, locale: I18n.locale, **options)
       validate_number_input!(number)
       validate_locale!(locale)
@@ -76,23 +75,41 @@ module HumanNumber
       Formatters::Number.format(number, locale:, **final_options)
     end
 
-    # Formats a currency amount using standard Rails currency formatting.
+    # Formats a currency amount with standard precision and symbol placement.
     #
-    # This method applies currency-specific precision rules (e.g., 2 decimals for USD,
-    # 0 decimals for JPY/KRW) based on the currency's native locale, ensuring
-    # consistent precision regardless of the display locale.
+    # This method provides currency formatting with automatic precision rules based on
+    # international standards, ensuring consistent display across different locales:
+    # - **Currency-specific precision**: 2 decimals for USD/EUR, 0 for JPY/KRW
+    # - **Native locale rules**: Precision determined by currency's origin locale
+    # - **Cross-locale consistency**: USD shows 2 decimals regardless of display locale
+    # - **Symbol placement**: Follows locale-specific conventions ($1,234 vs 1,234원)
     #
     # @param number [Numeric] The amount to format
     # @param currency_code [String] ISO 4217 currency code (e.g., 'USD', 'EUR', 'KRW', 'JPY')
-    # @param locale [Symbol, String] Display locale for formatting rules
+    # @param locale [Symbol, String] Display locale for formatting rules (default: current I18n locale)
+    #   Determines delimiter, separator, and symbol placement conventions
+    #
+    # @option options [Integer] :precision Decimal precision level. Overrides currency-specific precision
+    # @option options [Symbol] :round_mode Rounding mode (see BigDecimal.mode). Defaults to :default
+    # @option options [String] :separator Decimal separator. Defaults to locale-specific separator
+    # @option options [String] :delimiter Thousands delimiter. Defaults to locale-specific delimiter
+    # @option options [Boolean] :strip_insignificant_zeros (false) Remove trailing decimal zeros
+    #
+    # @note Only numeric formatting options are supported. Currency symbols and formats are
+    #   automatically determined by ISO 4217 standards and locale conventions.
     #
     # @return [String] The formatted currency string
     #
-    # @example Standard currency formatting
+    # @example Basic currency formatting
     #   HumanNumber.currency(1234.56, currency_code: 'USD', locale: :en) #=> "$1,234.56"
     #   HumanNumber.currency(50000, currency_code: 'KRW', locale: :ko)   #=> "50,000원"
     #   HumanNumber.currency(1234.99, currency_code: 'JPY', locale: :ja) #=> "1,235円"
     #
+    # @example Custom precision and formatting
+    #   HumanNumber.currency(1234.56, currency_code: 'USD', precision: 1)                    #=> "$1,234.6"
+    #   HumanNumber.currency(1234.56, currency_code: 'USD', delimiter: " ")                  #=> "$1 234.56"
+    #   HumanNumber.currency(1234.50, currency_code: 'USD', strip_insignificant_zeros: true) #=> "$1,234.5"
+    #
     # @example Cross-locale precision consistency
     #   # USD always shows 2 decimals regardless of display locale
     #   HumanNumber.currency(1234.56, currency_code: 'USD', locale: :ko) #=> "$1,234.56"
@@ -100,16 +117,20 @@ module HumanNumber
     #   # JPY always shows 0 decimals regardless of display locale
     #   HumanNumber.currency(1234.56, currency_code: 'JPY', locale: :en) #=> "1,235円"
     #
-    # @note Precision is determined by currency's native locale, not display locale
+    # @example Edge cases
+    #   HumanNumber.currency(0, currency_code: 'USD')      #=> "$0.00"
+    #   HumanNumber.currency(-1234.56, currency_code: 'USD') #=> "-$1,234.56"
+    #
+    # @note Precision is determined by currency's native locale unless overridden via :precision option
+    # @see #human_currency For currency formatting with intelligent abbreviations (K/M/B)
     # @see Formatters::Number.format_with_currency_precision Currency precision logic
     # @see Formatters::Currency.format Currency symbol and format application
-    # @since 1.0.0
-    def currency(number, currency_code:, locale: I18n.locale)
+    def currency(number, currency_code:, locale: I18n.locale, **options)
       validate_number_input!(number)
       validate_currency_code!(currency_code)
       validate_locale!(locale)
 
-      formatted_number = Formatters::Number.format_with_currency_precision(number, currency_code:, locale:)
+      formatted_number = Formatters::Number.format_with_currency_precision(number, currency_code:, locale:, **options)
       Formatters::Currency.format(formatted_number, currency_code:, locale:)
     end
 
@@ -139,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
@@ -153,13 +174,12 @@ module HumanNumber
     # @note Combines human number formatting with currency-specific symbol placement
     # @see #human_number For detailed number formatting options
     # @see #currency For standard currency formatting without abbreviations
-    # @since 1.0.0
     def human_currency(number, currency_code:, locale: I18n.locale, **options)
       validate_number_input!(number)
       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.1
+  version: 0.1.3
 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,15 +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
-  rubygems_mfa_required: 'true'
+  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
 rdoc_options: []
 require_paths:
 - lib