@ainc/fs 0.1.22 → 0.1.24

package/dist/resolvePaths.js

@@ -0,0 +1,42 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-26 22:30:23
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePaths = resolvePaths;
+const match_1 = require("./match");
+const cache_1 = require("./cache");
+const resolveAlias_1 = require("./resolveAlias");
+const resolveDirect_1 = require("./resolveDirect");
+/**
+ *****************************************
+ * 缓存
+ *****************************************
+ */
+const cached = (0, cache_1.cache)(new WeakMap());
+/**
+ *****************************************
+ * 解析别名
+ *****************************************
+ */
+function resolvePaths(paths) {
+    return cached.get(paths, () => (0, resolveAlias_1.resolveDict)(paths, resolvePath));
+}
+/**
+ *****************************************
+ * 解析匹配规则
+ *****************************************
+ */
+function resolvePath(key, paths) {
+    const { test, resolve } = (0, resolveDirect_1.resolveDirect)(key);
+    const rules = paths.map(resolve);
+    // 返回解析函数
+    return function resolve(id, handler) {
+        if (test(id)) {
+            return (0, match_1.match)(rules, direct => handler(direct(id)));
+        }
+    };
+}

package/dist/split.d.ts

@@ -0,0 +1,6 @@
+/**
+ *****************************************
+ * 分割字符串
+ *****************************************
+ */
+export declare function split(str: string, sep: string): [string, string | undefined];

package/dist/split.js

@@ -0,0 +1,24 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-24 23:56:16
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.split = split;
+/**
+ *****************************************
+ * 分割字符串
+ *****************************************
+ */
+function split(str, sep) {
+    const idx = str.indexOf(sep);
+    // 执行切割
+    if (idx === -1) {
+        return [str, undefined];
+    }
+    else {
+        return [str.slice(0, idx), str.slice(idx + sep.length)];
+    }
+}

package/dist/sys.d.ts

@@ -0,0 +1,60 @@
+import { PackageDescription } from './loadPackageDescription';
+/**
+ *****************************************
+ * 文件系统
+ *****************************************
+ */
+export type FileSystem = typeof sys;
+/**
+ *****************************************
+ * 文件系统
+ *****************************************
+ */
+export declare const sys: {
+    /** 解析基准路径 */
+    baseUrl: string | undefined;
+    /** 别名配置 */
+    alias: Record<string, string> | undefined;
+    /** 路径配置 */
+    paths: Record<string, string[]> | undefined;
+    /** 缓存 ID */
+    cacheSalt: string;
+    /** 缓存 */
+    cache: Map<string, string | null | undefined>;
+    /** 当前目录 */
+    cwd: string;
+    /** 是否解析模块 */
+    module: boolean;
+    /** 是否解析模块导出 */
+    moduleExports: boolean;
+    /** 解析 main 字段 */
+    mainFields: string[];
+    /** 解析条件 */
+    conditions: string[];
+    /** 解析扩展名 */
+    extensions: string[];
+    /** 解析路径 */
+    resolve(id: string, from: string): string | null | undefined;
+    /** 解析内部模块 */
+    resolveBuiltin(id: string): string | undefined;
+    /** 解析文件 */
+    resolveFile(id: string, from: string): string | null | undefined;
+    /** 解析文件目标 */
+    resolveTarget(path: string): string | undefined;
+    /** 解析目录 */
+    resolveDir(path: string): string | undefined;
+    /** 解析 main 文件 */
+    resolveMainFile(path: string, pkg: PackageDescription): string | undefined;
+    /** 解析 index 文件 */
+    resolveIndex(path: string): string | undefined;
+    /** 解析扩展名 */
+    resolveExtensions(path: string): string | undefined;
+    /** 解析包自身 */
+    resolveSelf(name: string, path: string, from: string): string | null | undefined;
+    /** 解析模块 */
+    resolveModule(id: string, from: string): string | null | undefined;
+    /** 解析模块导入 */
+    resolveModuleImports(id: string, from: string): string | null | undefined;
+    /** 解析模块导出 */
+    resolveModuleExports(id: string, from: string, pkg: PackageDescription): string | null | undefined;
+};

package/dist/sys.js

