@babelize/engine 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * Babelize Engine v2 — public API.
+ *
+ * This folder is introduced alongside the existing v1 engine (phases/*) using a
+ * strangler-fig approach. Nothing outside v2 should import internal modules
+ * directly — only this file re-exports the public surface.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tallyLocaleIssues = exports.flattenLocaleMessages = exports.checkLocalePair = exports.frameworkSupport = exports.analyzeWorkspace = exports.analyzeProject = exports.localeExtension = exports.getCircuitBreaker = exports.CircuitState = exports.CircuitBreaker = exports.validateBatchQuality = exports.validateTranslationQuality = exports.translatorLoadBalancer = exports.warmupTranslator = exports.checkTranslatorHealth = exports.callTranslator = exports.requiredPluralCategories = exports.parseIcu = exports.isIcuMessage = exports.compareIcuMessages = exports.sameProtectedSpans = exports.restoreText = exports.protectText = exports.hasNothingToTranslate = exports.checkTokens = exports.validateRawTokens = exports.sanitizeTranslation = exports.restorePlaceholders = exports.protectPlaceholders = exports.hashString = exports.hasICUSyntax = exports.extractPlaceholders = exports.parseCode = exports.saveProjectConfig = exports.saveCachedStrings = exports.getProjectInfo = exports.getBabelizeSummary = exports.detectProjectInfo = exports.addBabelToHistory = exports.formatSyncNotificationMessage = exports.detectSyncIssues = exports.matchFromMemory = exports.setEngineLogger = exports.runWithEngineLogger = exports.validateWorkspace = exports.scanKeyReferences = exports.validateEngineConfigV2 = exports.runEngineV2 = exports.loadBabelizeConfig = exports.BabelizeEngine = void 0;
+exports.TRANSLATION_CACHE_TTL_SECONDS = exports.translationCacheKey = exports.hashText = exports.readProjectLocaleConfig = exports.localeIssueFile = exports.checkProjectLocales = exports.ReviewError = exports.reviewLocaleChanges = exports.loadLocale = exports.isLocaleCode = exports.isIgnoredLocalePath = exports.groupLocaleFiles = exports.findLocaleFileSets = exports.DEFAULT_LOCALE_IGNORE_DIRS = void 0;
+var BabelizeEngine_1 = require("./BabelizeEngine");
+Object.defineProperty(exports, "BabelizeEngine", { enumerable: true, get: function () { return BabelizeEngine_1.BabelizeEngine; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "loadBabelizeConfig", { enumerable: true, get: function () { return config_1.loadBabelizeConfig; } });
+// Backend runtime surface (workers/controllers).
+var runtime_1 = require("./runtime");
+Object.defineProperty(exports, "runEngineV2", { enumerable: true, get: function () { return runtime_1.runEngineV2; } });
+Object.defineProperty(exports, "validateEngineConfigV2", { enumerable: true, get: function () { return runtime_1.validateEngineConfigV2; } });
+var key_usage_1 = require("./utils/key-usage");
+Object.defineProperty(exports, "scanKeyReferences", { enumerable: true, get: function () { return key_usage_1.scanKeyReferences; } });
+// Framework detection without running the pipeline (CLI `translate` uses it
+// to refuse unsupported projects before spending any LLM calls).
+var workspace_1 = require("./modules/workspace");
+Object.defineProperty(exports, "validateWorkspace", { enumerable: true, get: function () { return workspace_1.validateWorkspace; } });
+// ── Providers (infrastructure the host injects) ──────────────
+__exportStar(require("./providers"), exports);
+var logger_1 = require("./utils/logger");
+Object.defineProperty(exports, "runWithEngineLogger", { enumerable: true, get: function () { return logger_1.runWithEngineLogger; } });
+Object.defineProperty(exports, "setEngineLogger", { enumerable: true, get: function () { return logger_1.setEngineLogger; } });
+// ── Pipeline pieces the backend uses directly ────────────────
+__exportStar(require("./modules/lockfile"), exports);
+__exportStar(require("./modules/translator/language-codes"), exports);
+var memory_matcher_1 = require("./modules/translator/memory/memory-matcher");
+Object.defineProperty(exports, "matchFromMemory", { enumerable: true, get: function () { return memory_matcher_1.matchFromMemory; } });
+var sync_detector_1 = require("./modules/sync-detector");
+Object.defineProperty(exports, "detectSyncIssues", { enumerable: true, get: function () { return sync_detector_1.detectSyncIssues; } });
+Object.defineProperty(exports, "formatSyncNotificationMessage", { enumerable: true, get: function () { return sync_detector_1.formatSyncNotificationMessage; } });
+// ── Utilities shared with the backend ────────────────────────
+var metadata_1 = require("./utils/metadata");
+Object.defineProperty(exports, "addBabelToHistory", { enumerable: true, get: function () { return metadata_1.addBabelToHistory; } });
+Object.defineProperty(exports, "detectProjectInfo", { enumerable: true, get: function () { return metadata_1.detectProjectInfo; } });
+Object.defineProperty(exports, "getBabelizeSummary", { enumerable: true, get: function () { return metadata_1.getBabelizeSummary; } });
+Object.defineProperty(exports, "getProjectInfo", { enumerable: true, get: function () { return metadata_1.getProjectInfo; } });
+Object.defineProperty(exports, "saveCachedStrings", { enumerable: true, get: function () { return metadata_1.saveCachedStrings; } });
+Object.defineProperty(exports, "saveProjectConfig", { enumerable: true, get: function () { return metadata_1.saveProjectConfig; } });
+var ast_helpers_1 = require("./utils/ast-helpers");
+Object.defineProperty(exports, "parseCode", { enumerable: true, get: function () { return ast_helpers_1.parseCode; } });
+var string_utils_1 = require("./utils/string-utils");
+Object.defineProperty(exports, "extractPlaceholders", { enumerable: true, get: function () { return string_utils_1.extractPlaceholders; } });
+Object.defineProperty(exports, "hasICUSyntax", { enumerable: true, get: function () { return string_utils_1.hasICUSyntax; } });
+Object.defineProperty(exports, "hashString", { enumerable: true, get: function () { return string_utils_1.hashString; } });
+Object.defineProperty(exports, "protectPlaceholders", { enumerable: true, get: function () { return string_utils_1.protectPlaceholders; } });
+Object.defineProperty(exports, "restorePlaceholders", { enumerable: true, get: function () { return string_utils_1.restorePlaceholders; } });
+var translation_sanitizer_1 = require("./utils/translation-sanitizer");
+Object.defineProperty(exports, "sanitizeTranslation", { enumerable: true, get: function () { return translation_sanitizer_1.sanitizeTranslation; } });
+Object.defineProperty(exports, "validateRawTokens", { enumerable: true, get: function () { return translation_sanitizer_1.validateRawTokens; } });
+var placeholder_protection_1 = require("./utils/placeholder-protection");
+Object.defineProperty(exports, "checkTokens", { enumerable: true, get: function () { return placeholder_protection_1.checkTokens; } });
+Object.defineProperty(exports, "hasNothingToTranslate", { enumerable: true, get: function () { return placeholder_protection_1.hasNothingToTranslate; } });
+Object.defineProperty(exports, "protectText", { enumerable: true, get: function () { return placeholder_protection_1.protectText; } });
+Object.defineProperty(exports, "restoreText", { enumerable: true, get: function () { return placeholder_protection_1.restoreText; } });
+Object.defineProperty(exports, "sameProtectedSpans", { enumerable: true, get: function () { return placeholder_protection_1.sameProtectedSpans; } });
+var icu_message_1 = require("./utils/icu-message");
+Object.defineProperty(exports, "compareIcuMessages", { enumerable: true, get: function () { return icu_message_1.compareIcuMessages; } });
+Object.defineProperty(exports, "isIcuMessage", { enumerable: true, get: function () { return icu_message_1.isIcuMessage; } });
+Object.defineProperty(exports, "parseIcu", { enumerable: true, get: function () { return icu_message_1.parseIcu; } });
+Object.defineProperty(exports, "requiredPluralCategories", { enumerable: true, get: function () { return icu_message_1.requiredPluralCategories; } });
+var translator_caller_1 = require("./utils/translator-caller");
+Object.defineProperty(exports, "callTranslator", { enumerable: true, get: function () { return translator_caller_1.callTranslator; } });
+Object.defineProperty(exports, "checkTranslatorHealth", { enumerable: true, get: function () { return translator_caller_1.checkTranslatorHealth; } });
+Object.defineProperty(exports, "warmupTranslator", { enumerable: true, get: function () { return translator_caller_1.warmupTranslator; } });
+var translator_load_balancer_1 = require("./utils/translator-load-balancer");
+Object.defineProperty(exports, "translatorLoadBalancer", { enumerable: true, get: function () { return translator_load_balancer_1.translatorLoadBalancer; } });
+var translation_quality_1 = require("./utils/translation-quality");
+Object.defineProperty(exports, "validateTranslationQuality", { enumerable: true, get: function () { return translation_quality_1.validateTranslationQuality; } });
+Object.defineProperty(exports, "validateBatchQuality", { enumerable: true, get: function () { return translation_quality_1.validateBatchQuality; } });
+var circuit_breaker_1 = require("./utils/circuit-breaker");
+Object.defineProperty(exports, "CircuitBreaker", { enumerable: true, get: function () { return circuit_breaker_1.CircuitBreaker; } });
+Object.defineProperty(exports, "CircuitState", { enumerable: true, get: function () { return circuit_breaker_1.CircuitState; } });
+Object.defineProperty(exports, "getCircuitBreaker", { enumerable: true, get: function () { return circuit_breaker_1.getCircuitBreaker; } });
+var file_utils_1 = require("./utils/file-utils");
+Object.defineProperty(exports, "localeExtension", { enumerable: true, get: function () { return file_utils_1.localeExtension; } });
+// ── Local analysis and locale QA (no translation, no network) ──
+var analyze_1 = require("./analysis/analyze");
+Object.defineProperty(exports, "analyzeProject", { enumerable: true, get: function () { return analyze_1.analyzeProject; } });
+Object.defineProperty(exports, "analyzeWorkspace", { enumerable: true, get: function () { return analyze_1.analyzeWorkspace; } });
+Object.defineProperty(exports, "frameworkSupport", { enumerable: true, get: function () { return analyze_1.frameworkSupport; } });
+var locale_qa_1 = require("./qa/locale-qa");
+Object.defineProperty(exports, "checkLocalePair", { enumerable: true, get: function () { return locale_qa_1.checkLocalePair; } });
+Object.defineProperty(exports, "flattenLocaleMessages", { enumerable: true, get: function () { return locale_qa_1.flattenLocaleMessages; } });
+Object.defineProperty(exports, "tallyLocaleIssues", { enumerable: true, get: function () { return locale_qa_1.tallyLocaleIssues; } });
+var locale_files_1 = require("./qa/locale-files");
+Object.defineProperty(exports, "DEFAULT_LOCALE_IGNORE_DIRS", { enumerable: true, get: function () { return locale_files_1.DEFAULT_LOCALE_IGNORE_DIRS; } });
+Object.defineProperty(exports, "findLocaleFileSets", { enumerable: true, get: function () { return locale_files_1.findLocaleFileSets; } });
+Object.defineProperty(exports, "groupLocaleFiles", { enumerable: true, get: function () { return locale_files_1.groupLocaleFiles; } });
+Object.defineProperty(exports, "isIgnoredLocalePath", { enumerable: true, get: function () { return locale_files_1.isIgnoredLocalePath; } });
+Object.defineProperty(exports, "isLocaleCode", { enumerable: true, get: function () { return locale_files_1.isLocaleCode; } });
+Object.defineProperty(exports, "loadLocale", { enumerable: true, get: function () { return locale_files_1.loadLocale; } });
+var review_1 = require("./qa/review");
+Object.defineProperty(exports, "reviewLocaleChanges", { enumerable: true, get: function () { return review_1.reviewLocaleChanges; } });
+Object.defineProperty(exports, "ReviewError", { enumerable: true, get: function () { return review_1.ReviewError; } });
+var check_project_1 = require("./qa/check-project");
+Object.defineProperty(exports, "checkProjectLocales", { enumerable: true, get: function () { return check_project_1.checkProjectLocales; } });
+Object.defineProperty(exports, "localeIssueFile", { enumerable: true, get: function () { return check_project_1.localeIssueFile; } });
+Object.defineProperty(exports, "readProjectLocaleConfig", { enumerable: true, get: function () { return check_project_1.readProjectLocaleConfig; } });
+var cache_keys_1 = require("./utils/cache-keys");
+Object.defineProperty(exports, "hashText", { enumerable: true, get: function () { return cache_keys_1.hashText; } });
+Object.defineProperty(exports, "translationCacheKey", { enumerable: true, get: function () { return cache_keys_1.translationCacheKey; } });
+Object.defineProperty(exports, "TRANSLATION_CACHE_TTL_SECONDS", { enumerable: true, get: function () { return cache_keys_1.TRANSLATION_CACHE_TTL_SECONDS; } });
+// ── Local translation runner (CLI `babelize translate`, MCP `babelize_translate`) ──
+__exportStar(require("./local"), exports);

package/dist/injection/InjectionStrategy.d.ts

@@ -0,0 +1,62 @@
+import * as t from '@babel/types';
+import type { JsxMessage } from '../utils/jsx-message';
+export interface MessageOptions {
+    /** Local name for react-i18next's Trans (`BabelizeTrans` when the file already binds `Trans`). */
+    transName?: string;
+}
+/** What a strategy renders for a JSX sentence message. */
+export interface MessageRendering {
+    /** Replaces the element's children. */
+    node: t.JSXExpressionContainer | t.JSXElement;
+    /** Named imports the rendering needs, e.g. `Trans` from react-i18next (`local` when aliased). */
+    imports?: Array<{
+        source: string;
+        name: string;
+        local?: string;
+    }>;
+}
+export interface InjectionContext {
+    filePath: string;
+    isComponent: boolean;
+    hasUseClient: boolean;
+    /** The component the hook goes into is already `async` (set per component). */
+    isAsyncComponent?: boolean;
+}
+export interface InjectionStrategy {
+    /**
+     * Framework identifier
+     */
+    id: string;
+    /**
+     * Determine if an import is already present in the AST
+     */
+    hasImport(ast: t.File): boolean;
+    /**
+     * Create the AST node for the import declaration
+     */
+    createImport(context?: InjectionContext): t.ImportDeclaration;
+    /**
+     * Determine if the hook/setup is already present in the component body
+     */
+    hasHook(componentPath: any): boolean;
+    /**
+     * Create the AST node(s) for the hook declaration
+     * Context allows handling async/await for server components
+     */
+    createHook(context: InjectionContext): t.Statement[];
+    /**
+     * Return the identifier name used for translation (typically 't')
+     */
+    getTranslationFunctionName(): string;
+    /**
+     * Does the hook require the component function to be async?
+     */
+    requiresAsyncComponent(context: InjectionContext): boolean;
+    /**
+     * Render a JSX sentence (named placeholders, inline tags) for `key`, e.g.
+     * `{t("key", { user })}`. Null when the strategy can't express it (rich
+     * text without a component API) — the sentence is then left as is and
+     * reported as not injected. Strategies without it render placeholders only.
+     */
+    createMessage?(key: string, message: JsxMessage, options?: MessageOptions): MessageRendering | null;
+}

