@discourse/types 2026.8.0-fb9247e0 → 2026.9.0-c0ef3a11

package/declarations/app/ui-kit/modifiers/d-virtualizer.d.ts

@@ -0,0 +1,131 @@
+import type Owner from "@ember/owner";
+import Modifier, { type ArgsFor } from "ember-modifier";
+import type { DVirtualListApi } from "discourse/ui-kit/d-virtual-list";
+type VirtualKey = number | string | bigint;
+interface VisibleRange {
+    startIndex: number;
+    endIndex: number;
+}
+interface VirtualRange extends VisibleRange {
+    overscan: number;
+    count: number;
+}
+type PinnedIndices = (indices: readonly number[], range: VirtualRange) => readonly number[];
+/** The visible range plus the total item count, handed to an edge callback. */
+interface EdgeInfo extends VisibleRange {
+    count: number;
+}
+interface VirtualItem {
+    key: VirtualKey;
+    index: number;
+    start: number;
+    end: number;
+    size: number;
+    lane: number;
+}
+interface PublishedState {
+    /**
+     * The rendered window. Frozen, and a copy of the engine's own array rather than
+     * the array itself, so a consumer cannot write into the memoized result the
+     * engine hands back on every later read. Only the array is frozen: the items in
+     * it are reconstructed per computation, so a write to one cannot outlive the
+     * next window change.
+     */
+    virtualItems: readonly VirtualItem[];
+    totalSize: number;
+    range: VisibleRange | null;
+}
+interface DVirtualizerSignature<T> {
+    Element: HTMLDivElement;
+    Args: {
+        Named: {
+            /** The complete list whose visible window is rendered. */
+            items: readonly T[];
+            /** Returns the estimated pixel size of an unmeasured item. */
+            estimateSize: (item: T, index: number) => number;
+            /**
+             * Field name whose value is the row's STABLE key (see {@link keyFor}). Without
+             * it rows key by object identity, so a consumer that rebuilds its item objects
+             * each render (fresh objects, same logical rows) orphans every measurement and
+             * remounts the whole window. The field must be present and unique per row;
+             * nullish/primitive rows fall back to identity keying.
+             */
+            key?: string;
+            /** The number of extra items rendered outside the visible range. */
+            overscan?: number;
+            /**
+             * The edge the list rests at. `"bottom"` additionally makes the engine
+             * follow appends while the reader is within `scrollEndThreshold` of the
+             * end; the initial rest position is applied by the component, not here.
+             */
+            anchor?: "top" | "bottom";
+            /**
+             * Distance from the end, in px, that still counts as "at the end". Governs
+             * both the follow-on-append gate and the engine's at-end row-resize branch.
+             * Defaults to the engine's own value, which is 1px.
+             */
+            scrollEndThreshold?: number;
+            /**
+             * Extends the default window with extra absolute indices to keep mounted.
+             * Invalid and duplicate extras are discarded, and the result stays in
+             * ascending index order. See {@link rangeExtractorWithPins}.
+             */
+            pinnedIndices?: PinnedIndices;
+            /** Receives newly published virtualizer state. */
+            onState?: (state: PublishedState) => void;
+            /**
+             * Receives the imperative virtual-list API after initialization.
+             *
+             * Delivered synchronously during the first `modify()`, unlike the other
+             * callbacks here, which are delivered from the after-render flush. The
+             * phase is load-bearing: a consumer that positions the list and then calls
+             * back into the API needs the handle before that positioning runs. The
+             * cost is that writing tracked state already consumed in this render pass
+             * will trip a backtracking assertion — do that work in a later phase.
+             */
+            onRegisterApi?: (api: DVirtualListApi) => void;
+            /** Runs when the visible item range changes. */
+            onVisibleRangeChange?: (range: VisibleRange) => void;
+            /**
+             * Runs once when the visible range enters the START band (within
+             * `edgeThreshold` rows of index 0), re-arming only after it retreats past
+             * the band plus hysteresis. Mount at the start is suppressed (the start
+             * latch begins satisfied) so a list that opens at the top does not fire.
+             */
+            onReachStart?: (info: EdgeInfo) => void;
+            /**
+             * Runs once when the visible range enters the END band (within
+             * `edgeThreshold` rows of the last index), re-arming after retreat past
+             * hysteresis. Unlike the start edge, the end latch begins UNsatisfied, so
+             * a list whose first page already reaches the end fires on mount.
+             */
+            onReachEnd?: (info: EdgeInfo) => void;
+            /** Rows from an edge at which its reach callback arms (default 8). */
+            edgeThreshold?: number;
+        };
+        Positional: [];
+    };
+}
+/**
+ * Bridges the windowing engine to Glimmer's reactivity.
+ *
+ * Applied to the scroll element by `DVirtualList`. It owns the imperative
+ * virtualizer instance and is the single reactive site for it:
+ *
+ * - `modify()` re-runs whenever its tracked named args change. On the first run
+ *   it constructs and mounts the virtualizer; on later runs it calls
+ *   `setOptions`.
+ * - Engine changes enqueue one `schedule("afterRender")` flush. The flush only
+ *   publishes when the total, range, or any virtual item field changes, avoiding
+ *   the render loop caused by assigning an equivalent fresh array to tracked
+ *   state.
+ * - Teardown calls the cleanup returned by `_didMount()` and cancels any pending
+ *   flush; every path that could write is fenced by destruction state.
+ */
+export default class DVirtualizer<T> extends Modifier<DVirtualizerSignature<T>> {
+    #private;
+    constructor(owner: Owner, args: ArgsFor<DVirtualizerSignature<T>>);
+    modify(element: HTMLDivElement, _positional: [], named: DVirtualizerSignature<T>["Args"]["Named"]): void;
+}
+export {};
+//# sourceMappingURL=d-virtualizer.d.ts.map

