@payloadcms/translations 3.0.0-alpha.0

package/dist/utilities/ensureDirExists.js

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDirectoryExists = void 0;
+const fs_1 = __importDefault(require("fs"));
+function ensureDirectoryExists(directory) {
+    try {
+        if (!fs_1.default.existsSync(directory)) {
+            fs_1.default.mkdirSync(directory, { recursive: true });
+        }
+    }
+    catch (error) {
+        console.error(`Error creating directory '${directory}': ${error.message}`);
+    }
+}
+exports.ensureDirectoryExists = ensureDirectoryExists;

package/dist/utilities/getTranslation.d.ts

@@ -0,0 +1,3 @@
+import type { JSX } from 'react';
+import { I18n } from '../types';
+export declare const getTranslation: (label: JSX.Element | Record<string, string> | string, i18n: Pick<I18n, 'fallbackLanguage' | 'language'>) => string;

package/dist/utilities/getTranslation.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTranslation = void 0;
+const getTranslation = (label, i18n) => {
+    if (typeof label === 'object') {
+        if (label[i18n.language]) {
+            return label[i18n.language];
+        }
+        let fallbacks = [];
+        if (typeof i18n.fallbackLanguage === 'string') {
+            fallbacks = [i18n.fallbackLanguage];
+        }
+        else if (Array.isArray(i18n.fallbackLanguage)) {
+            fallbacks = i18n.fallbackLanguage;
+        }
+        const fallbackLang = fallbacks.find((language) => label[language]);
+        return fallbackLang && label[fallbackLang] ? fallbackLang : label[Object.keys(label)[0]];
+    }
+    return label;
+};
+exports.getTranslation = getTranslation;

package/dist/utilities/init.d.ts

@@ -0,0 +1,30 @@
+import { Translations, InitI18n } from '../types';
+/**
+ * @function getTranslationString
+ *
+ * Gets a translation string from a translations object
+ *
+ * @returns string
+ */
+export declare const getTranslationString: ({ count, key, translations, }: {
+    count?: number;
+    key: string;
+    translations: Translations[0];
+}) => string;
+/**
+ * @function t
+ *
+ * Merges config defined translations with translations passed in as an argument
+ * returns a function that can be used to translate a string
+ *
+ * @returns string
+ */
+type TFunctionConstructor = ({ key, translations, vars, }: {
+    key: string;
+    translations?: Translations[0];
+    vars?: Record<string, any>;
+}) => string;
+export declare const t: TFunctionConstructor;
+export declare function matchLanguage(header: string): string | undefined;
+export declare const initI18n: InitI18n;
+export {};

