@nimpl/i18n 0.0.0-experimental-0b32faf

package/ClientTranslation.d.ts

@@ -0,0 +1,12 @@
+import React from "react";
+import { type I18nOptions } from "./types";
+type ClientTranslationProps = {
+    term: string;
+    components?: {
+        [key: string]: React.ReactElement;
+    };
+    query?: I18nOptions["query"];
+    removeUnusedQueries?: I18nOptions["removeUnusedQueries"];
+};
+declare const ClientTranslation: React.FC<ClientTranslationProps>;
+export default ClientTranslation;

package/I18nTransmitter.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+import { type I18nOptions } from "./types";
+export type I18nTransmitterProps = {
+    terms: (string | [string, I18nOptions])[];
+    children: React.ReactNode;
+    cleanThread?: boolean;
+    language?: string;
+};
+declare const I18nTransmitter: React.FC<I18nTransmitterProps>;
+export default I18nTransmitter;

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Alex Savelyev <dev@alexdln.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+# @nimpl/i18n
+
+(Former [next-translation](https://www.npmjs.com/package/next-translation))
+
+i18n library designed primarily with server components in mind and maximum optimization (due to the transfer of logic to the assembly stage and/or server side).
+
+Visit https://nimpl.dev/docs/i18n to view the full documentation.
+
+## Why one more library?
+
+Server components are a recent feature in React. Existing translation libraries are not yet well-optimized for them. If they support it, then only by disabling Next.js static optimization.
+
+This library is an attempt to create a highly optimized solution exclusively using the current capabilities of React.js, Next.js and node.js.
+
+## Features
+
+Support for loading translations during page rendering (_instead of the application build step_), allowing for up-to-date translations with ISR or SSR;
+
+Support for revalidation logic, i.e. you can specify how often translations should be updated (_or that they should not be updated at all_);
+
+Optimized caching system - not a single extra request will be sent, even with parallel building (which is now enabled by default);
+
+Passing only those translations to the client that are needed on the client;
+
+Embedding parameters in client translations on the server;
+
+Support for html entities.
+
+## Installation
+
+**Using npm:**
+
+```bash
+npm i @nimpl/i18n
+```
+
+**Using yarn:**
+
+```bash
+yarn add @nimpl/i18n
+```
+
+## Additionally
+
+Create tasks with wishes, ideas, difficulties, etc. All of them will definitely be considered and thought over.
+
+## License
+
+[MIT](https://github.com/alexdln/nimpl-i18n/blob/main/LICENSE)

package/ServerTranslation.d.ts

@@ -0,0 +1,13 @@
+import React from "react";
+import { type I18nOptions } from "./types";
+type ServerTranslationProps = {
+    term: string;
+    components?: {
+        [key: string]: React.ReactElement;
+    };
+    query?: I18nOptions["query"];
+    removeUnusedQueries?: I18nOptions["removeUnusedQueries"];
+    language?: string;
+};
+declare const ServerTranslation: React.FC<ServerTranslationProps>;
+export default ServerTranslation;

package/dist/ClientTranslation.js

@@ -0,0 +1,15 @@
+"use strict";
+"use client";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = __importDefault(require("react"));
+const Translation_1 = __importDefault(require("./lib/Translation"));
+const useTranslation_1 = __importDefault(require("./useTranslation"));
+const ClientTranslation = ({ term, components, query, removeUnusedQueries }) => {
+    const { t } = (0, useTranslation_1.default)();
+    const text = t(term, { query, removeUnusedQueries });
+    return react_1.default.createElement(Translation_1.default, { term: term, text: text, components: components });
+};
+exports.default = ClientTranslation;

package/dist/I18nTransmitter.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = __importDefault(require("react"));
+const object_path_1 = __importDefault(require("object-path"));
+const ClientI18nProvider_1 = __importDefault(require("./lib/ClientI18nProvider"));
+const formatServerTranslate_1 = __importDefault(require("./lib/formatServerTranslate"));
+const loadI18nData_1 = __importDefault(require("./lib/loadI18nData"));
+const formatServerTranslates = (result, targetKey, translates, opts = {}) => {
+    if (!translates)
+        return;
+    if (typeof translates === "string") {
+        result[targetKey] = (0, formatServerTranslate_1.default)({ term: targetKey, text: translates, parseEntities: true, ...opts });
+    }
+    else {
+        Object.entries(translates).forEach(([subKey, translate]) => {
+            formatServerTranslates(result, `${targetKey}.${subKey}`, translate, opts);
+        });
+    }
+};
+const I18nTransmitter = async ({ language: argLanguage, terms, children, cleanThread, }) => {
+    const { dictionary, language: configLanguage } = await (0, loadI18nData_1.default)();
+    const language = argLanguage || configLanguage;
+    if (!language) {
+        throw new Error("Unable to get the language in the createTranslation function. Please check the getLanguage method in the configuration file or pass the language as an argument.");
+    }
+    const result = {};
+    terms.forEach((term) => {
+        if (Array.isArray(term)) {
+            const [termKey, opts] = term;
+            const translates = object_path_1.default.get(dictionary, termKey);
+            formatServerTranslates(result, termKey, translates, opts);
+        }
+        else {
+            const translates = object_path_1.default.get(dictionary, term);
+            formatServerTranslates(result, term, translates);
+        }
+    });
+    return (react_1.default.createElement(ClientI18nProvider_1.default, { language: language, translates: result, cleanThread: cleanThread }, children));
+};
+exports.default = I18nTransmitter;

package/dist/ServerTranslation.js

@@ -0,0 +1,14 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = __importDefault(require("react"));
+const Translation_1 = __importDefault(require("./lib/Translation"));
+const getTranslation_1 = __importDefault(require("./getTranslation"));
+const ServerTranslation = async ({ term, components, query, removeUnusedQueries, language, }) => {
+    const { t } = await (0, getTranslation_1.default)({ language });
+    const text = t(term, { query, removeUnusedQueries });
+    return react_1.default.createElement(Translation_1.default, { term: term, text: text, components: components });
+};
+exports.default = ServerTranslation;

package/dist/clientConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+throw new Error("Please add the i18n wrapper to your next.config.js");

package/dist/configuration/getConfig.js

@@ -0,0 +1,68 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const url_1 = require("url");
+const CONFIG_PATH = path_1.default.join(process.cwd(), "nimpl-i18n.js");
+// Crutch bypass of conversion by the assembler to require
+const dynamicImport = new Function("p", "return import(p)");
+const getConfig = async () => {
+    let clientConfig;
+    if (fs_1.default.existsSync(CONFIG_PATH)) {
+        const config = await dynamicImport((0, url_1.pathToFileURL)(CONFIG_PATH).href);
+        clientConfig = config.default;
+    }
+    else {
+        // @ts-expect-error will be imported from the alias configuration in webpack
+        const config = await Promise.resolve().then(() => __importStar(require("@nimpl/i18n/clientConfig")));
+        clientConfig = config.default;
+    }
+    const { load, getLanguage, languages } = clientConfig;
+    if (!load) {
+        throw new Error(`Can't find "load" method in configuration file - https://github.com/alexdln/nimpl-i18n#configuration`);
+    }
+    if (!languages) {
+        throw new Error(`Can't find "languages" list in configuration file - https://github.com/alexdln/nimpl-i18n#configuration`);
+    }
+    if (!getLanguage) {
+        throw new Error(`Can't find "getLanguage" method in configuration file - https://github.com/alexdln/nimpl-i18n#configuration`);
+    }
+    return clientConfig;
+};
+exports.default = getConfig;

package/dist/configuration/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/getTranslation.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const object_path_1 = __importDefault(require("object-path"));
+const formatServerTranslate_1 = __importDefault(require("./lib/formatServerTranslate"));
+const loadI18nData_1 = __importDefault(require("./lib/loadI18nData"));
+const getTranslation = async (options) => {
+    const { language: argLanguage, namespace } = options || {};
+    const { dictionary, language: configLanguage } = await (0, loadI18nData_1.default)();
+    const language = argLanguage || configLanguage;
+    if (!language) {
+        throw new Error("Unable to get the language in the createTranslation function. Please check the getLanguage method in the configuration file or pass the language as an argument.");
+    }
+    const namespaceDictionary = namespace ? object_path_1.default.get(dictionary, namespace) : dictionary;
+    const t = (term, opts) => {
+        let termDictionary = namespaceDictionary;
+        let termNamespace = namespace;
+        let termKey = term;
+        if (term.includes(":")) {
+            [termNamespace, termKey] = term.split(":");
+            termDictionary = object_path_1.default.get(dictionary, termNamespace);
+        }
+        const translation = object_path_1.default.get(termDictionary, termKey);
+        const fullTerm = `${termNamespace ? `${termNamespace}.` : ""}${termKey}`;
+        if (typeof translation !== "string" || !translation)
+            return fullTerm;
+        return (0, formatServerTranslate_1.default)({ term: fullTerm, text: translation, parseEntities: true, ...opts });
+    };
+    return { t, language };
+};
+exports.default = getTranslation;

package/dist/helpers/isPromise.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPromise = void 0;
+const isPromise = (el) => {
+    if (el && typeof el === "object" && "then" in el) {
+        return true;
+    }
+    return false;
+};
+exports.isPromise = isPromise;

package/dist/i18n.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const CONFIG_PATH = path_1.default.join(process.cwd(), "nimpl-i18n.js");
+const i18n = () => {
+    return (nextConfig = {}) => {
+        return {
+            ...nextConfig,
+            webpack: (config, options) => {
+                if (!(0, fs_1.existsSync)(CONFIG_PATH))
+                    throw new Error("Please create and configure nimpl-i18n.js");
+                config.resolve ||= {};
+                config.resolve.alias = {
+                    ...config.resolve.alias,
+                    "@nimpl/i18n/clientConfig": CONFIG_PATH,
+                };
+                if (typeof nextConfig.webpack === "function") {
+                    return nextConfig.webpack(config, options);
+                }
+                return config;
+            },
+        };
+    };
+};
+exports.default = i18n;

package/dist/lib/ClientI18nContext.js

@@ -0,0 +1,6 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientI18nContext = void 0;
+const react_1 = require("react");
+exports.ClientI18nContext = (0, react_1.createContext)(null);

package/dist/lib/ClientI18nProvider.js

@@ -0,0 +1,46 @@
+"use strict";
+"use client";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = __importStar(require("react"));
+const ClientI18nContext_1 = require("./ClientI18nContext");
+const ClientI18nProvider = ({ translates, children, language, cleanThread }) => {
+    const prevTranslates = (0, react_1.useContext)(ClientI18nContext_1.ClientI18nContext);
+    if (cleanThread) {
+        Object.assign(translates, prevTranslates?.translates);
+    }
+    return react_1.default.createElement(ClientI18nContext_1.ClientI18nContext.Provider, { value: { language, translates } }, children);
+};
+exports.default = ClientI18nProvider;

package/dist/lib/Translation.js

@@ -0,0 +1,56 @@
+"use strict";
+/* eslint-disable @typescript-eslint/no-explicit-any */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = __importDefault(require("react"));
+const Translation = ({ term, text, components }) => {
+    const parts = text
+        .split(/<\/?[a-zA-Z0-9]+>|<[a-zA-Z0-9]+ ?\/>/gm)
+        .map((el, i) => react_1.default.createElement(react_1.default.Fragment, { key: `p-${i}` }, el));
+    if (components) {
+        const tags = text.match(/<\/?[a-zA-Z0-9]+>|<[a-zA-Z0-9]+ ?\/>/gm);
+        const openedTags = [];
+        tags?.forEach((tag, tagIndex) => {
+            const tagName = tag.match(/[a-zA-Z0-9]+/)[0];
+            if (tag.match(/<[a-zA-Z0-9]+ ?\/>/)) {
+                const component = components[tagName];
+                if (component) {
+                    parts.splice(tagIndex + 1, 1, react_1.default.cloneElement(component, { key: `c-${tagIndex}` }, component.props.children));
+                }
+                else {
+                    console.warn(`Unknown component for term "${term}" - ${tagName}`);
+                }
+            }
+            else if (tag.match(/<\/[a-zA-Z0-9]+>/)) {
+                const openedTagIndex = openedTags.findIndex((i) => i.tag === tagName);
+                if (openedTagIndex !== -1) {
+                    const lastOpenedIndex = openedTags.length - 1 - openedTagIndex;
+                    const openedTagsLength = openedTags.length;
+                    for (let i = openedTagsLength; i > lastOpenedIndex; i--) {
+                        const targetIndex = i - 1;
+                        const targetTag = openedTags[targetIndex];
+                        const component = components[targetTag.tag];
+                        if (component) {
+                            const children = parts
+                                .slice(targetTag.position + 1, tagIndex + 1)
+                                .filter((c) => Boolean(c && typeof c === "object" && "props" in c && c.props.children));
+                            parts.splice(targetTag.position + 1, // parts на 1 больше
+                            tagIndex - targetTag.position, react_1.default.cloneElement(component, { key: `${tagIndex}-${targetIndex}` }, children.length ? children : component.props.children));
+                        }
+                        else {
+                            console.warn(`Unknown component for term "${term}" - ${targetTag}`);
+                        }
+                        openedTags.splice(targetIndex, 1);
+                    }
+                }
+            }
+            else {
+                openedTags.push({ tag: tagName, position: tagIndex });
+            }
+        });
+    }
+    return parts;
+};
+exports.default = Translation;

package/dist/lib/formatServerTranslate.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 });
+const html_entities_1 = require("html-entities");
+const injectQuery_1 = __importDefault(require("./injectQuery"));
+const formatServerTranslate = ({ term, text, removeUnusedQueries, query, parseEntities }) => {
+    let newTranslate = text;
+    if (query) {
+        newTranslate = (0, injectQuery_1.default)({ term, text: newTranslate, query, removeUnusedQueries });
+    }
+    if (parseEntities === undefined || parseEntities === true) {
+        newTranslate = (0, html_entities_1.decode)(newTranslate, { scope: "strict" });
+    }
+    return newTranslate;
+};
+exports.default = formatServerTranslate;

package/dist/lib/injectQuery.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const injectQuery = ({ text, query, removeUnusedQueries }) => {
+    const newText = text.replace(/{{([a-zA-Z0-9_-]+)}}/gm, (matched, g1) => {
+        if (query[g1]) {
+            return query[g1].toString();
+        }
+        if (removeUnusedQueries) {
+            return "";
+        }
+        else {
+            return matched;
+        }
+    });
+    return newText;
+};
+exports.default = injectQuery;

package/dist/lib/loadI18nData.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const getConfig_1 = __importDefault(require("../configuration/getConfig"));
+const get_pathname_1 = require("@nimpl/getters/get-pathname");
+const get_params_1 = require("@nimpl/getters/get-params");
+const loadI18nData = async () => {
+    const config = await (0, getConfig_1.default)();
+    const language = await config.getLanguage({
+        get pathname() {
+            return (0, get_pathname_1.getPathname)();
+        },
+        get params() {
+            return (0, get_params_1.getParams)();
+        },
+    });
+    if (!language || !config.languages.includes(language)) {
+        throw new Error(`Can\' load data for language "${language}", valid languages are: ${config.languages.join(", ")}`);
+    }
+    const dictionary = await config.load(language);
+    return { dictionary, language };
+};
+exports.default = loadI18nData;

package/dist/lib/parseEntities.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const html_entities_1 = require("html-entities");
+const parseEntities = (translate) => {
+    return (0, html_entities_1.decode)(translate, { scope: "strict" });
+};
+exports.default = parseEntities;

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/useTranslation.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("react");
+const ClientI18nContext_1 = require("./lib/ClientI18nContext");
+const injectQuery_1 = __importDefault(require("./lib/injectQuery"));
+const useTranslation = ({ namespace } = {}) => {
+    const context = (0, react_1.useContext)(ClientI18nContext_1.ClientI18nContext);
+    if (!context) {
+        throw new Error("Please, Init I18nTransmitter for client components - https://nimpl.dev/docs/i18n/usage#client-components");
+    }
+    const { language, translates } = context;
+    const t = (term, opts) => {
+        let termKey;
+        if (term.includes(":")) {
+            termKey = term.replace(":", ".");
+        }
+        else {
+            termKey = `${namespace ? `${namespace}.` : ""}${term}`;
+        }
+        const translation = translates[termKey];
+        if (!translation)
+            return termKey;
+        if (opts?.query) {
+            return (0, injectQuery_1.default)({
+                term,
+                text: translation,
+                query: opts.query,
+                removeUnusedQueries: opts.removeUnusedQueries,
+            });
+        }
+        return translation;
+    };
+    return { t, language };
+};
+exports.default = useTranslation;

package/env.d.ts

@@ -0,0 +1 @@
+/// <reference types="react/experimental" />

package/getTranslation.d.ts

@@ -0,0 +1,10 @@
+import { type I18nOptions } from "./types";
+type GetTranslationReturnType = {
+    t: (term: string, opts?: I18nOptions) => string;
+    language: string;
+};
+declare const getTranslation: (options?: {
+    language?: string;
+    namespace?: string;
+}) => Promise<GetTranslationReturnType>;
+export default getTranslation;

package/i18n.d.ts

@@ -0,0 +1,2 @@
+declare const i18n: () => (nextConfig?: any) => any;
+export default i18n;

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@nimpl/i18n",
+  "version": "0.0.0-experimental-0b32faf",
+  "description": "i18n library for working with translations in server and client components",
+  "exports": {
+    "./ClientTranslation": {
+      "default": "./dist/ClientTranslation.js"
+    },
+    "./getTranslation": {
+      "default": "./dist/getTranslation.js"
+    },
+    "./i18n": {
+      "default": "./dist/i18n.js"
+    },
+    "./I18nTransmitter": {
+      "default": "./dist/I18nTransmitter.js"
+    },
+    "./ServerTranslation": {
+      "default": "./dist/ServerTranslation.js"
+    },
+    "./types": {
+      "default": "./dist/types.js"
+    },
+    "./useTranslation": {
+      "default": "./dist/useTranslation.js"
+    },
+    "./clientConfig": {
+      "default": "./dist/clientConfig.js"
+    }
+  },
+  "files": [
+    "dist",
+    "*.d.ts"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [
+    "next",
+    "next.js",
+    "server components",
+    "react.js",
+    "i18n",
+    "internationalization",
+    "localization",
+    "l10n",
+    "intl"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/alexdln/nimpl-i18n.git"
+  },
+  "author": {
+    "name": "Alex Savelyev",
+    "email": "dev@alexdln.com",
+    "url": "https://github.com/alexdln/"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "25.1.0",
+    "@types/object-path": "0.11.4",
+    "@types/react": "19.2.10",
+    "@types/webpack": "5.28.5",
+    "react": "19.2.4",
+    "typescript": "5.9.3"
+  },
+  "peerDependencies": {
+    "react": ">= 19.1.0"
+  },
+  "dependencies": {
+    "@nimpl/getters": "2.2.2",
+    "html-entities": "2.6.0",
+    "object-path": "0.11.8"
+  }
+}

package/types.d.ts

@@ -0,0 +1,22 @@
+export type Translates = {
+    [key: string]: Translates | string;
+};
+export type GetLangOpts = {
+    pathname: string | null;
+    params: {
+        [key: string]: string | string[];
+    };
+};
+export type Query = {
+    [key: string]: string | number;
+};
+export type I18nOptions = {
+    query?: Query;
+    removeUnusedQueries?: boolean;
+};
+export type I18nContextType = {
+    lang: string;
+    translates: {
+        [key: string]: string;
+    };
+} | null;

package/useTranslation.d.ts

@@ -0,0 +1,9 @@
+import { type I18nOptions } from "./types";
+type GetTranslationReturnType = {
+    t: (term: string, opts?: I18nOptions) => string;
+    language: string;
+};
+declare const useTranslation: ({ namespace }?: {
+    namespace?: string;
+}) => GetTranslationReturnType;
+export default useTranslation;