@carbon/ibm-products 2.92.0 → 2.92.1-rc.0

package/es/index.js

@@ -60,6 +60,7 @@ import { UserAvatar } from "./components/UserAvatar/UserAvatar.js";
 import { WebTerminalProvider, useWebTerminal } from "./components/WebTerminal/hooks/index.js";
 import { WebTerminal } from "./components/WebTerminal/WebTerminal.js";
 import { WebTerminalContentWrapper } from "./components/WebTerminal/WebTerminalContentWrapper.js";
+import { AddSelectData } from "./packages/ibm-products-utilities/src/utils/add-select/add-select-data.js";
 import { Coachmark as Coachmark$1 } from "./components/Coachmark/next/Coachmark/Coachmark.js";
 import { CoachmarkTagline } from "./components/Coachmark/next/Coachmark/CoachmarkTagline/CoachmarkTagline.js";
 import { CoachmarkBeacon as CoachmarkBeacon$1 } from "./components/Coachmark/next/Coachmark/CoachmarkBeacon/CoachmarkBeacon.js";
@@ -148,7 +149,6 @@ import { NavList } from "./components/Nav/NavList.js";
 import { Nav } from "./components/Nav/Nav.js";
 import { StatusIndicator } from "./components/StatusIndicator/StatusIndicator.js";
 import { StatusIndicatorStep } from "./components/StatusIndicator/StatusIndicatorStep.js";
