@lab-anssi/ui-kit 1.61.3 → 1.62.0

package/dist/utilitaires/createFormValidation.svelte.js

@@ -0,0 +1,183 @@
+/**
+ * Crée un état de validation pour les composants de formulaire.
+ * Encapsule la logique de validation des contraintes HTML pour les custom elements.
+ *
+ * @returns Un objet contenant l'état de validation et les méthodes associées
+ *
+ * @example
+ * ```typescript
+ * const validation = createFormValidation();
+ *
+ * // Dans un $effect
+ * validation.setup(internals, formControlElement, host, () => value);
+ *
+ * // Dans le template
+ * <input
+ *   bind:this={formControlElement}
+ *   onblur={validation.handleBlur}
+ *   oninvalid={validation.handleInvalid}
+ * />
+ * ```
+ */
+export function createFormValidation() {
+    let customValidityMessage = $state("");
+    let hasInteracted = $state(false);
+    let localStatus = $state("default");
+    let localErrorMessage = $state("");
+    let internals;
+    let formControlElement;
+    let host;
+    let resetValueCallback;
+    /**
+     * Met à jour la validité du champ de formulaire.
+     * Vérifie les messages de validité personnalisés et la validité native du formulaire.
+     * Met à jour l'état local et le message d'erreur si l'utilisateur a interagi avec le champ.
+     */
+    function updateValidity() {
+        if (!internals || !formControlElement)
+            return;
+        if (customValidityMessage) {
+            internals.setValidity({ customError: true }, customValidityMessage, formControlElement);
+            if (hasInteracted) {
+                localStatus = "error";
+                localErrorMessage = customValidityMessage;
+            }
+        }
+        else if (!formControlElement.validity.valid) {
+            internals.setValidity(formControlElement.validity, formControlElement.validationMessage, formControlElement);
+            if (hasInteracted) {
+                localStatus = "error";
+                localErrorMessage = formControlElement.validationMessage;
+            }
+        }
+        else {
+            internals.setValidity({});
+            if (hasInteracted) {
+                localStatus = "default";
+                localErrorMessage = "";
+            }
+        }
+    }
+    /**
+     * Gère l'événement blur du champ de formulaire.
+     * Marque le composant comme ayant interagi si la valeur n'est pas vide.
+     *
+     * @param {Event} event - L'événement blur déclenché
+     */
+    function handleBlur(event) {
+        const target = event.target;
+        if (!hasInteracted && "value" in target && target.value) {
+            hasInteracted = true;
+            updateValidity();
+        }
+    }
+    /**
+     * Gère l'événement invalid du champ de formulaire.
+     * Marque le composant comme ayant interagi et met à jour la validité.
+     *
+     * @param {Event} event - L'événement invalid déclenché
+     */
+    function handleInvalid(event) {
+        event.preventDefault();
+        hasInteracted = true;
+        updateValidity();
+    }
+    /**
+     * Gère l'événement formreset du formulaire.
+     * Réinitialise l'état du composant lors du reset du formulaire.
+     */
+    function handleFormReset() {
+        if (resetValueCallback) {
+            resetValueCallback();
+        }
+        hasInteracted = false;
+        localStatus = "default";
+        localErrorMessage = "";
+        customValidityMessage = "";
+        if (internals) {
+            internals.setValidity({});
+        }
+    }
+    /**
+     * Définit un message de validité personnalisé pour le champ.
+     * Met à jour le message de validité personnalisé et déclenche la vérification de validité.
+     *
+     * @param {string} message - Le message de validité personnalisé à définir
+     */
+    function setCustomValidity(message) {
+        customValidityMessage = message;
+        updateValidity();
+    }
+    /**
+     * Stocke les références nécessaires à la validation.
+     * À appeler une fois au montage du composant dans un $effect.
+     *
+     * @param {ElementInternals} internalsRef - L'interface ElementInternals du custom element
+     * @param {HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement} element - L'élément de formulaire natif
+     * @param {HTMLElement} hostElement - L'élément hôte du custom element
+     * @param {() => void} resetCallback - Fonction pour réinitialiser la valeur lors du reset
+     */
+    function setup(internalsRef, element, hostElement, resetCallback) {
+        internals = internalsRef;
+        formControlElement = element;
+        host = hostElement;
+        resetValueCallback = resetCallback;
+    }
+    /**
+     * Synchronise la valeur du formulaire et met à jour la validité.
+     * À appeler dans un $effect qui observe les changements de valeur.
+     *
+     * @param {string | undefined} value - La valeur actuelle du champ
+     * @param {boolean} bypassNativeValidation - Permet de "bypasser" la validation native
+     */
+    function syncFormValue(value, bypassNativeValidation = false) {
+        if (!internals || !formControlElement)
+            return;
+        internals.setFormValue(value ?? "");
+        if (bypassNativeValidation) {
+            internals.setValidity({});
+        }
+        else {
+            updateValidity();
+        }
+    }
+    /**
+     * Attache les event listeners pour la validation.
+     * À appeler dans un $effect pour gérer le cycle de vie.
+     *
+     * @returns Fonction de cleanup pour retirer les listeners
+     */
+    function attachListeners() {
+        if (!host || !internals)
+            return;
+        host.addEventListener("invalid", handleInvalid);
+        internals.form?.addEventListener("reset", handleFormReset);
+        return () => {
+            host?.removeEventListener("invalid", handleInvalid);
+            internals?.form?.removeEventListener("reset", handleFormReset);
+        };
+    }
+    return {
+        // État réactif
+        get customValidityMessage() {
+            return customValidityMessage;
+        },
+        get hasInteracted() {
+            return hasInteracted;
+        },
+        get localStatus() {
+            return localStatus;
+        },
+        get localErrorMessage() {
+            return localErrorMessage;
+        },
+        // Méthodes
+        setup,
+        updateValidity,
+        handleBlur,
+        handleInvalid,
+        setCustomValidity,
+        syncFormValue,
+        attachListeners,
+    };
+}

