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

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

@@ -1,132 +1,223 @@
-export const FLOAT_UI_PLACEMENTS: string[];
-export namespace VISIBILITY_OPTIMIZERS {
-    let FLIP: string;
-    let AUTO_PLACEMENT: string;
-    let NONE: string;
+import type { AutoUpdateOptions, ReferenceElement } from "@floating-ui/dom";
+import { type ComponentLike } from "@glint/template";
+/**
+ * The placements floating-ui may position a float at, ordered by preference. Kept
+ * `as const` so consumers can derive the exact string-literal union (see
+ * `FloatUiPlacement`) instead of a loose `string`.
+ */
+export declare const FLOAT_UI_PLACEMENTS: readonly ["top", "top-start", "top-end", "right", "right-start", "right-end", "bottom", "bottom-start", "bottom-end", "left", "left-start", "left-end"];
+/**
+ * The strategies that keep a float on screen when its preferred placement would
+ * overflow. `FLIP` flips to the opposite side, `AUTO_PLACEMENT` picks the best fit,
+ * and `NONE` disables the optimizer entirely.
+ */
+export declare const VISIBILITY_OPTIMIZERS: {
+    readonly FLIP: "flip";
+    readonly AUTO_PLACEMENT: "autoPlacement";
+    readonly NONE: "none";
+};
+/**
+ * The reference a float is anchored to: either a real element or a virtual one — any
+ * object implementing `getBoundingClientRect` (floating-ui's `ReferenceElement`). The
+ * listener and focus code only runs against real elements (see `triggerElement`).
+ */
+export type FloatKitTrigger = ReferenceElement;
+/** One of the placements in `FLOAT_UI_PLACEMENTS`. */
+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];
+/**
+ * A relayed lifecycle or trigger callback (`onShow`, `onClose`, `beforeTrigger`, …).
+ * These are handed straight to consumers that pass functions of varying arity and
+ * return type, so the signature is deliberately broad-but-real: it accepts any
+ * function, still documents intent, and type-checks the internal call — unlike the
+ * bare `Function` type (which yields an unchecked `any` and trips lint).
+ */
+export type FloatCallback = (...args: any[]) => void;
+/**
+ * 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.
+ */
+export type FloatTriggers = string[] | {
+    mobile: string[];
+    desktop: string[];
+};
+/**
+ * The full set of options shared by menus and tooltips, after a consumer's partial
+ * options have been merged over the defaults below. This is the source of truth for
+ * the corresponding component arguments; every field is always present on an
+ * instance because the defaults populate it.
+ */
+export interface TooltipOptions {
+    /** Whether to animate the float as it opens and closes. */
+    animated: boolean;
+    /** Whether to render a directional arrow pointing at the trigger. */
+    arrow: boolean;
+    /** Read by the shared float body to decide whether to focus it; menus set it, tooltips leave it unset. */
+    autofocus?: boolean;
+    /** Read by the shared inline float to render as a modal on mobile; menus set it, tooltips leave it unset. */
+    modalForMobile?: boolean;
+    /** Called just before the float is shown. */
+    beforeTrigger: FloatCallback | null;
+    /** Whether a click outside the float closes it. */
+    closeOnClickOutside: boolean;
+    /** Whether pressing Escape closes the float. */
+    closeOnEscape: boolean;
+    /** Whether scrolling closes the float. */
+    closeOnScroll: boolean;
+    /** A component rendered as the content; it receives the `@data` and `@close` arguments. */
+    component: ComponentLike<{
+        Args: {
+            data?: unknown;
+            close?: FloatCallback;
+        };
+    }> | null;
+    /** The content rendered when neither a block nor a `component` is provided. */
+    content: string | null;
+    /**
+     * Sets a `data-identifier` attribute on both the trigger and the content. Several
+     * floats may share an identifier, but only one per identifier is open at a time.
+     */
+    identifier: string | null;
+    /** Improves positioning for a trigger that spans multiple lines. */
+    inline: boolean | null;
+    /** Whether the content stays open while the pointer moves into it, so it can be interacted with. */
+    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;
+    /** Passed as the `@data` argument to a `component` rendered as the content. */
+    data: unknown;
+    /** Displaces the content from its trigger, in pixels. */
+    offset: number;
+    /** The events that open the float. */
+    triggers: FloatTriggers;
+    /** The events that close the float. */
+    untriggers: FloatTriggers;
+    /** The preferred placement of the float relative to its trigger. */
+    placement: FloatUiPlacement;
+    /** Whether to shift the float into view before running the visibility optimizer, rather than after. */
+    shiftBeforeVisibilityOptimizer: boolean;
+    /** The strategy that keeps the float on screen when its preferred placement would overflow. */
+    visibilityOptimizer: VisibilityOptimizer;
+    /** The placements to try, in order, when the preferred one does not fit. */
+    fallbackPlacements: readonly FloatUiPlacement[];
+    /** Whether to reposition automatically as the trigger or viewport changes; an object passes floating-ui `autoUpdate` options. */
+    autoUpdate: boolean | AutoUpdateOptions;
+    /** Whether to trap Tab focus within the content. */
+    trapTab: boolean;
+    /** Called after the float closes. */
+    onClose: FloatCallback | null;
+    /** Called after the float shows. */
+    onShow: 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;
 }
