@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/esm/components/core-plugin-toggle-component.d.mts

@@ -0,0 +1,102 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @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';
+import type { App } from 'obsidian';
+import type { Promisable } from 'type-fest';
+import { ComponentEx } from './component-ex.mjs';
+/**
+ * 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/esm/components/core-plugin-toggle-component.mjs

@@ -0,0 +1,113 @@
+/*
+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 initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import { invokeAsyncSafely } from "@mnaoumov/typescript-lib/async";
+import { ComponentEx } from "./component-ex.mjs";
+class CorePluginToggleComponent extends 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) {
+      invokeAsyncSafely(handler);
+    }
+  }
+}
+export {
+  CorePluginToggleComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvY29yZS1wbHVnaW4tdG9nZ2xlLWNvbXBvbmVudC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbnRhaW5zIGNsYXNzIHtAbGluayBDb3JlUGx1Z2luVG9nZ2xlQ29tcG9uZW50fSB0aGF0IHJ1bnMgYSBoYW5kbGVyIGVhY2ggdGltZSBhIGNvcmUgT2JzaWRpYW4gcGx1Z2luIGlzXG4gKiBlbmFibGVkIG9yIGRpc2FibGVkLlxuICovXG5cbmltcG9ydCB0eXBlIHsgSW50ZXJuYWxQbHVnaW5OYW1lVHlwZSB9IGZyb20gJ0BvYnNpZGlhbi10eXBpbmdzL29ic2lkaWFuLXB1YmxpYy1sYXRlc3QnO1xuaW1wb3J0IHR5cGUgeyBBcHAgfSBmcm9tICdvYnNpZGlhbic7XG5pbXBvcnQgdHlwZSB7IFByb21pc2FibGUgfSBmcm9tICd0eXBlLWZlc3QnO1xuXG5pbXBvcnQgeyBpbnZva2VBc3luY1NhZmVseSB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9hc3luYyc7XG5cbmltcG9ydCB7IENvbXBvbmVudEV4IH0gZnJvbSAnLi9jb21wb25lbnQtZXgudHMnO1xuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHRoZSB7QGxpbmsgQ29yZVBsdWdpblRvZ2dsZUNvbXBvbmVudH0gY29uc3RydWN0b3IuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ29yZVBsdWdpblRvZ2dsZUNvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2UuXG4gICAqL1xuICByZWFkb25seSBhcHA6IEFwcDtcblxuICAvKipcbiAgICogVGhlIGlkIG9mIHRoZSBjb3JlIHBsdWdpbiB0byB3YXRjaCwgZS5nLiBgSW50ZXJuYWxQbHVnaW5OYW1lLkNhbnZhc2AuXG4gICAqL1xuICByZWFkb25seSBjb3JlUGx1Z2luSWQ6IEludGVybmFsUGx1Z2luTmFtZVR5cGU7XG5cbiAgLyoqXG4gICAqIFJ1bnMgZWFjaCB0aW1lIHRoZSBjb3JlIHBsdWdpbiBnb2VzIGZyb20gZW5hYmxlZCB0byBkaXNhYmxlZC5cbiAgICpcbiAgICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gb3IgYHZvaWRgLiBBIHJlamVjdGlvbiBpcyByZXBvcnRlZCB0aHJvdWdoIHRoZSBsaWJyYXJ5J3MgYXN5bmMgZXJyb3IgaGFuZGxpbmcuXG4gICAqL1xuICByZWFkb25seSBvbkRpc2FibGU/OiAoKSA9PiBQcm9taXNhYmxlPHZvaWQ+O1xuXG4gIC8qKlxuICAgKiBSdW5zIGVhY2ggdGltZSB0aGUgY29yZSBwbHVnaW4gZ29lcyBmcm9tIGRpc2FibGVkIHRvIGVuYWJsZWQsIGFuZCBvbmNlIG9uIGxvYWQgd2hlbiB0aGUgY29yZSBwbHVnaW4gaXNcbiAgICogYWxyZWFkeSBlbmFibGVkIHRoZW4uXG4gICAqXG4gICAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IG9yIGB2b2lkYC4gQSByZWplY3Rpb24gaXMgcmVwb3J0ZWQgdGhyb3VnaCB0aGUgbGlicmFyeSdzIGFzeW5jIGVycm9yIGhhbmRsaW5nLlxuICAgKi9cbiAgcmVhZG9ubHkgb25FbmFibGU/OiAoKSA9PiBQcm9taXNhYmxlPHZvaWQ+O1xuXG4gIC8qKlxuICAgKiBXaGV0aGVyIHtAbGluayBvbkRpc2FibGV9IGFsc28gcnVucyB3aGVuIHRoaXMgY29tcG9uZW50IHVubG9hZHMgd2hpbGUgdGhlIGNvcmUgcGx1Z2luIGlzIGVuYWJsZWQsIHNvIGV2ZXJ5XG4gICAqIHtAbGluayBvbkVuYWJsZX0gaXMgYmFsYW5jZWQgYnkgb25lIHtAbGluayBvbkRpc2FibGV9LiBEZWZhdWx0cyB0byBgZmFsc2VgOiB0aGUgY29yZSBwbHVnaW4gZGlkIG5vdCBjaGFuZ2UsXG4gICAqIHNvIGEgY29uc3VtZXIgdGhhdCByZXB1Ymxpc2hlcyB0cmFuc2l0aW9ucyBtdXN0IG5vdCBzZWUgb25lLlxuICAgKi9cbiAgcmVhZG9ubHkgc2hvdWxkQ2FsbE9uRGlzYWJsZU9uVW5sb2FkPzogYm9vbGVhbjtcbn1cblxuLyoqXG4gKiBSdW5zIHtAbGluayBDb3JlUGx1Z2luVG9nZ2xlQ29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXMub25FbmFibGV9IC8ge0BsaW5rIENvcmVQbHVnaW5Ub2dnbGVDb21wb25lbnRDb25zdHJ1Y3RvclBhcmFtcy5vbkRpc2FibGV9XG4gKiBvbiB0aGUgZWRnZXMgb2YgYSBjb3JlIHBsdWdpbidzIGBlbmFibGVkYCBmbGFnLlxuICpcbiAqIEByZW1hcmtzXG4gKiBPYnNpZGlhbiByYWlzZXMgYGNoYW5nZWAgb24gYGFwcC5pbnRlcm5hbFBsdWdpbnNgIGZvciBldmVyeSBjb3JlIHBsdWdpbiB0b2dnbGUsIHdpdGggbm8gcGF5bG9hZCBuYW1pbmcgd2hpY2hcbiAqIG9uZTogYEludGVybmFsUGx1Z2luLmVuYWJsZSgpYCBzZXRzIGBlbmFibGVkYCBhcyBpdHMgZmlyc3Qgc3RhdGVtZW50IGFuZCByYWlzZXMgYGNoYW5nZWAgYXMgaXRzIGxhc3QsIGFuZFxuICogYGRpc2FibGUoKWAgbWlycm9ycyB0aGF0LiBTbyBhIGhhbmRsZXIgcmVhZGluZyBgZW5hYmxlZGAgc2VlcyB0aGUgcG9zdC10cmFuc2l0aW9uIHZhbHVlLCBidXQgaXQgYWxzbyBydW5zXG4gKiBmb3IgZXZlcnkgT1RIRVIgY29yZSBwbHVnaW4ncyB0b2dnbGUuIFRoaXMgY29tcG9uZW50IGtlZXBzIHRoZSBsYXN0IG9ic2VydmVkIHZhbHVlIGFuZCBjYWxscyBhIGhhbmRsZXIgb25seVxuICogd2hlbiB0aGUgZmxhZyBhY3R1YWxseSBtb3ZlZCwgd2hpY2ggaXMgdGhlIHN0ZXAgYSBoYW5kLXdyaXR0ZW4gc3Vic2NyaXB0aW9uIG1vc3QgZWFzaWx5IGdldHMgd3JvbmcuXG4gKlxuICogSXQgcmVwbGFjZXMgcGF0Y2hpbmcgYG9uVXNlckVuYWJsZWAgLyBgb25Vc2VyRGlzYWJsZWAgb24gdGhlIGNvcmUgcGx1Z2luJ3MgaW5zdGFuY2UgcHJvdG90eXBlLCB3aGljaCBldmVyeVxuICogdmF1bHQgc2hhcmVzLCBhbmQgaXQgYWxzbyBjYXRjaGVzIGEgdG9nZ2xlIHRoYXQgd2FzIG5vdCBkcml2ZW4gYnkgdGhlIHVzZXIsIHdoaWNoIG5laXRoZXIgaG9vayBmaXJlcyBmb3IuXG4gKlxuICogQSBjb3JlIHBsdWdpbiBpZCB0aGlzIE9ic2lkaWFuIHZlcnNpb24gZG9lcyBub3Qga25vdyByZWdpc3RlcnMgbm90aGluZy5cbiAqXG4gKiBIYW5kbGVycyBydW4gc3luY2hyb25vdXNseSB3aGVuIHRoZXkgYXJlIHN5bmNocm9ub3VzLCBzbyBhIGhhbmRsZXIgb2JzZXJ2ZXMgdGhlIHN0YXRlIHJpZ2h0IGFmdGVyIHRoZVxuICogdG9nZ2xlLlxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0c1xuICogdGhpcy5hZGRDaGlsZChuZXcgQ29yZVBsdWdpblRvZ2dsZUNvbXBvbmVudCh7XG4gKiAgIGFwcDogdGhpcy5hcHAsXG4gKiAgIGNvcmVQbHVnaW5JZDogSW50ZXJuYWxQbHVnaW5OYW1lLkNhbnZhcyxcbiAqICAgb25EaXNhYmxlOiAoKSA9PiB7XG4gKiAgICAgdGhpcy5zdG9wSW5kZXhpbmdDYW52YXNlcygpO1xuICogICB9LFxuICogICBvbkVuYWJsZTogKCkgPT4ge1xuICogICAgIHRoaXMuc3RhcnRJbmRleGluZ0NhbnZhc2VzKCk7XG4gKiAgIH0sXG4gKiAgIHNob3VsZENhbGxPbkRpc2FibGVPblVubG9hZDogdHJ1ZVxuICogfSkpO1xuICogYGBgXG4gKi9cbmV4cG9ydCBjbGFzcyBDb3JlUGx1Z2luVG9nZ2xlQ29tcG9uZW50IGV4dGVuZHMgQ29tcG9uZW50RXgge1xuICAvKipcbiAgICogVGhlIE9ic2lkaWFuIGFwcCBpbnN0YW5jZS5cbiAgICovXG4gIHByb3RlY3RlZCByZWFkb25seSBhcHA6IEFwcDtcblxuICAvKipcbiAgICogVGhlIGlkIG9mIHRoZSB3YXRjaGVkIGNvcmUgcGx1Z2luLlxuICAgKi9cbiAgcHJvdGVjdGVkIHJlYWRvbmx5IGNvcmVQbHVnaW5JZDogSW50ZXJuYWxQbHVnaW5OYW1lVHlwZTtcblxuICBwcml2YXRlIGlzQ29yZVBsdWdpbkVuYWJsZWQgPSBmYWxzZTtcbiAgcHJpdmF0ZSByZWFkb25seSBvbkRpc2FibGU6ICgoKSA9PiBQcm9taXNhYmxlPHZvaWQ+KSB8IHVuZGVmaW5lZDtcbiAgcHJpdmF0ZSByZWFkb25seSBvbkVuYWJsZTogKCgpID0+IFByb21pc2FibGU8dm9pZD4pIHwgdW5kZWZpbmVkO1xuICBwcml2YXRlIHJlYWRvbmx5IHNob3VsZENhbGxPbkRpc2FibGVPblVubG9hZDogYm9vbGVhbjtcblxuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBpbnN0YW5jZSBvZiB0aGUge0BsaW5rIENvcmVQbHVnaW5Ub2dnbGVDb21wb25lbnR9IGNsYXNzLlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIGNvbnN0cnVjdG9yIHBhcmFtZXRlcnMuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocGFyYW1zOiBDb3JlUGx1Z2luVG9nZ2xlQ29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXMpIHtcbiAgICBzdXBlcigpO1xuICAgIHRoaXMuYXBwID0gcGFyYW1zLmFwcDtcbiAgICB0aGlzLmNvcmVQbHVnaW5JZCA9IHBhcmFtcy5jb3JlUGx1Z2luSWQ7XG4gICAgdGhpcy5vbkRpc2FibGUgPSBwYXJhbXMub25EaXNhYmxlO1xuICAgIHRoaXMub25FbmFibGUgPSBwYXJhbXMub25FbmFibGU7XG4gICAgdGhpcy5zaG91bGRDYWxsT25EaXNhYmxlT25VbmxvYWQgPSBwYXJhbXMuc2hvdWxkQ2FsbE9uRGlzYWJsZU9uVW5sb2FkID8/IGZhbHNlO1xuICB9XG5cbiAgLyoqXG4gICAqIFN1YnNjcmliZXMgdG8gY29yZSBwbHVnaW4gdG9nZ2xlcywgYW5kIHJ1bnMgdGhlIGVuYWJsZSBoYW5kbGVyIHdoZW4gdGhlIGNvcmUgcGx1Z2luIGlzIGFscmVhZHkgZW5hYmxlZC5cbiAgICovXG4gIHB1YmxpYyBvdmVycmlkZSBvbmxvYWQoKTogdm9pZCB7XG4gICAgY29uc3QgY29yZVBsdWdpbiA9IHRoaXMuYXBwLmludGVybmFsUGx1Z2lucy5nZXRQbHVnaW5CeUlkKHRoaXMuY29yZVBsdWdpbklkKTtcbiAgICBpZiAoIWNvcmVQbHVnaW4pIHtcbiAgICAgIHJldHVybjtcbiAgICB9XG5cbiAgICB0aGlzLmlzQ29yZVBsdWdpbkVuYWJsZWQgPSBjb3JlUGx1Z2luLmVuYWJsZWQ7XG5cbiAgICB0aGlzLnJlZ2lzdGVyRXZlbnQodGhpcy5hcHAuaW50ZXJuYWxQbHVnaW5zLm9uKCdjaGFuZ2UnLCAoKSA9PiB7XG4gICAgICBjb25zdCBpc0NvcmVQbHVnaW5FbmFibGVkID0gY29yZVBsdWdpbi5lbmFibGVkO1xuICAgICAgaWYgKGlzQ29yZVBsdWdpbkVuYWJsZWQgPT09IHRoaXMuaXNDb3JlUGx1Z2luRW5hYmxlZCkge1xuICAgICAgICByZXR1cm47XG4gICAgICB9XG4gICAgICB0aGlzLmlzQ29yZVBsdWdpbkVuYWJsZWQgPSBpc0NvcmVQbHVnaW5FbmFibGVkO1xuICAgICAgdGhpcy5pbnZva2VIYW5kbGVyKGlzQ29yZVBsdWdpbkVuYWJsZWQgPyB0aGlzLm9uRW5hYmxlIDogdGhpcy5vbkRpc2FibGUpO1xuICAgIH0pKTtcblxuICAgIHRoaXMucmVnaXN0ZXIoKCkgPT4ge1xuICAgICAgaWYgKHRoaXMuc2hvdWxkQ2FsbE9uRGlzYWJsZU9uVW5sb2FkICYmIHRoaXMuaXNDb3JlUGx1Z2luRW5hYmxlZCkge1xuICAgICAgICB0aGlzLmludm9rZUhhbmRsZXIodGhpcy5vbkRpc2FibGUpO1xuICAgICAgfVxuICAgIH0pO1xuXG4gICAgaWYgKHRoaXMuaXNDb3JlUGx1Z2luRW5hYmxlZCkge1xuICAgICAgdGhpcy5pbnZva2VIYW5kbGVyKHRoaXMub25FbmFibGUpO1xuICAgIH1cbiAgfVxuXG4gIHByaXZhdGUgaW52b2tlSGFuZGxlcihoYW5kbGVyOiAoKCkgPT4gUHJvbWlzYWJsZTx2b2lkPikgfCB1bmRlZmluZWQpOiB2b2lkIHtcbiAgICBpZiAoaGFuZGxlcikge1xuICAgICAgaW52b2tlQXN5bmNTYWZlbHkoaGFuZGxlcik7XG4gICAgfVxuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBV0EsU0FBUyx5QkFBeUI7QUFFbEMsU0FBUyxtQkFBbUI7QUF5RXJCLE1BQU0sa0NBQWtDLFlBQVk7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUl0QztBQUFBO0FBQUE7QUFBQTtBQUFBLEVBS0E7QUFBQSxFQUVYLHNCQUFzQjtBQUFBLEVBQ2I7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9WLFlBQVksUUFBb0Q7QUFDckUsVUFBTTtBQUNOLFNBQUssTUFBTSxPQUFPO0FBQ2xCLFNBQUssZUFBZSxPQUFPO0FBQzNCLFNBQUssWUFBWSxPQUFPO0FBQ3hCLFNBQUssV0FBVyxPQUFPO0FBQ3ZCLFNBQUssOEJBQThCLE9BQU8sK0JBQStCO0FBQUEsRUFDM0U7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtnQixTQUFlO0FBQzdCLFVBQU0sYUFBYSxLQUFLLElBQUksZ0JBQWdCLGNBQWMsS0FBSyxZQUFZO0FBQzNFLFFBQUksQ0FBQyxZQUFZO0FBQ2Y7QUFBQSxJQUNGO0FBRUEsU0FBSyxzQkFBc0IsV0FBVztBQUV0QyxTQUFLLGNBQWMsS0FBSyxJQUFJLGdCQUFnQixHQUFHLFVBQVUsTUFBTTtBQUM3RCxZQUFNLHNCQUFzQixXQUFXO0FBQ3ZDLFVBQUksd0JBQXdCLEtBQUsscUJBQXFCO0FBQ3BEO0FBQUEsTUFDRjtBQUNBLFdBQUssc0JBQXNCO0FBQzNCLFdBQUssY0FBYyxzQkFBc0IsS0FBSyxXQUFXLEtBQUssU0FBUztBQUFBLElBQ3pFLENBQUMsQ0FBQztBQUVGLFNBQUssU0FBUyxNQUFNO0FBQ2xCLFVBQUksS0FBSywrQkFBK0IsS0FBSyxxQkFBcUI7QUFDaEUsYUFBSyxjQUFjLEtBQUssU0FBUztBQUFBLE1BQ25DO0FBQUEsSUFDRixDQUFDO0FBRUQsUUFBSSxLQUFLLHFCQUFxQjtBQUM1QixXQUFLLGNBQWMsS0FBSyxRQUFRO0FBQUEsSUFDbEM7QUFBQSxFQUNGO0FBQUEsRUFFUSxjQUFjLFNBQXFEO0FBQ3pFLFFBQUksU0FBUztBQUNYLHdCQUFrQixPQUFPO0FBQUEsSUFDM0I7QUFBQSxFQUNGO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/components/disposable-component.d.mts

@@ -0,0 +1,24 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Disposable component base class and utilities for `using` declarations.
+ */
+import type { DisposableEx } from '@mnaoumov/typescript-lib/disposable';
+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 {};

