@bemoje/cli 0.0.4 → 0.0.6

package/dist/esm/opt/OptionBuilder.js

@@ -0,0 +1,84 @@
+import { Option } from '@commander-js/extra-typings';
+import { OptionArgumentParserSelector } from './OptionArgumentParserSelector';
+import { OptionArgumentValidatorSelector } from './OptionArgumentValidatorSelector';
+import { OptionHelpers } from './OptionHelpers';
+import { OptionReader } from './OptionReader';
+import { realizeLazyProperty } from '../util/object/realizeLazyProperty';
+/**
+ * Wrapper around the @see Option class, for more intuitive construction.
+ * @remarks Options are one of boolean, negated, required argument, or optional argument.
+ */
+export class OptionBuilder {
+    cmd;
+    $;
+    constructor(cmd, flags) {
+        this.cmd = cmd;
+        this.$ = new Option(flags);
+        if (!OptionHelpers.hasArgument(this.$) && this.$.long?.startsWith('--no-')) {
+            this.$.default(true);
+        }
+    }
+    description(string) {
+        this.$.description = string;
+        return this;
+    }
+    mandatory(mandatory = true) {
+        this.$.makeOptionMandatory(mandatory);
+        return this;
+    }
+    hideHelp(hide = true) {
+        this.$.hideHelp(hide);
+        return this;
+    }
+    hidden(hidden = true) {
+        this.$.hidden = hidden;
+        return this;
+    }
+    preset(arg) {
+        this.$.preset(arg);
+        return this;
+    }
+    default(value, description) {
+        this.$.default(value, description);
+        return this;
+    }
+    choices(values) {
+        if (!OptionHelpers.hasArgument(this.$)) {
+            throw new Error('Cannot set choices on option with no argument: ' + this.$.name());
+        }
+        this.$.choices(values);
+        return this;
+    }
+    conflicts(names) {
+        this.$.conflicts(names);
+        return this;
+    }
+    implies(optionValues) {
+        this.$.implies(optionValues);
+        return this;
+    }
+    env(name) {
+        this.$.env(name);
+        return this;
+    }
+    short(short) {
+        OptionHelpers.setShort(this.$, short);
+        return this;
+    }
+    get parser() {
+        if (!OptionHelpers.hasArgument(this.$)) {
+            throw new Error('Cannot set parser on option with no argument: ' + this.$.attributeName());
+        }
+        return new OptionArgumentParserSelector(this);
+    }
+    get validator() {
+        if (!OptionHelpers.hasArgument(this.$)) {
+            throw new Error('Cannot set validator on option with no argument: ' + this.$.attributeName());
+        }
+        return new OptionArgumentValidatorSelector(this);
+    }
+    get get() {
+        return realizeLazyProperty(this, 'get', new OptionReader(this));
+    }
+}
+//# sourceMappingURL=OptionBuilder.js.map

package/dist/esm/opt/OptionBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptionBuilder.js","sourceRoot":"","sources":["../../../src/opt/OptionBuilder.ts"],"names":[],"mappings":"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"}

package/dist/esm/opt/OptionHelpers.js

