@hyperframes/engine 0.1.1 → 0.1.2

package/dist/services/videoFrameExtractor.js

@@ -1,302 +0,0 @@
-/**
- * Video Frame Extractor Service
- *
- * Pre-extracts video frames using FFmpeg for frame-accurate rendering.
- * Videos are replaced with <img> elements during capture.
- */
-import { spawn } from "child_process";
-import { existsSync, mkdirSync, readdirSync, rmSync } from "fs";
-import { join } from "path";
-import { parseHTML } from "linkedom";
-import { extractVideoMetadata } from "../utils/ffprobe.js";
-import { downloadToTemp, isHttpUrl } from "../utils/urlDownloader.js";
-import { DEFAULT_CONFIG } from "../config.js";
-export function parseVideoElements(html) {
-    const videos = [];
-    const { document } = parseHTML(html);
-    const videoEls = document.querySelectorAll("video[id][src]");
-    for (const el of videoEls) {
-        const id = el.getAttribute("id");
-        const src = el.getAttribute("src");
-        if (!id || !src)
-            continue;
-        const startAttr = el.getAttribute("data-start");
-        const endAttr = el.getAttribute("data-end");
-        const mediaStartAttr = el.getAttribute("data-media-start");
-        const hasAudioAttr = el.getAttribute("data-has-audio");
-        videos.push({
-            id,
-            src,
-            start: startAttr ? parseFloat(startAttr) : 0,
-            end: endAttr ? parseFloat(endAttr) : 0,
-            mediaStart: mediaStartAttr ? parseFloat(mediaStartAttr) : 0,
-            hasAudio: hasAudioAttr === "true",
-        });
-    }
-    return videos;
-}
-export async function extractVideoFramesRange(videoPath, videoId, startTime, duration, options, signal, config) {
-    const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
-    const { fps, outputDir, quality = 95, format = "jpg" } = options;
-    const videoOutputDir = join(outputDir, videoId);
-    if (!existsSync(videoOutputDir))
-        mkdirSync(videoOutputDir, { recursive: true });
-    const metadata = await extractVideoMetadata(videoPath);
-    const framePattern = `frame_%05d.${format}`;
-    const outputPattern = join(videoOutputDir, framePattern);
-    const args = [
-        "-ss",
-        String(startTime),
-        "-i",
-        videoPath,
-        "-t",
-        String(duration),
-        "-vf",
-        `fps=${fps}`,
-        "-q:v",
-        format === "jpg" ? String(Math.ceil((100 - quality) / 3)) : "0",
-    ];
-    if (format === "png")
-        args.push("-compression_level", "6");
-    args.push("-y", outputPattern);
-    return new Promise((resolve, reject) => {
-        const ffmpeg = spawn("ffmpeg", args);
-        let stderr = "";
-        const onAbort = () => {
-            ffmpeg.kill("SIGTERM");
-        };
-        if (signal) {
-            if (signal.aborted) {
-                ffmpeg.kill("SIGTERM");
-            }
-            else {
-                signal.addEventListener("abort", onAbort, { once: true });
-            }
-        }
-        const timer = setTimeout(() => {
-            ffmpeg.kill("SIGTERM");
-        }, ffmpegProcessTimeout);
-        ffmpeg.stderr.on("data", (data) => {
-            stderr += data.toString();
-        });
-        ffmpeg.on("close", (code) => {
-            clearTimeout(timer);
-            if (signal)
-                signal.removeEventListener("abort", onAbort);
-            if (signal?.aborted) {
-                reject(new Error("Video frame extraction cancelled"));
-                return;
-            }
-            if (code !== 0) {
-                reject(new Error(`FFmpeg exited with code ${code}: ${stderr.slice(-500)}`));
-                return;
-            }
-            const framePaths = new Map();
-            const files = readdirSync(videoOutputDir)
-                .filter((f) => f.startsWith("frame_") && f.endsWith(`.${format}`))
-                .sort();
-            files.forEach((file, index) => {
-                framePaths.set(index, join(videoOutputDir, file));
-            });
-            resolve({
-                videoId,
-                srcPath: videoPath,
-                outputDir: videoOutputDir,
-                framePattern,
-                fps,
-                totalFrames: framePaths.size,
-                metadata,
-                framePaths,
-            });
-        });
-        ffmpeg.on("error", (err) => {
-            clearTimeout(timer);
-            if (signal)
-                signal.removeEventListener("abort", onAbort);
-            if (err.code === "ENOENT") {
-                reject(new Error("[FFmpeg] ffmpeg not found"));
-            }
-            else {
-                reject(err);
-            }
-        });
-    });
-}
-export async function extractAllVideoFrames(videos, baseDir, options, signal, config) {
-    const startTime = Date.now();
-    const extracted = [];
-    const errors = [];
-    let totalFramesExtracted = 0;
-    // Process videos in parallel for better performance
-    const results = await Promise.all(videos.map(async (video) => {
-        if (signal?.aborted) {
-            throw new Error("Video frame extraction cancelled");
-        }
-        try {
-            let videoPath = video.src;
-            if (!videoPath.startsWith("/") && !isHttpUrl(videoPath)) {
-                videoPath = join(baseDir, videoPath);
-            }
-            if (isHttpUrl(videoPath)) {
-                const downloadDir = join(options.outputDir, "_downloads");
-                mkdirSync(downloadDir, { recursive: true });
-                videoPath = await downloadToTemp(videoPath, downloadDir);
-            }
-            if (!existsSync(videoPath)) {
-                return { error: { videoId: video.id, error: `Video file not found: ${videoPath}` } };
-            }
-            let videoDuration = video.end - video.start;
-            // Fallback: if no data-duration/data-end was specified, probe the actual file
-            if (videoDuration <= 0) {
-                const metadata = await extractVideoMetadata(videoPath);
-                const sourceDuration = metadata.durationSeconds - video.mediaStart;
-                videoDuration = sourceDuration > 0 ? sourceDuration : metadata.durationSeconds;
-                video.end = video.start + videoDuration;
-            }
-            const result = await extractVideoFramesRange(videoPath, video.id, video.mediaStart, videoDuration, options, signal, config);
-            return { result };
-        }
-        catch (err) {
-            return {
-                error: {
-                    videoId: video.id,
-                    error: err instanceof Error ? err.message : String(err),
-                },
-            };
-        }
-    }));
-    // Collect results and errors
-    for (const item of results) {
-        if ("error" in item && item.error) {
-            errors.push(item.error);
-        }
-        else if ("result" in item) {
-            extracted.push(item.result);
-            totalFramesExtracted += item.result.totalFrames;
-        }
-    }
-    return { success: errors.length === 0, extracted, errors, totalFramesExtracted, durationMs: Date.now() - startTime };
-}
-export function getFrameAtTime(extracted, globalTime, videoStart) {
-    const localTime = globalTime - videoStart;
-    if (localTime < 0)
-        return null;
-    const frameIndex = Math.floor(localTime * extracted.fps);
-    if (frameIndex < 0 || frameIndex >= extracted.totalFrames)
-        return null;
-    return extracted.framePaths.get(frameIndex) || null;
-}
-export class FrameLookupTable {
-    videos = new Map();
-    orderedVideos = [];
-    activeVideoIds = new Set();
-    startCursor = 0;
-    lastTime = null;
-    addVideo(extracted, start, end, mediaStart) {
-        this.videos.set(extracted.videoId, { extracted, start, end, mediaStart });
-        this.orderedVideos = Array.from(this.videos.entries())
-            .map(([videoId, video]) => ({ videoId, ...video }))
-            .sort((a, b) => a.start - b.start);
-        this.resetActiveState();
-    }
-    getFrame(videoId, globalTime) {
-        const video = this.videos.get(videoId);
-        if (!video)
-            return null;
-        if (globalTime < video.start || globalTime >= video.end)
-            return null;
-        return getFrameAtTime(video.extracted, globalTime, video.start);
-    }
-    resetActiveState() {
-        this.activeVideoIds.clear();
-        this.startCursor = 0;
-        this.lastTime = null;
-    }
-    refreshActiveSet(globalTime) {
-        if (this.lastTime == null || globalTime < this.lastTime) {
-            this.activeVideoIds.clear();
-            this.startCursor = 0;
-            for (const entry of this.orderedVideos) {
-                if (entry.start <= globalTime && globalTime < entry.end) {
-                    this.activeVideoIds.add(entry.videoId);
-                }
-                if (entry.start <= globalTime) {
-                    this.startCursor += 1;
-                }
-                else {
-                    break;
-                }
-            }
-            this.lastTime = globalTime;
-            return;
-        }
-        while (this.startCursor < this.orderedVideos.length) {
-            const candidate = this.orderedVideos[this.startCursor];
-            if (!candidate)
-                break;
-            if (candidate.start > globalTime) {
-                break;
-            }
-            if (globalTime < candidate.end) {
-                this.activeVideoIds.add(candidate.videoId);
-            }
-            this.startCursor += 1;
-        }
-        for (const videoId of Array.from(this.activeVideoIds)) {
-            const video = this.videos.get(videoId);
-            if (!video || globalTime < video.start || globalTime >= video.end) {
-                this.activeVideoIds.delete(videoId);
-            }
-        }
-        this.lastTime = globalTime;
-    }
-    getActiveFramePayloads(globalTime) {
-        const frames = new Map();
-        this.refreshActiveSet(globalTime);
-        for (const videoId of this.activeVideoIds) {
-            const video = this.videos.get(videoId);
-            if (!video)
-                continue;
-            const localTime = globalTime - video.start;
-            const frameIndex = Math.floor(localTime * video.extracted.fps);
-            if (frameIndex < 0 || frameIndex >= video.extracted.totalFrames)
-                continue;
-            const framePath = video.extracted.framePaths.get(frameIndex);
-            if (!framePath)
-                continue;
-            frames.set(videoId, { framePath, frameIndex });
-        }
-        return frames;
-    }
-    getActiveFrames(globalTime) {
-        const payloads = this.getActiveFramePayloads(globalTime);
-        const frames = new Map();
-        for (const [videoId, payload] of payloads) {
-            frames.set(videoId, payload.framePath);
-        }
-        return frames;
-    }
-    cleanup() {
-        for (const video of this.videos.values()) {
-            if (existsSync(video.extracted.outputDir)) {
-                rmSync(video.extracted.outputDir, { recursive: true, force: true });
-            }
-        }
-        this.videos.clear();
-        this.orderedVideos = [];
-        this.resetActiveState();
-    }
-}
-export function createFrameLookupTable(videos, extracted) {
-    const table = new FrameLookupTable();
-    const extractedMap = new Map();
-    for (const ext of extracted)
-        extractedMap.set(ext.videoId, ext);
-    for (const video of videos) {
-        const ext = extractedMap.get(video.id);
-        if (ext)
-            table.addVideo(ext, video.start, video.end, video.mediaStart);
-    }
-    return table;
-}
-//# sourceMappingURL=videoFrameExtractor.js.map

