@ixfx/components 0.13.2 → 0.13.4

package/dist/hex-editor-Caq8vNQk.d.ts

@@ -125,5 +125,4 @@ declare global {
   }
 }
 //#endregion
-export { NoneSelectEventDetail as a, SingleSelectEventDetail as c, IxfxHexEditorElement as i, HexChangeDetail as n, RectangularSelectEventDetail as o, HexChangeEvent as r, SelectEventDetail as s, ContiguousSelectEventDetail as t };
-//# sourceMappingURL=hex-editor-Caq8vNQk.d.ts.map
+export { NoneSelectEventDetail as a, SingleSelectEventDetail as c, IxfxHexEditorElement as i, HexChangeDetail as n, RectangularSelectEventDetail as o, HexChangeEvent as r, SelectEventDetail as s, ContiguousSelectEventDetail as t };

package/dist/hex-editor-DiYpgIKs.js

@@ -1141,5 +1141,3 @@ __decorate([state()], IxfxHexEditorElement.prototype, "_focusSide", void 0);
 IxfxHexEditorElement = __decorate([safeCustomElement(`ixfx-hex-editor`)], IxfxHexEditorElement);
 //#endregion
 export { IxfxHexEditorElement as t };
-
-//# sourceMappingURL=hex-editor-DiYpgIKs.js.map

package/dist/highlight-B-eQrhhb.js

@@ -46,5 +46,3 @@ function findTextNode(element, expectedText) {
 }
 //#endregion
 export { buildHighlightTargets as n, clearHighlights as r, applyHighlights as t };
-
-//# sourceMappingURL=highlight-B-eQrhhb.js.map

package/dist/icon-1gpwtPx8.js

