@cimpress-ui/react 0.1.0 → 0.3.0

package/dist/esm/components/table/hooks/use-table-cell.d.ts

@@ -0,0 +1,7 @@
+import { type RefObject } from 'react';
+import type { NativeElementProps } from '../../types.js';
+export interface UseTableCell {
+    cellProps: NativeElementProps<HTMLTableCellElement>;
+}
+export declare function useTableCell(ref: RefObject<HTMLTableCellElement | null>, rowKey: string, columnKey: string): UseTableCell;
+//# sourceMappingURL=use-table-cell.d.ts.map

package/dist/esm/components/table/hooks/use-table-cell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-table-cell.d.ts","sourceRoot":"","sources":["../../../../../src/components/table/hooks/use-table-cell.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqD,KAAK,SAAS,EAAa,MAAM,OAAO,CAAC;AACrG,OAAO,KAAK,EAAoB,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAM3E,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;CACrD;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,SAAS,CAAC,oBAAoB,GAAG,IAAI,CAAC,EAC3C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,YAAY,CAsJd"}

package/dist/esm/components/table/hooks/use-table-cell.js

@@ -0,0 +1,141 @@
+import { getFocusableTreeWalker, useFocusRing } from '@react-aria/focus';
+import { isFocusVisible } from '@react-aria/interactions';
+import { mergeProps, useEffectEvent, useLayoutEffect } from '@react-aria/utils';
+import { useEffect } from 'react';
+import { useTableFocus } from '../contexts/focus.js';
+import { useTableRowState } from '../contexts/row-state.js';
+import { useTableState } from '../contexts/table-state.js';
+import { focusTableChild } from '../utils/focus-table-child.js';
+export function useTableCell(ref, rowKey, columnKey) {
+    const tableFocus = useTableFocus();
+    const { pendingRowSelectionState, setPendingRowSelectionState } = useTableState();
+    const { onSelectionToggle } = useTableRowState();
+    const isTabbable = rowKey === tableFocus.focusedRowKey && columnKey === tableFocus.focusedColumnKey;
+    // Handles focusing the cell.
+    // If there is a focusable child, it is focused, otherwise the cell itself is focused.
+    const focusCell = () => {
+        if (!ref.current) {
+            return;
+        }
+        // If there's a pending selection state, apply it to this cell's row.
+        // If this cell is a header cell, `onSelectionToggle` will be undefined, but we still want to clear the pending selection state.
+        if (pendingRowSelectionState !== undefined) {
+            onSelectionToggle?.(pendingRowSelectionState);
+            setPendingRowSelectionState(undefined);
+        }
+        // If focus is already on a focusable child within the cell, early return so we don't shift focus
+        if (ref.current.contains(document.activeElement) && ref.current !== document.activeElement) {
+            return;
+        }
+        const treeWalker = getFocusableTreeWalker(ref.current);
+        const focusable = tableFocus.childFocusStrategy === 'last' ? treeWalker.lastChild() : treeWalker.firstChild();
+        if (focusable) {
+            // Cell has focusable children, focus the child
+            focusTableChild(focusable);
+        }
+        else if (!ref.current.contains(document.activeElement)) {
+            // Cell has no focusable children and current focus is outside of the cell, focus the cell itself
+            focusTableChild(ref.current);
+        }
+        else if (ref.current === document.activeElement && !isTabbable) {
+            // Focus is on the current cell, but table focus is elsewhere, update table focus state
+            tableFocus.setFocus(rowKey, columnKey);
+        }
+    };
+    // Focus the cell DOM node when table focus moves to this cell
+    useLayoutEffect(() => {
+        if (isTabbable && !ref.current.contains(document.activeElement)) {
+            focusCell();
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [ref, isTabbable]);
+    const resetIfFocused = useEffectEvent(() => {
+        if (isTabbable) {
+            tableFocus.setFocus('', '');
+        }
+    });
+    // Reset table focus when the focused cell unmounts
+    useEffect(() => () => {
+        resetIfFocused();
+    }, [resetIfFocused]);
+    const onFocus = (e) => {
+        // Ignore focus events bubbling through portals
+        if (!e.currentTarget.contains(e.target)) {
+            return;
+        }
+        // If cell is already focused, return early.
+        // However, if focus happens as a result of a press, we need to re-run the child-focusing logic,
+        // otherwise `useFocusRing` will force the cell itself to become focused.
+        if (e.currentTarget.contains(e.relatedTarget) && isFocusVisible()) {
+            return;
+        }
+        // There are 3 scenarios for why a cell might receive focus:
+        // - focus happens through a press, we need to update table focus state to the current cell
+        // - focus happens through arrow key navigation within the table,
+        //   we do nothing as table focus state would have already been updated earlier
+        // - focus happens through tabbing into the table from outside,
+        //   we do nothing because we want to restore focus to the previously focused cell,
+        //   and overriding table focus state would make that impossible
+        if (!isFocusVisible()) {
+            tableFocus.setFocus(rowKey, columnKey);
+        }
+        if (e.target === ref.current) {
+            // If the cell itself receives focus, wait a frame so that focus finishes propagating
+            // up to the tree, and move focus to a focusable child if possible.
+            requestAnimationFrame(() => {
+                if (document.activeElement === ref.current) {
+                    focusCell();
+                }
+            });
+        }
+    };
+    // Handles keyboard navigation between focusable children within the cell.
+    const onKeyDownCapture = (e) => {
+        // Ignore keyboard events bubbling through portals
+        if (!e.currentTarget.contains(e.target) || !ref.current || !document.activeElement) {
+            return;
+        }
+        const walker = getFocusableTreeWalker(ref.current);
+        walker.currentNode = document.activeElement;
+        if (e.key === 'ArrowLeft' || e.key === 'ArrowRight') {
+            // Move to the previous/next focusable element within the cell
+            const childElementToFocus = e.key === 'ArrowLeft' ? walker.previousNode() : walker.nextNode();
+            if (childElementToFocus && childElementToFocus !== ref.current) {
+                focusTableChild(childElementToFocus);
+            }
+            else {
+                // If there is no previous/next focusable element within the current cell, focus should move to the previous/next cell.
+                // This is handled by `useTable`, so we need to let the event bubble up to it.
+                // But we also don't want this event to reach children of the current cell, as arrow keys should be used exclusively for table navigation.
+                // Solution: re-dispatch the event from a parent element of the current cell.
+                ref.current.parentElement.dispatchEvent(new KeyboardEvent(e.nativeEvent.type, e.nativeEvent));
+            }
+        }
+        else if (e.key === 'ArrowUp' || e.key === 'ArrowDown') {
+            // Move to the previous/next cell in the current column.
+            // This is handled by `useTable`, so we need to let the event bubble up to it.
+            // But we also don't want this event to reach children of the current cell, as arrow keys should be used exclusively for table navigation.
+            // Solution: re-dispatch the event from a parent element of the current cell.
+            ref.current.parentElement?.dispatchEvent(new KeyboardEvent(e.nativeEvent.type, e.nativeEvent));
+        }
+        else {
+            // if we didn't handle anything, return early so we don't stop propagation and preventDefault
+            return;
+        }
+        e.preventDefault();
+        e.stopPropagation();
+    };
+    const { focusProps, isFocused } = useFocusRing();
+    const customProps = {
+        tabIndex: isTabbable ? 0 : -1,
+        onFocus,
+        onKeyDownCapture,
+        'data-cell-row-key': rowKey,
+        'data-cell-column-key': columnKey,
+        'data-focused': isFocused || undefined,
+    };
+    return {
+        cellProps: mergeProps(focusProps, customProps),
+    };
+}
+//# sourceMappingURL=use-table-cell.js.map

package/dist/esm/components/table/hooks/use-table-cell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-table-cell.js","sourceRoot":"","sources":["../../../../../src/components/table/hooks/use-table-cell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAqE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErG,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAMhE,MAAM,UAAU,YAAY,CAC1B,GAA2C,EAC3C,MAAc,EACd,SAAiB;IAEjB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,GAAG,aAAa,EAAE,CAAC;IAClF,MAAM,EAAE,iBAAiB,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAEjD,MAAM,UAAU,GAAG,MAAM,KAAK,UAAU,CAAC,aAAa,IAAI,SAAS,KAAK,UAAU,CAAC,gBAAgB,CAAC;IAEpG,6BAA6B;IAC7B,sFAAsF;IACtF,MAAM,SAAS,GAAG,GAAG,EAAE;QACrB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,qEAAqE;QACrE,gIAAgI;QAChI,IAAI,wBAAwB,KAAK,SAAS,EAAE,CAAC;YAC3C,iBAAiB,EAAE,CAAC,wBAAwB,CAAC,CAAC;YAC9C,2BAA2B,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;QAED,iGAAiG;QACjG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,aAAa,EAAE,CAAC;YAC3F,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,UAAU,CAAC,kBAAkB,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QAE9G,IAAI,SAAS,EAAE,CAAC;YACd,+CAA+C;YAC/C,eAAe,CAAC,SAA6B,CAAC,CAAC;QACjD,CAAC;aAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACzD,iGAAiG;YACjG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;aAAM,IAAI,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,aAAa,IAAI,CAAC,UAAU,EAAE,CAAC;YACjE,uFAAuF;YACvF,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC;IAEF,8DAA8D;IAC9D,eAAe,CAAC,GAAG,EAAE;QACnB,IAAI,UAAU,IAAI,CAAC,GAAG,CAAC,OAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACjE,SAAS,EAAE,CAAC;QACd,CAAC;QACD,uDAAuD;IACzD,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;IAEtB,MAAM,cAAc,GAAG,cAAc,CAAC,GAAG,EAAE;QACzC,IAAI,UAAU,EAAE,CAAC;YACf,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,mDAAmD;IACnD,SAAS,CACP,GAAG,EAAE,CAAC,GAAG,EAAE;QACT,cAAc,EAAE,CAAC;IACnB,CAAC,EACD,CAAC,cAAc,CAAC,CACjB,CAAC;IAEF,MAAM,OAAO,GAAsB,CAAC,CAAC,EAAE,EAAE;QACvC,+CAA+C;QAC/C,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QAED,4CAA4C;QAC5C,gGAAgG;QAChG,yEAAyE;QACzE,IAAI,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,cAAc,EAAE,EAAE,CAAC;YAClE,OAAO;QACT,CAAC;QAED,4DAA4D;QAC5D,2FAA2F;QAC3F,iEAAiE;QACjE,+EAA+E;QAC/E,+DAA+D;QAC/D,mFAAmF;QACnF,gEAAgE;QAChE,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YACtB,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;YAC7B,qFAAqF;YACrF,mEAAmE;YACnE,qBAAqB,CAAC,GAAG,EAAE;gBACzB,IAAI,QAAQ,CAAC,aAAa,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;oBAC3C,SAAS,EAAE,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;IAEF,0EAA0E;IAC1E,MAAM,gBAAgB,GAAyB,CAAC,CAAC,EAAE,EAAE;QACnD,kDAAkD;QAClD,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;YAC9F,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAC,aAAa,CAAC;QAE5C,IAAI,CAAC,CAAC,GAAG,KAAK,WAAW,IAAI,CAAC,CAAC,GAAG,KAAK,YAAY,EAAE,CAAC;YACpD,8DAA8D;YAC9D,MAAM,mBAAmB,GAAG,CAAC,CAAC,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAE9F,IAAI,mBAAmB,IAAI,mBAAmB,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC/D,eAAe,CAAC,mBAAuC,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,uHAAuH;gBACvH,8EAA8E;gBAC9E,0IAA0I;gBAC1I,6EAA6E;gBAC7E,GAAG,CAAC,OAAO,CAAC,aAAc,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;YACjG,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;YACxD,wDAAwD;YACxD,8EAA8E;YAC9E,0IAA0I;YAC1I,6EAA6E;YAC7E,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QACjG,CAAC;aAAM,CAAC;YACN,6FAA6F;YAC7F,OAAO;QACT,CAAC;QAED,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,CAAC,CAAC,eAAe,EAAE,CAAC;IACtB,CAAC,CAAC;IAEF,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,YAAY,EAAE,CAAC;IAEjD,MAAM,WAAW,GAA6C;QAC5D,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,OAAO;QACP,gBAAgB;QAChB,mBAAmB,EAAE,MAAM;QAC3B,sBAAsB,EAAE,SAAS;QACjC,cAAc,EAAE,SAAS,IAAI,SAAS;KACvC,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,UAAU,CAAC,UAAU,EAAE,WAAW,CAAC;KAC/C,CAAC;AACJ,CAAC","sourcesContent":["import { getFocusableTreeWalker, useFocusRing } from '@react-aria/focus';\nimport { isFocusVisible } from '@react-aria/interactions';\nimport { mergeProps, useEffectEvent, useLayoutEffect } from '@react-aria/utils';\nimport { type KeyboardEventHandler, type FocusEventHandler, type RefObject, useEffect } from 'react';\nimport type { FocusableElement, NativeElementProps } from '../../types.js';\nimport { useTableFocus } from '../contexts/focus.js';\nimport { useTableRowState } from '../contexts/row-state.js';\nimport { useTableState } from '../contexts/table-state.js';\nimport { focusTableChild } from '../utils/focus-table-child.js';\n\nexport interface UseTableCell {\n  cellProps: NativeElementProps<HTMLTableCellElement>;\n}\n\nexport function useTableCell(\n  ref: RefObject<HTMLTableCellElement | null>,\n  rowKey: string,\n  columnKey: string,\n): UseTableCell {\n  const tableFocus = useTableFocus();\n  const { pendingRowSelectionState, setPendingRowSelectionState } = useTableState();\n  const { onSelectionToggle } = useTableRowState();\n\n  const isTabbable = rowKey === tableFocus.focusedRowKey && columnKey === tableFocus.focusedColumnKey;\n\n  // Handles focusing the cell.\n  // If there is a focusable child, it is focused, otherwise the cell itself is focused.\n  const focusCell = () => {\n    if (!ref.current) {\n      return;\n    }\n\n    // If there's a pending selection state, apply it to this cell's row.\n    // If this cell is a header cell, `onSelectionToggle` will be undefined, but we still want to clear the pending selection state.\n    if (pendingRowSelectionState !== undefined) {\n      onSelectionToggle?.(pendingRowSelectionState);\n      setPendingRowSelectionState(undefined);\n    }\n\n    // If focus is already on a focusable child within the cell, early return so we don't shift focus\n    if (ref.current.contains(document.activeElement) && ref.current !== document.activeElement) {\n      return;\n    }\n\n    const treeWalker = getFocusableTreeWalker(ref.current);\n    const focusable = tableFocus.childFocusStrategy === 'last' ? treeWalker.lastChild() : treeWalker.firstChild();\n\n    if (focusable) {\n      // Cell has focusable children, focus the child\n      focusTableChild(focusable as FocusableElement);\n    } else if (!ref.current.contains(document.activeElement)) {\n      // Cell has no focusable children and current focus is outside of the cell, focus the cell itself\n      focusTableChild(ref.current);\n    } else if (ref.current === document.activeElement && !isTabbable) {\n      // Focus is on the current cell, but table focus is elsewhere, update table focus state\n      tableFocus.setFocus(rowKey, columnKey);\n    }\n  };\n\n  // Focus the cell DOM node when table focus moves to this cell\n  useLayoutEffect(() => {\n    if (isTabbable && !ref.current!.contains(document.activeElement)) {\n      focusCell();\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [ref, isTabbable]);\n\n  const resetIfFocused = useEffectEvent(() => {\n    if (isTabbable) {\n      tableFocus.setFocus('', '');\n    }\n  });\n\n  // Reset table focus when the focused cell unmounts\n  useEffect(\n    () => () => {\n      resetIfFocused();\n    },\n    [resetIfFocused],\n  );\n\n  const onFocus: FocusEventHandler = (e) => {\n    // Ignore focus events bubbling through portals\n    if (!e.currentTarget.contains(e.target)) {\n      return;\n    }\n\n    // If cell is already focused, return early.\n    // However, if focus happens as a result of a press, we need to re-run the child-focusing logic,\n    // otherwise `useFocusRing` will force the cell itself to become focused.\n    if (e.currentTarget.contains(e.relatedTarget) && isFocusVisible()) {\n      return;\n    }\n\n    // There are 3 scenarios for why a cell might receive focus:\n    // - focus happens through a press, we need to update table focus state to the current cell\n    // - focus happens through arrow key navigation within the table,\n    //   we do nothing as table focus state would have already been updated earlier\n    // - focus happens through tabbing into the table from outside,\n    //   we do nothing because we want to restore focus to the previously focused cell,\n    //   and overriding table focus state would make that impossible\n    if (!isFocusVisible()) {\n      tableFocus.setFocus(rowKey, columnKey);\n    }\n\n    if (e.target === ref.current) {\n      // If the cell itself receives focus, wait a frame so that focus finishes propagating\n      // up to the tree, and move focus to a focusable child if possible.\n      requestAnimationFrame(() => {\n        if (document.activeElement === ref.current) {\n          focusCell();\n        }\n      });\n    }\n  };\n\n  // Handles keyboard navigation between focusable children within the cell.\n  const onKeyDownCapture: KeyboardEventHandler = (e) => {\n    // Ignore keyboard events bubbling through portals\n    if (!e.currentTarget.contains(e.target as Element) || !ref.current || !document.activeElement) {\n      return;\n    }\n\n    const walker = getFocusableTreeWalker(ref.current);\n    walker.currentNode = document.activeElement;\n\n    if (e.key === 'ArrowLeft' || e.key === 'ArrowRight') {\n      // Move to the previous/next focusable element within the cell\n      const childElementToFocus = e.key === 'ArrowLeft' ? walker.previousNode() : walker.nextNode();\n\n      if (childElementToFocus && childElementToFocus !== ref.current) {\n        focusTableChild(childElementToFocus as FocusableElement);\n      } else {\n        // If there is no previous/next focusable element within the current cell, focus should move to the previous/next cell.\n        // This is handled by `useTable`, so we need to let the event bubble up to it.\n        // But we also don't want this event to reach children of the current cell, as arrow keys should be used exclusively for table navigation.\n        // Solution: re-dispatch the event from a parent element of the current cell.\n        ref.current.parentElement!.dispatchEvent(new KeyboardEvent(e.nativeEvent.type, e.nativeEvent));\n      }\n    } else if (e.key === 'ArrowUp' || e.key === 'ArrowDown') {\n      // Move to the previous/next cell in the current column.\n      // This is handled by `useTable`, so we need to let the event bubble up to it.\n      // But we also don't want this event to reach children of the current cell, as arrow keys should be used exclusively for table navigation.\n      // Solution: re-dispatch the event from a parent element of the current cell.\n      ref.current.parentElement?.dispatchEvent(new KeyboardEvent(e.nativeEvent.type, e.nativeEvent));\n    } else {\n      // if we didn't handle anything, return early so we don't stop propagation and preventDefault\n      return;\n    }\n\n    e.preventDefault();\n    e.stopPropagation();\n  };\n\n  const { focusProps, isFocused } = useFocusRing();\n\n  const customProps: NativeElementProps<HTMLTableCellElement> = {\n    tabIndex: isTabbable ? 0 : -1,\n    onFocus,\n    onKeyDownCapture,\n    'data-cell-row-key': rowKey,\n    'data-cell-column-key': columnKey,\n    'data-focused': isFocused || undefined,\n  };\n\n  return {\n    cellProps: mergeProps(focusProps, customProps),\n  };\n}\n"]}

package/dist/esm/components/table/hooks/use-table.d.ts

@@ -0,0 +1,7 @@
+import type { RefObject } from 'react';
+import type { NativeElementProps } from '../../types.js';
+export interface UseTable {
+    tableProps: NativeElementProps<HTMLTableElement>;
+}
+export declare function useTable(ref: RefObject<HTMLTableElement | null>): UseTable;
+//# sourceMappingURL=use-table.d.ts.map

package/dist/esm/components/table/hooks/use-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-table.d.ts","sourceRoot":"","sources":["../../../../../src/components/table/hooks/use-table.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAqB,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,KAAK,EAAoB,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAK3E,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;CAClD;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,QAAQ,CAkK1E"}

package/dist/esm/components/table/hooks/use-table.js

@@ -0,0 +1,153 @@
+import { getFocusableTreeWalker, useFocusable } from '@react-aria/focus';
+import { getInteractionModality, useKeyboard } from '@react-aria/interactions';
+import { isCtrlKeyPressed, mergeProps } from '@react-aria/utils';
+import { useTableFocus } from '../contexts/focus.js';
+import { useTableState } from '../contexts/table-state.js';
+import { focusTableChild } from '../utils/focus-table-child.js';
+export function useTable(ref) {
+    const tableFocus = useTableFocus();
+    const { rowSelectionMode, onAllRowsSelectionToggle } = useTableState();
+    const restoreCellFocus = (e) => {
+        if (!tableFocus.focusedRowKey || !tableFocus.focusedColumnKey) {
+            // User hasn't interacted with the table yet.
+            // Focus the first or last cell, depending on which direction the user is tabbing from.
+            const lastFocusedElement = e.relatedTarget;
+            const cellElements = e.currentTarget.querySelectorAll('[data-cell-row-key][data-cell-column-key]');
+            let cellElementToFocus;
+            if (lastFocusedElement &&
+                e.currentTarget.compareDocumentPosition(lastFocusedElement) & Node.DOCUMENT_POSITION_FOLLOWING) {
+                cellElementToFocus = cellElements[cellElements.length - 1];
+            }
+            else {
+                cellElementToFocus = cellElements[0];
+            }
+            const { cellRowKey, cellColumnKey } = cellElementToFocus.dataset;
+            // We know the keys are defined, because we queried the DOM for elements that have them
+            tableFocus.setFocus(cellRowKey, cellColumnKey);
+        }
+        else {
+            const element = e.currentTarget.querySelector(`[data-cell-row-key='${CSS.escape(tableFocus.focusedRowKey)}'][data-cell-column-key='${CSS.escape(tableFocus.focusedColumnKey)}']`);
+            if (element) {
+                // If focus is already within the cell, don't refocus
+                if (!element.contains(document.activeElement)) {
+                    focusTableChild(element);
+                }
+            }
+        }
+    };
+    const { focusableProps } = useFocusable({
+        onFocus: (e) => {
+            // Ignore focus events bubbling through portals
+            if (!e.currentTarget.contains(e.target)) {
+                return;
+            }
+            restoreCellFocus(e);
+        },
+    }, ref);
+    const { keyboardProps } = useKeyboard({
+        onKeyDown: (e) => {
+            // Ignore keyboard events bubbling through portals
+            if (!e.currentTarget.contains(e.target)) {
+                return;
+            }
+            const focusedCellElement = e.currentTarget.querySelector(`[data-cell-row-key='${CSS.escape(tableFocus.focusedRowKey)}'][data-cell-column-key='${CSS.escape(tableFocus.focusedColumnKey)}']`);
+            let cellElementToFocus = null;
+            let newChildFocusStrategy;
+            if (e.key === 'ArrowLeft' || e.key === 'ArrowRight') {
+                // Focus previous/next cell in the same row
+                const selector = `[data-cell-row-key='${CSS.escape(tableFocus.focusedRowKey)}']:not([data-cell-column-key='${CSS.escape(tableFocus.focusedColumnKey)}'])`;
+                const walker = getFocusableTreeWalker(e.currentTarget, { accept: (node) => node.matches(selector) });
+                walker.currentNode = focusedCellElement;
+                cellElementToFocus = e.key === 'ArrowLeft' ? walker.previousNode() : walker.nextNode();
+                newChildFocusStrategy = e.key === 'ArrowLeft' ? 'last' : 'first';
+            }
+            else if (e.key === 'ArrowUp' || e.key === 'ArrowDown') {
+                // Focus previous/next cell in the same column
+                const selector = constructColumnSelector(e.currentTarget, tableFocus.focusedRowKey, tableFocus.focusedColumnKey);
+                const walker = getFocusableTreeWalker(e.currentTarget, { accept: (node) => node.matches(selector) });
+                walker.currentNode = focusedCellElement;
+                cellElementToFocus = e.key === 'ArrowUp' ? walker.previousNode() : walker.nextNode();
+            }
+            else if (e.key === 'PageUp' || e.key === 'PageDown') {
+                // Move focus up/down by 5 rows
+                const selector = constructColumnSelector(e.currentTarget, tableFocus.focusedRowKey, tableFocus.focusedColumnKey);
+                const walker = getFocusableTreeWalker(e.currentTarget, { accept: (node) => node.matches(selector) });
+                walker.currentNode = focusedCellElement;
+                const advance = e.key === 'PageUp' ? walker.previousNode.bind(walker) : walker.nextNode.bind(walker);
+                // `advance()` will do nothing if there's no appropriate node found, so it's safe to just call it 5 times
+                for (let i = 0; i < 5; i++) {
+                    advance();
+                }
+                cellElementToFocus = walker.currentNode;
+            }
+            else if (e.key === 'Home' || e.key === 'End') {
+                // If Ctrl/Cmd is pressed, move focus to the first/last cell of the table;
+                // otherwise, move focus to the first/last cell of the current row
+                const selector = '[data-cell-row-key][data-cell-column-key]';
+                const walker = getFocusableTreeWalker(e.currentTarget, { accept: (node) => node.matches(selector) });
+                walker.currentNode = isCtrlKeyPressed(e) ? e.currentTarget : focusedCellElement.parentElement;
+                cellElementToFocus = e.key === 'Home' ? walker.firstChild() : walker.lastChild();
+                newChildFocusStrategy = e.key === 'Home' ? 'first' : 'last';
+            }
+            else if (e.key === 'Tab') {
+                // Table is supposed to be a single Tab stop, but cells may contain elements that are tabbable (checkboxes, buttons, menus, etc.).
+                // We don't control the rendering of these elements, so we can't override their tabIndex to prevent tabbing.
+                // Instead, we detect when Tab key is pressed, and move focus manually to the guard element before/after the table,
+                // so that the browser default behavior will apply starting from that element rather than the currently focused one.
+                const tableElement = e.currentTarget;
+                const guardElement = e.shiftKey ? tableElement.previousElementSibling : tableElement.nextElementSibling;
+                if (guardElement) {
+                    focusTableChild(guardElement);
+                }
+                return;
+            }
+            else if (e.key === 'a' && isCtrlKeyPressed(e) && rowSelectionMode === 'multiple') {
+                // Select all rows
+                onAllRowsSelectionToggle?.(true);
+            }
+            else {
+                // if we didn't handle anything, return early so we don't preventDefault
+                return;
+            }
+            if (cellElementToFocus) {
+                const { cellRowKey, cellColumnKey } = cellElementToFocus.dataset;
+                // We know the keys are defined, because we queried the DOM for elements that have them
+                tableFocus.setFocus(cellRowKey, cellColumnKey, newChildFocusStrategy);
+            }
+            e.preventDefault();
+        },
+    });
+    const customProps = {
+        role: 'grid',
+        // If no cell is tabbable within the table, make the table itself tabbable,
+        // otherwise the Tab key will just skip it
+        tabIndex: tableFocus.focusedRowKey && tableFocus.focusedColumnKey ? -1 : 0,
+        onFocusCapture: (e) => {
+            // If we're navigating into the table with a keyboard, focus the last focused cell instead of the first tabbable element
+            if (getInteractionModality() === 'keyboard' &&
+                !e.currentTarget.contains(e.relatedTarget) &&
+                e.currentTarget.contains(e.target)) {
+                restoreCellFocus(e);
+            }
+        },
+    };
+    return {
+        tableProps: mergeProps(focusableProps, keyboardProps, customProps),
+    };
+}
+/** Constructs a DOM selector for cells in the same column, taking `colspan` into account. */
+function constructColumnSelector(tableElement, rowKey, columnKey) {
+    const baseSelector = `[data-cell-column-key='${CSS.escape(columnKey)}']:not([data-cell-row-key='${CSS.escape(rowKey)}'])`;
+    const columnHeader = tableElement.querySelector(`th[data-cell-row-key='${CSS.escape(rowKey)}'][data-cell-column-key='${CSS.escape(columnKey)}']`);
+    const columnSelectors = [baseSelector];
+    let currentColumn = columnHeader?.previousElementSibling;
+    while (currentColumn) {
+        const { cellColumnKey } = currentColumn.dataset;
+        if (cellColumnKey) {
+            columnSelectors.push(`[data-cell-column-key='${CSS.escape(cellColumnKey)}'][colspan]:not([data-cell-row-key='${CSS.escape(rowKey)}'])`);
+        }
+        currentColumn = currentColumn.previousElementSibling;
+    }
+    return `:is(${columnSelectors.join(', ')})`;
+}
+//# sourceMappingURL=use-table.js.map

package/dist/esm/components/table/hooks/use-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-table.js","sourceRoot":"","sources":["../../../../../src/components/table/hooks/use-table.ts"],"names":[],"mappings":"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","sourcesContent":["import { getFocusableTreeWalker, useFocusable } from '@react-aria/focus';\nimport { getInteractionModality, useKeyboard } from '@react-aria/interactions';\nimport { isCtrlKeyPressed, mergeProps } from '@react-aria/utils';\nimport type { FocusEventHandler, RefObject } from 'react';\nimport type { FocusableElement, NativeElementProps } from '../../types.js';\nimport { type ChildFocusStrategy, useTableFocus } from '../contexts/focus.js';\nimport { useTableState } from '../contexts/table-state.js';\nimport { focusTableChild } from '../utils/focus-table-child.js';\n\nexport interface UseTable {\n  tableProps: NativeElementProps<HTMLTableElement>;\n}\n\nexport function useTable(ref: RefObject<HTMLTableElement | null>): UseTable {\n  const tableFocus = useTableFocus();\n  const { rowSelectionMode, onAllRowsSelectionToggle } = useTableState();\n\n  const restoreCellFocus: FocusEventHandler = (e) => {\n    if (!tableFocus.focusedRowKey || !tableFocus.focusedColumnKey) {\n      // User hasn't interacted with the table yet.\n      // Focus the first or last cell, depending on which direction the user is tabbing from.\n      const lastFocusedElement = e.relatedTarget as Element;\n      const cellElements = e.currentTarget.querySelectorAll('[data-cell-row-key][data-cell-column-key]');\n      let cellElementToFocus: Element | undefined;\n\n      if (\n        lastFocusedElement &&\n        e.currentTarget.compareDocumentPosition(lastFocusedElement) & Node.DOCUMENT_POSITION_FOLLOWING\n      ) {\n        cellElementToFocus = cellElements[cellElements.length - 1];\n      } else {\n        cellElementToFocus = cellElements[0];\n      }\n\n      const { cellRowKey, cellColumnKey } = (cellElementToFocus as HTMLTableCellElement).dataset;\n\n      // We know the keys are defined, because we queried the DOM for elements that have them\n      tableFocus.setFocus(cellRowKey!, cellColumnKey!);\n    } else {\n      const element = e.currentTarget.querySelector(\n        `[data-cell-row-key='${CSS.escape(tableFocus.focusedRowKey)}'][data-cell-column-key='${CSS.escape(tableFocus.focusedColumnKey)}']`,\n      ) as HTMLTableCellElement;\n\n      if (element) {\n        // If focus is already within the cell, don't refocus\n        if (!element.contains(document.activeElement)) {\n          focusTableChild(element);\n        }\n      }\n    }\n  };\n\n  const { focusableProps } = useFocusable(\n    {\n      onFocus: (e) => {\n        // Ignore focus events bubbling through portals\n        if (!e.currentTarget.contains(e.target)) {\n          return;\n        }\n\n        restoreCellFocus(e);\n      },\n    },\n    ref,\n  );\n\n  const { keyboardProps } = useKeyboard({\n    onKeyDown: (e) => {\n      // Ignore keyboard events bubbling through portals\n      if (!e.currentTarget.contains(e.target)) {\n        return;\n      }\n\n      const focusedCellElement = e.currentTarget.querySelector(\n        `[data-cell-row-key='${CSS.escape(tableFocus.focusedRowKey)}'][data-cell-column-key='${CSS.escape(tableFocus.focusedColumnKey)}']`,\n      ) as HTMLTableCellElement;\n\n      let cellElementToFocus: Node | null = null;\n      let newChildFocusStrategy: ChildFocusStrategy | undefined;\n\n      if (e.key === 'ArrowLeft' || e.key === 'ArrowRight') {\n        // Focus previous/next cell in the same row\n        const selector = `[data-cell-row-key='${CSS.escape(tableFocus.focusedRowKey)}']:not([data-cell-column-key='${CSS.escape(tableFocus.focusedColumnKey)}'])`;\n        const walker = getFocusableTreeWalker(e.currentTarget, { accept: (node) => node.matches(selector) });\n        walker.currentNode = focusedCellElement;\n        cellElementToFocus = e.key === 'ArrowLeft' ? walker.previousNode() : walker.nextNode();\n        newChildFocusStrategy = e.key === 'ArrowLeft' ? 'last' : 'first';\n      } else if (e.key === 'ArrowUp' || e.key === 'ArrowDown') {\n        // Focus previous/next cell in the same column\n        const selector = constructColumnSelector(\n          e.currentTarget,\n          tableFocus.focusedRowKey,\n          tableFocus.focusedColumnKey,\n        );\n        const walker = getFocusableTreeWalker(e.currentTarget, { accept: (node) => node.matches(selector) });\n        walker.currentNode = focusedCellElement;\n        cellElementToFocus = e.key === 'ArrowUp' ? walker.previousNode() : walker.nextNode();\n      } else if (e.key === 'PageUp' || e.key === 'PageDown') {\n        // Move focus up/down by 5 rows\n        const selector = constructColumnSelector(\n          e.currentTarget,\n          tableFocus.focusedRowKey,\n          tableFocus.focusedColumnKey,\n        );\n        const walker = getFocusableTreeWalker(e.currentTarget, { accept: (node) => node.matches(selector) });\n        walker.currentNode = focusedCellElement;\n\n        const advance = e.key === 'PageUp' ? walker.previousNode.bind(walker) : walker.nextNode.bind(walker);\n\n        // `advance()` will do nothing if there's no appropriate node found, so it's safe to just call it 5 times\n        for (let i = 0; i < 5; i++) {\n          advance();\n        }\n\n        cellElementToFocus = walker.currentNode;\n      } else if (e.key === 'Home' || e.key === 'End') {\n        // If Ctrl/Cmd is pressed, move focus to the first/last cell of the table;\n        // otherwise, move focus to the first/last cell of the current row\n        const selector = '[data-cell-row-key][data-cell-column-key]';\n        const walker = getFocusableTreeWalker(e.currentTarget, { accept: (node) => node.matches(selector) });\n        walker.currentNode = isCtrlKeyPressed(e) ? e.currentTarget : focusedCellElement.parentElement!;\n        cellElementToFocus = e.key === 'Home' ? walker.firstChild() : walker.lastChild();\n        newChildFocusStrategy = e.key === 'Home' ? 'first' : 'last';\n      } else if (e.key === 'Tab') {\n        // Table is supposed to be a single Tab stop, but cells may contain elements that are tabbable (checkboxes, buttons, menus, etc.).\n        // We don't control the rendering of these elements, so we can't override their tabIndex to prevent tabbing.\n        // Instead, we detect when Tab key is pressed, and move focus manually to the guard element before/after the table,\n        // so that the browser default behavior will apply starting from that element rather than the currently focused one.\n        const tableElement = e.currentTarget as HTMLTableElement;\n        const guardElement = e.shiftKey ? tableElement.previousElementSibling : tableElement.nextElementSibling;\n\n        if (guardElement) {\n          focusTableChild(guardElement as FocusableElement);\n        }\n\n        return;\n      } else if (e.key === 'a' && isCtrlKeyPressed(e) && rowSelectionMode === 'multiple') {\n        // Select all rows\n        onAllRowsSelectionToggle?.(true);\n      } else {\n        // if we didn't handle anything, return early so we don't preventDefault\n        return;\n      }\n\n      if (cellElementToFocus) {\n        const { cellRowKey, cellColumnKey } = (cellElementToFocus as HTMLTableCellElement).dataset;\n\n        // We know the keys are defined, because we queried the DOM for elements that have them\n        tableFocus.setFocus(cellRowKey!, cellColumnKey!, newChildFocusStrategy);\n      }\n\n      e.preventDefault();\n    },\n  });\n\n  const customProps: NativeElementProps<HTMLTableElement> = {\n    role: 'grid',\n    // If no cell is tabbable within the table, make the table itself tabbable,\n    // otherwise the Tab key will just skip it\n    tabIndex: tableFocus.focusedRowKey && tableFocus.focusedColumnKey ? -1 : 0,\n    onFocusCapture: (e) => {\n      // If we're navigating into the table with a keyboard, focus the last focused cell instead of the first tabbable element\n      if (\n        getInteractionModality() === 'keyboard' &&\n        !e.currentTarget.contains(e.relatedTarget) &&\n        e.currentTarget.contains(e.target)\n      ) {\n        restoreCellFocus(e);\n      }\n    },\n  };\n\n  return {\n    tableProps: mergeProps(focusableProps, keyboardProps, customProps),\n  };\n}\n\n/** Constructs a DOM selector for cells in the same column, taking `colspan` into account. */\nfunction constructColumnSelector(tableElement: HTMLTableElement, rowKey: string, columnKey: string): string {\n  const baseSelector = `[data-cell-column-key='${CSS.escape(columnKey)}']:not([data-cell-row-key='${CSS.escape(rowKey)}'])`;\n  const columnHeader = tableElement.querySelector(\n    `th[data-cell-row-key='${CSS.escape(rowKey)}'][data-cell-column-key='${CSS.escape(columnKey)}']`,\n  );\n\n  const columnSelectors: string[] = [baseSelector];\n\n  let currentColumn = columnHeader?.previousElementSibling;\n\n  while (currentColumn) {\n    const { cellColumnKey } = (currentColumn as HTMLElement).dataset;\n\n    if (cellColumnKey) {\n      columnSelectors.push(\n        `[data-cell-column-key='${CSS.escape(cellColumnKey)}'][colspan]:not([data-cell-row-key='${CSS.escape(rowKey)}'])`,\n      );\n    }\n\n    currentColumn = currentColumn.previousElementSibling;\n  }\n\n  return `:is(${columnSelectors.join(', ')})`;\n}\n"]}

package/dist/esm/components/table/table-all-rows-selector.d.ts

@@ -0,0 +1,11 @@
+import type { CommonProps, LabellableProps } from '../types.js';
+export interface TableAllRowsSelectorProps extends CommonProps, Omit<LabellableProps, 'label'> {
+}
+/**
+ * Controls the selection state of all rows within a table.
+ *
+ * See [table building guide](https://ui.cimpress.io/dev-guides/tables/).
+ */
+declare const _TableAllRowsSelector: (props: TableAllRowsSelectorProps & import("react").RefAttributes<HTMLLabelElement>) => import("react").JSX.Element | null;
+export { _TableAllRowsSelector as TableAllRowsSelector };
+//# sourceMappingURL=table-all-rows-selector.d.ts.map

package/dist/esm/components/table/table-all-rows-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-all-rows-selector.d.ts","sourceRoot":"","sources":["../../../../src/components/table/table-all-rows-selector.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGhE,MAAM,WAAW,yBAA0B,SAAQ,WAAW,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC;CAAG;AAoBjG;;;;GAIG;AACH,QAAA,MAAM,qBAAqB,4HAA2D,CAAC;AAEvF,OAAO,EAAE,qBAAqB,IAAI,oBAAoB,EAAE,CAAC"}

package/dist/esm/components/table/table-all-rows-selector.js

@@ -0,0 +1,20 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef } from '../../forward-ref.js';
+import { Checkbox } from '../checkbox/checkbox.js';
+import { useTableState } from './contexts/table-state.js';
+function TableAllRowsSelector(props, ref) {
+    const { rowSelectionMode, areAllRowsSelected, areSomeRowsSelected, onAllRowsSelectionToggle } = useTableState();
+    if (rowSelectionMode !== 'multiple') {
+        return null;
+    }
+    return (_jsx(Checkbox, { ...props, ref: ref, isSelected: areAllRowsSelected, isIndeterminate: areSomeRowsSelected, onChange: onAllRowsSelectionToggle }));
+}
+/**
+ * Controls the selection state of all rows within a table.
+ *
+ * See [table building guide](https://ui.cimpress.io/dev-guides/tables/).
+ */
+const _TableAllRowsSelector = forwardRef(TableAllRowsSelector, 'TableAllRowsSelector');
+export { _TableAllRowsSelector as TableAllRowsSelector };
+//# sourceMappingURL=table-all-rows-selector.js.map

package/dist/esm/components/table/table-all-rows-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-all-rows-selector.js","sourceRoot":"","sources":["../../../../src/components/table/table-all-rows-selector.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI1D,SAAS,oBAAoB,CAAC,KAAgC,EAAE,GAAmC;IACjG,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,GAAG,aAAa,EAAE,CAAC;IAEhH,IAAI,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,KAAC,QAAQ,OACH,KAAK,EACT,GAAG,EAAE,GAAG,EACR,UAAU,EAAE,kBAAkB,EAC9B,eAAe,EAAE,mBAAmB,EACpC,QAAQ,EAAE,wBAAwB,GAClC,CACH,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,qBAAqB,GAAG,UAAU,CAAC,oBAAoB,EAAE,sBAAsB,CAAC,CAAC;AAEvF,OAAO,EAAE,qBAAqB,IAAI,oBAAoB,EAAE,CAAC","sourcesContent":["'use client';\n\nimport type { ForwardedRef } from 'react';\nimport { forwardRef } from '../../forward-ref.js';\nimport { Checkbox } from '../checkbox/checkbox.js';\nimport type { CommonProps, LabellableProps } from '../types.js';\nimport { useTableState } from './contexts/table-state.js';\n\nexport interface TableAllRowsSelectorProps extends CommonProps, Omit<LabellableProps, 'label'> {}\n\nfunction TableAllRowsSelector(props: TableAllRowsSelectorProps, ref: ForwardedRef<HTMLLabelElement>) {\n  const { rowSelectionMode, areAllRowsSelected, areSomeRowsSelected, onAllRowsSelectionToggle } = useTableState();\n\n  if (rowSelectionMode !== 'multiple') {\n    return null;\n  }\n\n  return (\n    <Checkbox\n      {...props}\n      ref={ref}\n      isSelected={areAllRowsSelected}\n      isIndeterminate={areSomeRowsSelected}\n      onChange={onAllRowsSelectionToggle}\n    />\n  );\n}\n\n/**\n * Controls the selection state of all rows within a table.\n *\n * See [table building guide](https://ui.cimpress.io/dev-guides/tables/).\n */\nconst _TableAllRowsSelector = forwardRef(TableAllRowsSelector, 'TableAllRowsSelector');\n\nexport { _TableAllRowsSelector as TableAllRowsSelector };\n"]}

package/dist/esm/components/table/table-body-cell.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+import type { CommonProps } from '../types.js';
+export interface TableBodyCellProps extends CommonProps {
+    /** The contents of the cell. */
+    children: ReactNode;
+    /**
+     * A unique identifier for the column that this cell belongs to.
+     * Cells that belong to the same column must have the same `columnKey`.
+     */
+    columnKey: string;
+}
+/**
+ * Renders a cell within a table body row.
+ *
+ * See [table usage guidelines](https://ui.cimpress.io/components/table/) and [table building guide](https://ui.cimpress.io/dev-guides/tables/).
+ */
+declare const _TableBodyCell: (props: TableBodyCellProps & import("react").RefAttributes<HTMLTableCellElement>) => import("react").JSX.Element | null;
+export { _TableBodyCell as TableBodyCell };
+//# sourceMappingURL=table-body-cell.d.ts.map

package/dist/esm/components/table/table-body-cell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-body-cell.d.ts","sourceRoot":"","sources":["../../../../src/components/table/table-body-cell.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,gCAAgC;IAChC,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAyBD;;;;GAIG;AACH,QAAA,MAAM,cAAc,yHAA6C,CAAC;AAElE,OAAO,EAAE,cAAc,IAAI,aAAa,EAAE,CAAC"}

package/dist/esm/components/table/table-body-cell.js

@@ -0,0 +1,22 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { mergeProps, useObjectRef } from '@react-aria/utils';
+import { forwardRef } from '../../forward-ref.js';
+import { useColumnData } from './contexts/column-collection.js';
+import { useTableRowState } from './contexts/row-state.js';
+import { useTableCell } from './hooks/use-table-cell.js';
+function TableBodyCell({ children, UNSAFE_className, UNSAFE_style, columnKey, ...props }, ref) {
+    const cellRef = useObjectRef(ref);
+    const { rowKey } = useTableRowState();
+    const { cellProps } = useTableCell(cellRef, rowKey, columnKey);
+    const columnData = useColumnData(columnKey);
+    return (_jsx("td", { ...mergeProps(props, cellProps), ref: cellRef, className: UNSAFE_className, style: columnData?.width !== undefined ? { ...UNSAFE_style, width: columnData.width } : UNSAFE_style, "aria-colindex": columnData?.number, "data-alignment": columnData?.contentAlignment, children: children }));
+}
+/**
+ * Renders a cell within a table body row.
+ *
+ * See [table usage guidelines](https://ui.cimpress.io/components/table/) and [table building guide](https://ui.cimpress.io/dev-guides/tables/).
+ */
+const _TableBodyCell = forwardRef(TableBodyCell, 'TableBodyCell');
+export { _TableBodyCell as TableBodyCell };
+//# sourceMappingURL=table-body-cell.js.map

package/dist/esm/components/table/table-body-cell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-body-cell.js","sourceRoot":"","sources":["../../../../src/components/table/table-body-cell.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAYzD,SAAS,aAAa,CACpB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,KAAK,EAAsB,EACrF,GAAuC;IAEvC,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACtC,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAE5C,OAAO,CACL,gBACM,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,EAChC,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,UAAU,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,YAAY,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,YAAY,mBACrF,UAAU,EAAE,MAAM,oBACjB,UAAU,EAAE,gBAAgB,YAE3C,QAAQ,GACN,CACN,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,cAAc,GAAG,UAAU,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;AAElE,OAAO,EAAE,cAAc,IAAI,aAAa,EAAE,CAAC","sourcesContent":["'use client';\n\nimport { mergeProps, useObjectRef } from '@react-aria/utils';\nimport type { ForwardedRef, ReactNode } from 'react';\nimport { forwardRef } from '../../forward-ref.js';\nimport type { CommonProps } from '../types.js';\nimport { useColumnData } from './contexts/column-collection.js';\nimport { useTableRowState } from './contexts/row-state.js';\nimport { useTableCell } from './hooks/use-table-cell.js';\n\nexport interface TableBodyCellProps extends CommonProps {\n  /** The contents of the cell. */\n  children: ReactNode;\n  /**\n   * A unique identifier for the column that this cell belongs to.\n   * Cells that belong to the same column must have the same `columnKey`.\n   */\n  columnKey: string;\n}\n\nfunction TableBodyCell(\n  { children, UNSAFE_className, UNSAFE_style, columnKey, ...props }: TableBodyCellProps,\n  ref: ForwardedRef<HTMLTableCellElement>,\n) {\n  const cellRef = useObjectRef(ref);\n  const { rowKey } = useTableRowState();\n  const { cellProps } = useTableCell(cellRef, rowKey, columnKey);\n  const columnData = useColumnData(columnKey);\n\n  return (\n    <td\n      {...mergeProps(props, cellProps)}\n      ref={cellRef}\n      className={UNSAFE_className}\n      style={columnData?.width !== undefined ? { ...UNSAFE_style, width: columnData.width } : UNSAFE_style}\n      aria-colindex={columnData?.number}\n      data-alignment={columnData?.contentAlignment}\n    >\n      {children}\n    </td>\n  );\n}\n\n/**\n * Renders a cell within a table body row.\n *\n * See [table usage guidelines](https://ui.cimpress.io/components/table/) and [table building guide](https://ui.cimpress.io/dev-guides/tables/).\n */\nconst _TableBodyCell = forwardRef(TableBodyCell, 'TableBodyCell');\n\nexport { _TableBodyCell as TableBodyCell };\n"]}

package/dist/esm/components/table/table-body-row.d.ts

@@ -0,0 +1,40 @@
+import type { ReactNode } from 'react';
+import type { CommonProps } from '../types.js';
+export interface TableBodyRowProps extends CommonProps {
+    /** The cells that belong to this row. */
+    children: ReactNode;
+    /**
+     * The row's position within the full dataset, including headers.
+     *
+     * Provide this value if your table presents a subset of rows, such as when using pagination.
+     *
+     * This number must be:
+     * - greater than or equal to `1`
+     * - greater than the `rowNumber` of any previous rows
+     * - less than or equal to the `totalRowCount` of the parent `Table`
+     *
+     * Use together with `totalRowCount` on the `Table` component.
+     */
+    rowNumber?: number;
+    /**
+     * Whether the row is selected.
+     *
+     * This value will be ignored if `rowSelectionMode` on the `Table` component is set to `'none'`.
+     */
+    isSelected?: boolean;
+    /**
+     * A function called when the row's selection state should change.
+     *
+     * If called without an argument, you are free to pick the new selection state based on your own logic.
+     * If called with an argument, you must set the selection state to the provided value.
+     */
+    onSelectionToggle?: (value?: boolean) => void;
+}
+/**
+ * Renders a row within a table body.
+ *
+ * See [table usage guidelines](https://ui.cimpress.io/components/table/) and [table building guide](https://ui.cimpress.io/dev-guides/tables/).
+ */
+declare const _TableBodyRow: (props: TableBodyRowProps & import("react").RefAttributes<HTMLTableRowElement>) => import("react").JSX.Element | null;
+export { _TableBodyRow as TableBodyRow };
+//# sourceMappingURL=table-body-row.d.ts.map

package/dist/esm/components/table/table-body-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-body-row.d.ts","sourceRoot":"","sources":["../../../../src/components/table/table-body-row.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,yCAAyC;IACzC,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAC/C;AAoBD;;;;GAIG;AACH,QAAA,MAAM,aAAa,uHAA2C,CAAC;AAwB/D,OAAO,EAAE,aAAa,IAAI,YAAY,EAAE,CAAC"}

package/dist/esm/components/table/table-body-row.js

@@ -0,0 +1,25 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { mergeProps, useId } from '@react-aria/utils';
+import { forwardRef } from '../../forward-ref.js';
+import { TableRowStateProvider, useTableRowState } from './contexts/row-state.js';
+import { useTableState } from './contexts/table-state.js';
+import { useSelectableRow } from './hooks/use-selectable-row.js';
+function TableBodyRow({ isSelected, onSelectionToggle, ...props }, ref) {
+    const rowKey = useId();
+    return (_jsx(TableRowStateProvider, { rowKey: rowKey, isSelected: isSelected, onSelectionToggle: onSelectionToggle, children: _jsx(TableBodyRowInner, { props: props, forwardedRef: ref }) }));
+}
+/**
+ * Renders a row within a table body.
+ *
+ * See [table usage guidelines](https://ui.cimpress.io/components/table/) and [table building guide](https://ui.cimpress.io/dev-guides/tables/).
+ */
+const _TableBodyRow = forwardRef(TableBodyRow, 'TableBodyRow');
+function TableBodyRowInner({ props: { children, UNSAFE_className, UNSAFE_style, rowNumber, ...props }, forwardedRef, }) {
+    const { rowSelectionMode } = useTableState();
+    const { isSelected } = useTableRowState();
+    const { rowProps } = useSelectableRow();
+    return (_jsx("tr", { ...mergeProps(rowProps, props), ref: forwardedRef, className: UNSAFE_className, style: UNSAFE_style, "aria-rowindex": rowNumber, "aria-selected": rowSelectionMode !== 'none' ? (isSelected ?? false) : undefined, children: children }));
+}
+export { _TableBodyRow as TableBodyRow };
+//# sourceMappingURL=table-body-row.js.map

package/dist/esm/components/table/table-body-row.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-body-row.js","sourceRoot":"","sources":["../../../../src/components/table/table-body-row.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAiCjE,SAAS,YAAY,CACnB,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,KAAK,EAAqB,EAC9D,GAAsC;IAEtC,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC;IAEvB,OAAO,CACL,KAAC,qBAAqB,IAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,iBAAiB,YACjG,KAAC,iBAAiB,IAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,GAAI,GAChC,CACzB,CAAC;AACJ,CAAC;AAOD;;;;GAIG;AACH,MAAM,aAAa,GAAG,UAAU,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;AAE/D,SAAS,iBAAiB,CAAC,EACzB,KAAK,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EACxE,YAAY,GACW;IACvB,MAAM,EAAE,gBAAgB,EAAE,GAAG,aAAa,EAAE,CAAC;IAC7C,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAC1C,MAAM,EAAE,QAAQ,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAExC,OAAO,CACL,gBACM,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,EAC/B,GAAG,EAAE,YAAY,EACjB,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,YAAY,mBACJ,SAAS,mBACT,gBAAgB,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,YAE7E,QAAQ,GACN,CACN,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,aAAa,IAAI,YAAY,EAAE,CAAC","sourcesContent":["'use client';\n\nimport { mergeProps, useId } from '@react-aria/utils';\nimport type { ForwardedRef, ReactNode } from 'react';\nimport { forwardRef } from '../../forward-ref.js';\nimport type { CommonProps } from '../types.js';\nimport { TableRowStateProvider, useTableRowState } from './contexts/row-state.js';\nimport { useTableState } from './contexts/table-state.js';\nimport { useSelectableRow } from './hooks/use-selectable-row.js';\n\nexport interface TableBodyRowProps extends CommonProps {\n  /** The cells that belong to this row. */\n  children: ReactNode;\n  /**\n   * The row's position within the full dataset, including headers.\n   *\n   * Provide this value if your table presents a subset of rows, such as when using pagination.\n   *\n   * This number must be:\n   * - greater than or equal to `1`\n   * - greater than the `rowNumber` of any previous rows\n   * - less than or equal to the `totalRowCount` of the parent `Table`\n   *\n   * Use together with `totalRowCount` on the `Table` component.\n   */\n  rowNumber?: number;\n  /**\n   * Whether the row is selected.\n   *\n   * This value will be ignored if `rowSelectionMode` on the `Table` component is set to `'none'`.\n   */\n  isSelected?: boolean;\n  /**\n   * A function called when the row's selection state should change.\n   *\n   * If called without an argument, you are free to pick the new selection state based on your own logic.\n   * If called with an argument, you must set the selection state to the provided value.\n   */\n  onSelectionToggle?: (value?: boolean) => void;\n}\n\nfunction TableBodyRow(\n  { isSelected, onSelectionToggle, ...props }: TableBodyRowProps,\n  ref: ForwardedRef<HTMLTableRowElement>,\n) {\n  const rowKey = useId();\n\n  return (\n    <TableRowStateProvider rowKey={rowKey} isSelected={isSelected} onSelectionToggle={onSelectionToggle}>\n      <TableBodyRowInner props={props} forwardedRef={ref} />\n    </TableRowStateProvider>\n  );\n}\n\ninterface TableBodyRowInnerProps {\n  props: Omit<TableBodyRowProps, 'isSelected' | 'onSelectionToggle'>;\n  forwardedRef: ForwardedRef<HTMLTableRowElement>;\n}\n\n/**\n * Renders a row within a table body.\n *\n * See [table usage guidelines](https://ui.cimpress.io/components/table/) and [table building guide](https://ui.cimpress.io/dev-guides/tables/).\n */\nconst _TableBodyRow = forwardRef(TableBodyRow, 'TableBodyRow');\n\nfunction TableBodyRowInner({\n  props: { children, UNSAFE_className, UNSAFE_style, rowNumber, ...props },\n  forwardedRef,\n}: TableBodyRowInnerProps) {\n  const { rowSelectionMode } = useTableState();\n  const { isSelected } = useTableRowState();\n  const { rowProps } = useSelectableRow();\n\n  return (\n    <tr\n      {...mergeProps(rowProps, props)}\n      ref={forwardedRef}\n      className={UNSAFE_className}\n      style={UNSAFE_style}\n      aria-rowindex={rowNumber}\n      aria-selected={rowSelectionMode !== 'none' ? (isSelected ?? false) : undefined}\n    >\n      {children}\n    </tr>\n  );\n}\n\nexport { _TableBodyRow as TableBodyRow };\n"]}

package/dist/esm/components/table/table-body.d.ts

@@ -0,0 +1,14 @@
+import type { ReactNode } from 'react';
+import type { CommonProps } from '../types.js';
+export interface TableBodyProps extends CommonProps {
+    /** The rows that belong to this table body. */
+    children: ReactNode;
+}
+/**
+ * Renders a body section within a table.
+ *
+ * See [table usage guidelines](https://ui.cimpress.io/components/table/) and [table building guide](https://ui.cimpress.io/dev-guides/tables/).
+ */
+declare const _TableBody: (props: TableBodyProps & import("react").RefAttributes<HTMLTableSectionElement>) => import("react").JSX.Element | null;
+export { _TableBody as TableBody };
+//# sourceMappingURL=table-body.d.ts.map

package/dist/esm/components/table/table-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-body.d.ts","sourceRoot":"","sources":["../../../../src/components/table/table-body.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,+CAA+C;IAC/C,QAAQ,EAAE,SAAS,CAAC;CACrB;AAaD;;;;GAIG;AACH,QAAA,MAAM,UAAU,wHAAqC,CAAC;AAEtD,OAAO,EAAE,UAAU,IAAI,SAAS,EAAE,CAAC"}

package/dist/esm/components/table/table-body.js

@@ -0,0 +1,14 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef } from '../../forward-ref.js';
+function TableBody({ children, UNSAFE_className, UNSAFE_style, ...props }, ref) {
+    return (_jsx("tbody", { ...props, ref: ref, className: UNSAFE_className, style: UNSAFE_style, children: children }));
+}
+/**
+ * Renders a body section within a table.
+ *
+ * See [table usage guidelines](https://ui.cimpress.io/components/table/) and [table building guide](https://ui.cimpress.io/dev-guides/tables/).
+ */
+const _TableBody = forwardRef(TableBody, 'TableBody');
+export { _TableBody as TableBody };
+//# sourceMappingURL=table-body.js.map

package/dist/esm/components/table/table-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-body.js","sourceRoot":"","sources":["../../../../src/components/table/table-body.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAQlD,SAAS,SAAS,CAChB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,KAAK,EAAkB,EACtE,GAA0C;IAE1C,OAAO,CACL,mBAAW,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,YAAY,YACzE,QAAQ,GACH,CACT,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAEtD,OAAO,EAAE,UAAU,IAAI,SAAS,EAAE,CAAC","sourcesContent":["'use client';\n\nimport type { ForwardedRef, ReactNode } from 'react';\nimport { forwardRef } from '../../forward-ref.js';\nimport type { CommonProps } from '../types.js';\n\nexport interface TableBodyProps extends CommonProps {\n  /** The rows that belong to this table body. */\n  children: ReactNode;\n}\n\nfunction TableBody(\n  { children, UNSAFE_className, UNSAFE_style, ...props }: TableBodyProps,\n  ref: ForwardedRef<HTMLTableSectionElement>,\n) {\n  return (\n    <tbody {...props} ref={ref} className={UNSAFE_className} style={UNSAFE_style}>\n      {children}\n    </tbody>\n  );\n}\n\n/**\n * Renders a body section within a table.\n *\n * See [table usage guidelines](https://ui.cimpress.io/components/table/) and [table building guide](https://ui.cimpress.io/dev-guides/tables/).\n */\nconst _TableBody = forwardRef(TableBody, 'TableBody');\n\nexport { _TableBody as TableBody };\n"]}