@astryxdesign/core 0.1.3 → 0.1.4-canary.01e5b29

package/dist/Table/plugins/columnResize/useTableColumnResize.js

@@ -22,7 +22,7 @@ import { observeResize, unobserveResize } from "../../../utils/sharedResizeObser
 // =============================================================================
 // Config Type
 // =============================================================================
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsxDEV as _jsxDEV, Fragment as _Fragment } from "react/jsx-dev-runtime";
 // =============================================================================
 // Constants
 // =============================================================================
@@ -445,10 +445,13 @@ function ResizeHandle({
     }
   }, [currentWidth, getRTLMultiplier, minWidth, maxWidth, buildSnapshotAndResize, tableRef]);
   const ariaLabel = typeof columnHeader === 'string' ? `Resize column ${columnHeader}` : `Resize column ${columnKey}`;
-  return /*#__PURE__*/_jsx("div", {
+  return /*#__PURE__*/_jsxDEV("div", {
     role: "separator",
-    "aria-orientation": "vertical",
-    "aria-valuenow": currentWidth ?? undefined,
+    "aria-orientation": "vertical"
+    // A focusable role="separator" requires a numeric aria-valuenow, so fall
+    // back to the column's minWidth before the width has been measured.
+    ,
+    "aria-valuenow": currentWidth ?? minWidth,
     "aria-valuemin": minWidth,
     "aria-valuemax": maxWidth === Infinity ? undefined : maxWidth,
     "aria-label": ariaLabel,
@@ -458,7 +461,7 @@ function ResizeHandle({
     ...{
       className: "x10l6tqk xtijo5x x13vifvy x1w0ack5 x1xc55vz x7eptgl x1vjfegm x5ve5x3 x87ps6o x1qfzo5y x1m3wso9 x11woleg xhj50sb x1s928wv x1j6awrg x1unh1gc x1m1drc7 x1xrz1ek xi8c0p9 x1i3206j xvtkv6q"
     }
-  });
+  }, void 0, false);
 }
 
 // =============================================================================
@@ -518,13 +521,13 @@ export function useTableColumnResize(config) {
   }, []);
   return useMemo(() => ({
     transformTableContext(children) {
-      return /*#__PURE__*/_jsx("div", {
+      return /*#__PURE__*/_jsxDEV("div", {
         ref: measureRef,
         style: {
           display: 'contents'
         },
         children: children
-      });
+      }, void 0, false);
     },
     transformHeaderCell(props, column) {
       // Skip columns that opt out of resizing
@@ -571,7 +574,7 @@ export function useTableColumnResize(config) {
         ...existingStyle,
         ...widthStyle
       } : widthStyle : existingStyle;
-      const handle = /*#__PURE__*/_jsx(ResizeHandle, {
+      const handle = /*#__PURE__*/_jsxDEV(ResizeHandle, {
         columnKey: column.key,
         columnHeader: column.header ?? column.key,
         currentWidth: overrideWidth,
@@ -582,16 +585,16 @@ export function useTableColumnResize(config) {
         dragStateRef: dragStateRef,
         isDraggingRef: isDraggingRef,
         tableRef: tableRef
-      }, `resize-${column.key}`);
+      }, `resize-${column.key}`, false);
       return {
         ...props,
         htmlProps: {
           ...props.htmlProps,
           style: mergedStyle
         },
-        overlay: /*#__PURE__*/_jsxs(_Fragment, {
+        overlay: /*#__PURE__*/_jsxDEV(_Fragment, {
           children: [props.overlay, handle]
-        }),
+        }, void 0, true),
         styles: [...props.styles, headerCellRelative.base]
       };
     }

package/dist/Table/plugins/filtering/useTableFiltering.js

@@ -48,7 +48,7 @@ import { proportional } from "../../columnUtils.js";
  *
  * Both require `searchConfig` on the plugin config.
  */
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsxDEV as _jsxDEV, Fragment as _Fragment } from "react/jsx-dev-runtime";
 // =============================================================================
 // PowerSearch → Table Filter Resolution
 // =============================================================================
@@ -292,7 +292,7 @@ function TextFilterControl({
   const config = store.getConfig();
   const value = config.filters[columnKey];
   const strValue = typeof value === 'string' ? value : '';
-  return /*#__PURE__*/_jsx(TextInput, {
+  return /*#__PURE__*/_jsxDEV(TextInput, {
     label: `Filter ${header}`,
     isLabelHidden: true,
     value: strValue,
@@ -302,7 +302,7 @@ function TextFilterControl({
     placeholder: `Filter ${header}`,
     size: size,
     hasClear: hasClear
-  });
+  }, void 0, false);
 }
 function NumberFilterControl({
   columnKey,
@@ -320,7 +320,7 @@ function NumberFilterControl({
     store.getConfig().onFilterChange(columnKey, newValue);
   }, [store, columnKey]);
   if (hasClear) {
-    return /*#__PURE__*/_jsx(NumberInput, {
+    return /*#__PURE__*/_jsxDEV(NumberInput, {
       label: `Filter ${header}`,
       isLabelHidden: true,
       value: numValue,
@@ -331,9 +331,9 @@ function NumberFilterControl({
       step: step,
       size: size,
       hasClear: true
-    });
+    }, void 0, false);
   }
-  return /*#__PURE__*/_jsx(NumberInput, {
+  return /*#__PURE__*/_jsxDEV(NumberInput, {
     label: `Filter ${header}`,
     isLabelHidden: true,
     value: numValue,
@@ -343,7 +343,7 @@ function NumberFilterControl({
     max: operatorValue.maxValue ?? null,
     step: step,
     size: size
-  });
+  }, void 0, false);
 }
 function SelectorFilterControl({
   columnKey,
@@ -364,7 +364,7 @@ function SelectorFilterControl({
     store.getConfig().onFilterChange(columnKey, newValue === '' || newValue == null ? null : newValue);
   }, [store, columnKey]);
   if (hasClear) {
-    return /*#__PURE__*/_jsx(Selector, {
+    return /*#__PURE__*/_jsxDEV(Selector, {
       label: `Filter ${header}`,
       isLabelHidden: true,
       options: options,
@@ -373,9 +373,9 @@ function SelectorFilterControl({
       placeholder: "All",
       size: size,
       hasClear: true
-    });
+    }, void 0, false);
   }
-  return /*#__PURE__*/_jsx(Selector, {
+  return /*#__PURE__*/_jsxDEV(Selector, {
     label: `Filter ${header}`,
     isLabelHidden: true,
     options: options,
@@ -383,7 +383,7 @@ function SelectorFilterControl({
     onChange: handleChange,
     placeholder: "All",
     size: size
-  });
+  }, void 0, false);
 }
 function MultiSelectorFilterControl({
   columnKey,
@@ -400,7 +400,7 @@ function MultiSelectorFilterControl({
     value: v.value,
     label: v.label
   }));
-  return /*#__PURE__*/_jsx(MultiSelector, {
+  return /*#__PURE__*/_jsxDEV(MultiSelector, {
     label: `Filter ${header}`,
     isLabelHidden: true,
     options: options,
@@ -413,7 +413,7 @@ function MultiSelectorFilterControl({
     hasSelectAll: true,
     hasSearch: false,
     hasClear: hasClear
-  });
+  }, void 0, false);
 }
 function DateFilterControl({
   columnKey,
@@ -423,7 +423,7 @@ function DateFilterControl({
 }) {
   const store = useFilterStore();
   const value = store.getConfig().filters[columnKey];
-  return /*#__PURE__*/_jsx(DateInput, {
+  return /*#__PURE__*/_jsxDEV(DateInput, {
     label: `Filter ${header}`,
     isLabelHidden: true,
     value: value ?? undefined,
@@ -432,7 +432,7 @@ function DateFilterControl({
     },
     size: size,
     hasClear: hasClear
-  });
+  }, void 0, false);
 }
 function TimeFilterControl({
   columnKey,
@@ -442,7 +442,7 @@ function TimeFilterControl({
 }) {
   const store = useFilterStore();
   const value = store.getConfig().filters[columnKey];
-  return /*#__PURE__*/_jsx(TimeInput, {
+  return /*#__PURE__*/_jsxDEV(TimeInput, {
     label: `Filter ${header}`,
     isLabelHidden: true,
     value: value ?? undefined,
@@ -451,7 +451,7 @@ function TimeFilterControl({
     },
     size: size,
     hasClear: hasClear
-  });
+  }, void 0, false);
 }
 function StringListFilterControl({
   columnKey,
@@ -473,7 +473,7 @@ function StringListFilterControl({
     bootstrap: () => []
   }), []);
   const searchSource = operatorValue.searchSource ?? fallbackSource;
-  return /*#__PURE__*/_jsx(Tokenizer, {
+  return /*#__PURE__*/_jsxDEV(Tokenizer, {
     label: `Filter ${header}`,
     isLabelHidden: true,
     searchSource: searchSource,
@@ -487,7 +487,7 @@ function StringListFilterControl({
     },
     size: size,
     hasClear: hasClear
-  });
+  }, void 0, false);
 }
 
 /** Renders the appropriate filter control for a column's operator value type. */
@@ -500,60 +500,60 @@ function FilterControl({
 }) {
   switch (operatorValue.type) {
     case 'string':
-      return /*#__PURE__*/_jsx(TextFilterControl, {
+      return /*#__PURE__*/_jsxDEV(TextFilterControl, {
         columnKey: columnKey,
         header: header,
         size: size,
         hasClear: hasClear
-      });
+      }, void 0, false);
     case 'integer':
     case 'float':
-      return /*#__PURE__*/_jsx(NumberFilterControl, {
+      return /*#__PURE__*/_jsxDEV(NumberFilterControl, {
         columnKey: columnKey,
         header: header,
         operatorValue: operatorValue,
         size: size,
         hasClear: hasClear
-      });
+      }, void 0, false);
     case 'enum':
-      return /*#__PURE__*/_jsx(SelectorFilterControl, {
+      return /*#__PURE__*/_jsxDEV(SelectorFilterControl, {
         columnKey: columnKey,
         header: header,
         operatorValue: operatorValue,
         size: size,
         hasClear: hasClear
-      });
+      }, void 0, false);
     case 'enum_list':
-      return /*#__PURE__*/_jsx(MultiSelectorFilterControl, {
+      return /*#__PURE__*/_jsxDEV(MultiSelectorFilterControl, {
         columnKey: columnKey,
         header: header,
         operatorValue: operatorValue,
         size: size,
         hasClear: hasClear
-      });
+      }, void 0, false);
     case 'date_absolute':
-      return /*#__PURE__*/_jsx(DateFilterControl, {
+      return /*#__PURE__*/_jsxDEV(DateFilterControl, {
         columnKey: columnKey,
         header: header,
         size: size,
         hasClear: hasClear
-      });
+      }, void 0, false);
     case 'time':
-      return /*#__PURE__*/_jsx(TimeFilterControl, {
+      return /*#__PURE__*/_jsxDEV(TimeFilterControl, {
         columnKey: columnKey,
         header: header,
         size: size,
         hasClear: hasClear
-      });
+      }, void 0, false);
     case 'string_list':
     case 'entity_list':
-      return /*#__PURE__*/_jsx(StringListFilterControl, {
+      return /*#__PURE__*/_jsxDEV(StringListFilterControl, {
         columnKey: columnKey,
         header: header,
         operatorValue: operatorValue,
         size: size,
         hasClear: hasClear
-      });
+      }, void 0, false);
     case 'nested':
     case 'empty':
     case 'date_relative':
@@ -613,46 +613,46 @@ function PopoverFilterTrigger({
       };
     }
   }), [store, columnKey, draft, setDraft]);
-  return /*#__PURE__*/_jsx(Popover, {
+  return /*#__PURE__*/_jsxDEV(Popover, {
     isOpen: isOpen,
     onOpenChange: handleOpen,
     label: `Filter ${header}`,
     placement: "below",
     alignment: "start",
-    content: /*#__PURE__*/_jsx(FilterStoreContext, {
+    content: /*#__PURE__*/_jsxDEV(FilterStoreContext, {
       value: draftStore,
-      children: /*#__PURE__*/_jsxs("div", {
+      children: /*#__PURE__*/_jsxDEV("div", {
         ...{
           className: "xafpxmx"
         },
-        children: [/*#__PURE__*/_jsx(FilterControl, {
+        children: [/*#__PURE__*/_jsxDEV(FilterControl, {
           columnKey: columnKey,
           header: header,
           operatorValue: operatorValue,
           size: "md"
-        }), /*#__PURE__*/_jsxs("div", {
+        }, void 0, false), /*#__PURE__*/_jsxDEV("div", {
           ...{
             className: "x78zum5 x1txdalj xtbrsbv"
           },
-          children: [/*#__PURE__*/_jsx(Button, {
+          children: [/*#__PURE__*/_jsxDEV(Button, {
             label: "Reset",
             variant: "ghost",
             size: "sm",
             onClick: handleClear
-          }), /*#__PURE__*/_jsx("div", {
+          }, void 0, false), /*#__PURE__*/_jsxDEV("div", {
             ...{
               className: "x98rzlu"
             }
-          }), /*#__PURE__*/_jsx(Button, {
+          }, void 0, false), /*#__PURE__*/_jsxDEV(Button, {
             label: "Apply",
             variant: "primary",
             size: "sm",
             onClick: handleApply
-          })]
-        })]
-      })
-    }),
-    children: /*#__PURE__*/_jsx("button", {
+          }, void 0, false)]
+        }, void 0, true)]
+      }, void 0, true)
+    }, void 0, false),
+    children: /*#__PURE__*/_jsxDEV("button", {
       type: "button",
       "aria-label": `Filter ${header}`,
       "aria-haspopup": "dialog",
@@ -664,13 +664,13 @@ function PopoverFilterTrigger({
           className: "x1ypdohk x3nfvp2 x6s0dn4 xl56j7k x1717udv xh6dtrn x2lah0s x1xrq5m x17aqpur x1hc1fzr"
         }
       }[!!hasValue << 0],
-      children: /*#__PURE__*/_jsx(Icon, {
+      children: /*#__PURE__*/_jsxDEV(Icon, {
         icon: "funnel",
         size: "xsm",
         color: hasValue ? 'accent' : 'secondary'
-      })
-    })
-  });
+      }, void 0, false)
+    }, void 0, false)
+  }, void 0, false);
 }
 
 // =============================================================================
@@ -703,16 +703,16 @@ function FilterSlot({
   header,
   operatorValue
 }) {
-  return /*#__PURE__*/_jsx("div", {
+  return /*#__PURE__*/_jsxDEV("div", {
     ...{
       className: "x78zum5 x6s0dn4 x2lah0s"
     },
-    children: /*#__PURE__*/_jsx(PopoverFilterTrigger, {
+    children: /*#__PURE__*/_jsxDEV(PopoverFilterTrigger, {
       columnKey: columnKey,
       header: header,
       operatorValue: operatorValue
-    })
-  });
+    }, void 0, false)
+  }, void 0, false);
 }
 
 /**
@@ -727,21 +727,21 @@ function InlineFilterSlot({
   const variant = use(FilterVariantContext);
   const size = 'sm';
   const placeholderStyle = variant === 'inline-compact' ? filterStyles.placeholderCompact : filterStyles.placeholder;
-  return /*#__PURE__*/_jsx("div", {
+  return /*#__PURE__*/_jsxDEV("div", {
     ...{
       className: "x78zum5 xdt5ytf xzye2dw xcsaf9d xeuugli"
     },
-    children: operatorValue != null ? /*#__PURE__*/_jsx(FilterControl, {
+    children: operatorValue != null ? /*#__PURE__*/_jsxDEV(FilterControl, {
       columnKey: columnKey,
       header: header,
       operatorValue: operatorValue,
       size: size,
       hasClear: true
-    }) : /*#__PURE__*/_jsx("div", {
+    }, void 0, false) : /*#__PURE__*/_jsxDEV("div", {
       "aria-hidden": "true",
       ...stylex.props(placeholderStyle)
-    })
-  });
+    }, void 0, false)
+  }, void 0, false);
 }
 
 // =============================================================================
@@ -806,13 +806,13 @@ export function useTableFiltering(config) {
       return col;
     }) : undefined,
     transformTableContext(children) {
-      return /*#__PURE__*/_jsx(FilterStoreContext, {
+      return /*#__PURE__*/_jsxDEV(FilterStoreContext, {
         value: store,
-        children: /*#__PURE__*/_jsx(FilterVariantContext, {
+        children: /*#__PURE__*/_jsxDEV(FilterVariantContext, {
           value: variant,
           children: children
-        })
-      });
+        }, void 0, false)
+      }, void 0, false);
     },
     transformHeaderCell(props, column) {
       const rawFilter = column.filter;
@@ -827,13 +827,13 @@ export function useTableFiltering(config) {
         }
         return {
           ...props,
-          after: /*#__PURE__*/_jsxs(_Fragment, {
-            children: [props.after, /*#__PURE__*/_jsx(FilterSlot, {
+          after: /*#__PURE__*/_jsxDEV(_Fragment, {
+            children: [props.after, /*#__PURE__*/_jsxDEV(FilterSlot, {
               columnKey: column.key,
               header: header,
               operatorValue: operatorValue
-            })]
-          })
+            }, void 0, false)]
+          }, void 0, true)
         };
       }
 
@@ -842,13 +842,13 @@ export function useTableFiltering(config) {
       // header content rather than inline after it.
       return {
         ...props,
-        below: /*#__PURE__*/_jsxs(_Fragment, {
-          children: [props.below, /*#__PURE__*/_jsx(InlineFilterSlot, {
+        below: /*#__PURE__*/_jsxDEV(_Fragment, {
+          children: [props.below, /*#__PURE__*/_jsxDEV(InlineFilterSlot, {
             columnKey: column.key,
             header: header,
             operatorValue: operatorValue
-          })]
-        })
+          }, void 0, false)]
+        }, void 0, true)
       };
     }
   }), [store, variant]);

package/dist/Table/plugins/pagination/paginateData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paginateData.d.ts","sourceRoot":"","sources":["../../../../src/Table/plugins/pagination/paginateData.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,CAAC,EAAE,CASL"}
+{"version":3,"file":"paginateData.d.ts","sourceRoot":"","sources":["../../../../src/Table/plugins/pagination/paginateData.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,CAAC,EAAE,CAaL"}

package/dist/Table/plugins/pagination/paginateData.js

@@ -32,6 +32,10 @@ export function paginateData(data, page, pageSize) {
   // pageSize would slice every page empty while the pagination chrome still
   // renders page buttons.
   const size = Number.isFinite(pageSize) ? Math.max(1, Math.floor(pageSize)) : 10;
-  const start = (page - 1) * size;
+  // page needs the same coercion: a negative start index makes Array.slice
+  // count from the END of the data (page -1 returns the tail dressed up as a
+  // page), and a fractional page returns a slice straddling two pages.
+  const p = Number.isFinite(page) ? Math.max(1, Math.floor(page)) : 1;
+  const start = (p - 1) * size;
   return data.slice(start, start + size);
 }

package/dist/Table/plugins/pagination/useTablePagination.js

@@ -20,7 +20,7 @@ import * as stylex from '@stylexjs/stylex';
 import "../../../theme/tokens.stylex.js";
 import { spacingVars } from "../../../theme/tokens.stylex.js";
 import { Pagination } from "../../../Pagination/index.js";
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsxDEV as _jsxDEV, Fragment as _Fragment } from "react/jsx-dev-runtime";
 // =============================================================================
 // Styles
 // =============================================================================
@@ -166,15 +166,15 @@ export function useTablePagination(config) {
       if (isSinglePage) {
         return children;
       }
-      const makeWrapper = side => /*#__PURE__*/_jsx("div", {
+      const makeWrapper = side => /*#__PURE__*/_jsxDEV("div", {
         ...stylex.props(styles.wrapper, side === 'below' && styles.marginTop, side === 'above' && styles.marginBottom, a === 'center' && styles.alignCenter, a === 'end' && styles.alignEnd, a === 'start' && styles.alignStart),
-        children: /*#__PURE__*/_jsx(Pagination, {
+        children: /*#__PURE__*/_jsxDEV(Pagination, {
           ...props
-        })
-      });
-      return /*#__PURE__*/_jsxs(_Fragment, {
+        }, void 0, false)
+      }, void 0, false);
+      return /*#__PURE__*/_jsxDEV(_Fragment, {
         children: [(pos === 'above' || pos === 'both') && makeWrapper('above'), children, (pos === 'below' || pos === 'both') && makeWrapper('below')]
-      });
+      }, void 0, true);
     }
   }), []);
 }

package/dist/Table/plugins/rowExpansion/index.d.ts

@@ -0,0 +1,3 @@
+export { useTableRowExpansion, useTableRowExpansionState, } from './useTableRowExpansion';
+export type { UseTableRowExpansionConfig } from './useTableRowExpansion';
+//# sourceMappingURL=index.d.ts.map

package/dist/Table/plugins/rowExpansion/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/Table/plugins/rowExpansion/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAC,0BAA0B,EAAC,MAAM,wBAAwB,CAAC"}

package/dist/Table/plugins/rowExpansion/index.js

@@ -0,0 +1,3 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+export { useTableRowExpansion, useTableRowExpansionState } from "./useTableRowExpansion.js";

package/dist/Table/plugins/rowExpansion/useTableRowExpansion.d.ts

@@ -0,0 +1,90 @@
+import type { TablePlugin } from '../../types';
+/**
+ * Configuration for useTableRowExpansion (inherited-columns mode).
+ *
+ * Child rows use the same columns as their parents, with indentation on the
+ * first content column. The consumer provides a **flat** data array (use
+ * {@link useTableRowExpansionState} to flatten a tree) and a `getDepth`
+ * function so the plugin knows each row's nesting level.
+ */
+export interface UseTableRowExpansionConfig<T extends Record<string, unknown>> {
+    /** Set of currently-expanded row keys. */
+    expandedKeys: Set<string>;
+    /** Called when a row's expansion is toggled. */
+    onToggle: (key: string) => void;
+    /** Derive a stable unique key from a row item. */
+    getRowKey: (item: T) => string;
+    /** Return the children of a row (used to determine expandability). */
+    getChildren: (item: T) => T[];
+    /** Return the depth of a row in the hierarchy (0 = top-level). */
+    getDepth?: (item: T) => number;
+    /** Optionally control which rows are expandable. @default checks getChildren length */
+    getIsItemExpandable?: (item: T) => boolean;
+    /**
+     * When true, clicking anywhere on the row toggles expansion (in addition to
+     * the chevron button). @default false — only the chevron triggers expansion.
+     */
+    hasRowClickExpansion?: boolean;
+    /**
+     * State of the expand-all toggle in the header. `true` = all expanded,
+     * `false` = all collapsed, `'indeterminate'` = mixed. When provided
+     * (together with `onToggleExpandAll`), the header cell shows a toggle button.
+     */
+    isAllExpanded?: boolean | 'indeterminate';
+    /** Called when the expand-all header toggle is clicked. */
+    onToggleExpandAll?: (expand: boolean) => void;
+}
+/**
+ * Configuration for {@link useTableRowExpansionState}.
+ *
+ * Mirrors the shape of {@link useTableSelectionState}: you own the
+ * `expandedKeys` set (via `useState`), and the hook derives everything the
+ * plugin needs — the flattened `data`, per-row depth, expand/collapse
+ * handlers, and the expand-all toggle state.
+ */
+export interface UseTableRowExpansionStateConfig<T extends Record<string, unknown>> {
+    /** The full, un-flattened tree. */
+    baseData: T[];
+    /** Return the children of a row. Leaf rows return an empty array. */
+    getChildren: (item: T) => T[];
+    /** Derive a stable unique key from a row item. */
+    getRowKey: (item: T) => string;
+    /**
+     * Should this row be expandable? Rows that return `false` never show a
+     * chevron and are skipped by expand-all. @default rows with children
+     */
+    getIsItemExpandable?: (item: T) => boolean;
+    /** Controlled set of currently-expanded row keys. */
+    expandedKeys: Set<string>;
+    /** Setter for the controlled expanded keys. */
+    setExpandedKeys: React.Dispatch<React.SetStateAction<Set<string>>>;
+}
+export interface UseTableRowExpansionStateResult<T extends Record<string, unknown>> {
+    /** The flattened, currently-visible rows. Pass to `<Table data>`. */
+    data: T[];
+    /** Ready-to-use config for {@link useTableRowExpansion}. */
+    expansionConfig: UseTableRowExpansionConfig<T>;
+}
+/**
+ * Manages row-expansion state and derives the config for
+ * {@link useTableRowExpansion}. This is the recommended entry point — it
+ * removes the boilerplate of flattening the tree, tracking depth, and
+ * computing the expand-all state.
+ *
+ * @example
+ * ```tsx
+ * const [expandedKeys, setExpandedKeys] = useState<Set<string>>(new Set());
+ * const {data, expansionConfig} = useTableRowExpansionState({
+ *   baseData: tree,
+ *   getChildren: item => item.children ?? [],
+ *   getRowKey: item => item.id,
+ *   expandedKeys,
+ *   setExpandedKeys,
+ * });
+ * const expansion = useTableRowExpansion(expansionConfig);
+ * <Table data={data} columns={columns} idKey="id" plugins={{expansion}} />;
+ * ```
+ */
+export declare function useTableRowExpansionState<T extends Record<string, unknown>>({ baseData, getChildren, getRowKey, getIsItemExpandable, expandedKeys, setExpandedKeys, }: UseTableRowExpansionStateConfig<T>): UseTableRowExpansionStateResult<T>;
+export declare function useTableRowExpansion<T extends Record<string, unknown>>(config: UseTableRowExpansionConfig<T>): TablePlugin<T>;
+//# sourceMappingURL=useTableRowExpansion.d.ts.map

package/dist/Table/plugins/rowExpansion/useTableRowExpansion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableRowExpansion.d.ts","sourceRoot":"","sources":["../../../../src/Table/plugins/rowExpansion/useTableRowExpansion.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,WAAW,EAKZ,MAAM,aAAa,CAAC;AAMrB;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3E,0CAA0C;IAC1C,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,gDAAgD;IAChD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,kDAAkD;IAClD,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC/B,sEAAsE;IACtE,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC/B,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IAC3C;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,eAAe,CAAC;IAC1C,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC/C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,+BAA+B,CAC9C,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEjC,mCAAmC;IACnC,QAAQ,EAAE,CAAC,EAAE,CAAC;IACd,qEAAqE;IACrE,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IAC9B,kDAAkD;IAClD,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC/B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IAC3C,qDAAqD;IACrD,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,+CAA+C;IAC/C,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,+BAA+B,CAC9C,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEjC,qEAAqE;IACrE,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,4DAA4D;IAC5D,eAAe,EAAE,0BAA0B,CAAC,CAAC,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC3E,QAAQ,EACR,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,eAAe,GAChB,EAAE,+BAA+B,CAAC,CAAC,CAAC,GAAG,+BAA+B,CAAC,CAAC,CAAC,CAyHzE;AAuGD,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpE,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAC,GACpC,WAAW,CAAC,CAAC,CAAC,CAwOhB"}