@club-employes/utopia 4.384.0 → 4.386.0

package/dist/components/molecules/EmptyState/EmptyState.d.ts

@@ -5,8 +5,8 @@ declare const _default: DefineComponent<EmptyStateProps, {}, {}, {}, {}, Compone
     title: string;
     icon: IconName;
     iconSize: IconSize;
-    iconColor: string;
     description: string;
+    iconColor: string;
     buttonLabel: string;
     buttonAction: () => void;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;

package/dist/components/organisms/PageNavigation/PageNavigation.d.ts

@@ -8,12 +8,12 @@ declare const _default: DefineComponent<PageNavigationProps, {}, {}, {}, {}, Com
     "onSize-change"?: ((page: number) => any) | undefined;
 }>, {
     size: number;
+    goToPageLabel: string;
+    sizeLabel: string;
     compact: boolean;
     showSize: boolean;
-    sizeLabel: string;
     sizeOptions: number[];
     showGoToPage: boolean;
-    goToPageLabel: string;
     goToPageDropdownMaxPages: number;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 export default _default;

package/dist/components/organisms/SummaryMetricCard/types.d.ts

@@ -4,4 +4,5 @@ export interface SummaryMetricCardProps {
     value: string | number;
     icon: string;
     variant?: SummaryMetricCardVariant;
+    subValue?: string | number;
 }

package/dist/composables/useTableTranslations.d.ts

@@ -1,41 +1,14 @@
 import { ComputedRef, MaybeRefOrGetter } from 'vue';
-export type TableLanguage = 'fr' | 'en';
-interface TableTranslations {
-    goToPageLabel: string;
-    sizeLabel: string;
-    elements: string;
-    to: string;
-    filter: {
-        equals: string;
-        notEquals: string;
-        before: string;
-        after: string;
-        contains: string;
-        notContains: string;
-        startsWith: string;
-        lessThan: string;
-        greaterThan: string;
-        lessThanOrEqual: string;
-        greaterThanOrEqual: string;
-        between: string;
-        notBetween: string;
-    };
-    emptyState: {
-        loading: {
-            title: string;
-            description: string;
-        };
-        noData: {
-            title: string;
-            description: string;
-        };
-        noSearchResults: {
-            title: string;
-            description: string;
-        };
-    };
-    editModeLabelOn: string;
-    editModeLabelOff: string;
-}
+import { UtopiaLocale, UtopiaMessagesTree } from '../i18n/types';
+/** @deprecated Alias historique — utiliser `UtopiaLocale`. Exporté à vie (rétro-compat). */
+export type TableLanguage = UtopiaLocale;
+export type TableTranslations = UtopiaMessagesTree['table'];
+/**
+ * Wrapper rétro-compatible au-dessus du socle i18n du DS : les dictionnaires
+ * vivent désormais dans `src/i18n/messages/{fr,en}.ts` (clé `table`).
+ *
+ * Signature et comportement inchangés pour une langue définie ; si `language`
+ * résout `undefined`, retombe sur la locale globale Utopia (puis `'fr'`) —
+ * même chaîne de résolution que `useUtopiaI18n`.
+ */
 export declare function useTableTranslations(language: MaybeRefOrGetter<TableLanguage | string>): ComputedRef<TableTranslations>;
-export {};

package/dist/i18n/__tests__/useUtopiaI18n.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/i18n/index.d.ts

@@ -0,0 +1,4 @@
+export { mergeMessagesDeep, normalizeUtopiaLocale, useEffectiveLocale, useUtopiaI18n, useUtopiaIntlLocale, type UseUtopiaI18nReturn } from './useUtopiaI18n';
+export type { DeepPartialMessages, MessagePath, UtopiaComponentKey, UtopiaLocale, UtopiaMessagesOverride, UtopiaMessagesTree } from './types';
+export { default as utopiaMessagesFr } from './messages/fr';
+export { default as utopiaMessagesEn } from './messages/en';

package/dist/i18n/messages/en.d.ts

@@ -0,0 +1,10 @@
+import { UtopiaMessagesOverride } from '../types';
+/**
+ * Dictionnaire EN — surcharge partielle du dictionnaire FR canonique (`fr.ts`).
+ *
+ * Toute clé absente ici retombe silencieusement sur la valeur FR au runtime
+ * (jamais de clé brute affichée). Le type `UtopiaMessagesOverride` garantit
+ * qu'aucune clé inconnue de `fr.ts` ne peut être introduite ici.
+ */
+declare const en: UtopiaMessagesOverride;
+export default en;

package/dist/i18n/messages/fr.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Dictionnaire canonique des libellés internes du DS — locale FR (défaut).
+ *
+ * Source de vérité du shape de l'arbre de messages : `en.ts` est typé
+ * `UtopiaMessagesOverride` (partiel récursif de cet arbre) et retombe sur
+ * ces valeurs à la moindre clé manquante.
+ *
+ * Règles :
+ * - une clé racine par composant (camelCase du nom du composant), plus `common`
+ *   pour les libellés transverses (aria, actions génériques) ;
+ * - les chaînes migrées depuis un composant sont copiées **à l'identique,
+ *   caractère pour caractère** (accents, ponctuation, emojis compris) —
+ *   c'est le contrat de non-régression FR ;
+ * - interpolation par balises `{param}` (voir `t()` de `useUtopiaI18n`).
+ */
+declare const _default: {
+    common: {
+        required: string;
+        close: string;
+        cancel: string;
+        apply: string;
+        clear: string;
+        add: string;
+        remove: string;
+        search: string;
+    };
+    table: {
+        goToPageLabel: string;
+        sizeLabel: string;
+        elements: string;
+        to: string;
+        filter: {
+            equals: string;
+            notEquals: string;
+            before: string;
+            after: string;
+            contains: string;
+            notContains: string;
+            startsWith: string;
+            lessThan: string;
+            greaterThan: string;
+            lessThanOrEqual: string;
+            greaterThanOrEqual: string;
+            between: string;
+            notBetween: string;
+        };
+        emptyState: {
+            loading: {
+                title: string;
+                description: string;
+            };
+            noData: {
+                title: string;
+                description: string;
+            };
+            noSearchResults: {
+                title: string;
+                description: string;
+            };
+        };
+        editModeLabelOn: string;
+        editModeLabelOff: string;
+    };
+};
+export default _default;

package/dist/i18n/types.d.ts

@@ -0,0 +1,27 @@
+import { default as frMessages } from './messages/fr';
+/**
+ * Locales supportées par le DS.
+ *
+ * Élargissable plus tard (`'es' | 'de' | …`) sans rien casser : toute valeur
+ * inconnue est normalisée sur `'fr'` (voir `normalizeUtopiaLocale`).
+ */
+export type UtopiaLocale = 'fr' | 'en';
+/** Arbre complet des messages, dont `fr.ts` est la source de vérité. */
+export type UtopiaMessagesTree = typeof frMessages;
+/** Clé racine de l'arbre — une par composant (+ `common`). */
+export type UtopiaComponentKey = keyof UtopiaMessagesTree;
+/**
+ * Version partielle récursive de l'arbre : shape des dictionnaires de
+ * surcharge (`en.ts`). Les feuilles restent des `string`.
+ */
+export type DeepPartialMessages<T> = {
+    [K in keyof T]?: T[K] extends string ? string : DeepPartialMessages<T[K]>;
+};
+export type UtopiaMessagesOverride = DeepPartialMessages<UtopiaMessagesTree>;
+/**
+ * Chemins pointés (`'emptyState.noData.title'`) valides dans le bloc de
+ * messages d'un composant — utilisé par le `t()` de `useUtopiaI18n`.
+ */
+export type MessagePath<T> = T extends string ? never : {
+    [K in keyof T & string]: T[K] extends string ? K : `${K}.${MessagePath<T[K]>}`;
+}[keyof T & string];

package/dist/i18n/useUtopiaI18n.d.ts

@@ -0,0 +1,48 @@
+import { ComputedRef, MaybeRefOrGetter } from 'vue';
+import { MessagePath, UtopiaComponentKey, UtopiaLocale, UtopiaMessagesTree } from './types';
+/** Toute valeur non reconnue retombe sur `'fr'` (défaut historique du DS). */
+export declare function normalizeUtopiaLocale(value: unknown): UtopiaLocale;
+/**
+ * Résout la locale effective d'un composant :
+ * prop `language` explicite > locale globale Utopia (`setUtopiaLocale`) > `'fr'`.
+ *
+ * Réactif : suit la prop (getter/ref) et le `Ref` global à chaud.
+ */
+export declare function useEffectiveLocale(language?: MaybeRefOrGetter<string | undefined>): ComputedRef<UtopiaLocale>;
+type MessagesNode = {
+    [key: string]: string | MessagesNode;
+};
+/**
+ * Fusionne une surcharge partielle dans l'arbre de base, feuille à feuille.
+ * Une feuille absente (ou d'un autre type) de la surcharge garde la valeur
+ * de base — c'est le fallback en→fr : jamais de clé brute affichée.
+ */
+export declare function mergeMessagesDeep<T extends MessagesNode>(base: T, override: unknown): T;
+export interface UseUtopiaI18nReturn<K extends UtopiaComponentKey> {
+    /** Locale effective (prop > globale > fr), réactive. */
+    locale: ComputedRef<UtopiaLocale>;
+    /** Bloc de messages du composant, réactif, fallback fr garanti. */
+    messages: ComputedRef<UtopiaMessagesTree[K]>;
+    /** Accès par chemin pointé + interpolation `{param}`. */
+    t: (path: MessagePath<UtopiaMessagesTree[K]>, params?: Record<string, string | number>) => string;
+}
+/**
+ * i18n interne du DS — généralisation du pattern historique de `<Table>`
+ * (`useTableTranslations` + fallback `getUtopiaLocale()`).
+ *
+ * ```ts
+ * const { messages, t } = useUtopiaI18n('dropDown', () => props.language)
+ * const placeholderText = computed(() => props.placeholder ?? messages.value.placeholder)
+ * ```
+ *
+ * Les dictionnaires sont module-locaux (une copie par bundle du DS) : seul le
+ * *choix* de locale transite par `globalThis` — des versions désynchronisées
+ * du DS entre host et MFEs restent donc cohérentes chacune avec ses messages.
+ */
+export declare function useUtopiaI18n<K extends UtopiaComponentKey>(component: K, language?: MaybeRefOrGetter<string | undefined>): UseUtopiaI18nReturn<K>;
+/**
+ * Locale BCP 47 réactive pour `Intl.*` (dates, nombres) :
+ * `fr → 'fr-FR'`, `en → 'en-GB'`.
+ */
+export declare function useUtopiaIntlLocale(language?: MaybeRefOrGetter<string | undefined>): ComputedRef<string>;
+export {};

package/dist/index.d.ts

@@ -112,8 +112,10 @@ export type { TreeProps, TreeNode, TreeSelectionKey } from './components/molecul
 export { clubEmployesDark, clubEmployesLight } from './themes/club-employes';
 export { gifteoDark, gifteoLight } from './themes/gifteo';
 export type { LoaderProps } from './components/templates/Loader/types';
-export { getActiveTheme, initializeTheme, isValidThemeName, unlockBrand, useBreakpoints, useCurrency, useFavicon, useScrollShadows, useTheme, usePrimeVueTableLocale, getUtopiaLocale, setUtopiaLocale, useUtopiaLocale } from './composables';
+export { getActiveTheme, initializeTheme, isValidThemeName, unlockBrand, useBreakpoints, useCurrency, useFavicon, useScrollShadows, useTheme, usePrimeVueTableLocale, getUtopiaLocale, setUtopiaLocale, useUtopiaLocale, useTableTranslations } from './composables';
 export type { PrimeVueTableLanguage } from './composables/usePrimeVueTableLocale';
+export type { TableLanguage, TableTranslations } from './composables/useTableTranslations';
+export { mergeMessagesDeep, normalizeUtopiaLocale, useEffectiveLocale, useUtopiaI18n, useUtopiaIntlLocale, utopiaMessagesEn, utopiaMessagesFr, type DeepPartialMessages, type MessagePath, type UseUtopiaI18nReturn, type UtopiaComponentKey, type UtopiaLocale, type UtopiaMessagesOverride, type UtopiaMessagesTree } from './i18n';
 export { applyPrimeVueTableLocalePatch, PRIMEVUE_TABLE_LOCALE_EN, PRIMEVUE_TABLE_LOCALE_FR, type PrimeVueTableLocalePatch } from './locales/primeVueTableLocale';
 export type { ThemeName } from './composables/initializeTheme';
 export type { UseScrollShadowsOptions, UseScrollShadowsReturn } from './composables/useScrollShadows';