@chipmobilesdk/rn-i18n-tooling 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,77 @@
+# @chipmobilesdk/rn-i18n-tooling
+
+## 0.1.1
+
+### Patch Changes
+
+- `chip-i18n` runs on Linux and macOS again. ([#27](https://github.com/operationd8979/chip-mobile-sdk/pull/27))
+
+  Every line of `bin/chip-i18n.mjs` in 0.1.0 ends in CRLF, the shebang included, so the
+  kernel reads the interpreter name as `node\r` and the command dies before it starts:
+
+  ```
+  $ npx chip-i18n --help
+  /usr/bin/env: 'node\r': No such file or directory
+  ```
+
+  Only away from Windows. 0.1.0 had to be published by hand — npm's trusted publishing
+  cannot create a package that does not exist yet — and `npm pack` ships the working tree
+  as it stands, which on a Windows checkout (`core.autocrlf`) had every line rewritten. The
+  package's own smoke test installs the tarball and runs the binary, but it passes on
+  Windows, where CRLF is fine, and in CI, where the checkout is LF: the broken artifact
+  exists only in between.
+
+  `.gitattributes` now pins `packages/*/bin/**` to LF so no checkout can rewrite it, and
+  `npm run check:manifests` fails on a `bin` target that contains a carriage return or is
+  missing its shebang. Nothing else in the package changed.
+
+## 0.1.0
+
+### Minor Changes
+
+- The extraction CLI is a package of its own, and it runs from npm. ([#21](https://github.com/operationd8979/chip-mobile-sdk/pull/21))
+
+  `@chipmobilesdk/rn-i18n-tooling` is new: it builds to JavaScript, declares the Node it
+  needs (`>=22.13.0`) and exposes a `chip-i18n` binary.
+
+  ```sh
+  npm i -D @chipmobilesdk/rn-i18n-tooling
+  npx chip-i18n sync                # was: node --experimental-strip-types \
+                                    #   node_modules/@chipmobilesdk/rn-i18n/src/tooling/cli.ts
+  ```
+
+  The tooling used to ship inside the runtime tarball as TypeScript source behind a
+  `./tooling` subpath, so the command the README documented worked in this monorepo and
+  nowhere else — a consumer had no `bin`, and `node` could not execute the `.ts`
+  (I18N-01, DEP-02). A test now installs the package into a throwaway app's
+  `node_modules` from exactly what `files` lists and runs the binary there, so "works
+  when published" is checked rather than asserted.
+
+  `@chipmobilesdk/rn-i18n` therefore has one entrypoint and no subpaths, and its tarball
+  no longer carries `src/tooling`. **Migration:** an app that imported
+  `@chipmobilesdk/rn-i18n/tooling` for the programmatic API installs the new package and
+  imports `@chipmobilesdk/rn-i18n-tooling` instead; the members are unchanged
+  (`runSync`, `scanSource`, `syncLocaleFiles`, `buildReport`, `renderReport`,
+  `generateKeysFile`, `renderKeysModule`, `validateSyncConfig`, `listSourceFiles`,
+  `globToRegExp`). An app that only ran the CLI replaces its script with `chip-i18n sync`.
+
+  Three things the move fixed while the code was in hand:
+
+  - **The scan starts where the glob does.** `listSourceFiles` walked the project root and
+    threw away almost everything it read; it now walks each glob's own base directory
+    (`src/screens/**/*.tsx` → `src/screens`), one walk per distinct base.
+  - **A match offset becomes a line number by binary search** over the file's line
+    starts, computed once. Counting newlines per match made a file with many keys
+    quadratic in its own length, and the ambiguous-usage snippet re-split the whole file
+    for every hit.
+  - **A sync with nothing to do writes nothing.** Each locale file and the generated keys
+    file are compared with what would be written — with line endings normalised, so a
+    Windows checkout's CRLF is not "a change" — and left alone when they match. Rewriting
+    identical bytes churned every mtime, which woke watchers and showed work in
+    `git status` that had not happened. The report says `Locale files: unchanged, nothing
+    written`.
+
+  `chip-i18n` also takes a command rather than only flags: `sync` is the one command,
+  `--help` prints usage, an unknown command exits 2, and a bare invocation still means
+  `sync` for a script that predates the name.
+

package/README.md

@@ -1,3 +1,65 @@
-# Temporary Holding Version
+# @chipmobilesdk/rn-i18n-tooling
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The `chip-i18n` CLI: it scans a React Native app's source for translation keys and
+synchronises the app's locale JSON files against what it finds.
+
+- **Node, not React Native.** Nothing here runs on a device, and the package is a
+  `devDependency` of the app. The runtime library is
+  [`@chipmobilesdk/rn-i18n`](../rn-i18n/README.md).
+- **Ships JavaScript.** The tarball carries `lib/` built from TypeScript plus the
+  `bin/chip-i18n.mjs` entry. This package exists because the tooling used to ship as
+  `.ts` source inside the runtime tarball, where the documented command — `node
+  --experimental-strip-types node_modules/@chipmobilesdk/rn-i18n/src/tooling/cli.ts` —
+  worked in this monorepo and nowhere else (I18N-01, DEP-02).
+- **Public package.** Published under the `@chipmobilesdk` npm organization. The
+  license is `UNLICENSED`: the code is readable on npm, but
+  no open-source license is granted.
+- **Version**: see [CHANGELOG](CHANGELOG.md)
+
+## Install
+
+```sh
+npm i -D @chipmobilesdk/rn-i18n-tooling
+```
+
+Node `>=22.13.0`.
+
+## Use
+
+```sh
+npx chip-i18n sync                              # i18n-sync.config.json
+npx chip-i18n sync --config other.config.json
+npx chip-i18n --help
+```
+
+The configuration file, the key patterns, the runtime-only key policy and the generated
+typed-key contract are documented in the runtime package's README, under
+`## Extraction & synchronization CLI` — the CLI reads the same config it always did.
+
+Exit codes: `0` success or warnings, `1` blocking findings (a key with two different
+default texts, a malformed locale file), `2` invalid configuration or usage.
+
+A run that finds nothing to change **writes no file**: each locale file is compared
+with what would be written and left alone when it matches. That makes the command safe
+in a watch loop or a pre-commit hook, where rewriting identical bytes used to churn
+mtimes and show work in `git status` that had not happened.
+
+## Programmatic use
+
+The same functions are importable, for a repository that wants to drive extraction from
+its own script:
+
+```ts
+import { runSync, renderReport, scanSource } from '@chipmobilesdk/rn-i18n-tooling';
+```
+
+`runSync(rootDir, config)` returns the report and whether the generated keys file
+changed; `scanSource` is the scanner on its own. Both are the ones the CLI uses.
+
+## Repository layout
+
+| | |
+|---|---|
+| `src/` | TypeScript sources; `cli.ts` is the command |
+| `lib/` | build output (`npm run build`), git-ignored, published |
+| `bin/chip-i18n.mjs` | the published binary, a wrapper over `lib/cli.js` |

package/bin/chip-i18n.mjs

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+// The published entry point for `npx chip-i18n`. It is a hand-written wrapper
+// rather than the built `lib/cli.js` directly: a shebang in a TypeScript source
+// file is at the mercy of the emitter, and this file is also where the error for
+// "installed but never built" belongs.
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+const cli = new URL('../lib/cli.js', import.meta.url);
+if (!existsSync(fileURLToPath(cli))) {
+	console.error(
+		'[chip-i18n] This package was installed without its build output. Reinstall it from npm, or run `npm run build` in packages/rn-i18n-tooling.',
+	);
+	process.exitCode = 2;
+} else {
+	await import(cli.href);
+}

package/lib/cli.d.ts

@@ -0,0 +1,5 @@
+export declare function parseArgs(argv: readonly string[]): {
+    command: string;
+    configPath: string;
+};
+//# sourceMappingURL=cli.d.ts.map

package/lib/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAuBA,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAiB1F"}

package/lib/cli.js

@@ -0,0 +1,91 @@
+/**
+ * The `chip-i18n` CLI: extracts translation keys from an app's source and
+ * synchronises its locale files.
+ *
+ *   npx chip-i18n sync                              # i18n-sync.config.json
+ *   npx chip-i18n sync --config other.config.json
+ *
+ * Exit codes: 0 success or warnings, 1 blocking findings (conflicts or
+ * malformed locale files), 2 invalid configuration, bad usage or internal error.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import { renderReport } from "./report.js";
+import { SyncConfigError, runSync } from "./runner.js";
+const USAGE = `Usage: chip-i18n sync [--config <path>]
+
+  sync   Scan the configured source globs, update the locale files and report.
+         --config defaults to i18n-sync.config.json, resolved from the current
+         working directory.`;
+export function parseArgs(argv) {
+    let configPath = 'i18n-sync.config.json';
+    // No command at all means `sync`: that is what the one command was before this
+    // CLI had a name, and an app's npm script may still invoke it that way.
+    let command = 'sync';
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = argv[index];
+        if (argument === '--config' && argv[index + 1]) {
+            configPath = argv[index + 1];
+            index += 1;
+        }
+        else if (argument === '--help' || argument === '-h') {
+            command = 'help';
+        }
+        else if (index === 0 && !argument.startsWith('-')) {
+            command = argument;
+        }
+    }
+    return { command, configPath };
+}
+async function main() {
+    const rootDir = process.cwd();
+    const { command, configPath } = parseArgs(process.argv.slice(2));
+    if (command === 'help') {
+        console.log(USAGE);
+        return 0;
+    }
+    if (command !== 'sync') {
+        console.error(`[chip-i18n] Unknown command: ${command}\n\n${USAGE}`);
+        return 2;
+    }
+    const absoluteConfigPath = path.resolve(rootDir, configPath);
+    if (!fs.existsSync(absoluteConfigPath)) {
+        console.error(`[chip-i18n] Sync configuration not found: ${configPath}`);
+        return 2;
+    }
+    let config;
+    try {
+        config = JSON.parse(fs.readFileSync(absoluteConfigPath, 'utf8'));
+    }
+    catch (error) {
+        console.error(`[chip-i18n] Sync configuration is not valid JSON: ${String(error)}`);
+        return 2;
+    }
+    try {
+        const { report, generatedKeysChanged } = await runSync(rootDir, config);
+        console.log(renderReport(report));
+        if (config.generateKeysFile) {
+            console.log(generatedKeysChanged
+                ? `Typed keys regenerated: ${config.generateKeysFile}`
+                : `Typed keys unchanged: ${config.generateKeysFile}`);
+        }
+        return report.outcome === 'failed' ? 1 : 0;
+    }
+    catch (error) {
+        if (error instanceof SyncConfigError) {
+            console.error(`[chip-i18n] ${error.message}`);
+        }
+        else {
+            console.error(`[chip-i18n] Sync failed: ${String(error)}`);
+        }
+        return 2;
+    }
+}
+main().then(code => {
+    process.exitCode = code;
+}, error => {
+    console.error(`[chip-i18n] Unexpected failure: ${String(error)}`);
+    process.exitCode = 2;
+});
+//# sourceMappingURL=cli.js.map

package/lib/cli.js.map

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

package/lib/generateKeys.d.ts

@@ -0,0 +1,14 @@
+import type { RuntimeEntryConfig, TranslationTemplate } from './types.ts';
+/**
+ * Renders the typed key contract: the union of scanned template keys and
+ * declared runtime-only keys (FR-041). Apps bind lookups to the generated
+ * type so `tsc --noEmit` reports invalid or stale key usage before release.
+ */
+export declare function renderKeysModule(template: TranslationTemplate, runtimeEntries: readonly RuntimeEntryConfig[], typeName?: string): string;
+export interface GenerateKeysResult {
+    filePath: string;
+    changed: boolean;
+}
+/** Writes the typed key artifact and reports whether it changed (staleness). */
+export declare function generateKeysFile(rootDir: string, relativePath: string, template: TranslationTemplate, runtimeEntries: readonly RuntimeEntryConfig[], typeName?: string): GenerateKeysResult;
+//# sourceMappingURL=generateKeys.d.ts.map

package/lib/generateKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateKeys.d.ts","sourceRoot":"","sources":["../src/generateKeys.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE1E;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,mBAAmB,EAC7B,cAAc,EAAE,SAAS,kBAAkB,EAAE,EAC7C,QAAQ,SAAe,GACrB,MAAM,CA4BR;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,mBAAmB,EAC7B,cAAc,EAAE,SAAS,kBAAkB,EAAE,EAC7C,QAAQ,CAAC,EAAE,MAAM,GACf,kBAAkB,CAepB"}

package/lib/generateKeys.js

@@ -0,0 +1,51 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Renders the typed key contract: the union of scanned template keys and
+ * declared runtime-only keys (FR-041). Apps bind lookups to the generated
+ * type so `tsc --noEmit` reports invalid or stale key usage before release.
+ */
+export function renderKeysModule(template, runtimeEntries, typeName = 'AppI18nKey') {
+    const templateKeys = template.keys.map(key => key.key).sort((a, b) => a.localeCompare(b, 'en'));
+    const runtimeKeys = runtimeEntries
+        .map(entry => entry.key)
+        .sort((a, b) => a.localeCompare(b, 'en'));
+    // Escaped, not interpolated: a key holding an apostrophe or a backslash wrote
+    // a file that did not parse, and `tsc` then failed for the whole app (I18N-20).
+    const literal = (key) => `'${key.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
+    const renderList = (keys) => keys.length === 0 ? '[]' : `[\n${keys.map(key => `\t${literal(key)},`).join('\n')}\n]`;
+    return [
+        '// AUTO-GENERATED by @chipmobilesdk/rn-i18n tooling. Do not edit by hand.',
+        '// Regenerate with: npm run i18n:sync',
+        '',
+        `export const I18N_TEMPLATE_KEYS = ${renderList(templateKeys)} as const;`,
+        '',
+        `export const I18N_RUNTIME_ONLY_KEYS = ${renderList(runtimeKeys)} as const;`,
+        '',
+        'export const I18N_KEYS = [',
+        '\t...I18N_TEMPLATE_KEYS,',
+        '\t...I18N_RUNTIME_ONLY_KEYS,',
+        '] as const;',
+        '',
+        `export type ${typeName} = (typeof I18N_KEYS)[number];`,
+        '',
+    ].join('\n');
+}
+/** Writes the typed key artifact and reports whether it changed (staleness). */
+export function generateKeysFile(rootDir, relativePath, template, runtimeEntries, typeName) {
+    const filePath = path.join(rootDir, relativePath);
+    const content = renderKeysModule(template, runtimeEntries, typeName);
+    // Line endings normalised before comparing, which is how git sees the file: a
+    // Windows checkout materialises CRLF, and rewriting it in LF to "fix" that is
+    // churn, not work. The file keeps its endings while the content matches.
+    const previous = fs.existsSync(filePath)
+        ? fs.readFileSync(filePath, 'utf8').replace(/\r\n/g, '\n')
+        : undefined;
+    const changed = previous !== content;
+    if (changed) {
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.writeFileSync(filePath, content, 'utf8');
+    }
+    return { filePath, changed };
+}
+//# sourceMappingURL=generateKeys.js.map

package/lib/generateKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateKeys.js","sourceRoot":"","sources":["../src/generateKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC/B,QAA6B,EAC7B,cAA6C,EAC7C,QAAQ,GAAG,YAAY;IAEvB,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAChG,MAAM,WAAW,GAAG,cAAc;SAChC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;SACvB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAE3C,8EAA8E;IAC9E,gFAAgF;IAChF,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;IACxF,MAAM,UAAU,GAAG,CAAC,IAAuB,EAAE,EAAE,CAC9C,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;IAExF,OAAO;QACN,2EAA2E;QAC3E,uCAAuC;QACvC,EAAE;QACF,qCAAqC,UAAU,CAAC,YAAY,CAAC,YAAY;QACzE,EAAE;QACF,yCAAyC,UAAU,CAAC,WAAW,CAAC,YAAY;QAC5E,EAAE;QACF,4BAA4B;QAC5B,0BAA0B;QAC1B,8BAA8B;QAC9B,aAAa;QACb,EAAE;QACF,eAAe,QAAQ,gCAAgC;QACvD,EAAE;KACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAOD,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAC/B,OAAe,EACf,YAAoB,EACpB,QAA6B,EAC7B,cAA6C,EAC7C,QAAiB;IAEjB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;IACrE,8EAA8E;IAC9E,8EAA8E;IAC9E,yEAAyE;IACzE,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QACvC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;QAC1D,CAAC,CAAC,SAAS,CAAC;IACb,MAAM,OAAO,GAAG,QAAQ,KAAK,OAAO,CAAC;IACrC,IAAI,OAAO,EAAE,CAAC;QACb,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Programmatic surface of `@chipmobilesdk/rn-i18n-tooling`: the extraction and
+ * synchronization the `chip-i18n` command performs, for a repository that drives
+ * it from its own script. Node only — nothing here may be imported from React
+ * Native code, which is why it is a package of its own rather than a subpath of
+ * the runtime library (LIB-003, WS4-03).
+ */
+export { globToRegExp, listSourceFiles, scanSource } from './scan.ts';
+export { flattenTranslations, nestTranslations, syncLocaleFiles } from './sync.ts';
+export { buildReport, renderReport } from './report.ts';
+export { generateKeysFile, renderKeysModule } from './generateKeys.ts';
+export type { GenerateKeysResult } from './generateKeys.ts';
+export { SyncConfigError, loadRuntimeEntries, runSync, validateSyncConfig } from './runner.ts';
+export type { SyncRunResult } from './runner.ts';
+export type { AmbiguousUsage, ExtractionReport, KeyConflict, LocaleSyncResult, PatternConfig, ReportOutcome, RuntimeEntryConfig, SourceLocation, SyncConfig, TemplateKey, TranslationTemplate, } from './types.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC/F,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EACX,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,WAAW,EACX,mBAAmB,GACnB,MAAM,YAAY,CAAC"}

package/lib/index.js

@@ -0,0 +1,13 @@
+/**
+ * Programmatic surface of `@chipmobilesdk/rn-i18n-tooling`: the extraction and
+ * synchronization the `chip-i18n` command performs, for a repository that drives
+ * it from its own script. Node only — nothing here may be imported from React
+ * Native code, which is why it is a package of its own rather than a subpath of
+ * the runtime library (LIB-003, WS4-03).
+ */
+export { globToRegExp, listSourceFiles, scanSource } from "./scan.js";
+export { flattenTranslations, nestTranslations, syncLocaleFiles } from "./sync.js";
+export { buildReport, renderReport } from "./report.js";
+export { generateKeysFile, renderKeysModule } from "./generateKeys.js";
+export { SyncConfigError, loadRuntimeEntries, runSync, validateSyncConfig } from "./runner.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/lib/report.d.ts

@@ -0,0 +1,10 @@
+import type { ExtractionReport, LocaleSyncResult, RuntimeEntryConfig, TranslationTemplate } from './types.ts';
+/**
+ * Assembles the extraction/synchronization report distinguishing scanned
+ * template keys, runtime-only keys, stale removals, ambiguous usages, and
+ * conflicts (FR-026, FR-036).
+ */
+export declare function buildReport(template: TranslationTemplate, syncResults: readonly LocaleSyncResult[], runtimeEntries: readonly RuntimeEntryConfig[]): ExtractionReport;
+/** Renders the report as readable text for CLI output. */
+export declare function renderReport(report: ExtractionReport): string;
+//# sourceMappingURL=report.d.ts.map

package/lib/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAChB,gBAAgB,EAEhB,kBAAkB,EAClB,mBAAmB,EACnB,MAAM,YAAY,CAAC;AAapB;;;;GAIG;AACH,wBAAgB,WAAW,CAC1B,QAAQ,EAAE,mBAAmB,EAC7B,WAAW,EAAE,SAAS,gBAAgB,EAAE,EACxC,cAAc,EAAE,SAAS,kBAAkB,EAAE,GAC3C,gBAAgB,CA2ClB;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAwC7D"}

package/lib/report.js

@@ -0,0 +1,89 @@
+function perLocale(results, select) {
+    const record = {};
+    for (const result of results) {
+        record[result.locale] = select(result);
+    }
+    return record;
+}
+/**
+ * Assembles the extraction/synchronization report distinguishing scanned
+ * template keys, runtime-only keys, stale removals, ambiguous usages, and
+ * conflicts (FR-026, FR-036).
+ */
+export function buildReport(template, syncResults, runtimeEntries) {
+    const errors = syncResults.filter(result => result.error).map(result => result.error);
+    let outcome = 'success';
+    if (template.ambiguous.length > 0 ||
+        syncResults.some(result => result.addedKeys.length > 0 || result.runtimeReported.length > 0)) {
+        outcome = 'completedWithWarnings';
+    }
+    if (errors.length > 0 || template.conflicts.length > 0) {
+        outcome = 'failed';
+    }
+    return {
+        outcome,
+        discovered: template.keys.map(key => ({
+            key: key.key,
+            defaultText: key.defaultText,
+            locations: key.locations.map(location => `${location.file}:${location.line}`),
+        })),
+        createdLocaleFiles: syncResults
+            .filter(result => result.created && !result.error)
+            .map(result => ({ locale: result.locale, filePath: result.filePath })),
+        writtenLocaleFiles: syncResults.filter(result => result.written).map(result => result.locale),
+        addedKeys: perLocale(syncResults, result => result.addedKeys),
+        preservedKeys: perLocale(syncResults, result => result.preservedKeys),
+        removedStaleKeys: perLocale(syncResults, result => result.removedKeys),
+        missingPerLocale: perLocale(syncResults, result => [...result.addedKeys, ...result.runtimeAdded, ...result.runtimeReported].sort((a, b) => a.localeCompare(b, 'en'))),
+        runtimeOnly: {
+            declared: runtimeEntries.map(entry => entry.key),
+            preserved: perLocale(syncResults, result => result.runtimePreserved),
+            added: perLocale(syncResults, result => result.runtimeAdded),
+            reported: perLocale(syncResults, result => result.runtimeReported),
+        },
+        ambiguous: template.ambiguous,
+        conflicts: template.conflicts,
+        errors,
+    };
+}
+/** Renders the report as readable text for CLI output. */
+export function renderReport(report) {
+    const lines = [];
+    lines.push(`i18n sync outcome: ${report.outcome}`);
+    lines.push(`Discovered keys: ${report.discovered.length}`);
+    lines.push(report.writtenLocaleFiles.length === 0
+        ? 'Locale files: unchanged, nothing written'
+        : `Locale files written: ${report.writtenLocaleFiles.join(', ')}`);
+    for (const created of report.createdLocaleFiles) {
+        lines.push(`Created locale file: ${created.locale} -> ${created.filePath}`);
+    }
+    for (const [locale, keys] of Object.entries(report.addedKeys)) {
+        if (keys.length > 0) {
+            lines.push(`Added [${locale}]: ${keys.join(', ')}`);
+        }
+    }
+    for (const [locale, keys] of Object.entries(report.removedStaleKeys)) {
+        if (keys.length > 0) {
+            lines.push(`Removed stale [${locale}]: ${keys.join(', ')}`);
+        }
+    }
+    for (const [locale, keys] of Object.entries(report.runtimeOnly.reported)) {
+        if (keys.length > 0) {
+            lines.push(`Runtime-only missing [${locale}]: ${keys.join(', ')}`);
+        }
+    }
+    for (const usage of report.ambiguous) {
+        lines.push(`Ambiguous usage at ${usage.file}:${usage.line}: ${usage.snippet}`);
+    }
+    for (const conflict of report.conflicts) {
+        const sources = conflict.values
+            .map(value => `"${value.text}" (${value.location.file}:${value.location.line})`)
+            .join(' vs ');
+        lines.push(`Conflict for key "${conflict.key}": ${sources}`);
+    }
+    for (const error of report.errors) {
+        lines.push(`Error: ${error}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=report.js.map

package/lib/report.js.map

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

package/lib/runner.d.ts

@@ -0,0 +1,21 @@
+import type { ExtractionReport, RuntimeEntryConfig, SyncConfig } from './types.ts';
+export declare class SyncConfigError extends Error {
+    constructor(message: string);
+}
+export declare function validateSyncConfig(config: SyncConfig): void;
+/**
+ * Loads declared runtime-only entries from the configured module. Accepts a
+ * default export or a named `runtimeEntries` export. The module must use
+ * type-only imports so it can run under Node's TypeScript type stripping.
+ */
+export declare function loadRuntimeEntries(rootDir: string, runtimeEntriesFile: string | undefined): Promise<RuntimeEntryConfig[]>;
+export interface SyncRunResult {
+    report: ExtractionReport;
+    generatedKeysChanged: boolean;
+}
+/**
+ * Full pipeline: scan the source tree, synchronize every locale JSON file,
+ * regenerate the typed key artifact, and assemble the report.
+ */
+export declare function runSync(rootDir: string, config: SyncConfig, runtimeEntriesOverride?: readonly RuntimeEntryConfig[]): Promise<SyncRunResult>;
+//# sourceMappingURL=runner.d.ts.map

package/lib/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEnF,qBAAa,eAAgB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI3B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAuB3D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,MAAM,EACf,kBAAkB,EAAE,MAAM,GAAG,SAAS,GACpC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAmB/B;AAED,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,gBAAgB,CAAC;IACzB,oBAAoB,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,EAClB,sBAAsB,CAAC,EAAE,SAAS,kBAAkB,EAAE,GACpD,OAAO,CAAC,aAAa,CAAC,CA2BxB"}

package/lib/runner.js

@@ -0,0 +1,88 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import fs from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { scanSource } from "./scan.js";
+import { syncLocaleFiles } from "./sync.js";
+import { buildReport } from "./report.js";
+import { generateKeysFile } from "./generateKeys.js";
+export class SyncConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SyncConfigError';
+    }
+}
+export function validateSyncConfig(config) {
+    const issues = [];
+    if (!Array.isArray(config.sourceGlobs) || config.sourceGlobs.length === 0) {
+        issues.push('`sourceGlobs` must list at least one glob.');
+    }
+    if (!Array.isArray(config.patterns) || config.patterns.length === 0) {
+        issues.push('`patterns` must list at least one regex pattern.');
+    }
+    else {
+        for (const pattern of config.patterns) {
+            if (!pattern.regex?.includes('(?<key>')) {
+                issues.push(`Pattern "${pattern.regex}" must contain a named (?<key>...) capture group.`);
+            }
+        }
+    }
+    if (!config.localesDir) {
+        issues.push('`localesDir` is required.');
+    }
+    if (!Array.isArray(config.locales) || config.locales.length === 0) {
+        issues.push('`locales` must list every supported locale.');
+    }
+    if (issues.length > 0) {
+        throw new SyncConfigError(`Invalid i18n sync configuration:\n- ${issues.join('\n- ')}`);
+    }
+}
+/**
+ * Loads declared runtime-only entries from the configured module. Accepts a
+ * default export or a named `runtimeEntries` export. The module must use
+ * type-only imports so it can run under Node's TypeScript type stripping.
+ */
+export async function loadRuntimeEntries(rootDir, runtimeEntriesFile) {
+    if (!runtimeEntriesFile) {
+        return [];
+    }
+    const absolutePath = path.resolve(rootDir, runtimeEntriesFile);
+    if (!fs.existsSync(absolutePath)) {
+        throw new SyncConfigError(`Runtime entries file not found: ${runtimeEntriesFile}`);
+    }
+    const module = (await import(__rewriteRelativeImportExtension(pathToFileURL(absolutePath).href)));
+    const entries = module.default ?? module.runtimeEntries;
+    if (!Array.isArray(entries)) {
+        throw new SyncConfigError(`Runtime entries file must export an entry array (default or \`runtimeEntries\`): ${runtimeEntriesFile}`);
+    }
+    return entries;
+}
+/**
+ * Full pipeline: scan the source tree, synchronize every locale JSON file,
+ * regenerate the typed key artifact, and assemble the report.
+ */
+export async function runSync(rootDir, config, runtimeEntriesOverride) {
+    validateSyncConfig(config);
+    const runtimeEntries = runtimeEntriesOverride ?? (await loadRuntimeEntries(rootDir, config.runtimeEntriesFile));
+    const template = scanSource(rootDir, config.sourceGlobs, config.patterns);
+    const syncResults = syncLocaleFiles(rootDir, config, template, runtimeEntries);
+    const report = buildReport(template, syncResults, runtimeEntries);
+    let generatedKeysChanged = false;
+    if (config.generateKeysFile) {
+        generatedKeysChanged = generateKeysFile(rootDir, config.generateKeysFile, template, runtimeEntries, config.keysTypeName).changed;
+    }
+    if (config.reportPath) {
+        const reportPath = path.resolve(rootDir, config.reportPath);
+        fs.mkdirSync(path.dirname(reportPath), { recursive: true });
+        fs.writeFileSync(reportPath, `${JSON.stringify(report, null, '\t')}\n`, 'utf8');
+    }
+    return { report, generatedKeysChanged };
+}
+//# sourceMappingURL=runner.js.map

package/lib/runner.js.map

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