@ainc/fs 0.1.22 → 0.1.24

package/dist/loadPackageDescription.js

@@ -0,0 +1,71 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2023-12-02 11:43:57
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadPackageDescription = loadPackageDescription;
+exports.readPackageDescription = readPackageDescription;
+exports.resolvePackageDescription = resolvePackageDescription;
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+const node_path_1 = require("node:path");
+const stat_1 = require("./stat");
+const lookup_1 = require("./lookup");
+const jsonc_1 = require("./jsonc");
+const readFile_1 = require("./readFile");
+/**
+ *****************************************
+ * 加载包描述
+ *****************************************
+ */
+function loadPackageDescription(from) {
+    const data = resolvePackageDescription(from);
+    // 返回配置
+    if (data) {
+        return data.config;
+    }
+}
+/**
+ *****************************************
+ * 读取包描述
+ *****************************************
+ */
+function readPackageDescription(dir) {
+    const data = resolvePackageDescription(dir);
+    // 返回配置
+    if (data && data.path.startsWith(dir)) {
+        return data.config;
+    }
+}
+/**
+ *****************************************
+ * 缓存
+ *****************************************
+ */
+const cache = new Map();
+const moduleDir = node_path_1.sep + 'node_modules';
+/**
+ *****************************************
+ * 解析包配置
+ *****************************************
+ */
+function resolvePackageDescription(from) {
+    return (0, lookup_1.lookup)('package.json', {
+        from,
+        cache,
+        resolve(path, dir) {
+            if ((0, stat_1.isFile)(path)) {
+                return { dir, path, config: (0, jsonc_1.json)((0, readFile_1.readFile)(path)) };
+            }
+            if (dir.endsWith(moduleDir)) {
+                return { dir, path };
+            }
+        },
+    });
+}

package/dist/loadTsConfig.d.ts

@@ -0,0 +1,87 @@
+/**
+ *****************************************
+ * 编译配置
+ *****************************************
+ */
+export interface CompilerOptions {
+    target?: string;
+    lib?: string[];
+    module?: string;
+    moduleResolution?: string;
+    declaration?: boolean;
+    declarationMap?: boolean;
+    strict?: boolean;
+    sourceMap?: boolean;
+    esModuleInterop?: boolean;
+    experimentalDecorators?: boolean;
+    noImplicitAny?: boolean;
+    allowJs?: boolean;
+    noEmit?: boolean;
+    jsx?: string;
+    isolatedModules?: boolean;
+    resolveJsonModule?: boolean;
+    forceConsistentCasingInFileNames?: boolean;
+    skipLibCheck?: boolean;
+    skipDefaultLibCheck?: boolean;
+    rootDirs?: string[];
+    rootDir?: string;
+    outDir?: string;
+    baseUrl?: string;
+    paths?: Record<string, string[]>;
+    [key: string]: unknown;
+}
+/**
+ *****************************************
+ * 监听配置
+ *****************************************
+ */
+export interface WatchOptions {
+    watchFile?: string;
+    watchDirectory?: string;
+    excludeDirectories?: string[];
+    excludeFiles?: string[];
+    fallbackPolling?: string;
+    synchronousWatchDirectory?: boolean;
+    [key: string]: unknown;
+}
+/**
+ *****************************************
+ * TsConfig
+ *****************************************
+ */
+export interface TsConfig {
+    extends?: string | string[];
+    include?: string[];
+    exclude?: string[];
+    files?: string[];
+    compileOnSave?: boolean;
+    compilerOptions?: CompilerOptions;
+    watchOptions?: WatchOptions;
+}
+/**
+ *****************************************
+ * TsConfig
+ *****************************************
+ */
+export interface TsConfigDescription {
+    path: string;
+    config: TsConfig;
+}
+/**
+ *****************************************
+ * 加载 TS 配置
+ *****************************************
+ */
+export declare function loadTsConfig(from?: string): TsConfig | undefined;
+/**
+ *****************************************
+ * 加载编译配置
+ *****************************************
+ */
+export declare function loadCompilerOptions(from?: string): CompilerOptions | undefined;
+/**
+ *****************************************
+ * 解析 TS 配置
+ *****************************************
+ */
+export declare function resolveTsConfig(from?: string): TsConfigDescription | undefined;

package/dist/loadTsConfig.js

