generaltranslation 8.2.11 → 8.2.13

package/dist/internal.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_IntlCache = require("./IntlCache-k2qfrDqB.cjs");
-const require_base64 = require("./base64-CUcEPEC5.cjs");
+const require_IntlCache = require("./IntlCache-CAW8tKhd.cjs");
+const require_base64 = require("./base64-2fu94Klt.cjs");
 const require_isVariable = require("./isVariable-B08mggBy.cjs");
 let _formatjs_icu_messageformat_parser = require("@formatjs/icu-messageformat-parser");
 let _formatjs_icu_messageformat_parser_types_js = require("@formatjs/icu-messageformat-parser/types.js");
@@ -26,7 +26,7 @@ function isAcceptedPluralForm(form) {
 * Given a number and a list of allowed plural forms, return the plural form that best fits the number.
 *
 * @param {number} n - The number to determine the plural form for.
-* @param {locales[]} forms - The allowed plural forms.
+* @param {PluralType[]} forms - The allowed plural forms.
 * @returns {PluralType} The determined plural form, or an empty string if none fit.
 */
 function _getPluralForm(n, forms = pluralForms, locales = ["en"]) {
@@ -73,7 +73,7 @@ function minifyVariableType(variableType) {
 * @param icu - The ICU string to traverse
 * @param shouldVisit - A function that returns true if the element should be visited
 * @param visitor - A function that is called for each element that matches the type T
-* @returns The modified AST of the ICU string
+* @returns The modified AST of the ICU string.
 *
 * @note This function is a heavy operation, use sparingly
 */
@@ -211,9 +211,19 @@ function declareVar(variable, options) {
 //#endregion
 //#region src/derive/derive.ts
 /**
-* derive() is a powerful but dangerous function which marks its argument as derivable (statically analyzable) for the compiler and CLI tool.
+* Marks content as derivable by the GT compiler and CLI.
 *
-* This function is dangerous because it can cause the compiler and CLI tool to throw an error if the argument is not derivable.
+* Use `derive()` when a translation string or context needs content that is
+* computed from source code, but should still be discovered during extraction
+* instead of treated as a runtime interpolation variable. The CLI attempts to
+* resolve the derivable expression into every possible static value and
+* includes those values in the source content that gets translated.
+*
+* `derive()` returns its argument unchanged at runtime.
+*
+* Run `gt validate` after adding or changing `derive()` calls to verify that
+* each derivable expression can be resolved by the CLI before translating or
+* building.
 *
 * @example
 * ```jsx
@@ -224,8 +234,8 @@ function declareVar(variable, options) {
 * gt(`My name is ${derive(getSubject())}`);
 * ```
 *
-* @param {T extends string | boolean | number | null | undefined} content - Content to mark as derivable.
-* @returns content
+* @param {T extends string | boolean | number | null | undefined} content - Content to derive for translation extraction.
+* @returns {T} The same content, unchanged at runtime.
 */
 function derive(content) {
 	return content;
@@ -233,9 +243,14 @@ function derive(content) {
 /**
 * @deprecated Use derive() instead.
 *
-* declareStatic() is a powerful but dangerous function which marks its argument as derivable (statically analyzable) for the compiler and CLI tool.
+* Marks content as derivable by the GT compiler and CLI.
+*
+* Use `derive()` instead of `declareStatic()` for new code. This alias is kept
+* for backwards compatibility and returns its argument unchanged at runtime.
 *
-* This function is dangerous because it can cause the compiler and CLI tool to throw an error if the argument is not derivable.
+* Run `gt validate` after adding or changing derived content to verify that
+* each derivable expression can be resolved by the CLI before translating or
+* building.
 *
 * @example
 * ```jsx
@@ -246,8 +261,8 @@ function derive(content) {
 * gt(`My name is ${declareStatic(getSubject())}`);
 * ```
 *
-* @param {T extends string | boolean | number | null | undefined} content - Content to mark as derivable.
-* @returns content
+* @param {T extends string | boolean | number | null | undefined} content - Content to derive for translation extraction.
+* @returns {T} The same content, unchanged at runtime.
 */
 const declareStatic = derive;
 //#endregion
@@ -329,7 +344,7 @@ function condenseVars(icuString) {
 	if (!icuString.includes("_gt_")) return icuString;
 	function visitor(child) {
 		child.type = _formatjs_icu_messageformat_parser_types_js.TYPE.argument;
-		delete child.options;
+		Reflect.deleteProperty(child, "options");
 	}
 	return (0, _formatjs_icu_messageformat_parser_printer_js.printAST)(traverseIcu({
 		icuString,
@@ -342,7 +357,7 @@ function condenseVars(icuString) {
 //#region src/backwards-compatability/typeChecking.ts
 /**
 * Checks if a JSX child is an old variable object format
-* @param child - The JSX child to check
+* @param child - The JSX child to check.
 * @returns True if the child is an old variable object (has 'key' property)
 */
 function isOldVariableObject(child) {
@@ -350,7 +365,7 @@ function isOldVariableObject(child) {
 }
 /**
 * Checks if a JSX child is a new variable object format
-* @param child - The JSX child to check
+* @param child - The JSX child to check.
 * @returns True if the child is a new variable object (has 'k' property)
 */
 function isNewVariableObject(child) {
@@ -358,7 +373,7 @@ function isNewVariableObject(child) {
 }
 /**
 * Checks if a JSX child is an old JSX element format
-* @param child - The JSX child to check
+* @param child - The JSX child to check.
 * @returns True if the child is an old JSX element (has 'type' and 'props' properties)
 */
 function isOldJsxElement(child) {
@@ -366,8 +381,8 @@ function isOldJsxElement(child) {
 }
 /**
 * Checks if a JSX child follows the old format (string, old variable object, or old JSX element)
-* @param child - The JSX child to check
-* @returns True if the child is in the old format
+* @param child - The JSX child to check.
+* @returns True if the child is in the old format.
 */
 function isOldJsxChild(child) {
 	if (typeof child === "string") return true;
@@ -377,7 +392,7 @@ function isOldJsxChild(child) {
 /**
 * Checks if JSX children follow the old format
 * @param children - The JSX children to check (can be string, array, or single child)
-* @returns True if all children are in the old format
+* @returns True if all children are in the old format.
 */
 function isOldJsxChildren(children) {
 	if (typeof children === "string") return true;
@@ -447,7 +462,7 @@ function getNewGTProp(dataGT) {
 	};
 }
 /**
-* Convert response data from old format to new format
+* Convert response data from current format to old format
 */
 function getOldJsxChild(child) {
 	if (typeof child === "string") return child;
@@ -511,10 +526,10 @@ function getOldGTProp(dataGT, i) {
 //#endregion
 //#region src/backwards-compatability/oldHashJsxChildren.ts
 /**
-* Calculates a unique hash for a given string using sha256.
+* Calculates a unique hash for a given string using SHA-256.
 *
 * @param {string} string - The string to be hashed.
-* @returns {string} - The resulting hash as a hexadecimal string.
+* @returns {string} The resulting hash as a hexadecimal string.
 */
 function oldHashString(string) {
 	return require_isVariable.bytesToHex(require_isVariable.sha256(require_isVariable.utf8ToBytes(string)));
@@ -523,10 +538,10 @@ function oldHashString(string) {
 * Calculates a unique ID for the given children objects by hashing their sanitized JSON string representation.
 *
 * @param {any} childrenAsObjects - The children objects to be hashed.
-* @param {string} context - The context for the children
-* @param {string} id - The id for the JSX Children object
-* @param {function} hashFunction custom hash function
-* @returns {string} - The unique has of the children.
+* @param {string} context - The context for the children.
+* @param {string} id - The ID for the JSX children object.
+* @param {function} hashFunction - Custom hash function.
+* @returns {string} - The unique hash of the children.
 */
 function oldHashJsxChildren({ source, context, id, dataFormat }, hashFunction = oldHashString) {
 	return hashFunction(require_isVariable.stableStringify({

package/dist/internal.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"internal.cjs","names":["intlCache","TYPE","TYPE","TYPE","bytesToHex","sha256","utf8ToBytes","stringify"],"sources":["../src/settings/plurals.ts","../src/locales/getPluralForm.ts","../src/utils/minify.ts","../src/derive/utils/traverseIcu.ts","../src/derive/utils/constants.ts","../src/derive/utils/regex.ts","../src/derive/utils/traverseHelpers.ts","../src/derive/decodeVars.ts","../src/derive/utils/sanitizeVar.ts","../src/derive/declareVar.ts","../src/derive/derive.ts","../src/derive/indexVars.ts","../src/derive/extractVars.ts","../src/derive/condenseVars.ts","../src/backwards-compatability/typeChecking.ts","../src/backwards-compatability/dataConversion.ts","../src/backwards-compatability/oldHashJsxChildren.ts"],"sourcesContent":["export const pluralForms = [\n  'singular',\n  'plural',\n  'dual',\n  'zero',\n  'one',\n  'two',\n  'few',\n  'many',\n  'other',\n] as const;\nexport type PluralType = (typeof pluralForms)[number];\nexport function isAcceptedPluralForm(form: string): form is PluralType {\n  return pluralForms.includes(form as (typeof pluralForms)[number]);\n}\n","import { intlCache } from '../cache/IntlCache';\nimport { pluralForms, PluralType } from '../settings/plurals';\nimport { libraryDefaultLocale } from '../settings/settings';\n\n/**\n * Given a number and a list of allowed plural forms, return the plural form that best fits the number.\n *\n * @param {number} n - The number to determine the plural form for.\n * @param {locales[]} forms - The allowed plural forms.\n * @returns {PluralType} The determined plural form, or an empty string if none fit.\n */\nexport default function _getPluralForm(\n  n: number,\n  forms: PluralType[] = pluralForms as any,\n  locales: string[] = [libraryDefaultLocale]\n): PluralType | '' {\n  const pluralRules = intlCache.get('PluralRules', locales);\n  const provisionalBranchName = pluralRules.select(n);\n  // aliases\n  const absN = Math.abs(n);\n  // 0\n  if (absN === 0 && forms.includes('zero')) return 'zero'; // override\n  // 1\n  if (absN === 1) {\n    if (forms.includes('singular')) return 'singular'; // override\n    if (forms.includes('one')) return 'one'; // override\n  }\n  if (provisionalBranchName === 'one' && forms.includes('singular'))\n    return 'singular';\n  // 2\n  if (absN === 2) {\n    if (forms.includes('dual')) return 'dual'; // override\n    if (forms.includes('two')) return 'two'; // override\n  }\n  if (provisionalBranchName === 'two' && forms.includes('dual')) return 'dual';\n  // fallbacks\n  if (forms.includes(provisionalBranchName)) return provisionalBranchName;\n  // two\n  if (provisionalBranchName === 'two' && forms.includes('dual')) return 'dual';\n  if (provisionalBranchName === 'two' && forms.includes('plural'))\n    return 'plural';\n  if (provisionalBranchName === 'two' && forms.includes('other'))\n    return 'other';\n  // few\n  if (provisionalBranchName === 'few' && forms.includes('plural'))\n    return 'plural';\n  if (provisionalBranchName === 'few' && forms.includes('other'))\n    return 'other';\n  // many\n  if (provisionalBranchName === 'many' && forms.includes('plural'))\n    return 'plural';\n  if (provisionalBranchName === 'many' && forms.includes('other'))\n    return 'other';\n  // other\n  if (provisionalBranchName === 'other' && forms.includes('plural'))\n    return 'plural';\n  return '';\n}\n","import { VariableTransformationSuffix, VariableType } from '../types';\n\nconst VARIABLE_TRANSFORMATION_SUFFIXES_TO_MINIFIED_NAMES = {\n  variable: 'v',\n  number: 'n',\n  datetime: 'd',\n  currency: 'c',\n  'relative-time': 'rt',\n} as const;\n\nexport function minifyVariableType(\n  variableType: VariableTransformationSuffix\n): VariableType {\n  return VARIABLE_TRANSFORMATION_SUFFIXES_TO_MINIFIED_NAMES[variableType];\n}\n","import {\n  MessageFormatElement,\n  parse,\n  ParserOptions,\n  TYPE,\n} from '@formatjs/icu-messageformat-parser';\n\ntype TraverseIcuOptions = ParserOptions & {\n  recurseIntoVisited?: boolean;\n};\n\n/**\n * Given an ICU string, traverse the AST and call the visitor function for each element that matches the type T\n * @param icu - The ICU string to traverse\n * @param shouldVisit - A function that returns true if the element should be visited\n * @param visitor - A function that is called for each element that matches the type T\n * @returns The modified AST of the ICU string\n *\n * @note This function is a heavy operation, use sparingly\n */\nexport function traverseIcu<T extends MessageFormatElement>({\n  icuString,\n  shouldVisit,\n  visitor,\n  options: { recurseIntoVisited = true, ...otherOptions },\n}: {\n  icuString: string;\n  shouldVisit: (element: MessageFormatElement) => element is T;\n  visitor: (element: T) => void;\n  options: TraverseIcuOptions;\n}): MessageFormatElement[] {\n  const ast = parse(icuString, otherOptions);\n  handleChildren(ast);\n  return ast;\n\n  function handleChildren(children: MessageFormatElement[]): void {\n    children.map(handleChild);\n  }\n\n  function handleChild(child: MessageFormatElement) {\n    // handle select var\n    let visited = false;\n    if (shouldVisit(child)) {\n      visitor(child);\n      visited = true;\n    }\n    // recurse on children\n    if (!visited || recurseIntoVisited) {\n      if (child.type === TYPE.select || child.type === TYPE.plural) {\n        Object.values(child.options)\n          .map((option) => option.value)\n          .map(handleChildren);\n      } else if (child.type === TYPE.tag) {\n        handleChildren(child.children);\n      }\n    }\n  }\n}\n","export const VAR_IDENTIFIER = '_gt_';\nexport const VAR_NAME_IDENTIFIER = '_gt_var_name';\n","import { VAR_IDENTIFIER } from './constants';\n\n// Regex  for _gt_# select\nexport const GT_INDEXED_IDENTIFIER_REGEX = new RegExp(\n  `^${VAR_IDENTIFIER}\\\\d+$`\n);\n\nexport const GT_UNINDEXED_IDENTIFIER_REGEX = new RegExp(`^${VAR_IDENTIFIER}$`);\n","import {\n  GT_INDEXED_IDENTIFIER_REGEX,\n  GT_UNINDEXED_IDENTIFIER_REGEX,\n} from './regex';\nimport { GTIndexedSelectElement, GTUnindexedSelectElement } from './types';\nimport {\n  type MessageFormatElement,\n  TYPE,\n} from '@formatjs/icu-messageformat-parser/types.js';\n\n// Visit any _gt_# select\nexport function isGTIndexedSelectElement(\n  child: MessageFormatElement\n): child is GTIndexedSelectElement {\n  return (\n    child.type === TYPE.select &&\n    GT_INDEXED_IDENTIFIER_REGEX.test(child.value) &&\n    !!child.options.other &&\n    (child.options.other.value.length === 0 ||\n      (child.options.other.value.length > 0 &&\n        child.options.other.value[0]?.type === TYPE.literal))\n  );\n}\n\n// Visit any _gt_ select\nexport function isGTUnindexedSelectElement(\n  child: MessageFormatElement\n): child is GTUnindexedSelectElement {\n  return (\n    child.type === TYPE.select &&\n    GT_UNINDEXED_IDENTIFIER_REGEX.test(child.value) &&\n    !!child.options.other &&\n    (child.options.other.value.length === 0 ||\n      (child.options.other.value.length > 0 &&\n        child.options.other.value[0]?.type === TYPE.literal))\n  );\n}\n","import { traverseIcu } from './utils/traverseIcu';\nimport { VAR_IDENTIFIER } from './utils/constants';\nimport { GTUnindexedSelectElement } from './utils/types';\nimport { isGTUnindexedSelectElement } from './utils/traverseHelpers';\n\ntype Location = {\n  start: number;\n  end: number;\n  value: string;\n};\n\n/**\n * Given an encoded ICU string, interpolate only _gt_ variables that have been marked with declareVar()\n * @example\n * const encodedIcu = \"Hi\" + declareVar(\"Brian\") + \", my name is {name}\"\n * // 'Hi {_gt_, select, other {Brian}}, my name is {name}'\n * decodeVars(encodedIcu)\n * // 'Hi Brian, my name is {name}'\n */\nexport function decodeVars(icuString: string): string {\n  // Check if the string contains _gt_\n  if (!icuString.includes(VAR_IDENTIFIER)) {\n    return icuString;\n  }\n\n  // Record the location of the variable\n  const variableLocations: Location[] = [];\n  function visitor(child: GTUnindexedSelectElement): void {\n    variableLocations.push({\n      start: child.location?.start.offset ?? 0,\n      end: child.location?.end.offset ?? 0,\n      value:\n        child.options.other.value.length > 0\n          ? child.options.other.value[0].value\n          : '',\n    });\n  }\n\n  // Find all variable identifiers\n  traverseIcu({\n    icuString,\n    shouldVisit: isGTUnindexedSelectElement,\n    visitor,\n    options: {\n      recurseIntoVisited: false,\n      captureLocation: true,\n    },\n  });\n\n  // Construct output string\n  let previousIndex = 0;\n  const outputList = [];\n  for (let i = 0; i < variableLocations.length; i++) {\n    outputList.push(icuString.slice(previousIndex, variableLocations[i].start));\n    outputList.push(variableLocations[i].value);\n    previousIndex = variableLocations[i].end;\n  }\n  if (previousIndex < icuString.length) {\n    outputList.push(icuString.slice(previousIndex));\n  }\n  const outputString = outputList.join('');\n\n  return outputString;\n}\n","/**\n * Sanitizes string by escaping ICU syntax\n *\n * Sanitize arbitrary string so it does not break the following ICU message syntax:\n * {_gt_, select, other {string_here}}\n *\n * Escapes ICU special characters by:\n * 1. Doubling all single quotes (U+0027 ')\n * 2. Adding a single quote before the first special character ({}<>)\n * 3. Adding a single quote after the last special character ({}<>)\n */\nexport function sanitizeVar(string: string): string {\n  // First, double all single quotes (both ASCII and Unicode)\n  let result = string.replace(/'/g, \"''\");\n\n  // Find first and last positions of special characters\n  const specialChars = /[{}<>]/;\n  const firstSpecialIndex = result.search(specialChars);\n\n  if (firstSpecialIndex === -1) {\n    // No special characters, return with just doubled quotes\n    return result;\n  }\n\n  // Find last special character position\n  let lastSpecialIndex = -1;\n  for (let i = result.length - 1; i >= 0; i--) {\n    if (specialChars.test(result[i])) {\n      lastSpecialIndex = i;\n      break;\n    }\n  }\n\n  // Insert quotes around the special character region\n  result =\n    result.slice(0, firstSpecialIndex) +\n    \"'\" +\n    result.slice(firstSpecialIndex, lastSpecialIndex + 1) +\n    \"'\" +\n    result.slice(lastSpecialIndex + 1);\n\n  return result;\n}\n","import { VAR_IDENTIFIER, VAR_NAME_IDENTIFIER } from './utils/constants';\nimport { sanitizeVar } from './utils/sanitizeVar';\n\n/**\n * Mark as a non-translatable string. Use within a derive() call to mark content as not derivable (e.g., not possible to statically analyze).\n *\n * @example\n * function nonDerivableFunction() {\n *   return Math.random();\n * }\n *\n * function derivableFunction() {\n *   if (condition) {\n *     return declareVar(nonDerivableFunction())\n *   }\n *   return 'John Doe';\n * }\n *\n * const gt = useGT();\n * gt(`My name is ${derive(derivableFunction())}`);\n *\n * @param {string | number | boolean | null | undefined} variable - The variable to sanitize.\n * @param {Object} [options] - The options for the sanitization.\n * @param {string} [options.$name] - The name of the variable.\n * @returns {string} The sanitized value.\n */\nexport function declareVar(\n  variable: string | number | boolean | null | undefined,\n  options?: { $name?: string }\n): string {\n  // variable section\n  const sanitizedVariable = sanitizeVar(String(variable ?? ''));\n  const variableSection = ` other {${sanitizedVariable}}`;\n\n  // name section\n  let nameSection = '';\n  if (options?.$name) {\n    const sanitizedName = sanitizeVar(options.$name);\n    nameSection = ` ${VAR_NAME_IDENTIFIER} {${sanitizedName}}`;\n  }\n\n  // interpolate\n  return `{${VAR_IDENTIFIER}, select,${variableSection}${nameSection}}`;\n}\n","/**\n * derive() is a powerful but dangerous function which marks its argument as derivable (statically analyzable) for the compiler and CLI tool.\n *\n * This function is dangerous because it can cause the compiler and CLI tool to throw an error if the argument is not derivable.\n *\n * @example\n * ```jsx\n * function getSubject() {\n *   return (Math.random() > 0.5) ? \"Alice\" : \"Brian\";\n * }\n * ...\n * gt(`My name is ${derive(getSubject())}`);\n * ```\n *\n * @param {T extends string | boolean | number | null | undefined} content - Content to mark as derivable.\n * @returns content\n */\nexport function derive<T extends string | boolean | number | null | undefined>(\n  content: T\n): T {\n  return content;\n}\n\n/**\n * @deprecated Use derive() instead.\n *\n * declareStatic() is a powerful but dangerous function which marks its argument as derivable (statically analyzable) for the compiler and CLI tool.\n *\n * This function is dangerous because it can cause the compiler and CLI tool to throw an error if the argument is not derivable.\n *\n * @example\n * ```jsx\n * function getSubject() {\n *   return (Math.random() > 0.5) ? \"Alice\" : \"Brian\";\n * }\n * ...\n * gt(`My name is ${declareStatic(getSubject())}`);\n * ```\n *\n * @param {T extends string | boolean | number | null | undefined} content - Content to mark as derivable.\n * @returns content\n */\nexport const declareStatic = derive;\n","import { VAR_IDENTIFIER } from './utils/constants';\nimport { traverseIcu } from './utils/traverseIcu';\nimport { GTUnindexedSelectElement } from './utils/types';\nimport { isGTUnindexedSelectElement } from './utils/traverseHelpers';\nimport { IcuMessage } from '../types-dir/jsx/content';\n\ntype Location = {\n  start: number;\n  end: number;\n  otherStart: number;\n  otherEnd: number;\n};\n\n/**\n * Given an ICU string adds identifiers to each _gt_ placeholder\n * indexVars('Hello {_gt_} {_gt_} World') => 'Hello {_gt_1_} {_gt_2_} World'\n */\nexport function indexVars(icuString: IcuMessage): string {\n  // Check if the string contains _gt_\n  if (!icuString.includes(VAR_IDENTIFIER)) {\n    return icuString;\n  }\n\n  // Record the location of the variable\n  const variableLocations: Location[] = [];\n  function visitor(child: GTUnindexedSelectElement): void {\n    variableLocations.push({\n      start: child.location?.start.offset ?? 0,\n      end: child.location?.end.offset ?? 0,\n      otherStart: child.options.other.location?.start.offset ?? 0,\n      otherEnd: child.options.other.location?.end.offset ?? 0,\n    });\n  }\n\n  // Find all variable identifiers\n  traverseIcu({\n    icuString,\n    shouldVisit: isGTUnindexedSelectElement,\n    visitor,\n    options: { recurseIntoVisited: false, captureLocation: true },\n  });\n\n  // Index each variable and collapse the other option\n  const result = [];\n  let current = 0;\n  for (let i = 0; i < variableLocations.length; i++) {\n    const { start, end, otherStart, otherEnd } = variableLocations[i];\n    // Before the variable\n    result.push(icuString.slice(current, start));\n    // Replace the variable with the new identifier (+1 is for the curly brace)\n    result.push(icuString.slice(start, start + VAR_IDENTIFIER.length + 1));\n\n    // Add the new identifier\n    result.push(String(i + 1));\n    // After the variable\n    result.push(icuString.slice(start + VAR_IDENTIFIER.length + 1, otherStart));\n    // Before the other option\n    result.push('{}');\n    // The other option\n    result.push(icuString.slice(otherEnd, end));\n    current = end;\n  }\n  result.push(icuString.slice(current, icuString.length));\n\n  return result.join('');\n}\n","import { VAR_IDENTIFIER } from './utils/constants';\nimport { isGTUnindexedSelectElement } from './utils/traverseHelpers';\nimport { traverseIcu } from './utils/traverseIcu';\nimport { GTUnindexedSelectElement } from './utils/types';\n/**\n * Given an unindexed ICU string, extracts all the _gt_ variables and an indexed mapping of the variable to the values\n *\n * extractVars('Hello {_gt_, select, other {World}}') => { _gt_1: 'World' }\n *\n * @param {string} icuString - The ICU string to extract variables from.\n * @returns {Record<string, string>} A mapping of the variable to the value.\n */\nexport function extractVars(icuString: string): Record<string, string> {\n  // Check if the string contains _gt_\n  if (!icuString.includes(VAR_IDENTIFIER)) {\n    return {};\n  }\n\n  // Extract all the _gt_# variables\n  let index = 1;\n  const variables: Record<string, string> = {};\n  function visitor(child: GTUnindexedSelectElement): void {\n    variables[child.value + index] = child.options.other.value.length\n      ? child.options.other.value[0]?.value\n      : '';\n    index += 1;\n  }\n\n  traverseIcu({\n    icuString,\n    shouldVisit: isGTUnindexedSelectElement,\n    visitor,\n    options: { recurseIntoVisited: false },\n  });\n\n  return variables;\n}\n","import {\n  type ArgumentElement,\n  TYPE,\n} from '@formatjs/icu-messageformat-parser/types.js';\nimport { printAST } from '@formatjs/icu-messageformat-parser/printer.js';\nimport { traverseIcu } from './utils/traverseIcu';\nimport { VAR_IDENTIFIER } from './utils/constants';\nimport { GTIndexedSelectElement } from './utils/types';\nimport { isGTIndexedSelectElement } from './utils/traverseHelpers';\ninterface GTIndexedArgumentElement extends ArgumentElement {\n  value: `${typeof VAR_IDENTIFIER}${number}`;\n}\n\n/**\n * Given an indexed ICU string, condenses any select to an argument\n * indexVars('Hello {_gt_1, select, other {World}}') => 'Hello {_gt_1}'\n * @param {string} icuString - The ICU string to condense.\n * @returns {string} The condensed ICU string.\n */\nexport function condenseVars(icuString: string): string {\n  // Check if the string contains _gt_\n  if (!icuString.includes(VAR_IDENTIFIER)) {\n    return icuString;\n  }\n\n  // Replace with argument\n  function visitor(child: GTIndexedSelectElement): void {\n    (child as unknown as GTIndexedArgumentElement).type = TYPE.argument;\n    delete (child as any).options;\n  }\n\n  const ast = traverseIcu({\n    icuString,\n    shouldVisit: isGTIndexedSelectElement,\n    visitor,\n    options: { recurseIntoVisited: false },\n  });\n\n  // Serialize\n  return printAST(ast);\n}\n","import { JsxChild, JsxChildren } from '../types';\nimport {\n  OldJsxChild,\n  OldJsxChildren,\n  OldJsxElement,\n  OldVariableObject,\n} from './oldTypes.js';\nimport { Variable as VariableObject } from '../types';\n\n/**\n * Checks if a JSX child is an old variable object format\n * @param child - The JSX child to check\n * @returns True if the child is an old variable object (has 'key' property)\n */\nexport function isOldVariableObject(\n  child: OldJsxChild | JsxChild\n): child is OldVariableObject {\n  return typeof child === 'object' && child != null && 'key' in child;\n}\n\n/**\n * Checks if a JSX child is a new variable object format\n * @param child - The JSX child to check\n * @returns True if the child is a new variable object (has 'k' property)\n */\nexport function isNewVariableObject(\n  child: OldJsxChild | JsxChild\n): child is VariableObject {\n  return typeof child === 'object' && child != null && 'k' in child;\n}\n\n/**\n * Checks if a JSX child is an old JSX element format\n * @param child - The JSX child to check\n * @returns True if the child is an old JSX element (has 'type' and 'props' properties)\n */\nfunction isOldJsxElement(\n  child: OldJsxChild | JsxChild\n): child is OldJsxElement {\n  return (\n    typeof child === 'object' &&\n    child != null &&\n    'type' in child &&\n    'props' in child\n  );\n}\n\n/**\n * Checks if a JSX child follows the old format (string, old variable object, or old JSX element)\n * @param child - The JSX child to check\n * @returns True if the child is in the old format\n */\nfunction isOldJsxChild(child: OldJsxChild | JsxChild): child is OldJsxChild {\n  // string\n  if (typeof child === 'string') {\n    return true;\n  }\n\n  // variable object\n  if (isOldVariableObject(child)) {\n    return true;\n  }\n\n  // element\n  return isOldJsxElement(child);\n}\n\n/**\n * Checks if JSX children follow the old format\n * @param children - The JSX children to check (can be string, array, or single child)\n * @returns True if all children are in the old format\n */\nexport function isOldJsxChildren(\n  children: OldJsxChildren | JsxChildren\n): children is OldJsxChildren {\n  // string\n  if (typeof children === 'string') {\n    return true;\n  }\n\n  // array\n  if (Array.isArray(children)) {\n    return !children.some((child) => !isOldJsxChild(child));\n  }\n\n  // object\n  return isOldJsxChild(children);\n}\n","import { Variable as VariableObject, VariableType } from '../types';\nimport {\n  OldBranchType,\n  OldGTProp,\n  OldJsxChild,\n  OldJsxChildren,\n  OldJsxElement,\n  OldVariableObject,\n  OldVariableType,\n} from './oldTypes.js';\nimport { GTProp, JsxChild, JsxChildren, JsxElement } from '../types';\nimport {\n  isOldJsxChildren,\n  isNewVariableObject,\n  isOldVariableObject,\n} from './typeChecking';\n\n/**\n * Convert request data from old format to new format\n */\n\nexport function getNewJsxChild(child: OldJsxChild): JsxChild {\n  // string (end case)\n  if (typeof child === 'string') {\n    return child;\n  }\n\n  // VariableObject\n  if (isOldVariableObject(child)) {\n    return getNewVariableObject(child);\n  }\n\n  // JsxElement\n  return getNewJsxElement(child);\n}\n\nexport function getNewJsxChildren(children: OldJsxChildren): JsxChildren {\n  // string (end case)\n  if (typeof children === 'string') {\n    return children;\n  }\n\n  // Array\n  if (Array.isArray(children)) {\n    return children.map(getNewJsxChild);\n  }\n\n  // Object\n  return getNewJsxChild(children);\n}\n\nexport function getNewJsxElement(element: OldJsxElement): JsxElement {\n  // string (end case)\n  if (typeof element === 'string') {\n    return element;\n  }\n\n  // type\n  let t: string | undefined = undefined;\n  if (element.type != null) {\n    t = element.type;\n  }\n  // children\n  let c: JsxChildren | undefined = undefined;\n  if (element.props?.children != null) {\n    c = getNewJsxChildren(element.props.children);\n  }\n  return {\n    ...(t && { t }),\n    ...(c && { c }),\n    d: getNewGTProp(element.props['data-_gt']),\n    i: element.props['data-_gt'].id,\n  };\n}\n\nexport function getNewBranchType(branch: OldBranchType): 'b' | 'p' {\n  if (branch === 'branch') {\n    return 'b';\n  }\n  return 'p';\n}\n\nexport function getNewVariableType(variable: OldVariableType): VariableType {\n  switch (variable) {\n    case 'number':\n      return 'n';\n    case 'variable':\n      return 'v';\n    case 'datetime':\n      return 'd';\n    case 'currency':\n      return 'c';\n    default:\n      return 'v';\n  }\n}\n\nexport function getNewVariableObject(\n  variable: OldVariableObject\n): VariableObject {\n  // variable type\n  let v: VariableType | undefined = undefined;\n  if (variable.variable != null) {\n    v = getNewVariableType(variable.variable);\n  }\n  // variable id\n  let i: number | undefined = undefined;\n  if (variable.id != null) {\n    i = variable.id;\n  }\n  return {\n    k: variable.key,\n    ...(v && { v }),\n    ...(i && { i }),\n  };\n}\n\nexport function getNewGTProp(dataGT: OldGTProp): GTProp {\n  // branches\n  let b: Record<string, JsxChildren> | undefined = undefined;\n  if (dataGT.branches) {\n    b = Object.fromEntries(\n      Object.entries(dataGT.branches).map(([key, value]) => [\n        key,\n        getNewJsxChildren(value),\n      ])\n    );\n  }\n  // transformation\n  let t: 'b' | 'p' | undefined;\n  if (dataGT.transformation) {\n    t = getNewBranchType(dataGT.transformation);\n  }\n  return { ...(b && { b }), ...(t && { t }) };\n}\n\n/**\n * Convert response data from old format to new format\n */\n\nexport function getOldJsxChild(child: JsxChild): OldJsxChild {\n  // string (end case)\n  if (typeof child === 'string') {\n    return child;\n  }\n\n  // VariableObject\n  if (isNewVariableObject(child)) {\n    return getOldVariableObject(child);\n  }\n\n  // JsxElement\n  return getOldJsxElement(child);\n}\n\nexport function getOldJsxChildren(\n  children: JsxChildren | OldJsxChildren\n): OldJsxChildren {\n  // if children is already old, return it\n  if (isOldJsxChildren(children)) {\n    return children;\n  }\n\n  // string (end case)\n  if (typeof children === 'string') {\n    return children;\n  }\n\n  // Array\n  if (Array.isArray(children)) {\n    return children.map(getOldJsxChild);\n  }\n\n  // Object\n  return getOldJsxChild(children);\n}\n\nexport function getOldJsxElement(element: JsxElement): OldJsxElement {\n  // type (can assume that type will exist here)\n  const type: string = element.t as string;\n  // children\n  let children: OldJsxChildren | undefined = undefined;\n  if (element.c != null) {\n    children = getOldJsxChildren(element.c);\n  }\n  // data-_gt (can assume id will exist here)\n  const dataGT: OldGTProp = getOldGTProp(element.d || {}, element.i as number);\n  return {\n    type,\n    props: { children, 'data-_gt': dataGT },\n  };\n}\n\nexport function getOldBranchType(branch: 'b' | 'p'): OldBranchType {\n  if (branch === 'b') {\n    return 'branch';\n  }\n  return 'plural';\n}\n\nexport function getOldVariableType(variable: VariableType): OldVariableType {\n  switch (variable) {\n    case 'n':\n      return 'number';\n    case 'v':\n      return 'variable';\n    case 'd':\n      return 'datetime';\n    case 'c':\n      return 'currency';\n    default:\n      return 'variable';\n  }\n}\n\nexport function getOldVariableObject(\n  variable: VariableObject\n): OldVariableObject {\n  // variable type\n  let v: OldVariableType | undefined = undefined;\n  if (variable.v != null) {\n    v = getOldVariableType(variable.v);\n  }\n  // variable id\n  let i: number | undefined = undefined;\n  if (variable.i != null) {\n    i = variable.i;\n  }\n  return {\n    key: variable.k,\n    ...(v && { variable: v }),\n    ...(i && { id: i }),\n  };\n}\n\nexport function getOldGTProp(dataGT: GTProp, i: number): OldGTProp {\n  // transformation\n  let transformation: OldBranchType | undefined = undefined;\n  if (dataGT.t != null) {\n    transformation = getOldBranchType(dataGT.t);\n  }\n  // branches\n  let branches: Record<string, OldJsxChildren> | undefined = undefined;\n  if (dataGT.b != null) {\n    branches = Object.fromEntries(\n      Object.entries(dataGT.b).map(([key, value]) => [\n        key,\n        getOldJsxChildren(value),\n      ])\n    );\n  }\n  return {\n    id: i,\n    ...(transformation && { transformation }),\n    ...(branches && { branches }),\n  };\n}\n","// Functions provided to other GT libraries\n\nimport { OldJsxChild, OldJsxChildren, OldVariableObject } from './oldTypes';\nimport { stableStringify as stringify } from '../utils/stableStringify';\nimport { sha256 } from '@noble/hashes/sha2.js';\nimport { bytesToHex, utf8ToBytes } from '@noble/hashes/utils.js';\n\n// ----- FUNCTIONS ----- //\n/**\n * Calculates a unique hash for a given string using sha256.\n *\n * @param {string} string - The string to be hashed.\n * @returns {string} - The resulting hash as a hexadecimal string.\n */\nexport function oldHashString(string: string): string {\n  return bytesToHex(sha256(utf8ToBytes(string)));\n}\n\n/**\n * Calculates a unique ID for the given children objects by hashing their sanitized JSON string representation.\n *\n * @param {any} childrenAsObjects - The children objects to be hashed.\n * @param {string} context - The context for the children\n * @param {string} id - The id for the JSX Children object\n * @param {function} hashFunction custom hash function\n * @returns {string} - The unique has of the children.\n */\nexport function oldHashJsxChildren(\n  {\n    source,\n    context,\n    id,\n    dataFormat,\n  }: {\n    source: OldJsxChildren;\n    context?: string;\n    id?: string;\n    dataFormat: string;\n  },\n  hashFunction: (string: string) => string = oldHashString\n): string {\n  const unhashedKey = stringify({\n    source: sanitizeJsxChildren(source),\n    ...(id && { id }),\n    ...(context && { context }),\n    ...(dataFormat && { dataFormat }),\n  });\n  return hashFunction(unhashedKey);\n}\n\ntype SanitizedVariable = Omit<OldVariableObject, 'id'>;\n\ntype SanitizedElement = {\n  branches?: {\n    [k: string]: SanitizedChildren;\n  };\n  children?: SanitizedChildren;\n  transformation?: string;\n};\ntype SanitizedChild = SanitizedElement | SanitizedVariable | string;\ntype SanitizedChildren = SanitizedChild | SanitizedChild[];\n\nconst sanitizeChild = (child: OldJsxChild): SanitizedChild => {\n  if (child && typeof child === 'object') {\n    if ('props' in child) {\n      const newChild: SanitizedChild = {};\n      const dataGt = child?.props?.['data-_gt'];\n      if (dataGt?.branches) {\n        // The only thing that prevents sanitizeJsx from being stable is\n        // the order of the keys in the branches object.\n        // We don't sort them because stable-stringify sorts them anyways\n        newChild.branches = Object.fromEntries(\n          Object.entries(dataGt.branches).map(([key, value]) => [\n            key,\n            sanitizeJsxChildren(value as OldJsxChildren),\n          ])\n        );\n      }\n      if (child?.props?.children) {\n        newChild.children = sanitizeJsxChildren(child.props.children);\n      }\n      if (child?.props?.['data-_gt']?.transformation) {\n        newChild.transformation = child.props['data-_gt'].transformation;\n      }\n      return newChild;\n    }\n    if ('key' in child) {\n      return {\n        key: child.key,\n        ...(child.variable && {\n          variable: child.variable,\n        }),\n      };\n    }\n  }\n  return child as string;\n};\n\nfunction sanitizeJsxChildren(\n  childrenAsObjects: OldJsxChildren\n): SanitizedChildren {\n  return Array.isArray(childrenAsObjects)\n    ? childrenAsObjects.map(sanitizeChild)\n    : sanitizeChild(childrenAsObjects);\n}\n"],"mappings":";;;;;;;;AAAA,MAAa,cAAc;CACzB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,SAAgB,qBAAqB,MAAkC;AACrE,QAAO,YAAY,SAAS,KAAqC;;;;;;;;;;;ACFnE,SAAwB,eACtB,GACA,QAAsB,aACtB,UAAoB,CAAA,KAAsB,EACzB;CAEjB,MAAM,wBADcA,kBAAAA,UAAU,IAAI,eAAe,QACR,CAAC,OAAO,EAAE;CAEnD,MAAM,OAAO,KAAK,IAAI,EAAE;AAExB,KAAI,SAAS,KAAK,MAAM,SAAS,OAAO,CAAE,QAAO;AAEjD,KAAI,SAAS,GAAG;AACd,MAAI,MAAM,SAAS,WAAW,CAAE,QAAO;AACvC,MAAI,MAAM,SAAS,MAAM,CAAE,QAAO;;AAEpC,KAAI,0BAA0B,SAAS,MAAM,SAAS,WAAW,CAC/D,QAAO;AAET,KAAI,SAAS,GAAG;AACd,MAAI,MAAM,SAAS,OAAO,CAAE,QAAO;AACnC,MAAI,MAAM,SAAS,MAAM,CAAE,QAAO;;AAEpC,KAAI,0BAA0B,SAAS,MAAM,SAAS,OAAO,CAAE,QAAO;AAEtE,KAAI,MAAM,SAAS,sBAAsB,CAAE,QAAO;AAElD,KAAI,0BAA0B,SAAS,MAAM,SAAS,OAAO,CAAE,QAAO;AACtE,KAAI,0BAA0B,SAAS,MAAM,SAAS,SAAS,CAC7D,QAAO;AACT,KAAI,0BAA0B,SAAS,MAAM,SAAS,QAAQ,CAC5D,QAAO;AAET,KAAI,0BAA0B,SAAS,MAAM,SAAS,SAAS,CAC7D,QAAO;AACT,KAAI,0BAA0B,SAAS,MAAM,SAAS,QAAQ,CAC5D,QAAO;AAET,KAAI,0BAA0B,UAAU,MAAM,SAAS,SAAS,CAC9D,QAAO;AACT,KAAI,0BAA0B,UAAU,MAAM,SAAS,QAAQ,CAC7D,QAAO;AAET,KAAI,0BAA0B,WAAW,MAAM,SAAS,SAAS,CAC/D,QAAO;AACT,QAAO;;;;ACtDT,MAAM,qDAAqD;CACzD,UAAU;CACV,QAAQ;CACR,UAAU;CACV,UAAU;CACV,iBAAiB;CAClB;AAED,SAAgB,mBACd,cACc;AACd,QAAO,mDAAmD;;;;;;;;;;;;;ACO5D,SAAgB,YAA4C,EAC1D,WACA,aACA,SACA,SAAS,EAAE,qBAAqB,MAAM,GAAG,kBAMhB;CACzB,MAAM,OAAA,GAAA,mCAAA,OAAY,WAAW,aAAa;AAC1C,gBAAe,IAAI;AACnB,QAAO;CAEP,SAAS,eAAe,UAAwC;AAC9D,WAAS,IAAI,YAAY;;CAG3B,SAAS,YAAY,OAA6B;EAEhD,IAAI,UAAU;AACd,MAAI,YAAY,MAAM,EAAE;AACtB,WAAQ,MAAM;AACd,aAAU;;AAGZ,MAAI,CAAC,WAAW;OACV,MAAM,SAASC,mCAAAA,KAAK,UAAU,MAAM,SAASA,mCAAAA,KAAK,OACpD,QAAO,OAAO,MAAM,QAAQ,CACzB,KAAK,WAAW,OAAO,MAAM,CAC7B,IAAI,eAAe;YACb,MAAM,SAASA,mCAAAA,KAAK,IAC7B,gBAAe,MAAM,SAAS;;;;;;ACrDtC,MAAa,iBAAiB;AAC9B,MAAa,sBAAsB;;;ACEnC,MAAa,8BAA8B,IAAI,OAC7C,IAAI,eAAe,OACpB;AAED,MAAa,gCAAgC,IAAI,OAAO,IAAI,eAAe,GAAG;;;ACI9E,SAAgB,yBACd,OACiC;AACjC,QACE,MAAM,SAASC,4CAAAA,KAAK,UACpB,4BAA4B,KAAK,MAAM,MAAM,IAC7C,CAAC,CAAC,MAAM,QAAQ,UACf,MAAM,QAAQ,MAAM,MAAM,WAAW,KACnC,MAAM,QAAQ,MAAM,MAAM,SAAS,KAClC,MAAM,QAAQ,MAAM,MAAM,IAAI,SAASA,4CAAAA,KAAK;;AAKpD,SAAgB,2BACd,OACmC;AACnC,QACE,MAAM,SAASA,4CAAAA,KAAK,UACpB,8BAA8B,KAAK,MAAM,MAAM,IAC/C,CAAC,CAAC,MAAM,QAAQ,UACf,MAAM,QAAQ,MAAM,MAAM,WAAW,KACnC,MAAM,QAAQ,MAAM,MAAM,SAAS,KAClC,MAAM,QAAQ,MAAM,MAAM,IAAI,SAASA,4CAAAA,KAAK;;;;;;;;;;;;ACfpD,SAAgB,WAAW,WAA2B;AAEpD,KAAI,CAAC,UAAU,SAAA,OAAwB,CACrC,QAAO;CAIT,MAAM,oBAAgC,EAAE;CACxC,SAAS,QAAQ,OAAuC;AACtD,oBAAkB,KAAK;GACrB,OAAO,MAAM,UAAU,MAAM,UAAU;GACvC,KAAK,MAAM,UAAU,IAAI,UAAU;GACnC,OACE,MAAM,QAAQ,MAAM,MAAM,SAAS,IAC/B,MAAM,QAAQ,MAAM,MAAM,GAAG,QAC7B;GACP,CAAC;;AAIJ,aAAY;EACV;EACA,aAAa;EACb;EACA,SAAS;GACP,oBAAoB;GACpB,iBAAiB;GAClB;EACF,CAAC;CAGF,IAAI,gBAAgB;CACpB,MAAM,aAAa,EAAE;AACrB,MAAK,IAAI,IAAI,GAAG,IAAI,kBAAkB,QAAQ,KAAK;AACjD,aAAW,KAAK,UAAU,MAAM,eAAe,kBAAkB,GAAG,MAAM,CAAC;AAC3E,aAAW,KAAK,kBAAkB,GAAG,MAAM;AAC3C,kBAAgB,kBAAkB,GAAG;;AAEvC,KAAI,gBAAgB,UAAU,OAC5B,YAAW,KAAK,UAAU,MAAM,cAAc,CAAC;AAIjD,QAFqB,WAAW,KAAK,GAElB;;;;;;;;;;;;;;;ACnDrB,SAAgB,YAAY,QAAwB;CAElD,IAAI,SAAS,OAAO,QAAQ,MAAM,KAAK;CAGvC,MAAM,eAAe;CACrB,MAAM,oBAAoB,OAAO,OAAO,aAAa;AAErD,KAAI,sBAAsB,GAExB,QAAO;CAIT,IAAI,mBAAmB;AACvB,MAAK,IAAI,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,IACtC,KAAI,aAAa,KAAK,OAAO,GAAG,EAAE;AAChC,qBAAmB;AACnB;;AAKJ,UACE,OAAO,MAAM,GAAG,kBAAkB,GAClC,MACA,OAAO,MAAM,mBAAmB,mBAAmB,EAAE,GACrD,MACA,OAAO,MAAM,mBAAmB,EAAE;AAEpC,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;ACfT,SAAgB,WACd,UACA,SACQ;CAGR,MAAM,kBAAkB,WADE,YAAY,OAAO,YAAY,GAAG,CACR,CAAC;CAGrD,IAAI,cAAc;AAClB,KAAI,SAAS,MAEX,eAAc,IAAI,oBAAoB,IADhB,YAAY,QAAQ,MACa,CAAC;AAI1D,QAAO,IAAI,eAAe,WAAW,kBAAkB,YAAY;;;;;;;;;;;;;;;;;;;;;ACzBrE,SAAgB,OACd,SACG;AACH,QAAO;;;;;;;;;;;;;;;;;;;;;AAsBT,MAAa,gBAAgB;;;;;;;ACzB7B,SAAgB,UAAU,WAA+B;AAEvD,KAAI,CAAC,UAAU,SAAA,OAAwB,CACrC,QAAO;CAIT,MAAM,oBAAgC,EAAE;CACxC,SAAS,QAAQ,OAAuC;AACtD,oBAAkB,KAAK;GACrB,OAAO,MAAM,UAAU,MAAM,UAAU;GACvC,KAAK,MAAM,UAAU,IAAI,UAAU;GACnC,YAAY,MAAM,QAAQ,MAAM,UAAU,MAAM,UAAU;GAC1D,UAAU,MAAM,QAAQ,MAAM,UAAU,IAAI,UAAU;GACvD,CAAC;;AAIJ,aAAY;EACV;EACA,aAAa;EACb;EACA,SAAS;GAAE,oBAAoB;GAAO,iBAAiB;GAAM;EAC9D,CAAC;CAGF,MAAM,SAAS,EAAE;CACjB,IAAI,UAAU;AACd,MAAK,IAAI,IAAI,GAAG,IAAI,kBAAkB,QAAQ,KAAK;EACjD,MAAM,EAAE,OAAO,KAAK,YAAY,aAAa,kBAAkB;AAE/D,SAAO,KAAK,UAAU,MAAM,SAAS,MAAM,CAAC;AAE5C,SAAO,KAAK,UAAU,MAAM,OAAO,QAAQ,IAAwB,EAAE,CAAC;AAGtE,SAAO,KAAK,OAAO,IAAI,EAAE,CAAC;AAE1B,SAAO,KAAK,UAAU,MAAM,QAAQ,IAAwB,GAAG,WAAW,CAAC;AAE3E,SAAO,KAAK,KAAK;AAEjB,SAAO,KAAK,UAAU,MAAM,UAAU,IAAI,CAAC;AAC3C,YAAU;;AAEZ,QAAO,KAAK,UAAU,MAAM,SAAS,UAAU,OAAO,CAAC;AAEvD,QAAO,OAAO,KAAK,GAAG;;;;;;;;;;;;ACpDxB,SAAgB,YAAY,WAA2C;AAErE,KAAI,CAAC,UAAU,SAAA,OAAwB,CACrC,QAAO,EAAE;CAIX,IAAI,QAAQ;CACZ,MAAM,YAAoC,EAAE;CAC5C,SAAS,QAAQ,OAAuC;AACtD,YAAU,MAAM,QAAQ,SAAS,MAAM,QAAQ,MAAM,MAAM,SACvD,MAAM,QAAQ,MAAM,MAAM,IAAI,QAC9B;AACJ,WAAS;;AAGX,aAAY;EACV;EACA,aAAa;EACb;EACA,SAAS,EAAE,oBAAoB,OAAO;EACvC,CAAC;AAEF,QAAO;;;;;;;;;;AChBT,SAAgB,aAAa,WAA2B;AAEtD,KAAI,CAAC,UAAU,SAAA,OAAwB,CACrC,QAAO;CAIT,SAAS,QAAQ,OAAqC;AACnD,QAA8C,OAAOC,4CAAAA,KAAK;AAC3D,SAAQ,MAAc;;AAWxB,SAAA,GAAA,8CAAA,UARY,YAAY;EACtB;EACA,aAAa;EACb;EACA,SAAS,EAAE,oBAAoB,OAAO;EACvC,CAGkB,CAAC;;;;;;;;;ACzBtB,SAAgB,oBACd,OAC4B;AAC5B,QAAO,OAAO,UAAU,YAAY,SAAS,QAAQ,SAAS;;;;;;;AAQhE,SAAgB,oBACd,OACyB;AACzB,QAAO,OAAO,UAAU,YAAY,SAAS,QAAQ,OAAO;;;;;;;AAQ9D,SAAS,gBACP,OACwB;AACxB,QACE,OAAO,UAAU,YACjB,SAAS,QACT,UAAU,SACV,WAAW;;;;;;;AASf,SAAS,cAAc,OAAqD;AAE1E,KAAI,OAAO,UAAU,SACnB,QAAO;AAIT,KAAI,oBAAoB,MAAM,CAC5B,QAAO;AAIT,QAAO,gBAAgB,MAAM;;;;;;;AAQ/B,SAAgB,iBACd,UAC4B;AAE5B,KAAI,OAAO,aAAa,SACtB,QAAO;AAIT,KAAI,MAAM,QAAQ,SAAS,CACzB,QAAO,CAAC,SAAS,MAAM,UAAU,CAAC,cAAc,MAAM,CAAC;AAIzD,QAAO,cAAc,SAAS;;;;;;;ACjEhC,SAAgB,eAAe,OAA8B;AAE3D,KAAI,OAAO,UAAU,SACnB,QAAO;AAIT,KAAI,oBAAoB,MAAM,CAC5B,QAAO,qBAAqB,MAAM;AAIpC,QAAO,iBAAiB,MAAM;;AAGhC,SAAgB,kBAAkB,UAAuC;AAEvE,KAAI,OAAO,aAAa,SACtB,QAAO;AAIT,KAAI,MAAM,QAAQ,SAAS,CACzB,QAAO,SAAS,IAAI,eAAe;AAIrC,QAAO,eAAe,SAAS;;AAGjC,SAAgB,iBAAiB,SAAoC;AAEnE,KAAI,OAAO,YAAY,SACrB,QAAO;CAIT,IAAI,IAAwB,KAAA;AAC5B,KAAI,QAAQ,QAAQ,KAClB,KAAI,QAAQ;CAGd,IAAI,IAA6B,KAAA;AACjC,KAAI,QAAQ,OAAO,YAAY,KAC7B,KAAI,kBAAkB,QAAQ,MAAM,SAAS;AAE/C,QAAO;EACL,GAAI,KAAK,EAAE,GAAG;EACd,GAAI,KAAK,EAAE,GAAG;EACd,GAAG,aAAa,QAAQ,MAAM,YAAY;EAC1C,GAAG,QAAQ,MAAM,YAAY;EAC9B;;AAGH,SAAgB,iBAAiB,QAAkC;AACjE,KAAI,WAAW,SACb,QAAO;AAET,QAAO;;AAGT,SAAgB,mBAAmB,UAAyC;AAC1E,SAAQ,UAAR;EACE,KAAK,SACH,QAAO;EACT,KAAK,WACH,QAAO;EACT,KAAK,WACH,QAAO;EACT,KAAK,WACH,QAAO;EACT,QACE,QAAO;;;AAIb,SAAgB,qBACd,UACgB;CAEhB,IAAI,IAA8B,KAAA;AAClC,KAAI,SAAS,YAAY,KACvB,KAAI,mBAAmB,SAAS,SAAS;CAG3C,IAAI,IAAwB,KAAA;AAC5B,KAAI,SAAS,MAAM,KACjB,KAAI,SAAS;AAEf,QAAO;EACL,GAAG,SAAS;EACZ,GAAI,KAAK,EAAE,GAAG;EACd,GAAI,KAAK,EAAE,GAAG;EACf;;AAGH,SAAgB,aAAa,QAA2B;CAEtD,IAAI,IAA6C,KAAA;AACjD,KAAI,OAAO,SACT,KAAI,OAAO,YACT,OAAO,QAAQ,OAAO,SAAS,CAAC,KAAK,CAAC,KAAK,WAAW,CACpD,KACA,kBAAkB,MAAM,CACzB,CAAC,CACH;CAGH,IAAI;AACJ,KAAI,OAAO,eACT,KAAI,iBAAiB,OAAO,eAAe;AAE7C,QAAO;EAAE,GAAI,KAAK,EAAE,GAAG;EAAG,GAAI,KAAK,EAAE,GAAG;EAAG;;;;;AAO7C,SAAgB,eAAe,OAA8B;AAE3D,KAAI,OAAO,UAAU,SACnB,QAAO;AAIT,KAAI,oBAAoB,MAAM,CAC5B,QAAO,qBAAqB,MAAM;AAIpC,QAAO,iBAAiB,MAAM;;AAGhC,SAAgB,kBACd,UACgB;AAEhB,KAAI,iBAAiB,SAAS,CAC5B,QAAO;AAIT,KAAI,OAAO,aAAa,SACtB,QAAO;AAIT,KAAI,MAAM,QAAQ,SAAS,CACzB,QAAO,SAAS,IAAI,eAAe;AAIrC,QAAO,eAAe,SAAS;;AAGjC,SAAgB,iBAAiB,SAAoC;CAEnE,MAAM,OAAe,QAAQ;CAE7B,IAAI,WAAuC,KAAA;AAC3C,KAAI,QAAQ,KAAK,KACf,YAAW,kBAAkB,QAAQ,EAAE;CAGzC,MAAM,SAAoB,aAAa,QAAQ,KAAK,EAAE,EAAE,QAAQ,EAAY;AAC5E,QAAO;EACL;EACA,OAAO;GAAE;GAAU,YAAY;GAAQ;EACxC;;AAGH,SAAgB,iBAAiB,QAAkC;AACjE,KAAI,WAAW,IACb,QAAO;AAET,QAAO;;AAGT,SAAgB,mBAAmB,UAAyC;AAC1E,SAAQ,UAAR;EACE,KAAK,IACH,QAAO;EACT,KAAK,IACH,QAAO;EACT,KAAK,IACH,QAAO;EACT,KAAK,IACH,QAAO;EACT,QACE,QAAO;;;AAIb,SAAgB,qBACd,UACmB;CAEnB,IAAI,IAAiC,KAAA;AACrC,KAAI,SAAS,KAAK,KAChB,KAAI,mBAAmB,SAAS,EAAE;CAGpC,IAAI,IAAwB,KAAA;AAC5B,KAAI,SAAS,KAAK,KAChB,KAAI,SAAS;AAEf,QAAO;EACL,KAAK,SAAS;EACd,GAAI,KAAK,EAAE,UAAU,GAAG;EACxB,GAAI,KAAK,EAAE,IAAI,GAAG;EACnB;;AAGH,SAAgB,aAAa,QAAgB,GAAsB;CAEjE,IAAI,iBAA4C,KAAA;AAChD,KAAI,OAAO,KAAK,KACd,kBAAiB,iBAAiB,OAAO,EAAE;CAG7C,IAAI,WAAuD,KAAA;AAC3D,KAAI,OAAO,KAAK,KACd,YAAW,OAAO,YAChB,OAAO,QAAQ,OAAO,EAAE,CAAC,KAAK,CAAC,KAAK,WAAW,CAC7C,KACA,kBAAkB,MAAM,CACzB,CAAC,CACH;AAEH,QAAO;EACL,IAAI;EACJ,GAAI,kBAAkB,EAAE,gBAAgB;EACxC,GAAI,YAAY,EAAE,UAAU;EAC7B;;;;;;;;;;ACjPH,SAAgB,cAAc,QAAwB;AACpD,QAAOC,mBAAAA,WAAWC,mBAAAA,OAAOC,mBAAAA,YAAY,OAAO,CAAC,CAAC;;;;;;;;;;;AAYhD,SAAgB,mBACd,EACE,QACA,SACA,IACA,cAOF,eAA2C,eACnC;AAOR,QAAO,aANaC,mBAAAA,gBAAU;EAC5B,QAAQ,oBAAoB,OAAO;EACnC,GAAI,MAAM,EAAE,IAAI;EAChB,GAAI,WAAW,EAAE,SAAS;EAC1B,GAAI,cAAc,EAAE,YAAY;EACjC,CAC8B,CAAC;;AAelC,MAAM,iBAAiB,UAAuC;AAC5D,KAAI,SAAS,OAAO,UAAU,UAAU;AACtC,MAAI,WAAW,OAAO;GACpB,MAAM,WAA2B,EAAE;GACnC,MAAM,SAAS,OAAO,QAAQ;AAC9B,OAAI,QAAQ,SAIV,UAAS,WAAW,OAAO,YACzB,OAAO,QAAQ,OAAO,SAAS,CAAC,KAAK,CAAC,KAAK,WAAW,CACpD,KACA,oBAAoB,MAAwB,CAC7C,CAAC,CACH;AAEH,OAAI,OAAO,OAAO,SAChB,UAAS,WAAW,oBAAoB,MAAM,MAAM,SAAS;AAE/D,OAAI,OAAO,QAAQ,aAAa,eAC9B,UAAS,iBAAiB,MAAM,MAAM,YAAY;AAEpD,UAAO;;AAET,MAAI,SAAS,MACX,QAAO;GACL,KAAK,MAAM;GACX,GAAI,MAAM,YAAY,EACpB,UAAU,MAAM,UACjB;GACF;;AAGL,QAAO;;AAGT,SAAS,oBACP,mBACmB;AACnB,QAAO,MAAM,QAAQ,kBAAkB,GACnC,kBAAkB,IAAI,cAAc,GACpC,cAAc,kBAAkB"}
+{"version":3,"file":"internal.cjs","names":["intlCache","TYPE","TYPE","TYPE","bytesToHex","sha256","utf8ToBytes","stringify"],"sources":["../src/settings/plurals.ts","../src/locales/getPluralForm.ts","../src/utils/minify.ts","../src/derive/utils/traverseIcu.ts","../src/derive/utils/constants.ts","../src/derive/utils/regex.ts","../src/derive/utils/traverseHelpers.ts","../src/derive/decodeVars.ts","../src/derive/utils/sanitizeVar.ts","../src/derive/declareVar.ts","../src/derive/derive.ts","../src/derive/indexVars.ts","../src/derive/extractVars.ts","../src/derive/condenseVars.ts","../src/backwards-compatability/typeChecking.ts","../src/backwards-compatability/dataConversion.ts","../src/backwards-compatability/oldHashJsxChildren.ts"],"sourcesContent":["export const pluralForms = [\n  'singular',\n  'plural',\n  'dual',\n  'zero',\n  'one',\n  'two',\n  'few',\n  'many',\n  'other',\n] as const;\nexport type PluralType = (typeof pluralForms)[number];\nexport function isAcceptedPluralForm(form: string): form is PluralType {\n  return pluralForms.includes(form as (typeof pluralForms)[number]);\n}\n","import { intlCache } from '../cache/IntlCache';\nimport { pluralForms, PluralType } from '../settings/plurals';\nimport { libraryDefaultLocale } from '../settings/settings';\n\n/**\n * Given a number and a list of allowed plural forms, return the plural form that best fits the number.\n *\n * @param {number} n - The number to determine the plural form for.\n * @param {PluralType[]} forms - The allowed plural forms.\n * @returns {PluralType} The determined plural form, or an empty string if none fit.\n */\nexport default function _getPluralForm(\n  n: number,\n  forms: readonly PluralType[] = pluralForms,\n  locales: string[] = [libraryDefaultLocale]\n): PluralType | '' {\n  const pluralRules = intlCache.get('PluralRules', locales);\n  const provisionalBranchName = pluralRules.select(n);\n  // aliases\n  const absN = Math.abs(n);\n  // 0\n  if (absN === 0 && forms.includes('zero')) return 'zero'; // override\n  // 1\n  if (absN === 1) {\n    if (forms.includes('singular')) return 'singular'; // override\n    if (forms.includes('one')) return 'one'; // override\n  }\n  if (provisionalBranchName === 'one' && forms.includes('singular'))\n    return 'singular';\n  // 2\n  if (absN === 2) {\n    if (forms.includes('dual')) return 'dual'; // override\n    if (forms.includes('two')) return 'two'; // override\n  }\n  if (provisionalBranchName === 'two' && forms.includes('dual')) return 'dual';\n  // fallbacks\n  if (forms.includes(provisionalBranchName)) return provisionalBranchName;\n  // two\n  if (provisionalBranchName === 'two' && forms.includes('dual')) return 'dual';\n  if (provisionalBranchName === 'two' && forms.includes('plural'))\n    return 'plural';\n  if (provisionalBranchName === 'two' && forms.includes('other'))\n    return 'other';\n  // few\n  if (provisionalBranchName === 'few' && forms.includes('plural'))\n    return 'plural';\n  if (provisionalBranchName === 'few' && forms.includes('other'))\n    return 'other';\n  // many\n  if (provisionalBranchName === 'many' && forms.includes('plural'))\n    return 'plural';\n  if (provisionalBranchName === 'many' && forms.includes('other'))\n    return 'other';\n  // other\n  if (provisionalBranchName === 'other' && forms.includes('plural'))\n    return 'plural';\n  return '';\n}\n","import { VariableTransformationSuffix, VariableType } from '../types';\n\nconst VARIABLE_TRANSFORMATION_SUFFIXES_TO_MINIFIED_NAMES = {\n  variable: 'v',\n  number: 'n',\n  datetime: 'd',\n  currency: 'c',\n  'relative-time': 'rt',\n} as const;\n\nexport function minifyVariableType(\n  variableType: VariableTransformationSuffix\n): VariableType {\n  return VARIABLE_TRANSFORMATION_SUFFIXES_TO_MINIFIED_NAMES[variableType];\n}\n","import {\n  MessageFormatElement,\n  parse,\n  ParserOptions,\n  TYPE,\n} from '@formatjs/icu-messageformat-parser';\n\ntype TraverseIcuOptions = ParserOptions & {\n  recurseIntoVisited?: boolean;\n};\n\n/**\n * Given an ICU string, traverse the AST and call the visitor function for each element that matches the type T\n * @param icu - The ICU string to traverse\n * @param shouldVisit - A function that returns true if the element should be visited\n * @param visitor - A function that is called for each element that matches the type T\n * @returns The modified AST of the ICU string.\n *\n * @note This function is a heavy operation, use sparingly\n */\nexport function traverseIcu<T extends MessageFormatElement>({\n  icuString,\n  shouldVisit,\n  visitor,\n  options: { recurseIntoVisited = true, ...otherOptions },\n}: {\n  icuString: string;\n  shouldVisit: (element: MessageFormatElement) => element is T;\n  visitor: (element: T) => void;\n  options: TraverseIcuOptions;\n}): MessageFormatElement[] {\n  const ast = parse(icuString, otherOptions);\n  handleChildren(ast);\n  return ast;\n\n  function handleChildren(children: MessageFormatElement[]): void {\n    children.map(handleChild);\n  }\n\n  function handleChild(child: MessageFormatElement) {\n    // handle select var\n    let visited = false;\n    if (shouldVisit(child)) {\n      visitor(child);\n      visited = true;\n    }\n    // recurse on children\n    if (!visited || recurseIntoVisited) {\n      if (child.type === TYPE.select || child.type === TYPE.plural) {\n        Object.values(child.options)\n          .map((option) => option.value)\n          .map(handleChildren);\n      } else if (child.type === TYPE.tag) {\n        handleChildren(child.children);\n      }\n    }\n  }\n}\n","export const VAR_IDENTIFIER = '_gt_';\nexport const VAR_NAME_IDENTIFIER = '_gt_var_name';\n","import { VAR_IDENTIFIER } from './constants';\n\n// Regex  for _gt_# select\nexport const GT_INDEXED_IDENTIFIER_REGEX = new RegExp(\n  `^${VAR_IDENTIFIER}\\\\d+$`\n);\n\nexport const GT_UNINDEXED_IDENTIFIER_REGEX = new RegExp(`^${VAR_IDENTIFIER}$`);\n","import {\n  GT_INDEXED_IDENTIFIER_REGEX,\n  GT_UNINDEXED_IDENTIFIER_REGEX,\n} from './regex';\nimport { GTIndexedSelectElement, GTUnindexedSelectElement } from './types';\nimport {\n  type MessageFormatElement,\n  TYPE,\n} from '@formatjs/icu-messageformat-parser/types.js';\n\n// Visit any _gt_# select\nexport function isGTIndexedSelectElement(\n  child: MessageFormatElement\n): child is GTIndexedSelectElement {\n  return (\n    child.type === TYPE.select &&\n    GT_INDEXED_IDENTIFIER_REGEX.test(child.value) &&\n    !!child.options.other &&\n    (child.options.other.value.length === 0 ||\n      (child.options.other.value.length > 0 &&\n        child.options.other.value[0]?.type === TYPE.literal))\n  );\n}\n\n// Visit any _gt_ select\nexport function isGTUnindexedSelectElement(\n  child: MessageFormatElement\n): child is GTUnindexedSelectElement {\n  return (\n    child.type === TYPE.select &&\n    GT_UNINDEXED_IDENTIFIER_REGEX.test(child.value) &&\n    !!child.options.other &&\n    (child.options.other.value.length === 0 ||\n      (child.options.other.value.length > 0 &&\n        child.options.other.value[0]?.type === TYPE.literal))\n  );\n}\n","import { traverseIcu } from './utils/traverseIcu';\nimport { VAR_IDENTIFIER } from './utils/constants';\nimport { GTUnindexedSelectElement } from './utils/types';\nimport { isGTUnindexedSelectElement } from './utils/traverseHelpers';\n\ntype Location = {\n  start: number;\n  end: number;\n  value: string;\n};\n\n/**\n * Given an encoded ICU string, interpolate only _gt_ variables that have been marked with declareVar()\n * @example\n * const encodedIcu = \"Hi\" + declareVar(\"Brian\") + \", my name is {name}\"\n * // 'Hi {_gt_, select, other {Brian}}, my name is {name}'\n * decodeVars(encodedIcu)\n * // 'Hi Brian, my name is {name}'\n */\nexport function decodeVars(icuString: string): string {\n  // Check if the string contains _gt_\n  if (!icuString.includes(VAR_IDENTIFIER)) {\n    return icuString;\n  }\n\n  // Record the location of the variable\n  const variableLocations: Location[] = [];\n  function visitor(child: GTUnindexedSelectElement): void {\n    variableLocations.push({\n      start: child.location?.start.offset ?? 0,\n      end: child.location?.end.offset ?? 0,\n      value:\n        child.options.other.value.length > 0\n          ? child.options.other.value[0].value\n          : '',\n    });\n  }\n\n  // Find all variable identifiers.\n  traverseIcu({\n    icuString,\n    shouldVisit: isGTUnindexedSelectElement,\n    visitor,\n    options: {\n      recurseIntoVisited: false,\n      captureLocation: true,\n    },\n  });\n\n  // Construct output string\n  let previousIndex = 0;\n  const outputList = [];\n  for (let i = 0; i < variableLocations.length; i++) {\n    outputList.push(icuString.slice(previousIndex, variableLocations[i].start));\n    outputList.push(variableLocations[i].value);\n    previousIndex = variableLocations[i].end;\n  }\n  if (previousIndex < icuString.length) {\n    outputList.push(icuString.slice(previousIndex));\n  }\n  const outputString = outputList.join('');\n\n  return outputString;\n}\n","/**\n * Sanitizes string by escaping ICU syntax\n *\n * Sanitize arbitrary string so it does not break the following ICU message syntax:\n * {_gt_, select, other {string_here}}\n *\n * Escapes ICU special characters by:\n * 1. Doubling all single quotes (U+0027 ')\n * 2. Adding a single quote before the first special character ({}<>)\n * 3. Adding a single quote after the last special character ({}<>)\n */\nexport function sanitizeVar(string: string): string {\n  // First, double all single quotes (both ASCII and Unicode).\n  let result = string.replace(/'/g, \"''\");\n\n  // Find first and last positions of special characters\n  const specialChars = /[{}<>]/;\n  const firstSpecialIndex = result.search(specialChars);\n\n  if (firstSpecialIndex === -1) {\n    // No special characters; return with just doubled quotes.\n    return result;\n  }\n\n  // Find last special character position\n  let lastSpecialIndex = -1;\n  for (let i = result.length - 1; i >= 0; i--) {\n    if (specialChars.test(result[i])) {\n      lastSpecialIndex = i;\n      break;\n    }\n  }\n\n  // Insert quotes around the special character region.\n  result =\n    result.slice(0, firstSpecialIndex) +\n    \"'\" +\n    result.slice(firstSpecialIndex, lastSpecialIndex + 1) +\n    \"'\" +\n    result.slice(lastSpecialIndex + 1);\n\n  return result;\n}\n","import { VAR_IDENTIFIER, VAR_NAME_IDENTIFIER } from './utils/constants';\nimport { sanitizeVar } from './utils/sanitizeVar';\n\n/**\n * Mark as a non-translatable string. Use within a derive() call to mark content as not derivable (e.g., not possible to statically analyze).\n *\n * @example\n * function nonDerivableFunction() {\n *   return Math.random();\n * }\n *\n * function derivableFunction() {\n *   if (condition) {\n *     return declareVar(nonDerivableFunction())\n *   }\n *   return 'John Doe';\n * }\n *\n * const gt = useGT();\n * gt(`My name is ${derive(derivableFunction())}`);\n *\n * @param {string | number | boolean | null | undefined} variable - The variable to sanitize.\n * @param {Object} [options] - The options for the sanitization.\n * @param {string} [options.$name] - The name of the variable.\n * @returns {string} The sanitized value.\n */\nexport function declareVar(\n  variable: string | number | boolean | null | undefined,\n  options?: { $name?: string }\n): string {\n  // Variable section.\n  const sanitizedVariable = sanitizeVar(String(variable ?? ''));\n  const variableSection = ` other {${sanitizedVariable}}`;\n\n  // Name section.\n  let nameSection = '';\n  if (options?.$name) {\n    const sanitizedName = sanitizeVar(options.$name);\n    nameSection = ` ${VAR_NAME_IDENTIFIER} {${sanitizedName}}`;\n  }\n\n  // interpolate\n  return `{${VAR_IDENTIFIER}, select,${variableSection}${nameSection}}`;\n}\n","/**\n * Marks content as derivable by the GT compiler and CLI.\n *\n * Use `derive()` when a translation string or context needs content that is\n * computed from source code, but should still be discovered during extraction\n * instead of treated as a runtime interpolation variable. The CLI attempts to\n * resolve the derivable expression into every possible static value and\n * includes those values in the source content that gets translated.\n *\n * `derive()` returns its argument unchanged at runtime.\n *\n * Run `gt validate` after adding or changing `derive()` calls to verify that\n * each derivable expression can be resolved by the CLI before translating or\n * building.\n *\n * @example\n * ```jsx\n * function getSubject() {\n *   return (Math.random() > 0.5) ? \"Alice\" : \"Brian\";\n * }\n * ...\n * gt(`My name is ${derive(getSubject())}`);\n * ```\n *\n * @param {T extends string | boolean | number | null | undefined} content - Content to derive for translation extraction.\n * @returns {T} The same content, unchanged at runtime.\n */\nexport function derive<T extends string | boolean | number | null | undefined>(\n  content: T\n): T {\n  return content;\n}\n\n/**\n * @deprecated Use derive() instead.\n *\n * Marks content as derivable by the GT compiler and CLI.\n *\n * Use `derive()` instead of `declareStatic()` for new code. This alias is kept\n * for backwards compatibility and returns its argument unchanged at runtime.\n *\n * Run `gt validate` after adding or changing derived content to verify that\n * each derivable expression can be resolved by the CLI before translating or\n * building.\n *\n * @example\n * ```jsx\n * function getSubject() {\n *   return (Math.random() > 0.5) ? \"Alice\" : \"Brian\";\n * }\n * ...\n * gt(`My name is ${declareStatic(getSubject())}`);\n * ```\n *\n * @param {T extends string | boolean | number | null | undefined} content - Content to derive for translation extraction.\n * @returns {T} The same content, unchanged at runtime.\n */\nexport const declareStatic = derive;\n","import { VAR_IDENTIFIER } from './utils/constants';\nimport { traverseIcu } from './utils/traverseIcu';\nimport { GTUnindexedSelectElement } from './utils/types';\nimport { isGTUnindexedSelectElement } from './utils/traverseHelpers';\nimport { IcuMessage } from '../types-dir/jsx/content';\n\ntype Location = {\n  start: number;\n  end: number;\n  otherStart: number;\n  otherEnd: number;\n};\n\n/**\n * Given an ICU string adds identifiers to each _gt_ placeholder\n * indexVars('Hello {_gt_} {_gt_} World') => 'Hello {_gt_1_} {_gt_2_} World'\n */\nexport function indexVars(icuString: IcuMessage): string {\n  // Check if the string contains _gt_\n  if (!icuString.includes(VAR_IDENTIFIER)) {\n    return icuString;\n  }\n\n  // Record the location of the variable\n  const variableLocations: Location[] = [];\n  function visitor(child: GTUnindexedSelectElement): void {\n    variableLocations.push({\n      start: child.location?.start.offset ?? 0,\n      end: child.location?.end.offset ?? 0,\n      otherStart: child.options.other.location?.start.offset ?? 0,\n      otherEnd: child.options.other.location?.end.offset ?? 0,\n    });\n  }\n\n  // Find all variable identifiers.\n  traverseIcu({\n    icuString,\n    shouldVisit: isGTUnindexedSelectElement,\n    visitor,\n    options: { recurseIntoVisited: false, captureLocation: true },\n  });\n\n  // Index each variable and collapse the other option.\n  const result = [];\n  let current = 0;\n  for (let i = 0; i < variableLocations.length; i++) {\n    const { start, end, otherStart, otherEnd } = variableLocations[i];\n    // Before the variable\n    result.push(icuString.slice(current, start));\n    // Replace the variable with the new identifier (+1 is for the curly brace)\n    result.push(icuString.slice(start, start + VAR_IDENTIFIER.length + 1));\n\n    // Add the new identifier.\n    result.push(String(i + 1));\n    // After the variable\n    result.push(icuString.slice(start + VAR_IDENTIFIER.length + 1, otherStart));\n    // Before the other option\n    result.push('{}');\n    // The other option\n    result.push(icuString.slice(otherEnd, end));\n    current = end;\n  }\n  result.push(icuString.slice(current, icuString.length));\n\n  return result.join('');\n}\n","import { VAR_IDENTIFIER } from './utils/constants';\nimport { isGTUnindexedSelectElement } from './utils/traverseHelpers';\nimport { traverseIcu } from './utils/traverseIcu';\nimport { GTUnindexedSelectElement } from './utils/types';\n/**\n * Given an unindexed ICU string, extracts all the _gt_ variables and an indexed mapping of the variable to the values\n *\n * extractVars('Hello {_gt_, select, other {World}}') => { _gt_1: 'World' }\n *\n * @param {string} icuString - The ICU string to extract variables from.\n * @returns {Record<string, string>} A mapping of the variable to the value.\n */\nexport function extractVars(icuString: string): Record<string, string> {\n  // Check if the string contains _gt_\n  if (!icuString.includes(VAR_IDENTIFIER)) {\n    return {};\n  }\n\n  // Extract all the _gt_# variables\n  let index = 1;\n  const variables: Record<string, string> = {};\n  function visitor(child: GTUnindexedSelectElement): void {\n    variables[child.value + index] = child.options.other.value.length\n      ? child.options.other.value[0]?.value\n      : '';\n    index += 1;\n  }\n\n  traverseIcu({\n    icuString,\n    shouldVisit: isGTUnindexedSelectElement,\n    visitor,\n    options: { recurseIntoVisited: false },\n  });\n\n  return variables;\n}\n","import {\n  type ArgumentElement,\n  TYPE,\n} from '@formatjs/icu-messageformat-parser/types.js';\nimport { printAST } from '@formatjs/icu-messageformat-parser/printer.js';\nimport { traverseIcu } from './utils/traverseIcu';\nimport { VAR_IDENTIFIER } from './utils/constants';\nimport { GTIndexedSelectElement } from './utils/types';\nimport { isGTIndexedSelectElement } from './utils/traverseHelpers';\ninterface GTIndexedArgumentElement extends ArgumentElement {\n  value: `${typeof VAR_IDENTIFIER}${number}`;\n}\n\n/**\n * Given an indexed ICU string, condenses any select to an argument\n * indexVars('Hello {_gt_1, select, other {World}}') => 'Hello {_gt_1}'\n * @param {string} icuString - The ICU string to condense.\n * @returns {string} The condensed ICU string.\n */\nexport function condenseVars(icuString: string): string {\n  // Check if the string contains _gt_\n  if (!icuString.includes(VAR_IDENTIFIER)) {\n    return icuString;\n  }\n\n  // Replace with argument\n  function visitor(child: GTIndexedSelectElement): void {\n    (child as unknown as GTIndexedArgumentElement).type = TYPE.argument;\n    Reflect.deleteProperty(child, 'options');\n  }\n\n  const ast = traverseIcu({\n    icuString,\n    shouldVisit: isGTIndexedSelectElement,\n    visitor,\n    options: { recurseIntoVisited: false },\n  });\n\n  // Serialize\n  return printAST(ast);\n}\n","import { JsxChild, JsxChildren } from '../types';\nimport {\n  OldJsxChild,\n  OldJsxChildren,\n  OldJsxElement,\n  OldVariableObject,\n} from './oldTypes.js';\nimport { Variable as VariableObject } from '../types';\n\n/**\n * Checks if a JSX child is an old variable object format\n * @param child - The JSX child to check.\n * @returns True if the child is an old variable object (has 'key' property)\n */\nexport function isOldVariableObject(\n  child: OldJsxChild | JsxChild\n): child is OldVariableObject {\n  return typeof child === 'object' && child != null && 'key' in child;\n}\n\n/**\n * Checks if a JSX child is a new variable object format\n * @param child - The JSX child to check.\n * @returns True if the child is a new variable object (has 'k' property)\n */\nexport function isNewVariableObject(\n  child: OldJsxChild | JsxChild\n): child is VariableObject {\n  return typeof child === 'object' && child != null && 'k' in child;\n}\n\n/**\n * Checks if a JSX child is an old JSX element format\n * @param child - The JSX child to check.\n * @returns True if the child is an old JSX element (has 'type' and 'props' properties)\n */\nfunction isOldJsxElement(\n  child: OldJsxChild | JsxChild\n): child is OldJsxElement {\n  return (\n    typeof child === 'object' &&\n    child != null &&\n    'type' in child &&\n    'props' in child\n  );\n}\n\n/**\n * Checks if a JSX child follows the old format (string, old variable object, or old JSX element)\n * @param child - The JSX child to check.\n * @returns True if the child is in the old format.\n */\nfunction isOldJsxChild(child: OldJsxChild | JsxChild): child is OldJsxChild {\n  // string\n  if (typeof child === 'string') {\n    return true;\n  }\n\n  // variable object\n  if (isOldVariableObject(child)) {\n    return true;\n  }\n\n  // element\n  return isOldJsxElement(child);\n}\n\n/**\n * Checks if JSX children follow the old format\n * @param children - The JSX children to check (can be string, array, or single child)\n * @returns True if all children are in the old format.\n */\nexport function isOldJsxChildren(\n  children: OldJsxChildren | JsxChildren\n): children is OldJsxChildren {\n  // string\n  if (typeof children === 'string') {\n    return true;\n  }\n\n  // array\n  if (Array.isArray(children)) {\n    return !children.some((child) => !isOldJsxChild(child));\n  }\n\n  // object\n  return isOldJsxChild(children);\n}\n","import { Variable as VariableObject, VariableType } from '../types';\nimport {\n  OldBranchType,\n  OldGTProp,\n  OldJsxChild,\n  OldJsxChildren,\n  OldJsxElement,\n  OldVariableObject,\n  OldVariableType,\n} from './oldTypes.js';\nimport { GTProp, JsxChild, JsxChildren, JsxElement } from '../types';\nimport {\n  isOldJsxChildren,\n  isNewVariableObject,\n  isOldVariableObject,\n} from './typeChecking';\n\n/**\n * Convert request data from old format to new format\n */\n\nexport function getNewJsxChild(child: OldJsxChild): JsxChild {\n  // string (end case)\n  if (typeof child === 'string') {\n    return child;\n  }\n\n  // VariableObject\n  if (isOldVariableObject(child)) {\n    return getNewVariableObject(child);\n  }\n\n  // JsxElement\n  return getNewJsxElement(child);\n}\n\nexport function getNewJsxChildren(children: OldJsxChildren): JsxChildren {\n  // string (end case)\n  if (typeof children === 'string') {\n    return children;\n  }\n\n  // Array\n  if (Array.isArray(children)) {\n    return children.map(getNewJsxChild);\n  }\n\n  // Object\n  return getNewJsxChild(children);\n}\n\nexport function getNewJsxElement(element: OldJsxElement): JsxElement {\n  // string (end case)\n  if (typeof element === 'string') {\n    return element;\n  }\n\n  // type\n  let t: string | undefined = undefined;\n  if (element.type != null) {\n    t = element.type;\n  }\n  // children\n  let c: JsxChildren | undefined = undefined;\n  if (element.props?.children != null) {\n    c = getNewJsxChildren(element.props.children);\n  }\n  return {\n    ...(t && { t }),\n    ...(c && { c }),\n    d: getNewGTProp(element.props['data-_gt']),\n    i: element.props['data-_gt'].id,\n  };\n}\n\nexport function getNewBranchType(branch: OldBranchType): 'b' | 'p' {\n  if (branch === 'branch') {\n    return 'b';\n  }\n  return 'p';\n}\n\nexport function getNewVariableType(variable: OldVariableType): VariableType {\n  switch (variable) {\n    case 'number':\n      return 'n';\n    case 'variable':\n      return 'v';\n    case 'datetime':\n      return 'd';\n    case 'currency':\n      return 'c';\n    default:\n      return 'v';\n  }\n}\n\nexport function getNewVariableObject(\n  variable: OldVariableObject\n): VariableObject {\n  // variable type\n  let v: VariableType | undefined = undefined;\n  if (variable.variable != null) {\n    v = getNewVariableType(variable.variable);\n  }\n  // variable id\n  let i: number | undefined = undefined;\n  if (variable.id != null) {\n    i = variable.id;\n  }\n  return {\n    k: variable.key,\n    ...(v && { v }),\n    ...(i && { i }),\n  };\n}\n\nexport function getNewGTProp(dataGT: OldGTProp): GTProp {\n  // branches\n  let b: Record<string, JsxChildren> | undefined = undefined;\n  if (dataGT.branches) {\n    b = Object.fromEntries(\n      Object.entries(dataGT.branches).map(([key, value]) => [\n        key,\n        getNewJsxChildren(value),\n      ])\n    );\n  }\n  // transformation\n  let t: 'b' | 'p' | undefined;\n  if (dataGT.transformation) {\n    t = getNewBranchType(dataGT.transformation);\n  }\n  return { ...(b && { b }), ...(t && { t }) };\n}\n\n/**\n * Convert response data from current format to old format\n */\n\nexport function getOldJsxChild(child: JsxChild): OldJsxChild {\n  // string (end case)\n  if (typeof child === 'string') {\n    return child;\n  }\n\n  // VariableObject\n  if (isNewVariableObject(child)) {\n    return getOldVariableObject(child);\n  }\n\n  // JsxElement\n  return getOldJsxElement(child);\n}\n\nexport function getOldJsxChildren(\n  children: JsxChildren | OldJsxChildren\n): OldJsxChildren {\n  // if children is already old, return it\n  if (isOldJsxChildren(children)) {\n    return children;\n  }\n\n  // string (end case)\n  if (typeof children === 'string') {\n    return children;\n  }\n\n  // Array\n  if (Array.isArray(children)) {\n    return children.map(getOldJsxChild);\n  }\n\n  // Object\n  return getOldJsxChild(children);\n}\n\nexport function getOldJsxElement(element: JsxElement): OldJsxElement {\n  // type (can assume that type will exist here)\n  const type: string = element.t as string;\n  // children\n  let children: OldJsxChildren | undefined = undefined;\n  if (element.c != null) {\n    children = getOldJsxChildren(element.c);\n  }\n  // data-_gt (can assume id will exist here)\n  const dataGT: OldGTProp = getOldGTProp(element.d || {}, element.i as number);\n  return {\n    type,\n    props: { children, 'data-_gt': dataGT },\n  };\n}\n\nexport function getOldBranchType(branch: 'b' | 'p'): OldBranchType {\n  if (branch === 'b') {\n    return 'branch';\n  }\n  return 'plural';\n}\n\nexport function getOldVariableType(variable: VariableType): OldVariableType {\n  switch (variable) {\n    case 'n':\n      return 'number';\n    case 'v':\n      return 'variable';\n    case 'd':\n      return 'datetime';\n    case 'c':\n      return 'currency';\n    default:\n      return 'variable';\n  }\n}\n\nexport function getOldVariableObject(\n  variable: VariableObject\n): OldVariableObject {\n  // variable type\n  let v: OldVariableType | undefined = undefined;\n  if (variable.v != null) {\n    v = getOldVariableType(variable.v);\n  }\n  // variable id\n  let i: number | undefined = undefined;\n  if (variable.i != null) {\n    i = variable.i;\n  }\n  return {\n    key: variable.k,\n    ...(v && { variable: v }),\n    ...(i && { id: i }),\n  };\n}\n\nexport function getOldGTProp(dataGT: GTProp, i: number): OldGTProp {\n  // transformation\n  let transformation: OldBranchType | undefined = undefined;\n  if (dataGT.t != null) {\n    transformation = getOldBranchType(dataGT.t);\n  }\n  // branches\n  let branches: Record<string, OldJsxChildren> | undefined = undefined;\n  if (dataGT.b != null) {\n    branches = Object.fromEntries(\n      Object.entries(dataGT.b).map(([key, value]) => [\n        key,\n        getOldJsxChildren(value),\n      ])\n    );\n  }\n  return {\n    id: i,\n    ...(transformation && { transformation }),\n    ...(branches && { branches }),\n  };\n}\n","// Functions provided to other GT libraries\n\nimport { OldJsxChild, OldJsxChildren, OldVariableObject } from './oldTypes';\nimport { stableStringify as stringify } from '../utils/stableStringify';\nimport { sha256 } from '@noble/hashes/sha2.js';\nimport { bytesToHex, utf8ToBytes } from '@noble/hashes/utils.js';\n\n// ----- FUNCTIONS ----- //\n/**\n * Calculates a unique hash for a given string using SHA-256.\n *\n * @param {string} string - The string to be hashed.\n * @returns {string} The resulting hash as a hexadecimal string.\n */\nexport function oldHashString(string: string): string {\n  return bytesToHex(sha256(utf8ToBytes(string)));\n}\n\n/**\n * Calculates a unique ID for the given children objects by hashing their sanitized JSON string representation.\n *\n * @param {any} childrenAsObjects - The children objects to be hashed.\n * @param {string} context - The context for the children.\n * @param {string} id - The ID for the JSX children object.\n * @param {function} hashFunction - Custom hash function.\n * @returns {string} - The unique hash of the children.\n */\nexport function oldHashJsxChildren(\n  {\n    source,\n    context,\n    id,\n    dataFormat,\n  }: {\n    source: OldJsxChildren;\n    context?: string;\n    id?: string;\n    dataFormat: string;\n  },\n  hashFunction: (string: string) => string = oldHashString\n): string {\n  const unhashedKey = stringify({\n    source: sanitizeJsxChildren(source),\n    ...(id && { id }),\n    ...(context && { context }),\n    ...(dataFormat && { dataFormat }),\n  });\n  return hashFunction(unhashedKey);\n}\n\ntype SanitizedVariable = Omit<OldVariableObject, 'id'>;\n\ntype SanitizedElement = {\n  branches?: {\n    [k: string]: SanitizedChildren;\n  };\n  children?: SanitizedChildren;\n  transformation?: string;\n};\ntype SanitizedChild = SanitizedElement | SanitizedVariable | string;\ntype SanitizedChildren = SanitizedChild | SanitizedChild[];\n\nconst sanitizeChild = (child: OldJsxChild): SanitizedChild => {\n  if (child && typeof child === 'object') {\n    if ('props' in child) {\n      const newChild: SanitizedChild = {};\n      const dataGt = child?.props?.['data-_gt'];\n      if (dataGt?.branches) {\n        // The only thing that prevents sanitizeJsx from being stable is\n        // the order of the keys in the branches object.\n        // We don't sort them because stable-stringify sorts them anyways\n        newChild.branches = Object.fromEntries(\n          Object.entries(dataGt.branches).map(([key, value]) => [\n            key,\n            sanitizeJsxChildren(value as OldJsxChildren),\n          ])\n        );\n      }\n      if (child?.props?.children) {\n        newChild.children = sanitizeJsxChildren(child.props.children);\n      }\n      if (child?.props?.['data-_gt']?.transformation) {\n        newChild.transformation = child.props['data-_gt'].transformation;\n      }\n      return newChild;\n    }\n    if ('key' in child) {\n      return {\n        key: child.key,\n        ...(child.variable && {\n          variable: child.variable,\n        }),\n      };\n    }\n  }\n  return child as string;\n};\n\nfunction sanitizeJsxChildren(\n  childrenAsObjects: OldJsxChildren\n): SanitizedChildren {\n  return Array.isArray(childrenAsObjects)\n    ? childrenAsObjects.map(sanitizeChild)\n    : sanitizeChild(childrenAsObjects);\n}\n"],"mappings":"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"}

package/dist/internal.d.cts

@@ -1,4 +1,4 @@
-import { At as Variable, Ct as IcuMessage, Et as JsxElement, Mt as LocaleProperties, Q as FileFormat, Tt as JsxChildren, jt as VariableType, l as _Content, p as VariableTransformationSuffix, pt as RuntimeTranslateManyOptions, vt as GTProp, wt as JsxChild } from "./types-NKhpChvT.cjs";
+import { Dt as JsxChild, Et as IcuMessage, Ft as LocaleProperties, Nt as Variable, Ot as JsxChildren, Pt as VariableType, Q as FileFormat, gt as RuntimeTranslateManyOptions, kt as JsxElement, l as _Content, p as VariableTransformationSuffix, xt as GTProp } from "./types-Bf8_Apq_.cjs";
 
 //#region src/settings/settingsUrls.d.ts
 declare const defaultCacheUrl: "https://cdn.gtx.dev";
@@ -19,10 +19,10 @@ declare function isAcceptedPluralForm(form: string): form is PluralType;
  * Given a number and a list of allowed plural forms, return the plural form that best fits the number.
  *
  * @param {number} n - The number to determine the plural form for.
- * @param {locales[]} forms - The allowed plural forms.
+ * @param {PluralType[]} forms - The allowed plural forms.
  * @returns {PluralType} The determined plural form, or an empty string if none fit.
  */
-declare function _getPluralForm(n: number, forms?: PluralType[], locales?: string[]): PluralType | '';
+declare function _getPluralForm(n: number, forms?: readonly PluralType[], locales?: string[]): PluralType | '';
 //#endregion
 //#region src/utils/isVariable.d.ts
 declare function isVariable(obj: unknown): obj is Variable;
@@ -37,8 +37,8 @@ declare function decode(base64: string): string;
 //#region src/utils/isSupportedFileFormatTransform.d.ts
 /**
  * This function checks if a file format transformation is supported during translation
- * @param from - The source file format
- * @param to - The target file format
+ * @param from - The source file format.
+ * @param to - The target file format.
  * @returns True if the transformation is supported, false otherwise
  */
 declare function isSupportedFileFormatTransform(from: FileFormat, to: FileFormat): boolean;
@@ -96,9 +96,19 @@ declare function declareVar(variable: string | number | boolean | null | undefin
 //#endregion
 //#region src/derive/derive.d.ts
 /**
- * derive() is a powerful but dangerous function which marks its argument as derivable (statically analyzable) for the compiler and CLI tool.
+ * Marks content as derivable by the GT compiler and CLI.
  *
- * This function is dangerous because it can cause the compiler and CLI tool to throw an error if the argument is not derivable.
+ * Use `derive()` when a translation string or context needs content that is
+ * computed from source code, but should still be discovered during extraction
+ * instead of treated as a runtime interpolation variable. The CLI attempts to
+ * resolve the derivable expression into every possible static value and
+ * includes those values in the source content that gets translated.
+ *
+ * `derive()` returns its argument unchanged at runtime.
+ *
+ * Run `gt validate` after adding or changing `derive()` calls to verify that
+ * each derivable expression can be resolved by the CLI before translating or
+ * building.
  *
  * @example
  * ```jsx
@@ -109,16 +119,21 @@ declare function declareVar(variable: string | number | boolean | null | undefin
  * gt(`My name is ${derive(getSubject())}`);
  * ```
  *
- * @param {T extends string | boolean | number | null | undefined} content - Content to mark as derivable.
- * @returns content
+ * @param {T extends string | boolean | number | null | undefined} content - Content to derive for translation extraction.
+ * @returns {T} The same content, unchanged at runtime.
  */
 declare function derive<T extends string | boolean | number | null | undefined>(content: T): T;
 /**
  * @deprecated Use derive() instead.
  *
- * declareStatic() is a powerful but dangerous function which marks its argument as derivable (statically analyzable) for the compiler and CLI tool.
+ * Marks content as derivable by the GT compiler and CLI.
+ *
+ * Use `derive()` instead of `declareStatic()` for new code. This alias is kept
+ * for backwards compatibility and returns its argument unchanged at runtime.
  *
- * This function is dangerous because it can cause the compiler and CLI tool to throw an error if the argument is not derivable.
+ * Run `gt validate` after adding or changing derived content to verify that
+ * each derivable expression can be resolved by the CLI before translating or
+ * building.
  *
  * @example
  * ```jsx
@@ -129,8 +144,8 @@ declare function derive<T extends string | boolean | number | null | undefined>(
  * gt(`My name is ${declareStatic(getSubject())}`);
  * ```
  *
- * @param {T extends string | boolean | number | null | undefined} content - Content to mark as derivable.
- * @returns content
+ * @param {T extends string | boolean | number | null | undefined} content - Content to derive for translation extraction.
+ * @returns {T} The same content, unchanged at runtime.
  */
 declare const declareStatic: typeof derive;
 //#endregion
@@ -200,7 +215,7 @@ declare function getNewVariableType(variable: OldVariableType): VariableType;
 declare function getNewVariableObject(variable: OldVariableObject): Variable;
 declare function getNewGTProp(dataGT: OldGTProp): GTProp;
 /**
- * Convert response data from old format to new format
+ * Convert response data from current format to old format
  */
 declare function getOldJsxChild(child: JsxChild): OldJsxChild;
 declare function getOldJsxChildren(children: JsxChildren | OldJsxChildren): OldJsxChildren;
@@ -213,39 +228,39 @@ declare function getOldGTProp(dataGT: GTProp, i: number): OldGTProp;
 //#region src/backwards-compatability/typeChecking.d.ts
 /**
  * Checks if a JSX child is an old variable object format
- * @param child - The JSX child to check
+ * @param child - The JSX child to check.
  * @returns True if the child is an old variable object (has 'key' property)
  */
 declare function isOldVariableObject(child: OldJsxChild | JsxChild): child is OldVariableObject;
 /**
  * Checks if a JSX child is a new variable object format
- * @param child - The JSX child to check
+ * @param child - The JSX child to check.
  * @returns True if the child is a new variable object (has 'k' property)
  */
 declare function isNewVariableObject(child: OldJsxChild | JsxChild): child is Variable;
 /**
  * Checks if JSX children follow the old format
  * @param children - The JSX children to check (can be string, array, or single child)
- * @returns True if all children are in the old format
+ * @returns True if all children are in the old format.
  */
 declare function isOldJsxChildren(children: OldJsxChildren | JsxChildren): children is OldJsxChildren;
 //#endregion
 //#region src/backwards-compatability/oldHashJsxChildren.d.ts
 /**
- * Calculates a unique hash for a given string using sha256.
+ * Calculates a unique hash for a given string using SHA-256.
  *
  * @param {string} string - The string to be hashed.
- * @returns {string} - The resulting hash as a hexadecimal string.
+ * @returns {string} The resulting hash as a hexadecimal string.
  */
 declare function oldHashString(string: string): string;
 /**
  * Calculates a unique ID for the given children objects by hashing their sanitized JSON string representation.
  *
  * @param {any} childrenAsObjects - The children objects to be hashed.
- * @param {string} context - The context for the children
- * @param {string} id - The id for the JSX Children object
- * @param {function} hashFunction custom hash function
- * @returns {string} - The unique has of the children.
+ * @param {string} context - The context for the children.
+ * @param {string} id - The ID for the JSX children object.
+ * @param {function} hashFunction - Custom hash function.
+ * @returns {string} - The unique hash of the children.
  */
 declare function oldHashJsxChildren({
   source,