@versaur/react 1.0.10 → 1.0.12

package/dist/blocks.d.ts

@@ -29,6 +29,7 @@ import { ElementType } from 'react';
 import { FormHTMLAttributes } from 'react';
 import { ForwardRefExoticComponent } from 'react';
 import { HTMLAttributes } from 'react';
+import { Icon } from '@versaur/core/primitive';
 import { Menu as Menu_2 } from '@versaur/core/blocks';
 import { Modal as Modal_2 } from '@versaur/core/blocks';
 import { MouseEvent as MouseEvent_2 } from 'react';
@@ -36,8 +37,6 @@ import { ReactNode } from 'react';
 import { RefAttributes } from 'react';
 import { SVGProps } from 'react';
 import { TableCellVariant } from '@versaur/core/blocks';
-import { TdHTMLAttributes } from 'react';
-import { ThHTMLAttributes } from 'react';
 
 export declare const Accordion: AccordionComponent;
 
@@ -620,6 +619,12 @@ export declare interface FormGroupSeparatorProps extends HTMLAttributes<HTMLHREl
  */
 declare function getPanelAttribute(value: string): TabsPanelAttributes;
 
+declare type IconProps = Omit<SVGProps<SVGSVGElement>, "ref"> & {
+    as: ComponentType<SVGProps<SVGSVGElement>>;
+    intent?: Icon.Intent | "inherit";
+    size?: Icon.Size | "inherit";
+};
+
 export declare namespace Menu {
     export type Placement = MenuPlacement;
     export type DataAttrs = Menu_2.DataAttrs;
@@ -1135,94 +1140,161 @@ declare interface SidebarType extends ForwardRefExoticComponent<SidebarRootProps
 }
 
 export declare const Table: React.ForwardRefExoticComponent<TableWrapperProps & React.RefAttributes<HTMLDivElement>> & {
+    Toolbar: typeof TableToolbar;
     Header: typeof TableHeader;
     Body: typeof TableBody;
     Footer: typeof TableFooter;
     Row: typeof TableRow;
-    HeaderCell: typeof TableHeaderCell;
-    BodyCell: typeof TableBodyCell;
+    Col: typeof TableCol;
     Checkbox: typeof TableCheckbox;
     DoubleLine: typeof TableDoubleLine;
     Action: typeof TableAction;
+    ActionItem: typeof TableActionItem;
 };
 
 /**
- * TableAction - Built-in button for action column using ButtonIcon
+ * TableAction - Action trigger using Menu dropdown with action items
  */
-declare const TableAction: ForwardRefExoticComponent<TableActionProps & RefAttributes<HTMLButtonElement>>;
+declare const TableAction: ForwardRefExoticComponent<TableActionProps & RefAttributes<HTMLDivElement>>;
 
 /**
- * Built-in action button for action column
+ * TableActionItem - Menu-based action item (uses Menu.Item internally)
  */
