@smoove/core 0.1.0

package/dist/video/video-for-rendering.js

@@ -0,0 +1,45 @@
+import { getMediaTime } from "./driver.js";
+/**
+ * Deterministic, gated frame production — Remotion's `VideoForRendering`. Never
+ * plays in realtime: each tick seeks the source to the exact media time and
+ * holds a `delayRender` handle so `Composition.renderFrame()` waits for the
+ * decoded frame before the canvas is captured.
+ */
+export class RenderingVideoDriver {
+    ctx;
+    _lastMediaTime = Number.NaN;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    tick(localFrame) {
+        const { source, comp } = this.ctx;
+        if (!source.isReady) {
+            // The source isn't decodable yet; redraw so whatever is available shows.
+            this.ctx.redraw();
+            return;
+        }
+        const mediaTime = getMediaTime(localFrame, this.ctx.timing);
+        if (mediaTime === this._lastMediaTime) {
+            this.ctx.redraw();
+            return;
+        }
+        this._lastMediaTime = mediaTime;
+        const handle = comp.delayRender(`seek video -> ${mediaTime.toFixed(4)}s`);
+        source
+            .seek(mediaTime)
+            .then(() => {
+            this.ctx.redraw();
+        })
+            .catch((err) => {
+            console.error("[konva-motion] video seek failed during render:", err);
+        })
+            .finally(() => {
+            comp.continueRender(handle);
+        });
+    }
+    deactivate() {
+        this._lastMediaTime = Number.NaN;
+    }
+    dispose() { }
+}
+//# sourceMappingURL=video-for-rendering.js.map

package/dist/video/video-for-rendering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-for-rendering.js","sourceRoot":"","sources":["../../src/video/video-for-rendering.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6C,YAAY,EAAE,MAAM,aAAa,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IAGF;IAFrB,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC;IAEpC,YAA6B,GAAuB;QAAvB,QAAG,GAAH,GAAG,CAAoB;IAAG,CAAC;IAExD,IAAI,CAAC,UAAkB;QACrB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,yEAAyE;YACzE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,SAAS,KAAK,IAAI,CAAC,cAAc,EAAE,CAAC;YACtC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,iBAAiB,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC1E,MAAM;aACH,IAAI,CAAC,SAAS,CAAC;aACf,IAAI,CAAC,GAAG,EAAE;YACT,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QACpB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,OAAO,CAAC,KAAK,CAAC,iDAAiD,EAAE,GAAG,CAAC,CAAC;QACxE,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACP,CAAC;IAED,UAAU;QACR,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC;IACnC,CAAC;IAED,OAAO,KAAU,CAAC;CACnB"}

package/dist/video/video-source-browser.d.ts

@@ -0,0 +1,37 @@
+import type { SeekMode, VideoSource } from "./video-source.js";
+/**
+ * Preview-mode {@link VideoSource}: wraps an `HTMLVideoElement` and drives it in
+ * realtime. The server renderer injects a different source via
+ * `VideoConfig.sourceFactory`.
+ */
+export declare class BrowserVideoSource implements VideoSource {
+    private readonly _el;
+    private _ready;
+    private readonly _readyCbs;
+    private readonly _frameCbs;
+    private _rvfcId;
+    private _rvfcRunning;
+    private _seeking;
+    private _pending;
+    constructor();
+    load(src: string): Promise<void>;
+    private _startFrameLoop;
+    get element(): CanvasImageSource | null;
+    get naturalWidth(): number;
+    get naturalHeight(): number;
+    get duration(): number;
+    get currentTime(): number;
+    get isReady(): boolean;
+    seek(timeSeconds: number, mode?: SeekMode): Promise<void>;
+    /** Issue the pending seek if none is in flight; chains the latest target after each completes. */
+    private _drainSeek;
+    play(): Promise<void>;
+    pause(): void;
+    setMuted(muted: boolean): void;
+    setVolume(volume: number): void;
+    setPlaybackRate(rate: number): void;
+    onReady(cb: () => void): () => void;
+    onFrame(cb: () => void): () => void;
+    destroy(): void;
+}
+//# sourceMappingURL=video-source-browser.d.ts.map

package/dist/video/video-source-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-source-browser.d.ts","sourceRoot":"","sources":["../../src/video/video-source-browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQ/D;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,YAAY,CAAS;IAK7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA+E;;IAY/F,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBhC,OAAO,CAAC,eAAe;IAWvB,IAAI,OAAO,IAAI,iBAAiB,GAAG,IAAI,CAEtC;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,QAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBpE,kGAAkG;IAClG,OAAO,CAAC,UAAU;IA6BlB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,KAAK,IAAI,IAAI;IAIb,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAInC,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IASnC,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKnC,OAAO,IAAI,IAAI;CAYhB"}

