@vibeframe/cli 0.52.1 → 0.54.0

package/dist/commands/_shared/scene-lint.js

@@ -0,0 +1,207 @@
+/**
+ * @module _shared/scene-lint
+ *
+ * In-process Hyperframes lint pipeline for VibeFrame scene projects. Wraps
+ * `runHyperframeLint` from `@hyperframes/producer` (its public lint entry
+ * point) and adapts the output to VibeFrame's two-tier file structure:
+ *
+ *   project/
+ *     index.html              # root composition  → linted as-is
+ *     compositions/*.html     # sub-compositions  → producer's lint emits two
+ *                                                   spurious findings here, so
+ *                                                   we filter them out.
+ *
+ * Two findings are filtered for sub-compositions because they encode the
+ * inverse rule (sub-comps SHOULD be wrapped in `<template>` and SHOULD NOT
+ * have an `<html>` wrapper):
+ *   - `standalone_composition_wrapped_in_template`
+ *   - `root_composition_missing_html_wrapper`
+ *
+ * Pure helpers are exported for unit testing; `runProjectLint` does the
+ * filesystem walk + lint orchestration. Mechanical `--fix` is intentionally
+ * conservative — only `timed_element_missing_clip_class` is auto-fixed in
+ * MVP 1.
+ */
+import { readdir, readFile, writeFile, stat } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { resolve, relative, join } from "node:path";
+import { runHyperframeLint, } from "@hyperframes/producer";
+// ---------------------------------------------------------------------------
+// Pure helpers
+// ---------------------------------------------------------------------------
+/** Producer's two findings that are inverse-rules for sub-compositions. */
+export const SUB_COMP_FALSE_POSITIVES = new Set([
+    "standalone_composition_wrapped_in_template",
+    "root_composition_missing_html_wrapper",
+]);
+/**
+ * Discover scene files in a project. Returns the root composition (or null
+ * if missing) plus every `*.html` file under `compositions/` recursively.
+ *
+ * Paths returned are absolute. The caller derives project-relative paths via
+ * `relative(projectDir, path)`.
+ */
+export async function discoverSceneFiles(opts) {
+    const projectDir = resolve(opts.projectDir);
+    const rootAbs = resolve(projectDir, opts.rootRel ?? "index.html");
+    const root = existsSync(rootAbs) ? rootAbs : null;
+    const compsDir = resolve(projectDir, "compositions");
+    const subs = [];
+    if (existsSync(compsDir)) {
+        await collectHtmlRecursive(compsDir, subs);
+        subs.sort();
+    }
+    return { root, subs };
+}
+async function collectHtmlRecursive(dir, into) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            await collectHtmlRecursive(full, into);
+        }
+        else if (entry.isFile() && entry.name.toLowerCase().endsWith(".html")) {
+            into.push(full);
+        }
+    }
+}
+/**
+ * Drop findings that producer's lint emits as inverse-rules for sub-comp
+ * files. Other findings pass through unchanged.
+ */
+export function filterSubCompFalsePositives(findings, isSubComposition) {
+    if (!isSubComposition)
+        return findings;
+    return findings.filter((f) => !SUB_COMP_FALSE_POSITIVES.has(f.code));
+}
+/**
+ * Apply mechanical `--fix` rewrites for known-safe finding codes. Returns the
+ * (possibly unchanged) HTML and the list of codes that were fixed at least
+ * once.
+ *
+ * MVP 1 only auto-fixes `timed_element_missing_clip_class` — adding the
+ * `clip` class to elements that already carry timing attributes.
+ *
+ * Other "registration"/"paused" fixes are intentionally NOT mechanical —
+ * they require structural reasoning (where to insert the `window.__timelines`
+ * block, how to convert an unpaused timeline) that goes beyond a regex.
+ * The lint output still surfaces them with `fixHint` for the agent or human
+ * to apply.
+ */
+export function applyMechanicalFixes(html, findings) {
+    const fixedCodes = new Set();
+    let updated = html;
+    if (findings.some((f) => f.code === "timed_element_missing_clip_class")) {
+        const next = addClipClassToTimedElements(updated);
+        if (next !== updated) {
+            updated = next;
+            fixedCodes.add("timed_element_missing_clip_class");
+        }
+    }
+    return { html: updated, fixedCodes: [...fixedCodes] };
+}
+/**
+ * Add `class="clip"` (or merge into an existing `class="..."`) on every
+ * element that has both `data-start` and `data-duration` but no `clip` class.
+ *
+ * Skips `<audio>` and `<video>` elements — those have timing attributes but
+ * use their own track-management semantics, and the lint rule already exempts
+ * them.
+ */
+function addClipClassToTimedElements(html) {
+    return html.replace(/<([a-z][a-z0-9-]*)([^>]*)>/gi, (full, tag, attrs) => {
+        const lower = tag.toLowerCase();
+        if (lower === "audio" || lower === "video")
+            return full;
+        if (!/\sdata-start="/.test(attrs))
+            return full;
+        if (!/\sdata-duration="/.test(attrs))
+            return full;
+        const classMatch = attrs.match(/\sclass="([^"]*)"/);
+        if (classMatch) {
+            const classes = classMatch[1].split(/\s+/).filter(Boolean);
+            if (classes.includes("clip"))
+                return full;
+            const merged = [...classes, "clip"].join(" ");
+            return `<${tag}${attrs.replace(/\sclass="[^"]*"/, ` class="${merged}"`)}>`;
+        }
+        return `<${tag} class="clip"${attrs}>`;
+    });
+}
+/**
+ * Walk the project, lint every HTML file, optionally apply mechanical fixes,
+ * and return aggregated counts. Throws only on FS errors; lint errors are
+ * surfaced as findings, not exceptions.
+ */
+export async function runProjectLint(opts) {
+    const projectDir = resolve(opts.projectDir);
+    const { root, subs } = await discoverSceneFiles({ projectDir, rootRel: opts.rootRel });
+    const files = [];
+    const fixed = [];
+    const targets = [];
+    if (root)
+        targets.push({ abs: root, isSub: false });
+    for (const sub of subs)
+        targets.push({ abs: sub, isSub: true });
+    for (const { abs, isSub } of targets) {
+        const rel = relative(projectDir, abs) || abs;
+        const html = await readFile(abs, "utf-8");
+        const prepared = {
+            html,
+            entryFile: rel,
+            source: "projectDir",
+        };
+        const raw = runHyperframeLint(prepared);
+        const findings = filterSubCompFalsePositives(raw.findings, isSub);
+        if (opts.fix && findings.length > 0) {
+            const { html: nextHtml, fixedCodes } = applyMechanicalFixes(html, findings);
+            if (fixedCodes.length > 0) {
+                await writeFile(abs, nextHtml, "utf-8");
+                fixed.push({ file: rel, codes: fixedCodes });
+                // Re-lint after fix so the result reflects what's left.
+                const reLinted = runHyperframeLint({ ...prepared, html: nextHtml });
+                files.push({
+                    file: rel,
+                    isSubComposition: isSub,
+                    findings: filterSubCompFalsePositives(reLinted.findings, isSub),
+                });
+                continue;
+            }
+        }
+        files.push({ file: rel, isSubComposition: isSub, findings });
+    }
+    let errorCount = 0;
+    let warningCount = 0;
+    let infoCount = 0;
+    for (const f of files) {
+        for (const finding of f.findings) {
+            if (finding.severity === "error")
+                errorCount++;
+            else if (finding.severity === "warning")
+                warningCount++;
+            else
+                infoCount++;
+        }
+    }
+    return {
+        ok: errorCount === 0,
+        errorCount,
+        warningCount,
+        infoCount,
+        files,
+        fixed,
+    };
+}
+/** True if `root` exists and is a regular file. Used by callers that want to
+ *  pre-validate before invoking `runProjectLint`. */
+export async function rootExists(projectDir, rootRel = "index.html") {
+    const abs = resolve(projectDir, rootRel);
+    try {
+        const s = await stat(abs);
+        return s.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=scene-lint.js.map

package/dist/commands/_shared/scene-lint.js.map

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

package/dist/commands/_shared/scene-lint.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scene-lint.test.d.ts.map

package/dist/commands/_shared/scene-lint.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-lint.test.d.ts","sourceRoot":"","sources":["../../../src/commands/_shared/scene-lint.test.ts"],"names":[],"mappings":""}

package/dist/commands/_shared/scene-lint.test.js

@@ -0,0 +1,208 @@
+import { describe, expect, it } from "vitest";
+import { mkdtemp, mkdir, writeFile, readFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import { applyMechanicalFixes, discoverSceneFiles, filterSubCompFalsePositives, rootExists, runProjectLint, SUB_COMP_FALSE_POSITIVES, } from "./scene-lint.js";
+import { buildEmptyRootHtml, scaffoldSceneProject, } from "./scene-project.js";
+import { buildClipReference, emitSceneHtml, insertClipIntoRoot, } from "./scene-html-emit.js";
+async function makeTmp(label = "vibe-scene-lint-") {
+    return mkdtemp(join(tmpdir(), label));
+}
+// ── filterSubCompFalsePositives ─────────────────────────────────────────────
+describe("filterSubCompFalsePositives", () => {
+    const findings = [
+        { code: "standalone_composition_wrapped_in_template", severity: "warning", message: "x" },
+        { code: "root_composition_missing_html_wrapper", severity: "warning", message: "x" },
+        { code: "missing_timeline_registry", severity: "error", message: "real" },
+    ];
+    it("drops the two known false positives for sub-compositions", () => {
+        const out = filterSubCompFalsePositives(findings, true);
+        expect(out).toHaveLength(1);
+        expect(out[0].code).toBe("missing_timeline_registry");
+    });
+    it("returns root-composition findings unchanged", () => {
+        const out = filterSubCompFalsePositives(findings, false);
+        expect(out).toHaveLength(3);
+    });
+    it("exposes the filtered codes via SUB_COMP_FALSE_POSITIVES", () => {
+        expect(SUB_COMP_FALSE_POSITIVES.has("standalone_composition_wrapped_in_template")).toBe(true);
+        expect(SUB_COMP_FALSE_POSITIVES.has("root_composition_missing_html_wrapper")).toBe(true);
+        expect(SUB_COMP_FALSE_POSITIVES.size).toBe(2);
+    });
+});
+// ── applyMechanicalFixes ────────────────────────────────────────────────────
+describe("applyMechanicalFixes — timed_element_missing_clip_class", () => {
+    const finding = {
+        code: "timed_element_missing_clip_class",
+        severity: "error",
+        message: "missing class=\"clip\"",
+    };
+    it("adds class=\"clip\" to elements with timing attributes and no class", () => {
+        const html = `<div data-start="0" data-duration="3" data-track-index="1">x</div>`;
+        const { html: out, fixedCodes } = applyMechanicalFixes(html, [finding]);
+        expect(out).toContain('<div class="clip" data-start="0" data-duration="3"');
+        expect(fixedCodes).toEqual(["timed_element_missing_clip_class"]);
+    });
+    it("merges into an existing class list rather than overwriting", () => {
+        const html = `<div class="card glow" data-start="0" data-duration="3" data-track-index="1">x</div>`;
+        const { html: out } = applyMechanicalFixes(html, [finding]);
+        expect(out).toContain('class="card glow clip"');
+    });
+    it("is idempotent — already-clipped elements aren't modified", () => {
+        const html = `<div class="clip card" data-start="0" data-duration="3" data-track-index="1">x</div>`;
+        const { html: out, fixedCodes } = applyMechanicalFixes(html, [finding]);
+        expect(out).toBe(html);
+        expect(fixedCodes).toEqual([]);
+    });
+    it("skips <audio> and <video> (their lint rule already exempts them)", () => {
+        const html = `<audio data-start="0" data-duration="3" src="x.mp3"></audio>
+<video data-start="0" data-duration="3" src="x.mp4"></video>`;
+        const { html: out, fixedCodes } = applyMechanicalFixes(html, [finding]);
+        expect(out).toBe(html);
+        expect(fixedCodes).toEqual([]);
+    });
+    it("does not fix codes outside the auto-fix allow-list", () => {
+        const html = `<div data-start="0" data-duration="3">x</div>`;
+        const other = { code: "missing_timeline_registry", severity: "error", message: "x" };
+        const { html: out, fixedCodes } = applyMechanicalFixes(html, [other]);
+        expect(out).toBe(html);
+        expect(fixedCodes).toEqual([]);
+    });
+});
+// ── discoverSceneFiles + rootExists ─────────────────────────────────────────
+describe("discoverSceneFiles", () => {
+    it("returns null root when index.html is missing", async () => {
+        const dir = await makeTmp();
+        const out = await discoverSceneFiles({ projectDir: dir });
+        expect(out.root).toBeNull();
+        expect(out.subs).toEqual([]);
+    });
+    it("walks compositions/ recursively and sorts results", async () => {
+        const dir = await makeTmp();
+        await scaffoldSceneProject({ dir, name: "fix", aspect: "16:9", duration: 6 });
+        await mkdir(resolve(dir, "compositions/nested"), { recursive: true });
+        await writeFile(resolve(dir, "compositions/scene-b.html"), "x", "utf-8");
+        await writeFile(resolve(dir, "compositions/scene-a.html"), "x", "utf-8");
+        await writeFile(resolve(dir, "compositions/nested/deep.html"), "x", "utf-8");
+        await writeFile(resolve(dir, "compositions/notes.txt"), "ignored", "utf-8");
+        const out = await discoverSceneFiles({ projectDir: dir });
+        expect(out.root).toBe(resolve(dir, "index.html"));
+        expect(out.subs).toEqual([
+            resolve(dir, "compositions/nested/deep.html"),
+            resolve(dir, "compositions/scene-a.html"),
+            resolve(dir, "compositions/scene-b.html"),
+        ]);
+    });
+});
+describe("rootExists", () => {
+    it("true when index.html exists, false otherwise", async () => {
+        const dir = await makeTmp();
+        expect(await rootExists(dir)).toBe(false);
+        await scaffoldSceneProject({ dir, name: "x", aspect: "16:9", duration: 4 });
+        expect(await rootExists(dir)).toBe(true);
+    });
+});
+// ── runProjectLint — integration against scaffolded projects ────────────────
+describe("runProjectLint — integration", () => {
+    async function scaffoldWithScenes() {
+        const dir = await makeTmp("vibe-lint-int-");
+        await scaffoldSceneProject({ dir, name: "fixture", aspect: "16:9", duration: 8 });
+        // Add two scenes by hand using the C2 emit helpers (avoids spawning the CLI).
+        let root = await readFile(resolve(dir, "index.html"), "utf-8");
+        const intro = emitSceneHtml({
+            id: "intro", preset: "announcement", width: 1920, height: 1080,
+            duration: 4, headline: "Hello",
+        });
+        await writeFile(resolve(dir, "compositions/scene-intro.html"), intro, "utf-8");
+        root = insertClipIntoRoot(root, { id: "intro", start: 0, duration: 4 });
+        const outro = emitSceneHtml({
+            id: "outro", preset: "simple", width: 1920, height: 1080,
+            duration: 3, subhead: "Thanks",
+        });
+        await writeFile(resolve(dir, "compositions/scene-outro.html"), outro, "utf-8");
+        root = insertClipIntoRoot(root, { id: "outro", start: 4, duration: 3 });
+        await writeFile(resolve(dir, "index.html"), root, "utf-8");
+        return dir;
+    }
+    it("produces ok=true on a freshly scaffolded project with valid scenes", async () => {
+        const dir = await scaffoldWithScenes();
+        const result = await runProjectLint({ projectDir: dir });
+        expect(result.ok).toBe(true);
+        expect(result.errorCount).toBe(0);
+        // 1 root + 2 sub-comps inspected
+        expect(result.files.map((f) => f.file).sort()).toEqual([
+            "compositions/scene-intro.html",
+            "compositions/scene-outro.html",
+            "index.html",
+        ]);
+        // Sub-comp false positives must not appear
+        for (const file of result.files) {
+            for (const f of file.findings) {
+                expect(SUB_COMP_FALSE_POSITIVES.has(f.code)).toBe(false);
+            }
+        }
+    });
+    it("flags a sub-comp that has timing attributes but no class=\"clip\"", async () => {
+        const dir = await scaffoldWithScenes();
+        // Mutate scene-intro.html: drop `class="clip"` from a timed element.
+        const broken = `<template id="bad-template">
+  <div data-composition-id="bad" data-start="0" data-duration="3" data-width="1920" data-height="1080">
+    <div data-start="0" data-duration="2" data-track-index="1">no class</div>
+  </div>
+</template>`;
+        await writeFile(resolve(dir, "compositions/scene-bad.html"), broken, "utf-8");
+        const result = await runProjectLint({ projectDir: dir });
+        const badFile = result.files.find((f) => f.file.endsWith("scene-bad.html"));
+        expect(badFile).toBeDefined();
+        expect(badFile.findings.some((f) => f.code === "timed_element_missing_clip_class")).toBe(true);
+    });
+    it("--fix repairs timed_element_missing_clip_class and re-lint shows it gone", async () => {
+        const dir = await scaffoldWithScenes();
+        const broken = `<template id="bad-template">
+  <div data-composition-id="bad" data-start="0" data-duration="3" data-width="1920" data-height="1080">
+    <div data-start="0" data-duration="2" data-track-index="1">no class</div>
+    <script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
+    <script>
+      window.__timelines = window.__timelines || {};
+      const tl = gsap.timeline({ paused: true });
+      window.__timelines["bad"] = tl;
+    </script>
+  </div>
+</template>`;
+        const badPath = resolve(dir, "compositions/scene-bad.html");
+        await writeFile(badPath, broken, "utf-8");
+        const result = await runProjectLint({ projectDir: dir, fix: true });
+        // Fix tracked
+        const fix = result.fixed.find((f) => f.file.endsWith("scene-bad.html"));
+        expect(fix).toBeDefined();
+        expect(fix.codes).toContain("timed_element_missing_clip_class");
+        // File on disk is updated
+        const after = await readFile(badPath, "utf-8");
+        expect(after).toContain('<div class="clip" data-start="0" data-duration="2"');
+        // Re-lint result no longer reports it for that file
+        const badFile = result.files.find((f) => f.file.endsWith("scene-bad.html"));
+        expect(badFile.findings.some((f) => f.code === "timed_element_missing_clip_class")).toBe(false);
+    });
+    it("returns ok=true and empty findings on an empty root with no compositions/ dir", async () => {
+        const dir = await makeTmp();
+        await writeFile(resolve(dir, "index.html"), buildEmptyRootHtml({ aspect: "16:9", duration: 5 }), "utf-8");
+        const result = await runProjectLint({ projectDir: dir });
+        expect(result.ok).toBe(true);
+        expect(result.files).toHaveLength(1);
+        expect(result.files[0].file).toBe("index.html");
+    });
+    it("does not flag a buildClipReference()-built clip in the root", async () => {
+        const dir = await scaffoldWithScenes();
+        // Produce one extra clip via the C2 helper just to be sure the produced
+        // markup keeps lint clean.
+        const root = await readFile(resolve(dir, "index.html"), "utf-8");
+        const augmented = root.replace("</div>\n\n    <script>", `  ${buildClipReference({ id: "extra", start: 7, duration: 2 })}\n    </div>\n\n    <script>`);
+        await writeFile(resolve(dir, "index.html"), augmented, "utf-8");
+        // The extra clip references a non-existent composition file — that's a
+        // semantic/runtime concern, not a lint rule. So lint should still pass.
+        const result = await runProjectLint({ projectDir: dir });
+        const rootFile = result.files.find((f) => f.file === "index.html");
+        expect(rootFile.findings.some((f) => f.code === "timed_element_missing_clip_class")).toBe(false);
+    });
+});
+//# sourceMappingURL=scene-lint.test.js.map

package/dist/commands/_shared/scene-lint.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-lint.test.js","sourceRoot":"","sources":["../../../src/commands/_shared/scene-lint.test.ts"],"names":[],"mappings":"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"}

package/dist/commands/_shared/scene-project.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @module _shared/scene-project
+ *
+ * Helpers for scaffolding a "scene project" — a directory that works as both
+ * a VibeFrame project (via `vibe.project.yaml`) AND a HeyGen Hyperframes
+ * project (via `hyperframes.json` + `meta.json` + `index.html`). Either
+ * toolchain can be run inside the directory.
+ *
+ * Pure functions; no I/O beyond `scaffoldSceneProject()` which orchestrates
+ * file writes. Everything else returns strings or JSON-serializable objects
+ * so it can be unit-tested without touching the filesystem.
+ */
+/** Supported aspect ratios for scene projects (maps to CSS canvas dims). */
+export type SceneAspect = "16:9" | "9:16" | "1:1" | "4:5";
+export declare function aspectToDims(aspect: SceneAspect): {
+    width: number;
+    height: number;
+};
+/** Shape of the Hyperframes project config file. */
+export interface HyperframesConfig {
+    $schema?: string;
+    registry?: string;
+    paths?: {
+        blocks?: string;
+        components?: string;
+        assets?: string;
+    };
+    [key: string]: unknown;
+}
+/** Shape of the Hyperframes meta file. */
+export interface HyperframesMeta {
+    id: string;
+    name: string;
+    createdAt: string;
+    [key: string]: unknown;
+}
+/** Shape of the new VibeFrame-specific project config. */
+export interface VibeProjectConfig {
+    name: string;
+    aspect: SceneAspect;
+    /** Default scene duration in seconds when none is inferred from narration. */
+    defaultSceneDuration: number;
+    /** Default providers per capability. `null` means "auto-resolve from env". */
+    providers: {
+        image: "openai" | "gemini" | "grok" | null;
+        tts: "elevenlabs" | "kokoro" | null;
+        transcribe: "whisper" | null;
+    };
+    /** Cost ceiling for `vibe pipeline` runs in this project. 0 disables. */
+    budget: {
+        maxUsd: number;
+    };
+}
+/** Defaults for a fresh scene project. */
+export declare function defaultVibeProjectConfig(name: string): VibeProjectConfig;
+/** The Hyperframes config we write on init. Matches the format at
+ *  hyperframe-learn/my-first-video/hyperframes.json.
+ */
+export declare function buildHyperframesConfig(): HyperframesConfig;
+export declare function buildHyperframesMeta(name: string, now?: Date): HyperframesMeta;
+/**
+ * Merge an existing Hyperframes config with our defaults, preserving any
+ * user-authored keys and nested values. `vibe scene init` is idempotent:
+ * running it on a directory that already has `hyperframes.json` must never
+ * lose user config.
+ */
+export declare function mergeHyperframesConfig(existing: HyperframesConfig, defaults: HyperframesConfig): HyperframesConfig;
+/**
+ * Minimal valid Hyperframes root composition — empty (no sub-compositions
+ * yet). A later `vibe scene add` inserts `<div class="clip" ...>` children.
+ */
+export declare function buildEmptyRootHtml(opts: {
+    aspect: SceneAspect;
+    duration: number;
+}): string;
+/** Project-local CLAUDE.md that orients an AI agent to both toolchains. */
+export declare function buildProjectClaudeMd(name: string): string;
+/** Minimal .gitignore for a scene project. */
+export declare function buildSceneGitignore(): string;
+export interface ScaffoldOptions {
+    dir: string;
+    name?: string;
+    aspect?: SceneAspect;
+    duration?: number;
+    now?: Date;
+}
+export interface ScaffoldResult {
+    /** Files written (absolute paths). */
+    created: string[];
+    /** Files that already existed and were NOT overwritten. */
+    skipped: string[];
+    /** Files that were merge-updated (currently only hyperframes.json). */
+    merged: string[];
+}
+/**
+ * Scaffold (or update) a scene project at `dir`. Idempotent: running twice is
+ * a no-op; running on an existing Hyperframes project merges `hyperframes.json`
+ * instead of overwriting.
+ */
+export declare function scaffoldSceneProject(opts: ScaffoldOptions): Promise<ScaffoldResult>;
+//# sourceMappingURL=scene-project.d.ts.map

package/dist/commands/_shared/scene-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-project.d.ts","sourceRoot":"","sources":["../../../src/commands/_shared/scene-project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAS1D,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAEnF;AAED,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,8EAA8E;IAC9E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,SAAS,EAAE;QACT,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;QAC3C,GAAG,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI,CAAC;QACpC,UAAU,EAAE,SAAS,GAAG,IAAI,CAAC;KAC9B,CAAC;IACF,yEAAyE;IACzE,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5B;AAED,0CAA0C;AAC1C,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAQxE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,iBAAiB,CAU1D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,eAAe,CAE1F;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,iBAAiB,GAC1B,iBAAiB,CAOnB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAyC1F;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgEzD;AAED,8CAA8C;AAC9C,wBAAgB,mBAAmB,IAAI,MAAM,CAa5C;AAMD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uEAAuE;IACvE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAWD;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA4EzF"}