Skip to content
Changelog

What's new in elah

Release notes for the published packages — @elah/core, @elah/timeline, and @elah/editor ship together and share a version. @elah/cli is a separate package that versions independently.

Latest: v0.6.0View on npmCHANGELOG.md

v0.6.0

Latest

The premium editor port lands in the open-source packages: multiple video tracks, clip speed, crop and corner radius, layered text animation with 14 templates, frame sequences, stored project documents with media re-linking - and the eight defects found while verifying it.

Added@elah/core
  • Reading a stored project: readProjectDocument / isReadableProjectDocument / PROJECT_VERSION, plus relinkProjectMedia, which points restored clips back at the media library and reports missing blob:/data: sources instead of dropping them. engine.loadProject gained { transport, history } options and emits project:loaded.
  • Layered text and shape animation: TextAnimation.inMotion / outMotion are MotionSpecs (opacity, offset, scale, rotation, per-channel easing), with new back-*, elastic-out and bounce-out curves. The sampling helpers are public: sampleTextAnimation, resolveRampFrames, motionForKind.
  • Text templates: BUILT_IN_TEXT_TEMPLATES (14 looks), findTextTemplate and applyTextTemplate, which returns an undoable Partial<Clip> patch for engine.updateClip.
  • Clip.speed (0.25 to 4, video only; duration and export follow it), Clip.crop, Clip.cornerRadius, Track.protected and Track.pinned: "bottom".
  • Frame sequences: createFrameSequence, FrameSequenceController (scrub, wrap / pingpong looping), createFramePreloader and frameSequenceToProject, which lays a sequence out as image clips so it can be edited and exported.
  • Media library: beginImportUrl registers a pending remote asset that resolves later; probeHasAudio / determineAssetHasAudio; snapshotMediaLibrary / hydrateMediaLibrary carry the library across a page load. sourceBlobCache de-duplicates video downloads between the demuxer and the preview.
  • Two vanilla stores: textStylePresetsStore and clipLoadStore (renderer state, never part of the project or undo history). PerfSummary reports render-loop tick cost once a second on the PERF trace channel.
  • ExportOptions.outputHeight is now the short edge of the stage, so 1080 means 1920x1080 landscape and 1080x1920 portrait.
Added@elah/timeline
  • TimelineRef.zoomAtAnchor zooms anchored on the playhead. growClipToAssetDuration inserts a clip with a fallback length before its media is probed and grows it once the real duration is known; clips still loading show a shimmer.
Added@elah/react
  • useClipLoadStore and useTextStylePresetsStore.
Added@elah/editor
  • The barrel re-exports all of the above, including the vanilla clipLoadStore and textStylePresetsStore. New design tokens for the preview overlays and clip badge: --elah-overlay-*, --elah-spinner-*, --elah-clip-badge-bg, --elah-toast-shadow.
Changed
  • Multiple video tracks. addTrack("video") used to return the existing track; it now adds another. Video tracks composite in track order (the topmost lane draws on top), and a new video track goes directly below the last one.
  • Playback preferences (zoom, volume, mute, rate, loop, snap) are written to localStorage when they change rather than on every frame of playback. Same key, same envelope - nothing is lost.
  • serializeProject / deserializeProject are unchanged for consumers, now a facade over readProjectDocument. A document with no version stamp reads as version 1 instead of being rejected; one from a newer build throws ProjectDocumentError.
  • The timeline mounts only the clips inside the scrolled viewport (horizontal virtualisation), and the ruler shares one timecode formatter with the rest of the UI.
Changed@elah/cli
  • 0.1.2 - the build spec places every video clip on one track, so overlapping video clips are now a build error in the spec rather than something the engine rejects; the engine has allowed several video tracks since the multi-track change.