@@ -136,5 +136,3 @@ __decorate([property({
 IxfxIconElement = __decorate([safeCustomElement(`ixfx-icon`)], IxfxIconElement);
 //#endregion
 export { IxfxIconElement as t };
-
-//# sourceMappingURL=icon-1gpwtPx8.js.map

package/dist/{icon-DR_3rSyZ.d.ts → icon-CDGprSdE.d.ts}

@@ -9,7 +9,7 @@ declare class IxfxIconElement extends LitElement {
   rotate: string;
   connectedCallback(): void;
   disconnectedCallback(): void;
-  protected render(): import("lit").TemplateResult<1> | typeof nothing;
+  protected render(): typeof nothing | import("lit").TemplateResult<1>;
   protected updated(changed: Map<string, unknown>): void;
   static styles: import("lit").CSSResult[];
 }
@@ -19,5 +19,4 @@ declare global {
   }
 }
 //#endregion
-export { IxfxIconElement as t };
-//# sourceMappingURL=icon-DR_3rSyZ.d.ts.map
+export { IxfxIconElement as t };

package/dist/icons.d.ts

@@ -1,3 +1,3 @@
-import { t as IxfxIconElement } from "./icon-DR_3rSyZ.js";
-import { a as getIconEntry, c as iconBus, d as setIconFont, f as svgToDataUri, g as ICON_CLOSE, h as ICON_CHEVRON_DOWN, i as getIcon, l as registerFontIcon, m as ICON_CHECK, n as IconChangedEvent, o as getIconFont, p as ICON_CARET_RIGHT, r as IconEntry, s as hasIcon, t as IconChangedDetail, u as registerIcon } from "./index-garxxqgV.js";
+import { t as IxfxIconElement } from "./icon-CDGprSdE.js";
+import { a as getIconEntry, c as iconBus, d as setIconFont, f as svgToDataUri, g as ICON_CLOSE, h as ICON_CHEVRON_DOWN, i as getIcon, l as registerFontIcon, m as ICON_CHECK, n as IconChangedEvent, o as getIconFont, p as ICON_CARET_RIGHT, r as IconEntry, s as hasIcon, t as IconChangedDetail, u as registerIcon } from "./index-CYndvTWH.js";
 export { ICON_CARET_RIGHT, ICON_CHECK, ICON_CHEVRON_DOWN, ICON_CLOSE, type IconChangedDetail, type IconChangedEvent, type IconEntry, IxfxIconElement, getIcon, getIconEntry, getIconFont, hasIcon, iconBus, registerFontIcon, registerIcon, setIconFont, svgToDataUri };

package/dist/icons.js

@@ -5,5 +5,3 @@ import { a as registerDefaults, i as ICON_CLOSE, n as ICON_CHECK, r as ICON_CHEV
 registerDefaults();
 //#endregion
 export { ICON_CARET_RIGHT, ICON_CHECK, ICON_CHEVRON_DOWN, ICON_CLOSE, IxfxIconElement, getIcon, getIconEntry, getIconFont, hasIcon, iconBus, registerFontIcon, registerIcon, setIconFont, svgToDataUri };
-
-//# sourceMappingURL=icons.js.map

package/dist/{incr-search-D91M4Ozq.js → incr-search-JIhwB49y.js}

@@ -362,7 +362,11 @@ function createElementListSearchAdapter(host, options = {}) {
 	const getLabel = options.getLabel ?? defaultLabel;
 	const getKey = options.getKey ?? ((el) => keyForElement(el) ?? defaultLabel(el));
 	const hidden = /* @__PURE__ */ new Set();
-	const items = () => Array.from(host.querySelectorAll(itemSelector));
+	const observeContainer = options.observeContainer ?? true;
+	const items = () => {
+		if (options.getAllItems) return options.getAllItems();
+		return Array.from(host.querySelectorAll(itemSelector));
+	};
 	return {
 		getItems: items,
 		getLabel,
@@ -371,7 +375,9 @@ function createElementListSearchAdapter(host, options = {}) {
 			if (el) host.focusKey(getKey(el));
 		},
 		activateItem: (el) => {
-			el.dispatchEvent(new MouseEvent(`click`, {
+			const key = getKey(el);
+			if (host.activateKey) host.activateKey(key);
+			else el.dispatchEvent(new MouseEvent(`click`, {
 				bubbles: true,
 				composed: true
 			}));
@@ -397,7 +403,7 @@ function createElementListSearchAdapter(host, options = {}) {
 		highlightKeyOf: (el) => getKey(el),
 		highlightText: getLabel,
 		highlightKey: options.highlightKey,
-		container: () => host
+		container: observeContainer ? () => host : void 0
 	};
 }
 //#endregion
@@ -716,6 +722,10 @@ var ListSearchController = class {
 		}
 		this.#search.setItems(items);
 	}
+	/** Re-paint highlights without rebuilding the item set. Use when the rendered window changes. */
+	repaintHighlights() {
+		this.#applyHighlights();
+	}
 	/** Popover markup. Pair with `listSearchStyles` in the host's `static styles`. */
 	renderField() {
 		if (!this.enabled) return nothing;
@@ -837,9 +847,10 @@ var ListSearchController = class {
 			return;
 		}
 		const state = this.#search.state;
+		const itemByKey = new Map(state.results.map((r) => [r.item.key, r.item]));
 		const targets = buildHighlightTargets(root, selector, state.positionsByItem, (el) => {
 			const key = keyOf(el);
-			return key === void 0 ? void 0 : state.results.find((r) => r.item.key === key)?.item;
+			return key === void 0 ? void 0 : itemByKey.get(key);
 		}, this.#adapter.highlightText ?? ((el) => el.textContent ?? ``));
 		try {
 			applyHighlights(targets, { key: this.#highlightKey });
@@ -963,6 +974,16 @@ const listSearchStyles = css`
 //#endregion
 //#region src/incr-search/tree-list-search-adapter.ts
 /**
+* The label's own text. Highlights are painted on one text node matched by its
+* exact content, but a Lit-rendered label also holds template whitespace and
+* sibling bindings (tooltips), so `textContent` is padded and never equals the
+* node's content. Take the first non-blank text node instead.
+*/
+function labelText(el) {
+	for (const node of el.childNodes) if (node.nodeType === Node.TEXT_NODE && (node.textContent ?? ``).trim().length > 0) return node.textContent ?? ``;
+	return el.textContent ?? ``;
+}
+/**
 * A {@link ListSearchAdapter} over any `TreeSearchHost` (`ixfx-tree-list`,
 * `ixfx-miller-list`, `ixfx-crumb-navigation`). Navigate reveals the match
 * (expands its ancestors, moves the cursor); select drives `selectMany`; filter
@@ -990,11 +1011,10 @@ function createTreeListSearchAdapter(host, options = {}) {
 		},
 		highlightRoot: () => host.shadowRoot,
 		highlightSelector: options.labelSelector ?? `.tree-label`,
+		highlightText: labelText,
 		highlightKeyOf: (el) => el.closest(`[data-key]`)?.dataset.key,
 		highlightKey: options.highlightKey
 	};
 }
 //#endregion
 export { LIST_SEARCH_COMMAND_IDS as a, createElementListSearchAdapter as c, createDataListSearchAdapter as d, IncrSearchTreeController as f, createFuzzySearch as h, ListSearchController as i, KeyedElementIndex as l, createAcCompletionProvider as m, listSearchStyles as n, registerListSearchCommands as o, createIncrSearch as p, LIST_SEARCH_MODES as r, createElementIncrSearch as s, createTreeListSearchAdapter as t, keyForElement as u };
-
-//# sourceMappingURL=incr-search-D91M4Ozq.js.map

package/dist/incr-search.d.ts

@@ -1,2 +1,2 @@
-import { A as FuzzySearch, C as ListSearchControllerOptions, D as IncrSearchTreeOptions, E as IncrSearchTreeController, F as IncrSearchChangeCallback, I as IncrSearchOptions, L as IncrSearchResult, M as HighlightOptions, N as HighlightTarget, O as createAcCompletionProvider, P as IncrSearch, R as IncrSearchState, S as ListSearchController, T as ListSearchMode, _ as DataListSearchAdapterOptions, a as RegisterListSearchCommandsOptions, b as LIST_SEARCH_MODES, c as applyHighlights, d as createFuzzySearch, f as ElementIncrSearch, g as createElementListSearchAdapter, h as ElementListSearchHost, i as LIST_SEARCH_COMMAND_IDS, j as FuzzySearchOptions, k as ElementIncrSearchOptions, l as buildHighlightTargets, m as ElementListSearchAdapterOptions, n as createTreeListSearchAdapter, o as registerListSearchCommands, p as createElementIncrSearch, r as listSearchStyles, s as createIncrSearch, t as TreeListSearchAdapterOptions, u as clearHighlights, v as DataListSearchItem, w as ListSearchHost, x as ListSearchAdapter, y as createDataListSearchAdapter } from "./index-CxZ61DO1.js";
+import { A as FuzzySearch, C as ListSearchControllerOptions, D as IncrSearchTreeOptions, E as IncrSearchTreeController, F as IncrSearchChangeCallback, I as IncrSearchOptions, L as IncrSearchResult, M as HighlightOptions, N as HighlightTarget, O as createAcCompletionProvider, P as IncrSearch, R as IncrSearchState, S as ListSearchController, T as ListSearchMode, _ as DataListSearchAdapterOptions, a as RegisterListSearchCommandsOptions, b as LIST_SEARCH_MODES, c as applyHighlights, d as createFuzzySearch, f as ElementIncrSearch, g as createElementListSearchAdapter, h as ElementListSearchHost, i as LIST_SEARCH_COMMAND_IDS, j as FuzzySearchOptions, k as ElementIncrSearchOptions, l as buildHighlightTargets, m as ElementListSearchAdapterOptions, n as createTreeListSearchAdapter, o as registerListSearchCommands, p as createElementIncrSearch, r as listSearchStyles, s as createIncrSearch, t as TreeListSearchAdapterOptions, u as clearHighlights, v as DataListSearchItem, w as ListSearchHost, x as ListSearchAdapter, y as createDataListSearchAdapter } from "./index-BYIRgv49.js";
 export { type DataListSearchAdapterOptions, type DataListSearchItem, type ElementIncrSearch, type ElementIncrSearchOptions, type ElementListSearchAdapterOptions, type ElementListSearchHost, type FuzzySearch, type FuzzySearchOptions, type HighlightOptions, type HighlightTarget, type IncrSearch, type IncrSearchChangeCallback, IncrSearchTreeController as IncrSearchMillerController, IncrSearchTreeController, type IncrSearchTreeOptions as IncrSearchMillerOptions, type IncrSearchTreeOptions, type IncrSearchOptions, type IncrSearchResult, type IncrSearchState, LIST_SEARCH_COMMAND_IDS, LIST_SEARCH_MODES, type ListSearchAdapter, ListSearchController, type ListSearchControllerOptions, type ListSearchHost, type ListSearchMode, type RegisterListSearchCommandsOptions, type TreeListSearchAdapterOptions, applyHighlights, buildHighlightTargets, clearHighlights, createAcCompletionProvider, createDataListSearchAdapter, createElementIncrSearch, createElementListSearchAdapter, createFuzzySearch, createIncrSearch, createTreeListSearchAdapter, listSearchStyles, registerListSearchCommands };

package/dist/incr-search.js

@@ -1,3 +1,3 @@
 import { n as buildHighlightTargets, r as clearHighlights, t as applyHighlights } from "./highlight-B-eQrhhb.js";
-import { a as LIST_SEARCH_COMMAND_IDS, c as createElementListSearchAdapter, d as createDataListSearchAdapter, f as IncrSearchTreeController, h as createFuzzySearch, i as ListSearchController, m as createAcCompletionProvider, n as listSearchStyles, o as registerListSearchCommands, p as createIncrSearch, r as LIST_SEARCH_MODES, s as createElementIncrSearch, t as createTreeListSearchAdapter } from "./incr-search-D91M4Ozq.js";
+import { a as LIST_SEARCH_COMMAND_IDS, c as createElementListSearchAdapter, d as createDataListSearchAdapter, f as IncrSearchTreeController, h as createFuzzySearch, i as ListSearchController, m as createAcCompletionProvider, n as listSearchStyles, o as registerListSearchCommands, p as createIncrSearch, r as LIST_SEARCH_MODES, s as createElementIncrSearch, t as createTreeListSearchAdapter } from "./incr-search-JIhwB49y.js";
 export { IncrSearchTreeController as IncrSearchMillerController, IncrSearchTreeController, LIST_SEARCH_COMMAND_IDS, LIST_SEARCH_MODES, ListSearchController, applyHighlights, buildHighlightTargets, clearHighlights, createAcCompletionProvider, createDataListSearchAdapter, createElementIncrSearch, createElementListSearchAdapter, createFuzzySearch, createIncrSearch, createTreeListSearchAdapter, listSearchStyles, registerListSearchCommands };

package/dist/{index-Dq30pOnn.d.ts → index-B-hzcIP0.d.ts}

@@ -1,6 +1,6 @@
-import "./icon-DR_3rSyZ.js";
+import "./icon-CDGprSdE.js";
 import { o as TreeNode } from "./types-DQ7KOUIj.js";
-import { i as MenuContainer, n as MenuTrigger, r as MenuTriggerCommandDetail, t as MenuItem } from "./menu-item-B0zqw2xp.js";
+import { i as MenuContainer, n as MenuTrigger, r as MenuTriggerCommandDetail, t as MenuItem } from "./menu-item-bF6narIz.js";
 import { LitElement, TemplateResult } from "lit";
 import { CommandRegistry, KeyboardManager } from "@clinth/ui-commands";
 //#region src/menu/menu-bar.d.ts
@@ -178,5 +178,4 @@ declare namespace index_d_exports {
   export { MenuBar, MenuCheckItem, MenuCommandController, MenuContainer, MenuFromTreeOptions, MenuHeader, MenuItem, MenuRadioGroup, MenuRadioItem, MenuSeparator, MenuSubTrigger, MenuTrigger, menuFromTree, menuFromTreeToElements };
 }
 //#endregion
-export { menuFromTree as a, MenuSeparator as c, MenuCheckItem as d, MenuBar as f, MenuFromTreeOptions as i, MenuSubTrigger as l, MenuRadioGroup as n, menuFromTreeToElements as o, MenuRadioItem as r, MenuHeader as s, index_d_exports as t, MenuCommandController as u };
-//# sourceMappingURL=index-Dq30pOnn.d.ts.map
+export { menuFromTree as a, MenuSeparator as c, MenuCheckItem as d, MenuBar as f, MenuFromTreeOptions as i, MenuSubTrigger as l, MenuRadioGroup as n, menuFromTreeToElements as o, MenuRadioItem as r, MenuHeader as s, index_d_exports as t, MenuCommandController as u };

package/dist/{index-CxZ61DO1.d.ts → index-BYIRgv49.d.ts}

@@ -1,4 +1,4 @@
-import "./icon-DR_3rSyZ.js";
+import "./icon-CDGprSdE.js";
 import { w as TreeSearchHost } from "./tree-component-Cj8V3uar.js";
 import { o as TreeNode } from "./types-DQ7KOUIj.js";
 import { ReactiveController, ReactiveControllerHost, TemplateResult, nothing } from "lit";
@@ -242,6 +242,8 @@ declare class ListSearchController<TItem> implements ReactiveController {
   commit(): void;
   /** Rebuild the searchable item set from the adapter. Called on open and on container mutation. */
   refresh(): void;
+  /** Re-paint highlights without rebuilding the item set. Use when the rendered window changes. */
+  repaintHighlights(): void;
   /** Popover markup. Pair with `listSearchStyles` in the host's `static styles`. */
   renderField(): TemplateResult | typeof nothing;
 }
@@ -286,6 +288,7 @@ declare function createDataListSearchAdapter(host: {
 interface ElementListSearchHost extends HTMLElement {
   focusKey: (key: string) => void;
   selectKeys: (keys: Iterable<string>) => void;
+  activateKey?: (key: string) => void;
 }
 interface ElementListSearchAdapterOptions {
   /** Selector for item elements, relative to the host. Default `:scope > *`. */
@@ -294,6 +297,10 @@ interface ElementListSearchAdapterOptions {
   getKey?: (el: Element) => string;
   /** `CSS.highlights` registry key for matched-character highlights. */
   highlightKey?: string;
+  /** Full ordered item set, including rows not currently in the DOM (virtualised hosts). Defaults to querying `itemSelector`. */
+  getAllItems?: () => Element[];
+  /** Observe host child-list mutations to refresh the item set. Default true. */
+  observeContainer?: boolean;
 }
 /**
  * A {@link ListSearchAdapter} over the light-DOM item elements of a list
@@ -394,5 +401,4 @@ interface TreeListSearchAdapterOptions {
  */
 declare function createTreeListSearchAdapter(host: TreeSearchHost, options?: TreeListSearchAdapterOptions): ListSearchAdapter<TreeSearchItem>;
 //#endregion
-export { FuzzySearch as A, ListSearchControllerOptions as C, IncrSearchTreeOptions as D, IncrSearchTreeController as E, IncrSearchChangeCallback as F, IncrSearchOptions as I, IncrSearchResult as L, HighlightOptions as M, HighlightTarget as N, createAcCompletionProvider as O, IncrSearch as P, IncrSearchState as R, ListSearchController as S, ListSearchMode as T, DataListSearchAdapterOptions as _, RegisterListSearchCommandsOptions as a, LIST_SEARCH_MODES as b, applyHighlights as c, createFuzzySearch as d, ElementIncrSearch as f, createElementListSearchAdapter as g, ElementListSearchHost as h, LIST_SEARCH_COMMAND_IDS as i, FuzzySearchOptions as j, ElementIncrSearchOptions as k, buildHighlightTargets as l, ElementListSearchAdapterOptions as m, createTreeListSearchAdapter as n, registerListSearchCommands as o, createElementIncrSearch as p, listSearchStyles as r, createIncrSearch as s, TreeListSearchAdapterOptions as t, clearHighlights as u, DataListSearchItem as v, ListSearchHost as w, ListSearchAdapter as x, createDataListSearchAdapter as y };
-//# sourceMappingURL=index-CxZ61DO1.d.ts.map
+export { FuzzySearch as A, ListSearchControllerOptions as C, IncrSearchTreeOptions as D, IncrSearchTreeController as E, IncrSearchChangeCallback as F, IncrSearchOptions as I, IncrSearchResult as L, HighlightOptions as M, HighlightTarget as N, createAcCompletionProvider as O, IncrSearch as P, IncrSearchState as R, ListSearchController as S, ListSearchMode as T, DataListSearchAdapterOptions as _, RegisterListSearchCommandsOptions as a, LIST_SEARCH_MODES as b, applyHighlights as c, createFuzzySearch as d, ElementIncrSearch as f, createElementListSearchAdapter as g, ElementListSearchHost as h, LIST_SEARCH_COMMAND_IDS as i, FuzzySearchOptions as j, ElementIncrSearchOptions as k, buildHighlightTargets as l, ElementListSearchAdapterOptions as m, createTreeListSearchAdapter as n, registerListSearchCommands as o, createElementIncrSearch as p, listSearchStyles as r, createIncrSearch as s, TreeListSearchAdapterOptions as t, clearHighlights as u, DataListSearchItem as v, ListSearchHost as w, ListSearchAdapter as x, createDataListSearchAdapter as y };

package/dist/index-CCC0G1nO.d.ts

@@ -0,0 +1,324 @@
+import { C as TreeItemDblClickEvent, E as TreeSelectEvent, F as ListDragPreviewSourceResolver, L as ListNativeDragStartDetail, O as TreeTickleEvent, P as ListDragPreviewRenderer, _ as TreeDropTarget, a as TreeComponent, c as TreeDragContext, d as TreeDragStartEvent, h as TreeDropEvent, i as TreeCollapseEvent, k as TreeDataModel, l as TreeDragEndEvent, m as TreeDropDetail, n as TreeActivateEvent, o as TreeComponentEventMap, p as TreeDropContext, s as TreeDndMode, u as TreeDragOverEvent, w as TreeSearchHost, x as TreeItemClickEvent, y as TreeExpandEvent } from "./tree-component-Cj8V3uar.js";
+import { a as TreeItem, i as TreeInteractionMode, n as TreeExclusivity, o as TreeNode, r as TreeFilterPredicate, s as TreeSelectionFilter, t as LoadChildrenCallback } from "./types-DQ7KOUIj.js";
+import { S as ListSearchController } from "./index-BYIRgv49.js";
+import { t as ListNativeDragController } from "./list-native-drag-controller-ChIi3eK5.js";
+import { n as TickledController } from "./tickled-controller-DodxD3eQ.js";
+import { LitElement, PropertyValues, ReactiveController, ReactiveControllerHost, TemplateResult, nothing } from "lit";
+import { CommandRegistry } from "@clinth/ui-commands";
+import { TraversableTree } from "@ixfx/collections";
+//#region src/tree/types.d.ts
+/** Tree layout/display configuration (tree-specific, not shared). */
+type TreeConfig = {
+  indent: number;
+};
+//#endregion
+//#region src/tree/tree-base.d.ts
+/**
+ * `auto` windows the list once it has more than `virtualizeThreshold` visible
+ * rows; `on` / `off` force it.
+ */
+type TreeVirtualize = `auto` | `on` | `off`;
+declare class TreeBaseElement extends LitElement implements TreeComponent, TreeSearchHost {
+  #private;
+  root: TreeNode | undefined;
+  model: TreeDataModel | undefined;
+  /** Callback to lazily load children for a node. Superseded by `model` when both are set. */
+  loadChildren: LoadChildrenCallback | undefined;
+  exclusivity: TreeExclusivity;
+  selectionFilter: TreeSelectionFilter;
+  /** Controls how pointer/keyboard gestures map to selection changes. Default: `'standard'`. */
+  interactionMode: TreeInteractionMode;
+  selectedNode: TreeNode | undefined;
+  protected _selectedNodes: Set<TreeNode>;
+  get selectedNodes(): ReadonlySet<TreeNode>;
+  filterPredicate: TreeFilterPredicate | undefined;
+  disableKeyboardNavigation: boolean;
+  registry: CommandRegistry<unknown> | 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;
+  itemDnd: TreeDndMode;
+  acceptDropTypes: string | undefined;
+  dndExpandHoverMs: number;
+  /**
+   * Whether a drag that only reorders siblings (no dragged node changes parent)
+   * is honoured. Default `true`. Set `reorderable="false"` for models with no
+   * meaningful child order (e.g. a filesystem) — pure-reorder drags then get no
+   * drop indicator and emit no `tree-drop`. Reparenting is unaffected.
+   */
+  reorderable: boolean;
+  /**
+   * VS Code-style sticky headers: while scrolling vertically, the ancestors of
+   * the top-visible row stick to the top of the list. Clicking a stuck header
+   * selects that ancestor and scrolls it into view; clicking its caret toggles
+   * expansion. On by default — set `sticky-headers="false"` to opt out.
+   */
+  stickyHeaders: boolean;
+  /**
+   * Windowed rendering: only the rows near the viewport exist in the DOM, so a
+   * node with tens of thousands of children stays fast. `auto` (default)
+   * switches on above `virtualizeThreshold` visible rows; `on` / `off` force it.
+   * While windowed, rows are a fixed `--tree-item-height` tall and expand /
+   * collapse rows do not animate.
+   */
+  virtualize: TreeVirtualize;
+  /** Visible-row count above which `virtualize="auto"` windows the list. */
+  virtualizeThreshold: number;
+  dragPreviewRenderer: ListDragPreviewRenderer<TreeNode> | undefined;
+  dragPreviewSource: ListDragPreviewSourceResolver<TreeNode> | undefined;
+  canDrag: ((ctx: TreeDragContext) => boolean) | undefined;
+  canDrop: ((ctx: TreeDropContext) => boolean) | undefined;
+  parseExternalDrop: ((dt: DataTransfer) => TreeNode[] | undefined) | undefined;
+  applyInternalDrop: boolean;
+  /** Immutable: replace via `#setExpanded` so the flat-row cache is invalidated. */
+  protected _expandedKeys: ReadonlySet<string>;
+  /** Bumped whenever `_selectedNodes` content may have changed. */
+  protected _selectionVersion: number;
+  /**
+   * Call after editing `node.children` / `node.item` in place (outside
+   * `TreeDataModel`). Drops the cached whole-tree indexes and re-renders.
+   */
+  invalidateStructure(): void;
+  /** Scroll offset used for the last render; kept in sync with the container's. */
+  private _scrollTop;
+  /** Structure version for cache keys in subclasses (bumped on root / model change and lazy loads). */
+  protected get _structureVersion(): number;
+  /** Depths at which any loaded node carries an icon (stable across expansion). */
+  protected get _depthsWithIcons(): ReadonlySet<number>;
+  protected tickled: TickledController<string>;
+  protected _focusedDepth: number;
+  /** Incremental search (navigate / select / filter). See `docs/infra-incremental.md`. */
+  readonly search: ListSearchController<{
+    node: TreeNode;
+    depth: number;
+  }>;
+  /**
+   * Ancestor keys currently stuck to the top of the list (root-ward order).
+   * Recomputed on scroll and structural updates; empty when nothing is stuck.
+   */
+  protected _stickyKeys: string[];
+  protected get nativeDrag(): ListNativeDragController<TreeNode>;
+  protected get dropState(): TreeDropTarget | undefined;
+  /** Keys of the nodes currently being dragged out of this tree. */
+  protected get nativeDragKeys(): ReadonlySet<string>;
+  willUpdate(changedProps: PropertyValues): void;
+  /** True while `node` is a fading ghost row (removed / collapsed, still animating out). */
+  protected _isLeaving(node: TreeNode): boolean;
+  /**
+   * Kept for subclass compatibility. Filtered-out rows are no longer rendered
+   * at all (they are omitted from the flat list), so this is `false` for every
+   * rendered row.
+   */
+  protected _isFilteredOut(_node: TreeNode, _depth: number): boolean;
+  updated(changedProps: PropertyValues): void;
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  getConfig(): TreeConfig;
+  setConfig(config: Partial<TreeConfig>): void;
+  select(node: TreeNode): void;
+  deselect(node: TreeNode): void;
+  clearSelection(): void;
+  selectAll(): void;
+  deselectAll(): void;
+  navigateTo(keys: readonly string[]): boolean;
+  navigateToNode(predicate: (node: TreeNode) => boolean): boolean;
+  /** Expand ancestors + move the cursor to `key`, without touching the selection (search "navigate" mode). */
+  revealKey(key: string): boolean;
+  /** Replace the selection with `nodes` (subject to `selectionFilter`) — search "select" mode. */
+  selectMany(nodes: Iterable<TreeNode>): void;
+  getNodes(): ReadonlyArray<{
+    node: TreeNode;
+    depth: number;
+  }>;
+  protected renderNodeContent(node: TreeNode, depth: number): TemplateResult | typeof nothing;
+  protected _handleItemClick(node: TreeNode, depth: number, event?: MouseEvent): void;
+  protected _handleCheckboxClick(event: MouseEvent, node: TreeNode, _depth: number): void;
+  protected _isSelected(node: TreeNode): boolean;
+  protected _isFocused(node: TreeNode): boolean;
+  protected _isExpanded(node: TreeNode, _depth?: number): boolean;
+  protected get _pendingNode(): TreeNode | undefined;
+  protected renderLoadingIndicator(): TemplateResult | typeof nothing;
+  protected render(): TemplateResult<1>;
+  /**
+   * `{ posinset, setsize }` for `aria-posinset` / `aria-setsize`. A windowed
+   * list has most siblings out of the DOM, so assistive tech cannot count them.
+   */
+  protected _ariaSetInfo(node: TreeNode): {
+    posInSet: number;
+    setSize: number;
+  } | undefined;
+  /** Shared drag-and-drop render state for a row, used by every `_renderNode` variant. */
+  protected _dndRowState(node: TreeNode): {
+    draggable: boolean;
+    dragging: boolean;
+    dropTarget: boolean;
+    dropPosition?: TreeDropTarget[`position`];
+    dropDepth?: number;
+  };
+  protected _renderNode(node: TreeNode, depth: number): TemplateResult;
+  static styles: import("lit").CSSResult[];
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'ixfx-tree-base': TreeBaseElement;
+  }
+}
+interface TreeBaseElementEventMap extends TreeComponentEventMap {
+  'item-click': TreeItemClickEvent;
+  'item-dblclick': TreeItemDblClickEvent;
+  'expand': TreeExpandEvent;
+  'collapse': TreeCollapseEvent;
+  'select': TreeSelectEvent;
+  'tickle': TreeTickleEvent;
+  'activate': TreeActivateEvent;
+  'list-native-drag-start': CustomEvent<ListNativeDragStartDetail<TreeNode>>;
+  'tree-drag-start': TreeDragStartEvent;
+  'tree-drag-over': TreeDragOverEvent;
+  'tree-drop': TreeDropEvent;
+  'tree-drag-end': TreeDragEndEvent;
+}
+interface TreeBaseElement {
+  addEventListener: (<K extends keyof TreeBaseElementEventMap>(type: K, listener: (this: TreeBaseElement, event: TreeBaseElementEventMap[K]) => void, options?: boolean | AddEventListenerOptions) => void) & ((type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions) => void);
+  removeEventListener: (<K extends keyof TreeBaseElementEventMap>(type: K, listener: (this: TreeBaseElement, event: TreeBaseElementEventMap[K]) => void, options?: boolean | EventListenerOptions) => void) & ((type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions) => void);
+}
+//#endregion
+//#region src/tree/tree-flat.d.ts
+/** Checkbox tri-state in `checked` interactionMode: a branch node is `indeterminate` when some but not all of its descendants are selected. */
+type TreeCheckboxState = `checked` | `unchecked` | `indeterminate`;
+//#endregion
+//#region src/tree/tree-list.d.ts
+declare class TreeListElement extends TreeBaseElement {
+  #private;
+  /**
+   * Optional renderer for the checkbox shown in `checked` interactionMode.
+   * Receives the node's current tri-state (`checked` / `unchecked` / `indeterminate`,
+   * the latter when some but not all descendants are selected) and returns a Lit
+   * template.
+   *
+   * When set, the checkbox becomes a `<span role="checkbox">` whose contents are
+   * whatever this returns. When unset, a native `<input type="checkbox">` is used.
+   *
+   * @example
+   *   list.checkboxRenderer = (state) => state === `unchecked`
+   *     ? html``
+   *     : html`<svg viewBox="0 0 16 16" width="14" height="14"
+   *           fill="none" stroke="currentColor" stroke-width="2"
+   *           stroke-linecap="round" stroke-linejoin="round"
+   *           style="opacity:${state === `indeterminate` ? 0.35 : 0.6}">
+   *         <polyline points="3,8 7,12 13,4" />
+   *       </svg>`;
+   */
+  checkboxRenderer: ((state: TreeCheckboxState) => unknown) | undefined;
+  willUpdate(changedProps: PropertyValues): void;
+  protected renderNodeContent(node: TreeNode, depth: number): TemplateResult;
+  protected _renderNode(node: TreeNode, depth: number): TemplateResult;
+  static styles: import("lit").CSSResult[];
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'ixfx-tree-list': TreeListElement;
+  }
+}
+interface TreeListElement {
+  addEventListener: (<K extends keyof TreeBaseElementEventMap>(type: K, listener: (this: TreeListElement, event: TreeBaseElementEventMap[K]) => void, options?: boolean | AddEventListenerOptions) => void) & ((type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions) => void);
+}
+//#endregion
+//#region src/tree/tree-controller.d.ts
+type TreeControllerOptions<T> = {
+  valueToItem: (value: T, node: TraversableTree<T>) => TreeItem;
+};
+declare class TreeController<T> {
+  #private;
+  constructor(root: TraversableTree<T>, element: TreeBaseElement, options: TreeControllerOptions<T>);
+  connect(): void;
+  disconnect(): void;
+  navigateToValue(predicate: (value: T) => boolean): boolean;
+}
+//#endregion
+//#region src/tree/tree-drop-controller.d.ts
+interface TreeDropVisibleRow {
+  readonly key: string;
+  readonly node: TreeNode;
+  readonly depth: number;
+  /** Index of this row in the full flat (visible) list — not in the `rows` array. */
+  readonly index: number;
+  readonly rect: DOMRect;
+}
+/** Structural facts about a visible row, independent of geometry. */
+interface TreeDropRowInfo {
+  readonly node: TreeNode;
+  readonly depth: number;
+  /** Parent key, or `undefined` for a root-level row. */
+  readonly parentKey: string | undefined;
+}
+/** What a `dragover` / `drop` DataTransfer resolved to for this tree. */
+interface TreeDropResolvedDrag {
+  readonly source: `internal` | `external`;
+  /** Keys of the dragged nodes (empty for external). */
+  readonly keys: readonly string[];
+  /** The dragged nodes — live nodes for internal, parsed payload for external. */
+  readonly nodes: readonly TreeNode[];
+}
+type TreeDropControllerConfig = {
+  getDndMode: () => `none` | `internal` | `external` | `both`;
+  getExpandHoverMs: () => number;
+  /**
+   * Measured rows in display order, each with a fresh viewport rect. May be
+   * limited to the rows intersecting the scroll container — ancestors and
+   * siblings are resolved through `getRowInfo` / `getChildren`, not from here.
+   * Host may cache.
+   */
+  getVisibleRows: () => TreeDropVisibleRow[];
+  /** Flat-list info for a visible key (no geometry), or `undefined` if not visible. */
+  getRowInfo: (key: string) => TreeDropRowInfo | undefined;
+  /** Children of `parentKey`, or the root's children when undefined. */
+  getChildren: (parentKey: string | undefined) => readonly TreeNode[];
+  getIndentPx: () => number;
+  getScrollContainer: () => HTMLElement | undefined;
+  /** True when `key` is `ancestorKey` or a descendant of it. */
+  isSelfOrDescendant: (ancestorKey: string, key: string) => boolean;
+  /** True when the node is currently expanded in the UI. */
+  isExpanded: (key: string) => boolean;
+  /**
+   * When `false`, an internal drop that would not change any dragged node's
+   * parent (pure sibling reorder, or dropping back into the current parent) is
+   * rejected outright — no indicator, no `tree-drop`.
+   */
+  isReorderAllowed: () => boolean;
+  /** Current parent key of `key`, or `undefined` for a root-level node. */
+  getParentKey: (key: string) => string | undefined;
+  /**
+   * Decide whether this DataTransfer is acceptable and resolve the dragged set.
+   * `phase` is `hover` during dragenter/dragover (DataTransfer is read-protected —
+   * resolve internal drags from the drag registry) and `drop` during drop
+   * (getData is readable; external payloads may be parsed here). Return
+   * `undefined` to reject (the tree will not become a drop target).
+   */
+  resolveDrag: (dataTransfer: DataTransfer, phase: `hover` | `drop`) => TreeDropResolvedDrag | undefined;
+  vet: (ctx: TreeDropContext) => boolean;
+  expandKey: (key: string) => void;
+  /** Fired whenever the resolved drop target changes (undefined = none / rejected). */
+  onDropStateChange: (state: TreeDropTarget | undefined) => void;
+  /** Fired when a drag enters / leaves this tree. */
+  onActiveChange: (active: boolean) => void;
+  commitDrop: (detail: TreeDropDetail) => boolean;
+  onDragEnd: (dropped: boolean) => void;
+};
+declare class TreeDropController implements ReactiveController {
+  #private;
+  constructor(host: ReactiveControllerHost & HTMLElement, config: TreeDropControllerConfig);
+  /** A drag is currently over this tree. */
+  get isDragging(): boolean;
+  /** A drag is over this tree but the current position is not a valid drop. */
+  get isRejected(): boolean;
+  get dropState(): TreeDropTarget | undefined;
+  hostConnected(): void;
+  /** Bind once the shadow `#container` exists (it does not yet at `hostConnected`). */
+  hostUpdated(): void;
+  hostDisconnected(): void;
+}
+//#endregion
+export { TreeDropVisibleRow as a, TreeListElement as c, TreeBaseElementEventMap as d, TreeVirtualize as f, TreeDropRowInfo as i, TreeCheckboxState as l, TreeDropControllerConfig as n, TreeController as o, TreeConfig as p, TreeDropResolvedDrag as r, TreeControllerOptions as s, TreeDropController as t, TreeBaseElement as u };

package/dist/{index-garxxqgV.d.ts → index-CYndvTWH.d.ts}

@@ -1,4 +1,4 @@
-import "./icon-DR_3rSyZ.js";
+import "./icon-CDGprSdE.js";
 //#region src/icons/defaults.d.ts
 /** Chevron pointing down (Lucide `chevron-down`). Used for split-button dropdown toggle. */
 declare const ICON_CHEVRON_DOWN = "<svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\"><path d=\"m6 9 6 6 6-6\"/></svg>";
@@ -34,5 +34,4 @@ declare function setIconFont(fontFamily: string): void;
 declare function getIconFont(): string | undefined;
 declare function svgToDataUri(svg: string): string;
 //#endregion
-export { getIconEntry as a, iconBus as c, setIconFont as d, svgToDataUri as f, ICON_CLOSE as g, ICON_CHEVRON_DOWN as h, getIcon as i, registerFontIcon as l, ICON_CHECK as m, IconChangedEvent as n, getIconFont as o, ICON_CARET_RIGHT as p, IconEntry as r, hasIcon as s, IconChangedDetail as t, registerIcon as u };
-//# sourceMappingURL=index-garxxqgV.d.ts.map
+export { getIconEntry as a, iconBus as c, setIconFont as d, svgToDataUri as f, ICON_CLOSE as g, ICON_CHEVRON_DOWN as h, getIcon as i, registerFontIcon as l, ICON_CHECK as m, IconChangedEvent as n, getIconFont as o, ICON_CARET_RIGHT as p, IconEntry as r, hasIcon as s, IconChangedDetail as t, registerIcon as u };

package/dist/{index-BUB5SICW.d.ts → index-CoqtMSd9.d.ts}

@@ -1,4 +1,4 @@
-import { t as LabelledInputBase } from "./labelled-input-base-Dp_9KP0G.js";
+import { t as LabelledInputBase } from "./labelled-input-base-DiTme1JO.js";
 import { CSSResultGroup } from "lit";
 //#region src/labelled-range-input/labelled-range-input.d.ts
 declare class LabelledRangeInput extends LabelledInputBase {
@@ -20,5 +20,4 @@ declare global {
   }
 }
 //#endregion
-export { LabelledRangeInput as t };
-//# sourceMappingURL=index-BUB5SICW.d.ts.map
+export { LabelledRangeInput as t };

package/dist/index-DV3iaUBW.d.ts

@@ -391,5 +391,4 @@ declare function attachTimelineInteractions(host: IxfxTimelineElement, vcanvasEl
 //#region src/timeline/timeline-styles.d.ts
 declare const timelineStyles: import("lit").CSSResult;
 //#endregion
-export { TimelineTrackReorderEvent as A, TimelineEventResizeEvent as C, TimelineTickleChangeEvent as D, TimelineTickleChangeDetail as E, TrackHeightMode as F, TrackLayout as I, UserScale as L, TimelineTrackResizeEvent as M, TimelineTrackSelectDetail as N, TimelineTrack as O, TimelineTrackSelectEvent as P, ViewRange as R, TimelineEventResizeDetail as S, TimelineSelectionChangeEvent as T, TimelineDraggingEvent as _, CssVars as a, TimelineEventMoveDetail as b, resolveGrid as c, DragSnappingFn as d, DragTarget as f, TimelineDraggingDetail as g, TimelineDraggingCallbackDetail as h, TimelineTrackTabElement as i, TimelineTrackResizeDetail as j, TimelineTrackReorderDetail as k, TimelineController as l, GridResolution as m, attachTimelineInteractions as n, Rect as o, GridMode as p, IxfxTimelineElement as r, resolveCssVars as s, timelineStyles as t, TimelineControllerConfig as u, TimelineElementEventMap as v, TimelineSelectionChangeDetail as w, TimelineEventMoveEvent as x, TimelineEvent as y };
-//# sourceMappingURL=index-DV3iaUBW.d.ts.map
+export { TimelineTrackReorderEvent as A, TimelineEventResizeEvent as C, TimelineTickleChangeEvent as D, TimelineTickleChangeDetail as E, TrackHeightMode as F, TrackLayout as I, UserScale as L, TimelineTrackResizeEvent as M, TimelineTrackSelectDetail as N, TimelineTrack as O, TimelineTrackSelectEvent as P, ViewRange as R, TimelineEventResizeDetail as S, TimelineSelectionChangeEvent as T, TimelineDraggingEvent as _, CssVars as a, TimelineEventMoveDetail as b, resolveGrid as c, DragSnappingFn as d, DragTarget as f, TimelineDraggingDetail as g, TimelineDraggingCallbackDetail as h, TimelineTrackTabElement as i, TimelineTrackResizeDetail as j, TimelineTrackReorderDetail as k, TimelineController as l, GridResolution as m, attachTimelineInteractions as n, Rect as o, GridMode as p, IxfxTimelineElement as r, resolveCssVars as s, timelineStyles as t, TimelineControllerConfig as u, TimelineElementEventMap as v, TimelineSelectionChangeDetail as w, TimelineEventMoveEvent as x, TimelineEvent as y };

package/dist/{index-CJ5fshD3.d.ts → index-UvnoZUAo.d.ts}

@@ -1,4 +1,4 @@
-import { t as LabelledInputBase } from "./labelled-input-base-Dp_9KP0G.js";
+import { t as LabelledInputBase } from "./labelled-input-base-DiTme1JO.js";
 import { n as EditableLabel } from "./editable-label-rzXkjf1H.js";
 import { n as WheelNudgeConsumer, t as WheelDirection } from "./wheel-nudge-By5s_ioH.js";
 import { f as SliderMarkerStyle, m as SliderSingleStyle } from "./slider-input-BxURAAmD.js";
@@ -97,5 +97,4 @@ declare global {
   }
 }
 //#endregion
-export { EditableNumber as n, LabelledSliderInput as t };
-//# sourceMappingURL=index-CJ5fshD3.d.ts.map
+export { EditableNumber as n, LabelledSliderInput as t };

package/dist/index-o-CWDt11.d.ts

@@ -74,5 +74,4 @@ declare global {
   }
 }
 //#endregion
-export { NarrowedTextItem as a, NarrowedTextChangeEvent as i, FuzzySearchResult as n, Orientation as o, NarrowedTextChangeDetail as r, SelectionMode as s, NarrowedTextElement as t };
-//# sourceMappingURL=index-o-CWDt11.d.ts.map
+export { NarrowedTextItem as a, NarrowedTextChangeEvent as i, FuzzySearchResult as n, Orientation as o, NarrowedTextChangeDetail as r, SelectionMode as s, NarrowedTextElement as t };

package/dist/{index-BOUaDIW-.d.ts → index-tq6f8007.d.ts}

@@ -1,4 +1,4 @@
-import "./index-BUB5SICW.js";
+import "./index-CoqtMSd9.js";
 import { CSSResultGroup, LitElement, PropertyValues } from "lit";
 import { Colour } from "@ixfx/visual";
 //#region src/colour-picker/types.d.ts
@@ -183,5 +183,4 @@ declare global {
   }
 }
 //#endregion
-export { ColourPickerInputEvent as a, ColourPickerEventDetail as i, ColourPicker as n, OklchValue as o, ColourPickerChangeEvent as r, ColourPickerPopup as t };
-//# sourceMappingURL=index-BOUaDIW-.d.ts.map
+export { ColourPickerInputEvent as a, ColourPickerEventDetail as i, ColourPicker as n, OklchValue as o, ColourPickerChangeEvent as r, ColourPickerPopup as t };