package/declarations/app/ui-kit/modifiers/d-virtualizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"d-virtualizer.d.ts","sourceRoot":"","sources":["../../../../../discourse/app/ui-kit/modifiers/d-virtualizer.ts"],"names":[],"mappings":"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"}

package/declarations/float-kit/components/d-float-body.d.ts

@@ -15,6 +15,16 @@ interface DFloatBodySignature {
         role?: string;
         /** Whether to trap Tab focus within the content. */
         trapTab?: boolean;
+        /**
+         * Whether the content should take part in the tab sequence as if it were rendered inline
+         * after the trigger, rather than at the portal's position in the document: Tab leads into its
+         * controls from the trigger, and off the end of them it dismisses the float and continues
+         * from the trigger.
+         *
+         * The non-containing alternative to `trapTab`, for a float that is dismissable but whose
+         * content holds focus. See `FloatKitTabOrderInline`.
+         */
+        inlineTabOrder?: boolean;
         /**
          * The element to render into. Some callers forward this even though the body
          * reads `@instance.portalOutletElement`.
@@ -35,6 +45,7 @@ interface DFloatBodySignature {
  * instance plus a few presentational overrides.
  */
 export default class DFloatBody extends Component<DFloatBodySignature> {
+    #private;
     closeOnScroll: import("ember-modifier").FunctionBasedModifier<{
         Args: {
             Positional: unknown[];
@@ -49,6 +60,34 @@ export default class DFloatBody extends Component<DFloatBodySignature> {
         };
         Element: HTMLElement;
     }>;
+    /**
+     * Extends the trigger's grace period across the content itself, so hovering onto the
+     * float keeps it open and leaving it starts the close. Focus moving within the
+     * content is not a departure, so it holds the lock rather than scheduling a close.
+     */
+    hoverGrace: import("ember-modifier").FunctionBasedModifier<{
+        Args: {
+            Positional: unknown[];
+            Named: import("ember-modifier/-private/signature").EmptyObject;
+        };
+        Element: HTMLElement;
+    }>;
+    /**
+     * Whether to install the grace-period listeners on the content. Only meaningful while
+     * the float is open, and only when a grace period is configured.
+     *
+     * @returns `true` when the content should participate in the grace period.
+     */
+    get supportsHoverGrace(): boolean;
+    get contentAriaLabelledby(): string | null | undefined;
+    /**
+     * Whether to repair the tab order, asserting first that containment was not ALSO asked for.
+     *
+     * The two are alternatives, and the conflict is otherwise silent and one-sided: `dTrapTab` is
+     * applied first below, so its `preventDefault` lands before the tab-order handler runs, and the
+     * float traps focus while its author believes they configured the opposite.
+     */
+    get inlineTabOrder(): boolean;
     get supportsCloseOnClickOutside(): boolean;
     get supportsCloseOnEscape(): boolean;
     get supportsCloseOnScroll(): boolean;

package/declarations/float-kit/components/d-float-body.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"d-float-body.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-float-body.gts"],"names":[],"mappings":"AAAA,OA8JO,SAAS,MAAM,oBAAoB,CAAC;AAK3C,OAAO,KAAK,gBAAgB,MAAM,4CAA4C,CAAC;AAQ/E,UAAU,mBAAmB;IAC3B,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE;QACJ,4CAA4C;QAC5C,QAAQ,EAAE,gBAAgB,CAAC;QAE3B,oEAAoE;QACpE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAExB,gDAAgD;QAChD,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,kDAAkD;QAClD,UAAU,CAAC,EAAE,MAAM,CAAC;QAEpB,qCAAqC;QACrC,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd,oDAAoD;QACpD,OAAO,CAAC,EAAE,OAAO,CAAC;QAElB;;;WAGG;QACH,mBAAmB,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;KAC1C,CAAC;IACF,MAAM,EAAE;QACN,iEAAiE;QACjE,OAAO,EAAE,EAAE,CAAC;KACb,CAAC;CACH;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,SAAS,CAAC,mBAAmB,CAAC;IACpE,aAAa;;;;;;OAYV;IAEH,0BAA0B;;;;;;OAWvB;IAEH,IAAI,2BAA2B,YAE9B;IAED,IAAI,qBAAqB,YAExB;IAED,IAAI,qBAAqB,YAExB;IAED,IAAI,OAAO,gDAEV;IAED,IAAI,OAAO,gBAEV;IAED,IAAI,OAAO,8CAEV;IAED,IAAI,KAAK,0CAOR;CAuDF"}
+{"version":3,"file":"d-float-body.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-float-body.gts"],"names":[],"mappings":"AAAA,OAkQO,SAAS,MAAM,oBAAoB,CAAC;AAM3C,OAAO,KAAK,gBAAgB,MAAM,4CAA4C,CAAC;AAU/E,UAAU,mBAAmB;IAC3B,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE;QACJ,4CAA4C;QAC5C,QAAQ,EAAE,gBAAgB,CAAC;QAE3B,oEAAoE;QACpE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAExB,gDAAgD;QAChD,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,kDAAkD;QAClD,UAAU,CAAC,EAAE,MAAM,CAAC;QAEpB,qCAAqC;QACrC,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd,oDAAoD;QACpD,OAAO,CAAC,EAAE,OAAO,CAAC;QAElB;;;;;;;;WAQG;QACH,cAAc,CAAC,EAAE,OAAO,CAAC;QAEzB;;;WAGG;QACH,mBAAmB,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;KAC1C,CAAC;IACF,MAAM,EAAE;QACN,iEAAiE;QACjE,OAAO,EAAE,EAAE,CAAC;KACb,CAAC;CACH;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,SAAS,CAAC,mBAAmB,CAAC;;IACpE,aAAa;;;;;;OAYV;IAEH,0BAA0B;;;;;;OAWvB;IAEH;;;;OAIG;IACH,UAAU;;;;;;OA0BP;IAEH;;;;;OAKG;IACH,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED,IAAI,qBAAqB,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAMrD;IAUD;;;;;;OAMG;IACH,IAAI,cAAc,YAOjB;IAED,IAAI,2BAA2B,YAE9B;IAED,IAAI,qBAAqB,YAExB;IAED,IAAI,qBAAqB,YAExB;IAED,IAAI,OAAO,gDAEV;IAED,IAAI,OAAO,gBAEV;IAED,IAAI,OAAO,8CAEV;IAED,IAAI,KAAK,0CAWR;CA2DF"}

