@ixfx/components 0.16.3 → 0.16.4

package/docs-user/panel.md

@@ -2,7 +2,7 @@
 
 An collapsible panel component with support for titles, icons, toolbars, and multiple visual variants.
 
-The header chrome is an `ixfx-titlebar` (see [`ixfx-titlebar`](../titlebar/README.md)); the panel adds the collapsible content area beneath it.
+The header chrome is an `ixfx-titlebar` (see [`ixfx-titlebar`](./titlebar.md)); the panel adds the collapsible content area beneath it.
 
 ```html
 <ixfx-panel title="Settings">
@@ -341,5 +341,5 @@ import type { TitlebarOrientation, TitlebarVariant, TitlebarToggleInteraction, T
 
 ## See also
 
-- [`ixfx-titlebar`](../titlebar/README.md) — Standalone titlebar chrome composed by this panel
-- [`ixfx-icon`](../icons/README.md) — Icon component used by panel
+- [`ixfx-titlebar`](./titlebar.md) — Standalone titlebar chrome composed by this panel
+- [`ixfx-icon`](./icons.md) — Icon component used by panel

package/docs-user/split-layout.md

@@ -132,7 +132,7 @@ Nested `<ixfx-split-layout>` elements create sub-groups:
 | `--split-collapsed-size` | `0px` | Size of collapsed panels |
 | `--split-snap` | `24px` | Snap/hysteresis distance |
 The gutter grip is the shared `dimpled` handle — theme it with the
-`--ixfx-handle-*` variables (see [docs/infra-handle.md](../../docs/infra-handle.md)).
+`--ixfx-handle-*` variables (see [docs/infra-handle.md](./infra-handle.md)).
 
 ---
 
@@ -202,7 +202,7 @@ layouts, resizing several splits with one gesture.
 `getViewState()` / `setViewState()` snapshot and restore the size and
 collapse of each direct child that has an `id`, as plain JSON (`kind:
 'split-layout'`). The component never persists anything itself — see
-[docs/infra-view-state.md](../../docs/infra-view-state.md) and
+[docs/infra-view-state.md](./infra-view-state.md) and
 `bindViewState()`.
 
 ```ts

package/docs-user/sunburst-tree.md

@@ -2,7 +2,7 @@
 
 `<ixfx-sunbursttree-list>` — a zoomable sunburst over weighted tree data. The zoom node is the centre disc; each ring outward is one generation, and each arc's angle is its share of its parent's value. Every change — data arriving, a different weighting, a zoom — animates from what's on screen to the new layout.
 
-It implements the shared `TreeComponent` interface (see [`src/tree/README.md`](../tree/README.md)), so `TreeDataModel`, `IncrSearchTreeController`, and `TreeComponent`-typed code work unmodified. Geometrically it is a polar [icicle](../icicle-tree/), and shares its API shape.
+It implements the shared `TreeComponent` interface (see [`src/tree/README.md`](./tree.md)), so `TreeDataModel`, `IncrSearchTreeController`, and `TreeComponent`-typed code work unmodified. Geometrically it is a polar [icicle](./icicle-tree.md), and shares its API shape.
 
 ---
 
@@ -123,7 +123,7 @@ All of it is computed in CSS from per-arc custom properties, so the palette is t
 | `animationDuration` (`animation-duration`) | `number` | `600` | Transition length in ms; `0` snaps. Respects `prefers-reduced-motion` |
 | `filterPredicate` | `TreeFilterPredicate \| undefined` | `undefined` | Non-matching arcs (with no matching descendant) are dimmed |
 | `disableKeyboardNavigation` (`disable-keyboard-navigation`) | `boolean` | `false` | Turn off keyboard handling |
-| `searchModes` (`search-modes`) | `string \| undefined` | `undefined` | Subset of `navigate select filter` — see [`docs/infra-incremental.md`](../../docs/infra-incremental.md) |
+| `searchModes` (`search-modes`) | `string \| undefined` | `undefined` | Subset of `navigate select filter` — see [`docs/infra-incremental.md`](./infra-incremental.md) |
 | `exclusivity` | `TreeExclusivity` | `'none'` | Accepted for interface compatibility, ignored |
 | `selectedNode` / `selectedNodes` | | | Same contract as `ixfx-tree-list` |
 | `focusedNode` | `TreeNode \| undefined` (read-only) | `undefined` | Current zoom node; `undefined` when showing the full tree |
