@ainc/fs 0.1.19 → 0.1.21

package/esm/lookup.mjs

@@ -0,0 +1,48 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-29 20:56:24
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { resolve as resolvePath } from 'node:path';
+import { isFile } from './stat.mjs';
+import { dirname } from './dirname.mjs';
+/**
+ *****************************************
+ * 查找最近的文件
+ *****************************************
+ */
+export function lookup(name, options) {
+    const opts = { cache: new Map(), resolve: isFile, ...options };
+    const dir = opts.from ? resolvePath(opts.from) : process.cwd();
+    // 查找文件
+    return find(name, dir, opts);
+}
+/**
+ *****************************************
+ * 查找最近的文件
+ *****************************************
+ */
+function find(name, dir, options) {
+    const { cache, resolve } = options;
+    if (!dir) {
+        return;
+    }
+    // 解析路径
+    const path = resolvePath(dir, name);
+    if (cache.has(path)) {
+        return cache.get(path);
+    }
+    // 查找文件
+    const result = resolve(path, dir) || find(name, dirname(dir), options);
+    // 缓存结果
+    cache.set(path, result);
+    // 返回结果
+    return result;
+}

package/esm/md5.mjs

@@ -0,0 +1,21 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-02-25 16:27:15
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { createHash } from 'node:crypto';
+/**
+ *****************************************
+ * 生成 md5 签名
+ *****************************************
+ */
+export function md5(str) {
+    return createHash('md5').update(str, 'utf8').digest('hex');
+}

package/esm/mkdir.mjs

@@ -0,0 +1,37 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-25 11:15:33
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 创建目录
+ *****************************************
+ */
+import { mkdirSync, unlinkSync } from 'node:fs';
+import { stat } from './stat.mjs';
+/**
+ *****************************************
+ * 创建目录
+ *****************************************
+ */
+export function mkdir(dir, options) {
+    const stats = stat(dir);
+    if (!stats) {
+        return (mkdirSync(dir, { recursive: true }), true);
+    }
+    // 目录已存在
+    if (stats.isDirectory()) {
+        return true;
+    }
+    // 非强制模式下，返回失败
+    if (!options || !options.force) {
+        return false;
+    }
+    // 删除文件
+    unlinkSync(dir);
+    // 创建目录
+    return (mkdirSync(dir, { recursive: true }), true);
+}

package/esm/readFile.mjs

@@ -0,0 +1,21 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2023-12-31 10:20:08
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { readFileSync } from 'node:fs';
+/**
+ *****************************************
+ * 读取文件
+ *****************************************
+ */
+export function readFile(path) {
+    return readFileSync(path, 'utf8');
+}

package/esm/relative.mjs

@@ -0,0 +1,66 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2023-12-31 09:16:34
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { sep, relative as relativePath } from 'node:path';
+/**
+ *****************************************
+ * 判断是否为相对路径
+ *****************************************
+ */
+export function isRelative(id) {
+    // 判断是否以 '.' 开头
+    if (id.charAt(0) !== '.') {
+        return false;
+    }
+    // 获取字符
+    const c1 = id.charAt(1);
+    // 以 './' 开头
+    if (c1 === '/' || c1 === '') {
+        return true;
+    }
+    else if (c1 !== '.') {
+        return false;
+    }
+    // 获取下一字符
+    const c2 = id.charAt(2);
+    // 判断以
+    return c2 === '/' || c2 === '';
+}
+/**
+ *****************************************
+ * 获取相对路径
+ *****************************************
+ */
+export const relativeFrom = sep === '/'
+    ? relativePath
+    : function relativeFrom(from, to) {
+        return relativePath(from, to).replace(/\\/g, '/');
+    };
+/**
+ *****************************************
+ * 获取相对路径
+ *****************************************
+ */
+export function relative(from, to) {
+    const result = relativeFrom(from, to);
+    // 当前路径
+    if (!result) {
+        return './';
+    }
+    // 样式化路径
+    if (result === '.' || result === '..' || result.endsWith('/..')) {
+        return result + '/';
+    }
+    else {
+        return result.charAt(0) === '.' ? result : './' + result;
+    }
+}

package/esm/resolveFile.mjs