package/declarations/float-kit/components/d-headless-menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"d-headless-menu.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-headless-menu.gts"],"names":[],"mappings":"AAAA,OAiCO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,OAAO,KAAK,aAAa,MAAM,yCAAyC,CAAC;AAEzE,UAAU,sBAAsB;IAC9B,IAAI,EAAE;QACJ,mCAAmC;QACnC,IAAI,EAAE,aAAa,CAAC;QAEpB,oEAAoE;QACpE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;KACzB,CAAC;CACH;AAED;;;;;;GAMG;AACH,QAAA,MAAM,aAAa,EAAE,qBAAqB,CAAC,sBAAsB,CAW/D,CAAC;AAEH,eAAe,aAAa,CAAC"}
+{"version":3,"file":"d-headless-menu.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-headless-menu.gts"],"names":[],"mappings":"AAAA,OAkCO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,OAAO,KAAK,aAAa,MAAM,yCAAyC,CAAC;AAEzE,UAAU,sBAAsB;IAC9B,IAAI,EAAE;QACJ,mCAAmC;QACnC,IAAI,EAAE,aAAa,CAAC;QAEpB,oEAAoE;QACpE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;KACzB,CAAC;CACH;AAED;;;;;;GAMG;AACH,QAAA,MAAM,aAAa,EAAE,qBAAqB,CAAC,sBAAsB,CAY/D,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/declarations/float-kit/components/d-inline-float.d.ts

@@ -1,12 +1,16 @@
-import Component from "@glimmer/component";
+import type { TemplateOnlyComponent } from "@ember/component/template-only";
 import type FloatKitInstance from "discourse/float-kit/lib/float-kit-instance";
-import type Site from "discourse/models/site";
 interface DInlineFloatSignature {
     Args: {
         /** The float instance to render. */
         instance: FloatKitInstance;
         /** Whether to trap Tab focus within the content. */
         trapTab?: boolean;
+        /**
+         * Whether the content takes part in the tab sequence as if rendered inline after the trigger.
+         * The non-containing alternative to `trapTab`; the two are mutually exclusive.
+         */
+        inlineTabOrder?: boolean;
         /** A class added to the outer float element. */
         mainClass?: string;
         /** A class added to the inner content element. */
@@ -26,8 +30,6 @@ interface DInlineFloatSignature {
  * and `DHeadlessTooltip`); the declarative components render their own body
  * inline instead.
  */
-export default class DInlineFloat extends Component<DInlineFloatSignature> {
-    site: Site;
-}
-export {};
+declare const DInlineFloat: TemplateOnlyComponent<DInlineFloatSignature>;
+export default DInlineFloat;
 //# sourceMappingURL=d-inline-float.d.ts.map

package/declarations/float-kit/components/d-inline-float.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"d-inline-float.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-inline-float.gts"],"names":[],"mappings":"AAAA,OAyFO,SAAS,MAAM,oBAAoB,CAAC;AAI3C,OAAO,KAAK,gBAAgB,MAAM,4CAA4C,CAAC;AAC/E,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAK9C,UAAU,qBAAqB;IAC7B,IAAI,EAAE;QACJ,oCAAoC;QACpC,QAAQ,EAAE,gBAAgB,CAAC;QAE3B,oDAAoD;QACpD,OAAO,CAAC,EAAE,OAAO,CAAC;QAElB,gDAAgD;QAChD,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,kDAAkD;QAClD,UAAU,CAAC,EAAE,MAAM,CAAC;QAEpB,qCAAqC;QACrC,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd,oEAAoE;QACpE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;KACzB,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,SAAS,CAAC,qBAAqB,CAAC;IACvD,IAAI,EAAE,IAAI,CAAC;CA0D7B"}
+{"version":3,"file":"d-inline-float.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-inline-float.gts"],"names":[],"mappings":"AAAA,OA6FO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAG5E,OAAO,KAAK,gBAAgB,MAAM,4CAA4C,CAAC;AAK/E,UAAU,qBAAqB;IAC7B,IAAI,EAAE;QACJ,oCAAoC;QACpC,QAAQ,EAAE,gBAAgB,CAAC;QAE3B,oDAAoD;QACpD,OAAO,CAAC,EAAE,OAAO,CAAC;QAElB;;;WAGG;QACH,cAAc,CAAC,EAAE,OAAO,CAAC;QAEzB,gDAAgD;QAChD,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,kDAAkD;QAClD,UAAU,CAAC,EAAE,MAAM,CAAC;QAEpB,qCAAqC;QACrC,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd,oEAAoE;QACpE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;KACzB,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,QAAA,MAAM,YAAY,EAAE,qBAAqB,CAAC,qBAAqB,CAyD7D,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/declarations/float-kit/components/d-menu.d.ts

