@ainc/fs 0.1.22 → 0.1.24

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 { gzip, ungzip } from './gzip.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 };
+            }
+        },
+    });
+}

package/esm/loadTsConfig.mjs

@@ -0,0 +1,215 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2023-12-30 13:48:09
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, resolve, sep, isAbsolute } from 'node:path';
+import { relative, isRelative } from './relative.mjs';
+import { resolveFile } from './resolveFile.mjs';
+import { isFile } from './stat.mjs';
+import { lookup } from './lookup.mjs';
+import { jsonc } from './jsonc.mjs';
+import { match } from './match.mjs';
+import { resolveModuleDirs } from './resolveModuleDir.mjs';
+/**
+ *****************************************
+ * 加载 TS 配置
+ *****************************************
+ */
+export function loadTsConfig(from) {
+    const data = resolveTsConfig(from);
+    // 返回配置
+    if (data) {
+        return data.config;
+    }
+}
+/**
+ *****************************************
+ * 加载编译配置
+ *****************************************
+ */
+export function loadCompilerOptions(from) {
+    const data = resolveTsConfig(from);
+    // 返回配置
+    if (data && data.config) {
+        return data.config.compilerOptions;
+    }
+}
+/**
+ *****************************************
+ * 缓存内容
+ *****************************************
+ */
+const cache = new Map();
+/**
+ *****************************************
+ * 解析 TS 配置
+ *****************************************
+ */
+export function resolveTsConfig(from) {
+    return lookup('tsconfig.json', {
+        from,
+        cache,
+        resolve(path) {
+            return isFile(path) ? loadTsConfigFile(path) : undefined;
+        },
+    });
+}
+/**
+ *****************************************
+ * 解析 TS 配置文件
+ *****************************************
+ */
+function loadTsConfigFile(path) {
+    const config = parseTsConfig(path, new Set([path]), ['.json', sep + 'tsconfig.json']);
+    const dir = dirname(path);
+    // 移除继承属性
+    config.extends = undefined;
+    // 格式化 include 配置
+    if (config.include) {
+        config.include = config.include.map(path => relative(dir, path));
+    }
+    // 格式化 exclude 配置
+    if (config.exclude) {
+        config.exclude = config.exclude.map(path => relative(dir, path));
+    }
+    // 格式化 files 配置
+    if (config.files) {
+        config.files = config.files.map(path => relative(dir, path));
+    }
+    // 返回结果
+    return { path, config };
+}
+/**
+ *****************************************
+ * 解析配置
+ *****************************************
+ */
+function parseTsConfig(path, tracker, extensions) {
+    const data = jsonc(readFileSync(path, 'utf8'));
+    const dir = dirname(path);
+    const config = normalizeTsConfig(data, dir);
+    // 不存在继承，直接返回
+    if (!config.extends) {
+        return config;
+    }
+    // 获取继承列表
+    const extendsList = Array.isArray(config.extends) ? config.extends : [config.extends];
+    const configs = extendsList.map(path => parseExtendsTsConfig(path, dir, tracker, extensions));
+    // 追加当前配置
+    configs.push(config);
+    // 合并配置
+    return configs.reduce(mergeTsConfig);
+}
+/**
+ *****************************************
+ * 合并配置
+ *****************************************
+ */
+function mergeTsConfig(target, source) {
+    const { baseUrl, paths } = source.compilerOptions || {};
+    const config = { ...target, ...source };
+    // 合并配置项
+    config.compilerOptions = { ...target.compilerOptions, ...source.compilerOptions };
+    config.watchOptions = { ...target.watchOptions, ...source.watchOptions };
+    // 更新 paths 配置
+    if (baseUrl || paths) {
+        config.compilerOptions.baseUrl = baseUrl;
+        config.compilerOptions.paths = paths;
+    }
+    // 返回配置
+    return config;
+}
+/**
+ *****************************************
+ * 解析继承配置
+ *****************************************
+ */
+function parseExtendsTsConfig(path, from, tracker, extensions) {
+    const extendsFile = resolveExtendsFile(path, from, extensions);
+    // 未找到文件
+    if (!extendsFile) {
+        throw new Error(`file '${path}' not found.`);
+    }
+    // 循环引用
+    if (tracker.has(extendsFile)) {
+        throw new Error(`circularity detected while resolving configuration: ${extendsFile}`);
+    }
+    // 添加引用文件
+    tracker.add(extendsFile);
+    // 解析文件
+    return parseTsConfig(extendsFile, tracker, extensions);
+}
+/**
+ *****************************************
+ * 解析继承文件地址
+ *****************************************
+ */
+function resolveExtendsFile(path, from, extensions) {
+    // 解析相对路径
+    if (isRelative(path)) {
+        return resolveFile(resolve(from, path), extensions);
+    }
+    // 解析绝对路径
+    if (isAbsolute(path)) {
+        return resolveFile(path, extensions);
+    }
+    // 解析模块目录
+    const moduleDirs = resolveModuleDirs(from);
+    // 模块目录
+    return match(moduleDirs, dir => resolveFile(resolve(dir, path), extensions));
+}
+/**
+ *****************************************
+ * 格式化配置
+ *****************************************
+ */
+function normalizeTsConfig(config, dir) {
+    const compilerOptions = config.compilerOptions;
+    const watchOptions = config.watchOptions;
+    // 格式化 include 配置
+    if (config.include) {
+        config.include = config.include.map(path => resolve(dir, path));
+    }
+    // 格式化 exclude 配置
+    if (config.exclude) {
+        config.exclude = config.exclude.map(path => resolve(dir, path));
+    }
+    // 格式化 files 配置
+    if (config.files) {
+        config.files = config.files.map(path => resolve(dir, path));
+    }
+    // 格式化 compilerOptions 配置
+    if (compilerOptions) {
+        // 格式化 baseUrl 配置
+        if (compilerOptions.baseUrl) {
+            compilerOptions.baseUrl = resolve(dir, compilerOptions.baseUrl);
+        }
+        // 格式化 outDir 配置
+        if (compilerOptions.outDir) {
+            compilerOptions.outDir = resolve(dir, compilerOptions.outDir);
+        }
+        // 格式化 rootDir 配置
+        if (compilerOptions.rootDir) {
+            compilerOptions.rootDir = resolve(dir, compilerOptions.rootDir);
+        }
+        // 格式化 rootDirs 配置
+        if (compilerOptions.rootDirs) {
+            compilerOptions.rootDirs = compilerOptions.rootDirs.map(path => resolve(dir, path));
+        }
+    }
+    // 格式化监听路径
+    if (watchOptions && watchOptions.excludeDirectories) {
+        watchOptions.excludeDirectories = watchOptions.excludeDirectories.map(path => resolve(dir, path));
+    }
+    // 返回配置
+    return config;
+}

