@babelize/engine 0.0.0-stage → 0.1.2

package/dist/django/types.d.ts

@@ -0,0 +1,49 @@
+/** Shared types for the Django (gettext) pipeline. */
+export interface GettextMessage {
+    msgid: string;
+    msgidPlural?: string;
+    msgctxt?: string;
+    /** PO flags such as python-format / python-brace-format. */
+    flags: string[];
+    /** Translator comments (`#.` in the PO file). */
+    comments: string[];
+}
+/** A hardcoded string the injector can wrap. */
+export interface PythonEdit {
+    kind: 'python';
+    start: number;
+    end: number;
+    /** Evaluated at import time (module/class level): needs gettext_lazy. */
+    lazy: boolean;
+    /** Argument text placed inside the gettext call. */
+    inner: string;
+    /** Text appended after the call, e.g. ` % {"count": count}`. */
+    suffix: string;
+}
+export interface TemplateEdit {
+    kind: 'template';
+    start: number;
+    end: number;
+    replacement: string;
+}
+export interface DjangoFinding {
+    message: GettextMessage;
+    /** 1-based line of the string in the original file. */
+    line: number;
+    /** Already marked for translation in the code (gettext call, trans tag). */
+    wrapped: boolean;
+    /** How to mark a hardcoded string (absent for wrapped strings). */
+    edit?: PythonEdit | TemplateEdit;
+}
+export interface DjangoUnwired {
+    line: number;
+    text: string;
+    reason: string;
+}
+export interface DjangoFileAnalysis {
+    findings: DjangoFinding[];
+    /** User-facing text found but deliberately not wrapped, with why. */
+    unwired: DjangoUnwired[];
+}
+/** PO format flags for a message, the way xgettext would mark it. */
+export declare function formatFlags(...texts: Array<string | undefined>): string[];

package/dist/django/types.js

@@ -0,0 +1,15 @@
+"use strict";
+/** Shared types for the Django (gettext) pipeline. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatFlags = formatFlags;
+const PYTHON_FORMAT = /%(?:\(\w+\))?[sdif]/;
+const BRACE_FORMAT = /\{(?:\w+(?:\.\w+|\[\w+\])*)?(?:![rsa])?(?::[^{}]*)?\}/;
+/** PO format flags for a message, the way xgettext would mark it. */
+function formatFlags(...texts) {
+    const all = texts.filter((t) => !!t).map((t) => t.replace(/%%/g, ''));
+    if (all.some((t) => PYTHON_FORMAT.test(t)))
+        return ['python-format'];
+    if (all.some((t) => BRACE_FORMAT.test(t.replace(/\{\{|\}\}/g, ''))))
+        return ['python-brace-format'];
+    return [];
+}

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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.
+ */
+export { BabelizeEngine } from './BabelizeEngine';
+export type { BabelizeConfig, BabelizeEngineDependencies, BabelRunResult, ExtractedString, TranslationResult, TranslationUnit, } from './types';
+export { loadBabelizeConfig } from './config';
+export { runEngineV2, validateEngineConfigV2 } from './runtime';
+export { RunAbortedError } from './orchestrator';
+export type { EngineConfigV2, EngineResultV2 } from './runtime';
+export type { KeyUsageReport, ProcessingStats } from './runtime/types';
+export { scanKeyReferences } from './utils/key-usage';
+export { validateWorkspace } from './modules/workspace';
+export * from './providers';
+export { runWithEngineLogger, setEngineLogger } from './utils/logger';
+export type { EngineLogger, LogContext } from './utils/logger';
+export * from './modules/lockfile';
+export * from './modules/translator/language-codes';
+export type { MemoryEntry, FuzzyMatch, MemoryLookupResult } from './modules/translator/memory/types';
+export { matchFromMemory } from './modules/translator/memory/memory-matcher';
+export { detectSyncIssues, formatSyncNotificationMessage } from './modules/sync-detector';
+export type { SyncDetectionResult, SyncDetectedString, SyncMissingLocaleKey } from './modules/sync-detector';
+export type { TranslationEntry, WorkspaceInfo } from './runtime/types';
+export { addBabelToHistory, detectProjectInfo, getBabelizeSummary, getProjectInfo, saveCachedStrings, saveProjectConfig, } from './utils/metadata';
+export type { BabelHistoryEntry, ExtractedStringEntry, ProjectInfo } from './utils/metadata';
+export { detectStack, localRepoFiles, FRAMEWORK_DISPLAY_NAMES } from './detection/stack';
+export type { DetectedStack, RepoFiles, StackFramework, PackageManagerId } from './detection/stack';
+export { parseCode } from './utils/ast-helpers';
+export { extractPlaceholders, hasICUSyntax, hashString, protectPlaceholders, restorePlaceholders, } from './utils/string-utils';
+export { sanitizeTranslation, validateRawTokens } from './utils/translation-sanitizer';
+export { checkTokens, hasNothingToTranslate, protectText, restoreText, sameProtectedSpans } from './utils/placeholder-protection';
+export type { ProtectedText, TokenCheck } from './utils/placeholder-protection';
+export { compareIcuMessages, isIcuMessage, parseIcu, requiredPluralCategories } from './utils/icu-message';
+export type { IcuIssue, IcuNode } from './utils/icu-message';
+export { callTranslator, checkTranslatorHealth, warmupTranslator } from './utils/translator-caller';
+export { translatorLoadBalancer } from './utils/translator-load-balancer';
+export type { TranslatorEndpoint } from './utils/translator-load-balancer';
+export { validateTranslationQuality, validateBatchQuality } from './utils/translation-quality';
+export type { QualityIssue, QualityResult } from './utils/translation-quality';
+export { CircuitBreaker, CircuitState, getCircuitBreaker } from './utils/circuit-breaker';
+export type { CircuitBreakerOptions } from './utils/circuit-breaker';
+export { localeExtension } from './utils/file-utils';
+export { analyzeProject, analyzeWorkspace, frameworkSupport, } from './analysis/analyze';
+export type { AnalyzeOptions, AnalyzedString, FrameworkSupport, ProjectAnalysis } from './analysis/analyze';
+export { checkLocalePair, flattenLocaleMessages, tallyLocaleIssues } from './qa/locale-qa';
+export { canonicalLocale, canonicalizeLocaleKeys, containsTerm, localeValue, normalizeGlossary, glossaryFingerprint, } from './modules/glossary';
+export type { GlossaryRules, GlossaryRuleInput } from './modules/glossary';
+export type { LocaleGlossary, LocaleIssue, LocaleIssueCode, LocaleIssueSeverity, LocalePairOptions, LocalePairReport, } from './qa/locale-qa';
+export { DEFAULT_LOCALE_IGNORE_DIRS, findLocaleFileSets, groupLocaleFiles, isIgnoredLocalePath, isLocaleCode, loadLocale } from './qa/locale-files';
+export type { FindLocaleOptions, LoadedLocale, LocaleFileSet, ProjectFileReader } from './qa/locale-files';
+export { reviewLocaleChanges, ReviewError } from './qa/review';
+export type { LocaleChangeReview, LocaleSetChangeReview, ReviewOptions } from './qa/review';
+export { checkProjectLocales, localeIssueFile, readProjectLocaleConfig } from './qa/check-project';
+export type { CheckProjectOptions, LocaleSetReport, ProjectLocaleCheck, ProjectLocaleConfig } from './qa/check-project';
+export { hashText, translationCacheKey, TRANSLATION_CACHE_TTL_SECONDS } from './utils/cache-keys';
+export * from './local';

