@vibeframe/cli 0.52.1 → 0.54.0

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

@@ -0,0 +1,281 @@
+/**
+ * @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.
+ */
+import { mkdir, readFile, writeFile, access } from "node:fs/promises";
+import { resolve, basename } from "node:path";
+import { stringify as yamlStringify } from "yaml";
+const ASPECT_DIMS = {
+    "16:9": { width: 1920, height: 1080 },
+    "9:16": { width: 1080, height: 1920 },
+    "1:1": { width: 1080, height: 1080 },
+    "4:5": { width: 1080, height: 1350 },
+};
+export function aspectToDims(aspect) {
+    return ASPECT_DIMS[aspect];
+}
+/** Defaults for a fresh scene project. */
+export function defaultVibeProjectConfig(name) {
+    return {
+        name,
+        aspect: "16:9",
+        defaultSceneDuration: 5,
+        providers: { image: null, tts: null, transcribe: null },
+        budget: { maxUsd: 0 },
+    };
+}
+/** The Hyperframes config we write on init. Matches the format at
+ *  hyperframe-learn/my-first-video/hyperframes.json.
+ */
+export function buildHyperframesConfig() {
+    return {
+        $schema: "https://hyperframes.heygen.com/schema/hyperframes.json",
+        registry: "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
+        paths: {
+            blocks: "compositions",
+            components: "compositions/components",
+            assets: "assets",
+        },
+    };
+}
+export function buildHyperframesMeta(name, now = new Date()) {
+    return { id: name, name, createdAt: now.toISOString() };
+}
+/**
+ * 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 function mergeHyperframesConfig(existing, defaults) {
+    const out = { ...defaults, ...existing };
+    // Preserve nested `paths` by shallow-merging.
+    if (existing.paths || defaults.paths) {
+        out.paths = { ...(defaults.paths ?? {}), ...(existing.paths ?? {}) };
+    }
+    return out;
+}
+/**
+ * Minimal valid Hyperframes root composition — empty (no sub-compositions
+ * yet). A later `vibe scene add` inserts `<div class="clip" ...>` children.
+ */
+export function buildEmptyRootHtml(opts) {
+    const { width, height } = ASPECT_DIMS[opts.aspect];
+    return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=${width}, height=${height}" />
+    <script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
+    <style>
+      * { margin: 0; padding: 0; box-sizing: border-box; }
+      html, body {
+        margin: 0;
+        width: ${width}px;
+        height: ${height}px;
+        overflow: hidden;
+        background: #000;
+      }
+    </style>
+  </head>
+  <body>
+    <div
+      id="root"
+      data-composition-id="main"
+      data-start="0"
+      data-duration="${opts.duration}"
+      data-width="${width}"
+      data-height="${height}"
+    >
+      <!-- Scenes added via \`vibe scene add\` are inserted here. -->
+      <!-- Each scene reference: data-composition-id, data-composition-src, data-start, data-duration, data-track-index. -->
+      <!-- See compositions/*.html for sub-composition contents. -->
+
+    </div>
+
+    <script>
+      window.__timelines = window.__timelines || {};
+      window.__timelines["main"] = gsap.timeline({ paused: true });
+    </script>
+  </body>
+</html>
+`;
+}
+/** Project-local CLAUDE.md that orients an AI agent to both toolchains. */
+export function buildProjectClaudeMd(name) {
+    return `# ${name} — Scene Authoring Project
+
+This project is **bilingual**: it works with both VibeFrame (\`vibe\`) and
+HeyGen Hyperframes (\`hyperframes\`). You can run either CLI inside this
+directory.
+
+## Skills — USE THESE FIRST
+
+**Always invoke the relevant skill before authoring scenes.** Skills encode
+framework-specific patterns (GSAP timeline registration, data-attribute
+semantics, VibeFrame pipeline conventions) that are NOT in generic web docs.
+
+| Skill             | Command          | When to use                                                                           |
+| ----------------- | ---------------- | ------------------------------------------------------------------------------------- |
+| **vibe-scene**    | \`/vibe-scene\`    | Authoring / editing per-scene HTML in this project — preferred                        |
+| **hyperframes**   | \`/hyperframes\`   | Fallback: direct HF authoring (install via \`npx skills add heygen-com/hyperframes\`) |
+| **gsap**          | \`/gsap\`          | GSAP tweens, timelines, easing                                                        |
+
+If the skill is not available, follow the **Key Rules** below.
+
+## Project structure
+
+- \`index.html\` — root composition (timeline)
+- \`compositions/scene-*.html\` — per-scene HTML authored by you or the agent
+- \`assets/\` — shared media (narration audio, images, video)
+- \`transcript.json\` — Whisper word-level transcript (if narration exists)
+- \`hyperframes.json\` — HF registry config (speak to both toolchains)
+- \`vibe.project.yaml\` — VibeFrame config (providers, budget)
+- \`renders/\` — output MP4s
+
+## Commands
+
+\`\`\`bash
+vibe scene add <name> --narration "..." --visuals "..."   # Author a new scene via AI
+vibe scene lint                                             # Validate scenes (in-process HF linter)
+vibe scene render                                           # Render to MP4
+
+# Hyperframes CLI (if installed — works in this project too)
+npx hyperframes preview
+npx hyperframes render
+\`\`\`
+
+## Key Rules (for hand-authored scene HTML)
+
+1. Every timed element needs \`data-start\`, \`data-duration\`, and \`data-track-index\`.
+2. Elements with timing **MUST** have \`class="clip"\` — the framework uses this for visibility control.
+3. Timelines must be paused and registered on \`window.__timelines\`:
+   \`\`\`js
+   window.__timelines = window.__timelines || {};
+   window.__timelines["composition-id"] = gsap.timeline({ paused: true });
+   \`\`\`
+4. Videos use \`muted\` with a separate \`<audio>\` element for the audio track.
+5. Sub-compositions use \`data-composition-src="compositions/file.html"\`.
+6. Only deterministic logic — no \`Date.now()\`, \`Math.random()\`, or network fetches.
+
+## Linting — run after changes
+
+\`\`\`bash
+vibe scene lint           # preferred — in-process, no network
+vibe scene lint --fix     # auto-fix mechanical issues
+vibe scene lint --json    # structured output for agent loops
+\`\`\`
+`;
+}
+/** Minimal .gitignore for a scene project. */
+export function buildSceneGitignore() {
+    return `# VibeFrame caches
+.vibeframe/cache/
+.vibeframe/checkpoints/
+
+# Render outputs
+renders/*.mp4
+tmp/
+
+# OS / editor
+.DS_Store
+*.log
+`;
+}
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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 async function scaffoldSceneProject(opts) {
+    const dir = resolve(opts.dir);
+    const name = opts.name ?? basename(dir);
+    const aspect = opts.aspect ?? "16:9";
+    const duration = opts.duration ?? 10;
+    const now = opts.now ?? new Date();
+    await mkdir(dir, { recursive: true });
+    await mkdir(resolve(dir, "compositions"), { recursive: true });
+    await mkdir(resolve(dir, "assets"), { recursive: true });
+    const created = [];
+    const skipped = [];
+    const merged = [];
+    // hyperframes.json — merge if exists, else create.
+    const hfPath = resolve(dir, "hyperframes.json");
+    const hfDefaults = buildHyperframesConfig();
+    if (await pathExists(hfPath)) {
+        const existingRaw = await readFile(hfPath, "utf-8");
+        const existing = JSON.parse(existingRaw);
+        const mergedConfig = mergeHyperframesConfig(existing, hfDefaults);
+        await writeFile(hfPath, JSON.stringify(mergedConfig, null, 2) + "\n", "utf-8");
+        merged.push(hfPath);
+    }
+    else {
+        await writeFile(hfPath, JSON.stringify(hfDefaults, null, 2) + "\n", "utf-8");
+        created.push(hfPath);
+    }
+    // meta.json — preserve existing (id shouldn't change).
+    const metaPath = resolve(dir, "meta.json");
+    if (await pathExists(metaPath)) {
+        skipped.push(metaPath);
+    }
+    else {
+        await writeFile(metaPath, JSON.stringify(buildHyperframesMeta(name, now), null, 2) + "\n", "utf-8");
+        created.push(metaPath);
+    }
+    // index.html — preserve existing (user may have edited root).
+    const rootPath = resolve(dir, "index.html");
+    if (await pathExists(rootPath)) {
+        skipped.push(rootPath);
+    }
+    else {
+        await writeFile(rootPath, buildEmptyRootHtml({ aspect, duration }), "utf-8");
+        created.push(rootPath);
+    }
+    // vibe.project.yaml — preserve existing; this is VibeFrame's own config.
+    const vibePath = resolve(dir, "vibe.project.yaml");
+    if (await pathExists(vibePath)) {
+        skipped.push(vibePath);
+    }
+    else {
+        const cfg = { ...defaultVibeProjectConfig(name), aspect };
+        await writeFile(vibePath, yamlStringify(cfg), "utf-8");
+        created.push(vibePath);
+    }
+    // CLAUDE.md — preserve existing.
+    const claudePath = resolve(dir, "CLAUDE.md");
+    if (await pathExists(claudePath)) {
+        skipped.push(claudePath);
+    }
+    else {
+        await writeFile(claudePath, buildProjectClaudeMd(name), "utf-8");
+        created.push(claudePath);
+    }
+    // .gitignore — preserve existing.
+    const gitignorePath = resolve(dir, ".gitignore");
+    if (await pathExists(gitignorePath)) {
+        skipped.push(gitignorePath);
+    }
+    else {
+        await writeFile(gitignorePath, buildSceneGitignore(), "utf-8");
+        created.push(gitignorePath);
+    }
+    return { created, skipped, merged };
+}
+//# sourceMappingURL=scene-project.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,203 @@
+import { describe, expect, it } from "vitest";
+import { mkdtemp, readFile, writeFile, mkdir, access } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import { parse as yamlParse } from "yaml";
+import { aspectToDims, buildEmptyRootHtml, buildHyperframesConfig, buildHyperframesMeta, buildProjectClaudeMd, buildSceneGitignore, defaultVibeProjectConfig, mergeHyperframesConfig, scaffoldSceneProject, } from "./scene-project.js";
+async function makeTmp(label = "vibe-scene-test-") {
+    return mkdtemp(join(tmpdir(), label));
+}
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+describe("aspectToDims", () => {
+    it.each([
+        ["16:9", 1920, 1080],
+        ["9:16", 1080, 1920],
+        ["1:1", 1080, 1080],
+        ["4:5", 1080, 1350],
+    ])("%s → %dx%d", (ratio, w, h) => {
+        expect(aspectToDims(ratio)).toEqual({ width: w, height: h });
+    });
+});
+describe("buildHyperframesConfig", () => {
+    it("produces the shape expected by hyperframes CLI", () => {
+        const cfg = buildHyperframesConfig();
+        expect(cfg.$schema).toContain("hyperframes.json");
+        expect(cfg.paths).toEqual({
+            blocks: "compositions",
+            components: "compositions/components",
+            assets: "assets",
+        });
+    });
+});
+describe("buildHyperframesMeta", () => {
+    it("uses project name as both id and name", () => {
+        const meta = buildHyperframesMeta("my-video", new Date("2026-04-25T00:00:00Z"));
+        expect(meta).toEqual({
+            id: "my-video",
+            name: "my-video",
+            createdAt: "2026-04-25T00:00:00.000Z",
+        });
+    });
+});
+describe("mergeHyperframesConfig", () => {
+    it("preserves existing top-level keys", () => {
+        const existing = {
+            $schema: "custom-schema",
+            registry: "https://my.registry/",
+            customField: "user-value",
+        };
+        const merged = mergeHyperframesConfig(existing, buildHyperframesConfig());
+        expect(merged.$schema).toBe("custom-schema");
+        expect(merged.registry).toBe("https://my.registry/");
+        expect(merged.customField).toBe("user-value");
+    });
+    it("shallow-merges nested paths preserving user keys", () => {
+        const existing = {
+            paths: { blocks: "custom-blocks", assets: "media" },
+        };
+        const merged = mergeHyperframesConfig(existing, buildHyperframesConfig());
+        expect(merged.paths).toEqual({
+            blocks: "custom-blocks", // preserved
+            components: "compositions/components", // from defaults
+            assets: "media", // preserved
+        });
+    });
+    it("falls back to defaults when existing is empty", () => {
+        const merged = mergeHyperframesConfig({}, buildHyperframesConfig());
+        expect(merged).toEqual(buildHyperframesConfig());
+    });
+});
+describe("buildEmptyRootHtml", () => {
+    it("embeds aspect-correct canvas dimensions", () => {
+        const html = buildEmptyRootHtml({ aspect: "9:16", duration: 12 });
+        expect(html).toContain("width: 1080px");
+        expect(html).toContain("height: 1920px");
+        expect(html).toContain('data-duration="12"');
+        expect(html).toContain('data-composition-id="main"');
+    });
+    it("registers a paused main timeline", () => {
+        const html = buildEmptyRootHtml({ aspect: "16:9", duration: 5 });
+        expect(html).toContain('window.__timelines["main"] = gsap.timeline({ paused: true });');
+    });
+});
+describe("buildProjectClaudeMd", () => {
+    it("names the project and references both toolchains", () => {
+        const md = buildProjectClaudeMd("my-promo");
+        expect(md).toContain("# my-promo");
+        expect(md).toContain("/vibe-scene");
+        expect(md).toContain("/hyperframes");
+        expect(md).toContain("vibe scene add");
+        expect(md).toContain("npx hyperframes");
+    });
+});
+describe("buildSceneGitignore", () => {
+    it("excludes caches and rendered outputs", () => {
+        const out = buildSceneGitignore();
+        expect(out).toContain(".vibeframe/cache/");
+        expect(out).toContain("renders/*.mp4");
+    });
+});
+describe("defaultVibeProjectConfig", () => {
+    it("produces sane defaults", () => {
+        const cfg = defaultVibeProjectConfig("promo");
+        expect(cfg.name).toBe("promo");
+        expect(cfg.aspect).toBe("16:9");
+        expect(cfg.defaultSceneDuration).toBe(5);
+        expect(cfg.providers).toEqual({ image: null, tts: null, transcribe: null });
+        expect(cfg.budget.maxUsd).toBe(0);
+    });
+});
+describe("scaffoldSceneProject", () => {
+    it("creates all expected files in an empty directory", async () => {
+        const dir = await makeTmp();
+        const result = await scaffoldSceneProject({
+            dir,
+            name: "fixture",
+            aspect: "16:9",
+            duration: 8,
+            now: new Date("2026-04-25T00:00:00Z"),
+        });
+        const expected = [
+            "hyperframes.json",
+            "meta.json",
+            "index.html",
+            "vibe.project.yaml",
+            "CLAUDE.md",
+            ".gitignore",
+        ];
+        for (const f of expected) {
+            expect(await pathExists(resolve(dir, f))).toBe(true);
+        }
+        expect(await pathExists(resolve(dir, "compositions"))).toBe(true);
+        expect(await pathExists(resolve(dir, "assets"))).toBe(true);
+        expect(result.created.length).toBe(expected.length);
+        expect(result.merged).toEqual([]);
+        expect(result.skipped).toEqual([]);
+    });
+    it("vibe.project.yaml parses as valid YAML and carries the chosen aspect", async () => {
+        const dir = await makeTmp();
+        await scaffoldSceneProject({ dir, name: "fixture", aspect: "9:16", duration: 10 });
+        const raw = await readFile(resolve(dir, "vibe.project.yaml"), "utf-8");
+        const parsed = yamlParse(raw);
+        expect(parsed).toMatchObject({
+            name: "fixture",
+            aspect: "9:16",
+            defaultSceneDuration: 5,
+            providers: { image: null, tts: null, transcribe: null },
+        });
+    });
+    it("is idempotent: running twice is a no-op (no overwrites of user-editable files)", async () => {
+        const dir = await makeTmp();
+        const first = await scaffoldSceneProject({ dir, name: "fixture" });
+        const claudeBefore = await readFile(resolve(dir, "CLAUDE.md"), "utf-8");
+        // User edits CLAUDE.md
+        await writeFile(resolve(dir, "CLAUDE.md"), claudeBefore + "\n\n## My notes\n\nHand-written.\n", "utf-8");
+        const second = await scaffoldSceneProject({ dir, name: "fixture" });
+        const claudeAfter = await readFile(resolve(dir, "CLAUDE.md"), "utf-8");
+        // CLAUDE.md edit survives.
+        expect(claudeAfter).toContain("Hand-written.");
+        // Second run reports every non-hyperframes.json file as skipped.
+        expect(second.created).toEqual([]);
+        expect(second.skipped.length).toBeGreaterThan(0);
+        // hyperframes.json is always merge-updated (idempotent shape).
+        expect(second.merged.map((p) => p.split("/").pop())).toContain("hyperframes.json");
+        // First run created hyperframes.json; second merged it.
+        expect(first.created.map((p) => p.split("/").pop())).toContain("hyperframes.json");
+    });
+    it("preserves user keys in existing hyperframes.json (merge, not overwrite)", async () => {
+        const dir = await makeTmp();
+        await mkdir(dir, { recursive: true });
+        // Pre-seed a Hyperframes project with custom paths + user field.
+        const preExisting = {
+            $schema: "https://hyperframes.heygen.com/schema/hyperframes.json",
+            paths: { blocks: "custom-blocks", assets: "media" },
+            userField: "kept",
+        };
+        await writeFile(resolve(dir, "hyperframes.json"), JSON.stringify(preExisting, null, 2) + "\n", "utf-8");
+        const result = await scaffoldSceneProject({ dir, name: "fixture" });
+        const merged = JSON.parse(await readFile(resolve(dir, "hyperframes.json"), "utf-8"));
+        expect(merged.userField).toBe("kept");
+        expect(merged.paths.blocks).toBe("custom-blocks");
+        expect(merged.paths.assets).toBe("media");
+        // Default key backfilled:
+        expect(merged.paths.components).toBe("compositions/components");
+        expect(result.merged.some((p) => p.endsWith("hyperframes.json"))).toBe(true);
+    });
+    it("creates index.html with the correct aspect", async () => {
+        const dir = await makeTmp();
+        await scaffoldSceneProject({ dir, name: "fixture", aspect: "1:1", duration: 6 });
+        const html = await readFile(resolve(dir, "index.html"), "utf-8");
+        expect(html).toContain("width: 1080px");
+        expect(html).toContain("height: 1080px");
+        expect(html).toContain('data-duration="6"');
+    });
+});
+//# sourceMappingURL=scene-project.test.js.map

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

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

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

