datocms-react-ui 2.1.0-alpha.1 → 2.1.0-alpha.2

package/dist/esm/Tooltip/TooltipContent/index.js

@@ -0,0 +1,118 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { FloatingPortal, useDelayGroup, useDelayGroupContext, useMergeRefs, useTransitionStyles, } from '@floating-ui/react';
+import * as React from 'react';
+import { Canvas, useCtx } from '../../Canvas';
+import { getSharedPortalRoot, releaseSharedPortalRoot, useTooltipState, } from '../utils';
+import s from './styles.module.css.json';
+/**
+ * TooltipContent contains the content displayed in the floating tooltip.
+ *
+ * The content is automatically wrapped in a Canvas component to inherit the DatoCMS
+ * theme and styling. The tooltip uses a portal to render outside the normal DOM
+ * hierarchy, ensuring proper positioning and z-index stacking.
+ *
+ * @example Simple text tooltip
+ *
+ * Display plain text in a tooltip to provide helpful information:
+ *
+ * ```js
+ * <Canvas ctx={ctx}>
+ *   <Tooltip>
+ *     <TooltipTrigger>
+ *       <Button>Delete</Button>
+ *     </TooltipTrigger>
+ *     <TooltipContent>
+ *       This action cannot be undone
+ *     </TooltipContent>
+ *   </Tooltip>
+ * </Canvas>;
+ * ```
+ *
+ * @example Rich content tooltip
+ *
+ * Include formatted content with custom styles for more detailed information:
+ *
+ * ```js
+ * <Canvas ctx={ctx}>
+ *   <Tooltip placement="right">
+ *     <TooltipTrigger>
+ *       <Button leftIcon={<HelpIcon />}>Help</Button>
+ *     </TooltipTrigger>
+ *     <TooltipContent>
+ *       <div>
+ *         <strong>Need assistance?</strong>
+ *         <p style={{ margin: '5px 0 0 0', fontSize: 'var(--font-size-xs)' }}>
+ *           Contact support@example.com
+ *         </p>
+ *       </div>
+ *     </TooltipContent>
+ *   </Tooltip>
+ * </Canvas>;
+ * ```
+ *
+ * @example Tooltip with keyboard shortcut
+ *
+ * Combine tooltips with the HotKey component to show keyboard shortcuts:
+ *
+ * ```js
+ * <Canvas ctx={ctx}>
+ *   <Tooltip>
+ *     <TooltipTrigger>
+ *       <Button leftIcon={<SaveIcon />}>Save</Button>
+ *     </TooltipTrigger>
+ *     <TooltipContent>
+ *       <HotKey hotkey="mod+s" label="Save changes" />
+ *     </TooltipContent>
+ *   </Tooltip>
+ * </Canvas>;
+ * ```
+ */
+export var TooltipContent = React.forwardRef(function TooltipContent(_a, propRef) {
+    var children = _a.children;
+    var ctx = useCtx();
+    var state = useTooltipState();
+    var _b = useDelayGroupContext(), isInstantPhase = _b.isInstantPhase, currentId = _b.currentId;
+    var ref = useMergeRefs([state.refs.setFloating, propRef]);
+    // Use the shared portal root
+    var portalRootRef = React.useRef(null);
+    React.useEffect(function () {
+        // Get the shared portal root and increment ref count
+        portalRootRef.current = getSharedPortalRoot();
+        // Cleanup function to release the shared portal root
+        return function () {
+            releaseSharedPortalRoot();
+        };
+    }, []);
+    useDelayGroup(state.context, { id: state.context.floatingId });
+    var instantDuration = 0;
+    var duration = 250;
+    var _c = useTransitionStyles(state.context, {
+        duration: isInstantPhase
+            ? {
+                open: instantDuration,
+                // `id` is this component's `id`
+                // `currentId` is the current group's `id`
+                close: currentId === state.context.floatingId ? duration : instantDuration,
+            }
+            : duration,
+        initial: {
+            opacity: 0,
+        },
+    }), isMounted = _c.isMounted, styles = _c.styles;
+    if (!isMounted)
+        return null;
+    return (React.createElement(FloatingPortal, { root: portalRootRef },
+        React.createElement(Canvas, { ctx: ctx, noAutoResizer: true },
+            React.createElement("div", __assign({ ref: ref, style: __assign(__assign({}, state.floatingStyles), styles) }, state.getFloatingProps(), { className: s.tooltip }), children))));
+});
+//# sourceMappingURL=index.js.map

