@saidksi/localizer-core 0.1.0

package/dist/rewriter/transforms.js

@@ -0,0 +1,189 @@
+export const LIBRARY_ADAPTERS = {
+    "react-i18next": {
+        importSource: "react-i18next",
+        importSpecifier: "useTranslation",
+        importStatement: 'import { useTranslation } from "react-i18next";',
+        hookStatement: "const { t } = useTranslation();",
+        hookDetectionString: "useTranslation(",
+        callFor: (key) => `t('${key}')`,
+    },
+    "i18next": {
+        importSource: "react-i18next",
+        importSpecifier: "useTranslation",
+        importStatement: 'import { useTranslation } from "react-i18next";',
+        hookStatement: "const { t } = useTranslation();",
+        hookDetectionString: "useTranslation(",
+        callFor: (key) => `t('${key}')`,
+    },
+    "next-intl": {
+        importSource: "next-intl",
+        importSpecifier: "useTranslations",
+        importStatement: 'import { useTranslations } from "next-intl";',
+        hookStatement: "const t = useTranslations();",
+        hookDetectionString: "useTranslations(",
+        callFor: (key) => `t('${key}')`,
+    },
+    "react-intl": {
+        importSource: "react-intl",
+        importSpecifier: "useIntl",
+        importStatement: 'import { useIntl } from "react-intl";',
+        hookStatement: "const intl = useIntl();",
+        hookDetectionString: "useIntl(",
+        callFor: (key) => `intl.formatMessage({ id: '${key}' })`,
+    },
+    "vue-i18n": {
+        importSource: "vue-i18n",
+        importSpecifier: "useI18n",
+        importStatement: 'import { useI18n } from "vue-i18n";',
+        hookStatement: "const { t } = useI18n();",
+        hookDetectionString: "useI18n(",
+        callFor: (key) => `t('${key}')`,
+    },
+};
+export function getAdapter(library) {
+    return LIBRARY_ADAPTERS[library];
+}
+// ─── Positional string replacement ───────────────────────────────────────────
+/**
+ * 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 function applyStringReplacements(source, results, adapter) {
+    const resolved = results.filter((r) => r.resolvedKey !== null);
+    if (resolved.length === 0)
+        return { modified: source, count: 0 };
+    // Sort: bottom → top, right → left
+    const sorted = [...resolved].sort((a, b) => {
+        if (b.line !== a.line)
+            return b.line - a.line;
+        return b.column - a.column;
+    });
+    const lines = source.split("\n");
+    let count = 0;
+    for (const result of sorted) {
+        const lineIdx = result.line - 1; // convert to 0-based
+        const lineStr = lines[lineIdx];
+        if (lineStr === undefined)
+            continue;
+        const key = result.resolvedKey;
+        const call = adapter.callFor(key);
+        let replaced = null;
+        switch (result.nodeType) {
+            case "JSXText": {
+                // Bare text: Welcome back → {t('key')}
+                // Search for the trimmed value starting at (or after) the column
+                const idx = lineStr.indexOf(result.value, result.column);
+                if (idx !== -1) {
+                    replaced =
+                        lineStr.substring(0, idx) +
+                            `{${call}}` +
+                            lineStr.substring(idx + result.value.length);
+                }
+                break;
+            }
+            case "JSXAttribute": {
+                // Quoted attribute value: "Enter email" or 'Enter email' → {t('key')}
+                // Try both quote styles; column points to the opening quote
+                for (const q of ['"', "'"]) {
+                    const target = `${q}${result.value}${q}`;
+                    const idx = lineStr.indexOf(target, result.column);
+                    if (idx !== -1) {
+                        replaced =
+                            lineStr.substring(0, idx) +
+                                `{${call}}` +
+                                lineStr.substring(idx + target.length);
+                        break;
+                    }
+                }
+                break;
+            }
+            case "TemplateLiteral": {
+                if (result.context === "Template literal (static part)") {
+                    // Static quasi from a dynamic template: `prefix ${expr} suffix`
+                    // Replace just the static text span with ${t('key')} (stays inside backticks)
+                    const idx = lineStr.indexOf(result.value, result.column);
+                    if (idx !== -1) {
+                        replaced =
+                            lineStr.substring(0, idx) +
+                                `\${${call}}` +
+                                lineStr.substring(idx + result.value.length);
+                    }
+                }
+                else {
+                    // Standalone static template literal: `Hello world` → t('key')
+                    const target = `\`${result.value}\``;
+                    const idx = lineStr.indexOf(target, result.column);
+                    if (idx !== -1) {
+                        replaced =
+                            lineStr.substring(0, idx) +
+                                call +
+                                lineStr.substring(idx + target.length);
+                    }
+                }
+                break;
+            }
+            case "StringLiteral": {
+                // Skip module-level strings — t() is not available outside component functions
+                if (result.isModuleLevel)
+                    break;
+                // Non-JSX string inside component: setError("..."), return "..." etc. → t('key')
+                for (const q of ['"', "'"]) {
+                    const target = `${q}${result.value}${q}`;
+                    const idx = lineStr.indexOf(target, result.column);
+                    if (idx !== -1) {
+                        replaced =
+                            lineStr.substring(0, idx) +
+                                call +
+                                lineStr.substring(idx + target.length);
+                        break;
+                    }
+                }
+                break;
+            }
+            case "JSXInterpolation": {
+                // Replace the entire children span with a single t() call that passes
+                // the interpolation variables as an object:
+                //   You have {taskCount} pending tasks
+                //   → {t('tasks.pending_count', { taskCount: taskCount })}
+                if (!result.rawSpan || !result.interpolations?.length)
+                    break;
+                // Build the options object: { taskCount: taskCount, userName: userName }
+                const argsStr = result.interpolations
+                    .map(({ placeholder, expression }) => placeholder === expression
+                    ? placeholder // shorthand: { taskCount }
+                    : `${placeholder}: ${expression}`)
+                    .join(", ");
+                const callWithArgs = adapter.callFor(key).replace(/\)$/, `, { ${argsStr} })`);
+                // rawSpan may include surrounding newlines/whitespace from JSX formatting
+                // (the scanner's firstChild.getStart() lands on the '\n' after the opening
+                // tag's '>').  Trim first, then search on the reported line.
+                // Try column-anchored search first; fall back to scanning from col 0
+                // because result.column may point to the prior line's position.
+                const rawSpanTrimmed = result.rawSpan.trim();
+                // If trimmed span still contains a newline the content truly spans
+                // multiple lines — indexOf on a single lineStr will return -1 safely.
+                let idx = lineStr.indexOf(rawSpanTrimmed, result.column);
+                if (idx === -1)
+                    idx = lineStr.indexOf(rawSpanTrimmed, 0);
+                if (idx !== -1) {
+                    replaced =
+                        lineStr.substring(0, idx) +
+                            `{${callWithArgs}}` +
+                            lineStr.substring(idx + rawSpanTrimmed.length);
+                }
+                break;
+            }
+        }
+        if (replaced !== null) {
+            lines[lineIdx] = replaced;
+            count++;
+        }
+    }
+    return { modified: lines.join("\n"), count };
+}
+//# sourceMappingURL=transforms.js.map

package/dist/rewriter/transforms.js.map

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

package/dist/rewriter/ts-morph.d.ts

@@ -0,0 +1,19 @@
+import type { LibraryAdapter } from "./transforms.js";
+/**
+ * Ensure the i18n library import exists in the file.
+ * If the import (or specifier) is already present, the source is returned unchanged.
+ * Otherwise the import is added after the last existing import declaration.
+ */
+export declare function ensureImport(source: string, filePath: string, adapter: LibraryAdapter): string;
+/**
+ * Ensure the translation hook declaration exists in the first component function.
+ * If the hook call is already present anywhere in the file, the source is returned unchanged.
+ * Otherwise the hook statement is inserted at the top of the component function body.
+ */
+export declare function ensureHook(source: string, filePath: string, adapter: LibraryAdapter, namespace?: string): string;
+/**
+ * Apply both import and hook injection in a single pass.
+ * Import is added first so the hook injection sees the updated source.
+ */
+export declare function ensureTranslationBoilerplate(source: string, filePath: string, adapter: LibraryAdapter, namespace?: string): string;
+//# sourceMappingURL=ts-morph.d.ts.map