package/dist/services/videoFrameExtractor.js.map

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

package/dist/services/videoFrameInjector.d.ts

@@ -1,17 +0,0 @@
-/**
- * Video Frame Injector
- *
- * Creates a BeforeCaptureHook that replaces native <video> elements with
- * pre-extracted frame images during rendering. This is the Hyperframes-specific
- * video handling strategy — OSS users with different video pipelines can
- * provide their own hook or skip video injection entirely.
- */
-import { type FrameLookupTable } from "./videoFrameExtractor.js";
-import { type BeforeCaptureHook } from "./frameCapture.js";
-import { type EngineConfig } from "../config.js";
-/**
- * Creates a BeforeCaptureHook that injects pre-extracted video frames
- * into the page, replacing native <video> elements with frame images.
- */
-export declare function createVideoFrameInjector(frameLookup: FrameLookupTable | null, config?: Partial<Pick<EngineConfig, "frameDataUriCacheLimit">>): BeforeCaptureHook | null;
-//# sourceMappingURL=videoFrameInjector.d.ts.map

package/dist/services/videoFrameInjector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"videoFrameInjector.d.ts","sourceRoot":"","sources":["../../src/services/videoFrameInjector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAiDjE;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,gBAAgB,GAAG,IAAI,EACpC,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC,GAC7D,iBAAiB,GAAG,IAAI,CA0C1B"}

