@carbon/ibm-products-web-components 0.45.0 → 0.46.0

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

@@ -1 +1 @@
-{"version":3,"file":"add-select-data.js","names":[],"sources":["../../../../../../ibm-products-utilities/src/utils/add-select/add-select-data.ts"],"sourcesContent":["/**\n * Copyright IBM Corp. 2026\n *\n * This source code is licensed under the Apache-2.0 license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\nimport { ReactNode } from 'react';\n\n/**\n * Status types for items in the hierarchical data structure\n */\nexport type ItemStatus = 'checked' | 'unchecked' | 'indeterminate';\n\n/**\n * Interface for item details metadata\n */\nexport interface ItemDetails {\n  [key: string]: unknown;\n}\n\n/**\n * Interface for hierarchical data items\n */\nexport interface AddSelectItem {\n  /** Unique identifier for the item */\n  id: string;\n  /** Display title for the item */\n  title?: string;\n  /** Value associated with the item */\n  value?: string;\n  /** Subtitle or secondary text */\n  subtitle?: string;\n  /** Whether the item is currently selected */\n  selected?: boolean;\n  /** Selection status (checked, unchecked, or indeterminate for parent nodes) */\n  status?: ItemStatus;\n  /** Whether the item is disabled and cannot be selected */\n  disabled?: boolean;\n  /** Icon or visual element to display with the item */\n  icon?: ReactNode;\n  /** Nested children items */\n  children?: {\n    entries: AddSelectItem[];\n  };\n  /** Additional metadata and details about the item */\n  itemDetails?: ItemDetails;\n  [key: string]: unknown; // Allow additional properties\n}\n\n/**\n * Options for search functionality\n */\nexport interface SearchOptions {\n  caseSensitive?: boolean;\n  searchFields?: string[]; // Fields to search in (default: ['title', 'value'])\n  maxResults?: number; // Maximum number of results to return\n}\n\n/**\n * AddSelectData - A lightweight, framework-agnostic utility for managing hierarchical data\n *\n * This utility provides standard APIs for common operations such as setting, selecting,\n * traversing, searching, and sorting hierarchical data structures. It encapsulates data\n * logic separate from UI, allowing both React and Web Components to reuse the same\n * data management functions.\n */\nexport class AddSelectData {\n  private items: AddSelectItem[] = [];\n  private itemMap: Map<string, AddSelectItem> = new Map();\n  private parentMap: Map<string, string> = new Map(); // child id -> parent id\n  private selectedIds: Set<string> = new Set(); // Track selected IDs for O(1) lookup\n  private depthCache: Map<string, number> = new Map(); // Cache item depths\n  private selectedItemsCache: AddSelectItem[] | null = null; // Memoized selected items\n\n  /**\n   * Initialize or replace the hierarchical data\n   * @param items - Array of hierarchical items\n   */\n  setItems(items: AddSelectItem[]): void {\n    this.items = items;\n    this._invalidateCaches();\n    this._buildMaps(items);\n  }\n\n  /**\n   * Get the full list of items\n   * @returns Array of all items\n   */\n  getItems(): AddSelectItem[] {\n    return this.items;\n  }\n\n  /**\n   * Retrieve a single item by its id\n   * @param id - The item id\n   * @returns The item or undefined if not found\n   */\n  getItem(id: string): AddSelectItem | undefined {\n    return this.itemMap.get(id);\n  }\n\n  /**\n   * Update a given item with new properties\n   * @param id - The item id\n   * @param newProperties - Properties to update\n   * @returns true if item was found and updated, false otherwise\n   */\n  setItem(id: string, newProperties: Partial<AddSelectItem>): boolean {\n    const item = this.itemMap.get(id);\n    if (!item) {\n      return false;\n    }\n\n    Object.assign(item, newProperties);\n\n    // Invalidate cache if selection-related properties changed\n    if ('selected' in newProperties || 'status' in newProperties) {\n      this._invalidateSelectionCache();\n    }\n\n    return true;\n  }\n\n  /**\n   * Returns an array of items marked as selected (memoized)\n   * @returns Array of selected items\n   */\n  getSelectedItems(): AddSelectItem[] {\n    // Return cached result if available\n    if (this.selectedItemsCache !== null) {\n      return this.selectedItemsCache;\n    }\n\n    // Build and cache the result\n    const selected: AddSelectItem[] = [];\n    this.selectedIds.forEach((id) => {\n      const item = this.itemMap.get(id);\n      if (item) {\n        selected.push(item);\n      }\n    });\n\n    this.selectedItemsCache = selected;\n    return selected;\n  }\n\n  /**\n   * Mark one or more items (by id) as selected\n   * @param ids - Single id or array of ids to select\n   * @param exclusive - If true, deselect all other items (default: false)\n   */\n  setSelectedItems(ids: string | string[], exclusive: boolean = false): void {\n    const idArray = Array.isArray(ids) ? ids : [ids];\n\n    if (exclusive) {\n      // Efficiently clear all selections using the Set\n      this.selectedIds.forEach((id) => {\n        const item = this.itemMap.get(id);\n        if (item) {\n          item.selected = false;\n          item.status = 'unchecked';\n        }\n      });\n      this.selectedIds.clear();\n    }\n\n    // Select specified items\n    idArray.forEach((id) => {\n      const item = this.itemMap.get(id);\n      if (item) {\n        item.selected = true;\n        item.status = 'checked';\n        this.selectedIds.add(id);\n      }\n    });\n\n    this._invalidateSelectionCache();\n  }\n\n  /**\n   * Get direct children of a node\n   * @param id - The parent item id\n   * @returns Array of child items or empty array if no children\n   */\n  getItemChildren(id: string): AddSelectItem[] {\n    const item = this.itemMap.get(id);\n    if (!item) {\n      return [];\n    }\n    return item.children?.entries ?? [];\n  }\n\n  /**\n   * Get the parent of a node\n   * @param id - The child item id\n   * @returns The parent item or undefined if no parent (root level)\n   */\n  getItemParent(id: string): AddSelectItem | undefined {\n    const parentId = this.parentMap.get(id);\n    return parentId ? this.itemMap.get(parentId) : undefined;\n  }\n\n  /**\n   * Get all ancestors (parents up to the root) of a node\n   * @param id - The item id\n   * @returns Array of ancestor items from immediate parent to root\n   */\n  getItemParents(id: string): AddSelectItem[] {\n    const parents: AddSelectItem[] = [];\n    let currentId: string | undefined = id;\n\n    while (currentId) {\n      const parentId = this.parentMap.get(currentId);\n      if (!parentId) {\n        break;\n      }\n\n      const parent = this.itemMap.get(parentId);\n      if (parent) {\n        parents.push(parent);\n      }\n      currentId = parentId;\n    }\n\n    return parents;\n  }\n\n  /**\n   * Retrieve the selected state status of an item\n   * @param id - The item id\n   * @returns The status or undefined if item not found\n   */\n  getItemStatus(id: string): ItemStatus | undefined {\n    return this.itemMap.get(id)?.status;\n  }\n\n  /**\n   * Set or update the status of an item\n   * @param id - The item id\n   * @param status - The new status\n   * @returns true if item was found and updated, false otherwise\n   */\n  setItemStatus(id: string, status: ItemStatus): boolean {\n    const item = this.itemMap.get(id);\n    if (!item) {\n      return false;\n    }\n\n    const wasSelected = item.selected;\n    item.status = status;\n    item.selected = status === 'checked';\n\n    // Update selectedIds Set\n    if (item.selected) {\n      this.selectedIds.add(id);\n    } else {\n      this.selectedIds.delete(id);\n    }\n\n    // Invalidate cache if selection changed\n    if (wasSelected !== item.selected) {\n      this._invalidateSelectionCache();\n    }\n\n    return true;\n  }\n\n  /**\n   * Check whether an item is selected (O(1) lookup)\n   * @param id - The item id\n   * @returns true if selected, false otherwise\n   */\n  isSelected(id: string): boolean {\n    return this.selectedIds.has(id);\n  }\n\n  /**\n   * Search items based on a query and return matching items\n   * @param query - The search query string\n   * @param options - Search options\n   * @returns Array of matching items\n   */\n  search(query: string, options: SearchOptions = {}): AddSelectItem[] {\n    // Early return for empty query\n    if (!query) {\n      return [];\n    }\n\n    const {\n      caseSensitive = false,\n      searchFields = ['title', 'value'],\n      maxResults,\n    } = options;\n\n    const searchTerm = caseSensitive ? query : query.toLowerCase();\n    const results: AddSelectItem[] = [];\n\n    // Use early termination if maxResults is specified\n    const shouldContinue = (): boolean => {\n      return !maxResults || results.length < maxResults;\n    };\n\n    this._traverseItems(this.items, (item) => {\n      if (!shouldContinue()) {\n        return;\n      }\n\n      for (const field of searchFields) {\n        const fieldValue = item[field];\n        if (fieldValue) {\n          const valueToSearch = caseSensitive\n            ? String(fieldValue)\n            : String(fieldValue).toLowerCase();\n\n          if (valueToSearch.includes(searchTerm)) {\n            results.push(item);\n            break; // Don't add the same item multiple times\n          }\n        }\n      }\n    });\n\n    return results;\n  }\n\n  /**\n   * Sort items based on a comparator function\n   * @param compareFn - Comparison function for sorting\n   * @param recursive - If true, sort children recursively (default: false)\n   */\n  sort(\n    compareFn: (a: AddSelectItem, b: AddSelectItem) => number,\n    recursive: boolean = false\n  ): void {\n    // Sort recursively first if needed\n    if (recursive) {\n      this._sortRecursive(this.items, compareFn);\n    }\n\n    // Then sort the top level\n    this.items.sort(compareFn);\n\n    // Rebuild maps and caches after sorting\n    this._invalidateCaches();\n    this._buildMaps(this.items);\n  }\n\n  /**\n   * Clear all selections (optimized with Set)\n   */\n  clearSelections(): void {\n    // Efficiently clear using the selectedIds Set\n    this.selectedIds.forEach((id) => {\n      const item = this.itemMap.get(id);\n      if (item) {\n        item.selected = false;\n        item.status = 'unchecked';\n      }\n    });\n    this.selectedIds.clear();\n    this._invalidateSelectionCache();\n  }\n\n  /**\n   * Get the depth/level of an item in the hierarchy (cached)\n   * @param id - The item id\n   * @returns The depth (0 for root level items) or -1 if not found\n   */\n  getItemDepth(id: string): number {\n    // Check cache first\n    const cachedDepth = this.depthCache.get(id);\n    if (cachedDepth !== undefined) {\n      return cachedDepth;\n    }\n\n    // Item doesn't exist\n    if (!this.itemMap.has(id)) {\n      return -1;\n    }\n\n    // Calculate and cache depth\n    let depth = 0;\n    let currentId: string | undefined = id;\n\n    while (currentId) {\n      const parentId = this.parentMap.get(currentId);\n      if (!parentId) {\n        break;\n      }\n      depth++;\n      currentId = parentId;\n    }\n\n    this.depthCache.set(id, depth);\n    return depth;\n  }\n\n  /**\n   * Check if an item has children\n   * @param id - The item id\n   * @returns true if item has children, false otherwise\n   */\n  hasChildren(id: string): boolean {\n    const item = this.itemMap.get(id);\n    return !!item?.children?.entries?.length;\n  }\n\n  /**\n   * Get all descendant items of a node\n   * @param id - The parent item id\n   * @returns Array of all descendant items\n   */\n  getItemDescendants(id: string): AddSelectItem[] {\n    const item = this.itemMap.get(id);\n    if (!item?.children?.entries) {\n      return [];\n    }\n\n    const descendants: AddSelectItem[] = [];\n    this._traverseItems(item.children.entries, (child) => {\n      descendants.push(child);\n    });\n\n    return descendants;\n  }\n\n  /**\n   * Check if an item has any selected descendants (optimized)\n   * @param id - The item id\n   * @param selectedIds - Set of selected item IDs (defaults to internal selectedIds)\n   * @returns true if any descendant is selected, false otherwise\n   */\n  hasSelectedDescendants(\n    id: string,\n    selectedIds: Set<string> = this.selectedIds\n  ): boolean {\n    const children = this.getItemChildren(id);\n    if (!children.length) {\n      return false;\n    }\n\n    // Check if any child or their descendants are selected\n    for (const child of children) {\n      if (\n        selectedIds.has(child.id) ||\n        this.hasSelectedDescendants(child.id, selectedIds)\n      ) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  /**\n   * Check if all descendants of an item are selected (optimized)\n   * @param id - The item id\n   * @param selectedIds - Set of selected item IDs (defaults to internal selectedIds)\n   * @returns true if all descendants are selected, false otherwise\n   */\n  allDescendantsSelected(\n    id: string,\n    selectedIds: Set<string> = this.selectedIds\n  ): boolean {\n    const item = this.itemMap.get(id);\n    if (!item) {\n      return false;\n    }\n\n    const children = this.getItemChildren(id);\n    if (!children.length) {\n      return selectedIds.has(item.id);\n    }\n\n    // All children must be selected and all their descendants must be selected\n    for (const child of children) {\n      if (\n        !selectedIds.has(child.id) ||\n        !this.allDescendantsSelected(child.id, selectedIds)\n      ) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * Get all descendant IDs from an item (including the item itself)\n   * @param id - The item id\n   * @returns Array of all descendant IDs including the item itself\n   */\n  getAllDescendantIds(id: string): string[] {\n    const item = this.itemMap.get(id);\n    if (!item) {\n      return [];\n    }\n\n    const ids: string[] = [id];\n    const children = this.getItemChildren(id);\n\n    for (const child of children) {\n      ids.push(...this.getAllDescendantIds(child.id));\n    }\n\n    return ids;\n  }\n\n  /**\n   * Get only top-level selected items (items without selected ancestors)\n   * @param selectedIds - Set of selected item IDs (defaults to internal selectedIds)\n   * @returns Array of top-level selected items\n   */\n  getTopLevelSelectedItems(\n    selectedIds: Set<string> = this.selectedIds\n  ): AddSelectItem[] {\n    const topLevelItems: AddSelectItem[] = [];\n    const processedIds = new Set<string>();\n\n    // Helper to check if any ancestor is selected\n    const hasSelectedAncestor = (itemId: string): boolean => {\n      const parents = this.getItemParents(itemId);\n      return parents.some((parent) => selectedIds.has(parent.id));\n    };\n\n    // Collect all selected items that don't have a selected ancestor\n    selectedIds.forEach((id) => {\n      if (!processedIds.has(id) && !hasSelectedAncestor(id)) {\n        const item = this.itemMap.get(id);\n        if (item) {\n          topLevelItems.push(item);\n          // Mark all descendants as processed\n          const descendantIds = this.getAllDescendantIds(id);\n          descendantIds.forEach((descId) => processedIds.add(descId));\n        }\n      }\n    });\n\n    return topLevelItems;\n  }\n\n  /**\n   * Invalidate all caches\n   * @private\n   */\n  private _invalidateCaches(): void {\n    this.selectedItemsCache = null;\n    this.depthCache.clear();\n  }\n\n  /**\n   * Invalidate selection cache only\n   * @private\n   */\n  private _invalidateSelectionCache(): void {\n    this.selectedItemsCache = null;\n  }\n\n  /**\n   * Build internal maps for efficient lookups (optimized with depth caching)\n   * @private\n   */\n  private _buildMaps(\n    items: AddSelectItem[],\n    parentId?: string,\n    depth: number = 0\n  ): void {\n    if (!parentId) {\n      // Clear maps when building from root\n      this.itemMap.clear();\n      this.parentMap.clear();\n      this.selectedIds.clear();\n      this.depthCache.clear();\n    }\n\n    items.forEach((item) => {\n      this.itemMap.set(item.id, item);\n      this.depthCache.set(item.id, depth);\n\n      if (parentId) {\n        this.parentMap.set(item.id, parentId);\n      }\n\n      // Track selected items\n      if (item.selected) {\n        this.selectedIds.add(item.id);\n      }\n\n      if (item.children?.entries) {\n        this._buildMaps(item.children.entries, item.id, depth + 1);\n      }\n    });\n  }\n\n  /**\n   * Traverse all items and apply a callback function\n   * @private\n   */\n  private _traverseItems(\n    items: AddSelectItem[],\n    callback: (item: AddSelectItem) => void\n  ): void {\n    for (const item of items) {\n      callback(item);\n      if (item.children?.entries) {\n        this._traverseItems(item.children.entries, callback);\n      }\n    }\n  }\n\n  /**\n   * Sort items recursively\n   * @private\n   */\n  private _sortRecursive(\n    items: AddSelectItem[],\n    compareFn: (a: AddSelectItem, b: AddSelectItem) => number\n  ): void {\n    for (const item of items) {\n      if (item.children?.entries) {\n        item.children.entries.sort(compareFn);\n        this._sortRecursive(item.children.entries, compareFn);\n      }\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"add-select-data.js","names":[],"sources":["../../../../../../ibm-products-utilities/src/utils/add-select/add-select-data.ts"],"sourcesContent":["/**\n * Copyright IBM Corp. 2026\n *\n * This source code is licensed under the Apache-2.0 license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\nimport { ReactNode } from 'react';\n\n/**\n * Status types for items in the hierarchical data structure\n */\nexport type ItemStatus = 'checked' | 'unchecked' | 'indeterminate';\n\n/**\n * A single labelled detail entry for display in `defaultContent()`.\n * Use this form when you want `AddSelectItemPanel` or\n * `AddSelectSelectionSummaryItem` to render key-value pairs automatically.\n */\nexport interface ItemDetailEntry {\n  /** User-visible label shown as the row heading */\n  label: string;\n  /** Value displayed beneath the label */\n  value: string | number;\n}\n\n/**\n * Item details metadata.\n *\n * **Preferred form** — labelled array consumed by `defaultContent()`:\n * ```ts\n * itemDetails: [\n *   { label: 'Category', value: 'Analytics' },\n *   { label: 'Owner',    value: 'Marketing Team' },\n * ]\n * ```\n *\n * **Legacy form** — arbitrary record for custom renderers that access\n * named keys directly (e.g. `item.itemDetails.description`). Not rendered\n * by `defaultContent()`.\n */\nexport type ItemDetails = ItemDetailEntry[] | Record<string, unknown>;\n\n/**\n * Interface for hierarchical data items\n */\nexport interface AddSelectItem {\n  /** Unique identifier for the item */\n  id: string;\n  /** Display title for the item */\n  title?: string;\n  /** Value associated with the item */\n  value?: string;\n  /** Subtitle or secondary text */\n  subtitle?: string;\n  /** Whether the item is currently selected */\n  selected?: boolean;\n  /** Selection status (checked, unchecked, or indeterminate for parent nodes) */\n  status?: ItemStatus;\n  /** Whether the item is disabled and cannot be selected */\n  disabled?: boolean;\n  /** Icon or visual element to display with the item */\n  icon?: ReactNode;\n  /** Nested children items */\n  children?: {\n    entries: AddSelectItem[];\n  };\n  /** Additional metadata and details about the item */\n  itemDetails?: ItemDetails;\n  [key: string]: unknown; // Allow additional properties\n}\n\n/**\n * Options for search functionality\n */\nexport interface SearchOptions {\n  caseSensitive?: boolean;\n  searchFields?: string[]; // Fields to search in (default: ['title', 'value'])\n  maxResults?: number; // Maximum number of results to return\n}\n\n/**\n * AddSelectData - A lightweight, framework-agnostic utility for managing hierarchical data\n *\n * This utility provides standard APIs for common operations such as setting, selecting,\n * traversing, searching, and sorting hierarchical data structures. It encapsulates data\n * logic separate from UI, allowing both React and Web Components to reuse the same\n * data management functions.\n */\nexport class AddSelectData {\n  private items: AddSelectItem[] = [];\n  private itemMap: Map<string, AddSelectItem> = new Map();\n  private parentMap: Map<string, string> = new Map(); // child id -> parent id\n  private selectedIds: Set<string> = new Set(); // Track selected IDs for O(1) lookup\n  private depthCache: Map<string, number> = new Map(); // Cache item depths\n  private selectedItemsCache: AddSelectItem[] | null = null; // Memoized selected items\n\n  /**\n   * Initialize or replace the hierarchical data\n   * @param items - Array of hierarchical items\n   */\n  setItems(items: AddSelectItem[]): void {\n    this.items = items;\n    this._invalidateCaches();\n    this._buildMaps(items);\n  }\n\n  /**\n   * Get the full list of items\n   * @returns Array of all items\n   */\n  getItems(): AddSelectItem[] {\n    return this.items;\n  }\n\n  /**\n   * Retrieve a single item by its id\n   * @param id - The item id\n   * @returns The item or undefined if not found\n   */\n  getItem(id: string): AddSelectItem | undefined {\n    return this.itemMap.get(id);\n  }\n\n  /**\n   * Update a given item with new properties\n   * @param id - The item id\n   * @param newProperties - Properties to update\n   * @returns true if item was found and updated, false otherwise\n   */\n  setItem(id: string, newProperties: Partial<AddSelectItem>): boolean {\n    const item = this.itemMap.get(id);\n    if (!item) {\n      return false;\n    }\n\n    Object.assign(item, newProperties);\n\n    // Invalidate cache if selection-related properties changed\n    if ('selected' in newProperties || 'status' in newProperties) {\n      this._invalidateSelectionCache();\n    }\n\n    return true;\n  }\n\n  /**\n   * Returns an array of items marked as selected (memoized)\n   * @returns Array of selected items\n   */\n  getSelectedItems(): AddSelectItem[] {\n    // Return cached result if available\n    if (this.selectedItemsCache !== null) {\n      return this.selectedItemsCache;\n    }\n\n    // Build and cache the result\n    const selected: AddSelectItem[] = [];\n    this.selectedIds.forEach((id) => {\n      const item = this.itemMap.get(id);\n      if (item) {\n        selected.push(item);\n      }\n    });\n\n    this.selectedItemsCache = selected;\n    return selected;\n  }\n\n  /**\n   * Mark one or more items (by id) as selected\n   * @param ids - Single id or array of ids to select\n   * @param exclusive - If true, deselect all other items (default: false)\n   */\n  setSelectedItems(ids: string | string[], exclusive: boolean = false): void {\n    const idArray = Array.isArray(ids) ? ids : [ids];\n\n    if (exclusive) {\n      // Efficiently clear all selections using the Set\n      this.selectedIds.forEach((id) => {\n        const item = this.itemMap.get(id);\n        if (item) {\n          item.selected = false;\n          item.status = 'unchecked';\n        }\n      });\n      this.selectedIds.clear();\n    }\n\n    // Select specified items\n    idArray.forEach((id) => {\n      const item = this.itemMap.get(id);\n      if (item) {\n        item.selected = true;\n        item.status = 'checked';\n        this.selectedIds.add(id);\n      }\n    });\n\n    this._invalidateSelectionCache();\n  }\n\n  /**\n   * Get direct children of a node\n   * @param id - The parent item id\n   * @returns Array of child items or empty array if no children\n   */\n  getItemChildren(id: string): AddSelectItem[] {\n    const item = this.itemMap.get(id);\n    if (!item) {\n      return [];\n    }\n    return item.children?.entries ?? [];\n  }\n\n  /**\n   * Get the parent of a node\n   * @param id - The child item id\n   * @returns The parent item or undefined if no parent (root level)\n   */\n  getItemParent(id: string): AddSelectItem | undefined {\n    const parentId = this.parentMap.get(id);\n    return parentId ? this.itemMap.get(parentId) : undefined;\n  }\n\n  /**\n   * Get all ancestors (parents up to the root) of a node\n   * @param id - The item id\n   * @returns Array of ancestor items from immediate parent to root\n   */\n  getItemParents(id: string): AddSelectItem[] {\n    const parents: AddSelectItem[] = [];\n    let currentId: string | undefined = id;\n\n    while (currentId) {\n      const parentId = this.parentMap.get(currentId);\n      if (!parentId) {\n        break;\n      }\n\n      const parent = this.itemMap.get(parentId);\n      if (parent) {\n        parents.push(parent);\n      }\n      currentId = parentId;\n    }\n\n    return parents;\n  }\n\n  /**\n   * Retrieve the selected state status of an item\n   * @param id - The item id\n   * @returns The status or undefined if item not found\n   */\n  getItemStatus(id: string): ItemStatus | undefined {\n    return this.itemMap.get(id)?.status;\n  }\n\n  /**\n   * Set or update the status of an item\n   * @param id - The item id\n   * @param status - The new status\n   * @returns true if item was found and updated, false otherwise\n   */\n  setItemStatus(id: string, status: ItemStatus): boolean {\n    const item = this.itemMap.get(id);\n    if (!item) {\n      return false;\n    }\n\n    const wasSelected = item.selected;\n    item.status = status;\n    item.selected = status === 'checked';\n\n    // Update selectedIds Set\n    if (item.selected) {\n      this.selectedIds.add(id);\n    } else {\n      this.selectedIds.delete(id);\n    }\n\n    // Invalidate cache if selection changed\n    if (wasSelected !== item.selected) {\n      this._invalidateSelectionCache();\n    }\n\n    return true;\n  }\n\n  /**\n   * Check whether an item is selected (O(1) lookup)\n   * @param id - The item id\n   * @returns true if selected, false otherwise\n   */\n  isSelected(id: string): boolean {\n    return this.selectedIds.has(id);\n  }\n\n  /**\n   * Search items based on a query and return matching items\n   * @param query - The search query string\n   * @param options - Search options\n   * @returns Array of matching items\n   */\n  search(query: string, options: SearchOptions = {}): AddSelectItem[] {\n    // Early return for empty query\n    if (!query) {\n      return [];\n    }\n\n    const {\n      caseSensitive = false,\n      searchFields = ['title', 'value'],\n      maxResults,\n    } = options;\n\n    const searchTerm = caseSensitive ? query : query.toLowerCase();\n    const results: AddSelectItem[] = [];\n\n    // Use early termination if maxResults is specified\n    const shouldContinue = (): boolean => {\n      return !maxResults || results.length < maxResults;\n    };\n\n    this._traverseItems(this.items, (item) => {\n      if (!shouldContinue()) {\n        return;\n      }\n\n      for (const field of searchFields) {\n        const fieldValue = item[field];\n        if (fieldValue) {\n          const valueToSearch = caseSensitive\n            ? String(fieldValue)\n            : String(fieldValue).toLowerCase();\n\n          if (valueToSearch.includes(searchTerm)) {\n            results.push(item);\n            break; // Don't add the same item multiple times\n          }\n        }\n      }\n    });\n\n    return results;\n  }\n\n  /**\n   * Sort items based on a comparator function\n   * @param compareFn - Comparison function for sorting\n   * @param recursive - If true, sort children recursively (default: false)\n   */\n  sort(\n    compareFn: (a: AddSelectItem, b: AddSelectItem) => number,\n    recursive: boolean = false\n  ): void {\n    // Sort recursively first if needed\n    if (recursive) {\n      this._sortRecursive(this.items, compareFn);\n    }\n\n    // Then sort the top level\n    this.items.sort(compareFn);\n\n    // Rebuild maps and caches after sorting\n    this._invalidateCaches();\n    this._buildMaps(this.items);\n  }\n\n  /**\n   * Clear all selections (optimized with Set)\n   */\n  clearSelections(): void {\n    // Efficiently clear using the selectedIds Set\n    this.selectedIds.forEach((id) => {\n      const item = this.itemMap.get(id);\n      if (item) {\n        item.selected = false;\n        item.status = 'unchecked';\n      }\n    });\n    this.selectedIds.clear();\n    this._invalidateSelectionCache();\n  }\n\n  /**\n   * Get the depth/level of an item in the hierarchy (cached)\n   * @param id - The item id\n   * @returns The depth (0 for root level items) or -1 if not found\n   */\n  getItemDepth(id: string): number {\n    // Check cache first\n    const cachedDepth = this.depthCache.get(id);\n    if (cachedDepth !== undefined) {\n      return cachedDepth;\n    }\n\n    // Item doesn't exist\n    if (!this.itemMap.has(id)) {\n      return -1;\n    }\n\n    // Calculate and cache depth\n    let depth = 0;\n    let currentId: string | undefined = id;\n\n    while (currentId) {\n      const parentId = this.parentMap.get(currentId);\n      if (!parentId) {\n        break;\n      }\n      depth++;\n      currentId = parentId;\n    }\n\n    this.depthCache.set(id, depth);\n    return depth;\n  }\n\n  /**\n   * Check if an item has children\n   * @param id - The item id\n   * @returns true if item has children, false otherwise\n   */\n  hasChildren(id: string): boolean {\n    const item = this.itemMap.get(id);\n    return !!item?.children?.entries?.length;\n  }\n\n  /**\n   * Get all descendant items of a node\n   * @param id - The parent item id\n   * @returns Array of all descendant items\n   */\n  getItemDescendants(id: string): AddSelectItem[] {\n    const item = this.itemMap.get(id);\n    if (!item?.children?.entries) {\n      return [];\n    }\n\n    const descendants: AddSelectItem[] = [];\n    this._traverseItems(item.children.entries, (child) => {\n      descendants.push(child);\n    });\n\n    return descendants;\n  }\n\n  /**\n   * Check if an item has any selected descendants (optimized)\n   * @param id - The item id\n   * @param selectedIds - Set of selected item IDs (defaults to internal selectedIds)\n   * @returns true if any descendant is selected, false otherwise\n   */\n  hasSelectedDescendants(\n    id: string,\n    selectedIds: Set<string> = this.selectedIds\n  ): boolean {\n    const children = this.getItemChildren(id);\n    if (!children.length) {\n      return false;\n    }\n\n    // Check if any child or their descendants are selected\n    for (const child of children) {\n      if (\n        selectedIds.has(child.id) ||\n        this.hasSelectedDescendants(child.id, selectedIds)\n      ) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  /**\n   * Check if all descendants of an item are selected (optimized)\n   * @param id - The item id\n   * @param selectedIds - Set of selected item IDs (defaults to internal selectedIds)\n   * @returns true if all descendants are selected, false otherwise\n   */\n  allDescendantsSelected(\n    id: string,\n    selectedIds: Set<string> = this.selectedIds\n  ): boolean {\n    const item = this.itemMap.get(id);\n    if (!item) {\n      return false;\n    }\n\n    const children = this.getItemChildren(id);\n    if (!children.length) {\n      return selectedIds.has(item.id);\n    }\n\n    // All children must be selected and all their descendants must be selected\n    for (const child of children) {\n      if (\n        !selectedIds.has(child.id) ||\n        !this.allDescendantsSelected(child.id, selectedIds)\n      ) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * Get all descendant IDs from an item (including the item itself)\n   * @param id - The item id\n   * @returns Array of all descendant IDs including the item itself\n   */\n  getAllDescendantIds(id: string): string[] {\n    const item = this.itemMap.get(id);\n    if (!item) {\n      return [];\n    }\n\n    const ids: string[] = [id];\n    const children = this.getItemChildren(id);\n\n    for (const child of children) {\n      ids.push(...this.getAllDescendantIds(child.id));\n    }\n\n    return ids;\n  }\n\n  /**\n   * Get only top-level selected items (items without selected ancestors)\n   * @param selectedIds - Set of selected item IDs (defaults to internal selectedIds)\n   * @returns Array of top-level selected items\n   */\n  getTopLevelSelectedItems(\n    selectedIds: Set<string> = this.selectedIds\n  ): AddSelectItem[] {\n    const topLevelItems: AddSelectItem[] = [];\n    const processedIds = new Set<string>();\n\n    // Helper to check if any ancestor is selected\n    const hasSelectedAncestor = (itemId: string): boolean => {\n      const parents = this.getItemParents(itemId);\n      return parents.some((parent) => selectedIds.has(parent.id));\n    };\n\n    // Collect all selected items that don't have a selected ancestor\n    selectedIds.forEach((id) => {\n      if (!processedIds.has(id) && !hasSelectedAncestor(id)) {\n        const item = this.itemMap.get(id);\n        if (item) {\n          topLevelItems.push(item);\n          // Mark all descendants as processed\n          const descendantIds = this.getAllDescendantIds(id);\n          descendantIds.forEach((descId) => processedIds.add(descId));\n        }\n      }\n    });\n\n    return topLevelItems;\n  }\n\n  /**\n   * Invalidate all caches\n   * @private\n   */\n  private _invalidateCaches(): void {\n    this.selectedItemsCache = null;\n    this.depthCache.clear();\n  }\n\n  /**\n   * Invalidate selection cache only\n   * @private\n   */\n  private _invalidateSelectionCache(): void {\n    this.selectedItemsCache = null;\n  }\n\n  /**\n   * Build internal maps for efficient lookups (optimized with depth caching)\n   * @private\n   */\n  private _buildMaps(\n    items: AddSelectItem[],\n    parentId?: string,\n    depth: number = 0\n  ): void {\n    if (!parentId) {\n      // Clear maps when building from root\n      this.itemMap.clear();\n      this.parentMap.clear();\n      this.selectedIds.clear();\n      this.depthCache.clear();\n    }\n\n    items.forEach((item) => {\n      this.itemMap.set(item.id, item);\n      this.depthCache.set(item.id, depth);\n\n      if (parentId) {\n        this.parentMap.set(item.id, parentId);\n      }\n\n      // Track selected items\n      if (item.selected) {\n        this.selectedIds.add(item.id);\n      }\n\n      if (item.children?.entries) {\n        this._buildMaps(item.children.entries, item.id, depth + 1);\n      }\n    });\n  }\n\n  /**\n   * Traverse all items and apply a callback function\n   * @private\n   */\n  private _traverseItems(\n    items: AddSelectItem[],\n    callback: (item: AddSelectItem) => void\n  ): void {\n    for (const item of items) {\n      callback(item);\n      if (item.children?.entries) {\n        this._traverseItems(item.children.entries, callback);\n      }\n    }\n  }\n\n  /**\n   * Sort items recursively\n   * @private\n   */\n  private _sortRecursive(\n    items: AddSelectItem[],\n    compareFn: (a: AddSelectItem, b: AddSelectItem) => number\n  ): void {\n    for (const item of items) {\n      if (item.children?.entries) {\n        item.children.entries.sort(compareFn);\n        this._sortRecursive(item.children.entries, compareFn);\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/es-custom/ibm-products-web-components/package.js

@@ -6,7 +6,7 @@
  */
 
 //#region package.json
-var version = "0.45.0-rc.0";
+var version = "0.46.0-rc.0";
 //#endregion
 export { version };
 

package/lib/components/add-select/add-select-body.d.ts

@@ -15,16 +15,14 @@ import '@carbon/web-components/es/components/link/index.js';
 /**
  * Add Select Body component - contains the main content area
  * @element c4p-add-select-body
- * @slot default - The main content area containing c4p-add-select-content
- * @slot header - Custom header content
- * @fires c4p-add-select-body-search - Fired when search term changes
+ * @slot default - The main content area containing c4p-add-select-column or rows
+ * @slot header - Replaces the entire header section
+ * @slot actions - Custom actions (filter/sort) rendered next to the search input
+ * @slot sub-header-actions - Custom content rendered after breadcrumbs and item count
+ * @fires c4p-add-select-body-search - Fired when search term changes; detail: { searchTerm }
+ * @fires c4p-add-select-body-breadcrumb-click - Fired when a breadcrumb link is clicked; detail: { index }
  */
 declare class CDSAddSelectBody extends LitElement {
-    /**
-     * Whether this is a multi-select (inherited from parent c4p-add-select)
-     * @private
-     */
-    private get _multi();
     /**
      * Label for items section
      */
@@ -52,9 +50,13 @@ declare class CDSAddSelectBody extends LitElement {
      */
     private _searchTerm;
     /**
-     * Item count for display
+     * Item count for display. When undefined, no count badge is rendered.
+     */
+    itemCount: number | undefined;
+    /**
+     * Whether to hide the search input
      */
-    itemCount: number;
+    hideSearch: boolean;
     /**
      * Navigation path for breadcrumbs
      */
@@ -66,6 +68,9 @@ declare class CDSAddSelectBody extends LitElement {
      * Handle search input
      */
     private _handleSearch;
+    /** Tracks whether the header slot has been filled by the consumer */
+    private _hasHeaderSlot;
+    private _handleHeaderSlotChange;
     render(): import("lit-html").TemplateResult<1>;
     /**
      * The name of the custom event fired when search term changes

package/lib/components/add-select/add-select-body.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-select-body.d.ts","sourceRoot":"","sources":["../../../src/components/add-select/add-select-body.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAQ,MAAM,KAAK,CAAC;AAIvC,OAAO,sDAAsD,CAAC;AAC9D,OAAO,sDAAsD,CAAC;AAC9D,OAAO,mDAAmD,CAAC;AAC3D,OAAO,0DAA0D,CAAC;AAClE,OAAO,oDAAoD,CAAC;AAM5D;;;;;;GAMG;AACH,cACM,gBAAiB,SAAQ,UAAU;IACvC;;;OAGG;IACH,OAAO,KAAK,MAAM,GAGjB;IAED;;OAEG;IAEH,UAAU,SAAM;IAEhB;;OAEG;IAEH,iBAAiB,SAAM;IAEvB;;OAEG;IAEH,uBAAuB,SAAY;IAEnC;;OAEG;IAIH;;OAEG;IAIH;;OAEG;IAEH,kBAAkB,SAAoB;IAEtC;;OAEG;IAEH,OAAO,CAAC,WAAW,CAAM;IAEzB;;OAEG;IAEH,SAAS,SAAK;IAEd;;OAEG;IAEH,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IAEhD;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB,MAAM;IA2GN;;OAEG;IACH,MAAM,KAAK,WAAW,WAErB;IAED;;OAEG;IACH,MAAM,KAAK,oBAAoB,WAE9B;IAED,MAAM,CAAC,MAAM,MAAU;CACxB;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"add-select-body.d.ts","sourceRoot":"","sources":["../../../src/components/add-select/add-select-body.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAGhD,OAAO,sDAAsD,CAAC;AAC9D,OAAO,sDAAsD,CAAC;AAC9D,OAAO,mDAAmD,CAAC;AAC3D,OAAO,0DAA0D,CAAC;AAClE,OAAO,oDAAoD,CAAC;AAM5D;;;;;;;;;GASG;AACH,cACM,gBAAiB,SAAQ,UAAU;IACvC;;OAEG;IAEH,UAAU,SAAM;IAEhB;;OAEG;IAEH,iBAAiB,SAAM;IAEvB;;OAEG;IAEH,uBAAuB,SAAY;IAEnC;;OAEG;IAIH;;OAEG;IAIH;;OAEG;IAEH,kBAAkB,SAAoB;IAEtC;;OAEG;IAEH,OAAO,CAAC,WAAW,CAAM;IAEzB;;OAEG;IAEH,SAAS,EAAE,MAAM,GAAG,SAAS,CAAa;IAE1C;;OAEG;IAEH,UAAU,UAAS;IAEnB;;OAEG;IAEH,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IAEhD;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB,qEAAqE;IAErE,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,uBAAuB;IAK/B,MAAM;IA4IN;;OAEG;IACH,MAAM,KAAK,WAAW,WAErB;IAED;;OAEG;IACH,MAAM,KAAK,oBAAoB,WAE9B;IAED,MAAM,CAAC,MAAM,MAAU;CACxB;AAED,eAAe,gBAAgB,CAAC"}

package/lib/components/add-select/add-select-column.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @license
+ *
+ * Copyright IBM Corp. 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 { LitElement } from 'lit';
+import '@carbon/web-components/es/components/search/index.js';
+import '@carbon/web-components/es/components/tag/index.js';
+import '@carbon/web-components/es/components/checkbox/index.js';
+/**
+ * Add Select Column component — optional column wrapper providing column-level
+ * search, title, and "Select All" functionality. Propagates `multi` context to
+ * child rows via the `multi` property/attribute.
+ * @element c4p-add-select-column
+ * @slot default - AddSelectRow elements
+ * @slot actions - Custom actions (filter/sort) placed next to column search
+ * @fires c4p-add-select-column-search - Fired when column search changes; detail: { searchTerm }
+ * @fires c4p-add-select-column-select-all - Fired when "Select All" checkbox changes; detail: { checked }
+ */
+declare class CDSAddSelectColumn extends LitElement {
+    /**
+     * Column title shown in the header
+     */
+    title: string;
+    /**
+     * Label text for the column search input (accessibility)
+     */
+    searchLabel: string;
+    /**
+     * Placeholder text for the column search input
+     */
+    searchPlaceholder: string;
+    /**
+     * Whether to hide the column search input
+     */
+    hideSearch: boolean;
+    /**
+     * Whether this column uses multi-selection (checkboxes) or single-selection (radio buttons)
+     */
+    multi: boolean;
+    /**
+     * Whether to show the "Select All" checkbox (only when multi is true)
+     */
+    showSelectAll: boolean;
+    /**
+     * Total number of items in the column (shown in tag badge)
+     */
+    itemCount: number;
+    /**
+     * Whether all items are currently selected
+     */
+    allSelected: boolean;
+    /**
+     * Whether the "Select All" checkbox is in an indeterminate state
+     */
+    allIndeterminate: boolean;
+    /** Internal column search term */
+    private _searchTerm;
+    /** Whether the actions slot has any assigned content */
+    private _hasActionsSlot;
+    private _handleActionsSlotChange;
+    private _handleSearch;
+    private _handleSelectAll;
+    private _handleSlotChange;
+    updated(changed: Map<string, unknown>): void;
+    render(): import("lit-html").TemplateResult<1>;
+    /**
+     * The name of the custom event fired when column search changes.
+     * detail: { searchTerm: string }
+     */
+    static get eventSearch(): string;
+    /**
+     * The name of the custom event fired when "Select All" is toggled.
+     * detail: { checked: boolean }
+     */
+    static get eventSelectAll(): string;
+    static styles: any;
+}
+export default CDSAddSelectColumn;
+//# sourceMappingURL=add-select-column.d.ts.map

package/lib/components/add-select/add-select-column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-select-column.d.ts","sourceRoot":"","sources":["../../../src/components/add-select/add-select-column.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAIhD,OAAO,sDAAsD,CAAC;AAC9D,OAAO,mDAAmD,CAAC;AAC3D,OAAO,wDAAwD,CAAC;AAMhE;;;;;;;;;GASG;AACH,cACM,kBAAmB,SAAQ,UAAU;IACzC;;OAEG;IAEH,KAAK,SAAM;IAEX;;OAEG;IAEH,WAAW,SAAY;IAEvB;;OAEG;IAEH,iBAAiB,SAAY;IAE7B;;OAEG;IAEH,UAAU,UAAS;IAEnB;;OAEG;IAEH,KAAK,UAAS;IAEd;;OAEG;IAEH,aAAa,UAAS;IAEtB;;OAEG;IAEH,SAAS,SAAK;IAEd;;OAEG;IAEH,WAAW,UAAS;IAEpB;;OAEG;IAEH,gBAAgB,UAAS;IAEzB,kCAAkC;IAElC,OAAO,CAAC,WAAW,CAAM;IAEzB,wDAAwD;IAExD,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,wBAAwB;IAKhC,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAMrC,MAAM;IAkGN;;;OAGG;IACH,MAAM,KAAK,WAAW,WAErB;IAED;;;OAGG;IACH,MAAM,KAAK,cAAc,WAExB;IAED,MAAM,CAAC,MAAM,MAAU;CACxB;AAED,eAAe,kBAAkB,CAAC"}

package/lib/components/add-select/add-select-item-panel.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @license
+ *
+ * Copyright IBM Corp. 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 { LitElement } from 'lit';
+import '@carbon/web-components/es/components/icon-button/index.js';
+import type { AddSelectItem } from '@carbon/ibm-products-utilities';
+/**
+ * Add Select Item Panel — side panel displaying detailed information about an item.
+ * CSS modifier `${blockClass}__item-summary-panel--open` is added when `open` is true,
+ * enabling CSS-driven slide-in/out transitions.
+ * @element c4p-add-select-item-panel
+ * @slot default - Highest priority: replaces all body rendering when populated
+ * @slot render-item - Medium priority: receives item for custom rendering
+ * @fires c4p-add-select-item-panel-close - Fired when close icon is clicked
+ */
+declare class CDSAddSelectItemPanel extends LitElement {
+    /**
+     * Panel title
+     */
+    title: string;
+    /**
+     * Item data (set via JS property)
+     */
+    item: AddSelectItem | null;
+    /**
+     * Controls panel visibility via CSS modifier class (enables CSS transitions)
+     */
+    open: boolean;
+    /**
+     * Accessible label for the close icon button
+     */
+    closeIconDescription: string;
+    /**
+     * Whether to show the close button
+     */
+    showCloseButton: boolean;
+    private _handleClose;
+    private _renderDefaultContent;
+    /** Whether the default slot has assigned elements */
+    private _hasDefaultSlot;
+    /** Whether the render-item slot has assigned elements */
+    private _hasRenderItemSlot;
+    private _handleDefaultSlotChange;
+    private _handleRenderItemSlotChange;
+    render(): import("lit-html").TemplateResult<1>;
+    /**
+     * The name of the custom event fired when the close icon is clicked.
+     */
+    static get eventClose(): string;
+    static styles: any;
+}
+export default CDSAddSelectItemPanel;
+//# sourceMappingURL=add-select-item-panel.d.ts.map

package/lib/components/add-select/add-select-item-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-select-item-panel.d.ts","sourceRoot":"","sources":["../../../src/components/add-select/add-select-item-panel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAIhD,OAAO,2DAA2D,CAAC;AAInE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAKpE;;;;;;;;GAQG;AACH,cACM,qBAAsB,SAAQ,UAAU;IAC5C;;OAEG;IAEH,KAAK,SAAkB;IAEvB;;OAEG;IAEH,IAAI,EAAE,aAAa,GAAG,IAAI,CAAQ;IAElC;;OAEG;IAEH,IAAI,UAAS;IAEb;;OAEG;IAEH,oBAAoB,SAAW;IAE/B;;OAEG;IAEH,eAAe,UAAQ;IAEvB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,qBAAqB;IA6B7B,qDAAqD;IAErD,OAAO,CAAC,eAAe,CAAS;IAEhC,yDAAyD;IAEzD,OAAO,CAAC,kBAAkB,CAAS;IAEnC,OAAO,CAAC,wBAAwB;IAKhC,OAAO,CAAC,2BAA2B;IAMnC,MAAM;IAwDN;;OAEG;IACH,MAAM,KAAK,UAAU,WAEpB;IAED,MAAM,CAAC,MAAM,MAAU;CACxB;AAED,eAAe,qBAAqB,CAAC"}

package/lib/components/add-select/add-select-row.d.ts

@@ -9,6 +9,9 @@
 import { LitElement } from 'lit';
 import '@carbon/web-components/es/components/checkbox/index.js';
 import '@carbon/web-components/es/components/radio-button/index.js';
+import '@carbon/web-components/es/components/skeleton-text/index.js';
+import '@carbon/web-components/es/components/skeleton-icon/index.js';
+import '@carbon/web-components/es/components/icon-button/index.js';
 /**
  * Add Select Row component - represents a single selectable row
  * @element c4p-add-select-row
@@ -17,12 +20,15 @@ import '@carbon/web-components/es/components/radio-button/index.js';
  * @slot meta - Optional metadata slot
  * @fires c4p-add-select-row-select - Fired when row is selected/deselected
  * @fires c4p-add-select-row-navigate - Fired when navigating to children
+ * @fires c4p-add-select-row-item-panel-click - Fired when the item panel icon button is clicked
  */
 declare class CDSAddSelectRow extends LitElement {
     /**
-     * Whether this is part of a multi-select list (inherited from parent c4p-add-select)
-     * @private
+     * Whether this row renders a checkbox (multi) or radio button (single).
+     * Set by the parent c4p-add-select-column via the _column-multi attribute.
+     * Falls back to reading the nearest c4p-add-select wrapper when not set.
      */
+    private _columnMulti;
     private get _multi();
     /**
      * Unique identifier for the item
@@ -44,10 +50,36 @@ declare class CDSAddSelectRow extends LitElement {
      * Whether the item is selected
      */
     selected: boolean;
+    /**
+     * Whether the checkbox is in an indeterminate state (multi hierarchical)
+     */
+    indeterminate: boolean;
     /**
      * Whether the item is disabled
      */
     disabled: boolean;
+    /**
+     * Whether to render the row as a skeleton (loading) state
+     */
+    skeleton: boolean;
+    /** Whether the icon slot has assigned content */
+    private _hasIconSlot;
+    private _handleIconSlotChange;
+    /** Whether the rowContent slot has assigned content */
+    private _hasRowContentSlot;
+    private _handleRowContentSlotChange;
+    /**
+     * Whether to show the item details icon button
+     */
+    hasItemPanel: boolean;
+    /**
+     * Whether the item panel is currently open for this item
+     */
+    itemPanelOpen: boolean;
+    /**
+     * Accessible label for the item panel icon button
+     */
+    itemPanelIconDescription: string;
     /**
      * Whether the item has children (for navigation)
      */
@@ -56,6 +88,10 @@ declare class CDSAddSelectRow extends LitElement {
      * Parent ID for hierarchical navigation
      */
     parentId: string;
+    /**
+     * Handle item panel icon button click
+     */
+    private _handleItemPanelClick;
     /**
      * Handle navigation to children
      */
@@ -77,6 +113,10 @@ declare class CDSAddSelectRow extends LitElement {
      * The name of the custom event fired when navigating to children
      */
     static get eventNavigate(): string;
+    /**
+     * The name of the custom event fired when item panel icon button is clicked
+     */
+    static get eventItemPanelClick(): string;
     static styles: any;
 }
 export default CDSAddSelectRow;

package/lib/components/add-select/add-select-row.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-select-row.d.ts","sourceRoot":"","sources":["../../../src/components/add-select/add-select-row.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAIhD,OAAO,wDAAwD,CAAC;AAChE,OAAO,4DAA4D,CAAC;AASpE;;;;;;;;GAQG;AACH,cACM,eAAgB,SAAQ,UAAU;IACtC;;;OAGG;IACH,OAAO,KAAK,MAAM,GAGjB;IACD;;OAEG;IAEH,MAAM,SAAM;IAEZ;;OAEG;IAEH,KAAK,SAAM;IAEX;;OAEG;IAEH,QAAQ,SAAM;IAEd;;OAEG;IAEH,KAAK,SAAM;IAEX;;OAEG;IAEH,QAAQ,UAAS;IAEjB;;OAEG;IAEH,QAAQ,UAAS;IAEjB;;OAEG;IAEH,WAAW,UAAS;IAEpB;;OAEG;IAEH,QAAQ,SAAM;IAEd;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmB3B,MAAM;IAsFN;;OAEG;IACH,MAAM,KAAK,WAAW,WAErB;IAED;;OAEG;IACH,MAAM,KAAK,aAAa,WAEvB;IAED,MAAM,CAAC,MAAM,MAAU;CACxB;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"add-select-row.d.ts","sourceRoot":"","sources":["../../../src/components/add-select/add-select-row.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAIhD,OAAO,wDAAwD,CAAC;AAChE,OAAO,4DAA4D,CAAC;AACpE,OAAO,6DAA6D,CAAC;AACrE,OAAO,6DAA6D,CAAC;AACrE,OAAO,2DAA2D,CAAC;AAUnE;;;;;;;;;GASG;AACH,cACM,eAAgB,SAAQ,UAAU;IACtC;;;;OAIG;IAEH,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO,KAAK,MAAM,GAMjB;IAED;;OAEG;IAEH,MAAM,SAAM;IAEZ;;OAEG;IAEH,KAAK,SAAM;IAEX;;OAEG;IAEH,QAAQ,SAAM;IAEd;;OAEG;IAEH,KAAK,SAAM;IAEX;;OAEG;IAEH,QAAQ,UAAS;IAEjB;;OAEG;IAEH,aAAa,UAAS;IAEtB;;OAEG;IAEH,QAAQ,UAAS;IAEjB;;OAEG;IAEH,QAAQ,UAAS;IAEjB,iDAAiD;IAEjD,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO,CAAC,qBAAqB;IAK7B,uDAAuD;IAEvD,OAAO,CAAC,kBAAkB,CAAS;IAEnC,OAAO,CAAC,2BAA2B;IAMnC;;OAEG;IAEH,YAAY,UAAS;IAErB;;OAEG;IAEH,aAAa,UAAS;IAEtB;;OAEG;IAEH,wBAAwB,SAAkB;IAE1C;;OAEG;IAEH,WAAW,UAAS;IAEpB;;OAEG;IAEH,QAAQ,SAAM;IAEd;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmB3B,MAAM;IA4JN;;OAEG;IACH,MAAM,KAAK,WAAW,WAErB;IAED;;OAEG;IACH,MAAM,KAAK,aAAa,WAEvB;IAED;;OAEG;IACH,MAAM,KAAK,mBAAmB,WAE7B;IAED,MAAM,CAAC,MAAM,MAAU;CACxB;AAED,eAAe,eAAe,CAAC"}

package/lib/components/add-select/add-select-selection-summary-item.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @license
+ *
+ * Copyright IBM Corp. 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 { LitElement } from 'lit';
+import '@carbon/web-components/es/components/icon-button/index.js';
+import type { AddSelectItem } from '@carbon/ibm-products-utilities';
+/**
+ * Add Select Selection Summary Item — individual selected item display.
+ * @element c4p-add-select-selection-summary-item
+ * @slot default - Highest priority: replaces all rendering when populated
+ * @slot render-item - Custom full-row renderer; replaces title/subtitle/body but keeps remove button (second priority after default slot)
+ * @slot accordion-title - Custom accordion title (used when use-accordion is true)
+ * @slot accordion-body - Custom accordion body (used when use-accordion is true)
+ * @fires c4p-add-select-selection-summary-item-remove - Fired when remove button clicked; detail: { itemId }
+ */
+declare class CDSAddSelectSelectionSummaryItem extends LitElement {
+    /**
+     * Item data (set via JS property)
+     */
+    item: AddSelectItem | null;
+    /**
+     * Use accordion pattern for display
+     */
+    useAccordion: boolean;
+    /**
+     * Accessible label for the remove button
+     */
+    removeButtonLabel: string;
+    /**
+     * When true, the remove button is not rendered
+     */
+    hideRemoveButton: boolean;
+    /** Whether the default slot has assigned elements */
+    private _hasDefaultSlot;
+    /** Whether the render-item slot has assigned elements */
+    private _hasRenderItemSlot;
+    /** Whether the accordion-title slot has assigned elements */
+    private _hasAccordionTitleSlot;
+    /** Whether the accordion-body slot has assigned elements */
+    private _hasAccordionBodySlot;
+    /** Whether the custom accordion is open */
+    private _accordionOpen;
+    private _handleDefaultSlotChange;
+    private _handleAccordionTitleSlotChange;
+    private _handleAccordionBodySlotChange;
+    private _handleRenderItemSlotChange;
+    private _handleRemove;
+    private _renderDefaultItemDetails;
+    private _renderRemoveButton;
+    render(): import("lit-html").TemplateResult<1>;
+    /**
+     * The name of the custom event fired when the remove button is clicked.
+     * detail: { itemId: string }
+     */
+    static get eventRemove(): string;
+    static styles: any;
+}
+export default CDSAddSelectSelectionSummaryItem;
+//# sourceMappingURL=add-select-selection-summary-item.d.ts.map

package/lib/components/add-select/add-select-selection-summary-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-select-selection-summary-item.d.ts","sourceRoot":"","sources":["../../../src/components/add-select/add-select-selection-summary-item.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAIhD,OAAO,2DAA2D,CAAC;AAKnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAKpE;;;;;;;;GAQG;AACH,cACM,gCAAiC,SAAQ,UAAU;IACvD;;OAEG;IAEH,IAAI,EAAE,aAAa,GAAG,IAAI,CAAQ;IAElC;;OAEG;IAEH,YAAY,UAAS;IAErB;;OAEG;IAEH,iBAAiB,SAAiB;IAElC;;OAEG;IAEH,gBAAgB,UAAS;IAEzB,qDAAqD;IAErD,OAAO,CAAC,eAAe,CAAS;IAEhC,yDAAyD;IAEzD,OAAO,CAAC,kBAAkB,CAAS;IAEnC,6DAA6D;IAE7D,OAAO,CAAC,sBAAsB,CAAS;IAEvC,4DAA4D;IAE5D,OAAO,CAAC,qBAAqB,CAAS;IAEtC,2CAA2C;IAE3C,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,wBAAwB;IAKhC,OAAO,CAAC,+BAA+B;IAMvC,OAAO,CAAC,8BAA8B;IAMtC,OAAO,CAAC,2BAA2B;IAMnC,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,yBAAyB;IAsBjC,OAAO,CAAC,mBAAmB;IAyB3B,MAAM;IAuJN;;;OAGG;IACH,MAAM,KAAK,WAAW,WAErB;IAED,MAAM,CAAC,MAAM,MAAU;CACxB;AAED,eAAe,gCAAgC,CAAC"}

package/lib/components/add-select/add-select-selection-summary.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @license
+ *
+ * Copyright IBM Corp. 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 { LitElement } from 'lit';
+import '@carbon/web-components/es/components/tag/index.js';
+import '@carbon/web-components/es/components/icon-button/index.js';
+/**
+ * Add Select Selection Summary — displays the list of selected items.
+ * @element c4p-add-select-selection-summary
+ * @slot default - SelectionSummaryItem components or custom body content
+ * @slot header - Replaces the entire header section
+ * @slot header-actions - Custom actions alongside the edit icon
+ * @slot empty-state - Shown when selectedItemCount is 0 or not set
+ * @fires c4p-add-select-selection-summary-edit - Fired when edit icon is clicked
+ */
+declare class CDSAddSelectSelectionSummary extends LitElement {
+    /**
+     * Panel title
+     */
+    title: string;
+    /**
+     * Number of selected items — shown as a badge next to the title when provided.
+     * Badge is hidden when this is omitted/undefined.
+     */
+    selectedItemCount: number | undefined;
+    /**
+     * Show edit icon next to title
+     */
+    showEditIcon: boolean;
+    /**
+     * Accessible label for the edit icon button
+     */
+    editIconDescription: string;
+    private _handleEdit;
+    render(): import("lit-html").TemplateResult<1>;
+    /**
+     * The name of the custom event fired when the edit icon is clicked.
+     */
+    static get eventEdit(): string;
+    static styles: any;
+}
+export default CDSAddSelectSelectionSummary;
+//# sourceMappingURL=add-select-selection-summary.d.ts.map

package/lib/components/add-select/add-select-selection-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-select-selection-summary.d.ts","sourceRoot":"","sources":["../../../src/components/add-select/add-select-selection-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAGhD,OAAO,mDAAmD,CAAC;AAC3D,OAAO,2DAA2D,CAAC;AAQnE;;;;;;;;GAQG;AACH,cACM,4BAA6B,SAAQ,UAAU;IACnD;;OAEG;IAEH,KAAK,SAAoB;IAEzB;;;OAGG;IAEH,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAa;IAElD;;OAEG;IAEH,YAAY,UAAS;IAErB;;OAEG;IAEH,mBAAmB,SAAqB;IAExC,OAAO,CAAC,WAAW;IASnB,MAAM;IA+CN;;OAEG;IACH,MAAM,KAAK,SAAS,WAEnB;IAED,MAAM,CAAC,MAAM,MAAU;CACxB;AAED,eAAe,4BAA4B,CAAC"}

package/lib/components/add-select/index.d.ts

@@ -8,6 +8,9 @@
  */
 import './add-select';
 import './add-select-body';
+import './add-select-column';
 import './add-select-row';
-import './add-select-content';
+import './add-select-selection-summary';
+import './add-select-selection-summary-item';
+import './add-select-item-panel';
 //# sourceMappingURL=index.d.ts.map

package/lib/components/add-select/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/add-select/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,cAAc,CAAC;AACtB,OAAO,mBAAmB,CAAC;AAC3B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/add-select/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,cAAc,CAAC;AACtB,OAAO,mBAAmB,CAAC;AAC3B,OAAO,qBAAqB,CAAC;AAC7B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,gCAAgC,CAAC;AACxC,OAAO,qCAAqC,CAAC;AAC7C,OAAO,yBAAyB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/ibm-products-web-components",
   "description": "Carbon for IBM Products Web Components",
-  "version": "0.45.0",
+  "version": "0.46.0",
   "license": "Apache-2.0",
   "main": "es/index.js",
   "module": "es/index.js",
@@ -25,6 +25,7 @@
     "provenance": true
   },
   "exports": {
+    ".": "./es/index.js",
     "./es/*": "./es/*",
     "./es-custom/*": "./es-custom/*",
     "./lib/*": "./lib/*",
@@ -58,7 +59,7 @@
   "dependencies": {
     "@carbon-labs/wc-empty-state": "^0.22.0",
     "@carbon-labs/wc-resizer": "^0.3.0",
-    "@carbon/ibm-products-styles": "^2.92.0",
+    "@carbon/ibm-products-styles": "^2.93.0",
     "@carbon/layout": "^11.54.0",
     "@carbon/styles": "^1.110.1",
     "@carbon/utilities": "^0.21.0",
@@ -71,14 +72,14 @@
   "devDependencies": {
     "@aarsteinmedia/dotlottie-player": "^6.0.5",
     "@blockquote/rollup-plugin-externalize-source-dependencies": "^1.0.0",
-    "@carbon/ibm-products-utilities": "1.5.0",
+    "@carbon/ibm-products-utilities": "1.6.0",
     "@carbon/icon-helpers": "^10.77.0",
     "@carbon/icons": "^11.83.0",
     "@carbon/motion": "^11.47.0",
     "@figma/code-connect": "^1.4.0",
     "@ibm/telemetry-js-config-generator": "^2.1.0",
     "@mordech/vite-lit-loader": "^0.40.0",
-    "@open-wc/testing": "^4.0.0",
+    "@open-wc/testing": "^5.0.0",
     "@stackblitz/sdk": "^1.11.0",
     "@storybook/addon-a11y": "^10.3.5",
     "@storybook/addon-docs": "^10.3.5",
@@ -88,7 +89,7 @@
     "@vitest/browser": "^3.2.0",
     "@vitest/coverage-v8": "^3.2.0",
     "autoprefixer": "^10.4.20",
-    "c8": "^11.0.0",
+    "c8": "^12.0.0",
     "cssnano": "^7.0.6",
     "eslint": "^9.14.0",
     "eslint-config-carbon": "^3.25.0",
@@ -109,5 +110,5 @@
     "vitest": "^3.2.0",
     "web-component-analyzer": "2.0.0"
   },
-  "gitHead": "452f9b6ddfcc5e76fc88cc005bfc5455944872cb"
+  "gitHead": "91d179a76c469fdcccc0c3a60900146b452e4055"
 }