animation: six character-motion panel transitions, composed in the core so backends agree

1 files changed, 7 insertions, 5 deletions

diff --git a/docs/macos.md b/docs/macos.md
index be110532..940d5a58 100644
--- a/docs/macos.md
+++ b/docs/macos.md
@@ -657,16 +657,18 @@ against the Zig extern struct on Linux. The exported list is already stable
 paint order—moving panes by slot, then opening panes by slot—so Swift only
 consumes it.
 
-CoreText renders the complete frame supplied by the core. PanelAscii bytes are
-already interpolated there, identically to the TTY and SDL paths. When tracks
+CoreText renders the complete frame supplied by the core. Character effects —
+PanelAscii's byte walks and the glyph motion of PanelEdges, PanelFall,
+PanelWave, PanelCurtain, PanelScramble and PanelType — are already composed
+there, identically to the TTY and SDL paths. When tracks
 exist, the
 same retained bitmap used by scene effects is fed through two kernels in
 `shaders/crt.ci.metal`: `pardesPanelClear` removes every final target first,
 then `pardesPanel` samples each target into its eased presented box. Slide uses
 ease-out cubic, zoom uses ease-out-back, dissolve uses stable pane/cell noise,
-while ASCII only clips the already-composed core cells; pixel attachments have
-no ASCII value and pass through unchanged. Because the input is the finished
-bitmap rather than a glyph-only
+while `pardesComposedInCore` effects only clip the already-composed core cells;
+pixel attachments have no character value and pass through unchanged.
+Because the input is the finished bitmap rather than a glyph-only
 batch, backgrounds, glyphs, taglines, rules, the caret, PDF pages, and image
 panes move and dissolve together. Scene CRT/ripple/glitch runs once after the
 panel composition.