package/dist/injection/InjectionStrategy.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/injection/StrategyFactory.d.ts

@@ -0,0 +1,4 @@
+import { InjectionStrategy } from './InjectionStrategy';
+export declare class StrategyFactory {
+    static getStrategy(framework: string, existingDeps?: Record<string, string>): InjectionStrategy;
+}

package/dist/injection/StrategyFactory.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StrategyFactory = void 0;
+const ReactI18nextStrategy_1 = require("./strategies/ReactI18nextStrategy");
+const NextIntlStrategy_1 = require("./strategies/NextIntlStrategy");
+const VanillaStrategy_1 = require("./strategies/VanillaStrategy");
+const VueI18nStrategy_1 = require("./strategies/VueI18nStrategy");
+class StrategyFactory {
+    static getStrategy(framework, existingDeps) {
+        if (existingDeps?.['react-i18next']) {
+            return new ReactI18nextStrategy_1.ReactI18nextStrategy();
+        }
+        if (existingDeps?.['next-intl']) {
+            return new NextIntlStrategy_1.NextIntlStrategy();
+        }
+        switch (framework) {
+            case 'nextjs':
+                return new NextIntlStrategy_1.NextIntlStrategy();
+            case 'react':
+                return new ReactI18nextStrategy_1.ReactI18nextStrategy();
+            case 'vue':
+                return new VueI18nStrategy_1.VueI18nStrategy();
+            case 'unknown':
+            default:
+                return new VanillaStrategy_1.VanillaStrategy();
+        }
+    }
+}
+exports.StrategyFactory = StrategyFactory;