@@ -0,0 +1,79 @@
+/**
+ * @module _shared/scene-render
+ *
+ * Render a VibeFrame scene project to MP4/WebM/MOV using the Hyperframes
+ * producer directly. Unlike the FFmpeg-bridge backend in
+ * `pipeline/renderers/hyperframes.ts` which has to convert a `TimelineState`
+ * into a temp Hyperframes project, scene projects already ARE Hyperframes
+ * projects — so we hand the producer the user's project dir and entry file
+ * verbatim.
+ *
+ * `executeSceneRender()` is decoupled from CLI flags so that the C6 agent
+ * tool and the C5 `--format scenes` pipeline can call it the same way. It
+ * returns a structured result instead of throwing or exiting.
+ */
+import { type RenderConfig } from "@hyperframes/producer";
+export type RenderFps = 24 | 30 | 60;
+export type RenderQuality = "draft" | "standard" | "high";
+export type RenderFormat = "mp4" | "webm" | "mov";
+export interface SceneRenderOptions {
+    /** Project directory (defaults to cwd). */
+    projectDir?: string;
+    /** Root composition file relative to projectDir (default: "index.html"). */
+    root?: string;
+    /** Output file. When relative, resolved against projectDir. Default:
+     *  `renders/<projectName>-<isoStamp>.<format>`. */
+    output?: string;
+    fps?: RenderFps;
+    quality?: RenderQuality;
+    format?: RenderFormat;
+    /** Hyperframes capture worker count. Default 1 (the existing backend's
+     *  default — auto-worker mode times out on small comps). */
+    workers?: number;
+    signal?: AbortSignal;
+    onProgress?: (pct: number, stage: string) => void;
+}
+export interface SceneRenderResult {
+    success: boolean;
+    outputPath?: string;
+    durationMs?: number;
+    framesRendered?: number;
+    totalFrames?: number;
+    fps?: RenderFps;
+    quality?: RenderQuality;
+    format?: RenderFormat;
+    error?: string;
+}
+/** Map a quality preset to an x264 CRF (lower = higher quality). */
+export declare function qualityToCrf(quality?: RenderQuality): number;
+/**
+ * Compute the default output path for a render. Pure — does no I/O. Returns
+ * an absolute path under `<projectDir>/renders/`.
+ *
+ * `now` is injectable so tests get deterministic output.
+ */
+export declare function defaultOutputPath(opts: {
+    projectDir: string;
+    projectName?: string;
+    format?: RenderFormat;
+    now?: Date;
+}): string;
+/**
+ * Build the producer's `RenderConfig` from caller options. Pure — useful for
+ * unit tests that want to assert defaults without touching Chrome.
+ */
+export declare function buildRenderConfig(opts: {
+    fps?: RenderFps;
+    quality?: RenderQuality;
+    format?: RenderFormat;
+    workers?: number;
+    entryFile?: string;
+}): RenderConfig;
+/**
+ * Render a scene project. Mirrors the contract of the existing Hyperframes
+ * backend (preflight → execute → structured result), but skips the
+ * `TimelineState` → temp project conversion because the user's project is
+ * already a valid Hyperframes project.
+ */
+export declare function executeSceneRender(opts?: SceneRenderOptions): Promise<SceneRenderResult>;
+//# sourceMappingURL=scene-render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scene-render.d.ts","sourceRoot":"","sources":["../../../src/commands/_shared/scene-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAI/B,MAAM,MAAM,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACrC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;uDACmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;gEAC4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAA0B,GAAG,MAAM,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,MAAM,CAST;AAmBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,YAAY,CAUf;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+DlG"}