@quenty/studio-bridge 0.7.0 → 0.8.0

package/dist/src/server/pending-request-map.test.js

@@ -0,0 +1,192 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { PendingRequestMap } from './pending-request-map.js';
+describe('PendingRequestMap', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    describe('happy path', () => {
+        it('resolves the promise when resolveRequest is called', async () => {
+            const map = new PendingRequestMap();
+            const promise = map.addRequestAsync('req-1', 5000);
+            map.resolveRequest('req-1', 'hello');
+            await expect(promise).resolves.toBe('hello');
+        });
+        it('resolves with an object value', async () => {
+            const map = new PendingRequestMap();
+            const promise = map.addRequestAsync('req-1', 5000);
+            map.resolveRequest('req-1', { status: 200 });
+            await expect(promise).resolves.toEqual({ status: 200 });
+        });
+    });
+    describe('rejection', () => {
+        it('rejects the promise when rejectRequest is called', async () => {
+            const map = new PendingRequestMap();
+            const promise = map.addRequestAsync('req-1', 5000);
+            map.rejectRequest('req-1', new Error('Something failed'));
+            await expect(promise).rejects.toThrow('Something failed');
+        });
+    });
+    describe('timeout', () => {
+        it('rejects with timeout error after the specified duration', async () => {
+            const map = new PendingRequestMap();
+            const promise = map.addRequestAsync('req-1', 1000);
+            vi.advanceTimersByTime(1000);
+            await expect(promise).rejects.toThrow('Request "req-1" timed out after 1000ms');
+        });
+        it('removes the entry from the map after timeout', async () => {
+            const map = new PendingRequestMap();
+            const promise = map.addRequestAsync('req-1', 500);
+            expect(map.hasPendingRequest('req-1')).toBe(true);
+            vi.advanceTimersByTime(500);
+            // Let the rejection propagate
+            await promise.catch(() => { });
+            expect(map.hasPendingRequest('req-1')).toBe(false);
+            expect(map.pendingCount).toBe(0);
+        });
+    });
+    describe('cancelAll', () => {
+        it('rejects all pending requests', async () => {
+            const map = new PendingRequestMap();
+            const p1 = map.addRequestAsync('req-1', 5000);
+            const p2 = map.addRequestAsync('req-2', 5000);
+            const p3 = map.addRequestAsync('req-3', 5000);
+            map.cancelAll('session closed');
+            await expect(p1).rejects.toThrow('session closed');
+            await expect(p2).rejects.toThrow('session closed');
+            await expect(p3).rejects.toThrow('session closed');
+        });
+        it('uses default message when no reason provided', async () => {
+            const map = new PendingRequestMap();
+            const promise = map.addRequestAsync('req-1', 5000);
+            map.cancelAll();
+            await expect(promise).rejects.toThrow('All pending requests cancelled');
+        });
+        it('empties the map after cancellation', () => {
+            const map = new PendingRequestMap();
+            map.addRequestAsync('req-1', 5000).catch(() => { });
+            map.addRequestAsync('req-2', 5000).catch(() => { });
+            map.cancelAll();
+            expect(map.pendingCount).toBe(0);
+            expect(map.hasPendingRequest('req-1')).toBe(false);
+            expect(map.hasPendingRequest('req-2')).toBe(false);
+        });
+    });
+    describe('unknown ID handling', () => {
+        it('resolveRequest with unknown ID does not throw', () => {
+            const map = new PendingRequestMap();
+            expect(() => map.resolveRequest('nonexistent', 'value')).not.toThrow();
+        });
+        it('rejectRequest with unknown ID does not throw', () => {
+            const map = new PendingRequestMap();
+            expect(() => map.rejectRequest('nonexistent', new Error('err'))).not.toThrow();
+        });
+    });
+    describe('duplicate ID', () => {
+        it('rejects the second addRequestAsync immediately without disturbing the first', async () => {
+            const map = new PendingRequestMap();
+            const first = map.addRequestAsync('req-1', 5000);
+            const second = map.addRequestAsync('req-1', 5000);
+            await expect(second).rejects.toThrow('Request "req-1" is already pending');
+            // First should still be pending
+            expect(map.hasPendingRequest('req-1')).toBe(true);
+            // Resolve the first
+            map.resolveRequest('req-1', 'success');
+            await expect(first).resolves.toBe('success');
+        });
+    });
+    describe('pendingCount', () => {
+        it('starts at 0', () => {
+            const map = new PendingRequestMap();
+            expect(map.pendingCount).toBe(0);
+        });
+        it('increments when requests are added', () => {
+            const map = new PendingRequestMap();
+            map.addRequestAsync('req-1', 5000).catch(() => { });
+            expect(map.pendingCount).toBe(1);
+            map.addRequestAsync('req-2', 5000).catch(() => { });
+            expect(map.pendingCount).toBe(2);
+        });
+        it('decrements when requests are resolved', () => {
+            const map = new PendingRequestMap();
+            map.addRequestAsync('req-1', 5000).catch(() => { });
+            map.addRequestAsync('req-2', 5000).catch(() => { });
+            map.resolveRequest('req-1', 'done');
+            expect(map.pendingCount).toBe(1);
+            map.resolveRequest('req-2', 'done');
+            expect(map.pendingCount).toBe(0);
+        });
+        it('decrements when requests are rejected', () => {
+            const map = new PendingRequestMap();
+            map.addRequestAsync('req-1', 5000).catch(() => { });
+            map.rejectRequest('req-1', new Error('fail'));
+            expect(map.pendingCount).toBe(0);
+        });
+        it('decrements on timeout', async () => {
+            const map = new PendingRequestMap();
+            const promise = map.addRequestAsync('req-1', 100);
+            expect(map.pendingCount).toBe(1);
+            vi.advanceTimersByTime(100);
+            await promise.catch(() => { });
+            expect(map.pendingCount).toBe(0);
+        });
+    });
+    describe('hasPendingRequest', () => {
+        it('returns true for a pending request', () => {
+            const map = new PendingRequestMap();
+            map.addRequestAsync('req-1', 5000).catch(() => { });
+            expect(map.hasPendingRequest('req-1')).toBe(true);
+        });
+        it('returns false for an unknown request', () => {
+            const map = new PendingRequestMap();
+            expect(map.hasPendingRequest('req-1')).toBe(false);
+        });
+        it('returns false after resolve', () => {
+            const map = new PendingRequestMap();
+            map.addRequestAsync('req-1', 5000).catch(() => { });
+            map.resolveRequest('req-1', 'done');
+            expect(map.hasPendingRequest('req-1')).toBe(false);
+        });
+        it('returns false after reject', () => {
+            const map = new PendingRequestMap();
+            map.addRequestAsync('req-1', 5000).catch(() => { });
+            map.rejectRequest('req-1', new Error('fail'));
+            expect(map.hasPendingRequest('req-1')).toBe(false);
+        });
+        it('returns false after timeout', async () => {
+            const map = new PendingRequestMap();
+            const promise = map.addRequestAsync('req-1', 200);
+            vi.advanceTimersByTime(200);
+            await promise.catch(() => { });
+            expect(map.hasPendingRequest('req-1')).toBe(false);
+        });
+    });
+    describe('timer cleanup', () => {
+        it('clears the timeout when resolved before expiry', () => {
+            const map = new PendingRequestMap();
+            map.addRequestAsync('req-1', 5000).catch(() => { });
+            map.resolveRequest('req-1', 'done');
+            // Advancing past the original timeout should not cause issues
+            vi.advanceTimersByTime(10000);
+            expect(map.pendingCount).toBe(0);
+        });
+        it('clears the timeout when rejected before expiry', () => {
+            const map = new PendingRequestMap();
+            map.addRequestAsync('req-1', 5000).catch(() => { });
+            map.rejectRequest('req-1', new Error('early'));
+            vi.advanceTimersByTime(10000);
+            expect(map.pendingCount).toBe(0);
+        });
+        it('clears all timers on cancelAll', () => {
+            const map = new PendingRequestMap();
+            map.addRequestAsync('req-1', 5000).catch(() => { });
+            map.addRequestAsync('req-2', 5000).catch(() => { });
+            map.cancelAll();
+            vi.advanceTimersByTime(10000);
+            expect(map.pendingCount).toBe(0);
+        });
+    });
+});
+//# sourceMappingURL=pending-request-map.test.js.map

