@scenerok/sdk 0.8.0 → 0.10.0

package/dist/ir.d.ts

@@ -1,16 +1,47 @@
 /**
- * IRTimeline contract — mirrors src/types/ir.ts so the SDK can ship standalone.
- * Keep fields in sync with the platform IR; Pass 2 consumes this shape.
+ * IRTimeline contract — a copy of the platform's `src/types/ir.ts` so the SDK
+ * ships standalone. Keep the two in sync: Pass 2 (preview and render) consumes
+ * this shape, and `src/lib/sdk-runtime/ir-parity.unit.test.ts` fails when they
+ * drift.
+ */
+/**
+ * Source-text correlation for timeline editing. When present, records the
+ * character-offset span of the originating `[ ... ]` timespec in the VidScript
+ * source (`start` is the offset of the `[`). Used by the editor timeline to map
+ * IR elements back to their source block for surgical start/end edits. Additive
+ * metadata only — never affects rendering.
  */
 export interface IRSourceTimespec {
     start: number;
     end: number;
 }
+/**
+ * A rectangle of the picture to show, in pixels from its top-left. A clip's is
+ * in its source's pixels; a group's is in its target's. The drawn size stays
+ * `width` × `height` of the item; the crop picks which part fills it.
+ */
+export interface IRCrop {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** How a matte's picture scales the item below it: its alpha, its luminance, or one minus its alpha. */
+export type IRMaskMode = 'alpha' | 'luma' | 'inverted';
 export interface IRTimeline {
     version: 1;
     width: number;
     height: number;
     fps: number;
+    /**
+     * Exact frame duration `num / den` seconds, set only when `fps` is a
+     * non-integer NTSC rate (23.976 is `{ num: 1001, den: 24000 }`). Absent for
+     * integer fps. `fps` stays the nominal number.
+     */
+    timeBase?: {
+        num: number;
+        den: number;
+    };
     duration: number;
     background: string;
     clips: IRClip[];
@@ -19,17 +50,121 @@ export interface IRTimeline {
     effects: IREffect[];
     audio: IRAudioTrack[];
     output: IROutput;
+    /** Closed items rendered offscreen and drawn as one clip (plan-v1/39 §6). */
+    groups?: IRGroup[];
+    /** Named instants (`marker(...)`). Timeline data only — never affects rendering. */
+    markers?: IRMarker[];
+    /** Resolved extents of `use <timeline>` statements — additive metadata for editor tooling, never affects rendering. */
     timelineUses?: IRTimelineUse[];
 }
+/**
+ * A named time on the timeline (`marker("act 2")`). Markers carry editorial
+ * meaning (chapters, act breaks, sync points) and are exported as OTIO markers;
+ * no renderer reads them.
+ */
+export interface IRMarker {
+    id: string;
+    name: string;
+    /** Seconds from the timeline start. */
+    time: number;
+    duration: number;
+    metadata?: Record<string, unknown>;
+    /** Source `[ ... ]` offset span of the originating block (timeline editing). */
+    sourceTimespec?: IRSourceTimespec;
+}
+/**
+ * A set of items rendered into an offscreen picture, then drawn into its
+ * parent as one textured quad (plan-v1/39 §6). Children are in group-local
+ * time: 0 is `start`. Audio never lives in a group; it shifts into `ir.audio`
+ * at the placement offset.
+ */
+export interface IRGroup {
+    id: string;
+    start: number;
+    end: number;
+    clips: IRClip[];
+    layers: IRLayer[];
+    surfaces: IRSurface[];
+    groups?: IRGroup[];
+    /** Graded on the group's picture only, before it is drawn into the parent. */
+    effects?: IREffect[];
+    /** Picture size of the offscreen target, in output pixels. */
+    width: number;
+    height: number;
+    /**
+     * Size the picture is drawn at in the parent when it differs from the target
+     * (`width:` / `height:` on a placed value scale the picture; children stay
+     * laid out in `width` × `height`).
+     */
+    displayWidth?: number;
+    displayHeight?: number;
+    /** Placement of the picture in the parent, same meaning as IRClip. */
+    x: number;
+    y: number;
+    opacity: number;
+    /** Blend mode over the parent's picture below (`Composite` modes). */
+    blend?: string;
+    /** Rounded-corner radius in output pixels. */
+    radius?: number;
+    /** Four corner points in the parent's output pixels, TL → TR → BR → BL. */
+    corners?: [number, number][];
+    /** Part of the target to show, in target pixels (`Crop`). */
+    crop?: IRCrop;
+    /**
+     * The matte, rendered into a target of its own and sampled over the picture
+     * (`Mask`). `group` is in this group's local time and target pixels; its own
+     * placement fields are unused.
+     */
+    mask?: {
+        group: IRGroup;
+        mode: IRMaskMode;
+    };
+    motion?: IRMotionTrack[];
+    animations?: IRAnimation[];
+    /** Blur the group's own motion by accumulating sub-frames (`motion_blur:`). */
+    motionBlur?: IRMotionBlur;
+    /** Source `[ ... ]` offset span of the originating block (timeline editing). */
+    sourceTimespec?: IRSourceTimespec;
+}
+/**
+ * Sub-frame accumulation for an item's own motion. `shutter` is the exposure
+ * as an angle (360 = the whole frame interval), `samples` the sub-frames
+ * averaged; each sample is another render of the frame.
+ */
+export interface IRMotionBlur {
+    shutter: number;
+    samples: number;
+}
 export interface IRTimelineUse {
+    /** Timeline name as referenced at the use site. */
     name: string;
+    /** Character offset of the use statement's `at` time spec in source. */
     sourceOffset: number;
     start: number;
     end: number;
 }
+/**
+ * A clip whose `source` is a numbered-file pattern (`shot.%04d.png`) rather than
+ * one media file. Source time maps to a frame file through `clip-time.ts`.
+ */
+export interface IRImageSequence {
+    /** Number in the first frame's file name. */
+    first: number;
+    /** How many numbered frames exist, from `first`. */
+    count: number;
+    /** Frames per second of the sequence. Omitted: the output fps. */
+    rate?: number;
+}
 export interface IRClip {
     id: string;
     source: string;
+    /** Present when `source` is a frame-file pattern (`input frames = "shot.%04d.png"`). */
+    sequence?: IRImageSequence;
+    /**
+     * Frame rate the video source is interpreted at (`input a = "x.mp4", rate: 23.976`).
+     * Source time is conformed to that frame grid before sampling. Omitted: the file's own rate, unconformed.
+     */
+    sourceRate?: number;
     start: number;
     end: number;
     trimStart: number;
@@ -41,11 +176,38 @@ export interface IRClip {
     height: number;
     x: number;
     y: number;
+    /** Rounded-corner radius in output pixels (`video …, radius:`). */
+    radius?: number;
+    /** Four corner points in output pixels, TL → TR → BR → BL (`video …, corners:`). */
+    corners?: [number, number][];
+    /** Part of the source to show, in source pixels (`Crop`); `width` × `height` stay the drawn size. */
+    crop?: IRCrop;
+    /** Per-clip grade (`filter …, target: a` and `input_colorspace`/`output_colorspace`). */
+    effects?: IREffect[];
+    /** Color-space conversion applied to this clip only. */
+    colorspace?: {
+        input?: string;
+        output?: string;
+    };
     animations?: IRAnimation[];
     motion?: IRMotionTrack[];
+    /** Blur the clip's own motion by accumulating sub-frames (`motion_blur:`). */
+    motionBlur?: IRMotionBlur;
+    /** Source `[ ... ]` offset span of the originating block (timeline editing). */
     sourceTimespec?: IRSourceTimespec;
+    /**
+     * The source file was missing at compile time (`output ..., allow_offline: true`).
+     * `source` is kept for relinking and OTIO export, but nothing may fetch, decode, or
+     * draw it: the compiler emits a `solid` surface and a text label over the same span
+     * as the slate. Every media path skips an offline clip (`isOfflineClip`).
+     */
+    offline?: boolean;
 }
 export type IRLayer = IRTextLayer | IRVideoOverlayLayer | IRCompositeLayer;
+/**
+ * Future unified surface abstraction.
+ * For now this is aspirational — existing layers will gradually migrate toward it.
+ */
 export interface IRSurface {
     id: string;
     type: 'text' | 'video' | 'image' | 'mesh' | 'lottie' | string;
@@ -65,9 +227,13 @@ export interface IRTextLayer {
     start: number;
     end: number;
     style: IRTextStyle;
+    /** Structured animations (preferred over the legacy `style.animation` string) */
     animations?: IRAnimation[];
+    /** Property/keyframe motion tracks shared by preview and render engines */
     motion?: IRMotionTrack[];
+    /** Phase 3: Effects attached to this text surface */
     effects?: IREffect[];
+    /** Source `[ ... ]` offset span of the originating block (timeline editing). */
     sourceTimespec?: IRSourceTimespec;
 }
 export interface IRTextStyle {
@@ -78,6 +244,7 @@ export interface IRTextStyle {
     stroke: string;
     strokeWidth: number;
     position: string;
+    /** @deprecated Use `animations` instead. Kept for backward compatibility. */
     animation?: string;
     bold: boolean;
     italic: boolean;
@@ -92,6 +259,8 @@ export interface IRTextStyle {
     shadowBlur: number;
     shadowOffsetX: number;
     shadowOffsetY: number;
+    /** Per-token reveal: `text …, stagger: "word" | "char"`. */
+    stagger?: 'word' | 'char';
     fit?: 'none' | 'wrap' | 'shrink' | 'wrap-shrink';
     overflow?: 'contain' | 'crop' | 'allow';
     safeArea?: number | string;
@@ -100,9 +269,15 @@ export interface IRTextStyle {
     maxLines?: number;
     anchor?: 'left' | 'center' | 'right' | 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
 }
+/**
+ * Animation descriptor. Produced by animation plugins (e.g. basic-animations).
+ * The renderer (preview + final) is responsible for interpreting these.
+ */
 export interface IRAnimation {
     id: string;
+    /** Animation type, e.g. "fade", "slideY", "scale", "kenBurns", or plugin-specific */
     type: string;
+    /** Which plugin produced this animation (for debugging + future versioning) */
     plugin?: string;
     from: Record<string, unknown>;
     to: Record<string, unknown>;
@@ -140,7 +315,9 @@ export interface IRVideoOverlayLayer {
     x: number;
     y: number;
     opacity: number;
+    /** Phase 3: Effects attached to this video overlay surface */
     effects?: IREffect[];
+    /** Source `[ ... ]` offset span of the originating block (timeline editing). */
     sourceTimespec?: IRSourceTimespec;
 }
 export interface IRCompositeLayer {
@@ -154,6 +331,7 @@ export interface IRCompositeLayer {
     y: number;
     opacity: number;
     mode: string;
+    /** Source `[ ... ]` offset span of the originating block (timeline editing). */
     sourceTimespec?: IRSourceTimespec;
 }
 export type IREffect = IRBuiltinEffect | IRShaderEffect;
@@ -164,6 +342,7 @@ export interface IRBuiltinEffect {
     start: number;
     end: number;
     params: Record<string, number | string>;
+    /** Phase 3: animations targeting specific param keys (e.g. grayscale intensity) */
     animations?: IRAnimation[];
     motion?: IRMotionTrack[];
 }
@@ -174,6 +353,7 @@ export interface IRShaderEffect {
     start: number;
     end: number;
     params: Record<string, number | string>;
+    /** Phase 3: animations targeting specific param keys */
     animations?: IRAnimation[];
     motion?: IRMotionTrack[];
 }
@@ -185,10 +365,23 @@ export interface IRAudioTrack {
     volume: number;
     fadeIn: number;
     fadeOut: number;
+    /** Source in-point in seconds (`audio …, trim_start:`). Playback starts this far into the file. */
+    sourceOffset?: number;
+    /** Stereo placement in [-1, 1] (`audio …, pan:`). Constant-power panning. */
+    pan?: number;
+    /**
+     * Source path of a track that ducks this one (`audio …, duck_under:`).
+     * While that track plays, this bed is pulled down by the shared gain curve.
+     */
+    duckUnder?: string;
+    /** Gain automation (`audio …, animate: { type: "volume", … }`). */
+    motion?: IRMotionTrack[];
+    animations?: IRAnimation[];
     loudnessNormalization?: 'ebu-r128';
     targetLufs?: number;
     truePeakDb?: number;
     loudnessRangeLufs?: number;
+    /** Source `[ ... ]` offset span of the originating block (timeline editing). */
     sourceTimespec?: IRSourceTimespec;
 }
 export interface IROutput {
@@ -198,6 +391,14 @@ export interface IROutput {
     bitrate: string;
     resolution: string;
     fps: number;
+    /** `output ..., alpha: true`: encode the alpha channel (`mov` ProRes 4444 or `webm` VP9). */
+    alpha?: boolean;
+    /** `output ..., start_timecode: "HH:MM:SS:FF"`: timecode of the first frame (non-drop-frame). */
+    startTimecode?: string;
+    /** `output ..., burn_in: "timecode"`: draw the running timecode onto the picture. */
+    burnIn?: 'timecode';
+    /** `output ..., allow_offline: true`: an input whose file is missing at compile time becomes an offline slate instead of an error. */
+    allowOffline?: boolean;
 }
 export declare function defaultIROutput(): IROutput;
 export declare function defaultIRTimeline(): IRTimeline;

package/dist/ir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"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"}

package/dist/ir.js

@@ -1,6 +1,8 @@
 /**
- * IRTimeline contract — mirrors src/types/ir.ts so the SDK can ship standalone.
- * Keep fields in sync with the platform IR; Pass 2 consumes this shape.
+ * IRTimeline contract — a copy of the platform's `src/types/ir.ts` so the SDK
+ * ships standalone. Keep the two in sync: Pass 2 (preview and render) consumes
+ * this shape, and `src/lib/sdk-runtime/ir-parity.unit.test.ts` fails when they
+ * drift.
  */
 export function defaultIROutput() {
     return {

package/dist/media.d.ts

@@ -1,15 +1,59 @@
-import type { AudioOptions, AudioTrack, FilterEffect, ShaderEffect, TextLayer, TextOptions, VideoClip, VideoOptions } from './types.js';
-/** Create a video clip from a path/URL. Pass `duration` when the asset is not probed yet. */
+import { type TimeInput } from './duration.js';
+import type { IRCrop } from './ir.js';
+import { type AudioOptions, type AudioTrack, type ClipEdits, type FilterEffect, type GapNode, type ImageClip, type ImageOptions, type ImageSequenceOptions, type MarkerNode, type MaskOptions, type MaskSpec, type PictureNode, type ShaderEffect, type SolidNode, type SolidOptions, type TextLayer, type TextOptions, type VideoClip, type VideoOptions } from './types.js';
+/** Length of a still or text appended with `push` and no explicit duration. */
+export declare const DEFAULT_STILL_LENGTH = 3;
+/**
+ * A trim on a trimmed value is relative to what the first kept:
+ * `clip.trim(10, 20).trim(2, 4)` plays source 12–14 s. Past the kept range is an error.
+ */
+export declare function composeTrim(previous: {
+    trimStart?: number;
+    trimEnd?: number;
+}, start: TimeInput | undefined, end: TimeInput | undefined): {
+    trimStart: number;
+    trimEnd: number;
+};
+/** A crop on a cropped value is relative to the first, like `trim`. */
+export declare function composeCrop(previous: IRCrop | undefined, x: number, y: number, width: number, height: number): IRCrop;
+export declare function makeMask(matte: PictureNode, options?: MaskOptions): MaskSpec;
+/** A grade scoped to one value. LUTs read a file at compile time, so they stay a VidScript statement. */
+export declare function makeClipEffect(name: string, params?: Record<string, number | string>): {
+    type: "builtin";
+    id: string;
+    name: string;
+    start: number;
+    end: number;
+    params: {
+        [x: string]: string | number;
+    };
+};
+/** How long a clip plays: the source range at `|speed|`, `loop` times; 0 when unknown. */
+export declare function playedLength(edits: ClipEdits, mediaDuration: number | undefined): number;
+/** A video clip from a path/URL. Pass `duration` when the asset is not probed yet. */
 export declare function video(source: string, options?: VideoOptions): VideoClip;
 /** Probe a video duration when omitted, then create a video clip. */
 export declare function loadVideo(source: string, options?: VideoOptions): Promise<VideoClip>;
-/** Create a text layer. */
+/** A still image. It fills its placement window (`image ≤ video`). */
+export declare function image(source: string, options?: ImageOptions): ImageClip;
+/**
+ * A numbered-frame source (`input frames = "shot.%04d.png", count: 24, rate: 12`).
+ * Plays `count / rate` seconds; `rate` defaults to the timeline fps.
+ */
+export declare function imageSequence(pattern: string, options: ImageSequenceOptions): VideoClip;
+/** A text layer. */
 export declare function text(content: string, options?: TextOptions): TextLayer;
-/** Create an audio track. */
+/** An audio track. */
 export declare function audio(source: string, options?: AudioOptions): AudioTrack;
 /** Probe an audio duration when omitted, then create an audio track. */
 export declare function loadAudio(source: string, options?: AudioOptions): Promise<AudioTrack>;
-/** Builtin post-processing filter (e.g. glow, blur). */
+/** A flat-colour rectangle — full frame unless sized. With `radius`/`corners` it is a shape matte. */
+export declare function solid(color: string, options?: SolidOptions): SolidNode;
+/** A transparent gap: `t.push(gap(), 2)` advances the playhead by 2 s. */
+export declare function gap(): GapNode;
+/** A named instant (`t[4][4] = marker('act 2')`). Exported as an OTIO marker; never rendered. */
+export declare function marker(name: string, metadata?: Record<string, unknown>): MarkerNode;
+/** Builtin post-processing filter over the frame (e.g. glow, blur). */
 export declare function filter(name: string, params?: Record<string, number | string>): FilterEffect;
 /** Custom GLSL shader effect. */
 export declare function shader(shaderSource: string, params?: Record<string, number | string>): ShaderEffect;

package/dist/media.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,WAAW,EACX,SAAS,EACT,YAAY,EACb,MAAM,YAAY,CAAC;AAcpB,6FAA6F;AAC7F,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,SAAS,CAuB3E;AAED,qEAAqE;AACrE,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,CAI9F;AAED,2BAA2B;AAC3B,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,SAAS,CAoB1E;AAED,6BAA6B;AAC7B,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,UAAU,CAa5E;AAED,wEAAwE;AACxE,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAI/F;AAED,wDAAwD;AACxD,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAM,GAC3C,YAAY,CAOd;AAED,iCAAiC;AACjC,wBAAgB,MAAM,CACpB,YAAY,EAAE,MAAM,EACpB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAM,GAC3C,YAAY,CAOd"}
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"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"}