swagger-parser-mcp-server 2.0.4 → 2.3.0

package/dist/application/snapshot/snapshotCaptureService.js

@@ -0,0 +1,394 @@
+import { createHash } from 'node:crypto';
+import { analyzeCanonicalChange, createCanonicalSnapshot, } from '../../domain/canonical/canonicalSnapshot.js';
+import { classifyEndpointDiffs } from '../../domain/diff/endpointDiffClassifier.js';
+import { validateEnvironment } from '../../domain/contracts/runtimeEnvironmentContract.js';
+import { snapshotDiffResultSchema } from '../../domain/contracts/snapshotDiffContract.js';
+function toStableJson(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map(item => toStableJson(item)).join(',')}]`;
+    }
+    if (value !== null && typeof value === 'object') {
+        const entries = Object.entries(value).sort(([left], [right]) => left.localeCompare(right));
+        return `{${entries.map(([key, child]) => `${JSON.stringify(key)}:${toStableJson(child)}`).join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+export function createSpecHash(document) {
+    return createHash('sha256').update(toStableJson(document)).digest('hex');
+}
+function buildWarnings(analysis, targetSnapshot) {
+    const warnings = [];
+    if (analysis.isVersionOnlyChange) {
+        warnings.push({
+            code: 'VERSION_ONLY_CHANGE',
+            message: 'Only version signal changed while structural fingerprint stayed the same.',
+        });
+    }
+    if (analysis.hasVersionMismatch) {
+        const infoVersion = targetSnapshot.versionSignal.infoVersion ?? 'unknown';
+        const hints = targetSnapshot.versionSignal.urlVersionHints.join(', ');
+        warnings.push({
+            code: 'VERSION_MISMATCH',
+            message: `info.version (${infoVersion}) does not match URL version hints (${hints || 'none'}).`,
+        });
+    }
+    return warnings;
+}
+function zeroCounts() {
+    return {
+        total: 0,
+        breaking: 0,
+        nonBreaking: 0,
+        info: 0,
+    };
+}
+function normalizeEnvironment(env) {
+    return validateEnvironment(env);
+}
+function createEmptyDiffResult(params) {
+    return snapshotDiffResultSchema.parse({
+        summary: {
+            projectKey: params.projectKey,
+            sourceUrl: params.sourceUrl,
+            baselineSnapshotId: params.baselineSnapshotId,
+            targetSnapshotId: params.targetSnapshotId,
+            comparedAt: params.comparedAt.toISOString(),
+            hasChanges: false,
+            isNoopCapture: params.isNoopCapture,
+        },
+        counts: zeroCounts(),
+        changes: [],
+        warnings: params.warnings,
+    });
+}
+function createDiffResult(params) {
+    const precomputed = precomputeDiffPayload(params.baselineSnapshot, params.targetSnapshot);
+    return createDiffResultFromPrecomputed({
+        projectKey: params.projectKey,
+        sourceUrl: params.sourceUrl,
+        baselineSnapshotId: params.baselineSnapshotId,
+        targetSnapshotId: params.targetSnapshotId,
+        comparedAt: params.comparedAt,
+        isNoopCapture: params.isNoopCapture,
+        precomputed,
+    });
+}
+function precomputeDiffPayload(baselineSnapshot, targetSnapshot) {
+    const analysis = analyzeCanonicalChange(baselineSnapshot, targetSnapshot);
+    if (!analysis.hasStructuralChanges) {
+        return {
+            counts: zeroCounts(),
+            changes: [],
+            warnings: buildWarnings(analysis, targetSnapshot),
+        };
+    }
+    const classified = classifyEndpointDiffs(baselineSnapshot, targetSnapshot);
+    const changes = classified.changes.map(change => ({
+        url: change.url,
+        method: change.method,
+        classification: change.classification,
+        changeReason: change.changeReason,
+    }));
+    return {
+        counts: classified.counts,
+        changes,
+        warnings: buildWarnings(analysis, targetSnapshot),
+    };
+}
+function createDiffResultFromPrecomputed(params) {
+    if (params.precomputed.changes.length === 0) {
+        return createEmptyDiffResult({
+            projectKey: params.projectKey,
+            sourceUrl: params.sourceUrl,
+            baselineSnapshotId: params.baselineSnapshotId,
+            targetSnapshotId: params.targetSnapshotId,
+            comparedAt: params.comparedAt,
+            isNoopCapture: params.isNoopCapture,
+            warnings: params.precomputed.warnings,
+        });
+    }
+    return snapshotDiffResultSchema.parse({
+        summary: {
+            projectKey: params.projectKey,
+            sourceUrl: params.sourceUrl,
+            baselineSnapshotId: params.baselineSnapshotId,
+            targetSnapshotId: params.targetSnapshotId,
+            comparedAt: params.comparedAt.toISOString(),
+            hasChanges: params.precomputed.counts.total > 0,
+            isNoopCapture: params.isNoopCapture,
+        },
+        counts: params.precomputed.counts,
+        changes: params.precomputed.changes,
+        warnings: params.precomputed.warnings,
+    });
+}
+function toSelfAnalysis(snapshot) {
+    return analyzeCanonicalChange(snapshot, snapshot);
+}
+function createTransitionPayload(previousSnapshot, targetSnapshot) {
+    const precomputed = precomputeDiffPayload(previousSnapshot.canonicalSnapshot, targetSnapshot);
+    return {
+        baselineSnapshotId: previousSnapshot.id,
+        counts: precomputed.counts,
+        warnings: precomputed.warnings,
+        events: precomputed.changes.map(change => ({
+            path: change.url,
+            method: change.method,
+            classification: change.classification,
+            changeReason: change.changeReason,
+        })),
+    };
+}
+function normalizeHistoryFilter(input) {
+    const hasPath = typeof input.path === 'string' && input.path.trim().length > 0;
+    const hasMethod = typeof input.method === 'string' && input.method.trim().length > 0;
+    if (hasPath !== hasMethod) {
+        throw new Error('path and method must be provided together.');
+    }
+    if (!hasPath || !hasMethod) {
+        return {
+            sourceId: input.sourceId,
+            limit: input.limit,
+        };
+    }
+    return {
+        sourceId: input.sourceId,
+        limit: input.limit,
+        path: input.path.trim(),
+        method: input.method.toLowerCase(),
+    };
+}
+function toEndpointHistoryEvent(record) {
+    return {
+        baselineSnapshotId: record.baselineSnapshotId,
+        targetSnapshotId: record.targetSnapshotId,
+        path: record.path,
+        method: record.method,
+        classification: record.classification,
+        changeReason: record.changeReason,
+        changedAt: record.changedAt,
+    };
+}
+export class SnapshotCaptureService {
+    repository;
+    loader;
+    now;
+    initializePromise = null;
+    constructor(repository, loader, now = () => new Date()) {
+        this.repository = repository;
+        this.loader = loader;
+        this.now = now;
+    }
+    async initialize() {
+        if (!this.initializePromise) {
+            this.initializePromise = this.repository.initializeSchema().catch(error => {
+                this.initializePromise = null;
+                throw error;
+            });
+        }
+        await this.initializePromise;
+    }
+    async resolveBootstrapContext(env) {
+        const normalized = normalizeEnvironment(env);
+        const project = await this.repository.ensureProject(normalized.PROJECT_KEY);
+        const source = await this.repository.ensureSource(project.id, normalized.SWAGGER_URL);
+        return {
+            environment: normalized,
+            project,
+            source,
+        };
+    }
+    async bootstrap(env) {
+        await this.initialize();
+        return this.resolveBootstrapContext(env);
+    }
+    async capture(env) {
+        await this.initialize();
+        const bootstrap = await this.resolveBootstrapContext(env);
+        const fetchedDocument = await this.loader.loadFresh(bootstrap.environment.SWAGGER_URL);
+        const canonicalSnapshot = createCanonicalSnapshot({
+            document: fetchedDocument,
+            sourceUrl: bootstrap.environment.SWAGGER_URL,
+        });
+        const specHash = createSpecHash(fetchedDocument);
+        const previousSnapshot = await this.repository.getLatestSnapshot(bootstrap.source.id);
+        const comparedAt = this.now();
+        if (previousSnapshot && previousSnapshot.specHash === specHash) {
+            const warnings = buildWarnings(toSelfAnalysis(previousSnapshot.canonicalSnapshot), previousSnapshot.canonicalSnapshot);
+            const diffResult = createEmptyDiffResult({
+                projectKey: bootstrap.project.projectKey,
+                sourceUrl: bootstrap.source.swaggerUrl,
+                baselineSnapshotId: previousSnapshot.id,
+                targetSnapshotId: previousSnapshot.id,
+                comparedAt,
+                isNoopCapture: true,
+                warnings,
+            });
+            return {
+                ...bootstrap,
+                specHash,
+                snapshot: previousSnapshot,
+                previousSnapshot,
+                isNoopCapture: true,
+                diffResult,
+            };
+        }
+        const transition = previousSnapshot ? createTransitionPayload(previousSnapshot, canonicalSnapshot) : undefined;
+        const saveResult = await this.repository.saveSnapshot({
+            sourceId: bootstrap.source.id,
+            specHash,
+            documentFingerprint: canonicalSnapshot.documentFingerprint,
+            canonicalSnapshot,
+            transition,
+        });
+        const savedSnapshot = saveResult.snapshot;
+        if (!saveResult.created) {
+            const warnings = buildWarnings(toSelfAnalysis(savedSnapshot.canonicalSnapshot), savedSnapshot.canonicalSnapshot);
+            const diffResult = createEmptyDiffResult({
+                projectKey: bootstrap.project.projectKey,
+                sourceUrl: bootstrap.source.swaggerUrl,
+                baselineSnapshotId: savedSnapshot.id,
+                targetSnapshotId: savedSnapshot.id,
+                comparedAt,
+                isNoopCapture: true,
+                warnings,
+            });
+            return {
+                ...bootstrap,
+                specHash,
+                snapshot: savedSnapshot,
+                previousSnapshot,
+                isNoopCapture: true,
+                diffResult,
+            };
+        }
+        if (!previousSnapshot) {
+            const warnings = buildWarnings(toSelfAnalysis(savedSnapshot.canonicalSnapshot), savedSnapshot.canonicalSnapshot);
+            const diffResult = createEmptyDiffResult({
+                projectKey: bootstrap.project.projectKey,
+                sourceUrl: bootstrap.source.swaggerUrl,
+                baselineSnapshotId: savedSnapshot.id,
+                targetSnapshotId: savedSnapshot.id,
+                comparedAt,
+                isNoopCapture: false,
+                warnings,
+            });
+            return {
+                ...bootstrap,
+                specHash,
+                snapshot: savedSnapshot,
+                previousSnapshot: null,
+                isNoopCapture: false,
+                diffResult,
+            };
+        }
+        const precomputed = precomputeDiffPayload(previousSnapshot.canonicalSnapshot, canonicalSnapshot);
+        const diffResult = createDiffResultFromPrecomputed({
+            projectKey: bootstrap.project.projectKey,
+            sourceUrl: bootstrap.source.swaggerUrl,
+            baselineSnapshotId: previousSnapshot.id,
+            targetSnapshotId: savedSnapshot.id,
+            comparedAt,
+            isNoopCapture: false,
+            precomputed,
+        });
+        return {
+            ...bootstrap,
+            specHash,
+            snapshot: savedSnapshot,
+            previousSnapshot,
+            isNoopCapture: false,
+            diffResult,
+        };
+    }
+    async listSnapshotsBySource(sourceId, limit = 50) {
+        await this.initialize();
+        const snapshots = await this.repository.listSnapshotsBySource(sourceId, limit);
+        return snapshots.map(snapshot => ({
+            id: snapshot.id,
+            sourceId: snapshot.sourceId,
+            specHash: snapshot.specHash,
+            documentFingerprint: snapshot.documentFingerprint,
+            capturedAt: snapshot.capturedAt,
+        }));
+    }
+    async listEndpointChangeHistory(input) {
+        await this.initialize();
+        const normalized = normalizeHistoryFilter(input);
+        const records = await this.repository.listEndpointChangeHistory(normalized);
+        return records.map(toEndpointHistoryEvent);
+    }
+    async resolveReplaySnapshots(input) {
+        const baselineSnapshot = await this.repository.getSnapshotById(input.baselineSnapshotId);
+        if (!baselineSnapshot) {
+            throw new Error(`Baseline snapshot not found: ${input.baselineSnapshotId}`);
+        }
+        const targetSnapshot = await this.repository.getSnapshotById(input.targetSnapshotId);
+        if (!targetSnapshot) {
+            throw new Error(`Target snapshot not found: ${input.targetSnapshotId}`);
+        }
+        if (baselineSnapshot.sourceId !== targetSnapshot.sourceId) {
+            throw new Error('Cannot replay diff across different sources.');
+        }
+        return {
+            baselineSnapshot,
+            targetSnapshot,
+        };
+    }
+    async replayDiff(input) {
+        const replaySnapshots = await this.resolveReplaySnapshots(input);
+        const sourceIdentity = await this.repository.getSourceIdentityById(replaySnapshots.baselineSnapshot.sourceId);
+        if (!sourceIdentity) {
+            throw new Error(`Source identity not found for snapshot source: ${replaySnapshots.baselineSnapshot.sourceId}`);
+        }
+        return createDiffResult({
+            projectKey: sourceIdentity.projectKey,
+            sourceUrl: sourceIdentity.swaggerUrl,
+            baselineSnapshotId: replaySnapshots.baselineSnapshot.id,
+            targetSnapshotId: replaySnapshots.targetSnapshot.id,
+            baselineSnapshot: replaySnapshots.baselineSnapshot.canonicalSnapshot,
+            targetSnapshot: replaySnapshots.targetSnapshot.canonicalSnapshot,
+            comparedAt: this.now(),
+            isNoopCapture: false,
+        });
+    }
+    async getEndpointDiffDetail(input) {
+        await this.initialize();
+        const replaySnapshots = await this.resolveReplaySnapshots(input);
+        const targetMethod = input.method.toLowerCase();
+        const classified = classifyEndpointDiffs(replaySnapshots.baselineSnapshot.canonicalSnapshot, replaySnapshots.targetSnapshot.canonicalSnapshot);
+        const matchedChange = classified.changes.find(change => change.url === input.path && change.method === targetMethod);
+        if (matchedChange) {
+            return {
+                baselineSnapshotId: replaySnapshots.baselineSnapshot.id,
+                targetSnapshotId: replaySnapshots.targetSnapshot.id,
+                path: input.path,
+                method: targetMethod,
+                hasChange: true,
+                classification: matchedChange.classification,
+                changeReason: matchedChange.changeReason,
+                details: matchedChange.details,
+                before: matchedChange.before,
+                after: matchedChange.after,
+            };
+        }
+        const beforeEndpoint = replaySnapshots.baselineSnapshot.canonicalSnapshot.endpoints.find(endpoint => endpoint.path === input.path && endpoint.method === targetMethod);
+        const afterEndpoint = replaySnapshots.targetSnapshot.canonicalSnapshot.endpoints.find(endpoint => endpoint.path === input.path && endpoint.method === targetMethod);
+        if (!beforeEndpoint && !afterEndpoint) {
+            throw new Error(`Endpoint not found for ${targetMethod.toUpperCase()} ${input.path} in requested snapshots.`);
+        }
+        return {
+            baselineSnapshotId: replaySnapshots.baselineSnapshot.id,
+            targetSnapshotId: replaySnapshots.targetSnapshot.id,
+            path: input.path,
+            method: targetMethod,
+            hasChange: false,
+            classification: null,
+            changeReason: null,
+            details: [],
+            before: beforeEndpoint?.canonicalOperation ?? null,
+            after: afterEndpoint?.canonicalOperation ?? null,
+        };
+    }
+}
+//# sourceMappingURL=snapshotCaptureService.js.map

package/dist/application/snapshot/snapshotCaptureService.js.map

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

package/dist/application/snapshot/snapshotRepository.d.ts

@@ -0,0 +1,77 @@
+import { CanonicalEndpointSnapshot, CanonicalSnapshot } from '../../domain/canonical/canonicalSnapshot.js';
+import { SnapshotDiffResult } from '../../domain/contracts/snapshotDiffContract.js';
+export interface SnapshotProjectRecord {
+    id: string;
+    projectKey: string;
+    createdAt: string;
+}
+export interface SnapshotSourceRecord {
+    id: string;
+    projectId: string;
+    swaggerUrl: string;
+    createdAt: string;
+}
+export interface SnapshotRecord {
+    id: string;
+    sourceId: string;
+    specHash: string;
+    documentFingerprint: string;
+    canonicalSnapshot: CanonicalSnapshot;
+    capturedAt: string;
+}
+export interface SaveSnapshotInput {
+    sourceId: string;
+    specHash: string;
+    documentFingerprint: string;
+    canonicalSnapshot: CanonicalSnapshot;
+    transition?: PersistedTransitionInput;
+}
+export interface SaveSnapshotResult {
+    snapshot: SnapshotRecord;
+    created: boolean;
+}
+export interface SnapshotSourceIdentityRecord {
+    sourceId: string;
+    projectId: string;
+    projectKey: string;
+    swaggerUrl: string;
+}
+export interface PersistedTransitionEvent {
+    path: string;
+    method: CanonicalEndpointSnapshot['method'];
+    classification: SnapshotDiffResult['changes'][number]['classification'];
+    changeReason: string;
+}
+export interface PersistedTransitionInput {
+    baselineSnapshotId: string;
+    counts: SnapshotDiffResult['counts'];
+    warnings: SnapshotDiffResult['warnings'];
+    events: PersistedTransitionEvent[];
+}
+export interface EndpointChangeHistoryRecord {
+    baselineSnapshotId: string;
+    targetSnapshotId: string;
+    path: string;
+    method: CanonicalEndpointSnapshot['method'];
+    classification: SnapshotDiffResult['changes'][number]['classification'];
+    changeReason: string;
+    changedAt: string;
+}
+export interface ListEndpointChangeHistoryInput {
+    sourceId: string;
+    limit?: number;
+    path?: string;
+    method?: CanonicalEndpointSnapshot['method'];
+}
+export interface SnapshotRepository {
+    initializeSchema(): Promise<void>;
+    ensureProject(projectKey: string): Promise<SnapshotProjectRecord>;
+    ensureSource(projectId: string, swaggerUrl: string): Promise<SnapshotSourceRecord>;
+    getSourceIdentityById(sourceId: string): Promise<SnapshotSourceIdentityRecord | null>;
+    getLatestSnapshot(sourceId: string): Promise<SnapshotRecord | null>;
+    saveSnapshot(input: SaveSnapshotInput): Promise<SaveSnapshotResult>;
+    getSnapshotById(snapshotId: string): Promise<SnapshotRecord | null>;
+    listSnapshotsBySource(sourceId: string, limit?: number): Promise<SnapshotRecord[]>;
+    listEndpointChangeHistory(input: ListEndpointChangeHistoryInput): Promise<EndpointChangeHistoryRecord[]>;
+}
+//# sourceMappingURL=snapshotRepository.d.ts.map

package/dist/application/snapshot/snapshotRepository.d.ts.map

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

package/dist/application/snapshot/snapshotRepository.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=snapshotRepository.js.map

package/dist/application/snapshot/snapshotRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotRepository.js","sourceRoot":"","sources":["../../../src/application/snapshot/snapshotRepository.ts"],"names":[],"mappings":""}

package/dist/domain/canonical/canonicalSnapshot.d.ts

@@ -0,0 +1,61 @@
+import { OpenAPIDocument } from '../../utils/types.js';
+declare const HTTP_METHODS: readonly ["get", "post", "put", "patch", "delete", "head", "options", "trace"];
+type CanonicalHttpMethod = (typeof HTTP_METHODS)[number];
+export interface CanonicalEndpointSnapshot {
+    path: string;
+    method: CanonicalHttpMethod;
+    fingerprint: string;
+    canonicalOperation: CanonicalOperationShape;
+}
+export interface VersionSignal {
+    infoVersion: string | null;
+    normalizedInfoVersion: string | null;
+    urlVersionHints: string[];
+    hasVersionMismatch: boolean;
+}
+export interface CanonicalSnapshot {
+    sourceUrl: string;
+    documentFingerprint: string;
+    endpoints: CanonicalEndpointSnapshot[];
+    versionSignal: VersionSignal;
+}
+export interface CanonicalSnapshotInput {
+    document: OpenAPIDocument;
+    sourceUrl: string;
+}
+export interface CanonicalChangeAnalysis {
+    hasStructuralChanges: boolean;
+    hasVersionChange: boolean;
+    isVersionOnlyChange: boolean;
+    hasVersionMismatch: boolean;
+}
+export interface CanonicalMediaContent {
+    mediaType: string;
+    hasSchema: boolean;
+    schema?: unknown;
+}
+export interface CanonicalRequestBody {
+    required: boolean;
+    content: CanonicalMediaContent[];
+}
+export interface CanonicalResponse {
+    statusCode: string;
+    content: CanonicalMediaContent[];
+}
+export interface CanonicalParameter {
+    name: string;
+    in: string;
+    required: boolean;
+    schema?: unknown;
+    content?: CanonicalMediaContent[];
+}
+export interface CanonicalOperationShape {
+    parameters: CanonicalParameter[];
+    requestBody?: CanonicalRequestBody;
+    responses: CanonicalResponse[];
+}
+export declare function extractVersionSignal(document: OpenAPIDocument, sourceUrl: string): VersionSignal;
+export declare function createCanonicalSnapshot(input: CanonicalSnapshotInput): CanonicalSnapshot;
+export declare function analyzeCanonicalChange(baseline: CanonicalSnapshot, target: CanonicalSnapshot): CanonicalChangeAnalysis;
+export {};
+//# sourceMappingURL=canonicalSnapshot.d.ts.map

package/dist/domain/canonical/canonicalSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalSnapshot.d.ts","sourceRoot":"","sources":["../../../src/domain/canonical/canonicalSnapshot.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,QAAA,MAAM,YAAY,gFAAiF,CAAC;AAMpG,KAAK,mBAAmB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,mBAAmB,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,uBAAuB,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,yBAAyB,EAAE,CAAC;IACvC,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAwSD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAahG;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,sBAAsB,GAAG,iBAAiB,CAgDxF;AAgBD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,iBAAiB,GACxB,uBAAuB,CAYzB"}