@scalebun-release/cli 2.5.0

package/lib/ui/banner.js

@@ -0,0 +1,162 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORDMARK = exports.MARK = void 0;
+exports.termWidth = termWidth;
+exports.banner = banner;
+exports.shouldShowArt = shouldShowArt;
+// scalebun/src/ui/banner.ts
+// Ported from the reference banner.mjs — do NOT retune the width thresholds, the
+// gradient stops, the colour ladder, or the mark art. The mark is pre-rendered;
+// regenerate with `pnpm --filter @scalebun/cli gen:mark` if the logo changes.
+// Glyph set is ▀ ▄ █ + space only: the CP437 legacy subset that every monospace
+// font ships (braille U+2800 does NOT ship in DejaVu Sans Mono / Liberation Mono
+// and renders as tofu).
+const chalk_1 = __importDefault(require("chalk"));
+const mark_1 = require("./mark");
+Object.defineProperty(exports, "MARK", { enumerable: true, get: function () { return mark_1.MARK; } });
+const MARK_H = mark_1.MARK.length;
+exports.WORDMARK = [
+    '███████╗ ██████╗ █████╗ ██╗     ███████╗██████╗ ██╗   ██╗███╗   ██╗',
+    '██╔════╝██╔════╝██╔══██╗██║     ██╔════╝██╔══██╗██║   ██║████╗  ██║',
+    '███████╗██║     ███████║██║     █████╗  ██████╔╝██║   ██║██╔██╗ ██║',
+    '╚════██║██║     ██╔══██║██║     ██╔══╝  ██╔══██╗██║   ██║██║╚██╗██║',
+    '███████║╚██████╗██║  ██║███████╗███████╗██████╔╝╚██████╔╝██║ ╚████║',
+    '╚══════╝ ╚═════╝╚═╝  ╚═╝╚══════╝╚══════╝╚═════╝  ╚═════╝ ╚═╝  ╚═══╝',
+];
+const WORD_W = exports.WORDMARK[0].length;
+/* ── colour ─────────────────────────────────────────────────────────── */
+// Detection is chalk's (`chalk.level`), the CLI's single source of truth for
+// colour support — it also parses argv, so `--no-color` / `--color=never` are
+// honoured here exactly as they are for the status box and command table. The
+// raw-ANSI emitters below stay local: they do per-character gradient with
+// repeat-collapsing, which chalk does not offer.
+const BRAND = [80, 70, 229]; // #5046E5, flat logo indigo
+// Flat: the wordmark is solid brand indigo, identical to the mark (and to the
+// sixel logo). The old purple→pink gradient never matched the real brand logo.
+const GRAD = [
+    BRAND,
+    BRAND,
+];
+function rgb256(r, g, b) {
+    const q = (v) => Math.round((v / 255) * 5);
+    return 16 + 36 * q(r) + 6 * q(g) + q(b);
+}
+function fg(level, r, g, b) {
+    if (level >= 3)
+        return `\x1b[38;2;${r};${g};${b}m`;
+    if (level === 2)
+        return `\x1b[38;5;${rgb256(r, g, b)}m`;
+    if (level === 1)
+        return '\x1b[95m'; // bright magenta
+    return '';
+}
+const RESET = (lvl) => (lvl ? '\x1b[0m' : '');
+const STEPS = 12; // quantised: 12 stops instead of one escape per character
+function mix(t) {
+    const [a, b] = GRAD;
+    const q = Math.round(t * (STEPS - 1)) / (STEPS - 1);
+    return [
+        Math.round(a[0] + (b[0] - a[0]) * q),
+        Math.round(a[1] + (b[1] - a[1]) * q),
+        Math.round(a[2] + (b[2] - a[2]) * q),
+    ];
+}
+/** Per-character horizontal gradient. Falls back to one flat escape below truecolor. */
+function gradient(line, level) {
+    if (level === 0)
+        return line;
+    if (level < 3)
+        return fg(level, GRAD[0][0], GRAD[0][1], GRAD[0][2]) + line + RESET(level);
+    let out = '';
+    let last = '';
+    for (let i = 0; i < line.length; i++) {
+        const [r, g, b] = mix(i / Math.max(1, line.length - 1));
+        const c = fg(3, r, g, b);
+        if (c !== last) {
+            out += c;
+            last = c;
+        } // collapse repeats
+        out += line[i];
+    }
+    return out + RESET(level);
+}
+/* ── layout ─────────────────────────────────────────────────────────── */
+/** Real TTY width wins; COLUMNS only covers the non-TTY case (pipes, tests). */
+function termWidth() {
+    return process.stdout.columns || Number(process.env.COLUMNS) || 80;
+}
+const pad = (s, n) => s + ' '.repeat(Math.max(0, n - s.length));
+function banner(o = {}) {
+    const version = o.version ?? '0.0.0';
+    const tagline = o.tagline ?? 'Enterprise OTA Update & Telemetry Control Plane';
+    const level = o.level ?? chalk_1.default.level; // 0 none · 1 basic · 2 256 · 3 truecolor
+    const width = o.width ?? termWidth();
+    const dim = level ? '\x1b[90m' : '';
+    const R = RESET(level);
+    // Narrow terminals: no art at all. One line beats a broken picture.
+    if (width < 46)
+        return `${fg(level, BRAND[0], BRAND[1], BRAND[2])}scalebun${R} ${dim}v${version}${R}\n`;
+    const GAP = 5; // must match GAP/TOP in graphics.ts (sixel path)
+    const OFF = GAP; // compact lockup uses the same gap
+    const brand = fg(level, BRAND[0], BRAND[1], BRAND[2]);
+    const lines = [];
+    // Full lockup — mark + block wordmark, wordmark optically centred.
+    if (o.mark !== false && width >= mark_1.MARK_W + GAP + WORD_W) {
+        const top = 2; // lifts the logo optically — matches graphics.ts TOP
+        for (let i = 0; i < MARK_H; i++) {
+            const left = brand + pad(mark_1.MARK[i] ?? '', mark_1.MARK_W) + R;
+            const wi = i - top;
+            let right = '';
+            if (wi >= 0 && wi < exports.WORDMARK.length)
+                right = gradient(exports.WORDMARK[wi], level);
+            else if (wi === exports.WORDMARK.length)
+                right = `${dim}v${version} · ${tagline}${R}`;
+            lines.push(right ? left + ' '.repeat(GAP) + right : left);
+        }
+        return lines.join('\n').replace(/[ \t]+$/gm, '') + '\n';
+    }
+    // Compact lockup — mark + type. Same composition as the `quiet` direction, so
+    // an 80-column terminal still gets the rabbit.
+    const shortTag = 'OTA updates and telemetry';
+    const tag = width >= mark_1.MARK_W + OFF + tagline.length ? tagline : shortTag;
+    if (o.mark !== false && width >= mark_1.MARK_W + OFF + shortTag.length) {
+        const bold = level ? '\x1b[1m' : '';
+        const type = [
+            `${bold}${fg(level, GRAD[0][0], GRAD[0][1], GRAD[0][2])}scalebun${R}  ${dim}v${version}${R}`,
+            `${dim}${tag}${R}`,
+        ];
+        const top = Math.floor((MARK_H - type.length) / 2);
+        for (let i = 0; i < MARK_H; i++) {
+            const left = brand + pad(mark_1.MARK[i] ?? '', mark_1.MARK_W) + R;
+            const ti = i - top;
+            const right = ti >= 0 && ti < type.length ? type[ti] : '';
+            lines.push(right ? left + ' '.repeat(OFF) + right : left);
+        }
+        return lines.join('\n').replace(/[ \t]+$/gm, '') + '\n';
+    }
+    // No room beside the mark: type only.
+    if (width >= WORD_W)
+        exports.WORDMARK.forEach((l) => lines.push(gradient(l, level)));
+    else
+        lines.push(`${fg(level, BRAND[0], BRAND[1], BRAND[2])}scalebun${R}`);
+    lines.push('');
+    lines.push(`${dim}v${version} · ${width >= 60 ? tagline : shortTag}${R}`);
+    return lines.join('\n') + '\n';
+}
+/**
+ * Gates the ART ONLY (mark + wordmark). The splash body — status line and
+ * command table — is the output of the no-arg command, not banner decoration,
+ * so it must NOT be gated by this. Keep the two concerns separate.
+ */
+function shouldShowArt(argv = process.argv.slice(2)) {
+    if (argv.includes('--no-banner') || process.env.SCALEBUN_NO_BANNER)
+        return false;
+    if (process.env.CI && !process.stdout.isTTY)
+        return false;
+    const cmd = argv.find((a) => !a.startsWith('-'));
+    return !cmd || cmd === 'help'; // bare `scalebun` and `scalebun help` only
+}
+//# sourceMappingURL=banner.js.map

