@promptctl/rich-js 0.1.0

package/dist/widgets/dropdown.js

@@ -0,0 +1,373 @@
+/**
+ * Dropdown widget — single-select from option list, with built-in filter.
+ *
+ * [LAW:one-source-of-truth] Inline footprint (always 1 row, the header)
+ * is independent of rendered shape (1 row collapsed, 1 + M rows expanded
+ * where M = filteredOptions.length, or 1 when no matches). render() emits
+ * the header row only; renderOverlay() emits option rows or a
+ * "(no matches)" placeholder.
+ *
+ * [LAW:dataflow-not-control-flow] `expanded` and `filter` are data;
+ * layout never reserves space for the option list; the overlay pass
+ * paints over whatever is below.
+ *
+ * [LAW:one-source-of-truth] `options` and `selectedIndex` are canonical.
+ * `filter` is internal view state. `filteredOptions` is the derived
+ * subsequence (case-insensitive substring match). `highlightedIndex`
+ * indexes into `filteredOptions`. Commit maps the filtered position
+ * back to canonical idx by reference, so selection survives any filter
+ * mutation.
+ *
+ * Width invariant: measure() always returns maxLabelLen(options) + 4
+ * regardless of filter state — the query is right-clipped, never wider
+ * than the header. See spec/widgets.md → Dropdown → Filtering.
+ */
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { observable, action } from "mobx";
+import { Segment } from "../core/segment.js";
+import { Style } from "../core/style.js";
+import { ColorSpec } from "../core/color.js";
+import { DEFAULT_TERMINAL_THEME } from "../themes/terminalThemes.js";
+import { WidgetBase } from "./widget-base.js";
+let Dropdown = (() => {
+    var _a;
+    let _classSuper = WidgetBase;
+    let _instanceExtraInitializers = [];
+    let _options_decorators;
+    let _options_initializers = [];
+    let _options_extraInitializers = [];
+    let _selectedIndex_decorators;
+    let _selectedIndex_initializers = [];
+    let _selectedIndex_extraInitializers = [];
+    let _expanded_decorators;
+    let _expanded_initializers = [];
+    let _expanded_extraInitializers = [];
+    let _highlightedIndex_decorators;
+    let _highlightedIndex_initializers = [];
+    let _highlightedIndex_extraInitializers = [];
+    let _filter_decorators;
+    let _filter_initializers = [];
+    let _filter_extraInitializers = [];
+    let _handleKey_decorators;
+    let _handleMouse_decorators;
+    let _setHovered_decorators;
+    return class Dropdown extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _options_decorators = [(_a = observable).shallow.bind(_a)];
+            _selectedIndex_decorators = [observable];
+            _expanded_decorators = [observable];
+            _highlightedIndex_decorators = [observable];
+            _filter_decorators = [observable];
+            _handleKey_decorators = [action];
+            _handleMouse_decorators = [action];
+            _setHovered_decorators = [action];
+            __esDecorate(this, null, _options_decorators, { kind: "accessor", name: "options", static: false, private: false, access: { has: obj => "options" in obj, get: obj => obj.options, set: (obj, value) => { obj.options = value; } }, metadata: _metadata }, _options_initializers, _options_extraInitializers);
+            __esDecorate(this, null, _selectedIndex_decorators, { kind: "accessor", name: "selectedIndex", static: false, private: false, access: { has: obj => "selectedIndex" in obj, get: obj => obj.selectedIndex, set: (obj, value) => { obj.selectedIndex = value; } }, metadata: _metadata }, _selectedIndex_initializers, _selectedIndex_extraInitializers);
+            __esDecorate(this, null, _expanded_decorators, { kind: "accessor", name: "expanded", static: false, private: false, access: { has: obj => "expanded" in obj, get: obj => obj.expanded, set: (obj, value) => { obj.expanded = value; } }, metadata: _metadata }, _expanded_initializers, _expanded_extraInitializers);
+            __esDecorate(this, null, _highlightedIndex_decorators, { kind: "accessor", name: "highlightedIndex", static: false, private: false, access: { has: obj => "highlightedIndex" in obj, get: obj => obj.highlightedIndex, set: (obj, value) => { obj.highlightedIndex = value; } }, metadata: _metadata }, _highlightedIndex_initializers, _highlightedIndex_extraInitializers);
+            __esDecorate(this, null, _filter_decorators, { kind: "accessor", name: "filter", static: false, private: false, access: { has: obj => "filter" in obj, get: obj => obj.filter, set: (obj, value) => { obj.filter = value; } }, metadata: _metadata }, _filter_initializers, _filter_extraInitializers);
+            __esDecorate(this, null, _handleKey_decorators, { kind: "method", name: "handleKey", static: false, private: false, access: { has: obj => "handleKey" in obj, get: obj => obj.handleKey }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _handleMouse_decorators, { kind: "method", name: "handleMouse", static: false, private: false, access: { has: obj => "handleMouse" in obj, get: obj => obj.handleMouse }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _setHovered_decorators, { kind: "method", name: "setHovered", static: false, private: false, access: { has: obj => "setHovered" in obj, get: obj => obj.setHovered }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        id = __runInitializers(this, _instanceExtraInitializers);
+        focusable = true;
+        #options_accessor_storage = __runInitializers(this, _options_initializers, void 0);
+        get options() { return this.#options_accessor_storage; }
+        set options(value) { this.#options_accessor_storage = value; }
+        #selectedIndex_accessor_storage = (__runInitializers(this, _options_extraInitializers), __runInitializers(this, _selectedIndex_initializers, void 0));
+        get selectedIndex() { return this.#selectedIndex_accessor_storage; }
+        set selectedIndex(value) { this.#selectedIndex_accessor_storage = value; }
+        #expanded_accessor_storage = (__runInitializers(this, _selectedIndex_extraInitializers), __runInitializers(this, _expanded_initializers, false));
+        get expanded() { return this.#expanded_accessor_storage; }
+        set expanded(value) { this.#expanded_accessor_storage = value; }
+        #highlightedIndex_accessor_storage = (__runInitializers(this, _expanded_extraInitializers), __runInitializers(this, _highlightedIndex_initializers, void 0));
+        get highlightedIndex() { return this.#highlightedIndex_accessor_storage; }
+        set highlightedIndex(value) { this.#highlightedIndex_accessor_storage = value; }
+        #filter_accessor_storage = (__runInitializers(this, _highlightedIndex_extraInitializers), __runInitializers(this, _filter_initializers, ""));
+        get filter() { return this.#filter_accessor_storage; }
+        set filter(value) { this.#filter_accessor_storage = value; }
+        // [LAW:dataflow-not-control-flow] Derived view; empty filter falls out
+        // naturally because "".includes("") is true for every label — no
+        // special-case branch.
+        get filteredOptions() {
+            const f = this.filter.toLowerCase();
+            const result = [];
+            for (let i = 0; i < this.options.length; i++) {
+                const label = this.options[i];
+                if (label.toLowerCase().includes(f))
+                    result.push({ label, idx: i });
+            }
+            return result;
+        }
+        _theme = __runInitializers(this, _filter_extraInitializers);
+        constructor(options) {
+            super();
+            this.id = options.id ?? `dropdown-${Math.random().toString(36).slice(2, 8)}`;
+            this.options = [...options.options];
+            this.selectedIndex = options.selectedIndex ?? 0;
+            this.highlightedIndex = this.selectedIndex;
+            this.disabled = options.disabled ?? false;
+            this._theme = options.theme ?? DEFAULT_TERMINAL_THEME;
+        }
+        setTheme(theme) { this._theme = theme; }
+        // --- Event handlers ---
+        handleKey(event) {
+            if (this.disabled)
+                return;
+            const isPrintable = event.character.length === 1 &&
+                !event.ctrl &&
+                !event.meta &&
+                event.character >= " " &&
+                event.character !== "\x7f";
+            if (!this.expanded) {
+                // enter/space remain the explicit "open with selection seeded" gesture.
+                if (event.key === "enter" || event.key === "space") {
+                    this.expanded = true;
+                    this.highlightedIndex = this.selectedIndex;
+                    return;
+                }
+                // Any other printable char auto-expands and starts filtering.
+                if (isPrintable) {
+                    this.expanded = true;
+                    this.filter = this.filter + event.character;
+                    this.highlightedIndex = 0;
+                }
+                return;
+            }
+            // expanded
+            switch (event.key) {
+                case "up":
+                    this.highlightedIndex = Math.max(0, this.highlightedIndex - 1);
+                    return;
+                case "down": {
+                    const max = Math.max(0, this.filteredOptions.length - 1);
+                    this.highlightedIndex = Math.min(max, this.highlightedIndex + 1);
+                    return;
+                }
+                case "enter": {
+                    // [LAW:one-source-of-truth] Map filtered position → canonical idx.
+                    // No-op when filteredOptions is empty (highlighted is undefined).
+                    const picked = this.filteredOptions[this.highlightedIndex];
+                    if (picked === undefined)
+                        return;
+                    this.selectedIndex = picked.idx;
+                    this.filter = "";
+                    this.expanded = false;
+                    this.emitChange();
+                    this.emitSubmit();
+                    return;
+                }
+                case "escape":
+                    // Single-step: clear filter + collapse.
+                    this.filter = "";
+                    this.expanded = false;
+                    return;
+                case "backspace":
+                    // [LAW:dataflow-not-control-flow] slice(0,-1) on "" is "" — no guard.
+                    this.filter = this.filter.slice(0, -1);
+                    this.highlightedIndex = 0;
+                    return;
+            }
+            if (isPrintable) {
+                this.filter = this.filter + event.character;
+                this.highlightedIndex = 0;
+            }
+        }
+        handleMouse(event) {
+            if (this.disabled)
+                return;
+            if (event.type !== "mouse_up")
+                return;
+            const b = this.bounds;
+            if (!b)
+                return;
+            const inside = event.x >= b.x &&
+                event.x < b.x + b.width &&
+                event.y >= b.y &&
+                event.y < b.y + b.height;
+            if (!this.expanded) {
+                if (inside) {
+                    this.expanded = true;
+                    this.highlightedIndex = this.selectedIndex;
+                }
+                return;
+            }
+            // expanded: row 0 is the header; rows 1..M are filtered options.
+            if (!inside) {
+                // Click outside cancels — clear filter + collapse.
+                this.filter = "";
+                this.expanded = false;
+                return;
+            }
+            const rowOffset = event.y - b.y;
+            if (rowOffset === 0) {
+                // Click the header → collapse + clear filter, no selection change.
+                this.filter = "";
+                this.expanded = false;
+                return;
+            }
+            // [LAW:one-source-of-truth] Filtered position → canonical idx.
+            const picked = this.filteredOptions[rowOffset - 1];
+            if (picked === undefined)
+                return;
+            this.selectedIndex = picked.idx;
+            this.filter = "";
+            this.expanded = false;
+            this.emitChange();
+            this.emitSubmit();
+        }
+        // --- Hover mutator (router fast-path) ---
+        setHovered(value) { this.hovered = value; }
+        // --- Rendering ---
+        render(options) {
+            // Header only — the inline footprint that flow layout sees. Always
+            // 1 row regardless of `expanded`/`filter`. Option rows live in
+            // renderOverlay. Width invariant: maxLabelLen + 4.
+            const arrowChar = options.asciiOnly ? "v" : "▾";
+            const maxLabelLen = this.maxLabelLen();
+            const baseStyle = this.disabled
+                ? new Style({ color: "#666666", bgcolor: "#333333", dim: true })
+                : new Style({
+                    color: this.resolvePalette("foreground"),
+                    bgcolor: this.resolvePalette("surface"),
+                    underline: this.focused,
+                });
+            const headerLabel = this.headerText(maxLabelLen);
+            return [
+                new Segment("[", baseStyle),
+                new Segment(`${headerLabel} ${arrowChar}`, baseStyle),
+                new Segment("]", baseStyle),
+            ];
+        }
+        // [LAW:dataflow-not-control-flow] One header text function; the data
+        // (filter empty vs not) chooses between selected-label and query+cursor.
+        // Both branches yield exactly maxLabelLen cells — width invariant.
+        headerText(maxLabelLen) {
+            if (this.filter === "") {
+                return (this.options[this.selectedIndex] ?? "").padEnd(maxLabelLen, " ");
+            }
+            const cursor = this.focused ? "│" : "";
+            const filterRoom = Math.max(0, maxLabelLen - cursor.length);
+            const filterText = this.filter.slice(0, filterRoom);
+            return (filterText + cursor).padEnd(maxLabelLen, " ");
+        }
+        renderOverlay(_options) {
+            if (!this.expanded)
+                return null;
+            const maxLabelLen = this.maxLabelLen();
+            const fopts = this.filteredOptions;
+            if (fopts.length === 0)
+                return this.renderNoMatchRow(maxLabelLen);
+            const segments = [];
+            for (let i = 0; i < fopts.length; i++) {
+                if (i > 0)
+                    segments.push(new Segment("\n"));
+                segments.push(...this.renderOptionRow(fopts[i], i, maxLabelLen));
+            }
+            return segments;
+        }
+        renderNoMatchRow(maxLabelLen) {
+            // Right-clipped + padded so width matches a normal option row.
+            const text = "(no matches)".slice(0, maxLabelLen).padEnd(maxLabelLen, " ");
+            const inner = ` ${text} `;
+            const style = this.disabled
+                ? new Style({ color: "#666666", bgcolor: "#333333", dim: true })
+                : new Style({
+                    color: this.resolvePalette("foreground"),
+                    bgcolor: this.resolvePalette("surface"),
+                    dim: true,
+                });
+            return [
+                new Segment("[", style),
+                new Segment(inner, style),
+                new Segment("]", style),
+            ];
+        }
+        renderOptionRow(entry, fpos, maxLabelLen) {
+            // Row: "[ " + label.padEnd(maxLabelLen) + " ]"
+            // Width = 1 + 1 + maxLabelLen + 1 + 1 = maxLabelLen + 4.
+            const label = entry.label.padEnd(maxLabelLen, " ");
+            const inner = ` ${label} `;
+            const isSelected = entry.idx === this.selectedIndex;
+            const isHighlighted = fpos === this.highlightedIndex;
+            // Highlighted: muted bg → text-primary (mostly-accent fg) is readable.
+            // Selected:    full primary bg → on-primary (WCAG contrast) for fg.
+            const rowStyle = this.disabled
+                ? new Style({ color: "#666666", bgcolor: "#333333", dim: true })
+                : isHighlighted
+                    ? new Style({
+                        color: this.resolvePalette("text-primary"),
+                        bgcolor: this.resolvePalette("primary-muted"),
+                    })
+                    : isSelected
+                        ? new Style({
+                            color: this.resolvePalette("on-primary"),
+                            bgcolor: this.resolvePalette("primary"),
+                        })
+                        : new Style({
+                            color: this.resolvePalette("foreground"),
+                            bgcolor: this.resolvePalette("surface"),
+                        });
+            return [
+                new Segment("[", rowStyle),
+                new Segment(inner, rowStyle),
+                new Segment("]", rowStyle),
+            ];
+        }
+        maxLabelLen() {
+            let m = 0;
+            for (const label of this.options)
+                if (label.length > m)
+                    m = label.length;
+            return m;
+        }
+        measure(_options) {
+            const width = this.maxLabelLen() + 4;
+            return { minimum: width, maximum: width };
+        }
+        // --- Palette resolution ---
+        resolvePalette(key) {
+            const rgba = this._theme.palette.get(key);
+            // [LAW:no-defensive-null-guards] palette must contain all keys.
+            return ColorSpec.fromRgba(rgba);
+        }
+    };
+})();
+export { Dropdown };
+//# sourceMappingURL=dropdown.js.map

package/dist/widgets/dropdown.js.map

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

package/dist/widgets/event-router.d.ts

@@ -0,0 +1,73 @@
+/**
+ * EventRouter — parses raw stdin into KeyEvent / WidgetMouseEvent values
+ * and dispatches them to widgets via the Screen's FocusManager and bounds.
+ *
+ * [LAW:single-enforcer] ANSI escape parsing lives only here — widgets never
+ * see raw bytes. One parser, one dispatch surface.
+ *
+ * [LAW:dataflow-not-control-flow] The same parse pipeline runs for every
+ * input chunk: append → consume one event at a time until the buffer can't
+ * yield more. The byte's value, not a side-mode, decides which event is
+ * emitted. There is no "are we mid-sequence" mode flag — the buffer head
+ * carries all the state we need.
+ *
+ * Lone-ESC handling: a bare `\x1b` is ambiguous (escape key vs. start of a
+ * CSI sequence). When the buffer is drained but ends with a lone ESC, the
+ * router defers emission via setImmediate. The next chunk cancels the timer
+ * if it extends the sequence. Tests can call `flush()` to drain synchronously.
+ */
+import type { Screen, FocusManager, InteractiveWidget, KeyEvent, WidgetMouseEvent, Unsubscribe } from "./types.js";
+type WidgetSource = {
+    focusManager: FocusManager;
+    getWidgets: () => readonly InteractiveWidget[];
+};
+export interface EventRouterOptions {
+    screen: Screen | WidgetSource;
+    input?: NodeJS.ReadableStream & {
+        setRawMode?: (raw: boolean) => unknown;
+        isTTY?: boolean;
+    };
+    output?: NodeJS.WritableStream;
+    /**
+     * When true (default when output is a TTY), enable mouse tracking on
+     * start() and disable on stop(). Disable in tests / non-TTY environments.
+     */
+    manageMouse?: boolean;
+    /**
+     * When true (default when input is a TTY), put stdin into raw mode on
+     * start() and restore on stop().
+     */
+    manageRawMode?: boolean;
+}
+export declare class EventRouter {
+    private readonly source;
+    private readonly input;
+    private readonly output;
+    private readonly manageMouse;
+    private readonly manageRawMode;
+    private buffer;
+    private running;
+    private dataListener;
+    private escTimer;
+    private readonly keyHandlers;
+    private readonly mouseHandlers;
+    constructor(options: EventRouterOptions);
+    start(): void;
+    stop(): void;
+    onKey(handler: (event: KeyEvent) => void): Unsubscribe;
+    onMouse(handler: (event: WidgetMouseEvent) => void): Unsubscribe;
+    /** Feed a chunk of bytes (or a string of bytes) into the parser. */
+    feed(chunk: Buffer | string): void;
+    /** Force any pending lone ESC out of the buffer. */
+    flush(): void;
+    private drain;
+    private consumeOne;
+    private consumePrintable;
+    private consumeEscape;
+    private consumeSS3;
+    private consumeCSI;
+    private dispatchKey;
+    private dispatchMouse;
+}
+export {};
+//# sourceMappingURL=event-router.d.ts.map

package/dist/widgets/event-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-router.d.ts","sourceRoot":"","sources":["../../src/widgets/event-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,iBAAiB,EACjB,QAAQ,EACR,gBAAgB,EAChB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,KAAK,YAAY,GAAG;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,MAAM,SAAS,iBAAiB,EAAE,CAAC;CAChD,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,GAAG;QAC9B,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;QACvC,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AA+ED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IAExC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAiD;IACrE,OAAO,CAAC,QAAQ,CAA8C;IAE9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwC;IACpE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgD;gBAElE,OAAO,EAAE,kBAAkB;IAiBvC,KAAK,IAAI,IAAI;IAsBb,IAAI,IAAI,IAAI;IAqBZ,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,WAAW;IAKtD,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,WAAW;IAOhE,oEAAoE;IACpE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAkBlC,oDAAoD;IACpD,KAAK,IAAI,IAAI;IAab,OAAO,CAAC,KAAK;IAWb,OAAO,CAAC,UAAU;IA6ClB,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,UAAU;IAuDlB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,aAAa;CAyBtB"}