@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/esm/setting-components/typed-text-component.d.mts

@@ -0,0 +1,100 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Contains a component that displays and edits a text-based value.
+ */
+import type { ValidatorElement } from '@mnaoumov/typescript-lib/html-element';
+import { TextComponent, ValueComponent } from 'obsidian';
+import type { ValidatorComponent } from './validator-component.mjs';
+import type { ValueComponentWithChangeTracking } from './value-component-with-change-tracking.mjs';
+import { CssClass } from '../css-class.mjs';
+/**
+ * The parameters for constructing a {@link TypedTextComponent}.
+ */
+export interface TypedTextComponentConstructorParams {
+    /**
+     * The container element for the component.
+     */
+    readonly containerEl: HTMLElement;
+    /**
+     * A CSS class to apply to the component.
+     */
+    readonly cssClass?: CssClass;
+    /**
+     * The type of the input element.
+     */
+    readonly type: string;
+}
+/**
+ * A component that displays and edits a text-based value.
+ *
+ * @typeParam T - The type of the value to set.
+ */
+export declare abstract class TypedTextComponent<T> extends ValueComponent<T> implements ValidatorComponent, ValueComponentWithChangeTracking<T> {
+    /**
+     * An input element of the component.
+     */
+    readonly inputEl: HTMLInputElement;
+    /**
+     * A validator element of the component.
+     *
+     * @returns The validator element.
+     */
+    get validatorEl(): ValidatorElement;
+    /**
+     * The inner text component.
+     */
+    protected readonly textComponent: TextComponent;
+    /**
+     * Creates a new typed text component.
+     *
+     * @param params - The parameters for the typed text component.
+     */
+    constructor(params: TypedTextComponentConstructorParams);
+    /**
+     * Gets the value of the component.
+     *
+     * @returns The value of the component.
+     */
+    getValue(): T;
+    /**
+     * 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: (value: T) => void): this;
+    /**
+     * Called when the component is changed.
+     */
+    onChanged(): void;
+    /**
+     * Sets the disabled state of the component.
+     *
+     * @param isDisabled - Whether the component is disabled.
+     * @returns The component.
+     */
+    setDisabled(isDisabled: boolean): this;
+    /**
+     * Sets the value of the component.
+     *
+     * @param value - The value to set.
+     * @returns The component.
+     */
+    setValue(value: T): this;
+    /**
+     * Converts a string to a value.
+     *
+     * @param $string - The string to convert.
+     * @returns The value.
+     */
+    abstract valueFromString($string: string): T;
+    /**
+     * Converts a value to a string.
+     *
+     * @param value - The value to convert.
+     * @returns The string.
+     */
+    valueToString(value: T): string;
+}

package/dist/lib/esm/setting-components/typed-text-component.mjs

