63 KiB
AniCraft roadmap
Principle: infrastructure first, then high-traffic parity, then the long tail. Every
milestone ends with a green tree: build, tests, clippy, a --screenshot check and an updated
"Honest status" section below.
Honest status (2026-11-09, v0.1.0 early alpha)
| Dimension | Status |
|---|---|
| Architecture | M0 skeleton in place: geom → doc → render → engine → cli → shell, layering enforced by cargo test (src/architecture_tests.rs: lower layers only, no UI crates below the shell, and the AGENTS.md map must match). |
| Rendering | CPU oracle with analytic AA, non-zero/even-odd, solid + linear/radial gradients, round-join strokes. Mask clipping: the display list carries nested clips; a clip is the anti-aliased union of its mask fills (strokes and opacity ignored), intersected with any enclosing clip, computed once per render band; an empty mask hides everything under it. Group alpha: a symbol instance below full opacity is a group in the display list; each render band composites the group's run of ops into its own buffer (nested groups stack) and blends it once at the group's alpha, so overlaps don't show through; SVG export writes <g opacity>. Blend modes (Animate's 14, on movie clip and button instances): an instance with one is an isolated group that blends at its close with the W3C separable formulas on premultiplied colour (Alpha and Erase keep or clear the backdrop); SVG gets CSS mix-blend-mode, Lottie the layer bm. Bitmaps: Paint::Bitmap fills (once or tiled) with bilinear sampling in premultiplied space, colour effects per sample; PNG/JPEG import to stage (a rectangle of the image's size); stored in the document as PNG (base64 in .anicraft), decoded once on first use; SVG export embeds each image once as a pattern. Filters: a filtered group is drawn on its own (by the same renderer, recursively, so nested filters work) into a buffer over its artwork grown by the filters' reach, filtered (box-blur passes; shadow and glow from the blurred, offset opacity; bevel and gradient bevel from the difference of the blurred opacity offset towards and away from the light, gradient glow from the glow's intensity, both through a colour ramp whose rest stop is pinned transparent, inner/outer/full and knockout, ADR 0025; colour matrix), and composited back as one image in its group, so alpha and blend apply; clips from inside the symbol apply before filtering and the instance's own clip after. GPU stage, first slice (M3, ADR 0019; --features gpu-stage, off by default): Preferences › Stage › Renderer GPU (preview) draws the stage with wgpu compute from the oracle's own prepared fills (tile binning with per-row backdrops on the CPU, exact area coverage and src-over per pixel on the GPU): solid and gradient fills and strokes, non-zero and even-odd; masks, group opacity, blend modes, filters and bitmaps fall back to the CPU per tile, and the status bar says so. Parity with the oracle: max 1/255, mean < 0.0001/255 on the sample, stress and analytic scenes (tests skip without an adapter). 4K with 1,000 shapes: 8.8–9.0 ms vs the CPU's 17.4–17.8 ms. Second slice (ADR 0029): on the window's wgpu device the stage tiles are drawn straight into textures egui shows (no readback; a headless device with readback when the window is on OpenGL); masks (nested, united artwork), group opacity and all 14 blend modes on the GPU, same parity (max 1/255, mean ≤ 0.0011/255); 4K: 1,000 shapes in 2.1–2.4 ms, 10k shapes in 10.2 ms as stage tiles, masked scenes 7× the CPU. Third slice (ADR 0032): bitmap fills (textures uploaded once per image and cached under a 256 MB budget, sampled with the oracle's own bilinear filter, colour effect and repeat rules: byte-identical) and all seven filters (each filtered symbol drawn into a layer of its own and filtered by compute passes that run the oracle's resolved steps: max 1/255, mean ≤ 0.007/255) on the GPU; the shaders now build with Direct3D's FXC, so DX12 windows get the GPU stage too (parity suite green on Vulkan and DX12); software adapters are refused (the CPU is faster), the start-up self-test compares with the oracle. The GPU is the default stage renderer: the shell's gpu-stage feature is on by default, Preferences › Stage › Renderer defaults to Graphics card (GPU), and the CPU draws whenever there is no usable card, a tile is past the GPU's limits (more than 16 images, filters nested deeper than 4) or anything fails. 4K: the filtered sample in 3.9 ms (CPU 31.5), 200 bitmap fills in 4.4 ms (CPU 37.2). Fourth slice (ADR 0048): tile binning on the GPU for heavy frames without masks or groups (count, prefix sum, scatter and tile-list passes, no atomics, no readback; the CPU binning stays the reference and does the rest; one tile format for both: an integer backdrop per tile and steps on the tiles' left edges): on Vulkan, 10k shapes at 4K in one texture 21.7 → 4.7 ms, 50k shapes 122 → 22.5 ms, the 50k-shape 4K stage 75 → 37 ms (Direct3D 12 keeps CPU binning: slower there in stage tiles); and hairlines for outline mode in both renderers (coverage by distance, one edge per segment): onion outlines on the 2,000-item stress scene as fast as tinted (GPU stage 73 → 10 ms, CPU stage 34–39 → 17 ms at 1080p). Not yet: sharing a filtered layer across a frame's tiles, more than 16 images per tile, GPU binning inside masks and groups, flattening and stroking on the GPU, buffer reuse and fewer dispatches across tiles, hairlines for sub-pixel strokes, GPU exports, a GPU runner in CI; the CPU stays the oracle and the export path. |
| Timeline | Frame selection: click, Shift-click or drag across frames and layers; F5/Shift+F5, F6/F7 and Shift+F6 (keys, buttons and right-click menu) act on the whole selection; drag selected keyframes left or right to move them, and up or down onto other layers (the source keeps empty frames, as in Animate) (with a drop outline; one undo step; keys they land on are replaced, and spans fill the frames left behind); removing or clearing selected frames that hold artwork asks first. Cut/Copy/Paste Frames (Ctrl+Alt+X/C/V, and plain Ctrl+X/C/V after clicking the timeline): own clipboard, copies cut exactly at the selection edges (mid-tween state kept), paste inserts like Animate, several layers paste onto the layers below (missing ones are created), fresh element ids, symbols travel with them. Span length by dragging its end (resize cursor, live outline with the length in frames and seconds; later frames move with it). Headless: layers/count on the frame commands, timeline.move_keyframes, timeline.cut_frames/copy_frames/paste_frames. Layers (show/lock/outline), keyframes, blank keyframes, insert/remove frames, classic tweens with 8 easing presets + curve preview, shape tweens (morph between any two shapes: segments made cubic, subpaths paired by size and grown from or shrunk to a point when counts differ, segment counts equalized by subdivision, windings matched and start points aligned; amber spans; classic ⇄ shape keeps the easing; shape hints (ADR 0023): Modify › Shape › Add Shape Hint (Ctrl+Shift+H) adds lettered markers a–z that the artist drags onto an edge on the first and last keyframe (rose until placed, amber placed on the first, mint on the last; right-click removes), the morph cuts both outlines at the hinted points and matches the pieces in order by length; tween.add_hint/move_hint/remove_hint/clear_hints/hints; not yet: View › Show Shape Hints, hints inside symbols edited in place), auto-key when editing inside a tween, frame labels, symbol nesting: graphics keep step with their timeline (loop, play once, single frame, first frame; set in Properties), movie clips loop their own timeline from when the instance appears (continuous across keyframes holding the same instance), buttons show their Up frame, looping playback. Onion skin and Edit Multiple Frames (ADR 0047): onion markers on the frame ruler (drag the start and end brackets; Always Show Markers, Anchor Markers, Onion 2 / Onion 5 / Onion All, also on a right-click on the ruler), frames before and after the playhead tinted in their own colours (theme blue and green, changeable in the onion menu, Reset) and fading with distance, Outlines, Keyframes Only, locked layers left out as in Animate, each layer's onion frames under its own artwork and over the layers below; options saved in the preferences; the stage's frame cache keys every look apart. Edit Multiple Frames shows every keyframe within the markers at full strength and selects (click, Shift-click, marquee, Select All) and moves (drag, arrow keys) artwork across them, one undo step, motion tween paths moving with their objects. Headless: frames.artwork, frames.edit_multiple. Edit Multiple Frames, complete (ADR 0051): Cut, Copy, Paste (current frame), Paste in Place (back keyframe by keyframe, or a one-frame copy onto every keyframe between the markers), Clear, Align (Ctrl+Alt+1…6, To Stage), Rotate 90° and Flip, and Free Transform of the selection on every keyframe about one shared pivot (one box, one undo step per drag); raw shapes moved, transformed or pasted merge again on their own keyframe; onion skin and Edit Multiple Frames inside a symbol edited in place, on its own timeline and markers. Headless: frames.transform, frames.align, frames.delete, frames.copy, frames.cut, frames.paste, frames.merge, merge on frames.edit_multiple. Not yet: per-layer onion toggles, Duplicate/Distribute/Arrange and recolouring across keyframes, scaling a motion tween's object on several frames, a draggable pivot, onion frames of the timeline around an open symbol. Mask layers: right-click a layer › Mask turns it into a mask over the layer below (Masked adds more layers to it); masked layers are indented under a stencil icon; the mask applies on the stage and in every export alike, and while the mask layer is unlocked its edge shows in the layer colour so it can be picked and reshaped; masked-away parts cannot be picked; layers moved in under a mask join it, moved out leave it, and a mask moves with its whole group; masks inside symbols nest. Headless: layer.toggle_mask, layer.set_type. Scenes (ADR 0011): the movie is an ordered list of scenes, each its own timeline, edited one at a time (scene menu on the edit bar, Insert › Scene, Modify › Scene, Shift+PageUp/PageDown); add, duplicate (fresh ids), rename, reorder and remove (asks when the scene has artwork; undoable); PNG-sequence and GIF exports play every scene in order. Layer folders: nestable folders (depth ≤ 16) holding layers and masks through Layer.parent, one invariant (Timeline::repair_masks: a child sits below its parent inside the parent's unbroken run; broken links fall back to the nearest valid ancestor); hiding or locking a folder hides or locks its contents (rendering, picking, drawing); folders open and close on the timeline (view state); layers move in and out with Up/Down, a folder moves with its contents; deleting a folder deletes its contents (asks first). Motion tweens (ADR 0016): a span's object animated property by property (x, y, scale, rotation, skew, alpha, tint), each property its own curve of property keyframes with a per-segment ease (presets or a custom cubic Bézier, overshoot allowed); auto-key turns any edit of the object inside the span into property keys (every command, through the session), F6 keys every property, splits and copies keep the motion; sky-blue spans with property-key diamonds; Motion Editor tab beside the timeline: property list with values at the playhead, curve graph with draggable keys and Bézier handles, one undo step per drag. Motion paths (ADR 0030): a motion tween may carry a cubic path its object travels by arc length, timed by the X/Y curves (a straight path reproduces them exactly, overshoot included); shown on the stage in the motion colour with a dot per frame when the object or span is selected; Selection drags the path to bend it and its ends to move them, Subselection drags anchors and handles; moving the object reshapes the path; Orient to path and Straighten in Properties; splits cut the path. Path points (ADR 0038): with Subselection, double-click the path to add a point (shape and motion unchanged), Shift-click to select several anchors, Delete to remove them (the path refits through the rest; the ends stay), right-click for smooth/corner and Straighten; the Pen's Alt-click adds a point to a motion path or a selected shape; Ctrl-drag (⌘-drag) the path or its object, or edit Properties › Path start, to move the whole path with its timing exact. Anchors pinned to frames (ADR 0049): moving the object at a frame pins a path point there (a new anchor where it was put; after the last position key the path carries on), and the object passes every pinned point exactly on its frame, the X/Y eases timing it between pins; pinned points are diamonds with their frame number on the stage, blue keys in the Motion Editor's X/Y (dragging one moves its point) and holed diamonds on the timeline; Subselection's right-click pins to the playhead's frame or unpins, Properties › Frame has Pin Here / Unpin, F6 pins where the object is; point edits keep pins on their anchors; files without pins evaluate exactly as before. Headless: timeline.create_motion_tween, motion.* (motion.set_path/clear_path/orient/add_point/delete_points/convert_point/move_path/pin_point/unpin_point; motion.info reports pins). Not yet: retiming a pin by dragging its key in time, two pins on one anchor, XFL motion path keyframes, a marquee over path anchors, nudging or transforming a whole path, retiming keys, rescaling keys with the span, XFL motion-tween import. Bones and IK, first slice (ADR 0043): the Bone tool (M) drags from one symbol instance to another to join them with a bone on an armature layer (chains join end to start, branches allowed, up to 256 bones); bones show as wedges in the layer colour; the Selection tool drags a bone or a posed instance to pose by cyclic coordinate descent (joint limits, pinned bones, one undo step per drag) and the root to move it all; poses are joint angles keyed per frame and tweened with the span's easing; Properties › Bone (angle, constrain min/max, pin, remove); bone.* headless; every export sees the pose. Not yet: shape armatures, spring, joint translation, runtime armatures, XFL import, editing members' properties in place. Camera layer (ADR 0027): the camera button in the timeline header or the Camera tool (C) adds a Camera layer on top; its frame shows on the stage in orange; drag to pan, turn with the round handle, wheel to zoom (one undo step per drag); Properties › Camera (position, zoom, rotation, tint, reset); keyframes and classic or motion tweens animate it; layer Depth gives pan parallax; View › Preview Through Camera shows the movie's picture (artwork tools pause there); hiding the camera layer turns it off; every export, Test Movie and the GPU stage see it. Headless: camera.add/remove/set/info, layer.set_depth. Not yet: editing through the preview, perspective depth, XFL camera import. Motion guides: guided layers (children of a guide through Layer.parent) have their classic tweens follow the guide's first path by arc length, from the point nearest each start keyframe to the point nearest its end (geom::walk::PathWalk), optionally orienting to the path; guide artwork is listed for picking and editing, drawn on the stage as a line, and never rendered or exported. |
| Drawing | Selection (click, shift-add, marquee, drag-move, arrow nudge; across layers, ADR 0044: a selection holds artwork on several visible, unlocked layers, the timeline marks them, Properties shows mixed values), Free Transform (Q): scale from corner/edge handles (Shift proportional, Alt from centre), rotate outside corners (Shift snaps 15°), move; one undo step per drag. Rectangle (corner radius), oval, PolyStar, line (45° snap), hand, zoom. Pen (P): click for corners, drag for smooth handles (Alt breaks them), close on the first point, Enter/Esc/last-point click finishes, Backspace takes back a point; one undo step per path. Pencil (Shift+Y): Smooth (Schneider curve fitting with corner detection), Straighten and Ink modes, smoothing relative to the screen. Subselection (A): anchors and handles on selected shapes, drag points/handles (anchors bring their handles; one undo step per drag), point marquee, double-click an edge to add a point, Delete removes points, right-click Make Smooth/Corner; closed shapes' start point and closing edge edit like any other. Cut/Copy/Paste in Center/Paste in Place (the clipboard carries symbols across documents). Rotate 90° CW/CCW, Flip H/V. Align left/centre/right/top/middle/bottom (Ctrl+Alt+1…6; a single element aligns to the stage) and distribute. Convert to symbol / break apart; arrange; duplicate. Headless: draw.path, draw.freehand, path.move_points/add_point/delete_points/convert_point. Paint Bucket (K): click a fill to recolour it, or inside an outline (one shape or several) to fill the enclosed area; gap size None/Small/Medium/Large closes openings; the fill is traced and curve-fitted into a new shape placed under its lines; open areas say so instead of flooding. Ink Bottle (S): gives the clicked shape the current stroke. Headless: paint.bucket, paint.ink. Tool options show first in Properties while a drawing tool is active. Text (T) (ADR 0012): click to type on the stage, click or double-click text to edit it; font (installed families, plus the embedded Inter), size, colour, bold, italic, alignment, letter/line spacing, wrap width; the last style is kept for new text; laid out by anicraft-text (fontdb discovery, harfrust shaping, skrifa outlines) and stored as outlines with the source, so rendering never needs the font; Break Apart makes a shape. Variable-width strokes (ADR 0018): a stroke's width varies along it through width points (position by arc length, a width on each side as a factor of the stroke width, smooth monotone interpolation); built-in profiles (Uniform, Taper both ends, Taper start, Taper end, Bulge, Pinch) in Properties › Width with a picture of each, and in the drawing tools' options for new strokes; the Width tool (U): hover a stroke to see its width points, drag a handle to widen or narrow (Alt: one side), drag the dot to slide a point, drag anywhere on the stroke to add one, Delete removes; one undo step per drag; rendered by the oracle as trapezoids with outer round joins and cross-section caps, written by SVG and Lottie export as the same filled outlines; shape tweens blend profiles; .anicraft keeps them (older files open as uniform). Headless: stroke.set_profile, stroke.set_width_point, stroke.delete_width_point, stroke.width_at, profile on element.set_stroke, the drawing commands and paint.ink. Not yet: width data from or to Animate files, saved custom profiles, pressure. Stroke styles (ADR 0046): Properties › Style (Solid, Dashed with dash and gap, Dotted with spacing), Cap (None, Round, Square), Join (Miter, Round, Bevel) and Miter limit, also in the drawing tools' options for new strokes; drawn exactly by the oracle (butt and square caps, miters bevelled past the limit, dashes by arc length restarting per subpath, round dots, dashes keeping a width profile's widths; sub-pixel patterns solid and faded) and so by the GPU stage; the Ink Bottle carries the style and the Eyedropper picks it; merge drawing keeps it on cut pieces; shape tweens blend miter limits and dash lengths; SVG, HTML canvas and Lottie export write it. Headless: stroke.set_style, and cap, join, miter, style, dash, dash_offset, dot_spacing on element.set_stroke, the drawing commands and paint.ink. Not yet: Animate's ragged, stipple and hatched styles, multi-dash patterns in Properties (kept and editable by command), stroke scale modes and hairlines. Merge drawing (ADR 0031, first slice): with Object Drawing (J) off, the editor's default, the shape tools, Pen and Pencil draw raw strokes and fills that cut and join the raw shapes they touch (a fill on top replaces what it covers or joins the same colour, lines cut each other and the fills they cross, a fill hides the lines under it, points within 0.2 px are one; exact Bézier pieces, anicraft_geom::planar); one element per fill region and stroke run, selected with Animate's dot pattern; double-click selects connected strokes, or a fill with its outline; a dragged or nudged raw shape merges where it lands; arrows move 1 screen pixel (Shift 10). Headless: object on the drawing commands (scripts draw objects by default), draw.object_drawing, draw.drop, element.select_connected. Selection tool on raw shapes (ADR 0041): drag an unselected segment or fill edge to bend it through the pointer (every shape sharing the edge bends with it), an unselected corner or end to move it with every raw shape that shares it, a fill to move only that fill; points and selections snap to points, strokes and fill edges within 10 screen px (snap ring), and arrow nudges join ends within 0.2 px at their midpoint or onto a line that stays put; a corner or curve mark by the pointer shows what a drag does; the marquee selects the parts of raw fills and strokes under it, cut at its edges (taken back if nothing uses them, no undo step), and objects wholly inside; each drag one undo step, merged on release. Headless: path.bend_segment, raw.move_point, raw.select_rect, raw.merge, raw.hit, snap on element.translate. Subselection on raw shapes and merging everywhere (ADR 0042): with Subselection (A), a click on a raw line or fill shows the anchors of everything connected to it (once per shared point; hollow, selected ones solid) and the handles of the selected anchors' curves and of the clicked edge; drag an anchor to move it with the other selected ones and every shape on them, a handle to change the curve in every shape that has the edge, a line or fill to move everything connected; Shift adds or removes anchors; the marquee takes whole shapes on the active layer and selects the anchors inside; arrows nudge 1 screen px (Shift 10); one undo step per gesture, merged on release. Snap to Objects (View › Snapping, a magnet under the tools, the selection tools' options) switches the Selection and Subselection tools' snapping. The Paint Bucket's raw fills are exact (up to the lines and fill edges, from the planar merge) and join fills of their colour; pasted raw shapes cut what they land on; raw shapes from Animate files open raw and merged; gradient and bitmap fills take part in the merge. Headless: raw.subselect, raw.subselect_rect, raw.points, raw.move_handle, with on raw.move_point, draw.snap_to_objects, object on paint.bucket. Not yet: width profiles in the merge. Raw points and symbols in place (ADR 0045): add a point on a raw edge (Pen Alt-click, Subselection double-click; every shape on the edge gets it, the curve unchanged), delete raw points (Delete; the shapes on each are joined across it so the drawing stays connected; points where three edges meet are kept), Make Smooth / Corner on raw points, smooth handle pairs (Alt breaks them; drawing objects too); the Line, Rectangle, Oval, PolyStar and Pen tools snap their points within 10 screen px (Snap to Objects, Ctrl+Shift+/); a double-click on an instance (or Ctrl+E, or a double-click in the Library) opens the symbol in place, the stage dimmed around it, the edit bar showing the path back, and every tool and command works on its timeline. Headless: raw.add_point, raw.delete_points, raw.convert_points, draw.snap, smooth on raw.move_handle and path.move_points, symbol.edit, symbol.exit. Not yet: rotated instances in place (they open upright). Onion skin and Edit Multiple Frames work inside a symbol since ADR 0051. Brush (B) (ADR 0033, first slice): paints filled shapes in the fill colour, the exact area the tip sweeps (a distance field traced and fitted with cubics); round or square tip with size, angle and roundness (oval and flat calligraphic tips), pen pressure from a tablet (10–100 % of the size; a mouse paints full size), smoothing relative to the screen, Paint Normal, Paint Fills and Paint Behind; a raw shape that merges with the drawing, or a drawing object with Object Drawing on; a click paints a dab; live preview while dragging; [ and ] change the size; one undo step per stroke. Headless: draw.brush. Not yet: Paint Selection and Paint Inside, a brush library, pressure curves and tilt. Eraser (E) (ADR 0034, first slice): sweeps the Brush's tip and takes what it covers out of the raw shapes on the active layer (the sweep is a fill in the planar merge that comes out empty); Erase Normal, Erase Fills, Erase Lines, Erase Selected Fills and Erase Inside; the Faucet deletes a whole fill or line with a click; drawing objects, symbols and text are kept; a stroke that erases nothing leaves no undo step; live preview, [ and ] sizes, one undo step per stroke; double-clicking the tool (or Erase Everything… in its options) clears the visible, unlocked layers at this frame after asking. Eyedropper (I) (first slice): a click on a fill picks its paint (solid, or a gradient or bitmap kept where it is on the stage, as Lock Fill) into the fill swatch, a click on a line picks its colour, width and profile; with shapes selected it applies the style to them; then it becomes the Paint Bucket or the Ink Bottle; Shift-click picks into the other swatch only. Headless: draw.erase, draw.faucet, draw.erase_all, paint.pick, paint.apply_style. Not yet: erasing inside symbols, erasing width-profiled shapes (gradient fills erase since ADR 0042), eraser pressure, picking a bitmap's pixel colour or text styles, an eyedropper cursor. |
| Plug-ins | WebAssembly plug-ins (ADR 0017, docs/plugins.md): sandboxed modules run by wasmi with no imports but the AniCraft ABI (anicraft.call/anicraft.response: JSON requests that run registry commands, read a compact document view or the active layer's elements, and log); fuel (10⁹ instructions), memory (256 MiB), wall-clock (5 s), request, size and log limits, a fresh instance per run; file, plug-in, undo and clipboard commands refused. plugin.install/list/run/remove/reload; a run is atomic and one undo step named after the plug-in. App: Commands menu (Plug-ins, Install, Manage, Reload), palette entries, a dialog generated from the manifest's parameters with a live preview; plug-ins load from <settings>/plugins or ANICRAFT_PLUGINS; CLI --plugins. Samples in Rust (Star Field, Jitter Selection, guest SDK) in examples/plugins. Frame scripts: see Interactivity. Not yet: exporter and easing kinds, background runs with cancel, a binary document view. |
| Interactivity | Frame actions, frame scripts and Test Movie, first slice (ADR 0024): a typed timeline action IR (anicraft-actions: stop, play, go to a frame or label in a scene, next/previous frame and scene, trace, set x/y/alpha/visible/rotation/scale, instance-name target paths) on keyframes and on button and movie clip instances (click, press, release, over, out); a pure, deterministic, budgeted player in anicraft-doc (step(doc, &state, &events); movie clip playheads, button Up/Over/Down states with Hit-frame hit tests, script-set properties) drawn by evaluate_player, while evaluate and exports stay script-free. Actions panel (F9: structured lists, targets/labels/scenes picked from the document; movie clip timelines too), instance name and events in Properties, an "a" on keyframes with actions. Frame scripts on the plug-in host (kind: "frame-script", entry points, player/action ops, 20 M instructions per frame shared, no document access). Test Movie (Control › Test Movie, Ctrl+Enter): the player at the document frame rate in its own window with the pointer, restart/pause/step and an Output panel. Headless: actions.set/clear/list, instance.set_name, control.test_movie (timed pointer events, returns output and state). HTML canvas export (ADR 0028, file.export_html, File › Export › Export HTML Canvas…): one self-contained page (data, player and drawing code inline; images and sounds embedded) that plays in any browser with canvas 2D; every used timeline baked frame by frame (tweens of every kind exact, identical paths, paints and frames stored once), movie clips, buttons with Hit areas and every action run by player.js, a port of the Rust player checked against it step by step in Boa (state, output and display list); masks and fading/blending groups on offscreen layers; Web Audio for Event/Start/Stop/Stream sounds; filters, Subtract/Invert, bitmap tints and plug-in frame scripts reported. Kept frame scripts (ADR 0013 tier 1): scripts written in another language (an Animate document's ActionScript) kept verbatim on keyframes with their language, symbol linkage classes and the document class; the Actions panel's Script view (monospace editor with line numbers, language, live and undoable), the same "a" marker, Class rows in Properties; script.set/clear/list/set_class; ActionScript timeline subset runs (ADR 0013 tier 2): a hand-written, bounded lexer and parser (anicraft_actions::as3) lower stop/play/go to/next and previous frame and scene on instance-name paths, mouse listeners (click, down, up, roll over and out; named or inline functions, currentTarget), trace and property settings to the action IR, compiled once per script; anything else is reported with line and column and the script doesn't run (never half-run), navigateToURL and the like are ignored and noted; the player keeps listeners per instance, Test Movie's Output says which scripts run and which don't and why, the Script view lists problems in place, the XFL report and script.list/check say what runs, and the HTML page runs the same steps (player.js checked against the Rust player). Not yet: ActionScript variables, conditions, reading properties, removeEventListener, enter-frame and keyboard events, functions from other frames, event bubbling, ActionScript 1.0/2.0, scripts on instances, filters and keyboard focus in the HTML page, sound actions, keyboard events, variables, persistent script state, masks in hit tests, a separate OS window. |
| Headless | CLI: info, render, render-seq, gif, commands, exec, run, serve (JSON-lines). MCP server (anicraft-cli mcp, docs/mcp.md): stdio JSON-RPC, protocol 2025-06-18 (and 2025-03-26, 2024-11-05); five tools over the command registry (list, run, run a script, describe the document, render a frame as a PNG picture); confirmation tiers and undo apply as in the app. |
| Sound | Audio layers, first slice (ADR 0020): WAV (own reader), Ogg Vorbis (lewton) and MP3 (nanomp3) import, bounded and crash-proof; sounds live in the library, stored in .anicraft as imported, decoded once in the background. A sound belongs to a keyframe as in Animate (Properties › Sound: name, Sync Event/Start/Stop/Stream, Repeat ×N or Loop); Import to Stage puts one on a new layer spanning its length, Import to Library only adds it, the Library previews, places and deletes sounds. The timeline draws each sound's waveform over its span. Stage playback plays the mix through cpal (default feature sound-output) and the playhead follows the audio clock; stream sounds resync after a jump and scrubbing plays one-frame snippets. Mixing is pure and sample-exact (doc::sound::voices + audio::mix, Catmull-Rom resampling between rates). Headless: sound.place/set/remove/rename/delete, file.import_to_library, file.export_audio (WAV, 16/24-bit or float, any rate), and Export Video carries the soundtrack (Opus in WebM, AAC in MP4, by the user's ffmpeg). Second slice (ADR 0039): each frame sound has an Effect (None, Left channel, Right channel, Fade left to right, Fade right to left, Fade in, Fade out, shaped over the time it is heard, or Custom: up to 16 volume points per channel in the Edit Envelope window, drawn on each channel's waveform; the timeline's waveform follows the envelope). Layers holding sounds get a Volume and Mute (Properties, and a speaker toggle in the timeline); volumes multiply down through symbols and muted layers are silent in playback and every export. Sounds inside symbols play: a graphic's on its own frames mapped to the parent's time (loop mode and first frame apply; streams join mid-way and follow the parent playhead), a movie clip's on a loop from when the instance appeared; in the interactive player and Test Movie (which now has sound, the picture keeping time with it) movie clips start theirs as their own timelines reach them. The HTML page carries envelopes, volumes and graphic sounds. Headless: sound.set {effect, envelope}, layer.set_volume, layer.toggle_mute. Not yet: sounds on button frames, sound panning beyond the envelope, sounds from XFL (Animate keeps sound data in an undocumented binary form, so neither sounds nor their envelopes come across), audio in Lottie, stream sounds that follow go-tos in the HTML page, lossless compression of stored WAVs, latency compensation. |
| Files | .anicraft JSON load/save (v3, with scenes; v1 and v2 files open as one scene), PNG frame and sequence export, animated GIF export (parallel render and quantize, exact frame timing, looping), SVG frame export (from the same evaluated frame as the renderer: stage-space paths, renderer-matched stroke widths, caps, joins and dashes, gradients under gradientTransform, colour effects baked in, masks as nested clipPaths). Opens Animate documents (.fla, .xfl, XFL folders; ADR 0009): stage, first scene, layers, keyframes, labels, classic tweens with ease, shapes (solid/linear/radial fills, strokes), groups, primitives, symbol instances (matrix, alpha, tint, loop, blend mode, all seven filters), library symbols, shape tweens, layer folders and mask layers (masks inside folders too); imported files are untitled so Save never overwrites them; what isn't supported yet is reported after opening. Every scene comes across. Bitmaps: library items whose image is in the package as PNG or JPEG (the original in LIBRARY/, else the bin/ data file when it is PNG or JPEG), instances, and bitmap fills with their matrix (twips scale removed; repeating unless clipped); Animate's own bitmap encodings are not public and are reported, not decoded. Text (ADR 0014): static, dynamic and input text fields become text blocks laid out by anicraft-text, with face (by PostScript name, family, or the family the name suggests; _sans/_serif/_typewriter), size, colour, bold/italic, alignment, letter and line spacing, margins, matrix, fixed width (wraps) or auto-size, and several lines; runs in different styles become one block per run of same-style lines, stacked as in Animate; a line mixing styles takes its main style and is counted; missing families fall back and are named in the report; dynamic/input fields come across as static text (reported). Shape hints on shape tweens (a tolerant self-authored shapeHints reader, ADR 0023). Brightness colour effects (as a tint towards white or black), movie clip and button instance names, one-segment custom eases (as cubic Béziers); a symbol without symbolType is a movie clip; frame comments aren't labels. Stroke caps, joins and miter limit, dashed and dotted strokes (ADR 0046; ragged, stipple and hatched are drawn solid and reported). Reported rather than silently changed: gradient strokes, repeating/reflecting, focal-point, elliptical and linear-RGB gradients, advanced colour effects, reverse loop modes, extra tween spins. A self-authored corpus with golden renders covers all of it (ADR 0035). No per-character styles or motion tweens from XFL yet; frame scripts are kept verbatim (scenes and every symbol, with the language from the publish settings), with symbol linkage classes and the document class, and the report lists them as kept, not run (ADR 0013 tier 1; scripts on instances and linkage on bitmaps and sounds are reported); Import to Stage (Ctrl+R) for SVG drawings: editable shapes on a new layer at the playhead, with groups, use and symbols, transforms, viewBox, styles, opacity and gradients; clip paths and opaque masks (ADR 0021) become mask layers in a folder named after the file (clips that cut nothing dropped, clips inside clips intersected exactly when all but one are convex polygons, curves kept), and text becomes text blocks, one per text chunk (position, anchor, font family list, size, weight, style, letter spacing, fill), with missing fonts named; stroke caps, joins, miter limits and dashes come across (ADR 0046); soft masks, per-character positions and text on a path are reported, as is anything else unsupported. Sprite sheet export: movie frames on one PNG grid (parallel render, columns/padding/scale, transparent or stage background) with a "JSON hash" frame map (rectangles, sizes, per-frame durations). Video export: WebM (VP9) or MP4 (H.264) by streaming raw frames, in order and rendered in parallel batches, to the user's own ffmpeg (no encoder bundled; ffmpeg from a parameter, ANICRAFT_FFMPEG or the PATH; argument lists, never a shell). Lottie export (file.export_lottie): frame-accurate rather than re-keyed: each frame is evaluated, artwork that persists (same layer, element, occurrence and path structure) becomes one shape layer with outlines baked to stage space, and whatever changes (outlines, colours, gradient points, stroke width, opacity, masks as layer masks) is written as hold keyframes where it changes; one layer order consistent with every frame (topological); checked against the reference web player (matches the renderer). Reported, not exported: bitmap fills, nested masks (innermost kept), group fades (per shape), stretched radial gradients (circles). HTML canvas export (file.export_html, ADR 0028): one self-contained web page that plays the movie, buttons and actions included (see Interactivity). |
| Library | Library management, first slice (ADR 0050): nested folders (New Folder, rename, drag items and folders in and out, Move to; deleting a folder that holds items asks), inline rename (F2 or double-click the name; names unique per folder, case aside), Duplicate Symbol (fresh ids, same folder, “Ball copy”), Swap Symbol in Properties (keeps transform, colour effect, filters, looping and name), a use count column, Select Unused Items and Delete Unused Items (unused = not reachable from any scene; linkage classes count as used; asks first), deleting used items asks and removes their instances, fills and keyframe sounds, sort by name, type, use count or date added, search (opens the folders that lead to a match), multiple selection, a preview (a symbol's first frame from the oracle, a bitmap as smoothed or not, a sound's waveform with play) and item properties (symbol type and linkage class, bitmap Allow Smoothing, which the oracle, the GPU stage, SVG and HTML honour). Folders are a side table in the document (older files open flat); XFL import keeps folders and Allow Smoothing. Headless: library.items/new_folder/rename/move/duplicate/delete/unused/delete_unused/set_smoothing, element.swap_symbol. Second slice (ADR 0053): drag items onto the stage (symbols and bitmaps land at the pointer on the active layer at the playhead, sounds go onto its keyframe; several at once; one undo step; inside a symbol open for editing too), Place on Stage (button, right-click, or Enter) at the centre of the view, Swap Bitmap in Properties (a placed bitmap keeps its corner and takes the new size; a bitmap fill keeps its shape), a Convert to Symbol dialog with name, type and folder that offers the last folder and type again, and "mixed" on every Properties row for several elements (Scale, Rotation, Alpha, Symbol, Type, Filters, Blending, Looping, First frame, Fill, Bitmap, Stroke, Width, Style; each row compares only the elements it edits; editing a mixed row sets all, and Type sets every selected instance's symbol). Headless: library.place {items, x, y} (and sound), element.swap_bitmap, kind and folder on modify.convert_to_symbol. Not yet: shared libraries and importing items from another document, linkage on bitmaps and sounds, bitmap compression, dropping files from the desktop, a picture of the item while dragging, Swap Bitmap on a Library item (every use), mixed text style rows, a Colour Effect row with tint. |
| Tests | 133 tests (adds point editing, closed-path anchors, curve fitting, pen/pencil/subselection commands, the Pen's path data, frame ranges, keyframe moves, range confirmations, frame selection and the frame clipboard): unit, analytic render, band/determinism, robustness fuzz over all commands, round trip (v1 and v2 files), structural sharing and history budget, render-service equivalence, confirmations, clipboard, transforms and align, GIF decode and timing, free-transform maths, UI-guideline enforcement, CLI. |
| Ease of use & safety | Visual language (ADR 0008, revised): graphite palette, corners by role (square structure, softened controls, rounder menus and dialogs with soft depth), borders only between layout regions, flat buttons with a visible focus ring, vibrant timeline blocks (mint artwork, violet tweens), sentence-case headings, collapsible sections with rules (Preferences, Properties, dock, shortcut sheet), Lucide icons stroked as vectors via a new full SVG path reader; click targets ≥ 28 px (tools 40, rows 28, toggles 24); palette contrast, target sizes and "no raw colours or radii" are enforced by tests. Product principles written (docs/product-principles.md). Tiered destructive-action confirmations, enforced in the engine (ADR 0004). Unsaved-changes guard on close/new/open. Crash-recovery autosave (ADR 0015): unsaved work is copied in the background (every minute or 25 changes by default; Preferences › Files › Autosave, with an off switch) to Recovery in the settings folder, atomically and never over the user's file; an OS file lock per running window tells crashed sessions from open ones; the next start offers what was left behind in a non-blocking window (Restore as unsaved work with its original path, Discard with a second click, Later; File › Recover Autosaved Documents… brings it back); saves and clean exits remove the copy; headless file.recovery_list/recover/discard_recovery/autosave. Not yet: several open documents, older copies, the undo history. Overwrite checks for saves and exports. "Ctrl+Z to undo" hints. Command palette (Ctrl+K). Shortcut sheet (F1). Right-click menus on stage, frames and layers. Save As (Ctrl+Shift+S). Shortcut editor (F1): every menu command, tool and view key can be rebound, given extra keys or unbound; recording asks before taking a key from another action, reserved keys (palette, editor, Preferences, quit, play, Esc, Space, Tab) stay fixed, per-action and global reset; only the changes are saved in preferences, so untouched actions follow new defaults; menus, tooltips and the palette show the keys in effect. |
| Platforms & preferences | ADR 0006 platform layer: ⌘ shortcut labels and an AniCraft app menu with a unified title bar on macOS; Exit and Preferences (Ctrl+U) on Windows and Linux; native file dialogs (XDG portal on Linux, with a fallback switch); wgpu with automatic OpenGL fallback; per-OS settings folder. Web editor, first slice (ADR 0036, docs/web.md): the same program built for wasm32-unknown-unknown runs in a browser (WebGL2), built by scripts/build-web.sh/.ps1 with the wasm-bindgen CLI into web/ (8973 KB, 3278 KB gzipped). Open and import with the browser's file picker; save and export as downloads (the engine reads and writes through engine::vfs, memory in the browser). Autosave and preferences in browser storage, with Web Locks so only closed or crashed tabs' work is offered. Leaving with unsaved work asks first. Every crate builds for wasm32 in CI, and the engine's tests run inside WebAssembly in Node. Not yet: a browser-verified run, sound (Web Audio), the GPU stage on WebGPU, video export, plug-in installs, PNG sequence as one zip, IndexedDB for large autosaves, threads, hosting. Preferences window: theme (Graphite or High contrast), interface and data fonts (bundled default or any installed font), interface scale (75–200 %), stage render mode, file dialogs, reset confirmations. Edits render live (fixed the missing-repaint bug). Not yet: native macOS NSMenu, macOS/Linux CI runners. Verified on Windows only so far. |
| Installers & release | Packaging (ADR 0026, docs/release.md): the Craft family's packaging/ layout behind the shared release workflow. Windows MSI (x64, arm64; per-user by default, everyone on request, upgrades in place), portable and symbols zips; macOS universal DMG with a laid-out window and CLI zip; Linux AppImage, deb, rpm, tar.gz, Flatpak and Arch (x86_64, aarch64; riscv64 deb/rpm/tar). .anicraft opens AniCraft by default; .fla/.xfl offered under Open with. Signed and notarized on the release branch (missing secrets fail it), unsigned elsewhere; ends in a draft release. Packaging lint and a fixture WiX build guard PRs; src/packaging_tests.rs keeps ids and types in step. Not yet: double-clicking a document in Finder opens it (the app starts, the file doesn't open), AppImage desktop integration, portable mode, store listings, video export inside the Flatpak. |
| Languages | First slice (ADR 0040, docs/localisation.md): every shell string goes through tr!/trn! (keyed by its English; placeholders; CLDR plurals for whole numbers), menus translate the registry's labels when drawn (ids, CLI, MCP and the file format stay English), screen-reader names too. Catalogs are craft-i18n's TSV, read by our own parser and embedded from CRAFT_I18N_DIR (fallback app → shared → base language → English). Preferences › Appearance › Language (system language by default) and --lang. A pseudo-locale (--lang pseudo: accented, a third longer, bracketed) tests layout; checked by a source guideline test and a pseudo-locale accessibility audit; scripts/i18n-extract.sh writes the translators' template and per-locale coverage. Not yet: a real language (craft-i18n has no anicraft.tsv yet), engine messages and confirmation bodies (@msg), default document names, right to left (needs bidi and shaping in egui upstream), CJK and Georgian (need a font), shaped scripts. |
| Accessibility | First pass (ADR 0022, docs/accessibility.md): AccessKit (via eframe) gives every control a name and role, checked by a headless test that walks the tree in 23 interface states (custom-painted tools, layer rows and toggles, icon buttons, Library rows, every Properties field, the Motion Editor, every dialog; the stage is a named canvas; the status bar a polite live region). Ctrl+F6 / Ctrl+Shift+F6 move focus between Stage, Timeline, Properties, Library and Tools (rebindable); focused controls keep Enter/Space/arrows while other shortcuts still work; pointer-only surfaces are not Tab stops. High contrast palette (Preferences › Theme) from the same roles, text ≥ 7:1, controls and focus ≥ 3:1; both palettes checked by the contrast test (the graphite one now meets AA everywhere). Interface scale 75–200 % holds up (stage refits, tools and timeline header scroll, status truncates). Not yet: stage elements and single frames exposed one by one, keyboard menu bar, following the OS contrast setting, manual passes with Narrator, VoiceOver and Orca. |
| Stage rendering & build | Tiled stage (ADR 0007): 512 px cached tiles, batched per frame with one scene evaluation per frame, look-ahead ring and playback prefetch, scaled older tiles instead of blank areas, pixel-aligned (no seams). Space-biased build: debug build 6.9 GB → 1.04 GB, fresh build 44 s, edit rebuild 4–6 s (docs/development.md). |
| Scale & performance | Pulled forward from M2: persistent document with snapshot undo (memory-budgeted history, save-point dirty tracking, History panel), background render worker with frame cache and playback look-ahead, band-parallel renderer with culling, compact streaming file format v2, anicraft-cli bench. Measured numbers are in docs/performance.md. Memory, sharing, file-size and culling budgets are a test on every PR; timing budgets are anicraft-cli bench --check yes (all met; the 1080p render is 15.3–15.8 ms against 16.7 ms). |
Milestones
| M | Theme | Exit criteria |
|---|---|---|
| M0 | Foundations (this version) | Workspace + layering; document model; timeline evaluation with classic tweens and easing; CPU oracle renderer; command registry with undo; .anicraft; CLI render + JSON-lines; egui shell with stage, tools, timeline, properties, library; --screenshot. |
| M1 | Authoring core ✅ (v0.1.0) | |
| M2 | Model at scale | Arc structural sharing (O(changed) undo)bench --check on a known machine, CI once a benchmark runner exists); src/architecture_tests.rs, runs with cargo test). |
| M3 | GPU stage (in progress; the default stage renderer since ADR 0032) | gpu-stage on by default for the app, automatic CPU fallback); next: GPU binning inside masks and groups, shared filtered layers across tiles, an image atlas, GPU exports. |
| M4 | Interchange (in progress) | XFL import (DOMDocument.xml, symbols, edges/fill styles decoded from the public format descriptions) with a corpus of self-authored files: first slice ✅ (see Files above); .fla variants of the corpus, sound and video items; |
| M5 | Rich media | harfrust shaping, skrifa outlines, line wrapping, outlines stored with the text; per-character styles, text on a path and input fields later); cpal output); |
| M6 | Interactivity & extensibility | Plug-ins: the Craft-family WebAssembly system (same host model as PhotoCraft: wasmi sandbox, plugin.* commands; AniCraft ABI for vector/timeline operations and exporters): first slice ✅ (command plug-ins over the registry, ADR 0017; exporter and easing kinds later); script.* commands); flash.* API and SWF bytecode are not planned. |
| M7 | Advanced animation | |
| M8 | Release quality | packaging/ layout, MSI, DMG, AppImage/deb/rpm/Flatpak/tar.gz, .anicraft registered everywhere, signing wired to the release environment; next: opening documents from Finder, AppImage desktop integration, portable mode, store submissions); tr! everywhere in the shell, craft-i18n catalogs, Preferences language, pseudo-locale; next: AniCraft's catalog in craft-i18n, engine messages, right to left once egui can lay it out); accessibility: first pass ✅ (ADR 0022: screen-reader names for every control, Ctrl+F6 panel focus, high-contrast theme, 200 % scale), next: stage elements and frames for screen readers, keyboard menu bar, the OS contrast setting; |
Releases
v0.1.0 (early alpha) marks M0 + M1 complete (see CHANGELOG.md). main starts with
that one commit; publishing it follows the checklist in docs/release.md.
Parallel tracks (from 2026-11-09)
Milestones whose next task needs no unfinished work from another milestone run at the same time,
one agent per track (AGENTS.md › Milestone tracks). Each task is still its own PR to main,
titled with its milestone.
| Track | Next task | Depends on (all done) |
|---|---|---|
| M2 | Motion tweens with property curves and the Motion Editor | timeline evaluation, classic tweens |
| M3 | GPU stage: GPU binning inside masks and groups, filtered layers shared across a frame's tiles, more than 16 images per tile (first slice ✅ ADR 0019, no readback and masks/groups ✅ ADR 0029, bitmaps, filters and the default ✅ ADR 0032, GPU binning and hairlines ✅ ADR 0048) | CPU oracle, tiled stage, GPU stage slices 1–4 |
| M4 | Text from Animate files | XFL import, text engine (M5 first slice) |
| M5 | Audio layers: import, waveform, playback sync | timeline, layers |
| M6 | command registry, plug-in host, action IR and player | |
| M7 | strokes, Pen and Pencil, width profiles, timeline evaluation | |
| M8 | .anicraft format, session, AccessKit in eframe |
Tasks that wait on an open track: XFL motion tweens (on M2's motion tweens); frame scripts and ActionScript (on M6's plug-in host).
Current focus (after M0 + scale foundations)
The person confirmed that opening Animate files (XFL) is the first interchange priority. The undo/performance foundations it needs are in place, so XFL import (M4) can move up once the authoring core below is solid.
Landed in M1 so far: Free Transform, clipboard, rotate/flip, align/distribute, GIF export, and
now Subselection, Pen and Pencil on a path-editing model in the engine (points addressed by
command and slot, so XFL edge data can map onto it). The Pen's interaction and the Pencil's
curve fitter were borrowed from PhotoCraft and reviewed before porting (see
src/pathtools.rs and crates/geom/src/fit.rs for what changed and why). PolyStar no longer
has a key (P is the Pen, as in Animate).
Next, in order:
- Raw drawing as in Animate (issue #42, a user's detailed report). Merge drawing's first
slice (ADR 0031, outside contribution #92) makes the shape tools draw raw strokes and fills
that cut and join. Still to match the report, first-party:
Selection tool on raw drawings (ADR 0041)✅: drag an unselected segment to bend it; drag an endpoint or corner to move it, moving every shape that shares the point; snap dragged points to points, strokes and fill edges within 10 screen px, and keyboard moves within 0.2 document px; a marquee that selects the parts of fills and strokes under it (cut at its edges); Shift adds. Not yet: snapping while drawing.Selection across layers (ADR 0044)✅: a selection is a set of (layer, element) pairs; the marquee, Shift-click and Select All work across visible, unlocked layers (raw parts cut and re-merged per layer); move, delete, duplicate, arrange, transforms, colour effects, filters and break apart act on each layer; align, distribute, Free Transform and copy act across them; paste keeps each layer; Convert to Symbol keeps the layers inside and lands on the topmost; the timeline marks layers with selected artwork, and a click on a layer's name selects its artwork; Properties shows mixed values. Not yet: armature instances from inactive layers in a marquee, "mixed" on every Properties row.Subselection on raw drawings, and merging everywhere (ADR 0042)✅: hollow anchors on connected raw shapes, handles on curves, point marquee on the active layer, dragging a segment or fill moves what is connected, arrow keys; Snap to Objects (View › Snapping, the magnet); the Paint Bucket's fills (exact, up to the lines) and pasted raw shapes merge; raw shapes from Animate files come in raw; gradients take part in the merge. Not yet: width profiles in the merge.Raw points and raw shapes inside symbols (ADR 0045)✅: add a point on a raw line or fill edge (Pen Alt-click, Subselection double-click), shared by every shape on the edge; delete raw points (the shapes on them joined across, the drawing kept connected; a line's last points remove it); Make Smooth / Corner on raw points; smooth handle pairs (Alt breaks them; drawing objects too); the Line, Rectangle, Oval, PolyStar and Pen tools snap while drawing; Snap to Objects is Ctrl+Shift+/; symbols open for editing in place (double-click an instance or a Library symbol, Ctrl+E; the edit bar's path back), where merge drawing, Selection and Subselection work as on the stage. Not yet: in-place editing of rotated instances (they open upright), deleting a point where three edges meet. (Onion skin and Edit Multiple Frames inside a symbol: ADR 0051 ✅.)
- M4 XFL import, next slices:
masks (with M2 mask layers)✅,shape tweens✅,every scene✅,bitmaps✅ (PNG/JPEG data),text✅ (one style per line; per-character styles with the text model), motion tweens, anda larger self-authored corpus checked by render tests✅ (ADR 0035). SVG import✅ andSVG frame export✅,text, clip paths and masks (onto mask layers)✅ (ADR 0021).dashes✅ (ADR 0046). Next for SVG: soft (luminance) masks, per-character text positions and text on a path.
Risks
| Risk | Mitigation |
|---|---|
| GPU and CPU renderers drift apart | Golden parity tests in CI; CPU stays the oracle. |
| XFL edge encoding is under-documented | Build a self-authored corpus; unknown elements kept verbatim; fail with readable errors. |
| egui immediate-mode cost with big timelines | Virtualise the frame grid (paint only visible cells); cache layer row summaries per revision. |
| Snapshot undo memory | Arc structural sharing in M2; history size cap with a preference. |