@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/esm/plugin/settings-migration-api.d.mts

@@ -0,0 +1,91 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * The generic half of a settings HANDOVER contract: one plugin offers another the settings it used to own,
+ * and the plugin that owns them now decides what to do with the offer.
+ *
+ * The shape below is deliberately the *envelope* and nothing else. A handover has three parts, and only one
+ * of them is generic:
+ *
+ * - The **envelope** — a `migrateSettings` call, who is proposing, and whether the user applied it. Identical
+ *   for every pair of plugins, so it lives here.
+ * - The **payload** — which settings are being proposed. Entirely the pair's own business, so it stays a type
+ *   parameter and is never named here.
+ * - The **provider's identity** — its plugin id and display name. Also the pair's own business, and not
+ *   something this library has any standing to own.
+ *
+ * Why it is declared rather than imported. A provider is typically an Obsidian *plugin* repo, not an npm
+ * package, so a consumer has nothing to depend on and hand-writes its own copy of the contract. Five copies
+ * of one contract with no compiler link between them means drift is SILENT — every copy still compiles and
+ * the handover fails at runtime instead. Declaring the envelope here gives both ends one declaration to
+ * compile against; `watchPluginApi` still negotiates the version at runtime, because the two ends ship
+ * independently and always will.
+ *
+ * The provider publishes it:
+ *
+ * ```ts
+ * publishPluginApi<SettingsMigrationApi<MyMigratableSettings>>({
+ *   api: this.settingsMigrationApi,
+ *   apiVersion: '1.0.0',
+ *   contract: { migrateSettings: {} },
+ *   plugin: this
+ * });
+ * ```
+ *
+ * The consumer reaches it through {@link obsidian/components/settings-migration-component!SettingsMigrationComponent},
+ * which owns the whole offer-and-retire dance.
+ */
+/**
+ * Parameters for {@link SettingsMigrationApi.migrateSettings}.
+ *
+ * @typeParam TMigratableSettings - The settings the proposing plugin may hand over.
+ */
+export interface MigrateSettingsParams<TMigratableSettings extends object> {
+    /**
+     * The values the proposing plugin offers.
+     *
+     * Conventionally every member is optional, so a plugin proposes only what it actually held and a value the
+     * provider already owns is never overwritten by a default nobody chose. That convention belongs to the pair,
+     * though — this type imposes only the envelope.
+     */
+    readonly proposedSettings: TMigratableSettings;
+    /**
+     * The `manifest.id` of the plugin making the proposal, so the provider's dialog can say whose settings
+     * these are.
+     */
+    readonly sourcePluginId: string;
+}
+/**
+ * The outcome of {@link SettingsMigrationApi.migrateSettings}.
+ */
+export interface MigrateSettingsResult {
+    /**
+     * Whether the user approved the migration.
+     *
+     * `false` means they cancelled and nothing was written, so the proposing plugin must NOT record the
+     * migration as done — a cancel is not an answer, and the offer has to come back.
+     */
+    readonly isApplied: boolean;
+}
+/**
+ * The API a plugin publishes when it is willing to receive settings another plugin used to own.
+ *
+ * @typeParam TMigratableSettings - The settings this provider accepts.
+ *
+ * @remarks
+ * The provider owns the settings, so it owns the dialog: a proposing plugin never writes into another
+ * plugin's `data.json`. It proposes, and the user approves, edits or declines.
+ */
+export interface SettingsMigrationApi<TMigratableSettings extends object> {
+    /**
+     * Offers the user a set of settings values another plugin proposes, and applies what they approve.
+     *
+     * Resolves only once the dialog is closed, so the caller learns whether the migration actually happened and
+     * can retire — or withhold — its own pending values on that answer.
+     *
+     * @param params - The proposal.
+     * @returns What the user approved.
+     */
+    migrateSettings: (params: MigrateSettingsParams<TMigratableSettings>) => Promise<MigrateSettingsResult>;
+}

package/dist/lib/esm/plugin/settings-migration-api.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

package/dist/lib/esm/plugin-cli-handler-registrar.d.mts

