@progress/kendo-react-tooltip 13.3.0 → 13.4.0-develop.2

package/package-metadata.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { PackageMetadata } from '@progress/kendo-licensing';
+/**
+ * @hidden
+ */
+export declare const packageMetadata: PackageMetadata;

package/package-metadata.mjs

@@ -0,0 +1,13 @@
+// Generated file. DO NOT EDIT.
+/**
+ * @hidden
+ */
+export const packageMetadata = Object.freeze({
+    name: '@progress/kendo-react-tooltip',
+    productName: 'KendoReact',
+    productCode: 'KENDOUIREACT',
+    productCodes: ['KENDOUIREACT'],
+    publishDate: 0,
+    version: '13.4.0-develop.2',
+    licensingDocsUrl: 'https://www.telerik.com/kendo-react-ui/components/my-license/'
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-react-tooltip",
-  "version": "13.3.0",
+  "version": "13.4.0-develop.2",
   "description": "React Tooltips library represents popups with information that is related to a UI element. KendoReact Tooltips package",
   "author": "Progress",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -26,8 +26,8 @@
   "sideEffects": false,
   "peerDependencies": {
     "@progress/kendo-licensing": "^1.7.2",
-    "@progress/kendo-react-common": "13.3.0",
-    "@progress/kendo-react-popup": "13.3.0",
+    "@progress/kendo-react-common": "13.4.0-develop.2",
+    "@progress/kendo-react-popup": "13.4.0-develop.2",
     "@progress/kendo-svg-icons": "^4.0.0",
     "react": "^16.8.2 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc",
     "react-dom": "^16.8.2 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc"
@@ -52,7 +52,13 @@
   ],
   "@progress": {
     "friendlyName": "Tooltip",
-    "framework": "KendoReact"
+    "framework": "KendoReact",
+    "package": {
+      "productName": "KendoReact",
+      "productCode": "KENDOUIREACT",
+      "publishDate": 1770288261,
+      "licensingDocsUrl": "https://www.telerik.com/kendo-react-ui/components/my-license/"
+    }
   },
   "repository": {
     "type": "git",

package/popover/Popover.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { PopoverProps } from './interfaces/PopoverProps.js';
+import * as React from 'react';
+/**
+ * Represents the Object which is passed to the [`ref`](https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom) callback of the Popover component.
+ */
+export interface PopoverHandle {
+    /**
+     * The props of the Popover.
+     */
+    props: PopoverProps;
+}
+/**
+ * Represents the Popover component.
+ */
+export declare const Popover: React.ForwardRefExoticComponent<PopoverProps & React.RefAttributes<PopoverHandle | null>>;

package/popover/PopoverActionsBar.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { PopoverActionsBarProps } from './interfaces/PopoverActionsBarProps.js';
+import * as React from 'react';
+/**
+ * Represents the Object which is passed to the [`ref`](https://react.dev/learn/referencing-values-with-refs#refs-and-the-dom) callback of the PopoverActionBar component.
+ */
+export interface PopoverActionsBarHandle {
+    /**
+     * The props of the PopoverActionsBar.
+     */
+    props: PopoverActionsBarProps;
+    /**
+     * The current element or `null` if there is none.
+     */
+    element: HTMLDivElement | null;
+}
+/**
+ * Represents the PopoverActionsBar component.
+ */
+export declare const PopoverActionsBar: React.ForwardRefExoticComponent<PopoverActionsBarProps & React.RefAttributes<PopoverActionsBarHandle | null>>;

package/popover/interfaces/Align.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { Align as AlignBase } from '@progress/kendo-react-popup';
+/**
+ * Defines the horizontal and vertical aligning point of the Popup.
+ */
+export interface Align extends AlignBase {
+    /**
+     * Defines the possible horizontal point values that are relative to the anchor or the Popup.
+     *
+     * The available options are:
+     * - `left`—Uses the leftmost point of the anchor element.
+     * - `center`—Uses the center point of the anchor element.
+     * - `right`—Uses the rightmost point of the anchor element.
+     */
+    horizontal: 'left' | 'center' | 'right';
+    /**
+     * Defines the possible vertical point values that are relative to the anchor or the Popup.
+     *
+     * The available options are:
+     * - `top`—Uses the top point of the anchor element.
+     * - `center`—Uses the center point of the anchor element.
+     * - `bottom`—Uses the bottom point of the anchor element.
+     */
+    vertical: 'top' | 'center' | 'bottom';
+}

package/popover/interfaces/PopoverActionsBarProps.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Represents the props of the [KendoReact PopoverActionsBar](https://www.telerik.com/kendo-react-ui/components/tooltip/api/popoveractionsbar) component.
+ */
+export interface PopoverActionsBarProps {
+    /**
+     * Sets the horizontal alignment of the PopoverActionsBar buttons.
+     *
+     * The possible values are:
+     * * `start`
+     * * `center`
+     * * `end`
+     * * `stretched` (default)
+     */
+    alignment?: string;
+    /**
+     * Sets the orientation of the PopoverActionsBar buttons.
+     *
+     * The possible values are:
+     * * `horizontal` (default)
+     * * `vertical`
+     */
+    orientation?: string;
+    /**
+     * @hidden
+     */
+    children?: React.ReactNode;
+}

package/popover/interfaces/PopoverAnimation.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { PopupAnimation } from '@progress/kendo-react-popup';
+/**
+ * The animation settings of the Popover.
+ */
+export type PopoverAnimation = PopupAnimation;

package/popover/interfaces/PopoverCloseEvent.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { PopoverHandle } from '../Popover.js';
+/**
+ * Represents the object of the `Close` Popover event.
+ */
+export interface PopoverCloseEvent {
+    /**
+     * An event target.
+     */
+    target: PopoverHandle;
+}

package/popover/interfaces/PopoverCollision.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { PopoverCollisionType } from './PopoverCollisionType.js';
+/**
+ * Defines the horizontal and vertical collision behavior of the Popover.
+ */
+export interface PopoverCollision {
+    /**
+     * Defines the horizontal collision behavior of the Popover.
+     */
+    horizontal: PopoverCollisionType;
+    /**
+     * Defines the vertical collision behavior of the Popover.
+     */
+    vertical: PopoverCollisionType;
+}

package/popover/interfaces/PopoverCollisionType.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { CollisionType as CollisionTypeBase } from '@progress/kendo-react-popup';
+/**
+ * Defines the possible collision behavior when the Popover is not fully visible.
+ *
+ * The available options are:
+ * - `fit`—Moves the Popover horizontally until it is fully displayed in the viewport.
+ * - `flip`—Flips the Popover position based on the origin and the position properties.
+ * - `none`—The Popover is rendered at its original position. Usable when the Popover is focused on open and the page is scrolled to it.
+ */
+export type PopoverCollisionType = CollisionTypeBase;

package/popover/interfaces/PopoverKeyDownEvent.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { PopoverHandle } from '../Popover.js';
+/**
+ * Represents the object of the `KeyDown` Popover event.
+ */
+export interface PopoverKeyDownEvent {
+    /**
+     * An event target.
+     */
+    target: PopoverHandle;
+    /**
+     * A boolean value that indicates whether the Popover is visible.
+     */
+    show?: boolean;
+}

package/popover/interfaces/PopoverMargin.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { Margin as MarginBase } from '@progress/kendo-react-popup';
+/**
+ * Defines the horizontal and the vertical margin offset of the component.
+ */
+export interface PopoverMargin extends MarginBase {
+    /**
+     * Defines the possible horizontal margin value.
+     */
+    horizontal: number;
+    /**
+     * Defines the possible vertical margin value.
+     */
+    vertical: number;
+}

package/popover/interfaces/PopoverOffset.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { Offset as OffsetBase } from '@progress/kendo-react-popup';
+/**
+ * The offset position of the Popover.
+ */
+export interface PopoverOffset extends OffsetBase {
+    /**
+     * Defines the top position of the Popover.
+     */
+    top: number;
+    /**
+     * Defines the left position of the Popover.
+     */
+    left: number;
+}

package/popover/interfaces/PopoverOpenEvent.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { PopoverHandle } from '../Popover.js';
+/**
+ * Represents the object of the `Open` Popover event.
+ */
+export interface PopoverOpenEvent {
+    /**
+     * An event target.
+     */
+    target: PopoverHandle;
+}

package/popover/interfaces/PopoverPosition.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The position of the Popover.
+ * The available options are:
+ * - `top`
+ * - `left`
+ * - `bottom`
+ * - `right`
+ */
+export type PopoverPosition = 'top' | 'left' | 'bottom' | 'right';

package/popover/interfaces/PopoverPositionEvent.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { PopoverHandle } from '../Popover.js';
+/**
+ * Represents the object of the `Position` Popover event.
+ */
+export interface PopoverPositionEvent {
+    /**
+     * An event target.
+     */
+    target: PopoverHandle;
+    /**
+     * Indicates if the position is fitted.
+     */
+    fitted: boolean;
+    /**
+     * Indicates if the position is flipped.
+     */
+    flipped: boolean;
+}

package/popover/interfaces/PopoverPositionMode.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { PositionMode as PositionModeBase } from '@progress/kendo-react-popup';
+/**
+ * The type which defines all possible position modes of the Popover.
+ */
+export type PopoverPositionMode = PositionModeBase;

package/popover/interfaces/PopoverProps.d.ts

@@ -0,0 +1,258 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { PopoverCollision } from './PopoverCollision.js';
+import { PopoverMargin } from './PopoverMargin.js';
+import { PopoverOffset } from './PopoverOffset.js';
+import { PopoverOpenEvent } from './PopoverOpenEvent.js';
+import { PopoverCloseEvent } from './PopoverCloseEvent.js';
+import { PopoverAnimation } from './PopoverAnimation.js';
+import { PopoverPosition } from './PopoverPosition.js';
+import { PopoverPositionEvent } from './PopoverPositionEvent.js';
+import { PopoverPositionMode } from './PopoverPositionMode.js';
+import { PopoverKeyDownEvent } from './PopoverKeyDownEvent.js';
+export interface PopoverProps {
+    /**
+     * Set the focus the Popover container automatically when mounted.
+     *
+     * @default true
+     *
+     * @example
+     * ```jsx
+     * <Popover autoFocus={false} />
+     * ```
+     */
+    autoFocus?: boolean;
+    /**
+     * Specifies the title of the Popover component.
+     * Can be a string or JSX content.
+     *
+     * @example
+     * ```jsx
+     * <Popover title="Popover Title" />
+     * ```
+     */
+    title?: React.ReactNode;
+    /**
+     * Specifies the position of the Popover relative to the anchor or offset.
+     * Accepts predefined position values.
+     *
+     * @default "top"
+     *
+     * @example
+     * ```jsx
+     * <Popover position="top" />
+     * ```
+     */
+    position?: PopoverPosition;
+    /**
+     * Controls the visibility of the Popover callout (arrow).
+     * If set to `false`, the callout will not be rendered.
+     *
+     * @default true
+     *
+     * @example
+     * ```jsx
+     * <Popover callout={false} />
+     * ```
+     */
+    callout?: boolean;
+    /**
+     * Configures the animation behavior of the Popover.
+     * Accepts a boolean or a configuration object.
+     *
+     * @example
+     * ```jsx
+     * <Popover animate={true} />
+     * ```
+     */
+    animate?: boolean | PopoverAnimation;
+    /**
+     * Specifies the element to be used as the anchor for the Popover.
+     * The Popover opens relative to this element.
+     *
+     * @example
+     * ```jsx
+     * <Popover anchor={document.getElementById('anchor')} />
+     * ```
+     */
+    anchor?: HTMLElement | null;
+    /**
+     * Defines the container to which the Popover will be appended.
+     * Defaults to [`body`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/body).
+     * If set to `null`, the Popover will not use React Portal.
+     *
+     * @example
+     * ```jsx
+     * <Popover appendTo={document.getElementById('container')} />
+     * ```
+     */
+    appendTo?: HTMLElement | null;
+    /**
+     * Configures the collision behavior of the Popover.
+     * Determines how the Popover adjusts its position when it overflows the viewport.
+     *
+     * @example
+     * ```jsx
+     * <Popover collision={{ horizontal: 'fit', vertical: 'flip' }} />
+     * ```
+     */
+    collision?: PopoverCollision;
+    /**
+     * Specifies the margin in pixels between the Popover and the anchor element.
+     * Automatically set based on the `position` property if not specified.
+     *
+     * @example
+     * ```jsx
+     * <Popover margin={{ top: 10, left: 5 }} />
+     * ```
+     */
+    margin?: PopoverMargin;
+    /**
+     * Specifies the positioning mode of the Popover.
+     * Defaults to `fixed`. Use `absolute` for mobile browser support with zoom.
+     *
+     * @default "fixed"
+     *
+     * @example
+     * ```jsx
+     * <Popover positionMode="absolute" />
+     * ```
+     */
+    positionMode?: PopoverPositionMode;
+    /**
+     * Specifies the document scale when using a [scale transform](https://developer.mozilla.org/en-US/docs/Web/CSS/transform-function/scale).
+     * Required for accurate positioning when scaling is applied.
+     *
+     * @example
+     * ```jsx
+     * <Popover scale={1.5} />
+     * ```
+     */
+    scale?: number;
+    /**
+     * Specifies the absolute position of the Popover.
+     * The Popover opens relative to this point.
+     *
+     * @example
+     * ```jsx
+     * <Popover offset={{ top: 100, left: 200 }} />
+     * ```
+     */
+    offset?: PopoverOffset;
+    /**
+     * Specifies additional CSS classes for the animated Popover element.
+     *
+     * @example
+     * ```jsx
+     * <Popover popoverClass="custom-popover-class" />
+     * ```
+     */
+    popoverClass?: string | Array<string> | {
+        [key: string]: boolean;
+    };
+    /**
+     * Specifies additional CSS classes for the Popover element.
+     *
+     * @example
+     * ```jsx
+     * <Popover className="custom-class" />
+     * ```
+     */
+    className?: string | Array<string>;
+    /**
+     * Specifies the `id` attribute for the Popover element.
+     *
+     * @example
+     * ```jsx
+     * <Popover id="popover-id" />
+     * ```
+     */
+    id?: string;
+    /**
+     * Specifies the styles applied to the Popover element.
+     *
+     * @example
+     * ```jsx
+     * <Popover style={{ backgroundColor: 'blue' }} />
+     * ```
+     */
+    style?: React.CSSProperties;
+    /**
+     * Specifies the styles applied to the content element of the Popover.
+     *
+     * @example
+     * ```jsx
+     * <Popover contentStyle={{ padding: '10px' }} />
+     * ```
+     */
+    contentStyle?: React.CSSProperties;
+    /**
+     * Controls the visibility of the Popover.
+     * Defaults to `false`.
+     *
+     * @default false
+     *
+     * @example
+     * ```jsx
+     * <Popover show={true} />
+     * ```
+     */
+    show?: boolean;
+    /**
+     * Fires after the Popover is opened and the opening animation ends.
+     * Provides the event details.
+     *
+     * @example
+     * ```jsx
+     * <Popover onOpen={(event) => console.log('Popover opened', event)} />
+     * ```
+     */
+    onOpen?: (event: PopoverOpenEvent) => void;
+    /**
+     * Fires after the Popover is closed.
+     * Provides the event details.
+     *
+     * @example
+     * ```jsx
+     * <Popover onClose={(event) => console.log('Popover closed', event)} />
+     * ```
+     */
+    onClose?: (event: PopoverCloseEvent) => void;
+    /**
+     * Fires after the Popover position is calculated and set.
+     * Provides the event details.
+     *
+     * @example
+     * ```jsx
+     * <Popover onPosition={(event) => console.log('Popover positioned', event)} />
+     * ```
+     */
+    onPosition?: (event: PopoverPositionEvent) => void;
+    /**
+     * Fires when the Popover is focused and a key is pressed.
+     * Provides the event details.
+     *
+     * @example
+     * ```jsx
+     * <Popover onKeyDown={(event) => console.log('Key pressed', event)} />
+     * ```
+     */
+    onKeyDown?: (event: PopoverKeyDownEvent) => void;
+    /**
+     * Specifies the children elements of the Popover.
+     * Used to define the content of the Popover.
+     *
+     * @example
+     * ```jsx
+     * <Popover>
+     *   <div>Popover Content</div>
+     * </Popover>
+     * ```
+     */
+    children?: React.ReactNode;
+}

package/popover/utils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * @hidden
+ */
+export declare const getFirstFocusableElement: (element: HTMLElement) => HTMLElement | undefined;
+/**
+ * @hidden
+ */
+export declare const getLastFocusableElement: (element: HTMLElement) => HTMLElement | undefined;
+/**
+ * @hidden
+ */
+export declare const handleFocusTrap: (e: KeyboardEvent) => void;