@lionrapid/cli 0.1.0

package/README.md

@@ -0,0 +1,159 @@
+# @lionrapid/cli
+
+The LionRapid command-line tool. Syncs translation files in many formats
+(iOS `.strings`/`.xcstrings`, Android `strings.xml`, Flutter `.arb`, generic
+JSON, YAML, PO) with the LionRapid backend, and generates type-safe TypeScript
+keys from your translations.
+
+This is the **non-web integration wedge**: it reaches platforms the web
+surfaces (WordPress, edge proxy, JS snippet, React SDK) can't — mobile apps,
+backend services, static-site generators, and CI/CD — by speaking the existing
+`/api/integrations/*` REST surface instead of the DOM.
+
+## Status
+
+Phase 1 (file-sync dev-loop) is implemented. Command surface:
+
+| Command           | Status | What it does                                                        |
+| ----------------- | ------ | ------------------------------------------------------------------- |
+| `init`            | ✅     | Scaffold a `lionrapid.yml` (detects Flutter/iOS/Android/Rails/JS)   |
+| `push`            | ✅     | Upload source strings to the backend (server handles MT)            |
+| `pull [--types]`  | ✅     | Download translations into target files; optionally regen types     |
+| `validate [--ci]` | ✅     | Check local files vs the backend for missing/orphan/empty keys      |
+| `types generate`  | ✅     | Generate a typed `.d.ts` from your source files (offline)           |
+| `types check`     | ✅     | Report ICU issues in your source translations                       |
+| `scan [--json]`   | ✅     | Find user-facing strings in source → inventory keyed by auto_key    |
+| `scan --push`     | ✅     | Seed the safe `wrap` candidates to the backend under their auto_key |
+| `snapshot`        | ✅     | Write offline-resilience bundles (raw ContentUnit) per locale/ns    |
+| `doctor`          | ✅     | Preflight: config, credentials, server connectivity, source files   |
+
+Formats: JSON, YAML, PO (incl. plurals + `msgctxt`), Flutter `.arb`, iOS
+`.strings` + `.xcstrings`, Android `strings.xml`, XLIFF (1.2/2.0, CAT-tool
+interchange).
+
+**Multiple namespaces:** give any `files` entry its own `namespace` to map
+different file trees to different backend namespaces (defaults to the top-level
+`namespace`). Each is pushed/pulled/validated independently, so the same key name
+in two namespaces never collides:
+
+```yaml
+namespace: app
+files:
+  - { format: json, source: common/en.json, target: common/{locale}.json, namespace: common }
+  - { format: json, source: app/en.json,    target: app/{locale}.json } # → namespace: app
+```
+
+## Reliability & automation
+
+Built for CI and AI agents — every networked command is resilient and scriptable.
+
+- **`--json`** (all commands): emit one result envelope `{ ok, command, … }` on
+  **stdout**; human prose goes to **stderr**. On failure, a structured error
+  envelope `{ ok: false, error: { type, message, status? }, exitCode }` is written
+  to stdout. Parse stdout, read stderr.
+- **`--dry-run`** (`push`, `pull`): report exactly what _would_ happen — counts,
+  keys, target files — without any network mutation (`push`) or file write
+  (`pull`). `pull --dry-run` still does the read-only fetch so the counts are real.
+- **Exit codes** (stable, gate CI on them): `0` ok · `1` unexpected · `2`
+  validation/config · `3` auth · `4` network/5xx · `5` partial.
+- **Automatic retries**: transient failures (network error, `5xx`, `429`) are
+  retried with exponential backoff + jitter; a `429` honors `Retry-After`. Tune
+  with `LIONRAPID_RETRIES` (default `3`; `0` disables). Writes are safe to retry —
+  the integration endpoints upsert by composite key.
+- **Concurrent `pull`**: namespace fetches fan out with bounded concurrency
+  (`LIONRAPID_CONCURRENCY`, default `6`) and show interactive progress on a TTY.
+  Output stays deterministic — only the network fan-out is parallelized.
+- **`doctor`**: one command to verify config validity, credential resolution,
+  backend reachability/auth, and that declared source files exist — each checked
+  independently so you get an actionable list, not a stack trace.
+
+## Offline resilience (`snapshot`)
+
+`lionrapid snapshot` writes the **raw `ContentUnit` bundle** (`{ meta, translations }`)
+per locale/namespace, byte-shaped like the API response — **bypassing the format
+adapters** (which flatten to display strings and drop the `styles` map). Bundle
+these with your app and load them via the runtime so translations keep working
+**with the server down**:
+
+```ts
+import bundle from './snapshots/es.app.json' assert { type: 'json' };
+import {
+  LionRapidBuilder,
+  MemoryRepository,
+  StaticRepository,
+} from '@lionrapid/core';
+
+const core = await LionRapidBuilder.init({
+  defaultLocale: 'es',
+  namespace: 'app',
+})
+  .use(new MemoryRepository({ enabled: true }))
+  .useStaticBundle({ es: { app: bundle.translations } }) // offline layer (memory → static → network)
+  .build();
+core.t('welcome'); // works offline, styles intact
+```
+
+Node apps can read a snapshot directory at runtime via
+`new FileRepository('./snapshots')` from `@lionrapid/storage/node`.
+
+## No-library localization (`scan`)
+
+For a codebase with **no i18n library** (hardcoded strings, no `t()`), `scan`
+finds user-facing strings via the TypeScript AST over a finite allowlist of UI
+sinks (JSX text + `placeholder`/`alt`/`aria-label`/…), classifies them, and keys
+each by **content-hash `auto_key`** — the same key the web edge proxy / DOM
+auto-detect produces, so a string already translated on your website is reused
+in your app.
+
+- `action: wrap` — static text/attributes (deterministic, safe).
+- `action: review` — interpolation / inline markup / dynamic values (left for a
+  human or AI agent to author correctly).
+
+`scan --json` emits a machine-readable inventory on stdout (human prose on
+stderr) so an AI coding agent can drive the judgment-heavy wrapping while the CLI
+owns the correctness-critical parts (the `auto_key` hash, file writes, sync).
+`scan --push` seeds the safe candidates into the translation memory.
+
+### Wrapping (done by you / your agent)
+
+The CLI intentionally does **not** rewrite your source. It hands you the
+inventory — each candidate carries its `autoKey`, and the result carries the
+`namespace` — and you (or your AI coding agent, e.g. Claude Code / Cursor) wrap
+using the SDK, which also lets the agent handle the `review` cases (interpolation,
+plurals) a deterministic codemod can't:
+
+```tsx
+// inventory: { namespace: "app", autoKey: "auto_2d0f6b8300be", text: "Add to cart", sink: "jsx-text" }
+<Text>Add to cart</Text>
+//   →
+<Text><Trans namespace="app" i18nKey="auto_2d0f6b8300be">Add to cart</Trans></Text>
+
+// inventory: { autoKey: "auto_13348442cc6a", text: "Search", sink: "jsx-attr:placeholder" }
+placeholder="Search"  →  placeholder={t('app:auto_13348442cc6a', 'Search')}
+```
+
+Because the key is the same content-hash the web produces, any of these strings
+already translated on your website are translated in the app for free.
+
+## Usage
+
+```bash
+lionrapid init --project <id> --targets es,fr
+lionrapid push
+lionrapid pull --types
+lionrapid validate --ci
+
+# no-library localization
+lionrapid scan --json          # inventory of discovered strings (auto_key-keyed)
+lionrapid scan --push          # seed the safe candidates into the TM
+```
+
+The API key is read from `LIONRAPID_API_KEY` (or `~/.lionrapid/credentials`),
+never from the committed `lionrapid.yml`.
+
+## Development
+
+```bash
+npm run build -w packages/cli
+npm test -w packages/cli
+```

