@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/esm/command-handlers/command-handler-component.mjs

@@ -0,0 +1,193 @@
+/*
+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 {
+  CallbackDisposable,
+  CombineDisposable,
+  DisposableBase
+} from "@mnaoumov/typescript-lib/disposable";
+import { ComponentEx } from "../components/component-ex.mjs";
+class CommandMenuEventScope extends DisposableBase {
+  constructor(inner) {
+    super();
+    this.inner = inner;
+  }
+  inner;
+  disposables = [];
+  registerEditorMenuEventHandler(handler) {
+    return this.collect(this.inner.registerEditorMenuEventHandler(handler));
+  }
+  registerFileMenuEventHandler(handler) {
+    return this.collect(this.inner.registerFileMenuEventHandler(handler));
+  }
+  registerFilesMenuEventHandler(handler) {
+    return this.collect(this.inner.registerFilesMenuEventHandler(handler));
+  }
+  registerMarkdownViewportMenuEventHandler(handler) {
+    return this.collect(this.inner.registerMarkdownViewportMenuEventHandler(handler));
+  }
+  performDispose() {
+    for (const disposable of this.disposables) {
+      disposable.dispose();
+    }
+    this.disposables.length = 0;
+  }
+  collect(disposable) {
+    if (this.isDisposed) {
+      disposable.dispose();
+    } else {
+      this.disposables.push(disposable);
+    }
+    return disposable;
+  }
+}
+class CommandHandlerComponent extends ComponentEx {
+  /**
+   * Provider for accessing the currently active file.
+   */
+  activeFileProvider;
+  /**
+   * Registrars for menu surfaces that build their own plugin-titled parent entry, and therefore take
+   * the handlers with their section submenu forced off.
+   */
+  additionalMenuEventRegistrars;
+  /**
+   * Registrar used to add and remove commands with Obsidian.
+   */
+  commandRegistrar;
+  /**
+   * Registrar for menu event handlers.
+   */
+  menuEventRegistrar;
+  /**
+   * The name of the plugin that owns the commands.
+   */
+  pluginName;
+  commandLifetimeOwnerProvider;
+  /**
+   * Creates a new command handler component.
+   *
+   * @param params - The constructor parameters.
+   */
+  constructor(params) {
+    super();
+    this.activeFileProvider = params.activeFileProvider;
+    this.menuEventRegistrar = params.menuEventRegistrar;
+    this.additionalMenuEventRegistrars = params.additionalMenuEventRegistrars ?? [];
+    this.commandRegistrar = params.commandRegistrar;
+    this.pluginName = params.pluginName;
+    this.commandLifetimeOwnerProvider = params.commandLifetimeOwnerProvider ?? (() => this);
+  }
+  /**
+   * Builds the command handlers and registers them with Obsidian, giving each its own runtime
+   * registration context. Each handler's command is added immediately; the returned
+   * {@link DisposableEx} removes the commands registered by this call — and any menu events those
+   * handlers registered via their context's {@link MenuEventRegistrar} — when disposed. Any command
+   * still registered when the component unloads is removed automatically.
+   *
+   * The factory is invoked once more for every additional menu surface, so a plugin declares its
+   * handlers ONCE and all surfaces are fed. Those extra passes add no commands — the palette already
+   * has every command from the first pass.
+   *
+   * Which component's unload removes them is the caller's to choose: `options.lifetimeOwner` for this one
+   * batch, otherwise whatever this component's {@link CommandLifetimeOwnerProvider} resolves to, which
+   * defaults to the component itself. A command must never outlive the collaborators its handler closes
+   * over — left on a longer-lived owner it stays in the palette calling into torn-down objects — so the
+   * owner to name is the shortest-lived thing the batch depends on.
+   *
+   * @param commandHandlerFactory - Builds a fresh set of command handlers, once per menu surface.
+   * @param options - The registration options.
+   * @returns A {@link DisposableEx} that unregisters the handlers (commands + menu events) registered by this call.
+   */
+  async registerCommandHandlers(commandHandlerFactory, options) {
+    const lifetimeOwner = options?.lifetimeOwner ?? this.commandLifetimeOwnerProvider();
+    const disposables = [];
+    for (const commandHandler of commandHandlerFactory()) {
+      const command = commandHandler.buildCommand();
+      const commandId = command.id;
+      this.commandRegistrar.addCommand(command);
+      const menuEventScope = await this.registerMenuEventHandlers({ commandHandler, menuEventRegistrar: this.menuEventRegistrar });
+      const disposable = new CallbackDisposable({
+        callback: () => {
+          this.commandRegistrar.removeCommand(commandId);
+          menuEventScope.dispose();
+        }
+      });
+      disposables.push(lifetimeOwner.registerDisposable(disposable));
+    }
+    for (const additionalMenuEventRegistrar of this.additionalMenuEventRegistrars) {
+      for (const commandHandler of commandHandlerFactory()) {
+        disposables.push(lifetimeOwner.registerDisposable(await this.registerMenuEventHandlers({ commandHandler, menuEventRegistrar: additionalMenuEventRegistrar, shouldAddCommandToSubmenu: false })));
+      }
+    }
+    return new CombineDisposable({ disposables });
+  }
+  /**
+   * Hands a command handler its registration context, scoped so that disposing the returned scope
+   * unregisters exactly the menu events that handler registered.
+   *
+   * @param params - The parameters for this registration.
+   * @returns The handler's menu-event scope.
+   */
+  async registerMenuEventHandlers(params) {
+    const menuEventScope = new CommandMenuEventScope(params.menuEventRegistrar);
+    const context = {
+      activeFileProvider: this.activeFileProvider,
+      menuEventRegistrar: menuEventScope,
+      pluginName: this.pluginName,
+      shouldAddCommandToSubmenu: params.shouldAddCommandToSubmenu
+    };
+    await params.commandHandler.onRegistered(context);
+    return menuEventScope;
+  }
+}
+export {
+  CommandHandlerComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbW1hbmQtaGFuZGxlcnMvY29tbWFuZC1oYW5kbGVyLWNvbXBvbmVudC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbXBvbmVudCB0aGF0IHJlZ2lzdGVycyB7QGxpbmsgQ29tbWFuZEhhbmRsZXJ9cyB3aXRoIE9ic2lkaWFuIGFuZCB0aWVzIHRoZWlyIHJlbW92YWwgdG8gYSBjaG9zZW4gbGlmZXRpbWUuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBEaXNwb3NhYmxlRXggfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvZGlzcG9zYWJsZSc7XG5cbmltcG9ydCB7XG4gIENhbGxiYWNrRGlzcG9zYWJsZSxcbiAgQ29tYmluZURpc3Bvc2FibGUsXG4gIERpc3Bvc2FibGVCYXNlXG59IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9kaXNwb3NhYmxlJztcblxuaW1wb3J0IHR5cGUgeyBBY3RpdmVGaWxlUHJvdmlkZXIgfSBmcm9tICcuLi9hY3RpdmUtZmlsZS1wcm92aWRlci50cyc7XG5pbXBvcnQgdHlwZSB7IENvbW1hbmRSZWdpc3RyYXIgfSBmcm9tICcuLi9jb21tYW5kLXJlZ2lzdHJhci50cyc7XG5pbXBvcnQgdHlwZSB7XG4gIEVkaXRvck1lbnVFdmVudEhhbmRsZXIsXG4gIEZpbGVNZW51RXZlbnRIYW5kbGVyLFxuICBGaWxlc01lbnVFdmVudEhhbmRsZXIsXG4gIE1hcmtkb3duVmlld3BvcnRNZW51RXZlbnRIYW5kbGVyLFxuICBNZW51RXZlbnRSZWdpc3RyYXJcbn0gZnJvbSAnLi4vbWVudS1ldmVudC1yZWdpc3RyYXIudHMnO1xuaW1wb3J0IHR5cGUge1xuICBDb21tYW5kSGFuZGxlcixcbiAgQ29tbWFuZEhhbmRsZXJSZWdpc3RyYXRpb25Db250ZXh0XG59IGZyb20gJy4vY29tbWFuZC1oYW5kbGVyLnRzJztcblxuaW1wb3J0IHsgQ29tcG9uZW50RXggfSBmcm9tICcuLi9jb21wb25lbnRzL2NvbXBvbmVudC1leC50cyc7XG5cbi8qKlxuICogQnVpbGRzIGEgZnJlc2ggc2V0IG9mIHtAbGluayBDb21tYW5kSGFuZGxlcn1zLlxuICpcbiAqIEEgZmFjdG9yeSByYXRoZXIgdGhhbiBhIHJlYWR5LW1hZGUgYXJyYXkgYmVjYXVzZSB7QGxpbmsgQ29tbWFuZEhhbmRsZXJDb21wb25lbnR9IHJlZ2lzdGVycyB0aGUgc2FtZVxuICogaGFuZGxlcnMgYWdhaW5zdCBzZXZlcmFsIG1lbnUgc3VyZmFjZXMsIGFuZCBhIGhhbmRsZXIgY2FycmllcyBwZXItcmVnaXN0cmF0aW9uIHN0YXRlIChpdHNcbiAqIGFjdGl2ZS1maWxlIHByb3ZpZGVyLCBpdHMgcGx1Z2luIG5hbWUsIGFuZCB3aGF0ZXZlciBhIHN1YmNsYXNzIHJlY29yZHMgaW5cbiAqIHtAbGluayBDb21tYW5kSGFuZGxlci5vblJlZ2lzdGVyZWR9KSBcdTIwMTQgc28gZXZlcnkgc3VyZmFjZSBuZWVkcyBpdHMgb3duIGluc3RhbmNlcy5cbiAqXG4gKiBSZXR1cm5pbmcgc2hhcmVkIGluc3RhbmNlcyAoYCgpID0+IFtoYW5kbGVyMVNpbmdsZXRvbiwgaGFuZGxlcjJTaW5nbGV0b25dYCkgcmVpbnRyb2R1Y2VzIGV4YWN0bHkgdGhlXG4gKiBidWcgdGhlIGZhY3RvcnkgZXhpc3RzIHRvIGF2b2lkLCBzbyBpdCBpcyBub3QgbWVyZWx5IGRpc2NvdXJhZ2VkOiB7QGxpbmsgQ29tbWFuZEhhbmRsZXIub25SZWdpc3RlcmVkfVxuICogdGhyb3dzIG9uIHRoZSBzZWNvbmQgcmVnaXN0cmF0aW9uIG9mIGFuIGluc3RhbmNlLiB7QGxpbmsgQ29tbWFuZEhhbmRsZXJDb21wb25lbnQucmVnaXN0ZXJDb21tYW5kSGFuZGxlcnN9XG4gKiBhd2FpdHMgaXQsIHNvIHRoYXQgdGhyb3cgcmVqZWN0cyB0aGUgY2FsbGVyJ3MgcHJvbWlzZSBpbnN0ZWFkIG9mIGRlZ3JhZGluZyBpbnRvIGEgd3JvbmcgY29udGV4dCBtZW51LlxuICpcbiAqIEByZXR1cm5zIFRoZSBjb21tYW5kIGhhbmRsZXJzIHRvIHJlZ2lzdGVyLiBBIE5FVyBpbnN0YW5jZSBvZiBlYWNoIG9uIGV2ZXJ5IGNhbGwuXG4gKi9cbmV4cG9ydCB0eXBlIENvbW1hbmRIYW5kbGVyRmFjdG9yeSA9ICgpID0+IENvbW1hbmRIYW5kbGVyW107XG5cbmludGVyZmFjZSBDb21tYW5kSGFuZGxlckNvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zIHtcbiAgcmVhZG9ubHkgYWN0aXZlRmlsZVByb3ZpZGVyOiBBY3RpdmVGaWxlUHJvdmlkZXI7XG4gIHJlYWRvbmx5IGFkZGl0aW9uYWxNZW51RXZlbnRSZWdpc3RyYXJzPzogcmVhZG9ubHkgTWVudUV2ZW50UmVnaXN0cmFyW10gfCB1bmRlZmluZWQ7XG5cbiAgLyoqXG4gICAqIFJlc29sdmVzIHRoZSBsaWZldGltZSBvd25lciBmb3IgYSByZWdpc3RyYXRpb24gdGhhdCBuYW1lcyBub25lIG9mIGl0cyBvd24uXG4gICAqXG4gICAqIFdoZW4gb21pdHRlZCwgZXZlcnkgcmVnaXN0cmF0aW9uIGlzIG93bmVkIGJ5IHRoZSBjb21wb25lbnQgaXRzZWxmLCBzbyBpdHMgdW5sb2FkIHJlbW92ZXMgZXZlcnkgY29tbWFuZFxuICAgKiBpdCByZWdpc3RlcmVkIFx1MjAxNCB0aGUgYmVoYXZpb3IgYSBzdGFuZGFsb25lIGNvbXBvbmVudCBoYXMgYWx3YXlzIGhhZC4gTm8gYEBkZWZhdWx0YCB0YWcsIGJlY2F1c2UgdGhlXG4gICAqIGVmZmVjdGl2ZSBkZWZhdWx0IGlzIGEgY2xvc3VyZSBvdmVyIGB0aGlzYCByYXRoZXIgdGhhbiBhIGxpdGVyYWwgb3IgYSBsaW5rYWJsZSBzeW1ib2wuXG4gICAqL1xuICByZWFkb25seSBjb21tYW5kTGlmZXRpbWVPd25lclByb3ZpZGVyPzogQ29tbWFuZExpZmV0aW1lT3duZXJQcm92aWRlciB8IHVuZGVmaW5lZDtcbiAgcmVhZG9ubHkgY29tbWFuZFJlZ2lzdHJhcjogQ29tbWFuZFJlZ2lzdHJhcjtcbiAgcmVhZG9ubHkgbWVudUV2ZW50UmVnaXN0cmFyOiBNZW51RXZlbnRSZWdpc3RyYXI7XG4gIHJlYWRvbmx5IHBsdWdpbk5hbWU6IHN0cmluZztcbn1cblxuaW50ZXJmYWNlIENvbW1hbmRIYW5kbGVyQ29tcG9uZW50UmVnaXN0ZXJDb21tYW5kSGFuZGxlcnNPcHRpb25zIHtcbiAgLyoqXG4gICAqIFRoZSBjb21wb25lbnQgd2hvc2UgdW5sb2FkIHJlbW92ZXMgdGhlIGNvbW1hbmRzIHRoaXMgY2FsbCByZWdpc3RlcnMsIG92ZXJyaWRpbmcgdGhlIGNvbXBvbmVudCdzXG4gICAqIHtAbGluayBDb21tYW5kTGlmZXRpbWVPd25lclByb3ZpZGVyfSBmb3IgdGhpcyBvbmUgY2FsbC5cbiAgICpcbiAgICogTmFtZSBvbmUgd2hlbiB0aGUgYmF0Y2gncyBsaWZldGltZSBkaWZmZXJzIGZyb20gdGhlIGRlZmF1bHQgXHUyMDE0IHRoZSBjYWxsZXIgdGhhdCBuZWVkcyBpdCBpcyBvbmVcbiAgICogcmVnaXN0ZXJpbmcgdGhyb3VnaCBhIGNvbXBvbmVudCB3aG9zZSBkZWZhdWx0IG93bmVyIGlzIHNvbWUgU0hPUlRFUi1saXZlZCBzdXJmYWNlLCBhbmQgd2hvc2Ugb3duXG4gICAqIGNvbW1hbmRzIGhhdmUgdG8gb3V0bGl2ZSBpdC5cbiAgICovXG4gIHJlYWRvbmx5IGxpZmV0aW1lT3duZXI/OiBDb21wb25lbnRFeCB8IHVuZGVmaW5lZDtcbn1cblxuaW50ZXJmYWNlIENvbW1hbmRIYW5kbGVyQ29tcG9uZW50UmVnaXN0ZXJNZW51RXZlbnRIYW5kbGVyc1BhcmFtcyB7XG4gIHJlYWRvbmx5IGNvbW1hbmRIYW5kbGVyOiBDb21tYW5kSGFuZGxlcjtcbiAgcmVhZG9ubHkgbWVudUV2ZW50UmVnaXN0cmFyOiBNZW51RXZlbnRSZWdpc3RyYXI7XG4gIHJlYWRvbmx5IHNob3VsZEFkZENvbW1hbmRUb1N1Ym1lbnU/OiBib29sZWFuO1xufVxuXG4vKipcbiAqIFJlc29sdmVzIHRoZSBjb21wb25lbnQgdGhhdCBvd25zIHRoZSB0ZWFyZG93biBvZiB0aGUgY29tbWFuZHMgYSB7QGxpbmsgQ29tbWFuZEhhbmRsZXJDb21wb25lbnQucmVnaXN0ZXJDb21tYW5kSGFuZGxlcnN9XG4gKiBjYWxsIHJlZ2lzdGVycyBcdTIwMTQgdGhlIG9uZSB3aG9zZSB1bmxvYWQgcmVtb3ZlcyB0aGVtIGZyb20gdGhlIHBhbGV0dGUuXG4gKlxuICogQSBwcm92aWRlciByYXRoZXIgdGhhbiBhIGNvbXBvbmVudCwgYmVjYXVzZSB0aGUgb3duZXIgaXMgbm90IHN0YWJsZSBmb3IgdGhlIGxpZmUgb2YgdGhlIHJlZ2lzdGVyaW5nXG4gKiBjb21wb25lbnQuIGBQbHVnaW5CYXNlYCBoYW5kcyBiYWNrIHRoZSB3cmFwcGVyIGhvbGRpbmcgdGhlIHBsdWdpbidzIGZlYXR1cmUgc3VyZmFjZSwgYW5kIHRoYXQgd3JhcHBlciBpc1xuICogUkVQTEFDRUQgd2hvbGVzYWxlIGV2ZXJ5IHRpbWUgdGhlIHN1cmZhY2UgZ29lcyBkb3duIGFuZCBjb21lcyBiYWNrIChhIGRlY2xhcmVkIGRlcGVuZGVuY3kgbG9zdCBhbmRcbiAqIHJlZ2FpbmVkLCBhIGRlY2xhcmVkIGNvbmZsaWN0IGFwcGVhcmluZyBhbmQgYmVpbmcgcmVzb2x2ZWQpLiBBIHZhbHVlIGNhcHR1cmVkIG9uY2Ugd291bGQgdGllIHRoZSBzZWNvbmRcbiAqIGN5Y2xlJ3MgY29tbWFuZHMgdG8gdGhlIGZpcnN0IGN5Y2xlJ3MgZGVhZCB3cmFwcGVyLCB3aGVyZSBub3RoaW5nIHdvdWxkIGV2ZXIgZGlzcG9zZSB0aGVtLlxuICpcbiAqIEByZXR1cm5zIFRoZSBjb21wb25lbnQgdGhhdCBzaG91bGQgb3duIHRoZSByZWdpc3RyYXRpb24ncyB0ZWFyZG93bi5cbiAqL1xudHlwZSBDb21tYW5kTGlmZXRpbWVPd25lclByb3ZpZGVyID0gKCkgPT4gQ29tcG9uZW50RXg7XG5cbi8qKlxuICogQSBwZXItY29tbWFuZCB7QGxpbmsgTWVudUV2ZW50UmVnaXN0cmFyfSB0aGF0IGRlbGVnYXRlcyB0byBhIHNoYXJlZCByZWdpc3RyYXIgd2hpbGUgY29sbGVjdGluZyB0aGVcbiAqIHtAbGluayBEaXNwb3NhYmxlRXh9IGVhY2ggcmVnaXN0cmF0aW9uIHJldHVybnMsIHNvIGRpc3Bvc2luZyB0aGlzIHNjb3BlIHVucmVnaXN0ZXJzIGV4YWN0bHkgdGhhdCBjb21tYW5kJ3NcbiAqIG1lbnUgZXZlbnRzLiBBIGhhbmRsZXIgbWF5IGtlZXAgdGhlIHNjb3BlIHBhc3Qge0BsaW5rIENvbW1hbmRIYW5kbGVyLm9uUmVnaXN0ZXJlZH0gYW5kIHJlZ2lzdGVyIG1lbnUgZXZlbnRzXG4gKiBsYXRlciBcdTIwMTQgYSBicmlkZ2UgYmluZGluZyBhdCBsYXlvdXQtcmVhZHksIHNheSBcdTIwMTQgc28gYSByZWdpc3RyYXRpb24gdGhhdCBhcnJpdmVzIGFmdGVyIHRoaXMgc2NvcGUgd2FzIGRpc3Bvc2VkXG4gKiBpcyBkaXNwb3NlZCBpbW1lZGlhdGVseSBpbnN0ZWFkIG9mIGxlYWtpbmcuXG4gKi9cbmNsYXNzIENvbW1hbmRNZW51RXZlbnRTY29wZSBleHRlbmRzIERpc3Bvc2FibGVCYXNlIGltcGxlbWVudHMgTWVudUV2ZW50UmVnaXN0cmFyIHtcbiAgcHJpdmF0ZSByZWFkb25seSBkaXNwb3NhYmxlczogRGlzcG9zYWJsZUV4W10gPSBbXTtcblxuICBwdWJsaWMgY29uc3RydWN0b3IocHJpdmF0ZSByZWFkb25seSBpbm5lcjogTWVudUV2ZW50UmVnaXN0cmFyKSB7XG4gICAgc3VwZXIoKTtcbiAgfVxuXG4gIHB1YmxpYyByZWdpc3RlckVkaXRvck1lbnVFdmVudEhhbmRsZXIoaGFuZGxlcjogRWRpdG9yTWVudUV2ZW50SGFuZGxlcik6IERpc3Bvc2FibGVFeCB7XG4gICAgcmV0dXJuIHRoaXMuY29sbGVjdCh0aGlzLmlubmVyLnJlZ2lzdGVyRWRpdG9yTWVudUV2ZW50SGFuZGxlcihoYW5kbGVyKSk7XG4gIH1cblxuICBwdWJsaWMgcmVnaXN0ZXJGaWxlTWVudUV2ZW50SGFuZGxlcihoYW5kbGVyOiBGaWxlTWVudUV2ZW50SGFuZGxlcik6IERpc3Bvc2FibGVFeCB7XG4gICAgcmV0dXJuIHRoaXMuY29sbGVjdCh0aGlzLmlubmVyLnJlZ2lzdGVyRmlsZU1lbnVFdmVudEhhbmRsZXIoaGFuZGxlcikpO1xuICB9XG5cbiAgcHVibGljIHJlZ2lzdGVyRmlsZXNNZW51RXZlbnRIYW5kbGVyKGhhbmRsZXI6IEZpbGVzTWVudUV2ZW50SGFuZGxlcik6IERpc3Bvc2FibGVFeCB7XG4gICAgcmV0dXJuIHRoaXMuY29sbGVjdCh0aGlzLmlubmVyLnJlZ2lzdGVyRmlsZXNNZW51RXZlbnRIYW5kbGVyKGhhbmRsZXIpKTtcbiAgfVxuXG4gIHB1YmxpYyByZWdpc3Rlck1hcmtkb3duVmlld3BvcnRNZW51RXZlbnRIYW5kbGVyKGhhbmRsZXI6IE1hcmtkb3duVmlld3BvcnRNZW51RXZlbnRIYW5kbGVyKTogRGlzcG9zYWJsZUV4IHtcbiAgICByZXR1cm4gdGhpcy5jb2xsZWN0KHRoaXMuaW5uZXIucmVnaXN0ZXJNYXJrZG93blZpZXdwb3J0TWVudUV2ZW50SGFuZGxlcihoYW5kbGVyKSk7XG4gIH1cblxuICBwcm90ZWN0ZWQgb3ZlcnJpZGUgcGVyZm9ybURpc3Bvc2UoKTogdm9pZCB7XG4gICAgZm9yIChjb25zdCBkaXNwb3NhYmxlIG9mIHRoaXMuZGlzcG9zYWJsZXMpIHtcbiAgICAgIGRpc3Bvc2FibGUuZGlzcG9zZSgpO1xuICAgIH1cbiAgICB0aGlzLmRpc3Bvc2FibGVzLmxlbmd0aCA9IDA7XG4gIH1cblxuICBwcml2YXRlIGNvbGxlY3QoZGlzcG9zYWJsZTogRGlzcG9zYWJsZUV4KTogRGlzcG9zYWJsZUV4IHtcbiAgICBpZiAodGhpcy5pc0Rpc3Bvc2VkKSB7XG4gICAgICBkaXNwb3NhYmxlLmRpc3Bvc2UoKTtcbiAgICB9IGVsc2Uge1xuICAgICAgdGhpcy5kaXNwb3NhYmxlcy5wdXNoKGRpc3Bvc2FibGUpO1xuICAgIH1cblxuICAgIHJldHVybiBkaXNwb3NhYmxlO1xuICB9XG59XG5cbi8qKlxuICogUmVnaXN0ZXJzIHtAbGluayBDb21tYW5kSGFuZGxlcn1zIHdpdGggT2JzaWRpYW4gYW5kIG1hbmFnZXMgdGhlaXIgbGlmZWN5Y2xlLlxuICpcbiAqIENhbGwge0BsaW5rIHJlZ2lzdGVyQ29tbWFuZEhhbmRsZXJzfSB0byByZWdpc3RlciBhIGJhdGNoIG9mIGhhbmRsZXJzIG9uIGRlbWFuZCAoYXMgbWFueSB0aW1lcyBhc1xuICogbmVlZGVkIHdoaWxlIHRoZSBjb21wb25lbnQgaXMgYWxpdmUpOyBkaXNwb3NlIHRoZSByZXR1cm5lZCB7QGxpbmsgRGlzcG9zYWJsZUV4fSB0byB1bnJlZ2lzdGVyIGV4YWN0bHlcbiAqIHRob3NlIGhhbmRsZXJzIFx1MjAxNCBpbmNsdWRpbmcgYW55IG1lbnUgZXZlbnRzIHRoZXkgcmVnaXN0ZXJlZCBcdTIwMTQgb3IgbGV0IHRoZSBiYXRjaCdzIExJRkVUSU1FIE9XTkVSIHVubG9hZCB0b1xuICogcmVtb3ZlIGV2ZXJ5IGNvbW1hbmQgc3RpbGwgcmVnaXN0ZXJlZCB0aHJvdWdoIGl0LlxuICpcbiAqIFRoYXQgb3duZXIgaXMgdGhpcyBjb21wb25lbnQgYnkgZGVmYXVsdCwgd2hpY2ggaXMgd2h5IGEgc3RhbmRhbG9uZSBjb21wb25lbnQgcmVtb3ZlcyBpdHMgb3duIGNvbW1hbmRzXG4gKiB3aGVuIGl0IHVubG9hZHMuIEl0IGlzIG92ZXJyaWRhYmxlIGJlY2F1c2UgdGhlIHJlZ2lzdGVyaW5nIGNvbXBvbmVudCBhbmQgdGhlIHJlZ2lzdGVyZWQgY29tbWFuZHMgZG8gbm90XG4gKiBhbHdheXMgc2hhcmUgYSBsaWZldGltZTogYFBsdWdpbkJhc2VgIGtlZXBzIE9ORSBvZiB0aGVzZSBydW5uaW5nIGZvciB0aGUgd2hvbGUgbGlmZSBvZiB0aGUgcGx1Z2luIFx1MjAxNCBpdCBpc1xuICogd2hhdCB0aGUgXCJ5b3VyIGRlcGVuZGVuY3kgd2VudCBhd2F5XCIgbm90aWNlIGlzIGJ1aWx0IGJlc2lkZSBcdTIwMTQgd2hpbGUgdGhlIGNvbW1hbmRzIGEgc3ViY2xhc3MgcmVnaXN0ZXJzIGZyb21cbiAqIGBvbmxvYWRJbXBsYCBiZWxvbmcgdG8gdGhlIGZlYXR1cmUgc3VyZmFjZSB0aGUgZ2F0ZSB0ZWFycyBkb3duIGFuZCByZWJ1aWxkcyB1bmRlcm5lYXRoIGl0LiBTbyB0aGUgb3duZXIgaXNcbiAqIHJlc29sdmVkIHBlciBjYWxsLCBmcm9tIGEge0BsaW5rIENvbW1hbmRMaWZldGltZU93bmVyUHJvdmlkZXJ9IG9yIGZyb20gdGhlIGNhbGwncyBvd24gYGxpZmV0aW1lT3duZXJgLlxuICpcbiAqIFRoZSBzYW1lIGhhbmRsZXJzIGFyZSBmZWQgdG8gZXZlcnkgbWVudSBzdXJmYWNlIHRoZSBjb21wb25lbnQga25vd3MgYWJvdXQ6IE9ic2lkaWFuJ3Mgb3duIHdvcmtzcGFjZVxuICogZXZlbnRzLCBwbHVzIGVhY2ggYWRkaXRpb25hbCB7QGxpbmsgTWVudUV2ZW50UmVnaXN0cmFyfSBicmlkZ2luZyBhbm90aGVyIHBsdWdpbidzIG1lbnVzLlxuICovXG5leHBvcnQgY2xhc3MgQ29tbWFuZEhhbmRsZXJDb21wb25lbnQgZXh0ZW5kcyBDb21wb25lbnRFeCB7XG4gIC8qKlxuICAgKiBQcm92aWRlciBmb3IgYWNjZXNzaW5nIHRoZSBjdXJyZW50bHkgYWN0aXZlIGZpbGUuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgYWN0aXZlRmlsZVByb3ZpZGVyOiBBY3RpdmVGaWxlUHJvdmlkZXI7XG5cbiAgLyoqXG4gICAqIFJlZ2lzdHJhcnMgZm9yIG1lbnUgc3VyZmFjZXMgdGhhdCBidWlsZCB0aGVpciBvd24gcGx1Z2luLXRpdGxlZCBwYXJlbnQgZW50cnksIGFuZCB0aGVyZWZvcmUgdGFrZVxuICAgKiB0aGUgaGFuZGxlcnMgd2l0aCB0aGVpciBzZWN0aW9uIHN1Ym1lbnUgZm9yY2VkIG9mZi5cbiAgICovXG4gIHByb3RlY3RlZCByZWFkb25seSBhZGRpdGlvbmFsTWVudUV2ZW50UmVnaXN0cmFyczogcmVhZG9ubHkgTWVudUV2ZW50UmVnaXN0cmFyW107XG5cbiAgLyoqXG4gICAqIFJlZ2lzdHJhciB1c2VkIHRvIGFkZCBhbmQgcmVtb3ZlIGNvbW1hbmRzIHdpdGggT2JzaWRpYW4uXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgY29tbWFuZFJlZ2lzdHJhcjogQ29tbWFuZFJlZ2lzdHJhcjtcblxuICAvKipcbiAgICogUmVnaXN0cmFyIGZvciBtZW51IGV2ZW50IGhhbmRsZXJzLlxuICAgKi9cbiAgcHJvdGVjdGVkIHJlYWRvbmx5IG1lbnVFdmVudFJlZ2lzdHJhcjogTWVudUV2ZW50UmVnaXN0cmFyO1xuXG4gIC8qKlxuICAgKiBUaGUgbmFtZSBvZiB0aGUgcGx1Z2luIHRoYXQgb3ducyB0aGUgY29tbWFuZHMuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgcGx1Z2luTmFtZTogc3RyaW5nO1xuXG4gIHByaXZhdGUgcmVhZG9ubHkgY29tbWFuZExpZmV0aW1lT3duZXJQcm92aWRlcjogQ29tbWFuZExpZmV0aW1lT3duZXJQcm92aWRlcjtcblxuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBjb21tYW5kIGhhbmRsZXIgY29tcG9uZW50LlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIGNvbnN0cnVjdG9yIHBhcmFtZXRlcnMuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocGFyYW1zOiBDb21tYW5kSGFuZGxlckNvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zKSB7XG4gICAgc3VwZXIoKTtcbiAgICB0aGlzLmFjdGl2ZUZpbGVQcm92aWRlciA9IHBhcmFtcy5hY3RpdmVGaWxlUHJvdmlkZXI7XG4gICAgdGhpcy5tZW51RXZlbnRSZWdpc3RyYXIgPSBwYXJhbXMubWVudUV2ZW50UmVnaXN0cmFyO1xuICAgIHRoaXMuYWRkaXRpb25hbE1lbnVFdmVudFJlZ2lzdHJhcnMgPSBwYXJhbXMuYWRkaXRpb25hbE1lbnVFdmVudFJlZ2lzdHJhcnMgPz8gW107XG4gICAgdGhpcy5jb21tYW5kUmVnaXN0cmFyID0gcGFyYW1zLmNvbW1hbmRSZWdpc3RyYXI7XG4gICAgdGhpcy5wbHVnaW5OYW1lID0gcGFyYW1zLnBsdWdpbk5hbWU7XG4gICAgdGhpcy5jb21tYW5kTGlmZXRpbWVPd25lclByb3ZpZGVyID0gcGFyYW1zLmNvbW1hbmRMaWZldGltZU93bmVyUHJvdmlkZXIgPz8gKCgpOiBDb21wb25lbnRFeCA9PiB0aGlzKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBCdWlsZHMgdGhlIGNvbW1hbmQgaGFuZGxlcnMgYW5kIHJlZ2lzdGVycyB0aGVtIHdpdGggT2JzaWRpYW4sIGdpdmluZyBlYWNoIGl0cyBvd24gcnVudGltZVxuICAgKiByZWdpc3RyYXRpb24gY29udGV4dC4gRWFjaCBoYW5kbGVyJ3MgY29tbWFuZCBpcyBhZGRlZCBpbW1lZGlhdGVseTsgdGhlIHJldHVybmVkXG4gICAqIHtAbGluayBEaXNwb3NhYmxlRXh9IHJlbW92ZXMgdGhlIGNvbW1hbmRzIHJlZ2lzdGVyZWQgYnkgdGhpcyBjYWxsIFx1MjAxNCBhbmQgYW55IG1lbnUgZXZlbnRzIHRob3NlXG4gICAqIGhhbmRsZXJzIHJlZ2lzdGVyZWQgdmlhIHRoZWlyIGNvbnRleHQncyB7QGxpbmsgTWVudUV2ZW50UmVnaXN0cmFyfSBcdTIwMTQgd2hlbiBkaXNwb3NlZC4gQW55IGNvbW1hbmRcbiAgICogc3RpbGwgcmVnaXN0ZXJlZCB3aGVuIHRoZSBjb21wb25lbnQgdW5sb2FkcyBpcyByZW1vdmVkIGF1dG9tYXRpY2FsbHkuXG4gICAqXG4gICAqIFRoZSBmYWN0b3J5IGlzIGludm9rZWQgb25jZSBtb3JlIGZvciBldmVyeSBhZGRpdGlvbmFsIG1lbnUgc3VyZmFjZSwgc28gYSBwbHVnaW4gZGVjbGFyZXMgaXRzXG4gICAqIGhhbmRsZXJzIE9OQ0UgYW5kIGFsbCBzdXJmYWNlcyBhcmUgZmVkLiBUaG9zZSBleHRyYSBwYXNzZXMgYWRkIG5vIGNvbW1hbmRzIFx1MjAxNCB0aGUgcGFsZXR0ZSBhbHJlYWR5XG4gICAqIGhhcyBldmVyeSBjb21tYW5kIGZyb20gdGhlIGZpcnN0IHBhc3MuXG4gICAqXG4gICAqIFdoaWNoIGNvbXBvbmVudCdzIHVubG9hZCByZW1vdmVzIHRoZW0gaXMgdGhlIGNhbGxlcidzIHRvIGNob29zZTogYG9wdGlvbnMubGlmZXRpbWVPd25lcmAgZm9yIHRoaXMgb25lXG4gICAqIGJhdGNoLCBvdGhlcndpc2Ugd2hhdGV2ZXIgdGhpcyBjb21wb25lbnQncyB7QGxpbmsgQ29tbWFuZExpZmV0aW1lT3duZXJQcm92aWRlcn0gcmVzb2x2ZXMgdG8sIHdoaWNoXG4gICAqIGRlZmF1bHRzIHRvIHRoZSBjb21wb25lbnQgaXRzZWxmLiBBIGNvbW1hbmQgbXVzdCBuZXZlciBvdXRsaXZlIHRoZSBjb2xsYWJvcmF0b3JzIGl0cyBoYW5kbGVyIGNsb3Nlc1xuICAgKiBvdmVyIFx1MjAxNCBsZWZ0IG9uIGEgbG9uZ2VyLWxpdmVkIG93bmVyIGl0IHN0YXlzIGluIHRoZSBwYWxldHRlIGNhbGxpbmcgaW50byB0b3JuLWRvd24gb2JqZWN0cyBcdTIwMTQgc28gdGhlXG4gICAqIG93bmVyIHRvIG5hbWUgaXMgdGhlIHNob3J0ZXN0LWxpdmVkIHRoaW5nIHRoZSBiYXRjaCBkZXBlbmRzIG9uLlxuICAgKlxuICAgKiBAcGFyYW0gY29tbWFuZEhhbmRsZXJGYWN0b3J5IC0gQnVpbGRzIGEgZnJlc2ggc2V0IG9mIGNvbW1hbmQgaGFuZGxlcnMsIG9uY2UgcGVyIG1lbnUgc3VyZmFjZS5cbiAgICogQHBhcmFtIG9wdGlvbnMgLSBUaGUgcmVnaXN0cmF0aW9uIG9wdGlvbnMuXG4gICAqIEByZXR1cm5zIEEge0BsaW5rIERpc3Bvc2FibGVFeH0gdGhhdCB1bnJlZ2lzdGVycyB0aGUgaGFuZGxlcnMgKGNvbW1hbmRzICsgbWVudSBldmVudHMpIHJlZ2lzdGVyZWQgYnkgdGhpcyBjYWxsLlxuICAgKi9cbiAgcHVibGljIGFzeW5jIHJlZ2lzdGVyQ29tbWFuZEhhbmRsZXJzKGNvbW1hbmRIYW5kbGVyRmFjdG9yeTogQ29tbWFuZEhhbmRsZXJGYWN0b3J5LCBvcHRpb25zPzogQ29tbWFuZEhhbmRsZXJDb21wb25lbnRSZWdpc3RlckNvbW1hbmRIYW5kbGVyc09wdGlvbnMpOiBQcm9taXNlPERpc3Bvc2FibGVFeD4ge1xuICAgIC8vIFJlc29sdmVkIHBlciBjYWxsLCBuZXZlciBjYXB0dXJlZCBhdCBjb25zdHJ1Y3Rpb246IGEgcHJvdmlkZXIncyBhbnN3ZXIgY2hhbmdlcyBvdmVyIHRoZSBjb21wb25lbnQnc1xuICAgIC8vIGxpZmUuIGBQbHVnaW5CYXNlYCByZXR1cm5zIHRoZSB3cmFwcGVyIGhvbGRpbmcgdGhlIGZlYXR1cmUgc3VyZmFjZSwgYW5kIHRoYXQgd3JhcHBlciBpcyByZXBsYWNlZFxuICAgIC8vIHdob2xlc2FsZSBvbiBldmVyeSBnYXRlIGN5Y2xlIFx1MjAxNCBzbyB0aGlzIGN5Y2xlJ3MgY29tbWFuZHMgaGF2ZSB0byBsYW5kIG9uIHRoaXMgY3ljbGUncyB3cmFwcGVyLlxuICAgIGNvbnN0IGxpZmV0aW1lT3duZXIgPSBvcHRpb25zPy5saWZldGltZU93bmVyID8/IHRoaXMuY29tbWFuZExpZmV0aW1lT3duZXJQcm92aWRlcigpO1xuICAgIGNvbnN0IGRpc3Bvc2FibGVzOiBEaXNwb3NhYmxlW10gPSBbXTtcbiAgICBmb3IgKGNvbnN0IGNvbW1hbmRIYW5kbGVyIG9mIGNvbW1hbmRIYW5kbGVyRmFjdG9yeSgpKSB7XG4gICAgICBjb25zdCBjb21tYW5kID0gY29tbWFuZEhhbmRsZXIuYnVpbGRDb21tYW5kKCk7XG4gICAgICAvLyBDYXB0dXJlIHRoZSBpZCBiZWZvcmUgcmVnaXN0ZXJpbmcuIGBQbHVnaW4uYWRkQ29tbWFuZGAgbXV0YXRlcyBgY29tbWFuZC5pZGAgKHByZWZpeGluZyBpdCB3aXRoXG4gICAgICAvLyBgdGhpcy5tYW5pZmVzdC5pZGApLCB3aGlsZSBgUGx1Z2luLnJlbW92ZUNvbW1hbmRgIHJlLXByZWZpeGVzIFx1MjAxNCBzbyByZW1vdmFsIG5lZWRzIHRoZSBvcmlnaW5hbCBpZC5cbiAgICAgIC8vIFJlYWRpbmcgYGNvbW1hbmQuaWRgIGFmdGVyIGBhZGRDb21tYW5kYCB3b3VsZCBkb3VibGUtcHJlZml4IGl0LCBzbyB0aGUgY29tbWFuZCBpcyBuZXZlciByZW1vdmVkLlxuICAgICAgY29uc3QgY29tbWFuZElkID0gY29tbWFuZC5pZDtcbiAgICAgIHRoaXMuY29tbWFuZFJlZ2lzdHJhci5hZGRDb21tYW5kKGNvbW1hbmQpO1xuXG4gICAgICAvLyBFYWNoIGNvbW1hbmQgZ2V0cyBpdHMgb3duIHJlZ2lzdHJhdGlvbiBjb250ZXh0IHdpdGggYSBwZXItY29tbWFuZCBtZW51LWV2ZW50IHNjb3BlLCBzbyBkaXNwb3Npbmcgb25lXG4gICAgICAvLyBjb21tYW5kIHRlYXJzIGRvd24gaXRzIG93biBtZW51IGV2ZW50cyB3aXRob3V0IGFmZmVjdGluZyB0aGUgb3RoZXJzLlxuICAgICAgY29uc3QgbWVudUV2ZW50U2NvcGUgPSBhd2FpdCB0aGlzLnJlZ2lzdGVyTWVudUV2ZW50SGFuZGxlcnMoeyBjb21tYW5kSGFuZGxlciwgbWVudUV2ZW50UmVnaXN0cmFyOiB0aGlzLm1lbnVFdmVudFJlZ2lzdHJhciB9KTtcblxuICAgICAgY29uc3QgZGlzcG9zYWJsZSA9IG5ldyBDYWxsYmFja0Rpc3Bvc2FibGUoe1xuICAgICAgICBjYWxsYmFjazogKCk6IHZvaWQgPT4ge1xuICAgICAgICAgIHRoaXMuY29tbWFuZFJlZ2lzdHJhci5yZW1vdmVDb21tYW5kKGNvbW1hbmRJZCk7XG4gICAgICAgICAgbWVudUV2ZW50U2NvcGUuZGlzcG9zZSgpO1xuICAgICAgICB9XG4gICAgICB9KTtcbiAgICAgIC8vIFRpZSByZW1vdmFsIHRvIHRoZSBsaWZldGltZSBvd25lcidzIHVubG9hZCwgc28gYSBjb21tYW5kIG5ldmVyIG91dGxpdmVzIHdoYXQgaXQgY2FsbHMgaW50by5cbiAgICAgIGRpc3Bvc2FibGVzLnB1c2gobGlmZXRpbWVPd25lci5yZWdpc3RlckRpc3Bvc2FibGUoZGlzcG9zYWJsZSkpO1xuICAgIH1cblxuICAgIC8vIEV2ZXJ5IGFkZGl0aW9uYWwgc3VyZmFjZSBnZXRzIGl0cyBPV04gaGFuZGxlciBpbnN0YW5jZXMgXHUyMDE0IGEgaGFuZGxlciBjYXJyaWVzIHBlci1yZWdpc3RyYXRpb25cbiAgICAvLyBzdGF0ZSwgc28gb25lIGluc3RhbmNlIGNhbm5vdCBzZXJ2ZSB0d28gc3VyZmFjZXMgXHUyMDE0IGFuZCB0YWtlcyB0aGVtIHdpdGggdGhlIHNlY3Rpb24gc3VibWVudVxuICAgIC8vIGZvcmNlZCBvZmYsIGJlY2F1c2Ugc3VjaCBhIHN1cmZhY2Ugd3JhcHMgZXZlcnl0aGluZyBpbiBhIHBsdWdpbi10aXRsZWQgcGFyZW50IGVudHJ5IG9mIGl0cyBvd24uXG4gICAgZm9yIChjb25zdCBhZGRpdGlvbmFsTWVudUV2ZW50UmVnaXN0cmFyIG9mIHRoaXMuYWRkaXRpb25hbE1lbnVFdmVudFJlZ2lzdHJhcnMpIHtcbiAgICAgIGZvciAoY29uc3QgY29tbWFuZEhhbmRsZXIgb2YgY29tbWFuZEhhbmRsZXJGYWN0b3J5KCkpIHtcbiAgICAgICAgZGlzcG9zYWJsZXMucHVzaChsaWZldGltZU93bmVyLnJlZ2lzdGVyRGlzcG9zYWJsZShhd2FpdCB0aGlzLnJlZ2lzdGVyTWVudUV2ZW50SGFuZGxlcnMoeyBjb21tYW5kSGFuZGxlciwgbWVudUV2ZW50UmVnaXN0cmFyOiBhZGRpdGlvbmFsTWVudUV2ZW50UmVnaXN0cmFyLCBzaG91bGRBZGRDb21tYW5kVG9TdWJtZW51OiBmYWxzZSB9KSkpO1xuICAgICAgfVxuICAgIH1cblxuICAgIHJldHVybiBuZXcgQ29tYmluZURpc3Bvc2FibGUoeyBkaXNwb3NhYmxlcyB9KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBIYW5kcyBhIGNvbW1hbmQgaGFuZGxlciBpdHMgcmVnaXN0cmF0aW9uIGNvbnRleHQsIHNjb3BlZCBzbyB0aGF0IGRpc3Bvc2luZyB0aGUgcmV0dXJuZWQgc2NvcGVcbiAgICogdW5yZWdpc3RlcnMgZXhhY3RseSB0aGUgbWVudSBldmVudHMgdGhhdCBoYW5kbGVyIHJlZ2lzdGVyZWQuXG4gICAqXG4gICAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycyBmb3IgdGhpcyByZWdpc3RyYXRpb24uXG4gICAqIEByZXR1cm5zIFRoZSBoYW5kbGVyJ3MgbWVudS1ldmVudCBzY29wZS5cbiAgICovXG4gIHByaXZhdGUgYXN5bmMgcmVnaXN0ZXJNZW51RXZlbnRIYW5kbGVycyhwYXJhbXM6IENvbW1hbmRIYW5kbGVyQ29tcG9uZW50UmVnaXN0ZXJNZW51RXZlbnRIYW5kbGVyc1BhcmFtcyk6IFByb21pc2U8Q29tbWFuZE1lbnVFdmVudFNjb3BlPiB7XG4gICAgY29uc3QgbWVudUV2ZW50U2NvcGUgPSBuZXcgQ29tbWFuZE1lbnVFdmVudFNjb3BlKHBhcmFtcy5tZW51RXZlbnRSZWdpc3RyYXIpO1xuICAgIGNvbnN0IGNvbnRleHQ6IENvbW1hbmRIYW5kbGVyUmVnaXN0cmF0aW9uQ29udGV4dCA9IHtcbiAgICAgIGFjdGl2ZUZpbGVQcm92aWRlcjogdGhpcy5hY3RpdmVGaWxlUHJvdmlkZXIsXG4gICAgICBtZW51RXZlbnRSZWdpc3RyYXI6IG1lbnVFdmVudFNjb3BlLFxuICAgICAgcGx1Z2luTmFtZTogdGhpcy5wbHVnaW5OYW1lLFxuICAgICAgc2hvdWxkQWRkQ29tbWFuZFRvU3VibWVudTogcGFyYW1zLnNob3VsZEFkZENvbW1hbmRUb1N1Ym1lbnVcbiAgICB9O1xuICAgIGF3YWl0IHBhcmFtcy5jb21tYW5kSGFuZGxlci5vblJlZ2lzdGVyZWQoY29udGV4dCk7XG4gICAgcmV0dXJuIG1lbnVFdmVudFNjb3BlO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBUUE7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxPQUNLO0FBZ0JQLFNBQVMsbUJBQW1CO0FBMkU1QixNQUFNLDhCQUE4QixlQUE2QztBQUFBLEVBR3hFLFlBQTZCLE9BQTJCO0FBQzdELFVBQU07QUFENEI7QUFBQSxFQUVwQztBQUFBLEVBRm9DO0FBQUEsRUFGbkIsY0FBOEIsQ0FBQztBQUFBLEVBTXpDLCtCQUErQixTQUErQztBQUNuRixXQUFPLEtBQUssUUFBUSxLQUFLLE1BQU0sK0JBQStCLE9BQU8sQ0FBQztBQUFBLEVBQ3hFO0FBQUEsRUFFTyw2QkFBNkIsU0FBNkM7QUFDL0UsV0FBTyxLQUFLLFFBQVEsS0FBSyxNQUFNLDZCQUE2QixPQUFPLENBQUM7QUFBQSxFQUN0RTtBQUFBLEVBRU8sOEJBQThCLFNBQThDO0FBQ2pGLFdBQU8sS0FBSyxRQUFRLEtBQUssTUFBTSw4QkFBOEIsT0FBTyxDQUFDO0FBQUEsRUFDdkU7QUFBQSxFQUVPLHlDQUF5QyxTQUF5RDtBQUN2RyxXQUFPLEtBQUssUUFBUSxLQUFLLE1BQU0seUNBQXlDLE9BQU8sQ0FBQztBQUFBLEVBQ2xGO0FBQUEsRUFFbUIsaUJBQXVCO0FBQ3hDLGVBQVcsY0FBYyxLQUFLLGFBQWE7QUFDekMsaUJBQVcsUUFBUTtBQUFBLElBQ3JCO0FBQ0EsU0FBSyxZQUFZLFNBQVM7QUFBQSxFQUM1QjtBQUFBLEVBRVEsUUFBUSxZQUF3QztBQUN0RCxRQUFJLEtBQUssWUFBWTtBQUNuQixpQkFBVyxRQUFRO0FBQUEsSUFDckIsT0FBTztBQUNMLFdBQUssWUFBWSxLQUFLLFVBQVU7QUFBQSxJQUNsQztBQUVBLFdBQU87QUFBQSxFQUNUO0FBQ0Y7QUFvQk8sTUFBTSxnQ0FBZ0MsWUFBWTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBSXBDO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU1BO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFLQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBS0E7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtBO0FBQUEsRUFFRjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9WLFlBQVksUUFBa0Q7QUFDbkUsVUFBTTtBQUNOLFNBQUsscUJBQXFCLE9BQU87QUFDakMsU0FBSyxxQkFBcUIsT0FBTztBQUNqQyxTQUFLLGdDQUFnQyxPQUFPLGlDQUFpQyxDQUFDO0FBQzlFLFNBQUssbUJBQW1CLE9BQU87QUFDL0IsU0FBSyxhQUFhLE9BQU87QUFDekIsU0FBSywrQkFBK0IsT0FBTyxpQ0FBaUMsTUFBbUI7QUFBQSxFQUNqRztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBdUJBLE1BQWEsd0JBQXdCLHVCQUE4QyxTQUF3RjtBQUl6SyxVQUFNLGdCQUFnQixTQUFTLGlCQUFpQixLQUFLLDZCQUE2QjtBQUNsRixVQUFNLGNBQTRCLENBQUM7QUFDbkMsZUFBVyxrQkFBa0Isc0JBQXNCLEdBQUc7QUFDcEQsWUFBTSxVQUFVLGVBQWUsYUFBYTtBQUk1QyxZQUFNLFlBQVksUUFBUTtBQUMxQixXQUFLLGlCQUFpQixXQUFXLE9BQU87QUFJeEMsWUFBTSxpQkFBaUIsTUFBTSxLQUFLLDBCQUEwQixFQUFFLGdCQUFnQixvQkFBb0IsS0FBSyxtQkFBbUIsQ0FBQztBQUUzSCxZQUFNLGFBQWEsSUFBSSxtQkFBbUI7QUFBQSxRQUN4QyxVQUFVLE1BQVk7QUFDcEIsZUFBSyxpQkFBaUIsY0FBYyxTQUFTO0FBQzdDLHlCQUFlLFFBQVE7QUFBQSxRQUN6QjtBQUFBLE1BQ0YsQ0FBQztBQUVELGtCQUFZLEtBQUssY0FBYyxtQkFBbUIsVUFBVSxDQUFDO0FBQUEsSUFDL0Q7QUFLQSxlQUFXLGdDQUFnQyxLQUFLLCtCQUErQjtBQUM3RSxpQkFBVyxrQkFBa0Isc0JBQXNCLEdBQUc7QUFDcEQsb0JBQVksS0FBSyxjQUFjLG1CQUFtQixNQUFNLEtBQUssMEJBQTBCLEVBQUUsZ0JBQWdCLG9CQUFvQiw4QkFBOEIsMkJBQTJCLE1BQU0sQ0FBQyxDQUFDLENBQUM7QUFBQSxNQUNqTTtBQUFBLElBQ0Y7QUFFQSxXQUFPLElBQUksa0JBQWtCLEVBQUUsWUFBWSxDQUFDO0FBQUEsRUFDOUM7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBU0EsTUFBYywwQkFBMEIsUUFBZ0c7QUFDdEksVUFBTSxpQkFBaUIsSUFBSSxzQkFBc0IsT0FBTyxrQkFBa0I7QUFDMUUsVUFBTSxVQUE2QztBQUFBLE1BQ2pELG9CQUFvQixLQUFLO0FBQUEsTUFDekIsb0JBQW9CO0FBQUEsTUFDcEIsWUFBWSxLQUFLO0FBQUEsTUFDakIsMkJBQTJCLE9BQU87QUFBQSxJQUNwQztBQUNBLFVBQU0sT0FBTyxlQUFlLGFBQWEsT0FBTztBQUNoRCxXQUFPO0FBQUEsRUFDVDtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/esm/command-handlers/command-handler.d.mts

@@ -0,0 +1,107 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Base class and interfaces for command handlers.
+ */
+import type { Command, IconName } from 'obsidian';
+import type { ActiveFileProvider } from '../active-file-provider.mjs';
+import type { MenuEventRegistrar } from '../menu-event-registrar.mjs';
+/**
+ * Parameters for creating a command handler.
+ */
+export interface CommandHandlerConstructorParams {
+    /**
+     * The icon for the command.
+     */
+    readonly icon: IconName;
+    /**
+     * The ID of the command.
+     */
+    readonly id: string;
+    /**
+     * The display name of the command.
+     */
+    readonly name: string;
+}
+/**
+ * Context provided to command handlers during registration.
+ */
+export interface CommandHandlerRegistrationContext {
+    /**
+     * Provider for accessing the currently active file.
+     */
+    readonly activeFileProvider: ActiveFileProvider;
+    /**
+     * Registrar for menu event handlers.
+     */
+    readonly menuEventRegistrar: MenuEventRegistrar;
+    /**
+     * The name of the plugin that owns this command.
+     */
+    readonly pluginName: string;
+    /**
+     * Overrides the handler's own `shouldAddCommandToSubmenu`, or `undefined` to leave it alone.
+     *
+     * A menu surface that already wraps every contributed item in a plugin-titled parent entry — such as
+     * `NotebookNavigatorMenuEventRegistrarComponent` — sets this to `false`, because a handler declaring
+     * a section submenu of its own would make `Menu.sort()` nest a second plugin-titled entry inside the
+     * first. Only `AbstractFileCommandHandler` reads it: the surfaces that need it bridge file and
+     * folder menus, never the editor menu.
+     */
+    readonly shouldAddCommandToSubmenu?: boolean | undefined;
+}
+/**
+ * Base class for command handlers.
+ *
+ * Unlike the Obsidian {@link Command} interface, handlers are never mutated by Obsidian.
+ * The {@link buildCommand} method produces a plain {@link Command} object for registration.
+ */
+export declare abstract class CommandHandler {
+    /**
+     * The icon for the command.
+     */
+    protected readonly icon: IconName;
+    /**
+     * The ID of the command.
+     */
+    protected readonly id: string;
+    /**
+     * The display name of the command.
+     */
+    protected readonly name: string;
+    /**
+     * Gets the plugin name.
+     *
+     * @returns The plugin name.
+     */
+    protected get pluginName(): string;
+    private _pluginName?;
+    /**
+     * Creates a new command handler.
+     *
+     * @param params - The parameters for the command handler.
+     */
+    constructor(params: CommandHandlerConstructorParams);
+    /**
+     * Builds a plain Obsidian {@link Command} object for registration.
+     *
+     * @returns A new {@link Command} object. Obsidian may mutate this object after registration.
+     */
+    abstract buildCommand(): Command;
+    /**
+     * Called after the command has been registered with Obsidian.
+     * Subclasses use the provided context to register menu event handlers.
+     *
+     * Throws when the same instance is registered twice. A handler stores per-registration state — the
+     * plugin name here, the active-file provider and the submenu override in `AbstractFileCommandHandler`,
+     * plus whatever a subclass records — and the menu closures registered here read that state lazily, at
+     * menu-render time. So a second registration silently rewrites what the first registration's closures
+     * will see. `CommandHandlerComponent` registers a handler set once per menu surface, which is why
+     * `CommandHandlerFactory` must build FRESH instances on every call; this guard turns a factory that
+     * hands out shared instances into a loud failure instead of a wrong context menu.
+     *
+     * @param context - The registration context providing runtime capabilities.
+     */
+    onRegistered(context: CommandHandlerRegistrationContext): Promise<void>;
+}

package/dist/lib/esm/command-handlers/command-handler.mjs

@@ -0,0 +1,111 @@
+/*
+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 { noopAsync } from "@mnaoumov/typescript-lib/function";
+import { ensureNonNullable } from "@mnaoumov/typescript-lib/type-guards";
+class CommandHandler {
+  /**
+   * The icon for the command.
+   */
+  icon;
+  /**
+   * The ID of the command.
+   */
+  id;
+  /**
+   * The display name of the command.
+   */
+  name;
+  /**
+   * Gets the plugin name.
+   *
+   * @returns The plugin name.
+   */
+  get pluginName() {
+    return ensureNonNullable(this._pluginName);
+  }
+  _pluginName;
+  /**
+   * Creates a new command handler.
+   *
+   * @param params - The parameters for the command handler.
+   */
+  constructor(params) {
+    this.icon = params.icon;
+    this.id = params.id;
+    this.name = params.name;
+  }
+  /**
+   * Called after the command has been registered with Obsidian.
+   * Subclasses use the provided context to register menu event handlers.
+   *
+   * Throws when the same instance is registered twice. A handler stores per-registration state — the
+   * plugin name here, the active-file provider and the submenu override in `AbstractFileCommandHandler`,
+   * plus whatever a subclass records — and the menu closures registered here read that state lazily, at
+   * menu-render time. So a second registration silently rewrites what the first registration's closures
+   * will see. `CommandHandlerComponent` registers a handler set once per menu surface, which is why
+   * `CommandHandlerFactory` must build FRESH instances on every call; this guard turns a factory that
+   * hands out shared instances into a loud failure instead of a wrong context menu.
+   *
+   * @param context - The registration context providing runtime capabilities.
+   */
+  async onRegistered(context) {
+    await noopAsync();
+    if (this._pluginName !== void 0) {
+      throw new Error(
+        `Command handler '${this.id}' is already registered. A command handler instance cannot be registered twice - the command handler factory must build fresh instances on every call.`
+      );
+    }
+    this._pluginName = context.pluginName;
+  }
+}
+export {
+  CommandHandler
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbW1hbmQtaGFuZGxlcnMvY29tbWFuZC1oYW5kbGVyLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQmFzZSBjbGFzcyBhbmQgaW50ZXJmYWNlcyBmb3IgY29tbWFuZCBoYW5kbGVycy5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7XG4gIENvbW1hbmQsXG4gIEljb25OYW1lXG59IGZyb20gJ29ic2lkaWFuJztcblxuaW1wb3J0IHsgbm9vcEFzeW5jIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL2Z1bmN0aW9uJztcbmltcG9ydCB7IGVuc3VyZU5vbk51bGxhYmxlIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL3R5cGUtZ3VhcmRzJztcblxuaW1wb3J0IHR5cGUgeyBBY3RpdmVGaWxlUHJvdmlkZXIgfSBmcm9tICcuLi9hY3RpdmUtZmlsZS1wcm92aWRlci50cyc7XG5pbXBvcnQgdHlwZSB7IE1lbnVFdmVudFJlZ2lzdHJhciB9IGZyb20gJy4uL21lbnUtZXZlbnQtcmVnaXN0cmFyLnRzJztcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciBjcmVhdGluZyBhIGNvbW1hbmQgaGFuZGxlci5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBDb21tYW5kSGFuZGxlckNvbnN0cnVjdG9yUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBpY29uIGZvciB0aGUgY29tbWFuZC5cbiAgICovXG4gIHJlYWRvbmx5IGljb246IEljb25OYW1lO1xuXG4gIC8qKlxuICAgKiBUaGUgSUQgb2YgdGhlIGNvbW1hbmQuXG4gICAqL1xuICByZWFkb25seSBpZDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgZGlzcGxheSBuYW1lIG9mIHRoZSBjb21tYW5kLlxuICAgKi9cbiAgcmVhZG9ubHkgbmFtZTogc3RyaW5nO1xufVxuXG4vKipcbiAqIENvbnRleHQgcHJvdmlkZWQgdG8gY29tbWFuZCBoYW5kbGVycyBkdXJpbmcgcmVnaXN0cmF0aW9uLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIENvbW1hbmRIYW5kbGVyUmVnaXN0cmF0aW9uQ29udGV4dCB7XG4gIC8qKlxuICAgKiBQcm92aWRlciBmb3IgYWNjZXNzaW5nIHRoZSBjdXJyZW50bHkgYWN0aXZlIGZpbGUuXG4gICAqL1xuICByZWFkb25seSBhY3RpdmVGaWxlUHJvdmlkZXI6IEFjdGl2ZUZpbGVQcm92aWRlcjtcblxuICAvKipcbiAgICogUmVnaXN0cmFyIGZvciBtZW51IGV2ZW50IGhhbmRsZXJzLlxuICAgKi9cbiAgcmVhZG9ubHkgbWVudUV2ZW50UmVnaXN0cmFyOiBNZW51RXZlbnRSZWdpc3RyYXI7XG5cbiAgLyoqXG4gICAqIFRoZSBuYW1lIG9mIHRoZSBwbHVnaW4gdGhhdCBvd25zIHRoaXMgY29tbWFuZC5cbiAgICovXG4gIHJlYWRvbmx5IHBsdWdpbk5hbWU6IHN0cmluZztcblxuICAvKipcbiAgICogT3ZlcnJpZGVzIHRoZSBoYW5kbGVyJ3Mgb3duIGBzaG91bGRBZGRDb21tYW5kVG9TdWJtZW51YCwgb3IgYHVuZGVmaW5lZGAgdG8gbGVhdmUgaXQgYWxvbmUuXG4gICAqXG4gICAqIEEgbWVudSBzdXJmYWNlIHRoYXQgYWxyZWFkeSB3cmFwcyBldmVyeSBjb250cmlidXRlZCBpdGVtIGluIGEgcGx1Z2luLXRpdGxlZCBwYXJlbnQgZW50cnkgXHUyMDE0IHN1Y2ggYXNcbiAgICogYE5vdGVib29rTmF2aWdhdG9yTWVudUV2ZW50UmVnaXN0cmFyQ29tcG9uZW50YCBcdTIwMTQgc2V0cyB0aGlzIHRvIGBmYWxzZWAsIGJlY2F1c2UgYSBoYW5kbGVyIGRlY2xhcmluZ1xuICAgKiBhIHNlY3Rpb24gc3VibWVudSBvZiBpdHMgb3duIHdvdWxkIG1ha2UgYE1lbnUuc29ydCgpYCBuZXN0IGEgc2Vjb25kIHBsdWdpbi10aXRsZWQgZW50cnkgaW5zaWRlIHRoZVxuICAgKiBmaXJzdC4gT25seSBgQWJzdHJhY3RGaWxlQ29tbWFuZEhhbmRsZXJgIHJlYWRzIGl0OiB0aGUgc3VyZmFjZXMgdGhhdCBuZWVkIGl0IGJyaWRnZSBmaWxlIGFuZFxuICAgKiBmb2xkZXIgbWVudXMsIG5ldmVyIHRoZSBlZGl0b3IgbWVudS5cbiAgICovXG4gIHJlYWRvbmx5IHNob3VsZEFkZENvbW1hbmRUb1N1Ym1lbnU/OiBib29sZWFuIHwgdW5kZWZpbmVkO1xufVxuXG4vKipcbiAqIEJhc2UgY2xhc3MgZm9yIGNvbW1hbmQgaGFuZGxlcnMuXG4gKlxuICogVW5saWtlIHRoZSBPYnNpZGlhbiB7QGxpbmsgQ29tbWFuZH0gaW50ZXJmYWNlLCBoYW5kbGVycyBhcmUgbmV2ZXIgbXV0YXRlZCBieSBPYnNpZGlhbi5cbiAqIFRoZSB7QGxpbmsgYnVpbGRDb21tYW5kfSBtZXRob2QgcHJvZHVjZXMgYSBwbGFpbiB7QGxpbmsgQ29tbWFuZH0gb2JqZWN0IGZvciByZWdpc3RyYXRpb24uXG4gKi9cbmV4cG9ydCBhYnN0cmFjdCBjbGFzcyBDb21tYW5kSGFuZGxlciB7XG4gIC8qKlxuICAgKiBUaGUgaWNvbiBmb3IgdGhlIGNvbW1hbmQuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgaWNvbjogSWNvbk5hbWU7XG5cbiAgLyoqXG4gICAqIFRoZSBJRCBvZiB0aGUgY29tbWFuZC5cbiAgICovXG4gIHByb3RlY3RlZCByZWFkb25seSBpZDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgZGlzcGxheSBuYW1lIG9mIHRoZSBjb21tYW5kLlxuICAgKi9cbiAgcHJvdGVjdGVkIHJlYWRvbmx5IG5hbWU6IHN0cmluZztcblxuICAvKipcbiAgICogR2V0cyB0aGUgcGx1Z2luIG5hbWUuXG4gICAqXG4gICAqIEByZXR1cm5zIFRoZSBwbHVnaW4gbmFtZS5cbiAgICovXG4gIHByb3RlY3RlZCBnZXQgcGx1Z2luTmFtZSgpOiBzdHJpbmcge1xuICAgIHJldHVybiBlbnN1cmVOb25OdWxsYWJsZSh0aGlzLl9wbHVnaW5OYW1lKTtcbiAgfVxuXG4gIHByaXZhdGUgX3BsdWdpbk5hbWU/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgY29tbWFuZCBoYW5kbGVyLlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBhcmFtZXRlcnMgZm9yIHRoZSBjb21tYW5kIGhhbmRsZXIuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocGFyYW1zOiBDb21tYW5kSGFuZGxlckNvbnN0cnVjdG9yUGFyYW1zKSB7XG4gICAgdGhpcy5pY29uID0gcGFyYW1zLmljb247XG4gICAgdGhpcy5pZCA9IHBhcmFtcy5pZDtcbiAgICB0aGlzLm5hbWUgPSBwYXJhbXMubmFtZTtcbiAgfVxuXG4gIC8qKlxuICAgKiBCdWlsZHMgYSBwbGFpbiBPYnNpZGlhbiB7QGxpbmsgQ29tbWFuZH0gb2JqZWN0IGZvciByZWdpc3RyYXRpb24uXG4gICAqXG4gICAqIEByZXR1cm5zIEEgbmV3IHtAbGluayBDb21tYW5kfSBvYmplY3QuIE9ic2lkaWFuIG1heSBtdXRhdGUgdGhpcyBvYmplY3QgYWZ0ZXIgcmVnaXN0cmF0aW9uLlxuICAgKi9cbiAgcHVibGljIGFic3RyYWN0IGJ1aWxkQ29tbWFuZCgpOiBDb21tYW5kO1xuXG4gIC8qKlxuICAgKiBDYWxsZWQgYWZ0ZXIgdGhlIGNvbW1hbmQgaGFzIGJlZW4gcmVnaXN0ZXJlZCB3aXRoIE9ic2lkaWFuLlxuICAgKiBTdWJjbGFzc2VzIHVzZSB0aGUgcHJvdmlkZWQgY29udGV4dCB0byByZWdpc3RlciBtZW51IGV2ZW50IGhhbmRsZXJzLlxuICAgKlxuICAgKiBUaHJvd3Mgd2hlbiB0aGUgc2FtZSBpbnN0YW5jZSBpcyByZWdpc3RlcmVkIHR3aWNlLiBBIGhhbmRsZXIgc3RvcmVzIHBlci1yZWdpc3RyYXRpb24gc3RhdGUgXHUyMDE0IHRoZVxuICAgKiBwbHVnaW4gbmFtZSBoZXJlLCB0aGUgYWN0aXZlLWZpbGUgcHJvdmlkZXIgYW5kIHRoZSBzdWJtZW51IG92ZXJyaWRlIGluIGBBYnN0cmFjdEZpbGVDb21tYW5kSGFuZGxlcmAsXG4gICAqIHBsdXMgd2hhdGV2ZXIgYSBzdWJjbGFzcyByZWNvcmRzIFx1MjAxNCBhbmQgdGhlIG1lbnUgY2xvc3VyZXMgcmVnaXN0ZXJlZCBoZXJlIHJlYWQgdGhhdCBzdGF0ZSBsYXppbHksIGF0XG4gICAqIG1lbnUtcmVuZGVyIHRpbWUuIFNvIGEgc2Vjb25kIHJlZ2lzdHJhdGlvbiBzaWxlbnRseSByZXdyaXRlcyB3aGF0IHRoZSBmaXJzdCByZWdpc3RyYXRpb24ncyBjbG9zdXJlc1xuICAgKiB3aWxsIHNlZS4gYENvbW1hbmRIYW5kbGVyQ29tcG9uZW50YCByZWdpc3RlcnMgYSBoYW5kbGVyIHNldCBvbmNlIHBlciBtZW51IHN1cmZhY2UsIHdoaWNoIGlzIHdoeVxuICAgKiBgQ29tbWFuZEhhbmRsZXJGYWN0b3J5YCBtdXN0IGJ1aWxkIEZSRVNIIGluc3RhbmNlcyBvbiBldmVyeSBjYWxsOyB0aGlzIGd1YXJkIHR1cm5zIGEgZmFjdG9yeSB0aGF0XG4gICAqIGhhbmRzIG91dCBzaGFyZWQgaW5zdGFuY2VzIGludG8gYSBsb3VkIGZhaWx1cmUgaW5zdGVhZCBvZiBhIHdyb25nIGNvbnRleHQgbWVudS5cbiAgICpcbiAgICogQHBhcmFtIGNvbnRleHQgLSBUaGUgcmVnaXN0cmF0aW9uIGNvbnRleHQgcHJvdmlkaW5nIHJ1bnRpbWUgY2FwYWJpbGl0aWVzLlxuICAgKi9cbiAgcHVibGljIGFzeW5jIG9uUmVnaXN0ZXJlZChjb250ZXh0OiBDb21tYW5kSGFuZGxlclJlZ2lzdHJhdGlvbkNvbnRleHQpOiBQcm9taXNlPHZvaWQ+IHtcbiAgICBhd2FpdCBub29wQXN5bmMoKTtcbiAgICBpZiAodGhpcy5fcGx1Z2luTmFtZSAhPT0gdW5kZWZpbmVkKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoXG4gICAgICAgIGBDb21tYW5kIGhhbmRsZXIgJyR7dGhpcy5pZH0nIGlzIGFscmVhZHkgcmVnaXN0ZXJlZC4gQSBjb21tYW5kIGhhbmRsZXIgaW5zdGFuY2UgY2Fubm90IGJlIHJlZ2lzdGVyZWQgdHdpY2UgLSB0aGUgY29tbWFuZCBoYW5kbGVyIGZhY3RvcnkgbXVzdCBidWlsZCBmcmVzaCBpbnN0YW5jZXMgb24gZXZlcnkgY2FsbC5gXG4gICAgICApO1xuICAgIH1cblxuICAgIHRoaXMuX3BsdWdpbk5hbWUgPSBjb250ZXh0LnBsdWdpbk5hbWU7XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFXQSxTQUFTLGlCQUFpQjtBQUMxQixTQUFTLHlCQUF5QjtBQThEM0IsTUFBZSxlQUFlO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFJaEI7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFLQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9uQixJQUFjLGFBQXFCO0FBQ2pDLFdBQU8sa0JBQWtCLEtBQUssV0FBVztBQUFBLEVBQzNDO0FBQUEsRUFFUTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9ELFlBQVksUUFBeUM7QUFDMUQsU0FBSyxPQUFPLE9BQU87QUFDbkIsU0FBSyxLQUFLLE9BQU87QUFDakIsU0FBSyxPQUFPLE9BQU87QUFBQSxFQUNyQjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQXVCQSxNQUFhLGFBQWEsU0FBMkQ7QUFDbkYsVUFBTSxVQUFVO0FBQ2hCLFFBQUksS0FBSyxnQkFBZ0IsUUFBVztBQUNsQyxZQUFNLElBQUk7QUFBQSxRQUNSLG9CQUFvQixLQUFLLEVBQUU7QUFBQSxNQUM3QjtBQUFBLElBQ0Y7QUFFQSxTQUFLLGNBQWMsUUFBUTtBQUFBLEVBQzdCO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/command-handlers/editor-command-handler.d.mts

@@ -0,0 +1,208 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Command handler for editor commands with optional editor menu integration.
+ */
+import type { Command, Editor, IconName, MarkdownFileInfo, MarkdownView, Menu } from 'obsidian';
+import type { Promisable } from 'type-fest';
+import type { CommandHandlerConstructorParams, CommandHandlerRegistrationContext } from './command-handler.mjs';
+import { CommandHandler } from './command-handler.mjs';
+/**
+ * Parameters for creating an editor command handler.
+ */
+export interface EditorCommandHandlerConstructorParams extends CommandHandlerConstructorParams {
+    /**
+     * The item name to use in the editor menu.
+     */
+    readonly editorMenuItemName?: string | undefined;
+    /**
+     * The section to use in the editor menu.
+     */
+    readonly editorMenuSection?: string | undefined;
+    /**
+     * The icon to use in the editor menu submenu.
+     */
+    readonly editorMenuSubmenuIcon?: IconName | undefined;
+    /**
+     * Whether to add the command to a submenu.
+     *
+     * @default `false`
+     */
+    readonly shouldAddCommandToSubmenu?: boolean | undefined;
+}
+/**
+ * Parameters for {@link EditorCommandHandler.editorCheckCallback}.
+ */
+export interface EditorCommandHandlerEditorCheckCallbackParams {
+    /**
+     * Whether Obsidian is only checking availability (not executing).
+     */
+    readonly checking: boolean;
+    /**
+     * The markdown file context.
+     */
+    readonly context: MarkdownFileInfo;
+    /**
+     * The editor instance.
+     */
+    readonly editor: Editor;
+}
+/**
+ * Parameters for {@link EditorCommandHandler.handleEditorMenu}.
+ */
+export interface EditorCommandHandlerHandleEditorMenuParams {
+    /**
+     * The markdown file context.
+     */
+    readonly context: MarkdownFileInfo;
+    /**
+     * The editor instance.
+     */
+    readonly editor: Editor;
+    /**
+     * The menu to add items to.
+     */
+    readonly menu: Menu;
+}
+/**
+ * Parameters for {@link EditorCommandHandler.handleViewportMenu}.
+ */
+export interface EditorCommandHandlerHandleViewportMenuParams {
+    /**
+     * The menu to add items to.
+     */
+    readonly menu: Menu;
+    /**
+     * The view mode (`'source'` or `'preview'`).
+     */
+    readonly mode: string;
+    /**
+     * What raised the menu. Obsidian 1.13.7 always passes `'gutter'` - see
+     * {@link MarkdownViewportMenuEventHandler}.
+     */
+    readonly source: string;
+    /**
+     * The markdown view the menu was raised over.
+     */
+    readonly view: MarkdownView;
+}
+/**
+ * Command handler for editor commands.
+ *
+ * Subclasses override {@link canExecuteEditor} and {@link executeEditor} to provide behavior.
+ * Optionally integrates with the editor context menu via {@link shouldAddToEditorMenu}, and with the
+ * markdown viewport (margin) menu via {@link shouldAddToViewportMenu}.
+ */
+export declare abstract class EditorCommandHandler extends CommandHandler {
+    /**
+     * Gets the item name to use in the editor menu.
+     *
+     * @returns The item name, or `undefined` to use the command name.
+     */
+    protected get editorMenuItemName(): string | undefined;
+    /**
+     * Gets the section to use in the editor menu.
+     *
+     * @returns The section name, or `undefined` to use the plugin name.
+     */
+    protected get editorMenuSection(): string | undefined;
+    /**
+     * Gets the icon to use in the editor menu submenu.
+     *
+     * @returns The icon, or `undefined` for no icon.
+     */
+    protected get editorMenuSubmenuIcon(): IconName | undefined;
+    private readonly _editorMenuItemName?;
+    private readonly _editorMenuSection?;
+    private readonly _editorMenuSubmenuIcon?;
+    private readonly _shouldAddCommandToSubmenu?;
+    /**
+     * Creates a new editor command handler.
+     *
+     * @param params - The parameters for the editor command handler.
+     */
+    constructor(params: EditorCommandHandlerConstructorParams);
+    /**
+     * Builds a plain Obsidian {@link Command} object with an `editorCheckCallback`.
+     *
+     * @returns A new {@link Command} object.
+     */
+    buildCommand(): Command;
+    /**
+     * Registers the editor-menu and markdown-viewport-menu event handlers.
+     *
+     * Both are registered unconditionally; whether an item actually appears is decided per menu render by
+     * {@link shouldAddToEditorMenu} / {@link shouldAddToViewportMenu}, which both default to `false`.
+     *
+     * @param context - The registration context.
+     */
+    onRegistered(context: CommandHandlerRegistrationContext): Promise<void>;
+    /**
+     * Checks whether the command can execute for the given editor and context.
+     *
+     * @param _editor - The editor instance.
+     * @param _context - The markdown file context.
+     * @returns Whether the command can execute.
+     */
+    protected canExecuteEditor(_editor: Editor, _context: MarkdownFileInfo): boolean;
+    /**
+     * Executes the command for the given editor and context.
+     *
+     * @param editor - The editor instance.
+     * @param context - The markdown file context.
+     */
+    protected abstract executeEditor(editor: Editor, context: MarkdownFileInfo): Promisable<void>;
+    /**
+     * Gets whether to add the command to a submenu.
+     *
+     * @returns Whether to add to a submenu.
+     */
+    protected shouldAddCommandToSubmenu(): boolean | undefined;
+    /**
+     * Checks whether the command should appear in the command palette.
+     *
+     * @returns Whether to add to the command palette.
+     */
+    protected shouldAddToCommandPalette(): boolean;
+    /**
+     * Checks whether the command should appear in the editor context menu.
+     *
+     * @param _editor - The editor instance.
+     * @param _context - The markdown file context.
+     * @returns Whether to add to the editor menu.
+     */
+    protected shouldAddToEditorMenu(_editor: Editor, _context: MarkdownFileInfo): boolean;
+    /**
+     * Checks whether the command should appear in the markdown viewport (margin) context menu.
+     *
+     * That is the menu carrying `Readable line length` / `Line numbers` / `Inline title`, raised by
+     * right-clicking the empty space beside the text or the line-number gutter — a menu
+     * {@link shouldAddToEditorMenu} can never reach, because a margin click lands outside the editor's
+     * `contentDOM`. It is a natural home for whole-note commands once the editor menu gets crowded.
+     *
+     * `mode` and `source` are passed through rather than filtered here: whether a command belongs in
+     * reading mode is the consuming plugin's call. Note that Obsidian 1.13.7 always passes `'gutter'` as
+     * `source`, so only `mode` currently discriminates - see {@link MarkdownViewportMenuEventHandler}.
+     *
+     * @param _view - The markdown view the menu was raised over.
+     * @param _mode - The view mode (`'source'` or `'preview'`).
+     * @param _source - What raised the menu.
+     * @returns Whether to add to the viewport menu.
+     */
+    protected shouldAddToViewportMenu(_view: MarkdownView, _mode: string, _source: string): boolean;
+    /**
+     * Adds the command's item to a menu, in the handler's own section.
+     *
+     * Shared by both menu surfaces: an item presents identically whichever of the two it was opted into,
+     * so the section / submenu / icon plumbing lives here once.
+     *
+     * @param menu - The menu to add the item to.
+     * @param editor - The editor the command will run against.
+     * @param context - The markdown file context the command will run against.
+     */
+    private addMenuItem;
+    private editorCheckCallback;
+    private handleEditorMenu;
+    private handleViewportMenu;
+}