@heymantle/litho 0.0.13 → 0.0.15

package/README.md

@@ -107,6 +107,58 @@ Build a customer list page with search and filtering using Litho components.
 
 See **`AI_USAGE_IN_PROJECTS.md`** for detailed instructions on accessing guides and Storybook examples from projects using Litho as a dependency.
 
+## Visual Regression Testing
+
+Litho includes automated visual regression tests using Playwright to catch unintended UI changes.
+
+### Running Tests
+
+```bash
+# Run visual regression tests (uses Docker for CI parity)
+npm run test:visual:docker
+
+# Update baseline screenshots (uses Docker for CI parity)
+npm run test:visual:docker:update
+```
+
+> **Note:** The Docker commands ensure baselines match CI exactly. Native commands (`npm run test:visual`) are also available but may produce different results due to font rendering differences between macOS and Linux.
+
+### When Baselines Need Updating
+
+Update baselines when you've made **intentional** visual changes:
+- Modified component styles or layout
+- Changed default props or variants
+- Updated theme colors or typography
+- Added new visual states to existing components
+
+### Adding New Stories
+
+When you add a new component or story:
+1. The visual tests automatically discover all stories from Storybook
+2. Run `npm run test:visual:update` to generate baseline screenshots for new stories
+3. Commit the new baseline images in `tests/visual/stories.spec.js-snapshots/`
+
+### Skipped Stories
+
+Some stories are skipped because they contain non-deterministic content:
+- **Image stories** - Use random external images from picsum.photos
+- Add problematic stories to `SKIP_STORIES` in `tests/visual/stories.spec.js`
+
+### CI Integration
+
+Visual tests run automatically on PRs to `main`. If tests fail:
+1. Download the `visual-regression-diffs` artifact from the workflow
+2. Review the diff images to determine if changes are intentional
+3. If intentional, use the **Update Visual Baselines** workflow to regenerate baselines
+
+### Generating Baselines from CI
+
+Since macOS and Linux render fonts differently, generate baselines from CI for best results:
+
+1. Go to **Actions** → **Update Visual Baselines** → **Run workflow**
+2. The workflow will create a PR with updated baselines
+3. Review and merge the PR
+
 ## License
 
 MIT

package/dist/cjs/components/Card.js

