@opencodereview/core 1.9.1

package/dist/registry/maven-registry.js

@@ -0,0 +1,155 @@
+/**
+ * Maven Registry — package verification against Maven Central.
+ *
+ * Supports:
+ * - groupId:artifactId format (e.g. 'org.springframework.boot:spring-boot')
+ * - Java package name lookup (e.g. 'org.springframework.boot')
+ * - Custom Nexus/Artifactory URLs
+ *
+ * Used for both Java and Kotlin packages.
+ *
+ * @since 0.4.0 (V4)
+ */
+import { RegistryCache } from './cache.js';
+import { JAVA_BUILTINS } from './builtins/java-builtins.js';
+export class MavenRegistry {
+    name = 'maven';
+    language = 'java';
+    baseUrl;
+    token;
+    timeout;
+    cacheTtl;
+    cache;
+    constructor(config, cache) {
+        this.baseUrl = config?.url || 'https://search.maven.org';
+        this.token = config?.token;
+        this.timeout = config?.timeoutMs || 5000;
+        this.cacheTtl = config?.cacheTtlSeconds || 86400;
+        this.cache = cache || new RegistryCache();
+    }
+    /**
+     * Check if a Java/Kotlin import is a standard library package.
+     * Matches against top-level prefixes (e.g. 'java.util' matches 'java.util.List').
+     */
+    isBuiltin(packageName) {
+        for (const builtin of JAVA_BUILTINS) {
+            if (packageName === builtin || packageName.startsWith(builtin + '.')) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Extract groupId from a package name or groupId:artifactId format.
+     *
+     * Formats:
+     * - "org.springframework.boot:spring-boot" → groupId: "org.springframework.boot"
+     * - "org.springframework.boot" → groupId: "org.springframework.boot"
+     * - "com.google.guava" → groupId: "com.google.guava"
+     */
+    extractGroupId(packageName) {
+        if (packageName.includes(':')) {
+            const [groupId, artifactId] = packageName.split(':', 2);
+            return { groupId, artifactId };
+        }
+        return { groupId: packageName };
+    }
+    /**
+     * Verify if a Maven package/group exists.
+     *
+     * 1. Check if it's a Java/Kotlin standard library package
+     * 2. Check cache
+     * 3. Query Maven Central Search API:
+     *    GET {baseUrl}/solrsearch/select?q=g:{groupId}&rows=1&wt=json
+     *    - response.numFound > 0 → exists
+     *    - response.numFound === 0 → does not exist
+     *    - error → assume exists (conservative)
+     */
+    async verify(packageName) {
+        const start = Date.now();
+        // Check standard library first
+        if (this.isBuiltin(packageName)) {
+            return {
+                exists: true,
+                name: packageName,
+                source: 'builtin',
+                latencyMs: Date.now() - start,
+            };
+        }
+        // Check cache
+        const cacheKey = `maven:${packageName}`;
+        const cached = await this.cache.get(cacheKey);
+        if (cached) {
+            return { ...cached, name: packageName, latencyMs: Date.now() - start };
+        }
+        // Query Maven Central
+        try {
+            const { groupId, artifactId } = this.extractGroupId(packageName);
+            let query;
+            if (artifactId) {
+                query = `g:${encodeURIComponent(groupId)}+AND+a:${encodeURIComponent(artifactId)}`;
+            }
+            else {
+                query = `g:${encodeURIComponent(groupId)}`;
+            }
+            const url = `${this.baseUrl}/solrsearch/select?q=${query}&rows=1&wt=json`;
+            const headers = {
+                Accept: 'application/json',
+            };
+            if (this.token) {
+                headers['Authorization'] = `Bearer ${this.token}`;
+            }
+            const response = await fetch(url, {
+                method: 'GET',
+                headers,
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            const latencyMs = Date.now() - start;
+            if (!response.ok) {
+                // Non-200 → assume exists (conservative)
+                return {
+                    exists: true,
+                    name: packageName,
+                    source: 'registry',
+                    latencyMs,
+                };
+            }
+            const data = await response.json();
+            const numFound = data.response?.numFound || 0;
+            const exists = numFound > 0;
+            let version;
+            if (exists && data.response?.docs?.[0]) {
+                version = data.response.docs[0].latestVersion || data.response.docs[0].v;
+            }
+            const result = {
+                exists,
+                name: packageName,
+                version,
+                source: 'registry',
+                latencyMs,
+            };
+            await this.cache.set(cacheKey, result, this.cacheTtl);
+            return result;
+        }
+        catch {
+            // Network error → assume exists (conservative)
+            return {
+                exists: true,
+                name: packageName,
+                source: 'registry',
+                latencyMs: Date.now() - start,
+            };
+        }
+    }
+    /**
+     * Check if a Maven package is deprecated.
+     * Maven Central doesn't have a native deprecation field.
+     * This is a best-effort check — returns null in most cases.
+     */
+    async checkDeprecated(_packageName, _version) {
+        // Maven Central does not provide deprecation info via API.
+        // Future: could check POM metadata or known deprecation databases.
+        return null;
+    }
+}
+//# sourceMappingURL=maven-registry.js.map

package/dist/registry/maven-registry.js.map

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

package/dist/registry/npm-registry.d.ts

@@ -0,0 +1,40 @@
+/**
+ * npm Registry — package verification against the npm registry.
+ *
+ * Supports:
+ * - Regular packages (e.g. 'lodash')
+ * - Scoped packages (e.g. '@scope/name')
+ * - Custom registry URLs (enterprise Nexus/Artifactory)
+ * - Auth token headers
+ *
+ * @since 0.4.0 (V4)
+ */
+import type { PackageRegistry, PackageVerifyResult, DeprecationInfo, RegistryConfig } from './types.js';
+import { RegistryCache } from './cache.js';
+export declare class NpmRegistry implements PackageRegistry {
+    readonly name = "npm";
+    readonly language = "typescript";
+    private baseUrl;
+    private token?;
+    private timeout;
+    private cacheTtl;
+    private cache;
+    constructor(config?: RegistryConfig, cache?: RegistryCache);
+    /**
+     * Verify if an npm package exists.
+     *
+     * 1. Check if it's a Node.js built-in module
+     * 2. Check cache
+     * 3. Query registry: GET {baseUrl}/{packageName}
+     *    - 200 → exists, extract version from dist-tags.latest
+     *    - 404 → does not exist
+     *    - timeout/error → assume exists (conservative)
+     */
+    verify(packageName: string): Promise<PackageVerifyResult>;
+    /**
+     * Check if an npm package is deprecated.
+     * GET {baseUrl}/{packageName}/latest and check the deprecated field.
+     */
+    checkDeprecated(packageName: string): Promise<DeprecationInfo | null>;
+}
+//# sourceMappingURL=npm-registry.d.ts.map

package/dist/registry/npm-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-registry.d.ts","sourceRoot":"","sources":["../../src/registry/npm-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,qBAAa,WAAY,YAAW,eAAe;IACjD,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,QAAQ,gBAAgB;IAEjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAgB;gBAEjB,MAAM,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,aAAa;IAQ1D;;;;;;;;;OASG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAyF/D;;;OAGG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAqC5E"}

package/dist/registry/npm-registry.js

@@ -0,0 +1,155 @@
+/**
+ * npm Registry — package verification against the npm registry.
+ *
+ * Supports:
+ * - Regular packages (e.g. 'lodash')
+ * - Scoped packages (e.g. '@scope/name')
+ * - Custom registry URLs (enterprise Nexus/Artifactory)
+ * - Auth token headers
+ *
+ * @since 0.4.0 (V4)
+ */
+import { RegistryCache } from './cache.js';
+import { NODE_BUILTINS } from './builtins/node-builtins.js';
+export class NpmRegistry {
+    name = 'npm';
+    language = 'typescript';
+    baseUrl;
+    token;
+    timeout;
+    cacheTtl;
+    cache;
+    constructor(config, cache) {
+        this.baseUrl = config?.url || 'https://registry.npmjs.org';
+        this.token = config?.token;
+        this.timeout = config?.timeoutMs || 5000;
+        this.cacheTtl = config?.cacheTtlSeconds || 86400;
+        this.cache = cache || new RegistryCache();
+    }
+    /**
+     * Verify if an npm package exists.
+     *
+     * 1. Check if it's a Node.js built-in module
+     * 2. Check cache
+     * 3. Query registry: GET {baseUrl}/{packageName}
+     *    - 200 → exists, extract version from dist-tags.latest
+     *    - 404 → does not exist
+     *    - timeout/error → assume exists (conservative)
+     */
+    async verify(packageName) {
+        const start = Date.now();
+        // Check built-in modules first
+        const normalizedName = packageName.startsWith('node:')
+            ? packageName
+            : packageName;
+        if (NODE_BUILTINS.has(normalizedName) || NODE_BUILTINS.has(`node:${normalizedName}`)) {
+            return {
+                exists: true,
+                name: packageName,
+                source: 'builtin',
+                latencyMs: Date.now() - start,
+            };
+        }
+        // Check cache
+        const cacheKey = `npm:${packageName}`;
+        const cached = await this.cache.get(cacheKey);
+        if (cached) {
+            return { ...cached, latencyMs: Date.now() - start };
+        }
+        // Query registry
+        try {
+            // Scoped packages: @scope/name → @scope%2Fname
+            const encodedName = packageName.startsWith('@')
+                ? `@${encodeURIComponent(packageName.slice(1))}`
+                : encodeURIComponent(packageName);
+            const url = `${this.baseUrl}/${encodedName}`;
+            const headers = {
+                Accept: 'application/vnd.npm.install-v1+json',
+            };
+            if (this.token) {
+                headers['Authorization'] = `Bearer ${this.token}`;
+            }
+            const response = await fetch(url, {
+                method: 'GET',
+                headers,
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            const latencyMs = Date.now() - start;
+            if (response.status === 404) {
+                const result = {
+                    exists: false,
+                    name: packageName,
+                    source: 'registry',
+                    latencyMs,
+                };
+                await this.cache.set(cacheKey, result, this.cacheTtl);
+                return result;
+            }
+            // Parse response to get version info
+            let version;
+            try {
+                const data = await response.json();
+                const distTags = data['dist-tags'];
+                version = distTags?.latest;
+            }
+            catch {
+                // Could not parse response body, but status was OK
+            }
+            const result = {
+                exists: true,
+                name: packageName,
+                version,
+                source: 'registry',
+                latencyMs,
+            };
+            await this.cache.set(cacheKey, result, this.cacheTtl);
+            return result;
+        }
+        catch {
+            // Network error or timeout → assume exists (conservative, avoid false positives)
+            return {
+                exists: true,
+                name: packageName,
+                source: 'registry',
+                latencyMs: Date.now() - start,
+            };
+        }
+    }
+    /**
+     * Check if an npm package is deprecated.
+     * GET {baseUrl}/{packageName}/latest and check the deprecated field.
+     */
+    async checkDeprecated(packageName) {
+        try {
+            const encodedName = packageName.startsWith('@')
+                ? `@${encodeURIComponent(packageName.slice(1))}`
+                : encodeURIComponent(packageName);
+            const url = `${this.baseUrl}/${encodedName}/latest`;
+            const headers = {};
+            if (this.token) {
+                headers['Authorization'] = `Bearer ${this.token}`;
+            }
+            const response = await fetch(url, {
+                method: 'GET',
+                headers,
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            if (!response.ok) {
+                return null;
+            }
+            const data = await response.json();
+            const deprecated = data['deprecated'];
+            if (deprecated) {
+                return {
+                    deprecated: true,
+                    message: deprecated,
+                };
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=npm-registry.js.map

package/dist/registry/npm-registry.js.map

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

package/dist/registry/pypi-registry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * PyPI Registry — package verification against the Python Package Index.
+ *
+ * Supports:
+ * - Regular packages (e.g. 'requests')
+ * - Name normalization (hyphens ↔ underscores, case-insensitive)
+ * - Deprecation detection from classifiers and description
+ * - Custom registry URLs (enterprise)
+ *
+ * @since 0.4.0 (V4)
+ */
+import type { PackageRegistry, PackageVerifyResult, DeprecationInfo, RegistryConfig } from './types.js';
+import { RegistryCache } from './cache.js';
+export declare class PyPIRegistry implements PackageRegistry {
+    readonly name = "pypi";
+    readonly language = "python";
+    private baseUrl;
+    private token?;
+    private timeout;
+    private cacheTtl;
+    private cache;
+    constructor(config?: RegistryConfig, cache?: RegistryCache);
+    /**
+     * Normalize a PyPI package name.
+     * PyPI package names are case-insensitive and treat hyphens, underscores,
+     * and periods as equivalent.
+     * PEP 503: normalize by lowering and replacing [-_.] with hyphens.
+     */
+    private normalizeName;
+    /**
+     * Verify if a Python package exists on PyPI.
+     *
+     * 1. Check if it's a Python standard library module
+     * 2. Check cache
+     * 3. Query PyPI JSON API: GET {baseUrl}/pypi/{packageName}/json
+     *    - 200 → exists
+     *    - 404 → does not exist
+     *    - error → assume exists (conservative)
+     */
+    verify(packageName: string): Promise<PackageVerifyResult>;
+    /**
+     * Check if a Python package is deprecated.
+     * Looks for:
+     * - "Development Status :: 7 - Inactive" in classifiers
+     * - Deprecation notices in summary/description
+     */
+    checkDeprecated(packageName: string): Promise<DeprecationInfo | null>;
+}
+//# sourceMappingURL=pypi-registry.d.ts.map

package/dist/registry/pypi-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pypi-registry.d.ts","sourceRoot":"","sources":["../../src/registry/pypi-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,qBAAa,YAAa,YAAW,eAAe;IAClD,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,QAAQ,YAAY;IAE7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAgB;gBAEjB,MAAM,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,aAAa;IAQ1D;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;;;;;;OASG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkF/D;;;;;OAKG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CA+D5E"}

package/dist/registry/pypi-registry.js

@@ -0,0 +1,175 @@
+/**
+ * PyPI Registry — package verification against the Python Package Index.
+ *
+ * Supports:
+ * - Regular packages (e.g. 'requests')
+ * - Name normalization (hyphens ↔ underscores, case-insensitive)
+ * - Deprecation detection from classifiers and description
+ * - Custom registry URLs (enterprise)
+ *
+ * @since 0.4.0 (V4)
+ */
+import { RegistryCache } from './cache.js';
+import { PYTHON_BUILTINS } from './builtins/python-builtins.js';
+export class PyPIRegistry {
+    name = 'pypi';
+    language = 'python';
+    baseUrl;
+    token;
+    timeout;
+    cacheTtl;
+    cache;
+    constructor(config, cache) {
+        this.baseUrl = config?.url || 'https://pypi.org';
+        this.token = config?.token;
+        this.timeout = config?.timeoutMs || 5000;
+        this.cacheTtl = config?.cacheTtlSeconds || 86400;
+        this.cache = cache || new RegistryCache();
+    }
+    /**
+     * Normalize a PyPI package name.
+     * PyPI package names are case-insensitive and treat hyphens, underscores,
+     * and periods as equivalent.
+     * PEP 503: normalize by lowering and replacing [-_.] with hyphens.
+     */
+    normalizeName(name) {
+        return name.toLowerCase().replace(/[-_.]+/g, '-');
+    }
+    /**
+     * Verify if a Python package exists on PyPI.
+     *
+     * 1. Check if it's a Python standard library module
+     * 2. Check cache
+     * 3. Query PyPI JSON API: GET {baseUrl}/pypi/{packageName}/json
+     *    - 200 → exists
+     *    - 404 → does not exist
+     *    - error → assume exists (conservative)
+     */
+    async verify(packageName) {
+        const start = Date.now();
+        // Check Python stdlib first
+        // Python imports use the top-level module name
+        const topLevel = packageName.split('.')[0];
+        if (PYTHON_BUILTINS.has(topLevel)) {
+            return {
+                exists: true,
+                name: packageName,
+                source: 'builtin',
+                latencyMs: Date.now() - start,
+            };
+        }
+        // Normalize name for cache and lookup
+        const normalized = this.normalizeName(packageName);
+        const cacheKey = `pypi:${normalized}`;
+        const cached = await this.cache.get(cacheKey);
+        if (cached) {
+            return { ...cached, name: packageName, latencyMs: Date.now() - start };
+        }
+        // Query PyPI
+        try {
+            const url = `${this.baseUrl}/pypi/${encodeURIComponent(normalized)}/json`;
+            const headers = {
+                Accept: 'application/json',
+            };
+            if (this.token) {
+                headers['Authorization'] = `Bearer ${this.token}`;
+            }
+            const response = await fetch(url, {
+                method: 'GET',
+                headers,
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            const latencyMs = Date.now() - start;
+            if (response.status === 404) {
+                const result = {
+                    exists: false,
+                    name: packageName,
+                    source: 'registry',
+                    latencyMs,
+                };
+                await this.cache.set(cacheKey, result, this.cacheTtl);
+                return result;
+            }
+            // Extract version from response
+            let version;
+            try {
+                const data = await response.json();
+                version = data.info?.version;
+            }
+            catch {
+                // Could not parse, but the package exists
+            }
+            const result = {
+                exists: true,
+                name: packageName,
+                version,
+                source: 'registry',
+                latencyMs,
+            };
+            await this.cache.set(cacheKey, result, this.cacheTtl);
+            return result;
+        }
+        catch {
+            // Network error → assume exists (conservative)
+            return {
+                exists: true,
+                name: packageName,
+                source: 'registry',
+                latencyMs: Date.now() - start,
+            };
+        }
+    }
+    /**
+     * Check if a Python package is deprecated.
+     * Looks for:
+     * - "Development Status :: 7 - Inactive" in classifiers
+     * - Deprecation notices in summary/description
+     */
+    async checkDeprecated(packageName) {
+        try {
+            const normalized = this.normalizeName(packageName);
+            const url = `${this.baseUrl}/pypi/${encodeURIComponent(normalized)}/json`;
+            const headers = {};
+            if (this.token) {
+                headers['Authorization'] = `Bearer ${this.token}`;
+            }
+            const response = await fetch(url, {
+                method: 'GET',
+                headers,
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            if (!response.ok) {
+                return null;
+            }
+            const data = await response.json();
+            const info = data.info;
+            if (!info)
+                return null;
+            // Check classifiers for inactive status
+            const classifiers = info.classifiers || [];
+            const isInactive = classifiers.some((c) => c.includes('Development Status :: 7 - Inactive'));
+            if (isInactive) {
+                return {
+                    deprecated: true,
+                    message: 'Package is marked as inactive (Development Status :: 7 - Inactive)',
+                };
+            }
+            // Check summary for deprecation notice
+            const summary = (info.summary || '').toLowerCase();
+            const description = (info.description || '').toLowerCase();
+            if (summary.includes('deprecated') ||
+                summary.includes('no longer maintained') ||
+                description.startsWith('deprecated')) {
+                return {
+                    deprecated: true,
+                    message: info.summary || 'Package appears to be deprecated',
+                };
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=pypi-registry.js.map

package/dist/registry/pypi-registry.js.map

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

package/dist/registry/registry-manager.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Registry Manager — manages all language-specific registries.
+ *
+ * Provides a unified interface for verifying packages across
+ * all supported languages. Routes verification requests to the
+ * appropriate registry based on language.
+ *
+ * @since 0.4.0 (V4)
+ */
+import type { PackageRegistry, PackageVerifyResult, RegistryOptions } from './types.js';
+import { RegistryCache } from './cache.js';
+export declare class RegistryManager {
+    private registries;
+    private cache;
+    constructor(options?: RegistryOptions, cache?: RegistryCache);
+    /**
+     * Get the registry for a given language.
+     */
+    getRegistry(language: string): PackageRegistry | undefined;
+    /**
+     * Verify a package exists for a given language.
+     * If no registry is configured for the language, returns a graceful result.
+     */
+    verifyPackage(language: string, packageName: string): Promise<PackageVerifyResult>;
+    /**
+     * Batch verify multiple packages concurrently with rate limiting.
+     *
+     * @param language Target language
+     * @param packageNames Packages to verify
+     * @param concurrency Max concurrent verifications (default: 5)
+     */
+    verifyBatch(language: string, packageNames: string[], concurrency?: number): Promise<Map<string, PackageVerifyResult>>;
+    /**
+     * Get cache statistics.
+     */
+    cacheStats(): {
+        entries: number;
+        hitRate: number;
+    };
+    /**
+     * Persist the cache to disk.
+     */
+    persistCache(): Promise<void>;
+}
+//# sourceMappingURL=registry-manager.d.ts.map

package/dist/registry/registry-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-manager.d.ts","sourceRoot":"","sources":["../../src/registry/registry-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAM3C,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,KAAK,CAAgB;gBAEjB,OAAO,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,aAAa;IAiB5D;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI1D;;;OAGG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAaxF;;;;;;OAMG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EAAE,EACtB,WAAW,GAAE,MAAU,GACtB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAqC5C;;OAEG;IACH,UAAU,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAQlD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC"}