@principal-ai/subsystems-core 0.29.0

package/dist/registry/RemoteRegistry.js

@@ -0,0 +1,399 @@
+"use strict";
+/**
+ * RemoteRegistry - Calls web-ade API for published libraries
+ *
+ * Features:
+ * - HTTP caching (immutable schematics)
+ * - Handles PURL lookups (published libraries)
+ * - Handles customerId + serviceName lookups (services)
+ * - Version → commit hash resolution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemoteRegistry = void 0;
+const utils_1 = require("../scopes/utils");
+/**
+ * Remote registry implementation
+ */
+class RemoteRegistry {
+    constructor(apiBaseUrl, cacheTTL = 60 * 60 * 1000 // Default: 1 hour
+    ) {
+        this.apiBaseUrl = apiBaseUrl;
+        this.cache = new Map();
+        this.scopeToSnapshotKey = new Map();
+        this.cacheTTL = cacheTTL;
+    }
+    async lookupByScope(scope, resource) {
+        // First, check if this scope is owned by a cached schematic
+        const owningCacheKey = this.scopeToSnapshotKey.get(scope.name);
+        if (owningCacheKey) {
+            const cached = this.cache.get(owningCacheKey);
+            if (cached && cached.expiresAt > Date.now()) {
+                console.log('[RemoteRegistry] Scope found via owned-scopes mapping:', {
+                    scopeName: scope.name,
+                    cacheKey: owningCacheKey,
+                });
+                if (cached.snapshot.storyboards.length === 0) {
+                    return { found: false, reason: 'no_storyboards', scopeName: scope.name };
+                }
+                return { found: true, snapshot: cached.snapshot };
+            }
+            // Cache expired, remove stale mapping
+            this.scopeToSnapshotKey.delete(scope.name);
+        }
+        // Check if this is a library (PURL format)
+        if (scope.name.startsWith('pkg:')) {
+            const snapshot = await this.lookupLibrary(scope.name, scope.version);
+            if (!snapshot) {
+                return { found: false, reason: 'scope_not_owned', scopeName: scope.name };
+            }
+            if (snapshot.storyboards.length === 0) {
+                return { found: false, reason: 'no_storyboards', scopeName: scope.name };
+            }
+            return { found: true, snapshot };
+        }
+        // Otherwise it's a service - need customerId
+        const customerId = resource.attributes?.['customer.id'];
+        if (!customerId) {
+            console.warn('[RemoteRegistry] Service scope requires customer.id in resource attributes:', { scopeName: scope.name });
+            return { found: false, reason: 'scope_not_owned', scopeName: scope.name };
+        }
+        const snapshot = await this.lookupService(customerId, scope.name, scope.version);
+        if (!snapshot) {
+            return { found: false, reason: 'scope_not_owned', scopeName: scope.name };
+        }
+        if (snapshot.storyboards.length === 0) {
+            return { found: false, reason: 'no_storyboards', scopeName: scope.name };
+        }
+        return { found: true, snapshot };
+    }
+    /**
+     * Lookup published library by PURL
+     */
+    async lookupLibrary(purl, version) {
+        try {
+            // Parse PURL to extract components
+            const components = this.parsePURL(purl);
+            if (!components) {
+                console.error('[RemoteRegistry] Invalid PURL format:', purl);
+                return null;
+            }
+            // Get repository URL from package registry
+            const repoUrl = await this.getPackageRepository(components);
+            if (!repoUrl) {
+                console.error('[RemoteRegistry] Could not resolve repository for package:', purl);
+                return null;
+            }
+            // Lookup version → commit hash
+            const versionInfo = await this.lookupVersionMapping(repoUrl, version);
+            if (!versionInfo) {
+                return null;
+            }
+            // Fetch schematic by commit hash
+            return this.fetchSchematic(repoUrl, versionInfo.gitSHA);
+        }
+        catch (error) {
+            console.error('[RemoteRegistry] Library lookup failed:', error);
+            return null;
+        }
+    }
+    /**
+     * Lookup service by customerId + serviceName
+     */
+    async lookupService(customerId, serviceName, version) {
+        try {
+            // Lookup version → commit hash
+            const url = new URL(`${this.apiBaseUrl}/api/versions/lookup`);
+            url.searchParams.set('customerId', customerId);
+            url.searchParams.set('serviceName', serviceName);
+            url.searchParams.set('version', version);
+            const response = await fetch(url.toString());
+            if (!response.ok) {
+                if (response.status === 404) {
+                    console.log('[RemoteRegistry] Version not found:', { customerId, serviceName, version });
+                    return null;
+                }
+                throw new Error(`API error: ${response.status}`);
+            }
+            const data = await response.json();
+            if (!data.found || !data.registration) {
+                return null;
+            }
+            // Fetch schematic by commit hash
+            return this.fetchSchematic(data.registration.repositoryUrl, data.registration.gitSHA);
+        }
+        catch (error) {
+            console.error('[RemoteRegistry] Service lookup failed:', error);
+            return null;
+        }
+    }
+    /**
+     * Lookup version mapping (version string → commit hash)
+     */
+    async lookupVersionMapping(repositoryUrl, version) {
+        try {
+            // For libraries, we use repositoryUrl + version
+            // The API expects this format for published packages
+            const url = new URL(`${this.apiBaseUrl}/api/versions/lookup`);
+            url.searchParams.set('repositoryUrl', repositoryUrl);
+            url.searchParams.set('version', version);
+            const response = await fetch(url.toString());
+            if (!response.ok) {
+                if (response.status === 404) {
+                    return null;
+                }
+                throw new Error(`API error: ${response.status}`);
+            }
+            const data = await response.json();
+            if (!data.found || !data.registration) {
+                return null;
+            }
+            return {
+                gitSHA: data.registration.gitSHA,
+                repositoryUrl: data.registration.repositoryUrl,
+            };
+        }
+        catch (error) {
+            console.error('[RemoteRegistry] Version mapping lookup failed:', error);
+            return null;
+        }
+    }
+    /**
+     * Fetch schematic by repository URL and commit SHA
+     */
+    async fetchSchematic(repositoryUrl, commitSha) {
+        // Check cache first
+        const cacheKey = `${repositoryUrl}@${commitSha}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached && cached.expiresAt > Date.now()) {
+            return cached.snapshot;
+        }
+        try {
+            const url = new URL(`${this.apiBaseUrl}/api/versions/schematic`);
+            url.searchParams.set('repositoryUrl', repositoryUrl);
+            url.searchParams.set('commitSha', commitSha);
+            const response = await fetch(url.toString());
+            if (!response.ok) {
+                if (response.status === 404) {
+                    console.log('[RemoteRegistry] Schematic not found:', { repositoryUrl, commitSha });
+                    return null;
+                }
+                throw new Error(`API error: ${response.status}`);
+            }
+            const snapshot = await response.json();
+            // Cache the result
+            this.cache.set(cacheKey, {
+                snapshot,
+                expiresAt: Date.now() + this.cacheTTL,
+            });
+            // Register owned scopes for routing
+            if (snapshot.resources) {
+                this.registerOwnedScopes(cacheKey, snapshot.resources);
+            }
+            console.log('[RemoteRegistry] Schematic fetched:', {
+                repositoryUrl,
+                commitSha,
+                storyboardCount: snapshot.storyboards.length,
+                ownedScopes: this.getOwnedScopesFromResources(snapshot.resources),
+            });
+            return snapshot;
+        }
+        catch (error) {
+            console.error('[RemoteRegistry] Schematic fetch failed:', error);
+            return null;
+        }
+    }
+    /**
+     * Parse PURL string into components
+     *
+     * Format: pkg:ecosystem/namespace/name
+     * Examples:
+     *   pkg:npm/@acme/auth-library
+     *   pkg:pypi/acme-auth-library
+     *   pkg:maven/com.acme/auth-library
+     *   pkg:golang/github.com/acme/auth-lib
+     */
+    parsePURL(purl) {
+        const match = purl.match(/^pkg:([^/]+)\/(.+)$/);
+        if (!match) {
+            return null;
+        }
+        const ecosystem = match[1];
+        const rest = match[2];
+        // Handle scoped packages (e.g., @acme/package-name)
+        const parts = rest.split('/');
+        if (parts.length === 2) {
+            return {
+                ecosystem,
+                namespace: parts[0],
+                name: parts[1],
+            };
+        }
+        else if (parts.length === 1) {
+            return {
+                ecosystem,
+                name: parts[0],
+            };
+        }
+        return null;
+    }
+    /**
+     * Get repository URL from package registry metadata
+     *
+     * This queries the package registry (npm, pypi, etc.) to get the repository URL.
+     */
+    async getPackageRepository(components) {
+        try {
+            switch (components.ecosystem) {
+                case 'npm':
+                    return this.getNpmRepository(components);
+                case 'pypi':
+                    return this.getPypiRepository(components);
+                default:
+                    console.warn('[RemoteRegistry] Unsupported ecosystem:', components.ecosystem);
+                    return null;
+            }
+        }
+        catch (error) {
+            console.error('[RemoteRegistry] Package repository lookup failed:', error);
+            return null;
+        }
+    }
+    /**
+     * Get repository URL from npm registry
+     */
+    async getNpmRepository(components) {
+        const packageName = components.namespace
+            ? `${components.namespace}/${components.name}`
+            : components.name;
+        const url = `https://registry.npmjs.org/${encodeURIComponent(packageName)}`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            return null;
+        }
+        const data = await response.json();
+        const repoUrl = data.repository?.url || data.repository;
+        if (!repoUrl) {
+            return null;
+        }
+        // Clean up git URLs (git+https://github.com/... → https://github.com/...)
+        return repoUrl.replace(/^git\+/, '').replace(/\.git$/, '');
+    }
+    /**
+     * Get repository URL from PyPI
+     */
+    async getPypiRepository(components) {
+        const packageName = components.name;
+        const url = `https://pypi.org/pypi/${encodeURIComponent(packageName)}/json`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            return null;
+        }
+        const data = await response.json();
+        return data.info?.project_urls?.Source || data.info?.home_page || null;
+    }
+    async listScopes() {
+        console.warn('[RemoteRegistry] listScopes not implemented for remote registry');
+        return [];
+    }
+    supportsHotReload() {
+        return false;
+    }
+    /**
+     * Register a schematic directly (for preloading)
+     *
+     * This is similar to LocalRegistry's registerWorkspace() - it allows you to
+     * preload schematics before traces arrive, so the owned-scopes mapping is
+     * already populated when lookupByScope is called.
+     *
+     * @param snapshot - The VersionSnapshot to register
+     * @returns Array of registered scope names (from owned-scopes)
+     *
+     * @example
+     * ```typescript
+     * // Fetch schematic from your API
+     * const response = await fetch('/api/schematics/my-panel');
+     * const snapshot = await response.json();
+     *
+     * // Register it with RemoteRegistry
+     * const scopes = registry.registerSchematic(snapshot);
+     * console.log('Registered scopes:', scopes);
+     * // Now traces with these scopes will match this schematic's storyboards
+     * ```
+     */
+    registerSchematic(snapshot) {
+        const cacheKey = `${snapshot.repositoryUrl}@${snapshot.commitSha}`;
+        // Cache the snapshot
+        this.cache.set(cacheKey, {
+            snapshot,
+            expiresAt: Date.now() + this.cacheTTL,
+        });
+        // Register owned scopes (supports both legacy array and new record format)
+        const registeredScopes = [];
+        if (snapshot.resources) {
+            for (const [_resourceName, attrs] of Object.entries(snapshot.resources)) {
+                const scopeNames = (0, utils_1.getScopeNames)(attrs['owned-scopes']);
+                for (const scope of scopeNames) {
+                    this.scopeToSnapshotKey.set(scope, cacheKey);
+                    registeredScopes.push(scope);
+                }
+            }
+        }
+        console.log('[RemoteRegistry] Registered schematic:', {
+            cacheKey,
+            storyboardCount: snapshot.storyboards?.length || 0,
+            registeredScopes,
+        });
+        return registeredScopes;
+    }
+    /**
+     * Register owned scopes from a schematic's resources
+     *
+     * This builds a mapping from instrumentation scope names to their owning
+     * schematic cache key. When a trace comes in with a scope listed in
+     * `owned-scopes`, we can route it to the correct storyboards without
+     * needing a separate lookup.
+     */
+    registerOwnedScopes(cacheKey, resources) {
+        for (const [_resourceName, attrs] of Object.entries(resources)) {
+            const scopeNames = (0, utils_1.getScopeNames)(attrs['owned-scopes']);
+            for (const scope of scopeNames) {
+                this.scopeToSnapshotKey.set(scope, cacheKey);
+                console.log('[RemoteRegistry] Registered owned scope:', {
+                    scope,
+                    cacheKey,
+                });
+            }
+        }
+    }
+    /**
+     * Extract all owned scopes from resources (for logging)
+     */
+    getOwnedScopesFromResources(resources) {
+        if (!resources)
+            return [];
+        const scopes = [];
+        for (const attrs of Object.values(resources)) {
+            scopes.push(...(0, utils_1.getScopeNames)(attrs['owned-scopes']));
+        }
+        return scopes;
+    }
+    /**
+     * Clear the cache (useful for testing)
+     */
+    clearCache() {
+        this.cache.clear();
+        this.scopeToSnapshotKey.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        return {
+            size: this.cache.size,
+            ttl: this.cacheTTL,
+            ownedScopesCount: this.scopeToSnapshotKey.size,
+        };
+    }
+}
+exports.RemoteRegistry = RemoteRegistry;
+//# sourceMappingURL=RemoteRegistry.js.map