package/dist/lib/esm/components/disposable-component.mjs

@@ -0,0 +1,65 @@
+/*
+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 initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import { Component } from "obsidian";
+function asDisposableComponent(component) {
+  const disposableEx = component;
+  const symbolDispose = disposableEx[Symbol.dispose] ?? (() => {
+    component.unload();
+  });
+  disposableEx[Symbol.dispose] = symbolDispose;
+  disposableEx.dispose = () => {
+    symbolDispose();
+  };
+  return disposableEx;
+}
+export {
+  asDisposableComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvZGlzcG9zYWJsZS1jb21wb25lbnQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBEaXNwb3NhYmxlIGNvbXBvbmVudCBiYXNlIGNsYXNzIGFuZCB1dGlsaXRpZXMgZm9yIGB1c2luZ2AgZGVjbGFyYXRpb25zLlxuICovXG5cbmltcG9ydCB0eXBlIHsgRGlzcG9zYWJsZUV4IH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL2Rpc3Bvc2FibGUnO1xuXG5pbXBvcnQgeyBDb21wb25lbnQgfSBmcm9tICdvYnNpZGlhbic7XG5cbnR5cGUgRGlzcG9zYWJsZUNvbXBvbmVudFdyYXBwZXI8VENvbXBvbmVudCBleHRlbmRzIENvbXBvbmVudD4gPSBEaXNwb3NhYmxlRXggJiBUQ29tcG9uZW50O1xuXG4vKipcbiAqIENvbnZlcnQgY29tcG9uZW50IHRvIGEge0BsaW5rIERpc3Bvc2FibGVFeH0gaW50ZXJmYWNlIGJ5IGFkZGluZyBgU3ltYm9sLmRpc3Bvc2VgIGFuZCBhIGNvbnZlbmllbmNlXG4gKiB7QGxpbmsgRGlzcG9zYWJsZUV4LmRpc3Bvc2V9IG1ldGhvZCB0aGF0IHVubG9hZHMgdGhlIGNvbXBvbmVudCB3aGVuIGRpc3Bvc2VkLlxuICpcbiAqIEFuIGV4aXN0aW5nIGBTeW1ib2wuZGlzcG9zZWAgaXMgcHJlc2VydmVkOyB0aGUgY29udmVuaWVuY2Uge0BsaW5rIERpc3Bvc2FibGVFeC5kaXNwb3NlfSBtZXRob2QgYWx3YXlzXG4gKiBkZWxlZ2F0ZXMgdG8gaXQuIFRoZSBwYXNzZWQgY29tcG9uZW50IGlzIG11dGF0ZWQgaW4gcGxhY2UgYW5kIHJldHVybmVkLCBzbyB0aGUgY2FsbCBpcyBpZGVtcG90ZW50LlxuICpcbiAqIEB0eXBlUGFyYW0gVENvbXBvbmVudCAtIFRoZSB0eXBlIG9mIGNvbXBvbmVudCB0byB3cmFwLCBjb25zdHJhaW5lZCB0byBleHRlbmQgQ29tcG9uZW50LlxuICpcbiAqIEBwYXJhbSBjb21wb25lbnQgLSBUaGUgY29tcG9uZW50IGluc3RhbmNlIHRvIHdyYXAgd2l0aCBEaXNwb3NhYmxlIHN1cHBvcnQuXG4gKiBAcmV0dXJucyBUaGUgY29tcG9uZW50IGNhc3QgdG8gYERpc3Bvc2FibGVDb21wb25lbnRXcmFwcGVyYCB3aXRoIGBTeW1ib2wuZGlzcG9zZWAgYW5kIGBkaXNwb3NlYFxuICogICBhdHRhY2hlZC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGFzRGlzcG9zYWJsZUNvbXBvbmVudDxUQ29tcG9uZW50IGV4dGVuZHMgQ29tcG9uZW50Pihjb21wb25lbnQ6IFRDb21wb25lbnQpOiBEaXNwb3NhYmxlQ29tcG9uZW50V3JhcHBlcjxUQ29tcG9uZW50PiB7XG4gIGNvbnN0IGRpc3Bvc2FibGVFeCA9IGNvbXBvbmVudCBhcyBQYXJ0aWFsPERpc3Bvc2FibGVFeD47XG4gIGNvbnN0IHN5bWJvbERpc3Bvc2U6ICgpID0+IHZvaWQgPSBkaXNwb3NhYmxlRXhbU3ltYm9sLmRpc3Bvc2VdID8/ICgoKTogdm9pZCA9PiB7XG4gICAgY29tcG9uZW50LnVubG9hZCgpO1xuICB9KTtcbiAgZGlzcG9zYWJsZUV4W1N5bWJvbC5kaXNwb3NlXSA9IHN5bWJvbERpc3Bvc2U7XG4gIGRpc3Bvc2FibGVFeC5kaXNwb3NlID0gKCk6IHZvaWQgPT4ge1xuICAgIHN5bWJvbERpc3Bvc2UoKTtcbiAgfTtcbiAgcmV0dXJuIGRpc3Bvc2FibGVFeCBhcyBEaXNwb3NhYmxlQ29tcG9uZW50V3JhcHBlcjxUQ29tcG9uZW50Pjtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFRQSxTQUFTLGlCQUFpQjtBQWlCbkIsU0FBUyxzQkFBb0QsV0FBK0Q7QUFDakksUUFBTSxlQUFlO0FBQ3JCLFFBQU0sZ0JBQTRCLGFBQWEsT0FBTyxPQUFPLE1BQU0sTUFBWTtBQUM3RSxjQUFVLE9BQU87QUFBQSxFQUNuQjtBQUNBLGVBQWEsT0FBTyxPQUFPLElBQUk7QUFDL0IsZUFBYSxVQUFVLE1BQVk7QUFDakMsa0JBQWM7QUFBQSxFQUNoQjtBQUNBLFNBQU87QUFDVDsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/components/embed-extensions-component.d.mts

@@ -0,0 +1,38 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Contains class {@link EmbedExtensionsComponent} that registers embed extensions.
+ */
+import type { EmbedCreator } from '@obsidian-typings/obsidian-public-latest';
+import type { App } from 'obsidian';
+import { ComponentEx } from './component-ex.mjs';
+/**
+ * A component that registers and unregisters embed extensions.
+ *
+ * @remarks
+ * This component is useful for plugins that want to register custom embed types for specific file extensions.
+ * It ensures that the extensions are registered when the component is loaded and unregistered when the component is unloaded.
+ */
+export declare class EmbedExtensionsComponent extends ComponentEx {
+    protected readonly app: App;
+    /**
+     * Creates a new instance of the {@link EmbedExtensionsComponent} class.
+     *
+     * @param app - The Obsidian app instance.
+     */
+    constructor(app: App);
+    /**
+     * Registers the specified file extensions with the given embed type in the Obsidian app.
+     * The extensions will be automatically unregistered when the component is unloaded.
+     *
+     * @param extensions - An array of file extensions to register.
+     * @param embedCreator - The embed creator function to associate with the extensions.
+     *
+     * @example
+     * ```ts
+     * component.registerExtensions(['ext1', 'ext2'], (context, file, subpath) => new MyEmbedComponent(context, file, subpath));
+     * ```
+     */
+    registerExtensions(extensions: string[], embedCreator: EmbedCreator): void;
+}

