@generaltranslation/python-extractor 0.2.20 → 0.2.21

package/dist/constants.js

@@ -1,21 +1,26 @@
-export const PYTHON_GT_PACKAGES = ['gt_flask', 'gt_fastapi'];
-export const PYTHON_GT_DEPENDENCIES = ['gt-flask', 'gt-fastapi'];
-export const PYTHON_T_FUNCTION = 't';
-export const PYTHON_MSG_FUNCTION = 'msg';
-export const PYTHON_DERIVE = 'derive';
+//#region src/constants.ts
+const PYTHON_GT_PACKAGES = ["gt_flask", "gt_fastapi"];
+const PYTHON_GT_DEPENDENCIES = ["gt-flask", "gt-fastapi"];
+const PYTHON_T_FUNCTION = "t";
+const PYTHON_MSG_FUNCTION = "msg";
+const PYTHON_DERIVE = "derive";
 /** @deprecated Use PYTHON_DERIVE instead */
-export const PYTHON_DECLARE_STATIC = 'declare_static';
-export const PYTHON_DECLARE_VAR = 'declare_var';
+const PYTHON_DECLARE_STATIC = "declare_static";
+const PYTHON_DECLARE_VAR = "declare_var";
 /** These imported names are tracked (translation functions + derive helpers) */
