@scenerok/sdk 0.9.0 → 0.11.0

package/README.md

@@ -55,7 +55,7 @@ JavaScript has no `t[0, end]` dual key (comma operator). Use:
 | `t.range(start, end, value)` | Explicit call |
 | `t['-'] = value` / `t.push(value)` | Auto-append at playhead |
 
-`start` / `end` accept numbers (seconds), `s(3)` / `ms(300)`, or strings (`'3s'`, `'1:30'`). Full JS arithmetic works: `clip.duration + 0.5`.
+`start` / `end` accept numbers (seconds), `s(3)` / `ms(300)`, `t.frames(48)`, or strings (`'3s'`, `'1:30'`, `'48f'`, `'01:00:00:00'`). Full JS arithmetic works: `clip.duration + 0.5`. Windows snap to the timeline's frame grid, as VidScript blocks do; NTSC rates (`fps: 23.976`) are exact.
 
 No `video` / `text` keywords after `=` — the RHS type is inferred from factories.
 
@@ -65,6 +65,7 @@ No `video` / `text` keywords after `=` — the RHS type is inferred from factori
 |-----|----------|
 | Short promos, human edits, templates | VidScript (`.vid`) |
 | Loops, branches, computed timing, agents | TypeScript + `@scenerok/sdk` |
+| An edit with one data-driven part | VidScript importing a `.ts` module (below) |
 
 ## AI plugins
 
@@ -116,6 +117,67 @@ t[5.6][10] = video('./b.mp4', { duration: 4.4 })
 
 Same 29 shaders as VidScript. `toIR()` binds neighboring clips automatically.
 