@@ -0,0 +1,64 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * CLI handler registrars.
+ */
+import type { CliData, CliFlags } from 'obsidian';
+import type { Promisable } from 'type-fest';
+import { Plugin } from 'obsidian';
+/**
+ * Registers CLI handlers.
+ */
+export interface CliHandlerRegistrar {
+    /**
+     * Registers a CLI handler.
+     *
+     * @param params - The parameters for the CLI handler registration.
+     */
+    registerCliHandler: (params: CliHandlerRegistrarRegisterCliHandlerParams) => void;
+}
+/**
+ * Parameters for registering a CLI handler.
+ */
+export interface CliHandlerRegistrarRegisterCliHandlerParams {
+    /**
+     * The command to register the handler for.
+     */
+    readonly command: string;
+    /**
+     * The description of the command.
+     */
+    readonly description: string;
+    /**
+     * The flags for the command.
+     */
+    readonly flags: CliFlags | null;
+    /**
+     * The handler to register.
+     *
+     * @param cliData - The data passed to the handler.
+     * @returns The result of the handler.
+     */
+    readonly handler: (cliData: CliData) => Promisable<string>;
+}
+type PluginCliHandlerRegistrarRegisterCliHandlerParams = CliHandlerRegistrarRegisterCliHandlerParams;
+/**
+ * CLI handler registrar in an Obsidian plugin.
+ */
+export declare class PluginCliHandlerRegistrar implements CliHandlerRegistrar {
+    protected readonly plugin: Plugin;
+    /**
+     * Creates a new instance of the {@link PluginCliHandlerRegistrar} class.
+     *
+     * @param plugin - The Obsidian plugin instance.
+     */
+    constructor(plugin: Plugin);
+    /**
+     * Registers a CLI handler.
+     *
+     * @param params - The parameters for the CLI handler registration.
+     */
+    registerCliHandler(params: PluginCliHandlerRegistrarRegisterCliHandlerParams): void;
+}
+export {};

package/dist/lib/esm/plugin-cli-handler-registrar.mjs

