obsidian-dev-utils 18.4.2 → 19.0.0

package/dist/lib/Object.d.mts

@@ -0,0 +1,211 @@
+/**
+ * @packageDocumentation Object
+ * Contains utility functions for Objects.
+ */
+import type { UndefinedOnPartialDeep } from 'type-fest';
+/**
+ * Specifies how functions should be handled in the JSON output.
+ */
+export declare enum FunctionHandlingMode {
+    /**
+     * Excludes functions from the JSON output.
+     */
+    Exclude = "exclude",
+    /**
+     * Includes the full function definition in the JSON output.
+     */
+    Full = "full",
+    /**
+     * Includes only the function name in the JSON output.
+     */
+    NameOnly = "nameOnly"
+}
+/**
+ * Represents a constructor type for a given class `T` with arguments `Args`.
+ *
+ * @typeParam Type - The type of the instance being constructed.
+ * @typeParam Args - The types of arguments the constructor accepts.
+ */
+export type Constructor<Type, Args extends unknown[] = []> = new (...args: Args) => Type;
+/**
+ * Extracts the keys of a given type `Type` that match a specific value type `Value`.
+ *
+ * @typeParam Type - The type from which to extract the keys.
+ * @typeParam Value - The value type to match against.
+ */
+export type KeysMatching<Type, Value> = {
+    [Key in keyof Type]-?: Type[Key] extends Value ? Key : never;
+}[keyof Type];
+/**
+ * Options for converting an object to JSON.
+ */
+export interface ToJsonOptions {
+    /**
+     * Specifies how functions should be handled in the JSON output (default: `exclude`).
+     */
+    functionHandlingMode: FunctionHandlingMode;
+    /**
+     * Specifies the maximum depth of nested objects to include in the JSON output.
+     * Use `-1` for no limit.
+     * Defaults to `-1`.
+     */
+    maxDepth: number;
+    /**
+     * Specifies whether to catch errors in `toJSON()` and replace them with a placeholder.
+     * Defaults to `false`.
+     */
+    shouldCatchToJSONErrors: boolean;
+    /**
+     * Specifies whether to handle circular references in the JSON output.
+     * Defaults to `false`.
+     */
+    shouldHandleCircularReferences: boolean;
+    /**
+     * Specifies whether to handle errors in the JSON output.
+     * Defaults to `false`.
+     */
+    shouldHandleErrors: boolean;
+    /**
+     * Specifies whether to handle undefined values in the JSON output.
+     * Defaults to `false`.
+     */
+    shouldHandleUndefined: boolean;
+    /**
+     * Specifies whether to sort the keys of the JSON output.
+     * Defaults to `false`.
+     */
+    shouldSortKeys: boolean;
+    /**
+     * Specifies the indentation of the JSON output. This can be a number of spaces or a string. Defaults to `2`.
+     */
+    space: number | string;
+    /**
+     * Specifies the substitutions to use in the JSON output.
+     */
+    tokenSubstitutions: Partial<TokenSubstitutions>;
+}
+interface TokenSubstitutions {
+    circularReference: string;
+    maxDepthLimitReached: string;
+    toJSONFailed: string;
+}
+/**
+ * Assigns properties from one or more source objects to a target object, including non-enumerable properties.
+ *
+ * @param target - The target object to assign properties to.
+ * @param source - The source object to assign properties from.
+ * @returns The target object with the assigned properties.
+ */
+export declare function assignWithNonEnumerableProperties<T extends object, U>(target: T, source: U): T & U;
+/**
+ * @param target - The target object to assign properties to.
+ * @param source1 - The first source object to assign properties from.
+ * @param source2 - The second source object to assign properties from.
+ * @returns The target object with the assigned properties.
+ */
+export declare function assignWithNonEnumerableProperties<T extends object, U, V>(target: T, source1: U, source2: V): T & U & V;
+/**
+ * Assigns properties from one or more source objects to a target object, including non-enumerable properties.
+ *
+ * @param target - The target object to assign properties to.
+ * @param source1 - The first source object to assign properties from.
+ * @param source2 - The second source object to assign properties from.
+ * @param source3 - The third source object to assign properties from.
+ * @returns The target object with the assigned properties.
+ */
+export declare function assignWithNonEnumerableProperties<T extends object, U, V, W>(target: T, source1: U, source2: V, source3: W): T & U & V & W;
+/**
+ * Clones an object, including non-enumerable properties.
+ *
+ * @param obj - The object to clone.
+ * @returns A new object with the same properties as the original object, including non-enumerable properties.
+ */
+export declare function cloneWithNonEnumerableProperties<T extends object>(obj: T): T;
+/**
+ * Compares two values to determine if they are deeply equal.
+ *
+ * @param a - The first value to compare.
+ * @param b - The second value to compare.
+ * @returns `true` if the values are deeply equal, otherwise `false`.
+ */
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+/**
+ * Deletes multiple properties from an object.
+ *
+ * @typeParam T - The type of the object.
+ * @param obj - The object to delete the properties from.
+ * @param propertyNames - The names of the properties to delete.
+ * @returns `true` if any of the properties were present, otherwise `false`.
+ */
+export declare function deleteProperties<T extends object>(obj: T, propertyNames: (keyof T)[]): boolean;
+/**
+ * Deletes a property from an object.
+ *
+ * @typeParam T - The type of the object.
+ * @param obj - The object to delete the property from.
+ * @param propertyName - The name of the property to delete.
+ * @returns `true` if the property was present, otherwise `false`.
+ */
+export declare function deleteProperty<T extends object>(obj: T, propertyName: keyof T): boolean;
+/**
+ * Gets the value of a nested property from an object.
+ *
+ * @param obj - The object to get the nested property value from.
+ * @param path - The path to the nested property.
+ * @returns The value of the nested property.
+ */
+export declare function getNestedPropertyValue(obj: Record<string, unknown>, path: string): unknown;
+/**
+ * Gets the prototype of the specified object.
+ *
+ * @typeParam T - The type of the object.
+ * @param instance - The object instance to retrieve the prototype of.
+ * @returns The prototype of the object.
+ */
+export declare function getPrototypeOf<T>(instance: T): T;
+/**
+ * Retrieves the name of a property of a given type `T`.
+ *
+ * @typeParam T - The type of the object containing the property.
+ * @param name - The name of the property as a string.
+ * @returns The name of the property.
+ */
+export declare function nameof<T>(name: Extract<keyof T, string>): string;
+/**
+ * Normalizes optional properties to allow `undefined` assignment in strict mode.
+ *
+ * This utility provides a workaround for the `exactOptionalPropertyTypes` TypeScript flag,
+ * which prohibits directly assigning `undefined` to optional properties when the type
+ * explicitly omits `undefined`.
+ *
+ * Example:
+ * ```typescript
+ * // With `exactOptionalPropertyTypes: true`
+ * const x: { prop?: string } = { prop: undefined }; // Compiler error
+ *
+ * // Using this utility:
+ * const y: { prop?: string } = normalizeOptionalProperties<{ prop?: string }>({ prop: undefined }); // Works
+ * ```
+ *
+ * @typeParam T - The target type with optional properties to normalize.
+ * @param obj - The object to normalize, allowing explicit `undefined` for optional properties.
+ * @returns The normalized object, compatible with `exactOptionalPropertyTypes`.
+ */
+export declare function normalizeOptionalProperties<T>(obj: UndefinedOnPartialDeep<T>): T;
+/**
+ * Sets the value of a nested property in an object.
+ *
+ * @param obj - The object to set the nested property value in.
+ * @param path - The path to the nested property.
+ * @param value - The value to set.
+ */
+export declare function setNestedPropertyValue(obj: Record<string, unknown>, path: string, value: unknown): void;
+/**
+ * Converts a given value to a JSON string.
+ *
+ * @param value - The value to be converted to JSON. This can be of any type.
+ * @param options - Options for customizing the JSON conversion process.
+ * @returns The JSON string representation of the input value.
+ */
+export declare function toJson(value: unknown, options?: Partial<ToJsonOptions>): string;
+export {};