@@ -0,0 +1,54 @@
+import { arrLast } from '../util/array/arrLast';
+import { strEnsureStartsWith } from '../util/string/strEnsureStartsWith';
+/**
+ * Extract the argument name from an option's 'flags' string.
+ */
+function getArgumentName(opt) {
+    const result = arrLast(opt.flags.trim().split(' '));
+    if (/-/.test(result))
+        return undefined;
+    return result;
+}
+/**
+ * Check if an option has an argument.
+ */
+function hasArgument(opt) {
+    return /[<>[\]]/.test(opt.flags);
+}
+/**
+ * Update an Option's 'flags' property from its 'short' and 'long' properties.
+ * The flags property is not automatically updated when 'short' or 'long' are changed.
+ */
+function renderFlags(opt) {
+    const shortLong = [];
+    if (opt.short)
+        shortLong.push(opt.short);
+    if (opt.long)
+        shortLong.push(opt.long);
+    const argName = getArgumentName(opt);
+    return shortLong.join(', ') + (argName ? ' ' + argName : '');
+}
+/**
+ * Set an Option's 'long' name. The 'flags' property is updated accordingly.
+ * The '--' prefix is automatically added if not present.
+ */
+function setLong(opt, long) {
+    opt.long = strEnsureStartsWith(long, '--').replace(/^-+/, '--');
+    opt.flags = renderFlags(opt);
+}
+/**
+ * Set an Option's 'short' name. The 'flags' property is updated accordingly.
+ * The '-' prefix is automatically added if not present.
+ */
+function setShort(opt, short) {
+    opt.short = strEnsureStartsWith(short, '-').replace(/^-+/, '-');
+    opt.flags = renderFlags(opt);
+}
+export const OptionHelpers = {
+    getArgumentName,
+    hasArgument,
+    renderFlags,
+    setLong,
+    setShort,
+};
+//# sourceMappingURL=OptionHelpers.js.map

package/dist/esm/opt/OptionHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptionHelpers.js","sourceRoot":"","sources":["../../../src/opt/OptionHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAE/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAA;AAExE;;GAEG;AACH,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;IACnD,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAA;IACtC,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AAClC,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,SAAS,GAAG,EAAE,CAAA;IACpB,IAAI,GAAG,CAAC,KAAK;QAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACxC,IAAI,GAAG,CAAC,IAAI;QAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACtC,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;IACpC,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAC9D,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,GAAW,EAAE,IAAY;IACxC,GAAG,CAAC,IAAI,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAC/D,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;AAC9B,CAAC;AAED;;;GAGG;AACH,SAAS,QAAQ,CAAC,GAAW,EAAE,KAAa;IAC1C,GAAG,CAAC,KAAK,GAAG,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IAC/D,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;AAC9B,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,eAAe;IACf,WAAW;IACX,WAAW;IACX,OAAO;IACP,QAAQ;CACT,CAAA"}

package/dist/esm/opt/OptionReader.js

@@ -0,0 +1,62 @@
+import { OptionHelpers } from './OptionHelpers';
+export class OptionReader {
+    parent;
+    constructor(parent) {
+        this.parent = parent;
+    }
+    get $() {
+        return this.parent.$;
+    }
+    get option() {
+        return this.parent.$;
+    }
+    get description() {
+        return this.$.description;
+    }
+    get optional() {
+        return this.$.optional;
+    }
+    get mandatory() {
+        return this.$.mandatory;
+    }
+    get hidden() {
+        return this.$.hidden;
+    }
+    get variadic() {
+        return this.$.variadic;
+    }
+    get short() {
+        return this.$.short;
+    }
+    get long() {
+        return this.$.long;
+    }
+    get preset() {
+        return this.$.presetArg;
+    }
+    get default() {
+        return this.$.defaultValue;
+    }
+    get choices() {
+        return this.$.argChoices;
+    }
+    get env() {
+        return this.$.envVar;
+    }
+    get flags() {
+        return this.$.flags;
+    }
+    get name() {
+        return this.$.name();
+    }
+    get attributeName() {
+        return this.$.attributeName();
+    }
+    get defaultValueDescription() {
+        return this.$.defaultValueDescription;
+    }
+    get hasArgument() {
+        return OptionHelpers.hasArgument(this.parent.$);
+    }
+}
+//# sourceMappingURL=OptionReader.js.map

package/dist/esm/opt/OptionReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptionReader.js","sourceRoot":"","sources":["../../../src/opt/OptionReader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C,MAAM,OAAO,YAAY;IACQ;IAA/B,YAA+B,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAExD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IACtB,CAAC;IACD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IACtB,CAAC;IACD,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,CAAC,CAAC,WAAW,CAAA;IAC3B,CAAC;IACD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAA;IACxB,CAAC;IACD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;IACzB,CAAC;IACD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;IACtB,CAAC;IACD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAA;IACxB,CAAC;IACD,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAA;IACrB,CAAC;IACD,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;IACpB,CAAC;IACD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;IACzB,CAAC;IACD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,CAAC,CAAC,YAAY,CAAA;IAC5B,CAAC;IACD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,CAAC,CAAC,UAAU,CAAA;IAC1B,CAAC;IACD,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;IACtB,CAAC;IACD,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAA;IACrB,CAAC;IACD,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACtB,CAAC;IACD,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE,CAAA;IAC/B,CAAC;IACD,IAAI,uBAAuB;QACzB,OAAO,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAA;IACvC,CAAC;IACD,IAAI,WAAW;QACb,OAAO,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IACjD,CAAC;CACF"}

