@dxos/react-ui-stack 0.8.2-main.fbd8ed0 → 0.8.2-staging.42af850

package/dist/lib/browser/index.mjs

@@ -1,7 +1,8 @@
 // packages/ui/react-ui-stack/src/components/Stack/Stack.tsx
+import { useSignals as _useSignals } from "@preact-signals/safe-react/tracking";
 import { useArrowNavigationGroup } from "@fluentui/react-tabster";
 import { composeRefs } from "@radix-ui/react-compose-refs";
-import React, { Children, forwardRef, useState as useState2, useMemo } from "react";
+import React, { Children, forwardRef, useState as useState2, useMemo, useCallback } from "react";
 import { ListItem } from "@dxos/react-ui";
 import { mx } from "@dxos/react-ui-theme";
 
@@ -75,11 +76,17 @@ var StackContext = /* @__PURE__ */ createContext({
   size: "intrinsic"
 });
 var useStack = () => useContext(StackContext);
+var idle = {
+  type: "idle"
+};
 var StackItemContext = /* @__PURE__ */ createContext({
   selfDragHandleRef: () => {
   },
   size: "min-content",
   setSize: () => {
+  },
+  state: idle,
+  setState: () => {
   }
 });
 var useStackItem = () => useContext(StackItemContext);
@@ -92,158 +99,214 @@ var railGridVerticalContainFitContent = "grid-cols-[[rail-start]_var(--rail-size
 var autoScrollRootAttributes = {
   "data-drag-autoscroll": "idle"
 };