-export declare interface TableActionProps {
+declare const TableActionItem: ForwardRefExoticComponent<MenuItemProps & RefAttributes<HTMLButtonElement>>;
+
+/**
+ * Table.ActionItem - clickable menu item within Table.Action dropdown
+ */
+export declare interface TableActionItemProps extends HTMLAttributes<HTMLButtonElement> {
     /**
-     * Callback when button is clicked
+     * Callback when item is clicked
      */
-    onClick?: () => void;
+    onClick?: (e: React.MouseEvent<HTMLButtonElement>) => void;
     /**
-     * Disable the button
+     * Disable the item
      */
     disabled?: boolean;
 }
 
 /**
- * TableBody - tbody wrapper
+ * Table.Action - action trigger with Tooltip dropdown
  */
-declare const TableBody: ForwardRefExoticComponent<TableBodyProps & RefAttributes<HTMLTableSectionElement>>;
+export declare interface TableActionProps {
+    /**
+     * Icon element to render in the trigger button
+     */
+    icon: IconProps["as"];
+    /**
+     * Tooltip content: Table.ActionItem elements
+     */
+    children: ReactNode;
+}
 
 /**
- * TableBodyCell - td wrapper (renamed from TableCell)
+ * TableBody - container for data rows
  */
-declare const TableBodyCell: ForwardRefExoticComponent<TdHTMLAttributes<HTMLTableCellElement> & {
-variant?: TableCellVariant;
-} & RefAttributes<HTMLTableCellElement>>;
+declare const TableBody: ForwardRefExoticComponent<TableBodyProps & RefAttributes<HTMLDivElement>>;
 
 /**
- * Table body cell (renamed from TableCellProps)
- * Default vertical centering for content
+ * Table.Body - container for data rows
  */
-export declare type TableBodyCellProps = TdHTMLAttributes<HTMLTableCellElement> & {
-    variant?: TableCellVariant;
-};
-
-export declare type TableBodyProps = HTMLAttributes<HTMLTableSectionElement>;
+export declare type TableBodyProps = HTMLAttributes<HTMLDivElement>;
 
 /**
- * TableCheckbox - Built-in checkbox for row-level selection
+ * TableCheckbox - Built-in checkbox for row selection
  */
 declare const TableCheckbox: ForwardRefExoticComponent<TableCheckboxProps & RefAttributes<HTMLInputElement>>;
 
 /**
- * Built-in checkbox for row selection
+ * Table.Checkbox - built-in checkbox for row selection
  */
-export declare interface TableCheckboxProps {
+export declare type TableCheckboxProps = {
+    /**
+     * Whether this is the select-all checkbox in the header
+     */
+    isMain: true;
+    /**
+     * Unique row identifier (not needed for main checkbox)
+     */
+    rowId?: never;
+    /**
+     * Whether checkbox is checked (optional - managed by Table context)
+     */
+    checked?: boolean;
+    /**
+     * Indeterminate state (e.g., for select-all checkbox)
+     */
+    indeterminate?: boolean;
+    /**
+     * Callback when checkbox state changes (optional - managed by Table context)
+     */
+    onChange?: (checked: boolean) => void;
+} | {
+    /**
+     * Whether this is the select-all checkbox in the header
+     * @default false
+     */
+    isMain?: false;
     /**
      * Unique row identifier
      */
     rowId: string | number;
     /**
-     * Whether checkbox is checked
+     * Whether checkbox is checked (optional - managed by Table context)
      */
     checked?: boolean;
     /**
-     * Indeterminate state (e.g., for parent checkbox)
+     * Indeterminate state (e.g., for select-all checkbox)
      */
     indeterminate?: boolean;
     /**
-     * Callback when checkbox state changes
+     * Callback when checkbox state changes (optional - managed by Table context)
      */
-    onChange: (checked: boolean) => void;
-}
+    onChange?: (checked: boolean) => void;
+};
 
 /**
- * TableDoubleLine - Built-in cell with title and subtitle
+ * TableCol - polymorphic cell with grid area support
  */
-declare const TableDoubleLine: ForwardRefExoticComponent<TableDoubleLineProps & RefAttributes<HTMLDivElement>>;
+declare const TableCol: ForwardRefExoticComponent<HTMLAttributes<any> & {
+as?: "th" | "td" | "div";
+area?: string;
+variant?: TableCellVariant;
+} & RefAttributes<any>>;
 
 /**
- * Built-in double-line cell (title + subtitle)
+ * Table.Col - polymorphic cell with grid area support
  */
-export declare interface TableDoubleLineProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "subtitle"> {
+export declare type TableColProps = HTMLAttributes<any> & {
+    /**
+     * HTML element type: 'th' for headers, 'td' for data cells, 'div' for generic
+     * @default 'div'
+     */
+    as?: "th" | "td" | "div";
+    /**
+     * CSS grid area (e.g., "span 2", "1 / 3")
+     */
+    area?: string;
+    /**
+     * Cell variant for styling
+     */
+    variant?: TableCellVariant;
+};
+
+/**
+ * TableDoubleLine - Built-in cell with title and subtitle using typography tokens
+ */
+declare const TableDoubleLine: ForwardRefExoticComponent<TableDoubleLineProps & RefAttributes<any>>;
+
+/**
+ * Table.DoubleLine - built-in cell with title and subtitle
+ */
+export declare interface TableDoubleLineProps extends Omit<HTMLAttributes<any>, "title"> {
+    /**
+     * HTML element type: 'th' for headers, 'td' for data cells, 'div' for generic
+     * @default 'div'
+     */
+    as?: "th" | "td" | "div";
     /**
      * Main title (bold, primary color)
      */
@@ -1239,66 +1311,75 @@ export declare interface TableDoubleLineProps extends Omit<HTMLAttributes<HTMLDi
 }
 
 /**
- * TableFooter - tfoot wrapper
+ * TableFooter - container for footer row(s)
  */
-declare const TableFooter: ForwardRefExoticComponent<TableFooterProps & RefAttributes<HTMLTableSectionElement>>;
+declare const TableFooter: ForwardRefExoticComponent<TableFooterProps & RefAttributes<HTMLDivElement>>;
 
-export declare type TableFooterProps = HTMLAttributes<HTMLTableSectionElement>;
+/**
+ * Table.Footer - container for footer row(s)
+ */
+export declare type TableFooterProps = HTMLAttributes<HTMLDivElement>;
 
 /**
- * TableHeader - thead wrapper
+ * TableHeader - container for header columns
  */
-declare const TableHeader: ForwardRefExoticComponent<TableHeaderProps & RefAttributes<HTMLTableSectionElement>>;
+declare const TableHeader: ForwardRefExoticComponent<TableHeaderProps & RefAttributes<HTMLDivElement>>;
 
 /**
- * TableHeaderCell - th wrapper with sortable support (renamed from TableHead)
+ * Table.Header - container for header columns
  */
-declare const TableHeaderCell: ForwardRefExoticComponent<ThHTMLAttributes<HTMLTableCellElement> & {
-sortable?: boolean;
-sortDirection?: "asc" | "desc" | null;
-onSort?: (direction: "asc" | "desc" | null) => void;
-} & RefAttributes<HTMLTableCellElement>>;
+export declare type TableHeaderProps = HTMLAttributes<HTMLDivElement>;
 
 /**
- * Table header cell (renamed from TableHeadProps)
- * Supports sortable headers with controlled sort direction
+ * TableRow - wrapper for cells
  */
-export declare type TableHeaderCellProps = ThHTMLAttributes<HTMLTableCellElement> & {
-    /**
-     * Enable sortable header with visual indicator
-     */
-    sortable?: boolean;
-    /**
-     * Current sort direction ('asc' | 'desc' | null for no sort, chevron always visible when sortable)
-     */
-    sortDirection?: "asc" | "desc" | null;
-    /**
-     * Callback when user clicks sortable header
-     */
-    onSort?: (direction: "asc" | "desc" | null) => void;
-};
+declare const TableRow: ForwardRefExoticComponent<TableRowProps & RefAttributes<HTMLDivElement>>;
 
-export declare type TableHeaderProps = HTMLAttributes<HTMLTableSectionElement>;
+/**
+ * Table.Row - wrapper for cells
+ */
+export declare type TableRowProps = HTMLAttributes<HTMLDivElement>;
+
+/**
+ * Selection state data passed to toolbar render function
+ */
+declare interface TableSelectionData {
+    selected: Set<string | number>;
+    allSelected: boolean;
+    someSelected: boolean;
+}
 
 /**
- * TableRow - tr wrapper with click-to-select support
+ * TableToolbar - renders toolbar content with optional render functions for left and right slots
  */
-declare const TableRow: ForwardRefExoticComponent<TableRowProps & RefAttributes<HTMLTableRowElement>>;
+declare const TableToolbar: ForwardRefExoticComponent<TableToolbarProps & RefAttributes<HTMLDivElement>>;
 
-export declare type TableRowProps = HTMLAttributes<HTMLTableRowElement>;
+/**
+ * Table.Toolbar - generic slot for action controls with optional render functions
+ */
+export declare interface TableToolbarProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /**
+     * Render function for left-aligned content (receives selected row IDs Set)
+     */
+    leftContent?: ReactNode | ((selectedIds: Set<string | number>) => ReactNode);
+    /**
+     * Render function for right-aligned content (receives selected row IDs Set)
+     */
+    rightContent?: ReactNode | ((selectedIds: Set<string | number>) => ReactNode);
+}
 
 /**
- * Table wrapper props with CSS Grid column definition
+ * Table root wrapper with CSS Grid column definition
  */
 export declare type TableWrapperProps = HTMLAttributes<HTMLDivElement> & {
     /**
-     * CSS Grid template columns string (e.g., "2fr 1fr 1fr min-content")
+     * CSS Grid template columns string (e.g., "repeat(3, 1fr)", "2fr 1fr 1fr")
      */
-    columns: string;
+    columns?: string;
     /**
-     * Set of selected row IDs for row-level selection state (controlled)
+     * Callback fired when row selection changes
      */
-    selectedRows?: Set<string | number>;
+    onSelectionChange?: (data: TableSelectionData) => void;
 };
 
 export declare const Tabs: TabsComponent;