@ainc/fs 0.1.22 → 0.1.23

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

package/esm/sys.mjs

@@ -0,0 +1,258 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-06-29 16:06:27
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { fileURLToPath } from 'node:url';
+import { resolve, isAbsolute, sep } from 'node:path';
+import { builtinModules } from 'node:module';
+import { isRelative } from './relative.mjs';
+import { stat } from './stat.mjs';
+import { resolvePackageDescription } from './loadPackageDescription.mjs';
+import { resolveModuleId } from './resolveModuleId.mjs';
+import { resolveModuleDir } from './resolveModuleDir.mjs';
+import { resolveAlias } from './resolveAlias.mjs';
+import { resolvePaths } from './resolvePaths.mjs';
+import { resolveImports } from './resolveImports.mjs';
+import { resolveExports } from './resolveExports.mjs';
+/**
+ *****************************************
+ * 全局缓存
+ *****************************************
+ */
+const cache = new Map();
+/**
+ *****************************************
+ * 文件系统
+ *****************************************
+ */
+export const sys = {
+    /** 解析基准路径 */
+    baseUrl: undefined,
+    /** 别名配置 */
+    alias: undefined,
+    /** 路径配置 */
+    paths: undefined,
+    /** 缓存 ID */
+    cacheSalt: '',
+    /** 缓存 */
+    cache,
+    /** 当前目录 */
+    cwd: process.cwd(),
+    /** 是否解析模块 */
+    module: true,
+    /** 是否解析模块导出 */
+    moduleExports: true,
+    /** 解析 main 字段 */
+    mainFields: ['main'],
+    /** 解析条件 */
+    conditions: ['require', 'node'],
+    /** 解析扩展名 */
+    extensions: ['.ts', '.tsx', '.js', '.json', '.jsx', '.mjs', '.cjs', '.mts', '.cts', '.node', '.wasm'],
+    /** 解析路径 */
+    resolve(id, from) {
+        const cacheId = `${from}\x00${id}`;
+        const cacheSaltId = `${cacheId}\x00${this.cacheSalt}`;
+        // 存在缓存时，直接返回
+        if (this.cache.has(cacheId)) {
+            return this.cache.get(cacheId);
+        }
+        // 存在缓存时，直接返回
+        if (this.cache.has(cacheSaltId)) {
+            return this.cache.get(cacheSaltId);
+        }
+        // 添加缓存，避免循环解析
+        this.cache.set(cacheSaltId, null);
+        // 匹配规则
+        const rules = [
+            [cacheId, this.resolveBuiltin],
+            [cacheSaltId, this.resolveModuleImports],
+            [cacheId, this.resolveFile],
+            [cacheSaltId, this.resolveModule],
+        ];
+        // 解析规则
+        for (let i = 0, l = rules.length; i < l; i++) {
+            const [cacheId, handler] = rules[i];
+            const resolved = handler.call(this, id, from);
+            if (resolved !== undefined) {
+                this.cache.set(cacheId, resolved);
+                return resolved;
+            }
+        }
+    },
+    /** 解析内部模块 */
+    resolveBuiltin(id) {
+        if (builtinModules.includes(id)) {
+            return id;
+        }
+        // 处理内置模块
+        const prefix = id.slice(0, 5);
+        if (prefix === 'node:') {
+            return id;
+        }
+        // 处理 URL 路径
+        if (prefix === 'file:') {
+            return fileURLToPath(id);
+        }
+        // 处理资源路径
+        if (prefix === 'data:' || prefix === 'http:' || id.startsWith('https:')) {
+            return id;
+        }
+    },
+    /** 解析文件 */
+    resolveFile(id, from) {
+        // 解析相对路径
+        if (isRelative(id)) {
+            return this.resolveTarget(resolve(from, id));
+        }
+        // 解析绝对路径
+        if (isAbsolute(id)) {
+            return this.resolveTarget(id);
+        }
+        // 解析别名
+        if (this.alias) {
+            const alias = resolveAlias(this.alias);
+            const resolved = alias.match(resolve => resolve(id, alias => this.resolve(alias, this.cwd)));
+            if (resolved !== undefined) {
+                return resolved;
+            }
+        }
+        // 解析基准路径
+        if (this.baseUrl) {
+            const resolved = this.resolveTarget(resolve(this.baseUrl, id));
+            if (resolved !== undefined) {
+                return resolved;
+            }
+        }
+        // 解析路径映射
+        if (this.paths) {
+            const baseUrl = this.baseUrl || this.cwd;
+            const paths = resolvePaths(this.paths);
+            const resolved = paths.match(resolve => resolve(id, alias => this.resolve(alias, baseUrl)));
+            if (resolved !== undefined) {
+                return resolved;
+            }
+        }
+    },
+    /** 解析文件目标 */
+    resolveTarget(path) {
+        const stats = stat(path);
+        // 目标存在时，需要解析目标是目录的情况
+        if (stats) {
+            return stats.isDirectory() ? this.resolveDir(path) : path;
+        }
+        else {
+            return this.resolveExtensions(path);
+        }
+    },
+    /** 解析目录 */
+    resolveDir(path) {
+        const pkg = resolvePackageDescription(path);
+        // 解析主入口配置
+        if (pkg && pkg.dir === path && pkg.config) {
+            return this.resolveMainFile(path, pkg.config);
+        }
+        else {
+            return this.resolveIndex(path);
+        }
+    },
+    /** 解析 main 文件 */
+    resolveMainFile(path, pkg) {
+        for (let i = 0, l = this.mainFields.length; i < l; i++) {
+            const main = pkg[this.mainFields[i]];
+            // 存在主入口文件配置
+            if (main) {
+                return this.resolveTarget(resolve(path, main));
+            }
+        }
+        // 解析 index 文件
+        return this.resolveIndex(path);
+    },
+    /** 解析 index 文件 */
+    resolveIndex(path) {
+        return this.resolveExtensions(path + sep + 'index');
+    },
+    /** 解析扩展名 */
+    resolveExtensions(path) {
+        for (let i = 0, l = this.extensions.length; i < l; i++) {
+            const file = path + this.extensions[i];
+            const stats = stat(file);
+            if (stats && stats.isFile()) {
+                return file;
+            }
+        }
+    },
+    /** 解析包自身 */
+    resolveSelf(name, path, from) {
+        const pkg = resolvePackageDescription(from);
+        if (!pkg || !pkg.config) {
+            return;
+        }
+        // 获取配置
+        const { dir, config } = pkg;
+        // 解析模块导出
+        if (config.name === name) {
+            return this.resolveModuleExports(path, dir, config) || null;
+        }
+    },
+    /** 解析模块 */
+    resolveModule(id, from) {
+        const [name, subpath] = resolveModuleId(id);
+        const path = subpath === './' ? '.' : subpath;
+        // 解析当前包本身
+        const resolved = this.resolveSelf(name, path, from);
+        if (resolved !== undefined || this.module === false) {
+            return resolved;
+        }
+        // 解析模块目录
+        const dir = resolveModuleDir(name, from);
+        if (!dir) {
+            return;
+        }
+        // 读取包描述文件
+        const pkg = resolvePackageDescription(dir);
+        if (pkg && pkg.dir === dir && pkg.config) {
+            return this.resolveModuleExports(path, dir, pkg.config);
+        }
+        // 解析目标路径
+        if (path === '.') {
+            return this.resolveIndex(path);
+        }
+        else {
+            return this.resolveTarget(resolve(dir, path));
+        }
+    },
+    /** 解析模块导入 */
+    resolveModuleImports(id, from) {
+        const pkg = id.charAt(0) === '#' && resolvePackageDescription(from);
+        if (!pkg || !pkg.config || !pkg.config.imports) {
+            return;
+        }
+        // 执行配置
+        const imports = pkg.config.imports;
+        const dir = pkg.dir;
+        // 执行解析
+        return resolveImports(id, this.conditions, imports, path => this.resolve(path, dir));
+    },
+    /** 解析模块导出 */
+    resolveModuleExports(id, from, pkg) {
+        // 处理导出配置
+        if (pkg.exports && this.moduleExports) {
+            return resolveExports(id, this.conditions, pkg.exports, path => this.resolveTarget(resolve(from, path))) || null;
+        }
+        // 解析目标路径
+        if (id === '.') {
+            return this.resolveMainFile(from, pkg);
+        }
+        else {
+            return this.resolveTarget(resolve(from, id));
+        }
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainc/fs",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "description": "Let's do something nice with @ainc/esb!",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
@@ -43,11 +43,12 @@
     "jest": "^30.2.0"
   },
   "scripts": {
-    "build": "pnpm clean && pnpm compile && pnpm esm",
+    "build": "pnpm clean && pnpm compile && pnpm esm && pnpm exports",
     "watch": "pnpm compile --watch",
     "esm": "pnpm compile -m es2022 --outDir ./esm --declaration false && node ../../scripts/esm.js",
     "compile": "tsc -p ./tsconfig.build.json",
     "download": "node ./bin/download.mjs ./build/node-service.exe https://unpkg.com/@ainc/node-service-win32/core/node-service.exe",
+    "exports": "node ../../scripts/exports.js",
     "test": "jest",
     "clean": "rimraf ./dist ./esm"
   }