package/lib/ui/banner.js.map

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

package/lib/ui/graphics.d.ts

@@ -0,0 +1,18 @@
+declare const ROWS = 9, COLS = 13;
+type Caps = {
+    sixel: boolean;
+    cellH: number;
+    cellW: number;
+};
+export declare function capabilities(): Promise<Caps | null>;
+/**
+ * Draw the logo, then climb back over it and set the wordmark beside it.
+ * DEC save/restore (ESC 7 / ESC 8) does NOT survive a sixel draw in Windows
+ * Terminal — the cursor lands near the bottom of the image. Cursor-up plus an
+ * absolute column (CSI n G) is what actually works.
+ */
+export declare function lockup(caps: Caps, wordmark: string[], tagline: string, opts?: {
+    level?: number;
+}): string;
+export { ROWS as LOGO_ROWS, COLS as LOGO_COLS };
+//# sourceMappingURL=graphics.d.ts.map

package/lib/ui/graphics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphics.d.ts","sourceRoot":"","sources":["../../src/ui/graphics.ts"],"names":[],"mappings":"AASA,QAAA,MAAM,IAAI,IAAI,EAAE,IAAI,KAAK,CAAC;AAM1B,KAAK,IAAI,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAkD7D,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAUzD;AASD;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5B,MAAM,CA6BR;AAED,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,IAAI,IAAI,SAAS,EAAE,CAAC"}