package/dist/rewriter/ts-morph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-morph.d.ts","sourceRoot":"","sources":["../../src/rewriter/ts-morph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAItD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,GACtB,MAAM,CAoCR;AA8CD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAkCR;AAID;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EACvB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAIR"}

package/dist/rewriter/ts-morph.js

@@ -0,0 +1,121 @@
+import { Project, Node } from "ts-morph";
+// ─── Import injection ─────────────────────────────────────────────────────────
+/**
+ * Ensure the i18n library import exists in the file.
+ * If the import (or specifier) is already present, the source is returned unchanged.
+ * Otherwise the import is added after the last existing import declaration.
+ */
+export function ensureImport(source, filePath, adapter) {
+    const project = new Project({ useInMemoryFileSystem: true });
+    const sf = project.createSourceFile(filePath, source, { overwrite: true });
+    // Check if the import already exists
+    const existing = sf.getImportDeclaration((d) => d.getModuleSpecifierValue() === adapter.importSource &&
+        d.getNamedImports().some((n) => n.getName() === adapter.importSpecifier));
+    if (existing)
+        return source; // already imported
+    // Check if the module is imported but our specifier is missing
+    const partialImport = sf.getImportDeclaration((d) => d.getModuleSpecifierValue() === adapter.importSource);
+    if (partialImport) {
+        // Add our specifier to the existing import
+        partialImport.addNamedImport(adapter.importSpecifier);
+    }
+    else {
+        // Add a brand new import declaration after all existing imports
+        const imports = sf.getImportDeclarations();
+        const insertIndex = imports.length > 0
+            ? imports[imports.length - 1].getChildIndex() + 1
+            : 0;
+        sf.insertImportDeclaration(insertIndex, {
+            namedImports: [adapter.importSpecifier],
+            moduleSpecifier: adapter.importSource,
+        });
+    }
+    return sf.getFullText();
+}
+// ─── Hook injection ───────────────────────────────────────────────────────────
+/**
+ * Find the first component function in the source file.
+ * Looks for:
+ * 1. Exported function declarations: `export function Login()`
+ * 2. Default export functions: `export default function()`
+ * 3. Exported arrow function variable declarations: `export const Login = () => {}`
+ * 4. Any arrow function variable declaration: `const Login = () => {}`
+ * 5. Fallback: any function declaration
+ *
+ * Returns null if no suitable function is found.
+ */
+function findComponentFunction(sf) {
+    // 1. Named exported function declarations
+    for (const fn of sf.getFunctions()) {
+        if (fn.isExported() || fn.isDefaultExport())
+            return fn;
+    }
+    // 2. Exported arrow function variable declarations
+    for (const varStmt of sf.getVariableStatements()) {
+        if (!varStmt.isExported())
+            continue;
+        for (const decl of varStmt.getDeclarations()) {
+            const init = decl.getInitializer();
+            if (init && Node.isArrowFunction(init)) {
+                return init;
+            }
+        }
+    }
+    // 3. Any arrow function variable declaration
+    for (const varStmt of sf.getVariableStatements()) {
+        for (const decl of varStmt.getDeclarations()) {
+            const init = decl.getInitializer();
+            if (init && Node.isArrowFunction(init)) {
+                return init;
+            }
+        }
+    }
+    // 4. Fallback: first function declaration in file
+    return sf.getFunctions()[0] ?? null;
+}
+/**
+ * Ensure the translation hook declaration exists in the first component function.
+ * If the hook call is already present anywhere in the file, the source is returned unchanged.
+ * Otherwise the hook statement is inserted at the top of the component function body.
+ */
+export function ensureHook(source, filePath, adapter, namespace) {
+    // Fast path: hook already present in source text
+    if (source.includes(adapter.hookDetectionString))
+        return source;
+    const project = new Project({ useInMemoryFileSystem: true });
+    const sf = project.createSourceFile(filePath, source, { overwrite: true });
+    const fn = findComponentFunction(sf);
+    if (!fn)
+        return source; // no function found — leave as-is
+    const body = Node.isArrowFunction(fn)
+        ? fn.getBody()
+        : fn.getBody();
+    if (!body)
+        return source;
+    // For arrow functions with expression bodies (no braces), convert to block first
+    if (!Node.isBlock(body)) {
+        // e.g. `const X = () => <div/>` — not common in real components, skip
+        return source;
+    }
+    // Build the hook statement, using namespace if provided and if the hook accepts it
+    // Only useTranslation, useTranslations, and useI18n accept namespace argument.
+    // react-intl's useIntl() does not accept a namespace argument.
+    const supportsNamespace = adapter.importSpecifier !== "useIntl";
+    const hookStatement = namespace && supportsNamespace
+        ? adapter.hookStatement.replace("()", `('${namespace}')`)
+        : adapter.hookStatement;
+    // Insert hook at the very beginning of the function body (index 0)
+    body.insertStatements(0, [hookStatement]);
+    return sf.getFullText();
+}
+// ─── Combined ────────────────────────────────────────────────────────────────
+/**
+ * Apply both import and hook injection in a single pass.
+ * Import is added first so the hook injection sees the updated source.
+ */
+export function ensureTranslationBoilerplate(source, filePath, adapter, namespace) {
+    let result = ensureImport(source, filePath, adapter);
+    result = ensureHook(result, filePath, adapter, namespace);
+    return result;
+}
+//# sourceMappingURL=ts-morph.js.map

package/dist/rewriter/ts-morph.js.map

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

package/dist/scanner/babel.d.ts

@@ -0,0 +1,3 @@
+import type { ScanResult, LocalizeConfig } from "../types.js";
+export declare function scanWithBabel(filePath: string, source: string, config: LocalizeConfig): ScanResult[];
+//# sourceMappingURL=babel.d.ts.map

package/dist/scanner/babel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"babel.d.ts","sourceRoot":"","sources":["../../src/scanner/babel.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAY,cAAc,EAAoB,MAAM,aAAa,CAAC;AA2R1F,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACrB,UAAU,EAAE,CAsTd"}