@discourse/types 2026.6.0-06d03da3 → 2026.8.0-fb9247e0

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

@@ -1,24 +1,58 @@
-export default class FloatKitInstance {
-    site: any;
-    id: any;
-    show(): Promise<void>;
-    close(): Promise<void>;
-    onFocus(event: any): Promise<void>;
-    onBlur(event: any): Promise<void>;
-    onFocusIn(event: any): Promise<void>;
-    onFocusOut(event: any): Promise<void>;
-    trapPointerDown(event: any): void;
-    onTouchStart(event: any): void;
-    touchTimeout: any;
-    onDelayedHoverEnter(event: any): void;
-    delayedHoverTimeout: any;
+import type { FloatKitTrigger, TooltipOptions } from "discourse/float-kit/lib/constants";
+import discourseLater from "discourse/lib/later";
+import type Site from "discourse/models/site";
+/**
+ * The behavior shared by every anchored float (menus and tooltips): the trigger's
+ * event listeners, the touch/hover trigger handling, and the `show`/`close`
+ * lifecycle hooks. Subclasses supply the concrete state and actions this base
+ * orchestrates (`options`, `trigger`, `expanded`, and the trigger/pointer actions).
+ */
+export default abstract class FloatKitInstance {
+    site: Site;
+    id: string | null;
+    /** The merged options bag; a menu or tooltip subclass narrows the exact shape. */
+    abstract options: TooltipOptions;
+    /**
+     * The reference the float is anchored to — a real element, or a virtual one when the
+     * float is positioned programmatically. Use `triggerElement` for element-only work.
+     */
+    abstract trigger: FloatKitTrigger;
+    /** Whether the float is currently open. */
+    abstract expanded: boolean;
+    /** The rendered float body, assigned by the `apply-floating-ui` modifier. */
+    content: HTMLElement;
+    touchTimeout: ReturnType<typeof discourseLater>;
+    delayedHoverTimeout: ReturnType<typeof discourseLater>;
     openedByDelayedHover: boolean;
+    /**
+     * The trigger narrowed to a real element, or `null` when it is a virtual reference.
+     * The listener, focus, and containment logic all go through this so a virtual trigger
+     * is a no-op rather than a runtime error.
+     */
+    get triggerElement(): HTMLElement | null;
+    /** The element the rendered float body is portalled into. */
+    abstract get portalOutletElement(): HTMLElement | null;
+    abstract onClick(event: MouseEvent): Promise<void>;
+    abstract onPointerMove(event: PointerEvent): Promise<void>;
+    abstract onPointerLeave(event: PointerEvent): Promise<void>;
+    abstract onTrigger(event?: Event): Promise<void>;
+    show(): Promise<void>;
+    close(options?: {
+        focusTrigger?: boolean;
+    }): Promise<void>;
+    onFocus(event: FocusEvent): Promise<void>;
+    onBlur(event: FocusEvent): Promise<void>;
+    onFocusIn(event: FocusEvent): Promise<void>;
+    onFocusOut(event: FocusEvent): Promise<void>;
+    trapPointerDown(event: PointerEvent): void;
+    onTouchStart(event: TouchEvent): void;
+    onDelayedHoverEnter(event: PointerEvent): void;
     onDelayedHoverLeave(): void;
     onTouchCancel(): void;
     tearDownListeners(): void;
     setupListeners(): void;
-    get triggers(): any;
-    get untriggers(): any;
+    get triggers(): string[];
+    get untriggers(): string[];
     get shouldTrapPointerDown(): boolean;
 }
 //# sourceMappingURL=float-kit-instance.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"float-kit-instance.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/lib/float-kit-instance.js"],"names":[],"mappings":"AAeA;IACE,UAAc;IAEd,QAAmB;IAEnB,sBAGC;IAED,uBAGC;IAED,mCAGC;IAED,kCAGC;IAED,qCAGC;IAED,sCAGC;IAED,kCAQC;IAED,+BAoCC;IAZC,kBAWO;IAGT,sCAUC;IAPC,yBAMO;IAFL,8BAAgC;IAKpC,4BAGC;IAED,sBAOC;IAED,0BAoDC;IAED,uBAsEC;IAED,oBAWC;IAED,sBAWC;IAED,qCAEC;CACF"}
+{"version":3,"file":"float-kit-instance.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/lib/float-kit-instance.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACf,MAAM,mCAAmC,CAAC;AAG3C,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAS9C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,gBAAgB;IAC3B,IAAI,EAAE,IAAI,CAAC;IAEnB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAQ;IAElC,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAElC,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B,6EAA6E;IACrE,OAAO,EAAE,WAAW,CAAC;IAErB,YAAY,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAEhD,mBAAmB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAEvD,oBAAoB,EAAE,OAAO,CAAC;IAEtC;;;;OAIG;IACH,IAAI,cAAc,IAAI,WAAW,GAAG,IAAI,CAEvC;IAED,6DAA6D;IAC7D,QAAQ,KAAK,mBAAmB,IAAI,WAAW,GAAG,IAAI,CAAC;IAEvD,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAClD,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1D,QAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3D,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAG1C,IAAI;IAQJ,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE;IAK1C,OAAO,CAAC,KAAK,EAAE,UAAU;IAKzB,MAAM,CAAC,KAAK,EAAE,UAAU;IAKxB,SAAS,CAAC,KAAK,EAAE,UAAU;IAK3B,UAAU,CAAC,KAAK,EAAE,UAAU;IAKlC,eAAe,CAAC,KAAK,EAAE,YAAY;IAUnC,YAAY,CAAC,KAAK,EAAE,UAAU;IA+B9B,mBAAmB,CAAC,KAAK,EAAE,YAAY;IAYvC,mBAAmB;IAKnB,aAAa;IAab,iBAAiB;IAoDjB,cAAc;IAiEd,IAAI,QAAQ,IAAI,MAAM,EAAE,CAUvB;IAED,IAAI,UAAU,IAAI,MAAM,EAAE,CAUzB;IAED,IAAI,qBAAqB,YAExB;CACF"}

package/declarations/float-kit/lib/get-scroll-parent.d.ts

@@ -1,2 +1,3 @@
-export function getScrollParent(node: any): any;
+import type { VirtualElement } from "@floating-ui/dom";
+export declare function getScrollParent(node: Node | VirtualElement | null): HTMLElement | Window | null;
 //# sourceMappingURL=get-scroll-parent.d.ts.map

package/declarations/float-kit/lib/get-scroll-parent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-scroll-parent.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/lib/get-scroll-parent.js"],"names":[],"mappings":"AAAA,gDAYC"}
+{"version":3,"file":"get-scroll-parent.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/lib/get-scroll-parent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,GAAG,cAAc,GAAG,IAAI,GACjC,WAAW,GAAG,MAAM,GAAG,IAAI,CAiB7B"}

package/declarations/float-kit/lib/update-position.d.ts

@@ -1,2 +1,35 @@
-export function updatePosition(trigger: any, content: any, options: any): Promise<void>;
+import { type AutoUpdateOptions, type Boundary, type ComputePositionReturn, limitShift, type Padding, type Strategy } from "@floating-ui/dom";
+import { type FloatKitTrigger, type FloatUiPlacement, type VisibilityOptimizer } from "discourse/float-kit/lib/constants";
+/**
+ * The positioning-related subset of a float's options that `updatePosition` reads.
+ * Menu/tooltip instances pass their full options bag here; every field is optional
+ * because programmatic callers supply only the ones they need and the rest fall back
+ * to floating-ui defaults. `placement` additionally accepts the sentinel `"center"`,
+ * which centers the float over its trigger instead of anchoring to an edge.
+ */
+export interface PositioningOptions {
+    placement?: FloatUiPlacement | "center";
+    strategy?: Strategy;
+    autoUpdate?: boolean | AutoUpdateOptions;
+    offset?: number;
+    inline?: boolean | null;
+    arrow?: boolean;
+    hide?: boolean;
+    padding?: Padding;
+    boundary?: Boundary;
+    visibilityOptimizer?: VisibilityOptimizer;
+    shiftBeforeVisibilityOptimizer?: boolean;
+    allowedPlacements?: readonly FloatUiPlacement[];
+    fallbackPlacements?: readonly FloatUiPlacement[];
+    limitShift?: Parameters<typeof limitShift>[0];
+    crossAxisShift?: boolean;
+    matchTriggerWidth?: boolean;
+    matchTriggerMinWidth?: boolean;
+    constrainHeightToViewport?: boolean;
+    minHeight?: number;
+    computePosition?: (content: HTMLElement, result: ComputePositionReturn & {
+        arrowElement?: HTMLElement;
+    }) => void;
+}
+export declare function updatePosition(trigger: FloatKitTrigger, content: HTMLElement, options: PositioningOptions): Promise<void>;
 //# sourceMappingURL=update-position.d.ts.map

package/declarations/float-kit/lib/update-position.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-position.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/lib/update-position.js"],"names":[],"mappings":"AAyBA,wFA2BC"}
+{"version":3,"file":"update-position.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/lib/update-position.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EAEb,KAAK,qBAAqB,EAI1B,UAAU,EAGV,KAAK,OAAO,EAIZ,KAAK,QAAQ,EACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAErB,KAAK,mBAAmB,EACzB,MAAM,mCAAmC,CAAC;AAM3C;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,gBAAgB,GAAG,QAAQ,CAAC;IACxC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC,iBAAiB,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD,kBAAkB,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACjD,UAAU,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,CAChB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,qBAAqB,GAAG;QAAE,YAAY,CAAC,EAAE,WAAW,CAAA;KAAE,KAC3D,IAAI,CAAC;CACX;AAiBD,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/declarations/float-kit/modifiers/apply-floating-ui.d.ts

@@ -1,11 +1,29 @@
-export default class FloatKitApplyFloatingUi extends Modifier<import("ember-modifier/-private/signature").DefaultSignature> {
-    constructor(owner: any, args: any);
-    modify(element: any, [trigger, options, instance]: [any, any, any]): void;
-    instance: any;
-    options: any;
-    cleanup: () => void;
+import type Owner from "@ember/owner";
+import Modifier, { type ArgsFor } from "ember-modifier";
+import type { FloatKitTrigger } from "discourse/float-kit/lib/constants";
+import type FloatKitInstance from "discourse/float-kit/lib/float-kit-instance";
+import { type PositioningOptions } from "discourse/float-kit/lib/update-position";
+interface FloatKitApplyFloatingUiSignature {
+    Element: HTMLElement;
+    Args: {
+        Positional: [
+            /** The reference the float is anchored to. */
+            trigger: FloatKitTrigger,
+            /** The positioning options, or `undefined` to use the defaults. */
+            options: PositioningOptions | undefined,
+            /** The float instance being positioned. */
+            instance: FloatKitInstance
+        ];
+    };
+}
+export default class FloatKitApplyFloatingUi extends Modifier<FloatKitApplyFloatingUiSignature> {
+    instance: FloatKitInstance;
+    options: PositioningOptions;
+    cleanup?: () => void;
+    constructor(owner: Owner, args: ArgsFor<FloatKitApplyFloatingUiSignature>);
+    modify(element: HTMLElement, [trigger, options, instance,]: FloatKitApplyFloatingUiSignature["Args"]["Positional"]): void;
     update(): Promise<void>;
     teardown(): void;
 }
-import Modifier from "ember-modifier";
+export {};
 //# sourceMappingURL=apply-floating-ui.d.ts.map

package/declarations/float-kit/modifiers/apply-floating-ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply-floating-ui.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/modifiers/apply-floating-ui.js"],"names":[],"mappings":"AAMA;IACE,mCAGC;IAED,0EAiBC;IAfC,cAAwB;IACxB,aAA4B;IAG1B,oBAOC;IAML,wBAWC;IAED,iBAEC;CACF;qBA7CoB,gBAAgB"}
+{"version":3,"file":"apply-floating-ui.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/modifiers/apply-floating-ui.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,QAAQ,EAAE,EAAE,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,gBAAgB,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,yCAAyC,CAAC;AAGjD,UAAU,gCAAgC;IACxC,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE;QACJ,UAAU,EAAE;YACV,8CAA8C;YAC9C,OAAO,EAAE,eAAe;YAExB,mEAAmE;YACnE,OAAO,EAAE,kBAAkB,GAAG,SAAS;YAEvC,2CAA2C;YAC3C,QAAQ,EAAE,gBAAgB;SAC3B,CAAC;KACH,CAAC;CACH;AAED,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,QAAQ,CAAC,gCAAgC,CAAC;IACrF,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;gBAEjB,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,gCAAgC,CAAC;IAKzE,MAAM,CACJ,OAAO,EAAE,WAAW,EACpB,CACE,OAAO,EACP,OAAO,EACP,QAAQ,EACT,EAAE,gCAAgC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC;IAqBrD,MAAM;IAYZ,QAAQ;CAGT"}

package/declarations/float-kit/modifiers/auto-close-toast.d.ts

@@ -1,25 +1,38 @@
-export default class AutoCloseToast extends Modifier<import("ember-modifier/-private/signature").DefaultSignature> {
-    constructor(owner: any, args: any);
-    element: any;
-    close: any;
-    duration: any;
-    transitionLaterHandler: any;
-    closeLaterHandler: any;
-    progressBar: any;
-    progressAnimation: any;
-    enabled: any;
-    modify(element: any, _: any, { close, duration, progressBar, enabled }: {
-        close: any;
-        duration: any;
-        progressBar: any;
-        enabled: any;
-    }): void;
-    timeRemaining: any;
+import type Owner from "@ember/owner";
+import Modifier, { type ArgsFor } from "ember-modifier";
+import discourseLater from "discourse/lib/later";
+interface AutoCloseToastSignature {
+    Element: HTMLElement;
+    Args: {
+        Named: {
+            /** Closes the toast. */
+            close: () => void;
+            /** How long the toast stays open before auto-closing, in milliseconds. */
+            duration: number;
+            /** The progress-bar element to animate down over `duration`. */
+            progressBar?: HTMLElement | null;
+            /** Whether auto-close is active. */
+            enabled?: boolean;
+        };
+    };
+}
+export default class AutoCloseToast extends Modifier<AutoCloseToastSignature> {
+    element: HTMLElement;
+    close: () => void;
+    duration: number;
+    timeRemaining: number;
+    transitionLaterHandler: ReturnType<typeof discourseLater>;
+    closeLaterHandler: ReturnType<typeof discourseLater>;
+    progressBar: HTMLElement | null;
+    progressAnimation: Animation | null;
+    enabled: boolean;
+    constructor(owner: Owner, args: ArgsFor<AutoCloseToastSignature>);
+    modify(element: HTMLElement, _: [], { close, duration, progressBar, enabled, }: AutoCloseToastSignature["Args"]["Named"]): void;
     startTimer(): void;
     stopTimer(): void;
     startProgressAnimation(): void;
     pauseProgressAnimation(): void;
     cleanup(): void;
 }
-import Modifier from "ember-modifier";
+export {};
 //# sourceMappingURL=auto-close-toast.d.ts.map

package/declarations/float-kit/modifiers/auto-close-toast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-close-toast.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/modifiers/auto-close-toast.js"],"names":[],"mappings":"AASA;IAUE,mCAGC;IAZD,aAAQ;IACR,WAAM;IACN,cAAS;IACT,4BAAuB;IACvB,uBAAkB;IAClB,iBAAY;IACZ,uBAAkB;IAClB,aAAQ;IAOR;;;;;aAsBC;IAbC,mBAA6B;IAe/B,mBAWC;IAED,kBAKC;IAED,+BAgBC;IAED,+BAYC;IAED,gBASC;CACF;qBA5GoB,gBAAgB"}
+{"version":3,"file":"auto-close-toast.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/modifiers/auto-close-toast.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,QAAQ,EAAE,EAAE,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,cAAc,MAAM,qBAAqB,CAAC;AAKjD,UAAU,uBAAuB;IAC/B,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE;QACJ,KAAK,EAAE;YACL,wBAAwB;YACxB,KAAK,EAAE,MAAM,IAAI,CAAC;YAElB,0EAA0E;YAC1E,QAAQ,EAAE,MAAM,CAAC;YAEjB,gEAAgE;YAChE,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;YAEjC,oCAAoC;YACpC,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC;KACH,CAAC;CACH;AAED,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,QAAQ,CAAC,uBAAuB,CAAC;IACnE,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAC1D,iBAAiB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IACrD,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,SAAS,GAAG,IAAI,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;gBAEb,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAKhE,MAAM,CACJ,OAAO,EAAE,WAAW,EACpB,CAAC,EAAE,EAAE,EACL,EACE,KAAK,EACL,QAAQ,EACR,WAAW,EACX,OAAO,GACR,EAAE,uBAAuB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;IA0B7C,UAAU;IAaV,SAAS;IAOT,sBAAsB;IAkBtB,sBAAsB;IAgBtB,OAAO;CAUR"}

package/declarations/float-kit/modifiers/close-on-escape.d.ts

@@ -1,10 +1,21 @@
-export default class FloatKitCloseOnEscape extends Modifier<import("ember-modifier/-private/signature").DefaultSignature> {
-    constructor(owner: any, args: any);
-    modify(element: any, [closeFn]: [any]): void;
-    closeFn: any;
-    element: any;
-    check(event: any): void;
+import type Owner from "@ember/owner";
+import Modifier, { type ArgsFor } from "ember-modifier";
+interface FloatKitCloseOnEscapeSignature {
+    Element: HTMLElement;
+    Args: {
+        Positional: [
+            /** Called when Escape is pressed. */
+            close: () => void
+        ];
+    };
+}
+export default class FloatKitCloseOnEscape extends Modifier<FloatKitCloseOnEscapeSignature> {
+    closeFn: () => void;
+    element: HTMLElement;
+    constructor(owner: Owner, args: ArgsFor<FloatKitCloseOnEscapeSignature>);
+    modify(element: HTMLElement, [closeFn]: FloatKitCloseOnEscapeSignature["Args"]["Positional"]): void;
+    check(event: KeyboardEvent): void;
     cleanup(): void;
 }
-import Modifier from "ember-modifier";
+export {};
 //# sourceMappingURL=close-on-escape.d.ts.map

package/declarations/float-kit/modifiers/close-on-escape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"close-on-escape.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/modifiers/close-on-escape.js"],"names":[],"mappings":"AAIA;IACE,mCAGC;IAED,6CAKC;IAJC,aAAsB;IACtB,aAAsB;IAKxB,wBAOC;IAED,gBAEC;CACF;qBA5BoB,gBAAgB"}
+{"version":3,"file":"close-on-escape.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/modifiers/close-on-escape.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,QAAQ,EAAE,EAAE,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGxD,UAAU,8BAA8B;IACtC,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE;QACJ,UAAU,EAAE;YACV,qCAAqC;YACrC,KAAK,EAAE,MAAM,IAAI;SAClB,CAAC;KACH,CAAC;CACH;AAED,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,QAAQ,CAAC,8BAA8B,CAAC;IACjF,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;gBAEjB,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,8BAA8B,CAAC;IAKvE,MAAM,CACJ,OAAO,EAAE,WAAW,EACpB,CAAC,OAAO,CAAC,EAAE,8BAA8B,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC;IASjE,KAAK,CAAC,KAAK,EAAE,aAAa;IAQ1B,OAAO;CAGR"}

package/declarations/float-kit/services/internal-tooltip.d.ts

@@ -1,5 +1,6 @@
+import Service from "@ember/service";
+import type DTooltipInstance from "discourse/float-kit/lib/d-tooltip-instance";
 export default class InternalTooltip extends Service {
-    activeTooltip: any;
+    activeTooltip?: DTooltipInstance;
 }
-import Service from "@ember/service";
 //# sourceMappingURL=internal-tooltip.d.ts.map

package/declarations/float-kit/services/internal-tooltip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal-tooltip.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/services/internal-tooltip.js"],"names":[],"mappings":"AASA;IACE,mBAAuB;CACxB;oBAVmB,gBAAgB"}
+{"version":3,"file":"internal-tooltip.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/services/internal-tooltip.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,gBAAgB,CAAC;AACrC,OAAO,KAAK,gBAAgB,MAAM,4CAA4C,CAAC;AAQ/E,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IACzC,aAAa,CAAC,EAAE,gBAAgB,CAAC;CAC3C"}

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

@@ -1,50 +1,56 @@
+import Service from "@ember/service";
+import type { FloatKitTrigger, MenuOptions } from "discourse/float-kit/lib/constants";
+import DMenuInstance from "discourse/float-kit/lib/d-menu-instance";
+/**
+ * The service that shows menus imperatively, outside the `<DMenu />` component.
+ * It tracks every registered menu, enforces that only one menu per `identifier`
+ * or `groupIdentifier` is open at a time, and exposes the set that `DMenus`
+ * renders at the app root. Prefer `<DMenu />` when a template can own the trigger
+ * and content directly.
+ */
 export default class Menu extends Service {
-    registeredMenus: Set<unknown>;
+    registeredMenus: Set<DMenuInstance>;
     /**
-     * Render a menu
-     *
-     * @param {Element | DMenuInstance}
-     *  - trigger - the element that triggered the menu, can also be an object implementing `getBoundingClientRect`
-     *  - menu - an instance of a menu
-     * @param {Object} [options] - options
-     * @param {String | Element | Component} [options.content] - Specifies the content of the menu
-     * @param {Integer} [options.maxWidth] - Specifies the maximum width of the content
-     * @param {Object} [options.data] - An object which will be passed as the `@data` argument when content is a `Component`
-     * @param {Boolean} [options.arrow] - Determines if the menu has an arrow
-     * @param {Boolean} [options.offset] - Displaces the content from its reference trigger in pixels
-     * @param {String} [options.identifier] - Add a data-identifier attribute to the trigger and the content, multiple menus can have the same identifier,
-     * only one menu with the same identifier can be open at a time
-     * @param {String} [options.groupIdentifier] - Only one menu with the same groupIdentifier can be open at a time
-     * @param {Boolean} [options.inline] - Improves positioning for trigger that spans over multiple lines
-     *
-     * @returns {Promise<DMenuInstance | undefined>}
+     * Render a menu.
+     *
+     * @param triggerOrInstance - the element that triggered the menu (may also be an
+     *   object implementing `getBoundingClientRect`), or an existing menu instance.
+     * @param options - the menu options; each field is documented on {@link MenuOptions}.
+     *
+     * @returns the shown menu instance, or `undefined` when the call is a no-op.
      */
-    show(...args: any[]): Promise<DMenuInstance | undefined>;
-    newInstance(trigger: any, options: any): DMenuInstance;
+    show(triggerOrInstance: FloatKitTrigger | DMenuInstance, options?: Partial<MenuOptions>): Promise<DMenuInstance>;
     /**
-     * Returns an existing menu by its identifier if found
+     * Creates a menu instance with a detached trigger, without showing it.
      *
-     * @param {String} identifier - the menu identifier to retrieve
+     * @param trigger - the element the menu is anchored to (may also be an object
+     *   implementing `getBoundingClientRect`).
+     * @param options - the menu options; each field is documented on {@link MenuOptions}.
      *
-     * @returns {DMenuInstance | undefined}
+     * @returns the created menu instance.
      */
-    getByIdentifier(identifier: string): DMenuInstance | undefined;
+    newInstance(trigger: FloatKitTrigger, options?: Partial<MenuOptions>): DMenuInstance;
     /**
-     * Closes the given menu
+     * Returns an existing menu by its identifier if found.
      *
-     * @param {DMenuInstance | String} [menu | identifier] - the menu to close, can accept an instance or an identifier
+     * @param identifier - the menu identifier to retrieve.
+     */
+    getByIdentifier(identifier: string): DMenuInstance;
+    /**
+     * Closes the given menu.
+     *
+     * @param menu - the menu to close, either an instance or an identifier.
      */
     close(menu?: DMenuInstance | string): Promise<void>;
     /**
-     * Register event listeners on a trigger to show a menu
+     * Registers event listeners on a trigger to show a menu.
      *
-     * @param {Element} trigger - the element that triggered the menu, can also be an object implementing `getBoundingClientRect`
-     * @param {Object} [options] - @see `show`
+     * @param trigger - the element that triggered the menu (may also be an object
+     *   implementing `getBoundingClientRect`).
+     * @param options - see `show`.
      *
-     * @returns {DMenuInstance} An instance of the menu
+     * @returns the created menu instance.
      */
-    register(trigger: Element, options?: any): DMenuInstance;
+    register(trigger: FloatKitTrigger, options?: Partial<MenuOptions>): DMenuInstance;
 }
-import Service from "@ember/service";
-import DMenuInstance from "discourse/float-kit/lib/d-menu-instance";
 //# sourceMappingURL=menu.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/services/menu.js"],"names":[],"mappings":"AAOA;IACE,8BAA+B;IAE/B;;;;;;;;;;;;;;;;;;OAkBG;IACH,sBAFa,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAkD9C;IAED,uDAMC;IAED;;;;;;OAMG;IACH,qCAFa,aAAa,GAAG,SAAS,CAMrC;IAED;;;;OAIG;IACH,aAFW,aAAa,SAAS,iBAqBhC;IAED;;;;;;;OAOG;IACH,kBALW,OAAO,kBAGL,aAAa,CAWzB;CACF;oBA5ImB,gBAAgB;0BACV,yCAAyC"}
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/services/menu.ts"],"names":[],"mappings":"AAIA,OAAO,OAAO,MAAM,gBAAgB,CAAC;AACrC,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACZ,MAAM,mCAAmC,CAAC;AAC3C,OAAO,aAAa,MAAM,yCAAyC,CAAC;AAEpE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,OAAO;IACvC,eAAe,qBAA+B;IAE9C;;;;;;;;OAQG;IAEG,IAAI,CACR,iBAAiB,EAAE,eAAe,GAAG,aAAa,EAClD,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAsDhC;;;;;;;;OAQG;IACH,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAQpE;;;;OAIG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM;IAMlC;;;;OAIG;IAEG,KAAK,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM;IAwBzC;;;;;;;;OAQG;IAEH,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM;CAStE"}

package/declarations/float-kit/services/toasts.d.ts

@@ -1,69 +1,63 @@
+import Service from "@ember/service";
+import type { ToastData, ToastOptions } from "discourse/float-kit/lib/constants";
+import DToastInstance from "discourse/float-kit/lib/d-toast-instance";
+/** The options accepted by the themed convenience methods, which require `data`. */
+type ThemedToastOptions = Partial<ToastOptions> & {
+    data: ToastData;
+};
+/**
+ * The service that shows and dismisses toasts. Toasts are always created
+ * imperatively — there is no declarative component — so call `show` with a
+ * custom body component, or a themed helper such as `success`/`error` that
+ * renders the default body. It holds the list of active toasts that `DToasts`
+ * renders at the app root.
+ */
 export default class Toasts extends Service {
-    activeToasts: unknown[];
+    activeToasts: DToastInstance[];
     /**
-     * Render a toast
+     * Render a toast.
      *
-     * @param {Object} [options] - options passed to the toast component as `@toast` argument
-     * @param {String} [options.duration] - The duration (ms) of the toast, will be closed after this time
-     * @param {Boolean} [options.autoClose=true] - When true, the toast will autoClose after the duration
-     * @param {ComponentClass} [options.component] - A component to render, will use `DDefaultToast` if not provided
-     * @param {String} [options.class] - A class added to the d-toast element
-     * @param {Object} [options.data] - An object which will be passed as the `@data` argument to the component
+     * @param options - options passed to the toast component as its `@toast` argument;
+     *   each field is documented on {@link ToastOptions}. When no `component` is given,
+     *   `DDefaultToast` is used.
      *
-     * @returns {DToastInstance} - a toast instance
+     * @returns the created toast instance.
      */
-    show(options?: {
-        duration?: string;
-        autoClose?: boolean;
-        component?: ComponentClass;
-        class?: string;
-        data?: any;
-    }): DToastInstance;
+    show(options?: Partial<ToastOptions>): DToastInstance;
     /**
-     * Render a DDefaultToast toast with the default theme
-     *
-     * @param {Object} [options] - @see show
+     * Render a `DDefaultToast` with the default theme.
      *
-     * @returns {DToastInstance} - a toast instance
+     * @param options - see `show`.
      */
-    default(options?: any): DToastInstance;
+    default(options: ThemedToastOptions): DToastInstance;
     /**
-     * Render a DDefaultToast toast with the success theme
+     * Render a `DDefaultToast` with the success theme.
      *
-     * @param {Object} [options] - @see show
-     *
-     * @returns {DToastInstance} - a toast instance
+     * @param options - see `show`.
      */
-    success(options?: any): DToastInstance;
+    success(options: ThemedToastOptions): DToastInstance;
     /**
-     * Render a DDefaultToast toast with the error theme
-     *
-     * @param {Object} [options] - @see show
+     * Render a `DDefaultToast` with the error theme.
      *
-     * @returns {DToastInstance} - a toast instance
+     * @param options - see `show`.
      */
-    error(options?: any): DToastInstance;
+    error(options: ThemedToastOptions): DToastInstance;
     /**
-     * Render a DDefaultToast toast with the warning theme
+     * Render a `DDefaultToast` with the warning theme.
      *
-     * @param {Object} [options] - @see show
-     *
-     * @returns {DToastInstance} - a toast instance
+     * @param options - see `show`.
      */
-    warning(options?: any): DToastInstance;
+    warning(options: ThemedToastOptions): DToastInstance;
     /**
-     * Render a DDefaultToast toast with the info theme
-     *
-     * @param {Object} [options] - @see show
+     * Render a `DDefaultToast` with the info theme.
      *
-     * @returns {DToastInstance} - a toast instance
+     * @param options - see `show`.
      */
-    info(options?: any): DToastInstance;
+    info(options: ThemedToastOptions): DToastInstance;
     /**
-     * Close a toast. Any object containing a valid `id` property can be used as a toast parameter.
+     * Close a toast. Any object with a valid `id` property can be used.
      */
-    close(toast: any): void;
+    close(toast: Pick<DToastInstance, "id">): void;
 }
-import Service from "@ember/service";
-import DToastInstance from "discourse/float-kit/lib/d-toast-instance";
+export {};
 //# sourceMappingURL=toasts.d.ts.map

package/declarations/float-kit/services/toasts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toasts.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/services/toasts.js"],"names":[],"mappings":"AAQA;IACE,wBAAuC;IAEvC;;;;;;;;;;;OAWG;IACH,eARG;QAAyB,QAAQ;QACP,SAAS;QACF,SAAS,GAAlC,cAAc;QACG,KAAK;QACL,IAAI;KAE7B,GAAU,cAAc,CAc1B;IAED;;;;;;OAMG;IACH,wBAFa,cAAc,CAO1B;IAED;;;;;;OAMG;IACH,wBAFa,cAAc,CAQ1B;IAED;;;;;;OAMG;IACH,sBAFa,cAAc,CAQ1B;IAED;;;;;;OAMG;IACH,wBAFa,cAAc,CAQ1B;IAED;;;;;;OAMG;IACH,qBAFa,cAAc,CAQ1B;IAED;;OAEG;IACH,wBAKC;CACF;oBApHmB,gBAAgB;2BAET,0CAA0C"}
+{"version":3,"file":"toasts.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/services/toasts.ts"],"names":[],"mappings":"AAIA,OAAO,OAAO,MAAM,gBAAgB,CAAC;AAErC,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACb,MAAM,mCAAmC,CAAC;AAC3C,OAAO,cAAc,MAAM,0CAA0C,CAAC;AAEtE,oFAAoF;AACpF,KAAK,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,OAAO;IAChC,YAAY,mBAAkC;IAEvD;;;;;;;;OAQG;IAEH,IAAI,CAAC,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM;IAaxC;;;;OAIG;IAEH,OAAO,CAAC,OAAO,EAAE,kBAAkB;IAMnC;;;;OAIG;IAEH,OAAO,CAAC,OAAO,EAAE,kBAAkB;IAOnC;;;;OAIG;IAEH,KAAK,CAAC,OAAO,EAAE,kBAAkB;IAOjC;;;;OAIG;IAEH,OAAO,CAAC,OAAO,EAAE,kBAAkB;IAOnC;;;;OAIG;IAEH,IAAI,CAAC,OAAO,EAAE,kBAAkB;IAOhC;;OAEG;IAEH,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC;CAKxC"}

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

@@ -1,38 +1,40 @@
+import Service from "@ember/service";
+import type { FloatKitTrigger, TooltipOptions } from "discourse/float-kit/lib/constants";
+import DTooltipInstance from "discourse/float-kit/lib/d-tooltip-instance";
+/**
+ * The service that shows tooltips imperatively, outside the `<DTooltip />`
+ * component. It tracks every registered tooltip, enforces that only one tooltip
+ * per `identifier` is open at a time, and exposes the set that `DTooltips`
+ * renders at the app root. Prefer `<DTooltip />` when a template can own the
+ * trigger and content directly.
+ */
 export default class Tooltip extends Service {
-    registeredTooltips: Set<unknown>;
+    registeredTooltips: Set<DTooltipInstance>;
     /**
-     * Render a tooltip
+     * Render a tooltip.
      *
-     * @param {Element | DTooltipInstance}
-     *  - trigger - the element that triggered the tooltip, can also be an object implementing `getBoundingClientRect`
-     *  - tooltip - an instance of a tooltip
-     * @param {Object} [options] - options, if trigger given as first argument
-     * @param {String | Element | Component} [options.content] - Specifies the content of the tooltip
-     * @param {Integer} [options.maxWidth] - Specifies the maximum width of the content
-     * @param {Object} [options.data] - An object which will be passed as the `@data` argument when content is a `Component`
-     * @param {Boolean} [options.arrow] - Determines if the tooltip has an arrow
-     * @param {Boolean} [options.offset] - Displaces the content from its reference trigger in pixels
-     * @param {String} [options.identifier] - Add a data-identifier attribute to the trigger and the content
-     * @param {Boolean} [options.inline] - Improves positioning for trigger that spans over multiple lines
+     * @param triggerOrInstance - the element that triggered the tooltip (may also be an
+     *   object implementing `getBoundingClientRect`), or an existing tooltip instance.
+     * @param options - the tooltip options; each field is documented on {@link TooltipOptions}.
      *
-     * @returns {Promise<DTooltipInstance | undefined>}
+     * @returns the shown tooltip instance, or `undefined` when the call is a no-op.
      */
-    show(...args: any[]): Promise<DTooltipInstance | undefined>;
+    show(triggerOrInstance: FloatKitTrigger | DTooltipInstance, options?: Partial<TooltipOptions>): Promise<DTooltipInstance>;
     /**
-     * Closes the given tooltip
-     * @param {DTooltipInstance | String} [tooltip | identifier] - the tooltip to close, can accept an instance or an identifier
+     * Closes the given tooltip.
+     *
+     * @param tooltip - the tooltip to close, either an instance or an identifier.
      */
     close(tooltip?: DTooltipInstance | string): Promise<void>;
     /**
-     * Register event listeners on a trigger to show a tooltip
+     * Registers event listeners on a trigger to show a tooltip.
      *
-     * @param {Element} trigger - the element that triggered the tooltip, can also be an object implementing `getBoundingClientRect`
-     * @param {Object} [options] - @see `show`
+     * @param trigger - the element that triggered the tooltip (may also be an object
+     *   implementing `getBoundingClientRect`).
+     * @param options - see `show`.
      *
-     * @returns {DTooltipInstance} An instance of the tooltip
+     * @returns the created tooltip instance.
      */
-    register(trigger: Element, options?: any): DTooltipInstance;
+    register(trigger: FloatKitTrigger, options?: Partial<TooltipOptions>): DTooltipInstance;
 }
-import Service from "@ember/service";
-import DTooltipInstance from "discourse/float-kit/lib/d-tooltip-instance";
 //# sourceMappingURL=tooltip.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/services/tooltip.js"],"names":[],"mappings":"AAOA;IACE,iCAAkC;IAElC;;;;;;;;;;;;;;;;OAgBG;IACH,sBAFa,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAgDjD;IAED;;;OAGG;IACH,gBAFW,gBAAgB,SAAS,iBAqBnC;IAED;;;;;;;OAOG;IACH,kBALW,OAAO,kBAGL,gBAAgB,CAW5B;CACF;oBAlHmB,gBAAgB;6BACP,4CAA4C"}
+{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/services/tooltip.ts"],"names":[],"mappings":"AAIA,OAAO,OAAO,MAAM,gBAAgB,CAAC;AACrC,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,gBAAgB,MAAM,4CAA4C,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,OAAO;IAC1C,kBAAkB,wBAAkC;IAEpD;;;;;;;;OAQG;IAEG,IAAI,CACR,iBAAiB,EAAE,eAAe,GAAG,gBAAgB,EACrD,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAoDnC;;;;OAIG;IAEG,KAAK,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM;IAsB/C;;;;;;;;OAQG;IAEH,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM;CASzE"}

package/declarations/select-kit/compat-modules.d.ts

@@ -0,0 +1,3 @@
+export default compatModules;
+declare const compatModules: {};
+//# sourceMappingURL=compat-modules.d.ts.map

package/declarations/select-kit/compat-modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat-modules.d.ts","sourceRoot":"","sources":["../../../discourse/select-kit/compat-modules.js"],"names":[],"mappings":";AAEA,gCAAyB"}