@ixfx/components 0.16.0 → 0.16.1

package/docs-user/dock.md

@@ -228,7 +228,9 @@ The host consumes `ixfx-split-layout` events: `ixfx-split-resize` /
 ```ts
 getViewState(options?): DockHostViewState   // { v, kind: 'dock-host', layout }; folds live split weights
 setViewState(state: Partial<DockHostViewState>): void
-clearPendingViewState(): void               // no-op: placeholders live in the layout tree
+clearPendingViewState(): void               // drops placeholders (panels the host doesn't hold)
+saveLayout(): DockLayout                    // deprecated alias of getViewState().layout
+loadLayout(layout: DockLayout): void        // deprecated alias of setViewState({ layout })
 addPanel(panel: DockPanelElement | DockPanelInit, target?: DockAddPanelTarget): boolean
 type DockAddPanelTarget = {
   container?: string;   // named stack leaf — takes precedence over `stack`
@@ -259,6 +261,7 @@ getNeighbours(leaf: DockLeafRef): DockNeighbours | null
 moveLeaf(leaf: DockLeafRef, direction: 'up' | 'down' | 'left' | 'right'): boolean
 moveLeafToEdge(leaf: DockLeafRef, edge: 'top' | 'bottom' | 'left' | 'right'): boolean
 canAccept?: (panelId: string, op: DockOperation) => boolean
+placeholderLabel?: (panelId: string) => string   // tab label for placeholders (default: the id)
 
 // Cross-window hooks (serializable in/out; no element handoff)
 getPanelSnapshot(panelId: string): DockPanelSnapshot | null
@@ -456,13 +459,19 @@ The dock layout is close to structure, so the saved state *is* the tree
   a save → drag → save round-trip preserves user adjustments.
 - **Panels not in the host yet.** `setViewState()` keeps every panel id the
   layout names, held or not. One the host doesn't hold is a *placeholder*:
-  it keeps its place in the tree (shown as a tab labelled with its id) and
+  it keeps its place in the tree (shown as a tab labelled by the
+  `placeholderLabel(panelId)` property, or its id when unset) and
   the panel slots into that place when it arrives — appended as a light-DOM
   child, `addPanel()` **without** a target, `acceptExternalPanel()` without
   `at`, or a cross-host adoption. An explicit `addPanel()` target still wins.
   Placeholders are saved by `getViewState()`; `includePending: false` leaves
   them out (stacks they empty are dropped unless named). Remove one with
-  `removePanel(id)`; `clearPendingViewState()` is a no-op.
+  `removePanel(id)`, or all of them with `clearPendingViewState()`.
+- **Persisting with the default keeps stale ids.** A placeholder for a panel
+  that no longer exists is saved again on every `getViewState()`, so it never
+  goes away. Apps whose panels can disappear between save and restore should
+  call `clearPendingViewState()` once they have added the panels they hold,
+  or save with `includePending: false`.
 - Pooled panels the layout doesn't name are appended to the first stack
   admitting their kind.
 - A panel that is closed / removed (`removePanel`, close button, removed from

package/docs-user/grid-list.md

@@ -311,8 +311,11 @@ grid.registry.invoke('list.search.filter');   // or .navigate / .select
 
 Search matches `data-label` (or `[data-grid-list-caption]` text, then
 `data-search-label`, then `textContent`). Filter mode genuinely removes items
-from the virtualised layout. Add a page-level highlight rule to see matched
-characters:
+from the virtualised layout. Matched characters are highlighted under the
+`grid-list-search` key. In data mode (`itemAdapter`) the captions live in the
+shadow root and the grid styles them itself (`--search-highlight-bg` /
+`--search-highlight-color`, default `--accent` / `--accent-text`). In element
+mode the items are light DOM, so add a page-level rule:
 
 ```css
 ::highlight(grid-list-search) { background: var(--accent); color: var(--accent-text); }

package/docs-user/index.json

@@ -1,7 +1,7 @@
 {
   "name": "@ixfx/components",
-  "version": "0.16.0",
-  "generated": "2026-10-23T13:15:45.063Z",
+  "version": "0.16.1",
+  "generated": "2026-10-26T15:36:19.925Z",
   "components": [
     {
       "name": "ac-text",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ixfx/components",
   "type": "module",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "packageManager": "pnpm@10.0.0",
   "description": "Web components for ixfx — Lit-based UI toolkit",
   "author": "Clint Heyer",
@@ -247,7 +247,7 @@
     "lit": { "optional": false }
   },
   "dependencies": {
-    "@clinth/ui-commands": "1.1.0",
+    "@clinth/ui-commands": "1.1.1",
     "@clinth/vcanvas": "0.0.5",
     "@ixfx/arrays": "0.56.14",
     "@ixfx/collections": "0.56.14",