-export namespace TOOLTIP {
-    namespace options {
-        export let animated: boolean;
-        export let arrow: boolean;
-        export let beforeTrigger: any;
-        export let closeOnClickOutside: boolean;
-        export let closeOnEscape: boolean;
-        export let closeOnScroll: boolean;
-        export let component: any;
-        export let content: any;
-        export let identifier: any;
-        export let inline: any;
-        export let interactive: boolean;
-        export let listeners: boolean;
-        export let maxWidth: number;
-        export let data: any;
-        export let offset: number;
-        export namespace triggers {
-            let mobile: string[];
-            let desktop: string[];
-        }
-        export namespace untriggers {
-            let mobile_1: string[];
-            export { mobile_1 as mobile };
-            let desktop_1: string[];
-            export { desktop_1 as desktop };
-        }
-        export let placement: string;
-        export let shiftBeforeVisibilityOptimizer: boolean;
-        import visibilityOptimizer = VISIBILITY_OPTIMIZERS.FLIP;
-        export { visibilityOptimizer };
-        export { FLOAT_UI_PLACEMENTS as fallbackPlacements };
-        export let autoUpdate: boolean;
-        export let trapTab: boolean;
-        export let onClose: any;
-        export let onShow: any;
-        export let onRegisterApi: any;
-        export let portalOutletElement: any;
-    }
-    let portalOutletId: string;
+/**
+ * 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 menu template forwards to its trigger and content).
+ */
+export interface MenuOptions extends TooltipOptions {
+    /** Whether to focus the content when the menu opens. */
+    autofocus: boolean;
+    /** Whether the menu renders as a modal on mobile. */
+    modalForMobile: boolean;
+    /** Only one menu per group identifier is open at a time. */
+    groupIdentifier: string | null;
+    /** The identifier of the parent menu, for nested menus. */
+    parentIdentifier: string | null;
+    /** A class added to the trigger. */
+    triggerClass: string | null;
+    /** A class added to the content. */
+    contentClass: string | null;
+    /** A class added to both the trigger and the content. */
+    class: string | null;
+    /** Whether to set the content's min-width to the trigger's width. */
+    matchTriggerMinWidth: boolean;
+    /** Whether to set the content's width to the trigger's width. */
+    matchTriggerWidth: boolean;
 }
-export namespace MENU {
-    export namespace options_1 {
-        let animated_1: boolean;
-        export { animated_1 as animated };
-        let arrow_1: boolean;
-        export { arrow_1 as arrow };
-        export let autofocus: boolean;
-        let beforeTrigger_1: any;
-        export { beforeTrigger_1 as beforeTrigger };
-        let closeOnEscape_1: boolean;
-        export { closeOnEscape_1 as closeOnEscape };
-        let closeOnClickOutside_1: boolean;
-        export { closeOnClickOutside_1 as closeOnClickOutside };
-        let closeOnScroll_1: boolean;
-        export { closeOnScroll_1 as closeOnScroll };
-        let component_1: any;
-        export { component_1 as component };
-        let content_1: any;
-        export { content_1 as content };
-        let identifier_1: any;
-        export { identifier_1 as identifier };
-        let interactive_1: boolean;
-        export { interactive_1 as interactive };
-        let listeners_1: boolean;
-        export { listeners_1 as listeners };
-        let maxWidth_1: number;
-        export { maxWidth_1 as maxWidth };
-        let data_1: any;
-        export { data_1 as data };
-        let offset_1: number;
-        export { offset_1 as offset };
-        let triggers_1: string[];
-        export { triggers_1 as triggers };
-        let untriggers_1: string[];
-        export { untriggers_1 as untriggers };
-        let placement_1: string;
-        export { placement_1 as placement };
-        let shiftBeforeVisibilityOptimizer_1: boolean;
-        export { shiftBeforeVisibilityOptimizer_1 as shiftBeforeVisibilityOptimizer };
-        import visibilityOptimizer_1 = VISIBILITY_OPTIMIZERS.FLIP;
-        export { visibilityOptimizer_1 as visibilityOptimizer };
-        export { FLOAT_UI_PLACEMENTS as fallbackPlacements };
-        let autoUpdate_1: boolean;
-        export { autoUpdate_1 as autoUpdate };
-        let trapTab_1: boolean;
-        export { trapTab_1 as trapTab };
-        let onClose_1: any;
-        export { onClose_1 as onClose };
-        let onShow_1: any;
-        export { onShow_1 as onShow };
-        let onRegisterApi_1: any;
-        export { onRegisterApi_1 as onRegisterApi };
-        export let modalForMobile: boolean;
-        let inline_1: any;
-        export { inline_1 as inline };
-        export let groupIdentifier: any;
-        export let parentIdentifier: any;
-        export let triggerClass: any;
-        export let contentClass: any;
-        let _class: any;
-        export { _class as class };
-        export let matchTriggerMinWidth: boolean;
-        export let matchTriggerWidth: boolean;
-        let portalOutletElement_1: any;
-        export { portalOutletElement_1 as portalOutletElement };
-    }
-    export { options_1 as options };
-    let portalOutletId_1: string;
-    export { portalOutletId_1 as portalOutletId };
+/** One action button rendered by the default toast. */
+export interface ToastAction {
+    /** Called when the button is clicked, receiving the toast data and a close function. */
+    action?: (args: {
+        data?: ToastData;
+        close?: FloatCallback;
+    }) => void;
+    /** The icon ID for the button. */
+    icon?: string;
+    /** The label for the button. */
+    label?: string;
+    /** A class added to the button. */
+    class?: string;
 }
-export namespace TOAST {
-    export namespace options_2 {
-        export let autoClose: boolean;
-        export namespace autoUpdate_2 {
-            let ancestorScroll: boolean;
-        }
-        export { autoUpdate_2 as autoUpdate };
-        export let duration: string;
-        export { DDefaultToast as component };
-        export let showProgressBar: boolean;
-        export let views: string[];
-    }
-    export { options_2 as options };
+/**
+ * The `@data` passed to a toast component. The default toast reads these fields;
+ * custom components may add their own (hence the index signature).
+ */
+export interface ToastData {
+    /** A theme name applied to the toast (e.g. `"success"`, `"error"`). */
+    theme?: string;
+    /** The icon ID shown in the toast. */
+    icon?: string;
+    /** The toast title. */
+    title?: string;
+    /** The toast message. */
+    message?: string;
+    /** Whether `message` is trusted HTML rather than plain text. */
+    isHtmlMessage?: boolean;
+    /** The action buttons shown in the toast. */
+    actions?: ToastAction[];
+    [key: string]: unknown;
 }
+/** The arguments a toast component receives (the default is `DDefaultToast`). */
+export interface ToastComponentArgs {
+    /** The data to render in the toast. */
+    data?: ToastData;
+    /** Closes the toast. */
+    close?: FloatCallback;
+    /** Whether to show a progress bar counting down to auto-close. */
+    showProgressBar?: boolean;
+    /** Registers the progress-bar element so the auto-close modifier can animate it. */
+    onRegisterProgressBar?: (element: HTMLElement) => void;
+}
+/** The signature of a toast component (the default is `DDefaultToast`). */
+export type ToastComponent = ComponentLike<{
+    Element: HTMLElement;
+    Args: ToastComponentArgs;
+}>;
+/** The options for a toast, after merging over the defaults below. */
+export interface ToastOptions {
+    /** Whether the toast closes automatically after `duration`. */
+    autoClose: boolean;
+    /** Whether to reposition automatically; an object passes floating-ui `autoUpdate` options. */
+    autoUpdate: boolean | AutoUpdateOptions;
+    /** How long the toast stays open: a preset (`"short"`/`"long"`) or a number of milliseconds. */
+    duration: "short" | "long" | number;
+    /** The component rendered as the toast body. */
+    component: ToastComponent;
+    /** Whether to show a progress bar counting down to auto-close. */
+    showProgressBar: boolean;
+    /** The viewports the toast is shown on. */
+    views: Array<"desktop" | "mobile">;
+    /** The `@data` passed to the toast component. */
+    data?: ToastData;
+    /** A class added to the toast element. */
+    class?: string;
+}
+export declare const TOOLTIP: {
+    options: TooltipOptions;
+    portalOutletId: string;
+};
+export declare const MENU: {
+    options: MenuOptions;
+    portalOutletId: string;
+};
+export declare const TOAST: {
+    options: ToastOptions;
+};
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/lib/constants.js"],"names":[],"mappings":"AAAA,2CAaE"}
+{"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,75 +1,50 @@
+import Owner from "@ember/owner";
+import { 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.
+ */
 export default class DMenuInstance extends FloatKitInstance {
-    constructor(owner: any, options?: {}, ...args: any[]);
-    menu: any;
-    modal: any;
-    /**
-     * Indicates whether the menu is expanded or not.
-     * @property {boolean} expanded - Tracks the state of menu expansion, initially set to false.
-     */
+    menu: MenuService;
+    site: Site;
+    modal: ModalService;
+    /** Whether the menu is currently open. */
     expanded: boolean;
     /**
-     * Specifies whether the trigger for opening/closing the menu is detached from the menu itself.
-     * This is the case when a menu is trigger programmatically instead of through the <DMenu /> component.
-     * @property {boolean} detachedTrigger - Tracks whether the trigger is detached, initially set to false.
+     * 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
+     * trigger and content live in separate parts of the DOM and are rendered by
+     * `DHeadlessMenu` rather than by `DMenu`.
      */
     detachedTrigger: boolean;
     /**
-     * Configuration options for the DMenuInstance.
-     * @property {Object} options - Options object that configures the menu behavior and display.
+     * The merged menu options: the defaults from `MENU.options` with the caller's
+     * overrides applied in the constructor.
      */
-    options: {
-        animated: boolean;
-        arrow: boolean;
-        autofocus: boolean;
-        beforeTrigger: any;
-        closeOnEscape: boolean;
-        closeOnClickOutside: boolean;
-        closeOnScroll: boolean;
-        component: any;
-        content: any;
-        identifier: any;
-        interactive: boolean;
-        listeners: boolean;
-        maxWidth: number;
-        data: any;
-        offset: number;
-        triggers: string[];
-        untriggers: string[];
-        placement: string;
-        shiftBeforeVisibilityOptimizer: boolean;
-        visibilityOptimizer: string;
-        fallbackPlacements: string[];
-        autoUpdate: boolean;
-        trapTab: boolean;
-        onClose: any;
-        onShow: any;
-        onRegisterApi: any;
-        modalForMobile: boolean;
-        inline: any;
-        groupIdentifier: any;
-        parentIdentifier: any;
-        triggerClass: any;
-        contentClass: any;
-        class: any;
-        matchTriggerMinWidth: boolean;
-        matchTriggerWidth: boolean;
-        portalOutletElement: any;
-    };
-    portalOutletOverrideElement: any;
-    _trigger: any;
-    get portalOutletElement(): any;
-    set trigger(element: any);
-    get trigger(): any;
+    options: MenuOptions;
+    portalOutletOverrideElement?: HTMLElement | null;
+    _trigger: FloatKitTrigger;
+    constructor(owner: Owner, options?: Partial<MenuOptions>);
+    get portalOutletElement(): HTMLElement;
+    get trigger(): FloatKitTrigger;
+    set trigger(element: FloatKitTrigger);
+    get shouldTrapPointerDown(): boolean;
     close(options?: {
         focusTrigger: boolean;
-    }, ...args: any[]): Promise<void>;
-    show(...args: any[]): Promise<void>;
-    onPointerMove(event: any): Promise<void>;
-    onClick(event: any): Promise<void>;
-    onPointerLeave(event: any): Promise<void>;
-    onTrigger(event: any): Promise<void>;
-    onUntrigger(event: any): Promise<void>;
+    }): Promise<void>;
+    show(): Promise<void>;
+    onPointerMove(event: PointerEvent): Promise<void>;
+    onClick(event: MouseEvent): Promise<void>;
+    onPointerLeave(event: PointerEvent): Promise<void>;
+    onTrigger(event: Event): Promise<void>;
+    onUntrigger(event: Event): Promise<void>;
     destroy(): void;
 }
-import FloatKitInstance from "discourse/float-kit/lib/float-kit-instance";
 //# sourceMappingURL=d-menu-instance.d.ts.map

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.js"],"names":[],"mappings":"AAUA;IA2BE,sDAMC;IAhCD,UAAc;IAEd,WAAe;IAEf;;;OAGG;IACH,kBAA0B;IAE1B;;;;OAIG;IACH,yBAAiC;IAEjC;;;OAGG;IACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAiB;IACjB,iCAAqC;IAErC,cAAkB;IAUlB,+BAKC;IAMD,0BAIC;IARD,mBAEC;IAYD;;sCAqBC;IAED,oCAIC;IAED,yCAOC;IAED,mCAcC;IAED,0CAKC;IAED,qCAMC;IAED,uCAKC;IAED,gBAIC;CACF;6BA5I4B,4CAA4C"}
+{"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"}

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

@@ -1,10 +1,20 @@
+import Owner from "@ember/owner";
+import { type ToastOptions } from "discourse/float-kit/lib/constants";
+import type ToastsService from "discourse/float-kit/services/toasts";
+import type Site from "discourse/models/site";
+/**
+ * The instance backing a single toast: its merged options and a stable id used
+ * to track and dismiss it. Unlike a menu or tooltip a toast has no trigger — it
+ * is shown imperatively through the `toasts` service — so this does not extend
+ * `FloatKitInstance`.
+ */
 export default class DToastInstance {
-    constructor(owner: any, options?: {});
-    site: any;
-    toasts: any;
-    options: any;
+    site: Site;
+    toasts: ToastsService;
+    options: ToastOptions;
     id: any;
+    constructor(owner: Owner, options?: Partial<ToastOptions>);
     close(): void;
-    get isValidForView(): any;
+    get isValidForView(): boolean;
 }
 //# sourceMappingURL=d-toast-instance.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"d-toast-instance.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/lib/d-toast-instance.js"],"names":[],"mappings":"AAMA;IAOE,sCAGC;IATD,UAAc;IACd,YAAgB;IAEhB,aAAe;IACf,QAAiB;IAOjB,cAGC;IAED,0BAIC;CACF"}
+{"version":3,"file":"d-toast-instance.d.ts","sourceRoot":"","sources":["../../../../discourse/float-kit/lib/d-toast-instance.ts"],"names":[],"mappings":"AACA,OAAO,KAAmB,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,aAAa,MAAM,qCAAqC,CAAC;AACrE,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAG9C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,aAAa,CAAC;IAEvC,OAAO,EAAE,YAAY,CAAC;IACtB,EAAE,MAAe;gBAEL,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM;IAM7D,KAAK;IAIL,IAAI,cAAc,YAIjB;CACF"}

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

@@ -1,69 +1,41 @@
+import Owner from "@ember/owner";
+import { type FloatKitTrigger, type TooltipOptions } from "discourse/float-kit/lib/constants";
+import FloatKitInstance from "discourse/float-kit/lib/float-kit-instance";
+import type TooltipService from "discourse/float-kit/services/tooltip";
+/**
+ * The concrete float instance backing a tooltip. It holds the tooltip's options,
+ * open/close state, and portal outlet, and implements the trigger and lifecycle
+ * hooks that `FloatKitInstance` orchestrates.
+ */
 export default class DTooltipInstance extends FloatKitInstance {
-    constructor(owner: any, options?: {}, ...args: any[]);
-    tooltip: any;
-    /**
-     * Indicates whether the tooltip is expanded or not.
-     * @property {boolean} expanded - Tracks the state of tooltip expansion, initially set to false.
-     */
+    tooltip: TooltipService;
+    /** Whether the tooltip is currently open. */
     expanded: boolean;
     /**
-     * Specifies whether the trigger for opening/closing the tooltip is detached from the tooltip itself.
-     * This is the case when a tooltip is trigger programmatically instead of through the <DTooltip /> component.
-     * @property {boolean} detachedTrigger - Tracks whether the trigger is detached, initially set to false.
+     * Whether the tooltip's trigger is managed outside the `<DTooltip />`
+     * component. It is set when the tooltip is created through the `tooltip`
+     * service, where the trigger and content live in separate parts of the DOM
+     * and are rendered by `DHeadlessTooltip` rather than by `DTooltip`.
      */
     detachedTrigger: boolean;
     /**
-     * Configuration options for the DTooltipInstance.
-     * @property {Object} options - Options object that configures the tooltip behavior and display.
+     * The merged tooltip options: the defaults from `TOOLTIP.options` with the
+     * caller's overrides applied in the constructor.
      */
-    options: {
-        animated: boolean;
-        arrow: boolean;
-        beforeTrigger: any;
-        closeOnClickOutside: boolean;
-        closeOnEscape: boolean;
-        closeOnScroll: boolean;
-        component: any;
-        content: any;
-        identifier: any;
-        inline: any;
-        interactive: boolean;
-        listeners: boolean;
-        maxWidth: number;
-        data: any;
-        offset: number;
-        triggers: {
-            mobile: string[];
-            desktop: string[];
-        };
-        untriggers: {
-            mobile: string[];
-            desktop: string[];
-        };
-        placement: string;
-        shiftBeforeVisibilityOptimizer: boolean;
-        visibilityOptimizer: string;
-        fallbackPlacements: string[];
-        autoUpdate: boolean;
-        trapTab: boolean;
-        onClose: any;
-        onShow: any;
-        onRegisterApi: any;
-        portalOutletElement: any;
-    };
-    portalOutletOverrideElement: any;
-    _trigger: any;
-    set trigger(element: any);
-    get trigger(): any;
-    get portalOutletElement(): any;
-    show(...args: any[]): Promise<void>;
-    close(...args: any[]): Promise<void>;
-    onPointerMove(event: any): Promise<void>;
-    onClick(event: any): Promise<void>;
-    onPointerLeave(event: any): Promise<void>;
-    onTrigger(): Promise<void>;
-    onUntrigger(): Promise<void>;
+    options: TooltipOptions;
+    portalOutletOverrideElement?: HTMLElement | null;
+    _trigger: FloatKitTrigger;
+    constructor(owner: Owner, options?: Partial<TooltipOptions>);
+    get trigger(): FloatKitTrigger;
+    set trigger(element: FloatKitTrigger);
+    get portalOutletElement(): HTMLElement;
+    show(): Promise<void>;
+    close(): Promise<void>;
+    onPointerMove(event: PointerEvent): Promise<void>;
+    onClick(event: MouseEvent): Promise<void>;
+    onPointerLeave(event: PointerEvent): Promise<void>;
+    onTrigger(_event?: Event): Promise<void>;
+    onUntrigger(_event?: Event): Promise<void>;
     destroy(): void;
 }
-import FloatKitInstance from "discourse/float-kit/lib/float-kit-instance";
 //# sourceMappingURL=d-tooltip-instance.d.ts.map

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.js"],"names":[],"mappings":"AASA;IAyBE,sDAMC;IA9BD,aAAiB;IAEjB;;;OAGG;IACH,kBAA0B;IAE1B;;;;OAIG;IACH,yBAAiC;IAEjC;;;OAGG;IACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAiB;IACjB,iCAAqC;IAErC,cAAkB;IAclB,0BAIC;IARD,mBAEC;IAQD,+BAKC;IAED,oCAIC;IAED,qCAMC;IAED,yCAWC;IAED,mCAcC;IAED,0CAKC;IAED,2BAIC;IAED,6BAGC;IAED,gBAIC;CACF;6BAtH4B,4CAA4C"}
+{"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"}