Fixed
  • Video frames could upload into a disposed GPU texture after a clip source changed. The layer read the texture before replacing the provider; a replaced provider now also inherits the reference count of the clip.
  • A preview loading spinner that could never clear after a failed decoder re-open.
  • A borrowed frame stretched to the stage between clips; the held-over frame is now fitted by its own dimensions.
  • The timeline ruler showed 00:90 instead of 01:30, and its ticks drifted from the clips at low zoom.
  • The clip loading shimmer had no CSS, and horizontal clip virtualisation had been silently dropped in the port.
  • Preview overlays and clip badges used hard-coded colours and could not be themed; they now read the --elah-* tokens.
  • Web playground: deleted media was resurrected from IndexedDB and its object URLs were never revoked.
Added
  • playground/ is now examples/. New examples/AGENTS.md (the integration contract in one page) and a root npm run verify:examples, the only check in the repo that exercises the published tarballs rather than local source.
  • /docs/installation corrected: the sample package.json pinned ^0.2.0, the transpilePackages and Vite optimizeDeps.exclude lists omitted @elah/react, and the peer-dependency section did not mention lucide-react.
  • Bundle sizes re-measured and the method fixed. BUNDLE_STRATEGY.md now quotes what a browser downloads (esbuild, minified, gzipped, code-split) instead of the raw tsc output the old badges used: ~64 KiB at startup for the full SDK with the demuxer injected, ~11 KiB engine-only, and ~227 KiB on the quick-start path because createDefaultDemuxerFactory imports mediabunny statically. Reproduce with node scripts/measure-bundle.mjs.

v0.4.1

Export works out of the box for npm consumers, and @elah/editor finally re-exports its full public API.

Fixed@elah/core
  • The MP4 export worker now resolves in installed packages. exportVideo spawned the worker via new URL("./ExportWorker.ts", …), but the published package ships only the compiled ExportWorker.js — so the specifier was unresolvable and any consumer bundler (Turbopack, webpack, Vite) failed on the @elah/editor barrel, on first page load rather than on export. The build now rewrites the extension in dist/ as its final step. Apps no longer need a postinstall patch script; if you added one, delete it.
Fixed@elah/editor
  • The barrel re-exports the full public API. 40+ identifiers were missing, including ones the docs told you to import from it: snapFrame, buildSnapPoints, resolveOverlapEdgeSnap, clipsOverlap, DEFAULT_OVERLAP_TOLERANCE, useTransitionsStore, useAssets, importBlob, createShapeClip, createFreehandClip, serializeProject, deserializeProject, warmImageSrc, preloadProjectImages, cn, EditorContext, the vanilla stores (tracksStore, playbackStore, selectionStore, transitionsStore, mediaLibraryStore), and their types. Renderer and debug internals stay @elah/core-only by design.
Added
  • AGENTS.md — the brief for coding agents working in the repo — plus docs/ai/ELAH_FOR_AI_AGENTS.md, a single self-contained integration guide for AI tools with no repo access (Lovable, Google AI Studio, Emergent, v0).
  • New playground/minimal example: the smallest complete custom editor UI, meant as the thing you point an AI at.
  • The playground/next and playground/react examples now import all three required stylesheets and declare the lucide-react peer dependency explicitly.
  • Corrected the /examples code samples, which did not compile against 0.4.x (exportVideo options, ExportProgress shape, the DemuxerBackend interface, and ActiveTextClip field access).

v0.4.0

New @elah/react package — all React bindings split out of @elah/core, which is now truly framework-agnostic.

Added@elah/react
  • New package @elah/react — all React bindings in one place: the editor context (EditorContext, useEditor, useTimelineEngine, usePlaybackEngine), store hooks (useTracksStore, usePlaybackStore, useSelectionStore, useTransitionsStore, useMediaLibraryStore, useMediaLibrary / useAssets), and the audio hooks (useAudioMixer, useMasterVolume, useTrackLevels). Store hooks keep the imperative surface too (useTracksStore.getState() still works).
  • @elah/editor now also re-exports the audio hooks.
  • Test coverage for @elah/react, mirroring the vitest/jsdom conventions already used by @elah/timeline and @elah/editor.
