@mnaoumov/obsidian-dev-toolkit 0.0.0 → 1.1.0

package/dist/lib/esm/test-runners/integration-test-plugin.mjs

@@ -0,0 +1,94 @@
+/*
+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 { getRootFolder } from "@mnaoumov/typescript-dev-toolkit/root";
+import {
+  getFolderName,
+  join
+} from "@mnaoumov/typescript-lib/path";
+import { readFileSync } from "node:fs";
+import { registerLibResolver } from "obsidian-integration-testing";
+import { ObsidianPluginRepoPaths } from "../obsidian-plugin-repo-paths.mjs";
+const OBSIDIAN_DEV_UTILS_INTEGRATION_TEST_PLUGIN_ID = "obsidian-dev-utils-integration-test";
+function getIntegrationTestPluginPopulate() {
+  const packageFolder = getRootFolder(getFolderName(import.meta.url));
+  if (!packageFolder) {
+    throw new Error("Could not resolve the obsidian-dev-utils package folder to seed the integration-test harness plugin.");
+  }
+  const pluginSourceFolder = join(packageFolder, ObsidianPluginRepoPaths.DistIntegrationTestPlugin);
+  const pluginVaultFolder = join(
+    ObsidianPluginRepoPaths.DotObsidian,
+    ObsidianPluginRepoPaths.Plugins,
+    OBSIDIAN_DEV_UTILS_INTEGRATION_TEST_PLUGIN_ID
+  );
+  const populate = {};
+  for (const fileName of [ObsidianPluginRepoPaths.MainJs, ObsidianPluginRepoPaths.ManifestJson]) {
+    const sourcePath = join(pluginSourceFolder, fileName);
+    let content;
+    try {
+      content = readFileSync(sourcePath);
+    } catch (error) {
+      throw new Error(
+        `Could not read ${sourcePath}. The integration-test harness plugin is missing from the installed obsidian-dev-utils package \u2014 run \`npm run build\` in obsidian-dev-utils, or reinstall it.`,
+        { cause: error }
+      );
+    }
+    populate[join(pluginVaultFolder, fileName)] = content;
+  }
+  return populate;
+}
+function registerIntegrationTestLibResolver() {
+  registerLibResolver(() => {
+    const obsidianDevUtilsModule = window.__obsidianDevUtilsModule;
+    if (!obsidianDevUtilsModule) {
+      throw new Error(
+        "The obsidian-dev-utils module is not exposed on `window`. Is the obsidian-dev-utils integration-test harness plugin installed and enabled in the test vault? See `obsidian-dev-utils/integration-test-vitest-global-setup`."
+      );
+    }
+    return obsidianDevUtilsModule.__merged;
+  });
+}
+export {
+  OBSIDIAN_DEV_UTILS_INTEGRATION_TEST_PLUGIN_ID,
+  getIntegrationTestPluginPopulate,
+  registerIntegrationTestLibResolver
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3Rlc3QtcnVubmVycy9pbnRlZ3JhdGlvbi10ZXN0LXBsdWdpbi50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFdpcmVzIHRoZSBzaGlwcGVkIGludGVncmF0aW9uLXRlc3QgaGFybmVzcyBwbHVnaW4gaW50byBhIGNvbnN1bWVyIHBsdWdpbidzIGludGVncmF0aW9uIHRlc3RzLCBzbyBldmVyeVxuICogbGlicmFyeSBoZWxwZXIgaXMgcmVhY2hhYmxlIGFzIGBsaWIuPGhlbHBlcj5gIGluc2lkZSBhbiBgZXZhbEluT2JzaWRpYW5gIGNsb3N1cmUuXG4gKlxuICogVHdvIGhhbHZlcywgYW5kIGJvdGggbXVzdCBiZSB3aXJlZCBvciBgbGliLjxoZWxwZXI+YCBmYWlsczpcbiAqXG4gKiAtIHtAbGluayBnZXRJbnRlZ3JhdGlvblRlc3RQbHVnaW5Qb3B1bGF0ZX0gcHV0cyB0aGUgaGFybmVzcyBwbHVnaW4ncyBiaW5hcmllcyBpbiB0aGUgdGVzdCB2YXVsdC4gVGhlXG4gKiAgIGhhcm5lc3MgcGx1Z2luIGlzIHdoYXQgcHVibGlzaGVzIHRoZSBsaWJyYXJ5IG9uIGB3aW5kb3cuX19vYnNpZGlhbkRldlV0aWxzTW9kdWxlYDsgaW4gdGhpcyByZXBvJ3Mgb3duXG4gKiAgIHN1aXRlIGl0IElTIHRoZSBwbHVnaW4tdW5kZXItdGVzdCwgYnV0IGluIGEgY29uc3VtZXIncyBzdWl0ZSB0aGUgcGx1Z2luLXVuZGVyLXRlc3QgaXMgdGhlIGNvbnN1bWVyJ3Mgb3duXG4gKiAgIHBsdWdpbiwgc28gdGhlIGhhcm5lc3MgaGFzIHRvIHJpZGUgYWxvbmcgYXMgYSBzZWNvbmQsIHRlc3Qtb25seSBjb21tdW5pdHkgcGx1Z2luIFx1MjAxNCBzZWVkZWQgaGVyZSwgYW5kXG4gKiAgIHR1cm5lZCBvbiBieSBgb2JzaWRpYW4taW50ZWdyYXRpb24tdGVzdGluZ2AncyBgY3JlYXRlU2V0dXAoeyBlbmFibGVDb21tdW5pdHlQbHVnaW5zIH0pYC5cbiAqIC0ge0BsaW5rIHJlZ2lzdGVySW50ZWdyYXRpb25UZXN0TGliUmVzb2x2ZXJ9IHJlZ2lzdGVycyB0aGUgcmVuZGVyZXItc2lkZSByZXNvbHZlciB0aGF0IHJlYWRzIHRoYXQgZ2xvYmFsLlxuICpcbiAqIGBvYnNpZGlhbi1kZXYtdXRpbHMvaW50ZWdyYXRpb24tdGVzdC12aXRlc3QtZ2xvYmFsLXNldHVwYCBhbmRcbiAqIGBvYnNpZGlhbi1kZXYtdXRpbHMvaW50ZWdyYXRpb24tdGVzdC1zZXR1cGAgYXJlIHRoZSB0dXJua2V5IGVuZHBvaW50cyB0aGF0IGNhbGwgdGhlc2UgZm9yIHlvdS5cbiAqL1xuXG5pbXBvcnQgeyBnZXRSb290Rm9sZGVyIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtZGV2LXRvb2xraXQvcm9vdCc7XG5pbXBvcnQge1xuICBnZXRGb2xkZXJOYW1lLFxuICBqb2luXG59IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9wYXRoJztcbmltcG9ydCB7IHJlYWRGaWxlU3luYyB9IGZyb20gJ25vZGU6ZnMnO1xuaW1wb3J0IHsgcmVnaXN0ZXJMaWJSZXNvbHZlciB9IGZyb20gJ29ic2lkaWFuLWludGVncmF0aW9uLXRlc3RpbmcnO1xuXG5pbXBvcnQgeyBPYnNpZGlhblBsdWdpblJlcG9QYXRocyB9IGZyb20gJy4uL29ic2lkaWFuLXBsdWdpbi1yZXBvLXBhdGhzLnRzJztcblxuLyoqXG4gKiBUaGUgaWQgb2YgdGhlIGludGVncmF0aW9uLXRlc3QgaGFybmVzcyBwbHVnaW4gXHUyMDE0IHRoZSBmb2xkZXIgbmFtZSBpdCBpcyBzZWVkZWQgaW50bywgYW5kIHRoZSB2YWx1ZSB0byBwYXNzXG4gKiB0byBgY3JlYXRlU2V0dXAoeyBlbmFibGVDb21tdW5pdHlQbHVnaW5zIH0pYCBzbyB0aGUgaGFybmVzcyBlbmFibGVzIGl0IGFmdGVyIHRoZSBwbHVnaW4tdW5kZXItdGVzdC5cbiAqL1xuZXhwb3J0IGNvbnN0IE9CU0lESUFOX0RFVl9VVElMU19JTlRFR1JBVElPTl9URVNUX1BMVUdJTl9JRCA9ICdvYnNpZGlhbi1kZXYtdXRpbHMtaW50ZWdyYXRpb24tdGVzdCc7XG5cbi8qKlxuICogVGhlIGZsYXQgbGlicmFyeSBiYXJyZWwgdGhlIGhhcm5lc3MgcGx1Z2luIHB1Ymxpc2hlcy5cbiAqL1xuaW50ZXJmYWNlIE9ic2lkaWFuRGV2VXRpbHNNb2R1bGUge1xuICBfX21lcmdlZDogb2JqZWN0O1xufVxuXG4vKipcbiAqIFRoZSBzaGFwZSB0aGUgaGFybmVzcyBwbHVnaW4gcHVibGlzaGVzIG9uIHRoZSByZW5kZXJlcidzIGB3aW5kb3dgLlxuICovXG5pbnRlcmZhY2UgT2JzaWRpYW5EZXZVdGlsc01vZHVsZVdpbmRvdyB7XG4gIF9fb2JzaWRpYW5EZXZVdGlsc01vZHVsZTogT2JzaWRpYW5EZXZVdGlsc01vZHVsZTtcbn1cblxuLyoqXG4gKiBCdWlsZHMgdGhlIHZhdWx0LXJlbGF0aXZlIGZpbGUgbWFwIHRoYXQgaW5zdGFsbHMgdGhlIHNoaXBwZWQgaW50ZWdyYXRpb24tdGVzdCBoYXJuZXNzIHBsdWdpbiwgcmVhZHkgdG9cbiAqIGhhbmQgdG8gYSBnbG9iYWwgc2V0dXAncyBgcG9wdWxhdGVgIChvciB0byBtZXJnZSBpbnRvIGEgbGFyZ2VyIG1hcCB0aGUgY29uc3VtZXIgYWxyZWFkeSBidWlsZHMpLlxuICpcbiAqIFRoZSByZXN1bHQgaXMgYSBgUmVjb3JkPHN0cmluZywgVWludDhBcnJheT5gLCB3aGljaCBpcyBhc3NpZ25hYmxlIHRvIGBvYnNpZGlhbi1pbnRlZ3JhdGlvbi10ZXN0aW5nYCdzXG4gKiBgUG9wdWxhdGVGaWxlc1BhcmFtc2AgXHUyMDE0IHNvIGl0IGNvbXBvc2VzIHdpdGggYGJ1aWxkRGVtb1ZhdWx0UG9wdWxhdGVgIGFuZCBmcmllbmRzLlxuICpcbiAqIEByZXR1cm5zIFRoZSBtYXAgb2YgdmF1bHQtcmVsYXRpdmUgcGF0aHMgdG8gZmlsZSBjb250ZW50cy5cbiAqIEB0aHJvd3MgSWYgdGhlIGhhcm5lc3MgcGx1Z2luIHdhcyBub3QgYnVpbHQgaW50byB0aGlzIHBhY2thZ2UgXHUyMDE0IGkuZS4gYG5wbSBydW4gYnVpbGRgIG5ldmVyIHJhbi5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldEludGVncmF0aW9uVGVzdFBsdWdpblBvcHVsYXRlKCk6IFJlY29yZDxzdHJpbmcsIFVpbnQ4QXJyYXk+IHtcbiAgY29uc3QgcGFja2FnZUZvbGRlciA9IGdldFJvb3RGb2xkZXIoZ2V0Rm9sZGVyTmFtZShpbXBvcnQubWV0YS51cmwpKTtcbiAgaWYgKCFwYWNrYWdlRm9sZGVyKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKCdDb3VsZCBub3QgcmVzb2x2ZSB0aGUgb2JzaWRpYW4tZGV2LXV0aWxzIHBhY2thZ2UgZm9sZGVyIHRvIHNlZWQgdGhlIGludGVncmF0aW9uLXRlc3QgaGFybmVzcyBwbHVnaW4uJyk7XG4gIH1cblxuICBjb25zdCBwbHVnaW5Tb3VyY2VGb2xkZXIgPSBqb2luKHBhY2thZ2VGb2xkZXIsIE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLkRpc3RJbnRlZ3JhdGlvblRlc3RQbHVnaW4pO1xuICBjb25zdCBwbHVnaW5WYXVsdEZvbGRlciA9IGpvaW4oXG4gICAgT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuRG90T2JzaWRpYW4sXG4gICAgT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuUGx1Z2lucyxcbiAgICBPQlNJRElBTl9ERVZfVVRJTFNfSU5URUdSQVRJT05fVEVTVF9QTFVHSU5fSURcbiAgKTtcblxuICBjb25zdCBwb3B1bGF0ZTogUmVjb3JkPHN0cmluZywgVWludDhBcnJheT4gPSB7fTtcblxuICBmb3IgKGNvbnN0IGZpbGVOYW1lIG9mIFtPYnNpZGlhblBsdWdpblJlcG9QYXRocy5NYWluSnMsIE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLk1hbmlmZXN0SnNvbl0pIHtcbiAgICBjb25zdCBzb3VyY2VQYXRoID0gam9pbihwbHVnaW5Tb3VyY2VGb2xkZXIsIGZpbGVOYW1lKTtcbiAgICBsZXQgY29udGVudDogVWludDhBcnJheTtcbiAgICB0cnkge1xuICAgICAgY29udGVudCA9IHJlYWRGaWxlU3luYyhzb3VyY2VQYXRoKTtcbiAgICB9IGNhdGNoIChlcnJvcjogdW5rbm93bikge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgICBgQ291bGQgbm90IHJlYWQgJHtzb3VyY2VQYXRofS4gVGhlIGludGVncmF0aW9uLXRlc3QgaGFybmVzcyBwbHVnaW4gaXMgbWlzc2luZyBmcm9tIHRoZSBpbnN0YWxsZWQgYFxuICAgICAgICAgICsgJ29ic2lkaWFuLWRldi11dGlscyBwYWNrYWdlIFx1MjAxNCBydW4gYG5wbSBydW4gYnVpbGRgIGluIG9ic2lkaWFuLWRldi11dGlscywgb3IgcmVpbnN0YWxsIGl0LicsXG4gICAgICAgIHsgY2F1c2U6IGVycm9yIH1cbiAgICAgICk7XG4gICAgfVxuICAgIHBvcHVsYXRlW2pvaW4ocGx1Z2luVmF1bHRGb2xkZXIsIGZpbGVOYW1lKV0gPSBjb250ZW50O1xuICB9XG5cbiAgcmV0dXJuIHBvcHVsYXRlO1xufVxuXG4vKipcbiAqIFJlZ2lzdGVycyB0aGUgcmVuZGVyZXItc2lkZSByZXNvbHZlciB0aGF0IG1lcmdlcyB0aGUgd2hvbGUgbGlicmFyeSBpbnRvIHRoZSBgbGliYCBhcmd1bWVudCBvZiBldmVyeVxuICogYGV2YWxJbk9ic2lkaWFuYCBjYWxsYmFjaywgcmVhZGluZyBpdCBmcm9tIHRoZSBnbG9iYWwgdGhlIGhhcm5lc3MgcGx1Z2luIHB1Ymxpc2hlcy5cbiAqXG4gKiBDYWxsIG9uY2UgcGVyIHRlc3Qgd29ya2VyIFx1MjAxNCB0aGUgcHVibGlzaGVkIGBvYnNpZGlhbi1kZXYtdXRpbHMvaW50ZWdyYXRpb24tdGVzdC1zZXR1cGAgZW5kcG9pbnQgZG9lcyBpdFxuICogZm9yIHlvdSB3aGVuIGxpc3RlZCBpbiBgc2V0dXBGaWxlc2AuIFJlZ2lzdHJhdGlvbiBpcyBpZGVtcG90ZW50ICh0aGUgaGFybmVzcyBkZWR1cGVzIHJlc29sdmVycyBieSBzb3VyY2VcbiAqIHRleHQpLCBzbyBjYWxsaW5nIGl0IG1vcmUgdGhhbiBvbmNlIGlzIHNhZmUuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiByZWdpc3RlckludGVncmF0aW9uVGVzdExpYlJlc29sdmVyKCk6IHZvaWQge1xuICByZWdpc3RlckxpYlJlc29sdmVyKCgpOiBvYmplY3QgPT4ge1xuICAgIGNvbnN0IG9ic2lkaWFuRGV2VXRpbHNNb2R1bGUgPSAod2luZG93IGFzIFBhcnRpYWw8T2JzaWRpYW5EZXZVdGlsc01vZHVsZVdpbmRvdz4pLl9fb2JzaWRpYW5EZXZVdGlsc01vZHVsZTtcbiAgICBpZiAoIW9ic2lkaWFuRGV2VXRpbHNNb2R1bGUpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgICAgJ1RoZSBvYnNpZGlhbi1kZXYtdXRpbHMgbW9kdWxlIGlzIG5vdCBleHBvc2VkIG9uIGB3aW5kb3dgLiBJcyB0aGUgb2JzaWRpYW4tZGV2LXV0aWxzIGludGVncmF0aW9uLXRlc3QgJ1xuICAgICAgICAgICsgJ2hhcm5lc3MgcGx1Z2luIGluc3RhbGxlZCBhbmQgZW5hYmxlZCBpbiB0aGUgdGVzdCB2YXVsdD8gU2VlICdcbiAgICAgICAgICArICdgb2JzaWRpYW4tZGV2LXV0aWxzL2ludGVncmF0aW9uLXRlc3Qtdml0ZXN0LWdsb2JhbC1zZXR1cGAuJ1xuICAgICAgKTtcbiAgICB9XG4gICAgcmV0dXJuIG9ic2lkaWFuRGV2VXRpbHNNb2R1bGUuX19tZXJnZWQ7XG4gIH0pO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFtQkEsU0FBUyxxQkFBcUI7QUFDOUI7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFDUCxTQUFTLG9CQUFvQjtBQUM3QixTQUFTLDJCQUEyQjtBQUVwQyxTQUFTLCtCQUErQjtBQU1qQyxNQUFNLGdEQUFnRDtBQTBCdEQsU0FBUyxtQ0FBK0Q7QUFDN0UsUUFBTSxnQkFBZ0IsY0FBYyxjQUFjLFlBQVksR0FBRyxDQUFDO0FBQ2xFLE1BQUksQ0FBQyxlQUFlO0FBQ2xCLFVBQU0sSUFBSSxNQUFNLHNHQUFzRztBQUFBLEVBQ3hIO0FBRUEsUUFBTSxxQkFBcUIsS0FBSyxlQUFlLHdCQUF3Qix5QkFBeUI7QUFDaEcsUUFBTSxvQkFBb0I7QUFBQSxJQUN4Qix3QkFBd0I7QUFBQSxJQUN4Qix3QkFBd0I7QUFBQSxJQUN4QjtBQUFBLEVBQ0Y7QUFFQSxRQUFNLFdBQXVDLENBQUM7QUFFOUMsYUFBVyxZQUFZLENBQUMsd0JBQXdCLFFBQVEsd0JBQXdCLFlBQVksR0FBRztBQUM3RixVQUFNLGFBQWEsS0FBSyxvQkFBb0IsUUFBUTtBQUNwRCxRQUFJO0FBQ0osUUFBSTtBQUNGLGdCQUFVLGFBQWEsVUFBVTtBQUFBLElBQ25DLFNBQVMsT0FBZ0I7QUFDdkIsWUFBTSxJQUFJO0FBQUEsUUFDUixrQkFBa0IsVUFBVTtBQUFBLFFBRTVCLEVBQUUsT0FBTyxNQUFNO0FBQUEsTUFDakI7QUFBQSxJQUNGO0FBQ0EsYUFBUyxLQUFLLG1CQUFtQixRQUFRLENBQUMsSUFBSTtBQUFBLEVBQ2hEO0FBRUEsU0FBTztBQUNUO0FBVU8sU0FBUyxxQ0FBMkM7QUFDekQsc0JBQW9CLE1BQWM7QUFDaEMsVUFBTSx5QkFBMEIsT0FBaUQ7QUFDakYsUUFBSSxDQUFDLHdCQUF3QjtBQUMzQixZQUFNLElBQUk7QUFBQSxRQUNSO0FBQUEsTUFHRjtBQUFBLElBQ0Y7QUFDQSxXQUFPLHVCQUF1QjtBQUFBLEVBQ2hDLENBQUM7QUFDSDsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/test-runners/performance-eval-cap.d.mts

@@ -0,0 +1,27 @@
+/// <reference path="../index.d.mts" />
+/**
+ * @file
+ *
+ * The per-eval cap of the `integration-tests:desktop-performance` project, and the file suffix that
+ * project collects.
+ *
+ * Both live here, rather than in `vitest-config.ts`, because the `no-over-cap-wait-in-eval-in-obsidian`
+ * ESLint rule reads them too, and the shared ESLint config loads that rule in every consuming repo:
+ * importing `vitest-config.ts` from the rule would load `vitest/config` at lint time for nothing.
+ */
+/**
+ * The per-eval cap the `integration-tests:desktop-performance` project gives its CDP transport, in
+ * milliseconds.
+ *
+ * Every other project keeps the transport's own `DEFAULT_EVAL_CAP_IN_MILLISECONDS` (30 000), and a repo
+ * that raises its desktop cap above that is setting a BACKSTOP, not a budget a closure may spend. The
+ * performance project is the one exception, and a deliberate one: its whole measurement is one long
+ * in-page `Runtime.evaluate` over a vault of tens of thousands of notes, and its files run on no other
+ * project. A cross-platform suite gains nothing from any desktop raise, because Appium caps it at
+ * 30 000 whatever the desktop project says.
+ */
+export declare const PERFORMANCE_EVAL_CAP_IN_MILLISECONDS = 600000;
+/**
+ * The file-name suffix of a suite the `integration-tests:desktop-performance` project collects.
+ */
+export declare const DESKTOP_PERFORMANCE_TEST_FILE_SUFFIX = ".desktop-performance.integration.test.ts";

