@nodetool-ai/agents 0.8.1 → 0.8.2

package/dist/capabilities/storyboard-layout-check.d.ts

@@ -0,0 +1,33 @@
+import { type TimelineClip, type TimelineSequence } from "@nodetool-ai/timeline";
+/** A collision between copy and another layer, or between copy and the frame edge. */
+export interface LayoutDefect {
+    shotId: string;
+    timeMs: number;
+    clipIds: string[];
+    message: string;
+}
+export interface ShotWindow {
+    shotId: string;
+    start: number;
+    duration: number;
+}
+/**
+ * The settled moment of a shot: midway between the last entrance finishing and
+ * the first exit starting. That is the frame a viewer reads the shot at.
+ */
+export declare function shotHoldTimes(clips: readonly TimelineClip[], windows: readonly ShotWindow[], width: number, height: number): Map<string, number>;
+/**
+ * Render every visible layer of each shot alone at the shot's hold frame and
+ * compare the boxes of the pixels each one draws. Copy that crosses an image
+ * edge, crowds another layer or reaches the frame edge is a defect no
+ * reference frame can approve. Copy set wholly inside a plate or image is a
+ * deliberate overlay and passes.
+ */
+export declare function findLayoutDefects(options: {
+    sequence: TimelineSequence;
+    windows: readonly ShotWindow[];
+    holds: ReadonlyMap<string, number>;
+    loadAsset: (assetId: string) => Promise<Uint8Array | null>;
+    signal?: AbortSignal;
+}): Promise<LayoutDefect[]>;
+//# sourceMappingURL=storyboard-layout-check.d.ts.map

package/dist/capabilities/storyboard-layout-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyboard-layout-check.d.ts","sourceRoot":"","sources":["../../src/capabilities/storyboard-layout-check.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAG/B,sFAAsF;AACtF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AA4CD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA2BrB;AAqDD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA2I1B"}

package/dist/capabilities/storyboard-layout-check.js

