@ixfx/components 0.7.3 → 0.7.5

package/dist/miller.d.ts

@@ -1,7 +1,9 @@
 import { a as TreeItem, n as TreeExclusivity, o as TreeNode, r as TreeFilterPredicate, s as TreeSelectionFilter, t as LoadChildrenCallback } from "./types-Bc23SI94.js";
-import { a as TreeComponent, c as TreeExpandEvent, d as TreeSearchHost, f as TreeSelectDetail, g as TreeDataModel, h as TreeTickleEvent, i as TreeCollapseEvent, l as TreeItemClickDetail, m as TreeTickleDetail, n as TreeActivateEvent, o as TreeComponentEventMap, p as TreeSelectEvent, r as TreeCollapseDetail, s as TreeExpandDetail, t as TreeActivateDetail, u as TreeItemClickEvent } from "./tree-component-BvV4muxx.js";
-import { n as TickledController } from "./tickled-controller-Ds1DMyG7.js";
+import { a as TreeComponent, c as TreeExpandEvent, d as TreeSearchHost, f as TreeSelectDetail, g as TreeDataModel, h as TreeTickleEvent, i as TreeCollapseEvent, l as TreeItemClickDetail, m as TreeTickleDetail, n as TreeActivateEvent, o as TreeComponentEventMap, p as TreeSelectEvent, r as TreeCollapseDetail, s as TreeExpandDetail, t as TreeActivateDetail, u as TreeItemClickEvent } from "./tree-component-F6qZ0Gdv.js";
+import { y as ListSearchController } from "./index-CBS4z1v-.js";
+import { n as TickledController } from "./tickled-controller-Bn3YdQsM.js";
 import { LitElement, PropertyValues, TemplateResult, nothing } from "lit";
+import { CommandRegistry } from "@clinth/ui-commands";
 import { TraversableTree } from "@ixfx/collections";
 //#region src/miller/types.d.ts
 type MillerSelectionMode = `implicit` | `standard` | `manual` | `checked` | `vscode`;
@@ -28,6 +30,16 @@ type MillerItemDblClickDetail = {
   node: TreeNode;
   depth: number;
 };
