@heymantle/litho 0.0.14 → 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);
         }
@@ -373,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/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, _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 = 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,
@@ -283,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;
@@ -292,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;
@@ -301,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)
@@ -314,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") {

package/dist/cjs/components/Table.js

@@ -28,6 +28,7 @@ var _Text = /*#__PURE__*/ _interop_require_default(require("./Text"));
 var _Tooltip = /*#__PURE__*/ _interop_require_default(require("./Tooltip"));
 var _Table = require("../styles/Table");
 var _useIndexResourceState = require("../utilities/useIndexResourceState");
+var _useMobile = require("../utilities/useMobile");
 var _useMounted = require("../utilities/useMounted");
 var _useTableScrollState = /*#__PURE__*/ _interop_require_default(require("../utilities/useTableScrollState"));
 function _array_like_to_array(arr, len) {
@@ -502,6 +503,8 @@ var TableWrapperContext = /*#__PURE__*/ (0, _react.createContext)({});
                     var alignment = cellAlignment[indexAdjusted];
                     var isSortable = sortable && sortable.length > 0 && sortable[indexAdjusted];
                     var sortIndex = selectable ? indexAdjusted - 1 : indexAdjusted;
+                    // Check if this cell is covered by a fixed overlay
+                    var isCovered = !fixed && !reverseColumns && (fixedFirstColumns > 0 && indexAdjusted < fixedFirstColumns || fixedLastColumns > 0 && indexAdjusted >= headings.length - fixedLastColumns);
                     var sortContent = isSortable ? /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
                         className: "min-h-5 ".concat(sort.index === sortIndex ? "opacity-100" : "opacity-0 group-hover:opacity-100"),
                         children: /*#__PURE__*/ (0, _jsxruntime.jsx)(_Icon.default, {
@@ -536,6 +539,7 @@ var TableWrapperContext = /*#__PURE__*/ (0, _react.createContext)({});
                             ].includes(alignment) && sortContent
                         ]
                     });
