generaltranslation 5.0.2 → 5.0.4

package/dist/internal.d.ts

@@ -4,8 +4,19 @@ declare const defaultRuntimeApiUrl: "https://runtime.gtx.dev";
 
 declare const libraryDefaultLocale: "en-US";
 declare const localeCookieName: "generaltranslation.locale";
-declare const pluralForms: readonly ["singular", "plural", "dual", "zero", "one", "two", "few", "many", "other"];
 declare const localeHeaderName = "x-generaltranslation-locale";
-declare function isAcceptedPluralForm(form: string): form is (typeof pluralForms)[number];
 
-export { defaultBaseUrl, defaultCacheUrl, defaultRuntimeApiUrl, isAcceptedPluralForm, libraryDefaultLocale, localeCookieName, localeHeaderName, pluralForms };
+declare const pluralForms: readonly ["singular", "plural", "dual", "zero", "one", "two", "few", "many", "other"];
+type PluralType = (typeof pluralForms)[number];
+declare function isAcceptedPluralForm(form: string): form is PluralType;
+
+/**
+ * Given a number and a list of allowed plural forms, return the plural form that best fits the number.
+ *
+ * @param {number} n - The number to determine the plural form for.
+ * @param {locales[]} forms - The allowed plural forms.
+ * @returns {PluralType} The determined plural form, or an empty string if none fit.
+ */
+declare function _getPluralForm(n: number, forms?: PluralType[], locales?: string[]): PluralType | "";
+
+export { defaultBaseUrl, defaultCacheUrl, defaultRuntimeApiUrl, _getPluralForm as getPluralForm, isAcceptedPluralForm, libraryDefaultLocale, localeCookieName, localeHeaderName, pluralForms };

package/dist/internal.esm.min.mjs

@@ -1,2 +1,2 @@
-var t="https://cdn.gtx.dev",e="https://api.gtx.dev",n="https://runtime.gtx.dev",a="en-US",l="generaltranslation.locale",r=["singular","plural","dual","zero","one","two","few","many","other"],o="x-generaltranslation-locale";function i(t){return r.includes(t)}export{e as defaultBaseUrl,t as defaultCacheUrl,n as defaultRuntimeApiUrl,i as isAcceptedPluralForm,a as libraryDefaultLocale,l as localeCookieName,o as localeHeaderName,r as pluralForms};
+var l="https://cdn.gtx.dev",e="https://api.gtx.dev",n="https://runtime.gtx.dev",r="en-US",u="generaltranslation.locale",t="x-generaltranslation-locale",a=["singular","plural","dual","zero","one","two","few","many","other"];function i(l){return a.includes(l)}function o(l,e,n){void 0===e&&(e=a),void 0===n&&(n=[r]);var u=new Intl.PluralRules(n).select(l),t=Math.abs(l);if(0===t&&e.includes("zero"))return"zero";if(1===t){if(e.includes("singular"))return"singular";if(e.includes("one"))return"one"}if("one"===u&&e.includes("singular"))return"singular";if(2===t){if(e.includes("dual"))return"dual";if(e.includes("two"))return"two"}return"two"===u&&e.includes("dual")?"dual":e.includes(u)?u:"two"===u&&e.includes("dual")?"dual":"two"===u&&e.includes("plural")?"plural":"two"===u&&e.includes("other")?"other":"few"===u&&e.includes("plural")?"plural":"few"===u&&e.includes("other")?"other":"many"===u&&e.includes("plural")?"plural":"many"===u&&e.includes("other")?"other":"other"===u&&e.includes("plural")?"plural":""}export{e as defaultBaseUrl,l as defaultCacheUrl,n as defaultRuntimeApiUrl,o as getPluralForm,i as isAcceptedPluralForm,r as libraryDefaultLocale,u as localeCookieName,t as localeHeaderName,a as pluralForms};
 //# sourceMappingURL=internal.esm.min.mjs.map