-import { AddSelectData } from "./components/index.js";
 //#region src/index.ts
 /**
 * Copyright IBM Corp. 2024, 2025

package/es/packages/ibm-products-utilities/src/utils/add-select/add-select-data.js

@@ -0,0 +1,384 @@
+/**
+ * Copyright IBM Corp. 2020, 2026
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+//#region ../ibm-products-utilities/src/utils/add-select/add-select-data.ts
+/**
+* AddSelectData - A lightweight, framework-agnostic utility for managing hierarchical data
+*
+* This utility provides standard APIs for common operations such as setting, selecting,
+* traversing, searching, and sorting hierarchical data structures. It encapsulates data
+* logic separate from UI, allowing both React and Web Components to reuse the same
+* data management functions.
+*/
+var AddSelectData = class {
+	constructor() {
+		this.items = [];
+		this.itemMap = /* @__PURE__ */ new Map();
+		this.parentMap = /* @__PURE__ */ new Map();
+		this.selectedIds = /* @__PURE__ */ new Set();
+		this.depthCache = /* @__PURE__ */ new Map();
+		this.selectedItemsCache = null;
+	}
+	/**
+	* Initialize or replace the hierarchical data
+	* @param items - Array of hierarchical items
+	*/
+	setItems(items) {
+		this.items = items;
+		this._invalidateCaches();
+		this._buildMaps(items);
+	}
+	/**
+	* Get the full list of items
+	* @returns Array of all items
+	*/
+	getItems() {
+		return this.items;
+	}
+	/**
+	* Retrieve a single item by its id
+	* @param id - The item id
+	* @returns The item or undefined if not found
+	*/
+	getItem(id) {
+		return this.itemMap.get(id);
+	}
+	/**
+	* Update a given item with new properties
+	* @param id - The item id
+	* @param newProperties - Properties to update
+	* @returns true if item was found and updated, false otherwise
+	*/
+	setItem(id, newProperties) {
+		const item = this.itemMap.get(id);
+		if (!item) return false;
+		Object.assign(item, newProperties);
+		if ("selected" in newProperties || "status" in newProperties) this._invalidateSelectionCache();
+		return true;
+	}
+	/**
+	* Returns an array of items marked as selected (memoized)
+	* @returns Array of selected items
+	*/
+	getSelectedItems() {
+		if (this.selectedItemsCache !== null) return this.selectedItemsCache;
+		const selected = [];
+		this.selectedIds.forEach((id) => {
+			const item = this.itemMap.get(id);
+			if (item) selected.push(item);
+		});
+		this.selectedItemsCache = selected;
+		return selected;
+	}
+	/**
+	* Mark one or more items (by id) as selected
+	* @param ids - Single id or array of ids to select
+	* @param exclusive - If true, deselect all other items (default: false)
+	*/
+	setSelectedItems(ids, exclusive = false) {
+		const idArray = Array.isArray(ids) ? ids : [ids];
+		if (exclusive) {
+			this.selectedIds.forEach((id) => {
+				const item = this.itemMap.get(id);
+				if (item) {
+					item.selected = false;
+					item.status = "unchecked";
+				}
+			});
+			this.selectedIds.clear();
+		}
+		idArray.forEach((id) => {
+			const item = this.itemMap.get(id);
+			if (item) {
+				item.selected = true;
+				item.status = "checked";
+				this.selectedIds.add(id);
+			}
+		});
+		this._invalidateSelectionCache();
+	}
+	/**
+	* Get direct children of a node
+	* @param id - The parent item id
+	* @returns Array of child items or empty array if no children
+	*/
+	getItemChildren(id) {
+		const item = this.itemMap.get(id);
+		if (!item) return [];
+		return item.children?.entries ?? [];
+	}
+	/**
+	* Get the parent of a node
+	* @param id - The child item id
+	* @returns The parent item or undefined if no parent (root level)
+	*/
+	getItemParent(id) {
+		const parentId = this.parentMap.get(id);
+		return parentId ? this.itemMap.get(parentId) : void 0;
+	}
+	/**
+	* Get all ancestors (parents up to the root) of a node
+	* @param id - The item id
+	* @returns Array of ancestor items from immediate parent to root
+	*/
+	getItemParents(id) {
+		const parents = [];
+		let currentId = id;
+		while (currentId) {
+			const parentId = this.parentMap.get(currentId);
+			if (!parentId) break;
+			const parent = this.itemMap.get(parentId);
+			if (parent) parents.push(parent);
+			currentId = parentId;
+		}
+		return parents;
+	}
+	/**
+	* Retrieve the selected state status of an item
+	* @param id - The item id
+	* @returns The status or undefined if item not found
+	*/
+	getItemStatus(id) {
+		return this.itemMap.get(id)?.status;
+	}
+	/**
+	* Set or update the status of an item
+	* @param id - The item id
+	* @param status - The new status
+	* @returns true if item was found and updated, false otherwise
+	*/
+	setItemStatus(id, status) {
+		const item = this.itemMap.get(id);
+		if (!item) return false;
+		const wasSelected = item.selected;
+		item.status = status;
+		item.selected = status === "checked";
+		if (item.selected) this.selectedIds.add(id);
+		else this.selectedIds.delete(id);
+		if (wasSelected !== item.selected) this._invalidateSelectionCache();
+		return true;
+	}
+	/**
+	* Check whether an item is selected (O(1) lookup)
+	* @param id - The item id
+	* @returns true if selected, false otherwise
+	*/
+	isSelected(id) {
+		return this.selectedIds.has(id);
+	}
+	/**
+	* Search items based on a query and return matching items
+	* @param query - The search query string
+	* @param options - Search options
+	* @returns Array of matching items
+	*/
+	search(query, options = {}) {
+		if (!query) return [];
+		const { caseSensitive = false, searchFields = ["title", "value"], maxResults } = options;
+		const searchTerm = caseSensitive ? query : query.toLowerCase();
+		const results = [];
+		const shouldContinue = () => {
+			return !maxResults || results.length < maxResults;
+		};
+		this._traverseItems(this.items, (item) => {
+			if (!shouldContinue()) return;
+			for (const field of searchFields) {
+				const fieldValue = item[field];
+				if (fieldValue) {
+					if ((caseSensitive ? String(fieldValue) : String(fieldValue).toLowerCase()).includes(searchTerm)) {
+						results.push(item);
+						break;
+					}
+				}
+			}
+		});
+		return results;
+	}
+	/**
+	* Sort items based on a comparator function
+	* @param compareFn - Comparison function for sorting
+	* @param recursive - If true, sort children recursively (default: false)
+	*/
+	sort(compareFn, recursive = false) {
+		if (recursive) this._sortRecursive(this.items, compareFn);
+		this.items.sort(compareFn);
+		this._invalidateCaches();
+		this._buildMaps(this.items);
+	}
+	/**
+	* Clear all selections (optimized with Set)
+	*/
+	clearSelections() {
+		this.selectedIds.forEach((id) => {
+			const item = this.itemMap.get(id);
+			if (item) {
+				item.selected = false;
+				item.status = "unchecked";
+			}
+		});
+		this.selectedIds.clear();
+		this._invalidateSelectionCache();
+	}
+	/**
+	* Get the depth/level of an item in the hierarchy (cached)
+	* @param id - The item id
+	* @returns The depth (0 for root level items) or -1 if not found
+	*/
+	getItemDepth(id) {
+		const cachedDepth = this.depthCache.get(id);
+		if (cachedDepth !== void 0) return cachedDepth;
+		if (!this.itemMap.has(id)) return -1;
+		let depth = 0;
+		let currentId = id;
+		while (currentId) {
+			const parentId = this.parentMap.get(currentId);
+			if (!parentId) break;
+			depth++;
+			currentId = parentId;
+		}
+		this.depthCache.set(id, depth);
+		return depth;
+	}
+	/**
+	* Check if an item has children
+	* @param id - The item id
+	* @returns true if item has children, false otherwise
+	*/
+	hasChildren(id) {
+		return !!this.itemMap.get(id)?.children?.entries?.length;
+	}
+	/**
+	* Get all descendant items of a node
+	* @param id - The parent item id
+	* @returns Array of all descendant items
+	*/
+	getItemDescendants(id) {
+		const item = this.itemMap.get(id);
+		if (!item?.children?.entries) return [];
+		const descendants = [];
+		this._traverseItems(item.children.entries, (child) => {
+			descendants.push(child);
+		});
+		return descendants;
+	}
+	/**
+	* Check if an item has any selected descendants (optimized)
+	* @param id - The item id
+	* @param selectedIds - Set of selected item IDs (defaults to internal selectedIds)
+	* @returns true if any descendant is selected, false otherwise
+	*/
+	hasSelectedDescendants(id, selectedIds = this.selectedIds) {
+		const children = this.getItemChildren(id);
+		if (!children.length) return false;
+		for (const child of children) if (selectedIds.has(child.id) || this.hasSelectedDescendants(child.id, selectedIds)) return true;
+		return false;
+	}
+	/**
+	* Check if all descendants of an item are selected (optimized)
+	* @param id - The item id
+	* @param selectedIds - Set of selected item IDs (defaults to internal selectedIds)
+	* @returns true if all descendants are selected, false otherwise
+	*/
+	allDescendantsSelected(id, selectedIds = this.selectedIds) {
+		const item = this.itemMap.get(id);
+		if (!item) return false;
+		const children = this.getItemChildren(id);
+		if (!children.length) return selectedIds.has(item.id);
+		for (const child of children) if (!selectedIds.has(child.id) || !this.allDescendantsSelected(child.id, selectedIds)) return false;
+		return true;
+	}
+	/**
+	* Get all descendant IDs from an item (including the item itself)
+	* @param id - The item id
+	* @returns Array of all descendant IDs including the item itself
+	*/
+	getAllDescendantIds(id) {
+		if (!this.itemMap.get(id)) return [];
+		const ids = [id];
+		const children = this.getItemChildren(id);
+		for (const child of children) ids.push(...this.getAllDescendantIds(child.id));
+		return ids;
+	}
+	/**
+	* Get only top-level selected items (items without selected ancestors)
+	* @param selectedIds - Set of selected item IDs (defaults to internal selectedIds)
+	* @returns Array of top-level selected items
+	*/
+	getTopLevelSelectedItems(selectedIds = this.selectedIds) {
+		const topLevelItems = [];
+		const processedIds = /* @__PURE__ */ new Set();
+		const hasSelectedAncestor = (itemId) => {
+			return this.getItemParents(itemId).some((parent) => selectedIds.has(parent.id));
+		};
+		selectedIds.forEach((id) => {
+			if (!processedIds.has(id) && !hasSelectedAncestor(id)) {
+				const item = this.itemMap.get(id);
+				if (item) {
+					topLevelItems.push(item);
+					this.getAllDescendantIds(id).forEach((descId) => processedIds.add(descId));
+				}
+			}
+		});
+		return topLevelItems;
+	}
+	/**
+	* Invalidate all caches
+	* @private
+	*/
+	_invalidateCaches() {
+		this.selectedItemsCache = null;
+		this.depthCache.clear();
+	}
+	/**
+	* Invalidate selection cache only
+	* @private
+	*/
+	_invalidateSelectionCache() {
+		this.selectedItemsCache = null;
+	}
+	/**
+	* Build internal maps for efficient lookups (optimized with depth caching)
+	* @private
+	*/
+	_buildMaps(items, parentId, depth = 0) {
+		if (!parentId) {
+			this.itemMap.clear();
+			this.parentMap.clear();
+			this.selectedIds.clear();
+			this.depthCache.clear();
+		}
+		items.forEach((item) => {
+			this.itemMap.set(item.id, item);
+			this.depthCache.set(item.id, depth);
+			if (parentId) this.parentMap.set(item.id, parentId);
+			if (item.selected) this.selectedIds.add(item.id);
+			if (item.children?.entries) this._buildMaps(item.children.entries, item.id, depth + 1);
+		});
+	}
+	/**
+	* Traverse all items and apply a callback function
+	* @private
+	*/
+	_traverseItems(items, callback) {
+		for (const item of items) {
+			callback(item);
+			if (item.children?.entries) this._traverseItems(item.children.entries, callback);
+		}
+	}
+	/**
+	* Sort items recursively
+	* @private
+	*/
+	_sortRecursive(items, compareFn) {
+		for (const item of items) if (item.children?.entries) {
+			item.children.entries.sort(compareFn);
+			this._sortRecursive(item.children.entries, compareFn);
+		}
+	}
+};
+//#endregion
+export { AddSelectData };

