@elah/core 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,82 @@
+# @elah/core
+
+Framework-agnostic video timeline engine. No React. No renderer. Just the pure logic layer — project state, playback, frame resolution, and media management.
+
+Used internally by `@elah/timeline` and `@elah/editor`, but can be consumed directly for custom rendering pipelines or headless environments.
+
+[![npm](https://img.shields.io/npm/v/@elah/core)](https://www.npmjs.com/package/@elah/core)
+[![license](https://img.shields.io/badge/license-ECL--1.0-blue)](https://github.com/elahlabs/elah/blob/main/LICENSE)
+
+---
+
+## Install
+
+```bash
+npm install @elah/core
+```
+
+---
+
+## What's inside
+
+| Module | Description |
+|---|---|
+| `TimelineEngine` | Manages project state — tracks, clips, undo/redo |
+| `PlaybackEngine` | Frame-accurate playback clock |
+| `resolveTimeline` | Pure function — project → active scene at a given frame |
+| `GpuRenderer` | WebGL2 renderer for video, image, and text layers |
+| `useTracksStore` | Zustand mirror of project state for React |
+| `usePlaybackStore` | Zustand mirror of playback state for React |
+| `useSelectionStore` | Zustand mirror of selection state for React |
+| `useMediaLibrary` | Media asset library with thumbnail generation |
+| `importFiles` | Import local files into the media library |
+| `exportVideo` | Export the timeline to MP4 via a web worker |
+
+---
+
+## Quick start
+
+```ts
+import { TimelineEngine, PlaybackEngine, createVideoClip } from '@elah/core'
+
+const engine = new TimelineEngine({ fps: 30, stage: { width: 1920, height: 1080 } })
+const playback = new PlaybackEngine(engine)
+
+// Add a video clip
+engine.addClip('track-1', createVideoClip({ src: 'video.mp4', startFrame: 0, durationFrames: 90 }))
+
+// Resolve the scene at a given frame
+import { resolveTimeline } from '@elah/core'
+const scene = resolveTimeline(engine.getProject(), { currentFrame: 15 })
+```
+
+---
+
+## Clip factories
+
+```ts
+import { createVideoClip, createAudioClip, createTextClip, createImageClip } from '@elah/core'
+```
+
+---
+
+## Export
+
+```ts
+import { exportVideo } from '@elah/core'
+
+const blob = await exportVideo(engine.getProject(), {
+  videoBitrate: 8_000_000,
+  onProgress: ({ frame, totalFrames }) => console.log(frame, '/', totalFrames),
+})
+```
+
+---
+
+## Links
+
+- [Website](https://www.elah.dev)
+- [GitHub](https://github.com/elahlabs/elah)
+- [Full SDK — @elah/editor](https://www.npmjs.com/package/@elah/editor)
+- [License](https://github.com/elahlabs/elah/blob/main/LICENSE)
+- [Commercial licensing](mailto:contact@elah.dev)

package/dist/export/ExportWorker.js

@@ -275,7 +275,13 @@ async function renderFrame(ctx, scene, videoSinks, imageBitmaps, transitionSnaps
                     });
                 }
                 const seekStart = isDebugFrame ? performance.now() : 0;
-                const wrapped = await sink.getCanvas(sourceTimeSec);
+                let wrapped = null;
+                try {
+                    wrapped = await sink.getCanvas(sourceTimeSec);
+                }
+                catch (err) {
+                    xlog('render:frame0', `video layer — getCanvas() failed (frame skipped): ${String(err)}`);
+                }
                 if (isDebugFrame) {
                     xlog('render:frame0', `video layer — getCanvas()`, {
                         gotFrame: !!wrapped,

package/dist/export/exportVideo.js

@@ -67,7 +67,7 @@ export async function exportVideo(project, options = {}) {
         return Promise.reject(signal.reason ?? new DOMException('Export aborted', 'AbortError'));
     return new Promise((resolve, reject) => {
         mlog('EXPORT', 'spawning ExportWorker (module worker)');
-        const worker = new Worker(new URL('./ExportWorker.ts', import.meta.url), { type: 'module' });
+        const worker = new Worker(new URL('./ExportWorker.js', import.meta.url), { type: 'module' });
         const abort = () => {
             worker.terminate();
             mlog('EXPORT', 'aborted by signal');

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export type { TextLayout } from './renderer/gpu/layers/textLayout';
 export type { DemuxerBackend as MediabunnyDemuxer } from './media/video/demuxer/MediabunnyDemuxer';
 export { GpuDebugCounters } from './renderer/gpu/debug/GpuDebugCounters';
 export type { CounterSnapshot } from './renderer/gpu/debug/GpuDebugCounters';
+export { createDefaultDemuxerFactory } from './media/video/demuxer/createDefaultDemuxerFactory';
 export { createMediabunnyBackend, isMediabunnyCompatible } from './media/video/demuxer/createMediabunnyBackend';
 export type { MediabunnyModule, CreateMediabunnyBackendOpts } from './media/video/demuxer/createMediabunnyBackend';
 export type { DemuxerBackend, DemuxerFactory } from './media/video/demuxer/MediabunnyDemuxer';

package/dist/index.js

@@ -6,6 +6,7 @@ export { resolveDrawRect, transformFromContainRect } from './renderer/gpu/layers
 export { computeContainViewport } from './renderer/gpu/viewport';
 export { computeTextLayout, SIDE_MARGIN } from './renderer/gpu/layers/textLayout';
 export { GpuDebugCounters } from './renderer/gpu/debug/GpuDebugCounters';
+export { createDefaultDemuxerFactory } from './media/video/demuxer/createDefaultDemuxerFactory';
 export { createMediabunnyBackend, isMediabunnyCompatible } from './media/video/demuxer/createMediabunnyBackend';
 export { createVideoFrameProvider, MockVideoFrameProvider, SyntheticVideoFrameProvider } from './media/video';
 export { AudioPlaybackController } from './media/audio/AudioPlaybackController';

package/dist/media/video/demuxer/createDefaultDemuxerFactory.d.ts

@@ -0,0 +1,3 @@
+import { type CreateMediabunnyBackendOpts } from './createMediabunnyBackend';
+import type { DemuxerFactory } from './MediabunnyDemuxer';
+export declare function createDefaultDemuxerFactory(opts?: CreateMediabunnyBackendOpts): DemuxerFactory;

package/dist/media/video/demuxer/createDefaultDemuxerFactory.js

@@ -0,0 +1,6 @@
+import * as mediabunny from 'mediabunny';
+import { createMediabunnyBackend } from './createMediabunnyBackend';
+const mb = mediabunny;
+export function createDefaultDemuxerFactory(opts = {}) {
+    return () => createMediabunnyBackend(mb, opts);
+}

package/dist/media/video/index.d.ts

@@ -6,3 +6,4 @@ export { DecoderBackedVideoFrameProvider } from './DecoderBackedVideoFrameProvid
 export { FrameCache } from './FrameCache';
 export type { DemuxerFactory, DemuxerBackend } from './demuxer/MediabunnyDemuxer';
 export { createMediabunnyBackend, isMediabunnyCompatible } from './demuxer/createMediabunnyBackend';
+export { createDefaultDemuxerFactory } from './demuxer/createDefaultDemuxerFactory';

package/dist/media/video/index.js

@@ -3,3 +3,4 @@ export { StreamingFrameProducer } from './StreamingFrameProducer';
 export { DecoderBackedVideoFrameProvider } from './DecoderBackedVideoFrameProvider';
 export { FrameCache } from './FrameCache';
 export { createMediabunnyBackend, isMediabunnyCompatible } from './demuxer/createMediabunnyBackend';
+export { createDefaultDemuxerFactory } from './demuxer/createDefaultDemuxerFactory';

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@elah/core",
-  "version": "0.1.0",
-  "description": "Framework-agnostic video timeline engine",
+  "version": "0.2.0",
+  "description": "Framework-agnostic video timeline engine — playback, frame resolution, WebGL2 renderer, and media management",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "sideEffects": false,
   "exports": {
     ".": {
       "import": "./dist/index.js",
@@ -12,7 +13,9 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -20,8 +23,34 @@
     "test:watch": "vitest",
     "build": "tsc --noEmit && tsc -p tsconfig.build.json"
   },
+  "keywords": [
+    "video-editor",
+    "timeline",
+    "video-engine",
+    "webgl",
+    "webgl2",
+    "gpu-renderer",
+    "playback",
+    "frame-accurate",
+    "media",
+    "export",
+    "mp4",
+    "typescript",
+    "browser",
+    "react"
+  ],
+  "homepage": "https://www.elah.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elahlabs/elah.git"
+  },
+  "bugs": {
+    "url": "https://github.com/elahlabs/elah/issues"
+  },
+  "license": "SEE LICENSE IN LICENSE",
   "dependencies": {
     "immer": "^10.1.1",
+    "mediabunny": "^1.45.3",
     "zustand": "^5.0.3"
   },
   "devDependencies": {