package/dist/utilitaires/icons-stylesheet.d.ts

@@ -0,0 +1,370 @@
+/**
+ * Retourne la feuille de style partagée des icônes DSFR.
+ */
+export declare function getIconsStyleSheet(): CSSStyleSheet;
+type CustomElementConstructor = new (...args: unknown[]) => HTMLElement;
+/**
+ * Permet d'étendre la class des WebComponents afin d'injecter la feuille de style des icônes DSFR dans le Shadow DOM.
+ */
+export declare function withIconsStyleSheet(CustomElementClass: CustomElementConstructor): {
+    new (...args: unknown[]): {
+        connectedCallback(): void;
+        accessKey: string;
+        readonly accessKeyLabel: string;
+        autocapitalize: string;
+        autocorrect: boolean;
+        dir: string;
+        draggable: boolean;
+        hidden: boolean | "until-found";
+        inert: boolean;
+        innerText: string;
+        lang: string;
+        readonly offsetHeight: number;
+        readonly offsetLeft: number;
+        readonly offsetParent: Element | null;
+        readonly offsetTop: number;
+        readonly offsetWidth: number;
+        outerText: string;
+        popover: string | null;
+        spellcheck: boolean;
+        title: string;
+        translate: boolean;
+        writingSuggestions: string;
+        attachInternals(): ElementInternals;
+        click(): void;
+        hidePopover(): void;
+        showPopover(options?: ShowPopoverOptions): void;
+        togglePopover(options?: TogglePopoverOptions | boolean): boolean;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+        readonly attributes: NamedNodeMap;
+        get classList(): DOMTokenList;
+        set classList(value: string);
+        className: string;
+        readonly clientHeight: number;
+        readonly clientLeft: number;
+        readonly clientTop: number;
+        readonly clientWidth: number;
+        readonly currentCSSZoom: number;
+        readonly customElementRegistry: CustomElementRegistry | null;
+        id: string;
+        innerHTML: string;
+        readonly localName: string;
+        readonly namespaceURI: string | null;
+        onfullscreenchange: ((this: Element, ev: Event) => any) | null;
+        onfullscreenerror: ((this: Element, ev: Event) => any) | null;
+        outerHTML: string;
+        readonly ownerDocument: Document;
+        get part(): DOMTokenList;
+        set part(value: string);
+        readonly prefix: string | null;
+        readonly scrollHeight: number;
+        scrollLeft: number;
+        scrollTop: number;
+        readonly scrollWidth: number;
+        readonly shadowRoot: ShadowRoot | null;
+        slot: string;
+        readonly tagName: string;
+        attachShadow(init: ShadowRootInit): ShadowRoot;
+        checkVisibility(options?: CheckVisibilityOptions): boolean;
+        closest<K extends keyof HTMLElementTagNameMap>(selector: K): HTMLElementTagNameMap[K] | null;
+        closest<K extends keyof SVGElementTagNameMap>(selector: K): SVGElementTagNameMap[K] | null;
+        closest<K extends keyof MathMLElementTagNameMap>(selector: K): MathMLElementTagNameMap[K] | null;
+        closest<E extends Element = Element>(selectors: string): E | null;
+        computedStyleMap(): StylePropertyMapReadOnly;
+        getAttribute(qualifiedName: string): string | null;
+        getAttributeNS(namespace: string | null, localName: string): string | null;
+        getAttributeNames(): string[];
+        getAttributeNode(qualifiedName: string): Attr | null;
+        getAttributeNodeNS(namespace: string | null, localName: string): Attr | null;
+        getBoundingClientRect(): DOMRect;
+        getClientRects(): DOMRectList;
+        getElementsByClassName(classNames: string): HTMLCollectionOf<Element>;
+        getElementsByTagName<K extends keyof HTMLElementTagNameMap>(qualifiedName: K): HTMLCollectionOf<HTMLElementTagNameMap[K]>;
+        getElementsByTagName<K extends keyof SVGElementTagNameMap>(qualifiedName: K): HTMLCollectionOf<SVGElementTagNameMap[K]>;
+        getElementsByTagName<K extends keyof MathMLElementTagNameMap>(qualifiedName: K): HTMLCollectionOf<MathMLElementTagNameMap[K]>;
+        getElementsByTagName<K extends keyof HTMLElementDeprecatedTagNameMap>(qualifiedName: K): HTMLCollectionOf<HTMLElementDeprecatedTagNameMap[K]>;
+        getElementsByTagName(qualifiedName: string): HTMLCollectionOf<Element>;
+        getElementsByTagNameNS(namespaceURI: "http://www.w3.org/1999/xhtml", localName: string): HTMLCollectionOf<HTMLElement>;
+        getElementsByTagNameNS(namespaceURI: "http://www.w3.org/2000/svg", localName: string): HTMLCollectionOf<SVGElement>;
+        getElementsByTagNameNS(namespaceURI: "http://www.w3.org/1998/Math/MathML", localName: string): HTMLCollectionOf<MathMLElement>;
+        getElementsByTagNameNS(namespace: string | null, localName: string): HTMLCollectionOf<Element>;
+        getHTML(options?: GetHTMLOptions): string;
+        hasAttribute(qualifiedName: string): boolean;
+        hasAttributeNS(namespace: string | null, localName: string): boolean;
+        hasAttributes(): boolean;
+        hasPointerCapture(pointerId: number): boolean;
+        insertAdjacentElement(where: InsertPosition, element: Element): Element | null;
+        insertAdjacentHTML(position: InsertPosition, string: string): void;
+        insertAdjacentText(where: InsertPosition, data: string): void;
+        matches<K extends keyof HTMLElementTagNameMap>(selectors: K): this is HTMLElementTagNameMap[K];
+        matches<K extends keyof SVGElementTagNameMap>(selectors: K): this is SVGElementTagNameMap[K];
+        matches<K extends keyof MathMLElementTagNameMap>(selectors: K): this is MathMLElementTagNameMap[K];
+        matches(selectors: string): boolean;
+        releasePointerCapture(pointerId: number): void;
+        removeAttribute(qualifiedName: string): void;
+        removeAttributeNS(namespace: string | null, localName: string): void;
+        removeAttributeNode(attr: Attr): Attr;
+        requestFullscreen(options?: FullscreenOptions): Promise<void>;
+        requestPointerLock(options?: PointerLockOptions): Promise<void>;
+        scroll(options?: ScrollToOptions): void;
+        scroll(x: number, y: number): void;
+        scrollBy(options?: ScrollToOptions): void;
+        scrollBy(x: number, y: number): void;
+        scrollIntoView(arg?: boolean | ScrollIntoViewOptions): void;
+        scrollTo(options?: ScrollToOptions): void;
+        scrollTo(x: number, y: number): void;
+        setAttribute(qualifiedName: string, value: string): void;
+        setAttributeNS(namespace: string | null, qualifiedName: string, value: string): void;
+        setAttributeNode(attr: Attr): Attr | null;
+        setAttributeNodeNS(attr: Attr): Attr | null;
+        setHTMLUnsafe(html: string): void;
+        setPointerCapture(pointerId: number): void;
+        toggleAttribute(qualifiedName: string, force?: boolean): boolean;
+        webkitMatchesSelector(selectors: string): boolean;
+        get textContent(): string;
+        set textContent(value: string | null);
+        readonly baseURI: string;
+        readonly childNodes: NodeListOf<ChildNode>;
+        readonly firstChild: ChildNode | null;
+        readonly isConnected: boolean;
+        readonly lastChild: ChildNode | null;
+        readonly nextSibling: ChildNode | null;
+        readonly nodeName: string;
+        readonly nodeType: number;
+        nodeValue: string | null;
+        readonly parentElement: HTMLElement | null;
+        readonly parentNode: ParentNode | null;
+        readonly previousSibling: ChildNode | null;
+        appendChild<T extends Node>(node: T): T;
+        cloneNode(subtree?: boolean): Node;
+        compareDocumentPosition(other: Node): number;
+        contains(other: Node | null): boolean;
+        getRootNode(options?: GetRootNodeOptions): Node;
+        hasChildNodes(): boolean;
+        insertBefore<T extends Node>(node: T, child: Node | null): T;
+        isDefaultNamespace(namespace: string | null): boolean;
+        isEqualNode(otherNode: Node | null): boolean;
+        isSameNode(otherNode: Node | null): boolean;
+        lookupNamespaceURI(prefix: string | null): string | null;
+        lookupPrefix(namespace: string | null): string | null;
+        normalize(): void;
+        removeChild<T extends Node>(child: T): T;
+        replaceChild<T extends Node>(node: Node, child: T): T;
+        readonly ELEMENT_NODE: 1;
+        readonly ATTRIBUTE_NODE: 2;
+        readonly TEXT_NODE: 3;
+        readonly CDATA_SECTION_NODE: 4;
+        readonly ENTITY_REFERENCE_NODE: 5;
+        readonly ENTITY_NODE: 6;
+        readonly PROCESSING_INSTRUCTION_NODE: 7;
+        readonly COMMENT_NODE: 8;
+        readonly DOCUMENT_NODE: 9;
+        readonly DOCUMENT_TYPE_NODE: 10;
+        readonly DOCUMENT_FRAGMENT_NODE: 11;
+        readonly NOTATION_NODE: 12;
+        readonly DOCUMENT_POSITION_DISCONNECTED: 1;
+        readonly DOCUMENT_POSITION_PRECEDING: 2;
+        readonly DOCUMENT_POSITION_FOLLOWING: 4;
+        readonly DOCUMENT_POSITION_CONTAINS: 8;
+        readonly DOCUMENT_POSITION_CONTAINED_BY: 16;
+        readonly DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: 32;
+        dispatchEvent(event: Event): boolean;
+        ariaActiveDescendantElement: Element | null;
+        ariaAtomic: string | null;
+        ariaAutoComplete: string | null;
+        ariaBrailleLabel: string | null;
+        ariaBrailleRoleDescription: string | null;
+        ariaBusy: string | null;
+        ariaChecked: string | null;
+        ariaColCount: string | null;
+        ariaColIndex: string | null;
+        ariaColIndexText: string | null;
+        ariaColSpan: string | null;
+        ariaControlsElements: ReadonlyArray<Element> | null;
+        ariaCurrent: string | null;
+        ariaDescribedByElements: ReadonlyArray<Element> | null;
+        ariaDescription: string | null;
+        ariaDetailsElements: ReadonlyArray<Element> | null;
+        ariaDisabled: string | null;
+        ariaErrorMessageElements: ReadonlyArray<Element> | null;
+        ariaExpanded: string | null;
+        ariaFlowToElements: ReadonlyArray<Element> | null;
+        ariaHasPopup: string | null;
+        ariaHidden: string | null;
+        ariaInvalid: string | null;
+        ariaKeyShortcuts: string | null;
+        ariaLabel: string | null;
+        ariaLabelledByElements: ReadonlyArray<Element> | null;
+        ariaLevel: string | null;
+        ariaLive: string | null;
+        ariaModal: string | null;
+        ariaMultiLine: string | null;
+        ariaMultiSelectable: string | null;
+        ariaOrientation: string | null;
+        ariaOwnsElements: ReadonlyArray<Element> | null;
+        ariaPlaceholder: string | null;
+        ariaPosInSet: string | null;
+        ariaPressed: string | null;
+        ariaReadOnly: string | null;
+        ariaRelevant: string | null;
+        ariaRequired: string | null;
+        ariaRoleDescription: string | null;
+        ariaRowCount: string | null;
+        ariaRowIndex: string | null;
+        ariaRowIndexText: string | null;
+        ariaRowSpan: string | null;
+        ariaSelected: string | null;
+        ariaSetSize: string | null;
+        ariaSort: string | null;
+        ariaValueMax: string | null;
+        ariaValueMin: string | null;
+        ariaValueNow: string | null;
+        ariaValueText: string | null;
+        role: string | null;
+        animate(keyframes: Keyframe[] | PropertyIndexedKeyframes | null, options?: number | KeyframeAnimationOptions): Animation;
+        getAnimations(options?: GetAnimationsOptions): Animation[];
+        after(...nodes: (Node | string)[]): void;
+        before(...nodes: (Node | string)[]): void;
+        remove(): void;
+        replaceWith(...nodes: (Node | string)[]): void;
+        readonly nextElementSibling: Element | null;
+        readonly previousElementSibling: Element | null;
+        readonly childElementCount: number;
+        readonly children: HTMLCollection;
+        readonly firstElementChild: Element | null;
+        readonly lastElementChild: Element | null;
+        append(...nodes: (Node | string)[]): void;
+        moveBefore(node: Node, child: Node | null): void;
+        prepend(...nodes: (Node | string)[]): void;
+        querySelector<K extends keyof HTMLElementTagNameMap>(selectors: K): HTMLElementTagNameMap[K] | null;
+        querySelector<K extends keyof SVGElementTagNameMap>(selectors: K): SVGElementTagNameMap[K] | null;
+        querySelector<K extends keyof MathMLElementTagNameMap>(selectors: K): MathMLElementTagNameMap[K] | null;
+        querySelector<K extends keyof HTMLElementDeprecatedTagNameMap>(selectors: K): HTMLElementDeprecatedTagNameMap[K] | null;
+        querySelector<E extends Element = Element>(selectors: string): E | null;
+        querySelectorAll<K extends keyof HTMLElementTagNameMap>(selectors: K): NodeListOf<HTMLElementTagNameMap[K]>;
+        querySelectorAll<K extends keyof SVGElementTagNameMap>(selectors: K): NodeListOf<SVGElementTagNameMap[K]>;
+        querySelectorAll<K extends keyof MathMLElementTagNameMap>(selectors: K): NodeListOf<MathMLElementTagNameMap[K]>;
+        querySelectorAll<K extends keyof HTMLElementDeprecatedTagNameMap>(selectors: K): NodeListOf<HTMLElementDeprecatedTagNameMap[K]>;
+        querySelectorAll<E extends Element = Element>(selectors: string): NodeListOf<E>;
+        replaceChildren(...nodes: (Node | string)[]): void;
+        readonly assignedSlot: HTMLSlotElement | null;
+        readonly attributeStyleMap: StylePropertyMap;
+        get style(): CSSStyleDeclaration;
+        set style(cssText: string);
+        contentEditable: string;
+        enterKeyHint: string;
+        inputMode: string;
+        readonly isContentEditable: boolean;
+        onabort: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null;
+        onanimationcancel: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onanimationend: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onanimationiteration: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onanimationstart: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onauxclick: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onbeforeinput: ((this: GlobalEventHandlers, ev: InputEvent) => any) | null;
+        onbeforematch: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onbeforetoggle: ((this: GlobalEventHandlers, ev: ToggleEvent) => any) | null;
+        onblur: ((this: GlobalEventHandlers, ev: FocusEvent) => any) | null;
+        oncancel: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oncanplay: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oncanplaythrough: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onclick: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onclose: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oncommand: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oncontextlost: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oncontextmenu: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        oncontextrestored: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oncopy: ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
+        oncuechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oncut: ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
+        ondblclick: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        ondrag: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragend: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragenter: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragleave: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragover: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragstart: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondrop: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondurationchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onemptied: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onended: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onerror: OnErrorEventHandler;
+        onfocus: ((this: GlobalEventHandlers, ev: FocusEvent) => any) | null;
+        onformdata: ((this: GlobalEventHandlers, ev: FormDataEvent) => any) | null;
+        ongotpointercapture: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        oninput: ((this: GlobalEventHandlers, ev: InputEvent) => any) | null;
+        oninvalid: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onkeydown: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
+        onkeypress: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
+        onkeyup: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
+        onload: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onloadeddata: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onloadedmetadata: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onloadstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onlostpointercapture: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onmousedown: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseenter: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseleave: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmousemove: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseout: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseover: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseup: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onpaste: ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
+        onpause: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onplay: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onplaying: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onpointercancel: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerdown: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerenter: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerleave: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointermove: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerout: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerover: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerrawupdate: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onpointerup: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onprogress: ((this: GlobalEventHandlers, ev: ProgressEvent) => any) | null;
+        onratechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onreset: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onresize: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null;
+        onscroll: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onscrollend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onsecuritypolicyviolation: ((this: GlobalEventHandlers, ev: SecurityPolicyViolationEvent) => any) | null;
+        onseeked: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onseeking: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onselect: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onselectionchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onselectstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onslotchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onstalled: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onsubmit: ((this: GlobalEventHandlers, ev: SubmitEvent) => any) | null;
+        onsuspend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        ontimeupdate: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        ontoggle: ((this: GlobalEventHandlers, ev: ToggleEvent) => any) | null;
+        ontouchcancel?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontouchend?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontouchmove?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontouchstart?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontransitioncancel: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        ontransitionend: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        ontransitionrun: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        ontransitionstart: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        onvolumechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwaiting: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkitanimationend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkitanimationiteration: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkitanimationstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkittransitionend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwheel: ((this: GlobalEventHandlers, ev: WheelEvent) => any) | null;
+        autofocus: boolean;
+        readonly dataset: DOMStringMap;
+        nonce: string;
+        tabIndex: number;
+        blur(): void;
+        focus(options?: FocusOptions): void;
+    };
+};
+export {};

