@ainc/fs 0.1.22 → 0.1.24

package/dist/resolveAlias.js

@@ -0,0 +1,82 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-26 22:30:23
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAlias = resolveAlias;
+exports.resolveDict = resolveDict;
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+const dict_1 = require("./dict");
+const cache_1 = require("./cache");
+const resolveDirect_1 = require("./resolveDirect");
+/**
+ *****************************************
+ * 缓存
+ *****************************************
+ */
+const cached = (0, cache_1.cache)(new WeakMap());
+/**
+ *****************************************
+ * 解析别名
+ *****************************************
+ */
+function resolveAlias(alias) {
+    return cached.get(alias, resolveTarget);
+}
+/**
+ *****************************************
+ * 解析别名
+ *****************************************
+ */
+function resolveTarget(alias) {
+    return resolveDict(alias, resolvePath);
+}
+/**
+ *****************************************
+ * 解析匹配路径
+ *****************************************
+ */
+function resolvePath(key, value) {
+    const { test, resolve } = (0, resolveDirect_1.resolveDirect)(key);
+    const rule = resolve(value);
+    // 返回匹配函数
+    return function match(id, handler) {
+        if (test(id)) {
+            return handler(rule(id));
+        }
+    };
+}
+/**
+ *****************************************
+ * 解析字典
+ *****************************************
+ */
+function resolveDict(data, handler) {
+    const result = new dict_1.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;
+}

package/dist/resolveDirect.d.ts

@@ -0,0 +1,15 @@
+/**
+ *****************************************
+ * 解析指令
+ *****************************************
+ */
+export interface Direct {
+    test(id: string): boolean;
+    resolve(path: string): (id: string) => string;
+}
+/**
+ *****************************************
+ * 解析指令
+ *****************************************
+ */
+export declare function resolveDirect(direct: string): Direct;

package/dist/resolveDirect.js

@@ -0,0 +1,144 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-18 13:32:09
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDirect = resolveDirect;
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+const node_path_1 = require("node:path");
+const match_1 = require("./match");
+const split_1 = require("./split");
+/**
+ *****************************************
+ * 格式化路径
+ *****************************************
+ */
+const sepReg = /\//g;
+const normalizePath = (path) => path.replace(sepReg, node_path_1.sep);
+/**
+ *****************************************
+ * 格式化路径
+ *****************************************
+ */
+function normalizeFn(path) {
+    return node_path_1.sep === '\\' && (0, node_path_1.isAbsolute)(path) ? normalizePath : match_1.unary;
+}
+/**
+ *****************************************
+ * 解析指令
+ *****************************************
+ */
+function resolveDirect(direct) {
+    const idx = direct.indexOf('*');
+    if (idx === -1) {
+        return {
+            test: id => id === direct,
+            resolve: path => () => path,
+        };
+    }
+    // 分割路径
+    const [prefix, suffix] = [direct.slice(0, idx), direct.slice(idx + 1)];
+    // 生成匹配规则
+    if (prefix) {
+        return suffix ? resolvePrefixSuffix(prefix, suffix) : resolvePrefix(prefix);
+    }
+    else {
+        return suffix ? resolveSuffix(suffix) : resolveWildcard();
+    }
+}
+/**
+ *****************************************
+ * 解析前/后缀
+ *****************************************
+ */
+function resolvePrefixSuffix(prefix, suffix) {
+    const size = prefix.length + suffix.length;
+    return {
+        test(id) {
+            return id.length >= size && id.startsWith(prefix) && id.endsWith(suffix);
+        },
+        resolve(path) {
+            const [start, end] = (0, split_1.split)(path, '*');
+            const normalize = normalizeFn(start);
+            if (end === undefined) {
+                return () => start;
+            }
+            else {
+                return (id) => start + normalize(id.slice(prefix.length, -suffix.length)) + end;
+            }
+        },
+    };
+}
+/**
+ *****************************************
+ * 解析前缀
+ *****************************************
+ */
+function resolvePrefix(prefix) {
+    return {
+        test(id) {
+            return id.startsWith(prefix);
+        },
+        resolve(path) {
+            const [start, end] = (0, split_1.split)(path, '*');
+            const normalize = normalizeFn(start);
+            if (end === undefined) {
+                return () => start;
+            }
+            else {
+                return (id) => start + normalize(id.slice(prefix.length)) + end;
+            }
+        },
+    };
+}
+/**
+ *****************************************
+ * 解析后缀
+ *****************************************
+ */
+function resolveSuffix(suffix) {
+    return {
+        test(id) {
+            return id.endsWith(suffix);
+        },
+        resolve(val) {
+            const [start, end] = (0, split_1.split)(val, '*');
+            const normalize = normalizeFn(start);
+            if (end === undefined) {
+                return () => start;
+            }
+            else {
+                return (id) => start + normalize(id.slice(0, -suffix.length)) + end;
+            }
+        },
+    };
+}
+/**
+ *****************************************
+ * 解析通配符
+ *****************************************
+ */
+function resolveWildcard() {
+    return {
+        test() {
+            return true;
+        },
+        resolve(val) {
+            const [start, end] = (0, split_1.split)(val, '*');
+            const normalize = normalizeFn(start);
+            if (end === undefined) {
+                return () => start;
+            }
+            else {
+                return (id) => start + normalize(id) + end;
+            }
+        },
+    };
+}