package/dist/src/server/pending-request-map.test.js.map

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

package/dist/src/server/plugin-detection.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for persistent plugin detection and fallback logic in
+ * StudioBridgeServer.startAsync(). Validates the grace period behavior,
+ * persistent plugin preference, and fallback to temp injection.
+ */
+export {};
+//# sourceMappingURL=plugin-detection.test.d.ts.map

package/dist/src/server/plugin-detection.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-detection.test.d.ts","sourceRoot":"","sources":["../../../src/server/plugin-detection.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/server/plugin-detection.test.js

@@ -0,0 +1,154 @@
+/**
+ * Tests for persistent plugin detection and fallback logic in
+ * StudioBridgeServer.startAsync(). Validates the grace period behavior,
+ * persistent plugin preference, and fallback to temp injection.
+ */
+import { describe, it, expect, vi, afterEach, beforeEach } from 'vitest';
+import { WebSocket } from 'ws';
+import { StudioBridgeServer } from './studio-bridge-server.js';
+vi.mock('@quenty/nevermore-template-helpers', () => ({
+    BuildContext: {
+        createAsync: vi.fn(async () => ({
+            resolvePath: vi.fn((rel) => `/fake/tmp/${rel}`),
+            executeLuneTransformScriptAsync: vi.fn(async () => { }),
+            rojoBuildAsync: vi.fn(async () => undefined),
+            cleanupAsync: vi.fn(async () => { }),
+        })),
+    },
+    resolvePackagePath: vi.fn((..._args) => '/fake/transform-script.luau'),
+    resolveTemplatePath: vi.fn((..._args) => '/fake/default.project.json'),
+}));
+const mockInjectPluginAsync = vi.fn(async () => ({
+    pluginPath: '/fake/plugin.rbxmx',
+    cleanupAsync: vi.fn(async () => { }),
+}));
+vi.mock('../plugin/plugin-injector.js', () => ({
+    injectPluginAsync: (..._args) => mockInjectPluginAsync(),
+}));
+const mockIsPersistentPluginInstalled = vi.fn(() => false);
+vi.mock('../plugin/plugin-discovery.js', () => ({
+    isPersistentPluginInstalled: () => mockIsPersistentPluginInstalled(),
+}));
+vi.mock('../process/studio-process-manager.js', () => ({
+    launchStudioAsync: vi.fn(async () => ({
+        process: { pid: 12345 },
+        killAsync: vi.fn(async () => { }),
+    })),
+    findPluginsFolder: vi.fn(() => '/fake/plugins'),
+}));
+/**
+ * Connect a WebSocket client and send a register message.
+ */
+async function connectAndHandshake(port, sessionId) {
+    const ws = new WebSocket(`ws://localhost:${port}/${sessionId}`);
+    await new Promise((resolve, reject) => {
+        ws.on('open', resolve);
+        ws.on('error', reject);
+    });
+    ws.send(JSON.stringify({
+        type: 'register',
+        sessionId,
+        payload: {
+            pluginVersion: '1.0.0',
+            instanceId: 'inst-1',
+            placeName: 'TestPlace',
+            state: 'Edit',
+            capabilities: ['execute', 'queryState'],
+        },
+    }));
+    // Allow server to process register
+    await new Promise((r) => setTimeout(r, 20));
+    return ws;
+}
+describe('persistent plugin detection', () => {
+    let server;
+    let client;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockIsPersistentPluginInstalled.mockReturnValue(false);
+    });
+    afterEach(async () => {
+        if (client && client.readyState === WebSocket.OPEN) {
+            client.close();
+        }
+        if (server) {
+            await server.stopAsync();
+        }
+        client = undefined;
+        server = undefined;
+    });
+    it('uses temp injection when persistent plugin is not installed', async () => {
+        mockIsPersistentPluginInstalled.mockReturnValue(false);
+        const sessionId = 'no-persistent';
+        server = new StudioBridgeServer({
+            placePath: '/fake/place.rbxl',
+            sessionId,
+            timeoutMs: 5_000,
+        });
+        const startPromise = server.startAsync();
+        await new Promise((r) => setTimeout(r, 50));
+        const port = server._port;
+        // Temp injection should have been called immediately
+        expect(mockInjectPluginAsync).toHaveBeenCalledTimes(1);
+        // Complete handshake so startAsync resolves
+        client = await connectAndHandshake(port, sessionId);
+        await startPromise;
+    });
+    it('uses temp injection when preferPersistentPlugin is false', async () => {
+        mockIsPersistentPluginInstalled.mockReturnValue(true);
+        const sessionId = 'prefer-false';
+        server = new StudioBridgeServer({
+            placePath: '/fake/place.rbxl',
+            sessionId,
+            timeoutMs: 5_000,
+            preferPersistentPlugin: false,
+        });
+        const startPromise = server.startAsync();
+        await new Promise((r) => setTimeout(r, 50));
+        const port = server._port;
+        // Temp injection should have been called immediately
+        expect(mockInjectPluginAsync).toHaveBeenCalledTimes(1);
+        // Complete handshake so startAsync resolves
+        client = await connectAndHandshake(port, sessionId);
+        await startPromise;
+    });
+    it('falls back to temp injection after grace period when persistent plugin does not connect', async () => {
+        mockIsPersistentPluginInstalled.mockReturnValue(true);
+        const sessionId = 'grace-expire';
+        server = new StudioBridgeServer({
+            placePath: '/fake/place.rbxl',
+            sessionId,
+            timeoutMs: 10_000,
+        });
+        const startPromise = server.startAsync();
+        // Wait for the grace period (3 seconds) to expire + some buffer
+        // The server should fall back to temp injection after 3 seconds
+        await new Promise((r) => setTimeout(r, 3_200));
+        // After grace period, temp injection should have been called
+        expect(mockInjectPluginAsync).toHaveBeenCalledTimes(1);
+        // Complete handshake so startAsync resolves
+        const port = server._port;
+        client = await connectAndHandshake(port, sessionId);
+        await startPromise;
+    }, 15_000);
+    it('skips temp injection when persistent plugin connects within grace period', async () => {
+        mockIsPersistentPluginInstalled.mockReturnValue(true);
+        const sessionId = 'plugin-connects';
+        server = new StudioBridgeServer({
+            placePath: '/fake/place.rbxl',
+            sessionId,
+            timeoutMs: 10_000,
+        });
+        const startPromise = server.startAsync();
+        // Wait for the server to be up
+        await new Promise((r) => setTimeout(r, 100));
+        const port = server._port;
+        // Connect a plugin within the grace period (simulating persistent plugin)
+        client = await connectAndHandshake(port, sessionId);
+        // Wait for startAsync to resolve
+        await startPromise;
+        // Temp injection should NOT have been called
+        expect(mockInjectPluginAsync).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=plugin-detection.test.js.map

package/dist/src/server/plugin-detection.test.js.map

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

package/dist/src/server/studio-bridge-server.d.ts

@@ -8,7 +8,7 @@
  *   const result = await server.executeAsync({ scriptContent, onOutput });
  *   await server.stopAsync();
  */
-import { type OutputLevel } from './web-socket-protocol.js';
+import { type OutputLevel, type Capability, type PluginMessage, type ServerMessage } from './web-socket-protocol.js';
 export type StudioBridgePhase = 'building' | 'launching' | 'connecting' | 'executing' | 'done';
 export interface StudioBridgeServerOptions {
     /** Path to the .rbxl place file to open. If omitted, a minimal place is
@@ -20,6 +20,11 @@ export interface StudioBridgeServerOptions {
     onPhase?: (phase: StudioBridgePhase) => void;
     /** Session ID for concurrent session isolation. Auto-generated if omitted. */
     sessionId?: string;
+    /** Whether to prefer the persistent plugin over temp injection (default: true).
+     *  When true and the persistent plugin is installed, the server waits for
+     *  the plugin to discover it via the health endpoint before falling back
+     *  to temporary injection. Set to false in CI environments. */
+    preferPersistentPlugin?: boolean;
 }
 export interface ExecuteOptions {
     /** Luau script content to execute */
@@ -35,32 +40,64 @@ export interface StudioBridgeResult {
 }
 export declare class StudioBridgeServer {
     private _state;
+    private readonly _options;
     private readonly _sessionId;
     private readonly _defaultTimeoutMs;
     private readonly _onPhase;
     private readonly _placePath;
+    private _httpServer;
     private _wss;
+    private _port;
     private _pluginHandle;
     private _studioProc;
     private _placeBuildContext;
     private _connectedClient;
+    private _negotiatedCapabilities;
+    private _lastHeartbeatTimestamp;
+    private _actionDispatcher;
+    private _actionsReady;
+    private _actionSources;
     constructor(options?: StudioBridgeServerOptions);
+    /** The negotiated set of capabilities shared between plugin and server. */
+    get capabilities(): readonly Capability[];
+    /** Timestamp of the last heartbeat received from the plugin, or undefined. */
+    get lastHeartbeatTimestamp(): number | undefined;
+    /** Requires the plugin to advertise the relevant capability. */
+    performActionAsync<T extends PluginMessage>(message: Omit<ServerMessage, 'requestId' | 'sessionId'>, timeoutMs?: number): Promise<T>;
     /**
      * Build place (if needed) → start WS server → inject plugin → launch
      * Studio → wait for handshake.
      */
     startAsync(): Promise<void>;
+    /** Can be called multiple times while the bridge is ready. */
+    executeAsync(options: ExecuteOptions): Promise<StudioBridgeResult>;
+    /** Idempotent on 'stopped'. */
+    stopAsync(): Promise<void>;
     /**
-     * Send a Luau script to the connected Studio instance and wait for it to
-     * finish executing. Can be called multiple times while the bridge is ready.
+     * Ensure action modules (like `execute.luau`) are synced to the plugin
+     * before first use. Uses `syncActions` to check which actions the plugin
+     * is missing, then registers them via `registerAction`.
+     *
+     * Loads action sources and registers them with the connected plugin.
      */
-    executeAsync(options: ExecuteOptions): Promise<StudioBridgeResult>;
+    private _ensureActionsAsync;
     /**
-     * Shut down the bridge — send shutdown to client, kill Studio, clean up
-     * all resources. Idempotent on 'stopped'.
+     * Inject the temporary plugin via rojo build into Studio's plugins folder.
      */
-    stopAsync(): Promise<void>;
+    private _injectPluginAsync;
+    /**
+     * Wait for a persistent plugin to connect via WebSocket within the grace
+     * period. Returns true if a plugin connected (sent hello or register),
+     * false if the grace period expired.
+     */
+    private _waitForPluginConnectionAsync;
+    private _handlePluginHandshakeMessage;
     private _waitForHandshakeAsync;
+    /**
+     * Common handshake completion: store the connected client, listen for
+     * heartbeats and disconnect events.
+     */
+    private _finishHandshake;
     private _waitForScriptCompleteAsync;
     private _cleanupResourcesAsync;
 }

package/dist/src/server/studio-bridge-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"studio-bridge-server.d.ts","sourceRoot":"","sources":["../../../src/server/studio-bridge-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,OAAO,EACL,KAAK,WAAW,EAGjB,MAAM,0BAA0B,CAAC;AAyBlC,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,WAAW,GACX,YAAY,GACZ,WAAW,GACX,MAAM,CAAC;AAEX,MAAM,WAAW,yBAAyB;IACxC;gEAC4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAoCD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAuB;IAErC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmD;IAC5E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAEhD,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,kBAAkB,CAA2B;IACrD,OAAO,CAAC,gBAAgB,CAAwB;gBAEpC,OAAO,GAAE,yBAA8B;IAWnD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA6EjC;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA2CxE;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BhC,OAAO,CAAC,sBAAsB;IAwF9B,OAAO,CAAC,2BAA2B;YA6GrB,sBAAsB;CAiCrC"}
+{"version":3,"file":"studio-bridge-server.d.ts","sourceRoot":"","sources":["../../../src/server/studio-bridge-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAGnB,MAAM,0BAA0B,CAAC;AA0ClC,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,WAAW,GACX,YAAY,GACZ,WAAW,GACX,MAAM,CAAC;AAEX,MAAM,WAAW,yBAAyB;IACxC;gEAC4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;mEAG+D;IAC/D,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAiFD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAuB;IAErC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmD;IAC5E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAEhD,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,IAAI,CAA8B;IAC1C,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,kBAAkB,CAA2B;IACrD,OAAO,CAAC,gBAAgB,CAAwB;IAEhD,OAAO,CAAC,uBAAuB,CAA6B;IAC5D,OAAO,CAAC,uBAAuB,CAAqB;IACpD,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAA6B;gBAEvC,OAAO,GAAE,yBAA8B;IAQnD,2EAA2E;IAC3E,IAAI,YAAY,IAAI,SAAS,UAAU,EAAE,CAExC;IAED,8EAA8E;IAC9E,IAAI,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAE/C;IAED,gEAAgE;IAC1D,kBAAkB,CAAC,CAAC,SAAS,aAAa,EAC9C,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,WAAW,CAAC,EACvD,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC;IAmCb;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmGjC,8DAA8D;IACxD,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAyCxE,+BAA+B;IACzB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBhC;;;;;;OAMG;YACW,mBAAmB;IAmEjC;;OAEG;YACW,kBAAkB;IAUhC;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IAyCrC,OAAO,CAAC,6BAA6B;IA+CrC,OAAO,CAAC,sBAAsB;IAoE9B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAqCxB,OAAO,CAAC,2BAA2B;YA0HrB,sBAAsB;CAwCrC"}