package/dist/registry/RemoteRegistry.js.map

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

package/dist/registry/VersionRegistry.d.ts

@@ -0,0 +1,51 @@
+/**
+ * In-Memory Version Registry Implementation
+ *
+ * This is a simple in-memory implementation of the VersionRegistry interface,
+ * useful for testing and development. For production use, implement a persistent
+ * backend (database, S3, etc.).
+ */
+import type { VersionRegistry, RegisterVersionRequest, GetVersionResponse, VersionIdentifier } from '../types/version-registry';
+/**
+ * In-memory version registry for testing and development
+ */
+export declare class InMemoryVersionRegistry implements VersionRegistry {
+    private versions;
+    /**
+     * Create a unique key for a version
+     */
+    private getKey;
+    /**
+     * Register a new version snapshot
+     */
+    register(request: RegisterVersionRequest): Promise<void>;
+    /**
+     * Get a version snapshot by repository URL and commit SHA
+     */
+    get(repositoryUrl: string, commitSha: string): Promise<GetVersionResponse>;
+    /**
+     * Check if a version exists in the registry
+     */
+    exists(repositoryUrl: string, commitSha: string): Promise<boolean>;
+    /**
+     * Delete a version from the registry
+     */
+    delete(repositoryUrl: string, commitSha: string): Promise<void>;
+    /**
+     * List all versions for a repository
+     */
+    listVersions(repositoryUrl: string): Promise<VersionIdentifier[]>;
+    /**
+     * Clear all versions (for testing)
+     */
+    clear(): void;
+    /**
+     * Get the number of versions in the registry (for testing)
+     */
+    get size(): number;
+}
+/**
+ * Create a new in-memory version registry
+ */
+export declare function createInMemoryVersionRegistry(): InMemoryVersionRegistry;
+//# sourceMappingURL=VersionRegistry.d.ts.map