package/lib/index.js

@@ -7,7 +7,6 @@
 
 "use client";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("./_virtual/_rolldown/runtime.js");
 const require_settings = require("./settings.js");
 const require_usePrefix = require("./global/js/hooks/usePrefix.js");
 const require_index = require("./components/FeatureFlags/index.js");
@@ -62,6 +61,7 @@ const require_UserAvatar = require("./components/UserAvatar/UserAvatar.js");
 const require_index$1 = require("./components/WebTerminal/hooks/index.js");
 const require_WebTerminal = require("./components/WebTerminal/WebTerminal.js");
 const require_WebTerminalContentWrapper = require("./components/WebTerminal/WebTerminalContentWrapper.js");
+const require_add_select_data = require("./packages/ibm-products-utilities/src/utils/add-select/add-select-data.js");
 const require_Coachmark = require("./components/Coachmark/next/Coachmark/Coachmark.js");
 const require_CoachmarkTagline = require("./components/Coachmark/next/Coachmark/CoachmarkTagline/CoachmarkTagline.js");
 const require_CoachmarkBeacon = require("./components/Coachmark/next/Coachmark/CoachmarkBeacon/CoachmarkBeacon.js");
@@ -150,7 +150,6 @@ const require_NavList = require("./components/Nav/NavList.js");
 const require_Nav = require("./components/Nav/Nav.js");
 const require_StatusIndicator = require("./components/StatusIndicator/StatusIndicator.js");
 const require_StatusIndicatorStep = require("./components/StatusIndicator/StatusIndicatorStep.js");
