tanmi-dock 0.4.0-beta.1

package/dist/core/linker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linker.d.ts","sourceRoot":"","sources":["../../src/core/linker.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ1E;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOlE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMvE;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5D;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAcpE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAW9F;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,UAAQ,GACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2CxB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAcrE;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC,CAkB5D;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC,CA8Cf;;;;;;;;;;;;;;AAED,wBAYE"}

package/dist/core/linker.js

@@ -0,0 +1,263 @@
+/**
+ * 符号链接操作
+ * - macOS: 使用 symlink
+ * - Windows: 使用 junction (无需管理员权限)
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import { isWindows, KNOWN_PLATFORM_VALUES } from './platform.js';
+import { copyDir } from '../utils/fs-utils.js';
+/**
+ * 创建符号链接
+ * @param target 目标路径（链接指向的位置）
+ * @param linkPath 链接路径（创建链接的位置）
+ */
+export async function link(target, linkPath) {
+    // 确保父目录存在
+    const parentDir = path.dirname(linkPath);
+    await fs.mkdir(parentDir, { recursive: true });
+    // Windows 使用 junction，macOS 使用 dir 类型的 symlink
+    const type = isWindows() ? 'junction' : 'dir';
+    await fs.symlink(target, linkPath, type);
+}
+/**
+ * 检查路径是否为符号链接
+ */
+export async function isSymlink(linkPath) {
+    try {
+        const stat = await fs.lstat(linkPath);
+        return stat.isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 读取符号链接目标
+ */
+export async function readLink(linkPath) {
+    try {
+        return await fs.readlink(linkPath);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 删除符号链接
+ */
+export async function unlink(linkPath) {
+    // 在 Windows 上，junction 需要用 rmdir 删除
+    // 但 fs.unlink 在 Node.js 中可以处理符号链接
+    try {
+        const stat = await fs.lstat(linkPath);
+        if (stat.isSymbolicLink()) {
+            await fs.unlink(linkPath);
+        }
+    }
+    catch {
+        // 链接不存在，忽略
+    }
+}
+/**
+ * 检查符号链接是否有效（目标存在）
+ */
+export async function isValidLink(linkPath) {
+    try {
+        // lstat 检查链接本身是否存在
+        const lstat = await fs.lstat(linkPath);
+        if (!lstat.isSymbolicLink()) {
+            return false;
+        }
+        // stat 检查链接目标是否存在（会跟随链接）
+        await fs.stat(linkPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 检查符号链接是否指向正确的目标
+ */
+export async function isCorrectLink(linkPath, expectedTarget) {
+    const actualTarget = await readLink(linkPath);
+    if (!actualTarget) {
+        return false;
+    }
+    // 规范化路径后比较
+    const normalizedActual = path.resolve(path.dirname(linkPath), actualTarget);
+    const normalizedExpected = path.resolve(expectedTarget);
+    return normalizedActual === normalizedExpected;
+}
+/**
+ * 将普通目录替换为符号链接
+ * @param dirPath 要替换的目录路径
+ * @param target 链接目标
+ * @param backup 是否备份原目录（默认删除）
+ * @returns 备份路径（如果有）
+ */
+export async function replaceWithLink(dirPath, target, backup = false) {
+    // 检查是否已经是正确的链接
+    if (await isCorrectLink(dirPath, target)) {
+        return null;
+    }
+    // 如果是链接但指向错误，先删除
+    if (await isSymlink(dirPath)) {
+        await unlink(dirPath);
+        await link(target, dirPath);
+        return null;
+    }
+    // 检查目录是否存在
+    try {
+        const stat = await fs.lstat(dirPath);
+        if (!stat.isDirectory()) {
+            throw new Error(`路径不是目录: ${dirPath}`);
+        }
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            // 目录不存在，直接创建链接
+            await link(target, dirPath);
+            return null;
+        }
+        throw err;
+    }
+    let backupPath = null;
+    if (backup) {
+        // 备份目录
+        backupPath = `${dirPath}.backup.${Date.now()}`;
+        await fs.rename(dirPath, backupPath);
+    }
+    else {
+        // 删除目录
+        await fs.rm(dirPath, { recursive: true, force: true });
+    }
+    // 创建链接
+    await link(target, dirPath);
+    return backupPath;
+}
+/**
+ * 将符号链接还原为普通目录（从目标复制内容）
+ */
+export async function restoreFromLink(linkPath) {
+    const target = await readLink(linkPath);
+    if (!target) {
+        throw new Error(`不是符号链接: ${linkPath}`);
+    }
+    // 获取绝对目标路径
+    const absoluteTarget = path.resolve(path.dirname(linkPath), target);
+    // 删除链接
+    await unlink(linkPath);
+    // 复制目标内容（保留符号链接）
+    await copyDir(absoluteTarget, linkPath, { preserveSymlinks: true });
+}
+/**
+ * 检查路径状态
+ */
+export async function getPathStatus(localPath, expectedTarget) {
+    try {
+        const lstat = await fs.lstat(localPath);
+        if (lstat.isSymbolicLink()) {
+            const isCorrect = await isCorrectLink(localPath, expectedTarget);
+            return isCorrect ? 'linked' : 'wrong_link';
+        }
+        if (lstat.isDirectory()) {
+            return 'directory';
+        }
+        // 其他情况视为 missing
+        return 'missing';
+    }
+    catch {
+        return 'missing';
+    }
+}
+/**
+ * 链接库到项目（自动选择单平台/多平台策略）
+ * @param localPath 本地路径 (3rdparty/libXxx)
+ * @param storePath Store 根路径
+ * @param libName 库名
+ * @param commit commit hash
+ * @param platforms 选择的平台列表
+ */
+export async function linkLibrary(localPath, storePath, libName, commit, platforms) {
+    if (platforms.length === 0) {
+        throw new Error('至少需要一个平台');
+    }
+    if (platforms.length === 1) {
+        // 单平台：直接链接到平台目录
+        const target = path.join(storePath, libName, commit, platforms[0]);
+        await replaceWithLink(localPath, target);
+    }
+    else {
+        // 多平台：调用组合链接（3-2 实现）
+        await linkMultiPlatform(localPath, storePath, libName, commit, platforms);
+    }
+}
+/**
+ * 多平台组合链接
+ * 创建真实目录，内部分别链接各平台内容和共享内容
+ * @param localPath 本地路径
+ * @param storePath Store 根路径
+ * @param libName 库名
+ * @param commit commit hash
+ * @param platforms 平台列表
+ */
+export async function linkMultiPlatform(localPath, storePath, libName, commit, platforms) {
+    // 1. 删除旧链接/目录，创建真实目录
+    await fs.rm(localPath, { recursive: true, force: true });
+    await fs.mkdir(localPath, { recursive: true });
+    // 2. 取第一个平台作为共享内容来源
+    const primaryPlatform = platforms[0];
+    const primaryPath = path.join(storePath, libName, commit, primaryPlatform);
+    // 3. 遍历主平台目录内容
+    const entries = await fs.readdir(primaryPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const linkPath = path.join(localPath, entry.name);
+        if (KNOWN_PLATFORM_VALUES.includes(entry.name)) {
+            // 平台目录：检查是否在选择列表中
+            if (platforms.includes(entry.name)) {
+                // 链接到对应 store 平台目录下的平台子目录
+                const target = path.join(storePath, libName, commit, entry.name, entry.name);
+                await link(target, linkPath);
+            }
+        }
+        else {
+            // 共享内容：链接到主平台
+            const target = path.join(primaryPath, entry.name);
+            await link(target, linkPath);
+        }
+    }
+    // 4. 链接其他平台的平台目录（如果主平台没有）
+    for (const platform of platforms.slice(1)) {
+        if (!KNOWN_PLATFORM_VALUES.includes(platform))
+            continue;
+        const linkPath = path.join(localPath, platform);
+        // 如果还没链接（主平台可能已处理）
+        if (!(await isSymlink(linkPath))) {
+            const platformPath = path.join(storePath, libName, commit, platform, platform);
+            // 检查目标是否存在
+            try {
+                await fs.access(platformPath);
+                await link(platformPath, linkPath);
+            }
+            catch {
+                // 目标不存在，跳过
+            }
+        }
+    }
+}
+export default {
+    link,
+    isSymlink,
+    readLink,
+    unlink,
+    isValidLink,
+    isCorrectLink,
+    replaceWithLink,
+    restoreFromLink,
+    getPathStatus,
+    linkLibrary,
+    linkMultiPlatform,
+};
+//# sourceMappingURL=linker.js.map

package/dist/core/linker.js.map

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

package/dist/core/parser.d.ts

@@ -0,0 +1,43 @@
+import type { CodepacDep, ParsedDependency } from '../types/index.js';
+/**
+ * 查找 codepac 配置文件
+ * @param projectPath 项目路径
+ * @returns 配置文件路径，不存在返回 null
+ */
+export declare function findCodepacConfig(projectPath: string): Promise<string | null>;
+/**
+ * 解析 codepac-dep.json 配置文件
+ * @param configPath 配置文件路径
+ * @returns 解析后的配置对象
+ * @throws 文件不存在或格式错误时抛出异常
+ */
+export declare function parseCodepacDep(configPath: string): Promise<CodepacDep>;
+/**
+ * 从配置中提取依赖列表
+ * @param config 配置对象
+ * @returns 依赖列表
+ */
+export declare function extractDependencies(config: CodepacDep): ParsedDependency[];
+/**
+ * 解析项目依赖（便捷方法）
+ * @param projectPath 项目路径
+ * @returns 依赖列表和配置路径
+ * @throws 找不到配置文件或解析失败时抛出异常
+ */
+export declare function parseProjectDependencies(projectPath: string): Promise<{
+    dependencies: ParsedDependency[];
+    configPath: string;
+}>;
+/**
+ * 获取配置文件相对于项目的路径
+ */
+export declare function getRelativeConfigPath(projectPath: string, configPath: string): string;
+declare const _default: {
+    findCodepacConfig: typeof findCodepacConfig;
+    parseCodepacDep: typeof parseCodepacDep;
+    extractDependencies: typeof extractDependencies;
+    parseProjectDependencies: typeof parseProjectDependencies;
+    getRelativeConfigPath: typeof getRelativeConfigPath;
+};
+export default _default;
+//# sourceMappingURL=parser.d.ts.map

package/dist/core/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/core/parser.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAYtE;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWnF;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAoB7E;AA6CD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,EAAE,CAQ1E;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAWnE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAErF;;;;;;;;AAED,wBAME"}

package/dist/core/parser.js

@@ -0,0 +1,133 @@
+/**
+ * codepac-dep.json 解析器
+ */
+import fs from 'fs/promises';
+import path from 'path';
+/**
+ * codepac 配置文件名
+ */
+const CONFIG_FILENAME = 'codepac-dep.json';
+/**
+ * 搜索配置文件的目录列表
+ */
+const SEARCH_DIRS = ['3rdparty', '.'];
+/**
+ * 查找 codepac 配置文件
+ * @param projectPath 项目路径
+ * @returns 配置文件路径，不存在返回 null
+ */
+export async function findCodepacConfig(projectPath) {
+    for (const dir of SEARCH_DIRS) {
+        const configPath = path.join(projectPath, dir, CONFIG_FILENAME);
+        try {
+            await fs.access(configPath);
+            return configPath;
+        }
+        catch {
+            // 继续搜索
+        }
+    }
+    return null;
+}
+/**
+ * 解析 codepac-dep.json 配置文件
+ * @param configPath 配置文件路径
+ * @returns 解析后的配置对象
+ * @throws 文件不存在或格式错误时抛出异常
+ */
+export async function parseCodepacDep(configPath) {
+    let content;
+    try {
+        content = await fs.readFile(configPath, 'utf-8');
+    }
+    catch (_err) {
+        throw new Error(`无法读取配置文件: ${configPath}`);
+    }
+    let config;
+    try {
+        config = JSON.parse(content);
+    }
+    catch {
+        throw new Error(`配置文件格式错误 (JSON 解析失败): ${configPath}`);
+    }
+    // 验证配置结构
+    validateCodepacDep(config, configPath);
+    return config;
+}
+/**
+ * 验证 codepac-dep.json 配置结构
+ */
+function validateCodepacDep(config, configPath) {
+    if (!config || typeof config !== 'object') {
+        throw new Error(`配置文件格式错误: 期望对象类型 (${configPath})`);
+    }
+    const obj = config;
+    // 验证 version
+    if (typeof obj.version !== 'string') {
+        throw new Error(`配置文件格式错误: 缺少 version 字段 (${configPath})`);
+    }
+    // 验证 repos
+    if (!obj.repos || typeof obj.repos !== 'object') {
+        throw new Error(`配置文件格式错误: 缺少 repos 字段 (${configPath})`);
+    }
+    const repos = obj.repos;
+    if (!Array.isArray(repos.common)) {
+        throw new Error(`配置文件格式错误: repos.common 必须是数组 (${configPath})`);
+    }
+    // 验证每个 repo 配置
+    for (let i = 0; i < repos.common.length; i++) {
+        const repo = repos.common[i];
+        if (!repo || typeof repo !== 'object') {
+            throw new Error(`配置文件格式错误: repos.common[${i}] 必须是对象 (${configPath})`);
+        }
+        const required = ['url', 'commit', 'branch', 'dir'];
+        for (const field of required) {
+            if (typeof repo[field] !== 'string') {
+                throw new Error(`配置文件格式错误: repos.common[${i}].${field} 必须是字符串 (${configPath})`);
+            }
+        }
+    }
+}
+/**
+ * 从配置中提取依赖列表
+ * @param config 配置对象
+ * @returns 依赖列表
+ */
+export function extractDependencies(config) {
+    return config.repos.common.map((repo) => ({
+        libName: repo.dir,
+        commit: repo.commit,
+        branch: repo.branch,
+        url: repo.url,
+        sparse: repo.sparse,
+    }));
+}
+/**
+ * 解析项目依赖（便捷方法）
+ * @param projectPath 项目路径
+ * @returns 依赖列表和配置路径
+ * @throws 找不到配置文件或解析失败时抛出异常
+ */
+export async function parseProjectDependencies(projectPath) {
+    const configPath = await findCodepacConfig(projectPath);
+    if (!configPath) {
+        throw new Error(`找不到 codepac-dep.json 配置文件，已搜索: ${SEARCH_DIRS.join(', ')}`);
+    }
+    const config = await parseCodepacDep(configPath);
+    const dependencies = extractDependencies(config);
+    return { dependencies, configPath };
+}
+/**
+ * 获取配置文件相对于项目的路径
+ */
+export function getRelativeConfigPath(projectPath, configPath) {
+    return path.relative(projectPath, configPath);
+}
+export default {
+    findCodepacConfig,
+    parseCodepacDep,
+    extractDependencies,
+    parseProjectDependencies,
+    getRelativeConfigPath,
+};
+//# sourceMappingURL=parser.js.map

package/dist/core/parser.js.map

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

package/dist/core/platform.d.ts

@@ -0,0 +1,100 @@
+import type { Platform } from '../types/index.js';
+/**
+ * 平台选项定义
+ */
+export interface PlatformOption {
+    key: string;
+    value: string;
+    asan?: string;
+    hwasan?: string;
+}
+/**
+ * 支持的平台列表
+ */
+export declare const PLATFORM_OPTIONS: PlatformOption[];
+/**
+ * 通过 key 获取平台选项
+ */
+export declare function getPlatformOption(key: string): PlatformOption | undefined;
+/**
+ * 通过 value 获取平台选项
+ */
+export declare function getPlatformOptionByValue(value: string): PlatformOption | undefined;
+/**
+ * key 转换为 value
+ */
+export declare function platformKeyToValue(key: string): string | undefined;
+/**
+ * 获取所有平台 keys
+ */
+export declare function getAllPlatformKeys(): string[];
+/**
+ * 已知平台目录名列表 (用于多平台链接时识别平台子目录)
+ */
+export declare const KNOWN_PLATFORM_VALUES: string[];
+/**
+ * 获取配置目录路径 (固定位置)
+ * - macOS: ~/.tanmi-dock
+ * - Windows: %USERPROFILE%\.tanmi-dock
+ */
+export declare function getConfigDir(): string;
+/**
+ * 获取配置文件路径
+ */
+export declare function getConfigPath(): string;
+/**
+ * 获取注册表文件路径
+ */
+export declare function getRegistryPath(): string;
+/**
+ * 获取当前平台
+ */
+export declare function getPlatform(): Platform;
+/**
+ * 判断是否为 Windows
+ */
+export declare function isWindows(): boolean;
+/**
+ * 判断是否为 macOS
+ */
+export declare function isMacOS(): boolean;
+/**
+ * 规范化路径分隔符
+ */
+export declare function normalizePath(p: string): string;
+/**
+ * 展开 ~ 为用户主目录
+ */
+export declare function expandHome(p: string): string;
+/**
+ * 收缩路径，将用户主目录替换为 ~
+ */
+export declare function shrinkHome(p: string): string;
+/**
+ * 获取路径的绝对路径
+ */
+export declare function resolvePath(p: string): string;
+/**
+ * 判断路径是否为绝对路径
+ */
+export declare function isAbsolutePath(p: string): boolean;
+/**
+ * 连接路径
+ */
+export declare function joinPath(...parts: string[]): string;
+/**
+ * 路径安全检查结果
+ */
+export interface PathSafetyResult {
+    safe: boolean;
+    reason?: string;
+}
+/**
+ * 检查路径是否安全
+ */
+export declare function isPathSafe(p: string): PathSafetyResult;
+/**
+ * 确保路径安全，不安全时抛出错误
+ */
+export declare function ensurePathSafe(p: string): string;
+//# sourceMappingURL=platform.d.ts.map

package/dist/core/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/core/platform.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIlD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAQ5C,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEzE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAIlF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,EAQzC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEnD;AAeD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA2CtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAMhD"}