videoclaw 3.0.0-alpha.1

package/dist/video/music-video.js

@@ -0,0 +1,190 @@
+/**
+ * music-video.ts — the vocal-synced, beat-exact music-video ASSEMBLER (the crown
+ * jewel of the music-video lane). It turns a config (song + performer clips +
+ * B-roll pools) into a finished cut whose performers land on their own vocals and
+ * whose lips stay locked to the muxed song, with zero cumulative drift.
+ *
+ * This is a FULLY LOCAL assembler — no provider, no spend, only ffmpeg (already a
+ * dependency). It composes the lane's pure pieces:
+ *   buildVocalMap (transcript → rap/hook/instrumental/outro)  [or an explicit map]
+ *     → planVocalSync (performer-on-vocal, time-aligned, de-patterned B-roll)
+ *       → buildSegmentCutArgs (frame-exact `-frames:v` cut per segment)
+ *         → concat demuxer (-c copy) → ONE grade pass + mux the song.
+ *
+ * {@link buildMusicVideoPlan} is PURE (clip durations are injected via the config)
+ * so the whole plan — every segment, every ffmpeg invocation — is unit-testable
+ * offline. {@link runMusicVideo} is the thin execution shell: it writes the concat
+ * list, spawns each step, then asserts the built master matches the planned
+ * duration within one frame ({@link assertNoDrift}) so sync can never silently
+ * regress. Dry-run returns the plan without spawning.
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import { buildVocalMap, validateVocalMap, } from './vocal-map.js';
+import { planVocalSync, plannedDuration, } from './vocal-sync-plan.js';
+import { buildSegmentCutArgs, assertNoDrift, CUT_DEFAULT_WIDTH, CUT_DEFAULT_HEIGHT, } from './assemble/cut-segment.js';
+import { TARGET_FPS } from './assemble/animate-slides.js';
+import { resolveGradeFilter, buildConcatListContent } from './assemble/stitch.js';
+import { runFfmpeg, ffprobeDuration } from './assemble/ffmpeg.js';
+/** Attach the per-type performer clip to every vocal section of an auto-built map. */
+function attachPerformers(map, performers) {
+    if (!performers)
+        return map;
+    return map.map((s) => {
+        const clip = s.type === 'rap' ? performers.rap : s.type === 'hook' ? performers.hook : undefined;
+        return clip ? { ...s, performerClip: clip } : s;
+    });
+}
+/**
+ * Build the full, frame-exact assembly plan. PURE — no fs, no spawn. `workDir` is
+ * only used to compute step output paths; nothing is written here. Throws if a
+ * referenced clip id is missing from the registry or the vocal map is invalid.
+ */
+export function buildMusicVideoPlan(config, workDir) {
+    const fps = config.fps ?? TARGET_FPS;
+    const width = config.width ?? CUT_DEFAULT_WIDTH;
+    const height = config.height ?? CUT_DEFAULT_HEIGHT;
+    const grade = resolveGradeFilter(config.grade);
+    // 1. resolve the vocal map (explicit wins; else auto-classify + attach performers).
+    let vocalMap;
+    if (config.vocalMap && config.vocalMap.length > 0) {
+        vocalMap = config.vocalMap;
+    }
+    else {
+        if (!config.transcript) {
+            throw new Error('buildMusicVideoPlan: config needs either vocalMap or transcript.');
+        }
+        const auto = buildVocalMap(config.transcript, {
+            songEnd: config.songEnd,
+            ...(config.hookKeywords ? { hookKeywords: config.hookKeywords } : {}),
+        });
+        vocalMap = attachPerformers(auto, config.performers);
+    }
+    const issues = validateVocalMap(vocalMap, config.songEnd);
+    if (issues.length > 0) {
+        throw new Error(`buildMusicVideoPlan: invalid vocal map: ${issues.join('; ')}`);
+    }
+    // 2. clip registry → duration lookup + path lookup (pure planner inputs).
+    const byId = new Map(config.clips.map((c) => [c.id, c]));
+    const clipDuration = (id) => {
+        const c = byId.get(id);
+        if (!c)
+            throw new Error(`buildMusicVideoPlan: clip "${id}" referenced but not in the registry.`);
+        return c.durationSec;
+    };
+    const clipPath = (id) => {
+        const c = byId.get(id);
+        if (!c)
+            throw new Error(`buildMusicVideoPlan: clip "${id}" referenced but not in the registry.`);
+        return c.path;
+    };
+    // 3. plan the vocal-synced segment list.
+    const segments = planVocalSync({
+        vocalMap,
+        beats: config.beats ?? [],
+        songEnd: config.songEnd,
+        pools: config.pools,
+        clipDuration,
+        fps,
+        ...(config.cutLengths ? { cutLengths: config.cutLengths } : {}),
+    });
+    if (segments.length === 0) {
+        throw new Error('buildMusicVideoPlan: planner produced no segments (check pools/vocal map).');
+    }
+    // 4. compile the ffmpeg steps: frame-exact cut per segment → concat → grade + mux.
+    const segmentDir = path.join(workDir, 'segments');
+    const concatVideo = path.join(workDir, 'concat-silent.mp4');
+    const concatListPath = path.join(workDir, 'concat-list.txt');
+    const output = config.output ?? path.join(workDir, 'master.mp4');
+    const steps = [];
+    const segmentPaths = [];
+    segments.forEach((seg, i) => {
+        const outputPath = path.join(segmentDir, `seg-${String(i).padStart(4, '0')}.mp4`);
+        segmentPaths.push(outputPath);
+        steps.push({
+            kind: 'segment-cut',
+            label: `cut ${i} ${seg.performer ? 'performer' : 'b-roll'} ${seg.clip} @${seg.inSec}s ×${seg.durationSec}s`,
+            args: buildSegmentCutArgs({
+                clipPath: clipPath(seg.clip),
+                inSeconds: seg.inSec,
+                durationSec: seg.durationSec,
+                outputPath,
+                width,
+                height,
+                fps,
+                keepAudio: false,
+            }),
+        });
+    });
+    steps.push({
+        kind: 'concat-demuxer',
+        label: `concat ${segmentPaths.length} segments (-c copy)`,
+        concatListContent: buildConcatListContent(segmentPaths),
+        concatListPath,
+        args: ['-nostdin', '-f', 'concat', '-safe', '0', '-i', concatListPath, '-c', 'copy', concatVideo],
+    });
+    // ONE grade pass + mux the song as the full audio track. Re-encode video only
+    // when a grade is applied; otherwise copy the concatenated video stream.
+    const gradeMuxArgs = ['-nostdin', '-i', concatVideo, '-i', config.song];
+    if (grade) {
+        gradeMuxArgs.push('-vf', grade, '-c:v', 'libx264', '-crf', '18', '-preset', 'medium', '-pix_fmt', 'yuv420p');
+    }
+    else {
+        gradeMuxArgs.push('-c:v', 'copy');
+    }
+    gradeMuxArgs.push('-map', '0:v:0', '-map', '1:a:0', '-c:a', 'aac', '-b:a', '192k', '-shortest', output);
+    steps.push({
+        kind: 'grade-mux',
+        label: grade ? `grade (${config.grade}) + mux song` : 'mux song (no grade)',
+        args: gradeMuxArgs,
+    });
+    return {
+        schemaVersion: 1,
+        vocalMap,
+        segments,
+        plannedDurationSec: plannedDuration(segments),
+        width,
+        height,
+        fps,
+        grade,
+        steps,
+        segmentDir,
+        concatVideo,
+        output,
+    };
+}
+/**
+ * Execute the assembly plan: mkdir the work dirs, run every step in order, write
+ * the concat list before its step, then assert the built master matches the plan
+ * within one frame. On `dryRun`, returns the planned metrics without touching disk.
+ */
+export async function runMusicVideo(plan, opts = {}) {
+    const performerCuts = plan.segments.filter((s) => s.performer).length;
+    const base = {
+        output: plan.output,
+        plannedDurationSec: plan.plannedDurationSec,
+        segmentCount: plan.segments.length,
+        performerCuts,
+        brollCuts: plan.segments.length - performerCuts,
+        grade: plan.grade,
+    };
+    if (opts.dryRun) {
+        return { ...base, builtDurationSec: plan.plannedDurationSec, dryRun: true };
+    }
+    await fs.mkdir(plan.segmentDir, { recursive: true });
+    await fs.mkdir(path.dirname(plan.output), { recursive: true });
+    for (const step of plan.steps) {
+        if (step.concatListContent && step.concatListPath) {
+            await fs.writeFile(step.concatListPath, step.concatListContent, 'utf8');
+        }
+        await runFfmpeg(step.args, { ...(opts.ffmpegBin ? { ffmpegBin: opts.ffmpegBin } : {}) });
+    }
+    let builtDurationSec = plan.plannedDurationSec;
+    if (!opts.skipDriftCheck) {
+        const ms = await ffprobeDuration(plan.output, { ...(opts.ffprobeBin ? { ffprobeBin: opts.ffprobeBin } : {}) });
+        builtDurationSec = ms / 1000;
+        assertNoDrift(plan.plannedDurationSec, builtDurationSec, plan.fps);
+    }
+    return { ...base, builtDurationSec, dryRun: false };
+}
+//# sourceMappingURL=music-video.js.map

