@application-kit/i18n 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# @application-kit/i18n
+
+## 0.1.0
+
+### Minor Changes
+
+- bea5e4a: Первый выпуск: набор локалей `defineLocales`, словари `LocaleDictionary`/`composeMessages` и тип `TranslateFunction` (корень,
+  изоморфно); `I18nPlugin` с доступом к локали и переводу приложения (`getLocaleReference`, `getTranslate`, `setLocale`),
+  `collectModuleDictionaries` и `writeLocaleCookie` (вход `/vue`); `resolveLocale` — локаль запроса по профилю, cookie и
+  `Accept-Language` (вход `/server`).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 application-kit
+
+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

@@ -1,3 +1,66 @@
-# Temporary Holding Version
+# @application-kit/i18n
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Локали, словари и плагин `vue-i18n` для SSR-приложений на Vue.js и серверный резолв локали запроса. Пакет не знает
+языков продукта, его словарей и реестра модулей: набор локалей, каркасный словарь и словари модулей приходят
+параметрами.
+
+## Установка
+
+```sh
+yarn add @application-kit/i18n
+```
+
+Peer-зависимости: `vue`, `vue-i18n` — экземпляр у приложения один.
+
+## Входы
+
+| Вход | Для чего | Тянет |
+|------|----------|-------|
+| `@application-kit/i18n` | изоморфно: набор локалей, тип словаря, сборка словаря, тип перевода | ничего (типы `vue-i18n`) |
+| `@application-kit/i18n/vue` | клиент и SSR-рендер: плагин, доступ к локали и переводу, cookie выбора | `vue`, `vue-i18n` |
+| `@application-kit/i18n/server` | сервер: локаль запроса | ничего |
+
+Импорт любого входа не имеет побочных эффектов и не требует окружения: состояние плагина заводится на
+установке в приложение, а не на загрузке модуля.
+
+## Корень
+
+- `defineLocales(locales, fallback)` — набор `{ locales, fallback, isSupported }`; тип локали выводится из
+  литерального кортежа, запасная локаль вне списка не компилируется. `isSupported(value: unknown)` — проверка
+  значения, пришедшего снаружи (cookie, заголовок, профиль).
+- `LocaleDictionary<L>` — половины словаря одного поставщика по локалям; `LocaleMessages` — одна половина.
+- `composeMessages(dictionaries, locales)` — словарь приложения: каркас первым, модули за ним, поздний перекрывает ранний.
+- `TranslateFunction` — `(key, named?) => string`, форма `t` из `useI18n()`: перевод для кода вне компонентов.
+- `DictionaryProviderInterface<L>` — контракт модуля, несущего свой словарь (`getDictionary()`).
+
+```ts
+export const localeSet = defineLocales(['ru', 'en'], 'ru')
+export type AppLocale = (typeof localeSet.locales)[number]
+```
+
+## Vue.js
+
+```ts
+app.use(new I18nPlugin({
+  localeSet,
+  messages: frameworkMessages,
+  // Вызывается в контексте приложения: `inject` доступен, реестр модулей приложение достаёт само.
+  moduleDictionaries: () => collectModuleDictionaries(inject(MODULE_REGISTRY, undefined)),
+}))
+```
+
+- `I18nPlugin` — ставит `vue-i18n` (Composition API), стартовая и запасная локаль — `localeSet.fallback`.
+- `collectModuleDictionaries(registry)` — словари модулей реестра в порядке регистрации. Реестр структурный:
+  достаточно `getModules()`; словарь берётся у модуля с методом `getDictionary`.
+- `setLocale(app, locale)`, `getLocaleReference(app)`, `getTranslate(app)` — локаль и перевод конкретного
+  экземпляра приложения для кода вне компонентов. Состояние хранится по `App` (`WeakMap`), а не в модуле:
+  на сервере модуль живёт между запросами, и язык одного пользователя не доезжает до другого.
+- `writeLocaleCookie(locale, { name, maxAgeSeconds? })` — запоминает выбор языка для следующего запроса:
+  `Path=/`, `SameSite=Lax`, год по умолчанию, без `HttpOnly` (cookie пишет браузер, значение не секрет).
+
+## Сервер
+
+- `resolveLocale(request, { localeSet, cookieName })` — локаль запроса: профиль (`request.user.locale`) → cookie →
+  `Accept-Language` с весами `q` (`q=0` отклоняет язык, `ru-RU` — это `ru`) → `localeSet.fallback`. Испорченное
+  значение любого источника читается как «предпочтения нет». Запрос описан структурно (`LocaleRequestInterface`) —
+  подходит запрос Fastify с `@fastify/cookie` и без привязки к фреймворку.

