Roadmap
v1 — Core engine (@miraiclip/core) ✅ shipped
Commands, state, tracks, clips, undo/redo, patches, events, serialization. Headless, browser + Node, fully unit-testable. No rendering — proves the architecture first. Shipped as @miraiclip/core@0.1.0 (September 2026).
v2 — Rendering & playback (@miraiclip/renderer) ✅ shipped
WebCodecs-based decode pipeline with frame caching, a WebGL (PixiJS) compositor rendering project state to a canvas, and frame-accurate playback with the audio clock as the playback master. Proxy preview decode for 4K sources, golden-frame e2e coverage. Shipped as @miraiclip/renderer@0.1.0 (September 2026).
v3 — Export ✅ shipped
WebCodecs encode pipeline to MP4 (H.264 + AAC) and WebM (VP9 + Opus), offline (faster-than-realtime) rendering from project state via exportProject with pipelined encoding, progress events, cancellation, quality presets, and an output-fps option — verified end to end by a closed-loop e2e. Shipping as @miraiclip/renderer@0.2.0. See Export.
v3.x — Server-side export ✅ shipped
@miraiclip/server-export: the same exportProject running in headless Chrome on a server — exportProjectFile(docJson, options) and a miraiclip-export CLI hydrate the project in a browser harness and run the identical browser export path, so server output is pixel-identical to preview by construction. Built, integration-tested (real headless Chromium in CI), and verified end to end; Shipped as @miraiclip/server-export@0.1.0 (September 2026). See Server export. Also under v3.x: chunked offline audio rendering for long timelines.
v4 — Creative features ✅ shipped
Keyframe animations on clip properties (pure evaluator in core — preview, export, and server export all inherit it), shader-based effects with built-ins (color adjust, blur, chroma key), transitions (cross-dissolve, dips, wipe, slide) with equal-power audio crossfades, and reels-style karaoke captions (word-level timing, four highlight presets, SRT/VTT + ASR word-timestamp import, real font-asset loading in preview and export). See Rendering and the live Examples. Shipped as @miraiclip/core@0.2.0 + @miraiclip/renderer@0.3.0 (September 2026).
v4.x — Production readiness (in progress)
The stress tier is shipped: pnpm stress runs many-clip playback tracking, bounded-heap long exports, decoder churn with a scrub storm, throughput benchmarks (incl. optional 4K→1080p), and parallel server exports — nightly in CI with a metrics artifact. Measured numbers and known ceilings live on Production Readiness. Streaming export output and chunked offline audio shipped as @miraiclip/renderer@0.4.0 + @miraiclip/server-export@0.2.0 (September 2026) — export memory no longer scales with timeline length, demonstrated with a one-hour export at 165 MB of heap. An export validation corpus (ffmpeg-verified real exports, nightly) and a device benchmark tier guard correctness and presentation/seek latency; these tiers have caught and fixed real pipeline bugs before release. Still in v4.x: public registerEffect(), true overlapped audio crossfades, effect-param keyframes.
Beyond v4.x — explored
A template library (@miraiclip/templates — parameterized document generators over v4 primitives), a programmatic clip kind for code-driven graphics (charts, generative visuals) with export parity, and locked brand templates. See PLAN.md for the full exploration.
Parallel track — Adapters & ecosystem
@miraiclip/react hooks and selectors (Vue and Svelte adapters later), AI helpers exporting the command catalog as LLM tool definitions, and a collaboration reference implementation syncing commands/patches over WebSocket.