-let _carbon_ibm_products_utilities = require("@carbon/ibm-products-utilities");
 //#region src/index.ts
 /**
 * Copyright IBM Corp. 2024, 2025
@@ -162,12 +161,7 @@ let _carbon_ibm_products_utilities = require("@carbon/ibm-products-utilities");
 exports.APIKeyModal = require_APIKeyModal.APIKeyModal;
 exports.AboutModal = require_AboutModal.AboutModal;
 exports.ActionBar = require_ActionBar.ActionBar;
-Object.defineProperty(exports, "AddSelectData", {
-	enumerable: true,
-	get: function() {
-		return _carbon_ibm_products_utilities.AddSelectData;
-	}
-});
+exports.AddSelectData = require_add_select_data.AddSelectData;
 exports.BEACON_KIND = require_enums.BEACON_KIND;
 exports.COACHMARK_ALIGNMENT = require_enums.COACHMARK_ALIGNMENT;
 exports.COACHMARK_OVERLAY_KIND = require_enums.COACHMARK_OVERLAY_KIND;

package/lib/packages/ibm-products-utilities/src/utils/add-select/add-select-data.js

@@ -0,0 +1,384 @@
+/**
+ * Copyright IBM Corp. 2020, 2026
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+//#region ../ibm-products-utilities/src/utils/add-select/add-select-data.ts
+/**
+* AddSelectData - A lightweight, framework-agnostic utility for managing hierarchical data
+*
+* This utility provides standard APIs for common operations such as setting, selecting,
+* traversing, searching, and sorting hierarchical data structures. It encapsulates data
+* logic separate from UI, allowing both React and Web Components to reuse the same
+* data management functions.
+*/
+var AddSelectData = class {
+	constructor() {
+		this.items = [];
+		this.itemMap = /* @__PURE__ */ new Map();
+		this.parentMap = /* @__PURE__ */ new Map();
+		this.selectedIds = /* @__PURE__ */ new Set();
+		this.depthCache = /* @__PURE__ */ new Map();
+		this.selectedItemsCache = null;
+	}
+	/**
+	* Initialize or replace the hierarchical data
+	* @param items - Array of hierarchical items
+	*/
+	setItems(items) {
+		this.items = items;
+		this._invalidateCaches();
+		this._buildMaps(items);
+	}
+	/**
+	* Get the full list of items
+	* @returns Array of all items
+	*/
+	getItems() {
+		return this.items;
+	}
+	/**
+	* Retrieve a single item by its id
+	* @param id - The item id
+	* @returns The item or undefined if not found
+	*/
+	getItem(id) {
+		return this.itemMap.get(id);
+	}
+	/**
+	* Update a given item with new properties
+	* @param id - The item id
+	* @param newProperties - Properties to update
+	* @returns true if item was found and updated, false otherwise
+	*/
+	setItem(id, newProperties) {
+		const item = this.itemMap.get(id);
+		if (!item) return false;
+		Object.assign(item, newProperties);
+		if ("selected" in newProperties || "status" in newProperties) this._invalidateSelectionCache();
+		return true;
+	}
+	/**
+	* Returns an array of items marked as selected (memoized)
+	* @returns Array of selected items
+	*/
+	getSelectedItems() {
+		if (this.selectedItemsCache !== null) return this.selectedItemsCache;
+		const selected = [];
+		this.selectedIds.forEach((id) => {
+			const item = this.itemMap.get(id);
+			if (item) selected.push(item);
+		});
+		this.selectedItemsCache = selected;
+		return selected;
+	}
+	/**
+	* Mark one or more items (by id) as selected
+	* @param ids - Single id or array of ids to select
+	* @param exclusive - If true, deselect all other items (default: false)
+	*/
+	setSelectedItems(ids, exclusive = false) {
+		const idArray = Array.isArray(ids) ? ids : [ids];
+		if (exclusive) {
+			this.selectedIds.forEach((id) => {
+				const item = this.itemMap.get(id);
+				if (item) {
+					item.selected = false;
+					item.status = "unchecked";
+				}
+			});
+			this.selectedIds.clear();
+		}
+		idArray.forEach((id) => {
+			const item = this.itemMap.get(id);
+			if (item) {
+				item.selected = true;
+				item.status = "checked";
+				this.selectedIds.add(id);
+			}
+		});
+		this._invalidateSelectionCache();
+	}
+	/**
+	* Get direct children of a node
+	* @param id - The parent item id
+	* @returns Array of child items or empty array if no children
+	*/
+	getItemChildren(id) {
+		const item = this.itemMap.get(id);
+		if (!item) return [];
+		return item.children?.entries ?? [];
+	}
+	/**
+	* Get the parent of a node
+	* @param id - The child item id
+	* @returns The parent item or undefined if no parent (root level)
+	*/
+	getItemParent(id) {
+		const parentId = this.parentMap.get(id);
+		return parentId ? this.itemMap.get(parentId) : void 0;
+	}
+	/**
+	* Get all ancestors (parents up to the root) of a node
+	* @param id - The item id
+	* @returns Array of ancestor items from immediate parent to root
+	*/
+	getItemParents(id) {
+		const parents = [];
+		let currentId = id;
+		while (currentId) {
+			const parentId = this.parentMap.get(currentId);
+			if (!parentId) break;
+			const parent = this.itemMap.get(parentId);
+			if (parent) parents.push(parent);
+			currentId = parentId;
+		}
+		return parents;
+	}
+	/**
+	* Retrieve the selected state status of an item
+	* @param id - The item id
+	* @returns The status or undefined if item not found
+	*/
+	getItemStatus(id) {
+		return this.itemMap.get(id)?.status;
+	}
+	/**
+	* Set or update the status of an item
+	* @param id - The item id
+	* @param status - The new status
+	* @returns true if item was found and updated, false otherwise
+	*/
+	setItemStatus(id, status) {
+		const item = this.itemMap.get(id);
+		if (!item) return false;
+		const wasSelected = item.selected;
+		item.status = status;
+		item.selected = status === "checked";
+		if (item.selected) this.selectedIds.add(id);
+		else this.selectedIds.delete(id);
+		if (wasSelected !== item.selected) this._invalidateSelectionCache();
+		return true;
+	}
+	/**
+	* Check whether an item is selected (O(1) lookup)
+	* @param id - The item id
+	* @returns true if selected, false otherwise
+	*/
+	isSelected(id) {
+		return this.selectedIds.has(id);
+	}
+	/**
+	* Search items based on a query and return matching items
+	* @param query - The search query string
+	* @param options - Search options
+	* @returns Array of matching items
+	*/
+	search(query, options = {}) {
+		if (!query) return [];
+		const { caseSensitive = false, searchFields = ["title", "value"], maxResults } = options;
+		const searchTerm = caseSensitive ? query : query.toLowerCase();
+		const results = [];
+		const shouldContinue = () => {
+			return !maxResults || results.length < maxResults;
+		};
+		this._traverseItems(this.items, (item) => {
+			if (!shouldContinue()) return;
+			for (const field of searchFields) {
+				const fieldValue = item[field];
+				if (fieldValue) {
+					if ((caseSensitive ? String(fieldValue) : String(fieldValue).toLowerCase()).includes(searchTerm)) {
+						results.push(item);
+						break;
+					}
+				}
+			}
+		});
+		return results;
+	}
+	/**
+	* Sort items based on a comparator function
+	* @param compareFn - Comparison function for sorting
+	* @param recursive - If true, sort children recursively (default: false)
+	*/
+	sort(compareFn, recursive = false) {
+		if (recursive) this._sortRecursive(this.items, compareFn);
+		this.items.sort(compareFn);
+		this._invalidateCaches();
+		this._buildMaps(this.items);
+	}
+	/**
+	* Clear all selections (optimized with Set)
+	*/
+	clearSelections() {
+		this.selectedIds.forEach((id) => {
+			const item = this.itemMap.get(id);
+			if (item) {
+				item.selected = false;
+				item.status = "unchecked";
+			}
+		});
+		this.selectedIds.clear();
+		this._invalidateSelectionCache();
+	}
+	/**
+	* Get the depth/level of an item in the hierarchy (cached)
+	* @param id - The item id
+	* @returns The depth (0 for root level items) or -1 if not found
+	*/
+	getItemDepth(id) {
+		const cachedDepth = this.depthCache.get(id);
+		if (cachedDepth !== void 0) return cachedDepth;
+		if (!this.itemMap.has(id)) return -1;
+		let depth = 0;
+		let currentId = id;
+		while (currentId) {
+			const parentId = this.parentMap.get(currentId);
+			if (!parentId) break;
+			depth++;
+			currentId = parentId;
+		}
+		this.depthCache.set(id, depth);
+		return depth;
+	}
+	/**
+	* Check if an item has children
+	* @param id - The item id
+	* @returns true if item has children, false otherwise
+	*/
+	hasChildren(id) {
+		return !!this.itemMap.get(id)?.children?.entries?.length;
+	}
+	/**
+	* Get all descendant items of a node
+	* @param id - The parent item id
+	* @returns Array of all descendant items
+	*/
+	getItemDescendants(id) {
+		const item = this.itemMap.get(id);
+		if (!item?.children?.entries) return [];
+		const descendants = [];
+		this._traverseItems(item.children.entries, (child) => {
+			descendants.push(child);
+		});
+		return descendants;
+	}
+	/**
+	* Check if an item has any selected descendants (optimized)
+	* @param id - The item id
+	* @param selectedIds - Set of selected item IDs (defaults to internal selectedIds)
+	* @returns true if any descendant is selected, false otherwise
+	*/
+	hasSelectedDescendants(id, selectedIds = this.selectedIds) {
+		const children = this.getItemChildren(id);
+		if (!children.length) return false;
+		for (const child of children) if (selectedIds.has(child.id) || this.hasSelectedDescendants(child.id, selectedIds)) return true;
+		return false;
+	}
+	/**
+	* Check if all descendants of an item are selected (optimized)
+	* @param id - The item id
+	* @param selectedIds - Set of selected item IDs (defaults to internal selectedIds)
+	* @returns true if all descendants are selected, false otherwise
+	*/
+	allDescendantsSelected(id, selectedIds = this.selectedIds) {
+		const item = this.itemMap.get(id);
+		if (!item) return false;
+		const children = this.getItemChildren(id);
+		if (!children.length) return selectedIds.has(item.id);
+		for (const child of children) if (!selectedIds.has(child.id) || !this.allDescendantsSelected(child.id, selectedIds)) return false;
+		return true;
+	}
+	/**
+	* Get all descendant IDs from an item (including the item itself)
+	* @param id - The item id
+	* @returns Array of all descendant IDs including the item itself
+	*/
+	getAllDescendantIds(id) {
+		if (!this.itemMap.get(id)) return [];
+		const ids = [id];
+		const children = this.getItemChildren(id);
+		for (const child of children) ids.push(...this.getAllDescendantIds(child.id));
+		return ids;
+	}
+	/**
+	* Get only top-level selected items (items without selected ancestors)
+	* @param selectedIds - Set of selected item IDs (defaults to internal selectedIds)
+	* @returns Array of top-level selected items
+	*/
+	getTopLevelSelectedItems(selectedIds = this.selectedIds) {
+		const topLevelItems = [];
+		const processedIds = /* @__PURE__ */ new Set();
+		const hasSelectedAncestor = (itemId) => {
+			return this.getItemParents(itemId).some((parent) => selectedIds.has(parent.id));
+		};
+		selectedIds.forEach((id) => {
+			if (!processedIds.has(id) && !hasSelectedAncestor(id)) {
+				const item = this.itemMap.get(id);
+				if (item) {
+					topLevelItems.push(item);
+					this.getAllDescendantIds(id).forEach((descId) => processedIds.add(descId));
+				}
+			}
+		});
+		return topLevelItems;
+	}
+	/**
+	* Invalidate all caches
+	* @private
+	*/
+	_invalidateCaches() {
+		this.selectedItemsCache = null;
+		this.depthCache.clear();
+	}
+	/**
+	* Invalidate selection cache only
+	* @private
+	*/
+	_invalidateSelectionCache() {
+		this.selectedItemsCache = null;
+	}
+	/**
+	* Build internal maps for efficient lookups (optimized with depth caching)
+	* @private
+	*/
+	_buildMaps(items, parentId, depth = 0) {
+		if (!parentId) {
+			this.itemMap.clear();
+			this.parentMap.clear();
+			this.selectedIds.clear();
+			this.depthCache.clear();
+		}
+		items.forEach((item) => {
+			this.itemMap.set(item.id, item);
+			this.depthCache.set(item.id, depth);
+			if (parentId) this.parentMap.set(item.id, parentId);
+			if (item.selected) this.selectedIds.add(item.id);
+			if (item.children?.entries) this._buildMaps(item.children.entries, item.id, depth + 1);
+		});
+	}
+	/**
+	* Traverse all items and apply a callback function
+	* @private
+	*/
+	_traverseItems(items, callback) {
+		for (const item of items) {
+			callback(item);
+			if (item.children?.entries) this._traverseItems(item.children.entries, callback);
+		}
+	}
+	/**
+	* Sort items recursively
+	* @private
+	*/
+	_sortRecursive(items, compareFn) {
+		for (const item of items) if (item.children?.entries) {
+			item.children.entries.sort(compareFn);
+			this._sortRecursive(item.children.entries, compareFn);
+		}
+	}
+};
+//#endregion
+exports.AddSelectData = AddSelectData;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/ibm-products",
   "description": "Carbon for IBM Products",
