@profullstack/hqtui 0.1.0

package/dist/app.js

@@ -0,0 +1,296 @@
+import { FrameBuffer } from "./buffer.js";
+import { Encoder } from "./diff.js";
+import { ansi } from "./ansi.js";
+import { Terminal, emergencyRestore } from "./terminal.js";
+import { resolveTheme, themes } from "./theme.js";
+import { Surface, createSurface } from "./surface.js";
+import { Container } from "./ui.js";
+import { matchKey } from "./input.js";
+/**
+ * The application: owns the terminal, both framebuffers, the scheduler and the
+ * event loop. Everything else in the library is reachable from here.
+ */
+export class App {
+    terminal;
+    capabilities;
+    theme;
+    current;
+    previous;
+    encoder;
+    renderFn = () => { };
+    options;
+    listeners = new Map();
+    running = false;
+    dirty = true;
+    forceRepaint = true;
+    timer = null;
+    startedAt = 0;
+    frameCount = 0;
+    lastFrameAt = 0;
+    exitResolve = null;
+    focusIndex = 0;
+    focusCount = 0;
+    focusActions = [];
+    hits = [];
+    overlays = [];
+    lastStats = { frame: 0, renderMs: 0, changedCells: 0, dirtyRows: 0, bytes: 0, fps: 0 };
+    constructor(options = {}) {
+        this.options = options;
+        this.terminal = new Terminal(options);
+        this.capabilities = this.terminal.capabilities;
+        this.theme = resolveTheme(options.theme);
+        const { columns, rows } = this.terminal.size();
+        this.current = new FrameBuffer(columns, rows);
+        this.previous = new FrameBuffer(columns, rows);
+        this.encoder = new Encoder({
+            colors: this.capabilities.colors,
+            monochrome: options.monochrome ?? this.capabilities.colors === "none",
+        });
+    }
+    get width() {
+        return this.current.width;
+    }
+    get height() {
+        return this.current.height;
+    }
+    /** Stats for the most recent frame. */
+    get stats() {
+        return this.lastStats;
+    }
+    /** Register the view. Called on every frame; keep it pure and cheap. */
+    render(fn) {
+        this.renderFn = fn;
+        this.dirty = true;
+        return this;
+    }
+    /** Ask for a redraw. The scheduler coalesces repeated calls into one frame. */
+    invalidate() {
+        this.dirty = true;
+    }
+    /** Force a full repaint, e.g. after another process wrote to the terminal. */
+    redraw() {
+        this.forceRepaint = true;
+        this.dirty = true;
+    }
+    setTheme(theme) {
+        this.theme = resolveTheme(theme);
+        this.redraw();
+        return this;
+    }
+    on(event, listener) {
+        let set = this.listeners.get(event);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(event, set);
+        }
+        set.add(listener);
+        return () => set.delete(listener);
+    }
+    emit(event, value) {
+        const set = this.listeners.get(event);
+        if (!set)
+            return;
+        for (const listener of set)
+            listener(value);
+    }
+    /** Move keyboard focus. Wraps around. */
+    focusNext(delta = 1) {
+        if (this.focusCount === 0)
+            return;
+        this.focusIndex = (this.focusIndex + delta + this.focusCount) % this.focusCount;
+        this.dirty = true;
+    }
+    /** Activate the focused control, as Enter does. */
+    activateFocused() {
+        this.focusActions[this.focusIndex]?.();
+        this.dirty = true;
+    }
+    /** Start the loop. Resolves when the app exits. */
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.startedAt = Date.now();
+        this.terminal.enter();
+        this.terminal.onInput((event) => this.handleInput(event));
+        this.terminal.onResizeEvent(({ columns, rows }) => {
+            this.current.resize(columns, rows);
+            this.previous.resize(columns, rows);
+            this.forceRepaint = true;
+            this.dirty = true;
+            this.emit("resize", { width: columns, height: rows });
+            this.frame();
+        });
+        const fps = this.targetFps();
+        const interval = Math.max(8, Math.floor(1000 / fps));
+        this.frame();
+        this.timer = setInterval(() => {
+            if (this.options.alwaysRender || this.dirty)
+                this.frame();
+        }, interval);
+        this.timer.unref?.();
+        await new Promise((resolve) => {
+            this.exitResolve = resolve;
+        });
+    }
+    targetFps() {
+        const base = this.options.fps ?? 30;
+        if (this.capabilities.ssh)
+            return Math.min(base, this.options.remoteFps ?? 15);
+        return base;
+    }
+    /** Stop the loop and restore the terminal. */
+    stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+        this.terminal.restore();
+        this.emit("exit", undefined);
+        this.exitResolve?.();
+        this.exitResolve = null;
+    }
+    /** Alias for `stop()`, matching what users type in their key handlers. */
+    quit() {
+        this.stop();
+    }
+    handleInput(event) {
+        if (event.type === "key") {
+            const quitKeys = this.options.quitKeys ?? ["ctrl+c", "q"];
+            if (quitKeys.some((k) => matchKey(event, k))) {
+                this.emit("key", event);
+                this.stop();
+                return;
+            }
+            if (this.options.focusNavigation !== false) {
+                if (event.name === "tab") {
+                    this.focusNext(event.shift ? -1 : 1);
+                }
+                else if (event.name === "enter" || event.name === "space") {
+                    this.activateFocused();
+                }
+            }
+            this.emit("key", event);
+            this.dirty = true;
+            return;
+        }
+        if (event.type === "mouse") {
+            this.dispatchMouse(event);
+            this.emit("mouse", event);
+            return;
+        }
+        if (event.type === "paste") {
+            this.emit("paste", event);
+            this.dirty = true;
+            return;
+        }
+        this.emit("focus", event);
+    }
+    dispatchMouse(event) {
+        // Later regions are drawn on top, so hit-test in reverse.
+        for (let i = this.hits.length - 1; i >= 0; i--) {
+            const hit = this.hits[i];
+            const r = hit.rect;
+            if (event.x < r.x || event.y < r.y || event.x >= r.x + r.width || event.y >= r.y + r.height)
+                continue;
+            if (event.action === "scroll")
+                hit.onScroll?.(event.scroll);
+            else if (event.action === "press")
+                hit.onClick?.(event.x - r.x, event.y - r.y, event.button);
+            else if (event.action === "move")
+                hit.onHover?.(event.x - r.x, event.y - r.y);
+            this.dirty = true;
+            return;
+        }
+    }
+    /** Build one frame and push the difference to the terminal. */
+    frame() {
+        const started = performance.now();
+        this.dirty = false;
+        const size = this.terminal.size();
+        if (size.columns !== this.current.width || size.rows !== this.current.height) {
+            this.current.resize(size.columns, size.rows);
+            this.previous.resize(size.columns, size.rows);
+            this.forceRepaint = true;
+        }
+        this.current.clear(this.options.paintBackground === false ? undefined : this.theme.background, this.theme.foreground);
+        this.hits = [];
+        this.overlays = [];
+        this.focusActions = [];
+        let focusCursor = 0;
+        const ctx = {
+            theme: this.theme,
+            capabilities: this.capabilities,
+            width: this.current.width,
+            height: this.current.height,
+            frame: this.frameCount,
+            elapsed: Date.now() - this.startedAt,
+            focusIndex: this.focusIndex,
+            registerFocus: (action) => {
+                const index = focusCursor++;
+                if (action)
+                    this.focusActions[index] = action;
+                return { index, focused: index === this.focusIndex };
+            },
+            hit: (region) => this.hits.push(region),
+            overlay: (draw) => this.overlays.push(draw),
+            invalidate: () => this.invalidate(),
+        };
+        const root = createSurface(this.current, this.theme);
+        const container = new Container(root, ctx, "column");
+        this.renderFn({
+            ui: container,
+            theme: this.theme,
+            capabilities: this.capabilities,
+            width: this.current.width,
+            height: this.current.height,
+            frame: this.frameCount,
+            elapsed: ctx.elapsed,
+            focus: this.focusIndex,
+            app: this,
+        });
+        container.flush();
+        for (const overlay of this.overlays)
+            overlay(root);
+        this.focusCount = Math.max(focusCursor, 0);
+        if (this.focusCount > 0 && this.focusIndex >= this.focusCount)
+            this.focusIndex = 0;
+        const result = this.encoder.encode(this.previous, this.current, this.forceRepaint);
+        this.forceRepaint = false;
+        let output = result.output;
+        if (output.length > 0) {
+            if (this.capabilities.synchronizedOutput)
+                output = ansi.beginSync + output + ansi.endSync;
+            this.terminal.write(output);
+        }
+        this.previous.copyFrom(this.current);
+        const now = performance.now();
+        const stats = {
+            frame: this.frameCount++,
+            renderMs: now - started,
+            changedCells: result.changedCells,
+            dirtyRows: result.dirtyRows,
+            bytes: output.length,
+            fps: this.lastFrameAt ? 1000 / Math.max(1, now - this.lastFrameAt) : 0,
+        };
+        this.lastFrameAt = now;
+        this.lastStats = stats;
+        this.emit("frame", stats);
+        return stats;
+    }
+}
+/**
+ * Create an app. Every option has a sensible default: dark theme, mouse on,
+ * 30fps, alternate screen, terminal restored no matter how the process dies.
+ *
+ *   const app = await createApp();
+ *   app.render(({ ui }) => ui.panel({ title: "Hello" }, p => p.text("Hi")));
+ *   await app.start();
+ */
+export async function createApp(options = {}) {
+    return new App(options);
+}
+export { emergencyRestore, themes };
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAwB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjF,OAAO,EAA8B,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,SAAS,EAA8D,MAAM,SAAS,CAAC;AAEhG,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA0DtC;;;GAGG;AACH,MAAM,OAAO,GAAG;IACL,QAAQ,CAAW;IACnB,YAAY,CAAe;IACpC,KAAK,CAAQ;IAEL,OAAO,CAAc;IACrB,QAAQ,CAAc;IACtB,OAAO,CAAU;IACjB,QAAQ,GAAa,GAAG,EAAE,GAAE,CAAC,CAAC;IAC9B,OAAO,CAAa;IACpB,SAAS,GAAG,IAAI,GAAG,EAA+C,CAAC;IAEnE,OAAO,GAAG,KAAK,CAAC;IAChB,KAAK,GAAG,IAAI,CAAC;IACb,YAAY,GAAG,IAAI,CAAC;IACpB,KAAK,GAA0B,IAAI,CAAC;IACpC,SAAS,GAAG,CAAC,CAAC;IACd,UAAU,GAAG,CAAC,CAAC;IACf,WAAW,GAAG,CAAC,CAAC;IAChB,WAAW,GAAwB,IAAI,CAAC;IAExC,UAAU,GAAG,CAAC,CAAC;IACf,UAAU,GAAG,CAAC,CAAC;IACf,YAAY,GAAmB,EAAE,CAAC;IAClC,IAAI,GAAgB,EAAE,CAAC;IACvB,QAAQ,GAAgC,EAAE,CAAC;IAC3C,SAAS,GAAe,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IAE3G,YAAY,UAAsB,EAAE;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC/C,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEzC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC;YACzB,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM;YAChC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,MAAM;SACtE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;IAC5B,CAAC;IACD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IACD,uCAAuC;IACvC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,wEAAwE;IACxE,MAAM,CAAC,EAAY;QACjB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+EAA+E;IAC/E,UAAU;QACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,8EAA8E;IAC9E,MAAM;QACJ,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,QAAQ,CAAC,KAAiC;QACxC,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,EAAE,CAA2B,KAAQ,EAAE,QAAsC;QAC3E,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAAkC,CAAC,CAAC;QAC5C,OAAO,GAAG,EAAE,CAAC,GAAI,CAAC,MAAM,CAAC,QAAkC,CAAC,CAAC;IAC/D,CAAC;IAEO,IAAI,CAA2B,KAAQ,EAAE,KAAkB;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,KAAK,MAAM,QAAQ,IAAI,GAAG;YAAG,QAAqC,CAAC,KAAK,CAAC,CAAC;IAC5E,CAAC;IAED,yCAAyC;IACzC,SAAS,CAAC,KAAK,GAAG,CAAC;QACjB,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC;YAAE,OAAO;QAClC,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,UAAU,GAAG,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;QAChF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,mDAAmD;IACnD,eAAe;QACb,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAEtB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;YAChD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5D,CAAC,EAAE,QAAQ,CAAC,CAAC;QACb,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAErB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,SAAS;QACf,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC/E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8CAA8C;IAC9C,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,CAAC,KAAK;YAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC7B,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,0EAA0E;IAC1E,IAAI;QACF,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEO,WAAW,CAAC,KAAiB;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC1D,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7C,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBACxB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe,KAAK,KAAK,EAAE,CAAC;gBAC3C,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;oBACzB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvC,CAAC;qBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBAC5D,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzB,CAAC;YACH,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IAEO,aAAa,CAAC,KAAiB;QACrC,0DAA0D;QAC1D,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;YACnB,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM;gBAAE,SAAS;YACtG,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;gBAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;iBACvD,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO;gBAAE,GAAG,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;iBACxF,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;gBAAE,GAAG,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9E,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,OAAO;QACT,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,KAAK;QACH,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAC7E,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACtH,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACvB,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,MAAM,GAAG,GAAkB;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;YACzB,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YAC3B,KAAK,EAAE,IAAI,CAAC,UAAU;YACtB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;YACpC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,aAAa,EAAE,CAAC,MAAmB,EAAqB,EAAE;gBACxD,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;gBAC5B,IAAI,MAAM;oBAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;gBAC9C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;YACvD,CAAC;YACD,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YACvC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3C,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE;SACpC,CAAC;QAEF,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,CAAC;YACZ,EAAE,EAAE,SAAS;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;YACzB,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YAC3B,KAAK,EAAE,IAAI,CAAC,UAAU;YACtB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,KAAK,EAAE,IAAI,CAAC,UAAU;YACtB,GAAG,EAAE,IAAI;SACV,CAAC,CAAC;QACH,SAAS,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAEnD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU;YAAE,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QAEnF,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACnF,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAE1B,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC3B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,YAAY,CAAC,kBAAkB;gBAAE,MAAM,GAAG,IAAI,CAAC,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;YAC1F,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAErC,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAe;YACxB,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE;YACxB,QAAQ,EAAE,GAAG,GAAG,OAAO;YACvB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,MAAM,CAAC,MAAM;YACpB,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;SACvE,CAAC;QACF,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAAsB,EAAE;IACtD,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC"}

