animation: core publishes transition records; gui evaluates via shaders, tty over grid cells

1 files changed, 6 insertions, 3 deletions

diff --git a/docs/macos.md b/docs/macos.md
index b800513f..5e5f13e3 100644
--- a/docs/macos.md
+++ b/docs/macos.md
@@ -655,13 +655,16 @@ 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 still renders one canonical complete frame. When tracks exist, the
+CoreText renders the complete frame supplied by the core. PanelAscii bytes are
+already interpolated 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,
-and ASCII materialization replaces not-yet-revealed cells with procedural
-punctuation. Because the input is the finished bitmap rather than a glyph-only
+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
 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.