@@ -0,0 +1,260 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-06-29 16:06:27
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sys = void 0;
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+const node_url_1 = require("node:url");
+const node_path_1 = require("node:path");
+const node_module_1 = require("node:module");
+const relative_1 = require("./relative");
+const stat_1 = require("./stat");
+const loadPackageDescription_1 = require("./loadPackageDescription");
+const resolveModuleId_1 = require("./resolveModuleId");
+const resolveModuleDir_1 = require("./resolveModuleDir");
+const resolveAlias_1 = require("./resolveAlias");
+const resolvePaths_1 = require("./resolvePaths");
+const resolveImports_1 = require("./resolveImports");
+const resolveExports_1 = require("./resolveExports");
+/**
+ *****************************************
+ * 全局缓存
+ *****************************************
+ */
+const cache = new Map();
+/**
+ *****************************************
+ * 文件系统
+ *****************************************
+ */
+exports.sys = {
+    /** 解析基准路径 */
+    baseUrl: undefined,
+    /** 别名配置 */
+    alias: undefined,
+    /** 路径配置 */
+    paths: undefined,
+    /** 缓存 ID */
+    cacheSalt: '',
+    /** 缓存 */
+    cache,
+    /** 当前目录 */
+    cwd: process.cwd(),
+    /** 是否解析模块 */
+    module: true,
+    /** 是否解析模块导出 */
+    moduleExports: true,
+    /** 解析 main 字段 */
+    mainFields: ['main'],
+    /** 解析条件 */
+    conditions: ['require', 'node'],
+    /** 解析扩展名 */
+    extensions: ['.ts', '.tsx', '.js', '.json', '.jsx', '.mjs', '.cjs', '.mts', '.cts', '.node', '.wasm'],
+    /** 解析路径 */
+    resolve(id, from) {
+        const cacheId = `${from}\x00${id}`;
+        const cacheSaltId = `${cacheId}\x00${this.cacheSalt}`;
+        // 存在缓存时，直接返回
+        if (this.cache.has(cacheId)) {
+            return this.cache.get(cacheId);
+        }
+        // 存在缓存时，直接返回
+        if (this.cache.has(cacheSaltId)) {
+            return this.cache.get(cacheSaltId);
+        }
+        // 添加缓存，避免循环解析
+        this.cache.set(cacheSaltId, null);
+        // 匹配规则
+        const rules = [
+            [cacheId, this.resolveBuiltin],
+            [cacheSaltId, this.resolveModuleImports],
+            [cacheId, this.resolveFile],
+            [cacheSaltId, this.resolveModule],
+        ];
+        // 解析规则
+        for (let i = 0, l = rules.length; i < l; i++) {
+            const [cacheId, handler] = rules[i];
+            const resolved = handler.call(this, id, from);
+            if (resolved !== undefined) {
+                this.cache.set(cacheId, resolved);
+                return resolved;
+            }
+        }
+    },
+    /** 解析内部模块 */
+    resolveBuiltin(id) {
+        if (node_module_1.builtinModules.includes(id)) {
+            return id;
+        }
+        // 处理内置模块
+        const prefix = id.slice(0, 5);
+        if (prefix === 'node:') {
+            return id;
+        }
+        // 处理 URL 路径
+        if (prefix === 'file:') {
+            return (0, node_url_1.fileURLToPath)(id);
+        }
+        // 处理资源路径
+        if (prefix === 'data:' || prefix === 'http:' || id.startsWith('https:')) {
+            return id;
+        }
+    },
+    /** 解析文件 */
+    resolveFile(id, from) {
+        // 解析相对路径
+        if ((0, relative_1.isRelative)(id)) {
+            return this.resolveTarget((0, node_path_1.resolve)(from, id));
+        }
+        // 解析绝对路径
+        if ((0, node_path_1.isAbsolute)(id)) {
+            return this.resolveTarget(id);
+        }
+        // 解析别名
+        if (this.alias) {
+            const alias = (0, resolveAlias_1.resolveAlias)(this.alias);
+            const resolved = alias.match(resolve => resolve(id, alias => this.resolve(alias, this.cwd)));
+            if (resolved !== undefined) {
+                return resolved;
+            }
+        }
+        // 解析基准路径
+        if (this.baseUrl) {
+            const resolved = this.resolveTarget((0, node_path_1.resolve)(this.baseUrl, id));
+            if (resolved !== undefined) {
+                return resolved;
+            }
+        }
+        // 解析路径映射
+        if (this.paths) {
+            const baseUrl = this.baseUrl || this.cwd;
+            const paths = (0, resolvePaths_1.resolvePaths)(this.paths);
+            const resolved = paths.match(resolve => resolve(id, alias => this.resolve(alias, baseUrl)));
+            if (resolved !== undefined) {
+                return resolved;
+            }
+        }
+    },
+    /** 解析文件目标 */
+    resolveTarget(path) {
+        const stats = (0, stat_1.stat)(path);
+        // 目标存在时，需要解析目标是目录的情况
+        if (stats) {
+            return stats.isDirectory() ? this.resolveDir(path) : path;
+        }
+        else {
+            return this.resolveExtensions(path);
+        }
+    },
+    /** 解析目录 */
+    resolveDir(path) {
+        const pkg = (0, loadPackageDescription_1.resolvePackageDescription)(path);
+        // 解析主入口配置
+        if (pkg && pkg.dir === path && pkg.config) {
+            return this.resolveMainFile(path, pkg.config);
+        }
+        else {
+            return this.resolveIndex(path);
+        }
+    },
+    /** 解析 main 文件 */
+    resolveMainFile(path, pkg) {
+        for (let i = 0, l = this.mainFields.length; i < l; i++) {
+            const main = pkg[this.mainFields[i]];
+            // 存在主入口文件配置
+            if (main) {
+                return this.resolveTarget((0, node_path_1.resolve)(path, main));
+            }
+        }
+        // 解析 index 文件
+        return this.resolveIndex(path);
+    },
+    /** 解析 index 文件 */
+    resolveIndex(path) {
+        return this.resolveExtensions(path + node_path_1.sep + 'index');
+    },
+    /** 解析扩展名 */
+    resolveExtensions(path) {
+        for (let i = 0, l = this.extensions.length; i < l; i++) {
+            const file = path + this.extensions[i];
+            const stats = (0, stat_1.stat)(file);
+            if (stats && stats.isFile()) {
+                return file;
+            }
+        }
+    },
+    /** 解析包自身 */
+    resolveSelf(name, path, from) {
+        const pkg = (0, loadPackageDescription_1.resolvePackageDescription)(from);
+        if (!pkg || !pkg.config) {
+            return;
+        }
+        // 获取配置
+        const { dir, config } = pkg;
+        // 解析模块导出
+        if (config.name === name) {
+            return this.resolveModuleExports(path, dir, config) || null;
+        }
+    },
+    /** 解析模块 */
+    resolveModule(id, from) {
+        const [name, subpath] = (0, resolveModuleId_1.resolveModuleId)(id);
+        const path = subpath === './' ? '.' : subpath;
+        // 解析当前包本身
+        const resolved = this.resolveSelf(name, path, from);
+        if (resolved !== undefined || this.module === false) {
+            return resolved;
+        }
+        // 解析模块目录
+        const dir = (0, resolveModuleDir_1.resolveModuleDir)(name, from);
+        if (!dir) {
+            return;
+        }
+        // 读取包描述文件
+        const pkg = (0, loadPackageDescription_1.resolvePackageDescription)(dir);
+        if (pkg && pkg.dir === dir && pkg.config) {
+            return this.resolveModuleExports(path, dir, pkg.config);
+        }
+        // 解析目标路径
+        if (path === '.') {
+            return this.resolveIndex(path);
+        }
+        else {
+            return this.resolveTarget((0, node_path_1.resolve)(dir, path));
+        }
+    },
+    /** 解析模块导入 */
+    resolveModuleImports(id, from) {
+        const pkg = id.charAt(0) === '#' && (0, loadPackageDescription_1.resolvePackageDescription)(from);
+        if (!pkg || !pkg.config || !pkg.config.imports) {
+            return;
+        }
+        // 执行配置
+        const imports = pkg.config.imports;
+        const dir = pkg.dir;
+        // 执行解析
+        return (0, resolveImports_1.resolveImports)(id, this.conditions, imports, path => this.resolve(path, dir));
+    },
+    /** 解析模块导出 */
+    resolveModuleExports(id, from, pkg) {
+        // 处理导出配置
+        if (pkg.exports && this.moduleExports) {
+            return (0, resolveExports_1.resolveExports)(id, this.conditions, pkg.exports, path => this.resolveTarget((0, node_path_1.resolve)(from, path))) || null;
+        }
+        // 解析目标路径
+        if (id === '.') {
+            return this.resolveMainFile(from, pkg);
+        }
+        else {
+            return this.resolveTarget((0, node_path_1.resolve)(from, id));
+        }
+    },
+};

