kerfjs 5.0.0-beta.129 → 5.0.0-beta.130
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 +60 -1
- package/ai/manifest.json +1 -1
- package/llms.txt +1 -0
- package/package.json +4 -3
package/CHANGELOG.md
CHANGED
|
@@ -6,8 +6,44 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
|
6
6
|
|
|
7
7
|
## [Unreleased]
|
|
8
8
|
|
|
9
|
+
### Added
|
|
10
|
+
|
|
11
|
+
- **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
|
+
|
|
9
13
|
### Fixed
|
|
10
14
|
|
|
15
|
+
- **The Kerf UI editor's project type checks are several times faster (KF-SNM61J).** Each analysis asked TypeScript for auto-import completions, which re-read the project's `package.json` about 1,300 times, and every request re-read every program file. The project type service now reads each manifest once per request, keeps file snapshots until a file's modification time changes, and skips completions where nothing shows them: formatting a draft (a new `suggest: false` analysis option, which the editor sends) and document validation. Warm CPU time per request fell from 0.3–1.6 s to 0.07–0.2 s for formatting and from 1.3–2.3 s to about 0.5 s for a two-parameter validation, so parameter dialogs no longer sit at "Checking type…" when several editors share one project server.
|
|
16
|
+
- **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 (the Kerf UI editor's parameter dialog lost a row chosen mid-close this way). `openDialog()` now opens such a dialog afresh, and the superseded `close` event no longer reaches the application.
|
|
17
|
+
- **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
|
+
- **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
|
+
|
|
21
|
+
- **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
|
+
|
|
23
|
+
- **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
|
+
|
|
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
|
+
- 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
|
+
|
|
31
|
+
- **Shared generated component runtime (KF-4DR6XR).** Generated TypeScript and JavaScript views import one lightweight `@kerfjs/ui/view-runtime` helper instead of repeating it in every module. The curried boundary preserves component prop checking and linear catalog bundling analysis; declarations-only and component-free views add no runtime import.
|
|
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.
|
|
38
|
+
|
|
39
|
+
- **Library minimum size (KF-GC3PRB).** Shrinking the Library keeps its search and result rows visible through a public, viewport-capped PinnablePopoverSurface `minHeight` option. Keyboard resize remembers the actual constrained height without pinning.
|
|
40
|
+
|
|
41
|
+
- **Library keyboard-cleared search (KF-0XRNXD).** Select All then Delete now restores the same empty editor, placeholder, and field height as the clear button by installing shared SearchField wiring on the Library surface.
|
|
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
|
+
|
|
11
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.
|
|
12
48
|
|
|
13
49
|
### Removed
|
|
@@ -17,7 +53,17 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
|
17
53
|
|
|
18
54
|
### Added
|
|
19
55
|
|
|
20
|
-
- **
|
|
56
|
+
- **Kerf UI `RadioGroup` draws preview tiles (KF-C29WJ9).** `presentation="tiles"` draws each choice as a framed preview above its label and optional hint, for options best told apart by a picture of their result, such as a Theme picker's Auto, Light, and Dark. Each choice takes a decorative `preview` (a small SVG or image, `aria-hidden`). The selection shows as a brand ring plus a check mark, and the tiles wrap whole, with three fitting a phone-width column. The radios stay native: one Tab stop, arrow keys move and select, and the checked value submits. The UX catalog's RadioGroup page has a **Preview Tiles** example.
|
|
57
|
+
|
|
58
|
+
- **Kerf UI `PinnablePopoverSurface` has a persistent, app-owned mode (KF-850ZRF).** `pinnable={false}` renders a floating panel that is always pinned: there's no Pin toggle, and it never re-anchors or closes on a press outside. It still drags by its title, moves with the arrow keys, resizes, stays inside the viewport, and reports moves and resizes through `onChange`. `closable={false}` omits the header Close button so an application control owns visibility; Escape then closes it only when `wirePinnablePopover` is given the new `closeOnEscape: true`. `headerActions` stay, so an app can offer a Reattach control. The UX catalog's surface-scaffold page has a **Persistent Floating Panel** example.
|
|
59
|
+
|
|
60
|
+
- **Kerf UI `TabBarFit` reports the room beside an adjacent tab strip (KF-3A0DBM).** `wireTabBars`' `onFitChange` adds `barWidth` (the bar's content width) and `endFree` (the room between the leading, tab, and trailing zones and the `end` zone, or the bar's end edge without one). With `trailingPlacement="adjacent"` the strip is only as wide as its tabs, so `free` stays about 0; `endFree` is the room an `end` action can grow into. The wiring now also observes the bar itself, so a bar that grows without any zone resizing reports again.
|
|
61
|
+
|
|
62
|
+
- **A ListHeader can start on the summary rows' leading edge (KF-J8GMA2).** `leadingEdge="summary-row"` makes a fill-width header span its container as `SummaryRow`s do and start its label (toggle or heading) on their leading-content edge, compacting with them at the same 384px width. Apps no longer mirror SummaryRow's internal inset and compaction width in their own CSS.
|
|
63
|
+
|
|
64
|
+
- **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
|
+
- **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.
|
|
21
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.
|
|
22
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.
|
|
23
69
|
|
|
@@ -292,6 +338,19 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
|
292
338
|
|
|
293
339
|
### Changed
|
|
294
340
|
|
|
341
|
+
- **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
|
+
|
|
343
|
+
- **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
|
+
- **Type analysis no longer stalls the editor's server (KF-EQFF9K).** `editorFileMiddleware` (and the `@kerfjs/ui/vite-editor` plugin) runs the project-type service in a worker thread, so other responses, such as a Play page, no longer wait behind TypeScript. Measured on the editor's preview server, the Play page's worst wait during a cold analysis dropped from 976 ms to 2.4 ms. A worker crash fails the requests in flight with a 500, and the next request starts a new worker. The middleware gains `dispose()`, which the plugin calls when its server closes.
|
|
345
|
+
- **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. The editor's narrow Inspector toggle reads "Preview".
|
|
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.
|
|
295
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.
|
|
296
355
|
- **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.
|
|
297
356
|
- **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.
|
package/ai/manifest.json
CHANGED
package/llms.txt
CHANGED
|
@@ -53,6 +53,7 @@ kerf renders JSX to a structured `SafeHtml` (string for static content; tagged "
|
|
|
53
53
|
- [Ticket phase timing](https://github.com/brianwestphal/kerf/blob/main/docs/25-ticket-timing.md): structured Hot Sheet phase intervals and process-review summaries without raw output, secrets, or machine-specific paths.
|
|
54
54
|
- [Kerf UI editor (design)](https://github.com/brianwestphal/kerf/blob/main/docs/26-ui-editor.md): JSON view documents as the source of truth, read-only generated view modules with a typed contract and digest, contract-diff re-export, and runtime interpretation.
|
|
55
55
|
- [Off-main-thread compute (decided: recipe, no subpath)](https://github.com/brianwestphal/kerf/blob/main/docs/27-worker.md): measured Worker crossover (send-every-call never pays; worker-resident data does once a call exceeds a few milliseconds; transfer binary data) and the recipe-vs-`kerfjs/worker`-subpath decision.
|
|
56
|
+
- [Editor Library previews (built)](https://github.com/brianwestphal/kerf/blob/main/docs/28-library-previews.md): one preview-registration mechanism for first-party, installed-package and application components (`defineLibraryPreviews`, keyed by full catalog key: sample props, a pure static renderer, an icon fallback, fit), literal-JSON composition samples with an optional preview module, and a fixed override precedence.
|
|
56
57
|
|
|
57
58
|
## Examples
|
|
58
59
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "kerfjs",
|
|
3
|
-
"version": "5.0.0-beta.
|
|
3
|
+
"version": "5.0.0-beta.130",
|
|
4
4
|
"description": "Tiny reactive UI framework — fine-grained signals + DOM morphing + JSX. Apply the smallest possible cut to update your DOM.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"sideEffects": [
|
|
@@ -185,7 +185,7 @@
|
|
|
185
185
|
},
|
|
186
186
|
"dependencies": {
|
|
187
187
|
"@preact/signals-core": "^1.14.1",
|
|
188
|
-
"minimatch": "^
|
|
188
|
+
"minimatch": "^6.2.3",
|
|
189
189
|
"yaml": "^2.9.1"
|
|
190
190
|
},
|
|
191
191
|
"devDependencies": {
|
|
@@ -214,7 +214,8 @@
|
|
|
214
214
|
"vitest": "^4.1.12"
|
|
215
215
|
},
|
|
216
216
|
"overrides": {
|
|
217
|
-
"esbuild": "0.28.2"
|
|
217
|
+
"esbuild": "0.28.2",
|
|
218
|
+
"minimatch@>=7 <11.0.1": "^11.0.5"
|
|
218
219
|
},
|
|
219
220
|
"gitgist": {
|
|
220
221
|
"provider": "claude-cli",
|