package/dist/utilitaires/icons-stylesheet.js

@@ -0,0 +1,33 @@
+import dsfrIcons from "../styles/dsfr-icons.css?inline";
+let iconsStyleSheet = null;
+/**
+ * Retourne la feuille de style partagée des icônes DSFR.
+ */
+export function getIconsStyleSheet() {
+    if (!iconsStyleSheet) {
+        iconsStyleSheet = new CSSStyleSheet();
+        iconsStyleSheet.replaceSync(dsfrIcons);
+    }
+    return iconsStyleSheet;
+}
+/**
+ * Permet d'étendre la class des WebComponents afin d'injecter la feuille de style des icônes DSFR dans le Shadow DOM.
+ */
+export function withIconsStyleSheet(CustomElementClass) {
+    const ParentClass = CustomElementClass;
+    return class extends ParentClass {
+        connectedCallback() {
+            super.connectedCallback?.();
+            const iconsStyleSheet = getIconsStyleSheet();
+            const shadow = this.shadowRoot;
+            if (!shadow)
+                return;
+            const styleSheets = shadow?.adoptedStyleSheets;
+            if (!Array.isArray(styleSheets))
+                return;
+            if (!styleSheets.includes(iconsStyleSheet)) {
+                shadow.adoptedStyleSheets = [iconsStyleSheet, ...shadow.adoptedStyleSheets];
+            }
+        }
+    };
+}

