@nodetool-ai/execution 0.8.1

package/dist/timeline-debug/motion.js

@@ -0,0 +1,362 @@
+import { ANIMATED_PROPERTY_FOLD, CUSTOM_ANIMATION_PRESET_ID, IDENTITY_SAMPLE, compileClipAnimations, getAnimationPreset, normalizeCustomCurves, resolveCustomMask } from "@nodetool-ai/timeline";
+import { clipStaggerCount } from "@nodetool-ai/timeline/scene";
+/** Sub-millisecond slack, so float window math is not reported as a clamp. */
+const EPSILON_MS = 0.5;
+const clipLabel = (clip) => `${clip.name || clip.id}`;
+/**
+ * The animations the compiler would actually compile.
+ *
+ * An unknown preset, a role the preset does not offer and unusable baked curves
+ * are all reported by their own codes (`unknown_animation_preset`,
+ * `custom_animation_invalid`), and compiling them would additionally print a
+ * console warning from inside the engine — noise on a CLI run that has already
+ * named the problem. Filtering here keeps one finding per defect.
+ */
+function compilableAnimations(clip) {
+    const out = [];
+    for (const animation of clip.animations ?? []) {
+        if (animation.enabled === false)
+            continue;
+        if (animation.preset === CUSTOM_ANIMATION_PRESET_ID) {
+            if (!animation.custom?.curves?.length &&
+                (animation.styleTracks?.length || animation.textAnimator)) {
+                out.push(animation);
+                continue;
+            }
+            const baked = normalizeCustomCurves(animation.custom?.curves, animation.custom?.timeBase);
+            if (!baked.ok)
+                continue;
+            if (!resolveCustomMask(baked.curves, animation.custom?.mask).ok)
+                continue;
+            out.push(animation);
+            continue;
+        }
+        const preset = getAnimationPreset(animation.preset);
+        if (!preset || !preset.roles.includes(animation.role))
+            continue;
+        out.push(animation);
+    }
+    return out;
+}
+function heldInterval(compiled, clipDurationMs) {
+    return {
+        fromMs: compiled.holdBefore ? 0 : compiled.windowStartMs,
+        toMs: compiled.holdAfter ? clipDurationMs : compiled.windowEndMs
+    };
+}
+/**
+ * Two animations driving one `replace` channel over the same instants (I3).
+ *
+ * `positionX/Y`, `anchorX/Y` and `trimStart/End` set an absolute value instead
+ * of composing, so the last enabled animation in document order wins and the
+ * other's curve is discarded — silently, and only where they overlap, which is
+ * why this is a warning rather than something a preview would reveal.
+ */
+function replaceOverlapIssues(clip, compiled) {
+    const byChannel = new Map();
+    for (const animation of compiled) {
+        const interval = heldInterval(animation, clip.durationMs);
+        const claimed = new Set();
+        for (const curve of animation.curves) {
+            if (ANIMATED_PROPERTY_FOLD[curve.property] !== "replace")
+                continue;
+            if (claimed.has(curve.property))
+                continue;
+            claimed.add(curve.property);
+            const list = byChannel.get(curve.property);
+            const entry = { id: animation.id, ...interval };
+            if (list)
+                list.push(entry);
+            else
+                byChannel.set(curve.property, [entry]);
+        }
+    }
+    const issues = [];
+    for (const [channel, entries] of byChannel) {
+        for (let i = 0; i < entries.length - 1; i += 1) {
+            for (let j = i + 1; j < entries.length; j += 1) {
+                const a = entries[i];
+                const b = entries[j];
+                const fromMs = Math.max(a.fromMs, b.fromMs);
+                const toMs = Math.min(a.toMs, b.toMs);
+                if (toMs - fromMs <= EPSILON_MS)
+                    continue;
+                issues.push({
+                    severity: "warning",
+                    code: "replace_curves_overlap",
+                    message: `Clip "${clipLabel(clip)}" animations "${a.id}" and "${b.id}" both drive ${channel} between ${Math.round(fromMs)}ms and ${Math.round(toMs)}ms — ${channel} replaces rather than composes, so the last enabled animation in document order wins and the other's curve is discarded over that span.`,
+                    path: "animations[*]",
+                    clipId: clip.id,
+                    trackId: clip.trackId
+                });
+            }
+        }
+    }
+    return issues;
+}
+/**
+ * Motion the clip cannot hold.
+ *
+ * The compiler clamps a window to the clip and drops one that starts at or
+ * after clip end, so an entrance authored longer than its clip plays truncated
+ * — or never — with nothing said. Both are warnings: the clip still renders,
+ * it just does not perform the motion that was written.
+ *
+ * A `fullClip` preset (`kenBurns`) ignores duration and delay by design and is
+ * skipped. A `"loop"` runs to clip end by construction, so only a delay past
+ * the clip's end can drop it, which the dropped branch covers.
+ */
+function windowIssues(clip, animations, compiled) {
+    const byId = new Map(compiled.map((entry) => [entry.id, entry]));
+    const issues = [];
+    const at = { clipId: clip.id, trackId: clip.trackId, path: "animations[*]" };
+    for (const animation of animations) {
+        if (getAnimationPreset(animation.preset)?.fullClip === true)
+            continue;
+        const delayMs = Math.max(0, animation.delayMs ?? 0);
+        const durationMs = Math.max(1, animation.durationMs);
+        const entry = byId.get(animation.id);
+        if (!entry) {
+            issues.push({
+                severity: "warning",
+                code: "animation_exceeds_clip",
+                message: `Clip "${clipLabel(clip)}" animation "${animation.id}" (${animation.preset}, ${animation.role}) asks for ${durationMs}ms after a ${delayMs}ms delay on a ${clip.durationMs}ms clip — the window falls outside the clip, so the animation never runs.`,
+                ...at
+            });
+            continue;
+        }
+        if (animation.role === "loop")
+            continue;
+        const requestedMs = durationMs + (entry.stagger?.maxDelayMs ?? 0);
+        const actualMs = entry.windowEndMs - entry.windowStartMs;
+        if (actualMs + EPSILON_MS >= requestedMs)
+            continue;
+        issues.push({
+            severity: "warning",
+            code: "animation_exceeds_clip",
+            message: `Clip "${clipLabel(clip)}" animation "${animation.id}" (${animation.preset}, ${animation.role}) needs ${Math.round(requestedMs)}ms after a ${delayMs}ms delay but the ${clip.durationMs}ms clip leaves ${Math.round(actualMs)}ms — the window is clamped, so the motion is cut short.`,
+            ...at
+        });
+    }
+    return issues;
+}
+/**
+ * A stagger whose span did not fit the clip.
+ *
+ * When the units cannot all animate at the authored `offsetMs` the compiler
+ * shrinks the offset rather than the per-unit duration, so every unit still
+ * completes and the effect reads faster and flatter than it was written —
+ * `compressed` on the compiled stagger is the compiler saying so (T8).
+ */
+function staggerIssues(clip, compiled) {
+    const issues = [];
+    for (const entry of compiled) {
+        const stagger = entry.stagger;
+        if (!stagger?.compressed)
+            continue;
+        issues.push({
+            severity: "warning",
+            code: "stagger_compressed",
+            message: `Clip "${clipLabel(clip)}" animation "${entry.id}" staggers ${stagger.count} ${stagger.unit}(s) over a ${clip.durationMs}ms clip — the per-unit offset was shrunk to ${Math.round(stagger.offsetMs)}ms to make them fit, so the units overlap more than authored. Lengthen the clip or shorten the animation.`,
+            path: "animations[*].stagger.offsetMs",
+            clipId: clip.id,
+            trackId: clip.trackId
+        });
+    }
+    return issues;
+}
+/**
+ * A typewriter stored with a plain duration.
+ *
+ * `animate_clip` stores the preset as `durationMs: 1` plus a per-character
+ * `stagger` (`typewriterTiming`). Without the stagger the preset is one held
+ * opacity step over the whole block, and the caret draws only on a staggered
+ * reveal, so nothing types.
+ */
+function typewriterIssues(clip, animations) {
+    const issues = [];
+    for (const animation of animations) {
+        if (animation.preset !== "typewriter" || animation.stagger)
+            continue;
+        issues.push({
+            severity: "warning",
+            code: "typewriter_not_staggered",
+            message: `Clip "${clipLabel(clip)}" animation "${animation.id}" stores a typewriter as a ${animation.durationMs}ms duration with no stagger — nothing draws for ${animation.durationMs}ms, then the whole text appears at once with no caret. Store the per-character form \`animate_clip\` writes: \`durationMs: 1\` with \`stagger: {unit: "character", offsetMs}\`, or re-apply the preset through \`animate_clip\`.`,
+            path: "animations[*].stagger",
+            clipId: clip.id,
+            trackId: clip.trackId
+        });
+    }
+    return issues;
+}
+/**
+ * The value a channel shows when no animation drives it: the sampler's
+ * identity for a composing channel, the clip's own value (and the field that
+ * stores it) for a replace channel. `undefined` when that value comes from
+ * layout this check does not resolve (a clip with no stored transform).
+ */
+function restValue(clip, property) {
+    const own = (value, field) => value === undefined ? undefined : { value, field };
+    switch (property) {
+        case "wipeProgress":
+            return { value: 1 };
+        case "trimStart":
+            return own(clip.shapeStyle?.trimStart ?? 0, "shapeStyle.trimStart");
+        case "trimEnd":
+            return own(clip.shapeStyle?.trimEnd ?? 1, "shapeStyle.trimEnd");
+        case "positionX":
+            return own(clip.transform?.position.x, "transform.position.x");
+        case "positionY":
+            return own(clip.transform?.position.y, "transform.position.y");
+        case "anchorX":
+            return own(clip.transform?.anchor.x, "transform.anchor.x");
+        case "anchorY":
+            return own(clip.transform?.anchor.y, "transform.anchor.y");
+        default:
+            return { value: IDENTITY_SAMPLE[property] };
+    }
+}
+/**
+ * A custom `"out"` whose curve starts away from rest after clip start.
+ *
+ * An `"out"` holds its t=1 value to clip end but contributes nothing before its
+ * window, so the channel shows its rest value there and jumps to the first
+ * keyframe when the window opens. Builders turn an `"in"` that ends away from
+ * rest into an `"out"` to keep the end value, which is how a gauge arc drawn
+ * from `trimEnd: 0` shows a full ring first. A preset `"out"` is reversed to
+ * start at rest, and a source-anchored curve has no clip-time first value, so
+ * only clip-based custom curves are checked.
+ */
+function restBeforeWindowIssues(clip, animations, compiled) {
+    const custom = new Set(animations
+        .filter((animation) => animation.preset === CUSTOM_ANIMATION_PRESET_ID)
+        .map((animation) => animation.id));
+    const issues = [];
+    for (const entry of compiled) {
+        if (entry.role !== "out" || !custom.has(entry.id))
+            continue;
+        if (entry.timeBase === "source" || entry.windowStartMs <= EPSILON_MS)
+            continue;
+        for (const curve of entry.curves) {
+            const first = curve.keyframes[0]?.value;
+            const rest = restValue(clip, curve.property);
+            if (first === undefined || rest === undefined)
+                continue;
+            if (Math.abs(first - rest.value) <= 1e-3)
+                continue;
+            // A replace channel takes the clip's own value only while undriven, so
+            // storing the first keyframe there fixes the frames before the window
+            // alone. A composing channel's rest is fixed, so only the window can move.
+            const fix = rest.field
+                ? `Set the clip's \`${rest.field}\` to ${first}, or lengthen the animation so its window starts at clip start.`
+                : "Lengthen the animation so its window starts at clip start.";
+            issues.push({
+                severity: "warning",
+                code: "animation_holds_rest_before_window",
+                message: `Clip "${clipLabel(clip)}" animation "${entry.id}" (custom, out) starts its ${curve.property} curve at ${first}, but an "out" does not apply before its window — ${curve.property} renders at the rest value ${rest.value} until ${Math.round(entry.windowStartMs)}ms, then jumps to ${first}. ${fix}`,
+                path: "animations[*].custom.curves",
+                clipId: clip.id,
+                trackId: clip.trackId
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * `timeRemap.keyframes` must ascend in `t` (D13). `sourceMs` may descend —
+ * that is reverse playback — but a `t` that repeats or goes backwards makes the
+ * piecewise evaluation ambiguous: the source time for an instant depends on
+ * which segment is asked, so the clip decodes from somewhere nobody chose. An
+ * error, because unlike a mask or a transition there is no sane thing to draw
+ * instead.
+ */
+function timeRemapIssues(clip) {
+    const keyframes = clip.timeRemap?.keyframes;
+    if (!keyframes || keyframes.length < 2)
+        return [];
+    const issues = [];
+    for (let i = 1; i < keyframes.length; i += 1) {
+        const previous = keyframes[i - 1];
+        const current = keyframes[i];
+        if (current.t > previous.t)
+            continue;
+        issues.push({
+            severity: "error",
+            code: "time_remap_not_monotonic",
+            message: `Clip "${clipLabel(clip)}" remaps time with keyframe ${i} at t=${current.t}, at or before keyframe ${i - 1} at t=${previous.t} — \`t\` must ascend. \`sourceMs\` may descend, which is how a reverse is written.`,
+            path: `timeRemap.keyframes[${i}].t`,
+            clipId: clip.id,
+            trackId: clip.trackId
+        });
+        break;
+    }
+    return issues;
+}
+/** The animated properties a link on each channel replaces (`resolveAnimatedLayerProps`). */
+const LINK_REPLACES = {
+    positionX: ["positionX", "offsetX"],
+    positionY: ["positionY", "offsetY"],
+    scale: ["scale", "scaleX", "scaleY"],
+    rotation: ["rotation"],
+    opacity: ["opacity"]
+};
+/** The clip's own value on a link channel, and the value a wiggle centres on. */
+function staticChannel(clip, channel) {
+    const t = clip.transform;
+    switch (channel) {
+        case "positionX": return { value: t?.position.x ?? 0, wiggleBase: 0 };
+        case "positionY": return { value: t?.position.y ?? 0, wiggleBase: 0 };
+        case "scale": return { value: ((t?.scale.x ?? 1) + (t?.scale.y ?? 1)) / 2, wiggleBase: 1 };
+        case "rotation": return { value: t?.rotation ?? 0, wiggleBase: 0 };
+        default: return { value: clip.opacity ?? 1, wiggleBase: 1 };
+    }
+}
+/**
+ * A link that silently discards other motion on its channel.
+ *
+ * A link sets its channel's value outright: the clip's animations on that
+ * channel are ignored while it is set, and a wiggle centres on the channel's
+ * identity, not on the clip's own placement.
+ */
+function linkOverrideIssues(clip, compiled) {
+    const issues = [];
+    for (const [index, link] of (clip.animationLinks ?? []).entries()) {
+        const replaced = new Set(LINK_REPLACES[link.target]);
+        const animated = [...new Set(compiled.flatMap((entry) => entry.curves.map((curve) => curve.property).filter((property) => replaced.has(property))))];
+        const reasons = [];
+        if (animated.length)
+            reasons.push(`the clip's own ${animated.join(", ")} animation`);
+        if ("kind" in link) {
+            const { value, wiggleBase } = staticChannel(clip, link.target);
+            if (Math.abs(value - wiggleBase) > 1e-6)
+                reasons.push(`its authored ${link.target} of ${Math.round(value * 1000) / 1000} (the wiggle centres on ${wiggleBase})`);
+        }
+        if (!reasons.length)
+            continue;
+        issues.push({
+            severity: "warning",
+            code: "animation_link_overrides",
+            message: `Clip "${clipLabel(clip)}" links ${link.target}, which sets that channel outright and discards ${reasons.join(" and ")}. Put the link on a child clip and the other motion on its parent group.`,
+            path: `animationLinks[${index}]`,
+            clipId: clip.id,
+            trackId: clip.trackId
+        });
+    }
+    return issues;
+}
+/**
+ * Every motion finding for one clip. `canvas` is the sequence's pixel size,
+ * which the compiler needs to resolve a preset's normalized distances and to
+ * count the wrapped lines of a `"line"` stagger.
+ */
+export function checkClipMotion(clip, canvas) {
+    const issues = timeRemapIssues(clip);
+    const animations = compilableAnimations(clip);
+    if (animations.length === 0)
+        return [...issues, ...linkOverrideIssues(clip, [])];
+    const { unit: staggerUnit, count: staggerCount } = clipStaggerCount(clip, canvas);
+    const compiled = compileClipAnimations(animations, clip.durationMs, canvas, { staggerCount, staggerUnit });
+    issues.push(...windowIssues(clip, animations, compiled), ...staggerIssues(clip, compiled), ...typewriterIssues(clip, animations), ...restBeforeWindowIssues(clip, animations, compiled), ...replaceOverlapIssues(clip, compiled), ...linkOverrideIssues(clip, compiled));
+    return issues;
+}
+//# sourceMappingURL=motion.js.map

package/dist/timeline-debug/motion.js.map

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

package/dist/timeline-debug/report.d.ts

@@ -0,0 +1,16 @@
+import type { TimelineDebugReport, TimelineDebugTarget, TimelineInteractionRecord } from "./types.js";
+import { type TimelineValidationMeta } from "./validate.js";
+interface TimelineDebugReportInput {
+    target: TimelineDebugTarget;
+    /** The document as loaded — untrusted, validated here. */
+    document: unknown;
+    meta?: TimelineValidationMeta;
+    interactions?: TimelineInteractionRecord[];
+    /** Bridge snapshot after the scripted session (`TimelineBridgeFinalState`). */
+    finalState?: unknown;
+    /** Document reconstructed from the final state, validated as a second pass. */
+    finalDocument?: unknown;
+}
+export declare function buildTimelineDebugReport(input: TimelineDebugReportInput): TimelineDebugReport;
+export {};
+//# sourceMappingURL=report.d.ts.map

package/dist/timeline-debug/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/timeline-debug/report.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EAG1B,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,eAAe,CAAC;AAyFvB,UAAU,wBAAwB;IAChC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,YAAY,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAC3C,+EAA+E;IAC/E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,wBAAwB,GAC9B,mBAAmB,CAwCrB"}

package/dist/timeline-debug/report.js

@@ -0,0 +1,100 @@
+import { validateTimelineSequence } from "./validate.js";
+import { isNumber } from "../predicates.js";
+const DEFAULTS = { fps: 30, width: 1920, height: 1080 };
+/**
+ * What a headless timeline run cannot answer. Fixed, because the boundary is a
+ * property of the harness, not of the document it was pointed at.
+ */
+const NOT_SIMULATED = [
+    "Rendering and compositing — no pixels are produced, so nothing here sees a frame.",
+    "Playback timing — transport, scrubbing, and audio/video sync are untested.",
+    "Video and audio decode — asset durations, real frame rates, and codec support are unknown.",
+    "Generation providers — no clip media is produced; `generated` clips are checked structurally only.",
+    "Asset I/O — asset ids are never resolved or fetched.",
+    "`get_clip_frames` and any other frame-sampling tool."
+];
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const countAndDuration = (document) => {
+    if (!isRecord(document))
+        return { trackCount: 0, clipCount: 0, durationMs: 0 };
+    const tracks = Array.isArray(document.tracks) ? document.tracks : [];
+    const clips = Array.isArray(document.clips) ? document.clips : [];
+    let durationMs = 0;
+    for (const clip of clips) {
+        if (!isRecord(clip))
+            continue;
+        const start = isNumber(clip.startMs) ? clip.startMs : 0;
+        const length = isNumber(clip.durationMs) ? clip.durationMs : 0;
+        durationMs = Math.max(durationMs, start + Math.max(0, length));
+    }
+    return { trackCount: tracks.length, clipCount: clips.length, durationMs };
+};
+const describe = (issue) => {
+    const where = issue.clipId ?? issue.trackId ?? issue.path;
+    return where
+        ? `[${issue.code}] ${where}: ${issue.message}`
+        : `[${issue.code}] ${issue.message}`;
+};
+function buildTimelineVerdict(validation, interactions, finalValidation) {
+    const failedSteps = interactions.filter((step) => !step.ok);
+    const issues = [
+        ...validation.errors.map(describe),
+        ...failedSteps.map((step) => `Interaction \`${step.tool}\` failed${step.error ? `: ${step.error}` : ""}`),
+        ...(finalValidation?.errors ?? []).map((issue) => `After edits — ${describe(issue)}`)
+    ];
+    const warnings = [
+        ...validation.warnings.map(describe),
+        ...(finalValidation?.warnings ?? []).map((issue) => `After edits — ${describe(issue)}`)
+    ];
+    const ok = issues.length === 0;
+    const warningCount = warnings.length;
+    const headline = ok
+        ? `Timeline is sound — ${interactions.length} interaction(s) ran clean` +
+            (warningCount > 0 ? `, ${warningCount} warning(s)` : "") +
+            "."
+        : `Timeline has ${issues.length} problem(s)` +
+            (failedSteps.length > 0
+                ? `, ${failedSteps.length} failed interaction(s)`
+                : "") +
+            (warningCount > 0 ? `, ${warningCount} warning(s)` : "") +
+            ` — ${issues[0]}`;
+    return warningCount > 0
+        ? { ok, headline, issues, warnings }
+        : { ok, headline, issues };
+}
+export function buildTimelineDebugReport(input) {
+    const validation = validateTimelineSequence(input.document, input.meta);
+    const finalValidation = input.finalDocument === undefined
+        ? undefined
+        : validateTimelineSequence(input.finalDocument, input.meta);
+    const interactions = input.interactions ?? [];
+    // The final document is what the session left behind, so it — not the input
+    // — describes the sequence the report is about.
+    const counted = countAndDuration(input.finalDocument ?? input.document);
+    const meta = {
+        fps: input.meta?.fps && input.meta.fps > 0 ? input.meta.fps : DEFAULTS.fps,
+        width: input.meta?.width && input.meta.width > 0
+            ? input.meta.width
+            : DEFAULTS.width,
+        height: input.meta?.height && input.meta.height > 0
+            ? input.meta.height
+            : DEFAULTS.height,
+        ...counted
+    };
+    const report = {
+        target: input.target,
+        meta,
+        validation,
+        interactions,
+        notSimulated: [...NOT_SIMULATED],
+        verdict: buildTimelineVerdict(validation, interactions, finalValidation)
+    };
+    if (input.finalState !== undefined) {
+        report.finalState = input.finalState;
+    }
+    if (finalValidation) {
+        report.finalValidation = finalValidation;
+    }
+    return report;
+}
+//# sourceMappingURL=report.js.map

package/dist/timeline-debug/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/timeline-debug/report.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,wBAAwB,EAEzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAK5C,MAAM,QAAQ,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAW,CAAC;AAEjE;;;GAGG;AACH,MAAM,aAAa,GAA0B;IAC3C,mFAAmF;IACnF,4EAA4E;IAC5E,4FAA4F;IAC5F,oGAAoG;IACpG,sDAAsD;IACtD,sDAAsD;CACvD,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvE,MAAM,gBAAgB,GAAG,CACvB,QAAiB,EACjB,EAAE;IACF,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACrB,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IACxD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAS;QAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/D,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;AAC5E,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,KAAyB,EAAU,EAAE;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC;IAC1D,OAAO,KAAK;QACV,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,KAAK,KAAK,CAAC,OAAO,EAAE;QAC9C,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;AACzC,CAAC,CAAC;AAEF,SAAS,oBAAoB,CAC3B,UAA8B,EAC9B,YAAsD,EACtD,eAA+C;IAE/C,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAa;QACvB,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClC,GAAG,WAAW,CAAC,GAAG,CAChB,CAAC,IAAI,EAAE,EAAE,CACP,iBAAiB,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9E;QACD,GAAG,CAAC,eAAe,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CACpC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAC9C;KACF,CAAC;IACF,MAAM,QAAQ,GAAa;QACzB,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;QACpC,GAAG,CAAC,eAAe,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CACtC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAC9C;KACF,CAAC;IAEF,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IAC/B,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC;IACrC,MAAM,QAAQ,GAAG,EAAE;QACjB,CAAC,CAAC,uBAAuB,YAAY,CAAC,MAAM,2BAA2B;YACrE,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,YAAY,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG;QACL,CAAC,CAAC,gBAAgB,MAAM,CAAC,MAAM,aAAa;YAC1C,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;gBACrB,CAAC,CAAC,KAAK,WAAW,CAAC,MAAM,wBAAwB;gBACjD,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,YAAY,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtB,OAAO,YAAY,GAAG,CAAC;QACrB,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;QACpC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC;AAcD,MAAM,UAAU,wBAAwB,CACtC,KAA+B;IAE/B,MAAM,UAAU,GAAG,wBAAwB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACxE,MAAM,eAAe,GACnB,KAAK,CAAC,aAAa,KAAK,SAAS;QAC/B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,wBAAwB,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;IAE9C,4EAA4E;IAC5E,gDAAgD;IAChD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxE,MAAM,IAAI,GAAyB;QACjC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG;QAC1E,KAAK,EACH,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC;YACvC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK;YAClB,CAAC,CAAC,QAAQ,CAAC,KAAK;QACpB,MAAM,EACJ,KAAK,CAAC,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;YACzC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM;YACnB,CAAC,CAAC,QAAQ,CAAC,MAAM;QACrB,GAAG,OAAO;KACX,CAAC;IAGF,MAAM,MAAM,GAAiB;QAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI;QACJ,UAAU;QACV,YAAY;QACZ,YAAY,EAAE,CAAC,GAAG,aAAa,CAAC;QAChC,OAAO,EAAE,oBAAoB,CAAC,UAAU,EAAE,YAAY,EAAE,eAAe,CAAC;KACzE,CAAC;IACF,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACvC,CAAC;IACD,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,CAAC,eAAe,GAAG,eAAe,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/timeline-debug/showcase.d.ts

@@ -0,0 +1,7 @@
+import type { TimelineDocument } from "@nodetool-ai/protocol/api-schemas/timeline.js";
+import type { TimelineDebugIssue } from "./types.js";
+export declare function checkShowcase(doc: TimelineDocument, canvas: {
+    width: number;
+    height: number;
+}): TimelineDebugIssue[];
+//# sourceMappingURL=showcase.d.ts.map

package/dist/timeline-debug/showcase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showcase.d.ts","sourceRoot":"","sources":["../../src/timeline-debug/showcase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,gBAAgB,EACjB,MAAM,+CAA+C,CAAC;AAOvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA8LrD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,gBAAgB,EACrB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxC,kBAAkB,EAAE,CA2PtB"}