Changed@elah/core
  • BREAKING: core is now truly framework-agnostic — zero React in its module graph (fixes #42; importing @elah/core from Vue/Nuxt/Node no longer requires React).
  • All React hooks moved to @elah/react (re-exported unchanged by @elah/editor, so @elah/editor users are unaffected).
  • The Zustand mirrors are now vanilla stores exported as tracksStore, playbackStore, selectionStore, transitionsStore, and mediaLibraryStore (previously the React-bound useXStore exports). Imperative call sites migrate as useTracksStore.getState() → tracksStore.getState().

v0.1.1

elah serve gets a browser-friendly welcome page and a copy-paste startup example.

Added@elah/cli
  • elah serve welcome page — GET / now serves an HTML orientation page (route table, browser-connected status, copy-paste /render example) instead of a bare 404.
  • Copy-paste startup example — elah serve now prints a ready-to-run render example on startup: curl on macOS/Linux, Invoke-RestMethod on Windows (PowerShell's curl alias doesn't accept -H/-d).

v0.3.2

Documentation only — reworked package READMEs to cross-link @elah/cli. No code changes.

Changed
  • Reworked @elah/core, @elah/timeline, and @elah/editor READMEs to cross-link @elah/cli and stay consistent with its README pattern.

v0.3.1

License changed from ECL v1.0 to Apache-2.0. No code changes.

Changed
  • License changed from the Elah Community License (ECL) v1.0 to Apache-2.0, across @elah/core, @elah/timeline, and @elah/editor. Copyright remains with Elah Labs Private Limited.

v0.1.0

Initial release of @elah/cli — a headless CLI and self-hosted render server, bit-identical to browser export.

Added@elah/cli
  • CLI commands — elah split, trim, export, and build for headless project editing and MP4 export.
  • elah serve — a long-lived HTTP render server (POST /render: spec JSON in, MP4 out) with a warm browser and concurrency control.
  • Seconds-based build spec for programmatic and AI-generated projects, with path-addressed validation errors.
  • Library API — build, exportProject, createRenderSession, startServe, validateSpec, probeMedia — importable directly from Node.

v0.3.0

Multi-track audio, shape & freehand clips, a programmatic asset-insertion API, and a fully themeable timeline. No breaking changes.

Added@elah/core
  • Multi-track audio playback — AudioPlaybackController mixes several audio tracks with per-clip control, replacing the single-track v1 constraint.
  • Audio mixer hooks — useAudioMixer, useTrackLevels, useMasterVolume, plus a pluggable defaultAudioResolver / AudioResolver.
  • Shape clips — createShapeClip, ShapeVariant, and a GPU ShapeLayer (scene.shapes).
  • Freehand clips — createFreehandClip and a GPU FreehandLayer (scene.freehand).
  • Image decode cache warming — warmImageSrc, preloadProjectImages to eliminate first-paint stalls.
  • Expanded asset import — importUrl and importBlob alongside importFiles, plus the useAssets hook.
  • transformFromCoverRect placement helper (object-fit cover).
Added@elah/timeline
  • Programmatic insertion API — insertMediaAsset and insertElement place assets without a drag gesture (powers tap-to-add).
  • classNames slot API + cn util — restyle every sub-component without forking; a passed class always wins.
  • --elah-* CSS-variable theming with a backward-compatible timelineTheme facade.
Added@elah/editor
  • SourcePanel — a fully slot-styled source/asset browser with an asset activation API for tap-to-add flows.
  • Re-exports all of the new core and timeline API above.
Changed
  • Timeline UI redesigned (clips, headers, ruler, playhead) to the Figma cyan / cool-navy theme; editor retinted to match.
  • Timeline gestures migrated to pointer events with pinch-to-zoom and touch tap-to-add.
  • Export pipeline hardened: re-entrancy guard on exportVideo, improved audio mixing, shape/freehand parity with the live renderer.
Fixed
  • Backward-seek frame-cache stability and video-decoder pivot handling.
  • Generated clips can grow left without being clamped by source bounds.

v0.2.1

Documented measured bundle sizes and improved package build scripts.

Changed
  • Documented measured bundle sizes (~63 KiB gzipped full SDK).
  • Improved package build scripts.

v0.2.0

First public release of the three-package split.

Added
  • First public release of @elah/core, @elah/timeline, and @elah/editor.

Following Semantic Versioning. Have a question about a release? Ask on Discord.