@application-kit/i18n 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @application-kit/i18n
 
+## 0.3.0
+
+### Minor Changes
+
+- 61cb664: `useTranslate()` во входе `@application-kit/i18n/vue` — перевод и локаль для компонента без импорта `vue-i18n`. Пресет `@application-kit/lint-config` запрещает импорт `vue-i18n` в `src/libs` и `src/modules`.
+
+## 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` | ничего |
 
 Импорт любого входа не имеет побочных эффектов и не требует окружения: состояние плагина заводится на
 установке в приложение, а не на загрузке модуля.
@@ -52,6 +53,8 @@ app.use(new I18nPlugin({
 - `I18nPlugin` — ставит `vue-i18n` (Composition API), стартовая и запасная локаль — `localeSet.fallback`.
 - `collectModuleDictionaries(registry)` — словари модулей реестра в порядке регистрации. Реестр структурный:
   достаточно `getModules()`; словарь берётся у модуля с методом `getDictionary`.
+- `useTranslate()` — перевод и локаль в `setup` компонента: `{ locale, t }`, область всегда глобальная, запись в
+  `locale` меняет язык всего приложения. Приложение импортирует его, а не `vue-i18n`: механизм словаря меняется в пакете.
 - `setLocale(app, locale)`, `getLocaleReference(app)`, `getTranslate(app)` — локаль и перевод конкретного
   экземпляра приложения для кода вне компонентов. Состояние хранится по `App` (`WeakMap`), а не в модуле:
   на сервере модуль живёт между запросами, и язык одного пользователя не доезжает до другого.
@@ -64,3 +67,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/cjs/vue/index.d.ts

@@ -1,3 +1,4 @@
 export * from './i18n-plugin.js';
 export * from './locale-cookie.js';
 export * from './module-dictionary.js';
+export * from './use-translate.js';

package/dist/cjs/vue/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./i18n-plugin.js"), exports);
 __exportStar(require("./locale-cookie.js"), exports);
 __exportStar(require("./module-dictionary.js"), exports);
+__exportStar(require("./use-translate.js"), exports);

package/dist/cjs/vue/use-translate.d.ts

@@ -0,0 +1,7 @@
+import type { WritableComputedRef } from 'vue';
+import type { TranslateFunction } from '../translate-function.js';
+export interface TranslateComposableInterface {
+    locale: WritableComputedRef<string>;
+    t: TranslateFunction;
+}
+export declare const useTranslate: () => TranslateComposableInterface;

package/dist/cjs/vue/use-translate.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTranslate = void 0;
+const vue_i18n_1 = require("vue-i18n");
+const useTranslate = () => {
+    const { locale, t } = (0, vue_i18n_1.useI18n)({ useScope: 'global' });
+    return { locale, t: (key, named) => t(key, named ?? {}) };
+};
+exports.useTranslate = useTranslate;

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/dist/esm/vue/index.d.ts

@@ -1,3 +1,4 @@
 export * from './i18n-plugin.js';
 export * from './locale-cookie.js';
 export * from './module-dictionary.js';
+export * from './use-translate.js';

package/dist/esm/vue/index.js

@@ -1,3 +1,4 @@
 export * from './i18n-plugin.js';
 export * from './locale-cookie.js';
 export * from './module-dictionary.js';
+export * from './use-translate.js';

package/dist/esm/vue/use-translate.d.ts

@@ -0,0 +1,7 @@
+import type { WritableComputedRef } from 'vue';
+import type { TranslateFunction } from '../translate-function.js';
+export interface TranslateComposableInterface {
+    locale: WritableComputedRef<string>;
+    t: TranslateFunction;
+}
+export declare const useTranslate: () => TranslateComposableInterface;

package/dist/esm/vue/use-translate.js

@@ -0,0 +1,5 @@
+import { useI18n } from 'vue-i18n';
+export const useTranslate = () => {
+    const { locale, t } = useI18n({ useScope: 'global' });
+    return { locale, t: (key, named) => t(key, named ?? {}) };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@application-kit/i18n",
-  "version": "0.1.0",
+  "version": "0.3.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"