@@ -0,0 +1,229 @@
+import { createCanvas, loadImage } from "@napi-rs/canvas";
+import { compileClipAnimations, makeClip, makeTrack } from "@nodetool-ai/timeline";
+import { renderTimelineFrames } from "../timeline-preview/frames.js";
+/** Copy keeps this clearance from other layers and the frame edge, as a fraction of frame height. */
+const CLEARANCE = 0.012;
+/** Summed RGBA difference that counts a pixel as drawn by the layer. */
+const CHANGE_THRESHOLD = 48;
+/** A layer covering this much of the frame is a backdrop, and copy sits on it by design. */
+const BACKDROP_COVERAGE = 0.9;
+const CHECK_WIDTH = 540;
+const BACKDROP_FILLS = ["#000000", "#FFFFFF"];
+const LAYOUT_MEDIA = new Set(["text", "image", "video", "shape"]);
+const intersects = (a, b) => a.left < b.right && b.left < a.right && a.top < b.bottom && b.top < a.bottom;
+const expand = (box, by) => ({
+    left: box.left - by,
+    top: box.top - by,
+    right: box.right + by,
+    bottom: box.bottom + by
+});
+const contains = (outer, inner) => inner.left >= outer.left &&
+    inner.top >= outer.top &&
+    inner.right <= outer.right &&
+    inner.bottom <= outer.bottom;
+/**
+ * The settled moment of a shot: midway between the last entrance finishing and
+ * the first exit starting. That is the frame a viewer reads the shot at.
+ */
+export function shotHoldTimes(clips, windows, width, height) {
+    const holds = new Map();
+    for (const window of windows) {
+        const end = window.start + window.duration;
+        let settled = window.start;
+        let exit = end;
+        for (const clip of clips) {
+            if (clip.mediaType === "audio" || clip.startMs < window.start || clip.startMs >= end) {
+                continue;
+            }
+            for (const animation of compileClipAnimations(clip.animations, clip.durationMs, { width, height })) {
+                if (animation.loop) {
+                    continue;
+                }
+                if (animation.role === "in") {
+                    settled = Math.max(settled, clip.startMs + animation.windowEndMs);
+                }
+                else if (animation.role === "out") {
+                    exit = Math.min(exit, clip.startMs + animation.windowStartMs);
+                }
+            }
+        }
+        holds.set(window.shotId, Math.round(settled < exit ? (settled + exit) / 2 : window.start + window.duration / 2));
+    }
+    return holds;
+}
+async function decodePixels(png) {
+    const image = await loadImage(Buffer.from(png));
+    const canvas = createCanvas(image.width, image.height);
+    const context = canvas.getContext("2d");
+    context.drawImage(image, 0, 0);
+    return {
+        data: context.getImageData(0, 0, image.width, image.height).data,
+        width: image.width,
+        height: image.height
+    };
+}
+const changed = (layer, empty, i) => Math.abs(layer.data[i] - empty.data[i]) +
+    Math.abs(layer.data[i + 1] - empty.data[i + 1]) +
+    Math.abs(layer.data[i + 2] - empty.data[i + 2]) +
+    Math.abs(layer.data[i + 3] - empty.data[i + 3]) >=
+    CHANGE_THRESHOLD;
+/**
+ * The box of every pixel a layer changed over either backdrop. One backdrop
+ * hides the layer's pixels that share its colour, so a dark product edge on
+ * black or white copy on white is caught by the other one.
+ */
+function changedBox(renders) {
+    const { width, height } = renders[0].layer;
+    let left = width;
+    let top = height;
+    let right = -1;
+    let bottom = -1;
+    let covered = 0;
+    for (let y = 0; y < height; y += 1) {
+        for (let x = 0; x < width; x += 1) {
+            const i = (y * width + x) * 4;
+            if (!renders.some(({ layer, empty }) => changed(layer, empty, i))) {
+                continue;
+            }
+            covered += 1;
+            left = Math.min(left, x);
+            right = Math.max(right, x + 1);
+            top = Math.min(top, y);
+            bottom = Math.max(bottom, y + 1);
+        }
+    }
+    return right < 0
+        ? null
+        : { box: { left, top, right, bottom }, coverage: covered / (width * height) };
+}
+/**
+ * Render every visible layer of each shot alone at the shot's hold frame and
+ * compare the boxes of the pixels each one draws. Copy that crosses an image
+ * edge, crowds another layer or reaches the frame edge is a defect no
+ * reference frame can approve. Copy set wholly inside a plate or image is a
+ * deliberate overlay and passes.
+ */
+export async function findLayoutDefects(options) {
+    const { sequence, windows, holds } = options;
+    const defects = [];
+    for (const window of windows) {
+        const timeMs = holds.get(window.shotId);
+        if (timeMs === undefined) {
+            continue;
+        }
+        // A layer is what it changes over a solid backdrop beneath every track.
+        const backdropTrack = makeTrack({
+            type: "overlay",
+            name: "Layout check backdrop",
+            index: Math.max(-1, ...sequence.tracks.map((track) => track.index)) + 1
+        });
+        const backdrops = BACKDROP_FILLS.map((fill) => {
+            const clip = makeClip({
+                trackId: backdropTrack.id,
+                name: "Layout check backdrop",
+                mediaType: "shape",
+                sourceType: "imported",
+                status: "generated",
+                startMs: 0,
+                durationMs: timeMs + 1,
+                shapeStyle: { kind: "rect", fill, x: 0, y: 0, width: 1, height: 1 }
+            });
+            return {
+                clipId: clip.id,
+                sequence: {
+                    ...sequence,
+                    tracks: [...sequence.tracks, backdropTrack],
+                    clips: [...sequence.clips, clip]
+                }
+            };
+        });
+        const render = async (backdrop, clipId) => {
+            options.signal?.throwIfAborted();
+            const frame = (await renderTimelineFrames({
+                sequence: backdrop.sequence,
+                timesMs: [timeMs],
+                width: CHECK_WIDTH,
+                onlyClipIds: clipId ? [backdrop.clipId, clipId] : [backdrop.clipId],
+                loadAsset: options.loadAsset
+            })).frames[0];
+            return frame ? decodePixels(frame.png) : null;
+        };
+        const empties = [];
+        for (const backdrop of backdrops) {
+            const pixels = await render(backdrop);
+            if (pixels) {
+                empties.push(pixels);
+            }
+        }
+        if (empties.length !== backdrops.length) {
+            continue;
+        }
+        const empty = empties[0];
+        const footprints = [];
+        for (const clip of sequence.clips) {
+            if (!LAYOUT_MEDIA.has(clip.mediaType) ||
+                clip.hidden ||
+                clip.startMs > timeMs ||
+                timeMs >= clip.startMs + clip.durationMs) {
+                continue;
+            }
+            const renders = [];
+            for (const [index, backdrop] of backdrops.entries()) {
+                const layer = await render(backdrop, clip.id);
+                if (layer) {
+                    renders.push({ layer, empty: empties[index] });
+                }
+            }
+            const measured = renders.length === backdrops.length ? changedBox(renders) : null;
+            if (measured && measured.coverage < BACKDROP_COVERAGE) {
+                footprints.push({ clip, box: measured.box });
+            }
+        }
+        // Report in sequence pixels, the unit set_clip_params takes.
+        const toSequence = (sequence.width || empty.width) / empty.width;
+        const px = (value) => Math.round(value * toSequence);
+        const clearance = Math.max(1, Math.round(CLEARANCE * empty.height));
+        const label = (clip) => clip.mediaType === "text"
+            ? `"${clip.textStyle?.text?.trim() ?? clip.name}" (${clip.name}, ${clip.id})`
+            : `${clip.name} (${clip.id})`;
+        const safeArea = expand({ left: 0, top: 0, right: empty.width, bottom: empty.height }, -clearance);
+        const texts = footprints.filter((layer) => layer.clip.mediaType === "text");
+        for (const text of texts) {
+            if (!contains(safeArea, text.box)) {
+                defects.push({
+                    shotId: window.shotId,
+                    timeMs,
+                    clipIds: [text.clip.id],
+                    message: `Copy ${label(text.clip)} reaches within ${px(clearance)}px of the frame edge at ${timeMs}ms. Keep all copy inside the safe area.`
+                });
+            }
+            for (const other of footprints) {
+                if (other === text) {
+                    continue;
+                }
+                const otherIsText = other.clip.mediaType === "text";
+                // Report each pair of copy layers once.
+                if (otherIsText && texts.indexOf(other) < texts.indexOf(text)) {
+                    continue;
+                }
+                if (!intersects(expand(text.box, clearance), other.box)) {
+                    continue;
+                }
+                if (!otherIsText && contains(expand(other.box, -clearance), text.box)) {
+                    continue;
+                }
+                const gap = Math.max(other.box.top - text.box.bottom, text.box.top - other.box.bottom, other.box.left - text.box.right, text.box.left - other.box.right, 0);
+                defects.push({
+                    shotId: window.shotId,
+                    timeMs,
+                    clipIds: [text.clip.id, other.clip.id],
+                    message: intersects(text.box, other.box)
+                        ? `Copy ${label(text.clip)} overlaps ${label(other.clip)} at ${timeMs}ms. Move or resize one so they keep at least ${px(clearance)}px apart.`
+                        : `Copy ${label(text.clip)} is ${px(gap)}px from ${label(other.clip)} at ${timeMs}ms. Keep at least ${px(clearance)}px apart.`
+                });
+            }
+        }
+    }
+    return defects;
+}
+//# sourceMappingURL=storyboard-layout-check.js.map

