@gtkx/cli 1.6.0 → 2.0.0-beta.2

package/dist/i18n/source-messages.js

@@ -1,14 +1,38 @@
-import { findKeys } from "i18next-cli";
+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, sep } from "node:path";
+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 { gtkxExtractorPlugin } from "./extractor-plugin.js";
 import { metadataTemplateFiles } from "./metadata-templates.js";
+import { clearI18nResources, i18nToolkitConfig } from "./types.js";
 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",
+]);
 const quietLogger = () => {
     const reports = [];
     return {
@@ -27,29 +51,6 @@ const quietLogger = () => {
         },
     };
 };
-const extractorConfig = (sourceFiles) => {
-    const integration = gtkxExtractorPlugin();
-    return {
-        locales: ["en"],
-        plugins: [integration.plugin],
-        extract: {
-            input: sourceFiles,
-            output: "unused/{{language}}/{{namespace}}.json",
-            contextSeparator: CONTEXT_SEPARATOR,
-            defaultNS: DEFAULT_NAMESPACE,
-            disablePlurals: false,
-            extractFromComments: false,
-            functions: [],
-            generateBasePluralForms: false,
-            keySeparator: ".",
-            nsSeparator: false,
-            pluralSeparator: "_",
-            transComponents: integration.transComponents,
-            useTranslationNames: [],
-            warnOnConflicts: "error",
-        },
-    };
-};
 const splitContext = (key) => {
     const index = key.lastIndexOf(CONTEXT_SEPARATOR);
     if (index === -1) {
@@ -75,27 +76,30 @@ const normalizedLocations = (locations) => {
     return unique.values().toArray().toSorted(compareLocations);
 };
 const pointSource = (entry, msgid) => {
-    if (entry.explicitDefault !== true || typeof entry.defaultValue !== "string") {
+    if (typeof entry.defaultValue !== "string") {
         return msgid;
     }
-    return entry.defaultValue;
+    if (entry.explicitDefault === true) {
+        return entry.defaultValue;
+    }
+    return entry.defaultValue === msgid || msgid.endsWith(`.${entry.defaultValue}`)
+        ? msgid
+        : entry.defaultValue;
 };
 const pointMessage = (entry) => {
     const { context, msgid } = splitContext(entry.key);
     validateIdentity(context, msgid);
-    const isDefaultExplicit = entry.explicitDefault === true;
     const singular = pointSource(entry, msgid);
     if (singular.length === 0) {
         throw new Error("Translation source strings cannot be empty");
     }
     return {
         context,
-        kind: isDefaultExplicit ? "default" : "point",
         locations: normalizedLocations(entry.locations ?? []),
-        msgid,
         namespace: namespaceFor(entry),
         plural: null,
         singular,
+        sourceKey: msgid,
     };
 };
 const expandedPlural = (entry) => {
@@ -145,20 +149,18 @@ const pluralMessage = ({ baseKey, namespace, variants }) => {
     const { one, other } = pairedVariants(variants);
     const { context, msgid } = splitContext(baseKey);
     validateIdentity(context, msgid);
-    const hasStableKey = one.defaultValue !== other.defaultValue;
-    const singular = hasStableKey ? one.defaultValue : msgid;
+    const singular = one.defaultValue;
     const plural = other.defaultValue;
     if (singular === plural || singular.length === 0 || plural.length === 0) {
         throw new Error("GNU gettext plural source strings must be distinct and non-empty");
     }
     return {
         context,
-        kind: hasStableKey ? "pluralDefaults" : "plural",
         locations: normalizedLocations(variants.flatMap((variant) => variant.locations)),
-        msgid,
         namespace,
         plural,
         singular,
+        sourceKey: msgid,
     };
 };
 const pluralMessages = (entries) => groupedPlurals(entries).map((group) => pluralMessage(group));
@@ -185,40 +187,872 @@ const sourceMessages = (entries) => {
 };
 const compareMessages = (left, right) => left.namespace.localeCompare(right.namespace) ||
     (left.context ?? "").localeCompare(right.context ?? "") ||
-    left.msgid.localeCompare(right.msgid) ||
     left.singular.localeCompare(right.singular) ||
     (left.plural ?? "").localeCompare(right.plural ?? "");
+const inferLocations = (message, sources) => {
+    if (message.locations.length > 0) {
+        return message;
+    }
+    const locations = [];
+    for (const [file, source] of sources) {
+        const index = source.indexOf(message.sourceKey);
+        if (index !== -1) {
+            locations.push({ file, line: source.slice(0, index).split("\n").length });
+        }
+    }
+    return { ...message, locations };
+};
 const normalizedSourceFiles = (root, paths) => {
     const files = paths
         .map((path) => resolve(root, path))
-        .filter((path) => {
-        const projectPath = relative(root, path);
-        return projectPath !== ".." && !projectPath.startsWith(`..${sep}`) && !isAbsolute(projectPath);
-    });
+        .filter((path) => isPathWithin(root, path));
     return new Set(files).values().toArray().toSorted((left, right) => left.localeCompare(right));
 };
-const findSourceMessages = async (sourceFiles) => {
+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) => {
+    const location = node.loc?.start;
+    return location === undefined ? null : { column: location.column, line: location.line };
+};
+const registerSourceLocation = (node, references) => {
+    const point = sourcePoint(node);
+    if (point !== null) {
+        references.locations.add(sourceLocationKey(point.line, point.column));
+    }
+    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);
+    registerEntryLocation(extractedEntryKey(callPath.node, keyPrefix), point, references);
+};
+const parserPlugins = (lang) => [
+    "decorators",
+    ...(lang === "ts" || lang === "tsx" ? ["typescript"] : []),
+    ...(lang === "jsx" || lang === "tsx" ? ["jsx"] : []),
+];
+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 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") {
+        references.elements.add(nodeStart(elementPath));
+        registerSourceLocation(elementPath.node, 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 = (path, source, lang) => {
+    const parsed = parseBabelSync(source, {
+        ast: true,
+        babelrc: false,
+        configFile: false,
+        filename: path,
+        parserOpts: { createParenthesizedExpressions: true, plugins: parserPlugins(lang) },
+        sourceType: "module",
+    });
+    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 Set(),
+        masks: [],
+    };
+    traverse(parsed, {
+        CallExpression(callPath) {
+            registerTranslationCall(callPath, references);
+        },
+        JSXOpeningElement(elementPath) {
+            registerTranslationElement(elementPath, references);
+        },
+        OptionalCallExpression(callPath) {
+            assertSupportedOptionalCall(callPath);
+        },
+        TaggedTemplateExpression(tagPath) {
+            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 = (path, source) => {
+    const lang = sourceLanguage(path);
+    if (lang === undefined) {
+        return { calls: new Set(), elements: new Set(), entryLocations: new Map(), locations: new Set(), masks: [] };
+    }
+    const parsed = parseSync(path, source, { lang });
+    const references = translationReferences(path, source, lang);
+    new Visitor({
+        CallExpression(node) {
+            assertSupportedTranslationCall(node, references);
+        },
+        JSXOpeningElement(node) {
+            assertSupportedTransElement(node, references);
+        },
+    }).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 hasMissingSourcePoint = (file, references, extracted) => references.locations.values().some((location) => !extracted.has(`${file}\0${location}`));
+const assertAllReferencesExtracted = (root, references, entries) => {
+    const extracted = extractedSourcePoints(root, entries);
+    for (const [file, sourceReferences] of references) {
+        if (hasMissingSourcePoint(file, sourceReferences, extracted)) {
+            throw new Error("A translation expression could not be extracted safely");
+        }
+    }
+};
+const findSourceMessages = async (root, sourceFiles) => {
     if (sourceFiles.length === 0) {
+        clearI18nResources(root);
         return [];
     }
-    const fileErrors = [];
+    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(file, source));
+    }
+    let extracted;
     const { logger, reports } = quietLogger();
-    const { allKeys } = await findKeys(extractorConfig(sourceFiles), logger, fileErrors);
-    if (fileErrors.length > 0 || reports.length > 0) {
-        throw new Error([...fileErrors, ...reports].join("\n"));
+    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;
+        },
+    };
+    const result = await runExtractor(i18nToolkitConfig(root, sourceFiles, [capture]), {
+        logger,
+        quiet: true,
+        syncPrimaryWithDefaults: true,
+        trustDerivedDefaults: true,
+    });
+    if (extracted === undefined || reports.length > 0 || result.hasErrors) {
+        throw new Error(reports.join("\n") || "i18next extraction failed");
     }
-    return sourceMessages(allKeys.values().toArray()).toSorted(compareMessages);
+    return sourceMessages(extracted.values().toArray())
+        .map((message) => inferLocations(message, sources))
+        .toSorted(compareMessages);
 };
 const projectPath = (root, path) => {
     const absolute = isAbsolute(path) ? resolve(path) : resolve(root, path);
     const projectRelative = relative(root, absolute);
-    if (projectRelative === "" ||
-        projectRelative === ".." ||
-        projectRelative.startsWith(`..${sep}`) ||
-        isAbsolute(projectRelative)) {
+    if (!isPathInside(root, absolute)) {
         return null;
     }
-    return projectRelative.replaceAll("\\", "/");
+    return toPosixPath(projectRelative);
 };
 const writePotfiles = (project, sourceFiles) => {
     const paths = sourceFiles
@@ -241,7 +1075,6 @@ const renderCatalogCall = (message) => {
         ? `gettext(${msgid});`
         : `pgettext(${JSON.stringify(message.context)}, ${msgid});`;
 };
-const readSources = (sourceFiles) => new Map(sourceFiles.map((path) => [path, readFileSync(path, "utf8")]));
 const locatedOwners = (project, message) => {
     const owners = [];
     for (const location of message.locations) {
@@ -253,30 +1086,14 @@ const locatedOwners = (project, message) => {
     const unique = new Map(owners.map((owner) => [`${owner.path}\0${String(owner.line)}`, owner]));
     return unique.values().toArray();
 };
-const inferredOwner = (project, message, sources) => {
-    for (const [path, source] of sources) {
-        const index = source.indexOf(message.msgid);
-        if (index !== -1) {
-            return {
-                path: projectPath(project.root, path) ?? SYNTHETIC_FILENAME,
-                line: source.slice(0, index).split("\n").length,
-            };
-        }
-    }
-    return null;
-};
-const sourceOwners = (project, message, sources) => {
+const sourceOwners = (project, message) => {
     const located = locatedOwners(project, message);
-    if (located.length > 0) {
-        return located;
-    }
-    return [inferredOwner(project, message, sources) ?? { path: SYNTHETIC_FILENAME, line: undefined }];
+    return located.length > 0 ? located : [{ path: SYNTHETIC_FILENAME, line: undefined }];
 };
-const syntheticEntries = (project, messages, sourceFiles) => {
-    const sources = readSources(sourceFiles);
+const syntheticEntries = (project, messages) => {
     const entries = new Map();
     for (const message of messages) {
-        for (const owner of sourceOwners(project, message, sources)) {
+        for (const owner of sourceOwners(project, message)) {
             const owned = entries.get(owner.path) ?? [];
             owned.push({ call: renderCatalogCall(message), line: owner.line });
             entries.set(owner.path, owned);
@@ -314,8 +1131,8 @@ const renderSyntheticSource = (entries) => {
     }
     return `${lines.join("\n")}\n`;
 };
-const writeSyntheticSources = (workDir, project, messages, sourceFiles) => {
-    const entries = syntheticEntries(project, messages, sourceFiles);
+const writeSyntheticSources = (workDir, project, messages) => {
+    const entries = syntheticEntries(project, messages);
     const paths = [];
     for (const [path, owned] of entries) {
         const target = join(workDir, path);
@@ -327,8 +1144,8 @@ const writeSyntheticSources = (workDir, project, messages, sourceFiles) => {
     writeFileSync(potfiles, `${paths.toSorted((left, right) => left.localeCompare(right)).join("\n")}\n`);
     return potfiles;
 };
-const extractSourceMessages = ({ project, messages, sourceFiles, output, workDir }) => {
-    const potfilesPath = writeSyntheticSources(workDir, project, messages, sourceFiles);
+const extractSourceMessages = ({ project, messages, output, workDir }) => {
+    const potfilesPath = writeSyntheticSources(workDir, project, messages);
     runCliTool({
         tool: "xgettext",
         args: [
@@ -365,7 +1182,7 @@ const joinMetadataFragment = (output, fragment) => {
         target: output,
     });
 };
-const extractCatalogTemplate = ({ project, messages, sourceFiles, shouldPreserveMetadataMessages, output = resolve(project.poDir, `${project.domain}.pot`), }) => {
+const extractCatalogTemplate = ({ project, messages, shouldPreserveMetadataMessages, output = resolve(project.poDir, `${project.domain}.pot`), }) => {
     const workDir = mkdtempSync(join(project.poDir, ".gtkx-i18n-"));
     const source = join(workDir, "source.pot");
     const hasPreviousTemplate = existsSync(output);
@@ -373,11 +1190,11 @@ const extractCatalogTemplate = ({ project, messages, sourceFiles, shouldPreserve
         if (shouldPreserveMetadataMessages && hasPreviousTemplate) {
             const fragment = join(workDir, "metadata.pot");
             extractMetadataFragment(project, output, fragment);
-            extractSourceMessages({ project, messages, sourceFiles, output: source, workDir });
+            extractSourceMessages({ project, messages, output: source, workDir });
             joinMetadataFragment(source, fragment);
         }
         else {
-            extractSourceMessages({ project, messages, sourceFiles, output: source, workDir });
+            extractSourceMessages({ project, messages, output: source, workDir });
         }
         replaceCatalogTemplate(source, output);
     }
@@ -387,17 +1204,15 @@ const extractCatalogTemplate = ({ project, messages, sourceFiles, shouldPreserve
 };
 const extractSourceCatalogTo = async (project, paths, output) => {
     const sourceFiles = normalizedSourceFiles(project.root, paths);
-    const messages = await findSourceMessages(sourceFiles);
+    const messages = await findSourceMessages(project.root, sourceFiles);
     writePotfiles(project, sourceFiles);
-    extractCatalogTemplate({ project, messages, sourceFiles, shouldPreserveMetadataMessages: false, output });
-    return { messages, sourceFiles };
+    extractCatalogTemplate({ project, messages, shouldPreserveMetadataMessages: false, output });
 };
 const extractSourceCatalog = async (project, paths, shouldPreserveMetadataMessages = true) => {
     const sourceFiles = normalizedSourceFiles(project.root, paths);
-    const messages = await findSourceMessages(sourceFiles);
+    const messages = await findSourceMessages(project.root, sourceFiles);
     writePotfiles(project, sourceFiles);
-    extractCatalogTemplate({ project, messages, sourceFiles, shouldPreserveMetadataMessages });
-    return { messages, sourceFiles };
+    extractCatalogTemplate({ project, messages, shouldPreserveMetadataMessages });
 };
 export { extractSourceCatalog, extractSourceCatalogTo };
 //# sourceMappingURL=source-messages.js.map