@aster-cloud/aster-lang-ts 0.0.1

package/dist/src/package/manifest-parser.js

@@ -0,0 +1,275 @@
+/**
+ * Aster包清单文件解析器
+ *
+ * 负责读取、解析和验证manifest.json文件
+ */
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import Ajv from 'ajv';
+import { DiagnosticBuilder, DiagnosticCode } from '../diagnostics/diagnostics.js';
+// 加载manifest.schema.json
+// 从项目根目录加载schema（因为schema文件不会被编译到dist目录）
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// 从dist/src/package回到项目根目录：../../../
+const schemaPath = join(__dirname, '..', '..', '..', 'manifest.schema.json');
+const schema = JSON.parse(readFileSync(schemaPath, 'utf-8'));
+const ajv = new Ajv({ strict: true, allErrors: true });
+const validateSchema = ajv.compile(schema);
+/**
+ * 解析manifest.json文件
+ *
+ * @param filePath manifest.json文件路径
+ * @returns 解析后的Manifest对象，或诊断错误数组
+ */
+export function parseManifest(filePath) {
+    // 读取文件
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf-8');
+    }
+    catch (err) {
+        const error = err;
+        if (error.code === 'ENOENT') {
+            return [
+                DiagnosticBuilder.error(DiagnosticCode.M002_ManifestFileNotFound)
+                    .withMessage(`找不到清单文件：${filePath}`)
+                    .withPosition(dummyPosition())
+                    .build(),
+            ];
+        }
+        return [
+            DiagnosticBuilder.error(DiagnosticCode.M001_ManifestParseError)
+                .withMessage(`读取清单文件失败：${error.message}`)
+                .withPosition(dummyPosition())
+                .build(),
+        ];
+    }
+    // 解析JSON
+    let manifest;
+    try {
+        manifest = JSON.parse(content);
+    }
+    catch (err) {
+        const error = err;
+        return [
+            DiagnosticBuilder.error(DiagnosticCode.M001_ManifestParseError)
+                .withMessage(`JSON解析失败：${error.message}`)
+                .withPosition(dummyPosition())
+                .build(),
+        ];
+    }
+    // JSON Schema验证
+    const isValid = validateSchema(manifest);
+    if (!isValid && validateSchema.errors) {
+        const diagnostics = [];
+        for (const error of validateSchema.errors) {
+            const fieldPath = error.instancePath || '/';
+            const errorDiagnostic = mapAjvErrorToDiagnostic(error, fieldPath, manifest);
+            diagnostics.push(errorDiagnostic);
+        }
+        return diagnostics;
+    }
+    // 语义验证
+    const typedManifest = manifest;
+    const semanticErrors = validateManifest(typedManifest);
+    if (semanticErrors.length > 0) {
+        return semanticErrors;
+    }
+    return typedManifest;
+}
+/**
+ * 验证Manifest对象的语义正确性
+ *
+ * @param manifest 待验证的Manifest对象
+ * @returns 诊断错误数组（空数组表示验证通过）
+ */
+export function validateManifest(manifest) {
+    const diagnostics = [];
+    // 验证包名称格式（如果存在）
+    if (manifest.name) {
+        if (!/^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)*$/.test(manifest.name)) {
+            diagnostics.push(DiagnosticBuilder.error(DiagnosticCode.M003_InvalidPackageName)
+                .withMessage(`包名称格式无效：${manifest.name}（必须是小写字母、数字、下划线，用点号分隔）`)
+                .withPosition(dummyPosition())
+                .build());
+        }
+    }
+    // 验证版本格式（如果存在）
+    if (manifest.version) {
+        if (!/^\d+\.\d+\.\d+$/.test(manifest.version)) {
+            diagnostics.push(DiagnosticBuilder.error(DiagnosticCode.M004_InvalidVersion)
+                .withMessage(`版本格式无效：${manifest.version}（必须遵循 SemVer 格式，如 1.0.0）`)
+                .withPosition(dummyPosition())
+                .build());
+        }
+    }
+    // 验证依赖版本约束
+    if (manifest.dependencies) {
+        for (const [pkg, version] of Object.entries(manifest.dependencies)) {
+            if (!isValidVersionConstraint(version)) {
+                diagnostics.push(DiagnosticBuilder.error(DiagnosticCode.M005_InvalidVersionConstraint)
+                    .withMessage(`依赖 ${pkg} 的版本约束无效：${version}（支持 ^1.0.0、~1.0.0 或 1.0.0 格式）`)
+                    .withPosition(dummyPosition())
+                    .build());
+            }
+        }
+    }
+    // 验证开发依赖版本约束
+    if (manifest.devDependencies) {
+        for (const [pkg, version] of Object.entries(manifest.devDependencies)) {
+            if (!isValidVersionConstraint(version)) {
+                diagnostics.push(DiagnosticBuilder.error(DiagnosticCode.M005_InvalidVersionConstraint)
+                    .withMessage(`开发依赖 ${pkg} 的版本约束无效：${version}（支持 ^1.0.0、~1.0.0 或 1.0.0 格式）`)
+                    .withPosition(dummyPosition())
+                    .build());
+            }
+        }
+    }
+    // 验证effects格式（如果存在）
+    if (manifest.effects) {
+        for (const effect of manifest.effects) {
+            if (!/^[A-Z][a-zA-Z0-9]*$/.test(effect)) {
+                diagnostics.push(DiagnosticBuilder.error(DiagnosticCode.M006_InvalidEffectName)
+                    .withMessage(`效果名称格式无效：${effect}（必须是 PascalCase 格式，如 HttpRequest）`)
+                    .withPosition(dummyPosition())
+                    .build());
+            }
+        }
+    }
+    // 验证capabilities（如果存在）
+    if (manifest.capabilities) {
+        const validCapabilities = ['Http', 'Sql', 'Time', 'Files', 'Secrets', 'AiModel', 'Cpu'];
+        if (manifest.capabilities.allow) {
+            for (const cap of manifest.capabilities.allow) {
+                if (!validCapabilities.includes(cap)) {
+                    diagnostics.push(DiagnosticBuilder.error(DiagnosticCode.M008_InvalidCapability)
+                        .withMessage(`无效的能力声明：${cap}（有效值为：${validCapabilities.join(', ')}）`)
+                        .withPosition(dummyPosition())
+                        .build());
+                }
+            }
+        }
+        if (manifest.capabilities.deny) {
+            for (const cap of manifest.capabilities.deny) {
+                if (!validCapabilities.includes(cap)) {
+                    diagnostics.push(DiagnosticBuilder.error(DiagnosticCode.M008_InvalidCapability)
+                        .withMessage(`无效的能力声明：${cap}（有效值为：${validCapabilities.join(', ')}）`)
+                        .withPosition(dummyPosition())
+                        .build());
+                }
+            }
+        }
+    }
+    return diagnostics;
+}
+/**
+ * 检查版本约束是否有效
+ * 支持 ^1.0.0、~1.0.0 或 1.0.0 格式
+ */
+function isValidVersionConstraint(version) {
+    return /^(\^|~)?\d+\.\d+\.\d+$/.test(version);
+}
+/**
+ * 将ajv验证错误映射为Diagnostic
+ */
+function mapAjvErrorToDiagnostic(error, fieldPath, sourceData) {
+    const pos = dummyPosition();
+    const fieldValue = formatDiagnosticValue(sourceData, fieldPath);
+    switch (error.keyword) {
+        case 'pattern':
+            if (fieldPath.includes('/name')) {
+                return DiagnosticBuilder.error(DiagnosticCode.M003_InvalidPackageName)
+                    .withMessage(`包名称格式无效：${fieldValue}（必须是小写字母、数字、下划线，用点号分隔）`)
+                    .withPosition(pos)
+                    .build();
+            }
+            if (fieldPath.includes('/version')) {
+                return DiagnosticBuilder.error(DiagnosticCode.M004_InvalidVersion)
+                    .withMessage(`版本格式无效：${fieldValue}（必须遵循 SemVer 格式，如 1.0.0）`)
+                    .withPosition(pos)
+                    .build();
+            }
+            if (fieldPath.includes('/dependencies') || fieldPath.includes('/devDependencies')) {
+                return DiagnosticBuilder.error(DiagnosticCode.M005_InvalidVersionConstraint)
+                    .withMessage(`版本约束格式无效：${fieldValue}（支持 ^1.0.0、~1.0.0 或 1.0.0 格式）`)
+                    .withPosition(pos)
+                    .build();
+            }
+            if (fieldPath.includes('/effects')) {
+                return DiagnosticBuilder.error(DiagnosticCode.M006_InvalidEffectName)
+                    .withMessage(`效果名称格式无效：${fieldValue}（必须是 PascalCase 格式）`)
+                    .withPosition(pos)
+                    .build();
+            }
+            break;
+        case 'additionalProperties':
+            return DiagnosticBuilder.error(DiagnosticCode.M007_UnknownManifestField)
+                .withMessage(`未知的清单字段：${error.params.additionalProperty}`)
+                .withPosition(pos)
+                .build();
+        case 'enum':
+            if (fieldPath.includes('/capabilities')) {
+                return DiagnosticBuilder.error(DiagnosticCode.M008_InvalidCapability)
+                    .withMessage(`无效的能力声明：${fieldValue}（有效值为：Http、Sql、Time、Files、Secrets、AiModel、Cpu）`)
+                    .withPosition(pos)
+                    .build();
+            }
+            break;
+    }
+    // 默认错误
+    return DiagnosticBuilder.error(DiagnosticCode.M001_ManifestParseError)
+        .withMessage(`清单验证失败：${error.message || '未知错误'}（字段：${fieldPath}）`)
+        .withPosition(pos)
+        .build();
+}
+/**
+ * 创建占位位置信息
+ * manifest.json文件层面的错误无法精确定位到具体行列
+ */
+function dummyPosition() {
+    return { line: 1, col: 1 };
+}
+function formatDiagnosticValue(sourceData, fieldPath) {
+    const raw = resolveJsonPointer(sourceData, fieldPath);
+    if (raw === undefined) {
+        return 'undefined';
+    }
+    if (raw === null) {
+        return 'null';
+    }
+    if (typeof raw === 'string') {
+        return raw;
+    }
+    if (typeof raw === 'number' || typeof raw === 'boolean') {
+        return String(raw);
+    }
+    try {
+        return JSON.stringify(raw);
+    }
+    catch {
+        return String(raw);
+    }
+}
+function resolveJsonPointer(data, pointer) {
+    if (!pointer || pointer === '/') {
+        return data;
+    }
+    const segments = pointer
+        .split('/')
+        .filter(Boolean)
+        .map(segment => segment.replace(/~1/g, '/').replace(/~0/g, '~'));
+    let current = data;
+    for (const segment of segments) {
+        if (current && typeof current === 'object') {
+            const container = current;
+            current = container[segment];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+//# sourceMappingURL=manifest-parser.js.map

package/dist/src/package/manifest-parser.js.map

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

package/dist/src/package/package-cache.d.ts

@@ -0,0 +1,56 @@
+/**
+ * PackageCache 本地缓存管理器
+ *
+ * 提供包缓存的存储、验证与过期清理能力，支持离线模式。
+ */
+import { type Diagnostic } from '../diagnostics/diagnostics.js';
+export interface CacheConfig {
+    readonly cacheDir: string;
+    readonly ttl: number;
+    readonly maxSize?: number;
+}
+/**
+ * 基于文件系统的包缓存管理器
+ */
+export declare class PackageCache {
+    private readonly cacheDir;
+    private readonly ttl;
+    constructor(config: CacheConfig);
+    /**
+     * 检查指定包版本是否在缓存中且未过期
+     *
+     * @param packageName 包名称
+     * @param version 包版本
+     * @returns 缓存有效且未过期返回 true
+     */
+    isCached(packageName: string, version: string): boolean;
+    /**
+     * 获取指定包版本的缓存路径
+     *
+     * @param packageName 包名称
+     * @param version 包版本
+     * @returns 缓存目录路径
+     */
+    getCachePath(packageName: string, version: string): string;
+    /**
+     * 将 tarball 解压并添加到缓存
+     *
+     * @param tarballPath tarball 文件路径
+     * @param packageName 包名称
+     * @param version 包版本
+     */
+    addToCache(tarballPath: string, packageName: string, version: string): Promise<void | Diagnostic[]>;
+    /**
+     * 验证缓存完整性
+     *
+     * @param packageName 包名称
+     * @param version 包版本
+     * @returns 缓存有效且内容匹配返回 true
+     */
+    validateCache(packageName: string, version: string): Promise<boolean>;
+    /**
+     * 清理所有过期缓存
+     */
+    cleanExpired(): Promise<void>;
+}
+//# sourceMappingURL=package-cache.d.ts.map

package/dist/src/package/package-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-cache.d.ts","sourceRoot":"","sources":["../../../src/package/package-cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EACL,KAAK,UAAU,EAIhB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAOD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,MAAM,EAAE,WAAW;IAS/B;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAyBvD;;;;;;OAMG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAI1D;;;;;;OAMG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,UAAU,EAAE,CAAC;IAyCzG;;;;;;OAMG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAwB3E;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAiCpC"}

package/dist/src/package/package-cache.js

@@ -0,0 +1,166 @@
+/**
+ * PackageCache 本地缓存管理器
+ *
+ * 提供包缓存的存储、验证与过期清理能力，支持离线模式。
+ */
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { readFile, writeFile, readdir, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { extract } from 'tar';
+import { parseManifest } from './manifest-parser.js';
+import { DiagnosticCode, DiagnosticBuilder, dummyPosition, } from '../diagnostics/diagnostics.js';
+/**
+ * 基于文件系统的包缓存管理器
+ */
+export class PackageCache {
+    cacheDir;
+    ttl;
+    constructor(config) {
+        this.cacheDir = config.cacheDir;
+        this.ttl = config.ttl;
+        if (!existsSync(this.cacheDir)) {
+            mkdirSync(this.cacheDir, { recursive: true });
+        }
+    }
+    /**
+     * 检查指定包版本是否在缓存中且未过期
+     *
+     * @param packageName 包名称
+     * @param version 包版本
+     * @returns 缓存有效且未过期返回 true
+     */
+    isCached(packageName, version) {
+        const cachePath = this.getCachePath(packageName, version);
+        const manifestPath = join(cachePath, 'manifest.json');
+        const metadataPath = join(cachePath, '.cache-metadata.json');
+        if (!existsSync(manifestPath) || !existsSync(metadataPath)) {
+            return false;
+        }
+        try {
+            const metadataJson = readFileSync(metadataPath, 'utf-8');
+            const metadataContent = JSON.parse(metadataJson);
+            const cachedAt = metadataContent.cachedAt;
+            const now = Date.now();
+            if (now - cachedAt > this.ttl) {
+                return false;
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 获取指定包版本的缓存路径
+     *
+     * @param packageName 包名称
+     * @param version 包版本
+     * @returns 缓存目录路径
+     */
+    getCachePath(packageName, version) {
+        return join(this.cacheDir, packageName, version);
+    }
+    /**
+     * 将 tarball 解压并添加到缓存
+     *
+     * @param tarballPath tarball 文件路径
+     * @param packageName 包名称
+     * @param version 包版本
+     */
+    async addToCache(tarballPath, packageName, version) {
+        const cachePath = this.getCachePath(packageName, version);
+        try {
+            mkdirSync(cachePath, { recursive: true });
+            await extract({
+                file: tarballPath,
+                cwd: cachePath,
+            });
+            const manifestPath = join(cachePath, 'manifest.json');
+            if (!existsSync(manifestPath)) {
+                return [
+                    DiagnosticBuilder.error(DiagnosticCode.C004_ManifestMissing)
+                        .withMessage(`解压后未找到 manifest.json：${cachePath}`)
+                        .withPosition(dummyPosition())
+                        .build()
+                ];
+            }
+            const metadata = {
+                cachedAt: Date.now(),
+                version,
+            };
+            const metadataPath = join(cachePath, '.cache-metadata.json');
+            await writeFile(metadataPath, JSON.stringify(metadata, null, 2), 'utf-8');
+            return undefined;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return [
+                DiagnosticBuilder.error(DiagnosticCode.C002_ExtractionFailed)
+                    .withMessage(`缓存添加失败：${message}`)
+                    .withPosition(dummyPosition())
+                    .build()
+            ];
+        }
+    }
+    /**
+     * 验证缓存完整性
+     *
+     * @param packageName 包名称
+     * @param version 包版本
+     * @returns 缓存有效且内容匹配返回 true
+     */
+    async validateCache(packageName, version) {
+        const cachePath = this.getCachePath(packageName, version);
+        const manifestPath = join(cachePath, 'manifest.json');
+        if (!existsSync(manifestPath)) {
+            return false;
+        }
+        try {
+            const manifest = parseManifest(manifestPath);
+            if (Array.isArray(manifest)) {
+                return false;
+            }
+            if (manifest.name !== packageName || manifest.version !== version) {
+                return false;
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 清理所有过期缓存
+     */
+    async cleanExpired() {
+        try {
+            const packageDirs = await readdir(this.cacheDir);
+            for (const packageName of packageDirs) {
+                const packagePath = join(this.cacheDir, packageName);
+                const versionDirs = await readdir(packagePath);
+                for (const version of versionDirs) {
+                    const metadataPath = join(packagePath, version, '.cache-metadata.json');
+                    if (!existsSync(metadataPath)) {
+                        continue;
+                    }
+                    try {
+                        const metadataContent = await readFile(metadataPath, 'utf-8');
+                        const metadata = JSON.parse(metadataContent);
+                        const now = Date.now();
+                        if (now - metadata.cachedAt > this.ttl) {
+                            const cachePath = join(packagePath, version);
+                            await rm(cachePath, { recursive: true, force: true });
+                        }
+                    }
+                    catch {
+                        // 忽略元数据读取错误，继续处理下一个
+                    }
+                }
+            }
+        }
+        catch {
+            // 忽略清理错误
+        }
+    }
+}
+//# sourceMappingURL=package-cache.js.map

package/dist/src/package/package-cache.js.map

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

package/dist/src/package/package-installer.d.ts

@@ -0,0 +1,67 @@
+import { PackageRegistry } from './package-registry.js';
+import { PackageCache } from './package-cache.js';
+import type { ModuleCache } from '../lsp/module_cache.js';
+import { type Diagnostic } from '../diagnostics/diagnostics.js';
+/**
+ * PackageInstaller 包安装协调器
+ *
+ * 职责：
+ * - 协调 PackageRegistry 和 PackageCache
+ * - 实现完整的包安装流程（查询、下载、解压、验证）
+ * - 支持单包安装、批量安装、离线模式
+ * - 更新 lockfile 并刷新 module_cache
+ */
+export declare class PackageInstaller {
+    private readonly registry;
+    private readonly cache;
+    private readonly moduleCache?;
+    private readonly tempDir;
+    private readonly lockfilePath;
+    private readonly concurrencyLimit;
+    constructor(registry: PackageRegistry, cache: PackageCache, moduleCache?: ModuleCache | undefined, tempDir?: string, lockfilePath?: string);
+    /**
+     * 安装单个包
+     *
+     * @param packageName - 包名称
+     * @param versionConstraint - 版本约束（例如 "^1.0.0", "1.2.3"）
+     * @returns 已安装的版本号，或 Diagnostic[]
+     */
+    install(packageName: string, versionConstraint: string): Promise<string | Diagnostic[]>;
+    /**
+     * 批量安装（支持依赖解析）
+     *
+     * @param packages - 包名到版本约束的映射
+     * @returns 包名到已安装版本的映射，或 Diagnostic[]
+     */
+    installMany(packages: Map<string, string>): Promise<Map<string, string> | Diagnostic[]>;
+    /**
+     * 离线模式安装（仅使用缓存）
+     *
+     * @param packageName - 包名称
+     * @param version - 精确版本号
+     * @returns 版本号，或 Diagnostic[]
+     */
+    installOffline(packageName: string, version: string): Promise<string | Diagnostic[]>;
+    /**
+     * 收集所有传递依赖
+     *
+     * @param installedVersions - 已安装的包
+     * @returns 依赖名称到版本约束的映射
+     */
+    private collectAllDependencies;
+    /**
+     * 计算文件的 SHA256 哈希值
+     *
+     * @param filePath - 文件路径
+     * @returns SHA256 哈希值（十六进制字符串）
+     */
+    private calculateHash;
+    /**
+     * 判断版本约束是否为精确版本
+     *
+     * @param versionConstraint - 版本约束
+     * @returns 是否为精确版本
+     */
+    private isExactVersion;
+}
+//# sourceMappingURL=package-installer.d.ts.map

package/dist/src/package/package-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-installer.d.ts","sourceRoot":"","sources":["../../../src/package/package-installer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKlD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EACL,KAAK,UAAU,EAIhB,MAAM,+BAA+B,CAAC;AAMvC;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAMzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAP/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAa;gBAG3B,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,YAAY,EACnB,WAAW,CAAC,EAAE,WAAW,YAAA,EAC1C,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM;IASvB;;;;;;OAMG;IACG,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;IAkG7F;;;;;OAKG;IACG,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IAuG7F;;;;;;OAMG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;IA+B1F;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;;;;OAKG;YACW,aAAa;IAmB3B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;CAIvB"}