@cimpress-ui/react 0.1.0 → 0.3.0

package/dist/commonjs/components/table/contexts/table-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-state.js","sourceRoot":"","sources":["../../../../../src/components/table/contexts/table-state.tsx"],"names":[],"mappings":";;AAkBA,gDA8CC;AAGD,sCAOC;;AA1ED,6CAAmD;AACnD,iCAA6F;AAe7F,MAAM,iBAAiB,GAAG,IAAA,qBAAa,EAAoB,IAAI,CAAC,CAAC;AAEjE,SAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,GAOzB;IACC,+EAA+E;IAC/E,sDAAsD;IACtD,oDAAoD;IACpD,MAAM,2BAA2B,GAAG,IAAA,cAAM,EAAsB,SAAS,CAAC,CAAC;IAC3E,MAAM,CAAC,yBAAyB,EAAE,4BAA4B,CAAC,GAAG,IAAA,gBAAQ,EAAsB,SAAS,CAAC,CAAC;IAE3G,MAAM,gCAAgC,GAAG,IAAA,sBAAc,EAAC,wBAAwB,CAAC,CAAC;IAElF,MAAM,UAAU,GAAe,IAAA,eAAO,EACpC,GAAG,EAAE,CAAC,CAAC;QACL,gBAAgB;QAChB,kBAAkB;QAClB,mBAAmB;QACnB,wBAAwB,EAAE,gCAAgC;QAC1D,IAAI,wBAAwB;YAC1B,OAAO,2BAA2B,CAAC,OAAO,CAAC;QAC7C,CAAC;QACD,2BAA2B,CAAC,wBAA6C;YACvE,2BAA2B,CAAC,OAAO,GAAG,wBAAwB,CAAC;YAC/D,4BAA4B,CAAC,wBAAwB,CAAC,CAAC;QACzD,CAAC;KACF,CAAC;IACF,uDAAuD;IACvD;QACE,gBAAgB;QAChB,kBAAkB;QAClB,mBAAmB;QACnB,gCAAgC;QAChC,yBAAyB;KAC1B,CACF,CAAC;IAEF,OAAO,uBAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,UAAU,YAAG,QAAQ,GAA8B,CAAC;AAChG,CAAC;AAED,gEAAgE;AAChE,SAAgB,aAAa;IAC3B,MAAM,UAAU,GAAG,IAAA,kBAAU,EAAC,iBAAiB,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC","sourcesContent":["import { useEffectEvent } from '@react-aria/utils';\nimport { createContext, type ReactNode, useContext, useMemo, useRef, useState } from 'react';\n\n/** Represents the type of row selection allowed within a table. */\nexport type RowSelectionMode = 'single' | 'multiple' | 'none';\n\nexport interface TableState {\n  rowSelectionMode: RowSelectionMode;\n  areAllRowsSelected?: boolean;\n  areSomeRowsSelected?: boolean;\n  onAllRowsSelectionToggle?: (value?: boolean) => void;\n  /** The selection state that will be applied to the next focused row. */\n  pendingRowSelectionState?: boolean;\n  setPendingRowSelectionState: (value: boolean | undefined) => void;\n}\n\nconst TableStateContext = createContext<TableState | null>(null);\n\nexport function TableStateProvider({\n  children,\n  rowSelectionMode,\n  areAllRowsSelected,\n  areSomeRowsSelected,\n  onAllRowsSelectionToggle,\n}: {\n  children: ReactNode;\n  rowSelectionMode: RowSelectionMode;\n  areAllRowsSelected?: boolean;\n  areSomeRowsSelected?: boolean;\n  onAllRowsSelectionToggle?: (value?: boolean) => void;\n}) {\n  // When the pending selection state is updated, we want to trigger a re-render,\n  // but we also want immediate access to the new value.\n  // Hence why it is stored as both a ref and a state.\n  const pendingRowSelectionStateRef = useRef<boolean | undefined>(undefined);\n  const [_pendingRowSelectionState, _setPendingRowSelectionState] = useState<boolean | undefined>(undefined);\n\n  const onAllRowsSelectionToggleMemoized = useEffectEvent(onAllRowsSelectionToggle);\n\n  const tableState: TableState = useMemo(\n    () => ({\n      rowSelectionMode,\n      areAllRowsSelected,\n      areSomeRowsSelected,\n      onAllRowsSelectionToggle: onAllRowsSelectionToggleMemoized,\n      get pendingRowSelectionState() {\n        return pendingRowSelectionStateRef.current;\n      },\n      setPendingRowSelectionState(pendingRowSelectionState: boolean | undefined) {\n        pendingRowSelectionStateRef.current = pendingRowSelectionState;\n        _setPendingRowSelectionState(pendingRowSelectionState);\n      },\n    }),\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [\n      rowSelectionMode,\n      areAllRowsSelected,\n      areSomeRowsSelected,\n      onAllRowsSelectionToggleMemoized,\n      _pendingRowSelectionState,\n    ],\n  );\n\n  return <TableStateContext.Provider value={tableState}>{children}</TableStateContext.Provider>;\n}\n\n// eslint-disable-next-line react-refresh/only-export-components\nexport function useTableState(): TableState {\n  const tableState = useContext(TableStateContext);\n  if (!tableState) {\n    throw new Error('Cannot use table state outside of a table');\n  }\n\n  return tableState;\n}\n"]}

package/dist/commonjs/components/table/hooks/use-selectable-row.d.ts

@@ -0,0 +1,6 @@
+import type { NativeElementProps } from '../../types.js';
+export interface UseSelectableRow {
+    rowProps: NativeElementProps<HTMLTableRowElement>;
+}
+export declare function useSelectableRow(): UseSelectableRow;
+//# sourceMappingURL=use-selectable-row.d.ts.map

package/dist/commonjs/components/table/hooks/use-selectable-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-selectable-row.d.ts","sourceRoot":"","sources":["../../../../../src/components/table/hooks/use-selectable-row.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAIzD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;CACnD;AAED,wBAAgB,gBAAgB,IAAI,gBAAgB,CAoCnD"}

package/dist/commonjs/components/table/hooks/use-selectable-row.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSelectableRow = useSelectableRow;
+const row_state_js_1 = require("../contexts/row-state.js");
+const table_state_js_1 = require("../contexts/table-state.js");
+function useSelectableRow() {
+    const { rowSelectionMode, setPendingRowSelectionState } = (0, table_state_js_1.useTableState)();
+    const { isSelected, onSelectionToggle } = (0, row_state_js_1.useTableRowState)();
+    // Handles row selection using a keyboard.
+    const onKeyDownCapture = (e) => {
+        // Ignore keyboard events bubbling through portals
+        if (!e.currentTarget.contains(e.target)) {
+            return;
+        }
+        if (e.key === ' ' && e.shiftKey) {
+            // Toggle selection of current row
+            onSelectionToggle?.();
+        }
+        else if ((e.key === 'ArrowUp' || e.key === 'ArrowDown') && e.shiftKey && rowSelectionMode === 'multiple') {
+            // Extend selection up/down by one row
+            // We're not going to stop propagation so that the arrow navigation handler runs as usual,
+            // and we'll set a special state variable so that the selection state gets updated when the new row receives focus.
+            setPendingRowSelectionState(isSelected);
+            return;
+        }
+        else {
+            // if we didn't handle anything, return early so we don't stop propagation and preventDefault
+            return;
+        }
+        e.preventDefault();
+        e.stopPropagation();
+    };
+    const rowProps = {
+        onKeyDownCapture: rowSelectionMode !== 'none' ? onKeyDownCapture : undefined,
+    };
+    return {
+        rowProps,
+    };
+}
+//# sourceMappingURL=use-selectable-row.js.map

package/dist/commonjs/components/table/hooks/use-selectable-row.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-selectable-row.js","sourceRoot":"","sources":["../../../../../src/components/table/hooks/use-selectable-row.ts"],"names":[],"mappings":";;AASA,4CAoCC;AA3CD,2DAA4D;AAC5D,+DAA2D;AAM3D,SAAgB,gBAAgB;IAC9B,MAAM,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,GAAG,IAAA,8BAAa,GAAE,CAAC;IAC1E,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,IAAA,+BAAgB,GAAE,CAAC;IAE7D,0CAA0C;IAC1C,MAAM,gBAAgB,GAAyB,CAAC,CAAC,EAAE,EAAE;QACnD,kDAAkD;QAClD,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAiB,CAAC,EAAE,CAAC;YACnD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,kCAAkC;YAClC,iBAAiB,EAAE,EAAE,CAAC;QACxB,CAAC;aAAM,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,GAAG,KAAK,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,gBAAgB,KAAK,UAAU,EAAE,CAAC;YAC3G,sCAAsC;YACtC,0FAA0F;YAC1F,mHAAmH;YACnH,2BAA2B,CAAC,UAAU,CAAC,CAAC;YACxC,OAAO;QACT,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,QAAQ,GAA4C;QACxD,gBAAgB,EAAE,gBAAgB,KAAK,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;KAC7E,CAAC;IAEF,OAAO;QACL,QAAQ;KACT,CAAC;AACJ,CAAC","sourcesContent":["import type { KeyboardEventHandler } from 'react';\nimport type { NativeElementProps } from '../../types.js';\nimport { useTableRowState } from '../contexts/row-state.js';\nimport { useTableState } from '../contexts/table-state.js';\n\nexport interface UseSelectableRow {\n  rowProps: NativeElementProps<HTMLTableRowElement>;\n}\n\nexport function useSelectableRow(): UseSelectableRow {\n  const { rowSelectionMode, setPendingRowSelectionState } = useTableState();\n  const { isSelected, onSelectionToggle } = useTableRowState();\n\n  // Handles row selection using a keyboard.\n  const onKeyDownCapture: KeyboardEventHandler = (e) => {\n    // Ignore keyboard events bubbling through portals\n    if (!e.currentTarget.contains(e.target as Element)) {\n      return;\n    }\n\n    if (e.key === ' ' && e.shiftKey) {\n      // Toggle selection of current row\n      onSelectionToggle?.();\n    } else if ((e.key === 'ArrowUp' || e.key === 'ArrowDown') && e.shiftKey && rowSelectionMode === 'multiple') {\n      // Extend selection up/down by one row\n      // We're not going to stop propagation so that the arrow navigation handler runs as usual,\n      // and we'll set a special state variable so that the selection state gets updated when the new row receives focus.\n      setPendingRowSelectionState(isSelected);\n      return;\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 rowProps: NativeElementProps<HTMLTableRowElement> = {\n    onKeyDownCapture: rowSelectionMode !== 'none' ? onKeyDownCapture : undefined,\n  };\n\n  return {\n    rowProps,\n  };\n}\n"]}

package/dist/commonjs/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/commonjs/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/commonjs/components/table/hooks/use-table-cell.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTableCell = useTableCell;
+const focus_1 = require("@react-aria/focus");
+const interactions_1 = require("@react-aria/interactions");
+const utils_1 = require("@react-aria/utils");
+const react_1 = require("react");
+const focus_js_1 = require("../contexts/focus.js");
+const row_state_js_1 = require("../contexts/row-state.js");
+const table_state_js_1 = require("../contexts/table-state.js");
+const focus_table_child_js_1 = require("../utils/focus-table-child.js");
+function useTableCell(ref, rowKey, columnKey) {
+    const tableFocus = (0, focus_js_1.useTableFocus)();
+    const { pendingRowSelectionState, setPendingRowSelectionState } = (0, table_state_js_1.useTableState)();
+    const { onSelectionToggle } = (0, row_state_js_1.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 = (0, focus_1.getFocusableTreeWalker)(ref.current);
+        const focusable = tableFocus.childFocusStrategy === 'last' ? treeWalker.lastChild() : treeWalker.firstChild();
+        if (focusable) {
+            // Cell has focusable children, focus the child
+            (0, focus_table_child_js_1.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
+            (0, focus_table_child_js_1.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
+    (0, utils_1.useLayoutEffect)(() => {
+        if (isTabbable && !ref.current.contains(document.activeElement)) {
+            focusCell();
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [ref, isTabbable]);
+    const resetIfFocused = (0, utils_1.useEffectEvent)(() => {
+        if (isTabbable) {
+            tableFocus.setFocus('', '');
+        }
+    });
+    // Reset table focus when the focused cell unmounts
+    (0, react_1.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) && (0, interactions_1.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 (!(0, interactions_1.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 = (0, focus_1.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) {
+                (0, focus_table_child_js_1.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 } = (0, focus_1.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: (0, utils_1.mergeProps)(focusProps, customProps),
+    };
+}
+//# sourceMappingURL=use-table-cell.js.map

package/dist/commonjs/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":"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","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/commonjs/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/commonjs/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/commonjs/components/table/hooks/use-table.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTable = useTable;
+const focus_1 = require("@react-aria/focus");
+const interactions_1 = require("@react-aria/interactions");
+const utils_1 = require("@react-aria/utils");
+const focus_js_1 = require("../contexts/focus.js");
+const table_state_js_1 = require("../contexts/table-state.js");
+const focus_table_child_js_1 = require("../utils/focus-table-child.js");
+function useTable(ref) {
+    const tableFocus = (0, focus_js_1.useTableFocus)();
+    const { rowSelectionMode, onAllRowsSelectionToggle } = (0, table_state_js_1.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)) {
+                    (0, focus_table_child_js_1.focusTableChild)(element);
+                }
+            }
+        }
+    };
+    const { focusableProps } = (0, focus_1.useFocusable)({
+        onFocus: (e) => {
+            // Ignore focus events bubbling through portals
+            if (!e.currentTarget.contains(e.target)) {
+                return;
+            }
+            restoreCellFocus(e);
+        },
+    }, ref);
+    const { keyboardProps } = (0, interactions_1.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 = (0, focus_1.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 = (0, focus_1.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 = (0, focus_1.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 = (0, focus_1.getFocusableTreeWalker)(e.currentTarget, { accept: (node) => node.matches(selector) });
+                walker.currentNode = (0, utils_1.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) {
+                    (0, focus_table_child_js_1.focusTableChild)(guardElement);
+                }
+                return;
+            }
+            else if (e.key === 'a' && (0, utils_1.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 ((0, interactions_1.getInteractionModality)() === 'keyboard' &&
+                !e.currentTarget.contains(e.relatedTarget) &&
+                e.currentTarget.contains(e.target)) {
+                restoreCellFocus(e);
+            }
+        },
+    };
+    return {
+        tableProps: (0, utils_1.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/commonjs/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/commonjs/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/commonjs/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/commonjs/components/table/table-all-rows-selector.js

@@ -0,0 +1,23 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TableAllRowsSelector = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const forward_ref_js_1 = require("../../forward-ref.js");
+const checkbox_js_1 = require("../checkbox/checkbox.js");
+const table_state_js_1 = require("./contexts/table-state.js");
+function TableAllRowsSelector(props, ref) {
+    const { rowSelectionMode, areAllRowsSelected, areSomeRowsSelected, onAllRowsSelectionToggle } = (0, table_state_js_1.useTableState)();
+    if (rowSelectionMode !== 'multiple') {
+        return null;
+    }
+    return ((0, jsx_runtime_1.jsx)(checkbox_js_1.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 = (0, forward_ref_js_1.forwardRef)(TableAllRowsSelector, 'TableAllRowsSelector');
+exports.TableAllRowsSelector = _TableAllRowsSelector;
+//# sourceMappingURL=table-all-rows-selector.js.map

package/dist/commonjs/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,yDAAkD;AAClD,yDAAmD;AAEnD,8DAA0D;AAI1D,SAAS,oBAAoB,CAAC,KAAgC,EAAE,GAAmC;IACjG,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,GAAG,IAAA,8BAAa,GAAE,CAAC;IAEhH,IAAI,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,uBAAC,sBAAQ,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,IAAA,2BAAU,EAAC,oBAAoB,EAAE,sBAAsB,CAAC,CAAC;AAErD,qDAAoB","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/commonjs/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/commonjs/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/commonjs/components/table/table-body-cell.js

@@ -0,0 +1,25 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TableBodyCell = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const utils_1 = require("@react-aria/utils");
+const forward_ref_js_1 = require("../../forward-ref.js");
+const column_collection_js_1 = require("./contexts/column-collection.js");
+const row_state_js_1 = require("./contexts/row-state.js");
+const use_table_cell_js_1 = require("./hooks/use-table-cell.js");
+function TableBodyCell({ children, UNSAFE_className, UNSAFE_style, columnKey, ...props }, ref) {
+    const cellRef = (0, utils_1.useObjectRef)(ref);
+    const { rowKey } = (0, row_state_js_1.useTableRowState)();
+    const { cellProps } = (0, use_table_cell_js_1.useTableCell)(cellRef, rowKey, columnKey);
+    const columnData = (0, column_collection_js_1.useColumnData)(columnKey);
+    return ((0, jsx_runtime_1.jsx)("td", { ...(0, utils_1.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 = (0, forward_ref_js_1.forwardRef)(TableBodyCell, 'TableBodyCell');
+exports.TableBodyCell = _TableBodyCell;
+//# sourceMappingURL=table-body-cell.js.map

package/dist/commonjs/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,6CAA6D;AAE7D,yDAAkD;AAElD,0EAAgE;AAChE,0DAA2D;AAC3D,iEAAyD;AAYzD,SAAS,aAAa,CACpB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,KAAK,EAAsB,EACrF,GAAuC;IAEvC,MAAM,OAAO,GAAG,IAAA,oBAAY,EAAC,GAAG,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,+BAAgB,GAAE,CAAC;IACtC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAA,gCAAY,EAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,IAAA,oCAAa,EAAC,SAAS,CAAC,CAAC;IAE5C,OAAO,CACL,kCACM,IAAA,kBAAU,EAAC,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,IAAA,2BAAU,EAAC,aAAa,EAAE,eAAe,CAAC,CAAC;AAEvC,uCAAa","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/commonjs/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/commonjs/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"}