package/dist/resolveExports.d.ts

@@ -0,0 +1,19 @@
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { TargetDescription } from './loadPackageDescription';
+import { Handler } from './resolveAlias';
+/**
+ *****************************************
+ * 解析导出描述
+ *****************************************
+ */
+export declare function resolveTargetDescription(exports: (null | string | TargetDescription)[] | TargetDescription): TargetDescription;
+/**
+ *****************************************
+ * 解析导出配置
+ *****************************************
+ */
+export declare function resolveExports(id: string, conditions: string[], exports: TargetDescription[string], handler?: Handler): string | null | undefined;

package/dist/resolveExports.js

@@ -0,0 +1,54 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-27 21:02:36
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTargetDescription = resolveTargetDescription;
+exports.resolveExports = resolveExports;
+const resolveImports_1 = require("./resolveImports");
+/**
+ *****************************************
+ * 缓存
+ *****************************************
+ */
+const cache = new WeakMap();
+/**
+ *****************************************
+ * 解析导出描述
+ *****************************************
+ */
+function resolveTargetDescription(exports) {
+    const cached = cache.get(exports);
+    if (cached) {
+        return cached;
+    }
+    // 生成目标配置
+    const target = Array.isArray(exports) || !Object.keys(exports).some(key => key.charAt(0) === '.')
+        ? { '.': exports }
+        : exports;
+    // 添加缓存
+    cache.set(exports, target);
+    // 返回目标
+    return target;
+}
+/**
+ *****************************************
+ * 解析导出配置
+ *****************************************
+ */
+function resolveExports(id, conditions, exports, handler) {
+    if (!exports) {
+        return;
+    }
+    // 处理导出路径
+    if (typeof exports === 'string') {
+        return id === '.' ? exports : undefined;
+    }
+    // 解析导出描述
+    const target = resolveTargetDescription(exports);
+    // 获取匹配函数
+    return (0, resolveImports_1.resolveImports)(id, conditions, target, handler);
+}

package/dist/resolveImports.d.ts

@@ -0,0 +1,21 @@
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { TargetDescription } from './loadPackageDescription';
+import { Handler } from './resolveAlias';
+/**
+ *****************************************
+ * 映射函数
+ *****************************************
+ */
+export interface Direct {
+    [key: string]: Handler | Direct | (Handler | Direct)[];
+}
+/**
+ *****************************************
+ * 解析目标
+ *****************************************
+ */
+export declare function resolveImports(id: string, conditions: string[], target: TargetDescription, handler?: Handler): string | null | undefined;

package/dist/resolveImports.js