package/dist/esm/Tooltip/TooltipContent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Tooltip/TooltipContent/index.tsx"],"names":[],"mappings":";;;;;;;;;;;AAAA,OAAO,EACL,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAMzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,MAAM,CAAC,IAAM,cAAc,GAAG,KAAK,CAAC,UAAU,CAG5C,SAAS,cAAc,CAAC,EAAY,EAAE,OAAO;QAAnB,QAAQ,cAAA;IAClC,IAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,IAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAC1B,IAAA,KAAgC,oBAAoB,EAAE,EAApD,cAAc,oBAAA,EAAE,SAAS,eAA2B,CAAC;IAC7D,IAAM,GAAG,GAAG,YAAY,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5D,6BAA6B;IAC7B,IAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAwB,IAAI,CAAC,CAAC;IAEhE,KAAK,CAAC,SAAS,CAAC;QACd,qDAAqD;QACrD,aAAa,CAAC,OAAO,GAAG,mBAAmB,EAAE,CAAC;QAE9C,qDAAqD;QACrD,OAAO;YACL,uBAAuB,EAAE,CAAC;QAC5B,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAE/D,IAAM,eAAe,GAAG,CAAC,CAAC;IAC1B,IAAM,QAAQ,GAAG,GAAG,CAAC;IAEf,IAAA,KAAwB,mBAAmB,CAAC,KAAK,CAAC,OAAO,EAAE;QAC/D,QAAQ,EAAE,cAAc;YACtB,CAAC,CAAC;gBACE,IAAI,EAAE,eAAe;gBACrB,gCAAgC;gBAChC,0CAA0C;gBAC1C,KAAK,EACH,SAAS,KAAK,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe;aACtE;YACH,CAAC,CAAC,QAAQ;QACZ,OAAO,EAAE;YACP,OAAO,EAAE,CAAC;SACX;KACF,CAAC,EAbM,SAAS,eAAA,EAAE,MAAM,YAavB,CAAC;IAEH,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,OAAO,CACL,oBAAC,cAAc,IAAC,IAAI,EAAE,aAAa;QACjC,oBAAC,MAAM,IAAC,GAAG,EAAE,GAAG,EAAE,aAAa;YAC7B,sCACE,GAAG,EAAE,GAAG,EACR,KAAK,wBACA,KAAK,CAAC,cAAc,GACpB,MAAM,KAEP,KAAK,CAAC,gBAAgB,EAAE,IAC5B,SAAS,EAAE,CAAC,CAAC,OAAO,KAEnB,QAAQ,CACL,CACC,CACM,CAClB,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/esm/Tooltip/TooltipContent/styles.module.css.json

@@ -0,0 +1 @@
+{ "tooltip": "_tooltip_3z5rn_1" }

package/dist/esm/Tooltip/TooltipDelayGroup/index.d.ts