package/dist/injection/django/django-template-injector.d.ts

@@ -0,0 +1,29 @@
+import type { FileInjection } from '../../runtime/types';
+export interface DjangoInjectorOptions {
+    /** The masked HTML content after standard HTML injection has run */
+    maskedContent: string;
+    /** The restore function from dtl-mask to undo masking */
+    restore: (masked: string) => string;
+    /** Path of the file being processed */
+    filePath: string;
+    /** Mapping from extraction ID to translation key */
+    keyMapping: Map<string, string>;
+    /** Original unmodified source content for comparison */
+    sourceContent: string;
+}
+/**
+ * Convert data-i18n attributes to Django {% trans %} tags.
+ *
+ * For pure text elements:
+ *   <p data-i18n="hello">Hello</p>  →  <p>{% trans "hello" %}</p>
+ *
+ * For mixed content (elements with both text and child elements):
+ *   <p data-i18n="hello">Hello <em>world</em></p>  →
+ *   <p>{% blocktrans %}Hello <em>world</em>{% endblocktrans %}</p>
+ *   (blocktrans wraps the raw inner HTML)
+ *
+ * For attribute translations:
+ *   <input data-i18n-placeholder="ph_key" placeholder="Search...">  →
+ *   <input placeholder="{% trans "ph_key" %}">
+ */
+export declare function injectDjangoTemplates(options: DjangoInjectorOptions): Promise<FileInjection>;