@@ -1,16 +1,23 @@
 import Component from "@glimmer/component";
 import { type ComponentLike } from "@glint/template";
-import { type FloatCallback, type MenuOptions } from "discourse/float-kit/lib/constants";
+import { type FloatCallback, type FloatCloseOptions, type MenuOptions } from "discourse/float-kit/lib/constants";
 import DMenuInstance from "discourse/float-kit/lib/d-menu-instance";
-import type Site from "discourse/models/site";
 /** The object yielded to each of the menu's blocks and passed to a rendered component. */
 export interface DMenuComponentArgs<Data = unknown> {
     /** Closes the menu. */
-    close: FloatCallback;
+    close: (options?: FloatCloseOptions) => Promise<void>;
     /** Opens the menu. */
     show: FloatCallback;
     /** The `@data` passed to the menu. */
     data?: Data;
+    /** Whether the menu is currently open — reflects the live instance state. */
+    expanded: boolean;
+    /**
+     * Whether the menu is disabled — reflects the live instance state. A custom
+     * `@triggerComponent` does not receive `@disabled` itself, so this is how it renders a
+     * disabled affordance for the veto that `<DMenu>` is already applying.
+     */
+    disabled: boolean;
 }
 type DMenuOptionArgs<Data> = Partial<Omit<MenuOptions, "data" | "component" | "onRegisterApi">> & {
     /** The data passed to the content block and rendered component. */
@@ -19,13 +26,13 @@ type DMenuOptionArgs<Data> = Partial<Omit<MenuOptions, "data" | "component" | "o
     component?: ComponentLike<{
         Args: {
             data?: Data;
-            close?: FloatCallback;
+            close?: (options?: FloatCloseOptions) => Promise<void>;
         };
     }>;
     /** Called with the menu instance when it is created, so callers can control it programmatically. */
     onRegisterApi?: (instance: DMenuInstance) => void;
 };
-interface DMenuSignature<Data = unknown> {
+export interface DMenuSignature<Data = unknown> {
     Element: HTMLElement;
     Args: DMenuOptionArgs<Data> & {
         /** Called on keydown on the default trigger button. */
@@ -40,7 +47,18 @@ interface DMenuSignature<Data = unknown> {
         ariaLabel?: string;
         /** The title for the default trigger button. */
         title?: string;
-        /** Whether the default trigger button is disabled. */
+        /**
+         * Disables the menu: the default trigger button renders disabled, and — for any trigger,
+         * including a custom `@triggerComponent` — a trigger event (click/focus/hover/hold) no longer
+         * opens the menu. It does not touch the trigger's focusability or ARIA; that stays the
+         * caller's concern. A custom trigger reads the state back through `componentArgs.disabled`.
+         *
+         * Becoming disabled while open also closes the menu, since a disabled control must not keep
+         * an interactive overlay live. Where focus lands afterwards follows from the trigger: the
+         * default button is natively `disabled`, which no element can hold focus while being, so
+         * focus falls to the document. A caller that needs focus preserved supplies a trigger that
+         * stays focusable — the close refocuses it.
+         */
         disabled?: boolean;
         /** Whether the default trigger button shows a loading state. */
         isLoading?: boolean;
@@ -64,7 +82,6 @@ interface DMenuSignature<Data = unknown> {
  */
 export default class DMenu<Data = unknown> extends Component<DMenuSignature<Data>> {
     #private;
-    site: Site;
     menuInstance: DMenuInstance;
     registerTrigger: import("ember-modifier").FunctionBasedModifier<{
         Args: {
@@ -80,6 +97,13 @@ export default class DMenu<Data = unknown> extends Component<DMenuSignature<Data
         };
         Element: HTMLElement;
     }>;
+    syncDisabled: import("ember-modifier").FunctionBasedModifier<{
+        Args: {
+            Positional: [boolean?];
+            Named: import("ember-modifier/-private/signature").EmptyObject;
+        };
+        Element: HTMLElement;
+    }>;
     teardownFloatBody(): void;
     forwardTabToContent(event: KeyboardEvent): unknown;
     get options(): MenuOptions;
@@ -93,6 +117,13 @@ export default class DMenu<Data = unknown> extends Component<DMenuSignature<Data
             default: [];
         };
     }>;
+    /**
+     * Filling the gaps with defaults here would produce the same merged options, but it would erase
+     * the difference between "left unset" and "explicitly set to the default", which the instance
+     * needs in order to let one option imply another.
+     *
+     * @returns Only the options the caller supplied, keyed as in `MENU.options`.
+     */
     get allowedProperties(): Record<string, unknown>;
 }
 export {};

package/declarations/float-kit/components/d-menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"d-menu.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-menu.gts"],"names":[],"mappings":"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"}
+{"version":3,"file":"d-menu.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-menu.gts"],"names":[],"mappings":"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"}

