@surgeui/ds-vue 2.3.0 → 3.0.0

package/dist/components/templates/SplitLayout.vue.d.ts

@@ -0,0 +1,34 @@
+import { SplitLayoutProps } from '../../types';
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: Readonly<{
+        /** Première zone (gauche en colonnes, ou droite avec `reverse`) */
+        start?(): any;
+        /** Seconde zone */
+        end?(): any;
+    }> & {
+        /** Première zone (gauche en colonnes, ou droite avec `reverse`) */
+        start?(): any;
+        /** Seconde zone */
+        end?(): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<SplitLayoutProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<SplitLayoutProps> & Readonly<{}>, {
+    ratio: "1:1" | "2:1" | "1:2" | "3:2" | "2:3";
+    gap: import('../../types').LayoutGap;
+    reverse: boolean;
+    breakpoint: import('../../types').LayoutBreakpoint;
+    align: "start" | "center" | "end" | "stretch";
+    fullHeight: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=SplitLayout.vue.d.ts.map

package/dist/components/templates/SplitLayout.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SplitLayout.vue.d.ts","sourceRoot":"","sources":["../../../src/components/templates/SplitLayout.vue"],"names":[],"mappings":"AAiIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAuD/C,iBAAS,cAAc;WAmCT,OAAO,IAA6B;;QAxEhD,mEAAmE;kBACzD,GAAG;QACb,mBAAmB;gBACX,GAAG;;QAHX,mEAAmE;kBACzD,GAAG;QACb,mBAAmB;gBACX,GAAG;;;;EA0EZ;AAWD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;;;wFAQnB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAapG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/components/templates/_stories/layoutDemo.d.ts

@@ -0,0 +1,43 @@
+import { PropType } from 'vue';
+export declare const DemoBox: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    label: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** Hauteur minimale (longueur CSS) */
+    height: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** `accent` : zone mise en avant (contenu principal, à la une…) */
+    tone: {
+        type: PropType<"muted" | "accent">;
+        default: string;
+    };
+}>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    label: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** Hauteur minimale (longueur CSS) */
+    height: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** `accent` : zone mise en avant (contenu principal, à la une…) */
+    tone: {
+        type: PropType<"muted" | "accent">;
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    label: string;
+    height: string;
+    tone: "muted" | "accent";
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+/** Paragraphes de remplissage */
+export declare const paragraphs: (count: number) => string[];
+/** Hauteurs variées pour le mur (masonry) */
+export declare const tileHeights: string[];
+//# sourceMappingURL=layoutDemo.d.ts.map

package/dist/components/templates/_stories/layoutDemo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutDemo.d.ts","sourceRoot":"","sources":["../../../../src/components/templates/_stories/layoutDemo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAA;AAKvD,eAAO,MAAM,OAAO;;;;;IAIhB,sCAAsC;;;;;IAEtC,mEAAmE;;cAC3C,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC;;;;;;;;;;IAHpD,sCAAsC;;;;;IAEtC,mEAAmE;;cAC3C,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC;;;;;;;4EA2BtD,CAAA;AAEF,iCAAiC;AACjC,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,aAIvC,CAAA;AAED,6CAA6C;AAC7C,eAAO,MAAM,WAAW,UAA+G,CAAA"}

package/dist/composables/index.d.ts

@@ -3,5 +3,20 @@ import { useCustomTheme } from './useCustomTheme';
 import { useUniqueId } from './useUniqueId';
 import { useBreakpoint } from './useBreakpoint';
 import { usePrice } from './usePrice';
-export { useTheme, useCustomTheme, useUniqueId, useBreakpoint, usePrice, };
+import { useFloatingPosition } from './useFloatingPosition';
+import { useAnnouncer, announce, clearAnnouncements } from './useAnnouncer';
+import { useLocale, provideLocale, defineLocale, formatMessage, LocaleKey } from './useLocale';
+import { useFormField, provideFormField, mergeIds, FormFieldKey } from './useFormField';
+import { useFocusTrap, createFocusTrap, getTabbableElements } from './useFocusTrap';
+import { useDismiss } from './useDismiss';
+import { useListNavigation } from './useListNavigation';
+import { useTypeahead } from './useTypeahead';
+export { useTheme, useCustomTheme, useUniqueId, useBreakpoint, usePrice, useFloatingPosition, useAnnouncer, announce, clearAnnouncements, useLocale, provideLocale, defineLocale, formatMessage, LocaleKey, useFormField, provideFormField, mergeIds, FormFieldKey, useFocusTrap, createFocusTrap, getTabbableElements, useDismiss, useListNavigation, useTypeahead, };
+export type { FloatingPositionOptions } from './useFloatingPosition';
+export type { AnnounceOptions, AnnouncePriority } from './useAnnouncer';
+export type { FormFieldContext, FormFieldControl, FormFieldControlProps, UseFormFieldOptions, UseFormFieldReturn } from './useFormField';
+export type { FocusTrapOptions } from './useFocusTrap';
+export type { DismissOptions, DismissReason } from './useDismiss';
+export type { ListNavigationOptions, ListOrientation } from './useListNavigation';
+export type { TypeaheadOptions } from './useTypeahead';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composables/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,OAAO,EACL,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,QAAQ,GACT,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composables/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAC3E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC9F,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACvF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,EACL,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,QAAQ,EACR,mBAAmB,EACnB,YAAY,EACZ,QAAQ,EACR,kBAAkB,EAClB,SAAS,EACT,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,YAAY,GACb,CAAA;AAED,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACvE,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjE,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACjF,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/composables/useAnnouncer.d.ts

@@ -0,0 +1,32 @@
+export type AnnouncePriority = 'polite' | 'assertive';
+export interface AnnounceOptions {
+    /** `assertive` interrompt la lecture en cours : à réserver aux erreurs */
+    priority?: AnnouncePriority;
+    /** Délai avant d'effacer le message (ms) : un texte resté en place serait relu au curseur virtuel */
+    clearAfter?: number;
+}
+/**
+ * Crée les régions live du document s'il n'en a pas encore.
+ * Appelé au montage par `useAnnouncer` pour qu'elles précèdent la première annonce.
+ */
+export declare function ensureAnnouncerRegions(): void;
+/**
+ * Annonce un message aux lecteurs d'écran, sans le rendre visible.
+ * Utilisable hors composant (aucun effet côté serveur).
+ */
+export declare function announce(message: string, options?: AnnounceOptions): void;
+/** Efface les messages en attente ou affichés */
+export declare function clearAnnouncements(): void;
+/**
+ * Annonces accessibles depuis un composant.
+ *
+ * @example
+ * const { announce } = useAnnouncer()
+ * announce('3 résultats')
+ * announce('Le fichier dépasse 5 Mo', { priority: 'assertive' })
+ */
+export declare function useAnnouncer(): {
+    announce: typeof announce;
+    clear: typeof clearAnnouncements;
+};
+//# sourceMappingURL=useAnnouncer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAnnouncer.d.ts","sourceRoot":"","sources":["../../src/composables/useAnnouncer.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,WAAW,CAAA;AAErD,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,qGAAqG;IACrG,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AA2DD;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI,CAsB7E;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,IAAI,IAAI,CAMzC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY;;;EAO3B"}

package/dist/composables/useDismiss.d.ts

@@ -0,0 +1,32 @@
+import { MaybeRefOrGetter } from 'vue';
+type ElementTarget = MaybeRefOrGetter<HTMLElement | null | undefined>;
+export type DismissReason = 'escape' | 'outside' | 'focus-outside';
+export interface DismissOptions {
+    /** La couche est active (élément ouvert) */
+    enabled: MaybeRefOrGetter<boolean>;
+    /** Appelé quand la couche doit se fermer */
+    onDismiss: (reason: DismissReason, event: Event) => void;
+    /** Fermeture avec Échap (défaut : true) */
+    escape?: MaybeRefOrGetter<boolean>;
+    /** Fermeture à l'appui (pointerdown) hors des éléments (défaut : true) */
+    outside?: MaybeRefOrGetter<boolean>;
+    /** Fermeture quand le focus quitte les éléments (défaut : false) */
+    focusOutside?: MaybeRefOrGetter<boolean>;
+}
+/**
+ * Ferme un élément superposé avec Échap, un appui à l'extérieur ou la
+ * perte du focus. Les éléments listés (déclencheur, panneau…) forment
+ * « l'intérieur ».
+ *
+ * @example
+ * useDismiss([triggerRef, panelRef], {
+ *   enabled: isOpen,
+ *   onDismiss: (reason) => close({ returnFocus: reason === 'escape' })
+ * })
+ */
+export declare function useDismiss(targets: ElementTarget | ElementTarget[], options: DismissOptions): {
+    /** La couche est celle du dessus (seule à réagir à Échap) */
+    isTopLayer: () => boolean;
+};
+export {};
+//# sourceMappingURL=useDismiss.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDismiss.d.ts","sourceRoot":"","sources":["../../src/composables/useDismiss.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAc5E,KAAK,aAAa,GAAG,gBAAgB,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAErE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,CAAA;AAElE,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAClC,4CAA4C;IAC5C,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IACxD,2CAA2C;IAC3C,MAAM,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAClC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACnC,oEAAoE;IACpE,YAAY,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;CACzC;AAoED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,EAAE,EAAE,OAAO,EAAE,cAAc;IA6BxF,6DAA6D;;EAGhE"}

package/dist/composables/useFloatingPosition.d.ts

@@ -0,0 +1,32 @@
+import { MaybeRefOrGetter, Ref } from 'vue';
+import { Placement } from '@floating-ui/dom';
+export interface FloatingPositionOptions {
+    /** Placement souhaité ; il est retourné automatiquement s'il manque de place */
+    placement: MaybeRefOrGetter<Placement>;
+    /** Élément flottant affiché ou non */
+    open: MaybeRefOrGetter<boolean>;
+    /** Distance entre la référence et l'élément flottant (px) */
+    offset?: number;
+    /** Élément « flèche » à aligner sur la référence */
+    arrow?: Ref<HTMLElement | undefined | null>;
+    /** Largeur minimale = largeur de la référence (listes déroulantes) */
+    matchReferenceWidth?: boolean;
+    /** Marge minimale avec les bords de l'écran (px) */
+    padding?: number;
+}
+/**
+ * Positionne un élément flottant (popover, menu, liste) contre sa référence.
+ *
+ * - Position `fixed` : l'élément n'est plus coupé par un parent en
+ *   `overflow: hidden`.
+ * - Retournement (flip) et décalage (shift) quand il manque de place.
+ * - Suivi du défilement et du redimensionnement tant qu'il est ouvert.
+ *
+ * Renvoie le placement réellement appliqué, à utiliser pour orienter
+ * la flèche et l'animation (`transform-origin`).
+ */
+export declare function useFloatingPosition(reference: Ref<HTMLElement | undefined | null>, floating: Ref<HTMLElement | undefined | null>, options: FloatingPositionOptions): {
+    placement: Ref<Placement, Placement>;
+    update: () => Promise<void>;
+};
+//# sourceMappingURL=useFloatingPosition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFloatingPosition.d.ts","sourceRoot":"","sources":["../../src/composables/useFloatingPosition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkD,KAAK,gBAAgB,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AACrG,OAAO,EASL,KAAK,SAAS,EACf,MAAM,kBAAkB,CAAA;AAEzB,MAAM,WAAW,uBAAuB;IACtC,gFAAgF;IAChF,SAAS,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACtC,sCAAsC;IACtC,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAC/B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oDAAoD;IACpD,KAAK,CAAC,EAAE,GAAG,CAAC,WAAW,GAAG,SAAS,GAAG,IAAI,CAAC,CAAA;IAC3C,sEAAsE;IACtE,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,GAAG,CAAC,WAAW,GAAG,SAAS,GAAG,IAAI,CAAC,EAC9C,QAAQ,EAAE,GAAG,CAAC,WAAW,GAAG,SAAS,GAAG,IAAI,CAAC,EAC7C,OAAO,EAAE,uBAAuB;;;EAkFjC"}

package/dist/composables/useFocusTrap.d.ts

@@ -0,0 +1,42 @@
+import { MaybeRefOrGetter } from 'vue';
+type ElementTarget = MaybeRefOrGetter<HTMLElement | null | undefined>;
+export interface FocusTrapOptions {
+    /** Active le piège tant que la valeur est vraie (sinon : activate() / deactivate()) */
+    active?: MaybeRefOrGetter<boolean>;
+    /**
+     * Élément qui reçoit le focus à l'activation (par défaut : le premier
+     * élément focalisable, sinon le conteneur). `false` : le focus ne bouge pas.
+     */
+    initialFocus?: (() => HTMLElement | null | undefined) | false;
+    /**
+     * Rend le focus à la désactivation : `true` (élément focalisé avant
+     * l'activation), ou un élément précis. Le focus n'est rendu que s'il est
+     * encore dans le conteneur (l'utilisateur n'a pas cliqué ailleurs).
+     */
+    returnFocus?: boolean | (() => HTMLElement | null | undefined);
+}
+/** Éléments atteignables par Tab dans un conteneur, dans l'ordre du DOM */
+export declare function getTabbableElements(container: HTMLElement): HTMLElement[];
+/**
+ * Piège à focus sans cycle de vie Vue (utilisable hors composant).
+ * @returns activate / deactivate / isActive
+ */
+export declare function createFocusTrap(target: ElementTarget, options?: Omit<FocusTrapOptions, 'active'>): {
+    activate: () => void;
+    deactivate: () => void;
+    isActive: () => boolean;
+};
+/**
+ * Piège à focus lié au cycle de vie du composant.
+ *
+ * @example
+ * const panelRef = ref<HTMLElement>()
+ * useFocusTrap(panelRef, { active: isOpen })
+ */
+export declare function useFocusTrap(target: ElementTarget, options?: FocusTrapOptions): {
+    active: Readonly<import('vue').Ref<boolean, boolean>>;
+    activate: () => void;
+    deactivate: () => void;
+};
+export {};
+//# sourceMappingURL=useFocusTrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFocusTrap.d.ts","sourceRoot":"","sources":["../../src/composables/useFocusTrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,gBAAgB,EACtB,MAAM,KAAK,CAAA;AAcZ,KAAK,aAAa,GAAG,gBAAgB,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAErE,MAAM,WAAW,gBAAgB;IAC/B,uFAAuF;IACvF,MAAM,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAClC;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,KAAK,CAAA;IAC7D;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;CAC/D;AAiBD,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,WAAW,GAAG,WAAW,EAAE,CAUzE;AA+DD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAM;;;;EA8CpG;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,gBAAqB;;;;EAkCjF"}

package/dist/composables/useFormField.d.ts

@@ -0,0 +1,76 @@
+import { ComputedRef, InjectionKey, Ref } from 'vue';
+import { Size, State } from '../types';
+/** Contrôle enregistré auprès du champ */
+export interface FormFieldControl {
+    /**
+     * `false` pour un contrôle qu'un <label for> ne sait pas cibler
+     * (combobox en div, groupe de cases) : le clic sur le label lui donne
+     * alors le focus, et il est nommé par aria-labelledby.
+     */
+    labelable: boolean;
+    focus?: () => void;
+}
+export interface FormFieldContext {
+    /** Id du contrôle (cible du label) */
+    id: Readonly<Ref<string>>;
+    /** Id du label, s'il y en a un */
+    labelId: Readonly<Ref<string | undefined>>;
+    /** Id du message, s'il y en a un */
+    messageId: Readonly<Ref<string | undefined>>;
+    state: Readonly<Ref<State>>;
+    size: Readonly<Ref<Size>>;
+    required: Readonly<Ref<boolean>>;
+    disabled: Readonly<Ref<boolean>>;
+    /** Enregistre le contrôle ; renvoie la fonction de désenregistrement */
+    registerControl: (control: FormFieldControl) => () => void;
+}
+export declare const FormFieldKey: InjectionKey<FormFieldContext>;
+/** Fournit le contexte aux descendants (utilisé par SuFormField) */
+export declare function provideFormField(context: FormFieldContext): FormFieldContext;
+/** Joint des listes d'ids (aria-describedby…) sans doublons ni vides */
+export declare function mergeIds(...ids: (string | undefined | null | false)[]): string | undefined;
+/** Props d'un contrôle que le champ peut compléter */
+export interface FormFieldControlProps {
+    state?: State;
+    size?: Size;
+    disabled?: boolean;
+    required?: boolean;
+    ariaLabelledBy?: string;
+    ariaDescribedBy?: string;
+}
+export interface UseFormFieldOptions {
+    /** Le contrôle est-il ciblable par <label for> ? (défaut : true) */
+    labelable?: boolean;
+    /** Donne le focus au contrôle (clic sur le label d'un contrôle non ciblable) */
+    focus?: () => void;
+    /** Préfixe de l'id généré hors champ ; sans préfixe, pas d'id généré */
+    idPrefix?: string;
+}
+export interface UseFormFieldReturn {
+    /** Contexte du champ parent, ou null hors SuFormField */
+    field: FormFieldContext | null;
+    /** Id du contrôle : attribut id, sinon celui du champ, sinon généré (avec idPrefix) */
+    id: ComputedRef<string | undefined>;
+    state: ComputedRef<State>;
+    size: ComputedRef<Size>;
+    disabled: ComputedRef<boolean>;
+    required: ComputedRef<boolean>;
+    /** aria-describedby : celui du contrôle + message du champ */
+    describedBy: ComputedRef<string | undefined>;
+    /** aria-labelledby : celui du contrôle, sinon le label du champ (contrôle non ciblable) */
+    labelledBy: ComputedRef<string | undefined>;
+}
+/**
+ * Relie un contrôle au SuFormField qui l'entoure.
+ *
+ * Priorité : valeur explicite du contrôle > valeur du champ > défaut.
+ * `state` et `size` du contrôle comptent comme explicites quand ils
+ * diffèrent de leur défaut (`default`, `md`) ; `disabled` et `required`
+ * s'additionnent (un champ désactivé désactive son contrôle).
+ *
+ * @example
+ * const props = withDefaults(defineProps<MyControlProps>(), { state: 'default', size: 'md' })
+ * const { id, state, describedBy } = useFormField(props, { idPrefix: 'my-control' })
+ */
+export declare function useFormField(props: FormFieldControlProps, options?: UseFormFieldOptions): UseFormFieldReturn;
+//# sourceMappingURL=useFormField.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFormField.d.ts","sourceRoot":"","sources":["../../src/composables/useFormField.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,GAAG,EACT,MAAM,KAAK,CAAA;AACZ,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAU1C,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACzB,kCAAkC;IAClC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;IAC1C,oCAAoC;IACpC,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;IAC5C,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;IAC3B,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;IACzB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;IAChC,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;IAChC,wEAAwE;IACxE,eAAe,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,MAAM,IAAI,CAAA;CAC3D;AAED,eAAO,MAAM,YAAY,EAAE,YAAY,CAAC,gBAAgB,CAA4B,CAAA;AAEpF,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAG5E;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CAAC,GAAG,GAAG,EAAE,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,KAAK,CAAC,EAAE,GAAG,MAAM,GAAG,SAAS,CAG1F;AAED,sDAAsD;AACtD,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;IAClB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC9B,uFAAuF;IACvF,EAAE,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACnC,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,CAAA;IACzB,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAA;IACvB,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAC9B,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAC9B,8DAA8D;IAC9D,WAAW,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC5C,2FAA2F;IAC3F,UAAU,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CAC5C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,qBAAqB,EAC5B,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CA+BpB"}

package/dist/composables/useListNavigation.d.ts

@@ -0,0 +1,40 @@
+import { MaybeRefOrGetter } from 'vue';
+export type ListOrientation = 'vertical' | 'horizontal' | 'both';
+export interface ListNavigationOptions<T> {
+    items: MaybeRefOrGetter<readonly T[]>;
+    /** Éléments sautés par la navigation */
+    isDisabled?: (item: T, index: number) => boolean;
+    /** Flèches actives : haut/bas, gauche/droite, ou les quatre (défaut : vertical) */
+    orientation?: ListOrientation;
+    /** Boucle de la fin au début (défaut : false) */
+    loop?: boolean;
+    /** Début / Fin vont au premier / dernier élément (défaut : true) */
+    homeEnd?: boolean;
+    /** `roving` déplace le focus DOM ; `virtual` le laisse en place (défaut) */
+    mode?: 'roving' | 'virtual';
+    /** Élément DOM d'un index (mode roving) */
+    getElement?: (index: number) => HTMLElement | null | undefined;
+    /** Saisie rapide : texte de chaque élément */
+    typeahead?: {
+        getLabel: (item: T) => string;
+        timeout?: number;
+    } | false;
+    /** Appelé quand l'élément actif change (activation automatique des onglets…) */
+    onActiveChange?: (index: number) => void;
+}
+export declare function useListNavigation<T>(options: ListNavigationOptions<T>): {
+    activeIndex: import('vue').Ref<number, number>;
+    setActiveIndex: (index: number, { focus }?: {
+        focus?: boolean | undefined;
+    }) => void;
+    first: () => number;
+    last: () => number;
+    next: () => number;
+    previous: () => number;
+    findEnabled: (start: number, step: 1 | -1) => number;
+    handleKeydown: (event: KeyboardEvent) => boolean;
+    searchTypeahead: (char: string) => number;
+    isTyping: () => boolean;
+    reset: () => void;
+};
+//# sourceMappingURL=useListNavigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useListNavigation.d.ts","sourceRoot":"","sources":["../../src/composables/useListNavigation.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAenE,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAA;AAEhE,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,KAAK,EAAE,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;IACrC,wCAAwC;IACxC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;IAChD,mFAAmF;IACnF,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC3B,2CAA2C;IAC3C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,GAAG,SAAS,CAAA;IAC9D,8CAA8C;IAC9C,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAA;IACvE,gFAAgF;IAChF,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACzC;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC;;4BA+BrC,MAAM;;;;;;;yBART,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;2BAgElB,aAAa,KAAG,OAAO;4BAwDtB,MAAM;;;EAyBtC"}

package/dist/composables/useLocale.d.ts

@@ -0,0 +1,33 @@
+import { ComputedRef, InjectionKey, MaybeRefOrGetter } from 'vue';
+import { LocaleMessage, MessageKey, MessageParams, SurgeLocale, SurgeLocaleInput } from '../locales/types';
+export declare const LocaleKey: InjectionKey<ComputedRef<SurgeLocale>>;
+/**
+ * Complète une locale de base avec des messages partiels.
+ * @example defineLocale(en, { messages: { selectBox: { placeholder: 'Pick one…' } } })
+ */
+export declare function defineLocale(base: SurgeLocale, overrides?: SurgeLocaleInput | SurgeLocale): SurgeLocale;
+/** Met en forme un message : forme plurielle selon `count`, puis paramètres `{nom}` */
+export declare function formatMessage(message: LocaleMessage, params?: MessageParams, code?: string): string;
+/**
+ * Fournit une locale à un sous-arbre de composants. Les messages partiels
+ * complètent la locale du parent (ou le français).
+ *
+ * @example
+ * // Dans le composant racine : la langue suit l'état de l'application
+ * provideLocale(() => (lang.value === 'en' ? en : fr))
+ */
+export declare function provideLocale(locale: MaybeRefOrGetter<SurgeLocale | SurgeLocaleInput>): ComputedRef<SurgeLocale>;
+/**
+ * Accès aux textes de la locale courante.
+ *
+ * @example
+ * const { t } = useLocale()
+ * const label = computed(() => props.clearLabel ?? t('selectBox.clear'))
+ * t('fileUpload.selectedCount', { count: 3 }) // « 3 fichiers sélectionnés »
+ */
+export declare function useLocale(): {
+    locale: ComputedRef<SurgeLocale>;
+    t: (key: MessageKey, params?: MessageParams) => string;
+    formatBytes: (bytes: number) => string;
+};
+//# sourceMappingURL=useLocale.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLocale.d.ts","sourceRoot":"","sources":["../../src/composables/useLocale.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,KAAK,CAAA;AAEZ,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,aAAa,EACb,WAAW,EACX,gBAAgB,EAEjB,MAAM,iBAAiB,CAAA;AAUxB,eAAO,MAAM,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,WAAW,CAAC,CAAyB,CAAA;AAEtF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,gBAAgB,GAAG,WAAW,GAAG,WAAW,CAUvG;AAiBD,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,GAAE,aAAkB,EAAE,IAAI,SAAO,GAAG,MAAM,CAcrG;AAOD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,CAAC,WAAW,GAAG,gBAAgB,CAAC,4BAKrF;AAID;;;;;;;GAOG;AACH,wBAAgB,SAAS;;aAKP,UAAU,WAAW,aAAa,KAAG,MAAM;yBAM/B,MAAM,KAAG,MAAM;EAoB5C"}

package/dist/composables/useTheme.d.ts

@@ -5,10 +5,10 @@ export declare function useTheme(options?: UseThemeOptions): {
     contrastMode: import('vue').Ref<ContrastMode, ContrastMode>;
     motionMode: import('vue').Ref<MotionMode, MotionMode>;
     effectiveTheme: import('vue').ComputedRef<ThemeName>;
-    effectiveThemeMode: import('vue').ComputedRef<"dark" | "light">;
+    effectiveThemeMode: import('vue').ComputedRef<"light" | "dark">;
     effectiveContrast: import('vue').ComputedRef<"normal" | "high">;
     effectiveMotion: import('vue').ComputedRef<"reduce" | "normal">;
-    systemTheme: import('vue').ComputedRef<"dark" | "light">;
+    systemTheme: import('vue').ComputedRef<"light" | "dark">;
     systemContrast: import('vue').ComputedRef<"normal" | "high">;
     systemMotion: import('vue').ComputedRef<"reduce" | "normal">;
     currentThemeMetadata: import('vue').ComputedRef<ThemeMetadata>;

package/dist/composables/useTypeahead.d.ts

@@ -0,0 +1,17 @@
+import { MaybeRefOrGetter } from 'vue';
+export interface TypeaheadOptions<T> {
+    items: MaybeRefOrGetter<readonly T[]>;
+    /** Texte comparé au préfixe saisi */
+    getLabel: (item: T) => string;
+    /** Éléments ignorés */
+    isDisabled?: (item: T, index: number) => boolean;
+    /** Délai d'inactivité qui remet le préfixe à zéro (ms) */
+    timeout?: number;
+}
+export declare function useTypeahead<T>(options: TypeaheadOptions<T>): {
+    search: (char: string, fromIndex: number) => number;
+    reset: () => void;
+    /** Une saisie est en cours (Espace complète alors le préfixe) */
+    isTyping: () => boolean;
+};
+//# sourceMappingURL=useTypeahead.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTypeahead.d.ts","sourceRoot":"","sources":["../../src/composables/useTypeahead.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,KAAK,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAUzF,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,KAAK,EAAE,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;IACrC,qCAAqC;IACrC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;IAC7B,uBAAuB;IACvB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;IAChD,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC;mBAepC,MAAM,aAAa,MAAM,KAAG,MAAM;;IA6BtD,iEAAiE;;EAGpE"}

package/dist/composables/useUniqueId.d.ts

@@ -1,5 +1,9 @@
 /**
  * Composable pour générer des IDs uniques
+ *
+ * Dans un composant, préférer `useId()` de Vue (3.5+) : il produit le même ID
+ * côté serveur et côté client. Ce compteur reste disponible hors composant ;
+ * il est déterministe (pas d'horodatage) pour limiter les écarts d'hydratation.
  */
 export declare function useUniqueId(prefix?: string): string;
 //# sourceMappingURL=useUniqueId.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useUniqueId.d.ts","sourceRoot":"","sources":["../../src/composables/useUniqueId.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAgB,WAAW,CAAC,MAAM,GAAE,MAAa,GAAG,MAAM,CAEzD"}
+{"version":3,"file":"useUniqueId.d.ts","sourceRoot":"","sources":["../../src/composables/useUniqueId.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wBAAgB,WAAW,CAAC,MAAM,GAAE,MAAa,GAAG,MAAM,CAEzD"}

package/dist/{index-BAchYb_D.js → index-DxsqHbLv.js}

@@ -1,5 +1,5 @@
 import { createElementBlock as o, openBlock as n, createElementVNode as r } from "vue";
-import { r as Wr, a as Xr, b as Qr, c as Kr, d as Yr, e as Jr, f as ro, g as oo, i as no, h as eo, j as to, k as ao, l as io, m as co } from "./index-B8fo_rCP.js";
+import { r as Wr, a as Xr, b as Qr, c as Kr, d as Yr, e as Jr, f as ro, g as oo, i as no, h as eo, j as to, k as ao, l as io, m as co } from "./index-n-LN9d8r.js";
 function i(e, t) {
   return n(), o("svg", {
     xmlns: "http://www.w3.org/2000/svg",