grf-cli 1.0.0

package/dist/commands/use.js

@@ -0,0 +1,224 @@
+"use strict";
+/**
+ * use 命令
+ * 将缓存的仓库内容复制到当前工作目录
+ * 支持直接传入 git URL，会自动先 add 再 use
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const path_1 = __importDefault(require("path"));
+const repository = __importStar(require("../core/repository.js"));
+const filesystem = __importStar(require("../core/filesystem.js"));
+const index_js_1 = require("../types/index.js");
+/**
+ * 检查字符串是否为 Git URL
+ * 支持 HTTPS 和 SSH 格式
+ */
+function isGitUrl(str) {
+    // HTTPS 格式: https://github.com/user/repo.git
+    const httpsRegex = /^https?:\/\/[^/]+\/[^/]+\/[^/]+/;
+    // SSH 格式: git@github.com:user/repo.git
+    const sshRegex = /^git@[^:]+:[^/]+\/[^/]+/;
+    return httpsRegex.test(str) || sshRegex.test(str);
+}
+exports.useCommand = new commander_1.Command('use')
+    .description('Copy reference repository to current directory (supports Git URL)')
+    .argument('<name>', 'Repository name, short name, or Git URL')
+    .argument('[path]', 'Target path (default: .gitreference/<repo-path>)')
+    .option('-s, --subdir <path>', 'Copy only a specific subdirectory')
+    .option('--no-ignore', 'Do not update .gitignore')
+    .option('-b, --branch <branch>', 'Specify branch (only for Git URL)')
+    .action(async (name, targetPath, options) => {
+    let repoName = name;
+    // 检查是否为 Git URL
+    if (isGitUrl(name)) {
+        const addSpinner = (0, ora_1.default)('Adding repository...').start();
+        try {
+            // 检查仓库是否已存在
+            const parsed = repository.parseRepoUrl(name);
+            const fullName = `${parsed.host}/${parsed.owner}/${parsed.repo}`;
+            if (await repository.exists(fullName)) {
+                addSpinner.info(chalk_1.default.blue('Repository already exists, skipping add...'));
+                repoName = fullName;
+            }
+            else {
+                // 自动添加仓库
+                const repoInfo = await repository.add(name, {
+                    branch: options.branch,
+                    shallow: true,
+                    depth: 1,
+                });
+                addSpinner.succeed(chalk_1.default.green('Repository added successfully!'));
+                console.log(`  ${chalk_1.default.gray('Name:')}     ${repoInfo.name}`);
+                console.log(`  ${chalk_1.default.gray('Commit:')}   ${repoInfo.commitId.substring(0, 7)}...`);
+                console.log();
+                repoName = repoInfo.name;
+            }
+        }
+        catch (error) {
+            addSpinner.fail(chalk_1.default.red('Failed to add repository'));
+            if (error instanceof index_js_1.GrfError) {
+                console.error(chalk_1.default.red(`\n${chalk_1.default.bold('✗')} ${error.message}`));
+            }
+            else if (error instanceof Error) {
+                console.error(chalk_1.default.red(`\n${chalk_1.default.bold('✗')} ${error.message}`));
+            }
+            else {
+                console.error(chalk_1.default.red(`\n${chalk_1.default.bold('✗')} An unknown error occurred`));
+            }
+            process.exit(1);
+        }
+    }
+    const spinner = (0, ora_1.default)('Copying repository...').start();
+    try {
+        // 检查仓库是否存在
+        if (!await repository.exists(repoName)) {
+            spinner.fail(chalk_1.default.red('Repository not found'));
+            console.error(chalk_1.default.red(`\n${chalk_1.default.bold('✗')} Repository "${repoName}" does not exist.`));
+            console.error(chalk_1.default.gray(`  Use ${chalk_1.default.cyan('grf add <url>')} to add a repository first.`));
+            console.error(chalk_1.default.gray(`  Or use ${chalk_1.default.cyan('grf use <url>')} to add and use in one step.`));
+            process.exit(1);
+        }
+        // 获取仓库信息
+        let repoInfo = await repository.get(repoName);
+        if (!repoInfo) {
+            spinner.fail(chalk_1.default.red('Failed to get repository info'));
+            process.exit(1);
+        }
+        // 如果指定了分支且与当前分支不同，则切换分支
+        if (options.branch && repoInfo.branch !== options.branch) {
+            spinner.text = `Switching to branch ${options.branch}...`;
+            try {
+                repoInfo = await repository.switchBranch(repoName, options.branch);
+                spinner.text = 'Copying repository...';
+            }
+            catch (error) {
+                spinner.fail(chalk_1.default.red(`Failed to switch branch`));
+                if (error instanceof index_js_1.GrfError) {
+                    console.error(chalk_1.default.red(`\n${chalk_1.default.bold('✗')} ${error.message}`));
+                    if (error.code === index_js_1.ErrorCode.GIT_CHECKOUT_FAILED) {
+                        console.error(chalk_1.default.gray(`  Branch "${options.branch}" may not exist. Use ${chalk_1.default.cyan('git branch -r')} to list available branches.`));
+                    }
+                }
+                else if (error instanceof Error) {
+                    console.error(chalk_1.default.red(`\n${chalk_1.default.bold('✗')} ${error.message}`));
+                }
+                else {
+                    console.error(chalk_1.default.red(`\n${chalk_1.default.bold('✗')} An unknown error occurred`));
+                }
+                process.exit(1);
+            }
+        }
+        // 解析仓库路径
+        const repoPath = await repository.resolvePath(repoName);
+        // 确定源路径（如果指定了 subdir，则使用子目录）
+        const sourcePath = options.subdir
+            ? path_1.default.join(repoPath, options.subdir)
+            : repoPath;
+        // 检查源路径是否存在（特别是子目录情况）
+        if (options.subdir && !await filesystem.exists(sourcePath)) {
+            spinner.fail(chalk_1.default.red('Subdirectory not found'));
+            console.error(chalk_1.default.red(`\n${chalk_1.default.bold('✗')} Subdirectory "${options.subdir}" does not exist in repository "${repoInfo.name}".`));
+            process.exit(1);
+        }
+        // 确定目标路径
+        const finalTargetPath = targetPath
+            ? path_1.default.resolve(process.cwd(), targetPath)
+            : path_1.default.join(process.cwd(), '.gitreference', repoInfo.name);
+        // 确保目标目录的父目录存在
+        await filesystem.ensureDir(path_1.default.dirname(finalTargetPath));
+        // 复制文件（排除 .git 和 meta.json）
+        await filesystem.copyDir(sourcePath, finalTargetPath, {
+            exclude: ['.git', 'meta.json', '.grf-meta.json'],
+            overwrite: true,
+        });
+        // 更新 .gitignore（如果没有 --no-ignore 选项）
+        if (options.ignore !== false) {
+            // 始终添加 .gitreference/ 条目（默认行为）
+            await filesystem.updateGitignore(process.cwd(), '.gitreference/');
+            // 如果用户指定了自定义路径，额外添加该路径
+            if (targetPath) {
+                // 计算相对于工作目录的路径
+                const relativePath = path_1.default.relative(process.cwd(), finalTargetPath);
+                // 确保路径使用正斜杠（跨平台兼容）并以 / 结尾（表示目录）
+                const normalizedPath = relativePath.replace(/\\/g, '/');
+                const gitignoreEntry = normalizedPath.endsWith('/') ? normalizedPath : normalizedPath + '/';
+                // 避免重复添加（如果自定义路径在 .gitreference/ 下则跳过）
+                if (!gitignoreEntry.startsWith('.gitreference/')) {
+                    await filesystem.updateGitignore(process.cwd(), gitignoreEntry);
+                }
+            }
+        }
+        spinner.succeed(chalk_1.default.green('Repository copied successfully!'));
+        // 显示复制信息
+        console.log();
+        console.log(`  ${chalk_1.default.gray('Source:')}   ${sourcePath}`);
+        console.log(`  ${chalk_1.default.gray('Target:')}   ${finalTargetPath}`);
+        console.log(`  ${chalk_1.default.gray('Commit:')}   ${repoInfo.commitId.substring(0, 7)}...`);
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red('Failed to copy repository'));
+        if (error instanceof index_js_1.GrfError) {
+            console.error(chalk_1.default.red(`\n${chalk_1.default.bold('✗')} ${error.message}`));
+            // 提供更具体的错误提示
+            if (error.code === index_js_1.ErrorCode.REPO_NOT_FOUND) {
+                console.error(chalk_1.default.gray(`  Use ${chalk_1.default.cyan('grf add <url>')} to add a repository first.`));
+            }
+            else if (error.code === index_js_1.ErrorCode.FS_PATH_NOT_FOUND) {
+                console.error(chalk_1.default.gray(`  The source path does not exist. Please check the repository or subdirectory.`));
+            }
+            else if (error.code === index_js_1.ErrorCode.FS_PERMISSION_DENIED) {
+                console.error(chalk_1.default.gray(`  Permission denied. Please check your file permissions.`));
+            }
+            process.exit(1);
+        }
+        // 未知错误
+        if (error instanceof Error) {
+            console.error(chalk_1.default.red(`\n${chalk_1.default.bold('✗')} ${error.message}`));
+        }
+        else {
+            console.error(chalk_1.default.red(`\n${chalk_1.default.bold('✗')} An unknown error occurred`));
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=use.js.map

package/dist/commands/use.js.map

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

package/dist/core/config.d.ts

@@ -0,0 +1,55 @@
+/**
+ * grf 配置模块
+ * 负责管理全局配置和仓库元信息的读写
+ */
+import { GlobalConfig, RepoMeta } from "../types/index.js";
+/**
+ * 获取 grf 根目录路径
+ * @returns grf 根目录的绝对路径 (~/.gitreference/)
+ */
+export declare function getGrfRoot(): string;
+/**
+ * 获取仓库存储根目录
+ * @returns 仓库存储目录的绝对路径 (~/.gitreference/repos/)
+ */
+export declare function getReposRoot(): string;
+/**
+ * 获取配置文件路径
+ * @returns 配置文件的绝对路径 (~/.gitreference/config.json)
+ */
+export declare function getConfigPath(): string;
+/**
+ * 获取默认配置
+ * @returns 默认的全局配置对象
+ */
+export declare function getDefaultConfig(): GlobalConfig;
+/**
+ * 确保配置目录存在
+ * 如果目录不存在则创建
+ */
+export declare function ensureConfigDir(): Promise<void>;
+/**
+ * 读取全局配置
+ * 如果配置文件不存在，返回默认配置
+ * @returns 全局配置对象
+ */
+export declare function readGlobalConfig(): Promise<GlobalConfig>;
+/**
+ * 写入全局配置
+ * 自动创建配置目录（如果不存在）
+ * @param config 要写入的配置对象
+ */
+export declare function writeGlobalConfig(config: GlobalConfig): Promise<void>;
+/**
+ * 读取仓库元信息
+ * @param repoPath 仓库目录路径
+ * @returns 仓库元信息对象，如果不存在则返回 null
+ */
+export declare function readRepoMeta(repoPath: string): Promise<RepoMeta | null>;
+/**
+ * 写入仓库元信息
+ * @param repoPath 仓库目录路径
+ * @param meta 要写入的元信息对象
+ */
+export declare function writeRepoMeta(repoPath: string, meta: RepoMeta): Promise<void>;
+//# 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":"AAAA;;;GAGG;AAKH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAuB,MAAM,mBAAmB,CAAC;AAahF;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CAQ/C;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAcrD;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CAoC9D;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB3E;AAWD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA8B7E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/core/config.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * grf 配置模块
+ * 负责管理全局配置和仓库元信息的读写
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGrfRoot = getGrfRoot;
+exports.getReposRoot = getReposRoot;
+exports.getConfigPath = getConfigPath;
+exports.getDefaultConfig = getDefaultConfig;
+exports.ensureConfigDir = ensureConfigDir;
+exports.readGlobalConfig = readGlobalConfig;
+exports.writeGlobalConfig = writeGlobalConfig;
+exports.readRepoMeta = readRepoMeta;
+exports.writeRepoMeta = writeRepoMeta;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const index_js_1 = require("../types/index.js");
+/** grf 根目录名称 */
+const GRF_DIR_NAME = ".gitreference";
+/** 全局配置文件名 */
+const CONFIG_FILE_NAME = "config.json";
+/** 仓库存储目录名 */
+const REPOS_DIR_NAME = "repos";
+/** 仓库元信息文件名 */
+const REPO_META_FILE_NAME = ".gitreference-meta.json";
+/** 当前配置版本 */
+const CONFIG_VERSION = "1.0.0";
+/**
+ * 获取 grf 根目录路径
+ * @returns grf 根目录的绝对路径 (~/.gitreference/)
+ */
+function getGrfRoot() {
+    return path_1.default.join(os_1.default.homedir(), GRF_DIR_NAME);
+}
+/**
+ * 获取仓库存储根目录
+ * @returns 仓库存储目录的绝对路径 (~/.gitreference/repos/)
+ */
+function getReposRoot() {
+    return path_1.default.join(getGrfRoot(), REPOS_DIR_NAME);
+}
+/**
+ * 获取配置文件路径
+ * @returns 配置文件的绝对路径 (~/.gitreference/config.json)
+ */
+function getConfigPath() {
+    return path_1.default.join(getGrfRoot(), CONFIG_FILE_NAME);
+}
+/**
+ * 获取默认配置
+ * @returns 默认的全局配置对象
+ */
+function getDefaultConfig() {
+    return {
+        version: CONFIG_VERSION,
+        defaultBranch: "main",
+        shallowClone: true,
+        shallowDepth: 1,
+        repos: {},
+    };
+}
+/**
+ * 确保配置目录存在
+ * 如果目录不存在则创建
+ */
+async function ensureConfigDir() {
+    try {
+        const grfRoot = getGrfRoot();
+        const reposRoot = getReposRoot();
+        await fs_extra_1.default.ensureDir(grfRoot);
+        await fs_extra_1.default.ensureDir(reposRoot);
+    }
+    catch (error) {
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.FS_PERMISSION_DENIED, `无法创建配置目录: ${error.message}`, error);
+    }
+}
+/**
+ * 读取全局配置
+ * 如果配置文件不存在，返回默认配置
+ * @returns 全局配置对象
+ */
+async function readGlobalConfig() {
+    const configPath = getConfigPath();
+    try {
+        const exists = await fs_extra_1.default.pathExists(configPath);
+        if (!exists) {
+            return getDefaultConfig();
+        }
+        const content = await fs_extra_1.default.readFile(configPath, "utf-8");
+        const config = JSON.parse(content);
+        // 确保配置对象包含所有必要字段
+        return {
+            ...getDefaultConfig(),
+            ...config,
+        };
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return getDefaultConfig();
+        }
+        if (error instanceof SyntaxError) {
+            throw new index_js_1.GrfError(index_js_1.ErrorCode.CONFIG_PARSE_ERROR, `配置文件解析失败: ${error.message}`, error);
+        }
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.CONFIG_NOT_FOUND, `读取配置文件失败: ${error.message}`, error);
+    }
+}
+/**
+ * 写入全局配置
+ * 自动创建配置目录（如果不存在）
+ * @param config 要写入的配置对象
+ */
+async function writeGlobalConfig(config) {
+    try {
+        await ensureConfigDir();
+        const configPath = getConfigPath();
+        const content = JSON.stringify(config, null, 2);
+        await fs_extra_1.default.writeFile(configPath, content, "utf-8");
+    }
+    catch (error) {
+        if (error instanceof index_js_1.GrfError) {
+            throw error;
+        }
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.CONFIG_WRITE_ERROR, `写入配置文件失败: ${error.message}`, error);
+    }
+}
+/**
+ * 获取仓库元信息文件路径
+ * @param repoPath 仓库目录路径
+ * @returns 元信息文件的绝对路径
+ */
+function getRepoMetaPath(repoPath) {
+    return path_1.default.join(repoPath, REPO_META_FILE_NAME);
+}
+/**
+ * 读取仓库元信息
+ * @param repoPath 仓库目录路径
+ * @returns 仓库元信息对象，如果不存在则返回 null
+ */
+async function readRepoMeta(repoPath) {
+    const metaPath = getRepoMetaPath(repoPath);
+    try {
+        const exists = await fs_extra_1.default.pathExists(metaPath);
+        if (!exists) {
+            return null;
+        }
+        const content = await fs_extra_1.default.readFile(metaPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return null;
+        }
+        if (error instanceof SyntaxError) {
+            throw new index_js_1.GrfError(index_js_1.ErrorCode.CONFIG_PARSE_ERROR, `仓库元信息解析失败: ${error.message}`, error);
+        }
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.CONFIG_NOT_FOUND, `读取仓库元信息失败: ${error.message}`, error);
+    }
+}
+/**
+ * 写入仓库元信息
+ * @param repoPath 仓库目录路径
+ * @param meta 要写入的元信息对象
+ */
+async function writeRepoMeta(repoPath, meta) {
+    try {
+        const metaPath = getRepoMetaPath(repoPath);
+        const content = JSON.stringify(meta, null, 2);
+        await fs_extra_1.default.writeFile(metaPath, content, "utf-8");
+    }
+    catch (error) {
+        throw new index_js_1.GrfError(index_js_1.ErrorCode.CONFIG_WRITE_ERROR, `写入仓库元信息失败: ${error.message}`, error);
+    }
+}
+//# 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/filesystem.d.ts

