@kenkaiiii/gg-editor 0.6.7 → 0.7.1

package/dist/core/beats.js.map

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

package/dist/core/beats.test.d.ts

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

package/dist/core/beats.test.d.ts.map

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

package/dist/core/beats.test.js

@@ -0,0 +1,86 @@
+import { describe, expect, it } from "vitest";
+import { snapCuts } from "./beats.js";
+describe("snapCuts", () => {
+    it("returns empty results for empty cut list", () => {
+        const r = snapCuts([], [1, 2, 3], 0.25);
+        expect(r.snapped).toEqual([]);
+        expect(r.unchanged).toEqual([]);
+    });
+    it("returns every cut in unchanged when beats list is empty", () => {
+        const r = snapCuts([1.0, 2.0], [], 0.25);
+        expect(r.snapped).toEqual([]);
+        expect(r.unchanged).toEqual([{ atSec: 1.0 }, { atSec: 2.0 }]);
+    });
+    it("snaps a cut to the nearest beat within tolerance", () => {
+        // Beats at 1.0, 2.0, 3.0; cut at 2.07s with tol 0.25 → snaps to 2.0.
+        const r = snapCuts([2.07], [1.0, 2.0, 3.0], 0.25);
+        expect(r.snapped).toHaveLength(1);
+        expect(r.unchanged).toEqual([]);
+        expect(r.snapped[0]).toEqual({
+            originalSec: 2.07,
+            snappedSec: 2.0,
+            beatIdx: 1,
+            deltaSec: expect.closeTo(-0.07, 5),
+        });
+    });
+    it("leaves a cut unchanged when the closest beat is outside tolerance", () => {
+        // Beats at 0, 1; cut at 0.5 → equidistant, but 0.5 > tol of 0.1.
+        const r = snapCuts([0.5], [0.0, 1.0], 0.1);
+        expect(r.snapped).toEqual([]);
+        expect(r.unchanged).toHaveLength(1);
+        expect(r.unchanged[0].atSec).toBe(0.5);
+        expect(r.unchanged[0].nearestBeatDeltaSec).toBeCloseTo(0.5, 5);
+    });
+    it("picks the LEFT beat on a perfect tie (earlier beat wins)", () => {
+        // Cut at 1.5 between beats at 1.0 and 2.0 — both 0.5 away.
+        const r = snapCuts([1.5], [1.0, 2.0], 1.0);
+        expect(r.snapped).toHaveLength(1);
+        expect(r.snapped[0].snappedSec).toBe(1.0);
+        expect(r.snapped[0].beatIdx).toBe(0);
+    });
+    it("snaps each cut independently and preserves input order", () => {
+        const cuts = [3.05, 1.04, 2.5];
+        const beats = [1.0, 2.0, 3.0, 4.0];
+        const r = snapCuts(cuts, beats, 0.1);
+        // 3.05 → 3.0 (delta -0.05)
+        // 1.04 → 1.0 (delta -0.04)
+        // 2.5  → ties left at 2.0 BUT |0.5| > 0.1 tol → unchanged.
+        expect(r.snapped.map((s) => s.originalSec)).toEqual([3.05, 1.04]);
+        expect(r.unchanged.map((u) => u.atSec)).toEqual([2.5]);
+    });
+    it("clamps negative tolerance to 0 (no snap occurs)", () => {
+        const r = snapCuts([1.0001], [1.0], -0.5);
+        // Tolerance was negative → clamped to 0; cut isn't EXACTLY on the beat,
+        // so it falls into unchanged.
+        expect(r.snapped).toEqual([]);
+        expect(r.unchanged).toHaveLength(1);
+    });
+    it("handles cuts before the first beat and after the last beat", () => {
+        const beats = [5.0, 6.0, 7.0];
+        const r = snapCuts([4.95, 7.05, 100], beats, 0.1);
+        // 4.95 → 5.0, 7.05 → 7.0, 100 → unchanged (closest delta 93)
+        expect(r.snapped.map((s) => s.snappedSec)).toEqual([5.0, 7.0]);
+        expect(r.unchanged).toHaveLength(1);
+        expect(r.unchanged[0].atSec).toBe(100);
+        expect(r.unchanged[0].nearestBeatDeltaSec).toBeCloseTo(93, 1);
+    });
+    it("sorts beat input defensively", () => {
+        // Caller passes beats out of order; we still find the right neighbour.
+        const r = snapCuts([2.04], [3.0, 1.0, 2.0], 0.1);
+        expect(r.snapped[0].snappedSec).toBe(2.0);
+        expect(r.snapped[0].beatIdx).toBe(1); // index in the SORTED list
+    });
+    it("treats non-finite cuts as unchanged", () => {
+        const r = snapCuts([NaN, 1.0], [1.0, 2.0], 0.1);
+        expect(r.snapped).toHaveLength(1);
+        expect(r.snapped[0].originalSec).toBe(1.0);
+        expect(r.unchanged).toHaveLength(1);
+        expect(Number.isNaN(r.unchanged[0].atSec)).toBe(true);
+    });
+    it("zero tolerance only snaps exact-match cuts", () => {
+        const r = snapCuts([1.0, 1.001], [1.0, 2.0], 0);
+        expect(r.snapped.map((s) => s.originalSec)).toEqual([1.0]);
+        expect(r.unchanged.map((u) => u.atSec)).toEqual([1.001]);
+    });
+});
+//# sourceMappingURL=beats.test.js.map

