obsidian-dev-utils 55.4.0 → 56.0.0

package/dist/lib/cjs/obsidian/plugin/components/async-error-handler-component.cjs

@@ -0,0 +1,165 @@
+/*
+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/prefer-active-doc -- 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/prefer-active-doc  -- 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/prefer-active-doc -- 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 async_error_handler_component_exports = {};
+__export(async_error_handler_component_exports, {
+  AsyncErrorHandlerComponent: () => AsyncErrorHandlerComponent
+});
+module.exports = __toCommonJS(async_error_handler_component_exports);
+var import_obsidian = require('obsidian');
+var import_error = require('../../../error.cjs');
+var import_i18n = require('../../i18n/i18n.cjs');
+var import_plugin_notice_component = require('./plugin-notice-component.cjs');
+class AsyncErrorHandlerComponent extends import_obsidian.Component {
+  /**
+   * Creates a new async error handler component.
+   *
+   * @param noticeComponent - The notice component used to display error messages.
+   */
+  constructor(noticeComponent) {
+    super();
+    this.noticeComponent = noticeComponent;
+  }
+  noticeComponent;
+  /**
+   * Registers the error handler.
+   */
+  onload() {
+    this.register((0, import_error.registerAsyncErrorEventHandler)(this.handleAsyncError.bind(this)));
+  }
+  /**
+   * Called when an async error occurs.
+   *
+   * @param _asyncError - The async error.
+   */
+  handleAsyncError(_asyncError) {
+    this.noticeComponent.showNotice((0, import_i18n.t)(($) => $.obsidianDevUtils.notices.unhandledError));
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AsyncErrorHandlerComponent
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL3BsdWdpbi9jb21wb25lbnRzL2FzeW5jLWVycm9yLWhhbmRsZXItY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29tcG9uZW50IHRoYXQgaGFuZGxlcyBhc3luYyBlcnJvcnMgYnkgc2hvd2luZyBhIG5vdGljZSB0byB0aGUgdXNlci5cbiAqL1xuXG5pbXBvcnQgeyBDb21wb25lbnQgfSBmcm9tICdvYnNpZGlhbic7XG5cbmltcG9ydCB7IHJlZ2lzdGVyQXN5bmNFcnJvckV2ZW50SGFuZGxlciB9IGZyb20gJy4uLy4uLy4uL2Vycm9yLnRzJztcbmltcG9ydCB7IHQgfSBmcm9tICcuLi8uLi9pMThuL2kxOG4udHMnO1xuaW1wb3J0IHsgUGx1Z2luTm90aWNlQ29tcG9uZW50IH0gZnJvbSAnLi9wbHVnaW4tbm90aWNlLWNvbXBvbmVudC50cyc7XG5cbi8qKlxuICogUmVnaXN0ZXJzIGEgZ2xvYmFsIGFzeW5jIGVycm9yIGhhbmRsZXIgdGhhdCBzaG93cyBhIG5vdGljZSB0byB0aGUgdXNlci5cbiAqL1xuZXhwb3J0IGNsYXNzIEFzeW5jRXJyb3JIYW5kbGVyQ29tcG9uZW50IGV4dGVuZHMgQ29tcG9uZW50IHtcbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgYXN5bmMgZXJyb3IgaGFuZGxlciBjb21wb25lbnQuXG4gICAqXG4gICAqIEBwYXJhbSBub3RpY2VDb21wb25lbnQgLSBUaGUgbm90aWNlIGNvbXBvbmVudCB1c2VkIHRvIGRpc3BsYXkgZXJyb3IgbWVzc2FnZXMuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocHJpdmF0ZSByZWFkb25seSBub3RpY2VDb21wb25lbnQ6IFBsdWdpbk5vdGljZUNvbXBvbmVudCkge1xuICAgIHN1cGVyKCk7XG4gIH1cblxuICAvKipcbiAgICogUmVnaXN0ZXJzIHRoZSBlcnJvciBoYW5kbGVyLlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIG9ubG9hZCgpOiB2b2lkIHtcbiAgICB0aGlzLnJlZ2lzdGVyKHJlZ2lzdGVyQXN5bmNFcnJvckV2ZW50SGFuZGxlcih0aGlzLmhhbmRsZUFzeW5jRXJyb3IuYmluZCh0aGlzKSkpO1xuICB9XG5cbiAgLyoqXG4gICAqIENhbGxlZCB3aGVuIGFuIGFzeW5jIGVycm9yIG9jY3Vycy5cbiAgICpcbiAgICogQHBhcmFtIF9hc3luY0Vycm9yIC0gVGhlIGFzeW5jIGVycm9yLlxuICAgKi9cbiAgcHJvdGVjdGVkIGhhbmRsZUFzeW5jRXJyb3IoX2FzeW5jRXJyb3I6IHVua25vd24pOiB2b2lkIHtcbiAgICB0aGlzLm5vdGljZUNvbXBvbmVudC5zaG93Tm90aWNlKHQoKCQpID0+ICQub2JzaWRpYW5EZXZVdGlscy5ub3RpY2VzLnVuaGFuZGxlZEVycm9yKSk7XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQU1BLHNCQUEwQjtBQUUxQixtQkFBK0M7QUFDL0Msa0JBQWtCO0FBQ2xCLHFDQUFzQztBQUsvQixNQUFNLG1DQUFtQywwQkFBVTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU1qRCxZQUE2QixpQkFBd0M7QUFDMUUsVUFBTTtBQUQ0QjtBQUFBLEVBRXBDO0FBQUEsRUFGb0M7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9wQixTQUFlO0FBQzdCLFNBQUssYUFBUyw2Q0FBK0IsS0FBSyxpQkFBaUIsS0FBSyxJQUFJLENBQUMsQ0FBQztBQUFBLEVBQ2hGO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT1UsaUJBQWlCLGFBQTRCO0FBQ3JELFNBQUssZ0JBQWdCLGVBQVcsZUFBRSxDQUFDLE1BQU0sRUFBRSxpQkFBaUIsUUFBUSxjQUFjLENBQUM7QUFBQSxFQUNyRjtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/cjs/obsidian/plugin/components/async-error-handler-component.d.cts

@@ -0,0 +1,29 @@
+/**
+ * @file
+ *
+ * Component that handles async errors by showing a notice to the user.
+ */
+import { Component } from 'obsidian';
+import { PluginNoticeComponent } from './plugin-notice-component.cjs';
+/**
+ * Registers a global async error handler that shows a notice to the user.
+ */
+export declare class AsyncErrorHandlerComponent extends Component {
+    private readonly noticeComponent;
+    /**
+     * Creates a new async error handler component.
+     *
+     * @param noticeComponent - The notice component used to display error messages.
+     */
+    constructor(noticeComponent: PluginNoticeComponent);
+    /**
+     * Registers the error handler.
+     */
+    onload(): void;
+    /**
+     * Called when an async error occurs.
+     *
+     * @param _asyncError - The async error.
+     */
+    protected handleAsyncError(_asyncError: unknown): void;
+}

package/dist/lib/cjs/obsidian/plugin/components/console-debug-component.cjs

@@ -0,0 +1,160 @@
+/*
+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/prefer-active-doc -- 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/prefer-active-doc  -- 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/prefer-active-doc -- 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 console_debug_component_exports = {};
+__export(console_debug_component_exports, {
+  ConsoleDebugComponent: () => ConsoleDebugComponent
+});
+module.exports = __toCommonJS(console_debug_component_exports);
+var import_obsidian = require('obsidian');
+var import_debug = require('../../../debug.cjs');
+class ConsoleDebugComponent extends import_obsidian.Component {
+  /**
+   * Creates a new console debug component.
+   *
+   * @param pluginId - The plugin ID (used as the debugger namespace).
+   */
+  constructor(pluginId) {
+    super();
+    this.pluginId = pluginId;
+  }
+  pluginId;
+  /**
+   * Logs a message to the console under the plugin's debugger namespace.
+   *
+   * @param message - The message to log.
+   * @param args - Additional arguments to log.
+   */
+  debug(message, ...args) {
+    const FRAMES_TO_SKIP = 1;
+    const pluginDebugger = (0, import_debug.getDebugger)(this.pluginId, FRAMES_TO_SKIP);
+    pluginDebugger(message, ...args);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConsoleDebugComponent
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL3BsdWdpbi9jb21wb25lbnRzL2NvbnNvbGUtZGVidWctY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29tcG9uZW50IHRoYXQgcHJvdmlkZXMgbmFtZXNwYWNlZCBjb25zb2xlIGRlYnVnIGxvZ2dpbmcuXG4gKi9cblxuaW1wb3J0IHsgQ29tcG9uZW50IH0gZnJvbSAnb2JzaWRpYW4nO1xuXG5pbXBvcnQgeyBnZXREZWJ1Z2dlciB9IGZyb20gJy4uLy4uLy4uL2RlYnVnLnRzJztcblxuLyoqXG4gKiBQcm92aWRlcyBhIG5hbWVzcGFjZWQgYGNvbnNvbGVEZWJ1ZygpYCBtZXRob2QgZm9yIGxvZ2dpbmcuXG4gKlxuICogTWVzc2FnZXMgYXJlIG5vdCBzaG93biBieSBkZWZhdWx0IFx1MjAxNCBlbmFibGUgdGhlIHBsdWdpbidzIGRlYnVnZ2VyIG5hbWVzcGFjZSB0byBzZWUgdGhlbS5cbiAqXG4gKiBAc2VlIHtAbGluayBodHRwczovL2dpdGh1Yi5jb20vbW5hb3Vtb3Yvb2JzaWRpYW4tZGV2LXV0aWxzL2Jsb2IvbWFpbi9kb2NzL2RlYnVnZ2luZy5tZH0gZm9yIG1vcmUgaW5mb3JtYXRpb24uXG4gKi9cbmV4cG9ydCBjbGFzcyBDb25zb2xlRGVidWdDb21wb25lbnQgZXh0ZW5kcyBDb21wb25lbnQge1xuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBjb25zb2xlIGRlYnVnIGNvbXBvbmVudC5cbiAgICpcbiAgICogQHBhcmFtIHBsdWdpbklkIC0gVGhlIHBsdWdpbiBJRCAodXNlZCBhcyB0aGUgZGVidWdnZXIgbmFtZXNwYWNlKS5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3Rvcihwcml2YXRlIHJlYWRvbmx5IHBsdWdpbklkOiBzdHJpbmcpIHtcbiAgICBzdXBlcigpO1xuICB9XG5cbiAgLyoqXG4gICAqIExvZ3MgYSBtZXNzYWdlIHRvIHRoZSBjb25zb2xlIHVuZGVyIHRoZSBwbHVnaW4ncyBkZWJ1Z2dlciBuYW1lc3BhY2UuXG4gICAqXG4gICAqIEBwYXJhbSBtZXNzYWdlIC0gVGhlIG1lc3NhZ2UgdG8gbG9nLlxuICAgKiBAcGFyYW0gYXJncyAtIEFkZGl0aW9uYWwgYXJndW1lbnRzIHRvIGxvZy5cbiAgICovXG4gIHB1YmxpYyBkZWJ1ZyhtZXNzYWdlOiBzdHJpbmcsIC4uLmFyZ3M6IHVua25vd25bXSk6IHZvaWQge1xuICAgIC8vIFNraXAgdGhlIGBkZWJ1ZygpYCBjYWxsIGl0c2VsZlxuICAgIGNvbnN0IEZSQU1FU19UT19TS0lQID0gMTtcbiAgICBjb25zdCBwbHVnaW5EZWJ1Z2dlciA9IGdldERlYnVnZ2VyKHRoaXMucGx1Z2luSWQsIEZSQU1FU19UT19TS0lQKTtcbiAgICBwbHVnaW5EZWJ1Z2dlcihtZXNzYWdlLCAuLi5hcmdzKTtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBTUEsc0JBQTBCO0FBRTFCLG1CQUE0QjtBQVNyQixNQUFNLDhCQUE4QiwwQkFBVTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU01QyxZQUE2QixVQUFrQjtBQUNwRCxVQUFNO0FBRDRCO0FBQUEsRUFFcEM7QUFBQSxFQUZvQztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBVTdCLE1BQU0sWUFBb0IsTUFBdUI7QUFFdEQsVUFBTSxpQkFBaUI7QUFDdkIsVUFBTSxxQkFBaUIsMEJBQVksS0FBSyxVQUFVLGNBQWM7QUFDaEUsbUJBQWUsU0FBUyxHQUFHLElBQUk7QUFBQSxFQUNqQztBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

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

@@ -0,0 +1,29 @@
+/**
+ * @file
+ *
+ * Component that provides namespaced console debug logging.
+ */
+import { Component } from 'obsidian';
+/**
+ * Provides a namespaced `consoleDebug()` method for logging.
+ *
+ * Messages are not shown by default — enable the plugin's debugger namespace to see them.
+ *
+ * @see {@link https://github.com/mnaoumov/obsidian-dev-utils/blob/main/docs/debugging.md} for more information.
+ */
+export declare class ConsoleDebugComponent extends Component {
+    private readonly pluginId;
+    /**
+     * Creates a new console debug component.
+     *
+     * @param pluginId - The plugin ID (used as the debugger namespace).
+     */
+    constructor(pluginId: string);
+    /**
+     * Logs a message to the console under the plugin's debugger namespace.
+     *
+     * @param message - The message to log.
+     * @param args - Additional arguments to log.
+     */
+    debug(message: string, ...args: unknown[]): void;
+}

package/dist/lib/cjs/obsidian/{i18n/default-translations-base.cjs → plugin/components/i18n-component.cjs}

@@ -4,6 +4,7 @@ if you want to view the source, please visit the github repository of this plugi
 */
 
 (function initCjs() {
+  // eslint-disable-next-line obsidianmd/prefer-active-doc -- Actively use globalThis.
   const globalThisRecord = globalThis;
   globalThisRecord['__name'] ??= name;
   const originalRequire = require;
@@ -83,10 +84,12 @@ if you want to view the source, please visit the github repository of this plugi
       return originalRequire?.(id);
     }
 
-    // eslint-disable-next-line @typescript-eslint/no-deprecated, @typescript-eslint/no-unnecessary-condition -- We need access to app here which might not be available yet.
-    if (globalThis?.app?.isMobile) {
+    // eslint-disable-next-line @typescript-eslint/no-deprecated, obsidianmd/prefer-active-doc  -- 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/prefer-active-doc -- Actively use globalThis.
         return globalThis.process;
       }
     } else {
@@ -96,6 +99,7 @@ if you want to view the source, please visit the github repository of this plugi
       }
     }
 
+    // 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 {};
   }
