@cimpress-ui/react 0.1.0 → 0.2.1

package/dist/esm/components/pagination/pagination.js

@@ -0,0 +1,66 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { UNSTABLE_IconChevronLeftFill, UNSTABLE_IconChevronRightFill } from '../../icons/index.js';
+import { Button } from '../button/button.js';
+import { IconButton } from '../button/icon-button.js';
+import { IconLinkButton } from '../button/icon-link-button.js';
+import { LinkButton } from '../button/link-button.js';
+export function UNSTABLE_Pagination({ value, count, onPageChange, href, 'aria-label': ariaLabel }) {
+    const visiblePages = getVisiblePages(value, count);
+    const previousButtonProps = {
+        // TODO: icon doesn't look optically centered, see: https://www.figma.com/design/JVWmaCjDeOlrYAkLlJD5gr?node-id=10376-1487#1082340181
+        icon: _jsx(UNSTABLE_IconChevronLeftFill, {}),
+        isDisabled: value === 1,
+        // TODO: internationalization
+        'aria-label': 'Previous',
+    };
+    const nextButtonProps = {
+        // TODO: icon doesn't look optically centered, see: https://www.figma.com/design/JVWmaCjDeOlrYAkLlJD5gr?node-id=10376-1487#1082340181
+        icon: _jsx(UNSTABLE_IconChevronRightFill, {}),
+        isDisabled: value === count,
+        // TODO: internationalization
+        'aria-label': 'Next',
+    };
+    return (_jsx("nav", { className: "cim-pagination", "aria-label": ariaLabel, children: _jsxs("ul", { className: "cim-pagination-list", children: [_jsx("li", { children: href ? (_jsx(IconLinkButton, { ...previousButtonProps, href: href?.(value - 1) })) : (_jsx(IconButton, { ...previousButtonProps, onPress: () => onPageChange?.(value - 1) })) }), visiblePages.map((page) => {
+                    const isCurrentPage = typeof page === 'number' && page === value;
+                    const pageNumber = typeof page === 'number' ? page : page.page;
+                    const pageButtonProps = {
+                        // TODO: internationalization
+                        // TODO: review if "Current page" is needed once we put `aria-current` on the `button`/`link`
+                        'aria-label': isCurrentPage ? `Current page, page ${pageNumber}` : `Go to page ${pageNumber}`,
+                        children: typeof page === 'number' ? page : '…',
+                    };
+                    return (
+                    // TODO: Put `aria-current` on the `button`/`link` instead of the `li` for better accessibility/screen reader support
+                    // RAC Button doesn't support `aria-current` as of now
+                    _jsx("li", { "aria-current": isCurrentPage && href != null ? 'page' : isCurrentPage, children: href ? (_jsx(LinkButton, { href: href?.(pageNumber), ...pageButtonProps })) : (_jsx(Button, { onPress: () => onPageChange?.(pageNumber), ...pageButtonProps })) }, pageNumber));
+                }), _jsx("li", { children: href ? (_jsx(IconLinkButton, { ...nextButtonProps, href: href?.(value + 1) })) : (_jsx(IconButton, { ...nextButtonProps, onPress: () => onPageChange?.(value + 1) })) })] }) }));
+}
+function getVisiblePages(currentPage, totalPages) {
+    if (totalPages <= 7) {
+        return Array.from({ length: totalPages }, (_, index) => index + 1);
+    }
+    if (currentPage <= 4) {
+        return [1, 2, 3, 4, { type: 'ellipsis', page: 5 }, totalPages - 1, totalPages];
+    }
+    if (currentPage >= totalPages - 3) {
+        return [
+            1,
+            2,
+            { type: 'ellipsis', page: totalPages - 4 },
+            totalPages - 3,
+            totalPages - 2,
+            totalPages - 1,
+            totalPages,
+        ];
+    }
+    return [
+        1,
+        { type: 'ellipsis', page: currentPage - 2 },
+        currentPage - 1,
+        currentPage,
+        currentPage + 1,
+        { type: 'ellipsis', page: currentPage + 2 },
+        totalPages,
+    ];
+}
+//# sourceMappingURL=pagination.js.map