package/dist/registry/VersionRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/VersionRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,eAAe,EAEf,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,QAAQ,CAA2C;IAE3D;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9D;;OAEG;IACG,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiBhF;;OAEG;IACG,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxE;;OAEG;IACG,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrE;;OAEG;IACG,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAevE;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,uBAAuB,CAEvE"}

package/dist/registry/VersionRegistry.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * In-Memory Version Registry Implementation
+ *
+ * This is a simple in-memory implementation of the VersionRegistry interface,
+ * useful for testing and development. For production use, implement a persistent
+ * backend (database, S3, etc.).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInMemoryVersionRegistry = exports.InMemoryVersionRegistry = void 0;
+/**
+ * In-memory version registry for testing and development
+ */
+class InMemoryVersionRegistry {
+    constructor() {
+        this.versions = new Map();
+    }
+    /**
+     * Create a unique key for a version
+     */
+    getKey(repositoryUrl, commitSha) {
+        return `${repositoryUrl}@${commitSha}`;
+    }
+    /**
+     * Register a new version snapshot
+     */
+    async register(request) {
+        const key = this.getKey(request.repositoryUrl, request.commitSha);
+        const snapshot = {
+            repositoryUrl: request.repositoryUrl,
+            commitSha: request.commitSha,
+            storyboards: request.storyboards,
+            registeredAt: new Date().toISOString(),
+            metadata: request.metadata,
+        };
+        this.versions.set(key, snapshot);
+    }
+    /**
+     * Get a version snapshot by repository URL and commit SHA
+     */
+    async get(repositoryUrl, commitSha) {
+        const key = this.getKey(repositoryUrl, commitSha);
+        const snapshot = this.versions.get(key);
+        if (!snapshot) {
+            return {
+                found: false,
+                error: `Version not found: ${repositoryUrl}@${commitSha}`,
+            };
+        }
+        return {
+            found: true,
+            snapshot,
+        };
+    }
+    /**
+     * Check if a version exists in the registry
+     */
+    async exists(repositoryUrl, commitSha) {
+        const key = this.getKey(repositoryUrl, commitSha);
+        return this.versions.has(key);
+    }
+    /**
+     * Delete a version from the registry
+     */
+    async delete(repositoryUrl, commitSha) {
+        const key = this.getKey(repositoryUrl, commitSha);
+        this.versions.delete(key);
+    }
+    /**
+     * List all versions for a repository
+     */
+    async listVersions(repositoryUrl) {
+        const versions = [];
+        for (const [_key, snapshot] of this.versions.entries()) {
+            if (snapshot.repositoryUrl === repositoryUrl) {
+                versions.push({
+                    repositoryUrl: snapshot.repositoryUrl,
+                    commitSha: snapshot.commitSha,
+                });
+            }
+        }
+        return versions.sort((a, b) => a.commitSha.localeCompare(b.commitSha));
+    }
+    /**
+     * Clear all versions (for testing)
+     */
+    clear() {
+        this.versions.clear();
+    }
+    /**
+     * Get the number of versions in the registry (for testing)
+     */
+    get size() {
+        return this.versions.size;
+    }
+}
+exports.InMemoryVersionRegistry = InMemoryVersionRegistry;
+/**
+ * Create a new in-memory version registry
+ */
+function createInMemoryVersionRegistry() {
+    return new InMemoryVersionRegistry();
+}
+exports.createInMemoryVersionRegistry = createInMemoryVersionRegistry;
+//# sourceMappingURL=VersionRegistry.js.map