package/dist/cjs/define-locales.d.ts

@@ -0,0 +1,10 @@
+export interface LocaleSetInterface<L extends string> {
+    readonly fallback: L;
+    readonly isSupported: LocaleGuard<L>;
+    readonly locales: readonly L[];
+}
+type LocaleGuard<L extends string> = (value: unknown) => value is L;
+export declare const defineLocales: <const T extends readonly [string, ...string[]]>(locales: T, fallback: NoInfer<T[number]>) => {
+    readonly locales: T;
+} & LocaleSetInterface<T[number]>;
+export {};

package/dist/cjs/define-locales.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineLocales = void 0;
+const defineLocales = (locales, fallback) => {
+    const values = locales;
+    if (!values.includes(fallback)) {
+        throw new RangeError(`Запасная локаль «${fallback}» не входит в набор: ${locales.join(', ')}`);
+    }
+    return {
+        fallback,
+        isSupported: (value) => values.includes(value),
+        locales,
+    };
+};
+exports.defineLocales = defineLocales;

package/dist/cjs/dictionary-provider.interface.d.ts

@@ -0,0 +1,4 @@
+import type { LocaleDictionary } from './dictionary.js';
+export interface DictionaryProviderInterface<L extends string> {
+    getDictionary(): LocaleDictionary<L>;
+}

package/dist/cjs/dictionary-provider.interface.js

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

package/dist/cjs/dictionary.d.ts

@@ -0,0 +1,4 @@
+import type { LocaleMessageValue, VueMessageType } from 'vue-i18n';
+export type LocaleDictionary<L extends string> = Record<L, LocaleMessages>;
+export type LocaleMessages = Record<string, LocaleMessageValue<VueMessageType>>;
+export declare const composeMessages: <L extends string>(dictionaries: readonly LocaleDictionary<L>[], locales: readonly L[]) => LocaleDictionary<L>;

package/dist/cjs/dictionary.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composeMessages = void 0;
+const composeMessages = (dictionaries, locales) => {
+    const merged = new Map(locales.map((locale) => [locale, {}]));
+    for (const [locale, messages] of merged) {
+        for (const dictionary of dictionaries) {
+            Object.assign(messages, dictionary[locale]);
+        }
+    }
+    return Object.fromEntries(merged);
+};
+exports.composeMessages = composeMessages;

package/dist/cjs/index.d.ts

@@ -0,0 +1,4 @@
+export * from './define-locales.js';
+export * from './dictionary.js';
+export * from './dictionary-provider.interface.js';
+export * from './translate-function.js';

package/dist/cjs/index.js

@@ -0,0 +1,20 @@
+"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("./define-locales.js"), exports);
+__exportStar(require("./dictionary.js"), exports);
+__exportStar(require("./dictionary-provider.interface.js"), exports);
+__exportStar(require("./translate-function.js"), exports);

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

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

@@ -0,0 +1 @@
+export * from './resolve-locale.js';

package/dist/cjs/server/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("./resolve-locale.js"), exports);

package/dist/cjs/server/resolve-locale.d.ts

@@ -0,0 +1,13 @@
+import type { LocaleSetInterface } from '../define-locales.js';
+export interface LocaleRequestInterface {
+    cookies?: Partial<Record<string, string>> | undefined;
+    headers: Partial<Record<string, string | string[]>>;
+    user?: {
+        locale?: null | string;
+    } | undefined;
+}
+export interface ResolveLocaleOptionsInterface<L extends string> {
+    cookieName: string;
+    localeSet: LocaleSetInterface<L>;
+}
+export declare const resolveLocale: <L extends string>(request: LocaleRequestInterface, options: ResolveLocaleOptionsInterface<L>) => L;

