@feugene/fint-i18n 0.2.0 → 0.2.2

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/chunks/{core-gGqMvw8y.js → core-CJdrAmJT.js}

@@ -190,7 +190,6 @@ function m(t) {
 var h = class {
 	locale;
 	fallbackLocale;
-	globalInstall;
 	messages = t({});
 	compiledMessages = Object.create(null);
 	loaderRegistry;
@@ -202,7 +201,7 @@ var h = class {
 	skipNextUsedBlockLoadLocale = null;
 	hooks = new a();
 	constructor(e) {
-		this.locale = n(e.locale), this.fallbackLocale = e.fallbackLocale || "", this.loaderRegistry = new l(e.loaders), this.globalInstall = e.globalInstall !== !1, e.plugins && e.plugins.forEach((e) => e.install(this)), r(this.locale, (e, t) => {
+		this.locale = n(e.locale), this.fallbackLocale = e.fallbackLocale || "", this.loaderRegistry = new l(e.loaders), e.plugins && e.plugins.forEach((e) => e.install(this)), r(this.locale, (e, t) => {
 			if (e !== t) {
 				if (this.skipNextUsedBlockLoadLocale === e) {
 					this.skipNextUsedBlockLoadLocale = null;

package/dist/core.js

@@ -1,2 +1,2 @@
-import { i as e, n as t, r as n, t as r } from "./chunks/core-gGqMvw8y.js";
+import { i as e, n as t, r as n, t as r } from "./chunks/core-CJdrAmJT.js";
 export { r as FintI18n, n as HookManager, e as compileTemplate, t as createFintI18n };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { i as e, n as t, r as n, t as r } from "./chunks/core-gGqMvw8y.js";
+import { i as e, n as t, r as n, t as r } from "./chunks/core-CJdrAmJT.js";
 import { FINT_I18N_KEY as i, createVTDirective as a, installI18n as o, useFintI18n as s, useI18nScope as c } from "./vue.js";
 import { BridgePlugin as l, HookLoggerPlugin as u, PersistencePlugin as d } from "./plugins.js";
 export { l as BridgePlugin, i as FINT_I18N_KEY, r as FintI18n, u as HookLoggerPlugin, n as HookManager, d as PersistencePlugin, e as compileTemplate, t as createFintI18n, a as createVTDirective, o as installI18n, s as useFintI18n, c as useI18nScope };

package/dist/types/core/instance.d.ts

@@ -4,7 +4,6 @@ import type { FintI18nOptions, Locale, MessageValue, TranslateOptions } from './
 export declare class FintI18n {
     locale: Ref<Locale>;
     fallbackLocale: Locale;
-    globalInstall: boolean;
     readonly messages: Record<Locale, any>;
     private compiledMessages;
     private readonly loaderRegistry;

package/dist/types/core/types.d.ts

@@ -14,7 +14,6 @@ export interface FintI18nOptions {
     fallbackLocale?: Locale;
     loaders?: LocaleLoaderSource;
     plugins?: FintI18nPlugin[];
-    globalInstall?: boolean;
 }
 export type MessagePrimitive = string | number | boolean;
 export interface MessageSchema {

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

@@ -1,5 +1,14 @@
 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` (по умолчанию): выполняется стандартная регистрация;
+     * - `false`: ничего не происходит.
+     */
+    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 ?? !0;
+	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.2",
   "description": "Lightweight Vue 3 i18n library with lazy-loading blocks and template caching",
   "author": "feugene <feugene@example.com>",
   "license": "MIT",