@lionrapid/cli 0.1.0

package/dist/commands/init.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `init` — scaffold a `lionrapid.yml` by detecting the project's stack.
+ *
+ * Detection is best-effort and additive: a repo with both an Android and an iOS
+ * project gets file entries for both. The config is emitted with the `yaml`
+ * serializer so paths that need quoting (e.g. a target starting with
+ * `{locale}`) are quoted correctly. The logic is pure/testable; the commander
+ * action only supplies overrides and prints next steps.
+ */
+import type { FileFormat } from '../config.js';
+interface DetectedFile {
+    format: FileFormat;
+    source: string;
+    target: string;
+}
+export interface DetectResult {
+    stacks: string[];
+    files: DetectedFile[];
+}
+/** Inspect the project for known i18n stacks and propose file mappings. */
+export declare function detectProject(cwd: string): DetectResult;
+export interface InitAnswers {
+    project?: string;
+    server?: string;
+    sourceLocale?: string;
+    targetLocales?: string[];
+    force?: boolean;
+}
+export interface InitResult {
+    configPath: string;
+    yaml: string;
+    detected: DetectResult;
+}
+export declare function runInit(cwd: string, answers?: InitAnswers): InitResult;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,UAAU,YAAY;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AA4BD,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAuDvD;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,UAAU,CAmB1E"}

package/dist/commands/init.js