package/esm/cache.mjs

@@ -0,0 +1,22 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-19 12:43:17
+ *****************************************
+ */
+'use strict';
+export function cache(map) {
+    const cached = map || new Map();
+    // 获取缓存
+    function get(id, handler) {
+        return cached.has(id) ? cached.get(id) : set(id, handler);
+    }
+    // 更新缓存
+    function set(id, handler) {
+        const result = handler(id);
+        cached.set(id, result);
+        return result;
+    }
+    // 返回结果
+    return { set, get };
+}

package/esm/dict.mjs

@@ -0,0 +1,63 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-06-11 22:56:35
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 字典对象
+ *****************************************
+ */
+export class Dict {
+    constructor() {
+        /** 键值映射 */
+        this.data = {};
+        /** 键列表 */
+        this.keys = [];
+    }
+    /** 添加映射 */
+    set(key, value) {
+        if (!Object.prototype.hasOwnProperty.call(this.data, key)) {
+            this.keys.push(key);
+        }
+        // 更新值
+        this.data[key] = value;
+        // 返回自身
+        return this;
+    }
+    /** 获取值 */
+    get(key) {
+        return this.data[key];
+    }
+    /** 遍历 */
+    map(handler) {
+        const dict = new Dict();
+        // 遍历映射
+        this.keys.forEach(key => {
+            dict.set(key, handler(key, this.data[key]));
+        });
+        // 返回结果
+        return dict;
+    }
+    /** 排序 */
+    sort(handler) {
+        this.keys.sort(handler);
+        return this;
+    }
+    /** 匹配对象 */
+    match(handler) {
+        const keys = this.keys;
+        const data = this.data;
+        const size = keys.length;
+        // 遍历匹配
+        for (let i = 0; i < size; i++) {
+            const key = keys[i];
+            const result = handler(data[key], key);
+            if (result !== undefined) {
+                return result;
+            }
+        }
+    }
+}