package/dist/registry/VersionRegistry.js.map

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

package/dist/rules/config.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Principal Views Configuration Loader and Validator
+ * Handles loading and validating privu config files
+ */
+import type { PrivuConfig, RuleSeverity } from './types';
+/**
+ * Valid config file names in resolution order
+ */
+export declare const CONFIG_FILE_NAMES: readonly [".privurc.yaml", ".privurc.yml", ".privurc.json"];
+/**
+ * Default include patterns
+ */
+export declare const DEFAULT_INCLUDE_PATTERNS: string[];
+/**
+ * Default exclude patterns
+ */
+export declare const DEFAULT_EXCLUDE_PATTERNS: string[];
+/**
+ * Valid severity values
+ */
+export declare const VALID_SEVERITIES: readonly (RuleSeverity | false)[];
+/**
+ * All valid rule IDs
+ */
+export declare const VALID_RULE_IDS: readonly ["no-unknown-fields", "required-metadata", "valid-node-types", "valid-edge-types", "valid-color-format", "connection-type-references", "state-transition-references", "minimum-node-sources", "orphaned-node-types", "orphaned-edge-types", "unreachable-states", "dead-end-states", "valid-action-patterns"];
+export type ValidRuleId = (typeof VALID_RULE_IDS)[number];
+/**
+ * Rule-specific valid options
+ */
+export declare const RULE_OPTIONS_SCHEMA: Record<string, string[]>;
+export interface ConfigValidationError {
+    path: string;
+    message: string;
+    suggestion?: string;
+}
+export interface ConfigValidationResult {
+    valid: boolean;
+    errors: ConfigValidationError[];
+    config?: PrivuConfig;
+}
+/**
+ * Validate a VGC configuration object
+ */
+export declare function validatePrivuConfig(config: unknown): ConfigValidationResult;
+/**
+ * Get the default VGC configuration
+ */
+export declare function getDefaultConfig(): PrivuConfig;
+/**
+ * Merge configs with proper precedence (later configs override earlier)
+ */
+export declare function mergeConfigs(...configs: (PrivuConfig | undefined)[]): PrivuConfig;
+/**
+ * Format config validation errors for display
+ */
+export declare function formatConfigErrors(errors: ConfigValidationError[]): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/rules/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/rules/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAMzD;;GAEG;AACH,eAAO,MAAM,iBAAiB,6DAA8D,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,wBAAwB,UAIpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,UAAwC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,CAAC,YAAY,GAAG,KAAK,CAAC,EAQ7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,wTAkBjB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAIxD,CAAC;AAMF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,sBAAsB,CAuH3E;AAoHD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,CAO9C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,OAAO,EAAE,CAAC,WAAW,GAAG,SAAS,CAAC,EAAE,GAAG,WAAW,CAkBjF;AAgED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAc1E"}