@linagora/linid-im-front-corelib 0.0.81 → 0.0.83

package/dist/types/src/composables/useScopedI18n.d.ts

@@ -20,7 +20,7 @@ export declare function useScopedI18n(scope: string): {
      * @param key - Translation key (string or number) relative to the scoped namespace.
      * @returns `true` if the key exists, `false` otherwise.
      */
-    te: (key: string | number) => boolean;
+    te: (key: string, locale?: string | undefined) => boolean;
     /**
      * Retrieves the raw translation message for a scoped key without formatting.
      * @param key - Translation key (string or number) relative to the scoped namespace.
@@ -35,3 +35,30 @@ export declare function useScopedI18n(scope: string): {
      */
     translateOrDefault: (defaultValue: string, ...args: unknown[]) => ReturnType<ComposerTranslation>;
 };
+/**
+ * Resolves the effective locale to apply, without any side effect.
+ *
+ * The locale is resolved by priority: the stored user preference first, then the locally persisted language.
+ * If neither the stored preference nor the localStorage value is a supported language, the UI store locale is used as the fallback.
+ * @returns The locale code the caller should apply to its i18n target.
+ */
+export declare function resolveLocale(): string;
+/**
+ * Synchronises the persisted state with the given locale.
+ *
+ * The locale is always written to localStorage. The server-side user preference is updated only when it differs from
+ * the currently stored one.
+ * @param locale - The locale to persist.
+ * @returns A promise that resolves once the persisted state has been synchronised.
+ */
+export declare function syncLocale(locale: string): Promise<void>;
+/**
+ * Applies the given locale to the application and persists the choice.
+ *
+ * Updates the active i18n locale, reflects it in the UI store, and synchronises the persisted state. This assumes the
+ * shared i18n instance runs in Composition mode (legacy: false), as guaranteed by the corelib LinidI18n convention;
+ * on a legacy instance the locale assignment would be a silent no-op at runtime.
+ * @param locale - The locale code to apply (e.g. "fr-FR").
+ * @returns A promise that resolves once the locale has been applied and persisted.
+ */
+export declare function changeLocale(locale: string): Promise<void>;

package/dist/types/src/index.d.ts

@@ -8,7 +8,7 @@ export { usePagination } from './composables/usePagination';
 export { QDATE_DEFAULT_MASK, useQuasarDate } from './composables/useQuasarDate';
 export { useQuasarFieldValidation } from './composables/useQuasarFieldValidation';
 export { useQuasarRules } from './composables/useQuasarRules';
-export { useScopedI18n } from './composables/useScopedI18n';
+export { changeLocale, resolveLocale, syncLocale, useScopedI18n, } from './composables/useScopedI18n';
 export { useTree } from './composables/useTree';
 export { useUiDesign } from './composables/useUiDesign';
 export { useLinidFilterUrl } from './composables/useLinidFilterUrl';

package/dist/types/src/services/i18nService.d.ts

@@ -1,13 +1,26 @@
 import { type I18n } from 'vue-i18n';
+/**
+ * Type alias for the shared LinID i18n instance.
+ *
+ * This type represents the Vue I18n instance used across all LinID modules.
+ * The instance is configured in Composition API mode (`legacy: false`) and
+ * exposes the global composer API for translations.
+ *
+ * Using a dedicated alias prevents consumers from falling back to the default
+ * `I18n` generic parameters, which may expose both legacy and composition
+ * translation signatures and cause TypeScript overload conflicts.
+ */
+type LinidI18n = I18n<Record<string, never>, Record<string, never>>;
 /**
  * Initializes the shared i18n instance.
  * Should be called once by the host application during boot.
  * @param instance - The i18n instance to use as the shared store.
  */
-export declare function setI18nInstance(instance: I18n): void;
+export declare function setI18nInstance(instance: LinidI18n): void;
 /**
  * Returns the shared i18n instance.
  * Must be called after initialization via `setI18nInstance()`.
  * @returns The shared i18n instance.
  */
-export declare function getI18nInstance(): I18n;
+export declare function getI18nInstance(): LinidI18n;
+export {};

package/dist/types/src/stores/linidUiStore.d.ts

