@clowder-ai/plugin-contract 0.1.0-beta.2 → 0.1.0-beta.21

package/dist/validation/signals.js

@@ -0,0 +1,206 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const Ajv2020 = require('ajv/dist/2020');
+const addFormats = require('ajv-formats');
+const signalSchema = require('@clowder-ai/plugin-contract/schemas/signals');
+export const SIGNAL_PAYLOAD_MAX_ENCODED_BYTES = 65_536;
+const ajv = new Ajv2020({ allErrors: true, strict: false });
+addFormats(ajv);
+ajv.addSchema(signalSchema, signalSchema['$id']);
+function validator(definition) {
+    const validate = ajv.getSchema(`${String(signalSchema['$id'])}#/$defs/${definition}`);
+    if (!validate)
+        throw new Error(`missing signal schema definition: ${definition}`);
+    return validate;
+}
+const validateDeclarationSchema = validator('SignalDeclaration');
+const validatePublishInputSchema = validator('EventsPublishInput');
+const validatePublishResultSchema = validator('EventsPublishResult');
+const resolvedSchemaValidators = new WeakMap();
+function errorsOf(validate) {
+    return (validate.errors ?? []).map((error) => ({
+        instancePath: error.instancePath,
+        schemaPath: error.schemaPath,
+        keyword: error.keyword,
+        message: error.message ?? 'signal validation failed',
+    }));
+}
+function validateWith(validate, value) {
+    if (!validate(value))
+        return { valid: false, errors: errorsOf(validate) };
+    return { valid: true, value: value, errors: [] };
+}
+function isJsonValue(value, ancestors = new Set()) {
+    if (value === null ||
+        typeof value === 'string' ||
+        typeof value === 'boolean') {
+        return true;
+    }
+    if (typeof value === 'number')
+        return Number.isFinite(value);
+    if (typeof value !== 'object')
+        return false;
+    if (ancestors.has(value))
+        return false;
+    ancestors.add(value);
+    const valid = Array.isArray(value)
+        ? value.every((item) => isJsonValue(item, ancestors))
+        : Object.values(value).every((item) => isJsonValue(item, ancestors));
+    ancestors.delete(value);
+    return valid;
+}
+export function validateSignalDeclaration(value) {
+    return validateWith(validateDeclarationSchema, value);
+}
+export function validateEventsPublishInput(value) {
+    const structural = validateWith(validatePublishInputSchema, value);
+    if (!structural.valid)
+        return structural;
+    let validJsonValue = false;
+    try {
+        validJsonValue = isJsonValue(structural.value.payload);
+    }
+    catch {
+        validJsonValue = false;
+    }
+    if (!validJsonValue) {
+        return {
+            valid: false,
+            errors: [
+                {
+                    instancePath: '/payload',
+                    schemaPath: '#/$defs/EventsPublishInput/properties/payload',
+                    keyword: 'jsonValue',
+                    message: 'payload must contain only finite JSON values without cycles',
+                },
+            ],
+        };
+    }
+    let encodedPayloadBytes;
+    try {
+        encodedPayloadBytes = Buffer.byteLength(JSON.stringify(structural.value.payload), 'utf8');
+    }
+    catch {
+        return {
+            valid: false,
+            errors: [
+                {
+                    instancePath: '/payload',
+                    schemaPath: '#/$defs/EventsPublishInput/properties/payload',
+                    keyword: 'jsonValue',
+                    message: 'payload could not be safely serialized as JSON',
+                },
+            ],
+        };
+    }
+    if (encodedPayloadBytes > SIGNAL_PAYLOAD_MAX_ENCODED_BYTES) {
+        return {
+            valid: false,
+            errors: [
+                {
+                    instancePath: '/payload',
+                    schemaPath: '#/x-clowder-payload-max-encoded-bytes',
+                    keyword: 'maxEncodedBytes',
+                    message: `payload exceeds ${SIGNAL_PAYLOAD_MAX_ENCODED_BYTES} encoded bytes`,
+                },
+            ],
+        };
+    }
+    return structural;
+}
+/**
+ * Cross-document admission: a structurally legal publish is still forbidden
+ * unless its signalType appears in this plugin manifest's declared provides.
+ */
+export function validateDeclaredEventsPublishInput(declarations, signalSchemas, value) {
+    const input = validateEventsPublishInput(value);
+    if (!input.valid)
+        return input;
+    let matchingDeclaration;
+    for (const candidate of declarations) {
+        const declaration = validateSignalDeclaration(candidate);
+        if (!declaration.valid) {
+            return {
+                valid: false,
+                errors: [
+                    {
+                        instancePath: '/signals/provides',
+                        schemaPath: '#/$defs/SignalContribution/properties/provides',
+                        keyword: 'signalDeclaration',
+                        message: 'declared signal metadata is invalid',
+                    },
+                ],
+            };
+        }
+        if (declaration.value.type === input.value.signalType) {
+            matchingDeclaration = declaration.value;
+        }
+    }
+    if (matchingDeclaration === undefined) {
+        return {
+            valid: false,
+            errors: [
+                {
+                    instancePath: '/signalType',
+                    schemaPath: '#/$defs/SignalContribution/properties/provides',
+                    keyword: 'declaredSignalType',
+                    message: 'signalType is not declared by the plugin manifest',
+                },
+            ],
+        };
+    }
+    const resolvedSchema = signalSchemas[matchingDeclaration.schemaRef];
+    if (typeof resolvedSchema !== 'object' ||
+        resolvedSchema === null ||
+        Array.isArray(resolvedSchema)) {
+        return {
+            valid: false,
+            errors: [
+                {
+                    instancePath: '/signalType',
+                    schemaPath: matchingDeclaration.schemaRef,
+                    keyword: 'signalSchemaUnresolved',
+                    message: 'declared signal schema is not resolved from the installed package',
+                },
+            ],
+        };
+    }
+    let validateResolved = resolvedSchemaValidators.get(resolvedSchema);
+    if (validateResolved === undefined) {
+        try {
+            const schemaAjv = new Ajv2020({ allErrors: true, strict: false });
+            addFormats(schemaAjv);
+            validateResolved = schemaAjv.compile(resolvedSchema);
+            resolvedSchemaValidators.set(resolvedSchema, validateResolved);
+        }
+        catch {
+            resolvedSchemaValidators.set(resolvedSchema, null);
+            validateResolved = null;
+        }
+    }
+    if (validateResolved === null) {
+        return {
+            valid: false,
+            errors: [
+                {
+                    instancePath: '/signalType',
+                    schemaPath: matchingDeclaration.schemaRef,
+                    keyword: 'signalSchemaInvalid',
+                    message: 'declared signal schema could not be compiled safely',
+                },
+            ],
+        };
+    }
+    const content = {
+        payload: input.value.payload,
+        source: input.value.source,
+    };
+    if (!validateResolved(content)) {
+        return { valid: false, errors: errorsOf(validateResolved) };
+    }
+    return input;
+}
+export function validateEventsPublishResult(value) {
+    return validateWith(validatePublishResultSchema, value);
+}
+//# sourceMappingURL=signals.js.map