package/dist/cjs/server/resolve-locale.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveLocale = void 0;
+const DEFAULT_QUALITY = 1;
+const REJECTED_QUALITY = 0;
+const QUALITY_PATTERN = /(?<=;\s*q=)[^;]*/u;
+const SUBTAGS_AND_PARAMETERS_PATTERN = /[-;].*/u;
+const parseQuality = (range) => {
+    const value = QUALITY_PATTERN.exec(range)?.[0];
+    if (value === undefined) {
+        return DEFAULT_QUALITY;
+    }
+    const quality = Number(value);
+    return Number.isNaN(quality) ? REJECTED_QUALITY : quality;
+};
+const parseLanguageRange = (range) => ({
+    primaryTag: range.replace(SUBTAGS_AND_PARAMETERS_PATTERN, '').trim()
+        .toLowerCase(),
+    quality: parseQuality(range),
+});
+const resolveFromAcceptLanguage = (header, localeSet) => {
+    const ranges = header
+        .split(',')
+        .map((range) => parseLanguageRange(range))
+        .filter((range) => range.quality > REJECTED_QUALITY)
+        .toSorted((left, right) => right.quality - left.quality);
+    for (const range of ranges) {
+        if (localeSet.isSupported(range.primaryTag)) {
+            return range.primaryTag;
+        }
+    }
+    return undefined;
+};
+const requestedLocaleOf = (request, localeSet) => {
+    const header = request.headers['accept-language'];
+    return typeof header === 'string' ? resolveFromAcceptLanguage(header, localeSet) : undefined;
+};
+const chosenLocalesOf = (request, cookieName) => [
+    request.user?.locale,
+    request.cookies?.[cookieName],
+];
+const resolveLocale = (request, options) => {
+    const { cookieName, localeSet } = options;
+    return chosenLocalesOf(request, cookieName).find((value) => localeSet.isSupported(value))
+        ?? requestedLocaleOf(request, localeSet)
+        ?? localeSet.fallback;
+};
+exports.resolveLocale = resolveLocale;

package/dist/cjs/translate-function.d.ts

@@ -0,0 +1 @@
+export type TranslateFunction = (key: string, named?: Record<string, unknown>) => string;

package/dist/cjs/translate-function.js

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

package/dist/cjs/vue/i18n-plugin.d.ts

@@ -0,0 +1,20 @@
+import type { App, WritableComputedRef } from 'vue';
+import type { LocaleSetInterface } from '../define-locales.js';
+import type { LocaleDictionary } from '../dictionary.js';
+import type { TranslateFunction } from '../translate-function.js';
+export interface I18nPluginOptionsInterface<L extends string> {
+    localeSet: LocaleSetInterface<L>;
+    messages: LocaleDictionary<L>;
+    moduleDictionaries?: ModuleDictionariesResolver<L>;
+}
+type LocaleReference = WritableComputedRef<string>;
+type ModuleDictionariesResolver<L extends string> = (app: App) => readonly LocaleDictionary<L>[];
+export declare class I18nPlugin<L extends string> {
+    private readonly options;
+    constructor(options: I18nPluginOptionsInterface<L>);
+    install(app: App): void;
+}
+export declare const setLocale: (app: App, locale: string) => void;
+export declare const getLocaleReference: (app: App) => LocaleReference | undefined;
+export declare const getTranslate: (app: App) => TranslateFunction | undefined;
+export {};

package/dist/cjs/vue/i18n-plugin.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTranslate = exports.getLocaleReference = exports.setLocale = exports.I18nPlugin = void 0;
+const vue_i18n_1 = require("vue-i18n");
+const dictionary_js_1 = require("../dictionary.js");
+const localeReferences = new WeakMap();
+const translators = new WeakMap();
+class I18nPlugin {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    install(app) {
+        const { localeSet, messages, moduleDictionaries } = this.options;
+        const dictionaries = moduleDictionaries === undefined
+            ? [messages]
+            : [messages, ...app.runWithContext(() => moduleDictionaries(app))];
+        const i18n = (0, vue_i18n_1.createI18n)({
+            fallbackLocale: localeSet.fallback,
+            legacy: false,
+            locale: localeSet.fallback,
+            messages: (0, dictionary_js_1.composeMessages)(dictionaries, localeSet.locales),
+        });
+        localeReferences.set(app, i18n.global.locale);
+        translators.set(app, (key, named) => i18n.global.t(key, named ?? {}));
+        app.use(i18n);
+    }
+}
+exports.I18nPlugin = I18nPlugin;
+const setLocale = (app, locale) => {
+    const localeReference = localeReferences.get(app);
+    if (localeReference) {
+        localeReference.value = locale;
+    }
+};
+exports.setLocale = setLocale;
+const getLocaleReference = (app) => localeReferences.get(app);
+exports.getLocaleReference = getLocaleReference;
+const getTranslate = (app) => translators.get(app);
+exports.getTranslate = getTranslate;

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

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

package/dist/cjs/vue/index.js

