@ainc/fs 0.1.21 → 0.1.23

package/bin/download.mjs

@@ -29,12 +29,48 @@ main();
  *****************************************
  */
 async function main() {
-  const [path, url] = process.argv.slice(2);
-  if (!path || !url) {
+  const args = process.argv.slice(2);
+  if (!args.length) {
     return;
   }
 
+  // 下载多个文件
+  if (isURL(args[0])) {
+    return Promise.all(args.map(url => downloadFile(resolvePath(url), url)));
+  }
+
   // 下载文件
-  await downloadFile(path, url);
+  if (isURL(args[1])) {
+    await downloadFile(args[0], args[1]);
+  }
+}
+
+
+/**
+ *****************************************
+ * 判断是否为 URL
+ *****************************************
+ * @param {string} url
+ */
+function isURL(url) {
+  if (url) {
+    return url.startsWith('http://') || url.startsWith('https://');
+  }
+}
+
+
+/**
+ *****************************************
+ * 解析下载路径
+ *****************************************
+ * @param {string} url
+ */
+function resolvePath(url) {
+  const idx = url.lastIndexOf('/');
+  if (idx !== -1) {
+    return '.' + url.slice(idx);
+  } else {
+    return Math.random().toString(16).slice(2);
+  }
 }
 

package/dist/cache.d.ts

@@ -0,0 +1,16 @@
+/**
+ *****************************************
+ * 缓存
+ *****************************************
+ */
+export interface Cache<T, P> {
+    set(id: T, handler: (id: T) => P): P;
+    get(id: T, handler: (id: T) => P): P;
+}
+/**
+ *****************************************
+ * 创建缓存
+ *****************************************
+ */
+export declare function cache<T, P>(map?: Map<T, P>): Cache<T, P>;
+export declare function cache<T extends object, P>(map: WeakMap<T, P>): Cache<T, P>;

package/dist/cache.js

@@ -0,0 +1,24 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-19 12:43:17
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cache = cache;
+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/dist/dict.d.ts

@@ -0,0 +1,21 @@
+/**
+ *****************************************
+ * 字典对象
+ *****************************************
+ */
+export declare class Dict<T> {
+    /** 键值映射 */
+    private data;
+    /** 键列表 */
+    private keys;
+    /** 添加映射 */
+    set(key: string, value: T): this;
+    /** 获取值 */
+    get(key: string): T | undefined;
+    /** 遍历 */
+    map<P>(handler: (key: string, value: T) => P): Dict<P>;
+    /** 排序 */
+    sort(handler: (a: string, b: string) => number): this;
+    /** 匹配对象 */
+    match<P>(handler: (value: T, key: string) => P | undefined): P | undefined;
+}

package/dist/dict.js

@@ -0,0 +1,66 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-06-11 22:56:35
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Dict = void 0;
+/**
+ *****************************************
+ * 字典对象
+ *****************************************
+ */
+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;
+            }
+        }
+    }
+}
+exports.Dict = Dict;

package/dist/downloadFile.js

@@ -28,11 +28,10 @@ async function downloadFile(dest, url) {
             if (size < total) {
                 print(`  -> ${((size / total) * 100).toFixed(2)}% (${format(size)}/${format(total)})`);
             }
-            else {
-                print('[download]: done');
-            }
         },
     });
