@ainc/fs 0.1.22 → 0.1.23

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/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/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": "./downloadFile", "names": ["downloadFile"]},
+    {"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"]}
+]

package/esm/index.mjs

@@ -5,6 +5,22 @@
  *****************************************
  */
 'use strict';
+/**
+ *****************************************
+ * 文件系统
+ *****************************************
+ */
+export { sys } from './sys.mjs';
+/**
+ *****************************************
+ * 导出工具
+ *****************************************
+ */
+export { unary, noop, nil, match } from './match.mjs';
+export { split } from './split.mjs';
+export { cache } from './cache.mjs';
+export { retry } from './retry.mjs';
+export { Dict } from './dict.mjs';
 /**
  *****************************************
  * 导出接口
@@ -13,8 +29,8 @@
 export { resolve, join, isAbsolute } from 'node:path';
 export { relative, isRelative } from './relative.mjs';
 export { dirname } from './dirname.mjs';
+export { isEsmModule, isEsmFile, isEsmPackage } from './isEsmModule.mjs';
 export { stat, isDir, isFile } from './stat.mjs';
-export { resolveFile } from './resolveFile.mjs';
 export { readFile } from './readFile.mjs';
 export { writeFile } from './writeFile.mjs';
 export { copy } from './copy.mjs';
@@ -24,3 +40,15 @@ export { md5 } from './md5.mjs';
 export { json, jsonc } from './jsonc.mjs';
 export { findUp } from './findUp.mjs';
 export { download } from './download.mjs';
+export { downloadFile } from './downloadFile.mjs';
+export { loadPackageDescription, resolvePackageDescription } from './loadPackageDescription.mjs';
+export { loadTsConfig, loadCompilerOptions, resolveTsConfig } from './loadTsConfig.mjs';
+export { resolveAlias, resolveDict } from './resolveAlias.mjs';
+export { resolvePaths } from './resolvePaths.mjs';
+export { resolvePath } from './resolvePath.mjs';
+export { resolveFile } from './resolveFile.mjs';
+export { resolveDirect } from './resolveDirect.mjs';
+export { resolveImports } from './resolveImports.mjs';
+export { resolveExports } from './resolveExports.mjs';
+export { resolveModuleDir, resolveModuleDirs } from './resolveModuleDir.mjs';
+export { resolveModuleId } from './resolveModuleId.mjs';

package/esm/isEsmModule.mjs

@@ -0,0 +1,59 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-18 20:14:00
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { dirname, extname } from 'node:path';
+import { loadPackageDescription } from './loadPackageDescription.mjs';
+/**
+ *****************************************
+ * 判断是否为 ESM 模块
+ *****************************************
+ */
+export function isEsmModule(filename, dir = dirname(filename)) {
+    const result = isEsmFile(filename);
+    // 文件扩展名未匹配成功时，解析文件所在包的配置
+    if (result === undefined) {
+        return isEsmPackage(dir);
+    }
+    else {
+        return result;
+    }
+}
+/**
+ *****************************************
+ * 判断是否为 ESM 模块
+ *****************************************
+ */
+export function isEsmPackage(dir) {
+    const pkg = loadPackageDescription(dir);
+    if (pkg && pkg.type === 'module') {
+        return true;
+    }
+    else {
+        return false;
+    }
+}
+/**
+ *****************************************
+ * 判断为 ESM 文件
+ *****************************************
+ */
+export function isEsmFile(filename) {
+    const ext = extname(filename);
+    // 判断 mjs 模块
+    if (['.mjs', '.mts', '.mjsx', '.mtsx'].includes(ext)) {
+        return true;
+    }
+    // 判断 cjs 模块
+    if (['.cjs', '.cts', '.cjsx', '.ctsx'].includes(ext)) {
+        return false;
+    }
+}

package/esm/loadPackageDescription.mjs

@@ -0,0 +1,67 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2023-12-02 11:43:57
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { sep } from 'node:path';
+import { isFile } from './stat.mjs';
+import { lookup } from './lookup.mjs';
+import { json } from './jsonc.mjs';
+import { readFile } from './readFile.mjs';
+/**
+ *****************************************
+ * 加载包描述
+ *****************************************
+ */
+export function loadPackageDescription(from) {
+    const data = resolvePackageDescription(from);
+    // 返回配置
+    if (data) {
+        return data.config;
+    }
+}
+/**
+ *****************************************
+ * 读取包描述
+ *****************************************
+ */
+export function readPackageDescription(dir) {
+    const data = resolvePackageDescription(dir);
+    // 返回配置
+    if (data && data.path.startsWith(dir)) {
+        return data.config;
+    }
+}
+/**
+ *****************************************
+ * 缓存
+ *****************************************
+ */
+const cache = new Map();
+const moduleDir = sep + 'node_modules';
+/**
+ *****************************************
+ * 解析包配置
+ *****************************************
+ */
+export function resolvePackageDescription(from) {
+    return lookup('package.json', {
+        from,
+        cache,
+        resolve(path, dir) {
+            if (isFile(path)) {
+                return { dir, path, config: json(readFile(path)) };
+            }
+            if (dir.endsWith(moduleDir)) {
+                return { dir, path };
+            }
+        },
+    });
+}