@elah/editor 0.4.0 → 0.4.1

package/README.md

@@ -2,7 +2,7 @@
 
 The full Elah video editor SDK for React. Combines the core engine, timeline UI, WebGL2 renderer, media library, and export pipeline into a single package.
 
-Ships `EditorProvider`, `Preview` (WebGL2 canvas + interactive transform overlays), `Timeline`, `AssetPanel`, `SourcePanel`, and `ElementsPanel`, and re-exports the entire `@elah/core` and `@elah/timeline` API. Supports video, image, text, **shape**, and **freehand** clips, **multi-track audio**, and MP4 export.
+Ships `EditorProvider`, `Preview` (WebGL2 canvas + interactive transform overlays), `Timeline`, `AssetPanel`, `SourcePanel`, and `ElementsPanel`, and re-exports the public `@elah/core`, `@elah/react`, and `@elah/timeline` API — so most apps only ever import from `@elah/editor`. (Renderer and debug internals are the exception; import those from `@elah/core` directly.) Supports video, image, text, **shape**, and **freehand** clips, **multi-track audio**, and MP4 export.
 
 [![npm](https://img.shields.io/npm/v/@elah/editor)](https://www.npmjs.com/package/@elah/editor)
 [![gzip size](https://img.shields.io/badge/gzip-~63%20KiB%20full%20SDK-brightgreen)](../../BUNDLE_STRATEGY.md)
@@ -86,14 +86,16 @@ function App() {
 ## Import media
 
 ```ts
-import { importFiles, importUrl, useMediaLibrary } from '@elah/editor'
+import { importFiles, importUrl, importBlob, useMediaLibrary } from '@elah/editor'
 
-await importFiles(Array.from(fileList))   // local files
-await importUrl('https://example.com/clip.mp4') // remote URL (also importBlob for blobs)
+await importFiles(Array.from(fileList))          // local files
+await importUrl('https://example.com/clip.mp4')  // remote URL
+await importBlob(recordedBlob, { name: 'take-1.webm' })
 
 // Subscribe in React — useMediaLibrary() takes no arguments and returns
-// { assets, getAsset, removeAsset, updateAsset } with assets in insertion order.
-const { assets } = useMediaLibrary()
+// { assets, getAsset, removeAsset, updateAsset, importFiles, importUrl, importBlob }
+// with assets in insertion order. `useAssets` is an alias for the same hook.
+const { assets, importFiles: addFiles } = useMediaLibrary()
 ```
 
 ### Programmatic insertion (no drag)

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { TimelineEngine } from '@elah/core';
 export { PlaybackEngine } from '@elah/core';
 export type { PlaybackSnapshot, PlaybackEngineConfig } from '@elah/core';
 export { resolveTimeline } from '@elah/core';
-export type { Scene, ActiveTransition, ActiveVideoClip, ActiveAudioClip, ActiveTextClip, ActiveImageClip, ActiveClipBase, } from '@elah/core';
+export type { Scene, ActiveTransition, ActiveVideoClip, ActiveAudioClip, ActiveTextClip, ActiveImageClip, ActiveShapeClip, ActiveFreehandClip, ActiveClipBase, } from '@elah/core';
 export type { Renderer } from '@elah/core';
 export { GpuRenderer } from '@elah/core';
 export type { RendererOptions } from '@elah/core';
@@ -11,45 +11,60 @@ export { GpuDebugCounters } from '@elah/core';
 export type { CounterSnapshot } from '@elah/core';
 export { createDefaultDemuxerFactory, createMediabunnyBackend, isMediabunnyCompatible } from '@elah/core';
 export type { MediabunnyModule, CreateMediabunnyBackendOpts } from '@elah/core';
-export type { DemuxerBackend, DemuxerFactory } from '@elah/core';
+export type { DemuxerBackend, DemuxerFactory, MediabunnyDemuxer } from '@elah/core';
 export type { VideoFrameProvider, VideoFrameProviderDeps } from '@elah/core';
 export { createVideoFrameProvider, MockVideoFrameProvider, SyntheticVideoFrameProvider } from '@elah/core';
 export { AudioPlaybackController } from '@elah/core';
 export type { AudioPlaybackControllerOptions } from '@elah/core';
 export { defaultAudioResolver } from '@elah/core';
 export type { AudioResolver } from '@elah/core';
-export { MEDIA_DRAG_MIME, mediaDragKindMime, importFiles, importUrl } from '@elah/core';
-export { useMediaLibrary, useMediaLibraryStore } from '@elah/react';
-export type { MediaAsset, MediaKind, DragMediaPayload, ImportFilesOptions, ImportFilesResult, SkippedImport } from '@elah/core';
+export { warmImageSrc, preloadProjectImages } from '@elah/core';
+export type { ImageLoader, LoadedImage } from '@elah/core';
+export { MEDIA_DRAG_MIME, mediaDragKindMime, importFiles, importUrl, importBlob } from '@elah/core';
+export { useMediaLibrary, useAssets, useMediaLibraryStore } from '@elah/react';
+export type { MediaAsset, MediaKind, DragMediaPayload, ImportFilesOptions, ImportFilesResult, ImportUrlOptions, ImportBlobOptions, SkippedImport, MediaLibraryState, MediaLibraryActions, } from '@elah/core';
+export type { UseMediaLibraryApi } from '@elah/react';
 export { useTracksStore } from '@elah/react';
 export { usePlaybackStore } from '@elah/react';
 export { useSelectionStore } from '@elah/react';
+export { useTransitionsStore } from '@elah/react';
+export type { BoundStoreHook } from '@elah/react';
+export { tracksStore, playbackStore, selectionStore, transitionsStore, mediaLibraryStore } from '@elah/core';
+export type { TracksState, TracksActions, PlaybackState, PlaybackActions, SelectionState, SelectionActions, TransitionsState, TransitionsActions, } from '@elah/core';
 export { createVideoClip } from '@elah/core';
 export { createAudioClip } from '@elah/core';
 export { createTextClip } from '@elah/core';
 export { createImageClip } from '@elah/core';
+export { createShapeClip } from '@elah/core';
+export { createFreehandClip } from '@elah/core';
+export type { CreateClipOptions, CreateShapeClipOptions, CreateFreehandClipOptions, ShapeClipMetadata, FreehandClipMetadata, } from '@elah/core';
 export { splitClipAtPlayhead } from '@elah/core';
 export type { SplitAtPlayheadData } from '@elah/core';
 export type { ActionResult, ActionFailureReason } from '@elah/core';
 export { framesToTimecode, secondsToFrames, framesToSeconds, getTotalFrames } from '@elah/core';
 export { generateId } from '@elah/core';
 export { transformFromCoverRect } from '@elah/core';
+export { snapFrame, buildSnapPoints, resolveOverlapEdgeSnap, clipsOverlap, DEFAULT_OVERLAP_TOLERANCE } from '@elah/core';
+export { serializeProject, deserializeProject } from '@elah/core';
 export { exportVideo } from '@elah/core';
 export { lazyExportVideo } from '@elah/core';
 export type { ExportOptions, ExportProgress, ExportVideoCodec, ExportAudioCodec } from '@elah/core';
 export { Timeline } from '@elah/timeline';
-export type { TimelineProps, TimelineRef } from '@elah/timeline';
+export type { TimelineProps, TimelineRef, TimelineClassNames } from '@elah/timeline';
+export { cn } from '@elah/timeline';
 export { useTimeline } from '@elah/timeline';
 export { useTracks } from '@elah/timeline';
 export { usePlayback } from '@elah/timeline';
 export { useSelection } from '@elah/timeline';
 export { useTimelineDrop } from '@elah/timeline';
+export type { TimelineDropState } from '@elah/timeline';
 export { insertMediaAsset, insertElement } from '@elah/timeline';
 export { ELEMENT_DRAG_MIME } from '@elah/timeline';
 export type { DragElementPayload, ElementKind, ShapeVariant, InsertAssetOptions, InsertAssetResult, InsertAssetFailureReason, InsertedKind, } from '@elah/timeline';
 export { EditorProvider } from './editor/EditorProvider';
 export type { EditorProviderProps } from './editor/EditorProvider';
-export { useEditor, useTimelineEngine, usePlaybackEngine } from '@elah/react';
+export { EditorContext, useEditor, useTimelineEngine, usePlaybackEngine } from '@elah/react';
+export type { EditorContextValue } from '@elah/react';
 export { useAudioMixer, useMasterVolume, useTrackLevels } from '@elah/react';
 export type { AudioMixerApi, MasterVolumeApi, TrackLevel } from '@elah/react';
 export { useResolvedScene } from './editor/useResolvedScene';

package/dist/index.js

@@ -7,22 +7,30 @@ export { createDefaultDemuxerFactory, createMediabunnyBackend, isMediabunnyCompa
 export { createVideoFrameProvider, MockVideoFrameProvider, SyntheticVideoFrameProvider } from '@elah/core';
 export { AudioPlaybackController } from '@elah/core';
 export { defaultAudioResolver } from '@elah/core';
-export { MEDIA_DRAG_MIME, mediaDragKindMime, importFiles, importUrl } from '@elah/core';
-export { useMediaLibrary, useMediaLibraryStore } from '@elah/react';
+export { warmImageSrc, preloadProjectImages } from '@elah/core';
+export { MEDIA_DRAG_MIME, mediaDragKindMime, importFiles, importUrl, importBlob } from '@elah/core';
+export { useMediaLibrary, useAssets, useMediaLibraryStore } from '@elah/react';
 export { useTracksStore } from '@elah/react';
 export { usePlaybackStore } from '@elah/react';
 export { useSelectionStore } from '@elah/react';
+export { useTransitionsStore } from '@elah/react';
+export { tracksStore, playbackStore, selectionStore, transitionsStore, mediaLibraryStore } from '@elah/core';
 export { createVideoClip } from '@elah/core';
 export { createAudioClip } from '@elah/core';
 export { createTextClip } from '@elah/core';
 export { createImageClip } from '@elah/core';
+export { createShapeClip } from '@elah/core';
+export { createFreehandClip } from '@elah/core';
 export { splitClipAtPlayhead } from '@elah/core';
 export { framesToTimecode, secondsToFrames, framesToSeconds, getTotalFrames } from '@elah/core';
 export { generateId } from '@elah/core';
 export { transformFromCoverRect } from '@elah/core';
+export { snapFrame, buildSnapPoints, resolveOverlapEdgeSnap, clipsOverlap, DEFAULT_OVERLAP_TOLERANCE } from '@elah/core';
+export { serializeProject, deserializeProject } from '@elah/core';
 export { exportVideo } from '@elah/core';
 export { lazyExportVideo } from '@elah/core';
 export { Timeline } from '@elah/timeline';
+export { cn } from '@elah/timeline';
 export { useTimeline } from '@elah/timeline';
 export { useTracks } from '@elah/timeline';
 export { usePlayback } from '@elah/timeline';
@@ -31,7 +39,7 @@ export { useTimelineDrop } from '@elah/timeline';
 export { insertMediaAsset, insertElement } from '@elah/timeline';
 export { ELEMENT_DRAG_MIME } from '@elah/timeline';
 export { EditorProvider } from './editor/EditorProvider';
-export { useEditor, useTimelineEngine, usePlaybackEngine } from '@elah/react';
+export { EditorContext, useEditor, useTimelineEngine, usePlaybackEngine } from '@elah/react';
 export { useAudioMixer, useMasterVolume, useTrackLevels } from '@elah/react';
 export { useResolvedScene } from './editor/useResolvedScene';
 export { AssetPanel } from './editor/AssetPanel';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elah/editor",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Full React video editor SDK — timeline UI, WebGL2 preview, media library, drag and drop, and MP4 export",
   "type": "module",
   "main": "./dist/index.js",
@@ -59,9 +59,9 @@
     "lucide-react": ">=0.400.0"
   },
   "dependencies": {
-    "@elah/core": "^0.4.0",
-    "@elah/react": "^0.4.0",
-    "@elah/timeline": "^0.4.0",
+    "@elah/core": "^0.4.1",
+    "@elah/react": "^0.4.1",
+    "@elah/timeline": "^0.4.1",
     "immer": "^10.1.1",
     "zustand": "^5.0.3"
   },