package/dist/validation/signals.js.map

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

package/dist/wire/constants.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Wire-protocol framing constants.
+ * Every value is mechanized verbatim from the #1165 frozen shape (rev11).
+ * This module defines nothing new.
+ */
+/** Maximum raw UTF-8 bytes per frame, excluding the LF terminator. */
+export declare const MAX_FRAME_BYTES: 1048576;
+/** The v0 wire protocol version. */
+export declare const WIRE_VERSION: "0.1.0";
+/** The contract version this wire shape mechanizes. */
+export declare const CONTRACT_VERSION: "0.1.0";
+/** JSON-RPC version constant (exact string). */
+export declare const JSONRPC_VERSION: "2.0";
+/**
+ * Maximum payload bytes per element payload (frozen x-clowder-bounds).
+ * Open-membered payloads (MediaRefElementPayload, RichBlockElementPayload)
+ * are bounded by this ceiling alone — no structural narrowing.
+ */
+export declare const MAX_ELEMENT_PAYLOAD_BYTES: 65536;
+/**
+ * Maximum total payload bytes per message (frozen x-clowder-bounds).
+ */
+export declare const MAX_TOTAL_PAYLOAD_BYTES: 262144;
+/**
+ * Maximum elements per draft operation (frozen).
+ */
+export declare const MAX_ELEMENTS_PER_OPERATION: 32;
+/**
+ * Maximum elements per message envelope (frozen).
+ */
+export declare const MAX_ELEMENTS_PER_MESSAGE: 128;
+/**
+ * Maximum whisper targets (frozen).
+ */
+export declare const MAX_WHISPER_TARGETS: 16;
+//# sourceMappingURL=constants.d.ts.map