package/dist/capabilities/storyboard-layout-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyboard-layout-check.js","sourceRoot":"","sources":["../../src/capabilities/storyboard-layout-check.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/storyboard-measured-sources.d.ts

@@ -0,0 +1,10 @@
+import type { Shot } from "@nodetool-ai/protocol";
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+/** Use measured source length consistently for assembly, design preview and finishing. */
+export declare function measureStoryboardSources(shots: Shot[], context: ProcessingContext, signal?: AbortSignal): Promise<Shot[]>;
+/** Pixel size of every graphics image, so finishing can fit it between its copy. */
+export declare function measureStoryboardAssetSizes(shots: readonly Shot[], context: ProcessingContext, signal?: AbortSignal): Promise<Record<string, {
+    width: number;
+    height: number;
+}>>;
+//# sourceMappingURL=storyboard-measured-sources.d.ts.map

package/dist/capabilities/storyboard-measured-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyboard-measured-sources.d.ts","sourceRoot":"","sources":["../../src/capabilities/storyboard-measured-sources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,0FAA0F;AAC1F,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,GAAE,WAA4D,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAoB/K;AAED,oFAAoF;AACpF,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,GAAE,WAA4D,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CA2BtO"}

package/dist/capabilities/storyboard-measured-sources.js

@@ -0,0 +1,67 @@
+import { clampConcurrency, mapWithConcurrency } from "./concurrency.js";
+/** Use measured source length consistently for assembly, design preview and finishing. */
+export async function measureStoryboardSources(shots, context, signal = context.signal ?? new AbortController().signal) {
+    const { loadMediaRefBytes, probeVideoDurationSeconds } = await import("@nodetool-ai/runtime");
+    const { applyMeasuredShotClipDurations, resolveShotSource } = await import("@nodetool-ai/timeline");
+    signal.throwIfAborted();
+    const measurements = await mapWithConcurrency(shots, clampConcurrency(undefined), async (shot) => {
+        const clip = shot.clip;
+        const assetId = clip?.asset_id;
+        if (shot.status !== "rendered" || !assetId || resolveShotSource(shot)?.kind !== "video") {
+            return null;
+        }
+        try {
+            const bytes = await loadMediaRefBytes(clip, context);
+            const seconds = bytes?.length ? await probeVideoDurationSeconds(bytes, signal) : null;
+            return seconds === null ? null : [assetId, seconds];
+        }
+        catch (error) {
+            if (signal.aborted) {
+                throw error;
+            }
+            // Unmeasurable sources retain their stored duration, as canonical assembly does.
+            return null;
+        }
+    });
+    signal.throwIfAborted();
+    return applyMeasuredShotClipDurations(shots, new Map(measurements.flatMap((value) => value ? [value] : [])));
+}
+/** Pixel size of every graphics image, so finishing can fit it between its copy. */
+export async function measureStoryboardAssetSizes(shots, context, signal = context.signal ?? new AbortController().signal) {
+    const { loadMediaRefBytes } = await import("@nodetool-ai/runtime");
+    const { loadImage } = await import("@napi-rs/canvas");
+    const assetIds = new Set();
+    for (const shot of shots) {
+        for (const element of shot.graphics?.elements ?? []) {
+            if (element.kind === "asset" && element.asset_id) {
+                assetIds.add(element.asset_id);
+            }
+        }
+        for (const protection of shot.production?.protected_inputs ?? []) {
+            if (protection.asset_id) {
+                assetIds.add(protection.asset_id);
+            }
+        }
+    }
+    signal.throwIfAborted();
+    const sizes = await mapWithConcurrency([...assetIds], clampConcurrency(undefined), async (assetId) => {
+        try {
+            const bytes = await loadMediaRefBytes({ asset_id: assetId }, context);
+            if (!bytes?.length) {
+                return null;
+            }
+            const image = await loadImage(Buffer.from(bytes));
+            return image.width > 0 && image.height > 0 ? [assetId, { width: image.width, height: image.height }] : null;
+        }
+        catch (error) {
+            if (signal.aborted) {
+                throw error;
+            }
+            // An unreadable image keeps the default slot; validation reports a missing asset.
+            return null;
+        }
+    });
+    signal.throwIfAborted();
+    return Object.fromEntries(sizes.flatMap((value) => value ? [value] : []));
+}
+//# sourceMappingURL=storyboard-measured-sources.js.map