package/dist/utilities/init.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initI18n = exports.matchLanguage = exports.t = exports.getTranslationString = void 0;
+const deepMerge_1 = require("./deepMerge");
+/**
+ * @function getTranslationString
+ *
+ * Gets a translation string from a translations object
+ *
+ * @returns string
+ */
+const getTranslationString = ({ count, key, translations, }) => {
+    const keys = key.split(':');
+    let keySuffix = '';
+    const translation = keys.reduce((acc, key, index) => {
+        if (typeof acc === 'string')
+            return acc;
+        if (typeof count === 'number') {
+            if (count === 0 && `${key}_zero` in acc) {
+                keySuffix = '_zero';
+            }
+            else if (count === 1 && `${key}_one` in acc) {
+                keySuffix = '_one';
+            }
+            else if (count === 2 && `${key}_two` in acc) {
+                keySuffix = '_two';
+            }
+            else if (count > 5 && `${key}_many` in acc) {
+                keySuffix = '_many';
+            }
+            else if (count > 2 && count <= 5 && `${key}_few` in acc) {
+                keySuffix = '_few';
+            }
+            else if (`${key}_other` in acc) {
+                keySuffix = '_other';
+            }
+        }
+        let keyToUse = key;
+        if (index === keys.length - 1 && keySuffix) {
+            keyToUse = `${key}${keySuffix}`;
+        }
+        if (acc && keyToUse in acc) {
+            return acc[keyToUse];
+        }
+        return undefined;
+    }, translations);
+    if (!translation) {
+        console.log('key not found: ', key);
+    }
+    return translation || key;
+};
+exports.getTranslationString = getTranslationString;
+/**
+ * @function replaceVars
+ *
+ * Replaces variables in a translation string with values from an object
+ *
+ * @returns string
+ */
+const replaceVars = ({ translationString, vars, }) => {
+    const parts = translationString.split(/({{.*?}})/);
+    return parts
+        .map((part) => {
+        if (part.startsWith('{{') && part.endsWith('}}')) {
+            const placeholder = part.substring(2, part.length - 2).trim();
+            return vars[placeholder] || part;
+        }
+        else {
+            return part;
+        }
+    })
+        .join('');
+};
+const t = ({ key, translations, vars }) => {
+    let translationString = (0, exports.getTranslationString)({
+        count: typeof vars?.count === 'number' ? vars.count : undefined,
+        key,
+        translations,
+    });
+    if (vars) {
+        translationString = replaceVars({
+            translationString,
+            vars,
+        });
+    }
+    if (!translationString) {
+        translationString = key;
+    }
+    return translationString;
+};
+exports.t = t;
+function parseAcceptLanguage(header) {
+    return header
+        .split(',')
+        .map((lang) => {
+        const [language, quality] = lang.trim().split(';q=');
+        return {
+            language,
+            quality: quality ? parseFloat(quality) : 1,
+        };
+    })
+        .sort((a, b) => b.quality - a.quality); // Sort by quality, highest to lowest
+}
+const acceptedLanguages = [
+    'ar',
+    'az',
+    'bg',
+    'cs',
+    'de',
+    'en',
+    'es',
+    'fa',
+    'fr',
+    'hr',
+    'hu',
+    'it',
+    'ja',
+    'ko',
+    'my',
+    'nb',
+    'nl',
+    'pl',
+    'pt',
+    'ro',
+    'rs',
+    'rsLatin',
+    'ru',
+    'sv',
+    'th',
+    'tr',
+    'ua',
+    'vi',
+    'zh',
+    'zhTw',
+];
+function matchLanguage(header) {
+    const parsedHeader = parseAcceptLanguage(header);
+    for (const { language } of parsedHeader) {
+        for (const acceptedLanguage of acceptedLanguages) {
+            if (language.startsWith(acceptedLanguage)) {
+                return acceptedLanguage;
+            }
+        }
+    }
+    return undefined;
+}
+exports.matchLanguage = matchLanguage;
+const initTFunction = (args) => (key, vars) => {
+    const { config, language, translations } = args;
+    const mergedLanguages = (0, deepMerge_1.deepMerge)(config?.translations ?? {}, translations);
+    const languagePreference = matchLanguage(language);
+    return (0, exports.t)({
+        key,
+        translations: mergedLanguages[languagePreference],
+        vars,
+    });
+};
+function memoize(fn, keys) {
+    const cacheMap = new Map();
+    return function (args) {
+        const cacheKey = keys.reduce((acc, key) => acc + args[key], '');
+        if (!cacheMap.has(cacheKey)) {
+            const result = fn(args);
+            cacheMap.set(cacheKey, result);
+        }
+        return cacheMap.get(cacheKey);
+    };
+}
+exports.initI18n = memoize((({ config, language = 'en', translations, context }) => {
+    const i18n = {
+        fallbackLanguage: config.fallbackLanguage,
+        language: language || config.fallbackLanguage,
+        t: initTFunction({
+            config,
+            language: language || config.fallbackLanguage,
+            translations,
+        }),
+    };
+    return i18n;
+}), ['language', 'context']);

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@payloadcms/translations",
+  "version": "3.0.0-alpha.0",
+  "main": "./dist/exports/index.ts",
+  "types": "./dist/types.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/exports/index.js",
+      "require": "./dist/exports/index.js"
+    },
+    "./api": {
+      "import": "./dist/_generatedFiles_/api/index.js",
+      "require": "./dist/_generatedFiles_/api/index.js"
+    },
+    "./client": {
+      "import": "./dist/_generatedFiles_/client/index.js",
+      "require": "./dist/_generatedFiles_/client/index.js"
+    }
+  },
+  "devDependencies": {
+    "@swc/core": "^1.3.102",
+    "@types/react": "^18",
+    "typescript": "5.2.2",
+    "@payloadcms/eslint-config": "1.1.1"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "writeFiles": "npx ts-node ./writeTranslationFiles.ts",
+    "build": "pnpm writeFiles && tsc",
+    "clean": "rimraf {dist,*.tsbuildinfo}"
+  }
+}