@volorio/video-compositor 0.2.0

package/README.md

@@ -0,0 +1,7 @@
+# @volorio/video-compositor
+
+Volorio video compositor extension for layouts and overlays.
+
+```bash
+npm install @volorio/video-compositor
+```

package/dist/src/index.d.ts

@@ -0,0 +1,43 @@
+import type { VolorioRoomClient } from "@volorio/rtc";
+export declare const volorioVideoCompositorProductId = "video_compositor";
+export declare const volorioVideoCompositorSessionFeatures: {
+    readonly videoCompositor: true;
+};
+export interface VolorioVideoLayer {
+    id: string;
+    source: unknown;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    zIndex?: number;
+}
+export interface VolorioVideoCompositorEngine {
+    setLayers(layers: VolorioVideoLayer[]): Promise<void>;
+    render(): Promise<unknown>;
+    stop(): Promise<void>;
+}
+export interface VolorioVideoCompositorOptions {
+    layers: VolorioVideoLayer[];
+    width?: number;
+    height?: number;
+    background?: string;
+}
+export declare class VolorioVideoCompositorExtension {
+    private readonly engine;
+    constructor(engine: VolorioVideoCompositorEngine);
+    setLayers(layers: VolorioVideoLayer[]): Promise<void>;
+    render(): Promise<unknown>;
+    stop(): Promise<void>;
+}
+export declare class VolorioVideoCompositorProcessor {
+    readonly name = "volorio_video_compositor";
+    private options;
+    private readonly canvas;
+    private readonly context;
+    constructor(options: VolorioVideoCompositorOptions, canvas?: HTMLCanvasElement | OffscreenCanvas);
+    update(options: VolorioVideoCompositorOptions): void;
+    processFrame(source: CanvasImageSource): HTMLCanvasElement | OffscreenCanvas;
+}
+export declare function createVolorioVideoCompositorProcessor(options: VolorioVideoCompositorOptions): VolorioVideoCompositorProcessor;
+export type { VolorioRoomClient };

package/dist/src/index.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VolorioVideoCompositorProcessor = exports.VolorioVideoCompositorExtension = exports.volorioVideoCompositorSessionFeatures = exports.volorioVideoCompositorProductId = void 0;
+exports.createVolorioVideoCompositorProcessor = createVolorioVideoCompositorProcessor;
+exports.volorioVideoCompositorProductId = "video_compositor";
+exports.volorioVideoCompositorSessionFeatures = { videoCompositor: true };
+class VolorioVideoCompositorExtension {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    async setLayers(layers) {
+        await this.engine.setLayers(layers);
+    }
+    async render() {
+        return this.engine.render();
+    }
+    async stop() {
+        await this.engine.stop();
+    }
+}
+exports.VolorioVideoCompositorExtension = VolorioVideoCompositorExtension;
+class VolorioVideoCompositorProcessor {
+    name = "volorio_video_compositor";
+    options;
+    canvas;
+    context;
+    constructor(options, canvas = createCanvas(options.width ?? 1280, options.height ?? 720)) {
+        this.options = options;
+        this.canvas = canvas;
+        const context = canvas.getContext("2d");
+        if (context === null) {
+            throw new Error("Volorio video compositor requires a 2D canvas context");
+        }
+        this.context = context;
+    }
+    update(options) {
+        this.options = options;
+    }
+    processFrame(source) {
+        const fallbackSize = readFrameSize(source);
+        const width = this.options.width ?? fallbackSize.width;
+        const height = this.options.height ?? fallbackSize.height;
+        this.canvas.width = width;
+        this.canvas.height = height;
+        this.context.fillStyle = this.options.background ?? "#000000";
+        this.context.fillRect(0, 0, width, height);
+        const layers = [...this.options.layers].sort((left, right) => (left.zIndex ?? 0) - (right.zIndex ?? 0));
+        if (layers.length === 0) {
+            this.context.drawImage(source, 0, 0, width, height);
+        }
+        for (const layer of layers) {
+            const layerSource = layer.source === "local" || layer.source === undefined ? source : layer.source;
+            this.context.drawImage(layerSource, layer.x, layer.y, layer.width, layer.height);
+        }
+        return this.canvas;
+    }
+}
+exports.VolorioVideoCompositorProcessor = VolorioVideoCompositorProcessor;
+function createVolorioVideoCompositorProcessor(options) {
+    return new VolorioVideoCompositorProcessor(options);
+}
+function createCanvas(width, height) {
+    if (typeof OffscreenCanvas !== "undefined") {
+        return new OffscreenCanvas(width, height);
+    }
+    if (typeof document !== "undefined") {
+        const canvas = document.createElement("canvas");
+        canvas.width = width;
+        canvas.height = height;
+        return canvas;
+    }
+    throw new Error("Volorio video processors require a browser canvas runtime");
+}
+function readFrameSize(source) {
+    const candidate = source;
+    return {
+        width: candidate.videoWidth ?? candidate.naturalWidth ?? (Number(candidate.width) || 1280),
+        height: candidate.videoHeight ?? candidate.naturalHeight ?? (Number(candidate.height) || 720),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAoFA,sFAEC;AApFY,QAAA,+BAA+B,GAAG,kBAAkB,CAAC;AACrD,QAAA,qCAAqC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAW,CAAC;AAyBxF,MAAa,+BAA+B;IACb;IAA7B,YAA6B,MAAoC;QAApC,WAAM,GAAN,MAAM,CAA8B;IAAG,CAAC;IAErE,KAAK,CAAC,SAAS,CAAC,MAA2B;QACzC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF;AAdD,0EAcC;AAED,MAAa,+BAA+B;IACjC,IAAI,GAAG,0BAA0B,CAAC;IACnC,OAAO,CAAgC;IAC9B,MAAM,CAAsC;IAC5C,OAAO,CAA+D;IAEvF,YAAY,OAAsC,EAAE,SAA8C,YAAY,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,EAAE,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC;QAC1J,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,OAAsC;QAC3C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,YAAY,CAAC,MAAyB;QACpC,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,KAAK,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC,MAAM,CAAC;QAC1D,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,SAAS,CAAC;QAC9D,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;QACxG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;YACnG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,WAAgC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACxG,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAtCD,0EAsCC;AAED,SAAgB,qCAAqC,CAAC,OAAsC;IAC1F,OAAO,IAAI,+BAA+B,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,MAAc;IACjD,IAAI,OAAO,eAAe,KAAK,WAAW,EAAE,CAAC;QAC3C,OAAO,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,aAAa,CAAC,MAAyB;IAC9C,MAAM,SAAS,GAAG,MAAuI,CAAC;IAC1J,OAAO;QACL,KAAK,EAAE,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;QAC1F,MAAM,EAAE,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,aAAa,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC;KAC9F,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@volorio/video-compositor",
+  "version": "0.2.0",
+  "private": false,
+  "description": "Volorio video compositor extension for RTC layouts and overlays.",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    }
+  },
+  "files": ["dist/src", "README.md"],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "pnpm build",
+    "pack:local": "pnpm build && npm pack --pack-destination dist"
+  },
+  "dependencies": {
+    "@volorio/rtc": "^0.2.0"
+  }
+}