@mnaoumov/obsidian-lib 0.0.0 → 1.0.1

package/dist/lib/esm/components/plugin-settings-tab-component.d.mts

@@ -0,0 +1,39 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Component that registers a plugin settings tab with Obsidian.
+ * Also registers an "Open Settings" command automatically.
+ */
+import type { Plugin } from 'obsidian';
+import { PluginSettingTab } from 'obsidian';
+import { ComponentEx } from './component-ex.mjs';
+interface PluginSettingsTabComponentConstructorParams {
+    readonly plugin: Plugin;
+    readonly pluginSettingsTab: PluginSettingTab;
+}
+/**
+ * Wraps a {@link PluginSettingTab} and registers it with Obsidian on load.
+ * Also registers an "Open Settings" command to open the settings tab from the command palette.
+ */
+export declare class PluginSettingsTabComponent extends ComponentEx {
+    /**
+     * The plugin the settings tab is registered with.
+     */
+    protected readonly plugin: Plugin;
+    /**
+     * The plugin settings tab wrapped and registered with Obsidian on load.
+     */
+    protected readonly pluginSettingsTab: PluginSettingTab;
+    /**
+     * Creates a new plugin settings tab component.
+     *
+     * @param params - The plugin settings tab component constructor parameters.
+     */
+    constructor(params: PluginSettingsTabComponentConstructorParams);
+    /**
+     * Registers the settings tab and an "Open Settings" command with Obsidian.
+     */
+    onload(): void;
+}
+export {};