package/dist/lib/esm/components/embed-extensions-component.mjs

@@ -0,0 +1,85 @@
+/*
+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 initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import { ComponentEx } from "./component-ex.mjs";
+class EmbedExtensionsComponent extends ComponentEx {
+  /**
+   * Creates a new instance of the {@link EmbedExtensionsComponent} class.
+   *
+   * @param app - The Obsidian app instance.
+   */
+  constructor(app) {
+    super();
+    this.app = app;
+  }
+  app;
+  /**
+   * Registers the specified file extensions with the given embed type in the Obsidian app.
+   * The extensions will be automatically unregistered when the component is unloaded.
+   *
+   * @param extensions - An array of file extensions to register.
+   * @param embedCreator - The embed creator function to associate with the extensions.
+   *
+   * @example
+   * ```ts
+   * component.registerExtensions(['ext1', 'ext2'], (context, file, subpath) => new MyEmbedComponent(context, file, subpath));
+   * ```
+   */
+  registerExtensions(extensions, embedCreator) {
+    this.ensureLoaded();
+    this.app.embedRegistry.registerExtensions(extensions, embedCreator);
+    this.register(() => {
+      this.app.embedRegistry.unregisterExtensions(extensions);
+    });
+  }
+}
+export {
+  EmbedExtensionsComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvZW1iZWQtZXh0ZW5zaW9ucy1jb21wb25lbnQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBDb250YWlucyBjbGFzcyB7QGxpbmsgRW1iZWRFeHRlbnNpb25zQ29tcG9uZW50fSB0aGF0IHJlZ2lzdGVycyBlbWJlZCBleHRlbnNpb25zLlxuICovXG5cbmltcG9ydCB0eXBlIHsgRW1iZWRDcmVhdG9yIH0gZnJvbSAnQG9ic2lkaWFuLXR5cGluZ3Mvb2JzaWRpYW4tcHVibGljLWxhdGVzdCc7XG5pbXBvcnQgdHlwZSB7IEFwcCB9IGZyb20gJ29ic2lkaWFuJztcblxuaW1wb3J0IHsgQ29tcG9uZW50RXggfSBmcm9tICcuL2NvbXBvbmVudC1leC50cyc7XG5cbi8qKlxuICogQSBjb21wb25lbnQgdGhhdCByZWdpc3RlcnMgYW5kIHVucmVnaXN0ZXJzIGVtYmVkIGV4dGVuc2lvbnMuXG4gKlxuICogQHJlbWFya3NcbiAqIFRoaXMgY29tcG9uZW50IGlzIHVzZWZ1bCBmb3IgcGx1Z2lucyB0aGF0IHdhbnQgdG8gcmVnaXN0ZXIgY3VzdG9tIGVtYmVkIHR5cGVzIGZvciBzcGVjaWZpYyBmaWxlIGV4dGVuc2lvbnMuXG4gKiBJdCBlbnN1cmVzIHRoYXQgdGhlIGV4dGVuc2lvbnMgYXJlIHJlZ2lzdGVyZWQgd2hlbiB0aGUgY29tcG9uZW50IGlzIGxvYWRlZCBhbmQgdW5yZWdpc3RlcmVkIHdoZW4gdGhlIGNvbXBvbmVudCBpcyB1bmxvYWRlZC5cbiAqL1xuZXhwb3J0IGNsYXNzIEVtYmVkRXh0ZW5zaW9uc0NvbXBvbmVudCBleHRlbmRzIENvbXBvbmVudEV4IHtcbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgaW5zdGFuY2Ugb2YgdGhlIHtAbGluayBFbWJlZEV4dGVuc2lvbnNDb21wb25lbnR9IGNsYXNzLlxuICAgKlxuICAgKiBAcGFyYW0gYXBwIC0gVGhlIE9ic2lkaWFuIGFwcCBpbnN0YW5jZS5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3Rvcihwcm90ZWN0ZWQgcmVhZG9ubHkgYXBwOiBBcHApIHtcbiAgICBzdXBlcigpO1xuICB9XG5cbiAgLyoqXG4gICAqIFJlZ2lzdGVycyB0aGUgc3BlY2lmaWVkIGZpbGUgZXh0ZW5zaW9ucyB3aXRoIHRoZSBnaXZlbiBlbWJlZCB0eXBlIGluIHRoZSBPYnNpZGlhbiBhcHAuXG4gICAqIFRoZSBleHRlbnNpb25zIHdpbGwgYmUgYXV0b21hdGljYWxseSB1bnJlZ2lzdGVyZWQgd2hlbiB0aGUgY29tcG9uZW50IGlzIHVubG9hZGVkLlxuICAgKlxuICAgKiBAcGFyYW0gZXh0ZW5zaW9ucyAtIEFuIGFycmF5IG9mIGZpbGUgZXh0ZW5zaW9ucyB0byByZWdpc3Rlci5cbiAgICogQHBhcmFtIGVtYmVkQ3JlYXRvciAtIFRoZSBlbWJlZCBjcmVhdG9yIGZ1bmN0aW9uIHRvIGFzc29jaWF0ZSB3aXRoIHRoZSBleHRlbnNpb25zLlxuICAgKlxuICAgKiBAZXhhbXBsZVxuICAgKiBgYGB0c1xuICAgKiBjb21wb25lbnQucmVnaXN0ZXJFeHRlbnNpb25zKFsnZXh0MScsICdleHQyJ10sIChjb250ZXh0LCBmaWxlLCBzdWJwYXRoKSA9PiBuZXcgTXlFbWJlZENvbXBvbmVudChjb250ZXh0LCBmaWxlLCBzdWJwYXRoKSk7XG4gICAqIGBgYFxuICAgKi9cbiAgcHVibGljIHJlZ2lzdGVyRXh0ZW5zaW9ucyhleHRlbnNpb25zOiBzdHJpbmdbXSwgZW1iZWRDcmVhdG9yOiBFbWJlZENyZWF0b3IpOiB2b2lkIHtcbiAgICB0aGlzLmVuc3VyZUxvYWRlZCgpO1xuXG4gICAgdGhpcy5hcHAuZW1iZWRSZWdpc3RyeS5yZWdpc3RlckV4dGVuc2lvbnMoZXh0ZW5zaW9ucywgZW1iZWRDcmVhdG9yKTtcbiAgICB0aGlzLnJlZ2lzdGVyKCgpID0+IHtcbiAgICAgIHRoaXMuYXBwLmVtYmVkUmVnaXN0cnkudW5yZWdpc3RlckV4dGVuc2lvbnMoZXh0ZW5zaW9ucyk7XG4gICAgfSk7XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFTQSxTQUFTLG1CQUFtQjtBQVNyQixNQUFNLGlDQUFpQyxZQUFZO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBTWpELFlBQStCLEtBQVU7QUFDOUMsVUFBTTtBQUQ4QjtBQUFBLEVBRXRDO0FBQUEsRUFGc0M7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQWdCL0IsbUJBQW1CLFlBQXNCLGNBQWtDO0FBQ2hGLFNBQUssYUFBYTtBQUVsQixTQUFLLElBQUksY0FBYyxtQkFBbUIsWUFBWSxZQUFZO0FBQ2xFLFNBQUssU0FBUyxNQUFNO0FBQ2xCLFdBQUssSUFBSSxjQUFjLHFCQUFxQixVQUFVO0FBQUEsSUFDeEQsQ0FBQztBQUFBLEVBQ0g7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/components/generate-markdown-link-default-params-component.d.mts

@@ -0,0 +1,42 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Component that registers a function providing default params for generated markdown links while it is loaded.
+ */
+import type { GenerateMarkdownLinkParams } from '../link.mjs';
+import { ComponentEx } from './component-ex.mjs';
+/**
+ * Constructor params for {@link GenerateMarkdownLinkDefaultParamsComponent}.
+ */
+export interface GenerateMarkdownLinkDefaultParamsComponentConstructorParams {
+    /**
+     * Returns the default {@link GenerateMarkdownLinkParams} to merge into every generated markdown link while this
+     * component is loaded.
+     *
+     * @returns The default params.
+     */
+    readonly getDefaultParams: () => Partial<GenerateMarkdownLinkParams>;
+}
+/**
+ * Registers a function that provides default {@link GenerateMarkdownLinkParams} for the duration of its load.
+ *
+ * On load the function is appended to the shared list consulted when generating a markdown link; on unload it is
+ * removed. Later registrations take precedence over the built-in defaults but never over explicitly passed params.
+ */
+export declare class GenerateMarkdownLinkDefaultParamsComponent extends ComponentEx {
+    /**
+     * Returns the default {@link GenerateMarkdownLinkParams} registered while this component is loaded.
+     */
+    protected readonly getDefaultParams: () => Partial<GenerateMarkdownLinkParams>;
+    /**
+     * Creates a new component.
+     *
+     * @param params - The constructor params.
+     */
+    constructor(params: GenerateMarkdownLinkDefaultParamsComponentConstructorParams);
+    /**
+     * Registers the default-params function and schedules its removal on unload.
+     */
+    onload(): void;
+}

package/dist/lib/esm/components/generate-markdown-link-default-params-component.mjs

@@ -0,0 +1,81 @@
+/*
+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 initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import { getGenerateMarkdownLinkDefaultParamsFns } from "../link.mjs";
+import { ComponentEx } from "./component-ex.mjs";
+class GenerateMarkdownLinkDefaultParamsComponent extends ComponentEx {
+  /**
+   * Returns the default {@link GenerateMarkdownLinkParams} registered while this component is loaded.
+   */
+  getDefaultParams;
+  /**
+   * Creates a new component.
+   *
+   * @param params - The constructor params.
+   */
+  constructor(params) {
+    super();
+    this.getDefaultParams = params.getDefaultParams;
+  }
+  /**
+   * Registers the default-params function and schedules its removal on unload.
+   */
+  onload() {
+    super.onload();
+    const fns = getGenerateMarkdownLinkDefaultParamsFns();
+    fns.push(this.getDefaultParams);
+    this.register(() => {
+      fns.remove(this.getDefaultParams);
+    });
+  }
+}
+export {
+  GenerateMarkdownLinkDefaultParamsComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvZ2VuZXJhdGUtbWFya2Rvd24tbGluay1kZWZhdWx0LXBhcmFtcy1jb21wb25lbnQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBDb21wb25lbnQgdGhhdCByZWdpc3RlcnMgYSBmdW5jdGlvbiBwcm92aWRpbmcgZGVmYXVsdCBwYXJhbXMgZm9yIGdlbmVyYXRlZCBtYXJrZG93biBsaW5rcyB3aGlsZSBpdCBpcyBsb2FkZWQuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBHZW5lcmF0ZU1hcmtkb3duTGlua1BhcmFtcyB9IGZyb20gJy4uL2xpbmsudHMnO1xuXG5pbXBvcnQgeyBnZXRHZW5lcmF0ZU1hcmtkb3duTGlua0RlZmF1bHRQYXJhbXNGbnMgfSBmcm9tICcuLi9saW5rLnRzJztcbmltcG9ydCB7IENvbXBvbmVudEV4IH0gZnJvbSAnLi9jb21wb25lbnQtZXgudHMnO1xuXG4vKipcbiAqIENvbnN0cnVjdG9yIHBhcmFtcyBmb3Ige0BsaW5rIEdlbmVyYXRlTWFya2Rvd25MaW5rRGVmYXVsdFBhcmFtc0NvbXBvbmVudH0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgR2VuZXJhdGVNYXJrZG93bkxpbmtEZWZhdWx0UGFyYW1zQ29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXMge1xuICAvKipcbiAgICogUmV0dXJucyB0aGUgZGVmYXVsdCB7QGxpbmsgR2VuZXJhdGVNYXJrZG93bkxpbmtQYXJhbXN9IHRvIG1lcmdlIGludG8gZXZlcnkgZ2VuZXJhdGVkIG1hcmtkb3duIGxpbmsgd2hpbGUgdGhpc1xuICAgKiBjb21wb25lbnQgaXMgbG9hZGVkLlxuICAgKlxuICAgKiBAcmV0dXJucyBUaGUgZGVmYXVsdCBwYXJhbXMuXG4gICAqL1xuICByZWFkb25seSBnZXREZWZhdWx0UGFyYW1zOiAoKSA9PiBQYXJ0aWFsPEdlbmVyYXRlTWFya2Rvd25MaW5rUGFyYW1zPjtcbn1cblxuLyoqXG4gKiBSZWdpc3RlcnMgYSBmdW5jdGlvbiB0aGF0IHByb3ZpZGVzIGRlZmF1bHQge0BsaW5rIEdlbmVyYXRlTWFya2Rvd25MaW5rUGFyYW1zfSBmb3IgdGhlIGR1cmF0aW9uIG9mIGl0cyBsb2FkLlxuICpcbiAqIE9uIGxvYWQgdGhlIGZ1bmN0aW9uIGlzIGFwcGVuZGVkIHRvIHRoZSBzaGFyZWQgbGlzdCBjb25zdWx0ZWQgd2hlbiBnZW5lcmF0aW5nIGEgbWFya2Rvd24gbGluazsgb24gdW5sb2FkIGl0IGlzXG4gKiByZW1vdmVkLiBMYXRlciByZWdpc3RyYXRpb25zIHRha2UgcHJlY2VkZW5jZSBvdmVyIHRoZSBidWlsdC1pbiBkZWZhdWx0cyBidXQgbmV2ZXIgb3ZlciBleHBsaWNpdGx5IHBhc3NlZCBwYXJhbXMuXG4gKi9cbmV4cG9ydCBjbGFzcyBHZW5lcmF0ZU1hcmtkb3duTGlua0RlZmF1bHRQYXJhbXNDb21wb25lbnQgZXh0ZW5kcyBDb21wb25lbnRFeCB7XG4gIC8qKlxuICAgKiBSZXR1cm5zIHRoZSBkZWZhdWx0IHtAbGluayBHZW5lcmF0ZU1hcmtkb3duTGlua1BhcmFtc30gcmVnaXN0ZXJlZCB3aGlsZSB0aGlzIGNvbXBvbmVudCBpcyBsb2FkZWQuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgZ2V0RGVmYXVsdFBhcmFtczogKCkgPT4gUGFydGlhbDxHZW5lcmF0ZU1hcmtkb3duTGlua1BhcmFtcz47XG5cbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgY29tcG9uZW50LlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIGNvbnN0cnVjdG9yIHBhcmFtcy5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3RvcihwYXJhbXM6IEdlbmVyYXRlTWFya2Rvd25MaW5rRGVmYXVsdFBhcmFtc0NvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zKSB7XG4gICAgc3VwZXIoKTtcblxuICAgIHRoaXMuZ2V0RGVmYXVsdFBhcmFtcyA9IHBhcmFtcy5nZXREZWZhdWx0UGFyYW1zO1xuICB9XG5cbiAgLyoqXG4gICAqIFJlZ2lzdGVycyB0aGUgZGVmYXVsdC1wYXJhbXMgZnVuY3Rpb24gYW5kIHNjaGVkdWxlcyBpdHMgcmVtb3ZhbCBvbiB1bmxvYWQuXG4gICAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgb25sb2FkKCk6IHZvaWQge1xuICAgIHN1cGVyLm9ubG9hZCgpO1xuXG4gICAgY29uc3QgZm5zID0gZ2V0R2VuZXJhdGVNYXJrZG93bkxpbmtEZWZhdWx0UGFyYW1zRm5zKCk7XG4gICAgZm5zLnB1c2godGhpcy5nZXREZWZhdWx0UGFyYW1zKTtcbiAgICB0aGlzLnJlZ2lzdGVyKCgpID0+IHtcbiAgICAgIGZucy5yZW1vdmUodGhpcy5nZXREZWZhdWx0UGFyYW1zKTtcbiAgICB9KTtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQVFBLFNBQVMsK0NBQStDO0FBQ3hELFNBQVMsbUJBQW1CO0FBcUJyQixNQUFNLG1EQUFtRCxZQUFZO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFJdkQ7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFPWixZQUFZLFFBQXFFO0FBQ3RGLFVBQU07QUFFTixTQUFLLG1CQUFtQixPQUFPO0FBQUEsRUFDakM7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtnQixTQUFlO0FBQzdCLFVBQU0sT0FBTztBQUViLFVBQU0sTUFBTSx3Q0FBd0M7QUFDcEQsUUFBSSxLQUFLLEtBQUssZ0JBQWdCO0FBQzlCLFNBQUssU0FBUyxNQUFNO0FBQ2xCLFVBQUksT0FBTyxLQUFLLGdCQUFnQjtBQUFBLElBQ2xDLENBQUM7QUFBQSxFQUNIO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/components/index.d.mts

@@ -0,0 +1,30 @@
+/// <reference path="../library.d.mts" />
+export * as 'abort-signal-component' from './abort-signal-component.mjs';
+export * as 'all-windows-event-component' from './all-windows-event-component.mjs';
+export * as 'async-error-handler-component' from './async-error-handler-component.mjs';
+export * as 'async-events-component' from './async-events-component.mjs';
+export * as 'case-insensitive-file-index-component' from './case-insensitive-file-index-component.mjs';
+export * as 'component-ex' from './component-ex.mjs';
+export * as 'console-debug-component' from './console-debug-component.mjs';
+export * as 'core-plugin-toggle-component' from './core-plugin-toggle-component.mjs';
+export * as 'disposable-component' from './disposable-component.mjs';
+export * as 'embed-extensions-component' from './embed-extensions-component.mjs';
+export * as 'generate-markdown-link-default-params-component' from './generate-markdown-link-default-params-component.mjs';
+export * as 'layout-ready-component' from './layout-ready-component.mjs';
+export * as 'menu-event-registrar-component' from './menu-event-registrar-component.mjs';
+export * as 'monkey-around-component' from './monkey-around-component.mjs';
+export * as 'notebook-navigator-menu-event-registrar-component' from './notebook-navigator-menu-event-registrar-component.mjs';
+export * as 'plugin-context-component' from './plugin-context-component.mjs';
+export * as 'plugin-gate-component' from './plugin-gate-component.mjs';
+export * as 'plugin-notice-component' from './plugin-notice-component.mjs';
+export * as 'plugin-settings-component' from './plugin-settings-component.mjs';
+export * as 'plugin-settings-tab-component' from './plugin-settings-tab-component.mjs';
+export * as 'plugin-suggestion-component' from './plugin-suggestion-component.mjs';
+export * as 'pointer-position-component' from './pointer-position-component.mjs';
+export * as 'registry-component' from './registry-component.mjs';
+export * as 'release-notes-component' from './release-notes-component.mjs';
+export * as 'rename-delete-handler-component' from './rename-delete-handler-component.mjs';
+export * as 'rmdir-guard-component' from './rmdir-guard-component.mjs';
+export * as 'settings-migration-component' from './settings-migration-component.mjs';
+export * as 'syntax-highlighting-component' from './syntax-highlighting-component.mjs';
+export * as 'templates-language-component' from './templates-language-component.mjs';