@better-i18n/cli 0.1.7 → 0.2.0

package/dist/rules/health/missing-translations.js

@@ -0,0 +1,48 @@
+/**
+ * Missing Translations Rule
+ *
+ * Detects translation keys that exist in the source locale but are
+ * missing in one or more target locales. This is the most fundamental
+ * coverage check — if a key is missing, users see fallback or broken UI.
+ *
+ * Category: Coverage (highest weight in health score)
+ * Default Severity: error
+ */
+import { RULE_CATEGORY_MAP, RULE_HELP_MAP } from "../categories.js";
+const RULE_ID = "missing-translations";
+export const missingTranslationsRule = {
+    id: RULE_ID,
+    defaultSeverity: "error",
+    description: "Detect keys present in source locale but missing in target locales",
+    run(context) {
+        const { sourceLocale, targetLocales, translations } = context;
+        const sourceKeys = translations[sourceLocale];
+        if (!sourceKeys)
+            return [];
+        const diagnostics = [];
+        const sourceKeySet = Object.keys(sourceKeys);
+        for (const targetLocale of targetLocales) {
+            const targetKeys = translations[targetLocale] || {};
+            for (const key of sourceKeySet) {
+                if (!(key in targetKeys)) {
+                    const namespace = key.split(".")[0] || "default";
+                    diagnostics.push({
+                        filePath: `${targetLocale}.json`,
+                        line: 0,
+                        column: 0,
+                        rule: RULE_ID,
+                        category: RULE_CATEGORY_MAP[RULE_ID] || "Coverage",
+                        severity: this.defaultSeverity,
+                        message: `Key "${key}" is missing in locale "${targetLocale}"`,
+                        help: RULE_HELP_MAP[RULE_ID] || "",
+                        key,
+                        namespace,
+                        language: targetLocale,
+                    });
+                }
+            }
+        }
+        return diagnostics;
+    },
+};
+//# sourceMappingURL=missing-translations.js.map

package/dist/rules/health/missing-translations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-translations.js","sourceRoot":"","sources":["../../../src/rules/health/missing-translations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOpE,MAAM,OAAO,GAAG,sBAAsB,CAAC;AAEvC,MAAM,CAAC,MAAM,uBAAuB,GAAe;IACjD,EAAE,EAAE,OAAO;IACX,eAAe,EAAE,OAAO;IACxB,WAAW,EACT,oEAAoE;IAEtE,GAAG,CAAC,OAA0B;QAC5B,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;QAE9D,MAAM,UAAU,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU;YAAE,OAAO,EAAE,CAAC;QAE3B,MAAM,WAAW,GAAqB,EAAE,CAAC;QACzC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE7C,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,MAAM,UAAU,GAAG,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YAEpD,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;gBAC/B,IAAI,CAAC,CAAC,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC;oBACzB,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;oBAEjD,WAAW,CAAC,IAAI,CAAC;wBACf,QAAQ,EAAE,GAAG,YAAY,OAAO;wBAChC,IAAI,EAAE,CAAC;wBACP,MAAM,EAAE,CAAC;wBACT,IAAI,EAAE,OAAO;wBACb,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,IAAI,UAAU;wBAClD,QAAQ,EAAE,IAAI,CAAC,eAAe;wBAC9B,OAAO,EAAE,QAAQ,GAAG,2BAA2B,YAAY,GAAG;wBAC9D,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE;wBAClC,GAAG;wBACH,SAAS;wBACT,QAAQ,EAAE,YAAY;qBACvB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;CACF,CAAC"}

package/dist/rules/health/orphan-keys.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Orphan Keys Rule
+ *
+ * Detects translation keys that exist in remote translation files but
+ * are never referenced in code. These "orphan" keys increase bundle size
+ * and maintenance burden without providing value.
+ *
+ * Note: This rule requires code analysis results (codeKeys set).
+ * If codeKeys is empty, it returns no diagnostics to avoid false positives.
+ *
+ * Category: Performance
+ * Default Severity: warning
+ */
+import type { HealthRule } from "../registry.js";
+export declare const orphanKeysRule: HealthRule;
+//# sourceMappingURL=orphan-keys.d.ts.map