package/dist/lib/esm/test-runners/performance-eval-cap.mjs

@@ -0,0 +1,48 @@
+/*
+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 PERFORMANCE_EVAL_CAP_IN_MILLISECONDS = 6e5;
+const DESKTOP_PERFORMANCE_TEST_FILE_SUFFIX = ".desktop-performance.integration.test.ts";
+export {
+  DESKTOP_PERFORMANCE_TEST_FILE_SUFFIX,
+  PERFORMANCE_EVAL_CAP_IN_MILLISECONDS
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3Rlc3QtcnVubmVycy9wZXJmb3JtYW5jZS1ldmFsLWNhcC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRoZSBwZXItZXZhbCBjYXAgb2YgdGhlIGBpbnRlZ3JhdGlvbi10ZXN0czpkZXNrdG9wLXBlcmZvcm1hbmNlYCBwcm9qZWN0LCBhbmQgdGhlIGZpbGUgc3VmZml4IHRoYXRcbiAqIHByb2plY3QgY29sbGVjdHMuXG4gKlxuICogQm90aCBsaXZlIGhlcmUsIHJhdGhlciB0aGFuIGluIGB2aXRlc3QtY29uZmlnLnRzYCwgYmVjYXVzZSB0aGUgYG5vLW92ZXItY2FwLXdhaXQtaW4tZXZhbC1pbi1vYnNpZGlhbmBcbiAqIEVTTGludCBydWxlIHJlYWRzIHRoZW0gdG9vLCBhbmQgdGhlIHNoYXJlZCBFU0xpbnQgY29uZmlnIGxvYWRzIHRoYXQgcnVsZSBpbiBldmVyeSBjb25zdW1pbmcgcmVwbzpcbiAqIGltcG9ydGluZyBgdml0ZXN0LWNvbmZpZy50c2AgZnJvbSB0aGUgcnVsZSB3b3VsZCBsb2FkIGB2aXRlc3QvY29uZmlnYCBhdCBsaW50IHRpbWUgZm9yIG5vdGhpbmcuXG4gKi9cblxuLyoqXG4gKiBUaGUgcGVyLWV2YWwgY2FwIHRoZSBgaW50ZWdyYXRpb24tdGVzdHM6ZGVza3RvcC1wZXJmb3JtYW5jZWAgcHJvamVjdCBnaXZlcyBpdHMgQ0RQIHRyYW5zcG9ydCwgaW5cbiAqIG1pbGxpc2Vjb25kcy5cbiAqXG4gKiBFdmVyeSBvdGhlciBwcm9qZWN0IGtlZXBzIHRoZSB0cmFuc3BvcnQncyBvd24gYERFRkFVTFRfRVZBTF9DQVBfSU5fTUlMTElTRUNPTkRTYCAoMzAgMDAwKSwgYW5kIGEgcmVwb1xuICogdGhhdCByYWlzZXMgaXRzIGRlc2t0b3AgY2FwIGFib3ZlIHRoYXQgaXMgc2V0dGluZyBhIEJBQ0tTVE9QLCBub3QgYSBidWRnZXQgYSBjbG9zdXJlIG1heSBzcGVuZC4gVGhlXG4gKiBwZXJmb3JtYW5jZSBwcm9qZWN0IGlzIHRoZSBvbmUgZXhjZXB0aW9uLCBhbmQgYSBkZWxpYmVyYXRlIG9uZTogaXRzIHdob2xlIG1lYXN1cmVtZW50IGlzIG9uZSBsb25nXG4gKiBpbi1wYWdlIGBSdW50aW1lLmV2YWx1YXRlYCBvdmVyIGEgdmF1bHQgb2YgdGVucyBvZiB0aG91c2FuZHMgb2Ygbm90ZXMsIGFuZCBpdHMgZmlsZXMgcnVuIG9uIG5vIG90aGVyXG4gKiBwcm9qZWN0LiBBIGNyb3NzLXBsYXRmb3JtIHN1aXRlIGdhaW5zIG5vdGhpbmcgZnJvbSBhbnkgZGVza3RvcCByYWlzZSwgYmVjYXVzZSBBcHBpdW0gY2FwcyBpdCBhdFxuICogMzAgMDAwIHdoYXRldmVyIHRoZSBkZXNrdG9wIHByb2plY3Qgc2F5cy5cbiAqL1xuZXhwb3J0IGNvbnN0IFBFUkZPUk1BTkNFX0VWQUxfQ0FQX0lOX01JTExJU0VDT05EUyA9IDYwMF8wMDA7XG5cbi8qKlxuICogVGhlIGZpbGUtbmFtZSBzdWZmaXggb2YgYSBzdWl0ZSB0aGUgYGludGVncmF0aW9uLXRlc3RzOmRlc2t0b3AtcGVyZm9ybWFuY2VgIHByb2plY3QgY29sbGVjdHMuXG4gKi9cbmV4cG9ydCBjb25zdCBERVNLVE9QX1BFUkZPUk1BTkNFX1RFU1RfRklMRV9TVUZGSVggPSAnLmRlc2t0b3AtcGVyZm9ybWFuY2UuaW50ZWdyYXRpb24udGVzdC50cyc7XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQXNCTyxNQUFNLHVDQUF1QztBQUs3QyxNQUFNLHVDQUF1QzsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/test-runners/stale-build-global-setup.d.mts

@@ -0,0 +1,86 @@
+/// <reference path="../index.d.mts" />
+/**
+ * @file
+ *
+ * Vitest global setup that refuses to start an integration project whose plugin build is stale.
+ *
+ * The integration harness enables the plugin from its BUILD, `dist/build/main.js`, and a plugin's
+ * `test:integration*` scripts call vitest directly, so nothing on that path builds first. A session that
+ * edits `src/` and then runs one integration project tests the last build, however old it is, and the
+ * suite reports the old code as a behavior difference, not as a stale artifact. One such run cost a CDP
+ * probe into Obsidian's own link resolution, a wrong cache-race theory, and a harness change that was
+ * made and then reverted before anyone noticed that the build was three days old. `npm run gate` avoided
+ * the problem only because it happens to build before it runs `test:integration`.
+ *
+ * The setup refuses to start rather than building. A build inside a global setup would run once per
+ * project in a multi-project aggregate, and it would slow down a deliberate re-run of an unchanged build.
+ * A refusal is cheap, and it says what to run.
+ *
+ * Test files are not build inputs. Editing an integration case and re-running it is exactly the loop that
+ * must not force a rebuild, so `*.test.ts` files and `src/test-helpers/` are ignored. A dependency bump
+ * is not detected either: only files in the repo are compared, not `node_modules`.
+ */
+import type { TestProject } from 'vitest/node';
+/**
+ * Parameters for {@link findStaleBuild}.
+ */
+export interface FindStaleBuildParams {
+    /**
+     * The root folder of the plugin repo.
+     */
+    readonly rootFolder: string;
+}
+/**
+ * The build does not exist at all.
+ */
+export interface MissingBuild {
+    /**
+     * The discriminant.
+     */
+    readonly kind: 'missing';
+}
+/**
+ * The build exists but is older than one of its inputs.
+ */
+export interface OutdatedBuild {
+    /**
+     * The modification time of `dist/build/main.js`.
+     */
+    readonly buildModifiedAt: Date;
+    /**
+     * The discriminant.
+     */
+    readonly kind: 'outdated';
+    /**
+     * The modification time of {@link OutdatedBuild.newestInputPath}.
+     */
+    readonly newestInputModifiedAt: Date;
+    /**
+     * The newest build input, relative to the root folder.
+     */
+    readonly newestInputPath: string;
+}
+/**
+ * Why the build cannot be tested, as returned by {@link findStaleBuild}.
+ */
+export type StaleBuild = MissingBuild | OutdatedBuild;
+/**
+ * Checks whether `dist/build/main.js` is missing, or older than one of the files it is built from.
+ *
+ * @param params - The parameters.
+ * @returns `null` when the build is current; otherwise a description of the problem.
+ */
+export declare function findStaleBuild(params: FindStaleBuildParams): null | StaleBuild;
+/**
+ * Formats a {@link StaleBuild} as the message the setup throws.
+ *
+ * @param staleBuild - The stale build.
+ * @returns The message.
+ */
+export declare function formatStaleBuildMessage(staleBuild: StaleBuild): string;
+/**
+ * Vitest global setup: throws when the plugin build is missing or stale.
+ *
+ * @param project - The Vitest test project.
+ */
+export declare function setup(project: TestProject): void;