package/dist/services/videoFrameInjector.js

@@ -1,92 +0,0 @@
-/**
- * Video Frame Injector
- *
- * Creates a BeforeCaptureHook that replaces native <video> elements with
- * pre-extracted frame images during rendering. This is the Hyperframes-specific
- * video handling strategy — OSS users with different video pipelines can
- * provide their own hook or skip video injection entirely.
- */
-import { promises as fs } from "fs";
-import { injectVideoFramesBatch, syncVideoFrameVisibility } from "./screenshotService.js";
-import { DEFAULT_CONFIG } from "../config.js";
-function createFrameDataUriCache(cacheLimit) {
-    const cache = new Map();
-    const inFlight = new Map();
-    function remember(framePath, dataUri) {
-        if (cache.has(framePath)) {
-            cache.delete(framePath);
-        }
-        cache.set(framePath, dataUri);
-        if (cache.size > cacheLimit) {
-            const oldestKey = cache.keys().next().value;
-            if (oldestKey) {
-                cache.delete(oldestKey);
-            }
-        }
-        return dataUri;
-    }
-    async function get(framePath) {
-        const cached = cache.get(framePath);
-        if (cached) {
-            remember(framePath, cached);
-            return cached;
-        }
-        const existing = inFlight.get(framePath);
-        if (existing) {
-            return existing;
-        }
-        const pending = fs
-            .readFile(framePath)
-            .then((frameData) => {
-            const mimeType = framePath.endsWith(".png") ? "image/png" : "image/jpeg";
-            const dataUri = `data:${mimeType};base64,${frameData.toString("base64")}`;
-            return remember(framePath, dataUri);
-        })
-            .finally(() => {
-            inFlight.delete(framePath);
-        });
-        inFlight.set(framePath, pending);
-        return pending;
-    }
-    return { get };
-}
-/**
- * Creates a BeforeCaptureHook that injects pre-extracted video frames
- * into the page, replacing native <video> elements with frame images.
- */
-export function createVideoFrameInjector(frameLookup, config) {
-    if (!frameLookup)
-        return null;
-    const cacheLimit = Math.max(32, config?.frameDataUriCacheLimit ?? DEFAULT_CONFIG.frameDataUriCacheLimit);
-    const frameCache = createFrameDataUriCache(cacheLimit);
-    const lastInjectedFrameByVideo = new Map();
-    return async (page, time) => {
-        const activePayloads = frameLookup.getActiveFramePayloads(time);
-        const updates = [];
-        const activeIds = new Set();
-        if (activePayloads.size > 0) {
-            const pendingReads = [];
-            for (const [videoId, payload] of activePayloads) {
-                activeIds.add(videoId);
-                const lastFrameIndex = lastInjectedFrameByVideo.get(videoId);
-                if (lastFrameIndex === payload.frameIndex)
-                    continue;
-                pendingReads.push(frameCache.get(payload.framePath).then((dataUri) => ({ videoId, dataUri, frameIndex: payload.frameIndex })));
-            }
-            updates.push(...(await Promise.all(pendingReads)));
-        }
-        for (const videoId of Array.from(lastInjectedFrameByVideo.keys())) {
-            if (!activeIds.has(videoId)) {
-                lastInjectedFrameByVideo.delete(videoId);
-            }
-        }
-        await syncVideoFrameVisibility(page, Array.from(activeIds));
-        if (updates.length > 0) {
-            await injectVideoFramesBatch(page, updates.map((u) => ({ videoId: u.videoId, dataUri: u.dataUri })));
-            for (const update of updates) {
-                lastInjectedFrameByVideo.set(update.videoId, update.frameIndex);
-            }
-        }
-    };
-}
-//# sourceMappingURL=videoFrameInjector.js.map