package/dist/buffer.d.ts

@@ -0,0 +1,50 @@
+import { type Color } from "./color.ts";
+/** Style attribute bits packed into the cell's 16-bit attribute slot. */
+export declare const Attr: {
+    readonly None: 0;
+    readonly Bold: number;
+    readonly Dim: number;
+    readonly Italic: number;
+    readonly Underline: number;
+    readonly Blink: number;
+    readonly Reverse: number;
+    readonly Strike: number;
+};
+export type Attributes = number;
+export interface Style {
+    fg?: Color;
+    bg?: Color;
+    attrs?: Attributes;
+}
+/**
+ * The screen is one grid of cells, not a tree of widgets. Four parallel typed
+ * arrays keep a frame allocation-free: no object is created per cell, ever.
+ */
+export declare class FrameBuffer {
+    width: number;
+    height: number;
+    chars: Uint32Array;
+    fg: Uint32Array;
+    bg: Uint32Array;
+    attrs: Uint16Array;
+    constructor(width: number, height: number);
+    /** Resize in place, reusing the existing allocation when it is large enough. */
+    resize(width: number, height: number): void;
+    index(x: number, y: number): number;
+    clear(fill?: Color, fg?: Color): void;
+    inBounds(x: number, y: number): boolean;
+    /** Write one already-decoded cell value. Returns columns consumed. */
+    setCell(x: number, y: number, value: number, style?: Style): number;
+    /** Write text left to right. Returns the number of columns written. */
+    write(x: number, y: number, text: string, style?: Style, maxWidth?: number): number;
+    fillRect(x: number, y: number, w: number, h: number, ch?: number, style?: Style): void;
+    /** Restyle a region without touching its characters. */
+    styleRect(x: number, y: number, w: number, h: number, style: Style): void;
+    /** Copy another buffer's contents into this one (same dimensions assumed). */
+    copyFrom(other: FrameBuffer): void;
+    /** Plain text of one row, for tests and headless rendering. */
+    rowText(y: number): string;
+    /** Whole buffer as plain text. */
+    toText(trimEnd?: boolean): string;
+}
+//# sourceMappingURL=buffer.d.ts.map