package/dist/rules/health/orphan-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-keys.d.ts","sourceRoot":"","sources":["../../../src/rules/health/orphan-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EACV,UAAU,EAGX,MAAM,gBAAgB,CAAC;AAIxB,eAAO,MAAM,cAAc,EAAE,UAuC5B,CAAC"}

package/dist/rules/health/orphan-keys.js

@@ -0,0 +1,50 @@
+/**
+ * Orphan Keys Rule
+ *
+ * Detects translation keys that exist in remote translation files but
+ * are never referenced in code. These "orphan" keys increase bundle size
+ * and maintenance burden without providing value.
+ *
+ * Note: This rule requires code analysis results (codeKeys set).
+ * If codeKeys is empty, it returns no diagnostics to avoid false positives.
+ *
+ * Category: Performance
+ * Default Severity: warning
+ */
+import { RULE_CATEGORY_MAP, RULE_HELP_MAP } from "../categories.js";
+const RULE_ID = "orphan-keys";
+export const orphanKeysRule = {
+    id: RULE_ID,
+    defaultSeverity: "warning",
+    description: "Detect translation keys not referenced in code (dead translations)",
+    run(context) {
+        const { sourceLocale, translations, codeKeys } = context;
+        // If no code keys were collected, skip — we can't determine orphans
+        // without knowing what code actually uses.
+        if (codeKeys.size === 0)
+            return [];
+        const sourceKeys = translations[sourceLocale];
+        if (!sourceKeys)
+            return [];
+        const diagnostics = [];
+        for (const key of Object.keys(sourceKeys)) {
+            if (!codeKeys.has(key)) {
+                const namespace = key.split(".")[0] || "default";
+                diagnostics.push({
+                    filePath: `${sourceLocale}.json`,
+                    line: 0,
+                    column: 0,
+                    rule: RULE_ID,
+                    category: RULE_CATEGORY_MAP[RULE_ID] || "Performance",
+                    severity: this.defaultSeverity,
+                    message: `Key "${key}" exists in translations but is not used in code`,
+                    help: RULE_HELP_MAP[RULE_ID] || "",
+                    key,
+                    namespace,
+                });
+            }
+        }
+        return diagnostics;
+    },
+};
+//# sourceMappingURL=orphan-keys.js.map

package/dist/rules/health/orphan-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-keys.js","sourceRoot":"","sources":["../../../src/rules/health/orphan-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOpE,MAAM,OAAO,GAAG,aAAa,CAAC;AAE9B,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,EAAE,EAAE,OAAO;IACX,eAAe,EAAE,SAAS;IAC1B,WAAW,EACT,oEAAoE;IAEtE,GAAG,CAAC,OAA0B;QAC5B,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAEzD,oEAAoE;QACpE,2CAA2C;QAC3C,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEnC,MAAM,UAAU,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU;YAAE,OAAO,EAAE,CAAC;QAE3B,MAAM,WAAW,GAAqB,EAAE,CAAC;QAEzC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;gBAEjD,WAAW,CAAC,IAAI,CAAC;oBACf,QAAQ,EAAE,GAAG,YAAY,OAAO;oBAChC,IAAI,EAAE,CAAC;oBACP,MAAM,EAAE,CAAC;oBACT,IAAI,EAAE,OAAO;oBACb,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,IAAI,aAAa;oBACrD,QAAQ,EAAE,IAAI,CAAC,eAAe;oBAC9B,OAAO,EAAE,QAAQ,GAAG,kDAAkD;oBACtE,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE;oBAClC,GAAG;oBACH,SAAS;iBACV,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;CACF,CAAC"}

package/dist/rules/health/placeholder-mismatch.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Placeholder Mismatch Rule
+ *
+ * Detects placeholder inconsistencies between source and target translations.
+ * Missing placeholders cause runtime errors (blank slots, crashes).
+ * Extra placeholders indicate likely copy-paste mistakes.
+ *
+ * Supports formats:
+ *   {{name}}    - Handlebars / Mustache
+ *   {count}     - ICU MessageFormat / i18next
+ *   {0}, {1}    - Indexed positional
+ *   ${var}      - Template literal style
+ *   %s, %d, %@  - printf-style
+ *   %1$s        - Positional printf-style
+ *
+ * Category: Quality
+ * Default Severity: error
+ *
+ * Note: extractPlaceholders() is adapted from
+ * apps/api/domains/ai/quality/checks/placeholder-check.ts
+ * (cross-repo import not possible, logic kept in sync manually)
+ */
+import type { HealthRule } from "../registry.js";
+/**
+ * Extract placeholder tokens from a translation string.
+ *
+ * Uses ordered pattern matching with overlap detection to handle
+ * nested formats like {{name}} vs {name}.
+ */
+export declare function extractPlaceholders(text: string): string[];
+export declare const placeholderMismatchRule: HealthRule;
+//# sourceMappingURL=placeholder-mismatch.d.ts.map

