obsidian-dev-utils 88.5.0 → 88.6.0

package/dist/integration-test-plugin/main.js

@@ -26787,6 +26787,7 @@ init_error();
 init_function();
 var ComponentEx = class _ComponentEx extends import_obsidian99.Component {
   childrenSet = /* @__PURE__ */ new Set();
+  hasBeenLoaded = false;
   loadErrors = [];
   loadPromise = null;
   /**
@@ -26796,11 +26797,21 @@ var ComponentEx = class _ComponentEx extends import_obsidian99.Component {
    * immediately, so `child._loaded` is set before this method returns even when this component has async load logic.
    * The child's async tail (if any) is sequenced into the load promise so a later {@link loadWithPromises} call awaits it.
    *
+   * Adding a child BEFORE the first load is legitimate: the child is queued and loaded when this component loads.
+   * Adding one AFTER this component has been unloaded is not — the child would never be loaded and never unloaded
+   * (a leak), so it is refused with a {@link SilentError}. The typical source of such a call is an `async` method
+   * that was suspended on an `await` when the component got unloaded and then resumed on the dead component; the
+   * {@link SilentError} unwinds it quietly (see {@link isUnloaded}).
+   *
    * @typeParam TComponent - The type of component to add.
    * @param component - The component instance to add.
    * @returns The added component.
+   * @throws A {@link SilentError} if the component has already been unloaded.
    */
   addChild(component) {
+    if (this.isUnloaded()) {
+      throw new SilentError("Component is already unloaded");
+    }
     this._children.push(component);
     this.childrenSet.add(component);
     if (this._loaded) {
@@ -26818,6 +26829,7 @@ var ComponentEx = class _ComponentEx extends import_obsidian99.Component {
       return;
     }
     this._loaded = true;
+    this.hasBeenLoaded = true;
     this.resetLoadState();
     this.onload();
     const onloadAsyncPromise = this.onloadAsync();
@@ -26908,12 +26920,22 @@ var ComponentEx = class _ComponentEx extends import_obsidian99.Component {
    * {@link Component.unload} is a no-op while the component is not loaded, so any teardown registered beforehand would
    * never run if the component is unloaded without first being loaded.
    *
-   * @throws An {@link Error} if the component is not loaded.
+   * The two not-loaded cases are deliberately distinguished. A component that was NEVER loaded is a genuine
+   * programming error, so it throws a loud {@link Error}. A component that has ALREADY been unloaded is not —
+   * it is the expected outcome of work that outlived its component (e.g. an `async` method suspended on an
+   * `await` while the component was unloaded, then resumed) — so it throws a {@link SilentError}, which
+   * `handleSilentError` suppresses, letting such work unwind quietly instead of reporting an async error.
+   *
+   * @throws An {@link Error} if the component was never loaded, or a {@link SilentError} if it has already been unloaded.
    */
   ensureLoaded() {
-    if (!this._loaded) {
-      throw new Error("Component is not loaded");
+    if (this._loaded) {
+      return;
     }
+    if (this.isUnloaded()) {
+      throw new SilentError("Component is already unloaded");
+    }
+    throw new Error("Component is not loaded");
   }
   /**
    * Returns the component's in-flight load {@link Promise} (its {@link onloadAsync} plus children), or `null` when
@@ -26942,6 +26964,22 @@ var ComponentEx = class _ComponentEx extends import_obsidian99.Component {
   hasLoadErrors() {
     return this.loadErrors.length > 0;
   }
+  /**
+   * Returns whether the component has already been unloaded, as opposed to simply not having been loaded yet.
+   *
+   * Both states leave `_loaded` false, but they mean opposite things: a component that was never loaded is still
+   * ahead of its lifecycle (queueing children before load is legitimate), while an unloaded one is behind it and
+   * must not be used any further. The distinction is tracked by a flag set in {@link load}, NOT by an
+   * {@link Component.onunload} override, because subclasses override `onunload` and may not call `super`.
+   *
+   * Use it in a long-running `async` method to abandon work whose component was unloaded mid-flight, when
+   * unwinding via the {@link SilentError} thrown by {@link ensureLoaded} / {@link addChild} is not desired.
+   *
+   * @returns `true` if the component was loaded at some point and is currently unloaded, otherwise `false`.
+   */
+  isUnloaded() {
+    return this.hasBeenLoaded && !this._loaded;
+  }
   /**
    * Sequences an already-started load step into the load promise.
    *
@@ -34123,7 +34161,7 @@ __export(plugin_settings_tab_exports, {
   PluginSettingsTabBase: () => PluginSettingsTabBase,
   SAVE_TO_FILE_CONTEXT: () => SAVE_TO_FILE_CONTEXT
 });
-var import_obsidian132 = require("obsidian");
+var import_obsidian146 = require("obsidian");
 init_async_events();
 init_function();
 init_type_guards();
@@ -34286,910 +34324,917 @@ function isValidatorComponent(obj) {
   return typeof obj === "object" && obj !== null && "validatorEl" in obj && !!obj.validatorEl;
 }
 
-// src/obsidian/validation.ts
-var validation_exports = {};
-__export(validation_exports, {
-  OBSIDIAN_UNSAFE_FILENAME_CHARS: () => OBSIDIAN_UNSAFE_FILENAME_CHARS,
-  UNIX_UNSAFE_PATH_CHARS: () => UNIX_UNSAFE_PATH_CHARS,
-  WINDOWS_UNSAFE_PATH_CHARS: () => WINDOWS_UNSAFE_PATH_CHARS,
-  getOsAndObsidianUnsafePathCharsRegExp: () => getOsAndObsidianUnsafePathCharsRegExp,
-  getOsUnsafePathCharsRegExp: () => getOsUnsafePathCharsRegExp,
-  isValidationMessageHolder: () => isValidationMessageHolder
+// src/obsidian/setting-ex.ts
+var setting_ex_exports = {};
+__export(setting_ex_exports, {
+  SettingEx: () => SettingEx,
+  adoptSettingEx: () => adoptSettingEx
+});
+var import_obsidian144 = require("obsidian");
+
+// src/obsidian/setting-components/checkbox-component.ts
+var checkbox_component_exports = {};
+__export(checkbox_component_exports, {
+  CheckboxComponent: () => CheckboxComponent
 });
 var import_obsidian131 = require("obsidian");
-init_reg_exp();
-function isValidationMessageHolder(value) {
-  return value.validationMessage !== void 0;
-}
-var OBSIDIAN_UNSAFE_FILENAME_CHARS = /[#^[\]|]/g;
-var WINDOWS_UNSAFE_PATH_CHARS = /[*\\/<>:|?"]/g;
-var UNIX_UNSAFE_PATH_CHARS = /[\0/]/g;
-function getOsAndObsidianUnsafePathCharsRegExp(isWindows) {
-  return oneOf([
-    getOsUnsafePathCharsRegExp(isWindows),
-    OBSIDIAN_UNSAFE_FILENAME_CHARS
-  ]);
-}
-function getOsUnsafePathCharsRegExp(isWindows) {
-  isWindows ??= import_obsidian131.Platform.isWin;
-  return isWindows ? WINDOWS_UNSAFE_PATH_CHARS : UNIX_UNSAFE_PATH_CHARS;
-}
+init_css_class();
+init_plugin_context();
+var CheckboxComponent = class extends import_obsidian131.ValueComponent {
+  /**
+   * An input element of the checkbox.
+   */
+  inputEl;
+  /**
+   * A validator element of the checkbox.
+   *
+   * @returns The validator element.
+   */
+  get validatorEl() {
+    return this.inputEl;
+  }
+  changeCallback;
+  /**
+   * Creates a new checkbox component.
+   *
+   * @param containerEl - The container element.
+   */
+  constructor(containerEl) {
+    super();
+    addPluginCssClasses(containerEl, ["checkbox-component" /* CheckboxComponent */]);
+    this.inputEl = containerEl.createEl("input", { type: "checkbox" });
+    this.inputEl.addEventListener("change", this.onChanged.bind(this));
+  }
+  /**
+   * Gets the value of the checkbox.
+   *
+   * @returns The value of the checkbox.
+   */
+  getValue() {
+    return this.inputEl.checked;
+  }
+  /**
+   * Sets the callback to be called when the checkbox is changed.
+   *
+   * @param callback - The callback to be called when the checkbox is changed.
+   * @returns The component.
+   */
+  onChange(callback) {
+    this.changeCallback = callback;
+    return this;
+  }
+  /**
+   * Called when the checkbox is changed.
+   */
+  onChanged() {
+    this.changeCallback?.(this.getValue());
+  }
+  /**
+   * Sets the disabled state of the checkbox.
+   *
+   * @param disabled - The disabled state of the checkbox.
+   * @returns The component.
+   */
+  setDisabled(disabled) {
+    super.setDisabled(disabled);
+    this.inputEl.disabled = disabled;
+    return this;
+  }
+  /**
+   * Sets the value of the checkbox.
+   *
+   * @param value - The value to set the checkbox to.
+   * @returns The component.
+   */
+  setValue(value) {
+    this.inputEl.checked = value;
+    return this;
+  }
+};
 
-// src/obsidian/plugin/plugin-settings-tab.ts
+// src/obsidian/setting-components/code-highlighter-component.ts
+var code_highlighter_component_exports = {};
+__export(code_highlighter_component_exports, {
+  CodeHighlighterComponent: () => CodeHighlighterComponent
+});
+var import_obsidian132 = require("obsidian");
+init_css_class();
 init_plugin_context();
-var SAVE_TO_FILE_CONTEXT = "PluginSettingsTab";
-var PluginSettingsTabBase = class extends mixinAsyncEvents()(import_obsidian132.PluginSettingTab) {
+var CodeHighlighterComponent = class extends import_obsidian132.ValueComponent {
   /**
-   * Whether the plugin settings tab is open.
+   * An input element of the component.
    *
-   * @returns Whether the plugin settings tab is open.
+   * @returns The input element of the component.
    */
-  get isOpen() {
-    return this._isOpen;
+  get inputEl() {
+    return this.textAreaComponent.inputEl;
   }
   /**
-   * The settings manager.
+   * Gets the validator element of the component.
+   *
+   * @returns The validator element of the component.
    */
-  pluginSettingsComponent;
+  get validatorEl() {
+    return this.inputEl;
+  }
   /**
-   * A debounce timeout for saving settings.
+   * The `<code>` element that renders the syntax-highlighted overlay. Subclasses customizing the highlighting can target it.
+   */
+  codeEl;
+  /**
+   * The `<pre>` element that wraps the highlighted code overlay. Subclasses customizing the highlighting can target it.
+   */
+  preEl;
+  /**
+   * The inner text area component.
+   */
+  textAreaComponent;
+  placeholder = "";
+  simulateChangeCallback;
+  tabSize;
+  /**
+   * Creates a new multiple text component.
    *
-   * @returns The debounce timeout for saving settings.
+   * @param containerEl - The container element of the component.
    */
-  get saveSettingsDebounceTimeoutInMilliseconds() {
-    const DEFAULT = 2e3;
-    return DEFAULT;
+  constructor(containerEl) {
+    super();
+    addPluginCssClasses(containerEl, "code-highlighter-component" /* CodeHighlighterComponent */);
+    const wrapper = containerEl.createDiv();
+    addPluginCssClasses(wrapper, "setting-component-wrapper" /* SettingComponentWrapper */);
+    this.textAreaComponent = new import_obsidian132.TextAreaComponent(wrapper);
+    this.preEl = wrapper.createEl("pre", {
+      attr: {
+        tabIndex: "-1"
+      }
+    });
+    this.codeEl = this.preEl.createEl("code", {
+      attr: {
+        tabIndex: "-1"
+      }
+    });
+    this.inputEl.addEventListener("input", convertAsyncToSync(this.updateHighlightedCode.bind(this)));
+    this.inputEl.addEventListener("scroll", this.handleScroll.bind(this));
+    this.inputEl.addEventListener("keydown", this.handleKeyDown.bind(this));
+    const DEFAULT_TAB_SIZE = 2;
+    this.tabSize = DEFAULT_TAB_SIZE;
   }
-  _isOpen = false;
-  component;
-  saveSettingsDebounced;
-  get pluginSettings() {
-    return this.pluginSettingsComponent.settingsState.inputValues;
+  /**
+   * Empties the component.
+   */
+  empty() {
+    this.setValue("");
   }
   /**
-   * Creates a new plugin settings tab.
+   * Gets the value of the component.
    *
-   * @param params - The params.
+   * @returns The value of the component.
    */
-  constructor(params) {
-    super(params.plugin.app, params.plugin);
-    this.pluginSettingsComponent = params.pluginSettingsComponent;
-    addPluginCssClasses(this.containerEl, "plugin-settings-tab" /* PluginSettingsTab */);
-    this.saveSettingsDebounced = (0, import_obsidian132.debounce)(
-      convertAsyncToSync(() => this.pluginSettingsComponent.saveToFile(SAVE_TO_FILE_CONTEXT)),
-      this.saveSettingsDebounceTimeoutInMilliseconds
-    );
-    this.component = new ComponentEx();
+  getValue() {
+    return this.textAreaComponent.getValue();
   }
   /**
-   * Binds a value component to a plugin setting.
+   * Checks if the component is empty.
    *
-   * @typeParam UIValue - The type of the value of the UI component.
-   * @typeParam TValueComponent - The type of the value component.
-   * @typeParam PropertyName - The property name of the plugin settings to bind to.
-   * @param params - The params for binding the value component.
-   * @returns The value component.
+   * @returns `true` if the component is empty, `false` otherwise.
    */
-  bind(params) {
-    const {
-      propertyName,
-      valueComponent,
-      ...options
-    } = params;
-    const DEFAULT_OPTIONS = {
-      componentToPluginSettingsValueConverter: (value) => value,
-      onChanged: noop,
-      pluginSettingsToComponentValueConverter: (value) => value,
-      shouldResetSettingWhenComponentIsEmpty: true,
-      shouldShowPlaceholderForDefaultValues: true,
-      shouldShowValidationMessage: true
+  isEmpty() {
+    return this.textAreaComponent.getValue() === "";
+  }
+  /**
+   * Adds a change listener to the component.
+   *
+   * @param callback - The callback to call when the value changes.
+   * @returns The component.
+   */
+  onChange(callback) {
+    const changeHandler = () => {
+      callback(this.getValue());
     };
-    const optionsExt = { ...DEFAULT_OPTIONS, ...options };
-    const validatorEl = getValidatorComponent(valueComponent)?.validatorEl;
-    const textBasedComponent = getTextBasedComponentValue(valueComponent);
-    const readonlyValue = this.getPluginSettingsProperty(propertyName);
-    const defaults = this.pluginSettingsComponent.defaultSettings;
-    const defaultValue = defaults[propertyName];
-    const defaultComponentValue = optionsExt.pluginSettingsToComponentValueConverter(defaultValue);
-    textBasedComponent?.setPlaceholderValue(defaultComponentValue);
-    let validationMessage;
-    let tooltipEl = null;
-    let tooltipContentEl = null;
-    if (validatorEl) {
-      const wrapper = ensureWrapped(validatorEl);
-      tooltipEl = wrapper.createDiv();
-      addPluginCssClasses(tooltipEl, ["tooltip" /* Tooltip */, "tooltip-validator" /* TooltipValidator */]);
-      tooltipContentEl = tooltipEl.createSpan();
-      const tooltipArrowEl = tooltipEl.createDiv();
-      addPluginCssClasses(tooltipArrowEl, "tooltip-arrow" /* TooltipArrow */);
-      tooltipEl.hide();
-      wrapper.appendChild(tooltipEl);
-    }
-    registerAsyncEvent(
-      this.component,
-      this.on("validationMessageChanged", (anotherPropertyName, anotherValidationMessage) => {
-        if (propertyName !== anotherPropertyName) {
-          return;
-        }
-        validationMessage = anotherValidationMessage;
-        updateValidatorElDebounced();
-      })
-    );
-    let shouldEmptyOnBlur = false;
-    let shouldRevertToDefaultValueOnBlur = false;
-    if (textBasedComponent && optionsExt.shouldShowPlaceholderForDefaultValues && deepEqual(readonlyValue, defaultValue)) {
-      textBasedComponent.empty();
-    } else {
-      valueComponent.setValue(optionsExt.pluginSettingsToComponentValueConverter(readonlyValue));
-    }
-    let shouldSkipOnChange = false;
-    const UPDATE_VALIDATOR_EL_TIMEOUT_IN_MILLISECONDS = 100;
-    const updateValidatorElDebounced = (0, import_obsidian132.debounce)(() => {
-      window.requestAnimationFrame(() => {
-        updateValidatorEl();
-      });
-    }, UPDATE_VALIDATOR_EL_TIMEOUT_IN_MILLISECONDS);
-    valueComponent.onChange(convertAsyncToSync(async (uiValue) => {
-      if (shouldSkipOnChange) {
-        shouldSkipOnChange = false;
-        return;
-      }
-      shouldEmptyOnBlur = false;
-      const oldValue = this.getPluginSettingsProperty(propertyName);
-      let newValue = void 0;
-      let shouldSetProperty = true;
-      shouldRevertToDefaultValueOnBlur = !!textBasedComponent?.isEmpty() && optionsExt.shouldResetSettingWhenComponentIsEmpty;
-      if (shouldRevertToDefaultValueOnBlur) {
-        newValue = defaultValue;
-      } else {
-        const convertedValue = optionsExt.componentToPluginSettingsValueConverter(uiValue);
-        if (isValidationMessageHolder(convertedValue)) {
-          validationMessage = convertedValue.validationMessage;
-          shouldSetProperty = false;
-        } else {
-          newValue = convertedValue;
-        }
-      }
-      if (shouldSetProperty) {
-        validationMessage = await this.pluginSettingsComponent.setProperty(propertyName, newValue);
-        if (textBasedComponent && optionsExt.shouldShowPlaceholderForDefaultValues && !textBasedComponent.isEmpty() && deepEqual(newValue, defaultValue)) {
-          shouldEmptyOnBlur = true;
-        }
-      }
-      updateValidatorElDebounced();
-      if (shouldSetProperty) {
-        await optionsExt.onChanged(newValue, oldValue);
-      }
-      this.saveSettingsDebounced();
-    }));
-    validatorEl?.addEventListener("focus", () => {
-      updateValidatorElDebounced();
-    });
-    validatorEl?.addEventListener("blur", () => {
-      updateValidatorElDebounced();
-    });
-    validatorEl?.addEventListener("click", () => {
-      window.requestAnimationFrame(() => {
-        updateValidatorElDebounced();
-      });
-    });
-    const validationMessages = this.pluginSettingsComponent.settingsState.validationMessages;
-    validationMessage = validationMessages[propertyName] ?? "";
-    updateValidatorElDebounced();
-    return valueComponent;
-    function updateValidatorEl() {
-      if (!validatorEl?.isActiveElement()) {
-        if (shouldEmptyOnBlur) {
-          shouldEmptyOnBlur = false;
-          if (!textBasedComponent?.isEmpty()) {
-            shouldSkipOnChange = true;
-            textBasedComponent?.empty();
-          }
-        } else if (shouldRevertToDefaultValueOnBlur) {
-          shouldRevertToDefaultValueOnBlur = false;
-          if (textBasedComponent?.isEmpty()) {
-            shouldSkipOnChange = true;
-            valueComponent.setValue(defaultComponentValue);
-          }
-        }
-      }
-      if (!validatorEl) {
-        return;
-      }
-      assertNonNullable(tooltipContentEl);
-      if (validationMessage === "") {
-        validatorEl.setCustomValidity("");
-        validatorEl.checkValidity();
-        validationMessage = validatorEl.validationMessage;
-      }
-      validatorEl.setCustomValidity(validationMessage);
-      if (optionsExt.shouldShowValidationMessage) {
-        tooltipContentEl.textContent = validationMessage;
-        tooltipEl?.toggle(!!validationMessage);
-      } else if (validationMessage) {
-        (0, import_obsidian132.setTooltip)(validatorEl, validationMessage);
-      }
-    }
-  }
-  /**
-   * Renders the plugin settings tab.
-   */
-  display() {
-    this.displayLegacy();
+    this.simulateChangeCallback = changeHandler;
+    this.textAreaComponent.onChange(changeHandler);
+    return this;
   }
   /**
-   * Legacy way to render the plugin settings tab.
+   * Sets the disabled state of the component.
    *
-   * Temporary workaround to avoid dealing with `@deprecated`.
-   */
-  displayLegacy() {
-    this.containerEl.empty();
-    this._isOpen = true;
-    this.component.load();
-    registerAsyncEvent(this.component, this.pluginSettingsComponent.on("loadSettings", this.onLoadSettings.bind(this)));
-    registerAsyncEvent(this.component, this.pluginSettingsComponent.on("saveSettings", (newState, oldState, context) => this.onSaveSettings({ context, newState, oldState })));
-  }
-  /**
-   * Hides the plugin settings tab.
+   * @param disabled - The disabled state to set.
+   * @returns The component.
    */
-  hide() {
-    super.hide();
-    this.saveSettingsDebounced.cancel();
-    this._isOpen = false;
-    this.component.unload();
-    invokeAsyncSafely(() => this.hideAsync());
+  setDisabled(disabled) {
+    super.setDisabled(disabled);
+    this.textAreaComponent.setDisabled(disabled);
+    return this;
   }
   /**
-   * Async actions to perform when the settings tab is being hidden.
+   * Sets the language for code highlighting.
    *
-   * @returns A {@link Promise} that resolves when the settings tab is hidden.
-   */
-  async hideAsync() {
-    await this.pluginSettingsComponent.saveToFile(SAVE_TO_FILE_CONTEXT);
-  }
-  /**
-   * Shows the plugin settings tab.
+   * @param language - The language to set.
+   * @returns The component.
    */
-  show() {
-    this.app.setting.openTab(this);
+  setLanguage(language) {
+    const LANGUAGE_CLASS_PREFIX = "language-";
+    for (const el of [this.preEl, this.codeEl]) {
+      for (const cls of Array.from(el.classList)) {
+        if (cls.startsWith(LANGUAGE_CLASS_PREFIX)) {
+          el.classList.remove(cls);
+        }
+      }
+      el.classList.add(`${LANGUAGE_CLASS_PREFIX}${language}`);
+    }
+    return this;
   }
   /**
-   * Called when the plugin settings are loaded.
+   * Sets the placeholder of the component.
    *
-   * @param _loadedState - The loaded settings state.
-   * @param _isInitialLoad - Whether the settings are being loaded for the first time.
-   * @returns A {@link Promise} that resolves when the settings are loaded.
+   * @param placeholder - The placeholder to set.
+   * @returns The component.
    */
-  async onLoadSettings(_loadedState, _isInitialLoad) {
-    this.displayLegacy();
-    await noopAsync();
+  setPlaceholder(placeholder) {
+    this.placeholder = placeholder;
+    invokeAsyncSafely(this.updateHighlightedCode.bind(this));
+    return this;
   }
   /**
-   * Revalidates the settings.
+   * Sets the placeholder value of the component.
    *
-   * @returns A {@link Promise} that resolves when the settings are revalidated.
+   * @param placeholderValue - The placeholder value to set.
+   * @returns The component.
    */
-  async revalidate() {
-    const validationMessages = await this.pluginSettingsComponent.revalidate();
-    await this.updateValidations(validationMessages);
-  }
-  getPluginSettingsProperty(propertyName) {
-    const settings = this.pluginSettings;
-    return settings[propertyName];
-  }
-  async onSaveSettings(params) {
-    const {
-      context,
-      newState,
-      oldState: _oldState
-    } = params;
-    if (context === SAVE_TO_FILE_CONTEXT) {
-      await this.updateValidations(newState.validationMessages);
-      return;
-    }
-    this.displayLegacy();
-  }
-  async updateValidations(validationMessages) {
-    for (const [propertyName, validationMessage] of Object.entries(validationMessages)) {
-      await this.triggerAsync("validationMessageChanged", propertyName, validationMessage);
-    }
+  setPlaceholderValue(placeholderValue) {
+    this.setPlaceholder(placeholderValue);
+    return this;
   }
-};
-
-// src/obsidian/plugin/plugin.ts
-var plugin_exports = {};
-__export(plugin_exports, {
-  PluginBase: () => PluginBase,
-  reloadPlugin: () => reloadPlugin,
-  showErrorAndDisablePlugin: () => showErrorAndDisablePlugin
-});
-var import_obsidian133 = require("obsidian");
-init_async_events();
-init_error();
-init_function();
-init_type_guards();
-var PluginBase = class extends mixinAsyncEvents()(import_obsidian133.Plugin) {
   /**
-   * Gets abort signal component.
+   * Sets the tab size of the component.
    *
-   * @returns abort signal component.
+   * @param tabSize - The tab size to set.
+   * @returns The component.
    */
-  get abortSignalComponent() {
-    return ensureNonNullable(this._abortSignalComponent);
+  setTabSize(tabSize) {
+    this.tabSize = tabSize;
+    return this;
   }
   /**
-   * Sets abort signal component.
+   * Sets the value of the component.
    *
-   * @param value - Abort signal component.
+   * @param value - The value to set.
+   * @returns The component.
    */
-  set abortSignalComponent(value) {
-    this._abortSignalComponent = value;
+  setValue(value) {
+    this.textAreaComponent.setValue(value);
+    invokeAsyncSafely(this.updateHighlightedCode.bind(this));
+    return this;
   }
   /**
-   * Gets async error handler component.
+   * Simulate a change event.
    *
-   * @returns async error handler component.
+   * @deprecated Use only from tests to simulate a change event.
    */
-  get asyncErrorHandlerComponent() {
-    return ensureNonNullable(this._asyncErrorHandlerComponent);
+  simulateChange__() {
+    this.simulateChangeCallback?.();
   }
   /**
-   * Sets async error handler component.
-   *
-   * @param value - Async error handler component.
+   * Re-renders the highlighted code overlay from the current text area value. Subclasses can override to customize the render.
    */
-  set asyncErrorHandlerComponent(value) {
-    this._asyncErrorHandlerComponent = value;
+  async updateHighlightedCode() {
+    this.codeEl.textContent = this.inputEl.value || this.placeholder;
+    const prism = await loadPrism();
+    prism.highlightElement(this.codeEl);
+    this.preEl.toggleClass("is-placeholder" /* IsPlaceholder */, this.isEmpty());
+    window.requestAnimationFrame(() => {
+      const gap = Math.max(0, this.inputEl.scrollHeight - this.preEl.scrollHeight);
+      this.preEl.setCssProps({
+        "--bottom-gap": toPx(gap)
+      });
+      this.handleScroll();
+    });
+  }
+  handleKeyDown(evt) {
+    if (evt.key !== "Tab") {
+      return;
+    }
+    evt.preventDefault();
+    if (evt.ctrlKey || evt.metaKey) {
+      const focusables = Array.from(activeDocument.querySelectorAll(
+        ':is(a, button, input, select, textarea, [tabindex]):not([tabindex="-1"]):not(:disabled):not([type="hidden"])'
+      ));
+      const index2 = focusables.indexOf(this.inputEl);
+      const deltaIndex = evt.shiftKey ? -1 : 1;
+      const nextControl = focusables[(index2 + deltaIndex + focusables.length) % focusables.length];
+      nextControl?.focus();
+      return;
+    }
+    const oldValue = this.getValue();
+    const selectionStart = this.inputEl.selectionStart;
+    const selectionEnd = this.inputEl.selectionEnd;
+    const beforeSelection = oldValue.slice(0, selectionStart);
+    const afterSelection = oldValue.slice(selectionEnd);
+    const tabs = " ".repeat(this.tabSize);
+    let newBeforeSelection = beforeSelection;
+    if (evt.shiftKey) {
+      if (beforeSelection.endsWith(tabs)) {
+        newBeforeSelection = beforeSelection.slice(0, -this.tabSize);
+      }
+    } else {
+      newBeforeSelection = beforeSelection + tabs;
+    }
+    const newValue = `${newBeforeSelection}${afterSelection}`;
+    this.setValue(newValue);
+    this.inputEl.selectionStart = newBeforeSelection.length;
+    this.inputEl.selectionEnd = newBeforeSelection.length;
+  }
+  handleScroll() {
+    this.preEl.scrollTop = this.inputEl.scrollTop;
+    this.preEl.scrollLeft = this.inputEl.scrollLeft;
   }
+};
+
+// src/obsidian/setting-components/date-component.ts
+var date_component_exports = {};
+__export(date_component_exports, {
+  DateComponent: () => DateComponent
+});
+var import_obsidian134 = require("obsidian");
+init_css_class();
+
+// src/obsidian/setting-components/typed-range-text-component.ts
+var typed_range_text_component_exports = {};
+__export(typed_range_text_component_exports, {
+  TypedRangeTextComponent: () => TypedRangeTextComponent
+});
+
+// src/obsidian/setting-components/typed-text-component.ts
+var typed_text_component_exports = {};
+__export(typed_text_component_exports, {
+  TypedTextComponent: () => TypedTextComponent
+});
+var import_obsidian133 = require("obsidian");
+init_css_class();
+init_plugin_context();
+var TypedTextComponent = class extends import_obsidian133.ValueComponent {
   /**
-   * Gets the shared command handler component. Register a plugin's commands on it via
-   * {@link CommandHandlerComponent.registerCommandHandlers} rather than constructing your own
-   * {@link CommandHandlerComponent} — the app-backed active-file provider, command registrar, menu
-   * event registrar, and plugin name are already wired.
+   * An input element of the component.
+   */
+  inputEl;
+  /**
+   * A validator element of the component.
    *
-   * @returns The command handler component.
+   * @returns The validator element.
    */
-  get commandHandlerComponent() {
-    return ensureNonNullable(this._commandHandlerComponent);
+  get validatorEl() {
+    return this.inputEl;
   }
   /**
-   * Sets the command handler component.
+   * The inner text component.
+   */
+  textComponent;
+  /**
+   * Creates a new typed text component.
    *
-   * @param value - The command handler component.
+   * @param params - The parameters for the typed text component.
    */
-  set commandHandlerComponent(value) {
-    this._commandHandlerComponent = value;
+  constructor(params) {
+    super();
+    this.textComponent = new import_obsidian133.TextComponent(params.containerEl);
+    this.inputEl = this.textComponent.inputEl;
+    this.inputEl.type = params.type;
+    addPluginCssClasses(params.containerEl, params.cssClass);
   }
   /**
-   * Gets console debug component.
+   * Gets the value of the component.
    *
-   * @returns console debug component.
+   * @returns The value of the component.
    */
-  get consoleDebugComponent() {
-    return ensureNonNullable(this._consoleDebugComponent);
+  getValue() {
+    return this.valueFromString(this.textComponent.getValue());
   }
   /**
-   * Sets console debug component.
+   * Sets the callback function to be called when the component is changed.
    *
-   * @param value - Console debug component.
+   * @param callback - The callback function to be called when the component is changed.
+   * @returns The component.
    */
-  set consoleDebugComponent(value) {
-    this._consoleDebugComponent = value;
+  onChange(callback) {
+    this.textComponent.onChange(() => {
+      callback(this.getValue());
+    });
+    return this;
   }
   /**
-   * Gets plugin context component (plugin ID, debug controller, library styles).
-   *
-   * @returns plugin context component.
+   * Called when the component is changed.
    */
-  get pluginContextComponent() {
-    return ensureNonNullable(this._pluginContextComponent);
+  onChanged() {
+    this.textComponent.onChanged();
   }
   /**
-   * Sets plugin context component.
+   * Sets the disabled state of the component.
    *
-   * @param value - Plugin context component.
+   * @param disabled - Whether the component is disabled.
+   * @returns The component.
    */
-  set pluginContextComponent(value) {
-    this._pluginContextComponent = value;
+  setDisabled(disabled) {
+    super.setDisabled(disabled);
+    this.textComponent.setDisabled(disabled);
+    return this;
   }
   /**
-   * Gets plugin notice component.
+   * Sets the value of the component.
    *
-   * @returns plugin notice component.
+   * @param value - The value to set.
+   * @returns The component.
    */
-  get pluginNoticeComponent() {
-    return ensureNonNullable(this._pluginNoticeComponent);
+  setValue(value) {
+    this.textComponent.setValue(this.valueToString(value));
+    return this;
   }
   /**
-   * Sets plugin notice component.
+   * Converts a value to a string.
    *
-   * @param value - Plugin notice component.
+   * @param value - The value to convert.
+   * @returns The string.
    */
-  set pluginNoticeComponent(value) {
-    this._pluginNoticeComponent = value;
+  valueToString(value) {
+    return String(value);
   }
+};
+
+// src/obsidian/setting-components/typed-range-text-component.ts
+var TypedRangeTextComponent = class extends TypedTextComponent {
   /**
-   * Gets the editor lock component, used to lock notes read-only during long operations. Owned by
-   * the plugin, so its locks are released automatically when the plugin unloads.
+   * Sets the maximum value of the component.
    *
-   * @returns Editor lock component.
+   * @param max - The maximum value.
+   * @returns The component.
    */
-  get resourceLockComponent() {
-    return ensureNonNullable(this._resourceLockComponent);
+  setMax(max) {
+    this.inputEl.max = this.valueToString(max);
+    return this;
   }
   /**
-   * Sets the editor lock component.
+   * Sets the minimum value of the component.
    *
-   * @param value - Editor lock component.
+   * @param min - The minimum value.
+   * @returns The component.
    */
-  set resourceLockComponent(value) {
-    this._resourceLockComponent = value;
+  setMin(min) {
+    this.inputEl.min = this.valueToString(min);
+    return this;
   }
-  _abortSignalComponent;
-  _asyncErrorHandlerComponent;
-  _commandHandlerComponent;
-  _consoleDebugComponent;
-  _pluginContextComponent;
-  _pluginNoticeComponent;
-  _resourceLockComponent;
-  wrapperComponent = new ComponentEx();
   /**
-   * Adds a child component.
-   *
-   * The child is added to an internal wrapper component so that, during {@link onloadImpl},
-   * children are queued and then loaded sequentially (children-first) when the plugin loads.
+   * Sets the step value of the component.
    *
-   * @typeParam TComponent - The type of component to add.
-   * @param component - The component instance to add.
-   * @returns The added component.
+   * @param step - The step value.
+   * @returns The component.
    */
-  addChild(component) {
-    return this.wrapperComponent.addChild(component);
+  setStep(step) {
+    this.inputEl.step = String(step);
+    return this;
   }
+};
+
+// src/obsidian/setting-components/date-component.ts
+var moment2 = extractDefaultExportInterop(import_obsidian134.moment);
+var DATE_FORMAT = "YYYY-MM-DD";
+var DateComponent = class extends TypedRangeTextComponent {
   /**
-   * Called when the external settings change.
+   * Creates a new date component.
    *
-   * Override in subclass if needed. Make sure to call `await super.onExternalSettingsChange()` first.
+   * @param containerEl - The container element of the component.
    */
-  async onExternalSettingsChange() {
-    await super.onExternalSettingsChange?.();
-    await this.triggerAsync("externalSettingsChange");
+  constructor(containerEl) {
+    super({
+      containerEl,
+      cssClass: "date-component" /* DateComponent */,
+      type: "date"
+    });
   }
   /**
-   * Called when the plugin is loaded.
+   * Converts a string to a date.
    *
-   * Orchestrates loading: registers the universal components, lets the subclass wire its own
-   * components via {@link onloadImpl}, then loads all of them sequentially (children-first).
+   * @param str - The string to convert.
+   * @returns The date.
+   */
+  valueFromString(str) {
+    return moment2(str, DATE_FORMAT).toDate();
+  }
+  /**
+   * Converts a date to a string.
    *
-   * Do NOT override this method. Override {@link onloadImpl} instead.
+   * @param value - The date to convert.
+   * @returns The string.
    */
-  async onload() {
-    try {
-      await initI18N(this.createTranslationsMap());
-      this.pluginContextComponent = this.addChild(
-        new PluginContextComponent({
-          app: this.app,
-          pluginId: this.manifest.id
-        })
-      );
-      this.pluginNoticeComponent = this.addChild(
-        new PluginNoticeComponent({
-          app: this.app,
-          pluginName: this.manifest.name
-        })
-      );
-      this.asyncErrorHandlerComponent = this.addChild(new AsyncErrorHandlerComponent(this.pluginNoticeComponent));
-      this.abortSignalComponent = this.addChild(new AbortSignalComponent(this.manifest.id));
-      this.consoleDebugComponent = this.addChild(new ConsoleDebugComponent(this.manifest.id));
-      this.resourceLockComponent = this.addChild(new ResourceLockComponent(this.app, this.manifest.id));
-      this.commandHandlerComponent = this.addChild(
-        new CommandHandlerComponent({
-          activeFileProvider: new AppActiveFileProvider(this.app),
-          commandRegistrar: new PluginCommandRegistrar(this),
-          menuEventRegistrar: this.addChild(new MenuEventRegistrarComponent(this.app)),
-          pluginName: this.manifest.name
-        })
-      );
-      this.commandHandlerComponent.registerCommandHandlers([
-        new UnlockActiveNoteCommandHandler({
-          app: this.app,
-          resourceLockComponent: this.resourceLockComponent
-        })
-      ]);
-      await this.onloadImpl();
-      super.addChild(this.wrapperComponent);
-      await this.wrapperComponent.loadWithPromises();
-    } catch (error) {
-      printError(new Error(`Error loading plugin ${this.manifest.name} (${this.manifest.id})`, { cause: error }));
-      throw error;
-    }
+  valueToString(value) {
+    return moment2(value).format(DATE_FORMAT);
   }
+};
+
+// src/obsidian/setting-components/date-time-component.ts
+var date_time_component_exports = {};
+__export(date_time_component_exports, {
+  DateTimeComponent: () => DateTimeComponent
+});
+var import_obsidian135 = require("obsidian");
+init_css_class();
+var moment3 = extractDefaultExportInterop(import_obsidian135.moment);
+var DATE_TIME_FORMAT = "YYYY-MM-DDTHH:mm";
+var DateTimeComponent = class extends TypedRangeTextComponent {
   /**
-   * Removes a child component.
+   * Creates a new date and time component.
    *
-   * @typeParam TComponent - The type of component to remove.
-   * @param component - The component instance to remove.
-   * @returns The removed component.
+   * @param containerEl - The container element of the component.
    */
-  removeChild(component) {
-    return this.wrapperComponent.removeChild(component);
+  constructor(containerEl) {
+    super({
+      containerEl,
+      cssClass: "datetime-component" /* DateTimeComponent */,
+      type: "datetime-local"
+    });
   }
   /**
-   * Provides the translations map used to initialize i18n during {@link onload}.
-   *
-   * Override in subclass to supply plugin-specific translations. The default returns the built-in
-   * `obsidian-dev-utils` translations.
+   * Converts a string to a date.
    *
-   * @returns The translations map.
+   * @param str - The string to convert.
+   * @returns The date.
    */
-  createTranslationsMap() {
-    return defaultTranslationsMap;
+  valueFromString(str) {
+    return moment3(str, DATE_TIME_FORMAT).toDate();
   }
   /**
-   * Called during {@link onload} to wire plugin-specific child components.
-   *
-   * Override in subclass to add child components via {@link addChild}. The universal components are
-   * available here. Children are loaded sequentially in the order they are added (children-first).
+   * Converts a date to a string.
    *
-   * @returns A {@link Promise} that resolves when the subclass load logic is complete.
+   * @param value - The date to convert.
+   * @returns The string.
    */
-  onloadImpl() {
-    return noopAsync();
+  valueToString(value) {
+    return moment3(value).format(DATE_TIME_FORMAT);
   }
 };
-async function reloadPlugin(plugin) {
-  const plugins = plugin.app.plugins;
-  const pluginId = plugin.manifest.id;
-  await plugins.disablePlugin(pluginId);
-  await plugins.enablePlugin(pluginId);
-}
-async function showErrorAndDisablePlugin(plugin, message) {
-  const pluginNoticeComponent = new PluginNoticeComponent({
-    app: plugin.app,
-    pluginName: plugin.manifest.name
-  });
-  pluginNoticeComponent.showNotice(message);
-  printError(new Error(message));
-  await plugin.app.plugins.disablePlugin(plugin.manifest.id);
-}
 
-// src/obsidian/plugin-cli-handler-registrar.ts
-var plugin_cli_handler_registrar_exports = {};
-__export(plugin_cli_handler_registrar_exports, {
-  PluginCliHandlerRegistrar: () => PluginCliHandlerRegistrar
+// src/obsidian/setting-components/email-component.ts
+var email_component_exports = {};
+__export(email_component_exports, {
+  EmailComponent: () => EmailComponent
 });
-var import_obsidian134 = require("obsidian");
-var PluginCliHandlerRegistrar = class {
+init_css_class();
+var EmailComponent = class extends TypedTextComponent {
   /**
-   * Creates a new instance of the {@link PluginCliHandlerRegistrar} class.
+   * Creates a new email component.
    *
-   * @param plugin - The Obsidian plugin instance.
+   * @param containerEl - The container element of the component.
    */
-  constructor(plugin) {
-    this.plugin = plugin;
+  constructor(containerEl) {
+    super({
+      containerEl,
+      cssClass: "email-component" /* EmailComponent */,
+      type: "email"
+    });
   }
-  plugin;
   /**
-   * Registers a CLI handler.
+   * Empties the component.
+   */
+  empty() {
+    this.setValue("");
+  }
+  /**
+   * Checks if the component is empty.
    *
-   * @param params - The parameters for the CLI handler registration.
+   * @returns `true` if the component is empty, `false` otherwise.
    */
-  registerCliHandler(params) {
-    this.plugin.registerCliHandler(params.command, params.description, params.flags, (cliData) => normalizePromisable(params.handler(cliData)));
+  isEmpty() {
+    return this.getValue() === "";
+  }
+  /**
+   * Sets the placeholder value of the component.
+   *
+   * @param placeholderValue - The placeholder value to set.
+   * @returns The component.
+   */
+  setPlaceholderValue(placeholderValue) {
+    this.textComponent.setPlaceholder(placeholderValue);
+    return this;
+  }
+  /**
+   * Converts a string to an email address.
+   *
+   * @param str - The string to convert.
+   * @returns The email address.
+   */
+  valueFromString(str) {
+    return str;
   }
 };
 
-// src/obsidian/popovers/index.ts
-var popovers_exports = {};
-__export(popovers_exports, {
-  "field-popover": () => field_popover_exports,
-  popover: () => popover_exports,
-  "popover-anchor": () => popover_anchor_exports
+// src/obsidian/setting-components/file-component.ts
+var file_component_exports = {};
+__export(file_component_exports, {
+  FileComponent: () => FileComponent
 });
+init_css_class();
+var FileComponent = class extends TypedTextComponent {
+  /**
+   * Creates a new file component.
+   *
+   * @param containerEl - The container element of the component.
+   */
+  constructor(containerEl) {
+    super({
+      containerEl,
+      cssClass: "file-component" /* FileComponent */,
+      type: "file"
+    });
+  }
+  /**
+   * Gets the value of the component.
+   *
+   * @returns The value of the component.
+   */
+  getValue() {
+    return this.inputEl.files?.[0] ?? null;
+  }
+  /**
+   * Converts a string to a file.
+   *
+   * @returns The file.
+   */
+  valueFromString() {
+    return this.getValue();
+  }
+  /**
+   * Converts a file to a string.
+   *
+   * @param value - The file to convert.
+   * @returns The string.
+   */
+  valueToString(value) {
+    return value?.name ?? "";
+  }
+};
 
-// src/obsidian/popovers/field-popover.ts
-var field_popover_exports = {};
-__export(field_popover_exports, {
-  editFieldsInPopover: () => editFieldsInPopover
+// src/obsidian/setting-components/month-component.ts
+var month_component_exports = {};
+__export(month_component_exports, {
+  MonthComponent: () => MonthComponent
 });
 var import_obsidian136 = require("obsidian");
 init_css_class();
+var moment4 = extractDefaultExportInterop(import_obsidian136.moment);
+var DATE_FORMAT2 = "YYYY-MM";
+var MonthComponent = class extends TypedRangeTextComponent {
+  /**
+   * Creates a new month component.
+   *
+   * @param containerEl - The container element of the component.
+   */
+  constructor(containerEl) {
+    super({
+      containerEl,
+      cssClass: "month-component" /* MonthComponent */,
+      type: "month"
+    });
+  }
+  /**
+   * Converts a string to a month.
+   *
+   * @param str - The string to convert.
+   * @returns The month.
+   */
+  valueFromString(str) {
+    const parsed = moment4(str, DATE_FORMAT2);
+    if (!parsed.isValid()) {
+      throw new Error("Invalid month");
+    }
+    return {
+      month: parsed.month() + 1,
+      year: parsed.year()
+    };
+  }
+  /**
+   * Converts a month to a string.
+   *
+   * @param value - The month to convert.
+   * @returns The string.
+   */
+  valueToString(value) {
+    const date = moment4().year(value.year).month(value.month - 1);
+    return date.format(DATE_FORMAT2);
+  }
+};
 
-// src/obsidian/popovers/popover.ts
-var popover_exports = {};
-__export(popover_exports, {
-  showPopover: () => showPopover
+// src/obsidian/setting-components/multiple-dropdown-component.ts
+var multiple_dropdown_component_exports = {};
+__export(multiple_dropdown_component_exports, {
+  MultipleDropdownComponent: () => MultipleDropdownComponent
 });
-var import_obsidian135 = require("obsidian");
+var import_obsidian137 = require("obsidian");
 init_css_class();
 init_plugin_context();
-var ANCHOR_GAP_IN_PIXELS = 4;
-var VIEWPORT_MARGIN_IN_PIXELS = 8;
-async function showPopover(params) {
-  const {
-    anchor,
-    build,
-    cancelButtonText,
-    cssClasses,
-    okButtonText
-  } = params;
-  const doc = anchor.doc;
-  const win = getDocumentWindow(doc);
-  const popoverEl = doc.body.createDiv({ cls: "menu" });
-  addPluginCssClasses(popoverEl, ["popover" /* Popover */, ...cssClasses ?? []]);
-  return await new Promise((resolve2) => {
-    const state = { isClosed: false };
-    function close(result) {
-      if (state.isClosed) {
-        return;
-      }
-      state.isClosed = true;
-      doc.removeEventListener("pointerdown", handlePointerDown, true);
-      popoverEl.remove();
-      resolve2(result);
-    }
-    function handleCancel() {
-      close(null);
-    }
-    function handleOk() {
-      close(getValue());
-    }
-    function handlePointerDown(evt) {
-      if (evt.composedPath().includes(popoverEl)) {
-        return;
-      }
-      close(null);
-    }
-    const getValue = build({
-      cancel: handleCancel,
-      confirm: handleOk,
-      contentEl: popoverEl
-    });
-    popoverEl.addEventListener("keydown", (evt) => {
-      if (evt.key === "Enter") {
-        evt.preventDefault();
-        handleOk();
-        return;
-      }
-      if (evt.key === "Escape") {
-        evt.preventDefault();
-        handleCancel();
-      }
-    });
-    const buttonsSetting = new import_obsidian135.Setting(popoverEl);
-    buttonsSetting.addButton((button) => {
-      button.setButtonText(okButtonText ?? t2(($) => $.obsidianDevUtils.buttons.ok)).setCta().setClass("ok-button" /* OkButton */).onClick(handleOk);
-    });
-    buttonsSetting.addButton((button) => {
-      button.setButtonText(cancelButtonText ?? t2(($) => $.obsidianDevUtils.buttons.cancel)).setClass("cancel-button" /* CancelButton */).onClick(handleCancel);
-    });
-    doc.addEventListener("pointerdown", handlePointerDown, true);
-    positionAtAnchor(popoverEl, anchor, win);
-    focusFirstInput(popoverEl);
-  });
-}
-function focusFirstInput(popoverEl) {
-  const inputEl = popoverEl.querySelector("input");
-  if (!inputEl) {
-    return;
-  }
-  inputEl.focus();
-  inputEl.select();
-}
-function positionAtAnchor(popoverEl, anchor, win) {
-  const maxLeft = Math.max(VIEWPORT_MARGIN_IN_PIXELS, win.innerWidth - popoverEl.offsetWidth - VIEWPORT_MARGIN_IN_PIXELS);
-  const maxTop = Math.max(VIEWPORT_MARGIN_IN_PIXELS, win.innerHeight - popoverEl.offsetHeight - VIEWPORT_MARGIN_IN_PIXELS);
-  const left = Math.min(Math.max(anchor.left, VIEWPORT_MARGIN_IN_PIXELS), maxLeft);
-  const top = Math.min(Math.max(anchor.bottom + ANCHOR_GAP_IN_PIXELS, VIEWPORT_MARGIN_IN_PIXELS), maxTop);
-  popoverEl.style.left = `${String(Math.round(left + win.scrollX))}px`;
-  popoverEl.style.top = `${String(Math.round(top + win.scrollY))}px`;
-}
-
-// src/obsidian/popovers/field-popover.ts
-async function editFieldsInPopover(params) {
-  const {
-    anchor,
-    cancelButtonText,
-    cssClasses,
-    fields,
-    okButtonText
-  } = params;
-  return await showPopover(normalizeOptionalProperties({
-    anchor,
-    build({ contentEl }) {
-      const editors = fields.map((field) => ({
-        key: field.key,
-        textComponent: addField(contentEl, field)
-      }));
-      return () => {
-        const values = {};
-        for (const editor of editors) {
-          values[editor.key] = editor.textComponent.getValue();
-        }
-        return values;
-      };
-    },
-    cancelButtonText,
-    cssClasses,
-    okButtonText
-  }));
-}
-function addField(containerEl, field) {
-  const setting = new import_obsidian136.Setting(containerEl).setName(field.name);
-  const textComponent = new import_obsidian136.TextComponent(setting.controlEl);
-  textComponent.setValue(field.defaultValue ?? "");
-  textComponent.setPlaceholder(field.placeholder ?? "");
-  textComponent.inputEl.addClass("text-box" /* TextBox */);
-  return textComponent;
-}
-
-// src/obsidian/react/index.ts
-var react_exports = {};
-__export(react_exports, {
-  "app-context": () => app_context_exports
-});
-
-// src/obsidian/react/app-context.ts
-var app_context_exports = {};
-__export(app_context_exports, {
-  AppContext: () => AppContext,
-  useApp: () => useApp
-});
-var import_obsidian137 = require("obsidian");
-var import_react = __toESM(require_react(), 1);
-init_type_guards();
-var AppContext = (0, import_react.createContext)(void 0);
-function useApp() {
-  return ensureNonNullable((0, import_react.useContext)(AppContext), "AppContext not found");
-}
-
-// src/obsidian/ribbon-icon-registrar.ts
-var ribbon_icon_registrar_exports = {};
-__export(ribbon_icon_registrar_exports, {
-  PluginRibbonIconRegistrar: () => PluginRibbonIconRegistrar
-});
-var import_obsidian138 = require("obsidian");
-var PluginRibbonIconRegistrar = class {
-  /**
-   * Creates a new instance of the {@link PluginRibbonIconRegistrar} class.
-   *
-   * @param plugin - The Obsidian plugin instance.
-   */
-  constructor(plugin) {
-    this.plugin = plugin;
-  }
-  plugin;
+var MultipleDropdownComponent = class extends import_obsidian137.ValueComponent {
   /**
-   * Registers a ribbon icon.
+   * A select element of the component.
    *
-   * @param params - The parameters for the ribbon icon registration.
-   * @returns The HTML element representing the registered ribbon icon.
+   * @returns The select element.
    */
-  addRibbonIcon(params) {
-    return this.plugin.addRibbonIcon(params.icon, params.title, params.callback);
+  get selectEl() {
+    return this.dropdownComponent.selectEl;
   }
-};
-
-// src/obsidian/setting-components/index.ts
-var setting_components_exports = {};
-__export(setting_components_exports, {
-  "checkbox-component": () => checkbox_component_exports,
-  "code-highlighter-component": () => code_highlighter_component_exports,
-  "date-component": () => date_component_exports,
-  "date-time-component": () => date_time_component_exports,
-  "email-component": () => email_component_exports,
-  "file-component": () => file_component_exports,
-  "month-component": () => month_component_exports,
-  "multiple-dropdown-component": () => multiple_dropdown_component_exports,
-  "multiple-email-component": () => multiple_email_component_exports,
-  "multiple-file-component": () => multiple_file_component_exports,
-  "multiple-text-component": () => multiple_text_component_exports,
-  "number-component": () => number_component_exports,
-  "password-component": () => password_component_exports,
-  "setting-component-wrapper": () => setting_component_wrapper_exports,
-  "telephone-component": () => telephone_component_exports,
-  "text-based-component": () => text_based_component_exports,
-  "time-component": () => time_component_exports,
-  "tri-state-checkbox-component": () => tri_state_checkbox_component_exports,
-  "typed-dropdown-component": () => typed_dropdown_component_exports,
-  "typed-multiple-dropdown-component": () => typed_multiple_dropdown_component_exports,
-  "typed-range-text-component": () => typed_range_text_component_exports,
-  "typed-text-component": () => typed_text_component_exports,
-  "url-component": () => url_component_exports,
-  "validator-component": () => validator_component_exports,
-  "value-component-with-change-tracking": () => value_component_with_change_tracking_exports,
-  "week-component": () => week_component_exports
-});
-
-// src/obsidian/setting-components/checkbox-component.ts
-var checkbox_component_exports = {};
-__export(checkbox_component_exports, {
-  CheckboxComponent: () => CheckboxComponent
-});
-var import_obsidian139 = require("obsidian");
-init_css_class();
-init_plugin_context();
-var CheckboxComponent = class extends import_obsidian139.ValueComponent {
-  /**
-   * An input element of the checkbox.
-   */
-  inputEl;
   /**
-   * A validator element of the checkbox.
+   * A validator element of the component.
    *
    * @returns The validator element.
    */
   get validatorEl() {
-    return this.inputEl;
+    return this.selectEl;
   }
-  changeCallback;
   /**
-   * Creates a new checkbox component.
+   * The inner dropdown component.
+   */
+  dropdownComponent;
+  simulateChangeCallback;
+  /**
+   * Creates a new multiple dropdown component.
    *
-   * @param containerEl - The container element.
+   * @param containerEl - The container element of the component.
    */
   constructor(containerEl) {
     super();
-    addPluginCssClasses(containerEl, ["checkbox-component" /* CheckboxComponent */]);
-    this.inputEl = containerEl.createEl("input", { type: "checkbox" });
-    this.inputEl.addEventListener("change", this.onChanged.bind(this));
+    this.dropdownComponent = new import_obsidian137.DropdownComponent(containerEl);
+    this.dropdownComponent.selectEl.multiple = true;
+    addPluginCssClasses(containerEl, "multiple-dropdown-component" /* MultipleDropdownComponent */);
   }
   /**
-   * Gets the value of the checkbox.
+   * Adds an option to the dropdown.
    *
-   * @returns The value of the checkbox.
+   * @param value - The value of the option.
+   * @param display - The display text of the option.
+   * @returns The component.
    */
-  getValue() {
-    return this.inputEl.checked;
+  addOption(value, display) {
+    this.dropdownComponent.addOption(value, display);
+    return this;
   }
   /**
-   * Sets the callback to be called when the checkbox is changed.
+   * Adds multiple options to the dropdown.
    *
-   * @param callback - The callback to be called when the checkbox is changed.
+   * @param options - The options to add.
    * @returns The component.
    */
-  onChange(callback) {
-    this.changeCallback = callback;
+  addOptions(options) {
+    this.dropdownComponent.addOptions(options);
     return this;
   }
   /**
-   * Called when the checkbox is changed.
+   * Gets the value of the component.
+   *
+   * @returns The value of the component.
    */
-  onChanged() {
-    this.changeCallback?.(this.getValue());
+  getValue() {
+    return Array.from(this.dropdownComponent.selectEl.selectedOptions).map((o2) => o2.value);
   }
   /**
-   * Sets the disabled state of the checkbox.
+   * Sets the callback function to be called when the component is changed.
    *
-   * @param disabled - The disabled state of the checkbox.
+   * @param callback - The callback function to be called when the component is changed.
+   * @returns The component.
+   */
+  onChange(callback) {
+    const changeHandler = () => {
+      callback(this.getValue());
+    };
+    this.simulateChangeCallback = changeHandler;
+    this.dropdownComponent.onChange(changeHandler);
+    return this;
+  }
+  /**
+   * Sets the disabled state of the component.
+   *
+   * @param disabled - The disabled state to set.
    * @returns The component.
    */
   setDisabled(disabled) {
     super.setDisabled(disabled);
-    this.inputEl.disabled = disabled;
+    this.dropdownComponent.setDisabled(disabled);
     return this;
   }
   /**
-   * Sets the value of the checkbox.
+   * Sets the value of the component.
    *
-   * @param value - The value to set the checkbox to.
+   * @param value - The value to set.
    * @returns The component.
    */
   setValue(value) {
-    this.inputEl.checked = value;
+    for (const option of Array.from(this.dropdownComponent.selectEl.options)) {
+      option.selected = value.includes(option.value);
+    }
     return this;
   }
+  /**
+   * Simulate a change event.
+   *
+   * @deprecated Use only from tests to simulate a change event.
+   */
+  simulateChange__() {
+    this.simulateChangeCallback?.();
+  }
 };
 
-// src/obsidian/setting-components/code-highlighter-component.ts
-var code_highlighter_component_exports = {};
-__export(code_highlighter_component_exports, {
-  CodeHighlighterComponent: () => CodeHighlighterComponent
+// src/obsidian/setting-components/multiple-email-component.ts
+var multiple_email_component_exports = {};
+__export(multiple_email_component_exports, {
+  MultipleEmailComponent: () => MultipleEmailComponent
 });
-var import_obsidian140 = require("obsidian");
+init_css_class();
+var MultipleEmailComponent = class extends TypedTextComponent {
+  /**
+   * Creates a new multiple emails component.
+   *
+   * @param containerEl - The container element of the component.
+   */
+  constructor(containerEl) {
+    super({
+      containerEl,
+      cssClass: "multiple-email-component" /* MultipleEmailComponent */,
+      type: "email"
+    });
+    this.inputEl.multiple = true;
+  }
+  /**
+   * Converts a string to an email address.
+   *
+   * @param str - The string to convert.
+   * @returns The email address.
+   */
+  valueFromString(str) {
+    return str.split(",").map((email) => email.trim());
+  }
+  /**
+   * Converts an email address to a string.
+   *
+   * @param value - The email address to convert.
+   * @returns The string.
+   */
+  valueToString(value) {
+    return value.join(", ");
+  }
+};
+
+// src/obsidian/setting-components/multiple-file-component.ts
+var multiple_file_component_exports = {};
+__export(multiple_file_component_exports, {
+  MultipleFileComponent: () => MultipleFileComponent
+});
+init_type_guards();
+init_css_class();
+var MultipleFileComponent = class extends TypedTextComponent {
+  /**
+   * Creates a new multiple file component.
+   *
+   * @param containerEl - The container element of the component.
+   */
+  constructor(containerEl) {
+    super({
+      containerEl,
+      cssClass: "multiple-file-component" /* MultipleFileComponent */,
+      type: "file"
+    });
+    this.inputEl.multiple = true;
+  }
+  /**
+   * Gets the value of the component.
+   *
+   * @returns The value of the component.
+   */
+  getValue() {
+    return Array.from(ensureNonNullable(this.inputEl.files));
+  }
+  /**
+   * Converts a string to a file.
+   *
+   * @returns The file.
+   */
+  valueFromString() {
+    return this.getValue();
+  }
+  /**
+   * Converts a file to a string.
+   *
+   * @param value - The file to convert.
+   * @returns The string.
+   */
+  valueToString(value) {
+    return value[0]?.name ?? "";
+  }
+};
+
+// src/obsidian/setting-components/multiple-text-component.ts
+var multiple_text_component_exports = {};
+__export(multiple_text_component_exports, {
+  MultipleTextComponent: () => MultipleTextComponent
+});
+var import_obsidian138 = require("obsidian");
 init_css_class();
 init_plugin_context();
-var CodeHighlighterComponent = class extends import_obsidian140.ValueComponent {
+var MultipleTextComponent = class extends import_obsidian138.ValueComponent {
   /**
    * An input element of the component.
    *
@@ -35206,21 +35251,11 @@ var CodeHighlighterComponent = class extends import_obsidian140.ValueComponent {
   get validatorEl() {
     return this.inputEl;
   }
-  /**
-   * The `<code>` element that renders the syntax-highlighted overlay. Subclasses customizing the highlighting can target it.
-   */
-  codeEl;
-  /**
-   * The `<pre>` element that wraps the highlighted code overlay. Subclasses customizing the highlighting can target it.
-   */
-  preEl;
   /**
    * The inner text area component.
    */
   textAreaComponent;
-  placeholder = "";
   simulateChangeCallback;
-  tabSize;
   /**
    * Creates a new multiple text component.
    *
@@ -35228,31 +35263,14 @@ var CodeHighlighterComponent = class extends import_obsidian140.ValueComponent {
    */
   constructor(containerEl) {
     super();
-    addPluginCssClasses(containerEl, "code-highlighter-component" /* CodeHighlighterComponent */);
-    const wrapper = containerEl.createDiv();
-    addPluginCssClasses(wrapper, "setting-component-wrapper" /* SettingComponentWrapper */);
-    this.textAreaComponent = new import_obsidian140.TextAreaComponent(wrapper);
-    this.preEl = wrapper.createEl("pre", {
-      attr: {
-        tabIndex: "-1"
-      }
-    });
-    this.codeEl = this.preEl.createEl("code", {
-      attr: {
-        tabIndex: "-1"
-      }
-    });
-    this.inputEl.addEventListener("input", convertAsyncToSync(this.updateHighlightedCode.bind(this)));
-    this.inputEl.addEventListener("scroll", this.handleScroll.bind(this));
-    this.inputEl.addEventListener("keydown", this.handleKeyDown.bind(this));
-    const DEFAULT_TAB_SIZE = 2;
-    this.tabSize = DEFAULT_TAB_SIZE;
+    this.textAreaComponent = new import_obsidian138.TextAreaComponent(containerEl);
+    addPluginCssClasses(containerEl, "multiple-text-component" /* MultipleTextComponent */);
   }
   /**
    * Empties the component.
    */
   empty() {
-    this.setValue("");
+    this.textAreaComponent.setValue("");
   }
   /**
    * Gets the value of the component.
@@ -35260,7 +35278,7 @@ var CodeHighlighterComponent = class extends import_obsidian140.ValueComponent {
    * @returns The value of the component.
    */
   getValue() {
-    return this.textAreaComponent.getValue();
+    return this.textAreaComponent.getValue().split("\n");
   }
   /**
    * Checks if the component is empty.
@@ -35295,24 +35313,6 @@ var CodeHighlighterComponent = class extends import_obsidian140.ValueComponent {
     this.textAreaComponent.setDisabled(disabled);
     return this;
   }
-  /**
-   * Sets the language for code highlighting.
-   *
-   * @param language - The language to set.
-   * @returns The component.
-   */
-  setLanguage(language) {
-    const LANGUAGE_CLASS_PREFIX = "language-";
-    for (const el of [this.preEl, this.codeEl]) {
-      for (const cls of Array.from(el.classList)) {
-        if (cls.startsWith(LANGUAGE_CLASS_PREFIX)) {
-          el.classList.remove(cls);
-        }
-      }
-      el.classList.add(`${LANGUAGE_CLASS_PREFIX}${language}`);
-    }
-    return this;
-  }
   /**
    * Sets the placeholder of the component.
    *
@@ -35320,8 +35320,7 @@ var CodeHighlighterComponent = class extends import_obsidian140.ValueComponent {
    * @returns The component.
    */
   setPlaceholder(placeholder) {
-    this.placeholder = placeholder;
-    invokeAsyncSafely(this.updateHighlightedCode.bind(this));
+    this.textAreaComponent.setPlaceholder(placeholder);
     return this;
   }
   /**
@@ -35331,17 +35330,7 @@ var CodeHighlighterComponent = class extends import_obsidian140.ValueComponent {
    * @returns The component.
    */
   setPlaceholderValue(placeholderValue) {
-    this.setPlaceholder(placeholderValue);
-    return this;
-  }
-  /**
-   * Sets the tab size of the component.
-   *
-   * @param tabSize - The tab size to set.
-   * @returns The component.
-   */
-  setTabSize(tabSize) {
-    this.tabSize = tabSize;
+    this.setPlaceholder(this.valueToString(placeholderValue));
     return this;
   }
   /**
@@ -35351,8 +35340,7 @@ var CodeHighlighterComponent = class extends import_obsidian140.ValueComponent {
    * @returns The component.
    */
   setValue(value) {
-    this.textAreaComponent.setValue(value);
-    invokeAsyncSafely(this.updateHighlightedCode.bind(this));
+    this.textAreaComponent.setValue(this.valueToString(value));
     return this;
   }
   /**
@@ -35364,441 +35352,312 @@ var CodeHighlighterComponent = class extends import_obsidian140.ValueComponent {
     this.simulateChangeCallback?.();
   }
   /**
-   * Re-renders the highlighted code overlay from the current text area value. Subclasses can override to customize the render.
+   * Converts the value to the string shown in the text area. Subclasses can override to customize the serialization.
+   *
+   * @param value - The value to convert.
+   * @returns The string representation of the value.
    */
-  async updateHighlightedCode() {
-    this.codeEl.textContent = this.inputEl.value || this.placeholder;
-    const prism = await loadPrism();
-    prism.highlightElement(this.codeEl);
-    this.preEl.toggleClass("is-placeholder" /* IsPlaceholder */, this.isEmpty());
-    window.requestAnimationFrame(() => {
-      const gap = Math.max(0, this.inputEl.scrollHeight - this.preEl.scrollHeight);
-      this.preEl.setCssProps({
-        "--bottom-gap": toPx(gap)
-      });
-      this.handleScroll();
+  valueToString(value) {
+    return value.join("\n");
+  }
+};
+
+// src/obsidian/setting-components/number-component.ts
+var number_component_exports = {};
+__export(number_component_exports, {
+  NumberComponent: () => NumberComponent
+});
+init_css_class();
+var NumberComponent = class extends TypedRangeTextComponent {
+  /**
+   * Creates a new number component.
+   *
+   * @param containerEl - The container element of the component.
+   */
+  constructor(containerEl) {
+    super({
+      containerEl,
+      cssClass: "number-component" /* NumberComponent */,
+      type: "number"
     });
   }
-  handleKeyDown(evt) {
-    if (evt.key !== "Tab") {
-      return;
-    }
-    evt.preventDefault();
-    if (evt.ctrlKey || evt.metaKey) {
-      const focusables = Array.from(activeDocument.querySelectorAll(
-        ':is(a, button, input, select, textarea, [tabindex]):not([tabindex="-1"]):not(:disabled):not([type="hidden"])'
-      ));
-      const index2 = focusables.indexOf(this.inputEl);
-      const deltaIndex = evt.shiftKey ? -1 : 1;
-      const nextControl = focusables[(index2 + deltaIndex + focusables.length) % focusables.length];
-      nextControl?.focus();
-      return;
-    }
-    const oldValue = this.getValue();
-    const selectionStart = this.inputEl.selectionStart;
-    const selectionEnd = this.inputEl.selectionEnd;
-    const beforeSelection = oldValue.slice(0, selectionStart);
-    const afterSelection = oldValue.slice(selectionEnd);
-    const tabs = " ".repeat(this.tabSize);
-    let newBeforeSelection = beforeSelection;
-    if (evt.shiftKey) {
-      if (beforeSelection.endsWith(tabs)) {
-        newBeforeSelection = beforeSelection.slice(0, -this.tabSize);
-      }
-    } else {
-      newBeforeSelection = beforeSelection + tabs;
-    }
-    const newValue = `${newBeforeSelection}${afterSelection}`;
-    this.setValue(newValue);
-    this.inputEl.selectionStart = newBeforeSelection.length;
-    this.inputEl.selectionEnd = newBeforeSelection.length;
-  }
-  handleScroll() {
-    this.preEl.scrollTop = this.inputEl.scrollTop;
-    this.preEl.scrollLeft = this.inputEl.scrollLeft;
-  }
-};
-
-// src/obsidian/setting-components/date-component.ts
-var date_component_exports = {};
-__export(date_component_exports, {
-  DateComponent: () => DateComponent
-});
-var import_obsidian142 = require("obsidian");
-init_css_class();
-
-// src/obsidian/setting-components/typed-range-text-component.ts
-var typed_range_text_component_exports = {};
-__export(typed_range_text_component_exports, {
-  TypedRangeTextComponent: () => TypedRangeTextComponent
-});
-
-// src/obsidian/setting-components/typed-text-component.ts
-var typed_text_component_exports = {};
-__export(typed_text_component_exports, {
-  TypedTextComponent: () => TypedTextComponent
-});
-var import_obsidian141 = require("obsidian");
-init_css_class();
-init_plugin_context();
-var TypedTextComponent = class extends import_obsidian141.ValueComponent {
-  /**
-   * An input element of the component.
-   */
-  inputEl;
-  /**
-   * A validator element of the component.
-   *
-   * @returns The validator element.
-   */
-  get validatorEl() {
-    return this.inputEl;
-  }
-  /**
-   * The inner text component.
-   */
-  textComponent;
-  /**
-   * Creates a new typed text component.
-   *
-   * @param params - The parameters for the typed text component.
-   */
-  constructor(params) {
-    super();
-    this.textComponent = new import_obsidian141.TextComponent(params.containerEl);
-    this.inputEl = this.textComponent.inputEl;
-    this.inputEl.type = params.type;
-    addPluginCssClasses(params.containerEl, params.cssClass);
-  }
   /**
-   * Gets the value of the component.
-   *
-   * @returns The value of the component.
+   * Empties the component.
    */
-  getValue() {
-    return this.valueFromString(this.textComponent.getValue());
+  empty() {
+    this.textComponent.setValue("");
   }
   /**
-   * Sets the callback function to be called when the component is changed.
+   * Checks if the component is empty.
    *
-   * @param callback - The callback function to be called when the component is changed.
-   * @returns The component.
-   */
-  onChange(callback) {
-    this.textComponent.onChange(() => {
-      callback(this.getValue());
-    });
-    return this;
-  }
-  /**
-   * Called when the component is changed.
+   * @returns `true` if the component is empty, `false` otherwise.
    */
-  onChanged() {
-    this.textComponent.onChanged();
+  isEmpty() {
+    return this.textComponent.getValue() === "";
   }
   /**
-   * Sets the disabled state of the component.
+   * Sets the placeholder of the component.
    *
-   * @param disabled - Whether the component is disabled.
+   * @param placeholder - The placeholder to set.
    * @returns The component.
    */
-  setDisabled(disabled) {
-    super.setDisabled(disabled);
-    this.textComponent.setDisabled(disabled);
+  setPlaceholder(placeholder) {
+    this.textComponent.setPlaceholder(placeholder);
     return this;
   }
   /**
-   * Sets the value of the component.
+   * Sets the placeholder value of the component.
    *
-   * @param value - The value to set.
+   * @param placeholderValue - The placeholder value to set.
    * @returns The component.
    */
-  setValue(value) {
-    this.textComponent.setValue(this.valueToString(value));
+  setPlaceholderValue(placeholderValue) {
+    this.textComponent.setPlaceholder(this.valueToString(placeholderValue));
     return this;
   }
   /**
-   * Converts a value to a string.
+   * Converts a string to a number.
    *
-   * @param value - The value to convert.
-   * @returns The string.
+   * @param str - The string to convert.
+   * @returns The number.
    */
-  valueToString(value) {
-    return String(value);
+  valueFromString(str) {
+    return parseInt(str, 10);
   }
 };
 
-// src/obsidian/setting-components/typed-range-text-component.ts
-var TypedRangeTextComponent = class extends TypedTextComponent {
+// src/obsidian/setting-components/password-component.ts
+var password_component_exports = {};
+__export(password_component_exports, {
+  PasswordComponent: () => PasswordComponent
+});
+init_css_class();
+var PasswordComponent = class extends TypedTextComponent {
   /**
-   * Sets the maximum value of the component.
+   * Creates a new password component.
    *
-   * @param max - The maximum value.
-   * @returns The component.
+   * @param containerEl - The container element of the component.
    */
-  setMax(max) {
-    this.inputEl.max = this.valueToString(max);
-    return this;
+  constructor(containerEl) {
+    super({
+      containerEl,
+      cssClass: "password-component" /* PasswordComponent */,
+      type: "password"
+    });
   }
   /**
-   * Sets the minimum value of the component.
+   * Sets the placeholder value of the component.
    *
-   * @param min - The minimum value.
+   * @param placeholder - The placeholder to set.
    * @returns The component.
    */
-  setMin(min) {
-    this.inputEl.min = this.valueToString(min);
+  setPlaceholder(placeholder) {
+    this.textComponent.setPlaceholder(placeholder);
     return this;
   }
   /**
-   * Sets the step value of the component.
+   * Gets the value from a string.
    *
-   * @param step - The step value.
-   * @returns The component.
+   * @param str - The string to get the value from.
+   * @returns The value from the string.
    */
-  setStep(step) {
-    this.inputEl.step = String(step);
-    return this;
+  valueFromString(str) {
+    return str;
   }
 };
 
-// src/obsidian/setting-components/date-component.ts
-var moment2 = extractDefaultExportInterop(import_obsidian142.moment);
-var DATE_FORMAT = "YYYY-MM-DD";
-var DateComponent = class extends TypedRangeTextComponent {
+// src/obsidian/setting-components/telephone-component.ts
+var telephone_component_exports = {};
+__export(telephone_component_exports, {
+  TelephoneComponent: () => TelephoneComponent
+});
+init_css_class();
+var TelephoneComponent = class extends TypedTextComponent {
   /**
-   * Creates a new date component.
+   * Creates a new telephone component.
    *
    * @param containerEl - The container element of the component.
    */
   constructor(containerEl) {
     super({
       containerEl,
-      cssClass: "date-component" /* DateComponent */,
-      type: "date"
+      cssClass: "telephone-component" /* TelephoneComponent */,
+      type: "tel"
     });
   }
   /**
-   * Converts a string to a date.
+   * Empties the component.
+   */
+  empty() {
+    this.textComponent.setValue("");
+  }
+  /**
+   * Checks if the component is empty.
    *
-   * @param str - The string to convert.
-   * @returns The date.
+   * @returns `true` if the component is empty, `false` otherwise.
    */
-  valueFromString(str) {
-    return moment2(str, DATE_FORMAT).toDate();
+  isEmpty() {
+    return this.textComponent.getValue() === "";
   }
   /**
-   * Converts a date to a string.
+   * Sets the placeholder value of the component.
    *
-   * @param value - The date to convert.
-   * @returns The string.
+   * @param placeholderValue - The placeholder value to set.
+   * @returns The component.
    */
-  valueToString(value) {
-    return moment2(value).format(DATE_FORMAT);
+  setPlaceholderValue(placeholderValue) {
+    this.textComponent.setPlaceholder(placeholderValue);
+    return this;
+  }
+  /**
+   * Gets the value from a string.
+   *
+   * @param str - The string to get the value from.
+   * @returns The value from the string.
+   */
+  valueFromString(str) {
+    return str;
   }
 };
 
-// src/obsidian/setting-components/date-time-component.ts
-var date_time_component_exports = {};
-__export(date_time_component_exports, {
-  DateTimeComponent: () => DateTimeComponent
+// src/obsidian/setting-components/time-component.ts
+var time_component_exports = {};
+__export(time_component_exports, {
+  TimeComponent: () => TimeComponent
 });
-var import_obsidian143 = require("obsidian");
+var import_obsidian139 = require("obsidian");
 init_css_class();
-var moment3 = extractDefaultExportInterop(import_obsidian143.moment);
-var DATE_TIME_FORMAT = "YYYY-MM-DDTHH:mm";
-var DateTimeComponent = class extends TypedRangeTextComponent {
+var TimeComponent = class extends TypedRangeTextComponent {
   /**
-   * Creates a new date and time component.
+   * Creates a new time component.
    *
    * @param containerEl - The container element of the component.
    */
   constructor(containerEl) {
     super({
       containerEl,
-      cssClass: "datetime-component" /* DateTimeComponent */,
-      type: "datetime-local"
+      cssClass: "time-component" /* TimeComponent */,
+      type: "time"
     });
   }
   /**
-   * Converts a string to a date.
+   * Converts a string to a time.
    *
    * @param str - The string to convert.
    * @returns The date.
    */
   valueFromString(str) {
-    return moment3(str, DATE_TIME_FORMAT).toDate();
+    return import_obsidian139.moment.duration(str);
   }
   /**
-   * Converts a date to a string.
+   * Converts a time to a string.
    *
-   * @param value - The date to convert.
+   * @param value - The time to convert.
    * @returns The string.
    */
   valueToString(value) {
-    return moment3(value).format(DATE_TIME_FORMAT);
-  }
-};
+    let format2;
+    if (value.milliseconds() > 0) {
+      format2 = "HH:mm:ss.SSS";
+    } else if (value.seconds() > 0) {
+      format2 = "HH:mm:ss";
+    } else {
+      format2 = "HH:mm";
+    }
+    return import_obsidian139.moment.utc(value.asMilliseconds()).format(format2);
+  }
+};
 
-// src/obsidian/setting-components/email-component.ts
-var email_component_exports = {};
-__export(email_component_exports, {
-  EmailComponent: () => EmailComponent
+// src/obsidian/setting-components/tri-state-checkbox-component.ts
+var tri_state_checkbox_component_exports = {};
+__export(tri_state_checkbox_component_exports, {
+  TriStateCheckboxComponent: () => TriStateCheckboxComponent
 });
+var import_obsidian140 = require("obsidian");
 init_css_class();
-var EmailComponent = class extends TypedTextComponent {
-  /**
-   * Creates a new email component.
-   *
-   * @param containerEl - The container element of the component.
-   */
-  constructor(containerEl) {
-    super({
-      containerEl,
-      cssClass: "email-component" /* EmailComponent */,
-      type: "email"
-    });
-  }
-  /**
-   * Empties the component.
-   */
-  empty() {
-    this.setValue("");
-  }
-  /**
-   * Checks if the component is empty.
-   *
-   * @returns `true` if the component is empty, `false` otherwise.
-   */
-  isEmpty() {
-    return this.getValue() === "";
-  }
+init_plugin_context();
+var TriStateCheckboxComponent = class extends import_obsidian140.ValueComponent {
   /**
-   * Sets the placeholder value of the component.
-   *
-   * @param placeholderValue - The placeholder value to set.
-   * @returns The component.
+   * An input element of the checkbox.
    */
-  setPlaceholderValue(placeholderValue) {
-    this.textComponent.setPlaceholder(placeholderValue);
-    return this;
-  }
+  inputEl;
   /**
-   * Converts a string to an email address.
+   * A validator element of the checkbox.
    *
-   * @param str - The string to convert.
-   * @returns The email address.
+   * @returns The validator element.
    */
-  valueFromString(str) {
-    return str;
+  get validatorEl() {
+    return this.inputEl;
   }
-};
-
-// src/obsidian/setting-components/file-component.ts
-var file_component_exports = {};
-__export(file_component_exports, {
-  FileComponent: () => FileComponent
-});
-init_css_class();
-var FileComponent = class extends TypedTextComponent {
+  changeCallback;
   /**
-   * Creates a new file component.
+   * Creates a new tri-state checkbox component.
    *
-   * @param containerEl - The container element of the component.
+   * @param containerEl - The container element.
    */
   constructor(containerEl) {
-    super({
-      containerEl,
-      cssClass: "file-component" /* FileComponent */,
-      type: "file"
-    });
+    super();
+    addPluginCssClasses(containerEl, "tri-state-checkbox-component" /* TriStateCheckboxComponent */);
+    this.inputEl = containerEl.createEl("input", { type: "checkbox" });
+    this.inputEl.addEventListener("change", this.onChanged.bind(this));
   }
   /**
-   * Gets the value of the component.
+   * Gets the value of the checkbox.
    *
-   * @returns The value of the component.
+   * @returns The value of the checkbox.
    */
   getValue() {
-    return this.inputEl.files?.[0] ?? null;
-  }
-  /**
-   * Converts a string to a file.
-   *
-   * @returns The file.
-   */
-  valueFromString() {
-    return this.getValue();
+    return this.inputEl.indeterminate ? null : this.inputEl.checked;
   }
   /**
-   * Converts a file to a string.
+   * Sets the callback to be called when the checkbox is changed.
    *
-   * @param value - The file to convert.
-   * @returns The string.
+   * @param callback - The callback to be called when the checkbox is changed.
+   * @returns The component.
    */
-  valueToString(value) {
-    return value?.name ?? "";
+  onChange(callback) {
+    this.changeCallback = callback;
+    return this;
   }
-};
-
-// src/obsidian/setting-components/month-component.ts
-var month_component_exports = {};
-__export(month_component_exports, {
-  MonthComponent: () => MonthComponent
-});
-var import_obsidian144 = require("obsidian");
-init_css_class();
-var moment4 = extractDefaultExportInterop(import_obsidian144.moment);
-var DATE_FORMAT2 = "YYYY-MM";
-var MonthComponent = class extends TypedRangeTextComponent {
   /**
-   * Creates a new month component.
-   *
-   * @param containerEl - The container element of the component.
+   * Called when the checkbox is changed.
    */
-  constructor(containerEl) {
-    super({
-      containerEl,
-      cssClass: "month-component" /* MonthComponent */,
-      type: "month"
-    });
+  onChanged() {
+    this.changeCallback?.(this.getValue());
   }
   /**
-   * Converts a string to a month.
+   * Sets the disabled state of the checkbox.
    *
-   * @param str - The string to convert.
-   * @returns The month.
+   * @param disabled - The disabled state of the checkbox.
+   * @returns The component.
    */
-  valueFromString(str) {
-    const parsed = moment4(str, DATE_FORMAT2);
-    if (!parsed.isValid()) {
-      throw new Error("Invalid month");
-    }
-    return {
-      month: parsed.month() + 1,
-      year: parsed.year()
-    };
+  setDisabled(disabled) {
+    super.setDisabled(disabled);
+    this.inputEl.disabled = disabled;
+    return this;
   }
   /**
-   * Converts a month to a string.
+   * Sets the value of the checkbox.
    *
-   * @param value - The month to convert.
-   * @returns The string.
+   * @param value - The value to set the checkbox to.
+   * @returns The component.
    */
-  valueToString(value) {
-    const date = moment4().year(value.year).month(value.month - 1);
-    return date.format(DATE_FORMAT2);
+  setValue(value) {
+    this.inputEl.indeterminate = value === null;
+    this.inputEl.checked = value ?? false;
+    return this;
   }
 };
 
-// src/obsidian/setting-components/multiple-dropdown-component.ts
-var multiple_dropdown_component_exports = {};
-__export(multiple_dropdown_component_exports, {
-  MultipleDropdownComponent: () => MultipleDropdownComponent
+// src/obsidian/setting-components/typed-dropdown-component.ts
+var typed_dropdown_component_exports = {};
+__export(typed_dropdown_component_exports, {
+  TypedDropdownComponent: () => TypedDropdownComponent
 });
-var import_obsidian145 = require("obsidian");
+var import_obsidian141 = require("obsidian");
 init_css_class();
 init_plugin_context();
-var MultipleDropdownComponent = class extends import_obsidian145.ValueComponent {
+var TypedDropdownComponent = class extends import_obsidian141.ValueComponent {
   /**
    * A select element of the component.
    *
@@ -35819,6 +35678,10 @@ var MultipleDropdownComponent = class extends import_obsidian145.ValueComponent
    * The inner dropdown component.
    */
   dropdownComponent;
+  /**
+   * The list of selectable option values, indexed by their position in the dropdown.
+   */
+  values = [];
   simulateChangeCallback;
   /**
    * Creates a new multiple dropdown component.
@@ -35827,9 +35690,8 @@ var MultipleDropdownComponent = class extends import_obsidian145.ValueComponent
    */
   constructor(containerEl) {
     super();
-    this.dropdownComponent = new import_obsidian145.DropdownComponent(containerEl);
-    this.dropdownComponent.selectEl.multiple = true;
-    addPluginCssClasses(containerEl, "multiple-dropdown-component" /* MultipleDropdownComponent */);
+    this.dropdownComponent = new import_obsidian141.DropdownComponent(containerEl);
+    addPluginCssClasses(containerEl, "typed-dropdown-component" /* TypedDropdownComponent */);
   }
   /**
    * Adds an option to the dropdown.
@@ -35839,7 +35701,12 @@ var MultipleDropdownComponent = class extends import_obsidian145.ValueComponent
    * @returns The component.
    */
   addOption(value, display) {
-    this.dropdownComponent.addOption(value, display);
+    let index2 = this.values.indexOf(value);
+    if (index2 === -1) {
+      this.values.push(value);
+      index2 = this.values.length - 1;
+    }
+    this.dropdownComponent.addOption(String(index2), display);
     return this;
   }
   /**
@@ -35849,7 +35716,9 @@ var MultipleDropdownComponent = class extends import_obsidian145.ValueComponent
    * @returns The component.
    */
   addOptions(options) {
-    this.dropdownComponent.addOptions(options);
+    for (const [value, display] of options.entries()) {
+      this.addOption(value, display);
+    }
     return this;
   }
   /**
@@ -35858,7 +35727,7 @@ var MultipleDropdownComponent = class extends import_obsidian145.ValueComponent
    * @returns The value of the component.
    */
   getValue() {
-    return Array.from(this.dropdownComponent.selectEl.selectedOptions).map((o2) => o2.value);
+    return this.values[this.dropdownComponent.selectEl.selectedIndex] ?? null;
   }
   /**
    * Sets the callback function to be called when the component is changed.
@@ -35892,9 +35761,8 @@ var MultipleDropdownComponent = class extends import_obsidian145.ValueComponent
    * @returns The component.
    */
   setValue(value) {
-    for (const option of Array.from(this.dropdownComponent.selectEl.options)) {
-      option.selected = value.includes(option.value);
-    }
+    const index2 = value === null ? -1 : this.values.indexOf(value);
+    this.dropdownComponent.selectEl.selectedIndex = index2;
     return this;
   }
   /**
@@ -35907,160 +35775,91 @@ var MultipleDropdownComponent = class extends import_obsidian145.ValueComponent
   }
 };
 
-// src/obsidian/setting-components/multiple-email-component.ts
-var multiple_email_component_exports = {};
-__export(multiple_email_component_exports, {
-  MultipleEmailComponent: () => MultipleEmailComponent
+// src/obsidian/setting-components/typed-multiple-dropdown-component.ts
+var typed_multiple_dropdown_component_exports = {};
+__export(typed_multiple_dropdown_component_exports, {
+  TypedMultipleDropdownComponent: () => TypedMultipleDropdownComponent
 });
+var import_obsidian142 = require("obsidian");
 init_css_class();
-var MultipleEmailComponent = class extends TypedTextComponent {
+init_plugin_context();
+var TypedMultipleDropdownComponent = class extends import_obsidian142.ValueComponent {
   /**
-   * Creates a new multiple emails component.
+   * A select element of the component.
    *
-   * @param containerEl - The container element of the component.
+   * @returns The select element.
    */
-  constructor(containerEl) {
-    super({
-      containerEl,
-      cssClass: "multiple-email-component" /* MultipleEmailComponent */,
-      type: "email"
-    });
-    this.inputEl.multiple = true;
+  get selectEl() {
+    return this.multipleDropdownComponent.selectEl;
   }
   /**
-   * Converts a string to an email address.
+   * A validator element of the component.
    *
-   * @param str - The string to convert.
-   * @returns The email address.
+   * @returns The validator element.
    */
-  valueFromString(str) {
-    return str.split(",").map((email) => email.trim());
+  get validatorEl() {
+    return this.selectEl;
   }
   /**
-   * Converts an email address to a string.
-   *
-   * @param value - The email address to convert.
-   * @returns The string.
+   * The inner multiple dropdown component.
    */
-  valueToString(value) {
-    return value.join(", ");
-  }
-};
-
-// src/obsidian/setting-components/multiple-file-component.ts
-var multiple_file_component_exports = {};
-__export(multiple_file_component_exports, {
-  MultipleFileComponent: () => MultipleFileComponent
-});
-init_type_guards();
-init_css_class();
-var MultipleFileComponent = class extends TypedTextComponent {
+  multipleDropdownComponent;
   /**
-   * Creates a new multiple file component.
-   *
-   * @param containerEl - The container element of the component.
-   */
-  constructor(containerEl) {
-    super({
-      containerEl,
-      cssClass: "multiple-file-component" /* MultipleFileComponent */,
-      type: "file"
-    });
-    this.inputEl.multiple = true;
-  }
-  /**
-   * Gets the value of the component.
-   *
-   * @returns The value of the component.
-   */
-  getValue() {
-    return Array.from(ensureNonNullable(this.inputEl.files));
-  }
-  /**
-   * Converts a string to a file.
-   *
-   * @returns The file.
-   */
-  valueFromString() {
-    return this.getValue();
-  }
-  /**
-   * Converts a file to a string.
-   *
-   * @param value - The file to convert.
-   * @returns The string.
-   */
-  valueToString(value) {
-    return value[0]?.name ?? "";
-  }
-};
-
-// src/obsidian/setting-components/multiple-text-component.ts
-var multiple_text_component_exports = {};
-__export(multiple_text_component_exports, {
-  MultipleTextComponent: () => MultipleTextComponent
-});
-var import_obsidian146 = require("obsidian");
-init_css_class();
-init_plugin_context();
-var MultipleTextComponent = class extends import_obsidian146.ValueComponent {
-  /**
-   * An input element of the component.
-   *
-   * @returns The input element of the component.
-   */
-  get inputEl() {
-    return this.textAreaComponent.inputEl;
-  }
-  /**
-   * Gets the validator element of the component.
-   *
-   * @returns The validator element of the component.
-   */
-  get validatorEl() {
-    return this.inputEl;
-  }
-  /**
-   * The inner text area component.
+   * The list of selectable option values, indexed by their position in the dropdown.
    */
-  textAreaComponent;
+  values = [];
   simulateChangeCallback;
   /**
-   * Creates a new multiple text component.
+   * Creates a new multiple dropdown component.
    *
    * @param containerEl - The container element of the component.
    */
   constructor(containerEl) {
     super();
-    this.textAreaComponent = new import_obsidian146.TextAreaComponent(containerEl);
-    addPluginCssClasses(containerEl, "multiple-text-component" /* MultipleTextComponent */);
+    this.multipleDropdownComponent = new MultipleDropdownComponent(containerEl);
+    addPluginCssClasses(containerEl, "typed-multiple-dropdown-component" /* TypedMultipleDropdownComponent */);
   }
   /**
-   * Empties the component.
+   * Adds an option to the dropdown.
+   *
+   * @param value - The value of the option.
+   * @param display - The display text of the option.
+   * @returns The component.
    */
-  empty() {
-    this.textAreaComponent.setValue("");
+  addOption(value, display) {
+    let index2 = this.values.indexOf(value);
+    if (index2 === -1) {
+      this.values.push(value);
+      index2 = this.values.length - 1;
+    }
+    this.multipleDropdownComponent.addOption(String(index2), display);
+    return this;
   }
   /**
-   * Gets the value of the component.
+   * Adds multiple options to the dropdown.
    *
-   * @returns The value of the component.
+   * @param options - The options to add.
+   * @returns The component.
    */
-  getValue() {
-    return this.textAreaComponent.getValue().split("\n");
+  addOptions(options) {
+    for (const [value, display] of options.entries()) {
+      this.addOption(value, display);
+    }
+    return this;
   }
   /**
-   * Checks if the component is empty.
+   * Gets the value of the component.
    *
-   * @returns `true` if the component is empty, `false` otherwise.
+   * @returns The value of the component.
    */
-  isEmpty() {
-    return this.textAreaComponent.getValue() === "";
+  getValue() {
+    const indices = this.multipleDropdownComponent.getValue().map((str) => parseInt(str, 10));
+    return indices.map((index2) => this.values[index2]).filter((value) => value !== void 0);
   }
   /**
-   * Adds a change listener to the component.
+   * Sets the callback function to be called when the component is changed.
    *
-   * @param callback - The callback to call when the value changes.
+   * @param callback - The callback function to be called when the component is changed.
    * @returns The component.
    */
   onChange(callback) {
@@ -36068,7 +35867,7 @@ var MultipleTextComponent = class extends import_obsidian146.ValueComponent {
       callback(this.getValue());
     };
     this.simulateChangeCallback = changeHandler;
-    this.textAreaComponent.onChange(changeHandler);
+    this.multipleDropdownComponent.onChange(changeHandler);
     return this;
   }
   /**
@@ -36079,27 +35878,7 @@ var MultipleTextComponent = class extends import_obsidian146.ValueComponent {
    */
   setDisabled(disabled) {
     super.setDisabled(disabled);
-    this.textAreaComponent.setDisabled(disabled);
-    return this;
-  }
-  /**
-   * Sets the placeholder of the component.
-   *
-   * @param placeholder - The placeholder to set.
-   * @returns The component.
-   */
-  setPlaceholder(placeholder) {
-    this.textAreaComponent.setPlaceholder(placeholder);
-    return this;
-  }
-  /**
-   * Sets the placeholder value of the component.
-   *
-   * @param placeholderValue - The placeholder value to set.
-   * @returns The component.
-   */
-  setPlaceholderValue(placeholderValue) {
-    this.setPlaceholder(this.valueToString(placeholderValue));
+    this.multipleDropdownComponent.setDisabled(disabled);
     return this;
   }
   /**
@@ -36109,7 +35888,8 @@ var MultipleTextComponent = class extends import_obsidian146.ValueComponent {
    * @returns The component.
    */
   setValue(value) {
-    this.textAreaComponent.setValue(this.valueToString(value));
+    const indices = value.map((v) => this.values.indexOf(v)).filter((index2) => index2 !== -1);
+    this.multipleDropdownComponent.setValue(indices.map((index2) => String(index2)));
     return this;
   }
   /**
@@ -36120,41 +35900,32 @@ var MultipleTextComponent = class extends import_obsidian146.ValueComponent {
   simulateChange__() {
     this.simulateChangeCallback?.();
   }
-  /**
-   * Converts the value to the string shown in the text area. Subclasses can override to customize the serialization.
-   *
-   * @param value - The value to convert.
-   * @returns The string representation of the value.
-   */
-  valueToString(value) {
-    return value.join("\n");
-  }
 };
 
-// src/obsidian/setting-components/number-component.ts
-var number_component_exports = {};
-__export(number_component_exports, {
-  NumberComponent: () => NumberComponent
+// src/obsidian/setting-components/url-component.ts
+var url_component_exports = {};
+__export(url_component_exports, {
+  UrlComponent: () => UrlComponent
 });
 init_css_class();
-var NumberComponent = class extends TypedRangeTextComponent {
+var UrlComponent = class extends TypedTextComponent {
   /**
-   * Creates a new number component.
+   * Creates a new Url component.
    *
    * @param containerEl - The container element of the component.
    */
   constructor(containerEl) {
     super({
       containerEl,
-      cssClass: "number-component" /* NumberComponent */,
-      type: "number"
+      cssClass: "url-component" /* UrlComponent */,
+      type: "url"
     });
   }
   /**
    * Empties the component.
    */
   empty() {
-    this.textComponent.setValue("");
+    this.setValue("");
   }
   /**
    * Checks if the component is empty.
@@ -36162,17 +35933,7 @@ var NumberComponent = class extends TypedRangeTextComponent {
    * @returns `true` if the component is empty, `false` otherwise.
    */
   isEmpty() {
-    return this.textComponent.getValue() === "";
-  }
-  /**
-   * Sets the placeholder of the component.
-   *
-   * @param placeholder - The placeholder to set.
-   * @returns The component.
-   */
-  setPlaceholder(placeholder) {
-    this.textComponent.setPlaceholder(placeholder);
-    return this;
+    return this.getValue() === "";
   }
   /**
    * Sets the placeholder value of the component.
@@ -36181,808 +35942,1269 @@ var NumberComponent = class extends TypedRangeTextComponent {
    * @returns The component.
    */
   setPlaceholderValue(placeholderValue) {
-    this.textComponent.setPlaceholder(this.valueToString(placeholderValue));
+    this.textComponent.setPlaceholder(placeholderValue);
     return this;
   }
   /**
-   * Converts a string to a number.
+   * Converts a string to an url.
    *
    * @param str - The string to convert.
-   * @returns The number.
+   * @returns The url.
    */
   valueFromString(str) {
-    return parseInt(str, 10);
+    return str;
   }
 };
 
-// src/obsidian/setting-components/password-component.ts
-var password_component_exports = {};
-__export(password_component_exports, {
-  PasswordComponent: () => PasswordComponent
+// src/obsidian/setting-components/week-component.ts
+var week_component_exports = {};
+__export(week_component_exports, {
+  WeekComponent: () => WeekComponent
 });
+var import_obsidian143 = require("obsidian");
 init_css_class();
-var PasswordComponent = class extends TypedTextComponent {
+var moment6 = extractDefaultExportInterop(import_obsidian143.moment);
+var DATE_FORMAT3 = "YYYY-[W]WW";
+var WeekComponent = class extends TypedRangeTextComponent {
   /**
-   * Creates a new password component.
+   * Creates a new Week component.
    *
    * @param containerEl - The container element of the component.
    */
   constructor(containerEl) {
     super({
       containerEl,
-      cssClass: "password-component" /* PasswordComponent */,
-      type: "password"
+      cssClass: "week-component" /* WeekComponent */,
+      type: "week"
     });
   }
   /**
-   * Sets the placeholder value of the component.
+   * Converts a string to a Week.
    *
-   * @param placeholder - The placeholder to set.
-   * @returns The component.
+   * @param str - The string to convert.
+   * @returns The week.
    */
-  setPlaceholder(placeholder) {
-    this.textComponent.setPlaceholder(placeholder);
-    return this;
+  valueFromString(str) {
+    const parsed = moment6(str, DATE_FORMAT3);
+    if (!parsed.isValid()) {
+      throw new Error("Invalid week");
+    }
+    return {
+      weekNumber: parsed.isoWeek(),
+      year: parsed.year()
+    };
   }
   /**
-   * Gets the value from a string.
+   * Converts a week to a string.
    *
-   * @param str - The string to get the value from.
-   * @returns The value from the string.
+   * @param value - The week to convert.
+   * @returns The string.
    */
-  valueFromString(str) {
-    return str;
+  valueToString(value) {
+    const date = moment6().year(value.year).isoWeek(value.weekNumber);
+    return date.format(DATE_FORMAT3);
   }
 };
 
-// src/obsidian/setting-components/telephone-component.ts
-var telephone_component_exports = {};
-__export(telephone_component_exports, {
-  TelephoneComponent: () => TelephoneComponent
-});
-init_css_class();
-var TelephoneComponent = class extends TypedTextComponent {
+// src/obsidian/setting-ex.ts
+var SettingEx = class extends import_obsidian144.Setting {
   /**
-   * Creates a new telephone component.
+   * Adds a {@link CheckboxComponent} to the setting.
    *
-   * @param containerEl - The container element of the component.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  constructor(containerEl) {
-    super({
-      containerEl,
-      cssClass: "telephone-component" /* TelephoneComponent */,
-      type: "tel"
-    });
+  addCheckbox(cb) {
+    return this.addComponentClass(CheckboxComponent, cb);
   }
   /**
-   * Empties the component.
+   * Adds a {@link CodeHighlighterComponent} to the setting.
+   *
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  empty() {
-    this.textComponent.setValue("");
+  addCodeHighlighter(cb) {
+    return this.addComponentClass(CodeHighlighterComponent, cb);
   }
   /**
-   * Checks if the component is empty.
+   * Adds a component to the setting.
    *
-   * @returns `true` if the component is empty, `false` otherwise.
+   * @typeParam T - The type of the component to add.
+   * @param componentClass - The class of the component to add.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  isEmpty() {
-    return this.textComponent.getValue() === "";
+  addComponentClass(componentClass, cb) {
+    return this.addComponent((el) => {
+      const component = new componentClass(el);
+      cb(component);
+      return component;
+    });
   }
   /**
-   * Sets the placeholder value of the component.
+   * Adds a {@link DateComponent} to the setting.
    *
-   * @param placeholderValue - The placeholder value to set.
-   * @returns The component.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  setPlaceholderValue(placeholderValue) {
-    this.textComponent.setPlaceholder(placeholderValue);
-    return this;
+  addDate(cb) {
+    return this.addComponentClass(DateComponent, cb);
   }
   /**
-   * Gets the value from a string.
+   * Adds a {@link DateTimeComponent} to the setting.
    *
-   * @param str - The string to get the value from.
-   * @returns The value from the string.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  valueFromString(str) {
-    return str;
+  addDateTime(cb) {
+    return this.addComponentClass(DateTimeComponent, cb);
   }
-};
-
-// src/obsidian/setting-components/time-component.ts
-var time_component_exports = {};
-__export(time_component_exports, {
-  TimeComponent: () => TimeComponent
-});
-var import_obsidian147 = require("obsidian");
-init_css_class();
-var TimeComponent = class extends TypedRangeTextComponent {
   /**
-   * Creates a new time component.
+   * Adds an {@link EmailComponent} to the setting.
    *
-   * @param containerEl - The container element of the component.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  constructor(containerEl) {
-    super({
-      containerEl,
-      cssClass: "time-component" /* TimeComponent */,
-      type: "time"
-    });
+  addEmail(cb) {
+    return this.addComponentClass(EmailComponent, cb);
   }
   /**
-   * Converts a string to a time.
+   * Adds a {@link FileComponent} to the setting.
    *
-   * @param str - The string to convert.
-   * @returns The date.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  valueFromString(str) {
-    return import_obsidian147.moment.duration(str);
+  addFile(cb) {
+    return this.addComponentClass(FileComponent, cb);
   }
   /**
-   * Converts a time to a string.
+   * Adds a {@link MonthComponent} to the setting.
    *
-   * @param value - The time to convert.
-   * @returns The string.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  valueToString(value) {
-    let format2;
-    if (value.milliseconds() > 0) {
-      format2 = "HH:mm:ss.SSS";
-    } else if (value.seconds() > 0) {
-      format2 = "HH:mm:ss";
-    } else {
-      format2 = "HH:mm";
-    }
-    return import_obsidian147.moment.utc(value.asMilliseconds()).format(format2);
+  addMonth(cb) {
+    return this.addComponentClass(MonthComponent, cb);
   }
-};
-
-// src/obsidian/setting-components/tri-state-checkbox-component.ts
-var tri_state_checkbox_component_exports = {};
-__export(tri_state_checkbox_component_exports, {
-  TriStateCheckboxComponent: () => TriStateCheckboxComponent
-});
-var import_obsidian148 = require("obsidian");
-init_css_class();
-init_plugin_context();
-var TriStateCheckboxComponent = class extends import_obsidian148.ValueComponent {
   /**
-   * An input element of the checkbox.
-   */
-  inputEl;
-  /**
-   * A validator element of the checkbox.
+   * Adds a {@link MultipleDropdownComponent} to the setting.
    *
-   * @returns The validator element.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  get validatorEl() {
-    return this.inputEl;
+  addMultipleDropdown(cb) {
+    return this.addComponentClass(MultipleDropdownComponent, cb);
   }
-  changeCallback;
   /**
-   * Creates a new tri-state checkbox component.
+   * Adds a {@link MultipleEmailComponent} to the setting.
    *
-   * @param containerEl - The container element.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  constructor(containerEl) {
-    super();
-    addPluginCssClasses(containerEl, "tri-state-checkbox-component" /* TriStateCheckboxComponent */);
-    this.inputEl = containerEl.createEl("input", { type: "checkbox" });
-    this.inputEl.addEventListener("change", this.onChanged.bind(this));
+  addMultipleEmail(cb) {
+    return this.addComponentClass(MultipleEmailComponent, cb);
   }
   /**
-   * Gets the value of the checkbox.
+   * Adds a {@link MultipleFileComponent} to the setting.
    *
-   * @returns The value of the checkbox.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  getValue() {
-    return this.inputEl.indeterminate ? null : this.inputEl.checked;
+  addMultipleFile(cb) {
+    return this.addComponentClass(MultipleFileComponent, cb);
   }
   /**
-   * Sets the callback to be called when the checkbox is changed.
+   * Adds a {@link MultipleTextComponent} to the setting.
    *
-   * @param callback - The callback to be called when the checkbox is changed.
-   * @returns The component.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  onChange(callback) {
-    this.changeCallback = callback;
-    return this;
+  addMultipleText(cb) {
+    return this.addComponentClass(MultipleTextComponent, cb);
   }
   /**
-   * Called when the checkbox is changed.
+   * Adds a {@link NumberComponent} to the setting.
+   *
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  onChanged() {
-    this.changeCallback?.(this.getValue());
+  addNumber(cb) {
+    return this.addComponentClass(NumberComponent, cb);
   }
   /**
-   * Sets the disabled state of the checkbox.
+   * Adds a {@link PasswordComponent} to the setting.
    *
-   * @param disabled - The disabled state of the checkbox.
-   * @returns The component.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  setDisabled(disabled) {
-    super.setDisabled(disabled);
-    this.inputEl.disabled = disabled;
-    return this;
+  addPassword(cb) {
+    return this.addComponentClass(PasswordComponent, cb);
   }
   /**
-   * Sets the value of the checkbox.
+   * Adds a {@link TelephoneComponent} to the setting.
    *
-   * @param value - The value to set the checkbox to.
-   * @returns The component.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  setValue(value) {
-    this.inputEl.indeterminate = value === null;
-    this.inputEl.checked = value ?? false;
-    return this;
+  addTelephone(cb) {
+    return this.addComponentClass(TelephoneComponent, cb);
   }
-};
-
-// src/obsidian/setting-components/typed-dropdown-component.ts
-var typed_dropdown_component_exports = {};
-__export(typed_dropdown_component_exports, {
-  TypedDropdownComponent: () => TypedDropdownComponent
-});
-var import_obsidian149 = require("obsidian");
-init_css_class();
-init_plugin_context();
-var TypedDropdownComponent = class extends import_obsidian149.ValueComponent {
   /**
-   * A select element of the component.
+   * Adds a {@link TimeComponent} to the setting.
    *
-   * @returns The select element.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  get selectEl() {
-    return this.dropdownComponent.selectEl;
+  addTime(cb) {
+    return this.addComponentClass(TimeComponent, cb);
   }
   /**
-   * A validator element of the component.
+   * Adds a {@link TriStateCheckboxComponent} to the setting.
    *
-   * @returns The validator element.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  get validatorEl() {
-    return this.selectEl;
+  addTriStateCheckbox(cb) {
+    return this.addComponentClass(TriStateCheckboxComponent, cb);
   }
   /**
-   * The inner dropdown component.
-   */
-  dropdownComponent;
-  /**
-   * The list of selectable option values, indexed by their position in the dropdown.
+   * Adds a {@link TypedDropdownComponent} to the setting.
+   *
+   * @typeParam T - The type of the dropdown items.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  values = [];
-  simulateChangeCallback;
+  addTypedDropdown(cb) {
+    return this.addComponentClass(TypedDropdownComponent, cb);
+  }
   /**
-   * Creates a new multiple dropdown component.
+   * Adds a {@link TypedMultipleDropdownComponent} to the setting.
    *
-   * @param containerEl - The container element of the component.
+   * @typeParam T - The type of the items in the dropdown.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  constructor(containerEl) {
-    super();
-    this.dropdownComponent = new import_obsidian149.DropdownComponent(containerEl);
-    addPluginCssClasses(containerEl, "typed-dropdown-component" /* TypedDropdownComponent */);
+  addTypedMultipleDropdown(cb) {
+    return this.addComponentClass(TypedMultipleDropdownComponent, cb);
   }
   /**
-   * Adds an option to the dropdown.
+   * Adds an {@link UrlComponent} to the setting.
    *
-   * @param value - The value of the option.
-   * @param display - The display text of the option.
-   * @returns The component.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  addOption(value, display) {
-    let index2 = this.values.indexOf(value);
-    if (index2 === -1) {
-      this.values.push(value);
-      index2 = this.values.length - 1;
-    }
-    this.dropdownComponent.addOption(String(index2), display);
-    return this;
+  addUrl(cb) {
+    return this.addComponentClass(UrlComponent, cb);
   }
   /**
-   * Adds multiple options to the dropdown.
+   * Adds a {@link WeekComponent} to the setting.
    *
-   * @param options - The options to add.
-   * @returns The component.
-   */
-  addOptions(options) {
-    for (const [value, display] of options.entries()) {
-      this.addOption(value, display);
-    }
-    return this;
-  }
-  /**
-   * Gets the value of the component.
-   *
-   * @returns The value of the component.
-   */
-  getValue() {
-    return this.values[this.dropdownComponent.selectEl.selectedIndex] ?? null;
-  }
-  /**
-   * Sets the callback function to be called when the component is changed.
-   *
-   * @param callback - The callback function to be called when the component is changed.
-   * @returns The component.
-   */
-  onChange(callback) {
-    const changeHandler = () => {
-      callback(this.getValue());
-    };
-    this.simulateChangeCallback = changeHandler;
-    this.dropdownComponent.onChange(changeHandler);
-    return this;
-  }
-  /**
-   * Sets the disabled state of the component.
-   *
-   * @param disabled - The disabled state to set.
-   * @returns The component.
-   */
-  setDisabled(disabled) {
-    super.setDisabled(disabled);
-    this.dropdownComponent.setDisabled(disabled);
-    return this;
-  }
-  /**
-   * Sets the value of the component.
-   *
-   * @param value - The value to set.
-   * @returns The component.
-   */
-  setValue(value) {
-    const index2 = value === null ? -1 : this.values.indexOf(value);
-    this.dropdownComponent.selectEl.selectedIndex = index2;
-    return this;
-  }
-  /**
-   * Simulate a change event.
-   *
-   * @deprecated Use only from tests to simulate a change event.
+   * @param cb - The callback to call with the component.
+   * @returns The setting instance.
    */
-  simulateChange__() {
-    this.simulateChangeCallback?.();
+  addWeek(cb) {
+    return this.addComponentClass(WeekComponent, cb);
   }
 };
+function adoptSettingEx(setting) {
+  if (setting instanceof SettingEx) {
+    return setting;
+  }
+  Object.setPrototypeOf(setting, SettingEx.prototype);
+  return castTo(setting);
+}
 
-// src/obsidian/setting-components/typed-multiple-dropdown-component.ts
-var typed_multiple_dropdown_component_exports = {};
-__export(typed_multiple_dropdown_component_exports, {
-  TypedMultipleDropdownComponent: () => TypedMultipleDropdownComponent
+// src/obsidian/validation.ts
+var validation_exports = {};
+__export(validation_exports, {
+  OBSIDIAN_UNSAFE_FILENAME_CHARS: () => OBSIDIAN_UNSAFE_FILENAME_CHARS,
+  UNIX_UNSAFE_PATH_CHARS: () => UNIX_UNSAFE_PATH_CHARS,
+  WINDOWS_UNSAFE_PATH_CHARS: () => WINDOWS_UNSAFE_PATH_CHARS,
+  getOsAndObsidianUnsafePathCharsRegExp: () => getOsAndObsidianUnsafePathCharsRegExp,
+  getOsUnsafePathCharsRegExp: () => getOsUnsafePathCharsRegExp,
+  isValidationMessageHolder: () => isValidationMessageHolder
 });
-var import_obsidian150 = require("obsidian");
-init_css_class();
+var import_obsidian145 = require("obsidian");
+init_reg_exp();
+function isValidationMessageHolder(value) {
+  return value.validationMessage !== void 0;
+}
+var OBSIDIAN_UNSAFE_FILENAME_CHARS = /[#^[\]|]/g;
+var WINDOWS_UNSAFE_PATH_CHARS = /[*\\/<>:|?"]/g;
+var UNIX_UNSAFE_PATH_CHARS = /[\0/]/g;
+function getOsAndObsidianUnsafePathCharsRegExp(isWindows) {
+  return oneOf([
+    getOsUnsafePathCharsRegExp(isWindows),
+    OBSIDIAN_UNSAFE_FILENAME_CHARS
+  ]);
+}
+function getOsUnsafePathCharsRegExp(isWindows) {
+  isWindows ??= import_obsidian145.Platform.isWin;
+  return isWindows ? WINDOWS_UNSAFE_PATH_CHARS : UNIX_UNSAFE_PATH_CHARS;
+}
+
+// src/obsidian/plugin/plugin-settings-tab.ts
 init_plugin_context();
-var TypedMultipleDropdownComponent = class extends import_obsidian150.ValueComponent {
-  /**
-   * A select element of the component.
-   *
-   * @returns The select element.
-   */
-  get selectEl() {
-    return this.multipleDropdownComponent.selectEl;
-  }
-  /**
-   * A validator element of the component.
-   *
-   * @returns The validator element.
-   */
-  get validatorEl() {
-    return this.selectEl;
-  }
-  /**
-   * The inner multiple dropdown component.
-   */
-  multipleDropdownComponent;
-  /**
-   * The list of selectable option values, indexed by their position in the dropdown.
-   */
-  values = [];
-  simulateChangeCallback;
+var SAVE_TO_FILE_CONTEXT = "PluginSettingsTab";
+var PluginSettingsTabEventsComponent = class extends ComponentEx {
+  params;
   /**
-   * Creates a new multiple dropdown component.
+   * Creates a new component.
    *
-   * @param containerEl - The container element of the component.
+   * @param params - The params.
    */
-  constructor(containerEl) {
+  constructor(params) {
     super();
-    this.multipleDropdownComponent = new MultipleDropdownComponent(containerEl);
-    addPluginCssClasses(containerEl, "typed-multiple-dropdown-component" /* TypedMultipleDropdownComponent */);
-  }
-  /**
-   * Adds an option to the dropdown.
-   *
-   * @param value - The value of the option.
-   * @param display - The display text of the option.
-   * @returns The component.
-   */
-  addOption(value, display) {
-    let index2 = this.values.indexOf(value);
-    if (index2 === -1) {
-      this.values.push(value);
-      index2 = this.values.length - 1;
-    }
-    this.multipleDropdownComponent.addOption(String(index2), display);
-    return this;
-  }
-  /**
-   * Adds multiple options to the dropdown.
-   *
-   * @param options - The options to add.
-   * @returns The component.
-   */
-  addOptions(options) {
-    for (const [value, display] of options.entries()) {
-      this.addOption(value, display);
-    }
-    return this;
+    this.params = params;
   }
   /**
-   * Gets the value of the component.
-   *
-   * @returns The value of the component.
+   * Subscribes to the settings component's events.
    */
-  getValue() {
-    const indices = this.multipleDropdownComponent.getValue().map((str) => parseInt(str, 10));
-    return indices.map((index2) => this.values[index2]).filter((value) => value !== void 0);
+  onload() {
+    super.onload();
+    const { pluginSettingsComponent } = this.params;
+    registerAsyncEvent(this, pluginSettingsComponent.on("loadSettings", (loadedState, isInitialLoad) => this.params.onLoadSettings(loadedState, isInitialLoad)));
+    registerAsyncEvent(this, pluginSettingsComponent.on("saveSettings", (newState, oldState, context) => this.params.onSaveSettings(newState, oldState, context)));
   }
+};
+var PluginSettingsTabBase = class extends mixinAsyncEvents()(import_obsidian146.PluginSettingTab) {
   /**
-   * Sets the callback function to be called when the component is changed.
+   * Whether the plugin settings tab is open.
    *
-   * @param callback - The callback function to be called when the component is changed.
-   * @returns The component.
+   * @returns Whether the plugin settings tab is open.
    */
-  onChange(callback) {
-    const changeHandler = () => {
-      callback(this.getValue());
-    };
-    this.simulateChangeCallback = changeHandler;
-    this.multipleDropdownComponent.onChange(changeHandler);
-    return this;
+  get isOpen() {
+    return this._isOpen;
   }
   /**
-   * Sets the disabled state of the component.
-   *
-   * @param disabled - The disabled state to set.
-   * @returns The component.
+   * The settings manager.
    */
-  setDisabled(disabled) {
-    super.setDisabled(disabled);
-    this.multipleDropdownComponent.setDisabled(disabled);
-    return this;
-  }
+  pluginSettingsComponent;
   /**
-   * Sets the value of the component.
+   * A debounce timeout for saving settings.
    *
-   * @param value - The value to set.
-   * @returns The component.
+   * @returns The debounce timeout for saving settings.
    */
-  setValue(value) {
-    const indices = value.map((v) => this.values.indexOf(v)).filter((index2) => index2 !== -1);
-    this.multipleDropdownComponent.setValue(indices.map((index2) => String(index2)));
-    return this;
+  get saveSettingsDebounceTimeoutInMilliseconds() {
+    const DEFAULT = 2e3;
+    return DEFAULT;
   }
-  /**
-   * Simulate a change event.
-   *
-   * @deprecated Use only from tests to simulate a change event.
-   */
-  simulateChange__() {
-    this.simulateChangeCallback?.();
+  _isOpen = false;
+  component;
+  currentRenderComponent = null;
+  saveSettingsDebounced;
+  get pluginSettings() {
+    return this.pluginSettingsComponent.settingsState.inputValues;
   }
-};
-
-// src/obsidian/setting-components/url-component.ts
-var url_component_exports = {};
-__export(url_component_exports, {
-  UrlComponent: () => UrlComponent
-});
-init_css_class();
-var UrlComponent = class extends TypedTextComponent {
   /**
-   * Creates a new Url component.
+   * Creates a new plugin settings tab.
    *
-   * @param containerEl - The container element of the component.
+   * @param params - The params.
    */
-  constructor(containerEl) {
-    super({
-      containerEl,
-      cssClass: "url-component" /* UrlComponent */,
-      type: "url"
+  constructor(params) {
+    super(params.plugin.app, params.plugin);
+    this.pluginSettingsComponent = params.pluginSettingsComponent;
+    addPluginCssClasses(this.containerEl, "plugin-settings-tab" /* PluginSettingsTab */);
+    this.saveSettingsDebounced = (0, import_obsidian146.debounce)(
+      convertAsyncToSync(() => this.pluginSettingsComponent.saveToFile(SAVE_TO_FILE_CONTEXT)),
+      this.saveSettingsDebounceTimeoutInMilliseconds
+    );
+    this.component = new PluginSettingsTabEventsComponent({
+      onLoadSettings: (loadedState, isInitialLoad) => this.onLoadSettings(loadedState, isInitialLoad),
+      onSaveSettings: (newState, oldState, context) => this.onSaveSettings({ context, newState, oldState }),
+      pluginSettingsComponent: this.pluginSettingsComponent
     });
   }
   /**
-   * Empties the component.
-   */
-  empty() {
-    this.setValue("");
-  }
-  /**
-   * Checks if the component is empty.
+   * Binds a value component to a plugin setting.
    *
-   * @returns `true` if the component is empty, `false` otherwise.
-   */
-  isEmpty() {
-    return this.getValue() === "";
+   * @typeParam UIValue - The type of the value of the UI component.
+   * @typeParam TValueComponent - The type of the value component.
+   * @typeParam PropertyName - The property name of the plugin settings to bind to.
+   * @param params - The params for binding the value component.
+   * @returns The value component.
+   */
+  bind(params) {
+    const {
+      propertyName,
+      valueComponent,
+      ...options
+    } = params;
+    const DEFAULT_OPTIONS = {
+      componentToPluginSettingsValueConverter: (value) => value,
+      onChanged: noop,
+      pluginSettingsToComponentValueConverter: (value) => value,
+      shouldResetSettingWhenComponentIsEmpty: true,
+      shouldShowPlaceholderForDefaultValues: true,
+      shouldShowValidationMessage: true
+    };
+    const optionsExt = { ...DEFAULT_OPTIONS, ...options };
+    const validatorEl = getValidatorComponent(valueComponent)?.validatorEl;
+    const textBasedComponent = getTextBasedComponentValue(valueComponent);
+    const readonlyValue = this.getPluginSettingsProperty(propertyName);
+    const defaults = this.pluginSettingsComponent.defaultSettings;
+    const defaultValue = defaults[propertyName];
+    const defaultComponentValue = optionsExt.pluginSettingsToComponentValueConverter(defaultValue);
+    textBasedComponent?.setPlaceholderValue(defaultComponentValue);
+    let validationMessage;
+    let tooltipEl = null;
+    let tooltipContentEl = null;
+    if (validatorEl) {
+      const wrapper = ensureWrapped(validatorEl);
+      tooltipEl = wrapper.createDiv();
+      addPluginCssClasses(tooltipEl, ["tooltip" /* Tooltip */, "tooltip-validator" /* TooltipValidator */]);
+      tooltipContentEl = tooltipEl.createSpan();
+      const tooltipArrowEl = tooltipEl.createDiv();
+      addPluginCssClasses(tooltipArrowEl, "tooltip-arrow" /* TooltipArrow */);
+      tooltipEl.hide();
+      wrapper.appendChild(tooltipEl);
+    }
+    registerAsyncEvent(
+      this.getRenderComponent(),
+      this.on("validationMessageChanged", (anotherPropertyName, anotherValidationMessage) => {
+        if (propertyName !== anotherPropertyName) {
+          return;
+        }
+        validationMessage = anotherValidationMessage;
+        updateValidatorElDebounced();
+      })
+    );
+    let shouldEmptyOnBlur = false;
+    let shouldRevertToDefaultValueOnBlur = false;
+    if (textBasedComponent && optionsExt.shouldShowPlaceholderForDefaultValues && deepEqual(readonlyValue, defaultValue)) {
+      textBasedComponent.empty();
+    } else {
+      valueComponent.setValue(optionsExt.pluginSettingsToComponentValueConverter(readonlyValue));
+    }
+    let shouldSkipOnChange = false;
+    const UPDATE_VALIDATOR_EL_TIMEOUT_IN_MILLISECONDS = 100;
+    const updateValidatorElDebounced = (0, import_obsidian146.debounce)(() => {
+      window.requestAnimationFrame(() => {
+        updateValidatorEl();
+      });
+    }, UPDATE_VALIDATOR_EL_TIMEOUT_IN_MILLISECONDS);
+    valueComponent.onChange(convertAsyncToSync(async (uiValue) => {
+      if (shouldSkipOnChange) {
+        shouldSkipOnChange = false;
+        return;
+      }
+      shouldEmptyOnBlur = false;
+      const oldValue = this.getPluginSettingsProperty(propertyName);
+      let newValue = void 0;
+      let shouldSetProperty = true;
+      shouldRevertToDefaultValueOnBlur = !!textBasedComponent?.isEmpty() && optionsExt.shouldResetSettingWhenComponentIsEmpty;
+      if (shouldRevertToDefaultValueOnBlur) {
+        newValue = defaultValue;
+      } else {
+        const convertedValue = optionsExt.componentToPluginSettingsValueConverter(uiValue);
+        if (isValidationMessageHolder(convertedValue)) {
+          validationMessage = convertedValue.validationMessage;
+          shouldSetProperty = false;
+        } else {
+          newValue = convertedValue;
+        }
+      }
+      if (shouldSetProperty) {
+        validationMessage = await this.pluginSettingsComponent.setProperty(propertyName, newValue);
+        if (textBasedComponent && optionsExt.shouldShowPlaceholderForDefaultValues && !textBasedComponent.isEmpty() && deepEqual(newValue, defaultValue)) {
+          shouldEmptyOnBlur = true;
+        }
+      }
+      updateValidatorElDebounced();
+      if (shouldSetProperty) {
+        await optionsExt.onChanged(newValue, oldValue);
+      }
+      this.saveSettingsDebounced();
+    }));
+    validatorEl?.addEventListener("focus", () => {
+      updateValidatorElDebounced();
+    });
+    validatorEl?.addEventListener("blur", () => {
+      updateValidatorElDebounced();
+    });
+    validatorEl?.addEventListener("click", () => {
+      window.requestAnimationFrame(() => {
+        updateValidatorElDebounced();
+      });
+    });
+    const validationMessages = this.pluginSettingsComponent.settingsState.validationMessages;
+    validationMessage = validationMessages[propertyName] ?? "";
+    updateValidatorElDebounced();
+    return valueComponent;
+    function updateValidatorEl() {
+      if (!validatorEl?.isActiveElement()) {
+        if (shouldEmptyOnBlur) {
+          shouldEmptyOnBlur = false;
+          if (!textBasedComponent?.isEmpty()) {
+            shouldSkipOnChange = true;
+            textBasedComponent?.empty();
+          }
+        } else if (shouldRevertToDefaultValueOnBlur) {
+          shouldRevertToDefaultValueOnBlur = false;
+          if (textBasedComponent?.isEmpty()) {
+            shouldSkipOnChange = true;
+            valueComponent.setValue(defaultComponentValue);
+          }
+        }
+      }
+      if (!validatorEl) {
+        return;
+      }
+      assertNonNullable(tooltipContentEl);
+      if (validationMessage === "") {
+        validatorEl.setCustomValidity("");
+        validatorEl.checkValidity();
+        validationMessage = validatorEl.validationMessage;
+      }
+      validatorEl.setCustomValidity(validationMessage);
+      if (optionsExt.shouldShowValidationMessage) {
+        tooltipContentEl.textContent = validationMessage;
+        tooltipEl?.toggle(!!validationMessage);
+      } else if (validationMessage) {
+        (0, import_obsidian146.setTooltip)(validatorEl, validationMessage);
+      }
+    }
   }
   /**
-   * Sets the placeholder value of the component.
-   *
-   * @param placeholderValue - The placeholder value to set.
-   * @returns The component.
+   * Renders the plugin settings tab.
    */
-  setPlaceholderValue(placeholderValue) {
-    this.textComponent.setPlaceholder(placeholderValue);
-    return this;
+  display() {
+    this.displayLegacy();
   }
   /**
-   * Converts a string to an url.
+   * Legacy way to render the plugin settings tab imperatively.
    *
-   * @param str - The string to convert.
-   * @returns The url.
+   * The pre-declarative fallback: Obsidian only calls it when {@link getSettingDefinitions} returns an empty
+   * array, i.e. when the consumer has not overridden {@link getSettingDefinitionItems}. Such a consumer
+   * overrides this method and builds the UI with {@link SettingEx} and {@link bind}.
    */
-  valueFromString(str) {
-    return str;
+  displayLegacy() {
+    this.beginRenderCycle();
+    this.containerEl.empty();
   }
-};
-
-// src/obsidian/setting-components/value-component-with-change-tracking.ts
-var value_component_with_change_tracking_exports = {};
-
-// src/obsidian/setting-components/week-component.ts
-var week_component_exports = {};
-__export(week_component_exports, {
-  WeekComponent: () => WeekComponent
-});
-var import_obsidian151 = require("obsidian");
-init_css_class();
-var moment6 = extractDefaultExportInterop(import_obsidian151.moment);
-var DATE_FORMAT3 = "YYYY-[W]WW";
-var WeekComponent = class extends TypedRangeTextComponent {
   /**
-   * Creates a new Week component.
+   * Reads the value backing a native `control` setting definition.
    *
-   * @param containerEl - The container element of the component.
+   * Obsidian calls it on every render of a `control`-type definition. The inherited implementation reads
+   * `plugin.settings`, which a plugin built on {@link PluginSettingsComponentBase} never populates, so it is
+   * routed to the settings component instead.
+   *
+   * @param key - The settings property name.
+   * @returns The current value.
    */
-  constructor(containerEl) {
-    super({
-      containerEl,
-      cssClass: "week-component" /* WeekComponent */,
-      type: "week"
-    });
+  getControlValue(key) {
+    return this.getPluginSettingsProperty(castTo(key));
   }
   /**
-   * Converts a string to a Week.
+   * Returns the declarative setting definitions rendered by Obsidian 1.13+.
    *
-   * @param str - The string to convert.
-   * @returns The week.
+   * Delegates to {@link getSettingDefinitionItems}. When a consumer has not overridden that hook it returns
+   * an empty array, and Obsidian falls back to the imperative {@link displayLegacy} path.
+   *
+   * @returns The setting definitions.
    */
-  valueFromString(str) {
-    const parsed = moment6(str, DATE_FORMAT3);
-    if (!parsed.isValid()) {
-      throw new Error("Invalid week");
-    }
-    return {
-      weekNumber: parsed.isoWeek(),
-      year: parsed.year()
-    };
+  getSettingDefinitions() {
+    return this.getSettingDefinitionItems();
   }
   /**
-   * Converts a week to a string.
-   *
-   * @param value - The week to convert.
-   * @returns The string.
+   * Hides the plugin settings tab.
    */
-  valueToString(value) {
-    const date = moment6().year(value.year).isoWeek(value.weekNumber);
-    return date.format(DATE_FORMAT3);
+  hide() {
+    super.hide();
+    this.saveSettingsDebounced.cancel();
+    this._isOpen = false;
+    this.endRenderCycle();
+    this.component.unload();
+    invokeAsyncSafely(() => this.hideAsync());
   }
-};
-
-// src/obsidian/setting-ex.ts
-var setting_ex_exports = {};
-__export(setting_ex_exports, {
-  SettingEx: () => SettingEx
-});
-var import_obsidian152 = require("obsidian");
-var SettingEx = class extends import_obsidian152.Setting {
   /**
-   * Adds a {@link CheckboxComponent} to the setting.
+   * Async actions to perform when the settings tab is being hidden.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * @returns A {@link Promise} that resolves when the settings tab is hidden.
    */
-  addCheckbox(cb) {
-    return this.addComponentClass(CheckboxComponent, cb);
+  async hideAsync() {
+    await this.pluginSettingsComponent.saveToFile(SAVE_TO_FILE_CONTEXT);
   }
   /**
-   * Adds a {@link CodeHighlighterComponent} to the setting.
+   * Re-renders the settings tab after the underlying state changed.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * Rebuilds the definitions and re-renders, which covers both paths: Obsidian renders the declarative
+   * definitions when {@link getSettingDefinitionItems} provides them, and falls back to
+   * {@link displayLegacy} when it does not. Nothing is rendered while the tab is not the one on screen.
+   *
+   * Use it only for changes that alter the STRUCTURE of the tab — rows added or removed. When only a
+   * {@link PluginSettingsTabBaseSettingExParams.disabled} / {@link PluginSettingsTabBaseSettingExParams.visible}
+   * predicate has to be re-evaluated, call the much cheaper {@link refreshDomState} instead, which toggles the
+   * rendered DOM in place.
    */
-  addCodeHighlighter(cb) {
-    return this.addComponentClass(CodeHighlighterComponent, cb);
+  refresh() {
+    this.update();
   }
   /**
-   * Adds a component to the setting.
+   * Persists the value of a native `control` setting definition.
    *
-   * @typeParam T - The type of the component to add.
-   * @param componentClass - The class of the component to add.
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * The counterpart of {@link getControlValue}: it routes the write to the settings component instead of the
+   * inherited `plugin.saveData` path, so validation, transformers and the debounced save all apply as they do
+   * for a {@link bind}-ed component.
+   *
+   * @param key - The settings property name.
+   * @param value - The value to persist.
+   * @returns A {@link Promise} that resolves when the value is set.
    */
-  addComponentClass(componentClass, cb) {
-    return this.addComponent((el) => {
-      const component = new componentClass(el);
-      cb(component);
-      return component;
-    });
+  async setControlValue(key, value) {
+    await this.pluginSettingsComponent.setProperty(castTo(key), castTo(value));
+    this.saveSettingsDebounced();
   }
   /**
-   * Adds a {@link DateComponent} to the setting.
-   *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * Shows the plugin settings tab.
    */
-  addDate(cb) {
-    return this.addComponentClass(DateComponent, cb);
+  show() {
+    this.app.setting.openTab(this);
   }
   /**
-   * Adds a {@link DateTimeComponent} to the setting.
+   * The declarative setting definitions for the tab (Obsidian 1.13+).
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * Consumers override this, typically building each row with {@link settingEx} and {@link bind} and grouping
+   * them with `settingGroupEx`. Returning an empty array — the default — makes Obsidian fall back to the
+   * imperative {@link displayLegacy} path.
+   *
+   * MUST be a pure builder. Obsidian calls it when the tab is registered (`addSettingTab`), long before the
+   * tab is ever opened, in order to index the settings for search. Anything with a side effect belongs inside
+   * a row's {@link PluginSettingsTabBaseSettingExParams.render} callback, which runs only when the row is
+   * actually rendered.
+   *
+   * @returns The setting definitions.
    */
-  addDateTime(cb) {
-    return this.addComponentClass(DateTimeComponent, cb);
+  getSettingDefinitionItems() {
+    return [];
   }
   /**
-   * Adds an {@link EmailComponent} to the setting.
+   * Called when the plugin settings are loaded.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * @param _loadedState - The loaded settings state.
+   * @param _isInitialLoad - Whether the settings are being loaded for the first time.
+   * @returns A {@link Promise} that resolves when the settings are loaded.
    */
-  addEmail(cb) {
-    return this.addComponentClass(EmailComponent, cb);
+  async onLoadSettings(_loadedState, _isInitialLoad) {
+    this.refresh();
+    await noopAsync();
   }
   /**
-   * Adds a {@link FileComponent} to the setting.
+   * Revalidates the settings.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * @returns A {@link Promise} that resolves when the settings are revalidated.
    */
-  addFile(cb) {
-    return this.addComponentClass(FileComponent, cb);
+  async revalidate() {
+    const validationMessages = await this.pluginSettingsComponent.revalidate();
+    await this.updateValidations(validationMessages);
   }
   /**
-   * Adds a {@link MonthComponent} to the setting.
+   * Builds a search-indexable declarative row that is rendered imperatively.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * The bridge between the declarative API and ODU's imperative building blocks: Obsidian owns the row (so it
+   * indexes it for search and evaluates its {@link PluginSettingsTabBaseSettingExParams.visible} /
+   * {@link PluginSettingsTabBaseSettingExParams.disabled} predicates on every
+   * {@link refreshDomState}), while {@link PluginSettingsTabBaseSettingExParams.render} fills it in with
+   * {@link SettingEx} adders and {@link bind} exactly as an imperative tab would.
+   *
+   * @param params - The row params.
+   * @returns The setting definition.
    */
-  addMonth(cb) {
-    return this.addComponentClass(MonthComponent, cb);
+  settingEx(params) {
+    return normalizeOptionalProperties({
+      aliases: params.aliases,
+      desc: params.desc,
+      disabled: params.disabled,
+      name: params.name,
+      render: (setting, group) => this.renderSettingEx({ group, setting, settingExParams: params }),
+      searchable: params.searchable,
+      visible: params.visible
+    });
   }
   /**
-   * Adds a {@link MultipleDropdownComponent} to the setting.
+   * Builds a declarative heading group.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * The declarative counterpart of `SettingGroupEx`: where that class appends a group to a container
+   * imperatively, this returns the definition Obsidian renders, so a group-structured tab keeps its shape
+   * after the migration.
+   *
+   * @param params - The group params.
+   * @returns The group definition.
    */
-  addMultipleDropdown(cb) {
-    return this.addComponentClass(MultipleDropdownComponent, cb);
+  settingGroupEx(params) {
+    return normalizeOptionalProperties({
+      ...params,
+      type: "group"
+    });
+  }
+  beginRenderCycle() {
+    this.endRenderCycle();
+    this.currentRenderComponent = this.createRenderComponent();
+  }
+  createRenderComponent() {
+    this._isOpen = true;
+    this.component.load();
+    return this.component.addChild(new ComponentEx());
+  }
+  endRenderCycle() {
+    const renderComponent = this.currentRenderComponent;
+    if (!renderComponent) {
+      return;
+    }
+    this.currentRenderComponent = null;
+    this.component.removeChild(renderComponent);
+  }
+  getPluginSettingsProperty(propertyName) {
+    const settings = this.pluginSettings;
+    return settings[propertyName];
+  }
+  getRenderComponent() {
+    this.currentRenderComponent ??= this.createRenderComponent();
+    return this.currentRenderComponent;
+  }
+  async onSaveSettings(params) {
+    const {
+      context,
+      newState,
+      oldState: _oldState
+    } = params;
+    if (context === SAVE_TO_FILE_CONTEXT) {
+      await this.updateValidations(newState.validationMessages);
+      return;
+    }
+    this.refresh();
   }
+  // eslint-disable-next-line @typescript-eslint/no-invalid-void-type -- Mirrors Obsidian's `SettingDefinitionRender.render`, whose cleanup function is optional.
+  renderSettingEx(params) {
+    const rowComponent = this.createRenderComponent();
+    const previousRenderComponent = this.currentRenderComponent;
+    this.currentRenderComponent = rowComponent;
+    try {
+      const cleanup = params.settingExParams.render(adoptSettingEx(params.setting), params.group);
+      return () => {
+        if (typeof cleanup === "function") {
+          cleanup();
+        }
+        this.component.removeChild(rowComponent);
+      };
+    } finally {
+      this.currentRenderComponent = previousRenderComponent;
+    }
+  }
+  async updateValidations(validationMessages) {
+    for (const [propertyName, validationMessage] of Object.entries(validationMessages)) {
+      await this.triggerAsync("validationMessageChanged", propertyName, validationMessage);
+    }
+  }
+};
+
+// src/obsidian/plugin/plugin.ts
+var plugin_exports = {};
+__export(plugin_exports, {
+  PluginBase: () => PluginBase,
+  reloadPlugin: () => reloadPlugin,
+  showErrorAndDisablePlugin: () => showErrorAndDisablePlugin
+});
+var import_obsidian147 = require("obsidian");
+init_async_events();
+init_error();
+init_function();
+init_type_guards();
+var PluginBase = class extends mixinAsyncEvents()(import_obsidian147.Plugin) {
   /**
-   * Adds a {@link MultipleEmailComponent} to the setting.
+   * Gets abort signal component.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * @returns abort signal component.
    */
-  addMultipleEmail(cb) {
-    return this.addComponentClass(MultipleEmailComponent, cb);
+  get abortSignalComponent() {
+    return ensureNonNullable(this._abortSignalComponent);
   }
   /**
-   * Adds a {@link MultipleFileComponent} to the setting.
+   * Sets abort signal component.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * @param value - Abort signal component.
    */
-  addMultipleFile(cb) {
-    return this.addComponentClass(MultipleFileComponent, cb);
+  set abortSignalComponent(value) {
+    this._abortSignalComponent = value;
   }
   /**
-   * Adds a {@link MultipleTextComponent} to the setting.
+   * Gets async error handler component.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * @returns async error handler component.
    */
-  addMultipleText(cb) {
-    return this.addComponentClass(MultipleTextComponent, cb);
+  get asyncErrorHandlerComponent() {
+    return ensureNonNullable(this._asyncErrorHandlerComponent);
   }
   /**
-   * Adds a {@link NumberComponent} to the setting.
+   * Sets async error handler component.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * @param value - Async error handler component.
    */
-  addNumber(cb) {
-    return this.addComponentClass(NumberComponent, cb);
+  set asyncErrorHandlerComponent(value) {
+    this._asyncErrorHandlerComponent = value;
   }
   /**
-   * Adds a {@link PasswordComponent} to the setting.
+   * Gets the shared command handler component. Register a plugin's commands on it via
+   * {@link CommandHandlerComponent.registerCommandHandlers} rather than constructing your own
+   * {@link CommandHandlerComponent} — the app-backed active-file provider, command registrar, menu
+   * event registrar, and plugin name are already wired.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * @returns The command handler component.
    */
-  addPassword(cb) {
-    return this.addComponentClass(PasswordComponent, cb);
+  get commandHandlerComponent() {
+    return ensureNonNullable(this._commandHandlerComponent);
   }
   /**
-   * Adds a {@link TelephoneComponent} to the setting.
+   * Sets the command handler component.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * @param value - The command handler component.
    */
-  addTelephone(cb) {
-    return this.addComponentClass(TelephoneComponent, cb);
+  set commandHandlerComponent(value) {
+    this._commandHandlerComponent = value;
   }
   /**
-   * Adds a {@link TimeComponent} to the setting.
+   * Gets console debug component.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * @returns console debug component.
    */
-  addTime(cb) {
-    return this.addComponentClass(TimeComponent, cb);
+  get consoleDebugComponent() {
+    return ensureNonNullable(this._consoleDebugComponent);
   }
   /**
-   * Adds a {@link TriStateCheckboxComponent} to the setting.
+   * Sets console debug component.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * @param value - Console debug component.
    */
-  addTriStateCheckbox(cb) {
-    return this.addComponentClass(TriStateCheckboxComponent, cb);
+  set consoleDebugComponent(value) {
+    this._consoleDebugComponent = value;
   }
   /**
-   * Adds a {@link TypedDropdownComponent} to the setting.
+   * Gets plugin context component (plugin ID, debug controller, library styles).
    *
-   * @typeParam T - The type of the dropdown items.
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * @returns plugin context component.
    */
-  addTypedDropdown(cb) {
-    return this.addComponentClass(TypedDropdownComponent, cb);
+  get pluginContextComponent() {
+    return ensureNonNullable(this._pluginContextComponent);
   }
   /**
-   * Adds a {@link TypedMultipleDropdownComponent} to the setting.
+   * Sets plugin context component.
    *
-   * @typeParam T - The type of the items in the dropdown.
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * @param value - Plugin context component.
    */
-  addTypedMultipleDropdown(cb) {
-    return this.addComponentClass(TypedMultipleDropdownComponent, cb);
+  set pluginContextComponent(value) {
+    this._pluginContextComponent = value;
   }
   /**
-   * Adds an {@link UrlComponent} to the setting.
+   * Gets plugin notice component.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * @returns plugin notice component.
    */
-  addUrl(cb) {
-    return this.addComponentClass(UrlComponent, cb);
+  get pluginNoticeComponent() {
+    return ensureNonNullable(this._pluginNoticeComponent);
   }
   /**
-   * Adds a {@link WeekComponent} to the setting.
+   * Sets plugin notice component.
    *
-   * @param cb - The callback to call with the component.
-   * @returns The setting instance.
+   * @param value - Plugin notice component.
    */
-  addWeek(cb) {
-    return this.addComponentClass(WeekComponent, cb);
+  set pluginNoticeComponent(value) {
+    this._pluginNoticeComponent = value;
   }
-};
+  /**
+   * Gets the editor lock component, used to lock notes read-only during long operations. Owned by
+   * the plugin, so its locks are released automatically when the plugin unloads.
+   *
+   * @returns Editor lock component.
+   */
+  get resourceLockComponent() {
+    return ensureNonNullable(this._resourceLockComponent);
+  }
+  /**
+   * Sets the editor lock component.
+   *
+   * @param value - Editor lock component.
+   */
+  set resourceLockComponent(value) {
+    this._resourceLockComponent = value;
+  }
+  _abortSignalComponent;
+  _asyncErrorHandlerComponent;
+  _commandHandlerComponent;
+  _consoleDebugComponent;
+  _pluginContextComponent;
+  _pluginNoticeComponent;
+  _resourceLockComponent;
+  wrapperComponent = new ComponentEx();
+  /**
+   * Adds a child component.
+   *
+   * The child is added to an internal wrapper component so that, during {@link onloadImpl},
+   * children are queued and then loaded sequentially (children-first) when the plugin loads.
+   *
+   * @typeParam TComponent - The type of component to add.
+   * @param component - The component instance to add.
+   * @returns The added component.
+   */
+  addChild(component) {
+    return this.wrapperComponent.addChild(component);
+  }
+  /**
+   * Called when the external settings change.
+   *
+   * Override in subclass if needed. Make sure to call `await super.onExternalSettingsChange()` first.
+   */
+  async onExternalSettingsChange() {
+    await super.onExternalSettingsChange?.();
+    await this.triggerAsync("externalSettingsChange");
+  }
+  /**
+   * Called when the plugin is loaded.
+   *
+   * Orchestrates loading: registers the universal components, lets the subclass wire its own
+   * components via {@link onloadImpl}, then loads all of them sequentially (children-first).
+   *
+   * Do NOT override this method. Override {@link onloadImpl} instead.
+   */
+  async onload() {
+    try {
+      await initI18N(this.createTranslationsMap());
+      this.pluginContextComponent = this.addChild(
+        new PluginContextComponent({
+          app: this.app,
+          pluginId: this.manifest.id
+        })
+      );
+      this.pluginNoticeComponent = this.addChild(
+        new PluginNoticeComponent({
+          app: this.app,
+          pluginName: this.manifest.name
+        })
+      );
+      this.asyncErrorHandlerComponent = this.addChild(new AsyncErrorHandlerComponent(this.pluginNoticeComponent));
+      this.abortSignalComponent = this.addChild(new AbortSignalComponent(this.manifest.id));
+      this.consoleDebugComponent = this.addChild(new ConsoleDebugComponent(this.manifest.id));
+      this.resourceLockComponent = this.addChild(new ResourceLockComponent(this.app, this.manifest.id));
+      this.commandHandlerComponent = this.addChild(
+        new CommandHandlerComponent({
+          activeFileProvider: new AppActiveFileProvider(this.app),
+          commandRegistrar: new PluginCommandRegistrar(this),
+          menuEventRegistrar: this.addChild(new MenuEventRegistrarComponent(this.app)),
+          pluginName: this.manifest.name
+        })
+      );
+      this.commandHandlerComponent.registerCommandHandlers([
+        new UnlockActiveNoteCommandHandler({
+          app: this.app,
+          resourceLockComponent: this.resourceLockComponent
+        })
+      ]);
+      await this.onloadImpl();
+      super.addChild(this.wrapperComponent);
+      await this.wrapperComponent.loadWithPromises();
+    } catch (error) {
+      printError(new Error(`Error loading plugin ${this.manifest.name} (${this.manifest.id})`, { cause: error }));
+      throw error;
+    }
+  }
+  /**
+   * Removes a child component.
+   *
+   * @typeParam TComponent - The type of component to remove.
+   * @param component - The component instance to remove.
+   * @returns The removed component.
+   */
+  removeChild(component) {
+    return this.wrapperComponent.removeChild(component);
+  }
+  /**
+   * Provides the translations map used to initialize i18n during {@link onload}.
+   *
+   * Override in subclass to supply plugin-specific translations. The default returns the built-in
+   * `obsidian-dev-utils` translations.
+   *
+   * @returns The translations map.
+   */
+  createTranslationsMap() {
+    return defaultTranslationsMap;
+  }
+  /**
+   * Called during {@link onload} to wire plugin-specific child components.
+   *
+   * Override in subclass to add child components via {@link addChild}. The universal components are
+   * available here. Children are loaded sequentially in the order they are added (children-first).
+   *
+   * @returns A {@link Promise} that resolves when the subclass load logic is complete.
+   */
+  onloadImpl() {
+    return noopAsync();
+  }
+};
+async function reloadPlugin(plugin) {
+  const plugins = plugin.app.plugins;
+  const pluginId = plugin.manifest.id;
+  await plugins.disablePlugin(pluginId);
+  await plugins.enablePlugin(pluginId);
+}
+async function showErrorAndDisablePlugin(plugin, message) {
+  const pluginNoticeComponent = new PluginNoticeComponent({
+    app: plugin.app,
+    pluginName: plugin.manifest.name
+  });
+  pluginNoticeComponent.showNotice(message);
+  printError(new Error(message));
+  await plugin.app.plugins.disablePlugin(plugin.manifest.id);
+}
+
+// src/obsidian/plugin-cli-handler-registrar.ts
+var plugin_cli_handler_registrar_exports = {};
+__export(plugin_cli_handler_registrar_exports, {
+  PluginCliHandlerRegistrar: () => PluginCliHandlerRegistrar
+});
+var import_obsidian148 = require("obsidian");
+var PluginCliHandlerRegistrar = class {
+  /**
+   * Creates a new instance of the {@link PluginCliHandlerRegistrar} class.
+   *
+   * @param plugin - The Obsidian plugin instance.
+   */
+  constructor(plugin) {
+    this.plugin = plugin;
+  }
+  plugin;
+  /**
+   * Registers a CLI handler.
+   *
+   * @param params - The parameters for the CLI handler registration.
+   */
+  registerCliHandler(params) {
+    this.plugin.registerCliHandler(params.command, params.description, params.flags, (cliData) => normalizePromisable(params.handler(cliData)));
+  }
+};
+
+// src/obsidian/popovers/index.ts
+var popovers_exports = {};
+__export(popovers_exports, {
+  "field-popover": () => field_popover_exports,
+  popover: () => popover_exports,
+  "popover-anchor": () => popover_anchor_exports
+});
+
+// src/obsidian/popovers/field-popover.ts
+var field_popover_exports = {};
+__export(field_popover_exports, {
+  editFieldsInPopover: () => editFieldsInPopover
+});
+var import_obsidian150 = require("obsidian");
+init_css_class();
+
+// src/obsidian/popovers/popover.ts
+var popover_exports = {};
+__export(popover_exports, {
+  showPopover: () => showPopover
+});
+var import_obsidian149 = require("obsidian");
+init_css_class();
+init_plugin_context();
+var ANCHOR_GAP_IN_PIXELS = 4;
+var VIEWPORT_MARGIN_IN_PIXELS = 8;
+async function showPopover(params) {
+  const {
+    anchor,
+    build,
+    cancelButtonText,
+    cssClasses,
+    okButtonText
+  } = params;
+  const doc = anchor.doc;
+  const win = getDocumentWindow(doc);
+  const popoverEl = doc.body.createDiv({ cls: "menu" });
+  addPluginCssClasses(popoverEl, ["popover" /* Popover */, ...cssClasses ?? []]);
+  return await new Promise((resolve2) => {
+    const state = { isClosed: false };
+    function close(result) {
+      if (state.isClosed) {
+        return;
+      }
+      state.isClosed = true;
+      doc.removeEventListener("pointerdown", handlePointerDown, true);
+      popoverEl.remove();
+      resolve2(result);
+    }
+    function handleCancel() {
+      close(null);
+    }
+    function handleOk() {
+      close(getValue());
+    }
+    function handlePointerDown(evt) {
+      if (evt.composedPath().includes(popoverEl)) {
+        return;
+      }
+      close(null);
+    }
+    const getValue = build({
+      cancel: handleCancel,
+      confirm: handleOk,
+      contentEl: popoverEl
+    });
+    popoverEl.addEventListener("keydown", (evt) => {
+      if (evt.key === "Enter") {
+        evt.preventDefault();
+        handleOk();
+        return;
+      }
+      if (evt.key === "Escape") {
+        evt.preventDefault();
+        handleCancel();
+      }
+    });
+    const buttonsSetting = new import_obsidian149.Setting(popoverEl);
+    buttonsSetting.addButton((button) => {
+      button.setButtonText(okButtonText ?? t2(($) => $.obsidianDevUtils.buttons.ok)).setCta().setClass("ok-button" /* OkButton */).onClick(handleOk);
+    });
+    buttonsSetting.addButton((button) => {
+      button.setButtonText(cancelButtonText ?? t2(($) => $.obsidianDevUtils.buttons.cancel)).setClass("cancel-button" /* CancelButton */).onClick(handleCancel);
+    });
+    doc.addEventListener("pointerdown", handlePointerDown, true);
+    positionAtAnchor(popoverEl, anchor, win);
+    focusFirstInput(popoverEl);
+  });
+}
+function focusFirstInput(popoverEl) {
+  const inputEl = popoverEl.querySelector("input");
+  if (!inputEl) {
+    return;
+  }
+  inputEl.focus();
+  inputEl.select();
+}
+function positionAtAnchor(popoverEl, anchor, win) {
+  const maxLeft = Math.max(VIEWPORT_MARGIN_IN_PIXELS, win.innerWidth - popoverEl.offsetWidth - VIEWPORT_MARGIN_IN_PIXELS);
+  const maxTop = Math.max(VIEWPORT_MARGIN_IN_PIXELS, win.innerHeight - popoverEl.offsetHeight - VIEWPORT_MARGIN_IN_PIXELS);
+  const left = Math.min(Math.max(anchor.left, VIEWPORT_MARGIN_IN_PIXELS), maxLeft);
+  const top = Math.min(Math.max(anchor.bottom + ANCHOR_GAP_IN_PIXELS, VIEWPORT_MARGIN_IN_PIXELS), maxTop);
+  popoverEl.style.left = `${String(Math.round(left + win.scrollX))}px`;
+  popoverEl.style.top = `${String(Math.round(top + win.scrollY))}px`;
+}
+
+// src/obsidian/popovers/field-popover.ts
+async function editFieldsInPopover(params) {
+  const {
+    anchor,
+    cancelButtonText,
+    cssClasses,
+    fields,
+    okButtonText
+  } = params;
+  return await showPopover(normalizeOptionalProperties({
+    anchor,
+    build({ contentEl }) {
+      const editors = fields.map((field) => ({
+        key: field.key,
+        textComponent: addField(contentEl, field)
+      }));
+      return () => {
+        const values = {};
+        for (const editor of editors) {
+          values[editor.key] = editor.textComponent.getValue();
+        }
+        return values;
+      };
+    },
+    cancelButtonText,
+    cssClasses,
+    okButtonText
+  }));
+}
+function addField(containerEl, field) {
+  const setting = new import_obsidian150.Setting(containerEl).setName(field.name);
+  const textComponent = new import_obsidian150.TextComponent(setting.controlEl);
+  textComponent.setValue(field.defaultValue ?? "");
+  textComponent.setPlaceholder(field.placeholder ?? "");
+  textComponent.inputEl.addClass("text-box" /* TextBox */);
+  return textComponent;
+}
+
+// src/obsidian/react/index.ts
+var react_exports = {};
+__export(react_exports, {
+  "app-context": () => app_context_exports
+});
+
+// src/obsidian/react/app-context.ts
+var app_context_exports = {};
+__export(app_context_exports, {
+  AppContext: () => AppContext,
+  useApp: () => useApp
+});
+var import_obsidian151 = require("obsidian");
+var import_react = __toESM(require_react(), 1);
+init_type_guards();
+var AppContext = (0, import_react.createContext)(void 0);
+function useApp() {
+  return ensureNonNullable((0, import_react.useContext)(AppContext), "AppContext not found");
+}
+
+// src/obsidian/ribbon-icon-registrar.ts
+var ribbon_icon_registrar_exports = {};
+__export(ribbon_icon_registrar_exports, {
+  PluginRibbonIconRegistrar: () => PluginRibbonIconRegistrar
+});
+var import_obsidian152 = require("obsidian");
+var PluginRibbonIconRegistrar = class {
+  /**
+   * Creates a new instance of the {@link PluginRibbonIconRegistrar} class.
+   *
+   * @param plugin - The Obsidian plugin instance.
+   */
+  constructor(plugin) {
+    this.plugin = plugin;
+  }
+  plugin;
+  /**
+   * Registers a ribbon icon.
+   *
+   * @param params - The parameters for the ribbon icon registration.
+   * @returns The HTML element representing the registered ribbon icon.
+   */
+  addRibbonIcon(params) {
+    return this.plugin.addRibbonIcon(params.icon, params.title, params.callback);
+  }
+};
+
+// src/obsidian/setting-components/index.ts
+var setting_components_exports = {};
+__export(setting_components_exports, {
+  "checkbox-component": () => checkbox_component_exports,
+  "code-highlighter-component": () => code_highlighter_component_exports,
+  "date-component": () => date_component_exports,
+  "date-time-component": () => date_time_component_exports,
+  "email-component": () => email_component_exports,
+  "file-component": () => file_component_exports,
+  "month-component": () => month_component_exports,
+  "multiple-dropdown-component": () => multiple_dropdown_component_exports,
+  "multiple-email-component": () => multiple_email_component_exports,
+  "multiple-file-component": () => multiple_file_component_exports,
+  "multiple-text-component": () => multiple_text_component_exports,
+  "number-component": () => number_component_exports,
+  "password-component": () => password_component_exports,
+  "setting-component-wrapper": () => setting_component_wrapper_exports,
+  "telephone-component": () => telephone_component_exports,
+  "text-based-component": () => text_based_component_exports,
+  "time-component": () => time_component_exports,
+  "tri-state-checkbox-component": () => tri_state_checkbox_component_exports,
+  "typed-dropdown-component": () => typed_dropdown_component_exports,
+  "typed-multiple-dropdown-component": () => typed_multiple_dropdown_component_exports,
+  "typed-range-text-component": () => typed_range_text_component_exports,
+  "typed-text-component": () => typed_text_component_exports,
+  "url-component": () => url_component_exports,
+  "validator-component": () => validator_component_exports,
+  "value-component-with-change-tracking": () => value_component_with_change_tracking_exports,
+  "week-component": () => week_component_exports
+});
+
+// src/obsidian/setting-components/value-component-with-change-tracking.ts
+var value_component_with_change_tracking_exports = {};
 
 // src/obsidian/setting-group-ex.ts
 var setting_group_ex_exports = {};
@@ -37601,6 +37823,7 @@ __export(merged_exports, {
   addPluginCssClasses: () => addPluginCssClasses,
   addToQueue: () => addToQueue,
   addToQueueAndWait: () => addToQueueAndWait,
+  adoptSettingEx: () => adoptSettingEx,
   alert: () => alert,
   appendCodeBlock: () => appendCodeBlock,
   applyContentChanges: () => applyContentChanges,