package/declarations/float-kit/components/d-tooltip.d.ts

@@ -9,6 +9,8 @@ export interface DTooltipComponentArgs<Data = unknown> {
     close: FloatCallback;
     /** The `@data` passed to the tooltip. */
     data?: Data;
+    /** Whether the tooltip is currently open — reflects the live instance state. */
+    expanded: boolean;
 }
 type DTooltipOptionArgs<Data> = Partial<Omit<TooltipOptions, "data" | "component" | "onRegisterApi">> & {
     /** The data passed to the content block and rendered component. */

package/declarations/float-kit/components/d-tooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"d-tooltip.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-tooltip.gts"],"names":[],"mappings":"AAAA,OA8KO,SAAS,MAAM,oBAAoB,CAAC;AAI3C,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,cAAc,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,gBAAgB,MAAM,4CAA4C,CAAC;AAC1E,OAAO,KAAK,cAAc,MAAM,sCAAsC,CAAC;AAKvE,0DAA0D;AAC1D,MAAM,WAAW,qBAAqB,CAAC,IAAI,GAAG,OAAO;IACnD,0BAA0B;IAC1B,KAAK,EAAE,aAAa,CAAC;IAErB,yCAAyC;IACzC,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AASD,KAAK,kBAAkB,CAAC,IAAI,IAAI,OAAO,CACrC,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,CAAC,CAC7D,GAAG;IACF,mEAAmE;IACnE,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,2FAA2F;IAC3F,SAAS,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE;YAAE,IAAI,CAAC,EAAE,IAAI,CAAC;YAAC,KAAK,CAAC,EAAE,aAAa,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAE5E,uGAAuG;IACvG,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACtD,CAAC;AAEF,UAAU,iBAAiB,CAAC,IAAI,GAAG,OAAO;IACxC,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC,GAAG;QAI/B,kDAAkD;QAClD,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd,gDAAgD;QAChD,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,MAAM,EAAE;QACN,8FAA8F;QAC9F,OAAO,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;QAEvC,qFAAqF;QACrF,OAAO,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;QAEvC,wFAAwF;QACxF,OAAO,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;KACxC,CAAC;CACH;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAE,SAAQ,SAAS,CAC7D,iBAAiB,CAAC,IAAI,CAAC,CACxB;IACkB,OAAO,EAAE,cAAc,CAAC;IAEzC,eAAe,mBAIe;IAE9B,eAAe;;;;;;OAOZ;IAEH,IAAI,OAAO,IAAI,cAAc,CAE5B;IAED,IAAI,aAAa,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAK/C;IAED,IAAI,iBAAiB,4BAMpB;CA4FF"}
+{"version":3,"file":"d-tooltip.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-tooltip.gts"],"names":[],"mappings":"AAAA,OAuLO,SAAS,MAAM,oBAAoB,CAAC;AAI3C,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,cAAc,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,gBAAgB,MAAM,4CAA4C,CAAC;AAC1E,OAAO,KAAK,cAAc,MAAM,sCAAsC,CAAC;AAKvE,0DAA0D;AAC1D,MAAM,WAAW,qBAAqB,CAAC,IAAI,GAAG,OAAO;IACnD,0BAA0B;IAC1B,KAAK,EAAE,aAAa,CAAC;IAErB,yCAAyC;IACzC,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAC;CACnB;AASD,KAAK,kBAAkB,CAAC,IAAI,IAAI,OAAO,CACrC,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,CAAC,CAC7D,GAAG;IACF,mEAAmE;IACnE,IAAI,CAAC,EAAE,IAAI,CAAC;IAEZ,2FAA2F;IAC3F,SAAS,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE;YAAE,IAAI,CAAC,EAAE,IAAI,CAAC;YAAC,KAAK,CAAC,EAAE,aAAa,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAE5E,uGAAuG;IACvG,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACtD,CAAC;AAEF,UAAU,iBAAiB,CAAC,IAAI,GAAG,OAAO;IACxC,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC,GAAG;QAI/B,kDAAkD;QAClD,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd,gDAAgD;QAChD,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,MAAM,EAAE;QACN,8FAA8F;QAC9F,OAAO,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;QAEvC,qFAAqF;QACrF,OAAO,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;QAEvC,wFAAwF;QACxF,OAAO,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;KACxC,CAAC;CACH;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAE,SAAQ,SAAS,CAC7D,iBAAiB,CAAC,IAAI,CAAC,CACxB;IACkB,OAAO,EAAE,cAAc,CAAC;IAEzC,eAAe,mBAIe;IAE9B,eAAe;;;;;;OAOZ;IAEH,IAAI,OAAO,IAAI,cAAc,CAE5B;IAED,IAAI,aAAa,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAW/C;IAED,IAAI,iBAAiB,4BAMpB;CA4FF"}

