@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/esm/setting-components/telephone-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 TelephoneComponent extends TypedTextComponent {
+  /**
+   * Creates a new telephone component.
+   *
+   * @param containerEl - The container element of the component.
+   */
+  constructor(containerEl) {
+    super({
+      containerEl,
+      cssClass: CssClass.TelephoneComponent,
+      type: "tel"
+    });
+  }
+  /**
+   * Empties the component.
+   */
+  empty() {
+    this.textComponent.setValue("");
+  }
+  /**
+   * Checks if the component is empty.
+   *
+   * @returns `true` if the component is empty, `false` otherwise.
+   */
+  isEmpty() {
+    return this.textComponent.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;
+  }
+  /**
+   * Gets the value from a string.
+   *
+   * @param $string - The string to get the value from.
+   * @returns The value from the string.
+   */
+  valueFromString($string) {
+    return $string;
+  }
+}
+export {
+  TelephoneComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3NldHRpbmctY29tcG9uZW50cy90ZWxlcGhvbmUtY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29udGFpbnMgYSBjb21wb25lbnQgdGhhdCBhbGxvd3MgdGhlIHVzZXIgdG8gZW50ZXIgYSB0ZWxlcGhvbmUgbnVtYmVyLlxuICovXG5cbi8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBAdHlwZXNjcmlwdC1lc2xpbnQvbm8tdW51c2VkLXZhcnMgLS0gV2UgbmVlZCB0byBpbXBvcnQgYGluaXRQbHVnaW5Db250ZXh0YCB0byB1c2UgaXQgaW4gdGhlIHRzZG9jcy5cbmltcG9ydCB0eXBlIHsgaW5pdFBsdWdpbkNvbnRleHQgfSBmcm9tICcuLi9wbHVnaW4vcGx1Z2luLWNvbnRleHQudHMnO1xuLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby11bnVzZWQtdmFycyAtLSBXZSBuZWVkIHRvIGltcG9ydCBgU2V0dGluZ0V4YCB0byB1c2UgaXQgaW4gdGhlIHRzZG9jcy5cbmltcG9ydCB0eXBlIHsgU2V0dGluZ0V4IH0gZnJvbSAnLi4vc2V0dGluZy1leC50cyc7XG5pbXBvcnQgdHlwZSB7IFRleHRCYXNlZENvbXBvbmVudCB9IGZyb20gJy4vdGV4dC1iYXNlZC1jb21wb25lbnQudHMnO1xuXG5pbXBvcnQgeyBDc3NDbGFzcyB9IGZyb20gJy4uL2Nzcy1jbGFzcy50cyc7XG5pbXBvcnQgeyBUeXBlZFRleHRDb21wb25lbnQgfSBmcm9tICcuL3R5cGVkLXRleHQtY29tcG9uZW50LnRzJztcblxuLyoqXG4gKiBBIGNvbXBvbmVudCB0aGF0IGFsbG93cyB0aGUgdXNlciB0byBlbnRlciBhIHRlbGVwaG9uZSBudW1iZXIuXG4gKlxuICogSXQgbG9va3MgbGlrZSByZWd1bGFyIHRleHQgY29tcG9uZW50IG9uIGRlc2t0b3AgYnV0IGNoYW5nZXMga2V5Ym9hcmQgdG8gZGlnaXRzIG9ubHkgb24gbW9iaWxlLlxuICpcbiAqIFlvdSBjYW4gYWRkIHRoaXMgY29tcG9uZW50IHVzaW5nIHtAbGluayBTZXR0aW5nRXguYWRkVGVsZXBob25lfS5cbiAqXG4gKiBJbiBvcmRlciB0byBhZGQgdGhlIHN0eWxlcyBmb3IgdGhlIGNvbXBvbmVudCwgdXNlIHtAbGluayBpbml0UGx1Z2luQ29udGV4dH0gaW4geW91ciBwbHVnaW4ncyBgb25sb2FkKClgIGZ1bmN0aW9uLlxuICpcbiAqIEFsdGVybmF0aXZlbHksIHlvdSBjYW4gY29weSBzdHlsZXMgZnJvbSB7QGxpbmsgaHR0cHM6Ly9naXRodWIuY29tL21uYW91bW92L29ic2lkaWFuLWRldi11dGlscy9yZWxlYXNlcy9sYXRlc3QvZG93bmxvYWQvc3R5bGVzLmNzc30uXG4gKi9cbmV4cG9ydCBjbGFzcyBUZWxlcGhvbmVDb21wb25lbnQgZXh0ZW5kcyBUeXBlZFRleHRDb21wb25lbnQ8c3RyaW5nPiBpbXBsZW1lbnRzIFRleHRCYXNlZENvbXBvbmVudDxzdHJpbmc+IHtcbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgdGVsZXBob25lIGNvbXBvbmVudC5cbiAgICpcbiAgICogQHBhcmFtIGNvbnRhaW5lckVsIC0gVGhlIGNvbnRhaW5lciBlbGVtZW50IG9mIHRoZSBjb21wb25lbnQuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IoY29udGFpbmVyRWw6IEhUTUxFbGVtZW50KSB7XG4gICAgc3VwZXIoe1xuICAgICAgY29udGFpbmVyRWwsXG4gICAgICBjc3NDbGFzczogQ3NzQ2xhc3MuVGVsZXBob25lQ29tcG9uZW50LFxuICAgICAgdHlwZTogJ3RlbCdcbiAgICB9KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBFbXB0aWVzIHRoZSBjb21wb25lbnQuXG4gICAqL1xuICBwdWJsaWMgZW1wdHkoKTogdm9pZCB7XG4gICAgdGhpcy50ZXh0Q29tcG9uZW50LnNldFZhbHVlKCcnKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBDaGVja3MgaWYgdGhlIGNvbXBvbmVudCBpcyBlbXB0eS5cbiAgICpcbiAgICogQHJldHVybnMgYHRydWVgIGlmIHRoZSBjb21wb25lbnQgaXMgZW1wdHksIGBmYWxzZWAgb3RoZXJ3aXNlLlxuICAgKi9cbiAgcHVibGljIGlzRW1wdHkoKTogYm9vbGVhbiB7XG4gICAgcmV0dXJuIHRoaXMudGV4dENvbXBvbmVudC5nZXRWYWx1ZSgpID09PSAnJztcbiAgfVxuXG4gIC8qKlxuICAgKiBTZXRzIHRoZSBwbGFjZWhvbGRlciB2YWx1ZSBvZiB0aGUgY29tcG9uZW50LlxuICAgKlxuICAgKiBAcGFyYW0gcGxhY2Vob2xkZXJWYWx1ZSAtIFRoZSBwbGFjZWhvbGRlciB2YWx1ZSB0byBzZXQuXG4gICAqIEByZXR1cm5zIFRoZSBjb21wb25lbnQuXG4gICAqL1xuICBwdWJsaWMgc2V0UGxhY2Vob2xkZXJWYWx1ZShwbGFjZWhvbGRlclZhbHVlOiBzdHJpbmcpOiB0aGlzIHtcbiAgICB0aGlzLnRleHRDb21wb25lbnQuc2V0UGxhY2Vob2xkZXIocGxhY2Vob2xkZXJWYWx1ZSk7XG4gICAgcmV0dXJuIHRoaXM7XG4gIH1cblxuICAvKipcbiAgICogR2V0cyB0aGUgdmFsdWUgZnJvbSBhIHN0cmluZy5cbiAgICpcbiAgICogQHBhcmFtICRzdHJpbmcgLSBUaGUgc3RyaW5nIHRvIGdldCB0aGUgdmFsdWUgZnJvbS5cbiAgICogQHJldHVybnMgVGhlIHZhbHVlIGZyb20gdGhlIHN0cmluZy5cbiAgICovXG4gIHB1YmxpYyBvdmVycmlkZSB2YWx1ZUZyb21TdHJpbmcoJHN0cmluZzogc3RyaW5nKTogc3RyaW5nIHtcbiAgICByZXR1cm4gJHN0cmluZztcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQVlBLFNBQVMsZ0JBQWdCO0FBQ3pCLFNBQVMsMEJBQTBCO0FBYTVCLE1BQU0sMkJBQTJCLG1CQUFpRTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU1oRyxZQUFZLGFBQTBCO0FBQzNDLFVBQU07QUFBQSxNQUNKO0FBQUEsTUFDQSxVQUFVLFNBQVM7QUFBQSxNQUNuQixNQUFNO0FBQUEsSUFDUixDQUFDO0FBQUEsRUFDSDtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBS08sUUFBYztBQUNuQixTQUFLLGNBQWMsU0FBUyxFQUFFO0FBQUEsRUFDaEM7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFPTyxVQUFtQjtBQUN4QixXQUFPLEtBQUssY0FBYyxTQUFTLE1BQU07QUFBQSxFQUMzQztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBUU8sb0JBQW9CLGtCQUFnQztBQUN6RCxTQUFLLGNBQWMsZUFBZSxnQkFBZ0I7QUFDbEQsV0FBTztBQUFBLEVBQ1Q7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVFnQixnQkFBZ0IsU0FBeUI7QUFDdkQsV0FBTztBQUFBLEVBQ1Q7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K

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

@@ -0,0 +1,38 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Text based component utilities.
+ */
+/**
+ * A component based on a text input.
+ *
+ * @typeParam T - The type of the value to set.
+ */
+export interface TextBasedComponent<T> {
+    /**
+     * 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: T) => this;
+}
+/**
+ * Gets the text based component value of the component.
+ *
+ * @typeParam T - The type of the value to get.
+ * @param $unknown - Any object.
+ * @returns The text based component value of the component or `null` if the component is not a text based component.
+ */
+export declare function getTextBasedComponentValue<T>($unknown: unknown): null | TextBasedComponent<T>;

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

@@ -0,0 +1,81 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import { AbstractTextComponent } from "obsidian";
+class AbstractTextComponentWrapper {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- `unknown` doesn't work, getting compiler errors.
+  constructor(abstractTextComponent) {
+    this.abstractTextComponent = abstractTextComponent;
+  }
+  abstractTextComponent;
+  empty() {
+    this.abstractTextComponent.setValue("");
+  }
+  isEmpty() {
+    return this.abstractTextComponent.getValue() === "";
+  }
+  setPlaceholderValue(placeholderValue) {
+    this.abstractTextComponent.setPlaceholder(placeholderValue);
+    return this;
+  }
+}
+function getTextBasedComponentValue($unknown) {
+  if (isTextBasedComponent($unknown)) {
+    return $unknown;
+  }
+  return $unknown instanceof AbstractTextComponent ? new AbstractTextComponentWrapper($unknown) : null;
+}
+function isTextBasedComponent(component) {
+  const textBasedComponent = component;
+  return typeof textBasedComponent.setPlaceholderValue === "function" && typeof textBasedComponent.isEmpty === "function";
+}
+export {
+  getTextBasedComponentValue
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3NldHRpbmctY29tcG9uZW50cy90ZXh0LWJhc2VkLWNvbXBvbmVudC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRleHQgYmFzZWQgY29tcG9uZW50IHV0aWxpdGllcy5cbiAqL1xuXG5pbXBvcnQgeyBBYnN0cmFjdFRleHRDb21wb25lbnQgfSBmcm9tICdvYnNpZGlhbic7XG5cbi8qKlxuICogQSBjb21wb25lbnQgYmFzZWQgb24gYSB0ZXh0IGlucHV0LlxuICpcbiAqIEB0eXBlUGFyYW0gVCAtIFRoZSB0eXBlIG9mIHRoZSB2YWx1ZSB0byBzZXQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgVGV4dEJhc2VkQ29tcG9uZW50PFQ+IHtcbiAgLyoqXG4gICAqIEVtcHRpZXMgdGhlIGNvbXBvbmVudC5cbiAgICovXG4gIGVtcHR5OiAoKSA9PiB2b2lkO1xuXG4gIC8qKlxuICAgKiBDaGVja3MgaWYgdGhlIGNvbXBvbmVudCBpcyBlbXB0eS5cbiAgICpcbiAgICogQHJldHVybnMgYHRydWVgIGlmIHRoZSBjb21wb25lbnQgaXMgZW1wdHksIGBmYWxzZWAgb3RoZXJ3aXNlLlxuICAgKi9cbiAgaXNFbXB0eTogKCkgPT4gYm9vbGVhbjtcblxuICAvKipcbiAgICogU2V0cyB0aGUgcGxhY2Vob2xkZXIgdmFsdWUgb2YgdGhlIGNvbXBvbmVudC5cbiAgICpcbiAgICogQHBhcmFtIHBsYWNlaG9sZGVyVmFsdWUgLSBUaGUgcGxhY2Vob2xkZXIgdmFsdWUgdG8gc2V0LlxuICAgKiBAcmV0dXJucyBUaGUgY29tcG9uZW50LlxuICAgKi9cbiAgc2V0UGxhY2Vob2xkZXJWYWx1ZTogKHBsYWNlaG9sZGVyVmFsdWU6IFQpID0+IHRoaXM7XG59XG5cbmNsYXNzIEFic3RyYWN0VGV4dENvbXBvbmVudFdyYXBwZXI8VD4gaW1wbGVtZW50cyBUZXh0QmFzZWRDb21wb25lbnQ8VD4ge1xuICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgQHR5cGVzY3JpcHQtZXNsaW50L25vLWV4cGxpY2l0LWFueSAtLSBgdW5rbm93bmAgZG9lc24ndCB3b3JrLCBnZXR0aW5nIGNvbXBpbGVyIGVycm9ycy5cbiAgcHVibGljIGNvbnN0cnVjdG9yKHByaXZhdGUgcmVhZG9ubHkgYWJzdHJhY3RUZXh0Q29tcG9uZW50OiBBYnN0cmFjdFRleHRDb21wb25lbnQ8YW55Pikge31cblxuICBwdWJsaWMgZW1wdHkoKTogdm9pZCB7XG4gICAgdGhpcy5hYnN0cmFjdFRleHRDb21wb25lbnQuc2V0VmFsdWUoJycpO1xuICB9XG5cbiAgcHVibGljIGlzRW1wdHkoKTogYm9vbGVhbiB7XG4gICAgcmV0dXJuIHRoaXMuYWJzdHJhY3RUZXh0Q29tcG9uZW50LmdldFZhbHVlKCkgPT09ICcnO1xuICB9XG5cbiAgcHVibGljIHNldFBsYWNlaG9sZGVyVmFsdWUocGxhY2Vob2xkZXJWYWx1ZTogVCk6IHRoaXMge1xuICAgIHRoaXMuYWJzdHJhY3RUZXh0Q29tcG9uZW50LnNldFBsYWNlaG9sZGVyKHBsYWNlaG9sZGVyVmFsdWUgYXMgc3RyaW5nKTtcbiAgICByZXR1cm4gdGhpcztcbiAgfVxufVxuXG4vKipcbiAqIEdldHMgdGhlIHRleHQgYmFzZWQgY29tcG9uZW50IHZhbHVlIG9mIHRoZSBjb21wb25lbnQuXG4gKlxuICogQHR5cGVQYXJhbSBUIC0gVGhlIHR5cGUgb2YgdGhlIHZhbHVlIHRvIGdldC5cbiAqIEBwYXJhbSAkdW5rbm93biAtIEFueSBvYmplY3QuXG4gKiBAcmV0dXJucyBUaGUgdGV4dCBiYXNlZCBjb21wb25lbnQgdmFsdWUgb2YgdGhlIGNvbXBvbmVudCBvciBgbnVsbGAgaWYgdGhlIGNvbXBvbmVudCBpcyBub3QgYSB0ZXh0IGJhc2VkIGNvbXBvbmVudC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldFRleHRCYXNlZENvbXBvbmVudFZhbHVlPFQ+KCR1bmtub3duOiB1bmtub3duKTogbnVsbCB8IFRleHRCYXNlZENvbXBvbmVudDxUPiB7XG4gIGlmIChpc1RleHRCYXNlZENvbXBvbmVudCgkdW5rbm93bikpIHtcbiAgICByZXR1cm4gJHVua25vd247XG4gIH1cblxuICByZXR1cm4gJHVua25vd24gaW5zdGFuY2VvZiBBYnN0cmFjdFRleHRDb21wb25lbnQgPyBuZXcgQWJzdHJhY3RUZXh0Q29tcG9uZW50V3JhcHBlcjxUPigkdW5rbm93bikgOiBudWxsO1xufVxuXG5mdW5jdGlvbiBpc1RleHRCYXNlZENvbXBvbmVudDxUPihjb21wb25lbnQ6IHVua25vd24pOiBjb21wb25lbnQgaXMgVGV4dEJhc2VkQ29tcG9uZW50PFQ+IHtcbiAgY29uc3QgdGV4dEJhc2VkQ29tcG9uZW50ID0gY29tcG9uZW50IGFzIFBhcnRpYWw8VGV4dEJhc2VkQ29tcG9uZW50PFQ+PjtcbiAgcmV0dXJuIHR5cGVvZiB0ZXh0QmFzZWRDb21wb25lbnQuc2V0UGxhY2Vob2xkZXJWYWx1ZSA9PT0gJ2Z1bmN0aW9uJyAmJiB0eXBlb2YgdGV4dEJhc2VkQ29tcG9uZW50LmlzRW1wdHkgPT09ICdmdW5jdGlvbic7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBTUEsU0FBUyw2QkFBNkI7QUE2QnRDLE1BQU0sNkJBQWlFO0FBQUE7QUFBQSxFQUU5RCxZQUE2Qix1QkFBbUQ7QUFBbkQ7QUFBQSxFQUFvRDtBQUFBLEVBQXBEO0FBQUEsRUFFN0IsUUFBYztBQUNuQixTQUFLLHNCQUFzQixTQUFTLEVBQUU7QUFBQSxFQUN4QztBQUFBLEVBRU8sVUFBbUI7QUFDeEIsV0FBTyxLQUFLLHNCQUFzQixTQUFTLE1BQU07QUFBQSxFQUNuRDtBQUFBLEVBRU8sb0JBQW9CLGtCQUEyQjtBQUNwRCxTQUFLLHNCQUFzQixlQUFlLGdCQUEwQjtBQUNwRSxXQUFPO0FBQUEsRUFDVDtBQUNGO0FBU08sU0FBUywyQkFBOEIsVUFBaUQ7QUFDN0YsTUFBSSxxQkFBcUIsUUFBUSxHQUFHO0FBQ2xDLFdBQU87QUFBQSxFQUNUO0FBRUEsU0FBTyxvQkFBb0Isd0JBQXdCLElBQUksNkJBQWdDLFFBQVEsSUFBSTtBQUNyRztBQUVBLFNBQVMscUJBQXdCLFdBQXdEO0FBQ3ZGLFFBQU0scUJBQXFCO0FBQzNCLFNBQU8sT0FBTyxtQkFBbUIsd0JBQXdCLGNBQWMsT0FBTyxtQkFBbUIsWUFBWTtBQUMvRzsiLAogICJuYW1lcyI6IFtdCn0K

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

@@ -0,0 +1,38 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Contains a component that displays and edits a time.
+ */
+import { TypedRangeTextComponent } from './typed-range-text-component.mjs';
+/**
+ * A component that displays and edits a time.
+ *
+ * You can add this component using {@link SettingEx.addTime}.
+ *
+ * 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 TimeComponent extends TypedRangeTextComponent<moment.Duration> {
+    /**
+     * Creates a new time component.
+     *
+     * @param containerEl - The container element of the component.
+     */
+    constructor(containerEl: HTMLElement);
+    /**
+     * Converts a string to a time.
+     *
+     * @param $string - The string to convert.
+     * @returns The date.
+     */
+    valueFromString($string: string): moment.Duration;
+    /**
+     * Converts a time to a string.
+     *
+     * @param value - The time to convert.
+     * @returns The string.
+     */
+    valueToString(value: moment.Duration): string;
+}

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

@@ -0,0 +1,96 @@
+/*
+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 { moment } from "obsidian";
+import { CssClass } from "../css-class.mjs";
+import { TypedRangeTextComponent } from "./typed-range-text-component.mjs";
+class TimeComponent extends TypedRangeTextComponent {
+  /**
+   * Creates a new time component.
+   *
+   * @param containerEl - The container element of the component.
+   */
+  constructor(containerEl) {
+    super({
+      containerEl,
+      cssClass: CssClass.TimeComponent,
+      type: "time"
+    });
+  }
+  /**
+   * Converts a string to a time.
+   *
+   * @param $string - The string to convert.
+   * @returns The date.
+   */
+  valueFromString($string) {
+    return moment.duration($string);
+  }
+  /**
+   * Converts a time to a string.
+   *
+   * @param value - The time to convert.
+   * @returns The string.
+   */
+  valueToString(value) {
+    let format;
+    if (value.milliseconds() > 0) {
+      format = "HH:mm:ss.SSS";
+    } else if (value.seconds() > 0) {
+      format = "HH:mm:ss";
+    } else {
+      format = "HH:mm";
+    }
+    return moment.utc(value.asMilliseconds()).format(format);
+  }
+}
+export {
+  TimeComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3NldHRpbmctY29tcG9uZW50cy90aW1lLWNvbXBvbmVudC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbnRhaW5zIGEgY29tcG9uZW50IHRoYXQgZGlzcGxheXMgYW5kIGVkaXRzIGEgdGltZS5cbiAqL1xuXG5pbXBvcnQgeyBtb21lbnQgfSBmcm9tICdvYnNpZGlhbic7XG5cbi8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBAdHlwZXNjcmlwdC1lc2xpbnQvbm8tdW51c2VkLXZhcnMgLS0gV2UgbmVlZCB0byBpbXBvcnQgYGluaXRQbHVnaW5Db250ZXh0YCB0byB1c2UgaXQgaW4gdGhlIHRzZG9jcy5cbmltcG9ydCB0eXBlIHsgaW5pdFBsdWdpbkNvbnRleHQgfSBmcm9tICcuLi9wbHVnaW4vcGx1Z2luLWNvbnRleHQudHMnO1xuLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby11bnVzZWQtdmFycyAtLSBXZSBuZWVkIHRvIGltcG9ydCBgU2V0dGluZ0V4YCB0byB1c2UgaXQgaW4gdGhlIHRzZG9jcy5cbmltcG9ydCB0eXBlIHsgU2V0dGluZ0V4IH0gZnJvbSAnLi4vc2V0dGluZy1leC50cyc7XG5cbmltcG9ydCB7IENzc0NsYXNzIH0gZnJvbSAnLi4vY3NzLWNsYXNzLnRzJztcbmltcG9ydCB7IFR5cGVkUmFuZ2VUZXh0Q29tcG9uZW50IH0gZnJvbSAnLi90eXBlZC1yYW5nZS10ZXh0LWNvbXBvbmVudC50cyc7XG5cbi8qKlxuICogQSBjb21wb25lbnQgdGhhdCBkaXNwbGF5cyBhbmQgZWRpdHMgYSB0aW1lLlxuICpcbiAqIFlvdSBjYW4gYWRkIHRoaXMgY29tcG9uZW50IHVzaW5nIHtAbGluayBTZXR0aW5nRXguYWRkVGltZX0uXG4gKlxuICogSW4gb3JkZXIgdG8gYWRkIHRoZSBzdHlsZXMgZm9yIHRoZSBjb21wb25lbnQsIHVzZSB7QGxpbmsgaW5pdFBsdWdpbkNvbnRleHR9IGluIHlvdXIgcGx1Z2luJ3MgYG9ubG9hZCgpYCBmdW5jdGlvbi5cbiAqXG4gKiBBbHRlcm5hdGl2ZWx5LCB5b3UgY2FuIGNvcHkgc3R5bGVzIGZyb20ge0BsaW5rIGh0dHBzOi8vZ2l0aHViLmNvbS9tbmFvdW1vdi9vYnNpZGlhbi1kZXYtdXRpbHMvcmVsZWFzZXMvbGF0ZXN0L2Rvd25sb2FkL3N0eWxlcy5jc3N9LlxuICovXG5leHBvcnQgY2xhc3MgVGltZUNvbXBvbmVudCBleHRlbmRzIFR5cGVkUmFuZ2VUZXh0Q29tcG9uZW50PG1vbWVudC5EdXJhdGlvbj4ge1xuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyB0aW1lIGNvbXBvbmVudC5cbiAgICpcbiAgICogQHBhcmFtIGNvbnRhaW5lckVsIC0gVGhlIGNvbnRhaW5lciBlbGVtZW50IG9mIHRoZSBjb21wb25lbnQuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IoY29udGFpbmVyRWw6IEhUTUxFbGVtZW50KSB7XG4gICAgc3VwZXIoe1xuICAgICAgY29udGFpbmVyRWwsXG4gICAgICBjc3NDbGFzczogQ3NzQ2xhc3MuVGltZUNvbXBvbmVudCxcbiAgICAgIHR5cGU6ICd0aW1lJ1xuICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIENvbnZlcnRzIGEgc3RyaW5nIHRvIGEgdGltZS5cbiAgICpcbiAgICogQHBhcmFtICRzdHJpbmcgLSBUaGUgc3RyaW5nIHRvIGNvbnZlcnQuXG4gICAqIEByZXR1cm5zIFRoZSBkYXRlLlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIHZhbHVlRnJvbVN0cmluZygkc3RyaW5nOiBzdHJpbmcpOiBtb21lbnQuRHVyYXRpb24ge1xuICAgIHJldHVybiBtb21lbnQuZHVyYXRpb24oJHN0cmluZyk7XG4gIH1cblxuICAvKipcbiAgICogQ29udmVydHMgYSB0aW1lIHRvIGEgc3RyaW5nLlxuICAgKlxuICAgKiBAcGFyYW0gdmFsdWUgLSBUaGUgdGltZSB0byBjb252ZXJ0LlxuICAgKiBAcmV0dXJucyBUaGUgc3RyaW5nLlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIHZhbHVlVG9TdHJpbmcodmFsdWU6IG1vbWVudC5EdXJhdGlvbik6IHN0cmluZyB7XG4gICAgbGV0IGZvcm1hdDogc3RyaW5nO1xuICAgIGlmICh2YWx1ZS5taWxsaXNlY29uZHMoKSA+IDApIHtcbiAgICAgIGZvcm1hdCA9ICdISDptbTpzcy5TU1MnO1xuICAgIH0gZWxzZSBpZiAodmFsdWUuc2Vjb25kcygpID4gMCkge1xuICAgICAgZm9ybWF0ID0gJ0hIOm1tOnNzJztcbiAgICB9IGVsc2Uge1xuICAgICAgZm9ybWF0ID0gJ0hIOm1tJztcbiAgICB9XG5cbiAgICByZXR1cm4gbW9tZW50LnV0Yyh2YWx1ZS5hc01pbGxpc2Vjb25kcygpKS5mb3JtYXQoZm9ybWF0KTtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQU1BLFNBQVMsY0FBYztBQU92QixTQUFTLGdCQUFnQjtBQUN6QixTQUFTLCtCQUErQjtBQVdqQyxNQUFNLHNCQUFzQix3QkFBeUM7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFNbkUsWUFBWSxhQUEwQjtBQUMzQyxVQUFNO0FBQUEsTUFDSjtBQUFBLE1BQ0EsVUFBVSxTQUFTO0FBQUEsTUFDbkIsTUFBTTtBQUFBLElBQ1IsQ0FBQztBQUFBLEVBQ0g7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVFnQixnQkFBZ0IsU0FBa0M7QUFDaEUsV0FBTyxPQUFPLFNBQVMsT0FBTztBQUFBLEVBQ2hDO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFRZ0IsY0FBYyxPQUFnQztBQUM1RCxRQUFJO0FBQ0osUUFBSSxNQUFNLGFBQWEsSUFBSSxHQUFHO0FBQzVCLGVBQVM7QUFBQSxJQUNYLFdBQVcsTUFBTSxRQUFRLElBQUksR0FBRztBQUM5QixlQUFTO0FBQUEsSUFDWCxPQUFPO0FBQ0wsZUFBUztBQUFBLElBQ1g7QUFFQSxXQUFPLE9BQU8sSUFBSSxNQUFNLGVBQWUsQ0FBQyxFQUFFLE9BQU8sTUFBTTtBQUFBLEVBQ3pEO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/setting-components/tri-state-checkbox-component.d.mts

@@ -0,0 +1,69 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Tri-state checkbox component.
+ */
+import type { ValidatorElement } from '@mnaoumov/typescript-lib/html-element';
+import { ValueComponent } from 'obsidian';
+import type { ValidatorComponent } from './validator-component.mjs';
+import type { ValueComponentWithChangeTracking } from './value-component-with-change-tracking.mjs';
+/**
+ * A component that displays a tri-state checkbox.
+ *
+ * You can add this component using {@link SettingEx.addTriStateCheckbox}.
+ *
+ * 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 TriStateCheckboxComponent extends ValueComponent<boolean | null> implements ValidatorComponent, ValueComponentWithChangeTracking<boolean | null> {
+    /**
+     * An input element of the checkbox.
+     */
+    readonly inputEl: HTMLInputElement;
+    /**
+     * A validator element of the checkbox.
+     *
+     * @returns The validator element.
+     */
+    get validatorEl(): ValidatorElement;
+    private changeCallback?;
+    /**
+     * Creates a new tri-state checkbox component.
+     *
+     * @param containerEl - The container element.
+     */
+    constructor(containerEl: HTMLElement);
+    /**
+     * Gets the value of the checkbox.
+     *
+     * @returns The value of the checkbox.
+     */
+    getValue(): boolean | null;
+    /**
+     * 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: (newValue: boolean | null) => void): this;
+    /**
+     * Called when the checkbox is changed.
+     */
+    onChanged(): void;
+    /**
+     * Sets the disabled state of the checkbox.
+     *
+     * @param isDisabled - The disabled state of the checkbox.
+     * @returns The component.
+     */
+    setDisabled(isDisabled: boolean): this;
+    /**
+     * Sets the value of the checkbox.
+     *
+     * @param value - The value to set the checkbox to.
+     * @returns The component.
+     */
+    setValue(value: boolean | null): this;
+}

package/dist/lib/esm/setting-components/tri-state-checkbox-component.mjs

@@ -0,0 +1,128 @@
+/*
+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 { ValueComponent } from "obsidian";
+import { CssClass } from "../css-class.mjs";
+import { addPluginCssClasses } from "../plugin/plugin-context.mjs";
+class TriStateCheckboxComponent extends 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 tri-state checkbox component.
+   *
+   * @param containerEl - The container element.
+   */
+  constructor(containerEl) {
+    super();
+    addPluginCssClasses(containerEl, CssClass.TriStateCheckboxComponent);
+    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.indeterminate ? null : 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 isDisabled - The disabled state of the checkbox.
+   * @returns The component.
+   */
+  setDisabled(isDisabled) {
+    super.setDisabled(isDisabled);
+    this.inputEl.disabled = isDisabled;
+    return this;
+  }
+  /**
+   * Sets the value of the checkbox.
+   *
+   * @param value - The value to set the checkbox to.
+   * @returns The component.
+   */
+  setValue(value) {
+    this.inputEl.indeterminate = value === null;
+    this.inputEl.checked = value ?? false;
+    return this;
+  }
+}
+export {
+  TriStateCheckboxComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3NldHRpbmctY29tcG9uZW50cy90cmktc3RhdGUtY2hlY2tib3gtY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogVHJpLXN0YXRlIGNoZWNrYm94IGNvbXBvbmVudC5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IFZhbGlkYXRvckVsZW1lbnQgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvaHRtbC1lbGVtZW50JztcblxuaW1wb3J0IHsgVmFsdWVDb21wb25lbnQgfSBmcm9tICdvYnNpZGlhbic7XG5cbi8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBAdHlwZXNjcmlwdC1lc2xpbnQvbm8tdW51c2VkLXZhcnMgLS0gV2UgbmVlZCB0byBpbXBvcnQgYGluaXRQbHVnaW5Db250ZXh0YCB0byB1c2UgaXQgaW4gdGhlIHRzZG9jcy5cbmltcG9ydCB0eXBlIHsgaW5pdFBsdWdpbkNvbnRleHQgfSBmcm9tICcuLi9wbHVnaW4vcGx1Z2luLWNvbnRleHQudHMnO1xuLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby11bnVzZWQtdmFycyAtLSBXZSBuZWVkIHRvIGltcG9ydCBgU2V0dGluZ0V4YCB0byB1c2UgaXQgaW4gdGhlIHRzZG9jcy5cbmltcG9ydCB0eXBlIHsgU2V0dGluZ0V4IH0gZnJvbSAnLi4vc2V0dGluZy1leC50cyc7XG5pbXBvcnQgdHlwZSB7IFZhbGlkYXRvckNvbXBvbmVudCB9IGZyb20gJy4vdmFsaWRhdG9yLWNvbXBvbmVudC50cyc7XG5pbXBvcnQgdHlwZSB7IFZhbHVlQ29tcG9uZW50V2l0aENoYW5nZVRyYWNraW5nIH0gZnJvbSAnLi92YWx1ZS1jb21wb25lbnQtd2l0aC1jaGFuZ2UtdHJhY2tpbmcudHMnO1xuXG5pbXBvcnQgeyBDc3NDbGFzcyB9IGZyb20gJy4uL2Nzcy1jbGFzcy50cyc7XG5pbXBvcnQgeyBhZGRQbHVnaW5Dc3NDbGFzc2VzIH0gZnJvbSAnLi4vcGx1Z2luL3BsdWdpbi1jb250ZXh0LnRzJztcblxuLyoqXG4gKiBBIGNvbXBvbmVudCB0aGF0IGRpc3BsYXlzIGEgdHJpLXN0YXRlIGNoZWNrYm94LlxuICpcbiAqIFlvdSBjYW4gYWRkIHRoaXMgY29tcG9uZW50IHVzaW5nIHtAbGluayBTZXR0aW5nRXguYWRkVHJpU3RhdGVDaGVja2JveH0uXG4gKlxuICogSW4gb3JkZXIgdG8gYWRkIHRoZSBzdHlsZXMgZm9yIHRoZSBjb21wb25lbnQsIHVzZSB7QGxpbmsgaW5pdFBsdWdpbkNvbnRleHR9IGluIHlvdXIgcGx1Z2luJ3MgYG9ubG9hZCgpYCBmdW5jdGlvbi5cbiAqXG4gKiBBbHRlcm5hdGl2ZWx5LCB5b3UgY2FuIGNvcHkgc3R5bGVzIGZyb20ge0BsaW5rIGh0dHBzOi8vZ2l0aHViLmNvbS9tbmFvdW1vdi9vYnNpZGlhbi1kZXYtdXRpbHMvcmVsZWFzZXMvbGF0ZXN0L2Rvd25sb2FkL3N0eWxlcy5jc3N9LlxuICovXG5leHBvcnQgY2xhc3MgVHJpU3RhdGVDaGVja2JveENvbXBvbmVudCBleHRlbmRzIFZhbHVlQ29tcG9uZW50PGJvb2xlYW4gfCBudWxsPiBpbXBsZW1lbnRzIFZhbGlkYXRvckNvbXBvbmVudCwgVmFsdWVDb21wb25lbnRXaXRoQ2hhbmdlVHJhY2tpbmc8Ym9vbGVhbiB8IG51bGw+IHtcbiAgLyoqXG4gICAqIEFuIGlucHV0IGVsZW1lbnQgb2YgdGhlIGNoZWNrYm94LlxuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IGlucHV0RWw6IEhUTUxJbnB1dEVsZW1lbnQ7XG5cbiAgLyoqXG4gICAqIEEgdmFsaWRhdG9yIGVsZW1lbnQgb2YgdGhlIGNoZWNrYm94LlxuICAgKlxuICAgKiBAcmV0dXJucyBUaGUgdmFsaWRhdG9yIGVsZW1lbnQuXG4gICAqL1xuICBwdWJsaWMgZ2V0IHZhbGlkYXRvckVsKCk6IFZhbGlkYXRvckVsZW1lbnQge1xuICAgIHJldHVybiB0aGlzLmlucHV0RWw7XG4gIH1cblxuICBwcml2YXRlIGNoYW5nZUNhbGxiYWNrPzogKG5ld1ZhbHVlOiBib29sZWFuIHwgbnVsbCkgPT4gdm9pZDtcblxuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyB0cmktc3RhdGUgY2hlY2tib3ggY29tcG9uZW50LlxuICAgKlxuICAgKiBAcGFyYW0gY29udGFpbmVyRWwgLSBUaGUgY29udGFpbmVyIGVsZW1lbnQuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IoY29udGFpbmVyRWw6IEhUTUxFbGVtZW50KSB7XG4gICAgc3VwZXIoKTtcbiAgICBhZGRQbHVnaW5Dc3NDbGFzc2VzKGNvbnRhaW5lckVsLCBDc3NDbGFzcy5UcmlTdGF0ZUNoZWNrYm94Q29tcG9uZW50KTtcbiAgICB0aGlzLmlucHV0RWwgPSBjb250YWluZXJFbC5jcmVhdGVFbCgnaW5wdXQnLCB7IHR5cGU6ICdjaGVja2JveCcgfSk7XG4gICAgdGhpcy5pbnB1dEVsLmFkZEV2ZW50TGlzdGVuZXIoJ2NoYW5nZScsIHRoaXMub25DaGFuZ2VkLmJpbmQodGhpcykpO1xuICB9XG5cbiAgLyoqXG4gICAqIEdldHMgdGhlIHZhbHVlIG9mIHRoZSBjaGVja2JveC5cbiAgICpcbiAgICogQHJldHVybnMgVGhlIHZhbHVlIG9mIHRoZSBjaGVja2JveC5cbiAgICovXG4gIHB1YmxpYyBvdmVycmlkZSBnZXRWYWx1ZSgpOiBib29sZWFuIHwgbnVsbCB7XG4gICAgcmV0dXJuIHRoaXMuaW5wdXRFbC5pbmRldGVybWluYXRlID8gbnVsbCA6IHRoaXMuaW5wdXRFbC5jaGVja2VkO1xuICB9XG5cbiAgLyoqXG4gICAqIFNldHMgdGhlIGNhbGxiYWNrIHRvIGJlIGNhbGxlZCB3aGVuIHRoZSBjaGVja2JveCBpcyBjaGFuZ2VkLlxuICAgKlxuICAgKiBAcGFyYW0gY2FsbGJhY2sgLSBUaGUgY2FsbGJhY2sgdG8gYmUgY2FsbGVkIHdoZW4gdGhlIGNoZWNrYm94IGlzIGNoYW5nZWQuXG4gICAqIEByZXR1cm5zIFRoZSBjb21wb25lbnQuXG4gICAqL1xuICBwdWJsaWMgb25DaGFuZ2UoY2FsbGJhY2s6IChuZXdWYWx1ZTogYm9vbGVhbiB8IG51bGwpID0+IHZvaWQpOiB0aGlzIHtcbiAgICB0aGlzLmNoYW5nZUNhbGxiYWNrID0gY2FsbGJhY2s7XG4gICAgcmV0dXJuIHRoaXM7XG4gIH1cblxuICAvKipcbiAgICogQ2FsbGVkIHdoZW4gdGhlIGNoZWNrYm94IGlzIGNoYW5nZWQuXG4gICAqL1xuICBwdWJsaWMgb25DaGFuZ2VkKCk6IHZvaWQge1xuICAgIHRoaXMuY2hhbmdlQ2FsbGJhY2s/Lih0aGlzLmdldFZhbHVlKCkpO1xuICB9XG5cbiAgLyoqXG4gICAqIFNldHMgdGhlIGRpc2FibGVkIHN0YXRlIG9mIHRoZSBjaGVja2JveC5cbiAgICpcbiAgICogQHBhcmFtIGlzRGlzYWJsZWQgLSBUaGUgZGlzYWJsZWQgc3RhdGUgb2YgdGhlIGNoZWNrYm94LlxuICAgKiBAcmV0dXJucyBUaGUgY29tcG9uZW50LlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIHNldERpc2FibGVkKGlzRGlzYWJsZWQ6IGJvb2xlYW4pOiB0aGlzIHtcbiAgICBzdXBlci5zZXREaXNhYmxlZChpc0Rpc2FibGVkKTtcbiAgICB0aGlzLmlucHV0RWwuZGlzYWJsZWQgPSBpc0Rpc2FibGVkO1xuICAgIHJldHVybiB0aGlzO1xuICB9XG5cbiAgLyoqXG4gICAqIFNldHMgdGhlIHZhbHVlIG9mIHRoZSBjaGVja2JveC5cbiAgICpcbiAgICogQHBhcmFtIHZhbHVlIC0gVGhlIHZhbHVlIHRvIHNldCB0aGUgY2hlY2tib3ggdG8uXG4gICAqIEByZXR1cm5zIFRoZSBjb21wb25lbnQuXG4gICAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgc2V0VmFsdWUodmFsdWU6IGJvb2xlYW4gfCBudWxsKTogdGhpcyB7XG4gICAgdGhpcy5pbnB1dEVsLmluZGV0ZXJtaW5hdGUgPSB2YWx1ZSA9PT0gbnVsbDtcbiAgICB0aGlzLmlucHV0RWwuY2hlY2tlZCA9IHZhbHVlID8/IGZhbHNlO1xuICAgIHJldHVybiB0aGlzO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBUUEsU0FBUyxzQkFBc0I7QUFTL0IsU0FBUyxnQkFBZ0I7QUFDekIsU0FBUywyQkFBMkI7QUFXN0IsTUFBTSxrQ0FBa0MsZUFBK0c7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUk1STtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9oQixJQUFXLGNBQWdDO0FBQ3pDLFdBQU8sS0FBSztBQUFBLEVBQ2Q7QUFBQSxFQUVRO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT0QsWUFBWSxhQUEwQjtBQUMzQyxVQUFNO0FBQ04sd0JBQW9CLGFBQWEsU0FBUyx5QkFBeUI7QUFDbkUsU0FBSyxVQUFVLFlBQVksU0FBUyxTQUFTLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFDakUsU0FBSyxRQUFRLGlCQUFpQixVQUFVLEtBQUssVUFBVSxLQUFLLElBQUksQ0FBQztBQUFBLEVBQ25FO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT2dCLFdBQTJCO0FBQ3pDLFdBQU8sS0FBSyxRQUFRLGdCQUFnQixPQUFPLEtBQUssUUFBUTtBQUFBLEVBQzFEO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFRTyxTQUFTLFVBQW9EO0FBQ2xFLFNBQUssaUJBQWlCO0FBQ3RCLFdBQU87QUFBQSxFQUNUO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFLTyxZQUFrQjtBQUN2QixTQUFLLGlCQUFpQixLQUFLLFNBQVMsQ0FBQztBQUFBLEVBQ3ZDO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFRZ0IsWUFBWSxZQUEyQjtBQUNyRCxVQUFNLFlBQVksVUFBVTtBQUM1QixTQUFLLFFBQVEsV0FBVztBQUN4QixXQUFPO0FBQUEsRUFDVDtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBUWdCLFNBQVMsT0FBNkI7QUFDcEQsU0FBSyxRQUFRLGdCQUFnQixVQUFVO0FBQ3ZDLFNBQUssUUFBUSxVQUFVLFNBQVM7QUFDaEMsV0FBTztBQUFBLEVBQ1Q7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K

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

@@ -0,0 +1,97 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Typed dropdown component.
+ */
+import type { ValidatorElement } from '@mnaoumov/typescript-lib/html-element';
+import { DropdownComponent, ValueComponent } from 'obsidian';
+import type { ValueComponentWithChangeTracking } from './value-component-with-change-tracking.mjs';
+/**
+ * A dropdown component that can be used to select a value from a list.
+ *
+ * You can add this component using {@link SettingEx.addTypedDropdown}.
+ *
+ * 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}.
+ *
+ * @typeParam T - The type of the value to select.
+ */
+export declare class TypedDropdownComponent<T> extends ValueComponent<null | T> implements ValueComponentWithChangeTracking<null | T> {
+    /**
+     * A select element of the component.
+     *
+     * @returns The select element.
+     */
+    get selectEl(): HTMLSelectElement;
+    /**
+     * A validator element of the component.
+     *
+     * @returns The validator element.
+     */
+    get validatorEl(): ValidatorElement;
+    /**
+     * The inner dropdown component.
+     */
+    protected readonly dropdownComponent: DropdownComponent;
+    /**
+     * The list of selectable option values, indexed by their position in the dropdown.
+     */
+    protected readonly values: T[];
+    private simulateChangeCallback?;
+    /**
+     * Creates a new multiple dropdown component.
+     *
+     * @param containerEl - The container element of the component.
+     */
+    constructor(containerEl: HTMLElement);
+    /**
+     * 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: T, display: string): this;
+    /**
+     * Adds multiple options to the dropdown.
+     *
+     * @param options - The options to add.
+     * @returns The component.
+     */
+    addOptions(options: Map<T, string>): this;
+    /**
+     * Gets the value of the component.
+     *
+     * @returns The value of the component.
+     */
+    getValue(): null | 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: null | T) => void): this;
+    /**
+     * Sets the disabled state of the component.
+     *
+     * @param isDisabled - The disabled state to set.
+     * @returns The component.
+     */
+    setDisabled(isDisabled: boolean): this;
+    /**
+     * Sets the value of the component.
+     *
+     * @param value - The value to set.
+     * @returns The component.
+     */
+    setValue(value: null | T): this;
+    /**
+     * Simulate a change event.
+     *
+     * @deprecated Use only from tests to simulate a change event.
+     */
+    simulateChange__(): void;
+}