tanmi-dock 0.4.0-beta.1

package/dist/core/codepac.js

@@ -0,0 +1,188 @@
+/**
+ * codepac 命令封装
+ * 提供对 codepac CLI 工具的调用接口
+ */
+import { exec, spawn } from 'child_process';
+import { promisify } from 'util';
+import path from 'path';
+const execAsync = promisify(exec);
+/**
+ * codepac 命令名称
+ */
+const CODEPAC_CMD = 'codepac';
+/**
+ * 检查 codepac 是否已安装
+ */
+export async function isCodepacInstalled() {
+    try {
+        await execAsync(`${CODEPAC_CMD} --version`, { encoding: 'utf8' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 获取 codepac 版本
+ */
+export async function getVersion() {
+    try {
+        const { stdout } = await execAsync(`${CODEPAC_CMD} --version`, { encoding: 'utf8' });
+        return stdout.trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 使用 codepac 安装依赖
+ */
+export async function install(options) {
+    const { configPath, targetDir, platform, onProgress, silent } = options;
+    // 检查 codepac 是否安装
+    if (!(await isCodepacInstalled())) {
+        throw new Error('codepac 未安装，请先安装 codepac 工具');
+    }
+    // 构建命令参数
+    const args = ['install', '-c', configPath, '-d', targetDir];
+    // 添加平台参数
+    if (platform) {
+        args.push('-p', platform);
+    }
+    return new Promise((resolve, reject) => {
+        const proc = spawn(CODEPAC_CMD, args, {
+            cwd: path.dirname(configPath),
+            stdio: silent ? 'ignore' : 'pipe',
+        });
+        let stderr = '';
+        if (proc.stdout && onProgress) {
+            proc.stdout.on('data', (data) => {
+                const message = data.toString().trim();
+                if (message) {
+                    onProgress(message);
+                }
+            });
+        }
+        if (proc.stderr) {
+            proc.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+        }
+        proc.on('error', (err) => {
+            reject(new Error(`无法执行 codepac 命令: ${err.message}`));
+        });
+        proc.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                const errorMsg = stderr.trim() || `codepac 命令执行失败，退出码: ${code}`;
+                reject(new Error(errorMsg));
+            }
+        });
+    });
+}
+/**
+ * 使用 codepac 安装单个库
+ * 注意：这需要 codepac 支持单库安装，如果不支持则需要创建临时配置文件
+ */
+export async function installSingle(options) {
+    const { url, commit, branch, targetDir, platform, sparse, onProgress, silent } = options;
+    // 检查 codepac 是否安装
+    if (!(await isCodepacInstalled())) {
+        throw new Error('codepac 未安装，请先安装 codepac 工具');
+    }
+    // 创建临时配置
+    const fs = await import('fs/promises');
+    const os = await import('os');
+    const tempDir = os.tmpdir();
+    const tempConfigPath = path.join(tempDir, `codepac-temp-${Date.now()}.json`);
+    const tempConfig = {
+        version: '1.0.0',
+        repos: {
+            common: [
+                {
+                    url,
+                    commit,
+                    branch,
+                    dir: path.basename(targetDir),
+                    ...(sparse && { sparse }),
+                },
+            ],
+        },
+    };
+    try {
+        await fs.writeFile(tempConfigPath, JSON.stringify(tempConfig, null, 2), 'utf-8');
+        await install({
+            configPath: tempConfigPath,
+            targetDir: path.dirname(targetDir),
+            platform,
+            onProgress,
+            silent,
+        });
+    }
+    finally {
+        // 清理临时文件
+        try {
+            await fs.unlink(tempConfigPath);
+        }
+        catch {
+            // 忽略清理错误
+        }
+    }
+}
+/**
+ * 更新依赖
+ */
+export async function update(options) {
+    const { configPath, targetDir, libName, onProgress } = options;
+    // 检查 codepac 是否安装
+    if (!(await isCodepacInstalled())) {
+        throw new Error('codepac 未安装，请先安装 codepac 工具');
+    }
+    // 构建命令参数
+    const args = ['update', '-c', configPath, '-d', targetDir];
+    if (libName) {
+        args.push('-n', libName);
+    }
+    return new Promise((resolve, reject) => {
+        const proc = spawn(CODEPAC_CMD, args, {
+            cwd: path.dirname(configPath),
+            stdio: 'pipe',
+        });
+        let stderr = '';
+        if (proc.stdout && onProgress) {
+            proc.stdout.on('data', (data) => {
+                const message = data.toString().trim();
+                if (message) {
+                    onProgress(message);
+                }
+            });
+        }
+        if (proc.stderr) {
+            proc.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+        }
+        proc.on('error', (err) => {
+            reject(new Error(`无法执行 codepac 命令: ${err.message}`));
+        });
+        proc.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                const errorMsg = stderr.trim() || `codepac update 命令执行失败，退出码: ${code}`;
+                reject(new Error(errorMsg));
+            }
+        });
+    });
+}
+export default {
+    isCodepacInstalled,
+    getVersion,
+    install,
+    installSingle,
+    update,
+};
+//# sourceMappingURL=codepac.js.map