package/dist/video/video-source-browser.js

@@ -0,0 +1,171 @@
+/**
+ * Preview-mode {@link VideoSource}: wraps an `HTMLVideoElement` and drives it in
+ * realtime. The server renderer injects a different source via
+ * `VideoConfig.sourceFactory`.
+ */
+export class BrowserVideoSource {
+    _el;
+    _ready = false;
+    _readyCbs = new Set();
+    _frameCbs = new Set();
+    _rvfcId = null;
+    _rvfcRunning = false;
+    // Seek coalescing: keep at most one seek in flight. Rapid scrubbing only ever
+    // lands the latest target — intermediate ones are dropped — so the backlog
+    // never grows (which is what makes scrubbing a large clip degrade over time).
+    _seeking = false;
+    _pending = null;
+    constructor() {
+        const el = document.createElement("video");
+        el.crossOrigin = "anonymous";
+        el.playsInline = true;
+        el.preload = "auto";
+        // Muted so the browser allows programmatic play()/seek before any user gesture.
+        el.muted = true;
+        this._el = el;
+    }
+    load(src) {
+        return new Promise((resolve, reject) => {
+            const onReady = () => {
+                cleanup();
+                this._ready = true;
+                this._startFrameLoop();
+                for (const cb of this._readyCbs)
+                    cb();
+                resolve();
+            };
+            const onErr = () => {
+                cleanup();
+                reject(new Error(`Failed to load video: ${src}`));
+            };
+            const cleanup = () => {
+                this._el.removeEventListener("loadeddata", onReady);
+                this._el.removeEventListener("error", onErr);
+            };
+            this._el.addEventListener("loadeddata", onReady);
+            this._el.addEventListener("error", onErr);
+            this._el.src = src;
+        });
+    }
+    _startFrameLoop() {
+        if (this._rvfcRunning)
+            return;
+        if (typeof this._el.requestVideoFrameCallback !== "function")
+            return;
+        this._rvfcRunning = true;
+        const tick = () => {
+            for (const cb of this._frameCbs)
+                cb();
+            this._rvfcId = this._el.requestVideoFrameCallback?.(tick) ?? null;
+        };
+        this._rvfcId = this._el.requestVideoFrameCallback(tick);
+    }
+    get element() {
+        return this._ready ? this._el : null;
+    }
+    get naturalWidth() {
+        return this._el.videoWidth;
+    }
+    get naturalHeight() {
+        return this._el.videoHeight;
+    }
+    get duration() {
+        return Number.isFinite(this._el.duration) ? this._el.duration : 0;
+    }
+    get currentTime() {
+        return this._el.currentTime;
+    }
+    get isReady() {
+        return this._ready;
+    }
+    seek(timeSeconds, mode = "precise") {
+        const clamped = Math.max(0, this.duration > 0 ? Math.min(this.duration, timeSeconds) : timeSeconds);
+        // No-op seek with nothing in flight: already there, resolve immediately.
+        if (!this._seeking && Math.abs(this._el.currentTime - clamped) <= 1e-4) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            if (this._pending) {
+                // Supersede the queued target — only the latest scrub position matters.
+                this._pending.time = clamped;
+                this._pending.mode = mode;
+                this._pending.resolvers.push(resolve);
+            }
+            else {
+                this._pending = { time: clamped, mode, resolvers: [resolve] };
+            }
+            this._drainSeek();
+        });
+    }
+    /** Issue the pending seek if none is in flight; chains the latest target after each completes. */
+    _drainSeek() {
+        if (this._seeking || !this._pending)
+            return;
+        const { time, mode, resolvers } = this._pending;
+        this._pending = null;
+        if (Math.abs(this._el.currentTime - time) <= 1e-4) {
+            for (const r of resolvers)
+                r();
+            this._drainSeek();
+            return;
+        }
+        this._seeking = true;
+        const onSeeked = () => {
+            this._el.removeEventListener("seeked", onSeeked);
+            this._seeking = false;
+            for (const r of resolvers)
+                r();
+            // A newer target may have arrived mid-seek — land it now.
+            this._drainSeek();
+        };
+        this._el.addEventListener("seeked", onSeeked);
+        // fastSeek jumps to the nearest keyframe — much snappier for scrubbing a
+        // large clip. Fall back to a precise currentTime seek when unavailable.
+        if (mode === "fast" && typeof this._el.fastSeek === "function") {
+            this._el.fastSeek(time);
+        }
+        else {
+            this._el.currentTime = time;
+        }
+    }
+    play() {
+        return this._el.play();
+    }
+    pause() {
+        this._el.pause();
+    }
+    setMuted(muted) {
+        this._el.muted = muted;
+    }
+    setVolume(volume) {
+        this._el.volume = Math.max(0, Math.min(1, volume));
+    }
+    setPlaybackRate(rate) {
+        this._el.playbackRate = rate;
+    }
+    onReady(cb) {
+        if (this._ready) {
+            cb();
+            return () => { };
+        }
+        this._readyCbs.add(cb);
+        return () => this._readyCbs.delete(cb);
+    }
+    onFrame(cb) {
+        this._frameCbs.add(cb);
+        return () => this._frameCbs.delete(cb);
+    }
+    destroy() {
+        if (this._rvfcId !== null && typeof this._el.cancelVideoFrameCallback === "function") {
+            this._el.cancelVideoFrameCallback(this._rvfcId);
+        }
+        this._el.pause();
+        this._el.removeAttribute("src");
+        this._el.load();
+        this._readyCbs.clear();
+        this._frameCbs.clear();
+        this._pending = null;
+        this._seeking = false;
+    }
+}
+//# sourceMappingURL=video-source-browser.js.map

