@ainc/fs 0.1.22 → 0.1.23

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

package/dist/resolvePaths.js

@@ -0,0 +1,42 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-26 22:30:23
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePaths = resolvePaths;
+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 resolvePaths(paths) {
+    return cached.get(paths, () => (0, resolveAlias_1.resolveDict)(paths, resolvePath));
+}
+/**
+ *****************************************
+ * 解析匹配规则
+ *****************************************
+ */
+function resolvePath(key, paths) {
+    const { test, resolve } = (0, resolveDirect_1.resolveDirect)(key);
+    const rules = paths.map(resolve);
+    // 返回解析函数
+    return function resolve(id, handler) {
+        if (test(id)) {
+            return (0, match_1.match)(rules, direct => handler(direct(id)));
+        }
+    };
+}

package/dist/split.d.ts

@@ -0,0 +1,6 @@
+/**
+ *****************************************
+ * 分割字符串
+ *****************************************
+ */
+export declare function split(str: string, sep: string): [string, string | undefined];

package/dist/split.js

@@ -0,0 +1,24 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-24 23:56:16
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.split = split;
+/**
+ *****************************************
+ * 分割字符串
+ *****************************************
+ */
+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)];
+    }
+}

package/dist/sys.d.ts

@@ -0,0 +1,60 @@
+import { PackageDescription } from './loadPackageDescription';
+/**
+ *****************************************
+ * 文件系统
+ *****************************************
+ */
+export type FileSystem = typeof sys;
+/**
+ *****************************************
+ * 文件系统
+ *****************************************
+ */
+export declare const sys: {
+    /** 解析基准路径 */
+    baseUrl: string | undefined;
+    /** 别名配置 */
+    alias: Record<string, string> | undefined;
+    /** 路径配置 */
+    paths: Record<string, string[]> | undefined;
+    /** 缓存 ID */
+    cacheSalt: string;
+    /** 缓存 */
+    cache: Map<string, string | null | undefined>;
+    /** 当前目录 */
+    cwd: string;
+    /** 是否解析模块 */
+    module: boolean;
+    /** 是否解析模块导出 */
+    moduleExports: boolean;
+    /** 解析 main 字段 */
+    mainFields: string[];
+    /** 解析条件 */
+    conditions: string[];
+    /** 解析扩展名 */
+    extensions: string[];
+    /** 解析路径 */
+    resolve(id: string, from: string): string | null | undefined;
+    /** 解析内部模块 */
+    resolveBuiltin(id: string): string | undefined;
+    /** 解析文件 */
+    resolveFile(id: string, from: string): string | null | undefined;
+    /** 解析文件目标 */
+    resolveTarget(path: string): string | undefined;
+    /** 解析目录 */
+    resolveDir(path: string): string | undefined;
+    /** 解析 main 文件 */
+    resolveMainFile(path: string, pkg: PackageDescription): string | undefined;
+    /** 解析 index 文件 */
+    resolveIndex(path: string): string | undefined;
+    /** 解析扩展名 */
+    resolveExtensions(path: string): string | undefined;
+    /** 解析包自身 */
+    resolveSelf(name: string, path: string, from: string): string | null | undefined;
+    /** 解析模块 */
+    resolveModule(id: string, from: string): string | null | undefined;
+    /** 解析模块导入 */
+    resolveModuleImports(id: string, from: string): string | null | undefined;
+    /** 解析模块导出 */
+    resolveModuleExports(id: string, from: string, pkg: PackageDescription): string | null | undefined;
+};