package/dist/video/music-video.js.map

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

package/dist/video/narrate.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Narration (TTS) generation.
+ *
+ * `generateNarration` synthesizes a single narration clip for a project from a
+ * text script via a TTS backend (from the audio-platform registry), writes the
+ * audio to `projects/<slug>/artifacts/audio/narration.wav`, and persists a
+ * `narration.json` artifact describing it. When a `videoDurationMs` is supplied,
+ * the artifact also embeds a pure `planNarrationFit()` plan (atempo / loop-video
+ * timing) so a downstream assemble step can fit the narration to the video bed.
+ *
+ * Pure-ish: `env` and `fetcher` are threaded through to the backend so tests
+ * run fully offline with no real keys or network. Throws `tts_failed` when no
+ * requested/available TTS backend can run.
+ */
+import type { NarrationFitPlan } from './assemble/narration-fit.js';
+export declare const NARRATION_SCHEMA_VERSION = 1;
+export interface NarrationArtifact {
+    schemaVersion: typeof NARRATION_SCHEMA_VERSION;
+    projectSlug: string;
+    generatedAt: string;
+    backendId: string;
+    voice?: string;
+    text: string;
+    /** Project-relative path to the generated narration audio. */
+    path: string;
+    durationMs: number;
+    /**
+     * Backends that failed (in order) before `backendId` succeeded, when the
+     * automatic fallback chain was used. Omitted when the first backend succeeded
+     * or an explicit `--backend` was given (explicit selection never falls back).
+     */
+    fallbackFrom?: string[];
+    /** Present only when a videoDurationMs was supplied. */
+    fit?: NarrationFitPlan;
+}
+export interface GenerateNarrationOptions {
+    workspaceRoot: string;
+    slug: string;
+    text: string;
+    voice?: string;
+    /** Restrict to this backend id (defaults to the first AVAILABLE backend). */
+    backendId?: string;
+    /** When given, embed a planNarrationFit() plan in the artifact. */
+    videoDurationMs?: number;
+    dryRun?: boolean;
+    env?: NodeJS.ProcessEnv;
+    fetcher?: typeof fetch;
+}
+export declare function narrationArtifactPathFor(root: string, slug: string): string;
+export declare function narrationAudioDirFor(root: string, slug: string): string;
+export declare function readNarrationArtifact(root: string, slug: string): Promise<NarrationArtifact | null>;
+/**
+ * Generate a single narration clip + persist the `narration.json` artifact.
+ * Returns the written artifact. Throws `tts_failed` when no requested/available
+ * TTS backend can run.
+ */
+export declare function generateNarration(options: GenerateNarrationOptions): Promise<NarrationArtifact>;
+//# sourceMappingURL=narrate.d.ts.map

