generaltranslation 8.2.11 → 8.2.13

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # generaltranslation
 
+## 8.2.13
+
+### Patch Changes
+
+- [#1379](https://github.com/generaltranslation/gt/pull/1379) [`e88fd39`](https://github.com/generaltranslation/gt/commit/e88fd399683868d5af1fe2b0ba2974fe5b17d7a7) Thanks [@bgub](https://github.com/bgub)! - Tighten public and API metadata types, and handle metadata entries without hashes in the CLI.
+
+- [#1387](https://github.com/generaltranslation/gt/pull/1387) [`95f852a`](https://github.com/generaltranslation/gt/commit/95f852ae086ac79d2c446f4d3072d8fd18688796) Thanks [@bgub](https://github.com/bgub)! - Reduce explicit any usage in core and Next.js types.
+
+## 8.2.12
+
+### Patch Changes
+
+- [#1364](https://github.com/generaltranslation/gt/pull/1364) [`9eae4d9`](https://github.com/generaltranslation/gt/commit/9eae4d93476688b621c739683c8bac64cbf50bf0) Thanks [@pie575](https://github.com/pie575)! - Update Derive docs comments
+
 ## 8.2.11
 
 ### Patch Changes
@@ -275,6 +289,7 @@
   https://generaltranslation.com/blog/generaltranslation_v8
 
   Please update the following packages to the latest version:
+
   - generaltranslation: `7.9.1` or later
   - gtx-cli: `2.4.15` or later
   - gt-sanity: `1.0.11` or later

package/dist/{IntlCache-k2qfrDqB.cjs → IntlCache-CAW8tKhd.cjs}

@@ -34,16 +34,16 @@ const TERMINATOR_MAP = {
 var CutoffFormatConstructor = class {
 	/**
 	* Constructor
-	* @param {string | string[]} locales - The locales to use for formatting.
+	* @param {Intl.LocalesArgument} 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.
+	* @param {number} [options.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.
+	* @param {CutoffFormatStyle} [options.style='ellipsis'] - The style of the terminator.
+	* @param {string} [options.terminator] - Optional override the terminator to use.
+	* @param {string} [options.separator] - Optional override the separator to use between the terminator and the value.
 	* - If no terminator is provided, then separator is ignored.
 	*
 	* @example
@@ -154,24 +154,24 @@ const CustomIntl = {
 };
 /**
 * Cache for Intl and custom format instances to avoid repeated instantiation
-* Uses a two-level structure: constructor name -> cache key -> instance
+* 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)
+	* 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
+	* @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;
@@ -209,4 +209,4 @@ Object.defineProperty(exports, "libraryDefaultLocale", {
 	}
 });
 
-//# sourceMappingURL=IntlCache-k2qfrDqB.cjs.map
+//# sourceMappingURL=IntlCache-CAW8tKhd.cjs.map

package/dist/IntlCache-CAW8tKhd.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntlCache-CAW8tKhd.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 {Intl.LocalesArgument} locales - The locales to use for formatting.\n   * @param {CutoffFormatOptions} options - The options for formatting.\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   *\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/{IntlCache-Ccg_cQPR.mjs → IntlCache-WZk0rKvj.mjs}

@@ -34,16 +34,16 @@ const TERMINATOR_MAP = {
 var CutoffFormatConstructor = class {
 	/**
 	* Constructor
-	* @param {string | string[]} locales - The locales to use for formatting.
+	* @param {Intl.LocalesArgument} 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.
+	* @param {number} [options.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.
+	* @param {CutoffFormatStyle} [options.style='ellipsis'] - The style of the terminator.
+	* @param {string} [options.terminator] - Optional override the terminator to use.
+	* @param {string} [options.separator] - Optional override the separator to use between the terminator and the value.
 	* - If no terminator is provided, then separator is ignored.
 	*
 	* @example
@@ -154,24 +154,24 @@ const CustomIntl = {
 };
 /**
 * Cache for Intl and custom format instances to avoid repeated instantiation
-* Uses a two-level structure: constructor name -> cache key -> instance
+* 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)
+	* 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
+	* @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;
@@ -192,4 +192,4 @@ const intlCache = new IntlCache();
 //#endregion
 export { defaultTimeout as n, libraryDefaultLocale as r, intlCache as t };
 
-//# sourceMappingURL=IntlCache-Ccg_cQPR.mjs.map
+//# sourceMappingURL=IntlCache-WZk0rKvj.mjs.map

package/dist/IntlCache-WZk0rKvj.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntlCache-WZk0rKvj.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 {Intl.LocalesArgument} locales - The locales to use for formatting.\n   * @param {CutoffFormatOptions} options - The options for formatting.\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   *\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/LocaleConfig.d.ts

@@ -0,0 +1,59 @@
+import { CustomMapping, FormatVariables } from './types';
+import { CutoffFormatOptions } from './formatting/custom-formats/CutoffFormat/types';
+import { StringFormat } from './types-dir/jsx/content';
+export type LocaleConfigConstructorParams = {
+    defaultLocale?: string;
+    locales?: string[];
+    customMapping?: CustomMapping;
+};
+type LocalesOption = {
+    locales?: string | string[];
+};
+type WithLocales<T = object> = T & LocalesOption;
+/**
+ * LocaleConfig contains the locale and formatting primitives exposed through
+ * the core entrypoint.
+ *
+ * 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.
+ */
+export 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): import("./types").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;
+}
+export {};

package/dist/LocaleConfig.js

@@ -0,0 +1,225 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { _formatCurrency, _formatCutoff, _formatDateTime, _formatList, _formatListToParts, _formatMessageICU, _formatMessageString, _formatNum, _formatRelativeTime, _formatRelativeTimeFromDate, } from './formatting/format';
+import _requiresTranslation from './locales/requiresTranslation';
+import _determineLocale from './locales/determineLocale';
+import _isSameLanguage from './locales/isSameLanguage';
+import _getLocaleProperties from './locales/getLocaleProperties';
+import _getLocaleEmoji from './locales/getLocaleEmoji';
+import { _isValidLocale, _standardizeLocale } from './locales/isValidLocale';
+import { _getLocaleName } from './locales/getLocaleName';
+import { _getLocaleDirection } from './locales/getLocaleDirection';
+import { libraryDefaultLocale } from './settings/settings';
+import _isSameDialect from './locales/isSameDialect';
+import _isSupersetLocale from './locales/isSupersetLocale';
+import { _resolveAliasLocale } from './locales/resolveAliasLocale';
+import { _resolveCanonicalLocale } from './locales/resolveCanonicalLocale';
+/**
+ * LocaleConfig contains the locale and formatting primitives exposed through
+ * the core entrypoint.
+ *
+ * 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 */ (function () {
+    function LocaleConfig(_a) {
+        var _b = _a === void 0 ? {} : _a, _c = _b.defaultLocale, defaultLocale = _c === void 0 ? libraryDefaultLocale : _c, _d = _b.locales, locales = _d === void 0 ? [] : _d, customMapping = _b.customMapping;
+        this.defaultLocale = defaultLocale;
+        this.locales = locales;
+        this.customMapping = customMapping;
+    }
+    Object.defineProperty(LocaleConfig.prototype, "translationLocales", {
+        get: function () {
+            return this.locales.length ? this.locales : undefined;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    LocaleConfig.prototype.resolveCanonicalLocaleList = function (locales) {
+        var _this = this;
+        return locales.map(function (locale) { return _this.resolveCanonicalLocale(locale); });
+    };
+    LocaleConfig.prototype.resolveCanonicalLocaleArgs = function (locales) {
+        var _this = this;
+        return locales.map(function (locale) {
+            return Array.isArray(locale)
+                ? _this.resolveCanonicalLocaleList(locale)
+                : _this.resolveCanonicalLocale(locale);
+        });
+    };
+    LocaleConfig.prototype.toLocaleList = function (locales) {
+        return Array.isArray(locales) ? locales : [locales];
+    };
+    LocaleConfig.prototype.getFormattingLocales = function (targetLocale, locales) {
+        var _this = this;
+        var localeList = locales !== undefined
+            ? this.toLocaleList(locales)
+            : [targetLocale, this.defaultLocale, libraryDefaultLocale];
+        return localeList
+            .filter(function (locale) { return !!locale; })
+            .map(function (locale) { return _this.resolveCanonicalLocale(locale); });
+    };
+    LocaleConfig.prototype.formatNum = function (value, targetLocale, options) {
+        if (options === void 0) { options = {}; }
+        var locales = options.locales, intlOptions = __rest(options, ["locales"]);
+        return _formatNum({
+            value: value,
+            locales: this.getFormattingLocales(targetLocale, locales),
+            options: intlOptions,
+        });
+    };
+    LocaleConfig.prototype.formatDateTime = function (value, targetLocale, options) {
+        if (options === void 0) { options = {}; }
+        var locales = options.locales, intlOptions = __rest(options, ["locales"]);
+        return _formatDateTime({
+            value: value,
+            locales: this.getFormattingLocales(targetLocale, locales),
+            options: intlOptions,
+        });
+    };
+    LocaleConfig.prototype.formatCurrency = function (value, currency, targetLocale, options) {
+        if (options === void 0) { options = {}; }
+        var locales = options.locales, intlOptions = __rest(options, ["locales"]);
+        return _formatCurrency({
+            value: value,
+            currency: currency,
+            locales: this.getFormattingLocales(targetLocale, locales),
+            options: intlOptions,
+        });
+    };
+    LocaleConfig.prototype.formatRelativeTime = function (value, unit, targetLocale, options) {
+        if (options === void 0) { options = {}; }
+        var locales = options.locales, intlOptions = __rest(options, ["locales"]);
+        return _formatRelativeTime({
+            value: value,
+            unit: unit,
+            locales: this.getFormattingLocales(targetLocale, locales),
+            options: intlOptions,
+        });
+    };
+    LocaleConfig.prototype.formatRelativeTimeFromDate = function (date, targetLocale, options) {
+        if (options === void 0) { options = {}; }
+        var locales = options.locales, baseDate = options.baseDate, intlOptions = __rest(options, ["locales", "baseDate"]);
+        return _formatRelativeTimeFromDate({
+            date: date,
+            baseDate: baseDate !== null && baseDate !== void 0 ? baseDate : new Date(),
+            locales: this.getFormattingLocales(targetLocale, locales),
+            options: intlOptions,
+        });
+    };
+    LocaleConfig.prototype.formatCutoff = function (value, targetLocale, options) {
+        if (options === void 0) { options = {}; }
+        var locales = options.locales, formatOptions = __rest(options, ["locales"]);
+        return _formatCutoff({
+            value: value,
+            locales: this.getFormattingLocales(targetLocale, locales),
+            options: formatOptions,
+        });
+    };
+    LocaleConfig.prototype.formatMessage = function (message, targetLocale, options) {
+        if (options === void 0) { options = {}; }
+        var locales = options.locales, variables = options.variables, dataFormat = options.dataFormat;
+        if (dataFormat === 'STRING')
+            return _formatMessageString(message);
+        return _formatMessageICU(message, this.getFormattingLocales(targetLocale, locales), variables);
+    };
+    LocaleConfig.prototype.formatList = function (array, targetLocale, options) {
+        if (options === void 0) { options = {}; }
+        var locales = options.locales, intlOptions = __rest(options, ["locales"]);
+        return _formatList({
+            value: array,
+            locales: this.getFormattingLocales(targetLocale, locales),
+            options: intlOptions,
+        });
+    };
+    LocaleConfig.prototype.formatListToParts = function (array, targetLocale, options) {
+        if (options === void 0) { options = {}; }
+        var locales = options.locales, intlOptions = __rest(options, ["locales"]);
+        return _formatListToParts({
+            value: array,
+            locales: this.getFormattingLocales(targetLocale, locales),
+            options: intlOptions,
+        });
+    };
+    LocaleConfig.prototype.getLocaleName = function (locale) {
+        return _getLocaleName(locale, this.defaultLocale, this.customMapping);
+    };
+    LocaleConfig.prototype.getLocaleEmoji = function (locale) {
+        return _getLocaleEmoji(locale, this.customMapping);
+    };
+    LocaleConfig.prototype.getLocaleProperties = function (locale) {
+        return _getLocaleProperties(locale, this.defaultLocale, this.customMapping);
+    };
+    LocaleConfig.prototype.requiresTranslation = function (targetLocale, sourceLocale, approvedLocales) {
+        if (sourceLocale === void 0) { sourceLocale = this.defaultLocale; }
+        if (approvedLocales === void 0) { approvedLocales = this.translationLocales; }
+        return _requiresTranslation(this.resolveCanonicalLocale(sourceLocale), this.resolveCanonicalLocale(targetLocale), approvedLocales
+            ? this.resolveCanonicalLocaleList(approvedLocales)
+            : undefined, this.customMapping);
+    };
+    LocaleConfig.prototype.determineLocale = function (locales, approvedLocales) {
+        var _this = this;
+        var _a;
+        if (approvedLocales === void 0) { approvedLocales = this.locales; }
+        var approvedLocalePairs = approvedLocales.map(function (locale) { return ({
+            locale: locale,
+            canonicalLocale: _this.resolveCanonicalLocale(locale),
+        }); });
+        var resolvedLocale = _determineLocale(Array.isArray(locales)
+            ? this.resolveCanonicalLocaleList(locales)
+            : this.resolveCanonicalLocale(locales), approvedLocalePairs.map(function (_a) {
+            var canonicalLocale = _a.canonicalLocale;
+            return canonicalLocale;
+        }), this.customMapping);
+        if (!resolvedLocale)
+            return undefined;
+        return (((_a = approvedLocalePairs.find(function (_a) {
+            var canonicalLocale = _a.canonicalLocale;
+            return canonicalLocale === resolvedLocale;
+        })) === null || _a === void 0 ? void 0 : _a.locale) || this.resolveAliasLocale(resolvedLocale));
+    };
+    LocaleConfig.prototype.getLocaleDirection = function (locale) {
+        return _getLocaleDirection(this.resolveCanonicalLocale(locale));
+    };
+    LocaleConfig.prototype.isValidLocale = function (locale) {
+        return _isValidLocale(locale, this.customMapping);
+    };
+    LocaleConfig.prototype.resolveCanonicalLocale = function (locale) {
+        return _resolveCanonicalLocale(locale, this.customMapping);
+    };
+    LocaleConfig.prototype.resolveAliasLocale = function (locale) {
+        return _resolveAliasLocale(locale, this.customMapping);
+    };
+    LocaleConfig.prototype.standardizeLocale = function (locale) {
+        return _standardizeLocale(locale);
+    };
+    LocaleConfig.prototype.isSameDialect = function () {
+        var locales = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            locales[_i] = arguments[_i];
+        }
+        return _isSameDialect.apply(void 0, this.resolveCanonicalLocaleArgs(locales));
+    };
+    LocaleConfig.prototype.isSameLanguage = function () {
+        var locales = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            locales[_i] = arguments[_i];
+        }
+        return _isSameLanguage.apply(void 0, this.resolveCanonicalLocaleArgs(locales));
+    };
+    LocaleConfig.prototype.isSupersetLocale = function (superLocale, subLocale) {
+        return _isSupersetLocale(this.resolveCanonicalLocale(superLocale), this.resolveCanonicalLocale(subLocale));
+    };
+    return LocaleConfig;
+}());
+export { LocaleConfig };

package/dist/backwards-compatability/dataConversion.d.ts

@@ -0,0 +1,23 @@
+import { Variable as VariableObject, VariableType } from '../types';
+import { OldBranchType, OldGTProp, OldJsxChild, OldJsxChildren, OldJsxElement, OldVariableObject, OldVariableType } from './oldTypes.js';
+import { GTProp, JsxChild, JsxChildren, JsxElement } from '../types';
+/**
+ * Convert request data from old format to new format
+ */
+export declare function getNewJsxChild(child: OldJsxChild): JsxChild;
+export declare function getNewJsxChildren(children: OldJsxChildren): JsxChildren;
+export declare function getNewJsxElement(element: OldJsxElement): JsxElement;
+export declare function getNewBranchType(branch: OldBranchType): 'b' | 'p';
+export declare function getNewVariableType(variable: OldVariableType): VariableType;
+export declare function getNewVariableObject(variable: OldVariableObject): VariableObject;
+export declare function getNewGTProp(dataGT: OldGTProp): GTProp;
+/**
+ * Convert response data from current format to old format
+ */
+export declare function getOldJsxChild(child: JsxChild): OldJsxChild;
+export declare function getOldJsxChildren(children: JsxChildren | OldJsxChildren): OldJsxChildren;
+export declare function getOldJsxElement(element: JsxElement): OldJsxElement;
+export declare function getOldBranchType(branch: 'b' | 'p'): OldBranchType;
+export declare function getOldVariableType(variable: VariableType): OldVariableType;
+export declare function getOldVariableObject(variable: VariableObject): OldVariableObject;
+export declare function getOldGTProp(dataGT: GTProp, i: number): OldGTProp;