@@ -106,6 +110,10 @@ 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))
@@ -115,7 +123,34 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var default_translations_base_exports = {};
-module.exports = __toCommonJS(default_translations_base_exports);
-var import_en = require('./locales/en.cjs');
-//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2kxOG4vZGVmYXVsdC10cmFuc2xhdGlvbnMtYmFzZS50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRoaXMgZmlsZSBkZWZpbmVzIGEgZGVmYXVsdCB0cmFuc2xhdGlvbnMgYmFzZSBmb3IgYGkxOG5leHRgLlxuICovXG5cbi8qIHY4IGlnbm9yZSBzdGFydCAtLSBJbnRlcmZhY2Utb25seSBtb2R1bGU7IG5vIHJ1bnRpbWUgY29kZSB0byB0ZXN0LiAqL1xuXG5pbXBvcnQgdHlwZSB7IFBsdWdpblR5cGVzQmFzZSB9IGZyb20gJy4uL3BsdWdpbi9wbHVnaW4tdHlwZXMtYmFzZS50cyc7XG5pbXBvcnQgdHlwZSB7IFRyYW5zbGF0aW9ucyB9IGZyb20gJy4vaTE4bi50cyc7XG5cbmltcG9ydCB7IGVuIH0gZnJvbSAnLi9sb2NhbGVzL2VuLnRzJztcblxuLyoqXG4gKiBBIGRlZmF1bHQgcGx1Z2luIHR5cGVzIGZvciBgaTE4bmV4dGAuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRGVmYXVsdFBsdWdpblR5cGVzIGV4dGVuZHMgUGx1Z2luVHlwZXNCYXNlIHtcbiAgLyoqXG4gICAqIFRoZSBkZWZhdWx0IHRyYW5zbGF0aW9ucy5cbiAgICovXG4gIGRlZmF1bHRUcmFuc2xhdGlvbnM6IHR5cGVvZiBlbjtcbn1cblxuLyoqXG4gKiBBIGRlZmF1bHQgdHJhbnNsYXRpb25zIGJhc2UgZm9yIGBpMThuZXh0YC5cbiAqL1xuZXhwb3J0IHR5cGUgRGVmYXVsdFRyYW5zbGF0aW9uc0Jhc2UgPSBUcmFuc2xhdGlvbktleU1hcCAmIFRyYW5zbGF0aW9uczxEZWZhdWx0UGx1Z2luVHlwZXM+O1xuXG50eXBlIFRyYW5zbGF0aW9uS2V5ID0gc3RyaW5nIHwgVHJhbnNsYXRpb25LZXlNYXA7XG4vLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgQHR5cGVzY3JpcHQtZXNsaW50L25vLWVtcHR5LW9iamVjdC10eXBlIC0tIFdlIGNhbm5vdCBpbmxpbmUgYFRyYW5zbGF0aW9uS2V5TWFwYCwgc28gd2UgbmVlZCB0byBleHRyYWN0IGl0IGV2ZW4gaWYgaXQgaXMgZW1wdHkuXG5pbnRlcmZhY2UgVHJhbnNsYXRpb25LZXlNYXAgZXh0ZW5kcyBSZWNvcmQ8c3RyaW5nLCBUcmFuc2xhdGlvbktleT4ge31cblxuLyogdjggaWdub3JlIHN0b3AgKi9cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFXQSxnQkFBbUI7IiwKICAibmFtZXMiOiBbXQp9Cg==
+var i18n_component_exports = {};
+__export(i18n_component_exports, {
+  I18nComponent: () => I18nComponent
+});
+module.exports = __toCommonJS(i18n_component_exports);
+var import_async_component = require('../../components/async-component.cjs');
+var import_i18n = require('../../i18n/i18n.cjs');
+var import_translations_map = require('../../i18n/locales/translations-map.cjs');
+class I18nComponent extends import_async_component.AsyncComponentBase {
+  /**
+   * Creates a new i18n component.
+   *
+   * @param translationsMap - The translations map. Defaults to the built-in translations.
+   */
+  constructor(translationsMap = import_translations_map.defaultTranslationsMap) {
+    super();
+    this.translationsMap = translationsMap;
+  }
+  translationsMap;
+  /**
+   * Initializes i18n.
+   */
+  async onload() {
+    await (0, import_i18n.initI18N)(this.translationsMap);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  I18nComponent
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL3BsdWdpbi9jb21wb25lbnRzL2kxOG4tY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29tcG9uZW50IHRoYXQgaW5pdGlhbGl6ZXMgaTE4biB0cmFuc2xhdGlvbnMuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBUcmFuc2xhdGlvbnNNYXAgfSBmcm9tICcuLi8uLi9pMThuL2kxOG4udHMnO1xuXG5pbXBvcnQgeyBBc3luY0NvbXBvbmVudEJhc2UgfSBmcm9tICcuLi8uLi9jb21wb25lbnRzL2FzeW5jLWNvbXBvbmVudC50cyc7XG5pbXBvcnQgeyBpbml0STE4TiB9IGZyb20gJy4uLy4uL2kxOG4vaTE4bi50cyc7XG5pbXBvcnQgeyBkZWZhdWx0VHJhbnNsYXRpb25zTWFwIH0gZnJvbSAnLi4vLi4vaTE4bi9sb2NhbGVzL3RyYW5zbGF0aW9ucy1tYXAudHMnO1xuXG4vKipcbiAqIEluaXRpYWxpemVzIHRoZSBpMThuIG1vZHVsZSB3aXRoIHRoZSBwcm92aWRlZCB0cmFuc2xhdGlvbnMgbWFwLlxuICovXG5leHBvcnQgY2xhc3MgSTE4bkNvbXBvbmVudCBleHRlbmRzIEFzeW5jQ29tcG9uZW50QmFzZSB7XG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IGkxOG4gY29tcG9uZW50LlxuICAgKlxuICAgKiBAcGFyYW0gdHJhbnNsYXRpb25zTWFwIC0gVGhlIHRyYW5zbGF0aW9ucyBtYXAuIERlZmF1bHRzIHRvIHRoZSBidWlsdC1pbiB0cmFuc2xhdGlvbnMuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocHJpdmF0ZSByZWFkb25seSB0cmFuc2xhdGlvbnNNYXA6IFRyYW5zbGF0aW9uc01hcCA9IGRlZmF1bHRUcmFuc2xhdGlvbnNNYXApIHtcbiAgICBzdXBlcigpO1xuICB9XG5cbiAgLyoqXG4gICAqIEluaXRpYWxpemVzIGkxOG4uXG4gICAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgYXN5bmMgb25sb2FkKCk6IFByb21pc2U8dm9pZD4ge1xuICAgIGF3YWl0IGluaXRJMThOKHRoaXMudHJhbnNsYXRpb25zTWFwKTtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBUUEsNkJBQW1DO0FBQ25DLGtCQUF5QjtBQUN6Qiw4QkFBdUM7QUFLaEMsTUFBTSxzQkFBc0IsMENBQW1CO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBTTdDLFlBQTZCLGtCQUFtQyxnREFBd0I7QUFDN0YsVUFBTTtBQUQ0QjtBQUFBLEVBRXBDO0FBQUEsRUFGb0M7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9wQyxNQUFzQixTQUF3QjtBQUM1QyxjQUFNLHNCQUFTLEtBQUssZUFBZTtBQUFBLEVBQ3JDO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==

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

@@ -0,0 +1,23 @@
+/**
+ * @file
+ *
+ * Component that initializes i18n translations.
+ */
+import type { TranslationsMap } from '../../i18n/i18n.cjs';
+import { AsyncComponentBase } from '../../components/async-component.cjs';
+/**
+ * Initializes the i18n module with the provided translations map.
+ */
+export declare class I18nComponent extends AsyncComponentBase {
+    private readonly translationsMap;
+    /**
+     * Creates a new i18n component.
+     *
+     * @param translationsMap - The translations map. Defaults to the built-in translations.
+     */
+    constructor(translationsMap?: TranslationsMap);
+    /**
+     * Initializes i18n.
+     */
+    onload(): Promise<void>;
+}

package/dist/lib/cjs/obsidian/plugin/components/index.cjs

@@ -0,0 +1,170 @@
+/*
+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/prefer-active-doc -- 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/prefer-active-doc  -- 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/prefer-active-doc -- 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 __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var components_exports = {};
+__export(components_exports, {
+  abort_signal_component: () => abort_signal_component,
+  async_error_handler_component: () => async_error_handler_component,
+  console_debug_component: () => console_debug_component,
+  i18n_component: () => i18n_component,
+  lifecycle_events_component: () => lifecycle_events_component,
+  plugin_context_component: () => plugin_context_component,
+  plugin_notice_component: () => plugin_notice_component,
+  plugin_settings_component: () => plugin_settings_component,
+  plugin_settings_tab_component: () => plugin_settings_tab_component
+});
+module.exports = __toCommonJS(components_exports);
+var abort_signal_component = __toESM(__extractDefault(require('./abort-signal-component.cjs')), 1);
+var async_error_handler_component = __toESM(__extractDefault(require('./async-error-handler-component.cjs')), 1);
+var console_debug_component = __toESM(__extractDefault(require('./console-debug-component.cjs')), 1);
+var i18n_component = __toESM(__extractDefault(require('./i18n-component.cjs')), 1);
+var lifecycle_events_component = __toESM(__extractDefault(require('./lifecycle-events-component.cjs')), 1);
+var plugin_context_component = __toESM(__extractDefault(require('./plugin-context-component.cjs')), 1);
+var plugin_notice_component = __toESM(__extractDefault(require('./plugin-notice-component.cjs')), 1);
+var plugin_settings_component = __toESM(__extractDefault(require('./plugin-settings-component.cjs')), 1);
+var plugin_settings_tab_component = __toESM(__extractDefault(require('./plugin-settings-tab-component.cjs')), 1);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  abort_signal_component,
+  async_error_handler_component,
+  console_debug_component,
+  i18n_component,
+  lifecycle_events_component,
+  plugin_context_component,
+  plugin_notice_component,
+  plugin_settings_component,
+  plugin_settings_tab_component
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL3BsdWdpbi9jb21wb25lbnRzL2luZGV4LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKiBUSElTIElTIEEgR0VORVJBVEVEL0JVTkRMRUQgRklMRSBCWSBCVUlMRCBTQ1JJUFQgKi9cblxuZXhwb3J0ICogYXMgYWJvcnRfc2lnbmFsX2NvbXBvbmVudCBmcm9tICcuL2Fib3J0LXNpZ25hbC1jb21wb25lbnQudHMnO1xuZXhwb3J0ICogYXMgYXN5bmNfZXJyb3JfaGFuZGxlcl9jb21wb25lbnQgZnJvbSAnLi9hc3luYy1lcnJvci1oYW5kbGVyLWNvbXBvbmVudC50cyc7XG5leHBvcnQgKiBhcyBjb25zb2xlX2RlYnVnX2NvbXBvbmVudCBmcm9tICcuL2NvbnNvbGUtZGVidWctY29tcG9uZW50LnRzJztcbmV4cG9ydCAqIGFzIGkxOG5fY29tcG9uZW50IGZyb20gJy4vaTE4bi1jb21wb25lbnQudHMnO1xuZXhwb3J0ICogYXMgbGlmZWN5Y2xlX2V2ZW50c19jb21wb25lbnQgZnJvbSAnLi9saWZlY3ljbGUtZXZlbnRzLWNvbXBvbmVudC50cyc7XG5leHBvcnQgKiBhcyBwbHVnaW5fY29udGV4dF9jb21wb25lbnQgZnJvbSAnLi9wbHVnaW4tY29udGV4dC1jb21wb25lbnQudHMnO1xuZXhwb3J0ICogYXMgcGx1Z2luX25vdGljZV9jb21wb25lbnQgZnJvbSAnLi9wbHVnaW4tbm90aWNlLWNvbXBvbmVudC50cyc7XG5leHBvcnQgKiBhcyBwbHVnaW5fc2V0dGluZ3NfY29tcG9uZW50IGZyb20gJy4vcGx1Z2luLXNldHRpbmdzLWNvbXBvbmVudC50cyc7XG5leHBvcnQgKiBhcyBwbHVnaW5fc2V0dGluZ3NfdGFiX2NvbXBvbmVudCBmcm9tICcuL3BsdWdpbi1zZXR0aW5ncy10YWItY29tcG9uZW50LnRzJztcbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBRUEsNkJBQXdDO0FBQ3hDLG9DQUErQztBQUMvQyw4QkFBeUM7QUFDekMscUJBQWdDO0FBQ2hDLGlDQUE0QztBQUM1QywrQkFBMEM7QUFDMUMsOEJBQXlDO0FBQ3pDLGdDQUEyQztBQUMzQyxvQ0FBK0M7IiwKICAibmFtZXMiOiBbXQp9Cg==