@lingo.dev/compiler 0.1.0

package/build/plugin/transform/metadata.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.mjs","names":["keyName: string | null","entries: TranslationEntry[]"],"sources":["../../../src/plugin/transform/metadata.ts"],"sourcesContent":["/**\n * Transforms Next.js metadata object to use t() calls. See https://nextjs.org/docs/app/getting-started/metadata-and-og-images for docs on next metadata.\n */\nimport * as t from \"@babel/types\";\nimport {\n  isObjectExpression,\n  isReturnStatement,\n  type VariableDeclarator,\n} from \"@babel/types\";\nimport {\n  constructServerTranslationHookCall,\n  createTranslationEntry,\n} from \"./utils\";\nimport type { NodePath } from \"@babel/traverse\";\nimport type { TranslationEntry } from \"../../types\";\nimport type { VisitorsInternalState } from \"./process-file\";\n\n/**\n * Whitelist of metadata fields that should be translated.\n * Other fields (like technical configurations, URLs, etc.) are left unchanged.\n */\nconst TRANSLATABLE_METADATA_FIELDS = new Set([\n  // Top-level fields\n  \"title\",\n  \"description\",\n\n  // Title object fields (template and default)\n  \"title.template\",\n  \"title.default\",\n\n  // OpenGraph fields\n  \"openGraph.title\",\n  \"openGraph.description\",\n  \"openGraph.images[*].alt\",\n\n  // Twitter fields\n  \"twitter.title\",\n  \"twitter.description\",\n  \"twitter.images[*].alt\",\n\n  // Apple Web App\n  \"appleWebApp.title\",\n]);\n\nconst NEXT_METADATA_EXPORT_NAME = \"metadata\";\nconst NEXT_GENERATE_METADATA_FUNCTION_NAME = \"generateMetadata\";\n\ntype MetadataInputState = Pick<VisitorsInternalState, \"filePath\">;\nexport type MetadataOutputState = Pick<\n  VisitorsInternalState,\n  \"newEntries\" | \"needsAsyncImport\"\n>;\n\n/**\n * Check if a field path matches a pattern with array indices.\n * For example: \"openGraph.images[0].alt\" matches \"openGraph.images[*].alt\"\n */\nfunction matchesArrayPattern(fieldPath: string, pattern: string): boolean {\n  // Replace [number] with [*] for comparison\n  const normalizedPath = fieldPath.replace(/\\[\\d+]/g, \"[*]\");\n  return normalizedPath === pattern;\n}\n\n/**\n * Check if a metadata field path should be translated\n */\nfunction isTranslatableMetadataField(fieldPath: string): boolean {\n  // Direct match\n  if (TRANSLATABLE_METADATA_FIELDS.has(fieldPath)) {\n    return true;\n  }\n\n  // Check for array pattern matches (e.g., images[0].alt matches images[*].alt)\n  for (const pattern of TRANSLATABLE_METADATA_FIELDS) {\n    if (pattern.includes(\"[*]\") && matchesArrayPattern(fieldPath, pattern)) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nfunction isNextGenerateMetadataFunction(path: NodePath<t.FunctionDeclaration>) {\n  if (path.node.id?.name === NEXT_GENERATE_METADATA_FUNCTION_NAME) {\n    // Check if it's exported\n    const parent = path.parent;\n    if (parent.type === \"ExportNamedDeclaration\" || parent.type === \"Program\") {\n      return true;\n    }\n  }\n}\n\nfunction getNextMetadataObjectOrNull(\n  path: NodePath<t.ExportNamedDeclaration>,\n): VariableDeclarator[\"init\"] | null {\n  const declaration = path.node.declaration;\n  if (!declaration || declaration.type !== \"VariableDeclaration\") return null;\n\n  const declarator = declaration.declarations[0];\n  if (!declarator || declarator.id.type !== \"Identifier\") return null;\n  if (declarator.id.name === NEXT_METADATA_EXPORT_NAME && declarator.init) {\n    return declarator.init;\n  }\n}\n\n/**\n * Recursively transforms metadata object properties to use t() calls\n */\nfunction transformMetadataObject(\n  objectExpression: t.ObjectExpression,\n  state: MetadataInputState,\n  entries: TranslationEntry[],\n  parentPath: string = \"\",\n): void {\n  for (const prop of objectExpression.properties) {\n    if (prop.type !== \"ObjectProperty\") continue;\n\n    // Get the key name\n    let keyName: string | null = null;\n    if (prop.key.type === \"Identifier\") {\n      keyName = prop.key.name;\n    } else if (prop.key.type === \"StringLiteral\") {\n      keyName = prop.key.value;\n    }\n\n    if (!keyName) continue;\n\n    const fieldPath = parentPath ? `${parentPath}.${keyName}` : keyName;\n\n    // Check if this field should be translated\n    const shouldTranslate = isTranslatableMetadataField(fieldPath);\n    // Transform string values (only if whitelisted)\n    if (prop.value.type === \"StringLiteral\" && shouldTranslate) {\n      const text = prop.value.value;\n      const entry = createTranslationEntry(\n        \"metadata\",\n        text,\n        {\n          fieldPath: fieldPath,\n        },\n        state.filePath,\n        prop.value.loc?.start.line,\n        prop.value.loc?.start.column,\n      );\n      entries.push(entry);\n\n      // Replace with t(hash, fallback) call\n      prop.value = t.callExpression(t.identifier(\"t\"), [\n        t.stringLiteral(entry.hash),\n        t.stringLiteral(text),\n      ]);\n      // Only static template literals like `content`\n    } else if (prop.value.type === \"TemplateLiteral\" && shouldTranslate) {\n      if (\n        prop.value.expressions.length === 0 &&\n        prop.value.quasis.length === 1\n      ) {\n        const staticValue = prop.value.quasis[0].value.cooked;\n        if (staticValue) {\n          const entry = createTranslationEntry(\n            \"metadata\",\n            staticValue,\n            {\n              fieldPath: fieldPath,\n            },\n            state.filePath,\n            prop.value.loc?.start.line,\n            prop.value.loc?.start.column,\n          );\n          entries.push(entry);\n\n          // Replace with t(hash, fallback) call\n          prop.value = t.callExpression(t.identifier(\"t\"), [\n            t.stringLiteral(entry.hash),\n            t.stringLiteral(staticValue),\n          ]);\n        }\n      }\n    }\n    // Transform nested objects (always recurse to check nested fields)\n    else if (prop.value.type === \"ObjectExpression\") {\n      transformMetadataObject(prop.value, state, entries, fieldPath);\n    }\n    // Handle arrays (e.g., images: [{url: '...', alt: '...'}])\n    else if (prop.value.type === \"ArrayExpression\") {\n      prop.value.elements.forEach((element, index) => {\n        if (element && element.type === \"ObjectExpression\") {\n          transformMetadataObject(\n            element,\n            state,\n            entries,\n            `${fieldPath}[${index}]`,\n          );\n        }\n      });\n    }\n  }\n}\n\n/**\n * Transform existing generateMetadata function to add translations\n */\nfunction transformMetadataFunction(\n  path: NodePath<t.FunctionDeclaration>,\n  state: MetadataInputState,\n): MetadataOutputState | null {\n  const body = path.get(\"body\");\n  if (!body.isBlockStatement()) return null;\n\n  // Find the return statement with metadata object\n  let metadataReturn = undefined as NodePath<t.ReturnStatement> | undefined;\n  body.traverse({\n    ReturnStatement(returnPath) {\n      if (!metadataReturn) {\n        metadataReturn = returnPath;\n      }\n    },\n  });\n\n  if (!isReturnStatement(metadataReturn) || !metadataReturn.node.argument)\n    return null;\n  if (!isObjectExpression(metadataReturn.node.argument)) return null;\n\n  const entries: TranslationEntry[] = [];\n  const metadataObject = metadataReturn.node.argument;\n  transformMetadataObject(metadataObject, state, entries);\n\n  if (entries.length === 0) {\n    return null;\n  }\n\n  // Server translations require function to be async.\n  if (!path.node.async) {\n    path.node.async = true;\n  }\n\n  const serverCall = constructServerTranslationHookCall({\n    hashes: entries.map((e) => e.hash),\n  });\n  body.node.body.unshift(serverCall);\n\n  return {\n    needsAsyncImport: true,\n    newEntries: entries,\n  };\n}\n\n/**\n * Process static metadata export\n * Only converts to function if there are translatable strings\n */\nexport function processNextStaticMetadata(\n  path: NodePath<t.ExportNamedDeclaration>,\n  state: MetadataInputState,\n): MetadataOutputState | null {\n  // Get the metadata object\n  const metadataObject = getNextMetadataObjectOrNull(path);\n  if (!metadataObject || metadataObject.type !== \"ObjectExpression\")\n    return null;\n\n  // Clone and try transforming (transformMetadataObject modifies in place)\n  const clonedObject = t.cloneNode(metadataObject, true);\n  const entries: TranslationEntry[] = [];\n  transformMetadataObject(clonedObject, state, entries);\n\n  // If nothing to translate, leave as-is\n  if (entries.length === 0) {\n    return null;\n  }\n\n  // Create async generateMetadata function with transformed object\n  const serverCall = constructServerTranslationHookCall({\n    hashes: entries.map((e) => e.hash),\n  });\n\n  const generateMetadataFunction = t.functionDeclaration(\n    t.identifier(NEXT_GENERATE_METADATA_FUNCTION_NAME),\n    [],\n    t.blockStatement([serverCall, t.returnStatement(clonedObject)]),\n    false,\n    true, // async - required for server translations\n  );\n\n  // Replace static export with function export\n  path.replaceWith(t.exportNamedDeclaration(generateMetadataFunction, []));\n  path.skip();\n\n  return {\n    needsAsyncImport: true,\n    newEntries: entries,\n  };\n}\n\nexport function processNextDynamicMetadata(\n  path: NodePath<t.FunctionDeclaration>,\n  state: MetadataInputState,\n): MetadataOutputState | null {\n  if (!isNextGenerateMetadataFunction(path)) return null;\n  const newState = transformMetadataFunction(path, state);\n  path.skip();\n  return newState;\n}\n"],"mappings":"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"}

