Patch release — strictly additive work plus bug fixes, per VERSIONING.md. Markup compatibility with 0.1.1: fully additive, no renames or removals.
Resolves three TesseraQL downstream form-pattern issues (#244, #245, #246) — generated markup is treated as a public contract, so each is now a blessed, versioned pattern — plus a datagrid keyboard-nav fix.
Added
mutating-formrecipe (#244) — the blessed htmx form composition: POST with inline 4xx field errors (the field-errors fragment swapped into an in-form container), a success redirect (branch onHX-Request—204+HX-Redirectfor htmx, plain303 Locationfor no-JS), a double-submit guard + busy spinner, a confirmed destructive variant, and a no-JS degradation path.HX-Redirectis blessed overHX-Location(the latter is not post/redirect/get); no new glue behavior. Pinned by a real-htmx browser test. Docs.installCsrfHeader()(#246) — the blessed CSRF token delivery convention. Reads<meta name="csrf-token">on everyhtmx:configRequestand attaches it as a request header (defaultX-CSRF-Token, overridable per page viadata-header); read at request time so token rotation just works, never overwrites an explicitdata-hx-headersvalue, inert without the meta tag. Ships in the auto-init./behaviorsbundle. Docs.- Blessed boolean field-pattern docs (#245) — "As a boolean form field" on the checkbox page: a hidden
falsepaired with the same-name checkboxtrueso a form post always carries a value; covers the label-pattern rule and thehc-switchvariant. Docs.
Fixed
- field-errors: same-name groups now resolve to the first visible control (#245). The boolean-field idiom (hidden
false+ checkboxtrueunder one name) used to wirearia-invalid/aria-describedby/ focus / edit-to-clear to the hidden input; hidden members are now skipped when the group has a visible control. hc-datagrid: column-aligned keyboard navigation in multi-row records (#248). The navigation matrix resolvesrowspan/colspaninto a visual grid so ↑/↓ keep the visual column and a spanning cell is one stop. Single-row grids are unaffected.
Companion CLI release
@hypermedia-components/cli@0.1.1(tagcli-v0.1.1) re-bundles the recipe set sonpx @hypermedia-components/cli add mutating-formworks. No command or flag changes.
Full details in CHANGELOG.md.