@duetso/agent 0.1.81 → 0.1.82

package/dist/src/tui/paste-controller.d.ts

@@ -0,0 +1,90 @@
+import { type PasteEvent, type TextareaRenderable } from "@opentui/core";
+import { type PendingImage } from "./paste.js";
+import type { StatusController } from "./status-controller.js";
+export interface PasteControllerOptions {
+    /** Composer textarea. The controller inserts `[Image #N]` placeholders
+     *  into its buffer and falls back to text inserts when a clipboard probe
+     *  yields plain text after a keystroke ate a paste event. */
+    inputField: TextareaRenderable;
+    /** Session id used to namespace the on-disk paste cache under
+     *  `~/.duet/cache/paste/<sessionId>/`. */
+    sessionId: string;
+    /** Working directory for resolving relative paths handed to `/image`. */
+    workDir: string;
+    /** Append a bordered transcript block (label + body) for paste diagnostics
+     *  and per-attachment confirmation lines. */
+    appendBlock: (label: string | null, body: string, color: string) => void;
+    /** Status surface that owns the bottom-hint attachment counter. The
+     *  controller calls `setPendingImageCount` whenever the queue changes so
+     *  the hint stays in sync. */
+    statusController: Pick<StatusController, "setPendingImageCount">;
+}
+/**
+ * Owns the pending-image queue surfaced into the prompt as `[Image #N]`
+ * placeholders. Handles three intake paths that converge on the same
+ * `persistPastedImage` / `loadImageFromPath` machinery:
+ *
+ *   1. Bracketed-paste events that carry binary image bytes (kitty, ghostty,
+ *      recent iTerm2).
+ *   2. Text-shaped pastes that resolve to a single existing image file path
+ *      (Finder/Files drag-paste, file:// URLs).
+ *   3. Manual probes triggered by Cmd+V/Ctrl+V or the `/paste` slash command
+ *      against terminals that strip binary clipboards.
+ *
+ * The queue resets after every submit (callers drive that via `consume()`),
+ * so users see a fresh `#1` label per turn.
+ */
+export declare class PasteController {
+    private readonly inputField;
+    private readonly sessionId;
+    private readonly workDir;
+    private readonly appendBlock;
+    private readonly statusController;
+    private pendingImages;
+    /** Monotonic id used to label the next attachment. Reset together with
+     *  `pendingImages` so labels restart at `#1` after each submit. */
+    private nextImageId;
+    constructor(options: PasteControllerOptions);
+    /** Read-only view of the currently queued attachments. Useful for callers
+     *  that need to render attachment footnotes alongside the user message. */
+    attachments(): readonly PendingImage[];
+    /**
+     * Drain the queue, returning the attachments that were pending at submit
+     * time. The caller forwards `.attachment` payloads to the runner; the
+     * controller resets so the next turn starts at `[Image #1]`.
+     */
+    consume(): PendingImage[];
+    /** Drop all queued attachments. No-op when the queue is already empty so
+     *  `/clear-images` does not redundantly repaint the hint. */
+    clearPendingImages(): void;
+    /**
+     * Handle a bracketed-paste event from the textarea. Decides synchronously
+     * whether the payload is image bytes, a file path, an empty trigger that
+     * warrants a clipboard probe, or plain text that should fall through to
+     * the textarea's default insert path.
+     */
+    handlePasteEvent(event: PasteEvent): Promise<void>;
+    /**
+     * Manual clipboard probe. Read the OS clipboard for an image right now and
+     * attach it if found; otherwise fall back to a text probe so a Cmd+V/Ctrl+V
+     * keystroke that ate a legitimate text paste does not silently swallow it.
+     * The `source` distinguishes the keystroke entry point from the `/paste`
+     * slash command so we only emit the "no readable image" diagnostic for
+     * explicit user intent.
+     */
+    triggerClipboardProbe(source: "keystroke" | "slash"): Promise<void>;
+    /**
+     * Attach an image from disk by path. Drives the `/image <path>` slash
+     * command. Inserts the `[Image #N]` placeholder back into the (likely now
+     * empty) input so the user can keep typing their prompt with the image
+     * already attached.
+     */
+    attachImageFromPath(rawPath: string): Promise<void>;
+    /**
+     * Persist raw image bytes (from a bracketed-paste event or clipboard probe)
+     * under the session cache and surface the resulting `[Image #N]`
+     * placeholder in the prompt buffer.
+     */
+    private attachPastedImageBytes;
+}
+//# sourceMappingURL=paste-controller.d.ts.map