-  "version": "2.92.0",
+  "version": "2.92.1-rc.0",
   "license": "Apache-2.0",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -66,6 +66,7 @@
     "@babel/preset-env": "^7.26.9",
     "@babel/preset-react": "^7.26.3",
     "@babel/preset-typescript": "^7.26.0",
+    "@carbon/ibm-products-utilities": "1.1.0",
     "@carbon/styles": "^1.106.0",
     "@figma/code-connect": "^1.4.0",
     "@ibm/telemetry-js-config-generator": "^2.0.1",
@@ -107,7 +108,6 @@
     "@carbon-labs/react-resizer": "^0.24.0",
     "@carbon/feature-flags": "^1.3.0",
     "@carbon/ibm-products-styles": "^2.88.0",
-    "@carbon/ibm-products-utilities": "^1.1.0",
     "@carbon/telemetry": "^0.1.0",
     "@carbon/utilities": "^0.19.0",
     "@carbon/utilities-react": "0.22.0",
@@ -131,5 +131,5 @@
     "react-dom": "^16.8.6 || ^17.0.1 || ^18.2.0 || ^19.0.0",
     "react-is": "^16.13.1 || ^17.0.2 || ^18.3.1 || ^19.0.0"
   },
-  "gitHead": "3fdb86b45ca8f5b56aeb198d2660877fff326990"
+  "gitHead": "873abb7b28373ab7d8bb5d4c93ae98ee99112723"
 }