@@ -0,0 +1,118 @@
+import * as React from 'react';
+export declare type TooltipDelayGroupProps = {
+    children?: React.ReactNode;
+    /** The delay in milliseconds before a tooltip opens on hover (default: 1000) */
+    delay?: number | {
+        open?: number;
+        close?: number;
+    };
+    /** How long to wait in milliseconds before closing the group (default: 0) */
+    timeoutMs?: number;
+};
+/**
+ * TooltipDelayGroup synchronizes hover delays across multiple tooltips.
+ *
+ * When tooltips are wrapped in a delay group, hovering over the first tooltip
+ * will use the configured delay, but subsequent tooltips in the group will
+ * open instantly. This creates a smoother UX when users explore multiple
+ * interactive elements with tooltips.
+ *
+ * @example Basic delay group
+ *
+ * Group multiple tooltips together so they open instantly after the first one:
+ *
+ * ```js
+ * <Canvas ctx={ctx}>
+ *   <TooltipDelayGroup delay={500}>
+ *     <div style={{ display: 'flex', gap: 'var(--spacing-m)' }}>
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button leftIcon={<SaveIcon />} />
+ *         </TooltipTrigger>
+ *         <TooltipContent>Save changes</TooltipContent>
+ *       </Tooltip>
+ *
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button leftIcon={<UndoIcon />} />
+ *         </TooltipTrigger>
+ *         <TooltipContent>Undo</TooltipContent>
+ *       </Tooltip>
+ *
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button leftIcon={<RedoIcon />} />
+ *         </TooltipTrigger>
+ *         <TooltipContent>Redo</TooltipContent>
+ *       </Tooltip>
+ *     </div>
+ *   </TooltipDelayGroup>
+ * </Canvas>;
+ * ```
+ *
+ * @example Custom delay configuration
+ *
+ * Configure different delays for opening and closing tooltips in the group:
+ *
+ * ```js
+ * <Canvas ctx={ctx}>
+ *   <TooltipDelayGroup delay={{ open: 800, close: 200 }} timeoutMs={500}>
+ *     <div style={{ display: 'flex', gap: 'var(--spacing-s)' }}>
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button>Action 1</Button>
+ *         </TooltipTrigger>
+ *         <TooltipContent>First action</TooltipContent>
+ *       </Tooltip>
+ *
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button>Action 2</Button>
+ *         </TooltipTrigger>
+ *         <TooltipContent>Second action</TooltipContent>
+ *       </Tooltip>
+ *     </div>
+ *   </TooltipDelayGroup>
+ * </Canvas>;
+ * ```
+ *
+ * @example Toolbar with grouped tooltips
+ *
+ * Create a toolbar where hovering between tools feels instant and responsive:
+ *
+ * ```js
+ * <Canvas ctx={ctx}>
+ *   <TooltipDelayGroup delay={600}>
+ *     <div style={{
+ *       display: 'flex',
+ *       gap: 'var(--spacing-xs)',
+ *       padding: 'var(--spacing-s)',
+ *       borderRadius: 'var(--border-radius-m)',
+ *       backgroundColor: 'var(--light-bg-color)'
+ *     }}>
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button buttonSize="s" leftIcon={<BoldIcon />} />
+ *         </TooltipTrigger>
+ *         <TooltipContent>Bold</TooltipContent>
+ *       </Tooltip>
+ *
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button buttonSize="s" leftIcon={<ItalicIcon />} />
+ *         </TooltipTrigger>
+ *         <TooltipContent>Italic</TooltipContent>
+ *       </Tooltip>
+ *
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button buttonSize="s" leftIcon={<UnderlineIcon />} />
+ *         </TooltipTrigger>
+ *         <TooltipContent>Underline</TooltipContent>
+ *       </Tooltip>
+ *     </div>
+ *   </TooltipDelayGroup>
+ * </Canvas>;
+ * ```
+ */
+export declare function TooltipDelayGroup({ children, delay, timeoutMs, }: TooltipDelayGroupProps): JSX.Element;

package/dist/esm/Tooltip/TooltipDelayGroup/index.js