package/dist/esm/types/IConfig.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IConfig.js.map

package/dist/esm/types/IConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConfig.js","sourceRoot":"","sources":["../../../src/types/IConfig.ts"],"names":[],"mappings":""}

package/dist/esm/types/IPreset.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IPreset.js.map

package/dist/esm/types/IPreset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPreset.js","sourceRoot":"","sources":["../../../src/types/IPreset.ts"],"names":[],"mappings":""}

package/dist/esm/util/array/arrLast.js

@@ -0,0 +1,17 @@
+/**
+ * Returns the last element of an array.
+ * Throws an error if the array is empty.
+ * @template T The type of elements in the array.
+ * @param array The array to get the last element from.
+ * @returns The last element of the array.
+ * @throws If the array is empty.
+ * @example const numbers = [1, 2, 3, 4, 5];
+ * const lastNumber = arrLast(numbers);
+ * //=> 5
+ */
+export function arrLast(array) {
+    if (!array.length)
+        throw new Error('Cannot get last element of empty array.');
+    return array[array.length - 1];
+}
+//# sourceMappingURL=arrLast.js.map

package/dist/esm/util/array/arrLast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrLast.js","sourceRoot":"","sources":["../../../../src/util/array/arrLast.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAI,KAAU;IACnC,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;IAC7E,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AAChC,CAAC"}

package/dist/esm/util/array/arrSome.js

