@discourse/types 2026.7.0-ded677e0 → 2026.8.0-fb9247e0

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

@@ -1,3 +1,74 @@
+import type Owner from "@ember/owner";
+import Modifier, { type ArgsFor } from "ember-modifier";
+import type Site from "discourse/models/site";
+/**
+ * The gesture state reported by the `swipe-events` custom events and handed to the
+ * start, move, and end callbacks.
+ */
+export interface SwipeState {
+    /** The pointer coordinates where the gesture started. */
+    startLocation: {
+        x: number;
+        y: number;
+    };
+    /** The current pointer coordinates. */
+    center: {
+        x: number;
+        y: number;
+    };
+    /** The horizontal velocity, in pixels per millisecond. */
+    velocityX: number;
+    /** The vertical velocity, in pixels per millisecond. */
+    velocityY: number;
+    /** The horizontal displacement from `startLocation`, in pixels. */
+    deltaX: number;
+    /** The vertical displacement from `startLocation`, in pixels. */
+    deltaY: number;
+    /** Whether this is the first state of the gesture. */
+    start: boolean;
+    /** When this state was produced, as an epoch timestamp in milliseconds. */
+    timestamp: number;
+    /** The dominant direction of the gesture, fixed once first determined. */
+    direction: "up" | "down" | "left" | "right";
+    /** The element the gesture is tracked on. */
+    element: HTMLElement;
+    /** Returns whether the gesture direction is `"up"`. */
+    goingUp: () => boolean;
+    /** Returns whether the gesture direction is `"down"`. */
+    goingDown: () => boolean;
+    /** The underlying DOM event that produced this state. */
+    originalEvent?: Event;
+}
+/** The detail reported when a gesture is cancelled. */
+export interface SwipeCancelDetail {
+    /** The underlying DOM event that triggered the cancellation. */
+    originalEvent: Event;
+}
+interface DSwipeSignature {
+    /** The element the swipe listeners are attached to. */
+    Element: HTMLElement;
+    Args: {
+        Named: {
+            /**
+             * Called when a gesture starts. Calling `preventDefault()` on the event
+             * cancels the gesture: the body is not locked and no further swipe events
+             * fire for it.
+             */
+            onDidStartSwipe?: (state: SwipeState, event: Event) => void;
+            /** Called on each pointer move while the gesture is in progress. */
+            onDidSwipe?: (state: SwipeState) => void;
+            /** Called when the gesture ends. */
+            onDidEndSwipe?: (state: SwipeState) => void;
+            /** Called when the gesture is cancelled, e.g. by a second touch. */
+            onDidCancelSwipe?: (detail: SwipeCancelDetail) => void;
+            /** Whether swipe handling is enabled. Defaults to `true`; always off on desktop. */
+            enabled?: boolean;
+            /** Whether to lock body scrolling for the duration of the gesture. Defaults to `true`. */
+            lockBody?: boolean;
+        };
+        Positional: [];
+    };
+}
 /**
  * A modifier for handling swipe gestures on an element.
  *
@@ -17,81 +88,41 @@
  * >
  *   Swipe here
  * </div>
- *
- * @extends Modifier
- */
-/**
- * SwipeModifier class.
  */