package/dist/adapters/android-xml.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Android `res/values-<locale>/strings.xml` adapter (one locale per file).
+ *
+ * Handles `<string>` and `<plurals>` (quantity items flatten to `name[quantity]`
+ * keys, e.g. `num_items[other]`). `translatable="false"` strings are skipped.
+ * Inner text is XML-entity-decoded and Android-unescaped (`\'`, `\"`, `\n`,
+ * `\t`); inline markup (`<b>`, `<i>`, …) is left intact so it flows through
+ * core's ContentUnit pipeline.
+ *
+ * Phase-1 limitations (documented intentionally): styled strings whose markup
+ * carries quoted attributes (e.g. `<a href="…">`) are uncommon in Android and
+ * not round-trip-guaranteed; CDATA is unwrapped to its literal contents.
+ */
+import type { FormatAdapter, SerializeOptions, TranslationEntry } from './types.js';
+export declare class AndroidXmlAdapter implements FormatAdapter {
+    readonly format: "android-xml";
+    parse(content: string): TranslationEntry[];
+    serialize(entries: TranslationEntry[], _options?: SerializeOptions): string;
+}
+//# sourceMappingURL=android-xml.d.ts.map

package/dist/adapters/android-xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"android-xml.d.ts","sourceRoot":"","sources":["../../src/adapters/android-xml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAmCpF,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,MAAM,gBAA0B;IAEzC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE;IA8B1C,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,MAAM;CAwC5E"}

