@ainc/fs 0.1.10 → 0.1.14

package/src/helpers/compose.ts

@@ -0,0 +1,49 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2021-12-16 22:20:04
+ *****************************************
+ */
+'use strict';
+
+
+/**
+ *****************************************
+ * 解析规则
+ *****************************************
+ */
+type Handler = (...args: any[]) => void | unknown;
+
+
+/**
+ *****************************************
+ * 组合函数
+ *****************************************
+ */
+export function compose<T extends Handler>(rules: T[]): T {
+
+    // 无处理函数
+    if (rules.length === 0) {
+        return (() => undefined) as T;
+    }
+
+    // 单一处理函数
+    if (rules.length === 1) {
+        return rules[0];
+    }
+
+    // 复合处理函数
+    function composed(...args: any[]): void | unknown {
+        for (let idx = 0, len = rules.length; idx < len; idx++) {
+            const result = rules[idx](...args);
+
+            // 解析成功
+            if (result) {
+                return result;
+            }
+        }
+    }
+
+    // 返回结果
+    return composed as T;
+}

package/src/helpers/each.ts

@@ -0,0 +1,19 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2021-12-18 16:52:32
+ *****************************************
+ */
+'use strict';
+
+
+/**
+ *****************************************
+ * 遍历对象
+ *****************************************
+ */
+export function each<T>(target: T, handler: (value: T[keyof T], key: string) => void): void {
+    if (target && typeof target === 'object') {
+        Object.keys(target).forEach(key => handler(target[key as keyof T], key));
+    }
+}

package/src/helpers/match.ts

@@ -0,0 +1,31 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2021-12-16 00:10:41
+ *****************************************
+ */
+'use strict';
+
+
+/**
+ *****************************************
+ * 匹配列表
+ *****************************************
+ */
+export function match<T, P>(list: T[], handler: (data: T, index: number) => void | P): void | P {
+
+    // 处理只有一个元素的情况
+    if (list.length === 1) {
+        return handler(list[0], 0);
+    }
+
+    // 处理列表
+    for (let idx = 0, len = list.length; idx < len; idx ++) {
+        const result = handler(list[idx], idx);
+
+        // 返回结果
+        if (typeof result !== 'undefined') {
+            return result;
+        }
+    }
+}

package/src/helpers/normalizePath.ts

@@ -0,0 +1,51 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2021-12-18 11:16:21
+ *****************************************
+ */
+'use strict';
+
+
+/**
+ *****************************************
+ * 路径信息
+ *****************************************
+ */
+export interface PathInformation {
+    path: string;
+    query: string;
+    hash: string;
+}
+
+
+/**
+ *****************************************
+ * 切分字符
+ *****************************************
+ */
+export function split(str: string, sep: string): [string, string] {
+    const idx = str.indexOf(sep);
+
+    // 未找到分割字符串
+    if (idx === -1) {
+        return [str, ''];
+    }
+
+    // 分割字符串
+    return [str.substring(0, idx), str.substring(idx)];
+}
+
+
+/**
+ *****************************************
+ * 格式化路径
+ *****************************************
+ */
+export function normalizePath(id: string): PathInformation {
+    const [str, hash] = split(id, '#');
+    const [path, query] = split(str, '?');
+
+    // 返回结果
+    return { path, query, hash };
+}

package/src/helpers/safeCall.ts

@@ -0,0 +1,21 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2021-12-16 00:02:15
+ *****************************************
+ */
+'use strict';
+
+
+/**
+ *****************************************
+ * 安全执行
+ *****************************************
+ */
+export function safeCall<T>(handler: () => T): void | T {
+    try {
+        return handler();
+    } catch (err) {
+        return;
+    }
+}

package/src/helpers/split.ts

@@ -0,0 +1,25 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2021-12-21 21:17:28
+ *****************************************
+ */
+'use strict';
+
+
+/**
+ *****************************************
+ * 分割字符串
+ *****************************************
+ */
+export function split(str: string, sep: string): [string, string?] {
+    const idx = str.indexOf(sep);
+
+    // 不包含匹配符
+    if (idx < 0) {
+        return [str];
+    }
+
+    // 分割配置字符
+    return [str.substring(0, idx), str.substring(idx + 1)];
+}

package/src/{stripBOM.ts → helpers/stripBOM.ts}

@@ -1,7 +1,7 @@
 /**
  *****************************************
  * Created by edonet@163.com
- * Created on 2021-05-31 22:41:48
+ * Created on 2022-01-01 20:53:11
  *****************************************
  */
 'use strict';
@@ -9,16 +9,9 @@
 
 /**
  *****************************************
- * 移除BOM头
+ * 移除【BOM】标识
  *****************************************
  */
 export function stripBOM(content: string): string {
-
-    // 检测第一个字符是否为BOM
-    if (content.charCodeAt(0) === 0xFEFF) {
-        return content.slice(1);
-    }
-
-    // 返回源内容
-    return content;
+    return content.charCodeAt(0) === 0xFEFF ? content.slice(1) : content;
 }