package/dist/core/codepac.js.map

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

package/dist/core/config.d.ts

@@ -0,0 +1,70 @@
+import type { DockConfig, CleanStrategy } from '../types/index.js';
+/**
+ * 获取默认配置
+ */
+export declare function getDefaultConfig(storePath: string): DockConfig;
+/**
+ * 确保配置目录存在
+ */
+export declare function ensureConfigDir(): Promise<void>;
+/**
+ * 配置版本状态
+ */
+export type ConfigVersionStatus = 'current' | 'migrate' | 'unsupported';
+/**
+ * 检查配置版本
+ */
+export declare function checkConfigVersion(config: DockConfig): ConfigVersionStatus;
+/**
+ * 加载配置
+ * 文件不存在时返回 null
+ * 版本不兼容时抛出错误
+ */
+export declare function load(): Promise<DockConfig | null>;
+/**
+ * 保存配置（带文件锁保护）
+ */
+export declare function save(config: DockConfig): Promise<void>;
+/**
+ * 获取单个配置项
+ */
+export declare function get<K extends keyof DockConfig>(key: K): Promise<DockConfig[K] | undefined>;
+/**
+ * 设置单个配置项并保存（带文件锁保护读-改-写操作）
+ */
+export declare function set<K extends keyof DockConfig>(key: K, value: DockConfig[K]): Promise<void>;
+/**
+ * 获取 Store 路径
+ */
+export declare function getStorePath(): Promise<string | undefined>;
+/**
+ * 设置 Store 路径
+ */
+export declare function setStorePath(path: string): Promise<void>;
+/**
+ * 验证配置项名称是否有效
+ */
+export declare function isValidConfigKey(key: string): key is keyof DockConfig;
+/**
+ * 验证 cleanStrategy 值是否有效
+ */
+export declare function isValidCleanStrategy(value: string): value is CleanStrategy;
+/**
+ * 解析配置值
+ */
+export declare function parseConfigValue(key: keyof DockConfig, value: string): DockConfig[keyof DockConfig];
+declare const _default: {
+    load: typeof load;
+    save: typeof save;
+    get: typeof get;
+    set: typeof set;
+    getDefaultConfig: typeof getDefaultConfig;
+    ensureConfigDir: typeof ensureConfigDir;
+    getStorePath: typeof getStorePath;
+    setStorePath: typeof setStorePath;
+    isValidConfigKey: typeof isValidConfigKey;
+    isValidCleanStrategy: typeof isValidCleanStrategy;
+    parseConfigValue: typeof parseConfigValue;
+};
+export default _default;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGnE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAM9D;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAGrD;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;AAExE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,mBAAmB,CAa1E;AAED;;;;GAIG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAsBvD;AAwDD;;GAEG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5D;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,CAAC,SAAS,MAAM,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAGhG;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,CAAC,SAAS,MAAM,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAYjG;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAEhE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,MAAM,UAAU,CAUrE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAE1E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,UAAU,EACrB,KAAK,EAAE,MAAM,GACZ,UAAU,CAAC,MAAM,UAAU,CAAC,CAe9B;;;;;;;;;;;;;;AAED,wBAYE"}

package/dist/core/config.js

