@mnaoumov/typescript-dev-toolkit 0.0.0 → 1.0.0

package/dist/lib/esm/cli-utils.d.mts

@@ -0,0 +1,123 @@
+/// <reference path="./index.d.mts" />
+/**
+ * @file
+ *
+ * Contains utility classes and functions for managing task results, including
+ * success, exit codes, and chaining multiple tasks.
+ */
+import type { MaybeReturn } from '@mnaoumov/typescript-lib/type';
+import type { Promisable } from 'type-fest';
+/**
+ * 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 {@link CliTaskResult} or `void`.
+     * @returns A {@link Promise} that resolves with the first failed {@link CliTaskResult} or a success result.
+     */
+    static chain(tasks: (() => Promisable<MaybeReturn<CliTaskResult>>)[]): Promise<CliTaskResult>;
+    /**
+     * Creates a {@link CliTaskResult} that does not exit the process.
+     *
+     * @returns A {@link CliTaskResult} that does not exit the process.
+     */
+    static DoNotExit(): CliTaskResult;
+    /**
+     * A failure result of a CLI task.
+     *
+     * @returns The failure result.
+     */
+    static Failure(): CliTaskResult;
+    /**
+     * Creates a {@link CliTaskResult} based on an exit code.
+     *
+     * @param exitCode - The exit code to represent.
+     * @returns A {@link CliTaskResult} 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;
+    /**
+     * Throws an error if the task was not successful.
+     */
+    throwOnFailure(): 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
+ * using the `CommandLineToArgvW` convention (the standard used by the
+ * Microsoft C runtime and most Windows programs).
+ *
+ * Implements the ArgvQuote algorithm from
+ * {@link https://learn.microsoft.com/archive/blogs/twistylittlepassagesallalike/everyone-quotes-command-line-arguments-the-wrong-way | Everyone quotes command line arguments the wrong way}:
+ * backslashes before quotes and at the end of a quoted argument are doubled.
+ *
+ * This produces a shell-agnostic command line. Callers that route through
+ * a specific shell (cmd.exe, PowerShell, sh) must apply shell-specific
+ * escaping on top — see {@link cmdEscapeCommandLine}.
+ *
+ * @param $arguments - The array of command-line arguments to convert.
+ * @returns A string representing the command-line invocation.
+ */
+export declare function toCommandLine($arguments: string[]): string;
+/**
+ * Converts an array of command-line arguments into a single command-line string
+ * quoted for a POSIX shell (`sh`, `bash`, `zsh`, ...).
+ *
+ * Each argument is wrapped in single quotes unless it consists solely of
+ * characters that are safe unquoted, mirroring Python's `shlex.quote`. A literal
+ * single quote inside an argument is emitted as the `'\''` idiom (close the
+ * quoted span, add an escaped literal quote, reopen), so the shell reproduces the
+ * argument verbatim — no variable expansion (`$`), command substitution
+ * (`` ` ``), globbing (`*`, `?`, `[`), or word splitting.
+ *
+ * Use this on platforms where the command is executed through `sh -c`. On
+ * Windows, use {@link toCommandLine} plus {@link cmdEscapeCommandLine} instead —
+ * the two conventions are not interchangeable.
+ *
+ * @param $arguments - The array of command-line arguments to convert.
+ * @returns A string representing the command-line invocation for a POSIX shell.
+ */
+export declare function toPosixCommandLine($arguments: string[]): string;
+/**
+ * Escapes `cmd.exe` metacharacters with `^` so that `cmd.exe` passes them
+ * through literally. This is necessary because `cmd.exe`'s `"` handling
+ * differs from `CommandLineToArgvW` and cannot be relied upon.
+ *
+ * Apply this to a command line string that will be executed via `cmd.exe`
+ * (e.g., `spawn(cmd, [], { shell: true })` on Windows).
+ *
+ * @param commandLine - The already-quoted command line string.
+ * @returns The string with all cmd metacharacters `^`-escaped.
+ */
+export declare function cmdEscapeCommandLine(commandLine: string): string;
+/**
+ * Wraps a CLI task function to ensure it runs safely and handles its {@link CliTaskResult}.
+ *
+ * Honors the per-script off switch first: when the npm script currently running has been switched off —
+ * `LINT_MD=0 npm run lint:md`, see {@link getDisabledScriptEnvVariableName} — the task is not executed and
+ * the process exits successfully. Because every `scripts/*.ts` entry point already funnels through here, no
+ * script has to opt in, and each `npm run` sub-step of a composite script (e.g. `build`) carries its own
+ * switch.
+ *
+ * @param taskFunction - The task function to execute, which may return a {@link CliTaskResult} or `void`.
+ * @returns A {@link Promise} that resolves when the task is completed and exits with the appropriate status.
+ */
+export declare function wrapCliTask(taskFunction: () => Promisable<MaybeReturn<CliTaskResult>>): Promise<void>;

package/dist/lib/esm/cli-utils.mjs

@@ -0,0 +1,225 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import { enableLibraryDebuggers } from "@mnaoumov/typescript-lib/debug";
+import { printError } from "@mnaoumov/typescript-lib/error";
+import { noop } from "@mnaoumov/typescript-lib/function";
+import { replaceAll } from "@mnaoumov/typescript-lib/string";
+import process from "node:process";
+import { getDisabledScriptEnvVariableName } from "./env-toggle.mjs";
+class CliTaskResult {
+  /**
+   * Chains multiple tasks together, executing them sequentially until one fails.
+   *
+   * @param tasks - An array of task functions that return a {@link CliTaskResult} or `void`.
+   * @returns A {@link Promise} that resolves with the first failed {@link CliTaskResult} or a success result.
+   */
+  static async chain(tasks) {
+    for (const task of tasks) {
+      const result = await wrapResult(task);
+      if (!result.isSuccessful()) {
+        return result;
+      }
+    }
+    return this.Success();
+  }
+  /**
+   * Creates a {@link CliTaskResult} that does not exit the process.
+   *
+   * @returns A {@link CliTaskResult} that does not exit the process.
+   */
+  static DoNotExit() {
+    return new DoNotExitTaskResult();
+  }
+  /**
+   * A failure result of a CLI task.
+   *
+   * @returns The failure result.
+   */
+  static Failure() {
+    return this.Success(false);
+  }
+  /**
+   * Creates a {@link CliTaskResult} based on an exit code.
+   *
+   * @param exitCode - The exit code to represent.
+   * @returns A {@link CliTaskResult} 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);
+  }
+  /**
+   * Throws an error if the task was not successful.
+   */
+  throwOnFailure() {
+    if (!this.isSuccessful()) {
+      throw new Error("Task failed");
+    }
+  }
+}
+class DoNotExitTaskResult extends CliTaskResult {
+  /**
+   * Does not exit the process.
+   */
+  exit() {
+    noop();
+  }
+  isSuccessful() {
+    return true;
+  }
+}
+class ExitCodeTaskResult extends CliTaskResult {
+  constructor(exitCode) {
+    super();
+    this.exitCode = exitCode;
+  }
+  exitCode;
+  /**
+   * Exits the process with the specified exit code.
+   */
+  exit() {
+    process.exit(this.exitCode);
+  }
+  isSuccessful() {
+    return this.exitCode === 0;
+  }
+}
+class SuccessTaskResult extends CliTaskResult {
+  constructor(_isSuccessful) {
+    super();
+    this._isSuccessful = _isSuccessful;
+  }
+  _isSuccessful;
+  /**
+   * Exits the process based on the success of the task.
+   */
+  exit() {
+    process.exit(this._isSuccessful ? 0 : 1);
+  }
+  isSuccessful() {
+    return this._isSuccessful;
+  }
+}
+function toCommandLine($arguments) {
+  return $arguments.map((argument) => argvQuote(argument)).join(" ");
+}
+function toPosixCommandLine($arguments) {
+  return $arguments.map((argument) => posixQuote(argument)).join(" ");
+}
+const POSIX_SAFE_ARG_RE = /^[\w@%+=:,./-]+$/;
+const SINGLE_QUOTE_RE = /'/g;
+const POSIX_ESCAPED_SINGLE_QUOTE = String.raw`'\''`;
+function argvQuote(argument) {
+  if (argument.length > 0 && !/[\s\t\n\v"]/.test(argument)) {
+    return argument;
+  }
+  const BACKSLASH_ESCAPE_FACTOR = 2;
+  let result = '"';
+  for (let index = 0; index < argument.length; index++) {
+    let numberBackslashes = 0;
+    while (index < argument.length && argument[index] === "\\") {
+      index++;
+      numberBackslashes++;
+    }
+    if (index === argument.length) {
+      result += "\\".repeat(numberBackslashes * BACKSLASH_ESCAPE_FACTOR);
+      break;
+    }
+    const ch = argument.charAt(index);
+    result += ch === '"' ? `${"\\".repeat(numberBackslashes * BACKSLASH_ESCAPE_FACTOR + 1)}"` : "\\".repeat(numberBackslashes) + ch;
+  }
+  result += '"';
+  return result;
+}
+function posixQuote(argument) {
+  return POSIX_SAFE_ARG_RE.test(argument) ? argument : `'${replaceAll({ $string: argument, replacer: POSIX_ESCAPED_SINGLE_QUOTE, searchValue: SINGLE_QUOTE_RE })}'`;
+}
+const CMD_META_RE = /[()%!^"<>&|]/g;
+function cmdEscapeCommandLine(commandLine) {
+  return replaceAll({
+    $string: commandLine,
+    replacer: "^$&",
+    searchValue: CMD_META_RE
+  });
+}
+async function wrapCliTask(taskFunction) {
+  const disabledScriptEnvVariableName = getDisabledScriptEnvVariableName();
+  if (disabledScriptEnvVariableName !== null) {
+    process.stdout.write(`Skipped (${disabledScriptEnvVariableName} is off).
+`);
+    CliTaskResult.Success().exit();
+    return;
+  }
+  enableLibraryDebuggers();
+  const result = await wrapResult(taskFunction);
+  result.exit();
+}
+async function wrapResult(taskFunction) {
+  try {
+    return await taskFunction() ?? CliTaskResult.Success();
+  } catch (error) {
+    printError(new Error("An error occurred during task execution", { cause: error }));
+    return CliTaskResult.Failure();
+  }
+}
+export {
+  CliTaskResult,
+  cmdEscapeCommandLine,
+  toCommandLine,
+  toPosixCommandLine,
+  wrapCliTask
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2NsaS11dGlscy50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbnRhaW5zIHV0aWxpdHkgY2xhc3NlcyBhbmQgZnVuY3Rpb25zIGZvciBtYW5hZ2luZyB0YXNrIHJlc3VsdHMsIGluY2x1ZGluZ1xuICogc3VjY2VzcywgZXhpdCBjb2RlcywgYW5kIGNoYWluaW5nIG11bHRpcGxlIHRhc2tzLlxuICovXG5cbmltcG9ydCB0eXBlIHsgTWF5YmVSZXR1cm4gfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvdHlwZSc7XG5pbXBvcnQgdHlwZSB7IFByb21pc2FibGUgfSBmcm9tICd0eXBlLWZlc3QnO1xuXG5pbXBvcnQgeyBlbmFibGVMaWJyYXJ5RGVidWdnZXJzIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL2RlYnVnJztcbmltcG9ydCB7IHByaW50RXJyb3IgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvZXJyb3InO1xuaW1wb3J0IHsgbm9vcCB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9mdW5jdGlvbic7XG5pbXBvcnQgeyByZXBsYWNlQWxsIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL3N0cmluZyc7XG5pbXBvcnQgcHJvY2VzcyBmcm9tICdub2RlOnByb2Nlc3MnO1xuXG5pbXBvcnQgeyBnZXREaXNhYmxlZFNjcmlwdEVudlZhcmlhYmxlTmFtZSB9IGZyb20gJy4vZW52LXRvZ2dsZS50cyc7XG5cbi8qKlxuICogQWJzdHJhY3QgY2xhc3MgcmVwcmVzZW50aW5nIHRoZSByZXN1bHQgb2YgYSB0YXNrLiBJbmNsdWRlcyBtZXRob2RzIGZvciBoYW5kbGluZyBzdWNjZXNzLFxuICogZXhpdCBjb2RlcywgYW5kIGNoYWluaW5nIHRhc2tzLlxuICovXG5leHBvcnQgYWJzdHJhY3QgY2xhc3MgQ2xpVGFza1Jlc3VsdCB7XG4gIC8qKlxuICAgKiBDaGFpbnMgbXVsdGlwbGUgdGFza3MgdG9nZXRoZXIsIGV4ZWN1dGluZyB0aGVtIHNlcXVlbnRpYWxseSB1bnRpbCBvbmUgZmFpbHMuXG4gICAqXG4gICAqIEBwYXJhbSB0YXNrcyAtIEFuIGFycmF5IG9mIHRhc2sgZnVuY3Rpb25zIHRoYXQgcmV0dXJuIGEge0BsaW5rIENsaVRhc2tSZXN1bHR9IG9yIGB2b2lkYC5cbiAgICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyB3aXRoIHRoZSBmaXJzdCBmYWlsZWQge0BsaW5rIENsaVRhc2tSZXN1bHR9IG9yIGEgc3VjY2VzcyByZXN1bHQuXG4gICAqL1xuICBwdWJsaWMgc3RhdGljIGFzeW5jIGNoYWluKHRhc2tzOiAoKCkgPT4gUHJvbWlzYWJsZTxNYXliZVJldHVybjxDbGlUYXNrUmVzdWx0Pj4pW10pOiBQcm9taXNlPENsaVRhc2tSZXN1bHQ+IHtcbiAgICBmb3IgKGNvbnN0IHRhc2sgb2YgdGFza3MpIHtcbiAgICAgIGNvbnN0IHJlc3VsdCA9IGF3YWl0IHdyYXBSZXN1bHQodGFzayk7XG4gICAgICBpZiAoIXJlc3VsdC5pc1N1Y2Nlc3NmdWwoKSkge1xuICAgICAgICByZXR1cm4gcmVzdWx0O1xuICAgICAgfVxuICAgIH1cblxuICAgIHJldHVybiB0aGlzLlN1Y2Nlc3MoKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGEge0BsaW5rIENsaVRhc2tSZXN1bHR9IHRoYXQgZG9lcyBub3QgZXhpdCB0aGUgcHJvY2Vzcy5cbiAgICpcbiAgICogQHJldHVybnMgQSB7QGxpbmsgQ2xpVGFza1Jlc3VsdH0gdGhhdCBkb2VzIG5vdCBleGl0IHRoZSBwcm9jZXNzLlxuICAgKi9cbiAgcHVibGljIHN0YXRpYyBEb05vdEV4aXQoKTogQ2xpVGFza1Jlc3VsdCB7XG4gICAgcmV0dXJuIG5ldyBEb05vdEV4aXRUYXNrUmVzdWx0KCk7XG4gIH1cblxuICAvKipcbiAgICogQSBmYWlsdXJlIHJlc3VsdCBvZiBhIENMSSB0YXNrLlxuICAgKlxuICAgKiBAcmV0dXJucyBUaGUgZmFpbHVyZSByZXN1bHQuXG4gICAqL1xuICBwdWJsaWMgc3RhdGljIEZhaWx1cmUoKTogQ2xpVGFza1Jlc3VsdCB7XG4gICAgcmV0dXJuIHRoaXMuU3VjY2VzcyhmYWxzZSk7XG4gIH1cblxuICAvKipcbiAgICogQ3JlYXRlcyBhIHtAbGluayBDbGlUYXNrUmVzdWx0fSBiYXNlZCBvbiBhbiBleGl0IGNvZGUuXG4gICAqXG4gICAqIEBwYXJhbSBleGl0Q29kZSAtIFRoZSBleGl0IGNvZGUgdG8gcmVwcmVzZW50LlxuICAgKiBAcmV0dXJucyBBIHtAbGluayBDbGlUYXNrUmVzdWx0fSByZXByZXNlbnRpbmcgdGhlIGV4aXQgY29kZS5cbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgRnJvbUV4aXRDb2RlKGV4aXRDb2RlOiBudW1iZXIpOiBDbGlUYXNrUmVzdWx0IHtcbiAgICByZXR1cm4gbmV3IEV4aXRDb2RlVGFza1Jlc3VsdChleGl0Q29kZSk7XG4gIH1cblxuICAvKipcbiAgICogQ3JlYXRlcyBhIENsaVRhc2tSZXN1bHQgcmVwcmVzZW50aW5nIGEgc3VjY2Vzc2Z1bCB0YXNrIHJlc3VsdC5cbiAgICpcbiAgICogQHBhcmFtIGlzU3VjY2VzcyAtIEEgYm9vbGVhbiBpbmRpY2F0aW5nIHdoZXRoZXIgdGhlIHRhc2sgd2FzIHN1Y2Nlc3NmdWwuIERlZmF1bHQgaXMgYHRydWVgLlxuICAgKiBAcmV0dXJucyBBIENsaVRhc2tSZXN1bHQgb2JqZWN0IHJlcHJlc2VudGluZyBhIHN1Y2Nlc3NmdWwgdGFzayByZXN1bHQuXG4gICAqL1xuICBwdWJsaWMgc3RhdGljIFN1Y2Nlc3MoaXNTdWNjZXNzID0gdHJ1ZSk6IENsaVRhc2tSZXN1bHQge1xuICAgIHJldHVybiBuZXcgU3VjY2Vzc1Rhc2tSZXN1bHQoaXNTdWNjZXNzKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBFeGl0cyB0aGUgcHJvY2VzcyBiYXNlZCBvbiB0aGUgdGFzayByZXN1bHQuXG4gICAqL1xuICBwdWJsaWMgYWJzdHJhY3QgZXhpdCgpOiB2b2lkO1xuXG4gIC8qKlxuICAgKiBUaHJvd3MgYW4gZXJyb3IgaWYgdGhlIHRhc2sgd2FzIG5vdCBzdWNjZXNzZnVsLlxuICAgKi9cbiAgcHVibGljIHRocm93T25GYWlsdXJlKCk6IHZvaWQge1xuICAgIGlmICghdGhpcy5pc1N1Y2Nlc3NmdWwoKSkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKCdUYXNrIGZhaWxlZCcpO1xuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBEZXRlcm1pbmVzIGlmIHRoZSB0YXNrIHdhcyBzdWNjZXNzZnVsLlxuICAgKlxuICAgKiBAcmV0dXJucyBgdHJ1ZWAgaWYgdGhlIHRhc2sgd2FzIHN1Y2Nlc3NmdWwsIG90aGVyd2lzZSBgZmFsc2VgLlxuICAgKi9cbiAgcHJvdGVjdGVkIGFic3RyYWN0IGlzU3VjY2Vzc2Z1bCgpOiBib29sZWFuO1xufVxuXG4vKipcbiAqIEEgdGFzayByZXN1bHQgdGhhdCBkb2VzIG5vdCBleGl0IHRoZSBwcm9jZXNzLlxuICovXG5jbGFzcyBEb05vdEV4aXRUYXNrUmVzdWx0IGV4dGVuZHMgQ2xpVGFza1Jlc3VsdCB7XG4gIC8qKlxuICAgKiBEb2VzIG5vdCBleGl0IHRoZSBwcm9jZXNzLlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIGV4aXQoKTogdm9pZCB7XG4gICAgbm9vcCgpO1xuICB9XG5cbiAgcHJvdGVjdGVkIG92ZXJyaWRlIGlzU3VjY2Vzc2Z1bCgpOiBib29sZWFuIHtcbiAgICByZXR1cm4gdHJ1ZTtcbiAgfVxufVxuXG4vKipcbiAqIEEgdGFzayByZXN1bHQgYmFzZWQgb24gYW4gZXhpdCBjb2RlLlxuICovXG5jbGFzcyBFeGl0Q29kZVRhc2tSZXN1bHQgZXh0ZW5kcyBDbGlUYXNrUmVzdWx0IHtcbiAgcHVibGljIGNvbnN0cnVjdG9yKHByaXZhdGUgcmVhZG9ubHkgZXhpdENvZGU6IG51bWJlcikge1xuICAgIHN1cGVyKCk7XG4gIH1cblxuICAvKipcbiAgICogRXhpdHMgdGhlIHByb2Nlc3Mgd2l0aCB0aGUgc3BlY2lmaWVkIGV4aXQgY29kZS5cbiAgICovXG4gIHB1YmxpYyBvdmVycmlkZSBleGl0KCk6IHZvaWQge1xuICAgIHByb2Nlc3MuZXhpdCh0aGlzLmV4aXRDb2RlKTtcbiAgfVxuXG4gIHByb3RlY3RlZCBvdmVycmlkZSBpc1N1Y2Nlc3NmdWwoKTogYm9vbGVhbiB7XG4gICAgcmV0dXJuIHRoaXMuZXhpdENvZGUgPT09IDA7XG4gIH1cbn1cblxuLyoqXG4gKiBBIHRhc2sgcmVzdWx0IGJhc2VkIG9uIHN1Y2Nlc3Mgb3IgZmFpbHVyZS5cbiAqL1xuY2xhc3MgU3VjY2Vzc1Rhc2tSZXN1bHQgZXh0ZW5kcyBDbGlUYXNrUmVzdWx0IHtcbiAgcHVibGljIGNvbnN0cnVjdG9yKHByaXZhdGUgcmVhZG9ubHkgX2lzU3VjY2Vzc2Z1bDogYm9vbGVhbikge1xuICAgIHN1cGVyKCk7XG4gIH1cblxuICAvKipcbiAgICogRXhpdHMgdGhlIHByb2Nlc3MgYmFzZWQgb24gdGhlIHN1Y2Nlc3Mgb2YgdGhlIHRhc2suXG4gICAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgZXhpdCgpOiB2b2lkIHtcbiAgICBwcm9jZXNzLmV4aXQodGhpcy5faXNTdWNjZXNzZnVsID8gMCA6IDEpO1xuICB9XG5cbiAgcHJvdGVjdGVkIG92ZXJyaWRlIGlzU3VjY2Vzc2Z1bCgpOiBib29sZWFuIHtcbiAgICByZXR1cm4gdGhpcy5faXNTdWNjZXNzZnVsO1xuICB9XG59XG5cbi8qKlxuICogQ29udmVydHMgYW4gYXJyYXkgb2YgY29tbWFuZC1saW5lIGFyZ3VtZW50cyBpbnRvIGEgc2luZ2xlIGNvbW1hbmQtbGluZSBzdHJpbmdcbiAqIHVzaW5nIHRoZSBgQ29tbWFuZExpbmVUb0FyZ3ZXYCBjb252ZW50aW9uICh0aGUgc3RhbmRhcmQgdXNlZCBieSB0aGVcbiAqIE1pY3Jvc29mdCBDIHJ1bnRpbWUgYW5kIG1vc3QgV2luZG93cyBwcm9ncmFtcykuXG4gKlxuICogSW1wbGVtZW50cyB0aGUgQXJndlF1b3RlIGFsZ29yaXRobSBmcm9tXG4gKiB7QGxpbmsgaHR0cHM6Ly9sZWFybi5taWNyb3NvZnQuY29tL2FyY2hpdmUvYmxvZ3MvdHdpc3R5bGl0dGxlcGFzc2FnZXNhbGxhbGlrZS9ldmVyeW9uZS1xdW90ZXMtY29tbWFuZC1saW5lLWFyZ3VtZW50cy10aGUtd3Jvbmctd2F5IHwgRXZlcnlvbmUgcXVvdGVzIGNvbW1hbmQgbGluZSBhcmd1bWVudHMgdGhlIHdyb25nIHdheX06XG4gKiBiYWNrc2xhc2hlcyBiZWZvcmUgcXVvdGVzIGFuZCBhdCB0aGUgZW5kIG9mIGEgcXVvdGVkIGFyZ3VtZW50IGFyZSBkb3VibGVkLlxuICpcbiAqIFRoaXMgcHJvZHVjZXMgYSBzaGVsbC1hZ25vc3RpYyBjb21tYW5kIGxpbmUuIENhbGxlcnMgdGhhdCByb3V0ZSB0aHJvdWdoXG4gKiBhIHNwZWNpZmljIHNoZWxsIChjbWQuZXhlLCBQb3dlclNoZWxsLCBzaCkgbXVzdCBhcHBseSBzaGVsbC1zcGVjaWZpY1xuICogZXNjYXBpbmcgb24gdG9wIFx1MjAxNCBzZWUge0BsaW5rIGNtZEVzY2FwZUNvbW1hbmRMaW5lfS5cbiAqXG4gKiBAcGFyYW0gJGFyZ3VtZW50cyAtIFRoZSBhcnJheSBvZiBjb21tYW5kLWxpbmUgYXJndW1lbnRzIHRvIGNvbnZlcnQuXG4gKiBAcmV0dXJucyBBIHN0cmluZyByZXByZXNlbnRpbmcgdGhlIGNvbW1hbmQtbGluZSBpbnZvY2F0aW9uLlxuICovXG5leHBvcnQgZnVuY3Rpb24gdG9Db21tYW5kTGluZSgkYXJndW1lbnRzOiBzdHJpbmdbXSk6IHN0cmluZyB7XG4gIHJldHVybiAkYXJndW1lbnRzLm1hcCgoYXJndW1lbnQpID0+IGFyZ3ZRdW90ZShhcmd1bWVudCkpLmpvaW4oJyAnKTtcbn1cblxuLyoqXG4gKiBDb252ZXJ0cyBhbiBhcnJheSBvZiBjb21tYW5kLWxpbmUgYXJndW1lbnRzIGludG8gYSBzaW5nbGUgY29tbWFuZC1saW5lIHN0cmluZ1xuICogcXVvdGVkIGZvciBhIFBPU0lYIHNoZWxsIChgc2hgLCBgYmFzaGAsIGB6c2hgLCAuLi4pLlxuICpcbiAqIEVhY2ggYXJndW1lbnQgaXMgd3JhcHBlZCBpbiBzaW5nbGUgcXVvdGVzIHVubGVzcyBpdCBjb25zaXN0cyBzb2xlbHkgb2ZcbiAqIGNoYXJhY3RlcnMgdGhhdCBhcmUgc2FmZSB1bnF1b3RlZCwgbWlycm9yaW5nIFB5dGhvbidzIGBzaGxleC5xdW90ZWAuIEEgbGl0ZXJhbFxuICogc2luZ2xlIHF1b3RlIGluc2lkZSBhbiBhcmd1bWVudCBpcyBlbWl0dGVkIGFzIHRoZSBgJ1xcJydgIGlkaW9tIChjbG9zZSB0aGVcbiAqIHF1b3RlZCBzcGFuLCBhZGQgYW4gZXNjYXBlZCBsaXRlcmFsIHF1b3RlLCByZW9wZW4pLCBzbyB0aGUgc2hlbGwgcmVwcm9kdWNlcyB0aGVcbiAqIGFyZ3VtZW50IHZlcmJhdGltIFx1MjAxNCBubyB2YXJpYWJsZSBleHBhbnNpb24gKGAkYCksIGNvbW1hbmQgc3Vic3RpdHV0aW9uXG4gKiAoYGAgYCBgYCksIGdsb2JiaW5nIChgKmAsIGA/YCwgYFtgKSwgb3Igd29yZCBzcGxpdHRpbmcuXG4gKlxuICogVXNlIHRoaXMgb24gcGxhdGZvcm1zIHdoZXJlIHRoZSBjb21tYW5kIGlzIGV4ZWN1dGVkIHRocm91Z2ggYHNoIC1jYC4gT25cbiAqIFdpbmRvd3MsIHVzZSB7QGxpbmsgdG9Db21tYW5kTGluZX0gcGx1cyB7QGxpbmsgY21kRXNjYXBlQ29tbWFuZExpbmV9IGluc3RlYWQgXHUyMDE0XG4gKiB0aGUgdHdvIGNvbnZlbnRpb25zIGFyZSBub3QgaW50ZXJjaGFuZ2VhYmxlLlxuICpcbiAqIEBwYXJhbSAkYXJndW1lbnRzIC0gVGhlIGFycmF5IG9mIGNvbW1hbmQtbGluZSBhcmd1bWVudHMgdG8gY29udmVydC5cbiAqIEByZXR1cm5zIEEgc3RyaW5nIHJlcHJlc2VudGluZyB0aGUgY29tbWFuZC1saW5lIGludm9jYXRpb24gZm9yIGEgUE9TSVggc2hlbGwuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB0b1Bvc2l4Q29tbWFuZExpbmUoJGFyZ3VtZW50czogc3RyaW5nW10pOiBzdHJpbmcge1xuICByZXR1cm4gJGFyZ3VtZW50cy5tYXAoKGFyZ3VtZW50KSA9PiBwb3NpeFF1b3RlKGFyZ3VtZW50KSkuam9pbignICcpO1xufVxuXG4vKipcbiAqIE1hdGNoZXMgYW4gYXJndW1lbnQgdGhhdCBpcyBlbnRpcmVseSBjb21wb3NlZCBvZiBjaGFyYWN0ZXJzIHNhZmUgdG8gcGFzcyB0byBhXG4gKiBQT1NJWCBzaGVsbCB1bnF1b3RlZC4gTWlycm9ycyB0aGUgc2FmZSBzZXQgdXNlZCBieSBQeXRob24ncyBgc2hsZXgucXVvdGVgLlxuICovXG5jb25zdCBQT1NJWF9TQUZFX0FSR19SRSA9IC9eW1xcd0AlKz06LC4vLV0rJC87XG5cbi8qKlxuICogTWF0Y2hlcyBhIGxpdGVyYWwgc2luZ2xlIHF1b3RlLCBmb3IgcmVwbGFjaW5nIGl0IHdpdGggdGhlIGAnXFwnJ2AgaWRpb20uXG4gKi9cbmNvbnN0IFNJTkdMRV9RVU9URV9SRSA9IC8nL2c7XG5cbi8qKlxuICogVGhlIHJlcGxhY2VtZW50IGZvciBhIGxpdGVyYWwgc2luZ2xlIHF1b3RlIGluc2lkZSBhIHNpbmdsZS1xdW90ZWQgUE9TSVggc3BhbjpcbiAqIGNsb3NlIHRoZSBzcGFuLCBhZGQgYW4gZXNjYXBlZCBsaXRlcmFsIHF1b3RlLCByZW9wZW4gdGhlIHNwYW4uXG4gKi9cbmNvbnN0IFBPU0lYX0VTQ0FQRURfU0lOR0xFX1FVT1RFID0gU3RyaW5nLnJhd2AnXFwnJ2A7XG5cbi8qKlxuICogUXVvdGVzIGEgc2luZ2xlIGFyZ3VtZW50IHNvIHRoYXQgYENvbW1hbmRMaW5lVG9Bcmd2V2Agd2lsbCBkZWNvZGUgaXRcbiAqIHVuY2hhbmdlZC4gSW1wbGVtZW50cyB0aGUgQXJndlF1b3RlIGFsZ29yaXRobSBmcm9tXG4gKiB7QGxpbmsgaHR0cHM6Ly9sZWFybi5taWNyb3NvZnQuY29tL2FyY2hpdmUvYmxvZ3MvdHdpc3R5bGl0dGxlcGFzc2FnZXNhbGxhbGlrZS9ldmVyeW9uZS1xdW90ZXMtY29tbWFuZC1saW5lLWFyZ3VtZW50cy10aGUtd3Jvbmctd2F5IHwgRXZlcnlvbmUgcXVvdGVzIGNvbW1hbmQgbGluZSBhcmd1bWVudHMgdGhlIHdyb25nIHdheX0uXG4gKlxuICogQHBhcmFtIGFyZ3VtZW50IC0gVGhlIHJhdyBhcmd1bWVudCBzdHJpbmcuXG4gKiBAcmV0dXJucyBUaGUgcXVvdGVkIGFyZ3VtZW50IHN0cmluZy5cbiAqL1xuZnVuY3Rpb24gYXJndlF1b3RlKGFyZ3VtZW50OiBzdHJpbmcpOiBzdHJpbmcge1xuICBpZiAoYXJndW1lbnQubGVuZ3RoID4gMCAmJiAhL1tcXHNcXHRcXG5cXHZcIl0vLnRlc3QoYXJndW1lbnQpKSB7XG4gICAgcmV0dXJuIGFyZ3VtZW50O1xuICB9XG5cbiAgY29uc3QgQkFDS1NMQVNIX0VTQ0FQRV9GQUNUT1IgPSAyO1xuICBsZXQgcmVzdWx0ID0gJ1wiJztcbiAgZm9yIChsZXQgaW5kZXggPSAwOyBpbmRleCA8IGFyZ3VtZW50Lmxlbmd0aDsgaW5kZXgrKykge1xuICAgIGxldCBudW1iZXJCYWNrc2xhc2hlcyA9IDA7XG4gICAgd2hpbGUgKGluZGV4IDwgYXJndW1lbnQubGVuZ3RoICYmIGFyZ3VtZW50W2luZGV4XSA9PT0gJ1xcXFwnKSB7XG4gICAgICBpbmRleCsrO1xuICAgICAgbnVtYmVyQmFja3NsYXNoZXMrKztcbiAgICB9XG5cbiAgICBpZiAoaW5kZXggPT09IGFyZ3VtZW50Lmxlbmd0aCkge1xuICAgICAgcmVzdWx0ICs9ICdcXFxcJy5yZXBlYXQobnVtYmVyQmFja3NsYXNoZXMgKiBCQUNLU0xBU0hfRVNDQVBFX0ZBQ1RPUik7XG4gICAgICBicmVhaztcbiAgICB9XG5cbiAgICBjb25zdCBjaCA9IGFyZ3VtZW50LmNoYXJBdChpbmRleCk7XG4gICAgcmVzdWx0ICs9IGNoID09PSAnXCInID8gYCR7J1xcXFwnLnJlcGVhdChudW1iZXJCYWNrc2xhc2hlcyAqIEJBQ0tTTEFTSF9FU0NBUEVfRkFDVE9SICsgMSl9XCJgIDogJ1xcXFwnLnJlcGVhdChudW1iZXJCYWNrc2xhc2hlcykgKyBjaDtcbiAgfVxuXG4gIHJlc3VsdCArPSAnXCInO1xuICByZXR1cm4gcmVzdWx0O1xufVxuXG4vKipcbiAqIFF1b3RlcyBhIHNpbmdsZSBhcmd1bWVudCBmb3IgYSBQT1NJWCBzaGVsbCBzbyBpdCBpcyBwYXNzZWQgdGhyb3VnaCB2ZXJiYXRpbS5cbiAqIEFuIGVtcHR5IGFyZ3VtZW50IGJlY29tZXMgYCcnYDsgYW4gYXJndW1lbnQgb2Ygb25seSBzYWZlIGNoYXJhY3RlcnMgaXNcbiAqIHJldHVybmVkIHVuY2hhbmdlZDsgYW55dGhpbmcgZWxzZSBpcyBzaW5nbGUtcXVvdGVkLlxuICpcbiAqIEBwYXJhbSBhcmd1bWVudCAtIFRoZSByYXcgYXJndW1lbnQgc3RyaW5nLlxuICogQHJldHVybnMgVGhlIHF1b3RlZCBhcmd1bWVudCBzdHJpbmcuXG4gKi9cbmZ1bmN0aW9uIHBvc2l4UXVvdGUoYXJndW1lbnQ6IHN0cmluZyk6IHN0cmluZyB7XG4gIHJldHVybiBQT1NJWF9TQUZFX0FSR19SRS50ZXN0KGFyZ3VtZW50KSA/IGFyZ3VtZW50IDogYCcke3JlcGxhY2VBbGwoeyAkc3RyaW5nOiBhcmd1bWVudCwgcmVwbGFjZXI6IFBPU0lYX0VTQ0FQRURfU0lOR0xFX1FVT1RFLCBzZWFyY2hWYWx1ZTogU0lOR0xFX1FVT1RFX1JFIH0pfSdgO1xufVxuXG4vKipcbiAqIE1hdGNoZXMgYGNtZC5leGVgIG1ldGFjaGFyYWN0ZXJzIHRoYXQgbXVzdCBiZSBgXmAtZXNjYXBlZC5cbiAqL1xuY29uc3QgQ01EX01FVEFfUkUgPSAvWygpJSFeXCI8PiZ8XS9nO1xuXG4vKipcbiAqIEVzY2FwZXMgYGNtZC5leGVgIG1ldGFjaGFyYWN0ZXJzIHdpdGggYF5gIHNvIHRoYXQgYGNtZC5leGVgIHBhc3NlcyB0aGVtXG4gKiB0aHJvdWdoIGxpdGVyYWxseS4gVGhpcyBpcyBuZWNlc3NhcnkgYmVjYXVzZSBgY21kLmV4ZWAncyBgXCJgIGhhbmRsaW5nXG4gKiBkaWZmZXJzIGZyb20gYENvbW1hbmRMaW5lVG9Bcmd2V2AgYW5kIGNhbm5vdCBiZSByZWxpZWQgdXBvbi5cbiAqXG4gKiBBcHBseSB0aGlzIHRvIGEgY29tbWFuZCBsaW5lIHN0cmluZyB0aGF0IHdpbGwgYmUgZXhlY3V0ZWQgdmlhIGBjbWQuZXhlYFxuICogKGUuZy4sIGBzcGF3bihjbWQsIFtdLCB7IHNoZWxsOiB0cnVlIH0pYCBvbiBXaW5kb3dzKS5cbiAqXG4gKiBAcGFyYW0gY29tbWFuZExpbmUgLSBUaGUgYWxyZWFkeS1xdW90ZWQgY29tbWFuZCBsaW5lIHN0cmluZy5cbiAqIEByZXR1cm5zIFRoZSBzdHJpbmcgd2l0aCBhbGwgY21kIG1ldGFjaGFyYWN0ZXJzIGBeYC1lc2NhcGVkLlxuICovXG4vLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgdW5pY29ybi9uYW1lLXJlcGxhY2VtZW50cyAtLSBgY21kYCBuYW1lcyBXaW5kb3dzIGBjbWQuZXhlYCwgbm90IGFuIGFiYnJldmlhdGlvbiBvZiBgY29tbWFuZGAuXG5leHBvcnQgZnVuY3Rpb24gY21kRXNjYXBlQ29tbWFuZExpbmUoY29tbWFuZExpbmU6IHN0cmluZyk6IHN0cmluZyB7XG4gIHJldHVybiByZXBsYWNlQWxsKHtcbiAgICAkc3RyaW5nOiBjb21tYW5kTGluZSxcbiAgICByZXBsYWNlcjogJ14kJicsXG4gICAgc2VhcmNoVmFsdWU6IENNRF9NRVRBX1JFXG4gIH0pO1xufVxuXG4vKipcbiAqIFdyYXBzIGEgQ0xJIHRhc2sgZnVuY3Rpb24gdG8gZW5zdXJlIGl0IHJ1bnMgc2FmZWx5IGFuZCBoYW5kbGVzIGl0cyB7QGxpbmsgQ2xpVGFza1Jlc3VsdH0uXG4gKlxuICogSG9ub3JzIHRoZSBwZXItc2NyaXB0IG9mZiBzd2l0Y2ggZmlyc3Q6IHdoZW4gdGhlIG5wbSBzY3JpcHQgY3VycmVudGx5IHJ1bm5pbmcgaGFzIGJlZW4gc3dpdGNoZWQgb2ZmIFx1MjAxNFxuICogYExJTlRfTUQ9MCBucG0gcnVuIGxpbnQ6bWRgLCBzZWUge0BsaW5rIGdldERpc2FibGVkU2NyaXB0RW52VmFyaWFibGVOYW1lfSBcdTIwMTQgdGhlIHRhc2sgaXMgbm90IGV4ZWN1dGVkIGFuZFxuICogdGhlIHByb2Nlc3MgZXhpdHMgc3VjY2Vzc2Z1bGx5LiBCZWNhdXNlIGV2ZXJ5IGBzY3JpcHRzLyoudHNgIGVudHJ5IHBvaW50IGFscmVhZHkgZnVubmVscyB0aHJvdWdoIGhlcmUsIG5vXG4gKiBzY3JpcHQgaGFzIHRvIG9wdCBpbiwgYW5kIGVhY2ggYG5wbSBydW5gIHN1Yi1zdGVwIG9mIGEgY29tcG9zaXRlIHNjcmlwdCAoZS5nLiBgYnVpbGRgKSBjYXJyaWVzIGl0cyBvd25cbiAqIHN3aXRjaC5cbiAqXG4gKiBAcGFyYW0gdGFza0Z1bmN0aW9uIC0gVGhlIHRhc2sgZnVuY3Rpb24gdG8gZXhlY3V0ZSwgd2hpY2ggbWF5IHJldHVybiBhIHtAbGluayBDbGlUYXNrUmVzdWx0fSBvciBgdm9pZGAuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdoZW4gdGhlIHRhc2sgaXMgY29tcGxldGVkIGFuZCBleGl0cyB3aXRoIHRoZSBhcHByb3ByaWF0ZSBzdGF0dXMuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiB3cmFwQ2xpVGFzayh0YXNrRnVuY3Rpb246ICgpID0+IFByb21pc2FibGU8TWF5YmVSZXR1cm48Q2xpVGFza1Jlc3VsdD4+KTogUHJvbWlzZTx2b2lkPiB7XG4gIGNvbnN0IGRpc2FibGVkU2NyaXB0RW52VmFyaWFibGVOYW1lID0gZ2V0RGlzYWJsZWRTY3JpcHRFbnZWYXJpYWJsZU5hbWUoKTtcbiAgaWYgKGRpc2FibGVkU2NyaXB0RW52VmFyaWFibGVOYW1lICE9PSBudWxsKSB7XG4gICAgcHJvY2Vzcy5zdGRvdXQud3JpdGUoYFNraXBwZWQgKCR7ZGlzYWJsZWRTY3JpcHRFbnZWYXJpYWJsZU5hbWV9IGlzIG9mZikuXFxuYCk7XG4gICAgQ2xpVGFza1Jlc3VsdC5TdWNjZXNzKCkuZXhpdCgpO1xuICAgIHJldHVybjtcbiAgfVxuXG4gIGVuYWJsZUxpYnJhcnlEZWJ1Z2dlcnMoKTtcbiAgY29uc3QgcmVzdWx0ID0gYXdhaXQgd3JhcFJlc3VsdCh0YXNrRnVuY3Rpb24pO1xuICByZXN1bHQuZXhpdCgpO1xufVxuXG4vKipcbiAqIFNhZmVseSBleGVjdXRlcyBhIHRhc2sgZnVuY3Rpb24gYW5kIHJldHVybnMgYSB7QGxpbmsgQ2xpVGFza1Jlc3VsdH0uIElmIHRoZSB0YXNrIGZ1bmN0aW9uIHRocm93cyBhbiBlcnJvcixcbiAqIEFuIGVycm9yIGlzIGNhdWdodCwgYW5kIGEgZmFpbHVyZSB7QGxpbmsgQ2xpVGFza1Jlc3VsdH0gaXMgcmV0dXJuZWQuXG4gKlxuICogQHBhcmFtIHRhc2tGdW5jdGlvbiAtIFRoZSB0YXNrIGZ1bmN0aW9uIHRvIGV4ZWN1dGUuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdpdGggYSB7QGxpbmsgQ2xpVGFza1Jlc3VsdH0gcmVwcmVzZW50aW5nIHRoZSBvdXRjb21lIG9mIHRoZSB0YXNrLlxuICovXG5hc3luYyBmdW5jdGlvbiB3cmFwUmVzdWx0KHRhc2tGdW5jdGlvbjogKCkgPT4gUHJvbWlzYWJsZTxNYXliZVJldHVybjxDbGlUYXNrUmVzdWx0Pj4pOiBQcm9taXNlPENsaVRhc2tSZXN1bHQ+IHtcbiAgdHJ5IHtcbiAgICByZXR1cm4gKGF3YWl0IHRhc2tGdW5jdGlvbigpKSBhcyBDbGlUYXNrUmVzdWx0IHwgdW5kZWZpbmVkID8/IENsaVRhc2tSZXN1bHQuU3VjY2VzcygpO1xuICB9IGNhdGNoIChlcnJvcikge1xuICAgIHByaW50RXJyb3IobmV3IEVycm9yKCdBbiBlcnJvciBvY2N1cnJlZCBkdXJpbmcgdGFzayBleGVjdXRpb24nLCB7IGNhdXNlOiBlcnJvciB9KSk7XG4gICAgcmV0dXJuIENsaVRhc2tSZXN1bHQuRmFpbHVyZSgpO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7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

package/dist/lib/esm/code-generator.d.mts

@@ -0,0 +1,14 @@
+/// <reference path="./index.d.mts" />
+/**
+ * @file
+ *
+ * Contains utility functions for code generation.
+ */
+/**
+ * Generates a file at the specified path with the provided lines of code.
+ *
+ * @param path - The path where the file will be generated.
+ * @param lines - An array of strings representing the lines of code to be written in the file.
+ * @returns A {@link Promise} that resolves when the file generation is complete.
+ */
+export declare function generate(path: string, lines: string[]): Promise<void>;

package/dist/lib/esm/code-generator.mjs

@@ -0,0 +1,59 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import { writeFile } from "node:fs/promises";
+async function generate(path, lines) {
+  if (lines.at(-1)) {
+    lines.push("");
+  }
+  lines.unshift("/* THIS IS A GENERATED/BUNDLED FILE BY BUILD SCRIPT */", "");
+  await writeFile(path, lines.join("\n"), "utf-8");
+}
+export {
+  generate
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2NvZGUtZ2VuZXJhdG9yLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29udGFpbnMgdXRpbGl0eSBmdW5jdGlvbnMgZm9yIGNvZGUgZ2VuZXJhdGlvbi5cbiAqL1xuXG5pbXBvcnQgeyB3cml0ZUZpbGUgfSBmcm9tICdub2RlOmZzL3Byb21pc2VzJztcblxuLyoqXG4gKiBHZW5lcmF0ZXMgYSBmaWxlIGF0IHRoZSBzcGVjaWZpZWQgcGF0aCB3aXRoIHRoZSBwcm92aWRlZCBsaW5lcyBvZiBjb2RlLlxuICpcbiAqIEBwYXJhbSBwYXRoIC0gVGhlIHBhdGggd2hlcmUgdGhlIGZpbGUgd2lsbCBiZSBnZW5lcmF0ZWQuXG4gKiBAcGFyYW0gbGluZXMgLSBBbiBhcnJheSBvZiBzdHJpbmdzIHJlcHJlc2VudGluZyB0aGUgbGluZXMgb2YgY29kZSB0byBiZSB3cml0dGVuIGluIHRoZSBmaWxlLlxuICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyB3aGVuIHRoZSBmaWxlIGdlbmVyYXRpb24gaXMgY29tcGxldGUuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBnZW5lcmF0ZShwYXRoOiBzdHJpbmcsIGxpbmVzOiBzdHJpbmdbXSk6IFByb21pc2U8dm9pZD4ge1xuICBpZiAobGluZXMuYXQoLTEpKSB7XG4gICAgbGluZXMucHVzaCgnJyk7XG4gIH1cbiAgbGluZXMudW5zaGlmdCgnLyogVEhJUyBJUyBBIEdFTkVSQVRFRC9CVU5ETEVEIEZJTEUgQlkgQlVJTEQgU0NSSVBUICovJywgJycpO1xuICBhd2FpdCB3cml0ZUZpbGUocGF0aCwgbGluZXMuam9pbignXFxuJyksICd1dGYtOCcpO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFNQSxTQUFTLGlCQUFpQjtBQVMxQixlQUFzQixTQUFTLE1BQWMsT0FBZ0M7QUFDM0UsTUFBSSxNQUFNLEdBQUcsRUFBRSxHQUFHO0FBQ2hCLFVBQU0sS0FBSyxFQUFFO0FBQUEsRUFDZjtBQUNBLFFBQU0sUUFBUSwwREFBMEQsRUFBRTtBQUMxRSxRQUFNLFVBQVUsTUFBTSxNQUFNLEtBQUssSUFBSSxHQUFHLE9BQU87QUFDakQ7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/commitlint-config.d.mts

@@ -0,0 +1,14 @@
+/// <reference path="./index.d.mts" />
+/**
+ * @file
+ *
+ * Shared commitlint configuration for Conventional Commits.
+ */
+import type { UserConfig } from '@commitlint/types';
+/**
+ * Commitlint configuration extending `@commitlint/config-conventional`, plus a rule refusing a message whose
+ * header, body or footer matches the unpublished forbidden-patterns list (a no-op when none is configured), and
+ * a rule spellchecking the header the way the release spellchecks the changelog bullet it becomes (a no-op in a
+ * project with no `spellcheck` script).
+ */
+export declare const obsidianDevUtilsConfig: UserConfig;

package/dist/lib/esm/commitlint-config.mjs

@@ -0,0 +1,79 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import { castTo } from "@mnaoumov/typescript-lib/object-utils";
+import {
+  forbiddenPatternsPlugin,
+  NO_FORBIDDEN_PATTERNS_RULE_NAME
+} from "./commitlint-forbidden-patterns.mjs";
+import {
+  SPELLCHECK_HEADER_RULE_NAME,
+  spellcheckHeaderPlugin
+} from "./commitlint-spellcheck-header.mjs";
+const ERROR_SEVERITY_LEVEL = 2;
+const ERROR_SEVERITY = castTo(ERROR_SEVERITY_LEVEL);
+const obsidianDevUtilsConfig = {
+  extends: ["@commitlint/config-conventional"],
+  // ONE plugin object, never two: `@commitlint/load` stores every inline plugin under the same `local` key, so a
+  // second object silently replaces the first and its rule then fails as "Found rules without implementation".
+  plugins: [
+    {
+      rules: {
+        ...forbiddenPatternsPlugin.rules,
+        ...spellcheckHeaderPlugin.rules
+      }
+    }
+  ],
+  rules: {
+    [NO_FORBIDDEN_PATTERNS_RULE_NAME]: [ERROR_SEVERITY, "always"],
+    [SPELLCHECK_HEADER_RULE_NAME]: [ERROR_SEVERITY, "always"]
+  }
+};
+export {
+  obsidianDevUtilsConfig
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2NvbW1pdGxpbnQtY29uZmlnLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogU2hhcmVkIGNvbW1pdGxpbnQgY29uZmlndXJhdGlvbiBmb3IgQ29udmVudGlvbmFsIENvbW1pdHMuXG4gKi9cblxuLyogdjggaWdub3JlIHN0YXJ0IC0tIERlY2xhcmF0aXZlIGNvbW1pdGxpbnQgY29uZmlndXJhdGlvbjsgY29ycmVjdG5lc3MgaXMgdmVyaWZpZWQgYnkgcnVubmluZyBjb21taXRsaW50LCBub3QgdW5pdCB0ZXN0cy4gKi9cblxuaW1wb3J0IHR5cGUge1xuICBSdWxlQ29uZmlnU2V2ZXJpdHksXG4gIFVzZXJDb25maWdcbn0gZnJvbSAnQGNvbW1pdGxpbnQvdHlwZXMnO1xuXG5pbXBvcnQgeyBjYXN0VG8gfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvb2JqZWN0LXV0aWxzJztcblxuaW1wb3J0IHtcbiAgZm9yYmlkZGVuUGF0dGVybnNQbHVnaW4sXG4gIE5PX0ZPUkJJRERFTl9QQVRURVJOU19SVUxFX05BTUVcbn0gZnJvbSAnLi9jb21taXRsaW50LWZvcmJpZGRlbi1wYXR0ZXJucy50cyc7XG5pbXBvcnQge1xuICBTUEVMTENIRUNLX0hFQURFUl9SVUxFX05BTUUsXG4gIHNwZWxsY2hlY2tIZWFkZXJQbHVnaW5cbn0gZnJvbSAnLi9jb21taXRsaW50LXNwZWxsY2hlY2staGVhZGVyLnRzJztcblxuLypcbiAqIGBSdWxlQ29uZmlnU2V2ZXJpdHkuRXJyb3JgLiBUaGUgZW51bSBsaXZlcyBpbiBhIHBhY2thZ2UgdGhpcyBsaWJyYXJ5IG9ubHkgaGFzIGFzIGEgZGV2RGVwZW5kZW5jeSwgc28gaXRzIHZhbHVlIGNhbm5vdCBiZSBpbXBvcnRlZCBhdCBydW50aW1lLlxuICovXG5jb25zdCBFUlJPUl9TRVZFUklUWV9MRVZFTCA9IDI7XG5jb25zdCBFUlJPUl9TRVZFUklUWSA9IGNhc3RUbzxSdWxlQ29uZmlnU2V2ZXJpdHk+KEVSUk9SX1NFVkVSSVRZX0xFVkVMKTtcblxuLyoqXG4gKiBDb21taXRsaW50IGNvbmZpZ3VyYXRpb24gZXh0ZW5kaW5nIGBAY29tbWl0bGludC9jb25maWctY29udmVudGlvbmFsYCwgcGx1cyBhIHJ1bGUgcmVmdXNpbmcgYSBtZXNzYWdlIHdob3NlXG4gKiBoZWFkZXIsIGJvZHkgb3IgZm9vdGVyIG1hdGNoZXMgdGhlIHVucHVibGlzaGVkIGZvcmJpZGRlbi1wYXR0ZXJucyBsaXN0IChhIG5vLW9wIHdoZW4gbm9uZSBpcyBjb25maWd1cmVkKSwgYW5kXG4gKiBhIHJ1bGUgc3BlbGxjaGVja2luZyB0aGUgaGVhZGVyIHRoZSB3YXkgdGhlIHJlbGVhc2Ugc3BlbGxjaGVja3MgdGhlIGNoYW5nZWxvZyBidWxsZXQgaXQgYmVjb21lcyAoYSBuby1vcCBpbiBhXG4gKiBwcm9qZWN0IHdpdGggbm8gYHNwZWxsY2hlY2tgIHNjcmlwdCkuXG4gKi9cbmV4cG9ydCBjb25zdCBvYnNpZGlhbkRldlV0aWxzQ29uZmlnOiBVc2VyQ29uZmlnID0ge1xuICBleHRlbmRzOiBbJ0Bjb21taXRsaW50L2NvbmZpZy1jb252ZW50aW9uYWwnXSxcbiAgLy8gT05FIHBsdWdpbiBvYmplY3QsIG5ldmVyIHR3bzogYEBjb21taXRsaW50L2xvYWRgIHN0b3JlcyBldmVyeSBpbmxpbmUgcGx1Z2luIHVuZGVyIHRoZSBzYW1lIGBsb2NhbGAga2V5LCBzbyBhXG4gIC8vIHNlY29uZCBvYmplY3Qgc2lsZW50bHkgcmVwbGFjZXMgdGhlIGZpcnN0IGFuZCBpdHMgcnVsZSB0aGVuIGZhaWxzIGFzIFwiRm91bmQgcnVsZXMgd2l0aG91dCBpbXBsZW1lbnRhdGlvblwiLlxuICBwbHVnaW5zOiBbXG4gICAge1xuICAgICAgcnVsZXM6IHtcbiAgICAgICAgLi4uZm9yYmlkZGVuUGF0dGVybnNQbHVnaW4ucnVsZXMsXG4gICAgICAgIC4uLnNwZWxsY2hlY2tIZWFkZXJQbHVnaW4ucnVsZXNcbiAgICAgIH1cbiAgICB9XG4gIF0sXG4gIHJ1bGVzOiB7XG4gICAgW05PX0ZPUkJJRERFTl9QQVRURVJOU19SVUxFX05BTUVdOiBbRVJST1JfU0VWRVJJVFksICdhbHdheXMnXSxcbiAgICBbU1BFTExDSEVDS19IRUFERVJfUlVMRV9OQU1FXTogW0VSUk9SX1NFVkVSSVRZLCAnYWx3YXlzJ11cbiAgfVxufTtcblxuLyogdjggaWdub3JlIHN0b3AgKi9cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBYUEsU0FBUyxjQUFjO0FBRXZCO0FBQUEsRUFDRTtBQUFBLEVBQ0E7QUFBQSxPQUNLO0FBQ1A7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFLUCxNQUFNLHVCQUF1QjtBQUM3QixNQUFNLGlCQUFpQixPQUEyQixvQkFBb0I7QUFRL0QsTUFBTSx5QkFBcUM7QUFBQSxFQUNoRCxTQUFTLENBQUMsaUNBQWlDO0FBQUE7QUFBQTtBQUFBLEVBRzNDLFNBQVM7QUFBQSxJQUNQO0FBQUEsTUFDRSxPQUFPO0FBQUEsUUFDTCxHQUFHLHdCQUF3QjtBQUFBLFFBQzNCLEdBQUcsdUJBQXVCO0FBQUEsTUFDNUI7QUFBQSxJQUNGO0FBQUEsRUFDRjtBQUFBLEVBQ0EsT0FBTztBQUFBLElBQ0wsQ0FBQywrQkFBK0IsR0FBRyxDQUFDLGdCQUFnQixRQUFRO0FBQUEsSUFDNUQsQ0FBQywyQkFBMkIsR0FBRyxDQUFDLGdCQUFnQixRQUFRO0FBQUEsRUFDMUQ7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/commitlint-forbidden-patterns.d.mts

@@ -0,0 +1,37 @@
+/// <reference path="./index.d.mts" />
+/**
+ * @file
+ *
+ * A commitlint rule that refuses a commit message matching a pattern from the UNPUBLISHED forbidden-patterns
+ * list — in its header, its body or its footer.
+ *
+ * The release already refuses a changelog section carrying such a pattern, but a changelog section holds commit
+ * SUBJECTS only, so a body line was never scanned by anything: it reached the public history the moment the
+ * commit was pushed, and a pushed commit with descendants cannot be cleaned without rewriting published history.
+ * The commit-msg hook is the one point where a body is checked before it exists anywhere else.
+ *
+ * The list comes from the same place as the release's: the file named by the `FORBIDDEN_PATTERNS_FILE`
+ * environment variable (see `forbidden-patterns.ts`). The rule passes when nothing is configured, so a consumer
+ * who has not set it sees no change at all.
+ */
+import type { AsyncRule, Plugin, RuleOutcome } from '@commitlint/types';
+/**
+ * The name the rule is registered under.
+ */
+export declare const NO_FORBIDDEN_PATTERNS_RULE_NAME = "obsidian-dev-utils/no-forbidden-patterns";
+type Commit = Parameters<AsyncRule>[0];
+/**
+ * Checks the whole commit message — header, body and footer — against the forbidden patterns.
+ *
+ * Only the `always` condition is meaningful: `never` would require every line to carry a forbidden pattern, so
+ * it is treated the same way rather than inverted.
+ *
+ * @param commit - The parsed commit.
+ * @returns A {@link Promise} that resolves to the rule outcome, naming each offending line and what matched.
+ */
+export declare function noForbiddenPatternsRule(commit: Commit): Promise<RuleOutcome>;
+/**
+ * The commitlint plugin carrying {@link noForbiddenPatternsRule}.
+ */
+export declare const forbiddenPatternsPlugin: Plugin;
+export {};