package/es/components/index.js

@@ -1,149 +0,0 @@
-/**
- * Copyright IBM Corp. 2020, 2026
- *
- * This source code is licensed under the Apache-2.0 license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-import "./FeatureFlags/index.js";
-import "./AboutModal/AboutModal.js";
-import "./ActionBar/ActionBar.js";
-import "./APIKeyModal/APIKeyModal.js";
-import "./Cascade/Cascade.js";
-import "./Checklist/Checklist.js";
-import "./CreateFullPage/CreateFullPage.js";
-import "./CreateFullPage/CreateFullPageStep.js";
-import "./CreateModal/CreateModal.js";
-import "./SidePanel/SidePanel.js";
-import "./CreateSidePanel/CreateSidePanel.js";
-import "./Tearsheet/TearsheetPresence.js";
-import "./CreateTearsheet/CreateTearsheet.js";
-import "./CreateTearsheet/CreateTearsheetStep.js";
-import "./CreateTearsheet/CreateTearsheetDivider.js";
-import "./Tearsheet/TearsheetNarrow.js";
-import "./CreateTearsheetNarrow/CreateTearsheetNarrow.js";
-import "./EditSidePanel/EditSidePanel.js";
-import "./EditInPlace/EditInPlace.js";
-import "./EmptyStates/EmptyStateV2.deprecated.js";
-import "./EmptyStates/EmptyState.js";
-import "./EmptyStates/ErrorEmptyState/ErrorEmptyState.js";
-import "./EmptyStates/NoDataEmptyState/NoDataEmptyState.js";
-import "./EmptyStates/NoTagsEmptyState/NoTagsEmptyState.js";
-import "./EmptyStates/NotFoundEmptyState/NotFoundEmptyState.js";
-import "./EmptyStates/NotificationsEmptyState/NotificationsEmptyState.js";
-import "./EmptyStates/UnauthorizedEmptyState/UnauthorizedEmptyState.js";
-import "./ExportModal/ExportModal.js";
-import "./ExpressiveCard/ExpressiveCard.js";
-import "./FullPageError/FullPageError.js";
-import "./ImportModal/ImportModal.js";
-import "./InterstitialScreen/InterstitialScreen.js";
-import "./InterstitialScreen/InterstitialScreenView.js";
-import "./Tearsheet/Tearsheet.js";
-import "./UserProfileImage/UserProfileImage.js";
-import "./MultiAddSelect/MultiAddSelect.js";
-import "./NotificationsPanel/NotificationsPanel.js";
-import "./OptionsTile/OptionsTile.js";
-import "./TagSet/TagSet.js";
-import "./PageHeader/PageHeader.js";
-import "./ProductiveCard/ProductiveCard.js";
-import "./RemoveModal/RemoveModal.js";
-import "./Saving/Saving.js";
-import "./ScrollGradient/ScrollGradient.js";
-import "./SingleAddSelect/SingleAddSelect.js";
-import "./StatusIcon/StatusIcon.js";
-import "./StringFormatter/StringFormatter.js";
-import "./TagOverflow/TagOverflow.js";
-import "./UserAvatar/UserAvatar.js";
-import "./WebTerminal/hooks/index.js";
-import "./WebTerminal/WebTerminal.js";
-import "./WebTerminal/WebTerminalContentWrapper.js";
-import "./Coachmark/next/Coachmark/Coachmark.js";
-import "./Coachmark/next/Coachmark/CoachmarkTagline/CoachmarkTagline.js";
-import "./Coachmark/next/Coachmark/CoachmarkBeacon/CoachmarkBeacon.js";
-import "./TruncatedText/TruncatedText.js";
-import "./PageHeader/next/index.js";
-import "./Tearsheet/next/StackContext.js";
-import "./Tearsheet/next/Tearsheet.js";
-import "./AddSelect/next/AddSelect.js";
-import "./BigNumber/BigNumber.js";
-import "./Coachmark/utils/enums.js";
-import "./Coachmark/utils/context.js";
-import "./Coachmark/Coachmark.js";
-import "./CoachmarkBeacon/CoachmarkBeacon.js";
-import "./CoachmarkButton/CoachmarkButton.js";
-import "./CoachmarkFixed/CoachmarkFixed.js";
-import "./CoachmarkOverlayElement/CoachmarkOverlayElement.js";
-import "./CoachmarkOverlayElements/CoachmarkOverlayElements.js";
-import "./CoachmarkStack/CoachmarkStack.js";
-import "./ConditionBuilder/ConditionBuilder.js";
-import "./DataSpreadsheet/DataSpreadsheet.js";
-import "./DelimitedList/DelimitedList.js";
-import "./Decorator/Decorator.js";
-import "./GetStartedCard/GetStartedCard.js";
-import "./Guidebanner/Guidebanner.js";
-import "./Guidebanner/GuidebannerElement.js";
-import "./Guidebanner/GuidebannerElementButton.js";
-import "./Guidebanner/GuidebannerElementLink.js";
-import "./InlineTip/InlineTip.js";
-import "./InlineTip/InlineTipButton.js";
-import "./InlineTip/InlineTipLink.js";
-import "./NonLinearReading/NonLinearReading.js";
-import "./SearchBar/SearchBar.js";
-import "./Toolbar/Toolbar.js";
-import "./Toolbar/ToolbarButton.js";
-import "./Toolbar/ToolbarGroup.js";
-import "./TruncatedList/TruncatedList.js";
-import "./ComboButton/ComboButton.js";
-import "./ComboButton/ComboButtonItem/index.js";
-import "./Datagrid/Datagrid/addons/Filtering/hooks/useFilterContext.js";
-import "./Datagrid/Datagrid/Datagrid.js";
-import "./Datagrid/useSortableColumns.js";
-import "./Datagrid/useDatagrid.js";
-import "./Datagrid/useInfiniteScroll.js";
-import "./Datagrid/useNestedRows.js";
-import "./Datagrid/useSelectRows.js";
-import "./Datagrid/useExpandedRow.js";
-import "./Datagrid/useOnRowClick.js";
-import "./Datagrid/useRowIsMouseOver.js";
-import "./Datagrid/useColumnRightAlign.js";
-import "./Datagrid/useDisableSelectRows.js";
-import "./Datagrid/useStickyColumn.js";
-import "./Datagrid/useActionsColumn.js";
-import "./Datagrid/useCustomizeColumns.js";
-import "./Datagrid/useSelectAllToggle.js";
-import "./Datagrid/useColumnCenterAlign.js";
-import "./Datagrid/useColumnOrder.js";
-import "./Datagrid/useInlineEdit.js";
-import "./Datagrid/useEditableCell.js";
-import "./Datagrid/useFiltering.js";
-import "./Datagrid/utils/getAutoSizedColumnWidth.js";
-import "./DecoratorLink/DecoratorLink.js";
-import "./DecoratorDualButton/DecoratorDualButton.js";
-import "./DecoratorSingleButton/DecoratorSingleButton.js";
-import "./DescriptionList/DescriptionList.js";
-import "./DescriptionList/DescriptionListBody.js";
-import "./DescriptionList/DescriptionListCell.js";
-import "./DescriptionList/DescriptionListRow.js";
-import "./EditFullPage/EditFullPage.js";
-import "./EditTearsheet/EditTearsheet.js";
-import "./EditTearsheet/EditTearsheetForm.js";
-import "./EditTearsheetNarrow/EditTearsheetNarrow.js";
-import "./EditUpdateCards/EditUpdateCards.js";
-import "./FilterPanel/FilterPanel.js";
-import "./FilterPanel/FilterPanelLabel/FilterPanelLabel.js";
-import "./FilterPanel/FilterPanelGroup/FilterPanelGroup.js";
-import "./FilterPanel/FilterPanelAccordion/FilterPanelAccordion.js";
-import "./FilterPanel/FilterPanelAccordionItem/FilterPanelAccordionItem.js";
-import "./FilterPanel/FilterPanelCheckbox/FilterPanelCheckbox.js";
-import "./FilterPanel/FilterPanelCheckboxWithOverflow/FilterPanelCheckboxWithOverflow.js";
-import "./FilterPanel/FilterPanelSearch/FilterPanelSearch.js";
-import "./HTTPErrors/HTTPError403/HTTPError403.js";
-import "./HTTPErrors/HTTPError404/HTTPError404.js";
-import "./HTTPErrors/HTTPErrorOther/HTTPErrorOther.js";
-import "./Nav/NavItem.js";
-import "./Nav/NavList.js";
-import "./Nav/Nav.js";
-import "./StatusIndicator/StatusIndicator.js";
-import "./StatusIndicator/StatusIndicatorStep.js";
-import { AddSelectData } from "@carbon/ibm-products-utilities";
-export { AddSelectData };