package/dist/rules/health/placeholder-mismatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-mismatch.d.ts","sourceRoot":"","sources":["../../../src/rules/health/placeholder-mismatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EACV,UAAU,EAGX,MAAM,gBAAgB,CAAC;AAIxB;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAiC1D;AAED,eAAO,MAAM,uBAAuB,EAAE,UAsErC,CAAC"}

package/dist/rules/health/placeholder-mismatch.js

@@ -0,0 +1,120 @@
+/**
+ * Placeholder Mismatch Rule
+ *
+ * Detects placeholder inconsistencies between source and target translations.
+ * Missing placeholders cause runtime errors (blank slots, crashes).
+ * Extra placeholders indicate likely copy-paste mistakes.
+ *
+ * Supports formats:
+ *   {{name}}    - Handlebars / Mustache
+ *   {count}     - ICU MessageFormat / i18next
+ *   {0}, {1}    - Indexed positional
+ *   ${var}      - Template literal style
+ *   %s, %d, %@  - printf-style
+ *   %1$s        - Positional printf-style
+ *
+ * Category: Quality
+ * Default Severity: error
+ *
+ * Note: extractPlaceholders() is adapted from
+ * apps/api/domains/ai/quality/checks/placeholder-check.ts
+ * (cross-repo import not possible, logic kept in sync manually)
+ */
+import { RULE_CATEGORY_MAP, RULE_HELP_MAP } from "../categories.js";
+const RULE_ID = "placeholder-mismatch";
+/**
+ * Extract placeholder tokens from a translation string.
+ *
+ * Uses ordered pattern matching with overlap detection to handle
+ * nested formats like {{name}} vs {name}.
+ */
+export function extractPlaceholders(text) {
+    // Order matters: more specific patterns first to avoid sub-match overlaps.
+    const patterns = [
+        /\{\{[^}]+\}\}/g, // {{name}}      — Handlebars / Mustache
+        /\$\{[^}]+\}/g, // ${var}        — Template literal
+        /\{[a-zA-Z_]\w*\}/g, // {count}       — ICU / i18next
+        /\{\d+\}/g, // {0}, {1}      — Indexed positional
+        /%\d*\$?[sd@f]/g, // %s, %d, %1$s — printf-style
+    ];
+    const placeholders = [];
+    const claimed = [];
+    function isOverlapping(start, end) {
+        return claimed.some(([cs, ce]) => (start >= cs && start < ce) || (end > cs && end <= ce));
+    }
+    for (const pattern of patterns) {
+        let match;
+        while ((match = pattern.exec(text)) !== null) {
+            const start = match.index;
+            const end = start + match[0].length;
+            if (!isOverlapping(start, end)) {
+                placeholders.push(match[0]);
+                claimed.push([start, end]);
+            }
+        }
+    }
+    return placeholders;
+}
+export const placeholderMismatchRule = {
+    id: RULE_ID,
+    defaultSeverity: "error",
+    description: "Detect placeholder mismatches between source and target translations",
+    run(context) {
+        const { sourceLocale, targetLocales, translations } = context;
+        const sourceKeys = translations[sourceLocale];
+        if (!sourceKeys)
+            return [];
+        const diagnostics = [];
+        for (const targetLocale of targetLocales) {
+            const targetKeys = translations[targetLocale] || {};
+            for (const [key, sourceValue] of Object.entries(sourceKeys)) {
+                const targetValue = targetKeys[key];
+                if (targetValue === undefined)
+                    continue; // missing-translations handles this
+                const sourcePh = extractPlaceholders(sourceValue);
+                const targetPh = extractPlaceholders(targetValue);
+                if (sourcePh.length === 0 && targetPh.length === 0)
+                    continue;
+                const namespace = key.split(".")[0] || "default";
+                // Check for missing placeholders in target
+                for (const ph of sourcePh) {
+                    if (!targetPh.includes(ph)) {
+                        diagnostics.push({
+                            filePath: `${targetLocale}.json`,
+                            line: 0,
+                            column: 0,
+                            rule: RULE_ID,
+                            category: RULE_CATEGORY_MAP[RULE_ID] || "Quality",
+                            severity: this.defaultSeverity,
+                            message: `Placeholder ${ph} in source is missing in "${targetLocale}" for key "${key}"`,
+                            help: RULE_HELP_MAP[RULE_ID] || "",
+                            key,
+                            namespace,
+                            language: targetLocale,
+                        });
+                    }
+                }
+                // Check for extra placeholders in target (lower severity)
+                for (const ph of targetPh) {
+                    if (!sourcePh.includes(ph)) {
+                        diagnostics.push({
+                            filePath: `${targetLocale}.json`,
+                            line: 0,
+                            column: 0,
+                            rule: RULE_ID,
+                            category: RULE_CATEGORY_MAP[RULE_ID] || "Quality",
+                            severity: "warning",
+                            message: `Extra placeholder ${ph} in "${targetLocale}" not found in source for key "${key}"`,
+                            help: RULE_HELP_MAP[RULE_ID] || "",
+                            key,
+                            namespace,
+                            language: targetLocale,
+                        });
+                    }
+                }
+            }
+        }
+        return diagnostics;
+    },
+};
+//# sourceMappingURL=placeholder-mismatch.js.map

