generaltranslation 9.4.0 → 9.4.2
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.
- package/CHANGELOG.md +24 -0
- package/dist/adapter/createGtApi.d.ts +4 -4
- package/dist/adapter/createGtApi.js +17 -12
- package/dist/index.cjs +61 -29
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +85 -32
- package/dist/index.mjs +61 -29
- package/dist/index.mjs.map +1 -1
- package/dist/internal.cjs +15 -11
- package/dist/internal.cjs.map +1 -1
- package/dist/internal.d.cts +4 -4
- package/dist/internal.d.mts +4 -4
- package/dist/internal.mjs +16 -12
- package/dist/internal.mjs.map +1 -1
- package/dist/openapi.json +95 -30
- package/dist/{runtime-BiKgjDUI.mjs → runtime-Bcp4F2ME.mjs} +31 -13
- package/dist/runtime-Bcp4F2ME.mjs.map +1 -0
- package/dist/{runtime-BGUJYxhI.cjs → runtime-C25lwh9m.cjs} +30 -12
- package/dist/runtime-C25lwh9m.cjs.map +1 -0
- package/dist/runtime.cjs +1 -1
- package/dist/runtime.d.cts +8 -0
- package/dist/runtime.d.mts +8 -0
- package/dist/runtime.d.ts +8 -0
- package/dist/runtime.js +44 -14
- package/dist/runtime.mjs +1 -1
- package/package.json +3 -3
- package/dist/runtime-BGUJYxhI.cjs.map +0 -1
- package/dist/runtime-BiKgjDUI.mjs.map +0 -1
package/dist/openapi.json
CHANGED
|
@@ -165,6 +165,10 @@
|
|
|
165
165
|
}
|
|
166
166
|
]
|
|
167
167
|
},
|
|
168
|
+
"DataFormat": {
|
|
169
|
+
"type": "string",
|
|
170
|
+
"enum": ["JSX", "ICU", "I18NEXT", "STRING"]
|
|
171
|
+
},
|
|
168
172
|
"ModelProvider": {
|
|
169
173
|
"type": "string",
|
|
170
174
|
"enum": ["ANTHROPIC", "OPENAI", "XAI", "GOOGLE"]
|
|
@@ -211,10 +215,6 @@
|
|
|
211
215
|
]
|
|
212
216
|
}
|
|
213
217
|
},
|
|
214
|
-
"DataFormat": {
|
|
215
|
-
"type": "string",
|
|
216
|
-
"enum": ["JSX", "ICU", "I18NEXT", "STRING"]
|
|
217
|
-
},
|
|
218
218
|
"RuntimeTranslationRequest": {
|
|
219
219
|
"type": "object",
|
|
220
220
|
"properties": {
|
|
@@ -242,6 +242,9 @@
|
|
|
242
242
|
"dataFormat": {
|
|
243
243
|
"$ref": "#/components/schemas/DataFormat"
|
|
244
244
|
},
|
|
245
|
+
"fileFormat": {
|
|
246
|
+
"$ref": "#/components/schemas/RuntimeFileFormat"
|
|
247
|
+
},
|
|
245
248
|
"actionType": {
|
|
246
249
|
"type": "string",
|
|
247
250
|
"enum": ["fast", "standard"],
|
|
@@ -267,9 +270,6 @@
|
|
|
267
270
|
"required": ["before", "target", "after"]
|
|
268
271
|
}
|
|
269
272
|
}
|
|
270
|
-
},
|
|
271
|
-
"fileFormat": {
|
|
272
|
-
"$ref": "#/components/schemas/RuntimeFileFormat"
|
|
273
273
|
}
|
|
274
274
|
},
|
|
275
275
|
"default": {
|
|
@@ -299,6 +299,10 @@
|
|
|
299
299
|
},
|
|
300
300
|
"required": ["requests", "targetLocale", "sourceLocale", "metadata"]
|
|
301
301
|
},
|
|
302
|
+
"RuntimeFileFormat": {
|
|
303
|
+
"type": "string",
|
|
304
|
+
"enum": ["MD", "MDX"]
|
|
305
|
+
},
|
|
302
306
|
"CreateCliWizardSessionResponse": {
|
|
303
307
|
"type": "object",
|
|
304
308
|
"properties": {
|
|
@@ -319,7 +323,9 @@
|
|
|
319
323
|
"CliKeyType": {
|
|
320
324
|
"type": "string",
|
|
321
325
|
"enum": ["development", "production", "all"],
|
|
322
|
-
"default": "production"
|
|
326
|
+
"default": "production",
|
|
327
|
+
"deprecated": true,
|
|
328
|
+
"description": "Compatibility response slots. The wizard creates one project API key for all requested environments."
|
|
323
329
|
},
|
|
324
330
|
"CliWizardSessionReadyResponse": {
|
|
325
331
|
"anyOf": [
|
|
@@ -382,10 +388,6 @@
|
|
|
382
388
|
}
|
|
383
389
|
},
|
|
384
390
|
"required": ["message"]
|
|
385
|
-
},
|
|
386
|
-
"RuntimeFileFormat": {
|
|
387
|
-
"type": "string",
|
|
388
|
-
"enum": ["MD", "MDX"]
|
|
389
391
|
}
|
|
390
392
|
},
|
|
391
393
|
"parameters": {}
|
|
@@ -412,11 +414,13 @@
|
|
|
412
414
|
"properties": {
|
|
413
415
|
"fileId": {
|
|
414
416
|
"type": "string",
|
|
415
|
-
"minLength": 1
|
|
417
|
+
"minLength": 1,
|
|
418
|
+
"description": "File ID assigned by Google Drive, found in the Google Docs or Slides URL after /d/. This is not a GT database file ID. May identify a source file or a GT-managed translated copy. Supply hostApp with fileId for file-specific context; omit both to list connected projects."
|
|
416
419
|
},
|
|
417
420
|
"hostApp": {
|
|
418
421
|
"type": "string",
|
|
419
|
-
"enum": ["DOCS", "SLIDES"]
|
|
422
|
+
"enum": ["DOCS", "SLIDES"],
|
|
423
|
+
"description": "Google editor for the file: DOCS for Google Docs or SLIDES for Google Slides. Supply fileId with hostApp for file-specific context."
|
|
420
424
|
}
|
|
421
425
|
}
|
|
422
426
|
}
|
|
@@ -845,15 +849,18 @@
|
|
|
845
849
|
"properties": {
|
|
846
850
|
"projectId": {
|
|
847
851
|
"type": "string",
|
|
848
|
-
"minLength": 1
|
|
852
|
+
"minLength": 1,
|
|
853
|
+
"description": "GT project ID returned by get_google_drive_context. The project must have a Google Drive integration connected in the GT dashboard."
|
|
849
854
|
},
|
|
850
855
|
"fileId": {
|
|
851
856
|
"type": "string",
|
|
852
|
-
"minLength": 1
|
|
857
|
+
"minLength": 1,
|
|
858
|
+
"description": "File ID assigned by Google Drive, found in the Google Docs or Slides URL after /d/. This is not a GT database file ID. May identify a source file or a GT-managed translated copy."
|
|
853
859
|
},
|
|
854
860
|
"hostApp": {
|
|
855
861
|
"type": "string",
|
|
856
|
-
"enum": ["DOCS", "SLIDES"]
|
|
862
|
+
"enum": ["DOCS", "SLIDES"],
|
|
863
|
+
"description": "Google editor for the file: DOCS for Google Docs or SLIDES for Google Slides."
|
|
857
864
|
},
|
|
858
865
|
"targetLocales": {
|
|
859
866
|
"type": "array",
|
|
@@ -862,14 +869,17 @@
|
|
|
862
869
|
"minLength": 1
|
|
863
870
|
},
|
|
864
871
|
"minItems": 1,
|
|
865
|
-
"maxItems": 100
|
|
872
|
+
"maxItems": 100,
|
|
873
|
+
"description": "One to 100 supported target locale codes, such as fr or es-MX. Must respect the project locale whitelist. For a GT-managed translated copy, only that copy’s target locale is used."
|
|
866
874
|
},
|
|
867
875
|
"sourceLocale": {
|
|
868
876
|
"type": "string",
|
|
869
|
-
"minLength": 1
|
|
877
|
+
"minLength": 1,
|
|
878
|
+
"description": "Optional source locale code, such as en. Defaults to the file’s stored source locale, then the project default. Ignored for a GT-managed translated copy, whose original source locale is used."
|
|
870
879
|
},
|
|
871
880
|
"force": {
|
|
872
|
-
"type": "boolean"
|
|
881
|
+
"type": "boolean",
|
|
882
|
+
"description": "Whether to force retranslation of existing translations. Defaults to false. Retranslation may incur additional translation charges."
|
|
873
883
|
}
|
|
874
884
|
},
|
|
875
885
|
"required": ["projectId", "fileId", "hostApp", "targetLocales"]
|
|
@@ -1146,15 +1156,18 @@
|
|
|
1146
1156
|
"properties": {
|
|
1147
1157
|
"projectId": {
|
|
1148
1158
|
"type": "string",
|
|
1149
|
-
"minLength": 1
|
|
1159
|
+
"minLength": 1,
|
|
1160
|
+
"description": "GT project ID returned by get_google_drive_context. The project must have a Google Drive integration connected in the GT dashboard."
|
|
1150
1161
|
},
|
|
1151
1162
|
"fileId": {
|
|
1152
1163
|
"type": "string",
|
|
1153
|
-
"minLength": 1
|
|
1164
|
+
"minLength": 1,
|
|
1165
|
+
"description": "File ID assigned by Google Drive, found in the Google Docs or Slides URL after /d/. This is not a GT database file ID. May identify a source file or a GT-managed translated copy."
|
|
1154
1166
|
},
|
|
1155
1167
|
"hostApp": {
|
|
1156
1168
|
"type": "string",
|
|
1157
|
-
"enum": ["DOCS", "SLIDES"]
|
|
1169
|
+
"enum": ["DOCS", "SLIDES"],
|
|
1170
|
+
"description": "Google editor for the file: DOCS for Google Docs or SLIDES for Google Slides."
|
|
1158
1171
|
}
|
|
1159
1172
|
},
|
|
1160
1173
|
"required": ["projectId", "fileId", "hostApp"]
|
|
@@ -1968,7 +1981,50 @@
|
|
|
1968
1981
|
"type": "number"
|
|
1969
1982
|
}
|
|
1970
1983
|
},
|
|
1971
|
-
"required": ["x", "y", "width", "height"]
|
|
1984
|
+
"required": ["x", "y", "width", "height"],
|
|
1985
|
+
"additionalProperties": false
|
|
1986
|
+
},
|
|
1987
|
+
"render": {
|
|
1988
|
+
"type": "object",
|
|
1989
|
+
"properties": {
|
|
1990
|
+
"x": {
|
|
1991
|
+
"type": "number"
|
|
1992
|
+
},
|
|
1993
|
+
"y": {
|
|
1994
|
+
"type": "number"
|
|
1995
|
+
},
|
|
1996
|
+
"width": {
|
|
1997
|
+
"type": "number"
|
|
1998
|
+
},
|
|
1999
|
+
"height": {
|
|
2000
|
+
"type": "number"
|
|
2001
|
+
}
|
|
2002
|
+
},
|
|
2003
|
+
"required": ["x", "y", "width", "height"],
|
|
2004
|
+
"additionalProperties": false
|
|
2005
|
+
},
|
|
2006
|
+
"room": {
|
|
2007
|
+
"type": "object",
|
|
2008
|
+
"properties": {
|
|
2009
|
+
"left": {
|
|
2010
|
+
"type": "number",
|
|
2011
|
+
"minimum": 0
|
|
2012
|
+
},
|
|
2013
|
+
"right": {
|
|
2014
|
+
"type": "number",
|
|
2015
|
+
"minimum": 0
|
|
2016
|
+
},
|
|
2017
|
+
"up": {
|
|
2018
|
+
"type": "number",
|
|
2019
|
+
"minimum": 0
|
|
2020
|
+
},
|
|
2021
|
+
"down": {
|
|
2022
|
+
"type": "number",
|
|
2023
|
+
"minimum": 0
|
|
2024
|
+
}
|
|
2025
|
+
},
|
|
2026
|
+
"required": ["left", "right", "up", "down"],
|
|
2027
|
+
"additionalProperties": false
|
|
1972
2028
|
},
|
|
1973
2029
|
"autoResize": {
|
|
1974
2030
|
"type": "string",
|
|
@@ -1979,6 +2035,10 @@
|
|
|
1979
2035
|
"TRUNCATE"
|
|
1980
2036
|
]
|
|
1981
2037
|
},
|
|
2038
|
+
"textAlignHorizontal": {
|
|
2039
|
+
"type": "string",
|
|
2040
|
+
"enum": ["LEFT", "CENTER", "RIGHT", "JUSTIFIED"]
|
|
2041
|
+
},
|
|
1982
2042
|
"baseFontPt": {
|
|
1983
2043
|
"type": "number"
|
|
1984
2044
|
},
|
|
@@ -3376,7 +3436,7 @@
|
|
|
3376
3436
|
"type": "string"
|
|
3377
3437
|
},
|
|
3378
3438
|
"defaultLocale": {
|
|
3379
|
-
"type":
|
|
3439
|
+
"type": "string"
|
|
3380
3440
|
},
|
|
3381
3441
|
"currentLocales": {
|
|
3382
3442
|
"type": "array",
|
|
@@ -7022,13 +7082,14 @@
|
|
|
7022
7082
|
"$ref": "#/components/schemas/FileFormat"
|
|
7023
7083
|
},
|
|
7024
7084
|
"dataFormat": {
|
|
7025
|
-
"
|
|
7085
|
+
"$ref": "#/components/schemas/DataFormat"
|
|
7026
7086
|
},
|
|
7027
7087
|
"locale": {
|
|
7028
7088
|
"type": "string"
|
|
7029
7089
|
}
|
|
7030
7090
|
},
|
|
7031
7091
|
"required": [
|
|
7092
|
+
"branchId",
|
|
7032
7093
|
"fileId",
|
|
7033
7094
|
"versionId",
|
|
7034
7095
|
"fileName",
|
|
@@ -7620,7 +7681,7 @@
|
|
|
7620
7681
|
"post": {
|
|
7621
7682
|
"operationId": "translate",
|
|
7622
7683
|
"summary": "Translate content at runtime",
|
|
7623
|
-
"description": "Translate one or more strings
|
|
7684
|
+
"description": "Translate one or more strings, structured content entries, or markdown documents with caching and memoization. Markdown and MDX documents are sent as strings with `fileFormat` set to MD or MDX. Development API keys are accepted for this endpoint.",
|
|
7624
7685
|
"security": [
|
|
7625
7686
|
{
|
|
7626
7687
|
"BearerAuth": []
|
|
@@ -8042,13 +8103,14 @@
|
|
|
8042
8103
|
"$ref": "#/components/schemas/FileFormat"
|
|
8043
8104
|
},
|
|
8044
8105
|
"dataFormat": {
|
|
8045
|
-
"
|
|
8106
|
+
"$ref": "#/components/schemas/DataFormat"
|
|
8046
8107
|
},
|
|
8047
8108
|
"locale": {
|
|
8048
8109
|
"type": "string"
|
|
8049
8110
|
}
|
|
8050
8111
|
},
|
|
8051
8112
|
"required": [
|
|
8113
|
+
"branchId",
|
|
8052
8114
|
"fileId",
|
|
8053
8115
|
"versionId",
|
|
8054
8116
|
"fileName",
|
|
@@ -8240,7 +8302,8 @@
|
|
|
8240
8302
|
"type": {
|
|
8241
8303
|
"type": "string",
|
|
8242
8304
|
"enum": ["production", "development"],
|
|
8243
|
-
"
|
|
8305
|
+
"deprecated": true,
|
|
8306
|
+
"description": "Ignored. All new keys are project-scoped API keys for any environment."
|
|
8244
8307
|
}
|
|
8245
8308
|
},
|
|
8246
8309
|
"required": ["name"],
|
|
@@ -8274,7 +8337,9 @@
|
|
|
8274
8337
|
},
|
|
8275
8338
|
"type": {
|
|
8276
8339
|
"type": "string",
|
|
8277
|
-
"enum": ["production",
|
|
8340
|
+
"enum": ["production"],
|
|
8341
|
+
"deprecated": true,
|
|
8342
|
+
"description": "Compatibility field. All project API keys work in any environment."
|
|
8278
8343
|
}
|
|
8279
8344
|
},
|
|
8280
8345
|
"required": ["id", "name", "key", "projectId", "type"]
|
|
@@ -2,7 +2,7 @@ import { l as defaultTimeout, r as unwrapApiResult, s as createDiagnosticMessage
|
|
|
2
2
|
import { t as ApiError } from "./ApiError-CUKcz3YS.mjs";
|
|
3
3
|
import { t as hashSource } from "./id-X2zyx5Jk.mjs";
|
|
4
4
|
import { createApiClient, translate } from "@generaltranslation/api";
|
|
5
|
-
import { LocaleConfig,
|
|
5
|
+
import { LocaleConfig, getRegionProperties, isValidLocale, requiresTranslation, resolveAliasLocale, resolveCanonicalLocale } from "@generaltranslation/format";
|
|
6
6
|
//#region src/logging/errors.ts
|
|
7
7
|
const GT_SOURCE = "GT";
|
|
8
8
|
const translationTimeoutError = (timeout) => createDiagnosticMessage({
|
|
@@ -410,23 +410,23 @@ var GTRuntime = class {
|
|
|
410
410
|
this.setConfig(params);
|
|
411
411
|
}
|
|
412
412
|
setConfig({ apiKey, devApiKey, sourceLocale, targetLocale, locales, projectId, customMapping, baseUrl }) {
|
|
413
|
+
const effectiveCustomMapping = customMapping ?? this.customMapping;
|
|
413
414
|
if (apiKey) this.apiKey = apiKey;
|
|
414
415
|
if (devApiKey) this.devApiKey = devApiKey;
|
|
415
416
|
if (projectId) this.projectId = projectId;
|
|
416
417
|
if (sourceLocale) {
|
|
417
|
-
this.sourceLocale =
|
|
418
|
-
if (!isValidLocale(this.sourceLocale,
|
|
418
|
+
this.sourceLocale = sourceLocale;
|
|
419
|
+
if (!isValidLocale(this.sourceLocale, effectiveCustomMapping)) throw new Error(invalidLocaleError(this.sourceLocale));
|
|
419
420
|
}
|
|
420
421
|
if (targetLocale) {
|
|
421
|
-
this.targetLocale =
|
|
422
|
-
if (!isValidLocale(this.targetLocale,
|
|
422
|
+
this.targetLocale = targetLocale;
|
|
423
|
+
if (!isValidLocale(this.targetLocale, effectiveCustomMapping)) throw new Error(invalidLocaleError(this.targetLocale));
|
|
423
424
|
}
|
|
424
425
|
if (locales) {
|
|
425
426
|
const result = [];
|
|
426
427
|
const invalidLocales = [];
|
|
427
428
|
locales.forEach((locale) => {
|
|
428
|
-
|
|
429
|
-
if (isValidLocale(standardizedLocale)) result.push(standardizedLocale);
|
|
429
|
+
if (isValidLocale(locale, effectiveCustomMapping)) result.push(locale);
|
|
430
430
|
else invalidLocales.push(locale);
|
|
431
431
|
});
|
|
432
432
|
if (invalidLocales.length > 0) throw new Error(invalidLocalesError(invalidLocales));
|
|
@@ -443,6 +443,24 @@ var GTRuntime = class {
|
|
|
443
443
|
customMapping: this.customMapping
|
|
444
444
|
});
|
|
445
445
|
}
|
|
446
|
+
/** Convert app identity only where a GT service expects a language code. */
|
|
447
|
+
resolveServiceLocale(locale) {
|
|
448
|
+
return this.standardizeLocale(this.resolveCanonicalLocale(locale));
|
|
449
|
+
}
|
|
450
|
+
/**
|
|
451
|
+
* Recover configured spelling without negotiating an unrelated dialect.
|
|
452
|
+
* When several identities use the same service code and there is no request
|
|
453
|
+
* context to disambiguate them, the first configured identity wins.
|
|
454
|
+
*/
|
|
455
|
+
resolveServiceResponseLocale(locale) {
|
|
456
|
+
const canonical = this.standardizeLocale(locale);
|
|
457
|
+
return [
|
|
458
|
+
...this.locales ?? [],
|
|
459
|
+
this.sourceLocale,
|
|
460
|
+
this.targetLocale,
|
|
461
|
+
...Object.keys(this.customMapping ?? {})
|
|
462
|
+
].find((candidate) => candidate && this.resolveServiceLocale(candidate) === canonical) ?? locale;
|
|
463
|
+
}
|
|
446
464
|
_getTranslationConfig() {
|
|
447
465
|
return {
|
|
448
466
|
baseUrl: this.baseUrl,
|
|
@@ -489,8 +507,8 @@ var GTRuntime = class {
|
|
|
489
507
|
gtInstanceLogger.error(error);
|
|
490
508
|
throw new Error(error);
|
|
491
509
|
}
|
|
492
|
-
targetLocale = this.
|
|
493
|
-
const sourceLocale = this.
|
|
510
|
+
targetLocale = this.resolveServiceLocale(targetLocale);
|
|
511
|
+
const sourceLocale = this.resolveServiceLocale(options?.sourceLocale || this.sourceLocale || "en");
|
|
494
512
|
return (await _translateMany([source], {
|
|
495
513
|
...options,
|
|
496
514
|
targetLocale,
|
|
@@ -506,8 +524,8 @@ var GTRuntime = class {
|
|
|
506
524
|
gtInstanceLogger.error(error);
|
|
507
525
|
throw new Error(error);
|
|
508
526
|
}
|
|
509
|
-
targetLocale = this.
|
|
510
|
-
const sourceLocale = this.
|
|
527
|
+
targetLocale = this.resolveServiceLocale(targetLocale);
|
|
528
|
+
const sourceLocale = this.resolveServiceLocale(options?.sourceLocale || this.sourceLocale || "en");
|
|
511
529
|
return await _translateMany(sources, {
|
|
512
530
|
...options,
|
|
513
531
|
targetLocale,
|
|
@@ -832,7 +850,7 @@ var GTRuntime = class {
|
|
|
832
850
|
*/
|
|
833
851
|
determineLocale(locales, approvedLocales = this.locales || [], customMapping = this.customMapping) {
|
|
834
852
|
if (customMapping === this.customMapping) return this.localeConfig.determineLocale(locales, approvedLocales ?? []);
|
|
835
|
-
return determineLocale(locales, approvedLocales
|
|
853
|
+
return new LocaleConfig({ customMapping }).determineLocale(locales, approvedLocales ?? []);
|
|
836
854
|
}
|
|
837
855
|
/**
|
|
838
856
|
* Gets the text direction for a given locale code.
|
|
@@ -953,4 +971,4 @@ var GTRuntime = class {
|
|
|
953
971
|
//#endregion
|
|
954
972
|
export { gtInstanceLogger as a, translationRequestFailedError as c, fetchLogger as i, translationTimeoutError as l, validateResponse as n, noSourceLocaleProvidedError as o, fetchWithTimeout as r, noTargetLocaleProvidedError as s, GTRuntime as t };
|
|
955
973
|
|
|
956
|
-
//# sourceMappingURL=runtime-
|
|
974
|
+
//# sourceMappingURL=runtime-Bcp4F2ME.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runtime-Bcp4F2ME.mjs","names":["_isValidLocale","_getRegionProperties","_requiresTranslation","_resolveCanonicalLocale","_resolveAliasLocale"],"sources":["../src/logging/errors.ts","../src/logging/logger.ts","../src/translate/utils/fetchWithTimeout.ts","../src/translate/utils/validateResponse.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 signals = [controller.signal];\n if (options.signal) signals.push(options.signal);\n if (url instanceof Request) signals.push(url.signal);\n const signal = AbortSignal.any(signals);\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 {\n createApiClient,\n translate,\n type TranslateData,\n} from '@generaltranslation/api';\nimport {\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 type { Content } from '@generaltranslation/format/types';\nimport { hashSource } from '../id';\nimport { fetchWithTimeout } from './utils/fetchWithTimeout';\nimport { hasDecodedError, unwrapApiResult } from './utils/unwrapApiResult';\nimport { validateResponse } from './utils/validateResponse';\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 ...(metadata?.fileFormat && { fileFormat: metadata.fileFormat }),\n dataFormat: metadata?.dataFormat ?? 'STRING',\n });\n hashOrder?.push(hash);\n requestsObject[hash] = {\n source,\n metadata: metadata,\n };\n }\n\n const client = createApiClient({\n apiKey: config.apiKey,\n baseUrl: config.baseUrl || defaultRuntimeApiUrl,\n fetch: (input, init) => fetchWithTimeout(input, init ?? {}, timeout),\n projectId: config.projectId,\n retryPolicy: 'none',\n timeoutMs: false,\n });\n const body = {\n requests: requestsObject,\n targetLocale: globalMetadata.targetLocale,\n sourceLocale: globalMetadata.sourceLocale,\n // Core intentionally accepts custom model-provider strings beyond the\n // OpenAPI ANTHROPIC|OPENAI|XAI|GOOGLE enum; preserve the pre-migration\n // wire behavior at this boundary.\n metadata: globalMetadata as TranslateData['body']['metadata'],\n } satisfies TranslateData['body'];\n const result = await translate({ body, client });\n\n // The generated client only decodes JSON errors, so non-JSON response bodies\n // must be re-read here to preserve legacy ApiError details.\n if (\n result.data === undefined &&\n result.response &&\n !hasDecodedError(result)\n ) {\n await validateResponse(result.response);\n throw result.error;\n }\n\n const runtimeResponse = unwrapApiResult(result);\n // OpenAPI allows an optional JsonValue translation, while core's published\n // result requires the format-specific Content union.\n const response = runtimeResponse as Record<string, TranslationResult>;\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 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 const effectiveCustomMapping = customMapping ?? this.customMapping;\n\n // ----- Environment properties ----- //\n if (apiKey) this.apiKey = apiKey;\n if (devApiKey) this.devApiKey = devApiKey;\n if (projectId) this.projectId = projectId;\n\n // ----- Validate configured locale identities ----- //\n\n // source locale\n if (sourceLocale) {\n this.sourceLocale = sourceLocale;\n if (!_isValidLocale(this.sourceLocale, effectiveCustomMapping))\n throw new Error(invalidLocaleError(this.sourceLocale));\n }\n\n // target locale\n if (targetLocale) {\n this.targetLocale = targetLocale;\n if (!_isValidLocale(this.targetLocale, effectiveCustomMapping))\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 if (_isValidLocale(locale, effectiveCustomMapping)) {\n result.push(locale);\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 /** Convert app identity only where a GT service expects a language code. */\n protected resolveServiceLocale(locale: string): string {\n return this.standardizeLocale(this.resolveCanonicalLocale(locale));\n }\n\n /**\n * Recover configured spelling without negotiating an unrelated dialect.\n * When several identities use the same service code and there is no request\n * context to disambiguate them, the first configured identity wins.\n */\n protected resolveServiceResponseLocale(locale: string): string {\n const canonical = this.standardizeLocale(locale);\n const configured = [\n ...(this.locales ?? []),\n this.sourceLocale,\n this.targetLocale,\n ...Object.keys(this.customMapping ?? {}),\n ];\n return (\n configured.find(\n (candidate) =>\n candidate && this.resolveServiceLocale(candidate) === canonical\n ) ?? locale\n );\n }\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.resolveServiceLocale(targetLocale);\n\n const sourceLocale = this.resolveServiceLocale(\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.resolveServiceLocale(targetLocale);\n\n const sourceLocale = this.resolveServiceLocale(\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 new LocaleConfig({ customMapping }).determineLocale(\n locales,\n approvedLocales ?? []\n );\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":";;;;;;AAEA,MAAM,YAAY;AAElB,MAAa,2BAA2B,YACtC,wBAAwB;CACtB,QAAQ;CACR,UAAU;CACV,cAAc,uCAAuC,QAAQ;CAC7D,KAAK;CACN,CAAC;AAEJ,MAAa,iCAAiC,UAC5C,wBAAwB;CACtB,QAAQ;CACR,UAAU;CACV,cAAc;CACd,KAAK;CACL,SAAS;CACV,CAAC;AAEJ,MAAa,YAAY,QAAgB,YAAoB,UAC3D,wBAAwB;CACtB,QAAQ;CACR,UAAU;CACV,cAAc,gCAAgC,OAAO,GAAG;CACxD,KAAK;CACL,SAAS;CACV,CAAC;AAE4B,wBAAwB;CACtD,QAAQ;CACR,UAAU;CACV,cAAc;CACd,KAAK;CACN,CAAC;AAEF,MAAa,+BAA+B,iBAC1C,wBAAwB;CACtB,QAAQ;CACR,UAAU;CACV,cAAc,iBAAiB,aAAa;CAC5C,KAAK,sBAAsB,aAAa;CACzC,CAAC;AAEJ,MAAa,+BAA+B,iBAC1C,wBAAwB;CACtB,QAAQ;CACR,UAAU;CACV,cAAc,iBAAiB,aAAa;CAC5C,KAAK,sBAAsB,aAAa;CACzC,CAAC;AAEJ,MAAa,4BAA4B,iBACvC,wBAAwB;CACtB,QAAQ;CACR,UAAU;CACV,cAAc,iBAAiB,aAAa;CAC5C,KAAK,0BAA0B,aAAa;CAC7C,CAAC;AAEJ,MAAa,yBAAyB,iBACpC,wBAAwB;CACtB,QAAQ;CACR,UAAU;CACV,cAAc,iBAAiB,aAAa;CAC5C,KAAK,wBAAwB,aAAa;CAC3C,CAAC;AAEJ,MAAa,sBAAsB,WACjC,wBAAwB;CACtB,QAAQ;CACR,UAAU;CACV,cAAc,WAAW,OAAO;CAChC,KAAK;CACN,CAAC;AAEJ,MAAa,uBAAuB,YAClC,wBAAwB;CACtB,QAAQ;CACR,UAAU;CACV,cAAc,gCAAgC,QAAQ,KAAK,KAAK;CAChE,KAAK;CACN,CAAC;;;ACpCJ,MAAM,aAAuC;CAC3C,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,KAAK;CACN;AAED,MAAM,aAAuC;CAC3C,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,KAAK;CACN;AAED,MAAM,cAAc;;;;AAKpB,SAAS,wBAAkC;AACzC,KAAI,OAAO,YAAY,eAAe,QAAQ,KAAK,eAAe;EAChE,MAAM,WAAW,QAAQ,IAAI,cAAc,aAAa;AACxD,MAAI,YAAY,WACd,QAAO;;AAGX,QAAO;;;;;AAMT,IAAa,oBAAb,MAAqD;CAGnD,YAAY,QAAsB;AAChC,OAAK,SAAS;;CAGhB,OAAO,OAAuB;EAC5B,MAAM,QAAkB,EAAE;AAG1B,MAAI,KAAK,OAAO,iBACd,OAAM,KAAK,IAAI,MAAM,UAAU,aAAa,CAAC,GAAG;EAIlD,MAAM,YAAY,WAAW,MAAM;EACnC,MAAM,YAAY,IAAI,MAAM,MAAM,aAAa,CAAC;AAChD,QAAM,KAAK,GAAG,YAAY,YAAY,cAAc;AAGpD,MAAI,KAAK,OAAO,OACd,OAAM,KAAK,IAAI,KAAK,OAAO,OAAO,GAAG;AAIvC,MAAI,KAAK,OAAO,kBAAkB,MAAM,QACtC,OAAM,KAAK,IAAI,MAAM,QAAQ,GAAG;AAIlC,QAAM,KAAK,MAAM,QAAQ;AAGzB,MAAI,MAAM,YAAY,OAAO,KAAK,MAAM,SAAS,CAAC,SAAS,EACzD,OAAM,KAAK,iBAAiB,KAAK,UAAU,MAAM,UAAU,MAAM,EAAE,GAAG;EAGxE,MAAM,mBAAmB,MAAM,KAAK,IAAI;AAGxC,UAAQ,MAAM,OAAd;GACE,KAAK;AAEH,YAAQ,MAAM,iBAAiB;AAC/B;GACF,KAAK;AAEH,YAAQ,KAAK,iBAAiB;AAC9B;GACF,KAAK;AACH,YAAQ,KAAK,iBAAiB;AAC9B;GACF,KAAK;AACH,YAAQ,MAAM,iBAAiB;AAC/B;;;;;;;AAQR,IAAa,SAAb,MAAoB;CAIlB,YAAY,SAAgC,EAAE,EAAE;AAC9C,OAAK,SAAS;GACZ,OAAO,uBAAuB;GAC9B,kBAAkB;GAClB,gBAAgB;GAChB,eAAe;GACf,UAAU,EAAE;GACZ,GAAG;GACJ;AAED,OAAK,WAAW,CAAC,GAAI,KAAK,OAAO,YAAY,EAAE,CAAE;AAGjD,MAAI,KAAK,OAAO,cACd,MAAK,SAAS,KAAK,IAAI,kBAAkB,KAAK,OAAO,CAAC;;;;;CAO1D,WAAW,SAA2B;AACpC,OAAK,SAAS,KAAK,QAAQ;;;;;CAM7B,cAAc,SAA2B;EACvC,MAAM,QAAQ,KAAK,SAAS,QAAQ,QAAQ;AAC5C,MAAI,QAAQ,GACV,MAAK,SAAS,OAAO,OAAO,EAAE;;;;;CAOlC,UAAU,QAAqC;AAC7C,OAAK,SAAS;GAAE,GAAG,KAAK;GAAQ,GAAG;GAAQ;;;;;CAM7C,UAAkB,OAA0B;AAC1C,SAAO,WAAW,UAAU,WAAW,KAAK,OAAO;;;;;CAMrD,IACE,OACA,SACA,SACA,UACM;AACN,MAAI,CAAC,KAAK,UAAU,MAAM,CACxB;EAGF,MAAM,QAAkB;GACtB;GACA;GACA,2BAAW,IAAI,MAAM;GACrB;GACA;GACD;AAGD,OAAK,SAAS,SAAS,YAAY;AACjC,OAAI;AACF,YAAQ,OAAO,MAAM;YACd,OAAO;AAEd,YAAQ,MAAM,yBAAyB,MAAM;;IAE/C;;;;;;CAOJ,MAAM,SAAiB,SAAkB,UAA8B;AACrE,OAAK,IAAI,SAAS,SAAS,SAAS,SAAS;;;;;;CAO/C,KAAK,SAAiB,SAAkB,UAA8B;AACpE,OAAK,IAAI,QAAQ,SAAS,SAAS,SAAS;;;;;;CAO9C,KAAK,SAAiB,SAAkB,UAA8B;AACpE,OAAK,IAAI,QAAQ,SAAS,SAAS,SAAS;;;;;;CAO9C,MAAM,SAAiB,SAAkB,UAA8B;AACrE,OAAK,IAAI,SAAS,SAAS,SAAS,SAAS;;;;;CAM/C,MAAM,SAAgC;AACpC,SAAO,IAAI,cAAc,MAAM,QAAQ;;;;;CAMzC,YAA0B;AACxB,SAAO,EAAE,GAAG,KAAK,QAAQ;;;;;;AAO7B,IAAa,gBAAb,MAAa,cAAc;CAIzB,YAAY,QAAgB,SAAiB;AAC3C,OAAK,SAAS;AACd,OAAK,UAAU;;CAGjB,MAAM,SAAiB,UAA8B;AACnD,OAAK,OAAO,MAAM,SAAS,KAAK,SAAS,SAAS;;CAGpD,KAAK,SAAiB,UAA8B;AAClD,OAAK,OAAO,KAAK,SAAS,KAAK,SAAS,SAAS;;CAGnD,KAAK,SAAiB,UAA8B;AAClD,OAAK,OAAO,KAAK,SAAS,KAAK,SAAS,SAAS;;CAGnD,MAAM,SAAiB,UAA8B;AACnD,OAAK,OAAO,MAAM,SAAS,KAAK,SAAS,SAAS;;CAGpD,MAAM,cAAqC;AACzC,SAAO,IAAI,cAAc,KAAK,QAAQ,GAAG,KAAK,QAAQ,GAAG,eAAe;;;AAK5E,MAAa,gBAAgB,IAAI,OAAO;CACtC,OAAO,uBAAuB;CAC9B,kBAAkB;CAClB,gBAAgB;CAChB,QAAQ;CACT,CAAC;AA4BF,MAAa,cAAc,cAAc,MAAM,QAAQ;AACvD,MAAa,mBAAmB,cAAc,MAAM,cAAc;;;;;;;;;;;;;AC3UlE,eAAsB,iBACpB,KACA,SACA,SACA;CACA,MAAM,aAAa,IAAI,iBAAiB;CACxC,MAAM,UAAU,CAAC,WAAW,OAAO;AACnC,KAAI,QAAQ,OAAQ,SAAQ,KAAK,QAAQ,OAAO;AAChD,KAAI,eAAe,QAAS,SAAQ,KAAK,IAAI,OAAO;CACpD,MAAM,SAAS,YAAY,IAAI,QAAQ;AAEvC,WAAU,UAAU,UAAU;CAC9B,MAAM,YAAY,UACd,iBAAiB,WAAW,OAAO,EAAE,QAAQ,GAC7C;AAEJ,KAAI;AAEF,SAAO,MADgB,MAAM,KAAK;GAAE,GAAG;GAAS;GAAQ,CAAC;UAElD,OAAO;AACd,MAAI,iBAAiB,SAAS,MAAM,SAAS,aAC3C,OAAM,wBAAwB,QAAQ;AAExC,QAAM;WACE;AACR,MAAI,UAAW,cAAa,UAAU;;;;;ACnC1C,eAAsB,iBAAiB,UAAoB;AACzD,KAAI,CAAC,SAAS,IAAI;EAChB,IAAI,WAAW;AACf,MAAI;GACF,MAAM,OAAO,MAAM,SAAS,MAAM;AAClC,OAAI;AAEF,eADkB,KAAK,MAAM,KACT,CAAC;WACf;AACN,eAAW,QAAQ;;UAEf;AASR,QAAM,IADY,SALG,SACnB,SAAS,QACT,SAAS,YACT,SAEqC,EAAE,SAAS,QAAQ,SAC/C;;;;;AC0Bf,eAAsB,eACpB,UACA,gBAIA,QACA,SACkE;CAClE,MAAM,UAAU,MAAM,QAAQ,SAAS;CAGvC,MAAM,YAAkC,UAAU,EAAE,GAAG,KAAA;CACvD,MAAM,iBAGF,EAAE;CAEN,MAAM,UAAsD,UACxD,SAAS,KAAK,MAAM,CAAC,KAAA,GAAW,EAAE,CAAC,GACnC,OAAO,QAAQ,SAAS;AAE5B,MAAK,MAAM,CAAC,KAAK,YAAY,SAAS;EAGpC,MAAM,EAAE,QAAQ,aADd,OAAO,YAAY,WAAW,EAAE,QAAQ,SAAS,GAAG;EAEtD,MAAM,OACJ,OACA,UAAU,QACV,WAAW;GACT;GACA,GAAI,UAAU,WAAW,EAAE,SAAS,SAAS,SAAS;GACtD,GAAI,UAAU,YAAY,QAAQ,EAAE,UAAU,SAAS,UAAU;GACjE,GAAI,UAAU,cAAc,EAAE,YAAY,SAAS,YAAY;GAC/D,YAAY,UAAU,cAAc;GACrC,CAAC;AACJ,aAAW,KAAK,KAAK;AACrB,iBAAe,QAAQ;GACrB;GACU;GACX;;CAGH,MAAM,SAAS,gBAAgB;EAC7B,QAAQ,OAAO;EACf,SAAS,OAAO,WAAA;EAChB,QAAQ,OAAO,SAAS,iBAAiB,OAAO,QAAQ,EAAE,EAAE,QAAQ;EACpE,WAAW,OAAO;EAClB,aAAa;EACb,WAAW;EACZ,CAAC;CAUF,MAAM,SAAS,MAAM,UAAU;EAAE,MAAA;GAR/B,UAAU;GACV,cAAc,eAAe;GAC7B,cAAc,eAAe;GAI7B,UAAU;GAEyB;EAAE;EAAQ,CAAC;AAIhD,KACE,OAAO,SAAS,KAAA,KAChB,OAAO,YACP,CAAC,gBAAgB,OAAO,EACxB;AACA,QAAM,iBAAiB,OAAO,SAAS;AACvC,QAAM,OAAO;;CAMf,MAAM,WAHkB,gBAAgB,OAGR;AAGhC,KAAI,UACF,QAAO,UAAU,KACd,SACC,SAAS,SAAS;EAChB,SAAS;EACT,OAAO;EACP,MAAM;EACP,CACJ;AAIH,QAAO;;;;;;;;;;;;;;;;;;;ACzDT,IAAa,YAAb,MAAuB;;CAmCrB,IAAI,eAAe;AACjB,SAAO,KAAK;;;;;;;;;;;;;;;;;CAkBd,YAAY,SAA8B,EAAE,EAAE;AAE5C,MAAI,OAAO,YAAY,aAAa;AAClC,QAAK,WAAW,QAAQ,KAAK;AAC7B,QAAK,cAAc,QAAQ,KAAK;AAChC,QAAK,cAAc,QAAQ,KAAK;;AAGlC,OAAK,UAAU,OAAO;;CAGxB,UAAU,EACR,QACA,WACA,cACA,cACA,SACA,WACA,eACA,WACsB;EACtB,MAAM,yBAAyB,iBAAiB,KAAK;AAGrD,MAAI,OAAQ,MAAK,SAAS;AAC1B,MAAI,UAAW,MAAK,YAAY;AAChC,MAAI,UAAW,MAAK,YAAY;AAKhC,MAAI,cAAc;AAChB,QAAK,eAAe;AACpB,OAAI,CAACA,cAAe,KAAK,cAAc,uBAAuB,CAC5D,OAAM,IAAI,MAAM,mBAAmB,KAAK,aAAa,CAAC;;AAI1D,MAAI,cAAc;AAChB,QAAK,eAAe;AACpB,OAAI,CAACA,cAAe,KAAK,cAAc,uBAAuB,CAC5D,OAAM,IAAI,MAAM,mBAAmB,KAAK,aAAa,CAAC;;AAI1D,MAAI,SAAS;GACX,MAAM,SAAmB,EAAE;GAC3B,MAAM,iBAA2B,EAAE;AACnC,WAAQ,SAAS,WAAW;AAC1B,QAAIA,cAAe,QAAQ,uBAAuB,CAChD,QAAO,KAAK,OAAO;QAEnB,gBAAe,KAAK,OAAO;KAE7B;AACF,OAAI,eAAe,SAAS,EAC1B,OAAM,IAAI,MAAM,oBAAoB,eAAe,CAAC;AAEtD,QAAK,UAAU;;AAIjB,MAAI,QAAS,MAAK,UAAU;AAC5B,MAAI,eAAe;AACjB,QAAK,gBAAgB;AACrB,QAAK,uBAAuB,OAAO,YACjC,OAAO,QAAQ,cAAc,CAC1B,QACE,GAAG,WAAW,SAAS,OAAO,UAAU,YAAY,UAAU,MAChE,CACA,KAAK,CAAC,KAAK,WAAW,CAAE,MAA2B,MAAM,IAAI,CAAC,CAClE;;AAEH,OAAK,gBAAgB,IAAI,aAAa;GACpC,eAAe,KAAK;GACpB,SAAS,KAAK,WAAW,EAAE;GAC3B,eAAe,KAAK;GACrB,CAAC;;;CAMJ,qBAA+B,QAAwB;AACrD,SAAO,KAAK,kBAAkB,KAAK,uBAAuB,OAAO,CAAC;;;;;;;CAQpE,6BAAuC,QAAwB;EAC7D,MAAM,YAAY,KAAK,kBAAkB,OAAO;AAOhD,SACE;GANA,GAAI,KAAK,WAAW,EAAE;GACtB,KAAK;GACL,KAAK;GACL,GAAG,OAAO,KAAK,KAAK,iBAAiB,EAAE,CAAC;GAG9B,CAAC,MACR,cACC,aAAa,KAAK,qBAAqB,UAAU,KAAK,UACzD,IAAI;;CAIT,wBAA4D;AAC1D,SAAO;GACL,SAAS,KAAK;GACd,QAAQ,KAAK,UAAU,KAAK;GAC5B,WAAW,KAAK,aAAa;GAC9B;;CAGH,cAAwB,cAAsB;EAC5C,MAAM,SAAmB,EAAE;AAC3B,MAAI,CAAC,KAAK,UAAU,CAAC,KAAK,WAAW;GACnC,MAAM,QAAQ,sBAAsB,aAAa;AACjD,UAAO,KAAK,MAAM;;AAEpB,MAAI,CAAC,KAAK,WAAW;GACnB,MAAM,QAAQ,yBAAyB,aAAa;AACpD,UAAO,KAAK,MAAM;;AAEpB,MAAI,OAAO,OACT,OAAM,IAAI,MAAM,OAAO,KAAK,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;CAsBtC,MAAM,UACJ,QACA,SACA,SAC+C;AAE/C,MAAI,OAAO,YAAY,SACrB,WAAU,EAAE,cAAc,SAAS;AAIrC,OAAK,cAAc,YAAY;EAG/B,IAAI,eAAe,SAAS,gBAAgB,KAAK;AACjD,MAAI,CAAC,cAAc;GACjB,MAAM,QAAQ,4BAA4B,YAAY;AACtD,oBAAiB,MAAM,MAAM;AAC7B,SAAM,IAAI,MAAM,MAAM;;AAIxB,iBAAe,KAAK,qBAAqB,aAAa;EAEtD,MAAM,eAAe,KAAK,qBACxB,SAAS,gBAAgB,KAAK,gBAAA,KAC/B;AAaD,UAAO,MAVe,eACpB,CAAC,OAAO,EACR;GACE,GAAG;GACH;GACA;GACD,EACD,KAAK,uBAAuB,EAC5B,QACD,EACc;;CAuCjB,MAAM,cACJ,SACA,SACA,SACkE;AAElE,MAAI,OAAO,YAAY,SACrB,WAAU,EAAE,cAAc,SAAS;AAIrC,OAAK,cAAc,gBAAgB;EAGnC,IAAI,eAAe,SAAS,gBAAgB,KAAK;AACjD,MAAI,CAAC,cAAc;GACjB,MAAM,QAAQ,4BAA4B,gBAAgB;AAC1D,oBAAiB,MAAM,MAAM;AAC7B,SAAM,IAAI,MAAM,MAAM;;AAIxB,iBAAe,KAAK,qBAAqB,aAAa;EAEtD,MAAM,eAAe,KAAK,qBACxB,SAAS,gBAAgB,KAAK,gBAAA,KAC/B;AAGD,SAAO,MAAM,eACX,SACA;GACE,GAAG;GACH;GACA;GACD,EACD,KAAK,uBAAuB,EAC5B,QACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCH,aACE,OACA,SAGQ;AACR,SAAO,KAAK,aAAa,aAAa,OAAO,KAAK,cAAc,QAAQ;;;;;;;;;;;;;;;;;;CAmB1E,cACE,SACA,SAKQ;AACR,SAAO,KAAK,aAAa,cAAc,SAAS,KAAK,cAAc,QAAQ;;;;;;;;;;;;;;;CAe7E,UACE,QACA,SAGQ;AACR,SAAO,KAAK,aAAa,UAAU,QAAQ,KAAK,cAAc,QAAQ;;;;;;;;;;;;;;;CAgBxE,eACE,MACA,SAGQ;AACR,SAAO,KAAK,aAAa,eAAe,MAAM,KAAK,cAAc,QAAQ;;;;;;;;;;;;;;;;CAiB3E,eACE,OACA,UACA,SAGQ;AACR,SAAO,KAAK,aAAa,eACvB,OACA,UACA,KAAK,cACL,QACD;;;;;;;;;;;;;;;CAgBH,WACE,OACA,SAGA;AACA,SAAO,KAAK,aAAa,WAAW,OAAO,KAAK,cAAc,QAAQ;;;;;;;;;;;;;;CAexE,kBACE,OACA,SAGmB;AACnB,SAAO,KAAK,aAAa,kBACvB,OACA,KAAK,cACL,QACD;;;;;;;;;;;;;;;;CAiBH,mBACE,OACA,MACA,SAGQ;AACR,SAAO,KAAK,aAAa,mBACvB,OACA,MACA,KAAK,cACL,QACD;;;;;;;;;;;;;;CAeH,2BACE,MACA,SAIQ;AACR,SAAO,KAAK,aAAa,2BACvB,MACA,KAAK,cACL,QACD;;;;;;;;;;;;;CAgBH,cAAc,SAAS,KAAK,cAAsB;AAChD,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,4BAA4B,gBAAgB,CAAC;AAC1E,SAAO,KAAK,aAAa,cAAc,OAAO;;;;;;;;;;;;;;CAehD,eAAe,SAAS,KAAK,cAAsB;AACjD,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,4BAA4B,iBAAiB,CAAC;AAC3E,SAAO,KAAK,aAAa,eAAe,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCjD,oBAAoB,SAAS,KAAK,cAAgC;AAChE,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,4BAA4B,sBAAsB,CAAC;AACrE,SAAO,KAAK,aAAa,oBAAoB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCtD,oBACE,SAAS,KAAK,qBAAqB,CAAC,YACpC,eAC+C;AAC/C,MAAI,CAAC,eAAe;AAClB,OAAI,KAAK,iBAAiB,CAAC,KAAK,qBAAqB;IAEnD,MAAM,sBAA2C,EAAE;AACnD,SAAK,MAAM,CAAC,QAAQ,OAAO,OAAO,QAAQ,KAAK,cAAc,CAC3D,KACE,MACA,OAAO,OAAO,YACd,GAAG,cACH,CAAC,oBAAoB,GAAG,aACxB;KACA,MAAM,EAAE,YAAY,MAAM,UAAU;AACpC,yBAAoB,GAAG,cAAc;MACnC;MACA,GAAI,QAAQ,EAAE,MAAM;MACpB,GAAI,SAAS,EAAE,OAAO;MACvB;;AAGL,SAAK,sBAAsB;;AAE7B,mBAAgB,KAAK;;AAEvB,SAAOC,oBACL,QACA,KAAK,cACL,cACD;;;;;;;;;;;;;;;;CAiBH,oBACE,eAAe,KAAK,cACpB,eAAe,KAAK,cACpB,kBAAwC,KAAK,SAC7C,gBAA2C,KAAK,eACvC;AACT,MAAI,CAAC,aACH,OAAM,IAAI,MAAM,4BAA4B,sBAAsB,CAAC;AACrE,MAAI,CAAC,aACH,OAAM,IAAI,MAAM,4BAA4B,sBAAsB,CAAC;AACrE,MAAI,kBAAkB,KAAK,cACzB,QAAO,KAAK,aAAa,oBACvB,cACA,cACA,gBACD;AAEH,SAAOC,oBACL,cACA,cACA,iBACA,cACD;;;;;;;;;;;;;CAcH,gBACE,SACA,kBAAwC,KAAK,WAAW,EAAE,EAC1D,gBAA2C,KAAK,eAC5B;AACpB,MAAI,kBAAkB,KAAK,cACzB,QAAO,KAAK,aAAa,gBAAgB,SAAS,mBAAmB,EAAE,CAAC;AAE1E,SAAO,IAAI,aAAa,EAAE,eAAe,CAAC,CAAC,gBACzC,SACA,mBAAmB,EAAE,CACtB;;;;;;;;;;;;;CAcH,mBAAmB,SAAS,KAAK,cAA6B;AAC5D,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,4BAA4B,qBAAqB,CAAC;AACpE,SAAO,KAAK,aAAa,mBAAmB,OAAO;;;;;;;;;;;;;;CAerD,cACE,SAAS,KAAK,cACd,gBAA2C,KAAK,eACvC;AACT,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,4BAA4B,gBAAgB,CAAC;AAC1E,MAAI,kBAAkB,KAAK,cACzB,QAAO,KAAK,aAAa,cAAc,OAAO;AAEhD,SAAOF,cAAe,QAAQ,cAAc;;;;;;;;CAS9C,uBACE,SAA6B,KAAK,cAClC,gBAA2C,KAAK,eACxC;AACR,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,4BAA4B,yBAAyB,CAAC;AACxE,MAAI,kBAAkB,KAAK,cACzB,QAAO,KAAK,aAAa,uBAAuB,OAAO;AAEzD,SAAOG,uBAAwB,QAAQ,cAAc;;;;;;;;CASvD,mBACE,QACA,gBAA2C,KAAK,eACxC;AACR,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,4BAA4B,qBAAqB,CAAC;AACpE,MAAI,kBAAkB,KAAK,cACzB,QAAO,KAAK,aAAa,mBAAmB,OAAO;AAErD,SAAOC,mBAAoB,QAAQ,cAAc;;;;;;;;;;;;;CAcnD,kBAAkB,SAAS,KAAK,cAAsB;AACpD,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,4BAA4B,oBAAoB,CAAC;AACnE,SAAO,KAAK,aAAa,kBAAkB,OAAO;;;;;;;;;;;;;;;CAgBpD,cAAc,GAAG,SAAyC;AACxD,SAAO,KAAK,aAAa,cAAc,GAAG,QAAQ;;;;;;;;;;;;CAapD,eAAe,GAAG,SAAyC;AACzD,SAAO,KAAK,aAAa,eAAe,GAAG,QAAQ;;;;;;;;;;;;;;;;CAiBrD,iBAAiB,aAAqB,WAA4B;AAChE,SAAO,KAAK,aAAa,iBAAiB,aAAa,UAAU"}
|
|
@@ -410,23 +410,23 @@ var GTRuntime = class {
|
|
|
410
410
|
this.setConfig(params);
|
|
411
411
|
}
|
|
412
412
|
setConfig({ apiKey, devApiKey, sourceLocale, targetLocale, locales, projectId, customMapping, baseUrl }) {
|
|
413
|
+
const effectiveCustomMapping = customMapping ?? this.customMapping;
|
|
413
414
|
if (apiKey) this.apiKey = apiKey;
|
|
414
415
|
if (devApiKey) this.devApiKey = devApiKey;
|
|
415
416
|
if (projectId) this.projectId = projectId;
|
|
416
417
|
if (sourceLocale) {
|
|
417
|
-
this.sourceLocale =
|
|
418
|
-
if (!(0, _generaltranslation_format.isValidLocale)(this.sourceLocale,
|
|
418
|
+
this.sourceLocale = sourceLocale;
|
|
419
|
+
if (!(0, _generaltranslation_format.isValidLocale)(this.sourceLocale, effectiveCustomMapping)) throw new Error(invalidLocaleError(this.sourceLocale));
|
|
419
420
|
}
|
|
420
421
|
if (targetLocale) {
|
|
421
|
-
this.targetLocale =
|
|
422
|
-
if (!(0, _generaltranslation_format.isValidLocale)(this.targetLocale,
|
|
422
|
+
this.targetLocale = targetLocale;
|
|
423
|
+
if (!(0, _generaltranslation_format.isValidLocale)(this.targetLocale, effectiveCustomMapping)) throw new Error(invalidLocaleError(this.targetLocale));
|
|
423
424
|
}
|
|
424
425
|
if (locales) {
|
|
425
426
|
const result = [];
|
|
426
427
|
const invalidLocales = [];
|
|
427
428
|
locales.forEach((locale) => {
|
|
428
|
-
|
|
429
|
-
if ((0, _generaltranslation_format.isValidLocale)(standardizedLocale)) result.push(standardizedLocale);
|
|
429
|
+
if ((0, _generaltranslation_format.isValidLocale)(locale, effectiveCustomMapping)) result.push(locale);
|
|
430
430
|
else invalidLocales.push(locale);
|
|
431
431
|
});
|
|
432
432
|
if (invalidLocales.length > 0) throw new Error(invalidLocalesError(invalidLocales));
|
|
@@ -443,6 +443,24 @@ var GTRuntime = class {
|
|
|
443
443
|
customMapping: this.customMapping
|
|
444
444
|
});
|
|
445
445
|
}
|
|
446
|
+
/** Convert app identity only where a GT service expects a language code. */
|
|
447
|
+
resolveServiceLocale(locale) {
|
|
448
|
+
return this.standardizeLocale(this.resolveCanonicalLocale(locale));
|
|
449
|
+
}
|
|
450
|
+
/**
|
|
451
|
+
* Recover configured spelling without negotiating an unrelated dialect.
|
|
452
|
+
* When several identities use the same service code and there is no request
|
|
453
|
+
* context to disambiguate them, the first configured identity wins.
|
|
454
|
+
*/
|
|
455
|
+
resolveServiceResponseLocale(locale) {
|
|
456
|
+
const canonical = this.standardizeLocale(locale);
|
|
457
|
+
return [
|
|
458
|
+
...this.locales ?? [],
|
|
459
|
+
this.sourceLocale,
|
|
460
|
+
this.targetLocale,
|
|
461
|
+
...Object.keys(this.customMapping ?? {})
|
|
462
|
+
].find((candidate) => candidate && this.resolveServiceLocale(candidate) === canonical) ?? locale;
|
|
463
|
+
}
|
|
446
464
|
_getTranslationConfig() {
|
|
447
465
|
return {
|
|
448
466
|
baseUrl: this.baseUrl,
|
|
@@ -489,8 +507,8 @@ var GTRuntime = class {
|
|
|
489
507
|
gtInstanceLogger.error(error);
|
|
490
508
|
throw new Error(error);
|
|
491
509
|
}
|
|
492
|
-
targetLocale = this.
|
|
493
|
-
const sourceLocale = this.
|
|
510
|
+
targetLocale = this.resolveServiceLocale(targetLocale);
|
|
511
|
+
const sourceLocale = this.resolveServiceLocale(options?.sourceLocale || this.sourceLocale || "en");
|
|
494
512
|
return (await _translateMany([source], {
|
|
495
513
|
...options,
|
|
496
514
|
targetLocale,
|
|
@@ -506,8 +524,8 @@ var GTRuntime = class {
|
|
|
506
524
|
gtInstanceLogger.error(error);
|
|
507
525
|
throw new Error(error);
|
|
508
526
|
}
|
|
509
|
-
targetLocale = this.
|
|
510
|
-
const sourceLocale = this.
|
|
527
|
+
targetLocale = this.resolveServiceLocale(targetLocale);
|
|
528
|
+
const sourceLocale = this.resolveServiceLocale(options?.sourceLocale || this.sourceLocale || "en");
|
|
511
529
|
return await _translateMany(sources, {
|
|
512
530
|
...options,
|
|
513
531
|
targetLocale,
|
|
@@ -832,7 +850,7 @@ var GTRuntime = class {
|
|
|
832
850
|
*/
|
|
833
851
|
determineLocale(locales, approvedLocales = this.locales || [], customMapping = this.customMapping) {
|
|
834
852
|
if (customMapping === this.customMapping) return this.localeConfig.determineLocale(locales, approvedLocales ?? []);
|
|
835
|
-
return
|
|
853
|
+
return new _generaltranslation_format.LocaleConfig({ customMapping }).determineLocale(locales, approvedLocales ?? []);
|
|
836
854
|
}
|
|
837
855
|
/**
|
|
838
856
|
* Gets the text direction for a given locale code.
|
|
@@ -1006,4 +1024,4 @@ Object.defineProperty(exports, "validateResponse", {
|
|
|
1006
1024
|
}
|
|
1007
1025
|
});
|
|
1008
1026
|
|
|
1009
|
-
//# sourceMappingURL=runtime-
|
|
1027
|
+
//# sourceMappingURL=runtime-C25lwh9m.cjs.map
|