package/dist/adapters/android-xml.js

@@ -0,0 +1,101 @@
+/**
+ * Android `res/values-<locale>/strings.xml` adapter (one locale per file).
+ *
+ * Handles `<string>` and `<plurals>` (quantity items flatten to `name[quantity]`
+ * keys, e.g. `num_items[other]`). `translatable="false"` strings are skipped.
+ * Inner text is XML-entity-decoded and Android-unescaped (`\'`, `\"`, `\n`,
+ * `\t`); inline markup (`<b>`, `<i>`, …) is left intact so it flows through
+ * core's ContentUnit pipeline.
+ *
+ * Phase-1 limitations (documented intentionally): styled strings whose markup
+ * carries quoted attributes (e.g. `<a href="…">`) are uncommon in Android and
+ * not round-trip-guaranteed; CDATA is unwrapped to its literal contents.
+ */
+import { toContentUnit, fromContentUnit } from './content.js';
+const STRING_RE = /<string\s+name="([^"]+)"([^>]*)>([\s\S]*?)<\/string>/g;
+const PLURALS_RE = /<plurals\s+name="([^"]+)"[^>]*>([\s\S]*?)<\/plurals>/g;
+const ITEM_RE = /<item\s+quantity="([^"]+)"[^>]*>([\s\S]*?)<\/item>/g;
+const PLURAL_KEY_RE = /^(.+)\[(\w+)\]$/;
+function decodeXmlEntities(s) {
+    return s
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&#(\d+);/g, (_, n) => String.fromCodePoint(Number(n)))
+        .replace(/&#x([0-9a-fA-F]+);/g, (_, h) => String.fromCodePoint(parseInt(h, 16)))
+        .replace(/&amp;/g, '&');
+}
+function decodeInner(raw) {
+    const noCdata = raw.replace(/<!\[CDATA\[([\s\S]*?)\]\]>/g, '$1');
+    return decodeXmlEntities(noCdata).replace(/\\(.)/g, (_, c) => {
+        if (c === 'n')
+            return '\n';
+        if (c === 't')
+            return '\t';
+        return c; // \' → ', \" → ", \\ → \
+    });
+}
+function encodeInner(text, hasStyles) {
+    let s = text.replace(/&(?!(amp|lt|gt|quot|apos|#\d+|#x[0-9a-fA-F]+);)/g, '&amp;');
+    if (!hasStyles)
+        s = s.replace(/</g, '&lt;').replace(/>/g, '&gt;');
+    s = s.replace(/'/g, "\\'").replace(/\n/g, '\\n').replace(/\t/g, '\\t');
+    return s;
+}
+export class AndroidXmlAdapter {
+    format = 'android-xml';
+    parse(content) {
+        const hits = [];
+        for (const m of content.matchAll(STRING_RE)) {
+            const [, name, attrs, inner] = m;
+            if (/translatable\s*=\s*"false"/.test(attrs))
+                continue;
+            hits.push({
+                index: m.index,
+                entries: [{ key: name, value: toContentUnit(decodeInner(inner)) }],
+            });
+        }
+        for (const m of content.matchAll(PLURALS_RE)) {
+            const [, name, body] = m;
+            const entries = [];
+            for (const im of body.matchAll(ITEM_RE)) {
+                const [, quantity, inner] = im;
+                entries.push({ key: `${name}[${quantity}]`, value: toContentUnit(decodeInner(inner)) });
+            }
+            hits.push({ index: m.index, entries });
+        }
+        hits.sort((a, b) => a.index - b.index);
+        return hits.flatMap((h) => h.entries);
+    }
+    serialize(entries, _options) {
+        const lines = ['<?xml version="1.0" encoding="utf-8"?>', '<resources>'];
+        for (let i = 0; i < entries.length; i += 1) {
+            const entry = entries[i];
+            const pluralMatch = entry.key.match(PLURAL_KEY_RE);
+            if (pluralMatch) {
+                const base = pluralMatch[1];
+                lines.push(`    <plurals name="${base}">`);
+                // Consume consecutive items of the same plural base.
+                while (i < entries.length) {
+                    const current = entries[i];
+                    const cm = current.key.match(PLURAL_KEY_RE);
+                    if (!cm || cm[1] !== base)
+                        break;
+                    const hasStyles = Object.keys(current.value.styles).length > 0;
+                    lines.push(`        <item quantity="${cm[2]}">${encodeInner(fromContentUnit(current.value), hasStyles)}</item>`);
+                    i += 1;
+                }
+                i -= 1; // outer loop will increment
+                lines.push('    </plurals>');
+            }
+            else {
+                const hasStyles = Object.keys(entry.value.styles).length > 0;
+                lines.push(`    <string name="${entry.key}">${encodeInner(fromContentUnit(entry.value), hasStyles)}</string>`);
+            }
+        }
+        lines.push('</resources>', '');
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=android-xml.js.map

package/dist/adapters/android-xml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"android-xml.js","sourceRoot":"","sources":["../../src/adapters/android-xml.ts"],"names":[],"mappings":"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"}

package/dist/adapters/arb.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Flutter ARB adapter (Application Resource Bundle — JSON).
+ *
+ * ARB files are JSON where translation keys map to strings and metadata lives
+ * under `@`-prefixed keys (`@@locale`, `@key: { description, placeholders }`).
+ * Per Flutter's `gen-l10n`, placeholder/description metadata lives in the
+ * *template* ARB (the source); target ARBs carry only `@@locale` + translated
+ * strings. So we parse real (non-`@`) entries and, on serialize, write
+ * `@@locale` followed by key→value pairs.
+ */
+import type { FormatAdapter, SerializeOptions, TranslationEntry } from './types.js';
+export declare class ArbAdapter implements FormatAdapter {
+    readonly format: "arb";
+    parse(content: string): TranslationEntry[];
+    serialize(entries: TranslationEntry[], options?: SerializeOptions): string;
+}
+//# sourceMappingURL=arb.d.ts.map

package/dist/adapters/arb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arb.d.ts","sourceRoot":"","sources":["../../src/adapters/arb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGpF,qBAAa,UAAW,YAAW,aAAa;IAC9C,QAAQ,CAAC,MAAM,QAAkB;IAEjC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAoB1C,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM;CAM3E"}

package/dist/adapters/arb.js

@@ -0,0 +1,45 @@
+/**
+ * Flutter ARB adapter (Application Resource Bundle — JSON).
+ *
+ * ARB files are JSON where translation keys map to strings and metadata lives
+ * under `@`-prefixed keys (`@@locale`, `@key: { description, placeholders }`).
+ * Per Flutter's `gen-l10n`, placeholder/description metadata lives in the
+ * *template* ARB (the source); target ARBs carry only `@@locale` + translated
+ * strings. So we parse real (non-`@`) entries and, on serialize, write
+ * `@@locale` followed by key→value pairs.
+ */
+import { toContentUnit, fromContentUnit } from './content.js';
+export class ArbAdapter {
+    format = 'arb';
+    parse(content) {
+        const trimmed = content.trim();
+        if (trimmed === '')
+            return [];
+        let data;
+        try {
+            data = JSON.parse(trimmed);
+        }
+        catch (err) {
+            throw new Error(`Invalid ARB (JSON): ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (data === null || typeof data !== 'object' || Array.isArray(data)) {
+            throw new Error('Expected an ARB object.');
+        }
+        const out = [];
+        for (const [key, value] of Object.entries(data)) {
+            if (key.startsWith('@'))
+                continue; // @@locale and @key metadata
+            out.push({ key, value: toContentUnit(String(value)) });
+        }
+        return out;
+    }
+    serialize(entries, options) {
+        const obj = {};
+        if (options?.locale)
+            obj['@@locale'] = options.locale;
+        for (const entry of entries)
+            obj[entry.key] = fromContentUnit(entry.value);
+        return `${JSON.stringify(obj, null, 2)}\n`;
+    }
+}
+//# sourceMappingURL=arb.js.map

package/dist/adapters/arb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arb.js","sourceRoot":"","sources":["../../src/adapters/arb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,OAAO,UAAU;IACZ,MAAM,GAAG,KAAc,CAAC;IAEjC,KAAK,CAAC,OAAe;QACnB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,EAAE;YAAE,OAAO,EAAE,CAAC;QAC9B,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QACD,MAAM,GAAG,GAAuB,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,EAAE,CAAC;YAC3E,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,6BAA6B;YAChE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,SAAS,CAAC,OAA2B,EAAE,OAA0B;QAC/D,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,IAAI,OAAO,EAAE,MAAM;YAAE,GAAG,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;QACtD,KAAK,MAAM,KAAK,IAAI,OAAO;YAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3E,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;CACF"}

package/dist/adapters/content.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Conversion between a format's display string and the universal `ContentUnit`.
+ *
+ * Plain strings (the overwhelming majority of mobile/file translations) are
+ * stored verbatim as `{ text, styles: {} }` — no entity decoding, so they
+ * round-trip exactly. Only when a value actually contains inline markup do we
+ * run core's `MarkupParser`, so inline `<b>`/`<a>` survive the round-trip and
+ * hash to the same `auto_key` as the web stack.
+ */
+import { type ContentUnit } from '@lionrapid/core';
+export declare function toContentUnit(text: string): ContentUnit;
+export declare function fromContentUnit(unit: ContentUnit): string;
+//# sourceMappingURL=content.d.ts.map

package/dist/adapters/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/adapters/content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAgC,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAMjF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAGvD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAGzD"}

package/dist/adapters/content.js

@@ -0,0 +1,24 @@
+/**
+ * Conversion between a format's display string and the universal `ContentUnit`.
+ *
+ * Plain strings (the overwhelming majority of mobile/file translations) are
+ * stored verbatim as `{ text, styles: {} }` — no entity decoding, so they
+ * round-trip exactly. Only when a value actually contains inline markup do we
+ * run core's `MarkupParser`, so inline `<b>`/`<a>` survive the round-trip and
+ * hash to the same `auto_key` as the web stack.
+ */
+import { MarkupParser, HTMLSerializer } from '@lionrapid/core';
+const parser = new MarkupParser();
+const serializer = new HTMLSerializer();
+const HAS_TAG = /<[^>]+>/;
+export function toContentUnit(text) {
+    if (!HAS_TAG.test(text))
+        return { text, styles: {} };
+    return parser.parse(text);
+}
+export function fromContentUnit(unit) {
+    if (!unit.styles || Object.keys(unit.styles).length === 0)
+        return unit.text;
+    return serializer.serialize(unit);
+}
+//# sourceMappingURL=content.js.map

package/dist/adapters/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/adapters/content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAoB,MAAM,iBAAiB,CAAC;AAEjF,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;AAClC,MAAM,UAAU,GAAG,IAAI,cAAc,EAAE,CAAC;AACxC,MAAM,OAAO,GAAG,SAAS,CAAC;AAE1B,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrD,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAiB;IAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAC5E,OAAO,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Format adapter registry. Adapters are added one per increment; asking for a
+ * format that isn't wired up yet throws a clear, actionable error rather than
+ * failing obscurely.
+ */
+import type { FileFormat } from '../config.js';
+import type { FormatAdapter } from './types.js';
+export declare function getAdapter(format: FileFormat): FormatAdapter;
+export declare function supportedFormats(): FileFormat[];
+export type { FormatAdapter, TranslationEntry, SerializeOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAqBhD,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAQ5D;AAED,wBAAgB,gBAAgB,IAAI,UAAU,EAAE,CAE/C;AAED,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,34 @@
+/**
+ * Format adapter registry. Adapters are added one per increment; asking for a
+ * format that isn't wired up yet throws a clear, actionable error rather than
+ * failing obscurely.
+ */
+import { JsonAdapter } from './json.js';
+import { ArbAdapter } from './arb.js';
+import { IosStringsAdapter } from './ios-strings.js';
+import { AndroidXmlAdapter } from './android-xml.js';
+import { XcstringsAdapter } from './xcstrings.js';
+import { YamlAdapter } from './yaml.js';
+import { PoAdapter } from './po.js';
+import { XliffAdapter } from './xliff.js';
+const ADAPTERS = new Map([
+    ['json', new JsonAdapter()],
+    ['arb', new ArbAdapter()],
+    ['ios-strings', new IosStringsAdapter()],
+    ['android-xml', new AndroidXmlAdapter()],
+    ['xcstrings', new XcstringsAdapter()],
+    ['yaml', new YamlAdapter()],
+    ['po', new PoAdapter()],
+    ['xliff', new XliffAdapter()],
+]);
+export function getAdapter(format) {
+    const adapter = ADAPTERS.get(format);
+    if (!adapter) {
+        throw new Error(`No adapter for format "${format}" yet. Supported: ${[...ADAPTERS.keys()].join(', ')}.`);
+    }
+    return adapter;
+}
+export function supportedFormats() {
+    return [...ADAPTERS.keys()];
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAA4B;IAClD,CAAC,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;IAC3B,CAAC,KAAK,EAAE,IAAI,UAAU,EAAE,CAAC;IACzB,CAAC,aAAa,EAAE,IAAI,iBAAiB,EAAE,CAAC;IACxC,CAAC,aAAa,EAAE,IAAI,iBAAiB,EAAE,CAAC;IACxC,CAAC,WAAW,EAAE,IAAI,gBAAgB,EAAE,CAAC;IACrC,CAAC,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;IAC3B,CAAC,IAAI,EAAE,IAAI,SAAS,EAAE,CAAC;IACvB,CAAC,OAAO,EAAE,IAAI,YAAY,EAAE,CAAC;CAC9B,CAAC,CAAC;AAEH,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,0BAA0B,MAAM,qBAAqB,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACxF,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,CAAC"}

package/dist/adapters/ios-strings.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Apple `.strings` adapter (legacy iOS/macOS localization).
+ *
+ * Format: `"key" = "value";` pairs, each optionally preceded by a C-style
+ * block comment. Keys and values are double-quoted with C-style escapes
+ * (`\"`, `\\`, `\n`, `\t`, `\r`). Each `.strings` file holds a single locale,
+ * which fits the source/target per-locale file model directly.
+ */
+import type { FormatAdapter, TranslationEntry } from './types.js';
+export declare class IosStringsAdapter implements FormatAdapter {
+    readonly format: "ios-strings";
+    parse(content: string): TranslationEntry[];
+    serialize(entries: TranslationEntry[]): string;
+}
+//# sourceMappingURL=ios-strings.d.ts.map

package/dist/adapters/ios-strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios-strings.d.ts","sourceRoot":"","sources":["../../src/adapters/ios-strings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAwBlE,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,MAAM,gBAA0B;IAEzC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAa1C,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM;CAQ/C"}

package/dist/adapters/ios-strings.js

@@ -0,0 +1,54 @@
+/**
+ * Apple `.strings` adapter (legacy iOS/macOS localization).
+ *
+ * Format: `"key" = "value";` pairs, each optionally preceded by a C-style
+ * block comment. Keys and values are double-quoted with C-style escapes
+ * (`\"`, `\\`, `\n`, `\t`, `\r`). Each `.strings` file holds a single locale,
+ * which fits the source/target per-locale file model directly.
+ */
+import { toContentUnit, fromContentUnit } from './content.js';
+const ENTRY_RE = /(?:\/\*\s*([\s\S]*?)\s*\*\/\s*)?"((?:\\.|[^"\\])*)"\s*=\s*"((?:\\.|[^"\\])*)"\s*;/g;
+function unescape(s) {
+    return s.replace(/\\(.)/g, (_, c) => {
+        if (c === 'n')
+            return '\n';
+        if (c === 't')
+            return '\t';
+        if (c === 'r')
+            return '\r';
+        return c; // \" → " , \\ → \
+    });
+}
+function escape(s) {
+    return s
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, '\\n')
+        .replace(/\t/g, '\\t')
+        .replace(/\r/g, '\\r');
+}
+export class IosStringsAdapter {
+    format = 'ios-strings';
+    parse(content) {
+        const out = [];
+        for (const match of content.matchAll(ENTRY_RE)) {
+            const [, comment, rawKey, rawValue] = match;
+            out.push({
+                key: unescape(rawKey),
+                value: toContentUnit(unescape(rawValue)),
+                ...(comment ? { comment: comment.trim() } : {}),
+            });
+        }
+        return out;
+    }
+    serialize(entries) {
+        const lines = [];
+        for (const entry of entries) {
+            if (entry.comment)
+                lines.push(`/* ${entry.comment} */`);
+            lines.push(`"${escape(entry.key)}" = "${escape(fromContentUnit(entry.value))}";`);
+        }
+        return lines.length ? `${lines.join('\n')}\n` : '';
+    }
+}
+//# sourceMappingURL=ios-strings.js.map

package/dist/adapters/ios-strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios-strings.js","sourceRoot":"","sources":["../../src/adapters/ios-strings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,QAAQ,GACZ,oFAAoF,CAAC;AAEvF,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE;QAC1C,IAAI,CAAC,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAC3B,OAAO,CAAC,CAAC,CAAC,kBAAkB;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,CAAC;SACL,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,OAAO,iBAAiB;IACnB,MAAM,GAAG,aAAsB,CAAC;IAEzC,KAAK,CAAC,OAAe;QACnB,MAAM,GAAG,GAAuB,EAAE,CAAC;QACnC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC;YAC5C,GAAG,CAAC,IAAI,CAAC;gBACP,GAAG,EAAE,QAAQ,CAAC,MAAO,CAAC;gBACtB,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,QAAS,CAAC,CAAC;gBACzC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChD,CAAC,CAAC;QACL,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,SAAS,CAAC,OAA2B;QACnC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;YACxD,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;QACpF,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,CAAC;CACF"}

package/dist/adapters/json.d.ts

@@ -0,0 +1,12 @@
+/**
+ * JSON adapter — flat or nested i18n JSON (i18next, react-intl, Vue-i18n, RN,
+ * node backends). Nested objects flatten to dot-notation keys (`home.cta`) and
+ * unflatten back on serialize, preserving insertion order.
+ */
+import type { FormatAdapter, TranslationEntry } from './types.js';
+export declare class JsonAdapter implements FormatAdapter {
+    readonly format: "json";
+    parse(content: string): TranslationEntry[];
+    serialize(entries: TranslationEntry[]): string;
+}
+//# sourceMappingURL=json.d.ts.map

package/dist/adapters/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/adapters/json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGlE,qBAAa,WAAY,YAAW,aAAa;IAC/C,QAAQ,CAAC,MAAM,SAAmB;IAElC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAiB1C,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM;CAG/C"}

package/dist/adapters/json.js

@@ -0,0 +1,31 @@
+/**
+ * JSON adapter — flat or nested i18n JSON (i18next, react-intl, Vue-i18n, RN,
+ * node backends). Nested objects flatten to dot-notation keys (`home.cta`) and
+ * unflatten back on serialize, preserving insertion order.
+ */
+import { flattenObject, unflattenEntries } from './nested.js';
+export class JsonAdapter {
+    format = 'json';
+    parse(content) {
+        const trimmed = content.trim();
+        if (trimmed === '')
+            return [];
+        let data;
+        try {
+            data = JSON.parse(trimmed);
+        }
+        catch (err) {
+            throw new Error(`Invalid JSON: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (data === null || typeof data !== 'object' || Array.isArray(data)) {
+            throw new Error('Expected a JSON object of translation keys.');
+        }
+        const out = [];
+        flattenObject(data, '', out);
+        return out;
+    }
+    serialize(entries) {
+        return `${JSON.stringify(unflattenEntries(entries), null, 2)}\n`;
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/adapters/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/adapters/json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,OAAO,WAAW;IACb,MAAM,GAAG,MAAe,CAAC;IAElC,KAAK,CAAC,OAAe;QACnB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,EAAE;YAAE,OAAO,EAAE,CAAC;QAC9B,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,GAAG,GAAuB,EAAE,CAAC;QACnC,aAAa,CAAC,IAA+B,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QACxD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,SAAS,CAAC,OAA2B;QACnC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IACnE,CAAC;CACF"}

package/dist/adapters/nested.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared flatten/unflatten for nested key/value formats (JSON, YAML). Nested
+ * objects become dot-notation keys (`home.cta`) and rebuild on serialize,
+ * preserving insertion order. Values convert through the ContentUnit helpers.
+ */
+import type { TranslationEntry } from './types.js';
+export declare function flattenObject(obj: Record<string, unknown>, prefix: string, out: TranslationEntry[]): void;
+export declare function unflattenEntries(entries: TranslationEntry[]): Record<string, unknown>;
+//# sourceMappingURL=nested.d.ts.map

package/dist/adapters/nested.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nested.d.ts","sourceRoot":"","sources":["../../src/adapters/nested.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,gBAAgB,EAAE,GACtB,IAAI,CAYN;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAerF"}