@application-kit/i18n 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @application-kit/i18n
 
+## 0.2.0
+
+### Minor Changes
+
+- 6ddb211: Вход `/testing`: `createFakeTranslate(dictionary, defaultLocale)` — перевод для спек кода, принимающего `t` зависимостью:
+  ходит в настоящий словарь, подставляет именованные строки и числа, на отсутствующий ключ бросает `TypeError`; локаль —
+  обобщённый параметр, язык по умолчанию называет вызывающий. `vue-i18n` вход не тянет.
+
 ## 0.1.0
 
 ### Minor Changes

package/README.md

@@ -19,6 +19,7 @@ Peer-зависимости: `vue`, `vue-i18n` — экземпляр у при
 | `@application-kit/i18n` | изоморфно: набор локалей, тип словаря, сборка словаря, тип перевода | ничего (типы `vue-i18n`) |
 | `@application-kit/i18n/vue` | клиент и SSR-рендер: плагин, доступ к локали и переводу, cookie выбора | `vue`, `vue-i18n` |
 | `@application-kit/i18n/server` | сервер: локаль запроса | ничего |
+| `@application-kit/i18n/testing` | спеки потребителя: перевод по словарю без `vue-i18n` | ничего |
 
 Импорт любого входа не имеет побочных эффектов и не требует окружения: состояние плагина заводится на
 установке в приложение, а не на загрузке модуля.
@@ -64,3 +65,16 @@ app.use(new I18nPlugin({
   `Accept-Language` с весами `q` (`q=0` отклоняет язык, `ru-RU` — это `ru`) → `localeSet.fallback`. Испорченное
   значение любого источника читается как «предпочтения нет». Запрос описан структурно (`LocaleRequestInterface`) —
   подходит запрос Fastify с `@fastify/cookie` и без привязки к фреймворку.
+
+## Тесты потребителя
+
+- `createFakeTranslate(dictionary, defaultLocale)` — фабрика `(locale = defaultLocale) => TranslateFunction` для спек кода,
+  который принимает `t` зависимостью. Фейк, а не заглушка: ходит в настоящий словарь, подставляет именованные строки и
+  числа (`{name}`), на отсутствующий ключ бросает `TypeError` — опечатка в ключе валит спеку, а не проходит как «какой-то
+  текст вернулся».
+
+```ts
+export const fakeTranslate = createFakeTranslate(messages, localeSet.fallback)
+
+useUserListActions({ translate: fakeTranslate() })
+```

package/dist/cjs/testing/fake-translate.d.ts

@@ -0,0 +1,3 @@
+import type { LocaleDictionary } from '../dictionary.js';
+import type { TranslateFunction } from '../translate-function.js';
+export declare const createFakeTranslate: <L extends string>(dictionary: LocaleDictionary<L>, defaultLocale: L) => (locale?: L) => TranslateFunction;

package/dist/cjs/testing/fake-translate.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFakeTranslate = void 0;
+const resolveTemplate = (dictionary, locale, key) => {
+    let node = dictionary[locale];
+    for (const part of key.split('.')) {
+        node = node instanceof Object ? Reflect.get(node, part) : undefined;
+    }
+    return node;
+};
+const createFakeTranslate = (dictionary, defaultLocale) => (locale = defaultLocale) => (key, named) => {
+    const template = resolveTemplate(dictionary, locale, key);
+    if (typeof template !== 'string') {
+        throw new TypeError(`Ключа нет в словаре: ${key}`);
+    }
+    return template.replaceAll(/\{(?<name>\w+)\}/gu, (_match, name) => {
+        const value = named?.[name];
+        return typeof value === 'string' || typeof value === 'number' ? String(value) : '';
+    });
+};
+exports.createFakeTranslate = createFakeTranslate;

package/dist/cjs/testing/index.d.ts

@@ -0,0 +1 @@
+export * from './fake-translate.js';

package/dist/cjs/testing/index.js

@@ -0,0 +1,17 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./fake-translate.js"), exports);

package/dist/esm/testing/fake-translate.d.ts

@@ -0,0 +1,3 @@
+import type { LocaleDictionary } from '../dictionary.js';
+import type { TranslateFunction } from '../translate-function.js';
+export declare const createFakeTranslate: <L extends string>(dictionary: LocaleDictionary<L>, defaultLocale: L) => (locale?: L) => TranslateFunction;

package/dist/esm/testing/fake-translate.js

@@ -0,0 +1,17 @@
+const resolveTemplate = (dictionary, locale, key) => {
+    let node = dictionary[locale];
+    for (const part of key.split('.')) {
+        node = node instanceof Object ? Reflect.get(node, part) : undefined;
+    }
+    return node;
+};
+export const createFakeTranslate = (dictionary, defaultLocale) => (locale = defaultLocale) => (key, named) => {
+    const template = resolveTemplate(dictionary, locale, key);
+    if (typeof template !== 'string') {
+        throw new TypeError(`Ключа нет в словаре: ${key}`);
+    }
+    return template.replaceAll(/\{(?<name>\w+)\}/gu, (_match, name) => {
+        const value = named?.[name];
+        return typeof value === 'string' || typeof value === 'number' ? String(value) : '';
+    });
+};

package/dist/esm/testing/index.d.ts

@@ -0,0 +1 @@
+export * from './fake-translate.js';

package/dist/esm/testing/index.js

@@ -0,0 +1 @@
+export * from './fake-translate.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@application-kit/i18n",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Локали, словари и плагин vue-i18n для SSR-приложений на Vue и серверный резолв локали запроса",
   "keywords": [
     "i18n",
@@ -44,6 +44,16 @@
         "default": "./dist/cjs/server/index.js"
       }
     },
+    "./testing": {
+      "import": {
+        "types": "./dist/esm/testing/index.d.ts",
+        "default": "./dist/esm/testing/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/testing/index.d.ts",
+        "default": "./dist/cjs/testing/index.js"
+      }
+    },
     "./vue": {
       "import": {
         "types": "./dist/esm/vue/index.d.ts",
@@ -62,7 +72,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "rm -rf ./dist && node ../../scripts/barrels.mjs create ./src --entry-only=server,vue && tsc --project tsconfig.build.json && tsc --project tsconfig.build.cjs.json && node ../../scripts/barrels.mjs clean ./src && node ../../scripts/mark-cjs.mjs ./dist/cjs",
+    "build": "rm -rf ./dist && node ../../scripts/barrels.mjs create ./src --entry-only=server,testing,vue && tsc --project tsconfig.build.json && tsc --project tsconfig.build.cjs.json && node ../../scripts/barrels.mjs clean ./src && node ../../scripts/mark-cjs.mjs ./dist/cjs",
     "lint:tsc": "tsc --noEmit --pretty --project .",
     "test:mutation": "stryker run",
     "test:unit": "vitest run"