@saidksi/localizer-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 SaidKSI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", BASIS WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,164 @@
+# @localize/core
+
+Core library for the Localize i18n CLI tool. Provides AST-based string detection, AI-powered i18n key generation, code transformation, and validation.
+
+## Features
+
+- **Scanner**: AST-based detection of hardcoded strings in TypeScript/JavaScript code
+- **AI Integration**: Provider-agnostic support for Anthropic and OpenAI APIs
+- **Rewriter**: Automatic code transformation to replace hardcoded strings with i18n function calls
+- **Validator**: Key coverage validation across multiple language files
+- **Cache**: Smart caching to avoid re-processing unchanged files
+
+## Installation
+
+```bash
+npm install @localize/core
+# or
+pnpm add @localize/core
+```
+
+## Quick Start
+
+```typescript
+import { Scanner, AIClient, Rewriter, Validator } from "@localize/core";
+
+// 1. Scan for hardcoded strings
+const scanner = new Scanner({ defaultLanguage: "en" });
+const results = await scanner.scan("./src");
+
+// 2. Generate keys and translations
+const aiClient = new AIClient({
+  provider: "anthropic",
+  apiKey: process.env.ANTHROPIC_API_KEY,
+});
+const translations = await aiClient.generateTranslations(results);
+
+// 3. Rewrite source code
+const rewriter = new Rewriter();
+const modified = await rewriter.rewrite(filePath, results[0], translations);
+
+// 4. Validate translations
+const validator = new Validator();
+const coverage = await validator.validate("./messages");
+```
+
+## API
+
+### Scanner
+
+Detects hardcoded strings in source code:
+
+```typescript
+const scanner = new Scanner({
+  defaultLanguage: "en",
+  include: ["src/**/*.{ts,tsx,js,jsx}"],
+  exclude: ["**/*.test.ts", "node_modules"],
+  ignoreFiles: [],
+});
+
+const results = await scanner.scan(dirOrFilePath);
+// Returns: ScanResult[] with { filePath, string, line, column, context }
+```
+
+### AIClient
+
+Generates semantic i18n keys and translations:
+
+```typescript
+const client = new AIClient({
+  provider: "anthropic" | "openai",
+  apiKey: "your-api-key",
+  model: "claude-3-sonnet" | "gpt-4",
+});
+
+const translations = await client.generateTranslations(scanResults, {
+  languages: ["en", "fr", "es"],
+  keyStyle: "dot.notation" | "snake_case",
+  glossary: { /* domain-specific terms */ },
+});
+// Returns: { key: string, translations: { [lang]: string } }[]
+```
+
+### Rewriter
+
+Transforms source code to use i18n function calls:
+
+```typescript
+const rewriter = new Rewriter();
+const modified = await rewriter.rewrite(
+  filePath,
+  scanResult,
+  translation,
+  { 
+    i18nLibrary: "react-i18next",
+    dryRun: false,
+  }
+);
+// Returns: { modified: string, diff: string }
+```
+
+### Validator
+
+Validates translation coverage:
+
+```typescript
+const validator = new Validator({
+  messagesDir: "./messages",
+  languages: ["en", "fr"],
+});
+
+const report = await validator.validate();
+// Returns coverage % per language and missing keys
+```
+
+## Configuration
+
+Create a `.localize.config.json` in your project root:
+
+```json
+{
+  "defaultLanguage": "en",
+  "languages": ["en", "fr", "es"],
+  "messagesDir": "./messages",
+  "include": ["src/**/*.{ts,tsx,js,jsx}"],
+  "exclude": ["**/*.test.ts", "**/*.spec.ts"],
+  "aiProvider": "anthropic",
+  "aiModel": "claude-3-sonnet-20240229",
+  "keyStyle": "dot.notation",
+  "i18nLibrary": "react-i18next",
+  "fileOrganization": "per-page",
+  "strictMode": true,
+  "glossary": {}
+}
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Tests
+pnpm test
+pnpm test:watch
+pnpm test:coverage
+
+# Type check
+pnpm lint
+```
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## Repository
+
+https://github.com/SaidKSI/localize-core

package/dist/ai/anthropic.d.ts

