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

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

@@ -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/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.82",
+  "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": [