@@ -0,0 +1,19 @@
+"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("./i18n-plugin.js"), exports);
+__exportStar(require("./locale-cookie.js"), exports);
+__exportStar(require("./module-dictionary.js"), exports);

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

@@ -0,0 +1,5 @@
+export interface LocaleCookieOptionsInterface {
+    maxAgeSeconds?: number;
+    name: string;
+}
+export declare const writeLocaleCookie: (locale: string, options: LocaleCookieOptionsInterface) => void;

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

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeLocaleCookie = void 0;
+const DEFAULT_MAX_AGE_SECONDS = 31_536_000;
+const writeLocaleCookie = (locale, options) => {
+    const { maxAgeSeconds = DEFAULT_MAX_AGE_SECONDS, name } = options;
+    globalThis.document.cookie = [
+        `${name}=${locale}`,
+        'Path=/',
+        `Max-Age=${maxAgeSeconds}`,
+        'SameSite=Lax',
+    ].join('; ');
+};
+exports.writeLocaleCookie = writeLocaleCookie;

package/dist/cjs/vue/module-dictionary.d.ts

@@ -0,0 +1,5 @@
+import type { LocaleDictionary } from '../dictionary.js';
+export interface ModuleRegistryInterface {
+    getModules(): Iterable<unknown>;
+}
+export declare const collectModuleDictionaries: <L extends string>(registry: ModuleRegistryInterface | undefined) => LocaleDictionary<L>[];

package/dist/cjs/vue/module-dictionary.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectModuleDictionaries = void 0;
+const isObject = (value) => typeof value === 'object' && value !== null;
+const hasDictionary = (module) => isObject(module) && 'getDictionary' in module;
+const collectModuleDictionaries = (registry) => (registry === undefined
+    ? []
+    : [...registry.getModules()]
+        .filter((module) => hasDictionary(module))
+        .map((module) => module.getDictionary()));
+exports.collectModuleDictionaries = collectModuleDictionaries;

package/dist/esm/define-locales.d.ts

@@ -0,0 +1,10 @@
+export interface LocaleSetInterface<L extends string> {
+    readonly fallback: L;
+    readonly isSupported: LocaleGuard<L>;
+    readonly locales: readonly L[];
+}
+type LocaleGuard<L extends string> = (value: unknown) => value is L;
+export declare const defineLocales: <const T extends readonly [string, ...string[]]>(locales: T, fallback: NoInfer<T[number]>) => {
+    readonly locales: T;
+} & LocaleSetInterface<T[number]>;
+export {};

package/dist/esm/define-locales.js

@@ -0,0 +1,11 @@
+export const defineLocales = (locales, fallback) => {
+    const values = locales;
+    if (!values.includes(fallback)) {
+        throw new RangeError(`Запасная локаль «${fallback}» не входит в набор: ${locales.join(', ')}`);
+    }
+    return {
+        fallback,
+        isSupported: (value) => values.includes(value),
+        locales,
+    };
+};

package/dist/esm/dictionary-provider.interface.d.ts

@@ -0,0 +1,4 @@
+import type { LocaleDictionary } from './dictionary.js';
+export interface DictionaryProviderInterface<L extends string> {
+    getDictionary(): LocaleDictionary<L>;
+}

package/dist/esm/dictionary-provider.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/dictionary.d.ts

@@ -0,0 +1,4 @@
+import type { LocaleMessageValue, VueMessageType } from 'vue-i18n';
+export type LocaleDictionary<L extends string> = Record<L, LocaleMessages>;
+export type LocaleMessages = Record<string, LocaleMessageValue<VueMessageType>>;
+export declare const composeMessages: <L extends string>(dictionaries: readonly LocaleDictionary<L>[], locales: readonly L[]) => LocaleDictionary<L>;

package/dist/esm/dictionary.js

@@ -0,0 +1,9 @@
+export const composeMessages = (dictionaries, locales) => {
+    const merged = new Map(locales.map((locale) => [locale, {}]));
+    for (const [locale, messages] of merged) {
+        for (const dictionary of dictionaries) {
+            Object.assign(messages, dictionary[locale]);
+        }
+    }
+    return Object.fromEntries(merged);
+};

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+export * from './define-locales.js';
+export * from './dictionary.js';
+export * from './dictionary-provider.interface.js';
+export * from './translate-function.js';

package/dist/esm/index.js

@@ -0,0 +1,4 @@
+export * from './define-locales.js';
+export * from './dictionary.js';
+export * from './dictionary-provider.interface.js';
+export * from './translate-function.js';

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