package/dist/services/videoFrameInjector.js.map

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

package/dist/types.d.ts

@@ -1,79 +0,0 @@
-/**
- * @hyperframes/engine — Protocol Types
- *
- * The engine's page contract. Any web page that wants to be rendered
- * as video must expose `window.__hf` implementing the HfProtocol interface.
- */
-/**
- * Declares a media element the engine should handle.
- *
- * Headless Chrome in BeginFrame mode cannot play <video> or produce audio.
- * The engine pre-extracts video frames and audio tracks from declared media
- * elements and handles injection/mixing automatically.
- */
-export interface HfMediaElement {
-    /** DOM id of the <video> or <audio> element */
-    elementId: string;
-    /** Source file path or URL */
-    src: string;
-    /** When in the composition this element appears (seconds) */
-    startTime: number;
-    /** When in the composition this element disappears (seconds) */
-    endTime: number;
-    /** Offset into the source file (seconds, default: 0) */
-    mediaOffset?: number;
-    /** Audio volume 0-1 (default: 1) */
-    volume?: number;
-    /** Whether this element has audio that should be extracted */
-    hasAudio?: boolean;
-}
-/**
- * The seek protocol. The only contract between the engine and a page.
- *
- * The engine reads `duration` to calculate total frames, calls `seek(time)`
- * before each frame capture, and uses `media` (if provided) to handle
- * video frame injection and audio mixing.
- *
- * The engine does NOT care what animation framework drives the page.
- * GSAP, Framer Motion, CSS animations, Three.js — anything works as long
- * as `seek()` produces deterministic visual output for a given time.
- */
-export interface HfProtocol {
-    /** Total duration of the composition in seconds */
-    duration: number;
-    /** Seek to a specific time. Must produce deterministic visual output. */
-    seek(time: number): void;
-    /** Optional: media elements the engine should handle */
-    media?: HfMediaElement[];
-}
-export interface CaptureOptions {
-    width: number;
-    height: number;
-    fps: number;
-    format?: "jpeg" | "png";
-    quality?: number;
-    deviceScaleFactor?: number;
-}
-export interface CaptureResult {
-    frameIndex: number;
-    time: number;
-    path: string;
-    captureTimeMs: number;
-}
-export interface CaptureBufferResult {
-    buffer: Buffer;
-    captureTimeMs: number;
-}
-export interface CapturePerfSummary {
-    frames: number;
-    avgTotalMs: number;
-    avgSeekMs: number;
-    avgBeforeCaptureMs: number;
-    avgScreenshotMs: number;
-}
-declare global {
-    interface Window {
-        __hf?: HfProtocol;
-    }
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,wDAAwD;IACxD,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC1B;AAID,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;CACzB;AAID,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,IAAI,CAAC,EAAE,UAAU,CAAC;KACnB;CACF"}

package/dist/types.js

@@ -1,8 +0,0 @@
-/**
- * @hyperframes/engine — Protocol Types
- *
- * The engine's page contract. Any web page that wants to be rendered
- * as video must expose `window.__hf` implementing the HfProtocol interface.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/utils/ffprobe.d.ts

@@ -1,18 +0,0 @@
-export interface VideoMetadata {
-    durationSeconds: number;
-    width: number;
-    height: number;
-    fps: number;
-    videoCodec: string;
-    hasAudio: boolean;
-}
-export interface AudioMetadata {
-    durationSeconds: number;
-    sampleRate: number;
-    channels: number;
-    audioCodec: string;
-    bitrate?: number;
-}
-export declare function extractVideoMetadata(filePath: string): Promise<VideoMetadata>;
-export declare function extractAudioMetadata(filePath: string): Promise<AudioMetadata>;
-//# sourceMappingURL=ffprobe.d.ts.map

package/dist/utils/ffprobe.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ffprobe.d.ts","sourceRoot":"","sources":["../../src/utils/ffprobe.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAkCD,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAmEnF;AAED,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAoEnF"}