@@ -0,0 +1,74 @@
+/**
+ * FileSystem 模块
+ * 封装文件系统操作，提供复制、删除等功能
+ */
+/**
+ * 复制选项接口
+ */
+export interface CopyOptions {
+    /** 要排除的文件/目录模式（如 ['.git', 'node_modules']） */
+    exclude?: string[];
+    /** 是否覆盖已存在的文件 */
+    overwrite?: boolean;
+}
+/**
+ * 复制目录
+ * @param src 源目录路径
+ * @param dest 目标目录路径
+ * @param options 复制选项
+ */
+export declare function copyDir(src: string, dest: string, options?: CopyOptions): Promise<void>;
+/**
+ * 复制单个文件
+ * @param src 源文件路径
+ * @param dest 目标文件路径
+ */
+export declare function copyFile(src: string, dest: string): Promise<void>;
+/**
+ * 删除目录（递归删除）
+ * @param dirPath 要删除的目录路径
+ */
+export declare function removeDir(dirPath: string): Promise<void>;
+/**
+ * 检查路径是否存在
+ * @param filePath 要检查的路径
+ * @returns 路径是否存在
+ */
+export declare function exists(filePath: string): Promise<boolean>;
+/**
+ * 确保目录存在（不存在则创建）
+ * @param dirPath 目录路径
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/**
+ * 更新 .gitignore 文件
+ * 如果指定条目不存在，则追加到文件末尾
+ * 优化：将所有 gitreference 管理的条目放在同一个注释块下
+ * @param dir 目录路径
+ * @param entry 要添加的条目
+ */
+export declare function updateGitignore(dir: string, entry: string): Promise<void>;
+/**
+ * 读取目录内容
+ * @param dirPath 目录路径
+ * @returns 文件/目录名数组
+ */
+export declare function readDir(dirPath: string): Promise<string[]>;
+/**
+ * 检查路径是否为目录
+ * @param filePath 要检查的路径
+ * @returns 是否为目录
+ */
+export declare function isDirectory(filePath: string): Promise<boolean>;
+/**
+ * 从 .gitignore 文件中移除指定条目
+ * @param dir 目录路径（包含 .gitignore 的目录）
+ * @param entry 要移除的条目
+ * @param options 移除选项
+ * @returns 是否成功移除（条目存在并被移除返回 true）
+ */
+export declare function removeFromGitignore(dir: string, entry: string, options?: {
+    /** 是否同时移除关联的注释行（# Added by gitreference） */
+    removeComment?: boolean;
+}): Promise<boolean>;
+//# sourceMappingURL=filesystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/core/filesystem.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,iBAAiB;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BvE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB9D;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/D;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB9D;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CA0Ef;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBhE;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BpE;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,4CAA4C;IAC5C,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GACA,OAAO,CAAC,OAAO,CAAC,CA0FlB"}