@intlayer/babel 9.5.1 → 9.5.3

package/dist/esm/compat/optimizePass.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"optimizePass.mjs","names":[],"sources":["../../../src/compat/optimizePass.ts"],"sourcesContent":["import type * as BabelTypes from '@babel/types';\nimport {\n  type CallerDescriptor,\n  getRewritableCallers,\n} from '@intlayer/config/callers';\nimport type {\n  DictionaryImportRegistry,\n  ImportMode,\n} from '../dictionaryImports';\nimport { splitNamespace } from '../staticAstReaders';\nimport { resolveNamespaceForRewrite } from './namespaceResolution';\n\n/**\n * Compat half of the optimize pass.\n *\n * Every adapter-specific behaviour of the build-time rewrite lives here:\n * matching a compat caller's import, resolving its namespace, and re-pointing\n * the import specifier at the dictionary-accepting helper.\n *\n * The pass works on plain AST nodes rather than `NodePath`s: the optimize\n * plugin collects the call sites in its single traversal and hands them over,\n * so nothing here walks the tree.\n *\n * It is created only when compat descriptors were injected by a compat\n * package's bundler plugin, so a plain intlayer build never allocates it —\n * {@link createCompatOptimizePass} returns `null` for an empty registry.\n */\nexport type CompatOptimizePass = {\n  /**\n   * Whether `importSource` exports at least one rewritable compat caller, so\n   * the optimize plugin knows the import is worth inspecting even though it is\n   * not a native intlayer package.\n   */\n  ownsImportSource: (importSource: string) => boolean;\n  /** Records the local alias one import specifier introduces. */\n  noteImport: (\n    importSource: string,\n    importedName: string,\n    localName: string\n  ) => void;\n  /** Whether `localName` was bound to a compat caller by an import. */\n  ownsLocalName: (localName: string) => boolean;\n  /** Whether the file imported any compat caller at all. */\n  hasCallers: () => boolean;\n  /**\n   * Resolves the namespace of every collected call, dropping the callers that\n   * cannot be rewritten and deciding the file-level helper family. Must run\n   * after every import was noted and before any rewrite.\n   */\n  analyzeCalls: (callNodes: readonly BabelTypes.CallExpression[]) => void;\n  /** Rewrites one compat call site, if its caller survived {@link analyzeCalls}. */\n  rewriteCall: (callNode: BabelTypes.CallExpression) => void;\n  /** Re-points the compat specifiers of one import declaration. */\n  rewriteImportSpecifiers: (importNode: BabelTypes.ImportDeclaration) => void;\n};\n\n/**\n * Rewritable slice of a descriptor registry, cached by array reference.\n *\n * Babel reuses one plugin-options object for every file of a build, so the\n * filter runs once per build instead of once per transformed file.\n */\nconst rewritableCallersCache = new WeakMap<\n  readonly CallerDescriptor[],\n  readonly CallerDescriptor[]\n>();\n\nconst getCachedRewritableCallers = (\n  compatCallers: readonly CallerDescriptor[]\n): readonly CallerDescriptor[] => {\n  let rewritable = rewritableCallersCache.get(compatCallers);\n\n  if (!rewritable) {\n    rewritable = getRewritableCallers([...compatCallers]);\n    rewritableCallersCache.set(compatCallers, rewritable);\n  }\n\n  return rewritable;\n};\n\n/**\n * `importSource` → the callers it exports, indexed by their imported name.\n *\n * Built once per descriptor registry so matching an import specifier is two\n * map lookups instead of a scan over every descriptor's `importSources`.\n */\ntype CallerIndex = Map<string, Map<string, CallerDescriptor>>;\n\nconst callerIndexCache = new WeakMap<\n  readonly CallerDescriptor[],\n  CallerIndex\n>();\n\nconst getCallerIndex = (\n  rewritableCallers: readonly CallerDescriptor[]\n): CallerIndex => {\n  let index = callerIndexCache.get(rewritableCallers);\n\n  if (!index) {\n    index = new Map();\n\n    for (const descriptor of rewritableCallers) {\n      for (const importSource of descriptor.importSources) {\n        let byName = index.get(importSource);\n\n        if (!byName) {\n          byName = new Map();\n          index.set(importSource, byName);\n        }\n\n        byName.set(descriptor.callerName, descriptor);\n      }\n    }\n\n    callerIndexCache.set(rewritableCallers, index);\n  }\n\n  return index;\n};\n\n/**\n * Builds the compat optimize pass for one source file, or `null` when no\n * compat caller was injected.\n *\n * @param babelTypes - Babel's type helpers.\n * @param compatCallers - Descriptors injected by the compat packages' plugins.\n * @param imports - Shared dictionary-import registry for the file.\n * @param buildModes - The file's global import mode and per-dictionary overrides.\n */\nexport const createCompatOptimizePass = (\n  babelTypes: typeof BabelTypes,\n  compatCallers: readonly CallerDescriptor[],\n  imports: DictionaryImportRegistry,\n  buildModes: {\n    importMode: ImportMode | undefined;\n    dictionaryModeMap?: Record<string, ImportMode | undefined>;\n  }\n): CompatOptimizePass | null => {\n  const rewritableCallers = getCachedRewritableCallers(compatCallers);\n  if (rewritableCallers.length === 0) return null;\n\n  const callerIndex = getCallerIndex(rewritableCallers);\n  const { importMode, dictionaryModeMap } = buildModes;\n\n  /** Local alias → the descriptor it was imported as. */\n  const callersByLocalName = new Map<string, CallerDescriptor>();\n\n  /**\n   * File-level decision: one import specifier serves every call in the file, so\n   * a global dynamic/fetch mode — or any per-dictionary override reached from\n   * this file — flips all rewritten compat calls to the dynamic helper.\n   */\n  let useDynamicHelpers = false;\n\n  /** Narrows to the two modes that resolve through a per-locale loader. */\n  const isDynamicMode = (\n    mode: ImportMode | undefined\n  ): mode is 'dynamic' | 'fetch' => mode === 'dynamic' || mode === 'fetch';\n\n  /** Import mode a compat call site resolves to for `dictionaryKey`. */\n  const importModeFor = (dictionaryKey: string): ImportMode => {\n    if (!useDynamicHelpers) return 'static';\n\n    const override = dictionaryModeMap?.[dictionaryKey];\n    if (isDynamicMode(override)) return override;\n\n    return isDynamicMode(importMode) ? importMode : 'dynamic';\n  };\n\n  return {\n    ownsImportSource: (importSource) => callerIndex.has(importSource),\n\n    noteImport: (importSource, importedName, localName) => {\n      const descriptor = callerIndex.get(importSource)?.get(importedName);\n      if (descriptor) callersByLocalName.set(localName, descriptor);\n    },\n\n    ownsLocalName: (localName) => callersByLocalName.has(localName),\n\n    hasCallers: () => callersByLocalName.size > 0,\n\n    analyzeCalls: (callNodes) => {\n      if (callersByLocalName.size === 0) return;\n\n      /**\n       * Locals with at least one call site whose namespace could not be read:\n       * one import specifier serves every call in the file, so re-pointing it\n       * while leaving those calls untouched would hand a raw namespace string\n       * — or nothing at all — to the dictionary-accepting helper.\n       */\n      const unresolvableLocalNames = new Set<string>();\n      let hasDynamicCall = false;\n\n      for (const callNode of callNodes) {\n        const callee = callNode.callee;\n        if (!babelTypes.isIdentifier(callee)) continue;\n\n        const descriptor = callersByLocalName.get(callee.name);\n        if (!descriptor) continue;\n\n        const namespaceMatch = resolveNamespaceForRewrite(\n          babelTypes,\n          callNode.arguments,\n          descriptor\n        );\n\n        // No readable namespace — a computed key, or a call that passes none\n        // at all (`useTranslations()`). Either way the dictionary is unknown at\n        // build time, so the call keeps resolving through the runtime registry\n        // and holds back the siblings sharing its import.\n        if (!namespaceMatch) {\n          unresolvableLocalNames.add(callee.name);\n          continue;\n        }\n\n        const { dictionaryKey } = splitNamespace(namespaceMatch.fullNamespace);\n        if (isDynamicMode(dictionaryModeMap?.[dictionaryKey])) {\n          hasDynamicCall = true;\n        }\n      }\n\n      for (const localName of unresolvableLocalNames) {\n        callersByLocalName.delete(localName);\n      }\n\n      useDynamicHelpers = isDynamicMode(importMode) || hasDynamicCall;\n    },\n\n    rewriteCall: (callNode) => {\n      const callee = callNode.callee;\n      if (!babelTypes.isIdentifier(callee)) return;\n\n      const descriptor = callersByLocalName.get(callee.name);\n      if (!descriptor) return;\n\n      const callArguments = callNode.arguments;\n      const namespaceMatch = resolveNamespaceForRewrite(\n        babelTypes,\n        callArguments,\n        descriptor\n      );\n      // Filtered out by `analyzeCalls` — the import keeps its original specifier.\n      if (!namespaceMatch) return;\n\n      const { dictionaryKey, keyPrefix } = splitNamespace(\n        namespaceMatch.fullNamespace\n      );\n      const mode = importModeFor(dictionaryKey);\n      const ident = imports.identFor(dictionaryKey, mode);\n      const isDynamicHelper = mode !== 'static';\n\n      if (namespaceMatch.argumentIndex !== undefined) {\n        // Positional namespace: replace the string with the dictionary, then\n        // the (dynamic) key and the (nested) prefix.\n        //   useTranslation('about.counter', opts)\n        //     static  → useDictionary(_hash, 'counter', opts)\n        //     dynamic → useDictionaryDynamic(_hash_dyn, 'about', 'counter', opts)\n        callArguments[namespaceMatch.argumentIndex] = babelTypes.identifier(\n          ident.name\n        );\n\n        const insertedArguments: BabelTypes.Expression[] = [];\n        if (isDynamicHelper) {\n          insertedArguments.push(babelTypes.stringLiteral(dictionaryKey));\n        }\n        if (keyPrefix) {\n          insertedArguments.push(babelTypes.stringLiteral(keyPrefix));\n        }\n        callArguments.splice(\n          namespaceMatch.argumentIndex + 1,\n          0,\n          ...insertedArguments\n        );\n      } else if (isDynamicHelper) {\n        // Fixed / option namespace: prepend the loader and the dictionary key.\n        callArguments.unshift(\n          babelTypes.identifier(ident.name),\n          babelTypes.stringLiteral(dictionaryKey)\n        );\n      } else {\n        // Fixed / option namespace, static helper: prepend the dictionary.\n        //   useLingui() → useDictionary(_hash)\n        callArguments.unshift(babelTypes.identifier(ident.name));\n      }\n\n      // Option namespace: leave only the key-prefix remainder in the options\n      // object (or drop the property entirely), so the runtime helper does not\n      // re-apply the dictionary key as a lookup prefix.\n      //   useI18n({ namespace: 'about' }) → useDictionary(_hash, {})\n      if (namespaceMatch.optionProperty && namespaceMatch.optionsObject) {\n        if (keyPrefix) {\n          namespaceMatch.optionProperty.value =\n            babelTypes.stringLiteral(keyPrefix);\n        } else {\n          namespaceMatch.optionsObject.properties =\n            namespaceMatch.optionsObject.properties.filter(\n              (property) => property !== namespaceMatch.optionProperty\n            );\n        }\n      }\n    },\n\n    rewriteImportSpecifiers: (importNode) => {\n      const byName = callerIndex.get(importNode.source.value);\n      if (!byName) return;\n\n      for (const specifier of importNode.specifiers) {\n        if (!babelTypes.isImportSpecifier(specifier)) continue;\n\n        // Only a specifier still held by `callersByLocalName` is rewritable —\n        // `analyzeCalls` removed the ones with an unresolvable call site.\n        const descriptor = callersByLocalName.get(specifier.local.name);\n        if (!descriptor || !byName.has(descriptor.callerName)) continue;\n\n        // Keep the local alias so call sites read unchanged; only the imported\n        // name moves to the dictionary-accepting helper.\n        specifier.imported = babelTypes.identifier(\n          useDynamicHelpers\n            ? descriptor.dynamicReplacement!\n            : descriptor.staticReplacement!\n        );\n      }\n    },\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"optimizePass.mjs","names":[],"sources":["../../../src/compat/optimizePass.ts"],"sourcesContent":["import type * as BabelTypes from '@babel/types';\nimport {\n  type CallerDescriptor,\n  getRewritableCallers,\n} from '@intlayer/config/callers';\nimport type {\n  DictionaryImportRegistry,\n  ImportMode,\n} from '../dictionaryImports';\nimport {\n  ABSENT_VALUE,\n  readJsxAttributeString,\n  readObjectPropertyNode,\n  readStaticString,\n  splitNamespace,\n} from '../staticAstReaders';\nimport {\n  resolveNamespaceForAnalysis,\n  resolveNamespaceForRewrite,\n} from './namespaceResolution';\n\n/**\n * Compat half of the optimize pass.\n *\n * Every adapter-specific behaviour of the build-time rewrite lives here:\n * matching a compat caller's import, resolving its namespace, and re-pointing\n * the import specifier at the dictionary-accepting helper.\n *\n * The pass works on plain AST nodes rather than `NodePath`s: the optimize\n * plugin collects the call sites in its single traversal and hands them over,\n * so nothing here walks the tree.\n *\n * It is created only when compat descriptors were injected by a compat\n * package's bundler plugin, so a plain intlayer build never allocates it —\n * {@link createCompatOptimizePass} returns `null` for an empty registry.\n */\nexport type CompatOptimizePass = {\n  /**\n   * Whether `importSource` exports at least one rewritable compat caller, so\n   * the optimize plugin knows the import is worth inspecting even though it is\n   * not a native intlayer package.\n   */\n  ownsImportSource: (importSource: string) => boolean;\n  /** Records the local alias one import specifier introduces. */\n  noteImport: (\n    importSource: string,\n    importedName: string,\n    localName: string\n  ) => void;\n  /** Whether `localName` was bound to a compat caller by an import. */\n  ownsLocalName: (localName: string) => boolean;\n  /**\n   * Records the names a compat call's result was destructured into\n   * (`const { i18n, _, t } = useLingui()`), so a bare `t('…')` call in the\n   * file is read as a message-id site of that library. Names that are not\n   * message callers of the library are ignored.\n   */\n  noteDestructuredResult: (localCallerName: string, names: string[]) => void;\n  /** Whether the file imported any compat caller at all. */\n  hasCallers: () => boolean;\n  /**\n   * Whether the file imported a root-scope caller whose dictionaries are\n   * named by message ids (`useLingui()`), so the traversal must also hand\n   * over the id-carrying sites through {@link collectMessageIdSite}. Valid\n   * once every import was noted.\n   */\n  needsMessageIdSites: () => boolean;\n  /**\n   * Records one node that may carry a message id for a root-scope caller: a\n   * call (`i18n._('footer.github')`, `t({ id })`), a tagged template\n   * (``t`…` ``) or a JSX opening element (`<Trans id=\"…\" />`). Nodes that\n   * match no message caller are ignored.\n   */\n  collectMessageIdSite: (\n    node:\n      | BabelTypes.CallExpression\n      | BabelTypes.TaggedTemplateExpression\n      | BabelTypes.JSXOpeningElement\n  ) => void;\n  /**\n   * Whether the node is an element of a compat JSX caller bound by its id\n   * attribute (`<Trans id=\"…\" />`) imported by the file — as source JSX, or\n   * already compiled by the framework plugin into `jsx(Trans, { id })`.\n   */\n  ownsJsxSite: (node: JsxSiteNode) => boolean;\n  /**\n   * Resolves the namespace of every collected call and element, dropping the\n   * callers that cannot be rewritten and deciding the file-level helper\n   * family. Must run after every import was noted and every message-id site\n   * collected, and before any rewrite.\n   *\n   * @param countReferences - Number of references a local name has in the\n   * file. A JSX caller is only re-pointed when every reference is a bound\n   * element: one passed around as a value (`component={Trans}`) would reach\n   * the dictionary-accepting replacement without its dictionary.\n   */\n  analyzeCalls: (\n    callNodes: readonly BabelTypes.CallExpression[],\n    jsxSites?: readonly JsxSiteNode[],\n    countReferences?: (localName: string) => number\n  ) => void;\n  /** Rewrites one compat call site, if its caller survived {@link analyzeCalls}. */\n  rewriteCall: (callNode: BabelTypes.CallExpression) => void;\n  /**\n   * Binds one compat JSX element, if its caller survived {@link analyzeCalls}:\n   * adds the `dictionary` prop naming the dictionary its id addresses.\n   */\n  rewriteJsxSite: (node: JsxSiteNode) => void;\n  /** Re-points the compat specifiers of one import declaration. */\n  rewriteImportSpecifiers: (importNode: BabelTypes.ImportDeclaration) => void;\n};\n\n/**\n * A compat JSX element as the pass may meet it: the source element, or the\n * call the automatic/classic JSX runtime compiled it into — the optimize\n * transform runs after the framework plugin, so on Vite the compiled form is\n * the usual one.\n */\nexport type JsxSiteNode =\n  | BabelTypes.JSXOpeningElement\n  | BabelTypes.CallExpression;\n\n/**\n * Factories a JSX element compiles into — `jsx(Trans, props)` /\n * `_jsxs(Trans, props)` / `jsxRuntime.jsxDEV(Trans, props)` for the automatic\n * runtime, `React.createElement(Trans, props)` for the classic one. The\n * transform aliases the import (`_jsx`), hence the optional underscores.\n */\nconst COMPILED_JSX_FACTORY_PATTERN = /^_*(jsxs?|jsxDEV|createElement)$/;\n\n/**\n * Rewritable slice of a descriptor registry, cached by array reference.\n *\n * Babel reuses one plugin-options object for every file of a build, so the\n * filter runs once per build instead of once per transformed file.\n */\nconst rewritableCallersCache = new WeakMap<\n  readonly CallerDescriptor[],\n  readonly CallerDescriptor[]\n>();\n\nconst getCachedRewritableCallers = (\n  compatCallers: readonly CallerDescriptor[]\n): readonly CallerDescriptor[] => {\n  let rewritable = rewritableCallersCache.get(compatCallers);\n\n  if (!rewritable) {\n    rewritable = getRewritableCallers([...compatCallers]);\n    rewritableCallersCache.set(compatCallers, rewritable);\n  }\n\n  return rewritable;\n};\n\n/**\n * `importSource` → the callers it exports, indexed by their imported name.\n *\n * Built once per descriptor registry so matching an import specifier is two\n * map lookups instead of a scan over every descriptor's `importSources`.\n */\ntype CallerIndex = Map<string, Map<string, CallerDescriptor>>;\n\nconst callerIndexCache = new WeakMap<\n  readonly CallerDescriptor[],\n  CallerIndex\n>();\n\nconst getCallerIndex = (\n  rewritableCallers: readonly CallerDescriptor[]\n): CallerIndex => {\n  let index = callerIndexCache.get(rewritableCallers);\n\n  if (!index) {\n    index = new Map();\n\n    for (const descriptor of rewritableCallers) {\n      for (const importSource of descriptor.importSources) {\n        let byName = index.get(importSource);\n\n        if (!byName) {\n          byName = new Map();\n          index.set(importSource, byName);\n        }\n\n        byName.set(descriptor.callerName, descriptor);\n      }\n    }\n\n    callerIndexCache.set(rewritableCallers, index);\n  }\n\n  return index;\n};\n\n/**\n * Prop through which a bound compat JSX element (`<Trans>`) receives its\n * dictionary — the static dictionary, or a `[loader, key]` pair in dynamic\n * mode. The compat package's replacement component reads it.\n */\nconst JSX_DICTIONARY_ATTRIBUTE = 'dictionary';\n\n/**\n * Whether a descriptor's call sites carry the message id themselves, with the\n * dictionary named by the id's first dot-segment (lingui's `_` / `t` /\n * `<Trans>`, react-intl's `formatMessage`). These are the sites a root-scope\n * binding reads its dictionaries from.\n */\nconst isMessageIdCaller = (descriptor: CallerDescriptor): boolean =>\n  descriptor.translationFunction === 'self' &&\n  descriptor.namespaceSources.some(\n    (source) => source.from === 'path-first-segment'\n  );\n\n/**\n * `library` → its message-id callers, cached by registry reference.\n *\n * Read from the full registry rather than its rewritable slice: the id\n * callers are matched as methods or JSX and are never rewritten themselves —\n * they only name the dictionaries a root-scope call in the same file binds.\n */\nconst messageIdCallersCache = new WeakMap<\n  readonly CallerDescriptor[],\n  Map<string, CallerDescriptor[]>\n>();\n\nconst getMessageIdCallersByLibrary = (\n  compatCallers: readonly CallerDescriptor[]\n): Map<string, CallerDescriptor[]> => {\n  let byLibrary = messageIdCallersCache.get(compatCallers);\n\n  if (!byLibrary) {\n    byLibrary = new Map();\n\n    for (const descriptor of compatCallers) {\n      if (!isMessageIdCaller(descriptor)) continue;\n\n      let descriptors = byLibrary.get(descriptor.library);\n\n      if (!descriptors) {\n        descriptors = [];\n        byLibrary.set(descriptor.library, descriptors);\n      }\n\n      descriptors.push(descriptor);\n    }\n\n    messageIdCallersCache.set(compatCallers, byLibrary);\n  }\n\n  return byLibrary;\n};\n\n/**\n * The dictionaries a library's root-scope calls bind in the current file:\n * the first segment of every static message id, or `undefined` once a single\n * id could not be read — a computed id may address any dictionary, so the\n * calls must keep resolving through the runtime registry.\n */\ntype RootScopeBinding = Set<string> | undefined;\n\n/**\n * Builds the compat optimize pass for one source file, or `null` when no\n * compat caller was injected.\n *\n * @param babelTypes - Babel's type helpers.\n * @param compatCallers - Descriptors injected by the compat packages' plugins.\n * @param imports - Shared dictionary-import registry for the file.\n * @param buildModes - The file's global import mode and per-dictionary overrides.\n */\nexport const createCompatOptimizePass = (\n  babelTypes: typeof BabelTypes,\n  compatCallers: readonly CallerDescriptor[],\n  imports: DictionaryImportRegistry,\n  buildModes: {\n    importMode: ImportMode | undefined;\n    dictionaryModeMap?: Record<string, ImportMode | undefined>;\n  }\n): CompatOptimizePass | null => {\n  const rewritableCallers = getCachedRewritableCallers(compatCallers);\n  if (rewritableCallers.length === 0) return null;\n\n  const callerIndex = getCallerIndex(rewritableCallers);\n  const messageIdCallersByLibrary = getMessageIdCallersByLibrary(compatCallers);\n  const { importMode, dictionaryModeMap } = buildModes;\n\n  /** Local alias → the descriptor it was imported as. */\n  const callersByLocalName = new Map<string, CallerDescriptor>();\n\n  /**\n   * Root-scope binding per library, filled from the message-id sites the\n   * traversal hands over. A library is present only once a root-scope caller\n   * of it was imported, so the sites of other libraries are never read.\n   */\n  const rootScopeBindings = new Map<string, RootScopeBinding>();\n\n  /**\n   * Local names a bare message call may use per library: message callers\n   * imported from the library (`import { t } from '@lingui/macro'`) and\n   * names destructured from a root-scope call's result\n   * (`const { _ } = useLingui()`). A bare `t('…')` bound to anything else —\n   * say a local wrapper — is not a message-id site, mirroring the usage\n   * analyser; method calls (`i18n._('…')`) match by method name alone.\n   */\n  const bareMessageCallerNames = new Map<string, Set<string>>();\n\n  /**\n   * Bare calls met during the traversal, decided once every binding name is\n   * known — a destructuring may sit below the call sites in source order.\n   */\n  const pendingBareCalls: {\n    library: string;\n    name: string;\n    node: BabelTypes.CallExpression;\n  }[] = [];\n\n  const addBareMessageCallerName = (library: string, name: string): void => {\n    let names = bareMessageCallerNames.get(library);\n    if (!names) {\n      names = new Set();\n      bareMessageCallerNames.set(library, names);\n    }\n    names.add(name);\n  };\n\n  /**\n   * File-level decision: one import specifier serves every call in the file, so\n   * a global dynamic/fetch mode — or any per-dictionary override reached from\n   * this file — flips all rewritten compat calls to the dynamic helper.\n   */\n  let useDynamicHelpers = false;\n\n  /** Narrows to the two modes that resolve through a per-locale loader. */\n  const isDynamicMode = (\n    mode: ImportMode | undefined\n  ): mode is 'dynamic' | 'fetch' => mode === 'dynamic' || mode === 'fetch';\n\n  /** Import mode a compat call site resolves to for `dictionaryKey`. */\n  const importModeFor = (dictionaryKey: string): ImportMode => {\n    if (!useDynamicHelpers) return 'static';\n\n    const override = dictionaryModeMap?.[dictionaryKey];\n    if (isDynamicMode(override)) return override;\n\n    return isDynamicMode(importMode) ? importMode : 'dynamic';\n  };\n\n  /**\n   * Whether a call binds through the root-scope path: its descriptor allows\n   * it, the library has id callers to read from, and the call itself names\n   * no dictionary (`useLingui()`).\n   */\n  const isRootScopeCall = (\n    descriptor: CallerDescriptor,\n    callArguments: BabelTypes.CallExpression['arguments']\n  ): boolean =>\n    descriptor.allowRootScope === true &&\n    messageIdCallersByLibrary.has(descriptor.library) &&\n    resolveNamespaceForRewrite(babelTypes, callArguments, descriptor) ===\n      undefined;\n\n  /** Name a callee or tag reads as, whether bare (`t`) or a method (`i18n.t`). */\n  const readCalleeName = (\n    node: BabelTypes.Node\n  ): { name: string; isMethod: boolean } | undefined => {\n    if (babelTypes.isIdentifier(node)) {\n      return { name: node.name, isMethod: false };\n    }\n    if (\n      babelTypes.isMemberExpression(node) &&\n      babelTypes.isIdentifier(node.property) &&\n      !node.computed\n    ) {\n      return { name: node.property.name, isMethod: true };\n    }\n    return undefined;\n  };\n\n  /** The id descriptor of `library` matching a callee name, if any. */\n  const findMessageIdCaller = (\n    library: string,\n    callee: { name: string; isMethod: boolean } | undefined,\n    shape: 'call' | 'tagged-template'\n  ): CallerDescriptor | undefined => {\n    if (!callee) return undefined;\n\n    return messageIdCallersByLibrary\n      .get(library)\n      ?.find(\n        (descriptor) =>\n          descriptor.callerName === callee.name &&\n          (shape === 'tagged-template'\n            ? descriptor.matchAsTaggedTemplate === true\n            : !callee.isMethod || descriptor.matchAsMethod === true)\n      );\n  };\n\n  /** Records the dictionary key read from one message call's arguments. */\n  const recordMessageCall = (\n    library: string,\n    descriptor: CallerDescriptor,\n    callArguments: BabelTypes.CallExpression['arguments']\n  ): void => {\n    const resolved = resolveNamespaceForAnalysis(\n      babelTypes,\n      callArguments,\n      descriptor.namespaceSources\n    );\n\n    recordRootScopeKey(\n      library,\n      typeof resolved === 'string' && resolved !== ABSENT_VALUE\n        ? resolved\n        : undefined\n    );\n  };\n\n  /** Records one dictionary key for `library`, or poisons its binding. */\n  const recordRootScopeKey = (\n    library: string,\n    dictionaryKey: string | undefined\n  ): void => {\n    const binding = rootScopeBindings.get(library);\n    // Already poisoned: nothing can un-poison a file.\n    if (binding === undefined) return;\n\n    if (dictionaryKey === undefined) {\n      rootScopeBindings.set(library, undefined);\n      return;\n    }\n\n    binding.add(dictionaryKey);\n  };\n\n  /**\n   * The dictionary an id-derived key binds: the key itself when the build\n   * produced such a dictionary, else the library's whole-file catalog\n   * (`messages` for lingui, `index` otherwise) with the id kept intact, else\n   * `undefined` — nothing to bind safely.\n   *\n   * Id-derived keys are guesses, so the set of dictionaries the build actually\n   * produced is required to tell a dictionary from a group inside the\n   * whole-file catalog.\n   */\n  const settleDictionaryKey = (\n    key: string,\n    descriptor: CallerDescriptor\n  ): string | undefined => {\n    if (!dictionaryModeMap) return undefined;\n    if (key in dictionaryModeMap) return key;\n\n    const rootKey = descriptor.rootDictionaryKey ?? 'index';\n    return rootKey in dictionaryModeMap ? rootKey : undefined;\n  };\n\n  /**\n   * Settles every collected key of a library's root-scope binding, poisoning\n   * it when one key has nothing to bind — or when no id was read at all, since\n   * a call with nothing to bind must keep the registry.\n   */\n  const settleRootScopeBinding = (\n    library: string,\n    descriptor: CallerDescriptor\n  ): void => {\n    const binding = rootScopeBindings.get(library);\n    if (binding === undefined || binding.size === 0) {\n      rootScopeBindings.set(library, undefined);\n      return;\n    }\n\n    const settled = new Set<string>();\n\n    for (const key of binding) {\n      const dictionaryKey = settleDictionaryKey(key, descriptor);\n      if (dictionaryKey === undefined) {\n        rootScopeBindings.set(library, undefined);\n        return;\n      }\n      settled.add(dictionaryKey);\n    }\n\n    rootScopeBindings.set(library, settled);\n  };\n\n  /**\n   * A JSX element in either of its shapes, reduced to what the pass needs:\n   * the component's local name, its static id, and a way to add a prop.\n   */\n  type JsxSite = {\n    localName: string;\n    /** The static id attribute as a string node, `undefined` when dynamic or absent. */\n    readId: (attributeName: string) => BabelTypes.StringLiteral | undefined;\n    addProp: (name: string, value: BabelTypes.Expression) => void;\n  };\n\n  const readJsxSite = (node: JsxSiteNode): JsxSite | undefined => {\n    if (babelTypes.isJSXOpeningElement(node)) {\n      if (!babelTypes.isJSXIdentifier(node.name)) return undefined;\n\n      return {\n        localName: node.name.name,\n        readId: (attributeName) =>\n          readJsxAttributeString(babelTypes, node, attributeName),\n        addProp: (name, value) => {\n          node.attributes.push(\n            babelTypes.jsxAttribute(\n              babelTypes.jsxIdentifier(name),\n              babelTypes.jsxExpressionContainer(value)\n            )\n          );\n        },\n      };\n    }\n\n    // Compiled form: `jsx(Trans, { id: \"…\" })` / `React.createElement(Trans, {…})`.\n    const callee = readCalleeName(node.callee);\n    if (!callee || !COMPILED_JSX_FACTORY_PATTERN.test(callee.name)) {\n      return undefined;\n    }\n\n    const [component, props] = node.arguments;\n    if (\n      !babelTypes.isIdentifier(component) ||\n      !babelTypes.isObjectExpression(props)\n    ) {\n      return undefined;\n    }\n\n    return {\n      localName: component.name,\n      readId: (attributeName) => {\n        const idNode = readObjectPropertyNode(babelTypes, props, attributeName);\n        if (idNode === ABSENT_VALUE) return undefined;\n        const id = readStaticString(babelTypes, idNode);\n        return id === undefined ? undefined : babelTypes.stringLiteral(id);\n      },\n      addProp: (name, value) => {\n        props.properties.push(\n          babelTypes.objectProperty(babelTypes.identifier(name), value)\n        );\n      },\n    };\n  };\n\n  /** The compat JSX descriptor a site's component was imported as, if any. */\n  const jsxDescriptorFor = (\n    site: JsxSite | undefined\n  ): CallerDescriptor | undefined => {\n    if (!site) return undefined;\n    const descriptor = callersByLocalName.get(site.localName);\n    return descriptor?.jsxIdAttribute !== undefined ? descriptor : undefined;\n  };\n\n  /**\n   * The dictionary a compat JSX element binds, read from the first segment of\n   * its static id attribute — `undefined` when the id is dynamic or names\n   * nothing the build produced.\n   */\n  const resolveJsxDictionaryKey = (\n    site: JsxSite,\n    descriptor: CallerDescriptor\n  ): string | undefined => {\n    const idAttribute = site.readId(descriptor.jsxIdAttribute!);\n    if (!idAttribute) return undefined;\n\n    const resolved = resolveNamespaceForAnalysis(\n      babelTypes,\n      [idAttribute],\n      descriptor.namespaceSources\n    );\n    if (typeof resolved !== 'string' || resolved === ABSENT_VALUE) {\n      return undefined;\n    }\n\n    return settleDictionaryKey(resolved, descriptor);\n  };\n\n  return {\n    ownsImportSource: (importSource) => callerIndex.has(importSource),\n\n    noteImport: (importSource, importedName, localName) => {\n      for (const [library, descriptors] of messageIdCallersByLibrary) {\n        if (\n          descriptors.some(\n            (candidate) =>\n              candidate.callerName === importedName &&\n              candidate.importSources.includes(importSource)\n          )\n        ) {\n          addBareMessageCallerName(library, localName);\n        }\n      }\n\n      const descriptor = callerIndex.get(importSource)?.get(importedName);\n      if (!descriptor) return;\n\n      callersByLocalName.set(localName, descriptor);\n\n      if (\n        descriptor.allowRootScope &&\n        messageIdCallersByLibrary.has(descriptor.library) &&\n        !rootScopeBindings.has(descriptor.library)\n      ) {\n        rootScopeBindings.set(descriptor.library, new Set());\n      }\n    },\n\n    ownsLocalName: (localName) => callersByLocalName.has(localName),\n\n    noteDestructuredResult: (localCallerName, names) => {\n      const descriptor = callersByLocalName.get(localCallerName);\n      if (!descriptor?.allowRootScope) return;\n\n      const messageCallers = messageIdCallersByLibrary.get(descriptor.library);\n      if (!messageCallers) return;\n\n      for (const name of names) {\n        if (messageCallers.some((candidate) => candidate.callerName === name)) {\n          addBareMessageCallerName(descriptor.library, name);\n        }\n      }\n    },\n\n    hasCallers: () => callersByLocalName.size > 0,\n\n    needsMessageIdSites: () => rootScopeBindings.size > 0,\n\n    ownsJsxSite: (node) => jsxDescriptorFor(readJsxSite(node)) !== undefined,\n\n    collectMessageIdSite: (node) => {\n      for (const library of rootScopeBindings.keys()) {\n        // An element — as JSX or as the call it compiled into — matched by\n        // the component's name against the library's JSX id callers.\n        const jsxSite = babelTypes.isTaggedTemplateExpression(node)\n          ? undefined\n          : readJsxSite(node);\n        if (jsxSite) {\n          const descriptor = messageIdCallersByLibrary\n            .get(library)\n            ?.find(\n              (candidate) =>\n                candidate.callerName === jsxSite.localName &&\n                candidate.jsxIdAttribute !== undefined\n            );\n          if (!descriptor) continue;\n\n          const idAttribute = jsxSite.readId(descriptor.jsxIdAttribute!);\n          const resolved = idAttribute\n            ? resolveNamespaceForAnalysis(\n                babelTypes,\n                [idAttribute],\n                descriptor.namespaceSources\n              )\n            : undefined;\n\n          recordRootScopeKey(\n            library,\n            typeof resolved === 'string' && resolved !== ABSENT_VALUE\n              ? resolved\n              : undefined\n          );\n          continue;\n        }\n\n        if (babelTypes.isJSXOpeningElement(node)) continue;\n\n        if (babelTypes.isTaggedTemplateExpression(node)) {\n          // A macro template (``t`Hello ${name}` ``) has no id until the\n          // lingui macro plugin compiles it, so reaching one here means the\n          // id is unknowable.\n          const descriptor = findMessageIdCaller(\n            library,\n            readCalleeName(node.tag),\n            'tagged-template'\n          );\n          if (descriptor) recordRootScopeKey(library, undefined);\n          continue;\n        }\n\n        const callee = readCalleeName(node.callee);\n        const descriptor = findMessageIdCaller(library, callee, 'call');\n        if (!descriptor || !callee) continue;\n\n        if (!callee.isMethod) {\n          pendingBareCalls.push({ library, name: callee.name, node });\n          continue;\n        }\n\n        recordMessageCall(library, descriptor, node.arguments);\n      }\n    },\n\n    analyzeCalls: (callNodes, jsxSites = [], countReferences) => {\n      if (callersByLocalName.size === 0) return;\n\n      /**\n       * Locals with at least one call site whose namespace could not be read:\n       * one import specifier serves every call in the file, so re-pointing it\n       * while leaving those calls untouched would hand a raw namespace string\n       * — or nothing at all — to the dictionary-accepting helper.\n       */\n      const unresolvableLocalNames = new Set<string>();\n      let hasDynamicCall = false;\n      const settledLibraries = new Set<string>();\n\n      for (const { library, name, node } of pendingBareCalls) {\n        if (!bareMessageCallerNames.get(library)?.has(name)) continue;\n\n        const descriptor = findMessageIdCaller(\n          library,\n          { name, isMethod: false },\n          'call'\n        );\n        if (descriptor) recordMessageCall(library, descriptor, node.arguments);\n      }\n      pendingBareCalls.length = 0;\n\n      for (const callNode of callNodes) {\n        const callee = callNode.callee;\n        if (!babelTypes.isIdentifier(callee)) continue;\n\n        const descriptor = callersByLocalName.get(callee.name);\n        if (!descriptor) continue;\n\n        if (isRootScopeCall(descriptor, callNode.arguments)) {\n          if (!settledLibraries.has(descriptor.library)) {\n            settleRootScopeBinding(descriptor.library, descriptor);\n            settledLibraries.add(descriptor.library);\n          }\n\n          const binding = rootScopeBindings.get(descriptor.library);\n          if (binding === undefined) {\n            unresolvableLocalNames.add(callee.name);\n            continue;\n          }\n\n          for (const dictionaryKey of binding) {\n            if (isDynamicMode(dictionaryModeMap?.[dictionaryKey])) {\n              hasDynamicCall = true;\n            }\n          }\n          continue;\n        }\n\n        const namespaceMatch = resolveNamespaceForRewrite(\n          babelTypes,\n          callNode.arguments,\n          descriptor\n        );\n\n        // No readable namespace — a computed key, or a call that passes none\n        // at all (`useTranslations()`). Either way the dictionary is unknown at\n        // build time, so the call keeps resolving through the runtime registry\n        // and holds back the siblings sharing its import.\n        if (!namespaceMatch) {\n          unresolvableLocalNames.add(callee.name);\n          continue;\n        }\n\n        const { dictionaryKey } = splitNamespace(namespaceMatch.fullNamespace);\n        if (isDynamicMode(dictionaryModeMap?.[dictionaryKey])) {\n          hasDynamicCall = true;\n        }\n      }\n\n      /** Bound elements seen per JSX caller local, to match against references. */\n      const jsxSiteCounts = new Map<string, number>();\n\n      for (const jsxNode of jsxSites) {\n        const site = readJsxSite(jsxNode);\n        const descriptor = jsxDescriptorFor(site);\n        if (!site || !descriptor) continue;\n\n        jsxSiteCounts.set(\n          site.localName,\n          (jsxSiteCounts.get(site.localName) ?? 0) + 1\n        );\n\n        const dictionaryKey = resolveJsxDictionaryKey(site, descriptor);\n        if (dictionaryKey === undefined) {\n          unresolvableLocalNames.add(site.localName);\n          continue;\n        }\n\n        if (isDynamicMode(dictionaryModeMap?.[dictionaryKey])) {\n          hasDynamicCall = true;\n        }\n      }\n\n      // A JSX caller is re-pointed only when every reference to it is an\n      // element the pass binds — the import specifier serves them all.\n      for (const [localName, descriptor] of callersByLocalName) {\n        if (descriptor.jsxIdAttribute === undefined) continue;\n\n        const boundSites = jsxSiteCounts.get(localName) ?? 0;\n        const references = countReferences?.(localName) ?? boundSites;\n        if (boundSites === 0 || references !== boundSites) {\n          unresolvableLocalNames.add(localName);\n        }\n      }\n\n      for (const localName of unresolvableLocalNames) {\n        callersByLocalName.delete(localName);\n      }\n\n      useDynamicHelpers = isDynamicMode(importMode) || hasDynamicCall;\n    },\n\n    rewriteCall: (callNode) => {\n      const callee = callNode.callee;\n      if (!babelTypes.isIdentifier(callee)) return;\n\n      const descriptor = callersByLocalName.get(callee.name);\n      if (!descriptor) return;\n\n      const callArguments = callNode.arguments;\n\n      if (isRootScopeCall(descriptor, callArguments)) {\n        // Filtered out by `analyzeCalls` when poisoned — never reached here.\n        const binding = rootScopeBindings.get(descriptor.library);\n        if (binding === undefined) return;\n\n        // Root scope: every dictionary named in the file, ids kept intact so\n        // the runtime picks the dictionary by first segment.\n        //   useLingui()\n        //     static  → useDictionary(_footer, _header)\n        //     dynamic → useDictionaryDynamic([_footer_dyn, 'footer'], …)\n        for (const dictionaryKey of binding) {\n          const mode = importModeFor(dictionaryKey);\n          const ident = babelTypes.identifier(\n            imports.identFor(dictionaryKey, mode).name\n          );\n\n          callArguments.push(\n            mode === 'static'\n              ? ident\n              : babelTypes.arrayExpression([\n                  ident,\n                  babelTypes.stringLiteral(dictionaryKey),\n                ])\n          );\n        }\n        return;\n      }\n\n      const namespaceMatch = resolveNamespaceForRewrite(\n        babelTypes,\n        callArguments,\n        descriptor\n      );\n      // Filtered out by `analyzeCalls` — the import keeps its original specifier.\n      if (!namespaceMatch) return;\n\n      const { dictionaryKey, keyPrefix } = splitNamespace(\n        namespaceMatch.fullNamespace\n      );\n      const mode = importModeFor(dictionaryKey);\n      const ident = imports.identFor(dictionaryKey, mode);\n      const isDynamicHelper = mode !== 'static';\n\n      if (namespaceMatch.argumentIndex !== undefined) {\n        // Positional namespace: replace the string with the dictionary, then\n        // the (dynamic) key and the (nested) prefix.\n        //   useTranslation('about.counter', opts)\n        //     static  → useDictionary(_hash, 'counter', opts)\n        //     dynamic → useDictionaryDynamic(_hash_dyn, 'about', 'counter', opts)\n        callArguments[namespaceMatch.argumentIndex] = babelTypes.identifier(\n          ident.name\n        );\n\n        const insertedArguments: BabelTypes.Expression[] = [];\n        if (isDynamicHelper) {\n          insertedArguments.push(babelTypes.stringLiteral(dictionaryKey));\n        }\n        if (keyPrefix) {\n          insertedArguments.push(babelTypes.stringLiteral(keyPrefix));\n        }\n        callArguments.splice(\n          namespaceMatch.argumentIndex + 1,\n          0,\n          ...insertedArguments\n        );\n      } else if (isDynamicHelper) {\n        // Fixed / option namespace: prepend the loader and the dictionary key.\n        callArguments.unshift(\n          babelTypes.identifier(ident.name),\n          babelTypes.stringLiteral(dictionaryKey)\n        );\n      } else {\n        // Fixed / option namespace, static helper: prepend the dictionary.\n        callArguments.unshift(babelTypes.identifier(ident.name));\n      }\n\n      // Option namespace: leave only the key-prefix remainder in the options\n      // object (or drop the property entirely), so the runtime helper does not\n      // re-apply the dictionary key as a lookup prefix.\n      //   useI18n({ namespace: 'about' }) → useDictionary(_hash, {})\n      if (namespaceMatch.optionProperty && namespaceMatch.optionsObject) {\n        if (keyPrefix) {\n          namespaceMatch.optionProperty.value =\n            babelTypes.stringLiteral(keyPrefix);\n        } else {\n          namespaceMatch.optionsObject.properties =\n            namespaceMatch.optionsObject.properties.filter(\n              (property) => property !== namespaceMatch.optionProperty\n            );\n        }\n      }\n    },\n\n    rewriteJsxSite: (node) => {\n      const site = readJsxSite(node);\n      const descriptor = jsxDescriptorFor(site);\n      if (!site || !descriptor) return;\n\n      // Filtered out by `analyzeCalls` when unresolvable — never reached here.\n      const dictionaryKey = resolveJsxDictionaryKey(site, descriptor);\n      if (dictionaryKey === undefined) return;\n\n      const mode = importModeFor(dictionaryKey);\n      const ident = babelTypes.identifier(\n        imports.identFor(dictionaryKey, mode).name\n      );\n\n      // The id stays intact; the element receives the dictionary it names.\n      //   <Trans id=\"footer.github\" />\n      //     static  → <Trans id=\"footer.github\" dictionary={_footer} />\n      //     dynamic → <Trans id=\"footer.github\" dictionary={[_footer_dyn, 'footer']} />\n      site.addProp(\n        JSX_DICTIONARY_ATTRIBUTE,\n        mode === 'static'\n          ? ident\n          : babelTypes.arrayExpression([\n              ident,\n              babelTypes.stringLiteral(dictionaryKey),\n            ])\n      );\n    },\n\n    rewriteImportSpecifiers: (importNode) => {\n      const byName = callerIndex.get(importNode.source.value);\n      if (!byName) return;\n\n      for (const specifier of importNode.specifiers) {\n        if (!babelTypes.isImportSpecifier(specifier)) continue;\n\n        // Only a specifier still held by `callersByLocalName` is rewritable —\n        // `analyzeCalls` removed the ones with an unresolvable call site.\n        const descriptor = callersByLocalName.get(specifier.local.name);\n        if (!descriptor || !byName.has(descriptor.callerName)) continue;\n\n        // Keep the local alias so call sites read unchanged; only the imported\n        // name moves to the dictionary-accepting helper.\n        specifier.imported = babelTypes.identifier(\n          useDynamicHelpers\n            ? descriptor.dynamicReplacement!\n            : descriptor.staticReplacement!\n        );\n      }\n    },\n  };\n};\n"],"mappings":"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"}

package/dist/types/babel-plugin-intlayer-optimize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"babel-plugin-intlayer-optimize.d.ts","names":[],"sources":["../../src/babel-plugin-intlayer-optimize.ts"],"mappings":";;;;;;;YA8FY;;;;EAIV;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;;;;;;;;;;;;EAeA;;;;EAIA;;;;EAIA,oBAAoB;;;;EAOpB;;;;EAIA;;;;;;;;;;;;;;EAcA,gBAAgB;;;;;;;;;KAUb,QAAQ;EACX,MAAM;;EAEN;;EAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAgTW,8BAA2B;EACtC,cAAc;MACZ,aAAa"}
+{"version":3,"file":"babel-plugin-intlayer-optimize.d.ts","names":[],"sources":["../../src/babel-plugin-intlayer-optimize.ts"],"mappings":";;;;;;;YAiGY;;;;EAIV;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;;;;;;;;;;;;EAeA;;;;EAIA;;;;EAIA,oBAAoB;;;;EAOpB;;;;EAIA;;;;;;;;;;;;;;EAcA,gBAAgB;;;;;;;;;KAUb,QAAQ;EACX,MAAM;;EAEN;;EAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAgTW,8BAA2B;EACtC,cAAc;MACZ,aAAa"}

package/dist/types/compat/optimizePass.d.ts

@@ -28,19 +28,64 @@ export type CompatOptimizePass = {
   noteImport: (importSource: string, importedName: string, localName: string) => void;
   /** Whether `localName` was bound to a compat caller by an import. */
   ownsLocalName: (localName: string) => boolean;
+  /**
+   * Records the names a compat call's result was destructured into
+   * (`const { i18n, _, t } = useLingui()`), so a bare `t('…')` call in the
+   * file is read as a message-id site of that library. Names that are not
+   * message callers of the library are ignored.
+   */
+  noteDestructuredResult: (localCallerName: string, names: string[]) => void;
   /** Whether the file imported any compat caller at all. */
   hasCallers: () => boolean;
   /**
-   * Resolves the namespace of every collected call, dropping the callers that
-   * cannot be rewritten and deciding the file-level helper family. Must run
-   * after every import was noted and before any rewrite.
+   * Whether the file imported a root-scope caller whose dictionaries are
+   * named by message ids (`useLingui()`), so the traversal must also hand
+   * over the id-carrying sites through {@link collectMessageIdSite}. Valid
+   * once every import was noted.
+   */
+  needsMessageIdSites: () => boolean;
+  /**
+   * Records one node that may carry a message id for a root-scope caller: a
+   * call (`i18n._('footer.github')`, `t({ id })`), a tagged template
+   * (``t`…` ``) or a JSX opening element (`<Trans id="…" />`). Nodes that
+   * match no message caller are ignored.
+   */
+  collectMessageIdSite: (node: BabelTypes.CallExpression | BabelTypes.TaggedTemplateExpression | BabelTypes.JSXOpeningElement) => void;
+  /**
+   * Whether the node is an element of a compat JSX caller bound by its id
+   * attribute (`<Trans id="…" />`) imported by the file — as source JSX, or
+   * already compiled by the framework plugin into `jsx(Trans, { id })`.
    */
-  analyzeCalls: (callNodes: readonly BabelTypes.CallExpression[]) => void;
+  ownsJsxSite: (node: JsxSiteNode) => boolean;
+  /**
+   * Resolves the namespace of every collected call and element, dropping the
+   * callers that cannot be rewritten and deciding the file-level helper
+   * family. Must run after every import was noted and every message-id site
+   * collected, and before any rewrite.
+   *
+   * @param countReferences - Number of references a local name has in the
+   * file. A JSX caller is only re-pointed when every reference is a bound
+   * element: one passed around as a value (`component={Trans}`) would reach
+   * the dictionary-accepting replacement without its dictionary.
+   */
+  analyzeCalls: (callNodes: readonly BabelTypes.CallExpression[], jsxSites?: readonly JsxSiteNode[], countReferences?: (localName: string) => number) => void;
   /** Rewrites one compat call site, if its caller survived {@link analyzeCalls}. */
   rewriteCall: (callNode: BabelTypes.CallExpression) => void;
+  /**
+   * Binds one compat JSX element, if its caller survived {@link analyzeCalls}:
+   * adds the `dictionary` prop naming the dictionary its id addresses.
+   */
+  rewriteJsxSite: (node: JsxSiteNode) => void;
   /** Re-points the compat specifiers of one import declaration. */
   rewriteImportSpecifiers: (importNode: BabelTypes.ImportDeclaration) => void;
 };
+/**
+ * A compat JSX element as the pass may meet it: the source element, or the
+ * call the automatic/classic JSX runtime compiled it into — the optimize
+ * transform runs after the framework plugin, so on Vite the compiled form is
+ * the usual one.
+ */
+export type JsxSiteNode = BabelTypes.JSXOpeningElement | BabelTypes.CallExpression;
 /**
  * Builds the compat optimize pass for one source file, or `null` when no
  * compat caller was injected.

package/dist/types/compat/optimizePass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"optimizePass.d.ts","names":[],"sources":["../../../src/compat/optimizePass.ts"],"mappings":";;;;;;;;;;;;;;;;;;;YA2BY;;;;;;EAMV,mBAAmB;;EAEnB,aACE,sBACA,sBACA;;EAGF,gBAAgB;;EAEhB;;;;;;EAMA,eAAe,oBAAoB,WAAW;;EAE9C,cAAc,UAAU,WAAW;;EAEnC,0BAA0B,YAAY,WAAW;;;;;;;;;;;qBA4EtC,2BAAwB,mBAChB,YAAU,wBACL,oBAAkB,SACjC,0BAAwB;EAE/B,YAAY;EACZ,oBAAoB,eAAe;MAEpC"}
+{"version":3,"file":"optimizePass.d.ts","names":[],"sources":["../../../src/compat/optimizePass.ts"],"mappings":";;;;;;;;;;;;;;;;;;;YAoCY;;;;;;EAMV,mBAAmB;;EAEnB,aACE,sBACA,sBACA;;EAGF,gBAAgB;;;;;;;EAOhB,yBAAyB,yBAAyB;;EAElD;;;;;;;EAOA;;;;;;;EAOA,uBACE,MACI,WAAW,iBACX,WAAW,2BACX,WAAW;;;;;;EAOjB,cAAc,MAAM;;;;;;;;;;;;EAYpB,eACE,oBAAoB,WAAW,kBAC/B,oBAAoB,eACpB,mBAAmB;;EAGrB,cAAc,UAAU,WAAW;;;;;EAKnC,iBAAiB,MAAM;;EAEvB,0BAA0B,YAAY,WAAW;;;;;;;;YASvC,cACR,WAAW,oBACX,WAAW;;;;;;;;;;qBAqJF,2BAAwB,mBAChB,YAAU,wBACL,oBAAkB,SACjC,0BAAwB;EAE/B,YAAY;EACZ,oBAAoB,eAAe;MAEpC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/babel",
-  "version": "9.5.1",
+  "version": "9.5.3",
   "private": false,
   "description": "A Babel plugin for Intlayer that transforms declaration files and provides internationalization features during the build process according to the Intlayer configuration.",
   "keywords": [
@@ -89,19 +89,19 @@
     "@babel/plugin-syntax-jsx": "8.0.1",
     "@babel/traverse": "8.0.4",
     "@babel/types": "8.0.4",
-    "@intlayer/config": "9.5.1",
-    "@intlayer/core": "9.5.1",
-    "@intlayer/dictionaries-entry": "9.5.1",
-    "@intlayer/engine": "9.5.1",
-    "@intlayer/types": "9.5.1",
-    "@intlayer/unmerged-dictionaries-entry": "9.5.1"
+    "@intlayer/config": "9.5.3",
+    "@intlayer/core": "9.5.3",
+    "@intlayer/dictionaries-entry": "9.5.3",
+    "@intlayer/engine": "9.5.3",
+    "@intlayer/types": "9.5.3",
+    "@intlayer/unmerged-dictionaries-entry": "9.5.3"
   },
   "devDependencies": {
     "@babel/plugin-syntax-jsx": "8.0.1",
     "@types/babel__core": "7.20.5",
     "@types/babel__generator": "7.27.0",
     "@types/babel__traverse": "7.28.0",
-    "@types/node": "26.5.0",
+    "@types/node": "^22",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",
@@ -112,8 +112,8 @@
     "vitest": "5.0.0"
   },
   "peerDependencies": {
-    "@intlayer/svelte-compiler": "9.5.1",
-    "@intlayer/vue-compiler": "9.5.1"
+    "@intlayer/svelte-compiler": "9.5.3",
+    "@intlayer/vue-compiler": "9.5.3"
   },
   "peerDependenciesMeta": {
     "@intlayer/svelte-compiler": {