@@ -174,7 +174,7 @@ All events **bubble** and are **composed**. `depth` counts from the root's child
 
 ## View state
 
-Implements the shared view-state API (`getViewState()` / `setViewState()` / `clearPendingViewState()` / `view-state-change`) — see [`docs/infra-view-state.md`](../../docs/infra-view-state.md). `kind` is `sunbursttree-list`.
+Implements the shared view-state API (`getViewState()` / `setViewState()` / `clearPendingViewState()` / `view-state-change`) — see [`docs/infra-view-state.md`](./infra-view-state.md). `kind` is `sunbursttree-list`.
 
 | Field | Type | Meaning |
 |---|---|---|

package/docs-user/titlebar.md

@@ -97,5 +97,5 @@ import type { TitlebarOrientation, TitlebarVariant, TitlebarToggleInteraction, T
 
 ## See also
 
-- [`ixfx-panel`](../panel/README.md) — Collapsible panel that composes this titlebar
-- [`ixfx-icon`](../icons/README.md) — Icon component used by the titlebar
+- [`ixfx-panel`](./panel.md) — Collapsible panel that composes this titlebar
+- [`ixfx-icon`](./icons.md) — Icon component used by the titlebar

package/docs-user/tree.md

@@ -466,7 +466,7 @@ Notes:
 ## View state (`ixfx-tree-list`)
 
 Snapshot and restore selection, expansion, keyboard cursor and scroll
-separately from the data — see [`docs/infra-view-state.md`](../../docs/infra-view-state.md)
+separately from the data — see [`docs/infra-view-state.md`](./infra-view-state.md)
 for the shared contract. `kind: 'tree-list'`; fields `selected`, `expanded`,
 `focus`, `scroll`, all keyed by `item.key`.
 
@@ -701,7 +701,7 @@ el.registry.invoke('list.search.navigate'); // or .select / .filter
 ```
 
 Limit the offered modes with the `search-modes` attribute
-(`search-modes="navigate filter"`). Full model: [`docs/infra-incremental.md`](../../docs/infra-incremental.md).
+(`search-modes="navigate filter"`). Full model: [`docs/infra-incremental.md`](./infra-incremental.md).
 
 ### Deprecated: `IncrSearchTreeController`
 

package/docs-user/treemap.md

@@ -1,12 +1,12 @@
 # Treemap
 
-`<ixfx-treemap-list>` — a nested-area (treemap) view over tree data. The zoom root fills the viewport; each node's rectangle is subdivided among its children by `valueAccessor` share. Clicking a branch zooms into it, and ancestors collapse into a breadcrumb strip. It implements the shared `TreeComponent` interface (see [`src/tree/README.md`](../tree/README.md)). See the class docs in `treemap-list.ts` for properties and events.
+`<ixfx-treemap-list>` — a nested-area (treemap) view over tree data. The zoom root fills the viewport; each node's rectangle is subdivided among its children by `valueAccessor` share. Clicking a branch zooms into it, and ancestors collapse into a breadcrumb strip. It implements the shared `TreeComponent` interface (see [`src/tree/README.md`](./tree.md)). See the class docs in `treemap-list.ts` for properties and events.
 
 ---
 
 ## View state
 
-Implements the shared view-state API (`getViewState()` / `setViewState()` / `clearPendingViewState()` / `view-state-change`) — see [`docs/infra-view-state.md`](../../docs/infra-view-state.md). `kind` is `treemap-list`.
+Implements the shared view-state API (`getViewState()` / `setViewState()` / `clearPendingViewState()` / `view-state-change`) — see [`docs/infra-view-state.md`](./infra-view-state.md). `kind` is `treemap-list`.
 
 ```typescript
 type TreemapListViewState = ViewStateBase & {

package/docs-user/twosplit-layout.md

@@ -39,7 +39,7 @@ A Lit web component that lays out two elements within a container with a split b
 
 When `--handle-size` exceeds `5px` the split bar shows the shared `dimpled` grip —
 theme it with the `--ixfx-handle-*` variables (see
-[docs/infra-handle.md](../../docs/infra-handle.md)).
+[docs/infra-handle.md](./infra-handle.md)).
 
 ### Events
 
@@ -53,7 +53,7 @@ theme it with the `--ixfx-handle-*` variables (see
 `getViewState()` / `setViewState()` snapshot and restore both sides as plain
 JSON (`kind: 'twosplit-layout'`), keyed by slot name. The component never
 persists anything itself — see
-[docs/infra-view-state.md](../../docs/infra-view-state.md) and `bindViewState()`.
+[docs/infra-view-state.md](./infra-view-state.md) and `bindViewState()`.
 
 ```ts
 split.getViewState();
@@ -211,7 +211,7 @@ ixfx-twosplit-layout {
 When `--handle-size` is greater than `5px`, a grip appears in the centre of the
 split bar — the shared `dimpled` handle (a debossed square grid), oriented along
 the split. Theme it with the `--ixfx-handle-*` variables; see
-[docs/infra-handle.md](../../docs/infra-handle.md).
+[docs/infra-handle.md](./infra-handle.md).
 
 ```css
 ixfx-twosplit-layout {

package/docs-user/user-selection-intents.md

@@ -49,7 +49,7 @@ list.addEventListener('list-select-intent', (e) => {
 - **Cursor and anchor keep moving when cancelled.** They are view state, not selection; the next `extend` still has its `anchorKey`.
 - **Who fires it.** Gestures (click, Space, Enter, double-click, checkbox, Shift+Arrow, Cmd/Ctrl+A, marquee, Escape, click on empty space) and `selectAll()`. The imperative `select()` / `selectKeys()` / `clearSelection()` family never fires it, so applying your decision through them cannot re-enter your handler.
 - **`manual` mode.** The intent is reported and nothing else happens, so the caller never re-implements modifier handling. (`ixfx-data-grid` keeps Space toggling in `manual`, as before.)
-- **Not covered.** Right-click auto-select and the drag-origin auto-select of native drag-out still apply directly. `ixfx-miller-list` reports click / checkbox / Shift+Arrow; it has no select-all, and Escape navigates rather than clears. In `checked` mode a miller checkbox intent is for the node only; the descendant cascade is the caller's decision.
+- **Not covered.** Right-click auto-select and the drag-origin auto-select of native drag-out still apply directly. `ixfx-miller-list` reports click / checkbox / Shift+Arrow; it has no select-all, and Escape navigates rather than clears.
 
 ## `list-select` (consistent)
 
@@ -73,7 +73,7 @@ list.partialKeys = ['k1', 'k2'];   // ReadonlySet<string> getter; replace-on-set
 - Light-DOM lists (vertical, detail): `data-partial` on the row; grid-list cell and data-grid row: `data-partial` plus `.partial` (`part="item partial"` on grid-list); miller: `.partial`.
 - Accessibility: in `checked` mode the checkbox is indeterminate with `aria-checked="mixed"`; otherwise the row gets `aria-description="Partially selected"` (an author-set `aria-description` is never overwritten).
 - Style hooks: `--item-bg-partial`, `--item-border-partial` (`--grid-list-partial-outline` on grid-list).
-- `ixfx-flat-list` forwards `partialKeys` to its inner list. Miller's `checked` mode still derives indeterminate from loaded descendants; `partialKeys` overrides that for the keys you set.
+- `ixfx-flat-list` forwards `partialKeys` to its inner list. In `checked` mode (tree-list and miller-list alike) indeterminate comes from loaded descendants or `partialKeys`, whichever says so.
 
 ## Selected keys that aren't loaded yet
 
@@ -83,4 +83,4 @@ list.partialKeys = ['k1', 'k2'];   // ReadonlySet<string> getter; replace-on-set
 
 - **`ixfx-tree-list`** — also fires `list-select` next to `select`. `partialKeys` combines with the checkbox state derived from loaded descendants: indeterminate if either says so; selected wins.
 - **`ixfx-multicol-list`** — the intent is re-fired on the host with `columnId`; the "All" row is a `clear`. `partialKeys` applies to every column with a matching item key; `setColumnPartialKeys(columnId, keys)` targets one column.
-- **`ixfx-miller-list`** — see above; `checked` mode checkbox intents are for the node only.
+- **`ixfx-miller-list`** — same contract as the tree: a branch checkbox is one `toggle` with `descendants: true` and `checked`, `keys` = the node and its loaded descendants; `partialKeys` combines with the derived checkbox state (indeterminate if either says so; selected wins).

package/docs-user/user-theming.md

@@ -482,7 +482,7 @@ If you're upgrading from previous versions:
 
 For implementation details, see:
 - [`docs/infra-theming.md`](infra-theming.md) - Internal theming specification
-- [`docs-user/icons.md`](/docs-user/icons.md) - Full icon registry reference
+- [`docs-user/icons.md`](./icons.md) - Full icon registry reference
 - [`demo/loader.html?demo=icons`](/demo/loader.html?demo=icons) - Interactive icons demo
 - [`src/style.css`] - Base theme definitions
 - [`demo/shared/`] - Example theme implementations

package/docs-user/vertical-list.md

@@ -620,7 +620,7 @@ The element must be focused (click it or tab to it) before keyboard navigation w
 
 ## Incremental search
 
-A built-in type-ahead popover with three modes — **navigate** (cursor jumps to the best match, ↑/↓ cycle), **select** (matches become the selection), **filter** (non-matches hidden). See [`docs/infra-incremental.md`](../../docs/infra-incremental.md) for the full model, conversions between modes, and the `search-modes` attribute.
+A built-in type-ahead popover with three modes — **navigate** (cursor jumps to the best match, ↑/↓ cycle), **select** (matches become the selection), **filter** (non-matches hidden). See [`docs/infra-incremental.md`](./infra-incremental.md) for the full model, conversions between modes, and the `search-modes` attribute.
 
 There is **no default shortcut**. Open it by invoking one of the commands on `list.registry`:
 
@@ -701,7 +701,7 @@ The event is cancelable: call `preventDefault()` to suppress the browser's nativ
 
 Rename is **opt-in**: set `editValidator = (value, key) => boolean` first. Without it `beginEdit` returns `false` and rows stay plain text. The validator runs on commit; returning `false` rejects the text and the edit ends as a cancel.
 
-`list.beginEdit(key)` swaps an [`ixfx-editable-label`](../editable-label/README.md) into the row, selects its text and focuses it. It returns `false` if there is no `editValidator`, or the row is unknown or not rendered.
+`list.beginEdit(key)` swaps an [`ixfx-editable-label`](./editable-label.md) into the row, selects its text and focuses it. It returns `false` if there is no `editValidator`, or the row is unknown or not rendered.
 
 The editor replaces the row's `[data-edit-label]` element, or the whole row if there is none. Mark the text element in rows that carry icons or badges, and set `data-edit-value` there if the editable text differs from its content.
 

package/llms.txt

@@ -73,7 +73,12 @@ import '@ixfx/components/data-grid';
 - [xy-pad](docs-user/xy-pad.md): A 2D touch-friendly XY pad for controlling two parameters simultaneously. Each axis supports independent linear/logarithmic scaling.
 
 ## Overviews
+- [infra-handle.md](docs-user/infra-handle.md)
+- [infra-incremental.md](docs-user/infra-incremental.md)
+- [infra-theming.md](docs-user/infra-theming.md)
 - [infra-tickled.md](docs-user/infra-tickled.md)
+- [infra-view-state.md](docs-user/infra-view-state.md)
+- [list-state.md](docs-user/list-state.md)
 - [user-catalog.md](docs-user/user-catalog.md)
 - [user-selection-intents.md](docs-user/user-selection-intents.md)
 - [user-theming.md](docs-user/user-theming.md)

package/package.json

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