package/dist/src/tui/paste-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paste-controller.d.ts","sourceRoot":"","sources":["../../../src/tui/paste-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE3F,OAAO,EAIL,KAAK,YAAY,EAKlB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,MAAM,WAAW,sBAAsB;IACrC;;iEAE6D;IAC7D,UAAU,EAAE,kBAAkB,CAAC;IAC/B;8CAC0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB;iDAC6C;IAC7C,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE;;kCAE8B;IAC9B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,CAAC;CAClE;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8D;IAC1F,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiD;IAElF,OAAO,CAAC,aAAa,CAAsB;IAC3C;uEACmE;IACnE,OAAO,CAAC,WAAW,CAAK;gBAEZ,OAAO,EAAE,sBAAsB;IAQ3C;+EAC2E;IAC3E,WAAW,IAAI,SAAS,YAAY,EAAE;IAItC;;;;OAIG;IACH,OAAO,IAAI,YAAY,EAAE;IAQzB;iEAC6D;IAC7D,kBAAkB,IAAI,IAAI;IAO1B;;;;;OAKG;IACG,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA8FxD;;;;;;;OAOG;IACG,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCzE;;;;;OAKG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBzD;;;;OAIG;YACW,sBAAsB;CAyBrC"}

package/dist/src/tui/paste-controller.js