@@ -516,7 +516,7 @@ var sectionBodyStyles = (0, _tailwindvariants.tv)({
 };
 Card.Section.displayName = "Card.Section";
 var clickableRowStyles = (0, _tailwindvariants.tv)({
-    base: "Litho-Card__Row py-1.5 px-2.5 cursor-pointer rounded-md hover:bg-tint-2 active:bg-tint-3",
+    base: "Litho-Card__Row py-1.5 px-2.5 @md:px-3 cursor-pointer rounded-md hover:bg-tint-2 active:bg-tint-3",
     variants: {
         disabled: {
             true: "opacity-50 cursor-not-allowed pointer-events-none"

package/dist/cjs/components/Disclosure.js

@@ -1,3 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return _default;
+    }
+});
+var _jsxruntime = require("react/jsx-runtime");
+var _tailwindvariants = require("tailwind-variants");
+var styles = (0, _tailwindvariants.tv)({
+    base: "Litho-Disclosure relative",
+    variants: {
+        flush: {
+            true: "pl-4",
+            false: "pl-7.5 @md:pl-7"
+        }
+    },
+    defaultVariants: {
+        flush: false
+    }
+});
+var borderStyles = (0, _tailwindvariants.tv)({
+    base: "Litho-Disclosure__Border absolute top-0 w-px h-full bg-tint-5 dark:bg-tint-alt-5",
+    variants: {
+        flush: {
+            true: "left-0.5",
+            false: "left-[9px]"
+        }
+    },
+    defaultVariants: {
+        flush: false
+    }
+});
 /**
  * Renders a Disclosure component that displays content with disclosure styling.
  *
@@ -18,25 +54,20 @@
  * <Disclosure className="mt-4">
  *   <Text>This is disclosure content with margin</Text>
  * </Disclosure>
- */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "default", {
-    enumerable: true,
-    get: function() {
-        return _default;
-    }
-});
-var _jsxruntime = require("react/jsx-runtime");
-function Disclosure() {
+ */ function Disclosure() {
     var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
-    var children = props.children, className = props.className;
+    var children = props.children, className = props.className, _props_flush = props.flush, flush = _props_flush === void 0 ? false : _props_flush;
+    var classes = styles({
+        flush: flush
+    });
+    var borderClasses = borderStyles({
+        flush: flush
+    });
     return /*#__PURE__*/ (0, _jsxruntime.jsxs)("div", {
-        className: "relative pl-7.5 @md:pl-7".concat(className ? " ".concat(className) : ""),
+        className: "".concat(classes).concat(className ? " ".concat(className) : ""),
         children: [
             /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
-                className: "absolute left-[9px] top-0 w-px h-full bg-tint-5 dark:bg-tint-alt-5"
+                className: borderClasses
             }),
             /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
                 children: children

package/dist/cjs/components/DropZone.js

@@ -84,6 +84,42 @@ function _unsupported_iterable_to_array(o, minLen) {
     if (n === "Map" || n === "Set") return Array.from(n);
     if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
 }
+var normalizeDropZoneAccept = function(accept) {
+    if (!accept) return [];
+    return typeof accept === "string" ? [
+        accept
+    ] : accept;
+};
+var isFileAcceptedForDropZone = function(file) {
+    var accept = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : [];
+    if (!accept || accept.length === 0) return true;
+    return accept.some(function(type) {
+        if (!type) return false;
+        if (type === "*/*") return true;
+        if (type.endsWith("/*")) {
+            var _type_split = _sliced_to_array(type.split("/"), 1), prefix = _type_split[0];
+            if (prefix === "*") return true;
+            return !!(file === null || file === void 0 ? void 0 : file.type) && file.type.startsWith("".concat(prefix, "/"));
+        }
+        return (file === null || file === void 0 ? void 0 : file.type) === type;
+    });
+};
+var partitionFilesByDropZoneAccept = function(files) {
+    var accept = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : [];
+    var acceptedFiles = [];
+    var rejectedFiles = [];
+    files.forEach(function(file) {
+        if (isFileAcceptedForDropZone(file, accept)) {
+            acceptedFiles.push(file);
+        } else {
+            rejectedFiles.push(file);
+        }
+    });
+    return {
+        acceptedFiles: acceptedFiles,
+        rejectedFiles: rejectedFiles
+    };
+};
 var dropZoneStyles = (0, _tailwindvariants.tv)({
     base: "Litho-DropZone w-full flex items-center justify-center p-4 border border-form-border border-dashed rounded-md focus:outline-hidden",
     variants: {
@@ -145,11 +181,7 @@ var dropZoneStyles = (0, _tailwindvariants.tv)({
  */ function DropZone() {
     var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
     var id = props.id, label = props.label, labelHidden = props.labelHidden, labelAction = props.labelAction, tooltip = props.tooltip, labelVariant = props.labelVariant, _props_type = props.type, type = _props_type === void 0 ? "file" : _props_type, _accept = props.accept, _props_allowMultiple = props.allowMultiple, allowMultiple = _props_allowMultiple === void 0 ? false : _props_allowMultiple, _props_showDropZoneWhenDisabled = props.showDropZoneWhenDisabled, showDropZoneWhenDisabled = _props_showDropZoneWhenDisabled === void 0 ? true : _props_showDropZoneWhenDisabled, _disabled = props.disabled, onDrop = props.onDrop, onDropAccepted = props.onDropAccepted, onDropRejected = props.onDropRejected, helpText = props.helpText, error = props.error, _props_uploading = props.uploading, uploading = _props_uploading === void 0 ? false : _props_uploading, _props_uploadedFiles = props.uploadedFiles, uploadedFiles = _props_uploadedFiles === void 0 ? [] : _props_uploadedFiles, _props_uploadLabel = props.uploadLabel, uploadLabel = _props_uploadLabel === void 0 ? "Drag and drop files or click to upload" : _props_uploadLabel, _props_uploadingLabel = props.uploadingLabel, uploadingLabel = _props_uploadingLabel === void 0 ? "Uploading..." : _props_uploadingLabel, _props_dragLabel = props.dragLabel, dragLabel = _props_dragLabel === void 0 ? "Release to upload" : _props_dragLabel, tmp = props.showFilePreview, _showFilePreview = tmp === void 0 ? true : tmp, previewLoading = props.previewLoading, _props_previewRows = props.previewRows, previewRows = _props_previewRows === void 0 ? 2 : _props_previewRows, onRemove = props.onRemove, onFilePreviewClick = props.onFilePreviewClick, filename = props.filename;
-    var accept = _accept ? typeof _accept === "string" ? [
-        _accept
-    ] : _accept : [
-        "*/*"
-    ];
+    var accept = normalizeDropZoneAccept(_accept);
     var inputRef = (0, _react.useRef)(null);
     var _useState = _sliced_to_array((0, _react.useState)(false), 2), hasFocusWithin = _useState[0], setHasFocusWithin = _useState[1];
     var _useState1 = _sliced_to_array((0, _react.useState)(false), 2), isDraggingOver = _useState1[0], setIsDraggingOver = _useState1[1];
@@ -210,22 +242,7 @@ var dropZoneStyles = (0, _tailwindvariants.tv)({
         setDragFileCount(0);
         if (disabled) return;
         var droppedFiles = Array.from(event.dataTransfer.files);
-        var acceptedFiles = [];
-        var rejectedFiles = [];
-        droppedFiles.forEach(function(file) {
-            var isValidType = typeAccept.length === 0 || typeAccept.some(function(type) {
-                if (type.endsWith("/*")) {
-                    return file.type.startsWith("".concat(type.split("/")[0], "/"));
-                }
-                return file.type === type;
-            });
-            var isValid = isValidType;
-            if (isValid) {
-                acceptedFiles.push(file);
-            } else {
-                rejectedFiles.push(file);
-            }
-        });
+        var _partitionFilesByDropZoneAccept = partitionFilesByDropZoneAccept(droppedFiles, typeAccept), acceptedFiles = _partitionFilesByDropZoneAccept.acceptedFiles, rejectedFiles = _partitionFilesByDropZoneAccept.rejectedFiles;
         if (onDrop) {
             onDrop(droppedFiles);
         }
@@ -238,22 +255,7 @@ var dropZoneStyles = (0, _tailwindvariants.tv)({
     };
     var handleFileChange = function(event) {
         var selectedFiles = Array.from(event.target.files);
-        var acceptedFiles = [];
-        var rejectedFiles = [];
-        selectedFiles.forEach(function(file) {
-            var isValidType = typeAccept.length === 0 || typeAccept.some(function(type) {
-                if (type.endsWith("/*")) {
-                    return file.type.startsWith("".concat(type.split("/")[0], "/"));
-                }
-                return file.type === type;
-            });
-            var isValid = isValidType;
-            if (isValid) {
-                acceptedFiles.push(file);
-            } else {
-                rejectedFiles.push(file);
-            }
-        });
+        var _partitionFilesByDropZoneAccept = partitionFilesByDropZoneAccept(selectedFiles, typeAccept), acceptedFiles = _partitionFilesByDropZoneAccept.acceptedFiles, rejectedFiles = _partitionFilesByDropZoneAccept.rejectedFiles;
         if (onDrop) {
             onDrop(selectedFiles);
         }
@@ -291,6 +293,10 @@ var dropZoneStyles = (0, _tailwindvariants.tv)({
                             }),
                             labelAction && /*#__PURE__*/ (0, _jsxruntime.jsx)(_Link.default, {
                                 onClick: labelAction.onAction,
+                                insight: labelAction.insight,
+                                icon: labelAction.insight ? _polarisicons.MagicMajor : undefined,
+                                color: labelAction.insight ? "insight" : undefined,
+                                disabled: labelAction.disabled,
                                 removeUnderline: true,
                                 children: labelAction.content
                             })
@@ -369,6 +375,56 @@ var dropZoneStyles = (0, _tailwindvariants.tv)({
         ]
     });
 }
+var DropTarget = function() {
+    var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
+    var _accept = props.accept, _props_allowMultiple = props.allowMultiple, allowMultiple = _props_allowMultiple === void 0 ? true : _props_allowMultiple, _props_disabled = props.disabled, disabled = _props_disabled === void 0 ? false : _props_disabled, onDrop = props.onDrop, onDropAccepted = props.onDropAccepted, onDropRejected = props.onDropRejected, className = props.className, dragOverClassName = props.dragOverClassName, children = props.children;
+    var accept = normalizeDropZoneAccept(_accept);
+    var _useState = _sliced_to_array((0, _react.useState)(false), 2), isDraggingOver = _useState[0], setIsDraggingOver = _useState[1];
+    var handleDragOver = function(event) {
+        event.preventDefault();
+        event.stopPropagation();
+        if (!disabled) {
+            setIsDraggingOver(true);
+        }
+    };
+    var handleDragLeave = function(event) {
+        event.preventDefault();
+        event.stopPropagation();
+        setIsDraggingOver(false);
+    };
+    var handleDrop = function(event) {
+        event.preventDefault();
+        event.stopPropagation();
+        setIsDraggingOver(false);
+        if (disabled) return;
+        var droppedFiles = Array.from(event.dataTransfer.files);
+        if (allowMultiple === false) {
+            droppedFiles = droppedFiles.slice(0, 1);
+        }
+        var _partitionFilesByDropZoneAccept = partitionFilesByDropZoneAccept(droppedFiles, accept), acceptedFiles = _partitionFilesByDropZoneAccept.acceptedFiles, rejectedFiles = _partitionFilesByDropZoneAccept.rejectedFiles;
+        if (onDrop) {
+            onDrop(droppedFiles);
+        }
+        if (onDropAccepted && acceptedFiles.length > 0) {
+            onDropAccepted(acceptedFiles);
+        }
+        if (onDropRejected && rejectedFiles.length > 0) {
+            onDropRejected(rejectedFiles);
+        }
+    };
+    var dropTargetClassName = [
+        className,
+        isDraggingOver && dragOverClassName
+    ].filter(Boolean).join(" ");
+    return /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
+        className: dropTargetClassName,
+        onDragOver: handleDragOver,
+        onDragLeave: handleDragLeave,
+        onDrop: handleDrop,
+        children: children
+    });
+};
+DropZone.DropTarget = DropTarget;
 var previewContainerStyles = (0, _tailwindvariants.tv)({
     base: "flex flex-col",
     variants: {

package/dist/cjs/components/Layout.js

@@ -211,11 +211,13 @@ var annotatedSectionStyles = (0, _tailwindvariants.tv)({
     var annotatedSectionClasses = annotatedSectionStyles({
         embedded: embedded
     });
+    var annotationColSpan = embedded ? "@md-embed:col-span-4" : "@md:col-span-4";
+    var contentColSpan = embedded ? "@md-embed:col-span-8" : "@md:col-span-8";
     return /*#__PURE__*/ (0, _jsxruntime.jsxs)("div", {
         className: annotatedSectionClasses,
         children: [
             /*#__PURE__*/ (0, _jsxruntime.jsxs)("div", {
-                className: "Litho-Layout__Annotation flex flex-col gap-1 @md:col-span-4 py-2",
+                className: "Litho-Layout__Annotation flex flex-col gap-1 ".concat(annotationColSpan, " py-2"),
                 children: [
                     title && (typeof title === "string" ? /*#__PURE__*/ (0, _jsxruntime.jsx)(_Text.default, {
                         variant: "headingMd",
@@ -228,7 +230,7 @@ var annotatedSectionStyles = (0, _tailwindvariants.tv)({
                 ]
             }),
             /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
-                className: "Litho-Layout__AnnotationContent @md:col-span-8",
+                className: "Litho-Layout__AnnotationContent ".concat(contentColSpan),
                 children: children
             })
         ]

package/dist/cjs/components/Modal.js

@@ -127,7 +127,16 @@ function _unsupported_iterable_to_array(o, minLen) {
 }
 var ModalContext = /*#__PURE__*/ (0, _react.createContext)(false);
 var containerStyles = (0, _tailwindvariants.tv)({
-    base: "Litho-ModalContainer fixed inset-0 block flex flex-col justify-end md:justify-center items-center pointer-events-none"
+    base: "Litho-ModalContainer fixed inset-0 block flex flex-col justify-end md:justify-center items-center pointer-events-none",
+    variants: {
+        hidden: {
+            true: "hidden opacity-0 pointer-events-none",
+            false: ""
+        }
+    },
+    defaultVariants: {
+        hidden: false
+    }
 });
 var styles = (0, _tailwindvariants.tv)({
     base: "Litho-Modal relative bg-surface-highest shadow-modal dark:shadow-modal-dark w-full mx-auto pointer-events-auto flex flex-col overflow-hidden",
@@ -206,7 +215,7 @@ var sectionStyles = (0, _tailwindvariants.tv)({
  * @returns {React.ReactPortal|null} The rendered modal component or null if not open.
  */ function Modal() {
     var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
-    var children = props.children, title = props.title, subtitle = props.subtitle, open = props.open, onClose = props.onClose, sectioned = props.sectioned, primaryAction = props.primaryAction, secondaryAction = props.secondaryAction, _props_secondaryActions = props.secondaryActions, secondaryActions = _props_secondaryActions === void 0 ? [] : _props_secondaryActions, destructiveAction = props.destructiveAction, loading = props.loading, _props_size = props.size, size = _props_size === void 0 ? "default" : _props_size, leftAccessory = props.leftAccessory, _props_hideCloseButton = props.hideCloseButton, hideCloseButton = _props_hideCloseButton === void 0 ? false : _props_hideCloseButton, backAction = props.backAction, zIndexOverride = props.zIndexOverride, _props_autoFocusFirstInput = props.autoFocusFirstInput, autoFocusFirstInput = _props_autoFocusFirstInput === void 0 ? true : _props_autoFocusFirstInput, bodyClassName = props.bodyClassName;
+    var children = props.children, title = props.title, subtitle = props.subtitle, open = props.open, _props_hidden = props.hidden, hidden = _props_hidden === void 0 ? false : _props_hidden, onClose = props.onClose, sectioned = props.sectioned, primaryAction = props.primaryAction, secondaryAction = props.secondaryAction, _props_secondaryActions = props.secondaryActions, secondaryActions = _props_secondaryActions === void 0 ? [] : _props_secondaryActions, destructiveAction = props.destructiveAction, loading = props.loading, _props_size = props.size, size = _props_size === void 0 ? "default" : _props_size, leftAccessory = props.leftAccessory, _props_hideCloseButton = props.hideCloseButton, hideCloseButton = _props_hideCloseButton === void 0 ? false : _props_hideCloseButton, backAction = props.backAction, zIndexOverride = props.zIndexOverride, _props_autoFocusFirstInput = props.autoFocusFirstInput, autoFocusFirstInput = _props_autoFocusFirstInput === void 0 ? true : _props_autoFocusFirstInput, bodyClassName = props.bodyClassName;
     var setModalIsOpen = (0, _Frame.useFrame)().setModalIsOpen;
     var modalContentRef = (0, _react.useRef)(null);
     var hasChildren = !!children;
@@ -214,7 +223,9 @@ var sectionStyles = (0, _tailwindvariants.tv)({
         sectioned: sectioned,
         size: size
     });
-    var containerClasses = containerStyles();
+    var containerClasses = containerStyles({
+        hidden: hidden
+    });
     var headerClasses = headerStyles({
         hasChildren: hasChildren
     });

package/dist/cjs/components/Navigation.js

@@ -9,6 +9,7 @@ Object.defineProperty(exports, "default", {
     }
 });
 var _jsxruntime = require("react/jsx-runtime");
+var _react = /*#__PURE__*/ _interop_require_default(require("react"));
 var _tailwindvariants = require("tailwind-variants");
 var _Badge = /*#__PURE__*/ _interop_require_default(require("./Badge"));
 var _Icon = /*#__PURE__*/ _interop_require_default(require("./Icon"));
@@ -240,7 +241,7 @@ var linkStyles = (0, _tailwindvariants.tv)({
                             })
                         ]
                     }),
-                    badge ? /*#__PURE__*/ (0, _jsxruntime.jsx)(_Badge.default, {
+                    badge ? /*#__PURE__*/ _react.default.isValidElement(badge) ? badge : /*#__PURE__*/ (0, _jsxruntime.jsx)(_Badge.default, {
                         status: badge.status,
                         children: badge.label
                     }) : external ? /*#__PURE__*/ (0, _jsxruntime.jsx)(_Icon.default, {
@@ -329,10 +330,10 @@ var subLinkStyles = (0, _tailwindvariants.tv)({
                     })
                 ]
             }),
-            badge && /*#__PURE__*/ (0, _jsxruntime.jsx)(_Badge.default, {
+            badge && /*#__PURE__*/ (_react.default.isValidElement(badge) ? badge : /*#__PURE__*/ (0, _jsxruntime.jsx)(_Badge.default, {
                 status: badge.status,
                 children: badge.label
-            }),
+            })),
             accessory
         ]
     });

package/dist/cjs/components/Popover.js

@@ -189,18 +189,23 @@ var styles = (0, _tailwindvariants.tv)({
  * @param {boolean} [props.sectioned=false] - Whether the popover content is sectioned with padding.
  * @param {string} [props.preferredAlignment="center"] - Preferred alignment for the popover (left, center, right).
  * @param {string} [props.preferredPosition="below"] - Preferred position for the popover (above, below, cover, left, right).
+ * @param {number} [props.horizontalOffset] - Custom horizontal offset in pixels to adjust the popover position.
  * @param {string} [props.className] - Additional class name for the popover.
  * @param {string} [props.containerClassName] - Additional class name for the popover container.
  * @returns {JSX.Element} The rendered popover component.
  */ function Popover() {
     var props = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
-    var activatorWrapper = props.activatorWrapper, _props_activatorDisplayType = props.activatorDisplayType, activatorDisplayType = _props_activatorDisplayType === void 0 ? "inline-block" : _props_activatorDisplayType, activator = props.activator, children = props.children, onClose = props.onClose, active = props.active, fixed = props.fixed, zIndexOverride = props.zIndexOverride, _props_sectioned = props.sectioned, sectioned = _props_sectioned === void 0 ? false : _props_sectioned, _props_preferredAlignment = props.preferredAlignment, preferredAlignment = _props_preferredAlignment === void 0 ? "center" : _props_preferredAlignment, _props_preferredPosition = props.preferredPosition, preferredPosition = _props_preferredPosition === void 0 ? "below" : _props_preferredPosition, _props_matchActivatorWidth = props.matchActivatorWidth, matchActivatorWidth = _props_matchActivatorWidth === void 0 ? false : _props_matchActivatorWidth, _props_maxWidth = props.maxWidth, maxWidth = _props_maxWidth === void 0 ? "default" : _props_maxWidth, className = props.className, containerClassName = props.containerClassName;
+    var activatorWrapper = props.activatorWrapper, _props_activatorDisplayType = props.activatorDisplayType, activatorDisplayType = _props_activatorDisplayType === void 0 ? "inline-block" : _props_activatorDisplayType, activator = props.activator, children = props.children, onClose = props.onClose, activeProp = props.active, fixed = props.fixed, zIndexOverride = props.zIndexOverride, _props_sectioned = props.sectioned, sectioned = _props_sectioned === void 0 ? false : _props_sectioned, _props_preferredAlignment = props.preferredAlignment, preferredAlignment = _props_preferredAlignment === void 0 ? "center" : _props_preferredAlignment, _props_preferredPosition = props.preferredPosition, preferredPosition = _props_preferredPosition === void 0 ? "below" : _props_preferredPosition, _props_horizontalOffset = props.horizontalOffset, horizontalOffset = _props_horizontalOffset === void 0 ? 0 : _props_horizontalOffset, _props_matchActivatorWidth = props.matchActivatorWidth, matchActivatorWidth = _props_matchActivatorWidth === void 0 ? false : _props_matchActivatorWidth, _props_maxWidth = props.maxWidth, maxWidth = _props_maxWidth === void 0 ? "default" : _props_maxWidth, className = props.className, containerClassName = props.containerClassName, _props_closeOnResize = props.closeOnResize, closeOnResize = _props_closeOnResize === void 0 ? true : _props_closeOnResize, _props_debounceResizeObserver = props.debounceResizeObserver, debounceResizeObserver = _props_debounceResizeObserver === void 0 ? false : _props_debounceResizeObserver, _props_usePortal = props.usePortal, usePortal = _props_usePortal === void 0 ? true : _props_usePortal;
     var ActivatorWrapper = activatorWrapper || "div";
     var idValue = (0, _react.useId)();
     var idRef = (0, _react.useRef)(idValue);
     var initialWidthRef = (0, _react.useRef)(null);
     var popoverRef = (0, _react.useRef)(null);
     var activatorRef = (0, _react.useRef)(null);
+    // Check if the activator is inside an inert element (e.g., table cells covered by fixed columns)
+    var isActivatorInert = activatorRef.current ? activatorRef.current.closest('[inert]') !== null : false;
+    // When disabled, prevent popover from opening
+    var active = isActivatorInert ? false : activeProp;
     var _useState = _sliced_to_array((0, _react.useState)(_object_spread({
         visibility: "hidden",
         opacity: 0,
@@ -210,6 +215,25 @@ var styles = (0, _tailwindvariants.tv)({
     }, zIndexOverride ? {
         zIndex: zIndexOverride
     } : {})), 2), popoverStyle = _useState[0], setPopoverStyle = _useState[1];
+    // Reset popover style to hidden when it becomes active - this prevents flash
+    // of stale position from previous open. useLayoutEffect ensures this happens
+    // synchronously before paint.
+    (0, _react.useLayoutEffect)(function() {
+        if (active) {
+            setPopoverStyle(_object_spread({
+                visibility: "hidden",
+                opacity: 0,
+                position: "absolute",
+                top: 0,
+                left: 0
+            }, zIndexOverride ? {
+                zIndex: zIndexOverride
+            } : {}));
+        }
+    }, [
+        active,
+        zIndexOverride
+    ]);
     (0, _react.useEffect)(function() {
         if (active) {
             _PopoverManager.default.open(idRef.current);
@@ -264,7 +288,7 @@ var styles = (0, _tailwindvariants.tv)({
                     } else if (preferredAlignment === "right") {
                         left = fixed ? activatorRect.right - popoverRect.width : activatorRect.right + window.scrollX - popoverRect.width;
                     } else if (preferredAlignment === "center") {
-                        left = fixed ? activatorRect.left + activatorRect.width / 2 - popoverRect.width / 2 : activatorRect.left + window.scrollX + activatorRect.width / 2 - popoverRect.width / 2;
+                        left = fixed ? activatorRect.left + activatorRect.width / 2 - popoverRect.width / 2 + horizontalOffset : activatorRect.left + window.scrollX + activatorRect.width / 2 - popoverRect.width / 2 + horizontalOffset;
                     }
                 } else if (position === "above") {
                     top = fixed ? activatorRect.top - popoverRect.height - TOP_SPACING : activatorRect.top + window.scrollY - popoverRect.height - TOP_SPACING;
@@ -273,7 +297,7 @@ var styles = (0, _tailwindvariants.tv)({
                     } else if (preferredAlignment === "right") {
                         left = fixed ? activatorRect.right - popoverRect.width : activatorRect.right + window.scrollX - popoverRect.width;
                     } else if (preferredAlignment === "center") {
-                        left = fixed ? activatorRect.left + activatorRect.width / 2 - popoverRect.width / 2 : activatorRect.left + window.scrollX + activatorRect.width / 2 - popoverRect.width / 2;
+                        left = fixed ? activatorRect.left + activatorRect.width / 2 - popoverRect.width / 2 + horizontalOffset : activatorRect.left + window.scrollX + activatorRect.width / 2 - popoverRect.width / 2 + horizontalOffset;
                     }
                 } else if (position === "cover") {
                     top = fixed ? activatorRect.top : activatorRect.top + window.scrollY;
@@ -282,7 +306,7 @@ var styles = (0, _tailwindvariants.tv)({
                     } else if (preferredAlignment === "right") {
                         left = fixed ? activatorRect.right - popoverRect.width : activatorRect.right + window.scrollX - popoverRect.width;
                     } else if (preferredAlignment === "center") {
-                        left = fixed ? activatorRect.left + activatorRect.width / 2 - popoverRect.width / 2 : activatorRect.left + window.scrollX + activatorRect.width / 2 - popoverRect.width / 2;
+                        left = fixed ? activatorRect.left + activatorRect.width / 2 - popoverRect.width / 2 + horizontalOffset : activatorRect.left + window.scrollX + activatorRect.width / 2 - popoverRect.width / 2 + horizontalOffset;
                     }
                 }
                 // Fallback adjustments for vertical positioning (when not in left/right mode)
@@ -295,11 +319,23 @@ var styles = (0, _tailwindvariants.tv)({
                     }
                 }
                 // Fallback adjustments for horizontal positioning
-                if (left + popoverRect.width > windowWidth) {
-                    left = windowWidth - popoverRect.width - EDGE_SPACING;
-                }
-                if (left < 0) {
-                    left = EDGE_SPACING;
+                // Only apply edge constraints if we're not using center alignment with custom offset
+                // This allows center alignment to work even near edges
+                if (preferredAlignment !== "center" || horizontalOffset === 0) {
+                    if (left + popoverRect.width > windowWidth) {
+                        left = windowWidth - popoverRect.width - EDGE_SPACING;
+                    }
+                    if (left < 0) {
+                        left = EDGE_SPACING;
+                    }
+                } else {
+                    // For center alignment with offset, still respect edges but try to maintain centering
+                    if (left + popoverRect.width > windowWidth) {
+                        left = Math.max(EDGE_SPACING, windowWidth - popoverRect.width - EDGE_SPACING);
+                    }
+                    if (left < 0) {
+                        left = EDGE_SPACING;
+                    }
                 }
                 // Fallback adjustments for vertical positioning (when in left/right mode)
                 if (position === "left" || position === "right") {
@@ -339,7 +375,8 @@ var styles = (0, _tailwindvariants.tv)({
             observer.disconnect();
         };
     }, [
-        active
+        active,
+        debounceResizeObserver
     ]);
     (0, _react.useLayoutEffect)(function() {
         if (!active || !popoverRef.current) return;
@@ -384,7 +421,7 @@ var styles = (0, _tailwindvariants.tv)({
             }
         };
         var handleResize = function handleResize() {
-            if (onClose) {
+            if (onClose && closeOnResize) {
                 onClose();
             }
         };
@@ -427,7 +464,15 @@ var styles = (0, _tailwindvariants.tv)({
                 className: "Litho-PopoverActivator ".concat(activatorDisplayType),
                 children: memoizedActivator
             }),
-            active && typeof children !== "undefined" && /*#__PURE__*/ (0, _reactdom.createPortal)(/*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
+            active && typeof children !== "undefined" && (usePortal ? /*#__PURE__*/ (0, _reactdom.createPortal)(/*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
+                className: "@container",
+                children: /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
+                    ref: popoverRef,
+                    style: popoverStyle,
+                    className: "".concat(classes).concat(className ? " ".concat(className) : ""),
+                    children: children
+                })
+            }), document.body) : /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
                 className: "@container",
                 children: /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
                     ref: popoverRef,
@@ -435,7 +480,7 @@ var styles = (0, _tailwindvariants.tv)({
                     className: "".concat(classes).concat(className ? " ".concat(className) : ""),
                     children: children
                 })
-            }), document.body)
+            }))
         ]
     });
 }

package/dist/cjs/components/Select.js

@@ -203,6 +203,10 @@ var contentStyles = (0, _tailwindvariants.tv)({
                     }),
                     labelAction && /*#__PURE__*/ (0, _jsxruntime.jsx)(_Link.default, {
                         onClick: labelAction.onAction,
+                        insight: labelAction.insight,
+                        icon: labelAction.insight ? _polarisicons.MagicMajor : undefined,
+                        color: labelAction.insight ? "insight" : undefined,
+                        disabled: labelAction.disabled,
                         removeUnderline: true,
                         children: labelAction.content
                     })