@ainc/fs 0.1.22 → 0.1.23

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/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;
+}

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;
+    }
+}