@mnaoumov/obsidian-lib 0.0.0 → 1.0.1

package/dist/lib/esm/popovers/popover.d.mts

@@ -0,0 +1,78 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * A small floating panel anchored at a point, collecting a value and resolving a promise with it.
+ *
+ * This is the popover counterpart of `modals/modal.ts`: the same "ask the user for a value, resolve a
+ * promise" shape, for the cases a modal cannot serve. A modal dims the screen and is positioned by
+ * Obsidian, neither of which suits an editor that must appear *at* the thing it edits — a clicked
+ * link, the caret, or wherever a context menu was raised.
+ *
+ * The panel rides Obsidian's `.menu` class for its background, border and shadow, so only layout is
+ * styled by this library.
+ */
+import type { PopoverAnchor } from './popover-anchor.mjs';
+/**
+ * Reads the value the popover resolves with when it is confirmed.
+ *
+ * @typeParam Value - The type of the value resolved by the popover.
+ * @returns The current value.
+ */
+export type PopoverValueGetter<Value> = () => Value;
+/**
+ * The tools handed to {@link ShowPopoverParams.build} for populating a popover.
+ */
+export interface ShowPopoverBuildParams {
+    /**
+     * Dismisses the popover, resolving it with `null`, as the Cancel button does.
+     */
+    readonly cancel: () => void;
+    /**
+     * Confirms the popover, resolving it with the built value, as the OK button does.
+     */
+    readonly confirm: () => void;
+    /**
+     * The element to add the popover's content to. The OK and Cancel buttons are appended after it.
+     */
+    readonly contentEl: HTMLElement;
+}
+/**
+ * Parameters for {@link showPopover}.
+ *
+ * @typeParam Value - The type of the value resolved by the popover.
+ */
+export interface ShowPopoverParams<Value> {
+    /**
+     * Where to place the popover.
+     */
+    readonly anchor: PopoverAnchor;
+    /**
+     * Populates the popover's content.
+     *
+     * @param params - The tools for populating the popover.
+     * @returns A getter read when the popover is confirmed.
+     */
+    readonly build: (params: ShowPopoverBuildParams) => PopoverValueGetter<Value>;
+    /**
+     * A text for the "Cancel" button.
+     */
+    readonly cancelButtonText?: string;
+    /**
+     * Additional CSS classes to apply to the popover.
+     */
+    readonly cssClasses?: string[];
+    /**
+     * A text for the "OK" button.
+     */
+    readonly okButtonText?: string;
+}
+/**
+ * Displays a popover at the given anchor and resolves with the built value, or `null` if it was
+ * dismissed without confirming.
+ *
+ * @typeParam Value - The type of the value resolved by the popover.
+ * @param params - The parameters for the popover.
+ * @returns A {@link Promise} that resolves with the built value, or `null` if dismissed.
+ */
+export declare function showPopover<Value>(params: ShowPopoverParams<Value>): Promise<null | Value>;

package/dist/lib/esm/popovers/popover.mjs

