@ixfx/components 0.17.0 → 0.17.1

package/bundle/index.d.ts

@@ -9473,6 +9473,17 @@ type GridListDataAdapter<T> = {
    */
   badge?: (item: T, index: number) => unknown;
 };
+/**
+ * One entry of a batched item update — see `GridListElement.updateItems`.
+ *
+ * @typeParam T The type of data item.
+ */
+type GridListItemUpdate<T> = {
+  /** Key of the item to replace. Unknown keys are ignored. */
+  readonly key: string;
+  /** The new value for that item. */
+  readonly item: T;
+};
 /**
  * Common detail for per-item events (activate, click, tickle), key-first in
  * BOTH element and data modes. `item` is the backward-compat field — Element in
@@ -9810,8 +9821,47 @@ export declare class GridListElement<T = unknown> extends LitElement {
    * place (the keyed subtree is kept); an offscreen item shows its new content
    * when scrolled into view. Scroll and selection are untouched. Unknown keys
    * are ignored.
+   *
+   * Passing the **same object** that is already at `key` is a no-op: the
+   * `items` array is left untouched (same identity) and nothing is emitted.
+   * Use {@link refreshItem} to re-render a cell without changing the data.
+   *
+   * Updating many items one by one? Use {@link updateItems} — it applies them
+   * with a single array copy and a single rebuild.
    */
   updateItem(key: string, item: T): void;
