generaltranslation 8.2.7 → 8.2.8

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { $ as FileReference, A as BranchDataResult, B as FileUpload, C as ProcessMovesOptions, D as FileDataQuery, Dt as StringFormat, F as DownloadFileOptions, H as UploadFilesResponse, I as PublishFileEntry, J as DownloadFileBatchOptions, L as PublishFilesResult, M as TranslationError, Mt as CustomMapping, N as TranslationResult, O as FileDataResult, T as GetOrphanedFilesResult, U as CreateTagOptions, V as UploadFilesOptions, W as CreateTagResult, X as DownloadFileBatchResult, Y as DownloadFileBatchRequest, _ as AwaitJobsResult, at as CheckFileTranslationsOptions, et as FileReferenceIds, g as AwaitJobsOptions, h as SubmitUserEditDiffsPayload, j as TranslateManyResult, jt as LocaleProperties, k as BranchQuery, mt as TranslateOptions, n as FormatVariables, ot as FileQuery, pt as TranslateManyEntry, rt as EnqueueFilesResult, st as FileQueryResult, w as ProcessMovesResponse, x as MoveMapping, y as CheckJobStatusResult } from "./types-D2fTTTvZ.cjs";
+import { $ as FileReference, A as BranchDataResult, B as FileUpload, C as ProcessMovesOptions, D as FileDataQuery, Dt as StringFormat, F as DownloadFileOptions, H as UploadFilesResponse, I as PublishFileEntry, J as DownloadFileBatchOptions, L as PublishFilesResult, M as TranslationError, Mt as CustomMapping, N as TranslationResult, O as FileDataResult, T as GetOrphanedFilesResult, U as CreateTagOptions, V as UploadFilesOptions, W as CreateTagResult, X as DownloadFileBatchResult, Y as DownloadFileBatchRequest, _ as AwaitJobsResult, at as CheckFileTranslationsOptions, et as FileReferenceIds, g as AwaitJobsOptions, h as SubmitUserEditDiffsPayload, j as TranslateManyResult, jt as LocaleProperties, k as BranchQuery, mt as TranslateOptions, n as FormatVariables, ot as FileQuery, pt as TranslateManyEntry, rt as EnqueueFilesResult, st as FileQueryResult, w as ProcessMovesResponse, x as MoveMapping, y as CheckJobStatusResult } from "./types-BJdoI1d1.cjs";
 
 //#region src/translate/setupProject.d.ts
 type SetupProjectResult = {
@@ -71,6 +71,66 @@ interface CutoffFormatOptions extends TerminatorOptions {
   style?: CutoffFormatStyle;
 }
 //#endregion
+//#region src/LocaleConfig.d.ts
+type LocaleConfigConstructorParams = {
+  defaultLocale?: string;
+  locales?: string[];
+  customMapping?: CustomMapping;
+};
+type LocalesOption = {
+  locales?: string | string[];
+};
+type WithLocales<T = object> = T & LocalesOption;
+/**
+ * LocaleConfig is a client-safe locale and formatting helper.
+ *
+ * It intentionally does not store project IDs, API keys, runtime URLs, or any
+ * translation credentials. It only stores locale metadata needed to resolve
+ * aliases, choose formatting fallbacks, and format values with Intl.
+ */
+declare class LocaleConfig {
+  readonly defaultLocale: string;
+  readonly locales: string[];
+  readonly customMapping?: CustomMapping;
+  constructor({
+    defaultLocale,
+    locales,
+    customMapping
+  }?: LocaleConfigConstructorParams);
+  private get translationLocales();
+  private resolveCanonicalLocaleList;
+  private resolveCanonicalLocaleArgs;
+  private toLocaleList;
+  private getFormattingLocales;
+  formatNum(value: number, targetLocale?: string, options?: WithLocales<Intl.NumberFormatOptions>): string;
+  formatDateTime(value: Date, targetLocale?: string, options?: WithLocales<Intl.DateTimeFormatOptions>): string;
+  formatCurrency(value: number, currency: string, targetLocale?: string, options?: WithLocales<Intl.NumberFormatOptions>): string;
+  formatRelativeTime(value: number, unit: Intl.RelativeTimeFormatUnit, targetLocale?: string, options?: WithLocales<Intl.RelativeTimeFormatOptions>): string;
+  formatRelativeTimeFromDate(date: Date, targetLocale?: string, options?: WithLocales<Intl.RelativeTimeFormatOptions & {
+    baseDate?: Date;
+  }>): string;
+  formatCutoff(value: string, targetLocale?: string, options?: WithLocales<CutoffFormatOptions>): string;
+  formatMessage(message: string, targetLocale?: string, options?: WithLocales<{
+    variables?: FormatVariables;
+    dataFormat?: StringFormat;
+  }>): string;
+  formatList(array: Array<string | number>, targetLocale?: string, options?: WithLocales<Intl.ListFormatOptions>): string;
+  formatListToParts<T>(array: Array<T>, targetLocale?: string, options?: WithLocales<Intl.ListFormatOptions>): (string | T)[];
+  getLocaleName(locale: string): string;
+  getLocaleEmoji(locale: string): string;
+  getLocaleProperties(locale: string): LocaleProperties;
+  requiresTranslation(targetLocale: string, sourceLocale?: string, approvedLocales?: string[] | undefined): boolean;
+  determineLocale(locales: string | string[], approvedLocales?: string[]): string | undefined;
+  getLocaleDirection(locale: string): "ltr" | "rtl";
+  isValidLocale(locale: string): boolean;
+  resolveCanonicalLocale(locale: string): string;
+  resolveAliasLocale(locale: string): string;
+  standardizeLocale(locale: string): string;
+  isSameDialect(...locales: (string | string[])[]): boolean;
+  isSameLanguage(...locales: (string | string[])[]): boolean;
+  isSupersetLocale(superLocale: string, subLocale: string): boolean;
+}
+//#endregion
 //#region src/index.d.ts
 /**
  * Type representing the constructor parameters for the GT class.
@@ -123,14 +183,16 @@ declare class GT {
   targetLocale?: string;
   /** Array of supported locales */
   locales?: string[];
-  /** Array of locales used for rendering variables */
-  _renderingLocales: string[];
   /** Custom mapping for locale codes to their names */
   customMapping?: CustomMapping;
   /** Lazily derived reverse custom mapping for alias locales */
   reverseCustomMapping?: Record<string, string>;
   /** Lazily derived custom mapping for regions */
   customRegionMapping?: CustomRegionMapping;
+  /** Client-safe locale and formatting helpers (backing field) */
+  private _localeConfig;
+  /** Client-safe locale and formatting helpers */
+  get localeConfig(): LocaleConfig;
   /**
    * Constructs an instance of the GT class.
    *
@@ -1153,5 +1215,5 @@ declare function isSameLanguage(...locales: (string | string[])[]): boolean;
 declare function isSupersetLocale(superLocale: string, subLocale: string): boolean;
 declare const API_VERSION = "2026-03-06.v1";
 //#endregion
-export { API_VERSION, GT, determineLocale, formatCurrency, formatCutoff, formatDateTime, formatList, formatListToParts, formatMessage, formatNum, formatRelativeTime, formatRelativeTimeFromDate, getLocaleDirection, getLocaleEmoji, getLocaleName, getLocaleProperties, getRegionProperties, isSameDialect, isSameLanguage, isSupersetLocale, isValidLocale, requiresTranslation, resolveAliasLocale, resolveCanonicalLocale, standardizeLocale };
+export { API_VERSION, GT, LocaleConfig, type LocaleConfigConstructorParams, determineLocale, formatCurrency, formatCutoff, formatDateTime, formatList, formatListToParts, formatMessage, formatNum, formatRelativeTime, formatRelativeTimeFromDate, getLocaleDirection, getLocaleEmoji, getLocaleName, getLocaleProperties, getRegionProperties, isSameDialect, isSameLanguage, isSupersetLocale, isValidLocale, requiresTranslation, resolveAliasLocale, resolveCanonicalLocale, standardizeLocale };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as FileReference, A as BranchDataResult, B as FileUpload, C as ProcessMovesOptions, D as FileDataQuery, Dt as StringFormat, F as DownloadFileOptions, H as UploadFilesResponse, I as PublishFileEntry, J as DownloadFileBatchOptions, L as PublishFilesResult, M as TranslationError, Mt as CustomMapping, N as TranslationResult, O as FileDataResult, T as GetOrphanedFilesResult, U as CreateTagOptions, V as UploadFilesOptions, W as CreateTagResult, X as DownloadFileBatchResult, Y as DownloadFileBatchRequest, _ as AwaitJobsResult, at as CheckFileTranslationsOptions, et as FileReferenceIds, g as AwaitJobsOptions, h as SubmitUserEditDiffsPayload, j as TranslateManyResult, jt as LocaleProperties, k as BranchQuery, mt as TranslateOptions, n as FormatVariables, ot as FileQuery, pt as TranslateManyEntry, rt as EnqueueFilesResult, st as FileQueryResult, w as ProcessMovesResponse, x as MoveMapping, y as CheckJobStatusResult } from "./types-fUW4_Ole.mjs";
+import { $ as FileReference, A as BranchDataResult, B as FileUpload, C as ProcessMovesOptions, D as FileDataQuery, Dt as StringFormat, F as DownloadFileOptions, H as UploadFilesResponse, I as PublishFileEntry, J as DownloadFileBatchOptions, L as PublishFilesResult, M as TranslationError, Mt as CustomMapping, N as TranslationResult, O as FileDataResult, T as GetOrphanedFilesResult, U as CreateTagOptions, V as UploadFilesOptions, W as CreateTagResult, X as DownloadFileBatchResult, Y as DownloadFileBatchRequest, _ as AwaitJobsResult, at as CheckFileTranslationsOptions, et as FileReferenceIds, g as AwaitJobsOptions, h as SubmitUserEditDiffsPayload, j as TranslateManyResult, jt as LocaleProperties, k as BranchQuery, mt as TranslateOptions, n as FormatVariables, ot as FileQuery, pt as TranslateManyEntry, rt as EnqueueFilesResult, st as FileQueryResult, w as ProcessMovesResponse, x as MoveMapping, y as CheckJobStatusResult } from "./types-DazaDJbs.mjs";
 
 //#region src/translate/setupProject.d.ts
 type SetupProjectResult = {
@@ -71,6 +71,66 @@ interface CutoffFormatOptions extends TerminatorOptions {
   style?: CutoffFormatStyle;
 }
 //#endregion
+//#region src/LocaleConfig.d.ts
+type LocaleConfigConstructorParams = {
+  defaultLocale?: string;
+  locales?: string[];
+  customMapping?: CustomMapping;
+};
+type LocalesOption = {
+  locales?: string | string[];
+};
+type WithLocales<T = object> = T & LocalesOption;
+/**
+ * LocaleConfig is a client-safe locale and formatting helper.
+ *
+ * It intentionally does not store project IDs, API keys, runtime URLs, or any
+ * translation credentials. It only stores locale metadata needed to resolve
+ * aliases, choose formatting fallbacks, and format values with Intl.
+ */
+declare class LocaleConfig {
+  readonly defaultLocale: string;
+  readonly locales: string[];
+  readonly customMapping?: CustomMapping;
+  constructor({
+    defaultLocale,
+    locales,
+    customMapping
+  }?: LocaleConfigConstructorParams);
+  private get translationLocales();
+  private resolveCanonicalLocaleList;
+  private resolveCanonicalLocaleArgs;
+  private toLocaleList;
+  private getFormattingLocales;
+  formatNum(value: number, targetLocale?: string, options?: WithLocales<Intl.NumberFormatOptions>): string;
+  formatDateTime(value: Date, targetLocale?: string, options?: WithLocales<Intl.DateTimeFormatOptions>): string;
+  formatCurrency(value: number, currency: string, targetLocale?: string, options?: WithLocales<Intl.NumberFormatOptions>): string;
+  formatRelativeTime(value: number, unit: Intl.RelativeTimeFormatUnit, targetLocale?: string, options?: WithLocales<Intl.RelativeTimeFormatOptions>): string;
+  formatRelativeTimeFromDate(date: Date, targetLocale?: string, options?: WithLocales<Intl.RelativeTimeFormatOptions & {
+    baseDate?: Date;
+  }>): string;
+  formatCutoff(value: string, targetLocale?: string, options?: WithLocales<CutoffFormatOptions>): string;
+  formatMessage(message: string, targetLocale?: string, options?: WithLocales<{
+    variables?: FormatVariables;
+    dataFormat?: StringFormat;
+  }>): string;
+  formatList(array: Array<string | number>, targetLocale?: string, options?: WithLocales<Intl.ListFormatOptions>): string;
+  formatListToParts<T>(array: Array<T>, targetLocale?: string, options?: WithLocales<Intl.ListFormatOptions>): (string | T)[];
+  getLocaleName(locale: string): string;
+  getLocaleEmoji(locale: string): string;
+  getLocaleProperties(locale: string): LocaleProperties;
+  requiresTranslation(targetLocale: string, sourceLocale?: string, approvedLocales?: string[] | undefined): boolean;
+  determineLocale(locales: string | string[], approvedLocales?: string[]): string | undefined;
+  getLocaleDirection(locale: string): "ltr" | "rtl";
+  isValidLocale(locale: string): boolean;
+  resolveCanonicalLocale(locale: string): string;
+  resolveAliasLocale(locale: string): string;
+  standardizeLocale(locale: string): string;
+  isSameDialect(...locales: (string | string[])[]): boolean;
+  isSameLanguage(...locales: (string | string[])[]): boolean;
+  isSupersetLocale(superLocale: string, subLocale: string): boolean;
+}
+//#endregion
 //#region src/index.d.ts
 /**
  * Type representing the constructor parameters for the GT class.
@@ -123,14 +183,16 @@ declare class GT {
   targetLocale?: string;
   /** Array of supported locales */
   locales?: string[];
-  /** Array of locales used for rendering variables */
-  _renderingLocales: string[];
   /** Custom mapping for locale codes to their names */
   customMapping?: CustomMapping;
   /** Lazily derived reverse custom mapping for alias locales */
   reverseCustomMapping?: Record<string, string>;
   /** Lazily derived custom mapping for regions */
   customRegionMapping?: CustomRegionMapping;
+  /** Client-safe locale and formatting helpers (backing field) */
+  private _localeConfig;
+  /** Client-safe locale and formatting helpers */
+  get localeConfig(): LocaleConfig;
   /**
    * Constructs an instance of the GT class.
    *
@@ -1153,5 +1215,5 @@ declare function isSameLanguage(...locales: (string | string[])[]): boolean;
 declare function isSupersetLocale(superLocale: string, subLocale: string): boolean;
 declare const API_VERSION = "2026-03-06.v1";
 //#endregion
-export { API_VERSION, GT, determineLocale, formatCurrency, formatCutoff, formatDateTime, formatList, formatListToParts, formatMessage, formatNum, formatRelativeTime, formatRelativeTimeFromDate, getLocaleDirection, getLocaleEmoji, getLocaleName, getLocaleProperties, getRegionProperties, isSameDialect, isSameLanguage, isSupersetLocale, isValidLocale, requiresTranslation, resolveAliasLocale, resolveCanonicalLocale, standardizeLocale };
+export { API_VERSION, GT, LocaleConfig, type LocaleConfigConstructorParams, determineLocale, formatCurrency, formatCutoff, formatDateTime, formatList, formatListToParts, formatMessage, formatNum, formatRelativeTime, formatRelativeTimeFromDate, getLocaleDirection, getLocaleEmoji, getLocaleName, getLocaleProperties, getRegionProperties, isSameDialect, isSameLanguage, isSupersetLocale, isValidLocale, requiresTranslation, resolveAliasLocale, resolveCanonicalLocale, standardizeLocale };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { A as encode, R as intlCache, k as decode, z as defaultTimeout } from "./internal-CTeI8uLd.mjs";
+import { B as intlCache, M as encode, V as defaultTimeout, j as decode, k as validateFileFormatTransforms } from "./internal-B3QbyI_5.mjs";
 import { t as ApiError } from "./ApiError-Bv7vlzyQ.mjs";
 import { n as hashSource } from "./id-CPbVYREY.mjs";
 import IntlMessageFormat from "intl-messageformat";
@@ -1445,6 +1445,7 @@ async function processBatches(items, processor, options = {}) {
 * @returns The result of the API call
 */
 async function _enqueueFiles(files, options, config) {
+	validateFileFormatTransforms(files);
 	const result = await processBatches(files, async (batch) => {
 		const apiResult = await apiRequest(config, "/v2/project/translations/enqueue", {
 			body: {
@@ -1452,7 +1453,8 @@ async function _enqueueFiles(files, options, config) {
 					branchId: f.branchId,
 					fileId: f.fileId,
 					versionId: f.versionId,
-					fileName: f.fileName
+					fileName: f.fileName,
+					transformFormat: f.transformFormat
 				})),
 				targetLocales: options.targetLocales,
 				sourceLocale: options.sourceLocale,
@@ -1647,6 +1649,7 @@ async function _uploadSourceFiles(files, options, config) {
 * @returns Promise resolving to a BatchList with all uploaded files
 */
 async function _uploadTranslations(files, options, config) {
+	validateFileFormatTransforms(files.map(({ source }) => source));
 	return processBatches(files, async (batch) => {
 		return (await apiRequest(config, "/v2/project/files/upload-translations", {
 			body: {
@@ -1655,6 +1658,7 @@ async function _uploadTranslations(files, options, config) {
 						content: encode(source.content),
 						fileName: source.fileName,
 						fileFormat: source.fileFormat,
+						transformFormat: source.transformFormat,
 						locale: source.locale,
 						dataFormat: source.dataFormat,
 						formatMetadata: source.formatMetadata,
@@ -1929,6 +1933,158 @@ async function _publishFiles(files, config) {
 	return await apiRequest(config, "/v2/project/files/publish", { body: { files } });
 }
 //#endregion
+//#region src/LocaleConfig.ts
+/**
+* LocaleConfig is a client-safe locale and formatting helper.
+*
+* It intentionally does not store project IDs, API keys, runtime URLs, or any
+* translation credentials. It only stores locale metadata needed to resolve
+* aliases, choose formatting fallbacks, and format values with Intl.
+*/
+var LocaleConfig = class {
+	constructor({ defaultLocale = "en", locales = [], customMapping } = {}) {
+		this.defaultLocale = defaultLocale;
+		this.locales = locales;
+		this.customMapping = customMapping;
+	}
+	get translationLocales() {
+		return this.locales.length ? this.locales : void 0;
+	}
+	resolveCanonicalLocaleList(locales) {
+		return locales.map((locale) => this.resolveCanonicalLocale(locale));
+	}
+	resolveCanonicalLocaleArgs(locales) {
+		return locales.map((locale) => Array.isArray(locale) ? this.resolveCanonicalLocaleList(locale) : this.resolveCanonicalLocale(locale));
+	}
+	toLocaleList(locales) {
+		return Array.isArray(locales) ? locales : [locales];
+	}
+	getFormattingLocales(targetLocale, locales) {
+		return (locales !== void 0 ? this.toLocaleList(locales) : [
+			targetLocale,
+			this.defaultLocale,
+			"en"
+		]).filter((locale) => !!locale).map((locale) => this.resolveCanonicalLocale(locale));
+	}
+	formatNum(value, targetLocale, options = {}) {
+		const { locales, ...intlOptions } = options;
+		return _formatNum({
+			value,
+			locales: this.getFormattingLocales(targetLocale, locales),
+			options: intlOptions
+		});
+	}
+	formatDateTime(value, targetLocale, options = {}) {
+		const { locales, ...intlOptions } = options;
+		return _formatDateTime({
+			value,
+			locales: this.getFormattingLocales(targetLocale, locales),
+			options: intlOptions
+		});
+	}
+	formatCurrency(value, currency, targetLocale, options = {}) {
+		const { locales, ...intlOptions } = options;
+		return _formatCurrency({
+			value,
+			currency,
+			locales: this.getFormattingLocales(targetLocale, locales),
+			options: intlOptions
+		});
+	}
+	formatRelativeTime(value, unit, targetLocale, options = {}) {
+		const { locales, ...intlOptions } = options;
+		return _formatRelativeTime({
+			value,
+			unit,
+			locales: this.getFormattingLocales(targetLocale, locales),
+			options: intlOptions
+		});
+	}
+	formatRelativeTimeFromDate(date, targetLocale, options = {}) {
+		const { locales, baseDate, ...intlOptions } = options;
+		return _formatRelativeTimeFromDate({
+			date,
+			baseDate: baseDate ?? /* @__PURE__ */ new Date(),
+			locales: this.getFormattingLocales(targetLocale, locales),
+			options: intlOptions
+		});
+	}
+	formatCutoff(value, targetLocale, options = {}) {
+		const { locales, ...formatOptions } = options;
+		return _formatCutoff({
+			value,
+			locales: this.getFormattingLocales(targetLocale, locales),
+			options: formatOptions
+		});
+	}
+	formatMessage(message, targetLocale, options = {}) {
+		const { locales, variables, dataFormat } = options;
+		if (dataFormat === "STRING") return _formatMessageString(message);
+		return _formatMessageICU(message, this.getFormattingLocales(targetLocale, locales), variables);
+	}
+	formatList(array, targetLocale, options = {}) {
+		const { locales, ...intlOptions } = options;
+		return _formatList({
+			value: array,
+			locales: this.getFormattingLocales(targetLocale, locales),
+			options: intlOptions
+		});
+	}
+	formatListToParts(array, targetLocale, options = {}) {
+		const { locales, ...intlOptions } = options;
+		return _formatListToParts({
+			value: array,
+			locales: this.getFormattingLocales(targetLocale, locales),
+			options: intlOptions
+		});
+	}
+	getLocaleName(locale) {
+		return _getLocaleName(locale, this.defaultLocale, this.customMapping);
+	}
+	getLocaleEmoji(locale) {
+		return _getLocaleEmoji(locale, this.customMapping);
+	}
+	getLocaleProperties(locale) {
+		return _getLocaleProperties(locale, this.defaultLocale, this.customMapping);
+	}
+	requiresTranslation(targetLocale, sourceLocale = this.defaultLocale, approvedLocales = this.translationLocales) {
+		return _requiresTranslation(this.resolveCanonicalLocale(sourceLocale), this.resolveCanonicalLocale(targetLocale), approvedLocales ? this.resolveCanonicalLocaleList(approvedLocales) : void 0, this.customMapping);
+	}
+	determineLocale(locales, approvedLocales = this.locales) {
+		const approvedLocalePairs = approvedLocales.map((locale) => ({
+			locale,
+			canonicalLocale: this.resolveCanonicalLocale(locale)
+		}));
+		const resolvedLocale = _determineLocale(Array.isArray(locales) ? this.resolveCanonicalLocaleList(locales) : this.resolveCanonicalLocale(locales), approvedLocalePairs.map(({ canonicalLocale }) => canonicalLocale), this.customMapping);
+		if (!resolvedLocale) return void 0;
+		return approvedLocalePairs.find(({ canonicalLocale }) => canonicalLocale === resolvedLocale)?.locale || this.resolveAliasLocale(resolvedLocale);
+	}
+	getLocaleDirection(locale) {
+		return _getLocaleDirection(this.resolveCanonicalLocale(locale));
+	}
+	isValidLocale(locale) {
+		return _isValidLocale(locale, this.customMapping);
+	}
+	resolveCanonicalLocale(locale) {
+		return _resolveCanonicalLocale(locale, this.customMapping);
+	}
+	resolveAliasLocale(locale) {
+		return _resolveAliasLocale(locale, this.customMapping);
+	}
+	standardizeLocale(locale) {
+		return _standardizeLocale(locale);
+	}
+	isSameDialect(...locales) {
+		return _isSameDialect(...this.resolveCanonicalLocaleArgs(locales));
+	}
+	isSameLanguage(...locales) {
+		return _isSameLanguage(...this.resolveCanonicalLocaleArgs(locales));
+	}
+	isSupersetLocale(superLocale, subLocale) {
+		return _isSupersetLocale(this.resolveCanonicalLocale(superLocale), this.resolveCanonicalLocale(subLocale));
+	}
+};
+//#endregion
 //#region src/index.ts
 /**
 * GT is the core driver for the General Translation library.
@@ -1945,6 +2101,10 @@ async function _publishFiles(files, config) {
 * });
 */
 var GT = class {
+	/** Client-safe locale and formatting helpers */
+	get localeConfig() {
+		return this._localeConfig;
+	}
 	/**
 	* Constructs an instance of the GT class.
 	*
@@ -1961,7 +2121,6 @@ var GT = class {
 	* });
 	*/
 	constructor(params = {}) {
-		this._renderingLocales = [];
 		if (typeof process !== "undefined") {
 			this.apiKey ||= process.env?.GT_API_KEY;
 			this.devApiKey ||= process.env?.GT_DEV_API_KEY;
@@ -1981,10 +2140,6 @@ var GT = class {
 			this.targetLocale = _standardizeLocale(targetLocale);
 			if (!_isValidLocale(this.targetLocale, customMapping)) throw new Error(invalidLocaleError(this.targetLocale));
 		}
-		this._renderingLocales = [];
-		if (this.sourceLocale) this._renderingLocales.push(this.sourceLocale);
-		if (this.targetLocale) this._renderingLocales.push(this.targetLocale);
-		this._renderingLocales.push("en");
 		if (locales) {
 			const result = [];
 			const invalidLocales = [];
@@ -2001,6 +2156,11 @@ var GT = class {
 			this.customMapping = customMapping;
 			this.reverseCustomMapping = Object.fromEntries(Object.entries(customMapping).filter(([, value]) => value && typeof value === "object" && "code" in value).map(([key, value]) => [value.code, key]));
 		}
+		this._localeConfig = new LocaleConfig({
+			defaultLocale: this.sourceLocale,
+			locales: this.locales ?? [],
+			customMapping: this.customMapping
+		});
 	}
 	_getTranslationConfig() {
 		return {
@@ -2497,10 +2657,7 @@ var GT = class {
 	* // Returns: '...ld!'
 	*/
 	formatCutoff(value, options) {
-		return formatCutoff(value, {
-			locales: this._renderingLocales,
-			...options
-		});
+		return this.localeConfig.formatCutoff(value, this.targetLocale, options);
 	}
 	/**
 	* Formats a message according to the specified locales and options.
@@ -2519,10 +2676,7 @@ var GT = class {
 	* // Returns: "Bonjour John"
 	*/
 	formatMessage(message, options) {
-		return formatMessage(message, {
-			locales: this._renderingLocales,
-			...options
-		});
+		return this.localeConfig.formatMessage(message, this.targetLocale, options);
 	}
 	/**
 	* Formats a number according to the specified locales and options.
@@ -2538,10 +2692,7 @@ var GT = class {
 	* // Returns: "$1,234.56"
 	*/
 	formatNum(number, options) {
-		return formatNum(number, {
-			locales: this._renderingLocales,
-			...options
-		});
+		return this.localeConfig.formatNum(number, this.targetLocale, options);
 	}
 	/**
 	* Formats a date according to the specified locales and options.
@@ -2557,10 +2708,7 @@ var GT = class {
 	* // Returns: "Thursday, March 14, 2024 at 2:30:45 PM GMT-7"
 	*/
 	formatDateTime(date, options) {
-		return formatDateTime(date, {
-			locales: this._renderingLocales,
-			...options
-		});
+		return this.localeConfig.formatDateTime(date, this.targetLocale, options);
 	}
 	/**
 	* Formats a currency value according to the specified locales and options.
@@ -2577,10 +2725,7 @@ var GT = class {
 	* // Returns: "$1,234.56"
 	*/
 	formatCurrency(value, currency, options) {
-		return formatCurrency(value, currency, {
-			locales: this._renderingLocales,
-			...options
-		});
+		return this.localeConfig.formatCurrency(value, currency, this.targetLocale, options);
 	}
 	/**
 	* Formats a list of items according to the specified locales and options.
@@ -2596,11 +2741,7 @@ var GT = class {
 	* // Returns: "apple, banana, and orange"
 	*/
 	formatList(array, options) {
-		return _formatList({
-			value: array,
-			locales: options?.locales || this._renderingLocales,
-			options
-		});
+		return this.localeConfig.formatList(array, this.targetLocale, options);
 	}
 	/**
 	* Formats a list of items according to the specified locales and options.
@@ -2615,11 +2756,7 @@ var GT = class {
 	* // Returns: ['apple', ', ', 42, ' and ', '{ foo: "bar" }']
 	*/
 	formatListToParts(array, options) {
-		return _formatListToParts({
-			value: array,
-			locales: options?.locales || this._renderingLocales,
-			options
-		});
+		return this.localeConfig.formatListToParts(array, this.targetLocale, options);
 	}
 	/**
 	* Formats a relative time value according to the specified locales and options.
@@ -2636,10 +2773,7 @@ var GT = class {
 	* // Returns: "yesterday"
 	*/
 	formatRelativeTime(value, unit, options) {
-		return formatRelativeTime(value, unit, {
-			locales: this._renderingLocales,
-			...options
-		});
+		return this.localeConfig.formatRelativeTime(value, unit, this.targetLocale, options);
 	}
 	/**
 	* Formats a relative time string from a Date, automatically selecting the best unit.
@@ -2654,10 +2788,7 @@ var GT = class {
 	* // Returns: "1 hour ago"
 	*/
 	formatRelativeTimeFromDate(date, options) {
-		return formatRelativeTimeFromDate(date, {
-			locales: this._renderingLocales,
-			...options
-		});
+		return this.localeConfig.formatRelativeTimeFromDate(date, this.targetLocale, options);
 	}
 	/**
 	* Retrieves the display name of a locale code using Intl.DisplayNames, returning an empty string if no name is found.
@@ -2672,7 +2803,7 @@ var GT = class {
 	*/
 	getLocaleName(locale = this.targetLocale) {
 		if (!locale) throw new Error(noTargetLocaleProvidedError("getLocaleName"));
-		return _getLocaleName(locale, this.sourceLocale, this.customMapping);
+		return this.localeConfig.getLocaleName(locale);
 	}
 	/**
 	* Retrieves an emoji based on a given locale code.
@@ -2688,7 +2819,7 @@ var GT = class {
 	*/
 	getLocaleEmoji(locale = this.targetLocale) {
 		if (!locale) throw new Error(noTargetLocaleProvidedError("getLocaleEmoji"));
-		return getLocaleEmoji(locale, this.customMapping);
+		return this.localeConfig.getLocaleEmoji(locale);
 	}
 	/**
 	* Generates linguistic details for a given locale code.
@@ -2724,7 +2855,7 @@ var GT = class {
 	*/
 	getLocaleProperties(locale = this.targetLocale) {
 		if (!locale) throw new Error(noTargetLocaleProvidedError("getLocaleProperties"));
-		return getLocaleProperties(locale, this.sourceLocale, this.customMapping);
+		return this.localeConfig.getLocaleProperties(locale);
 	}
 	/**
 	* Retrieves multiple properties for a given region code, including:
@@ -2798,6 +2929,7 @@ var GT = class {
 	requiresTranslation(sourceLocale = this.sourceLocale, targetLocale = this.targetLocale, approvedLocales = this.locales, customMapping = this.customMapping) {
 		if (!sourceLocale) throw new Error(noSourceLocaleProvidedError("requiresTranslation"));
 		if (!targetLocale) throw new Error(noTargetLocaleProvidedError("requiresTranslation"));
+		if (customMapping === this.customMapping) return this.localeConfig.requiresTranslation(targetLocale, sourceLocale, approvedLocales);
 		return _requiresTranslation(sourceLocale, targetLocale, approvedLocales, customMapping);
 	}
 	/**
@@ -2812,6 +2944,7 @@ var GT = class {
 	* // Returns: "fr-FR"
 	*/
 	determineLocale(locales, approvedLocales = this.locales || [], customMapping = this.customMapping) {
+		if (customMapping === this.customMapping) return this.localeConfig.determineLocale(locales, approvedLocales ?? []);
 		return _determineLocale(locales, approvedLocales, customMapping);
 	}
 	/**
@@ -2827,7 +2960,7 @@ var GT = class {
 	*/
 	getLocaleDirection(locale = this.targetLocale) {
 		if (!locale) throw new Error(noTargetLocaleProvidedError("getLocaleDirection"));
-		return getLocaleDirection(locale);
+		return this.localeConfig.getLocaleDirection(locale);
 	}
 	/**
 	* Checks if a given BCP 47 locale code is valid.
@@ -2843,7 +2976,8 @@ var GT = class {
 	*/
 	isValidLocale(locale = this.targetLocale, customMapping = this.customMapping) {
 		if (!locale) throw new Error(noTargetLocaleProvidedError("isValidLocale"));
-		return isValidLocale(locale, customMapping);
+		if (customMapping === this.customMapping) return this.localeConfig.isValidLocale(locale);
+		return _isValidLocale(locale, customMapping);
 	}
 	/**
 	* Resolves the canonical locale for a given locale.
@@ -2853,6 +2987,7 @@ var GT = class {
 	*/
 	resolveCanonicalLocale(locale = this.targetLocale, customMapping = this.customMapping) {
 		if (!locale) throw new Error(noTargetLocaleProvidedError("resolveCanonicalLocale"));
+		if (customMapping === this.customMapping) return this.localeConfig.resolveCanonicalLocale(locale);
 		return _resolveCanonicalLocale(locale, customMapping);
 	}
 	/**
@@ -2863,6 +2998,7 @@ var GT = class {
 	*/
 	resolveAliasLocale(locale, customMapping = this.customMapping) {
 		if (!locale) throw new Error(noTargetLocaleProvidedError("resolveAliasLocale"));
+		if (customMapping === this.customMapping) return this.localeConfig.resolveAliasLocale(locale);
 		return _resolveAliasLocale(locale, customMapping);
 	}
 	/**
@@ -2878,7 +3014,7 @@ var GT = class {
 	*/
 	standardizeLocale(locale = this.targetLocale) {
 		if (!locale) throw new Error(noTargetLocaleProvidedError("standardizeLocale"));
-		return _standardizeLocale(locale);
+		return this.localeConfig.standardizeLocale(locale);
 	}
 	/**
 	* Checks if multiple BCP 47 locale codes represent the same dialect.
@@ -2894,7 +3030,7 @@ var GT = class {
 	* // Returns: true
 	*/
 	isSameDialect(...locales) {
-		return isSameDialect(...locales);
+		return this.localeConfig.isSameDialect(...locales);
 	}
 	/**
 	* Checks if multiple BCP 47 locale codes represent the same language.
@@ -2907,7 +3043,7 @@ var GT = class {
 	* // Returns: true
 	*/
 	isSameLanguage(...locales) {
-		return _isSameLanguage(...locales);
+		return this.localeConfig.isSameLanguage(...locales);
 	}
 	/**
 	* Checks if a locale is a superset of another locale.
@@ -2924,7 +3060,7 @@ var GT = class {
 	* // Returns: false
 	*/
 	isSupersetLocale(superLocale, subLocale) {
-		return isSupersetLocale(superLocale, subLocale);
+		return this.localeConfig.isSupersetLocale(superLocale, subLocale);
 	}
 };
 /**
@@ -3300,6 +3436,6 @@ function isSupersetLocale(superLocale, subLocale) {
 }
 const API_VERSION = API_VERSION$1;
 //#endregion
-export { API_VERSION, GT, determineLocale, formatCurrency, formatCutoff, formatDateTime, formatList, formatListToParts, formatMessage, formatNum, formatRelativeTime, formatRelativeTimeFromDate, getLocaleDirection, getLocaleEmoji, getLocaleName, getLocaleProperties, getRegionProperties, isSameDialect, isSameLanguage, isSupersetLocale, isValidLocale, requiresTranslation, resolveAliasLocale, resolveCanonicalLocale, standardizeLocale };
+export { API_VERSION, GT, LocaleConfig, determineLocale, formatCurrency, formatCutoff, formatDateTime, formatList, formatListToParts, formatMessage, formatNum, formatRelativeTime, formatRelativeTimeFromDate, getLocaleDirection, getLocaleEmoji, getLocaleName, getLocaleProperties, getRegionProperties, isSameDialect, isSameLanguage, isSupersetLocale, isValidLocale, requiresTranslation, resolveAliasLocale, resolveCanonicalLocale, standardizeLocale };
 
 //# sourceMappingURL=index.mjs.map