@babelize/engine 0.1.0 → 0.1.3

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

@@ -9,6 +9,7 @@ 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';
@@ -25,6 +26,8 @@ export type { SyncDetectionResult, SyncDetectedString, SyncMissingLocaleKey } fr
 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';
@@ -43,6 +46,8 @@ 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';

package/dist/index.js

@@ -21,8 +21,8 @@ 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;
+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");
@@ -31,6 +31,8 @@ Object.defineProperty(exports, "loadBabelizeConfig", { enumerable: true, get: fu
 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
@@ -58,6 +60,10 @@ Object.defineProperty(exports, "getBabelizeSummary", { enumerable: true, get: fu
 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");
@@ -104,6 +110,14 @@ 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; } });

package/dist/local/pseudo-provider.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PseudoTranslationProvider = exports.PSEUDO_OPEN = exports.PSEUDO_CLOSE = exports.isPseudoLocalized = void 0;
 const icu_message_1 = require("../utils/icu-message");
+const rules_1 = require("../modules/glossary/rules");
 /**
  * Pseudo-localization: a deterministic, offline TranslationProvider for tests
  * and for checking i18n wiring without an API key (`babelize translate
@@ -27,6 +28,9 @@ const ACCENTS = {
 /** Spans that must survive untouched: engine tokens, args, tags, URLs, emails, code, identifiers. */
 const PROTECTED = new RegExp([
     String.raw `\[\s*#\s*VAR_\d+\s*#\s*\]`,
+    // printf / gettext placeholders and HTML entities: %(name)s, %d, %%, —
+    String.raw `%\(\w+\)[-#0 +]*\d*(?:\.\d+)?[sdifr]|%%|%[sdif]`,
+    String.raw `&(?:[a-zA-Z][a-zA-Z0-9]{1,31}|#\d{1,7}|#x[0-9a-fA-F]{1,6});`,
     String.raw `\{[^{}]*\}`,
     String.raw `<[^<>]+>`,
     String.raw `https?:\/\/\S+`,
@@ -40,9 +44,6 @@ const PROTECTED = new RegExp([
 function accent(text) {
     return text.replace(/[aeiouycnAEIOUYCN]/g, (ch) => ACCENTS[ch] ?? ch);
 }
-function escapeRegExp(s) {
-    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
 /** Accent everything outside protected spans; glossary terms become their required translation. */
 function pseudoText(text, glossary = []) {
     const terms = [...glossary].sort((a, b) => b.term.length - a.term.length);
@@ -53,7 +54,7 @@ function pseudoText(text, glossary = []) {
         while (rest) {
             let best = null;
             for (const g of terms) {
-                const m = new RegExp(`(?<![\\w])${escapeRegExp(g.term)}(?![\\w])`, 'i').exec(rest);
+                const m = new RegExp((0, rules_1.termPattern)(g.term), 'iu').exec(rest);
                 if (m && (!best || m.index < best.index))
                     best = { index: m.index, length: m[0].length, translation: g.translation };
             }

package/dist/local/translate-core.d.ts

@@ -1,5 +1,8 @@
 import type { EngineConfigV2, EngineResultV2 } from '../runtime/types';
-import type { TranslationFailure, TranslationProvider } from '../providers/types';
+import type { ProjectRulesStore, TranslationFailure, TranslationProvider } from '../providers/types';
+import type { LocaleGlossary } from '../qa/locale-qa';
+/** A rules store serving a `.babelize/config.json` glossary (no brand voice locally). */
+export declare function configRulesStore(glossary: LocaleGlossary): ProjectRulesStore;
 import { type ByokProvider } from '@babelize/types';
 import type { HostedTranslationProvider } from './hosted-provider';
 import { type FormatResult } from './formatter';
@@ -7,7 +10,7 @@ import { type FileDiffStat, type ApplyIo, type WorkspaceChanges } from './worksp
 /** Lockfile scope for local runs: `.babelize/local/babelize-lock.json` in the project root. */
 export declare const LOCAL_PROJECT_ID = "local";
 export declare const LOCAL_LOCKFILE = ".babelize/local/babelize-lock.json";
-export declare const SUPPORTED_LOCAL_FRAMEWORKS: readonly ["react", "nextjs"];
+export declare const SUPPORTED_LOCAL_FRAMEWORKS: readonly ["react", "nextjs", "django"];
 export declare const BETA_LOCAL_FRAMEWORKS: readonly ["vue", "static"];
 export interface LocalTranslateOptions {
     projectDir: string;

package/dist/local/translate-core.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LocalTranslateError = exports.BETA_LOCAL_FRAMEWORKS = exports.SUPPORTED_LOCAL_FRAMEWORKS = exports.LOCAL_LOCKFILE = exports.LOCAL_PROJECT_ID = void 0;
+exports.configRulesStore = configRulesStore;
 exports.parseLocales = parseLocales;
 exports.validateLocales = validateLocales;
 exports.sentence = sentence;
@@ -45,10 +46,23 @@ const promises_1 = require("node:fs/promises");
 const path = __importStar(require("node:path"));
 const node_util_1 = require("node:util");
 const language_codes_1 = require("../modules/translator/language-codes");
+const locale_names_1 = require("../django/locale-names");
 const lockfile_1 = require("../modules/lockfile");
 const orchestrator_1 = require("../orchestrator");
 const logger_1 = require("../utils/logger");
 const workspace_1 = require("../modules/workspace");
+const check_project_1 = require("../qa/check-project");
+/** A rules store serving a `.babelize/config.json` glossary (no brand voice locally). */
+function configRulesStore(glossary) {
+    const rules = [
+        ...(glossary.neverTranslate ?? []).map((term) => ({ term, type: 'never_translate', translations: null })),
+        ...(glossary.alwaysTranslateAs ?? []).map((e) => ({ term: e.term, type: 'always_translate_as', translations: e.translations })),
+    ];
+    return {
+        getGlossary: async () => rules,
+        getBrandVoice: async () => null,
+    };
+}
 const types_1 = require("@babelize/types");
 const git_1 = require("./git");
 const formatter_1 = require("./formatter");
@@ -58,7 +72,7 @@ const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
 /** Lockfile scope for local runs: `.babelize/local/babelize-lock.json` in the project root. */
 exports.LOCAL_PROJECT_ID = 'local';
 exports.LOCAL_LOCKFILE = `.babelize/${exports.LOCAL_PROJECT_ID}/babelize-lock.json`;
-exports.SUPPORTED_LOCAL_FRAMEWORKS = ['react', 'nextjs'];
+exports.SUPPORTED_LOCAL_FRAMEWORKS = ['react', 'nextjs', 'django'];
 exports.BETA_LOCAL_FRAMEWORKS = ['vue', 'static'];
 class LocalTranslateError extends Error {
     constructor(message, code, 
@@ -96,7 +110,15 @@ async function listProjectFiles(dir) {
 /** Locales this project was already translated into: locale files plus lockfile entries. */
 async function existingTargetLocales(workspaceDir, publicDir, localeFormat, sourceLocale) {
     const found = new Set();
-    if (localeFormat !== 'po') {
+    if (localeFormat === 'po') {
+        // Django: <locale dir>/<pt_BR>/LC_MESSAGES/django.po
+        for (const entry of await (0, promises_1.readdir)(path.join(workspaceDir, publicDir)).catch(() => [])) {
+            const po = path.join(workspaceDir, publicDir, entry, 'LC_MESSAGES', 'django.po');
+            if (await (0, promises_1.readFile)(po, 'utf8').then(() => true, () => false))
+                found.add((0, locale_names_1.localeFromDjangoName)(entry));
+        }
+    }
+    else {
         const ext = localeFormat === 'arb' ? '.arb' : '.json';
         for (const entry of await (0, promises_1.readdir)(path.join(workspaceDir, publicDir, 'locales')).catch(() => [])) {
             if (entry.endsWith(ext))
@@ -286,7 +308,7 @@ async function runScoped(opts, deps, engineLog, state) {
         }
         const frameworkStatus = frameworkStatusOf(framework);
         if (!frameworkStatus) {
-            throw new LocalTranslateError(`Detected framework "${framework}", which \`babelize translate\` does not support. Supported: React and Next.js (Vue and static HTML in beta).`, 'unsupported_framework');
+            throw new LocalTranslateError(`Detected framework "${framework}", which \`babelize translate\` does not support. Supported: React, Next.js and Django (Vue and static HTML in beta).`, 'unsupported_framework');
         }
         deps.onFramework?.(framework, frameworkStatus);
         // The engine deletes locale files that aren't in its target list, so
@@ -299,6 +321,10 @@ async function runScoped(opts, deps, engineLog, state) {
         const targetLocales = [...opts.targetLocales, ...keptLocales];
         const before = await (0, workspace_copy_1.snapshot)(temp.dir);
         state.collecting = true;
+        // The project's glossary from .babelize/config.json — the same file and
+        // schema `babelize check` reads — applied like a cloud project's.
+        const { glossary } = await (0, check_project_1.readProjectLocaleConfig)(projectDir);
+        const rules = glossary ? configRulesStore(glossary) : undefined;
         const runEngine = deps.runEngine ?? orchestrator_1.runEngineV2;
         const result = await runEngine({
             workspacePath: temp.dir,
@@ -314,7 +340,7 @@ async function runScoped(opts, deps, engineLog, state) {
             // and the updated one comes back with the other changes — only on success.
             dataDir: temp.dir,
             byok: translator ? undefined : opts.byok,
-            providers: translator ? { translator } : undefined,
+            providers: translator || rules ? { ...(translator ? { translator } : {}), ...(rules ? { rules } : {}) } : undefined,
             installDependencies: false,
             onProgress: (message, step, status) => deps.onProgress?.(message, step, status),
         });
@@ -348,9 +374,21 @@ async function runScoped(opts, deps, engineLog, state) {
         // cloud backend stages locale files for a PR.
         const lost = [];
         for (const locale of result.locales) {
-            if (locale.locale === opts.sourceLocale)
+            if (locale.locale === opts.sourceLocale || locale.noFile)
                 continue;
             const rel = locale.path.split(path.sep).join('/');
+            if (locale.content !== undefined) {
+                // A merged catalogue (Django .po): written exactly as the engine
+                // produced it. The merge never drops existing translations.
+                for (const f of [{ path: rel, content: locale.content, encoding: 'utf8' }, ...(locale.extraFiles ?? [])]) {
+                    const abs = path.resolve(temp.dir, f.path.split(path.sep).join('/'));
+                    if (path.relative(temp.dir, abs).startsWith('..'))
+                        continue;
+                    await (0, promises_1.mkdir)(path.dirname(abs), { recursive: true });
+                    await (0, promises_1.writeFile)(abs, f.encoding === 'base64' ? Buffer.from(f.content, 'base64') : f.content);
+                }
+                continue;
+            }
             const previous = await readJsonIfExists(path.join(projectDir, rel));
             const next = flattenData(locale.data);
             const failedHere = new Set(translationFailures.filter((f) => f.locale === locale.locale).map((f) => f.key));

package/dist/local/translate-messages.js

@@ -39,6 +39,7 @@ const node_os_1 = require("node:os");
 const path = __importStar(require("node:path"));
 const keygen_1 = require("../modules/keygen");
 const translate_1 = require("../modules/translator/translate");
+const glossary_1 = require("../modules/glossary");
 const logger_1 = require("../utils/logger");
 async function translateMessages(opts) {
     const logger = {
@@ -54,14 +55,11 @@ async function run(opts) {
         throw new Error('translateMessages needs a byok key or a translator.');
     const dir = await (0, promises_1.mkdtemp)(path.join((0, node_os_1.tmpdir)(), 'babelize-messages-'));
     try {
-        // The translate phase reads glossary rules from .babelize/config.json when there is no project id.
-        const customTranslations = {};
-        for (const term of opts.glossary?.neverTranslate ?? [])
-            customTranslations[term] = { neverTranslate: true };
-        for (const e of opts.glossary?.alwaysTranslateAs ?? [])
-            customTranslations[e.term] = { translations: e.translations };
-        await (0, promises_1.mkdir)(path.join(dir, '.babelize'), { recursive: true });
-        await (0, promises_1.writeFile)(path.join(dir, '.babelize', 'config.json'), JSON.stringify({ customTranslations }));
+        // The glossary goes in as already-loaded rules, normalized like a project's.
+        const glossary = (0, glossary_1.normalizeGlossary)([
+            ...(opts.glossary?.neverTranslate ?? []).map((term) => ({ term, type: 'never_translate' })),
+            ...(opts.glossary?.alwaysTranslateAs ?? []).map((e) => ({ term: e.term, type: 'always_translate_as', translations: e.translations })),
+        ]);
         const workspace = {
             path: dir,
             framework: 'react',
@@ -72,7 +70,7 @@ async function run(opts) {
             localeFormat: 'json',
         };
         const result = await (0, translate_1.translateLocales)(workspace, { locale: opts.sourceLocale, path: '', data: { ...opts.messages }, isNew: false }, opts.targetLocales, false, true, // dry run: nothing written
-        undefined, opts.onProgress, undefined, undefined, opts.translator ? undefined : opts.byok, undefined, undefined, opts.translator ? { translator: opts.translator } : {}, { targetPlurals: opts.targetPlurals ?? true });
+        undefined, opts.onProgress, undefined, undefined, opts.translator ? undefined : opts.byok, undefined, undefined, opts.translator ? { translator: opts.translator } : {}, { targetPlurals: opts.targetPlurals ?? true, rules: { glossary, brandVoice: null, complete: true } });
         const targets = {};
         for (const file of result.translation.locales) {
             const flat = (0, keygen_1.flattenLocaleData)(file.data);

package/dist/modules/extractor/extract.js

@@ -42,8 +42,8 @@ const ast_helpers_1 = require("../../utils/ast-helpers");
 const file_utils_1 = require("../../utils/file-utils");
 const string_utils_1 = require("../../utils/string-utils");
 const detect_format_1 = require("../../utils/detect-format");
-const dtl_mask_1 = require("../../utils/dtl-mask");
-const py_extractor_1 = require("../../utils/py-extractor");
+const extract_1 = require("../../django/extract");
+const types_2 = require("@babelize/types");
 const jsx_message_1 = require("../../utils/jsx-message");
 const ui_copy_1 = require("../../utils/ui-copy");
 const module_constants_1 = require("../../utils/module-constants");
@@ -64,10 +64,14 @@ async function extractStrings(workspace, filesToProcess, extractOptions = {}) {
         }
     }
     else {
-        // Otherwise scan all source directories
+        // Otherwise scan all source directories. Django scans .py/.html and
+        // skips virtualenvs, migrations, static files and the like.
+        const fwConfig = workspace.framework === 'django' ? types_2.FRAMEWORK_CONFIGS.django : undefined;
+        const extensions = fwConfig ? [...fwConfig.extensions] : types_1.SUPPORTED_EXTENSIONS;
+        const excluded = fwConfig ? [...types_1.EXCLUDED_PATTERNS, ...(fwConfig.excludedPatterns ?? [])] : types_1.EXCLUDED_PATTERNS;
         for (const sourceDir of workspace.sourceDirs) {
             const dirPath = path.join(workspace.path, sourceDir);
-            const files = await (0, file_utils_1.findFiles)(dirPath, types_1.SUPPORTED_EXTENSIONS, types_1.EXCLUDED_PATTERNS);
+            const files = await (0, file_utils_1.findFiles)(dirPath, extensions, excluded);
             sourceFiles.push(...files);
         }
     }
@@ -104,17 +108,21 @@ async function extractStrings(workspace, filesToProcess, extractOptions = {}) {
     const extraction = { strings, filesAnalyzed, skippedFiles, warnings, notInjected };
     return { extraction };
 }
+const GENERATED_FILE_MARKERS = ['@babelize-generated', 'babelize:i18n-config'];
+/** True for files Babelize wrote itself; the marker sits in the header comment. */
+function isBabelizeGenerated(content) {
+    const head = content.slice(0, 500);
+    return GENERATED_FILE_MARKERS.some((marker) => head.includes(marker));
+}
 async function extractStringsFromFile(content, filePath, detectFormats, options) {
-    // Django template handling
-    if (options?.framework === 'django' && (filePath.endsWith('.html') || filePath.endsWith('.htm'))) {
-        const { masked } = (0, dtl_mask_1.maskTemplateTags)(content);
-        const result = await (0, html_extractor_1.extractStringsFromHtml)(masked, filePath, detectFormats);
-        // Don't restore — we extract from the masked version, the restore happens at inject time
-        return result;
-    }
-    // Python file handling
-    if (filePath.endsWith('.py')) {
-        return (0, py_extractor_1.extractStringsFromPython)(content, filePath);
+    // Files Babelize generated itself (i18n config, next-intl request config)
+    // hold config values such as bindI18n: 'languageChanged loaded'. A re-run
+    // used to extract those and inject t() into the i18n config, breaking it.
+    if (isBabelizeGenerated(content))
+        return { strings: [], warnings: [] };
+    // Django: gettext calls, translate tags and hardcoded text in templates/forms/models/views.
+    if (options?.framework === 'django') {
+        return (0, extract_1.extractDjangoFile)(content, filePath, { icu: options.plurals === true });
     }
     if (filePath.endsWith('.html') || filePath.endsWith('.htm')) {
         return (0, html_extractor_1.extractStringsFromHtml)(content, filePath, detectFormats);

package/dist/modules/finalization/django-finalize.d.ts

@@ -4,10 +4,25 @@ export interface DjangoFinalizeResult {
     /** Human-readable description of each edit applied. */
     changes: string[];
     warnings: string[];
+    /** Settings file content before and after, when it changed. */
+    original?: string;
+    updated?: string;
 }
 export declare function resolveSettingsPath(workspacePath: string): Promise<string | null>;
+/**
+ * The locale directory Django reads (LOCALE_PATHS[0]), relative to the
+ * workspace, '/'-separated. Falls back to <BASE_DIR>/locale — what finalize
+ * adds — when LOCALE_PATHS is absent or not a plain BASE_DIR path.
+ */
+export declare function resolveDjangoLocaleDir(workspacePath: string, djangoRoot: string): Promise<string>;
+/** First LOCALE_PATHS entry as a path relative to BASE_DIR, if it is one. */
+export declare function parseLocalePaths(source: string): string | null;
 export declare function finalizeDjangoSettings(workspacePath: string, options?: {
     targetLocales?: string[];
     sourceLocale?: string;
     dryRun?: boolean;
+    /** Django project root (BASE_DIR), relative to the workspace. */
+    djangoRoot?: string;
+    /** Locale directory the catalogues were written to, relative to the workspace. */
+    localeDir?: string;
 }): Promise<DjangoFinalizeResult>;