-export const PYTHON_TRANSLATION_FUNCTIONS = [
-    't',
-    'msg',
-    'derive',
-    'declare_static',
-    'declare_var',
+const PYTHON_TRANSLATION_FUNCTIONS = [
+	"t",
+	"msg",
+	"derive",
+	"declare_static",
+	"declare_var"
 ];
-export const PYTHON_METADATA_KWARGS = {
-    _id: 'id',
-    _context: 'context',
-    _max_chars: 'maxChars',
+const PYTHON_METADATA_KWARGS = {
+	_id: "id",
+	_context: "context",
+	_max_chars: "maxChars"
 };
+//#endregion
+export { PYTHON_DECLARE_STATIC, PYTHON_DECLARE_VAR, PYTHON_DERIVE, PYTHON_GT_DEPENDENCIES, PYTHON_GT_PACKAGES, PYTHON_METADATA_KWARGS, PYTHON_MSG_FUNCTION, PYTHON_TRANSLATION_FUNCTIONS, PYTHON_T_FUNCTION };
+
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["export const PYTHON_GT_PACKAGES = ['gt_flask', 'gt_fastapi'] as const;\nexport const PYTHON_GT_DEPENDENCIES = ['gt-flask', 'gt-fastapi'] as const;\nexport const PYTHON_T_FUNCTION = 't';\nexport const PYTHON_MSG_FUNCTION = 'msg';\nexport const PYTHON_DERIVE = 'derive';\n/** @deprecated Use PYTHON_DERIVE instead */\nexport const PYTHON_DECLARE_STATIC = 'declare_static';\nexport const PYTHON_DECLARE_VAR = 'declare_var';\n/** These imported names are tracked (translation functions + derive helpers) */\nexport const PYTHON_TRANSLATION_FUNCTIONS = [\n  't',\n  'msg',\n  'derive',\n  'declare_static',\n  'declare_var',\n] as const;\nexport const PYTHON_METADATA_KWARGS = {\n  _id: 'id',\n  _context: 'context',\n  _max_chars: 'maxChars',\n} as const;\n"],"mappings":";AAAA,MAAa,qBAAqB,CAAC,YAAY,aAAa;AAC5D,MAAa,yBAAyB,CAAC,YAAY,aAAa;AAChE,MAAa,oBAAoB;AACjC,MAAa,sBAAsB;AACnC,MAAa,gBAAgB;;AAE7B,MAAa,wBAAwB;AACrC,MAAa,qBAAqB;;AAElC,MAAa,+BAA+B;CAC1C;CACA;CACA;CACA;CACA;CACD;AACD,MAAa,yBAAyB;CACpC,KAAK;CACL,UAAU;CACV,YAAY;CACb"}

package/dist/extractCalls.js

@@ -1,288 +1,205 @@
-import { PYTHON_METADATA_KWARGS, PYTHON_DERIVE, PYTHON_DECLARE_STATIC, PYTHON_DECLARE_VAR, } from './constants.js';
-import { containsStaticCalls, parseStringExpression, } from './parseStringExpression.js';
-import { nodeToStrings } from './stringNode.js';
-import { indexVars } from 'generaltranslation/internal';
-import { randomUUID } from 'node:crypto';
+import { PYTHON_METADATA_KWARGS } from "./constants.js";
+import { containsStaticCalls, parseStringExpression } from "./parseStringExpression.js";
+import { nodeToStrings } from "./stringNode.js";
+import { indexVars } from "generaltranslation/internal";
+import { randomUUID } from "node:crypto";
+//#region src/extractCalls.ts
 /**
- * Extracts translation function calls from a Python AST.
- * Walks all `call` nodes and checks if they reference a tracked import.
- */
-export async function extractCalls(rootNode, imports, filePath) {
-    const calls = [];
-    const errors = [];
-    const warnings = [];
-    // Only track t/msg as translation functions (not derive/declare_static/declare_var)
-    const trackedNames = new Set(imports
-        .filter((imp) => imp.originalName !== PYTHON_DERIVE &&
-        imp.originalName !== PYTHON_DECLARE_STATIC &&
-        imp.originalName !== PYTHON_DECLARE_VAR)
-        .map((imp) => imp.localName));
-    if (trackedNames.size === 0)
-        return { calls, errors, warnings };
-    await walkCalls(rootNode, trackedNames, imports, filePath, calls, errors, warnings);
-    return { calls, errors, warnings };
+* Extracts translation function calls from a Python AST.
+* Walks all `call` nodes and checks if they reference a tracked import.
+*/
+async function extractCalls(rootNode, imports, filePath) {
+	const calls = [];
+	const errors = [];
+	const warnings = [];
+	const trackedNames = new Set(imports.filter((imp) => imp.originalName !== "derive" && imp.originalName !== "declare_static" && imp.originalName !== "declare_var").map((imp) => imp.localName));
+	if (trackedNames.size === 0) return {
+		calls,
+		errors,
+		warnings
+	};
+	await walkCalls(rootNode, trackedNames, imports, filePath, calls, errors, warnings);
+	return {
+		calls,
+		errors,
+		warnings
+	};
 }
 async function walkCalls(node, trackedNames, imports, filePath, calls, errors, warnings) {
-    if (node.type === 'call') {
-        const funcNode = node.childForFieldName('function');
-        if (funcNode &&
-            funcNode.type === 'identifier' &&
-            trackedNames.has(funcNode.text)) {
-            await processCall(node, imports, filePath, calls, errors, warnings);
-        }
-    }
-    for (let i = 0; i < node.childCount; i++) {
-        const child = node.child(i);
-        if (child)
-            await walkCalls(child, trackedNames, imports, filePath, calls, errors, warnings);
-    }
+	if (node.type === "call") {
+		const funcNode = node.childForFieldName("function");
+		if (funcNode && funcNode.type === "identifier" && trackedNames.has(funcNode.text)) await processCall(node, imports, filePath, calls, errors, warnings);
+	}
+	for (let i = 0; i < node.childCount; i++) {
+		const child = node.child(i);
+		if (child) await walkCalls(child, trackedNames, imports, filePath, calls, errors, warnings);
+	}
 }
 async function processCall(callNode, imports, filePath, calls, errors, _warnings) {
-    const argsNode = callNode.childForFieldName('arguments');
-    if (!argsNode) {
-        errors.push(`${locationStr(callNode)}: translation call has no arguments`);
-        return;
-    }
-    // Find first positional argument (skip punctuation)
-    let firstArg = null;
-    for (let i = 0; i < argsNode.childCount; i++) {
-        const child = argsNode.child(i);
-        if (child &&
-            child.type !== '(' &&
-            child.type !== ')' &&
-            child.type !== ',' &&
-            child.type !== 'keyword_argument') {
-            firstArg = child;
-            break;
-        }
-    }
-    if (!firstArg) {
-        errors.push(`${locationStr(callNode)}: translation call has no positional argument`);
-        return;
-    }
-    // Check if this expression contains declare_static/declare_var
-    const hasStaticHelpers = (firstArg.type === 'string' &&
-        isFString(firstArg) &&
-        containsStaticCalls(firstArg, imports)) ||
-        (firstArg.type === 'binary_operator' &&
-            containsStaticCalls(firstArg, imports)) ||
-        (firstArg.type === 'call' && containsStaticCalls(firstArg, imports)) ||
-        (firstArg.type === 'parenthesized_expression' &&
-            containsStaticCalls(firstArg, imports));
-    if (hasStaticHelpers) {
-        // Compound expression path: parse into StringNode tree
-        const rootNode = callNode.tree?.rootNode;
-        if (!rootNode) {
-            errors.push(`${locationStr(callNode)}: could not access AST root`);
-            return;
-        }
-        const stringNode = await parseStringExpression(firstArg, {
-            rootNode,
-            imports,
-            filePath,
-            errors,
-        });
-        if (!stringNode)
-            return;
-        const strings = nodeToStrings(stringNode).map(indexVars);
-        if (strings.length === 0) {
-            errors.push(`${locationStr(callNode)}: no string variants produced`);
-            return;
-        }
-        // Extract static metadata and check for derive in _context
-        const metadata = extractKwargs(argsNode, errors, callNode, imports);
-        const contextVariants = await extractDeriveContext(argsNode, imports, filePath, rootNode, errors);
-        const staticId = `static-temp-id-${randomUUID()}`;
-        if (contextVariants) {
-            // Cross-product: content variants × context variants
-            for (const source of strings) {
-                for (const context of contextVariants) {
-                    calls.push({
-                        source,
-                        ...metadata,
-                        context,
-                        staticId,
-                        line: callNode.startPosition.row + 1,
-                        column: callNode.startPosition.column,
-                    });
-                }
-            }
-        }
-        else {
-            for (const source of strings) {
-                calls.push({
-                    source,
-                    ...metadata,
-                    staticId,
-                    line: callNode.startPosition.row + 1,
-                    column: callNode.startPosition.column,
-                });
-            }
-        }
-        return;
-    }
-    // Simple path: validate first argument is a plain string literal
-    if (firstArg.type !== 'string') {
-        if (firstArg.type === 'identifier') {
-            errors.push(`${locationStr(callNode)}: translation call uses a variable "${firstArg.text}" instead of a string literal`);
-        }
-        else if (firstArg.type === 'concatenated_string') {
-            errors.push(`${locationStr(callNode)}: translation call uses concatenated strings — use a single string literal`);
-        }
-        else {
-            errors.push(`${locationStr(callNode)}: translation call first argument must be a string literal, got "${firstArg.type}"`);
-        }
-        return;
-    }
-    // Check for f-strings (without declare_static/declare_var)
-    if (isFString(firstArg)) {
-        errors.push(`${locationStr(callNode)}: translation call uses an f-string — use a plain string literal or derive()/declare_var()`);
-        return;
-    }
-    const source = extractStringContent(firstArg);
-    if (source === undefined) {
-        errors.push(`${locationStr(callNode)}: could not extract string content`);
-        return;
-    }
-    // Extract keyword arguments and check for derive in _context
-    const metadata = extractKwargs(argsNode, errors, callNode, imports);
-    const rootNode = callNode.tree?.rootNode;
-    const contextVariants = rootNode
-        ? await extractDeriveContext(argsNode, imports, filePath, rootNode, errors)
-        : null;
-    if (contextVariants) {
-        const staticId = `static-temp-id-${randomUUID()}`;
-        for (const context of contextVariants) {
-            calls.push({
-                source,
-                ...metadata,
-                context,
-                staticId,
-                line: callNode.startPosition.row + 1,
-                column: callNode.startPosition.column,
-            });
-        }
-    }
-    else {
-        calls.push({
-            source,
-            ...metadata,
-            line: callNode.startPosition.row + 1,
-            column: callNode.startPosition.column,
-        });
-    }
+	var _callNode$tree2;
+	const argsNode = callNode.childForFieldName("arguments");
+	if (!argsNode) {
+		errors.push(`${locationStr(callNode)}: translation call has no arguments`);
+		return;
+	}
+	let firstArg = null;
+	for (let i = 0; i < argsNode.childCount; i++) {
+		const child = argsNode.child(i);
+		if (child && child.type !== "(" && child.type !== ")" && child.type !== "," && child.type !== "keyword_argument") {
+			firstArg = child;
+			break;
+		}
+	}
+	if (!firstArg) {
+		errors.push(`${locationStr(callNode)}: translation call has no positional argument`);
+		return;
+	}
+	if (firstArg.type === "string" && isFString(firstArg) && containsStaticCalls(firstArg, imports) || firstArg.type === "binary_operator" && containsStaticCalls(firstArg, imports) || firstArg.type === "call" && containsStaticCalls(firstArg, imports) || firstArg.type === "parenthesized_expression" && containsStaticCalls(firstArg, imports)) {
+		var _callNode$tree;
+		const rootNode = (_callNode$tree = callNode.tree) === null || _callNode$tree === void 0 ? void 0 : _callNode$tree.rootNode;
+		if (!rootNode) {
+			errors.push(`${locationStr(callNode)}: could not access AST root`);
+			return;
+		}
+		const stringNode = await parseStringExpression(firstArg, {
+			rootNode,
+			imports,
+			filePath,
+			errors
+		});
+		if (!stringNode) return;
+		const strings = nodeToStrings(stringNode).map(indexVars);
+		if (strings.length === 0) {
+			errors.push(`${locationStr(callNode)}: no string variants produced`);
+			return;
+		}
+		const metadata = extractKwargs(argsNode, errors, callNode, imports);
+		const contextVariants = await extractDeriveContext(argsNode, imports, filePath, rootNode, errors);
+		const staticId = `static-temp-id-${randomUUID()}`;
+		if (contextVariants) for (const source of strings) for (const context of contextVariants) calls.push({
+			source,
+			...metadata,
+			context,
+			staticId,
+			line: callNode.startPosition.row + 1,
+			column: callNode.startPosition.column
+		});
+		else for (const source of strings) calls.push({
+			source,
+			...metadata,
+			staticId,
+			line: callNode.startPosition.row + 1,
+			column: callNode.startPosition.column
+		});
+		return;
+	}
+	if (firstArg.type !== "string") {
+		if (firstArg.type === "identifier") errors.push(`${locationStr(callNode)}: translation call uses a variable "${firstArg.text}" instead of a string literal`);
+		else if (firstArg.type === "concatenated_string") errors.push(`${locationStr(callNode)}: translation call uses concatenated strings — use a single string literal`);
+		else errors.push(`${locationStr(callNode)}: translation call first argument must be a string literal, got "${firstArg.type}"`);
+		return;
+	}
+	if (isFString(firstArg)) {
+		errors.push(`${locationStr(callNode)}: translation call uses an f-string — use a plain string literal or derive()/declare_var()`);
+		return;
+	}
+	const source = extractStringContent(firstArg);
+	if (source === void 0) {
+		errors.push(`${locationStr(callNode)}: could not extract string content`);
+		return;
+	}
+	const metadata = extractKwargs(argsNode, errors, callNode, imports);
+	const rootNode = (_callNode$tree2 = callNode.tree) === null || _callNode$tree2 === void 0 ? void 0 : _callNode$tree2.rootNode;
+	const contextVariants = rootNode ? await extractDeriveContext(argsNode, imports, filePath, rootNode, errors) : null;
+	if (contextVariants) {
+		const staticId = `static-temp-id-${randomUUID()}`;
+		for (const context of contextVariants) calls.push({
+			source,
+			...metadata,
+			context,
+			staticId,
+			line: callNode.startPosition.row + 1,
+			column: callNode.startPosition.column
+		});
+	} else calls.push({
+		source,
+		...metadata,
+		line: callNode.startPosition.row + 1,
+		column: callNode.startPosition.column
+	});
 }
 function extractKwargs(argsNode, errors, callNode, imports) {
-    const result = {};
-    for (let i = 0; i < argsNode.childCount; i++) {
-        const child = argsNode.child(i);
-        if (!child || child.type !== 'keyword_argument')
-            continue;
-        const nameNode = child.childForFieldName('name');
-        const valueNode = child.childForFieldName('value');
-        if (!nameNode || !valueNode)
-            continue;
-        const kwargName = nameNode.text;
-        const metadataKey = PYTHON_METADATA_KWARGS[kwargName];
-        if (!metadataKey)
-            continue;
-        if (metadataKey === 'maxChars') {
-            if (valueNode.type === 'integer') {
-                result.maxChars = parseInt(valueNode.text, 10);
-            }
-            else {
-                errors.push(`${locationStr(callNode)}: _max_chars must be an integer literal`);
-            }
-        }
-        else {
-            if (valueNode.type === 'string' && !isFString(valueNode)) {
-                const value = extractStringContent(valueNode);
-                if (value !== undefined) {
-                    if (metadataKey === 'id')
-                        result.id = value;
-                    else if (metadataKey === 'context')
-                        result.context = value;
-                }
-            }
-            else if (metadataKey === 'context' &&
-                imports &&
-                containsStaticCalls(valueNode, imports)) {
-                // _context contains derive() — skip error, caller handles derivation
-            }
-            else {
-                errors.push(`${locationStr(callNode)}: _${metadataKey} must be a string literal`);
-            }
-        }
-    }
-    return result;
+	const result = {};
+	for (let i = 0; i < argsNode.childCount; i++) {
+		const child = argsNode.child(i);
+		if (!child || child.type !== "keyword_argument") continue;
+		const nameNode = child.childForFieldName("name");
+		const valueNode = child.childForFieldName("value");
+		if (!nameNode || !valueNode) continue;
+		const metadataKey = PYTHON_METADATA_KWARGS[nameNode.text];
+		if (!metadataKey) continue;
+		if (metadataKey === "maxChars") if (valueNode.type === "integer") result.maxChars = parseInt(valueNode.text, 10);
+		else errors.push(`${locationStr(callNode)}: _max_chars must be an integer literal`);
+		else if (valueNode.type === "string" && !isFString(valueNode)) {
+			const value = extractStringContent(valueNode);
+			if (value !== void 0) {
+				if (metadataKey === "id") result.id = value;
+				else if (metadataKey === "context") result.context = value;
+			}
+		} else if (metadataKey === "context" && imports && containsStaticCalls(valueNode, imports)) {} else errors.push(`${locationStr(callNode)}: _${metadataKey} must be a string literal`);
+	}
+	return result;
 }
 /**
- * Finds the _context keyword argument node and, if it contains a derive() call,
- * parses it into context variants. Returns null if _context is static or absent.
- */
+* Finds the _context keyword argument node and, if it contains a derive() call,
+* parses it into context variants. Returns null if _context is static or absent.
+*/
 async function extractDeriveContext(argsNode, imports, filePath, rootNode, errors) {
-    // Find _context kwarg
-    for (let i = 0; i < argsNode.childCount; i++) {
-        const child = argsNode.child(i);
-        if (!child || child.type !== 'keyword_argument')
-            continue;
-        const nameNode = child.childForFieldName('name');
-        const valueNode = child.childForFieldName('value');
-        if (!nameNode || !valueNode)
-            continue;
-        if (nameNode.text !== '_context')
-            continue;
-        // Check if value contains derive()
-        if (!containsStaticCalls(valueNode, imports))
-            return null;
-        const contextNode = await parseStringExpression(valueNode, {
-            rootNode,
-            imports,
-            filePath,
-            errors,
-        });
-        if (!contextNode)
-            return null;
-        return nodeToStrings(contextNode);
-    }
-    return null;
+	for (let i = 0; i < argsNode.childCount; i++) {
+		const child = argsNode.child(i);
+		if (!child || child.type !== "keyword_argument") continue;
+		const nameNode = child.childForFieldName("name");
+		const valueNode = child.childForFieldName("value");
+		if (!nameNode || !valueNode) continue;
+		if (nameNode.text !== "_context") continue;
+		if (!containsStaticCalls(valueNode, imports)) return null;
+		const contextNode = await parseStringExpression(valueNode, {
+			rootNode,
+			imports,
+			filePath,
+			errors
+		});
+		if (!contextNode) return null;
+		return nodeToStrings(contextNode);
+	}
+	return null;
 }
 function isFString(stringNode) {
-    // Check if string_start begins with 'f' or 'F'
-    for (let i = 0; i < stringNode.childCount; i++) {
-        const child = stringNode.child(i);
-        if (child && child.type === 'string_start') {
-            return /^[fF]/.test(child.text);
-        }
-        // Also check for interpolation children (hallmark of f-strings)
-        if (child && child.type === 'interpolation') {
-            return true;
-        }
-    }
-    return false;
+	for (let i = 0; i < stringNode.childCount; i++) {
+		const child = stringNode.child(i);
+		if (child && child.type === "string_start") return /^[fF]/.test(child.text);
+		if (child && child.type === "interpolation") return true;
+	}
+	return false;
 }
 function extractStringContent(stringNode) {
-    // Look for string_content child
-    for (let i = 0; i < stringNode.childCount; i++) {
-        const child = stringNode.child(i);
-        if (child && child.type === 'string_content') {
-            return child.text;
-        }
-    }
-    // Empty string — no string_content child, but has string_start and string_end
-    let hasStart = false;
-    let hasEnd = false;
-    for (let i = 0; i < stringNode.childCount; i++) {
-        const child = stringNode.child(i);
-        if (child?.type === 'string_start')
-            hasStart = true;
-        if (child?.type === 'string_end')
-            hasEnd = true;
-    }
-    if (hasStart && hasEnd)
-        return '';
-    return undefined;
+	for (let i = 0; i < stringNode.childCount; i++) {
+		const child = stringNode.child(i);
+		if (child && child.type === "string_content") return child.text;
+	}
+	let hasStart = false;
+	let hasEnd = false;
+	for (let i = 0; i < stringNode.childCount; i++) {
+		const child = stringNode.child(i);
+		if ((child === null || child === void 0 ? void 0 : child.type) === "string_start") hasStart = true;
+		if ((child === null || child === void 0 ? void 0 : child.type) === "string_end") hasEnd = true;
+	}
+	if (hasStart && hasEnd) return "";
 }
 function locationStr(node) {
-    return `line ${node.startPosition.row + 1}, col ${node.startPosition.column}`;
+	return `line ${node.startPosition.row + 1}, col ${node.startPosition.column}`;
 }
+//#endregion
+export { extractCalls };
+
+//# sourceMappingURL=extractCalls.js.map

package/dist/extractCalls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractCalls.js","names":[],"sources":["../src/extractCalls.ts"],"sourcesContent":["import type { SyntaxNode } from './parser.js';\nimport type { ImportAlias } from './extractImports.js';\nimport {\n  PYTHON_METADATA_KWARGS,\n  PYTHON_DERIVE,\n  PYTHON_DECLARE_STATIC,\n  PYTHON_DECLARE_VAR,\n} from './constants.js';\nimport {\n  containsStaticCalls,\n  parseStringExpression,\n} from './parseStringExpression.js';\nimport { nodeToStrings } from './stringNode.js';\nimport { indexVars } from 'generaltranslation/internal';\nimport { randomUUID } from 'node:crypto';\n\nexport type RawTranslationCall = {\n  source: string;\n  id?: string;\n  context?: string;\n  maxChars?: number;\n  staticId?: string;\n  line: number;\n  column: number;\n};\n\n/**\n * Extracts translation function calls from a Python AST.\n * Walks all `call` nodes and checks if they reference a tracked import.\n */\nexport async function extractCalls(\n  rootNode: SyntaxNode,\n  imports: ImportAlias[],\n  filePath: string\n): Promise<{\n  calls: RawTranslationCall[];\n  errors: string[];\n  warnings: string[];\n}> {\n  const calls: RawTranslationCall[] = [];\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  // Only track t/msg as translation functions (not derive/declare_static/declare_var)\n  const trackedNames = new Set(\n    imports\n      .filter(\n        (imp) =>\n          imp.originalName !== PYTHON_DERIVE &&\n          imp.originalName !== PYTHON_DECLARE_STATIC &&\n          imp.originalName !== PYTHON_DECLARE_VAR\n      )\n      .map((imp) => imp.localName)\n  );\n  if (trackedNames.size === 0) return { calls, errors, warnings };\n\n  await walkCalls(\n    rootNode,\n    trackedNames,\n    imports,\n    filePath,\n    calls,\n    errors,\n    warnings\n  );\n\n  return { calls, errors, warnings };\n}\n\nasync function walkCalls(\n  node: SyntaxNode,\n  trackedNames: Set<string>,\n  imports: ImportAlias[],\n  filePath: string,\n  calls: RawTranslationCall[],\n  errors: string[],\n  warnings: string[]\n): Promise<void> {\n  if (node.type === 'call') {\n    const funcNode = node.childForFieldName('function');\n    if (\n      funcNode &&\n      funcNode.type === 'identifier' &&\n      trackedNames.has(funcNode.text)\n    ) {\n      await processCall(node, imports, filePath, calls, errors, warnings);\n    }\n  }\n\n  for (let i = 0; i < node.childCount; i++) {\n    const child = node.child(i);\n    if (child)\n      await walkCalls(\n        child,\n        trackedNames,\n        imports,\n        filePath,\n        calls,\n        errors,\n        warnings\n      );\n  }\n}\n\nasync function processCall(\n  callNode: SyntaxNode,\n  imports: ImportAlias[],\n  filePath: string,\n  calls: RawTranslationCall[],\n  errors: string[],\n  _warnings: string[]\n): Promise<void> {\n  const argsNode = callNode.childForFieldName('arguments');\n  if (!argsNode) {\n    errors.push(`${locationStr(callNode)}: translation call has no arguments`);\n    return;\n  }\n\n  // Find first positional argument (skip punctuation)\n  let firstArg: SyntaxNode | null = null;\n  for (let i = 0; i < argsNode.childCount; i++) {\n    const child = argsNode.child(i);\n    if (\n      child &&\n      child.type !== '(' &&\n      child.type !== ')' &&\n      child.type !== ',' &&\n      child.type !== 'keyword_argument'\n    ) {\n      firstArg = child;\n      break;\n    }\n  }\n\n  if (!firstArg) {\n    errors.push(\n      `${locationStr(callNode)}: translation call has no positional argument`\n    );\n    return;\n  }\n\n  // Check if this expression contains declare_static/declare_var\n  const hasStaticHelpers =\n    (firstArg.type === 'string' &&\n      isFString(firstArg) &&\n      containsStaticCalls(firstArg, imports)) ||\n    (firstArg.type === 'binary_operator' &&\n      containsStaticCalls(firstArg, imports)) ||\n    (firstArg.type === 'call' && containsStaticCalls(firstArg, imports)) ||\n    (firstArg.type === 'parenthesized_expression' &&\n      containsStaticCalls(firstArg, imports));\n\n  if (hasStaticHelpers) {\n    // Compound expression path: parse into StringNode tree\n    const rootNode = callNode.tree?.rootNode;\n    if (!rootNode) {\n      errors.push(`${locationStr(callNode)}: could not access AST root`);\n      return;\n    }\n\n    const stringNode = await parseStringExpression(firstArg, {\n      rootNode,\n      imports,\n      filePath,\n      errors,\n    });\n\n    if (!stringNode) return;\n\n    const strings = nodeToStrings(stringNode).map(indexVars);\n    if (strings.length === 0) {\n      errors.push(`${locationStr(callNode)}: no string variants produced`);\n      return;\n    }\n\n    // Extract static metadata and check for derive in _context\n    const metadata = extractKwargs(argsNode, errors, callNode, imports);\n    const contextVariants = await extractDeriveContext(\n      argsNode,\n      imports,\n      filePath,\n      rootNode,\n      errors\n    );\n\n    const staticId = `static-temp-id-${randomUUID()}`;\n\n    if (contextVariants) {\n      // Cross-product: content variants × context variants\n      for (const source of strings) {\n        for (const context of contextVariants) {\n          calls.push({\n            source,\n            ...metadata,\n            context,\n            staticId,\n            line: callNode.startPosition.row + 1,\n            column: callNode.startPosition.column,\n          });\n        }\n      }\n    } else {\n      for (const source of strings) {\n        calls.push({\n          source,\n          ...metadata,\n          staticId,\n          line: callNode.startPosition.row + 1,\n          column: callNode.startPosition.column,\n        });\n      }\n    }\n    return;\n  }\n\n  // Simple path: validate first argument is a plain string literal\n  if (firstArg.type !== 'string') {\n    if (firstArg.type === 'identifier') {\n      errors.push(\n        `${locationStr(callNode)}: translation call uses a variable \"${firstArg.text}\" instead of a string literal`\n      );\n    } else if (firstArg.type === 'concatenated_string') {\n      errors.push(\n        `${locationStr(callNode)}: translation call uses concatenated strings — use a single string literal`\n      );\n    } else {\n      errors.push(\n        `${locationStr(callNode)}: translation call first argument must be a string literal, got \"${firstArg.type}\"`\n      );\n    }\n    return;\n  }\n\n  // Check for f-strings (without declare_static/declare_var)\n  if (isFString(firstArg)) {\n    errors.push(\n      `${locationStr(callNode)}: translation call uses an f-string — use a plain string literal or derive()/declare_var()`\n    );\n    return;\n  }\n\n  const source = extractStringContent(firstArg);\n  if (source === undefined) {\n    errors.push(`${locationStr(callNode)}: could not extract string content`);\n    return;\n  }\n\n  // Extract keyword arguments and check for derive in _context\n  const metadata = extractKwargs(argsNode, errors, callNode, imports);\n\n  const rootNode = callNode.tree?.rootNode;\n  const contextVariants = rootNode\n    ? await extractDeriveContext(argsNode, imports, filePath, rootNode, errors)\n    : null;\n\n  if (contextVariants) {\n    const staticId = `static-temp-id-${randomUUID()}`;\n    for (const context of contextVariants) {\n      calls.push({\n        source,\n        ...metadata,\n        context,\n        staticId,\n        line: callNode.startPosition.row + 1,\n        column: callNode.startPosition.column,\n      });\n    }\n  } else {\n    calls.push({\n      source,\n      ...metadata,\n      line: callNode.startPosition.row + 1,\n      column: callNode.startPosition.column,\n    });\n  }\n}\n\nfunction extractKwargs(\n  argsNode: SyntaxNode,\n  errors: string[],\n  callNode: SyntaxNode,\n  imports?: ImportAlias[]\n): { id?: string; context?: string; maxChars?: number } {\n  const result: { id?: string; context?: string; maxChars?: number } = {};\n\n  for (let i = 0; i < argsNode.childCount; i++) {\n    const child = argsNode.child(i);\n    if (!child || child.type !== 'keyword_argument') continue;\n\n    const nameNode = child.childForFieldName('name');\n    const valueNode = child.childForFieldName('value');\n    if (!nameNode || !valueNode) continue;\n\n    const kwargName = nameNode.text;\n    const metadataKey = (\n      PYTHON_METADATA_KWARGS as Record<string, string | undefined>\n    )[kwargName];\n    if (!metadataKey) continue;\n\n    if (metadataKey === 'maxChars') {\n      if (valueNode.type === 'integer') {\n        result.maxChars = parseInt(valueNode.text, 10);\n      } else {\n        errors.push(\n          `${locationStr(callNode)}: _max_chars must be an integer literal`\n        );\n      }\n    } else {\n      if (valueNode.type === 'string' && !isFString(valueNode)) {\n        const value = extractStringContent(valueNode);\n        if (value !== undefined) {\n          if (metadataKey === 'id') result.id = value;\n          else if (metadataKey === 'context') result.context = value;\n        }\n      } else if (\n        metadataKey === 'context' &&\n        imports &&\n        containsStaticCalls(valueNode, imports)\n      ) {\n        // _context contains derive() — skip error, caller handles derivation\n      } else {\n        errors.push(\n          `${locationStr(callNode)}: _${metadataKey} must be a string literal`\n        );\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Finds the _context keyword argument node and, if it contains a derive() call,\n * parses it into context variants. Returns null if _context is static or absent.\n */\nasync function extractDeriveContext(\n  argsNode: SyntaxNode,\n  imports: ImportAlias[],\n  filePath: string,\n  rootNode: SyntaxNode,\n  errors: string[]\n): Promise<string[] | null> {\n  // Find _context kwarg\n  for (let i = 0; i < argsNode.childCount; i++) {\n    const child = argsNode.child(i);\n    if (!child || child.type !== 'keyword_argument') continue;\n\n    const nameNode = child.childForFieldName('name');\n    const valueNode = child.childForFieldName('value');\n    if (!nameNode || !valueNode) continue;\n    if (nameNode.text !== '_context') continue;\n\n    // Check if value contains derive()\n    if (!containsStaticCalls(valueNode, imports)) return null;\n\n    const contextNode = await parseStringExpression(valueNode, {\n      rootNode,\n      imports,\n      filePath,\n      errors,\n    });\n    if (!contextNode) return null;\n\n    return nodeToStrings(contextNode);\n  }\n  return null;\n}\n\nfunction isFString(stringNode: SyntaxNode): boolean {\n  // Check if string_start begins with 'f' or 'F'\n  for (let i = 0; i < stringNode.childCount; i++) {\n    const child = stringNode.child(i);\n    if (child && child.type === 'string_start') {\n      return /^[fF]/.test(child.text);\n    }\n    // Also check for interpolation children (hallmark of f-strings)\n    if (child && child.type === 'interpolation') {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction extractStringContent(stringNode: SyntaxNode): string | undefined {\n  // Look for string_content child\n  for (let i = 0; i < stringNode.childCount; i++) {\n    const child = stringNode.child(i);\n    if (child && child.type === 'string_content') {\n      return child.text;\n    }\n  }\n\n  // Empty string — no string_content child, but has string_start and string_end\n  let hasStart = false;\n  let hasEnd = false;\n  for (let i = 0; i < stringNode.childCount; i++) {\n    const child = stringNode.child(i);\n    if (child?.type === 'string_start') hasStart = true;\n    if (child?.type === 'string_end') hasEnd = true;\n  }\n  if (hasStart && hasEnd) return '';\n\n  return undefined;\n}\n\nfunction locationStr(node: SyntaxNode): string {\n  return `line ${node.startPosition.row + 1}, col ${node.startPosition.column}`;\n}\n"],"mappings":"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"}