package/dist/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../src/buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAGvD,yEAAyE;AACzE,eAAO,MAAM,IAAI;;;;;;;;;CASP,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,MAAM,WAAW,KAAK;IACpB,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,EAAE,EAAE,WAAW,CAAC;IAChB,EAAE,EAAE,WAAW,CAAC;IAChB,KAAK,EAAE,WAAW,CAAC;gBAEP,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAWzC,gFAAgF;IAChF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAgB3C,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAInC,KAAK,CAAC,IAAI,GAAE,KAAqB,EAAE,EAAE,GAAE,KAAqB,GAAG,IAAI;IAQnE,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAIvC,sEAAsE;IACtE,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM;IA8BnE,uEAAuE;IACvE,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,SAAW,GAAG,MAAM;IAiBrF,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,SAAK,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAUlF,wDAAwD;IACxD,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAezE,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAQlC,+DAA+D;IAC/D,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAW1B,kCAAkC;IAClC,MAAM,CAAC,OAAO,UAAO,GAAG,MAAM;CAQ/B"}

package/dist/buffer.js

@@ -0,0 +1,184 @@
+import { DEFAULT_COLOR } from "./color.js";
+import { CONTINUATION, cellWidth, graphemes, cellText } from "./unicode.js";
+/** Style attribute bits packed into the cell's 16-bit attribute slot. */
+export const Attr = {
+    None: 0,
+    Bold: 1 << 0,
+    Dim: 1 << 1,
+    Italic: 1 << 2,
+    Underline: 1 << 3,
+    Blink: 1 << 4,
+    Reverse: 1 << 5,
+    Strike: 1 << 6,
+};
+/**
+ * The screen is one grid of cells, not a tree of widgets. Four parallel typed
+ * arrays keep a frame allocation-free: no object is created per cell, ever.
+ */
+export class FrameBuffer {
+    width;
+    height;
+    chars;
+    fg;
+    bg;
+    attrs;
+    constructor(width, height) {
+        this.width = Math.max(0, width | 0);
+        this.height = Math.max(0, height | 0);
+        const n = this.width * this.height;
+        this.chars = new Uint32Array(n);
+        this.fg = new Uint32Array(n);
+        this.bg = new Uint32Array(n);
+        this.attrs = new Uint16Array(n);
+        this.clear();
+    }
+    /** Resize in place, reusing the existing allocation when it is large enough. */
+    resize(width, height) {
+        const w = Math.max(0, width | 0);
+        const h = Math.max(0, height | 0);
+        if (w === this.width && h === this.height)
+            return;
+        const n = w * h;
+        if (n > this.chars.length) {
+            this.chars = new Uint32Array(n);
+            this.fg = new Uint32Array(n);
+            this.bg = new Uint32Array(n);
+            this.attrs = new Uint16Array(n);
+        }
+        this.width = w;
+        this.height = h;
+        this.clear();
+    }
+    index(x, y) {
+        return y * this.width + x;
+    }
+    clear(fill = DEFAULT_COLOR, fg = DEFAULT_COLOR) {
+        const n = this.width * this.height;
+        this.chars.fill(32, 0, n);
+        this.fg.fill(fg, 0, n);
+        this.bg.fill(fill, 0, n);
+        this.attrs.fill(0, 0, n);
+    }
+    inBounds(x, y) {
+        return x >= 0 && y >= 0 && x < this.width && y < this.height;
+    }
+    /** Write one already-decoded cell value. Returns columns consumed. */
+    setCell(x, y, value, style) {
+        if (!this.inBounds(x, y))
+            return 0;
+        const w = cellWidth(value);
+        const i = this.index(x, y);
+        // Overwriting the tail of a wide char to our left would orphan it; blank it.
+        if (this.chars[i] === CONTINUATION && x > 0)
+            this.chars[i - 1] = 32;
+        this.chars[i] = value;
+        if (style) {
+            if (style.fg !== undefined)
+                this.fg[i] = style.fg;
+            if (style.bg !== undefined)
+                this.bg[i] = style.bg;
+            if (style.attrs !== undefined)
+                this.attrs[i] = style.attrs;
+        }
+        if (w === 2) {
+            if (x + 1 < this.width) {
+                const j = i + 1;
+                this.chars[j] = CONTINUATION;
+                if (style) {
+                    if (style.fg !== undefined)
+                        this.fg[j] = style.fg;
+                    if (style.bg !== undefined)
+                        this.bg[j] = style.bg;
+                    if (style.attrs !== undefined)
+                        this.attrs[j] = style.attrs;
+                }
+            }
+            else {
+                // No room for the second half: draw a space rather than corrupt the row.
+                this.chars[i] = 32;
+                return 1;
+            }
+        }
+        return Math.max(1, w);
+    }
+    /** Write text left to right. Returns the number of columns written. */
+    write(x, y, text, style, maxWidth = Infinity) {
+        if (y < 0 || y >= this.height)
+            return 0;
+        let cx = x;
+        let used = 0;
+        for (const g of graphemes(text)) {
+            if (used + g.width > maxWidth)
+                break;
+            if (cx >= this.width)
+                break;
+            if (cx + g.width > this.width)
+                break;
+            if (cx >= 0) {
+                this.setCell(cx, y, g.value, style);
+            }
+            cx += g.width;
+            used += g.width;
+        }
+        return used;
+    }
+    fillRect(x, y, w, h, ch = 32, style) {
+        const x0 = Math.max(0, x);
+        const y0 = Math.max(0, y);
+        const x1 = Math.min(this.width, x + w);
+        const y1 = Math.min(this.height, y + h);
+        for (let cy = y0; cy < y1; cy++) {
+            for (let cx = x0; cx < x1; cx++)
+                this.setCell(cx, cy, ch, style);
+        }
+    }
+    /** Restyle a region without touching its characters. */
+    styleRect(x, y, w, h, style) {
+        const x0 = Math.max(0, x);
+        const y0 = Math.max(0, y);
+        const x1 = Math.min(this.width, x + w);
+        const y1 = Math.min(this.height, y + h);
+        for (let cy = y0; cy < y1; cy++) {
+            for (let cx = x0; cx < x1; cx++) {
+                const i = this.index(cx, cy);
+                if (style.fg !== undefined)
+                    this.fg[i] = style.fg;
+                if (style.bg !== undefined)
+                    this.bg[i] = style.bg;
+                if (style.attrs !== undefined)
+                    this.attrs[i] = style.attrs;
+            }
+        }
+    }
+    /** Copy another buffer's contents into this one (same dimensions assumed). */
+    copyFrom(other) {
+        const n = Math.min(this.width * this.height, other.width * other.height);
+        this.chars.set(other.chars.subarray(0, n));
+        this.fg.set(other.fg.subarray(0, n));
+        this.bg.set(other.bg.subarray(0, n));
+        this.attrs.set(other.attrs.subarray(0, n));
+    }
+    /** Plain text of one row, for tests and headless rendering. */
+    rowText(y) {
+        if (y < 0 || y >= this.height)
+            return "";
+        let out = "";
+        for (let x = 0; x < this.width; x++) {
+            const v = this.chars[this.index(x, y)];
+            if (v === CONTINUATION)
+                continue;
+            out += v === 0 ? " " : cellText(v);
+        }
+        return out;
+    }
+    /** Whole buffer as plain text. */
+    toText(trimEnd = true) {
+        const rows = [];
+        for (let y = 0; y < this.height; y++) {
+            const r = this.rowText(y);
+            rows.push(trimEnd ? r.replace(/\s+$/, "") : r);
+        }
+        return rows.join("\n");
+    }
+}
+//# sourceMappingURL=buffer.js.map