@@ -0,0 +1 @@
+export * from './resolve-locale.js';

package/dist/esm/server/index.js

@@ -0,0 +1 @@
+export * from './resolve-locale.js';

package/dist/esm/server/resolve-locale.d.ts

@@ -0,0 +1,13 @@
+import type { LocaleSetInterface } from '../define-locales.js';
+export interface LocaleRequestInterface {
+    cookies?: Partial<Record<string, string>> | undefined;
+    headers: Partial<Record<string, string | string[]>>;
+    user?: {
+        locale?: null | string;
+    } | undefined;
+}
+export interface ResolveLocaleOptionsInterface<L extends string> {
+    cookieName: string;
+    localeSet: LocaleSetInterface<L>;
+}
+export declare const resolveLocale: <L extends string>(request: LocaleRequestInterface, options: ResolveLocaleOptionsInterface<L>) => L;

package/dist/esm/server/resolve-locale.js

@@ -0,0 +1,44 @@
+const DEFAULT_QUALITY = 1;
+const REJECTED_QUALITY = 0;
+const QUALITY_PATTERN = /(?<=;\s*q=)[^;]*/u;
+const SUBTAGS_AND_PARAMETERS_PATTERN = /[-;].*/u;
+const parseQuality = (range) => {
+    const value = QUALITY_PATTERN.exec(range)?.[0];
+    if (value === undefined) {
+        return DEFAULT_QUALITY;
+    }
+    const quality = Number(value);
+    return Number.isNaN(quality) ? REJECTED_QUALITY : quality;
+};
+const parseLanguageRange = (range) => ({
+    primaryTag: range.replace(SUBTAGS_AND_PARAMETERS_PATTERN, '').trim()
+        .toLowerCase(),
+    quality: parseQuality(range),
+});
+const resolveFromAcceptLanguage = (header, localeSet) => {
+    const ranges = header
+        .split(',')
+        .map((range) => parseLanguageRange(range))
+        .filter((range) => range.quality > REJECTED_QUALITY)
+        .toSorted((left, right) => right.quality - left.quality);
+    for (const range of ranges) {
+        if (localeSet.isSupported(range.primaryTag)) {
+            return range.primaryTag;
+        }
+    }
+    return undefined;
+};
+const requestedLocaleOf = (request, localeSet) => {
+    const header = request.headers['accept-language'];
+    return typeof header === 'string' ? resolveFromAcceptLanguage(header, localeSet) : undefined;
+};
+const chosenLocalesOf = (request, cookieName) => [
+    request.user?.locale,
+    request.cookies?.[cookieName],
+];
+export const resolveLocale = (request, options) => {
+    const { cookieName, localeSet } = options;
+    return chosenLocalesOf(request, cookieName).find((value) => localeSet.isSupported(value))
+        ?? requestedLocaleOf(request, localeSet)
+        ?? localeSet.fallback;
+};

package/dist/esm/translate-function.d.ts

@@ -0,0 +1 @@
+export type TranslateFunction = (key: string, named?: Record<string, unknown>) => string;

package/dist/esm/translate-function.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/vue/i18n-plugin.d.ts

@@ -0,0 +1,20 @@
+import type { App, WritableComputedRef } from 'vue';
+import type { LocaleSetInterface } from '../define-locales.js';
+import type { LocaleDictionary } from '../dictionary.js';
+import type { TranslateFunction } from '../translate-function.js';
+export interface I18nPluginOptionsInterface<L extends string> {
+    localeSet: LocaleSetInterface<L>;
+    messages: LocaleDictionary<L>;
+    moduleDictionaries?: ModuleDictionariesResolver<L>;
+}
+type LocaleReference = WritableComputedRef<string>;
+type ModuleDictionariesResolver<L extends string> = (app: App) => readonly LocaleDictionary<L>[];
+export declare class I18nPlugin<L extends string> {
+    private readonly options;
+    constructor(options: I18nPluginOptionsInterface<L>);
+    install(app: App): void;
+}
+export declare const setLocale: (app: App, locale: string) => void;
+export declare const getLocaleReference: (app: App) => LocaleReference | undefined;
+export declare const getTranslate: (app: App) => TranslateFunction | undefined;
+export {};

package/dist/esm/vue/i18n-plugin.js