@@ -0,0 +1,74 @@
+/*
+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 { normalizePromisable } from "@mnaoumov/typescript-lib/async";
+import { Plugin } from "obsidian";
+class PluginCliHandlerRegistrar {
+  /**
+   * Creates a new instance of the {@link PluginCliHandlerRegistrar} class.
+   *
+   * @param plugin - The Obsidian plugin instance.
+   */
+  constructor(plugin) {
+    this.plugin = plugin;
+  }
+  plugin;
+  /**
+   * Registers a CLI handler.
+   *
+   * @param params - The parameters for the CLI handler registration.
+   */
+  registerCliHandler(params) {
+    this.plugin.registerCliHandler(params.command, params.description, params.flags, (cliData) => normalizePromisable(params.handler(cliData)));
+  }
+}
+export {
+  PluginCliHandlerRegistrar
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3BsdWdpbi1jbGktaGFuZGxlci1yZWdpc3RyYXIudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBDTEkgaGFuZGxlciByZWdpc3RyYXJzLlxuICovXG5cbmltcG9ydCB0eXBlIHtcbiAgQ2xpRGF0YSxcbiAgQ2xpRmxhZ3Ncbn0gZnJvbSAnb2JzaWRpYW4nO1xuaW1wb3J0IHR5cGUgeyBQcm9taXNhYmxlIH0gZnJvbSAndHlwZS1mZXN0JztcblxuaW1wb3J0IHsgbm9ybWFsaXplUHJvbWlzYWJsZSB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9hc3luYyc7XG5pbXBvcnQgeyBQbHVnaW4gfSBmcm9tICdvYnNpZGlhbic7XG5cbi8qKlxuICogUmVnaXN0ZXJzIENMSSBoYW5kbGVycy5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBDbGlIYW5kbGVyUmVnaXN0cmFyIHtcbiAgLyoqXG4gICAqIFJlZ2lzdGVycyBhIENMSSBoYW5kbGVyLlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBhcmFtZXRlcnMgZm9yIHRoZSBDTEkgaGFuZGxlciByZWdpc3RyYXRpb24uXG4gICAqL1xuICByZWdpc3RlckNsaUhhbmRsZXI6IChwYXJhbXM6IENsaUhhbmRsZXJSZWdpc3RyYXJSZWdpc3RlckNsaUhhbmRsZXJQYXJhbXMpID0+IHZvaWQ7XG59XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3IgcmVnaXN0ZXJpbmcgYSBDTEkgaGFuZGxlci5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBDbGlIYW5kbGVyUmVnaXN0cmFyUmVnaXN0ZXJDbGlIYW5kbGVyUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBjb21tYW5kIHRvIHJlZ2lzdGVyIHRoZSBoYW5kbGVyIGZvci5cbiAgICovXG4gIHJlYWRvbmx5IGNvbW1hbmQ6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIGRlc2NyaXB0aW9uIG9mIHRoZSBjb21tYW5kLlxuICAgKi9cbiAgcmVhZG9ubHkgZGVzY3JpcHRpb246IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIGZsYWdzIGZvciB0aGUgY29tbWFuZC5cbiAgICovXG4gIHJlYWRvbmx5IGZsYWdzOiBDbGlGbGFncyB8IG51bGw7XG5cbiAgLyoqXG4gICAqIFRoZSBoYW5kbGVyIHRvIHJlZ2lzdGVyLlxuICAgKlxuICAgKiBAcGFyYW0gY2xpRGF0YSAtIFRoZSBkYXRhIHBhc3NlZCB0byB0aGUgaGFuZGxlci5cbiAgICogQHJldHVybnMgVGhlIHJlc3VsdCBvZiB0aGUgaGFuZGxlci5cbiAgICovXG4gIHJlYWRvbmx5IGhhbmRsZXI6IChjbGlEYXRhOiBDbGlEYXRhKSA9PiBQcm9taXNhYmxlPHN0cmluZz47XG59XG5cbnR5cGUgUGx1Z2luQ2xpSGFuZGxlclJlZ2lzdHJhclJlZ2lzdGVyQ2xpSGFuZGxlclBhcmFtcyA9IENsaUhhbmRsZXJSZWdpc3RyYXJSZWdpc3RlckNsaUhhbmRsZXJQYXJhbXM7XG5cbi8qKlxuICogQ0xJIGhhbmRsZXIgcmVnaXN0cmFyIGluIGFuIE9ic2lkaWFuIHBsdWdpbi5cbiAqL1xuZXhwb3J0IGNsYXNzIFBsdWdpbkNsaUhhbmRsZXJSZWdpc3RyYXIgaW1wbGVtZW50cyBDbGlIYW5kbGVyUmVnaXN0cmFyIHtcbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgaW5zdGFuY2Ugb2YgdGhlIHtAbGluayBQbHVnaW5DbGlIYW5kbGVyUmVnaXN0cmFyfSBjbGFzcy5cbiAgICpcbiAgICogQHBhcmFtIHBsdWdpbiAtIFRoZSBPYnNpZGlhbiBwbHVnaW4gaW5zdGFuY2UuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocHJvdGVjdGVkIHJlYWRvbmx5IHBsdWdpbjogUGx1Z2luKSB7fVxuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYSBDTEkgaGFuZGxlci5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIGZvciB0aGUgQ0xJIGhhbmRsZXIgcmVnaXN0cmF0aW9uLlxuICAgKi9cbiAgcHVibGljIHJlZ2lzdGVyQ2xpSGFuZGxlcihwYXJhbXM6IFBsdWdpbkNsaUhhbmRsZXJSZWdpc3RyYXJSZWdpc3RlckNsaUhhbmRsZXJQYXJhbXMpOiB2b2lkIHtcbiAgICB0aGlzLnBsdWdpbi5yZWdpc3RlckNsaUhhbmRsZXIocGFyYW1zLmNvbW1hbmQsIHBhcmFtcy5kZXNjcmlwdGlvbiwgcGFyYW1zLmZsYWdzLCAoY2xpRGF0YSkgPT4gbm9ybWFsaXplUHJvbWlzYWJsZShwYXJhbXMuaGFuZGxlcihjbGlEYXRhKSkpO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBWUEsU0FBUywyQkFBMkI7QUFDcEMsU0FBUyxjQUFjO0FBK0NoQixNQUFNLDBCQUF5RDtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU03RCxZQUErQixRQUFnQjtBQUFoQjtBQUFBLEVBQWlCO0FBQUEsRUFBakI7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFPL0IsbUJBQW1CLFFBQWlFO0FBQ3pGLFNBQUssT0FBTyxtQkFBbUIsT0FBTyxTQUFTLE9BQU8sYUFBYSxPQUFPLE9BQU8sQ0FBQyxZQUFZLG9CQUFvQixPQUFPLFFBQVEsT0FBTyxDQUFDLENBQUM7QUFBQSxFQUM1STtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

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

@@ -0,0 +1,75 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Utility for editing a handful of named text fields in a popover anchored at a point.
+ *
+ * This is to {@link showPopover} what `modals/prompt.ts` is to `modals/modal.ts`: the common case
+ * spelled declaratively, so a caller that only needs a few text fields never writes any DOM wiring.
+ * Anything richer — a dropdown, a toggle, rendered markdown — goes through {@link showPopover}
+ * directly.
+ */
+import type { PopoverAnchor } from './popover-anchor.mjs';
+/**
+ * Parameters for {@link editFieldsInPopover}.
+ *
+ * @typeParam Key - The union of the field keys, inferred from {@link EditFieldsInPopoverParams.fields}.
+ */
+export interface EditFieldsInPopoverParams<Key extends string> {
+    /**
+     * Where to place the popover.
+     */
+    readonly anchor: PopoverAnchor;
+    /**
+     * A text for the "Cancel" button.
+     */
+    readonly cancelButtonText?: string;
+    /**
+     * Additional CSS classes to apply to the popover.
+     */
+    readonly cssClasses?: string[];
+    /**
+     * The fields to edit, rendered top to bottom in the given order.
+     */
+    readonly fields: readonly PopoverField<Key>[];
+    /**
+     * A text for the "OK" button.
+     */
+    readonly okButtonText?: string;
+}
+/**
+ * A single text field of a {@link editFieldsInPopover} popover.
+ *
+ * @typeParam Key - The key the field's value is returned under.
+ */
+export interface PopoverField<Key extends string> {
+    /**
+     * A value to pre-fill the field with.
+     *
+     * @default `''`
+     */
+    readonly defaultValue?: string;
+    /**
+     * The key the field's value is returned under.
+     */
+    readonly key: Key;
+    /**
+     * The label shown next to the field.
+     */
+    readonly name: string;
+    /**
+     * A placeholder text for the field.
+     *
+     * @default `''`
+     */
+    readonly placeholder?: string;
+}
+/**
+ * Displays a popover with a text field per entry in `fields` and resolves with their values keyed by
+ * {@link PopoverField.key}, or `null` if it was dismissed without confirming.
+ *
+ * @typeParam Key - The union of the field keys, inferred from the `fields` array.
+ * @param params - The parameters for the popover.
+ * @returns A {@link Promise} that resolves with the edited values, or `null` if dismissed.
+ */
+export declare function editFieldsInPopover<Key extends string>(params: EditFieldsInPopoverParams<Key>): Promise<null | Record<Key, string>>;

package/dist/lib/esm/popovers/field-popover.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 { normalizeOptionalProperties } from "@mnaoumov/typescript-lib/object-utils";
+import {
+  Setting,
+  TextComponent
+} from "obsidian";
+import { CssClass } from "../css-class.mjs";
+import { showPopover } from "./popover.mjs";
+async function editFieldsInPopover(params) {
+  const {
+    anchor,
+    cancelButtonText,
+    cssClasses,
+    fields,
+    okButtonText
+  } = params;
+  return await showPopover(normalizeOptionalProperties({
+    anchor,
+    build({ contentEl }) {
+      const editors = fields.map((field) => ({
+        key: field.key,
+        textComponent: addField(contentEl, field)
+      }));
+      return () => {
+        const values = {};
+        for (const editor of editors) {
+          values[editor.key] = editor.textComponent.getValue();
+        }
+        return values;
+      };
+    },
+    cancelButtonText,
+    cssClasses,
+    okButtonText
+  }));
+}
+function addField(containerEl, field) {
+  const setting = new Setting(containerEl).setName(field.name);
+  const textComponent = new TextComponent(setting.controlEl);
+  textComponent.setValue(field.defaultValue ?? "");
+  textComponent.setPlaceholder(field.placeholder ?? "");
+  textComponent.inputEl.addClass(CssClass.TextBox);
+  return textComponent;
+}
+export {
+  editFieldsInPopover
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3BvcG92ZXJzL2ZpZWxkLXBvcG92ZXIudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBVdGlsaXR5IGZvciBlZGl0aW5nIGEgaGFuZGZ1bCBvZiBuYW1lZCB0ZXh0IGZpZWxkcyBpbiBhIHBvcG92ZXIgYW5jaG9yZWQgYXQgYSBwb2ludC5cbiAqXG4gKiBUaGlzIGlzIHRvIHtAbGluayBzaG93UG9wb3Zlcn0gd2hhdCBgbW9kYWxzL3Byb21wdC50c2AgaXMgdG8gYG1vZGFscy9tb2RhbC50c2A6IHRoZSBjb21tb24gY2FzZVxuICogc3BlbGxlZCBkZWNsYXJhdGl2ZWx5LCBzbyBhIGNhbGxlciB0aGF0IG9ubHkgbmVlZHMgYSBmZXcgdGV4dCBmaWVsZHMgbmV2ZXIgd3JpdGVzIGFueSBET00gd2lyaW5nLlxuICogQW55dGhpbmcgcmljaGVyIFx1MjAxNCBhIGRyb3Bkb3duLCBhIHRvZ2dsZSwgcmVuZGVyZWQgbWFya2Rvd24gXHUyMDE0IGdvZXMgdGhyb3VnaCB7QGxpbmsgc2hvd1BvcG92ZXJ9XG4gKiBkaXJlY3RseS5cbiAqL1xuXG5pbXBvcnQgeyBub3JtYWxpemVPcHRpb25hbFByb3BlcnRpZXMgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvb2JqZWN0LXV0aWxzJztcbmltcG9ydCB7XG4gIFNldHRpbmcsXG4gIFRleHRDb21wb25lbnRcbn0gZnJvbSAnb2JzaWRpYW4nO1xuXG5pbXBvcnQgdHlwZSB7IFBvcG92ZXJBbmNob3IgfSBmcm9tICcuL3BvcG92ZXItYW5jaG9yLnRzJztcbmltcG9ydCB0eXBlIHsgU2hvd1BvcG92ZXJQYXJhbXMgfSBmcm9tICcuL3BvcG92ZXIudHMnO1xuXG5pbXBvcnQgeyBDc3NDbGFzcyB9IGZyb20gJy4uL2Nzcy1jbGFzcy50cyc7XG5pbXBvcnQgeyBzaG93UG9wb3ZlciB9IGZyb20gJy4vcG9wb3Zlci50cyc7XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIGVkaXRGaWVsZHNJblBvcG92ZXJ9LlxuICpcbiAqIEB0eXBlUGFyYW0gS2V5IC0gVGhlIHVuaW9uIG9mIHRoZSBmaWVsZCBrZXlzLCBpbmZlcnJlZCBmcm9tIHtAbGluayBFZGl0RmllbGRzSW5Qb3BvdmVyUGFyYW1zLmZpZWxkc30uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRWRpdEZpZWxkc0luUG9wb3ZlclBhcmFtczxLZXkgZXh0ZW5kcyBzdHJpbmc+IHtcbiAgLyoqXG4gICAqIFdoZXJlIHRvIHBsYWNlIHRoZSBwb3BvdmVyLlxuICAgKi9cbiAgcmVhZG9ubHkgYW5jaG9yOiBQb3BvdmVyQW5jaG9yO1xuXG4gIC8qKlxuICAgKiBBIHRleHQgZm9yIHRoZSBcIkNhbmNlbFwiIGJ1dHRvbi5cbiAgICovXG4gIHJlYWRvbmx5IGNhbmNlbEJ1dHRvblRleHQ/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEFkZGl0aW9uYWwgQ1NTIGNsYXNzZXMgdG8gYXBwbHkgdG8gdGhlIHBvcG92ZXIuXG4gICAqL1xuICByZWFkb25seSBjc3NDbGFzc2VzPzogc3RyaW5nW107XG5cbiAgLyoqXG4gICAqIFRoZSBmaWVsZHMgdG8gZWRpdCwgcmVuZGVyZWQgdG9wIHRvIGJvdHRvbSBpbiB0aGUgZ2l2ZW4gb3JkZXIuXG4gICAqL1xuICByZWFkb25seSBmaWVsZHM6IHJlYWRvbmx5IFBvcG92ZXJGaWVsZDxLZXk+W107XG5cbiAgLyoqXG4gICAqIEEgdGV4dCBmb3IgdGhlIFwiT0tcIiBidXR0b24uXG4gICAqL1xuICByZWFkb25seSBva0J1dHRvblRleHQ/OiBzdHJpbmc7XG59XG5cbi8qKlxuICogQSBzaW5nbGUgdGV4dCBmaWVsZCBvZiBhIHtAbGluayBlZGl0RmllbGRzSW5Qb3BvdmVyfSBwb3BvdmVyLlxuICpcbiAqIEB0eXBlUGFyYW0gS2V5IC0gVGhlIGtleSB0aGUgZmllbGQncyB2YWx1ZSBpcyByZXR1cm5lZCB1bmRlci5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBQb3BvdmVyRmllbGQ8S2V5IGV4dGVuZHMgc3RyaW5nPiB7XG4gIC8qKlxuICAgKiBBIHZhbHVlIHRvIHByZS1maWxsIHRoZSBmaWVsZCB3aXRoLlxuICAgKlxuICAgKiBAZGVmYXVsdCBgJydgXG4gICAqL1xuICByZWFkb25seSBkZWZhdWx0VmFsdWU/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBrZXkgdGhlIGZpZWxkJ3MgdmFsdWUgaXMgcmV0dXJuZWQgdW5kZXIuXG4gICAqL1xuICByZWFkb25seSBrZXk6IEtleTtcblxuICAvKipcbiAgICogVGhlIGxhYmVsIHNob3duIG5leHQgdG8gdGhlIGZpZWxkLlxuICAgKi9cbiAgcmVhZG9ubHkgbmFtZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBBIHBsYWNlaG9sZGVyIHRleHQgZm9yIHRoZSBmaWVsZC5cbiAgICpcbiAgICogQGRlZmF1bHQgYCcnYFxuICAgKi9cbiAgcmVhZG9ubHkgcGxhY2Vob2xkZXI/OiBzdHJpbmc7XG59XG5cbi8qKlxuICogRGlzcGxheXMgYSBwb3BvdmVyIHdpdGggYSB0ZXh0IGZpZWxkIHBlciBlbnRyeSBpbiBgZmllbGRzYCBhbmQgcmVzb2x2ZXMgd2l0aCB0aGVpciB2YWx1ZXMga2V5ZWQgYnlcbiAqIHtAbGluayBQb3BvdmVyRmllbGQua2V5fSwgb3IgYG51bGxgIGlmIGl0IHdhcyBkaXNtaXNzZWQgd2l0aG91dCBjb25maXJtaW5nLlxuICpcbiAqIEB0eXBlUGFyYW0gS2V5IC0gVGhlIHVuaW9uIG9mIHRoZSBmaWVsZCBrZXlzLCBpbmZlcnJlZCBmcm9tIHRoZSBgZmllbGRzYCBhcnJheS5cbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycyBmb3IgdGhlIHBvcG92ZXIuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdpdGggdGhlIGVkaXRlZCB2YWx1ZXMsIG9yIGBudWxsYCBpZiBkaXNtaXNzZWQuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBlZGl0RmllbGRzSW5Qb3BvdmVyPEtleSBleHRlbmRzIHN0cmluZz4ocGFyYW1zOiBFZGl0RmllbGRzSW5Qb3BvdmVyUGFyYW1zPEtleT4pOiBQcm9taXNlPG51bGwgfCBSZWNvcmQ8S2V5LCBzdHJpbmc+PiB7XG4gIGNvbnN0IHtcbiAgICBhbmNob3IsXG4gICAgY2FuY2VsQnV0dG9uVGV4dCxcbiAgICBjc3NDbGFzc2VzLFxuICAgIGZpZWxkcyxcbiAgICBva0J1dHRvblRleHRcbiAgfSA9IHBhcmFtcztcblxuICByZXR1cm4gYXdhaXQgc2hvd1BvcG92ZXI8UmVjb3JkPEtleSwgc3RyaW5nPj4obm9ybWFsaXplT3B0aW9uYWxQcm9wZXJ0aWVzPFNob3dQb3BvdmVyUGFyYW1zPFJlY29yZDxLZXksIHN0cmluZz4+Pih7XG4gICAgYW5jaG9yLFxuICAgIGJ1aWxkKHsgY29udGVudEVsIH0pIHtcbiAgICAgIGNvbnN0IGVkaXRvcnMgPSBmaWVsZHMubWFwKChmaWVsZCkgPT4gKHtcbiAgICAgICAga2V5OiBmaWVsZC5rZXksXG4gICAgICAgIHRleHRDb21wb25lbnQ6IGFkZEZpZWxkKGNvbnRlbnRFbCwgZmllbGQpXG4gICAgICB9KSk7XG5cbiAgICAgIHJldHVybiAoKSA9PiB7XG4gICAgICAgIC8vIFRoZSByZWNvcmQgaXMgYWNjdW11bGF0ZWQga2V5IGJ5IGtleSwgc28gaXQgaXMgb25seSBjb21wbGV0ZSBcdTIwMTQgYW5kIG9ubHkgdHlwZWQgYXMgc3VjaCBcdTIwMTQgb25jZSBldmVyeSBmaWVsZCBoYXMgYmVlbiByZWFkLlxuICAgICAgICBjb25zdCB2YWx1ZXM6IFJlY29yZDxzdHJpbmcsIHN0cmluZz4gPSB7fTtcbiAgICAgICAgZm9yIChjb25zdCBlZGl0b3Igb2YgZWRpdG9ycykge1xuICAgICAgICAgIHZhbHVlc1tlZGl0b3Iua2V5XSA9IGVkaXRvci50ZXh0Q29tcG9uZW50LmdldFZhbHVlKCk7XG4gICAgICAgIH1cblxuICAgICAgICByZXR1cm4gdmFsdWVzO1xuICAgICAgfTtcbiAgICB9LFxuICAgIGNhbmNlbEJ1dHRvblRleHQsXG4gICAgY3NzQ2xhc3NlcyxcbiAgICBva0J1dHRvblRleHRcbiAgfSkpO1xufVxuXG4vKipcbiAqIEFkZHMgYSBzaW5nbGUgbGFiZWxsZWQgdGV4dCBmaWVsZCB0byB0aGUgcG9wb3Zlci5cbiAqXG4gKiBAdHlwZVBhcmFtIEtleSAtIFRoZSBrZXkgdGhlIGZpZWxkJ3MgdmFsdWUgaXMgcmV0dXJuZWQgdW5kZXIuXG4gKiBAcGFyYW0gY29udGFpbmVyRWwgLSBUaGUgZWxlbWVudCB0byBhZGQgdGhlIGZpZWxkIHRvLlxuICogQHBhcmFtIGZpZWxkIC0gVGhlIGZpZWxkIHRvIGFkZC5cbiAqIEByZXR1cm5zIFRoZSBmaWVsZCdzIHRleHQgY29tcG9uZW50LlxuICovXG5mdW5jdGlvbiBhZGRGaWVsZDxLZXkgZXh0ZW5kcyBzdHJpbmc+KGNvbnRhaW5lckVsOiBIVE1MRWxlbWVudCwgZmllbGQ6IFBvcG92ZXJGaWVsZDxLZXk+KTogVGV4dENvbXBvbmVudCB7XG4gIGNvbnN0IHNldHRpbmcgPSBuZXcgU2V0dGluZyhjb250YWluZXJFbCkuc2V0TmFtZShmaWVsZC5uYW1lKTtcbiAgY29uc3QgdGV4dENvbXBvbmVudCA9IG5ldyBUZXh0Q29tcG9uZW50KHNldHRpbmcuY29udHJvbEVsKTtcbiAgdGV4dENvbXBvbmVudC5zZXRWYWx1ZShmaWVsZC5kZWZhdWx0VmFsdWUgPz8gJycpO1xuICB0ZXh0Q29tcG9uZW50LnNldFBsYWNlaG9sZGVyKGZpZWxkLnBsYWNlaG9sZGVyID8/ICcnKTtcbiAgdGV4dENvbXBvbmVudC5pbnB1dEVsLmFkZENsYXNzKENzc0NsYXNzLlRleHRCb3gpO1xuICByZXR1cm4gdGV4dENvbXBvbmVudDtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFXQSxTQUFTLG1DQUFtQztBQUM1QztBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsT0FDSztBQUtQLFNBQVMsZ0JBQWdCO0FBQ3pCLFNBQVMsbUJBQW1CO0FBeUU1QixlQUFzQixvQkFBd0MsUUFBNkU7QUFDekksUUFBTTtBQUFBLElBQ0o7QUFBQSxJQUNBO0FBQUEsSUFDQTtBQUFBLElBQ0E7QUFBQSxJQUNBO0FBQUEsRUFDRixJQUFJO0FBRUosU0FBTyxNQUFNLFlBQWlDLDRCQUFvRTtBQUFBLElBQ2hIO0FBQUEsSUFDQSxNQUFNLEVBQUUsVUFBVSxHQUFHO0FBQ25CLFlBQU0sVUFBVSxPQUFPLElBQUksQ0FBQyxXQUFXO0FBQUEsUUFDckMsS0FBSyxNQUFNO0FBQUEsUUFDWCxlQUFlLFNBQVMsV0FBVyxLQUFLO0FBQUEsTUFDMUMsRUFBRTtBQUVGLGFBQU8sTUFBTTtBQUVYLGNBQU0sU0FBaUMsQ0FBQztBQUN4QyxtQkFBVyxVQUFVLFNBQVM7QUFDNUIsaUJBQU8sT0FBTyxHQUFHLElBQUksT0FBTyxjQUFjLFNBQVM7QUFBQSxRQUNyRDtBQUVBLGVBQU87QUFBQSxNQUNUO0FBQUEsSUFDRjtBQUFBLElBQ0E7QUFBQSxJQUNBO0FBQUEsSUFDQTtBQUFBLEVBQ0YsQ0FBQyxDQUFDO0FBQ0o7QUFVQSxTQUFTLFNBQTZCLGFBQTBCLE9BQXlDO0FBQ3ZHLFFBQU0sVUFBVSxJQUFJLFFBQVEsV0FBVyxFQUFFLFFBQVEsTUFBTSxJQUFJO0FBQzNELFFBQU0sZ0JBQWdCLElBQUksY0FBYyxRQUFRLFNBQVM7QUFDekQsZ0JBQWMsU0FBUyxNQUFNLGdCQUFnQixFQUFFO0FBQy9DLGdCQUFjLGVBQWUsTUFBTSxlQUFlLEVBQUU7QUFDcEQsZ0JBQWMsUUFBUSxTQUFTLFNBQVMsT0FBTztBQUMvQyxTQUFPO0FBQ1Q7IiwKICAibmFtZXMiOiBbXQp9Cg==

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

@@ -0,0 +1,4 @@
+/// <reference path="../library.d.mts" />
+export * as 'field-popover' from './field-popover.mjs';
+export * as 'popover-anchor' from './popover-anchor.mjs';
+export * as 'popover' from './popover.mjs';

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

@@ -0,0 +1,58 @@
+/*
+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 * as field_popover from "./field-popover.mjs";
+import * as popover_anchor from "./popover-anchor.mjs";
+import * as popover from "./popover.mjs";
+export {
+  field_popover as "field-popover",
+  popover,
+  popover_anchor as "popover-anchor"
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL3BvcG92ZXJzL2luZGV4LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKiBUSElTIElTIEEgR0VORVJBVEVEL0JVTkRMRUQgRklMRSBCWSBCVUlMRCBTQ1JJUFQgKi9cblxuZXhwb3J0ICogYXMgJ2ZpZWxkLXBvcG92ZXInIGZyb20gJy4vZmllbGQtcG9wb3Zlci50cyc7XG5leHBvcnQgKiBhcyAncG9wb3Zlci1hbmNob3InIGZyb20gJy4vcG9wb3Zlci1hbmNob3IudHMnO1xuZXhwb3J0ICogYXMgJ3BvcG92ZXInIGZyb20gJy4vcG9wb3Zlci50cyc7XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBRUEsWUFBWUEsbUJBQXFCO0FBQ2pDLFlBQVlDLG9CQUFzQjtBQUNsQyxZQUFZLGFBQWU7IiwKICAibmFtZXMiOiBbImZpZWxkLXBvcG92ZXIiLCAicG9wb3Zlci1hbmNob3IiXQp9Cg==

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

@@ -0,0 +1,67 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * The resolved position a popover is placed at.
+ *
+ * A popover takes a resolved anchor rather than an element because callers know the position in
+ * different ways: a clicked element has a rect, a context menu has the pointer that opened it, and a
+ * keyboard-invoked command has the caret. Each way gets its own builder here, so the popover itself
+ * stays unaware of how the position was found.
+ *
+ * This lives apart from the popover shell so that anything producing an anchor — most notably
+ * `PointerPositionComponent` — depends only on the position, not on the panel that consumes it.
+ */
+/**
+ * Where a popover is placed: viewport coordinates plus the document they belong to.
+ *
+ * Carrying the document explicitly is what makes an anchor inside a pop-out window work — the popover
+ * is appended to, and clamped against, that window rather than the main one.
+ */
+export interface PopoverAnchor {
+    /**
+     * The viewport `y` coordinate the popover is placed below.
+     */
+    readonly bottom: number;
+    /**
+     * The document the coordinates belong to.
+     */
+    readonly doc: Document;
+    /**
+     * The viewport `x` coordinate the popover is aligned to.
+     */
+    readonly left: number;
+}
+/**
+ * Anchors a popover in the middle of the document, for the cases where nothing better is known.
+ *
+ * @param doc - The document to anchor in.
+ * @returns The anchor.
+ */
+export declare function createAnchorFromDocumentCenter(doc: Document): PopoverAnchor;
+/**
+ * Anchors a popover just below an element — used for a clicked element, whose rect is exactly where
+ * the user is looking.
+ *
+ * @param element - The element to anchor at.
+ * @returns The anchor.
+ */
+export declare function createAnchorFromElement(element: HTMLElement): PopoverAnchor;
+/**
+ * Anchors a popover at a pointer position — used for a context menu, which is raised by a right-click
+ * or a long-press whose coordinates are where the user is looking.
+ *
+ * @param x - The viewport `x` coordinate.
+ * @param y - The viewport `y` coordinate.
+ * @param doc - The document the coordinates belong to.
+ * @returns The anchor.
+ */
+export declare function createAnchorFromPoint(x: number, y: number, doc: Document): PopoverAnchor;
+/**
+ * Anchors a popover at the caret — used by a command invoked from the keyboard, with the cursor
+ * already at the place being edited.
+ *
+ * @param doc - The document holding the selection.
+ * @returns The anchor, or a centered one when there is no caret to read.
+ */
+export declare function createAnchorFromSelection(doc: Document): PopoverAnchor;