package/dist/wire/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/wire/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sEAAsE;AACtE,eAAO,MAAM,eAAe,EAAG,OAAkB,CAAC;AAElD,oCAAoC;AACpC,eAAO,MAAM,YAAY,EAAG,OAAgB,CAAC;AAE7C,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,EAAG,OAAgB,CAAC;AAEjD,gDAAgD;AAChD,eAAO,MAAM,eAAe,EAAG,KAAc,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAG,KAAe,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAG,MAAgB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAG,EAAW,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAG,GAAY,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAG,EAAW,CAAC"}

package/dist/wire/constants.js

@@ -0,0 +1,36 @@
+/**
+ * Wire-protocol framing constants.
+ * Every value is mechanized verbatim from the #1165 frozen shape (rev11).
+ * This module defines nothing new.
+ */
+/** Maximum raw UTF-8 bytes per frame, excluding the LF terminator. */
+export const MAX_FRAME_BYTES = 1_048_576;
+/** The v0 wire protocol version. */
+export const WIRE_VERSION = '0.1.0';
+/** The contract version this wire shape mechanizes. */
+export const CONTRACT_VERSION = '0.1.0';
+/** JSON-RPC version constant (exact string). */
+export const JSONRPC_VERSION = '2.0';
+/**
+ * Maximum payload bytes per element payload (frozen x-clowder-bounds).
+ * Open-membered payloads (MediaRefElementPayload, RichBlockElementPayload)
+ * are bounded by this ceiling alone — no structural narrowing.
+ */
+export const MAX_ELEMENT_PAYLOAD_BYTES = 65_536;
+/**
+ * Maximum total payload bytes per message (frozen x-clowder-bounds).
+ */
+export const MAX_TOTAL_PAYLOAD_BYTES = 262_144;
+/**
+ * Maximum elements per draft operation (frozen).
+ */
+export const MAX_ELEMENTS_PER_OPERATION = 32;
+/**
+ * Maximum elements per message envelope (frozen).
+ */
+export const MAX_ELEMENTS_PER_MESSAGE = 128;
+/**
+ * Maximum whisper targets (frozen).
+ */
+export const MAX_WHISPER_TARGETS = 16;
+//# sourceMappingURL=constants.js.map

package/dist/wire/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/wire/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG,SAAkB,CAAC;AAElD,oCAAoC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,OAAgB,CAAC;AAE7C,uDAAuD;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAgB,CAAC;AAEjD,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,KAAc,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAe,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAgB,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAW,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAY,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAW,CAAC"}

