generaltranslation 9.0.2 → 9.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/dist/derive/condenseVars.js +2 -3
  3. package/dist/derive/utils/traverseHelpers.d.ts +1 -1
  4. package/dist/derive/utils/traverseHelpers.js +1 -1
  5. package/dist/derive/utils/traverseIcu.d.ts +1 -1
  6. package/dist/derive/utils/traverseIcu.js +1 -1
  7. package/dist/derive/utils/types.d.ts +1 -1
  8. package/dist/{derive-BvtWyo5B.cjs → derive-Cbl7M1SY.cjs} +7 -7
  9. package/dist/derive-Cbl7M1SY.cjs.map +1 -0
  10. package/dist/{derive-ClAsLQOX.mjs → derive-DDwuyrKI.mjs} +2 -2
  11. package/dist/derive-DDwuyrKI.mjs.map +1 -0
  12. package/dist/id.d.cts +1 -1
  13. package/dist/id.d.mts +1 -1
  14. package/dist/index.cjs +2 -2
  15. package/dist/index.d.cts +1 -1
  16. package/dist/index.d.mts +1 -1
  17. package/dist/index.mjs +2 -2
  18. package/dist/internal.cjs +4 -97
  19. package/dist/internal.cjs.map +1 -1
  20. package/dist/internal.d.cts +1 -1
  21. package/dist/internal.d.mts +1 -1
  22. package/dist/internal.mjs +3 -96
  23. package/dist/internal.mjs.map +1 -1
  24. package/dist/{runtime-WSpZppgm.mjs → runtime-DsKdTOSO.mjs} +2 -2
  25. package/dist/{runtime-WSpZppgm.mjs.map → runtime-DsKdTOSO.mjs.map} +1 -1
  26. package/dist/{runtime-wK7jzE9f.cjs → runtime-mKpF6P4Q.cjs} +2 -2
  27. package/dist/{runtime-wK7jzE9f.cjs.map → runtime-mKpF6P4Q.cjs.map} +1 -1
  28. package/dist/runtime.cjs +1 -1
  29. package/dist/runtime.d.cts +2 -2
  30. package/dist/runtime.d.mts +2 -2
  31. package/dist/runtime.d.ts +1 -1
  32. package/dist/runtime.js +3 -3
  33. package/dist/runtime.mjs +1 -1
  34. package/dist/types-dir/config.d.ts +60 -0
  35. package/dist/types-dir/config.js +1 -0
  36. package/dist/{types-CzFzXgUO.d.mts → types-iO493WgK.d.mts} +62 -3
  37. package/dist/{types-iLf0drw8.d.cts → types-wj-Dtih8.d.cts} +62 -3
  38. package/dist/types.d.cts +2 -2
  39. package/dist/types.d.mts +2 -2
  40. package/dist/types.d.ts +1 -0
  41. package/package.json +3 -4
  42. package/dist/derive/utils/printIcuAst.d.ts +0 -12
  43. package/dist/derive/utils/printIcuAst.js +0 -138
  44. package/dist/derive-BvtWyo5B.cjs.map +0 -1
  45. package/dist/derive-ClAsLQOX.mjs.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"internal.mjs","names":[],"sources":["../src/settings/plurals.ts","../src/locales/getPluralForm.ts","../src/utils/minify.ts","../src/derive/indexVars.ts","../src/derive/extractVars.ts","../src/derive/utils/printIcuAst.ts","../src/derive/condenseVars.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 { getCachedPluralRules } from '@generaltranslation/format/internal';\n\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 function _getPluralForm(\n n: number,\n forms: readonly PluralType[] = pluralForms,\n locales: string[] = [libraryDefaultLocale]\n): PluralType | '' {\n const pluralRules = getCachedPluralRules(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 { VAR_IDENTIFIER } from './utils/constants';\nimport { traverseIcu } from './utils/traverseIcu';\nimport { GTUnindexedSelectElement } from './utils/types';\nimport { isGTUnindexedSelectElement } from './utils/traverseHelpers';\nimport type { IcuMessage } from '@generaltranslation/format/types';\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","// The code in this file is adapted from the FormatJS printer,\n// https://github.com/formatjs/formatjs/blob/main/packages/icu-messageformat-parser/printer.ts\n// (published as `@formatjs/icu-messageformat-parser/printer.js`)\n// And is therefore MIT licensed\n\n/*!\nMIT License\n\nCopyright (c) 2023 FormatJS\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n*/\n\nimport { SKELETON_TYPE, TYPE } from '@formatjs/icu-messageformat-parser';\nimport type {\n DateElement,\n LiteralElement,\n MessageFormatElement,\n NumberElement,\n NumberSkeleton,\n PluralElement,\n SelectElement,\n TagElement,\n TimeElement,\n} from '@formatjs/icu-messageformat-parser';\n\ntype SimpleFormatStyle = NonNullable<\n (DateElement | TimeElement | NumberElement)['style']\n>;\n\n/**\n * Local copy of FormatJS `printAST` (see the license header above). The\n * published printer subpath is CommonJS-only, which browsers and Vite-based\n * dev servers (e.g. TanStack Start) cannot load from our ESM build, and the\n * package's ESM variant uses extensionless relative imports that fail Node\n * resolution.\n *\n * Output must stay byte-identical to FormatJS `printAST` because condensed\n * ICU strings feed into hashing.\n */\nexport function printIcuAst(ast: MessageFormatElement[]): string {\n return doPrintAst(ast, false);\n}\n\nfunction doPrintAst(ast: MessageFormatElement[], isInPlural: boolean): string {\n const printedNodes = ast.map((el, i) => {\n switch (el.type) {\n case TYPE.literal:\n return printLiteralElement(\n el,\n isInPlural,\n i === 0,\n i === ast.length - 1\n );\n case TYPE.argument:\n return `{${el.value}}`;\n case TYPE.date:\n case TYPE.time:\n case TYPE.number:\n return printSimpleFormatElement(el);\n case TYPE.plural:\n return printPluralElement(el);\n case TYPE.select:\n return printSelectElement(el);\n case TYPE.pound:\n return '#';\n case TYPE.tag:\n return printTagElement(el);\n }\n });\n return printedNodes.join('');\n}\n\nfunction printTagElement(el: TagElement): string {\n return `<${el.value}>${printIcuAst(el.children)}</${el.value}>`;\n}\n\nfunction printEscapedMessage(message: string): string {\n return message.replace(/([{}](?:[\\s\\S]*[{}])?)/, \"'$1'\");\n}\n\nfunction printLiteralElement(\n { value }: LiteralElement,\n isInPlural: boolean,\n isFirstEl: boolean,\n isLastEl: boolean\n): string {\n let escaped = value;\n // If this literal starts with a ' and it's not the 1st node, the node\n // before it is non-literal and the `'` needs to be re-escaped\n if (!isFirstEl && escaped[0] === \"'\") {\n escaped = `''${escaped.slice(1)}`;\n }\n // Same logic but for last el\n if (!isLastEl && escaped[escaped.length - 1] === \"'\") {\n escaped = `${escaped.slice(0, escaped.length - 1)}''`;\n }\n escaped = printEscapedMessage(escaped);\n // Upstream escapes only the first `#` (String#replace with a string\n // pattern); keep the quirk so output stays byte-identical\n return isInPlural ? escaped.replace('#', \"'#'\") : escaped;\n}\n\nfunction printSimpleFormatElement(\n el: DateElement | TimeElement | NumberElement\n): string {\n return `{${el.value}, ${TYPE[el.type]}${\n el.style ? `, ${printArgumentStyle(el.style)}` : ''\n }}`;\n}\n\nfunction printNumberSkeletonToken(\n token: NumberSkeleton['tokens'][number]\n): string {\n const { stem, options } = token;\n return options.length === 0\n ? stem\n : `${stem}${options.map((o) => `/${o}`).join('')}`;\n}\n\nfunction printArgumentStyle(style: SimpleFormatStyle): string {\n if (typeof style === 'string') {\n return printEscapedMessage(style);\n } else if (style.type === SKELETON_TYPE.dateTime) {\n return `::${style.pattern}`;\n } else {\n return `::${style.tokens.map(printNumberSkeletonToken).join(' ')}`;\n }\n}\n\nfunction printSelectElement(el: SelectElement): string {\n const msg = [\n el.value,\n 'select',\n Object.keys(el.options)\n .map((id) => `${id}{${doPrintAst(el.options[id].value, false)}}`)\n .join(' '),\n ].join(',');\n return `{${msg}}`;\n}\n\nfunction printPluralElement(el: PluralElement): string {\n const type = el.pluralType === 'cardinal' ? 'plural' : 'selectordinal';\n const msg = [\n el.value,\n type,\n [\n el.offset ? `offset:${el.offset}` : '',\n ...Object.keys(el.options).map(\n (id) => `${id}{${doPrintAst(el.options[id].value, true)}}`\n ),\n ]\n .filter(Boolean)\n .join(' '),\n ].join(',');\n return `{${msg}}`;\n}\n","import { TYPE } from '@formatjs/icu-messageformat-parser';\nimport type { ArgumentElement } from '@formatjs/icu-messageformat-parser/types.js';\nimport { printIcuAst } from './utils/printIcuAst';\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\nconst CONTAINS_INDEXED_GT_REGEX = new RegExp(`${VAR_IDENTIFIER}\\\\d+`);\n\n/**\n * Given an indexed ICU string, condenses any select to an argument\n * Unindexed _gt_ source strings and indexed _gt_# translation strings\n * are mutually exclusive.\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 an indexed _gt_ identifier.\n if (!CONTAINS_INDEXED_GT_REGEX.test(icuString)) {\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 printIcuAst(ast);\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"internal.mjs","names":[],"sources":["../src/settings/plurals.ts","../src/locales/getPluralForm.ts","../src/utils/minify.ts","../src/derive/indexVars.ts","../src/derive/extractVars.ts","../src/derive/condenseVars.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 { getCachedPluralRules } from '@generaltranslation/format/internal';\n\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 function _getPluralForm(\n n: number,\n forms: readonly PluralType[] = pluralForms,\n locales: string[] = [libraryDefaultLocale]\n): PluralType | '' {\n const pluralRules = getCachedPluralRules(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 { VAR_IDENTIFIER } from './utils/constants';\nimport { traverseIcu } from './utils/traverseIcu';\nimport { GTUnindexedSelectElement } from './utils/types';\nimport { isGTUnindexedSelectElement } from './utils/traverseHelpers';\nimport type { IcuMessage } from '@generaltranslation/format/types';\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 { printAST, TYPE, type ArgumentElement } from '@generaltranslation/icu';\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\nconst CONTAINS_INDEXED_GT_REGEX = new RegExp(`${VAR_IDENTIFIER}\\\\d+`);\n\n/**\n * Given an indexed ICU string, condenses any select to an argument\n * Unindexed _gt_ source strings and indexed _gt_# translation strings\n * are mutually exclusive.\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 an indexed _gt_ identifier.\n if (!CONTAINS_INDEXED_GT_REGEX.test(icuString)) {\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"],"mappings":"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"}
@@ -640,7 +640,7 @@ var GTRuntime = class {
640
640
  * Formats a message according to the specified locales and options.
641
641
  *
642
642
  * @param {string} message - The message to format.
643
- * @param {string | string[]} [locales='en'] - The locales to use for formatting.
643
+ * @param {string | string[]} [locales=libraryDefaultLocale] - The locales to use for formatting.
644
644
  * @param {FormatVariables} [variables={}] - The variables to use for formatting.
645
645
  * @param {StringFormat} [dataFormat='ICU'] - The format of the message.
646
646
  * @returns {string} The formatted message.
@@ -1043,4 +1043,4 @@ var GTRuntime = class {
1043
1043
  //#endregion
1044
1044
  export { validateResponse as a, noSourceLocaleProvidedError as c, handleFetchError as i, noTargetLocaleProvidedError as l, apiRequest as n, fetchWithTimeout as o, generateRequestHeaders as r, gtInstanceLogger as s, GTRuntime as t };
1045
1045
 
1046
- //# sourceMappingURL=runtime-WSpZppgm.mjs.map
1046
+ //# sourceMappingURL=runtime-DsKdTOSO.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"runtime-WSpZppgm.mjs","names":["_standardizeLocale","_isValidLocale","_getRegionProperties","_requiresTranslation","_determineLocale","_resolveCanonicalLocale","_resolveAliasLocale"],"sources":["../src/logging/errors.ts","../src/logging/logger.ts","../src/translate/utils/fetchWithTimeout.ts","../src/translate/utils/validateResponse.ts","../src/translate/utils/handleFetchError.ts","../src/translate/utils/generateRequestHeaders.ts","../src/translate/utils/apiRequest.ts","../src/translate/translateMany.ts","../src/runtime.ts"],"sourcesContent":["import { createDiagnosticMessage } from './diagnostics';\n\nconst GT_SOURCE = 'GT';\n\nexport const translationTimeoutError = (timeout: number) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Translation request timed out after ${timeout}ms`,\n fix: 'Try again, or increase the request timeout if the source content is large',\n });\n\nexport const translationRequestFailedError = (error: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: 'Translation request could not be completed',\n fix: 'Check your network connection and translation credentials, then try again',\n details: error,\n });\n\nexport const apiError = (status: number, statusText: string, error: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `The translation API returned ${status} ${statusText}`,\n fix: 'Check the request configuration and try again',\n details: error,\n });\n\nexport const invalidAuthError = createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: 'Authentication failed',\n fix: 'Check that your API key and project ID are correct',\n});\n\nexport const noTargetLocaleProvidedError = (functionName: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Cannot call \\`${functionName}\\` without a specified locale`,\n fix: `Pass a locale to \\`${functionName}\\` or specify targetLocale in the GT constructor`,\n });\n\nexport const noSourceLocaleProvidedError = (functionName: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Cannot call \\`${functionName}\\` without a specified locale`,\n fix: `Pass a locale to \\`${functionName}\\` or specify sourceLocale in the GT constructor`,\n });\n\nexport const noProjectIdProvidedError = (functionName: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Cannot call \\`${functionName}\\` without a specified project ID`,\n fix: `Pass a project ID to \\`${functionName}\\` or specify projectId in the GT constructor`,\n });\n\nexport const noApiKeyProvidedError = (functionName: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Cannot call \\`${functionName}\\` without a specified API key`,\n fix: `Pass an API key to \\`${functionName}\\` or specify apiKey in the GT constructor`,\n });\n\nexport const invalidLocaleError = (locale: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Locale \"${locale}\" is not valid`,\n fix: 'Use a valid BCP 47 locale code or add a custom mapping',\n });\n\nexport const invalidLocalesError = (locales: string[]) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `These locales are not valid: ${locales.join(', ')}`,\n fix: 'Use valid BCP 47 locale codes or add custom mappings',\n });\n","/**\n * Comprehensive logging system for the General Translation library.\n * Provides structured logging with multiple levels and configurable output.\n */\n\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'off';\n\nexport type LogMetadataValue =\n | string\n | number\n | boolean\n | null\n | undefined\n | Date\n | Error\n | LogMetadataValue[]\n | { [key: string]: LogMetadataValue };\n\nexport type LogMetadata = Record<string, LogMetadataValue>;\n\nexport interface LogEntry {\n level: LogLevel;\n message: string;\n timestamp: Date;\n context?: string;\n metadata?: LogMetadata;\n}\n\nexport interface LoggerConfig {\n /** Minimum log level to output. */\n level: LogLevel;\n /** Whether to include timestamps in log output. */\n includeTimestamp: boolean;\n /** Whether to include context information. */\n includeContext: boolean;\n /** Custom prefix for all log messages. */\n prefix?: string;\n /** Whether to output to console (default: true) */\n enableConsole: boolean;\n /** Custom log handlers. */\n handlers?: LogHandler[];\n}\n\nexport interface LogHandler {\n handle(entry: LogEntry): void;\n}\n\nconst LOG_LEVELS: Record<LogLevel, number> = {\n debug: 0,\n info: 1,\n warn: 2,\n error: 3,\n off: 4,\n};\n\nconst LOG_COLORS: Record<LogLevel, string> = {\n debug: '\\x1b[36m', // Cyan\n info: '\\x1b[32m', // Green\n warn: '\\x1b[33m', // Yellow\n error: '\\x1b[31m', // Red\n off: '', // No color needed since 'off' level logs are never displayed\n};\n\nconst RESET_COLOR = '\\x1b[0m';\n\n/**\n * Get the configured log level from environment variable or default to 'warn'\n */\nfunction getConfiguredLogLevel(): LogLevel {\n if (typeof process !== 'undefined' && process.env?._GT_LOG_LEVEL) {\n const envLevel = process.env._GT_LOG_LEVEL.toLowerCase();\n if (envLevel in LOG_LEVELS) {\n return envLevel as LogLevel;\n }\n }\n return 'warn';\n}\n\n/**\n * Console log handler that outputs formatted messages to console\n */\nexport class ConsoleLogHandler implements LogHandler {\n private config: LoggerConfig;\n\n constructor(config: LoggerConfig) {\n this.config = config;\n }\n\n handle(entry: LogEntry): void {\n const parts: string[] = [];\n\n // Add timestamp if enabled\n if (this.config.includeTimestamp) {\n parts.push(`[${entry.timestamp.toISOString()}]`);\n }\n\n // Add level with color\n const colorCode = LOG_COLORS[entry.level];\n const levelText = `[${entry.level.toUpperCase()}]`;\n parts.push(`${colorCode}${levelText}${RESET_COLOR}`);\n\n // Add prefix if configured\n if (this.config.prefix) {\n parts.push(`[${this.config.prefix}]`);\n }\n\n // Add context if available and enabled.\n if (this.config.includeContext && entry.context) {\n parts.push(`[${entry.context}]`);\n }\n\n // Add the main message\n parts.push(entry.message);\n\n // Format metadata if available.\n if (entry.metadata && Object.keys(entry.metadata).length > 0) {\n parts.push(`\\n Metadata: ${JSON.stringify(entry.metadata, null, 2)}`);\n }\n\n const formattedMessage = parts.join(' ');\n\n // Output to appropriate console method based on level\n switch (entry.level) {\n case 'debug':\n // eslint-disable-next-line no-console\n console.debug(formattedMessage);\n break;\n case 'info':\n // eslint-disable-next-line no-console\n console.info(formattedMessage);\n break;\n case 'warn':\n console.warn(formattedMessage);\n break;\n case 'error':\n console.error(formattedMessage);\n break;\n }\n }\n}\n\n/**\n * Main Logger class providing structured logging capabilities.\n */\nexport class Logger {\n private config: LoggerConfig;\n private handlers: LogHandler[];\n\n constructor(config: Partial<LoggerConfig> = {}) {\n this.config = {\n level: getConfiguredLogLevel(),\n includeTimestamp: true,\n includeContext: true,\n enableConsole: true,\n handlers: [],\n ...config,\n };\n\n this.handlers = [...(this.config.handlers || [])];\n\n // Add console handler if enabled\n if (this.config.enableConsole) {\n this.handlers.push(new ConsoleLogHandler(this.config));\n }\n }\n\n /**\n * Add a custom log handler\n */\n addHandler(handler: LogHandler): void {\n this.handlers.push(handler);\n }\n\n /**\n * Remove a log handler\n */\n removeHandler(handler: LogHandler): void {\n const index = this.handlers.indexOf(handler);\n if (index > -1) {\n this.handlers.splice(index, 1);\n }\n }\n\n /**\n * Update logger configuration\n */\n configure(config: Partial<LoggerConfig>): void {\n this.config = { ...this.config, ...config };\n }\n\n /**\n * Check if a log level should be output based on current configuration\n */\n private shouldLog(level: LogLevel): boolean {\n return LOG_LEVELS[level] >= LOG_LEVELS[this.config.level];\n }\n\n /**\n * Internal logging method that creates log entries and passes them to handlers\n */\n private log(\n level: LogLevel,\n message: string,\n context?: string,\n metadata?: LogMetadata\n ): void {\n if (!this.shouldLog(level)) {\n return;\n }\n\n const entry: LogEntry = {\n level,\n message,\n timestamp: new Date(),\n context,\n metadata,\n };\n\n // Pass to all handlers\n this.handlers.forEach((handler) => {\n try {\n handler.handle(entry);\n } catch (error) {\n // Prevent logging errors from breaking the application\n console.error('Error in log handler:', error);\n }\n });\n }\n\n /**\n * Log a debug message\n * Used for detailed diagnostic information, typically of interest only when diagnosing problems\n */\n debug(message: string, context?: string, metadata?: LogMetadata): void {\n this.log('debug', message, context, metadata);\n }\n\n /**\n * Log an info message\n * Used for general information about application operation.\n */\n info(message: string, context?: string, metadata?: LogMetadata): void {\n this.log('info', message, context, metadata);\n }\n\n /**\n * Log a warning message\n * Used for potentially problematic situations that don't prevent operation\n */\n warn(message: string, context?: string, metadata?: LogMetadata): void {\n this.log('warn', message, context, metadata);\n }\n\n /**\n * Log an error message\n * Used for error events that might still allow the application to continue.\n */\n error(message: string, context?: string, metadata?: LogMetadata): void {\n this.log('error', message, context, metadata);\n }\n\n /**\n * Create a child logger with a specific context\n */\n child(context: string): ContextLogger {\n return new ContextLogger(this, context);\n }\n\n /**\n * Get current logger configuration\n */\n getConfig(): LoggerConfig {\n return { ...this.config };\n }\n}\n\n/**\n * Context logger that automatically includes context information.\n */\nexport class ContextLogger {\n private logger: Logger;\n private context: string;\n\n constructor(logger: Logger, context: string) {\n this.logger = logger;\n this.context = context;\n }\n\n debug(message: string, metadata?: LogMetadata): void {\n this.logger.debug(message, this.context, metadata);\n }\n\n info(message: string, metadata?: LogMetadata): void {\n this.logger.info(message, this.context, metadata);\n }\n\n warn(message: string, metadata?: LogMetadata): void {\n this.logger.warn(message, this.context, metadata);\n }\n\n error(message: string, metadata?: LogMetadata): void {\n this.logger.error(message, this.context, metadata);\n }\n\n child(childContext: string): ContextLogger {\n return new ContextLogger(this.logger, `${this.context}:${childContext}`);\n }\n}\n\n// Default logger instance.\nexport const defaultLogger = new Logger({\n level: getConfiguredLogLevel(),\n includeTimestamp: true,\n includeContext: true,\n prefix: 'GT',\n});\n\n// Convenience functions using the default logger.\nexport const debug = (\n message: string,\n context?: string,\n metadata?: LogMetadata\n) => defaultLogger.debug(message, context, metadata);\n\nexport const info = (\n message: string,\n context?: string,\n metadata?: LogMetadata\n) => defaultLogger.info(message, context, metadata);\n\nexport const warn = (\n message: string,\n context?: string,\n metadata?: LogMetadata\n) => defaultLogger.warn(message, context, metadata);\n\nexport const error = (\n message: string,\n context?: string,\n metadata?: LogMetadata\n) => defaultLogger.error(message, context, metadata);\n\n// Create context-specific loggers for different parts of the system\nexport const fetchLogger = defaultLogger.child('fetch');\nexport const gtInstanceLogger = defaultLogger.child('GT instance');\n\n// Export types and classes\nexport { Logger as GTLogger };\n","import { translationTimeoutError } from '../../logging/errors';\nimport { defaultTimeout } from '../../settings/settings';\n\n/**\n * @internal\n *\n * Wraps the fetch function with a timeout.\n *\n * @param url - The URL to fetch.\n * @param options - The options to pass to the fetch function.\n * @param timeout - The timeout in milliseconds.\n * @returns The response from the fetch function.\n */\nexport async function fetchWithTimeout(\n url: string | URL | globalThis.Request,\n options: RequestInit,\n timeout?: number\n) {\n const controller = new AbortController();\n const signal = controller.signal;\n\n timeout = timeout ? timeout : defaultTimeout;\n const timeoutId = timeout\n ? setTimeout(() => controller.abort(), timeout)\n : null;\n\n try {\n const response = await fetch(url, { ...options, signal });\n return response;\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n throw translationTimeoutError(timeout);\n }\n throw error;\n } finally {\n if (timeoutId) clearTimeout(timeoutId);\n }\n}\n","import { apiError } from '../../logging/errors';\nimport { ApiError } from '../../errors/ApiError';\n\nexport async function validateResponse(response: Response) {\n if (!response.ok) {\n let errorMsg = 'Unknown error';\n try {\n const text = await response.text();\n try {\n const errorJson = JSON.parse(text) as { error: string };\n errorMsg = errorJson.error;\n } catch {\n errorMsg = text || 'Unknown error';\n }\n } catch {\n // response.text() failed, keep 'Unknown error'\n }\n const errorMessage = apiError(\n response.status,\n response.statusText,\n errorMsg\n );\n const error = new ApiError(errorMessage, response.status, errorMsg);\n throw error;\n }\n}\n","import { fetchLogger } from '../../logging/logger';\nimport {\n translationRequestFailedError,\n translationTimeoutError,\n} from '../../logging/errors';\n\nexport function handleFetchError(error: unknown, timeout: number): never {\n if (error instanceof Error && error.name === 'AbortError') {\n const errorMessage = translationTimeoutError(timeout);\n fetchLogger.error(errorMessage);\n throw new Error(errorMessage);\n }\n const errorMessage = translationRequestFailedError(\n error instanceof Error ? error.message : String(error)\n );\n fetchLogger.error(errorMessage);\n throw error;\n}\n","import { TranslationRequestConfig } from '../../types';\nimport { API_VERSION } from '../api';\n\nexport function generateRequestHeaders(\n config: TranslationRequestConfig,\n excludeContentType = false\n) {\n const authHeaders: Record<string, string> = {\n ...(!excludeContentType && { 'Content-Type': 'application/json' }),\n 'gt-project-id': config.projectId,\n };\n\n if (config.apiKey) {\n authHeaders['Authorization'] = `Bearer ${config.apiKey}`;\n }\n\n authHeaders['gt-api-version'] = API_VERSION;\n\n return authHeaders;\n}\n","import { TranslationRequestConfig } from '../../types';\nimport { defaultBaseUrl } from '../../settings/settingsUrls';\nimport { defaultTimeout } from '../../settings/settings';\nimport { fetchWithTimeout } from './fetchWithTimeout';\nimport { validateResponse } from './validateResponse';\nimport { handleFetchError } from './handleFetchError';\nimport { generateRequestHeaders } from './generateRequestHeaders';\n\nconst MAX_RETRIES = 3;\nconst INITIAL_DELAY_MS = 500;\nconst RATE_LIMIT_RETRY_DELAY_MS = 60_000;\nconst MS_PER_SECOND = 1000;\n\ntype RetryPolicy = 'exponential' | 'linear' | 'none';\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nfunction getRetryDelay(policy: RetryPolicy, attempt: number): number {\n switch (policy) {\n case 'linear':\n return INITIAL_DELAY_MS * (attempt + 1);\n case 'exponential':\n return INITIAL_DELAY_MS * 2 ** attempt;\n default:\n return 0;\n }\n}\n\nfunction parseDelayMs(value: string | null): number | undefined {\n if (!value) {\n return undefined;\n }\n\n const seconds = Number(value.split(',')[0].split(';')[0].trim());\n if (!Number.isFinite(seconds) || seconds < 0) {\n return undefined;\n }\n\n return seconds * MS_PER_SECOND;\n}\n\nfunction parseRetryAfter(value: string | null): number | undefined {\n const delayMs = parseDelayMs(value);\n if (delayMs !== undefined) {\n return delayMs;\n }\n\n if (!value) {\n return undefined;\n }\n\n const retryDate = Date.parse(value);\n if (Number.isNaN(retryDate)) {\n return undefined;\n }\n\n return Math.max(retryDate - Date.now(), 0);\n}\n\nfunction getRateLimitRetryDelay(response: Response): number {\n return (\n parseRetryAfter(response.headers.get('Retry-After')) ??\n parseDelayMs(response.headers.get('RateLimit-Reset')) ??\n RATE_LIMIT_RETRY_DELAY_MS\n );\n}\n\nfunction getResponseRetryDelay(\n response: Response,\n policy: RetryPolicy,\n attempt: number\n): number {\n if (response.status === 429) {\n return getRateLimitRetryDelay(response);\n }\n\n return getRetryDelay(policy, attempt);\n}\n\n/**\n * @internal\n *\n * Makes an API request with automatic retry for 429 and 5XX errors.\n *\n * Encapsulates URL construction, fetch with timeout, error handling,\n * response validation, and JSON parsing.\n *\n * @param config - The configuration for the API call.\n * @param endpoint - The API endpoint path (e.g. '/v2/project/jobs/info')\n * @param options - Optional request options.\n * @returns The parsed JSON response.\n */\nexport async function apiRequest<T>(\n config: TranslationRequestConfig,\n endpoint: string,\n options?: {\n body?: unknown;\n timeout?: number;\n method?: 'GET' | 'POST';\n retryPolicy?: RetryPolicy;\n }\n): Promise<T> {\n const timeout = options?.timeout ?? defaultTimeout;\n const url = `${config.baseUrl || defaultBaseUrl}${endpoint}`;\n const method = options?.method ?? 'POST';\n const retryPolicy = options?.retryPolicy ?? 'exponential';\n const maxRetries = retryPolicy === 'none' ? 0 : MAX_RETRIES;\n\n const requestInit: RequestInit = {\n method,\n headers: generateRequestHeaders(config),\n };\n if (options?.body !== undefined) {\n requestInit.body = JSON.stringify(options.body);\n }\n\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\n let response: Response;\n try {\n response = await fetchWithTimeout(url, requestInit, timeout);\n } catch (error) {\n if (attempt < maxRetries) {\n await sleep(getRetryDelay(retryPolicy, attempt));\n continue;\n }\n handleFetchError(error, timeout);\n }\n\n // Retry on rate limits and 5XX server errors.\n if (\n (response!.status === 429 || response!.status >= 500) &&\n attempt < maxRetries\n ) {\n await sleep(getResponseRetryDelay(response!, retryPolicy, attempt));\n continue;\n }\n\n await validateResponse(response!);\n return (await response!.json()) as T;\n }\n\n throw new Error('Max retries exceeded');\n}\n","import {\n TranslationRequestConfig,\n TranslateManyResult,\n TranslationResult,\n} from '../types';\nimport { defaultRuntimeApiUrl } from '../settings/settingsUrls';\nimport {\n TranslateManyEntry,\n TranslateOptions,\n EntryMetadata,\n} from '../types-dir/api/entry';\nimport { apiRequest } from './utils/apiRequest';\nimport type { Content } from '@generaltranslation/format/types';\nimport { hashSource } from '../id';\n\n/**\n * @internal\n *\n * Translates multiple entries in a single API request for better performance.\n * This function batches multiple translation requests together and sends them\n * to the GT translation API in one call.\n *\n * @param requests - The entries to translate. Can be an array (entries are hashed and results returned in order) or a record keyed by hash (skips hash calculation, returns a record).\n * @param globalMetadata - The metadata for the translation.\n * @param config - The configuration for the translation.\n * @returns The results of the translation. An array if requests was an array, a record if requests was a record.\n */\nexport async function _translateMany<\n T extends TranslateManyEntry[] | Record<string, TranslateManyEntry>,\n>(\n requests: T,\n globalMetadata: {\n targetLocale: string;\n sourceLocale: string;\n } & TranslateOptions,\n config: TranslationRequestConfig,\n timeout?: number\n): Promise<\n T extends TranslateManyEntry[]\n ? TranslateManyResult\n : Record<string, TranslationResult>\n>;\nexport async function _translateMany(\n requests: TranslateManyEntry[] | Record<string, TranslateManyEntry>,\n globalMetadata: {\n targetLocale: string;\n sourceLocale: string;\n } & TranslateOptions,\n config: TranslationRequestConfig,\n timeout?: number\n): Promise<TranslateManyResult | Record<string, TranslationResult>> {\n const isArray = Array.isArray(requests);\n\n // normalize and map from requests to requests record\n const hashOrder: string[] | undefined = isArray ? [] : undefined;\n const requestsObject: Record<\n string,\n { source: Content; metadata?: EntryMetadata }\n > = {};\n\n const entries: [string | undefined, TranslateManyEntry][] = isArray\n ? requests.map((r) => [undefined, r])\n : Object.entries(requests);\n\n for (const [key, request] of entries) {\n const normalized =\n typeof request === 'string' ? { source: request } : request;\n const { source, metadata } = normalized;\n const hash =\n key ??\n metadata?.hash ??\n hashSource({\n source,\n ...(metadata?.context && { context: metadata.context }),\n ...(metadata?.maxChars != null && { maxChars: metadata.maxChars }),\n dataFormat: metadata?.dataFormat ?? 'STRING',\n });\n hashOrder?.push(hash);\n requestsObject[hash] = {\n source,\n metadata: metadata,\n };\n }\n\n const response = await apiRequest<Record<string, TranslationResult>>(\n { ...config, baseUrl: config.baseUrl || defaultRuntimeApiUrl },\n `/v2/translate`,\n {\n body: {\n requests: requestsObject,\n targetLocale: globalMetadata.targetLocale,\n sourceLocale: globalMetadata.sourceLocale,\n metadata: globalMetadata,\n },\n timeout: timeout,\n retryPolicy: 'none',\n }\n );\n\n // If input was an array, map the record response back to an array in input order\n if (hashOrder) {\n return hashOrder.map(\n (hash) =>\n response[hash] ?? {\n success: false,\n error: 'No translation returned',\n code: 500,\n }\n );\n }\n\n // If input was a record, return the record response directly\n return response;\n}\n","// `generaltranslation` language toolkit\n// © 2026, General Translation, Inc.\n\n// ----- IMPORTS ----- //\n\nimport {\n LocaleConfig,\n determineLocale as _determineLocale,\n getRegionProperties as _getRegionProperties,\n isValidLocale as _isValidLocale,\n requiresTranslation as _requiresTranslation,\n resolveAliasLocale as _resolveAliasLocale,\n resolveCanonicalLocale as _resolveCanonicalLocale,\n standardizeLocale as _standardizeLocale,\n} from '@generaltranslation/format';\nimport type {\n CustomMapping,\n CustomRegionMapping,\n CutoffFormatOptions,\n FormatVariables,\n LocaleProperties,\n StringFormat,\n} from '@generaltranslation/format/types';\nimport {\n TranslateManyResult,\n TranslationError,\n TranslationRequestConfig,\n TranslationResult,\n TranslateManyEntry,\n} from './types';\nimport { libraryDefaultLocale } from './settings/settings';\nimport {\n noSourceLocaleProvidedError,\n noTargetLocaleProvidedError,\n invalidLocaleError,\n invalidLocalesError,\n noProjectIdProvidedError,\n noApiKeyProvidedError,\n} from './logging/errors';\nimport { gtInstanceLogger } from './logging/logger';\nimport { _translateMany } from './translate/translateMany';\nimport { TranslateOptions } from './types-dir/api/entry';\n\n// ============================================================ //\n// Runtime Class //\n// ============================================================ //\n/**\n * Type representing the constructor parameters for the GT and GTRuntime classes.\n * @typedef {Object} GTConstructorParams\n * @property {string} [apiKey] - The API key for accessing the translation service\n * @property {string} [devApiKey] - The development API key for accessing the translation service\n * @property {string} [sourceLocale] - The default source locale for translations\n * @property {string} [targetLocale] - The default target locale for translations\n * @property {string[]} [locales] - Array of supported locales\n * @property {string} [projectId] - The project ID for the translation service\n * @property {string} [baseUrl] - The base URL for the translation service\n * @property {CustomMapping} [customMapping] - Custom mapping of locale codes to their names\n */\nexport type GTConstructorParams = {\n apiKey?: string;\n devApiKey?: string;\n sourceLocale?: string;\n targetLocale?: string;\n locales?: string[];\n projectId?: string;\n baseUrl?: string;\n customMapping?: CustomMapping;\n};\n\n/**\n * GTRuntime is the runtime core of the GT driver: locale management,\n * formatting, and runtime translation requests.\n *\n * Browser-facing SDK code constructs this class (via `generaltranslation/runtime`)\n * so production bundles do not ship the project/file management API client\n * that lives on the GT class exported from the main entry.\n *\n * @example\n * const gt = new GTRuntime({\n * sourceLocale: 'en-US',\n * targetLocale: 'es-ES',\n * locales: ['en-US', 'es-ES', 'fr-FR']\n * });\n */\nexport class GTRuntime {\n /** Base URL for the translation service API */\n baseUrl?: string;\n\n /** Project ID for the translation service */\n projectId?: string;\n\n /** API key for accessing the translation service */\n apiKey?: string;\n\n /** Development API key for accessing the translation service */\n devApiKey?: string;\n\n /** Source locale for translations */\n sourceLocale?: string;\n\n /** Target locale for translations */\n targetLocale?: string;\n\n /** Array of supported locales */\n locales?: string[];\n\n /** Custom mapping for locale codes to their names */\n customMapping?: CustomMapping;\n\n /** Lazily derived reverse custom mapping for alias locales */\n reverseCustomMapping?: Record<string, string>;\n\n /** Lazily derived custom mapping for regions */\n customRegionMapping?: CustomRegionMapping;\n\n /** Runtime-safe locale and formatting helpers (backing field) */\n private _localeConfig!: LocaleConfig;\n\n /** Runtime-safe locale and formatting helpers */\n get localeConfig() {\n return this._localeConfig;\n }\n\n /**\n * Constructs an instance of the GTRuntime class.\n *\n * @param {GTConstructorParams} [params] - The parameters for initializing the GTRuntime instance\n * @throws {Error} If an invalid locale is provided\n * @throws {Error} If any of the provided locales are invalid\n *\n * @example\n * const gt = new GTRuntime({\n * apiKey: 'your-api-key',\n * sourceLocale: 'en-US',\n * targetLocale: 'es-ES',\n * locales: ['en-US', 'es-ES', 'fr-FR']\n * });\n */\n constructor(params: GTConstructorParams = {}) {\n // Read environment\n if (typeof process !== 'undefined') {\n this.apiKey ||= process.env?.GT_API_KEY;\n this.devApiKey ||= process.env?.GT_DEV_API_KEY;\n this.projectId ||= process.env?.GT_PROJECT_ID;\n }\n // Set up config\n this.setConfig(params);\n }\n\n setConfig({\n apiKey,\n devApiKey,\n sourceLocale,\n targetLocale,\n locales,\n projectId,\n customMapping,\n baseUrl,\n }: GTConstructorParams) {\n // ----- Environment properties ----- //\n if (apiKey) this.apiKey = apiKey;\n if (devApiKey) this.devApiKey = devApiKey;\n if (projectId) this.projectId = projectId;\n\n // ----- Standardize locales ----- //\n\n // source locale\n if (sourceLocale) {\n this.sourceLocale = _standardizeLocale(sourceLocale);\n if (!_isValidLocale(this.sourceLocale, customMapping))\n throw new Error(invalidLocaleError(this.sourceLocale));\n }\n\n // target locale\n if (targetLocale) {\n this.targetLocale = _standardizeLocale(targetLocale);\n if (!_isValidLocale(this.targetLocale, customMapping))\n throw new Error(invalidLocaleError(this.targetLocale));\n }\n\n // locales\n if (locales) {\n const result: string[] = [];\n const invalidLocales: string[] = [];\n locales.forEach((locale) => {\n const standardizedLocale = _standardizeLocale(locale);\n if (_isValidLocale(standardizedLocale)) {\n result.push(standardizedLocale);\n } else {\n invalidLocales.push(locale);\n }\n });\n if (invalidLocales.length > 0) {\n throw new Error(invalidLocalesError(invalidLocales));\n }\n this.locales = result;\n }\n\n // ----- Other properties ----- //\n if (baseUrl) this.baseUrl = baseUrl;\n if (customMapping) {\n this.customMapping = customMapping;\n this.reverseCustomMapping = Object.fromEntries(\n Object.entries(customMapping)\n .filter(\n ([, value]) => value && typeof value === 'object' && 'code' in value\n )\n .map(([key, value]) => [(value as { code: string }).code, key])\n );\n }\n this._localeConfig = new LocaleConfig({\n defaultLocale: this.sourceLocale,\n locales: this.locales ?? [],\n customMapping: this.customMapping,\n });\n }\n\n // -------------- Private Methods -------------- //\n\n protected _getTranslationConfig(): TranslationRequestConfig {\n return {\n baseUrl: this.baseUrl,\n apiKey: this.apiKey || this.devApiKey,\n projectId: this.projectId || '',\n };\n }\n\n protected _validateAuth(functionName: string) {\n const errors: string[] = [];\n if (!this.apiKey && !this.devApiKey) {\n const error = noApiKeyProvidedError(functionName);\n errors.push(error);\n }\n if (!this.projectId) {\n const error = noProjectIdProvidedError(functionName);\n errors.push(error);\n }\n if (errors.length) {\n throw new Error(errors.join('\\n'));\n }\n }\n\n /**\n * Translates a single source string to the target locale.\n * Routes through {@link translateMany} under the hood.\n *\n * @param {string} source - The source string to translate.\n * @param {object} options - Translation options including targetLocale and optional entry metadata.\n * @returns {Promise<TranslationResult | TranslationError>} The translated content.\n *\n * @example\n * const result = await gt.translate('Hello, world!', { targetLocale: 'es' });\n *\n * @example\n * const result = await gt.translate('Hello, world!', {\n * targetLocale: 'es',\n * dataFormat: 'ICU',\n * context: 'A formal greeting',\n * });\n */\n async translate(\n source: TranslateManyEntry,\n options: string | TranslateOptions,\n timeout?: number\n ): Promise<TranslationResult | TranslationError> {\n // Normalize string shorthand to options object\n if (typeof options === 'string') {\n options = { targetLocale: options };\n }\n\n // Validation\n this._validateAuth('translate');\n\n // Require target locale\n let targetLocale = options?.targetLocale || this.targetLocale;\n if (!targetLocale) {\n const error = noTargetLocaleProvidedError('translate');\n gtInstanceLogger.error(error);\n throw new Error(error);\n }\n\n // Replace target locale with canonical locale\n targetLocale = this.resolveCanonicalLocale(targetLocale);\n\n const sourceLocale = this.resolveCanonicalLocale(\n options?.sourceLocale || this.sourceLocale || libraryDefaultLocale\n );\n\n // Request the translation.\n const results = await _translateMany(\n [source],\n {\n ...options,\n targetLocale,\n sourceLocale,\n },\n this._getTranslationConfig(),\n timeout\n );\n return results[0];\n }\n\n /**\n * Translates multiple source strings to the target locale.\n * Each entry can be a plain string or an object with source and metadata fields.\n *\n * @param {TranslateManyEntry[] | Record<string, TranslateManyEntry>} sources - The source entries to translate. Can be an array or a record keyed by hash.\n * @param {object} options - Translation options including targetLocale.\n * @returns {Promise<TranslateManyResult | Record<string, TranslationResult>>} The translated contents. An array if sources was an array, a record if sources was a record.\n *\n * @example\n * const result = await gt.translateMany(\n * ['Hello, world!', 'Goodbye, world!'],\n * { targetLocale: 'es' }\n * );\n *\n * @example\n * const result = await gt.translateMany(\n * [{ source: 'Hello, world!', dataFormat: 'ICU' }],\n * { targetLocale: 'es' }\n * );\n *\n * @example\n * const result = await gt.translateMany(\n * { 'my-hash': 'Hello, world!' },\n * { targetLocale: 'es' }\n * );\n */\n async translateMany(\n sources: TranslateManyEntry[],\n options: string | TranslateOptions,\n timeout?: number\n ): Promise<TranslateManyResult>;\n async translateMany(\n sources: Record<string, TranslateManyEntry>,\n options: string | TranslateOptions,\n timeout?: number\n ): Promise<Record<string, TranslationResult>>;\n async translateMany(\n sources: TranslateManyEntry[] | Record<string, TranslateManyEntry>,\n options: string | TranslateOptions,\n timeout?: number\n ): Promise<TranslateManyResult | Record<string, TranslationResult>> {\n // Normalize string shorthand to options object\n if (typeof options === 'string') {\n options = { targetLocale: options };\n }\n\n // Validation\n this._validateAuth('translateMany');\n\n // Require target locale\n let targetLocale = options?.targetLocale || this.targetLocale;\n if (!targetLocale) {\n const error = noTargetLocaleProvidedError('translateMany');\n gtInstanceLogger.error(error);\n throw new Error(error);\n }\n\n // Replace target locale with canonical locale\n targetLocale = this.resolveCanonicalLocale(targetLocale);\n\n const sourceLocale = this.resolveCanonicalLocale(\n options?.sourceLocale || this.sourceLocale || libraryDefaultLocale\n );\n\n // Request the translation.\n return await _translateMany(\n sources,\n {\n ...options,\n targetLocale,\n sourceLocale,\n },\n this._getTranslationConfig(),\n timeout\n );\n }\n\n // -------------- Formatting -------------- //\n\n /**\n * Formats a string with cutoff behavior, applying a terminator when the string exceeds the maximum character limit.\n *\n * This method uses the GT instance's rendering locales by default for locale-specific terminator selection,\n * but can be overridden with custom locales in the options.\n *\n * @param {string} value - The string value to format with cutoff behavior.\n * @param {Object} [options] - Configuration options for cutoff formatting.\n * @param {string | string[]} [options.locales] - The locales to use for terminator selection. Defaults to instance's rendering locales.\n * @param {number} [options.maxChars] - The maximum number of characters to display.\n * - Undefined values are treated as no cutoff.\n * - Negative values follow .slice() behavior and terminator will be added before the value.\n * - 0 will result in an empty string.\n * - If cutoff results in an empty string, no terminator is added.\n * @param {CutoffFormatStyle} [options.style='ellipsis'] - The style of the terminator.\n * @param {string} [options.terminator] - Optional override the terminator to use.\n * @param {string} [options.separator] - Optional override the separator to use between the terminator and the value.\n * - If no terminator is provided, then separator is ignored.\n * @returns {string} The formatted string with terminator applied if cutoff occurs.\n *\n * @example\n * const gt = new GTRuntime({ targetLocale: 'en-US' });\n * gt.formatCutoff('Hello, world!', { maxChars: 8 });\n * // Returns: 'Hello, w...'\n *\n * @example\n * gt.formatCutoff('Hello, world!', { maxChars: -3 });\n * // Returns: '...ld!'\n */\n formatCutoff(\n value: string,\n options?: {\n locales?: string | string[];\n } & CutoffFormatOptions\n ): string {\n return this.localeConfig.formatCutoff(value, this.targetLocale, options);\n }\n\n /**\n * Formats a message according to the specified locales and options.\n *\n * @param {string} message - The message to format.\n * @param {string | string[]} [locales='en'] - The locales to use for formatting.\n * @param {FormatVariables} [variables={}] - The variables to use for formatting.\n * @param {StringFormat} [dataFormat='ICU'] - The format of the message.\n * @returns {string} The formatted message.\n *\n * @example\n * gt.formatMessage('Hello {name}', { name: 'John' });\n * // Returns: \"Hello John\"\n *\n * gt.formatMessage('Hello {name}', { name: 'John' }, { locales: ['fr'] });\n * // Returns: \"Bonjour John\"\n */\n formatMessage(\n message: string,\n options?: {\n locales?: string | string[];\n variables?: FormatVariables;\n dataFormat?: StringFormat;\n }\n ): string {\n return this.localeConfig.formatMessage(message, this.targetLocale, options);\n }\n /**\n * Formats a number according to the specified locales and options.\n *\n * @param {number} number - The number to format.\n * @param {Object} [options] - Additional options for number formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.NumberFormatOptions} [options] - Additional Intl.NumberFormat options.\n * @returns {string} The formatted number.\n *\n * @example\n * gt.formatNum(1234.56, { style: 'currency', currency: 'USD' });\n * // Returns: \"$1,234.56\"\n */\n formatNum(\n number: number,\n options?: {\n locales?: string | string[];\n } & Intl.NumberFormatOptions\n ): string {\n return this.localeConfig.formatNum(number, this.targetLocale, options);\n }\n\n /**\n * Formats a date according to the specified locales and options.\n *\n * @param {Date} date - The date to format.\n * @param {Object} [options] - Additional options for date formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.DateTimeFormatOptions} [options] - Additional Intl.DateTimeFormat options.\n * @returns {string} The formatted date.\n *\n * @example\n * gt.formatDateTime(new Date(), { dateStyle: 'full', timeStyle: 'long' });\n * // Returns: \"Thursday, March 14, 2024 at 2:30:45 PM GMT-7\"\n */\n formatDateTime(\n date: Date,\n options?: {\n locales?: string | string[];\n } & Intl.DateTimeFormatOptions\n ): string {\n return this.localeConfig.formatDateTime(date, this.targetLocale, options);\n }\n\n /**\n * Formats a currency value according to the specified locales and options.\n *\n * @param {number} value - The currency value to format.\n * @param {string} currency - The currency code (e.g., 'USD', 'EUR')\n * @param {Object} [options] - Additional options for currency formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.NumberFormatOptions} [options] - Additional Intl.NumberFormat options.\n * @returns {string} The formatted currency value.\n *\n * @example\n * gt.formatCurrency(1234.56, 'USD', { style: 'currency' });\n * // Returns: \"$1,234.56\"\n */\n formatCurrency(\n value: number,\n currency: string,\n options?: {\n locales?: string | string[];\n } & Intl.NumberFormatOptions\n ): string {\n return this.localeConfig.formatCurrency(\n value,\n currency,\n this.targetLocale,\n options\n );\n }\n\n /**\n * Formats a list of items according to the specified locales and options.\n *\n * @param {Array<string | number>} array - The list of items to format.\n * @param {Object} [options] - Additional options for list formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.ListFormatOptions} [options] - Additional Intl.ListFormat options.\n * @returns {string} The formatted list.\n *\n * @example\n * gt.formatList(['apple', 'banana', 'orange'], { type: 'conjunction' });\n * // Returns: \"apple, banana, and orange\"\n */\n formatList(\n array: Array<string | number>,\n options?: {\n locales?: string | string[];\n } & Intl.ListFormatOptions\n ) {\n return this.localeConfig.formatList(array, this.targetLocale, options);\n }\n\n /**\n * Formats a list of items according to the specified locales and options.\n * @param {Array<T>} array - The list of items to format.\n * @param {Object} [options] - Additional options for list formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.ListFormatOptions} [options] - Additional Intl.ListFormat options.\n * @returns {Array<T | string>} The formatted list parts.\n *\n * @example\n * gt.formatListToParts(['apple', 42, { foo: 'bar' }], { type: 'conjunction', style: 'short', locales: ['en'] });\n * // Returns: ['apple', ', ', 42, ' and ', '{ foo: \"bar\" }']\n */\n formatListToParts<T>(\n array: Array<T>,\n options?: {\n locales?: string | string[];\n } & Intl.ListFormatOptions\n ): Array<T | string> {\n return this.localeConfig.formatListToParts<T>(\n array,\n this.targetLocale,\n options\n );\n }\n\n /**\n * Formats a relative time value according to the specified locales and options.\n *\n * @param {number} value - The relative time value to format.\n * @param {Intl.RelativeTimeFormatUnit} unit - The unit of time (e.g., 'second', 'minute', 'hour', 'day', 'week', 'month', 'year')\n * @param {Object} options - Additional options for relative time formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.RelativeTimeFormatOptions} [options] - Additional Intl.RelativeTimeFormat options.\n * @returns {string} The formatted relative time string.\n *\n * @example\n * gt.formatRelativeTime(-1, 'day', { locales: ['en-US'], numeric: 'auto' });\n * // Returns: \"yesterday\"\n */\n formatRelativeTime(\n value: number,\n unit: Intl.RelativeTimeFormatUnit,\n options?: {\n locales?: string | string[];\n } & Omit<Intl.RelativeTimeFormatOptions, 'locales'>\n ): string {\n return this.localeConfig.formatRelativeTime(\n value,\n unit,\n this.targetLocale,\n options\n );\n }\n\n /**\n * Formats a relative time string from a Date, automatically selecting the best unit.\n *\n * @param {Date} date - The date to format relative to now.\n * @param {Object} [options] - Additional options for relative time formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @returns {string} The formatted relative time string (e.g., \"2 hours ago\", \"in 3 days\")\n *\n * @example\n * gt.formatRelativeTimeFromDate(new Date(Date.now() - 3600000));\n * // Returns: \"1 hour ago\"\n */\n formatRelativeTimeFromDate(\n date: Date,\n options?: {\n locales?: string | string[];\n baseDate?: Date;\n } & Omit<Intl.RelativeTimeFormatOptions, 'locales'>\n ): string {\n return this.localeConfig.formatRelativeTimeFromDate(\n date,\n this.targetLocale,\n options\n );\n }\n\n // -------------- Locale Properties -------------- //\n\n /**\n * Retrieves the display name of a locale code using Intl.DisplayNames, returning an empty string if no name is found.\n *\n * @param {string} [locale=this.targetLocale] - A BCP-47 locale code.\n * @returns {string} The display name corresponding to the code.\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.getLocaleName('es-ES');\n * // Returns: \"Spanish (Spain)\"\n */\n getLocaleName(locale = this.targetLocale): string {\n if (!locale) throw new Error(noTargetLocaleProvidedError('getLocaleName'));\n return this.localeConfig.getLocaleName(locale);\n }\n\n /**\n * Retrieves an emoji based on a given locale code.\n * Uses the locale's region (if present) to select an emoji or falls back on default emojis.\n *\n * @param {string} [locale=this.targetLocale] - A BCP-47 locale code (e.g., 'en-US', 'fr-CA')\n * @returns {string} The emoji representing the locale or its region.\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.getLocaleEmoji('es-ES');\n * // Returns: \"🇪🇸\"\n */\n getLocaleEmoji(locale = this.targetLocale): string {\n if (!locale) throw new Error(noTargetLocaleProvidedError('getLocaleEmoji'));\n return this.localeConfig.getLocaleEmoji(locale);\n }\n\n /**\n * Generates linguistic details for a given locale code.\n *\n * This function returns information about the locale,\n * script, and region of a given language code both in a standard form and in a maximized form (with likely script and region).\n * The function provides these names in both your default language and native forms, and an associated emoji.\n *\n * @param {string} [locale=this.targetLocale] - The locale code to get properties for (e.g., \"de-AT\").\n * @returns {LocaleProperties} - An object containing detailed information about the locale.\n *\n * @property {string} code - The full locale code, e.g., \"de-AT\".\n * @property {string} name - Language name in the default display language, e.g., \"Austrian German\".\n * @property {string} nativeName - Language name in the locale's native language, e.g., \"Österreichisches Deutsch\".\n * @property {string} languageCode - The base language code, e.g., \"de\".\n * @property {string} languageName - The language name in the default display language, e.g., \"German\".\n * @property {string} nativeLanguageName - The language name in the native language, e.g., \"Deutsch\".\n * @property {string} nameWithRegionCode - Language name with region in the default language, e.g., \"German (AT)\".\n * @property {string} nativeNameWithRegionCode - Language name with region in the native language, e.g., \"Deutsch (AT)\".\n * @property {string} regionCode - The region code from maximization, e.g., \"AT\".\n * @property {string} regionName - The region name in the default display language, e.g., \"Austria\".\n * @property {string} nativeRegionName - The region name in the native language, e.g., \"Österreich\".\n * @property {string} scriptCode - The script code from maximization, e.g., \"Latn\".\n * @property {string} scriptName - The script name in the default display language, e.g., \"Latin\".\n * @property {string} nativeScriptName - The script name in the native language, e.g., \"Lateinisch\".\n * @property {string} maximizedCode - The maximized locale code, e.g., \"de-Latn-AT\".\n * @property {string} maximizedName - Maximized locale name with likely script in the default language, e.g., \"Austrian German (Latin)\".\n * @property {string} nativeMaximizedName - Maximized locale name in the native language, e.g., \"Österreichisches Deutsch (Lateinisch)\".\n * @property {string} minimizedCode - Minimized locale code, e.g., \"de-AT\" (or \"de\" for \"de-DE\").\n * @property {string} minimizedName - Minimized language name in the default language, e.g., \"Austrian German\".\n * @property {string} nativeMinimizedName - Minimized language name in the native language, e.g., \"Österreichisches Deutsch\".\n * @property {string} emoji - The emoji associated with the locale's region, if applicable.\n */\n getLocaleProperties(locale = this.targetLocale): LocaleProperties {\n if (!locale)\n throw new Error(noTargetLocaleProvidedError('getLocaleProperties'));\n return this.localeConfig.getLocaleProperties(locale);\n }\n\n /**\n * Retrieves multiple properties for a given region code, including:\n * - `code`: the original region code\n * - `name`: the localized display name\n * - `emoji`: the associated flag or symbol\n *\n * Behavior:\n * - Accepts ISO 3166-1 alpha-2 or UN M.49 region codes (e.g., `\"US\"`, `\"FR\"`, `\"419\"`).\n * - Uses the instance's `targetLocale` to localize the region name for the user.\n * - If `customMapping` contains a `name` or `emoji` for the region, those override the default values.\n * - Otherwise, uses `Intl.DisplayNames` to get the localized region name, falling back to `libraryDefaultLocale`.\n * - Falls back to the region code as `name` if display name resolution fails.\n * - Falls back to a default emoji if no emoji mapping is found in built-in data or `customMapping`.\n *\n * @param {string} [region=this.getLocaleProperties().regionCode] - The region code to look up (e.g., `\"US\"`, `\"GB\"`, `\"DE\"`).\n * @param {CustomRegionMapping} [customMapping] - Optional mapping of region codes to custom names and/or emojis.\n * @returns {{ code: string, name: string, emoji: string }} An object containing:\n * - `code`: the input region code\n * - `name`: the localized or custom region name\n * - `emoji`: the matching emoji flag or symbol\n *\n * @throws {Error} If no target locale is available to determine region properties.\n *\n * @example\n * const gt = new GTRuntime({ targetLocale: 'en-US' });\n * gt.getRegionProperties('US');\n * // => { code: 'US', name: 'United States', emoji: '🇺🇸' }\n *\n * @example\n * const gt = new GTRuntime({ targetLocale: 'fr-FR' });\n * gt.getRegionProperties('US');\n * // => { code: 'US', name: 'États-Unis', emoji: '🇺🇸' }\n *\n * @example\n * gt.getRegionProperties('US', { US: { name: 'USA', emoji: '🗽' } });\n * // => { code: 'US', name: 'USA', emoji: '🗽' }\n */\n getRegionProperties(\n region = this.getLocaleProperties().regionCode,\n customMapping?: CustomRegionMapping\n ): { code: string; name: string; emoji: string } {\n if (!customMapping) {\n if (this.customMapping && !this.customRegionMapping) {\n // Lazy derive custom region mapping from customMapping\n const customRegionMapping: CustomRegionMapping = {};\n for (const [locale, lp] of Object.entries(this.customMapping)) {\n if (\n lp &&\n typeof lp === 'object' &&\n lp.regionCode &&\n !customRegionMapping[lp.regionCode]\n ) {\n const { regionName: name, emoji } = lp;\n customRegionMapping[lp.regionCode] = {\n locale,\n ...(name && { name }),\n ...(emoji && { emoji }),\n };\n }\n }\n this.customRegionMapping = customRegionMapping;\n }\n customMapping = this.customRegionMapping;\n }\n return _getRegionProperties(\n region,\n this.targetLocale, // this.targetLocale because we want it in the user's language\n customMapping\n );\n }\n\n /**\n * Determines whether a translation is required based on the source and target locales.\n *\n * @param {string} [sourceLocale=this.sourceLocale] - The locale code for the original content.\n * @param {string} [targetLocale=this.targetLocale] - The locale code to translate into.\n * @param {string[]} [approvedLocales=this.locales] - Optional array of approved target locales.\n * @returns {boolean} True if translation is required, false otherwise\n * @throws {Error} If no source locale is provided.\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.requiresTranslation('en-US', 'es-ES');\n * // Returns: true\n */\n requiresTranslation(\n sourceLocale = this.sourceLocale,\n targetLocale = this.targetLocale,\n approvedLocales: string[] | undefined = this.locales,\n customMapping: CustomMapping | undefined = this.customMapping\n ): boolean {\n if (!sourceLocale)\n throw new Error(noSourceLocaleProvidedError('requiresTranslation'));\n if (!targetLocale)\n throw new Error(noTargetLocaleProvidedError('requiresTranslation'));\n if (customMapping === this.customMapping) {\n return this.localeConfig.requiresTranslation(\n targetLocale,\n sourceLocale,\n approvedLocales\n );\n }\n return _requiresTranslation(\n sourceLocale,\n targetLocale,\n approvedLocales,\n customMapping\n );\n }\n\n /**\n * Determines the best matching locale from the provided approved locales list.\n *\n * @param {string | string[]} locales - A single locale or array of locales in preference order.\n * @param {string[]} [approvedLocales=this.locales] - Array of approved locales in preference order.\n * @returns {string | undefined} The best matching locale, or undefined if no match is found.\n *\n * @example\n * gt.determineLocale(['fr-CA', 'fr-FR'], ['en-US', 'fr-FR', 'es-ES']);\n * // Returns: \"fr-FR\"\n */\n determineLocale(\n locales: string | string[],\n approvedLocales: string[] | undefined = this.locales || [],\n customMapping: CustomMapping | undefined = this.customMapping\n ): string | undefined {\n if (customMapping === this.customMapping) {\n return this.localeConfig.determineLocale(locales, approvedLocales ?? []);\n }\n return _determineLocale(locales, approvedLocales, customMapping);\n }\n\n /**\n * Gets the text direction for a given locale code.\n *\n * @param {string} [locale=this.targetLocale] - A BCP-47 locale code.\n * @returns {'ltr' | 'rtl'} 'rtl' if the locale is right-to-left; otherwise 'ltr'.\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.getLocaleDirection('ar-SA');\n * // Returns: \"rtl\"\n */\n getLocaleDirection(locale = this.targetLocale): 'ltr' | 'rtl' {\n if (!locale)\n throw new Error(noTargetLocaleProvidedError('getLocaleDirection'));\n return this.localeConfig.getLocaleDirection(locale);\n }\n\n /**\n * Checks if a given BCP 47 locale code is valid.\n *\n * @param {string} [locale=this.targetLocale] - The BCP 47 locale code to validate.\n * @param {CustomMapping} [customMapping=this.customMapping] - The custom mapping to use for validation.\n * @returns {boolean} True if the locale code is valid, false otherwise\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.isValidLocale('en-US');\n * // Returns: true\n */\n isValidLocale(\n locale = this.targetLocale,\n customMapping: CustomMapping | undefined = this.customMapping\n ): boolean {\n if (!locale) throw new Error(noTargetLocaleProvidedError('isValidLocale'));\n if (customMapping === this.customMapping) {\n return this.localeConfig.isValidLocale(locale);\n }\n return _isValidLocale(locale, customMapping);\n }\n\n /**\n * Resolves the canonical locale for a given locale.\n * @param locale - The locale to resolve the canonical locale for\n * @param customMapping - The custom mapping to use for resolving the canonical locale\n * @returns The canonical locale, or the input locale when no canonical mapping exists.\n */\n resolveCanonicalLocale(\n locale: string | undefined = this.targetLocale,\n customMapping: CustomMapping | undefined = this.customMapping\n ): string {\n if (!locale)\n throw new Error(noTargetLocaleProvidedError('resolveCanonicalLocale'));\n if (customMapping === this.customMapping) {\n return this.localeConfig.resolveCanonicalLocale(locale);\n }\n return _resolveCanonicalLocale(locale, customMapping);\n }\n\n /**\n * Resolves the alias locale for a given locale.\n * @param locale - The locale to resolve the alias locale for\n * @param customMapping - The custom mapping to use for resolving the alias locale\n * @returns The configured alias for a canonical locale, or the input locale when already an alias or no alias mapping exists.\n */\n resolveAliasLocale(\n locale: string,\n customMapping: CustomMapping | undefined = this.customMapping\n ): string {\n if (!locale)\n throw new Error(noTargetLocaleProvidedError('resolveAliasLocale'));\n if (customMapping === this.customMapping) {\n return this.localeConfig.resolveAliasLocale(locale);\n }\n return _resolveAliasLocale(locale, customMapping);\n }\n\n /**\n * Standardizes a BCP 47 locale code to ensure correct formatting.\n *\n * @param {string} [locale=this.targetLocale] - The BCP 47 locale code to standardize.\n * @returns {string} The standardized locale code, or the input string if it cannot be standardized.\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.standardizeLocale('en_us');\n * // Returns: \"en-US\"\n */\n standardizeLocale(locale = this.targetLocale): string {\n if (!locale)\n throw new Error(noTargetLocaleProvidedError('standardizeLocale'));\n return this.localeConfig.standardizeLocale(locale);\n }\n\n /**\n * Checks if multiple BCP 47 locale codes represent the same dialect.\n *\n * @param {...(string | string[])} locales - The BCP 47 locale codes to compare.\n * @returns {boolean} True if all codes represent the same dialect, false otherwise\n *\n * @example\n * gt.isSameDialect('en-US', 'en-GB');\n * // Returns: false\n *\n * gt.isSameDialect('en', 'en-US');\n * // Returns: true\n */\n isSameDialect(...locales: (string | string[])[]): boolean {\n return this.localeConfig.isSameDialect(...locales);\n }\n\n /**\n * Checks if multiple BCP 47 locale codes represent the same language.\n *\n * @param {...(string | string[])} locales - The BCP 47 locale codes to compare.\n * @returns {boolean} True if all codes represent the same language, false otherwise\n *\n * @example\n * gt.isSameLanguage('en-US', 'en-GB');\n * // Returns: true\n */\n isSameLanguage(...locales: (string | string[])[]): boolean {\n return this.localeConfig.isSameLanguage(...locales);\n }\n\n /**\n * Checks if a locale is a superset of another locale.\n *\n * @param {string} superLocale - The locale to check if it is a superset\n * @param {string} subLocale - The locale to check if it is a subset\n * @returns {boolean} True if superLocale is a superset of subLocale, false otherwise\n *\n * @example\n * gt.isSupersetLocale('en', 'en-US');\n * // Returns: true\n *\n * gt.isSupersetLocale('en-US', 'en');\n * // Returns: false\n */\n isSupersetLocale(superLocale: string, subLocale: string): boolean {\n return this.localeConfig.isSupersetLocale(superLocale, subLocale);\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"runtime-DsKdTOSO.mjs","names":["_standardizeLocale","_isValidLocale","_getRegionProperties","_requiresTranslation","_determineLocale","_resolveCanonicalLocale","_resolveAliasLocale"],"sources":["../src/logging/errors.ts","../src/logging/logger.ts","../src/translate/utils/fetchWithTimeout.ts","../src/translate/utils/validateResponse.ts","../src/translate/utils/handleFetchError.ts","../src/translate/utils/generateRequestHeaders.ts","../src/translate/utils/apiRequest.ts","../src/translate/translateMany.ts","../src/runtime.ts"],"sourcesContent":["import { createDiagnosticMessage } from './diagnostics';\n\nconst GT_SOURCE = 'GT';\n\nexport const translationTimeoutError = (timeout: number) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Translation request timed out after ${timeout}ms`,\n fix: 'Try again, or increase the request timeout if the source content is large',\n });\n\nexport const translationRequestFailedError = (error: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: 'Translation request could not be completed',\n fix: 'Check your network connection and translation credentials, then try again',\n details: error,\n });\n\nexport const apiError = (status: number, statusText: string, error: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `The translation API returned ${status} ${statusText}`,\n fix: 'Check the request configuration and try again',\n details: error,\n });\n\nexport const invalidAuthError = createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: 'Authentication failed',\n fix: 'Check that your API key and project ID are correct',\n});\n\nexport const noTargetLocaleProvidedError = (functionName: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Cannot call \\`${functionName}\\` without a specified locale`,\n fix: `Pass a locale to \\`${functionName}\\` or specify targetLocale in the GT constructor`,\n });\n\nexport const noSourceLocaleProvidedError = (functionName: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Cannot call \\`${functionName}\\` without a specified locale`,\n fix: `Pass a locale to \\`${functionName}\\` or specify sourceLocale in the GT constructor`,\n });\n\nexport const noProjectIdProvidedError = (functionName: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Cannot call \\`${functionName}\\` without a specified project ID`,\n fix: `Pass a project ID to \\`${functionName}\\` or specify projectId in the GT constructor`,\n });\n\nexport const noApiKeyProvidedError = (functionName: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Cannot call \\`${functionName}\\` without a specified API key`,\n fix: `Pass an API key to \\`${functionName}\\` or specify apiKey in the GT constructor`,\n });\n\nexport const invalidLocaleError = (locale: string) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `Locale \"${locale}\" is not valid`,\n fix: 'Use a valid BCP 47 locale code or add a custom mapping',\n });\n\nexport const invalidLocalesError = (locales: string[]) =>\n createDiagnosticMessage({\n source: GT_SOURCE,\n severity: 'Error',\n whatHappened: `These locales are not valid: ${locales.join(', ')}`,\n fix: 'Use valid BCP 47 locale codes or add custom mappings',\n });\n","/**\n * Comprehensive logging system for the General Translation library.\n * Provides structured logging with multiple levels and configurable output.\n */\n\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'off';\n\nexport type LogMetadataValue =\n | string\n | number\n | boolean\n | null\n | undefined\n | Date\n | Error\n | LogMetadataValue[]\n | { [key: string]: LogMetadataValue };\n\nexport type LogMetadata = Record<string, LogMetadataValue>;\n\nexport interface LogEntry {\n level: LogLevel;\n message: string;\n timestamp: Date;\n context?: string;\n metadata?: LogMetadata;\n}\n\nexport interface LoggerConfig {\n /** Minimum log level to output. */\n level: LogLevel;\n /** Whether to include timestamps in log output. */\n includeTimestamp: boolean;\n /** Whether to include context information. */\n includeContext: boolean;\n /** Custom prefix for all log messages. */\n prefix?: string;\n /** Whether to output to console (default: true) */\n enableConsole: boolean;\n /** Custom log handlers. */\n handlers?: LogHandler[];\n}\n\nexport interface LogHandler {\n handle(entry: LogEntry): void;\n}\n\nconst LOG_LEVELS: Record<LogLevel, number> = {\n debug: 0,\n info: 1,\n warn: 2,\n error: 3,\n off: 4,\n};\n\nconst LOG_COLORS: Record<LogLevel, string> = {\n debug: '\\x1b[36m', // Cyan\n info: '\\x1b[32m', // Green\n warn: '\\x1b[33m', // Yellow\n error: '\\x1b[31m', // Red\n off: '', // No color needed since 'off' level logs are never displayed\n};\n\nconst RESET_COLOR = '\\x1b[0m';\n\n/**\n * Get the configured log level from environment variable or default to 'warn'\n */\nfunction getConfiguredLogLevel(): LogLevel {\n if (typeof process !== 'undefined' && process.env?._GT_LOG_LEVEL) {\n const envLevel = process.env._GT_LOG_LEVEL.toLowerCase();\n if (envLevel in LOG_LEVELS) {\n return envLevel as LogLevel;\n }\n }\n return 'warn';\n}\n\n/**\n * Console log handler that outputs formatted messages to console\n */\nexport class ConsoleLogHandler implements LogHandler {\n private config: LoggerConfig;\n\n constructor(config: LoggerConfig) {\n this.config = config;\n }\n\n handle(entry: LogEntry): void {\n const parts: string[] = [];\n\n // Add timestamp if enabled\n if (this.config.includeTimestamp) {\n parts.push(`[${entry.timestamp.toISOString()}]`);\n }\n\n // Add level with color\n const colorCode = LOG_COLORS[entry.level];\n const levelText = `[${entry.level.toUpperCase()}]`;\n parts.push(`${colorCode}${levelText}${RESET_COLOR}`);\n\n // Add prefix if configured\n if (this.config.prefix) {\n parts.push(`[${this.config.prefix}]`);\n }\n\n // Add context if available and enabled.\n if (this.config.includeContext && entry.context) {\n parts.push(`[${entry.context}]`);\n }\n\n // Add the main message\n parts.push(entry.message);\n\n // Format metadata if available.\n if (entry.metadata && Object.keys(entry.metadata).length > 0) {\n parts.push(`\\n Metadata: ${JSON.stringify(entry.metadata, null, 2)}`);\n }\n\n const formattedMessage = parts.join(' ');\n\n // Output to appropriate console method based on level\n switch (entry.level) {\n case 'debug':\n // eslint-disable-next-line no-console\n console.debug(formattedMessage);\n break;\n case 'info':\n // eslint-disable-next-line no-console\n console.info(formattedMessage);\n break;\n case 'warn':\n console.warn(formattedMessage);\n break;\n case 'error':\n console.error(formattedMessage);\n break;\n }\n }\n}\n\n/**\n * Main Logger class providing structured logging capabilities.\n */\nexport class Logger {\n private config: LoggerConfig;\n private handlers: LogHandler[];\n\n constructor(config: Partial<LoggerConfig> = {}) {\n this.config = {\n level: getConfiguredLogLevel(),\n includeTimestamp: true,\n includeContext: true,\n enableConsole: true,\n handlers: [],\n ...config,\n };\n\n this.handlers = [...(this.config.handlers || [])];\n\n // Add console handler if enabled\n if (this.config.enableConsole) {\n this.handlers.push(new ConsoleLogHandler(this.config));\n }\n }\n\n /**\n * Add a custom log handler\n */\n addHandler(handler: LogHandler): void {\n this.handlers.push(handler);\n }\n\n /**\n * Remove a log handler\n */\n removeHandler(handler: LogHandler): void {\n const index = this.handlers.indexOf(handler);\n if (index > -1) {\n this.handlers.splice(index, 1);\n }\n }\n\n /**\n * Update logger configuration\n */\n configure(config: Partial<LoggerConfig>): void {\n this.config = { ...this.config, ...config };\n }\n\n /**\n * Check if a log level should be output based on current configuration\n */\n private shouldLog(level: LogLevel): boolean {\n return LOG_LEVELS[level] >= LOG_LEVELS[this.config.level];\n }\n\n /**\n * Internal logging method that creates log entries and passes them to handlers\n */\n private log(\n level: LogLevel,\n message: string,\n context?: string,\n metadata?: LogMetadata\n ): void {\n if (!this.shouldLog(level)) {\n return;\n }\n\n const entry: LogEntry = {\n level,\n message,\n timestamp: new Date(),\n context,\n metadata,\n };\n\n // Pass to all handlers\n this.handlers.forEach((handler) => {\n try {\n handler.handle(entry);\n } catch (error) {\n // Prevent logging errors from breaking the application\n console.error('Error in log handler:', error);\n }\n });\n }\n\n /**\n * Log a debug message\n * Used for detailed diagnostic information, typically of interest only when diagnosing problems\n */\n debug(message: string, context?: string, metadata?: LogMetadata): void {\n this.log('debug', message, context, metadata);\n }\n\n /**\n * Log an info message\n * Used for general information about application operation.\n */\n info(message: string, context?: string, metadata?: LogMetadata): void {\n this.log('info', message, context, metadata);\n }\n\n /**\n * Log a warning message\n * Used for potentially problematic situations that don't prevent operation\n */\n warn(message: string, context?: string, metadata?: LogMetadata): void {\n this.log('warn', message, context, metadata);\n }\n\n /**\n * Log an error message\n * Used for error events that might still allow the application to continue.\n */\n error(message: string, context?: string, metadata?: LogMetadata): void {\n this.log('error', message, context, metadata);\n }\n\n /**\n * Create a child logger with a specific context\n */\n child(context: string): ContextLogger {\n return new ContextLogger(this, context);\n }\n\n /**\n * Get current logger configuration\n */\n getConfig(): LoggerConfig {\n return { ...this.config };\n }\n}\n\n/**\n * Context logger that automatically includes context information.\n */\nexport class ContextLogger {\n private logger: Logger;\n private context: string;\n\n constructor(logger: Logger, context: string) {\n this.logger = logger;\n this.context = context;\n }\n\n debug(message: string, metadata?: LogMetadata): void {\n this.logger.debug(message, this.context, metadata);\n }\n\n info(message: string, metadata?: LogMetadata): void {\n this.logger.info(message, this.context, metadata);\n }\n\n warn(message: string, metadata?: LogMetadata): void {\n this.logger.warn(message, this.context, metadata);\n }\n\n error(message: string, metadata?: LogMetadata): void {\n this.logger.error(message, this.context, metadata);\n }\n\n child(childContext: string): ContextLogger {\n return new ContextLogger(this.logger, `${this.context}:${childContext}`);\n }\n}\n\n// Default logger instance.\nexport const defaultLogger = new Logger({\n level: getConfiguredLogLevel(),\n includeTimestamp: true,\n includeContext: true,\n prefix: 'GT',\n});\n\n// Convenience functions using the default logger.\nexport const debug = (\n message: string,\n context?: string,\n metadata?: LogMetadata\n) => defaultLogger.debug(message, context, metadata);\n\nexport const info = (\n message: string,\n context?: string,\n metadata?: LogMetadata\n) => defaultLogger.info(message, context, metadata);\n\nexport const warn = (\n message: string,\n context?: string,\n metadata?: LogMetadata\n) => defaultLogger.warn(message, context, metadata);\n\nexport const error = (\n message: string,\n context?: string,\n metadata?: LogMetadata\n) => defaultLogger.error(message, context, metadata);\n\n// Create context-specific loggers for different parts of the system\nexport const fetchLogger = defaultLogger.child('fetch');\nexport const gtInstanceLogger = defaultLogger.child('GT instance');\n\n// Export types and classes\nexport { Logger as GTLogger };\n","import { translationTimeoutError } from '../../logging/errors';\nimport { defaultTimeout } from '../../settings/settings';\n\n/**\n * @internal\n *\n * Wraps the fetch function with a timeout.\n *\n * @param url - The URL to fetch.\n * @param options - The options to pass to the fetch function.\n * @param timeout - The timeout in milliseconds.\n * @returns The response from the fetch function.\n */\nexport async function fetchWithTimeout(\n url: string | URL | globalThis.Request,\n options: RequestInit,\n timeout?: number\n) {\n const controller = new AbortController();\n const signal = controller.signal;\n\n timeout = timeout ? timeout : defaultTimeout;\n const timeoutId = timeout\n ? setTimeout(() => controller.abort(), timeout)\n : null;\n\n try {\n const response = await fetch(url, { ...options, signal });\n return response;\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n throw translationTimeoutError(timeout);\n }\n throw error;\n } finally {\n if (timeoutId) clearTimeout(timeoutId);\n }\n}\n","import { apiError } from '../../logging/errors';\nimport { ApiError } from '../../errors/ApiError';\n\nexport async function validateResponse(response: Response) {\n if (!response.ok) {\n let errorMsg = 'Unknown error';\n try {\n const text = await response.text();\n try {\n const errorJson = JSON.parse(text) as { error: string };\n errorMsg = errorJson.error;\n } catch {\n errorMsg = text || 'Unknown error';\n }\n } catch {\n // response.text() failed, keep 'Unknown error'\n }\n const errorMessage = apiError(\n response.status,\n response.statusText,\n errorMsg\n );\n const error = new ApiError(errorMessage, response.status, errorMsg);\n throw error;\n }\n}\n","import { fetchLogger } from '../../logging/logger';\nimport {\n translationRequestFailedError,\n translationTimeoutError,\n} from '../../logging/errors';\n\nexport function handleFetchError(error: unknown, timeout: number): never {\n if (error instanceof Error && error.name === 'AbortError') {\n const errorMessage = translationTimeoutError(timeout);\n fetchLogger.error(errorMessage);\n throw new Error(errorMessage);\n }\n const errorMessage = translationRequestFailedError(\n error instanceof Error ? error.message : String(error)\n );\n fetchLogger.error(errorMessage);\n throw error;\n}\n","import { TranslationRequestConfig } from '../../types';\nimport { API_VERSION } from '../api';\n\nexport function generateRequestHeaders(\n config: TranslationRequestConfig,\n excludeContentType = false\n) {\n const authHeaders: Record<string, string> = {\n ...(!excludeContentType && { 'Content-Type': 'application/json' }),\n 'gt-project-id': config.projectId,\n };\n\n if (config.apiKey) {\n authHeaders['Authorization'] = `Bearer ${config.apiKey}`;\n }\n\n authHeaders['gt-api-version'] = API_VERSION;\n\n return authHeaders;\n}\n","import { TranslationRequestConfig } from '../../types';\nimport { defaultBaseUrl } from '../../settings/settingsUrls';\nimport { defaultTimeout } from '../../settings/settings';\nimport { fetchWithTimeout } from './fetchWithTimeout';\nimport { validateResponse } from './validateResponse';\nimport { handleFetchError } from './handleFetchError';\nimport { generateRequestHeaders } from './generateRequestHeaders';\n\nconst MAX_RETRIES = 3;\nconst INITIAL_DELAY_MS = 500;\nconst RATE_LIMIT_RETRY_DELAY_MS = 60_000;\nconst MS_PER_SECOND = 1000;\n\ntype RetryPolicy = 'exponential' | 'linear' | 'none';\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nfunction getRetryDelay(policy: RetryPolicy, attempt: number): number {\n switch (policy) {\n case 'linear':\n return INITIAL_DELAY_MS * (attempt + 1);\n case 'exponential':\n return INITIAL_DELAY_MS * 2 ** attempt;\n default:\n return 0;\n }\n}\n\nfunction parseDelayMs(value: string | null): number | undefined {\n if (!value) {\n return undefined;\n }\n\n const seconds = Number(value.split(',')[0].split(';')[0].trim());\n if (!Number.isFinite(seconds) || seconds < 0) {\n return undefined;\n }\n\n return seconds * MS_PER_SECOND;\n}\n\nfunction parseRetryAfter(value: string | null): number | undefined {\n const delayMs = parseDelayMs(value);\n if (delayMs !== undefined) {\n return delayMs;\n }\n\n if (!value) {\n return undefined;\n }\n\n const retryDate = Date.parse(value);\n if (Number.isNaN(retryDate)) {\n return undefined;\n }\n\n return Math.max(retryDate - Date.now(), 0);\n}\n\nfunction getRateLimitRetryDelay(response: Response): number {\n return (\n parseRetryAfter(response.headers.get('Retry-After')) ??\n parseDelayMs(response.headers.get('RateLimit-Reset')) ??\n RATE_LIMIT_RETRY_DELAY_MS\n );\n}\n\nfunction getResponseRetryDelay(\n response: Response,\n policy: RetryPolicy,\n attempt: number\n): number {\n if (response.status === 429) {\n return getRateLimitRetryDelay(response);\n }\n\n return getRetryDelay(policy, attempt);\n}\n\n/**\n * @internal\n *\n * Makes an API request with automatic retry for 429 and 5XX errors.\n *\n * Encapsulates URL construction, fetch with timeout, error handling,\n * response validation, and JSON parsing.\n *\n * @param config - The configuration for the API call.\n * @param endpoint - The API endpoint path (e.g. '/v2/project/jobs/info')\n * @param options - Optional request options.\n * @returns The parsed JSON response.\n */\nexport async function apiRequest<T>(\n config: TranslationRequestConfig,\n endpoint: string,\n options?: {\n body?: unknown;\n timeout?: number;\n method?: 'GET' | 'POST';\n retryPolicy?: RetryPolicy;\n }\n): Promise<T> {\n const timeout = options?.timeout ?? defaultTimeout;\n const url = `${config.baseUrl || defaultBaseUrl}${endpoint}`;\n const method = options?.method ?? 'POST';\n const retryPolicy = options?.retryPolicy ?? 'exponential';\n const maxRetries = retryPolicy === 'none' ? 0 : MAX_RETRIES;\n\n const requestInit: RequestInit = {\n method,\n headers: generateRequestHeaders(config),\n };\n if (options?.body !== undefined) {\n requestInit.body = JSON.stringify(options.body);\n }\n\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\n let response: Response;\n try {\n response = await fetchWithTimeout(url, requestInit, timeout);\n } catch (error) {\n if (attempt < maxRetries) {\n await sleep(getRetryDelay(retryPolicy, attempt));\n continue;\n }\n handleFetchError(error, timeout);\n }\n\n // Retry on rate limits and 5XX server errors.\n if (\n (response!.status === 429 || response!.status >= 500) &&\n attempt < maxRetries\n ) {\n await sleep(getResponseRetryDelay(response!, retryPolicy, attempt));\n continue;\n }\n\n await validateResponse(response!);\n return (await response!.json()) as T;\n }\n\n throw new Error('Max retries exceeded');\n}\n","import {\n TranslationRequestConfig,\n TranslateManyResult,\n TranslationResult,\n} from '../types';\nimport { defaultRuntimeApiUrl } from '../settings/settingsUrls';\nimport {\n TranslateManyEntry,\n TranslateOptions,\n EntryMetadata,\n} from '../types-dir/api/entry';\nimport { apiRequest } from './utils/apiRequest';\nimport type { Content } from '@generaltranslation/format/types';\nimport { hashSource } from '../id';\n\n/**\n * @internal\n *\n * Translates multiple entries in a single API request for better performance.\n * This function batches multiple translation requests together and sends them\n * to the GT translation API in one call.\n *\n * @param requests - The entries to translate. Can be an array (entries are hashed and results returned in order) or a record keyed by hash (skips hash calculation, returns a record).\n * @param globalMetadata - The metadata for the translation.\n * @param config - The configuration for the translation.\n * @returns The results of the translation. An array if requests was an array, a record if requests was a record.\n */\nexport async function _translateMany<\n T extends TranslateManyEntry[] | Record<string, TranslateManyEntry>,\n>(\n requests: T,\n globalMetadata: {\n targetLocale: string;\n sourceLocale: string;\n } & TranslateOptions,\n config: TranslationRequestConfig,\n timeout?: number\n): Promise<\n T extends TranslateManyEntry[]\n ? TranslateManyResult\n : Record<string, TranslationResult>\n>;\nexport async function _translateMany(\n requests: TranslateManyEntry[] | Record<string, TranslateManyEntry>,\n globalMetadata: {\n targetLocale: string;\n sourceLocale: string;\n } & TranslateOptions,\n config: TranslationRequestConfig,\n timeout?: number\n): Promise<TranslateManyResult | Record<string, TranslationResult>> {\n const isArray = Array.isArray(requests);\n\n // normalize and map from requests to requests record\n const hashOrder: string[] | undefined = isArray ? [] : undefined;\n const requestsObject: Record<\n string,\n { source: Content; metadata?: EntryMetadata }\n > = {};\n\n const entries: [string | undefined, TranslateManyEntry][] = isArray\n ? requests.map((r) => [undefined, r])\n : Object.entries(requests);\n\n for (const [key, request] of entries) {\n const normalized =\n typeof request === 'string' ? { source: request } : request;\n const { source, metadata } = normalized;\n const hash =\n key ??\n metadata?.hash ??\n hashSource({\n source,\n ...(metadata?.context && { context: metadata.context }),\n ...(metadata?.maxChars != null && { maxChars: metadata.maxChars }),\n dataFormat: metadata?.dataFormat ?? 'STRING',\n });\n hashOrder?.push(hash);\n requestsObject[hash] = {\n source,\n metadata: metadata,\n };\n }\n\n const response = await apiRequest<Record<string, TranslationResult>>(\n { ...config, baseUrl: config.baseUrl || defaultRuntimeApiUrl },\n `/v2/translate`,\n {\n body: {\n requests: requestsObject,\n targetLocale: globalMetadata.targetLocale,\n sourceLocale: globalMetadata.sourceLocale,\n metadata: globalMetadata,\n },\n timeout: timeout,\n retryPolicy: 'none',\n }\n );\n\n // If input was an array, map the record response back to an array in input order\n if (hashOrder) {\n return hashOrder.map(\n (hash) =>\n response[hash] ?? {\n success: false,\n error: 'No translation returned',\n code: 500,\n }\n );\n }\n\n // If input was a record, return the record response directly\n return response;\n}\n","// `generaltranslation` language toolkit\n// © 2026, General Translation, Inc.\n\n// ----- IMPORTS ----- //\n\nimport {\n LocaleConfig,\n determineLocale as _determineLocale,\n getRegionProperties as _getRegionProperties,\n isValidLocale as _isValidLocale,\n requiresTranslation as _requiresTranslation,\n resolveAliasLocale as _resolveAliasLocale,\n resolveCanonicalLocale as _resolveCanonicalLocale,\n standardizeLocale as _standardizeLocale,\n} from '@generaltranslation/format';\nimport type {\n CustomMapping,\n CustomRegionMapping,\n CutoffFormatOptions,\n FormatVariables,\n LocaleProperties,\n StringFormat,\n} from '@generaltranslation/format/types';\nimport {\n TranslateManyResult,\n TranslationError,\n TranslationRequestConfig,\n TranslationResult,\n TranslateManyEntry,\n} from './types';\nimport { libraryDefaultLocale } from './settings/settings';\nimport {\n noSourceLocaleProvidedError,\n noTargetLocaleProvidedError,\n invalidLocaleError,\n invalidLocalesError,\n noProjectIdProvidedError,\n noApiKeyProvidedError,\n} from './logging/errors';\nimport { gtInstanceLogger } from './logging/logger';\nimport { _translateMany } from './translate/translateMany';\nimport { TranslateOptions } from './types-dir/api/entry';\n\n// ============================================================ //\n// Runtime Class //\n// ============================================================ //\n/**\n * Type representing the constructor parameters for the GT and GTRuntime classes.\n * @typedef {Object} GTConstructorParams\n * @property {string} [apiKey] - The API key for accessing the translation service\n * @property {string} [devApiKey] - The development API key for accessing the translation service\n * @property {string} [sourceLocale] - The default source locale for translations\n * @property {string} [targetLocale] - The default target locale for translations\n * @property {string[]} [locales] - Array of supported locales\n * @property {string} [projectId] - The project ID for the translation service\n * @property {string} [baseUrl] - The base URL for the translation service\n * @property {CustomMapping} [customMapping] - Custom mapping of locale codes to their names\n */\nexport type GTConstructorParams = {\n apiKey?: string;\n devApiKey?: string;\n sourceLocale?: string;\n targetLocale?: string;\n locales?: string[];\n projectId?: string;\n baseUrl?: string;\n customMapping?: CustomMapping;\n};\n\n/**\n * GTRuntime is the runtime core of the GT driver: locale management,\n * formatting, and runtime translation requests.\n *\n * Browser-facing SDK code constructs this class (via `generaltranslation/runtime`)\n * so production bundles do not ship the project/file management API client\n * that lives on the GT class exported from the main entry.\n *\n * @example\n * const gt = new GTRuntime({\n * sourceLocale: 'en-US',\n * targetLocale: 'es-ES',\n * locales: ['en-US', 'es-ES', 'fr-FR']\n * });\n */\nexport class GTRuntime {\n /** Base URL for the translation service API */\n baseUrl?: string;\n\n /** Project ID for the translation service */\n projectId?: string;\n\n /** API key for accessing the translation service */\n apiKey?: string;\n\n /** Development API key for accessing the translation service */\n devApiKey?: string;\n\n /** Source locale for translations */\n sourceLocale?: string;\n\n /** Target locale for translations */\n targetLocale?: string;\n\n /** Array of supported locales */\n locales?: string[];\n\n /** Custom mapping for locale codes to their names */\n customMapping?: CustomMapping;\n\n /** Lazily derived reverse custom mapping for alias locales */\n reverseCustomMapping?: Record<string, string>;\n\n /** Lazily derived custom mapping for regions */\n customRegionMapping?: CustomRegionMapping;\n\n /** Runtime-safe locale and formatting helpers (backing field) */\n private _localeConfig!: LocaleConfig;\n\n /** Runtime-safe locale and formatting helpers */\n get localeConfig() {\n return this._localeConfig;\n }\n\n /**\n * Constructs an instance of the GTRuntime class.\n *\n * @param {GTConstructorParams} [params] - The parameters for initializing the GTRuntime instance\n * @throws {Error} If an invalid locale is provided\n * @throws {Error} If any of the provided locales are invalid\n *\n * @example\n * const gt = new GTRuntime({\n * apiKey: 'your-api-key',\n * sourceLocale: 'en-US',\n * targetLocale: 'es-ES',\n * locales: ['en-US', 'es-ES', 'fr-FR']\n * });\n */\n constructor(params: GTConstructorParams = {}) {\n // Read environment\n if (typeof process !== 'undefined') {\n this.apiKey ||= process.env?.GT_API_KEY;\n this.devApiKey ||= process.env?.GT_DEV_API_KEY;\n this.projectId ||= process.env?.GT_PROJECT_ID;\n }\n // Set up config\n this.setConfig(params);\n }\n\n setConfig({\n apiKey,\n devApiKey,\n sourceLocale,\n targetLocale,\n locales,\n projectId,\n customMapping,\n baseUrl,\n }: GTConstructorParams) {\n // ----- Environment properties ----- //\n if (apiKey) this.apiKey = apiKey;\n if (devApiKey) this.devApiKey = devApiKey;\n if (projectId) this.projectId = projectId;\n\n // ----- Standardize locales ----- //\n\n // source locale\n if (sourceLocale) {\n this.sourceLocale = _standardizeLocale(sourceLocale);\n if (!_isValidLocale(this.sourceLocale, customMapping))\n throw new Error(invalidLocaleError(this.sourceLocale));\n }\n\n // target locale\n if (targetLocale) {\n this.targetLocale = _standardizeLocale(targetLocale);\n if (!_isValidLocale(this.targetLocale, customMapping))\n throw new Error(invalidLocaleError(this.targetLocale));\n }\n\n // locales\n if (locales) {\n const result: string[] = [];\n const invalidLocales: string[] = [];\n locales.forEach((locale) => {\n const standardizedLocale = _standardizeLocale(locale);\n if (_isValidLocale(standardizedLocale)) {\n result.push(standardizedLocale);\n } else {\n invalidLocales.push(locale);\n }\n });\n if (invalidLocales.length > 0) {\n throw new Error(invalidLocalesError(invalidLocales));\n }\n this.locales = result;\n }\n\n // ----- Other properties ----- //\n if (baseUrl) this.baseUrl = baseUrl;\n if (customMapping) {\n this.customMapping = customMapping;\n this.reverseCustomMapping = Object.fromEntries(\n Object.entries(customMapping)\n .filter(\n ([, value]) => value && typeof value === 'object' && 'code' in value\n )\n .map(([key, value]) => [(value as { code: string }).code, key])\n );\n }\n this._localeConfig = new LocaleConfig({\n defaultLocale: this.sourceLocale,\n locales: this.locales ?? [],\n customMapping: this.customMapping,\n });\n }\n\n // -------------- Private Methods -------------- //\n\n protected _getTranslationConfig(): TranslationRequestConfig {\n return {\n baseUrl: this.baseUrl,\n apiKey: this.apiKey || this.devApiKey,\n projectId: this.projectId || '',\n };\n }\n\n protected _validateAuth(functionName: string) {\n const errors: string[] = [];\n if (!this.apiKey && !this.devApiKey) {\n const error = noApiKeyProvidedError(functionName);\n errors.push(error);\n }\n if (!this.projectId) {\n const error = noProjectIdProvidedError(functionName);\n errors.push(error);\n }\n if (errors.length) {\n throw new Error(errors.join('\\n'));\n }\n }\n\n /**\n * Translates a single source string to the target locale.\n * Routes through {@link translateMany} under the hood.\n *\n * @param {string} source - The source string to translate.\n * @param {object} options - Translation options including targetLocale and optional entry metadata.\n * @returns {Promise<TranslationResult | TranslationError>} The translated content.\n *\n * @example\n * const result = await gt.translate('Hello, world!', { targetLocale: 'es' });\n *\n * @example\n * const result = await gt.translate('Hello, world!', {\n * targetLocale: 'es',\n * dataFormat: 'ICU',\n * context: 'A formal greeting',\n * });\n */\n async translate(\n source: TranslateManyEntry,\n options: string | TranslateOptions,\n timeout?: number\n ): Promise<TranslationResult | TranslationError> {\n // Normalize string shorthand to options object\n if (typeof options === 'string') {\n options = { targetLocale: options };\n }\n\n // Validation\n this._validateAuth('translate');\n\n // Require target locale\n let targetLocale = options?.targetLocale || this.targetLocale;\n if (!targetLocale) {\n const error = noTargetLocaleProvidedError('translate');\n gtInstanceLogger.error(error);\n throw new Error(error);\n }\n\n // Replace target locale with canonical locale\n targetLocale = this.resolveCanonicalLocale(targetLocale);\n\n const sourceLocale = this.resolveCanonicalLocale(\n options?.sourceLocale || this.sourceLocale || libraryDefaultLocale\n );\n\n // Request the translation.\n const results = await _translateMany(\n [source],\n {\n ...options,\n targetLocale,\n sourceLocale,\n },\n this._getTranslationConfig(),\n timeout\n );\n return results[0];\n }\n\n /**\n * Translates multiple source strings to the target locale.\n * Each entry can be a plain string or an object with source and metadata fields.\n *\n * @param {TranslateManyEntry[] | Record<string, TranslateManyEntry>} sources - The source entries to translate. Can be an array or a record keyed by hash.\n * @param {object} options - Translation options including targetLocale.\n * @returns {Promise<TranslateManyResult | Record<string, TranslationResult>>} The translated contents. An array if sources was an array, a record if sources was a record.\n *\n * @example\n * const result = await gt.translateMany(\n * ['Hello, world!', 'Goodbye, world!'],\n * { targetLocale: 'es' }\n * );\n *\n * @example\n * const result = await gt.translateMany(\n * [{ source: 'Hello, world!', dataFormat: 'ICU' }],\n * { targetLocale: 'es' }\n * );\n *\n * @example\n * const result = await gt.translateMany(\n * { 'my-hash': 'Hello, world!' },\n * { targetLocale: 'es' }\n * );\n */\n async translateMany(\n sources: TranslateManyEntry[],\n options: string | TranslateOptions,\n timeout?: number\n ): Promise<TranslateManyResult>;\n async translateMany(\n sources: Record<string, TranslateManyEntry>,\n options: string | TranslateOptions,\n timeout?: number\n ): Promise<Record<string, TranslationResult>>;\n async translateMany(\n sources: TranslateManyEntry[] | Record<string, TranslateManyEntry>,\n options: string | TranslateOptions,\n timeout?: number\n ): Promise<TranslateManyResult | Record<string, TranslationResult>> {\n // Normalize string shorthand to options object\n if (typeof options === 'string') {\n options = { targetLocale: options };\n }\n\n // Validation\n this._validateAuth('translateMany');\n\n // Require target locale\n let targetLocale = options?.targetLocale || this.targetLocale;\n if (!targetLocale) {\n const error = noTargetLocaleProvidedError('translateMany');\n gtInstanceLogger.error(error);\n throw new Error(error);\n }\n\n // Replace target locale with canonical locale\n targetLocale = this.resolveCanonicalLocale(targetLocale);\n\n const sourceLocale = this.resolveCanonicalLocale(\n options?.sourceLocale || this.sourceLocale || libraryDefaultLocale\n );\n\n // Request the translation.\n return await _translateMany(\n sources,\n {\n ...options,\n targetLocale,\n sourceLocale,\n },\n this._getTranslationConfig(),\n timeout\n );\n }\n\n // -------------- Formatting -------------- //\n\n /**\n * Formats a string with cutoff behavior, applying a terminator when the string exceeds the maximum character limit.\n *\n * This method uses the GT instance's rendering locales by default for locale-specific terminator selection,\n * but can be overridden with custom locales in the options.\n *\n * @param {string} value - The string value to format with cutoff behavior.\n * @param {Object} [options] - Configuration options for cutoff formatting.\n * @param {string | string[]} [options.locales] - The locales to use for terminator selection. Defaults to instance's rendering locales.\n * @param {number} [options.maxChars] - The maximum number of characters to display.\n * - Undefined values are treated as no cutoff.\n * - Negative values follow .slice() behavior and terminator will be added before the value.\n * - 0 will result in an empty string.\n * - If cutoff results in an empty string, no terminator is added.\n * @param {CutoffFormatStyle} [options.style='ellipsis'] - The style of the terminator.\n * @param {string} [options.terminator] - Optional override the terminator to use.\n * @param {string} [options.separator] - Optional override the separator to use between the terminator and the value.\n * - If no terminator is provided, then separator is ignored.\n * @returns {string} The formatted string with terminator applied if cutoff occurs.\n *\n * @example\n * const gt = new GTRuntime({ targetLocale: 'en-US' });\n * gt.formatCutoff('Hello, world!', { maxChars: 8 });\n * // Returns: 'Hello, w...'\n *\n * @example\n * gt.formatCutoff('Hello, world!', { maxChars: -3 });\n * // Returns: '...ld!'\n */\n formatCutoff(\n value: string,\n options?: {\n locales?: string | string[];\n } & CutoffFormatOptions\n ): string {\n return this.localeConfig.formatCutoff(value, this.targetLocale, options);\n }\n\n /**\n * Formats a message according to the specified locales and options.\n *\n * @param {string} message - The message to format.\n * @param {string | string[]} [locales=libraryDefaultLocale] - The locales to use for formatting.\n * @param {FormatVariables} [variables={}] - The variables to use for formatting.\n * @param {StringFormat} [dataFormat='ICU'] - The format of the message.\n * @returns {string} The formatted message.\n *\n * @example\n * gt.formatMessage('Hello {name}', { name: 'John' });\n * // Returns: \"Hello John\"\n *\n * gt.formatMessage('Hello {name}', { name: 'John' }, { locales: ['fr'] });\n * // Returns: \"Bonjour John\"\n */\n formatMessage(\n message: string,\n options?: {\n locales?: string | string[];\n variables?: FormatVariables;\n dataFormat?: StringFormat;\n }\n ): string {\n return this.localeConfig.formatMessage(message, this.targetLocale, options);\n }\n /**\n * Formats a number according to the specified locales and options.\n *\n * @param {number} number - The number to format.\n * @param {Object} [options] - Additional options for number formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.NumberFormatOptions} [options] - Additional Intl.NumberFormat options.\n * @returns {string} The formatted number.\n *\n * @example\n * gt.formatNum(1234.56, { style: 'currency', currency: 'USD' });\n * // Returns: \"$1,234.56\"\n */\n formatNum(\n number: number,\n options?: {\n locales?: string | string[];\n } & Intl.NumberFormatOptions\n ): string {\n return this.localeConfig.formatNum(number, this.targetLocale, options);\n }\n\n /**\n * Formats a date according to the specified locales and options.\n *\n * @param {Date} date - The date to format.\n * @param {Object} [options] - Additional options for date formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.DateTimeFormatOptions} [options] - Additional Intl.DateTimeFormat options.\n * @returns {string} The formatted date.\n *\n * @example\n * gt.formatDateTime(new Date(), { dateStyle: 'full', timeStyle: 'long' });\n * // Returns: \"Thursday, March 14, 2024 at 2:30:45 PM GMT-7\"\n */\n formatDateTime(\n date: Date,\n options?: {\n locales?: string | string[];\n } & Intl.DateTimeFormatOptions\n ): string {\n return this.localeConfig.formatDateTime(date, this.targetLocale, options);\n }\n\n /**\n * Formats a currency value according to the specified locales and options.\n *\n * @param {number} value - The currency value to format.\n * @param {string} currency - The currency code (e.g., 'USD', 'EUR')\n * @param {Object} [options] - Additional options for currency formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.NumberFormatOptions} [options] - Additional Intl.NumberFormat options.\n * @returns {string} The formatted currency value.\n *\n * @example\n * gt.formatCurrency(1234.56, 'USD', { style: 'currency' });\n * // Returns: \"$1,234.56\"\n */\n formatCurrency(\n value: number,\n currency: string,\n options?: {\n locales?: string | string[];\n } & Intl.NumberFormatOptions\n ): string {\n return this.localeConfig.formatCurrency(\n value,\n currency,\n this.targetLocale,\n options\n );\n }\n\n /**\n * Formats a list of items according to the specified locales and options.\n *\n * @param {Array<string | number>} array - The list of items to format.\n * @param {Object} [options] - Additional options for list formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.ListFormatOptions} [options] - Additional Intl.ListFormat options.\n * @returns {string} The formatted list.\n *\n * @example\n * gt.formatList(['apple', 'banana', 'orange'], { type: 'conjunction' });\n * // Returns: \"apple, banana, and orange\"\n */\n formatList(\n array: Array<string | number>,\n options?: {\n locales?: string | string[];\n } & Intl.ListFormatOptions\n ) {\n return this.localeConfig.formatList(array, this.targetLocale, options);\n }\n\n /**\n * Formats a list of items according to the specified locales and options.\n * @param {Array<T>} array - The list of items to format.\n * @param {Object} [options] - Additional options for list formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.ListFormatOptions} [options] - Additional Intl.ListFormat options.\n * @returns {Array<T | string>} The formatted list parts.\n *\n * @example\n * gt.formatListToParts(['apple', 42, { foo: 'bar' }], { type: 'conjunction', style: 'short', locales: ['en'] });\n * // Returns: ['apple', ', ', 42, ' and ', '{ foo: \"bar\" }']\n */\n formatListToParts<T>(\n array: Array<T>,\n options?: {\n locales?: string | string[];\n } & Intl.ListFormatOptions\n ): Array<T | string> {\n return this.localeConfig.formatListToParts<T>(\n array,\n this.targetLocale,\n options\n );\n }\n\n /**\n * Formats a relative time value according to the specified locales and options.\n *\n * @param {number} value - The relative time value to format.\n * @param {Intl.RelativeTimeFormatUnit} unit - The unit of time (e.g., 'second', 'minute', 'hour', 'day', 'week', 'month', 'year')\n * @param {Object} options - Additional options for relative time formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @param {Intl.RelativeTimeFormatOptions} [options] - Additional Intl.RelativeTimeFormat options.\n * @returns {string} The formatted relative time string.\n *\n * @example\n * gt.formatRelativeTime(-1, 'day', { locales: ['en-US'], numeric: 'auto' });\n * // Returns: \"yesterday\"\n */\n formatRelativeTime(\n value: number,\n unit: Intl.RelativeTimeFormatUnit,\n options?: {\n locales?: string | string[];\n } & Omit<Intl.RelativeTimeFormatOptions, 'locales'>\n ): string {\n return this.localeConfig.formatRelativeTime(\n value,\n unit,\n this.targetLocale,\n options\n );\n }\n\n /**\n * Formats a relative time string from a Date, automatically selecting the best unit.\n *\n * @param {Date} date - The date to format relative to now.\n * @param {Object} [options] - Additional options for relative time formatting.\n * @param {string | string[]} [options.locales] - The locales to use for formatting.\n * @returns {string} The formatted relative time string (e.g., \"2 hours ago\", \"in 3 days\")\n *\n * @example\n * gt.formatRelativeTimeFromDate(new Date(Date.now() - 3600000));\n * // Returns: \"1 hour ago\"\n */\n formatRelativeTimeFromDate(\n date: Date,\n options?: {\n locales?: string | string[];\n baseDate?: Date;\n } & Omit<Intl.RelativeTimeFormatOptions, 'locales'>\n ): string {\n return this.localeConfig.formatRelativeTimeFromDate(\n date,\n this.targetLocale,\n options\n );\n }\n\n // -------------- Locale Properties -------------- //\n\n /**\n * Retrieves the display name of a locale code using Intl.DisplayNames, returning an empty string if no name is found.\n *\n * @param {string} [locale=this.targetLocale] - A BCP-47 locale code.\n * @returns {string} The display name corresponding to the code.\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.getLocaleName('es-ES');\n * // Returns: \"Spanish (Spain)\"\n */\n getLocaleName(locale = this.targetLocale): string {\n if (!locale) throw new Error(noTargetLocaleProvidedError('getLocaleName'));\n return this.localeConfig.getLocaleName(locale);\n }\n\n /**\n * Retrieves an emoji based on a given locale code.\n * Uses the locale's region (if present) to select an emoji or falls back on default emojis.\n *\n * @param {string} [locale=this.targetLocale] - A BCP-47 locale code (e.g., 'en-US', 'fr-CA')\n * @returns {string} The emoji representing the locale or its region.\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.getLocaleEmoji('es-ES');\n * // Returns: \"🇪🇸\"\n */\n getLocaleEmoji(locale = this.targetLocale): string {\n if (!locale) throw new Error(noTargetLocaleProvidedError('getLocaleEmoji'));\n return this.localeConfig.getLocaleEmoji(locale);\n }\n\n /**\n * Generates linguistic details for a given locale code.\n *\n * This function returns information about the locale,\n * script, and region of a given language code both in a standard form and in a maximized form (with likely script and region).\n * The function provides these names in both your default language and native forms, and an associated emoji.\n *\n * @param {string} [locale=this.targetLocale] - The locale code to get properties for (e.g., \"de-AT\").\n * @returns {LocaleProperties} - An object containing detailed information about the locale.\n *\n * @property {string} code - The full locale code, e.g., \"de-AT\".\n * @property {string} name - Language name in the default display language, e.g., \"Austrian German\".\n * @property {string} nativeName - Language name in the locale's native language, e.g., \"Österreichisches Deutsch\".\n * @property {string} languageCode - The base language code, e.g., \"de\".\n * @property {string} languageName - The language name in the default display language, e.g., \"German\".\n * @property {string} nativeLanguageName - The language name in the native language, e.g., \"Deutsch\".\n * @property {string} nameWithRegionCode - Language name with region in the default language, e.g., \"German (AT)\".\n * @property {string} nativeNameWithRegionCode - Language name with region in the native language, e.g., \"Deutsch (AT)\".\n * @property {string} regionCode - The region code from maximization, e.g., \"AT\".\n * @property {string} regionName - The region name in the default display language, e.g., \"Austria\".\n * @property {string} nativeRegionName - The region name in the native language, e.g., \"Österreich\".\n * @property {string} scriptCode - The script code from maximization, e.g., \"Latn\".\n * @property {string} scriptName - The script name in the default display language, e.g., \"Latin\".\n * @property {string} nativeScriptName - The script name in the native language, e.g., \"Lateinisch\".\n * @property {string} maximizedCode - The maximized locale code, e.g., \"de-Latn-AT\".\n * @property {string} maximizedName - Maximized locale name with likely script in the default language, e.g., \"Austrian German (Latin)\".\n * @property {string} nativeMaximizedName - Maximized locale name in the native language, e.g., \"Österreichisches Deutsch (Lateinisch)\".\n * @property {string} minimizedCode - Minimized locale code, e.g., \"de-AT\" (or \"de\" for \"de-DE\").\n * @property {string} minimizedName - Minimized language name in the default language, e.g., \"Austrian German\".\n * @property {string} nativeMinimizedName - Minimized language name in the native language, e.g., \"Österreichisches Deutsch\".\n * @property {string} emoji - The emoji associated with the locale's region, if applicable.\n */\n getLocaleProperties(locale = this.targetLocale): LocaleProperties {\n if (!locale)\n throw new Error(noTargetLocaleProvidedError('getLocaleProperties'));\n return this.localeConfig.getLocaleProperties(locale);\n }\n\n /**\n * Retrieves multiple properties for a given region code, including:\n * - `code`: the original region code\n * - `name`: the localized display name\n * - `emoji`: the associated flag or symbol\n *\n * Behavior:\n * - Accepts ISO 3166-1 alpha-2 or UN M.49 region codes (e.g., `\"US\"`, `\"FR\"`, `\"419\"`).\n * - Uses the instance's `targetLocale` to localize the region name for the user.\n * - If `customMapping` contains a `name` or `emoji` for the region, those override the default values.\n * - Otherwise, uses `Intl.DisplayNames` to get the localized region name, falling back to `libraryDefaultLocale`.\n * - Falls back to the region code as `name` if display name resolution fails.\n * - Falls back to a default emoji if no emoji mapping is found in built-in data or `customMapping`.\n *\n * @param {string} [region=this.getLocaleProperties().regionCode] - The region code to look up (e.g., `\"US\"`, `\"GB\"`, `\"DE\"`).\n * @param {CustomRegionMapping} [customMapping] - Optional mapping of region codes to custom names and/or emojis.\n * @returns {{ code: string, name: string, emoji: string }} An object containing:\n * - `code`: the input region code\n * - `name`: the localized or custom region name\n * - `emoji`: the matching emoji flag or symbol\n *\n * @throws {Error} If no target locale is available to determine region properties.\n *\n * @example\n * const gt = new GTRuntime({ targetLocale: 'en-US' });\n * gt.getRegionProperties('US');\n * // => { code: 'US', name: 'United States', emoji: '🇺🇸' }\n *\n * @example\n * const gt = new GTRuntime({ targetLocale: 'fr-FR' });\n * gt.getRegionProperties('US');\n * // => { code: 'US', name: 'États-Unis', emoji: '🇺🇸' }\n *\n * @example\n * gt.getRegionProperties('US', { US: { name: 'USA', emoji: '🗽' } });\n * // => { code: 'US', name: 'USA', emoji: '🗽' }\n */\n getRegionProperties(\n region = this.getLocaleProperties().regionCode,\n customMapping?: CustomRegionMapping\n ): { code: string; name: string; emoji: string } {\n if (!customMapping) {\n if (this.customMapping && !this.customRegionMapping) {\n // Lazy derive custom region mapping from customMapping\n const customRegionMapping: CustomRegionMapping = {};\n for (const [locale, lp] of Object.entries(this.customMapping)) {\n if (\n lp &&\n typeof lp === 'object' &&\n lp.regionCode &&\n !customRegionMapping[lp.regionCode]\n ) {\n const { regionName: name, emoji } = lp;\n customRegionMapping[lp.regionCode] = {\n locale,\n ...(name && { name }),\n ...(emoji && { emoji }),\n };\n }\n }\n this.customRegionMapping = customRegionMapping;\n }\n customMapping = this.customRegionMapping;\n }\n return _getRegionProperties(\n region,\n this.targetLocale, // this.targetLocale because we want it in the user's language\n customMapping\n );\n }\n\n /**\n * Determines whether a translation is required based on the source and target locales.\n *\n * @param {string} [sourceLocale=this.sourceLocale] - The locale code for the original content.\n * @param {string} [targetLocale=this.targetLocale] - The locale code to translate into.\n * @param {string[]} [approvedLocales=this.locales] - Optional array of approved target locales.\n * @returns {boolean} True if translation is required, false otherwise\n * @throws {Error} If no source locale is provided.\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.requiresTranslation('en-US', 'es-ES');\n * // Returns: true\n */\n requiresTranslation(\n sourceLocale = this.sourceLocale,\n targetLocale = this.targetLocale,\n approvedLocales: string[] | undefined = this.locales,\n customMapping: CustomMapping | undefined = this.customMapping\n ): boolean {\n if (!sourceLocale)\n throw new Error(noSourceLocaleProvidedError('requiresTranslation'));\n if (!targetLocale)\n throw new Error(noTargetLocaleProvidedError('requiresTranslation'));\n if (customMapping === this.customMapping) {\n return this.localeConfig.requiresTranslation(\n targetLocale,\n sourceLocale,\n approvedLocales\n );\n }\n return _requiresTranslation(\n sourceLocale,\n targetLocale,\n approvedLocales,\n customMapping\n );\n }\n\n /**\n * Determines the best matching locale from the provided approved locales list.\n *\n * @param {string | string[]} locales - A single locale or array of locales in preference order.\n * @param {string[]} [approvedLocales=this.locales] - Array of approved locales in preference order.\n * @returns {string | undefined} The best matching locale, or undefined if no match is found.\n *\n * @example\n * gt.determineLocale(['fr-CA', 'fr-FR'], ['en-US', 'fr-FR', 'es-ES']);\n * // Returns: \"fr-FR\"\n */\n determineLocale(\n locales: string | string[],\n approvedLocales: string[] | undefined = this.locales || [],\n customMapping: CustomMapping | undefined = this.customMapping\n ): string | undefined {\n if (customMapping === this.customMapping) {\n return this.localeConfig.determineLocale(locales, approvedLocales ?? []);\n }\n return _determineLocale(locales, approvedLocales, customMapping);\n }\n\n /**\n * Gets the text direction for a given locale code.\n *\n * @param {string} [locale=this.targetLocale] - A BCP-47 locale code.\n * @returns {'ltr' | 'rtl'} 'rtl' if the locale is right-to-left; otherwise 'ltr'.\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.getLocaleDirection('ar-SA');\n * // Returns: \"rtl\"\n */\n getLocaleDirection(locale = this.targetLocale): 'ltr' | 'rtl' {\n if (!locale)\n throw new Error(noTargetLocaleProvidedError('getLocaleDirection'));\n return this.localeConfig.getLocaleDirection(locale);\n }\n\n /**\n * Checks if a given BCP 47 locale code is valid.\n *\n * @param {string} [locale=this.targetLocale] - The BCP 47 locale code to validate.\n * @param {CustomMapping} [customMapping=this.customMapping] - The custom mapping to use for validation.\n * @returns {boolean} True if the locale code is valid, false otherwise\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.isValidLocale('en-US');\n * // Returns: true\n */\n isValidLocale(\n locale = this.targetLocale,\n customMapping: CustomMapping | undefined = this.customMapping\n ): boolean {\n if (!locale) throw new Error(noTargetLocaleProvidedError('isValidLocale'));\n if (customMapping === this.customMapping) {\n return this.localeConfig.isValidLocale(locale);\n }\n return _isValidLocale(locale, customMapping);\n }\n\n /**\n * Resolves the canonical locale for a given locale.\n * @param locale - The locale to resolve the canonical locale for\n * @param customMapping - The custom mapping to use for resolving the canonical locale\n * @returns The canonical locale, or the input locale when no canonical mapping exists.\n */\n resolveCanonicalLocale(\n locale: string | undefined = this.targetLocale,\n customMapping: CustomMapping | undefined = this.customMapping\n ): string {\n if (!locale)\n throw new Error(noTargetLocaleProvidedError('resolveCanonicalLocale'));\n if (customMapping === this.customMapping) {\n return this.localeConfig.resolveCanonicalLocale(locale);\n }\n return _resolveCanonicalLocale(locale, customMapping);\n }\n\n /**\n * Resolves the alias locale for a given locale.\n * @param locale - The locale to resolve the alias locale for\n * @param customMapping - The custom mapping to use for resolving the alias locale\n * @returns The configured alias for a canonical locale, or the input locale when already an alias or no alias mapping exists.\n */\n resolveAliasLocale(\n locale: string,\n customMapping: CustomMapping | undefined = this.customMapping\n ): string {\n if (!locale)\n throw new Error(noTargetLocaleProvidedError('resolveAliasLocale'));\n if (customMapping === this.customMapping) {\n return this.localeConfig.resolveAliasLocale(locale);\n }\n return _resolveAliasLocale(locale, customMapping);\n }\n\n /**\n * Standardizes a BCP 47 locale code to ensure correct formatting.\n *\n * @param {string} [locale=this.targetLocale] - The BCP 47 locale code to standardize.\n * @returns {string} The standardized locale code, or the input string if it cannot be standardized.\n * @throws {Error} If no target locale is provided.\n *\n * @example\n * gt.standardizeLocale('en_us');\n * // Returns: \"en-US\"\n */\n standardizeLocale(locale = this.targetLocale): string {\n if (!locale)\n throw new Error(noTargetLocaleProvidedError('standardizeLocale'));\n return this.localeConfig.standardizeLocale(locale);\n }\n\n /**\n * Checks if multiple BCP 47 locale codes represent the same dialect.\n *\n * @param {...(string | string[])} locales - The BCP 47 locale codes to compare.\n * @returns {boolean} True if all codes represent the same dialect, false otherwise\n *\n * @example\n * gt.isSameDialect('en-US', 'en-GB');\n * // Returns: false\n *\n * gt.isSameDialect('en', 'en-US');\n * // Returns: true\n */\n isSameDialect(...locales: (string | string[])[]): boolean {\n return this.localeConfig.isSameDialect(...locales);\n }\n\n /**\n * Checks if multiple BCP 47 locale codes represent the same language.\n *\n * @param {...(string | string[])} locales - The BCP 47 locale codes to compare.\n * @returns {boolean} True if all codes represent the same language, false otherwise\n *\n * @example\n * gt.isSameLanguage('en-US', 'en-GB');\n * // Returns: true\n */\n isSameLanguage(...locales: (string | string[])[]): boolean {\n return this.localeConfig.isSameLanguage(...locales);\n }\n\n /**\n * Checks if a locale is a superset of another locale.\n *\n * @param {string} superLocale - The locale to check if it is a superset\n * @param {string} subLocale - The locale to check if it is a subset\n * @returns {boolean} True if superLocale is a superset of subLocale, false otherwise\n *\n * @example\n * gt.isSupersetLocale('en', 'en-US');\n * // Returns: true\n *\n * gt.isSupersetLocale('en-US', 'en');\n * // Returns: false\n */\n isSupersetLocale(superLocale: string, subLocale: string): boolean {\n return this.localeConfig.isSupersetLocale(superLocale, subLocale);\n }\n}\n"],"mappings":"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"}
@@ -640,7 +640,7 @@ var GTRuntime = class {
640
640
  * Formats a message according to the specified locales and options.
641
641
  *
642
642
  * @param {string} message - The message to format.
643
- * @param {string | string[]} [locales='en'] - The locales to use for formatting.
643
+ * @param {string | string[]} [locales=libraryDefaultLocale] - The locales to use for formatting.
644
644
  * @param {FormatVariables} [variables={}] - The variables to use for formatting.
645
645
  * @param {StringFormat} [dataFormat='ICU'] - The format of the message.
646
646
  * @returns {string} The formatted message.
@@ -1096,4 +1096,4 @@ Object.defineProperty(exports, "validateResponse", {
1096
1096
  }
1097
1097
  });
1098
1098
 
1099
- //# sourceMappingURL=runtime-wK7jzE9f.cjs.map
1099
+ //# sourceMappingURL=runtime-mKpF6P4Q.cjs.map