package/dist/lib/Path.d.mts

@@ -0,0 +1,133 @@
+/**
+ * @packageDocumentation Path
+ * Contains utility functions for handling paths.
+ */
+import pathBrowserify from 'path-browserify';
+/**
+ * Provides methods for handling POSIX paths.
+ */
+export declare const posix: pathBrowserify.Path;
+/**
+ * The POSIX path delimiter.
+ */
+export declare const delimiter: string;
+/**
+ * The POSIX segment separator.
+ */
+export declare const sep: string;
+/**
+ * Returns the base name of a file, optionally removing the file extension.
+ *
+ * @param path - The path to get the base name from.
+ * @param ext - An optional extension to remove from the base name.
+ * @returns The base name of the file.
+ */
+export declare const basename: (this: void, path: string, ext?: string) => string;
+/**
+ * Returns the directory name of a path.
+ *
+ * @param path - The path to get the directory name from.
+ * @returns The directory name of the path.
+ */
+export declare const dirname: (this: void, path: string) => string;
+/**
+ * Returns the file extension of a path.
+ *
+ * @param path - The path to get the extension from.
+ * @returns The file extension of the path.
+ */
+export declare const extname: (this: void, path: string) => string;
+/**
+ * Formats a path object into a path string.
+ *
+ * @param pathObject - The path object to format.
+ * @returns The formatted path string.
+ */
+export declare const format: (this: void, pathObject: Partial<pathBrowserify.PathObject>) => string;
+/**
+ * Determines if a path is absolute.
+ *
+ * @param path - The path to check.
+ * @returns `true` if the path is absolute, `false` otherwise.
+ */
+export declare function isAbsolute(path: string): boolean;
+/**
+ * Joins multiple path segments into a single path.
+ *
+ * @param paths - The path segments to join.
+ * @returns The joined path.
+ */
+export declare const join: (this: void, ...paths: string[]) => string;
+/**
+ * Normalizes a path, resolving '..' and '.' segments.
+ *
+ * @param path - The path to normalize.
+ * @returns The normalized path.
+ */
+export declare const normalize: (this: void, path: string) => string;
+/**
+ * Parses a path string into a path object.
+ *
+ * @param path - The path string to parse.
+ * @returns The parsed path object.
+ */
+export declare const parse: (this: void, path: string) => pathBrowserify.PathObject;
+/**
+ * Returns the relative path from one path to another.
+ *
+ * @param from - The starting path.
+ * @param to - The destination path.
+ * @returns The relative path from `from` to `to`.
+ */
+export declare const relative: (this: void, from: string, to: string) => string;
+/**
+ * Gets the directory name from the `import(dot)meta(dot)url`, converting it to a POSIX-style path.
+ *
+ * @param importMetaUrl - The `import(dot)meta(dot)url` from which to extract the directory name.
+ * @returns The POSIX-style directory name.
+ */
+export declare function getDirname(importMetaUrl: string): string;
+/**
+ * Gets the filename from the `import(dot)meta(dot)url`, converting it to a POSIX-style path.
+ *
+ * @param importMetaUrl - The `import(dot)meta(dot)url` from which to extract the filename.
+ * @returns The POSIX-style filename.
+ */
+export declare function getFilename(importMetaUrl: string): string;
+/**
+ * Makes a filename by appending an extension to a given filename.
+ * If the extension is empty, the filename is returned as is.
+ *
+ * @param fileName - The filename to append the extension to.
+ * @param extension - The extension to append to the filename.
+ * @returns The filename with the extension appended.
+ */
+export declare function makeFileName(fileName: string, extension: string): string;
+/**
+ * Normalizes a given path by ensuring it is relative, adding "./" if necessary.
+ *
+ * @param path - The path to normalize.
+ * @returns The normalized path, starting with "./" if it was relative.
+ */
+export declare function normalizeIfRelative(path: string): string;
+/**
+ * Resolves a sequence of paths or path segments into an absolute path.
+ *
+ * @param pathSegments - The sequence of path segments to resolve.
+ * @returns The resolved absolute path.
+ */
+export declare function resolve(...pathSegments: string[]): string;
+/**
+ * Converts a buffer containing a path to a POSIX-style buffer by replacing backslashes with forward slashes.
+ *
+ * @param buffer - The buffer to convert.
+ * @returns A new buffer containing the POSIX-style path.
+ */
+export declare function toPosixBuffer(buffer: Buffer): Buffer;
+/**
+ * Converts a given path to a POSIX-style path by replacing backslashes with forward slashes.
+ *
+ * @param path - The path to convert.
+ * @returns The POSIX-style path.
+ */
+export declare function toPosixPath(path: string): string;