package/dist/wire/disposition-fixtures.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Disposition conformance fixture vectors — machine-readable test data
+ * for the pre-dispatch disposition table (T-A through T-M).
+ *
+ * Mechanized VERBATIM from §3.8-1 of the #1165 frozen plan (rev11,
+ * SHA 7e26e5af). Each vector carries:
+ *   - A raw frame (the input to a pre-dispatch classifier)
+ *   - Machine-readable pre-state with correlation records + cross-frame oracle
+ *   - The expected unique T-class assignment
+ *   - For respond classes: a type-checked closed-arm error envelope
+ *   - For close/accept classes: null response markers
+ *
+ * These are DATA — they do not classify. A future classifier
+ * implementation would be tested against these vectors.
+ *
+ * Coverage per §3.8-1 (frozen enumerations, not arbitrary counts):
+ *   - 9 response-candidate sub-cases (RESPONSE_CANDIDATE_CASES)
+ *     "your R9 correction #5's five required cases plus four controls"
+ *   - 7 notification-partition sub-cases (NOTIFICATION_PARTITION_CASES)
+ *     "your correction #4's five, the idless-envelope fixture,
+ *      and the R8 row-10 value-failure fixture"
+ *   - All 13 T-classes have ≥1 vector
+ *   - Pre-state mutual-exclusivity proof pairs:
+ *       ping nonce (T-H-3 / T-L-2), row-9 deliveryId (T-H-9 / T-L-4)
+ *
+ * Response frames are DERIVED from type-checked ClosedWireErrorResponse
+ * objects, not hand-written strings.
+ *
+ * Partition records carry {vectorId, expectedClass} per case (FC-70-4).
+ * Tests verify both existence AND class correctness per key.
+ */
+import type { DispositionClass, DispositionOutcome } from './disposition.js';
+import type { CandidateHello } from './handshake.js';
+import type { WireMethodName } from './registry.js';
+export declare const CLOSED_ERROR_ARM_NAMES: readonly ["ParseErrorEnvelope", "InvalidRequestNullIdEnvelope", "InvalidRequestValidIdEnvelope", "MethodNotFoundEnvelope", "InvalidParamsEnvelope", "InternalErrorEnvelope", "HandshakeRejectedEnvelope", "DeliveryRejectedEnvelope", "DomainErrorEnvelope", "DeadlineExpiredEnvelope", "SnapshotUnavailableEnvelope"];
+export type ClosedErrorArmName = (typeof CLOSED_ERROR_ARM_NAMES)[number];
+/**
+ * Original request fields needed for cross-frame semantic oracle validation.
+ * Optional: only populated for rows that have cross-frame invariants.
+ */
+export interface RequestSnapshot {
+    /** Row 11 ping: the nonce that must be echoed byte-equal in the result. */
+    readonly nonce?: string;
+    /** Row 9 deliver: the deliveryId that must match byte-equal in the ack. */
+    readonly deliveryId?: string;
+    /** Row 6 read: the validated request limit that bounds result.events. */
+    readonly readLimit?: number;
+    /** Row 8 snapshot: the validated request maxItems that bounds result.items. */
+    readonly snapshotMaxItems?: number;
+    /** Row 1 hello: the candidate claims that SessionBinding must echo byte-equal. */
+    readonly candidateHello?: CandidateHello;
+    /** Row 4 append: the input element IDs for cross-frame provenance. */
+    readonly appendElementIds?: readonly string[];
+}
+/**
+ * A single in-flight request record for pre-state correlation.
+ * The method field is a closed WireMethodName, not a bare string —
+ * the compiler catches typos and detects registry drift.
+ */
+export interface InFlightRecord {
+    readonly id: string;
+    readonly method: WireMethodName;
+    /** Original request fields for cross-frame semantic oracle. */
+    readonly requestSnapshot?: RequestSnapshot;
+}
+/**
+ * Machine-readable pre-state for state-dependent classification.
+ * Without this, T-H vs T-L cannot be distinguished from rawFrame alone.
+ */
+export interface FixturePreState {
+    readonly inFlightRequests: readonly InFlightRecord[];
+}
+export interface DispositionFixtureVector {
+    readonly id: string;
+    readonly rawFrame: string;
+    readonly rawFrameEncoding: 'utf8' | 'hex';
+    readonly preState: FixturePreState;
+    readonly expectedClass: DispositionClass;
+    readonly expectedOutcome: DispositionOutcome;
+    readonly expectedErrorArm: ClosedErrorArmName | null;
+    readonly expectedErrorCode: number | null;
+    readonly expectedResponseFrame: string | null;
+    /** This vector must not allocate state, enqueue work, or activate. */
+    readonly zeroSideEffects?: true;
+    readonly description: string;
+}
+/**
+ * A single named case from the frozen plan's partition enumeration.
+ */
+export interface PartitionCase {
+    readonly vectorId: string;
+    readonly expectedClass: DispositionClass;
+}
+/**
+ * 9 response-candidate sub-cases per §3.8-1:
+ * "your R9 correction #5's five required cases plus four controls"
+ *
+ * A "response candidate" enters the response lane: no method + at least
+ * one of result/error. Controls prove the boundary: frames with method
+ * that exit to T-F/T-K/T-D despite carrying result/error.
+ */
+export declare const RESPONSE_CANDIDATE_CASES: Readonly<Record<string, PartitionCase>>;
+/**
+ * 7 notification-partition sub-cases per §3.8-1:
+ * "your correction #4's five, the idless-envelope fixture,
+ *  and the R8 row-10 value-failure fixture"
+ */
+export declare const NOTIFICATION_PARTITION_CASES: Readonly<Record<string, PartitionCase>>;
+export declare const DISPOSITION_FIXTURE_VECTORS: readonly DispositionFixtureVector[];
+/** Complete beta.8 handshake safety surface exported for downstream runners. */
+export declare const BETA8_HANDSHAKE_VECTOR_IDS: readonly ["T-C-2", "T-M-1", "T-M-2", "T-M-3", "T-M-4", "T-M-5", "T-M-6", "T-M-7", "T-M-8", "T-G-2", "T-G-3", "T-G-4", "T-G-5", "T-G-6", "T-G-7", "T-G-8", "T-G-9", "T-G-10", "T-G-11", "T-G-12", "T-G-13", "T-G-14", "T-H-10", "T-H-11", "T-L-5", "T-L-6"];
+/** Complete beta.9 C-2 publish safety surface exported for downstream runners. */
+export declare const BETA9_EVENTS_PUBLISH_VECTOR_IDS: readonly ["T-M-9", "T-G-15", "T-H-12", "T-L-7"];
+/** Complete beta.10 M0-B lifecycle safety surface for rows 10 through 12. */
+export declare const BETA10_LIFECYCLE_VECTOR_IDS: readonly ["T-G-1", "T-J-1", "T-J-2", "T-K-1", "T-K-4", "T-K-5", "T-K-6", "T-K-7", "T-H-3", "T-L-1", "T-L-2", "T-L-3", "T-J-3", "T-K-8", "T-K-9", "T-K-10", "T-M-10", "T-G-16", "T-M-11", "T-G-17", "T-M-12", "T-G-18", "T-L-8", "T-H-13", "T-M-13", "T-G-19", "T-G-20", "T-L-9", "T-L-10"];
+/** Complete beta.11 M0-C messaging safety surface for rows 3 through 9. */
+export declare const BETA11_MESSAGING_VECTOR_IDS: readonly ["T-C-3", "T-H-2", "T-H-5", "T-H-9", "T-L-4", "T-M-14", "T-G-21", "T-M-15", "T-G-22", "T-M-16", "T-G-23", "T-M-17", "T-G-24", "T-M-18", "T-G-25", "T-M-19", "T-G-26", "T-M-20", "T-M-21", "T-G-27", "T-C-4", "T-C-5", "T-C-6", "T-L-11", "T-H-14", "T-L-12", "T-H-15", "T-L-13", "T-H-16", "T-L-14", "T-H-17", "T-L-15", "T-H-18", "T-L-16", "T-H-19", "T-L-17", "T-H-20", "T-H-21", "T-H-22"];
+//# sourceMappingURL=disposition-fixtures.d.ts.map

package/dist/wire/disposition-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposition-fixtures.d.ts","sourceRoot":"","sources":["../../src/wire/disposition-fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAQ7E,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,gBAAgB,CAAC;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAuBpD,eAAO,MAAM,sBAAsB,wTAYzB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAkNzE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,kFAAkF;IAClF,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,sEAAsE;IACtE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,cAAc,EAAE,CAAC;CACtD;AAMD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,KAAK,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,sEAAsE;IACtE,QAAQ,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAUD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAmB5E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAehF,CAAC;AAMF,eAAO,MAAM,2BAA2B,EAAE,SAAS,wBAAwB,EAykD1E,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,4PAO7B,CAAC;AAEX,kFAAkF;AAClF,eAAO,MAAM,+BAA+B,iDAKlC,CAAC;AAEX,6EAA6E;AAC7E,eAAO,MAAM,2BAA2B,4RA8B9B,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,yYAU9B,CAAC"}