@@ -0,0 +1,36 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2023-12-31 09:29:59
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { resolve } from 'node:path';
+import { isFile } from './stat.mjs';
+/**
+ *****************************************
+ * 解析文件
+ *****************************************
+ */
+export function resolveFile(path, extensions) {
+    const dest = resolve(path);
+    if (isFile(dest)) {
+        return dest;
+    }
+    // 不再查找
+    if (!extensions || !extensions.length) {
+        return;
+    }
+    // 遍历扩展名
+    for (let i = 0; i < extensions.length; ++i) {
+        const file = dest + extensions[i];
+        if (isFile(file)) {
+            return file;
+        }
+    }
+}

package/esm/retry.mjs

@@ -0,0 +1,48 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-01 20:06:58
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 重试
+ *****************************************
+ */
+export function retry(times, handler) {
+    let count = 1;
+    // 重试处理
+    for (;;) {
+        try {
+            const res = handler();
+            if (res instanceof Promise) {
+                return res.catch(tryPromise);
+            }
+            else {
+                return res;
+            }
+        }
+        catch (err) {
+            if (count++ >= times) {
+                throw err;
+            }
+        }
+    }
+    // 异步重试
+    async function tryPromise(err) {
+        if (count++ >= times) {
+            throw err;
+        }
+        for (;;) {
+            try {
+                return await handler();
+            }
+            catch (err) {
+                if (count++ >= times) {
+                    throw err;
+                }
+            }
+        }
+    }
+}

package/esm/rm.mjs

@@ -0,0 +1,32 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2023-12-31 09:26:54
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { unlinkSync, rmSync } from 'node:fs';
+import { stat } from './stat.mjs';
+/**
+ *****************************************
+ * 删除文件或目录
+ *****************************************
+ */
+export function rm(path) {
+    const stats = stat(path);
+    // 不存在文件
+    if (!stats) {
+        return;
+    }
+    // 非目录
+    if (!stats.isDirectory()) {
+        return unlinkSync(path);
+    }
+    // 遍历文件
+    rmSync(path, { force: true, recursive: true });
+}

package/esm/stat.mjs

@@ -0,0 +1,45 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2023-12-31 09:11:28
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { statSync } from 'node:fs';
+/**
+ *****************************************
+ * 获取文件状态
+ *****************************************
+ */
+export function stat(path) {
+    return statSync(path, { throwIfNoEntry: false });
+}
+/**
+ *****************************************
+ * 判断为目录
+ *****************************************
+ */
+export function isDir(path) {
+    const stats = stat(path);
+    // 目录存在时，返回路径
+    if (stats && stats.isDirectory()) {
+        return path;
+    }
+}
+/**
+ *****************************************
+ * 判断为文件
+ *****************************************
+ */
+export function isFile(path) {
+    const stats = stat(path);
+    // 文件存在时，返回路径
+    if (stats && stats.isFile()) {
+        return path;
+    }
+}

package/esm/stripComments.mjs

