@ainc/fs 0.1.22 → 0.1.24

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.24",
   "description": "Let's do something nice with @ainc/esb!",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
@@ -32,22 +32,21 @@
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "typescript": "^5.9.3"
-  },
   "devDependencies": {
     "@jest/globals": "30.2.0",
     "@swc/core": "^1.15.8",
     "@swc/jest": "^0.2.39",
     "@types/node": "^25.0.3",
-    "jest": "^30.2.0"
+    "jest": "^30.2.0",
+    "typescript": "^5.9.3"
   },
   "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"
   }