package/esm/match.mjs

@@ -0,0 +1,53 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-18 15:12:42
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 空函数
+ *****************************************
+ */
+export function noop() {
+    // do nothing
+}
+/**
+ *****************************************
+ * nil 函数
+ *****************************************
+ */
+export function nil() {
+    return null;
+}
+/**
+ *****************************************
+ * false
+ *****************************************
+ */
+export function falsy() {
+    return false;
+}
+/**
+ *****************************************
+ * 一元函数
+ *****************************************
+ */
+export function unary(value) {
+    return value;
+}
+/**
+ *****************************************
+ * 执行匹配
+ *****************************************
+ */
+export function match(list, handler) {
+    for (let i = 0; i < list.length; i++) {
+        const result = handler(list[i]);
+        // 查找到结果
+        if (result !== undefined) {
+            return result;
+        }
+    }
+}

package/esm/promises.mjs

@@ -0,0 +1,96 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-21 12:37:59
+ *****************************************
+ */
+'use strict';
+import { dirname } from 'node:path';
+import * as fs from 'node:fs/promises';
+/**
+ *****************************************
+ * 获取文件状态
+ *****************************************
+ */
+export async function stat(path, options) {
+    return fs.stat(path, options).catch(err => err.code === 'ENOENT' ? null : Promise.reject(err));
+}
+/**
+ *****************************************
+ * 删除文件
+ *****************************************
+ */
+export async function rm(path, options) {
+    if (await stat(path)) {
+        await fs.rm(path, { force: true, recursive: true, ...options });
+    }
+}
+/**
+ *****************************************
+ * 创建文件目录
+ *****************************************
+ */
+export async function mkdir(path, options) {
+    const stats = await stat(path);
+    const opts = { recursive: true, ...options };
+    // 创建目录
+    if (!stats) {
+        await fs.mkdir(path, opts);
+        return true;
+    }
+    else if (stats.isDirectory()) {
+        return true;
+    }
+    else if (!opts.force) {
+        return false;
+    }
+    else {
+        await fs.unlink(path);
+        await fs.mkdir(path, opts);
+        return true;
+    }
+}
+/**
+ *****************************************
+ * pipe
+ *****************************************
+ */
+export async function pipe(src, dest, options) {
+    return new Promise((resolve, reject) => {
+        src.once('close', resolve);
+        src.once('error', reject);
+        src.pipe(dest, options);
+    });
+}
+/**
+ *****************************************
+ * 读取文件
+ *****************************************
+ */
+export async function readFile(path) {
+    const stats = await stat(path);
+    if (stats && !stats.isDirectory()) {
+        return fs.readFile(path, 'utf8');
+    }
+}
+/**
+ *****************************************
+ * 写入文件
+ *****************************************
+ */
+export async function writeFile(path, content, options) {
+    const stats = await stat(path);
+    if (stats) {
+        if (!options || !options.force) {
+            return false;
+        }
+        else {
+            await rm(path);
+        }
+    }
+    // 写入文件内容
+    await fs.mkdir(dirname(path), { recursive: true });
+    await fs.writeFile(path, content);
+    // 返回结果
+    return true;
+}