@@ -0,0 +1,22 @@
+/**
+ * Checks if at least one element in the array satisfies the provided predicate.
+ * @param predicate The predicate function to apply to each element.
+ * @template T The type of elements in the input array.
+ * @returns Returns `true` if at least one element in the array passes the test implemented by the provided function, otherwise `false`.
+ * @param input The array to check.
+ * @example ```ts
+ * const numbers = [1, 2, 3, 4, 5];
+ * const isEven = (num) => num % 2 === 0;
+ * arrSome(numbers, isEven);
+ * //=> true
+ * ```
+ */
+export function arrSome(input, predicate) {
+    for (let i = 0, len = input.length; i < len; i++) {
+        if (predicate(input[i], i, input) === true) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=arrSome.js.map

package/dist/esm/util/array/arrSome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrSome.js","sourceRoot":"","sources":["../../../../src/util/array/arrSome.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,OAAO,CAAI,KAAe,EAAE,SAA4B;IACtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE;QAChD,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;YAC1C,OAAO,IAAI,CAAA;SACZ;KACF;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/esm/util/array/types/ArrayPredicate.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ArrayPredicate.js.map

package/dist/esm/util/array/types/ArrayPredicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayPredicate.js","sourceRoot":"","sources":["../../../../../src/util/array/types/ArrayPredicate.ts"],"names":[],"mappings":""}

package/dist/esm/util/db/JsonDB.js

@@ -0,0 +1,141 @@
+import { ensureThat } from '../validation/ensureThat';
+import { isObject } from '../validation/isObject';
+import { readJsonFileSafeSync } from '../fs/readJsonFile/readJsonFileSafeSync';
+import { writeJsonFileSafe } from '../fs/writeJsonFile/writeJsonFileSafe';
+/**
+ * Represents a simple JSON file database.
+ */
+export class JsonDB {
+    filepath;
+    indents;
+    /**
+     * The data stored in the JSON database.
+     */
+    data;
+    /**
+     * Creates a new instance of the JsonDB class.
+     * @param filepath - The filepath where the data file is stored or to be stored.
+     */
+    constructor(filepath, indents = 0) {
+        this.filepath = filepath;
+        this.indents = indents;
+        this.data = readJsonFileSafeSync(this.filepath) ?? {};
+    }
+    /**
+     * Saves the data to the JSON file.
+     */
+    async save(indents = this.indents) {
+        return await writeJsonFileSafe(this.filepath, this.data, { spaces: indents });
+    }
+    /**
+     * Sets the filepath of the JSON file.
+     * @param filepath - The new filepath.
+     */
+    setFilepath(filepath, save = true) {
+        if (this.filepath === filepath)
+            return;
+        this.filepath = filepath;
+        if (save)
+            this.save();
+    }
+    /**
+     * Sets a value in the JSON database.
+     * @param prefix - Object path prefix as dot-separated keys.
+     * @param value - The value to set.
+     * @param save - Whether to save the data to the JSON file.
+     */
+    set(prefix, value = {}, save = true) {
+        if (!prefix) {
+            this.data = ensureThat(value, isObject);
+        }
+        else {
+            const keys = prefix.split('.');
+            const lastKey = keys.pop();
+            let node = this.data;
+            for (const key of keys) {
+                if (!Object.hasOwn(node, key)) {
+                    node[key] = {};
+                }
+                node = node[key];
+            }
+            node[lastKey] = this.cloneDeep(value);
+        }
+        if (save)
+            this.save();
+    }
+    /**
+     * Gets a value from the JSON database.
+     * @param prefix - Object path prefix as dot-separated keys.
+     * @returns The value associated with the key.
+     * @throws An error if no entry is found at the specified key.
+     */
+    get(prefix) {
+        const value = this.getSafe(prefix);
+        if (value === undefined)
+            throw new Error(`No entry at '${prefix}'`);
+        return this.cloneDeep(value);
+    }
+    /**
+     * Gets a value from the JSON database safely.
+     * @param prefix - Object path prefix as dot-separated keys.
+     * @returns The value associated with the key, or undefined if no entry is found.
+     */
+    getSafe(prefix) {
+        if (!prefix)
+            return this.cloneDeep(this.data);
+        const keys = prefix.split('.');
+        let node = this.data;
+        for (const key of keys) {
+            if (!Object.hasOwn(node, key)) {
+                return undefined;
+            }
+            node = node[key];
+        }
+        return this.cloneDeep(node);
+    }
+    /**
+     * Checks if a key exists in the JSON database.
+     * @param prefix - Object path prefix as dot-separated keys.
+     * @returns True if the key exists, false otherwise.
+     */
+    has(prefix) {
+        if (!prefix)
+            return true;
+        return this.getSafe(prefix) !== undefined;
+    }
+    /**
+     * Deletes a value from the JSON database.
+     * @param prefix - Object path prefix as dot-separated keys.
+     * @param save - Whether to save the data to the JSON file.
+     */
+    delete(prefix, save = true) {
+        if (!prefix) {
+            this.data = {};
+        }
+        else {
+            const keys = prefix.split('.');
+            const lastKey = keys.pop();
+            let node = this.data;
+            for (const key of keys) {
+                if (!Object.hasOwn(node, key)) {
+                    return;
+                }
+                node = node[key];
+            }
+            delete node[lastKey];
+        }
+        if (save)
+            this.save();
+    }
+    /**
+     * Creates a deep clone of an object.
+     * @param obj - The object to clone.
+     * @returns The cloned object.
+     */
+    cloneDeep(obj) {
+        if (typeof obj !== 'object')
+            return obj;
+        return JSON.parse(JSON.stringify(obj));
+    }
+}
+//# sourceMappingURL=JsonDB.js.map

package/dist/esm/util/db/JsonDB.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonDB.js","sourceRoot":"","sources":["../../../../src/util/db/JsonDB.ts"],"names":[],"mappings":"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"}

package/dist/esm/util/errors/ErrorParser.js

@@ -0,0 +1,154 @@
+import colors from 'ansi-colors';
+import path from 'path';
+import { isPlainObject } from '../validation/isPlainObject';
+import { isPrimitive } from '../validation/isPrimitive';
+import { regexEscapeString } from '../regex/regexEscapeString';
+export class ErrorParser {
+    error;
+    constructor(error) {
+        this.error = error instanceof Error ? error : new Error(String(error));
+    }
+    get name() {
+        return this.error.name;
+    }
+    get message() {
+        return this.error.message;
+    }
+    get stack() {
+        return this.error.stack || '';
+    }
+    summary() {
+        return this.name + ': ' + this.message;
+    }
+    parseStackFrames() {
+        return errParseStack(this.stack);
+    }
+    prettyStack(parsedStackFrames) {
+        return errPrettyStack(this.error, parsedStackFrames);
+    }
+    toObject() {
+        return errToObject(this.error);
+    }
+    toJSON() {
+        return this.toObject();
+    }
+}
+export function errPrettyStack(error, parsedStackFrames) {
+    const frames = parsedStackFrames ?? errParseStack(error.stack || '');
+    // width of the first column = the longest frame.cell string
+    const offset = 2 + frames.reduce((acc, frame) => Math.max(acc, frame[0].length), 0);
+    // type and message
+    const result = [
+        colors.bold(colors.red(error.name)) +
+            ': ' +
+            ' '.repeat(Math.max(0, offset - error.name.length)) +
+            colors.red(error.message),
+    ];
+    // stack trace
+    result.push(colors.yellow('stack') + ':');
+    result.push(frames
+        .map((frame) => {
+        const [call, file] = frame;
+        let s = '  ';
+        let fp;
+        if (file.startsWith('node:')) {
+            s += colors.gray(call);
+            fp = colors.gray(file);
+        }
+        else if (file.includes('node_modules')) {
+            s += call;
+            const base = path.basename(file.split(':')[0]);
+            fp = file.replace(base, colors.yellow(base));
+        }
+        else {
+            s += call;
+            const base = path.basename(file.split(':')[0]);
+            fp = file.replace(base, colors.red(base));
+        }
+        s += ' '.repeat(offset - call.length);
+        s += fp;
+        return s;
+    })
+        .join('\n'));
+    // other properties
+    const ignore = ['name', 'message', 'frames', 'stack'];
+    const keys = Object.getOwnPropertyNames(error).filter((key) => !ignore.includes(key));
+    for (const k of keys) {
+        if (typeof k === 'symbol')
+            continue;
+        const key = k;
+        let s = colors.yellow(key.toString()) + ': ';
+        if (isPlainObject(error[key])) {
+            const json = JSON.stringify(error[key], null, 2);
+            if (json.length < 350) {
+                s += JSON.stringify(error[key], null, 2)
+                    .split('\n')
+                    .map((line) => {
+                    const arr = line.split('": ');
+                    arr[0] = colors.gray(arr[0].replace('"', ''));
+                    return arr.join(': ');
+                })
+                    .join('\n');
+            }
+            else {
+                s += JSON.stringify(error[key]);
+            }
+        }
+        else if (isPrimitive(error[key])) {
+            s += String(error[key]);
+        }
+        else if (error[key] != null && typeof error[key] === 'object') {
+            s += error[key].toString();
+        }
+        else {
+            s += JSON.stringify(error[key]);
+        }
+        result.push(s.trim());
+    }
+    return '\n' + result.join('\n') + '\n';
+}
+export function errParseStack(stack) {
+    if (!stack)
+        return [];
+    const nodeRe = /^\s*at (?:((?:\[object object\])?[^\\/]+(?: \[as \S+\])?) )?\(?(.*?):(\d+)(?::(\d+))?\)?\s*$/i;
+    const recwd = new RegExp('^' + regexEscapeString(process.cwd() + path.sep), 'i');
+    const frames = [];
+    for (const line of stack.split('\n')) {
+        const parts = nodeRe.exec(line);
+        if (!parts)
+            continue;
+        frames.push([
+            parts[1] || '<unknown>',
+            `${(parts[2] || '').replace(recwd, '').replace(/\\\\?/g, '/')}:${+parts[3]}:${parts[4] ? +parts[4] : null}`,
+        ]);
+    }
+    return frames;
+}
+export function errToObject(error) {
+    const own = Object.getOwnPropertyNames(error).filter((key) => typeof key === 'string');
+    const keys = new Set(['name', 'message', 'frames', ...own]);
+    keys.delete('stack');
+    const entries = Array.from(keys)
+        .filter((key) => error[key] !== undefined)
+        .map((key) => [key, error[key]]);
+    return Object.fromEntries(entries);
+}
+// try {
+//   throw new TypeError('wow ok oops')
+// } catch (error) {
+//   const err = new ErrorParser(error)
+//   console.log('----------------------')
+//   console.log({
+//     name: err.name,
+//     message: err.message,
+//     summary: err.summary,
+//   })
+//   console.log('----------------------')
+//   console.log(err.stack)
+//   console.log('----------------------')
+//   console.log(err.prettyStack())
+//   console.log('----------------------')
+//   console.log(err.toObject())
+//   console.log('----------------------')
+// }
+//# sourceMappingURL=ErrorParser.js.map

package/dist/esm/util/errors/ErrorParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorParser.js","sourceRoot":"","sources":["../../../../src/util/errors/ErrorParser.ts"],"names":[],"mappings":"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"}

package/dist/esm/util/fs/promptUserEditInTextEditor/IGetUserInputFromEditorOptions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IGetUserInputFromEditorOptions.js.map

package/dist/esm/util/fs/promptUserEditInTextEditor/IGetUserInputFromEditorOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IGetUserInputFromEditorOptions.js","sourceRoot":"","sources":["../../../../../src/util/fs/promptUserEditInTextEditor/IGetUserInputFromEditorOptions.ts"],"names":[],"mappings":""}

package/dist/esm/util/fs/promptUserEditInTextEditor/promptUserEditInTextEditorSync.js

@@ -0,0 +1,28 @@
+import { defaultOpenInEditorCommand } from '../../os/defaultOpenInEditorCommand';
+import { execSync } from 'child_process';
+import { readFileSync } from '../readFile/readFileSync';
+import { strEnsureStartsWith } from '../../string/strEnsureStartsWith';
+import { tempFileSync } from '../tempFile/tempFileSync';
+import { writeFileSync } from '../writeFile/writeFileSync';
+/**
+ * Prompts the user to edit a string in the user's text editor.
+ *
+ * @example ```ts
+ * promptUserEditInTextEditor({ editor: 'notepad' })
+ * ```
+ */
+export function promptUserEditInTextEditorSync(options) {
+    const { editor, content, extension } = applyDefaults(options);
+    return tempFileSync(extension, (tempfile) => {
+        writeFileSync(tempfile, content);
+        execSync(`${editor} ${tempfile}`, { stdio: 'inherit' });
+        return readFileSync(tempfile);
+    });
+}
+function applyDefaults(options = {}) {
+    const content = options.content ?? '';
+    const extension = strEnsureStartsWith(options.extension ?? '.txt', '.');
+    const editor = options.editor ?? defaultOpenInEditorCommand();
+    return { content, extension, editor };
+}
+//# sourceMappingURL=promptUserEditInTextEditorSync.js.map

package/dist/esm/util/fs/promptUserEditInTextEditor/promptUserEditInTextEditorSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptUserEditInTextEditorSync.js","sourceRoot":"","sources":["../../../../../src/util/fs/promptUserEditInTextEditor/promptUserEditInTextEditorSync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAA;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAAwC;IACrF,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;IAC7D,OAAO,YAAY,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;QAC1C,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAChC,QAAQ,CAAC,GAAG,MAAM,IAAI,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;QACvD,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAA;IAC/B,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,UAA0C,EAAE;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAA;IACrC,MAAM,SAAS,GAAG,mBAAmB,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,EAAE,GAAG,CAAC,CAAA;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,0BAA0B,EAAE,CAAA;IAC7D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAA;AACvC,CAAC"}