@taprootio/espalier 2.10.0 → 2.12.0

package/CHANGELOG.md

@@ -5,6 +5,98 @@ here. This file ships in the published npm package. It is a curated public
 record and intentionally does not mirror the private `taproot-controls`
 development history.
 
+## 2.12.0 — Resizable page workspaces
+
+- Add opt-in `esp-page workspace-resizable` separators for Main → Preview and
+  Preview → in-grid Flyout/Help, supporting pointer drag, physical-direction
+  Arrow keys, larger Shift+Arrow steps, LTR, and RTL. Both seams press on
+  through preview's minimum — Main/Preview into open help, Preview/Help into
+  main — and resize sessions apply widths directly, with no mid-interaction
+  renegotiation and no track-transition glide, so pointer capture survives in
+  every engine, drags track the cursor, each drag lands its complete delta,
+  and a focused separator keeps keyboard focus across repeated Arrow steps
+  (settling when focus leaves it). Navigation collapse triggered by a resize
+  happens during the session, not after it. Separators announce pane widths
+  that keep changing across their complete travel — main's width, then
+  help's width — and without a visible preview the second seam becomes the
+  distinct `main-flyout` separator (own part and event identity) sizing help
+  directly against main.
+- Retain selected pane sizes for the mounted page instance and feed them back
+  through the existing allocator, preserving all main/preview/help min/max
+  bounds, navigation collapse, preview hiding, responsive re-clamping and
+  restoration, and help overlay promotion.
+- Expose both seams as labelled, focusable vertical ARIA separators with live
+  min/max/current values, a dashed keyboard-focus line drawn along the seam
+  itself (one viewport tall, glowing in the line's own color), comfortable
+  transparent hit targets, public parts and CSS interaction tokens, and the
+  typed bubbling `esp-page-workspace-resize` event, whose width fields report
+  the current allocated pane widths.
+- Bound keyboard resize suspension to a short idle window so container/media
+  changes resume allocator re-clamping while focus remains on a separator, and
+  clean up interrupted measurement/collapse session state across disable,
+  disconnect, and reconnect lifecycles.
+- Hide unavailable separators when preview is hidden or help becomes an overlay,
+  and suppress selection and touch-page scrolling while dragging.
+- Hide the thick anchored-help seam terminus when no visible preview separates
+  help from its field; the bridge and terminus now appear only for detached help.
+- Add Page examples and layout guidance for preview-only and preview-plus-help
+  resizing, plus pointer, keyboard, responsive, ordering, navigation, overlay,
+  and real-browser regression coverage.
+
+## 2.11.0 — Flexible preview and help workspace
+
+- Arrange the `esp-page` authoring workspace as main, full-viewport preview,
+  then help, with independent preview and flyout controls.
+- Add min/max width contracts for main, preview, and help. Preview grows first,
+  help grows after preview reaches its maximum, and all three participate in
+  one spare-canvas, main-reclaim, and safe-navigation-collapse decision.
+- Retain a validated collapsed navigation rail whenever its saved width keeps
+  the complete workspace visible, restoring it only when all region minimums
+  fit with the rail present.
+- Bridge anchored help across a visible preview with a non-interactive,
+  40%-opacity dotted connector, caret at the main edge, and a short thick
+  terminus on the preview/help seam.
+- Present preview as a default secondary surface with the main/page background,
+  dotted tear-off edge, and outer shadow moved from main to preview.
+- Promote auto-mode help to the accessible overlay drawer whenever sidebar +
+  main + help minimums cannot fit, even above the mobile breakpoint, and restore
+  its in-grid complementary presentation when space returns.
+- Allocate preview and help widths from the visible page bounds, so a layout
+  box slightly wider than the visual viewport — such as a `100vw` page beside
+  a classic scrollbar — narrows help by the hidden sliver instead of promoting
+  the modal drawer.
+- Keep page-managed drawers stable across scroll-lock width changes, prevent
+  rejected preview measurements from flashing, keep candidate tracks mounted
+  until their geometry is stably valid or invalid, and raise nested drawers
+  above ancestor page headers.
+- Let preview and non-modal help scroll their own content first, then hand
+  wheel/trackpad motion back to the main document at either boundary or when
+  they have no intrinsic overflow.
+- Add a live Page example showing an editable field, persistent preview, and
+  anchored contextual help together, expanding main to full width when both
+  auxiliary surfaces are closed. Help starts closed so the documentation never
+  opens with an unsolicited modal drawer.
+
+## 2.10.1 — Full-viewport persistent preview
+
+- Correct `esp-page` persistent previews to begin at viewport top beside the
+  application header and remain visible while tall main content scrolls.
+- Give preview content an independent `100dvh` scroll surface with a zero sticky
+  offset, including pages with normal, sticky, or fixed headers.
+- Preserve spare-width negotiation, sidebar collapse, responsive hiding,
+  flyout precedence, and the existing `preview` slot and preview-control APIs;
+  consumers need no shadow-part styling or new compatibility attribute.
+
+## 2.10.0 — Persistent spare-width preview
+
+- Add a dedicated persistent `preview` slot to `esp-page`, separate from the
+  always-present `right` aside and transient `flyout` surface.
+- Use spare trailing canvas first, optionally reclaim main and linked navigation
+  width down to a configured floor, and automatically hide and restore the
+  preview as available space changes.
+- Preserve flyout precedence and expose labelled complementary-landmark,
+  visibility, toggle, width, and sidebar-collapse contracts for authoring tools.
+
 ## 2.8.0 — Popover collision strategies
 
 - Add declarative `flip`, `shift`, and `none` collision strategies to