package/dist/utilitaires/index.d.ts

@@ -0,0 +1,14 @@
+export { getIconsStyleSheet, withIconsStyleSheet } from "./icons-stylesheet";
+/**
+ * Génère une classe d'icône FR avec validation
+ * @param {string} icon - Le nom de l'icône
+ * @returns {string} La classe CSS complète ou une classe par défaut
+ */
+export declare function setIconClass(icon: string): string | undefined;
+/**
+ * Marque un Web Component comme thématisable via l'attribut data-themeable
+ * Permet d'appliquer des styles conditionnels basés sur cet attribut
+ * @param {HTMLElement | undefined} host - L'élément host du Web Component ($host)
+ * @param {boolean} [active=true] - Indique si le thème est actif ou non
+ */
+export declare function setThemeable(host: HTMLElement | undefined, active?: boolean): void;

package/dist/utilitaires/index.js

@@ -0,0 +1,26 @@
+export { getIconsStyleSheet, withIconsStyleSheet } from "./icons-stylesheet";
+/**
+ * Génère une classe d'icône FR avec validation
+ * @param {string} icon - Le nom de l'icône
+ * @returns {string} La classe CSS complète ou une classe par défaut
+ */
+export function setIconClass(icon) {
+    if (!icon || typeof icon !== "string") {
+        console.warn("iconClass: La prop `icon` doit être une chaîne de caractères");
+        return;
+    }
+    return `fr-icon-${icon}`;
+}
+/**
+ * Marque un Web Component comme thématisable via l'attribut data-themeable
+ * Permet d'appliquer des styles conditionnels basés sur cet attribut
+ * @param {HTMLElement | undefined} host - L'élément host du Web Component ($host)
+ * @param {boolean} [active=true] - Indique si le thème est actif ou non
+ */
+export function setThemeable(host, active = true) {
+    if (!host)
+        return;
+    if (host.hasAttribute("data-themeable") && host.getAttribute("data-themeable") === "false")
+        return;
+    host.setAttribute("data-themeable", active ? "true" : "false");
+}