1 files changed, 80 insertions, 0 deletions
diff --git a/docs/effects.md b/docs/effects.md
index 0e0ad51a..a0edc2ab 100644
--- a/docs/effects.md
+++ b/docs/effects.md
@@ -44,6 +44,10 @@ why. The verdict is the user's.
 | G8 notice chips | follows `Motion` and `Lift` | a notice floats in tier 4 on a lift (shadow) while Lift is on, drops in easing out and dissolves easing in, quicker than it came (150 ms against 180) | .scratch/render/notices/ (acme, forge) | pending |
 | G9 selection glow | `SelectionGlow on\|off` (off) | a soft halo of the selection's colour round each block of it in a body, fading in over 100 ms | .scratch/render/selection/ (forge, acme, lapis; lapis-glow-zoom.png) | pending |
 | G10 theme crossfade | always (a theme change) | the chrome's colours fade through OKLab, easing in and out (out when retargeted) | .scratch/render/crossfade/ (forge, lapis, acme cut short by dusk) | pending |
+| G11 look-hover glow | `HoverGlow on\|off` (off) | a soft underline of the theme's accent under the word a look-hover would open, fading in over 80 ms | .scratch/render/hover/ (forge, acme, lapis; zooms) | pending |
+| G12 ambient occlusion | `Occlusion on\|off` (off) | pane bodies darken toward their edges, at most 2% (§9.1: 1 to 2%) | .scratch/render/occlusion/ (on/off on forge, acme, lapis; acme-diff-x40.png) | pending |
+| G13 parallax | `Parallax on\|off` (off) | a theme's page pattern under the bodies (lapis's dots) moves with the text at a quarter of its speed, glides included | .scratch/render/parallax/ (lapis, notches down and up) | pending |
+| G14 afterglow | `Afterglow on\|off` (off) | a body cell whose text changed glows in the accent at 18% and fades over 250 ms | .scratch/render/afterglow/ (forge, acme: two in-place edits) | pending |
 
 ## Motion flavours
 
@@ -92,6 +96,13 @@ Which principles each motion uses:
   the flavour's arc), anticipation (playful's wind-up). A step of a cell or
   less, or any move in insert mode, lands at once, so typing never trails;
   a scroll carries the cursor with the text. Only the focused cursor moves.
+  A pane that moves carries it too: the springs keep its place in the pane
+  and the quad is drawn through the pane's presented box, so through a
+  slide, a zoom or a drag it rides with the text, and a layout change with
+  no transition lands it with the text. A focus change (to another pane, or
+  into a column's or the workspace's tag) glides from where the cursor is
+  drawn to the new one, free of the old pane's edges while it crosses
+  (.scratch/render/cursor/move/: ride-*, cross-*).
 
 
 Notes on G1: the lift and the dim run on one focus spring per pane, at the
@@ -207,3 +218,72 @@ muddy, on a smooth ease-in-out; a change made mid-fade sets off from where
 it shows and eases out, so it moves at once instead of stalling. The page,
 its text and the syntax colours still change at once with the theme, as
 before: fading them would re-resolve every cell each frame.
