@mnaoumov/typescript-dev-toolkit 0.0.0 → 1.1.0

package/dist/lib/cjs/exec.d.cts

@@ -0,0 +1,162 @@
+/// <reference path="./library-references.d.cts" />
+/**
+ * @file
+ *
+ * Contains utility functions for executing commands.
+ */
+/**
+ * A command part: either a plain string or an {@link ExecArgument} with batched arguments.
+ */
+export type CommandPart = ExecArgument | string;
+/**
+ * A command argument that contains a list of args to be batched.
+ * If the expanded command exceeds the platform's max command length,
+ * the batched args are split into sequential executions.
+ */
+export interface ExecArgument {
+    /**
+     * The arguments to batch.
+     */
+    readonly batchedArguments: readonly string[];
+}
+/**
+ * Options for {@link exec} that return detailed results.
+ */
+export interface ExecDetailedOptions extends ExecOptions {
+    /**
+     * Must be `true` to receive detailed results.
+     */
+    readonly shouldIncludeDetails: true;
+}
+/**
+ * Options for executing a command.
+ */
+export interface ExecOptions {
+    /**
+     * A current working folder for the command execution.
+     */
+    readonly cwd?: string;
+    /**
+     * Additional environment variables for the child process, merged over the inherited environment.
+     *
+     * @default `{}`
+     */
+    readonly env?: NodeJS.ProcessEnv;
+    /**
+     * If `true`, attaches the child process's stdio directly to the terminal (`stdio: 'inherit'`) instead
+     * of capturing it. Use for long-running or interactive commands such as dev servers and watch mode.
+     * Because the output is not captured, the resolved stdout is an empty string.
+     *
+     * @default `false`
+     */
+    readonly isInteractive?: boolean;
+    /**
+     * If `true`, suppresses the output of the command.
+     *
+     * @default `false`
+     */
+    readonly isQuiet?: boolean;
+    /**
+     * If `true`, throws an error if the command fails.
+     *
+     * @default `true`
+     */
+    readonly shouldFailIfCalledFromOutsideRoot?: boolean;
+    /**
+     * If `true`, ignores the exit code of the command.
+     *
+     * @default `false`
+     */
+    readonly shouldIgnoreExitCode?: boolean;
+    /**
+     * If `false`, only returns the output of the command.
+     *
+     * @default `false`
+     */
+    readonly shouldIncludeDetails?: boolean;
+    /**
+     * An input to be passed to the command.
+     *
+     * @default `''`
+     */
+    readonly stdin?: string;
+}
+/**
+ * A result of {@link exec}.
+ */
+export interface ExecResult {
+    /**
+     * An exit code of the command. A value of `null` indicates that the process did not exit normally.
+     */
+    readonly exitCode: null | number;
+    /**
+     * A signal that caused the process to be terminated. A value of `null` indicates that no signal was received.
+     */
+    readonly exitSignal: NodeJS.Signals | null;
+    /**
+     * A standard error output from the command.
+     */
+    readonly stderr: string;
+    /**
+     * A standard output from the command.
+     */
+    readonly stdout: string;
+}
+/**
+ * Options for {@link exec} that return only stdout.
+ */
+export interface ExecSimpleOptions extends ExecOptions {
+    /**
+     * Must be `false` or omitted to receive only stdout.
+     *
+     * @default `false`
+     */
+    readonly shouldIncludeDetails?: false;
+}
+/**
+ * Appends a single `node` CLI option to a `NODE_OPTIONS` string, preserving any options already present.
+ *
+ * @param existingNodeOptions - The current `NODE_OPTIONS` value (e.g. `process.env.NODE_OPTIONS`), if any.
+ * @param option - The `node` CLI option to append (e.g. `--localstorage-file=:memory:`).
+ * @returns The combined `NODE_OPTIONS` string. If `option` is already present, the value is returned unchanged.
+ */
+export declare function appendNodeOption(existingNodeOptions: string | undefined, option: string): string;
+/**
+ * Builds the environment for child processes: the parent environment plus `DEBUG_COLORS`, and — when
+ * the running `node` supports it — {@link LOCAL_STORAGE_NODE_OPTION} appended to `NODE_OPTIONS`.
+ *
+ * The support check guards against older `node` (< 22): passing an option `node` does not recognize via
+ * `NODE_OPTIONS` makes it exit before running, which would break every spawned tool.
+ *
+ * @param baseEnv - The parent environment to extend (typically `process.env`).
+ * @param allowedNodeEnvironmentFlags - The `node` options accepted via `NODE_OPTIONS` (typically `process.allowedNodeEnvironmentFlags`).
+ * @returns The environment to pass to spawned child processes.
+ */
+export declare function buildChildEnv(baseEnv: NodeJS.ProcessEnv, allowedNodeEnvironmentFlags: ReadonlySet<string>): NodeJS.ProcessEnv;
+/**
+ * Executes a command.
+ *
+ * @param command - The command to execute. It can be a string or an array of strings.
+ * @param options - The options for the execution.
+ * @returns A {@link Promise} that resolves with the output of the command.
+ * @throws If the command fails with a non-zero exit code and ignoreExitCode is `false`.
+ *         The error message includes the exit code, the command, stderr, and stdout (or a note that it was
+ *         printed), and says when the child crashed or was killed rather than exiting on its own.
+ *         If an error occurs during the execution and ignoreExitCode is `true`,
+ *         the error is resolved with the stdout and stderr.
+ */
+export declare function exec(command: CommandPart[] | string, options?: ExecSimpleOptions): Promise<string>;
+/**
+ * Executes a command.
+ *
+ * @param command - The command to execute. It can be a string or an array of strings.
+ * @param options - The options for the execution.
+ * @returns A {@link Promise} that resolves with ExecResult object.
+ *          The ExecResult object contains the exit code, exit signal, stderr, and stdout.
+ * @throws If the command fails with a non-zero exit code and ignoreExitCode is `false`.
+ *         The error message includes the exit code, the command, stderr, and stdout (or a note that it was
+ *         printed), and says when the child crashed or was killed rather than exiting on its own.
+ *         If an error occurs during the execution and ignoreExitCode is `true`,
+ *         the error is resolved with the stdout and stderr.
+ */
+export declare function exec(command: CommandPart[] | string, options: ExecDetailedOptions): Promise<ExecResult>;

