@selvajs/server 0.2.0-beta.1

package/dist/compute/__tests__/solve-pipeline.test.js

@@ -0,0 +1,245 @@
+/**
+ * Tests for `runSolvePipeline` — the transport-agnostic solve core (K3).
+ *
+ * `@selvajs/compute` is mocked so the pipeline runs without a live compute
+ * server: `TreeBuilder.fromInputParams` returns a marker tree and the scheduler
+ * is a stub whose `solve` we script per test (resolve a response, throw an
+ * AbortError, etc.). That isolates the pipeline's own behavior — outcome
+ * classification, size cap, gzip, and the Server-Timing / version envelope.
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { gunzipSync } from 'node:zlib';
+// --- Mock @selvajs/compute -------------------------------------------------
+vi.mock('@selvajs/compute', () => {
+    return {
+        TreeBuilder: {
+            fromInputParams: (params) => ({ __tree: true, count: params.length })
+        },
+        // transform-input.ts (imported by the pipeline) calls processInput; return
+        // the raw shape as an InputParam so filtering/mapping runs end-to-end.
+        processInput: (raw) => raw
+    };
+});
+import { runSolvePipeline, COMPUTE_CONTRACT_VERSION, COMPUTE_VERSION_HEADER } from '../index.js';
+/** A CachedClient stub whose scheduler.solve is scripted per test. */
+function fakeClient(solve) {
+    return {
+        client: {},
+        scheduler: { solve },
+        rhinoTiming: { last: null },
+        solveMeta: { last: null }
+    };
+}
+function baseArgs(over = {}) {
+    return {
+        definitionSource: new Uint8Array([1, 2, 3]),
+        inputs: [{ id: 'a', paramType: 'number', nickname: 'A' }],
+        values: { a: 5 },
+        client: fakeClient(async () => ({ values: [], errors: [], warnings: [] })),
+        responseMaxBytes: 10 * 1024 * 1024,
+        maxSolveDurationMs: 100_000,
+        acceptEncoding: '',
+        signal: new AbortController().signal,
+        loadStartMs: performance.now(),
+        defLoadMs: 1.5,
+        prepMarks: [['body', 0.2]],
+        ...over
+    };
+}
+describe('runSolvePipeline — success', () => {
+    it('returns an ok envelope with a JSON body and the version header', async () => {
+        const result = { values: [{ id: 'out' }], errors: [], warnings: ['w'] };
+        const outcome = await runSolvePipeline(baseArgs({ client: fakeClient(async () => result) }));
+        expect(outcome.kind).toBe('ok');
+        if (outcome.kind !== 'ok')
+            return;
+        expect(outcome.errorCount).toBe(0);
+        expect(outcome.warningCount).toBe(1);
+        expect(outcome.envelope.encoding).toBeUndefined();
+        expect(JSON.parse(outcome.envelope.body)).toEqual(result);
+        expect(outcome.envelope.headers[COMPUTE_VERSION_HEADER]).toBe(String(COMPUTE_CONTRACT_VERSION));
+        expect(outcome.envelope.headers['Content-Type']).toBe('application/json');
+        expect(outcome.envelope.headers['Content-Length']).toBe(String(Buffer.byteLength(outcome.envelope.body)));
+    });
+    it('only sends inputs with a paramType to the tree builder', async () => {
+        let seenTree;
+        const outcome = await runSolvePipeline(baseArgs({
+            inputs: [
+                { id: 'a', paramType: 'number', nickname: 'A' },
+                { id: 'b', nickname: 'B' } // no paramType → filtered out
+            ],
+            client: fakeClient(async (_def, tree) => {
+                seenTree = tree;
+                return { errors: [], warnings: [] };
+            })
+        }));
+        expect(outcome.kind).toBe('ok');
+        expect(seenTree).toEqual({ __tree: true, count: 1 });
+    });
+    it('forwards the abort signal to the scheduler', async () => {
+        const controller = new AbortController();
+        let seenSignal;
+        await runSolvePipeline(baseArgs({
+            signal: controller.signal,
+            client: fakeClient(async (_d, _t, opts) => {
+                seenSignal = opts.signal;
+                return { errors: [], warnings: [] };
+            })
+        }));
+        expect(seenSignal).toBe(controller.signal);
+    });
+});
+describe('runSolvePipeline — gzip', () => {
+    it('compresses when Accept-Encoding allows and the body is over 1 KB', async () => {
+        // A payload comfortably over the 1 KB gzip threshold.
+        const big = { values: Array.from({ length: 500 }, (_, i) => ({ i, s: 'xxxxxxxxxx' })) };
+        const outcome = await runSolvePipeline(baseArgs({ acceptEncoding: 'gzip, br', client: fakeClient(async () => big) }));
+        expect(outcome.kind).toBe('ok');
+        if (outcome.kind !== 'ok')
+            return;
+        expect(outcome.envelope.encoding).toBe('gzip');
+        expect(outcome.envelope.headers['Content-Encoding']).toBe('gzip');
+        expect(outcome.envelope.headers['Vary']).toBe('Accept-Encoding');
+        // The gzip body round-trips back to the original JSON.
+        const inflated = gunzipSync(Buffer.from(outcome.envelope.body)).toString();
+        expect(JSON.parse(inflated)).toEqual(big);
+        expect(outcome.envelope.metrics.compressedBytes).toBeGreaterThan(0);
+    });
+    it('does NOT compress when Accept-Encoding lacks gzip', async () => {
+        const big = { values: Array.from({ length: 500 }, (_, i) => ({ i, s: 'xxxxxxxxxx' })) };
+        const outcome = await runSolvePipeline(baseArgs({ acceptEncoding: 'br', client: fakeClient(async () => big) }));
+        expect(outcome.kind).toBe('ok');
+        if (outcome.kind !== 'ok')
+            return;
+        expect(outcome.envelope.encoding).toBeUndefined();
+        expect(outcome.envelope.headers['Content-Encoding']).toBeUndefined();
+        expect(outcome.envelope.metrics.compressedBytes).toBeNull();
+    });
+    it('does NOT compress a tiny body even with gzip advertised', async () => {
+        const outcome = await runSolvePipeline(baseArgs({ acceptEncoding: 'gzip', client: fakeClient(async () => ({ ok: 1 })) }));
+        expect(outcome.kind).toBe('ok');
+        if (outcome.kind !== 'ok')
+            return;
+        expect(outcome.envelope.encoding).toBeUndefined();
+    });
+});
+describe('runSolvePipeline — failure outcomes', () => {
+    it('classifies the scheduler deadline (AbortError, signal NOT aborted) as timeout', async () => {
+        const outcome = await runSolvePipeline(baseArgs({
+            maxSolveDurationMs: 42_000,
+            client: fakeClient(async () => {
+                const e = new Error('aborted');
+                e.name = 'AbortError';
+                throw e;
+            })
+        }));
+        expect(outcome.kind).toBe('timeout');
+        if (outcome.kind !== 'timeout')
+            return;
+        expect(outcome.message).toContain('42s');
+        expect(outcome.durationMs).toBeGreaterThanOrEqual(0);
+    });
+    it('classifies AbortError with the request signal aborted as client_abort', async () => {
+        const controller = new AbortController();
+        controller.abort();
+        const outcome = await runSolvePipeline(baseArgs({
+            signal: controller.signal,
+            client: fakeClient(async () => {
+                const e = new Error('aborted');
+                e.name = 'AbortError';
+                throw e;
+            })
+        }));
+        expect(outcome.kind).toBe('client_abort');
+    });
+    it('classifies any other throw as compute_error carrying the original error', async () => {
+        const boom = new TypeError('fetch failed');
+        const outcome = await runSolvePipeline(baseArgs({
+            client: fakeClient(async () => {
+                throw boom;
+            })
+        }));
+        expect(outcome.kind).toBe('compute_error');
+        if (outcome.kind !== 'compute_error')
+            return;
+        expect(outcome.error).toBe(boom);
+    });
+    it('returns too_large when the serialized result exceeds responseMaxBytes', async () => {
+        const outcome = await runSolvePipeline(baseArgs({
+            responseMaxBytes: 10, // tiny cap
+            client: fakeClient(async () => ({ values: 'a bigger than ten bytes payload' }))
+        }));
+        expect(outcome.kind).toBe('too_large');
+    });
+});
+describe('runSolvePipeline — Server-Timing', () => {
+    it('emits the core phases and echoes prep marks as p_*', async () => {
+        const outcome = await runSolvePipeline(baseArgs({
+            defLoadMs: 12.3,
+            prepMarks: [
+                ['body', 0.5],
+                ['client', 3.1]
+            ],
+            client: fakeClient(async () => ({ errors: [], warnings: [] }))
+        }));
+        expect(outcome.kind).toBe('ok');
+        if (outcome.kind !== 'ok')
+            return;
+        const st = outcome.envelope.headers['Server-Timing'];
+        expect(st).toContain('load;dur=12.3');
+        expect(st).toContain('tree;dur=');
+        expect(st).toContain('solve;dur=');
+        expect(st).toContain('serialize;dur=');
+        expect(st).toContain('total;dur=');
+        expect(st).toContain('p_body;dur=0.5');
+        expect(st).toContain('p_client;dur=3.1');
+    });
+    it('splits solve into rhino_* + compute_link when the client reported server timing', async () => {
+        // The real onServerTiming callback fires DURING the solve, after the
+        // pipeline has reset the holder — so populate it inside the solve stub, not
+        // before the call (which the pipeline's pre-solve reset would wipe).
+        const client = fakeClient(async () => {
+            client.rhinoTiming.last = { decode: 5, solve: 20, encode: 3 };
+            return { errors: [], warnings: [] };
+        });
+        const outcome = await runSolvePipeline(baseArgs({ client }));
+        expect(outcome.kind).toBe('ok');
+        if (outcome.kind !== 'ok')
+            return;
+        const st = outcome.envelope.headers['Server-Timing'];
+        expect(st).toContain('rhino_decode;dur=5.0');
+        expect(st).toContain('rhino_solve;dur=20.0');
+        expect(st).toContain('rhino_encode;dur=3.0');
+        expect(st).toContain('compute_link;dur=');
+    });
+    it('surfaces selva_cache + def_reupload verdicts as 0/1 flags', async () => {
+        // Populate during the solve (the onSettle callback's real timing), not
+        // before — the pipeline resets solveMeta before it runs.
+        const client = fakeClient(async () => {
+            client.solveMeta.last = { fromCache: true, definitionReuploaded: false };
+            return { errors: [], warnings: [] };
+        });
+        const outcome = await runSolvePipeline(baseArgs({ client }));
+        expect(outcome.kind).toBe('ok');
+        if (outcome.kind !== 'ok')
+            return;
+        const st = outcome.envelope.headers['Server-Timing'];
+        expect(st).toContain('selva_cache;dur=1');
+        expect(st).toContain('def_reupload;dur=0');
+    });
+    it('resets stale telemetry holders before solving', async () => {
+        // A warm client carrying a previous request's timing must not leak it into
+        // this solve's Server-Timing when the current solve reports nothing.
+        const client = fakeClient(async () => ({ errors: [], warnings: [] }));
+        client.rhinoTiming.last = { decode: 99, solve: 99, encode: 99 };
+        client.solveMeta.last = { fromCache: true };
+        const outcome = await runSolvePipeline(baseArgs({ client }));
+        expect(outcome.kind).toBe('ok');
+        if (outcome.kind !== 'ok')
+            return;
+        // Holders were reset to null before solve; the stub never repopulated them.
+        expect(outcome.envelope.headers['Server-Timing']).not.toContain('rhino_decode');
+        expect(outcome.envelope.headers['Server-Timing']).not.toContain('selva_cache');
+    });
+});
+//# sourceMappingURL=solve-pipeline.test.js.map