package/dist/internal.esm.min.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"internal.esm.min.mjs","sources":["../src/settings/settingsUrls.ts","../src/settings/settings.ts"],"sourcesContent":["export const defaultCacheUrl = \"https://cdn.gtx.dev\" as const;\nexport const defaultBaseUrl = \"https://api.gtx.dev\" as const;\nexport const defaultRuntimeApiUrl = \"https://runtime.gtx.dev\" as const;\nexport const translateBatchUrl = \"/v1/translate/batch\" as const;\nexport const translateJsxUrl = \"/v1/translate/react\" as const;\nexport const translateContentUrl = \"/v1/translate/content\" as const;\nexport const updateProjectTranslationsUrl = \"/v1/project/translations/update\" as const;\nexport const getProjectLocalesUrl = \"/v1/project/locales\" as const;","export const libraryDefaultLocale = \"en-US\" as const;\nexport const localeCookieName = \"generaltranslation.locale\" as const;\nexport const pluralForms = [\"singular\", \"plural\", \"dual\", \"zero\", \"one\", \"two\", \"few\", \"many\", \"other\"] as const;\nexport const localeHeaderName = \"x-generaltranslation-locale\";\nexport const maxTimeout = 60000;\nexport function isAcceptedPluralForm(\n    form: string\n  ): form is (typeof pluralForms)[number] {\n    return pluralForms.includes(form as (typeof pluralForms)[number]);\n}"],"names":["defaultCacheUrl","defaultBaseUrl","defaultRuntimeApiUrl","libraryDefaultLocale","localeCookieName","pluralForms","localeHeaderName","isAcceptedPluralForm","form","includes"],"mappings":"AAAO,IAAMA,EAAkB,sBAClBC,EAAiB,sBACjBC,EAAuB,0BCFvBC,EAAuB,QACvBC,EAAmB,4BACnBC,EAAc,CAAC,WAAY,SAAU,OAAQ,OAAQ,MAAO,MAAO,MAAO,OAAQ,SAClFC,EAAmB,8BAE1B,SAAUC,EACZC,GAEA,OAAOH,EAAYI,SAASD,EAChC"}
+{"version":3,"file":"internal.esm.min.mjs","sources":["../src/settings/settingsUrls.ts","../src/settings/settings.ts","../src/settings/plurals.ts","../src/locales/getPluralForm.ts"],"sourcesContent":["export const defaultCacheUrl = \"https://cdn.gtx.dev\" as const;\nexport const defaultBaseUrl = \"https://api.gtx.dev\" as const;\nexport const defaultRuntimeApiUrl = \"https://runtime.gtx.dev\" as const;\nexport const translateBatchUrl = \"/v1/translate/batch\" as const;\nexport const translateJsxUrl = \"/v1/translate/react\" as const;\nexport const translateContentUrl = \"/v1/translate/content\" as const;\nexport const updateProjectTranslationsUrl = \"/v1/project/translations/update\" as const;\nexport const getProjectLocalesUrl = \"/v1/project/locales\" as const;","export const libraryDefaultLocale = \"en-US\" as const;\nexport const localeCookieName = \"generaltranslation.locale\" as const;\nexport const localeHeaderName = \"x-generaltranslation-locale\";\nexport const maxTimeout = 60000;\n","export const pluralForms = [\"singular\", \"plural\", \"dual\", \"zero\", \"one\", \"two\", \"few\", \"many\", \"other\"] as const;\nexport type PluralType = (typeof pluralForms)[number];\nexport function isAcceptedPluralForm(\n    form: string\n  ): form is PluralType {\n    return pluralForms.includes(form as (typeof pluralForms)[number]);\n}","import { pluralForms, PluralType } from \"../settings/plurals\";\nimport { libraryDefaultLocale } from \"../settings/settings\";\n\n/**\n * Given a number and a list of allowed plural forms, return the plural form that best fits the number.\n * \n * @param {number} n - The number to determine the plural form for.\n * @param {locales[]} forms - The allowed plural forms.\n * @returns {PluralType} The determined plural form, or an empty string if none fit.\n */\nexport default function _getPluralForm(\n    n: number, \n    forms: PluralType[] = pluralForms as any, \n    locales: string[] = [libraryDefaultLocale] \n): PluralType | \"\" {\n    const pluralRules = new Intl.PluralRules(locales);\n    const provisionalBranchName = pluralRules.select(n);\n    // aliases\n    const absN = Math.abs(n);\n    // 0\n    if (absN === 0 && forms.includes(\"zero\")) return \"zero\"; // override\n    // 1\n    if (absN === 1) {\n        if (forms.includes(\"singular\")) return \"singular\"; // override\n        if (forms.includes(\"one\")) return \"one\"; // override\n    }\n    if (provisionalBranchName === \"one\" && forms.includes(\"singular\")) return \"singular\";\n    // 2\n    if (absN === 2) {\n        if (forms.includes(\"dual\")) return \"dual\"; // override\n        if (forms.includes(\"two\")) return \"two\"; // override\n    }\n    if (provisionalBranchName === \"two\" && forms.includes(\"dual\")) return \"dual\";\n    // fallbacks\n    if (forms.includes(provisionalBranchName)) return provisionalBranchName;\n    // two\n    if (provisionalBranchName === \"two\" && forms.includes(\"dual\")) return \"dual\";\n    if (provisionalBranchName === \"two\" && forms.includes(\"plural\")) return \"plural\";\n    if (provisionalBranchName === \"two\" && forms.includes(\"other\")) return \"other\";\n    // few\n    if (provisionalBranchName === \"few\" && forms.includes(\"plural\")) return \"plural\";\n    if (provisionalBranchName === \"few\" && forms.includes(\"other\")) return \"other\";\n    // many\n    if (provisionalBranchName === \"many\" && forms.includes(\"plural\")) return \"plural\";\n    if (provisionalBranchName === \"many\" && forms.includes(\"other\")) return \"other\";\n    // other\n    if (provisionalBranchName === \"other\" && forms.includes(\"plural\")) return \"plural\";\n    return \"\";\n}"],"names":["defaultCacheUrl","defaultBaseUrl","defaultRuntimeApiUrl","libraryDefaultLocale","localeCookieName","localeHeaderName","pluralForms","isAcceptedPluralForm","form","includes","_getPluralForm","n","forms","locales","provisionalBranchName","Intl","PluralRules","select","absN","Math","abs"],"mappings":"AAAO,IAAMA,EAAkB,sBAClBC,EAAiB,sBACjBC,EAAuB,0BCFvBC,EAAuB,QACvBC,EAAmB,4BACnBC,EAAmB,8BCFnBC,EAAc,CAAC,WAAY,SAAU,OAAQ,OAAQ,MAAO,MAAO,MAAO,OAAQ,SAEzF,SAAUC,EACZC,GAEA,OAAOF,EAAYG,SAASD,EAChC,CCIwB,SAAAE,EACpBC,EACAC,EACAC,QADA,IAAAD,IAAAA,EAAsBN,QACtB,IAAAO,IAAAA,EAAqB,CAAAV,IAErB,IACMW,EADc,IAAIC,KAAKC,YAAYH,GACCI,OAAON,GAE3CO,EAAOC,KAAKC,IAAIT,GAEtB,GAAa,IAATO,GAAcN,EAAMH,SAAS,QAAS,MAAO,OAEjD,GAAa,IAATS,EAAY,CACZ,GAAIN,EAAMH,SAAS,YAAa,MAAO,WACvC,GAAIG,EAAMH,SAAS,OAAQ,MAAO,KACrC,CACD,GAA8B,QAA1BK,GAAmCF,EAAMH,SAAS,YAAa,MAAO,WAE1E,GAAa,IAATS,EAAY,CACZ,GAAIN,EAAMH,SAAS,QAAS,MAAO,OACnC,GAAIG,EAAMH,SAAS,OAAQ,MAAO,KACrC,CACD,MAA8B,QAA1BK,GAAmCF,EAAMH,SAAS,QAAgB,OAElEG,EAAMH,SAASK,GAA+BA,EAEpB,QAA1BA,GAAmCF,EAAMH,SAAS,QAAgB,OACxC,QAA1BK,GAAmCF,EAAMH,SAAS,UAAkB,SAC1C,QAA1BK,GAAmCF,EAAMH,SAAS,SAAiB,QAEzC,QAA1BK,GAAmCF,EAAMH,SAAS,UAAkB,SAC1C,QAA1BK,GAAmCF,EAAMH,SAAS,SAAiB,QAEzC,SAA1BK,GAAoCF,EAAMH,SAAS,UAAkB,SAC3C,SAA1BK,GAAoCF,EAAMH,SAAS,SAAiB,QAE1C,UAA1BK,GAAqCF,EAAMH,SAAS,UAAkB,SACnE,EACX"}