package/dist/capabilities/storyboard-measured-sources.js.map

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

package/dist/capabilities/storyboard-review-times.d.ts

@@ -0,0 +1,4 @@
+import { type TimelineClip } from "@nodetool-ai/timeline";
+/** Sample holds, cut boundaries and authored motion events in timeline time. */
+export declare function storyboardReviewTimes(clips: readonly TimelineClip[], width: number, height: number, fps: number): number[];
+//# sourceMappingURL=storyboard-review-times.d.ts.map

package/dist/capabilities/storyboard-review-times.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyboard-review-times.d.ts","sourceRoot":"","sources":["../../src/capabilities/storyboard-review-times.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE7F,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAiC1H"}

package/dist/capabilities/storyboard-review-times.js

@@ -0,0 +1,39 @@
+import { compileClipAnimations, sourceRate } from "@nodetool-ai/timeline";
+/** Sample holds, cut boundaries and authored motion events in timeline time. */
+export function storyboardReviewTimes(clips, width, height, fps) {
+    const times = new Set();
+    const frameMs = 1000 / fps;
+    for (const clip of clips) {
+        if (clip.mediaType === "audio" || clip.durationMs <= 0) {
+            continue;
+        }
+        const last = Math.max(0, clip.durationMs - frameMs);
+        const add = (local) => { times.add(Math.round(clip.startMs + Math.max(0, Math.min(last, local)))); };
+        add(0);
+        add(clip.durationMs / 2);
+        add(last);
+        if (clip.transitionIn) {
+            add(clip.transitionIn.durationMs / 2);
+            add(clip.transitionIn.durationMs);
+        }
+        for (const animation of compileClipAnimations(clip.animations, clip.durationMs, { width, height })) {
+            const start = animation.windowStartMs;
+            const end = animation.loop ? Math.min(animation.windowEndMs, start + (animation.periodMs ?? clip.durationMs)) : animation.windowEndMs;
+            add(start);
+            add((start + end) / 2);
+            add(end);
+            for (const curve of animation.curves) {
+                for (const keyframe of curve.keyframes) {
+                    add(animation.timeBase === "source" && keyframe.sourceMs !== undefined
+                        ? (keyframe.sourceMs - (clip.inPointMs ?? 0)) / sourceRate(clip)
+                        : start + keyframe.t * (end - start));
+                }
+            }
+        }
+    }
+    if (times.size > 128) {
+        throw new Error(`Visual review requires ${times.size} event frames, exceeding the 128-frame limit. Split the cut or simplify motion before requesting reviewed finishing.`);
+    }
+    return [...times].sort((left, right) => left - right);
+}
+//# sourceMappingURL=storyboard-review-times.js.map

