neatkit 0.8.0 → 0.9.0

package/dist/components/Sidebar/components/SidebarItem.d.ts

@@ -1,5 +1,6 @@
 import { type ComponentPropsWithRef, type ComponentPropsWithoutRef, type ElementType, type ReactElement, type ReactNode } from "react";
 import { type IconType } from "../../Icon";
+import { type SidebarPresentation } from "../utils/presentation";
 /** A type representing properties owned by the Sidebar.Item component. */
 type SidebarItemOwnProps = {
     /** Whether the item represents the current page or view. */
@@ -10,6 +11,8 @@ type SidebarItemOwnProps = {
     disabled?: boolean;
     /** The icon displayed before the item label. */
     icon?: IconType;
+    /** The presentations the item is rendered in. */
+    presentation?: SidebarPresentation;
 };
 /** A type representing the reference accepted by a polymorphic element. */
 type SidebarItemReference<Component extends ElementType> = ComponentPropsWithRef<Component>["ref"];

package/dist/components/Sidebar/components/SidebarPanel.d.ts

@@ -1,5 +1,5 @@
 import type { CSSProperties, HTMLAttributes, ReactNode, Ref } from "react";
-import type { SidebarPresentation } from "../utils/state";
+import type { SidebarPresentationState } from "../utils/state";
 /** A type representing the edge an overlay Sidebar occupies. */
 export type SidebarSide = "end" | "start";
 /** A type representing CSS custom properties accepted by Sidebar styles. */
@@ -19,7 +19,7 @@ export type SidebarPanelProps = Omit<HTMLAttributes<HTMLElement>, "children" | "
     /** The reference assigned to the rendered panel element. */
     panelReference: Ref<HTMLElement>;
     /** The presentation currently rendered by the Sidebar. */
-    presentation: SidebarPresentation;
+    presentation: SidebarPresentationState;
     /** Whether the Sidebar is currently disclosed as an overlay. */
     open: boolean;
     /** The edge the overlay panel occupies. */

package/dist/components/Sidebar/hooks/usePresentation.d.ts

@@ -1,5 +1,5 @@
 import type { BoundaryWidthStore } from "../../Boundary/contexts/BoundaryContext";
-import type { SidebarPresentation, SidebarVariant } from "../utils/state";
+import type { SidebarPresentationState, SidebarVariant } from "../utils/state";
 /**
  * Resolves the presentation a Sidebar renders inside its boundary.
  *
@@ -11,4 +11,4 @@ import type { SidebarPresentation, SidebarVariant } from "../utils/state";
  *
  * @returns The explicit, measured, or pending Sidebar presentation.
  */
-export declare function usePresentation(variant: SidebarVariant, width: BoundaryWidthStore | undefined): SidebarPresentation;
+export declare function usePresentation(variant: SidebarVariant, width: BoundaryWidthStore | undefined): SidebarPresentationState;

package/dist/components/Sidebar/index.d.ts

@@ -1,2 +1,2 @@
 export { default } from "./Sidebar";
-export type { SidebarFooterProps, SidebarGroupPresentation, SidebarGroupProps, SidebarItemProps, SidebarOpenChangeReason, SidebarProps, SidebarSide, SidebarTriggerProps, SidebarUserAction, SidebarUserProps, SidebarVariant, } from "./Sidebar";
+export type { SidebarFooterProps, SidebarGroupProps, SidebarHeaderProps, SidebarItemProps, SidebarOpenChangeReason, SidebarPresentation, SidebarProps, SidebarSide, SidebarTriggerProps, SidebarUserAction, SidebarUserProps, SidebarVariant, } from "./Sidebar";

package/dist/components/Sidebar/utils/presentation.d.ts

@@ -0,0 +1,12 @@
+import type { SidebarPresentationState } from "./state";
+/** A type representing the presentations a Sidebar's content renders in. */
+export type SidebarPresentation = "both" | "inline" | "overlay";
+/**
+ * Determines whether content renders in the Sidebar's presentation.
+ *
+ * @param requested - The presentations the content is rendered in.
+ * @param current - The presentation the Sidebar currently renders.
+ *
+ * @returns Whether the content renders rather than being omitted.
+ */
+export declare function rendersInPresentation(requested: SidebarPresentation, current: SidebarPresentationState | undefined): boolean;

package/dist/components/Sidebar/utils/state.d.ts

@@ -6,7 +6,7 @@ export type SidebarVariant = "inline" | "overlay" | "responsive";
  * The pending presentation covers server rendering and hydration, where the
  * boundary is not yet measured and stylesheets select the presentation.
  */
-export type SidebarPresentation = "inline" | "overlay" | "pending";
+export type SidebarPresentationState = "inline" | "overlay" | "pending";
 /** A type representing an interaction requesting a Sidebar state change. */
 export type SidebarOpenChangeReason = "escape" | "item" | "outside" | "trigger" | "variant";
 /** A type representing the state one Sidebar publishes to its boundary. */
@@ -16,7 +16,7 @@ export type SidebarState = {
     /** Whether the overlay Sidebar is currently open. */
     open: boolean;
     /** The presentation currently rendered by the Sidebar. */
-    presentation: SidebarPresentation;
+    presentation: SidebarPresentationState;
     /** The responsive behavior requested for the Sidebar. */
     variant: SidebarVariant;
     /** Adds a mounted Trigger to the overlay dismissal layer. */

package/dist/components/Table/Table.d.ts

@@ -1,136 +1,19 @@
-import { type HTMLAttributeAnchorTarget, type HTMLAttributes, type MouseEventHandler, type ReactNode, type TableHTMLAttributes, type TdHTMLAttributes, type ThHTMLAttributes } from "react";
-import { type ButtonProps } from "../Button";
-import { type IconType } from "../Icon";
+import { type ReactNode, type TableHTMLAttributes } from "react";
+import TableBody from "./components/TableBody";
+import TableCell from "./components/TableCell";
+import TableFoot from "./components/TableFoot";
+import TableHead from "./components/TableHead";
+import TableHeaderCell from "./components/TableHeaderCell";
+import TableRow from "./components/TableRow";
 import "./styles/table.css";
-/** A value rendered directly or formatted by a Table cell. */
-export type TableCellValue = boolean | Date | number | string;
-/** The horizontal alignment applied to Table cell content. */
-export type TableCellAlignment = "left" | "center" | "right";
-/** A type representing properties for the Table component. */
-export type TableProps = TableHTMLAttributes<HTMLTableElement> & {
-    /** The table sections, rows, and cells rendered inside the Table. */
-    children: ReactNode;
-    /** The additional class name applied to the horizontal scroll container. */
-    containerClassName?: string;
-};
-/** A type representing properties for the Table.Head component. */
-export type TableHeadProps = HTMLAttributes<HTMLTableSectionElement> & {
-    /** The rows rendered inside the Table head. */
-    children: ReactNode;
-};
-/** A type representing properties for the Table.Body component. */
-export type TableBodyProps = HTMLAttributes<HTMLTableSectionElement> & {
-    /** The rows rendered inside the Table body. */
-    children?: ReactNode;
-    /** The number of columns occupied by the generated empty-state cell. */
-    emptyColumnCount?: number;
-    /** The content displayed when children contain no explicit content. */
-    emptyMessage?: ReactNode;
-};
-/** A type representing properties for the Table.Foot component. */
-export type TableFootProps = HTMLAttributes<HTMLTableSectionElement> & {
-    /** The rows rendered inside the Table foot. */
-    children: ReactNode;
-};
-/** Shared native properties for every Table.Row configuration. */
-type TableRowBaseProps = Omit<HTMLAttributes<HTMLTableRowElement>, "aria-label" | "children" | "onClick"> & {
-    /**
-     * The controls operating on this row.
-     *
-     * Each action is keyed by its label, so labels must be unique per row.
-     */
-    actions?: readonly TableRowAction[];
-    /** The cells rendered inside the Table row. */
-    children: ReactNode;
-};
-/** A type representing a static Table.Row configuration. */
-type TableStaticRowProps = {
-    /** The optional accessible name applied to the static row. */
-    "aria-label"?: string;
-    /** Static rows do not expose download behavior. */
-    download?: never;
-    /** Static rows do not expose a navigation destination. */
-    href?: never;
-    /** Static rows do not describe a linked resource language. */
-    hrefLang?: never;
-    /** Static rows do not expose whole-row activation. */
-    onClick?: never;
-    /** Static rows do not expose navigation interception. */
-    onNavigate?: never;
-    /** Static rows do not target a browsing context. */
-    target?: never;
-};
-/** A type representing a button-backed Table.Row configuration. */
-type TableButtonRowProps = {
-    /** The accessible name describing the whole-row action. */
-    "aria-label": string;
-    /** Button-backed rows do not expose download behavior. */
-    download?: never;
-    /** Button-backed rows do not expose a navigation destination. */
-    href?: never;
-    /** Button-backed rows do not describe a linked resource language. */
-    hrefLang?: never;
-    /** The callback invoked when the row's button is activated. */
-    onClick: MouseEventHandler<HTMLButtonElement>;
-    /** Button-backed rows do not expose navigation interception. */
-    onNavigate?: never;
-    /** Button-backed rows do not target a browsing context. */
-    target?: never;
-};
-/** A type representing a link-backed Table.Row configuration. */
-type TableLinkRowProps = {
-    /** The accessible name describing the whole-row link. */
-    "aria-label": string;
-    /** Whether the linked resource should be downloaded. */
-    download?: boolean | string;
-    /** The destination opened by whole-row activation. */
-    href: string;
-    /** The language of the linked resource. */
-    hrefLang?: string;
-    /** Link-backed rows do not expose button activation. */
-    onClick?: never;
-    /** The callback invoked when the row's link is activated. */
-    onNavigate?: MouseEventHandler<HTMLAnchorElement>;
-    /** The relationship between the table and linked resource. */
-    rel?: string;
-    /** The browsing context used to open the linked resource. */
-    target?: HTMLAttributeAnchorTarget;
-};
-/** A type representing properties for the Table.Row component. */
-export type TableRowProps = TableRowBaseProps & (TableButtonRowProps | TableLinkRowProps | TableStaticRowProps);
-/** Shared properties configuring a Table header cell. */
-type TableHeaderCellOwnProps = {
-    /** The horizontal alignment applied to the header content. */
-    align?: TableCellAlignment;
-    /** The content rendered inside the header cell. */
-    children?: ReactNode;
-    /** Whether the header pins its supported edge column during scrolling. */
-    sticky?: boolean;
-};
-/** A type representing properties for the Table.HeaderCell component. */
-export type TableHeaderCellProps = Omit<ThHTMLAttributes<HTMLTableCellElement>, "align" | "children"> & TableHeaderCellOwnProps;
-/** A type representing properties for the Table action header cell. */
-export type TableActionHeaderCellProps = Omit<TableHeaderCellProps, "align">;
-/** A type representing properties for the Table.Cell component. */
-export type TableCellProps = Omit<TdHTMLAttributes<HTMLTableCellElement>, "align" | "children"> & {
-    /** The horizontal alignment applied to the cell content. */
-    align?: TableCellAlignment;
-    /** Content rendered when no value is supplied. */
-    children?: ReactNode;
-    /** A function transforming the supplied value into displayed content. */
-    format?: (value: TableCellValue) => ReactNode;
-    /** The maximum CSS width used to truncate overflowing content. */
-    truncate?: string;
-    /** The primitive value displayed or passed to the format function. */
-    value?: TableCellValue;
-};
-/** A type representing one consistently styled Table row action. */
-export type TableRowAction = Omit<ButtonProps<"button">, "as" | "children" | "className" | "fullWidth" | "icon" | "iconAlignment" | "shape" | "style" | "textAlignment" | "type" | "variant"> & {
-    /** The icon identifying the row action. */
-    icon: IconType;
-    /** The short Tooltip label and base accessible name for the row action. */
-    label: string;
-};
+export type { TableRowAction } from "./components/TableAction";
+export type { TableBodyProps } from "./components/TableBody";
+export type { TableCellProps } from "./components/TableCell";
+export type { TableFootProps } from "./components/TableFoot";
+export type { TableHeadProps } from "./components/TableHead";
+export type { TableHeaderCellProps } from "./components/TableHeaderCell";
+export type { TableRowProps } from "./components/TableRow";
+export type { TableCellAlignment, TableCellValue } from "./utils/cell";
 /** A type representing the complete compound Table component. */
 type TableComponent = typeof TableRoot & {
     /** The body section containing Table data rows. */
@@ -146,84 +29,13 @@ type TableComponent = typeof TableRoot & {
     /** A Table row. */
     Row: typeof TableRow;
 };
-/**
- * Renders the Table head section.
- *
- * @param props - The native section properties and header rows.
- * @param forwardedReference - The reference assigned to the head element.
- *
- * @returns The rendered Table head section.
- */
-declare const TableHead: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLTableSectionElement> & {
-    /** The rows rendered inside the Table head. */
-    children: ReactNode;
-} & import("react").RefAttributes<HTMLTableSectionElement>>;
-/**
- * Renders the Table body and its optional empty state.
- *
- * @param props - The native section, row, and empty-state properties.
- * @param forwardedReference - The reference assigned to the body element.
- *
- * @returns The rendered Table body section.
- */
-declare const TableBody: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLTableSectionElement> & {
-    /** The rows rendered inside the Table body. */
-    children?: ReactNode;
-    /** The number of columns occupied by the generated empty-state cell. */
-    emptyColumnCount?: number;
-    /** The content displayed when children contain no explicit content. */
-    emptyMessage?: ReactNode;
-} & import("react").RefAttributes<HTMLTableSectionElement>>;
-/**
- * Renders the Table foot section.
- *
- * @param props - The native section properties and footer rows.
- * @param forwardedReference - The reference assigned to the foot element.
- *
- * @returns The rendered Table foot section.
- */
-declare const TableFoot: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLTableSectionElement> & {
-    /** The rows rendered inside the Table foot. */
+/** A type representing properties for the Table component. */
+export type TableProps = TableHTMLAttributes<HTMLTableElement> & {
+    /** The table sections, rows, and cells rendered inside the Table. */
     children: ReactNode;
-} & import("react").RefAttributes<HTMLTableSectionElement>>;
-/**
- * Renders a native Table row without replacing its table semantics.
- *
- * @param props - The native row properties and cells.
- * @param forwardedReference - The reference assigned to the row element.
- *
- * @returns The rendered Table row.
- */
-declare const TableRow: import("react").ForwardRefExoticComponent<TableRowProps & import("react").RefAttributes<HTMLTableRowElement>>;
-/**
- * Renders a column header cell.
- *
- * @param props - The native header properties and displayed label.
- * @param forwardedReference - The reference assigned to the header cell.
- *
- * @returns The rendered Table column header.
- */
-declare const TableHeaderCell: import("react").ForwardRefExoticComponent<Omit<ThHTMLAttributes<HTMLTableCellElement>, "children" | "align"> & TableHeaderCellOwnProps & import("react").RefAttributes<HTMLTableCellElement>>;
-/**
- * Renders a data cell with optional value formatting and truncation.
- *
- * @param props - The native cell, content, and display properties.
- * @param forwardedReference - The reference assigned to the data cell.
- *
- * @returns The rendered Table data cell.
- */
-declare const TableCell: import("react").ForwardRefExoticComponent<Omit<TdHTMLAttributes<HTMLTableCellElement>, "children" | "align"> & {
-    /** The horizontal alignment applied to the cell content. */
-    align?: TableCellAlignment;
-    /** Content rendered when no value is supplied. */
-    children?: ReactNode;
-    /** A function transforming the supplied value into displayed content. */
-    format?: (value: TableCellValue) => ReactNode;
-    /** The maximum CSS width used to truncate overflowing content. */
-    truncate?: string;
-    /** The primitive value displayed or passed to the format function. */
-    value?: TableCellValue;
-} & import("react").RefAttributes<HTMLTableCellElement>>;
+    /** The additional class name applied to the horizontal scroll container. */
+    containerClassName?: string;
+};
 /**
  * Renders a semantic Table inside a keyboard-scrollable surface.
  *

package/dist/components/Table/components/TableAction.d.ts

@@ -0,0 +1,18 @@
+import { type ButtonProps } from "../../Button";
+import type { IconType } from "../../Icon";
+/** A type representing one consistently styled Table row action. */
+export type TableRowAction = Omit<ButtonProps<"button">, "as" | "children" | "className" | "fullWidth" | "icon" | "iconAlignment" | "shape" | "style" | "textAlignment" | "type" | "variant"> & {
+    /** The icon identifying the row action. */
+    icon: IconType;
+    /** The short Tooltip label and base accessible name for the row action. */
+    label: string;
+};
+/**
+ * Renders one consistently styled control operating on a Table row.
+ *
+ * @param props - The short label, icon, and native button properties.
+ *
+ * @returns The rendered Table row action.
+ */
+declare function TableAction(props: TableRowAction): import("react").JSX.Element;
+export default TableAction;

package/dist/components/Table/components/TableActionCell.d.ts

@@ -0,0 +1,15 @@
+import { type TableRowAction } from "./TableAction";
+/** Internal action-cell properties supplied by a Table.Row. */
+export type TableActionCellProps = {
+    /** The controls rendered inside the row's action cell. */
+    actions: readonly TableRowAction[];
+};
+/**
+ * Renders the cell containing controls for one Table row.
+ *
+ * @param props - The composed Table actions operating on the row.
+ *
+ * @returns The rendered Table action cell.
+ */
+declare function TableActionCell(props: TableActionCellProps): import("react").JSX.Element;
+export default TableActionCell;

package/dist/components/Table/components/TableActionHeaderCell.d.ts

@@ -0,0 +1,13 @@
+import { type TableHeaderCellProps } from "./TableHeaderCell";
+/** A type representing properties for the Table action header cell. */
+export type TableActionHeaderCellProps = Omit<TableHeaderCellProps, "align">;
+/**
+ * Renders the header for a row-actions column.
+ *
+ * @param props - The native header properties and optional visible label.
+ * @param forwardedReference - The reference assigned to the header cell.
+ *
+ * @returns The rendered Table actions header.
+ */
+declare const TableActionHeaderCell: import("react").ForwardRefExoticComponent<TableActionHeaderCellProps & import("react").RefAttributes<HTMLTableCellElement>>;
+export default TableActionHeaderCell;

package/dist/components/Table/components/TableBody.d.ts

@@ -0,0 +1,27 @@
+import { type HTMLAttributes, type ReactNode } from "react";
+/** A type representing properties for the Table.Body component. */
+export type TableBodyProps = HTMLAttributes<HTMLTableSectionElement> & {
+    /** The rows rendered inside the Table body. */
+    children?: ReactNode;
+    /** The number of columns occupied by the generated empty-state cell. */
+    emptyColumnCount?: number;
+    /** The content displayed when children contain no explicit content. */
+    emptyMessage?: ReactNode;
+};
+/**
+ * Renders the Table body and its optional empty state.
+ *
+ * @param props - The native section, row, and empty-state properties.
+ * @param forwardedReference - The reference assigned to the body element.
+ *
+ * @returns The rendered Table body section.
+ */
+declare const TableBody: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLTableSectionElement> & {
+    /** The rows rendered inside the Table body. */
+    children?: ReactNode;
+    /** The number of columns occupied by the generated empty-state cell. */
+    emptyColumnCount?: number;
+    /** The content displayed when children contain no explicit content. */
+    emptyMessage?: ReactNode;
+} & import("react").RefAttributes<HTMLTableSectionElement>>;
+export default TableBody;

package/dist/components/Table/components/TableCell.d.ts

@@ -0,0 +1,42 @@
+import { type ReactNode, type TdHTMLAttributes } from "react";
+import { type TableCellAlignment, type TableCellFormatter, type TableCellValue } from "../utils/cell";
+import type { TableRowTrigger } from "../utils/trigger";
+/** A type representing properties for the Table.Cell component. */
+export type TableCellProps = Omit<TdHTMLAttributes<HTMLTableCellElement>, "align" | "children"> & {
+    /** The horizontal alignment applied to the cell content. */
+    align?: TableCellAlignment;
+    /** Content rendered when no value is supplied. */
+    children?: ReactNode;
+    /** A function transforming the supplied value into displayed content. */
+    format?: TableCellFormatter;
+    /** The maximum CSS width used to truncate overflowing content. */
+    truncate?: string;
+    /** The primitive value displayed or passed to the format function. */
+    value?: TableCellValue;
+};
+/** Internal Table.Cell properties supplied by an interactive Table.Row. */
+export type TableCellImplementationProps = TableCellProps & {
+    /** The primary row control rendered inside the first data cell. */
+    rowTrigger?: TableRowTrigger;
+};
+/**
+ * Renders a data cell with optional value formatting and truncation.
+ *
+ * @param props - The native cell, content, and display properties.
+ * @param forwardedReference - The reference assigned to the data cell.
+ *
+ * @returns The rendered Table data cell.
+ */
+declare const TableCell: import("react").ForwardRefExoticComponent<Omit<TdHTMLAttributes<HTMLTableCellElement>, "children" | "align"> & {
+    /** The horizontal alignment applied to the cell content. */
+    align?: TableCellAlignment;
+    /** Content rendered when no value is supplied. */
+    children?: ReactNode;
+    /** A function transforming the supplied value into displayed content. */
+    format?: TableCellFormatter;
+    /** The maximum CSS width used to truncate overflowing content. */
+    truncate?: string;
+    /** The primitive value displayed or passed to the format function. */
+    value?: TableCellValue;
+} & import("react").RefAttributes<HTMLTableCellElement>>;
+export default TableCell;

package/dist/components/Table/components/TableFoot.d.ts

@@ -0,0 +1,19 @@
+import { type HTMLAttributes, type ReactNode } from "react";
+/** A type representing properties for the Table.Foot component. */
+export type TableFootProps = HTMLAttributes<HTMLTableSectionElement> & {
+    /** The rows rendered inside the Table foot. */
+    children: ReactNode;
+};
+/**
+ * Renders the Table foot section.
+ *
+ * @param props - The native section properties and footer rows.
+ * @param forwardedReference - The reference assigned to the foot element.
+ *
+ * @returns The rendered Table foot section.
+ */
+declare const TableFoot: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLTableSectionElement> & {
+    /** The rows rendered inside the Table foot. */
+    children: ReactNode;
+} & import("react").RefAttributes<HTMLTableSectionElement>>;
+export default TableFoot;

package/dist/components/Table/components/TableHead.d.ts

@@ -0,0 +1,19 @@
+import { type HTMLAttributes, type ReactNode } from "react";
+/** A type representing properties for the Table.Head component. */
+export type TableHeadProps = HTMLAttributes<HTMLTableSectionElement> & {
+    /** The rows rendered inside the Table head. */
+    children: ReactNode;
+};
+/**
+ * Renders the Table head section.
+ *
+ * @param props - The native section properties and header rows.
+ * @param forwardedReference - The reference assigned to the head element.
+ *
+ * @returns The rendered Table head section.
+ */
+declare const TableHead: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLTableSectionElement> & {
+    /** The rows rendered inside the Table head. */
+    children: ReactNode;
+} & import("react").RefAttributes<HTMLTableSectionElement>>;
+export default TableHead;

package/dist/components/Table/components/TableHeaderCell.d.ts

@@ -0,0 +1,23 @@
+import { type ReactNode, type ThHTMLAttributes } from "react";
+import type { TableCellAlignment } from "../utils/cell";
+/** Shared properties configuring a Table header cell. */
+type TableHeaderCellOwnProps = {
+    /** The horizontal alignment applied to the header content. */
+    align?: TableCellAlignment;
+    /** The content rendered inside the header cell. */
+    children?: ReactNode;
+    /** Whether the header pins its supported edge column during scrolling. */
+    sticky?: boolean;
+};
+/** A type representing properties for the Table.HeaderCell component. */
+export type TableHeaderCellProps = Omit<ThHTMLAttributes<HTMLTableCellElement>, "align" | "children"> & TableHeaderCellOwnProps;
+/**
+ * Renders a column header cell.
+ *
+ * @param props - The native header properties and displayed label.
+ * @param forwardedReference - The reference assigned to the header cell.
+ *
+ * @returns The rendered Table column header.
+ */
+declare const TableHeaderCell: import("react").ForwardRefExoticComponent<Omit<ThHTMLAttributes<HTMLTableCellElement>, "children" | "align"> & TableHeaderCellOwnProps & import("react").RefAttributes<HTMLTableCellElement>>;
+export default TableHeaderCell;

package/dist/components/Table/components/TableRow.d.ts

@@ -0,0 +1,67 @@
+import { type HTMLAttributes, type MouseEventHandler, type ReactNode } from "react";
+import { type TableRowLinkProperties } from "../utils/trigger";
+import type { TableRowAction } from "./TableAction";
+/** Shared native properties for every Table.Row configuration. */
+type TableRowBaseProps = Omit<HTMLAttributes<HTMLTableRowElement>, "aria-label" | "children" | "onClick"> & {
+    /**
+     * The controls operating on this row.
+     *
+     * Each action is keyed by its label, so labels must be unique per row.
+     */
+    actions?: readonly TableRowAction[];
+    /** The cells rendered inside the Table row. */
+    children: ReactNode;
+};
+/** A type representing a static Table.Row configuration. */
+type TableStaticRowProps = {
+    /** The optional accessible name applied to the static row. */
+    "aria-label"?: string;
+    /** Static rows do not expose download behavior. */
+    download?: never;
+    /** Static rows do not expose a navigation destination. */
+    href?: never;
+    /** Static rows do not describe a linked resource language. */
+    hrefLang?: never;
+    /** Static rows do not expose whole-row activation. */
+    onClick?: never;
+    /** Static rows do not expose navigation interception. */
+    onNavigate?: never;
+    /** Static rows do not target a browsing context. */
+    target?: never;
+};
+/** A type representing a button-backed Table.Row configuration. */
+type TableButtonRowProps = {
+    /** The accessible name describing the whole-row action. */
+    "aria-label": string;
+    /** Button-backed rows do not expose download behavior. */
+    download?: never;
+    /** Button-backed rows do not expose a navigation destination. */
+    href?: never;
+    /** Button-backed rows do not describe a linked resource language. */
+    hrefLang?: never;
+    /** The callback invoked when the row's button is activated. */
+    onClick: MouseEventHandler<HTMLButtonElement>;
+    /** Button-backed rows do not expose navigation interception. */
+    onNavigate?: never;
+    /** Button-backed rows do not target a browsing context. */
+    target?: never;
+};
+/** A type representing a link-backed Table.Row configuration. */
+type TableLinkRowProps = TableRowLinkProperties & {
+    /** The accessible name describing the whole-row link. */
+    "aria-label": string;
+    /** Link-backed rows do not expose button activation. */
+    onClick?: never;
+};
+/** A type representing properties for the Table.Row component. */
+export type TableRowProps = TableRowBaseProps & (TableButtonRowProps | TableLinkRowProps | TableStaticRowProps);
+/**
+ * Renders a native Table row without replacing its table semantics.
+ *
+ * @param props - The native row properties and cells.
+ * @param forwardedReference - The reference assigned to the row element.
+ *
+ * @returns The rendered Table row.
+ */
+declare const TableRow: import("react").ForwardRefExoticComponent<TableRowProps & import("react").RefAttributes<HTMLTableRowElement>>;
+export default TableRow;

package/dist/components/Table/hooks/useHorizontalOverflow.d.ts

@@ -0,0 +1,25 @@
+import { type MutableRefObject, type UIEvent } from "react";
+/** A type representing the tracked horizontal overflow of a scroll region. */
+export type HorizontalOverflow = {
+    /** The reference assigned to the scrolling container. */
+    containerReference: MutableRefObject<HTMLDivElement | null>;
+    /** The reference assigned to the content measured for overflow. */
+    contentReference: MutableRefObject<HTMLElement | null>;
+    /** Whether the content currently overflows its container horizontally. */
+    isScrollable: boolean;
+    /** Whether the container is scrolled away from its inline start. */
+    isScrolled: boolean;
+    /** Records the scroll position reached by the container. */
+    handleScroll: (event: UIEvent<HTMLDivElement>) => void;
+};
+/**
+ * Tracks whether a container's content overflows it horizontally.
+ *
+ * Overflow is measured rather than assumed, so a scroll region only becomes
+ * focusable while there is content a keyboard user cannot otherwise reach.
+ *
+ * @note Falls back to resize events when `ResizeObserver` is unavailable.
+ *
+ * @returns The element references, overflow state, and scroll handler.
+ */
+export declare function useHorizontalOverflow(): HorizontalOverflow;

package/dist/components/Table/utils/cell.d.ts

@@ -0,0 +1,25 @@
+import type { ReactNode } from "react";
+/** A value rendered directly or formatted by a Table cell. */
+export type TableCellValue = boolean | Date | number | string;
+/** The horizontal alignment applied to Table cell content. */
+export type TableCellAlignment = "left" | "center" | "right";
+/** A function transforming a supplied value into displayed cell content. */
+export type TableCellFormatter = (value: TableCellValue) => ReactNode;
+/**
+ * Resolves the content displayed for a Table cell value.
+ *
+ * @param value - The supplied cell value.
+ * @param children - The fallback content used when no value is supplied.
+ * @param format - The optional consumer formatter applied to the value.
+ *
+ * @returns The content displayed inside the Table cell.
+ */
+export declare function resolveCellContent(value: TableCellValue | undefined, children: ReactNode, format: TableCellFormatter | undefined): ReactNode;
+/**
+ * Resolves a native title for truncated primitive content.
+ *
+ * @param content - The rendered content considered for a title.
+ *
+ * @returns A readable title, when the content can be represented as text.
+ */
+export declare function resolveTruncateTitle(content: ReactNode): string | undefined;