generaltranslation 8.2.13 → 8.2.14

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # generaltranslation
 
+## 8.2.14
+
+### Patch Changes
+
+- [#1397](https://github.com/generaltranslation/gt/pull/1397) [`73f3ac1`](https://github.com/generaltranslation/gt/commit/73f3ac1308df11c1e6230c13c1999bfc5f6afc99) Thanks [@bgub](https://github.com/bgub)! - Extract locale and formatting primitives into the new `@generaltranslation/format` package and update `generaltranslation/core` to re-export the shared helpers.
+
+- [#1408](https://github.com/generaltranslation/gt/pull/1408) [`425d3e4`](https://github.com/generaltranslation/gt/commit/425d3e4e6c61afd108c65c27f7693ba2470b33c6) Thanks [@bgub](https://github.com/bgub)! - Use @generaltranslation/format directly for shared formatting and locale helpers.
+
+- Updated dependencies [[`73f3ac1`](https://github.com/generaltranslation/gt/commit/73f3ac1308df11c1e6230c13c1999bfc5f6afc99)]:
+  - @generaltranslation/format@0.1.0
+
 ## 8.2.13
 
 ### Patch Changes

package/dist/{ApiError-IYfaOR30.mjs → ApiError-0DxxIHLp.mjs}

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

package/dist/{ApiError-CZ45tkW6.cjs.map → ApiError-0DxxIHLp.mjs.map}

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"ApiError-0DxxIHLp.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/{ApiError-CZ45tkW6.cjs → ApiError-D-IBuHj6.cjs}

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

package/dist/{ApiError-IYfaOR30.mjs.map → ApiError-D-IBuHj6.cjs.map}

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"ApiError-D-IBuHj6.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/LocaleConfig.d.ts

@@ -1,59 +1 @@
-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 {};
+export { LocaleConfig, type LocaleConfigConstructorParams, } from '@generaltranslation/format';

package/dist/LocaleConfig.js

@@ -1,225 +1 @@
-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 };
+export { LocaleConfig, } from '@generaltranslation/format';

package/dist/{base64-2fu94Klt.cjs → base64-C6BHySOc.cjs}

@@ -1,3 +1,7 @@
+//#region src/settings/settings.ts
+const libraryDefaultLocale = "en";
+const defaultTimeout = 6e4;
+//#endregion
 //#region src/settings/settingsUrls.ts
 const defaultCacheUrl = "https://cdn.gtx.dev";
 const defaultBaseUrl = "https://api2.gtx.dev";
@@ -89,6 +93,12 @@ Object.defineProperty(exports, "defaultRuntimeApiUrl", {
 		return defaultRuntimeApiUrl;
 	}
 });
+Object.defineProperty(exports, "defaultTimeout", {
+	enumerable: true,
+	get: function() {
+		return defaultTimeout;
+	}
+});
 Object.defineProperty(exports, "encode", {
 	enumerable: true,
 	get: function() {
@@ -101,6 +111,12 @@ Object.defineProperty(exports, "isSupportedFileFormatTransform", {
 		return isSupportedFileFormatTransform;
 	}
 });
+Object.defineProperty(exports, "libraryDefaultLocale", {
+	enumerable: true,
+	get: function() {
+		return libraryDefaultLocale;
+	}
+});
 Object.defineProperty(exports, "validateFileFormatTransforms", {
 	enumerable: true,
 	get: function() {
@@ -108,4 +124,4 @@ Object.defineProperty(exports, "validateFileFormatTransforms", {
 	}
 });
 
-//# sourceMappingURL=base64-2fu94Klt.cjs.map
+//# sourceMappingURL=base64-C6BHySOc.cjs.map

package/dist/base64-C6BHySOc.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64-C6BHySOc.cjs","names":[],"sources":["../src/settings/settings.ts","../src/settings/settingsUrls.ts","../src/utils/isSupportedFileFormatTransform.ts","../src/translate/utils/validateFileFormatTransform.ts","../src/utils/base64.ts"],"sourcesContent":["export const libraryDefaultLocale = 'en' as const;\nexport const defaultTimeout = 60000;\n","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,uBAAuB;AACpC,MAAa,iBAAiB;;;ACD9B,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"}

package/dist/{base64-DH0STixb.mjs → base64-CWITCfhU.mjs}

@@ -1,3 +1,7 @@
+//#region src/settings/settings.ts
+const libraryDefaultLocale = "en";
+const defaultTimeout = 6e4;
+//#endregion
 //#region src/settings/settingsUrls.ts
 const defaultCacheUrl = "https://cdn.gtx.dev";
 const defaultBaseUrl = "https://api2.gtx.dev";
@@ -65,6 +69,6 @@ function decode(base64) {
 	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 };
+export { defaultBaseUrl as a, defaultTimeout as c, isSupportedFileFormatTransform as i, libraryDefaultLocale as l, encode as n, defaultCacheUrl as o, validateFileFormatTransforms as r, defaultRuntimeApiUrl as s, decode as t };
 
-//# sourceMappingURL=base64-DH0STixb.mjs.map
+//# sourceMappingURL=base64-CWITCfhU.mjs.map

package/dist/base64-CWITCfhU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64-CWITCfhU.mjs","names":[],"sources":["../src/settings/settings.ts","../src/settings/settingsUrls.ts","../src/utils/isSupportedFileFormatTransform.ts","../src/translate/utils/validateFileFormatTransform.ts","../src/utils/base64.ts"],"sourcesContent":["export const libraryDefaultLocale = 'en' as const;\nexport const defaultTimeout = 60000;\n","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,uBAAuB;AACpC,MAAa,iBAAiB;;;ACD9B,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"}

package/dist/core.cjs

@@ -1,8 +1,9 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_core = require("./core-7RP541eY.cjs");
-exports.LocaleConfig = require_core.LocaleConfig;
-exports.formatCutoff = require_core.formatCutoff;
-exports.formatMessage = require_core.formatMessage;
-exports.isValidLocale = require_core.isValidLocale;
-exports.resolveCanonicalLocale = require_core.resolveCanonicalLocale;
-exports.standardizeLocale = require_core.standardizeLocale;
+var _generaltranslation_format = require("@generaltranslation/format");
+Object.keys(_generaltranslation_format).forEach(function(k) {
+	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function() {
+			return _generaltranslation_format[k];
+		}
+	});
+});

package/dist/core.d.cts

@@ -1,2 +1 @@
-import { a as standardizeLocale, i as resolveCanonicalLocale, n as formatMessage, o as LocaleConfig, r as isValidLocale, s as LocaleConfigConstructorParams, t as formatCutoff } from "./core-TLJoDpJP.cjs";
-export { LocaleConfig, LocaleConfigConstructorParams, formatCutoff, formatMessage, isValidLocale, resolveCanonicalLocale, standardizeLocale };
+export * from "@generaltranslation/format";

package/dist/core.d.mts

@@ -1,2 +1 @@
-import { a as standardizeLocale, i as resolveCanonicalLocale, n as formatMessage, o as LocaleConfig, r as isValidLocale, s as LocaleConfigConstructorParams, t as formatCutoff } from "./core-I9pWGafA.mjs";
-export { LocaleConfig, LocaleConfigConstructorParams, formatCutoff, formatMessage, isValidLocale, resolveCanonicalLocale, standardizeLocale };
+export * from "@generaltranslation/format";

package/dist/core.d.ts

@@ -1,128 +1 @@
-import type { CutoffFormatOptions } from './formatting/custom-formats/CutoffFormat/types';
-import type { CustomMapping, FormatVariables } from './types';
-import type { StringFormat } from './types-dir/jsx/content';
-export { LocaleConfig, type LocaleConfigConstructorParams, } from './LocaleConfig';
-/**
- * Core formatting and locale helpers.
- *
- * This entry point exposes deterministic locale and formatting primitives. It
- * does not export the GT service client, project credentials, network
- * translation methods, file APIs, or other server/service concerns from the
- * root `generaltranslation` facade.
- *
- * This entry point is intended for framework and shared packages that need
- * locale metadata or formatting behavior without pulling in the full
- * translation API surface.
- */
-/**
- * Formats a string with cutoff behavior, applying a terminator when the string exceeds the maximum character limit.
- *
- * This standalone function provides cutoff formatting functionality without requiring a GT instance.
- * The locales parameter is required for proper terminator selection based on the target language.
- *
- * @param {string} value - The string value to format with cutoff behavior.
- * @param {Object} [options] - Configuration options for cutoff formatting.
- * @param {string | string[]} [options.locales] - The locales to use for terminator selection.
- * @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} [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.
- * @returns {string} The formatted string with terminator applied if cutoff occurs.
- *
- * @example
- * formatCutoff('Hello, world!', { locales: 'en-US', maxChars: 8 });
- * // Returns: 'Hello, …'
- *
- * @example
- * formatCutoff('Hello, world!', { locales: 'en-US', maxChars: -3 });
- * // Returns: '…d!'
- *
- * @example
- * formatCutoff('Very long text that needs cutting', {
- *   locales: 'en-US',
- *   maxChars: 15,
- *   style: 'ellipsis',
- *   separator: ' '
- * });
- * // Returns: 'Very long tex …'
- */
-export declare function formatCutoff(value: string, options?: {
-    locales?: string | string[];
-} & CutoffFormatOptions): string;
-/**
- * Formats a message according to the specified locales and options.
- *
- * @param {string} message - The message to format.
- * @param {Object} [options] - Configuration options for message formatting.
- * @param {string | string[]} [options.locales] - The locales to use for formatting.
- * @param {FormatVariables} [options.variables] - The variables to use for formatting.
- * @param {StringFormat} [options.dataFormat='ICU'] - The format of the message. When STRING, the message is returned as is.
- * @returns {string} The formatted message.
- *
- * @example
- * formatMessage('Hello {name}', { variables: { name: 'John' } });
- * // Returns: "Hello John"
- *
- * @example
- * formatMessage('Hello {name}', {
- *   locales: ['fr'],
- *   variables: { name: 'John' }
- * });
- */
-export declare function formatMessage(message: string, options?: {
-    locales?: string | string[];
-    variables?: FormatVariables;
-    dataFormat?: StringFormat;
-}): string;
-/**
- * Checks if a given BCP 47 locale code is valid.
- *
- * @param {string} locale - The BCP 47 locale code to validate.
- * @param {CustomMapping} [customMapping] - The custom mapping to use for validation.
- * @returns {boolean} True if the BCP 47 code is valid, false otherwise.
- *
- * @example
- * isValidLocale('en-US');
- * // Returns: true
- *
- * @example
- * isValidLocale('en_US');
- * // Returns: false
- */
-export declare function isValidLocale(locale: string, customMapping?: CustomMapping): boolean;
-/**
- * Resolves the canonical locale for a given locale.
- *
- * @param {string} locale - The locale to resolve the canonical locale for.
- * @param {CustomMapping} [customMapping] - The custom mapping to use for resolving the canonical locale.
- * @returns {string} The canonical locale, or the input locale when no canonical mapping exists.
- *
- * @example
- * resolveCanonicalLocale('en-US');
- * // Returns: 'en-US'
- *
- * @example
- * resolveCanonicalLocale('en', { en: 'en-US' });
- * // Returns: 'en-US'
- */
-export declare function resolveCanonicalLocale(locale: string, customMapping?: CustomMapping): string;
-/**
- * Standardizes a BCP 47 locale code to ensure correct formatting.
- *
- * @param {string} locale - The BCP 47 locale code to standardize.
- * @returns {string} The standardized BCP 47 locale code, or the input string if it cannot be standardized.
- *
- * @example
- * standardizeLocale('en-us');
- * // Returns: 'en-US'
- *
- * @example
- * standardizeLocale('not a locale');
- * // Returns: 'not a locale'
- */
-export declare function standardizeLocale(locale: string): string;
+export * from '@generaltranslation/format';