+/** Detail for the `rebase` event fired when the view root changes. */
+type MillerRebaseDetail = {
+  /** The new view root, or `undefined` when the view was restored to the full tree. */
+  viewRoot: TreeNode | undefined;
+  /**
+   * Ancestry chain from the true root down to and including the new view root.
+   * Empty when the view shows the full tree.
+   */
+  path: Array<TreeNode>;
+};
 /** Detail for the `item-rightclick` event. */
 type MillerItemRightClickDetail = {
   node: TreeNode;
@@ -45,6 +57,7 @@ type MillerHeaderClickEvent = CustomEvent<MillerHeaderClickDetail>;
 type MillerItemDblClickEvent = CustomEvent<MillerItemDblClickDetail>;
 type MillerItemRightClickEvent = CustomEvent<MillerItemRightClickDetail>;
 type MillerHeaderRightClickEvent = CustomEvent<MillerHeaderRightClickDetail>;
+type MillerRebaseEvent = CustomEvent<MillerRebaseDetail>;
 /**
  * A snapshot of all display states for a single item in the miller columns.
  *
@@ -108,6 +121,29 @@ declare class MillerBaseElement extends LitElement implements TreeComponent, Tre
   root: TreeNode | undefined;
   model: TreeDataModel | undefined;
   headers: boolean;
+  /**
+   * When true, the last (rightmost) column grows to fill any remaining
+   * horizontal space in the host. All other columns size to their content
+   * (`max-content`), unless the user has manually resized them.
+   *
+   * When the user clicks into an item in the stretched column and a new
+   * column opens, the previously-last column automatically transitions back
+   * to its content-based width and the new last column stretches instead.
+   * Explicit user-resized widths (via the resize handle) always win over
+   * stretching.
+   */
+  stretchLastColumn: boolean;
+  /**
+   * Alternative node to use as the display root (Finder-style column-view
+   * rebase). When set, column 0 shows this node's children and all depths,
+   * headers, and key paths are relative to it. When `undefined` (default),
+   * the full `root` tree is shown.
+   *
+   * Prefer `rebaseTo()` / `rebaseUp()` over assigning this directly — they
+   * validate the target and report whether the view changed. Assigning a new
+   * `root` (or receiving one via `model`) silently clears the view root.
+   */
+  viewRoot: TreeNode | undefined;
   /**
    * Controls the column-level interaction pattern (how clicks map to column changes).
    * This is distinct from `selectionFilter` (which restricts which node kinds are selectable).
@@ -123,13 +159,27 @@ declare class MillerBaseElement extends LitElement implements TreeComponent, Tre
    */
   loadChildren: LoadChildrenCallback | undefined;
   filterPredicate: TreeFilterPredicate | undefined;
+  /**
+   * Space-separated subset of `navigate select filter` — limits which
+   * incremental-search modes are offered. Unset ⇒ all three; empty ⇒ search
+   * disabled. See `docs/infra-incremental.md`.
+   */
+  searchModes: string | undefined;
   protected _columns: TreeNode[][];
   protected _loadingDepth: number | undefined;
   protected _selectedByDepth: Map<number, TreeNode>;
   protected _selectedKeys: Set<string>;
   protected _selectedNodes: Set<TreeNode>;
+  /** Incremental search (navigate / select / filter). See `docs/infra-incremental.md`. */
+  readonly search: ListSearchController<{
+    node: TreeNode;
+    depth: number;
+  }>;
+  /** Command registry carrying this component's `list.search.*` commands. */
+  get registry(): CommandRegistry<unknown> | undefined;
   tickled: TickledController<string>;
   updated(changedProps: PropertyValues): void;
+  connectedCallback(): void;
   disconnectedCallback(): void;
   getConfig(): MillerConfig;
   setConfig(config: MillerConfig): void;
@@ -165,17 +215,41 @@ declare class MillerBaseElement extends LitElement implements TreeComponent, Tre
    */
   getSelected(): TreeNode[];
   /**
-   * Programmatically navigate to a node by key path.
+   * Programmatically navigate to a node by key path, relative to the current
+   * view root (rebased or full tree).
    */
   navigateTo(keys: readonly string[]): boolean;
   /**
    * Programmatically navigate to the first node (breadth-first) matching a predicate.
    */
   navigateToNode(predicate: (node: TreeNode) => boolean): boolean;
+  /** Open the columns down to `key` and move the cursor to it, without changing the selection (search "navigate" mode). */
+  revealKey(key: string): boolean;
+  /** Replace the selection with `nodes` (search "select" mode). */
+  selectMany(nodes: Iterable<TreeNode>): void;
   getNodes(): ReadonlyArray<{
     node: TreeNode;
     depth: number;
   }>;
+  /**
+   * Rebase the view to show `target`'s children in column 0 (Finder column-view
+   * behavior on double-click), keeping the full tree in `root`.
+   *
+   * - Pass a `MillerNode` (used as-is) or a key (looked up in the full tree).
+   * - Pass `undefined` to restore the full-tree view.
+   * - Rebasing to the true root is equivalent to restoring the full view.
+   * - Leaves are refused (returns `false`).
+   *
+   * Selection is cleared; all depths, headers, and key paths are relative to
+   * the new view root. Fires a `rebase` event when the view actually changes.
+   * Returns `false` when nothing changed (unknown key, leaf, or same view).
+   */
+  rebaseTo(target: TreeNode | string | undefined): boolean;
+  /**
+   * Rebase one level up from the current view root (no-op at the full tree).
+   * Fires a `rebase` event when the view actually changes.
+   */
+  rebaseUp(): boolean;
   protected renderColumnContent(nodes: TreeNode[], depth: number): TemplateResult | typeof nothing;
   protected _handleItemClick(node: TreeNode, depth: number, event?: MouseEvent): void;
   /**
@@ -234,6 +308,7 @@ interface MillerBaseElementEventMap extends TreeComponentEventMap {
   'item-rightclick': CustomEvent<MillerItemRightClickDetail>;
   'header-click': CustomEvent<MillerHeaderClickDetail>;
   'header-rightclick': CustomEvent<MillerHeaderRightClickDetail>;
+  'rebase': CustomEvent<MillerRebaseDetail>;
 }
 interface MillerBaseElement {
   addEventListener: (<K extends keyof MillerBaseElementEventMap>(type: K, listener: (this: MillerBaseElement, event: MillerBaseElementEventMap[K]) => void, options?: boolean | AddEventListenerOptions) => void) & ((type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions) => void);
@@ -319,10 +394,13 @@ declare class MillerTreeController<T> {
    * Any ancestor `MillerNode`s with unloaded children are populated
    * synchronously before calling `element.navigateTo()`.
    *
+   * Key paths are relative to the element's current view root: when the view
+   * is rebased, only matches at or below the view root can be reached.
+   *
    * Returns `false` if no matching node is found.
    */
   navigateToValue(predicate: (value: T) => boolean): boolean;
 }
 //#endregion