+## Values, methods, and placement
+
+The SDK speaks the current VidScript language and lowers to the same IR:
+
+```ts
+import { timeline, video, image, text, audio, solid, gap, marker, fadeIn, volumeRamp } from '@scenerok/sdk'
+
+const t = timeline({ width: 1920, height: 1080, fps: 30 })
+const beach = video('./beach.mp4', { duration: 60 })
+const vo = audio('./vo.mp3', { duration: 9 })
+
+t[0][6] = beach.trim(10, 20).speed(1.5).crop(0, 0, 1280, 720)      // methods return copies
+t[0][6] = video('./flare.mp4', { blend: 'screen', opacity: 0.6 })   // blend over what is below
+t[1][4] = image('./logo.png', { width: 240, height: 240, x: 60, y: 60, radius: 120 })
+t[6][9] = beach.trim(30, 33).mask(solid('#fff', { width: 800, height: 800, x: 560, y: 140, radius: 400 }))
+t.push(gap(), 1)
+t[4][4] = marker('act 2')
+t[0][9] = vo
+t[0][9] = audio('./bed.mp3', { duration: 60, volume: 0.4, duckUnder: vo, animate: volumeRamp(0, 0.4, 2) })
+```
+
+Values: `video`, `imageSequence`, `image`, `text`, `audio`, `solid`, `gap`, `marker`, `filter`, `shader`. Methods: `trim`, `speed`, `loop`, `resize`, `opacity`, `filter`, `crop`, `mask`, `animate`, `with`. Placement options on every picture: `x`, `y`, `width`, `height`, `area`, `opacity`, `rotation`, `radius`, `corners`, `blend`, `motionBlur`, `enabled`, `animate`.
+
+A timeline is a value too. Placed bare its items join the parent; `place(opts)`, `opacity`, `resize`, `filter`, `crop`, or `mask` draw it as one group:
+
+```ts
+const card = timeline({ name: 'card' })
+card[0][3] = solid('#101820', { height: 200, y: 880 })
+card[0][3] = text('Konkan Day 1', { y: '88%' }).animate(fadeIn(0.3))
+
+t[2][5] = card                                  // flat
+t[6][9] = card.opacity(0.8).place({ x: 40 })    // one group
+```
+
+## Use TypeScript from VidScript
+
+A `.vid` can import a module and place its exports as VidScript values:
+
+```ts
+// kit.ts
+import { video, text, timeline, solid } from '@scenerok/sdk'
+export const hero = video('beach.mp4', { duration: 12 }).trim(2, 8)
+export const title = text('Konkan Day 1', { size: 72, area: 'title' })
+export function lowerThird(name: string, opts: { color?: string } = {}) {
+  const t = timeline()
+  t[0][3] = solid(opts.color ?? '#101820', { height: 160, y: 880 })
+  t[0][3] = text(name, { y: '88%' })
+  return t
+}
+```
+
+```
+import kit from "./kit.ts"
+[0s .. 6s] = kit.hero
+[1s .. 4s] = kit.title
+[3s .. 6s] = kit.lowerThird("Nidheesh", color: "#ff5500")
+output to "reel.mp4", resolution: "1920x1080"
+```
+
+A `timeline()` without a size takes the importing script's canvas. `describeValue(value)` is the bridge the host uses; you do not call it yourself.
+
 ## Validate / render
 
 ```bash

package/dist/describe.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Plain-data descriptors of SDK values, for hosts that place them as VidScript
+ * values (`import kit from "./kit.ts"` then `[0s .. 3s] = kit.title`).
+ *
+ * A descriptor is JSON — it crosses a VM boundary — and its params use
+ * VidScript's property names (`stroke_width`, `fade_in`, …), so the compiler
+ * places it exactly like the VidScript spelling of the same value.
+ */
+import type { IRCrop, IREffect, IRMaskMode, IRTimeline } from './ir.js';
+export type DescriptorParams = Record<string, unknown>;
+export interface MaskDescriptor {
+    matte: SdkValueDescriptor;
+    mode: IRMaskMode;
+}
+export type SdkValueDescriptor = {
+    kind: 'video' | 'image';
+    source: string;
+    /** Media length in seconds, when known. */
+    duration?: number;
+    /** Frame rate to interpret the footage at. */
+    rate?: number;
+    sequence?: {
+        first: number;
+        count: number;
+        rate?: number;
+    };
+    /** The clip's own sound comes along when placed. */
+    nativeAudio?: boolean;
+    edits: {
+        trimStart?: number;
+        trimEnd?: number;
+        speed?: number;
+        loop?: number;
+        opacity?: number;
+        width?: number;
+        height?: number;
+        effects?: IREffect[];
+        crop?: IRCrop;
+        mask?: MaskDescriptor;
+    };
+    props: DescriptorParams;
+} | {
+    kind: 'text';
+    content: string;
+    params: DescriptorParams;
+} | {
+    kind: 'audio';
+    source: string;
+    duration?: number;
+    trimEnd?: number;
+    params: DescriptorParams;
+} | {
+    kind: 'solid';
+    color: string;
+    props: DescriptorParams;
+} | {
+    kind: 'gap';
+} | {
+    kind: 'marker';
+    name: string;
+    metadata?: Record<string, unknown>;
+} | {
+    kind: 'timeline';
+    name: string;
+    /** Lowered on the host canvas, in timeline-local time (0 is the placement start). */
+    ir: IRTimeline;
+    props: DescriptorParams;
+    effects: IREffect[];
+    crop?: IRCrop;
+    mask?: MaskDescriptor;
+}
+/** Plain data: numbers (Durations as seconds), strings, booleans, arrays, objects. */
+ | {
+    kind: 'data';
+    value: unknown;
+}
+/** A value with no VidScript placement (filters, shaders, transitions as values). */
+ | {
+    kind: 'unsupported';
+    sdkKind: string;
+};
+/**
+ * Describe any SDK value — or plain data — as JSON a host can place. Timelines
+ * lower on the host canvas (`globalThis.__scenerokCanvas`).
+ */
+export declare function describeValue(value: unknown): SdkValueDescriptor;
+//# sourceMappingURL=describe.d.ts.map

package/dist/describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../src/describe.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAexE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IACA,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,oDAAoD;IACpD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,cAAc,CAAC;KACvB,CAAC;IACF,KAAK,EAAE,gBAAgB,CAAC;CACzB,GACC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAChG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACpE;IACA,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AACD,sFAAsF;GACpF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE;AAClC,qFAAqF;GACnF;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AA2K7C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAyBhE"}

package/dist/describe.js

@@ -0,0 +1,210 @@
+/**
+ * Plain-data descriptors of SDK values, for hosts that place them as VidScript
+ * values (`import kit from "./kit.ts"` then `[0s .. 3s] = kit.title`).
+ *
+ * A descriptor is JSON — it crosses a VM boundary — and its params use
+ * VidScript's property names (`stroke_width`, `fade_in`, …), so the compiler
+ * places it exactly like the VidScript spelling of the same value.
+ */
+import { Duration, toSeconds } from './duration.js';
+import { bindTransitions, hostCanvas, lowerTimeline, timelineRecordOf } from './ir-builder.js';
+import { isSdkNode } from './types.js';
+function defined(entries) {
+    const out = {};
+    for (const [key, value] of Object.entries(entries)) {
+        if (value !== undefined)
+            out[key] = value;
+    }
+    return out;
+}
+function animateParam(animate) {
+    if (!animate)
+        return undefined;
+    const list = Array.isArray(animate) ? animate : [animate];
+    if (list.length === 0)
+        return undefined;
+    return list.map(({ type, from, to, duration, align, easing, loop, plugin }) => defined({ type, from, to, duration, align, easing, loop, plugin }));
+}
+/** Placement options in VidScript's property names. */
+function placementParams(opts) {
+    return defined({
+        x: opts.x,
+        y: opts.y,
+        width: opts.width,
+        height: opts.height,
+        opacity: opts.opacity,
+        rotation: opts.rotation,
+        radius: opts.radius,
+        corners: opts.corners,
+        area: opts.area,
+        blend: opts.blend,
+        motion_blur: opts.motionBlur,
+        enabled: opts.enabled,
+        animate: animateParam(opts.animate),
+        input_colorspace: opts.inputColorspace,
+        output_colorspace: opts.outputColorspace,
+        volume: opts.volume,
+    });
+}
+function describeMask(mask) {
+    if (!mask)
+        return undefined;
+    return { matte: describeValue(mask.matte), mode: mask.mode };
+}
+function describeMedia(node) {
+    const { trimStart, trimEnd, speed, loop, opacity, width, height, effects, crop, mask } = node.edits;
+    const video = node.kind === 'video' ? node : null;
+    return {
+        kind: node.kind,
+        source: node.source,
+        ...(video?.mediaDuration !== undefined ? { duration: video.mediaDuration } : {}),
+        ...(video?.options.rate !== undefined && !video.sequence ? { rate: video.options.rate } : {}),
+        ...(video?.sequence ? { sequence: video.sequence } : {}),
+        ...(video?.options.nativeAudio ? { nativeAudio: true } : {}),
+        edits: defined({
+            trimStart, trimEnd, speed, loop, opacity, width, height,
+            effects: effects?.length ? effects : undefined,
+            crop,
+            mask: describeMask(mask),
+        }),
+        props: placementParams(node.options),
+    };
+}
+function describeText(node) {
+    const o = node.options;
+    return {
+        kind: 'text',
+        content: node.content,
+        params: defined({
+            font: o.font,
+            size: o.size,
+            min_size: o.minSize,
+            color: o.color,
+            stroke: o.stroke,
+            stroke_width: o.strokeWidth,
+            position: o.position,
+            bold: o.bold,
+            italic: o.italic,
+            x: o.x,
+            y: o.y,
+            rotation: o.rotation,
+            opacity: o.opacity,
+            align: o.align,
+            line_height: o.lineHeight,
+            letter_spacing: o.letterSpacing,
+            shadow_color: o.shadowColor,
+            shadow_blur: o.shadowBlur,
+            shadow_offset_x: o.shadowOffsetX,
+            shadow_offset_y: o.shadowOffsetY,
+            fit: o.fit,
+            overflow: o.overflow,
+            safe_area: o.safeArea,
+            max_width: o.maxWidth,
+            max_height: o.maxHeight,
+            max_lines: o.maxLines,
+            anchor: o.anchor,
+            area: o.area,
+            stagger: o.stagger,
+            blend: o.blend,
+            animate: animateParam(node.animations),
+        }),
+    };
+}
+function describeAudio(node) {
+    const o = node.options;
+    const ebu = o.loudness === 'ebu-r128' || o.loudnessNormalization === 'ebu-r128';
+    const duck = typeof o.duckUnder === 'string' ? o.duckUnder : o.duckUnder?.source;
+    return {
+        kind: 'audio',
+        source: node.source,
+        ...(node.mediaDuration !== undefined ? { duration: node.mediaDuration } : {}),
+        params: defined({
+            volume: o.volume,
+            fade_in: o.fadeIn !== undefined ? toSeconds(o.fadeIn) : undefined,
+            fade_out: o.fadeOut !== undefined ? toSeconds(o.fadeOut) : undefined,
+            trim_start: o.trimStart !== undefined && toSeconds(o.trimStart) > 0 ? toSeconds(o.trimStart) : undefined,
+            pan: o.pan,
+            duck_under: duck,
+            loudness: ebu ? 'ebu-r128' : undefined,
+            animate: animateParam(o.animate),
+        }),
+    };
+}
+function describeSolid(node) {
+    return { kind: 'solid', color: node.color, props: placementParams(node.options) };
+}
+function lowerForHost(timeline) {
+    const state = lowerTimeline(timelineRecordOf(timeline), hostCanvas());
+    bindTransitions(state.ir);
+    return JSON.parse(JSON.stringify(state.ir));
+}
+function describeTimeline(value) {
+    const view = 'placement' in value ? value : null;
+    const timeline = view ? view.timeline : value;
+    return {
+        kind: 'timeline',
+        name: timeline.options.name ?? 'timeline',
+        ir: lowerForHost(timeline),
+        props: view ? placementParams(view.placement) : {},
+        effects: view ? view.effects : [],
+        ...(view?.cropRect ? { crop: view.cropRect } : {}),
+        ...(view?.maskSpec ? { mask: describeMask(view.maskSpec) } : {}),
+    };
+}
+function plainData(value, seen) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : null;
+    if (Duration.isDuration(value))
+        return value.seconds;
+    if (typeof value !== 'object')
+        return undefined;
+    if (seen.has(value))
+        throw new TypeError('Cannot describe a value that refers to itself');
+    seen.add(value);
+    try {
+        if (Array.isArray(value))
+            return value.map((item) => plainData(item, seen));
+        const out = {};
+        for (const [key, item] of Object.entries(value)) {
+            const data = plainData(item, seen);
+            if (data !== undefined)
+                out[key] = data;
+        }
+        return out;
+    }
+    finally {
+        seen.delete(value);
+    }
+}
+/**
+ * Describe any SDK value — or plain data — as JSON a host can place. Timelines
+ * lower on the host canvas (`globalThis.__scenerokCanvas`).
+ */
+export function describeValue(value) {
+    if (isSdkNode(value)) {
+        switch (value.kind) {
+            case 'video':
+            case 'image':
+                return describeMedia(value);
+            case 'text':
+                return describeText(value);
+            case 'audio':
+                return describeAudio(value);
+            case 'solid':
+                return describeSolid(value);
+            case 'gap':
+                return { kind: 'gap' };
+            case 'marker': {
+                const marker = value;
+                return { kind: 'marker', name: marker.name, ...(marker.metadata ? { metadata: marker.metadata } : {}) };
+            }
+            case 'timeline':
+                return describeTimeline(value);
+            default:
+                return { kind: 'unsupported', sdkKind: value.kind };
+        }
+    }
+    return { kind: 'data', value: plainData(value, new Set()) ?? null };
+}

package/dist/duration.d.ts

@@ -17,13 +17,19 @@ export declare class Duration {
 export declare function s(seconds: number): Duration;
 /** Milliseconds helper: `ms(300)` → 0.3s. */
 export declare function ms(milliseconds: number): Duration;
-/** Frame count at a given fps (default 30). */
+/**
+ * A frame count at `fps` (exact for NTSC: `frames(24, 23.976)` is `24 * 1001 / 24000`).
+ * To count frames of the timeline's own rate, use `t.frames(n)` or the string `'48f'`.
+ */
 export declare function frames(count: number, fps?: number): Duration;
 /**
  * Parse a time value to seconds.
- * Accepts numbers (already seconds), Duration, or strings like `3s`, `300ms`, `1:30`, `0:01:30`.
+ * Accepts numbers (already seconds), Duration, or strings like `3s`, `300ms`,
+ * `1:30`, `0:01:30`, frame counts `48f`, and timecodes `01:00:00:00@24`.
+ * Frame counts and timecodes without `@rate` count frames of `fps` — a
+ * timeline passes its own — and throw without one.
  */
-export declare function toSeconds(value: TimeInput): number;
+export declare function toSeconds(value: TimeInput, fps?: number): number;
 export declare function isAutoPlayheadKey(key: PropertyKey): boolean;
 export {};
 //# sourceMappingURL=duration.d.ts.map

package/dist/duration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../src/duration.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,QAAA,MAAM,cAAc,eAAkC,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnD,qBAAa,QAAQ;IACnB,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAG,IAAI,CAAU;IAC1C,yBAAyB;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM;IAO3B,OAAO,IAAI,MAAM;IAIjB,QAAQ,IAAI,MAAM;IAIlB,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ;IAI/B,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ;IAI/B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAI7B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ;CAOrD;AAED,mCAAmC;AACnC,wBAAgB,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAE3C;AAED,6CAA6C;AAC7C,wBAAgB,EAAE,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,CAEjD;AAED,+CAA+C;AAC/C,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,QAAQ,CAGxD;AAKD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CA4BlD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAE3D"}
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../src/duration.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAIrE,QAAA,MAAM,cAAc,eAAkC,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnD,qBAAa,QAAQ;IACnB,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAG,IAAI,CAAU;IAC1C,yBAAyB;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM;IAO3B,OAAO,IAAI,MAAM;IAIjB,QAAQ,IAAI,MAAM;IAIlB,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ;IAI/B,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ;IAI/B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAI7B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ;CAOrD;AAED,mCAAmC;AACnC,wBAAgB,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAE3C;AAED,6CAA6C;AAC7C,wBAAgB,EAAE,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,CAEjD;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,QAAQ,CAGxD;AAOD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAoChE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAE3D"}

package/dist/duration.js

@@ -1,4 +1,5 @@
 /** Duration helpers — seconds as the canonical unit (matches IR). */
+import { exactFpsOf, isTimecodeString, timecodeToSeconds } from './frame-rate.js';
 const DURATION_BRAND = Symbol.for('scenerok.Duration');
 export class Duration {
     [DURATION_BRAND] = true;
@@ -39,18 +40,25 @@ export function s(seconds) {
 export function ms(milliseconds) {
     return new Duration(milliseconds / 1000);
 }
-/** Frame count at a given fps (default 30). */
+/**
+ * A frame count at `fps` (exact for NTSC: `frames(24, 23.976)` is `24 * 1001 / 24000`).
+ * To count frames of the timeline's own rate, use `t.frames(n)` or the string `'48f'`.
+ */
 export function frames(count, fps = 30) {
     if (fps <= 0)
         throw new TypeError('fps must be positive');
-    return new Duration(count / fps);
+    return new Duration(count / exactFpsOf(fps));
 }
+const FRAME_STRING_RE = /^(\d+)\s*(?:f|frame|frames)$/i;
 const TIME_STRING_RE = /^(?:(?<h>\d+):(?<m>\d{2}):(?<s>\d{2}(?:\.\d+)?))$|^(?:(?<mm>\d+):(?<ss>\d{2}(?:\.\d+)?))$|^(?<num>\d+(?:\.\d+)?)\s*(?<unit>s|sec|secs|seconds|ms|milliseconds)?$/i;
 /**
  * Parse a time value to seconds.
- * Accepts numbers (already seconds), Duration, or strings like `3s`, `300ms`, `1:30`, `0:01:30`.
+ * Accepts numbers (already seconds), Duration, or strings like `3s`, `300ms`,
+ * `1:30`, `0:01:30`, frame counts `48f`, and timecodes `01:00:00:00@24`.
+ * Frame counts and timecodes without `@rate` count frames of `fps` — a
+ * timeline passes its own — and throw without one.
  */
-export function toSeconds(value) {
+export function toSeconds(value, fps) {
     if (typeof value === 'number') {
         if (!Number.isFinite(value))
             throw new TypeError(`Invalid time number: ${value}`);
@@ -63,6 +71,15 @@ export function toSeconds(value) {
         if (trimmed === '-' || trimmed === '') {
             throw new TypeError(`Cannot convert auto-playhead marker '${value}' via toSeconds; use timeline.push / t['-']`);
         }
+        if (isTimecodeString(trimmed))
+            return timecodeToSeconds(trimmed, fps);
+        const frameMatch = FRAME_STRING_RE.exec(trimmed);
+        if (frameMatch) {
+            if (fps === undefined) {
+                throw new TypeError(`Frame time '${value}' needs a frame rate; schedule it on a timeline or use frames(n, fps)`);
+            }
+            return Number(frameMatch[1]) / exactFpsOf(fps);
+        }
         const match = TIME_STRING_RE.exec(trimmed);
         if (!match || !match.groups) {
             throw new TypeError(`Unrecognized time string: ${JSON.stringify(value)}`);
@@ -83,5 +100,5 @@ export function toSeconds(value) {
     throw new TypeError(`Unsupported time input: ${String(value)}`);
 }
 export function isAutoPlayheadKey(key) {
-    return key === '-' || key === '-';
+    return key === '-';
 }

package/dist/frame-rate.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Rational frame rates — the SDK's copy of the platform's `src/lib/time/frame-rate.ts`.
+ *
+ * IR times stay float seconds. A frame is `num / den` seconds, so 23.976 is
+ * `1001 / 24000` rather than a rounded float, exactly as VidScript computes it.
+ */
+/** Frame duration in seconds: `num / den`. */
+export interface TimeBase {
+    num: number;
+    den: number;
+}
+/** Frame digits a timecode counts per second: 23.976 counts 24. */
+export declare function nominalFps(fps: number): number;
+/** `{ 1001, nominal * 1000 }` for NTSC rates (23.976, 29.97, …), `{ 1, fps }` otherwise. */
+export declare function frameRateOf(fps: number): TimeBase;
+/** True for the NTSC family (a time base that is not `1 / integer`). */
+export declare function isFractionalTimeBase(timeBase: TimeBase): boolean;
+/** The exact frames per second: `24000 / 1001` for 23.976. */
+export declare function exactFpsOf(fps: number): number;
+/** Round seconds to the nearest frame boundary (ties up). */
+export declare function snapToFrame(seconds: number, timeBase: TimeBase): number;
+/** True for an `HH:MM:SS:FF` (optionally `@rate`) string. */
+export declare function isTimecodeString(value: string): boolean;
+/**
+ * `HH:MM:SS:FF[@rate]` in seconds. Non-drop-frame only; FF must be below the
+ * nominal rate and hours run 0-23. Without `@rate`, `fps` is the rate; with
+ * neither the timecode has no meaning and this throws.
+ */
+export declare function timecodeToSeconds(value: string, fps?: number, label?: string): number;
+//# sourceMappingURL=frame-rate.d.ts.map

package/dist/frame-rate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-rate.d.ts","sourceRoot":"","sources":["../src/frame-rate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8CAA8C;AAC9C,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAKD,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAMjD;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEhE;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAIvE;AAID,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,MAAM,CAsBzF"}

package/dist/frame-rate.js

@@ -0,0 +1,73 @@
+/**
+ * Rational frame rates — the SDK's copy of the platform's `src/lib/time/frame-rate.ts`.
+ *
+ * IR times stay float seconds. A frame is `num / den` seconds, so 23.976 is
+ * `1001 / 24000` rather than a rounded float, exactly as VidScript computes it.
+ */
+const NTSC_TOLERANCE = 0.001;
+const NTSC_NOMINAL = [24, 30, 48, 60, 120];
+/** Frame digits a timecode counts per second: 23.976 counts 24. */
+export function nominalFps(fps) {
+    return Math.max(1, Math.round(fps));
+}
+/** `{ 1001, nominal * 1000 }` for NTSC rates (23.976, 29.97, …), `{ 1, fps }` otherwise. */
+export function frameRateOf(fps) {
+    for (const nominal of NTSC_NOMINAL) {
+        const ntsc = (nominal * 1000) / 1001;
+        if (Math.abs(fps - ntsc) <= NTSC_TOLERANCE)
+            return { num: 1001, den: nominal * 1000 };
+    }
+    return { num: 1, den: fps };
+}
+/** True for the NTSC family (a time base that is not `1 / integer`). */
+export function isFractionalTimeBase(timeBase) {
+    return timeBase.num !== 1;
+}
+/** The exact frames per second: `24000 / 1001` for 23.976. */
+export function exactFpsOf(fps) {
+    const base = frameRateOf(fps);
+    return base.den / base.num;
+}
+/** Round seconds to the nearest frame boundary (ties up). */
+export function snapToFrame(seconds, timeBase) {
+    if (!Number.isFinite(seconds))
+        return seconds;
+    const frames = Math.round((seconds * timeBase.den) / timeBase.num);
+    return (frames * timeBase.num) / timeBase.den;
+}
+const TIMECODE_RE = /^(\d{2}):(\d{2}):(\d{2})([:;])(\d{2})(?:@(\d+(?:\.\d+)?))?$/;
+/** True for an `HH:MM:SS:FF` (optionally `@rate`) string. */
+export function isTimecodeString(value) {
+    return TIMECODE_RE.test(value.trim());
+}
+/**
+ * `HH:MM:SS:FF[@rate]` in seconds. Non-drop-frame only; FF must be below the
+ * nominal rate and hours run 0-23. Without `@rate`, `fps` is the rate; with
+ * neither the timecode has no meaning and this throws.
+ */
+export function timecodeToSeconds(value, fps, label = 'timecode') {
+    const match = TIMECODE_RE.exec(value.trim());
+    if (!match) {
+        throw new TypeError(`${label} "${value}" is not HH:MM:SS:FF (two digits each, for example "01:00:00:00")`);
+    }
+    if (match[4] === ';') {
+        throw new TypeError(`${label} "${value}" is drop-frame; only non-drop-frame HH:MM:SS:FF is supported`);
+    }
+    const rate = match[6] !== undefined ? Number(match[6]) : fps;
+    if (rate === undefined || !Number.isFinite(rate) || rate <= 0) {
+        throw new TypeError(`${label} "${value}" needs a frame rate: write it as "${value}@24", or schedule it on a timeline`);
+    }
+    const [hours, minutes, seconds, frames] = [match[1], match[2], match[3], match[5]].map(Number);
+    if (hours > 23)
+        throw new RangeError(`${label} "${value}" has hours ${hours}; hours run 0-23`);
+    if (minutes > 59)
+        throw new RangeError(`${label} "${value}" has minutes ${minutes}; minutes run 0-59`);
+    if (seconds > 59)
+        throw new RangeError(`${label} "${value}" has seconds ${seconds}; seconds run 0-59`);
+    const nominal = nominalFps(rate);
+    if (frames >= nominal) {
+        throw new RangeError(`${label} "${value}" has frame ${frames}, but the rate is ${rate}; frames run 0-${nominal - 1}`);
+    }
+    const count = ((hours * 60 + minutes) * 60 + seconds) * nominal + frames;
+    return snapToFrame(count / exactFpsOf(rate), frameRateOf(rate));
+}

package/dist/index.d.ts

@@ -4,15 +4,18 @@
  * Agents use this for complex, data-driven scenes. Humans keep VidScript for
  * short declarative scripts. Both emit the same IRTimeline for Pass 2.
  */
-export type { IRTimeline, IRClip, IRLayer, IRTextLayer, IRSurface, IREffect, IRAudioTrack, IROutput, IRAnimation, IRMotionTrack, } from './ir.js';
+export type { IRTimeline, IRClip, IRLayer, IRTextLayer, IRTextStyle, IRSurface, IREffect, IRAudioTrack, IROutput, IRAnimation, IRMotionTrack, IRGroup, IRMarker, IRCrop, IRMaskMode, IRMotionBlur, IRImageSequence, } from './ir.js';
 export { defaultIRTimeline, defaultIROutput } from './ir.js';
 export { Duration, s, ms, frames, toSeconds, type TimeInput, } from './duration.js';
-export type { VideoClip, VideoOptions, TextLayer, TextOptions, AudioTrack, AudioOptions, FilterEffect, ShaderEffect, TransitionEffect, TransitionOptions, AnimationDescriptor, Schedulable, TimelineOptions, TimelineLike, SdkHost, } from './types.js';
-export { isSdkNode, isSchedulable } from './types.js';
-export { video, loadVideo, text, audio, loadAudio, filter, shader } from './media.js';
-export { fadeIn, fadeOut, slideY, slideX, scale, popIn } from './motion.js';
+export { frameRateOf, exactFpsOf, snapToFrame, timecodeToSeconds, type TimeBase } from './frame-rate.js';
+export type { VideoClip, VideoOptions, ImageClip, ImageOptions, ImageSequenceOptions, MediaMethods, ClipEdits, MaskOptions, PlacementOptions, BlendMode, MotionBlurOption, TextLayer, TextOptions, AudioTrack, AudioOptions, SolidNode, SolidOptions, GapNode, MarkerNode, FilterEffect, ShaderEffect, TransitionEffect, TransitionOptions, AnimationDescriptor, PictureNode, Schedulable, OutputOptions, TimelineOptions, TimelineLike, TimelineView, TimelinePlacementOptions, SdkHost, } from './types.js';
+export { isSdkNode, isSchedulable, isPictureNode } from './types.js';
+export { video, loadVideo, image, imageSequence, text, audio, loadAudio, solid, gap, marker, filter, shader, } from './media.js';
+export { animation, fadeIn, fadeOut, slideY, slideX, scale, popIn, riseIn, swingIn, glitchIn, float, typewriter, rotate, volumeRamp, type AnimationOptions, } from './motion.js';
 export { timeline, isTimeline, type Timeline } from './timeline.js';
-export { createIrBuilder, scheduleAt, resetIrBuilderIds, inferAutoDuration, assertSchedulable, bindTransitions, setGrid, type IrBuilderState, } from './ir-builder.js';
+export { createIrBuilder, scheduleAt, resetIrBuilderIds, inferAutoDuration, assertSchedulable, bindTransitions, setGrid, hostCanvas, type Canvas, type IrBuilderState, } from './ir-builder.js';
+export { animationToMotionTracks, animationsToMotionTracks } from './motion-tracks.js';
+export { describeValue, type SdkValueDescriptor, type MaskDescriptor } from './describe.js';
 export { defaultGridSpec, resolveGridAreas, placementFromGridArea, placeInArea, type GridSpec, type GridAreaRect, type GridAreaPlacement, } from './grid.js';
 export { getVideoLength, getAudioLength, getMediaInfo, getDimensions, getFps, getLoudness, hasAudio, mediaKind, grabFrame, grabFrames, grabFrameAtFraction, measureText, fitContain, fitCover, clampTime, parseTime, timecode, beats, type MediaSource, type MediaInfo, type Dimensions, type LoudnessInfo, type FitBox, type GrabFrameOptions, type MeasureTextStyle, type TextMetrics, type StdlibMediaKind, type StdlibHostApi, } from './stdlib.js';
 export { default as xai } from './plugins/xai.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -6,11 +6,14 @@
  */
 export { defaultIRTimeline, defaultIROutput } from './ir.js';
 export { Duration, s, ms, frames, toSeconds, } from './duration.js';
-export { isSdkNode, isSchedulable } from './types.js';
-export { video, loadVideo, text, audio, loadAudio, filter, shader } from './media.js';
-export { fadeIn, fadeOut, slideY, slideX, scale, popIn } from './motion.js';
+export { frameRateOf, exactFpsOf, snapToFrame, timecodeToSeconds } from './frame-rate.js';
+export { isSdkNode, isSchedulable, isPictureNode } from './types.js';
+export { video, loadVideo, image, imageSequence, text, audio, loadAudio, solid, gap, marker, filter, shader, } from './media.js';
+export { animation, fadeIn, fadeOut, slideY, slideX, scale, popIn, riseIn, swingIn, glitchIn, float, typewriter, rotate, volumeRamp, } from './motion.js';
 export { timeline, isTimeline } from './timeline.js';
-export { createIrBuilder, scheduleAt, resetIrBuilderIds, inferAutoDuration, assertSchedulable, bindTransitions, setGrid, } from './ir-builder.js';
+export { createIrBuilder, scheduleAt, resetIrBuilderIds, inferAutoDuration, assertSchedulable, bindTransitions, setGrid, hostCanvas, } from './ir-builder.js';
+export { animationToMotionTracks, animationsToMotionTracks } from './motion-tracks.js';
+export { describeValue } from './describe.js';
 export { defaultGridSpec, resolveGridAreas, placementFromGridArea, placeInArea, } from './grid.js';
 // Media stdlib — host-injected at compile time (`@scenerok/stdlib` alias)
 export { getVideoLength, getAudioLength, getMediaInfo, getDimensions, getFps, getLoudness, hasAudio, mediaKind, grabFrame, grabFrames, grabFrameAtFraction, measureText, fitContain, fitCover, clampTime, parseTime, timecode, beats, } from './stdlib.js';