package/declarations/float-kit/lib/constants.d.ts

@@ -26,6 +26,14 @@ export type FloatKitTrigger = ReferenceElement;
 export type FloatUiPlacement = (typeof FLOAT_UI_PLACEMENTS)[number];
 /** One of the visibility-optimizer identifiers in `VISIBILITY_OPTIMIZERS`. */
 export type VisibilityOptimizer = (typeof VISIBILITY_OPTIMIZERS)[keyof typeof VISIBILITY_OPTIMIZERS];
+/**
+ * The ARIA roles a float's content element may carry: `dialog` for a panel that owns widgets of
+ * its own, and the two presentational values for a container that must not sit between a control
+ * and the elements it references. Deliberately closed — a role outside this set has not been
+ * reconciled with the ARIA the content emits (see `DFloatBody`), so widening it is a decision to
+ * make here rather than at a call site.
+ */
+export type FloatContentRole = "dialog" | "none" | "presentation";
 /**
  * A relayed lifecycle or trigger callback (`onShow`, `onClose`, `beforeTrigger`, …).
  * These are handed straight to consumers that pass functions of varying arity and
@@ -34,6 +42,13 @@ export type VisibilityOptimizer = (typeof VISIBILITY_OPTIMIZERS)[keyof typeof VI
  * bare `Function` type (which yields an unchecked `any` and trips lint).
  */
 export type FloatCallback = (...args: any[]) => void;
+/** Options accepted when closing an anchored float. */
+export interface FloatCloseOptions {
+    /** Data passed to the float's `onClose` callback. */
+    data?: unknown;
+    /** Whether a menu restores focus to its trigger after closing. */
+    focusTrigger?: boolean;
+}
 /**
  * The events that open (or close) a float. Either a single list applied on every
  * viewport, or a split of `mobile`/`desktop` lists resolved against the current view.
@@ -85,8 +100,18 @@ export interface TooltipOptions {
     interactive: boolean;
     /** Whether FloatKit attaches the trigger event listeners itself, rather than the caller driving it through the service API. */
     listeners: boolean;
-    /** The maximum width of the content, in pixels. */
-    maxWidth: number;
+    /** How long to keep an interactive float open after the pointer leaves it. */
+    hoverGracePeriod: number;
+    /**
+     * The maximum width of the content: a number in pixels, or any CSS `max-width` value. Pass
+     * `"none"` alongside `matchTriggerWidth` — the two are both applied inline, so a numeric cap
+     * silently wins over the matched width and a trigger wider than the cap gets a narrower
+     * overlay.
+     *
+     * A number is additionally capped to the width the viewport leaves the float, so it can never
+     * overflow the document; a string is applied verbatim and gets no such cap.
+     */
+    maxWidth: number | string;
     /** Passed as the `@data` argument to a `component` rendered as the content. */
     data: unknown;
     /** Displaces the content from its trigger, in pixels. */
