@gtkx/cli 2.0.0-beta.1 → 2.0.0-beta.3

package/dist/i18n/source-messages.js

@@ -1,8 +1,11 @@
+import { parseSync as parseBabelSync, traverse, types } from "@babel/core";
 import { isPathInside, isPathWithin, toPosixPath } from "@gtkx/utils";
 import { runExtractor } from "i18next-cli";
 import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { parseSync, Visitor } from "vite";
 import { runCliTool } from "../internal/run-cli-tool.js";
+import { sourceLanguage } from "../internal/source-imports.js";
 import { replaceCatalogTemplate } from "./catalog-template.js";
 import { metadataTemplateFiles } from "./metadata-templates.js";
 import { clearI18nResources, i18nToolkitConfig } from "./types.js";
@@ -10,6 +13,82 @@ const CONTEXT_SEPARATOR = "\u{4}";
 const DEFAULT_NAMESPACE = "translation";
 const POTFILES_FILENAME = "POTFILES.in";
 const SYNTHETIC_FILENAME = "messages.js";
+const UNSUPPORTED_PLURAL_OPTION = /^defaultValue_(few|many|two|zero)$/u;
+const STATIC_SOURCE_OPTION_NAMES = new Set([
+    "context",
+    "defaultValue",
+    "defaultValue_one",
+    "defaultValue_other",
+    "keyPrefix",
+]);
+const NESTED_CONTEXT = /["']?context["']?\s*:\s*(?:"([^"]*)"|'([^']*)')/u;
+const NESTED_COUNT = /["']?count["']?\s*:/u;
+const NESTED_STRUCTURE_TOKEN = /"[^"]*"|'[^']*'|[()]/gu;
+const TRANSLATION_MODULES = new Set(["@gtkx/i18n", "i18next"]);
+const TRANS_ELEMENTS = new Set(["Trans", "TransWithoutContext"]);
+const STATIC_KEY_WRAPPER_TYPES = new Set([
+    "ParenthesizedExpression",
+    "TSAsExpression",
+    "TSSatisfiesExpression",
+    "TSTypeAssertion",
+    "TSNonNullExpression",
+]);
+class SourceExtractionError extends Error {
+}
+const sourceErrorMessage = (error) => error instanceof Error ? error.message : String(error);
+const projectSourcePath = (root, path) => {
+    const absolute = isAbsolute(path) ? resolve(path) : resolve(root, path);
+    return toPosixPath(isPathInside(root, absolute) ? relative(root, absolute) : path);
+};
+const sourceExtractionError = (root, path, point, error) => {
+    if (error instanceof SourceExtractionError) {
+        return error;
+    }
+    const file = projectSourcePath(root, path);
+    const location = point === null
+        ? file
+        : `${file}:${String(point.line)}:${String(point.column + 1)}`;
+    return new SourceExtractionError(`${location}: ${sourceErrorMessage(error)}`, { cause: error });
+};
+const locatablePoint = (node) => {
+    const location = node.loc?.start;
+    return location === undefined ? null : { column: location.column, line: location.line };
+};
+const isSourcePoint = (value) => typeof value === "object" &&
+    value !== null &&
+    "column" in value &&
+    typeof value.column === "number" &&
+    "line" in value &&
+    typeof value.line === "number";
+const errorSourcePoint = (error) => {
+    if (typeof error !== "object" || error === null) {
+        return null;
+    }
+    if ("loc" in error && isSourcePoint(error.loc)) {
+        return error.loc;
+    }
+    return "location" in error && isSourcePoint(error.location) ? error.location : null;
+};
+const atSourceNode = (root, path, node, operation) => {
+    try {
+        return operation();
+    }
+    catch (error) {
+        throw sourceExtractionError(root, path, locatablePoint(node), error);
+    }
+};
+const atExtractedLocation = (root, locations, operation) => {
+    const location = locations.find((candidate) => candidate.line !== undefined && candidate.column !== undefined);
+    if (location?.line === undefined || location.column === undefined) {
+        return operation();
+    }
+    try {
+        return operation();
+    }
+    catch (error) {
+        throw sourceExtractionError(root, location.file, { column: location.column, line: location.line }, error);
+    }
+};
 const quietLogger = () => {
     const reports = [];
     return {
@@ -98,10 +177,10 @@ const expandedPlural = (entry) => {
         },
     };
 };
-const groupedPlurals = (entries) => {
+const groupedPlurals = (root, entries) => {
     const groups = new Map();
     for (const entry of entries) {
-        const { baseKey, variant } = expandedPlural(entry);
+        const { baseKey, variant } = atExtractedLocation(root, entry.locations ?? [], () => expandedPlural(entry));
         const namespace = namespaceFor(entry);
         const key = `${namespace}\0${baseKey}`;
         const group = groups.get(key) ?? { baseKey, namespace, variants: [] };
@@ -140,17 +219,19 @@ const pluralMessage = ({ baseKey, namespace, variants }) => {
         sourceKey: msgid,
     };
 };
-const pluralMessages = (entries) => groupedPlurals(entries).map((group) => pluralMessage(group));
+const pluralMessages = (root, entries) => groupedPlurals(root, entries).map((group) => atExtractedLocation(root, group.variants.flatMap((variant) => variant.locations), () => pluralMessage(group)));
 const assertCardinal = (entry) => {
     if (entry.isOrdinal === true) {
         throw new Error("GNU gettext catalogs do not support i18next ordinal plurals");
     }
 };
-const sourceMessages = (entries) => {
+const sourceMessages = (root, entries) => {
     const points = [];
     const plurals = [];
     for (const entry of entries) {
-        assertCardinal(entry);
+        atExtractedLocation(root, entry.locations ?? [], () => {
+            assertCardinal(entry);
+        });
         if (entry.isExpandedPlural === true) {
             plurals.push(entry);
             continue;
@@ -160,7 +241,10 @@ const sourceMessages = (entries) => {
         }
         points.push(entry);
     }
-    return [...points.map((entry) => pointMessage(entry)), ...pluralMessages(plurals)];
+    return [
+        ...points.map((entry) => atExtractedLocation(root, entry.locations ?? [], () => pointMessage(entry))),
+        ...pluralMessages(root, plurals),
+    ];
 };
 const compareMessages = (left, right) => left.namespace.localeCompare(right.namespace) ||
     (left.context ?? "").localeCompare(right.context ?? "") ||
@@ -185,16 +269,885 @@ const normalizedSourceFiles = (root, paths) => {
         .filter((path) => isPathWithin(root, path));
     return new Set(files).values().toArray().toSorted((left, right) => left.localeCompare(right));
 };
+const isStaticKeyWrapper = (key) => STATIC_KEY_WRAPPER_TYPES.has(key.type);
+const unwrapStaticWrapper = (node) => isStaticKeyWrapper(node) ? unwrapStaticWrapper(node.expression) : node;
+const isStaticTranslationKey = (key) => {
+    if (key === undefined || key === null) {
+        return false;
+    }
+    if (key.type === "Literal") {
+        return typeof key.value === "string";
+    }
+    if (key.type === "TemplateLiteral") {
+        return key.expressions.length === 0;
+    }
+    if (key.type === "ParenthesizedExpression") {
+        return false;
+    }
+    if (isStaticKeyWrapper(key)) {
+        return isStaticTranslationKey(key.expression);
+    }
+    return false;
+};
+const assertStaticTranslationKey = (key) => {
+    if (!isStaticTranslationKey(key)) {
+        throw new Error("Translation keys must be string literals");
+    }
+};
+const propertyName = (property) => {
+    if (!property.computed && property.key.type === "Identifier") {
+        return property.key.name;
+    }
+    return property.key.type === "Literal" && typeof property.key.value === "string"
+        ? property.key.value
+        : null;
+};
+const assertSupportedOptionProperty = (property) => {
+    if (property.type === "SpreadElement") {
+        throw new Error("Translation extraction requires explicit option properties");
+    }
+    const name = propertyName(property);
+    if (name === null) {
+        throw new Error("Translation extraction requires static option property names");
+    }
+    if (UNSUPPORTED_PLURAL_OPTION.test(name)) {
+        throw new Error("GNU gettext accepts one singular and one plural source string");
+    }
+    if (STATIC_SOURCE_OPTION_NAMES.has(name)) {
+        assertStaticTranslationKey(property.value);
+    }
+};
+const assertSupportedOptionObject = (options) => {
+    if (options === null || options === undefined) {
+        return;
+    }
+    if (isStaticKeyWrapper(options) && unwrapStaticWrapper(options).type === "ObjectExpression") {
+        throw new Error("Translation option objects cannot be wrapped in another expression");
+    }
+    if (options.type !== "ObjectExpression") {
+        throw new Error("Translation option objects must be inline object literals");
+    }
+    for (const property of options.properties) {
+        assertSupportedOptionProperty(property);
+    }
+};
+const namedImportedBinding = (path, source) => {
+    if (!path.isImportSpecifier() || path.node.importKind === "type") {
+        return null;
+    }
+    const imported = path.node.imported;
+    return {
+        imported: types.isIdentifier(imported) ? imported.name : imported.value,
+        local: path.node.local.name,
+        source,
+        style: "named",
+    };
+};
+const defaultImportedBinding = (path, source) => path.isImportDefaultSpecifier()
+    ? { imported: "default", local: path.node.local.name, source, style: "default" }
+    : null;
+const namespaceImportedBinding = (path, source) => path.isImportNamespaceSpecifier()
+    ? { imported: "*", local: path.node.local.name, source, style: "namespace" }
+    : null;
+const importedBinding = (binding) => {
+    if (binding === undefined) {
+        return null;
+    }
+    const path = binding.path;
+    const declaration = path.parentPath;
+    if (!declaration.isImportDeclaration() || declaration.node.importKind === "type") {
+        return null;
+    }
+    const source = declaration.node.source.value;
+    return namedImportedBinding(path, source) ??
+        defaultImportedBinding(path, source) ??
+        namespaceImportedBinding(path, source);
+};
+const babelPropertyName = (property) => {
+    const key = property.key;
+    if (!property.computed && types.isIdentifier(key)) {
+        return key.name;
+    }
+    return types.isStringLiteral(key) ? key.value : null;
+};
+const isBoundIdentifier = (node, name) => {
+    if (types.isIdentifier(node)) {
+        return node.name === name;
+    }
+    if (types.isAssignmentPattern(node)) {
+        return types.isIdentifier(node.left) && node.left.name === name;
+    }
+    return false;
+};
+const isHookPatternBinding = (pattern, name) => {
+    if (types.isObjectPattern(pattern)) {
+        return pattern.properties.some((property) => types.isObjectProperty(property) &&
+            babelPropertyName(property) === "t" &&
+            isBoundIdentifier(property.value, name));
+    }
+    if (types.isArrayPattern(pattern)) {
+        return isBoundIdentifier(pattern.elements[0] ?? null, name);
+    }
+    return false;
+};
+const importedTranslationHook = (scope, call) => {
+    if (!types.isIdentifier(call.callee)) {
+        return null;
+    }
+    const imported = importedBinding(scope.getBinding(call.callee.name));
+    return imported?.imported === "useTranslation" && TRANSLATION_MODULES.has(imported.source)
+        ? imported
+        : null;
+};
+const translationHookBinding = (binding) => {
+    const path = binding.path;
+    if (!path.isVariableDeclarator()) {
+        return null;
+    }
+    const pattern = path.node.id;
+    const initializer = path.node.init;
+    if (!isHookPatternBinding(pattern, binding.identifier.name) ||
+        !types.isCallExpression(initializer)) {
+        return null;
+    }
+    const imported = importedTranslationHook(path.scope, initializer);
+    if (imported === null) {
+        return null;
+    }
+    return { call: initializer, isCanonical: imported.local === "useTranslation" };
+};
+const importedTranslationFunctionKind = (imported) => {
+    if (imported?.imported !== "t" || !TRANSLATION_MODULES.has(imported.source)) {
+        return null;
+    }
+    return imported.local === "t" ? "canonical" : "alias";
+};
+const hookTranslationFunctionKind = (binding) => {
+    if (binding === undefined) {
+        return null;
+    }
+    const hook = translationHookBinding(binding);
+    if (hook === null) {
+        return null;
+    }
+    return binding.identifier.name === "t" && hook.isCanonical ? "canonical" : "alias";
+};
+const directTranslationFunctionKind = (scope, name) => {
+    const binding = scope.getBinding(name);
+    return importedTranslationFunctionKind(importedBinding(binding)) ?? hookTranslationFunctionKind(binding);
+};
+const babelMemberName = (member) => {
+    const property = member.property;
+    if (member.computed) {
+        return types.isStringLiteral(property) ? property.value : null;
+    }
+    return types.isIdentifier(property) ? property.name : null;
+};
+const isImportedTranslationObject = (scope, object) => {
+    if (!types.isIdentifier(object)) {
+        return false;
+    }
+    const imported = importedBinding(scope.getBinding(object.name));
+    return imported !== null &&
+        TRANSLATION_MODULES.has(imported.source) &&
+        (imported.style === "namespace" || (imported.source === "i18next" && imported.imported === "default"));
+};
+const constantVariableDeclarator = (binding) => {
+    const path = binding.path;
+    const declaration = path.parentPath;
+    if (!path.isVariableDeclarator() ||
+        !declaration.isVariableDeclaration() ||
+        declaration.node.kind !== "const") {
+        return null;
+    }
+    return path;
+};
+const isTranslationHookResultBinding = (binding) => {
+    if (binding === undefined) {
+        return false;
+    }
+    const path = constantVariableDeclarator(binding);
+    const initializer = path?.node.init;
+    return path !== null &&
+        types.isIdentifier(path.node.id) &&
+        types.isCallExpression(initializer) &&
+        importedTranslationHook(path.scope, initializer) !== null;
+};
+const isHookTranslationMember = (scope, member) => {
+    if (babelMemberName(member) !== "t") {
+        return false;
+    }
+    const object = member.object;
+    if (types.isCallExpression(object)) {
+        return importedTranslationHook(scope, object) !== null;
+    }
+    return types.isIdentifier(object) && isTranslationHookResultBinding(scope.getBinding(object.name));
+};
+const isTranslationMember = (scope, member) => babelMemberName(member) === "t" &&
+    (isImportedTranslationObject(scope, member.object) || isHookTranslationMember(scope, member));
+const isDirectTranslationFunction = (scope, node) => types.isIdentifier(node) && directTranslationFunctionKind(scope, node.name) !== null;
+const isTranslationFunctionValue = (scope, node) => {
+    if (isDirectTranslationFunction(scope, node)) {
+        return true;
+    }
+    return (types.isMemberExpression(node) || types.isOptionalMemberExpression(node)) &&
+        isTranslationMember(scope, node);
+};
+const isTranslationBindCall = (scope, node) => {
+    if (!types.isCallExpression(node) || !types.isMemberExpression(node.callee)) {
+        return false;
+    }
+    return babelMemberName(node.callee) === "bind" &&
+        isTranslationFunctionValue(scope, node.callee.object);
+};
+const isTranslationObjectPatternAlias = (path, binding) => {
+    const pattern = path.node.id;
+    const initializer = path.node.init;
+    if (!types.isObjectPattern(pattern) ||
+        !isHookPatternBinding(pattern, binding.identifier.name) ||
+        !types.isIdentifier(initializer)) {
+        return false;
+    }
+    return isImportedTranslationObject(path.scope, initializer) ||
+        isTranslationHookResultBinding(path.scope.getBinding(initializer.name));
+};
+const isTranslationAliasBinding = (binding) => {
+    if (binding === undefined) {
+        return false;
+    }
+    const path = constantVariableDeclarator(binding);
+    if (path === null) {
+        return false;
+    }
+    if (isTranslationObjectPatternAlias(path, binding)) {
+        return true;
+    }
+    const initializer = path.node.init;
+    return types.isIdentifier(path.node.id) &&
+        initializer !== null &&
+        initializer !== undefined &&
+        (isTranslationFunctionValue(path.scope, initializer) || isTranslationBindCall(path.scope, initializer));
+};
+const translationFunctionKind = (scope, name) => {
+    const direct = directTranslationFunctionKind(scope, name);
+    if (direct !== null) {
+        return direct;
+    }
+    return isTranslationAliasBinding(scope.getBinding(name)) ? "alias" : null;
+};
+const translationElementKind = (path, name) => {
+    const imported = importedBinding(path.scope.getBinding(name));
+    if (imported?.source !== "@gtkx/i18n" || !TRANS_ELEMENTS.has(imported.imported)) {
+        return null;
+    }
+    return imported.local === imported.imported ? "canonical" : "alias";
+};
+const nodeStart = (path) => {
+    const start = path.node.start;
+    if (start === null || start === undefined) {
+        throw new Error("Translation extraction could not locate a source expression");
+    }
+    return start;
+};
+const registerSourceMask = (node, references) => {
+    const { start, end } = node;
+    if (start === null || start === undefined || end === null || end === undefined) {
+        throw new Error("Translation extraction could not locate a source expression");
+    }
+    references.masks.push({ start, end });
+};
+const sourceLocationKey = (line, column) => `${String(line)}:${String(column)}`;
+const sourcePoint = (node) => {
+    return locatablePoint(node);
+};
+const registerSourceLocation = (node, references) => {
+    const point = sourcePoint(node);
+    if (point !== null) {
+        references.locations.set(sourceLocationKey(point.line, point.column), point);
+    }
+    return point;
+};
+const babelStaticKey = (node) => {
+    if (node === null || node === undefined) {
+        return null;
+    }
+    if (types.isStringLiteral(node)) {
+        return node.value;
+    }
+    if (types.isTemplateLiteral(node) && node.expressions.length === 0) {
+        return node.quasis[0]?.value.cooked ?? null;
+    }
+    if (types.isParenthesizedExpression(node) ||
+        types.isTSAsExpression(node) ||
+        types.isTSSatisfiesExpression(node) ||
+        types.isTSTypeAssertion(node) ||
+        types.isTSNonNullExpression(node)) {
+        return babelStaticKey(node.expression);
+    }
+    return null;
+};
+const babelObjectExpression = (node) => {
+    if (node === null || node === undefined) {
+        return null;
+    }
+    if (types.isObjectExpression(node)) {
+        return node;
+    }
+    if (types.isParenthesizedExpression(node) ||
+        types.isTSAsExpression(node) ||
+        types.isTSSatisfiesExpression(node) ||
+        types.isTSTypeAssertion(node) ||
+        types.isTSNonNullExpression(node)) {
+        return babelObjectExpression(node.expression);
+    }
+    return null;
+};
+const babelNamedProperty = (object, name) => {
+    if (object === null) {
+        return null;
+    }
+    for (const property of object.properties) {
+        if (types.isObjectProperty(property) && babelPropertyName(property) === name) {
+            return property;
+        }
+    }
+    return null;
+};
+const babelStringProperty = (object, name) => {
+    const property = babelNamedProperty(object, name);
+    if (property === null) {
+        return null;
+    }
+    const value = babelStaticKey(property.value);
+    if (value === null) {
+        throw new Error(`Translation ${name} values must be string literals`);
+    }
+    return value;
+};
+const callOptions = (call) => babelObjectExpression(call.arguments[1]) ?? babelObjectExpression(call.arguments[2]);
+const hookKeyPrefix = (callee) => {
+    const binding = callee.scope.getBinding(callee.node.name);
+    const hook = binding === undefined ? null : translationHookBinding(binding);
+    return babelStringProperty(hook === null ? null : babelObjectExpression(hook.call.arguments[1]), "keyPrefix") ?? "";
+};
+const prefixedTranslationKey = (prefix, key) => {
+    if (prefix.length === 0) {
+        return key;
+    }
+    return prefix.endsWith(".") ? `${prefix}${key}` : `${prefix}.${key}`;
+};
+const extractedEntryKey = (call, keyPrefix) => {
+    const key = babelStaticKey(call.arguments[0]);
+    if (key === null) {
+        return null;
+    }
+    const options = callOptions(call);
+    const callPrefix = babelStringProperty(options, "keyPrefix");
+    if (callPrefix === "" && keyPrefix.length > 0) {
+        throw new Error("An empty call keyPrefix cannot override a hook keyPrefix during extraction");
+    }
+    const selectedPrefix = callPrefix ?? keyPrefix;
+    const prefixed = prefixedTranslationKey(selectedPrefix, key);
+    const context = babelStringProperty(options, "context");
+    return context === null ? prefixed : `${prefixed}${CONTEXT_SEPARATOR}${context}`;
+};
+const registerEntryLocation = (key, point, references) => {
+    if (key === null || point === null) {
+        return;
+    }
+    const locations = references.entryLocations.get(key) ?? [];
+    locations.push(point);
+    references.entryLocations.set(key, locations);
+};
+const registerCallReference = (callPath, references, keyPrefix) => {
+    references.calls.add(nodeStart(callPath));
+    const firstArgument = callPath.node.arguments[0];
+    const point = registerSourceLocation(firstArgument ?? callPath.node, references);
+    if (point !== null) {
+        references.sourcePoints.set(nodeStart(callPath), point);
+    }
+    registerEntryLocation(extractedEntryKey(callPath.node, keyPrefix), point, references);
+};
+const parserPlugins = (lang) => [
+    "decorators",
+    ...(lang === "ts" || lang === "tsx" ? ["typescript"] : []),
+    ...(lang === "jsx" || lang === "tsx" ? ["jsx"] : []),
+];
+const parseTranslationReferences = (root, path, source, lang) => {
+    try {
+        return parseBabelSync(source, {
+            ast: true,
+            babelrc: false,
+            configFile: false,
+            filename: projectSourcePath(root, path),
+            parserOpts: { createParenthesizedExpressions: true, plugins: parserPlugins(lang) },
+            sourceType: "module",
+        });
+    }
+    catch (error) {
+        throw sourceExtractionError(root, path, errorSourcePoint(error), error);
+    }
+};
+const registerIdentifierTranslationCall = (callPath, callee, references) => {
+    if (!callee.isIdentifier()) {
+        return;
+    }
+    const kind = translationFunctionKind(callee.scope, callee.node.name);
+    if (kind === "alias") {
+        throw new Error("Translation calls must use the imported name t");
+    }
+    if (kind === "canonical") {
+        registerCallReference(callPath, references, hookKeyPrefix(callee));
+    }
+    else if (callee.node.name === "t") {
+        registerSourceMask(callee.node, references);
+    }
+};
+const registerTranslationCall = (callPath, references) => {
+    assertSupportedWrappedCallee(callPath);
+    const callee = callPath.get("callee");
+    if (callee.isIdentifier()) {
+        registerIdentifierTranslationCall(callPath, callee, references);
+        return;
+    }
+    if (callee.isMemberExpression() && isTranslationMember(callee.scope, callee.node)) {
+        throw new Error("Translation calls must use the named t export");
+    }
+};
+const unwrapTranslationCallee = (node) => {
+    if (types.isParenthesizedExpression(node) ||
+        types.isTSAsExpression(node) ||
+        types.isTSSatisfiesExpression(node) ||
+        types.isTSTypeAssertion(node) ||
+        types.isTSNonNullExpression(node)) {
+        return unwrapTranslationCallee(node.expression);
+    }
+    return node;
+};
+const isTranslationCallee = (scope, node) => {
+    if (types.isIdentifier(node)) {
+        return translationFunctionKind(scope, node.name) !== null;
+    }
+    return (types.isMemberExpression(node) || types.isOptionalMemberExpression(node)) &&
+        isTranslationMember(scope, node);
+};
+const assertSupportedWrappedCallee = (callPath) => {
+    const callee = callPath.node.callee;
+    const unwrapped = unwrapTranslationCallee(callee);
+    if (unwrapped !== callee && isTranslationCallee(callPath.scope, unwrapped)) {
+        throw new Error("Translation call expressions cannot wrap their callee");
+    }
+};
+const assertSupportedOptionalCall = (callPath) => {
+    const callee = unwrapTranslationCallee(callPath.node.callee);
+    if (isTranslationCallee(callPath.scope, callee)) {
+        throw new Error("Translation calls cannot use optional chaining");
+    }
+};
+const assertUnsupportedTranslationTag = (tagPath) => {
+    const tag = unwrapTranslationCallee(tagPath.node.tag);
+    if (isTranslationCallee(tagPath.scope, tag)) {
+        throw new Error("Translation calls cannot use tagged-template syntax");
+    }
+};
+const registerUnrecognizedElementMasks = (elementPath, name, references) => {
+    registerSourceMask(name.node, references);
+    const parent = elementPath.parentPath.node;
+    const closingName = types.isJSXElement(parent) ? parent.closingElement?.name : null;
+    if (types.isJSXIdentifier(closingName)) {
+        registerSourceMask(closingName, references);
+    }
+};
+const registerElementReference = (elementPath, references) => {
+    const start = nodeStart(elementPath);
+    const point = registerSourceLocation(elementPath.node, references);
+    references.elements.add(start);
+    if (point !== null) {
+        references.sourcePoints.set(start, point);
+    }
+};
+const registerTranslationElement = (elementPath, references) => {
+    const name = elementPath.get("name");
+    if (!name.isJSXIdentifier()) {
+        return;
+    }
+    const kind = translationElementKind(name, name.node.name);
+    if (kind === "alias") {
+        throw new Error("Translation components must use their imported names");
+    }
+    if (kind === "canonical") {
+        registerElementReference(elementPath, references);
+    }
+    else if (TRANS_ELEMENTS.has(name.node.name)) {
+        registerUnrecognizedElementMasks(elementPath, name, references);
+    }
+};
+const maskUnrecognizedTranslations = (source, references) => {
+    let masked = source;
+    const masks = references.masks.toSorted((left, right) => right.start - left.start);
+    for (const { start, end } of masks) {
+        masked = `${masked.slice(0, start)}${"_".repeat(end - start)}${masked.slice(end)}`;
+    }
+    return masked;
+};
+const translationReferences = (root, path, source, lang) => {
+    const parsed = parseTranslationReferences(root, path, source, lang);
+    if (parsed === null) {
+        throw new Error(`Translation extraction could not parse ${path}`);
+    }
+    const references = {
+        calls: new Set(),
+        elements: new Set(),
+        entryLocations: new Map(),
+        locations: new Map(),
+        masks: [],
+        sourcePoints: new Map(),
+    };
+    traverse(parsed, {
+        CallExpression(callPath) {
+            atSourceNode(root, path, callPath.node, () => {
+                registerTranslationCall(callPath, references);
+            });
+        },
+        JSXOpeningElement(elementPath) {
+            atSourceNode(root, path, elementPath.node, () => {
+                registerTranslationElement(elementPath, references);
+            });
+        },
+        OptionalCallExpression(callPath) {
+            atSourceNode(root, path, callPath.node, () => {
+                assertSupportedOptionalCall(callPath);
+            });
+        },
+        TaggedTemplateExpression(tagPath) {
+            atSourceNode(root, path, tagPath.node, () => {
+                assertUnsupportedTranslationTag(tagPath);
+            });
+        },
+    });
+    return references;
+};
+const assertSupportedTranslationCall = (node, references) => {
+    if (!references.calls.has(node.start)) {
+        return;
+    }
+    assertStaticTranslationKey(node.arguments[0]);
+    assertSupportedTranslationOptions(node.arguments[1], node.arguments[2]);
+};
+const assertSupportedTranslationOptions = (second, third) => {
+    if (third !== undefined && third !== null) {
+        assertStaticTranslationKey(second);
+        assertSupportedOptionObject(third);
+        return;
+    }
+    if (second === undefined || second === null || isStaticTranslationKey(second)) {
+        return;
+    }
+    assertSupportedOptionObject(second);
+};
+const isNamedJsxAttribute = (attribute, name) => attribute.name.type === "JSXIdentifier" && attribute.name.name === name;
+const assertSupportedTransKey = (attribute) => {
+    if (!isNamedJsxAttribute(attribute, "i18nKey")) {
+        return;
+    }
+    const key = attribute.value?.type === "JSXExpressionContainer"
+        ? attribute.value.expression
+        : attribute.value;
+    assertStaticTranslationKey(key);
+};
+const assertSupportedTransStringAttribute = (attribute, name) => {
+    if (!isNamedJsxAttribute(attribute, name)) {
+        return;
+    }
+    const value = attribute.value?.type === "JSXExpressionContainer"
+        ? attribute.value.expression
+        : attribute.value;
+    assertStaticTranslationKey(value);
+};
+const assertSupportedTransOptions = (attribute) => {
+    if (isNamedJsxAttribute(attribute, "tOptions") && attribute.value?.type === "JSXExpressionContainer") {
+        assertSupportedOptionObject(attribute.value.expression);
+    }
+};
+const assertSupportedTransAttribute = (attribute) => {
+    if (attribute.type === "JSXSpreadAttribute") {
+        throw new Error("Translation extraction requires explicit component properties");
+    }
+    assertSupportedTransKey(attribute);
+    assertSupportedTransStringAttribute(attribute, "context");
+    assertSupportedTransStringAttribute(attribute, "defaults");
+    assertSupportedTransOptions(attribute);
+};
+const assertSupportedTransElement = (node, references) => {
+    if (!references.elements.has(node.start)) {
+        return;
+    }
+    for (const attribute of node.attributes) {
+        assertSupportedTransAttribute(attribute);
+    }
+};
+const assertSupportedTranslationSyntax = (root, path, source) => {
+    const lang = sourceLanguage(path);
+    if (lang === undefined) {
+        return {
+            calls: new Set(),
+            elements: new Set(),
+            entryLocations: new Map(),
+            locations: new Map(),
+            masks: [],
+            sourcePoints: new Map(),
+        };
+    }
+    let parsed;
+    try {
+        parsed = parseSync(projectSourcePath(root, path), source, { lang });
+    }
+    catch (error) {
+        throw sourceExtractionError(root, path, errorSourcePoint(error), error);
+    }
+    const references = translationReferences(root, path, source, lang);
+    new Visitor({
+        CallExpression(node) {
+            try {
+                assertSupportedTranslationCall(node, references);
+            }
+            catch (error) {
+                throw sourceExtractionError(root, path, references.sourcePoints.get(node.start) ?? null, error);
+            }
+        },
+        JSXOpeningElement(node) {
+            try {
+                assertSupportedTransElement(node, references);
+            }
+            catch (error) {
+                throw sourceExtractionError(root, path, references.sourcePoints.get(node.start) ?? null, error);
+            }
+        },
+    }).visit(parsed.program);
+    return references;
+};
+const extractedLocationFile = (root, file) => resolve(root, file);
+const isRecognizedLocation = (root, references, location) => {
+    if (location.line === undefined || location.column === undefined) {
+        return false;
+    }
+    const sourceReferences = references.get(extractedLocationFile(root, location.file));
+    return sourceReferences?.locations.has(sourceLocationKey(location.line, location.column)) === true;
+};
+const recognizedKeyLocations = (references, extractedKey) => {
+    const locations = [];
+    for (const [file, sourceReferences] of references) {
+        const points = sourceReferences.entryLocations.get(extractedKey) ?? [];
+        for (const point of points) {
+            locations.push({ file, column: point.column, line: point.line });
+        }
+    }
+    return locations;
+};
+const recognizedEntry = (root, references, entry) => {
+    const extractedLocations = entry.locations ?? [];
+    const locations = extractedLocations.length === 0
+        ? recognizedKeyLocations(references, entry.key)
+        : extractedLocations.filter((location) => isRecognizedLocation(root, references, location));
+    return locations.length === 0 ? null : { ...entry, locations };
+};
+const quotedNestedReferenceParts = (content, quote) => {
+    const end = content.indexOf(quote, 1);
+    return end === -1
+        ? null
+        : { base: content.slice(1, end), options: content.slice(end + 1) };
+};
+const nestedReferenceParts = (value) => {
+    const content = value.trim();
+    const quote = content[0];
+    if (quote === "\"" || quote === "'") {
+        return quotedNestedReferenceParts(content, quote);
+    }
+    const separator = content.indexOf(",");
+    const base = (separator === -1 ? content : content.slice(0, separator)).trim();
+    return base.length === 0
+        ? null
+        : { base, options: separator === -1 ? "" : content.slice(separator + 1) };
+};
+const nestedReferenceContext = (options) => {
+    const match = NESTED_CONTEXT.exec(options);
+    const context = match?.[1] ?? match?.[2] ?? null;
+    return context === null || context.length === 0 ? null : context;
+};
+const adjustedParenthesisDepth = (character, depth) => {
+    if (character === "(") {
+        return depth + 1;
+    }
+    return character === ")" ? depth - 1 : depth;
+};
+const nestedReferenceEnd = (text, start) => {
+    let depth = 0;
+    const tokens = text.slice(start).matchAll(NESTED_STRUCTURE_TOKEN);
+    for (const token of tokens) {
+        const character = token[0];
+        if (character === ")" && depth === 0) {
+            return start + token.index;
+        }
+        depth = adjustedParenthesisDepth(character, depth);
+    }
+    return -1;
+};
+const nestedReferenceContents = (text) => {
+    const contents = [];
+    let offset = 0;
+    while (offset < text.length) {
+        const prefix = text.indexOf("$t(", offset);
+        if (prefix === -1) {
+            break;
+        }
+        const start = prefix + 3;
+        const end = nestedReferenceEnd(text, start);
+        if (end === -1) {
+            break;
+        }
+        contents.push(text.slice(start, end));
+        offset = end + 1;
+    }
+    return contents;
+};
+const nestedPluralKeys = (base, context) => {
+    const pluralBase = context === null ? base : `${base}${CONTEXT_SEPARATOR}${context}`;
+    return [`${pluralBase}_one`, `${pluralBase}_other`];
+};
+const nestedReferenceKeys = (content) => {
+    const parts = nestedReferenceParts(content);
+    if (parts === null) {
+        return [];
+    }
+    const context = nestedReferenceContext(parts.options);
+    const contextual = context === null
+        ? []
+        : [`${parts.base}_${context}`, `${parts.base}${CONTEXT_SEPARATOR}${context}`];
+    return NESTED_COUNT.test(parts.options)
+        ? [parts.base, ...contextual, ...nestedPluralKeys(parts.base, context)]
+        : [parts.base, ...contextual];
+};
+const nestedEntryKeys = (text) => {
+    const keys = new Set();
+    for (const content of nestedReferenceContents(text)) {
+        for (const key of nestedReferenceKeys(content)) {
+            keys.add(key);
+        }
+    }
+    return keys;
+};
+const registerNestedKeyLocations = (root, references, key, locations) => {
+    for (const location of locations) {
+        if (location.line === undefined || location.column === undefined) {
+            continue;
+        }
+        const sourceReferences = references.get(resolve(root, location.file));
+        if (sourceReferences !== undefined) {
+            registerEntryLocation(key, { column: location.column, line: location.line }, sourceReferences);
+        }
+    }
+};
+const registerNestedTextLocations = (root, references, text, locations) => {
+    for (const key of nestedEntryKeys(text)) {
+        registerNestedKeyLocations(root, references, key, locations);
+    }
+};
+const registerNestedEntryLocations = (root, references, entry, locations) => {
+    registerNestedTextLocations(root, references, entry.key, locations);
+    if (typeof entry.defaultValue === "string") {
+        registerNestedTextLocations(root, references, entry.defaultValue, locations);
+    }
+};
+const didRegisterNestedLocationPass = (root, references, entries, processed) => {
+    let didRegister = false;
+    for (const [mapKey, entry] of entries) {
+        if (processed.has(mapKey)) {
+            continue;
+        }
+        const recognized = recognizedEntry(root, references, entry);
+        if (recognized !== null) {
+            processed.add(mapKey);
+            registerNestedEntryLocations(root, references, entry, recognized.locations ?? []);
+            didRegister = true;
+        }
+    }
+    return didRegister;
+};
+const registerNestedLocations = (root, references, entries) => {
+    const processed = new Set();
+    let hasRegisteredLocations = true;
+    while (hasRegisteredLocations) {
+        hasRegisteredLocations = didRegisterNestedLocationPass(root, references, entries, processed);
+    }
+};
+const retainRecognizedEntries = (root, references, entries) => {
+    for (const [mapKey, entry] of entries) {
+        const recognized = recognizedEntry(root, references, entry);
+        if (recognized === null) {
+            entries.delete(mapKey);
+        }
+        else {
+            entries.set(mapKey, recognized);
+        }
+    }
+};
+const fileSourcePointKey = (file, line, column) => `${file}\0${sourceLocationKey(line, column)}`;
+const registerExtractedSourcePoint = (root, points, location) => {
+    if (location.line !== undefined && location.column !== undefined) {
+        points.add(fileSourcePointKey(resolve(root, location.file), location.line, location.column));
+    }
+};
+const extractedSourcePoints = (root, entries) => {
+    const points = new Set();
+    for (const entry of entries.values()) {
+        const locations = entry.locations ?? [];
+        for (const location of locations) {
+            registerExtractedSourcePoint(root, points, location);
+        }
+    }
+    return points;
+};
+const missingSourcePoint = (file, references, extracted) => {
+    for (const [location, point] of references.locations) {
+        if (!extracted.has(`${file}\0${location}`)) {
+            return point;
+        }
+    }
+    return null;
+};
+const assertAllReferencesExtracted = (root, references, entries) => {
+    const extracted = extractedSourcePoints(root, entries);
+    for (const [file, sourceReferences] of references) {
+        const point = missingSourcePoint(file, sourceReferences, extracted);
+        if (point !== null) {
+            throw sourceExtractionError(root, file, point, new Error("A translation expression could not be extracted safely"));
+        }
+    }
+};
 const findSourceMessages = async (root, sourceFiles) => {
     if (sourceFiles.length === 0) {
         clearI18nResources(root);
         return [];
     }
+    const sources = new Map(sourceFiles.map((file) => [file, readFileSync(file, "utf8")]));
+    const references = new Map();
+    for (const [file, source] of sources) {
+        references.set(file, assertSupportedTranslationSyntax(root, file, source));
+    }
     let extracted;
     const { logger, reports } = quietLogger();
     const capture = {
         name: "gtkx-gettext",
+        onLoad(code, path) {
+            const sourceReferences = references.get(resolve(root, path));
+            return sourceReferences === undefined
+                ? code
+                : maskUnrecognizedTranslations(code, sourceReferences);
+        },
         onEnd(keys) {
+            registerNestedLocations(root, references, keys);
+            retainRecognizedEntries(root, references, keys);
+            assertAllReferencesExtracted(root, references, keys);
             extracted = keys;
         },
     };
@@ -207,8 +1160,7 @@ const findSourceMessages = async (root, sourceFiles) => {
     if (extracted === undefined || reports.length > 0 || result.hasErrors) {
         throw new Error(reports.join("\n") || "i18next extraction failed");
     }
-    const sources = new Map(sourceFiles.map((file) => [file, readFileSync(file, "utf8")]));
-    return sourceMessages(extracted.values().toArray())
+    return sourceMessages(root, extracted.values().toArray())
         .map((message) => inferLocations(message, sources))
         .toSorted(compareMessages);
 };