@@ -0,0 +1,114 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-06-22 11:21:37
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveImports = resolveImports;
+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 resolveImports(id, conditions, target, handler) {
+    const rules = cached.get(target, () => (0, resolveAlias_1.resolveDict)(target, resolveTargetDescription));
+    const resolve = handler || match_1.unary;
+    // 返回匹配函数
+    return rules.match(rule => {
+        if (rule.test(id)) {
+            return resolvePath(id, conditions, rule.direct, resolve);
+        }
+    });
+}
+/**
+ *****************************************
+ * 解析规则
+ *****************************************
+ */
+function resolveTargetDescription(key, value) {
+    const { test, resolve } = (0, resolveDirect_1.resolveDirect)(key);
+    // 返回配置规则
+    return {
+        test,
+        direct: walk(value, resolve),
+    };
+}
+/**
+ *****************************************
+ * 解析重定向
+ *****************************************
+ */
+function walk(value, handler) {
+    switch (typeof value) {
+        case 'string':
+            return handler(value);
+        case 'object':
+            break;
+        default:
+            return match_1.nil;
+    }
+    // 处理空目标
+    if (!value) {
+        return match_1.nil;
+    }
+    // 处理数组目标
+    if (Array.isArray(value)) {
+        return value.map(id => walk(id, handler));
+    }
+    // 定义结果
+    const direct = {};
+    // 遍历目标描述
+    Object.keys(value)
+        .forEach(key => {
+        direct[key] = walk(value[key], handler);
+    });
+    // 返回结果
+    return direct;
+}
+/**
+ *****************************************
+ * 解析规则
+ *****************************************
+ */
+function resolvePath(id, conditions, rule, handler) {
+    switch (typeof rule) {
+        case 'function':
+            return resolvePath(id, conditions, rule(id), handler);
+        case 'string':
+            return handler(rule);
+        case 'object':
+            break;
+        default:
+            return;
+    }
+    // 处理空规则
+    if (!rule) {
+        return null;
+    }
+    // 处理数组
+    if (Array.isArray(rule)) {
+        return (0, match_1.match)(rule, value => resolvePath(id, conditions, value, handler));
+    }
+    // 处理条件映射
+    const condition = conditions.find(key => rule[key]);
+    const value = condition ? rule[condition] : rule.default;
+    // 存在解析时，继续解析
+    if (value) {
+        return resolvePath(id, conditions, value, handler);
+    }
+    else {
+        return value;
+    }
+}

package/dist/resolveModuleDir.d.ts

@@ -0,0 +1,12 @@
+/**
+ *****************************************
+ * 解析模块目录
+ *****************************************
+ */
+export declare function resolveModuleDir(id: string, from: string): string | undefined;
+/**
+ *****************************************
+ * 解析模块目录列表
+ *****************************************
+ */
+export declare function resolveModuleDirs(from: string | undefined): string[];

package/dist/resolveModuleDir.js

@@ -0,0 +1,67 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-29 20:26:27
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveModuleDir = resolveModuleDir;
+exports.resolveModuleDirs = resolveModuleDirs;
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+const node_path_1 = require("node:path");
+const dirname_1 = require("./dirname");
+const stat_1 = require("./stat");
+const match_1 = require("./match");
+/**
+ *****************************************
+ * 模块路径缓存
+ *****************************************
+ */
+const cacheModuleDirs = new Map();
+const cacheModuleDir = new Map();
+/**
+ *****************************************
+ * 解析模块目录
+ *****************************************
+ */
+function resolveModuleDir(id, from) {
+    const cacheId = `${from}:${id}`;
+    if (cacheModuleDir.has(cacheId)) {
+        return cacheModuleDir.get(cacheId);
+    }
+    // 解析目录
+    const dirs = resolveModuleDirs(from);
+    const result = (0, match_1.match)(dirs, dir => (0, stat_1.isDir)((0, node_path_1.resolve)(dir, id)));
+    // 缓存结果
+    cacheModuleDir.set(cacheId, result);
+    // 返回结果
+    return result;
+}
+/**
+ *****************************************
+ * 解析模块目录列表
+ *****************************************
+ */
+function resolveModuleDirs(from) {
+    if (!from) {
+        return [];
+    }
+    // 存在缓存时，直接返回
+    const cached = cacheModuleDirs.get(from);
+    if (cached) {
+        return cached;
+    }
+    // 解析目录
+    const dirs = resolveModuleDirs((0, dirname_1.dirname)(from));
+    const dir = (0, node_path_1.join)(from, 'node_modules');
+    const result = (0, stat_1.isDir)(dir) ? [dir, ...dirs] : dirs;
+    // 缓存结果
+    cacheModuleDirs.set(from, result);
+    // 返回结果
+    return result;
+}

package/dist/resolveModuleId.d.ts

@@ -0,0 +1,6 @@
+/**
+ *****************************************
+ * 解析模块路径
+ *****************************************
+ */
+export declare function resolveModuleId(id: string): [string, string];

package/dist/resolveModuleId.js

