@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/cjs/components/core-plugin-toggle-component.cjs

@@ -0,0 +1,226 @@
+/*
+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'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    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 keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+(function patchObsidianRequire() {
+  const originalRequire = require;
+  if (!originalRequire || originalRequire.__isPatched) {
+    return;
+  }
+
+  // eslint-disable-next-line no-global-assign, no-implicit-globals -- We need to patch the `require()` function.
+  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 = 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 = 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);
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-deprecated, obsidianmd/no-global-this  -- Need access to app. Actively use globalThis.
+    if (globalThis.app.isMobile) {
+      if (id === 'process' || id === 'node:process') {
+        // eslint-disable-next-line no-console -- Valid usage.
+        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);
+      }
+    }
+
+    // eslint-disable-next-line no-console -- Valid usage.
+    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 core_plugin_toggle_component_exports = {};
+__export(core_plugin_toggle_component_exports, {
+  CorePluginToggleComponent: () => CorePluginToggleComponent
+});
+module.exports = __toCommonJS(core_plugin_toggle_component_exports);
+var import_async = require('@mnaoumov/typescript-lib/async');
+var import_component_ex = require('./component-ex.cjs');
+class CorePluginToggleComponent extends import_component_ex.ComponentEx {
+  /**
+   * The Obsidian app instance.
+   */
+  app;
+  /**
+   * The id of the watched core plugin.
+   */
+  corePluginId;
+  isCorePluginEnabled = false;
+  onDisable;
+  onEnable;
+  shouldCallOnDisableOnUnload;
+  /**
+   * Creates a new instance of the {@link CorePluginToggleComponent} class.
+   *
+   * @param params - The constructor parameters.
+   */
+  constructor(params) {
+    super();
+    this.app = params.app;
+    this.corePluginId = params.corePluginId;
+    this.onDisable = params.onDisable;
+    this.onEnable = params.onEnable;
+    this.shouldCallOnDisableOnUnload = params.shouldCallOnDisableOnUnload ?? false;
+  }
+  /**
+   * Subscribes to core plugin toggles, and runs the enable handler when the core plugin is already enabled.
+   */
+  onload() {
+    const corePlugin = this.app.internalPlugins.getPluginById(this.corePluginId);
+    if (!corePlugin) {
+      return;
+    }
+    this.isCorePluginEnabled = corePlugin.enabled;
+    this.registerEvent(this.app.internalPlugins.on("change", () => {
+      const isCorePluginEnabled = corePlugin.enabled;
+      if (isCorePluginEnabled === this.isCorePluginEnabled) {
+        return;
+      }
+      this.isCorePluginEnabled = isCorePluginEnabled;
+      this.invokeHandler(isCorePluginEnabled ? this.onEnable : this.onDisable);
+    }));
+    this.register(() => {
+      if (this.shouldCallOnDisableOnUnload && this.isCorePluginEnabled) {
+        this.invokeHandler(this.onDisable);
+      }
+    });
+    if (this.isCorePluginEnabled) {
+      this.invokeHandler(this.onEnable);
+    }
+  }
+  invokeHandler(handler) {
+    if (handler) {
+      (0, import_async.invokeAsyncSafely)(handler);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CorePluginToggleComponent
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvY29yZS1wbHVnaW4tdG9nZ2xlLWNvbXBvbmVudC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbnRhaW5zIGNsYXNzIHtAbGluayBDb3JlUGx1Z2luVG9nZ2xlQ29tcG9uZW50fSB0aGF0IHJ1bnMgYSBoYW5kbGVyIGVhY2ggdGltZSBhIGNvcmUgT2JzaWRpYW4gcGx1Z2luIGlzXG4gKiBlbmFibGVkIG9yIGRpc2FibGVkLlxuICovXG5cbmltcG9ydCB0eXBlIHsgSW50ZXJuYWxQbHVnaW5OYW1lVHlwZSB9IGZyb20gJ0BvYnNpZGlhbi10eXBpbmdzL29ic2lkaWFuLXB1YmxpYy1sYXRlc3QnO1xuaW1wb3J0IHR5cGUgeyBBcHAgfSBmcm9tICdvYnNpZGlhbic7XG5pbXBvcnQgdHlwZSB7IFByb21pc2FibGUgfSBmcm9tICd0eXBlLWZlc3QnO1xuXG5pbXBvcnQgeyBpbnZva2VBc3luY1NhZmVseSB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9hc3luYyc7XG5cbmltcG9ydCB7IENvbXBvbmVudEV4IH0gZnJvbSAnLi9jb21wb25lbnQtZXgudHMnO1xuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHRoZSB7QGxpbmsgQ29yZVBsdWdpblRvZ2dsZUNvbXBvbmVudH0gY29uc3RydWN0b3IuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ29yZVBsdWdpblRvZ2dsZUNvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2UuXG4gICAqL1xuICByZWFkb25seSBhcHA6IEFwcDtcblxuICAvKipcbiAgICogVGhlIGlkIG9mIHRoZSBjb3JlIHBsdWdpbiB0byB3YXRjaCwgZS5nLiBgSW50ZXJuYWxQbHVnaW5OYW1lLkNhbnZhc2AuXG4gICAqL1xuICByZWFkb25seSBjb3JlUGx1Z2luSWQ6IEludGVybmFsUGx1Z2luTmFtZVR5cGU7XG5cbiAgLyoqXG4gICAqIFJ1bnMgZWFjaCB0aW1lIHRoZSBjb3JlIHBsdWdpbiBnb2VzIGZyb20gZW5hYmxlZCB0byBkaXNhYmxlZC5cbiAgICpcbiAgICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gb3IgYHZvaWRgLiBBIHJlamVjdGlvbiBpcyByZXBvcnRlZCB0aHJvdWdoIHRoZSBsaWJyYXJ5J3MgYXN5bmMgZXJyb3IgaGFuZGxpbmcuXG4gICAqL1xuICByZWFkb25seSBvbkRpc2FibGU/OiAoKSA9PiBQcm9taXNhYmxlPHZvaWQ+O1xuXG4gIC8qKlxuICAgKiBSdW5zIGVhY2ggdGltZSB0aGUgY29yZSBwbHVnaW4gZ29lcyBmcm9tIGRpc2FibGVkIHRvIGVuYWJsZWQsIGFuZCBvbmNlIG9uIGxvYWQgd2hlbiB0aGUgY29yZSBwbHVnaW4gaXNcbiAgICogYWxyZWFkeSBlbmFibGVkIHRoZW4uXG4gICAqXG4gICAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IG9yIGB2b2lkYC4gQSByZWplY3Rpb24gaXMgcmVwb3J0ZWQgdGhyb3VnaCB0aGUgbGlicmFyeSdzIGFzeW5jIGVycm9yIGhhbmRsaW5nLlxuICAgKi9cbiAgcmVhZG9ubHkgb25FbmFibGU/OiAoKSA9PiBQcm9taXNhYmxlPHZvaWQ+O1xuXG4gIC8qKlxuICAgKiBXaGV0aGVyIHtAbGluayBvbkRpc2FibGV9IGFsc28gcnVucyB3aGVuIHRoaXMgY29tcG9uZW50IHVubG9hZHMgd2hpbGUgdGhlIGNvcmUgcGx1Z2luIGlzIGVuYWJsZWQsIHNvIGV2ZXJ5XG4gICAqIHtAbGluayBvbkVuYWJsZX0gaXMgYmFsYW5jZWQgYnkgb25lIHtAbGluayBvbkRpc2FibGV9LiBEZWZhdWx0cyB0byBgZmFsc2VgOiB0aGUgY29yZSBwbHVnaW4gZGlkIG5vdCBjaGFuZ2UsXG4gICAqIHNvIGEgY29uc3VtZXIgdGhhdCByZXB1Ymxpc2hlcyB0cmFuc2l0aW9ucyBtdXN0IG5vdCBzZWUgb25lLlxuICAgKi9cbiAgcmVhZG9ubHkgc2hvdWxkQ2FsbE9uRGlzYWJsZU9uVW5sb2FkPzogYm9vbGVhbjtcbn1cblxuLyoqXG4gKiBSdW5zIHtAbGluayBDb3JlUGx1Z2luVG9nZ2xlQ29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXMub25FbmFibGV9IC8ge0BsaW5rIENvcmVQbHVnaW5Ub2dnbGVDb21wb25lbnRDb25zdHJ1Y3RvclBhcmFtcy5vbkRpc2FibGV9XG4gKiBvbiB0aGUgZWRnZXMgb2YgYSBjb3JlIHBsdWdpbidzIGBlbmFibGVkYCBmbGFnLlxuICpcbiAqIEByZW1hcmtzXG4gKiBPYnNpZGlhbiByYWlzZXMgYGNoYW5nZWAgb24gYGFwcC5pbnRlcm5hbFBsdWdpbnNgIGZvciBldmVyeSBjb3JlIHBsdWdpbiB0b2dnbGUsIHdpdGggbm8gcGF5bG9hZCBuYW1pbmcgd2hpY2hcbiAqIG9uZTogYEludGVybmFsUGx1Z2luLmVuYWJsZSgpYCBzZXRzIGBlbmFibGVkYCBhcyBpdHMgZmlyc3Qgc3RhdGVtZW50IGFuZCByYWlzZXMgYGNoYW5nZWAgYXMgaXRzIGxhc3QsIGFuZFxuICogYGRpc2FibGUoKWAgbWlycm9ycyB0aGF0LiBTbyBhIGhhbmRsZXIgcmVhZGluZyBgZW5hYmxlZGAgc2VlcyB0aGUgcG9zdC10cmFuc2l0aW9uIHZhbHVlLCBidXQgaXQgYWxzbyBydW5zXG4gKiBmb3IgZXZlcnkgT1RIRVIgY29yZSBwbHVnaW4ncyB0b2dnbGUuIFRoaXMgY29tcG9uZW50IGtlZXBzIHRoZSBsYXN0IG9ic2VydmVkIHZhbHVlIGFuZCBjYWxscyBhIGhhbmRsZXIgb25seVxuICogd2hlbiB0aGUgZmxhZyBhY3R1YWxseSBtb3ZlZCwgd2hpY2ggaXMgdGhlIHN0ZXAgYSBoYW5kLXdyaXR0ZW4gc3Vic2NyaXB0aW9uIG1vc3QgZWFzaWx5IGdldHMgd3JvbmcuXG4gKlxuICogSXQgcmVwbGFjZXMgcGF0Y2hpbmcgYG9uVXNlckVuYWJsZWAgLyBgb25Vc2VyRGlzYWJsZWAgb24gdGhlIGNvcmUgcGx1Z2luJ3MgaW5zdGFuY2UgcHJvdG90eXBlLCB3aGljaCBldmVyeVxuICogdmF1bHQgc2hhcmVzLCBhbmQgaXQgYWxzbyBjYXRjaGVzIGEgdG9nZ2xlIHRoYXQgd2FzIG5vdCBkcml2ZW4gYnkgdGhlIHVzZXIsIHdoaWNoIG5laXRoZXIgaG9vayBmaXJlcyBmb3IuXG4gKlxuICogQSBjb3JlIHBsdWdpbiBpZCB0aGlzIE9ic2lkaWFuIHZlcnNpb24gZG9lcyBub3Qga25vdyByZWdpc3RlcnMgbm90aGluZy5cbiAqXG4gKiBIYW5kbGVycyBydW4gc3luY2hyb25vdXNseSB3aGVuIHRoZXkgYXJlIHN5bmNocm9ub3VzLCBzbyBhIGhhbmRsZXIgb2JzZXJ2ZXMgdGhlIHN0YXRlIHJpZ2h0IGFmdGVyIHRoZVxuICogdG9nZ2xlLlxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0c1xuICogdGhpcy5hZGRDaGlsZChuZXcgQ29yZVBsdWdpblRvZ2dsZUNvbXBvbmVudCh7XG4gKiAgIGFwcDogdGhpcy5hcHAsXG4gKiAgIGNvcmVQbHVnaW5JZDogSW50ZXJuYWxQbHVnaW5OYW1lLkNhbnZhcyxcbiAqICAgb25EaXNhYmxlOiAoKSA9PiB7XG4gKiAgICAgdGhpcy5zdG9wSW5kZXhpbmdDYW52YXNlcygpO1xuICogICB9LFxuICogICBvbkVuYWJsZTogKCkgPT4ge1xuICogICAgIHRoaXMuc3RhcnRJbmRleGluZ0NhbnZhc2VzKCk7XG4gKiAgIH0sXG4gKiAgIHNob3VsZENhbGxPbkRpc2FibGVPblVubG9hZDogdHJ1ZVxuICogfSkpO1xuICogYGBgXG4gKi9cbmV4cG9ydCBjbGFzcyBDb3JlUGx1Z2luVG9nZ2xlQ29tcG9uZW50IGV4dGVuZHMgQ29tcG9uZW50RXgge1xuICAvKipcbiAgICogVGhlIE9ic2lkaWFuIGFwcCBpbnN0YW5jZS5cbiAgICovXG4gIHByb3RlY3RlZCByZWFkb25seSBhcHA6IEFwcDtcblxuICAvKipcbiAgICogVGhlIGlkIG9mIHRoZSB3YXRjaGVkIGNvcmUgcGx1Z2luLlxuICAgKi9cbiAgcHJvdGVjdGVkIHJlYWRvbmx5IGNvcmVQbHVnaW5JZDogSW50ZXJuYWxQbHVnaW5OYW1lVHlwZTtcblxuICBwcml2YXRlIGlzQ29yZVBsdWdpbkVuYWJsZWQgPSBmYWxzZTtcbiAgcHJpdmF0ZSByZWFkb25seSBvbkRpc2FibGU6ICgoKSA9PiBQcm9taXNhYmxlPHZvaWQ+KSB8IHVuZGVmaW5lZDtcbiAgcHJpdmF0ZSByZWFkb25seSBvbkVuYWJsZTogKCgpID0+IFByb21pc2FibGU8dm9pZD4pIHwgdW5kZWZpbmVkO1xuICBwcml2YXRlIHJlYWRvbmx5IHNob3VsZENhbGxPbkRpc2FibGVPblVubG9hZDogYm9vbGVhbjtcblxuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBpbnN0YW5jZSBvZiB0aGUge0BsaW5rIENvcmVQbHVnaW5Ub2dnbGVDb21wb25lbnR9IGNsYXNzLlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIGNvbnN0cnVjdG9yIHBhcmFtZXRlcnMuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocGFyYW1zOiBDb3JlUGx1Z2luVG9nZ2xlQ29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXMpIHtcbiAgICBzdXBlcigpO1xuICAgIHRoaXMuYXBwID0gcGFyYW1zLmFwcDtcbiAgICB0aGlzLmNvcmVQbHVnaW5JZCA9IHBhcmFtcy5jb3JlUGx1Z2luSWQ7XG4gICAgdGhpcy5vbkRpc2FibGUgPSBwYXJhbXMub25EaXNhYmxlO1xuICAgIHRoaXMub25FbmFibGUgPSBwYXJhbXMub25FbmFibGU7XG4gICAgdGhpcy5zaG91bGRDYWxsT25EaXNhYmxlT25VbmxvYWQgPSBwYXJhbXMuc2hvdWxkQ2FsbE9uRGlzYWJsZU9uVW5sb2FkID8/IGZhbHNlO1xuICB9XG5cbiAgLyoqXG4gICAqIFN1YnNjcmliZXMgdG8gY29yZSBwbHVnaW4gdG9nZ2xlcywgYW5kIHJ1bnMgdGhlIGVuYWJsZSBoYW5kbGVyIHdoZW4gdGhlIGNvcmUgcGx1Z2luIGlzIGFscmVhZHkgZW5hYmxlZC5cbiAgICovXG4gIHB1YmxpYyBvdmVycmlkZSBvbmxvYWQoKTogdm9pZCB7XG4gICAgY29uc3QgY29yZVBsdWdpbiA9IHRoaXMuYXBwLmludGVybmFsUGx1Z2lucy5nZXRQbHVnaW5CeUlkKHRoaXMuY29yZVBsdWdpbklkKTtcbiAgICBpZiAoIWNvcmVQbHVnaW4pIHtcbiAgICAgIHJldHVybjtcbiAgICB9XG5cbiAgICB0aGlzLmlzQ29yZVBsdWdpbkVuYWJsZWQgPSBjb3JlUGx1Z2luLmVuYWJsZWQ7XG5cbiAgICB0aGlzLnJlZ2lzdGVyRXZlbnQodGhpcy5hcHAuaW50ZXJuYWxQbHVnaW5zLm9uKCdjaGFuZ2UnLCAoKSA9PiB7XG4gICAgICBjb25zdCBpc0NvcmVQbHVnaW5FbmFibGVkID0gY29yZVBsdWdpbi5lbmFibGVkO1xuICAgICAgaWYgKGlzQ29yZVBsdWdpbkVuYWJsZWQgPT09IHRoaXMuaXNDb3JlUGx1Z2luRW5hYmxlZCkge1xuICAgICAgICByZXR1cm47XG4gICAgICB9XG4gICAgICB0aGlzLmlzQ29yZVBsdWdpbkVuYWJsZWQgPSBpc0NvcmVQbHVnaW5FbmFibGVkO1xuICAgICAgdGhpcy5pbnZva2VIYW5kbGVyKGlzQ29yZVBsdWdpbkVuYWJsZWQgPyB0aGlzLm9uRW5hYmxlIDogdGhpcy5vbkRpc2FibGUpO1xuICAgIH0pKTtcblxuICAgIHRoaXMucmVnaXN0ZXIoKCkgPT4ge1xuICAgICAgaWYgKHRoaXMuc2hvdWxkQ2FsbE9uRGlzYWJsZU9uVW5sb2FkICYmIHRoaXMuaXNDb3JlUGx1Z2luRW5hYmxlZCkge1xuICAgICAgICB0aGlzLmludm9rZUhhbmRsZXIodGhpcy5vbkRpc2FibGUpO1xuICAgICAgfVxuICAgIH0pO1xuXG4gICAgaWYgKHRoaXMuaXNDb3JlUGx1Z2luRW5hYmxlZCkge1xuICAgICAgdGhpcy5pbnZva2VIYW5kbGVyKHRoaXMub25FbmFibGUpO1xuICAgIH1cbiAgfVxuXG4gIHByaXZhdGUgaW52b2tlSGFuZGxlcihoYW5kbGVyOiAoKCkgPT4gUHJvbWlzYWJsZTx2b2lkPikgfCB1bmRlZmluZWQpOiB2b2lkIHtcbiAgICBpZiAoaGFuZGxlcikge1xuICAgICAgaW52b2tlQXN5bmNTYWZlbHkoaGFuZGxlcik7XG4gICAgfVxuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBV0EsbUJBQWtDO0FBRWxDLDBCQUE0QjtBQXlFckIsTUFBTSxrQ0FBa0MsZ0NBQVk7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUl0QztBQUFBO0FBQUE7QUFBQTtBQUFBLEVBS0E7QUFBQSxFQUVYLHNCQUFzQjtBQUFBLEVBQ2I7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9WLFlBQVksUUFBb0Q7QUFDckUsVUFBTTtBQUNOLFNBQUssTUFBTSxPQUFPO0FBQ2xCLFNBQUssZUFBZSxPQUFPO0FBQzNCLFNBQUssWUFBWSxPQUFPO0FBQ3hCLFNBQUssV0FBVyxPQUFPO0FBQ3ZCLFNBQUssOEJBQThCLE9BQU8sK0JBQStCO0FBQUEsRUFDM0U7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtnQixTQUFlO0FBQzdCLFVBQU0sYUFBYSxLQUFLLElBQUksZ0JBQWdCLGNBQWMsS0FBSyxZQUFZO0FBQzNFLFFBQUksQ0FBQyxZQUFZO0FBQ2Y7QUFBQSxJQUNGO0FBRUEsU0FBSyxzQkFBc0IsV0FBVztBQUV0QyxTQUFLLGNBQWMsS0FBSyxJQUFJLGdCQUFnQixHQUFHLFVBQVUsTUFBTTtBQUM3RCxZQUFNLHNCQUFzQixXQUFXO0FBQ3ZDLFVBQUksd0JBQXdCLEtBQUsscUJBQXFCO0FBQ3BEO0FBQUEsTUFDRjtBQUNBLFdBQUssc0JBQXNCO0FBQzNCLFdBQUssY0FBYyxzQkFBc0IsS0FBSyxXQUFXLEtBQUssU0FBUztBQUFBLElBQ3pFLENBQUMsQ0FBQztBQUVGLFNBQUssU0FBUyxNQUFNO0FBQ2xCLFVBQUksS0FBSywrQkFBK0IsS0FBSyxxQkFBcUI7QUFDaEUsYUFBSyxjQUFjLEtBQUssU0FBUztBQUFBLE1BQ25DO0FBQUEsSUFDRixDQUFDO0FBRUQsUUFBSSxLQUFLLHFCQUFxQjtBQUM1QixXQUFLLGNBQWMsS0FBSyxRQUFRO0FBQUEsSUFDbEM7QUFBQSxFQUNGO0FBQUEsRUFFUSxjQUFjLFNBQXFEO0FBQ3pFLFFBQUksU0FBUztBQUNYLDBDQUFrQixPQUFPO0FBQUEsSUFDM0I7QUFBQSxFQUNGO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/cjs/components/core-plugin-toggle-component.d.cts

@@ -0,0 +1,102 @@
+/// <reference path="../library.d.cts" />
+/**
+ * @file
+ *
+ * Contains class {@link CorePluginToggleComponent} that runs a handler each time a core Obsidian plugin is
+ * enabled or disabled.
+ */
+import type { InternalPluginNameType } from '@obsidian-typings/obsidian-public-latest' with { 'resolution-mode': 'import' };
+import type { App } from 'obsidian' with { 'resolution-mode': 'import' };
+import type { Promisable } from 'type-fest' with { 'resolution-mode': 'import' };
+import { ComponentEx } from './component-ex.cjs';
+/**
+ * Parameters for the {@link CorePluginToggleComponent} constructor.
+ */
+export interface CorePluginToggleComponentConstructorParams {
+    /**
+     * The Obsidian app instance.
+     */
+    readonly app: App;
+    /**
+     * The id of the core plugin to watch, e.g. `InternalPluginName.Canvas`.
+     */
+    readonly corePluginId: InternalPluginNameType;
+    /**
+     * Runs each time the core plugin goes from enabled to disabled.
+     *
+     * @returns A {@link Promise} or `void`. A rejection is reported through the library's async error handling.
+     */
+    readonly onDisable?: () => Promisable<void>;
+    /**
+     * Runs each time the core plugin goes from disabled to enabled, and once on load when the core plugin is
+     * already enabled then.
+     *
+     * @returns A {@link Promise} or `void`. A rejection is reported through the library's async error handling.
+     */
+    readonly onEnable?: () => Promisable<void>;
+    /**
+     * Whether {@link onDisable} also runs when this component unloads while the core plugin is enabled, so every
+     * {@link onEnable} is balanced by one {@link onDisable}. Defaults to `false`: the core plugin did not change,
+     * so a consumer that republishes transitions must not see one.
+     */
+    readonly shouldCallOnDisableOnUnload?: boolean;
+}
+/**
+ * Runs {@link CorePluginToggleComponentConstructorParams.onEnable} / {@link CorePluginToggleComponentConstructorParams.onDisable}
+ * on the edges of a core plugin's `enabled` flag.
+ *
+ * @remarks
+ * Obsidian raises `change` on `app.internalPlugins` for every core plugin toggle, with no payload naming which
+ * one: `InternalPlugin.enable()` sets `enabled` as its first statement and raises `change` as its last, and
+ * `disable()` mirrors that. So a handler reading `enabled` sees the post-transition value, but it also runs
+ * for every OTHER core plugin's toggle. This component keeps the last observed value and calls a handler only
+ * when the flag actually moved, which is the step a hand-written subscription most easily gets wrong.
+ *
+ * It replaces patching `onUserEnable` / `onUserDisable` on the core plugin's instance prototype, which every
+ * vault shares, and it also catches a toggle that was not driven by the user, which neither hook fires for.
+ *
+ * A core plugin id this Obsidian version does not know registers nothing.
+ *
+ * Handlers run synchronously when they are synchronous, so a handler observes the state right after the
+ * toggle.
+ *
+ * @example
+ * ```ts
+ * this.addChild(new CorePluginToggleComponent({
+ *   app: this.app,
+ *   corePluginId: InternalPluginName.Canvas,
+ *   onDisable: () => {
+ *     this.stopIndexingCanvases();
+ *   },
+ *   onEnable: () => {
+ *     this.startIndexingCanvases();
+ *   },
+ *   shouldCallOnDisableOnUnload: true
+ * }));
+ * ```
+ */
+export declare class CorePluginToggleComponent extends ComponentEx {
+    /**
+     * The Obsidian app instance.
+     */
+    protected readonly app: App;
+    /**
+     * The id of the watched core plugin.
+     */
+    protected readonly corePluginId: InternalPluginNameType;
+    private isCorePluginEnabled;
+    private readonly onDisable;
+    private readonly onEnable;
+    private readonly shouldCallOnDisableOnUnload;
+    /**
+     * Creates a new instance of the {@link CorePluginToggleComponent} class.
+     *
+     * @param params - The constructor parameters.
+     */
+    constructor(params: CorePluginToggleComponentConstructorParams);
+    /**
+     * Subscribes to core plugin toggles, and runs the enable handler when the core plugin is already enabled.
+     */
+    onload(): void;
+    private invokeHandler;
+}

package/dist/lib/cjs/components/disposable-component.cjs

@@ -0,0 +1,178 @@
+/*
+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'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    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 keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+(function patchObsidianRequire() {
+  const originalRequire = require;
+  if (!originalRequire || originalRequire.__isPatched) {
+    return;
+  }
+
+  // eslint-disable-next-line no-global-assign, no-implicit-globals -- We need to patch the `require()` function.
+  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 = 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 = 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);
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-deprecated, obsidianmd/no-global-this  -- Need access to app. Actively use globalThis.
+    if (globalThis.app.isMobile) {
+      if (id === 'process' || id === 'node:process') {
+        // eslint-disable-next-line no-console -- Valid usage.
+        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);
+      }
+    }
+
+    // eslint-disable-next-line no-console -- Valid usage.
+    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 disposable_component_exports = {};
+__export(disposable_component_exports, {
+  asDisposableComponent: () => asDisposableComponent
+});
+module.exports = __toCommonJS(disposable_component_exports);
+var import_obsidian = require('obsidian');
+function asDisposableComponent(component) {
+  const disposableEx = component;
+  const symbolDispose = disposableEx[Symbol.dispose] ?? (() => {
+    component.unload();
+  });
+  disposableEx[Symbol.dispose] = symbolDispose;
+  disposableEx.dispose = () => {
+    symbolDispose();
+  };
+  return disposableEx;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  asDisposableComponent
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvZGlzcG9zYWJsZS1jb21wb25lbnQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBEaXNwb3NhYmxlIGNvbXBvbmVudCBiYXNlIGNsYXNzIGFuZCB1dGlsaXRpZXMgZm9yIGB1c2luZ2AgZGVjbGFyYXRpb25zLlxuICovXG5cbmltcG9ydCB0eXBlIHsgRGlzcG9zYWJsZUV4IH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL2Rpc3Bvc2FibGUnO1xuXG5pbXBvcnQgeyBDb21wb25lbnQgfSBmcm9tICdvYnNpZGlhbic7XG5cbnR5cGUgRGlzcG9zYWJsZUNvbXBvbmVudFdyYXBwZXI8VENvbXBvbmVudCBleHRlbmRzIENvbXBvbmVudD4gPSBEaXNwb3NhYmxlRXggJiBUQ29tcG9uZW50O1xuXG4vKipcbiAqIENvbnZlcnQgY29tcG9uZW50IHRvIGEge0BsaW5rIERpc3Bvc2FibGVFeH0gaW50ZXJmYWNlIGJ5IGFkZGluZyBgU3ltYm9sLmRpc3Bvc2VgIGFuZCBhIGNvbnZlbmllbmNlXG4gKiB7QGxpbmsgRGlzcG9zYWJsZUV4LmRpc3Bvc2V9IG1ldGhvZCB0aGF0IHVubG9hZHMgdGhlIGNvbXBvbmVudCB3aGVuIGRpc3Bvc2VkLlxuICpcbiAqIEFuIGV4aXN0aW5nIGBTeW1ib2wuZGlzcG9zZWAgaXMgcHJlc2VydmVkOyB0aGUgY29udmVuaWVuY2Uge0BsaW5rIERpc3Bvc2FibGVFeC5kaXNwb3NlfSBtZXRob2QgYWx3YXlzXG4gKiBkZWxlZ2F0ZXMgdG8gaXQuIFRoZSBwYXNzZWQgY29tcG9uZW50IGlzIG11dGF0ZWQgaW4gcGxhY2UgYW5kIHJldHVybmVkLCBzbyB0aGUgY2FsbCBpcyBpZGVtcG90ZW50LlxuICpcbiAqIEB0eXBlUGFyYW0gVENvbXBvbmVudCAtIFRoZSB0eXBlIG9mIGNvbXBvbmVudCB0byB3cmFwLCBjb25zdHJhaW5lZCB0byBleHRlbmQgQ29tcG9uZW50LlxuICpcbiAqIEBwYXJhbSBjb21wb25lbnQgLSBUaGUgY29tcG9uZW50IGluc3RhbmNlIHRvIHdyYXAgd2l0aCBEaXNwb3NhYmxlIHN1cHBvcnQuXG4gKiBAcmV0dXJucyBUaGUgY29tcG9uZW50IGNhc3QgdG8gYERpc3Bvc2FibGVDb21wb25lbnRXcmFwcGVyYCB3aXRoIGBTeW1ib2wuZGlzcG9zZWAgYW5kIGBkaXNwb3NlYFxuICogICBhdHRhY2hlZC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGFzRGlzcG9zYWJsZUNvbXBvbmVudDxUQ29tcG9uZW50IGV4dGVuZHMgQ29tcG9uZW50Pihjb21wb25lbnQ6IFRDb21wb25lbnQpOiBEaXNwb3NhYmxlQ29tcG9uZW50V3JhcHBlcjxUQ29tcG9uZW50PiB7XG4gIGNvbnN0IGRpc3Bvc2FibGVFeCA9IGNvbXBvbmVudCBhcyBQYXJ0aWFsPERpc3Bvc2FibGVFeD47XG4gIGNvbnN0IHN5bWJvbERpc3Bvc2U6ICgpID0+IHZvaWQgPSBkaXNwb3NhYmxlRXhbU3ltYm9sLmRpc3Bvc2VdID8/ICgoKTogdm9pZCA9PiB7XG4gICAgY29tcG9uZW50LnVubG9hZCgpO1xuICB9KTtcbiAgZGlzcG9zYWJsZUV4W1N5bWJvbC5kaXNwb3NlXSA9IHN5bWJvbERpc3Bvc2U7XG4gIGRpc3Bvc2FibGVFeC5kaXNwb3NlID0gKCk6IHZvaWQgPT4ge1xuICAgIHN5bWJvbERpc3Bvc2UoKTtcbiAgfTtcbiAgcmV0dXJuIGRpc3Bvc2FibGVFeCBhcyBEaXNwb3NhYmxlQ29tcG9uZW50V3JhcHBlcjxUQ29tcG9uZW50Pjtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFRQSxzQkFBMEI7QUFpQm5CLFNBQVMsc0JBQW9ELFdBQStEO0FBQ2pJLFFBQU0sZUFBZTtBQUNyQixRQUFNLGdCQUE0QixhQUFhLE9BQU8sT0FBTyxNQUFNLE1BQVk7QUFDN0UsY0FBVSxPQUFPO0FBQUEsRUFDbkI7QUFDQSxlQUFhLE9BQU8sT0FBTyxJQUFJO0FBQy9CLGVBQWEsVUFBVSxNQUFZO0FBQ2pDLGtCQUFjO0FBQUEsRUFDaEI7QUFDQSxTQUFPO0FBQ1Q7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/cjs/components/disposable-component.d.cts

@@ -0,0 +1,24 @@
+/// <reference path="../library.d.cts" />
+/**
+ * @file
+ *
+ * Disposable component base class and utilities for `using` declarations.
+ */
+import type { DisposableEx } from '@mnaoumov/typescript-lib/disposable' with { 'resolution-mode': 'import' };
+import { Component } from 'obsidian';
+type DisposableComponentWrapper<TComponent extends Component> = DisposableEx & TComponent;
+/**
+ * Convert component to a {@link DisposableEx} interface by adding `Symbol.dispose` and a convenience
+ * {@link DisposableEx.dispose} method that unloads the component when disposed.
+ *
+ * An existing `Symbol.dispose` is preserved; the convenience {@link DisposableEx.dispose} method always
+ * delegates to it. The passed component is mutated in place and returned, so the call is idempotent.
+ *
+ * @typeParam TComponent - The type of component to wrap, constrained to extend Component.
+ *
+ * @param component - The component instance to wrap with Disposable support.
+ * @returns The component cast to `DisposableComponentWrapper` with `Symbol.dispose` and `dispose`
+ *   attached.
+ */
+export declare function asDisposableComponent<TComponent extends Component>(component: TComponent): DisposableComponentWrapper<TComponent>;
+export {};