package/dist/compute/__tests__/solve-pipeline.test.js.map

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

package/dist/compute/__tests__/transform-input.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tests for `transformInputParameter` — the adapter that turns a persisted `SchemaInput`
+ * (plus the user's chosen value) into the `@selvajs/compute` `InputParam` that
+ * `TreeBuilder.fromInputParams` serializes for the solve.
+ *
+ * The adapter delegates to the package's `processInput`, so these assert the
+ * package-aligned behavior: correct `paramType` for every type (not the old
+ * coerce-everything-to-Text), and `default` carrying the user's value. Where a value/
+ * default is absent, `processInput` leaves `default` undefined and `fromInputParams`
+ * omits the input entirely — letting Grasshopper use its own internal default rather
+ * than forcing `''`/`false`.
+ */
+export {};
+//# sourceMappingURL=transform-input.test.d.ts.map

package/dist/compute/__tests__/transform-input.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-input.test.d.ts","sourceRoot":"","sources":["../../../src/compute/__tests__/transform-input.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/compute/__tests__/transform-input.test.js

@@ -0,0 +1,114 @@
+/**
+ * Tests for `transformInputParameter` — the adapter that turns a persisted `SchemaInput`
+ * (plus the user's chosen value) into the `@selvajs/compute` `InputParam` that
+ * `TreeBuilder.fromInputParams` serializes for the solve.
+ *
+ * The adapter delegates to the package's `processInput`, so these assert the
+ * package-aligned behavior: correct `paramType` for every type (not the old
+ * coerce-everything-to-Text), and `default` carrying the user's value. Where a value/
+ * default is absent, `processInput` leaves `default` undefined and `fromInputParams`
+ * omits the input entirely — letting Grasshopper use its own internal default rather
+ * than forcing `''`/`false`.
+ */
+import { describe, it, expect } from 'vitest';
+import { transformInputParameter } from '../transform-input.js';
+function input(partial) {
+    return {
+        id: 'id-1',
+        nickname: 'Param',
+        paramType: 'text',
+        ...partial
+    };
+}
+describe('transformInputParameter — identity fields', () => {
+    it('carries id, name, nickname, description through', () => {
+        const out = transformInputParameter(input({ id: 'guid-x', nickname: 'Width', description: 'the width' }), 5);
+        expect(out.id).toBe('guid-x');
+        expect(out.name).toBe('Width');
+        expect(out.nickname).toBe('Width');
+        expect(out.description).toBe('the width');
+    });
+    it('defaults a blank nickname to null and an absent description to empty string', () => {
+        const out = transformInputParameter(input({ nickname: '', description: undefined }), 'v');
+        expect(out.nickname).toBeNull();
+        expect(out.description).toBe('');
+    });
+});
+describe('transformInputParameter — number / integer', () => {
+    it('maps number with the user value winning over the schema default', () => {
+        const out = transformInputParameter(input({ paramType: 'number', default: 1, minimum: 0, maximum: 10, stepSize: 0.5 }), 7);
+        expect(out).toMatchObject({ paramType: 'Number', default: 7, minimum: 0, maximum: 10 });
+    });
+    it('falls back to the schema default when no value is supplied', () => {
+        const out = transformInputParameter(input({ paramType: 'number', default: 3 }), undefined);
+        expect(out.default).toBe(3);
+    });
+    it('forces stepSize to 1 for integers', () => {
+        const out = transformInputParameter(input({ paramType: 'integer', stepSize: 0.5, default: 2 }), 4);
+        expect(out).toMatchObject({ paramType: 'Integer', stepSize: 1, default: 4 });
+    });
+});
+describe('transformInputParameter — text', () => {
+    it('maps text and keeps the user value', () => {
+        const out = transformInputParameter(input({ paramType: 'text', default: 'd' }), 'hello');
+        expect(out).toMatchObject({ paramType: 'Text', default: 'hello' });
+    });
+    it('falls back to the schema default when no value is supplied', () => {
+        expect(transformInputParameter(input({ paramType: 'text', default: 'd' }), undefined).default).toBe('d');
+    });
+    it('leaves default undefined when neither value nor schema default exist (input is then omitted)', () => {
+        // processInput does not force ''. fromInputParams filters undefined defaults, so the
+        // param is simply not sent and Grasshopper uses its own internal default.
+        expect(transformInputParameter(input({ paramType: 'text', default: undefined }), undefined).default).toBeUndefined();
+    });
+});
+describe('transformInputParameter — boolean', () => {
+    it('maps boolean and preserves an explicit false (the bug-prone case)', () => {
+        const out = transformInputParameter(input({ paramType: 'boolean', default: true }), false);
+        expect(out).toMatchObject({ paramType: 'Boolean', default: false });
+    });
+    it('falls back to the schema default when no value is supplied', () => {
+        expect(transformInputParameter(input({ paramType: 'boolean', default: true }), undefined).default).toBe(true);
+    });
+    it('leaves default undefined when neither value nor schema default exist (input is then omitted)', () => {
+        expect(transformInputParameter(input({ paramType: 'boolean', default: undefined }), undefined)
+            .default).toBeUndefined();
+    });
+});
+describe('transformInputParameter — value-list / file / color / generic', () => {
+    // The regression that motivated the swap: these used to be silently coerced to Text.
+    // processInput now types them correctly. (The options map for ValueList isn't carried
+    // on SchemaInput, so `values` is empty and the selected value rides on `default` —
+    // which is exactly the string a contextual ValueList param consumes.)
+    it('maps valueList to ValueList, carrying the selected value', () => {
+        const out = transformInputParameter(input({ paramType: 'valueList', default: '0' }), '1');
+        expect(out).toMatchObject({ paramType: 'ValueList', default: '1' });
+    });
+    // Regression: processInput has no dynamicValueList handler, so without the explicit
+    // mapping it fell to the Geometry fallback with a null default — and fromInputParams
+    // then DROPPED the input, so the user's selection never reached the definition.
+    // The plugin's GetDynamicValueListParameter reuses the ValueList wire contract
+    // (TypeName "ValueList"), so ValueList is the correct target type.
+    it('maps dynamicValueList to ValueList, carrying the selected value', () => {
+        const out = transformInputParameter(input({ paramType: 'dynamicValueList', default: '0' }), '3.5');
+        expect(out).toMatchObject({ paramType: 'ValueList', default: '3.5' });
+    });
+    it('maps dynamicValueList checklist (array value) to ValueList, carrying all selections', () => {
+        const out = transformInputParameter(input({ paramType: 'dynamicValueList' }), ['a', 'b']);
+        expect(out.paramType).toBe('ValueList');
+        expect(out.default).toEqual(['a', 'b']);
+    });
+    it('maps file to File', () => {
+        const out = transformInputParameter(input({ paramType: 'file' }), { fileName: 'a.3dm' });
+        expect(out.paramType).toBe('File');
+    });
+    it('maps color to Color, carrying the value', () => {
+        const out = transformInputParameter(input({ paramType: 'color' }), '255,0,0');
+        expect(out).toMatchObject({ paramType: 'Color', default: '255,0,0' });
+    });
+    it('maps generic to the package fallback type (Geometry), not Text', () => {
+        const out = transformInputParameter(input({ paramType: 'generic', default: 'd' }), undefined);
+        expect(out.paramType).toBe('Geometry');
+    });
+});
+//# sourceMappingURL=transform-input.test.js.map

package/dist/compute/__tests__/transform-input.test.js.map

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

package/dist/compute/client-cache.d.ts

@@ -0,0 +1,104 @@
+import { GrasshopperClient, type SolveScheduler } from '@selvajs/compute';
+/**
+ * Opaque identity of a compute server. Callers never construct the branded
+ * string directly — they pass a resolved server config to `serverIdentity()`.
+ * Keeping this opaque from day one (ADR 0004 D1) means "a server is now a pool
+ * of URLs behind one id" stays an additive, non-breaking change.
+ */
+export type ServerIdentity = string & {
+    readonly __brand: 'ServerIdentity';
+};
+/** Minimal resolved-server shape the cache needs (a subset of the app's `ComputeServerConfig`). */
+export interface ResolvedServer {
+    /** Stable identity — the cache key. */
+    id: string;
+    /** Base URL of the Rhino.Compute instance (a resolution detail of `id`). */
+    serverUrl: string;
+    /** Sent as `RhinoComputeKey`. */
+    apiKey?: string;
+}
+/** Derive the opaque cache identity from a resolved server. Identity is the `id`. */
+export declare function serverIdentity(server: Pick<ResolvedServer, 'id'>): ServerIdentity;
+/**
+ * Per-request telemetry holders read by the caller right after a solve resolves
+ * to build a Server-Timing header. Populated by the client/scheduler callbacks.
+ */
+export interface CachedClient {
+    client: GrasshopperClient;
+    scheduler: SolveScheduler;
+    /**
+     * Last decode/solve/encode reported by the compute server (Server-Timing).
+     * Written by onServerTiming, read right after scheduler.solve resolves to split
+     * the solve wall time into on-compute-server work vs. the compute↔web-server
+     * link. Queue-mode schedulers serialize solves, so this correlates with the
+     * request that just resolved; a Selva-cache hit leaves it null (no compute
+     * call). Debug aid — a concurrent burst may misattribute one request's timing.
+     */
+    rhinoTiming: {
+        last: {
+            decode: number;
+            solve: number;
+            encode: number;
+        } | null;
+    };
+    /**
+     * Last solve's cache verdicts from the scheduler's onSettle: whether the
+     * in-process response cache served it (no compute call) and whether the
+     * definition had to be re-uploaded. Same read-after-solve pattern and
+     * concurrency caveat as rhinoTiming.
+     */
+    solveMeta: {
+        last: {
+            fromCache: boolean;
+            definitionReuploaded?: boolean;
+        } | null;
+    };
+}
+/**
+ * Config injected by the consuming app. Everything that used to be read from
+ * `$env` / `computeLimits` in the app module is passed in, so this module stays
+ * env-agnostic and testable.
+ */
+export interface ClientCacheConfig {
+    /** Per-solve timeout forwarded to the scheduler (`ComputeLimits.maxSolveDurationMs`). */
+    maxSolveDurationMs: number;
+    /** Ask Rhino.Compute to cache solve results and return them on identical repeats. */
+    cachesolve: boolean;
+    /** Also cache solves that reported GH errors (only meaningful with `cachesolve`). */
+    cacheerroredsolves: boolean;
+    /** Reference large definitions by server cache key (pointer) instead of re-uploading. */
+    reuseServerDefinitionCache: boolean;
+    /** Concise cache/timing logs. When false, `onDebugLog` is never invoked. */
+    debug: boolean;
+    /** VERBOSE lib-level logging (full solve request/response incl. geometry). */
+    debugVerbose: boolean;
+    /** Max distinct warm clients before the LRU evicts the oldest. Default 16. */
+    maxCachedClients?: number;
+    /** Sink for the concise debug lines (the app wires `console.log`). */
+    onDebugLog?: (message: string) => void;
+}
+export interface ClientCache {
+    /**
+     * Get (or create) the warm client + scheduler for a resolved compute server,
+     * keyed by its `id`. `definitionGuid`, when present, is stamped as the
+     * `X-Selva-Definition` header on this client's outbound solve/IO requests —
+     * inert routing/telemetry metadata until a pool router exists (ADR 0004 D2).
+     */
+    getClient(server: ResolvedServer, opts?: {
+        definitionGuid?: string;
+    }): Promise<CachedClient>;
+    /**
+     * Dispose and drop the warm client for `id` (or a `ServerIdentity`). Called by
+     * the config-write path when a server's URL/key rotates so the next request
+     * rebuilds against fresh connection details (ADR 0004 Consequences).
+     */
+    evict(id: string | ServerIdentity): void;
+    /** Dispose every warm client. Test seam / shutdown hook. */
+    disposeAll(): void;
+}
+/**
+ * Build a per-server warm-client cache. Each cache owns its own LRU `Map` keyed
+ * on server `id`.
+ */
+export declare function createClientCache(config: ClientCacheConfig): ClientCache;
+//# sourceMappingURL=client-cache.d.ts.map

package/dist/compute/client-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-cache.d.ts","sourceRoot":"","sources":["../../src/compute/client-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EAGjB,KAAK,cAAc,EACnB,MAAM,kBAAkB,CAAC;AAyB1B;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE7E,mGAAmG;AACnG,MAAM,WAAW,cAAc;IAC9B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,cAAc,CAEjF;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,cAAc,CAAC;IAC1B;;;;;;;OAOG;IACH,WAAW,EAAE;QAAE,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,CAAC;IAChF;;;;;OAKG;IACH,SAAS,EAAE;QAAE,IAAI,EAAE;YAAE,SAAS,EAAE,OAAO,CAAC;YAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,CAAC;CACnF;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC,yFAAyF;IACzF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qFAAqF;IACrF,UAAU,EAAE,OAAO,CAAC;IACpB,qFAAqF;IACrF,kBAAkB,EAAE,OAAO,CAAC;IAC5B,yFAAyF;IACzF,0BAA0B,EAAE,OAAO,CAAC;IACpC,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAC;IACf,8EAA8E;IAC9E,YAAY,EAAE,OAAO,CAAC;IACtB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC3B;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7F;;;;OAIG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IACzC,4DAA4D;IAC5D,UAAU,IAAI,IAAI,CAAC;CACnB;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAuJxE"}