package/dist/core/beats.test.js.map

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

package/dist/core/brand-kit.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Brand-kit loader.
+ *
+ * A "brand kit" is a small JSON file at `<cwd>/.gg/brand.json` that holds the
+ * channel-level constants every render-time tool wants: logo, intro/outro/
+ * watermark video paths, default fonts, colour palette, channel name, CTA
+ * text. The loader is opt-in — if the file isn't present, every consumer
+ * falls back to its existing defaults.
+ *
+ * Why JSON, not YAML: zero new deps; brand kits are short enough that the
+ * JSON line noise doesn't hurt readability.
+ *
+ * Why separate from styles (`<cwd>/.gg/editor-styles/*.md`): styles modulate
+ * the LLM's behaviour (its writing voice, tone, defaults). The brand kit
+ * modulates raw render output (which logo to overlay, which font to draw
+ * with). They serve different layers and we keep them separate so a user
+ * can change one without touching the other.
+ */
+export interface BrandKitFonts {
+    /** Display font for headlines / titles. */
+    heading?: string;
+    /** Body font for captions / lower-thirds. */
+    body?: string;
+}
+export interface BrandKitColors {
+    /** Hex (RRGGBB, no leading #). */
+    primary?: string;
+    secondary?: string;
+    accent?: string;
+}
+export interface BrandKit {
+    /** Channel display name; surfaced in outros, lower-thirds, end-screens. */
+    channelName?: string;
+    /** Path (relative to cwd) to a logo PNG with alpha — used by overlay_watermark and generate_outro. */
+    logo?: string;
+    /** Default watermark path (logo, but a more polished pre-positioned variant if you have one). */
+    watermark?: string;
+    /** Pre-rendered intro video. concat_videos uses this. */
+    intro?: string;
+    /** Pre-rendered outro video. concat_videos / generate_outro use this. */
+    outro?: string;
+    /** Per-font-role family (or path to .ttf for ffmpeg drawtext). */
+    fonts?: BrandKitFonts;
+    /** Brand palette (hex without leading #). */
+    colors?: BrandKitColors;
+    /** Default CTA text — used by generate_outro and overlay banners. */
+    ctaText?: string;
+    /** Default subscribe handle / URL surfaced in description templates. */
+    subscribeUrl?: string;
+}
+/** Path of the brand-kit file relative to cwd. Stable so docs can quote it. */
+export declare const BRAND_KIT_PATH = ".gg/brand.json";
+/**
+ * Load `<cwd>/.gg/brand.json` if present. Returns `null` when the file is
+ * missing OR malformed — callers should treat absence as "no brand kit
+ * configured" and fall back to their normal defaults. Malformed JSON also
+ * returns null (we don't want a syntax slip in a config file to break a
+ * render); the agent surfaces the issue separately via `validateBrandKit`.
+ */
+export declare function loadBrandKit(cwd: string): BrandKit | null;
+export interface BrandKitValidation {
+    ok: boolean;
+    /** Empty when ok=true. */
+    errors: string[];
+    /** Warnings don't block; they surface "you set logo but the file doesn't exist" cases. */
+    warnings: string[];
+}
+/**
+ * Validate a brand kit. Returns structured findings the agent can surface.
+ * Doesn't throw — caller decides whether to gate.
+ *
+ * Strict checks (errors):
+ *   - any path field that isn't a string
+ *   - any color that isn't 6-hex chars
+ *
+ * Soft checks (warnings):
+ *   - referenced files that don't exist on disk
+ */
+export declare function validateBrandKit(kit: BrandKit, cwd: string, fileExists?: (absPath: string) => boolean): BrandKitValidation;
+//# sourceMappingURL=brand-kit.d.ts.map

