Merge main into text editing (M9.10)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs/architecture.md

@@ -103,6 +103,30 @@ groups into `Params` keys (`effects::flatten_params`). Commands: `paint.*`, `pup
 
 Half, Third and Quarter resolution render proportionally fewer pixels end to end.
 
+**Colour and bit depth** (`crates/render/src/color.rs`, `crates/color/src/space.rs`). Pixels are
+`f32`, but 8 and 16 bpc projects clamp and quantise each layer after its source and masks and
+after every effect, and the comp after every layer (16 bpc uses 0..32768), so over-range values
+(Add, Screen, Exposure…) only survive in 32 bpc; blend modes without HDR support clamp their
+inputs in 32 bpc. With a working space (sRGB, Rec. 709, Rec. 2020, Display P3; matrices derived
+from the published primaries), footage is converted from its colour profile (stream metadata or
+Interpret Footage, else sRGB) and the top-level comp is converted to the sRGB display. Linearize
+Working Space runs everything in linear light; Blend Colors Using 1.0 Gamma linearises only for
+blending. Layer cache keys include these settings.
+
+**Frame blending**: footage and precomp layers whose source time falls between source frames
+(rate conform, stretch, remap) blend the two neighbouring frames, by cross-fade (Frame Mix) or by
+hierarchical block-matching optical flow and a bidirectional warp (Pixel Motion,
+`raster::flow`).
+
+**Collapse Transformations**: a collapsed precomp layer without masks, effects or styles draws
+its nested layers straight into the parent with concatenated transforms (one resample), so
+nested blend modes and adjustment layers act on the parent's layers; nested 3D layers use the
+parent's camera and lights and, when the precomp layer is 3D, are depth-sorted with the parent's
+3D run. Masks, effects or styles force a flattened render. On text and shape layers the switch is
+Continuously Rasterize: the source is rasterised at its on-screen scale. Quality: Draft samples
+nearest-neighbour, Wireframe draws the layer bounds. Slip edit (`layer.slip`, Alt+PageUp/Down,
+dragging the source bar in the timeline) moves the source under fixed in/out points.
+
 **Motion tracking** (Animation ▸ Track Motion / Stabilize Motion, Window ▸ Tracker): a tracker
 is a `Tracker` group under the layer's Motion Trackers group, with Track Point groups (Feature
 Center, Feature Size, Search Offset, Search Size, Confidence, Attach Point, Attach Point Offset)

docs/control-protocol.md

@@ -81,7 +81,21 @@ Element ids are stable, for example `tools.Selection`, `panel.Timeline`, `panel.
 `header.workspace.Animation`, `project.item.<id>`, `viewer.comp`, `viewer.handle.<layer>.<i>`,
 `timeline.layer.<id>.bar`, `timeline.layer.<id>.twirl`, `timeline.prop.<uid>.stopwatch`,
 `timeline.key.<uid>.<frame>`, `timeline.cti`, `effectControls.prop.<uid>.value` and
-`effects.item.<name>`. Use `ui.elements` to see what is on screen.
+`effects.item.<name>`. The Composition viewer adds `viewer.magnification`, `viewer.resolution`,
+`viewer.roi`, `viewer.grid`, `viewer.channel`, `viewer.exposure`, `viewer.snapshot`,
+`viewer.showSnapshot`, `viewer.fastPreviews` (their popup entries are `viewer.<menu>Item.<n>`),
+`viewer.ruler.top|left|origin`, `viewer.mask.<uid>.vertex.<i>`, `viewer.shapePath.<uid>.vertex.<i>`,
+`viewer.motionPath.<layer>.<key>[.in|.out]`, `viewer.freeTransform.handle.<i>` and
+`viewer.regionOfInterest`; the Graph Editor adds `timeline.graph.transformBox[.<i>]`,
+`timeline.graph.snap` and `timeline.graph.reference`. Use `ui.elements` to see what is on screen.
+
+Viewer state that agents drive headless too: `view.snapping`, `view.channel {channel, colorized?}`,
+`view.exposure {stops | delta}`, `view.resetExposure`, `view.takeSnapshot`, `view.showSnapshot`,
+`view.fastPreviewMode {mode}`, `view.setRegionOfInterest {rect}`, `view.addGuide`,
+`view.moveGuide`, `view.removeGuide`; editing: `shape.newPath` (Pen on shape layers),
+`mask.insertVertex`, `mask.convertVertex`, `mask.deleteVertices`, `path.freeTransform` (masks and
+shape paths by uid), `keys.setSpatialTangents` (motion-path handles) and `keys.transform` (Graph
+Editor transform box, timeline Alt-drag scaling).
 
 The MCP server's bridge mode (`effectcraft-cli mcp --bridge 9877`) is a thin client of this protocol;
 see [agents.md](agents.md).

