@saidksi/localizer-core 0.1.0

package/dist/ai/prompts.js

@@ -0,0 +1,151 @@
+// ─── Language names ───────────────────────────────────────────────────────────
+const LANGUAGE_NAMES = {
+    en: "English",
+    fr: "French",
+    ar: "Arabic",
+    es: "Spanish",
+    de: "German",
+    it: "Italian",
+    pt: "Portuguese",
+    ja: "Japanese",
+    zh: "Chinese (Simplified)",
+    ko: "Korean",
+    ru: "Russian",
+    nl: "Dutch",
+    pl: "Polish",
+    tr: "Turkish",
+    sv: "Swedish",
+    da: "Danish",
+    fi: "Finnish",
+    nb: "Norwegian",
+    cs: "Czech",
+    hu: "Hungarian",
+    ro: "Romanian",
+    uk: "Ukrainian",
+    he: "Hebrew",
+    hi: "Hindi",
+    th: "Thai",
+    vi: "Vietnamese",
+    id: "Indonesian",
+};
+export function getLanguageName(code) {
+    return LANGUAGE_NAMES[code] ?? code.toUpperCase();
+}
+// ─── Prompt builder ───────────────────────────────────────────────────────────
+export function buildTranslationPrompt(request) {
+    const { file, componentContext, element, surroundingCode, value, keyStyle, glossary, targetLanguages, } = request;
+    const indentedCode = surroundingCode
+        .split("\n")
+        .map((l) => `  ${l}`)
+        .join("\n");
+    const glossarySection = Object.keys(glossary).length > 0
+        ? `Glossary (use these exact terms):\n${Object.entries(glossary)
+            .map(([lang, term]) => `  ${lang}: "${term}"`)
+            .join("\n")}\n\n`
+        : "";
+    const relatedStringsSection = request.relatedStrings && request.relatedStrings.length > 0
+        ? `Related strings in same component (for consistent naming):\n${request.relatedStrings
+            .slice(0, 5)
+            .map((s) => `  "${s}"`)
+            .join("\n")}\n\n`
+        : "";
+    const languageList = targetLanguages
+        .map((code) => `${getLanguageName(code)} (${code})`)
+        .join(", ");
+    const exampleKey = keyStyle === "dot.notation"
+        ? "section.descriptive_key"
+        : "section_descriptive_key";
+    const exampleTranslations = Object.fromEntries(targetLanguages.map((lang) => [lang, "..."]));
+    // Detect whether this string contains i18next interpolation placeholders
+    const hasInterpolation = /\{\{[^}]+\}\}/.test(value);
+    const interpolationRule = hasInterpolation
+        ? `- This string contains i18next interpolation placeholders like {{count}}. Preserve ALL {{placeholder}} tokens exactly as-is in every translation — do NOT translate, rename, or remove them.\n`
+        : "";
+    return `You are an i18n key naming and translation assistant.
+
+File: ${file}
+Component: ${componentContext}
+Element: ${element}
+Surrounding code:
+${indentedCode}
+
+String: "${value}"
+Key style: ${keyStyle}
+${glossarySection}${relatedStringsSection}Tasks:
+1. Generate a concise semantic i18n key in ${keyStyle} format
+2. Translate the string into: ${languageList}
+
+Rules:
+- Key must be lowercase and context-aware (e.g. "auth.sign_in_button", not "button1")
+- If related strings exist in the same component, use consistent namespace roots (e.g. all under "dashboard.statistics" not mixed namespaces)
+- Use glossary terms exactly when provided
+- Translations must be natural, not word-for-word literal
+${interpolationRule}- Return ONLY valid JSON — no explanation, no markdown fences
+
+Return exactly this shape:
+{ "key": "${exampleKey}", "translations": ${JSON.stringify(exampleTranslations)} }`;
+}
+// ─── Translation-only prompt (--from-existing) ───────────────────────────────
+/**
+ * Simpler prompt used when keys already exist and we only need translations.
+ * Returns a flat { lang: translation } object — no key generation.
+ */
+export function buildTranslationOnlyPrompt(value, targetLanguages, glossary = {}) {
+    const languageList = targetLanguages
+        .map((code) => `${getLanguageName(code)} (${code})`)
+        .join(", ");
+    const glossarySection = Object.keys(glossary).length > 0
+        ? `Glossary (use these exact terms):\n${Object.entries(glossary)
+            .map(([lang, term]) => `  ${lang}: "${term}"`)
+            .join("\n")}\n\n`
+        : "";
+    const example = Object.fromEntries(targetLanguages.map((l) => [l, "..."]));
+    return `You are a professional translator.
+
+String: "${value}"
+Translate into: ${languageList}
+${glossarySection}Rules:
+- Translations must be natural, not word-for-word literal
+- Use glossary terms exactly when provided
+- Return ONLY valid JSON with no explanation or markdown
+
+Return exactly:
+${JSON.stringify(example)}`;
+}
+/** Parse a flat translation-only response: { fr: "...", ar: "..." } */
+export function parseTranslationOnlyResponse(text) {
+    const match = text.match(/\{[\s\S]*\}/);
+    if (!match)
+        throw new Error(`No JSON found in AI response:\n${text}`);
+    const parsed = JSON.parse(match[0]);
+    if (typeof parsed !== "object" || parsed === null) {
+        throw new Error(`Invalid translation response: ${match[0]}`);
+    }
+    return parsed;
+}
+/**
+ * Extract and validate the JSON object from an AI response string.
+ * Tolerates leading/trailing explanation text around the JSON.
+ */
+export function parseAIResponse(text) {
+    const match = text.match(/\{[\s\S]*\}/);
+    if (!match) {
+        throw new Error(`No JSON object found in AI response:\n${text}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(match[0]);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse AI response JSON: ${String(err)}\n${match[0]}`);
+    }
+    if (typeof parsed !== "object" ||
+        parsed === null ||
+        typeof parsed["key"] !== "string" ||
+        typeof parsed["translations"] !== "object" ||
+        parsed["translations"] === null) {
+        throw new Error(`AI response missing required fields (key, translations):\n${match[0]}`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/ai/prompts.js.map

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

package/dist/cache/index.d.ts

@@ -0,0 +1,69 @@
+import type { CacheStore } from "../types.js";
+/**
+ * Compute the SHA-256 hex digest of a string (file source contents).
+ * Exported for unit testing.
+ */
+export declare function hashSource(source: string): string;
+/**
+ * Read the cache store from `{projectRoot}/.localize/cache.json`.
+ * Returns an empty store if the file doesn't exist or is unreadable.
+ */
+export declare function readCache(projectRoot: string): Promise<CacheStore>;
+/**
+ * Persist the cache store to `{projectRoot}/.localize/cache.json`.
+ * Creates the `.localize/` directory if it doesn't exist.
+ */
+export declare function writeCache(projectRoot: string, store: CacheStore): Promise<void>;
+/**
+ * Delete the cache file entirely.
+ * Used by `localize run --force` to trigger a full re-process.
+ */
+export declare function clearCache(projectRoot: string): Promise<void>;
+/**
+ * Check whether a file (identified by its path and current source contents)
+ * has already been processed and hasn't changed since.
+ *
+ * @param store   The loaded CacheStore
+ * @param relPath File path relative to project root (used as the cache key)
+ * @param source  Current file contents
+ */
+export declare function isCached(store: CacheStore, relPath: string, source: string): boolean;
+/**
+ * Record that a file has been successfully processed.
+ * Returns a new CacheStore with the entry upserted (immutable update).
+ *
+ * @param store       The current CacheStore
+ * @param relPath     File path relative to project root
+ * @param source      File contents at time of processing
+ * @param stringCount Number of strings processed in this file
+ */
+export declare function markCached(store: CacheStore, relPath: string, source: string, stringCount: number): CacheStore;
+/**
+ * Remove a single file's entry from the cache.
+ * Returns a new CacheStore (immutable update).
+ */
+export declare function evictEntry(store: CacheStore, relPath: string): CacheStore;
+/**
+ * Filter a list of file paths down to those that are NOT in the cache
+ * (or whose contents have changed since last processing).
+ *
+ * @param store     Loaded CacheStore
+ * @param files     Array of { relPath, source } objects
+ */
+export declare function filterUncached(store: CacheStore, files: Array<{
+    relPath: string;
+    source: string;
+}>): Array<{
+    relPath: string;
+    source: string;
+}>;
+/**
+ * Apply a batch of processed files to the cache store.
+ * Returns a new CacheStore with all entries upserted.
+ */
+export declare function markBatchCached(store: CacheStore, processed: Array<{
+    relPath: string;
+    source: string;
+    stringCount: number;
+}>): CacheStore;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,aAAa,CAAC;AAoB1D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAID;;;GAGG;AACH,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAWxE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOnE;AAID;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAIT;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,UAAU,CAUZ;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAGzE;AAID;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAChD,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAE5C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GACzE,UAAU,CAMZ"}

package/dist/cache/index.js

@@ -0,0 +1,129 @@
+import { createHash } from "crypto";
+import { readFile, writeFile, mkdir, unlink } from "fs/promises";
+import { resolve, join } from "path";
+// ─── Constants ────────────────────────────────────────────────────────────────
+const CACHE_DIR = ".localize";
+const CACHE_FILE = "cache.json";
+const CURRENT_VERSION = 1;
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function getCachePath(projectRoot) {
+    return join(resolve(projectRoot), CACHE_DIR, CACHE_FILE);
+}
+function emptyStore() {
+    return { version: CURRENT_VERSION, entries: {} };
+}
+// ─── Hash ─────────────────────────────────────────────────────────────────────
+/**
+ * Compute the SHA-256 hex digest of a string (file source contents).
+ * Exported for unit testing.
+ */
+export function hashSource(source) {
+    return createHash("sha256").update(source, "utf-8").digest("hex");
+}
+// ─── Read / Write ─────────────────────────────────────────────────────────────
+/**
+ * Read the cache store from `{projectRoot}/.localize/cache.json`.
+ * Returns an empty store if the file doesn't exist or is unreadable.
+ */
+export async function readCache(projectRoot) {
+    const cachePath = getCachePath(projectRoot);
+    try {
+        const content = await readFile(cachePath, "utf-8");
+        const parsed = JSON.parse(content);
+        // Invalidate on version mismatch
+        if (parsed.version !== CURRENT_VERSION)
+            return emptyStore();
+        return parsed;
+    }
+    catch {
+        return emptyStore();
+    }
+}
+/**
+ * Persist the cache store to `{projectRoot}/.localize/cache.json`.
+ * Creates the `.localize/` directory if it doesn't exist.
+ */
+export async function writeCache(projectRoot, store) {
+    const cachePath = getCachePath(projectRoot);
+    await mkdir(join(resolve(projectRoot), CACHE_DIR), { recursive: true });
+    await writeFile(cachePath, JSON.stringify(store, null, 2) + "\n", "utf-8");
+}
+/**
+ * Delete the cache file entirely.
+ * Used by `localize run --force` to trigger a full re-process.
+ */
+export async function clearCache(projectRoot) {
+    const cachePath = getCachePath(projectRoot);
+    try {
+        await unlink(cachePath);
+    }
+    catch {
+        // Already gone — that's fine
+    }
+}
+// ─── Cache checks ─────────────────────────────────────────────────────────────
+/**
+ * Check whether a file (identified by its path and current source contents)
+ * has already been processed and hasn't changed since.
+ *
+ * @param store   The loaded CacheStore
+ * @param relPath File path relative to project root (used as the cache key)
+ * @param source  Current file contents
+ */
+export function isCached(store, relPath, source) {
+    const entry = store.entries[relPath];
+    if (!entry)
+        return false;
+    return entry.hash === hashSource(source);
+}
+/**
+ * Record that a file has been successfully processed.
+ * Returns a new CacheStore with the entry upserted (immutable update).
+ *
+ * @param store       The current CacheStore
+ * @param relPath     File path relative to project root
+ * @param source      File contents at time of processing
+ * @param stringCount Number of strings processed in this file
+ */
+export function markCached(store, relPath, source, stringCount) {
+    const entry = {
+        hash: hashSource(source),
+        processedAt: new Date().toISOString(),
+        stringCount,
+    };
+    return {
+        ...store,
+        entries: { ...store.entries, [relPath]: entry },
+    };
+}
+/**
+ * Remove a single file's entry from the cache.
+ * Returns a new CacheStore (immutable update).
+ */
+export function evictEntry(store, relPath) {
+    const { [relPath]: _, ...rest } = store.entries;
+    return { ...store, entries: rest };
+}
+// ─── Batch helpers ────────────────────────────────────────────────────────────
+/**
+ * Filter a list of file paths down to those that are NOT in the cache
+ * (or whose contents have changed since last processing).
+ *
+ * @param store     Loaded CacheStore
+ * @param files     Array of { relPath, source } objects
+ */
+export function filterUncached(store, files) {
+    return files.filter(({ relPath, source }) => !isCached(store, relPath, source));
+}
+/**
+ * Apply a batch of processed files to the cache store.
+ * Returns a new CacheStore with all entries upserted.
+ */
+export function markBatchCached(store, processed) {
+    let updated = store;
+    for (const { relPath, source, stringCount } of processed) {
+        updated = markCached(updated, relPath, source, stringCount);
+    }
+    return updated;
+}
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export { scanFile, scanFiles, scanDirectory, buildScanReport } from "./scanner/index.js";
+export { shouldFilter, NON_TRANSLATABLE_ATTRS, TRANSLATION_FNS } from "./scanner/filters.js";
+export * from "./rewriter/index.js";
+export * from "./ai/index.js";
+export { flattenKeys, readLanguageKeys, validateCoverage, isFullyCovered, getMissingKeys, resolveKeysFromMessages, type ValidateOptions, } from "./validator/index.js";
+export * from "./cache/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG7F,cAAc,qBAAqB,CAAC;AAGpC,cAAc,eAAe,CAAC;AAG9B,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAG9B,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+// Types — import these in all modules
+export * from "./types.js";
+// Scanner
+export { scanFile, scanFiles, scanDirectory, buildScanReport } from "./scanner/index.js";
+export { shouldFilter, NON_TRANSLATABLE_ATTRS, TRANSLATION_FNS } from "./scanner/filters.js";
+// Rewriter — Step 6
+export * from "./rewriter/index.js";
+// AI client — Step 5
+export * from "./ai/index.js";
+// Validator — Step 7
+export { flattenKeys, readLanguageKeys, validateCoverage, isFullyCovered, getMissingKeys, resolveKeysFromMessages, } from "./validator/index.js";
+// Cache — Step 8
+export * from "./cache/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,cAAc,YAAY,CAAC;AAE3B,UAAU;AACV,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE7F,oBAAoB;AACpB,cAAc,qBAAqB,CAAC;AAEpC,qBAAqB;AACrB,cAAc,eAAe,CAAC;AAE9B,qBAAqB;AACrB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,uBAAuB,GAExB,MAAM,sBAAsB,CAAC;AAE9B,iBAAiB;AACjB,cAAc,kBAAkB,CAAC"}

package/dist/rewriter/index.d.ts

@@ -0,0 +1,31 @@
+import type { ScanResult, RewriteResult, LocalizeConfig } from "../types.js";
+/**
+ * Generate a readable line-level diff between two source strings.
+ * Shows changed lines with - / + prefixes and up to 2 lines of context.
+ */
+export declare function generateDiff(original: string, modified: string, filePath: string): string;
+/**
+ * Rewrite a source file: replace hardcoded strings with t() calls,
+ * add the i18n import and hook if missing.
+ *
+ * Does NOT write to disk — returns the modified source and diff.
+ * The CLI layer handles confirmation and calls `applyRewrite` to persist.
+ */
+export declare function rewriteFile(filePath: string, results: ScanResult[], config: LocalizeConfig): Promise<RewriteResult>;
+/**
+ * Write the modified source from a RewriteResult to disk.
+ * Call this after the user confirms the diff.
+ * Returns the result with `applied: true`.
+ */
+export declare function applyRewrite(result: RewriteResult): Promise<RewriteResult>;
+/**
+ * Rewrite multiple files. Each file is processed independently.
+ * Results are returned in the same order as the input file list.
+ */
+export declare function rewriteFiles(fileResultsMap: Map<string, ScanResult[]>, config: LocalizeConfig): Promise<RewriteResult[]>;
+/**
+ * Group a flat ScanResult[] by source file.
+ * Useful before calling rewriteFiles.
+ */
+export declare function groupResultsByFile(results: ScanResult[]): Map<string, ScanResult[]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rewriter/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAM7E;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CA6CR;AAID;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,UAAU,EAAE,EACrB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,aAAa,CAAC,CA4CxB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAGhF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,EACzC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC,CAO1B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,UAAU,EAAE,GACpB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAW3B"}

package/dist/rewriter/index.js

@@ -0,0 +1,128 @@
+import { readFile, writeFile } from "fs/promises";
+import { resolve, basename, extname } from "path";
+import { applyStringReplacements, getAdapter } from "./transforms.js";
+import { ensureTranslationBoilerplate } from "./ts-morph.js";
+// ─── Diff generation ─────────────────────────────────────────────────────────
+/**
+ * Generate a readable line-level diff between two source strings.
+ * Shows changed lines with - / + prefixes and up to 2 lines of context.
+ */
+export function generateDiff(original, modified, filePath) {
+    if (original === modified)
+        return "";
+    const origLines = original.split("\n");
+    const modLines = modified.split("\n");
+    const output = [`--- ${filePath}`, `+++ ${filePath}`];
+    // Collect all changed line indices
+    const maxLen = Math.max(origLines.length, modLines.length);
+    const changedLines = new Set();
+    for (let i = 0; i < maxLen; i++) {
+        if (origLines[i] !== modLines[i])
+            changedLines.add(i);
+    }
+    // Build context windows (±2 lines around each change)
+    const CONTEXT = 2;
+    const toShow = new Set();
+    for (const idx of changedLines) {
+        for (let c = Math.max(0, idx - CONTEXT); c <= Math.min(maxLen - 1, idx + CONTEXT); c++) {
+            toShow.add(c);
+        }
+    }
+    const sortedIndices = [...toShow].sort((a, b) => a - b);
+    let prevIdx = -1;
+    for (const i of sortedIndices) {
+        // Show separator for gaps
+        if (prevIdx !== -1 && i > prevIdx + 1) {
+            output.push("@@");
+        }
+        prevIdx = i;
+        const orig = origLines[i];
+        const mod = modLines[i];
+        if (orig === mod) {
+            output.push(`  ${orig ?? ""}`);
+        }
+        else {
+            if (orig !== undefined)
+                output.push(`- ${orig}`);
+            if (mod !== undefined)
+                output.push(`+ ${mod}`);
+        }
+    }
+    return output.join("\n");
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Rewrite a source file: replace hardcoded strings with t() calls,
+ * add the i18n import and hook if missing.
+ *
+ * Does NOT write to disk — returns the modified source and diff.
+ * The CLI layer handles confirmation and calls `applyRewrite` to persist.
+ */
+export async function rewriteFile(filePath, results, config) {
+    const absolute = resolve(filePath);
+    const originalSource = await readFile(absolute, "utf-8");
+    const resolved = results.filter((r) => r.resolvedKey !== null);
+    if (resolved.length === 0) {
+        return {
+            file: absolute,
+            applied: false,
+            changesCount: 0,
+            diff: "",
+            modifiedSource: originalSource,
+        };
+    }
+    const adapter = getAdapter(config.i18nLibrary);
+    // Step 1: Replace hardcoded strings with t() calls (positional, text-based)
+    const { modified: afterReplacements, count } = applyStringReplacements(originalSource, resolved, adapter);
+    // Step 2: Ensure import + hook are present (ts-morph structural edits)
+    // Derive namespace from filename: Login.tsx → "login", home.tsx → "home"
+    const namespace = basename(filePath, extname(filePath)).toLowerCase();
+    const finalSource = ensureTranslationBoilerplate(afterReplacements, filePath, adapter, namespace);
+    const diff = generateDiff(originalSource, finalSource, filePath);
+    return {
+        file: absolute,
+        applied: false,
+        changesCount: count,
+        diff,
+        modifiedSource: finalSource,
+    };
+}
+/**
+ * Write the modified source from a RewriteResult to disk.
+ * Call this after the user confirms the diff.
+ * Returns the result with `applied: true`.
+ */
+export async function applyRewrite(result) {
+    await writeFile(result.file, result.modifiedSource, "utf-8");
+    return { ...result, applied: true };
+}
+/**
+ * Rewrite multiple files. Each file is processed independently.
+ * Results are returned in the same order as the input file list.
+ */
+export async function rewriteFiles(fileResultsMap, config) {
+    const rewrites = [];
+    for (const [filePath, results] of fileResultsMap) {
+        const rewrite = await rewriteFile(filePath, results, config);
+        rewrites.push(rewrite);
+    }
+    return rewrites;
+}
+/**
+ * Group a flat ScanResult[] by source file.
+ * Useful before calling rewriteFiles.
+ */
+export function groupResultsByFile(results) {
+    const map = new Map();
+    for (const result of results) {
+        const existing = map.get(result.file);
+        if (existing) {
+            existing.push(result);
+        }
+        else {
+            map.set(result.file, [result]);
+        }
+    }
+    return map;
+}
+//# sourceMappingURL=index.js.map

package/dist/rewriter/index.js.map

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

package/dist/rewriter/transforms.d.ts

@@ -0,0 +1,38 @@
+import type { ScanResult, I18nLibrary } from "../types.js";
+/**
+ * Encapsulates the library-specific details for import, hook, and call expression.
+ * Each supported i18n library has its own adapter.
+ */
+export interface LibraryAdapter {
+    /** npm package to import from */
+    importSource: string;
+    /** Named export to import: "useTranslation", "useTranslations", etc. */
+    importSpecifier: string;
+    /** The full import statement added to the top of the file */
+    importStatement: string;
+    /** Hook declaration added at the top of the component body */
+    hookStatement: string;
+    /**
+     * A string that uniquely identifies this hook in source code.
+     * Used to detect whether the hook is already present.
+     */
+    hookDetectionString: string;
+    /** Build the call expression for a given i18n key, e.g. t('auth.login') */
+    callFor(key: string): string;
+}
+export declare const LIBRARY_ADAPTERS: Record<I18nLibrary, LibraryAdapter>;
+export declare function getAdapter(library: I18nLibrary): LibraryAdapter;
+/**
+ * Apply all resolved string replacements to the source text.
+ *
+ * Strategy:
+ * - Sort results bottom-to-top, right-to-left so earlier replacements
+ *   don't shift the positions of later ones on the same line.
+ * - For each result, locate the exact source span from its NodeType and
+ *   replace it with the appropriate t() call expression.
+ */
+export declare function applyStringReplacements(source: string, results: ScanResult[], adapter: LibraryAdapter): {
+    modified: string;
+    count: number;
+};
+//# sourceMappingURL=transforms.d.ts.map

package/dist/rewriter/transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../../src/rewriter/transforms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI3D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,eAAe,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,cAAc,CAyChE,CAAC;AAEF,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAE/D;AAID;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,cAAc,GACtB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAgJrC"}