Code-first video & image, rendered natively on WebGPU.
@framefields/compositions
2.14.0
Minor Changes
976c782: Containers no longer clip their children by default:
overflowdefaults to"visible", as in CSS, so tilted badges, outside strokes and shaking titles are not cut at a parent's edge. Setoverflow: "hidden"where children must stay inside a box, such as a rounded card holding a square header or image. Text layers also make room for their own outside stroke and shadows, which used to be cut at the text box, and scale or rotate around their anchor within that room.01954c0: 3D scenes render in isolation. A box with a fixed size that holds a camera is its own scene: its camera, lights and environment see only its layers, it runs on its own clock, and it is placed like a picture, so
Layer.sequencetransitions between 3D scenes blend two finished pictures instead of drawing both through one camera. Signal tracks take{ clock: "layer" }to sample at the layer's own frame.comp.lint()reportsduplicate_id. Per-pass 3D buffers are recycled once per frame (per command encoder), so a frame holding several 3D scenes never reuses a buffer an earlier pass still reads, and bloom mip chains live until the frame is done. Size-dependent 3D render targets (depth, HDR, MSAA, reflections) are cached per size and kept for the frame, so scenes of different sizes can share a frame.976c782: Add opt-in geometry-aware scene outlines and art-directed toon lighting for meshes, 3D cards and native text. Outline widths scale with export resolution; exclusions retain occlusion, and ink follows fog before camera depth blur and bloom. Toon materials now use colored direct lights, point/spot attenuation and cast shadows, with configurable shadow/lit colors and terminators. Correct 3D card pivot transforms so changing an anchor does not move identity geometry.
Shade ink before the MSAA color resolve to preserve subpixel coverage between outlined surfaces. Custom cube-face artwork inherits surface settings while retaining explicit face overrides.
2.13.1
2.13.0
2.12.0
2.11.0
2.9.3
2.9.2
2.9.0
2.8.1
Patch Changes
- 7a1bac8: Support variable numbers of direct lights and skin joints, and render independent shadows for multiple directional and spot lights.
2.8.0
Patch Changes
b1a40b4: Bound frame-grid sample generation before allocation, validate numeric sampling inputs, and keep automatically chosen samples inside the exported frame window. Render hooks and pixels now use one timestamp-selected frame; timestamp labels no longer change frame selection through rounding. Composition rendering rejects mismatching FPS overrides.
Fix sequence duration with outgoing overlaps and delayed layers that previously outlived their scene. Explicit scene-layer windows must fit their owning scene, and overlaps cannot exceed either adjacent scene. Frame indices and frame-range steps must be safe integers; fractional timestamps and FPS remain supported.
Add
framefields check <entry> --jsonwith isolated builder execution, schema/lint/timeline diagnostics, bounded worker lifetime and optional--renderframe/grid smoke checks. Scaffolds includecheckandcheck:renderscripts. Add JSON component/font discovery and an API reference generated from the owning timing/preflight types viaframefields api.Normalize animation-builder inputs to strict program specs at the layer-builder boundary. Ambient light helpers now also accept an options object, consistently with other light helpers, while preserving positional color/intensity calls. These fixes allow the launch example to pass schema preflight.
2.7.0
Minor Changes
- 18aece7: Add forward and reverse media time remapping for video and audio layers, including smooth ramps, video holds, silent audio holds, source range checks and clip vision synchronization. Reverse video decoding uses a bounded frame cache.
- e56c7f5: Drive media
timeRemapfrom a signal:{ kind: "signal", mode: "speed" | "source-time", signal }accepts a signal instance or a named composition signal. Without frame hooks the signal is sampled up front; with hooks it is recorded live after each frame's hooks, replayed for seeks, audio, vision and the preview, and its source bounds are checked as it records.
2.6.2
2.6.1
2.6.0
2.5.5
Patch Changes
- demos
2.5.4
2.5.3
Patch Changes
- docs-fixes
2.5.2
2.5.1
2.5.0
2.4.3
Patch Changes
- Strict compile-time type safety across the engine harness:
- Branded types for coordinate and unit spaces (
Pixels,Normalized01,Degrees,Radians,Frames,Seconds,Hertz,Decibels). - Discriminated union types and capability-safe layer ports on
NodeEffect,Layernodes, and effect classes. - Compile-time exhaustiveness checking with
assertNeverand type-narrowed animation property targeting. - Schema and pipeline unification with generic node operations.
- Branded types for coordinate and unit spaces (
2.4.2
2.4.1
Patch Changes
- Speed up audio mixing for long timelines:
- Decode only the stretch of a source each clip plays, 0.5s early so MP3/AAC decoders warm up; samples match a whole-file decode exactly.
- Skip subtrees with no source and no sound-producing processor.
- Pass a lone child's buffer up instead of copying it per level.
- Read plain value signals once instead of once per sample.
- Keep up to 8 effect chunks in flight on the GPU before reading back.
- ffmpeg fallback: drop the 100 MB output cap and decode only the needed range.
2.4.0
2.3.2
2.3.1
2.3.0
Patch Changes
- 5c71a34: An audio layer's
volumeandmutedkeyframes count from the layer's own first frame, as a picture layer's do. They were read on the composition's clock, so any audio layer that didn't start at frame 0 was past its last key from its first sample: a fade-in[[0, 0], [6, 1], [len - 6, 1], [len, 0]]left every later clip silent, and keys had to be offset bystartFrameto play. Render QA already read the keys as layer-local and flagged that workaround asanimation_truncated; the mix and QA now agree.
2.2.0
Patch Changes
9b70fda: Asset and font paths no longer depend on the
BASE_URLandR2_CUSTOM_DOMAINenvironment variables, left over from the Gatewai web app. WithBASE_URLset, a font registered from an absolute path was fetched from$BASE_URL/<path>, and when that failed the engine quietly used a font from theR2_CUSTOM_DOMAINCDN instead of the project's file. Absolute paths are now always read from disk, and Lottie sources and fonts are used as given instead of being prefixed withhttp://localhost:8081.Removed from
@framefields/client-utils:getEnv,BASE_URL,R2_CUSTOM_DOMAIN,configureAssetUrlsand theoptionsargument ofGetAssetEndpoint,GetFontAssetUrl,resolveMediaSourceUrlandResolveFileDataUrl. Removed from@framefields/compositions:getFontUrl.
2.2.0-beta.4
Patch Changes
9b70fda: Asset and font paths no longer depend on the
BASE_URLandR2_CUSTOM_DOMAINenvironment variables, left over from the Gatewai web app. WithBASE_URLset, a font registered from an absolute path was fetched from$BASE_URL/<path>, and when that failed the engine quietly used a font from theR2_CUSTOM_DOMAINCDN instead of the project's file. Absolute paths are now always read from disk, and Lottie sources and fonts are used as given instead of being prefixed withhttp://localhost:8081.Removed from
@framefields/client-utils:getEnv,BASE_URL,R2_CUSTOM_DOMAIN,configureAssetUrlsand theoptionsargument ofGetAssetEndpoint,GetFontAssetUrl,resolveMediaSourceUrlandResolveFileDataUrl. Removed from@framefields/compositions:getFontUrl.
2.2.0-beta.3
2.2.0-beta.2
2.2.0-beta.1
2.2.0-beta.0
2.1.3
Patch Changes
- 71d48b4: Fail fast when referenced local media files cannot be opened or decoded during headless rendering, instead of silently resolving with black frames or silent audio.
2.1.2
2.1.1
Patch Changes
- rm aws bundle
2.1.0
2.0.11
Patch Changes
Physical 3D look, gradients, mattes, transitions and lint for agents:
Layer.environment(preset)/Lighting.studio|soft|sunset|dramatic(): GGX PBR with a procedural studio environment, emissive, exposure and tone mapping (PBR Neutral, AgX, ACES), soft shadow maps (castShadow), HDR bloom and fog. glTF normal, metallic-roughness, occlusion and emissive maps are now used.Colorhelpers (oklch,mix,ramp,lighten,contrast,readableOn, …);hsl(),oklch()and space-separatedrgb()accepted everywhere; color keyframes blend in OKLab.- CSS
linear-/radial-/conic-gradient()with up to 8 stops on any background or shape fill. - Track mattes (
withMatte(layer, "alpha" | "alpha-inverted" | "luma" | "luma-inverted")), on 2D and 3D layers; 3D layers keep their depth. Layer.sequence([...])withTransition.crossfade|push|slide|zoom|whip|wipe|iris|fadeThrough..animate()merges with existing tracks;FontManager.measure()text metrics.comp.lint()(also inrenderVideo({ qa })): unreadable colors/gradients, low-contrast text, off-canvas layers, shadow and environment misuse, static tracks.- Fixes:
Layer.shape({ fill })was ignored;Layer3D.planedropped material options; stale 3D camera buffer reuse between frames.
2.0.10
2.0.9
2.0.8
2.0.7
2.0.6
2.0.5
2.0.4
2.0.3
2.0.2
2.0.1
2.0.0
Patch Changes
- 985e6be:
LayerAnimation.signal()and.colorSignal()now accept a signal object (Signal.fromArray,Signal.builder, …) as well as a name registered withcomp.addSignal. Before, passing the object produced a meaningless handle id and the track silently did nothing (or picked up an unrelated signal). The object is carried on its track and registered with the program under a generatedinline_signal_Nid, so specs stay plain JSON. Values that are neither a signal nor a name now throw.
1.4.3
1.4.2
1.4.1
1.4.0
1.3.2
1.3.1
Patch Changes
- init