@@ -0,0 +1,132 @@
+/*
+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"
+  };
+  const existingProcess = globalThis.process;
+  if (!existingProcess) {
+    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 { getDocumentWindow } from "@mnaoumov/typescript-lib/html-element";
+import { Setting } from "obsidian";
+import { CssClass } from "../css-class.mjs";
+import { t } from "../i18n/i18n.mjs";
+import { addPluginCssClasses } from "../plugin/plugin-context.mjs";
+const ANCHOR_GAP_IN_PIXELS = 4;
+const 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, [CssClass.Popover, ...cssClasses ?? []]);
+  return await new Promise((resolve) => {
+    const state = { isClosed: false };
+    function close(result) {
+      if (state.isClosed) {
+        return;
+      }
+      state.isClosed = true;
+      doc.removeEventListener("pointerdown", handlePointerDown, true);
+      popoverEl.remove();
+      resolve(result);
+    }
+    function handleCancel() {
+      close(null);
+    }
+    function handleOk() {
+      close(getValue());
+    }
+    function handlePointerDown($event) {
+      if ($event.composedPath().includes(popoverEl)) {
+        return;
+      }
+      close(null);
+    }
+    const getValue = build({
+      cancel: handleCancel,
+      confirm: handleOk,
+      contentEl: popoverEl
+    });
+    popoverEl.addEventListener("keydown", ($event) => {
+      if ($event.key === "Enter") {
+        $event.preventDefault();
+        handleOk();
+        return;
+      }
+      if ($event.key !== "Escape") {
+        return;
+      }
+      $event.preventDefault();
+      handleCancel();
+    });
+    const buttonsSetting = new Setting(popoverEl);
+    buttonsSetting.addButton((button) => {
+      button.setButtonText(okButtonText ?? t(($) => $.obsidianDevUtils.buttons.ok)).setCta().setClass(CssClass.OkButton).onClick(handleOk);
+    });
+    buttonsSetting.addButton((button) => {
+      button.setButtonText(cancelButtonText ?? t(($) => $.obsidianDevUtils.buttons.cancel)).setClass(CssClass.CancelButton).onClick(handleCancel);
+    });
+    doc.addEventListener("pointerdown", handlePointerDown, { capture: 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`;
+}
+export {
+  showPopover
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3BvcG92ZXJzL3BvcG92ZXIudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBBIHNtYWxsIGZsb2F0aW5nIHBhbmVsIGFuY2hvcmVkIGF0IGEgcG9pbnQsIGNvbGxlY3RpbmcgYSB2YWx1ZSBhbmQgcmVzb2x2aW5nIGEgcHJvbWlzZSB3aXRoIGl0LlxuICpcbiAqIFRoaXMgaXMgdGhlIHBvcG92ZXIgY291bnRlcnBhcnQgb2YgYG1vZGFscy9tb2RhbC50c2A6IHRoZSBzYW1lIFwiYXNrIHRoZSB1c2VyIGZvciBhIHZhbHVlLCByZXNvbHZlIGFcbiAqIHByb21pc2VcIiBzaGFwZSwgZm9yIHRoZSBjYXNlcyBhIG1vZGFsIGNhbm5vdCBzZXJ2ZS4gQSBtb2RhbCBkaW1zIHRoZSBzY3JlZW4gYW5kIGlzIHBvc2l0aW9uZWQgYnlcbiAqIE9ic2lkaWFuLCBuZWl0aGVyIG9mIHdoaWNoIHN1aXRzIGFuIGVkaXRvciB0aGF0IG11c3QgYXBwZWFyICphdCogdGhlIHRoaW5nIGl0IGVkaXRzIFx1MjAxNCBhIGNsaWNrZWRcbiAqIGxpbmssIHRoZSBjYXJldCwgb3Igd2hlcmV2ZXIgYSBjb250ZXh0IG1lbnUgd2FzIHJhaXNlZC5cbiAqXG4gKiBUaGUgcGFuZWwgcmlkZXMgT2JzaWRpYW4ncyBgLm1lbnVgIGNsYXNzIGZvciBpdHMgYmFja2dyb3VuZCwgYm9yZGVyIGFuZCBzaGFkb3csIHNvIG9ubHkgbGF5b3V0IGlzXG4gKiBzdHlsZWQgYnkgdGhpcyBsaWJyYXJ5LlxuICovXG5cbmltcG9ydCB7IGdldERvY3VtZW50V2luZG93IH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL2h0bWwtZWxlbWVudCc7XG5pbXBvcnQgeyBTZXR0aW5nIH0gZnJvbSAnb2JzaWRpYW4nO1xuXG5pbXBvcnQgdHlwZSB7IFBvcG92ZXJBbmNob3IgfSBmcm9tICcuL3BvcG92ZXItYW5jaG9yLnRzJztcblxuaW1wb3J0IHsgQ3NzQ2xhc3MgfSBmcm9tICcuLi9jc3MtY2xhc3MudHMnO1xuaW1wb3J0IHsgdCB9IGZyb20gJy4uL2kxOG4vaTE4bi50cyc7XG5pbXBvcnQgeyBhZGRQbHVnaW5Dc3NDbGFzc2VzIH0gZnJvbSAnLi4vcGx1Z2luL3BsdWdpbi1jb250ZXh0LnRzJztcblxuLyoqXG4gKiBUaGUgZ2FwIGluIHBpeGVscyBiZXR3ZWVuIHRoZSBhbmNob3IgYW5kIHRoZSBwb3BvdmVyLlxuICovXG5jb25zdCBBTkNIT1JfR0FQX0lOX1BJWEVMUyA9IDQ7XG5cbi8qKlxuICogVGhlIG1pbmltdW0gZ2FwIGluIHBpeGVscyB0aGUgcG9wb3ZlciBrZWVwcyBmcm9tIHRoZSBlZGdlcyBvZiB0aGUgd2luZG93IHdoZW4gaXQgaGFzIHRvIGJlIGNsYW1wZWRcbiAqIGJhY2sgaW50byB2aWV3LlxuICovXG5jb25zdCBWSUVXUE9SVF9NQVJHSU5fSU5fUElYRUxTID0gODtcblxuLyoqXG4gKiBSZWFkcyB0aGUgdmFsdWUgdGhlIHBvcG92ZXIgcmVzb2x2ZXMgd2l0aCB3aGVuIGl0IGlzIGNvbmZpcm1lZC5cbiAqXG4gKiBAdHlwZVBhcmFtIFZhbHVlIC0gVGhlIHR5cGUgb2YgdGhlIHZhbHVlIHJlc29sdmVkIGJ5IHRoZSBwb3BvdmVyLlxuICogQHJldHVybnMgVGhlIGN1cnJlbnQgdmFsdWUuXG4gKi9cbmV4cG9ydCB0eXBlIFBvcG92ZXJWYWx1ZUdldHRlcjxWYWx1ZT4gPSAoKSA9PiBWYWx1ZTtcblxuLyoqXG4gKiBUaGUgdG9vbHMgaGFuZGVkIHRvIHtAbGluayBTaG93UG9wb3ZlclBhcmFtcy5idWlsZH0gZm9yIHBvcHVsYXRpbmcgYSBwb3BvdmVyLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFNob3dQb3BvdmVyQnVpbGRQYXJhbXMge1xuICAvKipcbiAgICogRGlzbWlzc2VzIHRoZSBwb3BvdmVyLCByZXNvbHZpbmcgaXQgd2l0aCBgbnVsbGAsIGFzIHRoZSBDYW5jZWwgYnV0dG9uIGRvZXMuXG4gICAqL1xuICByZWFkb25seSBjYW5jZWw6ICgpID0+IHZvaWQ7XG5cbiAgLyoqXG4gICAqIENvbmZpcm1zIHRoZSBwb3BvdmVyLCByZXNvbHZpbmcgaXQgd2l0aCB0aGUgYnVpbHQgdmFsdWUsIGFzIHRoZSBPSyBidXR0b24gZG9lcy5cbiAgICovXG4gIHJlYWRvbmx5IGNvbmZpcm06ICgpID0+IHZvaWQ7XG5cbiAgLyoqXG4gICAqIFRoZSBlbGVtZW50IHRvIGFkZCB0aGUgcG9wb3ZlcidzIGNvbnRlbnQgdG8uIFRoZSBPSyBhbmQgQ2FuY2VsIGJ1dHRvbnMgYXJlIGFwcGVuZGVkIGFmdGVyIGl0LlxuICAgKi9cbiAgcmVhZG9ubHkgY29udGVudEVsOiBIVE1MRWxlbWVudDtcbn1cblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgc2hvd1BvcG92ZXJ9LlxuICpcbiAqIEB0eXBlUGFyYW0gVmFsdWUgLSBUaGUgdHlwZSBvZiB0aGUgdmFsdWUgcmVzb2x2ZWQgYnkgdGhlIHBvcG92ZXIuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgU2hvd1BvcG92ZXJQYXJhbXM8VmFsdWU+IHtcbiAgLyoqXG4gICAqIFdoZXJlIHRvIHBsYWNlIHRoZSBwb3BvdmVyLlxuICAgKi9cbiAgcmVhZG9ubHkgYW5jaG9yOiBQb3BvdmVyQW5jaG9yO1xuXG4gIC8qKlxuICAgKiBQb3B1bGF0ZXMgdGhlIHBvcG92ZXIncyBjb250ZW50LlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHRvb2xzIGZvciBwb3B1bGF0aW5nIHRoZSBwb3BvdmVyLlxuICAgKiBAcmV0dXJucyBBIGdldHRlciByZWFkIHdoZW4gdGhlIHBvcG92ZXIgaXMgY29uZmlybWVkLlxuICAgKi9cbiAgcmVhZG9ubHkgYnVpbGQ6IChwYXJhbXM6IFNob3dQb3BvdmVyQnVpbGRQYXJhbXMpID0+IFBvcG92ZXJWYWx1ZUdldHRlcjxWYWx1ZT47XG5cbiAgLyoqXG4gICAqIEEgdGV4dCBmb3IgdGhlIFwiQ2FuY2VsXCIgYnV0dG9uLlxuICAgKi9cbiAgcmVhZG9ubHkgY2FuY2VsQnV0dG9uVGV4dD86IHN0cmluZztcblxuICAvKipcbiAgICogQWRkaXRpb25hbCBDU1MgY2xhc3NlcyB0byBhcHBseSB0byB0aGUgcG9wb3Zlci5cbiAgICovXG4gIHJlYWRvbmx5IGNzc0NsYXNzZXM/OiBzdHJpbmdbXTtcblxuICAvKipcbiAgICogQSB0ZXh0IGZvciB0aGUgXCJPS1wiIGJ1dHRvbi5cbiAgICovXG4gIHJlYWRvbmx5IG9rQnV0dG9uVGV4dD86IHN0cmluZztcbn1cblxuLyoqXG4gKiBEaXNwbGF5cyBhIHBvcG92ZXIgYXQgdGhlIGdpdmVuIGFuY2hvciBhbmQgcmVzb2x2ZXMgd2l0aCB0aGUgYnVpbHQgdmFsdWUsIG9yIGBudWxsYCBpZiBpdCB3YXNcbiAqIGRpc21pc3NlZCB3aXRob3V0IGNvbmZpcm1pbmcuXG4gKlxuICogQHR5cGVQYXJhbSBWYWx1ZSAtIFRoZSB0eXBlIG9mIHRoZSB2YWx1ZSByZXNvbHZlZCBieSB0aGUgcG9wb3Zlci5cbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycyBmb3IgdGhlIHBvcG92ZXIuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdpdGggdGhlIGJ1aWx0IHZhbHVlLCBvciBgbnVsbGAgaWYgZGlzbWlzc2VkLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gc2hvd1BvcG92ZXI8VmFsdWU+KHBhcmFtczogU2hvd1BvcG92ZXJQYXJhbXM8VmFsdWU+KTogUHJvbWlzZTxudWxsIHwgVmFsdWU+IHtcbiAgY29uc3Qge1xuICAgIGFuY2hvcixcbiAgICBidWlsZCxcbiAgICBjYW5jZWxCdXR0b25UZXh0LFxuICAgIGNzc0NsYXNzZXMsXG4gICAgb2tCdXR0b25UZXh0XG4gIH0gPSBwYXJhbXM7XG5cbiAgY29uc3QgZG9jID0gYW5jaG9yLmRvYztcbiAgY29uc3Qgd2luID0gZ2V0RG9jdW1lbnRXaW5kb3coZG9jKTtcbiAgY29uc3QgcG9wb3ZlckVsID0gZG9jLmJvZHkuY3JlYXRlRGl2KHsgY2xzOiAnbWVudScgfSk7XG4gIGFkZFBsdWdpbkNzc0NsYXNzZXMocG9wb3ZlckVsLCBbQ3NzQ2xhc3MuUG9wb3ZlciwgLi4uY3NzQ2xhc3NlcyA/PyBbXV0pO1xuXG4gIHJldHVybiBhd2FpdCBuZXcgUHJvbWlzZTxudWxsIHwgVmFsdWU+KChyZXNvbHZlKSA9PiB7XG4gICAgY29uc3Qgc3RhdGUgPSB7IGlzQ2xvc2VkOiBmYWxzZSB9O1xuXG4gICAgZnVuY3Rpb24gY2xvc2UocmVzdWx0OiBudWxsIHwgVmFsdWUpOiB2b2lkIHtcbiAgICAgIGlmIChzdGF0ZS5pc0Nsb3NlZCkge1xuICAgICAgICByZXR1cm47XG4gICAgICB9XG4gICAgICBzdGF0ZS5pc0Nsb3NlZCA9IHRydWU7XG4gICAgICBkb2MucmVtb3ZlRXZlbnRMaXN0ZW5lcigncG9pbnRlcmRvd24nLCBoYW5kbGVQb2ludGVyRG93biwgdHJ1ZSk7XG4gICAgICBwb3BvdmVyRWwucmVtb3ZlKCk7XG4gICAgICByZXNvbHZlKHJlc3VsdCk7XG4gICAgfVxuXG4gICAgZnVuY3Rpb24gaGFuZGxlQ2FuY2VsKCk6IHZvaWQge1xuICAgICAgY2xvc2UobnVsbCk7XG4gICAgfVxuXG4gICAgZnVuY3Rpb24gaGFuZGxlT2soKTogdm9pZCB7XG4gICAgICBjbG9zZShnZXRWYWx1ZSgpKTtcbiAgICB9XG5cbiAgICAvKipcbiAgICAgKiBEaXNtaXNzZXMgdGhlIHBvcG92ZXIgd2hlbiB0aGUgbmV4dCBnZXN0dXJlIHN0YXJ0cyBvdXRzaWRlIGl0LiBMaXN0ZW5pbmcgZm9yIGBwb2ludGVyZG93bmBcbiAgICAgKiByYXRoZXIgdGhhbiBgY2xpY2tgIG1hdHRlcnM6IGEgcG9wb3ZlciBpcyB0eXBpY2FsbHkgb3BlbmVkIGZyb20gYSBgY2xpY2tgIGhhbmRsZXIsIGFuZCB0aGUgdmVyeVxuICAgICAqIHNhbWUgY2xpY2sgd291bGQgb3RoZXJ3aXNlIHJlYWNoIHRoaXMgbGlzdGVuZXIgYW5kIGNsb3NlIHRoZSBwb3BvdmVyIHRoZSBpbnN0YW50IGl0IGFwcGVhcnMuXG4gICAgICpcbiAgICAgKiBAcGFyYW0gJGV2ZW50IC0gVGhlIHBvaW50ZXIgZXZlbnQuXG4gICAgICovXG4gICAgZnVuY3Rpb24gaGFuZGxlUG9pbnRlckRvd24oJGV2ZW50OiBQb2ludGVyRXZlbnQpOiB2b2lkIHtcbiAgICAgIGlmICgkZXZlbnQuY29tcG9zZWRQYXRoKCkuaW5jbHVkZXMocG9wb3ZlckVsKSkge1xuICAgICAgICByZXR1cm47XG4gICAgICB9XG4gICAgICBjbG9zZShudWxsKTtcbiAgICB9XG5cbiAgICBjb25zdCBnZXRWYWx1ZSA9IGJ1aWxkKHtcbiAgICAgIGNhbmNlbDogaGFuZGxlQ2FuY2VsLFxuICAgICAgY29uZmlybTogaGFuZGxlT2ssXG4gICAgICBjb250ZW50RWw6IHBvcG92ZXJFbFxuICAgIH0pO1xuXG4gICAgcG9wb3ZlckVsLmFkZEV2ZW50TGlzdGVuZXIoJ2tleWRvd24nLCAoJGV2ZW50OiBLZXlib2FyZEV2ZW50KSA9PiB7XG4gICAgICBpZiAoJGV2ZW50LmtleSA9PT0gJ0VudGVyJykge1xuICAgICAgICAkZXZlbnQucHJldmVudERlZmF1bHQoKTtcbiAgICAgICAgaGFuZGxlT2soKTtcbiAgICAgICAgcmV0dXJuO1xuICAgICAgfVxuXG4gICAgICBpZiAoJGV2ZW50LmtleSAhPT0gJ0VzY2FwZScpIHtcbiAgICAgICAgcmV0dXJuO1xuICAgICAgfVxuXG4gICAgICAkZXZlbnQucHJldmVudERlZmF1bHQoKTtcbiAgICAgIGhhbmRsZUNhbmNlbCgpO1xuICAgIH0pO1xuXG4gICAgY29uc3QgYnV0dG9uc1NldHRpbmcgPSBuZXcgU2V0dGluZyhwb3BvdmVyRWwpO1xuICAgIGJ1dHRvbnNTZXR0aW5nLmFkZEJ1dHRvbigoYnV0dG9uKSA9PiB7XG4gICAgICBidXR0b25cbiAgICAgICAgLnNldEJ1dHRvblRleHQob2tCdXR0b25UZXh0ID8/IHQoKCQpID0+ICQub2JzaWRpYW5EZXZVdGlscy5idXR0b25zLm9rKSlcbiAgICAgICAgLnNldEN0YSgpXG4gICAgICAgIC5zZXRDbGFzcyhDc3NDbGFzcy5Pa0J1dHRvbilcbiAgICAgICAgLm9uQ2xpY2soaGFuZGxlT2spO1xuICAgIH0pO1xuICAgIGJ1dHRvbnNTZXR0aW5nLmFkZEJ1dHRvbigoYnV0dG9uKSA9PiB7XG4gICAgICBidXR0b25cbiAgICAgICAgLnNldEJ1dHRvblRleHQoY2FuY2VsQnV0dG9uVGV4dCA/PyB0KCgkKSA9PiAkLm9ic2lkaWFuRGV2VXRpbHMuYnV0dG9ucy5jYW5jZWwpKVxuICAgICAgICAuc2V0Q2xhc3MoQ3NzQ2xhc3MuQ2FuY2VsQnV0dG9uKVxuICAgICAgICAub25DbGljayhoYW5kbGVDYW5jZWwpO1xuICAgIH0pO1xuXG4gICAgZG9jLmFkZEV2ZW50TGlzdGVuZXIoJ3BvaW50ZXJkb3duJywgaGFuZGxlUG9pbnRlckRvd24sIHsgY2FwdHVyZTogdHJ1ZSB9KTtcbiAgICBwb3NpdGlvbkF0QW5jaG9yKHBvcG92ZXJFbCwgYW5jaG9yLCB3aW4pO1xuICAgIGZvY3VzRmlyc3RJbnB1dChwb3BvdmVyRWwpO1xuICB9KTtcbn1cblxuLyoqXG4gKiBGb2N1c2VzIGFuZCBzZWxlY3RzIHRoZSBwb3BvdmVyJ3MgZmlyc3QgdGV4dCBpbnB1dCwgc28gdGhlIHVzZXIgY2FuIHR5cGUgc3RyYWlnaHQgYXdheS5cbiAqXG4gKiBAcGFyYW0gcG9wb3ZlckVsIC0gVGhlIHBvcG92ZXIgdG8gZm9jdXMgd2l0aGluLlxuICovXG5mdW5jdGlvbiBmb2N1c0ZpcnN0SW5wdXQocG9wb3ZlckVsOiBIVE1MRWxlbWVudCk6IHZvaWQge1xuICBjb25zdCBpbnB1dEVsID0gcG9wb3ZlckVsLnF1ZXJ5U2VsZWN0b3IoJ2lucHV0Jyk7XG4gIGlmICghaW5wdXRFbCkge1xuICAgIHJldHVybjtcbiAgfVxuXG4gIGlucHV0RWwuZm9jdXMoKTtcbiAgaW5wdXRFbC5zZWxlY3QoKTtcbn1cblxuLyoqXG4gKiBQbGFjZXMgdGhlIHBvcG92ZXIganVzdCBiZWxvdyB0aGUgYW5jaG9yLCBwdWxsaW5nIGl0IGJhY2sgaW5zaWRlIHRoZSB3aW5kb3cgd2hlbiBpdCB3b3VsZCBvdGhlcndpc2VcbiAqIG92ZXJmbG93IFx1MjAxNCBhbiBhbmNob3IgbmVhciB0aGUgcmlnaHQgb3IgYm90dG9tIGVkZ2UgaXMgZXhhY3RseSB3aGVyZSBhbiB1bmNsYW1wZWQgcG9wb3ZlciB3b3VsZFxuICogcmVuZGVyIG9mZi1zY3JlZW4uXG4gKlxuICogQHBhcmFtIHBvcG92ZXJFbCAtIFRoZSBwb3BvdmVyIHRvIHBvc2l0aW9uLlxuICogQHBhcmFtIGFuY2hvciAtIFdoZXJlIHRoZSBwb3BvdmVyIGJlbG9uZ3MuXG4gKiBAcGFyYW0gd2luIC0gVGhlIHdpbmRvdyB0aGUgYW5jaG9yIGxpdmVzIGluIChhIHBvcC1vdXQgd2luZG93IGhhcyBpdHMgb3duKS5cbiAqL1xuZnVuY3Rpb24gcG9zaXRpb25BdEFuY2hvcihwb3BvdmVyRWw6IEhUTUxFbGVtZW50LCBhbmNob3I6IFBvcG92ZXJBbmNob3IsIHdpbjogV2luZG93KTogdm9pZCB7XG4gIGNvbnN0IG1heExlZnQgPSBNYXRoLm1heChWSUVXUE9SVF9NQVJHSU5fSU5fUElYRUxTLCB3aW4uaW5uZXJXaWR0aCAtIHBvcG92ZXJFbC5vZmZzZXRXaWR0aCAtIFZJRVdQT1JUX01BUkdJTl9JTl9QSVhFTFMpO1xuICBjb25zdCBtYXhUb3AgPSBNYXRoLm1heChWSUVXUE9SVF9NQVJHSU5fSU5fUElYRUxTLCB3aW4uaW5uZXJIZWlnaHQgLSBwb3BvdmVyRWwub2Zmc2V0SGVpZ2h0IC0gVklFV1BPUlRfTUFSR0lOX0lOX1BJWEVMUyk7XG5cbiAgY29uc3QgbGVmdCA9IE1hdGgubWluKE1hdGgubWF4KGFuY2hvci5sZWZ0LCBWSUVXUE9SVF9NQVJHSU5fSU5fUElYRUxTKSwgbWF4TGVmdCk7XG4gIGNvbnN0IHRvcCA9IE1hdGgubWluKE1hdGgubWF4KGFuY2hvci5ib3R0b20gKyBBTkNIT1JfR0FQX0lOX1BJWEVMUywgVklFV1BPUlRfTUFSR0lOX0lOX1BJWEVMUyksIG1heFRvcCk7XG5cbiAgcG9wb3ZlckVsLnN0eWxlLmxlZnQgPSBgJHtTdHJpbmcoTWF0aC5yb3VuZChsZWZ0ICsgd2luLnNjcm9sbFgpKX1weGA7XG4gIHBvcG92ZXJFbC5zdHlsZS50b3AgPSBgJHtTdHJpbmcoTWF0aC5yb3VuZCh0b3AgKyB3aW4uc2Nyb2xsWSkpfXB4YDtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBY0EsU0FBUyx5QkFBeUI7QUFDbEMsU0FBUyxlQUFlO0FBSXhCLFNBQVMsZ0JBQWdCO0FBQ3pCLFNBQVMsU0FBUztBQUNsQixTQUFTLDJCQUEyQjtBQUtwQyxNQUFNLHVCQUF1QjtBQU03QixNQUFNLDRCQUE0QjtBQXlFbEMsZUFBc0IsWUFBbUIsUUFBeUQ7QUFDaEcsUUFBTTtBQUFBLElBQ0o7QUFBQSxJQUNBO0FBQUEsSUFDQTtBQUFBLElBQ0E7QUFBQSxJQUNBO0FBQUEsRUFDRixJQUFJO0FBRUosUUFBTSxNQUFNLE9BQU87QUFDbkIsUUFBTSxNQUFNLGtCQUFrQixHQUFHO0FBQ2pDLFFBQU0sWUFBWSxJQUFJLEtBQUssVUFBVSxFQUFFLEtBQUssT0FBTyxDQUFDO0FBQ3BELHNCQUFvQixXQUFXLENBQUMsU0FBUyxTQUFTLEdBQUcsY0FBYyxDQUFDLENBQUMsQ0FBQztBQUV0RSxTQUFPLE1BQU0sSUFBSSxRQUFzQixDQUFDLFlBQVk7QUFDbEQsVUFBTSxRQUFRLEVBQUUsVUFBVSxNQUFNO0FBRWhDLGFBQVMsTUFBTSxRQUE0QjtBQUN6QyxVQUFJLE1BQU0sVUFBVTtBQUNsQjtBQUFBLE1BQ0Y7QUFDQSxZQUFNLFdBQVc7QUFDakIsVUFBSSxvQkFBb0IsZUFBZSxtQkFBbUIsSUFBSTtBQUM5RCxnQkFBVSxPQUFPO0FBQ2pCLGNBQVEsTUFBTTtBQUFBLElBQ2hCO0FBRUEsYUFBUyxlQUFxQjtBQUM1QixZQUFNLElBQUk7QUFBQSxJQUNaO0FBRUEsYUFBUyxXQUFpQjtBQUN4QixZQUFNLFNBQVMsQ0FBQztBQUFBLElBQ2xCO0FBU0EsYUFBUyxrQkFBa0IsUUFBNEI7QUFDckQsVUFBSSxPQUFPLGFBQWEsRUFBRSxTQUFTLFNBQVMsR0FBRztBQUM3QztBQUFBLE1BQ0Y7QUFDQSxZQUFNLElBQUk7QUFBQSxJQUNaO0FBRUEsVUFBTSxXQUFXLE1BQU07QUFBQSxNQUNyQixRQUFRO0FBQUEsTUFDUixTQUFTO0FBQUEsTUFDVCxXQUFXO0FBQUEsSUFDYixDQUFDO0FBRUQsY0FBVSxpQkFBaUIsV0FBVyxDQUFDLFdBQTBCO0FBQy9ELFVBQUksT0FBTyxRQUFRLFNBQVM7QUFDMUIsZUFBTyxlQUFlO0FBQ3RCLGlCQUFTO0FBQ1Q7QUFBQSxNQUNGO0FBRUEsVUFBSSxPQUFPLFFBQVEsVUFBVTtBQUMzQjtBQUFBLE1BQ0Y7QUFFQSxhQUFPLGVBQWU7QUFDdEIsbUJBQWE7QUFBQSxJQUNmLENBQUM7QUFFRCxVQUFNLGlCQUFpQixJQUFJLFFBQVEsU0FBUztBQUM1QyxtQkFBZSxVQUFVLENBQUMsV0FBVztBQUNuQyxhQUNHLGNBQWMsZ0JBQWdCLEVBQUUsQ0FBQyxNQUFNLEVBQUUsaUJBQWlCLFFBQVEsRUFBRSxDQUFDLEVBQ3JFLE9BQU8sRUFDUCxTQUFTLFNBQVMsUUFBUSxFQUMxQixRQUFRLFFBQVE7QUFBQSxJQUNyQixDQUFDO0FBQ0QsbUJBQWUsVUFBVSxDQUFDLFdBQVc7QUFDbkMsYUFDRyxjQUFjLG9CQUFvQixFQUFFLENBQUMsTUFBTSxFQUFFLGlCQUFpQixRQUFRLE1BQU0sQ0FBQyxFQUM3RSxTQUFTLFNBQVMsWUFBWSxFQUM5QixRQUFRLFlBQVk7QUFBQSxJQUN6QixDQUFDO0FBRUQsUUFBSSxpQkFBaUIsZUFBZSxtQkFBbUIsRUFBRSxTQUFTLEtBQUssQ0FBQztBQUN4RSxxQkFBaUIsV0FBVyxRQUFRLEdBQUc7QUFDdkMsb0JBQWdCLFNBQVM7QUFBQSxFQUMzQixDQUFDO0FBQ0g7QUFPQSxTQUFTLGdCQUFnQixXQUE4QjtBQUNyRCxRQUFNLFVBQVUsVUFBVSxjQUFjLE9BQU87QUFDL0MsTUFBSSxDQUFDLFNBQVM7QUFDWjtBQUFBLEVBQ0Y7QUFFQSxVQUFRLE1BQU07QUFDZCxVQUFRLE9BQU87QUFDakI7QUFXQSxTQUFTLGlCQUFpQixXQUF3QixRQUF1QixLQUFtQjtBQUMxRixRQUFNLFVBQVUsS0FBSyxJQUFJLDJCQUEyQixJQUFJLGFBQWEsVUFBVSxjQUFjLHlCQUF5QjtBQUN0SCxRQUFNLFNBQVMsS0FBSyxJQUFJLDJCQUEyQixJQUFJLGNBQWMsVUFBVSxlQUFlLHlCQUF5QjtBQUV2SCxRQUFNLE9BQU8sS0FBSyxJQUFJLEtBQUssSUFBSSxPQUFPLE1BQU0seUJBQXlCLEdBQUcsT0FBTztBQUMvRSxRQUFNLE1BQU0sS0FBSyxJQUFJLEtBQUssSUFBSSxPQUFPLFNBQVMsc0JBQXNCLHlCQUF5QixHQUFHLE1BQU07QUFFdEcsWUFBVSxNQUFNLE9BQU8sR0FBRyxPQUFPLEtBQUssTUFBTSxPQUFPLElBQUksT0FBTyxDQUFDLENBQUM7QUFDaEUsWUFBVSxNQUFNLE1BQU0sR0FBRyxPQUFPLEtBQUssTUFBTSxNQUFNLElBQUksT0FBTyxDQUFDLENBQUM7QUFDaEU7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/property-entry.d.mts

@@ -0,0 +1,43 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * The `property:name` / `property:name=value` entry syntax shared by the settings lists that can match a note by its frontmatter.
+ *
+ * Two lists read it today: note priorities (`findNotePriorityRank`) and the attachment extensions of `isTreatedAsAttachment`.
+ * Both match through the one function here, so an entry the user writes in one list means exactly the same thing in the other.
+ */
+/**
+ * The prefix that marks a settings entry as a frontmatter property match.
+ */
+export declare const PROPERTY_ENTRY_PREFIX = "property:";
+/**
+ * Parameters for {@link checkPropertyEntryMatches}.
+ */
+export interface CheckPropertyEntryMatchesParams {
+    /**
+     * The entry to match: `property:name` matches when the property is present, `property:name=value` when it renders as `value`.
+     */
+    readonly entry: string;
+    /**
+     * The note's frontmatter, or `null` when it has none or it is not known.
+     */
+    readonly frontmatter: null | Readonly<Record<string, unknown>>;
+}
+/**
+ * Checks whether a note's frontmatter matches a `property:name` or `property:name=value` entry.
+ *
+ * A value is compared by its rendering, since frontmatter values are whatever YAML produced, and an array matches when any of its items does,
+ * which is how tag-like properties read. An entry without the {@link PROPERTY_ENTRY_PREFIX} matches nothing.
+ *
+ * @param params - The entry and the frontmatter to match it against.
+ * @returns Whether the frontmatter matches the entry.
+ */
+export declare function checkPropertyEntryMatches(params: CheckPropertyEntryMatchesParams): boolean;
+/**
+ * Checks whether a settings entry is a frontmatter property match.
+ *
+ * @param entry - The entry to check.
+ * @returns Whether the entry starts with {@link PROPERTY_ENTRY_PREFIX}.
+ */
+export declare function isPropertyEntry(entry: string): boolean;

