ng-primitives 0.121.0 → 0.122.0

package/package.json

@@ -2,7 +2,7 @@
   "name": "ng-primitives",
   "description": "Angular Primitives is a low-level headless UI component library with a focus on accessibility, customization, and developer experience. ",
   "license": "Apache-2.0",
-  "version": "0.121.0",
+  "version": "0.122.0",
   "keywords": [
     "angular",
     "primitives",

package/types/ng-primitives-combobox.d.ts

@@ -290,7 +290,17 @@ declare class NgpCombobox {
         reset: ({ scroll, origin }?: ng_primitives_a11y.ActivationOptions) => void;
         validate: () => void;
     };
-    /** The control status */
+    /**
+     * The form control status of the combobox host element itself. When the combobox is used as a
+     * form control (e.g. via a `ControlValueAccessor` wrapper) the `NgControl` lives on an ancestor
+     * element, so this resolves it even when there is no `ngpComboboxInput`.
+     */
+    private readonly hostControlStatus;
+    /**
+     * The control status. When an input is present it can resolve the associated `NgControl` (whether
+     * the control is on the input itself or an ancestor), so we use its status. Otherwise we fall back
+     * to the combobox host's own control status so an input-less combobox still reflects validity.
+     */
     protected readonly controlStatus: _angular_core.Signal<ng_primitives_utils.NgpControlStatus | undefined>;
     /** The state of the combobox. */
     protected readonly state: ng_primitives_state.CreatedState<NgpCombobox>;

package/types/ng-primitives-context-menu.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { Provider, Signal } from '@angular/core';
+import { Provider, Signal, WritableSignal } from '@angular/core';
 import { NgpOffset, NgpFlip, NgpShift, NgpOverlayContent, NgpOffsetInput, NgpFlipInput, NgpShiftInput } from 'ng-primitives/portal';
 import { FocusOrigin } from '@angular/cdk/a11y';
 import { BooleanInput } from '@angular/cdk/coercion';
@@ -222,6 +222,11 @@ interface NgpContextMenuTriggerState {
      * The focus origin that was used to open the menu.
      */
     readonly openOrigin: Signal<FocusOrigin>;
+    /**
+     * The container in which the menu should be attached.
+     * @default document.body
+     */
+    readonly container: WritableSignal<HTMLElement | string | null>;
     /**
      * Show the context menu.
      */
@@ -230,6 +235,12 @@ interface NgpContextMenuTriggerState {
      * Hide the context menu.
      */
     hide(origin?: FocusOrigin): void;
+    /**
+     * Set the container in which the menu should be attached. Takes effect the
+     * next time the menu is opened; it does not move a menu that is already open.
+     * @param container - The new container
+     */
+    setContainer(container: HTMLElement | string | null): void;
     /**
      * Set whether the pointer is over the menu content.
      */
@@ -269,11 +280,13 @@ interface NgpContextMenuTriggerProps<T = unknown> {
      */
     readonly context?: Signal<T>;
 }
-declare const ngpContextMenuTrigger: <T>({ disabled: _disabled, menu: _menu, offset: _offset, flip: _flip, context: _context, container, scrollBehavior, shift, }: NgpContextMenuTriggerProps<T>) => {
+declare const ngpContextMenuTrigger: <T>({ disabled: _disabled, menu: _menu, offset: _offset, flip: _flip, context: _context, container: _container, scrollBehavior, shift, }: NgpContextMenuTriggerProps<T>) => {
     open: Signal<boolean>;
-    openOrigin: _angular_core.WritableSignal<FocusOrigin>;
+    openOrigin: WritableSignal<FocusOrigin>;
+    container: WritableSignal<string | HTMLElement | null>;
     show: (origin?: FocusOrigin) => void;
     hide: (origin?: FocusOrigin) => void;
+    setContainer: (newContainer: HTMLElement | string | null) => void;
     setPointerOverContent: (_isOver: boolean) => void;
 };
 declare const provideContextMenuTriggerState: (opts?: {

package/types/ng-primitives-menu.d.ts

@@ -393,6 +393,11 @@ interface NgpMenuTriggerState<T = unknown> {
      * Whether the menu should flip when there is not enough space.
      */
     readonly flip: WritableSignal<NgpFlip>;
+    /**
+     * The container in which the menu should be attached.
+     * @default document.body
+     */
+    readonly container: WritableSignal<HTMLElement | string | null>;
     /**
      * The context provided to the menu.
      */
@@ -427,6 +432,12 @@ interface NgpMenuTriggerState<T = unknown> {
      * @param context - The new context
      */
     setContext(context: T): void;
+    /**
+     * Set the container in which the menu should be attached. Takes effect the
+     * next time the menu is opened; it does not move a menu that is already open.
+     * @param container - The new container
+     */
+    setContainer(container: HTMLElement | string | null): void;
     /**
      * Show the menu.
      * @param origin - The focus origin
@@ -526,10 +537,12 @@ declare const NgpMenuTriggerStateToken: _angular_core.InjectionToken<WritableSig
     setPlacement: (newPlacement: NgpMenuPlacement) => void;
     setOffset: (newOffset: NgpOffset) => void;
     setContext: (newContext: unknown) => void;
+    setContainer: (newContainer: HTMLElement | string | null) => void;
     setPointerOverContent: (isOver: boolean) => void;
     flip: WritableSignal<NgpFlip>;
+    container: WritableSignal<string | HTMLElement | null>;
 }>>;
-declare const ngpMenuTrigger: <T>({ disabled: _disabled, menu: _menu, placement: _placement, offset: _offset, flip: _flip, shift: _shift, context: _context, container, scrollBehavior, cooldown, triggers, showDelay, hideDelay, }: NgpMenuTriggerProps<T>) => {
+declare const ngpMenuTrigger: <T>({ disabled: _disabled, menu: _menu, placement: _placement, offset: _offset, flip: _flip, shift: _shift, context: _context, container: _container, scrollBehavior, cooldown, triggers, showDelay, hideDelay, }: NgpMenuTriggerProps<T>) => {
     menu: WritableSignal<NgpOverlayContent<T> | undefined>;
     placement: WritableSignal<NgpMenuPlacement>;
     offset: WritableSignal<NgpOffset>;
@@ -546,8 +559,10 @@ declare const ngpMenuTrigger: <T>({ disabled: _disabled, menu: _menu, placement:
     setPlacement: (newPlacement: NgpMenuPlacement) => void;
     setOffset: (newOffset: NgpOffset) => void;
     setContext: (newContext: T) => void;
+    setContainer: (newContainer: HTMLElement | string | null) => void;
     setPointerOverContent: (isOver: boolean) => void;
     flip: WritableSignal<NgpFlip>;
+    container: WritableSignal<string | HTMLElement | null>;
 };
 declare const provideMenuTriggerState: (opts?: {
     inherit?: boolean;

package/types/ng-primitives-navigation-menu.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, Provider, Signal } from '@angular/core';
+import { InjectionToken, Provider, Signal, WritableSignal } from '@angular/core';
 import { Placement } from '@floating-ui/dom';
 import { NgpOrientation } from 'ng-primitives/common';
 import { NgpOffset, NgpFlip, NgpShift, NgpOverlayContent, NgpOffsetInput, NgpFlipInput, NgpShiftInput } from 'ng-primitives/portal';
@@ -635,7 +635,7 @@ interface NgpNavigationMenuTriggerState {
     /**
      * The container for the content.
      */
-    readonly container: Signal<HTMLElement | string | null>;
+    readonly container: WritableSignal<HTMLElement | string | null>;
     /**
      * Whether the content is currently open.
      */
@@ -670,6 +670,13 @@ interface NgpNavigationMenuTriggerState {
      * @param id The content ID
      */
     setContentId(id: string): void;
+    /**
+     * Set the container in which the content should be attached. Takes effect the
+     * next time the content is opened; it does not move content that is already
+     * open.
+     * @param container The new container
+     */
+    setContainer(container: HTMLElement | string | null): void;
     /**
      * Update pointer over content state.
      * @param isOver Whether pointer is over content
@@ -721,14 +728,14 @@ interface NgpNavigationMenuTriggerProps {
      */
     readonly cooldown?: Signal<number>;
 }
-declare const NgpNavigationMenuTriggerStateToken: _angular_core.InjectionToken<_angular_core.WritableSignal<{
+declare const NgpNavigationMenuTriggerStateToken: _angular_core.InjectionToken<WritableSignal<{
     content: Signal<NgpOverlayContent<unknown> | undefined>;
     disabled: Signal<boolean>;
     placement: Signal<Placement>;
     offset: Signal<NgpOffset>;
     flip: Signal<NgpFlip>;
     shift: Signal<NgpShift>;
-    container: Signal<string | HTMLElement | null>;
+    container: WritableSignal<string | HTMLElement | null>;
     open: Signal<boolean>;
     id: string;
     contentId: Signal<string | undefined>;
@@ -737,6 +744,7 @@ declare const NgpNavigationMenuTriggerStateToken: _angular_core.InjectionToken<_
     focusFirstContentItem: (retryCount?: number) => void;
     focusLastContentItem: (retryCount?: number) => void;
     setContentId: (newId: string) => void;
+    setContainer: (newContainer: HTMLElement | string | null) => void;
     setPointerOverContent: (isOver: boolean) => void;
     setFocusInsideContent: (isFocused: boolean) => void;
     registerContentFocusFunctions: (focusFirst: () => void, focusLast: () => void) => void;
@@ -748,7 +756,7 @@ declare const ngpNavigationMenuTrigger: ({ content: _content, disabled: _disable
     offset: Signal<NgpOffset>;
     flip: Signal<NgpFlip>;
     shift: Signal<NgpShift>;
-    container: Signal<string | HTMLElement | null>;
+    container: WritableSignal<string | HTMLElement | null>;
     open: Signal<boolean>;
     id: string;
     contentId: Signal<string | undefined>;
@@ -757,6 +765,7 @@ declare const ngpNavigationMenuTrigger: ({ content: _content, disabled: _disable
     focusFirstContentItem: (retryCount?: number) => void;
     focusLastContentItem: (retryCount?: number) => void;
     setContentId: (newId: string) => void;
+    setContainer: (newContainer: HTMLElement | string | null) => void;
     setPointerOverContent: (isOver: boolean) => void;
     setFocusInsideContent: (isFocused: boolean) => void;
     registerContentFocusFunctions: (focusFirst: () => void, focusLast: () => void) => void;
@@ -769,7 +778,7 @@ declare const injectNavigationMenuTriggerState: {
         offset: Signal<NgpOffset>;
         flip: Signal<NgpFlip>;
         shift: Signal<NgpShift>;
-        container: Signal<string | HTMLElement | null>;
+        container: WritableSignal<string | HTMLElement | null>;
         open: Signal<boolean>;
         id: string;
         contentId: Signal<string | undefined>;
@@ -778,6 +787,7 @@ declare const injectNavigationMenuTriggerState: {
         focusFirstContentItem: (retryCount?: number) => void;
         focusLastContentItem: (retryCount?: number) => void;
         setContentId: (newId: string) => void;
+        setContainer: (newContainer: HTMLElement | string | null) => void;
         setPointerOverContent: (isOver: boolean) => void;
         setFocusInsideContent: (isFocused: boolean) => void;
         registerContentFocusFunctions: (focusFirst: () => void, focusLast: () => void) => void;
@@ -789,7 +799,7 @@ declare const injectNavigationMenuTriggerState: {
         offset: Signal<NgpOffset>;
         flip: Signal<NgpFlip>;
         shift: Signal<NgpShift>;
-        container: Signal<string | HTMLElement | null>;
+        container: WritableSignal<string | HTMLElement | null>;
         open: Signal<boolean>;
         id: string;
         contentId: Signal<string | undefined>;
@@ -798,6 +808,7 @@ declare const injectNavigationMenuTriggerState: {
         focusFirstContentItem: (retryCount?: number) => void;
         focusLastContentItem: (retryCount?: number) => void;
         setContentId: (newId: string) => void;
+        setContainer: (newContainer: HTMLElement | string | null) => void;
         setPointerOverContent: (isOver: boolean) => void;
         setFocusInsideContent: (isFocused: boolean) => void;
         registerContentFocusFunctions: (focusFirst: () => void, focusLast: () => void) => void;
@@ -809,7 +820,7 @@ declare const injectNavigationMenuTriggerState: {
         offset: Signal<NgpOffset>;
         flip: Signal<NgpFlip>;
         shift: Signal<NgpShift>;
-        container: Signal<string | HTMLElement | null>;
+        container: WritableSignal<string | HTMLElement | null>;
         open: Signal<boolean>;
         id: string;
         contentId: Signal<string | undefined>;
@@ -818,6 +829,7 @@ declare const injectNavigationMenuTriggerState: {
         focusFirstContentItem: (retryCount?: number) => void;
         focusLastContentItem: (retryCount?: number) => void;
         setContentId: (newId: string) => void;
+        setContainer: (newContainer: HTMLElement | string | null) => void;
         setPointerOverContent: (isOver: boolean) => void;
         setFocusInsideContent: (isFocused: boolean) => void;
         registerContentFocusFunctions: (focusFirst: () => void, focusLast: () => void) => void;
@@ -828,7 +840,7 @@ declare const injectNavigationMenuTriggerState: {
         offset: Signal<NgpOffset>;
         flip: Signal<NgpFlip>;
         shift: Signal<NgpShift>;
-        container: Signal<string | HTMLElement | null>;
+        container: WritableSignal<string | HTMLElement | null>;
         open: Signal<boolean>;
         id: string;
         contentId: Signal<string | undefined>;
@@ -837,6 +849,7 @@ declare const injectNavigationMenuTriggerState: {
         focusFirstContentItem: (retryCount?: number) => void;
         focusLastContentItem: (retryCount?: number) => void;
         setContentId: (newId: string) => void;
+        setContainer: (newContainer: HTMLElement | string | null) => void;
         setPointerOverContent: (isOver: boolean) => void;
         setFocusInsideContent: (isFocused: boolean) => void;
         registerContentFocusFunctions: (focusFirst: () => void, focusLast: () => void) => void;

package/types/ng-primitives-popover.d.ts

@@ -159,7 +159,7 @@ interface NgpPopoverTriggerState<T> {
      * Define the container in which the popover should be attached.
      * @default document.body
      */
-    readonly container: Signal<HTMLElement | string | null>;
+    readonly container: WritableSignal<HTMLElement | string | null>;
     /**
      * Define whether the popover should close when clicking outside of it, or a guard function.
      * @default true
@@ -209,6 +209,13 @@ interface NgpPopoverTriggerState<T> {
     readonly open: Signal<boolean>;
     /** @internal onDestroy callback */
     destroy: () => void;
+    /**
+     * Set the container in which the popover should be attached. Takes effect the
+     * next time the popover is opened; it does not move a popover that is already
+     * open.
+     * @param container - The new container
+     */
+    setContainer: (container: HTMLElement | string | null) => void;
     /**
      * Show the popover.
      * @returns A promise that resolves when the popover has been shown
@@ -308,7 +315,7 @@ interface NgpPopoverTriggerProps<T> {
     readonly onOpenChange?: (value: boolean) => void;
 }
 declare const NgpPopoverTriggerStateToken: _angular_core.InjectionToken<WritableSignal<NgpPopoverTriggerState<unknown>>>;
-declare const ngpPopoverTrigger: <T>({ popover: _popover, disabled, placement, offset, showDelay, hideDelay, flip, shift, container, closeOnOutsideClick, closeOnEscape, scrollBehavior, context, anchor, trackPosition, cooldown, onOpenChange, }: NgpPopoverTriggerProps<T>) => NgpPopoverTriggerState<T>;
+declare const ngpPopoverTrigger: <T>({ popover: _popover, disabled, placement, offset, showDelay, hideDelay, flip, shift, container: _container, closeOnOutsideClick, closeOnEscape, scrollBehavior, context, anchor, trackPosition, cooldown, onOpenChange, }: NgpPopoverTriggerProps<T>) => NgpPopoverTriggerState<T>;
 declare const providePopoverTriggerState: (opts?: {
     inherit?: boolean;
 }) => _angular_core.FactoryProvider;

package/types/ng-primitives-select.d.ts

@@ -229,7 +229,7 @@ interface NgpSelectState<T> {
     /** The position of the dropdown. */
     readonly placement: Signal<Placement>;
     /** The container for the dropdown. */
-    readonly container: Signal<HTMLElement | string | null>;
+    readonly container: WritableSignal<HTMLElement | string | null>;
     /** Whether the dropdown should flip when there is not enough space. Can be a boolean to enable/disable, or an object with padding and fallbackPlacements options. */
     readonly flip: Signal<NgpFlip>;
     /**
@@ -381,6 +381,13 @@ interface NgpSelectState<T> {
      * `setDisabledState` integration.
      */
     setDisabled(disabled: boolean): void;
+    /**
+     * Set the container in which the dropdown should be attached. Takes effect the
+     * next time the dropdown is opened; it does not move a dropdown that is already
+     * open.
+     * @param container - The new container
+     */
+    setContainer(container: HTMLElement | string | null): void;
     /**
      * Observable that emits whenever the value changes.
      */
@@ -427,7 +434,7 @@ interface NgpSelectProps<T> {
     readonly allOptions?: Signal<T[] | undefined>;
 }
 declare const NgpSelectStateToken: _angular_core.InjectionToken<WritableSignal<NgpSelectState<unknown>>>;
-declare const ngpSelect: <T>({ id, value: _value, multiple, disabled: _disabled, compareWith, placement, container, flip, offset, scrollToOption, allOptions, onValueChange, onOpenChange, }: NgpSelectProps<T>) => NgpSelectState<T>;
+declare const ngpSelect: <T>({ id, value: _value, multiple, disabled: _disabled, compareWith, placement, container: _container, flip, offset, scrollToOption, allOptions, onValueChange, onOpenChange, }: NgpSelectProps<T>) => NgpSelectState<T>;
 declare const provideSelectState: (opts?: {
     inherit?: boolean;
 }) => _angular_core.FactoryProvider;

package/types/ng-primitives-toast.d.ts

@@ -48,6 +48,7 @@ interface NgpToastOptions$1 {
 declare class NgpToast {
     private readonly manager;
     private readonly injector;
+    private readonly elementRef;
     protected readonly config: ng_primitives_toast.NgpToastConfig;
     /** @internal */
     readonly options: NgpToastOptions$1;
@@ -108,9 +109,9 @@ declare class NgpToast {
      */
     private readonly timer;
     constructor();
-    protected onPointerDown(event: PointerEvent): void;
-    protected onPointerMove(event: PointerEvent): void;
-    protected onPointerUp(): void;
+    private onPointerDown;
+    private onPointerMove;
+    private onPointerUp;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgpToast, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgpToast, "[ngpToast]", ["ngpToast"], {}, {}, never, never, true, never>;
 }

package/types/ng-primitives-tooltip.d.ts

@@ -124,7 +124,7 @@ interface NgpTooltipTriggerState<T> {
     /** Access the tooltip template ref. */
     readonly tooltip: WritableSignal<NgpOverlayContent<T> | string | null>;
     /**
-     * Define if the trigger should be disabled. This will prevent the tooltip from being shown or hidden from interactions.
+     * Whether the tooltip is disabled. This allows the tooltip to be enabled or disabled dynamically.
      * @default false
      */
     readonly disabled: Signal<boolean>;
@@ -165,7 +165,7 @@ interface NgpTooltipTriggerState<T> {
      * Define the container in which the tooltip should be attached.
      * @default document.body
      */
-    readonly container: Signal<HTMLElement | string | null>;
+    readonly container: WritableSignal<HTMLElement | string | null>;
     /**
      * Define whether the tooltip should only show when the trigger element overflows.
      * @default false
@@ -253,6 +253,13 @@ interface NgpTooltipTriggerState<T> {
      * Set the tooltip id.
      */
     setTooltipId: (id: string) => void;
+    /**
+     * Set the container in which the tooltip should be attached. Takes effect the
+     * next time the tooltip is shown; it does not move a tooltip that is already
+     * visible.
+     * @param container - The new container
+     */
+    setContainer: (container: HTMLElement | string | null) => void;
     /**
      * Called by tooltip content when pointer enters the tooltip.
      * @internal
@@ -269,7 +276,7 @@ interface NgpTooltipTriggerProps<T> {
     /** Access the tooltip template ref. */
     readonly tooltip?: Signal<NgpOverlayContent<T> | string | null>;
     /**
-     * Define if the trigger should be disabled. This will prevent the tooltip from being shown or hidden from interactions.
+     * Whether the tooltip is disabled. This allows the tooltip to be enabled or disabled dynamically.
      * @default false
      */
     readonly disabled?: Signal<boolean>;
@@ -370,7 +377,7 @@ declare const NgpTooltipTriggerStateToken: _angular_core.InjectionToken<Writable
     hideDelay: Signal<number>;
     flip: Signal<NgpFlip>;
     shift: Signal<NgpShift>;
-    container: Signal<string | HTMLElement | null>;
+    container: WritableSignal<string | HTMLElement | null>;
     showOnOverflow: Signal<boolean>;
     anchor: Signal<HTMLElement | null>;
     context: Signal<unknown>;
@@ -389,11 +396,12 @@ declare const NgpTooltipTriggerStateToken: _angular_core.InjectionToken<Writable
     show: () => void;
     hide: () => void;
     setTooltipId: (id: string) => void;
+    setContainer: (newContainer: HTMLElement | string | null) => void;
     onTooltipHoverStart: () => void;
     onTooltipHoverEnd: () => void;
     destroy: () => void;
 }>>;
-declare const ngpTooltipTrigger: <T>({ tooltip: _tooltip, disabled, placement, offset, showDelay, hideDelay, flip, shift, container, showOnOverflow, anchor, context, useTextContent, trackPosition, position, scrollBehavior, cooldown, hoverableContent, }: NgpTooltipTriggerProps<T>) => {
+declare const ngpTooltipTrigger: <T>({ tooltip: _tooltip, disabled, placement, offset, showDelay, hideDelay, flip, shift, container: _container, showOnOverflow, anchor, context, useTextContent, trackPosition, position, scrollBehavior, cooldown, hoverableContent, }: NgpTooltipTriggerProps<T>) => {
     tooltip: WritableSignal<string | NgpOverlayContent<T> | null>;
     disabled: Signal<boolean>;
     placement: Signal<NgpTooltipPlacement>;
@@ -402,7 +410,7 @@ declare const ngpTooltipTrigger: <T>({ tooltip: _tooltip, disabled, placement, o
     hideDelay: Signal<number>;
     flip: Signal<NgpFlip>;
     shift: Signal<NgpShift>;
-    container: Signal<string | HTMLElement | null>;
+    container: WritableSignal<string | HTMLElement | null>;
     showOnOverflow: Signal<boolean>;
     anchor: Signal<HTMLElement | null>;
     context: Signal<T | undefined>;
@@ -421,6 +429,7 @@ declare const ngpTooltipTrigger: <T>({ tooltip: _tooltip, disabled, placement, o
     show: () => void;
     hide: () => void;
     setTooltipId: (id: string) => void;
+    setContainer: (newContainer: HTMLElement | string | null) => void;
     onTooltipHoverStart: () => void;
     onTooltipHoverEnd: () => void;
     destroy: () => void;
@@ -445,7 +454,7 @@ declare class NgpTooltipTrigger<T = null> implements OnDestroy {
      */
     readonly tooltip: _angular_core.InputSignalWithTransform<string | NgpOverlayContent<T> | null, TooltipInput<T>>;
     /**
-     * Define if the trigger should be disabled. This will prevent the tooltip from being shown or hidden from interactions.
+     * Whether the tooltip is disabled. This allows the tooltip to be enabled or disabled dynamically.
      * @default false
      */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
@@ -545,7 +554,7 @@ declare class NgpTooltipTrigger<T = null> implements OnDestroy {
         hideDelay: _angular_core.Signal<number>;
         flip: _angular_core.Signal<NgpFlip>;
         shift: _angular_core.Signal<NgpShift>;
-        container: _angular_core.Signal<string | HTMLElement | null>;
+        container: _angular_core.WritableSignal<string | HTMLElement | null>;
         showOnOverflow: _angular_core.Signal<boolean>;
         anchor: _angular_core.Signal<HTMLElement | null>;
         context: _angular_core.Signal<T | undefined>;
@@ -564,6 +573,7 @@ declare class NgpTooltipTrigger<T = null> implements OnDestroy {
         show: () => void;
         hide: () => void;
         setTooltipId: (id: string) => void;
+        setContainer: (newContainer: HTMLElement | string | null) => void;
         onTooltipHoverStart: () => void;
         onTooltipHoverEnd: () => void;
         destroy: () => void;