package/dist/locales/getPluralForm.d.ts

@@ -0,0 +1,9 @@
+import { PluralType } from "../settings/plurals";
+/**
+ * Given a number and a list of allowed plural forms, return the plural form that best fits the number.
+ *
+ * @param {number} n - The number to determine the plural form for.
+ * @param {locales[]} forms - The allowed plural forms.
+ * @returns {PluralType} The determined plural form, or an empty string if none fit.
+ */
+export default function _getPluralForm(n: number, forms?: PluralType[], locales?: string[]): PluralType | "";

package/dist/settings/plurals.d.ts

@@ -0,0 +1,3 @@
+export declare const pluralForms: readonly ["singular", "plural", "dual", "zero", "one", "two", "few", "many", "other"];
+export type PluralType = (typeof pluralForms)[number];
+export declare function isAcceptedPluralForm(form: string): form is PluralType;

package/dist/settings/settings.d.ts

@@ -1,6 +1,4 @@
 export declare const libraryDefaultLocale: "en-US";
 export declare const localeCookieName: "generaltranslation.locale";
-export declare const pluralForms: readonly ["singular", "plural", "dual", "zero", "one", "two", "few", "many", "other"];
 export declare const localeHeaderName = "x-generaltranslation-locale";
 export declare const maxTimeout = 60000;
-export declare function isAcceptedPluralForm(form: string): form is (typeof pluralForms)[number];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generaltranslation",
-  "version": "5.0.2",
+  "version": "5.0.4",
   "description": "A language toolkit for AI developers",
   "main": "dist/index.cjs.min.cjs",
   "module": "dist/index.esm.min.mjs",