@intlayer/babel 8.7.0 → 8.7.1-canary-1

package/dist/cjs/babel-plugin-intlayer-field-rename.cjs

@@ -27,27 +27,35 @@ const generateShortFieldName = (index) => {
 *    inside `translation[locale]`. Recurse into the first locale's value.
 *  - All other intlayer runtime nodes (enumeration, condition, gender, …) are
 *    treated as leaves — their internal keys must never be renamed.
-*  - Plain objects are user-defined records: rename their keys (filtered by
-*    `usedFieldFilter` at the top level) and recurse into each value.
-*  - Primitives and arrays produce an empty map (no further renaming).
+*  - Arrays produce an empty children map.  Array elements are not traversed
+*    because consumers may access them via `.map()` / `.filter()` callbacks,
+*    which the source-code rename walk cannot enter.  Renaming element fields
+*    in the JSON without the matching source-code rename would produce
+*    mismatched key names and runtime crashes.
+*    The `[0]` pass-through in `walkRenameChain` is preserved so that direct
+*    indexed access (`field[0].sub`) silently terminates at the empty children
+*    map without breaking anything.
+*  - Plain objects are user-defined records: ALL non-reserved keys are renamed
+*    with short alphabetic aliases (a, b, c, …) and each value is recursed into.
+*  - Primitives produce an empty map (no further renaming).
 *
-* @param contentValue    - The dictionary content value to analyse.
-* @param usedFieldFilter - When provided, only keys in this set are included
-*                          at the current level (matches the usage-analysis
-*                          results so we don't rename purged fields).
+* The rename map is built from ALL user-defined fields (not just consumed ones).
+* Both the JSON rename and the source-code rename use the same map, so the
+* short names are always consistent regardless of which fields are pruned.
+*
+* @param contentValue - The dictionary content value to analyse.
 */
-const buildNestedRenameMapFromContent = (contentValue, usedFieldFilter) => {
+const buildNestedRenameMapFromContent = (contentValue) => {
 	if (!contentValue || typeof contentValue !== "object" || Array.isArray(contentValue)) return /* @__PURE__ */ new Map();
 	const record = contentValue;
 	if (typeof record.nodeType === "string") {
 		if (record.translation && typeof record.translation === "object" && !Array.isArray(record.translation)) {
 			const firstLocaleValue = Object.values(record.translation)[0];
-			return buildNestedRenameMapFromContent(firstLocaleValue, usedFieldFilter);
+			return buildNestedRenameMapFromContent(firstLocaleValue);
 		}
 		return /* @__PURE__ */ new Map();
 	}
-	const allKeys = Object.keys(record).filter((key) => !RESERVED_CONTENT_FIELD_NAMES.has(key));
-	const sortedKeys = [...usedFieldFilter ? allKeys.filter((key) => usedFieldFilter.has(key)) : allKeys].sort();
+	const sortedKeys = Object.keys(record).filter((key) => !RESERVED_CONTENT_FIELD_NAMES.has(key)).sort();
 	const renameMap = /* @__PURE__ */ new Map();
 	for (let i = 0; i < sortedKeys.length; i++) {
 		const key = sortedKeys[i];
@@ -62,16 +70,26 @@ const buildNestedRenameMapFromContent = (contentValue, usedFieldFilter) => {
 /**
 * Walks a MemberExpression chain starting from `startPath`, renaming each
 * property found in `currentRenameMap` at the corresponding nesting level.
+*
+* Numeric computed accesses (array indices such as `[0]`, `[1]`) are treated
+* as transparent pass-throughs: the rename map is kept unchanged and the walk
+* continues past the index.  This means `content.field[0].sub` is handled
+* correctly — `field` and `sub` are both renamed while `[0]` is left intact.
 */
 const walkRenameChain = (babelTypes, startPath, currentRenameMap) => {
 	let refPath = startPath;
 	let renameMap = currentRenameMap;
-	while (renameMap.size > 0) {
+	while (true) {
 		const parentPath = refPath.parentPath;
 		if (!parentPath) break;
 		const parentNode = parentPath.node;
 		if (!babelTypes.isMemberExpression(parentNode) && !babelTypes.isOptionalMemberExpression(parentNode) || parentNode.object !== refPath.node) break;
 		const memberNode = parentNode;
+		if (memberNode.computed && babelTypes.isNumericLiteral(memberNode.property)) {
+			refPath = parentPath;
+			continue;
+		}
+		if (renameMap.size === 0) break;
 		let fieldName;
 		if (!memberNode.computed && babelTypes.isIdentifier(memberNode.property)) fieldName = memberNode.property.name;
 		else if (memberNode.computed && babelTypes.isStringLiteral(memberNode.property)) fieldName = memberNode.property.value;

package/dist/cjs/babel-plugin-intlayer-field-rename.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"babel-plugin-intlayer-field-rename.cjs","names":["INTLAYER_CALLER_NAMES"],"sources":["../../src/babel-plugin-intlayer-field-rename.ts"],"sourcesContent":["import type { NodePath, PluginObj } from '@babel/core';\nimport type * as BabelTypes from '@babel/types';\nimport {\n  INTLAYER_CALLER_NAMES,\n  type IntlayerCallerName,\n  type NestedRenameMap,\n  type PruneContext,\n} from './babel-plugin-intlayer-usage-analyzer';\n\n// ── Field-name helpers ────────────────────────────────────────────────────────\n\n/**\n * Intlayer internal property names that must never be used as short-name\n * targets. These appear inside content-node values (e.g. `{ nodeType:\n * \"translation\", … }`) and are read by the intlayer runtime.\n */\nconst RESERVED_CONTENT_FIELD_NAMES = new Set(['nodeType']);\n\n/**\n * Converts a zero-based index to a short alphabetic identifier.\n *   0 → 'a', 1 → 'b', …, 25 → 'z', 26 → 'aa', 27 → 'ab', …\n */\nexport const generateShortFieldName = (index: number): string => {\n  const ALPHABET = 'abcdefghijklmnopqrstuvwxyz';\n  const remainder = index % ALPHABET.length;\n  const quotient = Math.floor(index / ALPHABET.length);\n  return quotient === 0\n    ? ALPHABET[remainder]\n    : generateShortFieldName(quotient - 1) + ALPHABET[remainder];\n};\n\n/**\n * Recursively builds a `NestedRenameMap` from a compiled dictionary content\n * value by traversing the intlayer node structure.\n *\n * Rules:\n *  - If the value has `nodeType: 'translation'`, user-defined fields live\n *    inside `translation[locale]`. Recurse into the first locale's value.\n *  - All other intlayer runtime nodes (enumeration, condition, gender, …) are\n *    treated as leaves — their internal keys must never be renamed.\n *  - Plain objects are user-defined records: rename their keys (filtered by\n *    `usedFieldFilter` at the top level) and recurse into each value.\n *  - Primitives and arrays produce an empty map (no further renaming).\n *\n * @param contentValue    - The dictionary content value to analyse.\n * @param usedFieldFilter - When provided, only keys in this set are included\n *                          at the current level (matches the usage-analysis\n *                          results so we don't rename purged fields).\n */\nexport const buildNestedRenameMapFromContent = (\n  contentValue: unknown,\n  usedFieldFilter?: Set<string>\n): NestedRenameMap => {\n  if (\n    !contentValue ||\n    typeof contentValue !== 'object' ||\n    Array.isArray(contentValue)\n  ) {\n    return new Map();\n  }\n\n  const record = contentValue as Record<string, unknown>;\n\n  // Any object with `nodeType: string` is an intlayer runtime node.\n  if (typeof record.nodeType === 'string') {\n    // Translation node: user-defined fields live inside translation[locale].\n    if (\n      record.translation &&\n      typeof record.translation === 'object' &&\n      !Array.isArray(record.translation)\n    ) {\n      const firstLocaleValue = Object.values(\n        record.translation as Record<string, unknown>\n      )[0];\n      return buildNestedRenameMapFromContent(firstLocaleValue, usedFieldFilter);\n    }\n    // All other intlayer nodes have runtime-managed internal structure — return\n    // an empty map so they are treated as leaves.\n    return new Map();\n  }\n\n  // User-defined record: collect non-reserved keys\n  const allKeys = Object.keys(record).filter(\n    (key) => !RESERVED_CONTENT_FIELD_NAMES.has(key)\n  );\n\n  const keysToRename = usedFieldFilter\n    ? allKeys.filter((key) => usedFieldFilter.has(key))\n    : allKeys;\n\n  const sortedKeys = [...keysToRename].sort();\n  const renameMap: NestedRenameMap = new Map();\n\n  for (let i = 0; i < sortedKeys.length; i++) {\n    const key = sortedKeys[i];\n    const children = buildNestedRenameMapFromContent(record[key]); // no filter for nested\n    renameMap.set(key, { shortName: generateShortFieldName(i), children });\n  }\n\n  return renameMap;\n};\n\n// ── Field-rename Babel plugin ─────────────────────────────────────────────────\n\n/**\n * Walks a MemberExpression chain starting from `startPath`, renaming each\n * property found in `currentRenameMap` at the corresponding nesting level.\n */\nconst walkRenameChain = (\n  babelTypes: typeof BabelTypes,\n  startPath: NodePath<BabelTypes.Node>,\n  currentRenameMap: NestedRenameMap\n): void => {\n  let refPath: NodePath<BabelTypes.Node> = startPath;\n  let renameMap = currentRenameMap;\n\n  while (renameMap.size > 0) {\n    const parentPath = refPath.parentPath;\n    if (!parentPath) break;\n\n    const parentNode = parentPath.node;\n\n    if (\n      (!babelTypes.isMemberExpression(parentNode) &&\n        !babelTypes.isOptionalMemberExpression(parentNode)) ||\n      (parentNode as BabelTypes.MemberExpression).object !== refPath.node\n    ) {\n      break;\n    }\n\n    const memberNode = parentNode as BabelTypes.MemberExpression;\n    let fieldName: string | undefined;\n\n    if (!memberNode.computed && babelTypes.isIdentifier(memberNode.property)) {\n      fieldName = memberNode.property.name;\n    } else if (\n      memberNode.computed &&\n      babelTypes.isStringLiteral(memberNode.property)\n    ) {\n      fieldName = memberNode.property.value;\n    } else {\n      break; // dynamic key – stop\n    }\n\n    const renameEntry = renameMap.get(fieldName);\n    if (!renameEntry) break; // not in map – stop\n\n    // Apply the rename\n    if (!memberNode.computed && babelTypes.isIdentifier(memberNode.property)) {\n      memberNode.property.name = renameEntry.shortName;\n    } else if (\n      memberNode.computed &&\n      babelTypes.isStringLiteral(memberNode.property)\n    ) {\n      memberNode.property.value = renameEntry.shortName;\n    }\n\n    refPath = parentPath;\n    renameMap = renameEntry.children;\n  }\n};\n\n/**\n * Creates a Babel plugin that rewrites dictionary content field accesses in\n * source files to their short aliases defined in\n * `pruneContext.dictionaryKeyToFieldRenameMap`.\n *\n * Handled patterns (mirrors the usage analyser):\n *\n *   const { fieldA, fieldB } = useIntlayer('key')\n *     → const { shortA: fieldA, shortB: fieldB } = useIntlayer('key')\n *\n *   useIntlayer('key').fieldA\n *     → useIntlayer('key').shortA\n *\n *   const result = useIntlayer('key');  result.fieldA\n *     → const result = useIntlayer('key');  result.shortA\n *\n * This plugin must run in a separate `transformAsync` pass **before**\n * `intlayerOptimizeBabelPlugin`, because the latter replaces `useIntlayer`\n * with `useDictionary`, erasing the dictionary-key information needed here.\n */\nexport const makeFieldRenameBabelPlugin =\n  (pruneContext: PruneContext) =>\n  ({ types: babelTypes }: { types: typeof BabelTypes }): PluginObj => ({\n    name: 'intlayer-field-rename',\n    visitor: {\n      Program: {\n        exit: (programPath) => {\n          if (pruneContext.dictionaryKeyToFieldRenameMap.size === 0) return;\n\n          // Collect local aliases for useIntlayer / getIntlayer\n          const intlayerCallerLocalNameMap = new Map<string, string>();\n\n          programPath.traverse({\n            ImportDeclaration: (importDeclarationPath) => {\n              for (const importSpecifier of importDeclarationPath.node\n                .specifiers) {\n                if (!babelTypes.isImportSpecifier(importSpecifier)) continue;\n\n                const importedName = babelTypes.isIdentifier(\n                  importSpecifier.imported\n                )\n                  ? importSpecifier.imported.name\n                  : (importSpecifier.imported as BabelTypes.StringLiteral)\n                      .value;\n\n                if (\n                  INTLAYER_CALLER_NAMES.includes(\n                    importedName as IntlayerCallerName\n                  )\n                ) {\n                  intlayerCallerLocalNameMap.set(\n                    importSpecifier.local.name,\n                    importedName\n                  );\n                }\n              }\n            },\n          });\n\n          if (intlayerCallerLocalNameMap.size === 0) return;\n\n          // Visit all useIntlayer / getIntlayer call-sites and rename field accesses\n          programPath.traverse({\n            CallExpression: (callExpressionPath) => {\n              const calleeNode = callExpressionPath.node.callee;\n              let localCallerName: string | undefined;\n\n              if (babelTypes.isIdentifier(calleeNode)) {\n                localCallerName = calleeNode.name;\n              } else if (\n                babelTypes.isMemberExpression(calleeNode) &&\n                babelTypes.isIdentifier(calleeNode.property)\n              ) {\n                localCallerName = calleeNode.property.name;\n              }\n\n              if (\n                !localCallerName ||\n                !intlayerCallerLocalNameMap.has(localCallerName)\n              )\n                return;\n\n              const callArguments = callExpressionPath.node.arguments;\n              if (callArguments.length === 0) return;\n\n              const firstArgument = callArguments[0];\n              let dictionaryKey: string | undefined;\n\n              if (babelTypes.isStringLiteral(firstArgument)) {\n                dictionaryKey = firstArgument.value;\n              } else if (\n                babelTypes.isTemplateLiteral(firstArgument) &&\n                firstArgument.expressions.length === 0 &&\n                firstArgument.quasis.length === 1\n              ) {\n                dictionaryKey =\n                  firstArgument.quasis[0].value.cooked ??\n                  firstArgument.quasis[0].value.raw;\n              }\n\n              if (!dictionaryKey) return;\n\n              const fieldRenameMap =\n                pruneContext.dictionaryKeyToFieldRenameMap.get(dictionaryKey);\n              if (!fieldRenameMap || fieldRenameMap.size === 0) return;\n\n              const parentNode = callExpressionPath.parent;\n\n              // ── Case 1: const { fieldA, fieldB } = useIntlayer('key') ────────\n              if (\n                babelTypes.isVariableDeclarator(parentNode) &&\n                babelTypes.isObjectPattern(parentNode.id)\n              ) {\n                for (const property of parentNode.id.properties) {\n                  if (!babelTypes.isObjectProperty(property)) continue;\n\n                  const keyName = babelTypes.isIdentifier(property.key)\n                    ? property.key.name\n                    : babelTypes.isStringLiteral(property.key)\n                      ? property.key.value\n                      : null;\n                  if (!keyName) continue;\n\n                  const renameEntry = fieldRenameMap.get(keyName);\n                  if (!renameEntry) continue;\n\n                  // { fieldA } → { shortA: fieldA }\n                  // { fieldA: localVar } → { shortA: localVar }\n                  if (property.shorthand) {\n                    property.shorthand = false;\n                    property.key = babelTypes.identifier(renameEntry.shortName);\n                  } else {\n                    property.key = babelTypes.identifier(renameEntry.shortName);\n                  }\n\n                  // Walk nested member accesses on the local variable\n                  if (\n                    renameEntry.children.size > 0 &&\n                    babelTypes.isIdentifier(property.value)\n                  ) {\n                    const localVarBinding = callExpressionPath.scope.getBinding(\n                      (property.value as BabelTypes.Identifier).name\n                    );\n                    if (localVarBinding) {\n                      for (const refPath of localVarBinding.referencePaths) {\n                        walkRenameChain(\n                          babelTypes,\n                          refPath,\n                          renameEntry.children\n                        );\n                      }\n                    }\n                  }\n                }\n                return;\n              }\n\n              // ── Case 2: useIntlayer('key').fieldA.nested ─────────────────────\n              if (\n                (babelTypes.isMemberExpression(parentNode) ||\n                  babelTypes.isOptionalMemberExpression(parentNode)) &&\n                (parentNode as BabelTypes.MemberExpression).object ===\n                  callExpressionPath.node\n              ) {\n                walkRenameChain(babelTypes, callExpressionPath, fieldRenameMap);\n                return;\n              }\n\n              // ── Case 3: const result = useIntlayer('key'); result.fieldA ─────\n              if (\n                babelTypes.isVariableDeclarator(parentNode) &&\n                babelTypes.isIdentifier(parentNode.id)\n              ) {\n                const variableName = parentNode.id.name;\n                const variableBinding =\n                  callExpressionPath.scope.getBinding(variableName);\n                if (!variableBinding) return;\n\n                for (const variableReferencePath of variableBinding.referencePaths) {\n                  walkRenameChain(\n                    babelTypes,\n                    variableReferencePath,\n                    fieldRenameMap\n                  );\n                }\n              }\n            },\n          });\n        },\n      },\n    },\n  });\n"],"mappings":"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"}
+{"version":3,"file":"babel-plugin-intlayer-field-rename.cjs","names":["INTLAYER_CALLER_NAMES"],"sources":["../../src/babel-plugin-intlayer-field-rename.ts"],"sourcesContent":["import type { NodePath, PluginObj } from '@babel/core';\nimport type * as BabelTypes from '@babel/types';\nimport {\n  INTLAYER_CALLER_NAMES,\n  type IntlayerCallerName,\n  type NestedRenameMap,\n  type PruneContext,\n} from './babel-plugin-intlayer-usage-analyzer';\n\n// ── Field-name helpers ────────────────────────────────────────────────────────\n\n/**\n * Intlayer internal property names that must never be used as short-name\n * targets. These appear inside content-node values (e.g. `{ nodeType:\n * \"translation\", … }`) and are read by the intlayer runtime.\n */\nconst RESERVED_CONTENT_FIELD_NAMES = new Set(['nodeType']);\n\n/**\n * Converts a zero-based index to a short alphabetic identifier.\n *   0 → 'a', 1 → 'b', …, 25 → 'z', 26 → 'aa', 27 → 'ab', …\n */\nexport const generateShortFieldName = (index: number): string => {\n  const ALPHABET = 'abcdefghijklmnopqrstuvwxyz';\n  const remainder = index % ALPHABET.length;\n  const quotient = Math.floor(index / ALPHABET.length);\n  return quotient === 0\n    ? ALPHABET[remainder]\n    : generateShortFieldName(quotient - 1) + ALPHABET[remainder];\n};\n\n/**\n * Recursively builds a `NestedRenameMap` from a compiled dictionary content\n * value by traversing the intlayer node structure.\n *\n * Rules:\n *  - If the value has `nodeType: 'translation'`, user-defined fields live\n *    inside `translation[locale]`. Recurse into the first locale's value.\n *  - All other intlayer runtime nodes (enumeration, condition, gender, …) are\n *    treated as leaves — their internal keys must never be renamed.\n *  - Arrays produce an empty children map.  Array elements are not traversed\n *    because consumers may access them via `.map()` / `.filter()` callbacks,\n *    which the source-code rename walk cannot enter.  Renaming element fields\n *    in the JSON without the matching source-code rename would produce\n *    mismatched key names and runtime crashes.\n *    The `[0]` pass-through in `walkRenameChain` is preserved so that direct\n *    indexed access (`field[0].sub`) silently terminates at the empty children\n *    map without breaking anything.\n *  - Plain objects are user-defined records: ALL non-reserved keys are renamed\n *    with short alphabetic aliases (a, b, c, …) and each value is recursed into.\n *  - Primitives produce an empty map (no further renaming).\n *\n * The rename map is built from ALL user-defined fields (not just consumed ones).\n * Both the JSON rename and the source-code rename use the same map, so the\n * short names are always consistent regardless of which fields are pruned.\n *\n * @param contentValue - The dictionary content value to analyse.\n */\nexport const buildNestedRenameMapFromContent = (\n  contentValue: unknown\n): NestedRenameMap => {\n  if (\n    !contentValue ||\n    typeof contentValue !== 'object' ||\n    Array.isArray(contentValue)\n  ) {\n    return new Map();\n  }\n\n  const record = contentValue as Record<string, unknown>;\n\n  // Any object with `nodeType: string` is an intlayer runtime node.\n  if (typeof record.nodeType === 'string') {\n    // Translation node: user-defined fields live inside translation[locale].\n    if (\n      record.translation &&\n      typeof record.translation === 'object' &&\n      !Array.isArray(record.translation)\n    ) {\n      const firstLocaleValue = Object.values(\n        record.translation as Record<string, unknown>\n      )[0];\n      return buildNestedRenameMapFromContent(firstLocaleValue);\n    }\n    // All other intlayer nodes have runtime-managed internal structure — return\n    // an empty map so they are treated as leaves.\n    return new Map();\n  }\n\n  // User-defined record: rename ALL non-reserved keys with stable alphabetic\n  // aliases sorted alphabetically so the mapping is deterministic.\n  const sortedKeys = Object.keys(record)\n    .filter((key) => !RESERVED_CONTENT_FIELD_NAMES.has(key))\n    .sort();\n\n  const renameMap: NestedRenameMap = new Map();\n\n  for (let i = 0; i < sortedKeys.length; i++) {\n    const key = sortedKeys[i];\n    const children = buildNestedRenameMapFromContent(record[key]);\n    renameMap.set(key, { shortName: generateShortFieldName(i), children });\n  }\n\n  return renameMap;\n};\n\n// ── Field-rename Babel plugin ─────────────────────────────────────────────────\n\n/**\n * Walks a MemberExpression chain starting from `startPath`, renaming each\n * property found in `currentRenameMap` at the corresponding nesting level.\n *\n * Numeric computed accesses (array indices such as `[0]`, `[1]`) are treated\n * as transparent pass-throughs: the rename map is kept unchanged and the walk\n * continues past the index.  This means `content.field[0].sub` is handled\n * correctly — `field` and `sub` are both renamed while `[0]` is left intact.\n */\nconst walkRenameChain = (\n  babelTypes: typeof BabelTypes,\n  startPath: NodePath<BabelTypes.Node>,\n  currentRenameMap: NestedRenameMap\n): void => {\n  let refPath: NodePath<BabelTypes.Node> = startPath;\n  let renameMap = currentRenameMap;\n\n  // eslint-disable-next-line no-constant-condition\n  while (true) {\n    const parentPath = refPath.parentPath;\n    if (!parentPath) break;\n\n    const parentNode = parentPath.node;\n\n    if (\n      (!babelTypes.isMemberExpression(parentNode) &&\n        !babelTypes.isOptionalMemberExpression(parentNode)) ||\n      (parentNode as BabelTypes.MemberExpression).object !== refPath.node\n    ) {\n      break;\n    }\n\n    const memberNode = parentNode as BabelTypes.MemberExpression;\n\n    // Numeric index access ([0], [1], …): advance past the array accessor\n    // without touching the rename map.  The next iteration will attempt to\n    // rename the property that follows the index.\n    if (\n      memberNode.computed &&\n      babelTypes.isNumericLiteral(memberNode.property)\n    ) {\n      refPath = parentPath;\n      continue;\n    }\n\n    // Nothing left to rename at this level — stop.\n    if (renameMap.size === 0) break;\n\n    let fieldName: string | undefined;\n\n    if (!memberNode.computed && babelTypes.isIdentifier(memberNode.property)) {\n      fieldName = memberNode.property.name;\n    } else if (\n      memberNode.computed &&\n      babelTypes.isStringLiteral(memberNode.property)\n    ) {\n      fieldName = memberNode.property.value;\n    } else {\n      break; // dynamic computed key – stop\n    }\n\n    const renameEntry = renameMap.get(fieldName);\n    if (!renameEntry) break; // not in map – stop\n\n    // Apply the rename\n    if (!memberNode.computed && babelTypes.isIdentifier(memberNode.property)) {\n      memberNode.property.name = renameEntry.shortName;\n    } else if (\n      memberNode.computed &&\n      babelTypes.isStringLiteral(memberNode.property)\n    ) {\n      memberNode.property.value = renameEntry.shortName;\n    }\n\n    refPath = parentPath;\n    renameMap = renameEntry.children;\n  }\n};\n\n/**\n * Creates a Babel plugin that rewrites dictionary content field accesses in\n * source files to their short aliases defined in\n * `pruneContext.dictionaryKeyToFieldRenameMap`.\n *\n * Handled patterns (mirrors the usage analyser):\n *\n *   const { fieldA, fieldB } = useIntlayer('key')\n *     → const { shortA: fieldA, shortB: fieldB } = useIntlayer('key')\n *\n *   useIntlayer('key').fieldA\n *     → useIntlayer('key').shortA\n *\n *   const result = useIntlayer('key');  result.fieldA\n *     → const result = useIntlayer('key');  result.shortA\n *\n * This plugin must run in a separate `transformAsync` pass **before**\n * `intlayerOptimizeBabelPlugin`, because the latter replaces `useIntlayer`\n * with `useDictionary`, erasing the dictionary-key information needed here.\n */\nexport const makeFieldRenameBabelPlugin =\n  (pruneContext: PruneContext) =>\n  ({ types: babelTypes }: { types: typeof BabelTypes }): PluginObj => ({\n    name: 'intlayer-field-rename',\n    visitor: {\n      Program: {\n        exit: (programPath) => {\n          if (pruneContext.dictionaryKeyToFieldRenameMap.size === 0) return;\n\n          // Collect local aliases for useIntlayer / getIntlayer\n          const intlayerCallerLocalNameMap = new Map<string, string>();\n\n          programPath.traverse({\n            ImportDeclaration: (importDeclarationPath) => {\n              for (const importSpecifier of importDeclarationPath.node\n                .specifiers) {\n                if (!babelTypes.isImportSpecifier(importSpecifier)) continue;\n\n                const importedName = babelTypes.isIdentifier(\n                  importSpecifier.imported\n                )\n                  ? importSpecifier.imported.name\n                  : (importSpecifier.imported as BabelTypes.StringLiteral)\n                      .value;\n\n                if (\n                  INTLAYER_CALLER_NAMES.includes(\n                    importedName as IntlayerCallerName\n                  )\n                ) {\n                  intlayerCallerLocalNameMap.set(\n                    importSpecifier.local.name,\n                    importedName\n                  );\n                }\n              }\n            },\n          });\n\n          if (intlayerCallerLocalNameMap.size === 0) return;\n\n          // Visit all useIntlayer / getIntlayer call-sites and rename field accesses\n          programPath.traverse({\n            CallExpression: (callExpressionPath) => {\n              const calleeNode = callExpressionPath.node.callee;\n              let localCallerName: string | undefined;\n\n              if (babelTypes.isIdentifier(calleeNode)) {\n                localCallerName = calleeNode.name;\n              } else if (\n                babelTypes.isMemberExpression(calleeNode) &&\n                babelTypes.isIdentifier(calleeNode.property)\n              ) {\n                localCallerName = calleeNode.property.name;\n              }\n\n              if (\n                !localCallerName ||\n                !intlayerCallerLocalNameMap.has(localCallerName)\n              )\n                return;\n\n              const callArguments = callExpressionPath.node.arguments;\n              if (callArguments.length === 0) return;\n\n              const firstArgument = callArguments[0];\n              let dictionaryKey: string | undefined;\n\n              if (babelTypes.isStringLiteral(firstArgument)) {\n                dictionaryKey = firstArgument.value;\n              } else if (\n                babelTypes.isTemplateLiteral(firstArgument) &&\n                firstArgument.expressions.length === 0 &&\n                firstArgument.quasis.length === 1\n              ) {\n                dictionaryKey =\n                  firstArgument.quasis[0].value.cooked ??\n                  firstArgument.quasis[0].value.raw;\n              }\n\n              if (!dictionaryKey) return;\n\n              const fieldRenameMap =\n                pruneContext.dictionaryKeyToFieldRenameMap.get(dictionaryKey);\n              if (!fieldRenameMap || fieldRenameMap.size === 0) return;\n\n              const parentNode = callExpressionPath.parent;\n\n              // ── Case 1: const { fieldA, fieldB } = useIntlayer('key') ────────\n              if (\n                babelTypes.isVariableDeclarator(parentNode) &&\n                babelTypes.isObjectPattern(parentNode.id)\n              ) {\n                for (const property of parentNode.id.properties) {\n                  if (!babelTypes.isObjectProperty(property)) continue;\n\n                  const keyName = babelTypes.isIdentifier(property.key)\n                    ? property.key.name\n                    : babelTypes.isStringLiteral(property.key)\n                      ? property.key.value\n                      : null;\n                  if (!keyName) continue;\n\n                  const renameEntry = fieldRenameMap.get(keyName);\n                  if (!renameEntry) continue;\n\n                  // { fieldA } → { shortA: fieldA }\n                  // { fieldA: localVar } → { shortA: localVar }\n                  if (property.shorthand) {\n                    property.shorthand = false;\n                    property.key = babelTypes.identifier(renameEntry.shortName);\n                  } else {\n                    property.key = babelTypes.identifier(renameEntry.shortName);\n                  }\n\n                  // Walk nested member accesses on the local variable\n                  if (\n                    renameEntry.children.size > 0 &&\n                    babelTypes.isIdentifier(property.value)\n                  ) {\n                    const localVarBinding = callExpressionPath.scope.getBinding(\n                      (property.value as BabelTypes.Identifier).name\n                    );\n                    if (localVarBinding) {\n                      for (const refPath of localVarBinding.referencePaths) {\n                        walkRenameChain(\n                          babelTypes,\n                          refPath,\n                          renameEntry.children\n                        );\n                      }\n                    }\n                  }\n                }\n                return;\n              }\n\n              // ── Case 2: useIntlayer('key').fieldA.nested ─────────────────────\n              if (\n                (babelTypes.isMemberExpression(parentNode) ||\n                  babelTypes.isOptionalMemberExpression(parentNode)) &&\n                (parentNode as BabelTypes.MemberExpression).object ===\n                  callExpressionPath.node\n              ) {\n                walkRenameChain(babelTypes, callExpressionPath, fieldRenameMap);\n                return;\n              }\n\n              // ── Case 3: const result = useIntlayer('key'); result.fieldA ─────\n              if (\n                babelTypes.isVariableDeclarator(parentNode) &&\n                babelTypes.isIdentifier(parentNode.id)\n              ) {\n                const variableName = parentNode.id.name;\n                const variableBinding =\n                  callExpressionPath.scope.getBinding(variableName);\n                if (!variableBinding) return;\n\n                for (const variableReferencePath of variableBinding.referencePaths) {\n                  walkRenameChain(\n                    babelTypes,\n                    variableReferencePath,\n                    fieldRenameMap\n                  );\n                }\n              }\n            },\n          });\n        },\n      },\n    },\n  });\n"],"mappings":"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"}

package/dist/cjs/extractContent/utils/generateKey.cjs

@@ -2,7 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 //#region src/extractContent/utils/generateKey.ts
 const generateKey = (text, existingKeys) => {
-	let key = text.normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[\s_-]+/g, " ").replace(/[^\p{L}\p{N} ]/gu, "").trim().split(" ").filter(Boolean).slice(0, 5).map((word, index) => index === 0 ? word.toLowerCase() : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
+	const maxWords = 5;
+	const maxWordLength = 20;
+	const maxKeyLength = 40;
+	let key = text.normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[\s_-]+/g, " ").replace(/[^\p{L}\p{N} ]/gu, "").trim().split(" ").filter(Boolean).slice(0, maxWords).map((word) => word.length > maxWordLength ? word.substring(0, maxWordLength) : word).map((word, index) => index === 0 ? word.toLowerCase() : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
+	if (key.length > maxKeyLength) key = key.substring(0, maxKeyLength);
 	if (!key) key = "content";
 	if (/^[0-9]/.test(key)) key = `x${key}`;
 	if (existingKeys.has(key)) {

package/dist/cjs/extractContent/utils/generateKey.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"generateKey.cjs","names":[],"sources":["../../../../src/extractContent/utils/generateKey.ts"],"sourcesContent":["export const generateKey = (\n  text: string,\n  existingKeys: Set<string>\n): string => {\n  const maxWords = 5;\n  let key = text\n    .normalize('NFD') // Normalize to decomposes combined characters (e.g., é -> e + ´)\n    .replace(/[\\u0300-\\u036f]/g, '') // Remove the accent characters\n    .replace(/[\\s_-]+/g, ' ')\n    .replace(/[^\\p{L}\\p{N} ]/gu, '')\n    .trim()\n    .split(' ')\n    .filter(Boolean)\n    .slice(0, maxWords)\n    .map((word, index) =>\n      index === 0\n        ? word.toLowerCase()\n        : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()\n    )\n    .join('');\n\n  if (!key) key = 'content';\n\n  // If the key starts with a number, prepend 'x' to make it a valid JS identifier\n  if (/^[0-9]/.test(key)) {\n    key = `x${key}`;\n  }\n\n  if (existingKeys.has(key)) {\n    let i = 1;\n    while (existingKeys.has(`${key}${i}`)) i++;\n    key = `${key}${i}`;\n  }\n  return key;\n};\n"],"mappings":";;;AAAA,MAAa,eACX,MACA,iBACW;CAEX,IAAI,MAAM,KACP,UAAU,MAAM,CAChB,QAAQ,oBAAoB,GAAG,CAC/B,QAAQ,YAAY,IAAI,CACxB,QAAQ,oBAAoB,GAAG,CAC/B,MAAM,CACN,MAAM,IAAI,CACV,OAAO,QAAQ,CACf,MAAM,GATQ,EASI,CAClB,KAAK,MAAM,UACV,UAAU,IACN,KAAK,aAAa,GAClB,KAAK,OAAO,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE,CAAC,aAAa,CAC/D,CACA,KAAK,GAAG;AAEX,KAAI,CAAC,IAAK,OAAM;AAGhB,KAAI,SAAS,KAAK,IAAI,CACpB,OAAM,IAAI;AAGZ,KAAI,aAAa,IAAI,IAAI,EAAE;EACzB,IAAI,IAAI;AACR,SAAO,aAAa,IAAI,GAAG,MAAM,IAAI,CAAE;AACvC,QAAM,GAAG,MAAM;;AAEjB,QAAO"}
+{"version":3,"file":"generateKey.cjs","names":[],"sources":["../../../../src/extractContent/utils/generateKey.ts"],"sourcesContent":["export const generateKey = (\n  text: string,\n  existingKeys: Set<string>\n): string => {\n  const maxWords = 5;\n  const maxWordLength = 20;\n  const maxKeyLength = 40;\n\n  let key = text\n    .normalize('NFD') // Normalize to decomposes combined characters (e.g., é -> e + ´)\n    .replace(/[\\u0300-\\u036f]/g, '') // Remove the accent characters\n    .replace(/[\\s_-]+/g, ' ')\n    .replace(/[^\\p{L}\\p{N} ]/gu, '')\n    .trim()\n    .split(' ')\n    .filter(Boolean)\n    .slice(0, maxWords)\n    .map((word) =>\n      word.length > maxWordLength ? word.substring(0, maxWordLength) : word\n    )\n    .map((word, index) =>\n      index === 0\n        ? word.toLowerCase()\n        : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()\n    )\n    .join('');\n\n  if (key.length > maxKeyLength) {\n    key = key.substring(0, maxKeyLength);\n  }\n\n  if (!key) key = 'content';\n\n  // If the key starts with a number, prepend 'x' to make it a valid JS identifier\n  if (/^[0-9]/.test(key)) {\n    key = `x${key}`;\n  }\n\n  if (existingKeys.has(key)) {\n    let i = 1;\n    while (existingKeys.has(`${key}${i}`)) i++;\n    key = `${key}${i}`;\n  }\n  return key;\n};\n"],"mappings":";;;AAAA,MAAa,eACX,MACA,iBACW;CACX,MAAM,WAAW;CACjB,MAAM,gBAAgB;CACtB,MAAM,eAAe;CAErB,IAAI,MAAM,KACP,UAAU,MAAM,CAChB,QAAQ,oBAAoB,GAAG,CAC/B,QAAQ,YAAY,IAAI,CACxB,QAAQ,oBAAoB,GAAG,CAC/B,MAAM,CACN,MAAM,IAAI,CACV,OAAO,QAAQ,CACf,MAAM,GAAG,SAAS,CAClB,KAAK,SACJ,KAAK,SAAS,gBAAgB,KAAK,UAAU,GAAG,cAAc,GAAG,KAClE,CACA,KAAK,MAAM,UACV,UAAU,IACN,KAAK,aAAa,GAClB,KAAK,OAAO,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE,CAAC,aAAa,CAC/D,CACA,KAAK,GAAG;AAEX,KAAI,IAAI,SAAS,aACf,OAAM,IAAI,UAAU,GAAG,aAAa;AAGtC,KAAI,CAAC,IAAK,OAAM;AAGhB,KAAI,SAAS,KAAK,IAAI,CACpB,OAAM,IAAI;AAGZ,KAAI,aAAa,IAAI,IAAI,EAAE;EACzB,IAAI,IAAI;AACR,SAAO,aAAa,IAAI,GAAG,MAAM,IAAI,CAAE;AACvC,QAAM,GAAG,MAAM;;AAEjB,QAAO"}

package/dist/cjs/extractContent/utils/shouldExtract.cjs

@@ -15,10 +15,12 @@ const shouldExtract = (text) => {
 	if (!trimmed) return false;
 	if (/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(trimmed)) return false;
 	if (trimmed.startsWith("{") || trimmed.startsWith("v-")) return false;
+	if (trimmed.includes("=>") || trimmed.includes(");") || trimmed.includes("(){") || trimmed.includes("==") || trimmed.includes("window.") || trimmed.startsWith("(function") || trimmed.startsWith("function(")) return false;
+	if ((trimmed.match(/[^\p{L}\p{N}\s.,!?;:'"()[\]{}–—/«»„“\p{Sc}%&*+#@^_+=<>/~]/gu) || []).length > 5) return false;
 	const wordCount = trimmed.split(/\s+/).length;
-	const isCapitalized = /^[A-Z]/.test(trimmed);
+	const isCapitalized = /^['"([]*\p{Lu}/u.test(trimmed);
 	if (wordCount === 1) {
-		if (/[a-z][A-Z]/.test(trimmed)) return false;
+		if (/[a-z]\p{Lu}/u.test(trimmed)) return false;
 		if (trimmed.includes("-") || trimmed.includes("_")) return false;
 	}
 	if (!isCapitalized && wordCount <= 2) return false;

package/dist/cjs/extractContent/utils/shouldExtract.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"shouldExtract.cjs","names":[],"sources":["../../../../src/extractContent/utils/shouldExtract.ts"],"sourcesContent":["/**\n * Checks whether the given text should be extracted as a translatable string.\n *\n * Filters out:\n * - Empty strings\n * - Emails\n * - Uncapitalized strings of 2 words or fewer (likely technical terms)\n * - Dynamic content patterns like Vue bindings (`v-`) or object patterns (`{`)\n */\nexport const shouldExtract = (text: string): boolean => {\n  const trimmed = text.trim();\n\n  if (!trimmed) return false;\n\n  // Ignore emails\n  if (/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(trimmed)) return false;\n\n  // Ignore dynamic content patterns\n  if (trimmed.startsWith('{') || trimmed.startsWith('v-')) return false;\n\n  const wordCount = trimmed.split(/\\s+/).length;\n  const isCapitalized = /^[A-Z]/.test(trimmed);\n\n  // Ignore technical identifiers (one word strings with camelCase, kebab-case, snake_case etc.)\n  if (wordCount === 1) {\n    // CamelCase or internal capitals (like camelCaseProperty or CamelCaseProperty)\n    if (/[a-z][A-Z]/.test(trimmed)) return false;\n    // kebab-case or snake_case\n    if (trimmed.includes('-') || trimmed.includes('_')) return false;\n  }\n\n  // We usually want to extract full sentences or labels, not single/short technical words.\n  // Extract if capitalized, or if it contains more than 2 words.\n  if (!isCapitalized && wordCount <= 2) return false;\n\n  return true;\n};\n"],"mappings":";;;;;;;;;;;;AASA,MAAa,iBAAiB,SAA0B;CACtD,MAAM,UAAU,KAAK,MAAM;AAE3B,KAAI,CAAC,QAAS,QAAO;AAGrB,KAAI,6BAA6B,KAAK,QAAQ,CAAE,QAAO;AAGvD,KAAI,QAAQ,WAAW,IAAI,IAAI,QAAQ,WAAW,KAAK,CAAE,QAAO;CAEhE,MAAM,YAAY,QAAQ,MAAM,MAAM,CAAC;CACvC,MAAM,gBAAgB,SAAS,KAAK,QAAQ;AAG5C,KAAI,cAAc,GAAG;AAEnB,MAAI,aAAa,KAAK,QAAQ,CAAE,QAAO;AAEvC,MAAI,QAAQ,SAAS,IAAI,IAAI,QAAQ,SAAS,IAAI,CAAE,QAAO;;AAK7D,KAAI,CAAC,iBAAiB,aAAa,EAAG,QAAO;AAE7C,QAAO"}
+{"version":3,"file":"shouldExtract.cjs","names":[],"sources":["../../../../src/extractContent/utils/shouldExtract.ts"],"sourcesContent":["/**\n * Checks whether the given text should be extracted as a translatable string.\n *\n * Filters out:\n * - Empty strings\n * - Emails\n * - Uncapitalized strings of 2 words or fewer (likely technical terms)\n * - Dynamic content patterns like Vue bindings (`v-`) or object patterns (`{`)\n */\nexport const shouldExtract = (text: string): boolean => {\n  const trimmed = text.trim();\n\n  if (!trimmed) return false;\n\n  // Ignore emails\n  if (/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(trimmed)) return false;\n\n  // Ignore dynamic content patterns\n  if (trimmed.startsWith('{') || trimmed.startsWith('v-')) return false;\n\n  // Ignore explicit code patterns (markers)\n  if (\n    trimmed.includes('=>') ||\n    trimmed.includes(');') ||\n    trimmed.includes('(){') ||\n    trimmed.includes('==') ||\n    trimmed.includes('window.') ||\n    trimmed.startsWith('(function') ||\n    trimmed.startsWith('function(')\n  ) {\n    return false;\n  }\n\n  // Heuristic: check for characters that are common in code but rare in natural text.\n  // Whitelist: letters, numbers, spaces, and frequent text symbols (including punctuation, braces, and technical symbols)\n  const nonTextualRegex =\n    /[^\\p{L}\\p{N}\\s.,!?;:'\"()[\\]{}–—/«»„“\\p{Sc}%&*+#@^_+=<>/~]/gu;\n  const nonTextualMatches = trimmed.match(nonTextualRegex) || [];\n\n  // If a string contains a high density of truly exceptional symbols (like |, \\, etc.),\n  // it is highly likely to be code or complex technical data.\n  if (nonTextualMatches.length > 5) return false;\n\n  const wordCount = trimmed.split(/\\s+/).length;\n\n  // Check if starts with a capital letter (including after an opening parenthesis/quote)\n  const isCapitalized = /^['\"([]*\\p{Lu}/u.test(trimmed);\n\n  // Ignore technical identifiers (one word strings with camelCase, kebab-case, snake_case etc.)\n  if (wordCount === 1) {\n    // CamelCase or internal capitals (like camelCaseProperty or CamelCaseProperty)\n    if (/[a-z]\\p{Lu}/u.test(trimmed)) return false;\n    // kebab-case or snake_case\n    if (trimmed.includes('-') || trimmed.includes('_')) return false;\n  }\n\n  // We usually want to extract full sentences or labels, not single/short technical words.\n  // Extract if capitalized, or if it contains more than 2 words.\n  if (!isCapitalized && wordCount <= 2) return false;\n\n  return true;\n};\n"],"mappings":";;;;;;;;;;;;AASA,MAAa,iBAAiB,SAA0B;CACtD,MAAM,UAAU,KAAK,MAAM;AAE3B,KAAI,CAAC,QAAS,QAAO;AAGrB,KAAI,6BAA6B,KAAK,QAAQ,CAAE,QAAO;AAGvD,KAAI,QAAQ,WAAW,IAAI,IAAI,QAAQ,WAAW,KAAK,CAAE,QAAO;AAGhE,KACE,QAAQ,SAAS,KAAK,IACtB,QAAQ,SAAS,KAAK,IACtB,QAAQ,SAAS,MAAM,IACvB,QAAQ,SAAS,KAAK,IACtB,QAAQ,SAAS,UAAU,IAC3B,QAAQ,WAAW,YAAY,IAC/B,QAAQ,WAAW,YAAY,CAE/B,QAAO;AAWT,MAJ0B,QAAQ,MADhC,8DACsD,IAAI,EAAE,EAIxC,SAAS,EAAG,QAAO;CAEzC,MAAM,YAAY,QAAQ,MAAM,MAAM,CAAC;CAGvC,MAAM,gBAAgB,kBAAkB,KAAK,QAAQ;AAGrD,KAAI,cAAc,GAAG;AAEnB,MAAI,eAAe,KAAK,QAAQ,CAAE,QAAO;AAEzC,MAAI,QAAQ,SAAS,IAAI,IAAI,QAAQ,SAAS,IAAI,CAAE,QAAO;;AAK7D,KAAI,CAAC,iBAAiB,aAAa,EAAG,QAAO;AAE7C,QAAO"}

package/dist/esm/babel-plugin-intlayer-field-rename.mjs

@@ -26,27 +26,35 @@ const generateShortFieldName = (index) => {
 *    inside `translation[locale]`. Recurse into the first locale's value.
 *  - All other intlayer runtime nodes (enumeration, condition, gender, …) are
 *    treated as leaves — their internal keys must never be renamed.
-*  - Plain objects are user-defined records: rename their keys (filtered by
-*    `usedFieldFilter` at the top level) and recurse into each value.
-*  - Primitives and arrays produce an empty map (no further renaming).
+*  - Arrays produce an empty children map.  Array elements are not traversed
+*    because consumers may access them via `.map()` / `.filter()` callbacks,
+*    which the source-code rename walk cannot enter.  Renaming element fields
+*    in the JSON without the matching source-code rename would produce
+*    mismatched key names and runtime crashes.
+*    The `[0]` pass-through in `walkRenameChain` is preserved so that direct
+*    indexed access (`field[0].sub`) silently terminates at the empty children
+*    map without breaking anything.
+*  - Plain objects are user-defined records: ALL non-reserved keys are renamed
+*    with short alphabetic aliases (a, b, c, …) and each value is recursed into.
+*  - Primitives produce an empty map (no further renaming).
 *
-* @param contentValue    - The dictionary content value to analyse.
-* @param usedFieldFilter - When provided, only keys in this set are included
-*                          at the current level (matches the usage-analysis
-*                          results so we don't rename purged fields).
+* The rename map is built from ALL user-defined fields (not just consumed ones).
+* Both the JSON rename and the source-code rename use the same map, so the
+* short names are always consistent regardless of which fields are pruned.
+*
+* @param contentValue - The dictionary content value to analyse.
 */
-const buildNestedRenameMapFromContent = (contentValue, usedFieldFilter) => {
+const buildNestedRenameMapFromContent = (contentValue) => {
 	if (!contentValue || typeof contentValue !== "object" || Array.isArray(contentValue)) return /* @__PURE__ */ new Map();
 	const record = contentValue;
 	if (typeof record.nodeType === "string") {
 		if (record.translation && typeof record.translation === "object" && !Array.isArray(record.translation)) {
 			const firstLocaleValue = Object.values(record.translation)[0];
-			return buildNestedRenameMapFromContent(firstLocaleValue, usedFieldFilter);
+			return buildNestedRenameMapFromContent(firstLocaleValue);
 		}
 		return /* @__PURE__ */ new Map();
 	}
-	const allKeys = Object.keys(record).filter((key) => !RESERVED_CONTENT_FIELD_NAMES.has(key));
-	const sortedKeys = [...usedFieldFilter ? allKeys.filter((key) => usedFieldFilter.has(key)) : allKeys].sort();
+	const sortedKeys = Object.keys(record).filter((key) => !RESERVED_CONTENT_FIELD_NAMES.has(key)).sort();
 	const renameMap = /* @__PURE__ */ new Map();
 	for (let i = 0; i < sortedKeys.length; i++) {
 		const key = sortedKeys[i];
@@ -61,16 +69,26 @@ const buildNestedRenameMapFromContent = (contentValue, usedFieldFilter) => {
 /**
 * Walks a MemberExpression chain starting from `startPath`, renaming each
 * property found in `currentRenameMap` at the corresponding nesting level.
+*
+* Numeric computed accesses (array indices such as `[0]`, `[1]`) are treated
+* as transparent pass-throughs: the rename map is kept unchanged and the walk
+* continues past the index.  This means `content.field[0].sub` is handled
+* correctly — `field` and `sub` are both renamed while `[0]` is left intact.
 */
 const walkRenameChain = (babelTypes, startPath, currentRenameMap) => {
 	let refPath = startPath;
 	let renameMap = currentRenameMap;
-	while (renameMap.size > 0) {
+	while (true) {
 		const parentPath = refPath.parentPath;
 		if (!parentPath) break;
 		const parentNode = parentPath.node;
 		if (!babelTypes.isMemberExpression(parentNode) && !babelTypes.isOptionalMemberExpression(parentNode) || parentNode.object !== refPath.node) break;
 		const memberNode = parentNode;
+		if (memberNode.computed && babelTypes.isNumericLiteral(memberNode.property)) {
+			refPath = parentPath;
+			continue;
+		}
+		if (renameMap.size === 0) break;
 		let fieldName;
 		if (!memberNode.computed && babelTypes.isIdentifier(memberNode.property)) fieldName = memberNode.property.name;
 		else if (memberNode.computed && babelTypes.isStringLiteral(memberNode.property)) fieldName = memberNode.property.value;

package/dist/esm/babel-plugin-intlayer-field-rename.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"babel-plugin-intlayer-field-rename.mjs","names":[],"sources":["../../src/babel-plugin-intlayer-field-rename.ts"],"sourcesContent":["import type { NodePath, PluginObj } from '@babel/core';\nimport type * as BabelTypes from '@babel/types';\nimport {\n  INTLAYER_CALLER_NAMES,\n  type IntlayerCallerName,\n  type NestedRenameMap,\n  type PruneContext,\n} from './babel-plugin-intlayer-usage-analyzer';\n\n// ── Field-name helpers ────────────────────────────────────────────────────────\n\n/**\n * Intlayer internal property names that must never be used as short-name\n * targets. These appear inside content-node values (e.g. `{ nodeType:\n * \"translation\", … }`) and are read by the intlayer runtime.\n */\nconst RESERVED_CONTENT_FIELD_NAMES = new Set(['nodeType']);\n\n/**\n * Converts a zero-based index to a short alphabetic identifier.\n *   0 → 'a', 1 → 'b', …, 25 → 'z', 26 → 'aa', 27 → 'ab', …\n */\nexport const generateShortFieldName = (index: number): string => {\n  const ALPHABET = 'abcdefghijklmnopqrstuvwxyz';\n  const remainder = index % ALPHABET.length;\n  const quotient = Math.floor(index / ALPHABET.length);\n  return quotient === 0\n    ? ALPHABET[remainder]\n    : generateShortFieldName(quotient - 1) + ALPHABET[remainder];\n};\n\n/**\n * Recursively builds a `NestedRenameMap` from a compiled dictionary content\n * value by traversing the intlayer node structure.\n *\n * Rules:\n *  - If the value has `nodeType: 'translation'`, user-defined fields live\n *    inside `translation[locale]`. Recurse into the first locale's value.\n *  - All other intlayer runtime nodes (enumeration, condition, gender, …) are\n *    treated as leaves — their internal keys must never be renamed.\n *  - Plain objects are user-defined records: rename their keys (filtered by\n *    `usedFieldFilter` at the top level) and recurse into each value.\n *  - Primitives and arrays produce an empty map (no further renaming).\n *\n * @param contentValue    - The dictionary content value to analyse.\n * @param usedFieldFilter - When provided, only keys in this set are included\n *                          at the current level (matches the usage-analysis\n *                          results so we don't rename purged fields).\n */\nexport const buildNestedRenameMapFromContent = (\n  contentValue: unknown,\n  usedFieldFilter?: Set<string>\n): NestedRenameMap => {\n  if (\n    !contentValue ||\n    typeof contentValue !== 'object' ||\n    Array.isArray(contentValue)\n  ) {\n    return new Map();\n  }\n\n  const record = contentValue as Record<string, unknown>;\n\n  // Any object with `nodeType: string` is an intlayer runtime node.\n  if (typeof record.nodeType === 'string') {\n    // Translation node: user-defined fields live inside translation[locale].\n    if (\n      record.translation &&\n      typeof record.translation === 'object' &&\n      !Array.isArray(record.translation)\n    ) {\n      const firstLocaleValue = Object.values(\n        record.translation as Record<string, unknown>\n      )[0];\n      return buildNestedRenameMapFromContent(firstLocaleValue, usedFieldFilter);\n    }\n    // All other intlayer nodes have runtime-managed internal structure — return\n    // an empty map so they are treated as leaves.\n    return new Map();\n  }\n\n  // User-defined record: collect non-reserved keys\n  const allKeys = Object.keys(record).filter(\n    (key) => !RESERVED_CONTENT_FIELD_NAMES.has(key)\n  );\n\n  const keysToRename = usedFieldFilter\n    ? allKeys.filter((key) => usedFieldFilter.has(key))\n    : allKeys;\n\n  const sortedKeys = [...keysToRename].sort();\n  const renameMap: NestedRenameMap = new Map();\n\n  for (let i = 0; i < sortedKeys.length; i++) {\n    const key = sortedKeys[i];\n    const children = buildNestedRenameMapFromContent(record[key]); // no filter for nested\n    renameMap.set(key, { shortName: generateShortFieldName(i), children });\n  }\n\n  return renameMap;\n};\n\n// ── Field-rename Babel plugin ─────────────────────────────────────────────────\n\n/**\n * Walks a MemberExpression chain starting from `startPath`, renaming each\n * property found in `currentRenameMap` at the corresponding nesting level.\n */\nconst walkRenameChain = (\n  babelTypes: typeof BabelTypes,\n  startPath: NodePath<BabelTypes.Node>,\n  currentRenameMap: NestedRenameMap\n): void => {\n  let refPath: NodePath<BabelTypes.Node> = startPath;\n  let renameMap = currentRenameMap;\n\n  while (renameMap.size > 0) {\n    const parentPath = refPath.parentPath;\n    if (!parentPath) break;\n\n    const parentNode = parentPath.node;\n\n    if (\n      (!babelTypes.isMemberExpression(parentNode) &&\n        !babelTypes.isOptionalMemberExpression(parentNode)) ||\n      (parentNode as BabelTypes.MemberExpression).object !== refPath.node\n    ) {\n      break;\n    }\n\n    const memberNode = parentNode as BabelTypes.MemberExpression;\n    let fieldName: string | undefined;\n\n    if (!memberNode.computed && babelTypes.isIdentifier(memberNode.property)) {\n      fieldName = memberNode.property.name;\n    } else if (\n      memberNode.computed &&\n      babelTypes.isStringLiteral(memberNode.property)\n    ) {\n      fieldName = memberNode.property.value;\n    } else {\n      break; // dynamic key – stop\n    }\n\n    const renameEntry = renameMap.get(fieldName);\n    if (!renameEntry) break; // not in map – stop\n\n    // Apply the rename\n    if (!memberNode.computed && babelTypes.isIdentifier(memberNode.property)) {\n      memberNode.property.name = renameEntry.shortName;\n    } else if (\n      memberNode.computed &&\n      babelTypes.isStringLiteral(memberNode.property)\n    ) {\n      memberNode.property.value = renameEntry.shortName;\n    }\n\n    refPath = parentPath;\n    renameMap = renameEntry.children;\n  }\n};\n\n/**\n * Creates a Babel plugin that rewrites dictionary content field accesses in\n * source files to their short aliases defined in\n * `pruneContext.dictionaryKeyToFieldRenameMap`.\n *\n * Handled patterns (mirrors the usage analyser):\n *\n *   const { fieldA, fieldB } = useIntlayer('key')\n *     → const { shortA: fieldA, shortB: fieldB } = useIntlayer('key')\n *\n *   useIntlayer('key').fieldA\n *     → useIntlayer('key').shortA\n *\n *   const result = useIntlayer('key');  result.fieldA\n *     → const result = useIntlayer('key');  result.shortA\n *\n * This plugin must run in a separate `transformAsync` pass **before**\n * `intlayerOptimizeBabelPlugin`, because the latter replaces `useIntlayer`\n * with `useDictionary`, erasing the dictionary-key information needed here.\n */\nexport const makeFieldRenameBabelPlugin =\n  (pruneContext: PruneContext) =>\n  ({ types: babelTypes }: { types: typeof BabelTypes }): PluginObj => ({\n    name: 'intlayer-field-rename',\n    visitor: {\n      Program: {\n        exit: (programPath) => {\n          if (pruneContext.dictionaryKeyToFieldRenameMap.size === 0) return;\n\n          // Collect local aliases for useIntlayer / getIntlayer\n          const intlayerCallerLocalNameMap = new Map<string, string>();\n\n          programPath.traverse({\n            ImportDeclaration: (importDeclarationPath) => {\n              for (const importSpecifier of importDeclarationPath.node\n                .specifiers) {\n                if (!babelTypes.isImportSpecifier(importSpecifier)) continue;\n\n                const importedName = babelTypes.isIdentifier(\n                  importSpecifier.imported\n                )\n                  ? importSpecifier.imported.name\n                  : (importSpecifier.imported as BabelTypes.StringLiteral)\n                      .value;\n\n                if (\n                  INTLAYER_CALLER_NAMES.includes(\n                    importedName as IntlayerCallerName\n                  )\n                ) {\n                  intlayerCallerLocalNameMap.set(\n                    importSpecifier.local.name,\n                    importedName\n                  );\n                }\n              }\n            },\n          });\n\n          if (intlayerCallerLocalNameMap.size === 0) return;\n\n          // Visit all useIntlayer / getIntlayer call-sites and rename field accesses\n          programPath.traverse({\n            CallExpression: (callExpressionPath) => {\n              const calleeNode = callExpressionPath.node.callee;\n              let localCallerName: string | undefined;\n\n              if (babelTypes.isIdentifier(calleeNode)) {\n                localCallerName = calleeNode.name;\n              } else if (\n                babelTypes.isMemberExpression(calleeNode) &&\n                babelTypes.isIdentifier(calleeNode.property)\n              ) {\n                localCallerName = calleeNode.property.name;\n              }\n\n              if (\n                !localCallerName ||\n                !intlayerCallerLocalNameMap.has(localCallerName)\n              )\n                return;\n\n              const callArguments = callExpressionPath.node.arguments;\n              if (callArguments.length === 0) return;\n\n              const firstArgument = callArguments[0];\n              let dictionaryKey: string | undefined;\n\n              if (babelTypes.isStringLiteral(firstArgument)) {\n                dictionaryKey = firstArgument.value;\n              } else if (\n                babelTypes.isTemplateLiteral(firstArgument) &&\n                firstArgument.expressions.length === 0 &&\n                firstArgument.quasis.length === 1\n              ) {\n                dictionaryKey =\n                  firstArgument.quasis[0].value.cooked ??\n                  firstArgument.quasis[0].value.raw;\n              }\n\n              if (!dictionaryKey) return;\n\n              const fieldRenameMap =\n                pruneContext.dictionaryKeyToFieldRenameMap.get(dictionaryKey);\n              if (!fieldRenameMap || fieldRenameMap.size === 0) return;\n\n              const parentNode = callExpressionPath.parent;\n\n              // ── Case 1: const { fieldA, fieldB } = useIntlayer('key') ────────\n              if (\n                babelTypes.isVariableDeclarator(parentNode) &&\n                babelTypes.isObjectPattern(parentNode.id)\n              ) {\n                for (const property of parentNode.id.properties) {\n                  if (!babelTypes.isObjectProperty(property)) continue;\n\n                  const keyName = babelTypes.isIdentifier(property.key)\n                    ? property.key.name\n                    : babelTypes.isStringLiteral(property.key)\n                      ? property.key.value\n                      : null;\n                  if (!keyName) continue;\n\n                  const renameEntry = fieldRenameMap.get(keyName);\n                  if (!renameEntry) continue;\n\n                  // { fieldA } → { shortA: fieldA }\n                  // { fieldA: localVar } → { shortA: localVar }\n                  if (property.shorthand) {\n                    property.shorthand = false;\n                    property.key = babelTypes.identifier(renameEntry.shortName);\n                  } else {\n                    property.key = babelTypes.identifier(renameEntry.shortName);\n                  }\n\n                  // Walk nested member accesses on the local variable\n                  if (\n                    renameEntry.children.size > 0 &&\n                    babelTypes.isIdentifier(property.value)\n                  ) {\n                    const localVarBinding = callExpressionPath.scope.getBinding(\n                      (property.value as BabelTypes.Identifier).name\n                    );\n                    if (localVarBinding) {\n                      for (const refPath of localVarBinding.referencePaths) {\n                        walkRenameChain(\n                          babelTypes,\n                          refPath,\n                          renameEntry.children\n                        );\n                      }\n                    }\n                  }\n                }\n                return;\n              }\n\n              // ── Case 2: useIntlayer('key').fieldA.nested ─────────────────────\n              if (\n                (babelTypes.isMemberExpression(parentNode) ||\n                  babelTypes.isOptionalMemberExpression(parentNode)) &&\n                (parentNode as BabelTypes.MemberExpression).object ===\n                  callExpressionPath.node\n              ) {\n                walkRenameChain(babelTypes, callExpressionPath, fieldRenameMap);\n                return;\n              }\n\n              // ── Case 3: const result = useIntlayer('key'); result.fieldA ─────\n              if (\n                babelTypes.isVariableDeclarator(parentNode) &&\n                babelTypes.isIdentifier(parentNode.id)\n              ) {\n                const variableName = parentNode.id.name;\n                const variableBinding =\n                  callExpressionPath.scope.getBinding(variableName);\n                if (!variableBinding) return;\n\n                for (const variableReferencePath of variableBinding.referencePaths) {\n                  walkRenameChain(\n                    babelTypes,\n                    variableReferencePath,\n                    fieldRenameMap\n                  );\n                }\n              }\n            },\n          });\n        },\n      },\n    },\n  });\n"],"mappings":"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"}
+{"version":3,"file":"babel-plugin-intlayer-field-rename.mjs","names":[],"sources":["../../src/babel-plugin-intlayer-field-rename.ts"],"sourcesContent":["import type { NodePath, PluginObj } from '@babel/core';\nimport type * as BabelTypes from '@babel/types';\nimport {\n  INTLAYER_CALLER_NAMES,\n  type IntlayerCallerName,\n  type NestedRenameMap,\n  type PruneContext,\n} from './babel-plugin-intlayer-usage-analyzer';\n\n// ── Field-name helpers ────────────────────────────────────────────────────────\n\n/**\n * Intlayer internal property names that must never be used as short-name\n * targets. These appear inside content-node values (e.g. `{ nodeType:\n * \"translation\", … }`) and are read by the intlayer runtime.\n */\nconst RESERVED_CONTENT_FIELD_NAMES = new Set(['nodeType']);\n\n/**\n * Converts a zero-based index to a short alphabetic identifier.\n *   0 → 'a', 1 → 'b', …, 25 → 'z', 26 → 'aa', 27 → 'ab', …\n */\nexport const generateShortFieldName = (index: number): string => {\n  const ALPHABET = 'abcdefghijklmnopqrstuvwxyz';\n  const remainder = index % ALPHABET.length;\n  const quotient = Math.floor(index / ALPHABET.length);\n  return quotient === 0\n    ? ALPHABET[remainder]\n    : generateShortFieldName(quotient - 1) + ALPHABET[remainder];\n};\n\n/**\n * Recursively builds a `NestedRenameMap` from a compiled dictionary content\n * value by traversing the intlayer node structure.\n *\n * Rules:\n *  - If the value has `nodeType: 'translation'`, user-defined fields live\n *    inside `translation[locale]`. Recurse into the first locale's value.\n *  - All other intlayer runtime nodes (enumeration, condition, gender, …) are\n *    treated as leaves — their internal keys must never be renamed.\n *  - Arrays produce an empty children map.  Array elements are not traversed\n *    because consumers may access them via `.map()` / `.filter()` callbacks,\n *    which the source-code rename walk cannot enter.  Renaming element fields\n *    in the JSON without the matching source-code rename would produce\n *    mismatched key names and runtime crashes.\n *    The `[0]` pass-through in `walkRenameChain` is preserved so that direct\n *    indexed access (`field[0].sub`) silently terminates at the empty children\n *    map without breaking anything.\n *  - Plain objects are user-defined records: ALL non-reserved keys are renamed\n *    with short alphabetic aliases (a, b, c, …) and each value is recursed into.\n *  - Primitives produce an empty map (no further renaming).\n *\n * The rename map is built from ALL user-defined fields (not just consumed ones).\n * Both the JSON rename and the source-code rename use the same map, so the\n * short names are always consistent regardless of which fields are pruned.\n *\n * @param contentValue - The dictionary content value to analyse.\n */\nexport const buildNestedRenameMapFromContent = (\n  contentValue: unknown\n): NestedRenameMap => {\n  if (\n    !contentValue ||\n    typeof contentValue !== 'object' ||\n    Array.isArray(contentValue)\n  ) {\n    return new Map();\n  }\n\n  const record = contentValue as Record<string, unknown>;\n\n  // Any object with `nodeType: string` is an intlayer runtime node.\n  if (typeof record.nodeType === 'string') {\n    // Translation node: user-defined fields live inside translation[locale].\n    if (\n      record.translation &&\n      typeof record.translation === 'object' &&\n      !Array.isArray(record.translation)\n    ) {\n      const firstLocaleValue = Object.values(\n        record.translation as Record<string, unknown>\n      )[0];\n      return buildNestedRenameMapFromContent(firstLocaleValue);\n    }\n    // All other intlayer nodes have runtime-managed internal structure — return\n    // an empty map so they are treated as leaves.\n    return new Map();\n  }\n\n  // User-defined record: rename ALL non-reserved keys with stable alphabetic\n  // aliases sorted alphabetically so the mapping is deterministic.\n  const sortedKeys = Object.keys(record)\n    .filter((key) => !RESERVED_CONTENT_FIELD_NAMES.has(key))\n    .sort();\n\n  const renameMap: NestedRenameMap = new Map();\n\n  for (let i = 0; i < sortedKeys.length; i++) {\n    const key = sortedKeys[i];\n    const children = buildNestedRenameMapFromContent(record[key]);\n    renameMap.set(key, { shortName: generateShortFieldName(i), children });\n  }\n\n  return renameMap;\n};\n\n// ── Field-rename Babel plugin ─────────────────────────────────────────────────\n\n/**\n * Walks a MemberExpression chain starting from `startPath`, renaming each\n * property found in `currentRenameMap` at the corresponding nesting level.\n *\n * Numeric computed accesses (array indices such as `[0]`, `[1]`) are treated\n * as transparent pass-throughs: the rename map is kept unchanged and the walk\n * continues past the index.  This means `content.field[0].sub` is handled\n * correctly — `field` and `sub` are both renamed while `[0]` is left intact.\n */\nconst walkRenameChain = (\n  babelTypes: typeof BabelTypes,\n  startPath: NodePath<BabelTypes.Node>,\n  currentRenameMap: NestedRenameMap\n): void => {\n  let refPath: NodePath<BabelTypes.Node> = startPath;\n  let renameMap = currentRenameMap;\n\n  // eslint-disable-next-line no-constant-condition\n  while (true) {\n    const parentPath = refPath.parentPath;\n    if (!parentPath) break;\n\n    const parentNode = parentPath.node;\n\n    if (\n      (!babelTypes.isMemberExpression(parentNode) &&\n        !babelTypes.isOptionalMemberExpression(parentNode)) ||\n      (parentNode as BabelTypes.MemberExpression).object !== refPath.node\n    ) {\n      break;\n    }\n\n    const memberNode = parentNode as BabelTypes.MemberExpression;\n\n    // Numeric index access ([0], [1], …): advance past the array accessor\n    // without touching the rename map.  The next iteration will attempt to\n    // rename the property that follows the index.\n    if (\n      memberNode.computed &&\n      babelTypes.isNumericLiteral(memberNode.property)\n    ) {\n      refPath = parentPath;\n      continue;\n    }\n\n    // Nothing left to rename at this level — stop.\n    if (renameMap.size === 0) break;\n\n    let fieldName: string | undefined;\n\n    if (!memberNode.computed && babelTypes.isIdentifier(memberNode.property)) {\n      fieldName = memberNode.property.name;\n    } else if (\n      memberNode.computed &&\n      babelTypes.isStringLiteral(memberNode.property)\n    ) {\n      fieldName = memberNode.property.value;\n    } else {\n      break; // dynamic computed key – stop\n    }\n\n    const renameEntry = renameMap.get(fieldName);\n    if (!renameEntry) break; // not in map – stop\n\n    // Apply the rename\n    if (!memberNode.computed && babelTypes.isIdentifier(memberNode.property)) {\n      memberNode.property.name = renameEntry.shortName;\n    } else if (\n      memberNode.computed &&\n      babelTypes.isStringLiteral(memberNode.property)\n    ) {\n      memberNode.property.value = renameEntry.shortName;\n    }\n\n    refPath = parentPath;\n    renameMap = renameEntry.children;\n  }\n};\n\n/**\n * Creates a Babel plugin that rewrites dictionary content field accesses in\n * source files to their short aliases defined in\n * `pruneContext.dictionaryKeyToFieldRenameMap`.\n *\n * Handled patterns (mirrors the usage analyser):\n *\n *   const { fieldA, fieldB } = useIntlayer('key')\n *     → const { shortA: fieldA, shortB: fieldB } = useIntlayer('key')\n *\n *   useIntlayer('key').fieldA\n *     → useIntlayer('key').shortA\n *\n *   const result = useIntlayer('key');  result.fieldA\n *     → const result = useIntlayer('key');  result.shortA\n *\n * This plugin must run in a separate `transformAsync` pass **before**\n * `intlayerOptimizeBabelPlugin`, because the latter replaces `useIntlayer`\n * with `useDictionary`, erasing the dictionary-key information needed here.\n */\nexport const makeFieldRenameBabelPlugin =\n  (pruneContext: PruneContext) =>\n  ({ types: babelTypes }: { types: typeof BabelTypes }): PluginObj => ({\n    name: 'intlayer-field-rename',\n    visitor: {\n      Program: {\n        exit: (programPath) => {\n          if (pruneContext.dictionaryKeyToFieldRenameMap.size === 0) return;\n\n          // Collect local aliases for useIntlayer / getIntlayer\n          const intlayerCallerLocalNameMap = new Map<string, string>();\n\n          programPath.traverse({\n            ImportDeclaration: (importDeclarationPath) => {\n              for (const importSpecifier of importDeclarationPath.node\n                .specifiers) {\n                if (!babelTypes.isImportSpecifier(importSpecifier)) continue;\n\n                const importedName = babelTypes.isIdentifier(\n                  importSpecifier.imported\n                )\n                  ? importSpecifier.imported.name\n                  : (importSpecifier.imported as BabelTypes.StringLiteral)\n                      .value;\n\n                if (\n                  INTLAYER_CALLER_NAMES.includes(\n                    importedName as IntlayerCallerName\n                  )\n                ) {\n                  intlayerCallerLocalNameMap.set(\n                    importSpecifier.local.name,\n                    importedName\n                  );\n                }\n              }\n            },\n          });\n\n          if (intlayerCallerLocalNameMap.size === 0) return;\n\n          // Visit all useIntlayer / getIntlayer call-sites and rename field accesses\n          programPath.traverse({\n            CallExpression: (callExpressionPath) => {\n              const calleeNode = callExpressionPath.node.callee;\n              let localCallerName: string | undefined;\n\n              if (babelTypes.isIdentifier(calleeNode)) {\n                localCallerName = calleeNode.name;\n              } else if (\n                babelTypes.isMemberExpression(calleeNode) &&\n                babelTypes.isIdentifier(calleeNode.property)\n              ) {\n                localCallerName = calleeNode.property.name;\n              }\n\n              if (\n                !localCallerName ||\n                !intlayerCallerLocalNameMap.has(localCallerName)\n              )\n                return;\n\n              const callArguments = callExpressionPath.node.arguments;\n              if (callArguments.length === 0) return;\n\n              const firstArgument = callArguments[0];\n              let dictionaryKey: string | undefined;\n\n              if (babelTypes.isStringLiteral(firstArgument)) {\n                dictionaryKey = firstArgument.value;\n              } else if (\n                babelTypes.isTemplateLiteral(firstArgument) &&\n                firstArgument.expressions.length === 0 &&\n                firstArgument.quasis.length === 1\n              ) {\n                dictionaryKey =\n                  firstArgument.quasis[0].value.cooked ??\n                  firstArgument.quasis[0].value.raw;\n              }\n\n              if (!dictionaryKey) return;\n\n              const fieldRenameMap =\n                pruneContext.dictionaryKeyToFieldRenameMap.get(dictionaryKey);\n              if (!fieldRenameMap || fieldRenameMap.size === 0) return;\n\n              const parentNode = callExpressionPath.parent;\n\n              // ── Case 1: const { fieldA, fieldB } = useIntlayer('key') ────────\n              if (\n                babelTypes.isVariableDeclarator(parentNode) &&\n                babelTypes.isObjectPattern(parentNode.id)\n              ) {\n                for (const property of parentNode.id.properties) {\n                  if (!babelTypes.isObjectProperty(property)) continue;\n\n                  const keyName = babelTypes.isIdentifier(property.key)\n                    ? property.key.name\n                    : babelTypes.isStringLiteral(property.key)\n                      ? property.key.value\n                      : null;\n                  if (!keyName) continue;\n\n                  const renameEntry = fieldRenameMap.get(keyName);\n                  if (!renameEntry) continue;\n\n                  // { fieldA } → { shortA: fieldA }\n                  // { fieldA: localVar } → { shortA: localVar }\n                  if (property.shorthand) {\n                    property.shorthand = false;\n                    property.key = babelTypes.identifier(renameEntry.shortName);\n                  } else {\n                    property.key = babelTypes.identifier(renameEntry.shortName);\n                  }\n\n                  // Walk nested member accesses on the local variable\n                  if (\n                    renameEntry.children.size > 0 &&\n                    babelTypes.isIdentifier(property.value)\n                  ) {\n                    const localVarBinding = callExpressionPath.scope.getBinding(\n                      (property.value as BabelTypes.Identifier).name\n                    );\n                    if (localVarBinding) {\n                      for (const refPath of localVarBinding.referencePaths) {\n                        walkRenameChain(\n                          babelTypes,\n                          refPath,\n                          renameEntry.children\n                        );\n                      }\n                    }\n                  }\n                }\n                return;\n              }\n\n              // ── Case 2: useIntlayer('key').fieldA.nested ─────────────────────\n              if (\n                (babelTypes.isMemberExpression(parentNode) ||\n                  babelTypes.isOptionalMemberExpression(parentNode)) &&\n                (parentNode as BabelTypes.MemberExpression).object ===\n                  callExpressionPath.node\n              ) {\n                walkRenameChain(babelTypes, callExpressionPath, fieldRenameMap);\n                return;\n              }\n\n              // ── Case 3: const result = useIntlayer('key'); result.fieldA ─────\n              if (\n                babelTypes.isVariableDeclarator(parentNode) &&\n                babelTypes.isIdentifier(parentNode.id)\n              ) {\n                const variableName = parentNode.id.name;\n                const variableBinding =\n                  callExpressionPath.scope.getBinding(variableName);\n                if (!variableBinding) return;\n\n                for (const variableReferencePath of variableBinding.referencePaths) {\n                  walkRenameChain(\n                    babelTypes,\n                    variableReferencePath,\n                    fieldRenameMap\n                  );\n                }\n              }\n            },\n          });\n        },\n      },\n    },\n  });\n"],"mappings":"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"}

package/dist/esm/extractContent/utils/generateKey.mjs

@@ -1,6 +1,10 @@
 //#region src/extractContent/utils/generateKey.ts
 const generateKey = (text, existingKeys) => {
-	let key = text.normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[\s_-]+/g, " ").replace(/[^\p{L}\p{N} ]/gu, "").trim().split(" ").filter(Boolean).slice(0, 5).map((word, index) => index === 0 ? word.toLowerCase() : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
+	const maxWords = 5;
+	const maxWordLength = 20;
+	const maxKeyLength = 40;
+	let key = text.normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[\s_-]+/g, " ").replace(/[^\p{L}\p{N} ]/gu, "").trim().split(" ").filter(Boolean).slice(0, maxWords).map((word) => word.length > maxWordLength ? word.substring(0, maxWordLength) : word).map((word, index) => index === 0 ? word.toLowerCase() : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
+	if (key.length > maxKeyLength) key = key.substring(0, maxKeyLength);
 	if (!key) key = "content";
 	if (/^[0-9]/.test(key)) key = `x${key}`;
 	if (existingKeys.has(key)) {

package/dist/esm/extractContent/utils/generateKey.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"generateKey.mjs","names":[],"sources":["../../../../src/extractContent/utils/generateKey.ts"],"sourcesContent":["export const generateKey = (\n  text: string,\n  existingKeys: Set<string>\n): string => {\n  const maxWords = 5;\n  let key = text\n    .normalize('NFD') // Normalize to decomposes combined characters (e.g., é -> e + ´)\n    .replace(/[\\u0300-\\u036f]/g, '') // Remove the accent characters\n    .replace(/[\\s_-]+/g, ' ')\n    .replace(/[^\\p{L}\\p{N} ]/gu, '')\n    .trim()\n    .split(' ')\n    .filter(Boolean)\n    .slice(0, maxWords)\n    .map((word, index) =>\n      index === 0\n        ? word.toLowerCase()\n        : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()\n    )\n    .join('');\n\n  if (!key) key = 'content';\n\n  // If the key starts with a number, prepend 'x' to make it a valid JS identifier\n  if (/^[0-9]/.test(key)) {\n    key = `x${key}`;\n  }\n\n  if (existingKeys.has(key)) {\n    let i = 1;\n    while (existingKeys.has(`${key}${i}`)) i++;\n    key = `${key}${i}`;\n  }\n  return key;\n};\n"],"mappings":";AAAA,MAAa,eACX,MACA,iBACW;CAEX,IAAI,MAAM,KACP,UAAU,MAAM,CAChB,QAAQ,oBAAoB,GAAG,CAC/B,QAAQ,YAAY,IAAI,CACxB,QAAQ,oBAAoB,GAAG,CAC/B,MAAM,CACN,MAAM,IAAI,CACV,OAAO,QAAQ,CACf,MAAM,GATQ,EASI,CAClB,KAAK,MAAM,UACV,UAAU,IACN,KAAK,aAAa,GAClB,KAAK,OAAO,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE,CAAC,aAAa,CAC/D,CACA,KAAK,GAAG;AAEX,KAAI,CAAC,IAAK,OAAM;AAGhB,KAAI,SAAS,KAAK,IAAI,CACpB,OAAM,IAAI;AAGZ,KAAI,aAAa,IAAI,IAAI,EAAE;EACzB,IAAI,IAAI;AACR,SAAO,aAAa,IAAI,GAAG,MAAM,IAAI,CAAE;AACvC,QAAM,GAAG,MAAM;;AAEjB,QAAO"}
+{"version":3,"file":"generateKey.mjs","names":[],"sources":["../../../../src/extractContent/utils/generateKey.ts"],"sourcesContent":["export const generateKey = (\n  text: string,\n  existingKeys: Set<string>\n): string => {\n  const maxWords = 5;\n  const maxWordLength = 20;\n  const maxKeyLength = 40;\n\n  let key = text\n    .normalize('NFD') // Normalize to decomposes combined characters (e.g., é -> e + ´)\n    .replace(/[\\u0300-\\u036f]/g, '') // Remove the accent characters\n    .replace(/[\\s_-]+/g, ' ')\n    .replace(/[^\\p{L}\\p{N} ]/gu, '')\n    .trim()\n    .split(' ')\n    .filter(Boolean)\n    .slice(0, maxWords)\n    .map((word) =>\n      word.length > maxWordLength ? word.substring(0, maxWordLength) : word\n    )\n    .map((word, index) =>\n      index === 0\n        ? word.toLowerCase()\n        : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()\n    )\n    .join('');\n\n  if (key.length > maxKeyLength) {\n    key = key.substring(0, maxKeyLength);\n  }\n\n  if (!key) key = 'content';\n\n  // If the key starts with a number, prepend 'x' to make it a valid JS identifier\n  if (/^[0-9]/.test(key)) {\n    key = `x${key}`;\n  }\n\n  if (existingKeys.has(key)) {\n    let i = 1;\n    while (existingKeys.has(`${key}${i}`)) i++;\n    key = `${key}${i}`;\n  }\n  return key;\n};\n"],"mappings":";AAAA,MAAa,eACX,MACA,iBACW;CACX,MAAM,WAAW;CACjB,MAAM,gBAAgB;CACtB,MAAM,eAAe;CAErB,IAAI,MAAM,KACP,UAAU,MAAM,CAChB,QAAQ,oBAAoB,GAAG,CAC/B,QAAQ,YAAY,IAAI,CACxB,QAAQ,oBAAoB,GAAG,CAC/B,MAAM,CACN,MAAM,IAAI,CACV,OAAO,QAAQ,CACf,MAAM,GAAG,SAAS,CAClB,KAAK,SACJ,KAAK,SAAS,gBAAgB,KAAK,UAAU,GAAG,cAAc,GAAG,KAClE,CACA,KAAK,MAAM,UACV,UAAU,IACN,KAAK,aAAa,GAClB,KAAK,OAAO,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE,CAAC,aAAa,CAC/D,CACA,KAAK,GAAG;AAEX,KAAI,IAAI,SAAS,aACf,OAAM,IAAI,UAAU,GAAG,aAAa;AAGtC,KAAI,CAAC,IAAK,OAAM;AAGhB,KAAI,SAAS,KAAK,IAAI,CACpB,OAAM,IAAI;AAGZ,KAAI,aAAa,IAAI,IAAI,EAAE;EACzB,IAAI,IAAI;AACR,SAAO,aAAa,IAAI,GAAG,MAAM,IAAI,CAAE;AACvC,QAAM,GAAG,MAAM;;AAEjB,QAAO"}

package/dist/esm/extractContent/utils/shouldExtract.mjs

@@ -13,10 +13,12 @@ const shouldExtract = (text) => {
 	if (!trimmed) return false;
 	if (/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(trimmed)) return false;
 	if (trimmed.startsWith("{") || trimmed.startsWith("v-")) return false;
+	if (trimmed.includes("=>") || trimmed.includes(");") || trimmed.includes("(){") || trimmed.includes("==") || trimmed.includes("window.") || trimmed.startsWith("(function") || trimmed.startsWith("function(")) return false;
+	if ((trimmed.match(/[^\p{L}\p{N}\s.,!?;:'"()[\]{}–—/«»„“\p{Sc}%&*+#@^_+=<>/~]/gu) || []).length > 5) return false;
 	const wordCount = trimmed.split(/\s+/).length;
-	const isCapitalized = /^[A-Z]/.test(trimmed);
+	const isCapitalized = /^['"([]*\p{Lu}/u.test(trimmed);
 	if (wordCount === 1) {
-		if (/[a-z][A-Z]/.test(trimmed)) return false;
+		if (/[a-z]\p{Lu}/u.test(trimmed)) return false;
 		if (trimmed.includes("-") || trimmed.includes("_")) return false;
 	}
 	if (!isCapitalized && wordCount <= 2) return false;

package/dist/esm/extractContent/utils/shouldExtract.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"shouldExtract.mjs","names":[],"sources":["../../../../src/extractContent/utils/shouldExtract.ts"],"sourcesContent":["/**\n * Checks whether the given text should be extracted as a translatable string.\n *\n * Filters out:\n * - Empty strings\n * - Emails\n * - Uncapitalized strings of 2 words or fewer (likely technical terms)\n * - Dynamic content patterns like Vue bindings (`v-`) or object patterns (`{`)\n */\nexport const shouldExtract = (text: string): boolean => {\n  const trimmed = text.trim();\n\n  if (!trimmed) return false;\n\n  // Ignore emails\n  if (/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(trimmed)) return false;\n\n  // Ignore dynamic content patterns\n  if (trimmed.startsWith('{') || trimmed.startsWith('v-')) return false;\n\n  const wordCount = trimmed.split(/\\s+/).length;\n  const isCapitalized = /^[A-Z]/.test(trimmed);\n\n  // Ignore technical identifiers (one word strings with camelCase, kebab-case, snake_case etc.)\n  if (wordCount === 1) {\n    // CamelCase or internal capitals (like camelCaseProperty or CamelCaseProperty)\n    if (/[a-z][A-Z]/.test(trimmed)) return false;\n    // kebab-case or snake_case\n    if (trimmed.includes('-') || trimmed.includes('_')) return false;\n  }\n\n  // We usually want to extract full sentences or labels, not single/short technical words.\n  // Extract if capitalized, or if it contains more than 2 words.\n  if (!isCapitalized && wordCount <= 2) return false;\n\n  return true;\n};\n"],"mappings":";;;;;;;;;;AASA,MAAa,iBAAiB,SAA0B;CACtD,MAAM,UAAU,KAAK,MAAM;AAE3B,KAAI,CAAC,QAAS,QAAO;AAGrB,KAAI,6BAA6B,KAAK,QAAQ,CAAE,QAAO;AAGvD,KAAI,QAAQ,WAAW,IAAI,IAAI,QAAQ,WAAW,KAAK,CAAE,QAAO;CAEhE,MAAM,YAAY,QAAQ,MAAM,MAAM,CAAC;CACvC,MAAM,gBAAgB,SAAS,KAAK,QAAQ;AAG5C,KAAI,cAAc,GAAG;AAEnB,MAAI,aAAa,KAAK,QAAQ,CAAE,QAAO;AAEvC,MAAI,QAAQ,SAAS,IAAI,IAAI,QAAQ,SAAS,IAAI,CAAE,QAAO;;AAK7D,KAAI,CAAC,iBAAiB,aAAa,EAAG,QAAO;AAE7C,QAAO"}
+{"version":3,"file":"shouldExtract.mjs","names":[],"sources":["../../../../src/extractContent/utils/shouldExtract.ts"],"sourcesContent":["/**\n * Checks whether the given text should be extracted as a translatable string.\n *\n * Filters out:\n * - Empty strings\n * - Emails\n * - Uncapitalized strings of 2 words or fewer (likely technical terms)\n * - Dynamic content patterns like Vue bindings (`v-`) or object patterns (`{`)\n */\nexport const shouldExtract = (text: string): boolean => {\n  const trimmed = text.trim();\n\n  if (!trimmed) return false;\n\n  // Ignore emails\n  if (/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(trimmed)) return false;\n\n  // Ignore dynamic content patterns\n  if (trimmed.startsWith('{') || trimmed.startsWith('v-')) return false;\n\n  // Ignore explicit code patterns (markers)\n  if (\n    trimmed.includes('=>') ||\n    trimmed.includes(');') ||\n    trimmed.includes('(){') ||\n    trimmed.includes('==') ||\n    trimmed.includes('window.') ||\n    trimmed.startsWith('(function') ||\n    trimmed.startsWith('function(')\n  ) {\n    return false;\n  }\n\n  // Heuristic: check for characters that are common in code but rare in natural text.\n  // Whitelist: letters, numbers, spaces, and frequent text symbols (including punctuation, braces, and technical symbols)\n  const nonTextualRegex =\n    /[^\\p{L}\\p{N}\\s.,!?;:'\"()[\\]{}–—/«»„“\\p{Sc}%&*+#@^_+=<>/~]/gu;\n  const nonTextualMatches = trimmed.match(nonTextualRegex) || [];\n\n  // If a string contains a high density of truly exceptional symbols (like |, \\, etc.),\n  // it is highly likely to be code or complex technical data.\n  if (nonTextualMatches.length > 5) return false;\n\n  const wordCount = trimmed.split(/\\s+/).length;\n\n  // Check if starts with a capital letter (including after an opening parenthesis/quote)\n  const isCapitalized = /^['\"([]*\\p{Lu}/u.test(trimmed);\n\n  // Ignore technical identifiers (one word strings with camelCase, kebab-case, snake_case etc.)\n  if (wordCount === 1) {\n    // CamelCase or internal capitals (like camelCaseProperty or CamelCaseProperty)\n    if (/[a-z]\\p{Lu}/u.test(trimmed)) return false;\n    // kebab-case or snake_case\n    if (trimmed.includes('-') || trimmed.includes('_')) return false;\n  }\n\n  // We usually want to extract full sentences or labels, not single/short technical words.\n  // Extract if capitalized, or if it contains more than 2 words.\n  if (!isCapitalized && wordCount <= 2) return false;\n\n  return true;\n};\n"],"mappings":";;;;;;;;;;AASA,MAAa,iBAAiB,SAA0B;CACtD,MAAM,UAAU,KAAK,MAAM;AAE3B,KAAI,CAAC,QAAS,QAAO;AAGrB,KAAI,6BAA6B,KAAK,QAAQ,CAAE,QAAO;AAGvD,KAAI,QAAQ,WAAW,IAAI,IAAI,QAAQ,WAAW,KAAK,CAAE,QAAO;AAGhE,KACE,QAAQ,SAAS,KAAK,IACtB,QAAQ,SAAS,KAAK,IACtB,QAAQ,SAAS,MAAM,IACvB,QAAQ,SAAS,KAAK,IACtB,QAAQ,SAAS,UAAU,IAC3B,QAAQ,WAAW,YAAY,IAC/B,QAAQ,WAAW,YAAY,CAE/B,QAAO;AAWT,MAJ0B,QAAQ,MADhC,8DACsD,IAAI,EAAE,EAIxC,SAAS,EAAG,QAAO;CAEzC,MAAM,YAAY,QAAQ,MAAM,MAAM,CAAC;CAGvC,MAAM,gBAAgB,kBAAkB,KAAK,QAAQ;AAGrD,KAAI,cAAc,GAAG;AAEnB,MAAI,eAAe,KAAK,QAAQ,CAAE,QAAO;AAEzC,MAAI,QAAQ,SAAS,IAAI,IAAI,QAAQ,SAAS,IAAI,CAAE,QAAO;;AAK7D,KAAI,CAAC,iBAAiB,aAAa,EAAG,QAAO;AAE7C,QAAO"}

package/dist/types/babel-plugin-intlayer-field-rename.d.ts

@@ -17,16 +17,25 @@ declare const generateShortFieldName: (index: number) => string;
  *    inside `translation[locale]`. Recurse into the first locale's value.
  *  - All other intlayer runtime nodes (enumeration, condition, gender, …) are
  *    treated as leaves — their internal keys must never be renamed.
- *  - Plain objects are user-defined records: rename their keys (filtered by
- *    `usedFieldFilter` at the top level) and recurse into each value.
- *  - Primitives and arrays produce an empty map (no further renaming).
- *
- * @param contentValue    - The dictionary content value to analyse.
- * @param usedFieldFilter - When provided, only keys in this set are included
- *                          at the current level (matches the usage-analysis
- *                          results so we don't rename purged fields).
+ *  - Arrays produce an empty children map.  Array elements are not traversed
+ *    because consumers may access them via `.map()` / `.filter()` callbacks,
+ *    which the source-code rename walk cannot enter.  Renaming element fields
+ *    in the JSON without the matching source-code rename would produce
+ *    mismatched key names and runtime crashes.
+ *    The `[0]` pass-through in `walkRenameChain` is preserved so that direct
+ *    indexed access (`field[0].sub`) silently terminates at the empty children
+ *    map without breaking anything.
+ *  - Plain objects are user-defined records: ALL non-reserved keys are renamed
+ *    with short alphabetic aliases (a, b, c, …) and each value is recursed into.
+ *  - Primitives produce an empty map (no further renaming).
+ *
+ * The rename map is built from ALL user-defined fields (not just consumed ones).
+ * Both the JSON rename and the source-code rename use the same map, so the
+ * short names are always consistent regardless of which fields are pruned.
+ *
+ * @param contentValue - The dictionary content value to analyse.
  */
-declare const buildNestedRenameMapFromContent: (contentValue: unknown, usedFieldFilter?: Set<string>) => NestedRenameMap;
+declare const buildNestedRenameMapFromContent: (contentValue: unknown) => NestedRenameMap;
 /**
  * Creates a Babel plugin that rewrites dictionary content field accesses in
  * source files to their short aliases defined in

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

@@ -1 +1 @@
-{"version":3,"file":"babel-plugin-intlayer-field-rename.d.ts","names":[],"sources":["../../src/babel-plugin-intlayer-field-rename.ts"],"mappings":";;;;;;;AAsBA;;cAAa,sBAAA,GAA0B,KAAA;;;AA2BvC;;;;;;;;;;AAqIA;;;;;;cArIa,+BAAA,GACX,YAAA,WACA,eAAA,GAAkB,GAAA,aACjB,eAAA;;;;;;;;;;;;;;;;;;;;;cAkIU,0BAAA,GACV,YAAA,EAAc,YAAA;EACd,KAAA,EAAA;AAAA;EAAyB,KAAA,SAAc,UAAA;AAAA,MAAe,SAAA"}
+{"version":3,"file":"babel-plugin-intlayer-field-rename.d.ts","names":[],"sources":["../../src/babel-plugin-intlayer-field-rename.ts"],"mappings":";;;;;;;AAsBA;;cAAa,sBAAA,GAA0B,KAAA;;;AAoCvC;;;;;AAqJA;;;;;;;;;;;;;;;;;;;;cArJa,+BAAA,GACX,YAAA,cACC,eAAA;;;;;;;;;;;;;;;;;;;;;cAmJU,0BAAA,GACV,YAAA,EAAc,YAAA;EACd,KAAA,EAAA;AAAA;EAAyB,KAAA,SAAc,UAAA;AAAA,MAAe,SAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/babel",
-  "version": "8.7.0",
+  "version": "8.7.1-canary-1",
   "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": [
@@ -81,12 +81,12 @@
     "@babel/plugin-syntax-jsx": "7.28.6",
     "@babel/traverse": "7.29.0",
     "@babel/types": "7.29.0",
-    "@intlayer/chokidar": "8.7.0",
-    "@intlayer/config": "8.7.0",
-    "@intlayer/core": "8.7.0",
-    "@intlayer/dictionaries-entry": "8.7.0",
-    "@intlayer/types": "8.7.0",
-    "@intlayer/unmerged-dictionaries-entry": "8.7.0",
+    "@intlayer/chokidar": "8.7.1-canary-1",
+    "@intlayer/config": "8.7.1-canary-1",
+    "@intlayer/core": "8.7.1-canary-1",
+    "@intlayer/dictionaries-entry": "8.7.1-canary-1",
+    "@intlayer/types": "8.7.1-canary-1",
+    "@intlayer/unmerged-dictionaries-entry": "8.7.1-canary-1",
     "@types/babel__core": "7.20.5",
     "@types/babel__generator": "7.27.0",
     "@types/babel__traverse": "7.28.0"
@@ -99,13 +99,13 @@
     "@utils/tsdown-config": "1.0.4",
     "@vitejs/plugin-react": "6.0.1",
     "rimraf": "6.1.3",
-    "tsdown": "0.21.7",
+    "tsdown": "0.21.8",
     "typescript": "6.0.2",
     "vitest": "4.1.4"
   },
   "peerDependencies": {
-    "@intlayer/svelte-compiler": "8.7.0",
-    "@intlayer/vue-compiler": "8.7.0"
+    "@intlayer/svelte-compiler": "8.7.1-canary-1",
+    "@intlayer/vue-compiler": "8.7.1-canary-1"
   },
   "peerDependenciesMeta": {
     "@intlayer/svelte-compiler": {