@vixen-tech/lynguist 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { LynguistOptions, LynguistTerm, ReplacePlaceholders } from './types';
+export type { LynguistTranslations, LynguistTerm } from './types';
+export declare function Lynguist(options: LynguistOptions): void;
+export declare function __(key: LynguistTerm, replace?: ReplacePlaceholders): string;
+export declare function __(key: LynguistTerm, count: number, replace?: ReplacePlaceholders): string;
+export declare function trans(key: LynguistTerm, replace?: ReplacePlaceholders): string;
+export declare function transChoice(key: LynguistTerm, count: number, replace?: ReplacePlaceholders): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAG5E,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAOjE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAGvD;AAED,wBAAgB,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAAA;AAC5E,wBAAgB,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAAA;AAS3F,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAU9E;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAcnG"}

package/dist/index.js

@@ -0,0 +1,36 @@
+import { pluralIndex, replacePlaceholders } from './utils';
+let lynguist = {
+    locale: 'en',
+    translations: {},
+};
+export function Lynguist(options) {
+    lynguist.locale = options.locale;
+    lynguist.translations = options.translations;
+}
+export function __(key, countOrReplace, replace) {
+    if (typeof countOrReplace === 'number') {
+        return transChoice(key, countOrReplace, replace);
+    }
+    return trans(key, countOrReplace);
+}
+export function trans(key, replace) {
+    let translation = lynguist.translations[key];
+    if (!(key in lynguist.translations) || !translation)
+        return key;
+    if (replace) {
+        translation = replacePlaceholders(translation, replace);
+    }
+    return translation;
+}
+export function transChoice(key, count, replace) {
+    if (!(key in lynguist.translations) || !lynguist.translations[key])
+        return key;
+    const parts = lynguist.translations[key].split('|');
+    let index = pluralIndex(count, lynguist.locale);
+    let translation = parts[index];
+    translation = translation.replaceAll(/:count/g, count.toString());
+    if (replace) {
+        translation = replacePlaceholders(translation, replace);
+    }
+    return translation;
+}

package/dist/types.d.ts

@@ -0,0 +1,10 @@
+export interface LynguistTranslations extends Record<string, string | null> {
+}
+export interface LynguistOptions {
+    locale: LynguistLocale;
+    translations: LynguistTranslations;
+}
+export type LynguistTerm = keyof LynguistTranslations;
+export type ReplacePlaceholders = Record<string, number | string | null | undefined>;
+export type LynguistLocale = 'af' | 'am' | 'ar' | 'be' | 'bh' | 'bn' | 'bs' | 'bg' | 'ca' | 'cs' | 'cy' | 'da' | 'de' | 'el' | 'en' | 'eo' | 'es' | 'et' | 'eu' | 'fa' | 'fi' | 'fil' | 'fo' | 'fr' | 'fur' | 'fy' | 'ga' | 'gl' | 'gu' | 'gun' | 'ha' | 'he' | 'hi' | 'hr' | 'hu' | 'hy' | 'is' | 'it' | 'ku' | 'lb' | 'ln' | 'lt' | 'lv' | 'mg' | 'mk' | 'ml' | 'mn' | 'mr' | 'mt' | 'nah' | 'nb' | 'ne' | 'nl' | 'nn' | 'no' | 'nso' | 'om' | 'or' | 'pa' | 'pap' | 'pl' | 'ps' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'so' | 'sq' | 'sr' | 'sv' | 'sw' | 'ta' | 'te' | 'ti' | 'tk' | 'uk' | 'ur' | 'wa' | 'xbr' | 'zu';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAqB,SAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAAG;AAE9E,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,cAAc,CAAA;IACtB,YAAY,EAAE,oBAAoB,CAAA;CACrC;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,oBAAoB,CAAA;AAErD,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAEpF,MAAM,MAAM,cAAc,GACpB,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,CAAA"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/utils.d.ts

@@ -0,0 +1,4 @@
+import { LynguistLocale, ReplacePlaceholders } from './types';
+export declare function replacePlaceholders(text: string, replace: ReplacePlaceholders): string;
+export declare function pluralIndex(count: number, locale: LynguistLocale): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAE7D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAkBtF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CA4HzE"}

package/dist/utils.js