-export default class DSwipeModifier extends Modifier<import("ember-modifier/-private/signature").DefaultSignature> {
-    /**
-     * Creates an instance of SwipeModifier.
-     * @param {Owner} owner - The owner.
-     * @param {Object} args - The arguments.
-     */
-    constructor(owner: Owner, args: any);
-    site: any;
+export default class DSwipeModifier extends Modifier<DSwipeSignature> {
+    #private;
+    site: Site;
+    constructor(owner: Owner, args: ArgsFor<DSwipeSignature>);
     /**
      * Modifies the element for swipe functionality.
-     * @param {HTMLElement} element - The element to modify.
-     * @param {*} _ - Unused argument.
-     * @param {Object} options - Options for modifying the swipe behavior.
-     * @param {Function} options.onDidStartSwipe - Callback function when swipe starts.
-     * @param {Function} options.onDidSwipe - Callback function when swipe occurs.
-     * @param {Function} options.onDidEndSwipe - Callback function when swipe ends.
-     * @param {Function} options.onDidCancelSwipe - Callback function when swipe is canceled.
-     * @param {boolean} options.enabled - Flag to enable/disable swipe.
-     * @param {boolean} options.lockBody - Automatically enable/disable body scroll lock.
+     *
+     * @param element - The element to modify.
+     * @param _positional - Unused positional arguments.
+     * @param named - Options for modifying the swipe behavior.
      */
-    modify(element: HTMLElement, _: any, { onDidStartSwipe, onDidSwipe, onDidEndSwipe, onDidCancelSwipe, enabled, lockBody, }: {
-        onDidStartSwipe: Function;
-        onDidSwipe: Function;
-        onDidEndSwipe: Function;
-        onDidCancelSwipe: Function;
-        enabled: boolean;
-        lockBody: boolean;
-    }): void;
-    enabled: boolean;
-    lockBody: boolean;
-    element: HTMLElement;
-    onDidSwipeCallback: Function;
-    onDidStartSwipeCallback: Function;
-    onDidCancelSwipeCallback: Function;
-    onDidEndSwipeCallback: Function;
-    _swipeEvents: SwipeEvents;
+    modify(element: HTMLElement, _positional: [], { onDidStartSwipe, onDidSwipe, onDidEndSwipe, onDidCancelSwipe, enabled, lockBody, }: DSwipeSignature["Args"]["Named"]): void;
     /**
-     * Handler for swipe start event. The callback can cancel the gesture by
+     * Handler for the swipe start event. The callback can cancel the gesture by
      * calling `preventDefault()` on the event, in which case the body is not
      * locked and no further swipe events are fired for this gesture.
-     * @param {Event} event - The swipe start event.
      */
     onDidStartSwipe(event: Event): void;
-    bodyLocked: boolean;
     /**
-     * Handler for swipe end event.
-     * @param {Event} event - The swipe end event.
+     * Handler for the swipe end event.
      */
     onDidEndSwipe(event: Event): void;
     /**
-     * Handler for swipe event.
-     * @param {Event} event - The swipe event.
+     * Handler for the swipe event.
      */
     onDidSwipe(event: Event): void;
     /**
-     * Handler for swipe cancel event.
-     * @param {Event} event - The swipe cancel event.
+     * Handler for the swipe cancel event.
      */
     onDidCancelSwipe(event: Event): void;
     /**
-     * Handler for scroll event. Prevents scrolling while swiping.
-     */
-    onScroll(event: any): void;
-    /**
-     * Cleans up the swipe modifier.
+     * Handler for the scroll event. Prevents scrolling while swiping.
      */
-    cleanup(): void;
-    #private;
+    onScroll(event: Event): void;
 }
-import Modifier from "ember-modifier";
-import SwipeEvents from "discourse/lib/swipe-events";
+export {};
 //# sourceMappingURL=d-swipe.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"d-swipe.d.ts","sourceRoot":"","sources":["../../../../../discourse/app/ui-kit/modifiers/d-swipe.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;GAEG;AACH;IAGE;;;;OAIG;IACH,mBAHW,KAAK,aAMf;IAVD,UAAc;IAYd;;;;;;;;;;;OAWG;IACH,gBAVW,WAAW,KACX,GAAC,wFAET;QAA0B,eAAe;QACf,UAAU;QACV,aAAa;QACb,gBAAgB;QACjB,OAAO,EAAxB,OAAO;QACU,QAAQ,EAAzB,OAAO;KACjB,QAiCA;IAnBG,iBAAoB;IAKtB,kBAAgC;IAChC,qBAAsB;IACtB,6BAAoC;IACpC,kCAA8C;IAC9C,mCAAgD;IAChD,gCAA0C;IAE1C,0BAAiD;IASnD;;;;;OAKG;IACH,uBAFW,KAAK,QAcf;IAFG,oBAAsB;IAI1B;;;OAGG;IACH,qBAFW,KAAK,QAMf;IAED;;;OAGG;IACH,kBAFW,KAAK,QAKf;IAED;;;OAGG;IACH,wBAFW,KAAK,QAMf;IAED;;OAEG;IACH,2BAGC;IAED;;OAEG;IACH,gBAYC;;CAQF;qBAzKoB,gBAAgB;wBAGb,4BAA4B"}
+{"version":3,"file":"d-swipe.d.ts","sourceRoot":"","sources":["../../../../../discourse/app/ui-kit/modifiers/d-swipe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,QAAQ,EAAE,EAAE,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAIxD,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,aAAa,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAExC,uCAAuC;IACvC,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAEjC,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAElB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAElB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IAEf,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IAEf,sDAAsD;IACtD,KAAK,EAAE,OAAO,CAAC;IAEf,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAElB,0EAA0E;IAC1E,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAE5C,6CAA6C;IAC7C,OAAO,EAAE,WAAW,CAAC;IAErB,uDAAuD;IACvD,OAAO,EAAE,MAAM,OAAO,CAAC;IAEvB,yDAAyD;IACzD,SAAS,EAAE,MAAM,OAAO,CAAC;IAEzB,yDAAyD;IACzD,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,aAAa,EAAE,KAAK,CAAC;CACtB;AAED,UAAU,eAAe;IACvB,uDAAuD;IACvD,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE;QACJ,KAAK,EAAE;YACL;;;;eAIG;YACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;YAE5D,oEAAoE;YACpE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;YAEzC,oCAAoC;YACpC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;YAE5C,oEAAoE;YACpE,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;YAEvD,oFAAoF;YACpF,OAAO,CAAC,EAAE,OAAO,CAAC;YAElB,0FAA0F;YAC1F,QAAQ,CAAC,EAAE,OAAO,CAAC;SACpB,CAAC;QACF,UAAU,EAAE,EAAE,CAAC;KAChB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,QAAQ,CAAC,eAAe,CAAC;;IAClD,IAAI,EAAE,IAAI,CAAC;gBAYhB,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC;IAKxD;;;;;;OAMG;IACH,MAAM,CACJ,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,EAAE,EACf,EACE,eAAe,EACf,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,OAAO,EACP,QAAQ,GACT,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;IAwBrC;;;;OAIG;IAEH,eAAe,CAAC,KAAK,EAAE,KAAK;IAgB5B;;OAEG;IAEH,aAAa,CAAC,KAAK,EAAE,KAAK;IAM1B;;OAEG;IAEH,UAAU,CAAC,KAAK,EAAE,KAAK;IAKvB;;OAEG;IAEH,gBAAgB,CAAC,KAAK,EAAE,KAAK;IAM7B;;OAEG;IAEH,QAAQ,CAAC,KAAK,EAAE,KAAK;CAwBtB"}

package/declarations/app/ui-kit/modifiers/d-trap-tab.d.ts

@@ -1,15 +1,25 @@
-export default class DTrapTabModifier extends Modifier<import("ember-modifier/-private/signature").DefaultSignature> {
-    constructor(owner: any, args: any);
-    capabilities: any;
-    element: any;
-    modify(element: any, _: any, { preventScroll, autofocus }: {
-        preventScroll: any;
-        autofocus: any;
-    }): void;
-    preventScroll: any;
-    originalElement: any;
-    trapTab(event: any): void;
-    cleanup(): void;
+import type Owner from "@ember/owner";
+import Modifier, { type ArgsFor } from "ember-modifier";
+import type { CapabilitiesService } from "discourse/services/capabilities";
+interface DTrapTabSignature {
+    /** The element the tab trap is attached to. */
+    Element: HTMLElement;
+    Args: {
+        Named: {
+            /** Whether focusing an element should prevent scrolling. Defaults to `true`. */
+            preventScroll?: boolean;
+            /** Whether to focus the first focusable element on setup. Defaults to `true`. */
+            autofocus?: boolean;
+        };
+        Positional: [];
+    };
 }
-import Modifier from "ember-modifier";
+export default class DTrapTabModifier extends Modifier<DTrapTabSignature> {
+    #private;
+    capabilities: CapabilitiesService;
+    constructor(owner: Owner, args: ArgsFor<DTrapTabSignature>);
+    modify(element: HTMLElement, _positional: [], { preventScroll, autofocus }: DTrapTabSignature["Args"]["Named"]): void;
+    trapTab(event: KeyboardEvent): void;
+}
+export {};
 //# sourceMappingURL=d-trap-tab.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"d-trap-tab.d.ts","sourceRoot":"","sources":["../../../../../discourse/app/ui-kit/modifiers/d-trap-tab.js"],"names":[],"mappings":"AASA;IAKE,mCAGC;IAPD,kBAAsB;IAEtB,aAAe;IAOf;;;aAmCC;IAjCC,mBAA0C;IAC1C,qBAA8B;IAkChC,0BAgCC;IAED,gBAEC;CACF;qBA3FoB,gBAAgB"}
+{"version":3,"file":"d-trap-tab.d.ts","sourceRoot":"","sources":["../../../../../discourse/app/ui-kit/modifiers/d-trap-tab.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,QAAQ,EAAE,EAAE,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAK3E,UAAU,iBAAiB;IACzB,+CAA+C;IAC/C,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE;QACJ,KAAK,EAAE;YACL,gFAAgF;YAChF,aAAa,CAAC,EAAE,OAAO,CAAC;YAExB,iFAAiF;YACjF,SAAS,CAAC,EAAE,OAAO,CAAC;SACrB,CAAC;QACF,UAAU,EAAE,EAAE,CAAC;KAChB,CAAC;CACH;AAED,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,QAAQ,CAAC,iBAAiB,CAAC;;IACtD,YAAY,EAAE,mBAAmB,CAAC;gBAMvC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAK1D,MAAM,CACJ,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,EAAE,EACf,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;IAyClE,OAAO,CAAC,KAAK,EAAE,aAAa;CAqC7B"}

package/declarations/app/workers/media-optimization/codecs.d.ts

@@ -1,4 +1,3 @@
-export function optimize(imageData: any, fileName: any, width: any, height: any, originalFileSize: any, settings: any): Promise<ArrayBuffer>;
 export function convert(fileBuffer: any, fileName: any, fileType: any, originalFileSize: any, settings: any): Promise<{
     data: ArrayBuffer;
     outputType: string;

package/declarations/app/workers/media-optimization/codecs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codecs.d.ts","sourceRoot":"","sources":["../../../../../discourse/app/workers/media-optimization/codecs.js"],"names":[],"mappings":"AA4GA,6IAkDC;AAED;;;GA6DC;AAED;;;GA8BC"}
+{"version":3,"file":"codecs.d.ts","sourceRoot":"","sources":["../../../../../discourse/app/workers/media-optimization/codecs.js"],"names":[],"mappings":"AA0IA;;;GAgFC;AAED;;;GA8BC"}

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

@@ -1,3 +1,22 @@
+import type { TemplateOnlyComponent } from "@ember/component/template-only";
+interface DButtonTooltipSignature {
+    Element: HTMLDivElement;
+    Blocks: {
+        /** The action button, rendered first. */
+        button: [];
+        /**
+         * The tooltip trigger rendered next to the button, typically a
+         * `<DTooltip />`. It is often shown conditionally, e.g. an info icon that
+         * appears only while the button is disabled to explain why.
+         */
+        tooltip: [];
+    };
+}
+/**
+ * Lays out an action button beside a tooltip trigger so the two sit inline
+ * together, sharing a single wrapper. This keeps a button and an adjacent
+ * explanatory tooltip aligned without the caller styling the pairing itself.
+ */
+declare const DButtonTooltip: TemplateOnlyComponent<DButtonTooltipSignature>;
 export default DButtonTooltip;
-declare const DButtonTooltip: import("@ember/component/template-only").TemplateOnlyComponent<never> & (abstract new () => import("@glint/template/-private/integration").InvokableInstance<() => import("@glint/template/-private/integration").ComponentReturn<{}>> & import("@glint/template/-private/integration").HasContext<import("@glint/template/-private/integration").TemplateContext<void, {}, {}, void>>);
 //# sourceMappingURL=d-button-tooltip.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"d-button-tooltip.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-button-tooltip.gjs"],"names":[],"mappings":";AAAA,sZAqBG"}
+{"version":3,"file":"d-button-tooltip.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-button-tooltip.gts"],"names":[],"mappings":"AAAA,OA+BO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,UAAU,uBAAuB;IAC/B,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE;QACN,yCAAyC;QACzC,MAAM,EAAE,EAAE,CAAC;QAEX;;;;WAIG;QACH,OAAO,EAAE,EAAE,CAAC;KACb,CAAC;CACH;AAED;;;;GAIG;AACH,QAAA,MAAM,cAAc,EAAE,qBAAqB,CAAC,uBAAuB,CAcjE,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/declarations/float-kit/components/d-default-toast.d.ts

@@ -1,3 +1,15 @@
+import type { TemplateOnlyComponent } from "@ember/component/template-only";
+import type { ToastComponentArgs } from "discourse/float-kit/lib/constants";
+interface DDefaultToastSignature {
+    Element: HTMLDivElement;
+    Args: ToastComponentArgs;
+}
+/**
+ * The default component rendered inside a toast when the caller does not supply
+ * one. It lays out the toast's icon, title, message, and action buttons from
+ * `@data`, an optional auto-close progress bar, and a close button, applying the
+ * theme in `@data.theme` (e.g. `"success"` or `"error"`).
+ */
+declare const DDefaultToast: TemplateOnlyComponent<DDefaultToastSignature>;
 export default DDefaultToast;
-declare const DDefaultToast: import("@ember/component/template-only").TemplateOnlyComponent<never> & (abstract new () => import("@glint/template/-private/integration").InvokableInstance<() => import("@glint/template/-private/integration").ComponentReturn<{}>> & import("@glint/template/-private/integration").HasContext<import("@glint/template/-private/integration").TemplateContext<void, {}, {}, void>>);
 //# sourceMappingURL=d-default-toast.d.ts.map

package/declarations/float-kit/components/d-default-toast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"d-default-toast.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-default-toast.gjs"],"names":[],"mappings":";AA4EA,qZAgIG"}
+{"version":3,"file":"d-default-toast.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-default-toast.gts"],"names":[],"mappings":"AAAA,OAiFO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAI5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAM5E,UAAU,sBAAsB;IAC9B,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED;;;;;GAKG;AACH,QAAA,MAAM,aAAa,EAAE,qBAAqB,CAAC,sBAAsB,CAmI/D,CAAC;AAEH,eAAe,aAAa,CAAC"}

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

@@ -1,5 +1,40 @@
-export default class DFloatBody extends Component<any> {
-    constructor(owner: import("@ember/-internals/owner").default, args: any);
+import Component from "@glimmer/component";
+import type FloatKitInstance from "discourse/float-kit/lib/float-kit-instance";
+interface DFloatBodySignature {
+    Element: HTMLDivElement;
+    Args: {
+        /** The float instance this body renders. */
+        instance: FloatKitInstance;
+        /** Whether to render in place instead of into the portal outlet. */
+        inline?: boolean | null;
+        /** A class added to the outer float element. */
+        mainClass?: string;
+        /** A class added to the inner content element. */
+        innerClass?: string;
+        /** The ARIA role for the content. */
+        role?: string;
+        /** Whether to trap Tab focus within the content. */
+        trapTab?: boolean;
+        /**
+         * The element to render into. Some callers forward this even though the body
+         * reads `@instance.portalOutletElement`.
+         */
+        portalOutletElement?: HTMLElement | null;
+    };
+    Blocks: {
+        /** The float content, rendered inside the positioned element. */
+        default: [];
+    };
+}
+/**
+ * The shared content body that both menus and tooltips render through. It
+ * portals the content (see `DFloatPortal`), positions it against the trigger
+ * with floating-ui, and wires the dismissal and focus behaviors the instance
+ * asks for in its options: close on click-outside, Escape, or scroll, and a Tab
+ * focus trap. It reads all of that from `@instance`, so callers only supply the
+ * instance plus a few presentational overrides.
+ */
+export default class DFloatBody extends Component<DFloatBodySignature> {
     closeOnScroll: import("ember-modifier").FunctionBasedModifier<{
         Args: {
             Positional: unknown[];
@@ -12,15 +47,15 @@ export default class DFloatBody extends Component<any> {
             Positional: unknown[];
             Named: import("ember-modifier/-private/signature").EmptyObject;
         };
-        Element: Element;
+        Element: HTMLElement;
     }>;
-    get supportsCloseOnClickOutside(): any;
-    get supportsCloseOnEscape(): any;
-    get supportsCloseOnScroll(): any;
-    get trigger(): any;
-    get content(): any;
-    get options(): any;
+    get supportsCloseOnClickOutside(): boolean;
+    get supportsCloseOnEscape(): boolean;
+    get supportsCloseOnScroll(): boolean;
+    get trigger(): import("@floating-ui/dom").ReferenceElement;
+    get content(): HTMLElement;
+    get options(): import("../lib/constants").TooltipOptions;
     get style(): import("@ember/template").TrustedHTML;
 }
-import Component from "@glimmer/component";
+export {};
 //# sourceMappingURL=d-float-body.d.ts.map

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.gjs"],"names":[],"mappings":"AAgIA;;IACE;;;;;;OAYG;IAEH;;;;;;OAWG;IAEH,uCAEC;IAED,iCAEC;IAED,iCAEC;IAED,mBAEC;IAED,mBAEC;IAED,mBAEC;IAED,mDAOC;CAqDF;sBA5HqB,oBAAoB"}
+{"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"}

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

@@ -1,6 +1,25 @@
-export default class DFloatPortal extends Component<any> {
-    constructor(owner: import("@ember/-internals/owner").default, args: any);
-    get inline(): any;
-}
 import Component from "@glimmer/component";
+interface DFloatPortalSignature {
+    Args: {
+        /** Whether to render in place instead of into the portal outlet. */
+        inline?: boolean | null;
+        /** The element to render into, instead of the default portal outlet. */
+        portalOutletElement?: HTMLElement | null;
+    };
+    Blocks: {
+        /** The content to render in place or teleport into the portal outlet. */
+        default: [];
+    };
+}
+/**
+ * The lowest-level teleport primitive shared by every float. It either renders
+ * its content in place or moves it (via `{{in-element}}`) into a portal outlet
+ * mounted near the document root, so the content escapes any `overflow` clipping
+ * or stacking context of its trigger. Rendering is forced in place under tests,
+ * where there is no portal outlet to teleport into.
+ */
+export default class DFloatPortal extends Component<DFloatPortalSignature> {
+    get inline(): boolean;
+}
+export {};
 //# sourceMappingURL=d-float-portal.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"d-float-portal.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-float-portal.gjs"],"names":[],"mappings":"AAqBA;;IACE,kBAEC;CAiBF;sBAvBqB,oBAAoB"}
+{"version":3,"file":"d-float-portal.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-float-portal.gts"],"names":[],"mappings":"AAAA,OAuCO,SAAS,MAAM,oBAAoB,CAAC;AAG3C,UAAU,qBAAqB;IAC7B,IAAI,EAAE;QACJ,oEAAoE;QACpE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAExB,wEAAwE;QACxE,mBAAmB,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;KAC1C,CAAC;IACF,MAAM,EAAE;QACN,yEAAyE;QACzE,OAAO,EAAE,EAAE,CAAC;KACb,CAAC;CACH;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,SAAS,CAAC,qBAAqB,CAAC;IACxE,IAAI,MAAM,YAET;CAiBF"}

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

@@ -1,3 +1,20 @@
+import type { TemplateOnlyComponent } from "@ember/component/template-only";
+import type DMenuInstance from "discourse/float-kit/lib/d-menu-instance";
+interface DHeadlessMenuSignature {
+    Args: {
+        /** The menu instance to render. */
+        menu: DMenuInstance;
+        /** Whether to render in place instead of into the portal outlet. */
+        inline?: boolean | null;
+    };
+}
+/**
+ * Renders a menu instance created through the `menu` service, whose trigger
+ * lives elsewhere in the DOM rather than being owned by this component. It is
+ * mounted once by `DMenus` at the app root, which iterates every registered
+ * menu with a detached trigger. Compare `DMenu`, the declarative component that
+ * owns both its trigger and its instance.
+ */
+declare const DHeadlessMenu: TemplateOnlyComponent<DHeadlessMenuSignature>;
 export default DHeadlessMenu;
-declare const DHeadlessMenu: import("@ember/component/template-only").TemplateOnlyComponent<never> & (abstract new () => import("@glint/template/-private/integration").InvokableInstance<() => import("@glint/template/-private/integration").ComponentReturn<{}>> & import("@glint/template/-private/integration").HasContext<import("@glint/template/-private/integration").TemplateContext<void, {}, {}, void>>);
 //# sourceMappingURL=d-headless-menu.d.ts.map

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.gjs"],"names":[],"mappings":";AAgBA,qZAWG"}
+{"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"}

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

@@ -1,3 +1,20 @@
+import type { TemplateOnlyComponent } from "@ember/component/template-only";
+import type DTooltipInstance from "discourse/float-kit/lib/d-tooltip-instance";
+interface DHeadlessTooltipSignature {
+    Args: {
+        /** The tooltip instance to render. */
+        tooltip: DTooltipInstance;
+        /** Whether to render in place instead of into the portal outlet. */
+        inline?: boolean | null;
+    };
+}
+/**
+ * Renders a tooltip instance created through the `tooltip` service, whose
+ * trigger lives elsewhere in the DOM rather than being owned by this component.
+ * It is mounted once by `DTooltips` at the app root, which iterates every
+ * registered tooltip with a detached trigger. Compare `DTooltip`, the
+ * declarative component that owns both its trigger and its instance.
+ */
+declare const DHeadlessTooltip: TemplateOnlyComponent<DHeadlessTooltipSignature>;
 export default DHeadlessTooltip;
-declare const DHeadlessTooltip: import("@ember/component/template-only").TemplateOnlyComponent<never> & (abstract new () => import("@glint/template/-private/integration").InvokableInstance<() => import("@glint/template/-private/integration").ComponentReturn<{}>> & import("@glint/template/-private/integration").HasContext<import("@glint/template/-private/integration").TemplateContext<void, {}, {}, void>>);
 //# sourceMappingURL=d-headless-tooltip.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"d-headless-tooltip.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-headless-tooltip.gjs"],"names":[],"mappings":";AAkBA,wZAWG"}
+{"version":3,"file":"d-headless-tooltip.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/components/d-headless-tooltip.gts"],"names":[],"mappings":"AAAA,OAmCO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,OAAO,KAAK,gBAAgB,MAAM,4CAA4C,CAAC;AAG/E,UAAU,yBAAyB;IACjC,IAAI,EAAE;QACJ,sCAAsC;QACtC,OAAO,EAAE,gBAAgB,CAAC;QAE1B,oEAAoE;QACpE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;KACzB,CAAC;CACH;AAED;;;;;;GAMG;AACH,QAAA,MAAM,gBAAgB,EAAE,qBAAqB,CAAC,yBAAyB,CAYrE,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

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

@@ -1,6 +1,33 @@
-export default class DInlineFloat extends Component<any> {
-    constructor(owner: import("@ember/-internals/owner").default, args: any);
-    site: any;
-}
 import Component from "@glimmer/component";
+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;
+        /** A class added to the outer float element. */
+        mainClass?: string;
+        /** A class added to the inner content element. */
+        innerClass?: string;
+        /** The ARIA role for the content. */
+        role?: string;
+        /** Whether to render in place instead of into the portal outlet. */
+        inline?: boolean | null;
+    };
+}
+/**
+ * Renders an already-created float instance, choosing how to present it: a
+ * full-screen modal on mobile when the instance opts into `modalForMobile`, and
+ * otherwise the standard positioned body (see `DFloatBody`). It only renders
+ * while the instance is expanded. This is the render path for floats created
+ * through the service API, whose trigger lives elsewhere (see `DHeadlessMenu`
+ * and `DHeadlessTooltip`); the declarative components render their own body
+ * inline instead.
+ */
+export default class DInlineFloat extends Component<DInlineFloatSignature> {
+    site: Site;
+}
+export {};
 //# 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.gjs"],"names":[],"mappings":"AAgEA;;IACE,UAAc;CA0Df;sBAnEqB,oBAAoB"}
+{"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"}

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

@@ -1,35 +1,99 @@
-export default class DMenu extends Component<any> {
-    constructor(owner: import("@ember/owner").default, args: any);
-    site: any;
+import Component from "@glimmer/component";
+import { type ComponentLike } from "@glint/template";
+import { type FloatCallback, 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;
+    /** Opens the menu. */
+    show: FloatCallback;
+    /** The `@data` passed to the menu. */
+    data?: Data;
+}
+type DMenuOptionArgs<Data> = Partial<Omit<MenuOptions, "data" | "component" | "onRegisterApi">> & {
+    /** The data passed to the content block and rendered component. */
+    data?: Data;
+    /** A component rendered as the content; it receives the `@data` and `@close` arguments. */
+    component?: ComponentLike<{
+        Args: {
+            data?: Data;
+            close?: FloatCallback;
+        };
+    }>;
+    /** Called with the menu instance when it is created, so callers can control it programmatically. */
+    onRegisterApi?: (instance: DMenuInstance) => void;
+};
+interface DMenuSignature<Data = unknown> {
+    Element: HTMLElement;
+    Args: DMenuOptionArgs<Data> & {
+        /** Called on keydown on the default trigger button. */
+        onKeydown?: (event: KeyboardEvent) => unknown;
+        /** A component rendered as the trigger, instead of the default button. */
+        triggerComponent?: ComponentLike;
+        /** The icon ID for the default trigger button. */
+        icon?: string;
+        /** The label for the default trigger button. */
+        label?: string;
+        /** The aria-label for the default trigger button. */
+        ariaLabel?: string;
+        /** The title for the default trigger button. */
+        title?: string;
+        /** Whether the default trigger button is disabled. */
+        disabled?: boolean;
+        /** Whether the default trigger button shows a loading state. */
+        isLoading?: boolean;
+    };
+    Blocks: {
+        /** The menu content; takes precedence over the `content` block. Yields the menu api. */
+        default: [DMenuComponentArgs<Data>];
+        /** Rendered as the trigger, replacing the default button. Yields the menu api. */
+        trigger: [DMenuComponentArgs<Data>];
+        /** The menu content, used when no default block is given. Yields the menu api. */
+        content: [DMenuComponentArgs<Data>];
+    };
+}
+/**
+ * The declarative menu component: it renders a trigger (the default button, a
+ * supplied `triggerComponent`, or a `trigger` block) and, while open, the menu
+ * content in a positioned float. It creates and owns its own `DMenuInstance`,
+ * populating the instance options from its arguments, so a template can drop in
+ * a menu without touching the `menu` service. For a menu whose trigger is
+ * managed separately through that service, see `DHeadlessMenu`.
+ */
+export default class DMenu<Data = unknown> extends Component<DMenuSignature<Data>> {
+    #private;
+    site: Site;
     menuInstance: DMenuInstance;
     registerTrigger: import("ember-modifier").FunctionBasedModifier<{
         Args: {
             Positional: unknown[];
             Named: import("ember-modifier/-private/signature").EmptyObject;
         };
-        Element: Element;
+        Element: HTMLElement;
     }>;
     registerFloatBody: import("ember-modifier").FunctionBasedModifier<{
         Args: {
             Positional: unknown[];
             Named: import("ember-modifier/-private/signature").EmptyObject;
         };
-        Element: Element;
+        Element: HTMLElement;
     }>;
-    body: Element;
     teardownFloatBody(): void;
-    forwardTabToContent(event: any): any;
-    get options(): {};
-    get componentArgs(): {
-        close: (options?: {
-            focusTrigger: boolean;
-        }, ...args: any[]) => Promise<void>;
-        show: (...args: any[]) => Promise<void>;
-        data: any;
-    };
-    get triggerComponent(): any;
-    get allowedProperties(): {};
+    forwardTabToContent(event: KeyboardEvent): unknown;
+    get options(): MenuOptions;
+    get componentArgs(): DMenuComponentArgs<Data>;
+    get triggerComponent(): ComponentLike<{
+        Element: HTMLElement;
+        Args: {
+            componentArgs?: DMenuComponentArgs<Data>;
+        };
+        Blocks: {
+            default: [];
+        };
+    }>;
+    get allowedProperties(): Record<string, unknown>;
 }
-import Component from "@glimmer/component";
-import DMenuInstance from "discourse/float-kit/lib/d-menu-instance";
+export {};
 //# sourceMappingURL=d-menu.d.ts.map