@intlpullhq/cli 0.1.6 → 0.1.7

package/README.md

@@ -744,11 +744,59 @@ Created by `intlpull init`, this file configures your project:
   "framework": "next",
   "library": "next-intl",
   "outputDir": "./messages",
+  "output": "messages/[locale]/[namespace].json",
   "sourceLanguage": "en",
   "namespaces": ["common", "admin"]
 }
 ```
 
+### Output Patterns (Namespace Support)
+
+The CLI supports flexible output patterns with placeholders to match any i18n library structure.
+
+**Placeholders:**
+- `[locale]` or `{locale}` - Language code (e.g., `en`, `es`, `zh-CN`)
+- `[namespace]` or `{namespace}` - Namespace name (e.g., `common`, `auth`)
+
+**Common Patterns by Framework:**
+
+| Framework/Library | Pattern | Example Output |
+|------------------|---------|----------------|
+| **next-intl** | `messages/[locale].json` | `messages/en.json` |
+| **next-i18next** | `public/locales/[locale]/[namespace].json` | `public/locales/en/common.json` |
+| **react-i18next** | `public/locales/[locale]/[namespace].json` | `public/locales/en/auth.json` |
+| **i18next** | `locales/[locale]/[namespace].json` | `locales/en/common.json` |
+| **vue-i18n** | `src/locales/[locale].json` | `src/locales/en.json` |
+| **Chrome Extension** | `_locales/[locale]/messages.json` | `_locales/en/messages.json` |
+| **React Native** | `assets/locales/[locale]/[namespace].json` | `assets/locales/en/common.json` |
+
+**Configure via CLI flag:**
+```bash
+# Namespaced output (creates separate files per namespace)
+npx @intlpullhq/cli pull --output "public/locales/[locale]/[namespace].json"
+
+# Flat output (merges all namespaces into one file)
+npx @intlpullhq/cli pull --output "messages/[locale].json"
+
+# Namespace-first structure
+npx @intlpullhq/cli pull --output "locales/[namespace]/[locale].json"
+```
+
+**Configure in `.intlpull.json`:**
+```json
+{
+  "projectId": "proj_xxxx",
+  "output": "public/locales/[locale]/[namespace].json"
+}
+```
+
+**Important:** Ensure your i18n library's configuration matches the output path:
+
+- **next-intl**: Update `src/i18n/request.ts` to load from the correct path
+- **i18next / react-i18next**: Update `backend.loadPath` in your i18n config
+- **Chrome Extension**: Must use `_locales/[locale]/messages.json` (Chrome requirement)
+```
+
 ### Environment Variables
 
 | Variable | Description |