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

package/lib/scan.d.ts

@@ -0,0 +1,22 @@
+import type { PatternConfig, TranslationTemplate } from './types.ts';
+/** Converts a glob (`**`, `*`, `?`, `{a,b}`) to an anchored RegExp. */
+export declare function globToRegExp(glob: string): RegExp;
+/**
+ * The deepest directory a glob can only match inside: everything before its
+ * first wildcard, truncated to a directory boundary. `src/screens/**\/*.tsx`
+ * gives `src/screens`, so the walk never leaves it — scanning started at the
+ * project root and threw away almost everything it read, which on a React
+ * Native checkout means `android/`, `ios/` and every build directory inside
+ * them (I18N-15).
+ */
+export declare function globBaseDir(glob: string): string;
+/** Lists project-relative source files matching the configured globs. */
+export declare function listSourceFiles(rootDir: string, sourceGlobs: readonly string[]): string[];
+/**
+ * Scans the source tree with the app-configured i18n usage regex patterns and
+ * builds the source-of-truth translation template: discovered keys with
+ * default text and `file:line` locations, ambiguous dynamic usages, and
+ * conflicting duplicate keys (FR-024…FR-026, FR-031).
+ */
+export declare function scanSource(rootDir: string, sourceGlobs: readonly string[], patterns: readonly PatternConfig[]): TranslationTemplate;
+//# sourceMappingURL=scan.d.ts.map

package/lib/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGX,aAAa,EAGb,mBAAmB,EACnB,MAAM,YAAY,CAAC;AAIpB,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsCjD;AAgBD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAqBzF;AAuDD;;;;;GAKG;AACH,wBAAgB,UAAU,CACzB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,QAAQ,EAAE,SAAS,aAAa,EAAE,GAChC,mBAAmB,CAgFrB"}

package/lib/scan.js