package/dist/capabilities/storyboard-review-times.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyboard-review-times.js","sourceRoot":"","sources":["../../src/capabilities/storyboard-review-times.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/storyboards.d.ts

@@ -1,20 +1,4 @@
-/**
- * The `storyboards` capability module.
- *
- * Storyboard capabilities: list and create, render stills and clips, revise
- * one take, assemble a timeline, edit the shot list, extract a script, and
- * delete. The render path used to be seven `Tool` subclasses in
- * `../tools/storyboard-render-tools.ts`.
- *
- * Wire names, descriptions and schemas are unchanged. Prompt composition,
- * entity seasoning, and the shot → timeline mapping stay the editor's own
- * (`entitiesForShot` from `@nodetool-ai/protocol`, `buildStoryboardTimeline`
- * from `@nodetool-ai/timeline`), so a board rendered headlessly matches one
- * rendered in the UI. Every heavy dependency is imported inside the
- * implementation that needs it.
- *
- * Design: docs/tool-class-retirement-design.md § "Migration".
- */
+import { finishStoryboard, layoutStoryboard, previewStoryboardDesign } from "./finish-storyboard.js";
 import type { VideoRef } from "@nodetool-ai/protocol";
 import type { CapabilityExport, CapabilityModule } from "./types.js";
 /**
@@ -64,5 +48,5 @@ declare const extractScriptFromStoryboard: CapabilityExport;
 declare const deleteStoryboard: CapabilityExport;
 export declare const STORYBOARD_CAPABILITIES: readonly CapabilityExport[];
 export declare const module: CapabilityModule;
-export { listStoryboards, createStoryboard, getStoryboard, renderStoryboardStills, renderStoryboardClips, reviseStoryboardClip, assembleStoryboardTimeline, editStoryboard, directStoryboard, extractScriptFromStoryboard, deleteStoryboard };
+export { finishStoryboard, layoutStoryboard, previewStoryboardDesign, listStoryboards, createStoryboard, getStoryboard, renderStoryboardStills, renderStoryboardClips, reviseStoryboardClip, assembleStoryboardTimeline, editStoryboard, directStoryboard, extractScriptFromStoryboard, deleteStoryboard };
 //# sourceMappingURL=storyboards.d.ts.map

package/dist/capabilities/storyboards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storyboards.d.ts","sourceRoot":"","sources":["../../src/capabilities/storyboards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH,OAAO,KAAK,EASV,QAAQ,EACT,MAAM,uBAAuB,CAAC;AAS/B,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AA8VpB;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,QAAQ,CAYX;AAqBD,QAAA,MAAM,eAAe,EAAE,gBAuBtB,CAAC;AAmBF,QAAA,MAAM,gBAAgB,EAAE,gBAoDvB,CAAC;AAEF,QAAA,MAAM,aAAa,EAAE,gBA6CpB,CAAC;AA6GF,QAAA,MAAM,sBAAsB,EAAE,gBAgG7B,CAAC;AAEF,QAAA,MAAM,qBAAqB,EAAE,gBA4I5B,CAAC;AAEF,QAAA,MAAM,oBAAoB,EAAE,gBA6E3B,CAAC;AAMF,QAAA,MAAM,0BAA0B,EAAE,gBA+QjC,CAAC;AAcF,QAAA,MAAM,SAAS,YACb,UAAU,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,CACd,CAAC;AAEX,KAAK,WAAW,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AA6B9C,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,UAAW,MAAM,KAAG,WAAW,GAAG,IAIhE,CAAC;AA64BF,QAAA,MAAM,cAAc,EAAE,gBAmGrB,CAAC;AAQF;;;;;GAKG;AACH,QAAA,MAAM,gBAAgB,EAAE,gBAqKvB,CAAC;AAWF,QAAA,MAAM,2BAA2B,EAAE,gBA6JlC,CAAC;AAEF,6EAA6E;AAC7E;;;;;;;GAOG;AACH,QAAA,MAAM,gBAAgB,EAAE,gBAYvB,CAAC;AACF,eAAO,MAAM,uBAAuB,EAAE,SAAS,gBAAgB,EAY9D,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,cAAc,EACd,gBAAgB,EAChB,2BAA2B,EAC3B,gBAAgB,EACjB,CAAC"}
+{"version":3,"file":"storyboards.d.ts","sourceRoot":"","sources":["../../src/capabilities/storyboards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAgCrG,OAAO,KAAK,EASV,QAAQ,EACT,MAAM,uBAAuB,CAAC;AAoB/B,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AA+VpB;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,QAAQ,CAYX;AAqBD,QAAA,MAAM,eAAe,EAAE,gBAwBtB,CAAC;AAoBF,QAAA,MAAM,gBAAgB,EAAE,gBAoDvB,CAAC;AAEF,QAAA,MAAM,aAAa,EAAE,gBAiDpB,CAAC;AAoLF,QAAA,MAAM,sBAAsB,EAAE,gBA6G7B,CAAC;AAEF,QAAA,MAAM,qBAAqB,EAAE,gBAuI5B,CAAC;AAEF,QAAA,MAAM,oBAAoB,EAAE,gBA0F3B,CAAC;AAMF,QAAA,MAAM,0BAA0B,EAAE,gBAqPjC,CAAC;AAcF,QAAA,MAAM,SAAS,YACb,UAAU,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,CACd,CAAC;AAEX,KAAK,WAAW,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AA6B9C,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,UAAW,MAAM,KAAG,WAAW,GAAG,IAIhE,CAAC;AAygCF,QAAA,MAAM,cAAc,EAAE,gBA6GrB,CAAC;AAQF;;;;;GAKG;AACH,QAAA,MAAM,gBAAgB,EAAE,gBA4KvB,CAAC;AAWF,QAAA,MAAM,2BAA2B,EAAE,gBA6JlC,CAAC;AAEF,6EAA6E;AAC7E;;;;;;;GAOG;AACH,QAAA,MAAM,gBAAgB,EAAE,gBAYvB,CAAC;AACF,eAAO,MAAM,uBAAuB,EAAE,SAAS,gBAAgB,EAe9D,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,cAAc,EACd,gBAAgB,EAChB,2BAA2B,EAC3B,gBAAgB,EACjB,CAAC"}