+  /**
+   * Data mode: replace several items at once — the batched form of
+   * {@link updateItem}.
+   *
+   * `entries` is an array of `{ key, item }` pairs (a `Map<key, item>` is
+   * accepted too). All the replacements are applied with **one** array copy
+   * and **one** source rebuild, so a host that must refresh n rows does not
+   * pay n copies and n scans.
+   *
+   * Semantics match n sequential {@link updateItem} calls:
+   * - unknown keys are ignored;
+   * - an entry whose `item` is the identical object already at that key is
+   *   skipped (it cannot change anything);
+   * - selection, cursor and scroll are untouched;
+   * - if no entry changes anything, `items` is left untouched (same identity)
+   *   and nothing is emitted.
+   */
+  updateItems(entries: Iterable<GridListItemUpdate<T>> | ReadonlyMap<string, T>): void;
+  /**
+   * Data mode: re-render the cell for `key` without touching `items`.
+   *
+   * Use this when the *data* is unchanged but the cell should be redrawn — for
+   * example after mutating something the adapter reads from outside the item
+   * (a thumbnail's load state). The `items` array keeps its identity, so the
+   * collection is not copied and no source rebuild is triggered.
+   *
+   * The adapter's `render` is called again for that cell on the next render,
+   * so the cell picks up the new state. Other cells are left alone.
+   *
+   * Unknown keys are ignored. A no-op in element mode.
+   */
+  refreshItem(key: string): void;
   /**
    * Data mode: remove the items carrying these keys. Removed keys leave the
    * selection and cursor silently (via the `items` change) and are held as
@@ -17014,4 +17064,4 @@ export interface XyPad {
   addEventListener: (<K extends keyof XyPadEventMap>(type: K, listener: (this: XyPad, event: XyPadEventMap[K]) => void, options?: boolean | AddEventListenerOptions) => void) & ((type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions) => void);
 }
 export declare function init(): void;
-export { type AcTokenAddDetail, type AcTokenAddEvent, type AcTokenElementEventMap, type AcTokenItem, type AcTokenRemoveDetail, type AcTokenRemoveEvent, type AcTokenStyle, type AcTokenStyleFn, type AcTokenizerFn, type AcTokensChangeDetail, type AcTokensChangeEvent, type AddedNode, type BridgeDeps, type BridgeResult, type BuiltInFormatterName, type BuiltInFormatterOptions, type CheckState, type CheckedSelectItem, type ColourPickerChangeEvent, type ColourPickerEventDetail, type ColourPickerInputEvent, type ComputeHyperbolicLayoutOptions, type ComputeTreemapLayoutOptions, type ContextKind, type ContextTarget, type CrumbNavigationViewState, type CssVars, type DataGridColumn, type DataGridColumnMenu, type DataGridColumnViewState, type DataGridDataType, type DataGridEditability, type DataGridEditorContext, type DataGridEditorFactory, type DataGridEditorType, type DataGridGetRowKey, type DataGridGroupBy, type DataGridGroupLabel, type DataGridInteractionMode, type DataGridRowLook, type DataGridSelectionMode, type DataGridSortDirection, type DataGridSortState, type DataGridViewState, type DataListSearchAdapterOptions, type DataListSearchItem, type DetailFormatter, type DetailGroupBy, type DetailListViewState, type DetailSortComparator, type DetailSortItem, type DetailSortMode, type DockDropZone, type DragSelectRect, type DraggableNode, type ElementIncrSearch, type ElementIncrSearchOptions, type ElementListSearchAdapterOptions, type ElementListSearchHost, type FlatListActivateDetail, type FlatListActivateEvent, type FlatListBranchOrder, type FlatListContextMenuDetail, type FlatListContextMenuEvent, type FlatListDropDetail, type FlatListDropEvent, type FlatListEditCancelDetail, type FlatListEditCancelEvent, type FlatListEditCommitDetail, type FlatListEditCommitEvent, type FlatListElementEventMap, type FlatListNavigateDetail, type FlatListNavigateEvent, type FlatListSelectDetail, type FlatListSelectEvent, type FlatListViewState, type FuzzySearch, type FuzzySearchOptions, type GlobalFormatter, type GridListActivateDetail, type GridListActivateEvent, type GridListCaptionAlign, type GridListCaptionBackdrop, type GridListCaptionPosition, type GridListCaptionStyle, type GridListDataAdapter, type GridListElementEventMap, type GridListFullElementEventMap, type GridListItemClickDetail, type GridListItemClickEvent, type GridListItemEventDetail, type GridListOrientation, type GridListSelectDetail, type GridListSelectEvent, type GridListTickleDetail, type GridListTickleEvent, type GridListViewState, type GridListViewportChangeDetail, type GridListViewportChangeEvent, type GroupedItemListerElementEventMap, type GroupedSelectDetail, type GroupedSelectEvent, type HighlightOptions, type HighlightTarget, type HyperbolicEdgeRenderContext, type HyperbolicEdgeRenderer, type HyperbolicFocusDetail, type HyperbolicFocusEvent, type HyperbolicInteractionMode, type HyperbolicLayoutEdge, type HyperbolicLayoutNode, type HyperbolicNodeShape, type Point as HyperbolicPoint, type HyperbolicTreeListViewState, type IGroupedSubComponent, type IGroupedSubComponentEventMap, type IcicleViewState, type IconChangedDetail, type IconChangedEvent, type IconEntry, type IncrSearch, type IncrSearchChangeCallback, IncrSearchTreeController as IncrSearchMillerController, type IncrSearchTreeOptions as IncrSearchMillerOptions, type IncrSearchTreeOptions, type IncrSearchOptions, type IncrSearchResult, type IncrSearchState, type InputMode, type ItemDisplay, type ItemOrientation, type ListActivateDetail, type ListActivateEvent, type ListContextMenuDetail, type ListContextMenuEvent, type ListDragEntry, type ListDragLeaveDetail, type ListDragLeaveEvent, type ListDragOverEvent, type ListDragPreview, type ListDragPreviewContext, type ListDragPreviewRenderer, type ListDragPreviewSourceResolver, type ListDragSelectControllerConfig, type ListDragSource, type ListDropDetail, type ListDropEvent, type ListEditCancelDetail, type ListEditCancelEvent, type ListEditCommitDetail, type ListEditCommitEvent, type ListElementEventMap, type ListGroupBy, type ListGroupChangeDetail, type ListGroupChangeEvent, type ListGroupEventMap, type ListGroupInfo, type ListGroupLabel, type ListGroupPartition, type ListGroupToggleDetail, type ListGroupToggleEvent, type ListInteractionMode, type ListItemClickDetail, type ListItemClickEvent, type ListItemMotionOptions, type ListItemOutResult, type ListMarqueeMode, type ListNativeDragControllerConfig, type ListNativeDragStartDetail, type ListNativeDragStartEvent, type ListSearchAdapter, type ListSearchControllerOptions, type ListSearchHost, type ListSearchMode, type ListSelectDetail, type ListSelectEvent, type ListSelectIntentDetail, type ListSelectIntentEvent, type ListSelectIntentKind, type ListSelectIntentSource, type ListSelectKeysDetail, type ListSelectionControllerConfig, type ListSelectionGesture, type ListSelectionMode, type ListSelectionModes, type ListTickleDetail, type ListTickleEvent, type ListViewportChangeDetail, type ListViewportChangeEvent, type MarqueeConfig, index_d_exports as Menu, type TreeActivateDetail as MillerActivateDetail, type TreeActivateEvent as MillerActivateEvent, type TreeCollapseDetail as MillerCollapseDetail, type TreeCollapseEvent as MillerCollapseEvent, type TreeExpandDetail as MillerExpandDetail, type TreeExpandEvent as MillerExpandEvent, type TreeItem as MillerItem, type TreeItemClickDetail as MillerItemClickDetail, type TreeItemClickEvent as MillerItemClickEvent, type MillerListViewState, type TreeNode as MillerNode, type TreeSelectDetail as MillerSelectDetail, type TreeSelectEvent as MillerSelectEvent, type TreeTickleDetail as MillerTickleDetail, type TreeTickleEvent as MillerTickleEvent, type MulticolCategory, type MulticolColumnState, type MulticolColumnsChangeReason, type MulticolItem, type MulticolListViewState, type MulticolQuery, type MulticolSelectDetail, type NodeDragConfig, type NodeFactory, type NodeFactoryContext, type OklchValue, type OpenableMenu, type PanZoomConfig, Point$1 as Point, type ProximityPair, type ProximityQuery, type Rect, type RegisterListSearchCommandsOptions, type ScrollHoverGuard, type ScrollHoverGuardConfig, type SortDirection, type SubComponentActivateDetail, type SubComponentActivateEvent, type SubComponentFactory, type SubComponentItemClickDetail, type SubComponentItemClickEvent, type SubComponentSelectDetail, type SubComponentSelectEvent, type SubComponentTickleDetail, type SubComponentTickleEvent, type SunburstViewState, type TickledControllerConfig, type TickledItem, type TreeCheckboxState, type TreeKeyboardNavCallbacks, type TreeKeyboardNavControllerConfig, type TreeKeyboardNavItemId, type TreeListSearchAdapterOptions, type TreeListViewState, type TreemapInteractionMode, type TreemapListViewState, type TreemapRect, type TreemapTilingMethod, type TreemapValueAccessor, type VerticalListViewState, type WheelMode, type WireDragConfig, type WireDragMode, type WireDragPort, type WirePath };
+export { type AcTokenAddDetail, type AcTokenAddEvent, type AcTokenElementEventMap, type AcTokenItem, type AcTokenRemoveDetail, type AcTokenRemoveEvent, type AcTokenStyle, type AcTokenStyleFn, type AcTokenizerFn, type AcTokensChangeDetail, type AcTokensChangeEvent, type AddedNode, type BridgeDeps, type BridgeResult, type BuiltInFormatterName, type BuiltInFormatterOptions, type CheckState, type CheckedSelectItem, type ColourPickerChangeEvent, type ColourPickerEventDetail, type ColourPickerInputEvent, type ComputeHyperbolicLayoutOptions, type ComputeTreemapLayoutOptions, type ContextKind, type ContextTarget, type CrumbNavigationViewState, type CssVars, type DataGridColumn, type DataGridColumnMenu, type DataGridColumnViewState, type DataGridDataType, type DataGridEditability, type DataGridEditorContext, type DataGridEditorFactory, type DataGridEditorType, type DataGridGetRowKey, type DataGridGroupBy, type DataGridGroupLabel, type DataGridInteractionMode, type DataGridRowLook, type DataGridSelectionMode, type DataGridSortDirection, type DataGridSortState, type DataGridViewState, type DataListSearchAdapterOptions, type DataListSearchItem, type DetailFormatter, type DetailGroupBy, type DetailListViewState, type DetailSortComparator, type DetailSortItem, type DetailSortMode, type DockDropZone, type DragSelectRect, type DraggableNode, type ElementIncrSearch, type ElementIncrSearchOptions, type ElementListSearchAdapterOptions, type ElementListSearchHost, type FlatListActivateDetail, type FlatListActivateEvent, type FlatListBranchOrder, type FlatListContextMenuDetail, type FlatListContextMenuEvent, type FlatListDropDetail, type FlatListDropEvent, type FlatListEditCancelDetail, type FlatListEditCancelEvent, type FlatListEditCommitDetail, type FlatListEditCommitEvent, type FlatListElementEventMap, type FlatListNavigateDetail, type FlatListNavigateEvent, type FlatListSelectDetail, type FlatListSelectEvent, type FlatListViewState, type FuzzySearch, type FuzzySearchOptions, type GlobalFormatter, type GridListActivateDetail, type GridListActivateEvent, type GridListCaptionAlign, type GridListCaptionBackdrop, type GridListCaptionPosition, type GridListCaptionStyle, type GridListDataAdapter, type GridListElementEventMap, type GridListFullElementEventMap, type GridListItemClickDetail, type GridListItemClickEvent, type GridListItemEventDetail, type GridListItemUpdate, type GridListOrientation, type GridListSelectDetail, type GridListSelectEvent, type GridListTickleDetail, type GridListTickleEvent, type GridListViewState, type GridListViewportChangeDetail, type GridListViewportChangeEvent, type GroupedItemListerElementEventMap, type GroupedSelectDetail, type GroupedSelectEvent, type HighlightOptions, type HighlightTarget, type HyperbolicEdgeRenderContext, type HyperbolicEdgeRenderer, type HyperbolicFocusDetail, type HyperbolicFocusEvent, type HyperbolicInteractionMode, type HyperbolicLayoutEdge, type HyperbolicLayoutNode, type HyperbolicNodeShape, type Point as HyperbolicPoint, type HyperbolicTreeListViewState, type IGroupedSubComponent, type IGroupedSubComponentEventMap, type IcicleViewState, type IconChangedDetail, type IconChangedEvent, type IconEntry, type IncrSearch, type IncrSearchChangeCallback, IncrSearchTreeController as IncrSearchMillerController, type IncrSearchTreeOptions as IncrSearchMillerOptions, type IncrSearchTreeOptions, type IncrSearchOptions, type IncrSearchResult, type IncrSearchState, type InputMode, type ItemDisplay, type ItemOrientation, type ListActivateDetail, type ListActivateEvent, type ListContextMenuDetail, type ListContextMenuEvent, type ListDragEntry, type ListDragLeaveDetail, type ListDragLeaveEvent, type ListDragOverEvent, type ListDragPreview, type ListDragPreviewContext, type ListDragPreviewRenderer, type ListDragPreviewSourceResolver, type ListDragSelectControllerConfig, type ListDragSource, type ListDropDetail, type ListDropEvent, type ListEditCancelDetail, type ListEditCancelEvent, type ListEditCommitDetail, type ListEditCommitEvent, type ListElementEventMap, type ListGroupBy, type ListGroupChangeDetail, type ListGroupChangeEvent, type ListGroupEventMap, type ListGroupInfo, type ListGroupLabel, type ListGroupPartition, type ListGroupToggleDetail, type ListGroupToggleEvent, type ListInteractionMode, type ListItemClickDetail, type ListItemClickEvent, type ListItemMotionOptions, type ListItemOutResult, type ListMarqueeMode, type ListNativeDragControllerConfig, type ListNativeDragStartDetail, type ListNativeDragStartEvent, type ListSearchAdapter, type ListSearchControllerOptions, type ListSearchHost, type ListSearchMode, type ListSelectDetail, type ListSelectEvent, type ListSelectIntentDetail, type ListSelectIntentEvent, type ListSelectIntentKind, type ListSelectIntentSource, type ListSelectKeysDetail, type ListSelectionControllerConfig, type ListSelectionGesture, type ListSelectionMode, type ListSelectionModes, type ListTickleDetail, type ListTickleEvent, type ListViewportChangeDetail, type ListViewportChangeEvent, type MarqueeConfig, index_d_exports as Menu, type TreeActivateDetail as MillerActivateDetail, type TreeActivateEvent as MillerActivateEvent, type TreeCollapseDetail as MillerCollapseDetail, type TreeCollapseEvent as MillerCollapseEvent, type TreeExpandDetail as MillerExpandDetail, type TreeExpandEvent as MillerExpandEvent, type TreeItem as MillerItem, type TreeItemClickDetail as MillerItemClickDetail, type TreeItemClickEvent as MillerItemClickEvent, type MillerListViewState, type TreeNode as MillerNode, type TreeSelectDetail as MillerSelectDetail, type TreeSelectEvent as MillerSelectEvent, type TreeTickleDetail as MillerTickleDetail, type TreeTickleEvent as MillerTickleEvent, type MulticolCategory, type MulticolColumnState, type MulticolColumnsChangeReason, type MulticolItem, type MulticolListViewState, type MulticolQuery, type MulticolSelectDetail, type NodeDragConfig, type NodeFactory, type NodeFactoryContext, type OklchValue, type OpenableMenu, type PanZoomConfig, Point$1 as Point, type ProximityPair, type ProximityQuery, type Rect, type RegisterListSearchCommandsOptions, type ScrollHoverGuard, type ScrollHoverGuardConfig, type SortDirection, type SubComponentActivateDetail, type SubComponentActivateEvent, type SubComponentFactory, type SubComponentItemClickDetail, type SubComponentItemClickEvent, type SubComponentSelectDetail, type SubComponentSelectEvent, type SubComponentTickleDetail, type SubComponentTickleEvent, type SunburstViewState, type TickledControllerConfig, type TickledItem, type TreeCheckboxState, type TreeKeyboardNavCallbacks, type TreeKeyboardNavControllerConfig, type TreeKeyboardNavItemId, type TreeListSearchAdapterOptions, type TreeListViewState, type TreemapInteractionMode, type TreemapListViewState, type TreemapRect, type TreemapTilingMethod, type TreemapValueAccessor, type VerticalListViewState, type WheelMode, type WireDragConfig, type WireDragMode, type WireDragPort, type WirePath };