@@ -0,0 +1,33 @@
+import { createI18n } from 'vue-i18n';
+import { composeMessages } from '../dictionary.js';
+const localeReferences = new WeakMap();
+const translators = new WeakMap();
+export class I18nPlugin {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    install(app) {
+        const { localeSet, messages, moduleDictionaries } = this.options;
+        const dictionaries = moduleDictionaries === undefined
+            ? [messages]
+            : [messages, ...app.runWithContext(() => moduleDictionaries(app))];
+        const i18n = createI18n({
+            fallbackLocale: localeSet.fallback,
+            legacy: false,
+            locale: localeSet.fallback,
+            messages: composeMessages(dictionaries, localeSet.locales),
+        });
+        localeReferences.set(app, i18n.global.locale);
+        translators.set(app, (key, named) => i18n.global.t(key, named ?? {}));
+        app.use(i18n);
+    }
+}
+export const setLocale = (app, locale) => {
+    const localeReference = localeReferences.get(app);
+    if (localeReference) {
+        localeReference.value = locale;
+    }
+};
+export const getLocaleReference = (app) => localeReferences.get(app);
+export const getTranslate = (app) => translators.get(app);

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

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

package/dist/esm/vue/index.js

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

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

@@ -0,0 +1,5 @@
+export interface LocaleCookieOptionsInterface {
+    maxAgeSeconds?: number;
+    name: string;
+}
+export declare const writeLocaleCookie: (locale: string, options: LocaleCookieOptionsInterface) => void;

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

@@ -0,0 +1,10 @@
+const DEFAULT_MAX_AGE_SECONDS = 31_536_000;
+export const writeLocaleCookie = (locale, options) => {
+    const { maxAgeSeconds = DEFAULT_MAX_AGE_SECONDS, name } = options;
+    globalThis.document.cookie = [
+        `${name}=${locale}`,
+        'Path=/',
+        `Max-Age=${maxAgeSeconds}`,
+        'SameSite=Lax',
+    ].join('; ');
+};

package/dist/esm/vue/module-dictionary.d.ts

@@ -0,0 +1,5 @@
+import type { LocaleDictionary } from '../dictionary.js';
+export interface ModuleRegistryInterface {
+    getModules(): Iterable<unknown>;
+}
+export declare const collectModuleDictionaries: <L extends string>(registry: ModuleRegistryInterface | undefined) => LocaleDictionary<L>[];

package/dist/esm/vue/module-dictionary.js

@@ -0,0 +1,7 @@
+const isObject = (value) => typeof value === 'object' && value !== null;
+const hasDictionary = (module) => isObject(module) && 'getDictionary' in module;
+export const collectModuleDictionaries = (registry) => (registry === undefined
+    ? []
+    : [...registry.getModules()]
+        .filter((module) => hasDictionary(module))
+        .map((module) => module.getDictionary()));

package/package.json

@@ -1,6 +1,90 @@
 {
   "name": "@application-kit/i18n",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Локали, словари и плагин vue-i18n для SSR-приложений на Vue и серверный резолв локали запроса",
+  "keywords": [
+    "i18n",
+    "locale",
+    "ssr",
+    "vue",
+    "vue-i18n"
+  ],
+  "homepage": "https://gitlab.com/application-kit/application-kit/-/tree/main/packages/i18n",
+  "bugs": "https://gitlab.com/application-kit/application-kit/-/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/application-kit/application-kit.git",
+    "directory": "packages/i18n"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "application-kit"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./package.json": "./package.json",
+    "./server": {
+      "import": {
+        "types": "./dist/esm/server/index.d.ts",
+        "default": "./dist/esm/server/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/server/index.d.ts",
+        "default": "./dist/cjs/server/index.js"
+      }
+    },
+    "./vue": {
+      "import": {
+        "types": "./dist/esm/vue/index.d.ts",
+        "default": "./dist/esm/vue/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/vue/index.d.ts",
+        "default": "./dist/cjs/vue/index.js"
+      }
+    }
+  },
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/cjs/index.d.ts",
+  "files": [
+    "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",
+    "lint:tsc": "tsc --noEmit --pretty --project .",
+    "test:mutation": "stryker run",
+    "test:unit": "vitest run"
+  },
+  "devDependencies": {
+    "@stryker-mutator/core": "^10.0.0",
+    "@stryker-mutator/vitest-runner": "^10.0.0",
+    "@types/node": "^26.2.0",
+    "jsdom": "^30.0.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.11",
+    "vue": "^3.5.41",
+    "vue-i18n": "^11.4.10"
+  },
+  "peerDependencies": {
+    "vue": "^3.5.0",
+    "vue-i18n": "^11.0.0"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }