@designcombo/video 0.0.1 → 0.0.3

package/dist/json-serialization.d.ts

@@ -1,5 +1,13 @@
 import { IClip } from './clips';
 interface BaseClipJSON {
+    id?: string;
+    effects?: Array<{
+        id: string;
+        key: string;
+        startTime: number;
+        duration: number;
+        targets?: number[];
+    }>;
     src: string;
     display: {
         from: number;
@@ -15,6 +23,10 @@ interface BaseClipJSON {
     zIndex: number;
     opacity: number;
     flip: 'horizontal' | 'vertical' | null;
+    trim?: {
+        from: number;
+        to: number;
+    };
     animation?: {
         keyFrames: Record<string, Partial<{
             x: number;
@@ -122,8 +134,21 @@ export interface CaptionClipJSON extends BaseClipJSON {
     fontUrl?: string;
 }
 export type ClipJSON = VideoClipJSON | AudioClipJSON | ImageClipJSON | TextClipJSON | CaptionClipJSON;
+export interface StudioTrackJSON {
+    id: string;
+    name: string;
+    type: string;
+    clipIds: string[];
+}
 export interface ProjectJSON {
+    tracks?: StudioTrackJSON[];
     clips: ClipJSON[];
+    globalEffects?: Array<{
+        id: string;
+        key: string;
+        startTime: number;
+        duration: number;
+    }>;
     settings?: {
         width?: number;
         height?: number;

package/dist/sprite/base-sprite.d.ts

@@ -15,6 +15,10 @@ type TKeyFrameOpts = Partial<Record<`${number}%` | 'from' | 'to', Partial<TAnima
  * @see {@link OffscreenSprite}
  */
 export declare abstract class BaseSprite {
+    /**
+     * Unique identifier for the sprite/clip
+     */
+    id: string;
     /**
      * Control display time range of clips, commonly used in editing scenario timeline (track) module
      * from: start time offset in microseconds
@@ -36,6 +40,15 @@ export declare abstract class BaseSprite {
      *    2. Audio uses the simplest interpolation algorithm to change rate, so changing rate will cause pitch variation, for custom algorithm please use {@link VideoClip.tickInterceptor} to implement
      */
     playbackRate: number;
+    /**
+     * Trim range of the source media in microseconds
+     * from: start time in microseconds
+     * to: end time in microseconds
+     */
+    trim: {
+        from: number;
+        to: number;
+    };
     private evtTool;
     /**
      * Listen to property change events
@@ -50,6 +63,10 @@ export declare abstract class BaseSprite {
             height: number;
             angle: number;
             zIndex: number;
+            blur: number;
+            brightness: number;
+            round: number;
+            volume: number;
         }>) => void;
     }[Type]) => (() => void);
     private _left;
@@ -96,6 +113,30 @@ export declare abstract class BaseSprite {
      * Control layering relationship between clips, clips with smaller zIndex will be occluded
      */
     set zIndex(v: number);
+    private _blur;
+    /**
+     * Blur intensity (0.0 to 1.0, where 1.0 is max useful blur, e.g. 50px)
+     */
+    get blur(): number;
+    set blur(v: number);
+    private _brightness;
+    /**
+     * Brightness intensity (0.0 to 1.0, where 0.0 is Normal, 1.0 is Maximum)
+     */
+    get brightness(): number;
+    set brightness(v: number);
+    private _round;
+    /**
+     * Rounded corners intensity (0.0 to 1.0, where 1.0 is a perfect circle/capsule)
+     */
+    get round(): number;
+    set round(v: number);
+    private _volume;
+    /**
+     * Audio volume (0.0 to 1.0)
+     */
+    get volume(): number;
+    set volume(v: number);
     /**
      * Opacity
      */
@@ -104,6 +145,13 @@ export declare abstract class BaseSprite {
      * Flip clip horizontally or vertically
      */
     flip: 'horizontal' | 'vertical' | null;
+    effects: Array<{
+        id: string;
+        key: string;
+        startTime: number;
+        duration: number;
+        targets?: number[];
+    }>;
     private animatKeyFrame;
     private animatOpts;
     /**

package/dist/sprite/pixi-sprite-renderer.d.ts

@@ -19,7 +19,10 @@ export declare class PixiSpriteRenderer {
     private canvas;
     private context;
     private destroyed;
-    constructor(pixiApp: Application | null, sprite: IClip, targetContainer?: Container | null);
+    private blurFilter;
+    private colorMatrixFilter;
+    private roundMask;
+    constructor(_pixiApp: Application | null, sprite: IClip, targetContainer?: Container | null);
     /**
      * Update the sprite with a new video frame or Texture
      * @param frame ImageBitmap, Texture, or null to render
@@ -28,21 +31,9 @@ export declare class PixiSpriteRenderer {
     updateFrame(frame: ImageBitmap | Texture | null): Promise<void>;
     /**
      * Apply sprite transformations to the Pixi Sprite
-     * This reads the current sprite properties (which may have been updated by animations)
-     * and applies them to the Pixi sprite
      */
     private applySpriteTransforms;
-    /**
-     * Update sprite properties without changing the frame
-     * Useful when sprite properties change but frame stays the same
-     */
     updateTransforms(): void;
-    /**
-     * Get the Pixi Sprite instance
-     */
     getSprite(): Sprite | null;
-    /**
-     * Destroy the renderer and clean up resources
-     */
     destroy(): void;
 }

package/dist/studio.d.ts

@@ -1,11 +1,55 @@
 import { IClip } from './clips/iclip';
 import { ProjectJSON } from './json-serialization';
+import { EffectKey } from './effect/glsl/gl-effect';
+import { default as EventEmitter } from './event-emitter';
 export interface IStudioOpts {
     width: number;
     height: number;
     fps?: number;
     bgColor?: string;
     canvas?: HTMLCanvasElement;
+    interactivity?: boolean;
+}
+export interface StudioEvents {
+    'selection:created': {
+        selected: IClip[];
+    };
+    'selection:updated': {
+        selected: IClip[];
+    };
+    'selection:cleared': {
+        deselected: IClip[];
+    };
+    'track:added': {
+        track: StudioTrack;
+    };
+    'track:removed': {
+        trackId: string;
+    };
+    'clip:added': {
+        clip: IClip;
+        trackId: string;
+    };
+    'clip:removed': {
+        clipId: string;
+    };
+    currentTime: {
+        currentTime: number;
+    };
+    play: {
+        isPlaying: boolean;
+    };
+    pause: {
+        isPlaying: boolean;
+    };
+    [key: string]: any;
+    [key: symbol]: any;
+}
+export interface StudioTrack {
+    id: string;
+    name: string;
+    type: string;
+    clipIds: string[];
 }
 /**
  * Interactive preview studio for clips with playback controls
@@ -22,9 +66,14 @@ export interface IStudioOpts {
  * await studio.addClip(spr1);
  * await studio.addClip(spr2);
  * studio.play();
+ *
+ * studio.on('selection:created', ({ selected }) => {
+ *   console.log('Selection created', selected);
+ * });
  */
-export declare class Studio {
+export declare class Studio extends EventEmitter<StudioEvents> {
     private pixiApp;
+    private tracks;
     private clips;
     private spriteRenderers;
     private artboard;
@@ -44,6 +93,12 @@ export declare class Studio {
     private maxDuration;
     private opts;
     private destroyed;
+    private globalEffects;
+    private activeGlobalEffect;
+    private currentGlobalEffectSprite;
+    private effectFilters;
+    private clipsNormalContainer;
+    private clipsEffectContainer;
     /**
      * Convert hex color string to number
      */
@@ -65,7 +120,35 @@ export declare class Studio {
      * @param clip The clip to add
      * @param audioSource Optional audio source (URL, File, or Blob) for AudioClip playback
      */
-    addClip(clip: IClip, audioSource?: string | File | Blob): Promise<void>;
+    addClip(clip: IClip, options?: {
+        trackId?: string;
+        audioSource?: string | File | Blob;
+    } | string | File | Blob): Promise<void>;
+    /**
+     * Add a new track to the studio
+     */
+    addTrack(track: {
+        name: string;
+        type: string;
+        id?: string;
+    }): StudioTrack;
+    /**
+     * Set tracks (and implicitly clips if they are new)
+     */
+    setTracks(tracks: StudioTrack[]): Promise<void>;
+    /**
+     * Remove a track and all its clips
+     */
+    removeTrack(trackId: string): Promise<void>;
+    /**
+     * Update a clip's properties
+     * Handles consistency between display (from/to) and duration
+     */
+    updateClip(id: string, updates: Partial<IClip>): Promise<void>;
+    /**
+     * Get all tracks
+     */
+    getTracks(): StudioTrack[];
     /**
      * Setup sprite interactivity for click selection
      */
@@ -115,6 +198,20 @@ export declare class Studio {
     private renderLoop;
     private updateFrame;
     private recalculateMaxDuration;
+    /**
+     * Apply global effect to the current scene
+     */
+    moveClipToEffectContainer(clip: IClip, toEffect?: boolean): void;
+    applyGlobalEffect(key: EffectKey, options: {
+        startTime: number;
+        duration?: number;
+        id?: string;
+    }, clips: IClip[]): string;
+    getTrackIndex(clipId: string): number;
+    removeGlobalEffect(id: string): void;
+    clearGlobalEffects(): void;
+    private updateActiveGlobalEffect;
+    private applyGlobalEffectIfNeeded;
     /**
      * Destroy the studio and clean up resources
      */
@@ -154,4 +251,5 @@ export declare class Studio {
      * @param json The JSON project data
      */
     loadFromJSON(json: ProjectJSON): Promise<void>;
+    private loadClipIntoTrack;
 }