@@ -107,23 +132,64 @@ export interface TooltipOptions {
     autoUpdate: boolean | AutoUpdateOptions;
     /** Whether to trap Tab focus within the content. */
     trapTab: boolean;
-    /** Called after the float closes. */
+    /** Called after the float closes, with any data supplied to `close`. */
     onClose: FloatCallback | null;
     /** Called after the float shows. */
     onShow: FloatCallback | null;
+    /**
+     * Called with the float's content element once it has been placed.
+     *
+     * Positioning is what gives a float its size, and it resolves asynchronously — so content
+     * that renders from a measurement of itself computes that measurement against a float that
+     * has no size yet. Such content re-measures here rather than waiting for a resize to be
+     * observed, which happens on the browser's schedule and is not guaranteed to be prompt.
+     *
+     * This fires on every placement, not once per open: with `autoUpdate` on (the default) an
+     * ancestor scroll, an element resize or a layout shift each reposition the float and call
+     * back. A callback that re-renders from its own measurement therefore has to reach a fixed
+     * point, since a size change it causes is itself a reposition trigger.
+     *
+     * A menu that renders as a mobile modal has no placement to compute and never repositions.
+     * It calls back once, after the modal is inserted, with the modal element.
+     */
+    onPositioned: FloatCallback | null;
     /** Called with the float instance when it is created, so callers can control it programmatically. */
     onRegisterApi: FloatCallback | null;
     /** The element to render the content into, instead of the default portal outlet. */
     portalOutletElement: HTMLElement | null;
 }
 /**
- * The options for a menu: every tooltip option plus the menu-only extras (focus
- * management, the mobile modal, identifier grouping, and the class/width overrides
+ * The options for a menu: every tooltip option plus the menu-only extras (the content role,
+ * focus management, the mobile modal, identifier grouping, and the class/width overrides
  * the menu template forwards to its trigger and content).
  */
 export interface MenuOptions extends TooltipOptions {
+    /**
+     * The ARIA role for the content element. `dialog` suits a panel that holds its own widgets.
+     * A popup that is only a list should pass `none`, so the container does not sit between the
+     * control and the items its `aria-activedescendant` points at.
+     */
+    contentRole: FloatContentRole;
     /** Whether to focus the content when the menu opens. */
     autofocus: boolean;
+    /**
+     * Whether the menu takes part in the tab sequence as if it were rendered inline after its
+     * trigger, rather than at the portal's position in the document. Tab leads into the menu's own
+     * controls from the trigger, and off the end of them it closes the menu and continues from the
+     * trigger.
+     *
+     * The non-containing alternative to `trapTab`, for a menu that is dismissable but whose content
+     * holds focus. Setting it turns `trapTab` off on its own, so the two never have to be passed
+     * together; a caller that asks for the trap explicitly gets an assertion instead, since only a
+     * contradiction remains. The trap is also what applies `autofocus`, so a menu using this option
+     * opens with focus still on the trigger, which is where tabbing into the content starts from.
+     *
+     * A menu with nothing focusable in it is unaffected in either direction, so this is safe to set
+     * on a menu that only sometimes renders a control. It does not reach a menu that also sets
+     * `modalForMobile`, which on mobile renders as a real `aria-modal` dialog that owns its own
+     * containment.
+     */
+    inlineTabOrder: boolean;
     /** Whether the menu renders as a modal on mobile. */
     modalForMobile: boolean;
     /** Only one menu per group identifier is open at a time. */

package/declarations/float-kit/lib/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/lib/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/lib/constants.ts"],"names":[],"mappings":"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"}

package/declarations/float-kit/lib/d-menu-instance.d.ts

@@ -1,22 +1,25 @@
 import Owner from "@ember/owner";
-import { type FloatKitTrigger, type MenuOptions } from "discourse/float-kit/lib/constants";
+import { type FloatCloseOptions, type FloatKitTrigger, type MenuOptions } from "discourse/float-kit/lib/constants";
 import FloatKitInstance from "discourse/float-kit/lib/float-kit-instance";
 import type MenuService from "discourse/float-kit/services/menu";
-import type Site from "discourse/models/site";
-import type ModalService from "discourse/services/modal";
 /**
  * The concrete float instance backing a menu. It holds the menu's options,
  * open/close state, and portal outlet, and implements the trigger and lifecycle
  * hooks that `FloatKitInstance` orchestrates. A menu refocuses its trigger when
- * it closes and, on mobile, closes through the modal service when it was shown
- * as a modal.
+ * it closes.
  */
 export default class DMenuInstance extends FloatKitInstance {
+    #private;
     menu: MenuService;
-    site: Site;
-    modal: ModalService;
     /** Whether the menu is currently open. */
     expanded: boolean;
+    /**
+     * Whether the trigger is disabled. While true, a trigger event (click/focus/hover/hold) does
+     * not open the menu — the single reactive veto for every listener the base wires once at
+     * registration. `<DMenu>` keeps this in sync with its `@disabled` argument; it does not touch
+     * focusability or the trigger's own ARIA, which stay the caller's concern.
+     */
+    disabled: boolean;
     /**
      * Whether the menu's trigger is managed outside the `<DMenu />` component. It
      * is set when the menu is created through the `menu` service, where the
@@ -36,9 +39,7 @@ export default class DMenuInstance extends FloatKitInstance {
     get trigger(): FloatKitTrigger;
     set trigger(element: FloatKitTrigger);
     get shouldTrapPointerDown(): boolean;
-    close(options?: {
-        focusTrigger: boolean;
-    }): Promise<void>;
+    close(options?: FloatCloseOptions): Promise<void>;
     show(): Promise<void>;
     onPointerMove(event: PointerEvent): Promise<void>;
     onClick(event: MouseEvent): Promise<void>;

package/declarations/float-kit/lib/d-menu-instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"d-menu-instance.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/lib/d-menu-instance.ts"],"names":[],"mappings":"AAIA,OAAO,KAA6B,MAAM,cAAc,CAAC;AAGzD,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,WAAW,EACjB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,gBAAgB,MAAM,4CAA4C,CAAC;AAC1E,OAAO,KAAK,WAAW,MAAM,mCAAmC,CAAC;AAEjE,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,KAAK,YAAY,MAAM,0BAA0B,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,gBAAgB;IACxC,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,YAAY,CAAC;IAErC,0CAA0C;IACjC,QAAQ,UAAS;IAE1B;;;;;OAKG;IACM,eAAe,UAAS;IAEjC;;;OAGG;IACM,OAAO,EAAE,WAAW,CAAC;IACrB,2BAA2B,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAEjD,QAAQ,EAAE,eAAe,CAAC;gBAEvB,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM;IAQ5D,IAAI,mBAAmB,gBAKtB;IAED,IAAI,OAAO,IAIU,eAAe,CAFnC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,eAAe,EAKnC;IAED,IAAI,qBAAqB,YAExB;IAGK,KAAK,CAAC,OAAO;;KAAyB;IAuBtC,IAAI;IAMJ,aAAa,CAAC,KAAK,EAAE,YAAY;IASjC,OAAO,CAAC,KAAK,EAAE,UAAU;IAgBzB,cAAc,CAAC,KAAK,EAAE,YAAY;IAOlC,SAAS,CAAC,KAAK,EAAE,KAAK;IAQtB,WAAW,CAAC,KAAK,EAAE,KAAK;IAO9B,OAAO;CAIR"}
+{"version":3,"file":"d-menu-instance.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/lib/d-menu-instance.ts"],"names":[],"mappings":"AAIA,OAAO,KAA6B,MAAM,cAAc,CAAC;AAGzD,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAEpB,KAAK,WAAW,EACjB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,gBAAgB,MAAM,4CAA4C,CAAC;AAC1E,OAAO,KAAK,WAAW,MAAM,mCAAmC,CAAC;AAGjE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,gBAAgB;;IACxC,IAAI,EAAE,WAAW,CAAC;IAEnC,0CAA0C;IACjC,QAAQ,UAAS;IAE1B;;;;;OAKG;IACM,QAAQ,UAAS;IAE1B;;;;;OAKG;IACM,eAAe,UAAS;IAEjC;;;OAGG;IACM,OAAO,EAAE,WAAW,CAAC;IACrB,2BAA2B,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAEjD,QAAQ,EAAE,eAAe,CAAC;gBAEvB,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM;IAkB5D,IAAI,mBAAmB,gBAKtB;IAED,IAAI,OAAO,IAIU,eAAe,CAFnC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,eAAe,EAKnC;IAED,IAAI,qBAAqB,YAExB;IAYK,KAAK,CAAC,OAAO,GAAE,iBAAsB;IAkCrC,IAAI;IAMJ,aAAa,CAAC,KAAK,EAAE,YAAY;IASjC,OAAO,CAAC,KAAK,EAAE,UAAU;IAgBzB,cAAc,CAAC,KAAK,EAAE,YAAY;IAYlC,SAAS,CAAC,KAAK,EAAE,KAAK;IAqBtB,WAAW,CAAC,KAAK,EAAE,KAAK;IAO9B,OAAO;CAIR"}

package/declarations/float-kit/lib/d-tooltip-instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"d-tooltip-instance.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/lib/d-tooltip-instance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAmB,MAAM,cAAc,CAAC;AAG/C,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,cAAc,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,gBAAgB,MAAM,4CAA4C,CAAC;AAC1E,OAAO,KAAK,cAAc,MAAM,sCAAsC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,gBAAgB;IAC3C,OAAO,EAAE,cAAc,CAAC;IAEzC,6CAA6C;IACpC,QAAQ,UAAS;IAE1B;;;;;OAKG;IACM,eAAe,UAAS;IAEjC;;;OAGG;IACM,OAAO,EAAE,cAAc,CAAC;IACxB,2BAA2B,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAEjD,QAAQ,EAAE,eAAe,CAAC;gBAEvB,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM;IAQ/D,IAAI,OAAO,IAIU,eAAe,CAFnC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,eAAe,EAKnC;IAED,IAAI,mBAAmB,gBAKtB;IAGK,IAAI;IAMJ,KAAK;IAQL,aAAa,CAAC,KAAK,EAAE,YAAY;IAajC,OAAO,CAAC,KAAK,EAAE,UAAU;IAgBzB,cAAc,CAAC,KAAK,EAAE,YAAY;IAUlC,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK;IAOxB,WAAW,CAAC,MAAM,CAAC,EAAE,KAAK;IAKhC,OAAO;CAIR"}
+{"version":3,"file":"d-tooltip-instance.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/lib/d-tooltip-instance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAmB,MAAM,cAAc,CAAC;AAG/C,OAAO,EACL,KAAK,eAAe,EAEpB,KAAK,cAAc,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,gBAAgB,MAAM,4CAA4C,CAAC;AAC1E,OAAO,KAAK,cAAc,MAAM,sCAAsC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,gBAAgB;IAC3C,OAAO,EAAE,cAAc,CAAC;IAEzC,6CAA6C;IACpC,QAAQ,UAAS;IAE1B;;;;;OAKG;IACM,eAAe,UAAS;IAEjC;;;OAGG;IACM,OAAO,EAAE,cAAc,CAAC;IACxB,2BAA2B,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAEjD,QAAQ,EAAE,eAAe,CAAC;gBAEvB,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM;IAQ/D,IAAI,OAAO,IAIU,eAAe,CAFnC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,eAAe,EAKnC;IAED,IAAI,mBAAmB,gBAKtB;IAGK,IAAI;IAMJ,KAAK;IASL,aAAa,CAAC,KAAK,EAAE,YAAY;IAajC,OAAO,CAAC,KAAK,EAAE,UAAU;IAgBzB,cAAc,CAAC,KAAK,EAAE,YAAY;IAelC,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK;IAOxB,WAAW,CAAC,MAAM,CAAC,EAAE,KAAK;IAKhC,OAAO;CAIR"}