package/build/plugin/transform/parse-override.cjs

@@ -0,0 +1,145 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_logger = require('../../utils/logger.cjs');
+let _babel_types = require("@babel/types");
+_babel_types = require_rolldown_runtime.__toESM(_babel_types);
+
+//#region src/plugin/transform/parse-override.ts
+const OVERRIDE_ATTRIBUTE = "data-lingo-override";
+/**
+* Parse the data-lingo-override attribute value
+* Supports object expression: data-lingo-override={{ de: "text", fr: "text" }}
+*
+* @param attr - The JSX attribute to parse
+* @returns Parsed overrides object or null if invalid
+*/
+function parseOverrideAttribute(attr) {
+	if (!attr.value) {
+		require_logger.logger.warn(`${OVERRIDE_ATTRIBUTE} attribute has no value`);
+		return null;
+	}
+	try {
+		if (_babel_types.isJSXExpressionContainer(attr.value)) {
+			const result = parseObjectExpression(attr.value.expression);
+			require_logger.logger.debug(`[PARSE_OVERRIDE] Parsed JSXExpressionContainer:`, result);
+			return result;
+		}
+		require_logger.logger.warn(`${OVERRIDE_ATTRIBUTE} must be an object expression`);
+		return null;
+	} catch (error) {
+		require_logger.logger.warn(`Failed to parse ${OVERRIDE_ATTRIBUTE}:`, error);
+		return null;
+	}
+}
+/**
+* Parse object expression from JSX: {{ de: "text", fr: "text" }}
+*/
+function parseObjectExpression(expression) {
+	if (_babel_types.isJSXEmptyExpression(expression)) {
+		require_logger.logger.warn(`${OVERRIDE_ATTRIBUTE} cannot be empty`);
+		return null;
+	}
+	if (!_babel_types.isObjectExpression(expression)) {
+		require_logger.logger.warn(`${OVERRIDE_ATTRIBUTE} must be an object expression, got: ${expression.type}`);
+		return null;
+	}
+	const overrides = {};
+	for (const prop of expression.properties) {
+		if (_babel_types.isSpreadElement(prop)) {
+			require_logger.logger.warn(`${OVERRIDE_ATTRIBUTE} does not support spread properties`);
+			continue;
+		}
+		if (!_babel_types.isObjectProperty(prop)) {
+			require_logger.logger.warn(`${OVERRIDE_ATTRIBUTE} only supports simple properties`);
+			continue;
+		}
+		let key;
+		if (_babel_types.isIdentifier(prop.key)) key = prop.key.name;
+		else if (_babel_types.isStringLiteral(prop.key)) key = prop.key.value;
+		else {
+			require_logger.logger.warn(`${OVERRIDE_ATTRIBUTE} keys must be identifiers or strings, got: ${prop.key.type}`);
+			continue;
+		}
+		let value;
+		if (_babel_types.isStringLiteral(prop.value)) {
+			value = prop.value.value;
+			require_logger.logger.debug(`[PARSE_OVERRIDE] Parsed string literal for ${key}: "${value}"`);
+		} else if (_babel_types.isTemplateLiteral(prop.value) && prop.value.quasis.length === 1 && prop.value.expressions.length === 0) {
+			value = prop.value.quasis[0].value.cooked || "";
+			require_logger.logger.debug(`[PARSE_OVERRIDE] Parsed template literal for ${key}: "${value}"`);
+		} else {
+			require_logger.logger.warn(`${OVERRIDE_ATTRIBUTE} value for "${key}" must be a string literal, got: ${prop.value.type}`);
+			continue;
+		}
+		overrides[key] = value;
+	}
+	require_logger.logger.debug(`[PARSE_OVERRIDE] Final overrides object:`, overrides);
+	return Object.keys(overrides).length > 0 ? overrides : null;
+}
+/**
+* Validate override object
+* Checks:
+* - Is a plain object
+* - All keys are valid locale codes (basic check)
+* - All values are non-empty strings
+*
+* @param overrides - The overrides to validate
+* @returns true if valid, false otherwise
+*/
+function validateOverrides(overrides) {
+	if (typeof overrides !== "object" || overrides === null || Array.isArray(overrides)) {
+		require_logger.logger.warn("Overrides must be a plain object");
+		return false;
+	}
+	const entries = Object.entries(overrides);
+	if (entries.length === 0) {
+		require_logger.logger.warn("Overrides object is empty");
+		return false;
+	}
+	for (const [locale, text] of entries) {
+		if (!/^[a-z]{2}(-[A-Z]{2})?$/.test(locale)) {
+			require_logger.logger.warn(`Invalid locale code "${locale}" in overrides. Expected format: "en" or "en-US"`);
+			return false;
+		}
+		if (typeof text !== "string" || text.trim().length === 0) {
+			require_logger.logger.warn(`Override for locale "${locale}" must be a non-empty string`);
+			return false;
+		}
+	}
+	return true;
+}
+/**
+* Find the ${OVERRIDE_ATTRIBUTE} attribute in a JSX element
+*
+* @param attributes - Array of JSX attributes
+* @returns The override attribute or undefined
+*/
+function findOverrideAttribute(attributes) {
+	return attributes.find((attr) => _babel_types.isJSXAttribute(attr) && _babel_types.isJSXIdentifier(attr.name) && attr.name.name === OVERRIDE_ATTRIBUTE);
+}
+/**
+* Remove the ${OVERRIDE_ATTRIBUTE} attribute from a JSX element
+* (We don't want this to appear in the final transformed output)
+*
+* @param attributes - Array of JSX attributes
+* @returns Array with override attribute removed
+*/
+function removeOverrideAttribute(attributes) {
+	return attributes.filter((attr) => !(_babel_types.isJSXAttribute(attr) && _babel_types.isJSXIdentifier(attr.name) && attr.name.name === `${OVERRIDE_ATTRIBUTE}`));
+}
+function processOverrideAttributes(path) {
+	let overrides;
+	if (path.node.type === "JSXElement") {
+		const overrideAttr = findOverrideAttribute(path.node.openingElement.attributes);
+		if (overrideAttr) {
+			const parsedOverrides = parseOverrideAttribute(overrideAttr);
+			if (parsedOverrides && validateOverrides(parsedOverrides)) {
+				overrides = parsedOverrides;
+				path.node.openingElement.attributes = removeOverrideAttribute(path.node.openingElement.attributes);
+			}
+		}
+	}
+	return overrides;
+}
+
+//#endregion
+exports.processOverrideAttributes = processOverrideAttributes;