@@ -5,6 +5,13 @@ import type { NavigationMenuItem } from '../types/linidUi';
 interface LinidUiState {
     /** List of main navigation menu items. */
     mainNavigationItems: NavigationMenuItem[];
+    /** Internationalization state: active locale and available languages. */
+    i18n: {
+        /** Currently active locale code (e.g. "fr-FR"). */
+        locale: string;
+        /** List of available locale codes declared in the configuration. */
+        languages: string[];
+    };
 }
 /**
  * Returns the Linid UI Store instance.
@@ -16,5 +23,15 @@ export declare const useLinidUiStore: () => import("pinia").Store<"LinidUiStore"
      * @param items - The navigation menu items to add.
      */
     addMainNavigationMenuItems(...items: NavigationMenuItem[]): void;
+    /**
+     * Sets the list of available locale codes.
+     * @param languages - The available locale codes (e.g. ["fr-FR", "en-US"]).
+     */
+    setAvailableLanguages(languages: string[]): void;
+    /**
+     * Sets the active locale code.
+     * @param locale - The locale code to activate (e.g. "fr-FR").
+     */
+    setLocale(locale: string): void;
 }>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linagora/linid-im-front-corelib",
-  "version": "0.0.81",
+  "version": "0.0.83",
   "description": "Core library of the LinID Identity Manager project. Provides shared types, services, components, and utilities for front-end and plugin, enabling consistent integration across the LinID ecosystem.",
   "type": "module",
   "files": [
@@ -47,39 +47,39 @@
   },
   "homepage": "https://github.com/linagora/linid-im-front-corelib#readme",
   "peerDependencies": {
-    "@module-federation/enhanced": "2.1.0",
-    "axios": "1.13.6",
-    "dayjs": "1.11.20",
+    "@module-federation/enhanced": "2.7.0",
+    "axios": "1.18.1",
+    "dayjs": "1.11.21",
     "pinia": "3.0.4",
-    "quasar": "2.18.6",
+    "quasar": "2.21.1",
     "rxjs": "7.8.2",
-    "vue": "3.5.30",
-    "vue-i18n": "11.3.0",
-    "vue-router": "5.0.3",
+    "vue": "3.5.39",
+    "vue-i18n": "11.4.6",
+    "vue-router": "5.1.0",
     "interactjs": "1.10.27"
   },
   "devDependencies": {
     "@eslint/js": "10.0.1",
-    "@types/node": "25.4.0",
+    "@types/node": "26.1.1",
     "@types/nunjucks": "3.2.6",
-    "@vitejs/plugin-vue": "6.0.4",
-    "@vitest/coverage-v8": "4.0.18",
+    "@vitejs/plugin-vue": "6.0.7",
+    "@vitest/coverage-v8": "4.1.10",
     "@vue/eslint-config-prettier": "10.2.0",
-    "@vue/eslint-config-typescript": "14.7.0",
-    "@vue/test-utils": "2.4.6",
-    "eslint": "10.0.3",
+    "@vue/eslint-config-typescript": "14.9.0",
+    "@vue/test-utils": "2.4.11",
+    "eslint": "10.6.0",
     "eslint-plugin-headers": "1.3.4",
     "eslint-plugin-import": "2.32.0",
-    "eslint-plugin-jsdoc": "62.8.0",
-    "eslint-plugin-vue": "10.8.0",
-    "happy-dom": "20.8.3",
+    "eslint-plugin-jsdoc": "63.0.12",
+    "eslint-plugin-vue": "10.9.2",
+    "happy-dom": "20.10.6",
     "oidc-client-ts": "3.5.0",
-    "prettier": "3.8.1",
-    "typescript": "5.9.3",
-    "vite": "7.3.1",
+    "prettier": "3.9.4",
+    "typescript": "6.0.3",
+    "vite": "8.1.3",
     "vite-tsconfig-paths": "6.1.1",
-    "vitest": "4.0.18",
-    "vue-tsc": "3.2.5"
+    "vitest": "4.1.10",
+    "vue-tsc": "3.3.7"
   },
   "scripts": {
     "build": "vite build && vue-tsc --declaration --emitDeclarationOnly -p tsconfig.lib.json",