clipfix 0.1.2 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # clipfix
 
-> Fix copy-pasted text from LLMs and the web — instantly convert fancy Unicode punctuation to plain ASCII.
+> Fix copy-pasted text from LLMs and the web -- instantly convert fancy Unicode punctuation to plain ASCII.
 
 ## Installation
 
@@ -10,26 +10,73 @@ npm install -g clipfix
 
 **macOS only** (ARM64 and Intel)
 
+## Two Modes
+
+**Soft mode (default)** -- removes invisible/structural characters and AI-signature typographic characters (curly quotes `""''`, em/en dashes `---`, ellipsis `...`). Arrows, math symbols, and guillemets are left untouched.
+
+**Hard mode (`--hard`)** -- also replaces all remaining typographic Unicode with ASCII equivalents. Useful for terminal output, source code, or strictly ASCII pipelines.
+
 ## Usage
 
 ### Clipboard Mode
 Copy text from anywhere, then:
 ```bash
-clipfix --clipboard
-# Fixed 8 characters
+clipfix --clipboard          # soft mode (default)
+clipfix --hard --clipboard   # hard mode
+# Fixed N characters
 ```
 
 ### Pipe Mode
 ```bash
-echo '"Hello — world"' | clipfix
+# Soft sanitize a file
+cat email.md | clipfix > email-clean.md
+
+# Hard sanitize — flatten all Unicode punctuation to ASCII
+echo '"Hello — world"' | clipfix --hard
 # Output: "Hello -- world"
 
 # Fix a file
-cat document.md | clipfix > fixed.md
+cat document.md | clipfix --hard > fixed.md
+```
+
+### List All Replaced Characters
+```bash
+clipfix --list-replacements
+```
+Prints a full table of every character clipfix handles, grouped by soft/hard mode.
+
+## Command Reference
+
+```
+clipfix [OPTIONS]
+
+Options:
+  -S, --soft               Soft sanitize: remove only invisible/structural characters (default)
+  -H, --hard               Hard sanitize: also replace typographic characters with ASCII equivalents
+  -c, --clipboard          Read from and write to clipboard
+  -l, --list-replacements  List all characters replaced by clipfix, grouped by mode
+  -h, --help               Print help
+  -V, --version            Print version
 ```
 
 ## What Gets Fixed
 
+### Soft mode (default)
+
+| Unicode | Becomes | Description |
+|---------|---------|-------------|
+| U+00A0 | ` ` (space) | Non-breaking space |
+| U+200B | *(removed)* | Zero-width space |
+| U+FEFF | *(removed)* | BOM marker |
+| U+200E/F | *(removed)* | Directional marks |
+| U+2018/19 | `'` | Curly single quotes |
+| U+201C/D | `"` | Curly double quotes |
+| U+2014 | `--` | Em dash |
+| U+2013 | `-` | En dash |
+| U+2026 | `...` | Ellipsis |
+
+### Hard mode only
+
 | Unicode | ASCII | Example |
 |---------|-------|---------|
 | `—` (em dash) | `--` | `Hello—world` → `Hello--world` |
@@ -38,11 +85,11 @@ cat document.md | clipfix > fixed.md
 | `≠` | `!=` | `x ≠ y` → `x != y` |
 | `…` | `...` | `wait…` → `wait...` |
 
-Plus 20+ more transformations including zero-width space removal.
+Plus 15+ more — run `clipfix --list-replacements` for the full list.
 
 ## Why?
 
-LLMs love fancy punctuation that breaks in terminals, code editors, and config files. clipfix sanitizes it instantly.
+LLMs love fancy punctuation that breaks in terminals, code editors, and config files.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clipfix",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Fix copy-pasted text from LLMs - convert fancy Unicode punctuation to plain ASCII",
   "main": "clipfix.js",
   "bin": {