@@ -0,0 +1,113 @@
+import { FloatingDelayGroup } from '@floating-ui/react';
+import * as React from 'react';
+/**
+ * TooltipDelayGroup synchronizes hover delays across multiple tooltips.
+ *
+ * When tooltips are wrapped in a delay group, hovering over the first tooltip
+ * will use the configured delay, but subsequent tooltips in the group will
+ * open instantly. This creates a smoother UX when users explore multiple
+ * interactive elements with tooltips.
+ *
+ * @example Basic delay group
+ *
+ * Group multiple tooltips together so they open instantly after the first one:
+ *
+ * ```js
+ * <Canvas ctx={ctx}>
+ *   <TooltipDelayGroup delay={500}>
+ *     <div style={{ display: 'flex', gap: 'var(--spacing-m)' }}>
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button leftIcon={<SaveIcon />} />
+ *         </TooltipTrigger>
+ *         <TooltipContent>Save changes</TooltipContent>
+ *       </Tooltip>
+ *
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button leftIcon={<UndoIcon />} />
+ *         </TooltipTrigger>
+ *         <TooltipContent>Undo</TooltipContent>
+ *       </Tooltip>
+ *
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button leftIcon={<RedoIcon />} />
+ *         </TooltipTrigger>
+ *         <TooltipContent>Redo</TooltipContent>
+ *       </Tooltip>
+ *     </div>
+ *   </TooltipDelayGroup>
+ * </Canvas>;
+ * ```
+ *
+ * @example Custom delay configuration
+ *
+ * Configure different delays for opening and closing tooltips in the group:
+ *
+ * ```js
+ * <Canvas ctx={ctx}>
+ *   <TooltipDelayGroup delay={{ open: 800, close: 200 }} timeoutMs={500}>
+ *     <div style={{ display: 'flex', gap: 'var(--spacing-s)' }}>
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button>Action 1</Button>
+ *         </TooltipTrigger>
+ *         <TooltipContent>First action</TooltipContent>
+ *       </Tooltip>
+ *
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button>Action 2</Button>
+ *         </TooltipTrigger>
+ *         <TooltipContent>Second action</TooltipContent>
+ *       </Tooltip>
+ *     </div>
+ *   </TooltipDelayGroup>
+ * </Canvas>;
+ * ```
+ *
+ * @example Toolbar with grouped tooltips
+ *
+ * Create a toolbar where hovering between tools feels instant and responsive:
+ *
+ * ```js
+ * <Canvas ctx={ctx}>
+ *   <TooltipDelayGroup delay={600}>
+ *     <div style={{
+ *       display: 'flex',
+ *       gap: 'var(--spacing-xs)',
+ *       padding: 'var(--spacing-s)',
+ *       borderRadius: 'var(--border-radius-m)',
+ *       backgroundColor: 'var(--light-bg-color)'
+ *     }}>
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button buttonSize="s" leftIcon={<BoldIcon />} />
+ *         </TooltipTrigger>
+ *         <TooltipContent>Bold</TooltipContent>
+ *       </Tooltip>
+ *
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button buttonSize="s" leftIcon={<ItalicIcon />} />
+ *         </TooltipTrigger>
+ *         <TooltipContent>Italic</TooltipContent>
+ *       </Tooltip>
+ *
+ *       <Tooltip>
+ *         <TooltipTrigger>
+ *           <Button buttonSize="s" leftIcon={<UnderlineIcon />} />
+ *         </TooltipTrigger>
+ *         <TooltipContent>Underline</TooltipContent>
+ *       </Tooltip>
+ *     </div>
+ *   </TooltipDelayGroup>
+ * </Canvas>;
+ * ```
+ */
+export function TooltipDelayGroup(_a) {
+    var children = _a.children, _b = _a.delay, delay = _b === void 0 ? 1000 : _b, _c = _a.timeoutMs, timeoutMs = _c === void 0 ? 0 : _c;
+    return (React.createElement(FloatingDelayGroup, { delay: delay, timeoutMs: timeoutMs }, children));
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/Tooltip/TooltipDelayGroup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Tooltip/TooltipDelayGroup/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyGG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAIT;QAHvB,QAAQ,cAAA,EACR,aAAY,EAAZ,KAAK,mBAAG,IAAI,KAAA,EACZ,iBAAa,EAAb,SAAS,mBAAG,CAAC,KAAA;IAEb,OAAO,CACL,oBAAC,kBAAkB,IAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,IACnD,QAAQ,CACU,CACtB,CAAC;AACJ,CAAC"}

package/dist/esm/Tooltip/TooltipTrigger/index.d.ts

@@ -0,0 +1,45 @@
+import * as React from 'react';
+export declare type TooltipTriggerProps = {
+    children: React.ReactElement;
+};
+/**
+ * TooltipTrigger wraps the element that triggers the tooltip on hover/focus.
+ *
+ * The child must be a single React element that accepts ref and event handler props.
+ * Common triggers include buttons, icons, or other interactive elements.
+ *
+ * @example With Button component
+ *
+ * Wrap a button to show a tooltip when the user hovers over it:
+ *
+ * ```js
+ * <Canvas ctx={ctx}>
+ *   <Tooltip>
+ *     <TooltipTrigger>
+ *       <Button>Hover for info</Button>
+ *     </TooltipTrigger>
+ *     <TooltipContent>
+ *       Additional information appears here
+ *     </TooltipContent>
+ *   </Tooltip>
+ * </Canvas>;
+ * ```
+ *
+ * @example With icon button
+ *
+ * Use tooltips with icon-only buttons to explain their purpose:
+ *
+ * ```js
+ * <Canvas ctx={ctx}>
+ *   <Tooltip placement="bottom">
+ *     <TooltipTrigger>
+ *       <Button buttonSize="s" leftIcon={<InfoIcon />} />
+ *     </TooltipTrigger>
+ *     <TooltipContent>
+ *       Click for more details
+ *     </TooltipContent>
+ *   </Tooltip>
+ * </Canvas>;
+ * ```
+ */
+export declare const TooltipTrigger: React.ForwardRefExoticComponent<TooltipTriggerProps & React.RefAttributes<HTMLElement>>;

package/dist/esm/Tooltip/TooltipTrigger/index.js

@@ -0,0 +1,76 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { useMergeRefs } from '@floating-ui/react';
+import * as React from 'react';
+import { useTooltipState } from '../utils';
+/**
+ * TooltipTrigger wraps the element that triggers the tooltip on hover/focus.
+ *
+ * The child must be a single React element that accepts ref and event handler props.
+ * Common triggers include buttons, icons, or other interactive elements.
+ *
+ * @example With Button component
+ *
+ * Wrap a button to show a tooltip when the user hovers over it:
+ *
+ * ```js
+ * <Canvas ctx={ctx}>
+ *   <Tooltip>
+ *     <TooltipTrigger>
+ *       <Button>Hover for info</Button>
+ *     </TooltipTrigger>
+ *     <TooltipContent>
+ *       Additional information appears here
+ *     </TooltipContent>
+ *   </Tooltip>
+ * </Canvas>;
+ * ```
+ *
+ * @example With icon button
+ *
+ * Use tooltips with icon-only buttons to explain their purpose:
+ *
+ * ```js
+ * <Canvas ctx={ctx}>
+ *   <Tooltip placement="bottom">
+ *     <TooltipTrigger>
+ *       <Button buttonSize="s" leftIcon={<InfoIcon />} />
+ *     </TooltipTrigger>
+ *     <TooltipContent>
+ *       Click for more details
+ *     </TooltipContent>
+ *   </Tooltip>
+ * </Canvas>;
+ * ```
+ */
+export var TooltipTrigger = React.forwardRef(function TooltipTrigger(_a, propRef) {
+    var children = _a.children, props = __rest(_a, ["children"]);
+    var state = useTooltipState();
+    var childrenRef = children.ref;
+    var ref = useMergeRefs([state.refs.setReference, propRef, childrenRef]);
+    if (!React.isValidElement(children)) {
+        throw new Error('TooltipTrigger children must be a valid React element');
+    }
+    return React.cloneElement(children, state.getReferenceProps(__assign(__assign(__assign({ ref: ref }, props), children.props), { 'data-state': state.open ? 'open' : 'closed' })));
+});
+//# sourceMappingURL=index.js.map

package/dist/esm/Tooltip/TooltipTrigger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/Tooltip/TooltipTrigger/index.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAM3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,CAAC,IAAM,cAAc,GAAG,KAAK,CAAC,UAAU,CAG5C,SAAS,cAAc,CAAC,EAAsB,EAAE,OAAO;IAA7B,IAAA,QAAQ,cAAA,EAAK,KAAK,cAApB,YAAsB,CAAF;IAC5C,IAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAEhC,IAAM,WAAW,GAAI,QAAgB,CAAC,GAAG,CAAC;IAC1C,IAAM,GAAG,GAAG,YAAY,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAE1E,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE;QACnC,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;KAC1E;IAED,OAAO,KAAK,CAAC,YAAY,CACvB,QAAQ,EACR,KAAK,CAAC,iBAAiB,8BACrB,GAAG,KAAA,IACA,KAAK,GACL,QAAQ,CAAC,KAAK,KACjB,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,IAC5C,CACH,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/esm/Tooltip/index.d.ts

@@ -0,0 +1,8 @@
+export { Tooltip } from './Tooltip';
+export type { TooltipProps } from './Tooltip';
+export { TooltipContent } from './TooltipContent';
+export type { TooltipContentProps } from './TooltipContent';
+export { TooltipDelayGroup } from './TooltipDelayGroup';
+export type { TooltipDelayGroupProps } from './TooltipDelayGroup';
+export { TooltipTrigger } from './TooltipTrigger';
+export type { TooltipTriggerProps } from './TooltipTrigger';

package/dist/esm/Tooltip/index.js

@@ -0,0 +1,5 @@
+export { Tooltip } from './Tooltip';
+export { TooltipContent } from './TooltipContent';
+export { TooltipDelayGroup } from './TooltipDelayGroup';
+export { TooltipTrigger } from './TooltipTrigger';
+//# sourceMappingURL=index.js.map

package/dist/esm/Tooltip/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Tooltip/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/esm/Tooltip/utils.d.ts

@@ -0,0 +1,166 @@
+import type { Placement } from '@floating-ui/react';
+import * as React from 'react';
+export declare function getSharedPortalRoot(): HTMLDivElement;
+export declare function releaseSharedPortalRoot(): void;
+export interface TooltipOptions {
+    /** Whether the tooltip is initially open (uncontrolled mode) */
+    initialOpen?: boolean;
+    /** Placement of the tooltip relative to its trigger */
+    placement?: Placement;
+    /** Controlled open state */
+    open?: boolean;
+    /** Callback when open state changes (controlled mode) */
+    onOpenChange?: (open: boolean) => void;
+}
+/**
+ * Hook that manages tooltip state and positioning logic.
+ *
+ * This hook provides the core tooltip behavior including hover/focus detection,
+ * positioning, and accessibility features. Use this when you need full control
+ * over the tooltip structure.
+ *
+ * @example Basic tooltip hook usage
+ *
+ * Build a custom tooltip implementation using the hook directly for maximum flexibility:
+ *
+ * ```js
+ * function MyComponent() {
+ *   const tooltip = useTooltip({ placement: 'top' });
+ *
+ *   return (
+ *     <>
+ *       <button
+ *         ref={tooltip.refs.setReference}
+ *         {...tooltip.getReferenceProps()}
+ *       >
+ *         Hover me
+ *       </button>
+ *
+ *       {tooltip.open && (
+ *         <div
+ *           ref={tooltip.refs.setFloating}
+ *           style={tooltip.floatingStyles}
+ *           {...tooltip.getFloatingProps()}
+ *         >
+ *           Tooltip content
+ *         </div>
+ *       )}
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @example Controlled tooltip
+ *
+ * Control the tooltip's open state programmatically for click-to-toggle behavior:
+ *
+ * ```js
+ * function ControlledTooltip() {
+ *   const [open, setOpen] = React.useState(false);
+ *   const tooltip = useTooltip({ open, onOpenChange: setOpen });
+ *
+ *   return (
+ *     <Canvas ctx={ctx}>
+ *       <button onClick={() => setOpen(!open)}>
+ *         Toggle tooltip
+ *       </button>
+ *     </Canvas>
+ *   );
+ * }
+ * ```
+ */
+export declare function useTooltip({ initialOpen, placement, open: controlledOpen, onOpenChange: setControlledOpen, }?: TooltipOptions): {
+    placement: Placement;
+    strategy: import("@floating-ui/utils").Strategy;
+    middlewareData: import("@floating-ui/core").MiddlewareData;
+    x: number;
+    y: number;
+    isPositioned: boolean;
+    update: () => void;
+    floatingStyles: React.CSSProperties;
+    refs: {
+        reference: React.MutableRefObject<import("@floating-ui/react-dom").ReferenceType | null>;
+        floating: React.MutableRefObject<HTMLElement | null>;
+        setReference: (node: import("@floating-ui/react-dom").ReferenceType | null) => void;
+        setFloating: (node: HTMLElement | null) => void;
+    } & import("@floating-ui/react").ExtendedRefs<import("@floating-ui/react").ReferenceType>;
+    elements: {
+        reference: import("@floating-ui/react-dom").ReferenceType | null;
+        floating: HTMLElement | null;
+    } & import("@floating-ui/react").ExtendedElements<import("@floating-ui/react").ReferenceType>;
+    context: {
+        x: number;
+        y: number;
+        placement: Placement;
+        strategy: import("@floating-ui/utils").Strategy;
+        middlewareData: import("@floating-ui/core").MiddlewareData;
+        isPositioned: boolean;
+        update: () => void;
+        floatingStyles: React.CSSProperties;
+        open: boolean;
+        onOpenChange: (open: boolean, event?: Event | undefined, reason?: import("@floating-ui/react").OpenChangeReason | undefined) => void;
+        events: import("@floating-ui/react").FloatingEvents;
+        dataRef: React.MutableRefObject<import("@floating-ui/react").ContextData>;
+        nodeId: string | undefined;
+        floatingId: string | undefined;
+        refs: import("@floating-ui/react").ExtendedRefs<import("@floating-ui/react").ReferenceType>;
+        elements: import("@floating-ui/react").ExtendedElements<import("@floating-ui/react").ReferenceType>;
+    };
+    getReferenceProps: (userProps?: React.HTMLProps<Element> | undefined) => Record<string, unknown>;
+    getFloatingProps: (userProps?: React.HTMLProps<HTMLElement> | undefined) => Record<string, unknown>;
+    getItemProps: (userProps?: (Omit<React.HTMLProps<HTMLElement>, "selected" | "active"> & {
+        active?: boolean | undefined;
+        selected?: boolean | undefined;
+    }) | undefined) => Record<string, unknown>;
+    open: boolean;
+    setOpen: (open: boolean) => void;
+};
+declare type ContextType = ReturnType<typeof useTooltip> | null;
+export declare const TooltipContext: React.Context<ContextType>;
+export declare const useTooltipState: () => {
+    placement: Placement;
+    strategy: import("@floating-ui/utils").Strategy;
+    middlewareData: import("@floating-ui/core").MiddlewareData;
+    x: number;
+    y: number;
+    isPositioned: boolean;
+    update: () => void;
+    floatingStyles: React.CSSProperties;
+    refs: {
+        reference: React.MutableRefObject<import("@floating-ui/react-dom").ReferenceType | null>;
+        floating: React.MutableRefObject<HTMLElement | null>;
+        setReference: (node: import("@floating-ui/react-dom").ReferenceType | null) => void;
+        setFloating: (node: HTMLElement | null) => void;
+    } & import("@floating-ui/react").ExtendedRefs<import("@floating-ui/react").ReferenceType>;
+    elements: {
+        reference: import("@floating-ui/react-dom").ReferenceType | null;
+        floating: HTMLElement | null;
+    } & import("@floating-ui/react").ExtendedElements<import("@floating-ui/react").ReferenceType>;
+    context: {
+        x: number;
+        y: number;
+        placement: Placement;
+        strategy: import("@floating-ui/utils").Strategy;
+        middlewareData: import("@floating-ui/core").MiddlewareData;
+        isPositioned: boolean;
+        update: () => void;
+        floatingStyles: React.CSSProperties;
+        open: boolean;
+        onOpenChange: (open: boolean, event?: Event | undefined, reason?: import("@floating-ui/react").OpenChangeReason | undefined) => void;
+        events: import("@floating-ui/react").FloatingEvents;
+        dataRef: React.MutableRefObject<import("@floating-ui/react").ContextData>;
+        nodeId: string | undefined;
+        floatingId: string | undefined;
+        refs: import("@floating-ui/react").ExtendedRefs<import("@floating-ui/react").ReferenceType>;
+        elements: import("@floating-ui/react").ExtendedElements<import("@floating-ui/react").ReferenceType>;
+    };
+    getReferenceProps: (userProps?: React.HTMLProps<Element> | undefined) => Record<string, unknown>;
+    getFloatingProps: (userProps?: React.HTMLProps<HTMLElement> | undefined) => Record<string, unknown>;
+    getItemProps: (userProps?: (Omit<React.HTMLProps<HTMLElement>, "selected" | "active"> & {
+        active?: boolean | undefined;
+        selected?: boolean | undefined;
+    }) | undefined) => Record<string, unknown>;
+    open: boolean;
+    setOpen: (open: boolean) => void;
+};
+export {};