generaltranslation 8.2.7 → 8.2.9

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # generaltranslation
 
+## 8.2.9
+
+### Patch Changes
+
+- [#1278](https://github.com/generaltranslation/gt/pull/1278) [`ce0933a`](https://github.com/generaltranslation/gt/commit/ce0933ab102d34a0c38634f7c2b0d634c9a620a8) Thanks [@bgub](https://github.com/bgub)! - Add a `generaltranslation/core` entrypoint for locale and formatting helpers, and update `gt-i18n` to consume it where possible.
+
+## 8.2.8
+
+### Patch Changes
+
+- [#1248](https://github.com/generaltranslation/gt/pull/1248) [`b12d57d`](https://github.com/generaltranslation/gt/commit/b12d57dab1d5cb1f602c5ac24a702b48cda7f11e) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Add PO/POT file format support and transformFormat plumbing for API uploads and CLI file downloads.
+
 ## 8.2.7
 
 ### Patch Changes

package/dist/{ApiError-4zIP-twr.cjs → ApiError-CZ45tkW6.cjs}

@@ -21,4 +21,4 @@ Object.defineProperty(exports, "ApiError", {
 	}
 });
 
-//# sourceMappingURL=ApiError-4zIP-twr.cjs.map
+//# sourceMappingURL=ApiError-CZ45tkW6.cjs.map

package/dist/{ApiError-4zIP-twr.cjs.map → ApiError-CZ45tkW6.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"ApiError-4zIP-twr.cjs","names":[],"sources":["../src/errors/ApiError.ts"],"sourcesContent":["export class ApiError extends Error {\n  public code: number;\n  public message: string;\n\n  constructor(error: string, code: number, message: string) {\n    super(error);\n    this.name = 'ApiError';\n    this.code = code;\n    this.message = message;\n  }\n\n  getCode() {\n    return this.code;\n  }\n\n  getMessage() {\n    return this.message;\n  }\n}\n"],"mappings":";AAAA,IAAa,WAAb,cAA8B,MAAM;CAIlC,YAAY,OAAe,MAAc,SAAiB;AACxD,QAAM,MAAM;AACZ,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,UAAU;;CAGjB,UAAU;AACR,SAAO,KAAK;;CAGd,aAAa;AACX,SAAO,KAAK"}
+{"version":3,"file":"ApiError-CZ45tkW6.cjs","names":[],"sources":["../src/errors/ApiError.ts"],"sourcesContent":["export class ApiError extends Error {\n  public code: number;\n  public message: string;\n\n  constructor(error: string, code: number, message: string) {\n    super(error);\n    this.name = 'ApiError';\n    this.code = code;\n    this.message = message;\n  }\n\n  getCode() {\n    return this.code;\n  }\n\n  getMessage() {\n    return this.message;\n  }\n}\n"],"mappings":";AAAA,IAAa,WAAb,cAA8B,MAAM;CAIlC,YAAY,OAAe,MAAc,SAAiB;AACxD,QAAM,MAAM;AACZ,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,UAAU;;CAGjB,UAAU;AACR,SAAO,KAAK;;CAGd,aAAa;AACX,SAAO,KAAK"}

package/dist/{ApiError-Bv7vlzyQ.mjs → ApiError-IYfaOR30.mjs}

@@ -16,4 +16,4 @@ var ApiError = class extends Error {
 //#endregion
 export { ApiError as t };
 
-//# sourceMappingURL=ApiError-Bv7vlzyQ.mjs.map
+//# sourceMappingURL=ApiError-IYfaOR30.mjs.map

package/dist/{ApiError-Bv7vlzyQ.mjs.map → ApiError-IYfaOR30.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"ApiError-Bv7vlzyQ.mjs","names":[],"sources":["../src/errors/ApiError.ts"],"sourcesContent":["export class ApiError extends Error {\n  public code: number;\n  public message: string;\n\n  constructor(error: string, code: number, message: string) {\n    super(error);\n    this.name = 'ApiError';\n    this.code = code;\n    this.message = message;\n  }\n\n  getCode() {\n    return this.code;\n  }\n\n  getMessage() {\n    return this.message;\n  }\n}\n"],"mappings":";AAAA,IAAa,WAAb,cAA8B,MAAM;CAIlC,YAAY,OAAe,MAAc,SAAiB;AACxD,QAAM,MAAM;AACZ,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,UAAU;;CAGjB,UAAU;AACR,SAAO,KAAK;;CAGd,aAAa;AACX,SAAO,KAAK"}
+{"version":3,"file":"ApiError-IYfaOR30.mjs","names":[],"sources":["../src/errors/ApiError.ts"],"sourcesContent":["export class ApiError extends Error {\n  public code: number;\n  public message: string;\n\n  constructor(error: string, code: number, message: string) {\n    super(error);\n    this.name = 'ApiError';\n    this.code = code;\n    this.message = message;\n  }\n\n  getCode() {\n    return this.code;\n  }\n\n  getMessage() {\n    return this.message;\n  }\n}\n"],"mappings":";AAAA,IAAa,WAAb,cAA8B,MAAM;CAIlC,YAAY,OAAe,MAAc,SAAiB;AACxD,QAAM,MAAM;AACZ,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,UAAU;;CAGjB,UAAU;AACR,SAAO,KAAK;;CAGd,aAAa;AACX,SAAO,KAAK"}

package/dist/IntlCache-Ccg_cQPR.mjs

@@ -0,0 +1,195 @@
+//#region src/settings/settings.ts
+const libraryDefaultLocale = "en";
+const defaultTimeout = 6e4;
+//#endregion
+//#region src/errors/formattingErrors.ts
+const createInvalidCutoffStyleError = (style) => `generaltranslation Formatting Error: Invalid cutoff style: ${style}.`;
+const DEFAULT_TERMINATOR_KEY = "DEFAULT_TERMINATOR_KEY";
+const TERMINATOR_MAP = {
+	ellipsis: {
+		fr: {
+			terminator: "…",
+			separator: " "
+		},
+		zh: {
+			terminator: "……",
+			separator: void 0
+		},
+		ja: {
+			terminator: "……",
+			separator: void 0
+		},
+		[DEFAULT_TERMINATOR_KEY]: {
+			terminator: "…",
+			separator: void 0
+		}
+	},
+	none: { [DEFAULT_TERMINATOR_KEY]: {
+		terminator: void 0,
+		separator: void 0
+	} }
+};
+//#endregion
+//#region src/formatting/custom-formats/CutoffFormat/CutoffFormat.ts
+var CutoffFormatConstructor = class {
+	/**
+	* Constructor
+	* @param {string | string[]} locales - The locales to use for formatting.
+	* @param {CutoffFormatOptions} options - The options for formatting.
+	* @param {number} [option.maxChars] - The maximum number of characters to display.
+	* - Undefined values are treated as no cutoff.
+	* - Negative values follow .slice() behavior and terminator will be added before the value.
+	* - 0 will result in an empty string.
+	* - If cutoff results in an empty string, no terminator is added.
+	* @param {CutoffFormatStyle} [option.style='ellipsis'] - The style of the terminator.
+	* @param {string} [option.terminator] - Optional override the terminator to use.
+	* @param {string} [option.separator] - Optional override the separator to use between the terminator and the value.
+	* - If no terminator is provided, then separator is ignored.
+	*
+	* @example
+	* const format = new CutoffFormat('en', { maxChars: 5 });
+	* format.format('Hello, world!'); // 'Hello...'
+	*
+	* const format = new CutoffFormat('en', { maxChars: -3 });
+	* format.format('Hello, world!'); // '...ld!'
+	*/
+	constructor(locales, options = {}) {
+		try {
+			const localesList = !locales ? ["en"] : Array.isArray(locales) ? locales.map((l) => String(l)) : [String(locales)];
+			const canonicalLocales = Intl.getCanonicalLocales(localesList);
+			this.locale = canonicalLocales.length ? canonicalLocales[0] : "en";
+		} catch {
+			this.locale = "en";
+		}
+		if (!TERMINATOR_MAP[options.style ?? "ellipsis"]) throw new Error(createInvalidCutoffStyleError(options.style ?? "ellipsis"));
+		let style;
+		let presetTerminatorOptions;
+		if (options.maxChars !== void 0) {
+			style = options.style ?? "ellipsis";
+			const languageCode = new Intl.Locale(this.locale).language;
+			presetTerminatorOptions = TERMINATOR_MAP[style][languageCode] || TERMINATOR_MAP[style]["DEFAULT_TERMINATOR_KEY"];
+		}
+		let terminator = options.terminator ?? presetTerminatorOptions?.terminator;
+		let separator = terminator != null ? options.separator ?? presetTerminatorOptions?.separator : void 0;
+		this.additionLength = (terminator?.length ?? 0) + (separator?.length ?? 0);
+		if (options.maxChars !== void 0 && Math.abs(options.maxChars) < this.additionLength) {
+			terminator = void 0;
+			separator = void 0;
+		}
+		this.options = {
+			maxChars: options.maxChars,
+			style,
+			terminator,
+			separator
+		};
+	}
+	/**
+	* Format a value according to the cutoff options, returning a formatted string.
+	*
+	* @param {string} value - The string value to format with cutoff behavior.
+	* @returns {string} The formatted string with terminator applied if cutoff occurs.
+	*
+	* @example
+	* const formatter = new CutoffFormatConstructor('en', { maxChars: 8, style: 'ellipsis' });
+	* formatter.format('Hello, world!'); // Returns 'Hello, w...'
+	*/
+	format(value) {
+		return this.formatToParts(value).join("");
+	}
+	/**
+	* Format a value to parts according to the cutoff options, returning an array of string parts.
+	* This method breaks down the formatted result into individual components for more granular control.
+	*
+	* @param {string} value - The string value to format with cutoff behavior.
+	* @returns {PrependedCutoffParts | PostpendedCutoffParts} An array of string parts representing the formatted result.
+	*   - For positive maxChars: [cutoffValue, separator?, terminator?]
+	*   - For negative maxChars: [terminator?, separator?, cutoffValue]
+	*   - For no cutoff: [originalValue]
+	*
+	* @example
+	* const formatter = new CutoffFormatConstructor('en', { maxChars: 5, style: 'ellipsis' });
+	* formatter.formatToParts('Hello, world!'); // Returns ['Hello', '...']
+	*/
+	formatToParts(value) {
+		const { maxChars, terminator, separator } = this.options;
+		const adjustedChars = maxChars === void 0 || Math.abs(maxChars) >= value.length ? maxChars : maxChars >= 0 ? Math.max(0, maxChars - this.additionLength) : Math.min(0, maxChars + this.additionLength);
+		const slicedValue = adjustedChars !== void 0 && adjustedChars > -1 ? value.slice(0, adjustedChars) : value.slice(adjustedChars);
+		if (maxChars == null || adjustedChars == null || adjustedChars === 0 || terminator == null || value.length <= Math.abs(maxChars)) return [slicedValue];
+		if (adjustedChars > 0) return separator != null ? [
+			slicedValue,
+			separator,
+			terminator
+		] : [slicedValue, terminator];
+		else return separator != null ? [
+			terminator,
+			separator,
+			slicedValue
+		] : [terminator, slicedValue];
+	}
+	/**
+	* Get the resolved options
+	* @returns {ResolvedCutoffFormatOptions} The resolved options.
+	*/
+	resolvedOptions() {
+		return this.options;
+	}
+};
+//#endregion
+//#region src/cache/IntlCache.ts
+/**
+* Object mapping constructor names to their respective constructor functions
+* Includes all native Intl constructors plus custom ones like CutoffFormat
+*/
+const CustomIntl = {
+	Collator: Intl.Collator,
+	DateTimeFormat: Intl.DateTimeFormat,
+	DisplayNames: Intl.DisplayNames,
+	ListFormat: Intl.ListFormat,
+	Locale: Intl.Locale,
+	NumberFormat: Intl.NumberFormat,
+	PluralRules: Intl.PluralRules,
+	RelativeTimeFormat: Intl.RelativeTimeFormat,
+	Segmenter: Intl.Segmenter,
+	CutoffFormat: CutoffFormatConstructor
+};
+/**
+* Cache for Intl and custom format instances to avoid repeated instantiation
+* Uses a two-level structure: constructor name -> cache key -> instance
+*/
+var IntlCache = class {
+	constructor() {
+		this.cache = {};
+	}
+	/**
+	* Generates a consistent cache key from locales and options
+	* Handles all LocalesArgument types (string, Locale, array, undefined)
+	*/
+	_generateKey(locales, options = {}) {
+		return `${!locales ? "undefined" : Array.isArray(locales) ? locales.map((l) => String(l)).join(",") : String(locales)}:${options ? JSON.stringify(options, Object.keys(options).sort()) : "{}"}`;
+	}
+	/**
+	* Gets a cached Intl instance or creates a new one if not found
+	* @param constructor The name of the Intl constructor to use
+	* @param args Constructor arguments (locales, options)
+	* @returns Cached or newly created Intl instance
+	*/
+	get(constructor, ...args) {
+		const [locales = "en", options = {}] = args;
+		const key = this._generateKey(locales, options);
+		let intlObject = this.cache[constructor]?.[key];
+		if (intlObject === void 0) {
+			intlObject = new CustomIntl[constructor](...args);
+			if (!this.cache[constructor]) this.cache[constructor] = {};
+			this.cache[constructor][key] = intlObject;
+		}
+		return intlObject;
+	}
+};
+/**
+* Global instance of the Intl cache for use throughout the application
+*/
+const intlCache = new IntlCache();
+//#endregion
+export { defaultTimeout as n, libraryDefaultLocale as r, intlCache as t };
+
+//# sourceMappingURL=IntlCache-Ccg_cQPR.mjs.map

package/dist/IntlCache-Ccg_cQPR.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntlCache-Ccg_cQPR.mjs","names":[],"sources":["../src/settings/settings.ts","../src/errors/formattingErrors.ts","../src/formatting/custom-formats/CutoffFormat/constants.ts","../src/formatting/custom-formats/CutoffFormat/CutoffFormat.ts","../src/cache/IntlCache.ts"],"sourcesContent":["export const libraryDefaultLocale = 'en' as const;\nexport const defaultTimeout = 60000;\n","export const createInvalidCutoffStyleError = (style: string) =>\n  `generaltranslation Formatting Error: Invalid cutoff style: ${style}.`;\n","import { CutoffFormatStyle, ResolvedTerminatorOptions } from './types';\n\nexport const DEFAULT_CUTOFF_FORMAT_STYLE: CutoffFormatStyle = 'ellipsis';\n\nexport const DEFAULT_TERMINATOR_KEY = 'DEFAULT_TERMINATOR_KEY';\n\nexport const TERMINATOR_MAP: Record<\n  CutoffFormatStyle,\n  Record<string | typeof DEFAULT_TERMINATOR_KEY, ResolvedTerminatorOptions>\n> = {\n  ellipsis: {\n    fr: {\n      terminator: '…',\n      separator: '\\u202F',\n    },\n    zh: {\n      terminator: '……',\n      separator: undefined,\n    },\n    ja: {\n      terminator: '……',\n      separator: undefined,\n    },\n    [DEFAULT_TERMINATOR_KEY]: {\n      terminator: '…',\n      separator: undefined,\n    },\n  },\n  none: {\n    [DEFAULT_TERMINATOR_KEY]: {\n      terminator: undefined,\n      separator: undefined,\n    },\n  },\n};\n","import { createInvalidCutoffStyleError } from '../../../errors/formattingErrors';\nimport { libraryDefaultLocale } from '../../../settings/settings';\nimport {\n  DEFAULT_CUTOFF_FORMAT_STYLE,\n  DEFAULT_TERMINATOR_KEY,\n  TERMINATOR_MAP,\n} from './constants';\nimport {\n  CutoffFormat,\n  CutoffFormatOptions,\n  CutoffFormatStyle,\n  PostpendedCutoffParts,\n  PrependedCutoffParts,\n  ResolvedCutoffFormatOptions,\n  ResolvedTerminatorOptions,\n} from './types';\n\nexport class CutoffFormatConstructor implements CutoffFormat {\n  private locale: string;\n  private options: ResolvedCutoffFormatOptions;\n  private additionLength: number;\n  /**\n   * Constructor\n   * @param {string | string[]} locales - The locales to use for formatting.\n   * @param {CutoffFormatOptions} options - The options for formatting.\n   * @param {number} [option.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} [option.style='ellipsis'] - The style of the terminator.\n   * @param {string} [option.terminator] - Optional override the terminator to use.\n   * @param {string} [option.separator] - Optional override the separator to use between the terminator and the value.\n   * - If no terminator is provided, then separator is ignored.\n   *\n   * @example\n   * const format = new CutoffFormat('en', { maxChars: 5 });\n   * format.format('Hello, world!'); // 'Hello...'\n   *\n   * const format = new CutoffFormat('en', { maxChars: -3 });\n   * format.format('Hello, world!'); // '...ld!'\n   */\n  constructor(\n    locales: Intl.LocalesArgument,\n    options: CutoffFormatOptions = {}\n  ) {\n    // Determine locale (this replicates Intl.NumberFormat behavior including silent failure)\n    try {\n      // Normalize locales to string\n      const localesList = !locales\n        ? [libraryDefaultLocale]\n        : Array.isArray(locales)\n          ? locales.map((l) => String(l))\n          : [String(locales)];\n      const canonicalLocales = Intl.getCanonicalLocales(localesList);\n      this.locale = canonicalLocales.length\n        ? canonicalLocales[0]\n        : libraryDefaultLocale;\n    } catch {\n      this.locale = libraryDefaultLocale;\n    }\n\n    // Follows Intl.NumberFormat behavior of throwing an error when currency is invalid\n    if (!TERMINATOR_MAP[options.style ?? DEFAULT_CUTOFF_FORMAT_STYLE]) {\n      throw new Error(\n        createInvalidCutoffStyleError(\n          options.style ?? DEFAULT_CUTOFF_FORMAT_STYLE\n        )\n      );\n    }\n\n    // Resolve terminator options\n    let style: CutoffFormatStyle | undefined;\n    let presetTerminatorOptions: ResolvedTerminatorOptions | undefined;\n    if (options.maxChars !== undefined) {\n      style = options.style ?? DEFAULT_CUTOFF_FORMAT_STYLE;\n      // TODO: need more sophisticated locale negotiation if we want to add support for region/script/etc.-specific terminators in the future\n      const languageCode = new Intl.Locale(this.locale).language;\n      presetTerminatorOptions =\n        TERMINATOR_MAP[style][languageCode] ||\n        TERMINATOR_MAP[style][DEFAULT_TERMINATOR_KEY];\n    }\n    let terminator: ResolvedTerminatorOptions['terminator'] =\n      options.terminator ?? presetTerminatorOptions?.terminator;\n    let separator: ResolvedTerminatorOptions['separator'] =\n      terminator != null\n        ? (options.separator ?? presetTerminatorOptions?.separator)\n        : undefined;\n    // // Remove terminator and separator if maxChars does have enough space\n    this.additionLength = (terminator?.length ?? 0) + (separator?.length ?? 0);\n    if (\n      options.maxChars !== undefined &&\n      Math.abs(options.maxChars) < this.additionLength\n    ) {\n      terminator = undefined;\n      separator = undefined;\n    }\n\n    this.options = {\n      maxChars: options.maxChars,\n      style,\n      terminator,\n      separator,\n    };\n  }\n\n  /**\n   * Format a value according to the cutoff options, returning a formatted string.\n   *\n   * @param {string} value - The string value to format with cutoff behavior.\n   * @returns {string} The formatted string with terminator applied if cutoff occurs.\n   *\n   * @example\n   * const formatter = new CutoffFormatConstructor('en', { maxChars: 8, style: 'ellipsis' });\n   * formatter.format('Hello, world!'); // Returns 'Hello, w...'\n   */\n  format(value: string): string {\n    return this.formatToParts(value).join('');\n  }\n\n  /**\n   * Format a value to parts according to the cutoff options, returning an array of string parts.\n   * This method breaks down the formatted result into individual components for more granular control.\n   *\n   * @param {string} value - The string value to format with cutoff behavior.\n   * @returns {PrependedCutoffParts | PostpendedCutoffParts} An array of string parts representing the formatted result.\n   *   - For positive maxChars: [cutoffValue, separator?, terminator?]\n   *   - For negative maxChars: [terminator?, separator?, cutoffValue]\n   *   - For no cutoff: [originalValue]\n   *\n   * @example\n   * const formatter = new CutoffFormatConstructor('en', { maxChars: 5, style: 'ellipsis' });\n   * formatter.formatToParts('Hello, world!'); // Returns ['Hello', '...']\n   */\n  formatToParts(value: string): PrependedCutoffParts | PostpendedCutoffParts {\n    const { maxChars, terminator, separator } = this.options;\n\n    // Slice our value\n    // const additionLength = (terminator?.length ?? 0) + (separator?.length ?? 0);\n    const adjustedChars =\n      maxChars === undefined || Math.abs(maxChars) >= value.length\n        ? maxChars\n        : maxChars >= 0\n          ? Math.max(0, maxChars - this.additionLength)\n          : Math.min(0, maxChars + this.additionLength);\n    const slicedValue =\n      adjustedChars !== undefined && adjustedChars > -1\n        ? value.slice(0, adjustedChars)\n        : value.slice(adjustedChars);\n\n    // No cutoff, no terminator -> value only\n    if (\n      maxChars == null ||\n      adjustedChars == null ||\n      adjustedChars === 0 ||\n      terminator == null ||\n      value.length <= Math.abs(maxChars)\n    ) {\n      return [slicedValue];\n    }\n\n    // Postpended cutoff\n    if (adjustedChars > 0) {\n      return separator != null\n        ? [slicedValue, separator, terminator]\n        : [slicedValue, terminator];\n    }\n    // Prepended cutoff\n    else {\n      return separator != null\n        ? [terminator, separator, slicedValue]\n        : [terminator, slicedValue];\n    }\n  }\n\n  /**\n   * Get the resolved options\n   * @returns {ResolvedCutoffFormatOptions} The resolved options.\n   */\n  resolvedOptions(): ResolvedCutoffFormatOptions {\n    return this.options;\n  }\n}\n","import { libraryDefaultLocale } from '../settings/settings';\nimport { CutoffFormatConstructor } from '../formatting/custom-formats/CutoffFormat/CutoffFormat';\nimport {\n  ConstructorType,\n  CustomIntlConstructors,\n  CustomIntlType,\n  IntlCacheObject,\n} from './types';\n\n/**\n * Object mapping constructor names to their respective constructor functions\n * Includes all native Intl constructors plus custom ones like CutoffFormat\n */\nconst CustomIntl: CustomIntlType = {\n  Collator: Intl.Collator,\n  DateTimeFormat: Intl.DateTimeFormat,\n  DisplayNames: Intl.DisplayNames,\n  ListFormat: Intl.ListFormat,\n  Locale: Intl.Locale,\n  NumberFormat: Intl.NumberFormat,\n  PluralRules: Intl.PluralRules,\n  RelativeTimeFormat: Intl.RelativeTimeFormat,\n  Segmenter: Intl.Segmenter,\n  CutoffFormat: CutoffFormatConstructor,\n};\n\n/**\n * Cache for Intl and custom format instances to avoid repeated instantiation\n * Uses a two-level structure: constructor name -> cache key -> instance\n */\nclass IntlCache {\n  private cache: IntlCacheObject;\n\n  constructor() {\n    this.cache = {};\n  }\n\n  /**\n   * Generates a consistent cache key from locales and options\n   * Handles all LocalesArgument types (string, Locale, array, undefined)\n   */\n  private _generateKey(locales: Intl.LocalesArgument, options = {}) {\n    // Normalize locales to string representation\n    const localeKey = !locales\n      ? 'undefined'\n      : Array.isArray(locales)\n        ? locales.map((l) => String(l)).join(',')\n        : String(locales);\n\n    // Sort option keys to ensure consistent key generation regardless of property order\n    const sortedOptions = options\n      ? JSON.stringify(options, Object.keys(options).sort())\n      : '{}';\n    return `${localeKey}:${sortedOptions}`;\n  }\n\n  /**\n   * Gets a cached Intl instance or creates a new one if not found\n   * @param constructor The name of the Intl constructor to use\n   * @param args Constructor arguments (locales, options)\n   * @returns Cached or newly created Intl instance\n   */\n  get<K extends keyof CustomIntlConstructors>(\n    constructor: K,\n    ...args: ConstructorParameters<CustomIntlConstructors[K]>\n  ): InstanceType<ConstructorType<K>> {\n    const [locales = libraryDefaultLocale, options = {}] = args;\n    const key = this._generateKey(locales, options);\n    let intlObject = this.cache[constructor]?.[key];\n\n    if (intlObject === undefined) {\n      // Create new instance and cache it\n      intlObject = new CustomIntl[constructor](...args);\n      if (!this.cache[constructor]) this.cache[constructor] = {};\n      this.cache[constructor][key] = intlObject;\n    }\n\n    return intlObject;\n  }\n}\n\n/**\n * Global instance of the Intl cache for use throughout the application\n */\nexport const intlCache = new IntlCache();\n"],"mappings":";AAAA,MAAa,uBAAuB;AACpC,MAAa,iBAAiB;;;ACD9B,MAAa,iCAAiC,UAC5C,8DAA8D,MAAM;ACGtE,MAAa,yBAAyB;AAEtC,MAAa,iBAGT;CACF,UAAU;EACR,IAAI;GACF,YAAY;GACZ,WAAW;GACZ;EACD,IAAI;GACF,YAAY;GACZ,WAAW,KAAA;GACZ;EACD,IAAI;GACF,YAAY;GACZ,WAAW,KAAA;GACZ;GACA,yBAAyB;GACxB,YAAY;GACZ,WAAW,KAAA;GACZ;EACF;CACD,MAAM,GACH,yBAAyB;EACxB,YAAY,KAAA;EACZ,WAAW,KAAA;EACZ,EACF;CACF;;;ACjBD,IAAa,0BAAb,MAA6D;;;;;;;;;;;;;;;;;;;;;;CAyB3D,YACE,SACA,UAA+B,EAAE,EACjC;AAEA,MAAI;GAEF,MAAM,cAAc,CAAC,UACjB,CAAA,KAAsB,GACtB,MAAM,QAAQ,QAAQ,GACpB,QAAQ,KAAK,MAAM,OAAO,EAAE,CAAC,GAC7B,CAAC,OAAO,QAAQ,CAAC;GACvB,MAAM,mBAAmB,KAAK,oBAAoB,YAAY;AAC9D,QAAK,SAAS,iBAAiB,SAC3B,iBAAiB,KAAA;UAEf;AACN,QAAK,SAAA;;AAIP,MAAI,CAAC,eAAe,QAAQ,SAAA,YAC1B,OAAM,IAAI,MACR,8BACE,QAAQ,SAAA,WACT,CACF;EAIH,IAAI;EACJ,IAAI;AACJ,MAAI,QAAQ,aAAa,KAAA,GAAW;AAClC,WAAQ,QAAQ,SAAA;GAEhB,MAAM,eAAe,IAAI,KAAK,OAAO,KAAK,OAAO,CAAC;AAClD,6BACE,eAAe,OAAO,iBACtB,eAAe,OAAA;;EAEnB,IAAI,aACF,QAAQ,cAAc,yBAAyB;EACjD,IAAI,YACF,cAAc,OACT,QAAQ,aAAa,yBAAyB,YAC/C,KAAA;AAEN,OAAK,kBAAkB,YAAY,UAAU,MAAM,WAAW,UAAU;AACxE,MACE,QAAQ,aAAa,KAAA,KACrB,KAAK,IAAI,QAAQ,SAAS,GAAG,KAAK,gBAClC;AACA,gBAAa,KAAA;AACb,eAAY,KAAA;;AAGd,OAAK,UAAU;GACb,UAAU,QAAQ;GAClB;GACA;GACA;GACD;;;;;;;;;;;;CAaH,OAAO,OAAuB;AAC5B,SAAO,KAAK,cAAc,MAAM,CAAC,KAAK,GAAG;;;;;;;;;;;;;;;;CAiB3C,cAAc,OAA6D;EACzE,MAAM,EAAE,UAAU,YAAY,cAAc,KAAK;EAIjD,MAAM,gBACJ,aAAa,KAAA,KAAa,KAAK,IAAI,SAAS,IAAI,MAAM,SAClD,WACA,YAAY,IACV,KAAK,IAAI,GAAG,WAAW,KAAK,eAAe,GAC3C,KAAK,IAAI,GAAG,WAAW,KAAK,eAAe;EACnD,MAAM,cACJ,kBAAkB,KAAA,KAAa,gBAAgB,KAC3C,MAAM,MAAM,GAAG,cAAc,GAC7B,MAAM,MAAM,cAAc;AAGhC,MACE,YAAY,QACZ,iBAAiB,QACjB,kBAAkB,KAClB,cAAc,QACd,MAAM,UAAU,KAAK,IAAI,SAAS,CAElC,QAAO,CAAC,YAAY;AAItB,MAAI,gBAAgB,EAClB,QAAO,aAAa,OAChB;GAAC;GAAa;GAAW;GAAW,GACpC,CAAC,aAAa,WAAW;MAI7B,QAAO,aAAa,OAChB;GAAC;GAAY;GAAW;GAAY,GACpC,CAAC,YAAY,YAAY;;;;;;CAQjC,kBAA+C;AAC7C,SAAO,KAAK;;;;;;;;;ACvKhB,MAAM,aAA6B;CACjC,UAAU,KAAK;CACf,gBAAgB,KAAK;CACrB,cAAc,KAAK;CACnB,YAAY,KAAK;CACjB,QAAQ,KAAK;CACb,cAAc,KAAK;CACnB,aAAa,KAAK;CAClB,oBAAoB,KAAK;CACzB,WAAW,KAAK;CAChB,cAAc;CACf;;;;;AAMD,IAAM,YAAN,MAAgB;CAGd,cAAc;AACZ,OAAK,QAAQ,EAAE;;;;;;CAOjB,aAAqB,SAA+B,UAAU,EAAE,EAAE;AAYhE,SAAO,GAVW,CAAC,UACf,cACA,MAAM,QAAQ,QAAQ,GACpB,QAAQ,KAAK,MAAM,OAAO,EAAE,CAAC,CAAC,KAAK,IAAI,GACvC,OAAO,QAAQ,CAMD,GAHE,UAClB,KAAK,UAAU,SAAS,OAAO,KAAK,QAAQ,CAAC,MAAM,CAAC,GACpD;;;;;;;;CAUN,IACE,aACA,GAAG,MAC+B;EAClC,MAAM,CAAC,UAAA,MAAgC,UAAU,EAAE,IAAI;EACvD,MAAM,MAAM,KAAK,aAAa,SAAS,QAAQ;EAC/C,IAAI,aAAa,KAAK,MAAM,eAAe;AAE3C,MAAI,eAAe,KAAA,GAAW;AAE5B,gBAAa,IAAI,WAAW,aAAa,GAAG,KAAK;AACjD,OAAI,CAAC,KAAK,MAAM,aAAc,MAAK,MAAM,eAAe,EAAE;AAC1D,QAAK,MAAM,aAAa,OAAO;;AAGjC,SAAO;;;;;;AAOX,MAAa,YAAY,IAAI,WAAW"}

package/dist/IntlCache-k2qfrDqB.cjs

@@ -0,0 +1,212 @@
+//#region src/settings/settings.ts
+const libraryDefaultLocale = "en";
+const defaultTimeout = 6e4;
+//#endregion
+//#region src/errors/formattingErrors.ts
+const createInvalidCutoffStyleError = (style) => `generaltranslation Formatting Error: Invalid cutoff style: ${style}.`;
+const DEFAULT_TERMINATOR_KEY = "DEFAULT_TERMINATOR_KEY";
+const TERMINATOR_MAP = {
+	ellipsis: {
+		fr: {
+			terminator: "…",
+			separator: " "
+		},
+		zh: {
+			terminator: "……",
+			separator: void 0
+		},
+		ja: {
+			terminator: "……",
+			separator: void 0
+		},
+		[DEFAULT_TERMINATOR_KEY]: {
+			terminator: "…",
+			separator: void 0
+		}
+	},
+	none: { [DEFAULT_TERMINATOR_KEY]: {
+		terminator: void 0,
+		separator: void 0
+	} }
+};
+//#endregion
+//#region src/formatting/custom-formats/CutoffFormat/CutoffFormat.ts
+var CutoffFormatConstructor = class {
+	/**
+	* Constructor
+	* @param {string | string[]} locales - The locales to use for formatting.
+	* @param {CutoffFormatOptions} options - The options for formatting.
+	* @param {number} [option.maxChars] - The maximum number of characters to display.
+	* - Undefined values are treated as no cutoff.
+	* - Negative values follow .slice() behavior and terminator will be added before the value.
+	* - 0 will result in an empty string.
+	* - If cutoff results in an empty string, no terminator is added.
+	* @param {CutoffFormatStyle} [option.style='ellipsis'] - The style of the terminator.
+	* @param {string} [option.terminator] - Optional override the terminator to use.
+	* @param {string} [option.separator] - Optional override the separator to use between the terminator and the value.
+	* - If no terminator is provided, then separator is ignored.
+	*
+	* @example
+	* const format = new CutoffFormat('en', { maxChars: 5 });
+	* format.format('Hello, world!'); // 'Hello...'
+	*
+	* const format = new CutoffFormat('en', { maxChars: -3 });
+	* format.format('Hello, world!'); // '...ld!'
+	*/
+	constructor(locales, options = {}) {
+		try {
+			const localesList = !locales ? ["en"] : Array.isArray(locales) ? locales.map((l) => String(l)) : [String(locales)];
+			const canonicalLocales = Intl.getCanonicalLocales(localesList);
+			this.locale = canonicalLocales.length ? canonicalLocales[0] : "en";
+		} catch {
+			this.locale = "en";
+		}
+		if (!TERMINATOR_MAP[options.style ?? "ellipsis"]) throw new Error(createInvalidCutoffStyleError(options.style ?? "ellipsis"));
+		let style;
+		let presetTerminatorOptions;
+		if (options.maxChars !== void 0) {
+			style = options.style ?? "ellipsis";
+			const languageCode = new Intl.Locale(this.locale).language;
+			presetTerminatorOptions = TERMINATOR_MAP[style][languageCode] || TERMINATOR_MAP[style]["DEFAULT_TERMINATOR_KEY"];
+		}
+		let terminator = options.terminator ?? presetTerminatorOptions?.terminator;
+		let separator = terminator != null ? options.separator ?? presetTerminatorOptions?.separator : void 0;
+		this.additionLength = (terminator?.length ?? 0) + (separator?.length ?? 0);
+		if (options.maxChars !== void 0 && Math.abs(options.maxChars) < this.additionLength) {
+			terminator = void 0;
+			separator = void 0;
+		}
+		this.options = {
+			maxChars: options.maxChars,
+			style,
+			terminator,
+			separator
+		};
+	}
+	/**
+	* Format a value according to the cutoff options, returning a formatted string.
+	*
+	* @param {string} value - The string value to format with cutoff behavior.
+	* @returns {string} The formatted string with terminator applied if cutoff occurs.
+	*
+	* @example
+	* const formatter = new CutoffFormatConstructor('en', { maxChars: 8, style: 'ellipsis' });
+	* formatter.format('Hello, world!'); // Returns 'Hello, w...'
+	*/
+	format(value) {
+		return this.formatToParts(value).join("");
+	}
+	/**
+	* Format a value to parts according to the cutoff options, returning an array of string parts.
+	* This method breaks down the formatted result into individual components for more granular control.
+	*
+	* @param {string} value - The string value to format with cutoff behavior.
+	* @returns {PrependedCutoffParts | PostpendedCutoffParts} An array of string parts representing the formatted result.
+	*   - For positive maxChars: [cutoffValue, separator?, terminator?]
+	*   - For negative maxChars: [terminator?, separator?, cutoffValue]
+	*   - For no cutoff: [originalValue]
+	*
+	* @example
+	* const formatter = new CutoffFormatConstructor('en', { maxChars: 5, style: 'ellipsis' });
+	* formatter.formatToParts('Hello, world!'); // Returns ['Hello', '...']
+	*/
+	formatToParts(value) {
+		const { maxChars, terminator, separator } = this.options;
+		const adjustedChars = maxChars === void 0 || Math.abs(maxChars) >= value.length ? maxChars : maxChars >= 0 ? Math.max(0, maxChars - this.additionLength) : Math.min(0, maxChars + this.additionLength);
+		const slicedValue = adjustedChars !== void 0 && adjustedChars > -1 ? value.slice(0, adjustedChars) : value.slice(adjustedChars);
+		if (maxChars == null || adjustedChars == null || adjustedChars === 0 || terminator == null || value.length <= Math.abs(maxChars)) return [slicedValue];
+		if (adjustedChars > 0) return separator != null ? [
+			slicedValue,
+			separator,
+			terminator
+		] : [slicedValue, terminator];
+		else return separator != null ? [
+			terminator,
+			separator,
+			slicedValue
+		] : [terminator, slicedValue];
+	}
+	/**
+	* Get the resolved options
+	* @returns {ResolvedCutoffFormatOptions} The resolved options.
+	*/
+	resolvedOptions() {
+		return this.options;
+	}
+};
+//#endregion
+//#region src/cache/IntlCache.ts
+/**
+* Object mapping constructor names to their respective constructor functions
+* Includes all native Intl constructors plus custom ones like CutoffFormat
+*/
+const CustomIntl = {
+	Collator: Intl.Collator,
+	DateTimeFormat: Intl.DateTimeFormat,
+	DisplayNames: Intl.DisplayNames,
+	ListFormat: Intl.ListFormat,
+	Locale: Intl.Locale,
+	NumberFormat: Intl.NumberFormat,
+	PluralRules: Intl.PluralRules,
+	RelativeTimeFormat: Intl.RelativeTimeFormat,
+	Segmenter: Intl.Segmenter,
+	CutoffFormat: CutoffFormatConstructor
+};
+/**
+* Cache for Intl and custom format instances to avoid repeated instantiation
+* Uses a two-level structure: constructor name -> cache key -> instance
+*/
+var IntlCache = class {
+	constructor() {
+		this.cache = {};
+	}
+	/**
+	* Generates a consistent cache key from locales and options
+	* Handles all LocalesArgument types (string, Locale, array, undefined)
+	*/
+	_generateKey(locales, options = {}) {
+		return `${!locales ? "undefined" : Array.isArray(locales) ? locales.map((l) => String(l)).join(",") : String(locales)}:${options ? JSON.stringify(options, Object.keys(options).sort()) : "{}"}`;
+	}
+	/**
+	* Gets a cached Intl instance or creates a new one if not found
+	* @param constructor The name of the Intl constructor to use
+	* @param args Constructor arguments (locales, options)
+	* @returns Cached or newly created Intl instance
+	*/
+	get(constructor, ...args) {
+		const [locales = "en", options = {}] = args;
+		const key = this._generateKey(locales, options);
+		let intlObject = this.cache[constructor]?.[key];
+		if (intlObject === void 0) {
+			intlObject = new CustomIntl[constructor](...args);
+			if (!this.cache[constructor]) this.cache[constructor] = {};
+			this.cache[constructor][key] = intlObject;
+		}
+		return intlObject;
+	}
+};
+/**
+* Global instance of the Intl cache for use throughout the application
+*/
+const intlCache = new IntlCache();
+//#endregion
+Object.defineProperty(exports, "defaultTimeout", {
+	enumerable: true,
+	get: function() {
+		return defaultTimeout;
+	}
+});
+Object.defineProperty(exports, "intlCache", {
+	enumerable: true,
+	get: function() {
+		return intlCache;
+	}
+});
+Object.defineProperty(exports, "libraryDefaultLocale", {
+	enumerable: true,
+	get: function() {
+		return libraryDefaultLocale;
+	}
+});
+
+//# sourceMappingURL=IntlCache-k2qfrDqB.cjs.map

package/dist/IntlCache-k2qfrDqB.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntlCache-k2qfrDqB.cjs","names":[],"sources":["../src/settings/settings.ts","../src/errors/formattingErrors.ts","../src/formatting/custom-formats/CutoffFormat/constants.ts","../src/formatting/custom-formats/CutoffFormat/CutoffFormat.ts","../src/cache/IntlCache.ts"],"sourcesContent":["export const libraryDefaultLocale = 'en' as const;\nexport const defaultTimeout = 60000;\n","export const createInvalidCutoffStyleError = (style: string) =>\n  `generaltranslation Formatting Error: Invalid cutoff style: ${style}.`;\n","import { CutoffFormatStyle, ResolvedTerminatorOptions } from './types';\n\nexport const DEFAULT_CUTOFF_FORMAT_STYLE: CutoffFormatStyle = 'ellipsis';\n\nexport const DEFAULT_TERMINATOR_KEY = 'DEFAULT_TERMINATOR_KEY';\n\nexport const TERMINATOR_MAP: Record<\n  CutoffFormatStyle,\n  Record<string | typeof DEFAULT_TERMINATOR_KEY, ResolvedTerminatorOptions>\n> = {\n  ellipsis: {\n    fr: {\n      terminator: '…',\n      separator: '\\u202F',\n    },\n    zh: {\n      terminator: '……',\n      separator: undefined,\n    },\n    ja: {\n      terminator: '……',\n      separator: undefined,\n    },\n    [DEFAULT_TERMINATOR_KEY]: {\n      terminator: '…',\n      separator: undefined,\n    },\n  },\n  none: {\n    [DEFAULT_TERMINATOR_KEY]: {\n      terminator: undefined,\n      separator: undefined,\n    },\n  },\n};\n","import { createInvalidCutoffStyleError } from '../../../errors/formattingErrors';\nimport { libraryDefaultLocale } from '../../../settings/settings';\nimport {\n  DEFAULT_CUTOFF_FORMAT_STYLE,\n  DEFAULT_TERMINATOR_KEY,\n  TERMINATOR_MAP,\n} from './constants';\nimport {\n  CutoffFormat,\n  CutoffFormatOptions,\n  CutoffFormatStyle,\n  PostpendedCutoffParts,\n  PrependedCutoffParts,\n  ResolvedCutoffFormatOptions,\n  ResolvedTerminatorOptions,\n} from './types';\n\nexport class CutoffFormatConstructor implements CutoffFormat {\n  private locale: string;\n  private options: ResolvedCutoffFormatOptions;\n  private additionLength: number;\n  /**\n   * Constructor\n   * @param {string | string[]} locales - The locales to use for formatting.\n   * @param {CutoffFormatOptions} options - The options for formatting.\n   * @param {number} [option.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} [option.style='ellipsis'] - The style of the terminator.\n   * @param {string} [option.terminator] - Optional override the terminator to use.\n   * @param {string} [option.separator] - Optional override the separator to use between the terminator and the value.\n   * - If no terminator is provided, then separator is ignored.\n   *\n   * @example\n   * const format = new CutoffFormat('en', { maxChars: 5 });\n   * format.format('Hello, world!'); // 'Hello...'\n   *\n   * const format = new CutoffFormat('en', { maxChars: -3 });\n   * format.format('Hello, world!'); // '...ld!'\n   */\n  constructor(\n    locales: Intl.LocalesArgument,\n    options: CutoffFormatOptions = {}\n  ) {\n    // Determine locale (this replicates Intl.NumberFormat behavior including silent failure)\n    try {\n      // Normalize locales to string\n      const localesList = !locales\n        ? [libraryDefaultLocale]\n        : Array.isArray(locales)\n          ? locales.map((l) => String(l))\n          : [String(locales)];\n      const canonicalLocales = Intl.getCanonicalLocales(localesList);\n      this.locale = canonicalLocales.length\n        ? canonicalLocales[0]\n        : libraryDefaultLocale;\n    } catch {\n      this.locale = libraryDefaultLocale;\n    }\n\n    // Follows Intl.NumberFormat behavior of throwing an error when currency is invalid\n    if (!TERMINATOR_MAP[options.style ?? DEFAULT_CUTOFF_FORMAT_STYLE]) {\n      throw new Error(\n        createInvalidCutoffStyleError(\n          options.style ?? DEFAULT_CUTOFF_FORMAT_STYLE\n        )\n      );\n    }\n\n    // Resolve terminator options\n    let style: CutoffFormatStyle | undefined;\n    let presetTerminatorOptions: ResolvedTerminatorOptions | undefined;\n    if (options.maxChars !== undefined) {\n      style = options.style ?? DEFAULT_CUTOFF_FORMAT_STYLE;\n      // TODO: need more sophisticated locale negotiation if we want to add support for region/script/etc.-specific terminators in the future\n      const languageCode = new Intl.Locale(this.locale).language;\n      presetTerminatorOptions =\n        TERMINATOR_MAP[style][languageCode] ||\n        TERMINATOR_MAP[style][DEFAULT_TERMINATOR_KEY];\n    }\n    let terminator: ResolvedTerminatorOptions['terminator'] =\n      options.terminator ?? presetTerminatorOptions?.terminator;\n    let separator: ResolvedTerminatorOptions['separator'] =\n      terminator != null\n        ? (options.separator ?? presetTerminatorOptions?.separator)\n        : undefined;\n    // // Remove terminator and separator if maxChars does have enough space\n    this.additionLength = (terminator?.length ?? 0) + (separator?.length ?? 0);\n    if (\n      options.maxChars !== undefined &&\n      Math.abs(options.maxChars) < this.additionLength\n    ) {\n      terminator = undefined;\n      separator = undefined;\n    }\n\n    this.options = {\n      maxChars: options.maxChars,\n      style,\n      terminator,\n      separator,\n    };\n  }\n\n  /**\n   * Format a value according to the cutoff options, returning a formatted string.\n   *\n   * @param {string} value - The string value to format with cutoff behavior.\n   * @returns {string} The formatted string with terminator applied if cutoff occurs.\n   *\n   * @example\n   * const formatter = new CutoffFormatConstructor('en', { maxChars: 8, style: 'ellipsis' });\n   * formatter.format('Hello, world!'); // Returns 'Hello, w...'\n   */\n  format(value: string): string {\n    return this.formatToParts(value).join('');\n  }\n\n  /**\n   * Format a value to parts according to the cutoff options, returning an array of string parts.\n   * This method breaks down the formatted result into individual components for more granular control.\n   *\n   * @param {string} value - The string value to format with cutoff behavior.\n   * @returns {PrependedCutoffParts | PostpendedCutoffParts} An array of string parts representing the formatted result.\n   *   - For positive maxChars: [cutoffValue, separator?, terminator?]\n   *   - For negative maxChars: [terminator?, separator?, cutoffValue]\n   *   - For no cutoff: [originalValue]\n   *\n   * @example\n   * const formatter = new CutoffFormatConstructor('en', { maxChars: 5, style: 'ellipsis' });\n   * formatter.formatToParts('Hello, world!'); // Returns ['Hello', '...']\n   */\n  formatToParts(value: string): PrependedCutoffParts | PostpendedCutoffParts {\n    const { maxChars, terminator, separator } = this.options;\n\n    // Slice our value\n    // const additionLength = (terminator?.length ?? 0) + (separator?.length ?? 0);\n    const adjustedChars =\n      maxChars === undefined || Math.abs(maxChars) >= value.length\n        ? maxChars\n        : maxChars >= 0\n          ? Math.max(0, maxChars - this.additionLength)\n          : Math.min(0, maxChars + this.additionLength);\n    const slicedValue =\n      adjustedChars !== undefined && adjustedChars > -1\n        ? value.slice(0, adjustedChars)\n        : value.slice(adjustedChars);\n\n    // No cutoff, no terminator -> value only\n    if (\n      maxChars == null ||\n      adjustedChars == null ||\n      adjustedChars === 0 ||\n      terminator == null ||\n      value.length <= Math.abs(maxChars)\n    ) {\n      return [slicedValue];\n    }\n\n    // Postpended cutoff\n    if (adjustedChars > 0) {\n      return separator != null\n        ? [slicedValue, separator, terminator]\n        : [slicedValue, terminator];\n    }\n    // Prepended cutoff\n    else {\n      return separator != null\n        ? [terminator, separator, slicedValue]\n        : [terminator, slicedValue];\n    }\n  }\n\n  /**\n   * Get the resolved options\n   * @returns {ResolvedCutoffFormatOptions} The resolved options.\n   */\n  resolvedOptions(): ResolvedCutoffFormatOptions {\n    return this.options;\n  }\n}\n","import { libraryDefaultLocale } from '../settings/settings';\nimport { CutoffFormatConstructor } from '../formatting/custom-formats/CutoffFormat/CutoffFormat';\nimport {\n  ConstructorType,\n  CustomIntlConstructors,\n  CustomIntlType,\n  IntlCacheObject,\n} from './types';\n\n/**\n * Object mapping constructor names to their respective constructor functions\n * Includes all native Intl constructors plus custom ones like CutoffFormat\n */\nconst CustomIntl: CustomIntlType = {\n  Collator: Intl.Collator,\n  DateTimeFormat: Intl.DateTimeFormat,\n  DisplayNames: Intl.DisplayNames,\n  ListFormat: Intl.ListFormat,\n  Locale: Intl.Locale,\n  NumberFormat: Intl.NumberFormat,\n  PluralRules: Intl.PluralRules,\n  RelativeTimeFormat: Intl.RelativeTimeFormat,\n  Segmenter: Intl.Segmenter,\n  CutoffFormat: CutoffFormatConstructor,\n};\n\n/**\n * Cache for Intl and custom format instances to avoid repeated instantiation\n * Uses a two-level structure: constructor name -> cache key -> instance\n */\nclass IntlCache {\n  private cache: IntlCacheObject;\n\n  constructor() {\n    this.cache = {};\n  }\n\n  /**\n   * Generates a consistent cache key from locales and options\n   * Handles all LocalesArgument types (string, Locale, array, undefined)\n   */\n  private _generateKey(locales: Intl.LocalesArgument, options = {}) {\n    // Normalize locales to string representation\n    const localeKey = !locales\n      ? 'undefined'\n      : Array.isArray(locales)\n        ? locales.map((l) => String(l)).join(',')\n        : String(locales);\n\n    // Sort option keys to ensure consistent key generation regardless of property order\n    const sortedOptions = options\n      ? JSON.stringify(options, Object.keys(options).sort())\n      : '{}';\n    return `${localeKey}:${sortedOptions}`;\n  }\n\n  /**\n   * Gets a cached Intl instance or creates a new one if not found\n   * @param constructor The name of the Intl constructor to use\n   * @param args Constructor arguments (locales, options)\n   * @returns Cached or newly created Intl instance\n   */\n  get<K extends keyof CustomIntlConstructors>(\n    constructor: K,\n    ...args: ConstructorParameters<CustomIntlConstructors[K]>\n  ): InstanceType<ConstructorType<K>> {\n    const [locales = libraryDefaultLocale, options = {}] = args;\n    const key = this._generateKey(locales, options);\n    let intlObject = this.cache[constructor]?.[key];\n\n    if (intlObject === undefined) {\n      // Create new instance and cache it\n      intlObject = new CustomIntl[constructor](...args);\n      if (!this.cache[constructor]) this.cache[constructor] = {};\n      this.cache[constructor][key] = intlObject;\n    }\n\n    return intlObject;\n  }\n}\n\n/**\n * Global instance of the Intl cache for use throughout the application\n */\nexport const intlCache = new IntlCache();\n"],"mappings":"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"}

package/dist/base64-C1sogiix.mjs

@@ -0,0 +1,70 @@
+//#region src/settings/settingsUrls.ts
+const defaultCacheUrl = "https://cdn.gtx.dev";
+const defaultBaseUrl = "https://api2.gtx.dev";
+const defaultRuntimeApiUrl = "https://runtime2.gtx.dev";
+//#endregion
+//#region src/utils/isSupportedFileFormatTransform.ts
+const SUPPORTED_TRANSFORMATIONS = {
+	GTJSON: ["GTJSON"],
+	JSON: ["JSON"],
+	PO: ["PO"],
+	POT: ["POT", "PO"],
+	YAML: ["YAML"],
+	MDX: ["MDX"],
+	MD: ["MD"],
+	TS: ["TS"],
+	JS: ["JS"],
+	HTML: ["HTML"],
+	TXT: ["TXT"],
+	TWILIO_CONTENT_JSON: ["TWILIO_CONTENT_JSON"]
+};
+/**
+* This function checks if a file format transformation is supported during translation
+* @param from - The source file format
+* @param to - The target file format
+* @returns True if the transformation is supported, false otherwise
+*/
+function isSupportedFileFormatTransform(from, to) {
+	return SUPPORTED_TRANSFORMATIONS[from]?.includes(to) ?? false;
+}
+//#endregion
+//#region src/translate/utils/validateFileFormatTransform.ts
+/**
+* Returns a user-facing validation error when a requested file format transform
+* is missing source format context or is not currently supported.
+*/
+function getFileFormatTransformError(file) {
+	if (!file.transformFormat) return void 0;
+	const fileLabel = file.fileName ?? file.fileId ?? "unknown file";
+	if (!file.fileFormat) return `fileFormat is required when transformFormat is provided for ${fileLabel}`;
+	if (!isSupportedFileFormatTransform(file.fileFormat, file.transformFormat)) return `Unsupported file format transform: ${file.fileFormat} -> ${file.transformFormat}`;
+}
+/**
+* Validates file format transforms before sending upload/enqueue requests.
+*/
+function validateFileFormatTransforms(files) {
+	for (const file of files) {
+		const error = getFileFormatTransformError(file);
+		if (error) throw new Error(error);
+	}
+}
+//#endregion
+//#region src/utils/base64.ts
+function encode(data) {
+	if (typeof Buffer !== "undefined") return Buffer.from(data, "utf8").toString("base64");
+	const bytes = new TextEncoder().encode(data);
+	let binary = "";
+	for (let i = 0; i < bytes.length; i++) binary += String.fromCharCode(bytes[i]);
+	return btoa(binary);
+}
+function decode(base64) {
+	if (typeof Buffer !== "undefined") return Buffer.from(base64, "base64").toString("utf8");
+	const binary = atob(base64);
+	const bytes = new Uint8Array(binary.length);
+	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+	return new TextDecoder().decode(bytes);
+}
+//#endregion
+export { defaultBaseUrl as a, isSupportedFileFormatTransform as i, encode as n, defaultCacheUrl as o, validateFileFormatTransforms as r, defaultRuntimeApiUrl as s, decode as t };
+
+//# sourceMappingURL=base64-C1sogiix.mjs.map

package/dist/base64-C1sogiix.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64-C1sogiix.mjs","names":[],"sources":["../src/settings/settingsUrls.ts","../src/utils/isSupportedFileFormatTransform.ts","../src/translate/utils/validateFileFormatTransform.ts","../src/utils/base64.ts"],"sourcesContent":["export const defaultCacheUrl = 'https://cdn.gtx.dev' as const;\nexport const defaultBaseUrl = 'https://api2.gtx.dev' as const;\nexport const defaultRuntimeApiUrl = 'https://runtime2.gtx.dev' as const;\n","import type { FileFormat } from '../types-dir/api/file';\n\nconst SUPPORTED_TRANSFORMATIONS = {\n  GTJSON: ['GTJSON'],\n  JSON: ['JSON'],\n  PO: ['PO'],\n  // POT templates can produce translated PO catalog files.\n  POT: ['POT', 'PO'],\n  YAML: ['YAML'],\n  MDX: ['MDX'],\n  MD: ['MD'],\n  TS: ['TS'],\n  JS: ['JS'],\n  HTML: ['HTML'],\n  TXT: ['TXT'],\n  TWILIO_CONTENT_JSON: ['TWILIO_CONTENT_JSON'],\n} as const satisfies Record<FileFormat, FileFormat[]>;\n\n/**\n * This function checks if a file format transformation is supported during translation\n * @param from - The source file format\n * @param to - The target file format\n * @returns True if the transformation is supported, false otherwise\n */\nexport function isSupportedFileFormatTransform(\n  from: FileFormat,\n  to: FileFormat\n): boolean {\n  const toFormats: FileFormat[] | undefined = SUPPORTED_TRANSFORMATIONS[from];\n  return toFormats?.includes(to) ?? false;\n}\n","import type { FileFormat } from '../../types-dir/api/file';\nimport { isSupportedFileFormatTransform } from '../../utils/isSupportedFileFormatTransform';\n\nexport type FileFormatTransformInput = {\n  fileFormat?: FileFormat;\n  transformFormat?: FileFormat;\n  fileName?: string;\n  fileId?: string;\n};\n\n/**\n * Returns a user-facing validation error when a requested file format transform\n * is missing source format context or is not currently supported.\n */\nexport function getFileFormatTransformError(\n  file: FileFormatTransformInput\n): string | undefined {\n  if (!file.transformFormat) return undefined;\n  const fileLabel = file.fileName ?? file.fileId ?? 'unknown file';\n  if (!file.fileFormat) {\n    return `fileFormat is required when transformFormat is provided for ${fileLabel}`;\n  }\n  if (!isSupportedFileFormatTransform(file.fileFormat, file.transformFormat)) {\n    return `Unsupported file format transform: ${file.fileFormat} -> ${file.transformFormat}`;\n  }\n  return undefined;\n}\n\n/**\n * Validates file format transforms before sending upload/enqueue requests.\n */\nexport function validateFileFormatTransforms(\n  files: FileFormatTransformInput[]\n): void {\n  for (const file of files) {\n    const error = getFileFormatTransformError(file);\n    if (error) throw new Error(error);\n  }\n}\n","// Encode a string to base64\nexport function encode(data: string): string {\n  if (typeof Buffer !== 'undefined') {\n    // Node.js path\n    return Buffer.from(data, 'utf8').toString('base64');\n  }\n  // Browser path\n  const bytes = new TextEncoder().encode(data);\n  let binary = '';\n  for (let i = 0; i < bytes.length; i++) {\n    binary += String.fromCharCode(bytes[i]);\n  }\n  return btoa(binary);\n}\n\n// Decode a base64 string to a string\nexport function decode(base64: string): string {\n  if (typeof Buffer !== 'undefined') {\n    // Node.js path\n    return Buffer.from(base64, 'base64').toString('utf8');\n  }\n  // Browser path\n  const binary = atob(base64);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  return new TextDecoder().decode(bytes);\n}\n"],"mappings":";AAAA,MAAa,kBAAkB;AAC/B,MAAa,iBAAiB;AAC9B,MAAa,uBAAuB;;;ACApC,MAAM,4BAA4B;CAChC,QAAQ,CAAC,SAAS;CAClB,MAAM,CAAC,OAAO;CACd,IAAI,CAAC,KAAK;CAEV,KAAK,CAAC,OAAO,KAAK;CAClB,MAAM,CAAC,OAAO;CACd,KAAK,CAAC,MAAM;CACZ,IAAI,CAAC,KAAK;CACV,IAAI,CAAC,KAAK;CACV,IAAI,CAAC,KAAK;CACV,MAAM,CAAC,OAAO;CACd,KAAK,CAAC,MAAM;CACZ,qBAAqB,CAAC,sBAAsB;CAC7C;;;;;;;AAQD,SAAgB,+BACd,MACA,IACS;AAET,QAD4C,0BAA0B,OACpD,SAAS,GAAG,IAAI;;;;;;;;ACfpC,SAAgB,4BACd,MACoB;AACpB,KAAI,CAAC,KAAK,gBAAiB,QAAO,KAAA;CAClC,MAAM,YAAY,KAAK,YAAY,KAAK,UAAU;AAClD,KAAI,CAAC,KAAK,WACR,QAAO,+DAA+D;AAExE,KAAI,CAAC,+BAA+B,KAAK,YAAY,KAAK,gBAAgB,CACxE,QAAO,sCAAsC,KAAK,WAAW,MAAM,KAAK;;;;;AAQ5E,SAAgB,6BACd,OACM;AACN,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,QAAQ,4BAA4B,KAAK;AAC/C,MAAI,MAAO,OAAM,IAAI,MAAM,MAAM;;;;;ACnCrC,SAAgB,OAAO,MAAsB;AAC3C,KAAI,OAAO,WAAW,YAEpB,QAAO,OAAO,KAAK,MAAM,OAAO,CAAC,SAAS,SAAS;CAGrD,MAAM,QAAQ,IAAI,aAAa,CAAC,OAAO,KAAK;CAC5C,IAAI,SAAS;AACb,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,IAChC,WAAU,OAAO,aAAa,MAAM,GAAG;AAEzC,QAAO,KAAK,OAAO;;AAIrB,SAAgB,OAAO,QAAwB;AAC7C,KAAI,OAAO,WAAW,YAEpB,QAAO,OAAO,KAAK,QAAQ,SAAS,CAAC,SAAS,OAAO;CAGvD,MAAM,SAAS,KAAK,OAAO;CAC3B,MAAM,QAAQ,IAAI,WAAW,OAAO,OAAO;AAC3C,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,IACjC,OAAM,KAAK,OAAO,WAAW,EAAE;AAEjC,QAAO,IAAI,aAAa,CAAC,OAAO,MAAM"}