datocms-react-ui 2.0.18 → 2.0.19

package/dist/types/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/types/Tooltip/TooltipTrigger/index.d.ts

@@ -1,5 +1,7 @@
 import * as React from 'react';
-export declare type TooltipTriggerProps = React.HTMLProps<HTMLElement>;
+export declare type TooltipTriggerProps = {
+    children: React.ReactElement;
+};
 /**
  * TooltipTrigger wraps the element that triggers the tooltip on hover/focus.
  *
@@ -40,4 +42,4 @@ export declare type TooltipTriggerProps = React.HTMLProps<HTMLElement>;
  * </Canvas>;
  * ```
  */
-export declare const TooltipTrigger: React.ForwardRefExoticComponent<Pick<TooltipTriggerProps, "width" | "height" | "style" | "className" | "cite" | "data" | "form" | "label" | "slot" | "span" | "summary" | "title" | "pattern" | "type" | "muted" | "children" | "disabled" | "onClick" | "target" | "href" | "selected" | "value" | "open" | "name" | "rel" | "useMap" | "color" | "hidden" | "onChange" | "onKeyDown" | "placeholder" | "id" | "required" | "htmlFor" | "default" | "onSubmit" | "alt" | "aria-errormessage" | "aria-invalid" | "aria-label" | "aria-labelledby" | "aria-live" | "autoFocus" | "onBlur" | "onFocus" | "tabIndex" | "defaultValue" | "content" | "translate" | "start" | "size" | "wrap" | "multiple" | "onMouseDown" | "onMouseMove" | "onMouseUp" | "action" | "list" | "role" | "onTouchStart" | "sizes" | "onDragStart" | "onDragEnd" | "defaultChecked" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "lang" | "spellCheck" | "radioGroup" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-keyshortcuts" | "aria-level" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocusCapture" | "onBlurCapture" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "step" | "key" | "autoComplete" | "cols" | "maxLength" | "minLength" | "readOnly" | "rows" | "accept" | "capture" | "checked" | "crossOrigin" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "max" | "min" | "src" | "acceptCharset" | "allowFullScreen" | "allowTransparency" | "as" | "async" | "autoPlay" | "cellPadding" | "cellSpacing" | "charSet" | "challenge" | "classID" | "colSpan" | "controls" | "coords" | "dateTime" | "defer" | "download" | "encType" | "frameBorder" | "headers" | "high" | "hrefLang" | "httpEquiv" | "integrity" | "keyParams" | "keyType" | "kind" | "loop" | "low" | "manifest" | "marginHeight" | "marginWidth" | "media" | "mediaGroup" | "method" | "nonce" | "noValidate" | "optimum" | "playsInline" | "poster" | "preload" | "reversed" | "rowSpan" | "sandbox" | "scope" | "scoped" | "scrolling" | "seamless" | "shape" | "srcDoc" | "srcLang" | "srcSet" | "wmode"> & React.RefAttributes<HTMLElement>>;
+export declare const TooltipTrigger: React.ForwardRefExoticComponent<TooltipTriggerProps & React.RefAttributes<HTMLElement>>;

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

@@ -2,5 +2,7 @@ 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "datocms-react-ui",
-  "version": "2.0.18",
+  "version": "2.0.19",
   "description": "React components to use inside DatoCMS plugins",
   "keywords": [
     "datocms",
@@ -58,5 +58,5 @@
     "postcss-nested": "^5.0.6",
     "typedoc": "^0.26.7"
   },
-  "gitHead": "59657aeaa34d9723d21537503933b2d7c92e7e39"
+  "gitHead": "136cd08943c66f818b29e51313acc009f26163e8"
 }

package/src/Tooltip/Tooltip/index.tsx

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { TooltipContext, useTooltip, TooltipOptions } from '../utils';
+import { TooltipContext, TooltipOptions, useTooltip } from '../utils';
 
 export type TooltipProps = {
   children?: React.ReactNode;

package/src/Tooltip/TooltipContent/index.tsx

@@ -1,13 +1,17 @@
-import * as React from 'react';
 import {
   FloatingPortal,
-  useMergeRefs,
   useDelayGroup,
   useDelayGroupContext,
+  useMergeRefs,
   useTransitionStyles,
 } from '@floating-ui/react';
+import * as React from 'react';
 import { Canvas, useCtx } from '../../Canvas';
-import { useTooltipState, getSharedPortalRoot, releaseSharedPortalRoot } from '../utils';
+import {
+  getSharedPortalRoot,
+  releaseSharedPortalRoot,
+  useTooltipState,
+} from '../utils';
 import s from './styles.module.css.json';
 
 export type TooltipContentProps = {
@@ -77,8 +81,10 @@ export type TooltipContentProps = {
  * </Canvas>;
  * ```
  */
-export const TooltipContent = React.forwardRef<HTMLDivElement, TooltipContentProps>(
-  function TooltipContent({ children }, propRef) {
+export const TooltipContent = React.forwardRef<
+  HTMLDivElement,
+  TooltipContentProps
+>(function TooltipContent({ children }, propRef) {
   const ctx = useCtx();
   const state = useTooltipState();
   const { isInstantPhase, currentId } = useDelayGroupContext();
@@ -136,5 +142,4 @@ export const TooltipContent = React.forwardRef<HTMLDivElement, TooltipContentPro
       </Canvas>
     </FloatingPortal>
   );
-  },
-);
+});

package/src/Tooltip/TooltipDelayGroup/index.tsx

@@ -0,0 +1,128 @@
+import { FloatingDelayGroup } from '@floating-ui/react';
+import * as React from 'react';
+
+export 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 function TooltipDelayGroup({
+  children,
+  delay = 1000,
+  timeoutMs = 0,
+}: TooltipDelayGroupProps) {
+  return (
+    <FloatingDelayGroup delay={delay} timeoutMs={timeoutMs}>
+      {children}
+    </FloatingDelayGroup>
+  );
+}

package/src/Tooltip/TooltipTrigger/index.tsx

@@ -1,8 +1,10 @@
-import * as React from 'react';
 import { useMergeRefs } from '@floating-ui/react';
+import * as React from 'react';
 import { useTooltipState } from '../utils';
 
-export type TooltipTriggerProps = React.HTMLProps<HTMLElement>;
+export type TooltipTriggerProps = {
+  children: React.ReactElement;
+};
 
 /**
  * TooltipTrigger wraps the element that triggers the tooltip on hover/focus.
@@ -44,8 +46,10 @@ export type TooltipTriggerProps = React.HTMLProps<HTMLElement>;
  * </Canvas>;
  * ```
  */
-export const TooltipTrigger = React.forwardRef<HTMLElement, TooltipTriggerProps>(
-  function TooltipTrigger({ children, ...props }, propRef) {
+export const TooltipTrigger = React.forwardRef<
+  HTMLElement,
+  TooltipTriggerProps
+>(function TooltipTrigger({ children, ...props }, propRef) {
   const state = useTooltipState();
 
   const childrenRef = (children as any).ref;
@@ -64,5 +68,4 @@ export const TooltipTrigger = React.forwardRef<HTMLElement, TooltipTriggerProps>
       'data-state': state.open ? 'open' : 'closed',
     }),
   );
-  },
-);
+});

package/src/Tooltip/index.ts

@@ -2,5 +2,7 @@ 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/src/Tooltip/utils.ts

@@ -157,7 +157,7 @@ export function useTooltip({
       ...interactions,
       ...data,
     }),
-    [open, setOpen, interactions, data]
+    [open, setOpen, interactions, data],
   );
 }