@mnaoumov/typescript-dev-toolkit 0.0.0 → 1.0.0

package/dist/lib/esm/forbidden-patterns.mjs

@@ -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 initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import { ensureNonNullable } from "@mnaoumov/typescript-lib/type-guards";
+import { readFile } from "node:fs/promises";
+import process from "node:process";
+import { loadEnvFileIfExists } from "./env-toggle.mjs";
+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() {
+  loadEnvFileIfExists();
+  const filePath = (process.env[FORBIDDEN_PATTERNS_FILE_ENV_VARIABLE] ?? "").trim();
+  if (filePath === "") {
+    return [];
+  }
+  let content;
+  try {
+    content = await 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 = ensureNonNullable(groups["source"]);
+  const flags = ensureNonNullable(groups["flags"]);
+  return new RegExp(source, flags.replaceAll(STATEFUL_FLAGS_REG_EXP, ""));
+}
+export {
+  FORBIDDEN_PATTERNS_FILE_ENV_VARIABLE,
+  findForbiddenPatternMatches,
+  readForbiddenPatterns
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2ZvcmJpZGRlbi1wYXR0ZXJucy50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIEFuIFVOUFVCTElTSEVEIGxpc3Qgb2YgcGF0dGVybnMgdGhhdCBhIHJlbGVhc2UgbXVzdCBuZXZlciBwdWJsaXNoLCByZWFkIGZyb20gYSBmaWxlIHRoZSByZXBvc2l0b3J5IGRvZXMgbm90XG4gKiBjb250YWluLlxuICpcbiAqIFRoZSBsaXN0IGV4aXN0cyBmb3Igdm9jYWJ1bGFyeSB0aGF0IGlzIHByaXZhdGUgdG8gb25lIG1haW50YWluZXIncyBtYWNoaW5lIFx1MjAxNCBhbiBpbnRlcm5hbCB0cmFja2VyJ3MgaWRzLCB0aGVcbiAqIHNob3J0IG5hbWVzIG9mIHRoZWlyIHByb2plY3RzIFx1MjAxNCBhbmQgd2hpY2ggYSBjb21taXQgc3ViamVjdCBjYW4gY2Fycnkgc3RyYWlnaHQgaW50byBhIGdlbmVyYXRlZCBjaGFuZ2Vsb2dcbiAqIHNlY3Rpb24uIE5laXRoZXIgb2YgdGhlIHR3byBvYnZpb3VzIGhvbWVzIHdvcmtzIGZvciBpdDogYSBsaXRlcmFsIGluIHRoaXMgbGlicmFyeSB3b3VsZCBzaGlwIHRoZSBsaXN0IHRvIGV2ZXJ5XG4gKiBjb25zdW1lciBvbiBucG0sIGFuZCBhIGNoZWNrZWQtaW4gcGVyLXJlcG9zaXRvcnkgY29uZmlnIHdvdWxkIHB1Ymxpc2ggaXQgaW4gZXZlcnkgcHVibGljIHJlcG9zaXRvcnkgdGhhdCB1c2VkXG4gKiBpdCwgcGVybWFuZW50bHkuIFNvIHRoZSBsaXN0IGlzIG5hbWVkIGJ5IHRoZSB7QGxpbmsgRk9SQklEREVOX1BBVFRFUk5TX0ZJTEVfRU5WX1ZBUklBQkxFfSBlbnZpcm9ubWVudCB2YXJpYWJsZVxuICogKHdoaWNoIGEgZ2l0aWdub3JlZCBgLmVudmAgY2FuIHNldCksIHBvaW50cyBhdCBhIGZpbGUgb3V0c2lkZSB0aGUgcmVwb3NpdG9yeSwgYW5kIGlzIGEgbm8tb3Agd2hlcmV2ZXIgaXQgaXMgbm90XG4gKiBzZXQgXHUyMDE0IGEgY29uc3VtZXIgd2hvIGhhcyBub3QgY29uZmlndXJlZCBpdCBzZWVzIG5vIGNoYW5nZSBhdCBhbGwuXG4gKlxuICogVGhlIGZpbGUgaG9sZHMgb25lIHBhdHRlcm4gcGVyIGxpbmUuIEJsYW5rIGxpbmVzIGFuZCBsaW5lcyBzdGFydGluZyB3aXRoIGAjYCBhcmUgaWdub3JlZC4gQSBsaW5lIHdyaXR0ZW4gYXMgYVxuICogcmVndWxhciBleHByZXNzaW9uIGxpdGVyYWwgXHUyMDE0IGAvXFxiZm9vXFxiL2lgIFx1MjAxNCB0YWtlcyB0aGUgZmxhZ3MgaXQgbmFtZXM7IGFueSBvdGhlciBsaW5lIGlzIGEgY2FzZS1zZW5zaXRpdmVcbiAqIHJlZ3VsYXIgZXhwcmVzc2lvbiBzb3VyY2UuIFRoZSBnbG9iYWwgYW5kIHN0aWNreSBmbGFncyBhcmUgZHJvcHBlZCwgc2luY2UgYSBtYXRjaCBoZXJlIGlzIGEgeWVzL25vIHF1ZXN0aW9uXG4gKiBhc2tlZCBvZiBvbmUgbGluZSBhdCBhIHRpbWUuXG4gKi9cblxuaW1wb3J0IHsgZW5zdXJlTm9uTnVsbGFibGUgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvdHlwZS1ndWFyZHMnO1xuaW1wb3J0IHsgcmVhZEZpbGUgfSBmcm9tICdub2RlOmZzL3Byb21pc2VzJztcbmltcG9ydCBwcm9jZXNzIGZyb20gJ25vZGU6cHJvY2Vzcyc7XG5cbmltcG9ydCB7IGxvYWRFbnZGaWxlSWZFeGlzdHMgfSBmcm9tICcuL2Vudi10b2dnbGUudHMnO1xuXG4vKipcbiAqIFRoZSBlbnZpcm9ubWVudCB2YXJpYWJsZSBuYW1pbmcgdGhlIGZvcmJpZGRlbi1wYXR0ZXJucyBmaWxlLlxuICovXG5leHBvcnQgY29uc3QgRk9SQklEREVOX1BBVFRFUk5TX0ZJTEVfRU5WX1ZBUklBQkxFID0gJ0ZPUkJJRERFTl9QQVRURVJOU19GSUxFJztcblxuLyoqXG4gKiBPbmUgbGluZSBvZiB0ZXh0IHRoYXQgYSBmb3JiaWRkZW4gcGF0dGVybiBtYXRjaGVkLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEZvcmJpZGRlblBhdHRlcm5NYXRjaCB7XG4gIC8qKlxuICAgKiBUaGUgbGluZSB0aGF0IGNhcnJpZXMgdGhlIG1hdGNoLlxuICAgKi9cbiAgcmVhZG9ubHkgbGluZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgdGV4dCB0aGUgcGF0dGVybiBtYXRjaGVkIHdpdGhpbiB7QGxpbmsgbGluZX0uXG4gICAqL1xuICByZWFkb25seSBtYXRjaDogc3RyaW5nO1xufVxuXG5jb25zdCBSRUdfRVhQX0xJVEVSQUxfUkVHX0VYUCA9IC9eXFwvKD88c291cmNlPi4rKVxcLyg/PGZsYWdzPlthLXpdKikkLztcbmNvbnN0IFNUQVRFRlVMX0ZMQUdTX1JFR19FWFAgPSAvW2d5XS9nO1xuXG4vKipcbiAqIEZpbmRzIGV2ZXJ5IGxpbmUgb2YgYHRleHRgIHRoYXQgb25lIG9mIGBwYXR0ZXJuc2AgbWF0Y2hlcy5cbiAqXG4gKiBAcGFyYW0gdGV4dCAtIFRoZSB0ZXh0IHRvIHNjYW4sIGxpbmUgYnkgbGluZS5cbiAqIEBwYXJhbSBwYXR0ZXJucyAtIFRoZSBwYXR0ZXJucywgYXMge0BsaW5rIHJlYWRGb3JiaWRkZW5QYXR0ZXJuc30gcmV0dXJuZWQgdGhlbS5cbiAqIEByZXR1cm5zIE9uZSB7QGxpbmsgRm9yYmlkZGVuUGF0dGVybk1hdGNofSBwZXIgb2ZmZW5kaW5nIGxpbmUsIG5hbWluZyB0aGUgZmlyc3QgcGF0dGVybiB0aGF0IG1hdGNoZWQgaXQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBmaW5kRm9yYmlkZGVuUGF0dGVybk1hdGNoZXModGV4dDogc3RyaW5nLCBwYXR0ZXJuczogcmVhZG9ubHkgUmVnRXhwW10pOiBGb3JiaWRkZW5QYXR0ZXJuTWF0Y2hbXSB7XG4gIGNvbnN0IG1hdGNoZXM6IEZvcmJpZGRlblBhdHRlcm5NYXRjaFtdID0gW107XG5cbiAgZm9yIChjb25zdCBsaW5lIG9mIHRleHQuc3BsaXQoL1xccj9cXG4vKSkge1xuICAgIGZvciAoY29uc3QgcGF0dGVybiBvZiBwYXR0ZXJucykge1xuICAgICAgY29uc3QgbWF0Y2ggPSBwYXR0ZXJuLmV4ZWMobGluZSk7XG4gICAgICBpZiAobWF0Y2gpIHtcbiAgICAgICAgbWF0Y2hlcy5wdXNoKHsgbGluZSwgbWF0Y2g6IG1hdGNoWzBdIH0pO1xuICAgICAgICBicmVhaztcbiAgICAgIH1cbiAgICB9XG4gIH1cblxuICByZXR1cm4gbWF0Y2hlcztcbn1cblxuLyoqXG4gKiBSZWFkcyB0aGUgZm9yYmlkZGVuIHBhdHRlcm5zIGZyb20gdGhlIGZpbGUge0BsaW5rIEZPUkJJRERFTl9QQVRURVJOU19GSUxFX0VOVl9WQVJJQUJMRX0gbmFtZXMsIGxvYWRpbmcgdGhlXG4gKiBvcHRpb25hbCBgLmVudmAgZmlyc3QuXG4gKlxuICogQW4gdW5zZXQgb3IgYmxhbmsgdmFyaWFibGUgbWVhbnMgbm8gbGlzdCBpcyBjb25maWd1cmVkLCBhbmQgeWllbGRzIG5vIHBhdHRlcm5zLiBBIHZhcmlhYmxlIHRoYXQgSVMgc2V0IGJ1dFxuICogbmFtZXMgYSBmaWxlIHRoYXQgY2Fubm90IGJlIHJlYWQgdGhyb3dzIGluc3RlYWQgb2YgeWllbGRpbmcgbm9uZTogYSBndWFyZCB0aGF0IHN3aXRjaGVzIGl0c2VsZiBvZmYgYmVjYXVzZVxuICogaXRzIGxpc3QgbW92ZWQgaXMgcHJlY2lzZWx5IHRoZSBzaWxlbnQgZmFpbHVyZSBpdCBleGlzdHMgdG8gcHJldmVudC5cbiAqXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHRvIHRoZSBjb21waWxlZCBwYXR0ZXJucy5cbiAqIEB0aHJvd3MgSWYgdGhlIG5hbWVkIGZpbGUgY2Fubm90IGJlIHJlYWQsIG9yIG9uZSBvZiBpdHMgbGluZXMgaXMgbm90IGEgdmFsaWQgcmVndWxhciBleHByZXNzaW9uLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gcmVhZEZvcmJpZGRlblBhdHRlcm5zKCk6IFByb21pc2U8UmVnRXhwW10+IHtcbiAgbG9hZEVudkZpbGVJZkV4aXN0cygpO1xuICBjb25zdCBmaWxlUGF0aCA9IChwcm9jZXNzLmVudltGT1JCSURERU5fUEFUVEVSTlNfRklMRV9FTlZfVkFSSUFCTEVdID8/ICcnKS50cmltKCk7XG4gIGlmIChmaWxlUGF0aCA9PT0gJycpIHtcbiAgICByZXR1cm4gW107XG4gIH1cblxuICBsZXQgY29udGVudDogc3RyaW5nO1xuICB0cnkge1xuICAgIGNvbnRlbnQgPSBhd2FpdCByZWFkRmlsZShmaWxlUGF0aCwgJ3V0Zi04Jyk7XG4gIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGAke0ZPUkJJRERFTl9QQVRURVJOU19GSUxFX0VOVl9WQVJJQUJMRX0gbmFtZXMgJHtmaWxlUGF0aH0sIHdoaWNoIGNhbm5vdCBiZSByZWFkLmAsIHsgY2F1c2U6IGVycm9yIH0pO1xuICB9XG5cbiAgY29uc3QgcGF0dGVybnM6IFJlZ0V4cFtdID0gW107XG4gIGZvciAoY29uc3QgW2luZGV4LCByYXdMaW5lXSBvZiBjb250ZW50LnNwbGl0KC9cXHI/XFxuLykuZW50cmllcygpKSB7XG4gICAgY29uc3QgbGluZSA9IHJhd0xpbmUudHJpbSgpO1xuICAgIGlmIChsaW5lID09PSAnJyB8fCBsaW5lLnN0YXJ0c1dpdGgoJyMnKSkge1xuICAgICAgY29udGludWU7XG4gICAgfVxuXG4gICAgdHJ5IHtcbiAgICAgIHBhdHRlcm5zLnB1c2godG9SZWdFeHAobGluZSkpO1xuICAgIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYExpbmUgJHtTdHJpbmcoaW5kZXggKyAxKX0gb2YgdGhlIGZvcmJpZGRlbi1wYXR0ZXJucyBmaWxlICR7ZmlsZVBhdGh9IGlzIG5vdCBhIHZhbGlkIHJlZ3VsYXIgZXhwcmVzc2lvbi5gLCB7IGNhdXNlOiBlcnJvciB9KTtcbiAgICB9XG4gIH1cblxuICByZXR1cm4gcGF0dGVybnM7XG59XG5cbmZ1bmN0aW9uIHRvUmVnRXhwKGxpbmU6IHN0cmluZyk6IFJlZ0V4cCB7XG4gIGNvbnN0IGdyb3VwcyA9IFJFR19FWFBfTElURVJBTF9SRUdfRVhQLmV4ZWMobGluZSk/Lmdyb3VwcztcbiAgaWYgKCFncm91cHMpIHtcbiAgICByZXR1cm4gbmV3IFJlZ0V4cChsaW5lKTtcbiAgfVxuXG4gIGNvbnN0IHNvdXJjZSA9IGVuc3VyZU5vbk51bGxhYmxlKGdyb3Vwc1snc291cmNlJ10pO1xuICBjb25zdCBmbGFncyA9IGVuc3VyZU5vbk51bGxhYmxlKGdyb3Vwc1snZmxhZ3MnXSk7XG4gIHJldHVybiBuZXcgUmVnRXhwKHNvdXJjZSwgZmxhZ3MucmVwbGFjZUFsbChTVEFURUZVTF9GTEFHU19SRUdfRVhQLCAnJykpO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFvQkEsU0FBUyx5QkFBeUI7QUFDbEMsU0FBUyxnQkFBZ0I7QUFDekIsT0FBTyxhQUFhO0FBRXBCLFNBQVMsMkJBQTJCO0FBSzdCLE1BQU0sdUNBQXVDO0FBaUJwRCxNQUFNLDBCQUEwQjtBQUNoQyxNQUFNLHlCQUF5QjtBQVN4QixTQUFTLDRCQUE0QixNQUFjLFVBQXNEO0FBQzlHLFFBQU0sVUFBbUMsQ0FBQztBQUUxQyxhQUFXLFFBQVEsS0FBSyxNQUFNLE9BQU8sR0FBRztBQUN0QyxlQUFXLFdBQVcsVUFBVTtBQUM5QixZQUFNLFFBQVEsUUFBUSxLQUFLLElBQUk7QUFDL0IsVUFBSSxPQUFPO0FBQ1QsZ0JBQVEsS0FBSyxFQUFFLE1BQU0sT0FBTyxNQUFNLENBQUMsRUFBRSxDQUFDO0FBQ3RDO0FBQUEsTUFDRjtBQUFBLElBQ0Y7QUFBQSxFQUNGO0FBRUEsU0FBTztBQUNUO0FBYUEsZUFBc0Isd0JBQTJDO0FBQy9ELHNCQUFvQjtBQUNwQixRQUFNLFlBQVksUUFBUSxJQUFJLG9DQUFvQyxLQUFLLElBQUksS0FBSztBQUNoRixNQUFJLGFBQWEsSUFBSTtBQUNuQixXQUFPLENBQUM7QUFBQSxFQUNWO0FBRUEsTUFBSTtBQUNKLE1BQUk7QUFDRixjQUFVLE1BQU0sU0FBUyxVQUFVLE9BQU87QUFBQSxFQUM1QyxTQUFTLE9BQU87QUFDZCxVQUFNLElBQUksTUFBTSxHQUFHLG9DQUFvQyxVQUFVLFFBQVEsMkJBQTJCLEVBQUUsT0FBTyxNQUFNLENBQUM7QUFBQSxFQUN0SDtBQUVBLFFBQU0sV0FBcUIsQ0FBQztBQUM1QixhQUFXLENBQUMsT0FBTyxPQUFPLEtBQUssUUFBUSxNQUFNLE9BQU8sRUFBRSxRQUFRLEdBQUc7QUFDL0QsVUFBTSxPQUFPLFFBQVEsS0FBSztBQUMxQixRQUFJLFNBQVMsTUFBTSxLQUFLLFdBQVcsR0FBRyxHQUFHO0FBQ3ZDO0FBQUEsSUFDRjtBQUVBLFFBQUk7QUFDRixlQUFTLEtBQUssU0FBUyxJQUFJLENBQUM7QUFBQSxJQUM5QixTQUFTLE9BQU87QUFDZCxZQUFNLElBQUksTUFBTSxRQUFRLE9BQU8sUUFBUSxDQUFDLENBQUMsbUNBQW1DLFFBQVEsdUNBQXVDLEVBQUUsT0FBTyxNQUFNLENBQUM7QUFBQSxJQUM3STtBQUFBLEVBQ0Y7QUFFQSxTQUFPO0FBQ1Q7QUFFQSxTQUFTLFNBQVMsTUFBc0I7QUFDdEMsUUFBTSxTQUFTLHdCQUF3QixLQUFLLElBQUksR0FBRztBQUNuRCxNQUFJLENBQUMsUUFBUTtBQUNYLFdBQU8sSUFBSSxPQUFPLElBQUk7QUFBQSxFQUN4QjtBQUVBLFFBQU0sU0FBUyxrQkFBa0IsT0FBTyxRQUFRLENBQUM7QUFDakQsUUFBTSxRQUFRLGtCQUFrQixPQUFPLE9BQU8sQ0FBQztBQUMvQyxTQUFPLElBQUksT0FBTyxRQUFRLE1BQU0sV0FBVyx3QkFBd0IsRUFBRSxDQUFDO0FBQ3hFOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/esm/formatters/dprint.d.mts

@@ -0,0 +1,33 @@
+/// <reference path="../index.d.mts" />
+/**
+ * @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/esm/formatters/dprint.mjs

@@ -0,0 +1,75 @@
+/*
+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 { assertNonNullable } from "@mnaoumov/typescript-lib/type-guards";
+import { existsSync } from "node:fs";
+import { resolveToolCommand } from "../package-manager.mjs";
+import { RepoPaths } from "../repo-paths.mjs";
+import {
+  execFromRoot,
+  getRootFolder,
+  resolvePathFromRootSafe
+} from "../root.mjs";
+async function format(options) {
+  const { defaultConfigFilePath, paths, rewrite = true } = options ?? {};
+  const rootFolder = getRootFolder();
+  assertNonNullable(rootFolder, "Root folder not found");
+  let dprintJsonPath = resolvePathFromRootSafe({ path: RepoPaths.DprintJson });
+  if (!existsSync(dprintJsonPath) && defaultConfigFilePath) {
+    dprintJsonPath = defaultConfigFilePath;
+  }
+  if (!existsSync(dprintJsonPath)) {
+    throw new Error("dprint.json not found");
+  }
+  const command = rewrite ? "fmt" : "check";
+  const targets = paths?.length ? paths : ["**/*"];
+  await execFromRoot([...resolveToolCommand({ tool: "dprint" }), command, "--config", dprintJsonPath, { batchedArguments: targets }]);
+}
+export {
+  format
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2Zvcm1hdHRlcnMvZHByaW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogRm9ybWF0IHRoZSBzb3VyY2UgY29kZS5cbiAqL1xuXG5pbXBvcnQgeyBhc3NlcnROb25OdWxsYWJsZSB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi90eXBlLWd1YXJkcyc7XG5pbXBvcnQgeyBleGlzdHNTeW5jIH0gZnJvbSAnbm9kZTpmcyc7XG5cbmltcG9ydCB7IHJlc29sdmVUb29sQ29tbWFuZCB9IGZyb20gJy4uL3BhY2thZ2UtbWFuYWdlci50cyc7XG5pbXBvcnQgeyBSZXBvUGF0aHMgfSBmcm9tICcuLi9yZXBvLXBhdGhzLnRzJztcbmltcG9ydCB7XG4gIGV4ZWNGcm9tUm9vdCxcbiAgZ2V0Um9vdEZvbGRlcixcbiAgcmVzb2x2ZVBhdGhGcm9tUm9vdFNhZmVcbn0gZnJvbSAnLi4vcm9vdC50cyc7XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3IgdGhlIHtAbGluayBmb3JtYXR9IGZ1bmN0aW9uLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEZvcm1hdE9wdGlvbnMge1xuICAvKipcbiAgICogVGhlIGBkcHJpbnQuanNvbmAgdXNlZCB3aGVuIHRoZSBwcm9qZWN0IGhhcyBub25lIG9mIGl0cyBvd24uIFdpdGhvdXQgaXQsIGEgcHJvamVjdCB3aXRoIG5vIGBkcHJpbnQuanNvbmBcbiAgICogZmFpbHMuXG4gICAqL1xuICByZWFkb25seSBkZWZhdWx0Q29uZmlnRmlsZVBhdGg/OiBzdHJpbmcgfCB1bmRlZmluZWQ7XG5cbiAgLyoqXG4gICAqIE9wdGlvbmFsIGZpbGUgcGF0aHMgdG8gZm9ybWF0LiBJZiBvbWl0dGVkLCBmb3JtYXRzIHRoZSBlbnRpcmUgcHJvamVjdC5cbiAgICovXG4gIHJlYWRvbmx5IHBhdGhzPzogc3RyaW5nW10gfCB1bmRlZmluZWQ7XG5cbiAgLyoqXG4gICAqIFdoZXRoZXIgdG8gcmV3cml0ZSB0aGUgc291cmNlIGNvZGUuXG4gICAqXG4gICAqIEBkZWZhdWx0IGB0cnVlYFxuICAgKi9cbiAgcmVhZG9ubHkgcmV3cml0ZT86IGJvb2xlYW4gfCB1bmRlZmluZWQ7XG59XG5cbi8qKlxuICogRm9ybWF0IHRoZSBzb3VyY2UgY29kZS5cbiAqXG4gKiBAcGFyYW0gb3B0aW9ucyAtIFRoZSB7QGxpbmsgRm9ybWF0T3B0aW9uc30uXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdoZW4gdGhlIHNvdXJjZSBjb2RlIGhhcyBiZWVuIGZvcm1hdHRlZC5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGZvcm1hdChvcHRpb25zPzogRm9ybWF0T3B0aW9ucyk6IFByb21pc2U8dm9pZD4ge1xuICBjb25zdCB7IGRlZmF1bHRDb25maWdGaWxlUGF0aCwgcGF0aHMsIHJld3JpdGUgPSB0cnVlIH0gPSBvcHRpb25zID8/IHt9O1xuICBjb25zdCByb290Rm9sZGVyID0gZ2V0Um9vdEZvbGRlcigpO1xuICBhc3NlcnROb25OdWxsYWJsZShyb290Rm9sZGVyLCAnUm9vdCBmb2xkZXIgbm90IGZvdW5kJyk7XG4gIGxldCBkcHJpbnRKc29uUGF0aCA9IHJlc29sdmVQYXRoRnJvbVJvb3RTYWZlKHsgcGF0aDogUmVwb1BhdGhzLkRwcmludEpzb24gfSk7XG4gIGlmICghZXhpc3RzU3luYyhkcHJpbnRKc29uUGF0aCkgJiYgZGVmYXVsdENvbmZpZ0ZpbGVQYXRoKSB7XG4gICAgZHByaW50SnNvblBhdGggPSBkZWZhdWx0Q29uZmlnRmlsZVBhdGg7XG4gIH1cblxuICBpZiAoIWV4aXN0c1N5bmMoZHByaW50SnNvblBhdGgpKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKCdkcHJpbnQuanNvbiBub3QgZm91bmQnKTtcbiAgfVxuXG4gIGNvbnN0IGNvbW1hbmQgPSByZXdyaXRlID8gJ2ZtdCcgOiAnY2hlY2snO1xuICAvKiB2OCBpZ25vcmUgc3RhcnQgLS0gVGhlIHBhdGhzLXByb3ZpZGVkIGJyYW5jaCBpcyBvbmx5IGV4ZXJjaXNlZCBieSBjb25zdW1lciBwcm9qZWN0cyBwYXNzaW5nIGZpbGUgbGlzdHMuICovXG4gIGNvbnN0IHRhcmdldHMgPSBwYXRocz8ubGVuZ3RoID8gcGF0aHMgOiBbJyoqLyonXTtcbiAgLyogdjggaWdub3JlIHN0b3AgKi9cbiAgYXdhaXQgZXhlY0Zyb21Sb290KFsuLi5yZXNvbHZlVG9vbENvbW1hbmQoeyB0b29sOiAnZHByaW50JyB9KSwgY29tbWFuZCwgJy0tY29uZmlnJywgZHByaW50SnNvblBhdGgsIHsgYmF0Y2hlZEFyZ3VtZW50czogdGFyZ2V0cyB9XSk7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQU1BLFNBQVMseUJBQXlCO0FBQ2xDLFNBQVMsa0JBQWtCO0FBRTNCLFNBQVMsMEJBQTBCO0FBQ25DLFNBQVMsaUJBQWlCO0FBQzFCO0FBQUEsRUFDRTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsT0FDSztBQStCUCxlQUFzQixPQUFPLFNBQXdDO0FBQ25FLFFBQU0sRUFBRSx1QkFBdUIsT0FBTyxVQUFVLEtBQUssSUFBSSxXQUFXLENBQUM7QUFDckUsUUFBTSxhQUFhLGNBQWM7QUFDakMsb0JBQWtCLFlBQVksdUJBQXVCO0FBQ3JELE1BQUksaUJBQWlCLHdCQUF3QixFQUFFLE1BQU0sVUFBVSxXQUFXLENBQUM7QUFDM0UsTUFBSSxDQUFDLFdBQVcsY0FBYyxLQUFLLHVCQUF1QjtBQUN4RCxxQkFBaUI7QUFBQSxFQUNuQjtBQUVBLE1BQUksQ0FBQyxXQUFXLGNBQWMsR0FBRztBQUMvQixVQUFNLElBQUksTUFBTSx1QkFBdUI7QUFBQSxFQUN6QztBQUVBLFFBQU0sVUFBVSxVQUFVLFFBQVE7QUFFbEMsUUFBTSxVQUFVLE9BQU8sU0FBUyxRQUFRLENBQUMsTUFBTTtBQUUvQyxRQUFNLGFBQWEsQ0FBQyxHQUFHLG1CQUFtQixFQUFFLE1BQU0sU0FBUyxDQUFDLEdBQUcsU0FBUyxZQUFZLGdCQUFnQixFQUFFLGtCQUFrQixRQUFRLENBQUMsQ0FBQztBQUNwSTsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/formatters/index.d.mts

@@ -0,0 +1,2 @@
+/// <reference path="../index.d.mts" />
+export * as 'dprint' from './dprint.mjs';

package/dist/lib/esm/formatters/index.mjs

@@ -0,0 +1,52 @@
+/*
+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 * as dprint from "./dprint.mjs";
+export {
+  dprint
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2Zvcm1hdHRlcnMvaW5kZXgudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qIFRISVMgSVMgQSBHRU5FUkFURUQvQlVORExFRCBGSUxFIEJZIEJVSUxEIFNDUklQVCAqL1xuXG5leHBvcnQgKiBhcyAnZHByaW50JyBmcm9tICcuL2RwcmludC50cyc7XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUVBLFlBQVksWUFBYzsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/fs.d.mts

@@ -0,0 +1,80 @@
+/// <reference path="./index.d.mts" />
+/**
+ * @file
+ *
+ * Contains utility functions for file system operations.
+ */
+import type { Dirent, ObjectEncodingOptions, PathLike } from 'node:fs';
+/**
+ * Options for controlling the format of the result when returning buffers.
+ *
+ * `directory` is used instead of `folder` to preserve compatibility with `node:fs` module.
+ */
+export type BufferResultOptions = 'buffer' | BufferResultObjectOptions;
+/**
+ * Options for controlling the format of the result when returning Dirent objects.
+ */
+export type DirentResultOptions = DirentResultBaseOptions & ObjectEncodingOptions;
+/**
+ * Options for controlling the format of the result when returning strings.
+ */
+export type StringResultOptions = ObjectEncodingOptions & StringResultBaseOptions | undefined;
+interface BufferResultObjectOptions {
+    /**
+     * Should be set to "buffer" to return buffers.
+     */
+    readonly encoding: 'buffer';
+    /**
+     * Whether to include subdirectories when reading the directory. If not provided, defaults to `false`.
+     */
+    readonly recursive?: boolean;
+    /**
+     * Should be set to `false` to return buffers.
+     */
+    readonly withFileTypes?: false;
+}
+interface DirentResultBaseOptions {
+    /**
+     * Whether to include subdirectories when reading the directory. If not provided, defaults to `false`.
+     */
+    readonly recursive?: boolean;
+    /**
+     * Should be set to `true` to return Dirent objects.
+     */
+    readonly withFileTypes: true;
+}
+interface StringResultBaseOptions {
+    /**
+     * Whether to include subdirectories when reading the directory. If not provided, defaults to `false`.
+     */
+    readonly recursive?: boolean;
+    /**
+     * Should be set to `false` to return strings.
+     */
+    readonly withFileTypes?: false;
+}
+/**
+ * Reads the contents of a directory and returns an array of strings with POSIX paths.
+ *
+ * @param path - The path to the directory.
+ * @param options - Options to control the format of the result. If not provided, returns strings.
+ * @returns A {@link Promise} that resolves with an array of POSIX-formatted file paths.
+ */
+export declare function readdirPosix(path: PathLike, options?: StringResultOptions): Promise<string[]>;
+/**
+ * Reads the contents of a directory and returns an array of buffers with POSIX paths.
+ *
+ * @param path - The path to the directory.
+ * @param options - Options to control the format of the result. Specify "buffer" to return buffers.
+ * @returns A {@link Promise} that resolves with an array of POSIX-formatted buffers.
+ */
+export declare function readdirPosix(path: PathLike, options: BufferResultOptions): Promise<Buffer[]>;
+/**
+ * Reads the contents of a directory and returns an array of Dirent objects with POSIX paths.
+ *
+ * @param path - The path to the directory.
+ * @param options - Options to control the format of the result. Specify `withFileTypes: true` to return Dirent objects.
+ * @returns A {@link Promise} that resolves with an array of POSIX-formatted Dirent objects.
+ */
+export declare function readdirPosix(path: PathLike, options: DirentResultOptions): Promise<Dirent[]>;
+export {};

package/dist/lib/esm/fs.mjs

@@ -0,0 +1,89 @@
+/*
+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 {
+  toPosixBuffer,
+  toPosixPath
+} from "@mnaoumov/typescript-lib/path";
+import { assertNonNullable } from "@mnaoumov/typescript-lib/type-guards";
+import { readdir } from "node:fs/promises";
+async function readdirPosix(path, options = {}) {
+  if (isStringResultOptions(options)) {
+    const paths = await readdir(path, options);
+    return paths.map((entryPath) => toPosixPath(entryPath));
+  }
+  if (isBufferResultOptions(options)) {
+    const buffers = await readdir(path, options);
+    return buffers.map((buffer) => toPosixBuffer(buffer));
+  }
+  const dirents = await readdir(path, options);
+  for (const dirent of dirents) {
+    dirent.name = toPosixPath(dirent.name);
+    dirent.parentPath = toPosixPath(dirent.parentPath);
+  }
+  return dirents;
+}
+function isBufferResultOptions(options) {
+  assertNonNullable(options);
+  if (options === "buffer") {
+    return true;
+  }
+  const commonOptions = options;
+  return commonOptions.withFileTypes !== true && commonOptions.encoding === "buffer";
+}
+function isStringResultOptions(options) {
+  assertNonNullable(options);
+  if (options === "buffer") {
+    return false;
+  }
+  const commonOptions = options;
+  return !(commonOptions.encoding === "buffer" || commonOptions.withFileTypes === true);
+}
+export {
+  readdirPosix
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2ZzLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29udGFpbnMgdXRpbGl0eSBmdW5jdGlvbnMgZm9yIGZpbGUgc3lzdGVtIG9wZXJhdGlvbnMuXG4gKi9cblxuaW1wb3J0IHR5cGUge1xuICBEaXJlbnQsXG4gIE9iamVjdEVuY29kaW5nT3B0aW9ucyxcbiAgUGF0aExpa2Vcbn0gZnJvbSAnbm9kZTpmcyc7XG5cbmltcG9ydCB7XG4gIHRvUG9zaXhCdWZmZXIsXG4gIHRvUG9zaXhQYXRoXG59IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9wYXRoJztcbmltcG9ydCB7IGFzc2VydE5vbk51bGxhYmxlIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL3R5cGUtZ3VhcmRzJztcbmltcG9ydCB7IHJlYWRkaXIgfSBmcm9tICdub2RlOmZzL3Byb21pc2VzJztcblxuLyoqXG4gKiBPcHRpb25zIGZvciBjb250cm9sbGluZyB0aGUgZm9ybWF0IG9mIHRoZSByZXN1bHQgd2hlbiByZXR1cm5pbmcgYnVmZmVycy5cbiAqXG4gKiBgZGlyZWN0b3J5YCBpcyB1c2VkIGluc3RlYWQgb2YgYGZvbGRlcmAgdG8gcHJlc2VydmUgY29tcGF0aWJpbGl0eSB3aXRoIGBub2RlOmZzYCBtb2R1bGUuXG4gKi9cbmV4cG9ydCB0eXBlIEJ1ZmZlclJlc3VsdE9wdGlvbnMgPSAnYnVmZmVyJyB8IEJ1ZmZlclJlc3VsdE9iamVjdE9wdGlvbnM7XG5cbi8qKlxuICogT3B0aW9ucyBmb3IgY29udHJvbGxpbmcgdGhlIGZvcm1hdCBvZiB0aGUgcmVzdWx0IHdoZW4gcmV0dXJuaW5nIERpcmVudCBvYmplY3RzLlxuICovXG5leHBvcnQgdHlwZSBEaXJlbnRSZXN1bHRPcHRpb25zID0gRGlyZW50UmVzdWx0QmFzZU9wdGlvbnMgJiBPYmplY3RFbmNvZGluZ09wdGlvbnM7XG5cbi8qKlxuICogT3B0aW9ucyBmb3IgY29udHJvbGxpbmcgdGhlIGZvcm1hdCBvZiB0aGUgcmVzdWx0IHdoZW4gcmV0dXJuaW5nIHN0cmluZ3MuXG4gKi9cbmV4cG9ydCB0eXBlIFN0cmluZ1Jlc3VsdE9wdGlvbnMgPVxuICB8IE9iamVjdEVuY29kaW5nT3B0aW9ucyAmIFN0cmluZ1Jlc3VsdEJhc2VPcHRpb25zXG4gIHwgdW5kZWZpbmVkO1xuXG5pbnRlcmZhY2UgQnVmZmVyUmVzdWx0T2JqZWN0T3B0aW9ucyB7XG4gIC8qKlxuICAgKiBTaG91bGQgYmUgc2V0IHRvIFwiYnVmZmVyXCIgdG8gcmV0dXJuIGJ1ZmZlcnMuXG4gICAqL1xuICByZWFkb25seSBlbmNvZGluZzogJ2J1ZmZlcic7XG5cbiAgLyoqXG4gICAqIFdoZXRoZXIgdG8gaW5jbHVkZSBzdWJkaXJlY3RvcmllcyB3aGVuIHJlYWRpbmcgdGhlIGRpcmVjdG9yeS4gSWYgbm90IHByb3ZpZGVkLCBkZWZhdWx0cyB0byBgZmFsc2VgLlxuICAgKi9cbiAgcmVhZG9ubHkgcmVjdXJzaXZlPzogYm9vbGVhbjtcblxuICAvKipcbiAgICogU2hvdWxkIGJlIHNldCB0byBgZmFsc2VgIHRvIHJldHVybiBidWZmZXJzLlxuICAgKi9cbiAgcmVhZG9ubHkgd2l0aEZpbGVUeXBlcz86IGZhbHNlO1xufVxuXG4vKipcbiAqIENvbW1vbiBvcHRpb25zIGZvciBjb250cm9sbGluZyB0aGUgZm9ybWF0IG9mIHRoZSByZXN1bHQuXG4gKi9cbmludGVyZmFjZSBDb21tb25PcHRpb25zIHtcbiAgLyoqXG4gICAqIEVuY29kaW5nIHRvIHVzZSB3aGVuIHJldHVybmluZyBzdHJpbmdzLlxuICAgKi9cbiAgcmVhZG9ubHkgZW5jb2Rpbmc/OiAnYnVmZmVyJyB8IE5vZGVKUy5CdWZmZXJFbmNvZGluZztcblxuICAvKipcbiAgICogU2V0IGB0cnVlYCB0byByZXR1cm4gRGlyZW50IG9iamVjdHMgb3IgYGZhbHNlYCB0byByZXR1cm4gc3RyaW5ncyBvciBidWZmZXJzLlxuICAgKi9cbiAgcmVhZG9ubHkgd2l0aEZpbGVUeXBlcz86IGJvb2xlYW47XG59XG5cbmludGVyZmFjZSBEaXJlbnRSZXN1bHRCYXNlT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBXaGV0aGVyIHRvIGluY2x1ZGUgc3ViZGlyZWN0b3JpZXMgd2hlbiByZWFkaW5nIHRoZSBkaXJlY3RvcnkuIElmIG5vdCBwcm92aWRlZCwgZGVmYXVsdHMgdG8gYGZhbHNlYC5cbiAgICovXG4gIHJlYWRvbmx5IHJlY3Vyc2l2ZT86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIFNob3VsZCBiZSBzZXQgdG8gYHRydWVgIHRvIHJldHVybiBEaXJlbnQgb2JqZWN0cy5cbiAgICovXG4gIHJlYWRvbmx5IHdpdGhGaWxlVHlwZXM6IHRydWU7XG59XG5cbmludGVyZmFjZSBTdHJpbmdSZXN1bHRCYXNlT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBXaGV0aGVyIHRvIGluY2x1ZGUgc3ViZGlyZWN0b3JpZXMgd2hlbiByZWFkaW5nIHRoZSBkaXJlY3RvcnkuIElmIG5vdCBwcm92aWRlZCwgZGVmYXVsdHMgdG8gYGZhbHNlYC5cbiAgICovXG4gIHJlYWRvbmx5IHJlY3Vyc2l2ZT86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIFNob3VsZCBiZSBzZXQgdG8gYGZhbHNlYCB0byByZXR1cm4gc3RyaW5ncy5cbiAgICovXG4gIHJlYWRvbmx5IHdpdGhGaWxlVHlwZXM/OiBmYWxzZTtcbn1cblxuLyoqXG4gKiBSZWFkcyB0aGUgY29udGVudHMgb2YgYSBkaXJlY3RvcnkgYW5kIHJldHVybnMgYW4gYXJyYXkgb2Ygc3RyaW5ncyB3aXRoIFBPU0lYIHBhdGhzLlxuICpcbiAqIEBwYXJhbSBwYXRoIC0gVGhlIHBhdGggdG8gdGhlIGRpcmVjdG9yeS5cbiAqIEBwYXJhbSBvcHRpb25zIC0gT3B0aW9ucyB0byBjb250cm9sIHRoZSBmb3JtYXQgb2YgdGhlIHJlc3VsdC4gSWYgbm90IHByb3ZpZGVkLCByZXR1cm5zIHN0cmluZ3MuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdpdGggYW4gYXJyYXkgb2YgUE9TSVgtZm9ybWF0dGVkIGZpbGUgcGF0aHMuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiByZWFkZGlyUG9zaXgocGF0aDogUGF0aExpa2UsIG9wdGlvbnM/OiBTdHJpbmdSZXN1bHRPcHRpb25zKTogUHJvbWlzZTxzdHJpbmdbXT47XG4vKipcbiAqIFJlYWRzIHRoZSBjb250ZW50cyBvZiBhIGRpcmVjdG9yeSBhbmQgcmV0dXJucyBhbiBhcnJheSBvZiBidWZmZXJzIHdpdGggUE9TSVggcGF0aHMuXG4gKlxuICogQHBhcmFtIHBhdGggLSBUaGUgcGF0aCB0byB0aGUgZGlyZWN0b3J5LlxuICogQHBhcmFtIG9wdGlvbnMgLSBPcHRpb25zIHRvIGNvbnRyb2wgdGhlIGZvcm1hdCBvZiB0aGUgcmVzdWx0LiBTcGVjaWZ5IFwiYnVmZmVyXCIgdG8gcmV0dXJuIGJ1ZmZlcnMuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdpdGggYW4gYXJyYXkgb2YgUE9TSVgtZm9ybWF0dGVkIGJ1ZmZlcnMuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiByZWFkZGlyUG9zaXgocGF0aDogUGF0aExpa2UsIG9wdGlvbnM6IEJ1ZmZlclJlc3VsdE9wdGlvbnMpOiBQcm9taXNlPEJ1ZmZlcltdPjtcbi8qKlxuICogUmVhZHMgdGhlIGNvbnRlbnRzIG9mIGEgZGlyZWN0b3J5IGFuZCByZXR1cm5zIGFuIGFycmF5IG9mIERpcmVudCBvYmplY3RzIHdpdGggUE9TSVggcGF0aHMuXG4gKlxuICogQHBhcmFtIHBhdGggLSBUaGUgcGF0aCB0byB0aGUgZGlyZWN0b3J5LlxuICogQHBhcmFtIG9wdGlvbnMgLSBPcHRpb25zIHRvIGNvbnRyb2wgdGhlIGZvcm1hdCBvZiB0aGUgcmVzdWx0LiBTcGVjaWZ5IGB3aXRoRmlsZVR5cGVzOiB0cnVlYCB0byByZXR1cm4gRGlyZW50IG9iamVjdHMuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdpdGggYW4gYXJyYXkgb2YgUE9TSVgtZm9ybWF0dGVkIERpcmVudCBvYmplY3RzLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gcmVhZGRpclBvc2l4KHBhdGg6IFBhdGhMaWtlLCBvcHRpb25zOiBEaXJlbnRSZXN1bHRPcHRpb25zKTogUHJvbWlzZTxEaXJlbnRbXT47XG4vKipcbiAqIFJlYWRzIHRoZSBjb250ZW50cyBvZiBhIGRpcmVjdG9yeSBhbmQgY29udmVydHMgZmlsZSBwYXRocyBvciBidWZmZXIgcmVzdWx0cyB0byBQT1NJWCBmb3JtYXQuXG4gKlxuICogQHBhcmFtIHBhdGggLSBUaGUgcGF0aCB0byB0aGUgZGlyZWN0b3J5LlxuICogQHBhcmFtIG9wdGlvbnMgLSBPcHRpb25zIHRvIGNvbnRyb2wgdGhlIGZvcm1hdCBvZiB0aGUgcmVzdWx0LlxuICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyB3aXRoIGFuIGFycmF5IG9mIFBPU0lYLWZvcm1hdHRlZCBmaWxlIHBhdGhzLCBidWZmZXJzLCBvciBEaXJlbnQgb2JqZWN0cy5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIHJlYWRkaXJQb3NpeChcbiAgcGF0aDogUGF0aExpa2UsXG4gIG9wdGlvbnM6IEJ1ZmZlclJlc3VsdE9wdGlvbnMgfCBEaXJlbnRSZXN1bHRPcHRpb25zIHwgU3RyaW5nUmVzdWx0T3B0aW9ucyA9IHt9XG4pOiBQcm9taXNlPEJ1ZmZlcltdIHwgRGlyZW50W10gfCBzdHJpbmdbXT4ge1xuICBpZiAoaXNTdHJpbmdSZXN1bHRPcHRpb25zKG9wdGlvbnMpKSB7XG4gICAgY29uc3QgcGF0aHMgPSBhd2FpdCByZWFkZGlyKHBhdGgsIG9wdGlvbnMpO1xuICAgIHJldHVybiBwYXRocy5tYXAoKGVudHJ5UGF0aCkgPT4gdG9Qb3NpeFBhdGgoZW50cnlQYXRoKSk7XG4gIH1cblxuICBpZiAoaXNCdWZmZXJSZXN1bHRPcHRpb25zKG9wdGlvbnMpKSB7XG4gICAgY29uc3QgYnVmZmVycyA9IGF3YWl0IHJlYWRkaXIocGF0aCwgb3B0aW9ucyk7XG4gICAgcmV0dXJuIGJ1ZmZlcnMubWFwKChidWZmZXIpID0+IHRvUG9zaXhCdWZmZXIoYnVmZmVyKSk7XG4gIH1cblxuICBjb25zdCBkaXJlbnRzID0gYXdhaXQgcmVhZGRpcihwYXRoLCBvcHRpb25zKTtcbiAgZm9yIChjb25zdCBkaXJlbnQgb2YgZGlyZW50cykge1xuICAgIGRpcmVudC5uYW1lID0gdG9Qb3NpeFBhdGgoZGlyZW50Lm5hbWUpO1xuICAgIGRpcmVudC5wYXJlbnRQYXRoID0gdG9Qb3NpeFBhdGgoZGlyZW50LnBhcmVudFBhdGgpO1xuICB9XG5cbiAgcmV0dXJuIGRpcmVudHM7XG59XG5cbi8qKlxuICogVHlwZSBndWFyZCB0byBjaGVjayBpZiB0aGUgb3B0aW9ucyBhcmUgZm9yIHJldHVybmluZyBidWZmZXJzLlxuICpcbiAqIEBwYXJhbSBvcHRpb25zIC0gVGhlIG9wdGlvbnMgdG8gY2hlY2suXG4gKiBAcmV0dXJucyBgdHJ1ZWAgaWYgdGhlIG9wdGlvbnMgYXJlIGZvciByZXR1cm5pbmcgYnVmZmVycywgb3RoZXJ3aXNlIGBmYWxzZWAuXG4gKi9cbmZ1bmN0aW9uIGlzQnVmZmVyUmVzdWx0T3B0aW9ucyhvcHRpb25zOiBCdWZmZXJSZXN1bHRPcHRpb25zIHwgRGlyZW50UmVzdWx0T3B0aW9ucyB8IFN0cmluZ1Jlc3VsdE9wdGlvbnMpOiBvcHRpb25zIGlzIEJ1ZmZlclJlc3VsdE9wdGlvbnMge1xuICBhc3NlcnROb25OdWxsYWJsZShvcHRpb25zKTtcblxuICBpZiAob3B0aW9ucyA9PT0gJ2J1ZmZlcicpIHtcbiAgICByZXR1cm4gdHJ1ZTtcbiAgfVxuXG4gIGNvbnN0IGNvbW1vbk9wdGlvbnMgPSBvcHRpb25zIGFzIENvbW1vbk9wdGlvbnM7XG5cbiAgLy8gVGhlIGVuY29kaW5nIGNoZWNrIG5ldmVyIGZhaWxzIGluIHByYWN0aWNlOiBpc1N0cmluZ1Jlc3VsdE9wdGlvbnMgYWxyZWFkeSBoYW5kbGVzIG5vbi1idWZmZXIgZW5jb2RpbmcgYmVmb3JlIHRoaXMgaXMgY2FsbGVkLlxuICByZXR1cm4gY29tbW9uT3B0aW9ucy53aXRoRmlsZVR5cGVzICE9PSB0cnVlICYmIGNvbW1vbk9wdGlvbnMuZW5jb2RpbmcgPT09ICdidWZmZXInO1xufVxuXG4vKipcbiAqIFR5cGUgZ3VhcmQgdG8gY2hlY2sgaWYgdGhlIG9wdGlvbnMgYXJlIGZvciByZXR1cm5pbmcgc3RyaW5ncy5cbiAqXG4gKiBAcGFyYW0gb3B0aW9ucyAtIFRoZSBvcHRpb25zIHRvIGNoZWNrLlxuICogQHJldHVybnMgYHRydWVgIGlmIHRoZSBvcHRpb25zIGFyZSBmb3IgcmV0dXJuaW5nIHN0cmluZ3MsIG90aGVyd2lzZSBgZmFsc2VgLlxuICovXG5mdW5jdGlvbiBpc1N0cmluZ1Jlc3VsdE9wdGlvbnMob3B0aW9uczogQnVmZmVyUmVzdWx0T3B0aW9ucyB8IERpcmVudFJlc3VsdE9wdGlvbnMgfCBTdHJpbmdSZXN1bHRPcHRpb25zKTogb3B0aW9ucyBpcyBTdHJpbmdSZXN1bHRPcHRpb25zIHtcbiAgYXNzZXJ0Tm9uTnVsbGFibGUob3B0aW9ucyk7XG5cbiAgaWYgKG9wdGlvbnMgPT09ICdidWZmZXInKSB7XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG5cbiAgY29uc3QgY29tbW9uT3B0aW9ucyA9IG9wdGlvbnMgYXMgQ29tbW9uT3B0aW9ucztcblxuICByZXR1cm4gISgoY29tbW9uT3B0aW9ucy5lbmNvZGluZyA9PT0gJ2J1ZmZlcicpIHx8IChjb21tb25PcHRpb25zLndpdGhGaWxlVHlwZXMgPT09IHRydWUpKTtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBWUE7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFDUCxTQUFTLHlCQUF5QjtBQUNsQyxTQUFTLGVBQWU7QUE0R3hCLGVBQXNCLGFBQ3BCLE1BQ0EsVUFBMkUsQ0FBQyxHQUNuQztBQUN6QyxNQUFJLHNCQUFzQixPQUFPLEdBQUc7QUFDbEMsVUFBTSxRQUFRLE1BQU0sUUFBUSxNQUFNLE9BQU87QUFDekMsV0FBTyxNQUFNLElBQUksQ0FBQyxjQUFjLFlBQVksU0FBUyxDQUFDO0FBQUEsRUFDeEQ7QUFFQSxNQUFJLHNCQUFzQixPQUFPLEdBQUc7QUFDbEMsVUFBTSxVQUFVLE1BQU0sUUFBUSxNQUFNLE9BQU87QUFDM0MsV0FBTyxRQUFRLElBQUksQ0FBQyxXQUFXLGNBQWMsTUFBTSxDQUFDO0FBQUEsRUFDdEQ7QUFFQSxRQUFNLFVBQVUsTUFBTSxRQUFRLE1BQU0sT0FBTztBQUMzQyxhQUFXLFVBQVUsU0FBUztBQUM1QixXQUFPLE9BQU8sWUFBWSxPQUFPLElBQUk7QUFDckMsV0FBTyxhQUFhLFlBQVksT0FBTyxVQUFVO0FBQUEsRUFDbkQ7QUFFQSxTQUFPO0FBQ1Q7QUFRQSxTQUFTLHNCQUFzQixTQUEwRztBQUN2SSxvQkFBa0IsT0FBTztBQUV6QixNQUFJLFlBQVksVUFBVTtBQUN4QixXQUFPO0FBQUEsRUFDVDtBQUVBLFFBQU0sZ0JBQWdCO0FBR3RCLFNBQU8sY0FBYyxrQkFBa0IsUUFBUSxjQUFjLGFBQWE7QUFDNUU7QUFRQSxTQUFTLHNCQUFzQixTQUEwRztBQUN2SSxvQkFBa0IsT0FBTztBQUV6QixNQUFJLFlBQVksVUFBVTtBQUN4QixXQUFPO0FBQUEsRUFDVDtBQUVBLFFBQU0sZ0JBQWdCO0FBRXRCLFNBQU8sRUFBRyxjQUFjLGFBQWEsWUFBYyxjQUFjLGtCQUFrQjtBQUNyRjsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/gate.d.mts

@@ -0,0 +1,93 @@
+/// <reference path="./index.d.mts" />
+/**
+ * @file
+ *
+ * The branch gate: the verification sequence that `updateVersion` runs as its release preflight, available
+ * as a command of its own.
+ *
+ * Four of the preflight's checks — `format:check`, `spellcheck`, `find-overexposed` and `test:coverage` —
+ * are reachable by no other routine command. So the natural branch gate (build, lint, test) can be green
+ * while the release is still going to fail, and the failure arrives at release time rather than in seconds
+ * on the branch.
+ *
+ * This module exists so the two are the same code rather than two lists that agree today: `updateVersion`
+ * calls {@link gate}, and a check added here is reachable from both. What the gate deliberately leaves to
+ * the release path is the clean-repo assertion — a branch gate is run on a dirty tree, which is the whole
+ * point of running it before committing — and the integration suite, which is the one preflight step that
+ * already has a routine command of its own (`npm run test:integration`) and so is not in the class this
+ * module exists for.
+ *
+ * The tests run ONCE, through `test:coverage` where the project defines it and through `test` otherwise.
+ * Running both, as this did until 2026-09-05, was a duplicate everywhere it mattered: a project scopes its
+ * two test scripts to the same vitest projects — every repo in this workspace passes the same `projects`
+ * array to both — so `test:coverage` is `test` plus the threshold flags, over the identical files. It buys
+ * no fail-fast either, because the coverage run fails on exactly the failures the plain run would have
+ * caught. The one thing lost is the ability to switch off only the coverage half: `TEST_COVERAGE=0` now
+ * turns off the gate's whole test step rather than demoting it to `test`.
+ */
+/**
+ * Options for {@link gate}.
+ */
+export interface GateOptions {
+    /**
+     * Whether to run the build. The build is not a verification check — it is kept in the gate because it is
+     * the only step that type-checks the project, and a green lint is not a type-check.
+     *
+     * @default `true`
+     */
+    readonly shouldBuild?: boolean;
+    /**
+     * Whether to run the verification checks. When `false`, only the build runs, which is what
+     * `npm run version -- --no-checks` does.
+     *
+     * @default `true`
+     */
+    readonly shouldRunChecks?: boolean;
+    /**
+     * Whether to run the integration test suite. Off by default, on two reasons that are about COST rather
+     * than about contention — desktop runs stopped contending in `obsidian-integration-testing` 5.0.0, which
+     * gives every run its own user-data dir and CDP port, and the Android emulator that is still shared is
+     * serialized by that package's own `android` setup lock, which waits rather than failing.
+     *
+     * The reasons that do hold: `test:integration` is the one preflight step reachable by a routine command
+     * of its own, unlike the four this gate exists for; and in a project whose suite includes an Android
+     * test it boots an AVD and an Appium server, then queues behind any other Android run for up to that
+     * lock's hour-long acquisition timeout. A command whose whole selling point is answering in seconds must
+     * not start one unasked. The release path opts in, so nothing is skipped before a publish.
+     *
+     * @default `false`
+     */
+    readonly shouldRunIntegrationTests?: boolean;
+}
+/**
+ * Runs the verification sequence that `npm run version` runs as its preflight.
+ *
+ * The order is deliberate. The lockfile check ({@link assertPackageLockIntegrity}) comes first, because it
+ * is an in-process JSON read that takes well under a second. Then come the checks that finish in seconds (`format:check`, `spellcheck`, `lint:md`) run
+ * first, so a typo fails the gate immediately instead of after the coverage run. Each step is dispatched
+ * through the package manager, so a project overriding one of these scripts gets its own version, and each
+ * step carries its own environment off switch.
+ *
+ * Every step but `build` is run with {@link npmRunOptional}, so it is skipped when the project does not define
+ * it: a project that chose no formatter, spell checker, markdown linter or linter has nothing to check there,
+ * and requiring those scripts made `npm run version` die on its first step in exactly those projects. `build`
+ * stays required, because a release with nothing built has nothing to ship. The test step is the one place that reads that skip: `test:coverage` is preferred, and
+ * `test` runs only as its fallback, so the suite is never run twice. The unit tests stay ahead of
+ * `test:integration` for the same fastest-first reason — a broken unit test should fail before an
+ * integration suite is started, not after.
+ *
+ * @param options - The {@link GateOptions} controlling which steps run.
+ * @returns A {@link Promise} that resolves when every step has passed.
+ */
+export declare function gate(options?: GateOptions): Promise<void>;
+/**
+ * Parses the command-line arguments for the gate script.
+ *
+ * The two `--no-` flags switch off steps that are on; `--integration` is the one that switches a step ON,
+ * because {@link GateOptions.shouldRunIntegrationTests} is off by default for cost. It exists so that
+ * default is a choice the caller can make per run rather than one only a programmatic caller can reach.
+ *
+ * @param $arguments - The command-line arguments to parse.
+ * @returns The parsed {@link GateOptions}.
+ */
+export declare function parseGateArguments($arguments: string[]): GateOptions;