@quenty/studio-bridge 0.7.0 → 0.8.0

package/dist/src/bridge/internal/session-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tracker.d.ts","sourceRoot":"","sources":["../../../../src/bridge/internal/session-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,YAAY,EACZ,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACd,MAAM,qCAAqC,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,SAAS,EACvB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,SAAS,CAAC,CAAC;IACtB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAAC;IACnE,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB,aAAa,EAAE,IAAI,CAAC;CACrB;AAED,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,iBAAiB,CAAkC;IAE3D;;;OAGG;IACH,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,eAAe,GACtB,IAAI;IA4BP;;;OAGG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAyBtC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIzD;;OAEG;IACH,YAAY,IAAI,WAAW,EAAE;IAI7B;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAU/D;;;OAGG;IACH,aAAa,IAAI,YAAY,EAAE;IAU/B;;OAEG;IACH,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE;IAgB3D;;;OAGG;IACH,mBAAmB,CACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,cAAc,GAAG,SAAS;IAK7B,4CAA4C;IAC5C,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,OAAO,CAAC,kBAAkB;CAa3B"}

package/dist/src/bridge/internal/session-tracker.js

@@ -0,0 +1,138 @@
+/**
+ * In-memory session map with instance-level grouping. Tracks connected
+ * plugin sessions by sessionId and groups them by instanceId for
+ * multi-context support (edit, client, server in Play mode).
+ *
+ * Used exclusively by bridge-host.ts. Emits events when sessions and
+ * instance groups are added, removed, or updated.
+ */
+import { EventEmitter } from 'events';
+export class SessionTracker extends EventEmitter {
+    _sessions = new Map();
+    _instanceSessions = new Map();
+    /**
+     * Add a session to the tracker. Groups by instanceId and emits events.
+     * If this is the first session for the instanceId, emits 'instance-added'.
+     */
+    addSession(sessionId, info, handle) {
+        const tracked = {
+            info,
+            handle,
+            lastHeartbeat: new Date(),
+        };
+        this._sessions.set(sessionId, tracked);
+        // Instance grouping
+        const instanceId = info.instanceId;
+        let sessionSet = this._instanceSessions.get(instanceId);
+        const isNewInstance = !sessionSet;
+        if (!sessionSet) {
+            sessionSet = new Set();
+            this._instanceSessions.set(instanceId, sessionSet);
+        }
+        sessionSet.add(sessionId);
+        this.emit('session-added', tracked);
+        if (isNewInstance) {
+            this.emit('instance-added', this._buildInstanceInfo(instanceId));
+        }
+    }
+    /**
+     * Remove a session from the tracker. If this was the last session for
+     * the instanceId, removes the instance group and emits 'instance-removed'.
+     */
+    removeSession(sessionId) {
+        const tracked = this._sessions.get(sessionId);
+        if (!tracked) {
+            return;
+        }
+        const instanceId = tracked.info.instanceId;
+        this._sessions.delete(sessionId);
+        // Update instance grouping
+        const sessionSet = this._instanceSessions.get(instanceId);
+        if (sessionSet) {
+            sessionSet.delete(sessionId);
+            if (sessionSet.size === 0) {
+                this._instanceSessions.delete(instanceId);
+                this.emit('session-removed', sessionId);
+                this.emit('instance-removed', instanceId);
+                return;
+            }
+        }
+        this.emit('session-removed', sessionId);
+    }
+    /**
+     * Get a tracked session by sessionId.
+     */
+    getSession(sessionId) {
+        return this._sessions.get(sessionId);
+    }
+    /**
+     * List all session infos.
+     */
+    listSessions() {
+        return Array.from(this._sessions.values()).map((t) => t.info);
+    }
+    /**
+     * Update a session's state and emit 'session-updated'.
+     */
+    updateSessionState(sessionId, state) {
+        const tracked = this._sessions.get(sessionId);
+        if (!tracked) {
+            return;
+        }
+        tracked.info = { ...tracked.info, state };
+        this.emit('session-updated', tracked);
+    }
+    /**
+     * List unique instances. Each instance groups 1-3 context sessions
+     * that share the same instanceId.
+     */
+    listInstances() {
+        const instances = [];
+        for (const instanceId of this._instanceSessions.keys()) {
+            instances.push(this._buildInstanceInfo(instanceId));
+        }
+        return instances;
+    }
+    /**
+     * Get all tracked sessions for a given instanceId.
+     */
+    getSessionsByInstance(instanceId) {
+        const sessionIds = this._instanceSessions.get(instanceId);
+        if (!sessionIds) {
+            return [];
+        }
+        const result = [];
+        for (const sessionId of sessionIds) {
+            const tracked = this._sessions.get(sessionId);
+            if (tracked) {
+                result.push(tracked);
+            }
+        }
+        return result;
+    }
+    /**
+     * Get a specific context session for an instance.
+     * Returns undefined if the context is not connected.
+     */
+    getSessionByContext(instanceId, context) {
+        const sessions = this.getSessionsByInstance(instanceId);
+        return sessions.find((s) => s.info.context === context);
+    }
+    /** Number of currently tracked sessions. */
+    get sessionCount() {
+        return this._sessions.size;
+    }
+    _buildInstanceInfo(instanceId) {
+        const sessions = this.getSessionsByInstance(instanceId);
+        const first = sessions[0];
+        return {
+            instanceId,
+            placeName: first?.info.placeName ?? '',
+            placeId: first?.info.placeId ?? 0,
+            gameId: first?.info.gameId ?? 0,
+            contexts: sessions.map((s) => s.info.context),
+            origin: first?.info.origin ?? 'user',
+        };
+    }
+}
+//# sourceMappingURL=session-tracker.js.map