package/dist/lib/cjs/forbidden-patterns.cjs

@@ -0,0 +1,157 @@
+/*
+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 keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var forbidden_patterns_exports = {};
+__export(forbidden_patterns_exports, {
+  FORBIDDEN_PATTERNS_FILE_ENV_VARIABLE: () => FORBIDDEN_PATTERNS_FILE_ENV_VARIABLE,
+  findForbiddenPatternMatches: () => findForbiddenPatternMatches,
+  readForbiddenPatterns: () => readForbiddenPatterns
+});
+module.exports = __toCommonJS(forbidden_patterns_exports);
+var import_type_guards = require('@mnaoumov/typescript-lib/type-guards');
+var import_promises = require('node:fs/promises');
+var import_node_process = __toESM(__extractDefault(require('node:process')), 1);
+var import_env_toggle = require('./env-toggle.cjs');
+const FORBIDDEN_PATTERNS_FILE_ENV_VARIABLE = "FORBIDDEN_PATTERNS_FILE";
+const REG_EXP_LITERAL_REG_EXP = /^\/(?<source>.+)\/(?<flags>[a-z]*)$/;
+const STATEFUL_FLAGS_REG_EXP = /[gy]/g;
+function findForbiddenPatternMatches(text, patterns) {
+  const matches = [];
+  for (const line of text.split(/\r?\n/)) {
+    for (const pattern of patterns) {
+      const match = pattern.exec(line);
+      if (match) {
+        matches.push({ line, match: match[0] });
+        break;
+      }
+    }
+  }
+  return matches;
+}
+async function readForbiddenPatterns() {
+  (0, import_env_toggle.loadEnvFileIfExists)();
+  const filePath = (import_node_process.default.env[FORBIDDEN_PATTERNS_FILE_ENV_VARIABLE] ?? "").trim();
+  if (filePath === "") {
+    return [];
+  }
+  let content;
+  try {
+    content = await (0, import_promises.readFile)(filePath, "utf-8");
+  } catch (error) {
+    throw new Error(`${FORBIDDEN_PATTERNS_FILE_ENV_VARIABLE} names ${filePath}, which cannot be read.`, { cause: error });
+  }
+  const patterns = [];
+  for (const [index, rawLine] of content.split(/\r?\n/).entries()) {
+    const line = rawLine.trim();
+    if (line === "" || line.startsWith("#")) {
+      continue;
+    }
+    try {
+      patterns.push(toRegExp(line));
+    } catch (error) {
+      throw new Error(`Line ${String(index + 1)} of the forbidden-patterns file ${filePath} is not a valid regular expression.`, { cause: error });
+    }
+  }
+  return patterns;
+}
+function toRegExp(line) {
+  const groups = REG_EXP_LITERAL_REG_EXP.exec(line)?.groups;
+  if (!groups) {
+    return new RegExp(line);
+  }
+  const source = (0, import_type_guards.ensureNonNullable)(groups["source"]);
+  const flags = (0, import_type_guards.ensureNonNullable)(groups["flags"]);
+  return new RegExp(source, flags.replaceAll(STATEFUL_FLAGS_REG_EXP, ""));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FORBIDDEN_PATTERNS_FILE_ENV_VARIABLE,
+  findForbiddenPatternMatches,
+  readForbiddenPatterns
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2ZvcmJpZGRlbi1wYXR0ZXJucy50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIEFuIFVOUFVCTElTSEVEIGxpc3Qgb2YgcGF0dGVybnMgdGhhdCBhIHJlbGVhc2UgbXVzdCBuZXZlciBwdWJsaXNoLCByZWFkIGZyb20gYSBmaWxlIHRoZSByZXBvc2l0b3J5IGRvZXMgbm90XG4gKiBjb250YWluLlxuICpcbiAqIFRoZSBsaXN0IGV4aXN0cyBmb3Igdm9jYWJ1bGFyeSB0aGF0IGlzIHByaXZhdGUgdG8gb25lIG1haW50YWluZXIncyBtYWNoaW5lIFx1MjAxNCBhbiBpbnRlcm5hbCB0cmFja2VyJ3MgaWRzLCB0aGVcbiAqIHNob3J0IG5hbWVzIG9mIHRoZWlyIHByb2plY3RzIFx1MjAxNCBhbmQgd2hpY2ggYSBjb21taXQgc3ViamVjdCBjYW4gY2Fycnkgc3RyYWlnaHQgaW50byBhIGdlbmVyYXRlZCBjaGFuZ2Vsb2dcbiAqIHNlY3Rpb24uIE5laXRoZXIgb2YgdGhlIHR3byBvYnZpb3VzIGhvbWVzIHdvcmtzIGZvciBpdDogYSBsaXRlcmFsIGluIHRoaXMgbGlicmFyeSB3b3VsZCBzaGlwIHRoZSBsaXN0IHRvIGV2ZXJ5XG4gKiBjb25zdW1lciBvbiBucG0sIGFuZCBhIGNoZWNrZWQtaW4gcGVyLXJlcG9zaXRvcnkgY29uZmlnIHdvdWxkIHB1Ymxpc2ggaXQgaW4gZXZlcnkgcHVibGljIHJlcG9zaXRvcnkgdGhhdCB1c2VkXG4gKiBpdCwgcGVybWFuZW50bHkuIFNvIHRoZSBsaXN0IGlzIG5hbWVkIGJ5IHRoZSB7QGxpbmsgRk9SQklEREVOX1BBVFRFUk5TX0ZJTEVfRU5WX1ZBUklBQkxFfSBlbnZpcm9ubWVudCB2YXJpYWJsZVxuICogKHdoaWNoIGEgZ2l0aWdub3JlZCBgLmVudmAgY2FuIHNldCksIHBvaW50cyBhdCBhIGZpbGUgb3V0c2lkZSB0aGUgcmVwb3NpdG9yeSwgYW5kIGlzIGEgbm8tb3Agd2hlcmV2ZXIgaXQgaXMgbm90XG4gKiBzZXQgXHUyMDE0IGEgY29uc3VtZXIgd2hvIGhhcyBub3QgY29uZmlndXJlZCBpdCBzZWVzIG5vIGNoYW5nZSBhdCBhbGwuXG4gKlxuICogVGhlIGZpbGUgaG9sZHMgb25lIHBhdHRlcm4gcGVyIGxpbmUuIEJsYW5rIGxpbmVzIGFuZCBsaW5lcyBzdGFydGluZyB3aXRoIGAjYCBhcmUgaWdub3JlZC4gQSBsaW5lIHdyaXR0ZW4gYXMgYVxuICogcmVndWxhciBleHByZXNzaW9uIGxpdGVyYWwgXHUyMDE0IGAvXFxiZm9vXFxiL2lgIFx1MjAxNCB0YWtlcyB0aGUgZmxhZ3MgaXQgbmFtZXM7IGFueSBvdGhlciBsaW5lIGlzIGEgY2FzZS1zZW5zaXRpdmVcbiAqIHJlZ3VsYXIgZXhwcmVzc2lvbiBzb3VyY2UuIFRoZSBnbG9iYWwgYW5kIHN0aWNreSBmbGFncyBhcmUgZHJvcHBlZCwgc2luY2UgYSBtYXRjaCBoZXJlIGlzIGEgeWVzL25vIHF1ZXN0aW9uXG4gKiBhc2tlZCBvZiBvbmUgbGluZSBhdCBhIHRpbWUuXG4gKi9cblxuaW1wb3J0IHsgZW5zdXJlTm9uTnVsbGFibGUgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvdHlwZS1ndWFyZHMnO1xuaW1wb3J0IHsgcmVhZEZpbGUgfSBmcm9tICdub2RlOmZzL3Byb21pc2VzJztcbmltcG9ydCBwcm9jZXNzIGZyb20gJ25vZGU6cHJvY2Vzcyc7XG5cbmltcG9ydCB7IGxvYWRFbnZGaWxlSWZFeGlzdHMgfSBmcm9tICcuL2Vudi10b2dnbGUudHMnO1xuXG4vKipcbiAqIFRoZSBlbnZpcm9ubWVudCB2YXJpYWJsZSBuYW1pbmcgdGhlIGZvcmJpZGRlbi1wYXR0ZXJucyBmaWxlLlxuICovXG5leHBvcnQgY29uc3QgRk9SQklEREVOX1BBVFRFUk5TX0ZJTEVfRU5WX1ZBUklBQkxFID0gJ0ZPUkJJRERFTl9QQVRURVJOU19GSUxFJztcblxuLyoqXG4gKiBPbmUgbGluZSBvZiB0ZXh0IHRoYXQgYSBmb3JiaWRkZW4gcGF0dGVybiBtYXRjaGVkLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEZvcmJpZGRlblBhdHRlcm5NYXRjaCB7XG4gIC8qKlxuICAgKiBUaGUgbGluZSB0aGF0IGNhcnJpZXMgdGhlIG1hdGNoLlxuICAgKi9cbiAgcmVhZG9ubHkgbGluZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgdGV4dCB0aGUgcGF0dGVybiBtYXRjaGVkIHdpdGhpbiB7QGxpbmsgbGluZX0uXG4gICAqL1xuICByZWFkb25seSBtYXRjaDogc3RyaW5nO1xufVxuXG5jb25zdCBSRUdfRVhQX0xJVEVSQUxfUkVHX0VYUCA9IC9eXFwvKD88c291cmNlPi4rKVxcLyg/PGZsYWdzPlthLXpdKikkLztcbmNvbnN0IFNUQVRFRlVMX0ZMQUdTX1JFR19FWFAgPSAvW2d5XS9nO1xuXG4vKipcbiAqIEZpbmRzIGV2ZXJ5IGxpbmUgb2YgYHRleHRgIHRoYXQgb25lIG9mIGBwYXR0ZXJuc2AgbWF0Y2hlcy5cbiAqXG4gKiBAcGFyYW0gdGV4dCAtIFRoZSB0ZXh0IHRvIHNjYW4sIGxpbmUgYnkgbGluZS5cbiAqIEBwYXJhbSBwYXR0ZXJucyAtIFRoZSBwYXR0ZXJucywgYXMge0BsaW5rIHJlYWRGb3JiaWRkZW5QYXR0ZXJuc30gcmV0dXJuZWQgdGhlbS5cbiAqIEByZXR1cm5zIE9uZSB7QGxpbmsgRm9yYmlkZGVuUGF0dGVybk1hdGNofSBwZXIgb2ZmZW5kaW5nIGxpbmUsIG5hbWluZyB0aGUgZmlyc3QgcGF0dGVybiB0aGF0IG1hdGNoZWQgaXQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBmaW5kRm9yYmlkZGVuUGF0dGVybk1hdGNoZXModGV4dDogc3RyaW5nLCBwYXR0ZXJuczogcmVhZG9ubHkgUmVnRXhwW10pOiBGb3JiaWRkZW5QYXR0ZXJuTWF0Y2hbXSB7XG4gIGNvbnN0IG1hdGNoZXM6IEZvcmJpZGRlblBhdHRlcm5NYXRjaFtdID0gW107XG5cbiAgZm9yIChjb25zdCBsaW5lIG9mIHRleHQuc3BsaXQoL1xccj9cXG4vKSkge1xuICAgIGZvciAoY29uc3QgcGF0dGVybiBvZiBwYXR0ZXJucykge1xuICAgICAgY29uc3QgbWF0Y2ggPSBwYXR0ZXJuLmV4ZWMobGluZSk7XG4gICAgICBpZiAobWF0Y2gpIHtcbiAgICAgICAgbWF0Y2hlcy5wdXNoKHsgbGluZSwgbWF0Y2g6IG1hdGNoWzBdIH0pO1xuICAgICAgICBicmVhaztcbiAgICAgIH1cbiAgICB9XG4gIH1cblxuICByZXR1cm4gbWF0Y2hlcztcbn1cblxuLyoqXG4gKiBSZWFkcyB0aGUgZm9yYmlkZGVuIHBhdHRlcm5zIGZyb20gdGhlIGZpbGUge0BsaW5rIEZPUkJJRERFTl9QQVRURVJOU19GSUxFX0VOVl9WQVJJQUJMRX0gbmFtZXMsIGxvYWRpbmcgdGhlXG4gKiBvcHRpb25hbCBgLmVudmAgZmlyc3QuXG4gKlxuICogQW4gdW5zZXQgb3IgYmxhbmsgdmFyaWFibGUgbWVhbnMgbm8gbGlzdCBpcyBjb25maWd1cmVkLCBhbmQgeWllbGRzIG5vIHBhdHRlcm5zLiBBIHZhcmlhYmxlIHRoYXQgSVMgc2V0IGJ1dFxuICogbmFtZXMgYSBmaWxlIHRoYXQgY2Fubm90IGJlIHJlYWQgdGhyb3dzIGluc3RlYWQgb2YgeWllbGRpbmcgbm9uZTogYSBndWFyZCB0aGF0IHN3aXRjaGVzIGl0c2VsZiBvZmYgYmVjYXVzZVxuICogaXRzIGxpc3QgbW92ZWQgaXMgcHJlY2lzZWx5IHRoZSBzaWxlbnQgZmFpbHVyZSBpdCBleGlzdHMgdG8gcHJldmVudC5cbiAqXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHRvIHRoZSBjb21waWxlZCBwYXR0ZXJucy5cbiAqIEB0aHJvd3MgSWYgdGhlIG5hbWVkIGZpbGUgY2Fubm90IGJlIHJlYWQsIG9yIG9uZSBvZiBpdHMgbGluZXMgaXMgbm90IGEgdmFsaWQgcmVndWxhciBleHByZXNzaW9uLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gcmVhZEZvcmJpZGRlblBhdHRlcm5zKCk6IFByb21pc2U8UmVnRXhwW10+IHtcbiAgbG9hZEVudkZpbGVJZkV4aXN0cygpO1xuICBjb25zdCBmaWxlUGF0aCA9IChwcm9jZXNzLmVudltGT1JCSURERU5fUEFUVEVSTlNfRklMRV9FTlZfVkFSSUFCTEVdID8/ICcnKS50cmltKCk7XG4gIGlmIChmaWxlUGF0aCA9PT0gJycpIHtcbiAgICByZXR1cm4gW107XG4gIH1cblxuICBsZXQgY29udGVudDogc3RyaW5nO1xuICB0cnkge1xuICAgIGNvbnRlbnQgPSBhd2FpdCByZWFkRmlsZShmaWxlUGF0aCwgJ3V0Zi04Jyk7XG4gIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGAke0ZPUkJJRERFTl9QQVRURVJOU19GSUxFX0VOVl9WQVJJQUJMRX0gbmFtZXMgJHtmaWxlUGF0aH0sIHdoaWNoIGNhbm5vdCBiZSByZWFkLmAsIHsgY2F1c2U6IGVycm9yIH0pO1xuICB9XG5cbiAgY29uc3QgcGF0dGVybnM6IFJlZ0V4cFtdID0gW107XG4gIGZvciAoY29uc3QgW2luZGV4LCByYXdMaW5lXSBvZiBjb250ZW50LnNwbGl0KC9cXHI/XFxuLykuZW50cmllcygpKSB7XG4gICAgY29uc3QgbGluZSA9IHJhd0xpbmUudHJpbSgpO1xuICAgIGlmIChsaW5lID09PSAnJyB8fCBsaW5lLnN0YXJ0c1dpdGgoJyMnKSkge1xuICAgICAgY29udGludWU7XG4gICAgfVxuXG4gICAgdHJ5IHtcbiAgICAgIHBhdHRlcm5zLnB1c2godG9SZWdFeHAobGluZSkpO1xuICAgIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYExpbmUgJHtTdHJpbmcoaW5kZXggKyAxKX0gb2YgdGhlIGZvcmJpZGRlbi1wYXR0ZXJucyBmaWxlICR7ZmlsZVBhdGh9IGlzIG5vdCBhIHZhbGlkIHJlZ3VsYXIgZXhwcmVzc2lvbi5gLCB7IGNhdXNlOiBlcnJvciB9KTtcbiAgICB9XG4gIH1cblxuICByZXR1cm4gcGF0dGVybnM7XG59XG5cbmZ1bmN0aW9uIHRvUmVnRXhwKGxpbmU6IHN0cmluZyk6IFJlZ0V4cCB7XG4gIGNvbnN0IGdyb3VwcyA9IFJFR19FWFBfTElURVJBTF9SRUdfRVhQLmV4ZWMobGluZSk/Lmdyb3VwcztcbiAgaWYgKCFncm91cHMpIHtcbiAgICByZXR1cm4gbmV3IFJlZ0V4cChsaW5lKTtcbiAgfVxuXG4gIGNvbnN0IHNvdXJjZSA9IGVuc3VyZU5vbk51bGxhYmxlKGdyb3Vwc1snc291cmNlJ10pO1xuICBjb25zdCBmbGFncyA9IGVuc3VyZU5vbk51bGxhYmxlKGdyb3Vwc1snZmxhZ3MnXSk7XG4gIHJldHVybiBuZXcgUmVnRXhwKHNvdXJjZSwgZmxhZ3MucmVwbGFjZUFsbChTVEFURUZVTF9GTEFHU19SRUdfRVhQLCAnJykpO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBb0JBLHlCQUFrQztBQUNsQyxzQkFBeUI7QUFDekIsMEJBQW9CO0FBRXBCLHdCQUFvQztBQUs3QixNQUFNLHVDQUF1QztBQWlCcEQsTUFBTSwwQkFBMEI7QUFDaEMsTUFBTSx5QkFBeUI7QUFTeEIsU0FBUyw0QkFBNEIsTUFBYyxVQUFzRDtBQUM5RyxRQUFNLFVBQW1DLENBQUM7QUFFMUMsYUFBVyxRQUFRLEtBQUssTUFBTSxPQUFPLEdBQUc7QUFDdEMsZUFBVyxXQUFXLFVBQVU7QUFDOUIsWUFBTSxRQUFRLFFBQVEsS0FBSyxJQUFJO0FBQy9CLFVBQUksT0FBTztBQUNULGdCQUFRLEtBQUssRUFBRSxNQUFNLE9BQU8sTUFBTSxDQUFDLEVBQUUsQ0FBQztBQUN0QztBQUFBLE1BQ0Y7QUFBQSxJQUNGO0FBQUEsRUFDRjtBQUVBLFNBQU87QUFDVDtBQWFBLGVBQXNCLHdCQUEyQztBQUMvRCw2Q0FBb0I7QUFDcEIsUUFBTSxZQUFZLG9CQUFBQSxRQUFRLElBQUksb0NBQW9DLEtBQUssSUFBSSxLQUFLO0FBQ2hGLE1BQUksYUFBYSxJQUFJO0FBQ25CLFdBQU8sQ0FBQztBQUFBLEVBQ1Y7QUFFQSxNQUFJO0FBQ0osTUFBSTtBQUNGLGNBQVUsVUFBTSwwQkFBUyxVQUFVLE9BQU87QUFBQSxFQUM1QyxTQUFTLE9BQU87QUFDZCxVQUFNLElBQUksTUFBTSxHQUFHLG9DQUFvQyxVQUFVLFFBQVEsMkJBQTJCLEVBQUUsT0FBTyxNQUFNLENBQUM7QUFBQSxFQUN0SDtBQUVBLFFBQU0sV0FBcUIsQ0FBQztBQUM1QixhQUFXLENBQUMsT0FBTyxPQUFPLEtBQUssUUFBUSxNQUFNLE9BQU8sRUFBRSxRQUFRLEdBQUc7QUFDL0QsVUFBTSxPQUFPLFFBQVEsS0FBSztBQUMxQixRQUFJLFNBQVMsTUFBTSxLQUFLLFdBQVcsR0FBRyxHQUFHO0FBQ3ZDO0FBQUEsSUFDRjtBQUVBLFFBQUk7QUFDRixlQUFTLEtBQUssU0FBUyxJQUFJLENBQUM7QUFBQSxJQUM5QixTQUFTLE9BQU87QUFDZCxZQUFNLElBQUksTUFBTSxRQUFRLE9BQU8sUUFBUSxDQUFDLENBQUMsbUNBQW1DLFFBQVEsdUNBQXVDLEVBQUUsT0FBTyxNQUFNLENBQUM7QUFBQSxJQUM3STtBQUFBLEVBQ0Y7QUFFQSxTQUFPO0FBQ1Q7QUFFQSxTQUFTLFNBQVMsTUFBc0I7QUFDdEMsUUFBTSxTQUFTLHdCQUF3QixLQUFLLElBQUksR0FBRztBQUNuRCxNQUFJLENBQUMsUUFBUTtBQUNYLFdBQU8sSUFBSSxPQUFPLElBQUk7QUFBQSxFQUN4QjtBQUVBLFFBQU0sYUFBUyxzQ0FBa0IsT0FBTyxRQUFRLENBQUM7QUFDakQsUUFBTSxZQUFRLHNDQUFrQixPQUFPLE9BQU8sQ0FBQztBQUMvQyxTQUFPLElBQUksT0FBTyxRQUFRLE1BQU0sV0FBVyx3QkFBd0IsRUFBRSxDQUFDO0FBQ3hFOyIsCiAgIm5hbWVzIjogWyJwcm9jZXNzIl0KfQo=

package/dist/lib/cjs/forbidden-patterns.d.cts

@@ -0,0 +1,57 @@
+/// <reference path="./library-references.d.cts" />
+/**
+ * @file
+ *
+ * An UNPUBLISHED list of patterns that a release must never publish, read from a file the repository does not
+ * contain.
+ *
+ * The list exists for vocabulary that is private to one maintainer's machine — an internal tracker's ids, the
+ * short names of their projects — and which a commit subject can carry straight into a generated changelog
+ * section. Neither of the two obvious homes works for it: a literal in this library would ship the list to every
+ * consumer on npm, and a checked-in per-repository config would publish it in every public repository that used
+ * it, permanently. So the list is named by the {@link FORBIDDEN_PATTERNS_FILE_ENV_VARIABLE} environment variable
+ * (which a gitignored `.env` can set), points at a file outside the repository, and is a no-op wherever it is not
+ * set — a consumer who has not configured it sees no change at all.
+ *
+ * The file holds one pattern per line. Blank lines and lines starting with `#` are ignored. A line written as a
+ * regular expression literal — `/\bfoo\b/i` — takes the flags it names; any other line is a case-sensitive
+ * regular expression source. The global and sticky flags are dropped, since a match here is a yes/no question
+ * asked of one line at a time.
+ */
+/**
+ * The environment variable naming the forbidden-patterns file.
+ */
+export declare const FORBIDDEN_PATTERNS_FILE_ENV_VARIABLE = "FORBIDDEN_PATTERNS_FILE";
+/**
+ * One line of text that a forbidden pattern matched.
+ */
+export interface ForbiddenPatternMatch {
+    /**
+     * The line that carries the match.
+     */
+    readonly line: string;
+    /**
+     * The text the pattern matched within {@link line}.
+     */
+    readonly match: string;
+}
+/**
+ * Finds every line of `text` that one of `patterns` matches.
+ *
+ * @param text - The text to scan, line by line.
+ * @param patterns - The patterns, as {@link readForbiddenPatterns} returned them.
+ * @returns One {@link ForbiddenPatternMatch} per offending line, naming the first pattern that matched it.
+ */
+export declare function findForbiddenPatternMatches(text: string, patterns: readonly RegExp[]): ForbiddenPatternMatch[];
+/**
+ * Reads the forbidden patterns from the file {@link FORBIDDEN_PATTERNS_FILE_ENV_VARIABLE} names, loading the
+ * optional `.env` first.
+ *
+ * An unset or blank variable means no list is configured, and yields no patterns. A variable that IS set but
+ * names a file that cannot be read throws instead of yielding none: a guard that switches itself off because
+ * its list moved is precisely the silent failure it exists to prevent.
+ *
+ * @returns A {@link Promise} that resolves to the compiled patterns.
+ * @throws If the named file cannot be read, or one of its lines is not a valid regular expression.
+ */
+export declare function readForbiddenPatterns(): Promise<RegExp[]>;

