obsidian-dev-utils 65.0.1 → 66.0.1

package/dist/lib/esm/obsidian/components/layout-ready-component.mjs

@@ -0,0 +1,76 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function initEsm() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  if (globalThis.process) {
+    return;
+  }
+
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  globalThis.process = browserProcess;
+})();
+
+import { invokeAsyncSafely } from "../../async.mjs";
+import { DisposableComponent } from "./disposable-component.mjs";
+class LayoutReadyComponent extends DisposableComponent {
+  /**
+   * Creates a new LayoutReadyComponent instance.
+   *
+   * @param app - The Obsidian App instance.
+   */
+  constructor(app) {
+    super();
+    this.app = app;
+  }
+  app;
+  /**
+   * Loads the component and registers the layout ready handler.
+   */
+  onload() {
+    super.onload();
+    this.app.workspace.onLayoutReady(() => {
+      window.setTimeout(() => {
+        if (this._loaded) {
+          invokeAsyncSafely(this.onLayoutReady.bind(this));
+        }
+      }, 0);
+    });
+  }
+}
+class CallbackLayoutReadyComponent extends LayoutReadyComponent {
+  /**
+   * Creates a new CallbackLayoutReadyComponent instance.
+   *
+   * @param app - The Obsidian App instance.
+   * @param callback - The callback to invoke when layout is ready.
+   */
+  constructor(app, callback) {
+    super(app);
+    this.callback = callback;
+  }
+  callback;
+  /**
+   * Executes when the Obsidian layout becomes ready.
+   *
+   * @returns The result of invoking the callback.
+   */
+  onLayoutReady() {
+    return this.callback();
+  }
+}
+export {
+  CallbackLayoutReadyComponent,
+  LayoutReadyComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbXBvbmVudHMvbGF5b3V0LXJlYWR5LWNvbXBvbmVudC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIEludGVyZmFjZSBmb3IgY29tcG9uZW50cyB0aGF0IG5lZWQgdG8gcGVyZm9ybSB3b3JrIHdoZW4gdGhlIHdvcmtzcGFjZSBsYXlvdXQgaXMgcmVhZHkuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBBcHAgfSBmcm9tICdvYnNpZGlhbic7XG5pbXBvcnQgdHlwZSB7IFByb21pc2FibGUgfSBmcm9tICd0eXBlLWZlc3QnO1xuXG5pbXBvcnQgeyBpbnZva2VBc3luY1NhZmVseSB9IGZyb20gJy4uLy4uL2FzeW5jLnRzJztcbmltcG9ydCB7IERpc3Bvc2FibGVDb21wb25lbnQgfSBmcm9tICcuL2Rpc3Bvc2FibGUtY29tcG9uZW50LnRzJztcblxuLyoqXG4gKiBBIGNvbXBvbmVudCB0aGF0IGV4ZWN1dGVzIGEgY2FsbGJhY2sgZnVuY3Rpb24gd2hlbiB0aGUgT2JzaWRpYW4gbGF5b3V0IGJlY29tZXMgcmVhZHkuXG4gKi9cbmV4cG9ydCBhYnN0cmFjdCBjbGFzcyBMYXlvdXRSZWFkeUNvbXBvbmVudCBleHRlbmRzIERpc3Bvc2FibGVDb21wb25lbnQge1xuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBMYXlvdXRSZWFkeUNvbXBvbmVudCBpbnN0YW5jZS5cbiAgICpcbiAgICogQHBhcmFtIGFwcCAtIFRoZSBPYnNpZGlhbiBBcHAgaW5zdGFuY2UuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocHJpdmF0ZSByZWFkb25seSBhcHA6IEFwcCkge1xuICAgIHN1cGVyKCk7XG4gIH1cblxuICAvKipcbiAgICogTG9hZHMgdGhlIGNvbXBvbmVudCBhbmQgcmVnaXN0ZXJzIHRoZSBsYXlvdXQgcmVhZHkgaGFuZGxlci5cbiAgICovXG4gIHB1YmxpYyBvdmVycmlkZSBvbmxvYWQoKTogdm9pZCB7XG4gICAgc3VwZXIub25sb2FkKCk7XG4gICAgdGhpcy5hcHAud29ya3NwYWNlLm9uTGF5b3V0UmVhZHkoKCkgPT4ge1xuICAgICAgd2luZG93LnNldFRpbWVvdXQoKCkgPT4ge1xuICAgICAgICBpZiAodGhpcy5fbG9hZGVkKSB7XG4gICAgICAgICAgaW52b2tlQXN5bmNTYWZlbHkodGhpcy5vbkxheW91dFJlYWR5LmJpbmQodGhpcykpO1xuICAgICAgICB9XG4gICAgICB9LCAwKTtcbiAgICB9KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBFeGVjdXRlcyB3aGVuIHRoZSBPYnNpZGlhbiBsYXlvdXQgYmVjb21lcyByZWFkeS5cbiAgICovXG4gIHByb3RlY3RlZCBhYnN0cmFjdCBvbkxheW91dFJlYWR5KCk6IFByb21pc2FibGU8dm9pZD47XG59XG5cbi8qKlxuICogQSB7QGxpbmsgTGF5b3V0UmVhZHlDb21wb25lbnR9IHN1YmNsYXNzIHRoYXQgaW52b2tlcyBhIHByb3ZpZGVkIGNhbGxiYWNrIGZ1bmN0aW9uIHdoZW4gdGhlIGxheW91dCBiZWNvbWVzIHJlYWR5LlxuICovXG5leHBvcnQgY2xhc3MgQ2FsbGJhY2tMYXlvdXRSZWFkeUNvbXBvbmVudCBleHRlbmRzIExheW91dFJlYWR5Q29tcG9uZW50IHtcbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgQ2FsbGJhY2tMYXlvdXRSZWFkeUNvbXBvbmVudCBpbnN0YW5jZS5cbiAgICpcbiAgICogQHBhcmFtIGFwcCAtIFRoZSBPYnNpZGlhbiBBcHAgaW5zdGFuY2UuXG4gICAqIEBwYXJhbSBjYWxsYmFjayAtIFRoZSBjYWxsYmFjayB0byBpbnZva2Ugd2hlbiBsYXlvdXQgaXMgcmVhZHkuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IoYXBwOiBBcHAsIHByaXZhdGUgcmVhZG9ubHkgY2FsbGJhY2s6ICgpID0+IFByb21pc2FibGU8dm9pZD4pIHtcbiAgICBzdXBlcihhcHApO1xuICB9XG5cbiAgLyoqXG4gICAqIEV4ZWN1dGVzIHdoZW4gdGhlIE9ic2lkaWFuIGxheW91dCBiZWNvbWVzIHJlYWR5LlxuICAgKlxuICAgKiBAcmV0dXJucyBUaGUgcmVzdWx0IG9mIGludm9raW5nIHRoZSBjYWxsYmFjay5cbiAgICovXG4gIHByb3RlY3RlZCBvdmVycmlkZSBvbkxheW91dFJlYWR5KCk6IFByb21pc2FibGU8dm9pZD4ge1xuICAgIHJldHVybiB0aGlzLmNhbGxiYWNrKCk7XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBU0EsU0FBUyx5QkFBeUI7QUFDbEMsU0FBUywyQkFBMkI7QUFLN0IsTUFBZSw2QkFBNkIsb0JBQW9CO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBTTlELFlBQTZCLEtBQVU7QUFDNUMsVUFBTTtBQUQ0QjtBQUFBLEVBRXBDO0FBQUEsRUFGb0M7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9wQixTQUFlO0FBQzdCLFVBQU0sT0FBTztBQUNiLFNBQUssSUFBSSxVQUFVLGNBQWMsTUFBTTtBQUNyQyxhQUFPLFdBQVcsTUFBTTtBQUN0QixZQUFJLEtBQUssU0FBUztBQUNoQiw0QkFBa0IsS0FBSyxjQUFjLEtBQUssSUFBSSxDQUFDO0FBQUEsUUFDakQ7QUFBQSxNQUNGLEdBQUcsQ0FBQztBQUFBLElBQ04sQ0FBQztBQUFBLEVBQ0g7QUFNRjtBQUtPLE1BQU0scUNBQXFDLHFCQUFxQjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBTzlELFlBQVksS0FBMkIsVUFBa0M7QUFDOUUsVUFBTSxHQUFHO0FBRG1DO0FBQUEsRUFFOUM7QUFBQSxFQUY4QztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVMzQixnQkFBa0M7QUFDbkQsV0FBTyxLQUFLLFNBQVM7QUFBQSxFQUN2QjtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/esm/obsidian/components/menu-event-registrar-component.d.mts

@@ -0,0 +1,41 @@
+/**
+ * @file
+ *
+ * Registers menu event handlers with Obsidian's workspace, supporting editor, file, and multi-file context menus.
+ */
+import type { App } from 'obsidian';
+import type { EditorMenuEventHandler, FileMenuEventHandler, FilesMenuEventHandler, MenuEventRegistrar } from '../menu-event-registrar.mjs';
+import { DisposableComponent } from './disposable-component.mjs';
+/**
+ * {@link MenuEventRegistrar} backed by Obsidian's {@link App} workspace events.
+ *
+ * Event handlers are registered with the provided {@link Component} for lifecycle management.
+ */
+/** */
+export declare class MenuEventRegistrarComponent extends DisposableComponent implements MenuEventRegistrar {
+    private readonly app;
+    /**
+     * Creates a new app-backed menu event registrar.
+     *
+     * @param app - The Obsidian app instance.
+     */
+    constructor(app: App);
+    /**
+     * Registers a handler for the editor context menu event.
+     *
+     * @param handler - The handler to register.
+     */
+    registerEditorMenuEventHandler(handler: EditorMenuEventHandler): void;
+    /**
+     * Registers a handler for the single-file context menu event.
+     *
+     * @param handler - The handler to register.
+     */
+    registerFileMenuEventHandler(handler: FileMenuEventHandler): void;
+    /**
+     * Registers a handler for the multi-file context menu event.
+     *
+     * @param handler - The handler to register.
+     */
+    registerFilesMenuEventHandler(handler: FilesMenuEventHandler): void;
+}

package/dist/lib/esm/obsidian/components/menu-event-registrar-component.mjs

@@ -0,0 +1,64 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function initEsm() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  if (globalThis.process) {
+    return;
+  }
+
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  globalThis.process = browserProcess;
+})();
+
+import { DisposableComponent } from "./disposable-component.mjs";
+class MenuEventRegistrarComponent extends DisposableComponent {
+  /**
+   * Creates a new app-backed menu event registrar.
+   *
+   * @param app - The Obsidian app instance.
+   */
+  constructor(app) {
+    super();
+    this.app = app;
+  }
+  app;
+  /**
+   * Registers a handler for the editor context menu event.
+   *
+   * @param handler - The handler to register.
+   */
+  registerEditorMenuEventHandler(handler) {
+    this.registerEvent(this.app.workspace.on("editor-menu", handler));
+  }
+  /**
+   * Registers a handler for the single-file context menu event.
+   *
+   * @param handler - The handler to register.
+   */
+  registerFileMenuEventHandler(handler) {
+    this.registerEvent(this.app.workspace.on("file-menu", handler));
+  }
+  /**
+   * Registers a handler for the multi-file context menu event.
+   *
+   * @param handler - The handler to register.
+   */
+  registerFilesMenuEventHandler(handler) {
+    this.registerEvent(this.app.workspace.on("files-menu", handler));
+  }
+}
+export {
+  MenuEventRegistrarComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbXBvbmVudHMvbWVudS1ldmVudC1yZWdpc3RyYXItY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogUmVnaXN0ZXJzIG1lbnUgZXZlbnQgaGFuZGxlcnMgd2l0aCBPYnNpZGlhbidzIHdvcmtzcGFjZSwgc3VwcG9ydGluZyBlZGl0b3IsIGZpbGUsIGFuZCBtdWx0aS1maWxlIGNvbnRleHQgbWVudXMuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBBcHAgfSBmcm9tICdvYnNpZGlhbic7XG5cbmltcG9ydCB0eXBlIHtcbiAgRWRpdG9yTWVudUV2ZW50SGFuZGxlcixcbiAgRmlsZU1lbnVFdmVudEhhbmRsZXIsXG4gIEZpbGVzTWVudUV2ZW50SGFuZGxlcixcbiAgTWVudUV2ZW50UmVnaXN0cmFyXG59IGZyb20gJy4uL21lbnUtZXZlbnQtcmVnaXN0cmFyLnRzJztcblxuaW1wb3J0IHsgRGlzcG9zYWJsZUNvbXBvbmVudCB9IGZyb20gJy4vZGlzcG9zYWJsZS1jb21wb25lbnQudHMnO1xuXG4vKipcbiAqIHtAbGluayBNZW51RXZlbnRSZWdpc3RyYXJ9IGJhY2tlZCBieSBPYnNpZGlhbidzIHtAbGluayBBcHB9IHdvcmtzcGFjZSBldmVudHMuXG4gKlxuICogRXZlbnQgaGFuZGxlcnMgYXJlIHJlZ2lzdGVyZWQgd2l0aCB0aGUgcHJvdmlkZWQge0BsaW5rIENvbXBvbmVudH0gZm9yIGxpZmVjeWNsZSBtYW5hZ2VtZW50LlxuICovXG5cbi8qKiAqL1xuZXhwb3J0IGNsYXNzIE1lbnVFdmVudFJlZ2lzdHJhckNvbXBvbmVudCBleHRlbmRzIERpc3Bvc2FibGVDb21wb25lbnQgaW1wbGVtZW50cyBNZW51RXZlbnRSZWdpc3RyYXIge1xuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBhcHAtYmFja2VkIG1lbnUgZXZlbnQgcmVnaXN0cmFyLlxuICAgKlxuICAgKiBAcGFyYW0gYXBwIC0gVGhlIE9ic2lkaWFuIGFwcCBpbnN0YW5jZS5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3Rvcihwcml2YXRlIHJlYWRvbmx5IGFwcDogQXBwKSB7XG4gICAgc3VwZXIoKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYSBoYW5kbGVyIGZvciB0aGUgZWRpdG9yIGNvbnRleHQgbWVudSBldmVudC5cbiAgICpcbiAgICogQHBhcmFtIGhhbmRsZXIgLSBUaGUgaGFuZGxlciB0byByZWdpc3Rlci5cbiAgICovXG4gIHB1YmxpYyByZWdpc3RlckVkaXRvck1lbnVFdmVudEhhbmRsZXIoaGFuZGxlcjogRWRpdG9yTWVudUV2ZW50SGFuZGxlcik6IHZvaWQge1xuICAgIHRoaXMucmVnaXN0ZXJFdmVudCh0aGlzLmFwcC53b3Jrc3BhY2Uub24oJ2VkaXRvci1tZW51JywgaGFuZGxlcikpO1xuICB9XG5cbiAgLyoqXG4gICAqIFJlZ2lzdGVycyBhIGhhbmRsZXIgZm9yIHRoZSBzaW5nbGUtZmlsZSBjb250ZXh0IG1lbnUgZXZlbnQuXG4gICAqXG4gICAqIEBwYXJhbSBoYW5kbGVyIC0gVGhlIGhhbmRsZXIgdG8gcmVnaXN0ZXIuXG4gICAqL1xuICBwdWJsaWMgcmVnaXN0ZXJGaWxlTWVudUV2ZW50SGFuZGxlcihoYW5kbGVyOiBGaWxlTWVudUV2ZW50SGFuZGxlcik6IHZvaWQge1xuICAgIHRoaXMucmVnaXN0ZXJFdmVudCh0aGlzLmFwcC53b3Jrc3BhY2Uub24oJ2ZpbGUtbWVudScsIGhhbmRsZXIpKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYSBoYW5kbGVyIGZvciB0aGUgbXVsdGktZmlsZSBjb250ZXh0IG1lbnUgZXZlbnQuXG4gICAqXG4gICAqIEBwYXJhbSBoYW5kbGVyIC0gVGhlIGhhbmRsZXIgdG8gcmVnaXN0ZXIuXG4gICAqL1xuICBwdWJsaWMgcmVnaXN0ZXJGaWxlc01lbnVFdmVudEhhbmRsZXIoaGFuZGxlcjogRmlsZXNNZW51RXZlbnRIYW5kbGVyKTogdm9pZCB7XG4gICAgdGhpcy5yZWdpc3RlckV2ZW50KHRoaXMuYXBwLndvcmtzcGFjZS5vbignZmlsZXMtbWVudScsIGhhbmRsZXIpKTtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFlQSxTQUFTLDJCQUEyQjtBQVM3QixNQUFNLG9DQUFvQyxvQkFBa0Q7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFNMUYsWUFBNkIsS0FBVTtBQUM1QyxVQUFNO0FBRDRCO0FBQUEsRUFFcEM7QUFBQSxFQUZvQztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVM3QiwrQkFBK0IsU0FBdUM7QUFDM0UsU0FBSyxjQUFjLEtBQUssSUFBSSxVQUFVLEdBQUcsZUFBZSxPQUFPLENBQUM7QUFBQSxFQUNsRTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9PLDZCQUE2QixTQUFxQztBQUN2RSxTQUFLLGNBQWMsS0FBSyxJQUFJLFVBQVUsR0FBRyxhQUFhLE9BQU8sQ0FBQztBQUFBLEVBQ2hFO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT08sOEJBQThCLFNBQXNDO0FBQ3pFLFNBQUssY0FBYyxLQUFLLElBQUksVUFBVSxHQUFHLGNBQWMsT0FBTyxDQUFDO0FBQUEsRUFDakU7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/obsidian/components/monkey-around-component.d.mts

@@ -0,0 +1,113 @@
+/**
+ * @file
+ *
+ * Improved type-safe wrapper of {@link https://www.npmjs.com/package/monkey-around} library.
+ */
+import type { ConditionalKeys } from 'type-fest';
+import type { GenericFunction } from '../../function.mjs';
+import { DisposableComponent } from './disposable-component.mjs';
+/**
+ * A type of the factories to apply to the object.
+ *
+ * @typeParam Obj - The object to patch.
+ */
+export type Factories<Obj extends object> = Partial<{
+    [Key in ConditionalKeys<Obj, GenericFunction | undefined>]: WrapperFactory<Extract<Obj[Key], GenericFunction | undefined>>;
+}>;
+/**
+ * Parameters passed to {@link MonkeyAroundComponent#registerMethodPatch}.
+ *
+ * @typeParam Obj - The object to patch.
+ * @typeParam MethodName - The method name to patch.
+ */
+export interface MonkeyAroundComponentRegisterMethodPatchParams<Obj extends object, MethodName extends MethodKeys<Obj>> {
+    /**
+     * The method name to patch.
+     */
+    readonly methodName: MethodName;
+    /**
+     * The object to patch.
+     */
+    readonly obj: Obj;
+    /**
+     * The patch handler function.
+     */
+    readonly patchHandler: PatchHandlerFn<Obj, MethodName>;
+    /**
+     * An optional token to identify the patch.
+     */
+    readonly patchToken?: symbol;
+}
+/**
+ * A patch handler function that intercepts calls to a method on an object.
+ *
+ * @typeParam Obj - The object being patched.
+ * @typeParam K - The method name being patched.
+ */
+export type PatchHandlerFn<Obj extends object, K extends MethodKeys<Obj>> = (params: PatchHandlerParams<Obj, K>) => ReturnType<Extract<Obj[K], GenericFunction>>;
+/**
+ * Parameters passed to a {@link PatchHandlerFn} callback.
+ *
+ * @typeParam Obj - The object being patched.
+ * @typeParam K - The method name being patched.
+ */
+export interface PatchHandlerParams<Obj extends object, K extends MethodKeys<Obj>> {
+    fallback(this: void): ReturnType<Extract<Obj[K], GenericFunction>>;
+    /**
+     * The original arguments of the intercepted call, as a tuple.
+     */
+    readonly originalArgs: Parameters<Extract<Obj[K], GenericFunction>>;
+    /**
+     * The original (unpatched) function. Call via `originalFn.call(originalThis, ...originalArgs)`.
+     */
+    readonly originalMethod: Extract<Obj[K], GenericFunction>;
+    readonly originalMethodBound: OmitThisParameter<Extract<Obj[K], GenericFunction>>;
+    /**
+     * The original `this` context of the intercepted call.
+     */
+    readonly originalThis: Obj;
+}
+type MethodKeys<Obj extends object> = ConditionalKeys<Obj, Function | undefined> & keyof Obj;
+type Uninstaller = () => void;
+type WrapperFactory<T extends Function | undefined> = (next: T) => T;
+/**
+ * A component that manages monkey-patches with lifecycle-bound cleanup.
+ * All patches registered via this component are automatically uninstalled when the component unloads.
+ */
+export declare class MonkeyAroundComponent extends DisposableComponent {
+    /**
+     * Registers a single-method patch using a simplified handler.
+     *
+     * @typeParam Obj - The object to patch.
+     * @typeParam K - The method name to patch.
+     * @param params - The parameters of the patch.
+     */
+    registerMethodPatch<Obj extends object, const MethodName extends MethodKeys<Obj>>(params: MonkeyAroundComponentRegisterMethodPatchParams<Obj, MethodName>): void;
+    /**
+     * Registers a patch using raw factories (advanced API).
+     *
+     * @typeParam Obj - The object to patch.
+     * @param obj - The object to patch.
+     * @param factories - The factories to apply to the object.
+     */
+    registerPatch<Obj extends object>(obj: Obj, factories: Factories<Obj>): void;
+}
+/**
+ * Applies a patch to the object.
+ * Better strongly-typed version of `monkey-around`.
+ *
+ * @typeParam Obj - The object to patch.
+ * @param obj - The object to patch.
+ * @param factories - The factories to apply to the object.
+ * @returns The uninstaller that removes the patch when called.
+ */
+export declare function around<Obj extends object>(obj: Obj, factories: Factories<Obj>): Uninstaller;
+/**
+ * Checks if a function has a specific patch token.
+ *
+ * @param fn - The function to check.
+ * @param patchToken - The patch token to check for.
+ * @returns Whether the function has the patch token.
+ */
+export declare function hasPatchToken(fn: GenericFunction, patchToken: symbol): boolean;
+export {};

package/dist/lib/esm/obsidian/components/monkey-around-component.mjs

@@ -0,0 +1,87 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function initEsm() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  if (globalThis.process) {
+    return;
+  }
+
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  globalThis.process = browserProcess;
+})();
+
+import { around as originalAround } from "monkey-around";
+import { getObsidianDevUtilsState } from "../app.mjs";
+import { DisposableComponent } from "./disposable-component.mjs";
+class MonkeyAroundComponent extends DisposableComponent {
+  /**
+   * Registers a single-method patch using a simplified handler.
+   *
+   * @typeParam Obj - The object to patch.
+   * @typeParam K - The method name to patch.
+   * @param params - The parameters of the patch.
+   */
+  registerMethodPatch(params) {
+    if (params.patchToken) {
+      const originalMethod = params.obj[params.methodName];
+      getMonkeyAroundPatches().set(originalMethod, params.patchToken);
+    }
+    this.registerPatch(params.obj, {
+      [params.methodName]: (originalMethod) => {
+        return patchedMethod;
+        function patchedMethod(...originalArgs) {
+          const originalThis = this;
+          return params.patchHandler({
+            fallback() {
+              return originalMethod.call(originalThis, ...originalArgs);
+            },
+            originalArgs,
+            originalMethod,
+            originalMethodBound: originalMethod.bind(originalThis),
+            originalThis
+          });
+        }
+      }
+    });
+  }
+  /**
+   * Registers a patch using raw factories (advanced API).
+   *
+   * @typeParam Obj - The object to patch.
+   * @param obj - The object to patch.
+   * @param factories - The factories to apply to the object.
+   */
+  registerPatch(obj, factories) {
+    if (!this._loaded) {
+      throw new Error("Cannot register patch on a component that is not loaded.");
+    }
+    const uninstaller = around(obj, factories);
+    this.register(uninstaller);
+  }
+}
+function around(obj, factories) {
+  return originalAround(obj, factories);
+}
+function hasPatchToken(fn, patchToken) {
+  return getMonkeyAroundPatches().get(fn) === patchToken;
+}
+function getMonkeyAroundPatches() {
+  return getObsidianDevUtilsState(null, "monkeyAroundPatches", /* @__PURE__ */ new WeakMap()).value;
+}
+export {
+  MonkeyAroundComponent,
+  around,
+  hasPatchToken
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbXBvbmVudHMvbW9ua2V5LWFyb3VuZC1jb21wb25lbnQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBJbXByb3ZlZCB0eXBlLXNhZmUgd3JhcHBlciBvZiB7QGxpbmsgaHR0cHM6Ly93d3cubnBtanMuY29tL3BhY2thZ2UvbW9ua2V5LWFyb3VuZH0gbGlicmFyeS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IENvbmRpdGlvbmFsS2V5cyB9IGZyb20gJ3R5cGUtZmVzdCc7XG5cbmltcG9ydCB7IGFyb3VuZCBhcyBvcmlnaW5hbEFyb3VuZCB9IGZyb20gJ21vbmtleS1hcm91bmQnO1xuXG5pbXBvcnQgdHlwZSB7IEdlbmVyaWNGdW5jdGlvbiB9IGZyb20gJy4uLy4uL2Z1bmN0aW9uLnRzJztcbmltcG9ydCB0eXBlIHsgR2VuZXJpY09iamVjdCB9IGZyb20gJy4uLy4uL3R5cGUtZ3VhcmRzLnRzJztcblxuaW1wb3J0IHsgZ2V0T2JzaWRpYW5EZXZVdGlsc1N0YXRlIH0gZnJvbSAnLi4vYXBwLnRzJztcbmltcG9ydCB7IERpc3Bvc2FibGVDb21wb25lbnQgfSBmcm9tICcuL2Rpc3Bvc2FibGUtY29tcG9uZW50LnRzJztcblxuLyoqXG4gKiBBIHR5cGUgb2YgdGhlIGZhY3RvcmllcyB0byBhcHBseSB0byB0aGUgb2JqZWN0LlxuICpcbiAqIEB0eXBlUGFyYW0gT2JqIC0gVGhlIG9iamVjdCB0byBwYXRjaC5cbiAqL1xuZXhwb3J0IHR5cGUgRmFjdG9yaWVzPE9iaiBleHRlbmRzIG9iamVjdD4gPSBQYXJ0aWFsPFxuICB7XG4gICAgW0tleSBpbiBDb25kaXRpb25hbEtleXM8T2JqLCBHZW5lcmljRnVuY3Rpb24gfCB1bmRlZmluZWQ+XTogV3JhcHBlckZhY3Rvcnk8RXh0cmFjdDxPYmpbS2V5XSwgR2VuZXJpY0Z1bmN0aW9uIHwgdW5kZWZpbmVkPj47XG4gIH1cbj47XG5cbi8qKlxuICogUGFyYW1ldGVycyBwYXNzZWQgdG8ge0BsaW5rIE1vbmtleUFyb3VuZENvbXBvbmVudCNyZWdpc3Rlck1ldGhvZFBhdGNofS5cbiAqXG4gKiBAdHlwZVBhcmFtIE9iaiAtIFRoZSBvYmplY3QgdG8gcGF0Y2guXG4gKiBAdHlwZVBhcmFtIE1ldGhvZE5hbWUgLSBUaGUgbWV0aG9kIG5hbWUgdG8gcGF0Y2guXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTW9ua2V5QXJvdW5kQ29tcG9uZW50UmVnaXN0ZXJNZXRob2RQYXRjaFBhcmFtczxPYmogZXh0ZW5kcyBvYmplY3QsIE1ldGhvZE5hbWUgZXh0ZW5kcyBNZXRob2RLZXlzPE9iaj4+IHtcbiAgLyoqXG4gICAqIFRoZSBtZXRob2QgbmFtZSB0byBwYXRjaC5cbiAgICovXG4gIHJlYWRvbmx5IG1ldGhvZE5hbWU6IE1ldGhvZE5hbWU7XG5cbiAgLyoqXG4gICAqIFRoZSBvYmplY3QgdG8gcGF0Y2guXG4gICAqL1xuICByZWFkb25seSBvYmo6IE9iajtcblxuICAvKipcbiAgICogVGhlIHBhdGNoIGhhbmRsZXIgZnVuY3Rpb24uXG4gICAqL1xuICByZWFkb25seSBwYXRjaEhhbmRsZXI6IFBhdGNoSGFuZGxlckZuPE9iaiwgTWV0aG9kTmFtZT47XG5cbiAgLyoqXG4gICAqIEFuIG9wdGlvbmFsIHRva2VuIHRvIGlkZW50aWZ5IHRoZSBwYXRjaC5cbiAgICovXG4gIHJlYWRvbmx5IHBhdGNoVG9rZW4/OiBzeW1ib2w7XG59XG5cbi8qKlxuICogQSBwYXRjaCBoYW5kbGVyIGZ1bmN0aW9uIHRoYXQgaW50ZXJjZXB0cyBjYWxscyB0byBhIG1ldGhvZCBvbiBhbiBvYmplY3QuXG4gKlxuICogQHR5cGVQYXJhbSBPYmogLSBUaGUgb2JqZWN0IGJlaW5nIHBhdGNoZWQuXG4gKiBAdHlwZVBhcmFtIEsgLSBUaGUgbWV0aG9kIG5hbWUgYmVpbmcgcGF0Y2hlZC5cbiAqL1xuZXhwb3J0IHR5cGUgUGF0Y2hIYW5kbGVyRm48T2JqIGV4dGVuZHMgb2JqZWN0LCBLIGV4dGVuZHMgTWV0aG9kS2V5czxPYmo+PiA9IChcbiAgcGFyYW1zOiBQYXRjaEhhbmRsZXJQYXJhbXM8T2JqLCBLPlxuKSA9PiBSZXR1cm5UeXBlPEV4dHJhY3Q8T2JqW0tdLCBHZW5lcmljRnVuY3Rpb24+PjtcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIHBhc3NlZCB0byBhIHtAbGluayBQYXRjaEhhbmRsZXJGbn0gY2FsbGJhY2suXG4gKlxuICogQHR5cGVQYXJhbSBPYmogLSBUaGUgb2JqZWN0IGJlaW5nIHBhdGNoZWQuXG4gKiBAdHlwZVBhcmFtIEsgLSBUaGUgbWV0aG9kIG5hbWUgYmVpbmcgcGF0Y2hlZC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBQYXRjaEhhbmRsZXJQYXJhbXM8T2JqIGV4dGVuZHMgb2JqZWN0LCBLIGV4dGVuZHMgTWV0aG9kS2V5czxPYmo+PiB7XG4gIGZhbGxiYWNrKHRoaXM6IHZvaWQpOiBSZXR1cm5UeXBlPEV4dHJhY3Q8T2JqW0tdLCBHZW5lcmljRnVuY3Rpb24+PjtcblxuICAvKipcbiAgICogVGhlIG9yaWdpbmFsIGFyZ3VtZW50cyBvZiB0aGUgaW50ZXJjZXB0ZWQgY2FsbCwgYXMgYSB0dXBsZS5cbiAgICovXG4gIHJlYWRvbmx5IG9yaWdpbmFsQXJnczogUGFyYW1ldGVyczxFeHRyYWN0PE9ialtLXSwgR2VuZXJpY0Z1bmN0aW9uPj47XG5cbiAgLyoqXG4gICAqIFRoZSBvcmlnaW5hbCAodW5wYXRjaGVkKSBmdW5jdGlvbi4gQ2FsbCB2aWEgYG9yaWdpbmFsRm4uY2FsbChvcmlnaW5hbFRoaXMsIC4uLm9yaWdpbmFsQXJncylgLlxuICAgKi9cbiAgcmVhZG9ubHkgb3JpZ2luYWxNZXRob2Q6IEV4dHJhY3Q8T2JqW0tdLCBHZW5lcmljRnVuY3Rpb24+O1xuXG4gIHJlYWRvbmx5IG9yaWdpbmFsTWV0aG9kQm91bmQ6IE9taXRUaGlzUGFyYW1ldGVyPEV4dHJhY3Q8T2JqW0tdLCBHZW5lcmljRnVuY3Rpb24+PjtcblxuICAvKipcbiAgICogVGhlIG9yaWdpbmFsIGB0aGlzYCBjb250ZXh0IG9mIHRoZSBpbnRlcmNlcHRlZCBjYWxsLlxuICAgKi9cbiAgcmVhZG9ubHkgb3JpZ2luYWxUaGlzOiBPYmo7XG59XG5cbi8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBAdHlwZXNjcmlwdC1lc2xpbnQvbm8tdW5zYWZlLWZ1bmN0aW9uLXR5cGUgLS0gV2UgbmVlZCB0byB1c2UgYEZ1bmN0aW9uYCB0eXBlIGFzIGEgZ2VuZXJpYyByZXN0cmljdGlvbi5cbnR5cGUgTWV0aG9kS2V5czxPYmogZXh0ZW5kcyBvYmplY3Q+ID0gQ29uZGl0aW9uYWxLZXlzPE9iaiwgRnVuY3Rpb24gfCB1bmRlZmluZWQ+ICYga2V5b2YgT2JqO1xuXG50eXBlIE9yaWdpbmFsRmFjdG9yaWVzPE9iaiBleHRlbmRzIEdlbmVyaWNPYmplY3Q+ID0gUGFyYW1ldGVyczx0eXBlb2Ygb3JpZ2luYWxBcm91bmQ8T2JqPj5bMV07XG5cbnR5cGUgVW5pbnN0YWxsZXIgPSAoKSA9PiB2b2lkO1xuXG4vLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgQHR5cGVzY3JpcHQtZXNsaW50L25vLXVuc2FmZS1mdW5jdGlvbi10eXBlIC0tIFdlIG5lZWQgdG8gdXNlIGBGdW5jdGlvbmAgdHlwZSBhcyBhIGdlbmVyaWMgcmVzdHJpY3Rpb24uXG50eXBlIFdyYXBwZXJGYWN0b3J5PFQgZXh0ZW5kcyBGdW5jdGlvbiB8IHVuZGVmaW5lZD4gPSAobmV4dDogVCkgPT4gVDtcblxuLyoqXG4gKiBBIGNvbXBvbmVudCB0aGF0IG1hbmFnZXMgbW9ua2V5LXBhdGNoZXMgd2l0aCBsaWZlY3ljbGUtYm91bmQgY2xlYW51cC5cbiAqIEFsbCBwYXRjaGVzIHJlZ2lzdGVyZWQgdmlhIHRoaXMgY29tcG9uZW50IGFyZSBhdXRvbWF0aWNhbGx5IHVuaW5zdGFsbGVkIHdoZW4gdGhlIGNvbXBvbmVudCB1bmxvYWRzLlxuICovXG5leHBvcnQgY2xhc3MgTW9ua2V5QXJvdW5kQ29tcG9uZW50IGV4dGVuZHMgRGlzcG9zYWJsZUNvbXBvbmVudCB7XG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYSBzaW5nbGUtbWV0aG9kIHBhdGNoIHVzaW5nIGEgc2ltcGxpZmllZCBoYW5kbGVyLlxuICAgKlxuICAgKiBAdHlwZVBhcmFtIE9iaiAtIFRoZSBvYmplY3QgdG8gcGF0Y2guXG4gICAqIEB0eXBlUGFyYW0gSyAtIFRoZSBtZXRob2QgbmFtZSB0byBwYXRjaC5cbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIG9mIHRoZSBwYXRjaC5cbiAgICovXG4gIHB1YmxpYyByZWdpc3Rlck1ldGhvZFBhdGNoPE9iaiBleHRlbmRzIG9iamVjdCwgY29uc3QgTWV0aG9kTmFtZSBleHRlbmRzIE1ldGhvZEtleXM8T2JqPj4oXG4gICAgcGFyYW1zOiBNb25rZXlBcm91bmRDb21wb25lbnRSZWdpc3Rlck1ldGhvZFBhdGNoUGFyYW1zPE9iaiwgTWV0aG9kTmFtZT5cbiAgKTogdm9pZCB7XG4gICAgaWYgKHBhcmFtcy5wYXRjaFRva2VuKSB7XG4gICAgICBjb25zdCBvcmlnaW5hbE1ldGhvZCA9IHBhcmFtcy5vYmpbcGFyYW1zLm1ldGhvZE5hbWVdIGFzIEdlbmVyaWNGdW5jdGlvbjtcbiAgICAgIGdldE1vbmtleUFyb3VuZFBhdGNoZXMoKS5zZXQob3JpZ2luYWxNZXRob2QsIHBhcmFtcy5wYXRjaFRva2VuKTtcbiAgICB9XG5cbiAgICB0eXBlIFJhd0ZuID0gRXh0cmFjdDxPYmpbTWV0aG9kTmFtZV0sIEdlbmVyaWNGdW5jdGlvbj47XG4gICAgdHlwZSBGbiA9IEdlbmVyaWNGdW5jdGlvbjxQYXJhbWV0ZXJzPFJhd0ZuPiwgUmV0dXJuVHlwZTxSYXdGbj4+O1xuICAgIHRoaXMucmVnaXN0ZXJQYXRjaChwYXJhbXMub2JqLCB7XG4gICAgICBbcGFyYW1zLm1ldGhvZE5hbWVdOiAob3JpZ2luYWxNZXRob2Q6IEZuKTogRm4gPT4ge1xuICAgICAgICByZXR1cm4gcGF0Y2hlZE1ldGhvZDtcbiAgICAgICAgZnVuY3Rpb24gcGF0Y2hlZE1ldGhvZCh0aGlzOiBPYmosIC4uLm9yaWdpbmFsQXJnczogUGFyYW1ldGVyczxSYXdGbj4pOiBSZXR1cm5UeXBlPFJhd0ZuPiB7XG4gICAgICAgICAgLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIGNvbnNpc3RlbnQtdGhpcywgQHR5cGVzY3JpcHQtZXNsaW50L25vLXRoaXMtYWxpYXMgLS0gV2UgbmVlZCB0byB1c2UgdGhlIGB0aGlzYCBjb250ZXh0LlxuICAgICAgICAgIGNvbnN0IG9yaWdpbmFsVGhpcyA9IHRoaXM7XG4gICAgICAgICAgcmV0dXJuIHBhcmFtcy5wYXRjaEhhbmRsZXIoe1xuICAgICAgICAgICAgZmFsbGJhY2soKSB7XG4gICAgICAgICAgICAgIHJldHVybiBvcmlnaW5hbE1ldGhvZC5jYWxsKG9yaWdpbmFsVGhpcywgLi4ub3JpZ2luYWxBcmdzKTtcbiAgICAgICAgICAgIH0sXG4gICAgICAgICAgICBvcmlnaW5hbEFyZ3MsXG4gICAgICAgICAgICBvcmlnaW5hbE1ldGhvZDogb3JpZ2luYWxNZXRob2QgYXMgUmF3Rm4sXG4gICAgICAgICAgICBvcmlnaW5hbE1ldGhvZEJvdW5kOiBvcmlnaW5hbE1ldGhvZC5iaW5kKG9yaWdpbmFsVGhpcykgYXMgT21pdFRoaXNQYXJhbWV0ZXI8UmF3Rm4+LFxuICAgICAgICAgICAgb3JpZ2luYWxUaGlzXG4gICAgICAgICAgfSk7XG4gICAgICAgIH1cbiAgICAgIH1cbiAgICB9IGFzIEZhY3RvcmllczxPYmo+KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYSBwYXRjaCB1c2luZyByYXcgZmFjdG9yaWVzIChhZHZhbmNlZCBBUEkpLlxuICAgKlxuICAgKiBAdHlwZVBhcmFtIE9iaiAtIFRoZSBvYmplY3QgdG8gcGF0Y2guXG4gICAqIEBwYXJhbSBvYmogLSBUaGUgb2JqZWN0IHRvIHBhdGNoLlxuICAgKiBAcGFyYW0gZmFjdG9yaWVzIC0gVGhlIGZhY3RvcmllcyB0byBhcHBseSB0byB0aGUgb2JqZWN0LlxuICAgKi9cbiAgcHVibGljIHJlZ2lzdGVyUGF0Y2g8T2JqIGV4dGVuZHMgb2JqZWN0PihvYmo6IE9iaiwgZmFjdG9yaWVzOiBGYWN0b3JpZXM8T2JqPik6IHZvaWQge1xuICAgIGlmICghdGhpcy5fbG9hZGVkKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoJ0Nhbm5vdCByZWdpc3RlciBwYXRjaCBvbiBhIGNvbXBvbmVudCB0aGF0IGlzIG5vdCBsb2FkZWQuJyk7XG4gICAgfVxuXG4gICAgY29uc3QgdW5pbnN0YWxsZXIgPSBhcm91bmQob2JqLCBmYWN0b3JpZXMpO1xuICAgIHRoaXMucmVnaXN0ZXIodW5pbnN0YWxsZXIpO1xuICB9XG59XG5cbi8qKlxuICogQXBwbGllcyBhIHBhdGNoIHRvIHRoZSBvYmplY3QuXG4gKiBCZXR0ZXIgc3Ryb25nbHktdHlwZWQgdmVyc2lvbiBvZiBgbW9ua2V5LWFyb3VuZGAuXG4gKlxuICogQHR5cGVQYXJhbSBPYmogLSBUaGUgb2JqZWN0IHRvIHBhdGNoLlxuICogQHBhcmFtIG9iaiAtIFRoZSBvYmplY3QgdG8gcGF0Y2guXG4gKiBAcGFyYW0gZmFjdG9yaWVzIC0gVGhlIGZhY3RvcmllcyB0byBhcHBseSB0byB0aGUgb2JqZWN0LlxuICogQHJldHVybnMgVGhlIHVuaW5zdGFsbGVyIHRoYXQgcmVtb3ZlcyB0aGUgcGF0Y2ggd2hlbiBjYWxsZWQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBhcm91bmQ8T2JqIGV4dGVuZHMgb2JqZWN0PihvYmo6IE9iaiwgZmFjdG9yaWVzOiBGYWN0b3JpZXM8T2JqPik6IFVuaW5zdGFsbGVyIHtcbiAgcmV0dXJuIG9yaWdpbmFsQXJvdW5kKG9iaiBhcyBHZW5lcmljT2JqZWN0LCBmYWN0b3JpZXMgYXMgT3JpZ2luYWxGYWN0b3JpZXM8R2VuZXJpY09iamVjdD4pO1xufVxuXG4vKipcbiAqIENoZWNrcyBpZiBhIGZ1bmN0aW9uIGhhcyBhIHNwZWNpZmljIHBhdGNoIHRva2VuLlxuICpcbiAqIEBwYXJhbSBmbiAtIFRoZSBmdW5jdGlvbiB0byBjaGVjay5cbiAqIEBwYXJhbSBwYXRjaFRva2VuIC0gVGhlIHBhdGNoIHRva2VuIHRvIGNoZWNrIGZvci5cbiAqIEByZXR1cm5zIFdoZXRoZXIgdGhlIGZ1bmN0aW9uIGhhcyB0aGUgcGF0Y2ggdG9rZW4uXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBoYXNQYXRjaFRva2VuKGZuOiBHZW5lcmljRnVuY3Rpb24sIHBhdGNoVG9rZW46IHN5bWJvbCk6IGJvb2xlYW4ge1xuICByZXR1cm4gZ2V0TW9ua2V5QXJvdW5kUGF0Y2hlcygpLmdldChmbikgPT09IHBhdGNoVG9rZW47XG59XG5cbmZ1bmN0aW9uIGdldE1vbmtleUFyb3VuZFBhdGNoZXMoKTogV2Vha01hcDxHZW5lcmljRnVuY3Rpb24sIHN5bWJvbD4ge1xuICByZXR1cm4gZ2V0T2JzaWRpYW5EZXZVdGlsc1N0YXRlKG51bGwsICdtb25rZXlBcm91bmRQYXRjaGVzJywgbmV3IFdlYWtNYXA8R2VuZXJpY0Z1bmN0aW9uLCBzeW1ib2w+KCkpLnZhbHVlO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFRQSxTQUFTLFVBQVUsc0JBQXNCO0FBS3pDLFNBQVMsZ0NBQWdDO0FBQ3pDLFNBQVMsMkJBQTJCO0FBNEY3QixNQUFNLDhCQUE4QixvQkFBb0I7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBUXRELG9CQUNMLFFBQ007QUFDTixRQUFJLE9BQU8sWUFBWTtBQUNyQixZQUFNLGlCQUFpQixPQUFPLElBQUksT0FBTyxVQUFVO0FBQ25ELDZCQUF1QixFQUFFLElBQUksZ0JBQWdCLE9BQU8sVUFBVTtBQUFBLElBQ2hFO0FBSUEsU0FBSyxjQUFjLE9BQU8sS0FBSztBQUFBLE1BQzdCLENBQUMsT0FBTyxVQUFVLEdBQUcsQ0FBQyxtQkFBMkI7QUFDL0MsZUFBTztBQUNQLGlCQUFTLGlCQUE0QixjQUFvRDtBQUV2RixnQkFBTSxlQUFlO0FBQ3JCLGlCQUFPLE9BQU8sYUFBYTtBQUFBLFlBQ3pCLFdBQVc7QUFDVCxxQkFBTyxlQUFlLEtBQUssY0FBYyxHQUFHLFlBQVk7QUFBQSxZQUMxRDtBQUFBLFlBQ0E7QUFBQSxZQUNBO0FBQUEsWUFDQSxxQkFBcUIsZUFBZSxLQUFLLFlBQVk7QUFBQSxZQUNyRDtBQUFBLFVBQ0YsQ0FBQztBQUFBLFFBQ0g7QUFBQSxNQUNGO0FBQUEsSUFDRixDQUFtQjtBQUFBLEVBQ3JCO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVNPLGNBQWtDLEtBQVUsV0FBaUM7QUFDbEYsUUFBSSxDQUFDLEtBQUssU0FBUztBQUNqQixZQUFNLElBQUksTUFBTSwwREFBMEQ7QUFBQSxJQUM1RTtBQUVBLFVBQU0sY0FBYyxPQUFPLEtBQUssU0FBUztBQUN6QyxTQUFLLFNBQVMsV0FBVztBQUFBLEVBQzNCO0FBQ0Y7QUFXTyxTQUFTLE9BQTJCLEtBQVUsV0FBd0M7QUFDM0YsU0FBTyxlQUFlLEtBQXNCLFNBQTZDO0FBQzNGO0FBU08sU0FBUyxjQUFjLElBQXFCLFlBQTZCO0FBQzlFLFNBQU8sdUJBQXVCLEVBQUUsSUFBSSxFQUFFLE1BQU07QUFDOUM7QUFFQSxTQUFTLHlCQUEyRDtBQUNsRSxTQUFPLHlCQUF5QixNQUFNLHVCQUF1QixvQkFBSSxRQUFpQyxDQUFDLEVBQUU7QUFDdkc7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/obsidian/{plugin/components → components}/plugin-context-component.d.mts

@@ -4,7 +4,7 @@
  * Component that initializes the plugin context, debug controller, and library styles.
  */
 import type { App } from 'obsidian';
-import { Component } from 'obsidian';
+import { DisposableComponent } from './disposable-component.mjs';
 interface PluginContextComponentConstructorParams {
     readonly app: App;
     readonly pluginId: string;
@@ -12,7 +12,7 @@ interface PluginContextComponentConstructorParams {
 /**
  * Initializes plugin context (plugin ID, debug controller, library styles) on load.
  */
-export declare class PluginContextComponent extends Component {
+export declare class PluginContextComponent extends DisposableComponent {
     /**
      * The singleton key for the {@link PluginContextComponent} class.
      */

package/dist/lib/esm/obsidian/components/plugin-context-component.mjs

@@ -0,0 +1,61 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function initEsm() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  if (globalThis.process) {
+    return;
+  }
+
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  globalThis.process = browserProcess;
+})();
+
+import {
+  initDebugController,
+  initPluginContext
+} from "../plugin/plugin-context.mjs";
+import { AllWindowsEventComponent } from "./all-windows-event-component.mjs";
+import { DisposableComponent } from "./disposable-component.mjs";
+class PluginContextComponent extends DisposableComponent {
+  /**
+   * The singleton key for the {@link PluginContextComponent} class.
+   */
+  static COMPONENT_KEY = Symbol(PluginContextComponent.name);
+  app;
+  pluginId;
+  /**
+   * Creates a new plugin context component.
+   *
+   * @param params - The constructor parameters.
+   */
+  constructor(params) {
+    super();
+    this.app = params.app;
+    this.pluginId = params.pluginId;
+  }
+  /**
+   * Initializes the plugin context and debug controller.
+   */
+  onload() {
+    super.onload();
+    initPluginContext(this.app, this.pluginId);
+    this.addChild(new AllWindowsEventComponent(this.app)).registerAllWindowsHandler((win) => {
+      initDebugController(win, this);
+    });
+  }
+}
+export {
+  PluginContextComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbXBvbmVudHMvcGx1Z2luLWNvbnRleHQtY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29tcG9uZW50IHRoYXQgaW5pdGlhbGl6ZXMgdGhlIHBsdWdpbiBjb250ZXh0LCBkZWJ1ZyBjb250cm9sbGVyLCBhbmQgbGlicmFyeSBzdHlsZXMuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBBcHAgfSBmcm9tICdvYnNpZGlhbic7XG5cbmltcG9ydCB7XG4gIGluaXREZWJ1Z0NvbnRyb2xsZXIsXG4gIGluaXRQbHVnaW5Db250ZXh0XG59IGZyb20gJy4uL3BsdWdpbi9wbHVnaW4tY29udGV4dC50cyc7XG5pbXBvcnQgeyBBbGxXaW5kb3dzRXZlbnRDb21wb25lbnQgfSBmcm9tICcuL2FsbC13aW5kb3dzLWV2ZW50LWNvbXBvbmVudC50cyc7XG5pbXBvcnQgeyBEaXNwb3NhYmxlQ29tcG9uZW50IH0gZnJvbSAnLi9kaXNwb3NhYmxlLWNvbXBvbmVudC50cyc7XG5cbmludGVyZmFjZSBQbHVnaW5Db250ZXh0Q29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXMge1xuICByZWFkb25seSBhcHA6IEFwcDtcbiAgcmVhZG9ubHkgcGx1Z2luSWQ6IHN0cmluZztcbn1cblxuLyoqXG4gKiBJbml0aWFsaXplcyBwbHVnaW4gY29udGV4dCAocGx1Z2luIElELCBkZWJ1ZyBjb250cm9sbGVyLCBsaWJyYXJ5IHN0eWxlcykgb24gbG9hZC5cbiAqL1xuZXhwb3J0IGNsYXNzIFBsdWdpbkNvbnRleHRDb21wb25lbnQgZXh0ZW5kcyBEaXNwb3NhYmxlQ29tcG9uZW50IHtcbiAgLyoqXG4gICAqIFRoZSBzaW5nbGV0b24ga2V5IGZvciB0aGUge0BsaW5rIFBsdWdpbkNvbnRleHRDb21wb25lbnR9IGNsYXNzLlxuICAgKi9cbiAgcHVibGljIHN0YXRpYyByZWFkb25seSBDT01QT05FTlRfS0VZID0gU3ltYm9sKFBsdWdpbkNvbnRleHRDb21wb25lbnQubmFtZSk7XG4gIHByaXZhdGUgcmVhZG9ubHkgYXBwOiBBcHA7XG4gIHByaXZhdGUgcmVhZG9ubHkgcGx1Z2luSWQ6IHN0cmluZztcblxuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBwbHVnaW4gY29udGV4dCBjb21wb25lbnQuXG4gICAqXG4gICAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgY29uc3RydWN0b3IgcGFyYW1ldGVycy5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3RvcihwYXJhbXM6IFBsdWdpbkNvbnRleHRDb21wb25lbnRDb25zdHJ1Y3RvclBhcmFtcykge1xuICAgIHN1cGVyKCk7XG4gICAgdGhpcy5hcHAgPSBwYXJhbXMuYXBwO1xuICAgIHRoaXMucGx1Z2luSWQgPSBwYXJhbXMucGx1Z2luSWQ7XG4gIH1cblxuICAvKipcbiAgICogSW5pdGlhbGl6ZXMgdGhlIHBsdWdpbiBjb250ZXh0IGFuZCBkZWJ1ZyBjb250cm9sbGVyLlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIG9ubG9hZCgpOiB2b2lkIHtcbiAgICBzdXBlci5vbmxvYWQoKTtcbiAgICBpbml0UGx1Z2luQ29udGV4dCh0aGlzLmFwcCwgdGhpcy5wbHVnaW5JZCk7XG4gICAgdGhpcy5hZGRDaGlsZChuZXcgQWxsV2luZG93c0V2ZW50Q29tcG9uZW50KHRoaXMuYXBwKSkucmVnaXN0ZXJBbGxXaW5kb3dzSGFuZGxlcigod2luKSA9PiB7XG4gICAgICBpbml0RGVidWdDb250cm9sbGVyKHdpbiwgdGhpcyk7XG4gICAgfSk7XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBUUE7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFDUCxTQUFTLGdDQUFnQztBQUN6QyxTQUFTLDJCQUEyQjtBQVU3QixNQUFNLCtCQUErQixvQkFBb0I7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUk5RCxPQUF1QixnQkFBZ0IsT0FBTyx1QkFBdUIsSUFBSTtBQUFBLEVBQ3hEO0FBQUEsRUFDQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9WLFlBQVksUUFBaUQ7QUFDbEUsVUFBTTtBQUNOLFNBQUssTUFBTSxPQUFPO0FBQ2xCLFNBQUssV0FBVyxPQUFPO0FBQUEsRUFDekI7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtnQixTQUFlO0FBQzdCLFVBQU0sT0FBTztBQUNiLHNCQUFrQixLQUFLLEtBQUssS0FBSyxRQUFRO0FBQ3pDLFNBQUssU0FBUyxJQUFJLHlCQUF5QixLQUFLLEdBQUcsQ0FBQyxFQUFFLDBCQUEwQixDQUFDLFFBQVE7QUFDdkYsMEJBQW9CLEtBQUssSUFBSTtBQUFBLElBQy9CLENBQUM7QUFBQSxFQUNIO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/obsidian/{plugin/components → components}/plugin-notice-component.d.mts

@@ -3,11 +3,11 @@
  *
  * Component that manages displaying notices to the user.
  */
-import { Component } from 'obsidian';
+import { DisposableComponent } from './disposable-component.mjs';
 /**
  * Manages showing plugin notices. Automatically hides the previous notice when a new one is shown.
  */
-export declare class PluginNoticeComponent extends Component {
+export declare class PluginNoticeComponent extends DisposableComponent {
     private readonly pluginName;
     /**
      * The singleton key for the {@link PluginNoticeComponent} class.

package/dist/lib/esm/obsidian/components/plugin-notice-component.mjs

@@ -0,0 +1,58 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function initEsm() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  if (globalThis.process) {
+    return;
+  }
+
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  globalThis.process = browserProcess;
+})();
+
+import { Notice } from "obsidian";
+import { DisposableComponent } from "./disposable-component.mjs";
+class PluginNoticeComponent extends DisposableComponent {
+  /**
+   * Creates a new plugin notice component.
+   *
+   * @param pluginName - The plugin name (shown as prefix in notices).
+   */
+  constructor(pluginName) {
+    super();
+    this.pluginName = pluginName;
+  }
+  pluginName;
+  /**
+   * The singleton key for the {@link PluginNoticeComponent} class.
+   */
+  static COMPONENT_KEY = Symbol(PluginNoticeComponent.name);
+  notice;
+  /**
+   * Displays a notice message to the user.
+   *
+   * @param message - The message to display.
+   */
+  showNotice(message) {
+    if (this.notice) {
+      this.notice.hide();
+    }
+    this.notice = new Notice(`${this.pluginName}
+${message}`);
+  }
+}
+export {
+  PluginNoticeComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbXBvbmVudHMvcGx1Z2luLW5vdGljZS1jb21wb25lbnQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBDb21wb25lbnQgdGhhdCBtYW5hZ2VzIGRpc3BsYXlpbmcgbm90aWNlcyB0byB0aGUgdXNlci5cbiAqL1xuXG5pbXBvcnQgeyBOb3RpY2UgfSBmcm9tICdvYnNpZGlhbic7XG5cbmltcG9ydCB7IERpc3Bvc2FibGVDb21wb25lbnQgfSBmcm9tICcuL2Rpc3Bvc2FibGUtY29tcG9uZW50LnRzJztcblxuLyoqXG4gKiBNYW5hZ2VzIHNob3dpbmcgcGx1Z2luIG5vdGljZXMuIEF1dG9tYXRpY2FsbHkgaGlkZXMgdGhlIHByZXZpb3VzIG5vdGljZSB3aGVuIGEgbmV3IG9uZSBpcyBzaG93bi5cbiAqL1xuZXhwb3J0IGNsYXNzIFBsdWdpbk5vdGljZUNvbXBvbmVudCBleHRlbmRzIERpc3Bvc2FibGVDb21wb25lbnQge1xuICAvKipcbiAgICogVGhlIHNpbmdsZXRvbiBrZXkgZm9yIHRoZSB7QGxpbmsgUGx1Z2luTm90aWNlQ29tcG9uZW50fSBjbGFzcy5cbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgcmVhZG9ubHkgQ09NUE9ORU5UX0tFWSA9IFN5bWJvbChQbHVnaW5Ob3RpY2VDb21wb25lbnQubmFtZSk7XG5cbiAgcHJpdmF0ZSBub3RpY2U/OiBOb3RpY2U7XG5cbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgcGx1Z2luIG5vdGljZSBjb21wb25lbnQuXG4gICAqXG4gICAqIEBwYXJhbSBwbHVnaW5OYW1lIC0gVGhlIHBsdWdpbiBuYW1lIChzaG93biBhcyBwcmVmaXggaW4gbm90aWNlcykuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocHJpdmF0ZSByZWFkb25seSBwbHVnaW5OYW1lOiBzdHJpbmcpIHtcbiAgICBzdXBlcigpO1xuICB9XG5cbiAgLyoqXG4gICAqIERpc3BsYXlzIGEgbm90aWNlIG1lc3NhZ2UgdG8gdGhlIHVzZXIuXG4gICAqXG4gICAqIEBwYXJhbSBtZXNzYWdlIC0gVGhlIG1lc3NhZ2UgdG8gZGlzcGxheS5cbiAgICovXG4gIHB1YmxpYyBzaG93Tm90aWNlKG1lc3NhZ2U6IHN0cmluZyk6IHZvaWQge1xuICAgIGlmICh0aGlzLm5vdGljZSkge1xuICAgICAgdGhpcy5ub3RpY2UuaGlkZSgpO1xuICAgIH1cblxuICAgIHRoaXMubm90aWNlID0gbmV3IE5vdGljZShgJHt0aGlzLnBsdWdpbk5hbWV9XFxuJHttZXNzYWdlfWApO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQU1BLFNBQVMsY0FBYztBQUV2QixTQUFTLDJCQUEyQjtBQUs3QixNQUFNLDhCQUE4QixvQkFBb0I7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFhdEQsWUFBNkIsWUFBb0I7QUFDdEQsVUFBTTtBQUQ0QjtBQUFBLEVBRXBDO0FBQUEsRUFGb0M7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVRwQyxPQUF1QixnQkFBZ0IsT0FBTyxzQkFBc0IsSUFBSTtBQUFBLEVBRWhFO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBZ0JELFdBQVcsU0FBdUI7QUFDdkMsUUFBSSxLQUFLLFFBQVE7QUFDZixXQUFLLE9BQU8sS0FBSztBQUFBLElBQ25CO0FBRUEsU0FBSyxTQUFTLElBQUksT0FBTyxHQUFHLEtBQUssVUFBVTtBQUFBLEVBQUssT0FBTyxFQUFFO0FBQUEsRUFDM0Q7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/obsidian/{plugin/components → components}/plugin-settings-component.d.mts

@@ -8,12 +8,12 @@
  * by this component — no separate manager class is needed.
  */
 import type { Promisable, ReadonlyDeep } from 'type-fest';
-import type { AsyncEventRef } from '../../../async-events.mjs';
-import type { Transformer } from '../../../transformers/transformer.mjs';
-import type { GenericObject } from '../../../type-guards.mjs';
-import type { MaybeReturn, StringKeys } from '../../../type.mjs';
-import type { DataHandler } from '../../data-handler.mjs';
-import { AsyncComponentBase } from '../../components/async-component.mjs';
+import type { AsyncEventRef } from '../../async-events.mjs';
+import type { Transformer } from '../../transformers/transformer.mjs';
+import type { GenericObject } from '../../type-guards.mjs';
+import type { MaybeReturn, StringKeys } from '../../type.mjs';
+import type { DataHandler } from '../data-handler.mjs';
+import { AsyncComponentBase } from './async-component.mjs';
 /**
  * A snapshot of plugin settings state, including raw input values, effective (validated) values,
  * and per-property validation messages.
@@ -261,19 +261,4 @@ export declare abstract class PluginSettingsComponentBase<PluginSettings extends
     private setPropertyImpl;
     private settingsToRawRecord;
 }
-/**
- * A no-op settings component for plugins without settings.
- */
-export declare class EmptyPluginSettingsComponent extends PluginSettingsComponentBase<object> {
-    /**
-     * Creates a new empty plugin settings component.
-     */
-    constructor();
-    /**
-     * Creates empty default settings.
-     *
-     * @returns An empty object.
-     */
-    protected createDefaultSettings(): object;
-}
 export {};