@agentdeck/bridge 0.2.1 → 0.2.3

package/dist/permission-resolver.js

@@ -0,0 +1,103 @@
+import { debug } from './logger.js';
+const pending = new Map();
+function buildDecisionBody(decision) {
+    return JSON.stringify({
+        hookSpecificOutput: {
+            hookEventName: 'PreToolUse',
+            permissionDecision: decision,
+        },
+    });
+}
+/** End a held response with a decision and drop the entry. Safe if the socket
+ *  is already gone. */
+function endWith(key, entry, decision) {
+    clearTimeout(entry.timer);
+    pending.delete(key);
+    try {
+        entry.res.writeHead(200, { 'Content-Type': 'application/json' });
+        entry.res.end(buildDecisionBody(decision));
+    }
+    catch {
+        /* client disconnected */
+    }
+    try {
+        entry.onResolved?.(decision);
+    }
+    catch { /* callback must never throw the resolver */ }
+}
+/**
+ * Register a held hook response. Auto-resolves to `ask` after `timeoutMs` so a
+ * never-answered prompt falls back to Claude's own terminal prompt. The hook's
+ * curl `--max-time` must exceed `timeoutMs` so this fallback reaches Claude
+ * before curl gives up.
+ */
+export function registerPending(requestId, res, opts) {
+    // Defensive: if a stale entry exists under this id, resolve it to ask first.
+    const existing = pending.get(requestId);
+    if (existing)
+        endWith(requestId, existing, 'ask');
+    const timer = setTimeout(() => {
+        const entry = pending.get(requestId);
+        if (entry) {
+            debug('permission', `pending ${requestId} timed out → ask`);
+            endWith(requestId, entry, 'ask');
+        }
+    }, opts.timeoutMs);
+    pending.set(requestId, {
+        res,
+        timer,
+        sessionId: opts.sessionId,
+        tool: opts.tool,
+        createdAt: Date.now(),
+        onResolved: opts.onResolved,
+    });
+    debug('permission', `registered pending ${requestId} (tool=${opts.tool ?? '?'} session=${opts.sessionId ?? '?'})`);
+}
+/**
+ * Resolve a pending request from a device decision. Returns the affected
+ * sessionId (so the caller can clear the awaiting overlay + rebroadcast), or
+ * null if no such pending request exists (already resolved / unknown id).
+ */
+export function resolvePending(requestId, decision) {
+    const entry = pending.get(requestId);
+    if (!entry)
+        return null;
+    const sessionId = entry.sessionId ?? null;
+    endWith(requestId, entry, decision);
+    debug('permission', `resolved pending ${requestId} → ${decision}`);
+    return sessionId;
+}
+/** Drop a pending entry without sending a decision (e.g. the hook's socket
+ *  closed because Claude moved on). The held response is already dead. */
+export function abandonPending(requestId) {
+    const entry = pending.get(requestId);
+    if (!entry)
+        return;
+    clearTimeout(entry.timer);
+    pending.delete(requestId);
+}
+/** Sweep entries older than maxAgeMs (backstop for any timer that didn't fire),
+ *  resolving them to `ask`. Returns the number swept. */
+export function sweepStalePending(maxAgeMs, now = Date.now()) {
+    let swept = 0;
+    for (const [key, entry] of Array.from(pending.entries())) {
+        if (now - entry.createdAt > maxAgeMs) {
+            endWith(key, entry, 'ask');
+            swept++;
+        }
+    }
+    if (swept > 0)
+        debug('permission', `swept ${swept} stale pending requests`);
+    return swept;
+}
+/** Resolve all pending to `ask` and clear — used on daemon shutdown. */
+export function drainAllPending() {
+    for (const [key, entry] of Array.from(pending.entries())) {
+        endWith(key, entry, 'ask');
+    }
+}
+/** Test/diagnostic helper. */
+export function _pendingCount() {
+    return pending.size;
+}
+//# sourceMappingURL=permission-resolver.js.map

package/dist/permission-resolver.js.map

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

