@agrhub/engine-pixi 1.3.3 → 1.4.1

package/NOTICE.md

@@ -17,3 +17,5 @@ relicense or sublicense a derivative of OpenVideo.
 - Shared MediaCache: one download per URL (in-flight dedupe + memory LRU + atomic OPFS persistence).
 - StudioBridge: patches applied in order, rebuilds coalesced, latest-wins seeking, listener-safe dispose.
 - Export: falls back to an encodable audio codec (AAC -> 44.1 kHz -> Opus) instead of failing; long audio decodes no longer abort the export.
+- 1.4.0 (selected changes from OpenVideo 1.4.0; the 1.3 caption model is kept): EdgeCrop mask animation ("edgeCrop"); muted clips and tracks (preview, export and studio sync; unmuting keeps decoded audio); custom transition shader values; effect layers sized correctly when exporting at a different resolution than the project.
+- 1.4.1: Caption colour/animation changes coming from Core (caption.setColors, undo) are redrawn immediately; a caption whose own colours are removed (e.g. by undo) falls back to its track colours instead of keeping stale ones; an empty wordsPerLine no longer overrides the track setting.

package/dist/animation/mask-animation.d.ts

@@ -142,4 +142,29 @@ export declare class StarRevealAnimation extends BaseMaskAnimation {
     constructor(params: StarRevealParams, options: AnimationOptions);
     protected buildMask(progress: number): MaskTransform;
 }
+export interface EdgeCropParams {
+    mode?: "reveal" | "conceal";
+    /** Edge(s) the crop is anchored to. "center" crops all four edges. Default: "center" */
+    origin?: "center" | "topLeft" | "topRight" | "bottomLeft" | "bottomRight";
+    /** Horizontal crop in canvas pixels at the start of the reveal. Default: 100 */
+    xDistance?: number;
+    /** Vertical crop in canvas pixels at the start of the reveal. Default: 100 */
+    yDistance?: number;
+    /** Corner radius of the visible area. Default: 0 */
+    maskBorderRadius?: number;
+    feather?: number;
+}
+/**
+ * EdgeCrop (ported from @openvideo/engine-pixi 1.4.0)
+ *
+ * Crops the clip's edges by a fixed pixel distance and animates the crop away.
+ * Unlike the other masks the clip is never fully hidden: at progress 0 only the
+ * cropped band is removed. The distances stay in canvas pixels even while the
+ * clip itself is scaled by other animations.
+ */
+export declare class EdgeCropAnimation extends BaseMaskAnimation {
+    readonly type = "edgeCrop";
+    constructor(params: EdgeCropParams, options: AnimationOptions);
+    protected buildMask(progress: number): MaskTransform;
+}
 export {};

package/dist/animation/types.d.ts

@@ -77,7 +77,7 @@ export type MaskPainter = (g: {
 }, width: number, height: number, progress: number) => void;
 export interface MaskTransform {
     /** Mask shape. Use "custom" and provide a `painter` for arbitrary paths. */
-    shape: "rect" | "circle" | "ellipse" | "custom";
+    shape: "rect" | "circle" | "ellipse" | "custom" | "edgeCrop";
     /**
      * Normalized progress 0–1 controlling how much of the clip is revealed.
      * 0 = fully hidden, 1 = fully visible.
@@ -98,6 +98,12 @@ export interface MaskTransform {
      * initialProgress→1 so individual painters don't need to handle this.
      */
     initialProgress?: number;
+    /** edgeCrop: horizontal crop distance in canvas pixels at progress 0. Default: 100 */
+    xDistance?: number;
+    /** edgeCrop: vertical crop distance in canvas pixels at progress 0. Default: 100 */
+    yDistance?: number;
+    /** edgeCrop: corner radius of the visible area. Default: 0 */
+    maskBorderRadius?: number;
     /**
      * Custom painter for shape === "custom".
      * Draw any path into the provided Graphics object.

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

@@ -87,6 +87,8 @@ export declare class Caption extends BaseTextClip<ICaptionEvents> implements ICl
     private _keywordPreserveAfterSpoken;
     private _wordAnimation;
     private _wordsPerLine;
+    /** Track-level colours this clip inherits when it has none of its own (set by fromObject) */
+    private _trackCaptionColors?;
     protected _videoWidth: number;
     protected _videoHeight: number;
     protected _bottomOffset: number;

package/dist/clips/iclip.d.ts

@@ -164,6 +164,10 @@ export interface IClip<T extends BaseSpriteEvents = BaseSpriteEvents> extends Om
      * Whether the clip is locked (preventing interactions)
      */
     locked: boolean;
+    /**
+     * Whether the clip's audio is muted
+     */
+    muted: boolean;
 }
 /**
  * Optional interface for clips that support HTML media element playback

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

@@ -26,6 +26,10 @@ export declare class Transition extends BaseClip {
      * ID of the clip to which the transition ends
      */
     toClipId: string | null;
+    /**
+     * Custom shader parameter values (uniform name -> value)
+     */
+    values: Record<string, any>;
     constructor(transitionKey: TransitionKey);
     clone(): Promise<this>;
     tick(_time: number): Promise<{

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

@@ -77,6 +77,7 @@ export declare class Video extends BaseClip implements IPlaybackCapable {
     private audioSamples;
     private videoFrameFinder;
     private audioFrameFinder;
+    protected onEffectiveVolumeChange(): void;
     private decoderConf;
     private opts;
     /**

package/dist/compositor/effect-manager.d.ts

@@ -5,7 +5,9 @@ export declare class EffectManager {
     private pixiApp;
     private effectCache;
     private effectInputTexture;
-    constructor(pixiApp: Application, hasVideoTrack: boolean);
+    private scaleX;
+    private scaleY;
+    constructor(pixiApp: Application, hasVideoTrack: boolean, scaleX?: number, scaleY?: number);
     /**
      * Processes all active global and adjustment layer effects at the given timestamp.
      */