package/dist/video/narrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrate.d.ts","sourceRoot":"","sources":["../../src/video/narrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgBH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,OAAO,wBAAwB,CAAC;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,wDAAwD;IACxD,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAInC;AAaD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAsH5B"}

package/dist/video/narrate.js

@@ -0,0 +1,145 @@
+/**
+ * Narration (TTS) generation.
+ *
+ * `generateNarration` synthesizes a single narration clip for a project from a
+ * text script via a TTS backend (from the audio-platform registry), writes the
+ * audio to `projects/<slug>/artifacts/audio/narration.wav`, and persists a
+ * `narration.json` artifact describing it. When a `videoDurationMs` is supplied,
+ * the artifact also embeds a pure `planNarrationFit()` plan (atempo / loop-video
+ * timing) so a downstream assemble step can fit the narration to the video bed.
+ *
+ * Pure-ish: `env` and `fetcher` are threaded through to the backend so tests
+ * run fully offline with no real keys or network. Throws `tts_failed` when no
+ * requested/available TTS backend can run.
+ */
+import { mkdir, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname, join, relative, resolve } from 'node:path';
+import { resolveProjectWorkspace } from './workspace.js';
+import { appendProjectEvent } from './events.js';
+import { writeTextFileAtomic } from './atomic-write.js';
+import { VclawError } from './errors.js';
+import { getTtsBackend, listAvailableTtsBackends, isTtsBackendAvailable, } from './audio-platform/registry.js';
+import { planNarrationFit } from './assemble/narration-fit.js';
+export const NARRATION_SCHEMA_VERSION = 1;
+export function narrationArtifactPathFor(root, slug) {
+    return join(resolveProjectWorkspace(slug, root).projectDir, 'artifacts', 'narration.json');
+}
+export function narrationAudioDirFor(root, slug) {
+    return join(resolveProjectWorkspace(slug, root).projectDir, 'artifacts', 'audio');
+}
+export async function readNarrationArtifact(root, slug) {
+    const path = narrationArtifactPathFor(root, slug);
+    if (!existsSync(path))
+        return null;
+    return JSON.parse(await readFile(path, 'utf-8'));
+}
+async function writeNarrationArtifact(root, slug, artifact) {
+    const path = narrationArtifactPathFor(root, slug);
+    await mkdir(dirname(path), { recursive: true });
+    await writeTextFileAtomic(path, `${JSON.stringify(artifact, null, 2)}\n`);
+    return path;
+}
+/**
+ * Generate a single narration clip + persist the `narration.json` artifact.
+ * Returns the written artifact. Throws `tts_failed` when no requested/available
+ * TTS backend can run.
+ */
+export async function generateNarration(options) {
+    const { workspaceRoot, slug, text } = options;
+    const env = options.env ?? process.env;
+    if (!text.trim()) {
+        throw new VclawError('tts_failed', 'Cannot generate narration with empty text.', { slug });
+    }
+    const available = listAvailableTtsBackends(env);
+    // Resolve the candidate chain. An explicit `--backend` is honored strictly
+    // (looked up + gated on availability) and NEVER falls back. Without one, we
+    // try every available backend in registry order (gemini-tts first, then
+    // elevenlabs-tts) so narration still succeeds when the preferred backend
+    // fails at RUNTIME — e.g. gemini-tts 403s when the Gemini `generativelanguage`
+    // API isn't enabled on the key's project even though the key is present.
+    let candidates;
+    if (options.backendId) {
+        const named = getTtsBackend(options.backendId); // throws on unknown id
+        if (!isTtsBackendAvailable(named, env)) {
+            throw new VclawError('tts_failed', `TTS backend '${named.id}' is not available. Set a Gemini API key (GEMINI_API_KEYS / GOOGLE_API_KEYS / GOOGLE_API_KEY) or ELEVENLABS_API_KEY.`, { slug, requested: named.id, available: available.map((b) => b.id) });
+        }
+        candidates = [named];
+    }
+    else {
+        candidates = available;
+    }
+    if (candidates.length === 0) {
+        throw new VclawError('tts_failed', 'No TTS backend is available. Set a Gemini API key (GEMINI_API_KEYS / GOOGLE_API_KEYS / GOOGLE_API_KEY) or ELEVENLABS_API_KEY.', { slug, requested: options.backendId ?? null, available: available.map((b) => b.id) });
+    }
+    const workspace = resolveProjectWorkspace(slug, workspaceRoot);
+    const projectRoot = resolve(workspace.projectDir);
+    const audioDir = narrationAudioDirFor(workspaceRoot, slug);
+    await mkdir(audioDir, { recursive: true });
+    // Try each candidate in order; the first that synthesizes wins. A failure is
+    // recorded (for the `fallbackFrom` trail) and the next candidate is tried.
+    let result;
+    const failedBackends = [];
+    const attemptErrors = [];
+    for (const backend of candidates) {
+        // Extension follows the backend's actual output format (wav for gemini-tts,
+        // mp3 for elevenlabs-tts) so the file name matches its bytes.
+        const outputPath = join(audioDir, `narration.${backend.outputExtension ?? 'wav'}`);
+        try {
+            result = await backend.generate({
+                text,
+                ...(options.voice ? { voice: options.voice } : {}),
+                outputPath,
+                ...(options.dryRun !== undefined ? { dryRun: options.dryRun } : {}),
+                env,
+                ...(options.fetcher ? { fetcher: options.fetcher } : {}),
+            });
+            break;
+        }
+        catch (err) {
+            failedBackends.push(backend.id);
+            attemptErrors.push({
+                backendId: backend.id,
+                message: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    if (!result) {
+        throw new VclawError('tts_failed', `All TTS backend(s) failed: ${attemptErrors.map((e) => `${e.backendId} (${e.message})`).join('; ')}`, { slug, attempts: attemptErrors, candidates: candidates.map((b) => b.id) });
+    }
+    const fallbackFrom = failedBackends.length > 0 ? failedBackends : undefined;
+    const rel = relative(projectRoot, resolve(result.path)).replaceAll('\\', '/');
+    let fit;
+    if (options.videoDurationMs !== undefined) {
+        fit = planNarrationFit({
+            voiceDurationMs: result.durationMs,
+            videoDurationMs: options.videoDurationMs,
+        });
+    }
+    const artifact = {
+        schemaVersion: NARRATION_SCHEMA_VERSION,
+        projectSlug: slug,
+        generatedAt: new Date().toISOString(),
+        backendId: result.backendId,
+        ...(options.voice ? { voice: options.voice } : {}),
+        text,
+        path: rel,
+        durationMs: result.durationMs,
+        ...(fallbackFrom ? { fallbackFrom } : {}),
+        ...(fit ? { fit } : {}),
+    };
+    await writeNarrationArtifact(workspaceRoot, slug, artifact);
+    if (existsSync(workspace.eventsPath) || existsSync(workspace.eventsDir)) {
+        await appendProjectEvent(workspace, {
+            type: 'narration.generated',
+            payload: {
+                backendId: result.backendId,
+                durationMs: result.durationMs,
+                dryRun: options.dryRun ?? false,
+                ...(fallbackFrom ? { fallbackFrom } : {}),
+            },
+        });
+    }
+    return artifact;
+}
+//# sourceMappingURL=narrate.js.map

package/dist/video/narrate.js.map

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

package/dist/video/native-dreamina.d.ts

@@ -0,0 +1,35 @@
+import type { VideoExecutionCancelResult, VideoExecutionPayload, VideoExecutionPollResult } from './types.js';
+interface FetchLikeResponse {
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+type FetchLike = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string | Uint8Array;
+}) => Promise<FetchLikeResponse>;
+export declare function submitDreaminaUseApiNative(payload: VideoExecutionPayload, options?: {
+    env?: NodeJS.ProcessEnv;
+    fetchImpl?: FetchLike;
+}): Promise<{
+    externalJobId: string;
+    rawResult: unknown;
+}>;
+export declare function pollDreaminaUseApiNative(input: {
+    outputDir: string;
+    externalJobId: string;
+    workspaceRoot: string;
+}, options?: {
+    env?: NodeJS.ProcessEnv;
+    fetchImpl?: FetchLike;
+}): Promise<VideoExecutionPollResult>;
+export declare function cancelDreaminaUseApiNative(input: {
+    outputDir: string;
+    externalJobId: string;
+    workspaceRoot: string;
+}): Promise<VideoExecutionCancelResult>;
+export {};
+//# sourceMappingURL=native-dreamina.d.ts.map

package/dist/video/native-dreamina.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-dreamina.d.ts","sourceRoot":"","sources":["../../src/video/native-dreamina.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAoB9G,UAAU,iBAAiB;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACrC;AAED,KAAK,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;CAC5B,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AA2QjC,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,qBAAqB,EAC9B,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;CAClB,GACL,OAAO,CAAC;IACT,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC,CAgKD;AA0CD,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,EACD,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;CAClB,GACL,OAAO,CAAC,wBAAwB,CAAC,CAwEnC;AAED,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC,0BAA0B,CAAC,CAqBrC"}