package/esm/resolveAlias.mjs

@@ -0,0 +1,79 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-26 22:30:23
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { Dict } from './dict.mjs';
+import { cache } from './cache.mjs';
+import { resolveDirect } from './resolveDirect.mjs';
+/**
+ *****************************************
+ * 缓存
+ *****************************************
+ */
+const cached = cache(new WeakMap());
+/**
+ *****************************************
+ * 解析别名
+ *****************************************
+ */
+export function resolveAlias(alias) {
+    return cached.get(alias, resolveTarget);
+}
+/**
+ *****************************************
+ * 解析别名
+ *****************************************
+ */
+function resolveTarget(alias) {
+    return resolveDict(alias, resolvePath);
+}
+/**
+ *****************************************
+ * 解析匹配路径
+ *****************************************
+ */
+function resolvePath(key, value) {
+    const { test, resolve } = resolveDirect(key);
+    const rule = resolve(value);
+    // 返回匹配函数
+    return function match(id, handler) {
+        if (test(id)) {
+            return handler(rule(id));
+        }
+    };
+}
+/**
+ *****************************************
+ * 解析字典
+ *****************************************
+ */
+export function resolveDict(data, handler) {
+    const result = new Dict();
+    // 生成元素
+    Object.keys(data)
+        .forEach(key => result.set(key, handler(key, data[key])));
+    // 排序列表
+    result.sort((a, b) => {
+        const idxA = a.indexOf('*');
+        const idxB = b.indexOf('*');
+        const baseA = idxA === -1 ? a.length : idxA;
+        const baseB = idxB === -1 ? b.length : idxB;
+        // 比较基准长度
+        if (baseA !== baseB) {
+            return baseB - baseA;
+        }
+        else {
+            return idxA === -1 ? -1 : idxB === -1 ? 1 : b.length - a.length;
+        }
+    });
+    // 返回结果
+    return result;
+}