@designcombo/video 0.1.9 → 0.1.11

package/dist/{SharedSystems-j_zPWvy9.js → SharedSystems-D0OoaJby.js}

@@ -1,4 +1,4 @@
-import { F as Ie, u as Ee, l as se, M as v, G as De, v as Oe, S as Fe, x as ae, E as u, e as D, y as S, z as Le, H as O, I as b, R as F, J as ne, K as He, t as m, b as f, i as B, w as L, L as K, N as We, c as Y, B as y, j as U, O as ze, Q as C, k as M, V as w, W as Ve, a as Ne, X as ie, Y as oe, Z as le, _ as ue, C as P, $ as je, a0 as A, a1 as J, D as H, a2 as $e, a3 as qe, P as Ke, d as Ye, T as X, a4 as Q, a5 as Je, a6 as Xe, a7 as Qe } from "./index-B0AsXir7.js";
+import { F as Ie, u as Ee, l as se, M as v, G as De, v as Oe, S as Fe, x as ae, E as u, e as D, y as S, z as Le, H as O, I as b, R as F, J as ne, K as He, t as m, b as f, i as B, w as L, L as K, N as We, c as Y, B as y, j as U, O as ze, Q as C, k as M, V as w, W as Ve, a as Ne, X as ie, Y as oe, Z as le, _ as ue, C as P, $ as je, a0 as A, a1 as J, D as H, a2 as $e, a3 as qe, P as Ke, d as Ye, T as X, a4 as Q, a5 as Je, a6 as Xe, a7 as Qe } from "./index-DWKp2xEE.js";
 import { B as de, c as Ze } from "./colorToUniform-C2jGzNe1.js";
 var et = `in vec2 vMaskCoord;
 in vec2 vTextureCoord;

package/dist/{WebGLRenderer-CWO7EcYW.js → WebGLRenderer-CaF4ncl9.js}

@@ -1,6 +1,6 @@
-import { S as G, E as d, B as v, w as m, D as S, L as j, v as ve, s as U, t as b, a8 as Be, k as K, a9 as Ae, b as p, V as L, j as B, i as A, l as F, M as $, aa as z, ab as Ne, ac as ye, ad as Y, ae as Ce, A as De, R as Ie, e as T } from "./index-B0AsXir7.js";
+import { S as G, E as d, B as v, w as m, D as S, L as j, v as ve, s as U, t as b, a8 as Be, k as K, a9 as Ae, b as p, V as L, j as B, i as A, l as F, M as $, aa as z, ab as Ne, ac as ye, ad as Y, ae as Ce, A as De, R as Ie, e as T } from "./index-DWKp2xEE.js";
 import { b as q } from "./colorToUniform-C2jGzNe1.js";
-import { e as Ge, G as Ue, c as Fe, b as Oe, U as Pe, R as Me, B as Z, d as N, f as Le, S as He, a as we } from "./SharedSystems-j_zPWvy9.js";
+import { e as Ge, G as Ue, c as Fe, b as Oe, U as Pe, R as Me, B as Z, d as N, f as Le, S as He, a as we } from "./SharedSystems-D0OoaJby.js";
 class Q {
   constructor() {
     this._tempState = G.for2d(), this._didUploadHash = {};

package/dist/{WebGPURenderer-EnfWRJnb.js → WebGPURenderer-CltimhzK.js}

@@ -1,6 +1,6 @@
-import { S as E, g as A, E as p, f as ae, D as S, b as C, B as T, c as ue, d as L, h as M, w as v, i as x, j as ce, k as de, l as k, m as w, M as D, n as H, o as he, p as pe, q as z, s as F, t as R, A as le, R as fe, e as B } from "./index-B0AsXir7.js";
+import { S as E, g as A, E as p, f as ae, D as S, b as C, B as T, c as ue, d as L, h as M, w as v, i as x, j as ce, k as de, l as k, m as w, M as D, n as H, o as he, p as pe, q as z, s as F, t as R, A as le, R as fe, e as B } from "./index-DWKp2xEE.js";
 import { l as ge, a as me } from "./colorToUniform-C2jGzNe1.js";
-import { c as _e, u as be, U as xe, B as ye, G as Ge, e as Se, R as Be, t as Pe, S as Te, a as Ce } from "./SharedSystems-j_zPWvy9.js";
+import { c as _e, u as be, U as xe, B as ye, G as Ge, e as Se, R as Be, t as Pe, S as Te, a as Ce } from "./SharedSystems-D0OoaJby.js";
 const y = E.for2d();
 class O {
   start(e, t, r) {

package/dist/{browserAll-C1JdPbX8.js → browserAll-tgth3L-L.js}

@@ -1,5 +1,5 @@
-import { T as M, U as Z, P as m, r as te, E as y, a as ie, w as g, e as P, C as V } from "./index-B0AsXir7.js";
-import "./webworkerAll-BtiyFllu.js";
+import { T as M, U as Z, P as m, r as te, E as y, a as ie, w as g, e as P, C as V } from "./index-DWKp2xEE.js";
+import "./webworkerAll-CZg7nv2I.js";
 class q {
   constructor(e) {
     this._lastTransform = "", this._observer = null, this._tickerAttached = !1, this.updateTranslation = () => {

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

@@ -79,7 +79,6 @@ export declare class AudioClip extends BaseClip implements IPlaybackCapable {
      * @param time Time when tick was called
      * @param tickRet Data returned by tick
      *
-     * @see [Remove video green screen background](https://webav-tech.github.io/WebAV/demo/3_2-chromakey-video)
      */
     tickInterceptor: <T extends Awaited<ReturnType<AudioClip['tick']>>>(time: number, tickRet: T) => Promise<T>;
     private timestamp;

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

@@ -93,5 +93,24 @@ export declare abstract class BaseClip extends BaseSprite implements IClip {
      * Override in subclasses to customize handle visibility (e.g., TextClip)
      */
     getVisibleHandles(): Array<'tl' | 'tr' | 'bl' | 'br' | 'ml' | 'mr' | 'mt' | 'mb' | 'rot'>;
+    /**
+     * Scale clip to fit within the scene dimensions while maintaining aspect ratio
+     * @param sceneWidth Scene width
+     * @param sceneHeight Scene height
+     */
+    scaleToFit(sceneWidth: number, sceneHeight: number): Promise<void>;
+    /**
+     * Scale clip to fill the scene dimensions while maintaining aspect ratio
+     * May crop parts of the clip.
+     * @param sceneWidth Scene width
+     * @param sceneHeight Scene height
+     */
+    scaleToFill(sceneWidth: number, sceneHeight: number): Promise<void>;
+    /**
+     * Center the clip within the scene dimensions
+     * @param sceneWidth Scene width
+     * @param sceneHeight Scene height
+     */
+    centerInScene(sceneWidth: number, sceneHeight: number): void;
     destroy(): void;
 }

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

@@ -48,6 +48,7 @@ export interface ICaptionClipOpts {
             from: number;
             to: number;
             isKeyWord: boolean;
+            paragraphIndex?: number;
         }>;
         colors?: {
             appeared?: string;
@@ -71,6 +72,7 @@ export interface ICaptionClipOpts {
         from: number;
         to: number;
         isKeyWord: boolean;
+        paragraphIndex?: number;
     }>;
     /**
      * @deprecated Use caption.colors instead
@@ -151,6 +153,10 @@ export interface ICaptionClipOpts {
      * @default 'none'
      */
     textCase?: 'none' | 'uppercase' | 'lowercase' | 'title';
+    /**
+     * Media ID to which the captions were applied
+     */
+    mediaId?: string;
 }
 /**
  * Caption clip using Canvas 2D for rendering
@@ -182,6 +188,28 @@ export declare class CaptionClip extends BaseClip implements IClip {
     text: string;
     get style(): any;
     set style(v: any);
+    get fontFamily(): string;
+    set fontFamily(v: string);
+    get fontUrl(): string;
+    set fontUrl(v: string);
+    get fontSize(): number;
+    set fontSize(v: number);
+    get fontWeight(): string;
+    set fontWeight(v: string);
+    get fontStyle(): string;
+    set fontStyle(v: string);
+    get fill(): any;
+    set fill(v: any);
+    get align(): 'left' | 'center' | 'right';
+    set align(v: 'left' | 'center' | 'right');
+    get stroke(): any;
+    set stroke(v: any);
+    get strokeWidth(): number;
+    set strokeWidth(v: number);
+    get dropShadow(): any;
+    set dropShadow(v: any);
+    get caption(): any;
+    set caption(v: any);
     /**
      * Bottom offset from video bottom (hybrid JSON structure)
      */
@@ -195,6 +223,11 @@ export declare class CaptionClip extends BaseClip implements IClip {
      * Unique identifier for this clip instance
      */
     id: string;
+    /**
+     * Media ID of the source clip
+     */
+    get mediaId(): string | undefined;
+    set mediaId(v: string | undefined);
     /**
      * Array of effects to be applied to this clip
      * Each effect specifies key, startTime, duration, and optional targets
@@ -205,6 +238,14 @@ export declare class CaptionClip extends BaseClip implements IClip {
         startTime: number;
         duration: number;
     }>;
+    /**
+     * Words getter for the clip
+     */
+    get words(): any[];
+    /**
+     * Words setter that triggers re-render and ensures consistency
+     */
+    set words(v: any[]);
     private opts;
     private pixiTextContainer;
     private renderTexture;

package/dist/clips/iclip.d.ts

@@ -19,10 +19,8 @@ export interface ITransitionInfo {
  *
  * Clips are abstractions of different data types, providing data to other modules
  *
- * WebAV provides built-in {@link VideoClip}, {@link AudioClip}, {@link ImageClip} and other common clips for providing data to {@link Compositor} and {@link AVCanvas}
  *
  * You only need to implement this interface to create custom clips, giving you maximum flexibility to generate video content such as animations and transition effects
- * @see [Custom Clip](https://webav-tech.github.io/WebAV/demo/2_6-custom-clip)
  *
  */
 export interface IClip extends Omit<BaseSprite, 'destroy' | 'ready'> {
@@ -32,6 +30,10 @@ export interface IClip extends Omit<BaseSprite, 'destroy' | 'ready'> {
      * Clip type (e.g., 'video', 'image', 'text', 'audio')
      */
     readonly type: string;
+    /**
+     * Source URL or identifier for this clip
+     */
+    src: string;
     /**
      * Extract data from clip at specified time
      * @param time Time in microseconds
@@ -97,6 +99,18 @@ export interface IClip extends Omit<BaseSprite, 'destroy' | 'ready'> {
      * @returns Array of handle kinds that should be visible
      */
     getVisibleHandles?: () => Array<'tl' | 'tr' | 'bl' | 'br' | 'ml' | 'mr' | 'mt' | 'mb' | 'rot'>;
+    /**
+     * Scale clip to fit within the scene dimensions while maintaining aspect ratio
+     */
+    scaleToFit(sceneWidth: number, sceneHeight: number): Promise<void>;
+    /**
+     * Scale clip to fill the scene dimensions while maintaining aspect ratio
+     */
+    scaleToFill(sceneWidth: number, sceneHeight: number): Promise<void>;
+    /**
+     * Center the clip within the scene dimensions
+     */
+    centerInScene(sceneWidth: number, sceneHeight: number): void;
 }
 /**
  * Optional interface for clips that support HTML media element playback

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

@@ -24,7 +24,6 @@ type AnimateImgType = 'avif' | 'webp' | 'png' | 'gif';
  *   )
  * )
  *
- * @see [Video composition](https://webav-tech.github.io/WebAV/demo/2_1-concat-video)
  */
 export declare class ImageClip extends BaseClip implements IClip {
     readonly type = "Image";
@@ -112,26 +111,5 @@ export declare class ImageClip extends BaseClip implements IClip {
      * @returns Promise that resolves to an ImageClip instance
      */
     static fromObject(json: ClipJSON): Promise<ImageClip>;
-    /**
-     * Scale clip to fit within the scene dimensions while maintaining aspect ratio
-     * Similar to fabric.js scaleToFit
-     * @param sceneWidth Scene width
-     * @param sceneHeight Scene height
-     */
-    scaleToFit(sceneWidth: number, sceneHeight: number): Promise<void>;
-    /**
-     * Scale clip to fill the scene dimensions while maintaining aspect ratio
-     * May crop parts of the clip. Similar to fabric.js scaleToFill
-     * @param sceneWidth Scene width
-     * @param sceneHeight Scene height
-     */
-    scaleToFill(sceneWidth: number, sceneHeight: number): Promise<void>;
-    /**
-     * Center the clip within the scene dimensions
-     * Similar to fabric.js center
-     * @param sceneWidth Scene width
-     * @param sceneHeight Scene height
-     */
-    centerInScene(sceneWidth: number, sceneHeight: number): void;
 }
 export {};

package/dist/clips/index.d.ts

@@ -7,4 +7,5 @@ export { VideoClip } from './video-clip';
 export type { IMP4ClipOpts } from './video-clip';
 export * from './text-clip';
 export * from './effect-clip';
+export * from './placeholder-clip';
 export * from './transition-clip';

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

@@ -0,0 +1,15 @@
+import { BaseClip } from './base-clip';
+import { IClipMeta } from './iclip';
+export declare class PlaceholderClip extends BaseClip {
+    type: string;
+    meta: IClipMeta;
+    constructor(src: string, meta?: Partial<IClipMeta>, type?: string);
+    private placeholderFrame;
+    tick(time: number): Promise<{
+        video?: ImageBitmap | null;
+        audio?: Float32Array[];
+        state: 'done' | 'success';
+    }>;
+    clone(): Promise<this>;
+    split(time: number): Promise<[this, this]>;
+}

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

@@ -23,6 +23,10 @@ export interface ITextClipOpts {
      * @default 'normal'
      */
     fontStyle?: string;
+    /**
+     * Font URL for custom fonts
+     */
+    fontUrl?: string;
     /**
      * Text color (hex string, color name, or gradient object)
      * @default '#ffffff'

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

@@ -1,4 +1,4 @@
-import { MP4Sample } from '@webav/mp4box.js';
+import { MP4Sample } from 'wrapbox';
 import { file } from 'opfs-tools';
 import { BaseClip } from './base-clip';
 import { IClip, IPlaybackCapable } from './iclip';
@@ -16,7 +16,7 @@ export interface IMP4ClipOpts {
         volume: number;
     };
     /**
-     * 不安全，随时可能废弃
+     * Unsafe, may be deprecated at any time
      */
     __unsafe_hardwareAcceleration__?: HardwarePreference;
 }
@@ -47,15 +47,6 @@ type ExtMP4Sample = Omit<MP4Sample, 'data'> & {
  *   },
  * });
  *
- * @example
- * // Direct constructor (for advanced use)
- * new VideoClip((await fetch('<mp4 url>')).body)
- * new VideoClip(mp4File.stream())
- *
- * @see {@link Compositor}
- * @see [AVCanvas](../../av-canvas/classes/AVCanvas.html)
- *
- * @see [Decode and play video](https://webav-tech.github.io/WebAV/demo/1_1-decode-video)
  */
 export declare class VideoClip extends BaseClip implements IPlaybackCapable {
     readonly type = "Video";
@@ -132,8 +123,7 @@ export declare class VideoClip extends BaseClip implements IPlaybackCapable {
      * @param time Time when tick was called
      * @param tickRet Data returned by tick
      *
-     * @see [Remove video green screen background](https://webav-tech.github.io/WebAV/demo/3_2-chromakey-video)
-     */
+     *    */
     tickInterceptor: <T extends Awaited<ReturnType<VideoClip['tick']>>>(time: number, tickRet: T) => Promise<T>;
     /**
      * Get image frame and audio data at specified time

package/dist/compositor.d.ts

@@ -1,4 +1,5 @@
 import { IClip } from './clips';
+import { default as EventEmitter } from './event-emitter';
 import { ProjectJSON } from './json-serialization';
 export interface ICompositorOpts {
     width?: number;
@@ -22,9 +23,6 @@ export interface ICompositorOpts {
 }
 /**
  * Video compositor that can add multiple {@link OffscreenSprite} instances,
- * compositing them based on position, z-index, time offset, etc., into an output video file
- * @see [Video Composition](https://webav-tech.github.io/WebAV/demo/2_1-concat-video)
- * @see [Video Audio Mixing](https://webav-tech.github.io/WebAV/demo/2_2-video-add-audio)
  * @example
  * const spr1 = new OffscreenSprite(
  *   new VideoClip((await fetch('<mp4 url>')).body),
@@ -40,7 +38,10 @@ export interface ICompositorOpts {
  * com.output(); // => ReadableStream
  *
  */
-export declare class Compositor {
+export declare class Compositor extends EventEmitter<{
+    OutputProgress: number;
+    error: Error;
+}> {
     /**
      * Check compatibility with the current environment
      * @param args.videoCodec Specify video codec, default avc1.42E032
@@ -62,11 +63,6 @@ export declare class Compositor {
     private stopOutput;
     private opts;
     private hasVideoTrack;
-    private evtTool;
-    on: <Type extends "error" | "OutputProgress">(type: Type, listener: {
-        OutputProgress: (progress: number) => void;
-        error: (err: Error) => void;
-    }[Type]) => (() => void);
     /**
      * Create a compositor instance based on configuration
      * @param opts ICompositorOpts

package/dist/event-emitter.d.ts

@@ -22,9 +22,17 @@ export default class EventEmitter<Events extends Record<EventType, unknown>> imp
      * Register an event handler for the given type.
      * @param {string|symbol} type Type of event to listen for, or `'*'` for all events
      * @param {Function} handler Function to call in response to given event
+     * @returns {Function} A function to unregister the handler
      */
-    on<Key extends keyof Events>(type: Key, handler: Handler<Events[Key]>): void;
-    on(type: '*', handler: WildcardHandler<Events>): void;
+    on<Key extends keyof Events>(type: Key, handler: Handler<Events[Key]>): () => void;
+    on(type: '*', handler: WildcardHandler<Events>): () => void;
+    /**
+     * Register a one-time event handler for the given type.
+     * @param {string|symbol} type Type of event to listen for
+     * @param {Function} handler Function to call in response to given event
+     * @returns {Function} A function to unregister the handler
+     */
+    once<Key extends keyof Events>(type: Key, handler: Handler<Events[Key]>): () => void;
     /**
      * Remove an event handler for the given type.
      * If `handler` is omitted, all handlers of the given type are removed.