package/dist/esm/components/pagination/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../../src/components/pagination/pagination.tsx"],"names":[],"mappings":"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","sourcesContent":["import { UNSTABLE_IconChevronLeftFill, UNSTABLE_IconChevronRightFill } from '../../icons/index.js';\nimport { Button } from '../button/button.js';\nimport { IconButton } from '../button/icon-button.js';\nimport { IconLinkButton } from '../button/icon-link-button.js';\nimport { LinkButton } from '../button/link-button.js';\n\nexport interface PaginationProps {\n  /** The current page number. */\n  value: number;\n  /** The total number of pages. */\n  count: number;\n  /** The accessibility label for the pagination navigation, must be unique to the page. */\n  'aria-label': string;\n  /** A callback function that is called when the page number changes. */\n  onPageChange?: (page: number) => void;\n  /** A function that returns a URL for a given page number. */\n  href?: (page: number) => string;\n}\n\nexport function UNSTABLE_Pagination({ value, count, onPageChange, href, 'aria-label': ariaLabel }: PaginationProps) {\n  const visiblePages = getVisiblePages(value, count);\n\n  const previousButtonProps = {\n    // TODO: icon doesn't look optically centered, see: https://www.figma.com/design/JVWmaCjDeOlrYAkLlJD5gr?node-id=10376-1487#1082340181\n    icon: <UNSTABLE_IconChevronLeftFill />,\n    isDisabled: value === 1,\n    // TODO: internationalization\n    'aria-label': 'Previous',\n  };\n\n  const nextButtonProps = {\n    // TODO: icon doesn't look optically centered, see: https://www.figma.com/design/JVWmaCjDeOlrYAkLlJD5gr?node-id=10376-1487#1082340181\n    icon: <UNSTABLE_IconChevronRightFill />,\n    isDisabled: value === count,\n    // TODO: internationalization\n    'aria-label': 'Next',\n  };\n\n  return (\n    <nav className=\"cim-pagination\" aria-label={ariaLabel}>\n      <ul className=\"cim-pagination-list\">\n        <li>\n          {href ? (\n            <IconLinkButton {...previousButtonProps} href={href?.(value - 1)} />\n          ) : (\n            <IconButton {...previousButtonProps} onPress={() => onPageChange?.(value - 1)} />\n          )}\n        </li>\n\n        {visiblePages.map((page) => {\n          const isCurrentPage = typeof page === 'number' && page === value;\n          const pageNumber = typeof page === 'number' ? page : page.page;\n          const pageButtonProps = {\n            // TODO: internationalization\n            // TODO: review if \"Current page\" is needed once we put `aria-current` on the `button`/`link`\n            'aria-label': isCurrentPage ? `Current page, page ${pageNumber}` : `Go to page ${pageNumber}`,\n            children: typeof page === 'number' ? page : '…',\n          };\n\n          return (\n            // TODO: Put `aria-current` on the `button`/`link` instead of the `li` for better accessibility/screen reader support\n            // RAC Button doesn't support `aria-current` as of now\n            <li key={pageNumber} aria-current={isCurrentPage && href != null ? 'page' : isCurrentPage}>\n              {href ? (\n                <LinkButton href={href?.(pageNumber)} {...pageButtonProps} />\n              ) : (\n                <Button onPress={() => onPageChange?.(pageNumber)} {...pageButtonProps} />\n              )}\n            </li>\n          );\n        })}\n\n        <li>\n          {href ? (\n            <IconLinkButton {...nextButtonProps} href={href?.(value + 1)} />\n          ) : (\n            <IconButton {...nextButtonProps} onPress={() => onPageChange?.(value + 1)} />\n          )}\n        </li>\n      </ul>\n    </nav>\n  );\n}\n\nfunction getVisiblePages(currentPage: number, totalPages: number): (number | { type: 'ellipsis'; page: number })[] {\n  if (totalPages <= 7) {\n    return Array.from({ length: totalPages }, (_, index) => index + 1);\n  }\n\n  if (currentPage <= 4) {\n    return [1, 2, 3, 4, { type: 'ellipsis', page: 5 }, totalPages - 1, totalPages];\n  }\n\n  if (currentPage >= totalPages - 3) {\n    return [\n      1,\n      2,\n      { type: 'ellipsis', page: totalPages - 4 },\n      totalPages - 3,\n      totalPages - 2,\n      totalPages - 1,\n      totalPages,\n    ];\n  }\n\n  return [\n    1,\n    { type: 'ellipsis', page: currentPage - 2 },\n    currentPage - 1,\n    currentPage,\n    currentPage + 1,\n    { type: 'ellipsis', page: currentPage + 2 },\n    totalPages,\n  ];\n}\n"]}

package/dist/esm/components/radio/radio.d.ts

@@ -1,6 +1,6 @@
 import { type RadioProps as RACRadioProps } from 'react-aria-components';
 import type { CommonProps, LabellableProps, StringLikeChildren } from '../types.js';
-export interface RadioProps extends CommonProps, Omit<LabellableProps, 'label'>, Pick<RACRadioProps, 'value' | 'isDisabled'> {
+export interface RadioProps extends CommonProps, Omit<LabellableProps, 'label'>, Pick<RACRadioProps, 'value' | 'isDisabled' | 'autoFocus'> {
     /** The label rendered next to the radio. */
     children?: StringLikeChildren;
 }

package/dist/esm/components/radio/radio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"radio.d.ts","sourceRoot":"","sources":["../../../../src/components/radio/radio.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAqB,KAAK,UAAU,IAAI,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG5F,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGpF,MAAM,WAAW,UACf,SAAQ,WAAW,EACjB,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,EAC9B,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,YAAY,CAAC;IAC7C,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AA8BD;;;;GAIG;AACH,QAAA,MAAM,MAAM,8JAA6C,CAAC;AAE1D,OAAO,EAAE,MAAM,IAAI,KAAK,EAAE,CAAC"}
+{"version":3,"file":"radio.d.ts","sourceRoot":"","sources":["../../../../src/components/radio/radio.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAqB,KAAK,UAAU,IAAI,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG5F,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGpF,MAAM,WAAW,UACf,SAAQ,WAAW,EACjB,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,EAC9B,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,YAAY,GAAG,WAAW,CAAC;IAC3D,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AA8BD;;;;GAIG;AACH,QAAA,MAAM,MAAM,8JAA6C,CAAC;AAE1D,OAAO,EAAE,MAAM,IAAI,KAAK,EAAE,CAAC"}

package/dist/esm/components/radio/radio.js.map

@@ -1 +1 @@
-{"version":3,"file":"radio.js","sourceRoot":"","sources":["../../../../src/components/radio/radio.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAqB,MAAM,OAAO,CAAC;AACrD,OAAO,EAAE,KAAK,IAAI,QAAQ,EAAoC,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAU7C,SAAS,KAAK,CACZ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,KAAK,EAAc,EAClE,GAAmC;IAEnC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IAE7E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,EAAE,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;QAClG,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;IAE1C,OAAO,CACL,MAAC,QAAQ,OAAK,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,aAChG,cAAK,SAAS,EAAC,0BAA0B,YACvC,cAAK,SAAS,EAAC,kBAAkB,YAC/B,cAAK,SAAS,EAAC,wBAAwB,GAAG,GACtC,GACF,EACL,QAAQ,IAAI,CACX,KAAC,IAAI,IAAC,EAAE,EAAC,MAAM,EAAC,OAAO,EAAC,MAAM,YAC3B,QAAQ,GACJ,CACR,IACQ,CACZ,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;AAE1D,OAAO,EAAE,MAAM,IAAI,KAAK,EAAE,CAAC","sourcesContent":["'use client';\n\nimport clsx from 'clsx';\nimport { useEffect, type ForwardedRef } from 'react';\nimport { Radio as RACRadio, type RadioProps as RACRadioProps } from 'react-aria-components';\nimport { forwardRef } from '../../forward-ref.js';\nimport { withStyleProps } from '../../with-style-props.js';\nimport type { CommonProps, LabellableProps, StringLikeChildren } from '../types.js';\nimport { Text } from '../typography/text.js';\n\nexport interface RadioProps\n  extends CommonProps,\n    Omit<LabellableProps, 'label'>,\n    Pick<RACRadioProps, 'value' | 'isDisabled'> {\n  /** The label rendered next to the radio. */\n  children?: StringLikeChildren;\n}\n\nfunction Radio(\n  { children, UNSAFE_className, UNSAFE_style, ...props }: RadioProps,\n  ref: ForwardedRef<HTMLLabelElement>,\n) {\n  const { 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy } = props;\n\n  useEffect(() => {\n    if (!children && !ariaLabel && !ariaLabelledBy) {\n      console.warn('Radio requires one of children / aria-label / aria-labelledby for accessibility');\n    }\n  }, [children, ariaLabel, ariaLabelledBy]);\n\n  return (\n    <RACRadio {...props} className={clsx('cim-radio', UNSAFE_className)} style={UNSAFE_style} ref={ref}>\n      <div className=\"cim-radio-toggle-wrapper\">\n        <div className=\"cim-radio-toggle\">\n          <div className=\"cim-radio-toggle-inner\" />\n        </div>\n      </div>\n      {children && (\n        <Text as=\"span\" variant=\"body\">\n          {children}\n        </Text>\n      )}\n    </RACRadio>\n  );\n}\n\n/**\n * Renders a single option within `RadioGroup`.\n *\n * See [radio group usage guidelines](https://ui.cimpress.io/components/radio-group/).\n */\nconst _Radio = withStyleProps(forwardRef(Radio), 'Radio');\n\nexport { _Radio as Radio };\n"]}
+{"version":3,"file":"radio.js","sourceRoot":"","sources":["../../../../src/components/radio/radio.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAqB,MAAM,OAAO,CAAC;AACrD,OAAO,EAAE,KAAK,IAAI,QAAQ,EAAoC,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAU7C,SAAS,KAAK,CACZ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,KAAK,EAAc,EAClE,GAAmC;IAEnC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IAE7E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc,EAAE,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;QAClG,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;IAE1C,OAAO,CACL,MAAC,QAAQ,OAAK,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,aAChG,cAAK,SAAS,EAAC,0BAA0B,YACvC,cAAK,SAAS,EAAC,kBAAkB,YAC/B,cAAK,SAAS,EAAC,wBAAwB,GAAG,GACtC,GACF,EACL,QAAQ,IAAI,CACX,KAAC,IAAI,IAAC,EAAE,EAAC,MAAM,EAAC,OAAO,EAAC,MAAM,YAC3B,QAAQ,GACJ,CACR,IACQ,CACZ,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;AAE1D,OAAO,EAAE,MAAM,IAAI,KAAK,EAAE,CAAC","sourcesContent":["'use client';\n\nimport clsx from 'clsx';\nimport { useEffect, type ForwardedRef } from 'react';\nimport { Radio as RACRadio, type RadioProps as RACRadioProps } from 'react-aria-components';\nimport { forwardRef } from '../../forward-ref.js';\nimport { withStyleProps } from '../../with-style-props.js';\nimport type { CommonProps, LabellableProps, StringLikeChildren } from '../types.js';\nimport { Text } from '../typography/text.js';\n\nexport interface RadioProps\n  extends CommonProps,\n    Omit<LabellableProps, 'label'>,\n    Pick<RACRadioProps, 'value' | 'isDisabled' | 'autoFocus'> {\n  /** The label rendered next to the radio. */\n  children?: StringLikeChildren;\n}\n\nfunction Radio(\n  { children, UNSAFE_className, UNSAFE_style, ...props }: RadioProps,\n  ref: ForwardedRef<HTMLLabelElement>,\n) {\n  const { 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy } = props;\n\n  useEffect(() => {\n    if (!children && !ariaLabel && !ariaLabelledBy) {\n      console.warn('Radio requires one of children / aria-label / aria-labelledby for accessibility');\n    }\n  }, [children, ariaLabel, ariaLabelledBy]);\n\n  return (\n    <RACRadio {...props} className={clsx('cim-radio', UNSAFE_className)} style={UNSAFE_style} ref={ref}>\n      <div className=\"cim-radio-toggle-wrapper\">\n        <div className=\"cim-radio-toggle\">\n          <div className=\"cim-radio-toggle-inner\" />\n        </div>\n      </div>\n      {children && (\n        <Text as=\"span\" variant=\"body\">\n          {children}\n        </Text>\n      )}\n    </RACRadio>\n  );\n}\n\n/**\n * Renders a single option within `RadioGroup`.\n *\n * See [radio group usage guidelines](https://ui.cimpress.io/components/radio-group/).\n */\nconst _Radio = withStyleProps(forwardRef(Radio), 'Radio');\n\nexport { _Radio as Radio };\n"]}

package/dist/esm/components/table/contexts/focus.d.ts

@@ -0,0 +1,13 @@
+import { type ReactNode } from 'react';
+export interface TableFocus {
+    focusedRowKey: string;
+    focusedColumnKey: string;
+    childFocusStrategy: ChildFocusStrategy;
+    setFocus: (rowKey: string, columnKey: string, childFocusStrategy?: ChildFocusStrategy) => void;
+}
+export type ChildFocusStrategy = 'first' | 'last';
+export declare function TableFocusProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useTableFocus(): TableFocus;
+//# sourceMappingURL=focus.d.ts.map

package/dist/esm/components/table/contexts/focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../../../../src/components/table/contexts/focus.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAyC,MAAM,OAAO,CAAC;AAE7F,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAChG;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,CAAC;AAIlD,wBAAgB,kBAAkB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAwCvE;AAGD,wBAAgB,aAAa,IAAI,UAAU,CAO1C"}

package/dist/esm/components/table/contexts/focus.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo, useRef, useState } from 'react';
+const TableFocusContext = createContext(null);
+export function TableFocusProvider({ children }) {
+    // When table focus is updated, we want to trigger a re-render,
+    // but we also want immediate access to the new values.
+    // Hence why they are stored as both a ref and a state.
+    const focusedRowKeyRef = useRef('');
+    const [_focusedRowKey, setFocusedRowKey] = useState('');
+    const focusedColumnKeyRef = useRef('');
+    const [_focusedColumnKey, setFocusedColumnKey] = useState('');
+    const childFocusStrategyRef = useRef('first');
+    const [_childFocusStrategy, setChildFocusStrategy] = useState('first');
+    const tableFocus = useMemo(() => ({
+        get focusedRowKey() {
+            return focusedRowKeyRef.current;
+        },
+        get focusedColumnKey() {
+            return focusedColumnKeyRef.current;
+        },
+        get childFocusStrategy() {
+            return childFocusStrategyRef.current;
+        },
+        setFocus: (rowKey, columnKey, childFocusStrategy) => {
+            focusedRowKeyRef.current = rowKey;
+            setFocusedRowKey(rowKey);
+            focusedColumnKeyRef.current = columnKey;
+            setFocusedColumnKey(columnKey);
+            if (childFocusStrategy) {
+                childFocusStrategyRef.current = childFocusStrategy;
+                setChildFocusStrategy(childFocusStrategy);
+            }
+        },
+    }), 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [_focusedRowKey, _focusedColumnKey, _childFocusStrategy]);
+    return _jsx(TableFocusContext.Provider, { value: tableFocus, children: children });
+}
+// eslint-disable-next-line react-refresh/only-export-components
+export function useTableFocus() {
+    const tableFocus = useContext(TableFocusContext);
+    if (!tableFocus) {
+        throw new Error('Cannot use table focus outside of a table');
+    }
+    return tableFocus;
+}
+//# sourceMappingURL=focus.js.map

package/dist/esm/components/table/contexts/focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.js","sourceRoot":"","sources":["../../../../../src/components/table/contexts/focus.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAkB,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAW7F,MAAM,iBAAiB,GAAG,aAAa,CAAoB,IAAI,CAAC,CAAC;AAEjE,MAAM,UAAU,kBAAkB,CAAC,EAAE,QAAQ,EAA2B;IACtE,+DAA+D;IAC/D,uDAAuD;IACvD,uDAAuD;IACvD,MAAM,gBAAgB,GAAG,MAAM,CAAS,EAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAS,EAAE,CAAC,CAAC;IAChE,MAAM,mBAAmB,GAAG,MAAM,CAAS,EAAE,CAAC,CAAC;IAC/C,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,GAAG,QAAQ,CAAS,EAAE,CAAC,CAAC;IACtE,MAAM,qBAAqB,GAAG,MAAM,CAAqB,OAAO,CAAC,CAAC;IAClE,MAAM,CAAC,mBAAmB,EAAE,qBAAqB,CAAC,GAAG,QAAQ,CAAqB,OAAO,CAAC,CAAC;IAE3F,MAAM,UAAU,GAAe,OAAO,CACpC,GAAG,EAAE,CAAC,CAAC;QACL,IAAI,aAAa;YACf,OAAO,gBAAgB,CAAC,OAAO,CAAC;QAClC,CAAC;QACD,IAAI,gBAAgB;YAClB,OAAO,mBAAmB,CAAC,OAAO,CAAC;QACrC,CAAC;QACD,IAAI,kBAAkB;YACpB,OAAO,qBAAqB,CAAC,OAAO,CAAC;QACvC,CAAC;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,EAAE;YAClD,gBAAgB,CAAC,OAAO,GAAG,MAAM,CAAC;YAClC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAEzB,mBAAmB,CAAC,OAAO,GAAG,SAAS,CAAC;YACxC,mBAAmB,CAAC,SAAS,CAAC,CAAC;YAE/B,IAAI,kBAAkB,EAAE,CAAC;gBACvB,qBAAqB,CAAC,OAAO,GAAG,kBAAkB,CAAC;gBACnD,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;KACF,CAAC;IACF,uDAAuD;IACvD,CAAC,cAAc,EAAE,iBAAiB,EAAE,mBAAmB,CAAC,CACzD,CAAC;IAEF,OAAO,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,UAAU,YAAG,QAAQ,GAA8B,CAAC;AAChG,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,aAAa;IAC3B,MAAM,UAAU,GAAG,UAAU,CAAC,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 { createContext, type ReactNode, useContext, useMemo, useRef, useState } from 'react';\n\nexport interface TableFocus {\n  focusedRowKey: string;\n  focusedColumnKey: string;\n  childFocusStrategy: ChildFocusStrategy;\n  setFocus: (rowKey: string, columnKey: string, childFocusStrategy?: ChildFocusStrategy) => void;\n}\n\nexport type ChildFocusStrategy = 'first' | 'last';\n\nconst TableFocusContext = createContext<TableFocus | null>(null);\n\nexport function TableFocusProvider({ children }: { children: ReactNode }) {\n  // When table focus is updated, we want to trigger a re-render,\n  // but we also want immediate access to the new values.\n  // Hence why they are stored as both a ref and a state.\n  const focusedRowKeyRef = useRef<string>('');\n  const [_focusedRowKey, setFocusedRowKey] = useState<string>('');\n  const focusedColumnKeyRef = useRef<string>('');\n  const [_focusedColumnKey, setFocusedColumnKey] = useState<string>('');\n  const childFocusStrategyRef = useRef<ChildFocusStrategy>('first');\n  const [_childFocusStrategy, setChildFocusStrategy] = useState<ChildFocusStrategy>('first');\n\n  const tableFocus: TableFocus = useMemo(\n    () => ({\n      get focusedRowKey() {\n        return focusedRowKeyRef.current;\n      },\n      get focusedColumnKey() {\n        return focusedColumnKeyRef.current;\n      },\n      get childFocusStrategy() {\n        return childFocusStrategyRef.current;\n      },\n      setFocus: (rowKey, columnKey, childFocusStrategy) => {\n        focusedRowKeyRef.current = rowKey;\n        setFocusedRowKey(rowKey);\n\n        focusedColumnKeyRef.current = columnKey;\n        setFocusedColumnKey(columnKey);\n\n        if (childFocusStrategy) {\n          childFocusStrategyRef.current = childFocusStrategy;\n          setChildFocusStrategy(childFocusStrategy);\n        }\n      },\n    }),\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [_focusedRowKey, _focusedColumnKey, _childFocusStrategy],\n  );\n\n  return <TableFocusContext.Provider value={tableFocus}>{children}</TableFocusContext.Provider>;\n}\n\n// eslint-disable-next-line react-refresh/only-export-components\nexport function useTableFocus(): TableFocus {\n  const tableFocus = useContext(TableFocusContext);\n  if (!tableFocus) {\n    throw new Error('Cannot use table focus outside of a table');\n  }\n\n  return tableFocus;\n}\n"]}

package/dist/esm/components/table/contexts/row-state.d.ts

@@ -0,0 +1,10 @@
+import { type ReactNode } from 'react';
+export interface TableRowState {
+    rowKey: string;
+}
+export declare function TableRowStateProvider({ children, rowKey }: {
+    children: ReactNode;
+    rowKey: string;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useTableRowState(): TableRowState;
+//# sourceMappingURL=row-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"row-state.d.ts","sourceRoot":"","sources":["../../../../../src/components/table/contexts/row-state.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,wBAAgB,qBAAqB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,2CASlG;AAGD,wBAAgB,gBAAgB,IAAI,aAAa,CAOhD"}

package/dist/esm/components/table/contexts/row-state.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from 'react';
+const TableRowStateContext = createContext(null);
+export function TableRowStateProvider({ children, rowKey }) {
+    const tableRowState = useMemo(() => ({
+        rowKey,
+    }), [rowKey]);
+    return _jsx(TableRowStateContext.Provider, { value: tableRowState, children: children });
+}
+// eslint-disable-next-line react-refresh/only-export-components
+export function useTableRowState() {
+    const tableRowState = useContext(TableRowStateContext);
+    if (!tableRowState) {
+        throw new Error('Cannot use table row state outside of a table row');
+    }
+    return tableRowState;
+}
+//# sourceMappingURL=row-state.js.map

package/dist/esm/components/table/contexts/row-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-state.js","sourceRoot":"","sources":["../../../../../src/components/table/contexts/row-state.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAkB,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAM3E,MAAM,oBAAoB,GAAG,aAAa,CAAuB,IAAI,CAAC,CAAC;AAEvE,MAAM,UAAU,qBAAqB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAA2C;IACjG,MAAM,aAAa,GAAkB,OAAO,CAC1C,GAAG,EAAE,CAAC,CAAC;QACL,MAAM;KACP,CAAC,EACF,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,aAAa,YAAG,QAAQ,GAAiC,CAAC;AACzG,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,gBAAgB;IAC9B,MAAM,aAAa,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACvD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC","sourcesContent":["import { createContext, type ReactNode, useContext, useMemo } from 'react';\n\nexport interface TableRowState {\n  rowKey: string;\n}\n\nconst TableRowStateContext = createContext<TableRowState | null>(null);\n\nexport function TableRowStateProvider({ children, rowKey }: { children: ReactNode; rowKey: string }) {\n  const tableRowState: TableRowState = useMemo(\n    () => ({\n      rowKey,\n    }),\n    [rowKey],\n  );\n\n  return <TableRowStateContext.Provider value={tableRowState}>{children}</TableRowStateContext.Provider>;\n}\n\n// eslint-disable-next-line react-refresh/only-export-components\nexport function useTableRowState(): TableRowState {\n  const tableRowState = useContext(TableRowStateContext);\n  if (!tableRowState) {\n    throw new Error('Cannot use table row state outside of a table row');\n  }\n\n  return tableRowState;\n}\n"]}

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>, 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,EAAsE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3G,OAAO,KAAK,EAAoB,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAI3E,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;CACrD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CA6HlH"}

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

@@ -0,0 +1,122 @@
+import { getFocusableTreeWalker, useFocusRing } from '@react-aria/focus';
+import { isFocusVisible } from '@react-aria/interactions';
+import { mergeProps } from '@react-aria/utils';
+import { useLayoutEffect } from 'react';
+import { useTableFocus } from '../contexts/focus.js';
+import { focusTableChild } from '../utils/focus-table-child.js';
+export function useTableCell(ref, rowKey, columnKey) {
+    const tableFocus = useTableFocus();
+    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 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 onFocus = (e) => {
+        // Ignore focus events bubbling through portals
+        if (!e.currentTarget.contains(e.target)) {
+            return;
+        }
+        // If cell is already focused, return early
+        if (e.currentTarget.contains(e.relatedTarget)) {
+            return;
+        }
+        if (e.target !== ref.current) {
+            // If a child element of the cell receives focus, there are 3 scenarios:
+            // - 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);
+            }
+        }
+        else {
+            // 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,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAA6B,eAAe,EAA0C,MAAM,OAAO,CAAC;AAE3G,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAMhE,MAAM,UAAU,YAAY,CAAC,GAAoC,EAAE,MAAc,EAAE,SAAiB;IAClG,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IAEnC,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,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,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,2CAA2C;QAC3C,IAAI,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9C,OAAO;QACT,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;YAC7B,wEAAwE;YACxE,2FAA2F;YAC3F,iEAAiE;YACjE,+EAA+E;YAC/E,+DAA+D;YAC/D,mFAAmF;YACnF,gEAAgE;YAChE,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;gBACtB,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,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 } from '@react-aria/utils';\nimport { type KeyboardEventHandler, useLayoutEffect, type FocusEventHandler, type RefObject } from 'react';\nimport type { FocusableElement, NativeElementProps } from '../../types.js';\nimport { useTableFocus } from '../contexts/focus.js';\nimport { focusTableChild } from '../utils/focus-table-child.js';\n\nexport interface UseTableCell {\n  cellProps: NativeElementProps<HTMLTableCellElement>;\n}\n\nexport function useTableCell(ref: RefObject<HTMLTableCellElement>, rowKey: string, columnKey: string): UseTableCell {\n  const tableFocus = useTableFocus();\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 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 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    if (e.currentTarget.contains(e.relatedTarget)) {\n      return;\n    }\n\n    if (e.target !== ref.current) {\n      // If a child element of the cell receives focus, there are 3 scenarios:\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    } else {\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>): 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;AAI3E,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;CAClD;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,gBAAgB,CAAC,GAAG,QAAQ,CAsJnE"}

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

@@ -0,0 +1,139 @@
+import { getFocusableTreeWalker, useFocusable } from '@react-aria/focus';
+import { getInteractionModality, useKeyboard } from '@react-aria/interactions';
+import { isMac, mergeProps } from '@react-aria/utils';
+import { useTableFocus } from '../contexts/focus.js';
+import { focusTableChild } from '../utils/focus-table-child.js';
+export function useTable(ref) {
+    const tableFocus = useTableFocus();
+    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 = `[data-cell-column-key='${CSS.escape(tableFocus.focusedColumnKey)}']:not([data-cell-row-key='${CSS.escape(tableFocus.focusedRowKey)}'])`;
+                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 = `[data-cell-column-key='${CSS.escape(tableFocus.focusedColumnKey)}']:not([data-cell-row-key='${CSS.escape(tableFocus.focusedRowKey)}'])`;
+                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 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),
+    };
+}
+// TODO: use `isCtrlKeyPressed` from `@react-aria/utils` after version upgrade
+function isCtrlKeyPressed(e) {
+    if (isMac()) {
+        return e.metaKey;
+    }
+    return e.ctrlKey;
+}
+//# 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 { isMac, 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 { focusTableChild } from '../utils/focus-table-child.js';\n\nexport interface UseTable {\n  tableProps: NativeElementProps<HTMLTableElement>;\n}\n\nexport function useTable(ref: RefObject<HTMLTableElement>): UseTable {\n  const tableFocus = useTableFocus();\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 = `[data-cell-column-key='${CSS.escape(tableFocus.focusedColumnKey)}']:not([data-cell-row-key='${CSS.escape(tableFocus.focusedRowKey)}'])`;\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 = `[data-cell-column-key='${CSS.escape(tableFocus.focusedColumnKey)}']:not([data-cell-row-key='${CSS.escape(tableFocus.focusedRowKey)}'])`;\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 {\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// TODO: use `isCtrlKeyPressed` from `@react-aria/utils` after version upgrade\nfunction isCtrlKeyPressed(e: { ctrlKey: boolean; metaKey: boolean }): boolean {\n  if (isMac()) {\n    return e.metaKey;\n  }\n\n  return e.ctrlKey;\n}\n"]}

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

@@ -0,0 +1,26 @@
+import type { ReactNode } from 'react';
+import type { CommonProps } from '../types.js';
+export interface UNSTABLE_TableBodyCellProps extends CommonProps {
+    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;
+    /**
+     * The position of the column that this cell belongs to within the full dataset.
+     *
+     * Provide this value if your table presents a subset of columns, such as when the user toggles column visibility.
+     *
+     * This number must be:
+     * - greater than or equal to `1`
+     * - greater than the `columnNumber` of any previous cells in the current row
+     * - less than or equal to the `totalColumnCount` of the parent `Table`
+     *
+     * Use together with `totalColumnCount` on the `Table` component.
+     */
+    columnNumber?: number;
+}
+declare const _UNSTABLE_TableBodyCell: (props: UNSTABLE_TableBodyCellProps & import("react").RefAttributes<HTMLTableCellElement>) => import("react").JSX.Element | null;
+export { _UNSTABLE_TableBodyCell as UNSTABLE_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":"AACA,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,MAAM,WAAW,2BAA4B,SAAQ,WAAW;IAC9D,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAuBD,QAAA,MAAM,uBAAuB,kIAAsD,CAAC;AAEpF,OAAO,EAAE,uBAAuB,IAAI,sBAAsB,EAAE,CAAC"}