@comvi/vue 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present Comvi (https://comvi.io)
+
+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

@@ -0,0 +1,277 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="../../.github/assets/header-logo-dark.png">
+    <img alt="Comvi" src="../../.github/assets/header-logo-light.png" width="860">
+  </picture>
+</p>
+
+<h1 align="center">@comvi/vue</h1>
+
+<p align="center">Vue 3 binding for Comvi i18n — plugin, composable, and <code>&lt;T&gt;</code> component.</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@comvi/vue"><img src="https://img.shields.io/npm/v/@comvi/vue?color=blue" alt="npm"></a>
+  <a href="https://bundlejs.com/?q=%40comvi%2Fvue"><img src="https://deno.bundlejs.com/?q=@comvi/vue&badge=&badge-style=flat&badge-raster" alt="Bundle size"></a>
+  <a href="https://github.com/comvi-io/comvi-js/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
+</p>
+
+---
+
+`@comvi/vue` wraps [`@comvi/core`](../core) for Vue 3. `app.use(i18n)` installs `$t` and `$i18n` global properties; `useI18n()` returns reactive refs that integrate with Vue's reactivity system.
+
+Same `t()` and `<T>` API as the [React](../react), [SolidJS](../solid), and [Svelte](../svelte) bindings — switch frameworks without relearning your i18n layer.
+
+For Nuxt 3, use [`@comvi/nuxt`](../nuxt) — it adds SSR, locale routing, and auto-imports on top of this package.
+
+📖 **Documentation:** https://comvi.io/docs/i18n/vue/
+
+## Why Comvi i18n?
+
+Comvi i18n is a modern, framework-agnostic internationalization library built on three principles: type-safe translations, real ICU MessageFormat, and zero compromises on bundle size or security.
+
+- **Rich text without XSS.** Embed components inside translation strings (`Click <link>here</link>`) — translators see clean markup, you decide what each tag renders to. No raw HTML, no unsafe DOM injection, no splitting a sentence across template fragments.
+- **Real ICU MessageFormat.** Plurals, ordinals, and select all follow locale-correct grammar via `Intl.PluralRules` — Polish, Ukrainian, Arabic, Welsh, and the rest. Same syntax every major TMS (Crowdin, Lokalise, Phrase) already speaks.
+- **Locale-aware formatters built in.** `formatNumber`, `formatDate`, `formatCurrency`, and `formatRelativeTime` follow the active locale via native `Intl`, with reactive updates in every framework binding.
+- **~8 kB gzipped, zero runtime dependencies.** No `eval` or `new Function` anywhere — runs under a strict CSP without `unsafe-eval`. Safe for Chrome extensions, Cloudflare Workers, and locked-down enterprise apps.
+- **Pluggable, not monolithic.** Translation loading (CDN/API), locale detection, and in-context editing are opt-in plugins via `@comvi/plugin-fetch-loader`, `@comvi/plugin-locale-detector`, and `@comvi/plugin-in-context-editor`. You only ship what you use.
+- **Same API across 6 frameworks.** `useI18n()` and `<T>` look the same in [Vue](https://www.npmjs.com/package/@comvi/vue), [React](https://www.npmjs.com/package/@comvi/react), [SolidJS](https://www.npmjs.com/package/@comvi/solid), [Svelte](https://www.npmjs.com/package/@comvi/svelte), [Next.js](https://www.npmjs.com/package/@comvi/next), and [Nuxt](https://www.npmjs.com/package/@comvi/nuxt) — switch frameworks without relearning your i18n layer.
+
+## Why @comvi/vue?
+
+- **Reactivity first.** `useI18n()` returns Vue refs and computed properties — changes to language or translations trigger precise re-renders without manual store subscriptions.
+- **Template-native API.** `<T>` component uses named slots for tag interpolation; `$t` template helper and `$i18n` global property eliminate boilerplate in Options API code.
+- **Single plugin, both APIs.** One `app.use(i18n)` install works seamlessly with Composition API, Options API, and component templates.
+
+## Install
+
+```bash
+npm install @comvi/vue
+# Peer: vue ^3.0.0
+```
+
+## Quick start
+
+```ts
+// main.ts
+import { createApp } from "vue";
+import { createI18n } from "@comvi/vue";
+import App from "./App.vue";
+
+const i18n = createI18n({
+  locale: "en",
+  fallbackLocale: "en",
+  translation: {
+    en: { greeting: "Hello, {name}!" },
+    uk: { greeting: "Привіт, {name}!" },
+  },
+});
+
+createApp(App).use(i18n).mount("#app");
+```
+
+```vue
+<!-- App.vue -->
+<script setup lang="ts">
+import { useI18n } from "@comvi/vue";
+const { t, locale, setLocale } = useI18n();
+</script>
+
+<template>
+  <h1>{{ t("greeting", { name: "Alice" }) }}</h1>
+  <select :value="locale" @change="setLocale(($event.target as HTMLSelectElement).value)">
+    <option value="en">English</option>
+    <option value="uk">Українська</option>
+  </select>
+</template>
+```
+
+For the `<T>` component (rich text with slot-based tag interpolation), `$t` template helper, type-safe keys, and the full composable API, see the [documentation](https://comvi.io/docs/i18n/vue/).
+
+## Rich text with `<T>`
+
+Embed components inside translation strings without raw HTML, without unsafe DOM injection. Translators see clean markup; you control the rendering via named slots.
+
+```json
+{ "help": "Read <link>our docs</link> or <bold>contact us</bold>." }
+```
+
+```vue
+<script setup lang="ts">
+import { T } from "@comvi/vue";
+</script>
+
+<template>
+  <T i18nKey="help">
+    <template #link="{ children }">
+      <a href="/docs">{{ children }}</a>
+    </template>
+    <template #bold="{ children }">
+      <strong>{{ children }}</strong>
+    </template>
+  </T>
+</template>
+```
+
+Alternatively, use the `components` prop for programmatic tag handling. Pass `tagInterpolation: { strict: "warn" }` to `createI18n` to catch translations referencing tags you forgot to handle before they ship.
+
+## ICU MessageFormat — locale-correct grammar, not just singular/plural
+
+`count === 1 ? "item" : "items"` works in English. It silently ships broken grammar in Polish, Ukrainian, Arabic, Welsh, and 30+ other locales — those languages have 3, 4, sometimes 6 distinct plural categories that a binary if/else can't express. [ICU MessageFormat](https://unicode-org.github.io/icu/userguide/format_parse/messages/) is the standard syntax for handling them — the same syntax Crowdin, Lokalise, Phrase, and every major TMS already speak. Comvi i18n parses it via native [`Intl.PluralRules`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/PluralRules), so every CLDR plural category is correct by default.
+
+### Plurals across languages
+
+```json
+{
+  "en": { "messages": "{count, plural, one {# message} other {# messages}}" },
+  "uk": {
+    "messages": "{count, plural, one {# повідомлення} few {# повідомлення} many {# повідомлень} other {# повідомлення}}"
+  },
+  "ar": {
+    "messages": "{count, plural, zero {لا توجد رسائل} one {رسالة واحدة} two {رسالتان} few {# رسائل} many {# رسالة} other {# رسالة}}"
+  }
+}
+```
+
+```ts
+t("messages", { count: 0 }); // ar: "لا توجد رسائل"      (zero form)
+t("messages", { count: 1 }); // en: "1 message"            uk: "1 повідомлення"
+t("messages", { count: 5 }); // en: "5 messages"           uk: "5 повідомлень"          ar: "5 رسائل"
+t("messages", { count: 22 }); // uk: "22 повідомлення"  ← the "few" form, NOT the "many" form
+```
+
+A naive English-style `count === 1 ? singular : plural` picks one Ukrainian form and ships it for every count — grammatically wrong for half your traffic.
+
+### Ordinals (1st, 2nd, 3rd…)
+
+```json
+{ "rank": "{place, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}" }
+```
+
+```ts
+t("rank", { place: 1 }); // "1st"
+t("rank", { place: 22 }); // "22nd"
+t("rank", { place: 113 }); // "113th"
+```
+
+### Select (gender, role, status)
+
+```json
+{ "greeting": "{gender, select, female {Welcome, madam} male {Welcome, sir} other {Welcome}}" }
+```
+
+```ts
+t("greeting", { gender: "female" }); // "Welcome, madam"
+t("greeting", { gender: "male" }); // "Welcome, sir"
+t("greeting", { gender: "other" }); // "Welcome"
+```
+
+### Locale-aware Intl formatters
+
+Numbers, dates, currency, and relative time follow the active locale via native `Intl` — reactive in your framework binding:
+
+```vue
+<script setup lang="ts">
+import { useI18n } from "@comvi/vue";
+
+const { t, locale, setLocale, formatCurrency, formatRelativeTime, formatDate } = useI18n();
+</script>
+
+<template>
+  <div>
+    <!-- Locale-aware plurals -->
+    <p>{{ t("items", { count: 5 }) }}</p>
+
+    <!-- Locale-aware Intl formatters — re-render when setLocale() is called -->
+    <p>Price: {{ formatCurrency(99.99, "USD") }}</p>
+    <p>Posted {{ formatRelativeTime(-2, "hour") }}</p>
+    <p>Date: {{ formatDate(new Date(), { dateStyle: "long" }) }}</p>
+
+    <select :value="locale" @change="setLocale(($event.target as HTMLSelectElement).value)">
+      <option value="en">English</option>
+      <option value="fr">Français</option>
+    </select>
+  </div>
+</template>
+```
+
+Switching locale via `setLocale()` re-renders all formatters automatically through Vue's reactivity.
+
+## Type-safe translation keys
+
+Declaration merging on `TranslationKeys` provides autocomplete and parameter validation per key. Generated automatically via `@comvi/cli` (TMS) or `@comvi/vite-plugin` (local JSON).
+
+```typescript
+// src/types/i18n.d.ts
+declare module "@comvi/core" {
+  interface TranslationKeys {
+    welcome: { name: string };
+    greeting: never;
+    "errors:NOT_FOUND": never;
+  }
+}
+```
+
+```vue
+<script setup lang="ts">
+import { useI18n } from "@comvi/vue";
+
+const { t } = useI18n();
+
+// ✓ Autocomplete works, params required
+t("welcome", { name: "Alice" });
+
+// ✓ No params needed
+t("greeting");
+
+// ✓ Namespaced keys use the ns option
+t("NOT_FOUND", { ns: "errors" });
+</script>
+```
+
+**What TypeScript catches:**
+
+```ts
+// ✗ Expected 2 arguments, but got 1
+t("welcome");
+
+// ✗ Property 'name' is missing in type '{ age: number }'
+t("welcome", { age: 5 });
+
+// ✗ Type 'number' is not assignable to type 'string'
+t("welcome", { name: 42 });
+
+// ✗ Argument of type '"typo"' is not assignable to parameter
+t("typo", { name: "Alice" });
+```
+
+## Loading translations from the Comvi platform
+
+Pair with `@comvi/plugin-fetch-loader` to load translations from a CDN or API. No redeploy needed to ship a translation:
+
+```ts
+// main.ts
+import { createApp } from "vue";
+import { createI18n } from "@comvi/vue";
+import { FetchLoader } from "@comvi/plugin-fetch-loader";
+import App from "./App.vue";
+
+const i18n = createI18n({
+  locale: "en",
+  defaultNs: "common",
+});
+
+// CDN for production, API for dev/staging
+i18n.use(
+  FetchLoader({
+    cdnUrl: "https://cdn.comvi.io/your-distribution-id",
+  }),
+);
+
+createApp(App).use(i18n).mount("#app");
+```
+
+See [`@comvi/plugin-fetch-loader`](https://github.com/comvi-io/comvi-js/tree/main/packages/plugin-fetch-loader) for full options and API endpoints.
+
+## License
+
+[MIT](https://github.com/comvi-io/comvi-js/blob/main/LICENSE) © Comvi

package/dist/VueI18n.d.ts

@@ -0,0 +1,96 @@
+import { I18n, I18nOptions, FlattenedTranslations, TranslationParams, TranslationResult, TranslationValue, I18nPlugin, I18nEvent, I18nEventData } from '@comvi/core';
+import { Ref, App } from 'vue';
+/**
+ * Vue-specific i18n options extending core options
+ */
+export interface VueI18nOptions extends I18nOptions {
+    /** @deprecated Use locale. */
+    language?: string;
+    /**
+     * Initial locale for SSR hydration.
+     * Use this to prevent hydration mismatches when server renders with a different
+     * locale than what the client would detect.
+     */
+    ssrLanguage?: string;
+}
+/**
+ * Vue-specific wrapper around the core I18n using composition
+ * Provides Vue reactivity integration and plugin installation
+ */
+export declare class VueI18n {
+    private _core;
+    private _locale;
+    private _localeComputed?;
+    private _isLoading;
+    private _isInitializing;
+    private _cacheRevision;
+    private _translationCacheRef;
+    private _unsubscribers;
+    private _requestedLocale;
+    private _localeQueue;
+    private _isLocaleQueueIdle;
+    private _isDestroyed;
+    addTranslations: (translations: Record<string, Record<string, TranslationValue>>) => void;
+    addActiveNamespace: (namespace: string) => Promise<void>;
+    clearTranslations: (language?: string, namespace?: string) => void;
+    reloadTranslations: (language?: string, namespace?: string) => Promise<void>;
+    registerLoader: (loader: Parameters<I18n["registerLoader"]>[0]) => void;
+    registerLocaleDetector: (detector: () => string | Promise<string>) => void;
+    registerPostProcessor: (processor: (result: TranslationResult, key: string, namespace: string, params?: TranslationParams) => TranslationResult) => void;
+    onMissingKey: (callback: (key: string, locale: string, namespace: string) => TranslationResult | void) => () => void;
+    onLoadError: (callback: (locale: string, namespace: string, error: Error) => void) => () => void;
+    on: <E extends I18nEvent>(event: E, callback: (payload: I18nEventData[E]) => void) => () => void;
+    hasLocale: (locale: string, namespace?: string) => boolean;
+    hasTranslation: (key: string, locale?: string, namespace?: string, checkFallbacks?: boolean) => boolean;
+    getLoadedLocales: () => string[];
+    setFallbackLocale: (locales: string | string[]) => void;
+    getDefaultNamespace: () => string;
+    reportError: (error: unknown, context?: Parameters<I18n["reportError"]>[1]) => void;
+    getActiveNamespaces: () => string[];
+    formatNumber: I18n["formatNumber"];
+    formatDate: I18n["formatDate"];
+    formatCurrency: I18n["formatCurrency"];
+    formatRelativeTime: I18n["formatRelativeTime"];
+    constructor(options: VueI18nOptions);
+    get locale(): Ref<string>;
+    set locale(value: string);
+    private _dirComputed?;
+    /** Text direction for the current locale, as a reactive computed ref */
+    get dir(): import('vue').ComputedRef<"ltr" | "rtl">;
+    setLocale(locale: string): Promise<void>;
+    get translationCache(): Readonly<Ref<Readonly<ReadonlyMap<string, FlattenedTranslations>>>>;
+    get isLoading(): Readonly<Ref<boolean>>;
+    get isInitializing(): Readonly<Ref<boolean>>;
+    /** Raw translation result for rich text renderers and advanced integrations. */
+    tRaw<NS extends import('@comvi/core').Namespaces, K extends import('@comvi/core').NamespacedKeys<NS>>(key: K, ...params: import('@comvi/core').NamespacedParamsArg<NS, K>): TranslationResult;
+    /** Raw translation result for typed keys. */
+    tRaw<K extends import('@comvi/core').DefaultNsKeys>(key: K, ...params: import('@comvi/core').ParamsArg<K>): TranslationResult;
+    /** Raw translation result for permissive keys. */
+    tRaw(key: import('@comvi/core').PermissiveKey, params?: import('@comvi/core').TranslationParams): TranslationResult;
+    /**
+     * Translate a namespaced key (when ns is provided). Always returns plain text.
+     */
+    t<NS extends import('@comvi/core').Namespaces, K extends import('@comvi/core').NamespacedKeys<NS>>(key: K, ...params: import('@comvi/core').NamespacedParamsArg<NS, K>): string;
+    /**
+     * Translate a key with Vue reactivity tracking - typed keys. Always returns plain text.
+     */
+    t<K extends import('@comvi/core').DefaultNsKeys>(key: K, ...params: import('@comvi/core').ParamsArg<K>): string;
+    /**
+     * Permissive overload - only active when TranslationKeys is empty. Always returns plain text.
+     */
+    t(key: import('@comvi/core').PermissiveKey, params?: import('@comvi/core').TranslationParams): string;
+    init(): Promise<this>;
+    use(plugin: I18nPlugin, options?: Parameters<I18n["use"]>[1]): this;
+    destroy(): void;
+    private _installedApps;
+    install(app: App): void;
+}
+export declare function createI18n(options: VueI18nOptions): VueI18n;
+declare module "vue" {
+    interface ComponentCustomProperties {
+        $t: VueI18n["t"];
+        $tRaw: VueI18n["tRaw"];
+        $i18n: VueI18n;
+    }
+}
+//# sourceMappingURL=VueI18n.d.ts.map

package/dist/VueI18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VueI18n.d.ts","sourceRoot":"","sources":["../src/VueI18n.ts"],"names":[],"mappings":"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"}

package/dist/components/T.d.ts

@@ -0,0 +1,185 @@
+import { PropType, Component, VNode } from 'vue';
+/**
+ * Component handler types for the `components` prop
+ */
+type ComponentHandler = string | Component | {
+    component: string | Component;
+    props?: Record<string, unknown>;
+};
+/**
+ * Components prop type for tag interpolation
+ */
+type ComponentsMap = Record<string, ComponentHandler>;
+/**
+ * Translation component for Vue
+ * Renders translated content with support for slots and components prop as tag handlers
+ *
+ * @example
+ * ```vue
+ * <!-- Simple usage -->
+ * <T i18nKey="greeting" />
+ *
+ * <!-- With parameters -->
+ * <T i18nKey="welcome" :params="{ name: 'John' }" />
+ *
+ * <!-- With tag interpolation using slots -->
+ * <T i18nKey="welcome_link">
+ *   <template #link="{ children }">
+ *     <a href="/help">{{ children }}</a>
+ *   </template>
+ * </T>
+ *
+ * <!-- With tag interpolation using components prop -->
+ * <T
+ *   i18nKey="welcome_link"
+ *   :components="{
+ *     link: { component: 'a', props: { href: '/help' } },
+ *     bold: 'strong'
+ *   }"
+ * />
+ *
+ * <!-- With specific namespace -->
+ * <T i18nKey="button.submit" ns="forms" />
+ *
+ * <!-- With specific locale -->
+ * <T i18nKey="greeting" locale="fr" />
+ * ```
+ */
+export declare const T: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    /**
+     * Translation key to look up
+     */
+    i18nKey: {
+        type: StringConstructor;
+        required: true;
+    };
+    /**
+     * Parameters for interpolation
+     * These will be merged with slot content
+     */
+    params: {
+        type: PropType<Record<string, unknown>>;
+        default: () => {};
+    };
+    /**
+     * Namespace to use (optional)
+     * If not specified, uses the default namespace
+     */
+    ns: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /**
+     * Specific locale to use (optional)
+     * If not specified, uses the current locale
+     */
+    locale: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /**
+     * Fallback text to display if translation is missing (optional)
+     * If not specified, returns the key itself
+     */
+    fallback: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /**
+     * Skip post-processing (optional)
+     * When true, prevents post-processors like IncontextEditor from adding invisible marker characters
+     */
+    raw: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    /**
+     * Components map for tag interpolation (optional)
+     * Maps tag names to their handlers (string tag name, component, or config object)
+     *
+     * @example
+     * {
+     *   bold: 'strong',                              // HTML tag name
+     *   link: { component: 'a', props: { href: '#' } }, // With props
+     *   btn: MyButton                                 // Vue component
+     * }
+     */
+    components: {
+        type: PropType<ComponentsMap>;
+        default: undefined;
+    };
+}>, () => string | (string | VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}>)[], {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    /**
+     * Translation key to look up
+     */
+    i18nKey: {
+        type: StringConstructor;
+        required: true;
+    };
+    /**
+     * Parameters for interpolation
+     * These will be merged with slot content
+     */
+    params: {
+        type: PropType<Record<string, unknown>>;
+        default: () => {};
+    };
+    /**
+     * Namespace to use (optional)
+     * If not specified, uses the default namespace
+     */
+    ns: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /**
+     * Specific locale to use (optional)
+     * If not specified, uses the current locale
+     */
+    locale: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /**
+     * Fallback text to display if translation is missing (optional)
+     * If not specified, returns the key itself
+     */
+    fallback: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /**
+     * Skip post-processing (optional)
+     * When true, prevents post-processors like IncontextEditor from adding invisible marker characters
+     */
+    raw: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    /**
+     * Components map for tag interpolation (optional)
+     * Maps tag names to their handlers (string tag name, component, or config object)
+     *
+     * @example
+     * {
+     *   bold: 'strong',                              // HTML tag name
+     *   link: { component: 'a', props: { href: '#' } }, // With props
+     *   btn: MyButton                                 // Vue component
+     * }
+     */
+    components: {
+        type: PropType<ComponentsMap>;
+        default: undefined;
+    };
+}>> & Readonly<{}>, {
+    locale: string;
+    params: Record<string, unknown>;
+    ns: string;
+    fallback: string;
+    raw: boolean;
+    components: ComponentsMap;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export {};
+//# sourceMappingURL=T.d.ts.map

package/dist/components/T.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"T.d.ts","sourceRoot":"","sources":["../../src/components/T.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,KAAK,EACX,MAAM,KAAK,CAAC;AAiBb;;GAEG;AACH,KAAK,gBAAgB,GACjB,MAAM,GACN,SAAS,GACT;IACE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEN;;GAEG;AACH,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAYtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,CAAC;IAGV;;OAEG;;;;;IAMH;;;OAGG;;cAEe,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;;;IAInD;;;OAGG;;;;;IAMH;;;OAGG;;;;;IAMH;;;OAGG;;;;;IAMH;;;OAGG;;;;;IAMH;;;;;;;;;;OAUG;;cAEe,QAAQ,CAAC,aAAa,CAAC;;;;;;IAjEzC;;OAEG;;;;;IAMH;;;OAGG;;cAEe,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;;;IAInD;;;OAGG;;;;;IAMH;;;OAGG;;;;;IAMH;;;OAGG;;;;;IAMH;;;OAGG;;;;;IAMH;;;;;;;;;;OAUG;;cAEe,QAAQ,CAAC,aAAa,CAAC;;;;;;;;;;4EAqJ3C,CAAC"}

package/dist/composables/useI18n.d.ts

@@ -0,0 +1,75 @@
+import { Ref } from 'vue';
+import { TranslationParams, TranslationResult, FlattenedTranslations, TranslationValue, I18nEvent, I18nEventData, I18n } from '@comvi/core';
+export interface UseI18nReturn {
+    /** Translation function - namespaced keys (when ns is provided). Always returns plain text. */
+    t<NS extends import('@comvi/core').Namespaces, K extends import('@comvi/core').NamespacedKeys<NS>>(key: K, ...params: import('@comvi/core').NamespacedParamsArg<NS, K>): string;
+    /** Translation function - typed keys (default namespace only, use ns option for others). */
+    t<K extends import('@comvi/core').DefaultNsKeys>(key: K, ...params: import('@comvi/core').ParamsArg<K>): string;
+    /** Permissive overload - only active when TranslationKeys is empty */
+    t(key: import('@comvi/core').PermissiveKey, params?: TranslationParams): string;
+    /** Raw translation result for rich text renderers and advanced integrations. */
+    tRaw<NS extends import('@comvi/core').Namespaces, K extends import('@comvi/core').NamespacedKeys<NS>>(key: K, ...params: import('@comvi/core').NamespacedParamsArg<NS, K>): TranslationResult;
+    /** Raw translation result for typed keys. */
+    tRaw<K extends import('@comvi/core').DefaultNsKeys>(key: K, ...params: import('@comvi/core').ParamsArg<K>): TranslationResult;
+    /** Raw translation result for permissive keys. */
+    tRaw(key: import('@comvi/core').PermissiveKey, params?: TranslationParams): TranslationResult;
+    /** Current locale (reactive Vue Ref) */
+    locale: Ref<string>;
+    /** Set locale asynchronously */
+    setLocale: (locale: string) => Promise<void>;
+    /** Translation cache (stable readonly ref with manual triggers, no cloning) */
+    translationCache: Readonly<Ref<Readonly<ReadonlyMap<string, FlattenedTranslations>>>>;
+    /** Loading state (readonly reactive Vue Ref) */
+    isLoading: Readonly<Ref<boolean>>;
+    /** Initializing state (readonly reactive Vue Ref) */
+    isInitializing: Readonly<Ref<boolean>>;
+    /** Add translations programmatically at runtime */
+    addTranslations: (translations: Record<string, Record<string, TranslationValue>>) => void;
+    /** Load a new namespace dynamically */
+    addActiveNamespace: (namespace: string) => Promise<void>;
+    /** Configure fallback locale chain */
+    setFallbackLocale: (locales: string | string[]) => void;
+    /** Register callback for missing keys */
+    onMissingKey: (callback: (key: string, locale: string, namespace: string) => TranslationResult | void) => () => void;
+    /** Register callback for load errors */
+    onLoadError: (callback: (locale: string, namespace: string, error: Error) => void) => () => void;
+    /** Clear translations from cache */
+    clearTranslations: (locale?: string, namespace?: string) => void;
+    /** Force reload translations from loader */
+    reloadTranslations: (locale?: string, namespace?: string) => Promise<void>;
+    /** Check if a locale is loaded for a namespace */
+    hasLocale: (locale: string, namespace?: string) => boolean;
+    /** Check if a translation exists */
+    hasTranslation: (key: string, locale?: string, namespace?: string, checkFallbacks?: boolean) => boolean;
+    /** Get list of all loaded locale codes */
+    getLoadedLocales: () => string[];
+    /** Get list of active namespaces */
+    getActiveNamespaces: () => string[];
+    /** Get default namespace */
+    getDefaultNamespace: () => string;
+    /** Subscribe to i18n events */
+    on: <E extends I18nEvent>(event: E, callback: (payload: I18nEventData[E]) => void) => () => void;
+    /** Report an error to the configured onError handler */
+    reportError: I18n["reportError"];
+    /** Format a number using the current language locale */
+    formatNumber: I18n["formatNumber"];
+    /** Format a date using the current language locale */
+    formatDate: I18n["formatDate"];
+    /** Format a number as currency using the current language locale */
+    formatCurrency: I18n["formatCurrency"];
+    /** Format a relative time ("2 hours ago", "in 3 days") using the current language locale */
+    formatRelativeTime: I18n["formatRelativeTime"];
+    /** Text direction for the current language, as a reactive computed ref */
+    dir: import('vue').ComputedRef<"ltr" | "rtl">;
+    /** Cleanup resources (call when i18n instance is no longer needed) */
+    destroy: () => void;
+}
+/**
+ * Vue composable to access the i18n instance
+ * Must be used within a component that has access to the i18n plugin
+ *
+ * @param ns - Optional namespace to scope translations to
+ * @returns Object with translation function, reactive state, and i18n methods
+ */
+export declare function useI18n(ns?: string): UseI18nReturn;
+//# sourceMappingURL=useI18n.d.ts.map

package/dist/composables/useI18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useI18n.d.ts","sourceRoot":"","sources":["../../src/composables/useI18n.ts"],"names":[],"mappings":"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"}

package/dist/comvi-vue.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require(`@comvi/core`),t=require(`vue`);var n=Symbol(`i18n`);function r(e){if(e.type===`text`)return e.text;let t=``;for(let n of e.children)t+=typeof n==`string`?n:r(n);return t}function i(e){if(typeof e==`string`)return e;let t=``;for(let n of e)t+=typeof n==`string`?n:r(n);return t}var a=[`addTranslations`,`addActiveNamespace`,`clearTranslations`,`reloadTranslations`,`registerLoader`,`registerPostProcessor`,`onMissingKey`,`onLoadError`,`on`,`hasLocale`,`hasTranslation`,`setFallbackLocale`,`getDefaultNamespace`,`reportError`,`getActiveNamespaces`,`formatNumber`,`formatDate`,`formatCurrency`,`formatRelativeTime`],o=class{constructor(n){this._unsubscribers=[],this._localeQueue=Promise.resolve(),this._isLocaleQueueIdle=!0,this._isDestroyed=!1,this._installedApps=new WeakSet;let r=n.ssrLanguage??n.locale??n.language;this._core=new e.I18n({...n,locale:r}),this._locale=(0,t.shallowRef)(r),this._requestedLocale=r,this._isLoading=(0,t.shallowRef)(this._core.isLoading),this._isInitializing=(0,t.shallowRef)(this._core.isInitializing),this._cacheRevision=(0,t.shallowRef)(this._core.translationCache.getRevision()),this._translationCacheRef=(0,t.shallowRef)(this._core.translationCache.getInternalMap());let i=()=>{this._cacheRevision.value=this._core.translationCache.getRevision(),this._translationCacheRef.value=this._core.translationCache.getInternalMap(),(0,t.triggerRef)(this._translationCacheRef)};this._unsubscribers.push(this._core.on(`localeChanged`,({to:e})=>{this._locale.value=e,this._requestedLocale=e}),this._core.on(`namespaceLoaded`,i),this._core.on(`loadingStateChanged`,({isLoading:e,isInitializing:t})=>{this._isLoading.value=e,this._isInitializing.value=t}),this._core.on(`initialized`,()=>{this._locale.value=this._core.locale,i(),this._isLoading.value=this._core.isLoading,this._isInitializing.value=this._core.isInitializing}),this._core.on(`translationsCleared`,i));let o=this._core;for(let e of a)this[e]=(...t)=>o[e](...t);this.registerLocaleDetector=e=>o.registerLocaleDetector(e),this.getLoadedLocales=()=>o.getLoadedLocales(),this.t=this.t.bind(this),this.tRaw=this.tRaw.bind(this),this.setLocale=this.setLocale.bind(this),this.destroy=this.destroy.bind(this)}get locale(){return this._localeComputed||(this._localeComputed=(0,t.computed)({get:()=>this._locale.value,set:e=>{this._requestedLocale!==e&&this.setLocale(e).catch(e=>{})}})),this._localeComputed}set locale(e){this.setLocale(e).catch(e=>{})}get dir(){return this._dirComputed||(this._dirComputed=(0,t.computed)(()=>this._core.dir)),this._dirComputed}async setLocale(e){let t=e;this._requestedLocale=t;let n=async()=>{this._core.locale!==t&&await this._core.setLocaleAsync(t)},r=this._isLocaleQueueIdle?n():this._localeQueue.then(n,n);this._isLocaleQueueIdle=!1;let i=r.catch(()=>{});this._localeQueue=i,i.finally(()=>{this._localeQueue===i&&(this._isLocaleQueueIdle=!0)});try{await r}catch(e){throw this._requestedLocale===t&&(this._requestedLocale=this._core.locale),e}}get translationCache(){return this._translationCacheRef}get isLoading(){return(0,t.readonly)(this._isLoading)}get isInitializing(){return(0,t.readonly)(this._isInitializing)}tRaw(e,...t){return this._core.tRaw(e,...t)}t(e,...t){return i(this.tRaw(e,...t))}async init(){return await this._core.init(),this}use(e,t){return this._core.use(e,t),this}destroy(){this._isDestroyed||(this._isDestroyed=!0,this._unsubscribers.reverse().forEach(e=>e()),this._unsubscribers.length=0,this._core.destroy().catch(e=>{this._core.reportError(e,{source:`plugin-cleanup`})}))}install(e){this._installedApps.has(e)||(this._installedApps.add(e),!this._core.isInitialized&&!this._core.isInitializing&&this.init().catch(e=>{this._core.reportError(e instanceof Error?e:Error(String(e)),{source:`init`})}),e.provide(n,this),e.config.globalProperties.$i18n=this,e.config.globalProperties.$t=this.t,e.config.globalProperties.$tRaw=this.tRaw)}};function s(e){return new o(e)}var c=[`locale`,`setLocale`,`translationCache`,`isLoading`,`isInitializing`,`addTranslations`,`addActiveNamespace`,`setFallbackLocale`,`onMissingKey`,`onLoadError`,`clearTranslations`,`reloadTranslations`,`hasLocale`,`hasTranslation`,`getLoadedLocales`,`getActiveNamespaces`,`getDefaultNamespace`,`on`,`reportError`,`formatNumber`,`formatDate`,`formatCurrency`,`formatRelativeTime`,`dir`,`destroy`];function l(r){let a=(0,t.inject)(n);if(!a)throw Error(`[i18n] useI18n must be used within a Vue app with i18n plugin installed. Make sure you called app.use(i18n) before using this composable.`);let o=(0,e.createBoundTranslation)(a,r),s={t:((e,t)=>i(o(e,t))),tRaw:o};for(let e of c)s[e]=a[e];return s}var u=`__vue_handler_`,d=`__`;function f(e){return typeof e==`string`?e?[e]:[]:e}var p=(0,t.defineComponent)({name:`T`,props:{i18nKey:{type:String,required:!0},params:{type:Object,default:()=>({})},ns:{type:String,default:void 0},locale:{type:String,default:void 0},fallback:{type:String,default:void 0},raw:{type:Boolean,default:void 0},components:{type:Object,default:void 0}},setup(r,{slots:i}){let a=(0,t.inject)(n);if(!a)throw Error(`[i18n] <T> component must be used within a Vue app with i18n plugin installed`);return()=>{let n=r.i18nKey,o=new Map,s={},c=(n,r)=>{o.set(n,e=>{try{return r(e)}catch(r){return a.reportError(r,{source:`translation`,tagName:n}),(0,t.h)(`span`,{},e)}}),s[n]=({children:t})=>(0,e.createElement)(`${u}${n}${d}`,{},f(t))},l=e=>e.length===1&&typeof e[0]==`string`?e[0]:e;if(r.components)for(let[n,i]of Object.entries(r.components))if(typeof i==`string`)s[n]=({children:t})=>(0,e.createElement)(i,{},f(t));else if(typeof i==`object`&&i&&`component`in i){let r=i.component,a=i.props||{};typeof r==`string`?s[n]=({children:t})=>(0,e.createElement)(r,a,f(t)):c(n,e=>(0,t.h)(r,a,{default:()=>l(e)}))}else c(n,e=>(0,t.h)(i,{},{default:()=>l(e)}));for(let[e,n]of Object.entries(i))n&&!(e in s)&&c(e,e=>{let r=n({children:l(e)}),i=Array.isArray(r)?r:[r];return i.length<=1?i.length===0?(0,t.h)(t.Fragment,{},[]):i[0]:(0,t.h)(t.Fragment,{},i)});let p={...r.params,...s};r.ns!==void 0&&(p.ns=r.ns),r.locale!==void 0&&(p.locale=r.locale),r.fallback!==void 0&&(p.fallback=r.fallback),r.raw!==void 0&&(p.raw=r.raw);let m=a.tRaw(n,p);if(typeof m==`string`)return m;let h=e=>typeof e==`string`?e?[e]:[]:e.map(e=>typeof e==`string`?e:g(e)),g=e=>{if(e.type===`text`)return e.text;if(e.type===`fragment`)return(0,t.h)(t.Fragment,{key:e.key},h(e.children));let n=e.tag,r=h(e.children);if(n.startsWith(u)&&n.endsWith(d)){let e=n.slice(14,-2),i=o.get(e);if(i)try{return i(r)}catch(n){return a.reportError(n,{source:`translation`,tagName:e}),(0,t.h)(`span`,{},r)}}return(0,t.h)(n,e.props,r)};return m.map(e=>typeof e==`string`?e:g(e))}}});exports.I18N_INJECTION_KEY=n,exports.T=p,exports.VueI18n=o,exports.createI18n=s,exports.useI18n=l,Object.keys(e).forEach(function(t){t!==`default`&&!Object.prototype.hasOwnProperty.call(exports,t)&&Object.defineProperty(exports,t,{enumerable:!0,get:function(){return e[t]}})});

package/dist/comvi-vue.js

@@ -0,0 +1 @@
+import{I18n as e,createBoundTranslation as t,createElement as n}from"@comvi/core";import{Fragment as r,computed as i,defineComponent as a,h as o,inject as s,readonly as c,shallowRef as l,triggerRef as u}from"vue";export*from"@comvi/core";var d=Symbol(`i18n`);function f(e){if(e.type===`text`)return e.text;let t=``;for(let n of e.children)t+=typeof n==`string`?n:f(n);return t}function p(e){if(typeof e==`string`)return e;let t=``;for(let n of e)t+=typeof n==`string`?n:f(n);return t}var m=[`addTranslations`,`addActiveNamespace`,`clearTranslations`,`reloadTranslations`,`registerLoader`,`registerPostProcessor`,`onMissingKey`,`onLoadError`,`on`,`hasLocale`,`hasTranslation`,`setFallbackLocale`,`getDefaultNamespace`,`reportError`,`getActiveNamespaces`,`formatNumber`,`formatDate`,`formatCurrency`,`formatRelativeTime`],h=class{constructor(t){this._unsubscribers=[],this._localeQueue=Promise.resolve(),this._isLocaleQueueIdle=!0,this._isDestroyed=!1,this._installedApps=new WeakSet;let n=t.ssrLanguage??t.locale??t.language;this._core=new e({...t,locale:n}),this._locale=l(n),this._requestedLocale=n,this._isLoading=l(this._core.isLoading),this._isInitializing=l(this._core.isInitializing),this._cacheRevision=l(this._core.translationCache.getRevision()),this._translationCacheRef=l(this._core.translationCache.getInternalMap());let r=()=>{this._cacheRevision.value=this._core.translationCache.getRevision(),this._translationCacheRef.value=this._core.translationCache.getInternalMap(),u(this._translationCacheRef)};this._unsubscribers.push(this._core.on(`localeChanged`,({to:e})=>{this._locale.value=e,this._requestedLocale=e}),this._core.on(`namespaceLoaded`,r),this._core.on(`loadingStateChanged`,({isLoading:e,isInitializing:t})=>{this._isLoading.value=e,this._isInitializing.value=t}),this._core.on(`initialized`,()=>{this._locale.value=this._core.locale,r(),this._isLoading.value=this._core.isLoading,this._isInitializing.value=this._core.isInitializing}),this._core.on(`translationsCleared`,r));let i=this._core;for(let e of m)this[e]=(...t)=>i[e](...t);this.registerLocaleDetector=e=>i.registerLocaleDetector(e),this.getLoadedLocales=()=>i.getLoadedLocales(),this.t=this.t.bind(this),this.tRaw=this.tRaw.bind(this),this.setLocale=this.setLocale.bind(this),this.destroy=this.destroy.bind(this)}get locale(){return this._localeComputed||(this._localeComputed=i({get:()=>this._locale.value,set:e=>{this._requestedLocale!==e&&this.setLocale(e).catch(e=>{})}})),this._localeComputed}set locale(e){this.setLocale(e).catch(e=>{})}get dir(){return this._dirComputed||(this._dirComputed=i(()=>this._core.dir)),this._dirComputed}async setLocale(e){let t=e;this._requestedLocale=t;let n=async()=>{this._core.locale!==t&&await this._core.setLocaleAsync(t)},r=this._isLocaleQueueIdle?n():this._localeQueue.then(n,n);this._isLocaleQueueIdle=!1;let i=r.catch(()=>{});this._localeQueue=i,i.finally(()=>{this._localeQueue===i&&(this._isLocaleQueueIdle=!0)});try{await r}catch(e){throw this._requestedLocale===t&&(this._requestedLocale=this._core.locale),e}}get translationCache(){return this._translationCacheRef}get isLoading(){return c(this._isLoading)}get isInitializing(){return c(this._isInitializing)}tRaw(e,...t){return this._core.tRaw(e,...t)}t(e,...t){return p(this.tRaw(e,...t))}async init(){return await this._core.init(),this}use(e,t){return this._core.use(e,t),this}destroy(){this._isDestroyed||(this._isDestroyed=!0,this._unsubscribers.reverse().forEach(e=>e()),this._unsubscribers.length=0,this._core.destroy().catch(e=>{this._core.reportError(e,{source:`plugin-cleanup`})}))}install(e){this._installedApps.has(e)||(this._installedApps.add(e),!this._core.isInitialized&&!this._core.isInitializing&&this.init().catch(e=>{this._core.reportError(e instanceof Error?e:Error(String(e)),{source:`init`})}),e.provide(d,this),e.config.globalProperties.$i18n=this,e.config.globalProperties.$t=this.t,e.config.globalProperties.$tRaw=this.tRaw)}};function g(e){return new h(e)}var _=[`locale`,`setLocale`,`translationCache`,`isLoading`,`isInitializing`,`addTranslations`,`addActiveNamespace`,`setFallbackLocale`,`onMissingKey`,`onLoadError`,`clearTranslations`,`reloadTranslations`,`hasLocale`,`hasTranslation`,`getLoadedLocales`,`getActiveNamespaces`,`getDefaultNamespace`,`on`,`reportError`,`formatNumber`,`formatDate`,`formatCurrency`,`formatRelativeTime`,`dir`,`destroy`];function v(e){let n=s(d);if(!n)throw Error(`[i18n] useI18n must be used within a Vue app with i18n plugin installed. Make sure you called app.use(i18n) before using this composable.`);let r=t(n,e),i={t:((e,t)=>p(r(e,t))),tRaw:r};for(let e of _)i[e]=n[e];return i}var y=`__vue_handler_`,b=`__`;function x(e){return typeof e==`string`?e?[e]:[]:e}var S=a({name:`T`,props:{i18nKey:{type:String,required:!0},params:{type:Object,default:()=>({})},ns:{type:String,default:void 0},locale:{type:String,default:void 0},fallback:{type:String,default:void 0},raw:{type:Boolean,default:void 0},components:{type:Object,default:void 0}},setup(e,{slots:t}){let i=s(d);if(!i)throw Error(`[i18n] <T> component must be used within a Vue app with i18n plugin installed`);return()=>{let a=e.i18nKey,s=new Map,c={},l=(e,t)=>{s.set(e,n=>{try{return t(n)}catch(t){return i.reportError(t,{source:`translation`,tagName:e}),o(`span`,{},n)}}),c[e]=({children:t})=>n(`${y}${e}${b}`,{},x(t))},u=e=>e.length===1&&typeof e[0]==`string`?e[0]:e;if(e.components)for(let[t,r]of Object.entries(e.components))if(typeof r==`string`)c[t]=({children:e})=>n(r,{},x(e));else if(typeof r==`object`&&r&&`component`in r){let e=r.component,i=r.props||{};typeof e==`string`?c[t]=({children:t})=>n(e,i,x(t)):l(t,t=>o(e,i,{default:()=>u(t)}))}else l(t,e=>o(r,{},{default:()=>u(e)}));for(let[e,n]of Object.entries(t))n&&!(e in c)&&l(e,e=>{let t=n({children:u(e)}),i=Array.isArray(t)?t:[t];return i.length<=1?i.length===0?o(r,{},[]):i[0]:o(r,{},i)});let d={...e.params,...c};e.ns!==void 0&&(d.ns=e.ns),e.locale!==void 0&&(d.locale=e.locale),e.fallback!==void 0&&(d.fallback=e.fallback),e.raw!==void 0&&(d.raw=e.raw);let f=i.tRaw(a,d);if(typeof f==`string`)return f;let p=e=>typeof e==`string`?e?[e]:[]:e.map(e=>typeof e==`string`?e:m(e)),m=e=>{if(e.type===`text`)return e.text;if(e.type===`fragment`)return o(r,{key:e.key},p(e.children));let t=e.tag,n=p(e.children);if(t.startsWith(y)&&t.endsWith(b)){let e=t.slice(14,-2),r=s.get(e);if(r)try{return r(n)}catch(t){return i.reportError(t,{source:`translation`,tagName:e}),o(`span`,{},n)}}return o(t,e.props,n)};return f.map(e=>typeof e==`string`?e:m(e))}}});export{d as I18N_INJECTION_KEY,S as T,h as VueI18n,g as createI18n,v as useI18n};

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from '@comvi/core';
+export { VueI18n, createI18n } from './VueI18n';
+export { useI18n } from './composables/useI18n';
+export { T } from './components/T';
+export { I18N_INJECTION_KEY } from './keys';
+export type { VueI18n as I18nInstance, VueI18nOptions } from './VueI18n';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,gBAAgB,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAG5C,YAAY,EAAE,OAAO,IAAI,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/keys.d.ts

@@ -0,0 +1,8 @@
+import { InjectionKey } from 'vue';
+import { VueI18n } from './VueI18n';
+/**
+ * Injection key for Vue's provide/inject pattern
+ * Used to inject the i18n instance into Vue components
+ */
+export declare const I18N_INJECTION_KEY: InjectionKey<VueI18n>;
+//# sourceMappingURL=keys.d.ts.map

package/dist/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,KAAK,CAAC;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,YAAY,CAAC,OAAO,CAAkB,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,3 @@
+import { TranslationResult } from '@comvi/core';
+export declare function translationResultToString(result: TranslationResult): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAe,MAAM,aAAa,CAAC;AAclE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAU3E"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@comvi/vue",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Vue 3 integration for Comvi — composables, components, and type-safe translations",
+  "license": "MIT",
+  "author": "Comvi <hello@comvi.io> (https://comvi.io)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/comvi-io/comvi-js.git",
+    "directory": "packages/vue"
+  },
+  "homepage": "https://comvi.io",
+  "bugs": {
+    "url": "https://github.com/comvi-io/comvi-js/issues"
+  },
+  "keywords": [
+    "i18n",
+    "internationalization",
+    "localization",
+    "vue",
+    "vue3",
+    "vue-i18n",
+    "composition-api",
+    "typescript",
+    "type-safe",
+    "comvi",
+    "translation",
+    "ssr",
+    "ssg",
+    "server-components"
+  ],
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/comvi-vue.cjs",
+  "module": "./dist/comvi-vue.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/comvi-vue.js",
+      "require": "./dist/comvi-vue.cjs"
+    }
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "@comvi/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "vue": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.0",
+    "@typescript-eslint/eslint-plugin": "^8.58.0",
+    "@typescript-eslint/parser": "^8.58.0",
+    "@vitest/coverage-v8": "^4.1.2",
+    "@vue/test-utils": "^2.4.6",
+    "eslint": "^10.1.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-vue": "^10.8.0",
+    "happy-dom": "^20.8.9",
+    "prettier": "^3.8.1",
+    "typescript": "~6.0.2",
+    "vite": "^8.0.3",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.1.2",
+    "vue": "^3.5.32",
+    "vue-eslint-parser": "^10.4.0",
+    "vue-tsc": "^3.2.6",
+    "@comvi/vite-config": "0.1.0"
+  },
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vue-tsc && vite build",
+    "typecheck": "vue-tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint . --max-warnings=0",
+    "format": "prettier --write src/",
+    "lint:fix": "eslint . --fix"
+  }
+}