package/dist/injection/django/django-template-injector.js

@@ -0,0 +1,216 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.injectDjangoTemplates = injectDjangoTemplates;
+function asElement(node) {
+    return node.nodeType === 1 ? node : null;
+}
+/**
+ * Convert data-i18n attributes to Django {% trans %} tags.
+ *
+ * For pure text elements:
+ *   <p data-i18n="hello">Hello</p>  →  <p>{% trans "hello" %}</p>
+ *
+ * For mixed content (elements with both text and child elements):
+ *   <p data-i18n="hello">Hello <em>world</em></p>  →
+ *   <p>{% blocktrans %}Hello <em>world</em>{% endblocktrans %}</p>
+ *   (blocktrans wraps the raw inner HTML)
+ *
+ * For attribute translations:
+ *   <input data-i18n-placeholder="ph_key" placeholder="Search...">  →
+ *   <input placeholder="{% trans "ph_key" %}">
+ */
+async function injectDjangoTemplates(options) {
+    const { maskedContent, restore, filePath, keyMapping } = options;
+    const { parse } = await Promise.resolve().then(() => __importStar(require('node-html-parser')));
+    const injections = [];
+    const importAdded = false;
+    const hookAdded = false;
+    // Parse the masked + injected HTML
+    const root = parse(maskedContent, {
+        comment: false,
+        blockTextElements: { script: true, style: true, noscript: true, pre: true },
+    });
+    const htmlEl = root.querySelector('html');
+    if (!htmlEl) {
+        return {
+            file: filePath,
+            originalContent: options.sourceContent,
+            modifiedContent: restore(maskedContent),
+            injections,
+            importAdded,
+            hookAdded,
+        };
+    }
+    walkAndInject(htmlEl, filePath, options.sourceContent, keyMapping, injections);
+    let modifiedContent = root.toString();
+    // Remove the i18n.js script tag injected by HTML pipeline — Django uses {% trans %} not client JS
+    modifiedContent = modifiedContent.replace(/<script[^>]*src\s*=\s*["']i18n\.js["'][^>]*>\s*<\/script>\s*\n?/g, '');
+    // Add {% load i18n %} after any {% extends %} tag (DTL requires extends first)
+    modifiedContent = ensureI18nLoad(modifiedContent);
+    // Restore template tags
+    modifiedContent = restore(modifiedContent);
+    return {
+        file: filePath,
+        originalContent: options.sourceContent,
+        modifiedContent,
+        injections,
+        importAdded,
+        hookAdded,
+    };
+}
+function walkAndInject(node, filePath, sourceContent, keyMapping, injections) {
+    const element = asElement(node);
+    if (!element)
+        return;
+    const rawTagName = element.rawTagName?.toLowerCase();
+    if (!rawTagName)
+        return;
+    if (['script', 'style', 'noscript', 'code', 'pre', 'svg'].includes(rawTagName))
+        return;
+    // Handle data-i18n on this element
+    const i18nKey = element.getAttribute('data-i18n');
+    if (i18nKey) {
+        convertDataI18nToTransTag(element, i18nKey, filePath, sourceContent, injections);
+    }
+    // Handle data-i18n-{attr} for attribute translations
+    convertDataI18nAttrTags(element, filePath, sourceContent, injections);
+    // Recurse into children
+    for (const child of node.childNodes || []) {
+        if (child.nodeType === 1) {
+            walkAndInject(child, filePath, sourceContent, keyMapping, injections);
+        }
+    }
+}
+function convertDataI18nToTransTag(element, key, filePath, sourceContent, injections) {
+    const line = element.range
+        ? (sourceContent.slice(0, element.range[0]).match(/\n/g) || []).length + 1
+        : 0;
+    // Remove the data-i18n attribute
+    element.removeAttribute('data-i18n');
+    const children = element.childNodes || [];
+    const hasElementChildren = children.some((c) => c.nodeType === 1);
+    if (hasElementChildren) {
+        // Mixed content: use blocktrans / endblocktrans
+        // Preserve inner HTML and wrap with blocktrans
+        const innerHtml = children
+            .map((c) => (c.nodeType === 1 ? c.toString() : c.toString()))
+            .join('');
+        // Replace children with raw blocktrans content
+        element.childNodes = [];
+        // node-html-parser doesn't support raw HTML children directly,
+        // so we set innerHTML which parses and inserts
+        element.innerHTML = `{% blocktrans %}${innerHtml}{% endblocktrans %}`;
+        injections.push({
+            file: filePath,
+            line,
+            column: 0,
+            original: innerHtml.trim(),
+            replacement: `{% blocktrans %}${innerHtml}{% endblocktrans %}`,
+            key,
+            confidence: 100,
+        });
+    }
+    else {
+        // Pure text content: use {% trans "key" %}
+        const text = children
+            .map((c) => c.toString())
+            .join('')
+            .trim();
+        element.childNodes = [];
+        element.innerHTML = `{% trans "${key}" %}`;
+        injections.push({
+            file: filePath,
+            line,
+            column: 0,
+            original: text,
+            replacement: `{% trans "${key}" %}`,
+            key,
+            confidence: 100,
+        });
+    }
+}
+function convertDataI18nAttrTags(element, filePath, sourceContent, injections) {
+    const i18nAttrs = [
+        'data-i18n-title',
+        'data-i18n-placeholder',
+        'data-i18n-alt',
+        'data-i18n-aria-label',
+        'data-i18n-aria-description',
+    ];
+    for (const dataAttr of i18nAttrs) {
+        const key = element.getAttribute(dataAttr);
+        if (!key)
+            continue;
+        // Extract the target attribute name: "data-i18n-placeholder" → "placeholder"
+        const attrSuffix = dataAttr.replace('data-i18n-', '');
+        const originalValue = element.getAttribute(attrSuffix) || '';
+        element.removeAttribute(dataAttr);
+        const line = element.range
+            ? (sourceContent.slice(0, element.range[0]).match(/\n/g) || []).length + 1
+            : 0;
+        // Replace attribute value with {% trans "key" %}
+        element.setAttribute(attrSuffix, `{% trans "${key}" %}`);
+        injections.push({
+            file: filePath,
+            line,
+            column: 0,
+            original: originalValue,
+            replacement: `{% trans "${key}" %}`,
+            key,
+            confidence: 100,
+        });
+    }
+}
+/**
+ * Ensure {% load i18n %} is present in the template.
+ * DTL requires it after any {% extends %} tag (at the top of the template
+ * but after extends).
+ */
+function ensureI18nLoad(content) {
+    if (/{%\s*load\s+i18n\s*%}/i.test(content)) {
+        return content;
+    }
+    // If there's an extends tag, insert load right after the last extends
+    const extendsMatch = content.match(/({%\s*extends\s+.*?%\})\s*\n?/s);
+    if (extendsMatch) {
+        const lastExtendsEnd = content.indexOf(extendsMatch[0]) + extendsMatch[0].length;
+        return (content.slice(0, lastExtendsEnd) +
+            '\n{% load i18n %}\n' +
+            content.slice(lastExtendsEnd));
+    }
+    // No extends: insert at the very top
+    return '{% load i18n %}\n' + content;
+}

package/dist/injection/html/html-injector.d.ts

@@ -0,0 +1,11 @@
+import type { FileInjection } from '../../runtime/types';
+interface HtmlInjectOptions {
+    content: string;
+    filePath: string;
+    keyMapping: Map<string, string>;
+    injectSwitcher?: boolean;
+    targetLocales?: string[];
+    sourceLocale?: string;
+}
+export declare function injectHtml(options: HtmlInjectOptions): Promise<FileInjection>;
+export {};

package/dist/injection/html/html-injector.js

@@ -0,0 +1,173 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.injectHtml = injectHtml;
+const string_utils_1 = require("../../utils/string-utils");
+const html_extractor_1 = require("../../utils/html-extractor");
+function asElement(node) {
+    return node.nodeType === 1 ? node : null;
+}
+function walkHtmlNode(node, filePath, content, keyMapping, matchedIds, injections) {
+    const tagName = node.rawTagName?.toLowerCase();
+    if (!tagName)
+        return;
+    if (['script', 'style', 'noscript', 'code', 'pre', 'svg'].includes(tagName))
+        return;
+    const translatableAttrs = ['alt', 'title', 'placeholder', 'aria-label', 'aria-description'];
+    const children = node.childNodes || [];
+    let textChild = null;
+    let nonTextChild = false;
+    for (const child of children) {
+        if ((0, html_extractor_1.isTextNode)(child)) {
+            if (child.text.trim()) {
+                textChild = child;
+            }
+        }
+        else {
+            nonTextChild = true;
+        }
+    }
+    const element = asElement(node);
+    if (textChild && !nonTextChild && element && !element.getAttribute('data-i18n')) {
+        const text = textChild.text.trim();
+        if (node.range) {
+            const line = (content.slice(0, node.range[0]).match(/\n/g) || []).length + 1;
+            const id = `${filePath}:${line}:${(0, string_utils_1.hashString)(text)}`;
+            if (matchedIds.has(id)) {
+                const key = keyMapping.get(id);
+                if (key) {
+                    element.setAttribute('data-i18n', key);
+                    injections.push({
+                        file: filePath,
+                        line,
+                        column: 0,
+                        original: text,
+                        replacement: `data-i18n="${key}"`,
+                        key,
+                        confidence: 100,
+                    });
+                }
+            }
+        }
+    }
+    else if (nonTextChild && element && !element.getAttribute('data-i18n')) {
+        for (const child of children) {
+            if (!(0, html_extractor_1.isTextNode)(child) || !child.text.trim())
+                continue;
+            const text = child.text.trim();
+            if (node.range) {
+                const line = (content.slice(0, node.range[0]).match(/\n/g) || []).length + 1;
+                const id = `${filePath}:${line}:${(0, string_utils_1.hashString)(text)}`;
+                if (matchedIds.has(id)) {
+                    const key = keyMapping.get(id);
+                    if (key) {
+                        element.setAttribute('data-i18n', key);
+                        injections.push({
+                            file: filePath,
+                            line,
+                            column: 0,
+                            original: text,
+                            replacement: `data-i18n="${key}"`,
+                            key,
+                            confidence: 100,
+                        });
+                        break;
+                    }
+                }
+            }
+        }
+    }
+    if (!element)
+        return;
+    for (const attr of translatableAttrs) {
+        const value = element.getAttribute(attr);
+        if (!value)
+            continue;
+        if (element.getAttribute(`data-i18n-${attr}`))
+            continue;
+        if (!node.range)
+            continue;
+        const line = (content.slice(0, node.range[0]).match(/\n/g) || []).length + 1;
+        const id = `${filePath}:${line}:${(0, string_utils_1.hashString)(value)}`;
+        if (matchedIds.has(id)) {
+            const key = keyMapping.get(id);
+            if (key) {
+                element.setAttribute(`data-i18n-${attr}`, key);
+                injections.push({
+                    file: filePath,
+                    line,
+                    column: 0,
+                    original: value,
+                    replacement: `data-i18n-${attr}="${key}"`,
+                    key,
+                    confidence: 100,
+                });
+            }
+        }
+    }
+    for (const child of children) {
+        if (child.nodeType === 1) {
+            walkHtmlNode(child, filePath, content, keyMapping, matchedIds, injections);
+        }
+    }
+}
+async function injectHtml(options) {
+    const { content, filePath, keyMapping } = options;
+    const { parse } = await Promise.resolve().then(() => __importStar(require('node-html-parser')));
+    const injections = [];
+    let importAdded = false;
+    const root = parse(content, {
+        comment: false,
+        blockTextElements: { script: true, style: true, noscript: true, pre: true },
+    });
+    const htmlEl = root.querySelector('html');
+    if (!htmlEl) {
+        return { file: filePath, originalContent: content, modifiedContent: content, injections, importAdded, hookAdded: false };
+    }
+    const matchedIds = new Set(keyMapping.keys());
+    walkHtmlNode(htmlEl, filePath, content, keyMapping, matchedIds, injections);
+    let modifiedContent = root.toString();
+    const hasScript = /<script[^>]*src\s*=\s*["']i18n\.js["'][^>]*>/.test(modifiedContent);
+    if (!hasScript) {
+        if (modifiedContent.includes('</body>')) {
+            modifiedContent = modifiedContent.replace('</body>', '  <script src="i18n.js"></script>\n</body>');
+        }
+        else {
+            modifiedContent = modifiedContent.replace('</head>', '  <script src="i18n.js"></script>\n</head>');
+        }
+        importAdded = true;
+    }
+    return { file: filePath, originalContent: content, modifiedContent, injections, importAdded, hookAdded: false };
+}