@@ -0,0 +1,219 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2023-12-30 13:48:09
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadTsConfig = loadTsConfig;
+exports.loadCompilerOptions = loadCompilerOptions;
+exports.resolveTsConfig = resolveTsConfig;
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const relative_1 = require("./relative");
+const resolveFile_1 = require("./resolveFile");
+const stat_1 = require("./stat");
+const lookup_1 = require("./lookup");
+const jsonc_1 = require("./jsonc");
+const match_1 = require("./match");
+const resolveModuleDir_1 = require("./resolveModuleDir");
+/**
+ *****************************************
+ * 加载 TS 配置
+ *****************************************
+ */
+function loadTsConfig(from) {
+    const data = resolveTsConfig(from);
+    // 返回配置
+    if (data) {
+        return data.config;
+    }
+}
+/**
+ *****************************************
+ * 加载编译配置
+ *****************************************
+ */
+function loadCompilerOptions(from) {
+    const data = resolveTsConfig(from);
+    // 返回配置
+    if (data && data.config) {
+        return data.config.compilerOptions;
+    }
+}
+/**
+ *****************************************
+ * 缓存内容
+ *****************************************
+ */
+const cache = new Map();
+/**
+ *****************************************
+ * 解析 TS 配置
+ *****************************************
+ */
+function resolveTsConfig(from) {
+    return (0, lookup_1.lookup)('tsconfig.json', {
+        from,
+        cache,
+        resolve(path) {
+            return (0, stat_1.isFile)(path) ? loadTsConfigFile(path) : undefined;
+        },
+    });
+}
+/**
+ *****************************************
+ * 解析 TS 配置文件
+ *****************************************
+ */
+function loadTsConfigFile(path) {
+    const config = parseTsConfig(path, new Set([path]), ['.json', node_path_1.sep + 'tsconfig.json']);
+    const dir = (0, node_path_1.dirname)(path);
+    // 移除继承属性
+    config.extends = undefined;
+    // 格式化 include 配置
+    if (config.include) {
+        config.include = config.include.map(path => (0, relative_1.relative)(dir, path));
+    }
+    // 格式化 exclude 配置
+    if (config.exclude) {
+        config.exclude = config.exclude.map(path => (0, relative_1.relative)(dir, path));
+    }
+    // 格式化 files 配置
+    if (config.files) {
+        config.files = config.files.map(path => (0, relative_1.relative)(dir, path));
+    }
+    // 返回结果
+    return { path, config };
+}
+/**
+ *****************************************
+ * 解析配置
+ *****************************************
+ */
+function parseTsConfig(path, tracker, extensions) {
+    const data = (0, jsonc_1.jsonc)((0, node_fs_1.readFileSync)(path, 'utf8'));
+    const dir = (0, node_path_1.dirname)(path);
+    const config = normalizeTsConfig(data, dir);
+    // 不存在继承，直接返回
+    if (!config.extends) {
+        return config;
+    }
+    // 获取继承列表
+    const extendsList = Array.isArray(config.extends) ? config.extends : [config.extends];
+    const configs = extendsList.map(path => parseExtendsTsConfig(path, dir, tracker, extensions));
+    // 追加当前配置
+    configs.push(config);
+    // 合并配置
+    return configs.reduce(mergeTsConfig);
+}
+/**
+ *****************************************
+ * 合并配置
+ *****************************************
+ */
+function mergeTsConfig(target, source) {
+    const { baseUrl, paths } = source.compilerOptions || {};
+    const config = { ...target, ...source };
+    // 合并配置项
+    config.compilerOptions = { ...target.compilerOptions, ...source.compilerOptions };
+    config.watchOptions = { ...target.watchOptions, ...source.watchOptions };
+    // 更新 paths 配置
+    if (baseUrl || paths) {
+        config.compilerOptions.baseUrl = baseUrl;
+        config.compilerOptions.paths = paths;
+    }
+    // 返回配置
+    return config;
+}
+/**
+ *****************************************
+ * 解析继承配置
+ *****************************************
+ */
+function parseExtendsTsConfig(path, from, tracker, extensions) {
+    const extendsFile = resolveExtendsFile(path, from, extensions);
+    // 未找到文件
+    if (!extendsFile) {
+        throw new Error(`file '${path}' not found.`);
+    }
+    // 循环引用
+    if (tracker.has(extendsFile)) {
+        throw new Error(`circularity detected while resolving configuration: ${extendsFile}`);
+    }
+    // 添加引用文件
+    tracker.add(extendsFile);
+    // 解析文件
+    return parseTsConfig(extendsFile, tracker, extensions);
+}
+/**
+ *****************************************
+ * 解析继承文件地址
+ *****************************************
+ */
+function resolveExtendsFile(path, from, extensions) {
+    // 解析相对路径
+    if ((0, relative_1.isRelative)(path)) {
+        return (0, resolveFile_1.resolveFile)((0, node_path_1.resolve)(from, path), extensions);
+    }
+    // 解析绝对路径
+    if ((0, node_path_1.isAbsolute)(path)) {
+        return (0, resolveFile_1.resolveFile)(path, extensions);
+    }
+    // 解析模块目录
+    const moduleDirs = (0, resolveModuleDir_1.resolveModuleDirs)(from);
+    // 模块目录
+    return (0, match_1.match)(moduleDirs, dir => (0, resolveFile_1.resolveFile)((0, node_path_1.resolve)(dir, path), extensions));
+}
+/**
+ *****************************************
+ * 格式化配置
+ *****************************************
+ */
+function normalizeTsConfig(config, dir) {
+    const compilerOptions = config.compilerOptions;
+    const watchOptions = config.watchOptions;
+    // 格式化 include 配置
+    if (config.include) {
+        config.include = config.include.map(path => (0, node_path_1.resolve)(dir, path));
+    }
+    // 格式化 exclude 配置
+    if (config.exclude) {
+        config.exclude = config.exclude.map(path => (0, node_path_1.resolve)(dir, path));
+    }
+    // 格式化 files 配置
+    if (config.files) {
+        config.files = config.files.map(path => (0, node_path_1.resolve)(dir, path));
+    }
+    // 格式化 compilerOptions 配置
+    if (compilerOptions) {
+        // 格式化 baseUrl 配置
+        if (compilerOptions.baseUrl) {
+            compilerOptions.baseUrl = (0, node_path_1.resolve)(dir, compilerOptions.baseUrl);
+        }
+        // 格式化 outDir 配置
+        if (compilerOptions.outDir) {
+            compilerOptions.outDir = (0, node_path_1.resolve)(dir, compilerOptions.outDir);
+        }
+        // 格式化 rootDir 配置
+        if (compilerOptions.rootDir) {
+            compilerOptions.rootDir = (0, node_path_1.resolve)(dir, compilerOptions.rootDir);
+        }
+        // 格式化 rootDirs 配置
+        if (compilerOptions.rootDirs) {
+            compilerOptions.rootDirs = compilerOptions.rootDirs.map(path => (0, node_path_1.resolve)(dir, path));
+        }
+    }
+    // 格式化监听路径
+    if (watchOptions && watchOptions.excludeDirectories) {
+        watchOptions.excludeDirectories = watchOptions.excludeDirectories.map(path => (0, node_path_1.resolve)(dir, path));
+    }
+    // 返回配置
+    return config;
+}

