@ainc/fs 0.1.22 → 0.1.24

package/esm/resolveDirect.mjs

@@ -0,0 +1,142 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-18 13:32:09
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { sep, isAbsolute } from 'node:path';
+import { unary } from './match.mjs';
+import { split } from './split.mjs';
+/**
+ *****************************************
+ * 格式化路径
+ *****************************************
+ */
+const sepReg = /\//g;
+const normalizePath = (path) => path.replace(sepReg, sep);
+/**
+ *****************************************
+ * 格式化路径
+ *****************************************
+ */
+function normalizeFn(path) {
+    return sep === '\\' && isAbsolute(path) ? normalizePath : unary;
+}
+/**
+ *****************************************
+ * 解析指令
+ *****************************************
+ */
+export 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] = 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] = 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] = 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] = split(val, '*');
+            const normalize = normalizeFn(start);
+            if (end === undefined) {
+                return () => start;
+            }
+            else {
+                return (id) => start + normalize(id) + end;
+            }
+        },
+    };
+}

package/esm/resolveExports.mjs

@@ -0,0 +1,51 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-27 21:02:36
+ *****************************************
+ */
+'use strict';
+import { resolveImports } from './resolveImports.mjs';
+/**
+ *****************************************
+ * 缓存
+ *****************************************
+ */
+const cache = new WeakMap();
+/**
+ *****************************************
+ * 解析导出描述
+ *****************************************
+ */
+export 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;
+}
+/**
+ *****************************************
+ * 解析导出配置
+ *****************************************
+ */
+export function resolveExports(id, conditions, exports, handler) {
+    if (!exports) {
+        return;
+    }
+    // 处理导出路径
+    if (typeof exports === 'string') {
+        return id === '.' ? exports : undefined;
+    }
+    // 解析导出描述
+    const target = resolveTargetDescription(exports);
+    // 获取匹配函数
+    return resolveImports(id, conditions, target, handler);
+}

package/esm/resolveImports.mjs

@@ -0,0 +1,112 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-06-22 11:21:37
+ *****************************************
+ */
+'use strict';
+import { match, nil, unary } from './match.mjs';
+import { cache } from './cache.mjs';
+import { resolveDict } from './resolveAlias.mjs';
+import { resolveDirect } from './resolveDirect.mjs';
+/**
+ *****************************************
+ * 缓存
+ *****************************************
+ */
+const cached = cache(new WeakMap());
+/**
+ *****************************************
+ * 解析目标
+ *****************************************
+ */
+export function resolveImports(id, conditions, target, handler) {
+    const rules = cached.get(target, () => resolveDict(target, resolveTargetDescription));
+    const resolve = handler || unary;
+    // 返回匹配函数
+    return rules.match(rule => {
+        if (rule.test(id)) {
+            return resolvePath(id, conditions, rule.direct, resolve);
+        }
+    });
+}
+/**
+ *****************************************
+ * 解析规则
+ *****************************************
+ */
+function resolveTargetDescription(key, value) {
+    const { test, resolve } = 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 nil;
+    }
+    // 处理空目标
+    if (!value) {
+        return 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 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/esm/resolveModuleDir.mjs

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

package/esm/resolveModuleId.mjs

@@ -0,0 +1,30 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-29 20:26:27
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 解析模块路径
+ *****************************************
+ */
+export 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/esm/resolvePath.mjs

@@ -0,0 +1,84 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-18 20:06:20
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { dirname, resolve } from 'node:path';
+import { loadCompilerOptions } from './loadTsConfig.mjs';
+import { sys } from './sys.mjs';
+import { isEsmFile, isEsmPackage } from './isEsmModule.mjs';
+/**
+ *****************************************
+ * 创建文件系统
+ *****************************************
+ */
+function createFileSystem(options) {
+    return {
+        ...sys,
+        ...options,
+        cache: options.cache || sys.cache,
+        cwd: options.cwd || sys.cwd,
+        mainFields: options.mainFields || sys.mainFields,
+        conditions: options.conditions || sys.conditions,
+        extensions: options.extensions || sys.extensions,
+    };
+}
+/**
+ *****************************************
+ * 判断是否为 ESM 模块
+ *****************************************
+ */
+function isEsmModule(dir, filename) {
+    if (filename) {
+        const result = isEsmFile(filename);
+        if (result !== undefined) {
+            return result;
+        }
+    }
+    // 判断为 ESM 模块
+    if (isEsmPackage(dir)) {
+        return true;
+    }
+    // 判断 TS 配置
+    const { module } = loadCompilerOptions(dir) || {};
+    if (module && module.toLowerCase().startsWith('es')) {
+        return true;
+    }
+    else {
+        return false;
+    }
+}
+/**
+ *****************************************
+ * 解析路径
+ *****************************************
+ */
+export function resolvePath(id, issuer, options) {
+    const from = issuer ? dirname(resolve(issuer)) : process.cwd();
+    const opts = options || {};
+    const sys = createFileSystem(opts);
+    // 设置模块路径映射
+    if (!opts.paths && !opts.baseUrl) {
+        const { baseUrl, paths } = loadCompilerOptions(from) || {};
+        sys.baseUrl = baseUrl;
+        sys.paths = paths;
+    }
+    else {
+        sys.baseUrl = opts.baseUrl && 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/esm/resolvePaths.mjs

@@ -0,0 +1,40 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-26 22:30:23
+ *****************************************
+ */
+'use strict';
+import { match } from './match.mjs';
+import { cache } from './cache.mjs';
+import { resolveDict } from './resolveAlias.mjs';
+import { resolveDirect } from './resolveDirect.mjs';
+/**
+ *****************************************
+ * 缓存
+ *****************************************
+ */
+const cached = cache(new WeakMap());
+/**
+ *****************************************
+ * 解析别名
+ *****************************************
+ */
+export function resolvePaths(paths) {
+    return cached.get(paths, () => resolveDict(paths, resolvePath));
+}
+/**
+ *****************************************
+ * 解析匹配规则
+ *****************************************
+ */
+function resolvePath(key, paths) {
+    const { test, resolve } = resolveDirect(key);
+    const rules = paths.map(resolve);
+    // 返回解析函数
+    return function resolve(id, handler) {
+        if (test(id)) {
+            return match(rules, direct => handler(direct(id)));
+        }
+    };
+}

package/esm/split.mjs

@@ -0,0 +1,22 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-24 23:56:16
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 分割字符串
+ *****************************************
+ */
+export 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)];
+    }
+}