package/esm/download.mjs

@@ -12,12 +12,13 @@
  */
 import { tmpdir } from 'node:os';
 import { resolve, join, dirname } from 'node:path';
-import { stat, mkdir, rm, rename } from 'node:fs/promises';
+import { mkdir, rm, rename } from 'node:fs/promises';
 import { createReadStream, createWriteStream } from 'node:fs';
 import { Readable } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
 import { retry } from './retry.mjs';
 import { md5 } from './md5.mjs';
+import { stat, pipe } from './promises.mjs';
 import { Concurrency } from './concurrency.mjs';
 /**
  *****************************************
@@ -91,7 +92,7 @@ async function downloadFileByChunk(dest, url, init, options) {
     // 创建下载目录
     await mkdir(dir, { recursive: true });
     // 合并文件
-    await chunkConcurrency.execute(path => pipe(path, stream));
+    await chunkConcurrency.execute(path => pipe(createReadStream(path), stream, { end: false }));
     // 结束传输
     stream.end();
     // 重命名临时文件
@@ -154,26 +155,13 @@ function getDownloadURL(url) {
 function getDownloadDir(url, options) {
     return join(tmpdir(), 'downloads', generateDownloadID(getDownloadURL(url), options));
 }
-/**
- *****************************************
- * 写入文件流
- *****************************************
- */
-function pipe(src, dest) {
-    return new Promise((resolve, reject) => {
-        const stream = createReadStream(src);
-        stream.once('close', resolve);
-        stream.once('error', reject);
-        stream.pipe(dest, { end: false });
-    });
-}
 /**
  *****************************************
  * 下载文件
  *****************************************
  */
 async function downloadFile(dest, url, init, options) {
-    const stats = await stat(dest).catch(err => err.code === 'ENOENT' ? null : Promise.reject(err));
+    const stats = await stat(dest);
     // 已经存在文件，不再下载
     if (stats && stats.isFile() && !options.force) {
         options.onProgress && options.onProgress(stats.size, stats.size);

package/esm/downloadFile.mjs

@@ -26,11 +26,10 @@ export async function downloadFile(dest, url) {
             if (size < total) {
                 print(`  -> ${((size / total) * 100).toFixed(2)}% (${format(size)}/${format(total)})`);
             }
-            else {
-                print('[download]: done', true);
-            }
         },
     });