package/dist/index.js

@@ -0,0 +1,140 @@
+"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.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.FRAMEWORK_DISPLAY_NAMES = exports.localRepoFiles = exports.detectStack = 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.RunAbortedError = 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 = exports.glossaryFingerprint = exports.normalizeGlossary = exports.localeValue = exports.containsTerm = exports.canonicalizeLocaleKeys = exports.canonicalLocale = exports.tallyLocaleIssues = exports.flattenLocaleMessages = exports.checkLocalePair = exports.frameworkSupport = 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 orchestrator_1 = require("./orchestrator");
+Object.defineProperty(exports, "RunAbortedError", { enumerable: true, get: function () { return orchestrator_1.RunAbortedError; } });
+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 stack_1 = require("./detection/stack");
+Object.defineProperty(exports, "detectStack", { enumerable: true, get: function () { return stack_1.detectStack; } });
+Object.defineProperty(exports, "localRepoFiles", { enumerable: true, get: function () { return stack_1.localRepoFiles; } });
+Object.defineProperty(exports, "FRAMEWORK_DISPLAY_NAMES", { enumerable: true, get: function () { return stack_1.FRAMEWORK_DISPLAY_NAMES; } });
+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; } });
+// Glossary rules: term matching, locale lookup/canonicalization, conflicts.
+var glossary_1 = require("./modules/glossary");
+Object.defineProperty(exports, "canonicalLocale", { enumerable: true, get: function () { return glossary_1.canonicalLocale; } });
+Object.defineProperty(exports, "canonicalizeLocaleKeys", { enumerable: true, get: function () { return glossary_1.canonicalizeLocaleKeys; } });
+Object.defineProperty(exports, "containsTerm", { enumerable: true, get: function () { return glossary_1.containsTerm; } });
+Object.defineProperty(exports, "localeValue", { enumerable: true, get: function () { return glossary_1.localeValue; } });
+Object.defineProperty(exports, "normalizeGlossary", { enumerable: true, get: function () { return glossary_1.normalizeGlossary; } });
+Object.defineProperty(exports, "glossaryFingerprint", { enumerable: true, get: function () { return glossary_1.glossaryFingerprint; } });
+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/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 };
+}

package/dist/injection/strategies/NextIntlStrategy.d.ts

@@ -0,0 +1,25 @@
+import * as t from '@babel/types';
+import { InjectionStrategy, InjectionContext, MessageRendering } from '../InjectionStrategy';
+import { type JsxMessage } from '../../utils/jsx-message';
+export declare class NextIntlStrategy implements InjectionStrategy {
+    id: string;
+    hasImport(ast: t.File): boolean;
+    createImport(context: InjectionContext): t.ImportDeclaration;
+    hasHook(componentPath: any): boolean;
+    createHook(context: InjectionContext): t.Statement[];
+    getTranslationFunctionName(): string;
+    /**
+     * `{t("key", { user })}`, or with inline elements
+     * `{t.rich("key", { user, link: (chunks) => <Link href="/x">{chunks}</Link> })}`
+     * for the message "Hi {user}, read the <link>terms</link>". Works with both
+     * useTranslations() and await getTranslations().
+     */
+    createMessage(key: string, message: JsxMessage): MessageRendering;
+    /**
+     * Never. An async component can't be rendered by a Client Component, and
+     * shared UI components often are. `useTranslations()` works in Server
+     * Components and client/shared ones as long as they aren't async, so only
+     * components that are already async get `await getTranslations()`.
+     */
+    requiresAsyncComponent(_context?: InjectionContext): boolean;
+}