-var Stack = /* @__PURE__ */ forwardRef(({ children, classNames, style, orientation = "vertical", rail = true, size = "intrinsic", onRearrange, itemsCount = Children.count(children), ...props }, forwardedRef) => {
-  const [stackElement, stackRef] = useState2(null);
-  const composedItemRef = composeRefs(stackRef, forwardedRef);
-  const arrowNavigationAttrs = useArrowNavigationGroup({
-    axis: orientation
-  });
-  const styles = {
-    [orientation === "horizontal" ? "gridTemplateColumns" : "gridTemplateRows"]: `repeat(${itemsCount}, min-content) [tabster-dummies] 0`,
-    ...style
-  };
-  const selfDroppable = !!(itemsCount < 1 && onRearrange && props.id);
-  const { dropping } = useStackDropForElements({
-    id: props.id,
-    element: stackElement,
-    selfDroppable,
-    orientation,
-    onRearrange
-  });
-  const gridClasses = useMemo(() => {
-    if (!rail) {
-      return orientation === "horizontal" ? "grid-rows-1 pli-1" : "grid-cols-1 plb-1";
-    }
-    if (orientation === "horizontal") {
-      return size === "contain-fit-content" ? railGridHorizontalContainFitContent : railGridHorizontal;
-    } else {
-      return size === "contain-fit-content" ? railGridVerticalContainFitContent : railGridVertical;
-    }
-  }, [
-    rail,
-    orientation,
-    size
-  ]);
-  return /* @__PURE__ */ React.createElement(StackContext.Provider, {
-    value: {
+var Stack = /* @__PURE__ */ forwardRef(({ children, classNames, style, orientation = "vertical", rail = true, size = "intrinsic", onRearrange, itemsCount = Children.count(children), getDropElement, separatorOnScroll, ...props }, forwardedRef) => {
+  var _effect = _useSignals();
+  try {
+    const [stackElement, stackRef] = useState2(null);
+    const composedItemRef = composeRefs(stackRef, forwardedRef);
+    const arrowNavigationAttrs = useArrowNavigationGroup({
+      axis: orientation
+    });
+    const styles = {
+      [orientation === "horizontal" ? "gridTemplateColumns" : "gridTemplateRows"]: `repeat(${itemsCount}, min-content) [tabster-dummies] 0`,
+      ...style
+    };
+    const selfDroppable = !!(itemsCount < 1 && onRearrange && props.id);
+    const { dropping } = useStackDropForElements({
+      id: props.id,
+      element: getDropElement && stackElement ? getDropElement(stackElement) : stackElement,
+      selfDroppable,
       orientation,
-      rail,
-      size,
       onRearrange
-    }
-  }, /* @__PURE__ */ React.createElement("div", {
-    ...props,
-    ...arrowNavigationAttrs,
-    className: mx("grid relative", gridClasses, (size === "contain" || size === "contain-fit-content") && (orientation === "horizontal" ? "overflow-x-auto min-bs-0 max-bs-full bs-full" : "overflow-y-auto min-is-0 max-is-full is-full"), classNames),
-    "data-rail": rail,
-    "aria-orientation": orientation,
-    style: styles,
-    ref: composedItemRef
-  }, children, selfDroppable && dropping && /* @__PURE__ */ React.createElement(ListItem.DropIndicator, {
-    lineInset: 8,
-    terminalInset: -8,
-    gap: -8,
-    edge: orientation === "horizontal" ? "left" : "top"
-  })));
+    });
+    const handleScroll = useCallback(() => {
+      if (stackElement && Number.isFinite(separatorOnScroll)) {
+        const scrollPosition = orientation === "horizontal" ? stackElement.scrollLeft : stackElement.scrollTop;
+        const scrollSize = orientation === "horizontal" ? stackElement.scrollWidth : stackElement.scrollHeight;
+        const clientSize = orientation === "horizontal" ? stackElement.clientWidth : stackElement.clientHeight;
+        const separatorHost = stackElement.closest("[data-scroll-separator]");
+        if (separatorHost) {
+          separatorHost.setAttribute("data-scroll-separator", String(scrollPosition > separatorOnScroll));
+          separatorHost.setAttribute("data-scroll-separator-end", String(scrollSize - (scrollPosition + clientSize) > separatorOnScroll));
+        }
+      }
+    }, [
+      stackElement,
+      separatorOnScroll,
+      orientation
+    ]);
+    const gridClasses = useMemo(() => {
+      if (!rail) {
+        return orientation === "horizontal" ? "grid-rows-1 pli-1" : "grid-cols-1 plb-1";
+      }
+      if (orientation === "horizontal") {
+        return size === "contain-fit-content" ? railGridHorizontalContainFitContent : railGridHorizontal;
+      } else {
+        return size === "contain-fit-content" ? railGridVerticalContainFitContent : railGridVertical;
+      }
+    }, [
+      rail,
+      orientation,
+      size
+    ]);
+    return /* @__PURE__ */ React.createElement(StackContext.Provider, {
+      value: {
+        orientation,
+        rail,
+        size,
+        onRearrange
+      }
+    }, /* @__PURE__ */ React.createElement("div", {
+      ...props,
+      ...arrowNavigationAttrs,
+      className: mx("grid relative", gridClasses, (size === "contain" || size === "contain-fit-content") && (orientation === "horizontal" ? "overflow-x-auto min-bs-0 max-bs-full bs-full" : "overflow-y-auto min-is-0 max-is-full is-full"), classNames),
+      "data-rail": rail,
+      "aria-orientation": orientation,
+      style: styles,
+      ref: composedItemRef,
+      ...Number.isFinite(separatorOnScroll) && {
+        onScroll: handleScroll
+      }
+    }, children, selfDroppable && dropping && /* @__PURE__ */ React.createElement(ListItem.DropIndicator, {
+      lineInset: 8,
+      terminalInset: -8,
+      gap: -8,
+      edge: orientation === "horizontal" ? "left" : "top"
+    })));
+  } finally {
+    _effect.f();
+  }
 });
 
 // packages/ui/react-ui-stack/src/components/StackItem/StackItem.tsx
+import { useSignals as _useSignals8 } from "@preact-signals/safe-react/tracking";
 import { combine as combine2 } from "@atlaskit/pragmatic-drag-and-drop/combine";
 import { draggable, dropTargetForElements as dropTargetForElements2 } from "@atlaskit/pragmatic-drag-and-drop/element/adapter";
 import { preserveOffsetOnSource } from "@atlaskit/pragmatic-drag-and-drop/element/preserve-offset-on-source";
-import { scrollJustEnoughIntoView } from "@atlaskit/pragmatic-drag-and-drop/element/scroll-just-enough-into-view";
+import { setCustomNativeDragPreview } from "@atlaskit/pragmatic-drag-and-drop/element/set-custom-native-drag-preview";
 import { attachClosestEdge as attachClosestEdge2, extractClosestEdge as extractClosestEdge2 } from "@atlaskit/pragmatic-drag-and-drop-hitbox/closest-edge";
 import { useFocusableGroup as useFocusableGroup2 } from "@fluentui/react-tabster";
 import { composeRefs as composeRefs2 } from "@radix-ui/react-compose-refs";
-import React8, { forwardRef as forwardRef5, useLayoutEffect as useLayoutEffect2, useState as useState4, useCallback } from "react";
+import React8, { forwardRef as forwardRef5, useLayoutEffect as useLayoutEffect2, useState as useState4, useCallback as useCallback2 } from "react";
+import { createPortal } from "react-dom";
 import { ListItem as ListItem2 } from "@dxos/react-ui";
 import { resizeAttributes, sizeStyle } from "@dxos/react-ui-dnd";
 import { mx as mx5 } from "@dxos/react-ui-theme";
 
 // packages/ui/react-ui-stack/src/components/StackItem/StackItemContent.tsx
+import { useSignals as _useSignals2 } from "@preact-signals/safe-react/tracking";
 import React2, { forwardRef as forwardRef2 } from "react";
 import { mx as mx2 } from "@dxos/react-ui-theme";
 var StackItemContent = /* @__PURE__ */ forwardRef2(({ children, toolbar, statusbar, classNames, size = "intrinsic", ...props }, forwardedRef) => {
-  const { size: stackItemSize } = useStack();
-  return /* @__PURE__ */ React2.createElement("div", {
-    role: "none",
-    ...props,
-    className: mx2("group grid grid-cols-[100%]", stackItemSize === "contain" && "min-bs-0 overflow-hidden", size === "video" ? "aspect-video" : size === "square" && "aspect-square", classNames),
-    style: {
-      gridTemplateRows: [
-        ...toolbar ? [
-          "var(--rail-action)"
-        ] : [],
-        "1fr",
-        ...statusbar ? [
-          "var(--statusbar-size)"
-        ] : []
-      ].join(" ")
-    },
-    "data-popover-collision-boundary": true,
-    ref: forwardedRef
-  }, children);
+  var _effect = _useSignals2();
+  try {
+    const { size: stackItemSize } = useStack();
+    return /* @__PURE__ */ React2.createElement("div", {
+      role: "none",
+      ...props,
+      className: mx2("group grid grid-cols-[100%]", stackItemSize === "contain" && "min-bs-0 overflow-hidden", size === "video" ? "aspect-video" : size === "square" && "aspect-square", classNames),
+      style: {
+        gridTemplateRows: [
+          ...toolbar ? [
+            "var(--rail-action)"
+          ] : [],
+          "1fr",
+          ...statusbar ? [
+            "var(--statusbar-size)"
+          ] : []
+        ].join(" ")
+      },
+      "data-popover-collision-boundary": true,
+      ref: forwardedRef
+    }, children);
+  } finally {
+    _effect.f();
+  }
 });
 
 // packages/ui/react-ui-stack/src/components/StackItem/StackItemDragHandle.tsx
+import { useSignals as _useSignals3 } from "@preact-signals/safe-react/tracking";
 import { Slot } from "@radix-ui/react-slot";
 import React3 from "react";
 var StackItemDragHandle = ({ asChild, children }) => {
-  const { selfDragHandleRef } = useStackItem();
-  const Root = asChild ? Slot : "div";
-  return /* @__PURE__ */ React3.createElement(Root, {
-    ref: selfDragHandleRef,
-    role: "button"
-  }, children);
+  var _effect = _useSignals3();
+  try {
+    const { selfDragHandleRef } = useStackItem();
+    const Root = asChild ? Slot : "div";
+    return /* @__PURE__ */ React3.createElement(Root, {
+      ref: selfDragHandleRef,
+      role: "button"
+    }, children);
+  } finally {
+    _effect.f();
+  }
 };
 
 // packages/ui/react-ui-stack/src/components/StackItem/StackItemHeading.tsx
+import { useSignals as _useSignals4 } from "@preact-signals/safe-react/tracking";
 import { useFocusableGroup } from "@fluentui/react-tabster";
 import React4, { forwardRef as forwardRef3 } from "react";
 import { useAttention } from "@dxos/react-ui-attention";
 import { mx as mx3 } from "@dxos/react-ui-theme";
 var StackItemHeading = ({ children, classNames, ...props }) => {
-  const { orientation } = useStack();
-  const focusableGroupAttrs = useFocusableGroup({
-    tabBehavior: "limited"
-  });
-  return /* @__PURE__ */ React4.createElement("div", {
-    role: "heading",
-    ...props,
-    tabIndex: 0,
-    ...focusableGroupAttrs,
-    className: mx3("flex items-center dx-focus-ring-inset-over-all relative !border-is-0 bg-headerSurface", orientation === "horizontal" ? "bs-[--rail-size]" : "is-[--rail-size] flex-col", classNames)
-  }, children);
+  var _effect = _useSignals4();
+  try {
+    const { orientation } = useStack();
+    const focusableGroupAttrs = useFocusableGroup({
+      tabBehavior: "limited"
+    });
+    return /* @__PURE__ */ React4.createElement("div", {
+      role: "heading",
+      ...props,
+      tabIndex: 0,
+      ...focusableGroupAttrs,
+      className: mx3('flex items-center dx-focus-ring-inset-over-all relative !border-is-0 bg-headerSurface border-transparent [[data-scroll-separator="true"]_&]:border-subduedSeparator', orientation === "horizontal" ? "bs-[--rail-size]" : "is-[--rail-size] flex-col", orientation === "horizontal" ? "border-be" : "border-ie", classNames)
+    }, children);
+  } finally {
+    _effect.f();
+  }
 };
 var StackItemHeadingLabel = /* @__PURE__ */ forwardRef3(({ attendableId, related, classNames, ...props }, forwardedRef) => {
-  const { hasAttention, isAncestor, isRelated } = useAttention(attendableId);
-  return /* @__PURE__ */ React4.createElement("h1", {
-    ...props,
-    "data-attention": (related && isRelated || hasAttention || isAncestor).toString(),
-    className: mx3("pli-1 min-is-0 is-0 grow truncate font-medium text-baseText data-[attention=true]:text-accentText self-center", classNames),
-    ref: forwardedRef
-  });
+  var _effect = _useSignals4();
+  try {
+    const { hasAttention, isAncestor, isRelated } = useAttention(attendableId);
+    return /* @__PURE__ */ React4.createElement("h1", {
+      ...props,
+      "data-attention": (related && isRelated || hasAttention || isAncestor).toString(),
+      className: mx3("pli-1 min-is-0 is-0 grow truncate font-medium text-baseText data-[attention=true]:text-accentText self-center", classNames),
+      ref: forwardedRef
+    });
+  } finally {
+    _effect.f();
+  }
 });
 
 // packages/ui/react-ui-stack/src/components/StackItem/StackItemResizeHandle.tsx
+import { useSignals as _useSignals5 } from "@preact-signals/safe-react/tracking";
 import React5 from "react";
 import { ResizeHandle } from "@dxos/react-ui-dnd";
 var MIN_WIDTH = 20;
 var MIN_HEIGHT = 3;
 var StackItemResizeHandle = () => {
-  const { orientation } = useStack();
-  const { setSize, size } = useStackItem();
-  return /* @__PURE__ */ React5.createElement(ResizeHandle, {
-    side: orientation === "horizontal" ? "inline-end" : "block-end",
-    fallbackSize: DEFAULT_EXTRINSIC_SIZE,
-    minSize: orientation === "horizontal" ? MIN_WIDTH : MIN_HEIGHT,
-    size,
-    onSizeChange: setSize
-  });
+  var _effect = _useSignals5();
+  try {
+    const { orientation } = useStack();
+    const { setSize, size } = useStackItem();
+    return /* @__PURE__ */ React5.createElement(ResizeHandle, {
+      side: orientation === "horizontal" ? "inline-end" : "block-end",
+      fallbackSize: DEFAULT_EXTRINSIC_SIZE,
+      minSize: orientation === "horizontal" ? MIN_WIDTH : MIN_HEIGHT,
+      size,
+      onSizeChange: setSize
+    });
+  } finally {
+    _effect.f();
+  }
 };
 
 // packages/ui/react-ui-stack/src/components/StackItem/StackItemSigil.tsx
-import React7, { Fragment, forwardRef as forwardRef4, useRef, useState as useState3 } from "react";
+import { useSignals as _useSignals7 } from "@preact-signals/safe-react/tracking";
+import React7, { Fragment, forwardRef as forwardRef4, useState as useState3 } from "react";
 import { keySymbols } from "@dxos/keyboard";
 import { Button, DropdownMenu, Icon, toLocalizedString, useTranslation } from "@dxos/react-ui";
 import { useAttention as useAttention2 } from "@dxos/react-ui-attention";
@@ -251,24 +314,32 @@ import { descriptionText, mx as mx4 } from "@dxos/react-ui-theme";
 import { getHostPlatform } from "@dxos/util";
 
 // packages/ui/react-ui-stack/src/components/StackItem/MenuSignifier.tsx
+import { useSignals as _useSignals6 } from "@preact-signals/safe-react/tracking";
 import React6 from "react";
-var MenuSignifierHorizontal = () => /* @__PURE__ */ React6.createElement("svg", {
-  className: "absolute block-end-[7px]",
-  width: 20,
-  height: 2,
-  viewBox: "0 0 20 2",
-  stroke: "currentColor",
-  opacity: 0.5
-}, /* @__PURE__ */ React6.createElement("line", {
-  x1: 0.5,
-  y1: 0.75,
-  x2: 19,
-  y2: 0.75,
-  strokeWidth: 1.25,
-  strokeLinecap: "round",
-  strokeDasharray: "6 20",
-  strokeDashoffset: "-6.5"
-}));
+var MenuSignifierHorizontal = () => {
+  var _effect = _useSignals6();
+  try {
+    return /* @__PURE__ */ React6.createElement("svg", {
+      className: "absolute block-end-[7px]",
+      width: 20,
+      height: 2,
+      viewBox: "0 0 20 2",
+      stroke: "currentColor",
+      opacity: 0.5
+    }, /* @__PURE__ */ React6.createElement("line", {
+      x1: 0.5,
+      y1: 0.75,
+      x2: 19,
+      y2: 0.75,
+      strokeWidth: 1.25,
+      strokeLinecap: "round",
+      strokeDasharray: "6 20",
+      strokeDashoffset: "-6.5"
+    }));
+  } finally {
+    _effect.f();
+  }
+};
 
 // packages/ui/react-ui-stack/src/translations.ts
 var translationKey = "stack";
@@ -290,221 +361,280 @@ var translations_default = [
 
 // packages/ui/react-ui-stack/src/components/StackItem/StackItemSigil.tsx
 var StackItemSigilButton = /* @__PURE__ */ forwardRef4(({ attendableId, classNames, related, isMenu = true, children, ...props }, forwardedRef) => {
-  const { hasAttention, isAncestor, isRelated } = useAttention2(attendableId);
-  const variant = related && isRelated || hasAttention || isAncestor ? "primary" : "ghost";
-  return /* @__PURE__ */ React7.createElement(Button, {
-    ...props,
-    variant,
-    classNames: [
-      "shrink-0 pli-0 min-bs-0 is-[--rail-action] bs-[--rail-action] relative app-no-drag",
-      classNames
-    ],
-    ref: forwardedRef
-  }, isMenu && /* @__PURE__ */ React7.createElement(MenuSignifierHorizontal, null), children);
+  var _effect = _useSignals7();
+  try {
+    const { hasAttention, isAncestor, isRelated } = useAttention2(attendableId);
+    const variant = related && isRelated || hasAttention || isAncestor ? "primary" : "ghost";
+    return /* @__PURE__ */ React7.createElement(Button, {
+      ...props,
+      variant,
+      classNames: [
+        "shrink-0 pli-0 min-bs-0 is-[--rail-action] bs-[--rail-action] relative app-no-drag",
+        classNames
+      ],
+      ref: forwardedRef
+    }, isMenu && /* @__PURE__ */ React7.createElement(MenuSignifierHorizontal, null), children);
+  } finally {
+    _effect.f();
+  }
 });
 var StackItemSigil = /* @__PURE__ */ forwardRef4(({ actions: actionGroups, onAction, triggerLabel, attendableId, icon, related, children }, forwardedRef) => {
-  const { t } = useTranslation(translationKey);
-  const suppressNextTooltip = useRef(false);
-  const [optionsMenuOpen, setOptionsMenuOpen] = useState3(false);
-  const hasActions = actionGroups && actionGroups.length > 0;
-  const button = /* @__PURE__ */ React7.createElement(StackItemSigilButton, {
-    attendableId,
-    related,
-    isMenu: hasActions,
-    // TODO(wittjosiah): Better disabling of interactive styles when no action are available.
-    //   Remove underscore icon when no actions are available?
-    classNames: !hasActions && "cursor-default"
-  }, /* @__PURE__ */ React7.createElement("span", {
-    className: "sr-only"
-  }, triggerLabel), /* @__PURE__ */ React7.createElement(Icon, {
-    icon,
-    size: 5
-  }));
-  if (!hasActions) {
-    return button;
-  }
-  return /* @__PURE__ */ React7.createElement(DropdownMenu.Root, {
-    open: optionsMenuOpen,
-    onOpenChange: (nextOpen) => {
-      if (!nextOpen) {
-        suppressNextTooltip.current = true;
-      }
-      return setOptionsMenuOpen(nextOpen);
+  var _effect = _useSignals7();
+  try {
+    const { t } = useTranslation(translationKey);
+    const [optionsMenuOpen, setOptionsMenuOpen] = useState3(false);
+    const hasActions = actionGroups && actionGroups.length > 0;
+    const button = /* @__PURE__ */ React7.createElement(StackItemSigilButton, {
+      attendableId,
+      related,
+      isMenu: hasActions,
+      // TODO(wittjosiah): Better disabling of interactive styles when no action are available.
+      //   Remove underscore icon when no actions are available?
+      classNames: !hasActions && "cursor-default"
+    }, /* @__PURE__ */ React7.createElement("span", {
+      className: "sr-only"
+    }, triggerLabel), /* @__PURE__ */ React7.createElement(Icon, {
+      icon,
+      size: 5
+    }));
+    if (!hasActions) {
+      return button;
     }
-  }, /* @__PURE__ */ React7.createElement(DropdownMenu.Trigger, {
-    asChild: true,
-    ref: forwardedRef
-  }, button), /* @__PURE__ */ React7.createElement(DropdownMenu.Portal, null, /* @__PURE__ */ React7.createElement(DropdownMenu.Content, {
-    classNames: "z-[31]"
-  }, /* @__PURE__ */ React7.createElement(DropdownMenu.Viewport, null, actionGroups?.map((actions, index) => {
-    const separator = index > 0 ? /* @__PURE__ */ React7.createElement(DropdownMenu.Separator, null) : null;
-    return /* @__PURE__ */ React7.createElement(Fragment, {
-      key: index
-    }, separator, actions.map((action) => {
-      const shortcut = typeof action.properties.keyBinding === "string" ? action.properties.keyBinding : action.properties.keyBinding?.[getHostPlatform()];
-      const menuItemType = action.properties.menuItemType;
-      const Root = menuItemType === "toggle" ? DropdownMenu.CheckboxItem : DropdownMenu.Item;
-      return /* @__PURE__ */ React7.createElement(Root, {
-        key: action.id,
-        onClick: (event) => {
-          if (action.properties.disabled) {
-            return;
+    return /* @__PURE__ */ React7.createElement(DropdownMenu.Root, {
+      open: optionsMenuOpen,
+      onOpenChange: setOptionsMenuOpen
+    }, /* @__PURE__ */ React7.createElement(DropdownMenu.Trigger, {
+      asChild: true,
+      ref: forwardedRef
+    }, button), /* @__PURE__ */ React7.createElement(DropdownMenu.Portal, null, /* @__PURE__ */ React7.createElement(DropdownMenu.Content, {
+      classNames: "z-[31]"
+    }, /* @__PURE__ */ React7.createElement(DropdownMenu.Viewport, null, actionGroups?.map((actions, index) => {
+      const separator = index > 0 ? /* @__PURE__ */ React7.createElement(DropdownMenu.Separator, null) : null;
+      return /* @__PURE__ */ React7.createElement(Fragment, {
+        key: index
+      }, separator, actions.map((action) => {
+        const shortcut = typeof action.properties.keyBinding === "string" ? action.properties.keyBinding : action.properties.keyBinding?.[getHostPlatform()];
+        const menuItemType = action.properties.menuItemType;
+        const Root = menuItemType === "toggle" ? DropdownMenu.CheckboxItem : DropdownMenu.Item;
+        return /* @__PURE__ */ React7.createElement(Root, {
+          key: action.id,
+          onClick: (event) => {
+            if (action.properties.disabled) {
+              return;
+            }
+            event.stopPropagation();
+            setOptionsMenuOpen(false);
+            onAction?.(action);
+          },
+          classNames: "gap-2",
+          disabled: action.properties.disabled,
+          checked: menuItemType === "toggle" ? action.properties.isChecked : void 0,
+          ...action.properties?.testId && {
+            "data-testid": action.properties.testId
           }
-          event.stopPropagation();
-          suppressNextTooltip.current = true;
-          setOptionsMenuOpen(false);
-          onAction?.(action);
-        },
-        classNames: "gap-2",
-        disabled: action.properties.disabled,
-        checked: menuItemType === "toggle" ? action.properties.isChecked : void 0,
-        ...action.properties?.testId && {
-          "data-testid": action.properties.testId
-        }
-      }, /* @__PURE__ */ React7.createElement(Icon, {
-        icon: action.properties.icon ?? "ph--placeholder--regular",
-        size: 4
-      }), /* @__PURE__ */ React7.createElement("span", {
-        className: "grow truncate"
-      }, toLocalizedString(action.properties.label ?? "", t)), menuItemType === "toggle" && /* @__PURE__ */ React7.createElement(DropdownMenu.ItemIndicator, {
-        asChild: true
-      }, /* @__PURE__ */ React7.createElement(Icon, {
-        icon: "ph--check--regular",
-        size: 4
-      })), shortcut && /* @__PURE__ */ React7.createElement("span", {
-        className: mx4("shrink-0", descriptionText)
-      }, keySymbols(shortcut).join("")));
-    }));
-  }), children), /* @__PURE__ */ React7.createElement(DropdownMenu.Arrow, null))));
+        }, /* @__PURE__ */ React7.createElement(Icon, {
+          icon: action.properties.icon ?? "ph--placeholder--regular",
+          size: 4
+        }), /* @__PURE__ */ React7.createElement("span", {
+          className: "grow truncate"
+        }, toLocalizedString(action.properties.label ?? "", t)), menuItemType === "toggle" && /* @__PURE__ */ React7.createElement(DropdownMenu.ItemIndicator, {
+          asChild: true
+        }, /* @__PURE__ */ React7.createElement(Icon, {
+          icon: "ph--check--regular",
+          size: 4
+        })), shortcut && /* @__PURE__ */ React7.createElement("span", {
+          className: mx4("shrink-0", descriptionText)
+        }, keySymbols(shortcut).join("")));
+      }));
+    }), children), /* @__PURE__ */ React7.createElement(DropdownMenu.Arrow, null))));
+  } finally {
+    _effect.f();
+  }
 });
 
 // packages/ui/react-ui-stack/src/components/StackItem/StackItem.tsx
 var DEFAULT_HORIZONTAL_SIZE = 48;
 var DEFAULT_VERTICAL_SIZE = "min-content";
 var DEFAULT_EXTRINSIC_SIZE = DEFAULT_HORIZONTAL_SIZE;
-var StackItemRoot = /* @__PURE__ */ forwardRef5(({ item, children, classNames, size: propsSize, onSizeChange, role, order, style, disableRearrange, focusIndicatorVariant = "over-all", ...props }, forwardedRef) => {
-  const [itemElement, itemRef] = useState4(null);
-  const [selfDragHandleElement, selfDragHandleRef] = useState4(null);
-  const [closestEdge, setEdge] = useState4(null);
-  const { orientation, rail, onRearrange } = useStack();
-  const [size = orientation === "horizontal" ? DEFAULT_HORIZONTAL_SIZE : DEFAULT_VERTICAL_SIZE, setInternalSize] = useState4(propsSize);
-  const Root = role ?? "div";
-  const composedItemRef = composeRefs2(itemRef, forwardedRef);
-  const setSize = useCallback((nextSize, commit) => {
-    setInternalSize(nextSize);
-    if (commit) {
-      onSizeChange?.(nextSize);
-    }
-  }, [
-    onSizeChange
-  ]);
-  const type = orientation === "horizontal" ? "column" : "card";
-  useLayoutEffect2(() => {
-    if (!itemElement || !onRearrange || disableRearrange) {
-      return;
-    }
-    return combine2(draggable({
-      element: itemElement,
-      ...selfDragHandleElement && {
-        dragHandle: selfDragHandleElement
-      },
-      getInitialData: () => ({
-        id: item.id,
-        type
-      }),
-      onGenerateDragPreview: ({ nativeSetDragImage, source, location }) => {
-        document.body.setAttribute("data-drag-preview", "true");
-        scrollJustEnoughIntoView({
-          element: source.element
-        });
-        const { x, y } = preserveOffsetOnSource({
-          element: source.element,
-          input: location.current.input
-        })({
-          container: source.element.offsetParent ?? document.body
-        });
-        nativeSetDragImage?.(source.element, x, y);
-      },
-      onDragStart: () => {
-        document.body.removeAttribute("data-drag-preview");
-        itemElement?.closest("[data-drag-autoscroll]")?.setAttribute("data-drag-autoscroll", "active");
-      },
-      onDrop: () => {
-        itemElement?.closest("[data-drag-autoscroll]")?.setAttribute("data-drag-autoscroll", "idle");
+var StackItemRoot = /* @__PURE__ */ forwardRef5(({ item, children, classNames, size: propsSize, onSizeChange, role, order, prevSiblingId, nextSiblingId, style, disableRearrange, focusIndicatorVariant = "over-all", ...props }, forwardedRef) => {
+  var _effect = _useSignals8();
+  try {
+    const [itemElement, itemRef] = useState4(null);
+    const [selfDragHandleElement, selfDragHandleRef] = useState4(null);
+    const [closestEdge, setEdge] = useState4(null);
+    const [sourceId, setSourceId] = useState4(null);
+    const [dragState, setDragState] = useState4(idle);
+    const { orientation, rail, onRearrange } = useStack();
+    const [size = orientation === "horizontal" ? DEFAULT_HORIZONTAL_SIZE : DEFAULT_VERTICAL_SIZE, setInternalSize] = useState4(propsSize);
+    const Root = role ?? "div";
+    const composedItemRef = composeRefs2(itemRef, forwardedRef);
+    const setSize = useCallback2((nextSize, commit) => {
+      setInternalSize(nextSize);
+      if (commit) {
+        onSizeChange?.(nextSize);
+      }
+    }, [
+      onSizeChange
+    ]);
+    const type = orientation === "horizontal" ? "column" : "card";
+    useLayoutEffect2(() => {
+      if (!itemElement || !onRearrange || disableRearrange) {
+        return;
       }
-    }), dropTargetForElements2({
-      element: itemElement,
-      getData: ({ input, element }) => {
-        return attachClosestEdge2({
+      return combine2(draggable({
+        element: itemElement,
+        ...selfDragHandleElement && {
+          dragHandle: selfDragHandleElement
+        },
+        getInitialData: () => ({
           id: item.id,
           type
-        }, {
-          input,
-          element,
-          allowedEdges: orientation === "horizontal" ? [
-            "left",
-            "right"
-          ] : [
-            "top",
-            "bottom"
-          ]
-        });
-      },
-      onDragEnter: ({ self, source }) => {
-        if (source.data.type === self.data.type) {
-          setEdge(extractClosestEdge2(self.data));
-        }
-      },
-      onDrag: ({ self, source }) => {
-        if (source.data.type === self.data.type) {
-          setEdge(extractClosestEdge2(self.data));
+        }),
+        onGenerateDragPreview: ({ nativeSetDragImage, source, location }) => {
+          document.body.setAttribute("data-drag-preview", "true");
+          const offsetFn = preserveOffsetOnSource({
+            element: source.element,
+            input: location.current.input
+          });
+          const rect = source.element.getBoundingClientRect();
+          setCustomNativeDragPreview({
+            nativeSetDragImage,
+            getOffset: ({ container }) => {
+              return offsetFn({
+                container
+              });
+            },
+            render: ({ container }) => {
+              container.style.width = rect.width + "px";
+              setDragState({
+                type: "preview",
+                container,
+                item
+              });
+              return () => {
+              };
+            }
+          });
+        },
+        onDragStart: () => {
+          document.body.removeAttribute("data-drag-preview");
+          itemElement?.closest("[data-drag-autoscroll]")?.setAttribute("data-drag-autoscroll", "active");
+          setDragState({
+            type: "is-dragging",
+            item
+          });
+        },
+        onDrop: () => {
+          itemElement?.closest("[data-drag-autoscroll]")?.setAttribute("data-drag-autoscroll", "idle");
+          setDragState(idle);
         }
-      },
-      onDragLeave: () => setEdge(null),
-      onDrop: ({ self, source }) => {
-        setEdge(null);
-        if (source.data.type === self.data.type) {
-          onRearrange(source.data, self.data, extractClosestEdge2(self.data));
+      }), dropTargetForElements2({
+        element: itemElement,
+        getData: ({ input, element }) => {
+          return attachClosestEdge2({
+            id: item.id,
+            type
+          }, {
+            input,
+            element,
+            allowedEdges: orientation === "horizontal" ? [
+              "left",
+              "right"
+            ] : [
+              "top",
+              "bottom"
+            ]
+          });
+        },
+        onDragEnter: ({ self, source }) => {
+          if (source.data.type === self.data.type) {
+            setEdge(extractClosestEdge2(self.data));
+            setSourceId(source.data.id);
+          }
+        },
+        onDrag: ({ self, source }) => {
+          if (source.data.type === self.data.type) {
+            setEdge(extractClosestEdge2(self.data));
+            setSourceId(source.data.id);
+          }
+        },
+        onDragLeave: () => {
+          setEdge(null);
+          setSourceId(null);
+        },
+        onDrop: ({ self, source }) => {
+          setEdge(null);
+          setSourceId(null);
+          if (source.data.type === self.data.type) {
+            onRearrange(source.data, self.data, extractClosestEdge2(self.data));
+          }
         }
+      }));
+    }, [
+      orientation,
+      item,
+      onRearrange,
+      selfDragHandleElement,
+      itemElement
+    ]);
+    const focusableGroupAttrs = useFocusableGroup2({
+      tabBehavior: "limited"
+    });
+    const shouldShowDropIndicator = () => {
+      if (!closestEdge || !sourceId) {
+        return false;
       }
-    }));
-  }, [
-    orientation,
-    item,
-    onRearrange,
-    selfDragHandleElement,
-    itemElement
-  ]);
-  const focusableGroupAttrs = useFocusableGroup2({
-    tabBehavior: "limited"
-  });
-  return /* @__PURE__ */ React8.createElement(StackItemContext.Provider, {
-    value: {
-      selfDragHandleRef,
-      size,
-      setSize
-    }
-  }, /* @__PURE__ */ React8.createElement(Root, {
-    ...props,
-    tabIndex: 0,
-    ...focusableGroupAttrs,
-    className: mx5("group/stack-item grid relative", focusIndicatorVariant === "over-all" ? "dx-focus-ring-inset-over-all" : orientation === "horizontal" ? "dx-focus-ring-group-x" : "dx-focus-ring-group-y", orientation === "horizontal" ? "grid-rows-subgrid" : "grid-cols-subgrid", rail && (orientation === "horizontal" ? "row-span-2" : "col-span-2"), classNames),
-    "data-dx-stack-item": true,
-    ...resizeAttributes,
-    style: {
-      ...sizeStyle(size, orientation),
-      ...Number.isFinite(order) && {
-        [orientation === "horizontal" ? "gridColumn" : "gridRow"]: `${order}`
+      if (sourceId === item.id) {
+        return false;
+      }
+      const isTrailingEdgeOfPrevSibling = prevSiblingId !== void 0 && sourceId === prevSiblingId && (orientation === "horizontal" && closestEdge === "left" || orientation === "vertical" && closestEdge === "top");
+      if (isTrailingEdgeOfPrevSibling) {
+        return false;
+      }
+      const isLeadingEdgeOfNextSibling = nextSiblingId !== void 0 && sourceId === nextSiblingId && (orientation === "horizontal" && closestEdge === "right" || orientation === "vertical" && closestEdge === "bottom");
+      if (isLeadingEdgeOfNextSibling) {
+        return false;
+      }
+      return true;
+    };
+    return /* @__PURE__ */ React8.createElement(StackItemContext.Provider, {
+      value: {
+        selfDragHandleRef,
+        size,
+        setSize,
+        state: dragState,
+        setState: setDragState
+      }
+    }, /* @__PURE__ */ React8.createElement(Root, {
+      ...props,
+      tabIndex: 0,
+      ...focusableGroupAttrs,
+      className: mx5("group/stack-item grid relative", focusIndicatorVariant === "over-all" ? "dx-focus-ring-inset-over-all" : orientation === "horizontal" ? "dx-focus-ring-group-x" : "dx-focus-ring-group-y", orientation === "horizontal" ? "grid-rows-subgrid" : "grid-cols-subgrid", rail && (orientation === "horizontal" ? "row-span-2" : "col-span-2"), classNames),
+      "data-dx-stack-item": true,
+      ...resizeAttributes,
+      style: {
+        ...sizeStyle(size, orientation),
+        ...Number.isFinite(order) && {
+          [orientation === "horizontal" ? "gridColumn" : "gridRow"]: `${order}`
+        },
+        ...style
       },
-      ...style
-    },
-    ref: composedItemRef
-  }, children, closestEdge && /* @__PURE__ */ React8.createElement(ListItem2.DropIndicator, {
-    lineInset: 8,
-    terminalInset: -8,
-    edge: closestEdge
-  })));
+      ref: composedItemRef
+    }, children, shouldShowDropIndicator() && closestEdge && /* @__PURE__ */ React8.createElement(ListItem2.DropIndicator, {
+      lineInset: 8,
+      terminalInset: -8,
+      edge: closestEdge
+    })));
+  } finally {
+    _effect.f();
+  }
 });
+var StackItemDragPreview = ({ children }) => {
+  const { state } = useStackItem();
+  return state?.type === "preview" ? /* @__PURE__ */ createPortal(children({
+    item: state.item
+  }), state.container) : null;
+};
 var StackItem = {
   Root: StackItemRoot,
   Content: StackItemContent,
@@ -513,7 +643,8 @@ var StackItem = {
   ResizeHandle: StackItemResizeHandle,
   DragHandle: StackItemDragHandle,
   Sigil: StackItemSigil,
-  SigilButton: StackItemSigilButton
+  SigilButton: StackItemSigilButton,
+  DragPreview: StackItemDragPreview
 };
 export {
   DEFAULT_EXTRINSIC_SIZE,
@@ -522,6 +653,7 @@ export {
   Stack,
   StackContext,
   StackItem,
+  StackItemDragPreview,
   autoScrollRootAttributes,
   railGridHorizontal,
   railGridHorizontalContainFitContent,