package/dist/video/video-source-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-source-browser.js","sourceRoot":"","sources":["../../src/video/video-source-browser.ts"],"names":[],"mappings":"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"}

package/dist/video/video-source.d.ts

@@ -0,0 +1,48 @@
+import type { Environment } from "../environment.js";
+/** Seek precision: exact frame ("precise", default) vs. snappy nearest-keyframe ("fast", for scrubbing). */
+export type SeekMode = "precise" | "fast";
+/**
+ * Runtime-agnostic video source — the dependency-injection seam between the
+ * engine and the actual media decoder. The browser implementation
+ * ({@link BrowserVideoSource}) wraps an `HTMLVideoElement`; a server renderer
+ * (e.g. Bun + Skia Canvas) injects its own decoder-backed source that produces
+ * drawable frames on demand.
+ */
+export interface VideoSource {
+    load(src: string): Promise<void>;
+    /** Drawable surface for `Konva.Image`, or null until ready. */
+    readonly element: CanvasImageSource | null;
+    readonly naturalWidth: number;
+    readonly naturalHeight: number;
+    /** Duration in seconds, or 0 if unknown. */
+    readonly duration: number;
+    /** Current media playback position in seconds. */
+    readonly currentTime: number;
+    readonly isReady: boolean;
+    /**
+     * Seek to a time in seconds. Resolves once the frame at that time has been
+     * decoded and is ready to draw — rendering `await`s this to gate frame
+     * capture; preview fires it and forgets.
+     *
+     * `mode: "fast"` requests an approximate, snappy seek (nearest keyframe) for
+     * scrubbing; the default `"precise"` lands on the exact frame.
+     */
+    seek(timeSeconds: number, mode?: SeekMode): Promise<void>;
+    play(): Promise<void>;
+    pause(): void;
+    setMuted(muted: boolean): void;
+    setVolume(volume: number): void;
+    setPlaybackRate(rate: number): void;
+    /** Fires once when metadata + first frame are available. */
+    onReady(cb: () => void): () => void;
+    /** Fires whenever a new frame has been decoded and is ready to draw. */
+    onFrame(cb: () => void): () => void;
+    destroy(): void;
+}
+/**
+ * Factory for a {@link VideoSource}. Receives the resolved {@link Environment}
+ * so a single factory can pick an implementation (e.g. browser vs. decoder)
+ * based on whether we are rendering or previewing.
+ */
+export type VideoSourceFactory = (env: Environment) => VideoSource;
+//# sourceMappingURL=video-source.d.ts.map

package/dist/video/video-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-source.d.ts","sourceRoot":"","sources":["../../src/video/video-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,4GAA4G;AAC5G,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;;;;;OAOG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACpC,wEAAwE;IACxE,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACpC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,WAAW,CAAC"}

package/dist/video/video-source.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=video-source.js.map

package/dist/video/video-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-source.js","sourceRoot":"","sources":["../../src/video/video-source.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@smoove/core",
+  "version": "0.1.0",
+  "description": "Agnostic timeline-driven animation engine. Runs in browser or server; integrates with any render target (e.g. Konva).",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/smoove-dev/smoove.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://smoove.dev",
+  "bugs": "https://github.com/smoove-dev/smoove/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "bezier-easing": "^2.1.0",
+    "flexily": "^0.7.1",
+    "mediabunny": "^1.49.0"
+  },
+  "peerDependencies": {
+    "konva": ">=10"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b --watch",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}