package/dist/lib/esm/property-entry.mjs

@@ -0,0 +1,73 @@
+/*
+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"
+  };
+  const existingProcess = globalThis.process;
+  if (!existingProcess) {
+    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();
+})();
+})();
+
+const PROPERTY_ENTRY_PREFIX = "property:";
+const PROPERTY_VALUE_SEPARATOR = "=";
+function checkPropertyEntryMatches(params) {
+  const {
+    entry,
+    frontmatter
+  } = params;
+  if (!frontmatter || !isPropertyEntry(entry)) {
+    return false;
+  }
+  const specifier = entry.slice(PROPERTY_ENTRY_PREFIX.length);
+  const separatorIndex = specifier.indexOf(PROPERTY_VALUE_SEPARATOR);
+  if (separatorIndex === -1) {
+    return Object.hasOwn(frontmatter, specifier);
+  }
+  const propertyName = specifier.slice(0, separatorIndex);
+  const expectedValue = specifier.slice(separatorIndex + 1);
+  if (!Object.hasOwn(frontmatter, propertyName)) {
+    return false;
+  }
+  const actualValue = frontmatter[propertyName];
+  return Array.isArray(actualValue) ? actualValue.some((item) => String(item) === expectedValue) : String(actualValue) === expectedValue;
+}
+function isPropertyEntry(entry) {
+  return entry.startsWith(PROPERTY_ENTRY_PREFIX);
+}
+export {
+  PROPERTY_ENTRY_PREFIX,
+  checkPropertyEntryMatches,
+  isPropertyEntry
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3Byb3BlcnR5LWVudHJ5LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogVGhlIGBwcm9wZXJ0eTpuYW1lYCAvIGBwcm9wZXJ0eTpuYW1lPXZhbHVlYCBlbnRyeSBzeW50YXggc2hhcmVkIGJ5IHRoZSBzZXR0aW5ncyBsaXN0cyB0aGF0IGNhbiBtYXRjaCBhIG5vdGUgYnkgaXRzIGZyb250bWF0dGVyLlxuICpcbiAqIFR3byBsaXN0cyByZWFkIGl0IHRvZGF5OiBub3RlIHByaW9yaXRpZXMgKGBmaW5kTm90ZVByaW9yaXR5UmFua2ApIGFuZCB0aGUgYXR0YWNobWVudCBleHRlbnNpb25zIG9mIGBpc1RyZWF0ZWRBc0F0dGFjaG1lbnRgLlxuICogQm90aCBtYXRjaCB0aHJvdWdoIHRoZSBvbmUgZnVuY3Rpb24gaGVyZSwgc28gYW4gZW50cnkgdGhlIHVzZXIgd3JpdGVzIGluIG9uZSBsaXN0IG1lYW5zIGV4YWN0bHkgdGhlIHNhbWUgdGhpbmcgaW4gdGhlIG90aGVyLlxuICovXG5cbi8qKlxuICogVGhlIHByZWZpeCB0aGF0IG1hcmtzIGEgc2V0dGluZ3MgZW50cnkgYXMgYSBmcm9udG1hdHRlciBwcm9wZXJ0eSBtYXRjaC5cbiAqL1xuZXhwb3J0IGNvbnN0IFBST1BFUlRZX0VOVFJZX1BSRUZJWCA9ICdwcm9wZXJ0eTonO1xuXG5jb25zdCBQUk9QRVJUWV9WQUxVRV9TRVBBUkFUT1IgPSAnPSc7XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIGNoZWNrUHJvcGVydHlFbnRyeU1hdGNoZXN9LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIENoZWNrUHJvcGVydHlFbnRyeU1hdGNoZXNQYXJhbXMge1xuICAvKipcbiAgICogVGhlIGVudHJ5IHRvIG1hdGNoOiBgcHJvcGVydHk6bmFtZWAgbWF0Y2hlcyB3aGVuIHRoZSBwcm9wZXJ0eSBpcyBwcmVzZW50LCBgcHJvcGVydHk6bmFtZT12YWx1ZWAgd2hlbiBpdCByZW5kZXJzIGFzIGB2YWx1ZWAuXG4gICAqL1xuICByZWFkb25seSBlbnRyeTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgbm90ZSdzIGZyb250bWF0dGVyLCBvciBgbnVsbGAgd2hlbiBpdCBoYXMgbm9uZSBvciBpdCBpcyBub3Qga25vd24uXG4gICAqL1xuICByZWFkb25seSBmcm9udG1hdHRlcjogbnVsbCB8IFJlYWRvbmx5PFJlY29yZDxzdHJpbmcsIHVua25vd24+Pjtcbn1cblxuLyoqXG4gKiBDaGVja3Mgd2hldGhlciBhIG5vdGUncyBmcm9udG1hdHRlciBtYXRjaGVzIGEgYHByb3BlcnR5Om5hbWVgIG9yIGBwcm9wZXJ0eTpuYW1lPXZhbHVlYCBlbnRyeS5cbiAqXG4gKiBBIHZhbHVlIGlzIGNvbXBhcmVkIGJ5IGl0cyByZW5kZXJpbmcsIHNpbmNlIGZyb250bWF0dGVyIHZhbHVlcyBhcmUgd2hhdGV2ZXIgWUFNTCBwcm9kdWNlZCwgYW5kIGFuIGFycmF5IG1hdGNoZXMgd2hlbiBhbnkgb2YgaXRzIGl0ZW1zIGRvZXMsXG4gKiB3aGljaCBpcyBob3cgdGFnLWxpa2UgcHJvcGVydGllcyByZWFkLiBBbiBlbnRyeSB3aXRob3V0IHRoZSB7QGxpbmsgUFJPUEVSVFlfRU5UUllfUFJFRklYfSBtYXRjaGVzIG5vdGhpbmcuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBlbnRyeSBhbmQgdGhlIGZyb250bWF0dGVyIHRvIG1hdGNoIGl0IGFnYWluc3QuXG4gKiBAcmV0dXJucyBXaGV0aGVyIHRoZSBmcm9udG1hdHRlciBtYXRjaGVzIHRoZSBlbnRyeS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGNoZWNrUHJvcGVydHlFbnRyeU1hdGNoZXMocGFyYW1zOiBDaGVja1Byb3BlcnR5RW50cnlNYXRjaGVzUGFyYW1zKTogYm9vbGVhbiB7XG4gIGNvbnN0IHtcbiAgICBlbnRyeSxcbiAgICBmcm9udG1hdHRlclxuICB9ID0gcGFyYW1zO1xuICBpZiAoIWZyb250bWF0dGVyIHx8ICFpc1Byb3BlcnR5RW50cnkoZW50cnkpKSB7XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG5cbiAgY29uc3Qgc3BlY2lmaWVyID0gZW50cnkuc2xpY2UoUFJPUEVSVFlfRU5UUllfUFJFRklYLmxlbmd0aCk7XG4gIGNvbnN0IHNlcGFyYXRvckluZGV4ID0gc3BlY2lmaWVyLmluZGV4T2YoUFJPUEVSVFlfVkFMVUVfU0VQQVJBVE9SKTtcbiAgaWYgKHNlcGFyYXRvckluZGV4ID09PSAtMSkge1xuICAgIHJldHVybiBPYmplY3QuaGFzT3duKGZyb250bWF0dGVyLCBzcGVjaWZpZXIpO1xuICB9XG5cbiAgY29uc3QgcHJvcGVydHlOYW1lID0gc3BlY2lmaWVyLnNsaWNlKDAsIHNlcGFyYXRvckluZGV4KTtcbiAgY29uc3QgZXhwZWN0ZWRWYWx1ZSA9IHNwZWNpZmllci5zbGljZShzZXBhcmF0b3JJbmRleCArIDEpO1xuICBpZiAoIU9iamVjdC5oYXNPd24oZnJvbnRtYXR0ZXIsIHByb3BlcnR5TmFtZSkpIHtcbiAgICByZXR1cm4gZmFsc2U7XG4gIH1cblxuICBjb25zdCBhY3R1YWxWYWx1ZSA9IGZyb250bWF0dGVyW3Byb3BlcnR5TmFtZV07XG4gIHJldHVybiBBcnJheS5pc0FycmF5KGFjdHVhbFZhbHVlKSA/IGFjdHVhbFZhbHVlLnNvbWUoKGl0ZW0pID0+IFN0cmluZyhpdGVtKSA9PT0gZXhwZWN0ZWRWYWx1ZSkgOiBTdHJpbmcoYWN0dWFsVmFsdWUpID09PSBleHBlY3RlZFZhbHVlO1xufVxuXG4vKipcbiAqIENoZWNrcyB3aGV0aGVyIGEgc2V0dGluZ3MgZW50cnkgaXMgYSBmcm9udG1hdHRlciBwcm9wZXJ0eSBtYXRjaC5cbiAqXG4gKiBAcGFyYW0gZW50cnkgLSBUaGUgZW50cnkgdG8gY2hlY2suXG4gKiBAcmV0dXJucyBXaGV0aGVyIHRoZSBlbnRyeSBzdGFydHMgd2l0aCB7QGxpbmsgUFJPUEVSVFlfRU5UUllfUFJFRklYfS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzUHJvcGVydHlFbnRyeShlbnRyeTogc3RyaW5nKTogYm9vbGVhbiB7XG4gIHJldHVybiBlbnRyeS5zdGFydHNXaXRoKFBST1BFUlRZX0VOVFJZX1BSRUZJWCk7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQVlPLE1BQU0sd0JBQXdCO0FBRXJDLE1BQU0sMkJBQTJCO0FBMEIxQixTQUFTLDBCQUEwQixRQUFrRDtBQUMxRixRQUFNO0FBQUEsSUFDSjtBQUFBLElBQ0E7QUFBQSxFQUNGLElBQUk7QUFDSixNQUFJLENBQUMsZUFBZSxDQUFDLGdCQUFnQixLQUFLLEdBQUc7QUFDM0MsV0FBTztBQUFBLEVBQ1Q7QUFFQSxRQUFNLFlBQVksTUFBTSxNQUFNLHNCQUFzQixNQUFNO0FBQzFELFFBQU0saUJBQWlCLFVBQVUsUUFBUSx3QkFBd0I7QUFDakUsTUFBSSxtQkFBbUIsSUFBSTtBQUN6QixXQUFPLE9BQU8sT0FBTyxhQUFhLFNBQVM7QUFBQSxFQUM3QztBQUVBLFFBQU0sZUFBZSxVQUFVLE1BQU0sR0FBRyxjQUFjO0FBQ3RELFFBQU0sZ0JBQWdCLFVBQVUsTUFBTSxpQkFBaUIsQ0FBQztBQUN4RCxNQUFJLENBQUMsT0FBTyxPQUFPLGFBQWEsWUFBWSxHQUFHO0FBQzdDLFdBQU87QUFBQSxFQUNUO0FBRUEsUUFBTSxjQUFjLFlBQVksWUFBWTtBQUM1QyxTQUFPLE1BQU0sUUFBUSxXQUFXLElBQUksWUFBWSxLQUFLLENBQUMsU0FBUyxPQUFPLElBQUksTUFBTSxhQUFhLElBQUksT0FBTyxXQUFXLE1BQU07QUFDM0g7QUFRTyxTQUFTLGdCQUFnQixPQUF3QjtBQUN0RCxTQUFPLE1BQU0sV0FBVyxxQkFBcUI7QUFDL0M7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/queue.d.mts

@@ -0,0 +1,93 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * Contains utility functions for enqueuing and processing functions in Obsidian.
+ */
+import type { Promisable } from 'type-fest';
+/**
+ * Options for the {@link addToQueueAndWait} function.
+ */
+export interface AddToQueueAndWaitParams {
+    /**
+     * Optional abort signal.
+     */
+    readonly abortSignal?: AbortSignal;
+    /**
+     * The function to add.
+     */
+    readonly operationFunction: (abortSignal: AbortSignal) => Promisable<void>;
+    /**
+     * Optional name of the operation.
+     *
+     * @default `''`
+     */
+    readonly operationName?: string;
+    /**
+     * Whether to show a timeout notice.
+     *
+     * @default `true`
+     */
+    readonly shouldShowTimeoutNotice?: boolean;
+    /**
+     * Optional stack trace.
+     */
+    readonly stackTrace?: string;
+    /**
+     * The timeout in milliseconds.
+     *
+     * @default `60000`
+     */
+    readonly timeoutInMilliseconds?: number;
+}
+/**
+ * Options for the {@link addToQueue} function.
+ */
+export interface AddToQueueParams {
+    /**
+     * Optional abort signal.
+     */
+    readonly abortSignal?: AbortSignal;
+    /**
+     * The function to add.
+     */
+    readonly operationFunction: (abortSignal: AbortSignal) => Promisable<void>;
+    /**
+     * Optional name of the operation.
+     *
+     * @default `''`
+     */
+    readonly operationName?: string;
+    /**
+     * Whether to show a timeout notice.
+     *
+     * @default `true`
+     */
+    readonly shouldShowTimeoutNotice?: boolean;
+    /**
+     * Optional stack trace.
+     */
+    readonly stackTrace?: string;
+    /**
+     * The timeout in milliseconds.
+     *
+     * @default `60000`
+     */
+    readonly timeoutInMilliseconds?: number;
+}
+/**
+ * Adds an asynchronous function to be executed after the previous function completes.
+ *
+ * @param params - The parameters for the function.
+ */
+export declare function addToQueue(params: AddToQueueParams): void;
+/**
+ * Adds an asynchronous function to be executed after the previous function completes and returns a {@link Promise} that resolves when the function completes.
+ *
+ * @param params - The parameters for the function.
+ */
+export declare function addToQueueAndWait(params: AddToQueueAndWaitParams): Promise<void>;
+/**
+ * Flushes the queue;
+ */
+export declare function flushQueue(): Promise<void>;

