@sansavision/vidra-player 0.1.0

package/README.md

@@ -0,0 +1,150 @@
+# @sansavision/vidra-player
+
+Real-time video rendering in the browser — powered by WebAssembly.
+
+Compile VidraScript **or** use the fluent TypeScript/JavaScript SDK to build videos programmatically, then render them at 60fps on a `<canvas>`.
+
+## Quick Start
+
+```bash
+# From the repo root
+cd packages/vidra-player
+npm install
+npm run demo
+# → opens http://localhost:3456/examples/demo.html
+```
+
+Then open **http://localhost:3456/examples/demo.html** in your browser.
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────┐
+│                    Browser                          │
+│                                                     │
+│  ┌──────────────┐     ┌──────────────────────────┐  │
+│  │ VidraScript   │────▶│ WASM Module (vidra-wasm) │  │
+│  │ or JS SDK     │     │                          │  │
+│  └──────────────┘     │  ┌────────────────────┐  │  │
+│                        │  │ Parser + Compiler  │  │  │
+│                        │  │ (vidra-lang)       │  │  │
+│                        │  └────────┬───────────┘  │  │
+│                        │           ▼              │  │
+│                        │  ┌────────────────────┐  │  │
+│                        │  │ CPU Renderer       │  │  │
+│                        │  │ (single-threaded)  │  │  │
+│                        │  └────────┬───────────┘  │  │
+│                        └───────────┼──────────────┘  │
+│                                    ▼                 │
+│                        ┌──────────────────────┐      │
+│                        │ RGBA pixel data      │      │
+│                        │ → ImageData          │      │
+│                        │ → <canvas>           │      │
+│                        └──────────────────────┘      │
+│                                    ▲                 │
+│                        requestAnimationFrame         │
+│                        (60fps render loop)            │
+└─────────────────────────────────────────────────────┘
+```
+
+### Two Input Modes
+
+#### 1. VidraScript DSL
+The WASM module includes the full `vidra-lang` parser and compiler. You write `.vidra` syntax, and the WASM module compiles it to IR internally:
+
+```
+project(1920, 1080, 60) {
+    scene("intro", 3s) {
+        layer("bg") { solid(#1a1a2e) }
+        layer("title") {
+            text("Hello!", font: "Inter", size: 100, color: #ffffff)
+            position(960, 540)
+            animation(opacity, from: 0, to: 1, duration: 1s, easing: easeOut)
+        }
+    }
+}
+```
+
+#### 2. JavaScript/TypeScript SDK
+Build videos using the fluent builder API. The SDK generates IR JSON directly — no VidraScript compilation step needed:
+
+```javascript
+import { Project, Scene, Layer, Easing } from "@sansavision/vidra-player";
+
+const project = new Project(1920, 1080, 60);
+const scene = new Scene("intro", 3.0);
+scene.addLayers(
+    new Layer("bg").solid("#1a1a2e"),
+    new Layer("title")
+        .text("Hello!", "Inter", 100, "#ffffff")
+        .position(960, 540)
+        .animate("opacity", 0, 1, 1.0, Easing.EaseOut)
+);
+project.addScene(scene);
+```
+
+### Engine API
+
+```typescript
+import { VidraEngine } from "@sansavision/vidra-player";
+
+const canvas = document.getElementById("canvas");
+const engine = new VidraEngine(canvas, {
+    onReady: () => console.log("WASM loaded"),
+    onFrame: (frame) => console.log(`Frame ${frame}`),
+    onStateChange: (state) => console.log(`State: ${state}`),
+    onError: (err) => console.error(err),
+});
+
+// Initialize WASM (call once)
+await engine.init();
+
+// Load content (pick one)
+engine.loadSource(vidraScript);       // VidraScript string
+engine.loadProject(sdkProject);       // SDK Project object
+engine.loadIR(irJsonString);          // Raw IR JSON
+
+// Playback controls
+engine.play();
+engine.pause();
+engine.stop();
+engine.seekToFrame(120);
+engine.seekToTime(2.0);
+
+// State
+engine.getCurrentFrame();   // → number
+engine.getCurrentTime();    // → number (seconds)
+engine.getState();          // → "idle" | "loading" | "playing" | "paused" | "stopped"
+engine.getProjectInfo();    // → { width, height, fps, totalFrames, totalDuration, sceneCount }
+```
+
+## Build Commands
+
+| Command | Description |
+|---------|-------------|
+| `npm run build` | Compile TypeScript → `dist/` |
+| `npm run build:wasm` | Compile Rust → WASM → `wasm/` |
+| `npm run build:all` | Build WASM + TypeScript |
+| `npm run demo` | Build TS and start local server on port 3456 |
+| `npm run dev` | Alias for `demo` |
+
+## Architecture
+
+The WASM module (`vidra-wasm`) is a standalone Rust crate that bundles:
+- **vidra-lang**: VidraScript lexer, parser, and compiler
+- **vidra-core**: Frame buffers, color types, duration types
+- **vidra-ir**: Intermediate representation for the scene graph
+- A **CPU-only renderer** (simplified from `vidra-render`, no GPU dependencies)
+
+It compiles to ~2MB of WASM via `wasm-pack` and exposes these functions:
+- `parse_and_compile(source)` → IR JSON string
+- `render_frame(irJson, frameIndex)` → RGBA `Uint8Array`
+- `get_project_info(irJson)` → metadata JSON
+- `load_image_asset(id, bytes)` → cache image for rendering
+
+The JavaScript `VidraEngine` class wraps these calls in a `requestAnimationFrame` loop, pushing RGBA pixel data to a 2D canvas via `ImageData`.
+
+## Requirements
+
+- Browser with WebAssembly support (all modern browsers)
+- For rebuilding WASM: Rust + `wasm-pack`

package/dist/engine.d.ts

@@ -0,0 +1,79 @@
+export interface ProjectInfo {
+    width: number;
+    height: number;
+    fps: number;
+    totalFrames: number;
+    totalDuration: number;
+    sceneCount: number;
+}
+export type PlayerState = "idle" | "loading" | "playing" | "paused" | "stopped";
+export interface EngineEvents {
+    onReady?: () => void;
+    onFrame?: (frame: number) => void;
+    onStateChange?: (state: PlayerState) => void;
+    onError?: (error: string) => void;
+}
+export declare class VidraEngine {
+    private canvas;
+    private ctx2d;
+    private irJson;
+    private info;
+    private currentFrame;
+    private animId;
+    private state;
+    private lastFrameTime;
+    private events;
+    private wasmReady;
+    constructor(canvas: HTMLCanvasElement, events?: EngineEvents);
+    /** Initialize the WASM module. Must be called once before any rendering. */
+    init(): Promise<void>;
+    /** Get the WASM engine version. */
+    getVersion(): string;
+    /** Load a VidraScript source string, compile it, and prepare for rendering. */
+    loadSource(source: string): ProjectInfo;
+    /** Load pre-compiled IR JSON directly. */
+    loadIR(irJson: string): ProjectInfo;
+    /**
+     * Load a Project built with the `@sansavision/vidra-sdk` builder API.
+     *
+     * Accepts any object that has either:
+     * - `.toJSONString()` → returns IR JSON string
+     * - `.toJSON()` → returns IR object (will be JSON.stringify'd)
+     *
+     * @example
+     * ```ts
+     * import { Project, Scene, Layer } from "@sansavision/vidra-player";
+     * const project = new Project(1920, 1080, 60);
+     * project.addScene(new Scene("s1", 3).addLayer(new Layer("bg").solid("#1a1a2e")));
+     * engine.loadProject(project);
+     * ```
+     */
+    loadProject(project: {
+        toJSONString?: () => string;
+        toJSON?: () => unknown;
+    }): ProjectInfo;
+    /** Load an image asset into the WASM renderer cache. */
+    loadImageAsset(assetId: string, url: string): Promise<void>;
+    /** Start playback from the current frame. */
+    play(): void;
+    /** Pause playback. */
+    pause(): void;
+    /** Stop playback and reset to frame 0. */
+    stop(): void;
+    /** Seek to a specific frame. */
+    seekToFrame(frame: number): void;
+    /** Seek to a specific time in seconds. */
+    seekToTime(seconds: number): void;
+    /** Get the current frame index. */
+    getCurrentFrame(): number;
+    /** Get the current time in seconds. */
+    getCurrentTime(): number;
+    /** Get the player state. */
+    getState(): PlayerState;
+    /** Get project info. */
+    getProjectInfo(): ProjectInfo | null;
+    private setState;
+    private tick;
+    private renderCurrentFrame;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhF,MAAM,WAAW,YAAY;IACzB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC7C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,SAAS,CAAkB;gBAEvB,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAE,YAAiB;IAMhE,4EAA4E;IACtE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,mCAAmC;IACnC,UAAU,IAAI,MAAM;IAIpB,+EAA+E;IAC/E,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW;IAmBvC,0CAA0C;IAC1C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW;IAkBnC;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,OAAO,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAA;KAAE,GAAG,WAAW;IAa1F,wDAAwD;IAClD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE,6CAA6C;IAC7C,IAAI,IAAI,IAAI;IAOZ,sBAAsB;IACtB,KAAK,IAAI,IAAI;IAKb,0CAA0C;IAC1C,IAAI,IAAI,IAAI;IAOZ,gCAAgC;IAChC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhC,0CAA0C;IAC1C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,mCAAmC;IACnC,eAAe,IAAI,MAAM;IAIzB,uCAAuC;IACvC,cAAc,IAAI,MAAM;IAKxB,4BAA4B;IAC5B,QAAQ,IAAI,WAAW;IAIvB,wBAAwB;IACxB,cAAc,IAAI,WAAW,GAAG,IAAI;IAMpC,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,IAAI,CAkBV;IAEF,OAAO,CAAC,kBAAkB;CAe7B"}

package/dist/engine.js

@@ -0,0 +1,183 @@
+// ─── Vidra Engine — WASM Loader & Render Loop ─────────────────────
+// This module loads the WASM module, manages the <canvas>, and drives
+// the requestAnimationFrame render loop.
+import init, { parse_and_compile, render_frame, get_project_info, load_image_asset, version, } from "../wasm/vidra_wasm.js";
+export class VidraEngine {
+    canvas;
+    ctx2d;
+    irJson = null;
+    info = null;
+    currentFrame = 0;
+    animId = 0;
+    state = "idle";
+    lastFrameTime = 0;
+    events;
+    wasmReady = false;
+    constructor(canvas, events = {}) {
+        this.canvas = canvas;
+        this.ctx2d = canvas.getContext("2d");
+        this.events = events;
+    }
+    /** Initialize the WASM module. Must be called once before any rendering. */
+    async init() {
+        await init();
+        this.wasmReady = true;
+        this.setState("idle");
+        this.events.onReady?.();
+    }
+    /** Get the WASM engine version. */
+    getVersion() {
+        return version();
+    }
+    /** Load a VidraScript source string, compile it, and prepare for rendering. */
+    loadSource(source) {
+        if (!this.wasmReady)
+            throw new Error("Engine not initialized. Call init() first.");
+        this.setState("loading");
+        this.irJson = parse_and_compile(source);
+        const rawInfo = get_project_info(this.irJson);
+        this.info = JSON.parse(rawInfo);
+        // Size the canvas to match the project
+        this.canvas.width = this.info.width;
+        this.canvas.height = this.info.height;
+        this.currentFrame = 0;
+        this.setState("paused");
+        this.renderCurrentFrame();
+        return this.info;
+    }
+    /** Load pre-compiled IR JSON directly. */
+    loadIR(irJson) {
+        if (!this.wasmReady)
+            throw new Error("Engine not initialized. Call init() first.");
+        this.setState("loading");
+        this.irJson = irJson;
+        const rawInfo = get_project_info(irJson);
+        this.info = JSON.parse(rawInfo);
+        this.canvas.width = this.info.width;
+        this.canvas.height = this.info.height;
+        this.currentFrame = 0;
+        this.setState("paused");
+        this.renderCurrentFrame();
+        return this.info;
+    }
+    /**
+     * Load a Project built with the `@sansavision/vidra-sdk` builder API.
+     *
+     * Accepts any object that has either:
+     * - `.toJSONString()` → returns IR JSON string
+     * - `.toJSON()` → returns IR object (will be JSON.stringify'd)
+     *
+     * @example
+     * ```ts
+     * import { Project, Scene, Layer } from "@sansavision/vidra-player";
+     * const project = new Project(1920, 1080, 60);
+     * project.addScene(new Scene("s1", 3).addLayer(new Layer("bg").solid("#1a1a2e")));
+     * engine.loadProject(project);
+     * ```
+     */
+    loadProject(project) {
+        let irJson;
+        if (typeof project.toJSONString === "function") {
+            irJson = project.toJSONString();
+        }
+        else if (typeof project.toJSON === "function") {
+            irJson = JSON.stringify(project.toJSON());
+        }
+        else {
+            // Last resort — try to stringify the entire object
+            irJson = JSON.stringify(project);
+        }
+        return this.loadIR(irJson);
+    }
+    /** Load an image asset into the WASM renderer cache. */
+    async loadImageAsset(assetId, url) {
+        const response = await fetch(url);
+        const buffer = await response.arrayBuffer();
+        load_image_asset(assetId, new Uint8Array(buffer));
+    }
+    /** Start playback from the current frame. */
+    play() {
+        if (!this.irJson || !this.info)
+            return;
+        this.setState("playing");
+        this.lastFrameTime = performance.now();
+        this.tick();
+    }
+    /** Pause playback. */
+    pause() {
+        this.setState("paused");
+        cancelAnimationFrame(this.animId);
+    }
+    /** Stop playback and reset to frame 0. */
+    stop() {
+        cancelAnimationFrame(this.animId);
+        this.currentFrame = 0;
+        this.setState("stopped");
+        this.renderCurrentFrame();
+    }
+    /** Seek to a specific frame. */
+    seekToFrame(frame) {
+        this.currentFrame = Math.max(0, Math.min(frame, (this.info?.totalFrames ?? 1) - 1));
+        this.renderCurrentFrame();
+        this.events.onFrame?.(this.currentFrame);
+    }
+    /** Seek to a specific time in seconds. */
+    seekToTime(seconds) {
+        if (!this.info)
+            return;
+        const frame = Math.floor(seconds * this.info.fps);
+        this.seekToFrame(frame);
+    }
+    /** Get the current frame index. */
+    getCurrentFrame() {
+        return this.currentFrame;
+    }
+    /** Get the current time in seconds. */
+    getCurrentTime() {
+        if (!this.info)
+            return 0;
+        return this.currentFrame / this.info.fps;
+    }
+    /** Get the player state. */
+    getState() {
+        return this.state;
+    }
+    /** Get project info. */
+    getProjectInfo() {
+        return this.info;
+    }
+    // ── Internal ─────────────────────────────────────────────────
+    setState(state) {
+        this.state = state;
+        this.events.onStateChange?.(state);
+    }
+    tick = () => {
+        if (this.state !== "playing" || !this.info)
+            return;
+        const now = performance.now();
+        const frameDurationMs = 1000 / this.info.fps;
+        if (now - this.lastFrameTime >= frameDurationMs) {
+            this.renderCurrentFrame();
+            this.events.onFrame?.(this.currentFrame);
+            this.currentFrame++;
+            if (this.currentFrame >= this.info.totalFrames) {
+                this.currentFrame = 0; // Loop
+            }
+            this.lastFrameTime = now;
+        }
+        this.animId = requestAnimationFrame(this.tick);
+    };
+    renderCurrentFrame() {
+        if (!this.irJson || !this.info)
+            return;
+        try {
+            const rgba = render_frame(this.irJson, this.currentFrame);
+            const imageData = new ImageData(new Uint8ClampedArray(rgba), this.info.width, this.info.height);
+            this.ctx2d.putImageData(imageData, 0, 0);
+        }
+        catch (e) {
+            this.events.onError?.(String(e));
+        }
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { VidraEngine } from "./engine.js";
+export type { ProjectInfo, PlayerState, EngineEvents } from "./engine.js";
+export { Project, Scene, Layer, Easing, hex, rgba, } from "./sdk.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG1E,OAAO,EACH,OAAO,EACP,KAAK,EACL,KAAK,EACL,MAAM,EACN,GAAG,EACH,IAAI,GACP,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// ─── Vidra Player — Main Exports ────────────────────────────────
+// Engine (WASM-powered renderer)
+export { VidraEngine } from "./engine.js";
+// Re-export the entire SDK so devs only need one package
+export { Project, Scene, Layer, Easing, hex, rgba, } from "./sdk.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,iCAAiC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,yDAAyD;AACzD,OAAO,EACH,OAAO,EACP,KAAK,EACL,KAAK,EACL,MAAM,EACN,GAAG,EACH,IAAI,GACP,MAAM,UAAU,CAAC"}

package/dist/sdk.d.ts

@@ -0,0 +1,69 @@
+import type { ProjectIR, SceneIR, LayerIR, AnimatableProperty, Easing as EasingType, Color, AssetType } from "./types.js";
+export type * from "./types.js";
+export declare function rgba(r: number, g: number, b: number, a?: number): Color;
+export declare function hex(hexCode: string): Color;
+export declare const Easing: {
+    readonly Linear: EasingType;
+    readonly EaseIn: EasingType;
+    readonly EaseOut: EasingType;
+    readonly EaseInOut: EasingType;
+    readonly CubicIn: EasingType;
+    readonly CubicOut: EasingType;
+    readonly CubicInOut: EasingType;
+    readonly Step: EasingType;
+};
+export declare class Layer {
+    private _layer;
+    constructor(id: string);
+    text(content: string, fontFamily?: string, fontSize?: number, color?: string | Color): this;
+    solid(color: string | Color): this;
+    image(assetId: string): this;
+    video(assetId: string, trimStart?: number, trimEnd?: number): this;
+    audio(assetId: string, volume?: number, trimStart?: number, trimEnd?: number): this;
+    shape(type: "rect", opts: {
+        width: number;
+        height: number;
+        radius?: number;
+        fill?: string | Color;
+    }): this;
+    shape(type: "circle", opts: {
+        radius: number;
+        fill?: string | Color;
+    }): this;
+    shape(type: "ellipse", opts: {
+        rx: number;
+        ry: number;
+        fill?: string | Color;
+    }): this;
+    tts(content: string, voice?: string, volume?: number): this;
+    position(x: number, y: number): this;
+    scale(factor: number): this;
+    scale(x: number, y: number): this;
+    rotation(degrees: number): this;
+    opacity(value: number): this;
+    anchor(x: number, y: number): this;
+    animate(property: AnimatableProperty | "positionX" | "positionY" | "scaleX" | "scaleY" | "rotation" | "opacity", from: number, to: number, durationSec: number, easing?: EasingType, delaySec?: number): this;
+    blur(radius: number): this;
+    dropShadow(offsetX: number, offsetY: number, blur: number, color?: string | Color): this;
+    addChild(child: Layer): this;
+    build(): LayerIR;
+}
+export declare class Scene {
+    private _scene;
+    constructor(id: string, durationSec: number);
+    addLayer(layer: Layer): this;
+    addLayers(...layers: Layer[]): this;
+    build(): SceneIR;
+}
+export declare class Project {
+    private _project;
+    constructor(width: number, height: number, fps: number);
+    background(color: string | Color): this;
+    addAsset(type: AssetType, id: string, path: string, name?: string): this;
+    addScene(scene: Scene): this;
+    toJSON(): ProjectIR;
+    toJSONString(pretty?: boolean): string;
+    toVidraScript(): string;
+    private _emitLayer;
+}
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

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