@nodetool-ai/video-nodes 0.8.1

package/README.md

@@ -0,0 +1,58 @@
+# @nodetool-ai/video-nodes
+
+Video and 3D-model nodes for [NodeTool](https://nodetool.ai).
+
+A pack of video-processing and 3D-mesh nodes for NodeTool workflows: trim, concat,
+and transform video; apply color and effects; run AI video generation and lip-sync;
+edit timelines; and load, repair, and convert 3D models.
+
+## Install
+
+```bash
+npm install @nodetool-ai/video-nodes
+```
+
+## Nodes
+
+### Video I/O
+
+- `nodetool.video.LoadVideoFile`, `nodetool.video.LoadVideoAssets`
+- `nodetool.video.SaveVideo`, `nodetool.video.SaveVideoFile`
+- `nodetool.video.GetVideoInfo`
+
+### Editing and transform
+
+- `nodetool.video.Trim`, `nodetool.video.Concat`, `nodetool.video.Reverse`, `nodetool.video.SetSpeed`, `nodetool.video.Fps`
+- `nodetool.video.Resize`, `nodetool.video.Rotate`, `nodetool.video.Overlay`, `nodetool.video.Transition`
+- `nodetool.video.ExtractFrame`, `nodetool.video.FrameToVideo`, `nodetool.video.ForEachFrame`
+- `nodetool.video.AddAudio`, `nodetool.video.ExtractAudio`, `nodetool.video.AddSubtitles`
+
+### Color and effects
+
+- `nodetool.video.Blur`, `nodetool.video.Sharpness`, `nodetool.video.Denoise`, `nodetool.video.Stabilize`
+- `nodetool.video.ChromaKey`, `nodetool.video.ColorBalance`, `nodetool.video.Saturation`
+
+### AI generation
+
+- `nodetool.video.TextToVideo`, `nodetool.video.ImageToVideo`, `nodetool.video.VideoToVideo`
+- `nodetool.video.LipSync`
+
+### Timeline
+
+Assemble clips and render a multi-track timeline.
+
+- `nodetool.timeline.AddClips`, `nodetool.timeline.RenderTimeline`, `nodetool.timeline.Transcript`
+
+### 3D models
+
+Load, generate, transform, and repair meshes.
+
+- I/O and metadata: `nodetool.model3d.LoadModel3DFile`, `nodetool.model3d.SaveModel3D`, `nodetool.model3d.SaveModel3DFile`, `nodetool.model3d.FormatConverter`, `nodetool.model3d.GetModel3DMetadata`
+- Generation: `nodetool.model3d.TextTo3D`, `nodetool.model3d.ImageTo3D`
+- Transform: `nodetool.model3d.Transform3D`, `nodetool.model3d.CenterMesh`, `nodetool.model3d.NormalizeModel3D`
+- Mesh ops: `nodetool.model3d.Decimate`, `nodetool.model3d.RepairMesh`, `nodetool.model3d.MergeMeshes`, `nodetool.model3d.Boolean3D`, `nodetool.model3d.FlipNormals`, `nodetool.model3d.RecalculateNormals`, `nodetool.model3d.ExtractLargestComponent`
+
+## Links
+
+- [NodeTool](https://nodetool.ai)
+- [GitHub](https://github.com/nodetool-ai/nodetool)

package/dist/.nodetool-build-stamp

@@ -0,0 +1 @@
+2026-09-28T09:19:13.465Z

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./nodes/video.js";
+export * from "./nodes/timeline.js";
+export * from "./nodes/script.js";
+export * from "./nodes/storyboard.js";
+export * from "./nodes/lib-video-download.js";
+export * from "./nodes/model3d.js";
+export { TextTo3DNode, ImageTo3DNode } from "./nodes/model3d/generation.js";
+export { DEFAULT_MODEL_3D, DEFAULT_FOLDER, DEFAULT_IMAGE, DEFAULT_TEXT_TO_3D_MODEL, DEFAULT_IMAGE_TO_3D_MODEL } from "./nodes/model3d/defaults.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AAInC,OAAO,EACL,YAAY,EACZ,aAAa,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export * from "./nodes/video.js";
+export * from "./nodes/timeline.js";
+export * from "./nodes/script.js";
+export * from "./nodes/storyboard.js";
+export * from "./nodes/lib-video-download.js";
+export * from "./nodes/model3d.js";
+// Submodule re-exports for callers (tests, codegen) that import the
+// 3D-model defaults / generation node classes directly.
+export { TextTo3DNode, ImageTo3DNode } from "./nodes/model3d/generation.js";
+export { DEFAULT_MODEL_3D, DEFAULT_FOLDER, DEFAULT_IMAGE, DEFAULT_TEXT_TO_3D_MODEL, DEFAULT_IMAGE_TO_3D_MODEL } from "./nodes/model3d/defaults.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AAEnC,oEAAoE;AACpE,wDAAwD;AACxD,OAAO,EACL,YAAY,EACZ,aAAa,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,6BAA6B,CAAC"}

package/dist/nodes/ffmpeg-helpers.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Shared ffmpeg/ffprobe helpers for the video nodes.
+ *
+ * Internal to the package — deliberately NOT re-exported from `src/index.ts`.
+ * Everything here is free of node-specific state so `timeline.ts` (and any other
+ * ffmpeg-backed module) can import it directly.
+ *
+ * Policy: a spawn failure because the binary is missing (`ENOENT`) surfaces as
+ * {@link MissingBinaryError} carrying the binary name. A genuine tool failure
+ * (non-zero exit) rejects with the underlying error, whose `.stderr` carries
+ * ffmpeg's diagnostics — callers turn that into an actionable message instead of
+ * silently passing the input through.
+ */
+import { execFile as execFileCb } from "node:child_process";
+import type { VideoRef } from "@nodetool-ai/node-sdk";
+export declare const execFile: typeof execFileCb.__promisify__;
+export declare const FFMPEG_MAX_BUFFER: number;
+/** A required binary (ffmpeg/ffprobe) is not installed or not on PATH. */
+export declare class MissingBinaryError extends Error {
+    readonly binary: string;
+    constructor(binary: string);
+}
+/** Run ffmpeg, mapping a missing binary to {@link MissingBinaryError}. */
+export declare function execFfmpeg(args: string[], options?: {
+    maxBuffer?: number;
+}): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+/** Run ffprobe, mapping a missing binary to {@link MissingBinaryError}. */
+export declare function execFfprobe(args: string[], options?: {
+    maxBuffer?: number;
+}): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+/** Build a VideoRef from raw bytes (raw base64 `data`, `type: "video"`). */
+export declare function videoRef(data: Uint8Array, extras?: Partial<VideoRef>): VideoRef;
+/** A fresh empty VideoRef prop default. Each call returns its own object. */
+export declare function defaultVideoRef(): VideoRef;
+/** Resolve a `file://` URI (or plain path) to a filesystem path. */
+export declare function filePath(uriOrPath: string): string;
+/**
+ * Resolve a folder value to a filesystem path. Accepts a plain string path/URI
+ * or a folder ref object (`{ uri }`); returns "" when no usable path is present.
+ */
+export declare function folderPath(raw: unknown): string;
+/** Expand %Y/%m/%d/%H/%M/%S date tokens in a filename. */
+export declare function dateName(name: string): string;
+/**
+ * Return a non-colliding path: `target` itself if free, otherwise `name-1.ext`,
+ * `name-2.ext`, … Guards saves in the same second (dateName granularity) from
+ * silently overwriting each other.
+ */
+export declare function uniqueTargetPath(target: string): Promise<string>;
+/**
+ * Parse an ffprobe `r_frame_rate` value ("30000/1001" or "25") into a number.
+ * Returns 0 for malformed values or zero denominators instead of NaN/Infinity.
+ */
+export declare function parseFrameRate(raw: string): number;
+/**
+ * Probe a file's duration in seconds. A missing ffprobe binary surfaces as
+ * {@link MissingBinaryError}; a genuine probe failure (corrupt input) returns 0.
+ */
+export declare function ffprobeDuration(file: string): Promise<number>;
+/** Write `bytes` to a temp file with `suffix`, returning its path + cleanup. */
+export declare function withTempFile(suffix: string, bytes: Uint8Array): Promise<{
+    path: string;
+    cleanup: () => Promise<void>;
+}>;
+/**
+ * Normalize provider-prediction output to `Uint8Array`. Accepts `Uint8Array`,
+ * `Buffer`, or `ArrayBuffer`; anything else throws a clear error naming the node
+ * and the received type instead of casting blindly.
+ */
+export declare function coerceProviderBytes(value: unknown, nodeName: string): Uint8Array;
+//# sourceMappingURL=ffmpeg-helpers.d.ts.map

package/dist/nodes/ffmpeg-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg-helpers.d.ts","sourceRoot":"","sources":["../../src/nodes/ffmpeg-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAM5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAOtD,eAAO,MAAM,QAAQ,iCAAwB,CAAC;AAE9C,eAAO,MAAM,iBAAiB,QAAmB,CAAC;AAElD,0EAA0E;AAC1E,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,YAAY,MAAM,EAAE,MAAM,EAQzB;CACF;AAWD,0EAA0E;AAC1E,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAO7C;AAED,2EAA2E;AAC3E,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAO7C;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CACtB,IAAI,EAAE,UAAU,EAChB,MAAM,GAAE,OAAO,CAAC,QAAQ,CAAM,GAC7B,QAAQ,CAMV;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,IAAI,QAAQ,CAU1C;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAUlD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAS/C;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU7C;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBtE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASlD;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBnE;AAED,gFAAgF;AAChF,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAUzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,UAAU,CAeZ"}

package/dist/nodes/ffmpeg-helpers.js

@@ -0,0 +1,220 @@
+/**
+ * Shared ffmpeg/ffprobe helpers for the video nodes.
+ *
+ * Internal to the package — deliberately NOT re-exported from `src/index.ts`.
+ * Everything here is free of node-specific state so `timeline.ts` (and any other
+ * ffmpeg-backed module) can import it directly.
+ *
+ * Policy: a spawn failure because the binary is missing (`ENOENT`) surfaces as
+ * {@link MissingBinaryError} carrying the binary name. A genuine tool failure
+ * (non-zero exit) rejects with the underlying error, whose `.stderr` carries
+ * ffmpeg's diagnostics — callers turn that into an actionable message instead of
+ * silently passing the input through.
+ */
+import { execFile as execFileCb } from "node:child_process";
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+import { isNonEmptyString, isObjectLike, isString } from "@nodetool-ai/node-sdk";
+export const execFile = promisify(execFileCb);
+export const FFMPEG_MAX_BUFFER = 50 * 1024 * 1024;
+/** A required binary (ffmpeg/ffprobe) is not installed or not on PATH. */
+export class MissingBinaryError extends Error {
+    binary;
+    constructor(binary) {
+        super(`${binary} is not installed or not on PATH. Install ${binary} (the ` +
+            `Package Manager UI can do this) to process video — these nodes shell ` +
+            `out to ffmpeg/ffprobe and cannot run without it.`);
+        this.name = "MissingBinaryError";
+        this.binary = binary;
+    }
+}
+/**
+ * Whether `err` is a spawn ENOENT (binary not on PATH) rather than the tool
+ * running and reporting a non-zero exit. Scope this to the spawn itself so an
+ * unrelated filesystem ENOENT is never mislabeled as a missing binary.
+ */
+function isSpawnEnoent(err) {
+    return isObjectLike(err) && err.code === "ENOENT";
+}
+/** Run ffmpeg, mapping a missing binary to {@link MissingBinaryError}. */
+export async function execFfmpeg(args, options = {}) {
+    try {
+        return await execFile("ffmpeg", args, options);
+    }
+    catch (error) {
+        if (isSpawnEnoent(error))
+            throw new MissingBinaryError("ffmpeg");
+        throw error;
+    }
+}
+/** Run ffprobe, mapping a missing binary to {@link MissingBinaryError}. */
+export async function execFfprobe(args, options = {}) {
+    try {
+        return await execFile("ffprobe", args, options);
+    }
+    catch (error) {
+        if (isSpawnEnoent(error))
+            throw new MissingBinaryError("ffprobe");
+        throw error;
+    }
+}
+/** Build a VideoRef from raw bytes (raw base64 `data`, `type: "video"`). */
+export function videoRef(data, extras = {}) {
+    return {
+        type: "video",
+        data: Buffer.from(data).toString("base64"),
+        ...extras
+    };
+}
+/** A fresh empty VideoRef prop default. Each call returns its own object. */
+export function defaultVideoRef() {
+    return {
+        type: "video",
+        uri: "",
+        asset_id: null,
+        data: null,
+        metadata: null,
+        duration: null,
+        format: null
+    };
+}
+/** Resolve a `file://` URI (or plain path) to a filesystem path. */
+export function filePath(uriOrPath) {
+    if (uriOrPath.startsWith("file://")) {
+        try {
+            return fileURLToPath(new URL(uriOrPath));
+        }
+        catch {
+            // Fallback for non-standard URIs like file://C:\path
+            return uriOrPath.slice("file://".length);
+        }
+    }
+    return uriOrPath;
+}
+/**
+ * Resolve a folder value to a filesystem path. Accepts a plain string path/URI
+ * or a folder ref object (`{ uri }`); returns "" when no usable path is present.
+ */
+export function folderPath(raw) {
+    if (isString(raw)) {
+        return raw.startsWith("file:") ? filePath(raw) : raw;
+    }
+    if (isObjectLike(raw)) {
+        const uri = raw.uri;
+        if (isNonEmptyString(uri))
+            return filePath(uri);
+    }
+    return "";
+}
+/** Expand %Y/%m/%d/%H/%M/%S date tokens in a filename. */
+export function dateName(name) {
+    const now = new Date();
+    const pad = (v) => String(v).padStart(2, "0");
+    return name
+        .replaceAll("%Y", String(now.getFullYear()))
+        .replaceAll("%m", pad(now.getMonth() + 1))
+        .replaceAll("%d", pad(now.getDate()))
+        .replaceAll("%H", pad(now.getHours()))
+        .replaceAll("%M", pad(now.getMinutes()))
+        .replaceAll("%S", pad(now.getSeconds()));
+}
+/**
+ * Return a non-colliding path: `target` itself if free, otherwise `name-1.ext`,
+ * `name-2.ext`, … Guards saves in the same second (dateName granularity) from
+ * silently overwriting each other.
+ */
+export async function uniqueTargetPath(target) {
+    const exists = async (p) => {
+        try {
+            await fs.access(p);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    if (!(await exists(target)))
+        return target;
+    const dir = path.dirname(target);
+    const ext = path.extname(target);
+    const base = path.basename(target, ext);
+    for (let i = 1;; i++) {
+        const candidate = path.join(dir, `${base}-${i}${ext}`);
+        if (!(await exists(candidate)))
+            return candidate;
+    }
+}
+/**
+ * Parse an ffprobe `r_frame_rate` value ("30000/1001" or "25") into a number.
+ * Returns 0 for malformed values or zero denominators instead of NaN/Infinity.
+ */
+export function parseFrameRate(raw) {
+    const parts = raw.trim().split("/");
+    if (parts.length === 2) {
+        const num = Number(parts[0]);
+        const den = Number(parts[1]);
+        return Number.isFinite(num) && den > 0 ? num / den : 0;
+    }
+    const val = Number(parts[0]);
+    return Number.isFinite(val) && val > 0 ? val : 0;
+}
+/**
+ * Probe a file's duration in seconds. A missing ffprobe binary surfaces as
+ * {@link MissingBinaryError}; a genuine probe failure (corrupt input) returns 0.
+ */
+export async function ffprobeDuration(file) {
+    try {
+        const { stdout } = await execFfprobe([
+            "-v",
+            "error",
+            "-show_entries",
+            "format=duration",
+            "-of",
+            "default=noprint_wrappers=1:nokey=1",
+            file
+        ]);
+        const val = parseFloat(stdout.trim());
+        return isNaN(val) ? 0 : val;
+    }
+    catch (error) {
+        if (error instanceof MissingBinaryError)
+            throw error;
+        return 0;
+    }
+}
+/** Write `bytes` to a temp file with `suffix`, returning its path + cleanup. */
+export async function withTempFile(suffix, bytes) {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), "nodetool-video-"));
+    const file = path.join(dir, `input${suffix}`);
+    await fs.writeFile(file, bytes);
+    return {
+        path: file,
+        cleanup: async () => {
+            await fs.rm(dir, { recursive: true, force: true });
+        }
+    };
+}
+/**
+ * Normalize provider-prediction output to `Uint8Array`. Accepts `Uint8Array`,
+ * `Buffer`, or `ArrayBuffer`; anything else throws a clear error naming the node
+ * and the received type instead of casting blindly.
+ */
+export function coerceProviderBytes(value, nodeName) {
+    if (value instanceof Uint8Array)
+        return value;
+    if (value instanceof ArrayBuffer)
+        return new Uint8Array(value);
+    const received = value === null
+        ? "null"
+        : Array.isArray(value)
+            ? "array"
+            : isObjectLike(value)
+                ? (value.constructor?.name ?? "object")
+                : typeof value;
+    throw new Error(`${nodeName}: provider returned ${received}, expected video bytes ` +
+        `(Uint8Array/Buffer).`);
+}
+//# sourceMappingURL=ffmpeg-helpers.js.map

package/dist/nodes/ffmpeg-helpers.js.map

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

package/dist/nodes/lib-video-download.d.ts

@@ -0,0 +1,29 @@
+import { BaseNode } from "@nodetool-ai/node-sdk";
+export declare class YtDlpDownloadLibNode extends BaseNode {
+    static readonly nodeType = "lib.video.download.YtDlpDownload";
+    static readonly title = "YouTube Downloader";
+    static readonly description = "Download media from URLs using yt-dlp.\n    download, video, audio, youtube, media, yt-dlp, metadata, subtitles\n\n    Use cases:\n    - Download videos from YouTube and other platforms\n    - Extract audio from video URLs\n    - Retrieve video/audio metadata without downloading\n    - Download subtitles and thumbnails";
+    static readonly metadataOutputTypes: {
+        video: string;
+        audio: string;
+        metadata: string;
+        subtitles: string;
+        thumbnail: string;
+    };
+    static readonly inlineFields: string[];
+    static readonly inputFields: string[];
+    static readonly requiredRuntimes: string[];
+    url: string;
+    mode: string;
+    format_selector: string;
+    container: string;
+    subtitles: boolean;
+    sub_langs: string;
+    thumbnail: boolean;
+    overwrite: boolean;
+    rate_limit_kbps: number;
+    timeout: number;
+    process(): Promise<Record<string, unknown>>;
+}
+export declare const LIB_YTDLP_NODES: readonly [typeof YtDlpDownloadLibNode];
+//# sourceMappingURL=lib-video-download.d.ts.map

package/dist/nodes/lib-video-download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib-video-download.d.ts","sourceRoot":"","sources":["../../src/nodes/lib-video-download.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAQ,MAAM,uBAAuB,CAAC;AAmJvD,qBAAa,oBAAqB,SAAQ,QAAQ;IAChD,MAAM,CAAC,QAAQ,CAAC,QAAQ,sCAAsC;IAC9D,MAAM,CAAC,QAAQ,CAAC,KAAK,wBAAwB;IAC7C,MAAM,CAAC,QAAQ,CAAC,WAAW,sUAC0S;IACrU,MAAM,CAAC,QAAQ,CAAC,mBAAmB;QACjC,KAAK;QACL,KAAK;QACL,QAAQ;QACR,SAAS;QACT,SAAS;MACT;IACF,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAW;IACjD,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAW;IAChD,MAAM,CAAC,QAAQ,CAAC,gBAAgB,WAAc;IAQtC,GAAG,EAAE,MAAM,CAAC;IASZ,IAAI,EAAE,MAAM,CAAC;IAQb,eAAe,EAAE,MAAM,CAAC;IAQxB,SAAS,EAAE,MAAM,CAAC;IAQlB,SAAS,EAAE,OAAO,CAAC;IASnB,SAAS,EAAE,MAAM,CAAC;IAQlB,SAAS,EAAE,OAAO,CAAC;IAQnB,SAAS,EAAE,OAAO,CAAC;IASnB,eAAe,EAAE,MAAM,CAAC;IAUxB,OAAO,EAAE,MAAM,CAAC;IAElB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0KhD;CACF;AAED,eAAO,MAAM,eAAe,wCAAkC,CAAC"}