@@ -0,0 +1,146 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import {
+  TextComponent,
+  ValueComponent
+} from "obsidian";
+import { CssClass } from "../css-class.mjs";
+import { addPluginCssClasses } from "../plugin/plugin-context.mjs";
+class TypedTextComponent extends 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 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.
+   */
+  getValue() {
+    return this.valueFromString(this.textComponent.getValue());
+  }
+  /**
+   * 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) {
+    this.textComponent.onChange(() => {
+      callback(this.getValue());
+    });
+    return this;
+  }
+  /**
+   * Called when the component is changed.
+   */
+  onChanged() {
+    this.textComponent.onChanged();
+  }
+  /**
+   * Sets the disabled state of the component.
+   *
+   * @param isDisabled - Whether the component is disabled.
+   * @returns The component.
+   */
+  setDisabled(isDisabled) {
+    super.setDisabled(isDisabled);
+    this.textComponent.setDisabled(isDisabled);
+    return this;
+  }
+  /**
+   * Sets the value of the component.
+   *
+   * @param value - The value to set.
+   * @returns The component.
+   */
+  setValue(value) {
+    this.textComponent.setValue(this.valueToString(value));
+    return this;
+  }
+  /**
+   * Converts a value to a string.
+   *
+   * @param value - The value to convert.
+   * @returns The string.
+   */
+  // eslint-disable-next-line unicorn/prefer-native-coercion-functions -- This is an overridable method on the component's public surface, and subclasses replace it to control how their value is rendered. Turning it into a `valueToString = String` field would change the class shape and take `override` with it.
+  valueToString(value) {
+    return String(value);
+  }
+}
+export {
+  TypedTextComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3NldHRpbmctY29tcG9uZW50cy90eXBlZC10ZXh0LWNvbXBvbmVudC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbnRhaW5zIGEgY29tcG9uZW50IHRoYXQgZGlzcGxheXMgYW5kIGVkaXRzIGEgdGV4dC1iYXNlZCB2YWx1ZS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IFZhbGlkYXRvckVsZW1lbnQgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvaHRtbC1lbGVtZW50JztcblxuaW1wb3J0IHtcbiAgVGV4dENvbXBvbmVudCxcbiAgVmFsdWVDb21wb25lbnRcbn0gZnJvbSAnb2JzaWRpYW4nO1xuXG5pbXBvcnQgdHlwZSB7IFZhbGlkYXRvckNvbXBvbmVudCB9IGZyb20gJy4vdmFsaWRhdG9yLWNvbXBvbmVudC50cyc7XG5pbXBvcnQgdHlwZSB7IFZhbHVlQ29tcG9uZW50V2l0aENoYW5nZVRyYWNraW5nIH0gZnJvbSAnLi92YWx1ZS1jb21wb25lbnQtd2l0aC1jaGFuZ2UtdHJhY2tpbmcudHMnO1xuXG5pbXBvcnQgeyBDc3NDbGFzcyB9IGZyb20gJy4uL2Nzcy1jbGFzcy50cyc7XG5pbXBvcnQgeyBhZGRQbHVnaW5Dc3NDbGFzc2VzIH0gZnJvbSAnLi4vcGx1Z2luL3BsdWdpbi1jb250ZXh0LnRzJztcblxuLyoqXG4gKiBUaGUgcGFyYW1ldGVycyBmb3IgY29uc3RydWN0aW5nIGEge0BsaW5rIFR5cGVkVGV4dENvbXBvbmVudH0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgVHlwZWRUZXh0Q29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXMge1xuICAvKipcbiAgICogVGhlIGNvbnRhaW5lciBlbGVtZW50IGZvciB0aGUgY29tcG9uZW50LlxuICAgKi9cbiAgcmVhZG9ubHkgY29udGFpbmVyRWw6IEhUTUxFbGVtZW50O1xuXG4gIC8qKlxuICAgKiBBIENTUyBjbGFzcyB0byBhcHBseSB0byB0aGUgY29tcG9uZW50LlxuICAgKi9cbiAgcmVhZG9ubHkgY3NzQ2xhc3M/OiBDc3NDbGFzcztcblxuICAvKipcbiAgICogVGhlIHR5cGUgb2YgdGhlIGlucHV0IGVsZW1lbnQuXG4gICAqL1xuICByZWFkb25seSB0eXBlOiBzdHJpbmc7XG59XG5cbi8qKlxuICogQSBjb21wb25lbnQgdGhhdCBkaXNwbGF5cyBhbmQgZWRpdHMgYSB0ZXh0LWJhc2VkIHZhbHVlLlxuICpcbiAqIEB0eXBlUGFyYW0gVCAtIFRoZSB0eXBlIG9mIHRoZSB2YWx1ZSB0byBzZXQuXG4gKi9cbmV4cG9ydCBhYnN0cmFjdCBjbGFzcyBUeXBlZFRleHRDb21wb25lbnQ8VD4gZXh0ZW5kcyBWYWx1ZUNvbXBvbmVudDxUPiBpbXBsZW1lbnRzIFZhbGlkYXRvckNvbXBvbmVudCwgVmFsdWVDb21wb25lbnRXaXRoQ2hhbmdlVHJhY2tpbmc8VD4ge1xuICAvKipcbiAgICogQW4gaW5wdXQgZWxlbWVudCBvZiB0aGUgY29tcG9uZW50LlxuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IGlucHV0RWw6IEhUTUxJbnB1dEVsZW1lbnQ7XG5cbiAgLyoqXG4gICAqIEEgdmFsaWRhdG9yIGVsZW1lbnQgb2YgdGhlIGNvbXBvbmVudC5cbiAgICpcbiAgICogQHJldHVybnMgVGhlIHZhbGlkYXRvciBlbGVtZW50LlxuICAgKi9cbiAgcHVibGljIGdldCB2YWxpZGF0b3JFbCgpOiBWYWxpZGF0b3JFbGVtZW50IHtcbiAgICByZXR1cm4gdGhpcy5pbnB1dEVsO1xuICB9XG5cbiAgLyoqXG4gICAqIFRoZSBpbm5lciB0ZXh0IGNvbXBvbmVudC5cbiAgICovXG4gIHByb3RlY3RlZCByZWFkb25seSB0ZXh0Q29tcG9uZW50OiBUZXh0Q29tcG9uZW50O1xuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IHR5cGVkIHRleHQgY29tcG9uZW50LlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBhcmFtZXRlcnMgZm9yIHRoZSB0eXBlZCB0ZXh0IGNvbXBvbmVudC5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3RvcihwYXJhbXM6IFR5cGVkVGV4dENvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zKSB7XG4gICAgc3VwZXIoKTtcbiAgICB0aGlzLnRleHRDb21wb25lbnQgPSBuZXcgVGV4dENvbXBvbmVudChwYXJhbXMuY29udGFpbmVyRWwpO1xuICAgIHRoaXMuaW5wdXRFbCA9IHRoaXMudGV4dENvbXBvbmVudC5pbnB1dEVsO1xuICAgIHRoaXMuaW5wdXRFbC50eXBlID0gcGFyYW1zLnR5cGU7XG4gICAgYWRkUGx1Z2luQ3NzQ2xhc3NlcyhwYXJhbXMuY29udGFpbmVyRWwsIHBhcmFtcy5jc3NDbGFzcyk7XG4gIH1cblxuICAvKipcbiAgICogR2V0cyB0aGUgdmFsdWUgb2YgdGhlIGNvbXBvbmVudC5cbiAgICpcbiAgICogQHJldHVybnMgVGhlIHZhbHVlIG9mIHRoZSBjb21wb25lbnQuXG4gICAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgZ2V0VmFsdWUoKTogVCB7XG4gICAgcmV0dXJuIHRoaXMudmFsdWVGcm9tU3RyaW5nKHRoaXMudGV4dENvbXBvbmVudC5nZXRWYWx1ZSgpKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBTZXRzIHRoZSBjYWxsYmFjayBmdW5jdGlvbiB0byBiZSBjYWxsZWQgd2hlbiB0aGUgY29tcG9uZW50IGlzIGNoYW5nZWQuXG4gICAqXG4gICAqIEBwYXJhbSBjYWxsYmFjayAtIFRoZSBjYWxsYmFjayBmdW5jdGlvbiB0byBiZSBjYWxsZWQgd2hlbiB0aGUgY29tcG9uZW50IGlzIGNoYW5nZWQuXG4gICAqIEByZXR1cm5zIFRoZSBjb21wb25lbnQuXG4gICAqL1xuICBwdWJsaWMgb25DaGFuZ2UoY2FsbGJhY2s6ICh2YWx1ZTogVCkgPT4gdm9pZCk6IHRoaXMge1xuICAgIC8qIHY4IGlnbm9yZSBzdGFydCAtLSBUaGUgaW5uZXIgYXJyb3cgZnVuY3Rpb24gaXMgb25seSBpbnZva2VkIHdoZW4gdGhlIERPTSBpbnB1dCBldmVudCBmaXJlcy4gKi9cbiAgICB0aGlzLnRleHRDb21wb25lbnQub25DaGFuZ2UoKCkgPT4ge1xuICAgICAgY2FsbGJhY2sodGhpcy5nZXRWYWx1ZSgpKTtcbiAgICB9KTtcbiAgICAvKiB2OCBpZ25vcmUgc3RvcCAqL1xuICAgIHJldHVybiB0aGlzO1xuICB9XG5cbiAgLyoqXG4gICAqIENhbGxlZCB3aGVuIHRoZSBjb21wb25lbnQgaXMgY2hhbmdlZC5cbiAgICovXG4gIHB1YmxpYyBvbkNoYW5nZWQoKTogdm9pZCB7XG4gICAgdGhpcy50ZXh0Q29tcG9uZW50Lm9uQ2hhbmdlZCgpO1xuICB9XG5cbiAgLyoqXG4gICAqIFNldHMgdGhlIGRpc2FibGVkIHN0YXRlIG9mIHRoZSBjb21wb25lbnQuXG4gICAqXG4gICAqIEBwYXJhbSBpc0Rpc2FibGVkIC0gV2hldGhlciB0aGUgY29tcG9uZW50IGlzIGRpc2FibGVkLlxuICAgKiBAcmV0dXJucyBUaGUgY29tcG9uZW50LlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIHNldERpc2FibGVkKGlzRGlzYWJsZWQ6IGJvb2xlYW4pOiB0aGlzIHtcbiAgICBzdXBlci5zZXREaXNhYmxlZChpc0Rpc2FibGVkKTtcbiAgICB0aGlzLnRleHRDb21wb25lbnQuc2V0RGlzYWJsZWQoaXNEaXNhYmxlZCk7XG4gICAgcmV0dXJuIHRoaXM7XG4gIH1cblxuICAvKipcbiAgICogU2V0cyB0aGUgdmFsdWUgb2YgdGhlIGNvbXBvbmVudC5cbiAgICpcbiAgICogQHBhcmFtIHZhbHVlIC0gVGhlIHZhbHVlIHRvIHNldC5cbiAgICogQHJldHVybnMgVGhlIGNvbXBvbmVudC5cbiAgICovXG4gIHB1YmxpYyBvdmVycmlkZSBzZXRWYWx1ZSh2YWx1ZTogVCk6IHRoaXMge1xuICAgIHRoaXMudGV4dENvbXBvbmVudC5zZXRWYWx1ZSh0aGlzLnZhbHVlVG9TdHJpbmcodmFsdWUpKTtcbiAgICByZXR1cm4gdGhpcztcbiAgfVxuXG4gIC8qKlxuICAgKiBDb252ZXJ0cyBhIHN0cmluZyB0byBhIHZhbHVlLlxuICAgKlxuICAgKiBAcGFyYW0gJHN0cmluZyAtIFRoZSBzdHJpbmcgdG8gY29udmVydC5cbiAgICogQHJldHVybnMgVGhlIHZhbHVlLlxuICAgKi9cbiAgcHVibGljIGFic3RyYWN0IHZhbHVlRnJvbVN0cmluZygkc3RyaW5nOiBzdHJpbmcpOiBUO1xuXG4gIC8qKlxuICAgKiBDb252ZXJ0cyBhIHZhbHVlIHRvIGEgc3RyaW5nLlxuICAgKlxuICAgKiBAcGFyYW0gdmFsdWUgLSBUaGUgdmFsdWUgdG8gY29udmVydC5cbiAgICogQHJldHVybnMgVGhlIHN0cmluZy5cbiAgICovXG4gIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSB1bmljb3JuL3ByZWZlci1uYXRpdmUtY29lcmNpb24tZnVuY3Rpb25zIC0tIFRoaXMgaXMgYW4gb3ZlcnJpZGFibGUgbWV0aG9kIG9uIHRoZSBjb21wb25lbnQncyBwdWJsaWMgc3VyZmFjZSwgYW5kIHN1YmNsYXNzZXMgcmVwbGFjZSBpdCB0byBjb250cm9sIGhvdyB0aGVpciB2YWx1ZSBpcyByZW5kZXJlZC4gVHVybmluZyBpdCBpbnRvIGEgYHZhbHVlVG9TdHJpbmcgPSBTdHJpbmdgIGZpZWxkIHdvdWxkIGNoYW5nZSB0aGUgY2xhc3Mgc2hhcGUgYW5kIHRha2UgYG92ZXJyaWRlYCB3aXRoIGl0LlxuICBwdWJsaWMgdmFsdWVUb1N0cmluZyh2YWx1ZTogVCk6IHN0cmluZyB7XG4gICAgcmV0dXJuIFN0cmluZyh2YWx1ZSk7XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFRQTtBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsT0FDSztBQUtQLFNBQVMsZ0JBQWdCO0FBQ3pCLFNBQVMsMkJBQTJCO0FBMkI3QixNQUFlLDJCQUE4QixlQUFxRjtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBSXZIO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT2hCLElBQVcsY0FBZ0M7QUFDekMsV0FBTyxLQUFLO0FBQUEsRUFDZDtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBS21CO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT1osWUFBWSxRQUE2QztBQUM5RCxVQUFNO0FBQ04sU0FBSyxnQkFBZ0IsSUFBSSxjQUFjLE9BQU8sV0FBVztBQUN6RCxTQUFLLFVBQVUsS0FBSyxjQUFjO0FBQ2xDLFNBQUssUUFBUSxPQUFPLE9BQU87QUFDM0Isd0JBQW9CLE9BQU8sYUFBYSxPQUFPLFFBQVE7QUFBQSxFQUN6RDtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9nQixXQUFjO0FBQzVCLFdBQU8sS0FBSyxnQkFBZ0IsS0FBSyxjQUFjLFNBQVMsQ0FBQztBQUFBLEVBQzNEO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFRTyxTQUFTLFVBQW9DO0FBRWxELFNBQUssY0FBYyxTQUFTLE1BQU07QUFDaEMsZUFBUyxLQUFLLFNBQVMsQ0FBQztBQUFBLElBQzFCLENBQUM7QUFFRCxXQUFPO0FBQUEsRUFDVDtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBS08sWUFBa0I7QUFDdkIsU0FBSyxjQUFjLFVBQVU7QUFBQSxFQUMvQjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBUWdCLFlBQVksWUFBMkI7QUFDckQsVUFBTSxZQUFZLFVBQVU7QUFDNUIsU0FBSyxjQUFjLFlBQVksVUFBVTtBQUN6QyxXQUFPO0FBQUEsRUFDVDtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBUWdCLFNBQVMsT0FBZ0I7QUFDdkMsU0FBSyxjQUFjLFNBQVMsS0FBSyxjQUFjLEtBQUssQ0FBQztBQUNyRCxXQUFPO0FBQUEsRUFDVDtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFpQk8sY0FBYyxPQUFrQjtBQUNyQyxXQUFPLE9BQU8sS0FBSztBQUFBLEVBQ3JCO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/setting-components/url-component.d.mts

@@ -0,0 +1,49 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Contains a component that displays and edits an url.
+ */
+import type { TextBasedComponent } from './text-based-component.mjs';
+import { TypedTextComponent } from './typed-text-component.mjs';
+/**
+ * A component that displays and edits an url.
+ *
+ * You can add this component using {@link SettingEx.addUrl}.
+ *
+ * In order to add the styles for the component, use {@link initPluginContext} in your plugin's `onload()` function.
+ *
+ * Alternatively, you can copy styles from {@link https://github.com/mnaoumov/obsidian-dev-utils/releases/latest/download/styles.css}.
+ */
+export declare class UrlComponent extends TypedTextComponent<string> implements TextBasedComponent<string> {
+    /**
+     * Creates a new Url component.
+     *
+     * @param containerEl - The container element of the component.
+     */
+    constructor(containerEl: HTMLElement);
+    /**
+     * Empties the component.
+     */
+    empty(): void;
+    /**
+     * Checks if the component is empty.
+     *
+     * @returns `true` if the component is empty, `false` otherwise.
+     */
+    isEmpty(): boolean;
+    /**
+     * Sets the placeholder value of the component.
+     *
+     * @param placeholderValue - The placeholder value to set.
+     * @returns The component.
+     */
+    setPlaceholderValue(placeholderValue: string): this;
+    /**
+     * Converts a string to an url.
+     *
+     * @param $string - The string to convert.
+     * @returns The url.
+     */
+    valueFromString($string: string): string;
+}

package/dist/lib/esm/setting-components/url-component.mjs

@@ -0,0 +1,102 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import { CssClass } from "../css-class.mjs";
+import { TypedTextComponent } from "./typed-text-component.mjs";
+class UrlComponent extends TypedTextComponent {
+  /**
+   * Creates a new Url component.
+   *
+   * @param containerEl - The container element of the component.
+   */
+  constructor(containerEl) {
+    super({
+      containerEl,
+      cssClass: CssClass.UrlComponent,
+      type: "url"
+    });
+  }
+  /**
+   * 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() === "";
+  }
+  /**
+   * 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 url.
+   *
+   * @param $string - The string to convert.
+   * @returns The url.
+   */
+  valueFromString($string) {
+    return $string;
+  }
+}
+export {
+  UrlComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3NldHRpbmctY29tcG9uZW50cy91cmwtY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29udGFpbnMgYSBjb21wb25lbnQgdGhhdCBkaXNwbGF5cyBhbmQgZWRpdHMgYW4gdXJsLlxuICovXG5cbi8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBAdHlwZXNjcmlwdC1lc2xpbnQvbm8tdW51c2VkLXZhcnMgLS0gV2UgbmVlZCB0byBpbXBvcnQgYGluaXRQbHVnaW5Db250ZXh0YCB0byB1c2UgaXQgaW4gdGhlIHRzZG9jcy5cbmltcG9ydCB0eXBlIHsgaW5pdFBsdWdpbkNvbnRleHQgfSBmcm9tICcuLi9wbHVnaW4vcGx1Z2luLWNvbnRleHQudHMnO1xuLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby11bnVzZWQtdmFycyAtLSBXZSBuZWVkIHRvIGltcG9ydCBgU2V0dGluZ0V4YCB0byB1c2UgaXQgaW4gdGhlIHRzZG9jcy5cbmltcG9ydCB0eXBlIHsgU2V0dGluZ0V4IH0gZnJvbSAnLi4vc2V0dGluZy1leC50cyc7XG5pbXBvcnQgdHlwZSB7IFRleHRCYXNlZENvbXBvbmVudCB9IGZyb20gJy4vdGV4dC1iYXNlZC1jb21wb25lbnQudHMnO1xuXG5pbXBvcnQgeyBDc3NDbGFzcyB9IGZyb20gJy4uL2Nzcy1jbGFzcy50cyc7XG5pbXBvcnQgeyBUeXBlZFRleHRDb21wb25lbnQgfSBmcm9tICcuL3R5cGVkLXRleHQtY29tcG9uZW50LnRzJztcblxuLyoqXG4gKiBBIGNvbXBvbmVudCB0aGF0IGRpc3BsYXlzIGFuZCBlZGl0cyBhbiB1cmwuXG4gKlxuICogWW91IGNhbiBhZGQgdGhpcyBjb21wb25lbnQgdXNpbmcge0BsaW5rIFNldHRpbmdFeC5hZGRVcmx9LlxuICpcbiAqIEluIG9yZGVyIHRvIGFkZCB0aGUgc3R5bGVzIGZvciB0aGUgY29tcG9uZW50LCB1c2Uge0BsaW5rIGluaXRQbHVnaW5Db250ZXh0fSBpbiB5b3VyIHBsdWdpbidzIGBvbmxvYWQoKWAgZnVuY3Rpb24uXG4gKlxuICogQWx0ZXJuYXRpdmVseSwgeW91IGNhbiBjb3B5IHN0eWxlcyBmcm9tIHtAbGluayBodHRwczovL2dpdGh1Yi5jb20vbW5hb3Vtb3Yvb2JzaWRpYW4tZGV2LXV0aWxzL3JlbGVhc2VzL2xhdGVzdC9kb3dubG9hZC9zdHlsZXMuY3NzfS5cbiAqL1xuZXhwb3J0IGNsYXNzIFVybENvbXBvbmVudCBleHRlbmRzIFR5cGVkVGV4dENvbXBvbmVudDxzdHJpbmc+IGltcGxlbWVudHMgVGV4dEJhc2VkQ29tcG9uZW50PHN0cmluZz4ge1xuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBVcmwgY29tcG9uZW50LlxuICAgKlxuICAgKiBAcGFyYW0gY29udGFpbmVyRWwgLSBUaGUgY29udGFpbmVyIGVsZW1lbnQgb2YgdGhlIGNvbXBvbmVudC5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3Rvcihjb250YWluZXJFbDogSFRNTEVsZW1lbnQpIHtcbiAgICBzdXBlcih7XG4gICAgICBjb250YWluZXJFbCxcbiAgICAgIGNzc0NsYXNzOiBDc3NDbGFzcy5VcmxDb21wb25lbnQsXG4gICAgICB0eXBlOiAndXJsJ1xuICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIEVtcHRpZXMgdGhlIGNvbXBvbmVudC5cbiAgICovXG4gIHB1YmxpYyBlbXB0eSgpOiB2b2lkIHtcbiAgICB0aGlzLnNldFZhbHVlKCcnKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBDaGVja3MgaWYgdGhlIGNvbXBvbmVudCBpcyBlbXB0eS5cbiAgICpcbiAgICogQHJldHVybnMgYHRydWVgIGlmIHRoZSBjb21wb25lbnQgaXMgZW1wdHksIGBmYWxzZWAgb3RoZXJ3aXNlLlxuICAgKi9cbiAgcHVibGljIGlzRW1wdHkoKTogYm9vbGVhbiB7XG4gICAgcmV0dXJuIHRoaXMuZ2V0VmFsdWUoKSA9PT0gJyc7XG4gIH1cblxuICAvKipcbiAgICogU2V0cyB0aGUgcGxhY2Vob2xkZXIgdmFsdWUgb2YgdGhlIGNvbXBvbmVudC5cbiAgICpcbiAgICogQHBhcmFtIHBsYWNlaG9sZGVyVmFsdWUgLSBUaGUgcGxhY2Vob2xkZXIgdmFsdWUgdG8gc2V0LlxuICAgKiBAcmV0dXJucyBUaGUgY29tcG9uZW50LlxuICAgKi9cbiAgcHVibGljIHNldFBsYWNlaG9sZGVyVmFsdWUocGxhY2Vob2xkZXJWYWx1ZTogc3RyaW5nKTogdGhpcyB7XG4gICAgdGhpcy50ZXh0Q29tcG9uZW50LnNldFBsYWNlaG9sZGVyKHBsYWNlaG9sZGVyVmFsdWUpO1xuICAgIHJldHVybiB0aGlzO1xuICB9XG5cbiAgLyoqXG4gICAqIENvbnZlcnRzIGEgc3RyaW5nIHRvIGFuIHVybC5cbiAgICpcbiAgICogQHBhcmFtICRzdHJpbmcgLSBUaGUgc3RyaW5nIHRvIGNvbnZlcnQuXG4gICAqIEByZXR1cm5zIFRoZSB1cmwuXG4gICAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgdmFsdWVGcm9tU3RyaW5nKCRzdHJpbmc6IHN0cmluZyk6IHN0cmluZyB7XG4gICAgcmV0dXJuICRzdHJpbmc7XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFZQSxTQUFTLGdCQUFnQjtBQUN6QixTQUFTLDBCQUEwQjtBQVc1QixNQUFNLHFCQUFxQixtQkFBaUU7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFNMUYsWUFBWSxhQUEwQjtBQUMzQyxVQUFNO0FBQUEsTUFDSjtBQUFBLE1BQ0EsVUFBVSxTQUFTO0FBQUEsTUFDbkIsTUFBTTtBQUFBLElBQ1IsQ0FBQztBQUFBLEVBQ0g7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtPLFFBQWM7QUFDbkIsU0FBSyxTQUFTLEVBQUU7QUFBQSxFQUNsQjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9PLFVBQW1CO0FBQ3hCLFdBQU8sS0FBSyxTQUFTLE1BQU07QUFBQSxFQUM3QjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBUU8sb0JBQW9CLGtCQUFnQztBQUN6RCxTQUFLLGNBQWMsZUFBZSxnQkFBZ0I7QUFDbEQsV0FBTztBQUFBLEVBQ1Q7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVFnQixnQkFBZ0IsU0FBeUI7QUFDdkQsV0FBTztBQUFBLEVBQ1Q7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/setting-components/validator-component.d.mts

@@ -0,0 +1,23 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Contains a component that has a validator element.
+ */
+import type { ValidatorElement } from '@mnaoumov/typescript-lib/html-element';
+/**
+ * A component that has a validator element.
+ */
+export interface ValidatorComponent {
+    /**
+     * A validator element of the component.
+     */
+    readonly validatorEl: ValidatorElement;
+}
+/**
+ * Gets a validator component related to the given object.
+ *
+ * @param $unknown - Any object.
+ * @returns The related validator component or `null` if no related validator component is found.
+ */
+export declare function getValidatorComponent($unknown: unknown): null | ValidatorComponent;

package/dist/lib/esm/setting-components/validator-component.mjs

@@ -0,0 +1,150 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import {
+  ColorComponent,
+  DropdownComponent,
+  ProgressBarComponent,
+  SearchComponent,
+  SliderComponent,
+  TextAreaComponent,
+  TextComponent,
+  ToggleComponent
+} from "obsidian";
+import { CssClass } from "../css-class.mjs";
+import { addPluginCssClasses } from "../plugin/plugin-context.mjs";
+import { ensureWrapped } from "./setting-component-wrapper.mjs";
+class OverlayValidatorComponent {
+  constructor(element) {
+    this.element = element;
+    const wrapper = ensureWrapped(element);
+    this._validatorEl = wrapper.createEl("input", {
+      attr: {
+        tabindex: -1
+      }
+    });
+    addPluginCssClasses(this._validatorEl, CssClass.OverlayValidator);
+    this._validatorEl.addEventListener("focus", () => {
+      this.element.focus();
+    });
+    this._validatorEl.isActiveElement = this.isElementOrDescendantActive.bind(this);
+    let tabIndexEl = this.element.querySelector("[tabindex]");
+    if (!tabIndexEl) {
+      if (this.element.getAttr("tabindex") === null) {
+        this.element.tabIndex = -1;
+      }
+      tabIndexEl = this.element;
+    }
+    this.element.addEventListener("focusin", () => {
+      this.forceBlurValidatorEl();
+    });
+    this.element.addEventListener("click", () => {
+      tabIndexEl.focus();
+    });
+    this.element.addEventListener("focusout", () => {
+      window.setTimeout(() => {
+        if (this.isElementOrDescendantActive()) {
+          return;
+        }
+        this.forceBlurValidatorEl();
+      }, 0);
+    });
+  }
+  element;
+  get validatorEl() {
+    return this._validatorEl;
+  }
+  _validatorEl;
+  forceBlurValidatorEl() {
+    this._validatorEl.dispatchEvent(new Event("blur"));
+  }
+  isElementOrDescendantActive() {
+    return this.element.contains(activeDocument.activeElement);
+  }
+}
+class ValidatorElementWrapper {
+  constructor(validatorEl) {
+    this.validatorEl = validatorEl;
+  }
+  validatorEl;
+}
+function getValidatorComponent($unknown) {
+  if (isValidatorComponent($unknown)) {
+    return $unknown;
+  }
+  if ($unknown instanceof ColorComponent) {
+    return new ValidatorElementWrapper($unknown.colorPickerEl);
+  }
+  if ($unknown instanceof DropdownComponent) {
+    return new ValidatorElementWrapper($unknown.selectEl);
+  }
+  if ($unknown instanceof ProgressBarComponent) {
+    return new OverlayValidatorComponent($unknown.progressBar);
+  }
+  if ($unknown instanceof SearchComponent) {
+    return new ValidatorElementWrapper($unknown.inputEl);
+  }
+  if ($unknown instanceof SliderComponent) {
+    return new ValidatorElementWrapper($unknown.sliderEl);
+  }
+  if ($unknown instanceof TextAreaComponent) {
+    return new ValidatorElementWrapper($unknown.inputEl);
+  }
+  if ($unknown instanceof TextComponent) {
+    return new ValidatorElementWrapper($unknown.inputEl);
+  }
+  return $unknown instanceof ToggleComponent ? new OverlayValidatorComponent($unknown.toggleEl) : null;
+}
+function isValidatorComponent($unknown) {
+  return typeof $unknown === "object" && $unknown !== null && "validatorEl" in $unknown && !!$unknown.validatorEl;
+}
+export {
+  getValidatorComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3NldHRpbmctY29tcG9uZW50cy92YWxpZGF0b3ItY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29udGFpbnMgYSBjb21wb25lbnQgdGhhdCBoYXMgYSB2YWxpZGF0b3IgZWxlbWVudC5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IFZhbGlkYXRvckVsZW1lbnQgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvaHRtbC1lbGVtZW50JztcblxuaW1wb3J0IHtcbiAgQ29sb3JDb21wb25lbnQsXG4gIERyb3Bkb3duQ29tcG9uZW50LFxuICBQcm9ncmVzc0JhckNvbXBvbmVudCxcbiAgU2VhcmNoQ29tcG9uZW50LFxuICBTbGlkZXJDb21wb25lbnQsXG4gIFRleHRBcmVhQ29tcG9uZW50LFxuICBUZXh0Q29tcG9uZW50LFxuICBUb2dnbGVDb21wb25lbnRcbn0gZnJvbSAnb2JzaWRpYW4nO1xuXG5pbXBvcnQgeyBDc3NDbGFzcyB9IGZyb20gJy4uL2Nzcy1jbGFzcy50cyc7XG5pbXBvcnQgeyBhZGRQbHVnaW5Dc3NDbGFzc2VzIH0gZnJvbSAnLi4vcGx1Z2luL3BsdWdpbi1jb250ZXh0LnRzJztcbmltcG9ydCB7IGVuc3VyZVdyYXBwZWQgfSBmcm9tICcuL3NldHRpbmctY29tcG9uZW50LXdyYXBwZXIudHMnO1xuXG4vKipcbiAqIEEgY29tcG9uZW50IHRoYXQgaGFzIGEgdmFsaWRhdG9yIGVsZW1lbnQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgVmFsaWRhdG9yQ29tcG9uZW50IHtcbiAgLyoqXG4gICAqIEEgdmFsaWRhdG9yIGVsZW1lbnQgb2YgdGhlIGNvbXBvbmVudC5cbiAgICovXG4gIHJlYWRvbmx5IHZhbGlkYXRvckVsOiBWYWxpZGF0b3JFbGVtZW50O1xufVxuXG5jbGFzcyBPdmVybGF5VmFsaWRhdG9yQ29tcG9uZW50IGltcGxlbWVudHMgVmFsaWRhdG9yQ29tcG9uZW50IHtcbiAgcHVibGljIGdldCB2YWxpZGF0b3JFbCgpOiBWYWxpZGF0b3JFbGVtZW50IHtcbiAgICByZXR1cm4gdGhpcy5fdmFsaWRhdG9yRWw7XG4gIH1cblxuICBwcml2YXRlIHJlYWRvbmx5IF92YWxpZGF0b3JFbDogVmFsaWRhdG9yRWxlbWVudDtcblxuICBwdWJsaWMgY29uc3RydWN0b3IocHJpdmF0ZSByZWFkb25seSBlbGVtZW50OiBIVE1MRWxlbWVudCkge1xuICAgIGNvbnN0IHdyYXBwZXIgPSBlbnN1cmVXcmFwcGVkKGVsZW1lbnQpO1xuXG4gICAgdGhpcy5fdmFsaWRhdG9yRWwgPSB3cmFwcGVyLmNyZWF0ZUVsKCdpbnB1dCcsIHtcbiAgICAgIGF0dHI6IHtcbiAgICAgICAgdGFiaW5kZXg6IC0xXG4gICAgICB9XG4gICAgfSk7XG4gICAgYWRkUGx1Z2luQ3NzQ2xhc3Nlcyh0aGlzLl92YWxpZGF0b3JFbCwgQ3NzQ2xhc3MuT3ZlcmxheVZhbGlkYXRvcik7XG5cbiAgICB0aGlzLl92YWxpZGF0b3JFbC5hZGRFdmVudExpc3RlbmVyKCdmb2N1cycsICgpID0+IHtcbiAgICAgIHRoaXMuZWxlbWVudC5mb2N1cygpO1xuICAgIH0pO1xuXG4gICAgdGhpcy5fdmFsaWRhdG9yRWwuaXNBY3RpdmVFbGVtZW50ID0gdGhpcy5pc0VsZW1lbnRPckRlc2NlbmRhbnRBY3RpdmUuYmluZCh0aGlzKTtcblxuICAgIGxldCB0YWJJbmRleEVsID0gdGhpcy5lbGVtZW50LnF1ZXJ5U2VsZWN0b3I8SFRNTEVsZW1lbnQ+KCdbdGFiaW5kZXhdJyk7XG4gICAgaWYgKCF0YWJJbmRleEVsKSB7XG4gICAgICBpZiAodGhpcy5lbGVtZW50LmdldEF0dHIoJ3RhYmluZGV4JykgPT09IG51bGwpIHtcbiAgICAgICAgdGhpcy5lbGVtZW50LnRhYkluZGV4ID0gLTE7XG4gICAgICB9XG4gICAgICB0YWJJbmRleEVsID0gdGhpcy5lbGVtZW50O1xuICAgIH1cblxuICAgIHRoaXMuZWxlbWVudC5hZGRFdmVudExpc3RlbmVyKCdmb2N1c2luJywgKCkgPT4ge1xuICAgICAgdGhpcy5mb3JjZUJsdXJWYWxpZGF0b3JFbCgpO1xuICAgIH0pO1xuICAgIHRoaXMuZWxlbWVudC5hZGRFdmVudExpc3RlbmVyKCdjbGljaycsICgpID0+IHtcbiAgICAgIHRhYkluZGV4RWwuZm9jdXMoKTtcbiAgICB9KTtcbiAgICB0aGlzLmVsZW1lbnQuYWRkRXZlbnRMaXN0ZW5lcignZm9jdXNvdXQnLCAoKSA9PiB7XG4gICAgICB3aW5kb3cuc2V0VGltZW91dCgoKSA9PiB7XG4gICAgICAgIGlmICh0aGlzLmlzRWxlbWVudE9yRGVzY2VuZGFudEFjdGl2ZSgpKSB7XG4gICAgICAgICAgcmV0dXJuO1xuICAgICAgICB9XG5cbiAgICAgICAgdGhpcy5mb3JjZUJsdXJWYWxpZGF0b3JFbCgpO1xuICAgICAgfSwgMCk7XG4gICAgfSk7XG4gIH1cblxuICBwcml2YXRlIGZvcmNlQmx1clZhbGlkYXRvckVsKCk6IHZvaWQge1xuICAgIHRoaXMuX3ZhbGlkYXRvckVsLmRpc3BhdGNoRXZlbnQobmV3IEV2ZW50KCdibHVyJykpO1xuICB9XG5cbiAgcHJpdmF0ZSBpc0VsZW1lbnRPckRlc2NlbmRhbnRBY3RpdmUoKTogYm9vbGVhbiB7XG4gICAgcmV0dXJuIHRoaXMuZWxlbWVudC5jb250YWlucyhhY3RpdmVEb2N1bWVudC5hY3RpdmVFbGVtZW50KTtcbiAgfVxufVxuXG5jbGFzcyBWYWxpZGF0b3JFbGVtZW50V3JhcHBlciBpbXBsZW1lbnRzIFZhbGlkYXRvckNvbXBvbmVudCB7XG4gIHB1YmxpYyBjb25zdHJ1Y3RvcihwdWJsaWMgcmVhZG9ubHkgdmFsaWRhdG9yRWw6IFZhbGlkYXRvckVsZW1lbnQpIHt9XG59XG5cbi8qKlxuICogR2V0cyBhIHZhbGlkYXRvciBjb21wb25lbnQgcmVsYXRlZCB0byB0aGUgZ2l2ZW4gb2JqZWN0LlxuICpcbiAqIEBwYXJhbSAkdW5rbm93biAtIEFueSBvYmplY3QuXG4gKiBAcmV0dXJucyBUaGUgcmVsYXRlZCB2YWxpZGF0b3IgY29tcG9uZW50IG9yIGBudWxsYCBpZiBubyByZWxhdGVkIHZhbGlkYXRvciBjb21wb25lbnQgaXMgZm91bmQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRWYWxpZGF0b3JDb21wb25lbnQoJHVua25vd246IHVua25vd24pOiBudWxsIHwgVmFsaWRhdG9yQ29tcG9uZW50IHtcbiAgaWYgKGlzVmFsaWRhdG9yQ29tcG9uZW50KCR1bmtub3duKSkge1xuICAgIHJldHVybiAkdW5rbm93bjtcbiAgfVxuXG4gIGlmICgkdW5rbm93biBpbnN0YW5jZW9mIENvbG9yQ29tcG9uZW50KSB7XG4gICAgcmV0dXJuIG5ldyBWYWxpZGF0b3JFbGVtZW50V3JhcHBlcigkdW5rbm93bi5jb2xvclBpY2tlckVsKTtcbiAgfVxuXG4gIGlmICgkdW5rbm93biBpbnN0YW5jZW9mIERyb3Bkb3duQ29tcG9uZW50KSB7XG4gICAgcmV0dXJuIG5ldyBWYWxpZGF0b3JFbGVtZW50V3JhcHBlcigkdW5rbm93bi5zZWxlY3RFbCk7XG4gIH1cblxuICBpZiAoJHVua25vd24gaW5zdGFuY2VvZiBQcm9ncmVzc0JhckNvbXBvbmVudCkge1xuICAgIHJldHVybiBuZXcgT3ZlcmxheVZhbGlkYXRvckNvbXBvbmVudCgkdW5rbm93bi5wcm9ncmVzc0Jhcik7XG4gIH1cblxuICBpZiAoJHVua25vd24gaW5zdGFuY2VvZiBTZWFyY2hDb21wb25lbnQpIHtcbiAgICByZXR1cm4gbmV3IFZhbGlkYXRvckVsZW1lbnRXcmFwcGVyKCR1bmtub3duLmlucHV0RWwpO1xuICB9XG5cbiAgaWYgKCR1bmtub3duIGluc3RhbmNlb2YgU2xpZGVyQ29tcG9uZW50KSB7XG4gICAgcmV0dXJuIG5ldyBWYWxpZGF0b3JFbGVtZW50V3JhcHBlcigkdW5rbm93bi5zbGlkZXJFbCk7XG4gIH1cblxuICBpZiAoJHVua25vd24gaW5zdGFuY2VvZiBUZXh0QXJlYUNvbXBvbmVudCkge1xuICAgIHJldHVybiBuZXcgVmFsaWRhdG9yRWxlbWVudFdyYXBwZXIoJHVua25vd24uaW5wdXRFbCk7XG4gIH1cblxuICBpZiAoJHVua25vd24gaW5zdGFuY2VvZiBUZXh0Q29tcG9uZW50KSB7XG4gICAgcmV0dXJuIG5ldyBWYWxpZGF0b3JFbGVtZW50V3JhcHBlcigkdW5rbm93bi5pbnB1dEVsKTtcbiAgfVxuXG4gIHJldHVybiAkdW5rbm93biBpbnN0YW5jZW9mIFRvZ2dsZUNvbXBvbmVudCA/IG5ldyBPdmVybGF5VmFsaWRhdG9yQ29tcG9uZW50KCR1bmtub3duLnRvZ2dsZUVsKSA6IG51bGw7XG59XG5cbmZ1bmN0aW9uIGlzVmFsaWRhdG9yQ29tcG9uZW50KCR1bmtub3duOiB1bmtub3duKTogJHVua25vd24gaXMgVmFsaWRhdG9yQ29tcG9uZW50IHtcbiAgcmV0dXJuIHR5cGVvZiAkdW5rbm93biA9PT0gJ29iamVjdCcgJiYgJHVua25vd24gIT09IG51bGwgJiYgJ3ZhbGlkYXRvckVsJyBpbiAkdW5rbm93biAmJiAhISgkdW5rbm93biBhcyBQYXJ0aWFsPFZhbGlkYXRvckNvbXBvbmVudD4pLnZhbGlkYXRvckVsO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQVFBO0FBQUEsRUFDRTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxPQUNLO0FBRVAsU0FBUyxnQkFBZ0I7QUFDekIsU0FBUywyQkFBMkI7QUFDcEMsU0FBUyxxQkFBcUI7QUFZOUIsTUFBTSwwQkFBd0Q7QUFBQSxFQU9yRCxZQUE2QixTQUFzQjtBQUF0QjtBQUNsQyxVQUFNLFVBQVUsY0FBYyxPQUFPO0FBRXJDLFNBQUssZUFBZSxRQUFRLFNBQVMsU0FBUztBQUFBLE1BQzVDLE1BQU07QUFBQSxRQUNKLFVBQVU7QUFBQSxNQUNaO0FBQUEsSUFDRixDQUFDO0FBQ0Qsd0JBQW9CLEtBQUssY0FBYyxTQUFT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

package/dist/lib/esm/setting-components/value-component-with-change-tracking.d.mts

@@ -0,0 +1,20 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Contains a type that extends ValueComponent to allow for change tracking.
+ */
+import type { ValueComponent } from 'obsidian';
+/**
+ * A ValueComponent that can track changes.
+ *
+ * @typeParam T - The type of the value to set.
+ */
+export interface ValueComponentWithChangeTracking<T> extends ValueComponent<T> {
+    /**
+     * Sets a callback function to be called when the value of the component changes.
+     *
+     * @param callback - A callback function that is called when the value of the component changes.
+     */
+    onChange: (callback: (newValue: T) => void) => this;
+}

package/dist/lib/esm/setting-components/value-component-with-change-tracking.mjs

@@ -0,0 +1,50 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFtdLAogICJzb3VyY2VzQ29udGVudCI6IFtdLAogICJtYXBwaW5ncyI6ICIiLAogICJuYW1lcyI6IFtdCn0K