package/dist/lib/RegExp.d.mts

@@ -0,0 +1,18 @@
+/**
+ * @packageDocumentation RegExp
+ * Contains utility functions for regular expressions.
+ */
+/**
+ * Escapes special characters in a string to safely use it within a regular expression.
+ *
+ * @param str - The string to escape.
+ * @returns The escaped string with special characters prefixed with a backslash.
+ */
+export declare function escapeRegExp(str: string): string;
+/**
+ * Checks if a string is a valid regular expression.
+ *
+ * @param str - The string to check.
+ * @returns `true` if the string is a valid regular expression, `false` otherwise.
+ */
+export declare function isValidRegExp(str: string): boolean;

package/dist/lib/ScriptUtils/CliUtils.cjs

@@ -0,0 +1,161 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function initCjs(){const globalThisRecord=globalThis;globalThisRecord["__name"]??=name;const originalRequire=require;if(originalRequire&&!originalRequire.__isPatched){require=Object.assign(id=>requirePatched(id),originalRequire,{__isPatched:true})}const newFuncs={__extractDefault:__name(()=>extractDefault,"__extractDefault"),process:__name(()=>{const browserProcess={browser:true,cwd:__name(()=>"/","cwd"),env:{},platform:"android"};return browserProcess},"process")};for(const key of Object.keys(newFuncs)){globalThisRecord[key]??=newFuncs[key]?.()}function name(obj){return obj}__name(name,"name");function extractDefault(module){return module&&module.__esModule&&module.default?module.default:module}__name(extractDefault,"extractDefault");function requirePatched(id){const module=originalRequire?.(id);if(module){return extractDefault(module)}if(id==="process"||id==="node:process"){console.error(`Module not found: ${id}. Fake process object is returned instead.`);return globalThis.process}console.error(`Module not found: ${id}. Empty object is returned instead.`);return{}}__name(requirePatched,"requirePatched")})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var CliUtils_exports = {};
+__export(CliUtils_exports, {
+  CliTaskResult: () => CliTaskResult,
+  toCommandLine: () => toCommandLine,
+  wrapCliTask: () => wrapCliTask
+});
+module.exports = __toCommonJS(CliUtils_exports);
+var import_Debug = require('../Debug.cjs');
+var import_Error = require('../Error.cjs');
+var import_Function = require('../Function.cjs');
+var import_String = require('../String.cjs');
+var import_NodeModules = require('./NodeModules.cjs');
+class CliTaskResult {
+  /**
+   * Chains multiple tasks together, executing them sequentially until one fails.
+   *
+   * @param tasks - An array of task functions that return a `TaskResult` or `void`.
+   * @returns A promise that resolves with the first failed `TaskResult` or a success result.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-invalid-void-type
+  static async chain(tasks) {
+    for (const task of tasks) {
+      const result = await wrapResult(task);
+      if (!result.isSuccessful()) {
+        return result;
+      }
+    }
+    return CliTaskResult.Success();
+  }
+  /**
+   * Creates a `TaskResult` that does not exit the process.
+   *
+   * @returns A `TaskResult` that does not exit the process.
+   */
+  static DoNotExit() {
+    return new DoNotExitTaskResult();
+  }
+  /**
+   * Represents a failure result of a CLI task.
+   *
+   * @returns The failure result.
+   */
+  static Failure() {
+    return this.Success(false);
+  }
+  /**
+   * Creates a `TaskResult` based on an exit code.
+   *
+   * @param exitCode - The exit code to represent.
+   * @returns A `TaskResult` representing the exit code.
+   */
+  static FromExitCode(exitCode) {
+    return new ExitCodeTaskResult(exitCode);
+  }
+  /**
+   * Creates a CliTaskResult representing a successful task result.
+   *
+   * @param isSuccess - A boolean indicating whether the task was successful. Default is true.
+   * @returns A CliTaskResult object representing a successful task result.
+   */
+  static Success(isSuccess = true) {
+    return new SuccessTaskResult(isSuccess);
+  }
+}
+class DoNotExitTaskResult extends CliTaskResult {
+  /**
+   * Does not exit the process.
+   */
+  exit() {
+    (0, import_Function.noop)();
+  }
+  isSuccessful() {
+    return true;
+  }
+}
+class ExitCodeTaskResult extends CliTaskResult {
+  constructor(exitCode) {
+    super();
+    this.exitCode = exitCode;
+  }
+  /**
+   * Exits the process with the specified exit code.
+   */
+  exit() {
+    import_NodeModules.process.exit(this.exitCode);
+  }
+  isSuccessful() {
+    return this.exitCode === 0;
+  }
+}
+class SuccessTaskResult extends CliTaskResult {
+  constructor(_isSuccessful) {
+    super();
+    this._isSuccessful = _isSuccessful;
+  }
+  /**
+   * Exits the process based on the success of the task.
+   */
+  exit() {
+    import_NodeModules.process.exit(this._isSuccessful ? 0 : 1);
+  }
+  isSuccessful() {
+    return this._isSuccessful;
+  }
+}
+function toCommandLine(args) {
+  return args.map((arg) => {
+    if (/[\s"\n]/.test(arg)) {
+      let escapedArg = arg;
+      escapedArg = (0, import_String.replaceAll)(escapedArg, /"/g, '\\"');
+      escapedArg = (0, import_String.replaceAll)(escapedArg, /\n/g, "\\n");
+      return `"${escapedArg}"`;
+    }
+    return arg;
+  }).join(" ");
+}
+async function wrapCliTask(taskFn) {
+  (0, import_Debug.enableLibraryDebuggers)();
+  const result = await wrapResult(taskFn);
+  result.exit();
+}
+async function wrapResult(taskFn) {
+  try {
+    return await taskFn() ?? CliTaskResult.Success();
+  } catch (error) {
+    (0, import_Error.printError)(new Error("An error occurred during task execution", { cause: error }));
+    return CliTaskResult.Failure();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CliTaskResult,
+  toCommandLine,
+  wrapCliTask
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL1NjcmlwdFV0aWxzL0NsaVV0aWxzLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBwYWNrYWdlRG9jdW1lbnRhdGlvbiBjbGlcbiAqIENvbnRhaW5zIHV0aWxpdHkgY2xhc3NlcyBhbmQgZnVuY3Rpb25zIGZvciBtYW5hZ2luZyB0YXNrIHJlc3VsdHMsIGluY2x1ZGluZ1xuICogc3VjY2VzcywgZXhpdCBjb2RlcywgYW5kIGNoYWluaW5nIG11bHRpcGxlIHRhc2tzLlxuICovXG5cbmltcG9ydCB0eXBlIHsgTWF5YmVQcm9taXNlIH0gZnJvbSAnLi4vQXN5bmMudHMnO1xuXG5pbXBvcnQgeyBlbmFibGVMaWJyYXJ5RGVidWdnZXJzIH0gZnJvbSAnLi4vRGVidWcudHMnO1xuaW1wb3J0IHsgcHJpbnRFcnJvciB9IGZyb20gJy4uL0Vycm9yLnRzJztcbmltcG9ydCB7IG5vb3AgfSBmcm9tICcuLi9GdW5jdGlvbi50cyc7XG5pbXBvcnQgeyByZXBsYWNlQWxsIH0gZnJvbSAnLi4vU3RyaW5nLnRzJztcbmltcG9ydCB7IHByb2Nlc3MgfSBmcm9tICcuL05vZGVNb2R1bGVzLnRzJztcblxuLyoqXG4gKiBBYnN0cmFjdCBjbGFzcyByZXByZXNlbnRpbmcgdGhlIHJlc3VsdCBvZiBhIHRhc2suIEluY2x1ZGVzIG1ldGhvZHMgZm9yIGhhbmRsaW5nIHN1Y2Nlc3MsXG4gKiBleGl0IGNvZGVzLCBhbmQgY2hhaW5pbmcgdGFza3MuXG4gKi9cbmV4cG9ydCBhYnN0cmFjdCBjbGFzcyBDbGlUYXNrUmVzdWx0IHtcbiAgLyoqXG4gICAqIENoYWlucyBtdWx0aXBsZSB0YXNrcyB0b2dldGhlciwgZXhlY3V0aW5nIHRoZW0gc2VxdWVudGlhbGx5IHVudGlsIG9uZSBmYWlscy5cbiAgICpcbiAgICogQHBhcmFtIHRhc2tzIC0gQW4gYXJyYXkgb2YgdGFzayBmdW5jdGlvbnMgdGhhdCByZXR1cm4gYSBgVGFza1Jlc3VsdGAgb3IgYHZvaWRgLlxuICAgKiBAcmV0dXJucyBBIHByb21pc2UgdGhhdCByZXNvbHZlcyB3aXRoIHRoZSBmaXJzdCBmYWlsZWQgYFRhc2tSZXN1bHRgIG9yIGEgc3VjY2VzcyByZXN1bHQuXG4gICAqL1xuICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgQHR5cGVzY3JpcHQtZXNsaW50L25vLWludmFsaWQtdm9pZC10eXBlXG4gIHB1YmxpYyBzdGF0aWMgYXN5bmMgY2hhaW4odGFza3M6ICgoKSA9PiBNYXliZVByb21pc2U8Q2xpVGFza1Jlc3VsdCB8IHZvaWQ+KVtdKTogUHJvbWlzZTxDbGlUYXNrUmVzdWx0PiB7XG4gICAgZm9yIChjb25zdCB0YXNrIG9mIHRhc2tzKSB7XG4gICAgICBjb25zdCByZXN1bHQgPSBhd2FpdCB3cmFwUmVzdWx0KHRhc2spO1xuICAgICAgaWYgKCFyZXN1bHQuaXNTdWNjZXNzZnVsKCkpIHtcbiAgICAgICAgcmV0dXJuIHJlc3VsdDtcbiAgICAgIH1cbiAgICB9XG5cbiAgICByZXR1cm4gQ2xpVGFza1Jlc3VsdC5TdWNjZXNzKCk7XG4gIH1cblxuICAvKipcbiAgICogQ3JlYXRlcyBhIGBUYXNrUmVzdWx0YCB0aGF0IGRvZXMgbm90IGV4aXQgdGhlIHByb2Nlc3MuXG4gICAqXG4gICAqIEByZXR1cm5zIEEgYFRhc2tSZXN1bHRgIHRoYXQgZG9lcyBub3QgZXhpdCB0aGUgcHJvY2Vzcy5cbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgRG9Ob3RFeGl0KCk6IENsaVRhc2tSZXN1bHQge1xuICAgIHJldHVybiBuZXcgRG9Ob3RFeGl0VGFza1Jlc3VsdCgpO1xuICB9XG5cbiAgLyoqXG4gICAqIFJlcHJlc2VudHMgYSBmYWlsdXJlIHJlc3VsdCBvZiBhIENMSSB0YXNrLlxuICAgKlxuICAgKiBAcmV0dXJucyBUaGUgZmFpbHVyZSByZXN1bHQuXG4gICAqL1xuICBwdWJsaWMgc3RhdGljIEZhaWx1cmUoKTogQ2xpVGFza1Jlc3VsdCB7XG4gICAgcmV0dXJuIHRoaXMuU3VjY2VzcyhmYWxzZSk7XG4gIH1cblxuICAvKipcbiAgICogQ3JlYXRlcyBhIGBUYXNrUmVzdWx0YCBiYXNlZCBvbiBhbiBleGl0IGNvZGUuXG4gICAqXG4gICAqIEBwYXJhbSBleGl0Q29kZSAtIFRoZSBleGl0IGNvZGUgdG8gcmVwcmVzZW50LlxuICAgKiBAcmV0dXJucyBBIGBUYXNrUmVzdWx0YCByZXByZXNlbnRpbmcgdGhlIGV4aXQgY29kZS5cbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgRnJvbUV4aXRDb2RlKGV4aXRDb2RlOiBudW1iZXIpOiBDbGlUYXNrUmVzdWx0IHtcbiAgICByZXR1cm4gbmV3IEV4aXRDb2RlVGFza1Jlc3VsdChleGl0Q29kZSk7XG4gIH1cblxuICAvKipcbiAgICogQ3JlYXRlcyBhIENsaVRhc2tSZXN1bHQgcmVwcmVzZW50aW5nIGEgc3VjY2Vzc2Z1bCB0YXNrIHJlc3VsdC5cbiAgICpcbiAgICogQHBhcmFtIGlzU3VjY2VzcyAtIEEgYm9vbGVhbiBpbmRpY2F0aW5nIHdoZXRoZXIgdGhlIHRhc2sgd2FzIHN1Y2Nlc3NmdWwuIERlZmF1bHQgaXMgdHJ1ZS5cbiAgICogQHJldHVybnMgQSBDbGlUYXNrUmVzdWx0IG9iamVjdCByZXByZXNlbnRpbmcgYSBzdWNjZXNzZnVsIHRhc2sgcmVzdWx0LlxuICAgKi9cbiAgcHVibGljIHN0YXRpYyBTdWNjZXNzKGlzU3VjY2VzcyA9IHRydWUpOiBDbGlUYXNrUmVzdWx0IHtcbiAgICByZXR1cm4gbmV3IFN1Y2Nlc3NUYXNrUmVzdWx0KGlzU3VjY2Vzcyk7XG4gIH1cblxuICAvKipcbiAgICogRXhpdHMgdGhlIHByb2Nlc3MgYmFzZWQgb24gdGhlIHRhc2sgcmVzdWx0LlxuICAgKi9cbiAgcHVibGljIGFic3RyYWN0IGV4aXQoKTogdm9pZDtcblxuICAvKipcbiAgICogRGV0ZXJtaW5lcyBpZiB0aGUgdGFzayB3YXMgc3VjY2Vzc2Z1bC5cbiAgICpcbiAgICogQHJldHVybnMgYHRydWVgIGlmIHRoZSB0YXNrIHdhcyBzdWNjZXNzZnVsLCBvdGhlcndpc2UgYGZhbHNlYC5cbiAgICovXG4gIHByb3RlY3RlZCBhYnN0cmFjdCBpc1N1Y2Nlc3NmdWwoKTogYm9vbGVhbjtcbn1cblxuLyoqXG4gKiBSZXByZXNlbnRzIGEgdGFzayByZXN1bHQgdGhhdCBkb2VzIG5vdCBleGl0IHRoZSBwcm9jZXNzLlxuICovXG5jbGFzcyBEb05vdEV4aXRUYXNrUmVzdWx0IGV4dGVuZHMgQ2xpVGFza1Jlc3VsdCB7XG4gIC8qKlxuICAgKiBEb2VzIG5vdCBleGl0IHRoZSBwcm9jZXNzLlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIGV4aXQoKTogdm9pZCB7XG4gICAgbm9vcCgpO1xuICB9XG5cbiAgcHJvdGVjdGVkIG92ZXJyaWRlIGlzU3VjY2Vzc2Z1bCgpOiBib29sZWFuIHtcbiAgICByZXR1cm4gdHJ1ZTtcbiAgfVxufVxuXG4vKipcbiAqIFJlcHJlc2VudHMgYSB0YXNrIHJlc3VsdCBiYXNlZCBvbiBhbiBleGl0IGNvZGUuXG4gKi9cbmNsYXNzIEV4aXRDb2RlVGFza1Jlc3VsdCBleHRlbmRzIENsaVRhc2tSZXN1bHQge1xuICBwdWJsaWMgY29uc3RydWN0b3IocHJpdmF0ZSByZWFkb25seSBleGl0Q29kZTogbnVtYmVyKSB7XG4gICAgc3VwZXIoKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBFeGl0cyB0aGUgcHJvY2VzcyB3aXRoIHRoZSBzcGVjaWZpZWQgZXhpdCBjb2RlLlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIGV4aXQoKTogdm9pZCB7XG4gICAgcHJvY2Vzcy5leGl0KHRoaXMuZXhpdENvZGUpO1xuICB9XG5cbiAgcHJvdGVjdGVkIG92ZXJyaWRlIGlzU3VjY2Vzc2Z1bCgpOiBib29sZWFuIHtcbiAgICByZXR1cm4gdGhpcy5leGl0Q29kZSA9PT0gMDtcbiAgfVxufVxuXG4vKipcbiAqIFJlcHJlc2VudHMgYSB0YXNrIHJlc3VsdCBiYXNlZCBvbiBzdWNjZXNzIG9yIGZhaWx1cmUuXG4gKi9cbmNsYXNzIFN1Y2Nlc3NUYXNrUmVzdWx0IGV4dGVuZHMgQ2xpVGFza1Jlc3VsdCB7XG4gIHB1YmxpYyBjb25zdHJ1Y3Rvcihwcml2YXRlIHJlYWRvbmx5IF9pc1N1Y2Nlc3NmdWw6IGJvb2xlYW4pIHtcbiAgICBzdXBlcigpO1xuICB9XG5cbiAgLyoqXG4gICAqIEV4aXRzIHRoZSBwcm9jZXNzIGJhc2VkIG9uIHRoZSBzdWNjZXNzIG9mIHRoZSB0YXNrLlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIGV4aXQoKTogdm9pZCB7XG4gICAgcHJvY2Vzcy5leGl0KHRoaXMuX2lzU3VjY2Vzc2Z1bCA/IDAgOiAxKTtcbiAgfVxuXG4gIHByb3RlY3RlZCBvdmVycmlkZSBpc1N1Y2Nlc3NmdWwoKTogYm9vbGVhbiB7XG4gICAgcmV0dXJuIHRoaXMuX2lzU3VjY2Vzc2Z1bDtcbiAgfVxufVxuXG4vKipcbiAqIENvbnZlcnRzIGFuIGFycmF5IG9mIGNvbW1hbmQtbGluZSBhcmd1bWVudHMgaW50byBhIHNpbmdsZSBjb21tYW5kLWxpbmUgc3RyaW5nLlxuICogSGFuZGxlcyBlc2NhcGluZyBvZiBzcGVjaWFsIGNoYXJhY3RlcnMgc3VjaCBhcyBzcGFjZXMsIHF1b3RlcywgYW5kIG5ld2xpbmVzLlxuICpcbiAqIEBwYXJhbSBhcmdzIC0gVGhlIGFycmF5IG9mIGNvbW1hbmQtbGluZSBhcmd1bWVudHMgdG8gY29udmVydC5cbiAqIEByZXR1cm5zIEEgc3RyaW5nIHJlcHJlc2VudGluZyB0aGUgY29tbWFuZC1saW5lIGludm9jYXRpb24uXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB0b0NvbW1hbmRMaW5lKGFyZ3M6IHN0cmluZ1tdKTogc3RyaW5nIHtcbiAgcmV0dXJuIGFyZ3NcbiAgICAubWFwKChhcmcpID0+IHtcbiAgICAgIGlmICgvW1xcc1wiXFxuXS8udGVzdChhcmcpKSB7XG4gICAgICAgIGxldCBlc2NhcGVkQXJnID0gYXJnO1xuICAgICAgICBlc2NhcGVkQXJnID0gcmVwbGFjZUFsbChlc2NhcGVkQXJnLCAvXCIvZywgJ1xcXFxcIicpO1xuICAgICAgICBlc2NhcGVkQXJnID0gcmVwbGFjZUFsbChlc2NhcGVkQXJnLCAvXFxuL2csICdcXFxcbicpO1xuICAgICAgICByZXR1cm4gYFwiJHtlc2NhcGVkQXJnfVwiYDtcbiAgICAgIH1cbiAgICAgIHJldHVybiBhcmc7XG4gICAgfSlcbiAgICAuam9pbignICcpO1xufVxuXG4vKipcbiAqIFdyYXBzIGEgQ0xJIHRhc2sgZnVuY3Rpb24gdG8gZW5zdXJlIGl0IHJ1bnMgc2FmZWx5IGFuZCBoYW5kbGVzIGl0cyBgVGFza1Jlc3VsdGAuXG4gKlxuICogQHBhcmFtIHRhc2tGbiAtIFRoZSB0YXNrIGZ1bmN0aW9uIHRvIGV4ZWN1dGUsIHdoaWNoIG1heSByZXR1cm4gYSBgVGFza1Jlc3VsdGAgb3Igdm9pZC5cbiAqIEByZXR1cm5zIEEgcHJvbWlzZSB0aGF0IHJlc29sdmVzIHdoZW4gdGhlIHRhc2sgaXMgY29tcGxldGVkIGFuZCBleGl0cyB3aXRoIHRoZSBhcHByb3ByaWF0ZSBzdGF0dXMuXG4gKi9cbi8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBAdHlwZXNjcmlwdC1lc2xpbnQvbm8taW52YWxpZC12b2lkLXR5cGVcbmV4cG9ydCBhc3luYyBmdW5jdGlvbiB3cmFwQ2xpVGFzayh0YXNrRm46ICgpID0+IE1heWJlUHJvbWlzZTxDbGlUYXNrUmVzdWx0IHwgdm9pZD4pOiBQcm9taXNlPHZvaWQ+IHtcbiAgZW5hYmxlTGlicmFyeURlYnVnZ2VycygpO1xuICBjb25zdCByZXN1bHQgPSBhd2FpdCB3cmFwUmVzdWx0KHRhc2tGbik7XG4gIHJlc3VsdC5leGl0KCk7XG59XG5cbi8qKlxuICogU2FmZWx5IGV4ZWN1dGVzIGEgdGFzayBmdW5jdGlvbiBhbmQgcmV0dXJucyBhIGBUYXNrUmVzdWx0YC4gSWYgdGhlIHRhc2sgZnVuY3Rpb24gdGhyb3dzIGFuIGVycm9yLFxuICogdGhlIGVycm9yIGlzIGNhdWdodCwgYW5kIGEgZmFpbHVyZSBgVGFza1Jlc3VsdGAgaXMgcmV0dXJuZWQuXG4gKlxuICogQHBhcmFtIHRhc2tGbiAtIFRoZSB0YXNrIGZ1bmN0aW9uIHRvIGV4ZWN1dGUuXG4gKiBAcmV0dXJucyBBIHByb21pc2UgdGhhdCByZXNvbHZlcyB3aXRoIGEgYFRhc2tSZXN1bHRgIHJlcHJlc2VudGluZyB0aGUgb3V0Y29tZSBvZiB0aGUgdGFzay5cbiAqL1xuLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby1pbnZhbGlkLXZvaWQtdHlwZVxuYXN5bmMgZnVuY3Rpb24gd3JhcFJlc3VsdCh0YXNrRm46ICgpID0+IE1heWJlUHJvbWlzZTxDbGlUYXNrUmVzdWx0IHwgdm9pZD4pOiBQcm9taXNlPENsaVRhc2tSZXN1bHQ+IHtcbiAgdHJ5IHtcbiAgICByZXR1cm4gYXdhaXQgdGFza0ZuKCkgYXMgQ2xpVGFza1Jlc3VsdCB8IHVuZGVmaW5lZCA/PyBDbGlUYXNrUmVzdWx0LlN1Y2Nlc3MoKTtcbiAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICBwcmludEVycm9yKG5ldyBFcnJvcignQW4gZXJyb3Igb2NjdXJyZWQgZHVyaW5nIHRhc2sgZXhlY3V0aW9uJywgeyBjYXVzZTogZXJyb3IgfSkpO1xuICAgIHJldHVybiBDbGlUYXNrUmVzdWx0LkZhaWx1cmUoKTtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBUUEsbUJBQXVDO0FBQ3ZDLG1CQUEyQjtBQUMzQixzQkFBcUI7QUFDckIsb0JBQTJCO0FBQzNCLHlCQUF3QjtBQU1qQixNQUFlLGNBQWM7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBUWxDLGFBQW9CLE1BQU0sT0FBNkU7QUFDckcsZUFBVyxRQUFRLE9BQU87QUFDeEIsWUFBTSxTQUFTLE1BQU0sV0FBVyxJQUFJO0FBQ3BDLFVBQUksQ0FBQyxPQUFPLGFBQWEsR0FBRztBQUMxQixlQUFPO0FBQUEsTUFDVDtBQUFBLElBQ0Y7QUFFQSxXQUFPLGNBQWMsUUFBUTtBQUFBLEVBQy9CO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT0EsT0FBYyxZQUEyQjtBQUN2QyxXQUFPLElBQUksb0JBQW9CO0FBQUEsRUFDakM7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFPQSxPQUFjLFVBQXlCO0FBQ3JDLFdBQU8sS0FBSyxRQUFRLEtBQUs7QUFBQSxFQUMzQjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBUUEsT0FBYyxhQUFhLFVBQWlDO0FBQzFELFdBQU8sSUFBSSxtQkFBbUIsUUFBUTtBQUFBLEVBQ3hDO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFRQSxPQUFjLFFBQVEsWUFBWSxNQUFxQjtBQUNyRCxXQUFPLElBQUksa0JBQWtCLFNBQVM7QUFBQSxFQUN4QztBQWFGO0FBS0EsTUFBTSw0QkFBNEIsY0FBYztBQUFBO0FBQUE7QUFBQTtBQUFBLEVBSTlCLE9BQWE7QUFDM0IsOEJBQUs7QUFBQSxFQUNQO0FBQUEsRUFFbUIsZUFBd0I7QUFDekMsV0FBTztBQUFBLEVBQ1Q7QUFDRjtBQUtBLE1BQU0sMkJBQTJCLGNBQWM7QUFBQSxFQUN0QyxZQUE2QixVQUFrQjtBQUNwRCxVQUFNO0FBRDRCO0FBQUEsRUFFcEM7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtnQixPQUFhO0FBQzNCLCtCQUFRLEtBQUssS0FBSyxRQUFRO0FBQUEsRUFDNUI7QUFBQSxFQUVtQixlQUF3QjtBQUN6QyxXQUFPLEtBQUssYUFBYTtBQUFBLEVBQzNCO0FBQ0Y7QUFLQSxNQUFNLDBCQUEwQixjQUFjO0FBQUEsRUFDckMsWUFBNkIsZUFBd0I7QUFDMUQsVUFBTTtBQUQ0QjtBQUFBLEVBRXBDO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFLZ0IsT0FBYTtBQUMzQiwrQkFBUSxLQUFLLEtBQUssZ0JBQWdCLElBQUksQ0FBQztBQUFBLEVBQ3pDO0FBQUEsRUFFbUIsZUFBd0I7QUFDekMsV0FBTyxLQUFLO0FBQUEsRUFDZDtBQUNGO0FBU08sU0FBUyxjQUFjLE1BQXdCO0FBQ3BELFNBQU8sS0FDSixJQUFJLENBQUMsUUFBUTtBQUNaLFFBQUksVUFBVSxLQUFLLEdBQUcsR0FBRztBQUN2QixVQUFJLGFBQWE7QUFDakIsdUJBQWEsMEJBQVcsWUFBWSxNQUFNLEtBQUs7QUFDL0MsdUJBQWEsMEJBQVcsWUFBWSxPQUFPLEtBQUs7QUFDaEQsYUFBTyxJQUFJLFVBQVU7QUFBQSxJQUN2QjtBQUNBLFdBQU87QUFBQSxFQUNULENBQUMsRUFDQSxLQUFLLEdBQUc7QUFDYjtBQVNBLGVBQXNCLFlBQVksUUFBaUU7QUFDakcsMkNBQXVCO0FBQ3ZCLFFBQU0sU0FBUyxNQUFNLFdBQVcsTUFBTTtBQUN0QyxTQUFPLEtBQUs7QUFDZDtBQVVBLGVBQWUsV0FBVyxRQUEwRTtBQUNsRyxNQUFJO0FBQ0YsV0FBTyxNQUFNLE9BQU8sS0FBa0MsY0FBYyxRQUFRO0FBQUEsRUFDOUUsU0FBUyxPQUFPO0FBQ2QsaUNBQVcsSUFBSSxNQUFNLDJDQUEyQyxFQUFFLE9BQU8sTUFBTSxDQUFDLENBQUM7QUFDakYsV0FBTyxjQUFjLFFBQVE7QUFBQSxFQUMvQjtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/{scripts/CliUtils.d.ts → ScriptUtils/CliUtils.d.cts}

@@ -3,7 +3,7 @@
  * Contains utility classes and functions for managing task results, including
  * success, exit codes, and chaining multiple tasks.
  */
-import type { MaybePromise } from '../Async.ts';
+import type { MaybePromise } from '../Async.cjs';
 /**
  * Abstract class representing the result of a task. Includes methods for handling success,
  * exit codes, and chaining tasks.

package/dist/lib/ScriptUtils/CliUtils.d.mts

@@ -0,0 +1,70 @@
+/**
+ * @packageDocumentation cli
+ * Contains utility classes and functions for managing task results, including
+ * success, exit codes, and chaining multiple tasks.
+ */
+import type { MaybePromise } from '../Async.mjs';
+/**
+ * Abstract class representing the result of a task. Includes methods for handling success,
+ * exit codes, and chaining tasks.
+ */
+export declare abstract class CliTaskResult {
+    /**
+     * Chains multiple tasks together, executing them sequentially until one fails.
+     *
+     * @param tasks - An array of task functions that return a `TaskResult` or `void`.
+     * @returns A promise that resolves with the first failed `TaskResult` or a success result.
+     */
+    static chain(tasks: (() => MaybePromise<CliTaskResult | void>)[]): Promise<CliTaskResult>;
+    /**
+     * Creates a `TaskResult` that does not exit the process.
+     *
+     * @returns A `TaskResult` that does not exit the process.
+     */
+    static DoNotExit(): CliTaskResult;
+    /**
+     * Represents a failure result of a CLI task.
+     *
+     * @returns The failure result.
+     */
+    static Failure(): CliTaskResult;
+    /**
+     * Creates a `TaskResult` based on an exit code.
+     *
+     * @param exitCode - The exit code to represent.
+     * @returns A `TaskResult` representing the exit code.
+     */
+    static FromExitCode(exitCode: number): CliTaskResult;
+    /**
+     * Creates a CliTaskResult representing a successful task result.
+     *
+     * @param isSuccess - A boolean indicating whether the task was successful. Default is true.
+     * @returns A CliTaskResult object representing a successful task result.
+     */
+    static Success(isSuccess?: boolean): CliTaskResult;
+    /**
+     * Exits the process based on the task result.
+     */
+    abstract exit(): void;
+    /**
+     * Determines if the task was successful.
+     *
+     * @returns `true` if the task was successful, otherwise `false`.
+     */
+    protected abstract isSuccessful(): boolean;
+}
+/**
+ * Converts an array of command-line arguments into a single command-line string.
+ * Handles escaping of special characters such as spaces, quotes, and newlines.
+ *
+ * @param args - The array of command-line arguments to convert.
+ * @returns A string representing the command-line invocation.
+ */
+export declare function toCommandLine(args: string[]): string;
+/**
+ * Wraps a CLI task function to ensure it runs safely and handles its `TaskResult`.
+ *
+ * @param taskFn - The task function to execute, which may return a `TaskResult` or void.
+ * @returns A promise that resolves when the task is completed and exits with the appropriate status.
+ */
+export declare function wrapCliTask(taskFn: () => MaybePromise<CliTaskResult | void>): Promise<void>;