package/dist/lib/esm/components/plugin-settings-tab-component.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();
+})();
+})();
+
+import { PluginSettingTab } from "obsidian";
+import { ComponentEx } from "./component-ex.mjs";
+class PluginSettingsTabComponent extends ComponentEx {
+  /**
+   * The plugin the settings tab is registered with.
+   */
+  plugin;
+  /**
+   * The plugin settings tab wrapped and registered with Obsidian on load.
+   */
+  pluginSettingsTab;
+  /**
+   * Creates a new plugin settings tab component.
+   *
+   * @param params - The plugin settings tab component constructor parameters.
+   */
+  constructor(params) {
+    super();
+    this.plugin = params.plugin;
+    this.pluginSettingsTab = params.pluginSettingsTab;
+  }
+  /**
+   * Registers the settings tab and an "Open Settings" command with Obsidian.
+   */
+  onload() {
+    this.plugin.addSettingTab(this.pluginSettingsTab);
+  }
+}
+export {
+  PluginSettingsTabComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvcGx1Z2luLXNldHRpbmdzLXRhYi1jb21wb25lbnQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBDb21wb25lbnQgdGhhdCByZWdpc3RlcnMgYSBwbHVnaW4gc2V0dGluZ3MgdGFiIHdpdGggT2JzaWRpYW4uXG4gKiBBbHNvIHJlZ2lzdGVycyBhbiBcIk9wZW4gU2V0dGluZ3NcIiBjb21tYW5kIGF1dG9tYXRpY2FsbHkuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBQbHVnaW4gfSBmcm9tICdvYnNpZGlhbic7XG5cbmltcG9ydCB7IFBsdWdpblNldHRpbmdUYWIgfSBmcm9tICdvYnNpZGlhbic7XG5cbmltcG9ydCB7IENvbXBvbmVudEV4IH0gZnJvbSAnLi9jb21wb25lbnQtZXgudHMnO1xuXG5pbnRlcmZhY2UgUGx1Z2luU2V0dGluZ3NUYWJDb21wb25lbnRDb25zdHJ1Y3RvclBhcmFtcyB7XG4gIHJlYWRvbmx5IHBsdWdpbjogUGx1Z2luO1xuICByZWFkb25seSBwbHVnaW5TZXR0aW5nc1RhYjogUGx1Z2luU2V0dGluZ1RhYjtcbn1cblxuLyoqXG4gKiBXcmFwcyBhIHtAbGluayBQbHVnaW5TZXR0aW5nVGFifSBhbmQgcmVnaXN0ZXJzIGl0IHdpdGggT2JzaWRpYW4gb24gbG9hZC5cbiAqIEFsc28gcmVnaXN0ZXJzIGFuIFwiT3BlbiBTZXR0aW5nc1wiIGNvbW1hbmQgdG8gb3BlbiB0aGUgc2V0dGluZ3MgdGFiIGZyb20gdGhlIGNvbW1hbmQgcGFsZXR0ZS5cbiAqL1xuZXhwb3J0IGNsYXNzIFBsdWdpblNldHRpbmdzVGFiQ29tcG9uZW50IGV4dGVuZHMgQ29tcG9uZW50RXgge1xuICAvKipcbiAgICogVGhlIHBsdWdpbiB0aGUgc2V0dGluZ3MgdGFiIGlzIHJlZ2lzdGVyZWQgd2l0aC5cbiAgICovXG4gIHByb3RlY3RlZCByZWFkb25seSBwbHVnaW46IFBsdWdpbjtcblxuICAvKipcbiAgICogVGhlIHBsdWdpbiBzZXR0aW5ncyB0YWIgd3JhcHBlZCBhbmQgcmVnaXN0ZXJlZCB3aXRoIE9ic2lkaWFuIG9uIGxvYWQuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgcGx1Z2luU2V0dGluZ3NUYWI6IFBsdWdpblNldHRpbmdUYWI7XG5cbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgcGx1Z2luIHNldHRpbmdzIHRhYiBjb21wb25lbnQuXG4gICAqXG4gICAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGx1Z2luIHNldHRpbmdzIHRhYiBjb21wb25lbnQgY29uc3RydWN0b3IgcGFyYW1ldGVycy5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3RvcihwYXJhbXM6IFBsdWdpblNldHRpbmdzVGFiQ29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXMpIHtcbiAgICBzdXBlcigpO1xuICAgIHRoaXMucGx1Z2luID0gcGFyYW1zLnBsdWdpbjtcbiAgICB0aGlzLnBsdWdpblNldHRpbmdzVGFiID0gcGFyYW1zLnBsdWdpblNldHRpbmdzVGFiO1xuICB9XG5cbiAgLyoqXG4gICAqIFJlZ2lzdGVycyB0aGUgc2V0dGluZ3MgdGFiIGFuZCBhbiBcIk9wZW4gU2V0dGluZ3NcIiBjb21tYW5kIHdpdGggT2JzaWRpYW4uXG4gICAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgb25sb2FkKCk6IHZvaWQge1xuICAgIHRoaXMucGx1Z2luLmFkZFNldHRpbmdUYWIodGhpcy5wbHVnaW5TZXR0aW5nc1RhYik7XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBU0EsU0FBUyx3QkFBd0I7QUFFakMsU0FBUyxtQkFBbUI7QUFXckIsTUFBTSxtQ0FBbUMsWUFBWTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBSXZDO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFLQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9aLFlBQVksUUFBcUQ7QUFDdEUsVUFBTTtBQUNOLFNBQUssU0FBUyxPQUFPO0FBQ3JCLFNBQUssb0JBQW9CLE9BQU87QUFBQSxFQUNsQztBQUFBO0FBQUE7QUFBQTtBQUFBLEVBS2dCLFNBQWU7QUFDN0IsU0FBSyxPQUFPLGNBQWMsS0FBSyxpQkFBaUI7QUFBQSxFQUNsRDtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/esm/components/plugin-suggestion-component.d.mts

@@ -0,0 +1,162 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Component that suggests installing another community plugin the host plugin needs in order to offer
+ * some of its behavior.
+ *
+ * A suggestion is not a dependency — but a dependency is now a thing this library HAS, so the choice
+ * between them is a real one. Use a suggestion when the other plugin ADDS something: the host keeps
+ * working without it, simply unable to offer whatever that plugin owns, and this component asks once
+ * whether the user would like it installed. Use `PluginGateComponent` when the host's advertised
+ * behavior is not there at all without the other plugin.
+ *
+ * This file used to argue the stronger position — that requiring another plugin should not exist, because
+ * "inventing one by refusing to load would punish the user for something they never agreed to". That was
+ * wrong about which option punishes the user, and the counter-case is worth keeping rather than quietly
+ * deleting. A load-bearing plugin the user cannot identify is not a neutral outcome: months later they
+ * meet it in their plugin list, nothing in Obsidian's manifest format says anything depends on it, they
+ * remove it, and the damage surfaces weeks after that with no way to connect the two. Beside that, a
+ * mandatory dependency that stays enabled-but-inert, names what it is waiting for, installs it in one
+ * click and resumes without a restart is not a punishment — it is the same information, delivered while
+ * the user can still act on it.
+ *
+ * The ask is surfaced twice, deliberately, because the two placements answer different questions:
+ * a notice on load ("you are missing something you probably want") and a settings-tab banner ("the
+ * settings you came looking for live in another plugin"). Declining silences only the notice — a user
+ * who opens the settings tab is asking about the feature right then, so the banner stays.
+ */
+import type { App } from 'obsidian';
+import type { Promisable } from 'type-fest';
+import type { PluginNoticeComponent } from './plugin-notice-component.mjs';
+import type { PluginSettingsComponentBase } from './plugin-settings-component.mjs';
+import { InstalledPluginState } from '../plugin/plugin-install-state.mjs';
+import { ComponentEx } from './component-ex.mjs';
+/**
+ * How the suggested plugin is currently present in the vault.
+ *
+ * The same three states a mandatory dependency is in, so this is {@link InstalledPluginState} under the
+ * name this component has always used — one enum, so a caller holding a state from either component can
+ * compare it against either name.
+ */
+export declare const SuggestedPluginState: typeof InstalledPluginState;
+/**
+ * Parameters for the {@link PluginSuggestionComponent} constructor.
+ */
+export interface PluginSuggestionComponentConstructorParams {
+    /**
+     * The Obsidian app instance.
+     */
+    readonly app: App;
+    /**
+     * Whether the user has already declined this suggestion.
+     *
+     * Storage belongs to the host plugin (typically one of its settings), because this component has no
+     * `data.json` of its own and a decline has to outlive a reload.
+     *
+     * Only ever called once {@link pluginSettingsComponent} reports its settings loaded, so an implementation
+     * reading a setting is guaranteed to read the stored value rather than its default.
+     *
+     * @returns `true` when the suggestion has been declined.
+     */
+    readonly isSuggestionDeclined: () => boolean;
+    /**
+     * The notice component of the plugin making the suggestion, used to show the suggestion and its
+     * outcome.
+     */
+    readonly pluginNoticeComponent: PluginNoticeComponent;
+    /**
+     * The settings component holding whatever {@link isSuggestionDeclined} reads.
+     *
+     * Taken as a whole component rather than as a bare "ready" flag so the host cannot forget to wire the
+     * wait: the notice is decided only after this component has read `data.json`. See
+     * {@link PluginSettingsComponentBase.whenLoadedFromFile} for why the read cannot simply happen at
+     * layout-ready.
+     */
+    readonly pluginSettingsComponent: PluginSettingsComponentBase<object>;
+    /**
+     * The localized sentence explaining what the host plugin cannot do without the suggested plugin. The
+     * host plugin owns this string: only it knows which of its features are affected.
+     */
+    readonly reason: string;
+    /**
+     * Records the user's answer to the suggestion.
+     *
+     * @param isDeclined - `true` when the user declined.
+     * @returns A {@link Promise} that resolves once the answer is persisted.
+     */
+    readonly setSuggestionDeclined: (isDeclined: boolean) => Promisable<void>;
+    /**
+     * The id of the suggested plugin, as listed in Obsidian's community plugin registry.
+     */
+    readonly suggestedPluginId: string;
+    /**
+     * The display name of the suggested plugin, shown to the user.
+     */
+    readonly suggestedPluginName: string;
+}
+/**
+ * How the suggested plugin is currently present in the vault.
+ */
+export type SuggestedPluginState = InstalledPluginState;
+/**
+ * Suggests installing another community plugin, via a load-time notice and a settings-tab banner.
+ */
+export declare class PluginSuggestionComponent extends ComponentEx {
+    private readonly app;
+    private readonly isSuggestionDeclined;
+    private readonly pluginNoticeComponent;
+    private readonly pluginSettingsComponent;
+    private readonly reason;
+    private readonly setSuggestionDeclined;
+    private readonly suggestedPluginId;
+    private readonly suggestedPluginName;
+    /**
+     * Creates an instance of {@link PluginSuggestionComponent}.
+     *
+     * @param params - The constructor parameters.
+     */
+    constructor(params: PluginSuggestionComponentConstructorParams);
+    /**
+     * Resolves how the suggested plugin is currently present in the vault.
+     *
+     * @returns The {@link SuggestedPluginState}.
+     */
+    getSuggestedPluginState(): SuggestedPluginState;
+    /**
+     * Installs (when needed) and enables the suggested plugin, reporting the outcome as a notice.
+     *
+     * @returns A {@link Promise} that resolves once the plugin is enabled, or once the failure has been
+     * reported.
+     */
+    installAndEnableSuggestedPlugin(): Promise<void>;
+    /**
+     * Loads the component, showing the suggestion notice once the layout is ready AND the host's settings
+     * have been read from disk.
+     *
+     * Both waits matter, and neither implies the other:
+     *
+     * - Layout-ready, because plugins load in an unspecified order, so the suggested plugin may well be
+     *   enabled a moment after this one. Checking earlier would suggest installing something the user
+     *   already has.
+     * - Settings-loaded, because {@link PluginSuggestionComponentConstructorParams.isSuggestionDeclined}
+     *   reads a setting of the host, and the host's settings component is a SIBLING whose own async load is
+     *   still in flight here. On a layout that is already ready — a runtime enable from the Community
+     *   Plugins tab, or a re-enable after an update — the layout-ready callback fires immediately, so the
+     *   read would see the default `false` and ask again a user who has already declined.
+     */
+    onload(): void;
+    /**
+     * Renders the suggestion banner into a settings-tab container, with a button that installs and enables
+     * the suggested plugin.
+     *
+     * Renders nothing when the suggested plugin is already enabled. Unlike the notice, the banner ignores a
+     * previous decline — the user is looking at these settings right now, which is a fresher signal than an
+     * answer they gave earlier.
+     *
+     * @param containerEl - The element to render the banner into.
+     */
+    renderBanner(containerEl: HTMLElement): void;
+    private getActionButtonText;
+    private showSuggestionNotice;
+}

package/dist/lib/esm/components/plugin-suggestion-component.mjs

@@ -0,0 +1,184 @@
+/*
+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 { convertAsyncToSync } from "@mnaoumov/typescript-lib/async";
+import { ButtonComponent } from "obsidian";
+import { CssClass } from "../css-class.mjs";
+import { t } from "../i18n/i18n.mjs";
+import {
+  getInstalledPluginState,
+  installAndEnablePlugin,
+  InstalledPluginState
+} from "../plugin/plugin-install-state.mjs";
+import { ComponentEx } from "./component-ex.mjs";
+import { CallbackLayoutReadyComponent } from "./layout-ready-component.mjs";
+const SuggestedPluginState = InstalledPluginState;
+class PluginSuggestionComponent extends ComponentEx {
+  app;
+  isSuggestionDeclined;
+  pluginNoticeComponent;
+  pluginSettingsComponent;
+  reason;
+  setSuggestionDeclined;
+  suggestedPluginId;
+  suggestedPluginName;
+  /**
+   * Creates an instance of {@link PluginSuggestionComponent}.
+   *
+   * @param params - The constructor parameters.
+   */
+  constructor(params) {
+    super();
+    this.app = params.app;
+    this.pluginNoticeComponent = params.pluginNoticeComponent;
+    this.pluginSettingsComponent = params.pluginSettingsComponent;
+    this.reason = params.reason;
+    this.suggestedPluginId = params.suggestedPluginId;
+    this.suggestedPluginName = params.suggestedPluginName;
+    this.isSuggestionDeclined = params.isSuggestionDeclined;
+    this.setSuggestionDeclined = params.setSuggestionDeclined;
+  }
+  /**
+   * Resolves how the suggested plugin is currently present in the vault.
+   *
+   * @returns The {@link SuggestedPluginState}.
+   */
+  getSuggestedPluginState() {
+    return getInstalledPluginState({
+      app: this.app,
+      pluginId: this.suggestedPluginId
+    });
+  }
+  /**
+   * Installs (when needed) and enables the suggested plugin, reporting the outcome as a notice.
+   *
+   * @returns A {@link Promise} that resolves once the plugin is enabled, or once the failure has been
+   * reported.
+   */
+  async installAndEnableSuggestedPlugin() {
+    if (this.getSuggestedPluginState() === SuggestedPluginState.Enabled) {
+      return;
+    }
+    await installAndEnablePlugin({
+      app: this.app,
+      pluginId: this.suggestedPluginId,
+      pluginName: this.suggestedPluginName,
+      pluginNoticeComponent: this.pluginNoticeComponent
+    });
+    await this.setSuggestionDeclined(false);
+  }
+  /**
+   * Loads the component, showing the suggestion notice once the layout is ready AND the host's settings
+   * have been read from disk.
+   *
+   * Both waits matter, and neither implies the other:
+   *
+   * - Layout-ready, because plugins load in an unspecified order, so the suggested plugin may well be
+   *   enabled a moment after this one. Checking earlier would suggest installing something the user
+   *   already has.
+   * - Settings-loaded, because {@link PluginSuggestionComponentConstructorParams.isSuggestionDeclined}
+   *   reads a setting of the host, and the host's settings component is a SIBLING whose own async load is
+   *   still in flight here. On a layout that is already ready — a runtime enable from the Community
+   *   Plugins tab, or a re-enable after an update — the layout-ready callback fires immediately, so the
+   *   read would see the default `false` and ask again a user who has already declined.
+   */
+  onload() {
+    this.addChild(
+      new CallbackLayoutReadyComponent(this.app, async () => {
+        await this.pluginSettingsComponent.whenLoadedFromFile();
+        if (this.isUnloaded()) {
+          return;
+        }
+        this.showSuggestionNotice();
+      })
+    );
+  }
+  /**
+   * Renders the suggestion banner into a settings-tab container, with a button that installs and enables
+   * the suggested plugin.
+   *
+   * Renders nothing when the suggested plugin is already enabled. Unlike the notice, the banner ignores a
+   * previous decline — the user is looking at these settings right now, which is a fresher signal than an
+   * answer they gave earlier.
+   *
+   * @param containerEl - The element to render the banner into.
+   */
+  renderBanner(containerEl) {
+    const state = this.getSuggestedPluginState();
+    if (state === SuggestedPluginState.Enabled) {
+      return;
+    }
+    const bannerEl = containerEl.createDiv({
+      cls: [CssClass.LibraryName, CssClass.PluginSuggestionBanner]
+    });
+    bannerEl.createDiv({ text: this.reason });
+    new ButtonComponent(bannerEl).setButtonText(this.getActionButtonText(state)).setCta().onClick(convertAsyncToSync(async () => {
+      await this.installAndEnableSuggestedPlugin();
+    }));
+  }
+  getActionButtonText(state) {
+    return t(
+      ($) => state === SuggestedPluginState.InstalledButDisabled ? $.obsidianDevUtils.pluginSuggestion.enable : $.obsidianDevUtils.pluginSuggestion.install
+    );
+  }
+  showSuggestionNotice() {
+    const state = this.getSuggestedPluginState();
+    if (state === SuggestedPluginState.Enabled || this.isSuggestionDeclined()) {
+      return;
+    }
+    const fragment = createFragment((fragmentEl) => {
+      fragmentEl.createDiv({ text: this.reason });
+      const buttonsEl = fragmentEl.createDiv();
+      new ButtonComponent(buttonsEl).setButtonText(this.getActionButtonText(state)).setCta().onClick(convertAsyncToSync(async () => {
+        await this.installAndEnableSuggestedPlugin();
+      }));
+      new ButtonComponent(buttonsEl).setButtonText(t(($) => $.obsidianDevUtils.pluginSuggestion.notNow)).onClick(convertAsyncToSync(async () => {
+        await this.setSuggestionDeclined(true);
+      }));
+    });
+    this.pluginNoticeComponent.showNotice(fragment, { shouldHideOnClick: false });
+  }
+}
+export {
+  PluginSuggestionComponent,
+  SuggestedPluginState
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvcGx1Z2luLXN1Z2dlc3Rpb24tY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29tcG9uZW50IHRoYXQgc3VnZ2VzdHMgaW5zdGFsbGluZyBhbm90aGVyIGNvbW11bml0eSBwbHVnaW4gdGhlIGhvc3QgcGx1Z2luIG5lZWRzIGluIG9yZGVyIHRvIG9mZmVyXG4gKiBzb21lIG9mIGl0cyBiZWhhdmlvci5cbiAqXG4gKiBBIHN1Z2dlc3Rpb24gaXMgbm90IGEgZGVwZW5kZW5jeSBcdTIwMTQgYnV0IGEgZGVwZW5kZW5jeSBpcyBub3cgYSB0aGluZyB0aGlzIGxpYnJhcnkgSEFTLCBzbyB0aGUgY2hvaWNlXG4gKiBiZXR3ZWVuIHRoZW0gaXMgYSByZWFsIG9uZS4gVXNlIGEgc3VnZ2VzdGlvbiB3aGVuIHRoZSBvdGhlciBwbHVnaW4gQUREUyBzb21ldGhpbmc6IHRoZSBob3N0IGtlZXBzXG4gKiB3b3JraW5nIHdpdGhvdXQgaXQsIHNpbXBseSB1bmFibGUgdG8gb2ZmZXIgd2hhdGV2ZXIgdGhhdCBwbHVnaW4gb3ducywgYW5kIHRoaXMgY29tcG9uZW50IGFza3Mgb25jZVxuICogd2hldGhlciB0aGUgdXNlciB3b3VsZCBsaWtlIGl0IGluc3RhbGxlZC4gVXNlIGBQbHVnaW5HYXRlQ29tcG9uZW50YCB3aGVuIHRoZSBob3N0J3MgYWR2ZXJ0aXNlZFxuICogYmVoYXZpb3IgaXMgbm90IHRoZXJlIGF0IGFsbCB3aXRob3V0IHRoZSBvdGhlciBwbHVnaW4uXG4gKlxuICogVGhpcyBmaWxlIHVzZWQgdG8gYXJndWUgdGhlIHN0cm9uZ2VyIHBvc2l0aW9uIFx1MjAxNCB0aGF0IHJlcXVpcmluZyBhbm90aGVyIHBsdWdpbiBzaG91bGQgbm90IGV4aXN0LCBiZWNhdXNlXG4gKiBcImludmVudGluZyBvbmUgYnkgcmVmdXNpbmcgdG8gbG9hZCB3b3VsZCBwdW5pc2ggdGhlIHVzZXIgZm9yIHNvbWV0aGluZyB0aGV5IG5ldmVyIGFncmVlZCB0b1wiLiBUaGF0IHdhc1xuICogd3JvbmcgYWJvdXQgd2hpY2ggb3B0aW9uIHB1bmlzaGVzIHRoZSB1c2VyLCBhbmQgdGhlIGNvdW50ZXItY2FzZSBpcyB3b3J0aCBrZWVwaW5nIHJhdGhlciB0aGFuIHF1aWV0bHlcbiAqIGRlbGV0aW5nLiBBIGxvYWQtYmVhcmluZyBwbHVnaW4gdGhlIHVzZXIgY2Fubm90IGlkZW50aWZ5IGlzIG5vdCBhIG5ldXRyYWwgb3V0Y29tZTogbW9udGhzIGxhdGVyIHRoZXlcbiAqIG1lZXQgaXQgaW4gdGhlaXIgcGx1Z2luIGxpc3QsIG5vdGhpbmcgaW4gT2JzaWRpYW4ncyBtYW5pZmVzdCBmb3JtYXQgc2F5cyBhbnl0aGluZyBkZXBlbmRzIG9uIGl0LCB0aGV5XG4gKiByZW1vdmUgaXQsIGFuZCB0aGUgZGFtYWdlIHN1cmZhY2VzIHdlZWtzIGFmdGVyIHRoYXQgd2l0aCBubyB3YXkgdG8gY29ubmVjdCB0aGUgdHdvLiBCZXNpZGUgdGhhdCwgYVxuICogbWFuZGF0b3J5IGRlcGVuZGVuY3kgdGhhdCBzdGF5cyBlbmFibGVkLWJ1dC1pbmVydCwgbmFtZXMgd2hhdCBpdCBpcyB3YWl0aW5nIGZvciwgaW5zdGFsbHMgaXQgaW4gb25lXG4gKiBjbGljayBhbmQgcmVzdW1lcyB3aXRob3V0IGEgcmVzdGFydCBpcyBub3QgYSBwdW5pc2htZW50IFx1MjAxNCBpdCBpcyB0aGUgc2FtZSBpbmZvcm1hdGlvbiwgZGVsaXZlcmVkIHdoaWxlXG4gKiB0aGUgdXNlciBjYW4gc3RpbGwgYWN0IG9uIGl0LlxuICpcbiAqIFRoZSBhc2sgaXMgc3VyZmFjZWQgdHdpY2UsIGRlbGliZXJhdGVseSwgYmVjYXVzZSB0aGUgdHdvIHBsYWNlbWVudHMgYW5zd2VyIGRpZmZlcmVudCBxdWVzdGlvbnM6XG4gKiBhIG5vdGljZSBvbiBsb2FkIChcInlvdSBhcmUgbWlzc2luZyBzb21ldGhpbmcgeW91IHByb2JhYmx5IHdhbnRcIikgYW5kIGEgc2V0dGluZ3MtdGFiIGJhbm5lciAoXCJ0aGVcbiAqIHNldHRpbmdzIHlvdSBjYW1lIGxvb2tpbmcgZm9yIGxpdmUgaW4gYW5vdGhlciBwbHVnaW5cIikuIERlY2xpbmluZyBzaWxlbmNlcyBvbmx5IHRoZSBub3RpY2UgXHUyMDE0IGEgdXNlclxuICogd2hvIG9wZW5zIHRoZSBzZXR0aW5ncyB0YWIgaXMgYXNraW5nIGFib3V0IHRoZSBmZWF0dXJlIHJpZ2h0IHRoZW4sIHNvIHRoZSBiYW5uZXIgc3RheXMuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBBcHAgfSBmcm9tICdvYnNpZGlhbic7XG5pbXBvcnQgdHlwZSB7IFByb21pc2FibGUgfSBmcm9tICd0eXBlLWZlc3QnO1xuXG5pbXBvcnQgeyBjb252ZXJ0QXN5bmNUb1N5bmMgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvYXN5bmMnO1xuaW1wb3J0IHsgQnV0dG9uQ29tcG9uZW50IH0gZnJvbSAnb2JzaWRpYW4nO1xuXG5pbXBvcnQgdHlwZSB7IFBsdWdpbk5vdGljZUNvbXBvbmVudCB9IGZyb20gJy4vcGx1Z2luLW5vdGljZS1jb21wb25lbnQudHMnO1xuaW1wb3J0IHR5cGUgeyBQbHVnaW5TZXR0aW5nc0NvbXBvbmVudEJhc2UgfSBmcm9tICcuL3BsdWdpbi1zZXR0aW5ncy1jb21wb25lbnQudHMnO1xuXG5pbXBvcnQgeyBDc3NDbGFzcyB9IGZyb20gJy4uL2Nzcy1jbGFzcy50cyc7XG5pbXBvcnQgeyB0IH0gZnJvbSAnLi4vaTE4bi9pMThuLnRzJztcbmltcG9ydCB7XG4gIGdldEluc3RhbGxlZFBsdWdpblN0YXRlLFxuICBpbnN0YWxsQW5kRW5hYmxlUGx1Z2luLFxuICBJbnN0YWxsZWRQbHVnaW5TdGF0ZVxufSBmcm9tICcuLi9wbHVnaW4vcGx1Z2luLWluc3RhbGwtc3RhdGUudHMnO1xuaW1wb3J0IHsgQ29tcG9uZW50RXggfSBmcm9tICcuL2NvbXBvbmVudC1leC50cyc7XG5pbXBvcnQgeyBDYWxsYmFja0xheW91dFJlYWR5Q29tcG9uZW50IH0gZnJvbSAnLi9sYXlvdXQtcmVhZHktY29tcG9uZW50LnRzJztcblxuLyoqXG4gKiBIb3cgdGhlIHN1Z2dlc3RlZCBwbHVnaW4gaXMgY3VycmVudGx5IHByZXNlbnQgaW4gdGhlIHZhdWx0LlxuICpcbiAqIFRoZSBzYW1lIHRocmVlIHN0YXRlcyBhIG1hbmRhdG9yeSBkZXBlbmRlbmN5IGlzIGluLCBzbyB0aGlzIGlzIHtAbGluayBJbnN0YWxsZWRQbHVnaW5TdGF0ZX0gdW5kZXIgdGhlXG4gKiBuYW1lIHRoaXMgY29tcG9uZW50IGhhcyBhbHdheXMgdXNlZCBcdTIwMTQgb25lIGVudW0sIHNvIGEgY2FsbGVyIGhvbGRpbmcgYSBzdGF0ZSBmcm9tIGVpdGhlciBjb21wb25lbnQgY2FuXG4gKiBjb21wYXJlIGl0IGFnYWluc3QgZWl0aGVyIG5hbWUuXG4gKi9cbmV4cG9ydCBjb25zdCBTdWdnZXN0ZWRQbHVnaW5TdGF0ZSA9IEluc3RhbGxlZFBsdWdpblN0YXRlO1xuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHRoZSB7QGxpbmsgUGx1Z2luU3VnZ2VzdGlvbkNvbXBvbmVudH0gY29uc3RydWN0b3IuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUGx1Z2luU3VnZ2VzdGlvbkNvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2UuXG4gICAqL1xuICByZWFkb25seSBhcHA6IEFwcDtcblxuICAvKipcbiAgICogV2hldGhlciB0aGUgdXNlciBoYXMgYWxyZWFkeSBkZWNsaW5lZCB0aGlzIHN1Z2dlc3Rpb24uXG4gICAqXG4gICAqIFN0b3JhZ2UgYmVsb25ncyB0byB0aGUgaG9zdCBwbHVnaW4gKHR5cGljYWxseSBvbmUgb2YgaXRzIHNldHRpbmdzKSwgYmVjYXVzZSB0aGlzIGNvbXBvbmVudCBoYXMgbm9cbiAgICogYGRhdGEuanNvbmAgb2YgaXRzIG93biBhbmQgYSBkZWNsaW5lIGhhcyB0byBvdXRsaXZlIGEgcmVsb2FkLlxuICAgKlxuICAgKiBPbmx5IGV2ZXIgY2FsbGVkIG9uY2Uge0BsaW5rIHBsdWdpblNldHRpbmdzQ29tcG9uZW50fSByZXBvcnRzIGl0cyBzZXR0aW5ncyBsb2FkZWQsIHNvIGFuIGltcGxlbWVudGF0aW9uXG4gICAqIHJlYWRpbmcgYSBzZXR0aW5nIGlzIGd1YXJhbnRlZWQgdG8gcmVhZCB0aGUgc3RvcmVkIHZhbHVlIHJhdGhlciB0aGFuIGl0cyBkZWZhdWx0LlxuICAgKlxuICAgKiBAcmV0dXJucyBgdHJ1ZWAgd2hlbiB0aGUgc3VnZ2VzdGlvbiBoYXMgYmVlbiBkZWNsaW5lZC5cbiAgICovXG4gIHJlYWRvbmx5IGlzU3VnZ2VzdGlvbkRlY2xpbmVkOiAoKSA9PiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBUaGUgbm90aWNlIGNvbXBvbmVudCBvZiB0aGUgcGx1Z2luIG1ha2luZyB0aGUgc3VnZ2VzdGlvbiwgdXNlZCB0byBzaG93IHRoZSBzdWdnZXN0aW9uIGFuZCBpdHNcbiAgICogb3V0Y29tZS5cbiAgICovXG4gIHJlYWRvbmx5IHBsdWdpbk5vdGljZUNvbXBvbmVudDogUGx1Z2luTm90aWNlQ29tcG9uZW50O1xuXG4gIC8qKlxuICAgKiBUaGUgc2V0dGluZ3MgY29tcG9uZW50IGhvbGRpbmcgd2hhdGV2ZXIge0BsaW5rIGlzU3VnZ2VzdGlvbkRlY2xpbmVkfSByZWFkcy5cbiAgICpcbiAgICogVGFrZW4gYXMgYSB3aG9sZSBjb21wb25lbnQgcmF0aGVyIHRoYW4gYXMgYSBiYXJlIFwicmVhZHlcIiBmbGFnIHNvIHRoZSBob3N0IGNhbm5vdCBmb3JnZXQgdG8gd2lyZSB0aGVcbiAgICogd2FpdDogdGhlIG5vdGljZSBpcyBkZWNpZGVkIG9ubHkgYWZ0ZXIgdGhpcyBjb21wb25lbnQgaGFzIHJlYWQgYGRhdGEuanNvbmAuIFNlZVxuICAgKiB7QGxpbmsgUGx1Z2luU2V0dGluZ3NDb21wb25lbnRCYXNlLndoZW5Mb2FkZWRGcm9tRmlsZX0gZm9yIHdoeSB0aGUgcmVhZCBjYW5ub3Qgc2ltcGx5IGhhcHBlbiBhdFxuICAgKiBsYXlvdXQtcmVhZHkuXG4gICAqL1xuICByZWFkb25seSBwbHVnaW5TZXR0aW5nc0NvbXBvbmVudDogUGx1Z2luU2V0dGluZ3NDb21wb25lbnRCYXNlPG9iamVjdD47XG5cbiAgLyoqXG4gICAqIFRoZSBsb2NhbGl6ZWQgc2VudGVuY2UgZXhwbGFpbmluZyB3aGF0IHRoZSBob3N0IHBsdWdpbiBjYW5ub3QgZG8gd2l0aG91dCB0aGUgc3VnZ2VzdGVkIHBsdWdpbi4gVGhlXG4gICAqIGhvc3QgcGx1Z2luIG93bnMgdGhpcyBzdHJpbmc6IG9ubHkgaXQga25vd3Mgd2hpY2ggb2YgaXRzIGZlYXR1cmVzIGFyZSBhZmZlY3RlZC5cbiAgICovXG4gIHJlYWRvbmx5IHJlYXNvbjogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBSZWNvcmRzIHRoZSB1c2VyJ3MgYW5zd2VyIHRvIHRoZSBzdWdnZXN0aW9uLlxuICAgKlxuICAgKiBAcGFyYW0gaXNEZWNsaW5lZCAtIGB0cnVlYCB3aGVuIHRoZSB1c2VyIGRlY2xpbmVkLlxuICAgKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIG9uY2UgdGhlIGFuc3dlciBpcyBwZXJzaXN0ZWQuXG4gICAqL1xuICByZWFkb25seSBzZXRTdWdnZXN0aW9uRGVjbGluZWQ6IChpc0RlY2xpbmVkOiBib29sZWFuKSA9PiBQcm9taXNhYmxlPHZvaWQ+O1xuXG4gIC8qKlxuICAgKiBUaGUgaWQgb2YgdGhlIHN1Z2dlc3RlZCBwbHVnaW4sIGFzIGxpc3RlZCBpbiBPYnNpZGlhbidzIGNvbW11bml0eSBwbHVnaW4gcmVnaXN0cnkuXG4gICAqL1xuICByZWFkb25seSBzdWdnZXN0ZWRQbHVnaW5JZDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgZGlzcGxheSBuYW1lIG9mIHRoZSBzdWdnZXN0ZWQgcGx1Z2luLCBzaG93biB0byB0aGUgdXNlci5cbiAgICovXG4gIHJlYWRvbmx5IHN1Z2dlc3RlZFBsdWdpbk5hbWU6IHN0cmluZztcbn1cblxuLyoqXG4gKiBIb3cgdGhlIHN1Z2dlc3RlZCBwbHVnaW4gaXMgY3VycmVudGx5IHByZXNlbnQgaW4gdGhlIHZhdWx0LlxuICovXG5leHBvcnQgdHlwZSBTdWdnZXN0ZWRQbHVnaW5TdGF0ZSA9IEluc3RhbGxlZFBsdWdpblN0YXRlO1xuXG4vKipcbiAqIFN1Z2dlc3RzIGluc3RhbGxpbmcgYW5vdGhlciBjb21tdW5pdHkgcGx1Z2luLCB2aWEgYSBsb2FkLXRpbWUgbm90aWNlIGFuZCBhIHNldHRpbmdzLXRhYiBiYW5uZXIuXG4gKi9cbmV4cG9ydCBjbGFzcyBQbHVnaW5TdWdnZXN0aW9uQ29tcG9uZW50IGV4dGVuZHMgQ29tcG9uZW50RXgge1xuICBwcml2YXRlIHJlYWRvbmx5IGFwcDogQXBwO1xuICBwcml2YXRlIHJlYWRvbmx5IGlzU3VnZ2VzdGlvbkRlY2xpbmVkOiAoKSA9PiBib29sZWFuO1xuICBwcml2YXRlIHJlYWRvbmx5IHBsdWdpbk5vdGljZUNvbXBvbmVudDogUGx1Z2luTm90aWNlQ29tcG9uZW50O1xuICBwcml2YXRlIHJlYWRvbmx5IHBsdWdpblNldHRpbmdzQ29tcG9uZW50OiBQbHVnaW5TZXR0aW5nc0NvbXBvbmVudEJhc2U8b2JqZWN0PjtcbiAgcHJpdmF0ZSByZWFkb25seSByZWFzb246IHN0cmluZztcbiAgcHJpdmF0ZSByZWFkb25seSBzZXRTdWdnZXN0aW9uRGVjbGluZWQ6IChpc0RlY2xpbmVkOiBib29sZWFuKSA9PiBQcm9taXNhYmxlPHZvaWQ+O1xuICBwcml2YXRlIHJlYWRvbmx5IHN1Z2dlc3RlZFBsdWdpbklkOiBzdHJpbmc7XG4gIHByaXZhdGUgcmVhZG9ubHkgc3VnZ2VzdGVkUGx1Z2luTmFtZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGFuIGluc3RhbmNlIG9mIHtAbGluayBQbHVnaW5TdWdnZXN0aW9uQ29tcG9uZW50fS5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBjb25zdHJ1Y3RvciBwYXJhbWV0ZXJzLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHBhcmFtczogUGx1Z2luU3VnZ2VzdGlvbkNvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zKSB7XG4gICAgc3VwZXIoKTtcbiAgICB0aGlzLmFwcCA9IHBhcmFtcy5hcHA7XG4gICAgdGhpcy5wbHVnaW5Ob3RpY2VDb21wb25lbnQgPSBwYXJhbXMucGx1Z2luTm90aWNlQ29tcG9uZW50O1xuICAgIHRoaXMucGx1Z2luU2V0dGluZ3NDb21wb25lbnQgPSBwYXJhbXMucGx1Z2luU2V0dGluZ3NDb21wb25lbnQ7XG4gICAgdGhpcy5yZWFzb24gPSBwYXJhbXMucmVhc29uO1xuICAgIHRoaXMuc3VnZ2VzdGVkUGx1Z2luSWQgPSBwYXJhbXMuc3VnZ2VzdGVkUGx1Z2luSWQ7XG4gICAgdGhpcy5zdWdnZXN0ZWRQbHVnaW5OYW1lID0gcGFyYW1zLnN1Z2dlc3RlZFBsdWdpbk5hbWU7XG4gICAgdGhpcy5pc1N1Z2dlc3Rpb25EZWNsaW5lZCA9IHBhcmFtcy5pc1N1Z2dlc3Rpb25EZWNsaW5lZDtcbiAgICB0aGlzLnNldFN1Z2dlc3Rpb25EZWNsaW5lZCA9IHBhcmFtcy5zZXRTdWdnZXN0aW9uRGVjbGluZWQ7XG4gIH1cblxuICAvKipcbiAgICogUmVzb2x2ZXMgaG93IHRoZSBzdWdnZXN0ZWQgcGx1Z2luIGlzIGN1cnJlbnRseSBwcmVzZW50IGluIHRoZSB2YXVsdC5cbiAgICpcbiAgICogQHJldHVybnMgVGhlIHtAbGluayBTdWdnZXN0ZWRQbHVnaW5TdGF0ZX0uXG4gICAqL1xuICBwdWJsaWMgZ2V0U3VnZ2VzdGVkUGx1Z2luU3RhdGUoKTogU3VnZ2VzdGVkUGx1Z2luU3RhdGUge1xuICAgIHJldHVybiBnZXRJbnN0YWxsZWRQbHVnaW5TdGF0ZSh7XG4gICAgICBhcHA6IHRoaXMuYXBwLFxuICAgICAgcGx1Z2luSWQ6IHRoaXMuc3VnZ2VzdGVkUGx1Z2luSWRcbiAgICB9KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBJbnN0YWxscyAod2hlbiBuZWVkZWQpIGFuZCBlbmFibGVzIHRoZSBzdWdnZXN0ZWQgcGx1Z2luLCByZXBvcnRpbmcgdGhlIG91dGNvbWUgYXMgYSBub3RpY2UuXG4gICAqXG4gICAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgb25jZSB0aGUgcGx1Z2luIGlzIGVuYWJsZWQsIG9yIG9uY2UgdGhlIGZhaWx1cmUgaGFzIGJlZW5cbiAgICogcmVwb3J0ZWQuXG4gICAqL1xuICBwdWJsaWMgYXN5bmMgaW5zdGFsbEFuZEVuYWJsZVN1Z2dlc3RlZFBsdWdpbigpOiBQcm9taXNlPHZvaWQ+IHtcbiAgICBpZiAodGhpcy5nZXRTdWdnZXN0ZWRQbHVnaW5TdGF0ZSgpID09PSBTdWdnZXN0ZWRQbHVnaW5TdGF0ZS5FbmFibGVkKSB7XG4gICAgICByZXR1cm47XG4gICAgfVxuXG4gICAgYXdhaXQgaW5zdGFsbEFuZEVuYWJsZVBsdWdpbih7XG4gICAgICBhcHA6IHRoaXMuYXBwLFxuICAgICAgcGx1Z2luSWQ6IHRoaXMuc3VnZ2VzdGVkUGx1Z2luSWQsXG4gICAgICBwbHVnaW5OYW1lOiB0aGlzLnN1Z2dlc3RlZFBsdWdpbk5hbWUsXG4gICAgICBwbHVnaW5Ob3RpY2VDb21wb25lbnQ6IHRoaXMucGx1Z2luTm90aWNlQ29tcG9uZW50XG4gICAgfSk7XG5cbiAgICAvLyBPbmx5IGFmdGVyIHRoZSBpbnN0YWxsIGFjdHVhbGx5IHN1Y2NlZWRlZCBcdTIwMTQgYGluc3RhbGxBbmRFbmFibGVQbHVnaW5gIHJldGhyb3dzIG9uIGZhaWx1cmUsIHNvIGFcbiAgICAvLyBmYWlsZWQgYXR0ZW1wdCBsZWF2ZXMgYSBwcmV2aW91cyBkZWNsaW5lIHN0YW5kaW5nIHJhdGhlciB0aGFuIHNpbGVudGx5IGNsZWFyaW5nIGl0LlxuICAgIGF3YWl0IHRoaXMuc2V0U3VnZ2VzdGlvbkRlY2xpbmVkKGZhbHNlKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBMb2FkcyB0aGUgY29tcG9uZW50LCBzaG93aW5nIHRoZSBzdWdnZXN0aW9uIG5vdGljZSBvbmNlIHRoZSBsYXlvdXQgaXMgcmVhZHkgQU5EIHRoZSBob3N0J3Mgc2V0dGluZ3NcbiAgICogaGF2ZSBiZWVuIHJlYWQgZnJvbSBkaXNrLlxuICAgKlxuICAgKiBCb3RoIHdhaXRzIG1hdHRlciwgYW5kIG5laXRoZXIgaW1wbGllcyB0aGUgb3RoZXI6XG4gICAqXG4gICAqIC0gTGF5b3V0LXJlYWR5LCBiZWNhdXNlIHBsdWdpbnMgbG9hZCBpbiBhbiB1bnNwZWNpZmllZCBvcmRlciwgc28gdGhlIHN1Z2dlc3RlZCBwbHVnaW4gbWF5IHdlbGwgYmVcbiAgICogICBlbmFibGVkIGEgbW9tZW50IGFmdGVyIHRoaXMgb25lLiBDaGVja2luZyBlYXJsaWVyIHdvdWxkIHN1Z2dlc3QgaW5zdGFsbGluZyBzb21ldGhpbmcgdGhlIHVzZXJcbiAgICogICBhbHJlYWR5IGhhcy5cbiAgICogLSBTZXR0aW5ncy1sb2FkZWQsIGJlY2F1c2Uge0BsaW5rIFBsdWdpblN1Z2dlc3Rpb25Db21wb25lbnRDb25zdHJ1Y3RvclBhcmFtcy5pc1N1Z2dlc3Rpb25EZWNsaW5lZH1cbiAgICogICByZWFkcyBhIHNldHRpbmcgb2YgdGhlIGhvc3QsIGFuZCB0aGUgaG9zdCdzIHNldHRpbmdzIGNvbXBvbmVudCBpcyBhIFNJQkxJTkcgd2hvc2Ugb3duIGFzeW5jIGxvYWQgaXNcbiAgICogICBzdGlsbCBpbiBmbGlnaHQgaGVyZS4gT24gYSBsYXlvdXQgdGhhdCBpcyBhbHJlYWR5IHJlYWR5IFx1MjAxNCBhIHJ1bnRpbWUgZW5hYmxlIGZyb20gdGhlIENvbW11bml0eVxuICAgKiAgIFBsdWdpbnMgdGFiLCBvciBhIHJlLWVuYWJsZSBhZnRlciBhbiB1cGRhdGUgXHUyMDE0IHRoZSBsYXlvdXQtcmVhZHkgY2FsbGJhY2sgZmlyZXMgaW1tZWRpYXRlbHksIHNvIHRoZVxuICAgKiAgIHJlYWQgd291bGQgc2VlIHRoZSBkZWZhdWx0IGBmYWxzZWAgYW5kIGFzayBhZ2FpbiBhIHVzZXIgd2hvIGhhcyBhbHJlYWR5IGRlY2xpbmVkLlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIG9ubG9hZCgpOiB2b2lkIHtcbiAgICB0aGlzLmFkZENoaWxkKFxuICAgICAgbmV3IENhbGxiYWNrTGF5b3V0UmVhZHlDb21wb25lbnQodGhpcy5hcHAsIGFzeW5jICgpID0+IHtcbiAgICAgICAgYXdhaXQgdGhpcy5wbHVnaW5TZXR0aW5nc0NvbXBvbmVudC53aGVuTG9hZGVkRnJvbUZpbGUoKTtcbiAgICAgICAgaWYgKHRoaXMuaXNVbmxvYWRlZCgpKSB7XG4gICAgICAgICAgcmV0dXJuO1xuICAgICAgICB9XG5cbiAgICAgICAgdGhpcy5zaG93U3VnZ2VzdGlvbk5vdGljZSgpO1xuICAgICAgfSlcbiAgICApO1xuICB9XG5cbiAgLyoqXG4gICAqIFJlbmRlcnMgdGhlIHN1Z2dlc3Rpb24gYmFubmVyIGludG8gYSBzZXR0aW5ncy10YWIgY29udGFpbmVyLCB3aXRoIGEgYnV0dG9uIHRoYXQgaW5zdGFsbHMgYW5kIGVuYWJsZXNcbiAgICogdGhlIHN1Z2dlc3RlZCBwbHVnaW4uXG4gICAqXG4gICAqIFJlbmRlcnMgbm90aGluZyB3aGVuIHRoZSBzdWdnZXN0ZWQgcGx1Z2luIGlzIGFscmVhZHkgZW5hYmxlZC4gVW5saWtlIHRoZSBub3RpY2UsIHRoZSBiYW5uZXIgaWdub3JlcyBhXG4gICAqIHByZXZpb3VzIGRlY2xpbmUgXHUyMDE0IHRoZSB1c2VyIGlzIGxvb2tpbmcgYXQgdGhlc2Ugc2V0dGluZ3MgcmlnaHQgbm93LCB3aGljaCBpcyBhIGZyZXNoZXIgc2lnbmFsIHRoYW4gYW5cbiAgICogYW5zd2VyIHRoZXkgZ2F2ZSBlYXJsaWVyLlxuICAgKlxuICAgKiBAcGFyYW0gY29udGFpbmVyRWwgLSBUaGUgZWxlbWVudCB0byByZW5kZXIgdGhlIGJhbm5lciBpbnRvLlxuICAgKi9cbiAgcHVibGljIHJlbmRlckJhbm5lcihjb250YWluZXJFbDogSFRNTEVsZW1lbnQpOiB2b2lkIHtcbiAgICBjb25zdCBzdGF0ZSA9IHRoaXMuZ2V0U3VnZ2VzdGVkUGx1Z2luU3RhdGUoKTtcbiAgICBpZiAoc3RhdGUgPT09IFN1Z2dlc3RlZFBsdWdpblN0YXRlLkVuYWJsZWQpIHtcbiAgICAgIHJldHVybjtcbiAgICB9XG5cbiAgICBjb25zdCBiYW5uZXJFbCA9IGNvbnRhaW5lckVsLmNyZWF0ZURpdih7XG4gICAgICBjbHM6IFtDc3NDbGFzcy5MaWJyYXJ5TmFtZSwgQ3NzQ2xhc3MuUGx1Z2luU3VnZ2VzdGlvbkJhbm5lcl1cbiAgICB9KTtcbiAgICBiYW5uZXJFbC5jcmVhdGVEaXYoeyB0ZXh0OiB0aGlzLnJlYXNvbiB9KTtcblxuICAgIG5ldyBCdXR0b25Db21wb25lbnQoYmFubmVyRWwpXG4gICAgICAuc2V0QnV0dG9uVGV4dCh0aGlzLmdldEFjdGlvbkJ1dHRvblRleHQoc3RhdGUpKVxuICAgICAgLnNldEN0YSgpXG4gICAgICAub25DbGljayhjb252ZXJ0QXN5bmNUb1N5bmMoYXN5bmMgKCkgPT4ge1xuICAgICAgICBhd2FpdCB0aGlzLmluc3RhbGxBbmRFbmFibGVTdWdnZXN0ZWRQbHVnaW4oKTtcbiAgICAgIH0pKTtcbiAgfVxuXG4gIHByaXZhdGUgZ2V0QWN0aW9uQnV0dG9uVGV4dChzdGF0ZTogU3VnZ2VzdGVkUGx1Z2luU3RhdGUpOiBzdHJpbmcge1xuICAgIHJldHVybiB0KCgkKSA9PlxuICAgICAgc3RhdGUgPT09IFN1Z2dlc3RlZFBsdWdpblN0YXRlLkluc3RhbGxlZEJ1dERpc2FibGVkXG4gICAgICAgID8gJC5vYnNpZGlhbkRldlV0aWxzLnBsdWdpblN1Z2dlc3Rpb24uZW5hYmxlXG4gICAgICAgIDogJC5vYnNpZGlhbkRldlV0aWxzLnBsdWdpblN1Z2dlc3Rpb24uaW5zdGFsbFxuICAgICk7XG4gIH1cblxuICBwcml2YXRlIHNob3dTdWdnZXN0aW9uTm90aWNlKCk6IHZvaWQge1xuICAgIGNvbnN0IHN0YXRlID0gdGhpcy5nZXRTdWdnZXN0ZWRQbHVnaW5TdGF0ZSgpO1xuICAgIGlmIChzdGF0ZSA9PT0gU3VnZ2VzdGVkUGx1Z2luU3RhdGUuRW5hYmxlZCB8fCB0aGlzLmlzU3VnZ2VzdGlvbkRlY2xpbmVkKCkpIHtcbiAgICAgIHJldHVybjtcbiAgICB9XG5cbiAgICBjb25zdCBmcmFnbWVudCA9IGNyZWF0ZUZyYWdtZW50KChmcmFnbWVudEVsKSA9PiB7XG4gICAgICBmcmFnbWVudEVsLmNyZWF0ZURpdih7IHRleHQ6IHRoaXMucmVhc29uIH0pO1xuICAgICAgY29uc3QgYnV0dG9uc0VsID0gZnJhZ21lbnRFbC5jcmVhdGVEaXYoKTtcblxuICAgICAgbmV3IEJ1dHRvbkNvbXBvbmVudChidXR0b25zRWwpXG4gICAgICAgIC5zZXRCdXR0b25UZXh0KHRoaXMuZ2V0QWN0aW9uQnV0dG9uVGV4dChzdGF0ZSkpXG4gICAgICAgIC5zZXRDdGEoKVxuICAgICAgICAub25DbGljayhjb252ZXJ0QXN5bmNUb1N5bmMoYXN5bmMgKCkgPT4ge1xuICAgICAgICAgIGF3YWl0IHRoaXMuaW5zdGFsbEFuZEVuYWJsZVN1Z2dlc3RlZFBsdWdpbigpO1xuICAgICAgICB9KSk7XG5cbiAgICAgIG5ldyBCdXR0b25Db21wb25lbnQoYnV0dG9uc0VsKVxuICAgICAgICAuc2V0QnV0dG9uVGV4dCh0KCgkKSA9PiAkLm9ic2lkaWFuRGV2VXRpbHMucGx1Z2luU3VnZ2VzdGlvbi5ub3ROb3cpKVxuICAgICAgICAub25DbGljayhjb252ZXJ0QXN5bmNUb1N5bmMoYXN5bmMgKCkgPT4ge1xuICAgICAgICAgIGF3YWl0IHRoaXMuc2V0U3VnZ2VzdGlvbkRlY2xpbmVkKHRydWUpO1xuICAgICAgICB9KSk7XG4gICAgfSk7XG5cbiAgICB0aGlzLnBsdWdpbk5vdGljZUNvbXBvbmVudC5zaG93Tm90aWNlKGZyYWdtZW50LCB7IHNob3VsZEhpZGVPbkNsaWNrOiBmYWxzZSB9KTtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUErQkEsU0FBUywwQkFBMEI7QUFDbkMsU0FBUyx1QkFBdUI7QUFLaEMsU0FBUyxnQkFB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

package/dist/lib/esm/components/pointer-position-component.d.mts

@@ -0,0 +1,29 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Remembers where the last pointer gesture happened, so UI can be anchored there.
+ *
+ * A context menu is the reason this exists: Obsidian's `file-menu` / `url-menu` events carry the
+ * target file or url but no event and no DOM element, and by the time a menu item's callback runs the
+ * menu is closing — so there is nothing left to measure. The right-click (or long-press) that raised
+ * the menu is, however, exactly where the user is looking, and it always precedes the menu.
+ */
+import type { PopoverAnchor } from '../popovers/popover-anchor.mjs';
+import { AllWindowsEventComponent } from './all-windows-event-component.mjs';
+/**
+ * Records the position of the last pointer gesture in any window.
+ */
+export declare class PointerPositionComponent extends AllWindowsEventComponent {
+    private lastAnchor;
+    /**
+     * The anchor for the last pointer gesture.
+     *
+     * @returns The anchor, or `null` when no pointer gesture has happened yet.
+     */
+    getLastPointerAnchor(): null | PopoverAnchor;
+    /**
+     * Starts recording pointer gestures in every window.
+     */
+    onload(): void;
+}

package/dist/lib/esm/components/pointer-position-component.mjs

@@ -0,0 +1,69 @@
+/*
+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 { createAnchorFromPoint } from "../popovers/popover-anchor.mjs";
+import { AllWindowsEventComponent } from "./all-windows-event-component.mjs";
+class PointerPositionComponent extends AllWindowsEventComponent {
+  lastAnchor = null;
+  /**
+   * The anchor for the last pointer gesture.
+   *
+   * @returns The anchor, or `null` when no pointer gesture has happened yet.
+   */
+  getLastPointerAnchor() {
+    return this.lastAnchor;
+  }
+  /**
+   * Starts recording pointer gestures in every window.
+   */
+  onload() {
+    super.onload();
+    this.registerAllWindowsHandler((win) => {
+      this.registerDomEvent(win.document, "pointerdown", ($event) => {
+        this.lastAnchor = createAnchorFromPoint($event.clientX, $event.clientY, win.document);
+      }, { capture: true });
+    });
+  }
+}
+export {
+  PointerPositionComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvcG9pbnRlci1wb3NpdGlvbi1jb21wb25lbnQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBSZW1lbWJlcnMgd2hlcmUgdGhlIGxhc3QgcG9pbnRlciBnZXN0dXJlIGhhcHBlbmVkLCBzbyBVSSBjYW4gYmUgYW5jaG9yZWQgdGhlcmUuXG4gKlxuICogQSBjb250ZXh0IG1lbnUgaXMgdGhlIHJlYXNvbiB0aGlzIGV4aXN0czogT2JzaWRpYW4ncyBgZmlsZS1tZW51YCAvIGB1cmwtbWVudWAgZXZlbnRzIGNhcnJ5IHRoZVxuICogdGFyZ2V0IGZpbGUgb3IgdXJsIGJ1dCBubyBldmVudCBhbmQgbm8gRE9NIGVsZW1lbnQsIGFuZCBieSB0aGUgdGltZSBhIG1lbnUgaXRlbSdzIGNhbGxiYWNrIHJ1bnMgdGhlXG4gKiBtZW51IGlzIGNsb3NpbmcgXHUyMDE0IHNvIHRoZXJlIGlzIG5vdGhpbmcgbGVmdCB0byBtZWFzdXJlLiBUaGUgcmlnaHQtY2xpY2sgKG9yIGxvbmctcHJlc3MpIHRoYXQgcmFpc2VkXG4gKiB0aGUgbWVudSBpcywgaG93ZXZlciwgZXhhY3RseSB3aGVyZSB0aGUgdXNlciBpcyBsb29raW5nLCBhbmQgaXQgYWx3YXlzIHByZWNlZGVzIHRoZSBtZW51LlxuICovXG5cbmltcG9ydCB0eXBlIHsgUG9wb3ZlckFuY2hvciB9IGZyb20gJy4uL3BvcG92ZXJzL3BvcG92ZXItYW5jaG9yLnRzJztcblxuaW1wb3J0IHsgY3JlYXRlQW5jaG9yRnJvbVBvaW50IH0gZnJvbSAnLi4vcG9wb3ZlcnMvcG9wb3Zlci1hbmNob3IudHMnO1xuaW1wb3J0IHsgQWxsV2luZG93c0V2ZW50Q29tcG9uZW50IH0gZnJvbSAnLi9hbGwtd2luZG93cy1ldmVudC1jb21wb25lbnQudHMnO1xuXG4vKipcbiAqIFJlY29yZHMgdGhlIHBvc2l0aW9uIG9mIHRoZSBsYXN0IHBvaW50ZXIgZ2VzdHVyZSBpbiBhbnkgd2luZG93LlxuICovXG5leHBvcnQgY2xhc3MgUG9pbnRlclBvc2l0aW9uQ29tcG9uZW50IGV4dGVuZHMgQWxsV2luZG93c0V2ZW50Q29tcG9uZW50IHtcbiAgcHJpdmF0ZSBsYXN0QW5jaG9yOiBudWxsIHwgUG9wb3ZlckFuY2hvciA9IG51bGw7XG5cbiAgLyoqXG4gICAqIFRoZSBhbmNob3IgZm9yIHRoZSBsYXN0IHBvaW50ZXIgZ2VzdHVyZS5cbiAgICpcbiAgICogQHJldHVybnMgVGhlIGFuY2hvciwgb3IgYG51bGxgIHdoZW4gbm8gcG9pbnRlciBnZXN0dXJlIGhhcyBoYXBwZW5lZCB5ZXQuXG4gICAqL1xuICBwdWJsaWMgZ2V0TGFzdFBvaW50ZXJBbmNob3IoKTogbnVsbCB8IFBvcG92ZXJBbmNob3Ige1xuICAgIHJldHVybiB0aGlzLmxhc3RBbmNob3I7XG4gIH1cblxuICAvKipcbiAgICogU3RhcnRzIHJlY29yZGluZyBwb2ludGVyIGdlc3R1cmVzIGluIGV2ZXJ5IHdpbmRvdy5cbiAgICovXG4gIHB1YmxpYyBvdmVycmlkZSBvbmxvYWQoKTogdm9pZCB7XG4gICAgc3VwZXIub25sb2FkKCk7XG5cbiAgICAvKlxuICAgICAqIFJlZ2lzdGVyZWQgcGVyIHdpbmRvdyByYXRoZXIgdGhhbiB0aHJvdWdoIGByZWdpc3RlckFsbERvY3VtZW50c0RvbUV2ZW50YCBzbyB0aGUgZG9jdW1lbnQgaXNcbiAgICAgKiB0YWtlbiBmcm9tIHRoZSB3aW5kb3cgdGhlIGxpc3RlbmVyIGJlbG9uZ3MgdG8uIERlcml2aW5nIGl0IGZyb20gdGhlIGV2ZW50IHRhcmdldCBpbnN0ZWFkIHdvdWxkXG4gICAgICogYWRkIGEgYnJhbmNoIHRoYXQgYSBkb2N1bWVudC1sZXZlbCBsaXN0ZW5lciBjYW4gbmV2ZXIgdGFrZS5cbiAgICAgKlxuICAgICAqIGBwb2ludGVyZG93bmAgcmF0aGVyIHRoYW4gYGNsaWNrYCAvIGBjb250ZXh0bWVudWA6IGl0IGZpcmVzIGZvciBldmVyeSBidXR0b24gYW5kIGZvciB0b3VjaCwgc29cbiAgICAgKiBvbmUgbGlzdGVuZXIgY292ZXJzIGEgZGVza3RvcCByaWdodC1jbGljayBhbmQgYSBtb2JpbGUgbG9uZy1wcmVzcyBhbGlrZSwgYW5kIGl0IGFsd2F5cyBydW5zXG4gICAgICogYmVmb3JlIHRoZSBtZW51IG9wZW5zLlxuICAgICAqL1xuICAgIHRoaXMucmVnaXN0ZXJBbGxXaW5kb3dzSGFuZGxlcigod2luKSA9PiB7XG4gICAgICB0aGlzLnJlZ2lzdGVyRG9tRXZlbnQod2luLmRvY3VtZW50LCAncG9pbnRlcmRvd24nLCAoJGV2ZW50KSA9PiB7XG4gICAgICAgIHRoaXMubGFzdEFuY2hvciA9IGNyZWF0ZUFuY2hvckZyb21Qb2ludCgkZXZlbnQuY2xpZW50WCwgJGV2ZW50LmNsaWVudFksIHdpbi5kb2N1bWVudCk7XG4gICAgICB9LCB7IGNhcHR1cmU6IHRydWUgfSk7XG4gICAgfSk7XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBYUEsU0FBUyw2QkFBNkI7QUFDdEMsU0FBUyxnQ0FBZ0M7QUFLbEMsTUFBTSxpQ0FBaUMseUJBQXlCO0FBQUEsRUFDN0QsYUFBbUM7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFPcEMsdUJBQTZDO0FBQ2xELFdBQU8sS0FBSztBQUFBLEVBQ2Q7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtnQixTQUFlO0FBQzdCLFVBQU0sT0FBTztBQVdiLFNBQUssMEJBQTBCLENBQUMsUUFBUTtBQUN0QyxXQUFLLGlCQUFpQixJQUFJLFVBQVUsZUFBZSxDQUFDLFdBQVc7QUFDN0QsYUFBSyxhQUFhLHNCQUFzQixPQUFPLFNBQVMsT0FBTyxTQUFTLElBQUksUUFBUTtBQUFBLE1BQ3RGLEdBQUcsRUFBRSxTQUFTLEtBQUssQ0FBQztBQUFBLElBQ3RCLENBQUM7QUFBQSxFQUNIO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/components/registry-component.d.mts

@@ -0,0 +1,37 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * {@link RegistryComponent}.
+ */
+import type { Constructor } from 'type-fest';
+import { ComponentEx } from './component-ex.mjs';
+/**
+ * A component that keeps registry of its children.
+ */
+export declare class RegistryComponent extends ComponentEx {
+    /**
+     * Get the single child of the given type.
+     *
+     * @typeParam TComponent - The type of component to get.
+     * @param componentClass - The class of the component to get.
+     * @returns The single registered child of the given type.
+     */
+    getChild<TComponent>(componentClass: Constructor<TComponent>): TComponent;
+    /**
+     * Get the single child of the given type.
+     *
+     * @typeParam TComponent - The type of component to get.
+     * @param componentClass - The class of the component to get.
+     * @returns The single registered child of the given type, or `null` if none are registered.
+     */
+    getChildOrNull<TComponent>(componentClass: Constructor<TComponent>): null | TComponent;
+    /**
+     * Get all children of the given type.
+     *
+     * @typeParam TComponent - The type of component to get.
+     * @param componentClass - The class of the component to get.
+     * @returns All registered children of the given type.
+     */
+    getChildren<TComponent>(componentClass: Constructor<TComponent>): TComponent[];
+}