package/src/helpers/stripComments.ts

@@ -0,0 +1,167 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2021-05-31 22:41:48
+ *****************************************
+ */
+'use strict';
+
+
+/**
+ *****************************************
+ * 判断是否为转义字符
+ *****************************************
+ */
+function isEscaped(index: number, source: string): number {
+    let count = 1;
+
+    // 统计转义字符
+    while (source[index - count] === '\\') {
+        count ++;
+    }
+
+    // 判断是否转义
+    return count % 2;
+}
+
+
+/**
+ *****************************************
+ * 判断是否为结尾的逗号
+ *****************************************
+ */
+function isTrailingComma(start: number, source: string): boolean {
+    let ch = source[start];
+
+    // 过滤空白字符
+    while (' \n\r'.indexOf(ch) > -1) {
+        ch = source[++ start];
+    }
+
+    // 返回是否为结束符
+    return '}]'.indexOf(ch) > -1;
+}
+
+
+/**
+ *****************************************
+ * 查找字符串结束
+ *****************************************
+ */
+function indexStringEnd(start: number, ch: string, source: string): number {
+    const idx = source.indexOf(ch, start);
+
+    // 判断是否查找结束
+    if (idx === -1) {
+        return source.length;
+    } else {
+        return isEscaped(idx, source) ? idx + 1 : indexStringEnd(idx + 1, ch, source);
+    }
+}
+
+
+/**
+ *****************************************
+ * 查找行注释结束
+ *****************************************
+ */
+function indexLineCommentEnd(start: number, source: string): number {
+    const idx = source.indexOf('\n', start);
+
+    // 判断是否查找结束
+    if (idx === -1) {
+        return source.length;
+    } else {
+        return source[idx - 1] === '\r' ? idx - 1 : idx;
+    }
+}
+
+
+/**
+ *****************************************
+ * 查找块注释结束
+ *****************************************
+ */
+function indexBlockCommentEnd(start: number, source: string): number {
+    const idx = source.indexOf('/', start);
+
+    if (idx === -1) {
+        return source.length;
+    } else if (source[idx - 1] === '*') {
+        return idx + 1;
+    } else {
+        return indexBlockCommentEnd(idx + 1, source);
+    }
+}
+
+
+/**
+ *****************************************
+ * 过滤注释
+ *****************************************
+ */
+export function stripComments(content: string): string {
+    let result = '';
+    let idx = 0;
+    let len = content.length;
+    let start = 0;
+
+    // 检测第一个字符是否为BOM
+    if (content.charCodeAt(0) === 0xFEFF) {
+        idx = start = 1;
+    }
+
+    // 遍历字符
+    while (idx < len) {
+        const ch = content[idx];
+
+        // 跳过字符串
+        if (ch === '"' || ch === '\'') {
+            idx = indexStringEnd(idx + 1, ch, content);
+            continue;
+        }
+
+        // 自增偏移
+        idx ++;
+
+        // 判断是为结尾的逗号
+        if (ch === ',' && isTrailingComma(idx, content)) {
+            result += content.slice(start, idx - 1);
+            start = idx;
+            idx = start + 1;
+            continue;
+        }
+
+        // 非注释
+        if (ch !== '/') {
+            continue;
+        }
+
+        // 获取下一字符
+        const next = content[idx];
+
+        // 处理行注释
+        if (next === '/') {
+            result += content.slice(start, idx - 1);
+            start = indexLineCommentEnd(idx + 1, content);
+            idx = start + 1;
+            continue;
+        }
+
+        // 处理多行注释
+        if (next === '*') {
+            result += content.slice(start, idx - 1);
+            start = indexBlockCommentEnd(idx + 2, content);
+            idx = start;
+            continue;
+        }
+    }
+
+    // 添加结束片段
+    if (start < len) {
+        result += content.slice(start);
+    }
+
+    // 返回结果
+    return result;
+}

package/src/index.ts

@@ -14,6 +14,7 @@
  */
 export { homedir } from './homedir';
 export { cwd } from './cwd';
+export { realpath } from './realpath';
 export { dirname } from './dirname';
 export { filename } from './filename';
 export { basename } from './basename';
@@ -24,6 +25,7 @@ export { isDirectory } from './isDirectory';
 export { indir } from './indir';
 export { json } from './json';
 export { jsonc } from './jsonc';
+export { parseJSON } from './parseJSON';
 export { copy } from './copy';
 export { cpdir } from './cpdir';
 export { find } from './find';
@@ -44,7 +46,7 @@ export { mapdir } from './mapdir';
 export { symlink } from './symlink';
 export { usedir } from './usedir';
 export { supdir } from './supdir';