docs/parity.md

@@ -63,17 +63,17 @@ rendering, on-canvas text editing) are where the conservative figure is most lik
 | Audio | 85% | 0.5 | audio to keyframes |
 | Import | 78% | 4.5 | PSD, SVG as shapes, Lottie |
 | Automation | 76% | 3.3 | a JavaScript scripting object model |
-| Shapes | 68% | 3.9 | pen tool for shape paths, vertex editing, taper and wave strokes |
+| Shapes | 68% | 3.9 | taper and wave strokes (pen tool for shape paths and vertex editing landed in M6.5) |
 | Compositions | 67% | 7.4 | marker dialog, flowchart, Essential Graphics |
-| Animation | 65% | 10.4 | motion-path handles in the viewer, graph editor transform box, puppet, Wiggler/Smoother/Motion Sketch |
+| Animation | 65% | 10.4 | puppet, Wiggler/Smoother/Motion Sketch (motion-path handles and the graph editor transform box landed in M5.8) |
 | Text | ≈ 85% | 1.5 | vertical type is basic (upright characters, no tate-chu-yoko), no OpenType feature panel, no text on 3D bevels; per-character styles, paragraph settings, on-canvas editing and the `sourceText` style API landed (M9.9–M9.10) |
 | Web | 60% | 2.5 | threads, browser storage, audio |
 | 3D | 58% | 20.5 | Advanced 3D (models, PBR, image-based light), 3D camera tracker, multi-view layouts |
 | Effects | 56% | 14.6 | Effect Controls widgets (angle dial, point crosshair, eyedropper, curves), GPU effects, 41 missing effects |
-| Interface | 55% | 10.4 | drag-to-dock and floating panels, viewer rulers/snapping/channels/snapshots, preferences, native macOS menus |
+| Interface | 55% | 10.4 | drag-to-dock and floating panels, preferences, native macOS menus (viewer rulers/snapping/channels/snapshots landed in M0.13) |
 | Project | 53% | 8.1 | 8/16/32-bit pipeline and colour management, auto-save, proxies, folder moves |
-| Masks & roto | 44% | 13.0 | mask tracking, Roto Brush, free transform and RotoBezier |
-| Preview | 43% | 8.1 | GPU compositor, disk cache, region of interest, snapshots and exposure |
+| Masks & roto | 44% | 13.0 | mask tracking, Roto Brush, variable-width mask feather points |
+| Preview | 43% | 8.1 | GPU compositor, disk cache (region of interest, snapshots, exposure and Fast Previews landed in M0.13) |
 | Tracking | 0% | 13.0 | point tracker, Warp Stabilizer, mask and face tracking |
 | Paint | 0% | 4.0 | Brush, Clone Stamp, Eraser |
 
@@ -89,10 +89,10 @@ Mocha and Cineware are third-party and not counted.
 
 1. ~~On-canvas text editing and per-character styles~~ (landed: M9.9–M9.10).
 2. Effect Controls widgets: angle dial, point crosshair, eyedropper, curves and levels editors.
-3. Viewer basics: snapping, rulers, channel view, snapshots, exposure, a drawable region of interest.
+3. ~~Viewer basics: snapping, rulers, channel view, snapshots, exposure, a drawable region of interest.~~ (M0.13)
 4. A GPU (wgpu) compositor, then GPU effects.
-5. Pen tool for shape paths, shape vertex editing, the Layer viewer, free transform and RotoBezier.
-6. Motion-path handles in the viewer; graph editor transform box and snapping.
+5. ~~Pen tool for shape paths, shape vertex editing, free transform~~ (M6.5); the Layer viewer.
+6. ~~Motion-path handles in the viewer; graph editor transform box and snapping.~~ (M5.8)
 7. Point tracking and stabilization (in progress).
 8. Frame blending, collapse transformations, slip edit.
 9. A real 8/16/32-bit pipeline with linear blending and colour management.