package/dist/lib/cjs/formatters/dprint.cjs

@@ -0,0 +1,108 @@
+/*
+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 keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+
+"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 dprint_exports = {};
+__export(dprint_exports, {
+  format: () => format
+});
+module.exports = __toCommonJS(dprint_exports);
+var import_type_guards = require('@mnaoumov/typescript-lib/type-guards');
+var import_node_fs = require('node:fs');
+var import_package_manager = require('../package-manager.cjs');
+var import_repo_paths = require('../repo-paths.cjs');
+var import_root = require('../root.cjs');
+async function format(options) {
+  const { defaultConfigFilePath, paths, rewrite = true } = options ?? {};
+  const rootFolder = (0, import_root.getRootFolder)();
+  (0, import_type_guards.assertNonNullable)(rootFolder, "Root folder not found");
+  let dprintJsonPath = (0, import_root.resolvePathFromRootSafe)({ path: import_repo_paths.RepoPaths.DprintJson });
+  if (!(0, import_node_fs.existsSync)(dprintJsonPath) && defaultConfigFilePath) {
+    dprintJsonPath = defaultConfigFilePath;
+  }
+  if (!(0, import_node_fs.existsSync)(dprintJsonPath)) {
+    throw new Error("dprint.json not found");
+  }
+  const command = rewrite ? "fmt" : "check";
+  const targets = paths?.length ? paths : ["**/*"];
+  await (0, import_root.execFromRoot)([...(0, import_package_manager.resolveToolCommand)({ tool: "dprint" }), command, "--config", dprintJsonPath, { batchedArguments: targets }]);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  format
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2Zvcm1hdHRlcnMvZHByaW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogRm9ybWF0IHRoZSBzb3VyY2UgY29kZS5cbiAqL1xuXG5pbXBvcnQgeyBhc3NlcnROb25OdWxsYWJsZSB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi90eXBlLWd1YXJkcyc7XG5pbXBvcnQgeyBleGlzdHNTeW5jIH0gZnJvbSAnbm9kZTpmcyc7XG5cbmltcG9ydCB7IHJlc29sdmVUb29sQ29tbWFuZCB9IGZyb20gJy4uL3BhY2thZ2UtbWFuYWdlci50cyc7XG5pbXBvcnQgeyBSZXBvUGF0aHMgfSBmcm9tICcuLi9yZXBvLXBhdGhzLnRzJztcbmltcG9ydCB7XG4gIGV4ZWNGcm9tUm9vdCxcbiAgZ2V0Um9vdEZvbGRlcixcbiAgcmVzb2x2ZVBhdGhGcm9tUm9vdFNhZmVcbn0gZnJvbSAnLi4vcm9vdC50cyc7XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3IgdGhlIHtAbGluayBmb3JtYXR9IGZ1bmN0aW9uLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEZvcm1hdE9wdGlvbnMge1xuICAvKipcbiAgICogVGhlIGBkcHJpbnQuanNvbmAgdXNlZCB3aGVuIHRoZSBwcm9qZWN0IGhhcyBub25lIG9mIGl0cyBvd24uIFdpdGhvdXQgaXQsIGEgcHJvamVjdCB3aXRoIG5vIGBkcHJpbnQuanNvbmBcbiAgICogZmFpbHMuXG4gICAqL1xuICByZWFkb25seSBkZWZhdWx0Q29uZmlnRmlsZVBhdGg/OiBzdHJpbmcgfCB1bmRlZmluZWQ7XG5cbiAgLyoqXG4gICAqIE9wdGlvbmFsIGZpbGUgcGF0aHMgdG8gZm9ybWF0LiBJZiBvbWl0dGVkLCBmb3JtYXRzIHRoZSBlbnRpcmUgcHJvamVjdC5cbiAgICovXG4gIHJlYWRvbmx5IHBhdGhzPzogc3RyaW5nW10gfCB1bmRlZmluZWQ7XG5cbiAgLyoqXG4gICAqIFdoZXRoZXIgdG8gcmV3cml0ZSB0aGUgc291cmNlIGNvZGUuXG4gICAqXG4gICAqIEBkZWZhdWx0IGB0cnVlYFxuICAgKi9cbiAgcmVhZG9ubHkgcmV3cml0ZT86IGJvb2xlYW4gfCB1bmRlZmluZWQ7XG59XG5cbi8qKlxuICogRm9ybWF0IHRoZSBzb3VyY2UgY29kZS5cbiAqXG4gKiBAcGFyYW0gb3B0aW9ucyAtIFRoZSB7QGxpbmsgRm9ybWF0T3B0aW9uc30uXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdoZW4gdGhlIHNvdXJjZSBjb2RlIGhhcyBiZWVuIGZvcm1hdHRlZC5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGZvcm1hdChvcHRpb25zPzogRm9ybWF0T3B0aW9ucyk6IFByb21pc2U8dm9pZD4ge1xuICBjb25zdCB7IGRlZmF1bHRDb25maWdGaWxlUGF0aCwgcGF0aHMsIHJld3JpdGUgPSB0cnVlIH0gPSBvcHRpb25zID8/IHt9O1xuICBjb25zdCByb290Rm9sZGVyID0gZ2V0Um9vdEZvbGRlcigpO1xuICBhc3NlcnROb25OdWxsYWJsZShyb290Rm9sZGVyLCAnUm9vdCBmb2xkZXIgbm90IGZvdW5kJyk7XG4gIGxldCBkcHJpbnRKc29uUGF0aCA9IHJlc29sdmVQYXRoRnJvbVJvb3RTYWZlKHsgcGF0aDogUmVwb1BhdGhzLkRwcmludEpzb24gfSk7XG4gIGlmICghZXhpc3RzU3luYyhkcHJpbnRKc29uUGF0aCkgJiYgZGVmYXVsdENvbmZpZ0ZpbGVQYXRoKSB7XG4gICAgZHByaW50SnNvblBhdGggPSBkZWZhdWx0Q29uZmlnRmlsZVBhdGg7XG4gIH1cblxuICBpZiAoIWV4aXN0c1N5bmMoZHByaW50SnNvblBhdGgpKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKCdkcHJpbnQuanNvbiBub3QgZm91bmQnKTtcbiAgfVxuXG4gIGNvbnN0IGNvbW1hbmQgPSByZXdyaXRlID8gJ2ZtdCcgOiAnY2hlY2snO1xuICAvKiB2OCBpZ25vcmUgc3RhcnQgLS0gVGhlIHBhdGhzLXByb3ZpZGVkIGJyYW5jaCBpcyBvbmx5IGV4ZXJjaXNlZCBieSBjb25zdW1lciBwcm9qZWN0cyBwYXNzaW5nIGZpbGUgbGlzdHMuICovXG4gIGNvbnN0IHRhcmdldHMgPSBwYXRocz8ubGVuZ3RoID8gcGF0aHMgOiBbJyoqLyonXTtcbiAgLyogdjggaWdub3JlIHN0b3AgKi9cbiAgYXdhaXQgZXhlY0Zyb21Sb290KFsuLi5yZXNvbHZlVG9vbENvbW1hbmQoeyB0b29sOiAnZHByaW50JyB9KSwgY29tbWFuZCwgJy0tY29uZmlnJywgZHByaW50SnNvblBhdGgsIHsgYmF0Y2hlZEFyZ3VtZW50czogdGFyZ2V0cyB9XSk7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBTUEseUJBQWtDO0FBQ2xDLHFCQUEyQjtBQUUzQiw2QkFBbUM7QUFDbkMsd0JBQTBCO0FBQzFCLGtCQUlPO0FBK0JQLGVBQXNCLE9BQU8sU0FBd0M7QUFDbkUsUUFBTSxFQUFFLHVCQUF1QixPQUFPLFVBQVUsS0FBSyxJQUFJLFdBQVcsQ0FBQztBQUNyRSxRQUFNLGlCQUFhLDJCQUFjO0FBQ2pDLDRDQUFrQixZQUFZLHVCQUF1QjtBQUNyRCxNQUFJLHFCQUFpQixxQ0FBd0IsRUFBRSxNQUFNLDRCQUFVLFdBQVcsQ0FBQztBQUMzRSxNQUFJLEtBQUMsMkJBQVcsY0FBYyxLQUFLLHVCQUF1QjtBQUN4RCxxQkFBaUI7QUFBQSxFQUNuQjtBQUVBLE1BQUksS0FBQywyQkFBVyxjQUFjLEdBQUc7QUFDL0IsVUFBTSxJQUFJLE1BQU0sdUJBQXVCO0FBQUEsRUFDekM7QUFFQSxRQUFNLFVBQVUsVUFBVSxRQUFRO0FBRWxDLFFBQU0sVUFBVSxPQUFPLFNBQVMsUUFBUSxDQUFDLE1BQU07QUFFL0MsWUFBTSwwQkFBYSxDQUFDLE9BQUcsMkNBQW1CLEVBQUUsTUFBTSxTQUFTLENBQUMsR0FBRyxTQUFTLFlBQVksZ0JBQWdCLEVBQUUsa0JBQWtCLFFBQVEsQ0FBQyxDQUFDO0FBQ3BJOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/cjs/formatters/dprint.d.cts

