openvideo 0.2.15 → 0.2.17

package/dist/{browserAll-1klNNaYF.js → browserAll-CRgUZ3hq.js}

@@ -1,5 +1,5 @@
-import { e as a, A as e, C as i, a as s, E as t, F as n, D as d } from "./index-CqBdAdbt.js";
-import "./webworkerAll-05Hpn3rq.js";
+import { e as a, A as e, C as i, a as s, E as t, F as n, D as d } from "./index-Gj63TxQW.js";
+import "./webworkerAll-S6vnaIy0.js";
 a.add(e);
 a.mixin(i, s);
 a.add(t);

package/dist/clips/base-clip.d.ts

@@ -15,6 +15,10 @@ export declare abstract class BaseClip<T extends BaseSpriteEvents = BaseSpriteEv
      * Used for serialization and reloading from JSON
      */
     src: string;
+    /**
+     * User-defined metadata
+     */
+    metadata: Record<string, any>;
     /**
      * Transition info (optional)
      */

package/dist/clips/caption-clip.d.ts

@@ -4,8 +4,8 @@ import { CaptionJSON, ICaptionWordAnimation } from '../json-serialization';
 import { Application, Texture } from 'pixi.js';
 import { BaseSpriteEvents } from '../sprite/base-sprite';
 export interface ITextBoxStyle {
-    style?: "tiktok" | "none";
-    textAlign?: "left" | "center" | "right" | "";
+    style?: 'tiktok' | 'none';
+    textAlign?: 'left' | 'center' | 'right' | '';
     maxLines?: number;
     borderRadius?: number;
     horizontalPadding?: number;
@@ -16,11 +16,11 @@ export interface ICaptionStyle {
     fontFamily?: string;
     fontWeight?: string | number;
     fontStyle?: string;
-    color?: ICaptionOpts["fill"];
-    align?: ICaptionOpts["align"];
-    textCase?: ICaptionOpts["textCase"];
-    verticalAlign?: ICaptionOpts["verticalAlign"];
-    wordsPerLine?: ICaptionOpts["wordsPerLine"];
+    color?: ICaptionOpts['fill'];
+    align?: ICaptionOpts['align'];
+    textCase?: ICaptionOpts['textCase'];
+    verticalAlign?: ICaptionOpts['verticalAlign'];
+    wordsPerLine?: ICaptionOpts['wordsPerLine'];
     stroke?: {
         color: string | number;
         width: number;
@@ -46,14 +46,14 @@ export interface ICaptionEvents extends BaseSpriteEvents {
         opacity: number;
         volume: number;
         text: string;
-        words: ICaptionOpts["words"];
-        fill: ICaptionOpts["fill"];
-        align: ICaptionOpts["align"];
-        textCase: ICaptionOpts["textCase"];
-        stroke: ICaptionOpts["stroke"];
-        dropShadow: ICaptionOpts["dropShadow"];
-        caption: ICaptionOpts["caption"];
-        wordsPerLine: ICaptionOpts["wordsPerLine"];
+        words: ICaptionOpts['words'];
+        fill: ICaptionOpts['fill'];
+        align: ICaptionOpts['align'];
+        textCase: ICaptionOpts['textCase'];
+        stroke: ICaptionOpts['stroke'];
+        dropShadow: ICaptionOpts['dropShadow'];
+        caption: ICaptionOpts['caption'];
+        wordsPerLine: ICaptionOpts['wordsPerLine'];
         textBoxStyle: ITextBoxStyle;
     }>;
 }
@@ -84,7 +84,7 @@ export interface ICaptionOpts {
      * @default '#ffffff'
      */
     fill?: string | number | {
-        type: "gradient";
+        type: 'gradient';
         x0: number;
         y0: number;
         x1: number;
@@ -163,7 +163,7 @@ export interface ICaptionOpts {
     stroke?: string | number | {
         color: string | number;
         width: number;
-        join?: "miter" | "round" | "bevel";
+        join?: 'miter' | 'round' | 'bevel';
     };
     /**
      * Stroke width in pixels (used when stroke is a simple color)
@@ -174,7 +174,7 @@ export interface ICaptionOpts {
      * Text alignment ('left', 'center', 'right')
      * @default 'center'
      */
-    align?: "left" | "center" | "right";
+    align?: 'left' | 'center' | 'right';
     /**
      * Drop shadow configuration
      */
@@ -194,7 +194,7 @@ export interface ICaptionOpts {
      * Word wrap mode ('break-word' or 'normal')
      * @default 'break-word'
      */
-    wordWrapMode?: "break-word" | "normal";
+    wordWrapMode?: 'break-word' | 'normal';
     /**
      * Whether to enable word wrap
      * @default true
@@ -204,7 +204,7 @@ export interface ICaptionOpts {
      * Vertical alignment ('top', 'center', 'bottom')
      * @default 'bottom'
      */
-    verticalAlign?: "top" | "center" | "bottom";
+    verticalAlign?: 'top' | 'center' | 'bottom';
     /**
      * Line height (multiplier)
      * @default 1
@@ -219,7 +219,7 @@ export interface ICaptionOpts {
      * Text case transformation
      * @default 'none'
      */
-    textCase?: "none" | "uppercase" | "lowercase" | "title";
+    textCase?: 'none' | 'uppercase' | 'lowercase' | 'title';
     /**
      * Media ID to which the captions were applied
      */
@@ -232,7 +232,7 @@ export interface ICaptionOpts {
      * Words per line mode ('single' or 'multiple')
      * @default 'multiple'
      */
-    wordsPerLine?: "single" | "multiple";
+    wordsPerLine?: 'single' | 'multiple';
     wordAnimation?: ICaptionWordAnimation;
     textBoxStyle?: ITextBoxStyle;
 }
@@ -253,7 +253,7 @@ export interface ICaptionOpts {
  */
 export declare class Caption extends BaseClip<ICaptionEvents> implements IClip {
     readonly type = "Caption";
-    ready: IClip["ready"];
+    ready: IClip['ready'];
     private _meta;
     get meta(): {
         duration: number;
@@ -286,8 +286,8 @@ export declare class Caption extends BaseClip<ICaptionEvents> implements IClip {
     set text(v: string);
     get style(): ICaptionStyle;
     set style(v: Partial<ICaptionOpts> | ICaptionStyle);
-    get wordsPerLine(): "single" | "multiple";
-    set wordsPerLine(v: "single" | "multiple");
+    get wordsPerLine(): 'single' | 'multiple';
+    set wordsPerLine(v: 'single' | 'multiple');
     get fontFamily(): string;
     set fontFamily(v: string);
     get fontUrl(): string;
@@ -296,20 +296,20 @@ export declare class Caption extends BaseClip<ICaptionEvents> implements IClip {
     set fontSize(v: number);
     get fontWeight(): string | number;
     set fontWeight(v: string | number);
-    get fontStyle(): "normal" | "italic" | "oblique";
-    set fontStyle(v: "normal" | "italic" | "oblique");
-    get fill(): ICaptionOpts["fill"];
-    set fill(v: ICaptionOpts["fill"]);
-    get align(): "left" | "center" | "right";
-    set align(v: "left" | "center" | "right");
-    get stroke(): ICaptionOpts["stroke"];
-    set stroke(v: ICaptionOpts["stroke"]);
+    get fontStyle(): 'normal' | 'italic' | 'oblique';
+    set fontStyle(v: 'normal' | 'italic' | 'oblique');
+    get fill(): ICaptionOpts['fill'];
+    set fill(v: ICaptionOpts['fill']);
+    get align(): 'left' | 'center' | 'right';
+    set align(v: 'left' | 'center' | 'right');
+    get stroke(): ICaptionOpts['stroke'];
+    set stroke(v: ICaptionOpts['stroke']);
     get strokeWidth(): number;
     set strokeWidth(v: number);
-    get dropShadow(): ICaptionOpts["dropShadow"];
-    set dropShadow(v: ICaptionOpts["dropShadow"]);
-    get caption(): ICaptionOpts["caption"];
-    set caption(v: ICaptionOpts["caption"]);
+    get dropShadow(): ICaptionOpts['dropShadow'];
+    set dropShadow(v: ICaptionOpts['dropShadow']);
+    get caption(): ICaptionOpts['caption'];
+    set caption(v: ICaptionOpts['caption']);
     get textBoxStyle(): ITextBoxStyle;
     set textBoxStyle(v: ITextBoxStyle);
     /**
@@ -320,7 +320,7 @@ export declare class Caption extends BaseClip<ICaptionEvents> implements IClip {
      * Text case proxy
      */
     get textCase(): string;
-    set textCase(v: "none" | "uppercase" | "lowercase" | "title");
+    set textCase(v: 'none' | 'uppercase' | 'lowercase' | 'title');
     /**
      * Unique identifier for this clip instance
      */
@@ -347,7 +347,7 @@ export declare class Caption extends BaseClip<ICaptionEvents> implements IClip {
     /**
      * Words setter that triggers re-render and ensures consistency
      */
-    set words(v: ICaptionOpts["words"]);
+    set words(v: ICaptionOpts['words']);
     private opts;
     private pixiTextContainer;
     private renderTexture;
@@ -359,7 +359,7 @@ export declare class Caption extends BaseClip<ICaptionEvents> implements IClip {
     private externalRenderer;
     private pixiApp;
     private originalOpts;
-    constructor(text: string, opts?: ICaptionOpts, renderer?: Application["renderer"]);
+    constructor(text: string, opts?: ICaptionOpts, renderer?: Application['renderer']);
     /**
      * Update text styling options and refresh the caption rendering
      */
@@ -378,11 +378,11 @@ export declare class Caption extends BaseClip<ICaptionEvents> implements IClip {
     /**
      * Set an external renderer (e.g., from Studio) to avoid creating our own Pixi App
      */
-    setRenderer(renderer: Application["renderer"]): void;
+    setRenderer(renderer: Application['renderer']): void;
     private getRenderer;
     tick(time: number): Promise<{
         video: ImageBitmap;
-        state: "success";
+        state: 'success';
     }>;
     split(_time: number): Promise<[this, this]>;
     addEffect(effect: {
@@ -406,6 +406,6 @@ export declare class Caption extends BaseClip<ICaptionEvents> implements IClip {
      * @returns Promise that resolves to a Caption instance
      */
     static fromObject(json: CaptionJSON): Promise<Caption>;
-    getVisibleHandles(): Array<"tl" | "tr" | "bl" | "br" | "ml" | "mr" | "mt" | "mb" | "rot">;
+    getVisibleHandles(): Array<'tl' | 'tr' | 'bl' | 'br' | 'ml' | 'mr' | 'mt' | 'mb' | 'rot'>;
     private drawRoundedTiktokPath;
 }

package/dist/clips/iclip.d.ts

@@ -1,4 +1,5 @@
 import { BaseSprite, BaseSpriteEvents } from '../sprite/base-sprite';
+import { ColorAdjustment } from '../utils/color-adjustment';
 export interface IClipMeta {
     width: number;
     height: number;
@@ -40,6 +41,10 @@ export interface IClip<T extends BaseSpriteEvents = BaseSpriteEvents> extends Om
      * Name of this clip
      */
     name: string;
+    /**
+     * User-defined metadata
+     */
+    metadata: Record<string, any>;
     /**
      * Source URL or identifier for this clip
      */
@@ -144,6 +149,10 @@ export interface IClip<T extends BaseSpriteEvents = BaseSpriteEvents> extends Om
      * Chroma key settings (green screen removal)
      */
     chromaKey: IChromaKeyOpts;
+    /**
+     * Clip color adjustment settings
+     */
+    colorAdjustment: ColorAdjustment;
     /**
      * Whether the clip is locked (preventing interactions)
      */

package/dist/clips/video-clip.d.ts

@@ -20,7 +20,7 @@ export interface IMP4ClipOpts {
      */
     __unsafe_hardwareAcceleration__?: HardwarePreference;
 }
-type ExtMP4Sample = Omit<MP4Sample, 'data'> & {
+type ExtMP4Sample = Omit<MP4Sample, "data"> & {
     is_idr: boolean;
     deleted?: boolean;
     data: null | Uint8Array;
@@ -57,7 +57,7 @@ export declare class Video extends BaseClip implements IPlaybackCapable {
     readonly type = "Video";
     private insId;
     private logger;
-    ready: IClip['ready'];
+    ready: IClip["ready"];
     private _meta;
     get meta(): {
         duration: number;
@@ -129,7 +129,7 @@ export declare class Video extends BaseClip implements IPlaybackCapable {
      * @param tickRet Data returned by tick
      *
      *    */
-    tickInterceptor: <T extends Awaited<ReturnType<Video['tick']>>>(time: number, tickRet: T) => Promise<T>;
+    tickInterceptor: <T extends Awaited<ReturnType<Video["tick"]>>>(time: number, tickRet: T) => Promise<T>;
     /**
      * Get image frame and audio data at specified time
      * @param time Time in microseconds
@@ -137,7 +137,7 @@ export declare class Video extends BaseClip implements IPlaybackCapable {
     tick(time: number): Promise<{
         video?: VideoFrame;
         audio: Float32Array[];
-        state: 'success' | 'done';
+        state: "success" | "done";
     }>;
     private thumbAborter;
     private thumbFinder;

package/dist/compositor.d.ts

@@ -102,6 +102,23 @@ export declare class Compositor extends EventEmitter<{
      * @param json The JSON project data
      */
     loadFromJSON(json: ProjectJSON): Promise<void>;
+    /**
+     * Renders the frame at the given time and returns it as a base64-encoded PNG.
+     *
+     * Initialises the internal Pixi application on demand (if not already
+     * initialised), performs a single-frame render using the same sprite
+     * pipeline as {@link output}, and returns the result without modifying
+     * the compositor's encoding state.
+     *
+     * @param timeMs Time in milliseconds
+     * @returns Base64 data-URL string (e.g. "data:image/png;base64,...")
+     *
+     * @example
+     * const compositor = new Compositor({ width: 1280, height: 720 });
+     * await compositor.addSprite(videoClip);
+     * const frame = await compositor.renderFrame(2000); // frame at 2 s
+     */
+    renderFrame(timeMs: number): Promise<string>;
 }
 /**
  * Buffer input data and convert to AudioData with fixed frame count

package/dist/effect/glsl/custom-glsl.d.ts

@@ -1030,3 +1030,4 @@ export declare const CHROMA_KEY_UNIFORMS: {
         type: string;
     };
 };
+export declare const SELECTIVE_HSL_FRAGMENT = "\nin vec2 vTextureCoord;\nin vec4 vColor;\nuniform sampler2D uTexture;\nout vec4 finalColor;\n\nuniform vec3 uTargetColor;\nuniform float uHueShift;\nuniform float uSatShift;\nuniform float uLightShift;\nuniform float uTolerance;\nuniform float uSoftness;\n\nvec3 rgb2hsl(vec3 c) {\n    float maxc = max(max(c.r, c.g), c.b);\n    float minc = min(min(c.r, c.g), c.b);\n    float h = 0.0;\n    float s = 0.0;\n    float l = (maxc + minc) * 0.5;\n\n    float d = maxc - minc;\n    if (d > 0.00001) {\n        s = l > 0.5 ? d / (2.0 - maxc - minc) : d / (maxc + minc);\n        if (maxc == c.r) {\n            h = (c.g - c.b) / d + (c.g < c.b ? 6.0 : 0.0);\n        } else if (maxc == c.g) {\n            h = (c.b - c.r) / d + 2.0;\n        } else {\n            h = (c.r - c.g) / d + 4.0;\n        }\n        h /= 6.0;\n    }\n    return vec3(h, s, l);\n}\n\nfloat hue2rgb(float p, float q, float t) {\n    if (t < 0.0) t += 1.0;\n    if (t > 1.0) t -= 1.0;\n    if (t < 1.0 / 6.0) return p + (q - p) * 6.0 * t;\n    if (t < 1.0 / 2.0) return q;\n    if (t < 2.0 / 3.0) return p + (q - p) * (2.0 / 3.0 - t) * 6.0;\n    return p;\n}\n\nvec3 hsl2rgb(vec3 hsl) {\n    float h = hsl.x;\n    float s = hsl.y;\n    float l = hsl.z;\n    if (s <= 0.00001) return vec3(l);\n    float q = l < 0.5 ? l * (1.0 + s) : l + s - l * s;\n    float p = 2.0 * l - q;\n    return vec3(\n        hue2rgb(p, q, h + 1.0 / 3.0),\n        hue2rgb(p, q, h),\n        hue2rgb(p, q, h - 1.0 / 3.0)\n    );\n}\n\nvoid main() {\n    vec4 src = texture(uTexture, vTextureCoord);\n    float dist = distance(src.rgb, uTargetColor);\n    float mask = 1.0 - smoothstep(uTolerance, uTolerance + uSoftness, dist);\n\n    vec3 hsl = rgb2hsl(src.rgb);\n    hsl.x = mod(hsl.x + (uHueShift / 360.0), 1.0);\n    hsl.y = clamp(hsl.y + uSatShift, 0.0, 1.0);\n    hsl.z = clamp(hsl.z + uLightShift, 0.0, 1.0);\n    vec3 adjusted = hsl2rgb(hsl);\n\n    vec3 resultColor = mix(src.rgb, adjusted, mask);\n    finalColor = vec4(resultColor, src.a);\n}\n";