@@ -0,0 +1,17 @@
+import type { AIRequest, AIResponse } from "../types.js";
+export declare const ANTHROPIC_RATES: Record<string, {
+    input: number;
+    output: number;
+}>;
+export declare function estimateCost(model: string, inputTokens: number, outputTokens: number): number;
+export interface AnthropicResult {
+    /** Maps string value → parsed AI response */
+    responses: Map<string, AIResponse>;
+    totalCostUsd: number;
+}
+/**
+ * Call the Anthropic API for a batch of AI requests.
+ * Runs up to MAX_CONCURRENCY requests in parallel.
+ */
+export declare function callAnthropic(requests: AIRequest[], model: string, apiKey: string): Promise<AnthropicResult>;
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/ai/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/ai/anthropic.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQzD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAI7E,CAAC;AAEF,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAGR;AAID,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,SAAS,EAAE,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC,CAuD1B"}

package/dist/ai/anthropic.js

@@ -0,0 +1,58 @@
+import Anthropic from "@anthropic-ai/sdk";
+import pLimit from "p-limit";
+import { buildTranslationPrompt, parseAIResponse } from "./prompts.js";
+const MAX_CONCURRENCY = 5;
+// ─── Cost estimation ──────────────────────────────────────────────────────────
+// Approximate rates in USD per token (updated 2025)
+export const ANTHROPIC_RATES = {
+    "claude-opus-4-6": { input: 15 / 1_000_000, output: 75 / 1_000_000 },
+    "claude-sonnet-4-6": { input: 3 / 1_000_000, output: 15 / 1_000_000 },
+    "claude-haiku-4-5": { input: 0.8 / 1_000_000, output: 4 / 1_000_000 },
+};
+export function estimateCost(model, inputTokens, outputTokens) {
+    const rates = ANTHROPIC_RATES[model] ?? ANTHROPIC_RATES["claude-sonnet-4-6"];
+    return inputTokens * rates.input + outputTokens * rates.output;
+}
+/**
+ * Call the Anthropic API for a batch of AI requests.
+ * Runs up to MAX_CONCURRENCY requests in parallel.
+ */
+export async function callAnthropic(requests, model, apiKey) {
+    const client = new Anthropic({ apiKey });
+    const limit = pLimit(MAX_CONCURRENCY);
+    const responses = new Map();
+    let totalCostUsd = 0;
+    await Promise.all(requests.map((request) => limit(async () => {
+        const prompt = buildTranslationPrompt(request);
+        let message;
+        try {
+            message = await client.messages.create({
+                model,
+                max_tokens: 1024,
+                messages: [{ role: "user", content: prompt }],
+            });
+        }
+        catch (err) {
+            // Log and skip — don't fail the entire batch
+            console.error(`[localize] Anthropic call failed for "${request.value}": ${String(err)}`);
+            return;
+        }
+        const rawText = message.content[0]?.type === "text" ? message.content[0].text : "";
+        let parsed;
+        try {
+            parsed = parseAIResponse(rawText);
+        }
+        catch (err) {
+            console.error(`[localize] Failed to parse response for "${request.value}": ${String(err)}`);
+            return;
+        }
+        // Track cost
+        totalCostUsd += estimateCost(model, message.usage.input_tokens, message.usage.output_tokens);
+        responses.set(request.value, {
+            key: parsed.key,
+            translations: parsed.translations,
+        });
+    })));
+    return { responses, totalCostUsd };
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/ai/anthropic.js.map

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

package/dist/ai/dedup.d.ts

@@ -0,0 +1,19 @@
+import type { ScanResult, AIRequest, LocalizeConfig } from "../types.js";
+/**
+ * Group scan results by string value.
+ * All results with the same value share one AI call.
+ * The first result in each group provides context for the AI prompt.
+ */
+export declare function deduplicateResults(results: ScanResult[]): Map<string, ScanResult[]>;
+/**
+ * Build one AIRequest per deduplicated group.
+ * Uses the first (representative) ScanResult for context.
+ * Includes related strings from the same component to guide consistent key naming.
+ */
+export declare function buildAIRequests(groups: Map<string, ScanResult[]>, config: LocalizeConfig, allResults?: ScanResult[]): AIRequest[];
+/**
+ * Apply resolved keys back to all ScanResults.
+ * All results with the same string value get the same key.
+ */
+export declare function applyResolvedKeys(results: ScanResult[], responses: Map<string, string>): ScanResult[];
+//# sourceMappingURL=dedup.d.ts.map

package/dist/ai/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/ai/dedup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA4BzE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,UAAU,EAAE,GACpB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAW3B;AAmBD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,EACjC,MAAM,EAAE,cAAc,EACtB,UAAU,CAAC,EAAE,UAAU,EAAE,GACxB,SAAS,EAAE,CAmDb;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EAAE,EACrB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,UAAU,EAAE,CAKd"}

package/dist/ai/dedup.js

@@ -0,0 +1,119 @@
+import { basename, extname } from "path";
+// ─── Component context ────────────────────────────────────────────────────────
+/**
+ * Derive a human-readable component description from a file path.
+ * "src/pages/LoginPage.tsx" → "LoginPage component"
+ */
+function getComponentContext(filePath) {
+    const name = basename(filePath, extname(filePath));
+    // PascalCase → spaced words: "LoginPage" → "Login Page"
+    const spaced = name.replace(/([A-Z])/g, " $1").trim();
+    return `${spaced} component`;
+}
+/**
+ * Extract element description from a ScanResult context string.
+ * "JSXText inside <h1>"           → "<h1>"
+ * "\"placeholder\" attribute on <input>" → "<input>"
+ * "Template literal"              → "template literal"
+ */
+function getElementFromContext(context) {
+    const match = context.match(/<([^>]+)>/);
+    return match ? `<${match[1]}>` : context;
+}
+// ─── Deduplication ───────────────────────────────────────────────────────────
+/**
+ * Group scan results by string value.
+ * All results with the same value share one AI call.
+ * The first result in each group provides context for the AI prompt.
+ */
+export function deduplicateResults(results) {
+    const groups = new Map();
+    for (const result of results) {
+        const existing = groups.get(result.value);
+        if (existing) {
+            existing.push(result);
+        }
+        else {
+            groups.set(result.value, [result]);
+        }
+    }
+    return groups;
+}
+/**
+ * Derive a grouping key for finding sibling strings in the same component or object.
+ * "src/pages/Dashboard.tsx" + null → "src/pages/Dashboard.tsx:dashboard"
+ * "src/pages/Dashboard.tsx" + "statusConfig" → "src/pages/Dashboard.tsx:dashboard:statusConfig"
+ *
+ * For object properties, includes the object name so properties from the same
+ * object are grouped together (e.g., statusConfig.online, statusConfig.offline).
+ */
+function getContextKey(filePath, objectKey) {
+    const componentName = basename(filePath, extname(filePath)).toLowerCase();
+    let key = `${filePath}:${componentName}`;
+    if (objectKey) {
+        key += `:${objectKey}`;
+    }
+    return key;
+}
+/**
+ * Build one AIRequest per deduplicated group.
+ * Uses the first (representative) ScanResult for context.
+ * Includes related strings from the same component to guide consistent key naming.
+ */
+export function buildAIRequests(groups, config, allResults) {
+    const requests = [];
+    // Build a map of contextKey → all string values in that context
+    // Used to find sibling strings
+    const contextToValues = new Map();
+    if (allResults) {
+        for (const result of allResults) {
+            const contextKey = getContextKey(result.file, result.objectKey);
+            if (!contextToValues.has(contextKey)) {
+                contextToValues.set(contextKey, new Set());
+            }
+            contextToValues.get(contextKey).add(result.value);
+        }
+    }
+    for (const [value, results] of groups) {
+        const rep = results[0];
+        const contextKey = getContextKey(rep.file, rep.objectKey);
+        // Extract glossary entries relevant to this specific string
+        const glossary = {};
+        for (const [lang, terms] of Object.entries(config.glossary)) {
+            const term = terms[value];
+            if (term !== undefined)
+                glossary[lang] = term;
+        }
+        // Find related strings (other strings in the same component, excluding self)
+        const relatedStrings = allResults
+            ? Array.from(contextToValues.get(contextKey) ?? [])
+                .filter((v) => v !== value)
+                .sort()
+            : [];
+        const request = {
+            file: rep.file,
+            componentContext: getComponentContext(rep.file),
+            element: getElementFromContext(rep.context),
+            surroundingCode: rep.surroundingCode,
+            value,
+            keyStyle: config.keyStyle,
+            glossary,
+            targetLanguages: config.languages,
+            contextKey,
+            ...(relatedStrings.length > 0 && { relatedStrings }),
+        };
+        requests.push(request);
+    }
+    return requests;
+}
+/**
+ * Apply resolved keys back to all ScanResults.
+ * All results with the same string value get the same key.
+ */
+export function applyResolvedKeys(results, responses) {
+    return results.map((r) => ({
+        ...r,
+        resolvedKey: responses.get(r.value) ?? null,
+    }));
+}
+//# sourceMappingURL=dedup.js.map

package/dist/ai/dedup.js.map

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

package/dist/ai/index.d.ts

@@ -0,0 +1,65 @@
+import type { ScanResult, LocalizeConfig } from "../types.js";
+export interface TranslateOptions {
+    dryRun?: boolean;
+    /** Override config.overwriteExisting for this run */
+    overwrite?: boolean;
+}
+export interface TranslateResult {
+    /** Scan results updated with resolvedKey populated */
+    results: ScanResult[];
+    /** Estimated USD cost of all AI calls made */
+    aiCostUsd: number;
+    /** Absolute paths of messages JSON files written (empty if dryRun) */
+    messagesWritten: string[];
+    /** Number of unique strings sent to AI */
+    uniqueStrings: number;
+    /** Number of AI calls actually made (may be less if some were already cached externally) */
+    aiCalls: number;
+}
+/**
+ * Translate a list of scan results using the configured AI provider.
+ *
+ * Steps:
+ * 1. Deduplicate by string value
+ * 2. Build AI requests (one per unique string)
+ * 3. Call Anthropic or OpenAI
+ * 4. Assign resolvedKey back to all results
+ * 5. Write to messages/{lang}/{pageName}.json (unless dryRun)
+ */
+export declare function translateStrings(scanResults: ScanResult[], config: LocalizeConfig, apiKey: string, options?: TranslateOptions): Promise<TranslateResult>;
+export interface ExistingKeyEntry {
+    /** The i18n key, e.g. "auth.sign_in_button" */
+    key: string;
+    /** The string value in the default language */
+    value: string;
+    /** Page name derived from the JSON filename, e.g. "login" */
+    pageName: string;
+}
+export interface TranslateExistingResult {
+    translated: number;
+    aiCostUsd: number;
+    messagesWritten: string[];
+    /** Number of AI API calls made (one per unique string value) */
+    aiCalls: number;
+}
+/**
+ * Translate a list of existing (key, value, pageName) entries into target languages.
+ * Used by `localize translate --from-existing` and `localize add-lang`.
+ *
+ * Skips entries that already have translations in target languages
+ * unless `overwrite` is true.
+ */
+export declare function translateExistingKeys(entries: ExistingKeyEntry[], config: LocalizeConfig, apiKey: string, options?: {
+    dryRun?: boolean;
+    overwrite?: boolean;
+    langs?: string[];
+}): Promise<TranslateExistingResult>;
+/**
+ * Send a minimal test request to verify an API key is valid.
+ * Used by `localize init` before saving the key to ~/.localize.
+ * Returns true if the key works, false otherwise.
+ */
+export declare function validateApiKey(provider: LocalizeConfig["aiProvider"], model: string, apiKey: string): Promise<boolean>;
+export { deduplicateResults, buildAIRequests } from "./dedup.js";
+export { buildTranslationPrompt, parseAIResponse } from "./prompts.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAc,cAAc,EAAa,MAAM,aAAa,CAAC;AA+QrF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,UAAU,EAAE,EACzB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAoE1B;AAID,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GACxE,OAAO,CAAC,uBAAuB,CAAC,CAmKlC;AAID;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,cAAc,CAAC,YAAY,CAAC,EACtC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAGD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}