@@ -0,0 +1,234 @@
+import { decodePasteBytes } from "@opentui/core";
+import { describeMacClipboardTypes, loadImageFromPath, looksLikeImageFilePath, persistPastedImage, sniffImageMimeType, tryReadClipboardImage, tryReadClipboardText, } from "./paste.js";
+import { COLORS } from "./theme.js";
+/**
+ * Owns the pending-image queue surfaced into the prompt as `[Image #N]`
+ * placeholders. Handles three intake paths that converge on the same
+ * `persistPastedImage` / `loadImageFromPath` machinery:
+ *
+ *   1. Bracketed-paste events that carry binary image bytes (kitty, ghostty,
+ *      recent iTerm2).
+ *   2. Text-shaped pastes that resolve to a single existing image file path
+ *      (Finder/Files drag-paste, file:// URLs).
+ *   3. Manual probes triggered by Cmd+V/Ctrl+V or the `/paste` slash command
+ *      against terminals that strip binary clipboards.
+ *
+ * The queue resets after every submit (callers drive that via `consume()`),
+ * so users see a fresh `#1` label per turn.
+ */
+export class PasteController {
+    inputField;
+    sessionId;
+    workDir;
+    appendBlock;
+    statusController;
+    pendingImages = [];
+    /** Monotonic id used to label the next attachment. Reset together with
+     *  `pendingImages` so labels restart at `#1` after each submit. */
+    nextImageId = 1;
+    constructor(options) {
+        this.inputField = options.inputField;
+        this.sessionId = options.sessionId;
+        this.workDir = options.workDir;
+        this.appendBlock = options.appendBlock;
+        this.statusController = options.statusController;
+    }
+    /** Read-only view of the currently queued attachments. Useful for callers
+     *  that need to render attachment footnotes alongside the user message. */
+    attachments() {
+        return this.pendingImages;
+    }
+    /**
+     * Drain the queue, returning the attachments that were pending at submit
+     * time. The caller forwards `.attachment` payloads to the runner; the
+     * controller resets so the next turn starts at `[Image #1]`.
+     */
+    consume() {
+        const drained = this.pendingImages;
+        this.pendingImages = [];
+        this.nextImageId = 1;
+        this.statusController.setPendingImageCount(0);
+        return drained;
+    }
+    /** Drop all queued attachments. No-op when the queue is already empty so
+     *  `/clear-images` does not redundantly repaint the hint. */
+    clearPendingImages() {
+        if (this.pendingImages.length === 0)
+            return;
+        this.pendingImages = [];
+        this.nextImageId = 1;
+        this.statusController.setPendingImageCount(0);
+    }
+    /**
+     * Handle a bracketed-paste event from the textarea. Decides synchronously
+     * whether the payload is image bytes, a file path, an empty trigger that
+     * warrants a clipboard probe, or plain text that should fall through to
+     * the textarea's default insert path.
+     */
+    async handlePasteEvent(event) {
+        const metadata = event.metadata;
+        const sniffed = sniffImageMimeType(event.bytes);
+        const inferredMime = metadata?.mimeType && metadata.mimeType.startsWith("image/") ? metadata.mimeType : sniffed;
+        // Synchronous fast paths — the paste payload itself is enough to decide.
+        if (inferredMime) {
+            event.preventDefault();
+            await this.attachPastedImageBytes(event.bytes, inferredMime);
+            return;
+        }
+        if (metadata?.kind === "binary") {
+            // Non-image binary paste — we cannot meaningfully forward it, but the
+            // terminal already swallowed the keystroke, so suppress the default
+            // text-insert path that would otherwise garble the prompt.
+            event.preventDefault();
+            this.appendBlock("[paste]", "Unsupported binary clipboard contents (only PNG/JPEG/GIF/WebP).", COLORS.system);
+            return;
+        }
+        // Text-shaped paste. Three sub-cases, ordered cheapest first so common
+        // text pastes never wait on the macOS Swift clipboard probe:
+        //
+        //   1. The text resolves to an image file path (Finder/Files drag-paste).
+        //   2. The terminal forwarded an empty payload but the OS clipboard
+        //      may carry an image promise (e.g. Figma "Copy as PNG", screenshot,
+        //      browser image copy that bracketed-paste cannot represent).
+        //   3. Plain text — just insert it.
+        //
+        // Sub-cases 1 and 3 are fully synchronous after the path heuristic, so
+        // the buffer paints immediately. Only sub-case 2 spawns the Swift
+        // probe, and only when there is literally no text to insert anyway.
+        const originalText = decodePasteBytes(event.bytes);
+        const candidate = looksLikeImageFilePath(originalText);
+        if (candidate) {
+            // Path-shaped paste: suppress the default insert so we can swap in
+            // the [Image #N] placeholder once load resolves.
+            event.preventDefault();
+            try {
+                const pending = await loadImageFromPath({
+                    cwd: this.workDir,
+                    rawPath: candidate,
+                    id: this.nextImageId,
+                });
+                this.nextImageId += 1;
+                this.pendingImages.push(pending);
+                this.inputField.insertText(pending.label);
+                this.appendBlock("[paste]", `attached ${pending.label} from ${pending.path}`, COLORS.system);
+                this.statusController.setPendingImageCount(this.pendingImages.length);
+            }
+            catch (error) {
+                // The clipboard looked like an image path but we could not load
+                // it — surface why and restore the original text so the user can
+                // edit it manually instead of losing what they pasted.
+                this.appendBlock("[paste]", `looked like an image path but could not attach ${candidate}: ${error instanceof Error ? error.message : String(error)}`, COLORS.system);
+                if (originalText.length > 0)
+                    this.inputField.insertText(originalText);
+            }
+            return;
+        }
+        if (originalText.length === 0) {
+            // No text payload — the terminal had nothing to forward but the OS
+            // clipboard may still carry an image promise. Suppress the default
+            // (which would do nothing anyway) and run the slow probe.
+            event.preventDefault();
+            const clipboardImage = await tryReadClipboardImage();
+            if (clipboardImage) {
+                await this.attachPastedImageBytes(clipboardImage.bytes, clipboardImage.mimeType);
+            }
+            return;
+        }
+        // Plain text paste — fall through to the InputRenderable's default
+        // insert path, which paints synchronously. Users whose intended image
+        // arrived as text-shaped bytes (e.g. Figma) can still trigger an
+        // explicit clipboard probe via the `/paste` slash command.
+    }
+    /**
+     * Manual clipboard probe. Read the OS clipboard for an image right now and
+     * attach it if found; otherwise fall back to a text probe so a Cmd+V/Ctrl+V
+     * keystroke that ate a legitimate text paste does not silently swallow it.
+     * The `source` distinguishes the keystroke entry point from the `/paste`
+     * slash command so we only emit the "no readable image" diagnostic for
+     * explicit user intent.
+     */
+    async triggerClipboardProbe(source) {
+        try {
+            const clipboardImage = await tryReadClipboardImage();
+            if (clipboardImage) {
+                await this.attachPastedImageBytes(clipboardImage.bytes, clipboardImage.mimeType);
+                return;
+            }
+            // No image on the clipboard. The keystroke path may have eaten a
+            // legitimate text paste, so fall back to a text probe so users do not
+            // lose what they were trying to paste.
+            const text = await tryReadClipboardText();
+            if (text) {
+                this.inputField.insertText(text);
+                return;
+            }
+            if (source === "slash") {
+                // Surface the actual clipboard UTI list when a /paste probe comes
+                // up empty — lets users see what their source app actually put
+                // there so the failure stops being mysterious.
+                const types = await describeMacClipboardTypes();
+                const detail = types
+                    ? ` — clipboard types: ${types}`
+                    : " — (could not query clipboard types; clipboard may be empty)";
+                this.appendBlock("[paste]", `clipboard had no readable image or text${detail}`, COLORS.system);
+            }
+        }
+        catch (error) {
+            this.appendBlock("[paste]", `clipboard probe failed: ${error instanceof Error ? error.message : String(error)}`, COLORS.error);
+        }
+    }
+    /**
+     * Attach an image from disk by path. Drives the `/image <path>` slash
+     * command. Inserts the `[Image #N]` placeholder back into the (likely now
+     * empty) input so the user can keep typing their prompt with the image
+     * already attached.
+     */
+    async attachImageFromPath(rawPath) {
+        try {
+            const pending = await loadImageFromPath({
+                cwd: this.workDir,
+                rawPath,
+                id: this.nextImageId,
+            });
+            this.nextImageId += 1;
+            this.pendingImages.push(pending);
+            this.inputField.insertText(pending.label);
+            this.appendBlock("[paste]", `attached ${pending.label} from ${pending.path}`, COLORS.system);
+            this.statusController.setPendingImageCount(this.pendingImages.length);
+        }
+        catch (error) {
+            this.appendBlock("[paste]", error instanceof Error ? error.message : String(error), COLORS.error);
+        }
+    }
+    /**
+     * Persist raw image bytes (from a bracketed-paste event or clipboard probe)
+     * under the session cache and surface the resulting `[Image #N]`
+     * placeholder in the prompt buffer.
+     */
+    async attachPastedImageBytes(bytes, mimeType) {
+        try {
+            const pending = await persistPastedImage({
+                sessionId: this.sessionId,
+                id: this.nextImageId,
+                bytes,
+                mimeType,
+            });
+            this.nextImageId += 1;
+            this.pendingImages.push(pending);
+            this.inputField.insertText(pending.label);
+            this.appendBlock("[paste]", `attached ${pending.label} (${mimeType}, ${formatBytes(bytes.length)})`, COLORS.system);
+            this.statusController.setPendingImageCount(this.pendingImages.length);
+        }
+        catch (error) {
+            this.appendBlock("[paste]", error instanceof Error ? error.message : String(error), COLORS.error);
+        }
+    }
+}
+function formatBytes(n) {
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)} KB`;
+    return `${(n / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=paste-controller.js.map

package/dist/src/tui/paste-controller.js.map

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

package/dist/src/tui/question-picker.d.ts

@@ -0,0 +1,111 @@
+import { type BoxRenderable, type KeyEvent, type TextareaRenderable, type TextRenderable } from "@opentui/core";
+import type { Session } from "../session/session.js";
+import type { TranscriptEntryKind } from "./transcript-log.js";
+import type { TurnPromptImage, TurnQuestion } from "../types/protocol.js";
+export interface QuestionPickerOptions {
+    /** Bordered panel that wraps the title + option rows; toggled visible
+     *  alongside the row pool. */
+    questionPanel: BoxRenderable;
+    /** Single text row used as the panel header; rewritten on every render
+     *  with the active question text and (i/N) progress. */
+    questionTitle: TextRenderable;
+    /** Fixed-size pool of selectable rows. The picker shows/hides entries
+     *  from this pool rather than mounting fresh renderables per question
+     *  so layout heights stay stable across questions. */
+    questionRows: TextRenderable[];
+    /** Composer textarea. Read for `plainText.length` so the picker can
+     *  defer Space/Left/Right bindings to typing when the user is mid-prompt. */
+    inputField: TextareaRenderable;
+    /** Session that receives the assembled answer payload via `.answer(...)`
+     *  once the user finishes the picker. */
+    session: Session;
+    /** Notify the host that the picker is about to swallow an Escape so the
+     *  global escape-to-exit handler suppresses the next Escape it sees and
+     *  doesn't double-handle the keystroke. */
+    onEscapeClose: () => void;
+    /** Append a bordered transcript block (label + body). Used for the
+     *  `you:` echo when the user confirms an answer, mirroring how free-form
+     *  prompts render. */
+    appendBlock: (label: string | null, body: string, color: string) => void;
+    /** Mirror committed answers into the in-memory transcript log so /copy
+     *  and resume snapshots include them in order. */
+    recordTranscriptEntry: (kind: TranscriptEntryKind, text: string) => void;
+    /** Surface a dispatch failure (rejected `session.answer` promise) the
+     *  same way the rest of runTui does. */
+    reportError: (error: unknown) => void;
+    /** Bridge to the status controller so the picker can flip the working
+     *  indicator on when an answer kicks off a new turn. */
+    markRunning: () => void;
+    /** Asked before `markRunning()` so the picker mirrors the host's
+     *  conditional "only mark when currently idle" behaviour. */
+    isRunning: () => boolean;
+}
+/**
+ * Owns the question picker: an ask terminal hands it a list of
+ * `TurnQuestion`s and the picker walks the user through them, accumulating
+ * selected option labels until the user either finishes the last question
+ * (dispatches an `answer`), types a free-form prompt over the top
+ * (`flushWithMessage`), or escapes out (host suppresses next escape so the
+ * TUI doesn't also exit).
+ *
+ * Single-select questions live-record the highlighted option as the answer
+ * so arrow navigation alone is enough; multi-select keeps the highlight
+ * separate from a checked-set toggled via Space/Enter and grows a synthetic
+ * "Done" row that advances to the next question.
+ */
+export declare class QuestionPicker {
+    private readonly opts;
+    private pendingQuestions;
+    private activeIndex;
+    private optionSelectedIndex;
+    private multiSelectChecked;
+    private accumulatedAnswers;
+    constructor(opts: QuestionPickerOptions);
+    isOpen(): boolean;
+    show(questions: TurnQuestion[]): void;
+    hide(): void;
+    /**
+     * Confirm whatever is currently highlighted. Multi-select on a regular row
+     * toggles; multi-select on the Done row advances. Single-select always
+     * advances (highlight = answer is already live-recorded by Up/Down). No-op
+     * when nothing is highlighted yet so the user is forced to make an
+     * explicit choice (or skip via Right-arrow).
+     */
+    confirmSelection(): boolean;
+    /**
+     * Dispatch the partially-collected answers together with a free-form
+     * `message` (and any pending image attachments) as a single
+     * `session.answer({ ..., message, images })` turn, then hide the picker.
+     * Used when the user types over the top of an open picker — without this
+     * the partial selections would be discarded when the prompt fires.
+     */
+    flushWithMessage(message: string, images: TurnPromptImage[]): void;
+    /**
+     * Handle a keystroke while the picker is open. Returns `true` if the key
+     * was claimed (and `key.preventDefault()` already called); the caller
+     * should stop further dispatch in that case. Returns `false` when the
+     * picker is closed or the key isn't one this controller handles.
+     */
+    handleKey(key: KeyEvent): boolean;
+    private activeQuestion;
+    /**
+     * Total navigable rows for the active question. The Up/Down handler clamps
+     * navigation to what is actually rendered on screen so a user cannot land
+     * the highlight on a row they cannot see.
+     */
+    private activeRowCount;
+    /**
+     * Row index of the synthetic Done row when the active question is
+     * multi-select; `undefined` otherwise so callers don't compare against a
+     * sentinel value. The Done row sits one past the last visible option,
+     * clamped to the same limit `render()` uses.
+     */
+    private activeQuestionDoneIndex;
+    private render;
+    private moveActiveHighlight;
+    private toggleActiveMultiSelectOption;
+    private navigateActive;
+    private describeAnswerLabels;
+    private advanceOrSubmit;
+}
+//# sourceMappingURL=question-picker.d.ts.map

package/dist/src/tui/question-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-picker.d.ts","sourceRoot":"","sources":["../../../src/tui/question-picker.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,QAAQ,EAEb,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AASvB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAI1E,MAAM,WAAW,qBAAqB;IACpC;kCAC8B;IAC9B,aAAa,EAAE,aAAa,CAAC;IAC7B;4DACwD;IACxD,aAAa,EAAE,cAAc,CAAC;IAC9B;;0DAEsD;IACtD,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B;iFAC6E;IAC7E,UAAU,EAAE,kBAAkB,CAAC;IAC/B;6CACyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB;;+CAE2C;IAC3C,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B;;0BAEsB;IACtB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE;sDACkD;IAClD,qBAAqB,EAAE,CAAC,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzE;4CACwC;IACxC,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC;4DACwD;IACxD,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB;iEAC6D;IAC7D,SAAS,EAAE,MAAM,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAc;IAiBb,OAAO,CAAC,QAAQ,CAAC,IAAI;IAhBjC,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,OAAO,CAAC,WAAW,CAAK;IAKxB,OAAO,CAAC,mBAAmB,CAAgB;IAI3C,OAAO,CAAC,kBAAkB,CAAqB;IAI/C,OAAO,CAAC,kBAAkB,CAAgC;gBAE7B,IAAI,EAAE,qBAAqB;IAExD,MAAM,IAAI,OAAO;IAKjB,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,IAAI;IASrC,IAAI,IAAI,IAAI;IAaZ;;;;;;OAMG;IACH,gBAAgB,IAAI,OAAO;IAW3B;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI;IAclE;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO;IA8CjC,OAAO,CAAC,cAAc;IAItB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,MAAM;IAyDd,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,6BAA6B;IAiBrC,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,eAAe;CA8BxB"}