+
+Notes on G11: the word a look-hover would open is already lit (the
+affordance's tint); HoverGlow adds a strip three logical pixels tall along
+its foot in the theme's accent, its edges blurred by one, at most 22% and
+under the text's contrast floor, fading in over 80 ms (micro-feedback). It
+stays on bodies and is split round a cursor, so it never touches one. The
+word is found by the tint's colour, as G9 finds the selection.
+Found while reviewing: with the machine loaded, test/gui_golden.py's
+two-captures-agree settle can take a scene's frame before the scene's
+change lands, and every later hash moves up a scene; a rerun on a quiet
+machine matches.
+
+Notes on G12: four soft strips cast from just outside each body inward,
+clipped to it and round a cursor, black in linear light, 2% at most and
+under the lift's contrast ceiling, in the pane's own group so it moves
+with it. At §9.1's strength it is all but invisible on a dark page (a
+level of 255 on forge) and faint on a light one (acme's page steps one
+level toward the edges); acme-diff-x40.png shows where it falls.
+
+Notes on G13: a body region now carries its first line (Region.line: a
+file's scroll, a terminal's grid offset; on the wire, a u32 more a
+region). Under Parallax the dots under each body are offset by a quarter
+of its line times the row height, plus G6's glide offset while one runs,
+so they drift with the text as it glides and settle with it (measured: 4
+lines at 35 px move the 22 px grid 13 px, 35 mod 22). The cell shader
+reads the offset from the instance's serial slot, free since G7 took the
+dissolve's per-cell noise out. Without a pattern, nothing happens.
+
+Notes on G14: the GUI keeps the grid it last drew and when each cell last
+changed; a changed cell of a pane body glows in the theme's accent, 18% at
+most and under the text's contrast floor, and fades with an ease-out over
+250 ms, drawn as one flat rectangle a run of cells that changed together.
+Never on a tag or a grip (bodies only), the cursor's cell or a selection;
+a body whose first line moved (a scroll) starts over instead of lighting
+up whole. It runs on the continuous path while anything glows, and costs
+a compare of the grid a frame while on, nothing while off.
+
+## Terminal track (§9.2)
+
+Audit, after decision 2 (keep every whimsical effect and polish it, never
+remove it): the six core-composed character transitions (ascii, edges,
+fall, wave, scramble, typewriter) and curtain stay as they are, each
+bounded to its pane's final rectangle and each cell's last sample its
+canonical one; slide and vertical are the tty compositor's and follow the
+Motion flavour (sxrrwplk); zoom stays (nearest-cell scaling, its look is
+the effect); dissolve swaps each changed cell once at its threshold;
+message fades and the theme's chrome fade are the core's (the latter in
+OKLab since G10), and InactiveDim (T5's unfocused dim) works in a grid as
+it does in a pixel shell.
+
+| # | effect | switch | state | review material | verdict |
+|---|---|---|---|---|---|
+| T2 | cursor jump trail | `JumpTrail on\|off` (off) | a jump of three cells or more leaves 3 to 5 cells of trail behind the cursor, their ground drawn toward the text's colour in OKLab, most beside it, fading in 120 ms; truecolor terminals (vaxis's answer or COLORTERM); never the cursor's cell, a selection or outside the focused body; off under Motion off; a few cells a frame | .scratch/render/tty/trail/ (pyte replay of a real tty session at 60 fps: trail-forge.mp4, zooms) | pending |
+| T1 chip shadow | `ChipShadow on\|off` (off) | a notice chip casts a shadow a cell right and down in its body: half blocks (▌ ▀ ▘) in a darker ground on blank cells, the ground 35% darker (OKLab) under text; never the cursor, a selection, a tag or another chip; truecolor only | .scratch/render/tty/shadow/ (forge, acme; zooms) | pending |
+| T4 ordered swap | `PanelDissolve` (off) | the terminal's dissolve swaps each changed cell once at its place in a 4x4 Bayer matrix (shifted per pane), an even patterned screen instead of noise; hit-testing follows the same order | .scratch/render/tty/dissolve/ (ordered-swap-sim: the matrix applied to two real frames; see note) | pending |
+| T7 thumb flash | `ThumbFlash on\|off` (off) | a pane whose view moves has its scroll thumb drawn toward the text's colour, 60% at once and back over 250 ms (quadratic); the thumb only, never a focus indicator; truecolor only; a few cells a frame while it fades | .scratch/render/tty/thumb-flash.mp4, thumb-flash-strip.png (pyte replay, forge) | pending |
+| T3 wipe | `PanelCurtain` (off) | the curtain becomes a wipe, left to right: new grid behind the head, old ahead, and a soft edge of two columns whose ink and ground sit 2/3 and 1/3 of the way to the old ground (OKLab; a palette colour steps at the half); only the head's columns change a frame; the head's cells are not hit-testable until settled | .scratch/render/tty/wipe/ (curtain-gui.mp4, curtain-edge-zoom.png) | pending |
+
+Note on T4's material: a pane opening in a tty session recorded through
+pyte did not animate (PanelSlide did not either there), so the review
+material applies the same matrix to two real frames of that session; the
+unit test holds the order (a 4x4 block reveals exactly t x 16 cells).
+
+Not built: T5 (unfocused dim) is InactiveDim, which already works in a
+grid. T6 (a truecolor ramp on the active tag band) would change the
+focused tag's colour, a focus indicator no effect may alter, so it stays
+out. The §9.2 byte budget (deferring a sample after an oversized frame,
+DECRQM for sync 2026) is not built either: the terminal effects here change
+a few cells a frame, and only PanelSlide rewrites a whole pane per sample.