obsidian-dev-utils 67.0.0 → 69.0.0

package/dist/lib/cjs/obsidian/components/plugin-settings-component.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../../library.d.cts" />
 /**
  * @file
  *
@@ -8,12 +9,13 @@
  * by this component — no separate manager class is needed.
  */
 import type { Constructor, Promisable, ReadonlyDeep } from 'type-fest';
-import type { AsyncEventRef } from '../../async-events.cjs';
+import type { AsyncEventRef, AsyncEventSource } from '../../async-events.cjs';
 import type { Transformer } from '../../transformers/transformer.cjs';
 import type { GenericObject } from '../../type-guards.cjs';
 import type { MaybeReturn, StringKeys } from '../../type.cjs';
 import type { DataHandler } from '../data-handler.cjs';
-import { AsyncComponent } from './async-component.cjs';
+import type { PluginEventSource } from '../plugin/plugin.cjs';
+import { ComponentEx } from './component-ex.cjs';
 /**
  * Constructor parameters for {@link PluginSettingsComponentBase}.
  *
@@ -24,6 +26,10 @@ export interface PluginSettingsComponentBaseConstructorParams<PluginSettings> {
      * The data handler for the plugin.
      */
     readonly dataHandler: DataHandler;
+    /**
+     * The plugin events.
+     */
+    readonly pluginEventSource: PluginEventSource;
     /**
      * The plugin settings class.
      */
@@ -68,6 +74,17 @@ export type ReadonlyPluginSettingsState<PluginSettings extends object> = Readonl
  * @typeParam PropertyName - The property name.
  */
 export type SettingsValidator<PluginSettings extends object, PropertyName extends StringKeys<PluginSettings> = StringKeys<PluginSettings>> = (value: PluginSettings[PropertyName], settings: PluginSettings) => Promisable<MaybeReturn<string>>;
+interface PluginSettingsComponentBaseEventMap<PluginSettings extends object> {
+    loadSettings: [
+        loadedState: ReadonlyPluginSettingsState<PluginSettings>,
+        isInitialLoad: boolean
+    ];
+    saveSettings: [
+        newState: ReadonlyPluginSettingsState<PluginSettings>,
+        oldState: ReadonlyPluginSettingsState<PluginSettings>,
+        context: unknown
+    ];
+}
 type PropertyNames<PluginSettings extends object> = StringKeys<PluginSettings>;
 type ValidationResult<PluginSettings extends object> = Partial<Record<StringKeys<PluginSettings>, string>>;
 /**
@@ -78,11 +95,7 @@ type ValidationResult<PluginSettings extends object> = Partial<Record<StringKeys
  *
  * @typeParam PluginSettings - The plugin settings type.
  */