@@ -0,0 +1,33 @@
+/// <reference path="../library-references.d.cts" />
+/**
+ * @file
+ *
+ * Format the source code.
+ */
+/**
+ * Parameters for the {@link format} function.
+ */
+export interface FormatOptions {
+    /**
+     * The `dprint.json` used when the project has none of its own. Without it, a project with no `dprint.json`
+     * fails.
+     */
+    readonly defaultConfigFilePath?: string | undefined;
+    /**
+     * Optional file paths to format. If omitted, formats the entire project.
+     */
+    readonly paths?: string[] | undefined;
+    /**
+     * Whether to rewrite the source code.
+     *
+     * @default `true`
+     */
+    readonly rewrite?: boolean | undefined;
+}
+/**
+ * Format the source code.
+ *
+ * @param options - The {@link FormatOptions}.
+ * @returns A {@link Promise} that resolves when the source code has been formatted.
+ */
+export declare function format(options?: FormatOptions): Promise<void>;

package/dist/lib/cjs/formatters/index.cjs

@@ -0,0 +1,99 @@
+/*
+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 keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var formatters_exports = {};
+__export(formatters_exports, {
+  dprint: () => dprint
+});
+module.exports = __toCommonJS(formatters_exports);
+var dprint = __toESM(__extractDefault(require('./dprint.cjs')), 1);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  dprint
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2Zvcm1hdHRlcnMvaW5kZXgudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qIFRISVMgSVMgQSBHRU5FUkFURUQvQlVORExFRCBGSUxFIEJZIEJVSUxEIFNDUklQVCAqL1xuXG5leHBvcnQgKiBhcyAnZHByaW50JyBmcm9tICcuL2RwcmludC50cyc7XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUVBLGFBQTBCOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/cjs/formatters/index.d.cts

@@ -0,0 +1,2 @@
+/// <reference path="../library-references.d.cts" />
+export * as 'dprint' from './dprint.cjs';