@navikt/ds-react 8.10.5 → 8.10.6

package/esm/data/table/helpers/selection/getMultipleSelectProps.js

@@ -1,67 +1,57 @@
-import { SelectionSubtreeHelper } from "./SelectionSubtreeHelper.js";
-function getMultipleSelectProps({ selectedKeysSet, selectedKeys, setSelectedKeys, disabledKeysSet, visibleRowIds, childRowIdsById, }) {
-    const subtreeHelper = new SelectionSubtreeHelper({
-        childRowIdsById,
-        disabledKeysSet,
-        selectedKeysSet,
-    });
-    // Header selection traverses the visible roots and skips already visited
-    // descendants, so expanded trees stay linear in the number of rows.
-    const headerSelectableKeys = subtreeHelper.getSelectableKeys(visibleRowIds);
-    const headerSelectableKeysSet = new Set(headerSelectableKeys);
-    const selectedSelectableCount = headerSelectableKeys.filter((k) => selectedKeysSet.has(k)).length;
-    const allSelectableSelected = headerSelectableKeys.length > 0 &&
-        selectedSelectableCount === headerSelectableKeys.length;
-    const indeterminate = selectedSelectableCount > 0 &&
-        selectedSelectableCount < headerSelectableKeys.length;
-    const selectedKeysNotInView = selectedKeys.filter((k) => !headerSelectableKeysSet.has(k));
-    const disabledSelected = selectedKeys.filter((k) => disabledKeysSet.has(k));
-    const preservedKeys = [
-        ...new Set([...selectedKeysNotInView, ...disabledSelected]),
-    ];
-    const isGroupFullySelected = (key) => {
-        const groupStats = subtreeHelper.getSelectionStats(key);
-        return (groupStats.selectableCount > 0 &&
-            groupStats.selectedCount === groupStats.selectableCount);
-    };
-    const handleToggleAll = () => {
-        if (allSelectableSelected) {
-            setSelectedKeys(preservedKeys);
+import { consoleWarning } from "../../../../utils/helpers/consoleWarning.js";
+import { canSelectTableRow, mutateRowSelection } from "./selection.utils.js";
+function getMultipleSelectProps({ selectedKeysSet, selectedKeys, setSelectedKeys, enableRowSelection, tableItems, }) {
+    const selectableIdsSet = new Set();
+    for (const [id, { rowData }] of tableItems.itemDetails) {
+        if (canSelectTableRow(enableRowSelection, { row: rowData, id })) {
+            selectableIdsSet.add(id);
         }
-        else {
-            setSelectedKeys([
-                ...new Set([...preservedKeys, ...headerSelectableKeys]),
-            ]);
+    }
+    let selectedOnPageCount = 0;
+    for (const id of selectableIdsSet) {
+        selectedKeysSet.has(id) && selectedOnPageCount++;
+    }
+    const isAllSelected = selectableIdsSet.size > 0 && selectedOnPageCount === selectableIdsSet.size;
+    const someSelected = selectedOnPageCount > 0;
+    const handleToggleRow = (key, row) => {
+        if (!row) {
+            consoleWarning(`Row data is undefined for key ${key}. This may cause issues with selection if enableRowSelection is used.`);
         }
-    };
-    const handleToggleRow = (key) => {
-        if (disabledKeysSet.has(key)) {
-            return;
+        const checked = !selectedKeysSet.has(key);
+        const nextSet = new Set(selectedKeysSet);
+        const changed = mutateRowSelection({
+            selectedRowIds: nextSet,
+            rowId: key,
+            checked,
+            childRowIdsById: tableItems.childRowIdsById,
+            itemDetails: tableItems.itemDetails,
+            enableRowSelection,
+        });
+        if (changed) {
+            setSelectedKeys([...nextSet]);
         }
-        const groupKeys = subtreeHelper.getSelectableKeys([key]);
-        if (isGroupFullySelected(key)) {
-            const groupKeysSet = new Set(groupKeys);
-            setSelectedKeys(selectedKeys.filter((selectedKey) => !groupKeysSet.has(selectedKey)));
+    };
+    const toggleAllRowSelected = (event) => {
+        if (event.target.checked) {
+            const preserved = selectedKeys.filter((k) => !selectableIdsSet.has(k));
+            setSelectedKeys([...preserved, ...selectableIdsSet]);
         }
         else {
-            setSelectedKeys([...new Set([...selectedKeys, ...groupKeys])]);
+            setSelectedKeys(selectedKeys.filter((k) => !selectableIdsSet.has(k)));
         }
     };
     return {
         getTheadCheckboxProps: () => ({
-            onChange: handleToggleAll,
-            checked: allSelectableSelected,
-            indeterminate,
-            disabled: headerSelectableKeys.length === 0,
+            checked: isAllSelected,
+            indeterminate: !isAllSelected && someSelected,
+            onChange: toggleAllRowSelected,
         }),
-        getRowCheckboxProps: (key) => {
-            const groupStats = subtreeHelper.getSelectionStats(key);
+        getRowCheckboxProps: (key, row) => {
             return {
-                onChange: () => handleToggleRow(key),
-                checked: isGroupFullySelected(key),
-                indeterminate: groupStats.selectedCount > 0 &&
-                    groupStats.selectedCount < groupStats.selectableCount,
-                disabled: disabledKeysSet.has(key),
+                onChange: () => handleToggleRow(key, row),
+                checked: selectedKeysSet.has(key),
+                indeterminate: false,
+                disabled: !canSelectTableRow(enableRowSelection, { row, id: key }),
             };
         },
         toggleSelection: handleToggleRow,

package/esm/data/table/helpers/selection/getMultipleSelectProps.js.map

@@ -1 +1 @@
-{"version":3,"file":"getMultipleSelectProps.js","sourceRoot":"","sources":["../../../../../src/data/table/helpers/selection/getMultipleSelectProps.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"getMultipleSelectProps.js","sourceRoot":"","sources":["../../../../../src/data/table/helpers/selection/getMultipleSelectProps.ts"],"names":[],"mappings":"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"}

package/esm/data/table/helpers/selection/getSingleSelectProps.d.ts

@@ -1,12 +1,13 @@
 import type { RadioInputProps } from "../../../../form/radio/radio-input/RadioInput.js";
-type GetSingleSelectPropsArgs = {
-    selectedKeysSet: Set<string | number>;
-    setSelectedKeys: (keys: (string | number)[]) => void;
-    disabledKeysSet: Set<string | number>;
+import type { TableRowEntryId } from "../../root/DataTable.types.js";
+import type { SelectedKeysT, SelectionProps } from "./selection.types.js";
+type GetSingleSelectPropsArgs<T> = {
+    selectedKeysSet: Set<TableRowEntryId>;
+    setSelectedKeys: (keys: SelectedKeysT) => void;
     name: string;
-};
-declare function getSingleSelectProps({ selectedKeysSet, setSelectedKeys, disabledKeysSet, name, }: GetSingleSelectPropsArgs): {
-    getRowRadioProps: (key: string | number) => RadioInputProps;
-    toggleSelection: (key: string | number) => void;
+} & Pick<SelectionProps<T>, "enableRowSelection">;
+declare function getSingleSelectProps<T>({ selectedKeysSet, setSelectedKeys, name, enableRowSelection, }: GetSingleSelectPropsArgs<T>): {
+    getRowRadioProps: (key: TableRowEntryId, row: T) => RadioInputProps;
+    toggleSelection: (key: TableRowEntryId, row: T) => void;
 };
 export { getSingleSelectProps };

package/esm/data/table/helpers/selection/getSingleSelectProps.js

@@ -1,18 +1,31 @@
-function getSingleSelectProps({ selectedKeysSet, setSelectedKeys, disabledKeysSet, name, }) {
-    const handleSelectionChange = (key) => {
-        if (disabledKeysSet.has(key)) {
+import { consoleWarning } from "../../../../utils/helpers/consoleWarning.js";
+import { canSelectTableRow } from "./selection.utils.js";
+function getSingleSelectProps({ selectedKeysSet, setSelectedKeys, name, enableRowSelection, }) {
+    const handleSelectionChange = (key, row) => {
+        if (!row) {
+            consoleWarning(`Row data is undefined for key ${key}. This may cause issues with selection if enableRowSelection is used.`);
+        }
+        if (!canSelectTableRow(enableRowSelection, { row, id: key })) {
             return;
         }
         setSelectedKeys([key]);
     };
     return {
-        getRowRadioProps: (key) => ({
-            checked: selectedKeysSet.has(key),
-            onChange: () => handleSelectionChange(key),
-            disabled: disabledKeysSet.has(key),
-            value: key,
-            name,
-        }),
+        getRowRadioProps: (key, row) => {
+            const isSelectionDisabled = !canSelectTableRow(enableRowSelection, {
+                row,
+                id: key,
+            });
+            return {
+                checked: selectedKeysSet.has(key),
+                onChange: isSelectionDisabled
+                    ? () => null
+                    : () => handleSelectionChange(key, row),
+                disabled: isSelectionDisabled,
+                value: key,
+                name,
+            };
+        },
         toggleSelection: handleSelectionChange,
     };
 }

package/esm/data/table/helpers/selection/getSingleSelectProps.js.map

@@ -1 +1 @@
-{"version":3,"file":"getSingleSelectProps.js","sourceRoot":"","sources":["../../../../../src/data/table/helpers/selection/getSingleSelectProps.ts"],"names":[],"mappings":"AASA,SAAS,oBAAoB,CAAC,EAC5B,eAAe,EACf,eAAe,EACf,eAAe,EACf,IAAI,GACqB;IACzB,MAAM,qBAAqB,GAAG,CAAC,GAAoB,EAAE,EAAE;QACrD,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,OAAO;QACL,gBAAgB,EAAE,CAAC,GAAoB,EAAmB,EAAE,CAAC,CAAC;YAC5D,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;YACjC,QAAQ,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC,GAAG,CAAC;YAC1C,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;YAClC,KAAK,EAAE,GAAG;YACV,IAAI;SACL,CAAC;QACF,eAAe,EAAE,qBAAqB;KACvC,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"getSingleSelectProps.js","sourceRoot":"","sources":["../../../../../src/data/table/helpers/selection/getSingleSelectProps.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAG1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAQtD,SAAS,oBAAoB,CAAI,EAC/B,eAAe,EACf,eAAe,EACf,IAAI,EACJ,kBAAkB,GACU;IAC5B,MAAM,qBAAqB,GAAG,CAAC,GAAoB,EAAE,GAAM,EAAE,EAAE;QAC7D,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,cAAc,CACZ,iCAAiC,GAAG,uEAAuE,CAC5G,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;YAC7D,OAAO;QACT,CAAC;QAED,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,OAAO;QACL,gBAAgB,EAAE,CAAC,GAAoB,EAAE,GAAM,EAAmB,EAAE;YAClE,MAAM,mBAAmB,GAAG,CAAC,iBAAiB,CAAC,kBAAkB,EAAE;gBACjE,GAAG;gBACH,EAAE,EAAE,GAAG;aACR,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;gBACjC,QAAQ,EAAE,mBAAmB;oBAC3B,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI;oBACZ,CAAC,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC;gBACzC,QAAQ,EAAE,mBAAmB;gBAC7B,KAAK,EAAE,GAAG;gBACV,IAAI;aACL,CAAC;QACJ,CAAC;QACD,eAAe,EAAE,qBAAqB;KACvC,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/esm/data/table/helpers/selection/selection.types.d.ts

@@ -1,7 +1,8 @@
 import type { CheckboxInputProps } from "../../../../form/checkbox/checkbox-input/CheckboxInput.js";
 import type { RadioInputProps } from "../../../../form/radio/radio-input/RadioInput.js";
-type SelectedKeysT = (string | number)[];
-type SelectionProps = {
+import type { TableRowEntryId } from "../../root/DataTable.types.js";
+type SelectedKeysT = TableRowEntryId[];
+type SelectionProps<T = any> = {
     /**
      * Enables selection of rows.
      *
@@ -12,7 +13,7 @@ type SelectionProps = {
      *
      * @default "none"
      */
-    selectionMode?: "none" | "single" | "multiple";
+    selectionMode: "none" | "single" | "multiple";
     /**
      * Controlled selected keys. Should be used in conjunction with `onSelectionChange`.
      */
@@ -26,41 +27,40 @@ type SelectionProps = {
      */
     onSelectionChange?: (keys: SelectedKeysT) => void;
     /**
-     * Keys that should be disabled for selection. These keys will not be selectable and will be styled as disabled.
+     * Callback to determine if a row should be enabled for selection.
      *
      *
-     * TODO: Consider making this optionally a callback with (rowData:T) => boolean, to allow for more dynamic disabling of selection based on row data.
+     * If set to a boolean, it will enable selection for all rows when true, and disable selection for all rows when false.
      */
-    disabledSelectionKeys?: SelectedKeysT;
+    enableRowSelection?: (({ row, id }: {
+        row: T;
+        id: TableRowEntryId;
+    }) => boolean) | boolean;
     /**
-     * If true, stops clicking a row from toggling its selection state. This can be used if you want to only allow selection through the checkboxes/radios, and not have the entire row be clickable for selection.
-     *
-     * @default false
+     * Determines if selection is triggered by clicking the row or the selection control (checkbox/radio).
+     * @default "row"
      */
-    disableRowSelectionOnClick?: boolean;
+    selectionTrigger?: "row" | "control";
 };
 type NoneSelection = {
     selectionMode: "none";
     selectedKeys: SelectedKeysT;
-    disabledSelectionKeys: SelectedKeysT;
 };
 type SingleSelection = {
     selectionMode: "single";
     selectedKeys: SelectedKeysT;
-    disabledSelectionKeys: SelectedKeysT;
-    getRowRadioProps: (key: string | number) => RadioInputProps;
-    toggleSelection: (key: string | number) => void;
+    getRowRadioProps: (key: TableRowEntryId, row: any) => RadioInputProps;
+    toggleSelection: (key: TableRowEntryId, row: any) => void;
 };
 type MultipleSelection = {
     selectionMode: "multiple";
     selectedKeys: SelectedKeysT;
-    disabledSelectionKeys: SelectedKeysT;
     getTheadCheckboxProps: () => CheckboxInputProps;
-    getRowCheckboxProps: (key: string | number) => CheckboxInputProps;
-    toggleSelection: (key: string | number) => void;
+    getRowCheckboxProps: (key: TableRowEntryId, row: any) => CheckboxInputProps;
+    toggleSelection: (key: TableRowEntryId, row: any) => void;
 };
 type TableSelectionBase = {
-    isRowSelected: (rowId: string | number) => boolean;
+    isRowSelected: (rowId: TableRowEntryId) => boolean;
 };
 type TableSelection = TableSelectionBase & (NoneSelection | SingleSelection | MultipleSelection);
-export type { MultipleSelection, NoneSelection, SelectionProps, SingleSelection, TableSelection, SelectedKeysT, };
+export type { MultipleSelection, NoneSelection, SelectedKeysT, SelectionProps, SingleSelection, TableSelection, };

package/esm/data/table/helpers/selection/selection.utils.d.ts

@@ -0,0 +1,21 @@
+import type { TableRowEntryId } from "../../root/DataTable.types.js";
+import type { ItemDetail } from "../collectTableRowEntries.js";
+import type { SelectionProps } from "./selection.types.js";
+declare function canSelectTableRow<T>(enableRowSelection: SelectionProps<T>["enableRowSelection"], args: {
+    row: T;
+    id: TableRowEntryId;
+}): boolean;
+type MutateRowSelectionArgs<T> = {
+    selectedRowIds: Set<TableRowEntryId>;
+    rowId: TableRowEntryId;
+    checked: boolean;
+    childRowIdsById: Map<TableRowEntryId, TableRowEntryId[]>;
+    itemDetails: Map<TableRowEntryId, ItemDetail<T>>;
+    enableRowSelection?: SelectionProps<T>["enableRowSelection"];
+};
+/**
+ * Traverses the row and its children and updates selected-state directly on given selectedRowIds set.
+ * Returns true if any changes were made to the set, false otherwise.
+ */
+declare function mutateRowSelection<T>({ selectedRowIds, rowId, checked, childRowIdsById, itemDetails, enableRowSelection, }: MutateRowSelectionArgs<T>): boolean;
+export { canSelectTableRow, mutateRowSelection };

package/esm/data/table/helpers/selection/selection.utils.js

@@ -0,0 +1,43 @@
+function canSelectTableRow(enableRowSelection, args) {
+    if (typeof enableRowSelection === "function") {
+        return enableRowSelection(args);
+    }
+    return enableRowSelection !== null && enableRowSelection !== void 0 ? enableRowSelection : true;
+}
+/**
+ * Traverses the row and its children and updates selected-state directly on given selectedRowIds set.
+ * Returns true if any changes were made to the set, false otherwise.
+ */
+function mutateRowSelection({ selectedRowIds, rowId, checked, childRowIdsById, itemDetails, enableRowSelection, }) {
+    let changed = false;
+    const item = itemDetails.get(rowId);
+    if (item &&
+        canSelectTableRow(enableRowSelection, { row: item.rowData, id: rowId })) {
+        if (checked && !selectedRowIds.has(rowId)) {
+            selectedRowIds.add(rowId);
+            changed = true;
+        }
+        else if (!checked && selectedRowIds.has(rowId)) {
+            selectedRowIds.delete(rowId);
+            changed = true;
+        }
+    }
+    const children = childRowIdsById.get(rowId);
+    if (children) {
+        for (const childId of children) {
+            if (mutateRowSelection({
+                selectedRowIds,
+                rowId: childId,
+                checked,
+                childRowIdsById,
+                itemDetails,
+                enableRowSelection,
+            })) {
+                changed = true;
+            }
+        }
+    }
+    return changed;
+}
+export { canSelectTableRow, mutateRowSelection };
+//# sourceMappingURL=selection.utils.js.map

package/esm/data/table/helpers/selection/selection.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.utils.js","sourceRoot":"","sources":["../../../../../src/data/table/helpers/selection/selection.utils.ts"],"names":[],"mappings":"AAIA,SAAS,iBAAiB,CACxB,kBAA2D,EAC3D,IAAqC;IAErC,IAAI,OAAO,kBAAkB,KAAK,UAAU,EAAE,CAAC;QAC7C,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,kBAAkB,aAAlB,kBAAkB,cAAlB,kBAAkB,GAAI,IAAI,CAAC;AACpC,CAAC;AAWD;;;GAGG;AACH,SAAS,kBAAkB,CAAI,EAC7B,cAAc,EACd,KAAK,EACL,OAAO,EACP,eAAe,EACf,WAAW,EACX,kBAAkB,GACQ;IAC1B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEpC,IACE,IAAI;QACJ,iBAAiB,CAAC,kBAAkB,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EACvE,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC1B,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,IAAI,CAAC,OAAO,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7B,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IACE,kBAAkB,CAAC;gBACjB,cAAc;gBACd,KAAK,EAAE,OAAO;gBACd,OAAO;gBACP,eAAe;gBACf,WAAW;gBACX,kBAAkB;aACnB,CAAC,EACF,CAAC;gBACD,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAC"}

package/esm/data/table/hooks/useColumnOptions.d.ts

@@ -1,19 +1,30 @@
 import type { ColumnDefinition, ColumnDefinitions } from "../root/DataTable.types.js";
-import type { SelectionProps } from "./useTableSelection.js";
 type UseColumnOptions = {
     stickyColumns?: {
-        first?: "1";
-        last?: "1";
+        start?: "1";
+        end?: "1";
     };
-    selectionMode: SelectionProps["selectionMode"];
+    hasSelection: boolean;
+    hasDetailsPanel: boolean;
+    layout: "fixed" | "auto";
+};
+type StickyStartState = {
+    selection: boolean;
+    expansion: boolean;
+    selectionOffset: number;
+    firstColumnOffset: number;
 };
 type UseColumnOptionsResult<T> = {
     columns: {
         isSticky: "start" | "end" | false;
+        isStickyLast?: boolean;
+        stickyLeftOffset?: number;
         colDef: ColumnDefinition<T>;
     }[];
-    stickySelection: boolean;
+    stickyStart: StickyStartState;
+    totalColSpan: number;
 };
 declare function useColumnOptions<T>(columnDefinitions: ColumnDefinitions<T>, options: UseColumnOptions): UseColumnOptionsResult<T>;
 export { useColumnOptions };
+export type { StickyStartState };
 export type { UseColumnOptionsResult };

package/esm/data/table/hooks/useColumnOptions.js

@@ -1,29 +1,47 @@
 import { useMemo } from "react";
+import { ACTION_CELL_WIDTH } from "../tr/DataTableTr.js";
 function useColumnOptions(columnDefinitions, options) {
-    const { stickyColumns, selectionMode } = options;
-    const hasSelection = selectionMode !== "none";
+    const { stickyColumns, hasSelection, hasDetailsPanel, layout } = options;
+    const hasStickyStart = (stickyColumns === null || stickyColumns === void 0 ? void 0 : stickyColumns.start) === "1";
+    const stickyExpansion = hasStickyStart && hasDetailsPanel;
+    const stickySelection = hasStickyStart && hasSelection;
+    const stickySelectionOffset = stickyExpansion ? ACTION_CELL_WIDTH : 0;
+    const stickyFirstColumnOffset = (stickyExpansion ? ACTION_CELL_WIDTH : 0) +
+        (stickySelection ? ACTION_CELL_WIDTH : 0);
     const columns = useMemo(() => {
         return columnDefinitions.map((colDef, index) => {
-            const isFirstSticky = (stickyColumns === null || stickyColumns === void 0 ? void 0 : stickyColumns.first) === "1" && index === 0 && !hasSelection;
-            const isLastSticky = (stickyColumns === null || stickyColumns === void 0 ? void 0 : stickyColumns.last) === "1" && index === columnDefinitions.length - 1;
+            const isFirstSticky = hasStickyStart && index === 0;
+            const isLastSticky = (stickyColumns === null || stickyColumns === void 0 ? void 0 : stickyColumns.end) === "1" && index === columnDefinitions.length - 1;
             return {
                 isSticky: isFirstSticky
                     ? "start"
                     : isLastSticky
                         ? "end"
                         : false,
+                isStickyLast: isFirstSticky && !isLastSticky,
+                stickyLeftOffset: isFirstSticky ? stickyFirstColumnOffset : undefined,
                 colDef,
             };
         });
     }, [
         columnDefinitions,
-        hasSelection,
-        stickyColumns === null || stickyColumns === void 0 ? void 0 : stickyColumns.first,
-        stickyColumns === null || stickyColumns === void 0 ? void 0 : stickyColumns.last,
+        hasStickyStart,
+        stickyColumns,
+        stickyFirstColumnOffset,
     ]);
+    const totalColSpan = columns.length +
+        (layout === "fixed" ? 1 : 0) +
+        (hasSelection ? 1 : 0) +
+        (hasDetailsPanel ? 1 : 0);
     return {
-        stickySelection: selectionMode !== "none" && (stickyColumns === null || stickyColumns === void 0 ? void 0 : stickyColumns.first) === "1",
+        stickyStart: {
+            selection: stickySelection,
+            expansion: stickyExpansion,
+            selectionOffset: stickySelectionOffset,
+            firstColumnOffset: stickyFirstColumnOffset,
+        },
         columns,
+        totalColSpan,
     };
 }
 export { useColumnOptions };

package/esm/data/table/hooks/useColumnOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"useColumnOptions.js","sourceRoot":"","sources":["../../../../src/data/table/hooks/useColumnOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAuBhC,SAAS,gBAAgB,CACvB,iBAAuC,EACvC,OAAyB;IAEzB,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAEjD,MAAM,YAAY,GAAG,aAAa,KAAK,MAAM,CAAC;IAE9C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3B,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YAC7C,MAAM,aAAa,GACjB,CAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,KAAK,MAAK,GAAG,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC;YAC/D,MAAM,YAAY,GAChB,CAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,IAAI,MAAK,GAAG,IAAI,KAAK,KAAK,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC;YAExE,OAAO;gBACL,QAAQ,EAAE,aAAa;oBACrB,CAAC,CAAE,OAAiB;oBACpB,CAAC,CAAC,YAAY;wBACZ,CAAC,CAAE,KAAe;wBAClB,CAAC,CAAE,KAAe;gBACtB,MAAM;aACP,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,EAAE;QACD,iBAAiB;QACjB,YAAY;QACZ,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,KAAK;QACpB,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,IAAI;KACpB,CAAC,CAAC;IAEH,OAAO;QACL,eAAe,EAAE,aAAa,KAAK,MAAM,IAAI,CAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,KAAK,MAAK,GAAG;QACzE,OAAO;KACR,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"useColumnOptions.js","sourceRoot":"","sources":["../../../../src/data/table/hooks/useColumnOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAKhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AA8BtD,SAAS,gBAAgB,CACvB,iBAAuC,EACvC,OAAyB;IAEzB,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAEzE,MAAM,cAAc,GAAG,CAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,KAAK,MAAK,GAAG,CAAC;IAEpD,MAAM,eAAe,GAAG,cAAc,IAAI,eAAe,CAAC;IAC1D,MAAM,eAAe,GAAG,cAAc,IAAI,YAAY,CAAC;IAEvD,MAAM,qBAAqB,GAAG,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,uBAAuB,GAC3B,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3B,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YAC7C,MAAM,aAAa,GAAG,cAAc,IAAI,KAAK,KAAK,CAAC,CAAC;YACpD,MAAM,YAAY,GAChB,CAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,GAAG,MAAK,GAAG,IAAI,KAAK,KAAK,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC;YAEvE,OAAO;gBACL,QAAQ,EAAE,aAAa;oBACrB,CAAC,CAAE,OAAiB;oBACpB,CAAC,CAAC,YAAY;wBACZ,CAAC,CAAE,KAAe;wBAClB,CAAC,CAAE,KAAe;gBACtB,YAAY,EAAE,aAAa,IAAI,CAAC,YAAY;gBAC5C,gBAAgB,EAAE,aAAa,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,SAAS;gBACrE,MAAM;aACP,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,EAAE;QACD,iBAAiB;QACjB,cAAc;QACd,aAAa;QACb,uBAAuB;KACxB,CAAC,CAAC;IAEH,MAAM,YAAY,GAChB,OAAO,CAAC,MAAM;QACd,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5B,OAAO;QACL,WAAW,EAAE;YACX,SAAS,EAAE,eAAe;YAC1B,SAAS,EAAE,eAAe;YAC1B,eAAe,EAAE,qBAAqB;YACtC,iBAAiB,EAAE,uBAAuB;SAC3C;QACD,OAAO;QACP,YAAY;KACb,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/esm/data/table/hooks/useTableDetailsPanel.d.ts

@@ -1,10 +1,11 @@
 import React from "react";
+import type { TableRowEntryId } from "../root/DataTable.types.js";
 type DetailsPanelProps<T> = {
     /**
-     * Renders a details panel below the row when expanded.
+     * Function to get the content to show in the details panel for a given row.
      * When provided, an expand toggle column is added automatically.
      */
-    getContent?: (rowData: T) => React.ReactNode;
+    getContent: (rowData: T) => React.ReactNode;
     /**
      * Determines whether a row can be expanded to show details panel content.
      * @default () => true
@@ -14,20 +15,16 @@ type DetailsPanelProps<T> = {
      * Controlled list of expanded row IDs.
      * Use with `onDetailsPanelChange` for controlled usage, or `defaultDetailsPanelRowIds` for uncontrolled.
      */
-    expandedRowIds?: (string | number)[];
+    expandedRowIds?: TableRowEntryId[];
     /**
      * Initial list of expanded row IDs for uncontrolled usage.
      * @default []
      */
-    defaultExpandedRowIds?: (string | number)[];
+    defaultExpandedRowIds?: TableRowEntryId[];
     /**
      * Called when the list of expanded row IDs changes.
-     *
-     *
-     * TODO:
-     * - Docs: This pattern is called "Master / Detail" in general terms
      */
-    onExpandedRowIdsChange?: (ids: (string | number)[]) => void;
+    onExpandedRowIdsChange?: (ids: TableRowEntryId[]) => void;
     /**
      * Returns the height (in px) or `"auto"` for a row's details panel.
      * When a number is returned, the panel scrolls within that fixed height.
@@ -41,9 +38,9 @@ type DetailsPanelProps<T> = {
     showExpandAll?: boolean;
 };
 type DataTableDetailsPanelContextT = {
-    isExpanded: (id: string | number) => boolean;
-    isDetailsPanelExpandable: (id: string | number) => boolean;
-    toggleExpansion: (id: string | number) => void;
+    isExpanded: (id: TableRowEntryId) => boolean;
+    isDetailsPanelExpandable: (id: TableRowEntryId) => boolean;
+    toggleExpansion: (id: TableRowEntryId) => void;
     toggleAll: () => void;
     isAllExpanded: boolean;
     getDetailsPanelContent?: (row: unknown) => React.ReactNode;
@@ -57,6 +54,6 @@ declare function DataTableDetailsPanelProvider<T>({ children, detailsPanel, }: {
 } & {
     children: React.ReactNode;
 }): React.JSX.Element;
-declare function getDataTableDetailsPanelId(tableId: string, rowId: string | number): string;
+declare function getDataTableDetailsPanelId(tableId: string, rowId: TableRowEntryId): string;
 export { DataTableDetailsPanelProvider, getDataTableDetailsPanelId, useDataTableDetailsPanel, };
 export type { DetailsPanelProps };

package/esm/data/table/hooks/useTableDetailsPanel.js

@@ -1,21 +1,22 @@
 import React, { useCallback } from "react";
 import { createStrictContext } from "../../../utils/helpers/index.js";
 import { useControllableState } from "../../../utils/hooks/index.js";
-import { useTableItemsContext } from "./useTableItems.js";
+import { useDataTableContext } from "../root/DataTableRoot.context.js";
 const { Provider: DataTableDetailsPanelContextProvider, useContext: useDataTableDetailsPanel, } = createStrictContext({
     name: "DataTableDetailsPanelContext",
     errorMessage: "useDataTableDetailsPanel must be used within a DataTableDetailsPanelProvider.",
 });
-function DataTableDetailsPanelProvider({ children, detailsPanel = {}, }) {
-    const { expandedRowIds, defaultExpandedRowIds = [], onExpandedRowIdsChange, getContent, isRowExpandable, getHeight, showExpandAll = false, } = detailsPanel;
+function DataTableDetailsPanelProvider({ children, detailsPanel, }) {
+    var _a;
+    const { expandedRowIds, defaultExpandedRowIds = [], onExpandedRowIdsChange, getContent, isRowExpandable, getHeight, showExpandAll = false, } = detailsPanel || {};
     const [expandedIds, setExpandedIds] = useControllableState({
         value: expandedRowIds,
         defaultValue: defaultExpandedRowIds,
         onChange: onExpandedRowIdsChange,
     });
     /* TODO: False is just fallback until auto and root is merged */
-    const tableItemsContext = useTableItemsContext(false);
-    const { itemDetails } = tableItemsContext !== null && tableItemsContext !== void 0 ? tableItemsContext : {
+    const tableContext = useDataTableContext(false);
+    const { itemDetails } = (_a = tableContext === null || tableContext === void 0 ? void 0 : tableContext.tableItems) !== null && _a !== void 0 ? _a : {
         itemDetails: new Map(),
     };
     const expandableIds = React.useMemo(() => {

package/esm/data/table/hooks/useTableDetailsPanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTableDetailsPanel.js","sourceRoot":"","sources":["../../../../src/data/table/hooks/useTableDetailsPanel.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"useTableDetailsPanel.js","sourceRoot":"","sources":["../../../../src/data/table/hooks/useTableDetailsPanel.tsx"],"names":[],"mappings":"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"}

package/esm/data/table/hooks/useTableItems.d.ts

@@ -1,30 +1,44 @@
-import { type ItemDetail, type TableRowEntryId } from "../helpers/collectTableRowEntries.js";
+import { type ItemDetail } from "../helpers/collectTableRowEntries.js";
+import type { TableRowEntryId } from "../root/DataTable.types.js";
 type SubRowsProps<T> = {
-    getRows?: (rowData: T) => T[];
-    expandedRowIds?: (string | number)[];
-    defaultExpandedRowIds?: (string | number)[];
+    /**
+     * Function to get sub-rows for a given row.
+     */
+    getRows: (rowData: T) => T[];
+    /**
+     * Controlled list of IDs of rows that should be expanded.
+     */
+    expandedRowIds?: TableRowEntryId[];
+    /**
+     * IDs of rows that should be initially expanded.
+     * Only used when `expandedRowIds` is not provided, i.e. when the expanded state is uncontrolled.
+     */
+    defaultExpandedRowIds?: TableRowEntryId[];
+    /**
+     * Called when the list of expanded row IDs changes.
+     */
+    onExpandedRowIdsChange?: (ids: TableRowEntryId[]) => void;
+    /**
+     * Function to get whether a row should be expandable.
+     * By default, all rows are expandable when `getRows` is provided.
+     */
     isRowExpandable?: (rowData: T) => boolean;
-    onExpandedRowIdsChange?: (ids: (string | number)[]) => void;
 };
 type UseTableItemsArgs<T> = {
     items: T[];
     getRowId?: (rowData: T) => TableRowEntryId;
     subRows?: SubRowsProps<T>;
 };
-type useTableItemsReturn<T> = {
+type UseTableItemsReturn<T> = {
     items: T[];
     itemDetails: Map<TableRowEntryId, ItemDetail<T>>;
     /** Row ids for the rows currently rendered in the table body. */
     visibleRowIds: TableRowEntryId[];
     /** Direct child ids for each row, used to traverse selection groups lazily. */
     childRowIdsById: Map<TableRowEntryId, TableRowEntryId[]>;
-    onExpandedRowIdsChange: (id: string | number) => void;
-    isSubRowExpanded: (id: string | number) => boolean;
+    onExpandedRowIdsChange: (id: TableRowEntryId) => void;
+    isSubRowExpanded: (id: TableRowEntryId) => boolean;
 };
-declare function useTableItems<T>(args: UseTableItemsArgs<T>): useTableItemsReturn<T>;
-declare const TableItemsProvider: import("react").FC<Omit<useTableItemsReturn<any>, "childRowIdsById"> & {
-    children: React.ReactNode;
-    ref?: never;
-}>, useTableItemsContext: <S extends boolean = true>(strict?: S | undefined) => S extends true ? Omit<useTableItemsReturn<any>, "childRowIdsById"> : Omit<useTableItemsReturn<any>, "childRowIdsById"> | undefined;
-export { useTableItems, TableItemsProvider, useTableItemsContext };
-export type { ItemDetail, SubRowsProps };
+declare function useTableItems<T>(args: UseTableItemsArgs<T>): UseTableItemsReturn<T>;
+export { useTableItems };
+export type { ItemDetail, SubRowsProps, UseTableItemsReturn };