@@ -0,0 +1,127 @@
+export function replacePlaceholders(text, replace) {
+    let translation = text;
+    for (const [placeholder, value] of Object.entries(replace)) {
+        if (value !== null && value !== undefined) {
+            let parameterValue = String(value);
+            if (placeholder === placeholder.toUpperCase()) {
+                parameterValue = parameterValue.toUpperCase();
+            }
+            else if (placeholder[0] === placeholder[0].toUpperCase()) {
+                parameterValue = parameterValue.charAt(0).toUpperCase() + parameterValue.slice(1);
+            }
+            translation = translation.replace(`:${placeholder}`, parameterValue);
+        }
+    }
+    return translation;
+}
+export function pluralIndex(count, locale) {
+    switch (locale) {
+        case 'af':
+        case 'bn':
+        case 'bg':
+        case 'ca':
+        case 'da':
+        case 'de':
+        case 'el':
+        case 'en':
+        case 'eo':
+        case 'es':
+        case 'et':
+        case 'eu':
+        case 'fa':
+        case 'fi':
+        case 'fo':
+        case 'fur':
+        case 'fy':
+        case 'gl':
+        case 'gu':
+        case 'ha':
+        case 'he':
+        case 'hu':
+        case 'is':
+        case 'it':
+        case 'ku':
+        case 'lb':
+        case 'ml':
+        case 'mn':
+        case 'mr':
+        case 'nah':
+        case 'nb':
+        case 'ne':
+        case 'nl':
+        case 'nn':
+        case 'no':
+        case 'om':
+        case 'or':
+        case 'pa':
+        case 'pap':
+        case 'ps':
+        case 'pt':
+        case 'so':
+        case 'sq':
+        case 'sv':
+        case 'sw':
+        case 'ta':
+        case 'te':
+        case 'tk':
+        case 'ur':
+        case 'zu':
+            return count === 1 ? 0 : 1;
+        case 'am':
+        case 'bh':
+        case 'fil':
+        case 'fr':
+        case 'gun':
+        case 'hi':
+        case 'hy':
+        case 'ln':
+        case 'mg':
+        case 'nso':
+        case 'ti':
+        case 'wa':
+        case 'xbr':
+            return count === 0 || count === 1 ? 0 : 1;
+        case 'be':
+        case 'bs':
+        case 'hr':
+        case 'ru':
+        case 'sr':
+        case 'uk':
+            return count % 10 === 1 && count % 100 !== 11 ? 0 : count % 10 >= 2 && count % 10 <= 4 && (count % 100 < 10 || count % 100 >= 20) ? 1 : 2;
+        case 'cs':
+        case 'sk':
+            return count === 1 ? 0 : count >= 2 && count <= 4 ? 1 : 2;
+        case 'ga':
+            return count === 1 ? 0 : count === 2 ? 1 : 2;
+        case 'lt':
+            return count % 10 === 1 && count % 100 != 11 ? 0 : count % 10 >= 2 && (count % 100 < 10 || count % 100 >= 20) ? 1 : 2;
+        case 'sl':
+            return count % 100 === 1 ? 0 : count % 100 === 2 ? 1 : count % 100 === 3 || count % 100 === 4 ? 2 : 3;
+        case 'mk':
+            return count % 10 === 1 ? 0 : 1;
+        case 'mt':
+            return count === 1 ? 0 : count === 0 || (count % 100 > 1 && count % 100 < 11) ? 1 : count % 100 > 10 && count % 100 < 20 ? 2 : 3;
+        case 'lv':
+            return count === 0 ? 0 : count % 10 === 1 && count % 100 != 11 ? 1 : 2;
+        case 'pl':
+            return count === 1 ? 0 : count % 10 >= 2 && count % 10 <= 4 && (count % 100 < 12 || count % 100 > 14) ? 1 : 2;
+        case 'cy':
+            return count === 1 ? 0 : count === 2 ? 1 : count === 8 || count === 11 ? 2 : 3;
+        case 'ro':
+            return count === 1 ? 0 : count === 0 || (count % 100 > 0 && count % 100 < 20) ? 1 : 2;
+        case 'ar':
+            return count === 0
+                ? 0
+                : count === 1
+                    ? 1
+                    : count === 2
+                        ? 2
+                        : count % 100 >= 3 && count % 100 <= 10
+                            ? 3
+                            : count % 100 >= 11 && count % 100 <= 99
+                                ? 4
+                                : 5;
+        default:
+            return 0;
+    }
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+    "name": "@vixen-tech/lynguist",
+    "version": "0.0.1",
+    "description": "",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsc -p tsconfig.json && tsc-alias",
+        "clean": "rm -rf dist",
+        "prepublishOnly": "pnpm clean && pnpm build",
+        "test": "vitest run"
+    },
+    "keywords": [
+        "translations",
+        "localization",
+        "i18n"
+    ],
+    "author": "Alex Torscho <contact@alextorscho.com> (https://alextorscho.com)",
+    "license": "ISC",
+    "devDependencies": {
+        "@types/node": "^25.0.3",
+        "prettier": "^3.7.4",
+        "tsc-alias": "^1.8.16",
+        "typescript": "^5.9.3",
+        "vite": "^7.3.0",
+        "vitest": "^4.0.16"
+    },
+    "directories": {
+        "test": "tests"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/vixen-tech/lynguist-js.git"
+    },
+    "bugs": {
+        "url": "https://github.com/vixen-tech/lynguist-js/issues"
+    },
+    "homepage": "https://github.com/vixen-tech/lynguist-js#readme"
+}