@application-kit/i18n 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @application-kit/i18n
 
+## 0.5.0
+
+### Minor Changes
+
+- b26b1a7: `useLocaleSelection(localeSet, cookie)` во входе `/vue` — модель переключателя языка: чтение с запасной локалью для значения вне набора, запись меняет локаль приложения и пишет cookie.
+
+## 0.4.0
+
+### Minor Changes
+
+- 2a51c82: Каналы значений «сервер → клиент». `vue-ssr`: опция `channels` у `createSsrEntry` и `hydrateSsrApplication`, контракт `SsrChannelInterface`, `PiniaPlugin`. Ломает: `describePage` заменена на `resolveLang`, значения `window.*` идут только каналами; `channels` обязательна у обеих функций, `beforeMount` стал необязательным. `i18n/vue`: `createLocaleChannel`. `feature-flags/vue`: `createFeatureFlagChannel`.
+
 ## 0.3.0
 
 ### Minor Changes

package/README.md

@@ -55,11 +55,17 @@ app.use(new I18nPlugin({
   достаточно `getModules()`; словарь берётся у модуля с методом `getDictionary`.
 - `useTranslate()` — перевод и локаль в `setup` компонента: `{ locale, t }`, область всегда глобальная, запись в
   `locale` меняет язык всего приложения. Приложение импортирует его, а не `vue-i18n`: механизм словаря меняется в пакете.
+- `createLocaleChannel(localeSet)` — канал локали для `createSsrEntry` и `hydrateSsrApplication` пакета
+  `@application-kit/vue-ssr`: клиент получает готовое решение сервера, не поддержанное набором значение с провода не
+  применяется. Пакет он не импортирует, совпадение — по форме.
 - `setLocale(app, locale)`, `getLocaleReference(app)`, `getTranslate(app)` — локаль и перевод конкретного
   экземпляра приложения для кода вне компонентов. Состояние хранится по `App` (`WeakMap`), а не в модуле:
   на сервере модуль живёт между запросами, и язык одного пользователя не доезжает до другого.
 - `writeLocaleCookie(locale, { name, maxAgeSeconds? })` — запоминает выбор языка для следующего запроса:
   `Path=/`, `SameSite=Lax`, год по умолчанию, без `HttpOnly` (cookie пишет браузер, значение не секрет).
+- `useLocaleSelection(localeSet, { name, maxAgeSeconds? })` — модель переключателя языка для `v-model`: читает локаль
+  приложения (вне набора — `localeSet.fallback`), запись меняет язык приложения и пишет cookie. Варианты и их подписи
+  строит приложение: компонент выбора остаётся за ним.
 
 ## Сервер
 

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

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

package/dist/cjs/vue/index.js

@@ -15,6 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./i18n-plugin.js"), exports);
+__exportStar(require("./locale-channel.js"), exports);
 __exportStar(require("./locale-cookie.js"), exports);
 __exportStar(require("./module-dictionary.js"), exports);
+__exportStar(require("./use-locale-selection.js"), exports);
 __exportStar(require("./use-translate.js"), exports);

package/dist/cjs/vue/locale-channel.d.ts

@@ -0,0 +1,13 @@
+import type { App } from 'vue';
+import type { LocaleSetInterface } from '../define-locales.js';
+export interface LocaleChannelInterface<L extends string> {
+    readonly key: string;
+    restore(app: App, serialized: string | undefined): void;
+    withValue(locale: L): LocaleChannelValueInterface;
+}
+export interface LocaleChannelValueInterface {
+    apply(app: App): void;
+    readonly key: string;
+    readonly serialized: string;
+}
+export declare const createLocaleChannel: <L extends string>(localeSet: LocaleSetInterface<L>) => LocaleChannelInterface<L>;

package/dist/cjs/vue/locale-channel.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLocaleChannel = void 0;
+const i18n_plugin_js_1 = require("./i18n-plugin.js");
+const LOCALE_CHANNEL_KEY = 'ssrLocale';
+const createLocaleChannel = (localeSet) => ({
+    key: LOCALE_CHANNEL_KEY,
+    restore: (app, serialized) => {
+        if (localeSet.isSupported(serialized)) {
+            (0, i18n_plugin_js_1.setLocale)(app, serialized);
+        }
+    },
+    withValue: (locale) => ({
+        apply: (app) => {
+            (0, i18n_plugin_js_1.setLocale)(app, locale);
+        },
+        key: LOCALE_CHANNEL_KEY,
+        serialized: locale,
+    }),
+});
+exports.createLocaleChannel = createLocaleChannel;

package/dist/cjs/vue/use-locale-selection.d.ts

@@ -0,0 +1,4 @@
+import type { WritableComputedRef } from 'vue';
+import type { LocaleSetInterface } from '../define-locales.js';
+import type { LocaleCookieOptionsInterface } from './locale-cookie.js';
+export declare const useLocaleSelection: <L extends string>(localeSet: LocaleSetInterface<L>, cookie: LocaleCookieOptionsInterface) => WritableComputedRef<L>;

package/dist/cjs/vue/use-locale-selection.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLocaleSelection = void 0;
+const vue_1 = require("vue");
+const locale_cookie_js_1 = require("./locale-cookie.js");
+const use_translate_js_1 = require("./use-translate.js");
+const useLocaleSelection = (localeSet, cookie) => {
+    const { locale } = (0, use_translate_js_1.useTranslate)();
+    return (0, vue_1.computed)({
+        get: () => (localeSet.isSupported(locale.value) ? locale.value : localeSet.fallback),
+        set: (value) => {
+            locale.value = value;
+            (0, locale_cookie_js_1.writeLocaleCookie)(value, cookie);
+        },
+    });
+};
+exports.useLocaleSelection = useLocaleSelection;

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

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

package/dist/esm/vue/index.js

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

package/dist/esm/vue/locale-channel.d.ts

@@ -0,0 +1,13 @@
+import type { App } from 'vue';
+import type { LocaleSetInterface } from '../define-locales.js';
+export interface LocaleChannelInterface<L extends string> {
+    readonly key: string;
+    restore(app: App, serialized: string | undefined): void;
+    withValue(locale: L): LocaleChannelValueInterface;
+}
+export interface LocaleChannelValueInterface {
+    apply(app: App): void;
+    readonly key: string;
+    readonly serialized: string;
+}
+export declare const createLocaleChannel: <L extends string>(localeSet: LocaleSetInterface<L>) => LocaleChannelInterface<L>;

package/dist/esm/vue/locale-channel.js

@@ -0,0 +1,17 @@
+import { setLocale } from './i18n-plugin.js';
+const LOCALE_CHANNEL_KEY = 'ssrLocale';
+export const createLocaleChannel = (localeSet) => ({
+    key: LOCALE_CHANNEL_KEY,
+    restore: (app, serialized) => {
+        if (localeSet.isSupported(serialized)) {
+            setLocale(app, serialized);
+        }
+    },
+    withValue: (locale) => ({
+        apply: (app) => {
+            setLocale(app, locale);
+        },
+        key: LOCALE_CHANNEL_KEY,
+        serialized: locale,
+    }),
+});

package/dist/esm/vue/use-locale-selection.d.ts

@@ -0,0 +1,4 @@
+import type { WritableComputedRef } from 'vue';
+import type { LocaleSetInterface } from '../define-locales.js';
+import type { LocaleCookieOptionsInterface } from './locale-cookie.js';
+export declare const useLocaleSelection: <L extends string>(localeSet: LocaleSetInterface<L>, cookie: LocaleCookieOptionsInterface) => WritableComputedRef<L>;

package/dist/esm/vue/use-locale-selection.js

@@ -0,0 +1,13 @@
+import { computed } from 'vue';
+import { writeLocaleCookie } from './locale-cookie.js';
+import { useTranslate } from './use-translate.js';
+export const useLocaleSelection = (localeSet, cookie) => {
+    const { locale } = useTranslate();
+    return computed({
+        get: () => (localeSet.isSupported(locale.value) ? locale.value : localeSet.fallback),
+        set: (value) => {
+            locale.value = value;
+            writeLocaleCookie(value, cookie);
+        },
+    });
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@application-kit/i18n",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Локали, словари и плагин vue-i18n для SSR-приложений на Vue и серверный резолв локали запроса",
   "keywords": [
     "i18n",