+    // 下载完成
+    print('[download]: done', true);
 }
 /**
  *****************************************
@@ -54,6 +53,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';
 /**
  *****************************************
  * 进度条
@@ -61,23 +70,20 @@ function format(bytes) {
  */
 function stdout() {
     let progressContent = '';
-    let progressSize = 0;
     let progressTime = 0;
-    return function print(content) {
+    return function print(content, flush) {
         const now = Date.now();
-        if (content === progressContent || now - progressTime < 1000) {
+        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/dist/index.d.ts

@@ -1,3 +1,27 @@
+/**
+ *****************************************
+ * 导出类型
+ *****************************************
+ */
+export type { PackageConfig, PackageDescription, TargetDescription } from './loadPackageDescription';
+export type { TsConfigDescription, TsConfig, CompilerOptions, WatchOptions } from './loadTsConfig';
+export type { FileSystem } from './sys';
+/**
+ *****************************************
+ * 文件系统
+ *****************************************
+ */
+export { sys } from './sys';
+/**
+ *****************************************
+ * 导出工具
+ *****************************************
+ */
+export { unary, noop, nil, match } from './match';
+export { split } from './split';
+export { cache } from './cache';
+export { retry } from './retry';
+export { Dict } from './dict';
 /**
  *****************************************
  * 导出接口
@@ -6,8 +30,8 @@
 export { resolve, join, isAbsolute } from 'node:path';
 export { relative, isRelative } from './relative';
 export { dirname } from './dirname';
+export { isEsmModule, isEsmFile, isEsmPackage } from './isEsmModule';
 export { stat, isDir, isFile } from './stat';
-export { resolveFile } from './resolveFile';
 export { readFile } from './readFile';
 export { writeFile } from './writeFile';
 export { copy } from './copy';
@@ -17,3 +41,15 @@ export { md5 } from './md5';
 export { json, jsonc } from './jsonc';
 export { findUp } from './findUp';
 export { download } from './download';
+export { downloadFile } from './downloadFile';
+export { loadPackageDescription, resolvePackageDescription } from './loadPackageDescription';
+export { loadTsConfig, loadCompilerOptions, resolveTsConfig } from './loadTsConfig';
+export { resolveAlias, resolveDict } from './resolveAlias';
+export { resolvePaths } from './resolvePaths';
+export { resolvePath } from './resolvePath';
+export { resolveFile } from './resolveFile';
+export { resolveDirect } from './resolveDirect';
+export { resolveImports } from './resolveImports';
+export { resolveExports } from './resolveExports';
+export { resolveModuleDir, resolveModuleDirs } from './resolveModuleDir';
+export { resolveModuleId } from './resolveModuleId';

package/dist/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/dist/index.js

@@ -6,7 +6,32 @@
  */
 'use strict';
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.download = exports.findUp = exports.jsonc = exports.json = exports.md5 = exports.lookup = exports.rm = exports.copy = exports.writeFile = exports.readFile = exports.resolveFile = exports.isFile = exports.isDir = exports.stat = exports.dirname = exports.isRelative = exports.relative = exports.isAbsolute = exports.join = exports.resolve = void 0;
+exports.resolveModuleId = exports.resolveModuleDirs = exports.resolveModuleDir = exports.resolveExports = exports.resolveImports = exports.resolveDirect = exports.resolveFile = exports.resolvePath = exports.resolvePaths = exports.resolveDict = exports.resolveAlias = exports.resolveTsConfig = exports.loadCompilerOptions = exports.loadTsConfig = exports.resolvePackageDescription = exports.loadPackageDescription = exports.downloadFile = exports.download = exports.findUp = exports.jsonc = exports.json = exports.md5 = exports.lookup = exports.rm = exports.copy = exports.writeFile = exports.readFile = exports.isFile = exports.isDir = exports.stat = exports.isEsmPackage = exports.isEsmFile = exports.isEsmModule = exports.dirname = exports.isRelative = exports.relative = exports.isAbsolute = exports.join = exports.resolve = exports.Dict = exports.retry = exports.cache = exports.split = exports.match = exports.nil = exports.noop = exports.unary = exports.sys = void 0;
+/**
+ *****************************************
+ * 文件系统
+ *****************************************
+ */
+var sys_1 = require("./sys");
+Object.defineProperty(exports, "sys", { enumerable: true, get: function () { return sys_1.sys; } });
+/**
+ *****************************************
+ * 导出工具
+ *****************************************
+ */
+var match_1 = require("./match");
+Object.defineProperty(exports, "unary", { enumerable: true, get: function () { return match_1.unary; } });
+Object.defineProperty(exports, "noop", { enumerable: true, get: function () { return match_1.noop; } });
+Object.defineProperty(exports, "nil", { enumerable: true, get: function () { return match_1.nil; } });
+Object.defineProperty(exports, "match", { enumerable: true, get: function () { return match_1.match; } });
+var split_1 = require("./split");
+Object.defineProperty(exports, "split", { enumerable: true, get: function () { return split_1.split; } });
+var cache_1 = require("./cache");
+Object.defineProperty(exports, "cache", { enumerable: true, get: function () { return cache_1.cache; } });
+var retry_1 = require("./retry");
+Object.defineProperty(exports, "retry", { enumerable: true, get: function () { return retry_1.retry; } });
+var dict_1 = require("./dict");
+Object.defineProperty(exports, "Dict", { enumerable: true, get: function () { return dict_1.Dict; } });
 /**
  *****************************************
  * 导出接口
@@ -21,12 +46,14 @@ Object.defineProperty(exports, "relative", { enumerable: true, get: function ()
 Object.defineProperty(exports, "isRelative", { enumerable: true, get: function () { return relative_1.isRelative; } });
 var dirname_1 = require("./dirname");
 Object.defineProperty(exports, "dirname", { enumerable: true, get: function () { return dirname_1.dirname; } });
+var isEsmModule_1 = require("./isEsmModule");
+Object.defineProperty(exports, "isEsmModule", { enumerable: true, get: function () { return isEsmModule_1.isEsmModule; } });
+Object.defineProperty(exports, "isEsmFile", { enumerable: true, get: function () { return isEsmModule_1.isEsmFile; } });
+Object.defineProperty(exports, "isEsmPackage", { enumerable: true, get: function () { return isEsmModule_1.isEsmPackage; } });
 var stat_1 = require("./stat");
 Object.defineProperty(exports, "stat", { enumerable: true, get: function () { return stat_1.stat; } });
 Object.defineProperty(exports, "isDir", { enumerable: true, get: function () { return stat_1.isDir; } });
 Object.defineProperty(exports, "isFile", { enumerable: true, get: function () { return stat_1.isFile; } });
-var resolveFile_1 = require("./resolveFile");
-Object.defineProperty(exports, "resolveFile", { enumerable: true, get: function () { return resolveFile_1.resolveFile; } });
 var readFile_1 = require("./readFile");
 Object.defineProperty(exports, "readFile", { enumerable: true, get: function () { return readFile_1.readFile; } });
 var writeFile_1 = require("./writeFile");
@@ -46,3 +73,32 @@ var findUp_1 = require("./findUp");
 Object.defineProperty(exports, "findUp", { enumerable: true, get: function () { return findUp_1.findUp; } });
 var download_1 = require("./download");
 Object.defineProperty(exports, "download", { enumerable: true, get: function () { return download_1.download; } });
+var downloadFile_1 = require("./downloadFile");
+Object.defineProperty(exports, "downloadFile", { enumerable: true, get: function () { return downloadFile_1.downloadFile; } });
+var loadPackageDescription_1 = require("./loadPackageDescription");
+Object.defineProperty(exports, "loadPackageDescription", { enumerable: true, get: function () { return loadPackageDescription_1.loadPackageDescription; } });
+Object.defineProperty(exports, "resolvePackageDescription", { enumerable: true, get: function () { return loadPackageDescription_1.resolvePackageDescription; } });
+var loadTsConfig_1 = require("./loadTsConfig");
+Object.defineProperty(exports, "loadTsConfig", { enumerable: true, get: function () { return loadTsConfig_1.loadTsConfig; } });
+Object.defineProperty(exports, "loadCompilerOptions", { enumerable: true, get: function () { return loadTsConfig_1.loadCompilerOptions; } });
+Object.defineProperty(exports, "resolveTsConfig", { enumerable: true, get: function () { return loadTsConfig_1.resolveTsConfig; } });
+var resolveAlias_1 = require("./resolveAlias");
+Object.defineProperty(exports, "resolveAlias", { enumerable: true, get: function () { return resolveAlias_1.resolveAlias; } });
+Object.defineProperty(exports, "resolveDict", { enumerable: true, get: function () { return resolveAlias_1.resolveDict; } });
+var resolvePaths_1 = require("./resolvePaths");
+Object.defineProperty(exports, "resolvePaths", { enumerable: true, get: function () { return resolvePaths_1.resolvePaths; } });
+var resolvePath_1 = require("./resolvePath");
+Object.defineProperty(exports, "resolvePath", { enumerable: true, get: function () { return resolvePath_1.resolvePath; } });
+var resolveFile_1 = require("./resolveFile");
+Object.defineProperty(exports, "resolveFile", { enumerable: true, get: function () { return resolveFile_1.resolveFile; } });
+var resolveDirect_1 = require("./resolveDirect");
+Object.defineProperty(exports, "resolveDirect", { enumerable: true, get: function () { return resolveDirect_1.resolveDirect; } });
+var resolveImports_1 = require("./resolveImports");
+Object.defineProperty(exports, "resolveImports", { enumerable: true, get: function () { return resolveImports_1.resolveImports; } });
+var resolveExports_1 = require("./resolveExports");
+Object.defineProperty(exports, "resolveExports", { enumerable: true, get: function () { return resolveExports_1.resolveExports; } });
+var resolveModuleDir_1 = require("./resolveModuleDir");
+Object.defineProperty(exports, "resolveModuleDir", { enumerable: true, get: function () { return resolveModuleDir_1.resolveModuleDir; } });
+Object.defineProperty(exports, "resolveModuleDirs", { enumerable: true, get: function () { return resolveModuleDir_1.resolveModuleDirs; } });
+var resolveModuleId_1 = require("./resolveModuleId");
+Object.defineProperty(exports, "resolveModuleId", { enumerable: true, get: function () { return resolveModuleId_1.resolveModuleId; } });

package/dist/isEsmModule.d.ts

@@ -0,0 +1,18 @@
+/**
+ *****************************************
+ * 判断是否为 ESM 模块
+ *****************************************
+ */
+export declare function isEsmModule(filename: string, dir?: string): boolean;
+/**
+ *****************************************
+ * 判断是否为 ESM 模块
+ *****************************************
+ */
+export declare function isEsmPackage(dir: string): boolean;
+/**
+ *****************************************
+ * 判断为 ESM 文件
+ *****************************************
+ */
+export declare function isEsmFile(filename: string): boolean | undefined;

package/dist/isEsmModule.js

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

package/dist/loadPackageDescription.d.ts

@@ -0,0 +1,61 @@
+/**
+ *****************************************
+ * 重定向描述
+ *****************************************
+ */
+export interface TargetDescription {
+    [key: string]: null | string | TargetDescription | (null | string | TargetDescription)[];
+}
+/**
+ *****************************************
+ * 包描述
+ *****************************************
+ */
+export interface PackageDescription {
+    name?: string;
+    version?: string;
+    description?: string;
+    type?: string;
+    types?: string;
+    main?: string;
+    imports?: TargetDescription;
+    exports?: null | string | string[] | TargetDescription;
+    files?: string[];
+    bin?: string | Record<string, string>;
+    scripts?: Record<string, string>;
+    repository?: string;
+    author?: string;
+    license?: string;
+    publishConfig?: Record<string, string | boolean | number>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+}
+/**
+ *****************************************
+ * 包配置
+ *****************************************
+ */
+export interface PackageConfig {
+    dir: string;
+    path: string;
+    config?: PackageDescription;
+}
+/**
+ *****************************************
+ * 加载包描述
+ *****************************************
+ */
+export declare function loadPackageDescription(from?: string): PackageDescription | undefined;
+/**
+ *****************************************
+ * 读取包描述
+ *****************************************
+ */
+export declare function readPackageDescription(dir: string): PackageDescription | undefined;
+/**
+ *****************************************
+ * 解析包配置
+ *****************************************
+ */
+export declare function resolvePackageDescription(from?: string): PackageConfig | undefined;

package/dist/loadPackageDescription.js

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