@guanghechen/commander 4.6.0 → 4.7.0

package/lib/esm/{index.mjs → node.mjs}

@@ -1,9 +1,96 @@
+import { stat, readFile } from 'node:fs/promises';
+import path from 'node:path';
 import { parse } from '@guanghechen/env';
 import { Reporter } from '@guanghechen/reporter';
-import { stat, readFile } from 'node:fs/promises';
-import * as path from 'node:path';
-import path__default from 'node:path';
-import * as fs from 'node:fs';
+import fs from 'node:fs';
+
+const WINDOWS_DRIVE_ABSOLUTE_REGEX = /^[a-zA-Z]:[\\/]/;
+function isAbsolutePath(filepath) {
+    return (filepath.startsWith('/') ||
+        filepath.startsWith('\\\\') ||
+        WINDOWS_DRIVE_ABSOLUTE_REGEX.test(filepath));
+}
+function resolvePathFrom(base, fragment) {
+    const useWindowsStyle = WINDOWS_DRIVE_ABSOLUTE_REGEX.test(base);
+    const normalizedBase = base.replace(/\\/g, '/');
+    const normalizedFragment = fragment.replace(/\\/g, '/');
+    const source = isAbsolutePath(normalizedFragment)
+        ? normalizedFragment
+        : `${normalizedBase.replace(/\/$/, '')}/${normalizedFragment}`;
+    const prefix = useWindowsStyle ? source.slice(0, 2) : '';
+    const body = useWindowsStyle ? source.slice(2) : source;
+    const stack = [];
+    for (const token of body.split('/')) {
+        if (token === '' || token === '.') {
+            continue;
+        }
+        if (token === '..') {
+            if (stack.length > 0) {
+                stack.pop();
+            }
+            continue;
+        }
+        stack.push(token);
+    }
+    if (useWindowsStyle) {
+        const resolved = `${prefix}/${stack.join('/')}`;
+        return resolved.endsWith('/') ? resolved.slice(0, -1) : resolved;
+    }
+    return `/${stack.join('/')}`;
+}
+function createUnsupportedFsError(operation) {
+    return new Error(`runtime does not support file-system operation: ${operation}`);
+}
+function getFallbackCwd() {
+    const proc = globalThis.process;
+    if (proc && typeof proc.cwd === 'function') {
+        return proc.cwd();
+    }
+    return '/';
+}
+function createBrowserCommandRuntime() {
+    return {
+        cwd: () => getFallbackCwd(),
+        isAbsolute: filepath => isAbsolutePath(filepath),
+        resolve: (...paths) => {
+            if (paths.length === 0) {
+                return getFallbackCwd();
+            }
+            let resolved = getFallbackCwd();
+            for (const path of paths) {
+                if (path.length === 0) {
+                    continue;
+                }
+                resolved = resolvePathFrom(resolved, path);
+            }
+            return resolved;
+        },
+        readFile: async () => {
+            throw createUnsupportedFsError('readFile');
+        },
+        stat: async () => {
+            throw createUnsupportedFsError('stat');
+        },
+    };
+}
+
+let defaultRuntime = createBrowserCommandRuntime();
+function getDefaultCommandRuntime() {
+    return defaultRuntime;
+}
+function setDefaultCommandRuntime(runtime) {
+    defaultRuntime = runtime;
+}
+
+function createNodeCommandRuntime() {
+    return {
+        cwd: () => process.cwd(),
+        isAbsolute: filepath => path.isAbsolute(filepath),
+        resolve: (...paths) => path.resolve(...paths),
+        readFile: filepath => readFile(filepath, 'utf8'),
+        stat: filepath => stat(filepath),
+    };
+}
 
 const TERMINAL_STYLE = {
     bold: '\x1b[1m',
@@ -270,6 +357,7 @@ class Command {
     #builtin;
     #presetConfig;
     #reporter;
+    #runtime;
     #parent;
     #options = [];
     #arguments = [];
@@ -285,6 +373,7 @@ class Command {
         this.#builtin = normalizeBuiltinConfig(config.builtin);
         this.#presetConfig = config.preset;
         this.#reporter = config.reporter;
+        this.#runtime = config.runtime ?? getDefaultCommandRuntime();
     }
     get name() {
         return this.#name || undefined;
@@ -803,12 +892,12 @@ class Command {
         return await this.#assertPresetRoot(commandPreset.root, 'command.preset.root', commandPath);
     }
     async #assertPresetRoot(root, sourceName, commandPath) {
-        if (!path__default.isAbsolute(root)) {
+        if (!this.#runtime.isAbsolute(root)) {
             throw new CommanderError('ConfigurationError', `invalid preset root from "${sourceName}": "${root}" is not an absolute directory`, commandPath);
         }
         let stats;
         try {
-            stats = await stat(root);
+            stats = await this.#runtime.stat(root);
         }
         catch (error) {
             throw new CommanderError('ConfigurationError', `invalid preset root from "${sourceName}": "${root}" cannot be accessed (${error.message})`, commandPath);
@@ -848,7 +937,7 @@ class Command {
                 },
             ];
         }
-        const absolutePath = path__default.resolve(presetRoot, defaultFilename);
+        const absolutePath = this.#runtime.resolve(presetRoot, defaultFilename);
         return [
             {
                 displayPath: absolutePath,
@@ -858,13 +947,13 @@ class Command {
         ];
     }
     #resolvePresetFileAbsolutePath(filepath, presetRoot) {
-        if (path__default.isAbsolute(filepath)) {
+        if (this.#runtime.isAbsolute(filepath)) {
             return filepath;
         }
         if (presetRoot !== undefined) {
-            return path__default.resolve(presetRoot, filepath);
+            return this.#runtime.resolve(presetRoot, filepath);
         }
-        return path__default.resolve(process.cwd(), filepath);
+        return this.#runtime.resolve(this.#runtime.cwd(), filepath);
     }
     #assertPresetOptionFragments(tokens, filepath, chain, optionPolicyMap) {
         if (tokens.length === 0) {
@@ -977,14 +1066,14 @@ class Command {
     }
     async #readPresetFile(file, commandPath) {
         try {
-            return await readFile(file.absolutePath, 'utf8');
+            return await this.#runtime.readFile(file.absolutePath);
         }
         catch (error) {
             const ioError = error;
             if (!file.explicit && ioError.code === 'ENOENT') {
                 return undefined;
             }
-            throw new CommanderError('ConfigurationError', `failed to read preset file "${file.displayPath}": ${ioError.message}`, commandPath);
+            throw new CommanderError('ConfigurationError', `failed to read preset file "${file.displayPath}": ${error.message}`, commandPath);
         }
     }
     #tokenizePresetOptions(content) {
@@ -2051,4 +2140,6 @@ class PwshCompletion {
     }
 }
 
-export { BashCompletion, Coerce, Command, CommanderError, CompletionCommand, FishCompletion, PwshCompletion, isDomain, isIp, isIpv4, isIpv6, logColorfulOption, logDateOption, logLevelOption, silentOption };
+setDefaultCommandRuntime(createNodeCommandRuntime());
+
+export { BashCompletion, Coerce, Command, CommanderError, CompletionCommand, FishCompletion, PwshCompletion, createBrowserCommandRuntime, createNodeCommandRuntime, getDefaultCommandRuntime, isDomain, isIp, isIpv4, isIpv6, logColorfulOption, logDateOption, logLevelOption, setDefaultCommandRuntime, silentOption };