gesso-core 0.4.0 → 0.4.2

package/CHANGELOG.md

@@ -1,5 +1,72 @@
 # gesso-core
 
+## 0.4.2
+
+### Patch Changes
+
+- d27e076: **The wheel scrolls an editable that overflows.** A multiline field with a fixed
+  height, or an unwrapped one narrower than its line, followed the caret and
+  nothing else: a wheel over it did nothing. It now scrolls the field's text on
+  either axis, clamped where the caret-follow offset is and without moving the
+  caret, and a wheel the field has no room for chains to the scroll container
+  around it, as one from a scroll container's end does.
+
+  A multiline field also shows the overlay scrollbar a scroll container does,
+  fading when idle, revealed by hovering its edge, and draggable once it shows.
+  While hidden it takes no presses, so a click at the end of a line still places
+  the caret. A single-line field draws none.
+
+  `scrollRange(record, axis)` is the furthest a record can scroll, the one answer
+  the layout engine's clamp, the scrollbars and the scroll sinks now all read.
+
+- d6c52da: **`scrollWith`: a container that scrolls in step with another node.** Binding a
+  container's `scrollY` to what `scrollPosition` reports leaves it a frame behind,
+  because the report arrives after the frame is laid out. A line-number gutter
+  beside a field, or a row header beside a grid, has to line up on every frame.
+  `scrollWith` names the node to follow and `scrollWithAxis` the axes (`both` by
+  default); the follower takes the leader's effective offset in the same layout
+  pass that settles it, whatever moved the leader. It ignores its own offset on a
+  followed axis, shows no scrollbar, and passes a wheel over it to the leader. An
+  `overflow="hidden"` box that follows is scrolled all the same, as script scrolls
+  one in CSS.
+
+  `scrollPosition` on an `<editabletext>` reports how far the field has scrolled
+  its own text, from the wheel, its scrollbar, the caret or a clamp.
+
+## 0.4.1
+
+### Patch Changes
+
+- **Scroll layers: a scrolled container is shifted, not redrawn.** On Canvas2D,
+  when a frame's only change is a scroll container's offset by a whole number of
+  device pixels, the renderer copies the pixels it already drew inside it over by
+  the scroll distance and redraws only the strip that came into view —
+  pixel-for-pixel identical to a full redraw, and several times cheaper in
+  software rendering. A layer is built only after the container has scrolled on a
+  few quiet frames running (`scrollLayerSettleFrames`, default 3), so a
+  virtualised list that mounts rows as it scrolls never builds one. Anything else
+  — a fractional smooth-wheel offset, a zoom, content that changes as it scrolls,
+  a caret or video inside — is drawn directly as before.
+  `Canvas2DRendererOptions.scrollLayers` turns it off. WebGPU is unchanged.
+
+  **Pictures that change every frame are no longer rasterised every frame.** On
+  Canvas2D, a painter's recording whose drawing changed this frame is replayed
+  straight onto the frame and rasterised only once it has held still for four
+  frames, so a live layer is never turned into a bitmap it throws away. A picture
+  seen for the first time, resized or re-themed is still rasterised at once.
+  `PaintStats` counts the replays as `direct`.
+
+  **A held mouse click is still a click.** A mouse press held past the long-press
+  delay lost its Click, so a deliberate, slow press on a button did nothing. A
+  mouse long press is now claimed only when a listener takes it (`preventDefault`
+  on `LongPress`) or it moves into a Drag. A finger's hold is claimed as before.
+
+  **`overscrollBehavior="contain"` keeps the wheel in a mounted app.** It was read
+  from the tree's topmost node, which in a mounted app is the runtime's wrapper,
+  not the app's root, and mid-chain it was honoured only on scroll containers. It
+  is now honoured on any ancestor of the target, so a pan-and-zoom canvas can keep
+  a ctrl-wheel or trackpad pinch from zooming the page.
+
 ## 0.4.0
 
 ### Minor Changes