package/dist/buffer.js.map

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

package/dist/capabilities.d.ts

@@ -0,0 +1,36 @@
+/**
+ * What the terminal can actually do. Detection is deliberately conservative:
+ * we degrade colors and glyphs rather than print mojibake on someone's console.
+ */
+export type ColorDepth = "truecolor" | "ansi256" | "ansi16" | "none";
+export interface Capabilities {
+    /** stdout is a real TTY, not a pipe or a file. */
+    tty: boolean;
+    colors: ColorDepth;
+    trueColor: boolean;
+    unicode: boolean;
+    braille: boolean;
+    mouse: boolean;
+    /** DEC 2026 atomic frame updates. */
+    synchronizedOutput: boolean;
+    bracketedPaste: boolean;
+    focusEvents: boolean;
+    tmux: boolean;
+    screen: boolean;
+    ssh: boolean;
+    windows: boolean;
+    /** Best guess at the emulator: kitty, wezterm, ghostty, iterm, alacritty, vscode, windows-terminal, xterm, unknown. */
+    program: string;
+}
+export interface CapabilityOverrides {
+    colors?: ColorDepth;
+    unicode?: boolean;
+    braille?: boolean;
+    mouse?: boolean;
+    synchronizedOutput?: boolean;
+    tty?: boolean;
+}
+export declare function detectCapabilities(overrides?: CapabilityOverrides, env?: NodeJS.ProcessEnv, stream?: {
+    isTTY?: boolean;
+}): Capabilities;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,qCAAqC;IACrC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,uHAAuH;IACvH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AA4CD,wBAAgB,kBAAkB,CAChC,SAAS,GAAE,mBAAwB,EACnC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,MAAM,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAmB,GAC3C,YAAY,CA6Bd"}