@mnaoumov/typescript-dev-toolkit 0.0.0 → 1.0.0

package/dist/lib/esm/root.mjs

@@ -0,0 +1,115 @@
+/*
+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 { normalizeOptionalProperties } from "@mnaoumov/typescript-lib/object-utils";
+import {
+  dirname,
+  join,
+  relative,
+  resolve,
+  toPosixPath
+} from "@mnaoumov/typescript-lib/path";
+import { existsSync } from "node:fs";
+import { exec } from "./exec.mjs";
+import { RepoPaths } from "./repo-paths.mjs";
+function execFromRoot(command, options = {}) {
+  let root = getRootFolder(options.cwd);
+  if (!root) {
+    if (options.shouldFailIfCalledFromOutsideRoot ?? true) {
+      throw new Error("Could not find root folder");
+    }
+    root = options.cwd ?? process.cwd();
+  }
+  return options.shouldIncludeDetails ? exec(command, { ...options, cwd: root, shouldIncludeDetails: true }) : exec(command, { ...options, cwd: root, shouldIncludeDetails: false });
+}
+function getRootFolder(cwd) {
+  let currentFolder = toPosixPath(cwd ?? process.cwd());
+  while (currentFolder !== RepoPaths.CurrentFolder && currentFolder !== RepoPaths.RootFolder) {
+    if (existsSync(join(currentFolder, RepoPaths.PackageJson))) {
+      return toPosixPath(currentFolder);
+    }
+    currentFolder = dirname(currentFolder);
+  }
+  return null;
+}
+function resolvePathFromRoot(params) {
+  const {
+    cwd,
+    path
+  } = params;
+  const rootFolder = getRootFolder(cwd);
+  return rootFolder ? resolve(rootFolder, path) : null;
+}
+function resolvePathFromRootSafe(params) {
+  const {
+    cwd,
+    path
+  } = params;
+  return resolvePathFromRoot(normalizeOptionalProperties({ cwd, path })) ?? path;
+}
+function toRelativeFromRoot(params) {
+  const {
+    cwd
+  } = params;
+  let {
+    path
+  } = params;
+  const rootFolder = getRootFolder(cwd);
+  if (!rootFolder) {
+    return null;
+  }
+  path = toPosixPath(path);
+  return relative(rootFolder, path);
+}
+export {
+  execFromRoot,
+  getRootFolder,
+  resolvePathFromRoot,
+  resolvePathFromRootSafe,
+  toRelativeFromRoot
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3Jvb3QudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBDb250YWlucyB1dGlsaXR5IGZ1bmN0aW9ucyBmb3IgZXhlY3V0aW5nIGNvbW1hbmRzIGZyb20gdGhlIHJvb3QgZm9sZGVyIG9mIGEgcHJvamVjdCxcbiAqIHJlc29sdmluZyBwYXRocyByZWxhdGl2ZSB0byB0aGUgcm9vdC5cbiAqL1xuXG5pbXBvcnQgeyBub3JtYWxpemVPcHRpb25hbFByb3BlcnRpZXMgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvb2JqZWN0LXV0aWxzJztcbmltcG9ydCB7XG4gIGRpcm5hbWUsXG4gIGpvaW4sXG4gIHJlbGF0aXZlLFxuICByZXNvbHZlLFxuICB0b1Bvc2l4UGF0aFxufSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvcGF0aCc7XG5pbXBvcnQgeyBleGlzdHNTeW5jIH0gZnJvbSAnbm9kZTpmcyc7XG5cbmltcG9ydCB0eXBlIHtcbiAgQ29tbWFuZFBhcnQsXG4gIEV4ZWNEZXRhaWxlZE9wdGlvbnMsXG4gIEV4ZWNPcHRpb25zLFxuICBFeGVjUmVzdWx0LFxuICBFeGVjU2ltcGxlT3B0aW9uc1xufSBmcm9tICcuL2V4ZWMudHMnO1xuXG5pbXBvcnQgeyBleGVjIH0gZnJvbSAnLi9leGVjLnRzJztcbmltcG9ydCB7IFJlcG9QYXRocyB9IGZyb20gJy4vcmVwby1wYXRocy50cyc7XG5cbi8qKlxuICogT3B0aW9ucyBmb3Ige0BsaW5rIGV4ZWNGcm9tUm9vdH0uXG4gKi9cbmV4cG9ydCB0eXBlIEV4ZWNGcm9tUm9vdE9wdGlvbnMgPSBFeGVjT3B0aW9ucztcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgcmVzb2x2ZVBhdGhGcm9tUm9vdH0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUmVzb2x2ZVBhdGhGcm9tUm9vdFBhcmFtcyB7XG4gIC8qKlxuICAgKiBUaGUgY3VycmVudCB3b3JraW5nIGZvbGRlciB0byByZXNvbHZlIGZyb20uXG4gICAqL1xuICByZWFkb25seSBjd2Q/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBwYXRoIHRvIHJlc29sdmUuXG4gICAqL1xuICByZWFkb25seSBwYXRoOiBzdHJpbmc7XG59XG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHtAbGluayByZXNvbHZlUGF0aEZyb21Sb290U2FmZX0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUmVzb2x2ZVBhdGhGcm9tUm9vdFNhZmVQYXJhbXMge1xuICAvKipcbiAgICogVGhlIGN1cnJlbnQgd29ya2luZyBmb2xkZXIgdG8gcmVzb2x2ZSBmcm9tLlxuICAgKi9cbiAgcmVhZG9ubHkgY3dkPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgcGF0aCB0byByZXNvbHZlLlxuICAgKi9cbiAgcmVhZG9ubHkgcGF0aDogc3RyaW5nO1xufVxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgdG9SZWxhdGl2ZUZyb21Sb290fS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBUb1JlbGF0aXZlRnJvbVJvb3RQYXJhbXMge1xuICAvKipcbiAgICogVGhlIGN1cnJlbnQgd29ya2luZyBmb2xkZXIgdG8gcmVzb2x2ZSBmcm9tLlxuICAgKi9cbiAgcmVhZG9ubHkgY3dkPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgYWJzb2x1dGUgcGF0aCB0byBjb252ZXJ0LlxuICAgKi9cbiAgcmVhZG9ubHkgcGF0aDogc3RyaW5nO1xufVxuXG4vKipcbiAqIEV4ZWN1dGVzIGEgY29tbWFuZCBmcm9tIHRoZSByb290IGZvbGRlciBvZiB0aGUgcHJvamVjdC5cbiAqXG4gKiBAcGFyYW0gY29tbWFuZCAtIFRoZSBjb21tYW5kIHRvIGV4ZWN1dGUuIEl0IGNhbiBiZSBhIHN0cmluZyBvciBhbiBhcnJheSBvZiBzdHJpbmdzLlxuICogQHBhcmFtIG9wdGlvbnMgLSBUaGUgb3B0aW9ucyBmb3IgdGhlIGV4ZWN1dGlvbi5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgd2l0aCB0aGUgb3V0cHV0IG9mIHRoZSBjb21tYW5kLlxuICogQHRocm93cyBJZiB0aGUgY29tbWFuZCBmYWlscyB3aXRoIGEgbm9uLXplcm8gZXhpdCBjb2RlIGFuZCBpZ25vcmVFeGl0Q29kZSBpcyBgZmFsc2VgLlxuICogICAgICAgICBUaGUgZXJyb3IgbWVzc2FnZSBpbmNsdWRlcyB0aGUgZXhpdCBjb2RlLCB0aGUgY29tbWFuZCwgc3RkZXJyLCBhbmQgc3Rkb3V0IChvciBhIG5vdGUgdGhhdCBpdCB3YXNcbiAqICAgICAgICAgcHJpbnRlZCksIGFuZCBzYXlzIHdoZW4gdGhlIGNoaWxkIGNyYXNoZWQgb3Igd2FzIGtpbGxlZCByYXRoZXIgdGhhbiBleGl0aW5nIG9uIGl0cyBvd24uXG4gKiAgICAgICAgIElmIGFuIGVycm9yIG9jY3VycyBkdXJpbmcgdGhlIGV4ZWN1dGlvbiBhbmQgaWdub3JlRXhpdENvZGUgaXMgYHRydWVgLFxuICogICAgICAgICB0aGUgZXJyb3IgaXMgcmVzb2x2ZWQgd2l0aCB0aGUgc3Rkb3V0IGFuZCBzdGRlcnIuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBleGVjRnJvbVJvb3QoY29tbWFuZDogQ29tbWFuZFBhcnRbXSB8IHN0cmluZywgb3B0aW9ucz86IEV4ZWNTaW1wbGVPcHRpb25zKTogUHJvbWlzZTxzdHJpbmc+O1xuLyoqXG4gKiBFeGVjdXRlcyBhIGNvbW1hbmQgZnJvbSB0aGUgcm9vdCBmb2xkZXIgb2YgdGhlIHByb2plY3QuXG4gKlxuICogQHBhcmFtIGNvbW1hbmQgLSBUaGUgY29tbWFuZCB0byBleGVjdXRlLiBJdCBjYW4gYmUgYSBzdHJpbmcgb3IgYW4gYXJyYXkgb2Ygc3RyaW5ncy5cbiAqIEBwYXJhbSBvcHRpb25zIC0gVGhlIG9wdGlvbnMgZm9yIHRoZSBleGVjdXRpb24uXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdpdGggRXhlY1Jlc3VsdCBvYmplY3QuXG4gKiAgICAgICAgICBUaGUgRXhlY1Jlc3VsdCBvYmplY3QgY29udGFpbnMgdGhlIGV4aXQgY29kZSwgZXhpdCBzaWduYWwsIHN0ZGVyciwgYW5kIHN0ZG91dC5cbiAqIEB0aHJvd3MgSWYgdGhlIGNvbW1hbmQgZmFpbHMgd2l0aCBhIG5vbi16ZXJvIGV4aXQgY29kZSBhbmQgaWdub3JlRXhpdENvZGUgaXMgYGZhbHNlYC5cbiAqICAgICAgICAgVGhlIGVycm9yIG1lc3NhZ2UgaW5jbHVkZXMgdGhlIGV4aXQgY29kZSwgdGhlIGNvbW1hbmQsIHN0ZGVyciwgYW5kIHN0ZG91dCAob3IgYSBub3RlIHRoYXQgaXQgd2FzXG4gKiAgICAgICAgIHByaW50ZWQpLCBhbmQgc2F5cyB3aGVuIHRoZSBjaGlsZCBjcmFzaGVkIG9yIHdhcyBraWxsZWQgcmF0aGVyIHRoYW4gZXhpdGluZyBvbiBpdHMgb3duLlxuICogICAgICAgICBJZiBhbiBlcnJvciBvY2N1cnMgZHVyaW5nIHRoZSBleGVjdXRpb24gYW5kIGlnbm9yZUV4aXRDb2RlIGlzIGB0cnVlYCxcbiAqICAgICAgICAgdGhlIGVycm9yIGlzIHJlc29sdmVkIHdpdGggdGhlIHN0ZG91dCBhbmQgc3RkZXJyLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZXhlY0Zyb21Sb290KGNvbW1hbmQ6IENvbW1hbmRQYXJ0W10gfCBzdHJpbmcsIG9wdGlvbnM6IEV4ZWNEZXRhaWxlZE9wdGlvbnMpOiBQcm9taXNlPEV4ZWNSZXN1bHQ+O1xuLyoqXG4gKiBFeGVjdXRlcyBhIGNvbW1hbmQgZnJvbSB0aGUgcm9vdCBmb2xkZXIgb2YgdGhlIHByb2plY3QuXG4gKlxuICogQHBhcmFtIGNvbW1hbmQgLSBUaGUgY29tbWFuZCB0byBleGVjdXRlLiBJdCBjYW4gYmUgYSBzdHJpbmcgb3IgYW4gYXJyYXkgb2Ygc3RyaW5ncy5cbiAqIEBwYXJhbSBvcHRpb25zIC0gVGhlIG9wdGlvbnMgZm9yIHRoZSBleGVjdXRpb24uXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdpdGggdGhlIG91dHB1dCBvZiB0aGUgY29tbWFuZCBvciBhbiBFeGVjUmVzdWx0IG9iamVjdC5cbiAqICAgICAgICAgIFRoZSBFeGVjUmVzdWx0IG9iamVjdCBjb250YWlucyB0aGUgZXhpdCBjb2RlLCBleGl0IHNpZ25hbCwgc3RkZXJyLCBhbmQgc3Rkb3V0LlxuICogQHRocm93cyBJZiB0aGUgY29tbWFuZCBmYWlscyB3aXRoIGEgbm9uLXplcm8gZXhpdCBjb2RlIGFuZCBpZ25vcmVFeGl0Q29kZSBpcyBgZmFsc2VgLlxuICogICAgICAgICBUaGUgZXJyb3IgbWVzc2FnZSBpbmNsdWRlcyB0aGUgZXhpdCBjb2RlLCB0aGUgY29tbWFuZCwgc3RkZXJyLCBhbmQgc3Rkb3V0IChvciBhIG5vdGUgdGhhdCBpdCB3YXNcbiAqICAgICAgICAgcHJpbnRlZCksIGFuZCBzYXlzIHdoZW4gdGhlIGNoaWxkIGNyYXNoZWQgb3Igd2FzIGtpbGxlZCByYXRoZXIgdGhhbiBleGl0aW5nIG9uIGl0cyBvd24uXG4gKiAgICAgICAgIElmIGFuIGVycm9yIG9jY3VycyBkdXJpbmcgdGhlIGV4ZWN1dGlvbiBhbmQgaWdub3JlRXhpdENvZGUgaXMgYHRydWVgLFxuICogICAgICAgICB0aGUgZXJyb3IgaXMgcmVzb2x2ZWQgd2l0aCB0aGUgc3Rkb3V0IGFuZCBzdGRlcnIuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBleGVjRnJvbVJvb3QoY29tbWFuZDogQ29tbWFuZFBhcnRbXSB8IHN0cmluZywgb3B0aW9uczogRXhlY0Zyb21Sb290T3B0aW9ucyA9IHt9KTogUHJvbWlzZTxFeGVjUmVzdWx0IHwgc3RyaW5nPiB7XG4gIGxldCByb290ID0gZ2V0Um9vdEZvbGRlcihvcHRpb25zLmN3ZCk7XG5cbiAgaWYgKCFyb290KSB7XG4gICAgaWYgKG9wdGlvbnMuc2hvdWxkRmFpbElmQ2FsbGVkRnJvbU91dHNpZGVSb290ID8/IHRydWUpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcignQ291bGQgbm90IGZpbmQgcm9vdCBmb2xkZXInKTtcbiAgICB9XG5cbiAgICByb290ID0gb3B0aW9ucy5jd2QgPz8gcHJvY2Vzcy5jd2QoKTtcbiAgfVxuXG4gIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSB1bmljb3JuL3ByZWZlci1taW5pbWFsLXRlcm5hcnkgLS0gRWFjaCBicmFuY2ggcGlja3MgYSBkaWZmZXJlbnQgYGV4ZWNgIG92ZXJsb2FkIGJ5IHRoZSBsaXRlcmFsIGBzaG91bGRJbmNsdWRlRGV0YWlsc2A7IGEgYGJvb2xlYW5gIG1hdGNoZXMgbmVpdGhlci5cbiAgcmV0dXJuIG9wdGlvbnMuc2hvdWxkSW5jbHVkZURldGFpbHMgPyBleGVjKGNvbW1hbmQsIHsgLi4ub3B0aW9ucywgY3dkOiByb290LCBzaG91bGRJbmNsdWRlRGV0YWlsczogdHJ1ZSB9KSA6IGV4ZWMoY29tbWFuZCwgeyAuLi5vcHRpb25zLCBjd2Q6IHJvb3QsIHNob3VsZEluY2x1ZGVEZXRhaWxzOiBmYWxzZSB9KTtcbn1cblxuLyoqXG4gKiBSZXRyaWV2ZXMgdGhlIHJvb3QgZm9sZGVyIG9mIHRoZSBwcm9qZWN0LlxuICpcbiAqIEBwYXJhbSBjd2QgLSBUaGUgY3VycmVudCB3b3JraW5nIGZvbGRlciB0byByZXNvbHZlIGZyb20uXG4gKiBAcmV0dXJucyBUaGUgcGF0aCB0byB0aGUgcm9vdCBmb2xkZXIuXG4gKiBAdGhyb3dzIElmIHRoZSByb290IGZvbGRlciBjYW5ub3QgYmUgZm91bmQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRSb290Rm9sZGVyKGN3ZD86IHN0cmluZyk6IG51bGwgfCBzdHJpbmcge1xuICBsZXQgY3VycmVudEZvbGRlciA9IHRvUG9zaXhQYXRoKGN3ZCA/PyBwcm9jZXNzLmN3ZCgpKTtcbiAgd2hpbGUgKGN1cnJlbnRGb2xkZXIgIT09IFJlcG9QYXRocy5DdXJyZW50Rm9sZGVyIGFzIHN0cmluZyAmJiBjdXJyZW50Rm9sZGVyICE9PSBSZXBvUGF0aHMuUm9vdEZvbGRlciBhcyBzdHJpbmcpIHtcbiAgICBpZiAoZXhpc3RzU3luYyhqb2luKGN1cnJlbnRGb2xkZXIsIFJlcG9QYXRocy5QYWNrYWdlSnNvbikpKSB7XG4gICAgICByZXR1cm4gdG9Qb3NpeFBhdGgoY3VycmVudEZvbGRlcik7XG4gICAgfVxuICAgIGN1cnJlbnRGb2xkZXIgPSBkaXJuYW1lKGN1cnJlbnRGb2xkZXIpO1xuICB9XG5cbiAgcmV0dXJuIG51bGw7XG59XG5cbi8qKlxuICogUmVzb2x2ZXMgYSBwYXRoIHJlbGF0aXZlIHRvIHRoZSByb290IGZvbGRlciBvZiB0aGUgcHJvamVjdC5cbiAqXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBhcmFtZXRlcnMgZm9yIHRoZSBmdW5jdGlvbi5cbiAqIEByZXR1cm5zIFRoZSByZXNvbHZlZCBhYnNvbHV0ZSBwYXRoLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVzb2x2ZVBhdGhGcm9tUm9vdChwYXJhbXM6IFJlc29sdmVQYXRoRnJvbVJvb3RQYXJhbXMpOiBudWxsIHwgc3RyaW5nIHtcbiAgY29uc3Qge1xuICAgIGN3ZCxcbiAgICBwYXRoXG4gIH0gPSBwYXJhbXM7XG4gIGNvbnN0IHJvb3RGb2xkZXIgPSBnZXRSb290Rm9sZGVyKGN3ZCk7XG4gIHJldHVybiByb290Rm9sZGVyID8gcmVzb2x2ZShyb290Rm9sZGVyLCBwYXRoKSA6IG51bGw7XG59XG5cbi8qKlxuICogUmVzb2x2ZXMgYSBwYXRoIHJlbGF0aXZlIHRvIHRoZSByb290IGZvbGRlciwgcmV0dXJuaW5nIHRoZSByZXNvbHZlZCBwYXRoIG9yIHRoZSBvcmlnaW5hbCBwYXRoIGlmIGl0IGRvZXMgbm90IGV4aXN0LlxuICpcbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycyBmb3IgdGhlIGZ1bmN0aW9uLlxuICogQHJldHVybnMgVGhlIHJlc29sdmVkIHBhdGggb3IgdGhlIG9yaWdpbmFsIHBhdGggaWYgaXQgZG9lcyBub3QgZXhpc3QuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiByZXNvbHZlUGF0aEZyb21Sb290U2FmZShwYXJhbXM6IFJlc29sdmVQYXRoRnJvbVJvb3RTYWZlUGFyYW1zKTogc3RyaW5nIHtcbiAgY29uc3Qge1xuICAgIGN3ZCxcbiAgICBwYXRoXG4gIH0gPSBwYXJhbXM7XG4gIHJldHVybiByZXNvbHZlUGF0aEZyb21Sb290KG5vcm1hbGl6ZU9wdGlvbmFsUHJvcGVydGllczxSZXNvbHZlUGF0aEZyb21Sb290UGFyYW1zPih7IGN3ZCwgcGF0aCB9KSkgPz8gcGF0aDtcbn1cblxuLyoqXG4gKiBDb252ZXJ0cyBhbiBhYnNvbHV0ZSBwYXRoIHRvIGEgcmVsYXRpdmUgcGF0aCBmcm9tIHRoZSByb290IGZvbGRlciBvZiB0aGUgcHJvamVjdC5cbiAqXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBhcmFtZXRlcnMgZm9yIHRoZSBmdW5jdGlvbi5cbiAqIEByZXR1cm5zIFRoZSByZWxhdGl2ZSBwYXRoIGZyb20gdGhlIHJvb3QgZm9sZGVyLlxuICovXG5leHBvcnQgZnVuY3Rpb24gdG9SZWxhdGl2ZUZyb21Sb290KHBhcmFtczogVG9SZWxhdGl2ZUZyb21Sb290UGFyYW1zKTogbnVsbCB8IHN0cmluZyB7XG4gIGNvbnN0IHtcbiAgICBjd2RcbiAgfSA9IHBhcmFtcztcbiAgbGV0IHtcbiAgICBwYXRoXG4gIH0gPSBwYXJhbXM7XG4gIGNvbnN0IHJvb3RGb2xkZXIgPSBnZXRSb290Rm9sZGVyKGN3ZCk7XG4gIGlmICghcm9vdEZvbGRlcikge1xuICAgIHJldHVybiBudWxsO1xuICB9XG5cbiAgcGF0aCA9IHRvUG9zaXhQYXRoKHBhdGgpO1xuICByZXR1cm4gcmVsYXRpdmUocm9vdEZvbGRlciwgcGF0aCk7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQU9BLFNBQVMsbUNBQW1DO0FBQzVDO0FBQUEsRUFDRTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxPQUNLO0FBQ1AsU0FBUyxrQkFBa0I7QUFVM0IsU0FBUyxZQUFZO0FBQ3JCLFNBQVMsaUJBQWlCO0FBMEZuQixTQUFTLGFBQWEsU0FBaUMsVUFBK0IsQ0FBQyxHQUFpQztBQUM3SCxNQUFJLE9BQU8sY0FBYyxRQUFRLEdBQUc7QUFFcEMsTUFBSSxDQUFDLE1BQU07QUFDVCxRQUFJLFFBQVEscUNBQXFDLE1BQU07QUFDckQsWUFBTSxJQUFJLE1BQU0sNEJBQTRCO0FBQUEsSUFDOUM7QUFFQSxXQUFPLFFBQVEsT0FBTyxRQUFRLElBQUk7QUFBQSxFQUNwQztBQUdBLFNBQU8sUUFBUSx1QkFBdUIsS0FBSyxTQUFTLEVBQUUsR0FBRyxTQUFTLEtBQUssTUFBTSxzQkFBc0IsS0FBSyxDQUFDLElBQUksS0FBSyxTQUFTLEVBQUUsR0FBRyxTQUFTLEtBQUssTUFBTSxzQkFBc0IsTUFBTSxDQUFDO0FBQ25MO0FBU08sU0FBUyxjQUFjLEtBQTZCO0FBQ3pELE1BQUksZ0JBQWdCLFlBQVksT0FBTyxRQUFRLElBQUksQ0FBQztBQUNwRCxTQUFPLGtCQUFrQixVQUFVLGlCQUEyQixrQkFBa0IsVUFBVSxZQUFzQjtBQUM5RyxRQUFJLFdBQVcsS0FBSyxlQUFlLFVBQVUsV0FBVyxDQUFDLEdBQUc7QUFDMUQsYUFBTyxZQUFZLGFBQWE7QUFBQSxJQUNsQztBQUNBLG9CQUFnQixRQUFRLGFBQWE7QUFBQSxFQUN2QztBQUVBLFNBQU87QUFDVDtBQVFPLFNBQVMsb0JBQW9CLFFBQWtEO0FBQ3BGLFFBQU07QUFBQSxJQUNKO0FBQUEsSUFDQTtBQUFBLEVBQ0YsSUFBSTtBQUNKLFFBQU0sYUFBYSxjQUFjLEdBQUc7QUFDcEMsU0FBTyxhQUFhLFFBQVEsWUFBWSxJQUFJLElBQUk7QUFDbEQ7QUFRTyxTQUFTLHdCQUF3QixRQUErQztBQUNyRixRQUFNO0FBQUEsSUFDSjtBQUFBLElBQ0E7QUFBQSxFQUNGLElBQUk7QUFDSixTQUFPLG9CQUFvQiw0QkFBdUQsRUFBRSxLQUFLLEtBQUssQ0FBQyxDQUFDLEtBQUs7QUFDdkc7QUFRTyxTQUFTLG1CQUFtQixRQUFpRDtBQUNsRixRQUFNO0FBQUEsSUFDSjtBQUFBLEVBQ0YsSUFBSTtBQUNKLE1BQUk7QUFBQSxJQUNGO0FBQUEsRUFDRixJQUFJO0FBQ0osUUFBTSxhQUFhLGNBQWMsR0FBRztBQUNwQyxNQUFJLENBQUMsWUFBWTtBQUNmLFdBQU87QUFBQSxFQUNUO0FBRUEsU0FBTyxZQUFZLElBQUk7QUFDdkIsU0FBTyxTQUFTLFlBQVksSUFBSTtBQUNsQzsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/test-runners/index.d.mts

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

package/dist/lib/esm/test-runners/index.mjs

@@ -0,0 +1,54 @@
+/*
+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 vitest_config from "./vitest-config.mjs";
+import * as vitest from "./vitest.mjs";
+export {
+  vitest,
+  vitest_config as "vitest-config"
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3Rlc3QtcnVubmVycy9pbmRleC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyogVEhJUyBJUyBBIEdFTkVSQVRFRC9CVU5ETEVEIEZJTEUgQlkgQlVJTEQgU0NSSVBUICovXG5cbmV4cG9ydCAqIGFzICd2aXRlc3QtY29uZmlnJyBmcm9tICcuL3ZpdGVzdC1jb25maWcudHMnO1xuZXhwb3J0ICogYXMgJ3ZpdGVzdCcgZnJvbSAnLi92aXRlc3QudHMnO1xuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFFQSxZQUFZQSxtQkFBcUI7QUFDakMsWUFBWSxZQUFjOyIsCiAgIm5hbWVzIjogWyJ2aXRlc3QtY29uZmlnIl0KfQo=

package/dist/lib/esm/test-runners/vitest-config.d.mts

@@ -0,0 +1,90 @@
+/// <reference path="../index.d.mts" />
+/**
+ * @file
+ *
+ * Shared vitest configuration for TypeScript LIBRARY packages: the pinned reporters, the test excludes, the coverage
+ * block, and {@link defineLibraryVitestConfig}, which wraps a package's own projects in them.
+ *
+ * The Obsidian plugin configuration (`@mnaoumov/obsidian-dev-toolkit/test-runners/vitest-config`) builds on the same
+ * reporters and excludes, so the two cannot drift apart.
+ */
+import type { TestProjectConfiguration, ViteUserConfig } from 'vitest/config';
+import type { Reporter } from 'vitest/node';
+/**
+ * One entry of a vitest `reporters` list: the name of a built-in reporter (`'default'`, `'junit'`,
+ * `'minimal'`, …) or a reporter instance.
+ *
+ * Spelled out rather than derived from vitest's own option type, whose parts (`ReporterName`,
+ * `InlineReporter`) are internal to vitest and exported from none of its entry points. Naming the two
+ * shapes directly keeps a reporters list a plain array a caller pushes onto, which the option type itself
+ * cannot be, because it is a union of an array with a single value. Vitest's third accepted shape, a
+ * `[name, options]` tuple, is deliberately left out: no repository on this toolchain uses one.
+ */
+export type VitestReporter = Reporter | string;
+/**
+ * The reporters every repo on this toolchain prints through.
+ *
+ * **Pinned, because vitest's fallback is not one reporter but two.** An unset `reporters` resolves to
+ * `isAgent ? 'minimal' : 'default'`, and `std-env`'s `isAgent` is true inside every AI coding session —
+ * it reads `AI_AGENT` plus a dozen tool-specific variables. `MinimalReporter` extends the default one
+ * with `summary: false`, `silent: 'passed-only'`, and a `printTestModule` that returns early unless the
+ * module FAILED. So the SAME `npm run test`, on the SAME tree, prints a line per test file for a
+ * developer and not one for a session, and swallows a passing test's console output in the second case
+ * only. Measured on the `unit-tests:script-utils` project of `obsidian-dev-utils` (43 files, vitest 5.0.1,
+ * 2026-09-23): 46 per-file lines over a 58-line log pinned, 0 over a 13-line log unset.
+ *
+ * A gate should not report differently depending on who runs it, and a `console.log` a developer adds
+ * to find something should not vanish because a session ran the suite. The cost of the pin is the ~45
+ * lines above.
+ *
+ * **What this deliberately does NOT carry is a reporter naming the file a dead pool worker took with it,
+ * because vitest 5 already does that itself.** `emitUnexpectedExit` is `(code, signal) => …` there, building
+ * its message from the exit code, the signal, the runner state and the files the worker held. Driven
+ * against real runs on 2026-09-23 in all four shapes: a worker `SIGKILL`ed mid-file, one killed at
+ * import before collection, the same under `minimal`, and the realistic one — the dying file among 42
+ * others in a parallel run — which reported `42 passed (43)` AND named the file. Under vitest 4 none of
+ * that existed and the reader was left subtracting over file names the log did not contain, which is
+ * what a reconciling reporter was written for; on 5 it would be a module, a test file and a coverage
+ * burden for every consumer, carrying a claim that is no longer true.
+ */
+export declare const DEFAULT_VITEST_REPORTERS: readonly VitestReporter[];
+/**
+ * Folders vitest never collects tests from.
+ */
+export declare const DEFAULT_VITEST_TEST_EXCLUDE: readonly string[];
+/**
+ * The coverage options of a library package: v8 over its own `src/`, without the generated barrels, the
+ * declarations, the tests and the test helpers. The threshold is the `test:coverage` script's to set.
+ */
+export declare const LIBRARY_VITEST_COVERAGE: {
+    exclude: string[];
+    include: string[];
+    provider: "v8";
+    reporter: string[];
+    reportsDirectory: string;
+};
+/**
+ * Parameters for {@link defineLibraryVitestConfig}.
+ */
+export interface DefineLibraryVitestConfigParams {
+    /**
+     * The vite plugins, e.g. a resolver mapping sibling packages onto their source.
+     */
+    readonly plugins?: ViteUserConfig['plugins'];
+    /**
+     * The package's vitest projects.
+     */
+    readonly projects: TestProjectConfiguration[];
+    /**
+     * The top-level `resolve` options, applied to every project that does not set its own.
+     */
+    readonly resolve?: ViteUserConfig['resolve'];
+}
+/**
+ * Defines a library package's vitest configuration: its own projects, wrapped in the shared reporters, excludes and
+ * coverage block, with console output from passing tests suppressed.
+ *
+ * @param params - The configuration parameters.
+ * @returns The vitest configuration.
+ */
+export declare function defineLibraryVitestConfig(params: DefineLibraryVitestConfigParams): ViteUserConfig;