package/dist/lib/esm/test-runners/stale-build-global-setup.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 { toPosixPath } from "@mnaoumov/typescript-lib/path";
+import {
+  existsSync,
+  readdirSync,
+  statSync
+} from "node:fs";
+import {
+  join,
+  relative,
+  sep
+} from "node:path";
+import { ObsidianPluginRepoPaths } from "../obsidian-plugin-repo-paths.mjs";
+const BUILD_PATH = `${ObsidianPluginRepoPaths.DistBuild}/${ObsidianPluginRepoPaths.MainJs}`;
+const ROOT_BUILD_INPUTS = [ObsidianPluginRepoPaths.ManifestJson, ObsidianPluginRepoPaths.StylesCss];
+const TEST_FILE_SUFFIX = ObsidianPluginRepoPaths.AnyTestTs.slice(1);
+function findStaleBuild(params) {
+  const buildPath = join(params.rootFolder, BUILD_PATH);
+  if (!existsSync(buildPath)) {
+    return { kind: "missing" };
+  }
+  const buildModifiedAt = statSync(buildPath).mtime;
+  let newestInputPath = null;
+  let newestInputModifiedAt = buildModifiedAt;
+  for (const inputPath of getBuildInputPaths(params.rootFolder)) {
+    const modifiedAt = statSync(inputPath).mtime;
+    if (modifiedAt <= newestInputModifiedAt) {
+      continue;
+    }
+    newestInputPath = inputPath;
+    newestInputModifiedAt = modifiedAt;
+  }
+  if (newestInputPath === null) {
+    return null;
+  }
+  return {
+    buildModifiedAt,
+    kind: "outdated",
+    newestInputModifiedAt,
+    newestInputPath: toPosixPath(relative(params.rootFolder, newestInputPath))
+  };
+}
+function formatStaleBuildMessage(staleBuild) {
+  return staleBuild.kind === "missing" ? `${BUILD_PATH} does not exist, so there is no plugin for the integration tests to load. Run \`npm run build\` first.` : `${BUILD_PATH} is older than ${staleBuild.newestInputPath} (built ${staleBuild.buildModifiedAt.toISOString()}, changed ${staleBuild.newestInputModifiedAt.toISOString()}), so the integration tests would run the previous build instead of the current source. Run \`npm run build\` first.`;
+}
+function setup(project) {
+  const staleBuild = findStaleBuild({ rootFolder: project.config.root });
+  if (staleBuild !== null) {
+    throw new Error(formatStaleBuildMessage(staleBuild));
+  }
+}
+function getBuildInputPaths(rootFolder) {
+  const paths = ROOT_BUILD_INPUTS.map((rootInput) => join(rootFolder, rootInput)).filter((path) => existsSync(path));
+  const srcFolder = join(rootFolder, ObsidianPluginRepoPaths.Src);
+  if (!existsSync(srcFolder)) {
+    return paths;
+  }
+  const testHelpersFolderPrefix = join(rootFolder, ObsidianPluginRepoPaths.Mocks) + sep;
+  for (const entry of readdirSync(srcFolder, { recursive: true, withFileTypes: true })) {
+    if (!entry.isFile() || entry.name.endsWith(TEST_FILE_SUFFIX)) {
+      continue;
+    }
+    const path = join(entry.parentPath, entry.name);
+    if (!path.startsWith(testHelpersFolderPrefix)) {
+      paths.push(path);
+    }
+  }
+  return paths;
+}
+export {
+  findStaleBuild,
+  formatStaleBuildMessage,
+  setup
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3Rlc3QtcnVubmVycy9zdGFsZS1idWlsZC1nbG9iYWwtc2V0dXAudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBWaXRlc3QgZ2xvYmFsIHNldHVwIHRoYXQgcmVmdXNlcyB0byBzdGFydCBhbiBpbnRlZ3JhdGlvbiBwcm9qZWN0IHdob3NlIHBsdWdpbiBidWlsZCBpcyBzdGFsZS5cbiAqXG4gKiBUaGUgaW50ZWdyYXRpb24gaGFybmVzcyBlbmFibGVzIHRoZSBwbHVnaW4gZnJvbSBpdHMgQlVJTEQsIGBkaXN0L2J1aWxkL21haW4uanNgLCBhbmQgYSBwbHVnaW4nc1xuICogYHRlc3Q6aW50ZWdyYXRpb24qYCBzY3JpcHRzIGNhbGwgdml0ZXN0IGRpcmVjdGx5LCBzbyBub3RoaW5nIG9uIHRoYXQgcGF0aCBidWlsZHMgZmlyc3QuIEEgc2Vzc2lvbiB0aGF0XG4gKiBlZGl0cyBgc3JjL2AgYW5kIHRoZW4gcnVucyBvbmUgaW50ZWdyYXRpb24gcHJvamVjdCB0ZXN0cyB0aGUgbGFzdCBidWlsZCwgaG93ZXZlciBvbGQgaXQgaXMsIGFuZCB0aGVcbiAqIHN1aXRlIHJlcG9ydHMgdGhlIG9sZCBjb2RlIGFzIGEgYmVoYXZpb3IgZGlmZmVyZW5jZSwgbm90IGFzIGEgc3RhbGUgYXJ0aWZhY3QuIE9uZSBzdWNoIHJ1biBjb3N0IGEgQ0RQXG4gKiBwcm9iZSBpbnRvIE9ic2lkaWFuJ3Mgb3duIGxpbmsgcmVzb2x1dGlvbiwgYSB3cm9uZyBjYWNoZS1yYWNlIHRoZW9yeSwgYW5kIGEgaGFybmVzcyBjaGFuZ2UgdGhhdCB3YXNcbiAqIG1hZGUgYW5kIHRoZW4gcmV2ZXJ0ZWQgYmVmb3JlIGFueW9uZSBub3RpY2VkIHRoYXQgdGhlIGJ1aWxkIHdhcyB0aHJlZSBkYXlzIG9sZC4gYG5wbSBydW4gZ2F0ZWAgYXZvaWRlZFxuICogdGhlIHByb2JsZW0gb25seSBiZWNhdXNlIGl0IGhhcHBlbnMgdG8gYnVpbGQgYmVmb3JlIGl0IHJ1bnMgYHRlc3Q6aW50ZWdyYXRpb25gLlxuICpcbiAqIFRoZSBzZXR1cCByZWZ1c2VzIHRvIHN0YXJ0IHJhdGhlciB0aGFuIGJ1aWxkaW5nLiBBIGJ1aWxkIGluc2lkZSBhIGdsb2JhbCBzZXR1cCB3b3VsZCBydW4gb25jZSBwZXJcbiAqIHByb2plY3QgaW4gYSBtdWx0aS1wcm9qZWN0IGFnZ3JlZ2F0ZSwgYW5kIGl0IHdvdWxkIHNsb3cgZG93biBhIGRlbGliZXJhdGUgcmUtcnVuIG9mIGFuIHVuY2hhbmdlZCBidWlsZC5cbiAqIEEgcmVmdXNhbCBpcyBjaGVhcCwgYW5kIGl0IHNheXMgd2hhdCB0byBydW4uXG4gKlxuICogVGVzdCBmaWxlcyBhcmUgbm90IGJ1aWxkIGlucHV0cy4gRWRpdGluZyBhbiBpbnRlZ3JhdGlvbiBjYXNlIGFuZCByZS1ydW5uaW5nIGl0IGlzIGV4YWN0bHkgdGhlIGxvb3AgdGhhdFxuICogbXVzdCBub3QgZm9yY2UgYSByZWJ1aWxkLCBzbyBgKi50ZXN0LnRzYCBmaWxlcyBhbmQgYHNyYy90ZXN0LWhlbHBlcnMvYCBhcmUgaWdub3JlZC4gQSBkZXBlbmRlbmN5IGJ1bXBcbiAqIGlzIG5vdCBkZXRlY3RlZCBlaXRoZXI6IG9ubHkgZmlsZXMgaW4gdGhlIHJlcG8gYXJlIGNvbXBhcmVkLCBub3QgYG5vZGVfbW9kdWxlc2AuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBUZXN0UHJvamVjdCB9IGZyb20gJ3ZpdGVzdC9ub2RlJztcblxuaW1wb3J0IHsgdG9Qb3NpeFBhdGggfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvcGF0aCc7XG5pbXBvcnQge1xuICBleGlzdHNTeW5jLFxuICByZWFkZGlyU3luYyxcbiAgc3RhdFN5bmNcbn0gZnJvbSAnbm9kZTpmcyc7XG5pbXBvcnQge1xuICBqb2luLFxuICByZWxhdGl2ZSxcbiAgc2VwXG59IGZyb20gJ25vZGU6cGF0aCc7XG5cbmltcG9ydCB7IE9ic2lkaWFuUGx1Z2luUmVwb1BhdGhzIH0gZnJvbSAnLi4vb2JzaWRpYW4tcGx1Z2luLXJlcG8tcGF0aHMudHMnO1xuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHtAbGluayBmaW5kU3RhbGVCdWlsZH0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRmluZFN0YWxlQnVpbGRQYXJhbXMge1xuICAvKipcbiAgICogVGhlIHJvb3QgZm9sZGVyIG9mIHRoZSBwbHVnaW4gcmVwby5cbiAgICovXG4gIHJlYWRvbmx5IHJvb3RGb2xkZXI6IHN0cmluZztcbn1cblxuLyoqXG4gKiBUaGUgYnVpbGQgZG9lcyBub3QgZXhpc3QgYXQgYWxsLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIE1pc3NpbmdCdWlsZCB7XG4gIC8qKlxuICAgKiBUaGUgZGlzY3JpbWluYW50LlxuICAgKi9cbiAgcmVhZG9ubHkga2luZDogJ21pc3NpbmcnO1xufVxuXG4vKipcbiAqIFRoZSBidWlsZCBleGlzdHMgYnV0IGlzIG9sZGVyIHRoYW4gb25lIG9mIGl0cyBpbnB1dHMuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgT3V0ZGF0ZWRCdWlsZCB7XG4gIC8qKlxuICAgKiBUaGUgbW9kaWZpY2F0aW9uIHRpbWUgb2YgYGRpc3QvYnVpbGQvbWFpbi5qc2AuXG4gICAqL1xuICByZWFkb25seSBidWlsZE1vZGlmaWVkQXQ6IERhdGU7XG5cbiAgLyoqXG4gICAqIFRoZSBkaXNjcmltaW5hbnQuXG4gICAqL1xuICByZWFkb25seSBraW5kOiAnb3V0ZGF0ZWQnO1xuXG4gIC8qKlxuICAgKiBUaGUgbW9kaWZpY2F0aW9uIHRpbWUgb2Yge0BsaW5rIE91dGRhdGVkQnVpbGQubmV3ZXN0SW5wdXRQYXRofS5cbiAgICovXG4gIHJlYWRvbmx5IG5ld2VzdElucHV0TW9kaWZpZWRBdDogRGF0ZTtcblxuICAvKipcbiAgICogVGhlIG5ld2VzdCBidWlsZCBpbnB1dCwgcmVsYXRpdmUgdG8gdGhlIHJvb3QgZm9sZGVyLlxuICAgKi9cbiAgcmVhZG9ubHkgbmV3ZXN0SW5wdXRQYXRoOiBzdHJpbmc7XG59XG5cbi8qKlxuICogV2h5IHRoZSBidWlsZCBjYW5ub3QgYmUgdGVzdGVkLCBhcyByZXR1cm5lZCBieSB7QGxpbmsgZmluZFN0YWxlQnVpbGR9LlxuICovXG5leHBvcnQgdHlwZSBTdGFsZUJ1aWxkID0gTWlzc2luZ0J1aWxkIHwgT3V0ZGF0ZWRCdWlsZDtcblxuY29uc3QgQlVJTERfUEFUSCA9IGAke09ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLkRpc3RCdWlsZH0vJHtPYnNpZGlhblBsdWdpblJlcG9QYXRocy5NYWluSnN9YDtcbmNvbnN0IFJPT1RfQlVJTERfSU5QVVRTID0gW09ic2lkaWFuUGx1Z2luUmVwb1BhdGhzLk1hbmlmZXN0SnNvbiwgT2JzaWRpYW5QbHVnaW5SZXBvUGF0aHMuU3R5bGVzQ3NzXTtcbmNvbnN0IFRFU1RfRklMRV9TVUZGSVggPSBPYnNpZGlhblBsdWdpblJlcG9QYXRocy5BbnlUZXN0VHMuc2xpY2UoMSk7XG5cbi8qKlxuICogQ2hlY2tzIHdoZXRoZXIgYGRpc3QvYnVpbGQvbWFpbi5qc2AgaXMgbWlzc2luZywgb3Igb2xkZXIgdGhhbiBvbmUgb2YgdGhlIGZpbGVzIGl0IGlzIGJ1aWx0IGZyb20uXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzLlxuICogQHJldHVybnMgYG51bGxgIHdoZW4gdGhlIGJ1aWxkIGlzIGN1cnJlbnQ7IG90aGVyd2lzZSBhIGRlc2NyaXB0aW9uIG9mIHRoZSBwcm9ibGVtLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZmluZFN0YWxlQnVpbGQocGFyYW1zOiBGaW5kU3RhbGVCdWlsZFBhcmFtcyk6IG51bGwgfCBTdGFsZUJ1aWxkIHtcbiAgY29uc3QgYnVpbGRQYXRoID0gam9pbihwYXJhbXMucm9vdEZvbGRlciwgQlVJTERfUEFUSCk7XG4gIGlmICghZXhpc3RzU3luYyhidWlsZFBhdGgpKSB7XG4gICAgcmV0dXJuIHsga2luZDogJ21pc3NpbmcnIH07XG4gIH1cblxuICBjb25zdCBidWlsZE1vZGlmaWVkQXQgPSBzdGF0U3luYyhidWlsZFBhdGgpLm10aW1lO1xuICBsZXQgbmV3ZXN0SW5wdXRQYXRoOiBudWxsIHwgc3RyaW5nID0gbnVsbDtcbiAgbGV0IG5ld2VzdElucHV0TW9kaWZpZWRBdCA9IGJ1aWxkTW9kaWZpZWRBdDtcblxuICBmb3IgKGNvbnN0IGlucHV0UGF0aCBvZiBnZXRCdWlsZElucHV0UGF0aHMocGFyYW1zLnJvb3RGb2xkZXIpKSB7XG4gICAgY29uc3QgbW9kaWZpZWRBdCA9IHN0YXRTeW5jKGlucHV0UGF0aCkubXRpbWU7XG4gICAgaWYgKG1vZGlmaWVkQXQgPD0gbmV3ZXN0SW5wdXRNb2RpZmllZEF0KSB7XG4gICAgICBjb250aW51ZTtcbiAgICB9XG5cbiAgICBuZXdlc3RJbnB1dFBhdGggPSBpbnB1dFBhdGg7XG4gICAgbmV3ZXN0SW5wdXRNb2RpZmllZEF0ID0gbW9kaWZpZWRBdDtcbiAgfVxuXG4gIGlmIChuZXdlc3RJbnB1dFBhdGggPT09IG51bGwpIHtcbiAgICByZXR1cm4gbnVsbDtcbiAgfVxuXG4gIHJldHVybiB7XG4gICAgYnVpbGRNb2RpZmllZEF0LFxuICAgIGtpbmQ6ICdvdXRkYXRlZCcsXG4gICAgbmV3ZXN0SW5wdXRNb2RpZmllZEF0LFxuICAgIG5ld2VzdElucHV0UGF0aDogdG9Qb3NpeFBhdGgocmVsYXRpdmUocGFyYW1zLnJvb3RGb2xkZXIsIG5ld2VzdElucHV0UGF0aCkpXG4gIH07XG59XG5cbi8qKlxuICogRm9ybWF0cyBhIHtAbGluayBTdGFsZUJ1aWxkfSBhcyB0aGUgbWVzc2FnZSB0aGUgc2V0dXAgdGhyb3dzLlxuICpcbiAqIEBwYXJhbSBzdGFsZUJ1aWxkIC0gVGhlIHN0YWxlIGJ1aWxkLlxuICogQHJldHVybnMgVGhlIG1lc3NhZ2UuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBmb3JtYXRTdGFsZUJ1aWxkTWVzc2FnZShzdGFsZUJ1aWxkOiBTdGFsZUJ1aWxkKTogc3RyaW5nIHtcbiAgcmV0dXJuIHN0YWxlQnVpbGQua2luZCA9PT0gJ21pc3NpbmcnXG4gICAgPyBgJHtCVUlMRF9QQVRIfSBkb2VzIG5vdCBleGlzdCwgc28gdGhlcmUgaXMgbm8gcGx1Z2luIGZvciB0aGUgaW50ZWdyYXRpb24gdGVzdHMgdG8gbG9hZC4gUnVuIFxcYG5wbSBydW4gYnVpbGRcXGAgZmlyc3QuYFxuICAgIDogYCR7QlVJTERfUEFUSH0gaXMgb2xkZXIgdGhhbiAke3N0YWxlQnVpbGQubmV3ZXN0SW5wdXRQYXRofSAoYnVpbHQgJHtzdGFsZUJ1aWxkLmJ1aWxkTW9kaWZpZWRBdC50b0lTT1N0cmluZygpfSwgYFxuICAgICAgKyBgY2hhbmdlZCAke3N0YWxlQnVpbGQubmV3ZXN0SW5wdXRNb2RpZmllZEF0LnRvSVNPU3RyaW5nKCl9KSwgc28gdGhlIGludGVncmF0aW9uIHRlc3RzIHdvdWxkIHJ1biB0aGUgcHJldmlvdXMgYnVpbGQgYFxuICAgICAgKyAnaW5zdGVhZCBvZiB0aGUgY3VycmVudCBzb3VyY2UuIFJ1biBgbnBtIHJ1biBidWlsZGAgZmlyc3QuJztcbn1cblxuLyoqXG4gKiBWaXRlc3QgZ2xvYmFsIHNldHVwOiB0aHJvd3Mgd2hlbiB0aGUgcGx1Z2luIGJ1aWxkIGlzIG1pc3Npbmcgb3Igc3RhbGUuXG4gKlxuICogQHBhcmFtIHByb2plY3QgLSBUaGUgVml0ZXN0IHRlc3QgcHJvamVjdC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHNldHVwKHByb2plY3Q6IFRlc3RQcm9qZWN0KTogdm9pZCB7XG4gIGNvbnN0IHN0YWxlQnVpbGQgPSBmaW5kU3RhbGVCdWlsZCh7IHJvb3RGb2xkZXI6IHByb2plY3QuY29uZmlnLnJvb3QgfSk7XG4gIGlmIChzdGFsZUJ1aWxkICE9PSBudWxsKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGZvcm1hdFN0YWxlQnVpbGRNZXNzYWdlKHN0YWxlQnVpbGQpKTtcbiAgfVxufVxuXG5mdW5jdGlvbiBnZXRCdWlsZElucHV0UGF0aHMocm9vdEZvbGRlcjogc3RyaW5nKTogc3RyaW5nW10ge1xuICBjb25zdCBwYXRocyA9IFJPT1RfQlVJTERfSU5QVVRTLm1hcCgocm9vdElucHV0KSA9PiBqb2luKHJvb3RGb2xkZXIsIHJvb3RJbnB1dCkpLmZpbHRlcigocGF0aCkgPT4gZXhpc3RzU3luYyhwYXRoKSk7XG5cbiAgY29uc3Qgc3JjRm9sZGVyID0gam9pbihyb290Rm9sZGVyLCBPYnNpZGlhblBsdWdpblJlcG9QYXRocy5TcmMpO1xuICBpZiAoIWV4aXN0c1N5bmMoc3JjRm9sZGVyKSkge1xuICAgIHJldHVybiBwYXRocztcbiAgfVxuXG4gIGNvbnN0IHRlc3RIZWxwZXJzRm9sZGVyUHJlZml4ID0gam9pbihyb290Rm9sZGVyLCBPYnNpZGlhblBsdWdpblJlcG9QYXRocy5Nb2NrcykgKyBzZXA7XG4gIGZvciAoY29uc3QgZW50cnkgb2YgcmVhZGRpclN5bmMoc3JjRm9sZGVyLCB7IHJlY3Vyc2l2ZTogdHJ1ZSwgd2l0aEZpbGVUeXBlczogdHJ1ZSB9KSkge1xuICAgIGlmICghZW50cnkuaXNGaWxlKCkgfHwgZW50cnkubmFtZS5lbmRzV2l0aChURVNUX0ZJTEVfU1VGRklYKSkge1xuICAgICAgY29udGludWU7XG4gICAgfVxuXG4gICAgY29uc3QgcGF0aCA9IGpvaW4oZW50cnkucGFyZW50UGF0aCwgZW50cnkubmFtZSk7XG4gICAgaWYgKCFwYXRoLnN0YXJ0c1dpdGgodGVzdEhlbHBlcnNGb2xkZXJQcmVmaXgpKSB7XG4gICAgICBwYXRocy5wdXNoKHBhdGgpO1xuICAgIH1cbiAgfVxuXG4gIHJldHVybiBwYXRocztcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBd0JBLFNBQVMsbUJBQW1CO0FBQzVCO0FBQUEsRUFDRTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsT0FDSztBQUNQO0FBQUEsRUFDRTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsT0FDSztBQUVQLFNBQVMsK0JBQStCO0FBb0R4QyxNQUFNLGFBQWEsR0FBRyx3QkFBd0IsU0FBUyxJQUFJLHdCQUF3QixNQUFNO0FBQ3pGLE1BQU0sb0JBQW9CLENBQUMsd0JBQXdCLGNBQWMsd0JBQXdCLFNBQVM7QUFDbEcsTUFBTSxtQkFBbUIsd0JBQXdCLFVBQVUsTUFBTSxDQUFDO0FBUTNELFNBQVMsZUFBZSxRQUFpRDtBQUM5RSxRQUFNLFlBQVksS0FBSyxPQUFPLFlBQVksVUFBVTtBQUNwRCxNQUFJLENBQUMsV0FBVyxTQUFTLEdBQUc7QUFDMUIsV0FBTyxFQUFFLE1BQU0sVUFBVTtBQUFBLEVBQzNCO0FBRUEsUUFBTSxrQkFBa0IsU0FBUyxTQUFTLEVBQUU7QUFDNUMsTUFBSSxrQkFBaUM7QUFDckMsTUFBSSx3QkFBd0I7QUFFNUIsYUFBVyxhQUFhLG1CQUFtQixPQUFPLFVBQVUsR0FBRztBQUM3RCxVQUFNLGFBQWEsU0FBUyxTQUFTLEVBQUU7QUFDdkMsUUFBSSxjQUFjLHVCQUF1QjtBQUN2QztBQUFBLElBQ0Y7QUFFQSxzQkFBa0I7QUFDbEIsNEJBQXdCO0FBQUEsRUFDMUI7QUFFQSxNQUFJLG9CQUFvQixNQUFNO0FBQzVCLFdBQU87QUFBQSxFQUNUO0FBRUEsU0FBTztBQUFBLElBQ0w7QUFBQSxJQUNBLE1BQU07QUFBQSxJQUNOO0FBQUEsSUFDQSxpQkFBaUIsWUFBWSxTQUFTLE9BQU8sWUFBWSxlQUFlLENBQUM7QUFBQSxFQUMzRTtBQUNGO0FBUU8sU0FBUyx3QkFBd0IsWUFBZ0M7QUFDdEUsU0FBTyxXQUFXLFNBQVMsWUFDdkIsR0FBRyxVQUFVLDJHQUNiLEdBQUcsVUFBVSxrQkFBa0IsV0FBVyxlQUFlLFdBQVcsV0FBVyxnQkFBZ0IsWUFBWSxDQUFDLGFBQy9GLFdBQVcsc0JBQXNCLFlBQVksQ0FBQztBQUVqRTtBQU9PLFNBQVMsTUFBTSxTQUE0QjtBQUNoRCxRQUFNLGFBQWEsZUFBZSxFQUFFLFlBQVksUUFBUSxPQUFPLEtBQUssQ0FBQztBQUNyRSxNQUFJLGVBQWUsTUFBTTtBQUN2QixVQUFNLElBQUksTUFBTSx3QkFBd0IsVUFBVSxDQUFDO0FBQUEsRUFDckQ7QUFDRjtBQUVBLFNBQVMsbUJBQW1CLFlBQThCO0FBQ3hELFFBQU0sUUFBUSxrQkFBa0IsSUFBSSxDQUFDLGNBQWMsS0FBSyxZQUFZLFNBQVMsQ0FBQyxFQUFFLE9BQU8sQ0FBQyxTQUFTLFdBQVcsSUFBSSxDQUFDO0FBRWpILFFBQU0sWUFBWSxLQUFLLFlBQVksd0JBQXdCLEdBQUc7QUFDOUQsTUFBSSxDQUFDLFdBQVcsU0FBUyxHQUFHO0FBQzFCLFdBQU87QUFBQSxFQUNUO0FBRUEsUUFBTSwwQkFBMEIsS0FBSyxZQUFZLHdCQUF3QixLQUFLLElBQUk7QUFDbEYsYUFBVyxTQUFTLFlBQVksV0FBVyxFQUFFLFdBQVcsTUFBTSxlQUFlLEtBQUssQ0FBQyxHQUFHO0FBQ3BGLFFBQUksQ0FBQyxNQUFNLE9BQU8sS0FBSyxNQUFNLEtBQUssU0FBUyxnQkFBZ0IsR0FBRztBQUM1RDtBQUFBLElBQ0Y7QUFFQSxVQUFNLE9BQU8sS0FBSyxNQUFNLFlBQVksTUFBTSxJQUFJO0FBQzlDLFFBQUksQ0FBQyxLQUFLLFdBQVcsdUJBQXVCLEdBQUc7QUFDN0MsWUFBTSxLQUFLLElBQUk7QUFBQSxJQUNqQjtBQUFBLEVBQ0Y7QUFFQSxTQUFPO0FBQ1Q7IiwKICAibmFtZXMiOiBbXQp9Cg==

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

@@ -0,0 +1,200 @@
+/// <reference path="../index.d.mts" />
+/**
+ * @file
+ *
+ * Shared vitest configuration for Obsidian plugins.
+ *
+ * Every plugin in the workspace declares the same five vitest projects — `unit-tests` plus the
+ * `integration-tests:{no-app,desktop,desktop-performance,android}` family — with the same timeouts,
+ * `setupFiles`, and `globalSetup` wiring. Maintaining that per repo means a convention change costs one
+ * near-identical edit per plugin, and any repo that is missed drifts silently. This module owns that
+ * configuration once, so a plugin's `scripts/vitest-config.ts` collapses to a single call.
+ *
+ * The seam mirrors {@link https://www.npmjs.com/package/obsidian-dev-utils | the ESLint one}
+ * (`defineEslintConfigs`): the factory builds a context holding the standard projects, the caller edits
+ * it in place through {@link DefineObsidianPluginVitestConfigOptions.editContext}, and appends any
+ * project the base does not know about through
+ * {@link DefineObsidianPluginVitestConfigOptions.customProjects}.
+ */
+import type { VitestReporter } from '@mnaoumov/typescript-dev-toolkit/test-runners/vitest-config';
+import type { TestProjectConfiguration, TestProjectInlineConfiguration, ViteUserConfig } from 'vitest/config';
+import { DEFAULT_VITEST_REPORTERS } from '@mnaoumov/typescript-dev-toolkit/test-runners/vitest-config';
+/**
+ * The `test` section of a single vitest project entry.
+ */
+export type ObsidianPluginVitestProjectConfig = NonNullable<TestProjectInlineConfiguration['test']>;
+/**
+ * One entry of a vitest `reporters` list: the name of a built-in reporter or a reporter instance. The same shape as
+ * the library configuration's {@link VitestReporter}.
+ */
+export type ObsidianPluginVitestReporter = VitestReporter;
+export { DEFAULT_VITEST_REPORTERS };
+/**
+ * The per-test budget of the regular integration projects, in milliseconds.
+ *
+ * Exported because a repo that assembles its vitest projects by hand instead of through
+ * {@link defineObsidianPluginVitestConfig} still needs the same relationship to the per-eval cap, and
+ * restating the number there is how the two drift apart.
+ */
+export declare const INTEGRATION_TEST_TIMEOUT_IN_MILLISECONDS: number;
+/**
+ * The options for defining a plugin's vitest configuration.
+ */
+export interface DefineObsidianPluginVitestConfigOptions {
+    /**
+     * A function that builds projects the base configuration does not know about, such as a plugin's own
+     * `integration-tests:demo-vault` project. The returned projects are appended after the standard five.
+     *
+     * @param context - The vitest configuration context.
+     * @returns The extra projects.
+     */
+    readonly customProjects?: (context: ObsidianPluginVitestConfigContext) => TestProjectConfiguration[];
+    /**
+     * A function that edits the vitest configuration context before it is assembled into a configuration.
+     *
+     * @param context - The vitest configuration context.
+     */
+    readonly editContext?: (context: ObsidianPluginVitestConfigContext) => void;
+}
+/**
+ * The context for defining a plugin's vitest configuration.
+ *
+ * Every member is live: the arrays and objects it exposes are the very ones the assembled configuration
+ * is built from, so editing them in place through
+ * {@link DefineObsidianPluginVitestConfigOptions.editContext} is what customizes the result.
+ */
+export declare class ObsidianPluginVitestConfigContext {
+    /**
+     * The `integration-tests:android` project, running the mobile-only and cross-platform suites against an
+     * Android emulator through Appium.
+     */
+    readonly android: ObsidianPluginVitestProjectConfig;
+    /**
+     * The per-test budget of the Android integration project, in milliseconds. Booting an emulator and
+     * driving it over Appium is slower than the desktop path, hence its own constant.
+     *
+     * @default `60000`
+     */
+    readonly androidTimeoutInMilliseconds = 60000;
+    /**
+     * The per-test budget of the regular integration projects, in milliseconds.
+     *
+     * It deliberately CLEARS the transports' per-eval cap rather than matching it, so that a closure which
+     * outruns the cap fails with the harness's `EvalCapExceededError` — naming the cap and the remedy —
+     * instead of with vitest's anonymous timeout. Lowering it to the cap restores that blind spot.
+     *
+     * @default `45000`
+     */
+    readonly bigTimeoutInMilliseconds: number;
+    /**
+     * The coverage `exclude` globs. Push onto it to drop more files from the coverage report.
+     *
+     * Declaration files are excluded by default because the coverage `include` below is `src/**\/*.ts`,
+     * which a `.d.ts` matches. A declaration file emits no runtime code, so it reports 0% and no test can
+     * ever raise it — a plugin that grows one under `src/` silently loses its 100% gate, and the usual
+     * remedy of an inline `v8 ignore` comment does not apply to a type-only file.
+     */
+    readonly coverageExclude: string[];
+    /**
+     * The `integration-tests:desktop` project, running the desktop-only and cross-platform suites against a
+     * real desktop Obsidian over CDP.
+     */
+    readonly desktop: ObsidianPluginVitestProjectConfig;
+    /**
+     * The `integration-tests:desktop-performance` project, running the at-scale suites. It is declared for
+     * every plugin even when there is no such suite yet — `passWithNoTests` makes an empty project free,
+     * and the matching `test:integration:desktop:performance` script exists in every plugin built on this library.
+     *
+     * A plugin's `test:integration` aggregate leaves this project out on purpose, and it stays out even on a
+     * machine with a desktop Obsidian set up. The reason is the fixture rather than the cost: a perf suite
+     * needs its own generated, populated vault, sized through env vars, and the aggregate's small temporary
+     * vault is the wrong one. The 600 s below is a timeout, not a duration — measured end to end, most perf
+     * suites finish in seconds, and only one that generates tens of thousands of notes takes minutes.
+     *
+     * Its CDP transport's per-eval cap is raised to 600 s as well (the budget clears it by the usual
+     * margin), because a perf suite's whole measurement is typically ONE long in-page evaluation, which the
+     * transport's 30 s default killed as a bare `CDP command timed out … Runtime.evaluate` naming neither the
+     * wait nor the assertion. Three plugins had each hand-written this raise in their own `editContext`
+     * before it moved here. Unlike a raised desktop cap, which is a backstop rather than a budget a closure
+     * may spend, this one IS a budget: `no-over-cap-wait-in-eval-in-obsidian` reads it for these files and
+     * for no other.
+     *
+     * No routine command runs them, but something does: a weekly sweep runs every plugin's
+     * `test:integration:desktop:performance`, which is also how to reach them by hand. Adding them to that
+     * aggregate is drift, not a gap to close.
+     */
+    readonly desktopPerformance: ObsidianPluginVitestProjectConfig;
+    /**
+     * The unit test files that redefine `window`, `document`, `location` or `top`, which the `unit-tests`
+     * project's VM pool cannot run.
+     *
+     * Under `pool: 'vmThreads'` those four are non-configurable properties of the VM global, so
+     * `vi.stubGlobal('window', …)` or `Object.defineProperty(window, 'location', …)` throws
+     * `Cannot redefine property`. That is JS semantics, not a bug to route around. Every other global stays
+     * configurable and stubs normally.
+     *
+     * Push a file here and it leaves `unit-tests` for a sibling `unit-tests:global-stubs` project that is
+     * identical except for the pool, which is the default one. A plugin's `test` and `test:coverage` scripts
+     * name `unit-tests`, which also selects every `unit-tests:*` project, so the sibling runs and is covered
+     * without a script change. It is emitted only when this list is non-empty.
+     *
+     * To keep a whole suite on the default pool instead, set `unitTests.pool` to `'forks'` and say why.
+     */
+    readonly globalStubTestFiles: string[];
+    /**
+     * The multiplier applied to a project's test budget to get its hook budget. A hook typically populates
+     * and opens a vault, so it needs several times what a single test does.
+     *
+     * @default `4`
+     */
+    readonly hookTimeoutMultiplier = 4;
+    /**
+     * The `integration-tests:no-app` project, running the suites that need no Obsidian instance at all.
+     */
+    readonly noApp: ObsidianPluginVitestProjectConfig;
+    /**
+     * The per-eval cap the performance integration project gives its CDP transport, in milliseconds.
+     *
+     * @default `600000`
+     */
+    readonly performanceEvalCapInMilliseconds = 600000;
+    /**
+     * The per-test budget of the performance integration project, in milliseconds. A performance vault is
+     * pre-populated with tens of thousands of notes before Obsidian opens, so both its setup and its tests
+     * need far more time than the regular integration projects.
+     *
+     * Like the regular budget, it CLEARS the project's per-eval cap
+     * ({@link ObsidianPluginVitestConfigContext.performanceEvalCapInMilliseconds}) rather than matching it,
+     * so an evaluation that outruns the cap reports itself instead of dying as vitest's anonymous timeout.
+     *
+     * @default `615000`
+     */
+    readonly performanceTimeoutInMilliseconds: number;
+    /**
+     * The reporters the run prints through.
+     *
+     * Pinned rather than left to vitest, which resolves an unset `reporters` differently for a developer
+     * and for an AI coding session — see {@link DEFAULT_VITEST_REPORTERS} for the whole of why, and for
+     * what it deliberately leaves to vitest 5 itself.
+     *
+     * Push onto it to add a reporter beside the pinned one.
+     *
+     * @default {@link DEFAULT_VITEST_REPORTERS}
+     */
+    readonly reporters: ObsidianPluginVitestReporter[];
+    /**
+     * The `unit-tests` project, running the mocked-Obsidian suites in `jsdom`.
+     */
+    readonly unitTests: ObsidianPluginVitestProjectConfig;
+    /**
+     * Creates a new context seeded with the standard projects.
+     */
+    constructor();
+}
+/**
+ * Defines the vitest configuration for an Obsidian plugin.
+ *
+ * @param options - The options for defining the configuration.
+ * @returns The vitest configuration.
+ */
+export declare function defineObsidianPluginVitestConfig(options?: DefineObsidianPluginVitestConfigOptions): ViteUserConfig;