-export { type TreeActivateDetail as MillerActivateDetail, type TreeActivateEvent as MillerActivateEvent, MillerBaseElement, MillerBaseElementEventMap, type TreeCollapseDetail as MillerCollapseDetail, type TreeCollapseEvent as MillerCollapseEvent, MillerConfig, type TreeExpandDetail as MillerExpandDetail, type TreeExpandEvent as MillerExpandEvent, MillerHeaderClickDetail, MillerHeaderClickEvent, MillerHeaderRightClickDetail, MillerHeaderRightClickEvent, type TreeItem as MillerItem, type TreeItemClickDetail as MillerItemClickDetail, type TreeItemClickEvent as MillerItemClickEvent, MillerItemDblClickDetail, MillerItemDblClickEvent, MillerItemRightClickDetail, MillerItemRightClickEvent, MillerItemState, MillerListElement, type TreeNode as MillerNode, type TreeSelectDetail as MillerSelectDetail, type TreeSelectEvent as MillerSelectEvent, MillerSelectionMode, type TreeTickleDetail as MillerTickleDetail, type TreeTickleEvent as MillerTickleEvent, MillerTreeController, MillerTreeControllerOptions };
+export { type TreeActivateDetail as MillerActivateDetail, type TreeActivateEvent as MillerActivateEvent, MillerBaseElement, MillerBaseElementEventMap, type TreeCollapseDetail as MillerCollapseDetail, type TreeCollapseEvent as MillerCollapseEvent, MillerConfig, type TreeExpandDetail as MillerExpandDetail, type TreeExpandEvent as MillerExpandEvent, MillerHeaderClickDetail, MillerHeaderClickEvent, MillerHeaderRightClickDetail, MillerHeaderRightClickEvent, type TreeItem as MillerItem, type TreeItemClickDetail as MillerItemClickDetail, type TreeItemClickEvent as MillerItemClickEvent, MillerItemDblClickDetail, MillerItemDblClickEvent, MillerItemRightClickDetail, MillerItemRightClickEvent, MillerItemState, MillerListElement, type TreeNode as MillerNode, MillerRebaseDetail, MillerRebaseEvent, type TreeSelectDetail as MillerSelectDetail, type TreeSelectEvent as MillerSelectEvent, MillerSelectionMode, type TreeTickleDetail as MillerTickleDetail, type TreeTickleEvent as MillerTickleEvent, MillerTreeController, MillerTreeControllerOptions };
 //# sourceMappingURL=miller.d.ts.map