-export { resolveAlias } from './resolveAlias';
+export { resolvePath } from './resolvePath';
 export { includePaths } from './includePaths';
 export { isAbsolutePath } from './isAbsolutePath';
 export { isRelativePath } from './isRelativePath';

package/src/isRelativePath.ts

@@ -7,11 +7,46 @@
 'use strict';
 
 
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { sep } from 'path';
+
+
+/**
+ *****************************************
+ * 判断是否为路径分隔符
+ *****************************************
+ */
+function isSep(ch: string): boolean {
+
+    // 模块相对标识
+    if (ch === '/' || ch === '') {
+        return true;
+    }
+
+    // 路径相对标识
+    return ch === sep;
+}
+
+
 /**
  *****************************************
  * 判断是否为相对路径
  *****************************************
  */
 export function isRelativePath(source: string): boolean {
-    return source.startsWith('./') || source.startsWith('../');
+
+    // 非相对标识
+    if (source.charAt(0) !== '.') {
+        return false;
+    }
+
+    // 位1字符
+    const ch1 = source.charAt(1);
+
+    // 非相对路径
+    return ch1 === '.' ? isSep(source.charAt(2)) : isSep(ch1);
 }

package/src/json.ts

@@ -15,6 +15,7 @@
 import { stat } from './stat';
 import { readFile } from './readFile';
 import { writeFile } from './writeFile';
+import { stripBOM } from './helpers/stripBOM';
 
 
 /**
@@ -44,7 +45,7 @@ function json<T = Data>(...args: [string] | [string, T]): T | null {
         const stats = stat(name);
 
         if (stats && stats.isFile()) {
-            return JSON.parse(readFile(stats.path));
+            return JSON.parse(stripBOM(readFile(stats.path)));
         }
     }
 

package/src/jsonc.ts

@@ -15,8 +15,7 @@
 import { stat } from './stat';
 import { readFile } from './readFile';
 import { writeFile } from './writeFile';
-import { stripBOM } from './stripBOM';
-import { stripComments } from './stripComments';
+import { stripComments } from './helpers/stripComments';
 
 
 /**
@@ -46,7 +45,7 @@ function jsonc<T = Data>(...args: [string] | [string, T]): T | null {
         const stats = stat(name);
 
         if (stats && stats.isFile()) {
-            const content = stripComments(stripBOM(readFile(stats.path)));
+            const content = stripComments(readFile(stats.path));
 
             // 空白文件
             if (!content.trim()) {

package/src/parseJSON.ts

@@ -0,0 +1,40 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2022-01-01 21:01:19
+ *****************************************
+ */
+'use strict';
+
+
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { stripBOM } from './helpers/stripBOM';
+import { stripComments } from './helpers/stripComments';
+
+
+/**
+ *****************************************
+ * 选项
+ *****************************************
+ */
+interface Options {
+    comments?: boolean;
+}
+
+
+/**
+ *****************************************
+ * 解析【JSON】文件
+ *****************************************
+ */
+export function parseJSON<T>(content: string, options: Options = {}): T {
+    const normalized = options.comments ? stripComments(content) : stripBOM(content);
+    const source = normalized.trim();
+
+    // 解析内容
+    return source ? JSON.parse(source) : undefined;
+}

package/src/realpath.ts

@@ -0,0 +1,35 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2021-07-17 17:42:34
+ *****************************************
+ */
+'use strict';
+
+
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { realpathSync } from 'fs';
+import { resolve } from 'path';
+import { isAbsolutePath } from './isAbsolutePath';
+
+
+/**
+ *****************************************
+ * 获取基准路径
+ *****************************************
+ */
+export const baseDir = realpathSync(process.cwd());
+
+
+/**
+ *****************************************
+ * 解析真实地址
+ *****************************************
+ */
+export function realpath(path: string): string {
+    return isAbsolutePath(path) ? realpathSync(path) : resolve(baseDir, path);
+}

package/src/relative.ts

@@ -25,7 +25,7 @@ export function relative(from: string, to: string): string {
 
     // 替换分隔符
     if (path.sep === '\\') {
-        result = result.replace(/\\/g, '/');
+        result = result.split('\\').join('/');
     }
 
     // 补全相对路径

package/src/resolve.ts

@@ -24,6 +24,7 @@ import { findFile } from './findFile';
  */
 export interface Options {
     ext?: string;
+    test?: RegExp;
     exclude?: string[];
 }
 
@@ -47,7 +48,7 @@ export interface Asset {
  */
 export function resolve(dir: string | string[], options: Options = {}): Asset[] {
     const input = Array.isArray(dir) ? dir : [dir];
-    const name = options.ext ? options.ext + '$' : '*';
+    const name = options.ext ? options.ext + '$' : options.test || '*';
     const ignore = options.exclude ? ['node_modules', ...options.exclude] : ['node_modules'];
     const assets: Asset[] = [];