Add CLI Tool for nano-string-utils (#28)

* add cli tool

* fix tests

Author: Zheruel

.github/workflows/ci.yml

@@ -53,6 +53,9 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
+      - name: Build the library
+        run: npm run build
+
       - name: Run tests
         run: npm test
 

CHANGELOG.md

@@ -7,11 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.12.0] - 2025-09-17
+
+### Added
+
+- **CLI Tool** - Zero-dependency command-line interface for string utilities
+  - New `nano-string` command available via `npx nano-string-utils` or global installation
+  - Support for all 40+ library functions directly from the terminal
+  - Pipe support for Unix-style command chaining
+  - Options handling for complex functions (template, truncate, pad, etc.)
+  - Comprehensive help system with global and per-function documentation
+  - Smart argument parsing with JSON support for complex data
+  - Boolean output with proper exit codes for validation functions
+  - Full test coverage with 39 CLI-specific test cases
+  - Examples: `nano-string slugify "Hello World"`, `echo "text" | nano-string kebabCase`
+
 ## [0.11.0] - 2025-09-17
 
 ### Added
 
 - **Interactive Migration Guide** - Comprehensive guide for migrating from lodash/underscore
+
   - Interactive documentation site with migration guide section
   - Complete function mapping table showing lodash → nano-string-utils equivalents
   - Step-by-step migration instructions with code examples
@@ -296,6 +312,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 100% test coverage for utility functions
 - Modern build tooling with tsup and Vitest
 
+[0.12.0]: https://github.com/Zheruel/nano-string-utils/releases/tag/v0.12.0
+[0.11.0]: https://github.com/Zheruel/nano-string-utils/releases/tag/v0.11.0
 [0.10.0]: https://github.com/Zheruel/nano-string-utils/releases/tag/v0.10.0
 [0.9.1]: https://github.com/Zheruel/nano-string-utils/releases/tag/v0.9.1
 [0.9.0]: https://github.com/Zheruel/nano-string-utils/releases/tag/v0.9.0

README.md

@@ -76,6 +76,100 @@ camelCase("hello-world"); // 'helloWorld'
 truncate("Long text here", 10); // 'Long te...'
 ```
 
+## CLI
+
+Nano String Utils includes a command-line interface for quick string transformations directly in your terminal.
+
+### Installation
+
+When installed globally or used with `npx`, the CLI is available as `nano-string`:
+
+```bash
+# Global installation
+npm install -g nano-string-utils
+nano-string slugify "Hello World"
+
+# Using npx (no installation required)
+npx nano-string-utils slugify "Hello World"
+```
+
+### Basic Usage
+
+```bash
+nano-string <function> <input> [options]
+```
+
+### Examples
+
+#### Simple transformations
+```bash
+nano-string slugify "Hello World!"           # hello-world
+nano-string camelCase "hello-world"          # helloWorld
+nano-string kebabCase "hello_world"          # hello-world
+nano-string capitalize "hello"               # Hello
+nano-string reverse "hello"                  # olleh
+```
+
+#### Using pipes
+```bash
+echo "Hello World" | nano-string slugify     # hello-world
+cat file.txt | nano-string truncate --length 50
+```
+
+#### Functions with options
+```bash
+# Truncate with custom length
+nano-string truncate "Long text here" --length 10  # Long te...
+
+# Template interpolation
+nano-string template "Hello {{name}}" --data '{"name":"World"}'  # Hello World
+
+# Pad strings
+nano-string padStart "hi" --length 5 --char "*"  # ***hi
+
+# Generate random strings
+nano-string randomString --length 10  # Generates 10-character string
+```
+
+#### Validation functions
+```bash
+nano-string isEmail "[email protected]"       # true
+nano-string isUrl "https://example.com"      # true
+nano-string isASCII "hello"                  # true
+```
+
+#### Analysis functions
+```bash
+nano-string wordCount "hello world test"     # 3
+nano-string levenshtein "kitten" "sitting"   # 3
+nano-string diff "hello" "hallo"             # Shows differences
+```
+
+### Available Commands
+
+To see all available functions:
+```bash
+nano-string --help
+```
+
+For help on a specific function:
+```bash
+nano-string slugify --help
+```
+
+### Supported Functions
+
+The CLI supports most functions from the library:
+- **Case Conversions**: slugify, camelCase, snakeCase, kebabCase, pascalCase, constantCase, dotCase, pathCase, sentenceCase, titleCase
+- **String Manipulation**: capitalize, reverse, truncate, excerpt, pad, padStart, padEnd
+- **Text Processing**: stripHtml, escapeHtml, deburr, normalizeWhitespace, removeNonPrintable, toASCII
+- **Validation**: isEmail, isUrl, isASCII
+- **Analysis**: wordCount, levenshtein, levenshteinNormalized, diff
+- **Generation**: randomString, hashString
+- **Unicode**: graphemes, codePoints
+- **Pluralization**: pluralize, singularize
+- **Templates**: template, templateSafe, highlight, fuzzyMatch
+
 ## API Reference
 
 ### String Transformation