@feugene/fint-i18n 0.2.0 → 0.2.1

package/README.md

@@ -25,6 +25,7 @@ You can find detailed information about the library in the relevant sections:
 
 - 📦 **[Installation and Getting Started](./docs/en/installation.md)**: How to install the package and configure it in a Vue application.
 - 📂 **[Defining Messages](./docs/en/defining-messages.md)**: JSON formats, loaders, and dynamic merging.
+- 🌐 **[Authoring localization packages](./docs/en/authoring-localization-packages.md)**: Per-locale export contract for tree-shakable donor packages.
 - 🚀 **[Usage](./docs/en/usage.md)**: How to use `t()`, `$t`, and the `v-t` directive.
 - 📘 **[API Reference](./docs/en/api.md)**: Detailed description of all functions, methods, and composables.
 - 🔌 **[Plugins](./docs/en/plugins.md)**: Extending functionality via the hook system and built-in plugins.
@@ -41,13 +42,14 @@ You can find detailed information about the library in the relevant sections:
 import { createApp } from 'vue'
 import { createFintI18n } from '@feugene/fint-i18n/core'
 import { installI18n } from '@feugene/fint-i18n/vue'
-import { appLocaleLoaders } from './i18n/messages'
-import { fintDsLocaleLoaders } from '@feugene/fint-ds/i18n'
-
+import { en as appEn, ru as appRu } from './i18n/messages'
+import { en as granularityEn, ru as granularityRu } from '@feugene/granularity/i18n'
 const i18n = createFintI18n({
   locale: 'en',
   fallbackLocale: 'en',
-  loaders: [appLocaleLoaders, fintDsLocaleLoaders],
+  // Import only the locales the application actually ships — bundlers will
+  // tree-shake the rest out of the final build.
+  loaders: [appEn, appRu, granularityEn, granularityRu],
 })
 
 const app = createApp(App)

package/README.ru.md

@@ -20,6 +20,7 @@
 
 - 📦 **[Установка и начало работы](./docs/ru/installation.md)**: Как установить пакет и настроить его в приложении Vue.
 - 📂 **[Определение сообщений](./docs/ru/defining-messages.md)**: Форматы JSON, лоадеры и динамический мердж.
+- 🌐 **[Гайд для авторов локализационных пакетов](./docs/ru/authoring-localization-packages.md)**: Контракт per-locale экспортов для tree-shakable пакетов-доноров.
 - 🚀 **[Использование](./docs/ru/usage.md)**: Как использовать `t()`, `$t` и директиву `v-t`.
 - 📘 **[Справочник API](./docs/ru/api.md)**: Подробное описание всех функций, методов и композаблов.
 - 🔌 **[Плагины](./docs/ru/plugins.md)**: Расширение функционала через систему хуков и встроенные плагины.
@@ -36,13 +37,14 @@
 import { createApp } from 'vue'
 import { createFintI18n } from '@feugene/fint-i18n/core'
 import { installI18n } from '@feugene/fint-i18n/vue'
-import { appLocaleLoaders } from './i18n/messages'
-import { fintDsLocaleLoaders } from '@feugene/fint-ds/i18n'
-
+import { en as appEn, ru as appRu } from './i18n/messages'
+import { en as granularityEn, ru as granularityRu } from '@feugene/granularity/i18n'
 const i18n = createFintI18n({
   locale: 'en',
   fallbackLocale: 'en',
-  loaders: [appLocaleLoaders, fintDsLocaleLoaders],
+  // Импортируйте только те локали, которые реально нужны приложению —
+  // остальные сборщик удалит при tree-shaking.
+  loaders: [appEn, appRu, granularityEn, granularityRu],
 })
 
 const app = createApp(App)

package/dist/types/vue/plugin.d.ts

@@ -1,5 +1,15 @@
 import type { App } from 'vue';
 import type { FintI18n } from '@/core';
-export declare function installI18n(app: App, i18n: FintI18n, options?: {
+export type GlobalInstallFn = (app: App, i18n: FintI18n) => void;
+export interface InstallI18nOptions {
     directive?: string | boolean;
-}): void;
+    /**
+     * Управляет регистрацией глобальных свойств ($t, $i18n).
+     * - функция: вызывается вместо стандартной регистрации;
+     * - `true`: выполняется стандартная регистрация (по умолчанию, если у инстанса `globalInstall === true`);
+     * - `false`: ничего не происходит.
+     * Если опция не передана — используется значение `i18n.globalInstall`.
+     */
+    globalInstall?: boolean | GlobalInstallFn;
+}
+export declare function installI18n(app: App, i18n: FintI18n, options?: InstallI18nOptions): void;

package/dist/vue.js

@@ -42,10 +42,15 @@ function o(e, t, n) {
 }
 //#endregion
 //#region src/vue/plugin.ts
-function s(e, t, r = {}) {
-	e.provide(n, t), t.globalInstall && (e.config.globalProperties.$t = t.t, e.config.globalProperties.$i18n = t);
-	let i = r.directive === !1 ? null : typeof r.directive == "string" ? r.directive : "t";
-	i && e.directive(i, a(t));
+function s(e, t) {
+	e.config.globalProperties.$t = t.t, e.config.globalProperties.$i18n = t;
+}
+function c(e, t, r = {}) {
+	e.provide(n, t);
+	let i = r.globalInstall ?? t.globalInstall;
+	typeof i == "function" ? i(e, t) : i && s(e, t);
+	let o = r.directive === !1 ? null : typeof r.directive == "string" ? r.directive : "t";
+	o && e.directive(o, a(t));
 }
 //#endregion
-export { n as FINT_I18N_KEY, a as createVTDirective, s as installI18n, r as useFintI18n, i as useI18nScope };
+export { n as FINT_I18N_KEY, a as createVTDirective, c as installI18n, r as useFintI18n, i as useI18nScope };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feugene/fint-i18n",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Lightweight Vue 3 i18n library with lazy-loading blocks and template caching",
   "author": "feugene <feugene@example.com>",
   "license": "MIT",