handsontable 18.0.0 → 18.1.0-rc1

package/plugins/nestedHeaders/stateManager/settingsNormalizer.js

@@ -48,7 +48,7 @@ function normalizeSettings(sourceSettings, columnsLimit = Infinity) {
    */ const normalizeHeaderSettings = (sourceHeaderSettings)=>{
         const headerSettings = (0, _utils.createDefaultHeaderSettings)();
         if ((0, _object.isObject)(sourceHeaderSettings)) {
-            const { label, colspan, rowspan, headerClassName, visibleWhen } = sourceHeaderSettings;
+            const { label, colspan, rowspan, headerClassName, visibleWhen, columnDropMode } = sourceHeaderSettings;
             headerSettings.label = (0, _mixed.stringify)(label);
             if (typeof colspan === 'number' && colspan > 1) {
                 headerSettings.colspan = colspan;
@@ -69,6 +69,10 @@ function normalizeSettings(sourceSettings, columnsLimit = Infinity) {
             if (typeof visibleWhen === 'string' && VISIBLE_WHEN_VALUES.includes(visibleWhen)) {
                 headerSettings.visibleWhen = visibleWhen;
             }
+            // Only `'split'` enables splitting; any other (or unset) value keeps the adopt default.
+            if (columnDropMode === 'split') {
+                headerSettings.columnDropMode = 'split';
+            }
         } else {
             headerSettings.label = (0, _mixed.stringify)(sourceHeaderSettings);
         }

package/plugins/nestedHeaders/stateManager/settingsNormalizer.mjs

@@ -75,7 +75,7 @@ const VISIBLE_WHEN_VALUES = [
    */ const normalizeHeaderSettings = (sourceHeaderSettings)=>{
         const headerSettings = createDefaultHeaderSettings();
         if (isObject(sourceHeaderSettings)) {
-            const { label, colspan, rowspan, headerClassName, visibleWhen } = sourceHeaderSettings;
+            const { label, colspan, rowspan, headerClassName, visibleWhen, columnDropMode } = sourceHeaderSettings;
             headerSettings.label = stringify(label);
             if (typeof colspan === 'number' && colspan > 1) {
                 headerSettings.colspan = colspan;
@@ -96,6 +96,10 @@ const VISIBLE_WHEN_VALUES = [
             if (typeof visibleWhen === 'string' && VISIBLE_WHEN_VALUES.includes(visibleWhen)) {
                 headerSettings.visibleWhen = visibleWhen;
             }
+            // Only `'split'` enables splitting; any other (or unset) value keeps the adopt default.
+            if (columnDropMode === 'split') {
+                headerSettings.columnDropMode = 'split';
+            }
         } else {
             headerSettings.label = stringify(sourceHeaderSettings);
         }

package/plugins/nestedHeaders/stateManager/sourceSettings.d.ts

@@ -1,7 +1,11 @@
-interface SourceHeaderCell {
+import type { ColumnDropMode } from './utils';
+export interface SourceHeaderCell {
     colspan?: number;
     origColspan?: number;
     isPlaceholder?: boolean;
+    columnDropMode?: ColumnDropMode;
+    headerClassNames?: string[];
+    crossHiddenColumns?: number[];
     [key: string]: unknown;
 }
 /**
@@ -32,6 +36,16 @@ export default class SourceSettings {
      * @param {Array[]} [nestedHeadersSettings=[]] The user-defined nested headers settings.
      */
     setData(nestedHeadersSettings?: unknown[][]): void;
+    /**
+     * Sets already-normalized source settings directly, bypassing normalization.
+     *
+     * Used to feed a derived (e.g. visual-order) settings matrix that is already in the normalized
+     * shape, so it must not be re-normalized. Callers are responsible for passing a well-formed matrix
+     * with equal-length layers.
+     *
+     * @param {Array[]} normalizedSettings The already-normalized nested headers settings.
+     */
+    setNormalizedData(normalizedSettings: SourceHeaderCell[][]): void;
     /**
      * Gets normalized source settings.
      *
@@ -73,7 +87,9 @@ export default class SourceSettings {
      */
     getHeadersSettings(headerLevel: number, columnIndex: number, columnsLength?: number): unknown[];
     /**
-     * Inserts `amount` columns into the normalized settings starting at the visual `columnIndex`.
+     * Inserts `amount` columns into the normalized settings starting at `columnIndex`. The index is a
+     * position within the authored, source-order settings (which the StateManager keys by physical
+     * column), not a visual index.
      *
      * The behavior mirrors the MergeCells plugin: a column inserted strictly inside a header's span
      * extends that header (and every ancestor that also spans the point), while a column inserted at a
@@ -81,19 +97,21 @@ export default class SourceSettings {
      * In the normalized representation "strictly inside a span" is exactly "the cell at the insert
      * index is a placeholder".
      *
-     * @param {number} columnIndex A visual column index at which the new columns are inserted.
+     * @param {number} columnIndex A source-order column index at which the new columns are inserted.
      * @param {number} amount The number of columns to insert.
      */
     insertColumns(columnIndex: number, amount: number): void;
     /**
-     * Removes `amount` columns from the normalized settings starting at the visual `columnIndex`.
+     * Removes `amount` columns from the normalized settings starting at `columnIndex`. The index is a
+     * position within the authored, source-order settings (which the StateManager keys by physical
+     * column), not a visual index.
      *
      * Every header that overlaps the removed range is shrunk by the number of removed columns it
      * covered. A header that loses all its columns is dropped; a header whose leftmost (labeled)
      * column is removed but which still has surviving columns is re-anchored to the first surviving
      * column, keeping its label and configurable properties.
      *
-     * @param {number} columnIndex A visual column index from which the columns are removed.
+     * @param {number} columnIndex A source-order column index from which the columns are removed.
      * @param {number} amount The number of columns to remove.
      */
     removeColumns(columnIndex: number, amount: number): void;
@@ -114,4 +132,3 @@ export default class SourceSettings {
      */
     clear(): void;
 }
-export {};

package/plugins/nestedHeaders/stateManager/sourceSettings.js

@@ -27,15 +27,12 @@ function _check_private_redeclaration(obj, privateCollection) {
     }
 }
 function _class_apply_descriptor_get(receiver, descriptor) {
-    if (descriptor.get) {
-        return descriptor.get.call(receiver);
-    }
+    if (descriptor.get) return descriptor.get.call(receiver);
     return descriptor.value;
 }
 function _class_apply_descriptor_set(receiver, descriptor, value) {
-    if (descriptor.set) {
-        descriptor.set.call(receiver, value);
-    } else {
+    if (descriptor.set) descriptor.set.call(receiver, value);
+    else {
         if (!descriptor.writable) {
             throw new TypeError("attempted to set read only private field");
         }
@@ -43,9 +40,7 @@ function _class_apply_descriptor_set(receiver, descriptor, value) {
     }
 }
 function _class_extract_field_descriptor(receiver, privateMap, action) {
-    if (!privateMap.has(receiver)) {
-        throw new TypeError("attempted to " + action + " private field on non-instance");
-    }
+    if (!privateMap.has(receiver)) throw new TypeError("attempted to " + action + " private field on non-instance");
     return privateMap.get(receiver);
 }
 function _class_private_field_get(receiver, privateMap) {
@@ -99,6 +94,18 @@ class SourceSettings {
         _class_private_field_set(this, _dataLength, _class_private_field_get(this, _data).length);
     }
     /**
+   * Sets already-normalized source settings directly, bypassing normalization.
+   *
+   * Used to feed a derived (e.g. visual-order) settings matrix that is already in the normalized
+   * shape, so it must not be re-normalized. Callers are responsible for passing a well-formed matrix
+   * with equal-length layers.
+   *
+   * @param {Array[]} normalizedSettings The already-normalized nested headers settings.
+   */ setNormalizedData(normalizedSettings) {
+        _class_private_field_set(this, _data, normalizedSettings);
+        _class_private_field_set(this, _dataLength, normalizedSettings.length);
+    }
+    /**
    * Gets normalized source settings.
    *
    * @returns {Array[]}
@@ -186,7 +193,9 @@ class SourceSettings {
         return headersSettingsChunks;
     }
     /**
-   * Inserts `amount` columns into the normalized settings starting at the visual `columnIndex`.
+   * Inserts `amount` columns into the normalized settings starting at `columnIndex`. The index is a
+   * position within the authored, source-order settings (which the StateManager keys by physical
+   * column), not a visual index.
    *
    * The behavior mirrors the MergeCells plugin: a column inserted strictly inside a header's span
    * extends that header (and every ancestor that also spans the point), while a column inserted at a
@@ -194,7 +203,7 @@ class SourceSettings {
    * In the normalized representation "strictly inside a span" is exactly "the cell at the insert
    * index is a placeholder".
    *
-   * @param {number} columnIndex A visual column index at which the new columns are inserted.
+   * @param {number} columnIndex A source-order column index at which the new columns are inserted.
    * @param {number} amount The number of columns to insert.
    */ insertColumns(columnIndex, amount) {
         (0, _array.arrayEach)(_class_private_field_get(this, _data), (cells)=>{
@@ -221,14 +230,16 @@ class SourceSettings {
         });
     }
     /**
-   * Removes `amount` columns from the normalized settings starting at the visual `columnIndex`.
+   * Removes `amount` columns from the normalized settings starting at `columnIndex`. The index is a
+   * position within the authored, source-order settings (which the StateManager keys by physical
+   * column), not a visual index.
    *
    * Every header that overlaps the removed range is shrunk by the number of removed columns it
    * covered. A header that loses all its columns is dropped; a header whose leftmost (labeled)
    * column is removed but which still has surviving columns is re-anchored to the first surviving
    * column, keeping its label and configurable properties.
    *
-   * @param {number} columnIndex A visual column index from which the columns are removed.
+   * @param {number} columnIndex A source-order column index from which the columns are removed.
    * @param {number} amount The number of columns to remove.
    */ removeColumns(columnIndex, amount) {
         const endIndex = columnIndex + amount;

package/plugins/nestedHeaders/stateManager/sourceSettings.mjs

@@ -4,15 +4,12 @@ function _check_private_redeclaration(obj, privateCollection) {
     }
 }
 function _class_apply_descriptor_get(receiver, descriptor) {
-    if (descriptor.get) {
-        return descriptor.get.call(receiver);
-    }
+    if (descriptor.get) return descriptor.get.call(receiver);
     return descriptor.value;
 }
 function _class_apply_descriptor_set(receiver, descriptor, value) {
-    if (descriptor.set) {
-        descriptor.set.call(receiver, value);
-    } else {
+    if (descriptor.set) descriptor.set.call(receiver, value);
+    else {
         if (!descriptor.writable) {
             throw new TypeError("attempted to set read only private field");
         }
@@ -20,9 +17,7 @@ function _class_apply_descriptor_set(receiver, descriptor, value) {
     }
 }
 function _class_extract_field_descriptor(receiver, privateMap, action) {
-    if (!privateMap.has(receiver)) {
-        throw new TypeError("attempted to " + action + " private field on non-instance");
-    }
+    if (!privateMap.has(receiver)) throw new TypeError("attempted to " + action + " private field on non-instance");
     return privateMap.get(receiver);
 }
 function _class_private_field_get(receiver, privateMap) {
@@ -85,6 +80,18 @@ class SourceSettings {
         _class_private_field_set(this, _dataLength, _class_private_field_get(this, _data).length);
     }
     /**
+   * Sets already-normalized source settings directly, bypassing normalization.
+   *
+   * Used to feed a derived (e.g. visual-order) settings matrix that is already in the normalized
+   * shape, so it must not be re-normalized. Callers are responsible for passing a well-formed matrix
+   * with equal-length layers.
+   *
+   * @param {Array[]} normalizedSettings The already-normalized nested headers settings.
+   */ setNormalizedData(normalizedSettings) {
+        _class_private_field_set(this, _data, normalizedSettings);
+        _class_private_field_set(this, _dataLength, normalizedSettings.length);
+    }
+    /**
    * Gets normalized source settings.
    *
    * @returns {Array[]}
@@ -172,7 +179,9 @@ class SourceSettings {
         return headersSettingsChunks;
     }
     /**
-   * Inserts `amount` columns into the normalized settings starting at the visual `columnIndex`.
+   * Inserts `amount` columns into the normalized settings starting at `columnIndex`. The index is a
+   * position within the authored, source-order settings (which the StateManager keys by physical
+   * column), not a visual index.
    *
    * The behavior mirrors the MergeCells plugin: a column inserted strictly inside a header's span
    * extends that header (and every ancestor that also spans the point), while a column inserted at a
@@ -180,7 +189,7 @@ class SourceSettings {
    * In the normalized representation "strictly inside a span" is exactly "the cell at the insert
    * index is a placeholder".
    *
-   * @param {number} columnIndex A visual column index at which the new columns are inserted.
+   * @param {number} columnIndex A source-order column index at which the new columns are inserted.
    * @param {number} amount The number of columns to insert.
    */ insertColumns(columnIndex, amount) {
         arrayEach(_class_private_field_get(this, _data), (cells)=>{
@@ -207,14 +216,16 @@ class SourceSettings {
         });
     }
     /**
-   * Removes `amount` columns from the normalized settings starting at the visual `columnIndex`.
+   * Removes `amount` columns from the normalized settings starting at `columnIndex`. The index is a
+   * position within the authored, source-order settings (which the StateManager keys by physical
+   * column), not a visual index.
    *
    * Every header that overlaps the removed range is shrunk by the number of removed columns it
    * covered. A header that loses all its columns is dropped; a header whose leftmost (labeled)
    * column is removed but which still has surviving columns is re-anchored to the first surviving
    * column, keeping its label and configurable properties.
    *
-   * @param {number} columnIndex A visual column index from which the columns are removed.
+   * @param {number} columnIndex A source-order column index from which the columns are removed.
    * @param {number} amount The number of columns to remove.
    */ removeColumns(columnIndex, amount) {
         const endIndex = columnIndex + amount;

package/plugins/nestedHeaders/stateManager/utils.d.ts

@@ -6,6 +6,10 @@
  * @property {number} rowspan Current calculated rowspan value of the rendered column header element.
  * @property {number} origRowspan Original rowspan value, set once while parsing user-defined nested header settings.
  * @property {boolean} collapsible The flag determines whether the node is collapsible (can be collapsed/expanded).
+ * @property {('adopt'|'split')} columnDropMode Determines what the group does when a column move drops a foreign
+ *                                column (one belonging to another group) into its span. When `'adopt'` (default)
+ *                                the group stays one banner and adopts that column as a child. When `'split'` the
+ *                                group keeps its identity and renders as several same-label banners (it splits).
  * @property {number[]} crossHiddenColumns The list of visual column indexes which indicates that the specified columns within
  *                                         the header settings are hidden.
  * @property {boolean} isCollapsed The flag determines whether the node is collapsed.
@@ -31,19 +35,30 @@
  * `'expanded'` - it is hidden when the group collapses, matching the default collapse behavior.
  */
 export type HeaderVisibility = 'collapsed' | 'expanded' | 'always';
+/**
+ * Determines what a group does when a column move drops a foreign column (one belonging to another
+ * group) into its span:
+ * - `'adopt'` (default) - the group stays a single banner and adopts that column as a child;
+ * - `'split'` - the group keeps its identity and renders as several same-label banners around the
+ *   foreign column (it splits).
+ *
+ * A group always reclaims its own columns moved back into its span, regardless of this setting.
+ */
+export type ColumnDropMode = 'adopt' | 'split';
 /**
  * Creates the header settings object with default values.
  *
  * @param {DefaultHeaderSettings} initialValues The initial values for the header settings object.
  * @returns {DefaultHeaderSettings}
  */
-export declare function createDefaultHeaderSettings({ label, colspan, origColspan, rowspan, origRowspan, collapsible, crossHiddenColumns, isCollapsed, isHidden, isRoot, isPlaceholder, isRowspanPlaceholder, headerClassNames, visibleWhen }?: {
+export declare function createDefaultHeaderSettings({ label, colspan, origColspan, rowspan, origRowspan, collapsible, columnDropMode, crossHiddenColumns, isCollapsed, isHidden, isRoot, isPlaceholder, isRowspanPlaceholder, headerClassNames, visibleWhen }?: {
     label?: string;
     colspan?: number;
     origColspan?: number;
     rowspan?: number;
     origRowspan?: number;
     collapsible?: boolean;
+    columnDropMode?: ColumnDropMode;
     crossHiddenColumns?: number[];
     isCollapsed?: boolean;
     isHidden?: boolean;
@@ -59,6 +74,7 @@ export declare function createDefaultHeaderSettings({ label, colspan, origColspa
     rowspan: number;
     origRowspan: number;
     collapsible: boolean;
+    columnDropMode: ColumnDropMode;
     isCollapsed: boolean;
     crossHiddenColumns: number[];
     isHidden: boolean;

package/plugins/nestedHeaders/stateManager/utils.js

@@ -6,6 +6,10 @@
  * @property {number} rowspan Current calculated rowspan value of the rendered column header element.
  * @property {number} origRowspan Original rowspan value, set once while parsing user-defined nested header settings.
  * @property {boolean} collapsible The flag determines whether the node is collapsible (can be collapsed/expanded).
+ * @property {('adopt'|'split')} columnDropMode Determines what the group does when a column move drops a foreign
+ *                                column (one belonging to another group) into its span. When `'adopt'` (default)
+ *                                the group stays one banner and adopts that column as a child. When `'split'` the
+ *                                group keeps its identity and renders as several same-label banners (it splits).
  * @property {number[]} crossHiddenColumns The list of visual column indexes which indicates that the specified columns within
  *                                         the header settings are hidden.
  * @property {boolean} isCollapsed The flag determines whether the node is collapsed.
@@ -46,7 +50,7 @@ _export(exports, {
         return createPlaceholderHeaderSettings;
     }
 });
-function createDefaultHeaderSettings({ label = '', colspan = 1, origColspan = 1, rowspan = 1, origRowspan = 1, collapsible = false, crossHiddenColumns = [], isCollapsed = false, isHidden = false, isRoot = false, isPlaceholder = false, isRowspanPlaceholder = false, headerClassNames = [], visibleWhen } = {}) {
+function createDefaultHeaderSettings({ label = '', colspan = 1, origColspan = 1, rowspan = 1, origRowspan = 1, collapsible = false, columnDropMode = 'adopt', crossHiddenColumns = [], isCollapsed = false, isHidden = false, isRoot = false, isPlaceholder = false, isRowspanPlaceholder = false, headerClassNames = [], visibleWhen } = {}) {
     return {
         label,
         colspan,
@@ -54,6 +58,7 @@ function createDefaultHeaderSettings({ label = '', colspan = 1, origColspan = 1,
         rowspan,
         origRowspan,
         collapsible,
+        columnDropMode,
         isCollapsed,
         crossHiddenColumns,
         isHidden,

package/plugins/nestedHeaders/stateManager/utils.mjs

@@ -6,6 +6,10 @@
  * @property {number} rowspan Current calculated rowspan value of the rendered column header element.
  * @property {number} origRowspan Original rowspan value, set once while parsing user-defined nested header settings.
  * @property {boolean} collapsible The flag determines whether the node is collapsible (can be collapsed/expanded).
+ * @property {('adopt'|'split')} columnDropMode Determines what the group does when a column move drops a foreign
+ *                                column (one belonging to another group) into its span. When `'adopt'` (default)
+ *                                the group stays one banner and adopts that column as a child. When `'split'` the
+ *                                group keeps its identity and renders as several same-label banners (it splits).
  * @property {number[]} crossHiddenColumns The list of visual column indexes which indicates that the specified columns within
  *                                         the header settings are hidden.
  * @property {boolean} isCollapsed The flag determines whether the node is collapsed.
@@ -33,7 +37,7 @@
  *
  * @param {DefaultHeaderSettings} initialValues The initial values for the header settings object.
  * @returns {DefaultHeaderSettings}
- */ export function createDefaultHeaderSettings({ label = '', colspan = 1, origColspan = 1, rowspan = 1, origRowspan = 1, collapsible = false, crossHiddenColumns = [], isCollapsed = false, isHidden = false, isRoot = false, isPlaceholder = false, isRowspanPlaceholder = false, headerClassNames = [], visibleWhen } = {}) {
+ */ export function createDefaultHeaderSettings({ label = '', colspan = 1, origColspan = 1, rowspan = 1, origRowspan = 1, collapsible = false, columnDropMode = 'adopt', crossHiddenColumns = [], isCollapsed = false, isHidden = false, isRoot = false, isPlaceholder = false, isRowspanPlaceholder = false, headerClassNames = [], visibleWhen } = {}) {
     return {
         label,
         colspan,
@@ -41,6 +45,7 @@
         rowspan,
         origRowspan,
         collapsible,
+        columnDropMode,
         isCollapsed,
         crossHiddenColumns,
         isHidden,

package/plugins/nestedHeaders/utils/ghostTable.js

@@ -14,9 +14,7 @@ function _check_private_redeclaration(obj, privateCollection) {
     }
 }
 function _class_private_method_get(receiver, privateSet, fn) {
-    if (!privateSet.has(receiver)) {
-        throw new TypeError("attempted to get private field on non-instance");
-    }
+    if (!privateSet.has(receiver)) throw new TypeError("attempted to get private field on non-instance");
     return fn;
 }
 function _class_private_method_init(obj, privateSet) {

package/plugins/nestedHeaders/utils/ghostTable.mjs

@@ -4,9 +4,7 @@ function _check_private_redeclaration(obj, privateCollection) {
     }
 }
 function _class_private_method_get(receiver, privateSet, fn) {
-    if (!privateSet.has(receiver)) {
-        throw new TypeError("attempted to get private field on non-instance");
-    }
+    if (!privateSet.has(receiver)) throw new TypeError("attempted to get private field on non-instance");
     return fn;
 }
 function _class_private_method_init(obj, privateSet) {

package/plugins/nestedRows/data/dataManager.d.ts

@@ -133,8 +133,11 @@ declare class DataManager {
     /**
      * Get the row index for the provided row object.
      *
+     * Returns `null` when the object is not part of the current nested structure - for example when it
+     * comes from a dataset that has since been replaced by `loadData` or `updateData`.
+     *
      * @param {object} rowObj The row object.
-     * @returns {number} Row index.
+     * @returns {number|null} Row index, or `null` when the object is unknown.
      */
     getRowIndex(rowObj: unknown): number | null;
     /**

package/plugins/nestedRows/data/dataManager.js

@@ -176,13 +176,17 @@ const _array = require("../../../helpers/array");
     /**
    * Get the row index for the provided row object.
    *
+   * Returns `null` when the object is not part of the current nested structure - for example when it
+   * comes from a dataset that has since been replaced by `loadData` or `updateData`.
+   *
    * @param {object} rowObj The row object.
-   * @returns {number} Row index.
+   * @returns {number|null} Row index, or `null` when the object is unknown.
    */ getRowIndex(rowObj) {
         if (rowObj === null || rowObj === undefined || typeof rowObj !== 'object') {
             return null;
         }
-        return this.cache.nodeInfo.get(rowObj).row;
+        const nodeInfo = this.cache.nodeInfo.get(rowObj);
+        return nodeInfo ? nodeInfo.row : null;
     }
     /**
    * Get the index of the provided row index/row object within its parent.
@@ -255,7 +259,8 @@ const _array = require("../../../helpers/array");
         if (!rowObject || typeof rowObject !== 'object') {
             return null;
         }
-        return this.cache.nodeInfo.get(rowObject).parent;
+        const nodeInfo = this.cache.nodeInfo.get(rowObject);
+        return nodeInfo ? nodeInfo.parent : null;
     }
     /**
    * Get the nesting level for the row with the provided row index.
@@ -281,7 +286,8 @@ const _array = require("../../../helpers/array");
         if (rowObject === null || rowObject === undefined || typeof rowObject !== 'object') {
             return null;
         }
-        return this.cache.nodeInfo.get(rowObject).level;
+        const nodeInfo = this.cache.nodeInfo.get(rowObject);
+        return nodeInfo ? nodeInfo.level : null;
     }
     /**
    * Check if the provided row/row element has children.

package/plugins/nestedRows/data/dataManager.mjs

@@ -166,13 +166,17 @@ import { arrayEach } from '../../../helpers/array.mjs';
     /**
    * Get the row index for the provided row object.
    *
+   * Returns `null` when the object is not part of the current nested structure - for example when it
+   * comes from a dataset that has since been replaced by `loadData` or `updateData`.
+   *
    * @param {object} rowObj The row object.
-   * @returns {number} Row index.
+   * @returns {number|null} Row index, or `null` when the object is unknown.
    */ getRowIndex(rowObj) {
         if (rowObj === null || rowObj === undefined || typeof rowObj !== 'object') {
             return null;
         }
-        return this.cache.nodeInfo.get(rowObj).row;
+        const nodeInfo = this.cache.nodeInfo.get(rowObj);
+        return nodeInfo ? nodeInfo.row : null;
     }
     /**
    * Get the index of the provided row index/row object within its parent.
@@ -245,7 +249,8 @@ import { arrayEach } from '../../../helpers/array.mjs';
         if (!rowObject || typeof rowObject !== 'object') {
             return null;
         }
-        return this.cache.nodeInfo.get(rowObject).parent;
+        const nodeInfo = this.cache.nodeInfo.get(rowObject);
+        return nodeInfo ? nodeInfo.parent : null;
     }
     /**
    * Get the nesting level for the row with the provided row index.
@@ -271,7 +276,8 @@ import { arrayEach } from '../../../helpers/array.mjs';
         if (rowObject === null || rowObject === undefined || typeof rowObject !== 'object') {
             return null;
         }
-        return this.cache.nodeInfo.get(rowObject).level;
+        const nodeInfo = this.cache.nodeInfo.get(rowObject);
+        return nodeInfo ? nodeInfo.level : null;
     }
     /**
    * Check if the provided row/row element has children.

package/plugins/nestedRows/nestedRows.d.ts

@@ -3,7 +3,7 @@ import DataManager from './data/dataManager';
 import CollapsingUI from './ui/collapsing';
 import HeadersUI from './ui/headers';
 import ContextMenuUI from './ui/contextMenu';
-import { TrimmingMap } from '../../translations';
+import type { TrimmingMap } from '../../translations';
 import RowMoveController from './utils/rowMoveController';
 export declare const PLUGIN_KEY = "nestedRows";
 export declare const PLUGIN_PRIORITY = 300;
@@ -100,6 +100,132 @@ export declare class NestedRows extends BasePlugin {
      * @private
      */
     unregisterShortcuts(): void;
+    /**
+     * Collapses every top-level parent row, which hides all of their descendants.
+     *
+     * A parent that was already collapsed inside another one stays collapsed.
+     *
+     * @fires Hooks#beforeRowCollapse
+     * @fires Hooks#afterRowCollapse
+     */
+    collapseAll(): void;
+    /**
+     * Expands every collapsed parent row at every nesting level, so no row stays hidden.
+     *
+     * @fires Hooks#beforeRowExpand
+     * @fires Hooks#afterRowExpand
+     */
+    expandAll(): void;
+    /**
+     * Collapses a parent row, which hides its children.
+     *
+     * @param {number} row Visual row index of the parent.
+     * @returns {boolean} `true` if the collapsed state changed. `false` when the row is not a parent,
+     * when it is already collapsed, or when the {@link Hooks#beforeRowCollapse} hook blocked the action.
+     * @fires Hooks#beforeRowCollapse
+     * @fires Hooks#afterRowCollapse
+     */
+    collapseParent(row: number): boolean;
+    /**
+     * Expands a parent row, which shows its children again.
+     *
+     * @param {number} row Visual row index of the parent.
+     * @returns {boolean} `true` if the collapsed state changed. `false` when the row is not a parent,
+     * when it is already expanded, or when the {@link Hooks#beforeRowExpand} hook blocked the action.
+     * @fires Hooks#beforeRowExpand
+     * @fires Hooks#afterRowExpand
+     */
+    expandParent(row: number): boolean;
+    /**
+     * Collapses an expanded parent row, or expands a collapsed one. This is the same action as clicking
+     * the button in the row header or pressing Enter on it.
+     *
+     * @param {number} row Visual row index of the parent.
+     * @returns {boolean} `true` if the collapsed state changed.
+     * @fires Hooks#beforeRowCollapse
+     * @fires Hooks#afterRowCollapse
+     * @fires Hooks#beforeRowExpand
+     * @fires Hooks#afterRowExpand
+     */
+    toggleParent(row: number): boolean;
+    /**
+     * Returns the physical row indexes of every parent row that is collapsed.
+     *
+     * The indexes are physical, not visual, because a parent collapsed inside another collapsed parent
+     * is trimmed and therefore has no visual index at all. Physical indexes are also what you want to
+     * store when saving the state. Convert one with {@link Core#toVisualRow}.
+     *
+     * @returns {number[]} Physical row indexes, sorted ascending.
+     */
+    getCollapsedParents(): number[];
+    /**
+     * Checks whether a parent row is collapsed.
+     *
+     * @param {number} row Visual row index of the parent.
+     * @returns {boolean} `true` if the row is a parent and its children are hidden.
+     */
+    isParentCollapsed(row: number): boolean;
+    /**
+     * Checks whether a row has children.
+     *
+     * @param {number} row Visual row index.
+     * @returns {boolean}
+     */
+    isParent(row: number): boolean;
+    /**
+     * Returns how deeply a row is nested. Top-level rows are at level `0`.
+     *
+     * @param {number} row Visual row index.
+     * @returns {number|null} The nesting level, or `null` when the row does not exist.
+     */
+    getRowLevel(row: number): number | null;
+    /**
+     * Returns the parent of a row.
+     *
+     * A visible row always has visible ancestors, so the returned index is visual like the argument.
+     *
+     * @param {number} row Visual row index.
+     * @returns {number|null} Visual row index of the parent, or `null` for a top-level row.
+     */
+    getRowParent(row: number): number | null;
+    /**
+     * Counts the children of a row.
+     *
+     * @param {number} row Visual row index.
+     * @param {boolean} [recursive=false] `true` counts every descendant, `false` counts only the direct
+     * children.
+     * @returns {number}
+     */
+    countChildren(row: number, recursive?: boolean): number;
+    /**
+     * Expands every ancestor of a row, so that a row hidden inside collapsed parents becomes visible.
+     *
+     * Takes a physical row index, because the row you want to reveal is hidden and therefore has no
+     * visual index.
+     *
+     * @param {number} row Physical row index of the row to reveal.
+     * @returns {boolean} `true` if anything was expanded.
+     * @fires Hooks#beforeRowExpand
+     * @fires Hooks#afterRowExpand
+     */
+    expandToRow(row: number): boolean;
+    /**
+     * Shows rows down to the given nesting level and collapses everything deeper.
+     *
+     * Level `0` leaves only the top-level rows visible.
+     *
+     * This runs as two steps - an expand and a collapse - so it fires both pairs of hooks. Returning
+     * `false` from {@link Hooks#beforeRowExpand} cancels the whole call and leaves the grid as it was.
+     * Returning `false` from {@link Hooks#beforeRowCollapse} blocks only the collapse step, so the
+     * expand step stays applied.
+     *
+     * @param {number} level The deepest nesting level that stays expanded.
+     * @fires Hooks#beforeRowCollapse
+     * @fires Hooks#afterRowCollapse
+     * @fires Hooks#beforeRowExpand
+     * @fires Hooks#afterRowExpand
+     */
+    expandToLevel(level: number): void;
     /**
      * Enable the modify hook skipping flag - allows retrieving the data from Handsontable without this plugin's
      * modifications.