package/dist/match.d.ts

@@ -0,0 +1,30 @@
+/**
+ *****************************************
+ * 空函数
+ *****************************************
+ */
+export declare function noop(): void;
+/**
+ *****************************************
+ * nil 函数
+ *****************************************
+ */
+export declare function nil(): null;
+/**
+ *****************************************
+ * false
+ *****************************************
+ */
+export declare function falsy(): boolean;
+/**
+ *****************************************
+ * 一元函数
+ *****************************************
+ */
+export declare function unary<T>(value: T): T;
+/**
+ *****************************************
+ * 执行匹配
+ *****************************************
+ */
+export declare function match<T, P>(list: T[], handler: (value: T) => P): P | undefined;

package/dist/match.js

@@ -0,0 +1,59 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-18 15:12:42
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noop = noop;
+exports.nil = nil;
+exports.falsy = falsy;
+exports.unary = unary;
+exports.match = match;
+/**
+ *****************************************
+ * 空函数
+ *****************************************
+ */
+function noop() {
+    // do nothing
+}
+/**
+ *****************************************
+ * nil 函数
+ *****************************************
+ */
+function nil() {
+    return null;
+}
+/**
+ *****************************************
+ * false
+ *****************************************
+ */
+function falsy() {
+    return false;
+}
+/**
+ *****************************************
+ * 一元函数
+ *****************************************
+ */
+function unary(value) {
+    return value;
+}
+/**
+ *****************************************
+ * 执行匹配
+ *****************************************
+ */
+function match(list, handler) {
+    for (let i = 0; i < list.length; i++) {
+        const result = handler(list[i]);
+        // 查找到结果
+        if (result !== undefined) {
+            return result;
+        }
+    }
+}

package/dist/promises.d.ts

