@mnaoumov/obsidian-lib 10.11.0 → 11.0.0

package/dist/lib/cjs/components/worker-pool-component.cjs

@@ -0,0 +1,185 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+(function patchObsidianRequire() {
+  const originalRequire = require;
+  if (!originalRequire || originalRequire.__isPatched) {
+    return;
+  }
+  require = Object.assign(
+    (id) => requirePatched(id),
+    originalRequire,
+    {
+      __isPatched: true
+    }
+  );
+  function extractDefault($module) {
+    return $module && $module.__esModule && "default" in $module ? $module.default : $module;
+  }
+  const OBSIDIAN_BUILT_IN_MODULE_NAMES = /* @__PURE__ */ new Set([
+    "@codemirror/autocomplete",
+    "@codemirror/collab",
+    "@codemirror/commands",
+    "@codemirror/language",
+    "@codemirror/lint",
+    "@codemirror/search",
+    "@codemirror/state",
+    "@codemirror/text",
+    "@codemirror/view",
+    "@lezer/common",
+    "@lezer/highlight",
+    "@lezer/lr",
+    "obsidian"
+  ]);
+  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = /* @__PURE__ */ new Set([
+    "@codemirror/closebrackets",
+    "@codemirror/comment",
+    "@codemirror/fold",
+    "@codemirror/gutter",
+    "@codemirror/highlight",
+    "@codemirror/history",
+    "@codemirror/matchbrackets",
+    "@codemirror/panel",
+    "@codemirror/rangeset",
+    "@codemirror/rectangular-selection",
+    "@codemirror/stream-parser",
+    "@codemirror/tooltip"
+  ]);
+  function requirePatched(id) {
+    if (OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id)) {
+      return originalRequire?.(id);
+    }
+    const app = globalThis.app;
+    if (app?.isMobile) {
+      if (id === "process" || id === "node:process") {
+        console.debug(`The most likely you can safely ignore this error. Module not found: ${id}. Fake process object is returned instead.`);
+        return process;
+      }
+    } else {
+      const $module = originalRequire?.(id);
+      if ($module) {
+        return extractDefault($module);
+      }
+    }
+    console.debug(`The most likely you can safely ignore this error. Module not found: ${id}. Empty object is returned instead.`);
+    return {};
+  }
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var worker_pool_component_exports = {};
+__export(worker_pool_component_exports, {
+  MAX_DEFAULT_WORKER_POOL_SIZE: () => MAX_DEFAULT_WORKER_POOL_SIZE,
+  WorkerPoolComponent: () => WorkerPoolComponent,
+  getDefaultWorkerPoolSize: () => getDefaultWorkerPoolSize
+});
+module.exports = __toCommonJS(worker_pool_component_exports);
+var import_component_ex = require("./component-ex.cjs");
+var import_worker_component = require("./worker-component.cjs");
+const MAX_DEFAULT_WORKER_POOL_SIZE = 4;
+class WorkerPoolComponent extends import_component_ex.ComponentEx {
+  /**
+   * Creates the pool.
+   *
+   * @param params - The parameters.
+   */
+  constructor(params) {
+    super();
+    this.params = params;
+    const size = params.size ?? getDefaultWorkerPoolSize();
+    if (!Number.isSafeInteger(size) || size < 1) {
+      throw new Error(`A worker pool needs a positive integer size, not ${String(size)}`);
+    }
+    for (let index = 0; index < size; index++) {
+      const workerParams = {
+        source: params.source,
+        ...params.fallbackHandlers !== void 0 && { fallbackHandlers: params.fallbackHandlers },
+        ...params.name !== void 0 && { name: `${params.name} ${String(index)}` }
+      };
+      this.workers.push(this.addChild(new import_worker_component.WorkerComponent(workerParams)));
+    }
+  }
+  params;
+  /**
+   * The number of workers.
+   *
+   * @returns The size.
+   */
+  get size() {
+    return this.workers.length;
+  }
+  workers = [];
+  /**
+   * Calls a method on the least busy worker.
+   *
+   * @typeParam TMethod - The method.
+   * @param method - The method name.
+   * @param callArguments - The method's arguments.
+   * @param options - The call options.
+   * @returns The method's result.
+   */
+  async call(method, callArguments, options) {
+    let leastBusy = this.getWorker(0);
+    for (const worker of this.workers) {
+      if (worker.pendingCallCount < leastBusy.pendingCallCount) {
+        leastBusy = worker;
+      }
+    }
+    return await leastBusy.call(method, callArguments, options);
+  }
+  /**
+   * Calls a method on every worker with the same arguments, for instance to configure them all.
+   *
+   * @typeParam TMethod - The method.
+   * @param method - The method name.
+   * @param callArguments - The method's arguments, cloned for each worker; nothing can be transferred to all of them.
+   * @param abortSignal - Cancels every call.
+   * @returns The results, in worker order.
+   */
+  async callAll(method, callArguments, abortSignal) {
+    const options = abortSignal === void 0 ? {} : { abortSignal };
+    return await Promise.all(this.workers.map(async (worker) => await worker.call(method, callArguments, options)));
+  }
+  /**
+   * Gets one worker, for jobs that keep state in a particular worker.
+   *
+   * @param index - The worker index, from `0` to {@link WorkerPoolComponent.size} minus one.
+   * @returns The worker.
+   */
+  getWorker(index) {
+    const worker = this.workers[index];
+    if (!worker) {
+      throw new Error(`The worker pool has no worker at index ${String(index)}`);
+    }
+    return worker;
+  }
+}
+function getDefaultWorkerPoolSize(hardwareConcurrency) {
+  const processorCount = hardwareConcurrency ?? window.navigator.hardwareConcurrency;
+  return Math.max(1, Math.min(MAX_DEFAULT_WORKER_POOL_SIZE, processorCount - 1));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MAX_DEFAULT_WORKER_POOL_SIZE,
+  WorkerPoolComponent,
+  getDefaultWorkerPoolSize
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9jb21wb25lbnRzL3dvcmtlci1wb29sLWNvbXBvbmVudC50cyJdLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBmaWxlXG4gKlxuICogQSBjb21wb25lbnQgdGhhdCBvd25zIHNldmVyYWwgd29ya2VycyBidWlsdCBmcm9tIHRoZSBzYW1lIGJ1bmRsZWQgc291cmNlIGFuZCBzcHJlYWRzIGNhbGxzIG92ZXIgdGhlbS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7XG4gIFdvcmtlckFwaSxcbiAgV29ya2VyQXBpSGFuZGxlcnNcbn0gZnJvbSAnLi4vd29ya2VyLXByb3RvY29sLnRzJztcbmltcG9ydCB0eXBlIHtcbiAgV29ya2VyQ29tcG9uZW50Q2FsbE9wdGlvbnMsXG4gIFdvcmtlck1ldGhvZCxcbiAgV29ya2VyTWV0aG9kUmVzdWx0XG59IGZyb20gJy4vd29ya2VyLWNvbXBvbmVudC50cyc7XG5cbmltcG9ydCB7IENvbXBvbmVudEV4IH0gZnJvbSAnLi9jb21wb25lbnQtZXgudHMnO1xuaW1wb3J0IHsgV29ya2VyQ29tcG9uZW50IH0gZnJvbSAnLi93b3JrZXItY29tcG9uZW50LnRzJztcblxuLyoqXG4gKiBUaGUgbW9zdCB3b3JrZXJzIHtAbGluayBnZXREZWZhdWx0V29ya2VyUG9vbFNpemV9IHN1Z2dlc3RzLCBzbyBhIHBvb2wgb24gYSBtYW55LWNvcmUgZGVza3RvcCBkb2VzIG5vdCBzdGFydmVcbiAqIE9ic2lkaWFuJ3Mgb3duIHJlbmRlcmVyIG9mIG1lbW9yeS5cbiAqL1xuZXhwb3J0IGNvbnN0IE1BWF9ERUZBVUxUX1dPUktFUl9QT09MX1NJWkUgPSA0O1xuXG4vKipcbiAqIE9wdGlvbnMgb2Yge0BsaW5rIFdvcmtlclBvb2xDb21wb25lbnQuY2FsbH06IHRoZSBzYW1lIGFzIHtAbGluayBXb3JrZXJDb21wb25lbnQuY2FsbH0ncy5cbiAqL1xuZXhwb3J0IHR5cGUgV29ya2VyUG9vbENvbXBvbmVudENhbGxPcHRpb25zID0gV29ya2VyQ29tcG9uZW50Q2FsbE9wdGlvbnM7XG5cbi8qKlxuICogUGFyYW1ldGVycyBvZiB7QGxpbmsgV29ya2VyUG9vbENvbXBvbmVudH0uXG4gKlxuICogQHR5cGVQYXJhbSBUQXBpIC0gVGhlIEFQSSBldmVyeSB3b3JrZXIgZXhwb3Nlcy5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBXb3JrZXJQb29sQ29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXM8VEFwaSBleHRlbmRzIFdvcmtlckFwaTxUQXBpPj4ge1xuICAvKipcbiAgICogVGhlIGhhbmRsZXJzIHRvIHJ1biBvbiB0aGUgbWFpbiB0aHJlYWQgd2hlbiBubyBgV29ya2VyYCBjYW4gYmUgY3JlYXRlZC4gU2VlIHtAbGluayBXb3JrZXJDb21wb25lbnR9LlxuICAgKi9cbiAgcmVhZG9ubHkgZmFsbGJhY2tIYW5kbGVycz86IFdvcmtlckFwaUhhbmRsZXJzPFRBcGk+O1xuXG4gIC8qKlxuICAgKiBUaGUgd29ya2VycycgbmFtZSBwcmVmaXgsIHNob3duIGJ5IHRoZSBkZXZlbG9wZXIgdG9vbHM7IGVhY2ggd29ya2VyIGdldHMgYDxuYW1lPiA8aW5kZXg+YC5cbiAgICovXG4gIHJlYWRvbmx5IG5hbWU/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBudW1iZXIgb2Ygd29ya2Vycy4gRGVmYXVsdHMgdG8ge0BsaW5rIGdldERlZmF1bHRXb3JrZXJQb29sU2l6ZX0uXG4gICAqL1xuICByZWFkb25seSBzaXplPzogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBUaGUgYnVuZGxlZCB3b3JrZXIgc291cmNlLlxuICAgKi9cbiAgcmVhZG9ubHkgc291cmNlOiBzdHJpbmc7XG59XG5cbi8qKlxuICogT3ducyBhIGZpeGVkIG51bWJlciBvZiB7QGxpbmsgV29ya2VyQ29tcG9uZW50fSBjaGlsZHJlbiBhbmQgc2VuZHMgZWFjaCBjYWxsIHRvIHRoZSBvbmUgd2l0aCB0aGUgZmV3ZXN0IHBlbmRpbmcgY2FsbHMuXG4gKlxuICogVXNlIGl0IGZvciBDUFUtYm91bmQgam9icyB0aGF0IHNwbGl0IGludG8gaW5kZXBlbmRlbnQgY2FsbHMuIEEgam9iIHRoYXQga2VlcHMgc3RhdGUgaW4gYSB3b3JrZXIgKGEgbG9hZGVkIGNvcnB1cywgYW5cbiAqIGluc3RhbnRpYXRlZCBtb2R1bGUpIGFkZHJlc3NlcyBlYWNoIHdvcmtlciBieSBpbmRleCB0aHJvdWdoIHtAbGluayBXb3JrZXJQb29sQ29tcG9uZW50LmdldFdvcmtlcn0gaW5zdGVhZC5cbiAqXG4gKiBAdHlwZVBhcmFtIFRBcGkgLSBUaGUgQVBJIGV2ZXJ5IHdvcmtlciBleHBvc2VzLlxuICovXG5leHBvcnQgY2xhc3MgV29ya2VyUG9vbENvbXBvbmVudDxUQXBpIGV4dGVuZHMgV29ya2VyQXBpPFRBcGk+PiBleHRlbmRzIENvbXBvbmVudEV4IHtcbiAgLyoqXG4gICAqIFRoZSBudW1iZXIgb2Ygd29ya2Vycy5cbiAgICpcbiAgICogQHJldHVybnMgVGhlIHNpemUuXG4gICAqL1xuICBwdWJsaWMgZ2V0IHNpemUoKTogbnVtYmVyIHtcbiAgICByZXR1cm4gdGhpcy53b3JrZXJzLmxlbmd0aDtcbiAgfVxuXG4gIHByaXZhdGUgcmVhZG9ubHkgd29ya2VyczogV29ya2VyQ29tcG9uZW50PFRBcGk+W10gPSBbXTtcblxuICAvKipcbiAgICogQ3JlYXRlcyB0aGUgcG9vbC5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHByb3RlY3RlZCByZWFkb25seSBwYXJhbXM6IFdvcmtlclBvb2xDb21wb25lbnRDb25zdHJ1Y3RvclBhcmFtczxUQXBpPikge1xuICAgIHN1cGVyKCk7XG4gICAgY29uc3Qgc2l6ZSA9IHBhcmFtcy5zaXplID8/IGdldERlZmF1bHRXb3JrZXJQb29sU2l6ZSgpO1xuICAgIGlmICghTnVtYmVyLmlzU2FmZUludGVnZXIoc2l6ZSkgfHwgc2l6ZSA8IDEpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcihgQSB3b3JrZXIgcG9vbCBuZWVkcyBhIHBvc2l0aXZlIGludGVnZXIgc2l6ZSwgbm90ICR7U3RyaW5nKHNpemUpfWApO1xuICAgIH1cbiAgICBmb3IgKGxldCBpbmRleCA9IDA7IGluZGV4IDwgc2l6ZTsgaW5kZXgrKykge1xuICAgICAgY29uc3Qgd29ya2VyUGFyYW1zID0ge1xuICAgICAgICBzb3VyY2U6IHBhcmFtcy5zb3VyY2UsXG4gICAgICAgIC4uLihwYXJhbXMuZmFsbGJhY2tIYW5kbGVycyAhPT0gdW5kZWZpbmVkICYmIHsgZmFsbGJhY2tIYW5kbGVyczogcGFyYW1zLmZhbGxiYWNrSGFuZGxlcnMgfSksXG4gICAgICAgIC4uLihwYXJhbXMubmFtZSAhPT0gdW5kZWZpbmVkICYmIHsgbmFtZTogYCR7cGFyYW1zLm5hbWV9ICR7U3RyaW5nKGluZGV4KX1gIH0pXG4gICAgICB9O1xuICAgICAgdGhpcy53b3JrZXJzLnB1c2godGhpcy5hZGRDaGlsZChuZXcgV29ya2VyQ29tcG9uZW50PFRBcGk+KHdvcmtlclBhcmFtcykpKTtcbiAgICB9XG4gIH1cblxuICAvKipcbiAgICogQ2FsbHMgYSBtZXRob2Qgb24gdGhlIGxlYXN0IGJ1c3kgd29ya2VyLlxuICAgKlxuICAgKiBAdHlwZVBhcmFtIFRNZXRob2QgLSBUaGUgbWV0aG9kLlxuICAgKiBAcGFyYW0gbWV0aG9kIC0gVGhlIG1ldGhvZCBuYW1lLlxuICAgKiBAcGFyYW0gY2FsbEFyZ3VtZW50cyAtIFRoZSBtZXRob2QncyBhcmd1bWVudHMuXG4gICAqIEBwYXJhbSBvcHRpb25zIC0gVGhlIGNhbGwgb3B0aW9ucy5cbiAgICogQHJldHVybnMgVGhlIG1ldGhvZCdzIHJlc3VsdC5cbiAgICovXG4gIHB1YmxpYyBhc3luYyBjYWxsPFRNZXRob2QgZXh0ZW5kcyBXb3JrZXJNZXRob2Q8VEFwaT4+KFxuICAgIG1ldGhvZDogVE1ldGhvZCxcbiAgICBjYWxsQXJndW1lbnRzOiBQYXJhbWV0ZXJzPFRBcGlbVE1ldGhvZF0+LFxuICAgIG9wdGlvbnM/OiBXb3JrZXJQb29sQ29tcG9uZW50Q2FsbE9wdGlvbnNcbiAgKTogUHJvbWlzZTxXb3JrZXJNZXRob2RSZXN1bHQ8VEFwaSwgVE1ldGhvZD4+IHtcbiAgICBsZXQgbGVhc3RCdXN5ID0gdGhpcy5nZXRXb3JrZXIoMCk7XG4gICAgZm9yIChjb25zdCB3b3JrZXIgb2YgdGhpcy53b3JrZXJzKSB7XG4gICAgICBpZiAod29ya2VyLnBlbmRpbmdDYWxsQ291bnQgPCBsZWFzdEJ1c3kucGVuZGluZ0NhbGxDb3VudCkge1xuICAgICAgICBsZWFzdEJ1c3kgPSB3b3JrZXI7XG4gICAgICB9XG4gICAgfVxuICAgIHJldHVybiBhd2FpdCBsZWFzdEJ1c3kuY2FsbChtZXRob2QsIGNhbGxBcmd1bWVudHMsIG9wdGlvbnMpO1xuICB9XG5cbiAgLyoqXG4gICAqIENhbGxzIGEgbWV0aG9kIG9uIGV2ZXJ5IHdvcmtlciB3aXRoIHRoZSBzYW1lIGFyZ3VtZW50cywgZm9yIGluc3RhbmNlIHRvIGNvbmZpZ3VyZSB0aGVtIGFsbC5cbiAgICpcbiAgICogQHR5cGVQYXJhbSBUTWV0aG9kIC0gVGhlIG1ldGhvZC5cbiAgICogQHBhcmFtIG1ldGhvZCAtIFRoZSBtZXRob2QgbmFtZS5cbiAgICogQHBhcmFtIGNhbGxBcmd1bWVudHMgLSBUaGUgbWV0aG9kJ3MgYXJndW1lbnRzLCBjbG9uZWQgZm9yIGVhY2ggd29ya2VyOyBub3RoaW5nIGNhbiBiZSB0cmFuc2ZlcnJlZCB0byBhbGwgb2YgdGhlbS5cbiAgICogQHBhcmFtIGFib3J0U2lnbmFsIC0gQ2FuY2VscyBldmVyeSBjYWxsLlxuICAgKiBAcmV0dXJucyBUaGUgcmVzdWx0cywgaW4gd29ya2VyIG9yZGVyLlxuICAgKi9cbiAgcHVibGljIGFzeW5jIGNhbGxBbGw8VE1ldGhvZCBleHRlbmRzIFdvcmtlck1ldGhvZDxUQXBpPj4oXG4gICAgbWV0aG9kOiBUTWV0aG9kLFxuICAgIGNhbGxBcmd1bWVudHM6IFBhcmFtZXRlcnM8VEFwaVtUTWV0aG9kXT4sXG4gICAgYWJvcnRTaWduYWw/OiBBYm9ydFNpZ25hbFxuICApOiBQcm9taXNlPFdvcmtlck1ldGhvZFJlc3VsdDxUQXBpLCBUTWV0aG9kPltdPiB7XG4gICAgY29uc3Qgb3B0aW9uczogV29ya2VyQ29tcG9uZW50Q2FsbE9wdGlvbnMgPSBhYm9ydFNpZ25hbCA9PT0gdW5kZWZpbmVkID8ge30gOiB7IGFib3J0U2lnbmFsIH07XG4gICAgcmV0dXJuIGF3YWl0IFByb21pc2UuYWxsKHRoaXMud29ya2Vycy5tYXAoYXN5bmMgKHdvcmtlcikgPT4gYXdhaXQgd29ya2VyLmNhbGwobWV0aG9kLCBjYWxsQXJndW1lbnRzLCBvcHRpb25zKSkpO1xuICB9XG5cbiAgLyoqXG4gICAqIEdldHMgb25lIHdvcmtlciwgZm9yIGpvYnMgdGhhdCBrZWVwIHN0YXRlIGluIGEgcGFydGljdWxhciB3b3JrZXIuXG4gICAqXG4gICAqIEBwYXJhbSBpbmRleCAtIFRoZSB3b3JrZXIgaW5kZXgsIGZyb20gYDBgIHRvIHtAbGluayBXb3JrZXJQb29sQ29tcG9uZW50LnNpemV9IG1pbnVzIG9uZS5cbiAgICogQHJldHVybnMgVGhlIHdvcmtlci5cbiAgICovXG4gIHB1YmxpYyBnZXRXb3JrZXIoaW5kZXg6IG51bWJlcik6IFdvcmtlckNvbXBvbmVudDxUQXBpPiB7XG4gICAgY29uc3Qgd29ya2VyID0gdGhpcy53b3JrZXJzW2luZGV4XTtcbiAgICBpZiAoIXdvcmtlcikge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKGBUaGUgd29ya2VyIHBvb2wgaGFzIG5vIHdvcmtlciBhdCBpbmRleCAke1N0cmluZyhpbmRleCl9YCk7XG4gICAgfVxuICAgIHJldHVybiB3b3JrZXI7XG4gIH1cbn1cblxuLyoqXG4gKiBTdWdnZXN0cyBhIHBvb2wgc2l6ZTogb25lIGZld2VyIHRoYW4gdGhlIGxvZ2ljYWwgcHJvY2Vzc29ycywgc28gdGhlIG1haW4gdGhyZWFkIGtlZXBzIG9uZSwgYmV0d2VlbiBgMWAgYW5kXG4gKiB7QGxpbmsgTUFYX0RFRkFVTFRfV09SS0VSX1BPT0xfU0laRX0uXG4gKlxuICogQHBhcmFtIGhhcmR3YXJlQ29uY3VycmVuY3kgLSBUaGUgbnVtYmVyIG9mIGxvZ2ljYWwgcHJvY2Vzc29ycy4gRGVmYXVsdHMgdG8gYG5hdmlnYXRvci5oYXJkd2FyZUNvbmN1cnJlbmN5YC5cbiAqIEByZXR1cm5zIFRoZSBzdWdnZXN0ZWQgc2l6ZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldERlZmF1bHRXb3JrZXJQb29sU2l6ZShoYXJkd2FyZUNvbmN1cnJlbmN5PzogbnVtYmVyKTogbnVtYmVyIHtcbiAgY29uc3QgcHJvY2Vzc29yQ291bnQgPSBoYXJkd2FyZUNvbmN1cnJlbmN5ID8/IHdpbmRvdy5uYXZpZ2F0b3IuaGFyZHdhcmVDb25jdXJyZW5jeTtcbiAgcmV0dXJuIE1hdGgubWF4KDEsIE1hdGgubWluKE1BWF9ERUZBVUxUX1dPUktFUl9QT09MX1NJWkUsIHByb2Nlc3NvckNvdW50IC0gMSkpO1xufVxuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQWdCQSwwQkFBNEI7QUFDNUIsOEJBQWdDO0FBTXpCLE1BQU0sK0JBQStCO0FBMENyQyxNQUFNLDRCQUEwRCxnQ0FBWTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQWlCMUUsWUFBK0IsUUFBb0Q7QUFDeEYsVUFBTTtBQUQ4QjtBQUVwQyxVQUFNLE9BQU8sT0FBTyxRQUFRLHlCQUF5QjtBQUNyRCxRQUFJLENBQUMsT0FBTyxjQUFjLElBQUksS0FBSyxPQUFPLEdBQUc7QUFDM0MsWUFBTSxJQUFJLE1BQU0sb0RBQW9ELE9BQU8sSUFBSSxDQUFDLEVBQUU7QUFBQSxJQUNwRjtBQUNBLGFBQVMsUUFBUSxHQUFHLFFBQVEsTUFBTSxTQUFTO0FBQ3pDLFlBQU0sZUFBZTtBQUFBLFFBQ25CLFFBQVEsT0FBTztBQUFBLFFBQ2YsR0FBSSxPQUFPLHFCQUFxQixVQUFhLEVBQUUsa0JBQWtCLE9BQU8saUJBQWlCO0FBQUEsUUFDekYsR0FBSSxPQUFPLFNBQVMsVUFBYSxFQUFFLE1BQU0sR0FBRyxPQUFPLElBQUksSUFBSSxPQUFPLEtBQUssQ0FBQyxHQUFHO0FBQUEsTUFDN0U7QUFDQSxXQUFLLFFBQVEsS0FBSyxLQUFLLFNBQVMsSUFBSSx3Q0FBc0IsWUFBWSxDQUFDLENBQUM7QUFBQSxJQUMxRTtBQUFBLEVBQ0Y7QUFBQSxFQWRzQztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVh0QyxJQUFXLE9BQWU7QUFDeEIsV0FBTyxLQUFLLFFBQVE7QUFBQSxFQUN0QjtBQUFBLEVBRWlCLFVBQW1DLENBQUM7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQWdDckQsTUFBYSxLQUNYLFFBQ0EsZUFDQSxTQUM0QztBQUM1QyxRQUFJLFlBQVksS0FBSyxVQUFVLENBQUM7QUFDaEMsZUFBVyxVQUFVLEtBQUssU0FBUztBQUNqQyxVQUFJLE9BQU8sbUJBQW1CLFVBQVUsa0JBQWtCO0FBQ3hELG9CQUFZO0FBQUEsTUFDZDtBQUFBLElBQ0Y7QUFDQSxXQUFPLE1BQU0sVUFBVSxLQUFLLFFBQVEsZUFBZSxPQUFPO0FBQUEsRUFDNUQ7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVdBLE1BQWEsUUFDWCxRQUNBLGVBQ0EsYUFDOEM7QUFDOUMsVUFBTSxVQUFzQyxnQkFBZ0IsU0FBWSxDQUFDLElBQUksRUFBRSxZQUFZO0FBQzNGLFdBQU8sTUFBTSxRQUFRLElBQUksS0FBSyxRQUFRLElBQUksT0FBTyxXQUFXLE1BQU0sT0FBTyxLQUFLLFFBQVEsZUFBZSxPQUFPLENBQUMsQ0FBQztBQUFBLEVBQ2hIO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFRTyxVQUFVLE9BQXNDO0FBQ3JELFVBQU0sU0FBUyxLQUFLLFFBQVEsS0FBSztBQUNqQyxRQUFJLENBQUMsUUFBUTtBQUNYLFlBQU0sSUFBSSxNQUFNLDBDQUEwQyxPQUFPLEtBQUssQ0FBQyxFQUFFO0FBQUEsSUFDM0U7QUFDQSxXQUFPO0FBQUEsRUFDVDtBQUNGO0FBU08sU0FBUyx5QkFBeUIscUJBQXNDO0FBQzdFLFFBQU0saUJBQWlCLHVCQUF1QixPQUFPLFVBQVU7QUFDL0QsU0FBTyxLQUFLLElBQUksR0FBRyxLQUFLLElBQUksOEJBQThCLGlCQUFpQixDQUFDLENBQUM7QUFDL0U7IiwibmFtZXMiOltdfQ==

package/dist/lib/cjs/components/worker-pool-component.d.cts

@@ -0,0 +1,102 @@
+/// <reference path="../library-references.d.cts" />
+/// <reference lib="dom" />
+/**
+ * @file
+ *
+ * A component that owns several workers built from the same bundled source and spreads calls over them.
+ */
+import type { WorkerApi, WorkerApiHandlers } from '../worker-protocol.cjs';
+import type { WorkerComponentCallOptions, WorkerMethod, WorkerMethodResult } from './worker-component.cjs';
+import { ComponentEx } from './component-ex.cjs';
+import { WorkerComponent } from './worker-component.cjs';
+/**
+ * The most workers {@link getDefaultWorkerPoolSize} suggests, so a pool on a many-core desktop does not starve
+ * Obsidian's own renderer of memory.
+ */
+export declare const MAX_DEFAULT_WORKER_POOL_SIZE = 4;
+/**
+ * Options of {@link WorkerPoolComponent.call}: the same as {@link WorkerComponent.call}'s.
+ */
+export type WorkerPoolComponentCallOptions = WorkerComponentCallOptions;
+/**
+ * Parameters of {@link WorkerPoolComponent}.
+ *
+ * @typeParam TApi - The API every worker exposes.
+ */
+export interface WorkerPoolComponentConstructorParams<TApi extends WorkerApi<TApi>> {
+    /**
+     * The handlers to run on the main thread when no `Worker` can be created. See {@link WorkerComponent}.
+     */
+    readonly fallbackHandlers?: WorkerApiHandlers<TApi>;
+    /**
+     * The workers' name prefix, shown by the developer tools; each worker gets `<name> <index>`.
+     */
+    readonly name?: string;
+    /**
+     * The number of workers. Defaults to {@link getDefaultWorkerPoolSize}.
+     */
+    readonly size?: number;
+    /**
+     * The bundled worker source.
+     */
+    readonly source: string;
+}
+/**
+ * Owns a fixed number of {@link WorkerComponent} children and sends each call to the one with the fewest pending calls.
+ *
+ * Use it for CPU-bound jobs that split into independent calls. A job that keeps state in a worker (a loaded corpus, an
+ * instantiated module) addresses each worker by index through {@link WorkerPoolComponent.getWorker} instead.
+ *
+ * @typeParam TApi - The API every worker exposes.
+ */
+export declare class WorkerPoolComponent<TApi extends WorkerApi<TApi>> extends ComponentEx {
+    protected readonly params: WorkerPoolComponentConstructorParams<TApi>;
+    /**
+     * The number of workers.
+     *
+     * @returns The size.
+     */
+    get size(): number;
+    private readonly workers;
+    /**
+     * Creates the pool.
+     *
+     * @param params - The parameters.
+     */
+    constructor(params: WorkerPoolComponentConstructorParams<TApi>);
+    /**
+     * Calls a method on the least busy worker.
+     *
+     * @typeParam TMethod - The method.
+     * @param method - The method name.
+     * @param callArguments - The method's arguments.
+     * @param options - The call options.
+     * @returns The method's result.
+     */
+    call<TMethod extends WorkerMethod<TApi>>(method: TMethod, callArguments: Parameters<TApi[TMethod]>, options?: WorkerPoolComponentCallOptions): Promise<WorkerMethodResult<TApi, TMethod>>;
+    /**
+     * Calls a method on every worker with the same arguments, for instance to configure them all.
+     *
+     * @typeParam TMethod - The method.
+     * @param method - The method name.
+     * @param callArguments - The method's arguments, cloned for each worker; nothing can be transferred to all of them.
+     * @param abortSignal - Cancels every call.
+     * @returns The results, in worker order.
+     */
+    callAll<TMethod extends WorkerMethod<TApi>>(method: TMethod, callArguments: Parameters<TApi[TMethod]>, abortSignal?: AbortSignal): Promise<WorkerMethodResult<TApi, TMethod>[]>;
+    /**
+     * Gets one worker, for jobs that keep state in a particular worker.
+     *
+     * @param index - The worker index, from `0` to {@link WorkerPoolComponent.size} minus one.
+     * @returns The worker.
+     */
+    getWorker(index: number): WorkerComponent<TApi>;
+}
+/**
+ * Suggests a pool size: one fewer than the logical processors, so the main thread keeps one, between `1` and
+ * {@link MAX_DEFAULT_WORKER_POOL_SIZE}.
+ *
+ * @param hardwareConcurrency - The number of logical processors. Defaults to `navigator.hardwareConcurrency`.
+ * @returns The suggested size.
+ */
+export declare function getDefaultWorkerPoolSize(hardwareConcurrency?: number): number;