@mnaoumov/obsidian-lib 10.12.0 → 11.0.0

package/dist/lib/cjs/plugin/third-party-plugin.cjs

@@ -0,0 +1,231 @@
+/*
+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 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;
+}
+
+ensureBrowserProcess();
+})();
+(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 third_party_plugin_exports = {};
+__export(third_party_plugin_exports, {
+  createThirdPartyPluginDependency: () => createThirdPartyPluginDependency,
+  getThirdPartyPluginApi: () => getThirdPartyPluginApi,
+  getThirdPartyPluginAvailability: () => getThirdPartyPluginAvailability,
+  isThirdPartyPluginDependency: () => isThirdPartyPluginDependency,
+  requireThirdPartyPluginApi: () => requireThirdPartyPluginApi,
+  waitForThirdPartyPluginApi: () => waitForThirdPartyPluginApi,
+  watchThirdPartyPluginApi: () => watchThirdPartyPluginApi
+});
+module.exports = __toCommonJS(third_party_plugin_exports);
+var import_async_events = require("@mnaoumov/typescript-lib/async-events");
+var import_plugin_instance = require("./plugin-instance.cjs");
+var import_plugin_lifecycle_events = require("./plugin-lifecycle-events.cjs");
+class ThirdPartyPluginApiWatchBase {
+  // A `protected` constructor is not assignable to `AbstractConstructor<object>`, which is what
+  // `mixinAsyncEvents` accepts, so this stays public even though only the subclass below calls it.
+  constructor(params) {
+    this.params = params;
+  }
+  params;
+}
+class ThirdPartyPluginApiRefImpl extends (0, import_async_events.mixinAsyncEvents)()(ThirdPartyPluginApiWatchBase) {
+  get availability() {
+    return getThirdPartyPluginAvailability(this.params);
+  }
+  get value() {
+    return this.currentValue;
+  }
+  currentValue = null;
+  /**
+   * Re-reads the API, firing `change` only when it actually changed.
+   */
+  refresh() {
+    const value = getThirdPartyPluginApi(this.params);
+    if (value === this.currentValue) {
+      return;
+    }
+    this.currentValue = value;
+    this.trigger("change");
+  }
+}
+function createThirdPartyPluginDependency(params) {
+  const minPluginVersion = params.minPluginVersion ?? params.adapter.minPluginVersion;
+  return {
+    adapter: params.adapter,
+    pluginId: params.adapter.pluginId,
+    pluginName: params.adapter.pluginName,
+    reason: params.reason,
+    ...minPluginVersion !== void 0 && { minPluginVersion }
+  };
+}
+function getThirdPartyPluginApi(params) {
+  const plugin = (0, import_plugin_instance.getLoadedPlugin)(toPluginAvailabilityParams(params));
+  return plugin === null ? null : params.adapter.getApi(plugin);
+}
+function getThirdPartyPluginAvailability(params) {
+  return (0, import_plugin_instance.getPluginAvailability)(toPluginAvailabilityParams(params));
+}
+function isThirdPartyPluginDependency(dependency) {
+  return "adapter" in dependency;
+}
+async function requireThirdPartyPluginApi(params) {
+  const plugin = await (0, import_plugin_instance.requirePlugin)({
+    ...params,
+    ...toPluginAvailabilityParams(params),
+    pluginName: params.adapter.pluginName
+  });
+  return getVerifiedApi(params.adapter, plugin);
+}
+async function waitForThirdPartyPluginApi(params) {
+  const plugin = await (0, import_plugin_instance.waitForPlugin)({
+    ...params,
+    ...toPluginAvailabilityParams(params)
+  });
+  return getVerifiedApi(params.adapter, plugin);
+}
+function watchThirdPartyPluginApi(params) {
+  const { app, component } = params;
+  const ref = new ThirdPartyPluginApiRefImpl(params);
+  function refresh() {
+    ref.refresh();
+  }
+  component.registerEvent(app.plugins.on(import_plugin_instance.PLUGINS_CHANGED_EVENT_NAME, refresh));
+  component.registerEvent(app.workspace.on(import_plugin_lifecycle_events.PLUGIN_LOADED_EVENT_NAME, refresh));
+  component.registerEvent(app.workspace.on(import_plugin_lifecycle_events.PLUGIN_UNLOADED_EVENT_NAME, refresh));
+  ref.refresh();
+  return ref;
+}
+function getVerifiedApi(adapter, plugin) {
+  const api = adapter.getApi(plugin);
+  if (api === null) {
+    throw new Error(`The plugin "${adapter.pluginId}" does not expose the API its adapter expects.`);
+  }
+  return api;
+}
+function toPluginAvailabilityParams(params) {
+  const { adapter, app } = params;
+  const minPluginVersion = params.minPluginVersion ?? adapter.minPluginVersion;
+  return {
+    app,
+    isPlugin: (plugin) => adapter.getApi(plugin) !== null,
+    pluginId: adapter.pluginId,
+    ...minPluginVersion !== void 0 && { minPluginVersion }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createThirdPartyPluginDependency,
+  getThirdPartyPluginApi,
+  getThirdPartyPluginAvailability,
+  isThirdPartyPluginDependency,
+  requireThirdPartyPluginApi,
+  waitForThirdPartyPluginApi,
+  watchThirdPartyPluginApi
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9wbHVnaW4vdGhpcmQtcGFydHktcGx1Z2luLnRzIl0sInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBUeXBlZCBhY2Nlc3MgdG8gdGhlIEFQSSBvZiBhIFRISVJELVBBUlRZIHBsdWdpbjogb25lIHRoYXQgcHVibGlzaGVzIG5vdGhpbmcgdGhyb3VnaCB0aGlzIGxpYnJhcnkncyByZWdpc3RyeS5cbiAqXG4gKiBBIHBsdWdpbiBidWlsdCBvbiB0aGlzIGxpYnJhcnkgcHVibGlzaGVzIGEgdmVyc2lvbmVkIGNvbnRyYWN0IChgZ2V0UGx1Z2luQXBpcygpYCksIGFuZCBhIGNvbnN1bWVyIHJlYWNoZXMgaXRcbiAqIHRocm91Z2ggYHdhdGNoUGx1Z2luQXBpYCAoYC4vcGx1Z2luLWFwaS50c2ApLiBNb3N0IHBsdWdpbnMgYSBjb25zdW1lciB3YW50cyB0byB0YWxrIHRvIOKAlCBgRGF0YXZpZXdgLFxuICogYFRlbXBsYXRlcmAsIGBOb3RlYm9vayBOYXZpZ2F0b3JgIOKAlCBhcmUgbm90IGJ1aWx0IG9uIGl0LCBzbyB0aGVpciBBUEkgaGFuZ3Mgb2ZmIHRoZSBwbHVnaW4gaW5zdGFuY2UgdW5kZXIgYVxuICogbmFtZSBvZiB0aGVpciBvd24gY2hvb3NpbmcsIGFuZCBldmVyeSBjb25zdW1lciB1c2VkIHRvIHJlYWNoIGl0IGJ5IGhhbmQgdGhyb3VnaCBgYXBwLnBsdWdpbnNgIHdpdGggYSBjYXN0LlxuICpcbiAqIEEge0BsaW5rIFRoaXJkUGFydHlQbHVnaW5BZGFwdGVyfSBzYXlzIE9OQ0UsIGZvciBvbmUgcGx1Z2luLCBob3cgdG8gZ2V0IGZyb20gaXRzIGluc3RhbmNlIHRvIGl0cyB0eXBlZCBBUEksXG4gKiBhbmQgVkVSSUZJRVMgdGhlIHNoYXBlIG9uIHRoZSB3YXksIHNvIGEgcmVsZWFzZSB0aGF0IHJlbmFtZWQgd2hhdCB0aGUgYWRhcHRlciByZWFkcyBpcyBcIm5vdCB0aGVyZVwiIHJhdGhlclxuICogdGhhbiBhIGBDYW5ub3QgcmVhZCBwcm9wZXJ0aWVzIG9mIHVuZGVmaW5lZGAgZnJvbSBpbnNpZGUgYSBjYWxsYmFjay4gRXZlcnl0aGluZyBlbHNlIGhlcmUgaXMgZ2VuZXJpYzpcbiAqXG4gKiAtIHtAbGluayBnZXRUaGlyZFBhcnR5UGx1Z2luQXBpfSBhbnN3ZXJzIFwibm93XCIsIGZvciBhIG9uZS1zaG90IHVzZS5cbiAqIC0ge0BsaW5rIHdhdGNoVGhpcmRQYXJ0eVBsdWdpbkFwaX0gYW5zd2VycyBcIm5vd1wiIGZvciBhcyBsb25nIGFzIGEgY29tcG9uZW50IGxpdmVzOiBpdHMgcmVmIHJlLXJlYWRzIG9uIGV2ZXJ5XG4gKiAgIGBhcHAucGx1Z2luc2AgYGNoYW5nZWRgIGFuZCBldmVyeSBgb2JzaWRpYW4tbGliOnBsdWdpbi1sb2FkZWRgIC8gYC11bmxvYWRlZGAgYnJvYWRjYXN0LCBzbyBhbiBPUFRJT05BTFxuICogICBkZXBlbmRlbmN5IGlzIGEgcmVmIHdob3NlIGB2YWx1ZWAgaXMgYG51bGxgIHdoaWxlIHRoZSBwbHVnaW4gaXMgYWJzZW50LCBhbmQgYmVjb21lcyB0aGUgQVBJIHRoZSBtb21lbnQgaXRcbiAqICAgaXMgZW5hYmxlZC5cbiAqIC0ge0BsaW5rIHdhaXRGb3JUaGlyZFBhcnR5UGx1Z2luQXBpfSBhbmQge0BsaW5rIHJlcXVpcmVUaGlyZFBhcnR5UGx1Z2luQXBpfSBhcmUgdGhlIG9uZS1zaG90IHdhaXRzLCBidWlsdCBvblxuICogICBgd2FpdEZvclBsdWdpbmAgLyBgcmVxdWlyZVBsdWdpbmAgKGAuL3BsdWdpbi1pbnN0YW5jZS50c2ApLCBzbyB0aGV5IHNoYXJlIHRoYXQgbW9kdWxlJ3MgYXZhaWxhYmlsaXR5XG4gKiAgIGNsYXNzaWZpY2F0aW9uLCBpdHMgbm90aWNlIGFuZCBpdHMgcmVwYWlyIGJ1dHRvbnMuXG4gKiAtIEEgUkVRVUlSRUQgZGVwZW5kZW5jeSBpcyBkZWNsYXJlZCB0aHJvdWdoIGBQbHVnaW5CYXNlLmdldFBsdWdpbkRlcGVuZGVuY2llcygpYCBhcyBhXG4gKiAgIHtAbGluayBUaGlyZFBhcnR5UGx1Z2luRGVwZW5kZW5jeX0gKGJ1aWx0IGJ5IHtAbGluayBjcmVhdGVUaGlyZFBhcnR5UGx1Z2luRGVwZW5kZW5jeX0pLCBhbmQgdGhlIHBsdWdpbiBnYXRlXG4gKiAgIGtlZXBzIGBvbmxvYWRJbXBsYCBmcm9tIHJ1bm5pbmcgd2hpbGUgaXQgaXMgbWlzc2luZywgdG9vIG9sZCBvciB0aGUgd3Jvbmcgc2hhcGUg4oCUIHRoZSBzYW1lIHRyZWF0bWVudCBhblxuICogICBvd24tcGx1Z2luIGRlcGVuZGVuY3kgZ2V0cy5cbiAqXG4gKiBBdmFpbGFiaWxpdHkgaXMge0BsaW5rIFBsdWdpbkF2YWlsYWJpbGl0eX0sIHJlYWQgZnJvbSBPYnNpZGlhbiBgMS4xNS4xYCBhcyBgcGx1Z2luLWluc3RhbmNlLnRzYCBkb2N1bWVudHM6XG4gKiBhbiBpbnN0YW5jZSB3aG9zZSBgb25sb2FkYCBpcyBzdGlsbCBydW5uaW5nIHJlYWRzIGFzIGBsb2FkaW5nYCwgbmV2ZXIgYXMgYXZhaWxhYmxlLiBBbiBhZGFwdGVyJ3NcbiAqIGBnZXRBcGlgIHJldHVybmluZyBgbnVsbGAgcmVhZHMgYXMge0BsaW5rIFBsdWdpbkF2YWlsYWJpbGl0eS5TaGFwZU1pc21hdGNofS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IEFzeW5jRXZlbnRTb3VyY2UgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvYXN5bmMtZXZlbnRzJztcbmltcG9ydCB0eXBlIHtcbiAgQXBwLFxuICBDb21wb25lbnQsXG4gIFBsdWdpblxufSBmcm9tICdvYnNpZGlhbic7XG5pbXBvcnQgdHlwZSB7IEV4Y2VwdCB9IGZyb20gJ3R5cGUtZmVzdCc7XG5cbmltcG9ydCB7IG1peGluQXN5bmNFdmVudHMgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvYXN5bmMtZXZlbnRzJztcblxuaW1wb3J0IHR5cGUgeyBQbHVnaW5EZXBlbmRlbmN5QmFzZSB9IGZyb20gJy4uL2NvbXBvbmVudHMvcGx1Z2luLWdhdGUtY29tcG9uZW50LnRzJztcbmltcG9ydCB0eXBlIHtcbiAgR2V0UGx1Z2luQXZhaWxhYmlsaXR5UGFyYW1zLFxuICBSZXF1aXJlUGx1Z2luUGFyYW1zLFxuICBXYWl0Rm9yUGx1Z2luUGFyYW1zXG59IGZyb20gJy4vcGx1Z2luLWluc3RhbmNlLnRzJztcblxuaW1wb3J0IHtcbiAgZ2V0TG9hZGVkUGx1Z2luLFxuICBnZXRQbHVnaW5BdmFpbGFiaWxpdHksXG4gIFBsdWdpbkF2YWlsYWJpbGl0eSxcbiAgUExVR0lOU19DSEFOR0VEX0VWRU5UX05BTUUsXG4gIHJlcXVpcmVQbHVnaW4sXG4gIHdhaXRGb3JQbHVnaW5cbn0gZnJvbSAnLi9wbHVnaW4taW5zdGFuY2UudHMnO1xuaW1wb3J0IHtcbiAgUExVR0lOX0xPQURFRF9FVkVOVF9OQU1FLFxuICBQTFVHSU5fVU5MT0FERURfRVZFTlRfTkFNRVxufSBmcm9tICcuL3BsdWdpbi1saWZlY3ljbGUtZXZlbnRzLnRzJztcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgY3JlYXRlVGhpcmRQYXJ0eVBsdWdpbkRlcGVuZGVuY3l9LlxuICpcbiAqIEB0eXBlUGFyYW0gVEFwaSAtIFRoZSBhZGFwdGVyJ3MgQVBJIHR5cGUuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ3JlYXRlVGhpcmRQYXJ0eVBsdWdpbkRlcGVuZGVuY3lQYXJhbXM8VEFwaSBleHRlbmRzIG9iamVjdD4ge1xuICAvKipcbiAgICogVGhlIGFkYXB0ZXIgb2YgdGhlIHJlcXVpcmVkIHBsdWdpbi5cbiAgICovXG4gIHJlYWRvbmx5IGFkYXB0ZXI6IFRoaXJkUGFydHlQbHVnaW5BZGFwdGVyPFRBcGk+O1xuXG4gIC8qKlxuICAgKiBUaGUgb2xkZXN0IHJlbGVhc2UgdGhlIGRlcGVuZGVudCB3b3JrcyB3aXRoLiBEZWZhdWx0cyB0byB0aGUgYWRhcHRlcidzIG93blxuICAgKiB7QGxpbmsgVGhpcmRQYXJ0eVBsdWdpbkFkYXB0ZXIubWluUGx1Z2luVmVyc2lvbn07IGEgZGVwZW5kZW50IG1heSBvbmx5IHJhaXNlIGl0LlxuICAgKi9cbiAgcmVhZG9ubHkgbWluUGx1Z2luVmVyc2lvbj86IHN0cmluZztcblxuICAvKipcbiAgICogQSBsb2NhbGl6ZWQgc2VudGVuY2Ugc2F5aW5nIHdoYXQgdGhlIGRlcGVuZGVudCBkb2VzIHdpdGggdGhlIHBsdWdpbiwgc2hvd24gaW4gdGhlIHNldHRpbmdzIGJhbm5lci5cbiAgICovXG4gIHJlYWRvbmx5IHJlYXNvbjogRG9jdW1lbnRGcmFnbWVudCB8IHN0cmluZztcbn1cblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgZ2V0VGhpcmRQYXJ0eVBsdWdpbkFwaX0gYW5kIHtAbGluayBnZXRUaGlyZFBhcnR5UGx1Z2luQXZhaWxhYmlsaXR5fS5cbiAqXG4gKiBAdHlwZVBhcmFtIFRBcGkgLSBUaGUgYWRhcHRlcidzIEFQSSB0eXBlLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEdldFRoaXJkUGFydHlQbHVnaW5BcGlQYXJhbXM8VEFwaSBleHRlbmRzIG9iamVjdD4ge1xuICAvKipcbiAgICogVGhlIGFkYXB0ZXIgb2YgdGhlIHBsdWdpbi5cbiAgICovXG4gIHJlYWRvbmx5IGFkYXB0ZXI6IFRoaXJkUGFydHlQbHVnaW5BZGFwdGVyPFRBcGk+O1xuXG4gIC8qKlxuICAgKiBUaGUgT2JzaWRpYW4gYXBwIGluc3RhbmNlLlxuICAgKi9cbiAgcmVhZG9ubHkgYXBwOiBBcHA7XG5cbiAgLyoqXG4gICAqIFRoZSBvbGRlc3QgcmVsZWFzZSB0aGUgY2FsbGVyIHdvcmtzIHdpdGguIERlZmF1bHRzIHRvIHRoZSBhZGFwdGVyJ3Mgb3duXG4gICAqIHtAbGluayBUaGlyZFBhcnR5UGx1Z2luQWRhcHRlci5taW5QbHVnaW5WZXJzaW9ufS5cbiAgICovXG4gIHJlYWRvbmx5IG1pblBsdWdpblZlcnNpb24/OiBzdHJpbmc7XG59XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIGdldFRoaXJkUGFydHlQbHVnaW5BdmFpbGFiaWxpdHl9LlxuICpcbiAqIEB0eXBlUGFyYW0gVEFwaSAtIFRoZSBhZGFwdGVyJ3MgQVBJIHR5cGUuXG4gKi9cbmV4cG9ydCB0eXBlIEdldFRoaXJkUGFydHlQbHVnaW5BdmFpbGFiaWxpdHlQYXJhbXM8VEFwaSBleHRlbmRzIG9iamVjdD4gPSBHZXRUaGlyZFBhcnR5UGx1Z2luQXBpUGFyYW1zPFRBcGk+O1xuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHtAbGluayByZXF1aXJlVGhpcmRQYXJ0eVBsdWdpbkFwaX0uXG4gKlxuICogQHR5cGVQYXJhbSBUQXBpIC0gVGhlIGFkYXB0ZXIncyBBUEkgdHlwZS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBSZXF1aXJlVGhpcmRQYXJ0eVBsdWdpbkFwaVBhcmFtczxUQXBpIGV4dGVuZHMgb2JqZWN0PiBleHRlbmRzIEV4Y2VwdDxSZXF1aXJlUGx1Z2luUGFyYW1zLCAnYXBwJyB8ICdpc1BsdWdpbicgfCAnbWluUGx1Z2luVmVyc2lvbicgfCAncGx1Z2luSWQnIHwgJ3BsdWdpbk5hbWUnPiwgR2V0VGhpcmRQYXJ0eVBsdWdpbkFwaVBhcmFtczxUQXBpPiB7fVxuXG4vKipcbiAqIEhvdyB0byBnZXQgZnJvbSBvbmUgdGhpcmQtcGFydHkgcGx1Z2luJ3MgaW5zdGFuY2UgdG8gaXRzIHR5cGVkIEFQSS5cbiAqXG4gKiBBbiBhZGFwdGVyIGlzIHBsYWluIGRhdGEgcGx1cyBvbmUgZnVuY3Rpb24sIHNvIGl0IGNhbiBiZSBhIG1vZHVsZS1sZXZlbCBjb25zdGFudCBzaGFyZWQgYnkgZXZlcnkgY29uc3VtZXIsXG4gKiBhbmQgYWRkaW5nIGEgcGx1Z2luIG1lYW5zIGFkZGluZyBvbmUgYWRhcHRlci5cbiAqXG4gKiBAdHlwZVBhcmFtIFRBcGkgLSBUaGUgcGx1Z2luJ3MgQVBJLCB0eXBlZCBieSB0aGUgYWRhcHRlcidzIGF1dGhvciBhbmQgdmVyaWZpZWQgYnkge0BsaW5rIGdldEFwaX0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgVGhpcmRQYXJ0eVBsdWdpbkFkYXB0ZXI8VEFwaSBleHRlbmRzIG9iamVjdD4ge1xuICAvKipcbiAgICogUmVhZHMgdGhlIHR5cGVkIEFQSSBvZmYgYSBydW5uaW5nIGluc3RhbmNlIG9mIHRoZSBwbHVnaW4sIFZFUklGWUlORyBpdHMgc2hhcGUuXG4gICAqXG4gICAqIFJldHVybiBgbnVsbGAgd2hlbiB0aGUgaW5zdGFuY2UgZG9lcyBub3QgY2FycnkgdGhlIG1lbWJlcnMgdGhlIGFkYXB0ZXIgdHlwZXMsIHdoaWNoIGlzIHdoYXQgYSByZWxlYXNlXG4gICAqIHRoYXQgcmVuYW1lZCBvciByZXNoYXBlZCB0aGVtIGxvb2tzIGxpa2UuIE5ldmVyIGNhc3Q6IGEgY2FzdCBhc3NlcnRzIGEgc2hhcGUgbm90aGluZyBjaGVja2VkLlxuICAgKlxuICAgKiBAcGFyYW0gcGx1Z2luIC0gVGhlIHJ1bm5pbmcgaW5zdGFuY2UsIHdob3NlIGBvbmxvYWRgIGhhcyBzZXR0bGVkLlxuICAgKiBAcmV0dXJucyBUaGUgQVBJLCBvciBgbnVsbGAgd2hlbiB0aGUgaW5zdGFuY2UgaXMgbm90IHRoZSBzaGFwZSB0aGUgYWRhcHRlciBleHBlY3RzLlxuICAgKi9cbiAgcmVhZG9ubHkgZ2V0QXBpOiAocGx1Z2luOiBQbHVnaW4pID0+IG51bGwgfCBUQXBpO1xuXG4gIC8qKlxuICAgKiBUaGUgb2xkZXN0IHJlbGVhc2Ugb2YgdGhlIHBsdWdpbiB0aGUgYWRhcHRlciB3YXMgdmVyaWZpZWQgYWdhaW5zdCwgY29tcGFyZWQgd2l0aCBpdHMgYG1hbmlmZXN0LnZlcnNpb25gLlxuICAgKiBBIHJlbGVhc2UgYmVsb3cgaXQgcmVhZHMgYXMge0BsaW5rIFBsdWdpbkF2YWlsYWJpbGl0eS5PdXRkYXRlZH0uXG4gICAqL1xuICByZWFkb25seSBtaW5QbHVnaW5WZXJzaW9uPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgYG1hbmlmZXN0LmlkYCBvZiB0aGUgcGx1Z2luLlxuICAgKi9cbiAgcmVhZG9ubHkgcGx1Z2luSWQ6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIGRpc3BsYXkgbmFtZSBvZiB0aGUgcGx1Z2luLCBzaG93biB0byB0aGUgdXNlci5cbiAgICovXG4gIHJlYWRvbmx5IHBsdWdpbk5hbWU6IHN0cmluZztcbn1cblxuLyoqXG4gKiBBIGxpdmUgcmVmZXJlbmNlIHRvIGEgdGhpcmQtcGFydHkgcGx1Z2luJ3MgQVBJLlxuICpcbiAqIEB0eXBlUGFyYW0gVEFwaSAtIFRoZSBhZGFwdGVyJ3MgQVBJIHR5cGUuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgVGhpcmRQYXJ0eVBsdWdpbkFwaVJlZjxUQXBpIGV4dGVuZHMgb2JqZWN0PiBleHRlbmRzIEFzeW5jRXZlbnRTb3VyY2U8VGhpcmRQYXJ0eVBsdWdpbkFwaVJlZkV2ZW50TWFwPiB7XG4gIC8qKlxuICAgKiBXaGV0aGVyIHRoZSBBUEkgY2FuIGJlIHVzZWQgcmlnaHQgbm93LCBhbmQgaWYgbm90LCB3aHkuIFJlYWQgYXQgdGhlIG1vbWVudCBvZiByZWFkaW5nLlxuICAgKi9cbiAgcmVhZG9ubHkgYXZhaWxhYmlsaXR5OiBQbHVnaW5BdmFpbGFiaWxpdHk7XG5cbiAgLyoqXG4gICAqIFRoZSBBUEksIG9yIGBudWxsYCB3aGVuIGl0IGlzIG5vdCBhdmFpbGFibGUgcmlnaHQgbm93LiBgbnVsbGAgZHVyaW5nIHRoZSBjb25zdW1lcidzIGBvbmxvYWRgIG1heSBvbmx5XG4gICAqIG1lYW4gdGhlIHBsdWdpbiBoYXMgbm90IGxvYWRlZCB5ZXQ7IHRoZSB2YWx1ZSBiZWNvbWVzIHRoZSBBUEkgb24gaXRzIG93biBvbmNlIGl0IGhhcy5cbiAgICovXG4gIHJlYWRvbmx5IHZhbHVlOiBudWxsIHwgVEFwaTtcbn1cblxuLyoqXG4gKiBUaGUgZXZlbnRzIGEge0BsaW5rIFRoaXJkUGFydHlQbHVnaW5BcGlSZWZ9IGZpcmVzLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFRoaXJkUGFydHlQbHVnaW5BcGlSZWZFdmVudE1hcCB7XG4gIC8qKlxuICAgKiBGaXJlZCB3aGVuZXZlciB7QGxpbmsgVGhpcmRQYXJ0eVBsdWdpbkFwaVJlZi52YWx1ZX0gY2hhbmdlcywgaW5jbHVkaW5nIHdoZW4gaXQgYmVjb21lcyBgbnVsbGAgYmVjYXVzZSB0aGVcbiAgICogcGx1Z2luIHdhcyBkaXNhYmxlZCBvciByZWxvYWRlZC5cbiAgICovXG4gIHJlYWRvbmx5IGNoYW5nZTogW107XG59XG5cbi8qKlxuICogQSB0aGlyZC1wYXJ0eSBwbHVnaW4gYW5vdGhlciBwbHVnaW4gY2Fubm90IHdvcmsgd2l0aG91dCwgZGVjbGFyZWQgdGhyb3VnaFxuICogYFBsdWdpbkJhc2UuZ2V0UGx1Z2luRGVwZW5kZW5jaWVzKClgLlxuICpcbiAqIEJ1aWx0IGJ5IHtAbGluayBjcmVhdGVUaGlyZFBhcnR5UGx1Z2luRGVwZW5kZW5jeX0sIHdoaWNoIGNvcGllcyB0aGUgYWRhcHRlcidzIGlkIGFuZCBuYW1lLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFRoaXJkUGFydHlQbHVnaW5EZXBlbmRlbmN5IGV4dGVuZHMgUGx1Z2luRGVwZW5kZW5jeUJhc2Uge1xuICAvKipcbiAgICogVGhlIGFkYXB0ZXIgdGhlIGdhdGUgcmVhZHMgdGhlIGRlcGVuZGVuY3kncyBBUEkgdGhyb3VnaC5cbiAgICovXG4gIHJlYWRvbmx5IGFkYXB0ZXI6IFRoaXJkUGFydHlQbHVnaW5BZGFwdGVyPG9iamVjdD47XG59XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIHdhaXRGb3JUaGlyZFBhcnR5UGx1Z2luQXBpfS5cbiAqXG4gKiBAdHlwZVBhcmFtIFRBcGkgLSBUaGUgYWRhcHRlcidzIEFQSSB0eXBlLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFdhaXRGb3JUaGlyZFBhcnR5UGx1Z2luQXBpUGFyYW1zPFRBcGkgZXh0ZW5kcyBvYmplY3Q+IGV4dGVuZHMgRXhjZXB0PFdhaXRGb3JQbHVnaW5QYXJhbXMsICdhcHAnIHwgJ2lzUGx1Z2luJyB8ICdtaW5QbHVnaW5WZXJzaW9uJyB8ICdwbHVnaW5JZCc+LCBHZXRUaGlyZFBhcnR5UGx1Z2luQXBpUGFyYW1zPFRBcGk+IHt9XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIHdhdGNoVGhpcmRQYXJ0eVBsdWdpbkFwaX0uXG4gKlxuICogQHR5cGVQYXJhbSBUQXBpIC0gVGhlIGFkYXB0ZXIncyBBUEkgdHlwZS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBXYXRjaFRoaXJkUGFydHlQbHVnaW5BcGlQYXJhbXM8VEFwaSBleHRlbmRzIG9iamVjdD4gZXh0ZW5kcyBHZXRUaGlyZFBhcnR5UGx1Z2luQXBpUGFyYW1zPFRBcGk+IHtcbiAgLyoqXG4gICAqIFRoZSBjb21wb25lbnQgb3duaW5nIHRoZSB3YXRjaC4gSXRzIHVubG9hZCBzdG9wcyBpdC5cbiAgICovXG4gIHJlYWRvbmx5IGNvbXBvbmVudDogQ29tcG9uZW50O1xufVxuXG4vKipcbiAqIEhvbGRzIHRoZSBwYXJhbWV0ZXJzLCBzbyB0aGUge0BsaW5rIG1peGluQXN5bmNFdmVudHN9IG1peGluIGhhcyBhIHJlYWwgYmFzZSB0byBleHRlbmQuXG4gKi9cbmFic3RyYWN0IGNsYXNzIFRoaXJkUGFydHlQbHVnaW5BcGlXYXRjaEJhc2Uge1xuICAvLyBBIGBwcm90ZWN0ZWRgIGNvbnN0cnVjdG9yIGlzIG5vdCBhc3NpZ25hYmxlIHRvIGBBYnN0cmFjdENvbnN0cnVjdG9yPG9iamVjdD5gLCB3aGljaCBpcyB3aGF0XG4gIC8vIGBtaXhpbkFzeW5jRXZlbnRzYCBhY2NlcHRzLCBzbyB0aGlzIHN0YXlzIHB1YmxpYyBldmVuIHRob3VnaCBvbmx5IHRoZSBzdWJjbGFzcyBiZWxvdyBjYWxscyBpdC5cbiAgcHVibGljIGNvbnN0cnVjdG9yKHByb3RlY3RlZCByZWFkb25seSBwYXJhbXM6IEdldFRoaXJkUGFydHlQbHVnaW5BcGlQYXJhbXM8b2JqZWN0Pikge31cbn1cblxuY2xhc3MgVGhpcmRQYXJ0eVBsdWdpbkFwaVJlZkltcGw8VEFwaSBleHRlbmRzIG9iamVjdD4gZXh0ZW5kcyBtaXhpbkFzeW5jRXZlbnRzPFRoaXJkUGFydHlQbHVnaW5BcGlSZWZFdmVudE1hcD4oKShUaGlyZFBhcnR5UGx1Z2luQXBpV2F0Y2hCYXNlKSBpbXBsZW1lbnRzIFRoaXJkUGFydHlQbHVnaW5BcGlSZWY8VEFwaT4ge1xuICBwdWJsaWMgZ2V0IGF2YWlsYWJpbGl0eSgpOiBQbHVnaW5BdmFpbGFiaWxpdHkge1xuICAgIHJldHVybiBnZXRUaGlyZFBhcnR5UGx1Z2luQXZhaWxhYmlsaXR5KHRoaXMucGFyYW1zKTtcbiAgfVxuXG4gIHB1YmxpYyBnZXQgdmFsdWUoKTogbnVsbCB8IFRBcGkge1xuICAgIHJldHVybiB0aGlzLmN1cnJlbnRWYWx1ZTtcbiAgfVxuXG4gIHByaXZhdGUgY3VycmVudFZhbHVlOiBudWxsIHwgVEFwaSA9IG51bGw7XG5cbiAgLyoqXG4gICAqIFJlLXJlYWRzIHRoZSBBUEksIGZpcmluZyBgY2hhbmdlYCBvbmx5IHdoZW4gaXQgYWN0dWFsbHkgY2hhbmdlZC5cbiAgICovXG4gIHB1YmxpYyByZWZyZXNoKCk6IHZvaWQge1xuICAgIGNvbnN0IHZhbHVlID0gZ2V0VGhpcmRQYXJ0eVBsdWdpbkFwaSh0aGlzLnBhcmFtcykgYXMgbnVsbCB8IFRBcGk7XG4gICAgaWYgKHZhbHVlID09PSB0aGlzLmN1cnJlbnRWYWx1ZSkge1xuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIHRoaXMuY3VycmVudFZhbHVlID0gdmFsdWU7XG4gICAgdGhpcy50cmlnZ2VyKCdjaGFuZ2UnKTtcbiAgfVxufVxuXG4vKipcbiAqIEJ1aWxkcyB0aGUgZGVjbGFyYXRpb24gb2YgYSByZXF1aXJlZCB0aGlyZC1wYXJ0eSBwbHVnaW4sIGZvciBgUGx1Z2luQmFzZS5nZXRQbHVnaW5EZXBlbmRlbmNpZXMoKWAuXG4gKlxuICogQHR5cGVQYXJhbSBUQXBpIC0gVGhlIGFkYXB0ZXIncyBBUEkgdHlwZS5cbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUge0BsaW5rIENyZWF0ZVRoaXJkUGFydHlQbHVnaW5EZXBlbmRlbmN5UGFyYW1zfS5cbiAqIEByZXR1cm5zIFRoZSBkZXBlbmRlbmN5LlxuICovXG5leHBvcnQgZnVuY3Rpb24gY3JlYXRlVGhpcmRQYXJ0eVBsdWdpbkRlcGVuZGVuY3k8VEFwaSBleHRlbmRzIG9iamVjdD4ocGFyYW1zOiBDcmVhdGVUaGlyZFBhcnR5UGx1Z2luRGVwZW5kZW5jeVBhcmFtczxUQXBpPik6IFRoaXJkUGFydHlQbHVnaW5EZXBlbmRlbmN5IHtcbiAgY29uc3QgbWluUGx1Z2luVmVyc2lvbiA9IHBhcmFtcy5taW5QbHVnaW5WZXJzaW9uID8/IHBhcmFtcy5hZGFwdGVyLm1pblBsdWdpblZlcnNpb247XG4gIHJldHVybiB7XG4gICAgYWRhcHRlcjogcGFyYW1zLmFkYXB0ZXIsXG4gICAgcGx1Z2luSWQ6IHBhcmFtcy5hZGFwdGVyLnBsdWdpbklkLFxuICAgIHBsdWdpbk5hbWU6IHBhcmFtcy5hZGFwdGVyLnBsdWdpbk5hbWUsXG4gICAgcmVhc29uOiBwYXJhbXMucmVhc29uLFxuICAgIC4uLihtaW5QbHVnaW5WZXJzaW9uICE9PSB1bmRlZmluZWQgJiYgeyBtaW5QbHVnaW5WZXJzaW9uIH0pXG4gIH07XG59XG5cbi8qKlxuICogUmV0dXJucyBhIHRoaXJkLXBhcnR5IHBsdWdpbidzIHR5cGVkIEFQSSB3aGVuIHRoZSBwbHVnaW4gaXMge0BsaW5rIFBsdWdpbkF2YWlsYWJpbGl0eS5BdmFpbGFibGV9LCBhbmQgYG51bGxgXG4gKiBvdGhlcndpc2UuXG4gKlxuICogQHR5cGVQYXJhbSBUQXBpIC0gVGhlIGFkYXB0ZXIncyBBUEkgdHlwZS5cbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUge0BsaW5rIEdldFRoaXJkUGFydHlQbHVnaW5BcGlQYXJhbXN9LlxuICogQHJldHVybnMgVGhlIEFQSSwgb3IgYG51bGxgLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0VGhpcmRQYXJ0eVBsdWdpbkFwaTxUQXBpIGV4dGVuZHMgb2JqZWN0PihwYXJhbXM6IEdldFRoaXJkUGFydHlQbHVnaW5BcGlQYXJhbXM8VEFwaT4pOiBudWxsIHwgVEFwaSB7XG4gIGNvbnN0IHBsdWdpbiA9IGdldExvYWRlZFBsdWdpbih0b1BsdWdpbkF2YWlsYWJpbGl0eVBhcmFtcyhwYXJhbXMpKTtcbiAgcmV0dXJuIHBsdWdpbiA9PT0gbnVsbCA/IG51bGwgOiBwYXJhbXMuYWRhcHRlci5nZXRBcGkocGx1Z2luKTtcbn1cblxuLyoqXG4gKiBSZWFkcyB3aGV0aGVyIGEgdGhpcmQtcGFydHkgcGx1Z2luJ3MgQVBJIGNhbiBiZSB1c2VkIHJpZ2h0IG5vdywgYW5kIGlmIG5vdCwgd2h5LlxuICpcbiAqIEB0eXBlUGFyYW0gVEFwaSAtIFRoZSBhZGFwdGVyJ3MgQVBJIHR5cGUuXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHtAbGluayBHZXRUaGlyZFBhcnR5UGx1Z2luQXBpUGFyYW1zfS5cbiAqIEByZXR1cm5zIFRoZSB7QGxpbmsgUGx1Z2luQXZhaWxhYmlsaXR5fTsge0BsaW5rIFBsdWdpbkF2YWlsYWJpbGl0eS5TaGFwZU1pc21hdGNofSB3aGVuIHRoZSBhZGFwdGVyIGRvZXMgbm90XG4gKiByZWNvZ25pemUgdGhlIHJ1bm5pbmcgaW5zdGFuY2UuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRUaGlyZFBhcnR5UGx1Z2luQXZhaWxhYmlsaXR5PFRBcGkgZXh0ZW5kcyBvYmplY3Q+KHBhcmFtczogR2V0VGhpcmRQYXJ0eVBsdWdpbkF2YWlsYWJpbGl0eVBhcmFtczxUQXBpPik6IFBsdWdpbkF2YWlsYWJpbGl0eSB7XG4gIHJldHVybiBnZXRQbHVnaW5BdmFpbGFiaWxpdHkodG9QbHVnaW5BdmFpbGFiaWxpdHlQYXJhbXMocGFyYW1zKSk7XG59XG5cbi8qKlxuICogQ2hlY2tzIHdoZXRoZXIgYSBkZXBlbmRlbmN5IGRlY2xhcmVkIHRocm91Z2ggYFBsdWdpbkJhc2UuZ2V0UGx1Z2luRGVwZW5kZW5jaWVzKClgIGlzIGEgdGhpcmQtcGFydHkgb25lLlxuICpcbiAqIEBwYXJhbSBkZXBlbmRlbmN5IC0gVGhlIGRlY2xhcmVkIGRlcGVuZGVuY3kuXG4gKiBAcmV0dXJucyBXaGV0aGVyIGl0IGNhcnJpZXMgYW4gYWRhcHRlci5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzVGhpcmRQYXJ0eVBsdWdpbkRlcGVuZGVuY3koZGVwZW5kZW5jeTogUGx1Z2luRGVwZW5kZW5jeUJhc2UpOiBkZXBlbmRlbmN5IGlzIFRoaXJkUGFydHlQbHVnaW5EZXBlbmRlbmN5IHtcbiAgcmV0dXJuICdhZGFwdGVyJyBpbiBkZXBlbmRlbmN5O1xufVxuXG4vKipcbiAqIFdhaXRzIGZvciBhIHRoaXJkLXBhcnR5IHBsdWdpbidzIEFQSSwgYXNraW5nIHRoZSB1c2VyIHRvIGluc3RhbGwsIGVuYWJsZSBvciB1cGRhdGUgdGhlIHBsdWdpbiB3aGlsZSBpdCBpc1xuICogbm90IGF2YWlsYWJsZS4gU2V0dGxlcyBvbmNlOyBzZWUgYHJlcXVpcmVQbHVnaW5gLlxuICpcbiAqIEB0eXBlUGFyYW0gVEFwaSAtIFRoZSBhZGFwdGVyJ3MgQVBJIHR5cGUuXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHtAbGluayBSZXF1aXJlVGhpcmRQYXJ0eVBsdWdpbkFwaVBhcmFtc30uXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSByZXNvbHZpbmcgd2l0aCB0aGUgQVBJLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gcmVxdWlyZVRoaXJkUGFydHlQbHVnaW5BcGk8VEFwaSBleHRlbmRzIG9iamVjdD4ocGFyYW1zOiBSZXF1aXJlVGhpcmRQYXJ0eVBsdWdpbkFwaVBhcmFtczxUQXBpPik6IFByb21pc2U8VEFwaT4ge1xuICBjb25zdCBwbHVnaW4gPSBhd2FpdCByZXF1aXJlUGx1Z2luKHtcbiAgICAuLi5wYXJhbXMsXG4gICAgLi4udG9QbHVnaW5BdmFpbGFiaWxpdHlQYXJhbXMocGFyYW1zKSxcbiAgICBwbHVnaW5OYW1lOiBwYXJhbXMuYWRhcHRlci5wbHVnaW5OYW1lXG4gIH0pO1xuICByZXR1cm4gZ2V0VmVyaWZpZWRBcGkocGFyYW1zLmFkYXB0ZXIsIHBsdWdpbik7XG59XG5cbi8qKlxuICogV2FpdHMgZm9yIGEgdGhpcmQtcGFydHkgcGx1Z2luJ3MgQVBJIHRvIGJlY29tZSBhdmFpbGFibGUuIFNldHRsZXMgb25jZTsgc2VlIGB3YWl0Rm9yUGx1Z2luYC5cbiAqXG4gKiBAdHlwZVBhcmFtIFRBcGkgLSBUaGUgYWRhcHRlcidzIEFQSSB0eXBlLlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSB7QGxpbmsgV2FpdEZvclRoaXJkUGFydHlQbHVnaW5BcGlQYXJhbXN9LlxuICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gcmVzb2x2aW5nIHdpdGggdGhlIEFQSS5cbiAqIEB0aHJvd3MgYFBsdWdpbkluc3RhbmNlVW5hdmFpbGFibGVFcnJvcmAgd2hlbiB0aGUgdGltZW91dCBlbGFwc2VzLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gd2FpdEZvclRoaXJkUGFydHlQbHVnaW5BcGk8VEFwaSBleHRlbmRzIG9iamVjdD4ocGFyYW1zOiBXYWl0Rm9yVGhpcmRQYXJ0eVBsdWdpbkFwaVBhcmFtczxUQXBpPik6IFByb21pc2U8VEFwaT4ge1xuICBjb25zdCBwbHVnaW4gPSBhd2FpdCB3YWl0Rm9yUGx1Z2luKHtcbiAgICAuLi5wYXJhbXMsXG4gICAgLi4udG9QbHVnaW5BdmFpbGFiaWxpdHlQYXJhbXMocGFyYW1zKVxuICB9KTtcbiAgcmV0dXJuIGdldFZlcmlmaWVkQXBpKHBhcmFtcy5hZGFwdGVyLCBwbHVnaW4pO1xufVxuXG4vKipcbiAqIFdhdGNoZXMgYSB0aGlyZC1wYXJ0eSBwbHVnaW4ncyBBUEkgYW5kIHJldHVybnMgYSBsaXZlIHtAbGluayBUaGlyZFBhcnR5UGx1Z2luQXBpUmVmfS5cbiAqXG4gKiBUaGUgcmVmIHJlLXJlYWRzIG9uIGV2ZXJ5IGBhcHAucGx1Z2luc2AgYGNoYW5nZWRgIGFuZCBldmVyeSBsaWJyYXJ5IGxpZmVjeWNsZSBicm9hZGNhc3QsIHNvIGl0IGZvbGxvd3MgdGhlXG4gKiBwbHVnaW4gdGhyb3VnaCBlbmFibGUsIGRpc2FibGUsIHVwZGF0ZSBhbmQgcmVsb2FkIHdpdGggbm8gcG9sbGluZy4gVGhpcyBpcyB0aGUgc2hhcGUgb2YgYW4gT1BUSU9OQUxcbiAqIGRlcGVuZGVuY3k6IHJlYWQgYHJlZi52YWx1ZWAgd2hlcmUgdGhlIGludGVncmF0aW9uIGlzIHVzZWQsIGFuZCB0cmVhdCBgbnVsbGAgYXMgXCJub3QgdGhlcmVcIi5cbiAqXG4gKiBAdHlwZVBhcmFtIFRBcGkgLSBUaGUgYWRhcHRlcidzIEFQSSB0eXBlLlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSB7QGxpbmsgV2F0Y2hUaGlyZFBhcnR5UGx1Z2luQXBpUGFyYW1zfS5cbiAqIEByZXR1cm5zIFRoZSBsaXZlIHJlZmVyZW5jZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHdhdGNoVGhpcmRQYXJ0eVBsdWdpbkFwaTxUQXBpIGV4dGVuZHMgb2JqZWN0PihwYXJhbXM6IFdhdGNoVGhpcmRQYXJ0eVBsdWdpbkFwaVBhcmFtczxUQXBpPik6IFRoaXJkUGFydHlQbHVnaW5BcGlSZWY8VEFwaT4ge1xuICBjb25zdCB7IGFwcCwgY29tcG9uZW50IH0gPSBwYXJhbXM7XG4gIGNvbnN0IHJlZiA9IG5ldyBUaGlyZFBhcnR5UGx1Z2luQXBpUmVmSW1wbDxUQXBpPihwYXJhbXMpO1xuICBmdW5jdGlvbiByZWZyZXNoKCk6IHZvaWQge1xuICAgIHJlZi5yZWZyZXNoKCk7XG4gIH1cbiAgY29tcG9uZW50LnJlZ2lzdGVyRXZlbnQoYXBwLnBsdWdpbnMub24oUExVR0lOU19DSEFOR0VEX0VWRU5UX05BTUUsIHJlZnJlc2gpKTtcbiAgY29tcG9uZW50LnJlZ2lzdGVyRXZlbnQoYXBwLndvcmtzcGFjZS5vbihQTFVHSU5fTE9BREVEX0VWRU5UX05BTUUsIHJlZnJlc2gpKTtcbiAgY29tcG9uZW50LnJlZ2lzdGVyRXZlbnQoYXBwLndvcmtzcGFjZS5vbihQTFVHSU5fVU5MT0FERURfRVZFTlRfTkFNRSwgcmVmcmVzaCkpO1xuICByZWYucmVmcmVzaCgpO1xuICByZXR1cm4gcmVmO1xufVxuXG5mdW5jdGlvbiBnZXRWZXJpZmllZEFwaTxUQXBpIGV4dGVuZHMgb2JqZWN0PihhZGFwdGVyOiBUaGlyZFBhcnR5UGx1Z2luQWRhcHRlcjxUQXBpPiwgcGx1Z2luOiBQbHVnaW4pOiBUQXBpIHtcbiAgY29uc3QgYXBpID0gYWRhcHRlci5nZXRBcGkocGx1Z2luKTtcbiAgaWYgKGFwaSA9PT0gbnVsbCkge1xuICAgIC8vIFVucmVhY2hhYmxlIHRocm91Z2ggdGhlIHdhaXRzLCB3aG9zZSBhdmFpbGFiaWxpdHkgY2hlY2sgYWxyZWFkeSByYW4gYGdldEFwaWA7IGtlcHQgc28gYSB3cm9uZyBhZGFwdGVyXG4gICAgLy8gZmFpbHMgaGVyZSBieSBuYW1lIHJhdGhlciB0aGFuIGhhbmRpbmcgYmFjayBgbnVsbGAgdHlwZWQgYXMgdGhlIEFQSS5cbiAgICB0aHJvdyBuZXcgRXJyb3IoYFRoZSBwbHVnaW4gXCIke2FkYXB0ZXIucGx1Z2luSWR9XCIgZG9lcyBub3QgZXhwb3NlIHRoZSBBUEkgaXRzIGFkYXB0ZXIgZXhwZWN0cy5gKTtcbiAgfVxuXG4gIHJldHVybiBhcGk7XG59XG5cbmZ1bmN0aW9uIHRvUGx1Z2luQXZhaWxhYmlsaXR5UGFyYW1zPFRBcGkgZXh0ZW5kcyBvYmplY3Q+KHBhcmFtczogR2V0VGhpcmRQYXJ0eVBsdWdpbkFwaVBhcmFtczxUQXBpPik6IEdldFBsdWdpbkF2YWlsYWJpbGl0eVBhcmFtcyB7XG4gIGNvbnN0IHsgYWRhcHRlciwgYXBwIH0gPSBwYXJhbXM7XG4gIGNvbnN0IG1pblBsdWdpblZlcnNpb24gPSBwYXJhbXMubWluUGx1Z2luVmVyc2lvbiA/PyBhZGFwdGVyLm1pblBsdWdpblZlcnNpb247XG4gIHJldHVybiB7XG4gICAgYXBwLFxuICAgIGlzUGx1Z2luOiAocGx1Z2luOiBQbHVnaW4pOiBwbHVnaW4gaXMgUGx1Z2luID0+IGFkYXB0ZXIuZ2V0QXBpKHBsdWdpbikgIT09IG51bGwsXG4gICAgcGx1Z2luSWQ6IGFkYXB0ZXIucGx1Z2luSWQsXG4gICAgLi4uKG1pblBsdWdpblZlcnNpb24gIT09IHVuZGVmaW5lZCAmJiB7IG1pblBsdWdpblZlcnNpb24gfSlcbiAgfTtcbn1cbiJdLCJtYXBwaW5ncyI6Ijs7Ozs7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

package/dist/lib/cjs/plugin/third-party-plugin.d.cts

@@ -0,0 +1,244 @@
+/// <reference path="../library-references.d.cts" />
+/// <reference lib="dom" />
+/**
+ * @file
+ *
+ * Typed access to the API of a THIRD-PARTY plugin: one that publishes nothing through this library's registry.
+ *
+ * A plugin built on this library publishes a versioned contract (`getPluginApis()`), and a consumer reaches it
+ * through `watchPluginApi` (`./plugin-api.ts`). Most plugins a consumer wants to talk to — `Dataview`,
+ * `Templater`, `Notebook Navigator` — are not built on it, so their API hangs off the plugin instance under a
+ * name of their own choosing, and every consumer used to reach it by hand through `app.plugins` with a cast.
+ *
+ * A {@link ThirdPartyPluginAdapter} says ONCE, for one plugin, how to get from its instance to its typed API,
+ * and VERIFIES the shape on the way, so a release that renamed what the adapter reads is "not there" rather
+ * than a `Cannot read properties of undefined` from inside a callback. Everything else here is generic:
+ *
+ * - {@link getThirdPartyPluginApi} answers "now", for a one-shot use.
+ * - {@link watchThirdPartyPluginApi} answers "now" for as long as a component lives: its ref re-reads on every
+ *   `app.plugins` `changed` and every `obsidian-lib:plugin-loaded` / `-unloaded` broadcast, so an OPTIONAL
+ *   dependency is a ref whose `value` is `null` while the plugin is absent, and becomes the API the moment it
+ *   is enabled.
+ * - {@link waitForThirdPartyPluginApi} and {@link requireThirdPartyPluginApi} are the one-shot waits, built on
+ *   `waitForPlugin` / `requirePlugin` (`./plugin-instance.ts`), so they share that module's availability
+ *   classification, its notice and its repair buttons.
+ * - A REQUIRED dependency is declared through `PluginBase.getPluginDependencies()` as a
+ *   {@link ThirdPartyPluginDependency} (built by {@link createThirdPartyPluginDependency}), and the plugin gate
+ *   keeps `onloadImpl` from running while it is missing, too old or the wrong shape — the same treatment an
+ *   own-plugin dependency gets.
+ *
+ * Availability is {@link PluginAvailability}, read from Obsidian `1.15.1` as `plugin-instance.ts` documents:
+ * an instance whose `onload` is still running reads as `loading`, never as available. An adapter's
+ * `getApi` returning `null` reads as {@link PluginAvailability.ShapeMismatch}.
+ */
+import type { AsyncEventSource } from '@mnaoumov/typescript-lib/async-events' with { 'resolution-mode': 'import' };
+import type { App, Component, Plugin } from 'obsidian' with { 'resolution-mode': 'import' };
+import type { Except } from 'type-fest' with { 'resolution-mode': 'import' };
+import type { PluginDependencyBase } from '../components/plugin-gate-component.cjs';
+import type { RequirePluginParams, WaitForPluginParams } from './plugin-instance.cjs';
+import { PluginAvailability } from './plugin-instance.cjs';
+/**
+ * Parameters for {@link createThirdPartyPluginDependency}.
+ *
+ * @typeParam TApi - The adapter's API type.
+ */
+export interface CreateThirdPartyPluginDependencyParams<TApi extends object> {
+    /**
+     * The adapter of the required plugin.
+     */
+    readonly adapter: ThirdPartyPluginAdapter<TApi>;
+    /**
+     * The oldest release the dependent works with. Defaults to the adapter's own
+     * {@link ThirdPartyPluginAdapter.minPluginVersion}; a dependent may only raise it.
+     */
+    readonly minPluginVersion?: string;
+    /**
+     * A localized sentence saying what the dependent does with the plugin, shown in the settings banner.
+     */
+    readonly reason: DocumentFragment | string;
+}
+/**
+ * Parameters for {@link getThirdPartyPluginApi} and {@link getThirdPartyPluginAvailability}.
+ *
+ * @typeParam TApi - The adapter's API type.
+ */
+export interface GetThirdPartyPluginApiParams<TApi extends object> {
+    /**
+     * The adapter of the plugin.
+     */
+    readonly adapter: ThirdPartyPluginAdapter<TApi>;
+    /**
+     * The Obsidian app instance.
+     */
+    readonly app: App;
+    /**
+     * The oldest release the caller works with. Defaults to the adapter's own
+     * {@link ThirdPartyPluginAdapter.minPluginVersion}.
+     */
+    readonly minPluginVersion?: string;
+}
+/**
+ * Parameters for {@link getThirdPartyPluginAvailability}.
+ *
+ * @typeParam TApi - The adapter's API type.
+ */
+export type GetThirdPartyPluginAvailabilityParams<TApi extends object> = GetThirdPartyPluginApiParams<TApi>;
+/**
+ * Parameters for {@link requireThirdPartyPluginApi}.
+ *
+ * @typeParam TApi - The adapter's API type.
+ */
+export interface RequireThirdPartyPluginApiParams<TApi extends object> extends Except<RequirePluginParams, 'app' | 'isPlugin' | 'minPluginVersion' | 'pluginId' | 'pluginName'>, GetThirdPartyPluginApiParams<TApi> {
+}
+/**
+ * How to get from one third-party plugin's instance to its typed API.
+ *
+ * An adapter is plain data plus one function, so it can be a module-level constant shared by every consumer,
+ * and adding a plugin means adding one adapter.
+ *
+ * @typeParam TApi - The plugin's API, typed by the adapter's author and verified by {@link getApi}.
+ */
+export interface ThirdPartyPluginAdapter<TApi extends object> {
+    /**
+     * Reads the typed API off a running instance of the plugin, VERIFYING its shape.
+     *
+     * Return `null` when the instance does not carry the members the adapter types, which is what a release
+     * that renamed or reshaped them looks like. Never cast: a cast asserts a shape nothing checked.
+     *
+     * @param plugin - The running instance, whose `onload` has settled.
+     * @returns The API, or `null` when the instance is not the shape the adapter expects.
+     */
+    readonly getApi: (plugin: Plugin) => null | TApi;
+    /**
+     * The oldest release of the plugin the adapter was verified against, compared with its `manifest.version`.
+     * A release below it reads as {@link PluginAvailability.Outdated}.
+     */
+    readonly minPluginVersion?: string;
+    /**
+     * The `manifest.id` of the plugin.
+     */
+    readonly pluginId: string;
+    /**
+     * The display name of the plugin, shown to the user.
+     */
+    readonly pluginName: string;
+}
+/**
+ * A live reference to a third-party plugin's API.
+ *
+ * @typeParam TApi - The adapter's API type.
+ */
+export interface ThirdPartyPluginApiRef<TApi extends object> extends AsyncEventSource<ThirdPartyPluginApiRefEventMap> {
+    /**
+     * Whether the API can be used right now, and if not, why. Read at the moment of reading.
+     */
+    readonly availability: PluginAvailability;
+    /**
+     * The API, or `null` when it is not available right now. `null` during the consumer's `onload` may only
+     * mean the plugin has not loaded yet; the value becomes the API on its own once it has.
+     */
+    readonly value: null | TApi;
+}
+/**
+ * The events a {@link ThirdPartyPluginApiRef} fires.
+ */
+export interface ThirdPartyPluginApiRefEventMap {
+    /**
+     * Fired whenever {@link ThirdPartyPluginApiRef.value} changes, including when it becomes `null` because the
+     * plugin was disabled or reloaded.
+     */
+    readonly change: [];
+}
+/**
+ * A third-party plugin another plugin cannot work without, declared through
+ * `PluginBase.getPluginDependencies()`.
+ *
+ * Built by {@link createThirdPartyPluginDependency}, which copies the adapter's id and name.
+ */
+export interface ThirdPartyPluginDependency extends PluginDependencyBase {
+    /**
+     * The adapter the gate reads the dependency's API through.
+     */
+    readonly adapter: ThirdPartyPluginAdapter<object>;
+}
+/**
+ * Parameters for {@link waitForThirdPartyPluginApi}.
+ *
+ * @typeParam TApi - The adapter's API type.
+ */
+export interface WaitForThirdPartyPluginApiParams<TApi extends object> extends Except<WaitForPluginParams, 'app' | 'isPlugin' | 'minPluginVersion' | 'pluginId'>, GetThirdPartyPluginApiParams<TApi> {
+}
+/**
+ * Parameters for {@link watchThirdPartyPluginApi}.
+ *
+ * @typeParam TApi - The adapter's API type.
+ */
+export interface WatchThirdPartyPluginApiParams<TApi extends object> extends GetThirdPartyPluginApiParams<TApi> {
+    /**
+     * The component owning the watch. Its unload stops it.
+     */
+    readonly component: Component;
+}
+/**
+ * Builds the declaration of a required third-party plugin, for `PluginBase.getPluginDependencies()`.
+ *
+ * @typeParam TApi - The adapter's API type.
+ * @param params - The {@link CreateThirdPartyPluginDependencyParams}.
+ * @returns The dependency.
+ */
+export declare function createThirdPartyPluginDependency<TApi extends object>(params: CreateThirdPartyPluginDependencyParams<TApi>): ThirdPartyPluginDependency;
+/**
+ * Returns a third-party plugin's typed API when the plugin is {@link PluginAvailability.Available}, and `null`
+ * otherwise.
+ *
+ * @typeParam TApi - The adapter's API type.
+ * @param params - The {@link GetThirdPartyPluginApiParams}.
+ * @returns The API, or `null`.
+ */
+export declare function getThirdPartyPluginApi<TApi extends object>(params: GetThirdPartyPluginApiParams<TApi>): null | TApi;
+/**
+ * Reads whether a third-party plugin's API can be used right now, and if not, why.
+ *
+ * @typeParam TApi - The adapter's API type.
+ * @param params - The {@link GetThirdPartyPluginApiParams}.
+ * @returns The {@link PluginAvailability}; {@link PluginAvailability.ShapeMismatch} when the adapter does not
+ * recognize the running instance.
+ */
+export declare function getThirdPartyPluginAvailability<TApi extends object>(params: GetThirdPartyPluginAvailabilityParams<TApi>): PluginAvailability;
+/**
+ * Checks whether a dependency declared through `PluginBase.getPluginDependencies()` is a third-party one.
+ *
+ * @param dependency - The declared dependency.
+ * @returns Whether it carries an adapter.
+ */
+export declare function isThirdPartyPluginDependency(dependency: PluginDependencyBase): dependency is ThirdPartyPluginDependency;
+/**
+ * Waits for a third-party plugin's API, asking the user to install, enable or update the plugin while it is
+ * not available. Settles once; see `requirePlugin`.
+ *
+ * @typeParam TApi - The adapter's API type.
+ * @param params - The {@link RequireThirdPartyPluginApiParams}.
+ * @returns A {@link Promise} resolving with the API.
+ */
+export declare function requireThirdPartyPluginApi<TApi extends object>(params: RequireThirdPartyPluginApiParams<TApi>): Promise<TApi>;
+/**
+ * Waits for a third-party plugin's API to become available. Settles once; see `waitForPlugin`.
+ *
+ * @typeParam TApi - The adapter's API type.
+ * @param params - The {@link WaitForThirdPartyPluginApiParams}.
+ * @returns A {@link Promise} resolving with the API.
+ * @throws `PluginInstanceUnavailableError` when the timeout elapses.
+ */
+export declare function waitForThirdPartyPluginApi<TApi extends object>(params: WaitForThirdPartyPluginApiParams<TApi>): Promise<TApi>;
+/**
+ * Watches a third-party plugin's API and returns a live {@link ThirdPartyPluginApiRef}.
+ *
+ * The ref re-reads on every `app.plugins` `changed` and every library lifecycle broadcast, so it follows the
+ * plugin through enable, disable, update and reload with no polling. This is the shape of an OPTIONAL
+ * dependency: read `ref.value` where the integration is used, and treat `null` as "not there".
+ *
+ * @typeParam TApi - The adapter's API type.
+ * @param params - The {@link WatchThirdPartyPluginApiParams}.
+ * @returns The live reference.
+ */
+export declare function watchThirdPartyPluginApi<TApi extends object>(params: WatchThirdPartyPluginApiParams<TApi>): ThirdPartyPluginApiRef<TApi>;

package/dist/lib/cjs/plugin-cli-handler-registrar.cjs

@@ -117,8 +117,8 @@ __export(plugin_cli_handler_registrar_exports, {
   PluginCliHandlerRegistrar: () => PluginCliHandlerRegistrar
 });
 module.exports = __toCommonJS(plugin_cli_handler_registrar_exports);
-var import_async = require('@mnaoumov/typescript-lib/async');
-var import_obsidian = require('obsidian');
+var import_async = require("@mnaoumov/typescript-lib/async");
+var import_obsidian = require("obsidian");
 class PluginCliHandlerRegistrar {
   /**
    * Creates a new instance of the {@link PluginCliHandlerRegistrar} class.

package/dist/lib/cjs/popovers/field-popover.cjs

@@ -117,10 +117,10 @@ __export(field_popover_exports, {
   editFieldsInPopover: () => editFieldsInPopover
 });
 module.exports = __toCommonJS(field_popover_exports);
-var import_object_utils = require('@mnaoumov/typescript-lib/object-utils');
-var import_obsidian = require('obsidian');
-var import_css_class = require('../css-class.cjs');
-var import_popover = require('./popover.cjs');
+var import_object_utils = require("@mnaoumov/typescript-lib/object-utils");
+var import_obsidian = require("obsidian");
+var import_css_class = require("../css-class.cjs");
+var import_popover = require("./popover.cjs");
 async function editFieldsInPopover(params) {
   const {
     anchor,

package/dist/lib/cjs/popovers/index.cjs

@@ -102,9 +102,9 @@ __export(popovers_exports, {
   "popover-anchor": () => popover_anchor
 });
 module.exports = __toCommonJS(popovers_exports);
-var field_popover = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./field-popover.cjs')), 1);
-var popover_anchor = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./popover-anchor.cjs')), 1);
-var popover = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./popover.cjs')), 1);
+var field_popover = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require("./field-popover.cjs")), 1);
+var popover_anchor = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require("./popover-anchor.cjs")), 1);
+var popover = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require("./popover.cjs")), 1);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   "field-popover": null,

package/dist/lib/cjs/popovers/popover-anchor.cjs

@@ -120,7 +120,7 @@ __export(popover_anchor_exports, {
   createAnchorFromSelection: () => createAnchorFromSelection
 });
 module.exports = __toCommonJS(popover_anchor_exports);
-var import_html_element = require('@mnaoumov/typescript-lib/html-element');
+var import_html_element = require("@mnaoumov/typescript-lib/html-element");
 const CENTER_FRACTION = 0.5;
 function createAnchorFromDocumentCenter(doc) {
   const win = (0, import_html_element.getDocumentWindow)(doc);

package/dist/lib/cjs/popovers/popover.cjs

@@ -117,11 +117,11 @@ __export(popover_exports, {
   showPopover: () => showPopover
 });
 module.exports = __toCommonJS(popover_exports);
-var import_html_element = require('@mnaoumov/typescript-lib/html-element');
-var import_obsidian = require('obsidian');
-var import_css_class = require('../css-class.cjs');
-var import_i18n = require('../i18n/i18n.cjs');
-var import_plugin_context = require('../plugin/plugin-context.cjs');
+var import_html_element = require("@mnaoumov/typescript-lib/html-element");
+var import_obsidian = require("obsidian");
+var import_css_class = require("../css-class.cjs");
+var import_i18n = require("../i18n/i18n.cjs");
+var import_plugin_context = require("../plugin/plugin-context.cjs");
 const ANCHOR_GAP_IN_PIXELS = 4;
 const VIEWPORT_MARGIN_IN_PIXELS = 8;
 async function showPopover(params) {

package/dist/lib/cjs/queue.cjs

@@ -119,14 +119,14 @@ __export(queue_exports, {
   flushQueue: () => flushQueue
 });
 module.exports = __toCommonJS(queue_exports);
-var import_abort_controller = require('@mnaoumov/typescript-lib/abort-controller');
-var import_async = require('@mnaoumov/typescript-lib/async');
-var import_error = require('@mnaoumov/typescript-lib/error');
-var import_function = require('@mnaoumov/typescript-lib/function');
-var import_async_with_notice = require('./async-with-notice.cjs');
-var import_i18n = require('./i18n/i18n.cjs');
-var import_logger = require('./logger.cjs');
-var import_obsidian_lib_state = require('./obsidian-lib-state.cjs');
+var import_abort_controller = require("@mnaoumov/typescript-lib/abort-controller");
+var import_async = require("@mnaoumov/typescript-lib/async");
+var import_error = require("@mnaoumov/typescript-lib/error");
+var import_function = require("@mnaoumov/typescript-lib/function");
+var import_async_with_notice = require("./async-with-notice.cjs");
+var import_i18n = require("./i18n/i18n.cjs");
+var import_logger = require("./logger.cjs");
+var import_obsidian_lib_state = require("./obsidian-lib-state.cjs");
 function addToQueue(params) {
   const stackTrace = params.stackTrace ?? (0, import_error.getStackTrace)(1);
   (0, import_async.invokeAsyncSafely)(() => addToQueueAndWait(params), stackTrace);

package/dist/lib/cjs/react/app-context.cjs

@@ -118,9 +118,9 @@ __export(app_context_exports, {
   useApp: () => useApp
 });
 module.exports = __toCommonJS(app_context_exports);
-var import_type_guards = require('@mnaoumov/typescript-lib/type-guards');
-var import_obsidian = require('obsidian');
-var import_react = require('react');
+var import_type_guards = require("@mnaoumov/typescript-lib/type-guards");
+var import_obsidian = require("obsidian");
+var import_react = require("react");
 const AppContext = (0, import_react.createContext)(void 0);
 function useApp() {
   return (0, import_type_guards.ensureNonNullable)((0, import_react.useContext)(AppContext), "AppContext not found");

package/dist/lib/cjs/react/index.cjs

@@ -100,7 +100,7 @@ __export(react_exports, {
   "app-context": () => app_context
 });
 module.exports = __toCommonJS(react_exports);
-var app_context = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./app-context.cjs')), 1);
+var app_context = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require("./app-context.cjs")), 1);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   "app-context": null

package/dist/lib/cjs/reference-definition.cjs

@@ -90,7 +90,7 @@ __export(reference_definition_exports, {
   referenceDefinitionToFileChange: () => referenceDefinitionToFileChange
 });
 module.exports = __toCommonJS(reference_definition_exports);
-var import_debug = require('./debug.cjs');
+var import_debug = require("./debug.cjs");
 const ASCII_PUNCTUATION_REG_EXP = /[!-/:-@[-`{-~]/;
 const BARE_DESTINATION_FORBIDDEN_CHARACTER_REG_EXP = /[\s\p{Cc}]/u;
 const DEFINITION_PREFIX_REG_EXP = /^[ \t]*\[(?:\\[\s\S]|[^\\\]])+\]:[ \t]*(?:\r?\n(?:[ \t]*>)*[ \t]*)?/;