package/dist/src/bridge/internal/session-tracker.js.map

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

package/dist/src/bridge/internal/session-tracker.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Unit tests for SessionTracker -- validates session add/remove,
+ * instance grouping, event emission, state updates, and context queries.
+ */
+export {};
+//# sourceMappingURL=session-tracker.test.d.ts.map

package/dist/src/bridge/internal/session-tracker.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tracker.test.d.ts","sourceRoot":"","sources":["../../../../src/bridge/internal/session-tracker.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/bridge/internal/session-tracker.test.js

@@ -0,0 +1,342 @@
+/**
+ * Unit tests for SessionTracker -- validates session add/remove,
+ * instance grouping, event emission, state updates, and context queries.
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { SessionTracker, } from './session-tracker.js';
+import { EventEmitter } from 'events';
+function createMockHandle(connected = true) {
+    const emitter = new EventEmitter();
+    return {
+        sendActionAsync: vi.fn(async () => ({})),
+        sendMessage: vi.fn(),
+        isConnected: connected,
+        on: emitter.on.bind(emitter),
+    };
+}
+function createSessionInfo(overrides = {}) {
+    return {
+        sessionId: 'session-1',
+        placeName: 'TestPlace',
+        state: 'Edit',
+        pluginVersion: '1.0.0',
+        capabilities: ['execute', 'queryState'],
+        connectedAt: new Date(),
+        origin: 'user',
+        context: 'edit',
+        instanceId: 'inst-1',
+        placeId: 123,
+        gameId: 456,
+        ...overrides,
+    };
+}
+describe('SessionTracker', () => {
+    let tracker;
+    beforeEach(() => {
+        tracker = new SessionTracker();
+    });
+    describe('addSession', () => {
+        it('adds a session and increments sessionCount', () => {
+            const info = createSessionInfo();
+            const handle = createMockHandle();
+            tracker.addSession('session-1', info, handle);
+            expect(tracker.sessionCount).toBe(1);
+        });
+        it('emits session-added event with tracked session', () => {
+            const info = createSessionInfo();
+            const handle = createMockHandle();
+            const listener = vi.fn();
+            tracker.on('session-added', listener);
+            tracker.addSession('session-1', info, handle);
+            expect(listener).toHaveBeenCalledTimes(1);
+            const tracked = listener.mock.calls[0][0];
+            expect(tracked.info.sessionId).toBe('session-1');
+            expect(tracked.handle).toBe(handle);
+        });
+        it('emits instance-added on first session for an instanceId', () => {
+            const info = createSessionInfo({ instanceId: 'inst-A' });
+            const handle = createMockHandle();
+            const listener = vi.fn();
+            tracker.on('instance-added', listener);
+            tracker.addSession('session-1', info, handle);
+            expect(listener).toHaveBeenCalledTimes(1);
+            const instance = listener.mock.calls[0][0];
+            expect(instance.instanceId).toBe('inst-A');
+            expect(instance.contexts).toEqual(['edit']);
+        });
+        it('does not emit instance-added for subsequent sessions on same instanceId', () => {
+            const handle = createMockHandle();
+            const listener = vi.fn();
+            tracker.on('instance-added', listener);
+            tracker.addSession('session-edit', createSessionInfo({
+                sessionId: 'session-edit',
+                instanceId: 'inst-A',
+                context: 'edit',
+            }), handle);
+            tracker.addSession('session-server', createSessionInfo({
+                sessionId: 'session-server',
+                instanceId: 'inst-A',
+                context: 'server',
+            }), handle);
+            expect(listener).toHaveBeenCalledTimes(1);
+        });
+        it('tracks multiple sessions', () => {
+            const handle = createMockHandle();
+            tracker.addSession('s1', createSessionInfo({ sessionId: 's1' }), handle);
+            tracker.addSession('s2', createSessionInfo({ sessionId: 's2', instanceId: 'inst-2' }), handle);
+            expect(tracker.sessionCount).toBe(2);
+        });
+    });
+    describe('removeSession', () => {
+        it('removes a session and decrements sessionCount', () => {
+            const handle = createMockHandle();
+            tracker.addSession('s1', createSessionInfo({ sessionId: 's1' }), handle);
+            tracker.removeSession('s1');
+            expect(tracker.sessionCount).toBe(0);
+        });
+        it('emits session-removed with sessionId', () => {
+            const handle = createMockHandle();
+            tracker.addSession('s1', createSessionInfo({ sessionId: 's1' }), handle);
+            const listener = vi.fn();
+            tracker.on('session-removed', listener);
+            tracker.removeSession('s1');
+            expect(listener).toHaveBeenCalledWith('s1');
+        });
+        it('emits instance-removed when last session for instanceId is removed', () => {
+            const handle = createMockHandle();
+            tracker.addSession('s1', createSessionInfo({ sessionId: 's1', instanceId: 'inst-A' }), handle);
+            const listener = vi.fn();
+            tracker.on('instance-removed', listener);
+            tracker.removeSession('s1');
+            expect(listener).toHaveBeenCalledWith('inst-A');
+        });
+        it('does not emit instance-removed when other sessions remain for instanceId', () => {
+            const handle = createMockHandle();
+            tracker.addSession('s-edit', createSessionInfo({
+                sessionId: 's-edit',
+                instanceId: 'inst-A',
+                context: 'edit',
+            }), handle);
+            tracker.addSession('s-server', createSessionInfo({
+                sessionId: 's-server',
+                instanceId: 'inst-A',
+                context: 'server',
+            }), handle);
+            const listener = vi.fn();
+            tracker.on('instance-removed', listener);
+            tracker.removeSession('s-server');
+            expect(listener).not.toHaveBeenCalled();
+            expect(tracker.sessionCount).toBe(1);
+        });
+        it('is a no-op for unknown sessionId', () => {
+            const listener = vi.fn();
+            tracker.on('session-removed', listener);
+            tracker.removeSession('nonexistent');
+            expect(listener).not.toHaveBeenCalled();
+        });
+    });
+    describe('getSession', () => {
+        it('returns tracked session by id', () => {
+            const info = createSessionInfo({ sessionId: 's1' });
+            const handle = createMockHandle();
+            tracker.addSession('s1', info, handle);
+            const tracked = tracker.getSession('s1');
+            expect(tracked).toBeDefined();
+            expect(tracked.info.sessionId).toBe('s1');
+            expect(tracked.handle).toBe(handle);
+        });
+        it('returns undefined for unknown id', () => {
+            expect(tracker.getSession('nonexistent')).toBeUndefined();
+        });
+    });
+    describe('listSessions', () => {
+        it('returns empty array when no sessions', () => {
+            expect(tracker.listSessions()).toEqual([]);
+        });
+        it('returns all session infos', () => {
+            const handle = createMockHandle();
+            tracker.addSession('s1', createSessionInfo({ sessionId: 's1' }), handle);
+            tracker.addSession('s2', createSessionInfo({ sessionId: 's2', instanceId: 'inst-2' }), handle);
+            const sessions = tracker.listSessions();
+            expect(sessions).toHaveLength(2);
+            expect(sessions.map((s) => s.sessionId).sort()).toEqual(['s1', 's2']);
+        });
+    });
+    describe('updateSessionState', () => {
+        it('updates state and emits session-updated', () => {
+            const handle = createMockHandle();
+            tracker.addSession('s1', createSessionInfo({ sessionId: 's1', state: 'Edit' }), handle);
+            const listener = vi.fn();
+            tracker.on('session-updated', listener);
+            tracker.updateSessionState('s1', 'Play');
+            const tracked = tracker.getSession('s1');
+            expect(tracked.info.state).toBe('Play');
+            expect(listener).toHaveBeenCalledTimes(1);
+            expect(listener.mock.calls[0][0].info.state).toBe('Play');
+        });
+        it('is a no-op for unknown sessionId', () => {
+            const listener = vi.fn();
+            tracker.on('session-updated', listener);
+            tracker.updateSessionState('nonexistent', 'Play');
+            expect(listener).not.toHaveBeenCalled();
+        });
+    });
+    describe('listInstances', () => {
+        it('returns empty array when no sessions', () => {
+            expect(tracker.listInstances()).toEqual([]);
+        });
+        it('groups sessions by instanceId', () => {
+            const handle = createMockHandle();
+            tracker.addSession('s-edit', createSessionInfo({
+                sessionId: 's-edit',
+                instanceId: 'inst-A',
+                context: 'edit',
+                placeName: 'MyPlace',
+                placeId: 100,
+                gameId: 200,
+            }), handle);
+            tracker.addSession('s-server', createSessionInfo({
+                sessionId: 's-server',
+                instanceId: 'inst-A',
+                context: 'server',
+            }), handle);
+            tracker.addSession('s-client', createSessionInfo({
+                sessionId: 's-client',
+                instanceId: 'inst-A',
+                context: 'client',
+            }), handle);
+            const instances = tracker.listInstances();
+            expect(instances).toHaveLength(1);
+            expect(instances[0].instanceId).toBe('inst-A');
+            expect(instances[0].contexts.sort()).toEqual([
+                'client',
+                'edit',
+                'server',
+            ]);
+        });
+        it('returns multiple instances for different instanceIds', () => {
+            const handle = createMockHandle();
+            tracker.addSession('s1', createSessionInfo({ sessionId: 's1', instanceId: 'inst-A' }), handle);
+            tracker.addSession('s2', createSessionInfo({ sessionId: 's2', instanceId: 'inst-B' }), handle);
+            const instances = tracker.listInstances();
+            expect(instances).toHaveLength(2);
+            const ids = instances.map((i) => i.instanceId).sort();
+            expect(ids).toEqual(['inst-A', 'inst-B']);
+        });
+    });
+    describe('getSessionsByInstance', () => {
+        it('returns all sessions for an instanceId', () => {
+            const handle = createMockHandle();
+            tracker.addSession('s-edit', createSessionInfo({
+                sessionId: 's-edit',
+                instanceId: 'inst-A',
+                context: 'edit',
+            }), handle);
+            tracker.addSession('s-server', createSessionInfo({
+                sessionId: 's-server',
+                instanceId: 'inst-A',
+                context: 'server',
+            }), handle);
+            const sessions = tracker.getSessionsByInstance('inst-A');
+            expect(sessions).toHaveLength(2);
+        });
+        it('returns empty array for unknown instanceId', () => {
+            expect(tracker.getSessionsByInstance('nonexistent')).toEqual([]);
+        });
+    });
+    describe('getSessionByContext', () => {
+        it('returns the session matching the context', () => {
+            const handle = createMockHandle();
+            tracker.addSession('s-edit', createSessionInfo({
+                sessionId: 's-edit',
+                instanceId: 'inst-A',
+                context: 'edit',
+            }), handle);
+            tracker.addSession('s-server', createSessionInfo({
+                sessionId: 's-server',
+                instanceId: 'inst-A',
+                context: 'server',
+            }), handle);
+            const session = tracker.getSessionByContext('inst-A', 'server');
+            expect(session).toBeDefined();
+            expect(session.info.sessionId).toBe('s-server');
+        });
+        it('returns undefined when context is not connected', () => {
+            const handle = createMockHandle();
+            tracker.addSession('s-edit', createSessionInfo({
+                sessionId: 's-edit',
+                instanceId: 'inst-A',
+                context: 'edit',
+            }), handle);
+            const session = tracker.getSessionByContext('inst-A', 'client');
+            expect(session).toBeUndefined();
+        });
+        it('returns undefined for unknown instanceId', () => {
+            expect(tracker.getSessionByContext('nonexistent', 'edit')).toBeUndefined();
+        });
+    });
+    describe('instance lifecycle', () => {
+        it('instance-added fires once then contexts update without new event', () => {
+            const handle = createMockHandle();
+            const instanceAdded = vi.fn();
+            tracker.on('instance-added', instanceAdded);
+            // First session -> instance-added
+            tracker.addSession('s-edit', createSessionInfo({
+                sessionId: 's-edit',
+                instanceId: 'inst-A',
+                context: 'edit',
+            }), handle);
+            expect(instanceAdded).toHaveBeenCalledTimes(1);
+            // Second session -> no instance-added
+            tracker.addSession('s-server', createSessionInfo({
+                sessionId: 's-server',
+                instanceId: 'inst-A',
+                context: 'server',
+            }), handle);
+            expect(instanceAdded).toHaveBeenCalledTimes(1);
+            // Instance contexts should reflect both
+            const instances = tracker.listInstances();
+            expect(instances[0].contexts.sort()).toEqual(['edit', 'server']);
+        });
+        it('removing one context updates instance but does not remove it', () => {
+            const handle = createMockHandle();
+            const instanceRemoved = vi.fn();
+            tracker.on('instance-removed', instanceRemoved);
+            tracker.addSession('s-edit', createSessionInfo({
+                sessionId: 's-edit',
+                instanceId: 'inst-A',
+                context: 'edit',
+            }), handle);
+            tracker.addSession('s-server', createSessionInfo({
+                sessionId: 's-server',
+                instanceId: 'inst-A',
+                context: 'server',
+            }), handle);
+            tracker.removeSession('s-server');
+            expect(instanceRemoved).not.toHaveBeenCalled();
+            const instances = tracker.listInstances();
+            expect(instances).toHaveLength(1);
+            expect(instances[0].contexts).toEqual(['edit']);
+        });
+        it('removing all contexts for an instance fires instance-removed', () => {
+            const handle = createMockHandle();
+            const instanceRemoved = vi.fn();
+            tracker.on('instance-removed', instanceRemoved);
+            tracker.addSession('s-edit', createSessionInfo({
+                sessionId: 's-edit',
+                instanceId: 'inst-A',
+                context: 'edit',
+            }), handle);
+            tracker.addSession('s-server', createSessionInfo({
+                sessionId: 's-server',
+                instanceId: 'inst-A',
+                context: 'server',
+            }), handle);
+            tracker.removeSession('s-edit');
+            expect(instanceRemoved).not.toHaveBeenCalled();
+            tracker.removeSession('s-server');
+            expect(instanceRemoved).toHaveBeenCalledWith('inst-A');
+        });
+    });
+});
+//# sourceMappingURL=session-tracker.test.js.map

package/dist/src/bridge/internal/session-tracker.test.js.map

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

package/dist/src/bridge/internal/transport-client.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Low-level WebSocket client with automatic reconnection and exponential
+ * backoff. Handles connection, message send/receive, and reconnection
+ * on disconnect. No business logic -- it is a dumb pipe.
+ */
+import { EventEmitter } from 'events';
+export interface TransportClientOptions {
+    /** Maximum number of reconnection attempts. Default: 10. */
+    maxReconnectAttempts?: number;
+    /** Initial backoff delay in ms. Default: 1000. */
+    initialBackoffMs?: number;
+    /** Maximum backoff delay in ms. Default: 30000. */
+    maxBackoffMs?: number;
+}
+export declare class TransportClient extends EventEmitter {
+    private _ws;
+    private _url;
+    private _isConnected;
+    private _reconnectAttempt;
+    private _reconnectTimer;
+    private _options;
+    private _intentionalClose;
+    /**
+     * Connect to the given WebSocket URL. Resolves when the connection is
+     * established. Rejects if the initial connection fails.
+     */
+    connectAsync(url: string, options?: TransportClientOptions): Promise<void>;
+    /**
+     * Disconnect from the server. Does not attempt reconnection.
+     */
+    disconnect(): void;
+    /**
+     * Send a string message over the WebSocket.
+     */
+    send(data: string): void;
+    /** Whether the client is currently connected. */
+    get isConnected(): boolean;
+    private _connectInternalAsync;
+    private _setupMessageHandler;
+    private _scheduleReconnect;
+    private _clearReconnectTimer;
+}
+//# sourceMappingURL=transport-client.d.ts.map

package/dist/src/bridge/internal/transport-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-client.d.ts","sourceRoot":"","sources":["../../../../src/bridge/internal/transport-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,eAAe,CAA4C;IACnE,OAAO,CAAC,QAAQ,CAId;IACF,OAAO,CAAC,iBAAiB,CAAS;IAElC;;;OAGG;IACG,YAAY,CAChB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC;IAiBhB;;OAEG;IACH,UAAU,IAAI,IAAI;IAqBlB;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOxB,iDAAiD;IACjD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,OAAO,CAAC,qBAAqB;IAoC7B,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,kBAAkB;IAiC1B,OAAO,CAAC,oBAAoB;CAM7B"}