package/dist/lib/esm/queue.mjs

@@ -0,0 +1,122 @@
+/*
+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"
+  };
+  const existingProcess = globalThis.process;
+  if (!existingProcess) {
+    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 {
+  abortSignalAny,
+  abortSignalNever
+} from "@mnaoumov/typescript-lib/abort-controller";
+import {
+  addErrorHandler,
+  invokeAsyncSafely
+} from "@mnaoumov/typescript-lib/async";
+import { getStackTrace } from "@mnaoumov/typescript-lib/error";
+import {
+  noop,
+  noopAsync
+} from "@mnaoumov/typescript-lib/function";
+import { runWithTimeoutNotice } from "./async-with-notice.mjs";
+import { t } from "./i18n/i18n.mjs";
+import { invokeAsyncAndLog } from "./logger.mjs";
+import { getObsidianDevUtilsState } from "./obsidian-dev-utils-state.mjs";
+function addToQueue(params) {
+  const stackTrace = params.stackTrace ?? getStackTrace(1);
+  invokeAsyncSafely(() => addToQueueAndWait(params), stackTrace);
+}
+async function addToQueueAndWait(params) {
+  const abortSignal = params.abortSignal ?? abortSignalNever();
+  abortSignal.throwIfAborted();
+  const DEFAULT_TIMEOUT_IN_MILLISECONDS = 6e4;
+  const timeoutInMilliseconds = params.timeoutInMilliseconds ?? DEFAULT_TIMEOUT_IN_MILLISECONDS;
+  const stackTrace = params.stackTrace ?? getStackTrace(1);
+  const operationName = params.operationName ?? "";
+  const queue = getQueue().value;
+  queue.items.push({
+    abortSignal,
+    operationFunction: params.operationFunction,
+    operationName,
+    shouldShowTimeoutNotice: params.shouldShowTimeoutNotice ?? true,
+    stackTrace,
+    timeoutInMilliseconds
+  });
+  queue.promise = queue.promise.then(() => processNextQueueItem());
+  await queue.promise;
+}
+async function flushQueue() {
+  await addToQueueAndWait({
+    operationFunction: noop,
+    operationName: t(($) => $.obsidianDevUtils.queue.flushQueue)
+  });
+}
+function getQueue() {
+  return getObsidianDevUtilsState("queue", { items: [], promise: noopAsync() });
+}
+async function processNextQueueItem() {
+  const queue = getQueue().value;
+  const item = queue.items[0];
+  if (!item) {
+    return;
+  }
+  await addErrorHandler(
+    () => runWithTimeoutNotice({
+      context: { queuedFunction: item.operationFunction },
+      async operationFunction(abortSignal) {
+        await invokeAsyncAndLog({
+          $function: item.operationFunction,
+          abortSignal: abortSignalAny(abortSignal, item.abortSignal),
+          stackTrace: item.stackTrace,
+          title: item.operationName || processNextQueueItem.name
+        });
+      },
+      operationName: item.operationName,
+      pluginNoticeComponent: null,
+      shouldShowTimeoutNotice: item.shouldShowTimeoutNotice,
+      stackTrace: item.stackTrace,
+      timeoutInMilliseconds: item.timeoutInMilliseconds
+    })
+  );
+  queue.items.shift();
+}
+export {
+  addToQueue,
+  addToQueueAndWait,
+  flushQueue
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3F1ZXVlLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29udGFpbnMgdXRpbGl0eSBmdW5jdGlvbnMgZm9yIGVucXVldWluZyBhbmQgcHJvY2Vzc2luZyBmdW5jdGlvbnMgaW4gT2JzaWRpYW4uXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBWYWx1ZVdyYXBwZXIgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvdmFsdWUtd3JhcHBlcic7XG5pbXBvcnQgdHlwZSB7IFByb21pc2FibGUgfSBmcm9tICd0eXBlLWZlc3QnO1xuXG5pbXBvcnQge1xuICBhYm9ydFNpZ25hbEFueSxcbiAgYWJvcnRTaWduYWxOZXZlclxufSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvYWJvcnQtY29udHJvbGxlcic7XG5pbXBvcnQge1xuICBhZGRFcnJvckhhbmRsZXIsXG4gIGludm9rZUFzeW5jU2FmZWx5XG59IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9hc3luYyc7XG5pbXBvcnQgeyBnZXRTdGFja1RyYWNlIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL2Vycm9yJztcbmltcG9ydCB7XG4gIG5vb3AsXG4gIG5vb3BBc3luY1xufSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvZnVuY3Rpb24nO1xuXG5pbXBvcnQgeyBydW5XaXRoVGltZW91dE5vdGljZSB9IGZyb20gJy4vYXN5bmMtd2l0aC1ub3RpY2UudHMnO1xuaW1wb3J0IHsgdCB9IGZyb20gJy4vaTE4bi9pMThuLnRzJztcbmltcG9ydCB7IGludm9rZUFzeW5jQW5kTG9nIH0gZnJvbSAnLi9sb2dnZXIudHMnO1xuaW1wb3J0IHsgZ2V0T2JzaWRpYW5EZXZVdGlsc1N0YXRlIH0gZnJvbSAnLi9vYnNpZGlhbi1kZXYtdXRpbHMtc3RhdGUudHMnO1xuXG4vKipcbiAqIE9wdGlvbnMgZm9yIHRoZSB7QGxpbmsgYWRkVG9RdWV1ZUFuZFdhaXR9IGZ1bmN0aW9uLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEFkZFRvUXVldWVBbmRXYWl0UGFyYW1zIHtcbiAgLyoqXG4gICAqIE9wdGlvbmFsIGFib3J0IHNpZ25hbC5cbiAgICovXG4gIHJlYWRvbmx5IGFib3J0U2lnbmFsPzogQWJvcnRTaWduYWw7XG5cbiAgLyoqXG4gICAqIFRoZSBmdW5jdGlvbiB0byBhZGQuXG4gICAqL1xuICByZWFkb25seSBvcGVyYXRpb25GdW5jdGlvbjogKGFib3J0U2lnbmFsOiBBYm9ydFNpZ25hbCkgPT4gUHJvbWlzYWJsZTx2b2lkPjtcblxuICAvKipcbiAgICogT3B0aW9uYWwgbmFtZSBvZiB0aGUgb3BlcmF0aW9uLlxuICAgKlxuICAgKiBAZGVmYXVsdCBgJydgXG4gICAqL1xuICByZWFkb25seSBvcGVyYXRpb25OYW1lPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBXaGV0aGVyIHRvIHNob3cgYSB0aW1lb3V0IG5vdGljZS5cbiAgICpcbiAgICogQGRlZmF1bHQgYHRydWVgXG4gICAqL1xuICByZWFkb25seSBzaG91bGRTaG93VGltZW91dE5vdGljZT86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIE9wdGlvbmFsIHN0YWNrIHRyYWNlLlxuICAgKi9cbiAgcmVhZG9ubHkgc3RhY2tUcmFjZT86IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIHRpbWVvdXQgaW4gbWlsbGlzZWNvbmRzLlxuICAgKlxuICAgKiBAZGVmYXVsdCBgNjAwMDBgXG4gICAqL1xuICByZWFkb25seSB0aW1lb3V0SW5NaWxsaXNlY29uZHM/OiBudW1iZXI7XG59XG5cbi8qKlxuICogT3B0aW9ucyBmb3IgdGhlIHtAbGluayBhZGRUb1F1ZXVlfSBmdW5jdGlvbi5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBBZGRUb1F1ZXVlUGFyYW1zIHtcbiAgLyoqXG4gICAqIE9wdGlvbmFsIGFib3J0IHNpZ25hbC5cbiAgICovXG4gIHJlYWRvbmx5IGFib3J0U2lnbmFsPzogQWJvcnRTaWduYWw7XG5cbiAgLyoqXG4gICAqIFRoZSBmdW5jdGlvbiB0byBhZGQuXG4gICAqL1xuICByZWFkb25seSBvcGVyYXRpb25GdW5jdGlvbjogKGFib3J0U2lnbmFsOiBBYm9ydFNpZ25hbCkgPT4gUHJvbWlzYWJsZTx2b2lkPjtcblxuICAvKipcbiAgICogT3B0aW9uYWwgbmFtZSBvZiB0aGUgb3BlcmF0aW9uLlxuICAgKlxuICAgKiBAZGVmYXVsdCBgJydgXG4gICAqL1xuICByZWFkb25seSBvcGVyYXRpb25OYW1lPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBXaGV0aGVyIHRvIHNob3cgYSB0aW1lb3V0IG5vdGljZS5cbiAgICpcbiAgICogQGRlZmF1bHQgYHRydWVgXG4gICAqL1xuICByZWFkb25seSBzaG91bGRTaG93VGltZW91dE5vdGljZT86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIE9wdGlvbmFsIHN0YWNrIHRyYWNlLlxuICAgKi9cbiAgcmVhZG9ubHkgc3RhY2tUcmFjZT86IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIHRpbWVvdXQgaW4gbWlsbGlzZWNvbmRzLlxuICAgKlxuICAgKiBAZGVmYXVsdCBgNjAwMDBgXG4gICAqL1xuICByZWFkb25seSB0aW1lb3V0SW5NaWxsaXNlY29uZHM/OiBudW1iZXI7XG59XG5cbmludGVyZmFjZSBRdWV1ZSB7XG4gIGl0ZW1zOiBRdWV1ZUl0ZW1bXTtcbiAgcHJvbWlzZTogUHJvbWlzZTx2b2lkPjtcbn1cblxuaW50ZXJmYWNlIFF1ZXVlSXRlbSB7XG4gIGFib3J0U2lnbmFsOiBBYm9ydFNpZ25hbDtcbiAgb3BlcmF0aW9uRnVuY3Rpb246IChhYm9ydFNpZ25hbDogQWJvcnRTaWduYWwpID0+IFByb21pc2FibGU8dm9pZD47XG4gIG9wZXJhdGlvbk5hbWU6IHN0cmluZztcbiAgc2hvdWxkU2hvd1RpbWVvdXROb3RpY2U6IGJvb2xlYW47XG4gIHN0YWNrVHJhY2U6IHN0cmluZztcbiAgdGltZW91dEluTWlsbGlzZWNvbmRzOiBudW1iZXI7XG59XG5cbi8qKlxuICogQWRkcyBhbiBhc3luY2hyb25vdXMgZnVuY3Rpb24gdG8gYmUgZXhlY3V0ZWQgYWZ0ZXIgdGhlIHByZXZpb3VzIGZ1bmN0aW9uIGNvbXBsZXRlcy5cbiAqXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBhcmFtZXRlcnMgZm9yIHRoZSBmdW5jdGlvbi5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGFkZFRvUXVldWUocGFyYW1zOiBBZGRUb1F1ZXVlUGFyYW1zKTogdm9pZCB7XG4gIGNvbnN0IHN0YWNrVHJhY2UgPSBwYXJhbXMuc3RhY2tUcmFjZSA/PyBnZXRTdGFja1RyYWNlKDEpO1xuICBpbnZva2VBc3luY1NhZmVseSgoKSA9PiBhZGRUb1F1ZXVlQW5kV2FpdChwYXJhbXMpLCBzdGFja1RyYWNlKTtcbn1cblxuLyoqXG4gKiBBZGRzIGFuIGFzeW5jaHJvbm91cyBmdW5jdGlvbiB0byBiZSBleGVjdXRlZCBhZnRlciB0aGUgcHJldmlvdXMgZnVuY3Rpb24gY29tcGxldGVzIGFuZCByZXR1cm5zIGEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgd2hlbiB0aGUgZnVuY3Rpb24gY29tcGxldGVzLlxuICpcbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycyBmb3IgdGhlIGZ1bmN0aW9uLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gYWRkVG9RdWV1ZUFuZFdhaXQocGFyYW1zOiBBZGRUb1F1ZXVlQW5kV2FpdFBhcmFtcyk6IFByb21pc2U8dm9pZD4ge1xuICBjb25zdCBhYm9ydFNpZ25hbCA9IHBhcmFtcy5hYm9ydFNpZ25hbCA/PyBhYm9ydFNpZ25hbE5ldmVyKCk7XG4gIGFib3J0U2lnbmFsLnRocm93SWZBYm9ydGVkKCk7XG5cbiAgY29uc3QgREVGQVVMVF9USU1FT1VUX0lOX01JTExJU0VDT05EUyA9IDYwXzAwMDtcbiAgY29uc3QgdGltZW91dEluTWlsbGlzZWNvbmRzID0gcGFyYW1zLnRpbWVvdXRJbk1pbGxpc2Vjb25kcyA/PyBERUZBVUxUX1RJTUVPVVRfSU5fTUlMTElTRUNPTkRTO1xuICBjb25zdCBzdGFja1RyYWNlID0gcGFyYW1zLnN0YWNrVHJhY2UgPz8gZ2V0U3RhY2tUcmFjZSgxKTtcbiAgY29uc3Qgb3BlcmF0aW9uTmFtZSA9IHBhcmFtcy5vcGVyYXRpb25OYW1lID8/ICcnO1xuICBjb25zdCBxdWV1ZSA9IGdldFF1ZXVlKCkudmFsdWU7XG4gIHF1ZXVlLml0ZW1zLnB1c2goe1xuICAgIGFib3J0U2lnbmFsLFxuICAgIG9wZXJhdGlvbkZ1bmN0aW9uOiBwYXJhbXMub3BlcmF0aW9uRnVuY3Rpb24sXG4gICAgb3BlcmF0aW9uTmFtZSxcbiAgICBzaG91bGRTaG93VGltZW91dE5vdGljZTogcGFyYW1zLnNob3VsZFNob3dUaW1lb3V0Tm90aWNlID8/IHRydWUsXG4gICAgc3RhY2tUcmFjZSxcbiAgICB0aW1lb3V0SW5NaWxsaXNlY29uZHNcbiAgfSk7XG4gIHF1ZXVlLnByb21pc2UgPSBxdWV1ZS5wcm9taXNlLnRoZW4oKCkgPT4gcHJvY2Vzc05leHRRdWV1ZUl0ZW0oKSk7XG4gIGF3YWl0IHF1ZXVlLnByb21pc2U7XG59XG5cbi8qKlxuICogRmx1c2hlcyB0aGUgcXVldWU7XG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBmbHVzaFF1ZXVlKCk6IFByb21pc2U8dm9pZD4ge1xuICBhd2FpdCBhZGRUb1F1ZXVlQW5kV2FpdCh7XG4gICAgb3BlcmF0aW9uRnVuY3Rpb246IG5vb3AsXG4gICAgb3BlcmF0aW9uTmFtZTogdCgoJCkgPT4gJC5vYnNpZGlhbkRldlV0aWxzLnF1ZXVlLmZsdXNoUXVldWUpXG4gIH0pO1xufVxuXG5mdW5jdGlvbiBnZXRRdWV1ZSgpOiBWYWx1ZVdyYXBwZXI8UXVldWU+IHtcbiAgcmV0dXJuIGdldE9ic2lkaWFuRGV2VXRpbHNTdGF0ZSgncXVldWUnLCB7IGl0ZW1zOiBbXSwgcHJvbWlzZTogbm9vcEFzeW5jKCkgfSk7XG59XG5cbmFzeW5jIGZ1bmN0aW9uIHByb2Nlc3NOZXh0UXVldWVJdGVtKCk6IFByb21pc2U8dm9pZD4ge1xuICBjb25zdCBxdWV1ZSA9IGdldFF1ZXVlKCkudmFsdWU7XG4gIGNvbnN0IGl0ZW0gPSBxdWV1ZS5pdGVtc1swXTtcbiAgLyogdjggaWdub3JlIHN0YXJ0IC0tIERlZmVuc2l2ZSBjaGVjazsgcHJvY2Vzc05leHRRdWV1ZUl0ZW0gaXMgb25seSBjYWxsZWQgYWZ0ZXIgYW4gaXRlbSBpcyBwdXNoZWQuICovXG4gIGlmICghaXRlbSkge1xuICAgIHJldHVybjtcbiAgfVxuICAvKiB2OCBpZ25vcmUgc3RvcCAqL1xuXG4gIGF3YWl0IGFkZEVycm9ySGFuZGxlcigoKSA9PlxuICAgIHJ1bldpdGhUaW1lb3V0Tm90aWNlKHtcbiAgICAgIGNvbnRleHQ6IHsgcXVldWVkRnVuY3Rpb246IGl0ZW0ub3BlcmF0aW9uRnVuY3Rpb24gfSxcbiAgICAgIGFzeW5jIG9wZXJhdGlvbkZ1bmN0aW9uKGFib3J0U2lnbmFsOiBBYm9ydFNpZ25hbCk6IFByb21pc2U8dm9pZD4ge1xuICAgICAgICBhd2FpdCBpbnZva2VBc3luY0FuZExvZyh7XG4gICAgICAgICAgJGZ1bmN0aW9uOiBpdGVtLm9wZXJhdGlvbkZ1bmN0aW9uLFxuICAgICAgICAgIGFib3J0U2lnbmFsOiBhYm9ydFNpZ25hbEFueShhYm9ydFNpZ25hbCwgaXRlbS5hYm9ydFNpZ25hbCksXG4gICAgICAgICAgc3RhY2tUcmFjZTogaXRlbS5zdGFja1RyYWNlLFxuICAgICAgICAgIHRpdGxlOiBpdGVtLm9wZXJhdGlvbk5hbWUgfHwgcHJvY2Vzc05leHRRdWV1ZUl0ZW0ubmFtZVxuICAgICAgICB9KTtcbiAgICAgIH0sXG4gICAgICBvcGVyYXRpb25OYW1lOiBpdGVtLm9wZXJhdGlvbk5hbWUsXG4gICAgICBwbHVnaW5Ob3RpY2VDb21wb25lbnQ6IG51bGwsXG4gICAgICBzaG91bGRTaG93VGltZW91dE5vdGljZTogaXRlbS5zaG91bGRTaG93VGltZW91dE5vdGljZSxcbiAgICAgIHN0YWNrVHJhY2U6IGl0ZW0uc3RhY2tUcmFjZSxcbiAgICAgIHRpbWVvdXRJbk1pbGxpc2Vjb25kczogaXRlbS50aW1lb3V0SW5NaWxsaXNlY29uZHNcbiAgICB9KVxuICApO1xuICBxdWV1ZS5pdGVtcy5zaGlmdCgpO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFTQTtBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsT0FDSztBQUNQO0FBQUEsRUFDRTtBQUFBLEVBQ0E7QUFBQSxPQUNLO0FBQ1AsU0FBUyxxQkFBcUI7QUFDOUI7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFFUCxTQUFTLDRCQUE0QjtBQUNyQyxTQUFTLFNBQVM7QUFDbEIsU0FBUyx5QkFBeUI7QUFDbEMsU0FBUyxnQ0FBZ0M7QUF1R2xDLFNBQVMsV0FBVyxRQUFnQztBQUN6RCxRQUFNLGFBQWEsT0FBTyxjQUFjLGNBQWMsQ0FBQztBQUN2RCxvQkFBa0IsTUFBTSxrQkFBa0IsTUFBTSxHQUFHLFVBQVU7QUFDL0Q7QUFPQSxlQUFzQixrQkFBa0IsUUFBZ0Q7QUFDdEYsUUFBTSxjQUFjLE9BQU8sZUFBZSxpQkFBaUI7QUFDM0QsY0FBWSxlQUFlO0FBRTNCLFFBQU0sa0NBQWtDO0FBQ3hDLFFBQU0sd0JBQXdCLE9BQU8seUJBQXlCO0FBQzlELFFBQU0sYUFBYSxPQUFPLGNBQWMsY0FBYyxDQUFDO0FBQ3ZELFFBQU0sZ0JBQWdCLE9BQU8saUJBQWlCO0FBQzlDLFFBQU0sUUFBUSxTQUFTLEVBQUU7QUFDekIsUUFBTSxNQUFNLEtBQUs7QUFBQSxJQUNmO0FBQUEsSUFDQSxtQkFBbUIsT0FBTztBQUFBLElBQzFCO0FBQUEsSUFDQSx5QkFBeUIsT0FBTywyQkFBMkI7QUFBQSxJQUMzRDtBQUFBLElBQ0E7QUFBQSxFQUNGLENBQUM7QUFDRCxRQUFNLFVBQVUsTUFBTSxRQUFRLEtBQUssTUFBTSxxQkFBcUIsQ0FBQztBQUMvRCxRQUFNLE1BQU07QUFDZDtBQUtBLGVBQXNCLGFBQTRCO0FBQ2hELFFBQU0sa0JBQWtCO0FBQUEsSUFDdEIsbUJBQW1CO0FBQUEsSUFDbkIsZUFBZSxFQUFFLENBQUMsTUFBTSxFQUFFLGlCQUFpQixNQUFNLFVBQVU7QUFBQSxFQUM3RCxDQUFDO0FBQ0g7QUFFQSxTQUFTLFdBQWdDO0FBQ3ZDLFNBQU8seUJBQXlCLFNBQVMsRUFBRSxPQUFPLENBQUMsR0FBRyxTQUFTLFVBQVUsRUFBRSxDQUFDO0FBQzlFO0FBRUEsZUFBZSx1QkFBc0M7QUFDbkQsUUFBTSxRQUFRLFNBQVMsRUFBRTtBQUN6QixRQUFNLE9BQU8sTUFBTSxNQUFNLENBQUM7QUFFMUIsTUFBSSxDQUFDLE1BQU07QUFDVDtBQUFBLEVBQ0Y7QUFHQSxRQUFNO0FBQUEsSUFBZ0IsTUFDcEIscUJBQXFCO0FBQUEsTUFDbkIsU0FBUyxFQUFFLGdCQUFnQixLQUFLLGtCQUFrQjtBQUFBLE1BQ2xELE1BQU0sa0JBQWtCLGFBQXlDO0FBQy9ELGNBQU0sa0JBQWtCO0FBQUEsVUFDdEIsV0FBVyxLQUFLO0FBQUEsVUFDaEIsYUFBYSxlQUFlLGFBQWEsS0FBSyxXQUFXO0FBQUEsVUFDekQsWUFBWSxLQUFLO0FBQUEsVUFDakIsT0FBTyxLQUFLLGlCQUFpQixxQkFBcUI7QUFBQSxRQUNwRCxDQUFDO0FBQUEsTUFDSDtBQUFBLE1BQ0EsZUFBZSxLQUFLO0FBQUEsTUFDcEIsdUJBQXVCO0FBQUEsTUFDdkIseUJBQXlCLEtBQUs7QUFBQSxNQUM5QixZQUFZLEtBQUs7QUFBQSxNQUNqQix1QkFBdUIsS0FBSztBQUFBLElBQzlCLENBQUM7QUFBQSxFQUNIO0FBQ0EsUUFBTSxNQUFNLE1BQU07QUFDcEI7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/react/app-context.d.mts

@@ -0,0 +1,24 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Passes obsidian {@link App} instance to React components.
+ */
+import { App } from 'obsidian';
+/**
+ * A context for the app.
+ *
+ * Usage:
+ * ```tsx
+ * <AppContext.Provider value={app}>
+ *   <YourComponent />
+ * </AppContext.Provider>
+ * ```
+ */
+export declare const AppContext: import("react").Context<App | undefined>;
+/**
+ * A hook to use the app context.
+ *
+ * @returns The app instance.
+ */
+export declare function useApp(): App;

