@ixfx/components 0.13.6 → 0.13.8

package/bundle/index.d.ts

@@ -2664,6 +2664,14 @@ type TreeDropEvent = CustomEvent<TreeDropDetail>;
 type TreeDragEndEvent = CustomEvent<{
   dropped: boolean;
 }>;
+/** How `navigateTo` scrolls its target: edge-align it, or centre it when it is off screen. */
+type TreeRevealMode = `edge` | `center-if-hidden`;
+type TreeNavigateOptions = {
+  /** Scroll behaviour for the target (default `edge`). */
+  reveal?: TreeRevealMode;
+  /** Suppress the `select` event this navigation would otherwise fire. */
+  silent?: boolean;
+};
 /**
  * Fired when the selection set changes by any means (click, keyboard, programmatic).
  * Event name: `select`
@@ -7999,14 +8007,6 @@ interface GroupedItemListerElement<T> {
  * rows; `on` / `off` force it.
  */
 type TreeVirtualize = `auto` | `on` | `off`;
-/** How `navigateTo` scrolls its target: edge-align it, or centre it when it is off screen. */
-type TreeRevealMode = `edge` | `center-if-hidden`;
-type TreeNavigateOptions = {
-  /** Scroll behaviour for the target row (default `edge`). */
-  reveal?: TreeRevealMode;
-  /** Suppress the `select` event this navigation would otherwise fire. */
-  silent?: boolean;
-};
 declare class TreeBaseElement extends LitElement implements TreeComponent, TreeSearchHost {
   #private;
   root: TreeNode | undefined;
@@ -8112,6 +8112,24 @@ declare class TreeBaseElement extends LitElement implements TreeComponent, TreeS
   clearSelection(): void;
   selectAll(): void;
   deselectAll(): void;
+  /**
+   * Expand every already-loaded branch in a single update. With `maxDepth`,
+   * only branches at depth < `maxDepth` are expanded (the root's children are
+   * depth 0), so rows at depth `maxDepth` become visible but stay collapsed.
+   *
+   * Unloaded (lazy) branches are not fetched — call again once their children
+   * have loaded to expand further. Bulk expansion ignores `exclusivity`. Fires
+   * one `expand` event per branch that actually opens — none for branches that
+   * were already expanded, including ones opened by filter auto-expansion.
+   */
+  expandAll(maxDepth?: number): void;
+  /**
+   * Collapse expanded branches in a single update. With `maxDepth`, only
+   * branches at depth >= `maxDepth` are collapsed, leaving the tree open down
+   * to depth `maxDepth - 1` (`collapseAll(0)` is a full collapse). Fires one
+   * `collapse` event per branch that actually closes.
+   */
+  collapseAll(maxDepth?: number): void;
   navigateTo(keys: readonly string[], options?: TreeNavigateOptions): boolean;
   navigateToNode(predicate: (node: TreeNode) => boolean): boolean;
   /** Expand ancestors + move the cursor to `key`, without touching the selection (search "navigate" mode). */
@@ -9884,7 +9902,13 @@ declare class MillerBaseElement extends LitElement implements TreeComponent, Tre
    * Programmatically navigate to a node by key path, relative to the current
    * view root (rebased or full tree).
    */
-  navigateTo(keys: readonly string[]): boolean;
+  navigateTo(keys: readonly string[], options?: TreeNavigateOptions): boolean;
+  /**
+   * Re-sync the element with children arrays patched in place (see
+   * `MillerTreeController.sync()`): columns whose selected node was removed are
+   * closed, selection entries for removed nodes are dropped, then it re-renders.
+   */
+  invalidateStructure(): void;
   /**
    * Programmatically navigate to the first node (breadth-first) matching a predicate.
    */
@@ -10018,6 +10042,11 @@ type MillerTreeControllerOptions<T> = {
    * `TraversableTree` node has any children.
    */
   valueToItem: (value: T, node: TraversableTree<T>) => TreeItem;
+  /**
+   * Children loader installed on the element by `connect()`. Defaults to a
+   * synchronous read from the source tree. `sync()` never touches it.
+   */
+  loadChildren?: LoadChildrenCallback;
 };
 /**
  * Bridges an `ixfx` `TraversableTree<T>` with an `ixfx-miller-*` component.
@@ -10065,7 +10094,28 @@ declare class MillerTreeController<T> {
    *
    * Returns `false` if no matching node is found.
    */
-  navigateToValue(predicate: (value: T) => boolean): boolean;
+  navigateToValue(predicate: (value: T) => boolean, options?: TreeNavigateOptions): boolean;
+  /**
+   * Navigate using item keys **relative to the element's current view root**
+   * (the real root when not rebased). Ancestors with unloaded children are
+   * populated first. Returns `false` if a key is missing.
+   */
+  navigateToKeyPath(keys: readonly string[], options?: TreeNavigateOptions): boolean;
+  /**
+   * Navigate to the source node with this identity. Returns `false` when it is
+   * unknown or lies outside a rebased view (keys are relative to the view root).
+   */
+  navigateToIdentity(identity: unknown, options?: TreeNavigateOptions): boolean;
+  /** The source node whose item key is `key`, if it has been materialised. */
+  lookupByKey(key: string): TraversableTree<T> | undefined;
+  /**
+   * Re-derive children for every already-materialised node from the source tree
+   * and patch them in place. Children arrays are mutated (not replaced) so open
+   * columns keep their references, and `MillerNode`s are reused by key so
+   * selection survives. A rebased `viewRoot` is reset only if its node was
+   * removed. `loadChildren` is left alone. Refreshes the element once.
+   */
+  sync(): void;
 }
 //#endregion
 //#region src/multicol-list/types.d.ts
@@ -10085,6 +10135,8 @@ type MulticolCategoryDefaults = {
 type MulticolCategory = {
   readonly key: string;
   readonly label: string;
+  /** Shown as a tooltip on the column header label. */
+  readonly description?: string;
   readonly children?: readonly MulticolCategory[];
   readonly defaults?: MulticolCategoryDefaults;
 };
@@ -10162,6 +10214,8 @@ declare class MulticolListElement extends LitElement {
   protected updated(changedProperties: Map<string, unknown>): void;
   private _renderColumn;
   private _getCategoryLabel;
+  /** Category description if present, else the default 'Change category' hint. */
+  private _getCategoryTooltip;
   private _onHeaderPointerDown;
   private _onResizePointerDown;
   private _openCategoryPicker;