@i18n-micro/vue 1.0.0 → 1.1.0

package/dist/injection.d.ts

@@ -1,6 +1,8 @@
 import { InjectionKey } from 'vue';
 import { VueI18n } from './composer';
 import { Locale } from '@i18n-micro/types';
+import { I18nRoutingStrategy } from './router/types';
 export declare const I18nInjectionKey: InjectionKey<VueI18n>;
 export declare const I18nLocalesKey: InjectionKey<Locale[]>;
 export declare const I18nDefaultLocaleKey: InjectionKey<string>;
+export declare const I18nRouterKey: InjectionKey<I18nRoutingStrategy>;

package/dist/plugin.d.ts

@@ -1,5 +1,22 @@
 import { Plugin } from 'vue';
 import { VueI18n, VueI18nOptions } from './composer';
-export declare function createI18n(options: VueI18nOptions): Plugin & {
+import { Locale } from '@i18n-micro/types';
+import { I18nRoutingStrategy } from './router/types';
+export interface CreateI18nOptions extends VueI18nOptions {
+    routingStrategy?: I18nRoutingStrategy;
+    /**
+     * Array of locale configurations
+     * If provided, will be automatically provided to the app via I18nLocalesKey
+     */
+    locales?: Locale[];
+    /**
+     * Default locale code
+     * If provided, will be automatically provided to the app via I18nDefaultLocaleKey
+     */
+    defaultLocale?: string;
+}
+export type I18nPlugin = Plugin & {
     global: VueI18n;
+    setRoutingStrategy: (strategy: I18nRoutingStrategy) => void;
 };
+export declare function createI18n(options: CreateI18nOptions): I18nPlugin;

package/dist/router/adapter.d.ts

@@ -0,0 +1,9 @@
+import { Router } from 'vue-router';
+import { I18nRoutingStrategy } from './types';
+import { Locale } from '@i18n-micro/types';
+/**
+ * Factory for Vue Router adapter
+ * Implements routing utilities for Vue Router
+ * Uses vue-router APIs for navigation and path resolution
+ */
+export declare function createVueRouterAdapter(router: Router, locales: Locale[], defaultLocale: string): I18nRoutingStrategy;

package/dist/router/types.d.ts

@@ -0,0 +1,43 @@
+import { Component } from 'vue';
+/**
+ * Routing strategy interface for i18n
+ * Implement this interface to integrate with any router library
+ */
+export interface I18nRoutingStrategy {
+    /**
+     * Returns current path (without locale prefix if needed, or full path)
+     * Used for determining active classes in links
+     */
+    getCurrentPath: () => string;
+    /**
+     * Component to use for rendering links (e.g., RouterLink)
+     */
+    linkComponent?: string | Component;
+    /**
+     * Function to navigate to another route/locale
+     */
+    push: (target: {
+        path: string;
+    }) => void;
+    /**
+     * Function to replace current route
+     */
+    replace: (target: {
+        path: string;
+    }) => void;
+    /**
+     * Generate path for specific locale
+     */
+    resolvePath?: (to: string | {
+        path?: string;
+    }, locale: string) => string | {
+        path?: string;
+    };
+    /**
+     * (Optional) Get current route object for SEO/Meta tags
+     */
+    getRoute?: () => {
+        fullPath: string;
+        query: Record<string, unknown>;
+    };
+}

package/dist/use-i18n.d.ts

@@ -1,35 +1,41 @@
-import { useRoute, RouteLocationRaw } from 'vue-router';
-import { Params, CleanTranslation, Locale, TranslationKey } from '@i18n-micro/types';
+import { VueI18n } from './composer';
+import { Locale } from '@i18n-micro/types';
 export interface UseI18nOptions {
     locales?: Locale[];
     defaultLocale?: string;
 }
+/**
+ * Get the i18n instance from the Vue app context
+ * Returns the same instance that was created with createI18n()
+ */
 export declare function useI18n(options?: UseI18nOptions): {
+    instance: VueI18n;
     locale: import('vue').WritableComputedRef<string, string>;
-    fallbackLocale: import('vue').WritableComputedRef<string, string>;
-    currentRoute: import('vue').WritableComputedRef<string, string>;
-    t: (key: TranslationKey, params?: Params, defaultValue?: string | null, routeName?: string) => CleanTranslation;
-    ts: (key: TranslationKey, params?: Params, defaultValue?: string, routeName?: string) => string;
-    tc: (key: TranslationKey, count: number | Params, defaultValue?: string) => string;
+    getLocales: () => Locale[];
+    defaultLocale: () => string;
+    getLocaleName: () => string | null;
+    localeRoute: (to: string | {
+        path?: string;
+    }, localeCode?: string) => string | {
+        path?: string;
+    };
+    localePath: (to: string | {
+        path?: string;
+    }, locale?: string) => string;
+    switchLocale: (newLocale: string) => void;
+    t: (key: import('@i18n-micro/types').TranslationKey, params?: import('@i18n-micro/types').Params, defaultValue?: string | null, routeName?: string) => import('@i18n-micro/types').CleanTranslation;
+    ts: (key: import('@i18n-micro/types').TranslationKey, params?: import('@i18n-micro/types').Params, defaultValue?: string, routeName?: string) => string;
+    tc: (key: import('@i18n-micro/types').TranslationKey, count: number | import('@i18n-micro/types').Params, defaultValue?: string) => string;
     tn: (value: number, options?: Intl.NumberFormatOptions) => string;
     td: (value: Date | number | string, options?: Intl.DateTimeFormatOptions) => string;
     tdr: (value: Date | number | string, options?: Intl.RelativeTimeFormatOptions) => string;
-    has: (key: TranslationKey, routeName?: string) => boolean;
+    has: (key: import('@i18n-micro/types').TranslationKey, routeName?: string) => boolean;
     setRoute: (routeName: string) => void;
     getRoute: () => string;
-    getRouteName: (r?: ReturnType<typeof useRoute>) => string;
-    getLocale: (r?: ReturnType<typeof useRoute>) => string;
-    getLocales: () => Locale[];
-    defaultLocale: () => string;
-    getLocaleName: () => string | null;
-    switchLocaleRoute: ((locale: string) => RouteLocationRaw) | undefined;
-    switchLocalePath: ((locale: string) => string) | undefined;
-    switchLocale: ((locale: string) => void) | undefined;
-    localeRoute: ((to: RouteLocationRaw | string, locale?: string) => RouteLocationRaw | string) | undefined;
-    localePath: ((to: RouteLocationRaw | string, locale?: string) => string) | undefined;
-    addTranslations: (locale: string, translations: Record<string, unknown>, merge?: boolean) => void;
-    addRouteTranslations: (locale: string, routeName: string, translations: Record<string, unknown>, merge?: boolean) => void;
-    mergeTranslations: (locale: string, routeName: string, translations: Record<string, unknown>) => void;
-    mergeGlobalTranslations: (locale: string, translations: Record<string, unknown>) => void;
+    getLocale: () => string;
+    addTranslations: (locale: string, translations: import('@i18n-micro/types').Translations, merge?: boolean) => void;
+    addRouteTranslations: (locale: string, routeName: string, translations: import('@i18n-micro/types').Translations, merge?: boolean) => void;
+    mergeTranslations: (locale: string, routeName: string, translations: import('@i18n-micro/types').Translations) => void;
+    mergeGlobalTranslations: (locale: string, translations: import('@i18n-micro/types').Translations) => void;
     clearCache: () => void;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-micro/vue",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -19,28 +19,33 @@
     "access": "public"
   },
   "dependencies": {
-    "@i18n-micro/core": "1.0.27",
-    "@i18n-micro/types": "1.0.15",
-    "@i18n-micro/devtools-ui": "1.0.0"
+    "@i18n-micro/types": "1.0.16",
+    "@i18n-micro/core": "1.0.28"
   },
   "peerDependencies": {
     "vue": "^3.3.0",
     "vue-router": "^4.0.0"
   },
+  "peerDependenciesMeta": {
+    "vue-router": {
+      "optional": true
+    }
+  },
   "devDependencies": {
-    "vue": "^3.3.0",
-    "vue-router": "^4.0.0",
-    "vite": "^5.0.0",
-    "vite-plugin-dts": "^4.3.0",
+    "vue": "^3.5.25",
+    "vue-router": "^4.6.3",
+    "vite": "^7.2.7",
+    "vite-plugin-dts": "^4.5.4",
     "jest": "^29.7.0",
-    "ts-jest": "^29.1.2",
-    "@types/jest": "^29.5.0",
-    "@vue/test-utils": "^2.4.0",
+    "ts-jest": "^29.4.6",
+    "@types/jest": "^29.5.14",
+    "@vue/test-utils": "^2.4.6",
     "jest-environment-jsdom": "^29.7.0"
   },
   "scripts": {
     "build": "vite build",
     "dev": "cd playground && vite",
+    "dev:ssr": "cd playground && node server.js",
     "test": "jest",
     "typecheck": "tsc --noEmit"
   }

package/dist/devtools/bridge/vue-bridge.d.ts

@@ -1,14 +0,0 @@
-import { I18nDevToolsBridge } from '@i18n-micro/devtools-ui';
-import { Locale } from '@i18n-micro/types';
-import { VueI18n } from '../../composer';
-export interface VueBridgeOptions {
-    i18n: VueI18n;
-    locales?: Locale[];
-    defaultLocale?: string;
-    translationDir?: string;
-}
-/**
- * Create a Vue bridge that adapts VueI18n API to I18nDevToolsBridge interface
- * Creates a virtual file system structure: locales/{lang}.json and locales/pages/{route}/{lang}.json
- */
-export declare function createVueBridge(options: VueBridgeOptions): I18nDevToolsBridge;

package/dist/devtools/index.d.ts

@@ -1,9 +0,0 @@
-import { VueI18n } from '../composer';
-import { Locale } from '@i18n-micro/types';
-export interface VueDevToolsOptions {
-    i18n: VueI18n;
-    locales?: Locale[];
-    defaultLocale?: string;
-    translationDir?: string;
-}
-export declare function setupVueDevTools(options: VueDevToolsOptions): void;

package/dist/router.d.ts

@@ -1,27 +0,0 @@
-import { Router, RouteLocationNormalizedLoaded } from 'vue-router';
-import { VueI18n } from './composer';
-export interface RouterIntegrationOptions {
-    router: Router;
-    i18n: VueI18n;
-    defaultLocale?: string;
-    locales?: string[];
-}
-/**
- * Get route name from Vue Router route
- * Extracts route name from route.name or route.path
- */
-export declare function getRouteName(route: RouteLocationNormalizedLoaded): string;
-/**
- * Get locale from route
- * Checks route.params.locale or extracts from path
- */
-export declare function getLocaleFromRoute(route: RouteLocationNormalizedLoaded, defaultLocale?: string, locales?: string[]): string;
-/**
- * Setup router integration for i18n
- * Automatically updates route and locale when router changes, AND updates URL when locale changes.
- */
-export declare function setupRouterIntegration(options: RouterIntegrationOptions): () => void;
-/**
- * Switch locale and navigate to localized route
- */
-export declare function switchLocaleRoute(router: Router, i18n: VueI18n, newLocale: string, locales?: string[]): void;