package/dist/rules/health/placeholder-mismatch.js.map

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

package/dist/rules/registry.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Rule Registry
+ *
+ * Core interfaces for the i18n Doctor rule system.
+ * Health rules implement HealthRule interface and produce I18nDiagnostic[].
+ *
+ * Design: Rules only produce message text. Category and help text are
+ * externalized in categories.ts (react-doctor pattern) for central management.
+ */
+import type { ProjectContext } from "../analyzer/types.js";
+/**
+ * Universal diagnostic type — the single "currency" of i18n Doctor.
+ *
+ * All sources (code analysis, health rules, file checks) produce this same type.
+ * Inspired by react-doctor's Diagnostic type which unifies oxlint + knip + motion check.
+ */
+export interface I18nDiagnostic {
+    /** Relative file path from project root */
+    filePath: string;
+    /** Line number (1-indexed, 0 if not applicable) */
+    line: number;
+    /** Column number (1-indexed, 0 if not applicable) */
+    column: number;
+    /** Rule identifier e.g. "missing-translations", "jsx-text" */
+    rule: string;
+    /** Diagnostic category */
+    category: "Coverage" | "Quality" | "Structure" | "Code" | "Performance";
+    /** Severity level */
+    severity: "error" | "warning" | "info";
+    /** Human-readable description of the issue */
+    message: string;
+    /** Actionable fix suggestion (populated from RULE_HELP_MAP) */
+    help: string;
+    /** Translation key involved (if applicable) */
+    key?: string;
+    /** Namespace involved (if applicable) */
+    namespace?: string;
+    /** Target language involved (if applicable) */
+    language?: string;
+}
+/**
+ * Health rule interface.
+ *
+ * Health rules analyze translation files at the project level (not per-file AST).
+ * Each rule receives a context with all translations and code keys,
+ * and returns diagnostics for any issues found.
+ *
+ * Design notes:
+ * - defaultSeverity lives on the rule (unlike react-doctor where oxlint sets it)
+ *   because health rules are standalone functions, not ESLint visitors
+ * - Category and help are NOT on the rule — they come from categories.ts
+ * - User config can override defaultSeverity
+ */
+export interface HealthRule {
+    /** Unique rule identifier e.g. "missing-translations" */
+    id: string;
+    /** Default severity (can be overridden by user config) */
+    defaultSeverity: I18nDiagnostic["severity"];
+    /** Short description of what the rule checks */
+    description: string;
+    /** Execute the rule against the health context */
+    run(context: HealthRuleContext): I18nDiagnostic[];
+}
+/**
+ * Context provided to health rules for analysis.
+ *
+ * Contains all the data a health rule needs: source translations,
+ * target translations, code keys, and project configuration.
+ */
+export interface HealthRuleContext {
+    /** Source locale code e.g. "en" */
+    sourceLocale: string;
+    /** Target locale codes e.g. ["tr", "de", "fr"] */
+    targetLocales: string[];
+    /** All translations: locale → flat key→value map */
+    translations: Record<string, Record<string, string>>;
+    /** Translation keys detected in code (from AST analysis) */
+    codeKeys: Set<string>;
+    /** Project root directory */
+    rootDir: string;
+    /** Project configuration (from i18n.config.ts) */
+    projectContext: ProjectContext | null;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/rules/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/rules/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,aAAa,CAAC;IACxE,qBAAqB;IACrB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,eAAe,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAC5C,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,GAAG,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,EAAE,CAAC;CACnD;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,4DAA4D;IAC5D,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;CACvC"}

package/dist/rules/registry.js

@@ -0,0 +1,11 @@
+/**
+ * Rule Registry
+ *
+ * Core interfaces for the i18n Doctor rule system.
+ * Health rules implement HealthRule interface and produce I18nDiagnostic[].
+ *
+ * Design: Rules only produce message text. Category and help text are
+ * externalized in categories.ts (react-doctor pattern) for central management.
+ */
+export {};
+//# sourceMappingURL=registry.js.map

package/dist/rules/registry.js.map

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

package/dist/utils/cdn-client.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CDN client utilities
+ *
+ * Functions for fetching translation data from Better i18n CDN.
+ * Extracted from sync.ts for reuse in doctor and sync commands.
+ */
+import type { CdnManifest } from "../analyzer/types.js";
+import type { RemoteTranslations } from "./json-keys.js";
+/**
+ * Fetch project manifest from CDN.
+ *
+ * The manifest contains language metadata, file URLs, and last-modified timestamps.
+ * Used as the entry point for all CDN operations.
+ */
+export declare function fetchManifest(cdnBaseUrl: string, workspaceId: string, projectSlug: string): Promise<CdnManifest>;
+/**
+ * Fetch remote translation keys for a specific locale.
+ *
+ * Uses manifest URL if available (preferred, as it may include CDN cache-busting),
+ * otherwise constructs a fallback URL from convention.
+ */
+export declare function fetchRemoteKeys(cdnBaseUrl: string, workspaceId: string, projectSlug: string, locale: string, manifest: CdnManifest | null): Promise<RemoteTranslations>;
+/**
+ * Fetch a single locale file from CDN.
+ *
+ * Convenience wrapper that combines manifest lookup + locale fetch.
+ * Returns null if the locale is not available.
+ */
+export declare function fetchLocaleFile(cdnBaseUrl: string, workspaceId: string, projectSlug: string, locale: string): Promise<RemoteTranslations | null>;
+//# sourceMappingURL=cdn-client.d.ts.map

package/dist/utils/cdn-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn-client.d.ts","sourceRoot":"","sources":["../../src/utils/cdn-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,CAAC,CAStB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,GAAG,IAAI,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAe7B;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAkBpC"}

package/dist/utils/cdn-client.js

@@ -0,0 +1,59 @@
+/**
+ * CDN client utilities
+ *
+ * Functions for fetching translation data from Better i18n CDN.
+ * Extracted from sync.ts for reuse in doctor and sync commands.
+ */
+/**
+ * Fetch project manifest from CDN.
+ *
+ * The manifest contains language metadata, file URLs, and last-modified timestamps.
+ * Used as the entry point for all CDN operations.
+ */
+export async function fetchManifest(cdnBaseUrl, workspaceId, projectSlug) {
+    const url = `${cdnBaseUrl}/${workspaceId}/${projectSlug}/manifest.json`;
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Manifest fetch failed (${response.status})`);
+    }
+    return response.json();
+}
+/**
+ * Fetch remote translation keys for a specific locale.
+ *
+ * Uses manifest URL if available (preferred, as it may include CDN cache-busting),
+ * otherwise constructs a fallback URL from convention.
+ */
+export async function fetchRemoteKeys(cdnBaseUrl, workspaceId, projectSlug, locale, manifest) {
+    let url;
+    if (manifest?.files[locale]?.url) {
+        url = manifest.files[locale].url;
+    }
+    else {
+        url = `${cdnBaseUrl}/${workspaceId}/${projectSlug}/translations/${locale}.json`;
+    }
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`CDN fetch failed (${response.status})`);
+    }
+    return response.json();
+}
+/**
+ * Fetch a single locale file from CDN.
+ *
+ * Convenience wrapper that combines manifest lookup + locale fetch.
+ * Returns null if the locale is not available.
+ */
+export async function fetchLocaleFile(cdnBaseUrl, workspaceId, projectSlug, locale) {
+    try {
+        const manifest = await fetchManifest(cdnBaseUrl, workspaceId, projectSlug);
+        if (!manifest.files[locale]) {
+            return null;
+        }
+        return await fetchRemoteKeys(cdnBaseUrl, workspaceId, projectSlug, locale, manifest);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=cdn-client.js.map

package/dist/utils/cdn-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn-client.js","sourceRoot":"","sources":["../../src/utils/cdn-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAkB,EAClB,WAAmB,EACnB,WAAmB;IAEnB,MAAM,GAAG,GAAG,GAAG,UAAU,IAAI,WAAW,IAAI,WAAW,gBAAgB,CAAC;IACxE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAElC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAA0B,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,WAAmB,EACnB,WAAmB,EACnB,MAAc,EACd,QAA4B;IAE5B,IAAI,GAAW,CAAC;IAChB,IAAI,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;QACjC,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,GAAG,UAAU,IAAI,WAAW,IAAI,WAAW,iBAAiB,MAAM,OAAO,CAAC;IAClF,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAElC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAiC,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,WAAmB,EACnB,WAAmB,EACnB,MAAc;IAEd,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;QAE3E,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,MAAM,eAAe,CAC1B,UAAU,EACV,WAAW,EACX,WAAW,EACX,MAAM,EACN,QAAQ,CACT,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/json-keys.d.ts

@@ -0,0 +1,60 @@
+/**
+ * JSON key utilities
+ *
+ * Functions for flattening, counting, and working with nested translation JSON files.
+ * Extracted from sync.ts for reuse in doctor, check, and sync commands.
+ */
+/**
+ * Recursive type representing any valid JSON value in a translation file.
+ * Leaves are strings (most common), numbers, booleans, null, or arrays.
+ * Objects represent nested namespaces.
+ */
+export type TranslationValue = string | number | boolean | null | TranslationValue[] | {
+    [key: string]: TranslationValue;
+};
+/**
+ * Top-level structure of a remote translation file (locale JSON).
+ */
+export type RemoteTranslations = Record<string, TranslationValue>;
+/**
+ * Flatten nested JSON translation file into a namespace-grouped key map.
+ *
+ * Only first-level key becomes the namespace (Better i18n convention).
+ * Returns Record<namespace, fullKey[]>.
+ *
+ * @example
+ * ```
+ * flattenKeys({ common: { title: "Hello", actions: { save: "Save" } } })
+ * // => { common: ["common.title", "common.actions.save"] }
+ * ```
+ */
+export declare function flattenKeys(remoteKeys: RemoteTranslations): Record<string, string[]>;
+/**
+ * Flatten nested JSON to a flat key→value map (all namespaces merged).
+ *
+ * Unlike flattenKeys() which groups by namespace, this returns a single
+ * flat map of dotted-path → leaf-value. Useful for health rules that
+ * need to compare source and target translation values.
+ */
+export declare function flattenToRecord(translations: RemoteTranslations): Record<string, string>;
+/**
+ * Count total leaf keys in nested translation structure.
+ * Only counts string values (not numbers, arrays, booleans).
+ */
+export declare function countTotalKeys(remoteKeys: RemoteTranslations): number;
+/**
+ * Count total keys from a namespace-grouped string[] map.
+ */
+export declare function countMissingKeys(keys: Record<string, string[]>): number;
+/**
+ * Count total keys from a namespace-grouped MissingKeyEntry[] map.
+ */
+export declare function countMissingKeysFromEntries(keys: Record<string, MissingKeyEntry[]>): number;
+/**
+ * A key detected in code that doesn't exist in remote translations.
+ */
+export interface MissingKeyEntry {
+    key: string;
+    value: string;
+}
+//# sourceMappingURL=json-keys.d.ts.map

package/dist/utils/json-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-keys.d.ts","sourceRoot":"","sources":["../../src/utils/json-keys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,gBAAgB,EAAE,GAClB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAA;CAAE,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CA0B1B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,kBAAkB,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBxB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAgBrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAEvE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,GACtC,MAAM,CAER;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf"}