-export declare class PluginSettingsComponentBase<PluginSettings extends object> extends AsyncComponent {
-    /**
-     * Component key for singleton replacement via {@link PluginBase.addChild}.
-     */
-    static readonly COMPONENT_KEY: unique symbol;
+export declare class PluginSettingsComponentBase<PluginSettings extends object> extends ComponentEx implements AsyncEventSource<PluginSettingsComponentBaseEventMap<PluginSettings>> {
     /**
      * Gets the readonly default settings.
      *
@@ -106,6 +119,7 @@ export declare class PluginSettingsComponentBase<PluginSettings extends object>
     private readonly dataHandler;
     private lastSavedState;
     private readonly legacySettingsConverters;
+    private readonly pluginEventSource;
     private readonly pluginSettingsClass;
     private readonly propertyNames;
     private readonly validators;
@@ -147,23 +161,44 @@ export declare class PluginSettingsComponentBase<PluginSettings extends object>
      */
     loadFromFile(isInitialLoad: boolean): Promise<void>;
     /**
-     * Subscribes to the `loadSettings` event.
+     * Remove an event listener.
+     *
+     * @typeParam EventName - The name of the event.
+     * @typeParam Args - The types of the arguments the event callback accepts.
+     * @param name - The name of the event.
+     * @param callback - The callback to remove.
+     */
+    off<EventName extends keyof PluginSettingsComponentBaseEventMap<PluginSettings>, Args extends EventName extends keyof PluginSettingsComponentBaseEventMap<PluginSettings> ? PluginSettingsComponentBaseEventMap<PluginSettings>[EventName] : unknown[]>(name: EventName, callback: (...args: Args) => Promisable<void>): void;
+    /**
+     * Remove an event listener by reference.
+     *
+     * @param eventRef - The reference to the event listener.
+     */
+    offref(eventRef: AsyncEventRef): void;
+    /**
+     * Add an event listener.
      *
-     * @param name - Always `loadSettings`.
-     * @param callback - The callback.
-     * @param thisArg - The `this` context.
+     * @typeParam EventName - The name of the event.
+     * @typeParam Args - The types of the arguments the event callback accepts.
+     * @param name - The name of the event.
+     * @param callback - The callback to call when the event is triggered.
+     * @param thisArg - The context passed as `this` to the `callback`.
      * @returns A reference to the event listener.
      */
-    on(name: 'loadSettings', callback: (loadedState: ReadonlyPluginSettingsState<PluginSettings>, isInitialLoad: boolean) => Promisable<void>, thisArg?: unknown): AsyncEventRef;
+    on<EventName extends keyof PluginSettingsComponentBaseEventMap<PluginSettings>, Args extends EventName extends keyof PluginSettingsComponentBaseEventMap<PluginSettings> ? PluginSettingsComponentBaseEventMap<PluginSettings>[EventName] : unknown[]>(name: EventName, callback: (...args: Args) => Promisable<void>, thisArg?: unknown): AsyncEventRef;
     /**
-     * Subscribes to the `saveSettings` event.
+     * Trigger an event, executing all the listeners in order even if some of them throw an error.
+     *
+     * Add an event listener that will be called only once.
      *
-     * @param name - Always `saveSettings`.
-     * @param callback - The callback.
-     * @param thisArg - The `this` context.
+     * @typeParam EventName - The name of the event.
+     * @typeParam Args - The types of the arguments the event callback accepts.
+     * @param name - The name of the event.
+     * @param callback - The callback to call when the event is triggered.
+     * @param thisArg - The context passed as `this` to the `callback`.
      * @returns A reference to the event listener.
      */
-    on(name: 'saveSettings', callback: (newState: ReadonlyPluginSettingsState<PluginSettings>, oldState: ReadonlyPluginSettingsState<PluginSettings>, context: unknown) => Promisable<void>, thisArg?: unknown): AsyncEventRef;
+    once<EventName extends keyof PluginSettingsComponentBaseEventMap<PluginSettings>, Args extends EventName extends keyof PluginSettingsComponentBaseEventMap<PluginSettings> ? PluginSettingsComponentBaseEventMap<PluginSettings>[EventName] : unknown[]>(name: EventName, callback: (...args: Args) => Promisable<void>, thisArg?: unknown): AsyncEventRef;
     /**
      * Called when the external settings change.
      *
@@ -173,7 +208,7 @@ export declare class PluginSettingsComponentBase<PluginSettings extends object>
     /**
      * Loads settings from file and registers event handlers.
      */
-    onload(): Promise<void>;
+    onloadAsync(): Promise<void>;
     /**
      * Registers a legacy settings converter.
      *
@@ -185,6 +220,7 @@ export declare class PluginSettingsComponentBase<PluginSettings extends object>
     /**
      * Registers a validator for a property.
      *
+     * @typeParam PropertyName - The name of the settings property.
      * @param propertyName - The name of the property.
      * @param validator - The validator.
      */

package/dist/lib/cjs/obsidian/components/plugin-settings-tab-component.cjs

@@ -129,8 +129,8 @@ __export(plugin_settings_tab_component_exports, {
 });
 module.exports = __toCommonJS(plugin_settings_tab_component_exports);
 var import_obsidian = require('obsidian');
-var import_disposable_component = require('./disposable-component.cjs');
-class PluginSettingsTabComponent extends import_disposable_component.DisposableComponent {
+var import_component_ex = require('./component-ex.cjs');
+class PluginSettingsTabComponent extends import_component_ex.ComponentEx {
   plugin;
   pluginSettingsTab;
   /**
@@ -154,4 +154,4 @@ class PluginSettingsTabComponent extends import_disposable_component.DisposableC
 0 && (module.exports = {
   PluginSettingsTabComponent
 });
-//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbXBvbmVudHMvcGx1Z2luLXNldHRpbmdzLXRhYi1jb21wb25lbnQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBDb21wb25lbnQgdGhhdCByZWdpc3RlcnMgYSBwbHVnaW4gc2V0dGluZ3MgdGFiIHdpdGggT2JzaWRpYW4uXG4gKiBBbHNvIHJlZ2lzdGVycyBhbiBcIk9wZW4gU2V0dGluZ3NcIiBjb21tYW5kIGF1dG9tYXRpY2FsbHkuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBQbHVnaW4gfSBmcm9tICdvYnNpZGlhbic7XG5cbmltcG9ydCB7IFBsdWdpblNldHRpbmdUYWIgfSBmcm9tICdvYnNpZGlhbic7XG5cbmltcG9ydCB7IERpc3Bvc2FibGVDb21wb25lbnQgfSBmcm9tICcuL2Rpc3Bvc2FibGUtY29tcG9uZW50LnRzJztcblxuaW50ZXJmYWNlIFBsdWdpblNldHRpbmdzVGFiQ29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXMge1xuICByZWFkb25seSBwbHVnaW46IFBsdWdpbjtcbiAgcmVhZG9ubHkgcGx1Z2luU2V0dGluZ3NUYWI6IFBsdWdpblNldHRpbmdUYWI7XG59XG5cbi8qKlxuICogV3JhcHMgYSB7QGxpbmsgUGx1Z2luU2V0dGluZ1RhYn0gYW5kIHJlZ2lzdGVycyBpdCB3aXRoIE9ic2lkaWFuIG9uIGxvYWQuXG4gKiBBbHNvIHJlZ2lzdGVycyBhbiBcIk9wZW4gU2V0dGluZ3NcIiBjb21tYW5kIHRvIG9wZW4gdGhlIHNldHRpbmdzIHRhYiBmcm9tIHRoZSBjb21tYW5kIHBhbGV0dGUuXG4gKi9cbmV4cG9ydCBjbGFzcyBQbHVnaW5TZXR0aW5nc1RhYkNvbXBvbmVudCBleHRlbmRzIERpc3Bvc2FibGVDb21wb25lbnQge1xuICBwcml2YXRlIHJlYWRvbmx5IHBsdWdpbjogUGx1Z2luO1xuICBwcml2YXRlIHJlYWRvbmx5IHBsdWdpblNldHRpbmdzVGFiOiBQbHVnaW5TZXR0aW5nVGFiO1xuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IHBsdWdpbiBzZXR0aW5ncyB0YWIgY29tcG9uZW50LlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBsdWdpbiBzZXR0aW5ncyB0YWIgY29tcG9uZW50IGNvbnN0cnVjdG9yIHBhcmFtZXRlcnMuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocGFyYW1zOiBQbHVnaW5TZXR0aW5nc1RhYkNvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zKSB7XG4gICAgc3VwZXIoKTtcbiAgICB0aGlzLnBsdWdpbiA9IHBhcmFtcy5wbHVnaW47XG4gICAgdGhpcy5wbHVnaW5TZXR0aW5nc1RhYiA9IHBhcmFtcy5wbHVnaW5TZXR0aW5nc1RhYjtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgdGhlIHNldHRpbmdzIHRhYiBhbmQgYW4gXCJPcGVuIFNldHRpbmdzXCIgY29tbWFuZCB3aXRoIE9ic2lkaWFuLlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIG9ubG9hZCgpOiB2b2lkIHtcbiAgICB0aGlzLnBsdWdpbi5hZGRTZXR0aW5nVGFiKHRoaXMucGx1Z2luU2V0dGluZ3NUYWIpO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFTQSxzQkFBaUM7QUFFakMsa0NBQW9DO0FBVzdCLE1BQU0sbUNBQW1DLGdEQUFvQjtBQUFBLEVBQ2pEO0FBQUEsRUFDQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9WLFlBQVksUUFBcUQ7QUFDdEUsVUFBTTtBQUNOLFNBQUssU0FBUyxPQUFPO0FBQ3JCLFNBQUssb0JBQW9CLE9BQU87QUFBQSxFQUNsQztBQUFBO0FBQUE7QUFBQTtBQUFBLEVBS2dCLFNBQWU7QUFDN0IsU0FBSyxPQUFPLGNBQWMsS0FBSyxpQkFBaUI7QUFBQSxFQUNsRDtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbXBvbmVudHMvcGx1Z2luLXNldHRpbmdzLXRhYi1jb21wb25lbnQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBDb21wb25lbnQgdGhhdCByZWdpc3RlcnMgYSBwbHVnaW4gc2V0dGluZ3MgdGFiIHdpdGggT2JzaWRpYW4uXG4gKiBBbHNvIHJlZ2lzdGVycyBhbiBcIk9wZW4gU2V0dGluZ3NcIiBjb21tYW5kIGF1dG9tYXRpY2FsbHkuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBQbHVnaW4gfSBmcm9tICdvYnNpZGlhbic7XG5cbmltcG9ydCB7IFBsdWdpblNldHRpbmdUYWIgfSBmcm9tICdvYnNpZGlhbic7XG5cbmltcG9ydCB7IENvbXBvbmVudEV4IH0gZnJvbSAnLi9jb21wb25lbnQtZXgudHMnO1xuXG5pbnRlcmZhY2UgUGx1Z2luU2V0dGluZ3NUYWJDb21wb25lbnRDb25zdHJ1Y3RvclBhcmFtcyB7XG4gIHJlYWRvbmx5IHBsdWdpbjogUGx1Z2luO1xuICByZWFkb25seSBwbHVnaW5TZXR0aW5nc1RhYjogUGx1Z2luU2V0dGluZ1RhYjtcbn1cblxuLyoqXG4gKiBXcmFwcyBhIHtAbGluayBQbHVnaW5TZXR0aW5nVGFifSBhbmQgcmVnaXN0ZXJzIGl0IHdpdGggT2JzaWRpYW4gb24gbG9hZC5cbiAqIEFsc28gcmVnaXN0ZXJzIGFuIFwiT3BlbiBTZXR0aW5nc1wiIGNvbW1hbmQgdG8gb3BlbiB0aGUgc2V0dGluZ3MgdGFiIGZyb20gdGhlIGNvbW1hbmQgcGFsZXR0ZS5cbiAqL1xuZXhwb3J0IGNsYXNzIFBsdWdpblNldHRpbmdzVGFiQ29tcG9uZW50IGV4dGVuZHMgQ29tcG9uZW50RXgge1xuICBwcml2YXRlIHJlYWRvbmx5IHBsdWdpbjogUGx1Z2luO1xuICBwcml2YXRlIHJlYWRvbmx5IHBsdWdpblNldHRpbmdzVGFiOiBQbHVnaW5TZXR0aW5nVGFiO1xuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IHBsdWdpbiBzZXR0aW5ncyB0YWIgY29tcG9uZW50LlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBsdWdpbiBzZXR0aW5ncyB0YWIgY29tcG9uZW50IGNvbnN0cnVjdG9yIHBhcmFtZXRlcnMuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocGFyYW1zOiBQbHVnaW5TZXR0aW5nc1RhYkNvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zKSB7XG4gICAgc3VwZXIoKTtcbiAgICB0aGlzLnBsdWdpbiA9IHBhcmFtcy5wbHVnaW47XG4gICAgdGhpcy5wbHVnaW5TZXR0aW5nc1RhYiA9IHBhcmFtcy5wbHVnaW5TZXR0aW5nc1RhYjtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgdGhlIHNldHRpbmdzIHRhYiBhbmQgYW4gXCJPcGVuIFNldHRpbmdzXCIgY29tbWFuZCB3aXRoIE9ic2lkaWFuLlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIG9ubG9hZCgpOiB2b2lkIHtcbiAgICB0aGlzLnBsdWdpbi5hZGRTZXR0aW5nVGFiKHRoaXMucGx1Z2luU2V0dGluZ3NUYWIpO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFTQSxzQkFBaUM7QUFFakMsMEJBQTRCO0FBV3JCLE1BQU0sbUNBQW1DLGdDQUFZO0FBQUEsRUFDekM7QUFBQSxFQUNBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT1YsWUFBWSxRQUFxRDtBQUN0RSxVQUFNO0FBQ04sU0FBSyxTQUFTLE9BQU87QUFDckIsU0FBSyxvQkFBb0IsT0FBTztBQUFBLEVBQ2xDO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFLZ0IsU0FBZTtBQUM3QixTQUFLLE9BQU8sY0FBYyxLQUFLLGlCQUFpQjtBQUFBLEVBQ2xEO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/cjs/obsidian/components/plugin-settings-tab-component.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../../library.d.cts" />
 /**
  * @file
  *
@@ -6,7 +7,7 @@
  */
 import type { Plugin } from 'obsidian';
 import { PluginSettingTab } from 'obsidian';
-import { DisposableComponent } from './disposable-component.cjs';
+import { ComponentEx } from './component-ex.cjs';
 interface PluginSettingsTabComponentConstructorParams {
     readonly plugin: Plugin;
     readonly pluginSettingsTab: PluginSettingTab;
@@ -15,7 +16,7 @@ interface PluginSettingsTabComponentConstructorParams {
  * Wraps a {@link PluginSettingTab} and registers it with Obsidian on load.
  * Also registers an "Open Settings" command to open the settings tab from the command palette.
  */
-export declare class PluginSettingsTabComponent extends DisposableComponent {
+export declare class PluginSettingsTabComponent extends ComponentEx {
     private readonly plugin;
     private readonly pluginSettingsTab;
     /**

package/dist/lib/cjs/obsidian/components/registry-component.cjs

@@ -0,0 +1,180 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function initCjs() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  const globalThisRecord = globalThis;
+  globalThisRecord['__name'] ??= name;
+  const originalRequire = require;
+  if (originalRequire && !originalRequire.__isPatched) {
+    // 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
+      }
+    );
+  }
+
+  const newFuncs = {
+    __extractDefault() {
+      return extractDefault;
+    },
+    process() {
+      const browserProcess = {
+        browser: true,
+        cwd() {
+          return '/';
+        },
+        env: {},
+        platform: 'android'
+      };
+      return browserProcess;
+    }
+  };
+
+  for (const key of Object.keys(newFuncs)) {
+    globalThisRecord[key] ??= newFuncs[key]?.();
+  }
+
+  function name(obj) {
+    return obj;
+  }
+
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+
+  const OBSIDIAN_BUILT_IN_MODULE_NAMES = [
+  'obsidian',
+  '@codemirror/autocomplete',
+  '@codemirror/collab',
+  '@codemirror/commands',
+  '@codemirror/language',
+  '@codemirror/lint',
+  '@codemirror/search',
+  '@codemirror/state',
+  '@codemirror/text',
+  '@codemirror/view',
+  '@lezer/common',
+  '@lezer/lr',
+  '@lezer/highlight'];
+
+
+  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = [
+  '@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.includes(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.includes(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.`);
+        // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+        return globalThis.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 registry_component_exports = {};
+__export(registry_component_exports, {
+  RegistryComponent: () => RegistryComponent
+});
+module.exports = __toCommonJS(registry_component_exports);
+var import_type_guards = require('../../type-guards.cjs');
+var import_component_ex = require('./component-ex.cjs');
+class RegistryComponent extends import_component_ex.ComponentEx {
+  /**
+   * Get the single child of the given type.
+   *
+   * @typeParam TComponent - The type of component to get.
+   * @param componentClass - The class of the component to get.
+   * @returns The single registered child of the given type.
+   */
+  getChild(componentClass) {
+    const child = this.getChildOrNull(componentClass);
+    if (child) {
+      return child;
+    }
+    throw new Error(`No instance of ${componentClass.name} registered`);
+  }
+  /**
+   * Get the single child of the given type.
+   *
+   * @typeParam TComponent - The type of component to get.
+   * @param componentClass - The class of the component to get.
+   * @returns The single registered child of the given type, or `null` if none are registered.
+   */
+  getChildOrNull(componentClass) {
+    const children = this.getChildren(componentClass);
+    if (children.length === 0) {
+      return null;
+    }
+    if (children.length === 1) {
+      return (0, import_type_guards.ensureNonNullable)(children[0]);
+    }
+    throw new Error(`Multiple instances of ${componentClass.name} registered`);
+  }
+  /**
+   * Get all children of the given type.
+   *
+   * @typeParam TComponent - The type of component to get.
+   * @param componentClass - The class of the component to get.
+   * @returns All registered children of the given type.
+   */
+  getChildren(componentClass) {
+    return this._children.filter((child) => child instanceof componentClass);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RegistryComponent
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbXBvbmVudHMvcmVnaXN0cnktY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICoge0BsaW5rIFJlZ2lzdHJ5Q29tcG9uZW50fS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IENvbnN0cnVjdG9yIH0gZnJvbSAndHlwZS1mZXN0JztcblxuaW1wb3J0IHsgZW5zdXJlTm9uTnVsbGFibGUgfSBmcm9tICcuLi8uLi90eXBlLWd1YXJkcy50cyc7XG5pbXBvcnQgeyBDb21wb25lbnRFeCB9IGZyb20gJy4vY29tcG9uZW50LWV4LnRzJztcblxuLyoqXG4gKiBBIGNvbXBvbmVudCB0aGF0IGtlZXBzIHJlZ2lzdHJ5IG9mIGl0cyBjaGlsZHJlbi5cbiAqL1xuZXhwb3J0IGNsYXNzIFJlZ2lzdHJ5Q29tcG9uZW50IGV4dGVuZHMgQ29tcG9uZW50RXgge1xuICAvKipcbiAgICogR2V0IHRoZSBzaW5nbGUgY2hpbGQgb2YgdGhlIGdpdmVuIHR5cGUuXG4gICAqXG4gICAqIEB0eXBlUGFyYW0gVENvbXBvbmVudCAtIFRoZSB0eXBlIG9mIGNvbXBvbmVudCB0byBnZXQuXG4gICAqIEBwYXJhbSBjb21wb25lbnRDbGFzcyAtIFRoZSBjbGFzcyBvZiB0aGUgY29tcG9uZW50IHRvIGdldC5cbiAgICogQHJldHVybnMgVGhlIHNpbmdsZSByZWdpc3RlcmVkIGNoaWxkIG9mIHRoZSBnaXZlbiB0eXBlLlxuICAgKi9cbiAgcHVibGljIGdldENoaWxkPFRDb21wb25lbnQ+KGNvbXBvbmVudENsYXNzOiBDb25zdHJ1Y3RvcjxUQ29tcG9uZW50Pik6IFRDb21wb25lbnQge1xuICAgIGNvbnN0IGNoaWxkID0gdGhpcy5nZXRDaGlsZE9yTnVsbChjb21wb25lbnRDbGFzcyk7XG4gICAgaWYgKGNoaWxkKSB7XG4gICAgICByZXR1cm4gY2hpbGQ7XG4gICAgfVxuXG4gICAgdGhyb3cgbmV3IEVycm9yKGBObyBpbnN0YW5jZSBvZiAke2NvbXBvbmVudENsYXNzLm5hbWV9IHJlZ2lzdGVyZWRgKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXQgdGhlIHNpbmdsZSBjaGlsZCBvZiB0aGUgZ2l2ZW4gdHlwZS5cbiAgICpcbiAgICogQHR5cGVQYXJhbSBUQ29tcG9uZW50IC0gVGhlIHR5cGUgb2YgY29tcG9uZW50IHRvIGdldC5cbiAgICogQHBhcmFtIGNvbXBvbmVudENsYXNzIC0gVGhlIGNsYXNzIG9mIHRoZSBjb21wb25lbnQgdG8gZ2V0LlxuICAgKiBAcmV0dXJucyBUaGUgc2luZ2xlIHJlZ2lzdGVyZWQgY2hpbGQgb2YgdGhlIGdpdmVuIHR5cGUsIG9yIGBudWxsYCBpZiBub25lIGFyZSByZWdpc3RlcmVkLlxuICAgKi9cbiAgcHVibGljIGdldENoaWxkT3JOdWxsPFRDb21wb25lbnQ+KGNvbXBvbmVudENsYXNzOiBDb25zdHJ1Y3RvcjxUQ29tcG9uZW50Pik6IG51bGwgfCBUQ29tcG9uZW50IHtcbiAgICBjb25zdCBjaGlsZHJlbiA9IHRoaXMuZ2V0Q2hpbGRyZW4oY29tcG9uZW50Q2xhc3MpO1xuICAgIGlmIChjaGlsZHJlbi5sZW5ndGggPT09IDApIHtcbiAgICAgIHJldHVybiBudWxsO1xuICAgIH1cblxuICAgIGlmIChjaGlsZHJlbi5sZW5ndGggPT09IDEpIHtcbiAgICAgIHJldHVybiBlbnN1cmVOb25OdWxsYWJsZShjaGlsZHJlblswXSk7XG4gICAgfVxuXG4gICAgdGhyb3cgbmV3IEVycm9yKGBNdWx0aXBsZSBpbnN0YW5jZXMgb2YgJHtjb21wb25lbnRDbGFzcy5uYW1lfSByZWdpc3RlcmVkYCk7XG4gIH1cblxuICAvKipcbiAgICogR2V0IGFsbCBjaGlsZHJlbiBvZiB0aGUgZ2l2ZW4gdHlwZS5cbiAgICpcbiAgICogQHR5cGVQYXJhbSBUQ29tcG9uZW50IC0gVGhlIHR5cGUgb2YgY29tcG9uZW50IHRvIGdldC5cbiAgICogQHBhcmFtIGNvbXBvbmVudENsYXNzIC0gVGhlIGNsYXNzIG9mIHRoZSBjb21wb25lbnQgdG8gZ2V0LlxuICAgKiBAcmV0dXJucyBBbGwgcmVnaXN0ZXJlZCBjaGlsZHJlbiBvZiB0aGUgZ2l2ZW4gdHlwZS5cbiAgICovXG4gIHB1YmxpYyBnZXRDaGlsZHJlbjxUQ29tcG9uZW50Pihjb21wb25lbnRDbGFzczogQ29uc3RydWN0b3I8VENvbXBvbmVudD4pOiBUQ29tcG9uZW50W10ge1xuICAgIHJldHVybiB0aGlzLl9jaGlsZHJlbi5maWx0ZXIoKGNoaWxkKSA9PiBjaGlsZCBpbnN0YW5jZW9mIGNvbXBvbmVudENsYXNzKSBhcyBUQ29tcG9uZW50W107XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQVFBLHlCQUFrQztBQUNsQywwQkFBNEI7QUFLckIsTUFBTSwwQkFBMEIsZ0NBQVk7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBUTFDLFNBQXFCLGdCQUFxRDtBQUMvRSxVQUFNLFFBQVEsS0FBSyxlQUFlLGNBQWM7QUFDaEQsUUFBSSxPQUFPO0FBQ1QsYUFBTztBQUFBLElBQ1Q7QUFFQSxVQUFNLElBQUksTUFBTSxrQkFBa0IsZUFBZSxJQUFJLGFBQWE7QUFBQSxFQUNwRTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFTTyxlQUEyQixnQkFBNEQ7QUFDNUYsVUFBTSxXQUFXLEtBQUssWUFBWSxjQUFjO0FBQ2hELFFBQUksU0FBUyxXQUFXLEdBQUc7QUFDekIsYUFBTztBQUFBLElBQ1Q7QUFFQSxRQUFJLFNBQVMsV0FBVyxHQUFHO0FBQ3pCLGlCQUFPLHNDQUFrQixTQUFTLENBQUMsQ0FBQztBQUFBLElBQ3RDO0FBRUEsVUFBTSxJQUFJLE1BQU0seUJBQXlCLGVBQWUsSUFBSSxhQUFhO0FBQUEsRUFDM0U7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBU08sWUFBd0IsZ0JBQXVEO0FBQ3BGLFdBQU8sS0FBSyxVQUFVLE9BQU8sQ0FBQyxVQUFVLGlCQUFpQixjQUFjO0FBQUEsRUFDekU7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/cjs/obsidian/components/registry-component.d.cts

@@ -0,0 +1,37 @@
+/// <reference path="../../library.d.cts" />
+/**
+ * @file
+ *
+ * {@link RegistryComponent}.
+ */
+import type { Constructor } from 'type-fest';
+import { ComponentEx } from './component-ex.cjs';
+/**
+ * A component that keeps registry of its children.
+ */
+export declare class RegistryComponent extends ComponentEx {
+    /**
+     * Get the single child of the given type.
+     *
+     * @typeParam TComponent - The type of component to get.
+     * @param componentClass - The class of the component to get.
+     * @returns The single registered child of the given type.
+     */
+    getChild<TComponent>(componentClass: Constructor<TComponent>): TComponent;
+    /**
+     * Get the single child of the given type.
+     *
+     * @typeParam TComponent - The type of component to get.
+     * @param componentClass - The class of the component to get.
+     * @returns The single registered child of the given type, or `null` if none are registered.
+     */
+    getChildOrNull<TComponent>(componentClass: Constructor<TComponent>): null | TComponent;
+    /**
+     * Get all children of the given type.
+     *
+     * @typeParam TComponent - The type of component to get.
+     * @param componentClass - The class of the component to get.
+     * @returns All registered children of the given type.
+     */
+    getChildren<TComponent>(componentClass: Constructor<TComponent>): TComponent[];
+}

package/dist/lib/cjs/obsidian/constructors/getDomEventsHandlersConstructor.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/constructors/index.d.cts

@@ -1 +1,2 @@
+/// <reference path="../../library.d.cts" />
 export * as 'getDomEventsHandlersConstructor' from './getDomEventsHandlersConstructor.cjs';

package/dist/lib/cjs/obsidian/data-handler.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/dataview-link.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/dataview.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/editor.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/file-change.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/file-manager.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/file-system.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/frontmatter-link-cache-with-offsets.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/frontmatter.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/i18n/custom-type-options.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/i18n/default-translations.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/i18n/i18n.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/i18n/index.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../../library.d.cts" />
 export * as 'custom-type-options' from './custom-type-options.cjs';
 export * as 'default-translations' from './default-translations.cjs';
 export * as 'i18n' from './i18n.cjs';

package/dist/lib/cjs/obsidian/i18n/locales/en.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../../../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/i18n/locales/index.d.cts

@@ -1,2 +1,3 @@
+/// <reference path="../../../library.d.cts" />
 export * as 'en' from './en.cjs';
 export * as 'translations-map' from './translations-map.cjs';

package/dist/lib/cjs/obsidian/i18n/locales/translations-map.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../../../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/index.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 export * as 'active-file-provider' from './active-file-provider.cjs';
 export * as 'app' from './app.cjs';
 export * as 'async-with-notice' from './async-with-notice.cjs';

package/dist/lib/cjs/obsidian/is-in-obsidian.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/link.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/logger.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/loop.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/markdown-code-block-processor-registrar.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/markdown-code-block-processor.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *

package/dist/lib/cjs/obsidian/markdown-view.d.cts

@@ -1,3 +1,4 @@
+/// <reference path="../library.d.cts" />
 /**
  * @file
  *