generaltranslation 2.0.67 → 2.0.68
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -369
- package/dist/codes/{determineLanguage.js → _determineLanguage.js} +5 -2
- package/dist/codes/_isSameLanguage.js +22 -0
- package/dist/codes/codes.d.ts +1 -8
- package/dist/codes/codes.js +61 -287
- package/dist/formatting/{_format.js → format.js} +40 -3
- package/dist/formatting/{_string_content.js → string_content.js} +21 -12
- package/dist/index.d.ts +55 -72
- package/dist/index.js +88 -66
- package/dist/settings/libraryDefaultLanguage.d.ts +2 -0
- package/dist/settings/libraryDefaultLanguage.js +4 -0
- package/dist/translation/dictionaries/_translateBundle.js +2 -2
- package/dist/translation/dictionaries/_updateProjectDictionary.js +4 -5
- package/dist/translation/react/_translateReact.js +2 -2
- package/dist/translation/strings/_translate.js +2 -2
- package/package.json +2 -2
- package/dist/codes/15924/CodeToScript.json +0 -215
- package/dist/codes/15924/ScriptToCode.json +0 -215
- package/dist/codes/3166/CodeToRegion.json +0 -296
- package/dist/codes/3166/RegionToCode.json +0 -296
- package/dist/codes/639-1/CodeToLanguage.json +0 -185
- package/dist/codes/639-1/LanguageToCode.json +0 -227
- package/dist/codes/639-3/CodeToLanguageTriletter.json +0 -186
- package/dist/codes/639-3/LanguageToCodeTriletter.json +0 -228
- package/dist/codes/getLanguageDirection.js +0 -71
- package/dist/codes/predefined/Predefined.json +0 -28
- /package/dist/codes/{determineLanguage.d.ts → _determineLanguage.d.ts} +0 -0
- /package/dist/codes/{getLanguageDirection.d.ts → _isSameLanguage.d.ts} +0 -0
- /package/dist/formatting/{_format.d.ts → format.d.ts} +0 -0
- /package/dist/formatting/{_string_content.d.ts → string_content.d.ts} +0 -0
package/dist/index.d.ts
CHANGED
@@ -1,4 +1,3 @@
|
|
1
|
-
import { LanguageObject } from './codes/codes';
|
2
1
|
import { Content, Update, Request, ReactChildrenAsObject, ReactTranslationResult, ContentTranslationResult } from './types/types';
|
3
2
|
/**
|
4
3
|
* Type representing the constructor parameters for the GT class.
|
@@ -76,69 +75,42 @@ declare class GT {
|
|
76
75
|
* @param {boolean} [replace=false] - Whether to replace the existing dictionary. Defaults to false.
|
77
76
|
* @returns {Promise<string[]>} A promise that resolves to an array of strings indicating the languages which have been updated.
|
78
77
|
*/
|
79
|
-
updateProjectDictionary(updates: Update[], languages?: string[],
|
78
|
+
updateProjectDictionary(updates: Update[], languages?: string[], replace?: boolean): Promise<string[]>;
|
80
79
|
}
|
81
80
|
export default GT;
|
82
81
|
/**
|
83
|
-
*
|
84
|
-
*
|
85
|
-
* @
|
82
|
+
* Get the text direction for a given language code using the Intl.Locale API.
|
83
|
+
*
|
84
|
+
* @param {string} code - The language code to check.
|
85
|
+
* @returns {string} - 'rtl' if the language is right-to-left, otherwise 'ltr'.
|
86
86
|
*/
|
87
|
-
export declare
|
87
|
+
export declare function getLanguageDirection(code: string): string;
|
88
|
+
/**
|
89
|
+
* Retrieves the display name(s) of language code(s) using Intl.DisplayNames.
|
90
|
+
*
|
91
|
+
* @param {string | string[]} code - A language code or an array of codes.
|
92
|
+
* @param {string} [language = 'en'] - The language for display names.
|
93
|
+
* @returns {string | string[]} The display name(s) corresponding to the code(s), or empty string(s) if invalid.
|
94
|
+
*/
|
95
|
+
export declare function getLanguageName(code: string | string[], language?: string): string | string[];
|
88
96
|
/**
|
89
97
|
* Checks if a given BCP 47 language code is valid.
|
90
98
|
* @param {string} code - The BCP 47 language code to validate.
|
91
99
|
* @returns {boolean} True if the BCP 47 code is valid, false otherwise.
|
92
100
|
*/
|
93
|
-
export declare
|
101
|
+
export declare function isValidLanguageCode(code: string): boolean;
|
94
102
|
/**
|
95
103
|
* Standardizes a BCP 47 language code to ensure correct formatting.
|
96
104
|
* @param {string} code - The BCP 47 language code to standardize.
|
97
105
|
* @returns {string} The standardized BCP 47 language code.
|
98
106
|
*/
|
99
|
-
export declare
|
100
|
-
/**
|
101
|
-
* Gets a language object from a BCP 47 language code.
|
102
|
-
* @param {string} code - The BCP 47 language code to convert.
|
103
|
-
* @returns {LanguageObject | null} The language object or null if the BCP 47 code is invalid.
|
104
|
-
*/
|
105
|
-
export declare function getLanguageObject(code: string): LanguageObject | null;
|
106
|
-
/**
|
107
|
-
* Gets language objects from multiple BCP 47 language codes.
|
108
|
-
* @param {string[]} codes - The BCP 47 language codes to convert.
|
109
|
-
* @returns {(LanguageObject | null)[]} An array of language objects or null for each invalid BCP 47 code.
|
110
|
-
*/
|
111
|
-
export declare function getLanguageObject(codes: string[]): (LanguageObject | null)[];
|
112
|
-
/**
|
113
|
-
* Gets a BCP 47 language code from a language name.
|
114
|
-
* @param {string} language - The language name to convert.
|
115
|
-
* @returns {string} The corresponding BCP 47 language code.
|
116
|
-
*/
|
117
|
-
export declare function getLanguageCode(language: string): string;
|
118
|
-
/**
|
119
|
-
* Gets BCP 47 language codes from multiple language names.
|
120
|
-
* @param {string[]} languages - The language names to convert.
|
121
|
-
* @returns {string[]} The corresponding BCP 47 language codes.
|
122
|
-
*/
|
123
|
-
export declare function getLanguageCode(languages: string[]): string[];
|
124
|
-
/**
|
125
|
-
* Gets a language name from a BCP 47 language code.
|
126
|
-
* @param {string} code - The BCP 47 language code to convert.
|
127
|
-
* @returns {string} The corresponding language name.
|
128
|
-
*/
|
129
|
-
export declare function getLanguageName(code: string): string;
|
130
|
-
/**
|
131
|
-
* Gets language names from multiple BCP 47 language codes.
|
132
|
-
* @param {string[]} codes - The BCP 47 language codes to convert.
|
133
|
-
* @returns {string[]} The corresponding language names.
|
134
|
-
*/
|
135
|
-
export declare function getLanguageName(codes: string[]): string[];
|
107
|
+
export declare function standardizeLanguageCode(code: string): string;
|
136
108
|
/**
|
137
109
|
* Checks if multiple BCP 47 language codes represent the same language.
|
138
110
|
* @param {string[]} codes - The BCP 47 language codes to compare.
|
139
111
|
* @returns {boolean} True if all BCP 47 codes represent the same language, false otherwise.
|
140
112
|
*/
|
141
|
-
export declare function isSameLanguage(...codes: string[]): boolean;
|
113
|
+
export declare function isSameLanguage(...codes: (string | string[])[]): boolean;
|
142
114
|
/**
|
143
115
|
* Formats a number according to the specified languages and options.
|
144
116
|
* @param {Object} params - The parameters for the number formatting.
|
@@ -147,7 +119,7 @@ export declare function isSameLanguage(...codes: string[]): boolean;
|
|
147
119
|
* @param {Intl.NumberFormatOptions} [params.options={}] - Additional options for number formatting.
|
148
120
|
* @returns {string} The formatted number.
|
149
121
|
*/
|
150
|
-
export declare function formatNum(
|
122
|
+
export declare function formatNum(params: {
|
151
123
|
value: number;
|
152
124
|
languages?: string | string[];
|
153
125
|
options?: Intl.NumberFormatOptions;
|
@@ -160,7 +132,7 @@ export declare function formatNum({ value, languages, options }: {
|
|
160
132
|
* @param {Intl.DateTimeFormatOptions} [params.options={}] - Additional options for date formatting.
|
161
133
|
* @returns {string} The formatted date.
|
162
134
|
*/
|
163
|
-
export declare function formatDateTime(
|
135
|
+
export declare function formatDateTime(params: {
|
164
136
|
value: Date;
|
165
137
|
languages?: string | string[];
|
166
138
|
options?: Intl.DateTimeFormatOptions;
|
@@ -174,48 +146,59 @@ export declare function formatDateTime({ value, languages, options }: {
|
|
174
146
|
* @param {Intl.NumberFormatOptions} [params.options={}] - Additional options for currency formatting.
|
175
147
|
* @returns {string} The formatted currency value.
|
176
148
|
*/
|
177
|
-
export declare function formatCurrency(
|
149
|
+
export declare function formatCurrency(params: {
|
178
150
|
value: number;
|
151
|
+
currency: string;
|
179
152
|
languages?: string | string[];
|
180
|
-
currency?: string;
|
181
153
|
options?: Intl.NumberFormatOptions;
|
182
154
|
}): string;
|
155
|
+
/**
|
156
|
+
* Formats a list of items according to the specified languages and options.
|
157
|
+
* @param {Object} params - The parameters for the list formatting.
|
158
|
+
* @param {Array<string | number>} params.value - The list of items to format.
|
159
|
+
* @param {string | string[]} [params.languages=['en']] - The languages to use for formatting.
|
160
|
+
* @param {Intl.ListFormatOptions} [params.options={}] - Additional options for list formatting.
|
161
|
+
* @returns {string} The formatted list.
|
162
|
+
*/
|
163
|
+
export declare function formatList(params: {
|
164
|
+
value: Array<string | number>;
|
165
|
+
languages?: string | string[];
|
166
|
+
options?: Intl.ListFormatOptions;
|
167
|
+
}): string;
|
168
|
+
/**
|
169
|
+
* Formats a relative time value according to the specified languages and options.
|
170
|
+
* @param {Object} params - The parameters for the relative time formatting.
|
171
|
+
* @param {number} params.value - The relative time value to format.
|
172
|
+
* @param {Intl.RelativeTimeFormatUnit} params.unit - The unit of time (e.g., 'second', 'minute', 'hour', 'day', 'week', 'month', 'year').
|
173
|
+
* @param {string | string[]} [params.languages=['en']] - The languages to use for formatting.
|
174
|
+
* @param {Intl.RelativeTimeFormatOptions} [params.options={}] - Additional options for relative time formatting.
|
175
|
+
* @returns {string} The formatted relative time string.
|
176
|
+
*/
|
177
|
+
export declare function formatRelativeTime(params: {
|
178
|
+
value: number;
|
179
|
+
unit: Intl.RelativeTimeFormatUnit;
|
180
|
+
languages?: string | string[];
|
181
|
+
options?: Intl.RelativeTimeFormatOptions;
|
182
|
+
}): string;
|
183
183
|
/**
|
184
184
|
* Splits a string into an array of text and variable objects.
|
185
|
-
*
|
186
185
|
* @param {string} string - The input string to split.
|
187
186
|
* @returns {Content} - An array containing strings and VariableObjects.
|
188
187
|
*/
|
189
188
|
export declare function splitStringToContent(string: string): Content;
|
190
189
|
/**
|
191
190
|
* Renders content to a string by replacing variables with their formatted values.
|
192
|
-
*
|
193
|
-
* @param {Content} content - The content to render, which can be a string or an array of strings and VariableObjects.
|
191
|
+
* @param {Content} content - The content to render.
|
194
192
|
* @param {string | string[]} [languages='en'] - The language(s) to use for formatting.
|
195
|
-
* @param {Record<string, any>} [variables={}] - An object containing variable values
|
196
|
-
* @param {Record<string, any>} [variableOptions={}] - An object containing options for formatting variables
|
193
|
+
* @param {Record<string, any>} [variables={}] - An object containing variable values.
|
194
|
+
* @param {Record<string, any>} [variableOptions={}] - An object containing options for formatting variables.
|
197
195
|
* @returns {string} - The rendered string with variables replaced by their formatted values.
|
198
|
-
|
199
|
-
|
200
|
-
export declare function renderContentToString<V extends Record<string, any>>(content: Content, languages?: string | string[], variables?: V, variableOptions?: {
|
201
|
-
[key in keyof V]?: Intl.NumberFormatOptions | Intl.DateTimeFormatOptions;
|
202
|
-
}): string;
|
196
|
+
*/
|
197
|
+
export declare function renderContentToString(content: Content, languages?: string | string[], variables?: Record<string, any>, variableOptions?: Record<string, any>): string;
|
203
198
|
/**
|
204
|
-
* Determines the best matching language from the approved languages list based on a provided
|
205
|
-
* list of preferred languages. The function prioritizes exact matches, but will also consider
|
206
|
-
* dialects of the same language if an exact match is not available.
|
207
|
-
*
|
208
|
-
* It also respects the order of preference in both the provided languages list and the
|
209
|
-
* approved languages list. A dialect match of a higher-preference language is considered better
|
210
|
-
* than an exact match of a lower-preference language.
|
211
|
-
*
|
212
|
-
* For example, if the `languages` list is ['en', 'fr'], and the `approvedLanguages` list is
|
213
|
-
* ['fr', 'en-GB'], it will prefer 'en-GB' over 'fr', even though 'fr' has an exact
|
214
|
-
* dialect match, because 'en' appears earlier in the `languages` list.
|
215
|
-
*
|
199
|
+
* Determines the best matching language from the approved languages list based on a provided list of preferred languages.
|
216
200
|
* @param {string | string[]} languages - A single language or an array of languages sorted in preference order.
|
217
201
|
* @param {string[]} approvedLanguages - An array of approved languages, also sorted by preference.
|
218
|
-
*
|
219
202
|
* @returns {string | undefined} - The best matching language from the approvedLanguages list, or undefined if no match is found.
|
220
203
|
*/
|
221
204
|
export declare function determineLanguage(languages: string | string[], approvedLanguages: string[]): string | undefined;
|
package/dist/index.js
CHANGED
@@ -22,8 +22,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
|
|
22
22
|
});
|
23
23
|
};
|
24
24
|
var __generator = (this && this.__generator) || function (thisArg, body) {
|
25
|
-
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
|
26
|
-
return g =
|
25
|
+
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
|
26
|
+
return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
|
27
27
|
function verb(n) { return function (v) { return step([n, v]); }; }
|
28
28
|
function step(op) {
|
29
29
|
if (f) throw new TypeError("Generator is already executing.");
|
@@ -52,27 +52,30 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
52
52
|
return (mod && mod.__esModule) ? mod : { "default": mod };
|
53
53
|
};
|
54
54
|
Object.defineProperty(exports, "__esModule", { value: true });
|
55
|
-
exports.
|
56
|
-
exports.getLanguageObject = getLanguageObject;
|
57
|
-
exports.getLanguageCode = getLanguageCode;
|
55
|
+
exports.getLanguageDirection = getLanguageDirection;
|
58
56
|
exports.getLanguageName = getLanguageName;
|
57
|
+
exports.isValidLanguageCode = isValidLanguageCode;
|
58
|
+
exports.standardizeLanguageCode = standardizeLanguageCode;
|
59
59
|
exports.isSameLanguage = isSameLanguage;
|
60
60
|
exports.formatNum = formatNum;
|
61
61
|
exports.formatDateTime = formatDateTime;
|
62
62
|
exports.formatCurrency = formatCurrency;
|
63
|
+
exports.formatList = formatList;
|
64
|
+
exports.formatRelativeTime = formatRelativeTime;
|
63
65
|
exports.splitStringToContent = splitStringToContent;
|
64
66
|
exports.renderContentToString = renderContentToString;
|
65
67
|
exports.determineLanguage = determineLanguage;
|
66
68
|
// ----- IMPORTS ----- //
|
67
|
-
var codes_1 = require("./codes/codes");
|
68
|
-
var getLanguageDirection_1 = __importDefault(require("./codes/getLanguageDirection"));
|
69
69
|
var _translateBundle_1 = __importDefault(require("./translation/dictionaries/_translateBundle"));
|
70
70
|
var _translate_1 = __importDefault(require("./translation/strings/_translate"));
|
71
71
|
var _translateReact_1 = __importDefault(require("./translation/react/_translateReact"));
|
72
72
|
var _updateProjectDictionary_1 = __importDefault(require("./translation/dictionaries/_updateProjectDictionary"));
|
73
|
-
var
|
74
|
-
var
|
75
|
-
var
|
73
|
+
var _determineLanguage_1 = __importDefault(require("./codes/_determineLanguage"));
|
74
|
+
var format_1 = require("./formatting/format");
|
75
|
+
var string_content_1 = require("./formatting/string_content");
|
76
|
+
var codes_1 = require("./codes/codes");
|
77
|
+
var _isSameLanguage_1 = __importDefault(require("./codes/_isSameLanguage"));
|
78
|
+
var libraryDefaultLanguage_1 = __importDefault(require("./settings/libraryDefaultLanguage"));
|
76
79
|
// ----- CORE CLASS ----- //
|
77
80
|
var getDefaultFromEnv = function (VARIABLE) {
|
78
81
|
if (typeof process !== 'undefined' && process.env) {
|
@@ -94,7 +97,7 @@ var GT = /** @class */ (function () {
|
|
94
97
|
* @param {string} [params.baseURL='https://prod.gtx.dev'] - The base URL for the translation service.
|
95
98
|
*/
|
96
99
|
function GT(_a) {
|
97
|
-
var _b = _a === void 0 ? {} : _a, _c = _b.apiKey, apiKey = _c === void 0 ? '' : _c, _d = _b.defaultLanguage, defaultLanguage = _d === void 0 ?
|
100
|
+
var _b = _a === void 0 ? {} : _a, _c = _b.apiKey, apiKey = _c === void 0 ? '' : _c, _d = _b.defaultLanguage, defaultLanguage = _d === void 0 ? libraryDefaultLanguage_1.default : _d, _e = _b.projectID, projectID = _e === void 0 ? '' : _e, _f = _b.baseURL, baseURL = _f === void 0 ? 'https://prod.gtx.dev' : _f;
|
98
101
|
this.apiKey = apiKey || getDefaultFromEnv('GT_API_KEY');
|
99
102
|
this.projectID = projectID || getDefaultFromEnv('GT_PROJECT_ID');
|
100
103
|
this.defaultLanguage = defaultLanguage.toLowerCase();
|
@@ -163,51 +166,57 @@ var GT = /** @class */ (function () {
|
|
163
166
|
* @returns {Promise<string[]>} A promise that resolves to an array of strings indicating the languages which have been updated.
|
164
167
|
*/
|
165
168
|
GT.prototype.updateProjectDictionary = function (updates_1) {
|
166
|
-
return __awaiter(this, arguments, void 0, function (updates, languages,
|
169
|
+
return __awaiter(this, arguments, void 0, function (updates, languages, replace) {
|
167
170
|
if (languages === void 0) { languages = []; }
|
168
|
-
if (projectID === void 0) { projectID = this.projectID; }
|
169
171
|
if (replace === void 0) { replace = false; }
|
170
172
|
return __generator(this, function (_a) {
|
171
|
-
return [2 /*return*/, (0, _updateProjectDictionary_1.default)(this, updates, languages,
|
173
|
+
return [2 /*return*/, (0, _updateProjectDictionary_1.default)(this, updates, languages, replace)];
|
172
174
|
});
|
173
175
|
});
|
174
176
|
};
|
175
177
|
return GT;
|
176
178
|
}());
|
177
179
|
// ----- EXPORTS ----- //
|
178
|
-
// Export the class
|
179
180
|
exports.default = GT;
|
180
|
-
// Export the functions
|
181
181
|
/**
|
182
|
-
*
|
183
|
-
*
|
184
|
-
* @
|
182
|
+
* Get the text direction for a given language code using the Intl.Locale API.
|
183
|
+
*
|
184
|
+
* @param {string} code - The language code to check.
|
185
|
+
* @returns {string} - 'rtl' if the language is right-to-left, otherwise 'ltr'.
|
185
186
|
*/
|
186
|
-
|
187
|
-
|
187
|
+
function getLanguageDirection(code) {
|
188
|
+
return (0, codes_1._getLanguageDirection)(code);
|
189
|
+
}
|
190
|
+
;
|
191
|
+
/**
|
192
|
+
* Retrieves the display name(s) of language code(s) using Intl.DisplayNames.
|
193
|
+
*
|
194
|
+
* @param {string | string[]} code - A language code or an array of codes.
|
195
|
+
* @param {string} [language = 'en'] - The language for display names.
|
196
|
+
* @returns {string | string[]} The display name(s) corresponding to the code(s), or empty string(s) if invalid.
|
197
|
+
*/
|
198
|
+
function getLanguageName(code, language) {
|
199
|
+
return (0, codes_1._getLanguageName)(code, language);
|
200
|
+
}
|
201
|
+
;
|
188
202
|
/**
|
189
203
|
* Checks if a given BCP 47 language code is valid.
|
190
204
|
* @param {string} code - The BCP 47 language code to validate.
|
191
205
|
* @returns {boolean} True if the BCP 47 code is valid, false otherwise.
|
192
206
|
*/
|
193
|
-
|
194
|
-
|
207
|
+
function isValidLanguageCode(code) {
|
208
|
+
return (0, codes_1._isValidLanguageCode)(code);
|
209
|
+
}
|
210
|
+
;
|
195
211
|
/**
|
196
212
|
* Standardizes a BCP 47 language code to ensure correct formatting.
|
197
213
|
* @param {string} code - The BCP 47 language code to standardize.
|
198
214
|
* @returns {string} The standardized BCP 47 language code.
|
199
215
|
*/
|
200
|
-
|
201
|
-
|
202
|
-
function getLanguageObject(codes) {
|
203
|
-
return Array.isArray(codes) ? (0, codes_1._getLanguageObject)(codes) : (0, codes_1._getLanguageObject)(codes);
|
204
|
-
}
|
205
|
-
function getLanguageCode(languages) {
|
206
|
-
return (0, codes_1._getLanguageCode)(languages);
|
207
|
-
}
|
208
|
-
function getLanguageName(codes) {
|
209
|
-
return (0, codes_1._getLanguageName)(codes);
|
216
|
+
function standardizeLanguageCode(code) {
|
217
|
+
return (0, codes_1._standardizeLanguageCode)(code);
|
210
218
|
}
|
219
|
+
;
|
211
220
|
/**
|
212
221
|
* Checks if multiple BCP 47 language codes represent the same language.
|
213
222
|
* @param {string[]} codes - The BCP 47 language codes to compare.
|
@@ -218,7 +227,7 @@ function isSameLanguage() {
|
|
218
227
|
for (var _i = 0; _i < arguments.length; _i++) {
|
219
228
|
codes[_i] = arguments[_i];
|
220
229
|
}
|
221
|
-
return
|
230
|
+
return _isSameLanguage_1.default.apply(void 0, codes);
|
222
231
|
}
|
223
232
|
;
|
224
233
|
/**
|
@@ -229,10 +238,10 @@ function isSameLanguage() {
|
|
229
238
|
* @param {Intl.NumberFormatOptions} [params.options={}] - Additional options for number formatting.
|
230
239
|
* @returns {string} The formatted number.
|
231
240
|
*/
|
232
|
-
function formatNum(
|
233
|
-
|
234
|
-
return (0, _format_1._formatNum)({ value: value, languages: languages, options: options });
|
241
|
+
function formatNum(params) {
|
242
|
+
return (0, format_1._formatNum)(params);
|
235
243
|
}
|
244
|
+
;
|
236
245
|
/**
|
237
246
|
* Formats a date according to the specified languages and options.
|
238
247
|
* @param {Object} params - The parameters for the date formatting.
|
@@ -241,10 +250,10 @@ function formatNum(_a) {
|
|
241
250
|
* @param {Intl.DateTimeFormatOptions} [params.options={}] - Additional options for date formatting.
|
242
251
|
* @returns {string} The formatted date.
|
243
252
|
*/
|
244
|
-
function formatDateTime(
|
245
|
-
|
246
|
-
return (0, _format_1._formatDateTime)({ value: value, languages: languages, options: options });
|
253
|
+
function formatDateTime(params) {
|
254
|
+
return (0, format_1._formatDateTime)(params);
|
247
255
|
}
|
256
|
+
;
|
248
257
|
/**
|
249
258
|
* Formats a currency value according to the specified languages, currency, and options.
|
250
259
|
* @param {Object} params - The parameters for the currency formatting.
|
@@ -254,50 +263,63 @@ function formatDateTime(_a) {
|
|
254
263
|
* @param {Intl.NumberFormatOptions} [params.options={}] - Additional options for currency formatting.
|
255
264
|
* @returns {string} The formatted currency value.
|
256
265
|
*/
|
257
|
-
function formatCurrency(
|
258
|
-
|
259
|
-
return (0, _format_1._formatCurrency)({ value: value, languages: languages, currency: currency, options: options });
|
266
|
+
function formatCurrency(params) {
|
267
|
+
return (0, format_1._formatCurrency)(params);
|
260
268
|
}
|
269
|
+
;
|
270
|
+
/**
|
271
|
+
* Formats a list of items according to the specified languages and options.
|
272
|
+
* @param {Object} params - The parameters for the list formatting.
|
273
|
+
* @param {Array<string | number>} params.value - The list of items to format.
|
274
|
+
* @param {string | string[]} [params.languages=['en']] - The languages to use for formatting.
|
275
|
+
* @param {Intl.ListFormatOptions} [params.options={}] - Additional options for list formatting.
|
276
|
+
* @returns {string} The formatted list.
|
277
|
+
*/
|
278
|
+
function formatList(params) {
|
279
|
+
return (0, format_1._formatList)(params);
|
280
|
+
}
|
281
|
+
;
|
282
|
+
/**
|
283
|
+
* Formats a relative time value according to the specified languages and options.
|
284
|
+
* @param {Object} params - The parameters for the relative time formatting.
|
285
|
+
* @param {number} params.value - The relative time value to format.
|
286
|
+
* @param {Intl.RelativeTimeFormatUnit} params.unit - The unit of time (e.g., 'second', 'minute', 'hour', 'day', 'week', 'month', 'year').
|
287
|
+
* @param {string | string[]} [params.languages=['en']] - The languages to use for formatting.
|
288
|
+
* @param {Intl.RelativeTimeFormatOptions} [params.options={}] - Additional options for relative time formatting.
|
289
|
+
* @returns {string} The formatted relative time string.
|
290
|
+
*/
|
291
|
+
function formatRelativeTime(params) {
|
292
|
+
return (0, format_1._formatRelativeTime)(params);
|
293
|
+
}
|
294
|
+
;
|
261
295
|
/**
|
262
296
|
* Splits a string into an array of text and variable objects.
|
263
|
-
*
|
264
297
|
* @param {string} string - The input string to split.
|
265
298
|
* @returns {Content} - An array containing strings and VariableObjects.
|
266
299
|
*/
|
267
300
|
function splitStringToContent(string) {
|
268
|
-
return (0,
|
301
|
+
return (0, string_content_1._splitStringToContent)(string);
|
269
302
|
}
|
303
|
+
;
|
270
304
|
/**
|
271
305
|
* Renders content to a string by replacing variables with their formatted values.
|
272
|
-
*
|
273
|
-
* @param {Content} content - The content to render, which can be a string or an array of strings and VariableObjects.
|
306
|
+
* @param {Content} content - The content to render.
|
274
307
|
* @param {string | string[]} [languages='en'] - The language(s) to use for formatting.
|
275
|
-
* @param {Record<string, any>} [variables={}] - An object containing variable values
|
276
|
-
* @param {Record<string, any>} [variableOptions={}] - An object containing options for formatting variables
|
308
|
+
* @param {Record<string, any>} [variables={}] - An object containing variable values.
|
309
|
+
* @param {Record<string, any>} [variableOptions={}] - An object containing options for formatting variables.
|
277
310
|
* @returns {string} - The rendered string with variables replaced by their formatted values.
|
278
|
-
|
279
|
-
*/
|
311
|
+
*/
|
280
312
|
function renderContentToString(content, languages, variables, variableOptions) {
|
281
|
-
return (0,
|
313
|
+
return (0, string_content_1._renderContentToString)(content, languages, variables, variableOptions);
|
282
314
|
}
|
315
|
+
;
|
283
316
|
/**
|
284
|
-
* Determines the best matching language from the approved languages list based on a provided
|
285
|
-
* list of preferred languages. The function prioritizes exact matches, but will also consider
|
286
|
-
* dialects of the same language if an exact match is not available.
|
287
|
-
*
|
288
|
-
* It also respects the order of preference in both the provided languages list and the
|
289
|
-
* approved languages list. A dialect match of a higher-preference language is considered better
|
290
|
-
* than an exact match of a lower-preference language.
|
291
|
-
*
|
292
|
-
* For example, if the `languages` list is ['en', 'fr'], and the `approvedLanguages` list is
|
293
|
-
* ['fr', 'en-GB'], it will prefer 'en-GB' over 'fr', even though 'fr' has an exact
|
294
|
-
* dialect match, because 'en' appears earlier in the `languages` list.
|
295
|
-
*
|
317
|
+
* Determines the best matching language from the approved languages list based on a provided list of preferred languages.
|
296
318
|
* @param {string | string[]} languages - A single language or an array of languages sorted in preference order.
|
297
319
|
* @param {string[]} approvedLanguages - An array of approved languages, also sorted by preference.
|
298
|
-
*
|
299
320
|
* @returns {string | undefined} - The best matching language from the approvedLanguages list, or undefined if no match is found.
|
300
321
|
*/
|
301
322
|
function determineLanguage(languages, approvedLanguages) {
|
302
|
-
return (0,
|
323
|
+
return (0, _determineLanguage_1.default)(languages, approvedLanguages);
|
303
324
|
}
|
325
|
+
;
|
@@ -9,8 +9,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
|
|
9
9
|
});
|
10
10
|
};
|
11
11
|
var __generator = (this && this.__generator) || function (thisArg, body) {
|
12
|
-
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
|
13
|
-
return g =
|
12
|
+
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
|
13
|
+
return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
|
14
14
|
function verb(n) { return function (v) { return step([n, v]); }; }
|
15
15
|
function step(op) {
|
16
16
|
if (f) throw new TypeError("Generator is already executing.");
|
@@ -9,8 +9,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
|
|
9
9
|
});
|
10
10
|
};
|
11
11
|
var __generator = (this && this.__generator) || function (thisArg, body) {
|
12
|
-
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
|
13
|
-
return g =
|
12
|
+
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
|
13
|
+
return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
|
14
14
|
function verb(n) { return function (v) { return step([n, v]); }; }
|
15
15
|
function step(op) {
|
16
16
|
if (f) throw new TypeError("Generator is already executing.");
|
@@ -40,7 +40,7 @@ exports.default = _updateProjectDictionary;
|
|
40
40
|
/**
|
41
41
|
* @internal
|
42
42
|
*/
|
43
|
-
function _updateProjectDictionary(gt, updates, languages,
|
43
|
+
function _updateProjectDictionary(gt, updates, languages, replace) {
|
44
44
|
return __awaiter(this, void 0, void 0, function () {
|
45
45
|
var response, _a, _b, _c, result;
|
46
46
|
return __generator(this, function (_d) {
|
@@ -54,7 +54,6 @@ function _updateProjectDictionary(gt, updates, languages, projectID, replace) {
|
|
54
54
|
body: JSON.stringify({
|
55
55
|
updates: updates,
|
56
56
|
languages: languages,
|
57
|
-
projectID: projectID,
|
58
57
|
replace: replace
|
59
58
|
})
|
60
59
|
})];
|
@@ -68,7 +67,7 @@ function _updateProjectDictionary(gt, updates, languages, projectID, replace) {
|
|
68
67
|
case 3: return [4 /*yield*/, response.json()];
|
69
68
|
case 4:
|
70
69
|
result = _d.sent();
|
71
|
-
return [2 /*return*/, result.languages];
|
70
|
+
return [2 /*return*/, result === null || result === void 0 ? void 0 : result.languages];
|
72
71
|
}
|
73
72
|
});
|
74
73
|
});
|
@@ -9,8 +9,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
|
|
9
9
|
});
|
10
10
|
};
|
11
11
|
var __generator = (this && this.__generator) || function (thisArg, body) {
|
12
|
-
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
|
13
|
-
return g =
|
12
|
+
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
|
13
|
+
return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
|
14
14
|
function verb(n) { return function (v) { return step([n, v]); }; }
|
15
15
|
function step(op) {
|
16
16
|
if (f) throw new TypeError("Generator is already executing.");
|
@@ -9,8 +9,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
|
|
9
9
|
});
|
10
10
|
};
|
11
11
|
var __generator = (this && this.__generator) || function (thisArg, body) {
|
12
|
-
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
|
13
|
-
return g =
|
12
|
+
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
|
13
|
+
return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
|
14
14
|
function verb(n) { return function (v) { return step([n, v]); }; }
|
15
15
|
function step(op) {
|
16
16
|
if (f) throw new TypeError("Generator is already executing.");
|
package/package.json
CHANGED
@@ -1,6 +1,6 @@
|
|
1
1
|
{
|
2
2
|
"name": "generaltranslation",
|
3
|
-
"version": "2.0.
|
3
|
+
"version": "2.0.68",
|
4
4
|
"description": "A language toolkit for AI developers",
|
5
5
|
"main": "dist/index.js",
|
6
6
|
"types": "dist/index.d.ts",
|
@@ -39,7 +39,7 @@
|
|
39
39
|
"homepage": "https://github.com/General-Translation/generaltranslation#readme",
|
40
40
|
"devDependencies": {
|
41
41
|
"@types/node": "^20.14.9",
|
42
|
-
"typescript": "^5.
|
42
|
+
"typescript": "^5.6.2"
|
43
43
|
},
|
44
44
|
"typescript": {
|
45
45
|
"definition": "dist/index.d.ts"
|