kerfjs 5.0.0-beta.130 → 5.0.0-beta.132
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +65 -253
- package/ai/manifest.json +1 -1
- package/dist/overlay.js +2 -1
- package/dist/overlay.js.map +1 -1
- package/llms.txt +1 -3
- package/package.json +1 -1
- package/setup/common.mjs +15 -1
- package/setup/index.mjs +87 -23
package/CHANGELOG.md
CHANGED
|
@@ -8,47 +8,48 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
|
8
8
|
|
|
9
9
|
### Added
|
|
10
10
|
|
|
11
|
+
- **Disclosure `size="compact"` (KF-ND665K).** A small, quiet in-content disclosure, such as a note card's AI feedback: a 14px arrow (passed through `DisclosureArrow`'s `size`), extra-small summary type, and content that starts on the title's text column after the narrower arrow. It works with every appearance; an embedded compact summary keeps its 24px row. Use it instead of overriding `--kui-disclosure-arrow-size`, which `kerf-ui-doctor` reports as `KUI-L021`.
|
|
12
|
+
- **ColumnTrack opens at its end or on a named column (KF-QHJKA4).** `ColumnTrack` takes `start: 'start' | 'end' | { column }`, and the new `wireColumnTracks(root)` (`@kerfjs/ui/wire-column-tracks`) applies it. A timeline board whose current work is last opens at its far end, and a paged phone board opens on the column whose `data-column-id` matches. The track opens there without animating, opens there again whenever `start` or its column ids change, and returns there when its width changes (a resize, a side rail opening) until the person scrolls it sideways. Apps no longer set `scrollLeft` from their own `ResizeObserver` for this.
|
|
13
|
+
- **TabBarItem names can keep their tail when they truncate (KF-SDNA0Z).** `nameTruncate="start"` puts the ellipsis at the start, keeping a name's tail visible. `nameTruncate="middle"` keeps the start and the last path segment (or the suffix `nameTruncateKeep` names), so tabs whose names differ only at the end, such as two runs of one release train, stay distinguishable at a capped width. The tab still shrinks before its strip scrolls, the full name is the tab's accessible name, and `wireTabBars` shows it as the `title` while it is truncated. The middle split is shared with `Text truncate="middle"`.
|
|
11
14
|
- **RadioGroup preview tiles in the design templates and Sketch Library (KF-1M9SJA).** The `radio-group` SVG design templates gain a Preview Tiles variant, a selected and an unselected tile with a hint, and `Kerf-UI.sketch` gains its editable light and dark Symbols (328 Symbols for 115 variants). Existing Symbol, Text and Color Variable IDs are unchanged, so linked instances sync with their overrides.
|
|
12
15
|
|
|
13
16
|
### Fixed
|
|
14
17
|
|
|
15
|
-
- **
|
|
16
|
-
- **A
|
|
18
|
+
- **Kerf UI keeps its geometry with Web Awesome 3.15 (KF-Y25K9Z).** Web Awesome 3.15 widened a checkbox group's default gap to 0.75em and added a top padding to every open `<details>` content box in `native.css`. The Web Awesome bridge now keeps stacked checkboxes 8px apart (the 28px pitch a Checkbox List shares), and a Disclosure's content box adds no padding of its own, so its content stays on the title's text column.
|
|
19
|
+
- **A ToolbarControlGroup in a surface's `headerActions` passes composition checks (KF-SMTCPZ).** The documented Reattach control in a persistent PinnablePopoverSurface (and the catalog's own surface demos) put a ToolbarControlGroup in `headerActions`, which `KUI-L201` rejected. A composition parent can now name one prop of a component (`@kerfjs/ui:surface-scaffold#headerActions`), and ToolbarControlGroup lists that prop, so it is accepted there but still reported in a surface's body or other props.
|
|
20
|
+
- **A persistent PinnablePopoverSurface no longer says moving it pins it (KF-4T907F).** With `pinnable={false}`, the title handle's default `moveDescription` drops "Moving it pins it.", which was wrong for a surface that is always pinned and has no Pin toggle. A pinnable surface keeps the full sentence.
|
|
21
|
+
- **A tooltip or popover re-hosted above a later modal `<dialog>` stays where it was (KF-F7H5FJ).** Moving an already-showing non-native surface into the top layer cleared all four insets, which wiped its anchored `top`/`left`, so it briefly sat at its static position until a size change repositioned it. The move now neutralizes only the sides the surface was never positioned on.
|
|
22
|
+
- **`kerfjs setup` is idempotent in a nested package of a repository that is not a workspace (KF-G54HNG).** Setup no longer creates a package `prettier.config.mjs` when Prettier already resolves a config from an ancestor up to the git repository root (a config file or a `package.json` `prettier` key), which shadowed the root's options; when it does propose one, `--resolve prettier.config.mjs=skip` declines it for good. JSON files setup manages are planned by value, so a formatter's layout no longer makes every rerun report `UPDATE .kerf-ui-profile.json`. `--guidance-source` accepts a shared `AGENTS.md` anywhere inside the enclosing repository, such as `../../AGENTS.md` from `clients/web`.
|
|
23
|
+
- **A context PopupMenu opens at its pointer point inside a transformed ancestor (KF-7PEMC6).** A context menu's invisible anchor is `position: fixed`, so an ancestor that becomes the containing block for fixed descendants (the app-height `CatalogExample` frame's identity transform, a `filter`, or `contain`) offset the menu by that ancestor's position. The menu now places itself against the viewport point it was rendered or opened with. Apps that converted `clientX`/`clientY` into the frame's coordinates as a workaround should pass them unconverted again.
|
|
24
|
+
- **RadioGroup preview tiles keep three on one row in a phone column (KF-0ZTK8A).** `presentation="tiles"` lines tiles up on an 88px basis and grows them back to 104px, so a short set shrinks to share a row down to that legible minimum before it wraps whole tiles. Three tiles now fit any column from 296px, including the 336px content column of a 390px phone, where the third tile used to wrap alone. A shrink-wrapped group still sizes to full 104px tiles.
|
|
25
|
+
- **SearchField `resultText` shows a find-in-content readout inside the field (KF-8CDT8B).** Pass a count such as "3 of 12" or "No matches". It sits between the editor and Clear in standalone and toolbar-group fields, quiet and sized to its content, and it is hidden while the field is collapsed or empty. The editor keeps at least 4rem (or a larger `--kui-search-field-editor-min-width`), so at a narrow width the readout ellipsizes, then hides, first. The readout describes the editor, and `wireSearchFields` announces it through a polite live region once it has been unchanged for half a second. The editor's description also follows a readout added to or removed from a field after it first rendered (KF-H3PNKB). The UX catalog's SearchField page has a live Find Readout example in which Enter steps to the next match.
|
|
26
|
+
- **An expanded search group no longer widens a TabBar `end` zone to its query (KF-X9A8X9).** In a content-sized zone, the search group's `min(--kui-search-field-expanded-width, 100%)` width was ignored when the zone sized itself, so a long query on one line set the zone's width and squeezed the tab strip, even though the field itself stayed capped. The group's maximum width is now the token itself, which bounds its size there. Fill and grow search groups keep their full-line maximum.
|
|
27
|
+
- **TabBar `snapTabs` keeps its end room through application re-renders (KF-NNSAT8).** `wireTabBars` stores the room after the last tab in the strip's inline style, which TabBar never renders, so a re-render that morphed the strip removed it. A strip scrolled into the room then clamped and the tabs jumped sideways, so a tap could land on the wrong tab. The wiring now watches each snap strip's style, puts the room back, and returns the strip to its last scroll position.
|
|
28
|
+
- **A multiline ListActionRow keeps its label, description, and status on separate lines (KF-SE5BAR).** `multiline` used to switch the label stack to a block, so the three parts ran together as one line of text ("HS2-1A long title…Done"). The stack now stays a grid aligned to the top: each part keeps its own line and wraps instead of ellipsizing, matching `ListItem multiline`. The UX catalog's multiline row now shows a description and status.
|
|
29
|
+
- **Text `truncate="start"` draws its leading ellipsis in Safari (KF-FM2NWN).** In WebKit, start-truncated text containing spaces, such as "Nightly release train …: run Q69G5FB0", was clipped at its left edge, with a stray dot drawn inside the text instead of a leading ellipsis. The run is now bracketed by invisible left-to-right marks instead of an isolating `dir="ltr"` span, which every engine ellipsizes correctly and which keeps edge punctuation in order. The `title` stays the plain text.
|
|
30
|
+
- **A visible-name TabBarItem wider than its strip is no longer clipped (KF-0M3ZPT).** A `nameOverflow="visible"` tab whose full width exceeded its `TabBar` strip was cut off at the strip's edge, with no ellipsis or title, and scrolling could not reveal the rest. Such a tab now takes the strip's width, ellipsizes its name, and `wireTabBars` gives it the full name as its `title`. A tab that fits keeps its full width and name as before.
|
|
31
|
+
- **A FramedListRow grows with content that wraps after a resize in WebKit (KF-D8VK4Y).** In Safari, a row whose `List` held an auto-fill `Grid` (or a wrapping `Row`) kept its height from before a resize when that content gained a line, so its fields spilled under the next row's divider. Rows now lay out as a column flexbox, which every engine sizes to its content. Single-child rows look the same as before: stretched across the row and centered in its 44px minimum height.
|
|
32
|
+
- **A DialogSurface reopened just as its exit motion ends stays open (KF-C0RV1G).** Browsers deliver a dialog's native `close` event as a later task. An `openDialog()` call that landed after the exit motion closed the dialog, but before that event arrived, left it closed, and the late event then cleared the reopened state. `openDialog()` now opens such a dialog afresh, and the superseded `close` event no longer reaches the application.
|
|
17
33
|
- **StateBanner accepts several action controls in the composition catalog (KF-8TF7Y8).** Its `action` already lays out one or more Buttons as a wrapping list, as the guidance says, but the catalog limited the zone to one child, so `kerf-ui-doctor` and the `kerfjs/ui-composition` lint rule reported `KUI-L203` for two Buttons in a fragment and pushed apps toward the Row wrapper the guidance forbids. The zone now accepts any number of controls; EmptyState's single action is unchanged.
|
|
18
|
-
- **The Kerf UI editor's parameter dialog reopens when a row is chosen while it closes (KF-8SPEG7).** The new choice was lost when the exit motion ended.
|
|
19
34
|
- **Kerf UI relocated toolbar groups keep keyboard focus when the relocated set changes (KF-KHTDC2).** A labeled `ToolbarControlGroup` with `relocateOnCollapse` now renders a stable `data-key` from its `label`; a `data-key` in `rootAttributes` overrides it. When groups join or leave the set a collapsed panel relocates, a focused control in an unchanged group keeps its DOM node and focus instead of dropping to `<body>`.
|
|
20
35
|
|
|
21
36
|
- **Homepage size claims (KF-60YNT1).** The homepage advertises the measured ~15 KB core bundle, and all four claims now participate in the existing bundle-size gate.
|
|
22
37
|
|
|
23
38
|
- **Dependency security (KF-3NWVZN).** Refresh vulnerable tooling, docs and example dependencies. The setup CLI retains Node 18 support through the unaffected minimatch 6 branch; contributor tooling resolves affected minimatch versions to patched 11.x. Astro stays on its patched 7.3 line to preserve the docs site's Node 22.12 floor.
|
|
24
39
|
|
|
25
|
-
- **Downstream Library previews (KF-RQJ15M).** Hosts and component catalogs can register typed Library-only samples, static schematics and icon fallbacks. Built-ins use the same extension; inert shadow thumbnails share styles and refit loaded assets, while insertion defaults and canvas rendering stay independent.
|
|
26
|
-
|
|
27
|
-
- Editor container, document and icon pickers restore the empty search placeholder and geometry after keyboard deletion, using their own SearchField wiring without duplicating play-stage helpers (KF-TBVRS4).
|
|
28
|
-
|
|
29
40
|
- Stable release CLI rejects unknown options and supports an explicit noninteractive dry-run plan without altering release state or metadata, fetching/creating tags, committing, pushing, or publishing (KF-Y9A9XE).
|
|
30
41
|
|
|
31
|
-
- **
|
|
32
|
-
|
|
33
|
-
- **Project TypeScript parameters (KF-26P9FT, KF-B8YSHV, KF-MB5FFZ, KF-AFW3ZA).** The Params rail shows compact name/type rows. A dialog provides TypeScript text entry, project symbol completion, automatic formatting and nested type navigation. The owning project compiler checks expressions, defaults and generated bindings before editor export or CLI generation; saved expressions preserve their import context.
|
|
34
|
-
|
|
35
|
-
- **Library file icons (KF-CBA2H7).** Both document layouts show decorative Lucide folder icons and extension-specific file icons, with a generic file fallback.
|
|
36
|
-
|
|
37
|
-
- **Library disclosure latency (KF-1XBJDT).** The document hierarchy stays stable across disclosure changes and TreeList offers explicit `keyedRows` reconciliation while default markup keeps nested-list composition. Divider matching excludes internal divider-free tree rows, and normal block flow avoids full-column flex layout on a branch change. The initial keyed-row plus final-icon measurement phase recorded 158–174 ms Chromium disclosure turns (about 421 ms before that optimization) and 732–814 ms in WebKit, with no pre-change WebKit baseline; these are earlier-phase figures, not final block-flow results. Same-machine rendering controls and later exact-source Linux results are recorded separately in the performance reports. CI measures the unchanged budgets once in a single-worker phase after functional tests, with exact-once test coverage and separate raw evidence; this controls benchmark workload rather than claiming another product speedup.
|
|
42
|
+
- **TreeList `keyedRows` (KF-1XBJDT).** TreeList offers explicit `keyedRows` reconciliation, so a document hierarchy stays stable across disclosure changes, while default markup keeps nested-list composition. Divider matching excludes internal divider-free tree rows, and normal block flow avoids full-column flex layout on a branch change.
|
|
38
43
|
|
|
39
|
-
- **
|
|
44
|
+
- **PinnablePopoverSurface `minHeight` (KF-GC3PRB).** A public, viewport-capped `minHeight` option keeps a resized surface's search and result rows visible.
|
|
40
45
|
|
|
41
|
-
- **
|
|
42
|
-
|
|
43
|
-
- **Library column clipping (KF-7HP7R9).** Document columns now clip at the Library surface edges while retaining row content insets. Public ColumnTrack/ColumnExplorer `inset` and PinnablePopoverSurface `bodyInset` options configure that boundary.
|
|
44
|
-
|
|
45
|
-
- **Library column headings (KF-MGAP67).** Each document column now carries its own quiet parent-folder heading; the shared path label and Back control are removed.
|
|
46
|
-
|
|
47
|
-
- **Editor Library resize (KF-EQRNAR).** Bottom-edge pointer and keyboard resizing now remembers the chosen size without pinning the Library. Header movement still pins it; transient panels keep light dismissal and restore their size after reopening or reload.
|
|
46
|
+
- **ColumnTrack/ColumnExplorer `inset` and PinnablePopoverSurface `bodyInset` (KF-7HP7R9).** These options configure the boundary where columns clip at a surface edge while rows keep their content insets.
|
|
48
47
|
|
|
49
48
|
### Removed
|
|
50
49
|
|
|
51
|
-
-
|
|
50
|
+
- **PopupMenu and Select `embedded` previews (KF-Q0S061).** `embedded` (on both) and PopupMenu `embeddedSubmenu` rendered an inert, open popup as a static preview for the removed Kerf UI editor's canvas and had no application use. They only shipped in 5.0.0 betas.
|
|
51
|
+
- **The Kerf UI editor and view-document tooling (KF-YGGEHT).** The private editor app and the `@kerfjs/ui/editor`, `@kerfjs/ui/view`, `@kerfjs/ui/view-runtime`, and `@kerfjs/ui/vite-editor` subpaths are removed, along with the `kerf-ui-view` and `kerf-ui-props` bins, `ai/view-document.schema.json`, `ai/component-props.json` (plus its overlay and schemas), the application UI profile's `props` catalog location, create-kerf-component's `props:generate` / `props:check` scripts and `component-props.json`, eslint-plugin-kerfjs's `no-generated-view-edits` rule, the composition catalog's `configTypes` and Library-preview fields, and the editor's CI jobs and Library performance workflows. They only shipped in 5.0.0 betas, so no stable release is affected.
|
|
52
|
+
- **Catalog view documents (KF-F5Y2BR, KF-4HQT01).** The UX catalog's demos and recipes are hand-written TSX again instead of `.kui.json` view documents with generated `.view.ts` modules; the rendered catalog is unchanged apart from fixing a lost `tone="quiet"` on the Foundation body-copy sample. The suite-v3 AI-regression cases edit those recipe `.tsx` files again instead of the documents.
|
|
52
53
|
- **Pinned TabBarItem support.** Removed `pinned` and its sticky/backdrop tokens and RTL compensation. Put fixed controls in TabBar's existing `leading`, `trailing`, or `end` zones outside the scrolling tablist. Ordinary tabs retain keyboard navigation, selection reveal, reordering, scroll dividers, and optional whole-tab snapping (`KF-K6GKN3`).
|
|
53
54
|
|
|
54
55
|
### Added
|
|
@@ -63,175 +64,70 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
|
63
64
|
|
|
64
65
|
- **A collapsible ListHeader can carry its section's commands (KF-X2MRCT).** A `toggle` header takes one trailing overflow button (`overflowAction`, `overflowLabel`, `overflowIcon`, optional `overflowDisabled` and `overflowTriggerAttributes` for popup metadata). It is a separate focus stop at the logical end, outside the disclosure button: the label and arrow toggle the section, and the overflow button never does.
|
|
65
66
|
|
|
66
|
-
- **Editor Documents folder layouts (KF-D4XZXG).** The Library's Documents mode now offers a folder TreeList and a paged ColumnExplorer with a remembered layout choice, keyboard navigation, and per-column parent-folder headings. File rows retain click and drag insertion.
|
|
67
67
|
- **Differential `bindList` and morph transition fuzzing (KF-YVMSEK).** Seeded mutations now compare incremental output with a fresh render across snapshot, granular, virtualized, and live-DOM protection states; directed tests cover recovery, refill, measured heights, and paired lists.
|
|
68
68
|
- **Kerf UI size, density, and inset prop vocabulary (KF-XQJECP).** Control sizes and row densities use `default` / `compact`; surface inset props use `none`, `compact`, `default`, or `comfortable` where applicable. Legacy literals remain accepted for this major version, with `KUI-L026` analyzer review findings and canonical DOM attributes. The component catalog records aliases and semantic exceptions, and its check rejects new divergent literals. `DialogSurface`'s legacy `compact` inset keeps its 8px geometry; new callers use `default` for 8px.
|
|
69
69
|
|
|
70
70
|
- **`debouncedSignal()` can be disposed (KF-EE8EPV).** It returns a `DebouncedSignal<T>`: the same read-only signal plus an idempotent `dispose()` that unsubscribes from the source and drops any pending write.
|
|
71
|
-
- **`@kerfjs/ui/view` exports one child-kind dispatch (KF-TZKGBZ).** `childKind()` / `classifyChild()` and the `ViewEachChild` / `ViewIfChild` / `ViewSlotChild` types replace hand-written `'$each' in child` chains.
|
|
72
71
|
- **`@kerfjs/ui` exports a shared `SurfacePresentation` type (KF-0MY6JQ).** The popover and pinnable presentation types are now aliases of it.
|
|
73
72
|
- **`npm create kerf-component --name <package-name>` (KF-7H7FWV).** Scoped package names are now reachable; the CLI rejects unknown flags and explains when the target is an existing file.
|
|
74
73
|
- **Kerf UI `wireTabBars` reports how each TabBar's tabs fit (KF-XFG3FZ).** A new `onFitChange(fit)` option reports `{ barId, overflowing, stripWidth, tabsWidth, free, trailingWidth, endWidth }`. It fires once per bar when the wiring first sees it, then on the next frame after any rounded value changes: a resize, an added or removed tab, or a swapped action. An app can swap a wide `end` action for a compact one while the tabs overflow without measuring TabBar's private parts. `free` is the room the tabs leave unused and is negative by the amount they overflow. Intrinsic tabs ellipsize before the strip scrolls, so `free` reaches 0 before `overflowing` turns true. The UX catalog's **Adaptive End Action** example shows the no-oscillation recipe: remember the wide action's `endWidth`, and restore it once `free` covers the difference. The new `TabBarFit` type is exported from `@kerfjs/ui/wire-tab-bars`.
|
|
75
|
-
- **
|
|
76
|
-
- **The Kerf UI editor inserts an existing document as a `#view` from a picker (KF-PX5EVZ).** With storage, Add a child's Component Select offers **Existing document…**; Add opens an **Insert Document** dialog that lists the project's other `.kui.json` documents under a filter. Choosing one reads it, puts a `#view` of it in the chosen zone with its required params seeded with example values, selects it, and renders it at once, as one undoable edit. A document that declares slots, cannot be read, or does not parse is refused with the reason. `EditorStorage` gains an optional `list()` (project-relative `.kui.json` paths); `devServerStorage(api?, listApi?)` implements it over the new `EDITOR_LIST_API`, which `@kerfjs/ui/vite-editor`'s `editorFileMiddleware` answers (`KERF_UI_EDITOR_LIST_API`, `editorDocuments(root)`: sorted, at most 5000, skipping `node_modules`, `dist`, `test-results`, and dot-folders). A storage without `list()` gets a path field instead.
|
|
77
|
-
- **The Kerf UI editor says how to switch a condition chain to kinds (KF-B0ZDE6).** On a list whose rows are picked by an `$if` chain, Row designs now shows "Rows chosen by conditions; to pick them by kind, remove designs down to one." where a one-design list offers Or pick designs by kind. The editor deliberately does not convert between the two forms: a chain reads true/false item fields and a kinds map reads one kind field, so switching changes the data the application sends (docs/26 §3.5).
|
|
78
|
-
- **A document composed into a row is keyed, and its actions are row actions (KF-RDZ7N7, KF-EP2152).** Every generated `render<Name>(inputs, slots, rowKey?)` takes an optional third argument and puts it on its root as `data-key`; a row whose template (or `$if`-chain design, or kinds-map entry) is a `#view` passes `String(<key>)`, and `interpretView` / `previewView` thread the key the same way. Before, those composed row roots had no `data-key`, so kerf `each()` matched them by position and a row action's `key` read empty. Such a document's actions now count as row actions of the composing document (its own contract keeps them view-scoped), so the composing module's handlers get the row `key`, and the editor's Extract to document no longer refuses a row design that shares the other designs' action. Composing the same document both inside and outside a row reports `KUI-V009`. The argument is not an input, so contract digests are unchanged; regenerate view modules to pick up the key.
|
|
79
|
-
- **Kerf UI `Toolbar responsive="wrap-groups"` wraps a leading zone of control groups (KF-K3TXCT).** For a toolbar whose leading zone is several `ToolbarControlGroup`s rather than a title, each leading group shares a row with the trailing zone while it fits and otherwise moves, whole, to the next row; the trailing zone stays at the inline end. Before, `wrap` kept the leading zone on one row and `stack` wrapped only the center and trailing zones, so the last leading group was clipped at a narrow width. The existing policies are unchanged. The Kerf UI editor's play bar uses it: the device options and Scale are back beside the device picker at wide widths, and still wrap whole at 390px.
|
|
80
|
-
- **Play mode wires the rest of a composed document's controls (KF-HBRKFH).** Inside a `#view`'s document in the Kerf UI editor's play mode, a Combobox, ColorField, ColorPicker, or TagField change, a ResizableRegion or SplitView list resize, and a TabBar reorder now reach that document's play copy (or the row it sits in). Each composed SplitView follows the device into `compact`, and each composed NavStack starts at its root view. A repeated tab in a composed document closes out of the param its items come from, through the `#view`'s `$param` props to a top param, or by changing a literal (or unset) prop on the `#view` that holds it. A repeated `#view`'s structural state is still shared by its rows.
|
|
81
|
-
- **Play mode wires controlled components inside composed documents (KF-58917B).** In the Kerf UI editor's play mode, a Switch, TabBar, TabNavigator, NavStack, or other controlled component inside a `#view`'s document now responds. Each composed node plays with a composed id (its `#view`'s id and its own), each `#view` keeps a play copy of its document, and a row `#view` passes its row keys so per-row state stays in its row. A value change goes where the value comes from: through a `$param` to the `#view`'s prop, then to a param, the `#view`'s literal prop, or (for a repeated `#view`'s `$bind`) its row item's field. Anything it cannot trace stays on the node for its row. The pure parts are `ui/src/editor/model/play-views.ts`.
|
|
82
|
-
- **The Kerf UI editor shows and plays `PinnablePopoverSurface` (KF-ZWG0B2).** Like `PopoverDialogSurface`, it shows embedded on the edit canvas (header, Pin, Close, and content, all selectable) instead of as a closed top-layer popover, and the Components grid gives it its own sketch. In play mode it is wired with `wirePinnablePopover`, so it opens below its trigger, light-dismisses while transient, and pins, moves, and resizes; a `pinned` prop starts it pinned.
|
|
83
|
-
- **Play mode renders composed documents (KF-85SCQD).** In the Kerf UI editor's play mode, a `#view` (such as an `$each` row that is its own row document) played as a "cannot render" placeholder, because the play stage has no storage. The editor now sends the composed documents it loaded with the document it plays, so the stage renders the rows as the canvas does, and a row document's actions reach the host's play handlers and the action log, named as their `#view`.
|
|
84
|
-
- **Kerf UI editor: reorder row designs (KF-STBQBG).** A selected row design in the Repeat section's Row designs moves with Move design earlier and Move design later. In an `$if` chain a design's condition moves with it and the last design, the `else` for every other item, stays last; in a list keyed by kind any design moves, which changes only the map's order. The model edits are `moveRowDesign` and `rowDesignMoves` in the editor's `model/row-designs.ts`.
|
|
85
|
-
- **Smarter drop targeting in the Kerf UI editor (KF-WKABP2).** Dragging over a Workbench or SplitView shows each zone that would take the drag as a region where it renders (a Workbench's left and right rails, header, main, footer, and bottom drawer), and the region under the pointer is where the drop goes: dropping a NavStack on a new Workbench's left side now fills its left rail instead of always landing in the main header. A node alone in a one-child zone can be replaced by a drop ("Replace Main"); a seeded placeholder is replaced at once, authored content after a confirmation, and Undo restores it. A drop made with Option (Alt) held, or one inside a container with several zones and no main one, opens a menu listing every place it can go.
|
|
86
|
-
- **Kerf UI view documents: a row design per item (KF-8J8E5V).** An `$each` template may now be an `$if` chain, `{ "$if": <boolean>, "then": <node>, "else": <node or another chain> }`, so a list can render a section header row for some items and an item row for others. Each branch is one keyable node with a `data-*` channel, and `else` is required, so every item yields exactly one row. The condition resolves in the item's scope. `generateView` writes `each(items, (item) => (cond ? A : B), { key })`, `interpretView` and `previewView` render the same branch, and a named node in any branch is a keyed ref that returns `null` for a row that took another branch. `validateView` reports a chain without `else`, a branch that is not one node, and a branch with no `data-*` channel as `KUI-V008`. The view-document schema accepts the chain, and `ViewTemplate` / `ViewTemplateChain` are exported types. Documents that do not use a chain generate byte-identical modules. Authoring a chain in the Kerf UI editor follows in KF-1CRGP1.
|
|
74
|
+
- **Kerf UI `Toolbar responsive="wrap-groups"` wraps a leading zone of control groups (KF-K3TXCT).** For a toolbar whose leading zone is several `ToolbarControlGroup`s rather than a title, each leading group shares a row with the trailing zone while it fits and otherwise moves, whole, to the next row; the trailing zone stays at the inline end. Before, `wrap` kept the leading zone on one row and `stack` wrapped only the center and trailing zones, so the last leading group was clipped at a narrow width. The existing policies are unchanged.
|
|
87
75
|
- **Kerf UI `PinnablePopoverSurface`: a non-modal panel the person can pin and move (KF-C57ZX0).** `@kerfjs/ui/surface-scaffold` adds `PinnablePopoverSurface` with `wirePinnablePopover(surface, { anchor?, pinned?, placement?, step?, largeStep?, onChange? })`, `pinPopover(surface, pinned?)`, and `isPopoverPinned(surface)`. It opens transient below its `popoverTarget` control and closes on Escape or a press outside. Pinned by its header Pin toggle (`aria-pressed`) or `pinPopover`, it stays open while the page is used, drags by its title, moves with the arrow keys on the focused title (Shift moves farther), resizes from its corner, and stays inside the viewport gutter after a window resize, returning to where the person put it when there is room. Moving a transient surface pins it. `onChange` reports `{ pinned, placement, reason }` for the application to store, and the `pinned` and `placement` options restore it. The controller keeps its state across application re-renders. It takes `PopoverDialogSurface`'s geometry props and an `embedded` presentation. The Surface Scaffolds demo's Pinnable Popover example shows the transient, pinned, moved, and restored states. The UI skill is now 1.74.0.
|
|
88
|
-
- **The Kerf UI editor extracts a subtree into a document of its own (KF-D9P3NP).** **Extract to › New document…** in the Flow area (also **Extract to Document…** in the node context menu) asks for the new document's path in a Save As–style dialog, suggesting one beside the current document, then writes a document whose root is the selected node (a repeated row, one row design of an `$if` chain or kinds map, or any other subtree) and puts a `#view` of it in its place. Every `$param` and `$bind` the subtree reads becomes one of the new document's params, typed from the source (a row's `message.subject` becomes a string param `subject`), and the `#view` passes the values back. One Undo restores the subtree; the new file stays. It is disabled, with the reason, on the root, on a subtree holding a slot, and without storage, and refused when the result would add a problem.
|
|
89
|
-
- **The Kerf UI editor renders and inspects composed documents (KF-5N26H6).** A `#view` node, such as an `$each` row that is its own row document, now loads its document through the editor's storage (resolving `src` from the composing document's folder, as `kerf-ui-view` does) and renders it in place on the canvas; a click anywhere in it selects the `#view`. Problems validate against the loaded document, so a missing required param or a prop of the wrong type is `KUI-V012` on its field, and a document that cannot load says why (no storage, still loading, no such file, or unreadable). The Inspector edits a `#view`'s props as that document's params, with the same fields and **Bind a prop** sources as any prop (a row's `message.subject`, offered only when its type fits). **Open document** opens the composed document, saving the composing one first, and **Back to <file>** in the canvas toolbar returns to it with the `#view` selected. Export and Compare generate a composing document's module with its composed documents. Inserting a `#view` from a picker comes next.
|
|
90
|
-
- **Kerf UI view documents: row designs keyed by item kind (KF-YX6HMT).** An `$each` may carry `"templates": { "<kind>": <node>, … }` and `"kind": <string value>` instead of `template`, so each item's `kind` picks its row design, like Interface Builder's prototype cells. A `default` entry is required and takes every other kind, so a repeat never filters. `validateView` reports, as `KUI-V008`, an `$each` with both `template` and `templates`, a map without `default`, a missing or stray `kind`, and an entry that is not one keyable node. `generateView` compares the kind per row and exports `type <Name><As>Kind`; the contract gains a `kinds` member only for documents that use a map (other digests are unchanged), and `diffContracts` reports a removed kind as breaking and an added one as not. `interpretView` and `previewView` pick the same template, the schema accepts the map, and `ViewChild`'s `$each` gains the `templates`/`kind` variant. In the editor, a one-design list can pick its designs by kind, then add, rename, and remove kinds in Row designs. The view bundle budgets rise to 13000 B (`interpretView`, 12915 measured) and 9450 B (`validateView`, 9364 measured).
|
|
91
|
-
- **Kerf UI editor: row designs (KF-1CRGP1).** A repeated node's Inspector has a Row designs section that authors an `$if`-chain template: Add a row design picks a component and a true/false param or item field, and the new design shows for those items while the last design keeps every other item. A selected design changes when it shows or is removed; a chain left with one design becomes a plain template. The outline lists each design with `if …`, `else if …`, or `otherwise`, the canvas renders each item's design, and play mode keeps row state and logs row actions for rows of any design. `ViewChild`'s `$each` `template` is now typed `ViewTemplate`, so TypeScript code that reads `child.template.id` narrows it first.
|
|
92
76
|
- **Kerf UI's no-network guarantee is tested and documented (KF-WK5DEF).** No Kerf UI component requests anything at runtime: icons are bundled Lucide SVG, and no component renders a Web Awesome element (4.4.1's `Select` did, so its `wa-icon` chevron fetched from Font Awesome's CDN). A browser test now loads every Kerf component's catalog demo and fails on any request off the page's origin. `ui/docs/webawesome-theme.md`, `ui/llms.txt`, and the UI skill (1.73.0) say so, and tell an application that renders Web Awesome elements itself to register a local icon library.
|
|
93
|
-
- **A grid view for the Kerf UI editor's Components palette (KF-JC7WTW).** A List/Grid control beside the Components filter switches the palette to tiles, and the editor remembers the choice per browser. Each tile shows its component as it would be added, rendered live and scaled into the tile: a Switch looks like a switch. Layouts, dialogs, and arrangement primitives (Workbench, SplitView, NavStack, DialogSurface, Grid, Spacer, and others) show a simplified sketch of their arrangement instead, since they render almost nothing when added empty. Tiles select, filter, and drag onto the canvas or the Outline like rows.
|
|
94
77
|
- **Kerf UI `Gauge` (KF-Y0XT2R).** `@kerfjs/ui/gauge` is a speedometer-style dial for a live rate or level read at a glance: a 240-degree track, a fill, and a needle scaled to `max`, as a named `role="meter"`. `variant="full"` (88px by default) adds ticks and the value and `unit` inside the dial; `variant="bare"` (40px) is the arc, fill, and needle at chip height with a hover title. Values above `max` pin the needle while the text shows the real value. `tone` colors the fill, `size` takes a `CssLength`, and `colors` takes typed `CssColor` values for a consumer palette. The needle and fill animate only on a value change and hold still under reduced motion.
|
|
95
78
|
- **Kerf UI `SegmentedControl` choice count badges (KF-170258).** A `SegmentedControlChoice` takes `badge` (a count, short text, or `true` for a dot), `badgeTone` (default `danger`), and `badgeMax` (default 99, so 128 shows "99+"), the same contract as `ToolbarButton`, so a toolbar view switcher can show a live count without app CSS or giving up its exclusive selection. A count of 0 or empty text shows nothing, and a loading `placeholder` shows no badge. The badge is `aria-hidden`; name the count in the choice's `label` and `title`. Kerf seats it on the segment's top edge over its icon and rings it in the segment's current fill (at rest, hover, or selected), and it never leaves the segment, so neither a toolbar nor a filled track clips it.
|
|
96
|
-
- **Kerf UI `ToolbarButton` count badges (KF-HDQTVV).** A ToolbarControlGroup button takes `badge` (a count, short text, or `true` for a dot), `badgeTone` (default `danger`), and `badgeMax` (default 99, so 128 shows "99+"). A count of 0 or empty text shows no badge. Kerf owns the pill's placement just over the icon's top-trailing corner, a 2px ring against the group's surface (the page surface for a borderless group), and 16px sizing at both group sizes, so apps no longer position a `Badge` with their own CSS. A Toolbar zone holding one stops clipping it, because WebKit cut its top off flat. The badge is `aria-hidden`, so the caller names the count in `ariaLabel` and `title` ("Workers, 2 live").
|
|
97
|
-
- **Kerf UI `SummaryRow` `action` (KF-YT6A0N).** A SummaryRow option takes an `action` prop, rendered as `data-action`, as ContentItem and ListItem do. A
|
|
98
|
-
- **
|
|
99
|
-
- **Kerf UI `PagedView` `pageLabel` localizes the page dots (KF-QSWJGQ).** Each dot's accessible name was fixed English ("Page 2 of 3: <label>"). `pageLabel` is a template string that fills `{index}` (1-based), `{count}`, and `{label}`, such as `pageLabel="Seite {index} von {count}: {label}"`; the default `Page {index} of {count}: {label}` is unchanged. It is a plain string, so the Kerf UI editor can author it. A placeholder inside a page label is spoken as written.
|
|
79
|
+
- **Kerf UI `ToolbarButton` count badges (KF-HDQTVV).** A ToolbarControlGroup button takes `badge` (a count, short text, or `true` for a dot), `badgeTone` (default `danger`), and `badgeMax` (default 99, so 128 shows "99+"). A count of 0 or empty text shows no badge. Kerf owns the pill's placement just over the icon's top-trailing corner, a 2px ring against the group's surface (the page surface for a borderless group), and 16px sizing at both group sizes, so apps no longer position a `Badge` with their own CSS. A Toolbar zone holding one stops clipping it, because WebKit cut its top off flat. The badge is `aria-hidden`, so the caller names the count in `ariaLabel` and `title` ("Workers, 2 live"). The ToolbarControlGroup demo's Corner Count example shows 0, 2, 99+, and a dot at default and compact sizes.
|
|
80
|
+
- **Kerf UI `SummaryRow` `action` (KF-YT6A0N).** A SummaryRow option takes an `action` prop, rendered as `data-action`, as ContentItem and ListItem do. A `data-action` in `rootAttributes` still works; `action` wins when both are set. Group rows (`semanticRole="group"`) take no `action`.
|
|
81
|
+
- **Kerf UI `PagedView` `pageLabel` localizes the page dots (KF-QSWJGQ).** Each dot's accessible name was fixed English ("Page 2 of 3: <label>"). `pageLabel` is a template string that fills `{index}` (1-based), `{count}`, and `{label}`, such as `pageLabel="Seite {index} von {count}: {label}"`; the default `Page {index} of {count}: {label}` is unchanged. A placeholder inside a page label is spoken as written.
|
|
100
82
|
- **A Kerf UI `PagedView` (KF-0QJ2K3).** `PagedView` (`@kerfjs/ui/paged-view`) pages a sidebar or panel region horizontally between full-size panes, with compact page dots floating in a chrome-material pill at the bottom; page content scrolls beneath the dots and ends clear of them. Touch swipes and trackpad scrolls snap to a page, and the dots work by click and by Left, Right, Home, and End. `wirePagedViews(root, { onPageChange })` (`@kerfjs/ui/wire-paged-views`) reports the chosen page id so the app can own and persist `page`, and scrolls to whatever page a render shows, smoothly unless reduced motion is preferred. The dots are a tablist named "Page 2 of 3: <label>", and off-screen pages are inert.
|
|
101
83
|
- **Kerf UI single-select listboxes get the listbox keyboard (KF-3WS7RR).** A `List selectionMode="single"` listbox is now one Tab stop with Kerf-owned movement, matching the multi-select grid. The new `wireSummaryRows(root)` (`@kerfjs/ui/wire-summary-rows`) handles `SummaryRow` options and `wireContentItems` handles `ContentItem selectionMode="single"` options. The roving `tabindex` sits on the last focused option, else the selected one, else the first, and survives re-renders. Up/Down/Home/End move focus without selecting. Enter or Space selects the focused option by dispatching its click (Space on release, carrying the key's Shift, Ctrl, and Cmd state), so the app's delegated `data-action` handler still owns the selection. Apps can always override a key, in listboxes and grids alike: Kerf skips a key event that is already `defaultPrevented`, so handling the key first (on the option, in the capture phase, or from a listener added to the root before wiring) and calling `preventDefault()` replaces Kerf's movement or activation. The UX catalog wires `wireSummaryRows`. Its SummaryRow and ContentItem listboxes are now one Tab stop each.
|
|
102
|
-
- **
|
|
103
|
-
- **Kerf UI
|
|
104
|
-
- **
|
|
105
|
-
- **
|
|
106
|
-
- **Kerf UI view documents: `$param` / `$bind` inside list and object values (KF-3QEZFB).** A field inside a prop value, such as a ContentItem's `media.src`, can hold a document param or an `$each` item field, checked against that field's type, so app data sits beside fields the document builds (`media.overlay`). `interpretView` and generated code read it in place. The editor's object form gains **Bind a field**, which binds one scalar field or promotes its literal to a param with that literal as the default.
|
|
107
|
-
- **Kerf UI `List` `landmark="region"` and `ColumnTrack` `ariaLabel` (KF-CW7Z38).** `List landmark="region" ariaLabel="…"` renders a named `role="region"` (a reader, a result picker, a board column) and owns its `role` and `aria-label` over `rootAttributes`; TypeScript requires the name and rejects combining `landmark` with `selectionMode`, and the props catalog records both, so a view document with an unnamed landmark fails validation (`KUI-V004`). `ColumnTrack ariaLabel` names the board's scroller as a `role="region"`, as `SunkenPanel` does; a bare `aria-label` in its `rootAttributes` named a role-less `div` and was not exposed. `ListLandmark` is exported. The List › Document Inset, Result Picker, and List View Transitions demos and both ColumnTrack boards use the props instead of a `role` in `rootAttributes`, and the editor builds Document Inset, Result Picker, and both boards. Text › Read-Only Field Preview (a group named by its label's id) stays unbuilt pending KF-P9NV94.
|
|
108
|
-
- **Kerf UI `List` `selectionMode="single"`: a labeled listbox (KF-MN7QK5).** `List selectionMode="single" ariaLabel="…"` renders `role="listbox"` with that name, for `SummaryRow` options and `ContentItem selectionMode="single"` options, the way `selectionMode="multiple"` renders a multi-select grid; the app no longer wraps rows in its own `<div role="listbox">`. The options keep their Tab stop, `aria-selected`, and Enter/Space activation; the app still owns the selection and any arrow-key movement. TypeScript now requires `ariaLabel` whenever `selectionMode` is set (`ListSelectionMode` is exported), and the props catalog records it, so a view document with a selectable List and no name fails validation (`KUI-V004`). The SummaryRow, Grid › Selectable Document Tiles, and Text › Presentation Roles demos compose `Text variant="span" weight="strong"` instead of raw `<strong>`, and the editor builds all five examples.
|
|
109
|
-
- **Kerf UI `Pane` `scrollAnchoring`; the editor Inspector no longer jumps in Safari (KF-NV427Y).** `scrollAnchoring="none"` opts a Pane's scrolling content out of the browser's scroll anchoring (`overflow-anchor: none`); the default `auto` keeps it. `PaneConfig` forwards it through Workbench panes, CollapsiblePanel, and NavStack views. The editor's Inspector views opt out, because Safari applied a stale anchoring jump to the Inspector about 300ms after an edit inserted a row, when the autosave status reflowed another pane.
|
|
84
|
+
- **Kerf UI: `List landmark="group"` and `labelledBy` (KF-P9NV94).** A List can now be a named `role="group"` as well as a `region`, and a landmark List can take its name from a visible label with `labelledBy` (its id, rendered as `aria-labelledby`) instead of `ariaLabel`, never both. A read-only field preview grouped under its `FieldLabel` no longer needs a raw `<div role="group" aria-labelledby>`; the Text › Read-Only Field Preview demo uses it.
|
|
85
|
+
- **Kerf UI `List` `landmark="region"` and `ColumnTrack` `ariaLabel` (KF-CW7Z38).** `List landmark="region" ariaLabel="…"` renders a named `role="region"` (a reader, a result picker, a board column) and owns its `role` and `aria-label` over `rootAttributes`; TypeScript requires the name and rejects combining `landmark` with `selectionMode`. `ColumnTrack ariaLabel` names the board's scroller as a `role="region"`, as `SunkenPanel` does; a bare `aria-label` in its `rootAttributes` named a role-less `div` and was not exposed. `ListLandmark` is exported. The List › Document Inset, Result Picker, and List View Transitions demos and both ColumnTrack boards use the props instead of a `role` in `rootAttributes`.
|
|
86
|
+
- **Kerf UI `List` `selectionMode="single"`: a labeled listbox (KF-MN7QK5).** `List selectionMode="single" ariaLabel="…"` renders `role="listbox"` with that name, for `SummaryRow` options and `ContentItem selectionMode="single"` options, the way `selectionMode="multiple"` renders a multi-select grid; the app no longer wraps rows in its own `<div role="listbox">`. The options keep their Tab stop, `aria-selected`, and Enter/Space activation; the app still owns the selection and any arrow-key movement. TypeScript now requires `ariaLabel` whenever `selectionMode` is set (`ListSelectionMode` is exported). The SummaryRow, Grid › Selectable Document Tiles, and Text › Presentation Roles demos compose `Text variant="span" weight="strong"` instead of raw `<strong>`.
|
|
87
|
+
- **Kerf UI `Pane` `scrollAnchoring` (KF-NV427Y).** `scrollAnchoring="none"` opts a Pane's scrolling content out of the browser's scroll anchoring (`overflow-anchor: none`); the default `auto` keeps it. `PaneConfig` forwards it through Workbench panes, CollapsiblePanel, and NavStack views. Opt out where Safari would otherwise apply a stale anchoring jump after an edit inserts content while another pane reflows.
|
|
110
88
|
- **Docs: the Worker recipe cancels, disposes, and pools (KF-E6ER9X).** The `kerfjs/async` "heavy app compute in a Worker" recipe is now a `createCompute(spawn, init)` client: a `resource()` run's `AbortSignal` terminates a running job's worker, and the next call starts a fresh one and reloads its resident data through `init`; `dispose()` terminates and rejects pending and later calls, registered on a `kerfjs/scope`; and a short pool snippet sends each call to the least busy worker. No `kerfjs/worker` subpath ships (`docs/27-worker.md`).
|
|
111
89
|
- **Docs: the Worker recipe's `call()` no longer hangs on a failed worker (KF-CP3SZV).** The `kerfjs/async` "heavy app compute in a Worker" recipe now handles the worker's `error` and `messageerror` events: a worker that fails to load or crashes rejects every pending call, and later calls reject at once instead of waiting forever.
|
|
112
|
-
- **Kerf UI
|
|
113
|
-
- **Editor: the Inspector hides preview-only popup props (KF-TGGSHZ).** PopupMenu `embedded` / `embeddedSubmenu` and Select `embedded` exist for the canvas preview, which sets them itself; authored in a view they would make the app's popup inert, so the props catalog marks them `hidden`. A dialog's `embedded` presentation stays authorable.
|
|
114
|
-
- **Kerf UI `FieldLabel` declares `id` (KF-Q70Q9Y).** `id` was only a pass-through native attribute, so the editor could not author the id a group's `labelledBy` names. It is now a declared prop in the props catalog.
|
|
115
|
-
- **Editor: an object's required switches write `false` (KF-VQTDYG).** Filling in an object prop in the Inspector (a DialogSurface `stack`) now writes `false` for each required boolean whose switch shows off, so the document is valid without turning each switch on and off.
|
|
116
|
-
- **View validation places a ListDetailDialog's toolbar controls in their Toolbar (KF-WBH5P2).** A composition entry's `configTypes` can name one field of a config type (`ListDetailDialogList.toolbar`, `ListDetailDialogDetail.actions`), so a ToolbarControlGroup in a ListDetailDialog's list toolbar or detail actions no longer fails `KUI-L201`, while the column's `content` and `footer` keep their own placement rules.
|
|
117
|
-
- **Kerf UI `PopupMenu` `embeddedSubmenu`; the editor canvas shows the submenu being edited (KF-M2FGPQ).** With `embedded`, `embeddedSubmenu` (a path of `items` indices, one per level) also shows that submenu open, in the document and inert. It sits beside its item with its first row level with the item, as the register places a real one, on the start side for an end-aligned menu, and below its parent menu at phone widths. The item takes its open-submenu fill. While the Inspector edits a place inside a PopupMenu item's `submenu` (`items.2.submenu…`), the edit canvas shows that submenu open. The document, the Inspector, and the export are unchanged. The UX catalog's Embedded Preview menu shows a Group By submenu.
|
|
118
|
-
- **An embedded Kerf UI `PopupMenu` or `Select` keeps no focus fill, and a Select's listbox sits on its control (KF-HVJDWF).** An embedded popup's rows take no focus: a menu's items render as static rows instead of buttons, and a Select's choices and listbox drop their `tabindex`. A click on a row no longer leaves the current-row fill, which looked like a stuck hover or a choice, and on the editor canvas the click still selects the PopupMenu or Select. An embedded Select's listbox now hangs right below the control, over its `hint`, as the real listbox does. The UX catalog's Embedded Preview Select shows a hint.
|
|
119
|
-
- **Kerf UI `PopupMenu` and `Select` `embedded`; the editor canvas shows a selected one open (KF-KN9CPE).** `embedded` renders the popup open at its trigger, in the document instead of the top layer, as a static preview: a PopupMenu's menu at its `placement` (its submenus stay closed), a Select's listbox below the control. It overlays what lies below rather than pushing it aside, so a trigger in a toolbar group keeps its place, and a toolbar's leading zone stops clipping while it holds one. An embedded popup is inert: the registers leave it alone, so its trigger opens nothing and its rows choose nothing, and a menu's items render without their `data-action`. The editor's edit canvas shows the selected PopupMenu or Select embedded, so the `items` or `choices` edited in the Inspector are visible; the document, the Inspector, and the export keep the authored props, and play mode opens the real popup. The UX catalog shows each as an Embedded Preview example.
|
|
90
|
+
- **Kerf UI `FieldLabel` declares `id` (KF-Q70Q9Y).** `id` was only a pass-through native attribute; it is now a declared prop, so a group's `labelledBy` can name it.
|
|
120
91
|
- **Kerf UI `Pane` `anchorName` (KF-TBCXTR).** A Pane names its root as a CSS anchor (`anchor-name`) from a dashed ident, so an app names its main column for an anchored `PopoverDialogSurface` without CSS. `PaneConfig` forwards it through Workbench panes, panel panes, CollapsiblePanel, and NavStack views. A value that is not a dashed ident throws.
|
|
121
|
-
- **Kerf UI `PopoverDialogSurface` manual dismiss and anchored docking
|
|
92
|
+
- **Kerf UI `PopoverDialogSurface` manual dismiss and anchored docking (KF-T1V86Q).** `dismiss="manual"` renders `popover="manual"`, so Escape and a press outside leave a request open until its own controls close it. `anchorName` (a CSS dashed ident) docks the open overlay centered on the bottom edge of the element the application names with that `anchor-name`, inset by `viewportGutter`; engines without CSS anchor positioning keep the centered placement. The UX catalog's anchored request popup is now a PopoverDialogSurface instead of an app-owned element with its own CSS.
|
|
122
93
|
- **`eslint-plugin-kerfjs` flags a raw `<form>` (KF-JPE38T).** `ui-preferences` reports a native `<form>` as `KUI-L303` and points at Kerf UI's `Form` with `wireForms`, which keeps a submission from navigating the page. A `Form` rendered without `wireForms` reachable was already reported by `ui-wiring` (`KUI-L401`); that case is now pinned by a test. Kerf UI `Form` gains `labelledBy`, `ariaLabel`, and `describedBy` for a named `form` landmark, and the composer-form recipe renders a `Form` instead of a raw `<form>`.
|
|
123
94
|
- **Kerf UI Button new-tab links get `rel="noopener noreferrer"` (KF-6GBJBP).** An enabled link `Button` whose target is `_blank` (through `link` or `href` + `target`) now renders `rel="noopener noreferrer"`, matching a link `Chip`'s `external`.
|
|
124
|
-
- **Kerf UI Button link emphasis and a `link` prop (KF-RESJ2S).** `emphasis="link"` draws any `Button`, a `<button>` with an `action` or a link, as an inline text link: underlined text in its tone's link color (neutral takes `--kui-color-text-link`) at the surrounding text size, with no fill, border, padding, or control height, keeping its native role and focus ring. It cannot take `pressed`. `link` takes a URL string, a `URL`, or `{ href, target }` and renders an `<a>` that keeps the Button's emphasis; it is the preferred form of `href` + `target`, which keep working, and giving both throws. The
|
|
95
|
+
- **Kerf UI Button link emphasis and a `link` prop (KF-RESJ2S).** `emphasis="link"` draws any `Button`, a `<button>` with an `action` or a link, as an inline text link: underlined text in its tone's link color (neutral takes `--kui-color-text-link`) at the surrounding text size, with no fill, border, padding, or control height, keeping its native role and focus ring. It cannot take `pressed`. `link` takes a URL string, a `URL`, or `{ href, target }` and renders an `<a>` that keeps the Button's emphasis; it is the preferred form of `href` + `target`, which keep working, and giving both throws. The ContentItem feed-card demo's raw "Source" anchor is now a link-emphasis Button.
|
|
125
96
|
- **Router `match()` / `activeClass()` notify only the links that change (KF-5P2QAP).** A navigation used to re-evaluate every link's active check; links now share one `setSelector()` over the current path's segment prefixes, so a navigation updates the links that turned on or off and nothing else, however long the nav. Results are unchanged, including `match('/')` staying exact. The router subpath grows by 0.30 KB min+gzip.
|
|
126
97
|
- **`selector()` / `setSelector()` key signals stay current while held (KF-4TXB21).** A key signal read outside any subscriber, such as one a click handler keeps, now returns the current comparison. Before, it kept the answer it had when handed out until something subscribed. Subscribed keys still update at O(1) per change.
|
|
127
98
|
- **Opt-in selector fan-out dev warning (KF-AJ4KG6).** `enableWarnings({ selectorFanout: true })` from `kerfjs/dev` (or `KERF_DEV_WARN_SELECTOR_FANOUT=1` under Node) warns once per signal when three writes in a row each re-evaluate at least 200 `computed()`s and almost none of them (at most 2, or 2%) produce a different value — the per-row `computed(() => row.id === selected.value ? 'danger' : '')` shape that `selector()` and `setSelector()` make O(1). The message prints the write's stack. A broad update whose computeds all change stays silent, and a tick that writes two tracked signals is not attributed. Like `untrackedSignals`, it only covers signals and computeds created after the switch is on. `computed()` is now a thin kerf wrapper over signals-core's (same signature, `watched` / `unwatched` options forwarded).
|
|
128
|
-
- **A Kerf UI `TabPanel` (KF-RE1EBK).** `TabPanel` (`@kerfjs/ui/tab-panel`) renders the application-owned panel a `TabBarItem` controls: `role="tabpanel"` with `id`, `aria-labelledby` from `tabId`, `hidden`, and `busy` (`aria-busy`), plus content `children`, `className`, `slot`, and `data-*` `rootAttributes`. Pair its `id` with the tab's `panelId` and its `tabId` with the tab's `tabId`; selection stays application state, so hide every panel but the selected tab's. It adds no inset, chrome, or layout. The ApplicationTabs catalog demos now use TabPanel and nested `Text` nodes instead of raw `<section role="tabpanel">` and `<strong>` markup
|
|
129
|
-
- **A Kerf UI `Form` (KF-XX4Y95).** `Form` (`@kerfjs/ui/form`) renders a layout-neutral native form (`display: contents`, no inset or chrome) with `id`, `name`, `action`, `noValidate`, `children`, and `rootAttributes`. Its `action` is a delegated `data-action` handled on `submit` with `delegateActions(root, 'submit', table)`, not a URL; call `wireForms(root)` (`@kerfjs/ui/wire-forms`) once so a submit Button or Enter in a field never navigates the page. The
|
|
99
|
+
- **A Kerf UI `TabPanel` (KF-RE1EBK).** `TabPanel` (`@kerfjs/ui/tab-panel`) renders the application-owned panel a `TabBarItem` controls: `role="tabpanel"` with `id`, `aria-labelledby` from `tabId`, `hidden`, and `busy` (`aria-busy`), plus content `children`, `className`, `slot`, and `data-*` `rootAttributes`. Pair its `id` with the tab's `panelId` and its `tabId` with the tab's `tabId`; selection stays application state, so hide every panel but the selected tab's. It adds no inset, chrome, or layout. The ApplicationTabs catalog demos now use TabPanel and nested `Text` nodes instead of raw `<section role="tabpanel">` and `<strong>` markup.
|
|
100
|
+
- **A Kerf UI `Form` (KF-XX4Y95).** `Form` (`@kerfjs/ui/form`) renders a layout-neutral native form (`display: contents`, no inset or chrome) with `id`, `name`, `action`, `noValidate`, `children`, and `rootAttributes`. Its `action` is a delegated `data-action` handled on `submit` with `delegateActions(root, 'submit', table)`, not a URL; call `wireForms(root)` (`@kerfjs/ui/wire-forms`) once so a submit Button or Enter in a field never navigates the page. The ChoiceChips dialog demo uses it instead of a raw form.
|
|
130
101
|
- **`setSelector()` for set membership (KF-1TFHMP).** `setSelector(checked)` over a `signal<ReadonlySet<K>>` returns `(key) => ReadonlySignal<boolean>`; a write diffs the previous set against the next and notifies only the keys that were added or removed, so multi-select, expanded tree rows, or error fields stop re-evaluating every row. A new Set with the same members notifies nothing. Exported from `kerfjs`; it tree-shakes away when unused.
|
|
131
|
-
- **WorkbenchDialog and ListDetailDialog `embedded` (KF-RWJ9KD).** Both render in flow and always shown, keeping their `height`, through DialogSurface's embedded presentation
|
|
132
|
-
- **DialogSurface `presentation="embedded"
|
|
102
|
+
- **WorkbenchDialog and ListDetailDialog `embedded` (KF-RWJ9KD).** Both render in flow and always shown, keeping their `height`, through DialogSurface's embedded presentation. An embedded DialogSurface now also keeps a `height` / `maxHeight` and clips a filling body to its rounded corners as a modal does. It draws a 1px border instead of the drop shadow, which a scrolling pane clipped at its edge (KF-4RSG7D).
|
|
103
|
+
- **DialogSurface `presentation="embedded"` (KF-SYGSD0).** An embedded DialogSurface is the same panel in flow and always open, without the top layer or a backdrop; `openDialog` / `closeDialog` leave it alone and its close controls do not hide it.
|
|
133
104
|
- **`selector()` for O(1) row selection (KF-769EW2).** `selector(selectedId)` returns `(key) => ReadonlySignal<boolean>`. Bind `computed(() => isSelected(row.id).value ? 'danger' : '')` in each row: the selector subscribes to `selectedId` once and a change writes only the previous and next keys' signals, where the plain `row.id === selectedId.value` computed re-evaluated every row. Entries are released with the rows that watch them. Exported from `kerfjs`; it tree-shakes away when unused.
|
|
134
105
|
- **`resource()` fetchers can cancel superseded runs (KF-DSXXTD).** A fetcher now receives an `AbortSignal` as its second argument. It aborts when a newer `run()` supersedes the run or `reset()` is called, and never after the run has settled. Pass it to `fetch()` to close a superseded request, or terminate a Worker job; the abort rejection is dropped by the stale guard, so it never surfaces as `failed`. Existing `() => …` and `(report) => …` fetchers are unchanged.
|
|
135
106
|
- **`KUI-L024` / `KUI-L025` analyzer findings.** `kerf-ui-analyze` and `kerf-ui-doctor` report a stylesheet selector naming `.wa-light` / `.wa-dark` / `.wa-invert` / `.wa-theme-default` (use the `scheme` prop or the `.kui-*` scopes), and a `--wa-*` write that nothing reads in a package without `@awesome.me/webawesome`. Writes to the `--wa-*` values Kerf's foundation reads stay legitimate theming. `KUI-L023` also joins the diagnostic ID registry, so profile exceptions for it load (`KF-J0MCPN`).
|
|
136
107
|
- **`KUI-L302` lint finding for Web Awesome scope classes.** `eslint-plugin-kerfjs`'s `ui-preferences` rule reports `wa-light`, `wa-dark`, `wa-invert`, and `wa-theme-default` in a JSX `class` / `className` and points at the `scheme` prop or the `.kui-*` scope classes, since the Web Awesome classes do nothing without its theme. Like `KUI-L301`, it honors profile exceptions (`KF-M2F5K4`).
|
|
137
108
|
- **Kerf-owned appearance scopes.** `.kui-light`, `.kui-dark`, `.kui-invert` and `[data-kui-scheme]` set a subtree's scheme from `foundation.css`, so they work without Web Awesome. `Pane`, `ContentItem`, `NavStack`, `TabNavigator` and its tabs take a `scheme` prop for the plain palette in a fixed scheme; a `tint` implies its scheme, and a disagreeing pair throws. Tinted surfaces now render `data-kui-scheme` and `kui-<scheme>` in place of the Web Awesome `wa-<scheme>` class, which only worked when the Web Awesome bridge was loaded. The bridge re-derives Web Awesome elements inside the Kerf scopes and still honors `.wa-*` (`KF-E44H0A`).
|
|
138
|
-
- **`ListHeader controls` and `List hidden`.** A toggle header names the region it shows or hides with `controls` (reported as `aria-controls` on its trigger), and a List collapses with `hidden`, so a disclosed group is a List instead of a raw `div
|
|
139
|
-
- **
|
|
140
|
-
- **
|
|
141
|
-
- **
|
|
142
|
-
- **
|
|
143
|
-
- **
|
|
144
|
-
- **Set a component's classes in the Kerf UI editor (KF-X8X8VX).** `className` was hidden in the Inspector, so a view could not carry a class such as an appearance scope. It is now a **Classes** field in a trailing **Advanced** section; `component-props.json` marks it `control: "classes"` (also allowed in the props overlay schema). Inner hooks such as `headerClassName` stay hidden.
|
|
145
|
-
- **Text `id` is a declared prop.** Text took `id` only as an inherited native attribute, which the Kerf UI editor does not edit, so a Text could not be built as a link's destination (the ListItem › Native Navigation Link demo's `#list-item-link-target`). It renders the same `id` attribute as before (`KF-86PM4R`).
|
|
146
|
-
- **Text `live` and `rootAttributes`, and Row `ariaLabel`.** A Text readout can be an `aria-live` region and carry `data-*` hooks, and a Row of related controls can name itself as a group. The SearchField demos now use these in place of raw attributes, a raw `<span>` and a raw `<div role="group">`, so the Kerf UI editor can rebuild them (`KF-7V2VGS`).
|
|
147
|
-
- **A TextField end toggle, and Not set in the Kerf UI editor.** `TextField` takes `toggle: { label, icon, pressed, action }`, an icon toggle button inside the end of a single-line field that reports `aria-pressed` and runs its delegated `action` (a password's Show, for example). The editor's Inspector uses it for every optional text prop: the toggle, pressed while the prop is unset, unsets it, and an emptied field now holds the empty string instead of unsetting. A required text prop can be `""`, so ValueTableRow placeholder rows (`value=""`) are buildable (`KF-3Y2GS2`).
|
|
148
|
-
- **An empty zone in a Kerf UI view document is an explicit `null` (KF-YCM09F).** `validateView` accepts an empty zone list for a required prop that takes `null`, and `interpretView` and generated modules pass `null` for any empty zone. SplitView's `detail` composition minimum is now 0, so the editor can build a SplitView with nothing selected by removing the detail's last child. The SplitView demo passes `null` instead of an empty `<div />`.
|
|
149
|
-
- **Switch a list item's kind in the Kerf UI editor (KF-BGKYYH).** An item of a discriminated union list, such as a `ScrollEffect` effect or a `PopupMenu` entry, has a Kind Select in its form: switching a reveal to a scale keeps its `range`, `rangeStart`, and `rangeEnd` and shows the scale's `from` and `to`. So reveal on entry plus fade on exit builds in the effects list editor without JSON. Switching a member no longer carries over the old member's literal discriminant.
|
|
150
|
-
- **Data attributes in the Kerf UI editor, and `KUI-V015` (KF-65FTKX).** The Inspector's Data attributes section edits a component's `rootAttributes` as Name and Value fields with Add and Remove, so a view document can carry app identity such as `data-band`. View documents carry lowercase `data-*` attributes only: `validateView` reports `KUI-V015` for any other key, and for the reserved `data-kerf-*` (the node marker), `data-key` (the row key), and `data-editor-*` names. `dataAttributeProblem(key)` in `@kerfjs/ui/view` names the problem with one key. A document that set a List's `role` or another non-`data-*` key through `rootAttributes` is now invalid.
|
|
151
|
-
- **A new ScrollEffect starts with one effect in the Kerf UI editor (KF-T3PYVC).** A required list whose placeholder items would all be identical, such as a ScrollEffect's `effects` (three stacked `parallax` layers before), now seeds one item. Lists whose items differ keep three numbered placeholders, so a Select's choices and a PopupMenu's items are unchanged.
|
|
152
|
-
- **A new Kerf UI editor document fills the screen (KF-Z70DBC).** New's root Pane, and a Pane chosen in Replace the root, starts with `fill` on, so a new view fills an app's `.kui-app-root` and play mode instead of ending after its content. Turn `fill` off in Properties for a Pane that should take its content's height.
|
|
109
|
+
- **`ListHeader controls` and `List hidden`.** A toggle header names the region it shows or hides with `controls` (reported as `aria-controls` on its trigger), and a List collapses with `hidden`, so a disclosed group is a List instead of a raw `div`, as in the List "Scrollable Application List" demo (`KF-9JACQY`).
|
|
110
|
+
- **Text `lang` and `ariaLabel` are declared props (KF-AC7AFR).** Text took them only as inherited native attributes. They render the same `lang` and `aria-label` attributes as before, and the Semantic Variants demo's labelled paragraph uses them.
|
|
111
|
+
- **Button `expanded` (KF-DE348P).** A Button can be a disclosure control: `expanded` renders `aria-expanded`, the application flips it in its `action` handler, and a `DisclosureArrow` makes a natural `icon`. A link Button refuses it, as it refuses `pressed`. The DisclosureArrow demos now use it in place of raw `<button aria-expanded>` elements.
|
|
112
|
+
- **Text `id` is a declared prop.** Text took `id` only as an inherited native attribute; declaring it lets a Text serve as a link's destination (the ListItem › Native Navigation Link demo's `#list-item-link-target`). It renders the same `id` attribute as before (`KF-86PM4R`).
|
|
113
|
+
- **Text `live` and `rootAttributes`, and Row `ariaLabel`.** A Text readout can be an `aria-live` region and carry `data-*` hooks, and a Row of related controls can name itself as a group. The SearchField demos now use these in place of raw attributes, a raw `<span>` and a raw `<div role="group">` (`KF-7V2VGS`).
|
|
114
|
+
- **A TextField end toggle.** `TextField` takes `toggle: { label, icon, pressed, action }`, an icon toggle button inside the end of a single-line field that reports `aria-pressed` and runs its delegated `action` (a password's Show, for example) (`KF-3Y2GS2`).
|
|
153
115
|
- **`Pane` `fill`.** `<Pane fill>` takes the full height of a parent with a definite height (an app's `.kui-app-root`, a `SizedRegion`, a grid cell) or the rest of a flex column, so a one-screen app's root Pane reaches the bottom of the screen with its header and footer pinned and its content scrolling between them, the same way a NavStack view or Workbench region fills its Pane. The default is unchanged: a Pane takes its content's height. `docs/app-layouts.md` now says when to use a filled Pane (one screen that never navigates) and when a one-entry `NavStack` (a screen that pushes views or needs the stack's chrome) (`KF-RMEME0`).
|
|
154
|
-
-
|
|
155
|
-
- **Play mode devices (KF-R7KXSN).** The play bar picks the device the view runs on: an iPhone SE, iPhone 17, iPhone 17 Pro Max, Android (Pixel 8), three iPads, two MacBooks, a 1080p desktop, or Flexible, with each preset's size and safe areas cited to a published source. Phones and tablets rotate and have an **Installed app** toggle: off, the view runs as a browser tab inside the device's safe areas; on, it fills the device and gets the safe areas through `--kui-safe-area-*` on the play page's `:root`. **Scale** is Fit or a fixed 50–150%, which may overflow and scroll the stage. Flexible takes a typed or dragged width and height. Changing devices resizes the running view without reloading it, and the choice is remembered per browser. Hosts add devices through `createEditor({ devicePresets })` or the Vite plugin's `devicePresets` module.
|
|
156
|
-
- **Play mode subtracts the mobile browsers' toolbars (KF-FNQFPJ).** With Installed app off, each shipped phone and tablet now takes its browser's toolbars from the viewport as well as its safe areas: Safari's bottom address bar and toolbar on iPhone (the default iPhone 17 tab is 402×678, was 402×778), Safari's tab and address bar on iPad, and Chrome's toolbar and gesture bar on Android. The heights are estimates of the toolbars fully expanded. The drawn address bar is now a pill at most 40px tall.
|
|
157
|
-
- **Play mode draws a top browser toolbar (KF-YC59PH).** In a browser tab, iPad Safari, Chrome for Android, and the iPhones in landscape now show the status bar at the device's own safe-area height with an address bar below it, instead of a status bar stretched over the whole top band. iPhone portrait, whose toolbar is at the bottom, is unchanged.
|
|
158
|
-
- **Play mode device frames (KF-E8T0AY).** The played view sits in a generic, unbranded mock device: a phone body with a pill cutout, a punch-hole, or a Home button; a tablet; a laptop with a window title bar; or a monitor on a stand. Phones and tablets get a status bar and a home indicator, and a browser tab gets its address bar where there's room. The play bar's Device frame toggle hides the frame without moving or resizing the view.
|
|
159
|
-
- **Play mode actions and the action log (KF-RF6RCS).** A played view's `$action`s call the host's mock handlers. Register them with `createEditor({ playHandlers })` or the `@kerfjs/ui/vite-editor` plugin's `playHandlers` module. A handler receives `{ action, nodeId, event, params, view }` and can set params (re-rendering the view), push or pop a NavStack through `view.navStack(name)`, or open an overlay. A handler that throws is logged, and the view keeps running. The play bar's Action log button shows a count of unseen actions and opens a list, newest first: each action, its node, the event, and whether a handler ran, was missing, or threw. The log keeps 200 entries and clears each time play mode starts.
|
|
160
|
-
- **Play mode starts each NavStack at its root view (KF-BFE3EC).** A played view opens the way an app launches: every NavStack shows its first view, and a mock handler pushes the rest with `view.navStack(name).push(key)`. A "row opens its detail" flow no longer needs a Back first. The editing canvas still shows the view you're editing.
|
|
161
|
-
- **More components respond in play mode (KF-XV732Q).** Workbench panels and ResizableRegions resize, a SplitView collapses on a compact device and pushes its detail from a list row, and value controls (Switch, Checkbox, RadioGroup, Slider, Select, SegmentedControl, ChoiceChips, Combobox, ColorField, ColorPicker, TagField, Disclosure, and a toggle ListItem) keep the person's change across re-renders: in the play copy, in the `$param` the prop reads, or for one `$each` row. A TabBarItem repeated by `$each` selects for its own row, a tab's close removes it, and a sidebar toggled by several actions responds to each.
|
|
162
|
-
- **Play mode keeps nested controls per row (KF-7XQAFR).** A value control inside an `$each` row, not only the row's own root (a Switch in a repeated Row, for instance), keeps the person's change for its row across re-renders. A repeated tab also closes when its `$each` reads a `$bind` (a param object's array, or an outer row's array) instead of a `$param`: the item leaves the param it comes from.
|
|
163
|
-
- **Play mode keeps a repeat-inside-a-repeat's rows apart (KF-ZMBST3).** An inner `$each` row's play-time state is keyed by its row path (the outer rows' keys, then its own), so two inner rows sharing a key under different outer rows no longer share it. Toggling a Switch on tab `a` in group 2 leaves tab `a` in group 1 alone. A TabBar repeated per group selects within its own group, and a closed selected tab hands its selection to a neighbor in the same group. A keyed ref on an inner template still returns the first row with that key.
|
|
164
|
-
- **Play mode selects and closes a placed tab in its own row's bar (KF-36QBFM).** A tab placed directly in a TabBar that repeats per row (not repeated by the bar's own `$each`) was one node shared by every row's bar: clicking it selected it in every bar and cleared the repeated tabs' selection everywhere, and its close did nothing. It now selects for its own row's bar only, and its close hides it there, handing a selection to the row's next open placed tab.
|
|
165
|
-
- **`Select` and `PopupMenu` take a `popupNote` (KF-59BF6C).** Quiet text at the bottom of the open popup, below the choices, announced as the listbox's or menu's description and never an option or item. It wraps to the choices' width and is drawn from the shared popup contract, so both look the same. A toolbar Select, which has no room for a `hint` below its trigger, can now say what its choices leave out: the editor's play bar uses it for the Device menu's "Touch, pixel density, and the on-screen keyboard aren't emulated."
|
|
116
|
+
- **`Select` and `PopupMenu` take a `popupNote` (KF-59BF6C).** Quiet text at the bottom of the open popup, below the choices, announced as the listbox's or menu's description and never an option or item. It wraps to the choices' width and is drawn from the shared popup contract, so both look the same. A toolbar Select, which has no room for a `hint` below its trigger, can now say what its choices leave out.
|
|
166
117
|
- **`ScrollEffect` and the shared scroll-effect layer (KF-YCX1XH).** `@kerfjs/ui/scroll-effect` ties compositor-only effects on any content to its own scroll position, with no scroll listener: `effects` takes `parallax` (`lag`), `reveal`, `fade`, `scale` (`from`/`to`), and `dim` (`to`) presets, each over an `entry`, `exit`, `cover`, or `contain` view-timeline range with optional `rangeStart`/`rangeEnd` percentages, nested in array order so transforms stack and opacities multiply. Out-of-range numbers throw a `RangeError`. Only `transform` and `opacity` animate. The named view timeline, the keyframes, and the static fallbacks (no scroll-driven animation support, reduced motion, `data-kui-effects="static"`, `update: slow`, reduced transparency, increased contrast, forced colors) now live once in `@kerfjs/ui/scroll-effect.css`, and `BackdropImage` runs its parallax, progressive blur, and dim on the same layer with unchanged output; `@kerfjs/ui/backdrop-image.css` imports it. There is no blur preset for arbitrary content (a compositor-only blur needs a second copy of the content) and no IntersectionObserver gating.
|
|
167
|
-
- **Show a NavStack's lower view in the Kerf UI editor.** A NavStack's Flow area lists its views under Shown on the canvas; choosing one previews the stack cut back to it, so that view's nodes can be seen, ringed, and dropped into. The document keeps every view (`KF-RMZ2NP`).
|
|
168
|
-
- **Embed in, in the Kerf UI editor.** The selected node's Embed in menu puts it inside a new container in its place: SizedRegion, ListInsetControl, or ListInsetText where each can hold it, or any container from the Other… dialog. A nested whole-screen layout's hint row offers Embed in SizedRegion, and the canvas no longer draws its own frame around such a layout, so it shows the collapse an app would until it is embedded (`KF-6MGYSG`).
|
|
169
|
-
- **View hints.** `validateView` now returns `hints`, non-blocking advice that never makes a document invalid. The first, `KUI-H001`, flags a `NavStack`, `SplitView`, `TabNavigator`, or `Workbench` below the root with nothing giving it a height and suggests a `SizedRegion`. `kerf-ui-view` prints hints without failing, and the Kerf UI editor lists them under Problems (`KF-KQ72TW`).
|
|
170
118
|
- **`SizedRegion` gives a nested whole-screen layout a height.** `NavStack`, `SplitView`, `TabNavigator`, and `Workbench` have no height of their own and collapsed to their bar below an app's root. Wrap one in `SizedRegion` (`@kerfjs/ui/sized-region`): `height="fill"` (the default) takes the rest of a Pane's content, and `minHeight` alone gives a usable height even in content that sizes to itself. (`KF-63XR5K`).
|
|
171
|
-
- **The Kerf UI editor's canvas shows the tab you are editing.** Selecting a node inside a TabNavigator tab's content previews that tab, so its content, selection ring, and drop targets are visible; the document keeps the tab it opens on (`KF-YZPBFH`).
|
|
172
119
|
- **`Button` and `ToolbarButton` open native popovers.** `popoverTarget` and `popoverTargetAction` (`toggle`, `show`, `hide`) make either one the Popover API's invoker, and `ariaHasPopup` reports the popup it opens; a link `Button` refuses `popoverTarget`. The catalog's popover triggers and the anchored request popup's actions now use them (`KF-PAMQNM`).
|
|
173
120
|
|
|
174
|
-
- **`Text` takes `weight="strong"`.** A title or key phrase that matters more than its neighbors renders inside a `<strong>` element (through every wrap, truncation, and line-cap mode)
|
|
175
|
-
- **`ToolbarButton` in `@kerfjs/ui/toolbar-control-group`.** A ToolbarControlGroup's native `<button type="button">` as a component: icon-only with `ariaLabel`, or labeled, with `action`, `pressed`, `disabled`, `title`, and `selectedChrome="none"`. It renders exactly the button the group already styles
|
|
176
|
-
- **
|
|
177
|
-
- **
|
|
178
|
-
- **Promote list and object props to params in the Kerf UI editor.** Promoting a list, object, or record prop (a Select's `choices`) makes a param typed exactly as that prop that keeps its current value as the default, so the application can supply the data (`KF-V9V2B6`).
|
|
179
|
-
- **App-supplied functions and models in view documents.** A param typed `{ "kind": "prop", "component": …, "prop": … }` carries a value a document cannot spell (a Select's `renderSelected`, a SearchField's `model`): the generated module types it from the component (`Parameters<typeof Select>[0]["renderSelected"]`), it is optional exactly when the prop is, and it binds only to that prop. The Kerf UI editor promotes such props to these params and previews them with placeholders; `createEditorCatalog({ placeholders })` adds a host's own (`KF-H3CB2P`).
|
|
180
|
-
- **More props edit in the Kerf UI editor.** A Chip's `children` and a ListHeader's `actionIcon` take text or components, an inline object deep in a config (a pane's `compactChromeOpen`) edits as a form, and a nested `data-*` attribute map edits as JSON. The props catalog now records a text-and-markup union as content and keeps inline object fields five levels deep (`KF-24G2KV`).
|
|
181
|
-
- **Field zones: nodes inside prop values.** A view document's zone key can name a content field inside a prop value (`leftRail.content`, `mainToolbar.title`, `views.0.content`); `validateView`, `interpretView`, and generated modules put its nodes in that field, and `fieldZoneOf` resolves such a key. In the Kerf UI editor a Workbench's rails and drawer, a toolbar's title and slots, and each NavStack view's content now take components from Add a child, the outline, and drag and drop (`KF-PD6QC5`).
|
|
182
|
-
- **Workbench rails and drawers in the Kerf UI editor.** A Workbench's (or WorkbenchDialog's) `leftRail`, `rightRail`, and `bottomDrawer` pick Static panel or Navigation panel, then edit that panel's form; switching keeps the label and size (`KF-907BXY`).
|
|
183
|
-
- **Typed choices in the Kerf UI editor.** Props that take one of several kinds of value (a LucideIcon's `size` as a keyword or a number, a Button's `badge`, a Select's `value`), number or boolean enums (`headingLevel`, `tabIndex`), and optional literals (`selectionMode`) now edit in a Select that keeps the value's type, with a text, number, list, or form control for an open member, instead of a read-only row (`KF-3CKTKN`).
|
|
184
|
-
- **Rounded segmented tab strips.** `TabBar` takes `shape="rounded"` with `presentation="segmented"` to draw the strip at the shared control radius, with every tab concentric inside it, instead of a pill track. The Kerf UI editor's Document and Inspector rail strips use it, as the UX review asked. Segmented strips stay pills by default, and the earlier change that drew every segmented tab as a pill is reverted (`KF-YBD6XJ`).
|
|
185
|
-
- **An outlined, compact PopupMenu trigger.** `PopupMenu` takes `emphasis="secondary"` to outline its button trigger like a secondary `Button`, and `size="compact"` for a compact Button's height, so a menu outside a toolbar (an Add menu in a row of actions) matches the buttons beside it. The Kerf UI editor's list editor uses both for its **Add ▾** menu (`KF-MGKDJC`).
|
|
186
|
-
- **Color fields suggest colors in the Kerf UI editor.** A color prop such as a Pane's `background` or a LucideIcon's `color` now shows a color builder placeholder (`uiColor("surface-raised")`) and hint instead of `px(8)` (`KF-PE0PTT`).
|
|
187
|
-
- **Field editors for your own types in the Kerf UI editor.** `createEditor({ fieldEditors })`, or a `src/kerf-ui-field-editors.ts` module beside `@kerfjs/ui/vite-editor`, registers an editor for a named type (`'ShippingWindow'`, `'ListConfig'`) that replaces the type-driven form wherever a prop or field has that type. Its `render(context)` gets the value, its type, `commit`, preset-button and control attributes, and the type-driven `form()` to compose (`KF-EXA2WH`).
|
|
188
|
-
- **A list editor in the Kerf UI editor.** A list of objects or union items (a Select's `choices`, a PopupMenu's `items`, a NavStack's `views`) now opens as one row per item: choose a row to edit that item's form, remove it, drag or Alt+Shift+Arrow to reorder, and **Add** a new item (or pick the kind from **Add ▾** for a PopupMenu's items, headings, and dividers) (`KF-CY1D5W`).
|
|
189
|
-
- **An icon picker in the Kerf UI editor.** A LucideIcon's `icon` (and any icon-data prop or field) now opens a dialog that searches the Lucide icons and shows them; choosing one sets it, and the canvas updates (`KF-VYRDDQ`).
|
|
190
|
-
- **Inline tag and checkbox editors in the Kerf UI editor.** A list of strings (a TagField's `tags`, a ColumnExplorer's `path`) now edits in a TagField and a set of sides (a Pane's `separators` or `safeAreaEdges`) in a CheckboxGroup, instead of JSON (`KF-A9ZHGW`).
|
|
191
|
-
- **Object forms in the Kerf UI editor.** An object prop (a Workbench's `mainFooterList`, a Pane's `tint`) now opens a form built from its type's fields instead of a JSON textarea. A form of at most 10 fields slides into the Inspector, Back returns, and the canvas updates as you edit; a larger one, such as a Workbench's `mainPane`, opens in a dialog. Nested objects open the same way. **Edit as JSON**, **Reset**, and **Fill with example** remain on every form (`KF-Z9S029`).
|
|
192
|
-
- **The Kerf UI editor's component filter stays put.** The Filter Components field now sits in the Document rail's pinned header, under the tab strip, so it stays in view while the Components list scrolls (`KF-PR8MA6`).
|
|
193
|
-
- **Clearer component groups in the Kerf UI editor.** The Components list titles each category with a default `ListHeader` and spaces the categories apart, as the catalog's sidebar does (`KF-K2VP9A`, `KF-YR81M0`).
|
|
194
|
-
- **Every component renders as added in the Kerf UI editor.** A Workbench, SplitView, TabBar, ToolbarControlGroup, FloatingToolbar, and 18 other components showed "cannot render" when added, because their required zones and content started empty. A new node now gets placeholders for them: the zone's own component where the catalog names one (a TabBar gets a TabBarItem), otherwise a `Text` naming the zone ("Main"). Seeded numbers start at their default or 1 (a Grid's `columns`), icon data names a Lucide icon, and list-or-set unions seed a list. Every placeholder can be changed or removed like any other node (`KF-FGD8B3`).
|
|
195
|
-
- **Filter the Kerf UI editor's components.** The Components area opens with a Filter Components field that narrows the palette to components whose name or category holds the text, with an empty state when nothing matches and a clear button (`KF-Y26SKM`).
|
|
196
|
-
- **Edit sizes in the Kerf UI editor.** A List, Row, or Grid `gap`, a layout `flex`, a Spacer or Skeleton `width`/`height`, and a dialog `height` were read-only in the Inspector because they take either a keyword or a css-values builder. They now get a Select of their keywords (spacing tokens in scale order) plus **Custom…**, which opens a field for a builder call such as `px(12)` (`KF-Q5AXNP`).
|
|
197
|
-
- **Replace the root in the Kerf UI editor.** Selecting a document's root offers Replace the root under Children: pick any component (such as a NavStack or TabNavigator, which fill the view only as the root) to start the document from it. Params, slots, and the name stay, and Undo restores the previous tree (`KF-KWQVDJ`).
|
|
198
|
-
- **Item slots in Kerf UI view documents.** `{ "$slot": "name" }` is now valid at a content field inside a prop value, such as a NavStack view's `content`, a TabNavigator tab's `content`, or a row menu's `icon`. The application fills it like a zone's `$slot`: `validateView` checks it, the contract and generated `<Name>Slots` include it, and generated code and `interpretView` render `slots.name()` in place. The editor seeds one for each such required field of a new node, so NavStack, TabNavigator, ListDetailDialog, and ListActionRow render as soon as they are added, and lists them in the outline under their node (`KF-SXDM56`).
|
|
199
|
-
- **Placeholder lists in the Kerf UI editor.** A Combobox, Select, PopupMenu, or any other component added with a required list or object prop now starts with numbered placeholders ("Suggestion 1", "Choice 1", "Item 1") built from the props catalog, so it renders right away instead of reporting `requires "suggestions"`. The Inspector edits those props as JSON checked against their type, and **Fill with example** restores the placeholder for an unset one (`KF-HNNWN9`).
|
|
200
|
-
- **Tabbed rails in the Kerf UI editor.** The Document rail switches between Outline, Components, and Problems (with a count badge), and the Inspector between a node's Properties, Flow (Show, Otherwise, Repeat, Move to), and Children (Add a child, slots), with segmented tab strips instead of one long list. A newly added node opens on its Properties (`KF-MHY1GB`).
|
|
201
|
-
- **Drag components from the Kerf UI editor's palette.** A Components row drags onto the canvas and drops before, after, or inside a node wherever the validator allows, or into the root when dropped on blank canvas (so an empty document takes its first node); the new node has its required props filled and is selected. A click still shows the component's documentation (`KF-78MHM8`).
|
|
121
|
+
- **`Text` takes `weight="strong"`.** A title or key phrase that matters more than its neighbors renders inside a `<strong>` element (through every wrap, truncation, and line-cap mode) instead of raw `<strong>` markup; the demos and recipes use it (`KF-6A9GJ2`).
|
|
122
|
+
- **`ToolbarButton` in `@kerfjs/ui/toolbar-control-group`.** A ToolbarControlGroup's native `<button type="button">` as a component: icon-only with `ariaLabel`, or labeled, with `action`, `pressed`, `disabled`, `title`, and `selectedChrome="none"`. It renders exactly the button the group already styles (`KF-5ZEYKP`).
|
|
123
|
+
- **Rounded segmented tab strips.** `TabBar` takes `shape="rounded"` with `presentation="segmented"` to draw the strip at the shared control radius, with every tab concentric inside it, instead of a pill track. Segmented strips stay pills by default, and the earlier change that drew every segmented tab as a pill is reverted (`KF-YBD6XJ`).
|
|
124
|
+
- **An outlined, compact PopupMenu trigger.** `PopupMenu` takes `emphasis="secondary"` to outline its button trigger like a secondary `Button`, and `size="compact"` for a compact Button's height, so a menu outside a toolbar (an Add menu in a row of actions) matches the buttons beside it (`KF-MGKDJC`).
|
|
202
125
|
- **`ChoiceChips` `overflow="scroll"` for one-row strips.** A section or filter strip can stay on one row that scrolls sideways inside the group, with no scrollbar, so it never wraps the content below it down. `wireChoiceChips` keeps the checked chip in view (scrolling only the group), `wireScrollDividers` fades each edge with chips past it, and the focus ring is never clipped. It cannot be combined with `maxHeight` (`KF-0Q7Q3D`).
|
|
203
|
-
- **
|
|
204
|
-
- **Drop palette components on the Kerf UI editor's outline.** A drag rests on the Outline tab to open it, then lands before, after, or inside an outline row with TreeList's own indicator. The Document rail's tab strip is now pinned under its toolbar, with a scroll divider. `@kerfjs/ui/wire-tree-list` adds `treeListExternalDrop(root, { canDrop })` so an application's own pointer drag from outside a TreeList can target its rows (`KF-67K2VP`).
|
|
205
|
-
- **Clearer drag feedback in the Kerf UI editor.** A chip naming the dragged component or node follows the pointer, the drop line or ring carries a caption such as "After folderList" or "Inside Pane › content", and a node moved on the canvas dims in place. A line before the first node no longer disappears on the canvas's clipped top edge (`KF-Y4GHQV`).
|
|
206
|
-
- **Every palette component drags in the Kerf UI editor.** Components with required props the editor cannot fill in yet (Select, PopupMenu, Combobox, CornerStatus, ResizableRegion, ListInsetControl, ChoiceChips, and about 40 others) could not be dropped anywhere, because those unfilled props counted as problems the drop would add. A drop now accepts the new node's own unfilled props, unmatched variants, and empty required zones, as Add a child does, and Problems then asks for them; where the node may go still decides (`KF-DC23E9`).
|
|
207
|
-
- **New in the Kerf UI editor.** The toolbar's New starts an empty document (an empty Pane) with no undo history. With autosave it is a new draft, saved at once, and the previous document stays in its own file (`KF-QSSTMX`).
|
|
208
|
-
- **The Kerf UI editor saves every change.** With `createEditor({ storage })` (both editor hosts pass `devServerStorage()`), each change saves through the dev server about 400 ms after it: to an autosaved draft in the project's self-ignoring `.kerf-ui-editor/drafts/` folder until **Save As…** names a `.kui.json` path inside the project, then to that file. The Preview header shows the file and whether it is saved, saving, or not saved (with the reason), and the editor reopens the last file on the next visit. `@kerfjs/ui/vite-editor` serves the file endpoint (`editorFileMiddleware`), which reads and writes only project `.kui.json` files and refuses writes from other sites. With storage, downloading a copy moves to Export's Document (.kui.json) (`KF-0SY9M6`).
|
|
209
|
-
- **`KUI-V014`: controls inside controls.** `validateView` now reports a control, link, or component that renders one placed at any depth in the zones of a component whose root is a control or link, such as a Button in an actionable ListItem's `trailing`. The browser splits that markup, which used to break the row at render time. A composed `#view` document is checked with the enclosing control in force (`KF-71ATXP`). `eslint-plugin-kerfjs`'s `ui-composition` rule, and so `kerf-ui-doctor`, reports the same placement in JSX as `KUI-L205` (`KF-VTFKX8`). The Kerf UI editor's drops and Move to stop offering those places. Selection catalog entries declare the rules as `content.interactive` (`root` or `contains`, optionally only `whenProps` are set, with per-export `content.exports`), projected into `component-composition.json`; every Kerf UI component that renders a native control, link, or label is classified, plus the interactive Web Awesome elements. Component packages declare the same rules under `composition.content` in `kerf.components.json`, which `create-kerf-component` validates and copies; components without them stay unchecked (`KF-0P9WWB`).
|
|
210
|
-
- **A preview that fails to mount no longer breaks the Kerf UI editor.** The canvas preview is rendered and test-mounted outside the editor's render, so a document whose markup the browser splits (a Button nested in a repeated ListItem's description) shows why it cannot be previewed while the rest of the editor keeps responding (`KF-P6FPG2`).
|
|
211
|
-
- **Drag nodes on the Kerf UI editor's canvas.** Pressing a node or slot placeholder and dragging past a few pixels moves it before, after, or inside the node under the pointer (read along a row's flow when its parent lays out left to right), with a line or ring over the canvas for legal drops only; Escape cancels and the ending click does not reselect (`KF-CWDE93`).
|
|
212
|
-
- **Slots select and move like nodes in the Kerf UI editor.** Clicking a slot's canvas placeholder selects it and rings it, and a selected slot moves with the Inspector toolbar's Move up, Move down, and Delete, or by dragging its outline row; the separate Delete slot button is gone (`KF-5RKX3W`).
|
|
213
|
-
- **Drag-and-drop in `TreeList` and the Kerf UI editor's outline.** TreeList nodes take `draggable`, and `wireTreeList(root, { canDrop, onMove })` lets a row be dragged before, after, or inside another row of its tree, painting a line or ring only for drops `canDrop` accepts. `moveTreeListNode(nodes, move)` applies a move to a plain node tree. The editor's outline drags nodes to legal places (beside a node, slot, repeat, or condition, or into a node's first zone that takes it), and the Inspector's Move to picker moves the selected node to the end of any zone it fits, as the keyboard alternative (`KF-WXP6AB`).
|
|
214
|
-
- **Otherwise branches in the Kerf UI editor.** A conditional node's Otherwise show select puts a component in the `$if`'s `else` branch (or removes it), nodes in either branch edit the shared condition and their own repeat, and removing a two-branch condition keeps both nodes. Nodes under a condition that also repeats are now found for prop edits and bindings (`KF-5S56VQ`).
|
|
215
|
-
- **Richer value editing in the Kerf UI editor.** A css-value prop's field lists the builders the prop accepts and how to compose them (`calc(plus(px(8), space("m")))`), and refuses an outer builder the prop does not take. A text-accepting content prop such as a Button's label switches between text and nodes: Use as nodes moves the text into a text node so components can sit beside it, adding a child does the same first, and Use as text moves a lone text run back (`KF-YR91FA`).
|
|
216
|
-
- **Control flow in the Kerf UI editor.** The Inspector's Control flow section shows a node only while a true/false param or item field holds (`$if`) and repeats it for each item of a list (`$each`, with a suggested item name and row key; renaming the item updates the row's bindings). Add a child also adds a `$slot`, declared when new and, inside a row, given the row item as input; a selected slot binds its inputs and can be deleted. Choices are the sources the validator accepts, the outline shows conditions, repeats, and slots, and every change is undoable (`KF-90GTJN`).
|
|
217
|
-
- **Bind props in the Kerf UI editor.** The editor's Inspector binds a prop to a document param or a field of an enclosing `$each` item, offering only the sources the validator accepts for that prop; Not bound clears a binding, and every change is undoable (`KF-K5TKCV`).
|
|
126
|
+
- **Drag-and-drop in `TreeList`.** TreeList nodes take `draggable`, and `wireTreeList(root, { canDrop, onMove })` lets a row be dragged before, after, or inside another row of its tree, painting a line or ring only for drops `canDrop` accepts. `moveTreeListNode(nodes, move)` applies a move to a plain node tree (`KF-WXP6AB`).
|
|
218
127
|
- **`ColumnExplorer` in `@kerfjs/ui`.** `@kerfjs/ui/column-explorer` browses a hierarchy the macOS column-view way: one column of ListItem rows per level in a ColumnTrack, where choosing a row with children opens the next column, and an optional `preview` column shows a chosen leaf. It reads TreeList's nodes, and the app owns the chosen `path` (`treeListPath(nodes, id)`). `layout="paged"` shows one column per page on a phone. `wireColumnExplorer` (`@kerfjs/ui/wire-column-explorer`) adds per-column keyboard navigation (Up, Down, Home, End, Right to open and enter, Left to return, type-ahead) and brings a newly opened column into view (`KF-JY68DQ`).
|
|
219
|
-
-
|
|
220
|
-
- **`@kerfjs/ui/editor`: the Kerf UI editor as a module.** `createEditor({ catalog, document?, save? })` mounts the editor shell (document rail, preview canvas, editing inspector, undo and redo, open, save, export, and compare). `createEditorCatalog({ props, composition, selection?, components })` combines Kerf UI's catalogs with an application package's, and `componentMap(props, modules)` maps each catalog key to its component function from the modules its `import` fields name. Application components appear under Application in the palette, can be added to legal zones, and a component with no registered function previews as a labeled placeholder. The host loads the global stylesheets plus `@kerfjs/ui/editor.css` and registers `@kerfjs/ui/popup-menu/register` and `@kerfjs/ui/select/register` (`KF-6GT5QY`).
|
|
221
|
-
- **`TreeList` in `@kerfjs/ui`.** `@kerfjs/ui/tree-list` shows a hierarchy as ListItem rows indented by depth, with a disclosure arrow on each row that has children: an ARIA tree whose nodes, expansion, and selection the app owns (`action` chooses, `toggleAction` opens or closes). Nodes take icons, descriptions, trailing content, `disabled`, and `hasChildren` for children loaded on demand. `wireTreeList` (`@kerfjs/ui/wire-tree-list`) adds tree keyboard navigation: arrows, Home and End, Right and Left to open, enter, close, and return to the parent, Enter and Space to choose, and type-ahead. `treeListRows` and `treeListPath` expose the model. The Kerf UI editor's outline is now a TreeList (`KF-ECR4XG`).
|
|
128
|
+
- **`TreeList` in `@kerfjs/ui`.** `@kerfjs/ui/tree-list` shows a hierarchy as ListItem rows indented by depth, with a disclosure arrow on each row that has children: an ARIA tree whose nodes, expansion, and selection the app owns (`action` chooses, `toggleAction` opens or closes). Nodes take icons, descriptions, trailing content, `disabled`, and `hasChildren` for children loaded on demand. `wireTreeList` (`@kerfjs/ui/wire-tree-list`) adds tree keyboard navigation: arrows, Home and End, Right and Left to open, enter, close, and return to the parent, Enter and Space to choose, and type-ahead. `treeListRows` and `treeListPath` expose the model (`KF-ECR4XG`).
|
|
222
129
|
- **`FilePickerTrigger` can look like a Button.** Give it `tone`, `emphasis`, or `size` (the same values as `Button`, with the same defaults) and it draws as a Button of those settings instead of the compact link-toned trigger, so an Open picker matches a Save button beside it. It stays a native file label around the hidden input, and keyboard focus on that input shows the Button's focus ring (`KF-W99E6W`).
|
|
223
|
-
-
|
|
224
|
-
- **`rootAttributes` on 36 more components.** Every Kerf UI component with a single root now takes a `rootAttributes` prop for application `data-*` metadata (a row key, a test hook, the editor's node marker), filtered against the component's own protected markers. Affected components: ChoiceChips, CollapsiblePanel, CollapsiblePanelToggle, Combobox, ContentSwap, CornerStatus, DisclosureArrow, EdgeActivityIndicator, EmptyState, FilePickerTrigger, FileDropZone, FloatingToolbar, ListInsetControl, LoadingSpinner, LucideIcon, NavStack, ResizableRegion, SearchField, SegmentedControl, Select, Skeleton, Spacer, SplitView, SunkenPanel, PopupSurface, TabBar, TabNavigator, TagField, Toolbar, ToolbarControlGroup, ToolbarActionLink, ToolbarText, ValuePreview, ValueTable, ValueTableRow, and Workbench. `component-props.json` records each component's `dataChannel`, and the Kerf UI editor can now name and select nodes of all of them (`KF-PYR8XZ`).
|
|
225
|
-
- **Compare with an existing view module.** The Kerf UI editor's Compare picker reads a `.view.ts` your app already imports and lists the contract changes regenerating would make before you export. `readViewHeader` and `kerfjs/no-generated-view-edits` now also detect an edited `kui-contract` header line, not only an edited body (`KF-9J810J`).
|
|
226
|
-
- **Profiles locate prop catalogs.** A `.kerf-ui-profile.json` catalog entry may declare `props`: the package's `component-props.json` (`schemaVersion` matches `kerf-ui-component-props/v<n>`). The `@kerfjs/ui` defaults declare their own. `kerf-ui-view` now discovers the composition and prop catalogs that the profiles above a document declare, so documents can use a component package's components without `--props` / `--composition` flags; `--no-profile` opts out (`KF-S61KAT`).
|
|
227
|
-
- **`previewView` for editor previews.** `@kerfjs/ui/view` adds a lenient renderer for editors. It skips validation and the contract check, and it renders a caller-supplied placeholder for nodes the caller flags as broken or whose rendering throws, so one bad node never blanks the preview. Applications keep using the strict `interpretView`. The Kerf UI editor now previews documents with problems this way (`KF-F355BF`).
|
|
228
|
-
- **Component packages ship `component-props.json`.** `@kerfjs/ui` adds a `kerf-ui-props --write | --check` bin. It generates a component package's structured prop schema, the same format as Kerf UI's own, from the package's composition catalog and built declarations, plus optional inspector hints. Packages scaffolded by `create-kerf-component` get `props:generate` and `props:check` scripts, with `prepublishOnly` regenerating the file, so Kerf UI view tools can validate, inspect, and generate documents that use their components (`KF-B8TGP4`).
|
|
229
|
-
- **Icons in Kerf UI view documents.** A document places a Lucide icon by name with `{ "$icon": "inbox" }` on `LucideIcon`'s `icon` prop, which `component-props.json` now marks with `iconSource: "lucide"`. `validateView` reports misuse or, given a name list, unknown icons as `KUI-V013`. Generated modules import the icon from `lucide` under a collision-free alias, and `interpretView` resolves it from an `icons` map (`KF-91KCPK`).
|
|
230
|
-
- **`kerfjs/no-generated-view-edits` lint rule.** `eslint-plugin-kerfjs` reports a generated Kerf UI view module (`*.view.ts` / `.view.js` / `.view.d.ts`) whose body no longer matches the digest in its `kerf-ui-view` header, a damaged header, or a hand-written module sitting beside a `.kui.json` document. Regenerate instead of editing; behavior and overrides belong in your own files. It is in `recommended` at `error` and ignores CRLF conversion (`KF-BD3ZHQ`).
|
|
231
|
-
- **`interpretView` for server-driven Kerf UI views.** `@kerfjs/ui/view` renders a `*.kui.json` view document at runtime, with the same output as its generated module, given an explicit component map. It first checks the document's contract digest against the `<name>Contract` your app compiled (from a `--declarations-only` module). A served document that changed inputs, actions, slots, or refs throws `KuiContractMismatch`, or renders your `onMismatch` fallback, instead of silently breaking the client (`KF-5G4CNW`).
|
|
232
|
-
- **`kerf-ui-view` generator for Kerf UI view documents.** `@kerfjs/ui` ships `generateView` and a `kerf-ui-view generate | check | diff` bin. They turn a `*.kui.json` view document into a read-only, deterministic `*.view.ts` module that calls component functions directly (no JSX, no build step). The module exports typed inputs, an exhaustive action-handler interface (row actions get the row key), `SafeHtml` slots, refs resolved through a `data-kerf-node` marker, and a contract digest. `check` fails on stale or hand-edited modules, and `diff` lists breaking and compatible contract changes before you regenerate. `--target js` emits `.view.js` plus `.view.d.ts` for no-build apps (`KF-WWJGSN`).
|
|
233
|
-
- **`@kerfjs/ui/view` document validator.** `validateView` checks a Kerf UI view document (`kerf-ui-document/v1`, the editor's JSON source of truth) against the component-props and composition catalogs. It reports `KUI-V001`–`V012` (shape, unknown components and props, values that don't fit their types or variants, missing required props, ids and names, `$param`/`$bind` scope, keyed `$each`, action scope, strictly parsed `$css` builder calls, node-marker channels, composed views) plus the `KUI-L201`–`L204` composition checks the ESLint rule runs on JSX. `ai/view-document.schema.json` ships for editors, and `component-props.json` now marks text-accepting content (`acceptsText`) and `data-*` index signatures (`index`) (`KF-FB9340`).
|
|
234
|
-
- **Structured component prop schema.** `@kerfjs/ui` ships `ai/component-props.json` (plus its schema), generated from the published declarations and Web Awesome's manifest. It lists every component's props in a small type grammar, with required, documented defaults, enum values in source order, zones and content slots, css-value grammars, and the discriminated variants of union props such as Button's icon-only form and ListHeader's toggle mode. Editors, validators, and code generators can read prop shapes without parsing TypeScript. `npm run props:sync` regenerates it, and the package check fails on drift (`KF-8PXPKW`).
|
|
130
|
+
- **`rootAttributes` on 36 more components.** Every Kerf UI component with a single root now takes a `rootAttributes` prop for application `data-*` metadata (a row key, a test hook), filtered against the component's own protected markers. Affected components: ChoiceChips, CollapsiblePanel, CollapsiblePanelToggle, Combobox, ContentSwap, CornerStatus, DisclosureArrow, EdgeActivityIndicator, EmptyState, FilePickerTrigger, FileDropZone, FloatingToolbar, ListInsetControl, LoadingSpinner, LucideIcon, NavStack, ResizableRegion, SearchField, SegmentedControl, Select, Skeleton, Spacer, SplitView, SunkenPanel, PopupSurface, TabBar, TabNavigator, TagField, Toolbar, ToolbarControlGroup, ToolbarActionLink, ToolbarText, ValuePreview, ValueTable, ValueTableRow, and Workbench (`KF-PYR8XZ`).
|
|
235
131
|
- **One Kerf UI Sketch Library.** `@kerfjs/ui` ships `docs/design/sketch/Kerf-UI.sketch`, with 308 editable light/dark Symbols covering all 110 design-template variants on one page per family. It includes 141 `Kerf/<Theme>/<Role>` Color Variables and Button's shared styles. Its document, Symbol, Text, and Color Variable IDs stay stable across releases, so linked instances sync while keeping overrides. The six family `.sketch` files become build inputs; install `Kerf-UI.sketch` instead (`KF-WW7BNZ`).
|
|
236
132
|
- **Kerf UI Sketch text names SF Pro.** `Kerf-UI.sketch` used Sketch's nameless system font, which Sketch's Embed Fonts settings reported as three Invalid Font entries. It now names SF Pro's Regular, Medium, and Semibold faces, the font production's `system-ui` uses on macOS, so install Apple's SF Pro fonts before adding the Library (`KF-KFV416`).
|
|
237
133
|
- **Decline setup value proposals.** `kerfjs setup --resolve <id>=skip` remembers an unused dependency, script, compiler option, or catalog/profile value per package. Dry runs expose proposal ids, `=kerf` adopts a declined value later, and new authored conflicts still require an explicit conflict resolution (`KF-0TTETG`).
|
|
@@ -341,21 +237,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
|
341
237
|
- **Kerf UI `yield-to-expanded-sibling` works in every Toolbar zone (KF-ZX9Q0X).** A `ToolbarControlGroup` with `visibility="yield-to-expanded-sibling"` now leaves a 480px-or-narrower Toolbar while a group in any of its zones is expanded, not only a trailing sibling. A group that a collapsed Workbench or CollapsiblePanel relocates into the work area's leading zone (`relocateOnCollapse`) therefore gives way to the work area's expanded search, with no need to switch `relocateOnCollapse` on the search state. Groups that don't opt in are unaffected.
|
|
342
238
|
|
|
343
239
|
- **The local demo bundle check matches CI on any Node (KF-J1Z4VA).** Gzip sizes differ across Node majors' zlib, so the check used to pass locally on a newer Node while CI, on the pinned Node 22, measured the same bundle over budget. Off the pinned major, the check and `--update-bundle-budget` now measure under that Node through `npx`. When it can't run, a size within 1.5 kB of its budget fails instead of passing.
|
|
344
|
-
- **
|
|
345
|
-
- **A Workbench panel
|
|
346
|
-
- **Curated Inspector groups for Web Awesome components (KF-AHW2TM).** The 73 `wa-*` catalog entries now name an Inspector family for each visible prop instead of taking one from the prop's name, so no Web Awesome family shows more than ten fields without task pages. Form fields such as `wa-input`, `wa-textarea`, and `wa-tag-input` split Behavior into TextField's Input, Validation, Typing assistance, and State; `wa-button` uses Button's Form and Link; `wa-popup` splits Layout into Position, Flip, Shift, and Size. `dir` and `lang` move to Accessibility and `did-ssr` to Integration.
|
|
347
|
-
- **Curated Inspector groups across the catalog (KF-DXTRPR).** Every Kerf UI component now names an Inspector family for each visible prop instead of relying on the name-based fallback, and the thirteen older entries that used legacy group names (State, Mode, Surface, …) now use the families. Families that hold several tasks gain subgroups, such as NavStack's Top toolbar and Bottom toolbar, ToolbarControlGroup's Focus and selection, and Checkbox's Form and Validation. Misplaced props move to the family that matches their purpose: NavStack's toolbars go to Layout and its tint to Appearance, Checkbox's `size` goes to Appearance and its `name` and `error` to Behavior, and List's `landmark` and `labelledBy` go to Accessibility.
|
|
348
|
-
- **Shorter field labels under their task (KF-FPSWVF).** On an Inspector task heading or page, a field drops the task's name from its label: Workbench's Main page reads Toolbar and Footer list, and Button's Badge heading reads Max, Label and Tone. Summaries, Bindings rows and search keep the full label.
|
|
349
|
-
- **The narrow Inspector keeps the field being edited (KF-EGNN3J).** `wireWorkbench` panels take `keepFocusedOpen`. When the panel holds focus as its overlay breakpoint begins, it stays open as the overlay, focus and all, instead of collapsing. The Kerf UI editor sets it on the Inspector, so a window that narrows mid-edit keeps the open page, draft, focus, selection and scroll, through 1440 → 960 → 390 → 1440.
|
|
350
|
-
- **Clearer Inspector identity and labels (KF-HP1J4Z).** The Inspector's header names the selected component's type alone, so a long name no longer truncates it (the name stays in Ref name). The unlabeled property count is gone, and Ref name's help shows only until the node has a name. A props overlay entry can set a task-facing `label`: Button's `children` now reads **Button text**, and All properties still finds it by its API name.
|
|
351
|
-
- **Binding and promotion beside each field (KF-FN28S3).** Each Inspector Properties page ends with a **Bindings** row per field, naming what it reads (a param, an item field, or Not bound). The row opens the field's own Bind page, with its Source and **Promote to a param**, and explains in place when no source in scope fits. The overview's separate Promote and Bind sections, each with its own property picker, are gone. Data attributes moved to the Integration page beside Classes.
|
|
352
|
-
- **Properties as a task directory (KF-QWDPM3).** The Inspector's Properties area no longer shows every field at once. It lists the selected node's groups, each summarizing what the node sets and how many fields have problems; a row opens the group as a focused page, and a group of more than ten fields opens its tasks (such as Button's Link or Popup) as further pages. **All properties** searches every field by label, API name, or group.
|
|
353
|
-
- **Consistent Inspector groups (KF-4BPSTB).** The editor's Inspector sorts every component's props into the same families — Content, Appearance, Behavior, Layout, Accessibility, Integration — with component-specific tasks under them (Button's Link, Form and Popup; TextField's Typing assistance; Workbench's Main, rail and drawer regions). The "Other" and "Advanced" sections are gone: uncurated props take a family from their name, and Classes sits in Integration. The props overlay gains an optional `subgroup`; older group names such as `State` still read, as Behavior › State, and a custom catalog's own group names keep their sections.
|
|
354
|
-
- **The Kerf UI editor's view and wiring regions are separate modules (KF-YF1PDR, KF-N0CSVT).** Inspector controls, field editors, Library drag and drop, dialogs, and event handlers now receive typed state from `createEditor`; behavior and public entry points are unchanged.
|
|
240
|
+
- **A Workbench panel's toggle can name its return while it is an overlay (KF-9H30XE).** `PanelToggle` takes `overlayLabel`, Workbench panels take `overlaid`, and `wireWorkbench` panels take an `overlay` signal it keeps equal to whether the panel presents as an overlay. While the panel is open and overlaid, its toggle shows the label beside its icon and is named by it; otherwise it stays icon-only.
|
|
241
|
+
- **A narrow Workbench panel keeps the field being edited (KF-EGNN3J).** `wireWorkbench` panels take `keepFocusedOpen`. When the panel holds focus as its overlay breakpoint begins, it stays open as the overlay, focus and all, instead of collapsing, so a window that narrows mid-edit keeps the open page, draft, focus, selection, and scroll.
|
|
355
242
|
- **UI source registration survives tree shaking (KF-TA779Y).** The source PopupMenu registration module is listed as side effectful, so Select's public registration import remains in source-built demos.
|
|
356
243
|
- **Browser waits follow UI state (KF-BG83G7).** Browser suites wait for navigation, animation, and rendered state instead of fixed sleeps, with bounded transition-settling checks.
|
|
357
|
-
- **
|
|
358
|
-
- **Workbench resize contract moved to its model folder (KF-8G51WR).**
|
|
244
|
+
- **Four long UI functions now have named phases (KF-70DQG4).** Search-field wiring, scroll-divider control, project analysis, and UI doctor were split into focused helpers without changing their public behavior.
|
|
245
|
+
- **Workbench resize contract moved to its model folder (KF-8G51WR).** Workbench now imports the shared contract without crossing a component's private `internal/` boundary; the source organization check has no allowlisted edge.
|
|
359
246
|
- **The basic site examples follow the Kerf lint rules (KF-4SA1SM).** They use `attr()` selectors and explicit page-lifetime delegates, and site lint now covers all examples.
|
|
360
247
|
- **CI exercises the published Node 18 floor (KF-Q1S54S).** It installs the packed package into a Node 18 consumer, runs the setup dry run, and checks a server render from `dist/`.
|
|
361
248
|
- **`kerfjs setup` separates detection and apply from planning (KF-Q0WSWJ).** The public CLI behavior and exports are unchanged; the packed package now includes focused `setup/detect.mjs`, `setup/apply.mjs`, and `setup/common.mjs` modules.
|
|
@@ -368,25 +255,18 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
|
368
255
|
- **`@kerfjs/ui` CLIs share one argument contract (KF-FSCXYT, KF-7NZM4K).** Every bin prints usage and exits 0 on `--help` / `-h` without doing work (`kerf-ui-analyze --help` used to run an analysis), reports a missing or malformed input as `<bin>: <path>: …` with exit 2 instead of a stack trace, and rejects unknown flags and flags missing a value.
|
|
369
256
|
- **`npm create kerf-component` no longer installs TypeScript (KF-7H7FWV).** It is an optional peer of the `kerf-component-catalog` bin, which the scaffold template and `kerfjs setup --ui` already install.
|
|
370
257
|
- **Release tooling (KF-12QS9G, KF-RV39NE).** Release notes keep their `##` / `###` headings and literal backslashes in the tag message and GitHub Release; `npm run release:beta` continues the highest beta series; `npm run release` refuses a dirty tree, a non-main branch, or an existing tag.
|
|
371
|
-
- **The Kerf UI editor's components moved into an Xcode-style Library popover (KF-Z54E4H).** The Document rail's Components tab is gone; the rail keeps Outline and Problems. The Preview toolbar's **Library** (`+`) button and Shift+Cmd+L (Ctrl+Shift+L elsewhere) open the Library, a `PinnablePopoverSurface` with the same filter, List/Grid view (still remembered per browser), thumbnails, categories, click-to-document, and drag onto the canvas or the Outline. It opens with focus in its filter and closes (Escape, Close, the shortcut, or a press outside) with focus back on the Library button. It is transient: a drag from it steps it aside so the canvas and outline it covered take the drop, a drop closes it, and a drop that finds no place brings it back. Hold Option (Alt) to keep it open, as the drag starts or at the drop; an Option drop that asks where it goes (the "drop where?" menu) brings the Library back once the menu closes. Pin it, or drag its title, to keep it open while you work; the editor remembers whether it was pinned and where. The drag chip now draws over the Library too.
|
|
372
258
|
- **A smaller kerf core (KF-DK0B7T).** Both list reconcilers share one bulk row parse and row-contract diagnosis, `each()` renders rows through one helper, and `mount()` walks for nested mounts more briefly. The main entry drops from 15.30 to 15.11 KB min+gzip with no behavior change, and the size budgets ratchet down to hold the gain.
|
|
373
259
|
- **Kerf UI `TabNavigator` tab badges hide a zero count and cap at `badgeMax` (KF-0V773N).** A tab `badge` of 0 or less now renders no badge (and adds nothing to the tab's name), and a count past the new per-tab `badgeMax` (default 99) shows `99+`, using the same helper as `Button` and `ToolbarButton`. Text is still trimmed and shown as written, and non-finite numbers still render nothing. **Behavior change:** a tab that passed `badge: 0` to show a "0" now shows no badge; pass the text `"0"` to keep it.
|
|
374
260
|
- **Kerf UI `Button` badges hide a zero count and cap at `badgeMax` (KF-78EZ8Q).** A `Button` `badge` of 0 or less, or empty text, now renders no badge, and a count past the new `badgeMax` (default 99) shows `99+`, the same rules as `ToolbarButton` (one shared helper, so they cannot drift). `badgeLabel` joins the button's accessible name only while the badge shows. **Behavior change:** a caller that passes `badge={0}` on purpose to show a "0" now gets no badge; pass the text `"0"` to keep it.
|
|
375
261
|
- **AI guidance stops steering toward Web Awesome.** The Kerf skill and Cursor rules (`kerf-skill-version` 1.29.0 / 1.25.0) name the `scheme` prop and `.kui-*` scopes, scope the `webawesome.css` paragraph to the optional integration, and no longer describe `Select` as Web Awesome markup. The `@kerfjs/ui` catalog guidance sends a plain action to `Button` and an ordinary form field to a multiline `TextField` instead of `wa-button` / `wa-textarea`, and the UI skill (1.71.0) labels its `--wa-*` tips as integration-only (`KF-XNKQPX`).
|
|
376
262
|
- **Kerf stylesheets read only `--kui-*` tokens.** Seven Web Awesome theme values Kerf used directly now have foundation tokens that follow them with the same fallbacks: `--kui-font-3xl`, `--kui-font-weight-bold`, `--kui-font-family-heading`, `--kui-font-weight-heading`, `--kui-line-height-condensed`, `--kui-color-overlay-modal` and `--kui-transition-slow`. Dialog, popup and sheet insets read the new `--kui-surface-inset` (8px) and `--kui-container-inset` (16px) instead of the bridge's `--kui-wa-surface-inset` / `--kui-wa-container-inset`, which now alias them for Web Awesome elements only. Override the `--kui-*` tiers to change Kerf surfaces (`KF-0DZ2V9`).
|
|
377
263
|
- **Raw Web Awesome children in Kerf containers are styled by the optional bridge.** No Kerf component renders a Web Awesome element, so the rules for a raw `wa-button` or `wa-dropdown` inside a ToolbarControlGroup, a Toolbar's trailing zone, a popup surface, a Workbench panel, or a ResizableRegion moved from those components' stylesheets into `@kerfjs/ui/webawesome.css`. A Kerf-only bundle sheds about 1.6 KB gzip of selectors that matched nothing, and the catalog no longer loads Web Awesome for Toolbar, TabBar, SurfaceScaffold, PopupMenu, or the composer-form recipe. An app that places raw Web Awesome elements in those containers imports the bridge, as Web Awesome use already requires (`KF-Z2K3RR`).
|
|
378
|
-
-
|
|
379
|
-
- **A StateBanner's action takes Kerf UI Buttons, laid out as a horizontal list.** Put compact pill `Button`s (`size="compact" shape="pill"`) in `action`. A neutral Button takes the banner's tone: a primary one is the translucent tone pill, a secondary one a tone outline, a plain one tone text. Brand, success, and danger Buttons keep their own tone. The action lays out its controls (several Buttons, a `LoadingSpinner` beside one) as a wrapping, end-aligned row, so no `Row` wrapper is needed. Plain `<button>`s still get the pill. The demos, recipes, and guidance use Buttons, and the editor can build a banner action again (`KF-Q87Q17`, replacing `KF-5TGWQG`'s plain-button contract).
|
|
264
|
+
- **A StateBanner's action takes Kerf UI Buttons, laid out as a horizontal list.** Put compact pill `Button`s (`size="compact" shape="pill"`) in `action`. A neutral Button takes the banner's tone: a primary one is the translucent tone pill, a secondary one a tone outline, a plain one tone text. Brand, success, and danger Buttons keep their own tone. The action lays out its controls (several Buttons, a `LoadingSpinner` beside one) as a wrapping, end-aligned row, so no `Row` wrapper is needed. Plain `<button>`s still get the pill. The demos, recipes, and guidance use Buttons (`KF-Q87Q17`, replacing `KF-5TGWQG`'s plain-button contract).
|
|
380
265
|
- **`ToolbarButton` can be an avatar button.** In a `ToolbarControlGroup` with `content="avatar"`, a `ToolbarButton` takes `ariaLabel` alone and shows the group's `avatarImage`; its `icon` is optional for that form (`KF-CFWFAE`).
|
|
381
266
|
|
|
382
267
|
- **Overlay render slots for buttons and errors are typed as `data-*` attributes.** `ConfirmRenderSlots`, `PromptRenderSlots`, `FormRenderSlots` / `FormRenderField`, and `ChoiceRenderSlots` type their `ok`, `cancel`, `error`, and `actions` slots as ``Record<`data-${string}`, string>`` (what they always held), so a component that accepts only data attributes, such as a Kerf UI `Button` or `ToolbarButton` via `rootAttributes`, can carry them. Input slots stay `Record<string, string>`; spreading any slot works as before (`KF-YRC20J`).
|
|
383
268
|
|
|
384
|
-
- **`ListHeader` `badge` and `status` take plain text.** Both accept `string | SafeHtml`; ListHeader still wraps each in its own compact Badge, so `badge="New"` replaces `badge={<span>New</span>}`
|
|
385
|
-
- **Promote an app-supplied prop from its own row in the Kerf UI editor.** A function or model prop such as a Select's `renderSelected` showed as a read-only "—"; its row now says the app supplies it and promotes it to a param when chosen. The Promote and Bind lists name props in words (`KF-D85GY0`).
|
|
386
|
-
- **Item forms keep field order in the Kerf UI editor.** In a form for a list item or object (a Select choice), the Icon row and Configure rows now sit where their fields are instead of after every text field, and picking a choice's icon fills its `iconName` with the icon's name until you give it one of your own (`KF-3J47BY`).
|
|
387
|
-
- **Add a child suggests what a zone holds in the Kerf UI editor.** The Component choice lists the components a zone is named for first, under Suggested (a Button's `icon` offers LucideIcon, a `badge` zone Badge), and starts on that suggestion; the rest follow grouped by the palette's categories instead of one alphabetical list of every component. Changing the zone starts its component choice over (`KF-N8TW04`).
|
|
388
|
-
- **A clearer LucideIcon Inspector in the Kerf UI editor.** A LucideIcon's icon comes first, under Icon with its `name`, then Appearance and Accessibility; Inspector rows keep their prop order instead of listing every icon or Configure row after the text fields. A new LucideIcon's `name` matches its icon, and choosing another icon renames it until you give it a name of your own (one undo restores both). The node's own name field is now "Ref name", so it no longer reads like the `name` prop (`KF-DQFXWG`).
|
|
389
|
-
- **Readable field labels in the Kerf UI editor.** The Inspector labels each prop and form field in sentence case (`controlInsets` reads "Control insets", `hAlign` "Horizontal align", `ariaLabel` "ARIA label") instead of its run-together camelCase name, and Configure and Choose rows name their field the same way (`KF-7M4XQR`).
|
|
269
|
+
- **`ListHeader` `badge` and `status` take plain text.** Both accept `string | SafeHtml`; ListHeader still wraps each in its own compact Badge, so `badge="New"` replaces `badge={<span>New</span>}` (`KF-ZYQVHD`).
|
|
390
270
|
- **`wa-tree` and `wa-tree-item` are Discouraged.** They now point at `TreeList` (`@kerfjs/ui/tree-list`), and the default application UI profile's `hierarchy-navigation` preference prefers TreeList, so `KUI-L301` steers a hierarchy to it rather than to an exception for Web Awesome Tree (`KF-QMH4F5`).
|
|
391
271
|
- **Compact toolbar groups use compact text.** A `ToolbarControlGroup` with `size="compact"` now sets the 14px text of a compact `Button` (`--kui-font-s`), so its plain buttons, action links, and PopupMenu triggers match a compact Button beside them; before, they kept the default 16px text at the 32px height (`KF-Z8EYHT`).
|
|
392
272
|
- **`ListHeader` action ends on the list's bordered edge.** A full-width header's fitted trailing action no longer sits 4px inside its header to center its glyph on a Pane toolbar slot; its border box now ends flush at the 8px inline margin, on the same edge as a selected or hovered `ListItem` and a Pane header's trailing `ToolbarControlGroup`. Bordered elements in one column align outer edges; borderless nested glyphs align with nested content (`KF-78N7HE`).
|
|
@@ -436,17 +316,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
|
436
316
|
|
|
437
317
|
### Fixed
|
|
438
318
|
|
|
439
|
-
- **The editor Library gives project documents their own mode (KF-BBES58).** A Components/Documents switch separates file navigation from component previews, while document click and drag insertion remain available.
|
|
440
|
-
- **Dragging the editor Library avoids repeated layout reads (KF-382S3P).** The header drag caches its active clamp and writes only position variables on pointer moves, then settles against the live viewport at release.
|
|
441
|
-
- **The editor Library resizes from its bottom edge (KF-K662KK).** A visible bottom grip pins the dialog and changes its height within the viewport, while its results remain scrollable.
|
|
442
|
-
- **Library grid names show an ellipsis when a tile is too narrow (KF-CTVDFT).** Component and document tile labels keep their full accessible names and tooltips while using the Text component's explicit single-line truncation.
|
|
443
|
-
- **The editor Library marks scrolled content with a separator (KF-3T9H48).** Its fixed filter row gains a line only while the results List is scrolled, without moving either row.
|
|
444
|
-
- **The editor Library's scrolling results reach the dialog bottom edge (KF-EHEQVX).** In the fill-last popover layout, the scrollport uses the visible bottom edge while its content retains the normal horizontal inset.
|
|
445
319
|
- **EditorFrame source text now scrolls to the frame edge (KF-4HRCHP).** The framed textarea fills its surface while keeping the 16px text inset, so scrolled source content clips at the visible frame boundary like preview content.
|
|
446
320
|
- **The SegmentedControl catalog variants share one inset (KF-WHB4W7).** The two pill groups no longer receive a second Toolbar inset, so their outer edges line up with the rounded, filled, and standalone examples.
|
|
447
321
|
- **The ValuePreview catalog examples share the page text guide (KF-WY8VWR).** Their panel content now aligns with the example headings and descriptions at wide and narrow widths.
|
|
448
322
|
- **`bindList` honors same-reference `arraySignal.update()` (KF-TMYJ4G).** Content rows refresh inside their existing row element, and element rows receive `update(item)`; all consumers see the new content.
|
|
449
|
-
- **Editor undo and redo discard refused Inspector drafts (KF-0Y88XZ).** When history restores the document, an invalid field value is reset alongside its error so the field displays the document's value.
|
|
450
323
|
- **Release pre-flight refuses stale lockfiles offline (KF-F1CPCK).** Before tagging, it checks each lockstep package's manifest against its `package-lock.json` and prints the packages that need an updated lockfile.
|
|
451
324
|
- **`bindList` snapshot render failures recover before later patches (KF-1267Y6).** A row-render throw during `replace()` or another snapshot pass latches a full reconcile for the next valid source notification.
|
|
452
325
|
- **Virtualized `bindList` freezes a rejected duplicate-key source until a valid update (KF-7HV0MF).** Scroll and measurement frames keep the last accepted window and measured-height baseline instead of re-rendering the invalid array.
|
|
@@ -459,82 +332,23 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
|
459
332
|
- **eslint-plugin-kerfjs UI rules refresh in long-running ESLint servers (KF-RZ2G3A).** They pick up a regenerated `component-composition.json`, an edited `.kerf-ui-profile.json`, or a renamed `package.json`, and stop reporting a stale KUI-L090 once the catalog is fixed.
|
|
460
333
|
- **Example apps (KF-203W27).** cart-htmx no longer interpolates JSON into an HTML attribute string, kanban recovers from `pointercancel`, and the dashboard chart loop stops with its feed.
|
|
461
334
|
- **An open Kerf UI `Combobox` list survives an application render while its field is focused (KF-YA45PW).** `Combobox` renders its list closed, so a render while the person was typing (for example when `suggestions` arrived) wrote `hidden` and `aria-expanded="false"` back and closed the open list, and the new options were never filtered against the typed text. `wireComboboxes` now restores a list it held open after such a render, re-filtered, with the same active option when it is still shown. An unfocused list, or one the person closed with Escape or by leaving the field, stays closed.
|
|
462
|
-
- **
|
|
463
|
-
- **A row document with its own repeat previews as a KUI-V016 placeholder (KF-A01VDM).** When a `#view` inside an `$each` row composes a document that has its own top-level `$each`, `previewView` (the Kerf UI editor's canvas and play) now renders the node holding that `$each` as a placeholder whose reason names `KUI-V016`, instead of kerf's generic `each()`-inside-a-row error. The rule is unchanged: validation already reports `KUI-V016` and `interpretView` refuses the document; put the repeat in the composing document.
|
|
464
|
-
- **Extract to document keeps an optional item field optional (KF-JE8KHX).** In the Kerf UI editor, extracting a row that reads an item field the item type does not mark `required` (`subject?: string`) gave the new document a required param, so the composing module passed `message.subject` (possibly `undefined`) to a required input and a strict `tsc` rejected it. View documents now accept `optional: true` on a param with no default: its input is optional, a `#view` may leave it out, and an omitted value reads as absent (no default stands in for it). Extract gives such a field that form, and the editor shows it as not required. `validateView` reports `optional` that is not `true`, or that sits beside a `default`, as `KUI-V001`. The view-document schema and the `ViewDocument` type gain the field. Contracts of documents that do not use it are unchanged.
|
|
465
|
-
- **Embedded `PopoverDialogSurface` and `PinnablePopoverSurface` no longer draw a shadow cut off in a square box (KF-ENXYEB).** With `presentation="embedded"`, in flow on the Kerf UI editor's canvas or in a catalog, they now draw their border without the drop shadow, as an embedded `DialogSurface` does. The scrolling container around them (a Pane's content) had clipped the shadow at its edges.
|
|
466
|
-
- **The Kerf UI editor's play bar no longer clips its Scale Select at a narrow window (KF-MAM4AT).** The device options and Scale now sit with the action log and Done in the play bar's trailing zone, which wraps whole groups, so at 390px they move to a second row instead of running off the edge.
|
|
467
|
-
- **A nested `#view` resolves from the document that contains it (KF-3X7MFF).** When `views/list.kui.json` composed `./rows/row.kui.json` and that row composed `./cell.kui.json`, `kerf-ui-view`, `validateView`, and the editor looked for `views/cell.kui.json`, while the generated row module imports `views/rows/cell.kui.json`. Every `src` now resolves from its own document's folder. `resolveView(src, path)` receives `path`, where `src` points relative to the top document's folder, and the new `composedViewPath(from, src)` from `@kerfjs/ui/view` computes it. A resolver that reads only `src` keeps working for the top document's own `#view`s. Cycles are found by path, so the same `src` in two folders is no longer a false cycle and a `../` loop back is no longer missed. The view bundle budgets rise to 13200 B (`interpretView`, 13069 measured) and 9600 B (`validateView`, 9496 measured).
|
|
335
|
+
- **Embedded `PopoverDialogSurface` and `PinnablePopoverSurface` no longer draw a shadow cut off in a square box (KF-ENXYEB).** With `presentation="embedded"`, in flow in a catalog or any scrolling container, they now draw their border without the drop shadow, as an embedded `DialogSurface` does. The scrolling container around them (a Pane's content) had clipped the shadow at its edges.
|
|
468
336
|
- **Kerf UI popups open by the viewport's room in a scrolled page (KF-GRNDW5).** A `Select`, `PopupMenu`, or any popup placed by the shared positioning bounded itself by the document element's client rect, which moves up as the page scrolls. In a page that scrolls its document, a `Select` far down opened on the wrong side and was capped short (to 0px at phone width). Popups are now bounded by the viewport rectangle, so they flip and size by the room around their trigger wherever the page is scrolled.
|
|
469
|
-
- **The Kerf UI editor's drag chip draws over the rails in Safari (KF-23EBGS).** The chip naming what is dragged lived inside the canvas pane, which clipped it in WebKit as soon as the pointer left the canvas, so a palette drag heading for a spring-loaded Document tab or an Outline row showed nothing under the pointer. The chip now sits outside the panes and follows the pointer over the whole editor in every engine.
|
|
470
337
|
- **`delegate()` re-resolves a stopped event object re-dispatched on another path (KF-50DWVS).** The dispatch snapshot now records the propagation path it was taken on. When code stops a dispatch and then re-dispatches the same `Event` object on another target, or after its target moved, later kerf listeners resolve against the new path instead of consuming entries resolved against the first dispatch's DOM. Cost: about 0.03 KB min+gzip.
|
|
471
338
|
- **Kerf UI `TabBar`: intrinsic tabs shrink with an ellipsized name before the strip scrolls (KF-VQ1Z8H).** Each `TabBarItem` in an intrinsic strip used to stay at its full width (`min-width: max-content`), so a narrowing bar only narrowed the tab scroller and cut a tab off mid-word at its edge, with no ellipsis. A tab now gives up width by ellipsizing its name down to a minimum of its chrome plus a few characters, and the strip scrolls only once every tab is at that minimum. Leading, trailing, and end zones still never shrink, and a wide bar where everything fits lays out exactly as before: a name shorter than the minimum never widens. The name now sits in a new `kui-tab-bar-item__label`, which sizes it from a hidden generated copy, so the visible name is still the only accessible name. `wireTabBars` gives a truncated tab its full name as a `title` on hover. `nameOverflow="visible"`, placeholder, icon-only, and fill-allocation tabs keep their previous geometry.
|
|
472
339
|
- **Kerf UI `PagedView` keeps its page when its region resizes (KF-W093WV).** `wirePagedViews` now realigns each viewport to its rendered page whenever the viewport resizes, instead of relying on the browser to re-snap. Before, Firefox could be left between pages after a resizable sidebar widened again, and the offset a resize left could be reported to `onPageChange` as if the person had chosen another page.
|
|
473
|
-
- **Kerf UI editor play mode runs the ContentItem and SummaryRow keyboard (KF-963DMT).** Play now installs `wireContentItems` and `wireSummaryRows`, so a played `List selectionMode` listbox or grid is one Tab stop, the arrows and Home/End move focus, and Enter/Space activate the focused option, sending a ContentItem's `action` to the action log as a shipped app does. Media cards also get their load and tint state. `wireContentItems` is now in the component catalog as optional ContentItem wiring, so catalog tooling knows about it.
|
|
474
340
|
- **Kerf UI `SummaryRow`: the keyboard focus ring is drawn inside the row (KF-Q1F3FH).** A focused row drew an outside 24%-alpha shadow ring, so in a list section its neighbors painted over the top and bottom and the section's rounded clip cut the sides, leaving a faint hairline that hid which row had focus once the arrow keys moved it. Row and card options now draw the standard `--kui-focus-ring` inside their own box (a negative-offset outline on an overlay above the leading rail), so nothing around the row covers it, and the selected fill and border still read apart from focus.
|
|
475
341
|
- **Kerf UI `SummaryRow`: a nested action in the title shows its whole focus ring (KF-ETTYMK).** The title's line clamp clips its overflow at the text, so a focused Button inside `title` (a static `semanticRole="group"` row's recovery action) lost the top and bottom of its ring. The clamp box now carries a focus ring's reach as padding offset by an equal negative margin, so the ring fits inside the clip in every engine while the title's layout, line count, and ellipsis are unchanged.
|
|
476
342
|
- **Kerf UI `Select`: an open listbox keeps keyboard focus through a re-render (KF-VJW4XW).** An application re-render that landed while a Select opened could leave focus on the trigger, where Home, End and the arrows are ignored. Focus that falls back to the trigger or the page now returns to the chosen option; focus moved elsewhere stays where it is.
|
|
477
343
|
- **Kerf UI `SummaryRow` ends a clamped title with an ellipsis (KF-KZNNT2).** A title longer than `titleLines` used to stop at its last visible line with no overflow indicator, so a cut at a word boundary read as a complete title. Row and card titles now clamp with `-webkit-line-clamp` and end the last visible line with an ellipsis, while the floated `trailingMeta` still wraps the first line and inline title content still clamps as one paragraph. The title holds its content in one new `kui-summary-row__title-text` block, because WebKit lifts a float out of a line-clamp box. Do not add a clamp or `text-overflow` in app CSS.
|
|
478
|
-
- **Kerf UI view validator: a prop-typed param outside a node's props no longer names an unrelated component (KF-3624D4).** A `$param` / `$bind` typed as a component prop, used in a `$if` condition, a `#text` value, a `#view` prop, or a `$slot` input, was checked against whichever component the validator had visited last, so its `KUI-V004` named an unrelated component and could change when an unrelated node moved. It now reports `a ‹component› "‹prop›" value fits only that prop, not "‹field›"`, whatever comes before it.
|
|
479
|
-
- **Kerf UI view validator: a mismatch message names field zones instead of quoting their nodes (KF-20GMVX).** A `KUI-V004` for an invalid prop value whose field zones hold nodes (a CollapsiblePanel `toolbar`) now writes each zone as `<zone toolbar.leading>` instead of serializing every node inside it. The message stays readable in the Problems rail and the CLI, and editing inside the zone no longer changes it, so the editor's Move to, drops, and Embed in no longer mistake that edit for a new problem.
|
|
480
|
-
- **Editor: selecting a node in a large document is fast again (KF-SFAA5R).** The Inspector's Move to list validated the whole document once per zone on every selection, so a click cost 617 ms at 300 nodes and 7.1 s at 1000. `moveDestinations` now asks the new scoped move check, `createMoveCheck` from `@kerfjs/ui/view`, which re-checks only the source parent, the target parent, and the moved subtree, and falls back to a full validation where only that can tell. Building the list for a node in a flat 1000-node Pane drops from about 9.5 s to 24 ms in Node; the list itself is unchanged.
|
|
481
|
-
- **Editor: a field-level param can be renamed (KF-5ZMAEM).** A field promoted to a param from an object form's Bind a field (a ContentItem's `media.src`) kept its generated name (`nodeMediaSrc`); the form now shows a **Src param** name field while the field is bound to a param, and renaming it updates the param and every prop and field that uses it, as a bound prop's row already did. The Image-Tinted Feed Cards build names its artwork params `skylineUrl` and `skylineBlurredUrl`.
|
|
482
|
-
- **Editor: Bind a field offers params for the first field of an unset object (KF-PTMNSZ).** Binding a ContentItem's `media.src` while `media` was unset listed no source at all, because the result was still missing the required `alt` and that problem rejected every candidate. Source now judges each candidate with the object's other required fields standing in, so the string params that fit `src` are offered and the ones that do not fit stay out.
|
|
483
|
-
- **Editor: a saved document's bytes no longer depend on edit order (KF-YJFMZY).** Save, autosave, and Export's Document (.kui.json) now write each node's props, and every object inside them, in the component's declared prop order. Before, a field landed where it was first written, so a TextField toggle saved `pressed` before or after `action` depending on which was edited first, and an editor build sample re-saved with a different key order. The committed editor build samples are normalized to that order.
|
|
484
|
-
- **Editor: a selection no longer costs the square of the document (KF-ZW633Z).** The outline asked whether each row could be dragged by cloning the whole document for that row, so one click made one full clone per node (611 clones at 600 nodes). Where every node sits is now read from one walk per document version, and the Embed in options validate the unchanged document once instead of once per container. A selection now makes the same three clones at any size, and its remaining work grows linearly with the document: a click in a flat Pane drops from 100 ms to 34 ms at 300 nodes and from 700 ms to 83 ms at 1000 (Chromium, production build).
|
|
485
344
|
- **`each()`'s duplicate-reference error points at the real cause for an `arraySignal` (KF-7HMTZQ).** An `arraySignal` `push()`, `insert()` or `update()` renders through the granular path, which skips the O(N) duplicate check, so the error fired on a later, unrelated render and seemed to blame it. The message now names both indices (`first at index 0, again at index 1`) and, for an `arraySignal`, says the duplicate was most likely added by an earlier mutation. Detection itself is unchanged: an early check would cost O(N) per insert.
|
|
486
|
-
- **A click during a NavStack pop reaches the revealed view (KF-SBP2MV).** While a popped view slid out, it sat over the revealed view and took the pointer, so a click on the revealed view in that moment hit the outgoing copy and did nothing
|
|
487
|
-
- **A re-pointed input's `change` fires in WebKit (KF-FMGEJ6).** When a re-render changed a text input's `value` attribute, WebKit kept the value the input was created with as its `change` baseline, so typing that earlier value back fired no `change
|
|
488
|
-
- **
|
|
489
|
-
- **The Kerf UI editor names unnamed object members by what sets them apart (KF-BT1YG0).** A union of object shapes with no type name or literal tag, such as SearchField's `trailingAction` (a disclosure with `expanded`, or a toggle with `pressed`), read "Custom 1…" and "Custom 2…" in the Inspector's type Select. Each member is now named after the fields only it allows: "With expanded…" and "With pressed…".
|
|
490
|
-
- **Badge `ariaHidden` is a switch in the Kerf UI editor (KF-AYX1G2).** `component-props.json` recorded the prop as a `boolean | false | true` union because Badge's labeled and hidden variants narrow it to `false` and `true`, so the Inspector offered a two-item Select. A prop whose variant types are `boolean` and boolean literals now merges into one `boolean`.
|
|
491
|
-
- **The Kerf UI editor names components as authors write them.** The palette, Add a child list, outline and Inspector named an entry's primary component after its catalog title, so `DialogSurface` read "Surface Scaffolds" and `FilePickerTrigger` read "FilePicker". Every component now shows its export name (`KF-9DA687`).
|
|
492
|
-
- **A TabBarItem can be made non-closable in the Kerf UI editor.** `closable` defaults to `true` but did not say so, so `component-props.json` recorded no default and the editor's switch could not write `false`. Its JSDoc now states the default (`KF-X2E1B1`).
|
|
493
|
-
- **Multi-line text props hold line breaks in the Kerf UI editor.** The props overlay's `textarea` control (EmptyState and StateBanner `detail`, Text `children`) was ignored, so every string prop was a single-line field that Enter committed. Those props now edit in a multi-line field that commits on change, and ValuePreview `value` is one of them. TextField's end `toggle` now also works on a multi-line field, pinned to its top end, so an optional multi-line prop keeps its Not set toggle (`KF-8FCJ02`).
|
|
494
|
-
- **A ListActionRow can be an unpressed toggle in the Kerf UI editor.** Its `pressed` edited as a switch, which clears the prop when off, so the editor could not write `pressed: false` (`aria-pressed="false"`). It now has the same Not set / Off / On Select as `Button`, `ListItem`, and `ToolbarButton` (`KF-3T47XJ`).
|
|
495
|
-
- **A ToolbarControlGroup in a MessageComposer's leading zone validates.** MessageComposer draws its controls in a compact Toolbar, and its docs place leading controls in a `ToolbarControlGroup`, but the composition rules allowed a group only in Toolbar, FloatingToolbar or TabBar. So `validateView` reported `KUI-L201` for that documented composition. MessageComposer is now a listed parent (`KF-K1HFS2`).
|
|
496
|
-
- **Default-on boolean props can be turned off in the Kerf UI editor.** `component-props.json` read a default only from a backticked phrasing, so props documented as "(default true)" or "Defaults to true." (Select and PopupMenu `caret`, ColorField and ColorPicker `alpha`, ColorPicker `eyedropper`, BackdropImage `bleedInline`, ToolbarText `ellipsis`) had no default. The editor showed their switch off and could not write `false`. Unquoted `true`/`false` defaults are now read, and Select's `caret` doc states its default (`KF-YNEMFD`).
|
|
497
|
-
- **Turning `multiple` on or off reshapes a Select or ChoiceChips value in the Kerf UI editor.** A picked value became the wrong shape when `multiple` changed. Now one value becomes a one-entry list and a list keeps its first entry, in the same undo step. Renaming a choice's value also renames it inside a list value (`KF-E3MN4B`).
|
|
498
|
-
- **A prop typed with a lone `true` or `false` no longer offers the other boolean.** `component-props.json` folded any boolean literal in a union into `boolean`, so the Kerf UI editor offered `false` for Button's `badge` (`string | number | true`) and `true` for Combobox's `createLabel` (`string | false`). A lone literal now stays a `literal` member (`KF-FY62FK`).
|
|
499
|
-
- **The Kerf UI editor picks several values for an array `value`.** A CheckboxGroup's value, and a ChoiceChips value once `multiple` is on, now get a checkbox per choice instead of a single-choice Select that wrote one string of the wrong type; none checked is `[]`. A required string value (SegmentedControl) can also be set to `Empty ("")` for its no-selection state (`KF-8MEWP2`).
|
|
500
|
-
- **A TextField's spell checking can be turned off in the Kerf UI editor.** Browsers check spelling when `spellcheck` is unset, and the Inspector's switch cleared the prop when turned off, so `spellcheck: false` couldn't be written. It now edits as a Not set / Off / On select, as a toggle's `pressed` does (`KF-38KD5N`).
|
|
501
|
-
- **"Add to …" in a nested form adds to that field in the Kerf UI editor.** A content field inside an object prop that was not yet set, such as a SplitView's Compact stack › List › Toolbar › Trailing, wasn't treated as a zone of the node. So **Add to trailing** said "Every zone of this component is full" or put the child in another zone (`compactStack.backIcon`), which left the document invalid. The field's form now adds to the field itself (`KF-KAVBDD`).
|
|
502
|
-
- **An empty Toolbar's zones stay apart on the Kerf UI editor canvas.** In a narrow column, such as a SplitView's list, the Leading, Center, and Trailing placeholders each kept a 160px minimum and drew over one another, so a drop aimed at Leading landed in Center. A placeholder now never grows past its zone, so each zone is its own drop target (`KF-K3EKKF`).
|
|
503
|
-
- **Embed in no longer writes an empty `props` object in the Kerf UI editor.** A container with no props of its own, embedded through Flow › Embed in (a List or a ContentItem from Other…), exported as `"props": {}`; it now has no `props` key, as when it is dropped from the palette (`KF-QX497W`).
|
|
504
|
-
- **A Workbench panel's nested forms open in the Kerf UI editor.** In a static or navigation panel's form (a rail or the bottom drawer), Configure toolbar, Configure pane, and the other nested object rows did nothing; the type at a path inside a union-typed prop now follows the member the value holds, so those forms open and their fields write inside the panel (`KF-EZN7H2`).
|
|
505
|
-
- **A `$bind` into a param with a default uses the default (KF-8P3H7F).** `{ "$bind": "data.tabs" }` over a `data` param with a default read the raw input, so an app that omitted the optional `data` (and the editor canvas, which samples only params without a default) threw "Cannot read properties of undefined" in `interpretView`, `previewView`, and the generated view module. A `$bind` path now starts from the param read the way `$param` reads it, `(inputs.data ?? <default>)`, in the interpreter and the generator alike; `null` takes the default too.
|
|
506
|
-
- **A repeat inside a repeat's row renders (KF-CFA1S1).** An `$each` inside another `$each`'s template, such as a TabBar per group repeating `group.tabs`, threw in `interpretView`, `previewView`, and the generated view module, because kerf refuses a keyed `each()` inside a row render; the editor canvas showed "This document cannot be previewed". The inner repeat now renders as a plain `.map()` that re-renders with its row, in the interpreter and the generator alike, and its rows still carry `data-key`. A `#view` in an `$each` row whose document has its own top-level `$each` cannot work that way (its module can't know it is in a row), so `validateView` reports it as the new `KUI-V016`.
|
|
507
|
-
- **Icon-only buttons look complete on the Kerf UI editor canvas.** A Button or ToolbarButton with an icon and no text showed a full "is empty — drag a component here" stand-in that swamped its toolbar; a node holding something in another zone now shows its main-zone stand-in only while it is selected (`KF-6EV4Q5`).
|
|
508
|
-
- **Toolbar controls in a view's toolbar validate.** A `ToolbarControlGroup` in a NavStack view's (or a Pane's or Workbench's) toolbar config renders inside that Toolbar, but `validateView` reported `KUI-L201` for it and the editor showed the layout as unable to render. Composition entries can now name the config types they render (`configTypes`), and a content field inside one is placed in that component (`KF-THTR71`).
|
|
509
|
-
- **The Kerf UI editor's selection ring no longer marks the wrong content.** Selecting a node in an inactive tab drew the ring over the active tab's content at the same place; the ring now hides while the selected node can't be seen (`KF-ZC9EXM`).
|
|
510
|
-
- **The Kerf UI editor recognizes a dot-badge tab.** A TabNavigator tab with `badge: true` was listed as a count-badge tab and edited with the count form; a union member whose literal the value carries now wins over an earlier member that only tolerates it (`KF-2XH5XS`).
|
|
511
|
-
- **A list item's typed choice takes an open value in the Kerf UI editor.** Picking Number… or Text… for a field such as a tab's badge in a Configure dialog used to change nothing; it now sets the value and shows its control, as a typed choice in the Inspector does (`KF-ZAQQFK`).
|
|
512
|
-
- **Drop into a tab's content on the Kerf UI editor canvas.** A selected node's seeded item slots (a TabNavigator tab's or NavStack view's content) show as drop stand-ins named after the slot, and a drop there fills the content. Before, the canvas showed only the slot's name, and a drop into its field zone was refused (`KF-HGG7MJ`).
|
|
513
|
-
|
|
514
|
-
- **The Kerf UI editor's outline keeps a node's item content in item order.** A filled field zone (tab 1's content) is listed among the remaining item slots in tab order, rather than after them (`KF-KA5B40`).
|
|
515
|
-
|
|
516
|
-
- **The Kerf UI editor can make an unpressed toggle.** `pressed` on `Button`, `ListItem`, and `ToolbarButton` edits with a Not set / Off / On Select instead of a switch, because unset means a plain action and `false` means a toggle that is off (`aria-pressed="false"`). Off now writes `pressed: false` (`KF-K9VBB4`).
|
|
517
|
-
- **Turning a switch off in the Kerf UI editor clears its prop.** An optional boolean switched back to its default (`showValue` off) no longer leaves `showValue: false` in the document; a prop that defaults on still records `false` (`KF-K03GBN`).
|
|
345
|
+
- **A click during a NavStack pop reaches the revealed view (KF-SBP2MV).** While a popped view slid out, it sat over the revealed view and took the pointer, so a click on the revealed view in that moment hit the outgoing copy and did nothing. The exiting view is now `inert` and ignores pointer events for the duration of the slide.
|
|
346
|
+
- **A re-pointed input's `change` fires in WebKit (KF-FMGEJ6).** When a re-render changed a text input's `value` attribute, WebKit kept the value the input was created with as its `change` baseline, so typing that earlier value back fired no `change`. The morph, fine-grained bindings, and the keyed-list attribute fast path now write the live property before the attribute. The end state is unchanged in every engine.
|
|
347
|
+
- **A ToolbarControlGroup in a MessageComposer's leading zone passes composition checks.** MessageComposer draws its controls in a compact Toolbar, and its docs place leading controls in a `ToolbarControlGroup`, but the composition rules allowed a group only in Toolbar, FloatingToolbar or TabBar, so the documented composition reported `KUI-L201`. MessageComposer is now a listed parent (`KF-K1HFS2`).
|
|
518
348
|
|
|
519
349
|
- **The UI evaluator names a failed screenshot capture.** When a full-page capture fails after a context's checks ran, `KUI-B001` now says the screenshot could not be captured and suggests a longer timeout, instead of telling you to check that the app is running (`KF-G8KKNY`).
|
|
520
350
|
|
|
521
|
-
-
|
|
522
|
-
- **The Kerf UI editor icon picker shows each Lucide icon once, by its own name.** Lucide exports 255 aliases (`ArrowDownAz` for `ArrowDownAZ`, `Filter` for `Funnel`), which showed as duplicate tiles, and `ArrowDownAZ` was named `arrowDownAZ`; the picker now offers one tile per icon under Lucide's canonical name (`arrow-down-a-z`, `funnel`) while an alias still finds it in a search (`KF-NTK7YW`).
|
|
523
|
-
- **Clearing a Kerf UI editor field commits in Safari.** When a node's problems appeared above its Inspector controls, the re-render turned one prop's input into another's; WebKit then fired no `change` for the next clear, so a cleared `label` stayed set. Each control is now keyed by its prop or field (`KF-QCBJ4F`).
|
|
524
|
-
- **A content field in a Kerf UI editor item form leads to its field zone.** In a SegmentedControl choice’s form, `Content` read “KerfUiContent” and did nothing; it now adds to that choice’s field zone (opening Children with the zone chosen when nothing is suggested), or names and selects the nodes there, like a top-level content row. A field seeded with an item slot (a NavStack view's `content`) names the slot instead of showing its JSON, and nodes added from the row take the slot's place (`KF-VSWT2Q`, `KF-1ZSW5J`).
|
|
525
|
-
- **New nodes in the Kerf UI editor no longer write a `false` variant discriminant.** Dropping a ListHeader exported `toggle: false` and a Select `multiple: false`, restating defaults the validator already assumes when a prop is absent; seeding now leaves them unset (`KF-RRVYCG`).
|
|
526
|
-
- **The Kerf UI editor says why a drop is not allowed.** Dragging a component or node where it cannot go drew nothing and dropped nothing; the drag caption now names the reason in words while the pointer rests there ("ToolbarControlGroup goes in Toolbar or FloatingToolbar or TabBar", or "cannot go here") (`KF-6RYJ64`).
|
|
527
|
-
- **Toolbars and toolbar groups in the Kerf UI editor.** A new ToolbarControlGroup starts with a ToolbarButton instead of a stray Text, and Add a child in a group suggests ToolbarButton then ToolbarActionLink. A container with no main zone (a Toolbar) shows a placeholder for each empty zone ("Leading — drop here", "Center", "Trailing") while it is empty or selected, and a drop on one lands in that zone (`KF-7BB55F`).
|
|
528
|
-
- **A Select's value picks from its choices in the Kerf UI editor.** The `value` of a component with literal `choices` (Select, SegmentedControl, RadioGroup, …) is now a Select of those choices instead of a free text field labeled "Value value"; renaming the selected choice's value carries the value along in the same undo step, and a value that names no choice is shown as such with a hint. Props that take several kinds of value label the kind "<Prop> type" and the value "<Prop>" (`KF-9AWGPS`).
|
|
529
|
-
- **`validateView` accepts `$icon` and `$css` inside list and object values.** A Select choice's `icon` or `color` set in the Kerf UI editor was rejected with a type mismatch that dumped the whole `choices` value, although `interpretView` and the generated module already handled them (`KF-3J9GJV`).
|
|
530
|
-
- **Variant problems say how to fix them in the Kerf UI editor.** A node whose props fit none of its component's variants listed only "props match none of its variants"; the Problems list and banner now add what would fix it, such as `set "label" or "ariaLabel"`, `remove "ariaLabel" or "label"`, or `set "toggle" to false` (`KF-TVZ06Y`).
|
|
531
|
-
- **A gutter around the Kerf UI editor's canvas.** The preview sat flush against the canvas edges, so the selection ring of a node at the edge was drawn over its content; the canvas now leaves a small gutter so the ring and drop lines show whole (`KF-C4EW1V`).
|
|
532
|
-
- **Node-only content props are editable from Properties in the Kerf UI editor.** A prop that takes only components, such as a Button's or ListItem's `icon` or a ListItem's `trailing`, showed as a read-only "—". Its row now adds the component the zone calls for (a LucideIcon for an icon) and selects it, or opens Children on that zone when there is no single choice; once filled, the row names what fills it ("LucideIcon · plus") and selects it (`KF-5T3TE4`).
|
|
533
|
-
- **The Kerf UI editor's icon picker focuses its search.** Opening Choose icon puts focus in the search field, so typing a name filters the icons at once (`KF-GQHRC0`).
|
|
534
|
-
- **Empty containers show on the Kerf UI editor canvas.** A container whose main zone holds nothing (a new document's Pane, a Row just dropped in) previewed with no size, so it could not be seen, clicked, or dropped into. It now shows a placeholder ("Row is empty — drag a component here") that selects the node and takes a drop; the document is unchanged (`KF-ZWJHJR`).
|
|
535
|
-
- **Drops land in a node's main zone in the Kerf UI editor.** Dropping a component on blank canvas, or inside a node, now fills the zone its `children` render into (a Pane's content) before any other, and Add a child starts on that zone, instead of the first zone listed (a Pane's header) (`KF-W10DXQ`).
|
|
536
|
-
- **`@kerfjs/ui/styles.css` now holds the whole root-barrel layer.** It left out the stylesheets of `ListInsetControl`, `ListInsetText`, `SunkenPanel`, and `FloatingToolbar`. A root-barrel import paired with `styles.css`, as the Kerf UI editor's canvas does, therefore rendered those components unstyled: a `ListInsetControl` had no inset. The component-integrations check now fails when a root-barrel component's stylesheet does not reach `styles.css` (`KF-H29W31`).
|
|
537
|
-
- **Singular counts in the Kerf UI editor's preview header.** A document with one node or one problem now reads "1 node" and "1 problem" instead of "1 nodes" and "1 problems" (`KF-X2YQZE`).
|
|
351
|
+
- **`@kerfjs/ui/styles.css` now holds the whole root-barrel layer.** It left out the stylesheets of `ListInsetControl`, `ListInsetText`, `SunkenPanel`, and `FloatingToolbar`, so a root-barrel import paired with `styles.css` rendered those components unstyled: a `ListInsetControl` had no inset. The component-integrations check now fails when a root-barrel component's stylesheet does not reach `styles.css` (`KF-H29W31`).
|
|
538
352
|
- **A toggle `ListHeader`'s disclosure arrow lines up with its rows' trailing icons.** The arrow was centered in a 24px layer, 3px inside the trailing content edge of the `ListItem` rows below it. The layer now hugs the 18px arrow, so it ends on the toggle's 1px border + 8px padding, the same inset as a row's trailing icon, at standard and compact density (`KF-HZKKK9`).
|
|
539
353
|
- **UI doctor KUI-L401 honors view-scoped exceptions from app entries.** A declared application entry keeps each component use's source file when checking missing wiring, so a narrow exception on one view does not move to the entry or suppress another view's warning (`KF-5X91JH`).
|
|
540
354
|
- **Live Markdown editor at phone width.** The editor and preview stack into full-width, independently scrolling panes on narrow screens; tablet and desktop keep the side-by-side layout (`KF-HR730P`).
|
|
@@ -659,15 +473,13 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
|
659
473
|
|
|
660
474
|
- The UX Catalog filter keeps its placeholder hidden when a controlled state change rerenders the sidebar while filter text remains (`KF-4EA9R6`).
|
|
661
475
|
|
|
662
|
-
- Inspector TabBars use the shared rounded rectangle radius on the strip and inset tabs while ordinary segmented TabBars retain their pill geometry (`KF-K3RDN1`).
|
|
663
|
-
|
|
664
476
|
- **`KUI-L103` no longer flags a component's classes inside its own source.** `ui-public-boundaries` treats a catalog entry's `source` file as the owner of that entry's public classes, so an app component writing its own root class is not reported as recreating itself. Apps no longer need to mark those classes `placeableClasses` to silence it. Any other file, including another component's source, is still checked (`KF-G6FR6V`).
|
|
665
477
|
|
|
666
478
|
### Documentation
|
|
667
479
|
|
|
668
480
|
- **Imperative nodes inside keyed rows must be marked (KF-TBC6V7).** The render guide explains how an unmarked node can divert a text-only list update and why `data-morph-preserve` is required when adding it.
|
|
669
481
|
- **Nested removal observers use per-root containment (KF-6E8Y2C).** The scope API reference explains that an inner observer disposes a node moved outside its own root, even when it remains inside an outer observed root.
|
|
670
|
-
- **New consumer guides and references.**
|
|
482
|
+
- **New consumer guides and references.** The doctor, analyzer and evaluator guides gain CLI-option and Node-API tables (KF-GD1BDC); the API reference documents the tooling-facing JSX, brand and dev-hook exports and the `clearDevHooks` / `installDevHooks` signatures (KF-QGKQ0M, KF-FJQP4X); the htmx cart and counter-store apps get their own example pages (KF-GHSA8D).
|
|
671
483
|
- The `@kerfjs/ui` UX catalog's Structured Ticket Search help is lighter: a short title and line, then grouped filter chips (action `Chip`s) that insert their filter into the field, instead of a key/value table. The SearchField examples' notes are shorter too (`KF-XP8742`).
|
|
672
484
|
|
|
673
485
|
- New recipe in the `kerfjs/async` API reference: move heavy app compute (fuzzy search, CSV or markdown parsing, aggregation) into a Worker by having a `resource()` fetcher post a message to the worker and resolve with its reply. It covers request/reply ids, dropping superseded results, worker errors, transferring `ArrayBuffer`s, and keeping the render on the main thread (`KF-04KHT9`).
|