package/dist/lib/esm/react/app-context.mjs

@@ -0,0 +1,56 @@
+/*
+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"
+  };
+  const existingProcess = globalThis.process;
+  if (!existingProcess) {
+    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 { ensureNonNullable } from "@mnaoumov/typescript-lib/type-guards";
+import { App } from "obsidian";
+import {
+  createContext,
+  useContext
+} from "react";
+const AppContext = createContext(void 0);
+function useApp() {
+  return ensureNonNullable(useContext(AppContext), "AppContext not found");
+}
+export {
+  AppContext,
+  useApp
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3JlYWN0L2FwcC1jb250ZXh0LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogUGFzc2VzIG9ic2lkaWFuIHtAbGluayBBcHB9IGluc3RhbmNlIHRvIFJlYWN0IGNvbXBvbmVudHMuXG4gKi9cblxuaW1wb3J0IHsgZW5zdXJlTm9uTnVsbGFibGUgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvdHlwZS1ndWFyZHMnO1xuaW1wb3J0IHsgQXBwIH0gZnJvbSAnb2JzaWRpYW4nO1xuaW1wb3J0IHtcbiAgY3JlYXRlQ29udGV4dCxcbiAgdXNlQ29udGV4dFxufSBmcm9tICdyZWFjdCc7XG5cbi8qKlxuICogQSBjb250ZXh0IGZvciB0aGUgYXBwLlxuICpcbiAqIFVzYWdlOlxuICogYGBgdHN4XG4gKiA8QXBwQ29udGV4dC5Qcm92aWRlciB2YWx1ZT17YXBwfT5cbiAqICAgPFlvdXJDb21wb25lbnQgLz5cbiAqIDwvQXBwQ29udGV4dC5Qcm92aWRlcj5cbiAqIGBgYFxuICovXG4vKiB2OCBpZ25vcmUgc3RhcnQgLS0gUmVhY3QgY29udGV4dCByZXF1aXJlcyBSZWFjdCB0ZXN0aW5nIHNldHVwIHRoYXQgaXMgbm90IGF2YWlsYWJsZSBpbiB0aGlzIHByb2plY3QuICovXG5leHBvcnQgY29uc3QgQXBwQ29udGV4dCA9IGNyZWF0ZUNvbnRleHQ8QXBwIHwgdW5kZWZpbmVkPih1bmRlZmluZWQpO1xuXG4vKipcbiAqIEEgaG9vayB0byB1c2UgdGhlIGFwcCBjb250ZXh0LlxuICpcbiAqIEByZXR1cm5zIFRoZSBhcHAgaW5zdGFuY2UuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB1c2VBcHAoKTogQXBwIHtcbiAgcmV0dXJuIGVuc3VyZU5vbk51bGxhYmxlKHVzZUNvbnRleHQoQXBwQ29udGV4dCksICdBcHBDb250ZXh0IG5vdCBmb3VuZCcpO1xufVxuLyogdjggaWdub3JlIHN0b3AgKi9cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBTUEsU0FBUyx5QkFBeUI7QUFDbEMsU0FBUyxXQUFXO0FBQ3BCO0FBQUEsRUFDRTtBQUFBLEVBQ0E7QUFBQSxPQUNLO0FBYUEsTUFBTSxhQUFhLGNBQStCLE1BQVM7QUFPM0QsU0FBUyxTQUFjO0FBQzVCLFNBQU8sa0JBQWtCLFdBQVcsVUFBVSxHQUFHLHNCQUFzQjtBQUN6RTsiLAogICJuYW1lcyI6IFtdCn0K