@@ -0,0 +1,227 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const IGNORED_DIRECTORIES = new Set(['node_modules', '.git', 'build', 'dist', 'Pods']);
+/** Converts a glob (`**`, `*`, `?`, `{a,b}`) to an anchored RegExp. */
+export function globToRegExp(glob) {
+    let source = '';
+    let index = 0;
+    while (index < glob.length) {
+        const char = glob[index];
+        if (char === '*') {
+            if (glob[index + 1] === '*') {
+                // `**/` matches zero or more directories; trailing `**` matches all.
+                if (glob[index + 2] === '/') {
+                    source += '(?:.*/)?';
+                    index += 3;
+                }
+                else {
+                    source += '.*';
+                    index += 2;
+                }
+                continue;
+            }
+            source += '[^/]*';
+        }
+        else if (char === '?') {
+            source += '[^/]';
+        }
+        else if (char === '{') {
+            const end = glob.indexOf('}', index);
+            if (end === -1) {
+                source += '\\{';
+            }
+            else {
+                const alternatives = glob
+                    .slice(index + 1, end)
+                    .split(',')
+                    .map(alternative => alternative.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+                source += `(?:${alternatives.join('|')})`;
+                index = end;
+            }
+        }
+        else {
+            source += char.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        }
+        index += 1;
+    }
+    return new RegExp(`^${source}$`);
+}
+function walkDirectory(rootDir, current, files) {
+    for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+        if (entry.isDirectory()) {
+            if (!IGNORED_DIRECTORIES.has(entry.name)) {
+                walkDirectory(rootDir, path.join(current, entry.name), files);
+            }
+            continue;
+        }
+        if (entry.isFile()) {
+            files.push(path.relative(rootDir, path.join(current, entry.name)).replace(/\\/g, '/'));
+        }
+    }
+}
+/**
+ * The deepest directory a glob can only match inside: everything before its
+ * first wildcard, truncated to a directory boundary. `src/screens/**\/*.tsx`
+ * gives `src/screens`, so the walk never leaves it — scanning started at the
+ * project root and threw away almost everything it read, which on a React
+ * Native checkout means `android/`, `ios/` and every build directory inside
+ * them (I18N-15).
+ */
+export function globBaseDir(glob) {
+    const wildcard = glob.search(/[*?{[]/);
+    const literal = wildcard === -1 ? glob : glob.slice(0, wildcard);
+    const cut = literal.lastIndexOf('/');
+    return cut === -1 ? '' : literal.slice(0, cut);
+}
+/** Lists project-relative source files matching the configured globs. */
+export function listSourceFiles(rootDir, sourceGlobs) {
+    const found = new Set();
+    // One walk per distinct base directory, not per glob: two globs under the same
+    // directory would otherwise read it twice.
+    const bases = new Map();
+    for (const glob of sourceGlobs) {
+        const base = globBaseDir(glob);
+        const matchers = bases.get(base) ?? [];
+        matchers.push(globToRegExp(glob));
+        bases.set(base, matchers);
+    }
+    for (const [base, matchers] of bases) {
+        const directory = base === '' ? rootDir : path.join(rootDir, base);
+        if (!fs.existsSync(directory))
+            continue;
+        const files = [];
+        walkDirectory(rootDir, directory, files);
+        for (const file of files) {
+            if (matchers.some(matcher => matcher.test(file)))
+                found.add(file);
+        }
+    }
+    return [...found].sort();
+}
+/**
+ * Offsets of the start of every line, so a match offset becomes a line number in
+ * a binary search rather than a scan from the top of the file. Counting newlines
+ * per match made a file with many keys quadratic in its own length.
+ */
+function lineStartsOf(text) {
+    const starts = [0];
+    for (let position = text.indexOf('\n'); position !== -1; position = text.indexOf('\n', position + 1)) {
+        starts.push(position + 1);
+    }
+    return starts;
+}
+/** 1-based line number of `index`, by binary search over `lineStarts`. */
+function lineOfIndex(lineStarts, index) {
+    let low = 0;
+    let high = lineStarts.length - 1;
+    while (low < high) {
+        const middle = Math.floor((low + high + 1) / 2);
+        if (lineStarts[middle] <= index)
+            low = middle;
+        else
+            high = middle - 1;
+    }
+    return low + 1;
+}
+/** The text of a 1-based line, without its terminator. */
+function lineText(text, lineStarts, line) {
+    const start = lineStarts[line - 1] ?? 0;
+    const end = lineStarts[line] ?? text.length + 1;
+    return text.slice(start, Math.max(start, end - 1));
+}
+function compilePatterns(patterns) {
+    return patterns.map(pattern => {
+        const flags = [...new Set(`g${pattern.flags ?? ''}`)].join('');
+        return {
+            keyRegex: new RegExp(pattern.regex, flags),
+            ambiguousRegex: pattern.ambiguousRegex
+                ? new RegExp(pattern.ambiguousRegex, flags)
+                : undefined,
+        };
+    });
+}
+/**
+ * Scans the source tree with the app-configured i18n usage regex patterns and
+ * builds the source-of-truth translation template: discovered keys with
+ * default text and `file:line` locations, ambiguous dynamic usages, and
+ * conflicting duplicate keys (FR-024…FR-026, FR-031).
+ */
+export function scanSource(rootDir, sourceGlobs, patterns) {
+    const compiled = compilePatterns(patterns);
+    const files = listSourceFiles(rootDir, sourceGlobs);
+    const keys = new Map();
+    const valuesByKey = new Map();
+    const ambiguous = [];
+    for (const file of files) {
+        const text = fs.readFileSync(path.join(rootDir, file), 'utf8');
+        const lineStarts = lineStartsOf(text);
+        const matchedSpans = [];
+        for (const pattern of compiled) {
+            pattern.keyRegex.lastIndex = 0;
+            for (const match of text.matchAll(pattern.keyRegex)) {
+                const key = match.groups?.key;
+                if (!key) {
+                    continue;
+                }
+                const startIndex = match.index ?? 0;
+                matchedSpans.push([startIndex, startIndex + match[0].length]);
+                const location = {
+                    file,
+                    line: lineOfIndex(lineStarts, startIndex),
+                };
+                const existing = keys.get(key);
+                if (existing) {
+                    existing.locations.push(location);
+                }
+                else {
+                    keys.set(key, { key, locations: [location] });
+                }
+                const defaultText = match.groups?.defaultText;
+                if (defaultText !== undefined) {
+                    const values = valuesByKey.get(key) ?? [];
+                    values.push({ text: defaultText, location });
+                    valuesByKey.set(key, values);
+                }
+            }
+        }
+        for (const pattern of compiled) {
+            if (!pattern.ambiguousRegex) {
+                continue;
+            }
+            pattern.ambiguousRegex.lastIndex = 0;
+            for (const match of text.matchAll(pattern.ambiguousRegex)) {
+                const start = match.index ?? 0;
+                const overlapsKeyMatch = matchedSpans.some(([from, to]) => start >= from && start < to);
+                if (overlapsKeyMatch) {
+                    continue;
+                }
+                const lineNumber = lineOfIndex(lineStarts, start);
+                ambiguous.push({
+                    file,
+                    line: lineNumber,
+                    snippet: lineText(text, lineStarts, lineNumber).trim() || match[0],
+                });
+            }
+        }
+    }
+    const conflicts = [];
+    for (const [key, values] of valuesByKey) {
+        const distinct = [...new Set(values.map(value => value.text))];
+        if (distinct.length > 1) {
+            conflicts.push({ key, values });
+        }
+        else {
+            const templateKey = keys.get(key);
+            if (templateKey) {
+                templateKey.defaultText = values[0].text;
+            }
+        }
+    }
+    return {
+        keys: [...keys.values()].sort((a, b) => a.key.localeCompare(b.key)),
+        ambiguous,
+        conflicts: conflicts.sort((a, b) => a.key.localeCompare(b.key)),
+        scannedFiles: files.length,
+    };
+}
+//# sourceMappingURL=scan.js.map

package/lib/scan.js.map

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

package/lib/sync.d.ts

@@ -0,0 +1,18 @@
+import type { LocaleSyncResult, RuntimeEntryConfig, SyncConfig, TranslationTemplate } from './types.ts';
+type JsonValue = string | {
+    [key: string]: JsonValue;
+};
+/** Flattens nested locale JSON into dot-path keys with leaf values. */
+export declare function flattenTranslations(node: JsonValue, prefix?: string, into?: Map<string, JsonValue>): Map<string, JsonValue>;
+/** Rebuilds the nested JSON object with deterministically sorted keys. */
+export declare function nestTranslations(flat: Map<string, JsonValue>): JsonValue;
+/**
+ * Synchronizes every configured locale JSON file against the scanned
+ * template: creates missing files, adds missing keys with the configured
+ * placeholder, preserves existing translations verbatim, removes stale keys,
+ * and protects declared runtime-only entries (FR-027…FR-030, FR-034/FR-035).
+ * Conflicted keys are never added or overwritten while the conflict is open.
+ */
+export declare function syncLocaleFiles(rootDir: string, config: SyncConfig, template: TranslationTemplate, runtimeEntries: readonly RuntimeEntryConfig[]): LocaleSyncResult[];
+export {};
+//# sourceMappingURL=sync.d.ts.map

package/lib/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACnB,MAAM,YAAY,CAAC;AAEpB,KAAK,SAAS,GAAG,MAAM,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAoBvD,uEAAuE;AACvE,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,SAAS,EACf,MAAM,SAAK,EACX,IAAI,GAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAa,GACtC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CASxB;AAaD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAiBxE;AAuCD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,mBAAmB,EAC7B,cAAc,EAAE,SAAS,kBAAkB,EAAE,GAC3C,gBAAgB,EAAE,CAiFpB"}

package/lib/sync.js

@@ -0,0 +1,173 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const PLURAL_CATEGORIES = new Set(['zero', 'one', 'two', 'few', 'many', 'other']);
+/**
+ * Mirrors the runtime plural-group leaf rule (translation/plurals.ts) so a
+ * plural variant object is synchronized as one key, not per category.
+ */
+function isPluralGroupValue(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const keys = Object.keys(value);
+    return (keys.length > 0 &&
+        'other' in value &&
+        keys.every(key => PLURAL_CATEGORIES.has(key) && typeof value[key] === 'string'));
+}
+/** Flattens nested locale JSON into dot-path keys with leaf values. */
+export function flattenTranslations(node, prefix = '', into = new Map()) {
+    if (typeof node === 'string' || isPluralGroupValue(node)) {
+        into.set(prefix, node);
+        return into;
+    }
+    for (const [key, value] of Object.entries(node)) {
+        flattenTranslations(value, prefix ? `${prefix}.${key}` : key, into);
+    }
+    return into;
+}
+function sortValue(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    const sorted = {};
+    for (const key of Object.keys(value).sort((a, b) => a.localeCompare(b, 'en'))) {
+        sorted[key] = sortValue(value[key]);
+    }
+    return sorted;
+}
+/** Rebuilds the nested JSON object with deterministically sorted keys. */
+export function nestTranslations(flat) {
+    const root = {};
+    const sortedKeys = [...flat.keys()].sort((a, b) => a.localeCompare(b, 'en'));
+    for (const flatKey of sortedKeys) {
+        const segments = flatKey.split('.');
+        let node = root;
+        for (let index = 0; index < segments.length - 1; index += 1) {
+            const segment = segments[index];
+            const next = node[segment];
+            if (typeof next !== 'object' || next === null || isPluralGroupValue(next)) {
+                node[segment] = {};
+            }
+            node = node[segment];
+        }
+        node[segments[segments.length - 1]] = sortValue(flat.get(flatKey));
+    }
+    return root;
+}
+function placeholderValue(config, locale, key, defaultText) {
+    const placeholder = config.placeholder ?? 'template';
+    if (placeholder === 'template') {
+        return defaultText ?? key;
+    }
+    if (typeof placeholder === 'string') {
+        return placeholder;
+    }
+    return placeholder[locale] ?? defaultText ?? key;
+}
+/** Writes the file unless it already holds exactly this; returns whether it wrote. */
+function writeLocaleFile(filePath, content) {
+    const json = `${JSON.stringify(content, null, '\t')}\n`;
+    if (fs.existsSync(filePath)) {
+        try {
+            // Compared with line endings normalised, which is how git sees the file: a
+            // Windows checkout materialises CRLF, and rewriting every locale file in LF
+            // to "fix" that is exactly the churn this check exists to avoid. The file
+            // keeps whatever endings it has as long as the content matches.
+            if (fs.readFileSync(filePath, 'utf8').replace(/\r\n/g, '\n') === json)
+                return false;
+        }
+        catch {
+            // Unreadable: fall through and write, which is the repair.
+        }
+    }
+    // Atomic per-file write: a failed run never leaves a partial locale file.
+    const temporaryPath = `${filePath}.tmp`;
+    fs.writeFileSync(temporaryPath, json, 'utf8');
+    fs.renameSync(temporaryPath, filePath);
+    return true;
+}
+/**
+ * Synchronizes every configured locale JSON file against the scanned
+ * template: creates missing files, adds missing keys with the configured
+ * placeholder, preserves existing translations verbatim, removes stale keys,
+ * and protects declared runtime-only entries (FR-027…FR-030, FR-034/FR-035).
+ * Conflicted keys are never added or overwritten while the conflict is open.
+ */
+export function syncLocaleFiles(rootDir, config, template, runtimeEntries) {
+    const templateByKey = new Map(template.keys.map(key => [key.key, key]));
+    const conflictedKeys = new Set(template.conflicts.map(conflict => conflict.key));
+    const runtimeByKey = new Map(runtimeEntries.map(entry => [entry.key, entry]));
+    const results = [];
+    for (const locale of config.locales) {
+        const filePath = path.join(rootDir, config.localesDir, `${locale}.json`);
+        const result = {
+            locale,
+            filePath,
+            created: false,
+            addedKeys: [],
+            preservedKeys: [],
+            removedKeys: [],
+            runtimePreserved: [],
+            runtimeAdded: [],
+            runtimeReported: [],
+            written: false,
+        };
+        results.push(result);
+        let existing = new Map();
+        if (fs.existsSync(filePath)) {
+            try {
+                const parsed = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+                existing = flattenTranslations(parsed);
+            }
+            catch (error) {
+                result.error = `Malformed locale file ${locale}.json: ${String(error)}`;
+                continue;
+            }
+        }
+        else {
+            result.created = true;
+        }
+        const next = new Map();
+        for (const [key, templateKey] of templateByKey) {
+            const current = existing.get(key);
+            if (current !== undefined) {
+                next.set(key, current);
+                result.preservedKeys.push(key);
+                continue;
+            }
+            if (conflictedKeys.has(key)) {
+                // Reported for manual review; never silently added (FR-031).
+                continue;
+            }
+            next.set(key, placeholderValue(config, locale, key, templateKey.defaultText));
+            result.addedKeys.push(key);
+        }
+        for (const [key, entry] of runtimeByKey) {
+            const current = existing.get(key);
+            if (current !== undefined) {
+                next.set(key, current);
+                result.runtimePreserved.push(key);
+                continue;
+            }
+            if ((entry.policy ?? 'report') === 'add') {
+                next.set(key, placeholderValue(config, locale, key, entry.defaultText));
+                result.runtimeAdded.push(key);
+            }
+            else {
+                result.runtimeReported.push(key);
+            }
+        }
+        for (const key of existing.keys()) {
+            if (!next.has(key) && !runtimeByKey.has(key) && !conflictedKeys.has(key)) {
+                result.removedKeys.push(key);
+            }
+        }
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        result.written = writeLocaleFile(filePath, nestTranslations(next));
+        result.addedKeys.sort((a, b) => a.localeCompare(b, 'en'));
+        result.preservedKeys.sort((a, b) => a.localeCompare(b, 'en'));
+        result.removedKeys.sort((a, b) => a.localeCompare(b, 'en'));
+    }
+    return results;
+}
+//# sourceMappingURL=sync.js.map

package/lib/sync.js.map

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

package/lib/types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Shared contracts for the Node-only extraction and synchronization tooling.
+ * This module must stay free of React Native imports; it is consumed through
+ * this package's entrypoint and its `chip-i18n` command.
+ */
+export interface PatternConfig {
+    /**
+     * Regex source with a named `key` capture group for statically resolvable
+     * keys, and an optional named `defaultText` group for template values.
+     */
+    regex: string;
+    /** Extra regex flags; `g` is always applied. */
+    flags?: string;
+    /**
+     * Optional regex matching dynamic usages of the same call style. Matches
+     * that do not overlap a static key match are reported as ambiguous.
+     */
+    ambiguousRegex?: string;
+}
+export interface SyncConfig {
+    /** Globs relative to the project root, e.g. `src/**\/*.{ts,tsx}`. */
+    sourceGlobs: string[];
+    patterns: PatternConfig[];
+    /** Directory containing `<locale>.json` files. */
+    localesDir: string;
+    locales: string[];
+    /** Module exporting the declared runtime-only entries. */
+    runtimeEntriesFile?: string;
+    /**
+     * Value written for newly added keys: `template` uses the discovered
+     * default text (falling back to the key), a string is used verbatim, and
+     * a map selects per locale. Default: `template`.
+     */
+    placeholder?: 'template' | string | Record<string, string>;
+    /** Optional JSON report output path. */
+    reportPath?: string;
+    /** Generated typed key artifact path, e.g. `src/i18n/keys.generated.ts`. */
+    generateKeysFile?: string;
+    /** Exported key type name. Default: `AppI18nKey`. */
+    keysTypeName?: string;
+}
+export interface RuntimeEntryConfig {
+    key: string;
+    defaultText: string;
+    policy?: 'add' | 'report';
+    description?: string;
+}
+export interface SourceLocation {
+    file: string;
+    line: number;
+}
+export interface TemplateKey {
+    key: string;
+    defaultText?: string;
+    locations: SourceLocation[];
+}
+export interface AmbiguousUsage {
+    file: string;
+    line: number;
+    snippet: string;
+}
+export interface KeyConflict {
+    key: string;
+    values: {
+        text: string;
+        location: SourceLocation;
+    }[];
+}
+export interface TranslationTemplate {
+    /** Discovered keys sorted by key name. */
+    keys: TemplateKey[];
+    ambiguous: AmbiguousUsage[];
+    conflicts: KeyConflict[];
+    scannedFiles: number;
+}
+export interface LocaleSyncResult {
+    locale: string;
+    filePath: string;
+    created: boolean;
+    addedKeys: string[];
+    preservedKeys: string[];
+    removedKeys: string[];
+    runtimePreserved: string[];
+    runtimeAdded: string[];
+    runtimeReported: string[];
+    /**
+     * Whether the file on disk changed. A sync that finds nothing to do writes
+     * nothing: rewriting identical bytes churned every locale file's mtime, so a
+     * watcher rebuilt and `git status` showed work that had not happened.
+     */
+    written: boolean;
+    /** Set when the locale file is malformed; no write happened. */
+    error?: string;
+}
+export type ReportOutcome = 'success' | 'completedWithWarnings' | 'failed';
+export interface ExtractionReport {
+    outcome: ReportOutcome;
+    discovered: {
+        key: string;
+        defaultText?: string;
+        locations: string[];
+    }[];
+    createdLocaleFiles: {
+        locale: string;
+        filePath: string;
+    }[];
+    /** Locales whose file on disk actually changed; empty when the sync was a no-op. */
+    writtenLocaleFiles: string[];
+    addedKeys: Record<string, string[]>;
+    preservedKeys: Record<string, string[]>;
+    removedStaleKeys: Record<string, string[]>;
+    missingPerLocale: Record<string, string[]>;
+    runtimeOnly: {
+        declared: string[];
+        preserved: Record<string, string[]>;
+        added: Record<string, string[]>;
+        reported: Record<string, string[]>;
+    };
+    ambiguous: AmbiguousUsage[];
+    conflicts: KeyConflict[];
+    errors: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

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

package/lib/types.js

@@ -0,0 +1,7 @@
+/**
+ * Shared contracts for the Node-only extraction and synchronization tooling.
+ * This module must stay free of React Native imports; it is consumed through
+ * this package's entrypoint and its `chip-i18n` command.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}