package/dist/core/brand-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-kit.d.ts","sourceRoot":"","sources":["../../src/core/brand-kit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sGAAsG;IACtG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iGAAiG;IACjG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,+EAA+E;AAC/E,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAezD;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,0BAA0B;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,0FAA0F;IAC1F,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,GACxC,kBAAkB,CAsCpB"}

package/dist/core/brand-kit.js

@@ -0,0 +1,96 @@
+/**
+ * Brand-kit loader.
+ *
+ * A "brand kit" is a small JSON file at `<cwd>/.gg/brand.json` that holds the
+ * channel-level constants every render-time tool wants: logo, intro/outro/
+ * watermark video paths, default fonts, colour palette, channel name, CTA
+ * text. The loader is opt-in — if the file isn't present, every consumer
+ * falls back to its existing defaults.
+ *
+ * Why JSON, not YAML: zero new deps; brand kits are short enough that the
+ * JSON line noise doesn't hurt readability.
+ *
+ * Why separate from styles (`<cwd>/.gg/editor-styles/*.md`): styles modulate
+ * the LLM's behaviour (its writing voice, tone, defaults). The brand kit
+ * modulates raw render output (which logo to overlay, which font to draw
+ * with). They serve different layers and we keep them separate so a user
+ * can change one without touching the other.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+/** Path of the brand-kit file relative to cwd. Stable so docs can quote it. */
+export const BRAND_KIT_PATH = ".gg/brand.json";
+/**
+ * Load `<cwd>/.gg/brand.json` if present. Returns `null` when the file is
+ * missing OR malformed — callers should treat absence as "no brand kit
+ * configured" and fall back to their normal defaults. Malformed JSON also
+ * returns null (we don't want a syntax slip in a config file to break a
+ * render); the agent surfaces the issue separately via `validateBrandKit`.
+ */
+export function loadBrandKit(cwd) {
+    const path = resolvePath(cwd, BRAND_KIT_PATH);
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Validate a brand kit. Returns structured findings the agent can surface.
+ * Doesn't throw — caller decides whether to gate.
+ *
+ * Strict checks (errors):
+ *   - any path field that isn't a string
+ *   - any color that isn't 6-hex chars
+ *
+ * Soft checks (warnings):
+ *   - referenced files that don't exist on disk
+ */
+export function validateBrandKit(kit, cwd, fileExists) {
+    const errors = [];
+    const warnings = [];
+    const exists = fileExists ?? ((p) => existsSync(p));
+    const pathFields = ["logo", "watermark", "intro", "outro"];
+    for (const f of pathFields) {
+        const v = kit[f];
+        if (v === undefined)
+            continue;
+        if (typeof v !== "string" || v.trim().length === 0) {
+            errors.push(`${f}: must be a non-empty string`);
+            continue;
+        }
+        const abs = resolvePath(cwd, v);
+        if (!exists(abs))
+            warnings.push(`${f}: file not found at ${abs}`);
+    }
+    if (kit.colors) {
+        for (const [k, v] of Object.entries(kit.colors)) {
+            if (v !== undefined && !/^[0-9a-fA-F]{6}$/.test(v)) {
+                errors.push(`colors.${k}: '${v}' is not 6-char hex (RRGGBB, no #)`);
+            }
+        }
+    }
+    if (kit.fonts) {
+        for (const [k, v] of Object.entries(kit.fonts)) {
+            if (v !== undefined && typeof v !== "string") {
+                errors.push(`fonts.${k}: must be a string (font name or path to .ttf)`);
+            }
+        }
+    }
+    if (kit.channelName !== undefined && typeof kit.channelName !== "string") {
+        errors.push("channelName: must be a string");
+    }
+    return { ok: errors.length === 0, errors, warnings };
+}
+//# sourceMappingURL=brand-kit.js.map

package/dist/core/brand-kit.js.map

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

package/dist/core/brand-kit.test.d.ts

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

package/dist/core/brand-kit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-kit.test.d.ts","sourceRoot":"","sources":["../../src/core/brand-kit.test.ts"],"names":[],"mappings":""}

package/dist/core/brand-kit.test.js

@@ -0,0 +1,76 @@
+import { describe, expect, it } from "vitest";
+import { mkdtempSync, mkdirSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { BRAND_KIT_PATH, loadBrandKit, validateBrandKit } from "./brand-kit.js";
+function makeCwd(brand) {
+    const cwd = mkdtempSync(join(tmpdir(), "gg-brandkit-test-"));
+    if (brand !== undefined) {
+        mkdirSync(join(cwd, ".gg"), { recursive: true });
+        writeFileSync(join(cwd, BRAND_KIT_PATH), brand, "utf8");
+    }
+    return cwd;
+}
+describe("loadBrandKit", () => {
+    it("returns null when no brand.json exists", () => {
+        const cwd = makeCwd();
+        expect(loadBrandKit(cwd)).toBeNull();
+    });
+    it("returns null on malformed JSON (no throw)", () => {
+        const cwd = makeCwd("{ not valid json");
+        expect(loadBrandKit(cwd)).toBeNull();
+    });
+    it("returns null on non-object root (array, primitive)", () => {
+        expect(loadBrandKit(makeCwd('["a", "b"]'))).toBeNull();
+        expect(loadBrandKit(makeCwd('"string"'))).toBeNull();
+        expect(loadBrandKit(makeCwd("42"))).toBeNull();
+    });
+    it("parses a valid brand kit", () => {
+        const cwd = makeCwd(JSON.stringify({
+            channelName: "Ken Kai",
+            logo: "assets/logo.png",
+            fonts: { heading: "Bebas Neue", body: "Inter" },
+            colors: { primary: "FF6B35", secondary: "004E89" },
+            ctaText: "Subscribe for more",
+        }));
+        const kit = loadBrandKit(cwd);
+        expect(kit?.channelName).toBe("Ken Kai");
+        expect(kit?.fonts?.heading).toBe("Bebas Neue");
+        expect(kit?.colors?.primary).toBe("FF6B35");
+    });
+});
+describe("validateBrandKit", () => {
+    const noExist = () => false;
+    it("ok=true on empty kit", () => {
+        const v = validateBrandKit({}, "/tmp", noExist);
+        expect(v.ok).toBe(true);
+        expect(v.errors).toEqual([]);
+    });
+    it("rejects malformed colors", () => {
+        const kit = { colors: { primary: "#FF6B35", secondary: "no" } };
+        const v = validateBrandKit(kit, "/tmp", noExist);
+        expect(v.ok).toBe(false);
+        expect(v.errors.find((e) => e.includes("colors.primary"))).toBeTruthy();
+        expect(v.errors.find((e) => e.includes("colors.secondary"))).toBeTruthy();
+    });
+    it("rejects empty path strings", () => {
+        const v = validateBrandKit({ logo: "" }, "/tmp", noExist);
+        expect(v.ok).toBe(false);
+        expect(v.errors.find((e) => e.includes("logo"))).toBeTruthy();
+    });
+    it("warns on missing referenced files", () => {
+        const v = validateBrandKit({ logo: "missing.png" }, "/tmp", noExist);
+        expect(v.ok).toBe(true);
+        expect(v.warnings.find((w) => w.includes("logo"))).toBeTruthy();
+    });
+    it("no warning when fileExists returns true", () => {
+        const v = validateBrandKit({ logo: "logo.png" }, "/tmp", () => true);
+        expect(v.ok).toBe(true);
+        expect(v.warnings).toEqual([]);
+    });
+    it("accepts six-char hex colors (no leading #)", () => {
+        const v = validateBrandKit({ colors: { primary: "FFFFFF", accent: "00aaff" } }, "/tmp", noExist);
+        expect(v.ok).toBe(true);
+    });
+});
+//# sourceMappingURL=brand-kit.test.js.map

package/dist/core/brand-kit.test.js.map

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

package/dist/core/bundled-sfx.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Bundled sound-effect library.
+ *
+ * gg-editor's `add_sfx_at_cuts` needs a WAV/MP3 file per hit. Without this
+ * module the agent had to either ask the user to supply one or invent a path
+ * — both broke the canonical retention pipeline. Now the agent calls
+ * `add_sfx_at_cuts(sfx="whoosh", …)` with a bundled name and the resolver
+ * either returns a cached WAV or synthesises one via ffmpeg into
+ * `~/.gg/sfx-cache/<name>.wav` (~50 ms one-time per name; cached forever).
+ *
+ * Why synthesised, not shipped: no third-party files = no IP risk + no npm
+ * weight. Every recipe is a pure ffmpeg-lavfi expression so the output is
+ * deterministic and reproducible. Quality is "creator-vlog acceptable" —
+ * not Skywalker Sound, but indistinguishable from typical CapCut presets in
+ * a sub-1-second cut.
+ *
+ * Design rules for recipes:
+ *   - Stereo (`-ac 2`) — every consumer mixes into stereo audio.
+ *   - 200–500 ms long. Anything longer fights the next cut.
+ *   - Peak ≤ -3 dBFS (the recipes all keep amplitude ≤ 0.7) so
+ *     `add_sfx_at_cuts`'s default -8 dB gain leaves headroom for voice.
+ *   - Linear fade in (≥5 ms) + fade out — no clicks at the envelope edges.
+ */
+export interface SfxRecipe {
+    /** One-line creator description shown in the system prompt + tool description. */
+    description: string;
+    /**
+     * ffmpeg args producing the WAV. The cached output path is appended at
+     * synthesis time; recipes should NOT include it themselves.
+     */
+    args: string[];
+}
+/**
+ * The bundled set. Keep this list short and creator-relevant —
+ * 8–10 names covers the entire short-form vocabulary.
+ */
+export declare const BUNDLED_SFX: Record<string, SfxRecipe>;
+/** Names of every bundled SFX (sorted for stable display). */
+export declare function listBundledSfxNames(): string[];
+/** A short markdown-style list of bundled SFX for tool descriptions / system prompts. */
+export declare function bundledSfxDescriptionList(): string;
+/** Cache dir for synthesised WAVs. Stable across sessions, gitignored by convention. */
+export declare function getSfxCacheDir(): string;
+/**
+ * Resolve an SFX argument:
+ *
+ *   - Bundled name (e.g. `"whoosh"`) → cache hit at `~/.gg/sfx-cache/whoosh.wav`,
+ *     synthesising via ffmpeg on first request.
+ *   - File-like string (contains `/`, `\`, `.`, `~`) → resolve against `cwd`
+ *     and return as-is. The caller still has to verify the file exists.
+ *
+ * Throws when the name is neither bundled nor file-like.
+ */
+export declare function resolveSfx(nameOrPath: string, cwd: string, signal?: AbortSignal): Promise<{
+    path: string;
+    bundled: boolean;
+    name?: string;
+}>;
+/**
+ * Ensure a bundled SFX is present on disk, synthesising it via ffmpeg if not.
+ * Returns the absolute cache path.
+ */
+export declare function ensureBundledSfx(name: string, signal?: AbortSignal): Promise<string>;
+//# sourceMappingURL=bundled-sfx.d.ts.map

package/dist/core/bundled-sfx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-sfx.d.ts","sourceRoot":"","sources":["../../src/core/bundled-sfx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,MAAM,WAAW,SAAS;IACxB,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CA4HjD,CAAC;AAEF,8DAA8D;AAC9D,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED,yFAAyF;AACzF,wBAAgB,yBAAyB,IAAI,MAAM,CAIlD;AAED,wFAAwF;AACxF,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB5D;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB1F"}