package/build/plugin/transform/parse-override.mjs

@@ -0,0 +1,144 @@
+import { logger } from "../../utils/logger.mjs";
+import * as t from "@babel/types";
+
+//#region src/plugin/transform/parse-override.ts
+const OVERRIDE_ATTRIBUTE = "data-lingo-override";
+/**
+* Parse the data-lingo-override attribute value
+* Supports object expression: data-lingo-override={{ de: "text", fr: "text" }}
+*
+* @param attr - The JSX attribute to parse
+* @returns Parsed overrides object or null if invalid
+*/
+function parseOverrideAttribute(attr) {
+	if (!attr.value) {
+		logger.warn(`${OVERRIDE_ATTRIBUTE} attribute has no value`);
+		return null;
+	}
+	try {
+		if (t.isJSXExpressionContainer(attr.value)) {
+			const result = parseObjectExpression(attr.value.expression);
+			logger.debug(`[PARSE_OVERRIDE] Parsed JSXExpressionContainer:`, result);
+			return result;
+		}
+		logger.warn(`${OVERRIDE_ATTRIBUTE} must be an object expression`);
+		return null;
+	} catch (error) {
+		logger.warn(`Failed to parse ${OVERRIDE_ATTRIBUTE}:`, error);
+		return null;
+	}
+}
+/**
+* Parse object expression from JSX: {{ de: "text", fr: "text" }}
+*/
+function parseObjectExpression(expression) {
+	if (t.isJSXEmptyExpression(expression)) {
+		logger.warn(`${OVERRIDE_ATTRIBUTE} cannot be empty`);
+		return null;
+	}
+	if (!t.isObjectExpression(expression)) {
+		logger.warn(`${OVERRIDE_ATTRIBUTE} must be an object expression, got: ${expression.type}`);
+		return null;
+	}
+	const overrides = {};
+	for (const prop of expression.properties) {
+		if (t.isSpreadElement(prop)) {
+			logger.warn(`${OVERRIDE_ATTRIBUTE} does not support spread properties`);
+			continue;
+		}
+		if (!t.isObjectProperty(prop)) {
+			logger.warn(`${OVERRIDE_ATTRIBUTE} only supports simple properties`);
+			continue;
+		}
+		let key;
+		if (t.isIdentifier(prop.key)) key = prop.key.name;
+		else if (t.isStringLiteral(prop.key)) key = prop.key.value;
+		else {
+			logger.warn(`${OVERRIDE_ATTRIBUTE} keys must be identifiers or strings, got: ${prop.key.type}`);
+			continue;
+		}
+		let value;
+		if (t.isStringLiteral(prop.value)) {
+			value = prop.value.value;
+			logger.debug(`[PARSE_OVERRIDE] Parsed string literal for ${key}: "${value}"`);
+		} else if (t.isTemplateLiteral(prop.value) && prop.value.quasis.length === 1 && prop.value.expressions.length === 0) {
+			value = prop.value.quasis[0].value.cooked || "";
+			logger.debug(`[PARSE_OVERRIDE] Parsed template literal for ${key}: "${value}"`);
+		} else {
+			logger.warn(`${OVERRIDE_ATTRIBUTE} value for "${key}" must be a string literal, got: ${prop.value.type}`);
+			continue;
+		}
+		overrides[key] = value;
+	}
+	logger.debug(`[PARSE_OVERRIDE] Final overrides object:`, overrides);
+	return Object.keys(overrides).length > 0 ? overrides : null;
+}
+/**
+* Validate override object
+* Checks:
+* - Is a plain object
+* - All keys are valid locale codes (basic check)
+* - All values are non-empty strings
+*
+* @param overrides - The overrides to validate
+* @returns true if valid, false otherwise
+*/
+function validateOverrides(overrides) {
+	if (typeof overrides !== "object" || overrides === null || Array.isArray(overrides)) {
+		logger.warn("Overrides must be a plain object");
+		return false;
+	}
+	const entries = Object.entries(overrides);
+	if (entries.length === 0) {
+		logger.warn("Overrides object is empty");
+		return false;
+	}
+	for (const [locale, text] of entries) {
+		if (!/^[a-z]{2}(-[A-Z]{2})?$/.test(locale)) {
+			logger.warn(`Invalid locale code "${locale}" in overrides. Expected format: "en" or "en-US"`);
+			return false;
+		}
+		if (typeof text !== "string" || text.trim().length === 0) {
+			logger.warn(`Override for locale "${locale}" must be a non-empty string`);
+			return false;
+		}
+	}
+	return true;
+}
+/**
+* Find the ${OVERRIDE_ATTRIBUTE} attribute in a JSX element
+*
+* @param attributes - Array of JSX attributes
+* @returns The override attribute or undefined
+*/
+function findOverrideAttribute(attributes) {
+	return attributes.find((attr) => t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name) && attr.name.name === OVERRIDE_ATTRIBUTE);
+}
+/**
+* Remove the ${OVERRIDE_ATTRIBUTE} attribute from a JSX element
+* (We don't want this to appear in the final transformed output)
+*
+* @param attributes - Array of JSX attributes
+* @returns Array with override attribute removed
+*/
+function removeOverrideAttribute(attributes) {
+	return attributes.filter((attr) => !(t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name) && attr.name.name === `${OVERRIDE_ATTRIBUTE}`));
+}
+function processOverrideAttributes(path) {
+	let overrides;
+	if (path.node.type === "JSXElement") {
+		const overrideAttr = findOverrideAttribute(path.node.openingElement.attributes);
+		if (overrideAttr) {
+			const parsedOverrides = parseOverrideAttribute(overrideAttr);
+			if (parsedOverrides && validateOverrides(parsedOverrides)) {
+				overrides = parsedOverrides;
+				path.node.openingElement.attributes = removeOverrideAttribute(path.node.openingElement.attributes);
+			}
+		}
+	}
+	return overrides;
+}
+
+//#endregion
+export { processOverrideAttributes };
+//# sourceMappingURL=parse-override.mjs.map