package/lib/ui/graphics.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOGO_COLS = exports.LOGO_ROWS = void 0;
+exports.capabilities = capabilities;
+exports.lockup = lockup;
+// scalebun/src/ui/graphics.ts
+// Smooth logo via sixel, where the terminal supports it. Falls back to block art.
+// Zero runtime deps. Payloads pre-generated by tools/gen-sixel.mjs.
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_fs_1 = require("node:fs");
+/** 9 rows tall, keyed by the terminal's cell height in px. ~5.7 KB total. */
+const sixel_1 = require("./sixel");
+const ROWS = 9, COLS = 13;
+exports.LOGO_ROWS = ROWS;
+exports.LOGO_COLS = COLS;
+const GAP = 5, TOP = 2; // shared with the block-art path in banner.ts
+const E = '\x1b';
+const CACHE = (0, node_path_1.join)((0, node_os_1.homedir)(), '.scalebun', 'graphics.json');
+const TTL = 7 * 24 * 3600 * 1000;
+/**
+ * One round trip for everything: DA1 (feature list, 4 = sixel) and CSI 16 t
+ * (cell size). Env vars are useless here — cmd.exe inside Windows Terminal
+ * reports no TERM, no TERM_PROGRAM and no WT_SESSION, yet supports sixel.
+ */
+function probe(ms = 300) {
+    return new Promise(resolve => {
+        if (!process.stdin.isTTY || !process.stdout.isTTY)
+            return resolve(null);
+        let buf = '';
+        const finish = () => {
+            clearTimeout(timer);
+            process.stdin.removeListener('data', onData);
+            try {
+                process.stdin.setRawMode(false);
+            }
+            catch { }
+            process.stdin.pause();
+            const da1 = buf.match(/\x1b\[\?([0-9;]+)c/);
+            const cell = buf.match(/\x1b\[6;(\d+);(\d+)t/);
+            resolve({
+                sixel: !!da1 && da1[1].split(';').includes('4'),
+                cellH: cell ? +cell[1] : 20,
+                cellW: cell ? +cell[2] : 10
+            });
+        };
+        const onData = (d) => {
+            buf += d.toString('binary');
+            if (/c/.test(buf) && /t/.test(buf))
+                finish();
+        };
+        const timer = setTimeout(finish, ms);
+        try {
+            process.stdin.setRawMode(true);
+        }
+        catch {
+            return resolve(null);
+        }
+        process.stdin.resume();
+        process.stdin.on('data', onData);
+        process.stdout.write(E + '[c' + E + '[16t');
+    });
+}
+function readCache() {
+    try {
+        const c = JSON.parse((0, node_fs_1.readFileSync)(CACHE, 'utf8'));
+        return Date.now() - c.at < TTL ? c.caps : null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(caps) {
+    try {
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)((0, node_os_1.homedir)(), '.scalebun'), { recursive: true });
+        (0, node_fs_1.writeFileSync)(CACHE, JSON.stringify({ at: Date.now(), caps }));
+    }
+    catch { /* cache is an optimisation, never a requirement */ }
+}
+async function capabilities() {
+    const mode = process.env.SCALEBUN_GRAPHICS; // off | auto | refresh
+    if (mode === 'off')
+        return null;
+    if (mode !== 'refresh') {
+        const hit = readCache();
+        if (hit)
+            return hit;
+    }
+    const caps = await probe();
+    if (caps)
+        writeCache(caps);
+    return caps;
+}
+/** Pick the payload whose cell height is closest to this terminal's. */
+function payload(cellH) {
+    const keys = Object.keys(sixel_1.SIXEL).map(Number);
+    const best = keys.reduce((a, b) => Math.abs(b - cellH) < Math.abs(a - cellH) ? b : a);
+    return sixel_1.SIXEL[String(best)];
+}
+/**
+ * Draw the logo, then climb back over it and set the wordmark beside it.
+ * DEC save/restore (ESC 7 / ESC 8) does NOT survive a sixel draw in Windows
+ * Terminal — the cursor lands near the bottom of the image. Cursor-up plus an
+ * absolute column (CSI n G) is what actually works.
+ */
+function lockup(caps, wordmark, tagline, opts = {}) {
+    const img = payload(caps.cellH);
+    const level = opts.level ?? 3;
+    // Same indigo as the mark itself — #5046E5 — with the usual downshift.
+    const brand = level >= 3 ? E + '[38;2;80;70;229m'
+        : level === 2 ? E + '[38;5;62m'
+            : level === 1 ? E + '[95m' : '';
+    const dim = level ? E + '[90m' : '';
+    const R = level ? E + '[0m' : '';
+    // Match the block-art gutter exactly, so the wordmark sits in the same
+    // column whether the logo rendered as sixel or as blocks.
+    const gutter = Math.max(COLS, Math.ceil(img.w / caps.cellW)) + GAP;
+    // The mark's visual mass sits low (ears and arrow are open line, the head is
+    // solid), so geometric centring reads as the logo sagging. Dropping the text
+    // two rows lifts the logo optically. Rows 0-1 are the arrow and ear tips.
+    const top = TOP;
+    let s = img.d + E + '[' + ROWS + 'A';
+    for (let i = 0; i < ROWS; i++) {
+        const wi = i - top;
+        let text = '';
+        if (wi >= 0 && wi < wordmark.length)
+            text = brand + wordmark[wi] + R;
+        else if (wi === wordmark.length)
+            text = dim + tagline + R;
+        s += (text ? E + '[' + gutter + 'G' + text : '') + '\n';
+    }
+    return s;
+}
+//# sourceMappingURL=graphics.js.map

package/lib/ui/graphics.js.map

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

package/lib/ui/mark.d.ts

@@ -0,0 +1,4 @@
+export declare const MARK: readonly string[];
+export declare const MARK_W = 13;
+export declare const MARK_H = 9;
+//# sourceMappingURL=mark.d.ts.map

package/lib/ui/mark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark.d.ts","sourceRoot":"","sources":["../../src/ui/mark.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,IAAI,EAAE,SAAS,MAAM,EAUjC,CAAC;AACF,eAAO,MAAM,MAAM,KAAK,CAAC;AACzB,eAAO,MAAM,MAAM,IAAI,CAAC"}

package/lib/ui/mark.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MARK_H = exports.MARK_W = exports.MARK = void 0;
+/* eslint-disable */
+// prettier-ignore
+// GENERATED by tools/gen-mark.mjs from assets/scalebun-mark.svg — do not edit by hand.
+// 13x9, arrowhead hand-hinted (see HINT in the generator)
+exports.MARK = [
+    " ▄▄▄     ▄██",
+    "████▄   ████",
+    "██ ██  ▄██▀",
+    "▀████████▄",
+    " ████▀▀▀▀███",
+    "██▀     ▄▄▀██",
+    "██      ▀▀ ██",
+    "██▄    ▄▄▄▄██",
+    " ▀██████▀▀▀▀"
+];
+exports.MARK_W = 13;
+exports.MARK_H = 9;
+//# sourceMappingURL=mark.js.map

package/lib/ui/mark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark.js","sourceRoot":"","sources":["../../src/ui/mark.ts"],"names":[],"mappings":";;;AAAA,oBAAoB;AACpB,kBAAkB;AAClB,uFAAuF;AACvF,0DAA0D;AAC7C,QAAA,IAAI,GAAsB;IACrC,cAAc;IACd,cAAc;IACd,aAAa;IACb,YAAY;IACZ,cAAc;IACd,eAAe;IACf,eAAe;IACf,eAAe;IACf,cAAc;CACf,CAAC;AACW,QAAA,MAAM,GAAG,EAAE,CAAC;AACZ,QAAA,MAAM,GAAG,CAAC,CAAC"}

package/lib/ui/menu.d.ts

@@ -0,0 +1,109 @@
+/**
+ * The interactive home screen — arrow keys through the grouped commands.
+ *
+ * ── Why a menu and not just a prompt ────────────────────────────────────────
+ *
+ * A bare prompt only helps someone who already knows what to type, which is
+ * precisely the person who did not need an interactive mode. Printing all
+ * thirty commands instead solves discovery and destroys it in the same breath:
+ * a wall of cyan has no shape, so nothing stands out. Grouping and then
+ * revealing one group at a time keeps the whole surface reachable while never
+ * showing more than about five things at once.
+ *
+ * Typing still works, and works from the menu — any printable key opens the
+ * command line seeded with that character. So the menu is a floor, not a
+ * ceiling: it never stands between an experienced user and the thing they were
+ * going to type anyway.
+ *
+ * ── The frame must FIT ──────────────────────────────────────────────────────
+ *
+ * This is the whole ballgame, and getting it wrong is not a cosmetic bug.
+ * Logo, status box, project line, group header and the ten SETUP commands come
+ * to 32 lines; a normal terminal is 24 to 30. Overflow does not merely crop —
+ * the terminal scrolls to fit, so the next frame's `\x1b[H` (cursor home) lands
+ * at the top of the VIEWPORT rather than the top of the frame, and each redraw
+ * paints over a shifting target. Within a few keypresses the screen is a
+ * collage of half-frames, arrow keys appear to do nothing, and the session
+ * looks hung when it is in fact working perfectly.
+ *
+ * So the frame is budgeted against `stdout.rows` and the command list is
+ * windowed to whatever is left. The logo is never what gets sacrificed — it is
+ * the reason for coming back to this screen — so the list scrolls instead.
+ *
+ * Frames are composed in memory and written ONCE. Sequential console.log calls
+ * tear visibly: the terminal paints each line as it arrives, so an arrow key
+ * produces a flicker of half-drawn screen.
+ */
+export type MenuChoice = {
+    kind: 'run';
+    argv: string[];
+}
+/** The user started typing; `seed` is the character that triggered it. */
+ | {
+    kind: 'type';
+    seed: string;
+} | {
+    kind: 'quit';
+};
+export interface MenuDeps {
+    /**
+     * Splash art, rendered ONCE by the caller and reused for every frame.
+     * Detecting terminal capabilities means writing to stdin and waiting for a
+     * reply, which is impossible while the menu owns raw mode.
+     */
+    art: string;
+    /**
+     * A line that must not be dropped by the layout ladder — currently the
+     * "your session is running stale code" warning, which is worthless if it is
+     * the first thing sacrificed on a short terminal.
+     *
+     * A FUNCTION, not a string: the menu can sit open for a long time, and the
+     * condition it reports (an upgrade landing on disk) happens while it sits
+     * there. Passing a string would freeze the answer at the moment the menu was
+     * entered, so the warning would only appear after running an unrelated
+     * command — by which point the user has already hit the stale behaviour.
+     */
+    notice?: () => string | undefined;
+}
+/**
+ * Split one stdin chunk into individual keypresses.
+ *
+ * stdin delivers BYTES, not keys. Press two arrows faster than the event loop
+ * drains stdin — which is just "press them quickly" — and both arrive in a
+ * single chunk as `\x1b[B\x1b[B`. Comparing the whole chunk against a table of
+ * key sequences matches nothing, so the keys are silently dropped and the menu
+ * looks frozen. The same happens to a held-down arrow and to any paste.
+ *
+ * Escape sequences are ESC, an introducer (`[` for CSI, `O` for SS3), then
+ * parameter bytes up to a final byte in the 0x40-0x7E range. A lone ESC with
+ * nothing after it is the Escape key.
+ */
+export declare function splitKeys(chunk: string): string[];
+export interface FrameInput {
+    /** Terminal height. The frame is built to fit in `rows - 1`. */
+    rows: number;
+    art: string[];
+    status: string[];
+    /** Project line, stage hint — kept when they fit, dropped before the logo. */
+    extras: string[];
+    title: string[];
+    items: string[];
+    /** Index into `items` that must stay visible. */
+    active: number;
+    footer: string;
+    /** Always rendered, never traded away for space. */
+    notice?: string;
+}
+/**
+ * Compose one frame that fits.
+ *
+ * Pure, and exported, because the fit is the invariant that matters and it is
+ * invisible until it breaks: an overflowing frame scrolls the terminal, so the
+ * next redraw's cursor-home lands somewhere other than the top of the frame and
+ * the screen degrades into a collage of half-frames. That reads as a hung
+ * session, not as a layout bug, which is what makes it worth a test rather than
+ * an eyeball.
+ */
+export declare function composeFrame(input: FrameInput): string[];
+export declare function menu(deps: MenuDeps): Promise<MenuChoice>;
+//# sourceMappingURL=menu.d.ts.map

package/lib/ui/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../src/ui/menu.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE;AACjC,0EAA0E;GACxE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACnC;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBjD;AAyCD,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CA0DxD;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CA8JxD"}