package/dist/pixoo/micro-glyphs.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Native 11×11 creature glyphs for the Timebox Mini micro layout.
+ *
+ * The Timebox Mini has only 121 LEDs. Downscaling the 32×32 terrarium creature to
+ * 11×11 bottoms out at a fuzzy silhouette — so for this device the creatures are
+ * **hand-authored directly at 11×11** as bold, high-contrast bitmaps. Every pixel
+ * is intentional, which is dramatically more legible than any downscale. Treat
+ * this screen as a status badge, not a shrunken aquarium: one dominant creature,
+ * no labels, no HUD chrome, and only the pixels that identify the canonical mark.
+ *
+ * The glyphs are the canonical brand marks (matching assets/logos/*_creature_gen.png
+ * and design/brand/*.svg), not loose creature approximations:
+ *   Claude  → rusty robot (rectangular body, dark cutout eyes, arms, legs)
+ *   Codex   → lavender cloud carrying a white `>_` terminal prompt
+ *   OpenClaw→ red lobster (side claws, antennae, teal eyes)
+ *   OpenCode→ hollow rectangular ring logo
+ *   Antigravity→ peak/arc logo
+ * The MicroCreature keys are legacy internal codenames kept for the renderer
+ * mapping — only the art behind them is brand-true.
+ *
+ * Each glyph is an 11-row × 11-col string grid. Characters map to colors:
+ *   '.' transparent (shows the status-color background)
+ *   'B' body   'A' arm/antenna/leg   'C' claw   'D' joint/shadow   'E' eye   'K' cutout   'M' prompt mark   'F' logo frame
+ *   Antigravity additionally uses gradient bands: L/T/Q/Y/O/R/P/V/U/N plus K for black cutout.
+ * `work` is an optional second frame for a simple processing animation (leg wiggle).
+ */
+export type RGB = readonly [number, number, number];
+export type MicroCreature = 'octopus' | 'jellyfish' | 'opencode' | 'crayfish' | 'antigravity';
+export type MicroState = 'idle' | 'working' | 'asking';
+export declare const MICRO_SIZE = 11;
+/**
+ * Dark status-color field so the bright creature pops.
+ *
+ * Idle is a steady green so a resting session reads as calm/still. Both active
+ * states animate the field so the tiny panel visibly "does something" while the
+ * agent is busy — the device only re-pushes when the frame changes, so a
+ * breathing field is also what keeps working sessions live on screen:
+ *   • processing → a slow blue "breathing" pulse (calm, ~3s cycle)
+ *   • awaiting   → a faster, brighter amber pulse (urgent)
+ * Error is a steady deep red (no motion — a frozen alarm reads as more severe).
+ */
+export declare function microStatusBg(state: 'idle' | 'processing' | 'awaiting' | 'error', animFrame: number): RGB;
+/**
+ * Paint a creature glyph onto an 11×11 RGB buffer (only non-transparent pixels).
+ * `working` alternates two leg frames; `asking` reuses the idle pose (the amber
+ * field already signals "awaiting").
+ */
+export declare function paintMicroGlyph(buf: Uint8Array, creature: MicroCreature, state: MicroState, animFrame: number): void;
+//# sourceMappingURL=micro-glyphs.d.ts.map

package/dist/pixoo/micro-glyphs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"micro-glyphs.d.ts","sourceRoot":"","sources":["../../src/pixoo/micro-glyphs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACpD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;AAC9F,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvD,eAAO,MAAM,UAAU,KAAK,CAAC;AA6M7B;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,EACnD,SAAS,EAAE,MAAM,GAChB,GAAG,CAeL;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,GAChB,IAAI,CAoBN"}

package/dist/pixoo/micro-glyphs.js

@@ -0,0 +1,276 @@
+/**
+ * Native 11×11 creature glyphs for the Timebox Mini micro layout.
+ *
+ * The Timebox Mini has only 121 LEDs. Downscaling the 32×32 terrarium creature to
+ * 11×11 bottoms out at a fuzzy silhouette — so for this device the creatures are
+ * **hand-authored directly at 11×11** as bold, high-contrast bitmaps. Every pixel
+ * is intentional, which is dramatically more legible than any downscale. Treat
+ * this screen as a status badge, not a shrunken aquarium: one dominant creature,
+ * no labels, no HUD chrome, and only the pixels that identify the canonical mark.
+ *
+ * The glyphs are the canonical brand marks (matching assets/logos/*_creature_gen.png
+ * and design/brand/*.svg), not loose creature approximations:
+ *   Claude  → rusty robot (rectangular body, dark cutout eyes, arms, legs)
+ *   Codex   → lavender cloud carrying a white `>_` terminal prompt
+ *   OpenClaw→ red lobster (side claws, antennae, teal eyes)
+ *   OpenCode→ hollow rectangular ring logo
+ *   Antigravity→ peak/arc logo
+ * The MicroCreature keys are legacy internal codenames kept for the renderer
+ * mapping — only the art behind them is brand-true.
+ *
+ * Each glyph is an 11-row × 11-col string grid. Characters map to colors:
+ *   '.' transparent (shows the status-color background)
+ *   'B' body   'A' arm/antenna/leg   'C' claw   'D' joint/shadow   'E' eye   'K' cutout   'M' prompt mark   'F' logo frame
+ *   Antigravity additionally uses gradient bands: L/T/Q/Y/O/R/P/V/U/N plus K for black cutout.
+ * `work` is an optional second frame for a simple processing animation (leg wiggle).
+ */
+export const MICRO_SIZE = 11;
+// Claude Code — rusty robot (design/brand/claudecode.svg): broad rectangular
+// body, full-width side arms, straight vertical legs, and two narrow vertical
+// cutout eyes. The eyes occupy two LED rows because the SVG holes are taller
+// than they are wide; the legs stay aligned instead of wiggling.
+const OCTOPUS = {
+    // `E` is the lit "active" eye used only in the work pose: the rusty robot's
+    // dark cutout eyes (`K`) light up cyan while it is processing, so the panel
+    // reads as "thinking" at a glance instead of a frozen idle robot.
+    colors: { B: [235, 130, 90], D: [150, 84, 64], K: [0, 0, 0], E: [120, 226, 255] },
+    idle: [
+        '...........',
+        '.BBBBBBBBB.',
+        '.BBBBBBBBB.',
+        '.BBKBBBKBB.',
+        '.BBKBBBKBB.',
+        'BBBBBBBBBBB',
+        'BBBBBBBBBBB',
+        '.BBBBBBBBB.',
+        '..BB...BB..',
+        '..BB...BB..',
+        '...........',
+    ],
+    // Working: eyes light up + the legs take a stride (left up / right planted),
+    // so the alternation with `idle` gives a visible blink + walk while busy.
+    work: [
+        '...........',
+        '.BBBBBBBBB.',
+        '.BBBBBBBBB.',
+        '.BBEBBBEBB.',
+        '.BBEBBBEBB.',
+        'BBBBBBBBBBB',
+        'BBBBBBBBBBB',
+        '.BBBBBBBBB.',
+        '..BB...BB..',
+        '...B...BB..',
+        '...........',
+    ],
+};
+// Codex — lavender cloud (assets/logos/cloud_creature_gen.png, design/brand/codex.svg):
+// puffy cloud outline with no dangling legs, plus an oversized `>_` prompt. The
+// prompt is deliberately brighter than the body so it survives the LED diffuser.
+const JELLYFISH = {
+    // `M` is PURE white (not off-white) and the body is a deeper indigo than the
+    // old lavender so the `>_` prompt actually pops on the LED diffuser instead of
+    // washing into the cloud. The mark is a bold 2px chevron + full-width cursor.
+    colors: { B: [86, 92, 220], M: [255, 255, 255] },
+    idle: [
+        '...........',
+        '...BBBBB...',
+        '.BBBBBBBBB.',
+        'BBBBBBBBBBB',
+        'BBMMBBBBBBB',
+        'BBBMMBBBBBB',
+        'BBMMBBBBBBB',
+        'BBBBBBBBBBB',
+        'BBBMMMMMBBB',
+        '.BBBBBBBBB.',
+        '...BBBBB...',
+    ],
+    // Working: the cursor blinks off so the alternation reads as a live terminal
+    // prompt (chevron steady, underscore pulsing) while Codex is processing.
+    work: [
+        '...........',
+        '...BBBBB...',
+        '.BBBBBBBBB.',
+        'BBBBBBBBBBB',
+        'BBMMBBBBBBB',
+        'BBBMMBBBBBB',
+        'BBMMBBBBBBB',
+        'BBBBBBBBBBB',
+        'BBBBBBBBBBB',
+        '.BBBBBBBBB.',
+        '...BBBBB...',
+    ],
+};
+// OpenCode — canonical opencode.svg: a single tall rectangular ring, not two
+// overlapping squares and not a filled core. Light stroke so it reads on LEDs
+// (#3a3a3a brand gray is too dark for this panel).
+const OPENCODE = {
+    colors: { F: [232, 232, 232] },
+    idle: [
+        '...........',
+        '..FFFFFFF..',
+        '..FFFFFFF..',
+        '..FF...FF..',
+        '..FF...FF..',
+        '..FF...FF..',
+        '..FF...FF..',
+        '..FF...FF..',
+        '..FFFFFFF..',
+        '..FFFFFFF..',
+        '...........',
+    ],
+    // Working: the ring thickens inward (hole narrows to 1px), so the alternation
+    // with `idle` reads as a steady pulse while OpenCode is processing.
+    work: [
+        '...........',
+        '..FFFFFFF..',
+        '..FFFFFFF..',
+        '..FFF.FFF..',
+        '..FFF.FFF..',
+        '..FFF.FFF..',
+        '..FFF.FFF..',
+        '..FFF.FFF..',
+        '..FFFFFFF..',
+        '..FFFFFFF..',
+        '...........',
+    ],
+};
+// Antigravity — rainbow peak/arc mark, simplified for an 11×11 matrix. The
+// central hollow is transparent, not black, so the status field shows through
+// like the open space in the official arc silhouette.
+const ANTIGRAVITY = {
+    colors: {
+        L: [92, 214, 77],
+        T: [31, 198, 179],
+        Q: [58, 199, 235],
+        Y: [245, 203, 36],
+        O: [255, 132, 16],
+        R: [255, 82, 65],
+        P: [183, 92, 182],
+        V: [102, 111, 225],
+        U: [36, 126, 255],
+        N: [41, 184, 238],
+    },
+    idle: [
+        '.....O.....',
+        '....YOR....',
+        '...LYORP...',
+        '...LYORPV..',
+        '...LTQRPV..',
+        '..LTQRPVU..',
+        '..TQ...VU..',
+        '..Q.....U..',
+        '.NQ.....UU.',
+        '.N.......UU',
+        '...........',
+    ],
+    work: [
+        '....YO.....',
+        '....YORP...',
+        '...LYORPV..',
+        '...LTQRPV..',
+        '..LTQRPVU..',
+        '..TQ...VU..',
+        '..Q.....U..',
+        '.NQ.....UU.',
+        '.N.......UU',
+        '...........',
+        '...........',
+    ],
+};
+// OpenClaw — red mechanical lobster (assets/logos/lobster_creature_gen.png,
+// Pixoo LOD): side claws, small antennae, teal eyes, and a tapered body. The
+// full asset's raised claws are too tall for 11px and read as a different head.
+const CRAYFISH = {
+    colors: { B: [255, 92, 92], C: [210, 52, 52], A: [225, 180, 170], E: [0, 229, 204] },
+    idle: [
+        '...A...A...',
+        '....A.A....',
+        '....BBB....',
+        '...BEBEB...',
+        'C.BBBBBBB.C',
+        'CC.BBBBB.CC',
+        '.CBBBBBBB.C',
+        '..BBBBBBB..',
+        '...BBBBB...',
+        '...BB.BB...',
+        '..BB...BB..',
+    ],
+    work: [
+        '....A.A....',
+        '...A...A...',
+        '....BBB....',
+        '...BEBEB...',
+        '.CBBBBBBB.C',
+        'CC.BBBBB.CC',
+        'C.BBBBBBB.C',
+        '..BBBBBBB..',
+        '...BBBBB...',
+        '...B.B.B...',
+        '..BB...BB..',
+    ],
+};
+const GLYPHS = {
+    octopus: OCTOPUS,
+    jellyfish: JELLYFISH,
+    opencode: OPENCODE,
+    crayfish: CRAYFISH,
+    antigravity: ANTIGRAVITY,
+};
+/**
+ * Dark status-color field so the bright creature pops.
+ *
+ * Idle is a steady green so a resting session reads as calm/still. Both active
+ * states animate the field so the tiny panel visibly "does something" while the
+ * agent is busy — the device only re-pushes when the frame changes, so a
+ * breathing field is also what keeps working sessions live on screen:
+ *   • processing → a slow blue "breathing" pulse (calm, ~3s cycle)
+ *   • awaiting   → a faster, brighter amber pulse (urgent)
+ * Error is a steady deep red (no motion — a frozen alarm reads as more severe).
+ */
+export function microStatusBg(state, animFrame) {
+    switch (state) {
+        case 'error': return [64, 18, 18];
+        case 'awaiting': {
+            const p = 0.78 + 0.22 * ((Math.sin(animFrame * 0.25) + 1) / 2);
+            return [Math.round(74 * p), Math.round(50 * p), Math.round(10 * p)];
+        }
+        case 'processing': {
+            // Breathe between a dim floor and a brighter blue on a ~3s cycle. Sampled
+            // at the device's ~1.5s poll this reads as a steady "working" heartbeat.
+            const p = 0.68 + 0.32 * ((Math.sin(animFrame * 0.18) + 1) / 2);
+            return [Math.round(16 * p), Math.round(40 * p), Math.round(88 * p)];
+        }
+        default: return [16, 56, 28];
+    }
+}
+/**
+ * Paint a creature glyph onto an 11×11 RGB buffer (only non-transparent pixels).
+ * `working` alternates two leg frames; `asking` reuses the idle pose (the amber
+ * field already signals "awaiting").
+ */
+export function paintMicroGlyph(buf, creature, state, animFrame) {
+    const g = GLYPHS[creature];
+    const grid = state === 'working' && g.work && ((animFrame >> 2) & 1) ? g.work : g.idle;
+    const drift = creature === 'antigravity' ? Math.floor(animFrame / 6) % 4 : 0;
+    const offsetX = creature === 'antigravity' && state === 'working'
+        ? (drift === 1 ? 1 : drift === 3 ? -1 : 0)
+        : 0;
+    const offsetY = creature === 'antigravity' && state !== 'idle' && (drift === 0 || drift === 1) ? -1 : 0;
+    for (let y = 0; y < MICRO_SIZE; y++) {
+        const row = grid[y];
+        for (let x = 0; x < MICRO_SIZE; x++) {
+            const col = g.colors[row[x]];
+            if (!col)
+                continue;
+            const dx = x + offsetX;
+            const dy = y + offsetY;
+            if (dx < 0 || dx >= MICRO_SIZE || dy < 0 || dy >= MICRO_SIZE)
+                continue;
+            const i = (dy * MICRO_SIZE + dx) * 3;
+            buf[i] = col[0];
+            buf[i + 1] = col[1];
+            buf[i + 2] = col[2];
+        }
+    }
+}
+//# sourceMappingURL=micro-glyphs.js.map

package/dist/pixoo/micro-glyphs.js.map

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

package/dist/pixoo/pixoo-bridge.d.ts

@@ -42,9 +42,9 @@ export declare function getPixooDeviceDetails(): Array<{
  * Render a fresh frame using current cached state.
  * Used by the live preview endpoint when no Pixoo device is connected.
  */
-export declare function renderPreviewFrame(): Uint8Array;
+export declare function renderPreviewFrame(size?: 11 | 32 | 64, layout?: 'standard' | 'micro'): Uint8Array;
 /**
  * Get the last calculated frame.
  */
-export declare function getLastFrame(): Uint8Array | null;
+export declare function getLastFrame(size?: 11 | 32 | 64, layout?: 'standard' | 'micro'): Uint8Array | null;
 //# sourceMappingURL=pixoo-bridge.d.ts.map

package/dist/pixoo/pixoo-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pixoo-bridge.d.ts","sourceRoot":"","sources":["../../src/pixoo/pixoo-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAgC,MAAM,aAAa,CAAC;AAW7E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAiCD,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAExE;AAED,wBAAgB,gBAAgB,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI,CAwCnE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAwDvD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CA6BrD;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAG3E;AAED,+BAA+B;AAC/B,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAG5E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAO/C;AAED,uCAAuC;AACvC,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,qBAAqB,IAAI,KAAK,CAAC;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAYD;AAsCD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,UAAU,GAAG,IAAI,CAEhD"}
+{"version":3,"file":"pixoo-bridge.d.ts","sourceRoot":"","sources":["../../src/pixoo/pixoo-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAgC,MAAM,aAAa,CAAC;AAW7E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA2CD,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAExE;AAED,wBAAgB,gBAAgB,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI,CAwCnE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAmFvD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CA8BrD;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAG3E;AAED,+BAA+B;AAC/B,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAG5E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAO/C;AAED,uCAAuC;AACvC,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,qBAAqB,IAAI,KAAK,CAAC;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAYD;AA8ED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,GAAE,UAAU,GAAG,OAAoB,GAAG,UAAU,CAE7G;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,GAAE,UAAU,GAAG,OAAoB,GAAG,UAAU,GAAG,IAAI,CAE9G"}