@@ -0,0 +1,32 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-29 20:26:27
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveModuleId = resolveModuleId;
+/**
+ *****************************************
+ * 解析模块路径
+ *****************************************
+ */
+function resolveModuleId(id) {
+    const idx1 = id.indexOf('/');
+    // 处理不带域的模块路径
+    if (idx1 === -1) {
+        return [id, '.'];
+    }
+    else if (id.charAt(0) !== '@') {
+        return [id.slice(0, idx1), '.' + id.slice(idx1)];
+    }
+    // 分割模块路径
+    const idx2 = id.indexOf('/', idx1 + 1);
+    if (idx2 === -1) {
+        return [id, '.'];
+    }
+    else {
+        return [id.slice(0, idx2), '.' + id.slice(idx2)];
+    }
+}

package/dist/resolvePath.d.ts

@@ -0,0 +1,23 @@
+/**
+ *****************************************
+ * 文件系统
+ *****************************************
+ */
+export interface Options {
+    baseUrl?: string;
+    alias?: Record<string, string>;
+    paths?: Record<string, string[]>;
+    cache?: Map<string, string | null | undefined>;
+    cwd?: string;
+    module?: boolean;
+    moduleExports?: boolean;
+    mainFields?: string[];
+    conditions?: string[];
+    extensions?: string[];
+}
+/**
+ *****************************************
+ * 解析路径
+ *****************************************
+ */
+export declare function resolvePath(id: string, issuer?: string, options?: Options): string | null | undefined;

package/dist/resolvePath.js

@@ -0,0 +1,86 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-18 20:06:20
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePath = resolvePath;
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+const node_path_1 = require("node:path");
+const loadTsConfig_1 = require("./loadTsConfig");
+const sys_1 = require("./sys");
+const isEsmModule_1 = require("./isEsmModule");
+/**
+ *****************************************
+ * 创建文件系统
+ *****************************************
+ */
+function createFileSystem(options) {
+    return {
+        ...sys_1.sys,
+        ...options,
+        cache: options.cache || sys_1.sys.cache,
+        cwd: options.cwd || sys_1.sys.cwd,
+        mainFields: options.mainFields || sys_1.sys.mainFields,
+        conditions: options.conditions || sys_1.sys.conditions,
+        extensions: options.extensions || sys_1.sys.extensions,
+    };
+}
+/**
+ *****************************************
+ * 判断是否为 ESM 模块
+ *****************************************
+ */
+function isEsmModule(dir, filename) {
+    if (filename) {
+        const result = (0, isEsmModule_1.isEsmFile)(filename);
+        if (result !== undefined) {
+            return result;
+        }
+    }
+    // 判断为 ESM 模块
+    if ((0, isEsmModule_1.isEsmPackage)(dir)) {
+        return true;
+    }
+    // 判断 TS 配置
+    const { module } = (0, loadTsConfig_1.loadCompilerOptions)(dir) || {};
+    if (module && module.toLowerCase().startsWith('es')) {
+        return true;
+    }
+    else {
+        return false;
+    }
+}
+/**
+ *****************************************
+ * 解析路径
+ *****************************************
+ */
+function resolvePath(id, issuer, options) {
+    const from = issuer ? (0, node_path_1.dirname)((0, node_path_1.resolve)(issuer)) : process.cwd();
+    const opts = options || {};
+    const sys = createFileSystem(opts);
+    // 设置模块路径映射
+    if (!opts.paths && !opts.baseUrl) {
+        const { baseUrl, paths } = (0, loadTsConfig_1.loadCompilerOptions)(from) || {};
+        sys.baseUrl = baseUrl;
+        sys.paths = paths;
+    }
+    else {
+        sys.baseUrl = opts.baseUrl && (0, node_path_1.resolve)(opts.baseUrl);
+    }
+    // 设置加载条件
+    if (!opts.conditions) {
+        sys.conditions = isEsmModule(from, issuer) ? ['import', 'node'] : ['require', 'node'];
+    }
+    // 生成缓存 ID
+    sys.cacheSalt = sys.conditions.join(',');
+    // 执行解析
+    return sys.resolve(id, from);
+}

package/dist/resolvePaths.d.ts

@@ -0,0 +1,13 @@
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { Dict } from './dict';
+import { Match } from './resolveAlias';
+/**
+ *****************************************
+ * 解析别名
+ *****************************************
+ */
+export declare function resolvePaths(paths: Record<string, string[]>): Dict<Match>;