@supersoniks/concorde 4.8.0 → 4.9.1

package/dist/types/core/components/ui/toast/toast-item.d.ts

@@ -0,0 +1,41 @@
+import { LitElement, nothing } from "lit";
+import "@supersoniks/concorde/core/components/ui/toast/types";
+import { ToastStatus } from "@supersoniks/concorde/core/components/ui/toast/types";
+export declare class SonicToastItem extends LitElement {
+    static styles: import("lit").CSSResult[];
+    title: string;
+    id: string;
+    text: string;
+    status: ToastStatus;
+    ghost: boolean;
+    preserve: boolean;
+    dismissForever: boolean;
+    maxHeight: string;
+    visible: boolean;
+    private _titleId;
+    /**
+     * Retourne le rôle ARIA approprié selon le statut du toast
+     * - "alert" pour les erreurs (messages critiques) - implique déjà aria-live="assertive"
+     * - "status" pour les autres (messages informatifs)
+     */
+    getAriaRole(): "alert" | "status";
+    /**
+     * Retourne la valeur aria-live appropriée selon le statut
+     * - null pour les erreurs car role="alert" implique déjà aria-live="assertive"
+     * - "polite" pour les autres (peut attendre)
+     */
+    getAriaLive(): "polite" | null;
+    /**
+     * Génère et mémorise un ID unique pour le titre du toast
+     */
+    getTitleId(): string;
+    /**
+     * Génère un label ARIA descriptif pour le bouton de fermeture
+     */
+    getCloseButtonLabel(): string;
+    render(): typeof nothing | import("lit-html").TemplateResult<1>;
+    hide(): void;
+    show(): void;
+    autoHide(): void;
+}
+//# sourceMappingURL=toast-item.d.ts.map

package/dist/types/core/components/ui/toast/toast-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast-item.d.ts","sourceRoot":"","sources":["../../../../../../src/core/components/ui/toast/toast-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,UAAU,EAAO,OAAO,EAAE,MAAM,KAAK,CAAC;AAGrD,OAAO,sDAAsD,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAC;AAYnF,qBACa,cAAe,SAAQ,UAAU;IAC5C,MAAM,CAAC,MAAM,4BAuLX;IAE0B,KAAK,SAAM;IACX,EAAE,SAAM;IACR,IAAI,SAAM;IACV,MAAM,EAAE,WAAW,CAAM;IACxB,KAAK,UAAS;IACd,QAAQ,UAAS;IACjB,cAAc,UAAS;IACxB,SAAS,SAAW;IACvC,OAAO,UAAQ;IACf,OAAO,CAAC,QAAQ,CAAc;IAKvC;;;;OAIG;IACH,WAAW,IAAI,OAAO,GAAG,QAAQ;IAIjC;;;;OAIG;IACH,WAAW,IAAI,QAAQ,GAAG,IAAI;IAI9B;;OAEG;IACH,UAAU,IAAI,MAAM;IAUpB;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAa7B,MAAM;IAkEN,IAAI;IAkBJ,IAAI;IAIJ,QAAQ;CAKT"}

package/dist/types/core/components/ui/toast/toast.d.ts

@@ -0,0 +1,28 @@
+import { LitElement, nothing } from "lit";
+import "@supersoniks/concorde/core/components/ui/icon/icon";
+import "@supersoniks/concorde/core/components/ui/toast/toast-item";
+import { Toast, ToastStatus } from "@supersoniks/concorde/core/components/ui/toast/types";
+export declare class SonicToast extends LitElement {
+    toasts: Toast[];
+    static delegateToasts: boolean;
+    createRenderRoot(): this;
+    render(): typeof nothing | import("lit-html").TemplateResult<1>;
+    static removeAll(): void;
+    static removeItemsByStatus(status: ToastStatus): void;
+    static removeTemporaryItems(): void;
+    static instance?: SonicToast;
+    static getInstance(): SonicToast;
+    static add(conf: Toast): {
+        id: string | number;
+        text: string;
+        title: string | undefined;
+        status: ToastStatus;
+        preserve: boolean | undefined;
+        ghost: boolean | undefined;
+        dismissForever: boolean | undefined;
+    } | null | undefined;
+    static handleExistingToastDelegation(): void;
+    static removeItem(toastToRemove?: Toast): void;
+    removeItem(toastToRemove?: Toast): void;
+}
+//# sourceMappingURL=toast.d.ts.map

package/dist/types/core/components/ui/toast/toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../../../../src/core/components/ui/toast/toast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,UAAU,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAKhD,OAAO,oDAAoD,CAAC;AAI5D,OAAO,2DAA2D,CAAC;AACnE,OAAO,EACL,KAAK,EACL,WAAW,EACZ,MAAM,sDAAsD,CAAC;AAS9D,qBACa,UAAW,SAAQ,UAAU;IACb,MAAM,EAAE,KAAK,EAAE,CAAM;IAChD,MAAM,CAAC,cAAc,UAAS;IAE9B,gBAAgB;IAIhB,MAAM;IAwEN,MAAM,CAAC,SAAS;IAYhB,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,WAAW;IAgB9C,MAAM,CAAC,oBAAoB;IAe3B,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAC7B,MAAM,CAAC,WAAW;IAMlB,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK;;;;;;;;;IAsDtB,MAAM,CAAC,6BAA6B;IAUpC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,KAAK;IAcvC,UAAU,CAAC,aAAa,CAAC,EAAE,KAAK;CAQjC"}