+    // 下载完成
+    print('[download]: done', true);
 }
 /**
  *****************************************
@@ -52,6 +51,16 @@ function format(bytes) {
     // 返回默认
     return `${(bytes / limit).toFixed(2)} TB`;
 }
+/**
+ *****************************************
+ * 上移一行并清除该行内容
+ * a. 移动光标上移一行：\x1B[1A
+ * b. 清除当前行：\x1B[2K
+ * c. 移动光标到行首：\x1B[0G
+ *****************************************
+ */
+const clearCurrentLine = '\x1B[0G\x1B[2K';
+const clearPreviousLine = '\x1B[1A\x1B[2K';
 /**
  *****************************************
  * 进度条
@@ -59,23 +68,20 @@ function format(bytes) {
  */
 function stdout() {
     let progressContent = '';
-    let progressSize = 0;
     let progressTime = 0;
     return function print(content, flush) {
         const now = Date.now();
         if ((content === progressContent || now - progressTime < 600) && !flush) {
             return;
         }
-        const size = content.length;
-        const diff = progressSize - size;
+        // 清除内容
+        if (progressContent) {
+            process.stdout.write(clearCurrentLine);
+            process.stdout.write(clearPreviousLine);
+        }
+        // 更新内容
         progressContent = content;
         progressTime = now;
-        progressSize = size;
-        if (diff > 0) {
-            process.stdout.write(`\r${content}${' '.repeat(diff)}`);
-        }
-        else {
-            process.stdout.write(`\r${content}`);
-        }
+        process.stdout.write(content + '\n');
     };
 }

package/esm/gzip.mjs

@@ -0,0 +1,47 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-20 23:07:36
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { createReadStream, createWriteStream } from 'node:fs';
+import { createGzip, createGunzip } from 'node:zlib';
+import { rm } from './promises.mjs';
+/**
+ *****************************************
+ * gzip
+ *****************************************
+ */
+export function gzip(src, dest, options) {
+    return new Promise((resolve, reject) => {
+        const readable = createReadStream(src);
+        const gzip = createGzip(options);
+        const writable = createWriteStream(dest);
+        readable.pipe(gzip)
+            .pipe(writable)
+            .once('finish', () => resolve(dest))
+            .once('error', err => rm(dest).then(() => reject(err)));
+    });
+}
+/**
+ *****************************************
+ * ungzip
+ *****************************************
+ */
+export function ungzip(src, dest, options) {
+    return new Promise((resolve, reject) => {
+        const readable = createReadStream(src);
+        const gzip = createGunzip(options);
+        const writable = createWriteStream(dest);
+        readable.pipe(gzip)
+            .pipe(writable)
+            .once('finish', () => resolve(dest))
+            .once('error', err => rm(dest).then(() => reject(err)));
+    });
+}

package/esm/index.exports.json

@@ -0,0 +1,34 @@
+[
+    {"path": "./sys", "names": ["sys"]},
+    {"path": "./match", "names": ["unary", "noop", "nil", "match"]},
+    {"path": "./split", "names": ["split"]},
+    {"path": "./cache", "names": ["cache"]},
+    {"path": "./retry", "names": ["retry"]},
+    {"path": "./dict", "names": ["Dict"]},
+    {"path": "node:path", "names": ["resolve", "join", "isAbsolute"]},
+    {"path": "./relative", "names": ["relative", "isRelative"]},
+    {"path": "./dirname", "names": ["dirname"]},
+    {"path": "./isEsmModule", "names": ["isEsmModule", "isEsmFile", "isEsmPackage"]},
+    {"path": "./stat", "names": ["stat", "isDir", "isFile"]},
+    {"path": "./readFile", "names": ["readFile"]},
+    {"path": "./writeFile", "names": ["writeFile"]},
+    {"path": "./copy", "names": ["copy"]},
+    {"path": "./rm", "names": ["rm"]},
+    {"path": "./lookup", "names": ["lookup"]},
+    {"path": "./md5", "names": ["md5"]},
+    {"path": "./jsonc", "names": ["json", "jsonc"]},
+    {"path": "./findUp", "names": ["findUp"]},
+    {"path": "./download", "names": ["download"]},
+    {"path": "./gzip", "names": ["gzip", "ungzip"]},
+    {"path": "./loadPackageDescription", "names": ["loadPackageDescription", "resolvePackageDescription"]},
+    {"path": "./loadTsConfig", "names": ["loadTsConfig", "loadCompilerOptions", "resolveTsConfig"]},
+    {"path": "./resolveAlias", "names": ["resolveAlias", "resolveDict"]},
+    {"path": "./resolvePaths", "names": ["resolvePaths"]},
+    {"path": "./resolvePath", "names": ["resolvePath"]},
+    {"path": "./resolveFile", "names": ["resolveFile"]},
+    {"path": "./resolveDirect", "names": ["resolveDirect"]},
+    {"path": "./resolveImports", "names": ["resolveImports"]},
+    {"path": "./resolveExports", "names": ["resolveExports"]},
+    {"path": "./resolveModuleDir", "names": ["resolveModuleDir", "resolveModuleDirs"]},
+    {"path": "./resolveModuleId", "names": ["resolveModuleId"]}
+]