+                    var hasTooltip = (heading.tooltip || heading.tooltipContent) && !isCovered;
                     return /*#__PURE__*/ (0, _jsxruntime.jsx)(HeadingCell, {
                         className: _Table.styles.headingStyles({
                             hidden: hideCell,
@@ -553,7 +557,7 @@ var TableWrapperContext = /*#__PURE__*/ (0, _react.createContext)({});
                             className: _Table.styles.headingLabelContainerStyles({
                                 alignment: alignment
                             }),
-                            children: heading.hidden ? null : heading.tooltip || heading.tooltipContent ? /*#__PURE__*/ (0, _jsxruntime.jsx)(_Tooltip.default, {
+                            children: heading.hidden ? null : hasTooltip ? /*#__PURE__*/ (0, _jsxruntime.jsx)(_Tooltip.default, {
                                 content: heading.tooltip || heading.tooltipContent,
                                 preferredPosition: "above",
                                 children: labelContent
@@ -669,12 +673,16 @@ var TableWrapperContext = /*#__PURE__*/ (0, _react.createContext)({});
                     value: {
                         columnsToRender: columnsToRender,
                         reverseColumns: reverseColumns,
-                        hideCellsOnMobile: hideCellsOnMobile
+                        hideCellsOnMobile: hideCellsOnMobile,
+                        isFixedOverlay: fixed,
+                        fixedFirstColumns: fixedFirstColumns,
+                        fixedLastColumns: fixedLastColumns
                     },
                     children: /*#__PURE__*/ (0, _jsxruntime.jsxs)("table", {
                         className: _Table.styles.tableStyles(),
                         children: [
                             hasHeadings && renderHeadings({
+                                fixed: fixed,
                                 hidden: true,
                                 columnsToRender: columnsToRender,
                                 reverseColumns: reverseColumns,
@@ -807,7 +815,8 @@ var TableWrapperContext = /*#__PURE__*/ (0, _react.createContext)({});
             increasedTableDensity: increasedTableDensity,
             tableContainerRef: tableContainerRef,
             cellAlignment: cellAlignment,
-            noBodyCellPadding: noBodyCellPadding
+            noBodyCellPadding: noBodyCellPadding,
+            columnWidths: columnWidths
         },
         children: /*#__PURE__*/ (0, _jsxruntime.jsxs)("div", {
             "data-id": idRef.current,
@@ -858,8 +867,7 @@ var TableWrapperContext = /*#__PURE__*/ (0, _react.createContext)({});
                             children: renderTable({
                                 classes: "relative overflow-hidden",
                                 fixed: true,
-                                columnsToRender: fixedFirstColumns,
-                                hideCellsOnMobile: true
+                                columnsToRender: fixedFirstColumns
                             })
                         }) : /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
                             className: _Table.styles.overflowShadowStyles({
@@ -877,8 +885,7 @@ var TableWrapperContext = /*#__PURE__*/ (0, _react.createContext)({});
                                 classes: "relative overflow-hidden",
                                 fixed: true,
                                 columnsToRender: fixedLastColumns,
-                                reverseColumns: true,
-                                hideCellsOnMobile: true
+                                reverseColumns: true
                             })
                         }) : /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
                             className: _Table.styles.overflowShadowStyles({
@@ -1023,8 +1030,11 @@ Table.Row.displayName = "Table.Row";
  */ function Cell(param) {
     var tmp = param.alignment, _alignment = tmp === void 0 ? "start" : tmp, children = param.children, _param_selectionCell = param.selectionCell, selectionCell = _param_selectionCell === void 0 ? false : _param_selectionCell;
     var _useContext = (0, _react.useContext)(TableContext), cellAlignment = _useContext.cellAlignment, increasedTableDensity = _useContext.increasedTableDensity, selectable = _useContext.selectable, noBodyCellPadding = _useContext.noBodyCellPadding;
-    var _useContext1 = (0, _react.useContext)(TableWrapperContext), hideCellsOnMobile = _useContext1.hideCellsOnMobile, reverseColumns = _useContext1.reverseColumns, columnsToRender = _useContext1.columnsToRender;
+    var _useContext1 = (0, _react.useContext)(TableWrapperContext), hideCellsOnMobile = _useContext1.hideCellsOnMobile, reverseColumns = _useContext1.reverseColumns, columnsToRender = _useContext1.columnsToRender, isFixedOverlay = _useContext1.isFixedOverlay, fixedFirstColumns = _useContext1.fixedFirstColumns, fixedLastColumns = _useContext1.fixedLastColumns;
+    var isMobile = (0, _useMobile.useMobile)();
     var columnCount = (cellAlignment === null || cellAlignment === void 0 ? void 0 : cellAlignment.length) || 0;
+    // Use state instead of ref so changes trigger re-render
+    var _useState = _sliced_to_array((0, _react.useState)(-1), 2), cellIndex = _useState[0], setCellIndex = _useState[1];
     var cellIndexRef = (0, _react.useRef)(null);
     var setCellRef = (0, _react.useCallback)(function(node) {
         if (!node || cellIndexRef.current !== null) return;
@@ -1032,16 +1042,21 @@ Table.Row.displayName = "Table.Row";
         if ((parentRow === null || parentRow === void 0 ? void 0 : parentRow.tagName) === "TR") {
             var totalCells = parentRow.children.length;
             var index = node.cellIndex;
-            cellIndexRef.current = reverseColumns ? totalCells - columnsToRender + index - (totalCells - columnCount) : index;
+            var calculatedIndex = reverseColumns ? totalCells - columnsToRender + index - (totalCells - columnCount) : index;
+            cellIndexRef.current = calculatedIndex;
+            setCellIndex(calculatedIndex);
         }
     }, [
         reverseColumns,
         columnsToRender,
         columnCount
     ]);
-    var _cellIndexRef_current;
-    var cellIndex = (_cellIndexRef_current = cellIndexRef.current) !== null && _cellIndexRef_current !== void 0 ? _cellIndexRef_current : -1;
     var alignment = (cellAlignment === null || cellAlignment === void 0 ? void 0 : cellAlignment[cellIndex]) || _alignment;
+    // Check if this cell is covered by a fixed overlay
+    // When cellIndex is unknown (-1), conservatively assume the cell might be covered
+    // if there are any fixed columns. This prevents duplicate popovers during the
+    // brief window between initial render and when cellIndex is calculated.
+    var isCoveredByFixedOverlay = !isFixedOverlay && !reverseColumns && (cellIndex === -1 ? fixedFirstColumns > 0 || fixedLastColumns > 0 : fixedFirstColumns > 0 && cellIndex < fixedFirstColumns || fixedLastColumns > 0 && cellIndex >= columnCount - fixedLastColumns);
     return /*#__PURE__*/ (0, _jsxruntime.jsx)("td", {
         ref: setCellRef,
         className: _Table.styles.cellStyles({
@@ -1052,6 +1067,7 @@ Table.Row.displayName = "Table.Row";
             tableIsSelectable: selectable,
             noBodyCellPadding: noBodyCellPadding
         }),
+        inert: !isMobile && isCoveredByFixedOverlay || undefined,
         children: /*#__PURE__*/ (0, _jsxruntime.jsx)("div", {
             className: _Table.styles.cellContentStyles({
                 alignment: alignment