package/dist/lib/esm/test-runners/vitest-config.mjs

@@ -0,0 +1,86 @@
+/*
+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();
+})();
+})();
+
+const DEFAULT_VITEST_REPORTERS = ["default"];
+const DEFAULT_VITEST_TEST_EXCLUDE = ["node_modules", "dist"];
+const LIBRARY_VITEST_COVERAGE = {
+  exclude: [
+    "src/**/@types/**",
+    "src/**/index.ts",
+    "src/**/*.d.ts",
+    "src/**/*.test.ts",
+    "src/test-helpers/**"
+  ],
+  include: ["src/**/*.ts"],
+  provider: "v8",
+  reporter: ["text", "lcov", "html"],
+  reportsDirectory: "./coverage"
+};
+function defineLibraryVitestConfig(params) {
+  const config = {
+    plugins: params.plugins ?? [],
+    test: {
+      coverage: LIBRARY_VITEST_COVERAGE,
+      exclude: [...DEFAULT_VITEST_TEST_EXCLUDE],
+      globals: false,
+      onConsoleLog: () => false,
+      projects: params.projects,
+      reporters: [...DEFAULT_VITEST_REPORTERS]
+    }
+  };
+  if (params.resolve) {
+    config.resolve = params.resolve;
+  }
+  return config;
+}
+export {
+  DEFAULT_VITEST_REPORTERS,
+  DEFAULT_VITEST_TEST_EXCLUDE,
+  LIBRARY_VITEST_COVERAGE,
+  defineLibraryVitestConfig
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3Rlc3QtcnVubmVycy92aXRlc3QtY29uZmlnLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogU2hhcmVkIHZpdGVzdCBjb25maWd1cmF0aW9uIGZvciBUeXBlU2NyaXB0IExJQlJBUlkgcGFja2FnZXM6IHRoZSBwaW5uZWQgcmVwb3J0ZXJzLCB0aGUgdGVzdCBleGNsdWRlcywgdGhlIGNvdmVyYWdlXG4gKiBibG9jaywgYW5kIHtAbGluayBkZWZpbmVMaWJyYXJ5Vml0ZXN0Q29uZmlnfSwgd2hpY2ggd3JhcHMgYSBwYWNrYWdlJ3Mgb3duIHByb2plY3RzIGluIHRoZW0uXG4gKlxuICogVGhlIE9ic2lkaWFuIHBsdWdpbiBjb25maWd1cmF0aW9uIChgQG1uYW91bW92L29ic2lkaWFuLWRldi10b29sa2l0L3Rlc3QtcnVubmVycy92aXRlc3QtY29uZmlnYCkgYnVpbGRzIG9uIHRoZSBzYW1lXG4gKiByZXBvcnRlcnMgYW5kIGV4Y2x1ZGVzLCBzbyB0aGUgdHdvIGNhbm5vdCBkcmlmdCBhcGFydC5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7XG4gIFRlc3RQcm9qZWN0Q29uZmlndXJhdGlvbixcbiAgVml0ZVVzZXJDb25maWdcbn0gZnJvbSAndml0ZXN0L2NvbmZpZyc7XG5pbXBvcnQgdHlwZSB7IFJlcG9ydGVyIH0gZnJvbSAndml0ZXN0L25vZGUnO1xuXG4vKipcbiAqIE9uZSBlbnRyeSBvZiBhIHZpdGVzdCBgcmVwb3J0ZXJzYCBsaXN0OiB0aGUgbmFtZSBvZiBhIGJ1aWx0LWluIHJlcG9ydGVyIChgJ2RlZmF1bHQnYCwgYCdqdW5pdCdgLFxuICogYCdtaW5pbWFsJ2AsIFx1MjAyNikgb3IgYSByZXBvcnRlciBpbnN0YW5jZS5cbiAqXG4gKiBTcGVsbGVkIG91dCByYXRoZXIgdGhhbiBkZXJpdmVkIGZyb20gdml0ZXN0J3Mgb3duIG9wdGlvbiB0eXBlLCB3aG9zZSBwYXJ0cyAoYFJlcG9ydGVyTmFtZWAsXG4gKiBgSW5saW5lUmVwb3J0ZXJgKSBhcmUgaW50ZXJuYWwgdG8gdml0ZXN0IGFuZCBleHBvcnRlZCBmcm9tIG5vbmUgb2YgaXRzIGVudHJ5IHBvaW50cy4gTmFtaW5nIHRoZSB0d29cbiAqIHNoYXBlcyBkaXJlY3RseSBrZWVwcyBhIHJlcG9ydGVycyBsaXN0IGEgcGxhaW4gYXJyYXkgYSBjYWxsZXIgcHVzaGVzIG9udG8sIHdoaWNoIHRoZSBvcHRpb24gdHlwZSBpdHNlbGZcbiAqIGNhbm5vdCBiZSwgYmVjYXVzZSBpdCBpcyBhIHVuaW9uIG9mIGFuIGFycmF5IHdpdGggYSBzaW5nbGUgdmFsdWUuIFZpdGVzdCdzIHRoaXJkIGFjY2VwdGVkIHNoYXBlLCBhXG4gKiBgW25hbWUsIG9wdGlvbnNdYCB0dXBsZSwgaXMgZGVsaWJlcmF0ZWx5IGxlZnQgb3V0OiBubyByZXBvc2l0b3J5IG9uIHRoaXMgdG9vbGNoYWluIHVzZXMgb25lLlxuICovXG5leHBvcnQgdHlwZSBWaXRlc3RSZXBvcnRlciA9IFJlcG9ydGVyIHwgc3RyaW5nO1xuXG4vKipcbiAqIFRoZSByZXBvcnRlcnMgZXZlcnkgcmVwbyBvbiB0aGlzIHRvb2xjaGFpbiBwcmludHMgdGhyb3VnaC5cbiAqXG4gKiAqKlBpbm5lZCwgYmVjYXVzZSB2aXRlc3QncyBmYWxsYmFjayBpcyBub3Qgb25lIHJlcG9ydGVyIGJ1dCB0d28uKiogQW4gdW5zZXQgYHJlcG9ydGVyc2AgcmVzb2x2ZXMgdG9cbiAqIGBpc0FnZW50ID8gJ21pbmltYWwnIDogJ2RlZmF1bHQnYCwgYW5kIGBzdGQtZW52YCdzIGBpc0FnZW50YCBpcyB0cnVlIGluc2lkZSBldmVyeSBBSSBjb2Rpbmcgc2Vzc2lvbiBcdTIwMTRcbiAqIGl0IHJlYWRzIGBBSV9BR0VOVGAgcGx1cyBhIGRvemVuIHRvb2wtc3BlY2lmaWMgdmFyaWFibGVzLiBgTWluaW1hbFJlcG9ydGVyYCBleHRlbmRzIHRoZSBkZWZhdWx0IG9uZVxuICogd2l0aCBgc3VtbWFyeTogZmFsc2VgLCBgc2lsZW50OiAncGFzc2VkLW9ubHknYCwgYW5kIGEgYHByaW50VGVzdE1vZHVsZWAgdGhhdCByZXR1cm5zIGVhcmx5IHVubGVzcyB0aGVcbiAqIG1vZHVsZSBGQUlMRUQuIFNvIHRoZSBTQU1FIGBucG0gcnVuIHRlc3RgLCBvbiB0aGUgU0FNRSB0cmVlLCBwcmludHMgYSBsaW5lIHBlciB0ZXN0IGZpbGUgZm9yIGFcbiAqIGRldmVsb3BlciBhbmQgbm90IG9uZSBmb3IgYSBzZXNzaW9uLCBhbmQgc3dhbGxvd3MgYSBwYXNzaW5nIHRlc3QncyBjb25zb2xlIG91dHB1dCBpbiB0aGUgc2Vjb25kIGNhc2VcbiAqIG9ubHkuIE1lYXN1cmVkIG9uIHRoZSBgdW5pdC10ZXN0czpzY3JpcHQtdXRpbHNgIHByb2plY3Qgb2YgYG9ic2lkaWFuLWRldi11dGlsc2AgKDQzIGZpbGVzLCB2aXRlc3QgNS4wLjEsXG4gKiAyMDI2LTA5LTIzKTogNDYgcGVyLWZpbGUgbGluZXMgb3ZlciBhIDU4LWxpbmUgbG9nIHBpbm5lZCwgMCBvdmVyIGEgMTMtbGluZSBsb2cgdW5zZXQuXG4gKlxuICogQSBnYXRlIHNob3VsZCBub3QgcmVwb3J0IGRpZmZlcmVudGx5IGRlcGVuZGluZyBvbiB3aG8gcnVucyBpdCwgYW5kIGEgYGNvbnNvbGUubG9nYCBhIGRldmVsb3BlciBhZGRzXG4gKiB0byBmaW5kIHNvbWV0aGluZyBzaG91bGQgbm90IHZhbmlzaCBiZWNhdXNlIGEgc2Vzc2lvbiByYW4gdGhlIHN1aXRlLiBUaGUgY29zdCBvZiB0aGUgcGluIGlzIHRoZSB+NDVcbiAqIGxpbmVzIGFib3ZlLlxuICpcbiAqICoqV2hhdCB0aGlzIGRlbGliZXJhdGVseSBkb2VzIE5PVCBjYXJyeSBpcyBhIHJlcG9ydGVyIG5hbWluZyB0aGUgZmlsZSBhIGRlYWQgcG9vbCB3b3JrZXIgdG9vayB3aXRoIGl0LFxuICogYmVjYXVzZSB2aXRlc3QgNSBhbHJlYWR5IGRvZXMgdGhhdCBpdHNlbGYuKiogYGVtaXRVbmV4cGVjdGVkRXhpdGAgaXMgYChjb2RlLCBzaWduYWwpID0+IFx1MjAyNmAgdGhlcmUsIGJ1aWxkaW5nXG4gKiBpdHMgbWVzc2FnZSBmcm9tIHRoZSBleGl0IGNvZGUsIHRoZSBzaWduYWwsIHRoZSBydW5uZXIgc3RhdGUgYW5kIHRoZSBmaWxlcyB0aGUgd29ya2VyIGhlbGQuIERyaXZlblxuICogYWdhaW5zdCByZWFsIHJ1bnMgb24gMjAyNi0wOS0yMyBpbiBhbGwgZm91ciBzaGFwZXM6IGEgd29ya2VyIGBTSUdLSUxMYGVkIG1pZC1maWxlLCBvbmUga2lsbGVkIGF0XG4gKiBpbXBvcnQgYmVmb3JlIGNvbGxlY3Rpb24sIHRoZSBzYW1lIHVuZGVyIGBtaW5pbWFsYCwgYW5kIHRoZSByZWFsaXN0aWMgb25lIFx1MjAxNCB0aGUgZHlpbmcgZmlsZSBhbW9uZyA0MlxuICogb3RoZXJzIGluIGEgcGFyYWxsZWwgcnVuIFx1MjAxNCB3aGljaCByZXBvcnRlZCBgNDIgcGFzc2VkICg0MylgIEFORCBuYW1lZCB0aGUgZmlsZS4gVW5kZXIgdml0ZXN0IDQgbm9uZSBvZlxuICogdGhhdCBleGlzdGVkIGFuZCB0aGUgcmVhZGVyIHdhcyBsZWZ0IHN1YnRyYWN0aW5nIG92ZXIgZmlsZSBuYW1lcyB0aGUgbG9nIGRpZCBub3QgY29udGFpbiwgd2hpY2ggaXNcbiAqIHdoYXQgYSByZWNvbmNpbGluZyByZXBvcnRlciB3YXMgd3JpdHRlbiBmb3I7IG9uIDUgaXQgd291bGQgYmUgYSBtb2R1bGUsIGEgdGVzdCBmaWxlIGFuZCBhIGNvdmVyYWdlXG4gKiBidXJkZW4gZm9yIGV2ZXJ5IGNvbnN1bWVyLCBjYXJyeWluZyBhIGNsYWltIHRoYXQgaXMgbm8gbG9uZ2VyIHRydWUuXG4gKi9cbmV4cG9ydCBjb25zdCBERUZBVUxUX1ZJVEVTVF9SRVBPUlRFUlM6IHJlYWRvbmx5IFZpdGVzdFJlcG9ydGVyW10gPSBbJ2RlZmF1bHQnXTtcblxuLyoqXG4gKiBGb2xkZXJzIHZpdGVzdCBuZXZlciBjb2xsZWN0cyB0ZXN0cyBmcm9tLlxuICovXG5leHBvcnQgY29uc3QgREVGQVVMVF9WSVRFU1RfVEVTVF9FWENMVURFOiByZWFkb25seSBzdHJpbmdbXSA9IFsnbm9kZV9tb2R1bGVzJywgJ2Rpc3QnXTtcblxuLyoqXG4gKiBUaGUgY292ZXJhZ2Ugb3B0aW9ucyBvZiBhIGxpYnJhcnkgcGFja2FnZTogdjggb3ZlciBpdHMgb3duIGBzcmMvYCwgd2l0aG91dCB0aGUgZ2VuZXJhdGVkIGJhcnJlbHMsIHRoZVxuICogZGVjbGFyYXRpb25zLCB0aGUgdGVzdHMgYW5kIHRoZSB0ZXN0IGhlbHBlcnMuIFRoZSB0aHJlc2hvbGQgaXMgdGhlIGB0ZXN0OmNvdmVyYWdlYCBzY3JpcHQncyB0byBzZXQuXG4gKi9cbmV4cG9ydCBjb25zdCBMSUJSQVJZX1ZJVEVTVF9DT1ZFUkFHRSA9IHtcbiAgZXhjbHVkZTogW1xuICAgICdzcmMvKiovQHR5cGVzLyoqJyxcbiAgICAnc3JjLyoqL2luZGV4LnRzJyxcbiAgICAnc3JjLyoqLyouZC50cycsXG4gICAgJ3NyYy8qKi8qLnRlc3QudHMnLFxuICAgICdzcmMvdGVzdC1oZWxwZXJzLyoqJ1xuICBdLFxuICBpbmNsdWRlOiBbJ3NyYy8qKi8qLnRzJ10sXG4gIHByb3ZpZGVyOiAndjgnIGFzIGNvbnN0LFxuICByZXBvcnRlcjogWyd0ZXh0JywgJ2xjb3YnLCAnaHRtbCddLFxuICByZXBvcnRzRGlyZWN0b3J5OiAnLi9jb3ZlcmFnZSdcbn07XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIGRlZmluZUxpYnJhcnlWaXRlc3RDb25maWd9LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIERlZmluZUxpYnJhcnlWaXRlc3RDb25maWdQYXJhbXMge1xuICAvKipcbiAgICogVGhlIHZpdGUgcGx1Z2lucywgZS5nLiBhIHJlc29sdmVyIG1hcHBpbmcgc2libGluZyBwYWNrYWdlcyBvbnRvIHRoZWlyIHNvdXJjZS5cbiAgICovXG4gIHJlYWRvbmx5IHBsdWdpbnM/OiBWaXRlVXNlckNvbmZpZ1sncGx1Z2lucyddO1xuXG4gIC8qKlxuICAgKiBUaGUgcGFja2FnZSdzIHZpdGVzdCBwcm9qZWN0cy5cbiAgICovXG4gIHJlYWRvbmx5IHByb2plY3RzOiBUZXN0UHJvamVjdENvbmZpZ3VyYXRpb25bXTtcblxuICAvKipcbiAgICogVGhlIHRvcC1sZXZlbCBgcmVzb2x2ZWAgb3B0aW9ucywgYXBwbGllZCB0byBldmVyeSBwcm9qZWN0IHRoYXQgZG9lcyBub3Qgc2V0IGl0cyBvd24uXG4gICAqL1xuICByZWFkb25seSByZXNvbHZlPzogVml0ZVVzZXJDb25maWdbJ3Jlc29sdmUnXTtcbn1cblxuLyoqXG4gKiBEZWZpbmVzIGEgbGlicmFyeSBwYWNrYWdlJ3Mgdml0ZXN0IGNvbmZpZ3VyYXRpb246IGl0cyBvd24gcHJvamVjdHMsIHdyYXBwZWQgaW4gdGhlIHNoYXJlZCByZXBvcnRlcnMsIGV4Y2x1ZGVzIGFuZFxuICogY292ZXJhZ2UgYmxvY2ssIHdpdGggY29uc29sZSBvdXRwdXQgZnJvbSBwYXNzaW5nIHRlc3RzIHN1cHByZXNzZWQuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBjb25maWd1cmF0aW9uIHBhcmFtZXRlcnMuXG4gKiBAcmV0dXJucyBUaGUgdml0ZXN0IGNvbmZpZ3VyYXRpb24uXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBkZWZpbmVMaWJyYXJ5Vml0ZXN0Q29uZmlnKHBhcmFtczogRGVmaW5lTGlicmFyeVZpdGVzdENvbmZpZ1BhcmFtcyk6IFZpdGVVc2VyQ29uZmlnIHtcbiAgY29uc3QgY29uZmlnOiBWaXRlVXNlckNvbmZpZyA9IHtcbiAgICBwbHVnaW5zOiBwYXJhbXMucGx1Z2lucyA/PyBbXSxcbiAgICB0ZXN0OiB7XG4gICAgICBjb3ZlcmFnZTogTElCUkFSWV9WSVRFU1RfQ09WRVJBR0UsXG4gICAgICBleGNsdWRlOiBbLi4uREVGQVVMVF9WSVRFU1RfVEVTVF9FWENMVURFXSxcbiAgICAgIGdsb2JhbHM6IGZhbHNlLFxuICAgICAgb25Db25zb2xlTG9nOiAoKTogZmFsc2UgPT4gZmFsc2UsXG4gICAgICBwcm9qZWN0czogcGFyYW1zLnByb2plY3RzLFxuICAgICAgcmVwb3J0ZXJzOiBbLi4uREVGQVVMVF9WSVRFU1RfUkVQT1JURVJTXVxuICAgIH1cbiAgfTtcblxuICBpZiAocGFyYW1zLnJlc29sdmUpIHtcbiAgICBjb25maWcucmVzb2x2ZSA9IHBhcmFtcy5yZXNvbHZlO1xuICB9XG5cbiAgcmV0dXJuIGNvbmZpZztcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBc0RPLE1BQU0sMkJBQXNELENBQUMsU0FBUztBQUt0RSxNQUFNLDhCQUFpRCxDQUFDLGdCQUFnQixNQUFNO0FBTTlFLE1BQU0sMEJBQTBCO0FBQUEsRUFDckMsU0FBUztBQUFBLElBQ1A7QUFBQSxJQUNBO0FBQUEsSUFDQTtBQUFBLElBQ0E7QUFBQSxJQUNBO0FBQUEsRUFDRjtBQUFBLEVBQ0EsU0FBUyxDQUFDLGFBQWE7QUFBQSxFQUN2QixVQUFVO0FBQUEsRUFDVixVQUFVLENBQUMsUUFBUSxRQUFRLE1BQU07QUFBQSxFQUNqQyxrQkFBa0I7QUFDcEI7QUE2Qk8sU0FBUywwQkFBMEIsUUFBeUQ7QUFDakcsUUFBTSxTQUF5QjtBQUFBLElBQzdCLFNBQVMsT0FBTyxXQUFXLENBQUM7QUFBQSxJQUM1QixNQUFNO0FBQUEsTUFDSixVQUFVO0FBQUEsTUFDVixTQUFTLENBQUMsR0FBRywyQkFBMkI7QUFBQSxNQUN4QyxTQUFTO0FBQUEsTUFDVCxjQUFjLE1BQWE7QUFBQSxNQUMzQixVQUFVLE9BQU87QUFBQSxNQUNqQixXQUFXLENBQUMsR0FBRyx3QkFBd0I7QUFBQSxJQUN6QztBQUFBLEVBQ0Y7QUFFQSxNQUFJLE9BQU8sU0FBUztBQUNsQixXQUFPLFVBQVUsT0FBTztBQUFBLEVBQzFCO0FBRUEsU0FBTztBQUNUOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/esm/test-runners/vitest.d.mts

@@ -0,0 +1,52 @@
+/// <reference path="../index.d.mts" />
+/**
+ * @file
+ *
+ * This module provides functions for running tests using the Vitest framework.
+ */
+/**
+ * Options for running tests with coverage.
+ */
+export interface TestCoverageOptions extends TestOptions {
+    /**
+     * Minimum coverage percentage required. If the actual coverage falls below
+     * this threshold, the process exits with a non-zero code.
+     *
+     * @default `0`
+     */
+    readonly minCoverageInPercents?: number;
+}
+/**
+ * Options for running tests.
+ */
+export interface TestOptions {
+    /**
+     * The projects to run.
+     */
+    readonly projects?: string[];
+}
+/**
+ * Options for running tests in watch mode.
+ */
+export type TestWatchOptions = TestOptions;
+/**
+ * Runs the test suite.
+ *
+ * @param options - The options for the test.
+ * @returns A {@link Promise} that resolves when the tests have completed.
+ */
+export declare function test(options?: TestOptions): Promise<void>;
+/**
+ * Runs the test suite with coverage.
+ *
+ * @param options - Optional coverage configuration.
+ * @returns A {@link Promise} that resolves when the tests have completed.
+ */
+export declare function testCoverage(options?: TestCoverageOptions): Promise<void>;
+/**
+ * Runs the test suite in watch mode.
+ *
+ * @param options - The options for the test.
+ * @returns A {@link Promise} that resolves when the tests have completed.
+ */
+export declare function testWatch(options?: TestWatchOptions): Promise<void>;

package/dist/lib/esm/test-runners/vitest.mjs

@@ -0,0 +1,76 @@
+/*
+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 { execFromRoot } from "../root.mjs";
+async function test(options = {}) {
+  await execFromRoot(["vitest", "run", ...buildProjectFlags(options.projects)]);
+}
+async function testCoverage(options = {}) {
+  const threshold = String(options.minCoverageInPercents ?? 0);
+  await execFromRoot([
+    "vitest",
+    "run",
+    ...buildProjectFlags(options.projects),
+    "--coverage",
+    `--coverage.thresholds.lines=${threshold}`,
+    `--coverage.thresholds.functions=${threshold}`,
+    `--coverage.thresholds.branches=${threshold}`,
+    `--coverage.thresholds.statements=${threshold}`
+  ]);
+}
+async function testWatch(options = {}) {
+  await execFromRoot(["vitest", ...buildProjectFlags(options.projects)]);
+}
+function buildProjectFlags(projects) {
+  return (projects ?? []).flatMap((project) => [`--project=${project}`, `--project=${project}:*`]);
+}
+export {
+  test,
+  testCoverage,
+  testWatch
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3Rlc3QtcnVubmVycy92aXRlc3QudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBUaGlzIG1vZHVsZSBwcm92aWRlcyBmdW5jdGlvbnMgZm9yIHJ1bm5pbmcgdGVzdHMgdXNpbmcgdGhlIFZpdGVzdCBmcmFtZXdvcmsuXG4gKi9cblxuLyogdjggaWdub3JlIHN0YXJ0IC0tIEV4ZWN1dGVzIHZpdGVzdCBhcyBhIENMSSBzdWJwcm9jZXNzOyBjb3JyZWN0bmVzcyBpcyB2ZXJpZmllZCBieSBydW5uaW5nIHRlc3RzLCBub3QgdW5pdCB0ZXN0cy4gKi9cblxuaW1wb3J0IHsgZXhlY0Zyb21Sb290IH0gZnJvbSAnLi4vcm9vdC50cyc7XG5cbi8qKlxuICogT3B0aW9ucyBmb3IgcnVubmluZyB0ZXN0cyB3aXRoIGNvdmVyYWdlLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFRlc3RDb3ZlcmFnZU9wdGlvbnMgZXh0ZW5kcyBUZXN0T3B0aW9ucyB7XG4gIC8qKlxuICAgKiBNaW5pbXVtIGNvdmVyYWdlIHBlcmNlbnRhZ2UgcmVxdWlyZWQuIElmIHRoZSBhY3R1YWwgY292ZXJhZ2UgZmFsbHMgYmVsb3dcbiAgICogdGhpcyB0aHJlc2hvbGQsIHRoZSBwcm9jZXNzIGV4aXRzIHdpdGggYSBub24temVybyBjb2RlLlxuICAgKlxuICAgKiBAZGVmYXVsdCBgMGBcbiAgICovXG4gIHJlYWRvbmx5IG1pbkNvdmVyYWdlSW5QZXJjZW50cz86IG51bWJlcjtcbn1cblxuLyoqXG4gKiBPcHRpb25zIGZvciBydW5uaW5nIHRlc3RzLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFRlc3RPcHRpb25zIHtcbiAgLyoqXG4gICAqIFRoZSBwcm9qZWN0cyB0byBydW4uXG4gICAqL1xuICByZWFkb25seSBwcm9qZWN0cz86IHN0cmluZ1tdO1xufVxuXG4vKipcbiAqIE9wdGlvbnMgZm9yIHJ1bm5pbmcgdGVzdHMgaW4gd2F0Y2ggbW9kZS5cbiAqL1xuZXhwb3J0IHR5cGUgVGVzdFdhdGNoT3B0aW9ucyA9IFRlc3RPcHRpb25zO1xuXG4vKipcbiAqIFJ1bnMgdGhlIHRlc3Qgc3VpdGUuXG4gKlxuICogQHBhcmFtIG9wdGlvbnMgLSBUaGUgb3B0aW9ucyBmb3IgdGhlIHRlc3QuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdoZW4gdGhlIHRlc3RzIGhhdmUgY29tcGxldGVkLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gdGVzdChvcHRpb25zOiBUZXN0T3B0aW9ucyA9IHt9KTogUHJvbWlzZTx2b2lkPiB7XG4gIGF3YWl0IGV4ZWNGcm9tUm9vdChbJ3ZpdGVzdCcsICdydW4nLCAuLi5idWlsZFByb2plY3RGbGFncyhvcHRpb25zLnByb2plY3RzKV0pO1xufVxuXG4vKipcbiAqIFJ1bnMgdGhlIHRlc3Qgc3VpdGUgd2l0aCBjb3ZlcmFnZS5cbiAqXG4gKiBAcGFyYW0gb3B0aW9ucyAtIE9wdGlvbmFsIGNvdmVyYWdlIGNvbmZpZ3VyYXRpb24uXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdoZW4gdGhlIHRlc3RzIGhhdmUgY29tcGxldGVkLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gdGVzdENvdmVyYWdlKG9wdGlvbnM6IFRlc3RDb3ZlcmFnZU9wdGlvbnMgPSB7fSk6IFByb21pc2U8dm9pZD4ge1xuICBjb25zdCB0aHJlc2hvbGQgPSBTdHJpbmcob3B0aW9ucy5taW5Db3ZlcmFnZUluUGVyY2VudHMgPz8gMCk7XG4gIGF3YWl0IGV4ZWNGcm9tUm9vdChbXG4gICAgJ3ZpdGVzdCcsXG4gICAgJ3J1bicsXG4gICAgLi4uYnVpbGRQcm9qZWN0RmxhZ3Mob3B0aW9ucy5wcm9qZWN0cyksXG4gICAgJy0tY292ZXJhZ2UnLFxuICAgIGAtLWNvdmVyYWdlLnRocmVzaG9sZHMubGluZXM9JHt0aHJlc2hvbGR9YCxcbiAgICBgLS1jb3ZlcmFnZS50aHJlc2hvbGRzLmZ1bmN0aW9ucz0ke3RocmVzaG9sZH1gLFxuICAgIGAtLWNvdmVyYWdlLnRocmVzaG9sZHMuYnJhbmNoZXM9JHt0aHJlc2hvbGR9YCxcbiAgICBgLS1jb3ZlcmFnZS50aHJlc2hvbGRzLnN0YXRlbWVudHM9JHt0aHJlc2hvbGR9YFxuICBdKTtcbn1cblxuLyoqXG4gKiBSdW5zIHRoZSB0ZXN0IHN1aXRlIGluIHdhdGNoIG1vZGUuXG4gKlxuICogQHBhcmFtIG9wdGlvbnMgLSBUaGUgb3B0aW9ucyBmb3IgdGhlIHRlc3QuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdoZW4gdGhlIHRlc3RzIGhhdmUgY29tcGxldGVkLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gdGVzdFdhdGNoKG9wdGlvbnM6IFRlc3RXYXRjaE9wdGlvbnMgPSB7fSk6IFByb21pc2U8dm9pZD4ge1xuICBhd2FpdCBleGVjRnJvbVJvb3QoWyd2aXRlc3QnLCAuLi5idWlsZFByb2plY3RGbGFncyhvcHRpb25zLnByb2plY3RzKV0pO1xufVxuXG4vKipcbiAqIEJ1aWxkcyBgLS1wcm9qZWN0YCBmbGFncyBmb3IgdGhlIGdpdmVuIHByb2plY3QgcHJlZml4ZXMuXG4gKiBFYWNoIHByZWZpeCBleHBhbmRzIHRvIGJvdGggYC0tcHJvamVjdD1wcmVmaXhgIChleGFjdCBtYXRjaClcbiAqIGFuZCBgLS1wcm9qZWN0PXByZWZpeDoqYCAoc3ViLXByb2plY3RzKS5cbiAqXG4gKiBAcGFyYW0gcHJvamVjdHMgLSBUaGUgcHJvamVjdCBuYW1lIHByZWZpeGVzLlxuICogQHJldHVybnMgVGhlIGAtLXByb2plY3RgIGZsYWdzIGFycmF5LlxuICovXG5mdW5jdGlvbiBidWlsZFByb2plY3RGbGFncyhwcm9qZWN0cz86IHN0cmluZ1tdKTogc3RyaW5nW10ge1xuICByZXR1cm4gKHByb2plY3RzID8/IFtdKS5mbGF0TWFwKChwcm9qZWN0KSA9PiBbYC0tcHJvamVjdD0ke3Byb2plY3R9YCwgYC0tcHJvamVjdD0ke3Byb2plY3R9OipgXSk7XG59XG5cbi8qIHY4IGlnbm9yZSBzdG9wICovXG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQVFBLFNBQVMsb0JBQW9CO0FBb0M3QixlQUFzQixLQUFLLFVBQXVCLENBQUMsR0FBa0I7QUFDbkUsUUFBTSxhQUFhLENBQUMsVUFBVSxPQUFPLEdBQUcsa0JBQWtCLFFBQVEsUUFBUSxDQUFDLENBQUM7QUFDOUU7QUFRQSxlQUFzQixhQUFhLFVBQStCLENBQUMsR0FBa0I7QUFDbkYsUUFBTSxZQUFZLE9BQU8sUUFBUSx5QkFBeUIsQ0FBQztBQUMzRCxRQUFNLGFBQWE7QUFBQSxJQUNqQjtBQUFBLElBQ0E7QUFBQSxJQUNBLEdBQUcsa0JBQWtCLFFBQVEsUUFBUTtBQUFBLElBQ3JDO0FBQUEsSUFDQSwrQkFBK0IsU0FBUztBQUFBLElBQ3hDLG1DQUFtQyxTQUFTO0FBQUEsSUFDNUMsa0NBQWtDLFNBQVM7QUFBQSxJQUMzQyxvQ0FBb0MsU0FBUztBQUFBLEVBQy9DLENBQUM7QUFDSDtBQVFBLGVBQXNCLFVBQVUsVUFBNEIsQ0FBQyxHQUFrQjtBQUM3RSxRQUFNLGFBQWEsQ0FBQyxVQUFVLEdBQUcsa0JBQWtCLFFBQVEsUUFBUSxDQUFDLENBQUM7QUFDdkU7QUFVQSxTQUFTLGtCQUFrQixVQUErQjtBQUN4RCxVQUFRLFlBQVksQ0FBQyxHQUFHLFFBQVEsQ0FBQyxZQUFZLENBQUMsYUFBYSxPQUFPLElBQUksYUFBYSxPQUFPLElBQUksQ0FBQztBQUNqRzsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/validate-declarations.d.mts

@@ -0,0 +1,37 @@
+/// <reference path="./index.d.mts" />
+/**
+ * @file
+ *
+ * Type-checks the generated declaration files (`.d.cts` / `.d.mts`) to prove they are self-contained
+ * — every `lib` and internal cross-reference they rely on resolves on its own, independent of the
+ * consumer's `tsconfig`.
+ *
+ * Only diagnostics whose source file is one we own (under the project root, outside `node_modules`)
+ * are reported. Diagnostics inside `node_modules` — broken upstream `.d.ts` files we do not control —
+ * are ignored. Cross-module-format interop diagnostics in our own declarations (for example a
+ * CommonJS `.d.cts` importing an ESM-only package, `TS1541` / `TS1542` / `TS1479`) are NOT ignored:
+ * they describe declarations we emit, so the generator must produce valid output (e.g. add the
+ * required `resolution-mode` attribute) rather than the validator hiding the problem.
+ */
+/**
+ * Options for {@link validateDeclarations}.
+ */
+export interface ValidateDeclarationsOptions {
+    /**
+     * When `true`, the ignored `node_modules` diagnostics are printed in full in addition to their
+     * count, so they can be inspected. When omitted or `false`, only the count is printed.
+     *
+     * @default `false`
+     */
+    readonly isVerbose?: boolean;
+}
+/**
+ * Validates the generated declaration files against the `tsconfig.validate-declarations*.json`
+ * configs, reporting every diagnostic that concerns the library's own declarations and ignoring only
+ * those whose source file lives in `node_modules`.
+ *
+ * @param options - The options controlling validation output.
+ * @returns `true` when the library's own declarations have no type errors, `false` otherwise.
+ * @throws If the root folder cannot be found.
+ */
+export declare function validateDeclarations(options?: ValidateDeclarationsOptions): boolean;

package/dist/lib/esm/validate-declarations.mjs

@@ -0,0 +1,87 @@
+/*
+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 { join } from "@mnaoumov/typescript-lib/path";
+import {
+  checkProjectTypes,
+  parseTsConfig,
+  toCanonical
+} from "./check-project-types.mjs";
+import { RepoPaths } from "./repo-paths.mjs";
+import { getRootFolder } from "./root.mjs";
+const NODE_MODULES_SEGMENT = "/node_modules/";
+const VALIDATE_DECLARATIONS_TS_CONFIG_FILE_NAMES = [
+  RepoPaths.TsConfigValidateDeclarationsJson,
+  RepoPaths.TsConfigValidateDeclarationsCjsJson
+];
+function validateDeclarations(options = {}) {
+  const root = getRootFolder();
+  if (!root) {
+    throw new Error("Could not find root folder");
+  }
+  const rootCanonical = toCanonical(root);
+  let isValid = true;
+  for (const tsConfigFileName of VALIDATE_DECLARATIONS_TS_CONFIG_FILE_NAMES) {
+    const { fileNames, options: compilerOptions } = parseTsConfig(join(root, tsConfigFileName));
+    const isConfigValid = checkProjectTypes({
+      isVerbose: options.isVerbose ?? false,
+      options: compilerOptions,
+      rootNames: fileNames,
+      shouldKeepFile: (fileName) => shouldKeepProjectFile({ fileName, rootCanonical })
+    });
+    isValid &&= isConfigValid;
+  }
+  return isValid;
+}
+function shouldKeepProjectFile(params) {
+  const { fileName, rootCanonical } = params;
+  return fileName.startsWith(`${rootCanonical}/`) && !fileName.includes(NODE_MODULES_SEGMENT);
+}
+export {
+  validateDeclarations
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3ZhbGlkYXRlLWRlY2xhcmF0aW9ucy50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFR5cGUtY2hlY2tzIHRoZSBnZW5lcmF0ZWQgZGVjbGFyYXRpb24gZmlsZXMgKGAuZC5jdHNgIC8gYC5kLm10c2ApIHRvIHByb3ZlIHRoZXkgYXJlIHNlbGYtY29udGFpbmVkXG4gKiBcdTIwMTQgZXZlcnkgYGxpYmAgYW5kIGludGVybmFsIGNyb3NzLXJlZmVyZW5jZSB0aGV5IHJlbHkgb24gcmVzb2x2ZXMgb24gaXRzIG93biwgaW5kZXBlbmRlbnQgb2YgdGhlXG4gKiBjb25zdW1lcidzIGB0c2NvbmZpZ2AuXG4gKlxuICogT25seSBkaWFnbm9zdGljcyB3aG9zZSBzb3VyY2UgZmlsZSBpcyBvbmUgd2Ugb3duICh1bmRlciB0aGUgcHJvamVjdCByb290LCBvdXRzaWRlIGBub2RlX21vZHVsZXNgKVxuICogYXJlIHJlcG9ydGVkLiBEaWFnbm9zdGljcyBpbnNpZGUgYG5vZGVfbW9kdWxlc2AgXHUyMDE0IGJyb2tlbiB1cHN0cmVhbSBgLmQudHNgIGZpbGVzIHdlIGRvIG5vdCBjb250cm9sIFx1MjAxNFxuICogYXJlIGlnbm9yZWQuIENyb3NzLW1vZHVsZS1mb3JtYXQgaW50ZXJvcCBkaWFnbm9zdGljcyBpbiBvdXIgb3duIGRlY2xhcmF0aW9ucyAoZm9yIGV4YW1wbGUgYVxuICogQ29tbW9uSlMgYC5kLmN0c2AgaW1wb3J0aW5nIGFuIEVTTS1vbmx5IHBhY2thZ2UsIGBUUzE1NDFgIC8gYFRTMTU0MmAgLyBgVFMxNDc5YCkgYXJlIE5PVCBpZ25vcmVkOlxuICogdGhleSBkZXNjcmliZSBkZWNsYXJhdGlvbnMgd2UgZW1pdCwgc28gdGhlIGdlbmVyYXRvciBtdXN0IHByb2R1Y2UgdmFsaWQgb3V0cHV0IChlLmcuIGFkZCB0aGVcbiAqIHJlcXVpcmVkIGByZXNvbHV0aW9uLW1vZGVgIGF0dHJpYnV0ZSkgcmF0aGVyIHRoYW4gdGhlIHZhbGlkYXRvciBoaWRpbmcgdGhlIHByb2JsZW0uXG4gKi9cblxuaW1wb3J0IHsgam9pbiB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9wYXRoJztcblxuaW1wb3J0IHtcbiAgY2hlY2tQcm9qZWN0VHlwZXMsXG4gIHBhcnNlVHNDb25maWcsXG4gIHRvQ2Fub25pY2FsXG59IGZyb20gJy4vY2hlY2stcHJvamVjdC10eXBlcy50cyc7XG5pbXBvcnQgeyBSZXBvUGF0aHMgfSBmcm9tICcuL3JlcG8tcGF0aHMudHMnO1xuaW1wb3J0IHsgZ2V0Um9vdEZvbGRlciB9IGZyb20gJy4vcm9vdC50cyc7XG5cbmNvbnN0IE5PREVfTU9EVUxFU19TRUdNRU5UID0gJy9ub2RlX21vZHVsZXMvJztcblxuY29uc3QgVkFMSURBVEVfREVDTEFSQVRJT05TX1RTX0NPTkZJR19GSUxFX05BTUVTID0gW1xuICBSZXBvUGF0aHMuVHNDb25maWdWYWxpZGF0ZURlY2xhcmF0aW9uc0pzb24sXG4gIFJlcG9QYXRocy5Uc0NvbmZpZ1ZhbGlkYXRlRGVjbGFyYXRpb25zQ2pzSnNvblxuXTtcblxuLyoqXG4gKiBPcHRpb25zIGZvciB7QGxpbmsgdmFsaWRhdGVEZWNsYXJhdGlvbnN9LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFZhbGlkYXRlRGVjbGFyYXRpb25zT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBXaGVuIGB0cnVlYCwgdGhlIGlnbm9yZWQgYG5vZGVfbW9kdWxlc2AgZGlhZ25vc3RpY3MgYXJlIHByaW50ZWQgaW4gZnVsbCBpbiBhZGRpdGlvbiB0byB0aGVpclxuICAgKiBjb3VudCwgc28gdGhleSBjYW4gYmUgaW5zcGVjdGVkLiBXaGVuIG9taXR0ZWQgb3IgYGZhbHNlYCwgb25seSB0aGUgY291bnQgaXMgcHJpbnRlZC5cbiAgICpcbiAgICogQGRlZmF1bHQgYGZhbHNlYFxuICAgKi9cbiAgcmVhZG9ubHkgaXNWZXJib3NlPzogYm9vbGVhbjtcbn1cblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgc2hvdWxkS2VlcFByb2plY3RGaWxlfS5cbiAqL1xuaW50ZXJmYWNlIFNob3VsZEtlZXBQcm9qZWN0RmlsZVBhcmFtcyB7XG4gIC8qKlxuICAgKiBBYnNvbHV0ZSBwYXRoIG9mIHRoZSBmaWxlIHVuZGVyIGNvbnNpZGVyYXRpb24uXG4gICAqL1xuICByZWFkb25seSBmaWxlTmFtZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBBYnNvbHV0ZSAoY2Fub25pY2FsKSBwYXRoIG9mIHRoZSBwcm9qZWN0IHJvb3QuXG4gICAqL1xuICByZWFkb25seSByb290Q2Fub25pY2FsOiBzdHJpbmc7XG59XG5cbi8qKlxuICogVmFsaWRhdGVzIHRoZSBnZW5lcmF0ZWQgZGVjbGFyYXRpb24gZmlsZXMgYWdhaW5zdCB0aGUgYHRzY29uZmlnLnZhbGlkYXRlLWRlY2xhcmF0aW9ucyouanNvbmBcbiAqIGNvbmZpZ3MsIHJlcG9ydGluZyBldmVyeSBkaWFnbm9zdGljIHRoYXQgY29uY2VybnMgdGhlIGxpYnJhcnkncyBvd24gZGVjbGFyYXRpb25zIGFuZCBpZ25vcmluZyBvbmx5XG4gKiB0aG9zZSB3aG9zZSBzb3VyY2UgZmlsZSBsaXZlcyBpbiBgbm9kZV9tb2R1bGVzYC5cbiAqXG4gKiBAcGFyYW0gb3B0aW9ucyAtIFRoZSBvcHRpb25zIGNvbnRyb2xsaW5nIHZhbGlkYXRpb24gb3V0cHV0LlxuICogQHJldHVybnMgYHRydWVgIHdoZW4gdGhlIGxpYnJhcnkncyBvd24gZGVjbGFyYXRpb25zIGhhdmUgbm8gdHlwZSBlcnJvcnMsIGBmYWxzZWAgb3RoZXJ3aXNlLlxuICogQHRocm93cyBJZiB0aGUgcm9vdCBmb2xkZXIgY2Fubm90IGJlIGZvdW5kLlxuICovXG4vLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgdW5pY29ybi9jb25zaXN0ZW50LWJvb2xlYW4tbmFtZSAtLSBUaGUgbmFtZSBzdGF0ZXMgdGhlIGFjdGlvbjsgdGhlIGJvb2xlYW4gb25seSByZXBvcnRzIHdoZXRoZXIgdmFsaWRhdGlvbiBwYXNzZWQuXG5leHBvcnQgZnVuY3Rpb24gdmFsaWRhdGVEZWNsYXJhdGlvbnMob3B0aW9uczogVmFsaWRhdGVEZWNsYXJhdGlvbnNPcHRpb25zID0ge30pOiBib29sZWFuIHtcbiAgY29uc3Qgcm9vdCA9IGdldFJvb3RGb2xkZXIoKTtcblxuICBpZiAoIXJvb3QpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IoJ0NvdWxkIG5vdCBmaW5kIHJvb3QgZm9sZGVyJyk7XG4gIH1cblxuICBjb25zdCByb290Q2Fub25pY2FsID0gdG9DYW5vbmljYWwocm9vdCk7XG5cbiAgbGV0IGlzVmFsaWQgPSB0cnVlO1xuXG4gIGZvciAoY29uc3QgdHNDb25maWdGaWxlTmFtZSBvZiBWQUxJREFURV9ERUNMQVJBVElPTlNfVFNfQ09ORklHX0ZJTEVfTkFNRVMpIHtcbiAgICBjb25zdCB7IGZpbGVOYW1lcywgb3B0aW9uczogY29tcGlsZXJPcHRpb25zIH0gPSBwYXJzZVRzQ29uZmlnKGpvaW4ocm9vdCwgdHNDb25maWdGaWxlTmFtZSkpO1xuICAgIGNvbnN0IGlzQ29uZmlnVmFsaWQgPSBjaGVja1Byb2plY3RUeXBlcyh7XG4gICAgICBpc1ZlcmJvc2U6IG9wdGlvbnMuaXNWZXJib3NlID8/IGZhbHNlLFxuICAgICAgb3B0aW9uczogY29tcGlsZXJPcHRpb25zLFxuICAgICAgcm9vdE5hbWVzOiBmaWxlTmFtZXMsXG4gICAgICBzaG91bGRLZWVwRmlsZTogKGZpbGVOYW1lKSA9PiBzaG91bGRLZWVwUHJvamVjdEZpbGUoeyBmaWxlTmFtZSwgcm9vdENhbm9uaWNhbCB9KVxuICAgIH0pO1xuICAgIGlzVmFsaWQgJiY9IGlzQ29uZmlnVmFsaWQ7XG4gIH1cblxuICByZXR1cm4gaXNWYWxpZDtcbn1cblxuLyoqXG4gKiBEZXRlcm1pbmVzIHdoZXRoZXIgYSBmaWxlIGJlbG9uZ3MgdG8gdGhlIHByb2plY3QgKHVuZGVyIHRoZSByb290IGZvbGRlciwgb3V0c2lkZSBgbm9kZV9tb2R1bGVzYCkuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIGZvciB0aGUgY2hlY2suXG4gKiBAcmV0dXJucyBgdHJ1ZWAgd2hlbiB0aGUgZmlsZSBiZWxvbmdzIHRvIHRoZSBwcm9qZWN0LlxuICovXG5mdW5jdGlvbiBzaG91bGRLZWVwUHJvamVjdEZpbGUocGFyYW1zOiBTaG91bGRLZWVwUHJvamVjdEZpbGVQYXJhbXMpOiBib29sZWFuIHtcbiAgY29uc3QgeyBmaWxlTmFtZSwgcm9vdENhbm9uaWNhbCB9ID0gcGFyYW1zO1xuICByZXR1cm4gZmlsZU5hbWUuc3RhcnRzV2l0aChgJHtyb290Q2Fub25pY2FsfS9gKSAmJiAhZmlsZU5hbWUuaW5jbHVkZXMoTk9ERV9NT0RVTEVTX1NFR01FTlQpO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFlQSxTQUFTLFlBQVk7QUFFckI7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxPQUNLO0FBQ1AsU0FBUyxpQkFBaUI7QUFDMUIsU0FBUyxxQkFBcUI7QUFFOUIsTUFBTSx1QkFBdUI7QUFFN0IsTUFBTSw2Q0FBNkM7QUFBQSxFQUNqRCxVQUFVO0FBQUEsRUFDVixVQUFVO0FBQ1o7QUF3Q08sU0FBUyxxQkFBcUIsVUFBdUMsQ0FBQyxHQUFZO0FBQ3ZGLFFBQU0sT0FBTyxjQUFjO0FBRTNCLE1BQUksQ0FBQyxNQUFNO0FBQ1QsVUFBTSxJQUFJLE1BQU0sNEJBQTRCO0FBQUEsRUFDOUM7QUFFQSxRQUFNLGdCQUFnQixZQUFZLElBQUk7QUFFdEMsTUFBSSxVQUFVO0FBRWQsYUFBVyxvQkFBb0IsNENBQTRDO0FBQ3pFLFVBQU0sRUFBRSxXQUFXLFNBQVMsZ0JBQWdCLElBQUksY0FBYyxLQUFLLE1BQU0sZ0JBQWdCLENBQUM7QUFDMUYsVUFBTSxnQkFBZ0Isa0JBQWtCO0FBQUEsTUFDdEMsV0FBVyxRQUFRLGFBQWE7QUFBQSxNQUNoQyxTQUFTO0FBQUEsTUFDVCxXQUFXO0FBQUEsTUFDWCxnQkFBZ0IsQ0FBQyxhQUFhLHNCQUFzQixFQUFFLFVBQVUsY0FBYyxDQUFDO0FBQUEsSUFDakYsQ0FBQztBQUNELGdCQUFZO0FBQUEsRUFDZDtBQUVBLFNBQU87QUFDVDtBQVFBLFNBQVMsc0JBQXNCLFFBQThDO0FBQzNFLFFBQU0sRUFBRSxVQUFVLGNBQWMsSUFBSTtBQUNwQyxTQUFPLFNBQVMsV0FBVyxHQUFHLGFBQWEsR0FBRyxLQUFLLENBQUMsU0FBUyxTQUFTLG9CQUFvQjtBQUM1RjsiLAogICJuYW1lcyI6IFtdCn0K