@vocoder/cli 0.1.4 → 0.1.6

package/README.md

@@ -1,6 +1,6 @@
 # @vocoder/cli
 
-Command-line tool for Vocoder. Handles project setup, string extraction from source code, and translation synchronization.
+Command-line tool for Vocoder. Handles project setup and automatic string wrapping for translation.
 
 ## Installation
 
@@ -30,48 +30,11 @@ The command detects your git remote and checks if a Vocoder project already exis
 
 | Flag | Description |
 |---|---|
-| `--api-url <url>` | Override Vocoder API URL |
 | `--yes` | Skip confirmation prompts |
 | `--project-name <name>` | Pre-fill project name |
 | `--source-locale <locale>` | Pre-fill source locale |
 | `--target-locales <list>` | Comma-separated target locales (e.g., `es,fr,de`) |
 
-### `vocoder sync`
-
-Extract translatable strings from your source code and push them to Vocoder for translation.
-
-```bash
-vocoder sync
-```
-
-This command:
-
-1. Detects the current git branch and repository
-2. Scans your source files for `<T>` components and `t()` calls
-3. Extracts the source text, file location, and any context/formality hints
-4. Sends the extracted strings to the Vocoder API
-5. Optionally waits for translations to complete (based on sync mode)
-
-**Options:**
-
-| Flag | Description |
-|---|---|
-| `--branch <name>` | Override branch detection |
-| `--include <pattern>` | Glob pattern(s) to include (repeatable) |
-| `--exclude <pattern>` | Glob pattern(s) to exclude (repeatable) |
-| `--force` | Sync even if not on a target branch |
-| `--mode <mode>` | Sync mode: `auto`, `required`, or `best-effort` |
-| `--max-wait-ms <ms>` | Max wait time before fallback (milliseconds) |
-| `--no-fallback` | Fail instead of falling back to cached translations |
-| `--dry-run` | Show what would be synced without sending |
-| `--verbose` | Show detailed progress |
-
-#### Sync Modes
-
-- **`auto`** (default) -- Checks the project's sync policy. Blocking branches (e.g., `main`, `production`) use `required` mode; other branches use `best-effort`.
-- **`required`** -- Waits for translations to complete before finishing. Fails if translations can't be completed within the timeout.
-- **`best-effort`** -- Sends strings for translation but doesn't wait. Falls back to the latest available translations.
-
 ### `vocoder wrap`
 
 Automatically wrap string literals in your source code with `<T>` and `t()`.
@@ -93,29 +56,15 @@ Scans your JSX/TSX files for user-facing string literals and wraps them with the
 | `--confidence <level>` | Minimum confidence: `high`, `medium`, `low` (default: `high`) |
 | `--verbose` | Detailed output |
 
-## Environment Variables
-
-| Variable | Required | Description |
-|---|---|---|
-| `VOCODER_API_KEY` | Yes (for `sync`) | API key for authenticating with the Vocoder API |
-| `VOCODER_API_URL` | No | Override API URL (default: `https://vocoder.app`) |
-
-The CLI reads `.env` files in the project root automatically.
-
 ## String Extraction
 
-The CLI uses Babel to parse JSX/TSX files and extract strings from:
-
-- `<T>` component children: `<T>Hello, world!</T>`
-- `<T>` component `msg` prop: `<T msg="{count, plural, one {# item} other {# items}}" />`
-- `t()` function calls: `t('Hello, world!')`
+The `wrap` command uses Babel to parse JSX/TSX files and detect strings that are likely user-facing. It distinguishes between:
 
-It tracks imports from `@vocoder/react` to ensure only Vocoder components are extracted (not unrelated components that happen to be named `T`).
+- JSX text content (wrapped with `<T>`)
+- String props like `placeholder`, `title`, `aria-label` (wrapped with `t()`)
+- Non-translatable strings like class names, keys, and URLs (left alone)
 
-Each extracted string includes:
-- The source text (used as the translation key)
-- File path and line number
-- Optional `context` and `formality` props
+It tracks imports from `@vocoder/react` to avoid double-wrapping strings that are already marked for translation.
 
 ## Git Integration