@@ -0,0 +1,69 @@
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { Readable, Writable, PipeOptions } from 'node:stream';
+import { Mode, RmOptions, StatOptions as IStatOptions } from 'node:fs';
+/**
+ *****************************************
+ * 状态选项
+ *****************************************
+ */
+export interface StatOptions extends IStatOptions {
+    bigint?: false | undefined;
+}
+/**
+ *****************************************
+ * 获取文件状态
+ *****************************************
+ */
+export declare function stat(path: string, options?: StatOptions): Promise<import("node:fs").Stats | null>;
+/**
+ *****************************************
+ * 删除文件
+ *****************************************
+ */
+export declare function rm(path: string, options?: RmOptions): Promise<void>;
+/**
+ *****************************************
+ * 选项
+ *****************************************
+ */
+export interface MkdirOptions {
+    force?: boolean;
+    mode?: Mode | undefined;
+    recursive?: boolean;
+}
+/**
+ *****************************************
+ * 创建文件目录
+ *****************************************
+ */
+export declare function mkdir(path: string, options?: MkdirOptions): Promise<boolean>;
+/**
+ *****************************************
+ * pipe
+ *****************************************
+ */
+export declare function pipe(src: Readable, dest: Writable, options?: PipeOptions): Promise<unknown>;
+/**
+ *****************************************
+ * 读取文件
+ *****************************************
+ */
+export declare function readFile(path: string): Promise<string | undefined>;
+/**
+ *****************************************
+ * 选项
+ *****************************************
+ */
+export interface WriteFileOptions {
+    force?: boolean;
+}
+/**
+ *****************************************
+ * 写入文件
+ *****************************************
+ */
+export declare function writeFile(path: string, content: string, options?: WriteFileOptions): Promise<boolean>;

package/dist/promises.js

@@ -0,0 +1,103 @@
+/**
+ *****************************************
+ * Created by edonet@163.com
+ * Created on 2026-03-21 12:37:59
+ *****************************************
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stat = stat;
+exports.rm = rm;
+exports.mkdir = mkdir;
+exports.pipe = pipe;
+exports.readFile = readFile;
+exports.writeFile = writeFile;
+const node_path_1 = require("node:path");
+const fs = require("node:fs/promises");
+/**
+ *****************************************
+ * 获取文件状态
+ *****************************************
+ */
+async function stat(path, options) {
+    return fs.stat(path, options).catch(err => err.code === 'ENOENT' ? null : Promise.reject(err));
+}
+/**
+ *****************************************
+ * 删除文件
+ *****************************************
+ */
+async function rm(path, options) {
+    if (await stat(path)) {
+        await fs.rm(path, { force: true, recursive: true, ...options });
+    }
+}
+/**
+ *****************************************
+ * 创建文件目录
+ *****************************************
+ */
+async function mkdir(path, options) {
+    const stats = await stat(path);
+    const opts = { recursive: true, ...options };
+    // 创建目录
+    if (!stats) {
+        await fs.mkdir(path, opts);
+        return true;
+    }
+    else if (stats.isDirectory()) {
+        return true;
+    }
+    else if (!opts.force) {
+        return false;
+    }
+    else {
+        await fs.unlink(path);
+        await fs.mkdir(path, opts);
+        return true;
+    }
+}
+/**
+ *****************************************
+ * pipe
+ *****************************************
+ */
+async function pipe(src, dest, options) {
+    return new Promise((resolve, reject) => {
+        src.once('close', resolve);
+        src.once('error', reject);
+        src.pipe(dest, options);
+    });
+}
+/**
+ *****************************************
+ * 读取文件
+ *****************************************
+ */
+async function readFile(path) {
+    const stats = await stat(path);
+    if (stats && !stats.isDirectory()) {
+        return fs.readFile(path, 'utf8');
+    }
+}
+/**
+ *****************************************
+ * 写入文件
+ *****************************************
+ */
+async function writeFile(path, content, options) {
+    const stats = await stat(path);
+    if (stats) {
+        if (!options || !options.force) {
+            return false;
+        }
+        else {
+            await rm(path);
+        }
+    }
+    // 写入文件内容
+    await fs.mkdir((0, node_path_1.dirname)(path), { recursive: true });
+    await fs.writeFile(path, content);
+    // 返回结果
+    return true;
+}

package/dist/resolveAlias.d.ts

@@ -0,0 +1,25 @@
+/**
+ *****************************************
+ * 加载依赖
+ *****************************************
+ */
+import { Dict } from './dict';
+/**
+ *****************************************
+ * 处理函数
+ *****************************************
+ */
+export type Handler = (path: string) => string | null | undefined;
+export type Match = (id: string, handler: Handler) => string | null | undefined;
+/**
+ *****************************************
+ * 解析别名
+ *****************************************
+ */
+export declare function resolveAlias(alias: Record<string, string>): Dict<Match>;
+/**
+ *****************************************
+ * 解析字典
+ *****************************************
+ */
+export declare function resolveDict<T, P>(data: Record<string, T>, handler: (key: string, value: T) => P): Dict<P>;