@@ -0,0 +1,210 @@
+/**
+ * 全局配置管理
+ * 配置文件位置: ~/.tanmi-dock/config.json
+ */
+import fs from 'fs/promises';
+import semver from 'semver';
+import { getConfigPath, getConfigDir, expandHome } from './platform.js';
+import { withFileLock } from '../utils/lock.js';
+import { DEFAULT_CONFIG, CURRENT_CONFIG_VERSION, MIN_SUPPORTED_VERSION } from '../types/index.js';
+/**
+ * 获取默认配置
+ */
+export function getDefaultConfig(storePath) {
+    return {
+        ...DEFAULT_CONFIG,
+        initialized: true,
+        storePath: expandHome(storePath),
+    };
+}
+/**
+ * 确保配置目录存在
+ */
+export async function ensureConfigDir() {
+    const dir = getConfigDir();
+    await fs.mkdir(dir, { recursive: true });
+}
+/**
+ * 检查配置版本
+ */
+export function checkConfigVersion(config) {
+    const version = config.version || '1.0.0';
+    if (semver.eq(version, CURRENT_CONFIG_VERSION)) {
+        return 'current'; // 版本一致
+    }
+    if (semver.lt(version, CURRENT_CONFIG_VERSION) && semver.gte(version, MIN_SUPPORTED_VERSION)) {
+        return 'migrate'; // 需要迁移
+    }
+    if (semver.gt(version, CURRENT_CONFIG_VERSION)) {
+        return 'unsupported'; // 配置版本高于程序，需升级程序
+    }
+    return 'unsupported';
+}
+/**
+ * 加载配置
+ * 文件不存在时返回 null
+ * 版本不兼容时抛出错误
+ */
+export async function load() {
+    try {
+        const configPath = getConfigPath();
+        const content = await fs.readFile(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        const versionStatus = checkConfigVersion(config);
+        if (versionStatus === 'unsupported') {
+            throw new Error(`配置版本 ${config.version} 高于程序支持版本 ${CURRENT_CONFIG_VERSION}，请升级 tanmi-dock`);
+        }
+        if (versionStatus === 'migrate') {
+            return await migrateConfig(config);
+        }
+        return config;
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes('配置版本')) {
+            throw err; // 重新抛出版本错误
+        }
+        return null;
+    }
+}
+/**
+ * 迁移函数映射: 从哪个版本迁移
+ */
+const migrations = {
+    '1.0.0': (config) => {
+        // v1.0.0 → v1.1.0 的迁移逻辑
+        return {
+            ...config,
+            version: '1.1.0',
+            // 未来可在此添加新字段的默认值
+        };
+    },
+};
+/**
+ * 迁移配置到最新版本
+ * 逐版本迁移，出错时保留原配置
+ */
+async function migrateConfig(config) {
+    const originalVersion = config.version || '1.0.0';
+    let current = { ...config };
+    let version = originalVersion;
+    try {
+        // 逐版本迁移
+        while (version !== CURRENT_CONFIG_VERSION) {
+            const migrateFn = migrations[version];
+            if (!migrateFn) {
+                throw new Error(`无法从版本 ${version} 迁移，缺少迁移函数`);
+            }
+            console.log(`[info] 迁移配置: ${version} → ...`);
+            current = migrateFn(current);
+            version = current.version;
+        }
+        // 保存迁移后的配置
+        const migrated = current;
+        await save(migrated);
+        console.log(`[ok] 配置已从 ${originalVersion} 迁移到 ${CURRENT_CONFIG_VERSION}`);
+        return migrated;
+    }
+    catch (err) {
+        console.error(`[err] 配置迁移失败: ${err.message}`);
+        console.log('[info] 保留原配置不覆盖');
+        return config;
+    }
+}
+/**
+ * 保存配置（带文件锁保护）
+ */
+export async function save(config) {
+    await ensureConfigDir();
+    const configPath = getConfigPath();
+    await withFileLock(configPath, async () => {
+        await fs.writeFile(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    });
+}
+/**
+ * 获取单个配置项
+ */
+export async function get(key) {
+    const config = await load();
+    return config?.[key];
+}
+/**
+ * 设置单个配置项并保存（带文件锁保护读-改-写操作）
+ */
+export async function set(key, value) {
+    await ensureConfigDir();
+    const configPath = getConfigPath();
+    await withFileLock(configPath, async () => {
+        const content = await fs.readFile(configPath, 'utf-8').catch(() => null);
+        if (!content) {
+            throw new Error('配置文件不存在，请先运行 tanmi-dock init');
+        }
+        const config = JSON.parse(content);
+        config[key] = value;
+        await fs.writeFile(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    });
+}
+/**
+ * 获取 Store 路径
+ */
+export async function getStorePath() {
+    return get('storePath');
+}
+/**
+ * 设置 Store 路径
+ */
+export async function setStorePath(path) {
+    await set('storePath', expandHome(path));
+}
+/**
+ * 验证配置项名称是否有效
+ */
+export function isValidConfigKey(key) {
+    const validKeys = [
+        'version',
+        'initialized',
+        'storePath',
+        'cleanStrategy',
+        'maxStoreSize',
+        'autoDownload',
+    ];
+    return validKeys.includes(key);
+}
+/**
+ * 验证 cleanStrategy 值是否有效
+ */
+export function isValidCleanStrategy(value) {
+    return ['unreferenced', 'lru', 'manual'].includes(value);
+}
+/**
+ * 解析配置值
+ */
+export function parseConfigValue(key, value) {
+    switch (key) {
+        case 'autoDownload':
+        case 'initialized':
+            return value === 'true';
+        case 'maxStoreSize':
+            return parseInt(value, 10);
+        case 'cleanStrategy':
+            if (!isValidCleanStrategy(value)) {
+                throw new Error(`无效的 cleanStrategy 值: ${value}，有效值: unreferenced, lru, manual`);
+            }
+            return value;
+        default:
+            return value;
+    }
+}
+export default {
+    load,
+    save,
+    get,
+    set,
+    getDefaultConfig,
+    ensureConfigDir,
+    getStorePath,
+    setStorePath,
+    isValidConfigKey,
+    isValidCleanStrategy,
+    parseConfigValue,
+};
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/guard.d.ts

@@ -0,0 +1,18 @@
+import type { InitStatus } from '../types/index.js';
+/**
+ * 检查是否已初始化
+ */
+export declare function isInitialized(): Promise<boolean>;
+/**
+ * 确保已初始化，否则输出错误并退出
+ */
+export declare function ensureInitialized(): Promise<void>;
+/**
+ * 获取详细的初始化状态
+ */
+export declare function getInitStatus(): Promise<InitStatus>;
+/**
+ * 检查配置目录是否存在
+ */
+export declare function configDirExists(): Promise<boolean>;
+//# sourceMappingURL=guard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/core/guard.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAStD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOvD;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,CAmCzD;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAOxD"}

package/dist/core/guard.js

@@ -0,0 +1,82 @@
+/**
+ * 初始化状态检查
+ * 未初始化时阻止其他命令执行
+ */
+import fs from 'fs/promises';
+import { getConfigPath, getConfigDir } from './platform.js';
+import { error, hint } from '../utils/logger.js';
+import { EXIT_CODES } from '../utils/exit-codes.js';
+/**
+ * 检查是否已初始化
+ */
+export async function isInitialized() {
+    try {
+        const configPath = getConfigPath();
+        const content = await fs.readFile(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        return config.initialized === true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 确保已初始化，否则输出错误并退出
+ */
+export async function ensureInitialized() {
+    const initialized = await isInitialized();
+    if (!initialized) {
+        error('TanmiDock 尚未初始化');
+        hint('请先运行: tanmi-dock init');
+        process.exit(EXIT_CODES.NOT_INITIALIZED);
+    }
+}
+/**
+ * 获取详细的初始化状态
+ */
+export async function getInitStatus() {
+    const configPath = getConfigPath();
+    let configExists = false;
+    let initialized = false;
+    let storePathExists = false;
+    let storePath;
+    try {
+        await fs.access(configPath);
+        configExists = true;
+        const content = await fs.readFile(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        initialized = config.initialized === true;
+        storePath = config.storePath;
+        if (storePath) {
+            try {
+                await fs.access(storePath);
+                storePathExists = true;
+            }
+            catch {
+                storePathExists = false;
+            }
+        }
+    }
+    catch {
+        // config file doesn't exist
+    }
+    return {
+        initialized,
+        configExists,
+        storePathExists,
+        storePath,
+    };
+}
+/**
+ * 检查配置目录是否存在
+ */
+export async function configDirExists() {
+    try {
+        await fs.access(getConfigDir());
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=guard.js.map

package/dist/core/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/core/guard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,MAAM,GAAe,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/C,OAAO,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,WAAW,GAAG,MAAM,aAAa,EAAE,CAAC;IAC1C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACzB,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IAEnC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,IAAI,SAA6B,CAAC;IAElC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5B,YAAY,GAAG,IAAI,CAAC;QAEpB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,MAAM,GAAe,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/C,WAAW,GAAG,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC;QAC1C,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAE7B,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC3B,eAAe,GAAG,IAAI,CAAC;YACzB,CAAC;YAAC,MAAM,CAAC;gBACP,eAAe,GAAG,KAAK,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,4BAA4B;IAC9B,CAAC;IAED,OAAO;QACL,WAAW;QACX,YAAY;QACZ,eAAe;QACf,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/core/linker.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 创建符号链接
+ * @param target 目标路径（链接指向的位置）
+ * @param linkPath 链接路径（创建链接的位置）
+ */
+export declare function link(target: string, linkPath: string): Promise<void>;
+/**
+ * 检查路径是否为符号链接
+ */
+export declare function isSymlink(linkPath: string): Promise<boolean>;
+/**
+ * 读取符号链接目标
+ */
+export declare function readLink(linkPath: string): Promise<string | null>;
+/**
+ * 删除符号链接
+ */
+export declare function unlink(linkPath: string): Promise<void>;
+/**
+ * 检查符号链接是否有效（目标存在）
+ */
+export declare function isValidLink(linkPath: string): Promise<boolean>;
+/**
+ * 检查符号链接是否指向正确的目标
+ */
+export declare function isCorrectLink(linkPath: string, expectedTarget: string): Promise<boolean>;
+/**
+ * 将普通目录替换为符号链接
+ * @param dirPath 要替换的目录路径
+ * @param target 链接目标
+ * @param backup 是否备份原目录（默认删除）
+ * @returns 备份路径（如果有）
+ */
+export declare function replaceWithLink(dirPath: string, target: string, backup?: boolean): Promise<string | null>;
+/**
+ * 将符号链接还原为普通目录（从目标复制内容）
+ */
+export declare function restoreFromLink(linkPath: string): Promise<void>;
+/**
+ * 检查路径状态
+ */
+export declare function getPathStatus(localPath: string, expectedTarget: string): Promise<'linked' | 'wrong_link' | 'directory' | 'missing'>;
+/**
+ * 链接库到项目（自动选择单平台/多平台策略）
+ * @param localPath 本地路径 (3rdparty/libXxx)
+ * @param storePath Store 根路径
+ * @param libName 库名
+ * @param commit commit hash
+ * @param platforms 选择的平台列表
+ */
+export declare function linkLibrary(localPath: string, storePath: string, libName: string, commit: string, platforms: string[]): Promise<void>;
+/**
+ * 多平台组合链接
+ * 创建真实目录，内部分别链接各平台内容和共享内容
+ * @param localPath 本地路径
+ * @param storePath Store 根路径
+ * @param libName 库名
+ * @param commit commit hash
+ * @param platforms 平台列表
+ */
+export declare function linkMultiPlatform(localPath: string, storePath: string, libName: string, commit: string, platforms: string[]): Promise<void>;
+declare const _default: {
+    link: typeof link;
+    isSymlink: typeof isSymlink;
+    readLink: typeof readLink;
+    unlink: typeof unlink;
+    isValidLink: typeof isValidLink;
+    isCorrectLink: typeof isCorrectLink;
+    replaceWithLink: typeof replaceWithLink;
+    restoreFromLink: typeof restoreFromLink;
+    getPathStatus: typeof getPathStatus;
+    linkLibrary: typeof linkLibrary;
+    linkMultiPlatform: typeof linkMultiPlatform;
+};
+export default _default;
+//# sourceMappingURL=linker.d.ts.map