package/build/plugin/transform/parse-override.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-override.mjs","names":["overrides: Record<string, string>","key: string","value: string","overrides: Record<string, string> | undefined"],"sources":["../../../src/plugin/transform/parse-override.ts"],"sourcesContent":["/**\n * Utilities for parsing and validating translation override attributes\n */\n\nimport type { JSXAttribute } from \"@babel/types\";\nimport * as t from \"@babel/types\";\nimport { logger } from \"../../utils/logger.js\";\nimport type { NodePath } from \"@babel/traverse\";\n\nconst OVERRIDE_ATTRIBUTE = \"data-lingo-override\";\n\n/**\n * Parse the data-lingo-override attribute value\n * Supports object expression: data-lingo-override={{ de: \"text\", fr: \"text\" }}\n *\n * @param attr - The JSX attribute to parse\n * @returns Parsed overrides object or null if invalid\n */\nexport function parseOverrideAttribute(\n  attr: JSXAttribute,\n): Record<string, string> | null {\n  if (!attr.value) {\n    logger.warn(`${OVERRIDE_ATTRIBUTE} attribute has no value`);\n    return null;\n  }\n\n  try {\n    // Handle JSXExpressionContainer: {{ de: \"...\", fr: \"...\" }}\n    if (t.isJSXExpressionContainer(attr.value)) {\n      const result = parseObjectExpression(attr.value.expression);\n      logger.debug(`[PARSE_OVERRIDE] Parsed JSXExpressionContainer:`, result);\n      return result;\n    }\n\n    logger.warn(`${OVERRIDE_ATTRIBUTE} must be an object expression`);\n    return null;\n  } catch (error) {\n    logger.warn(`Failed to parse ${OVERRIDE_ATTRIBUTE}:`, error);\n    return null;\n  }\n}\n\n/**\n * Parse object expression from JSX: {{ de: \"text\", fr: \"text\" }}\n */\nfunction parseObjectExpression(\n  expression: t.Expression | t.JSXEmptyExpression,\n): Record<string, string> | null {\n  if (t.isJSXEmptyExpression(expression)) {\n    logger.warn(`${OVERRIDE_ATTRIBUTE} cannot be empty`);\n    return null;\n  }\n\n  if (!t.isObjectExpression(expression)) {\n    logger.warn(\n      `${OVERRIDE_ATTRIBUTE} must be an object expression, got: ${expression.type}`,\n    );\n    return null;\n  }\n\n  const overrides: Record<string, string> = {};\n\n  for (const prop of expression.properties) {\n    // Skip spread properties\n    if (t.isSpreadElement(prop)) {\n      logger.warn(`${OVERRIDE_ATTRIBUTE} does not support spread properties`);\n      continue;\n    }\n\n    // Only support ObjectProperty (not methods or getters/setters)\n    if (!t.isObjectProperty(prop)) {\n      logger.warn(`${OVERRIDE_ATTRIBUTE} only supports simple properties`);\n      continue;\n    }\n\n    // Get the key (locale code)\n    let key: string;\n    if (t.isIdentifier(prop.key)) {\n      key = prop.key.name;\n    } else if (t.isStringLiteral(prop.key)) {\n      key = prop.key.value;\n    } else {\n      logger.warn(\n        `${OVERRIDE_ATTRIBUTE} keys must be identifiers or strings, got: ${prop.key.type}`,\n      );\n      continue;\n    }\n\n    // Get the value (translated text)\n    let value: string;\n    if (t.isStringLiteral(prop.value)) {\n      value = prop.value.value;\n      logger.debug(\n        `[PARSE_OVERRIDE] Parsed string literal for ${key}: \"${value}\"`,\n      );\n    } else if (\n      t.isTemplateLiteral(prop.value) &&\n      prop.value.quasis.length === 1 &&\n      prop.value.expressions.length === 0\n    ) {\n      // Support template literals with no expressions: `text`\n      value = prop.value.quasis[0].value.cooked || \"\";\n      logger.debug(\n        `[PARSE_OVERRIDE] Parsed template literal for ${key}: \"${value}\"`,\n      );\n    } else {\n      logger.warn(\n        `${OVERRIDE_ATTRIBUTE} value for \"${key}\" must be a string literal, got: ${prop.value.type}`,\n      );\n      continue;\n    }\n\n    overrides[key] = value;\n  }\n\n  logger.debug(`[PARSE_OVERRIDE] Final overrides object:`, overrides);\n  return Object.keys(overrides).length > 0 ? overrides : null;\n}\n\n/**\n * Validate override object\n * Checks:\n * - Is a plain object\n * - All keys are valid locale codes (basic check)\n * - All values are non-empty strings\n *\n * @param overrides - The overrides to validate\n * @returns true if valid, false otherwise\n */\nexport function validateOverrides(overrides: Record<string, string>): boolean {\n  if (\n    typeof overrides !== \"object\" ||\n    overrides === null ||\n    Array.isArray(overrides)\n  ) {\n    logger.warn(\"Overrides must be a plain object\");\n    return false;\n  }\n\n  const entries = Object.entries(overrides);\n  if (entries.length === 0) {\n    logger.warn(\"Overrides object is empty\");\n    return false;\n  }\n\n  for (const [locale, text] of entries) {\n    // Basic locale code validation (2-letter code or with region)\n    if (!/^[a-z]{2}(-[A-Z]{2})?$/.test(locale)) {\n      logger.warn(\n        `Invalid locale code \"${locale}\" in overrides. Expected format: \"en\" or \"en-US\"`,\n      );\n      return false;\n    }\n\n    // Check value is non-empty string\n    if (typeof text !== \"string\" || text.trim().length === 0) {\n      logger.warn(`Override for locale \"${locale}\" must be a non-empty string`);\n      return false;\n    }\n  }\n\n  return true;\n}\n\n/**\n * Find the ${OVERRIDE_ATTRIBUTE} attribute in a JSX element\n *\n * @param attributes - Array of JSX attributes\n * @returns The override attribute or undefined\n */\nexport function findOverrideAttribute(\n  attributes: (t.JSXAttribute | t.JSXSpreadAttribute)[],\n): JSXAttribute | undefined {\n  const found = attributes.find(\n    (attr): attr is JSXAttribute =>\n      t.isJSXAttribute(attr) &&\n      t.isJSXIdentifier(attr.name) &&\n      attr.name.name === OVERRIDE_ATTRIBUTE,\n  );\n  return found;\n}\n\n/**\n * Remove the ${OVERRIDE_ATTRIBUTE} attribute from a JSX element\n * (We don't want this to appear in the final transformed output)\n *\n * @param attributes - Array of JSX attributes\n * @returns Array with override attribute removed\n */\nexport function removeOverrideAttribute(\n  attributes: (t.JSXAttribute | t.JSXSpreadAttribute)[],\n): (t.JSXAttribute | t.JSXSpreadAttribute)[] {\n  return attributes.filter(\n    (attr) =>\n      !(\n        t.isJSXAttribute(attr) &&\n        t.isJSXIdentifier(attr.name) &&\n        attr.name.name === `${OVERRIDE_ATTRIBUTE}`\n      ),\n  );\n}\n\nexport function processOverrideAttributes(\n  path: NodePath<t.JSXElement | t.JSXFragment>,\n): Record<string, string> | undefined {\n  // Check for override attribute (only on JSXElement, not Fragment)\n  let overrides: Record<string, string> | undefined;\n  if (path.node.type === \"JSXElement\") {\n    const overrideAttr = findOverrideAttribute(\n      path.node.openingElement.attributes,\n    );\n    if (overrideAttr) {\n      const parsedOverrides = parseOverrideAttribute(overrideAttr);\n      if (parsedOverrides && validateOverrides(parsedOverrides)) {\n        overrides = parsedOverrides;\n        // Remove the override attribute from the output\n        path.node.openingElement.attributes = removeOverrideAttribute(\n          path.node.openingElement.attributes,\n        );\n      }\n    }\n  }\n  return overrides;\n}\n"],"mappings":"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"}