@@ -0,0 +1,118 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2023-01-05 21:39:42
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 定义注释标识
+ *****************************************
+ */
+const singleComment = Symbol('singleComment');
+const multiComment = Symbol('multiComment');
+/**
+ *****************************************
+ * 判断是否转义
+ *****************************************
+ */
+function isEscaped(content, index) {
+    let backslashCount = 0;
+    let idx = index;
+    // 遍历字符
+    while (content[idx--] === '\\') {
+        backslashCount++;
+    }
+    // 返回结果
+    return backslashCount % 2 === 1;
+}
+/**
+ *****************************************
+ * 去除注释
+ *****************************************
+ */
+export function stripComments(content) {
+    // 校验内容
+    if (typeof content !== 'string') {
+        throw new TypeError(`Expected argument \`content\` to be a \`string\`, got \`${typeof content}\``);
+    }
+    // 定义变量
+    let isInsideString = false;
+    let isInsideComment = false;
+    let offset = 0;
+    let buffer = '';
+    let result = '';
+    let commaIndex = -1;
+    // 遍历字符
+    for (let index = 0; index < content.length; index++) {
+        const curr = content[index];
+        // 处理字符串
+        if (curr === '"' && !isInsideComment && !isEscaped(content, index - 1)) {
+            isInsideString = !isInsideString;
+        }
+        // 跳转字符串
+        if (isInsideString) {
+            continue;
+        }
+        // 退出单行注释
+        if (isInsideComment === singleComment) {
+            if (curr === '\n') {
+                isInsideComment = false;
+                offset = index;
+            }
+            continue;
+        }
+        // 获取下一字符
+        const next = content[index + 1];
+        // 退出多行注释
+        if (isInsideComment === multiComment) {
+            if (curr === '*' && next === '/') {
+                isInsideComment = false;
+                index += 1;
+                offset = index + 1;
+            }
+            continue;
+        }
+        // 处理注释起始位置
+        if (curr === '/') {
+            if (next === '/') {
+                buffer += content.slice(offset, index);
+                offset = index;
+                isInsideComment = singleComment;
+                index++;
+                continue;
+            }
+            if (next === '*') {
+                buffer += content.slice(offset, index);
+                offset = index;
+                isInsideComment = multiComment;
+                index++;
+                continue;
+            }
+        }
+        // 处理末尾逗号
+        if (commaIndex !== -1) {
+            if (curr === '}' || curr === ']') {
+                buffer += content.slice(offset, index);
+                result += buffer.slice(1);
+                buffer = '';
+                offset = index;
+                commaIndex = -1;
+            }
+            else if (curr !== ' ' && curr !== '\t' && curr !== '\r' && curr !== '\n') {
+                buffer += content.slice(offset, index);
+                offset = index;
+                commaIndex = -1;
+            }
+        }
+        else if (curr === ',') {
+            result += buffer + content.slice(offset, index);
+            buffer = '';
+            offset = index;
+            commaIndex = index;
+        }
+    }
+    // 返回结果
+    return result + buffer + (isInsideComment ? '' : content.slice(offset));
+}

package/esm/writeFile.mjs

@@ -0,0 +1,39 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2025-05-25 12:10:08
+ *****************************************
+ */
+'use strict';
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { stat } from './stat.mjs';
+import { rm } from './rm.mjs';
+import { mkdir } from './mkdir.mjs';
+/**
+ *****************************************
+ * 写入文件
+ *****************************************
+ */
+export function writeFile(dest, content, options) {
+    const stats = stat(dest);
+    if (stats) {
+        if (!options || !options.force) {
+            return false;
+        }
+        else {
+            rm(dest);
+        }
+    }
+    // 创建目录
+    if (!mkdir(dirname(dest), options)) {
+        return false;
+    }
+    // 写入文件
+    return (writeFileSync(dest, content), true);
+}

package/package.json

@@ -1,12 +1,31 @@
 {
   "name": "@ainc/fs",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "Let's do something nice with @ainc/esb!",
   "types": "dist/index.d.ts",
   "main": "dist/index.js",
   "files": [
+    "bin",
+    "esm",
     "dist"
   ],
+  "bin": {
+    "download": "./bin/download.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./esm/index.mjs",
+      "default": "./esm/index.mjs"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "require": "./dist/*.js",
+      "import": "./esm/*.mjs",
+      "default": "./esm/*.mjs"
+    }
+  },
   "repository": "git@absock.net:ainc/esb.git",
   "author": "edonet@163.com",
   "license": "MIT",
@@ -14,21 +33,21 @@
     "access": "public"
   },
   "dependencies": {
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   },
   "devDependencies": {
-    "@jest/globals": "^29.7.0",
-    "@swc/core": "^1.11.24",
-    "@swc/jest": "^0.2.38",
-    "@types/node": "^22.15.19",
-    "jest": "^29.7.0"
+    "@jest/globals": "30.2.0",
+    "@swc/core": "^1.15.8",
+    "@swc/jest": "^0.2.39",
+    "@types/node": "^25.0.3",
+    "jest": "^30.2.0"
   },
   "scripts": {
-    "start": "tsc",
-    "build": "pnpm clean && pnpm compile",
+    "build": "pnpm clean && pnpm compile && pnpm esm",
     "watch": "pnpm compile --watch",
+    "esm": "pnpm compile -m es2022 --outDir ./esm --declaration false && node ../../scripts/esm.js",
     "compile": "tsc -p ./tsconfig.build.json",
     "test": "jest",
-    "clean": "rimraf ./dist"
+    "clean": "rimraf ./dist ./esm"
   }
 }