@ixfx/components 0.13.5 → 0.13.7

package/docs-user/index.json

@@ -1,7 +1,7 @@
 {
   "name": "@ixfx/components",
-  "version": "0.13.5",
-  "generated": "2026-10-04T12:58:50.843Z",
+  "version": "0.13.7",
+  "generated": "2026-10-05T21:23:39.070Z",
   "components": [
     {
       "name": "ac-text",

package/docs-user/miller.md

@@ -54,7 +54,11 @@ Inherited from theme:
 // Navigate to a node by key path (root-to-target keys, excluding root itself).
 // Only works with already-loaded children — returns false if any node along
 // the path has unloaded children or if a key is not found.
-navigateTo(keys: readonly string[]): boolean
+navigateTo(keys: readonly string[], options?: { reveal?: 'edge' | 'center-if-hidden'; silent?: boolean }): boolean
+
+// Re-sync after children arrays were patched in place (used by MillerTreeController.sync()):
+// closes columns whose selected node was removed, then re-renders.
+invalidateStructure(): void
 
 // Navigate to the first loaded node (breadth-first) matching a predicate.
 // Returns false if no match is found in the currently loaded tree.
@@ -398,11 +402,27 @@ type MillerTreeControllerOptions<T> = {
   // key and label are required. If isLeaf is omitted, it is inferred
   // from whether the TraversableTree node has any children.
   valueToItem: (value: T, node: TraversableTree<T>) => MillerItem;
+  // Installed as element.loadChildren by connect(). Defaults to a synchronous
+  // read from the source tree. sync() never touches it.
+  loadChildren?: LoadChildrenCallback;
 };
 ```
 
 ### Methods
 
+```typescript
+// Re-derive children of already-loaded nodes from the source tree and patch them
+// in place (arrays mutated, MillerNodes reused by key). viewRoot is reset only if
+// its node was removed. Refreshes the element once.
+sync(): void
+
+// Lookups that avoid searching the source tree. Key paths are RELATIVE TO THE
+// VIEW ROOT; identities outside a rebased view return false.
+lookupByKey(key: string): TraversableTree<T> | undefined
+navigateToKeyPath(keys: readonly string[], options?: TreeNavigateOptions): boolean
+navigateToIdentity(identity: unknown, options?: TreeNavigateOptions): boolean
+```
+
 ```typescript
 // Wire up the controller — sets element.root and provides loadChildren callback.
 // Safe to call again after disconnect().

package/docs-user/tree.md

@@ -46,6 +46,8 @@ type TreeNode = {
 
 `TreeNode` is **immutable** — structural changes always produce a new root. Never mutate a node in place; use `TreeDataModel` convenience methods or replace `root` directly.
 
+**Incremental updates.** `TreeController.sync()` re-derives children of already-materialised nodes from the source tree and patches them in place (nodes are reused by key, so expansion and selection survive). `navigateToKeyPath(keys)`, `navigateToIdentity(id)` and `lookupByKey(key)` resolve targets without searching the source tree.
+
 **Escape hatch for in-place edits.** The component itself fills in `node.children` when lazy-loading, and `TreeController` does the same. If you must edit `node.children` or `node.item` (e.g. an icon) in place, call `el.invalidateStructure()` afterwards. It drops the cached whole-tree indexes (parent map, icon depths, filter matches, checkbox states) and re-renders. Visible rows are re-derived on every update, so ordinary expand / collapse never needs it.
 
 ---
@@ -248,7 +250,7 @@ they do without windowing and cover rows that are not rendered:
   is never missing.
 - **Incremental search**: `navigate`, `select` and `filter` modes search the whole tree.
   Match highlights are repainted as the window moves.
-- **`navigateTo` / `revealKey`**: expand ancestors and scroll to the row.
+- **`navigateTo` / `revealKey`**: expand ancestors and scroll to the row. `navigateTo(keys, { reveal: 'center-if-hidden' })` centres the row only when it is off screen (arithmetic, no DOM measuring); `{ silent: true }` suppresses the `select` event. Otherwise `select` detail carries `origin: 'user' | 'programmatic'`.
 - **Drag and drop**: drop targets are computed from the layout, so auto-scroll while dragging works.
 - **Sticky headers**: found by arithmetic, with no per-row measuring.
 
@@ -817,7 +819,7 @@ interface TreeComponent extends EventTarget {
   select(node: TreeNode): void;
   deselect(node: TreeNode): void;
   clearSelection(): void;
-  navigateTo(keys: readonly string[]): boolean;
+  navigateTo(keys: readonly string[], options?: { reveal?: 'edge' | 'center-if-hidden'; silent?: boolean }): boolean;
   navigateToNode(predicate: (node: TreeNode) => boolean): boolean;
   getNodes(): ReadonlyArray<{ node: TreeNode; depth: number }>;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ixfx/components",
   "type": "module",
-  "version": "0.13.5",
+  "version": "0.13.7",
   "packageManager": "pnpm@10.0.0",
   "description": "Web components for ixfx — Lit-based UI toolkit",
   "author": "Clint Heyer",