package/dist/miller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"miller.d.ts","names":[],"sources":["../src/miller/types.ts","../src/miller/miller-base.ts","../src/miller/miller-list.ts","../src/miller/miller-tree-controller.ts"],"mappings":";;;;;;KAyBY;KAEA;EACV,cAAc;;;KAIJ;;EAEV;;EAEA;;;;;;;;EAQA,MAAM,MAZI;;;KAgBA;EACV,MADU;EAEV;;;KAIU;EACV,MADU;EAEV;EACA,YAAY;;;KAIF;EACV;EACA;EACA,MAAM,MAHI;EAIV,YAAY;;KAGF,yBAAyB,YAAY;KACrC,0BAA0B,YAAY;KACtC,4BAA4B,YAAY;KACxC,8BAA8B,YAAY;;;;;;;;;;KAW1C;EACV;EACA;EACA;EACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cCMW,0BAA0B,sBAAsB,eAAe;;EAE1E,MAAM;EAGN,OAAO;EAGP;;;;;;EAQA,iBAAiB;EAKjB,iBAAiB;EAGjB,aAAa;;;;;;EAQb,cAAc;EAGd,iBAAiB;YAGP,UAAU;YAIV;YAGA,kBAAgB,YAAA;YAGhB,eAAe;YAIf,gBAAc,IAAA;EA2BxB,SAAO;EA+BE,QAAQ,cAAc;EA8DtB;EAQT,aAAa;EAQb,UAAU,QAAQ;;MASd,gBAAgB;;MAKhB,aAAa,MAAM;;MAQnB,gBAAgB;MAIhB,aAAa,MAAM;;MAWnB,iBAAiB,YAAY;;EAOjC,OAAO,MAAM;;EAYb,SAAS,MAAM;;;;EAgBf;;EAYA;;EAKA;;;;;EAQA,YAAY,MAAM,UAAY;;;;;EAmB9B,eAAe;;;;EAcf,WAAW;;;;EAsDX,eAAe,YAAY,MAAM;EASjC,YAAY;IAAgB,MAAM;IAAY;;YAkCpC,oBAAoB,OAAO,YAAc,gBAAgB,wBAAwB;YAMjF,iBAAiB,MAAM,UAAY,eAAe,QAAQ;;;;YAO1D,qBAAqB,OAAO,YAAY,MAAM,UAAY;;;;YAQ1D,oBAAoB,MAAM,UAAY,eAAe,QAAQ;;;;YAW7D,sBAAsB,MAAM,UAAY,eAAe,OAAO;;;;YAW9D,wBAAwB,OAAO,YAAY;YAU3C,YAAY,MAAM,UAAY;YAY9B,QAAQ,MAAM,UAAY;;;;EAOpC,aAAa,aAAa,gBAAgB;;;;YA2nBhC,0BAA0B,wBAAwB;YAoBzC,UAAM;YAgCf,iBAAiB;YAQjB,WAAW,MAAM,UAAY;;;;;YAQ7B,wBAAwB,MAAM,UAAY;;;;YAY1C;SAIM,sBAAM;;QAiHhB;YACI;IACR,oBAAoB;;;UAIP,kCAAkC;EACjD,cAAc;EACd,UAAU;EACV,YAAY;EACZ,UAAU;EACV,UAAU;EACV,YAAY;EACZ,iBAAiB,YAAY;EAC7B,mBAAmB,YAAY;EAC/B,gBAAgB,YAAY;EAC5B,qBAAqB,YAAY;;UAGlB;EACf,oBAAoB,gBAAgB,2BAClC,MAAM,GACN,WAAW,MAAM,mBAAmB,OAAO,0BAA0B,aACrE,oBAAoB,sCAEpB,cACA,UAAU,oCACV,oBAAoB;EAEtB,uBAAuB,gBAAgB,2BACrC,MAAM,GACN,WAAW,MAAM,mBAAmB,OAAO,0BAA0B,aACrE,oBAAoB,mCAEpB,cACA,UAAU,oCACV,oBAAoB;;;;;;;;;;;;;;;;;;;;cCl3CX,0BAA0B;;YAClB,oBAAoB,OAAO,YAAc,gBAAgB;SA0D5D,sBAAM;;QAqFhB;YACI;IACR,oBAAoB;;;;;KCnMZ,4BAA4B;;;;;;;EAOtC,cAAc,OAAO,GAAG,MAAM,gBAAgB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;cA2B1C,qBAAqB;;EAa9B,YAAA,MAAM,gBAAgB,IACtB,SAAS,mBACT,SAAS,4BAA4B;;;;;EAavC;;EAoBA;;;;;;;;;;EAeA,gBAAgB,YAAY,OAAO"}
+{"version":3,"file":"miller.d.ts","names":[],"sources":["../src/miller/types.ts","../src/miller/miller-base.ts","../src/miller/miller-list.ts","../src/miller/miller-tree-controller.ts"],"mappings":"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"}