package/dist/types/core/components/ui/toast/types.d.ts

@@ -0,0 +1,12 @@
+import { Message } from "@supersoniks/concorde/core/_types/types";
+export type ToastStatus = Message["status"] | "" | "success";
+export type Toast = {
+    id?: string | number;
+    text: string;
+    title?: string;
+    status?: ToastStatus;
+    preserve?: boolean;
+    ghost?: boolean;
+    dismissForever?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/core/components/ui/toast/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/core/components/ui/toast/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAElE,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;AAG7D,MAAM,MAAM,KAAK,GAAG;IAClB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC"}

package/dist/types/core/components/ui/tooltip/tooltip.d.ts

@@ -0,0 +1,21 @@
+import { LitElement, PropertyValues } from "lit";
+export declare class Tooltip extends LitElement {
+    static styles: import("lit").CSSResult[];
+    label: string;
+    placement?: "top" | "top-start" | "top-end" | "right" | "right-start" | "right-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "left-start" | "left-end";
+    disabled: boolean;
+    focusable: boolean;
+    private lastKeyWasTab;
+    private boundHandleKeyDown;
+    private boundHandleMouseDown;
+    constructor();
+    private handleKeyDown;
+    private handleMouseDown;
+    private handleFocusIn;
+    private handleFocusOut;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected willUpdate(_changedProperties: PropertyValues): void;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=tooltip.d.ts.map

package/dist/types/core/components/ui/tooltip/tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../../../../../../src/core/components/ui/tooltip/tooltip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,UAAU,EAAO,cAAc,EAAE,MAAM,KAAK,CAAC;AAG5D,qBACa,OAAQ,SAAQ,UAAU;IACrC,MAAM,CAAC,MAAM,4BA4GX;IAE0B,KAAK,SAAM;IACI,SAAS,CAAC,EACjD,KAAK,GACL,WAAW,GACX,SAAS,GACT,OAAO,GACP,aAAa,GACb,WAAW,GACX,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,UAAU,CAAC;IAEc,QAAQ,UAAS;IACjB,SAAS,UAAS;IAE/C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,oBAAoB,CAAa;;IAQzC,OAAO,CAAC,aAAa,CAKnB;IAEF,OAAO,CAAC,eAAe,CAKrB;IAEF,OAAO,CAAC,aAAa,CAMnB;IAEF,OAAO,CAAC,cAAc,CAGpB;IAEF,iBAAiB;IASjB,oBAAoB;IAQpB,SAAS,CAAC,UAAU,CAAC,kBAAkB,EAAE,cAAc,GAAG,IAAI;IAwB9D,MAAM;CASP"}

package/dist/types/core/components/ui/ui.d.ts

@@ -0,0 +1,35 @@
+import "./theme/theme";
+import "./badge/badge";
+import "./button/button";
+import "./link/link";
+import "./progress/progress";
+import "./form/input/input";
+import "./form/input-autocomplete/input-autocomplete";
+import "./form/input/password-helper";
+import "./form/input/same-value-helper";
+import "./form/checkbox/checkbox";
+import "./form/radio/radio";
+import "./form/switch/switch";
+import "./form/select/select";
+import "./form/textarea/textarea";
+import "./form/fieldset/fieldset";
+import "./form/fieldset/legend";
+import "./form/form-layout/form-layout";
+import "./form/form-actions/form-actions";
+import "./group/group";
+import "./icon/icon";
+import "./image/image";
+import "./loader/loader";
+import "./menu/menu";
+import "./modal/modal";
+import "./alert/alert";
+import "./alert-messages/alert-messages";
+import "./toast/toast";
+import "./toast/message-subscriber";
+import "./tooltip/tooltip";
+import "./pop/pop";
+import "./divider/divider";
+import "./card/card";
+import "./table/table";
+import "./captcha/captcha";
+//# sourceMappingURL=ui.d.ts.map

package/dist/types/core/components/ui/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../../../src/core/components/ui/ui.ts"],"names":[],"mappings":"AACA,OAAO,eAAe,CAAC;AAEvB,OAAO,eAAe,CAAC;AACvB,OAAO,iBAAiB,CAAC;AACzB,OAAO,aAAa,CAAC;AACrB,OAAO,qBAAqB,CAAC;AAE7B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,8CAA8C,CAAC;AACtD,OAAO,8BAA8B,CAAC;AACtC,OAAO,gCAAgC,CAAC;AACxC,OAAO,0BAA0B,CAAC;AAClC,OAAO,oBAAoB,CAAC;AAC5B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,0BAA0B,CAAC;AAClC,OAAO,0BAA0B,CAAC;AAClC,OAAO,wBAAwB,CAAC;AAChC,OAAO,gCAAgC,CAAC;AACxC,OAAO,kCAAkC,CAAC;AAC1C,OAAO,eAAe,CAAC;AAGvB,OAAO,aAAa,CAAC;AACrB,OAAO,eAAe,CAAC;AACvB,OAAO,iBAAiB,CAAC;AAEzB,OAAO,aAAa,CAAC;AAGrB,OAAO,eAAe,CAAC;AACvB,OAAO,eAAe,CAAC;AACvB,OAAO,iCAAiC,CAAC;AAEzC,OAAO,eAAe,CAAC;AACvB,OAAO,4BAA4B,CAAC;AACpC,OAAO,mBAAmB,CAAC;AAC3B,OAAO,WAAW,CAAC;AACnB,OAAO,mBAAmB,CAAC;AAC3B,OAAO,aAAa,CAAC;AACrB,OAAO,eAAe,CAAC;AACvB,OAAO,mBAAmB,CAAC"}

package/dist/types/core/core.d.ts

@@ -0,0 +1,5 @@
+import "./components/functional/functional";
+import "./components/ui/ui";
+import "./mixins/mixins";
+import "./utils/url-pattern";
+//# sourceMappingURL=core.d.ts.map

package/dist/types/core/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/core/core.ts"],"names":[],"mappings":"AAAA,OAAO,oCAAoC,CAAC;AAC5C,OAAO,oBAAoB,CAAC;AAC5B,OAAO,iBAAiB,CAAC;AACzB,OAAO,qBAAqB,CAAC"}

package/dist/types/core/decorators/Subscriber.d.ts

@@ -0,0 +1,11 @@
+export { bind } from "./subscriber/bind";
+export { publish } from "./subscriber/publish";
+export { subscribe } from "./subscriber/subscribe";
+export { onAssign } from "./subscriber/onAssign";
+export { handle, Skip } from "./subscriber/handle";
+export type { HandleOptions } from "./subscriber/handle";
+export { autoSubscribe } from "./subscriber/autoSubscribe";
+export { autoFill } from "./subscriber/autoFill";
+export { ancestorAttribute } from "./subscriber/ancestorAttribute";
+export type { AncestorAttributeOptions } from "./subscriber/ancestorAttribute";
+//# sourceMappingURL=Subscriber.d.ts.map

package/dist/types/core/decorators/Subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Subscriber.d.ts","sourceRoot":"","sources":["../../../../src/core/decorators/Subscriber.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,YAAY,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/types/core/decorators/api.d.ts

@@ -0,0 +1,119 @@
+import type { DataProviderKey, DataProviderKeyHost } from "../utils/dataProviderKey";
+import { Endpoint } from "../utils/endpoint";
+import { APIConfiguration, type ApiResult } from "@supersoniks/concorde/core/utils/api";
+import { type DynamicPathOptions } from "./subscriber/dynamicPath";
+/**
+ * Décorateur **`@get`** : charge des données via `API.getDetailed` et assigne un
+ * `ApiResult<T>` (`request`, `response`, `result` typé `T`) ou `null`.
+ * Le path est un `Endpoint<T, Ue>` ; les placeholders `${nomPropriété}` sont résolus sur l'instance (`Ue` contraint l’hôte).
+ *
+ * **Scoped (défaut)** : `HTML.getApiConfiguration(host)` avec `host` = l’élément connecté
+ * (`HTMLElement` / `ShadowRoot`). Si `serviceURL` n’est pas encore disponible (reflect Lit, scope
+ * ancêtre), le GET est différé jusqu’à ce que la config soit prête.
+ *
+ * **Deuxième paramètre** : `DataProviderKey<APIConfiguration>` — la config est lue via
+ * `PublisherManager` sur le chemin résolu (même syntaxe dynamique que `@subscribe`).
+ * Toute mutation interne du publisher (`onInternalMutation`) relance le GET.
+ *
+ * **Options** (`GetOptions`) : `triggerKey` — `PublisherManager.get(...).invalidate()` relance le GET ;
+ * `refetchEveryMs` — polling automatique.
+ *
+ * @example
+ * @get(new Endpoint<User, { userId: string }>("users/${userId}"))
+ * payload?: ApiResult<User>;
+ *
+ * @example
+ * const apiConf = new DataProviderKey<APIConfiguration>("myApiConf");
+ * PublisherManager.get("myApiConf").set({ serviceURL: "...", token: null, ... });
+ * @get(new Endpoint<Thing, { id: string }>("things/${id}"), apiConf)
+ * payload?: ApiResult<Thing>;
+ *
+ * @example
+ * @get(usersEndpoint, { triggerKey: refreshUsersKey })
+ * payload?: ApiResult<User[]>;
+ * // PublisherManager.get("users.refresh").invalidate() → refetch
+ */
+export declare function get<T, Ue = any>(endpoint: Endpoint<T, Ue>): <K extends string>(target: DataProviderKeyHost<Ue> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+export declare function get<T, Ue = any, Uk = any>(endpoint: Endpoint<T, Ue>, configurationKey: DataProviderKey<APIConfiguration, Uk>): <K extends string>(target: DataProviderKeyHost<Ue> & DataProviderKeyHost<Uk> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+export declare function get<T, Ue = any, Uk = any>(endpoint: Endpoint<T, Ue>, options: GetOptions): <K extends string>(target: DataProviderKeyHost<Ue> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+export declare function get<T, Ue = any, Uk = any, Ut = any>(endpoint: Endpoint<T, Ue>, configurationKey: DataProviderKey<APIConfiguration, Uk>, options: GetOptions): <K extends string>(target: DataProviderKeyHost<Ue> & DataProviderKeyHost<Uk> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+export type GetOptions<Uk = any> = DynamicPathOptions & {
+    /** Intervalle de refetch automatique (ms). 0 ou absent = pas de polling. */
+    refetchEveryMs?: number;
+    /** Publisher dont `invalidate()` relance le GET. */
+    triggerKey?: DataProviderKey<unknown, Uk>;
+};
+export type ApiSendOptions<Uk = any> = DynamicPathOptions & {
+    /** Intervalle de renvoi automatique (ms). 0 ou absent = pas de polling. */
+    refetchEveryMs?: number;
+    /** Ne pas envoyer si le body publisher est null/undefined (défaut: true). */
+    skipIfBodyMissing?: boolean;
+    /**
+     * Relancer l'envoi quand le body publisher mute (défaut: true).
+     * `false` : le body est lu au moment de l'envoi ; déclencher via `triggerKey.invalidate()`.
+     */
+    autoPostOnBodyMutation?: boolean;
+    /** Publisher dont `invalidate()` relance l'envoi (relit le body courant). */
+    triggerKey?: DataProviderKey<unknown, Uk>;
+};
+/** @deprecated Alias — préférer `ApiSendOptions`. */
+export type PostOptions<Uk = any> = ApiSendOptions<Uk>;
+export type PutOptions<Uk = any> = ApiSendOptions<Uk>;
+export type PatchOptions<Uk = any> = ApiSendOptions<Uk>;
+/**
+ * Décorateur **`@post`** : envoie des données via `API.postDetailed` et assigne un
+ * `ApiResult<T>` (`request`, `response`, `result` typé `T`).
+ *
+ * Le body est lu depuis un `DataProviderKey` (mutations et assignations relancent le POST).
+ *
+ * @example
+ * @post(new Endpoint<SyncResult, { sessionId: string }>("sessions/${sessionId}/sync"), syncRequestKey)
+ * payload?: ApiResult<SyncResult>;
+ */
+export declare function post<T, B, Ue = any>(endpoint: Endpoint<T, Ue>, bodyKey: DataProviderKey<B>): <K extends string>(target: DataProviderKeyHost<Ue> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+export declare function post<T, B, Ue = any, Uk = any>(endpoint: Endpoint<T, Ue>, bodyKey: DataProviderKey<B>, configurationKey: DataProviderKey<APIConfiguration, Uk>): <K extends string>(target: DataProviderKeyHost<Ue> & DataProviderKeyHost<Uk> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+export declare function post<T, B, Ue = any, Uk = any>(endpoint: Endpoint<T, Ue>, bodyKey: DataProviderKey<B>, options: PostOptions<Uk>): <K extends string>(target: DataProviderKeyHost<Ue> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+export declare function post<T, B, Ue = any, Uk = any, Ut = any>(endpoint: Endpoint<T, Ue>, bodyKey: DataProviderKey<B>, configurationKey: DataProviderKey<APIConfiguration, Uk>, options: PostOptions<Ut>): <K extends string>(target: DataProviderKeyHost<Ue> & DataProviderKeyHost<Uk> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+/** `@put` — même modèle que `@post` via `API.putDetailed`. */
+export declare function put<T, B, Ue = any>(endpoint: Endpoint<T, Ue>, bodyKey: DataProviderKey<B>): <K extends string>(target: DataProviderKeyHost<Ue> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+export declare function put<T, B, Ue = any, Uk = any>(endpoint: Endpoint<T, Ue>, bodyKey: DataProviderKey<B>, configurationKey: DataProviderKey<APIConfiguration, Uk>): <K extends string>(target: DataProviderKeyHost<Ue> & DataProviderKeyHost<Uk> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+export declare function put<T, B, Ue = any, Uk = any>(endpoint: Endpoint<T, Ue>, bodyKey: DataProviderKey<B>, options: PutOptions<Uk>): <K extends string>(target: DataProviderKeyHost<Ue> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+export declare function put<T, B, Ue = any, Uk = any, Ut = any>(endpoint: Endpoint<T, Ue>, bodyKey: DataProviderKey<B>, configurationKey: DataProviderKey<APIConfiguration, Uk>, options: PutOptions<Ut>): <K extends string>(target: DataProviderKeyHost<Ue> & DataProviderKeyHost<Uk> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+/** `@patch` — même modèle que `@post` via `API.patchDetailed`. */
+export declare function patch<T, B, Ue = any>(endpoint: Endpoint<T, Ue>, bodyKey: DataProviderKey<B>): <K extends string>(target: DataProviderKeyHost<Ue> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+export declare function patch<T, B, Ue = any, Uk = any>(endpoint: Endpoint<T, Ue>, bodyKey: DataProviderKey<B>, configurationKey: DataProviderKey<APIConfiguration, Uk>): <K extends string>(target: DataProviderKeyHost<Ue> & DataProviderKeyHost<Uk> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+export declare function patch<T, B, Ue = any, Uk = any>(endpoint: Endpoint<T, Ue>, bodyKey: DataProviderKey<B>, options: PatchOptions<Uk>): <K extends string>(target: DataProviderKeyHost<Ue> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+export declare function patch<T, B, Ue = any, Uk = any, Ut = any>(endpoint: Endpoint<T, Ue>, bodyKey: DataProviderKey<B>, configurationKey: DataProviderKey<APIConfiguration, Uk>, options: PatchOptions<Ut>): <K extends string>(target: DataProviderKeyHost<Ue> & DataProviderKeyHost<Uk> & {
+    [P in K]?: ApiResult<T> | null | undefined;
+}, propertyKey: K) => void;
+//# sourceMappingURL=api.d.ts.map

package/dist/types/core/decorators/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/core/decorators/api.ts"],"names":[],"mappings":"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"}

package/dist/types/core/decorators/lifecycle.d.ts

@@ -0,0 +1,19 @@
+/** Event dispatched when a component's connectedCallback has completed. Can be listened to from anywhere (bubbles). */
+export declare const CONNECTED = "sonic-connected";
+/**
+ * Décorateur de classe qui retarde le connectedCallback jusqu'à ce que tous les ancêtres
+ * correspondant aux sélecteurs CSS fournis aient exécuté leur connectedCallback.
+ * Les nœuds qui ne sont pas des web components sont considérés comme connectés par défaut.
+ * S'applique uniquement aux web components (classes étendant HTMLElement).
+ */
+export declare function awaitConnectedAncestors(...selectors: string[]): <T extends {
+    new (...args: any[]): HTMLElement;
+}>(constructor: T) => T;
+/**
+ * Décorateur de classe pour les ancêtres qui veulent signaler qu'ils sont prêts.
+ * Dispatche l'événement "sonic-connected" à la fin du connectedCallback (bubbles).
+ */
+export declare function dispatchConnectedEvent(): <T extends {
+    new (...args: any[]): HTMLElement;
+}>(constructor: T) => T;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/types/core/decorators/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/core/decorators/lifecycle.ts"],"names":[],"mappings":"AAEA,uHAAuH;AACvH,eAAO,MAAM,SAAS,oBAAoB,CAAC;AA4B3C;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,IAC3C,CAAC,SAAS;IAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,WAAW,CAAA;CAAE,EAC9D,aAAa,CAAC,KACb,CAAC,CAoBL;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,KACnB,CAAC,SAAS;IAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,WAAW,CAAA;CAAE,EAC9D,aAAa,CAAC,KACb,CAAC,CASL"}

package/dist/types/core/decorators/subscriber/ancestorAttribute.d.ts

@@ -0,0 +1,11 @@
+export type AncestorAttributeOptions = {
+    /**
+     * Si true, le composant reste synchronisé avec les attributs ancêtres via
+     * `AncestorAttributeObserver` (mutations + reparenting). Requis pour que
+     * `@bind` / `@subscribe` avec `${dataProvider}` se re-lient quand le scope change.
+     * Défaut : false (lecture unique au connect, rétrocompat).
+     */
+    dynamic?: boolean;
+};
+export declare function ancestorAttribute(attributeName: string, options?: AncestorAttributeOptions): (target: unknown, propertyKey: string) => void;
+//# sourceMappingURL=ancestorAttribute.d.ts.map

package/dist/types/core/decorators/subscriber/ancestorAttribute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ancestorAttribute.d.ts","sourceRoot":"","sources":["../../../../../src/core/decorators/subscriber/ancestorAttribute.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,wBAAwB,IAKjB,QAAQ,OAAO,EAAE,aAAa,MAAM,UA4BtD"}

package/dist/types/core/decorators/subscriber/autoFill.d.ts

@@ -0,0 +1,2 @@
+export declare function autoFill(values: string[]): (target: unknown) => void;
+//# sourceMappingURL=autoFill.d.ts.map

package/dist/types/core/decorators/subscriber/autoFill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoFill.d.ts","sourceRoot":"","sources":["../../../../../src/core/decorators/subscriber/autoFill.ts"],"names":[],"mappings":"AAKA,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IACtB,QAAQ,OAAO,UAoBjC"}

package/dist/types/core/decorators/subscriber/autoSubscribe.d.ts

@@ -0,0 +1,2 @@
+export declare function autoSubscribe(): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
+//# sourceMappingURL=autoSubscribe.d.ts.map

package/dist/types/core/decorators/subscriber/autoSubscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoSubscribe.d.ts","sourceRoot":"","sources":["../../../../../src/core/decorators/subscriber/autoSubscribe.ts"],"names":[],"mappings":"AAMA,wBAAgB,aAAa,KAEzB,QAAQ,GAAG,EACX,aAAa,MAAM,EACnB,YAAY,kBAAkB,UA+CjC"}

package/dist/types/core/decorators/subscriber/bind.d.ts

@@ -0,0 +1,28 @@
+import type { DataProviderKey, DataProviderKeyHost } from "../../utils/dataProviderKey";
+import { type DynamicPathOptions } from "./dynamicPath";
+export type BindOptions = DynamicPathOptions & {
+    reflect?: boolean;
+};
+/**
+ * Bidirectional binding to a publisher path. Subscribes to changes and optionally reflects writes back.
+ * Accepts either a string path (legacy) or DataProviderKey<T> for type-safe binding.
+ * Supports dynamic paths: use placeholders like "users.${userIndex}" in the path or DataProviderKey.
+ *
+ * @example
+ * // String path (legacy):
+ * @bind("demoData.firstName")
+ * @state()
+ * firstName = "";
+ *
+ * @example
+ * // DataProviderKey with type validation:
+ * const dataKey = new DataProviderKey<Data>("data");
+ * @bind(dataKey.count, { reflect: true })
+ * @state()
+ * count: number = 0;
+ */
+export declare function bind(path: string, options?: BindOptions): (target: unknown, propertyKey: string) => void;
+export declare function bind<T, U = any>(key: DataProviderKey<T, U>, options?: BindOptions): <K extends string>(target: DataProviderKeyHost<U> & {
+    [P in K]?: T | null | undefined;
+}, propertyKey: K) => void;
+//# sourceMappingURL=bind.d.ts.map

package/dist/types/core/decorators/subscriber/bind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.d.ts","sourceRoot":"","sources":["../../../../../src/core/decorators/subscriber/bind.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,KAAK,kBAAkB,EAIxB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAiLF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;AAClD,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,EAC7B,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,WAAW,GACpB,CAAC,CAAC,SAAS,MAAM,EAClB,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG;KAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS;CAAE,EACpE,WAAW,EAAE,CAAC,KACX,IAAI,CAAC"}

package/dist/types/core/decorators/subscriber/common.d.ts

@@ -0,0 +1,14 @@
+type ConnectedCallback = (component: ConnectedComponent) => void;
+export type ConnectedComponent = Record<string, unknown> & {
+    /** Hooks exécutés avant le connectedCallback d'origine (ex. lecture DOM ancêtre). */
+    __onBeforeConnected__: (callback: ConnectedCallback) => void;
+    /** Hooks exécutés après le connectedCallback d'origine (ex. abonnements). */
+    __onConnected__: (callback: ConnectedCallback) => void;
+    __onDisconnected__: (callback: ConnectedCallback) => void;
+    __beforeConnectedCallbackCalls__?: Set<ConnectedCallback>;
+    __connectedCallbackCalls__?: Set<ConnectedCallback>;
+    __disconnectedCallbackCalls__?: Set<ConnectedCallback>;
+};
+export declare function setSubscribable(target: any): void;
+export {};
+//# sourceMappingURL=common.d.ts.map

package/dist/types/core/decorators/subscriber/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../../src/core/decorators/subscriber/common.ts"],"names":[],"mappings":"AAAA,KAAK,iBAAiB,GAAG,CAAC,SAAS,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAEjE,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACzD,qFAAqF;IACrF,qBAAqB,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7D,6EAA6E;IAC7E,eAAe,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACvD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC1D,gCAAgC,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC1D,0BAA0B,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACpD,6BAA6B,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;CACxD,CAAC;AA0BF,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,QAgC1C"}

package/dist/types/core/decorators/subscriber/dynamicPath.d.ts

@@ -0,0 +1,23 @@
+/** Lit / décorateurs : chemins publisher avec `${prop}` ou `{$prop}`. */
+/**
+ * Options de résolution des placeholders dynamiques.
+ * `skipEmptyPlaceholder` ne concerne que les chaînes vides `''` — pas `0`, `false`, `null`, etc.
+ */
+export type DynamicPathOptions = {
+    /**
+     * Si `true`, un placeholder résolu en `''` est traité comme non prêt (`ready: false`).
+     * N'affecte pas les autres valeurs (`0` → `"0"`, `false` → `"false"`, …).
+     */
+    skipEmptyPlaceholder?: boolean;
+};
+export declare function cleanPlaceholder(value: string): string;
+export declare function getValueFromExpression(component: unknown, expression: string): unknown;
+export declare function resolveDynamicPath(component: unknown, template: string, options?: DynamicPathOptions): {
+    ready: boolean;
+    path: string | null;
+};
+export declare function extractDynamicDependencies(path: string): string[];
+export declare function hasPath(obj: unknown): obj is {
+    path: string;
+};
+//# sourceMappingURL=dynamicPath.d.ts.map

package/dist/types/core/decorators/subscriber/dynamicPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamicPath.d.ts","sourceRoot":"","sources":["../../../../../src/core/decorators/subscriber/dynamicPath.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAgBT;AAWD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,kBAAkB,GAC3B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAuBzC;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAajE;AACD,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAO7D"}

package/dist/types/core/decorators/subscriber/dynamicPropertyWatch.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Surveillance des props utilisées dans les chemins dynamiques (`${userIndex}`, etc.).
+ *
+ * Modèle :
+ * - `observeDynamicProperty()` enregistre une prop + un handler à appeler si elle change ;
+ * - un seul `requestAnimationFrame` appelle `notifyObservedPropertyChanges()` ;
+ * - pour chaque prop observée : `lastValue` vs valeur lue sur le composant ;
+ * - plusieurs passes dans la même frame si un handler en modifie une autre ;
+ * - garde anti-boucle si une prop ne cesse de changer.
+ */
+/**
+ * Observe une prop du composant utilisée dans un chemin dynamique.
+ * Retourne une fonction de désinscription.
+ *
+ * Les deux premiers paramètres sont ignorés (legacy API des décorateurs).
+ */
+export declare function observeDynamicProperty(_legacyWatcherStoreKey: PropertyKey, _legacyHookedStoreKey: PropertyKey, component: object, dependencyPropertyName: string, onDependencyChange: () => void): () => void;
+/** @deprecated Alias conservé pour les décorateurs existants. */
+export declare const registerDynamicPropertyWatcher: typeof observeDynamicProperty;
+/** @deprecated No-op conservé pour compatibilité API. */
+export declare function ensureDynamicPropertiesWillUpdate(_watcherStoreKey: PropertyKey, _hookedStoreKey: PropertyKey, _instance: object): void;
+/** Clés legacy ignorées par `@bind`. */
+export declare const bindDynamicWatchKeys: {
+    readonly watcherStore: symbol;
+    readonly hooked: symbol;
+};
+/** Clés legacy ignorées par `@publish`. */
+export declare const publishDynamicWatchKeys: {
+    readonly watcherStore: "__publishDynamicWatcherStore__";
+    readonly hooked: "__publishDynamicWillUpdateHooked__";
+};
+/** Clés legacy ignorées par `@get`. */
+export declare const getDynamicWatchKeys: {
+    readonly watcherStore: "__getDynamicWatcherStore__";
+    readonly hooked: "__getDynamicWillUpdateHooked__";
+};
+/** Clés legacy ignorées par `@onAssign`. */
+export declare const onAssignDynamicWatchKeys: {
+    readonly watcherStore: symbol;
+    readonly hooked: symbol;
+};
+//# sourceMappingURL=dynamicPropertyWatch.d.ts.map

package/dist/types/core/decorators/subscriber/dynamicPropertyWatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamicPropertyWatch.d.ts","sourceRoot":"","sources":["../../../../../src/core/decorators/subscriber/dynamicPropertyWatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkGH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,sBAAsB,EAAE,WAAW,EACnC,qBAAqB,EAAE,WAAW,EAClC,SAAS,EAAE,MAAM,EACjB,sBAAsB,EAAE,MAAM,EAC9B,kBAAkB,EAAE,MAAM,IAAI,GAC7B,MAAM,IAAI,CAoCZ;AAED,iEAAiE;AACjE,eAAO,MAAM,8BAA8B,+BAAyB,CAAC;AAErE,yDAAyD;AACzD,wBAAgB,iCAAiC,CAC/C,gBAAgB,EAAE,WAAW,EAC7B,eAAe,EAAE,WAAW,EAC5B,SAAS,EAAE,MAAM,GAChB,IAAI,CAAG;AAEV,wCAAwC;AACxC,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AAEX,2CAA2C;AAC3C,eAAO,MAAM,uBAAuB;;;CAG1B,CAAC;AAEX,uCAAuC;AACvC,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX,4CAA4C;AAC5C,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC"}

package/dist/types/core/decorators/subscriber/handle.d.ts

@@ -0,0 +1,74 @@
+import type { DataProviderKey, DataProviderKeyHost } from "../../utils/dataProviderKey";
+import type { DynamicPathOptions } from "./dynamicPath";
+import { Skip } from "./onAssign";
+export { Skip } from "./onAssign";
+/**
+ * Options de `@handle`, nommées d'après les cas d'usage réels rencontrés dans
+ * les projets (panier, file d'attente, formulaires multi-publishers, etc.).
+ *
+ * Par défaut (aucune option), `@handle` appelle la méthode **à chaque
+ * assignation**, même quand la valeur reçue est `null`/`undefined` (c'est la
+ * différence de comportement voulue par rapport à `@onAssign`).
+ */
+export type HandleOptions = DynamicPathOptions & {
+    /**
+     * Attendre que **toutes** les clés surveillées soient définies (non
+     * `null`/`undefined`) avant d'appeler la méthode. Reproduit la sémantique
+     * historique de `@onAssign`.
+     *
+     * À utiliser quand la logique combine plusieurs sources et n'a de sens que
+     * lorsque toutes sont prêtes (ex. calcul de date à partir de
+     * `date` + `timeZone` + `direction`).
+     */
+    waitForAllDefined?: boolean;
+    /**
+     * Ne pas appeler la méthode si la valeur reçue appartient à l'une de ces
+     * catégories. Chaque entrée est une catégorie nommée (pas une valeur), donc
+     * aucune ambiguïté valeur/motif.
+     *
+     * - `Skip.Nullish` ignore `null`/`undefined` ;
+     * - `Skip.EmptyObject` / `Skip.EmptyArray` ignorent `{}` / `[]` ;
+     * - `Skip.EmptyString` ignore `""`.
+     *
+     * Pratique quand un publisher non initialisé émet `{}` comme état « pas encore
+     * chargé » : `skip: [Skip.EmptyObject]`. Pour une validation arbitraire sur une
+     * valeur précise, faire le test directement dans la méthode.
+     */
+    skip?: Skip[];
+};
+type HandleDecorator<Host, Fn> = (target: Host, propertyKey: string, descriptor: TypedPropertyDescriptor<Fn>) => void;
+/**
+ * Callback typé déclenché lorsqu'un (ou plusieurs) chemin(s) publisher sont
+ * assignés via `DataProviderKey<T>`. Invoque la méthode décorée avec la/les
+ * valeur(s) assignée(s) (calculs, effets de bord, mise à jour d'autres `@state`…).
+ *
+ * Supporte les chemins dynamiques : placeholders type `"users.${userIndex}"`.
+ *
+ * Contrairement à `@onAssign`, la méthode est appelée à chaque assignation,
+ * même quand la valeur reçue est `null`/`undefined` — sauf si une option
+ * (`waitForAllDefined`, `skip`) restreint le déclenchement.
+ *
+ * @example
+ * // Mono-clé
+ * const cart = new DataProviderKey<Cart>("cart");
+ * @handle(cart.total)
+ * updateSummary(total: number) {
+ *   this.summary = total * this.taxRate;
+ * }
+ *
+ * @example
+ * // Multi-clés (coordination de plusieurs publishers)
+ * @handle(config.show, idle.isIdle, { waitForAllDefined: true })
+ * onModal(show: boolean, isIdle: boolean) {
+ *   if (show && isIdle) this.open(); else this.close();
+ * }
+ *
+ * @example
+ * // Ignorer un objet vide émis par un publisher non initialisé
+ * @handle(user.profile, { skip: [Skip.EmptyObject] })
+ * onProfile(profile: Profile) { this.name = profile.name; }
+ */
+export declare function handle<A, U = any>(key: DataProviderKey<A, U>, options?: HandleOptions): HandleDecorator<DataProviderKeyHost<U>, (a: A) => void>;
+export declare function handle<A, B, UA = any, UB = any>(keyA: DataProviderKey<A, UA>, keyB: DataProviderKey<B, UB>, options?: HandleOptions): HandleDecorator<DataProviderKeyHost<UA> & DataProviderKeyHost<UB>, (a: A, b: B) => void>;
+export declare function handle<A, B, C, UA = any, UB = any, UC = any>(keyA: DataProviderKey<A, UA>, keyB: DataProviderKey<B, UB>, keyC: DataProviderKey<C, UC>, options?: HandleOptions): HandleDecorator<DataProviderKeyHost<UA> & DataProviderKeyHost<UB> & DataProviderKeyHost<UC>, (a: A, b: B, c: C) => void>;
+//# sourceMappingURL=handle.d.ts.map

package/dist/types/core/decorators/subscriber/handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../../../../../src/core/decorators/subscriber/handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAkB,IAAI,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG;IAC/C;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;CACf,CAAC;AAEF,KAAK,eAAe,CAAC,IAAI,EAAE,EAAE,IAAI,CAC/B,MAAM,EAAE,IAAI,EACZ,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,uBAAuB,CAAC,EAAE,CAAC,KACpC,IAAI,CAAC;AAUV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,EAC/B,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,aAAa,GACtB,eAAe,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC;AAC3D,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,GAAG,EAC7C,IAAI,EAAE,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC,EAC5B,IAAI,EAAE,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC,EAC5B,OAAO,CAAC,EAAE,aAAa,GACtB,eAAe,CAChB,mBAAmB,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC,EAAE,CAAC,EACjD,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,CACrB,CAAC;AACF,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,GAAG,EAC1D,IAAI,EAAE,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC,EAC5B,IAAI,EAAE,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC,EAC5B,IAAI,EAAE,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC,EAC5B,OAAO,CAAC,EAAE,aAAa,GACtB,eAAe,CAChB,mBAAmB,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC,EAAE,CAAC,EAC3E,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,CAC3B,CAAC"}