@@ -0,0 +1,111 @@
+/**
+ * `init` — scaffold a `lionrapid.yml` by detecting the project's stack.
+ *
+ * Detection is best-effort and additive: a repo with both an Android and an iOS
+ * project gets file entries for both. The config is emitted with the `yaml`
+ * serializer so paths that need quoting (e.g. a target starting with
+ * `{locale}`) are quoted correctly. The logic is pure/testable; the commander
+ * action only supplies overrides and prints next steps.
+ */
+import { existsSync, readdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { stringify as stringifyYaml } from 'yaml';
+import { ConfigError } from '../config.js';
+function hasAny(cwd, names) {
+    return names.some((n) => existsSync(join(cwd, n)));
+}
+/** Shallow search (bounded depth) for a file matching `test`. */
+function findShallow(cwd, test, maxDepth = 3) {
+    const skip = new Set(['node_modules', '.git', 'build', 'dist', 'Pods', '.dart_tool']);
+    const walk = (dir, depth) => {
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return false;
+        }
+        for (const e of entries) {
+            // Match files (e.g. *.xcstrings) and directories (e.g. *.xcodeproj).
+            if (test(e.name))
+                return true;
+            if (e.isDirectory() && depth < maxDepth && !skip.has(e.name)) {
+                if (walk(join(dir, e.name), depth + 1))
+                    return true;
+            }
+        }
+        return false;
+    };
+    return walk(cwd, 0);
+}
+/** Inspect the project for known i18n stacks and propose file mappings. */
+export function detectProject(cwd) {
+    const stacks = [];
+    const files = [];
+    if (existsSync(join(cwd, 'pubspec.yaml'))) {
+        stacks.push('Flutter');
+        files.push({
+            format: 'arb',
+            source: 'lib/l10n/app_en.arb',
+            target: 'lib/l10n/app_{locale}.arb',
+        });
+    }
+    if (hasAny(cwd, ['build.gradle', 'build.gradle.kts', 'settings.gradle', 'app/build.gradle'])) {
+        stacks.push('Android');
+        files.push({
+            format: 'android-xml',
+            source: 'app/src/main/res/values/strings.xml',
+            target: 'app/src/main/res/values-{locale}/strings.xml',
+        });
+    }
+    if (findShallow(cwd, (n) => n.endsWith('.xcodeproj') || n.endsWith('.xcstrings'), 2)) {
+        stacks.push('iOS');
+        if (findShallow(cwd, (n) => n.endsWith('.xcstrings'), 3)) {
+            files.push({
+                format: 'xcstrings',
+                source: 'Localizable.xcstrings',
+                target: 'Localizable.xcstrings',
+            });
+        }
+        else {
+            files.push({
+                format: 'ios-strings',
+                source: 'en.lproj/Localizable.strings',
+                target: '{locale}.lproj/Localizable.strings',
+            });
+        }
+    }
+    if (existsSync(join(cwd, 'config', 'locales'))) {
+        stacks.push('Rails');
+        files.push({
+            format: 'yaml',
+            source: 'config/locales/en.yml',
+            target: 'config/locales/{locale}.yml',
+        });
+    }
+    if (files.length === 0) {
+        // Default to JSON (covers React Native, node, Vue, generic).
+        stacks.push(existsSync(join(cwd, 'package.json')) ? 'JavaScript' : 'generic');
+        files.push({ format: 'json', source: 'locales/en.json', target: 'locales/{locale}.json' });
+    }
+    return { stacks, files };
+}
+export function runInit(cwd, answers = {}) {
+    const configPath = join(cwd, 'lionrapid.yml');
+    if (existsSync(configPath) && !answers.force) {
+        throw new ConfigError(`lionrapid.yml already exists at ${configPath} (use --force to overwrite).`);
+    }
+    const detected = detectProject(cwd);
+    const config = {
+        project: answers.project ?? 'YOUR_PROJECT_ID',
+        server: answers.server ?? 'https://api.lionrapid.com',
+        sourceLocale: answers.sourceLocale ?? 'en',
+        targetLocales: answers.targetLocales ?? ['es', 'fr'],
+        namespace: 'app',
+        files: detected.files,
+    };
+    const yaml = stringifyYaml(config);
+    writeFileSync(configPath, yaml);
+    return { configPath, yaml, detected };
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/pull.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `pull` — download published translations and write them into target files.
+ *
+ * Per-locale formats write one file per locale. Multi-locale catalog formats
+ * (e.g. .xcstrings) read a base catalog (existing target, else the source) and
+ * have every target locale merged into it, written once. Only `mark-ready`
+ * rows are returned by the public endpoint; we report how many source keys are
+ * still pending per locale.
+ */
+import type { LionRapidConfig } from '../config.js';
+import type { LionRapidApiClient } from '../api-client.js';
+export interface PullOptions {
+    cwd: string;
+    /** Fetch + count what would be written, but write no files. */
+    dryRun?: boolean;
+    /** Progress callback, invoked as each namespace fetch completes. */
+    onProgress?: (done: number, total: number) => void;
+}
+export interface PullFileResult {
+    target: string;
+    count: number;
+}
+export interface PullLocaleResult {
+    locale: string;
+    files: PullFileResult[];
+    /** Source keys present but not yet translated/published for this locale. */
+    pending: number;
+}
+export interface PullResult {
+    locales: PullLocaleResult[];
+    /** True when this was a dry run — no files were written. */
+    dryRun?: boolean;
+}
+export declare function runPull(config: LionRapidConfig, client: LionRapidApiClient, opts: PullOptions): Promise<PullResult>;
+//# sourceMappingURL=pull.d.ts.map

package/dist/commands/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAa,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAI3D,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAkBD,wBAAsB,OAAO,CAC3B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,UAAU,CAAC,CA+GrB"}

package/dist/commands/pull.js

@@ -0,0 +1,123 @@
+/**
+ * `pull` — download published translations and write them into target files.
+ *
+ * Per-locale formats write one file per locale. Multi-locale catalog formats
+ * (e.g. .xcstrings) read a base catalog (existing target, else the source) and
+ * have every target locale merged into it, written once. Only `mark-ready`
+ * rows are returned by the public endpoint; we report how many source keys are
+ * still pending per locale.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { getAdapter } from '../adapters/index.js';
+import { mapLimit, resolveConcurrency } from './context.js';
+/** Union of source keys per namespace, for "pending" reporting. */
+function sourceKeysByNamespace(config, cwd) {
+    const byNs = new Map();
+    for (const file of config.files) {
+        const ns = file.namespace ?? config.namespace;
+        const abs = resolve(cwd, file.source);
+        if (!existsSync(abs))
+            continue;
+        const set = byNs.get(ns) ?? new Set();
+        for (const entry of getAdapter(file.format).parse(readFileSync(abs, 'utf8'))) {
+            set.add(entry.key);
+        }
+        byNs.set(ns, set);
+    }
+    return byNs;
+}
+export async function runPull(config, client, opts) {
+    const sourceKeys = sourceKeysByNamespace(config, opts.cwd);
+    const perLocaleFiles = config.files.filter((f) => !getAdapter(f.format).multiLocale);
+    const multiFiles = config.files.filter((f) => getAdapter(f.format).multiLocale);
+    // Run-wide namespace cache, keyed `${locale}:${namespace}`.
+    const nsCache = new Map();
+    const fetchNs = async (locale, namespace) => {
+        const cacheKey = `${locale}:${namespace}`;
+        const hit = nsCache.get(cacheKey);
+        if (hit)
+            return hit;
+        const bundle = await client.getNamespace(locale, namespace);
+        nsCache.set(cacheKey, bundle.translations);
+        return bundle.translations;
+    };
+    // Pre-fetch every needed (locale, namespace) bundle concurrently so the slow
+    // network fan-out runs in parallel; the write loops below then read the warm
+    // cache. Output stays deterministic — only the fetch is parallelized.
+    const allNamespaces = new Set();
+    for (const file of config.files)
+        allNamespaces.add(file.namespace ?? config.namespace);
+    const pairs = config.targetLocales.flatMap((locale) => [...allNamespaces].map((namespace) => ({ locale, namespace })));
+    let fetched = 0;
+    await mapLimit(pairs, resolveConcurrency(), async ({ locale, namespace }) => {
+        await fetchNs(locale, namespace);
+        opts.onProgress?.(++fetched, pairs.length);
+    });
+    const toEntries = (translations) => Object.entries(translations).map(([key, value]) => ({ key, value }));
+    // Base content for each multi-locale catalog: prefer existing target, else source.
+    const catalogContent = new Map();
+    for (const file of multiFiles) {
+        const targetAbs = resolve(opts.cwd, file.target);
+        const sourceAbs = resolve(opts.cwd, file.source);
+        const base = existsSync(targetAbs)
+            ? readFileSync(targetAbs, 'utf8')
+            : existsSync(sourceAbs)
+                ? readFileSync(sourceAbs, 'utf8')
+                : null;
+        catalogContent.set(file, base);
+    }
+    const locales = [];
+    for (const locale of config.targetLocales) {
+        const fileResults = [];
+        const usedNamespaces = new Set();
+        for (const file of perLocaleFiles) {
+            const adapter = getAdapter(file.format);
+            const namespace = file.namespace ?? config.namespace;
+            usedNamespaces.add(namespace);
+            const entries = toEntries(await fetchNs(locale, namespace));
+            const relPath = file.target.replace('{locale}', locale);
+            // Don't clobber an existing target with an empty result (locked/pending).
+            // Dry run computes counts but writes nothing.
+            if (entries.length > 0 && !opts.dryRun) {
+                const absPath = resolve(opts.cwd, relPath);
+                mkdirSync(dirname(absPath), { recursive: true });
+                writeFileSync(absPath, adapter.serialize(entries, { locale, sourceLocale: config.sourceLocale }));
+            }
+            fileResults.push({ target: relPath, count: entries.length });
+        }
+        for (const file of multiFiles) {
+            const adapter = getAdapter(file.format);
+            const namespace = file.namespace ?? config.namespace;
+            usedNamespaces.add(namespace);
+            const entries = toEntries(await fetchNs(locale, namespace));
+            if (entries.length > 0) {
+                const merged = adapter.mergeLocale(catalogContent.get(file) ?? null, entries, locale);
+                catalogContent.set(file, merged);
+            }
+            fileResults.push({ target: file.target, count: entries.length });
+        }
+        let pending = 0;
+        for (const namespace of usedNamespaces) {
+            const have = new Set(Object.keys(nsCache.get(`${locale}:${namespace}`) ?? {}));
+            for (const key of sourceKeys.get(namespace) ?? new Set()) {
+                if (!have.has(key))
+                    pending += 1;
+            }
+        }
+        locales.push({ locale, files: fileResults, pending });
+    }
+    // Write each accumulated multi-locale catalog once (skipped on a dry run).
+    if (!opts.dryRun) {
+        for (const file of multiFiles) {
+            const content = catalogContent.get(file);
+            if (content != null) {
+                const absPath = resolve(opts.cwd, file.target);
+                mkdirSync(dirname(absPath), { recursive: true });
+                writeFileSync(absPath, content);
+            }
+        }
+    }
+    return { locales, ...(opts.dryRun ? { dryRun: true } : {}) };
+}
+//# sourceMappingURL=pull.js.map

package/dist/commands/pull.js.map

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

package/dist/commands/push.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `push` — upload local strings to the backend.
+ *
+ * Default (source) mode reads each entry's `source` file and registers source
+ * rows via `sync/batch`; the server then queues machine translation for the
+ * configured target locales.
+ *
+ * `--target <locale>` mode uploads an already-translated target file as drafts
+ * via `targets/batch`, optionally publishing them with `--publish`.
+ */
+import type { LionRapidConfig } from '../config.js';
+import type { LionRapidApiClient } from '../api-client.js';
+export interface PushOptions {
+    cwd: string;
+    /** Push an already-translated target locale instead of the source. */
+    target?: string;
+    /** In target mode, mark every pushed row ready (public) after writing. */
+    publish?: boolean;
+    /** Parse + count what would be pushed, but make no network calls. */
+    dryRun?: boolean;
+}
+export interface PushFileResult {
+    file: string;
+    count: number;
+    skipped?: boolean;
+}
+export interface PushResult {
+    mode: 'source' | 'target';
+    pushed: number;
+    files: PushFileResult[];
+    /** True when `--publish` was requested but no editor token was available. */
+    publishSkipped?: boolean;
+    /** True when this was a dry run — nothing was sent to the server. */
+    dryRun?: boolean;
+}
+export declare function runPush(config: LionRapidConfig, client: LionRapidApiClient, opts: PushOptions): Promise<PushResult>;
+//# sourceMappingURL=push.d.ts.map

package/dist/commands/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/commands/push.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAoB,MAAM,kBAAkB,CAAC;AAM7E,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,UAAU,CAAC,CAoDrB"}

package/dist/commands/push.js

@@ -0,0 +1,63 @@
+/**
+ * `push` — upload local strings to the backend.
+ *
+ * Default (source) mode reads each entry's `source` file and registers source
+ * rows via `sync/batch`; the server then queues machine translation for the
+ * configured target locales.
+ *
+ * `--target <locale>` mode uploads an already-translated target file as drafts
+ * via `targets/batch`, optionally publishing them with `--publish`.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { getAdapter } from '../adapters/index.js';
+import { chunk } from './context.js';
+const BATCH = 500;
+export async function runPush(config, client, opts) {
+    const mode = opts.target ? 'target' : 'source';
+    const files = [];
+    // Publishing (mark-ready) needs an editor token; if asked to publish without
+    // one, we still upload the drafts and report that publishing was skipped.
+    const canPublish = mode === 'target' && opts.publish === true && client.canPublish;
+    const publishSkipped = mode === 'target' && opts.publish === true && !client.canPublish;
+    let pushed = 0;
+    for (const file of config.files) {
+        const adapter = getAdapter(file.format);
+        const namespace = file.namespace ?? config.namespace;
+        const relPath = mode === 'source' ? file.source : file.target.replace('{locale}', opts.target);
+        const absPath = resolve(opts.cwd, relPath);
+        if (!existsSync(absPath)) {
+            files.push({ file: relPath, count: 0, skipped: true });
+            continue;
+        }
+        const parseLocale = mode === 'source' ? config.sourceLocale : opts.target;
+        const entries = adapter.parse(readFileSync(absPath, 'utf8'), { locale: parseLocale });
+        const items = entries.map((e) => ({ key: e.key, value: e.value }));
+        // Dry run: parse + count only, never touch the network.
+        if (!opts.dryRun) {
+            for (const batch of chunk(items, BATCH)) {
+                if (mode === 'source') {
+                    await client.syncBatch(config.sourceLocale, namespace, batch);
+                }
+                else {
+                    await client.targetsBatch(opts.target, namespace, batch);
+                    if (canPublish) {
+                        for (const it of batch) {
+                            await client.markReady(opts.target, namespace, it.key);
+                        }
+                    }
+                }
+            }
+        }
+        pushed += items.length;
+        files.push({ file: relPath, count: items.length });
+    }
+    return {
+        mode,
+        pushed,
+        files,
+        ...(publishSkipped ? { publishSkipped: true } : {}),
+        ...(opts.dryRun ? { dryRun: true } : {}),
+    };
+}
+//# sourceMappingURL=push.js.map

package/dist/commands/push.js.map

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

package/dist/commands/scan.d.ts

@@ -0,0 +1,46 @@
+/**
+ * `scan` — discover candidate user-facing strings in source and produce an
+ * inventory keyed by content-hash auto_key. Offline; the deterministic half of
+ * the no-library localization flow. The judgment-heavy `review` candidates are
+ * handed to a human/agent; the safe `wrap` candidates can be auto-wrapped (N5)
+ * and seeded/pushed (N6).
+ */
+import type { LionRapidConfig } from '../config.js';
+import type { LionRapidApiClient } from '../api-client.js';
+import { type Candidate } from '../scan/scanner.js';
+export declare const DEFAULT_SCAN_INCLUDE: string[];
+export declare const DEFAULT_SCAN_EXCLUDE: string[];
+export interface ScanOptions {
+    cwd: string;
+    include?: string[];
+    exclude?: string[];
+}
+export interface ScanSummary {
+    files: number;
+    candidates: number;
+    wrap: number;
+    review: number;
+    uniqueKeys: number;
+}
+export interface ScanResult {
+    /** Namespace the discovered keys belong to (for the agent/human to wrap with). */
+    namespace: string;
+    summary: ScanSummary;
+    candidates: Candidate[];
+}
+export declare function runScan(config: LionRapidConfig, opts: ScanOptions): Promise<ScanResult>;
+export interface SeedResult {
+    pushed: number;
+}
+/**
+ * Push the scan's `wrap` candidates to the backend as source rows keyed by their
+ * content-hash auto_key (composite `{sourceLocale}:{namespace}:auto_xxx`) — the
+ * same key the web/edge stack produces — so the backend can dedup them against
+ * the web TM. Only deterministic `wrap` candidates are seeded; `review`
+ * candidates are left for a human/agent.
+ */
+export declare function seedFromScan(result: ScanResult, client: LionRapidApiClient, opts: {
+    sourceLocale: string;
+    namespace: string;
+}): Promise<SeedResult>;
+//# sourceMappingURL=scan.d.ts.map

package/dist/commands/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAoB,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE7E,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEhE,eAAO,MAAM,oBAAoB,UAA+B,CAAC;AACjE,eAAO,MAAM,oBAAoB,UAKhC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,UAAU,CAAC,CA8BrB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,UAAU,CAAC,CAerB"}

package/dist/commands/scan.js

@@ -0,0 +1,68 @@
+/**
+ * `scan` — discover candidate user-facing strings in source and produce an
+ * inventory keyed by content-hash auto_key. Offline; the deterministic half of
+ * the no-library localization flow. The judgment-heavy `review` candidates are
+ * handed to a human/agent; the safe `wrap` candidates can be auto-wrapped (N5)
+ * and seeded/pushed (N6).
+ */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { discoverFiles } from '../scan/discover.js';
+import { scanSource } from '../scan/scanner.js';
+export const DEFAULT_SCAN_INCLUDE = ['src/**/*.{ts,tsx,js,jsx}'];
+export const DEFAULT_SCAN_EXCLUDE = [
+    '**/*.test.*',
+    '**/*.spec.*',
+    '**/*.d.ts',
+    '**/*.stories.*',
+];
+export async function runScan(config, opts) {
+    const include = opts.include ??
+        (config.scan?.include.length ? config.scan.include : DEFAULT_SCAN_INCLUDE);
+    const exclude = opts.exclude ??
+        (config.scan?.exclude.length ? config.scan.exclude : DEFAULT_SCAN_EXCLUDE);
+    const files = discoverFiles(opts.cwd, { include, exclude });
+    const candidates = [];
+    for (const rel of files) {
+        const code = readFileSync(resolve(opts.cwd, rel), 'utf8');
+        candidates.push(...(await scanSource(code, rel)));
+    }
+    const wrap = candidates.filter((c) => c.action === 'wrap');
+    const review = candidates.filter((c) => c.action === 'review');
+    const uniqueKeys = new Set(wrap.map((c) => c.autoKey)).size;
+    return {
+        namespace: config.namespace,
+        summary: {
+            files: files.length,
+            candidates: candidates.length,
+            wrap: wrap.length,
+            review: review.length,
+            uniqueKeys,
+        },
+        candidates,
+    };
+}
+/**
+ * Push the scan's `wrap` candidates to the backend as source rows keyed by their
+ * content-hash auto_key (composite `{sourceLocale}:{namespace}:auto_xxx`) — the
+ * same key the web/edge stack produces — so the backend can dedup them against
+ * the web TM. Only deterministic `wrap` candidates are seeded; `review`
+ * candidates are left for a human/agent.
+ */
+export async function seedFromScan(result, client, opts) {
+    const byKey = new Map();
+    for (const c of result.candidates) {
+        if (c.action === 'wrap' && c.autoKey && !byKey.has(c.autoKey)) {
+            byKey.set(c.autoKey, { text: c.text, styles: {} });
+        }
+    }
+    const items = [...byKey.entries()].map(([key, value]) => ({
+        key,
+        value,
+    }));
+    if (items.length > 0) {
+        await client.syncBatch(opts.sourceLocale, opts.namespace, items);
+    }
+    return { pushed: items.length };
+}
+//# sourceMappingURL=scan.js.map

package/dist/commands/scan.js.map

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

package/dist/commands/snapshot.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `snapshot` — produce offline-resilience snapshot files: the RAW
+ * `bundle.translations` (`Record<key, ContentUnit>`) the backend returns,
+ * written verbatim per (locale, namespace).
+ *
+ * CRITICAL: this deliberately BYPASSES the format adapters. The pull/format
+ * adapters flatten ContentUnit to plain display strings (dropping the `styles`
+ * map) — fine for human-edited translation files, fatal for runtime seeding,
+ * because the runtime needs the full ContentUnit (text + styles) to render
+ * inline markup (`<1>…</1>`). The snapshot is byte-shaped exactly like
+ * `GET /api/integrations/translations/{locale}/{namespace}`, so it drops
+ * straight into `MemoryRepository.setNamespace` / `StaticRepository` on every
+ * surface with no re-derivation.
+ */
+import type { ContentUnit } from '@lionrapid/core';
+import type { LionRapidConfig } from '../config.js';
+import type { LionRapidApiClient } from '../api-client.js';
+export declare const DEFAULT_SNAPSHOT_DIR = "snapshots";
+export interface SnapshotOptions {
+    cwd: string;
+    out?: string;
+    /** Stamp written into meta (caller supplies; omitted from golden comparisons). */
+    generatedAt?: string;
+}
+export interface SnapshotFileResult {
+    path: string;
+    locale: string;
+    namespace: string;
+    keys: number;
+}
+export interface SnapshotResult {
+    files: SnapshotFileResult[];
+    skipped: Array<{
+        locale: string;
+        namespace: string;
+    }>;
+}
+export interface SnapshotFile {
+    meta: {
+        locale: string;
+        namespace: string;
+        version?: string;
+        generatedAt?: string;
+    };
+    translations: Record<string, ContentUnit>;
+}
+export declare function runSnapshot(config: LionRapidConfig, client: LionRapidApiClient, opts: SnapshotOptions): Promise<SnapshotResult>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/commands/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/commands/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpF,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAC3C;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,cAAc,CAAC,CAmCzB"}