obsidian-dev-utils 88.8.0 → 90.0.0

package/dist/lib/cjs/obsidian/command-handlers/abstract-file-command-handler.d.cts

@@ -176,6 +176,7 @@ export declare abstract class AbstractFileCommandHandler extends GlobalCommandHa
     private readonly _filesMenuItemName?;
     private readonly _filesMenuSection?;
     private readonly _filesMenuSubmenuIcon?;
+    private _registrationShouldAddCommandToSubmenu?;
     private readonly _shouldAddCommandToSubmenu?;
     /**
      * Creates a new abstract file command handler.
@@ -240,6 +241,10 @@ export declare abstract class AbstractFileCommandHandler extends GlobalCommandHa
     /**
      * Gets whether to add the command to a submenu.
      *
+     * The registration context wins over the constructor value: a menu surface that already wraps every
+     * contributed item in a plugin-titled parent entry forces this off, because a section submenu
+     * declared here would make `Menu.sort()` nest a second plugin-titled entry inside the first.
+     *
      * @returns Whether to add to a submenu.
      */
     protected shouldAddCommandToSubmenu(): boolean | undefined;

package/dist/lib/cjs/obsidian/command-handlers/command-handler-component.cjs

@@ -40,16 +40,11 @@ if you want to view the source, please visit the github repository of this plugi
     globalThisRecord[key] ??= newFuncs[key]?.();
   }
 
-  function name(obj) {
-    return obj;
-  }
-
   function extractDefault(module) {
     return module && module.__esModule && 'default' in module ? module.default : module;
   }
 
-  const OBSIDIAN_BUILT_IN_MODULE_NAMES = [
-  'obsidian',
+  const OBSIDIAN_BUILT_IN_MODULE_NAMES = new Set([
   '@codemirror/autocomplete',
   '@codemirror/collab',
   '@codemirror/commands',
@@ -60,11 +55,12 @@ if you want to view the source, please visit the github repository of this plugi
   '@codemirror/text',
   '@codemirror/view',
   '@lezer/common',
+  '@lezer/highlight',
   '@lezer/lr',
-  '@lezer/highlight'];
+  'obsidian']
+  );
 
-
-  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = [
+  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = new Set([
   '@codemirror/closebrackets',
   '@codemirror/comment',
   '@codemirror/fold',
@@ -76,11 +72,11 @@ if you want to view the source, please visit the github repository of this plugi
   '@codemirror/rangeset',
   '@codemirror/rectangular-selection',
   '@codemirror/stream-parser',
-  '@codemirror/tooltip'];
-
+  '@codemirror/tooltip']
+  );
 
   function requirePatched(id) {
-    if (OBSIDIAN_BUILT_IN_MODULE_NAMES.includes(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.includes(id)) {
+    if (OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id)) {
       return originalRequire?.(id);
     }
 
@@ -89,8 +85,8 @@ if you want to view the source, please visit the github repository of this plugi
       if (id === 'process' || id === 'node:process') {
         // eslint-disable-next-line no-console -- Valid usage.
         console.debug(`The most likely you can safely ignore this error. Module not found: ${id}. Fake process object is returned instead.`);
-        // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
-        return globalThis.process;
+
+        return process;
       }
     } else {
       const module = originalRequire?.(id);
@@ -128,7 +124,6 @@ __export(command_handler_component_exports, {
   CommandHandlerComponent: () => CommandHandlerComponent
 });
 module.exports = __toCommonJS(command_handler_component_exports);
-var import_async = require('../../async.cjs');
 var import_disposable = require('../../disposable.cjs');
 var import_component_ex = require('../components/component-ex.cjs');
 class CommandMenuEventScope extends import_disposable.DisposableBase {
@@ -167,6 +162,11 @@ class CommandHandlerComponent extends import_component_ex.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.
    */
@@ -188,31 +188,31 @@ class CommandHandlerComponent extends import_component_ex.ComponentEx {
     super();
     this.activeFileProvider = params.activeFileProvider;
     this.menuEventRegistrar = params.menuEventRegistrar;
+    this.additionalMenuEventRegistrars = params.additionalMenuEventRegistrars ?? [];
     this.commandRegistrar = params.commandRegistrar;
     this.pluginName = params.pluginName;
   }
   /**
-   * Registers the given command handlers with Obsidian and provides 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.
+   * 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.
    *
-   * @param commandHandlers - The command handlers to register.
-   * @returns A {@link DisposableEx} that unregisters the handlers (commands + menu events) passed to this call.
+   * @param commandHandlerFactory - Builds a fresh set of command handlers, once per menu surface.
+   * @returns A {@link DisposableEx} that unregisters the handlers (commands + menu events) registered by this call.
    */
-  registerCommandHandlers(commandHandlers) {
+  async registerCommandHandlers(commandHandlerFactory) {
     const disposables = [];
-    for (const commandHandler of commandHandlers) {
+    for (const commandHandler of commandHandlerFactory()) {
       const command = commandHandler.buildCommand();
       const commandId = command.id;
       this.commandRegistrar.addCommand(command);
-      const menuEventScope = new CommandMenuEventScope(this.menuEventRegistrar);
-      const context = {
-        activeFileProvider: this.activeFileProvider,
-        menuEventRegistrar: menuEventScope,
-        pluginName: this.pluginName
-      };
+      const menuEventScope = await this.registerMenuEventHandlers({ commandHandler, menuEventRegistrar: this.menuEventRegistrar });
       const disposable = new import_disposable.CallbackDisposable({
         callback: () => {
           this.commandRegistrar.removeCommand(commandId);
@@ -220,13 +220,35 @@ class CommandHandlerComponent extends import_component_ex.ComponentEx {
         }
       });
       disposables.push(this.registerDisposable(disposable));
-      (0, import_async.invokeAsyncSafely)(() => commandHandler.onRegistered(context));
+    }
+    for (const additionalMenuEventRegistrar of this.additionalMenuEventRegistrars) {
+      for (const commandHandler of commandHandlerFactory()) {
+        disposables.push(this.registerDisposable(await this.registerMenuEventHandlers({ commandHandler, menuEventRegistrar: additionalMenuEventRegistrar, shouldAddCommandToSubmenu: false })));
+      }
     }
     return new import_disposable.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;
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CommandHandlerComponent
 });
-//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbW1hbmQtaGFuZGxlcnMvY29tbWFuZC1oYW5kbGVyLWNvbXBvbmVudC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbXBvbmVudCB0aGF0IHJlZ2lzdGVycyB7QGxpbmsgQ29tbWFuZEhhbmRsZXJ9cyB3aXRoIE9ic2lkaWFuIGFuZCB0aWVzIHRoZWlyIHJlbW92YWwgdG8gaXRzIGxpZmVjeWNsZS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IERpc3Bvc2FibGVFeCB9IGZyb20gJy4uLy4uL2Rpc3Bvc2FibGUudHMnO1xuaW1wb3J0IHR5cGUgeyBBY3RpdmVGaWxlUHJvdmlkZXIgfSBmcm9tICcuLi9hY3RpdmUtZmlsZS1wcm92aWRlci50cyc7XG5pbXBvcnQgdHlwZSB7IENvbW1hbmRSZWdpc3RyYXIgfSBmcm9tICcuLi9jb21tYW5kLXJlZ2lzdHJhci50cyc7XG5pbXBvcnQgdHlwZSB7XG4gIEVkaXRvck1lbnVFdmVudEhhbmRsZXIsXG4gIEZpbGVNZW51RXZlbnRIYW5kbGVyLFxuICBGaWxlc01lbnVFdmVudEhhbmRsZXIsXG4gIE1lbnVFdmVudFJlZ2lzdHJhclxufSBmcm9tICcuLi9tZW51LWV2ZW50LXJlZ2lzdHJhci50cyc7XG5pbXBvcnQgdHlwZSB7XG4gIENvbW1hbmRIYW5kbGVyLFxuICBDb21tYW5kSGFuZGxlclJlZ2lzdHJhdGlvbkNvbnRleHRcbn0gZnJvbSAnLi9jb21tYW5kLWhhbmRsZXIudHMnO1xuXG5pbXBvcnQgeyBpbnZva2VBc3luY1NhZmVseSB9IGZyb20gJy4uLy4uL2FzeW5jLnRzJztcbmltcG9ydCB7XG4gIENhbGxiYWNrRGlzcG9zYWJsZSxcbiAgQ29tYmluZURpc3Bvc2FibGUsXG4gIERpc3Bvc2FibGVCYXNlXG59IGZyb20gJy4uLy4uL2Rpc3Bvc2FibGUudHMnO1xuaW1wb3J0IHsgQ29tcG9uZW50RXggfSBmcm9tICcuLi9jb21wb25lbnRzL2NvbXBvbmVudC1leC50cyc7XG5cbmludGVyZmFjZSBDb21tYW5kSGFuZGxlckNvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zIHtcbiAgcmVhZG9ubHkgYWN0aXZlRmlsZVByb3ZpZGVyOiBBY3RpdmVGaWxlUHJvdmlkZXI7XG4gIHJlYWRvbmx5IGNvbW1hbmRSZWdpc3RyYXI6IENvbW1hbmRSZWdpc3RyYXI7XG4gIHJlYWRvbmx5IG1lbnVFdmVudFJlZ2lzdHJhcjogTWVudUV2ZW50UmVnaXN0cmFyO1xuICByZWFkb25seSBwbHVnaW5OYW1lOiBzdHJpbmc7XG59XG5cbi8qKlxuICogQSBwZXItY29tbWFuZCB7QGxpbmsgTWVudUV2ZW50UmVnaXN0cmFyfSB0aGF0IGRlbGVnYXRlcyB0byBhIHNoYXJlZCByZWdpc3RyYXIgd2hpbGUgY29sbGVjdGluZyB0aGVcbiAqIHtAbGluayBEaXNwb3NhYmxlRXh9IGVhY2ggcmVnaXN0cmF0aW9uIHJldHVybnMsIHNvIGRpc3Bvc2luZyB0aGlzIHNjb3BlIHVucmVnaXN0ZXJzIGV4YWN0bHkgdGhhdCBjb21tYW5kJ3NcbiAqIG1lbnUgZXZlbnRzLiBCZWNhdXNlIHtAbGluayBDb21tYW5kSGFuZGxlci5vblJlZ2lzdGVyZWR9IHJ1bnMgZmlyZS1hbmQtZm9yZ2V0IChpdCBtYXkgcmVnaXN0ZXIgbWVudSBldmVudHNcbiAqIGFmdGVyIHRoaXMgc2NvcGUgaGFzIGFscmVhZHkgYmVlbiBkaXNwb3NlZCksIGEgcmVnaXN0cmF0aW9uIHRoYXQgYXJyaXZlcyBwb3N0LWRpc3Bvc2UgaXMgZGlzcG9zZWQgaW1tZWRpYXRlbHlcbiAqIGluc3RlYWQgb2YgbGVha2luZy5cbiAqL1xuY2xhc3MgQ29tbWFuZE1lbnVFdmVudFNjb3BlIGV4dGVuZHMgRGlzcG9zYWJsZUJhc2UgaW1wbGVtZW50cyBNZW51RXZlbnRSZWdpc3RyYXIge1xuICBwcml2YXRlIHJlYWRvbmx5IGRpc3Bvc2FibGVzOiBEaXNwb3NhYmxlRXhbXSA9IFtdO1xuXG4gIHB1YmxpYyBjb25zdHJ1Y3Rvcihwcml2YXRlIHJlYWRvbmx5IGlubmVyOiBNZW51RXZlbnRSZWdpc3RyYXIpIHtcbiAgICBzdXBlcigpO1xuICB9XG5cbiAgcHVibGljIHJlZ2lzdGVyRWRpdG9yTWVudUV2ZW50SGFuZGxlcihoYW5kbGVyOiBFZGl0b3JNZW51RXZlbnRIYW5kbGVyKTogRGlzcG9zYWJsZUV4IHtcbiAgICByZXR1cm4gdGhpcy5jb2xsZWN0KHRoaXMuaW5uZXIucmVnaXN0ZXJFZGl0b3JNZW51RXZlbnRIYW5kbGVyKGhhbmRsZXIpKTtcbiAgfVxuXG4gIHB1YmxpYyByZWdpc3RlckZpbGVNZW51RXZlbnRIYW5kbGVyKGhhbmRsZXI6IEZpbGVNZW51RXZlbnRIYW5kbGVyKTogRGlzcG9zYWJsZUV4IHtcbiAgICByZXR1cm4gdGhpcy5jb2xsZWN0KHRoaXMuaW5uZXIucmVnaXN0ZXJGaWxlTWVudUV2ZW50SGFuZGxlcihoYW5kbGVyKSk7XG4gIH1cblxuICBwdWJsaWMgcmVnaXN0ZXJGaWxlc01lbnVFdmVudEhhbmRsZXIoaGFuZGxlcjogRmlsZXNNZW51RXZlbnRIYW5kbGVyKTogRGlzcG9zYWJsZUV4IHtcbiAgICByZXR1cm4gdGhpcy5jb2xsZWN0KHRoaXMuaW5uZXIucmVnaXN0ZXJGaWxlc01lbnVFdmVudEhhbmRsZXIoaGFuZGxlcikpO1xuICB9XG5cbiAgcHJvdGVjdGVkIG92ZXJyaWRlIHBlcmZvcm1EaXNwb3NlKCk6IHZvaWQge1xuICAgIGZvciAoY29uc3QgZGlzcG9zYWJsZSBvZiB0aGlzLmRpc3Bvc2FibGVzKSB7XG4gICAgICBkaXNwb3NhYmxlLmRpc3Bvc2UoKTtcbiAgICB9XG4gICAgdGhpcy5kaXNwb3NhYmxlcy5sZW5ndGggPSAwO1xuICB9XG5cbiAgcHJpdmF0ZSBjb2xsZWN0KGRpc3Bvc2FibGU6IERpc3Bvc2FibGVFeCk6IERpc3Bvc2FibGVFeCB7XG4gICAgaWYgKHRoaXMuaXNEaXNwb3NlZCkge1xuICAgICAgZGlzcG9zYWJsZS5kaXNwb3NlKCk7XG4gICAgfSBlbHNlIHtcbiAgICAgIHRoaXMuZGlzcG9zYWJsZXMucHVzaChkaXNwb3NhYmxlKTtcbiAgICB9XG5cbiAgICByZXR1cm4gZGlzcG9zYWJsZTtcbiAgfVxufVxuXG4vKipcbiAqIFJlZ2lzdGVycyB7QGxpbmsgQ29tbWFuZEhhbmRsZXJ9cyB3aXRoIE9ic2lkaWFuIGFuZCBtYW5hZ2VzIHRoZWlyIGxpZmVjeWNsZS5cbiAqXG4gKiBDYWxsIHtAbGluayByZWdpc3RlckNvbW1hbmRIYW5kbGVyc30gdG8gcmVnaXN0ZXIgYSBiYXRjaCBvZiBoYW5kbGVycyBvbiBkZW1hbmQgKGFzIG1hbnkgdGltZXMgYXNcbiAqIG5lZWRlZCB3aGlsZSB0aGUgY29tcG9uZW50IGlzIGFsaXZlKTsgZGlzcG9zZSB0aGUgcmV0dXJuZWQge0BsaW5rIERpc3Bvc2FibGVFeH0gdG8gdW5yZWdpc3RlciBleGFjdGx5XG4gKiB0aG9zZSBoYW5kbGVycyBcdTIwMTQgaW5jbHVkaW5nIGFueSBtZW51IGV2ZW50cyB0aGV5IHJlZ2lzdGVyZWQgXHUyMDE0IG9yIGxldCB0aGUgY29tcG9uZW50IHVubG9hZCB0byByZW1vdmUgZXZlcnlcbiAqIGNvbW1hbmQgc3RpbGwgcmVnaXN0ZXJlZCB0aHJvdWdoIGl0LlxuICovXG5leHBvcnQgY2xhc3MgQ29tbWFuZEhhbmRsZXJDb21wb25lbnQgZXh0ZW5kcyBDb21wb25lbnRFeCB7XG4gIC8qKlxuICAgKiBQcm92aWRlciBmb3IgYWNjZXNzaW5nIHRoZSBjdXJyZW50bHkgYWN0aXZlIGZpbGUuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgYWN0aXZlRmlsZVByb3ZpZGVyOiBBY3RpdmVGaWxlUHJvdmlkZXI7XG5cbiAgLyoqXG4gICAqIFJlZ2lzdHJhciB1c2VkIHRvIGFkZCBhbmQgcmVtb3ZlIGNvbW1hbmRzIHdpdGggT2JzaWRpYW4uXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgY29tbWFuZFJlZ2lzdHJhcjogQ29tbWFuZFJlZ2lzdHJhcjtcblxuICAvKipcbiAgICogUmVnaXN0cmFyIGZvciBtZW51IGV2ZW50IGhhbmRsZXJzLlxuICAgKi9cbiAgcHJvdGVjdGVkIHJlYWRvbmx5IG1lbnVFdmVudFJlZ2lzdHJhcjogTWVudUV2ZW50UmVnaXN0cmFyO1xuXG4gIC8qKlxuICAgKiBUaGUgbmFtZSBvZiB0aGUgcGx1Z2luIHRoYXQgb3ducyB0aGUgY29tbWFuZHMuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgcGx1Z2luTmFtZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IGNvbW1hbmQgaGFuZGxlciBjb21wb25lbnQuXG4gICAqXG4gICAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgY29uc3RydWN0b3IgcGFyYW1ldGVycy5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3RvcihwYXJhbXM6IENvbW1hbmRIYW5kbGVyQ29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXMpIHtcbiAgICBzdXBlcigpO1xuICAgIHRoaXMuYWN0aXZlRmlsZVByb3ZpZGVyID0gcGFyYW1zLmFjdGl2ZUZpbGVQcm92aWRlcjtcbiAgICB0aGlzLm1lbnVFdmVudFJlZ2lzdHJhciA9IHBhcmFtcy5tZW51RXZlbnRSZWdpc3RyYXI7XG4gICAgdGhpcy5jb21tYW5kUmVnaXN0cmFyID0gcGFyYW1zLmNvbW1hbmRSZWdpc3RyYXI7XG4gICAgdGhpcy5wbHVnaW5OYW1lID0gcGFyYW1zLnBsdWdpbk5hbWU7XG4gIH1cblxuICAvKipcbiAgICogUmVnaXN0ZXJzIHRoZSBnaXZlbiBjb21tYW5kIGhhbmRsZXJzIHdpdGggT2JzaWRpYW4gYW5kIHByb3ZpZGVzIGVhY2ggaXRzIG93biBydW50aW1lIHJlZ2lzdHJhdGlvblxuICAgKiBjb250ZXh0LiBFYWNoIGhhbmRsZXIncyBjb21tYW5kIGlzIGFkZGVkIGltbWVkaWF0ZWx5OyB0aGUgcmV0dXJuZWQge0BsaW5rIERpc3Bvc2FibGVFeH0gcmVtb3ZlcyB0aGVcbiAgICogY29tbWFuZHMgcmVnaXN0ZXJlZCBieSB0aGlzIGNhbGwgXHUyMDE0IGFuZCBhbnkgbWVudSBldmVudHMgdGhvc2UgaGFuZGxlcnMgcmVnaXN0ZXJlZCB2aWEgdGhlaXIgY29udGV4dCdzXG4gICAqIHtAbGluayBNZW51RXZlbnRSZWdpc3RyYXJ9IFx1MjAxNCB3aGVuIGRpc3Bvc2VkLiBBbnkgY29tbWFuZCBzdGlsbCByZWdpc3RlcmVkIHdoZW4gdGhlIGNvbXBvbmVudCB1bmxvYWRzIGlzXG4gICAqIHJlbW92ZWQgYXV0b21hdGljYWxseS5cbiAgICpcbiAgICogQHBhcmFtIGNvbW1hbmRIYW5kbGVycyAtIFRoZSBjb21tYW5kIGhhbmRsZXJzIHRvIHJlZ2lzdGVyLlxuICAgKiBAcmV0dXJucyBBIHtAbGluayBEaXNwb3NhYmxlRXh9IHRoYXQgdW5yZWdpc3RlcnMgdGhlIGhhbmRsZXJzIChjb21tYW5kcyArIG1lbnUgZXZlbnRzKSBwYXNzZWQgdG8gdGhpcyBjYWxsLlxuICAgKi9cbiAgcHVibGljIHJlZ2lzdGVyQ29tbWFuZEhhbmRsZXJzKGNvbW1hbmRIYW5kbGVyczogQ29tbWFuZEhhbmRsZXJbXSk6IERpc3Bvc2FibGVFeCB7XG4gICAgY29uc3QgZGlzcG9zYWJsZXM6IERpc3Bvc2FibGVbXSA9IFtdO1xuICAgIGZvciAoY29uc3QgY29tbWFuZEhhbmRsZXIgb2YgY29tbWFuZEhhbmRsZXJzKSB7XG4gICAgICBjb25zdCBjb21tYW5kID0gY29tbWFuZEhhbmRsZXIuYnVpbGRDb21tYW5kKCk7XG4gICAgICAvLyBDYXB0dXJlIHRoZSBpZCBiZWZvcmUgcmVnaXN0ZXJpbmcuIGBQbHVnaW4uYWRkQ29tbWFuZGAgbXV0YXRlcyBgY29tbWFuZC5pZGAgKHByZWZpeGluZyBpdCB3aXRoXG4gICAgICAvLyBgdGhpcy5tYW5pZmVzdC5pZGApLCB3aGlsZSBgUGx1Z2luLnJlbW92ZUNvbW1hbmRgIHJlLXByZWZpeGVzIFx1MjAxNCBzbyByZW1vdmFsIG5lZWRzIHRoZSBvcmlnaW5hbCBpZC5cbiAgICAgIC8vIFJlYWRpbmcgYGNvbW1hbmQuaWRgIGFmdGVyIGBhZGRDb21tYW5kYCB3b3VsZCBkb3VibGUtcHJlZml4IGl0LCBzbyB0aGUgY29tbWFuZCBpcyBuZXZlciByZW1vdmVkLlxuICAgICAgY29uc3QgY29tbWFuZElkID0gY29tbWFuZC5pZDtcbiAgICAgIHRoaXMuY29tbWFuZFJlZ2lzdHJhci5hZGRDb21tYW5kKGNvbW1hbmQpO1xuXG4gICAgICAvLyBFYWNoIGNvbW1hbmQgZ2V0cyBpdHMgb3duIHJlZ2lzdHJhdGlvbiBjb250ZXh0IHdpdGggYSBwZXItY29tbWFuZCBtZW51LWV2ZW50IHNjb3BlLCBzbyBkaXNwb3Npbmcgb25lXG4gICAgICAvLyBDb21tYW5kIHRlYXJzIGRvd24gaXRzIG93biBtZW51IGV2ZW50cyB3aXRob3V0IGFmZmVjdGluZyB0aGUgb3RoZXJzLlxuICAgICAgY29uc3QgbWVudUV2ZW50U2NvcGUgPSBuZXcgQ29tbWFuZE1lbnVFdmVudFNjb3BlKHRoaXMubWVudUV2ZW50UmVnaXN0cmFyKTtcbiAgICAgIGNvbnN0IGNvbnRleHQ6IENvbW1hbmRIYW5kbGVyUmVnaXN0cmF0aW9uQ29udGV4dCA9IHtcbiAgICAgICAgYWN0aXZlRmlsZVByb3ZpZGVyOiB0aGlzLmFjdGl2ZUZpbGVQcm92aWRlcixcbiAgICAgICAgbWVudUV2ZW50UmVnaXN0cmFyOiBtZW51RXZlbnRTY29wZSxcbiAgICAgICAgcGx1Z2luTmFtZTogdGhpcy5wbHVnaW5OYW1lXG4gICAgICB9O1xuXG4gICAgICBjb25zdCBkaXNwb3NhYmxlID0gbmV3IENhbGxiYWNrRGlzcG9zYWJsZSh7XG4gICAgICAgIGNhbGxiYWNrOiAoKTogdm9pZCA9PiB7XG4gICAgICAgICAgdGhpcy5jb21tYW5kUmVnaXN0cmFyLnJlbW92ZUNvbW1hbmQoY29tbWFuZElkKTtcbiAgICAgICAgICBtZW51RXZlbnRTY29wZS5kaXNwb3NlKCk7XG4gICAgICAgIH1cbiAgICAgIH0pO1xuICAgICAgLy8gVGllIHJlbW92YWwgdG8gdGhlIGNvbXBvbmVudCdzIHVubG9hZCwgc28gYSBjb21tYW5kIG5ldmVyIG91dGxpdmVzIHRoZSBjb21wb25lbnQuXG4gICAgICBkaXNwb3NhYmxlcy5wdXNoKHRoaXMucmVnaXN0ZXJEaXNwb3NhYmxlKGRpc3Bvc2FibGUpKTtcbiAgICAgIGludm9rZUFzeW5jU2FmZWx5KCgpID0+IGNvbW1hbmRIYW5kbGVyLm9uUmVnaXN0ZXJlZChjb250ZXh0KSk7XG4gICAgfVxuXG4gICAgcmV0dXJuIG5ldyBDb21iaW5lRGlzcG9zYWJsZSh7IGRpc3Bvc2FibGVzIH0pO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFvQkEsbUJBQWtDO0FBQ2xDLHdCQUlPO0FBQ1AsMEJBQTRCO0FBZ0I1QixNQUFNLDhCQUE4QixpQ0FBNkM7QUFBQSxFQUd4RSxZQUE2QixPQUEyQjtBQUM3RCxVQUFNO0FBRDRCO0FBQUEsRUFFcEM7QUFBQSxFQUZvQztBQUFBLEVBRm5CLGNBQThCLENBQUM7QUFBQSxFQU16QywrQkFBK0IsU0FBK0M7QUFDbkYsV0FBTyxLQUFLLFFBQVEsS0FBSyxNQUFNLCtCQUErQixPQUFPLENBQUM7QUFBQSxFQUN4RTtBQUFBLEVBRU8sNkJBQTZCLFNBQTZDO0FBQy9FLFdBQU8sS0FBSyxRQUFRLEtBQUssTUFBTSw2QkFBNkIsT0FBTyxDQUFDO0FBQUEsRUFDdEU7QUFBQSxFQUVPLDhCQUE4QixTQUE4QztBQUNqRixXQUFPLEtBQUssUUFBUSxLQUFLLE1BQU0sOEJBQThCLE9BQU8sQ0FBQztBQUFBLEVBQ3ZFO0FBQUEsRUFFbUIsaUJBQXVCO0FBQ3hDLGVBQVcsY0FBYyxLQUFLLGFBQWE7QUFDekMsaUJBQVcsUUFBUTtBQUFBLElBQ3JCO0FBQ0EsU0FBSyxZQUFZLFNBQVM7QUFBQSxFQUM1QjtBQUFBLEVBRVEsUUFBUSxZQUF3QztBQUN0RCxRQUFJLEtBQUssWUFBWTtBQUNuQixpQkFBVyxRQUFRO0FBQUEsSUFDckIsT0FBTztBQUNMLFdBQUssWUFBWSxLQUFLLFVBQVU7QUFBQSxJQUNsQztBQUVBLFdBQU87QUFBQSxFQUNUO0FBQ0Y7QUFVTyxNQUFNLGdDQUFnQyxnQ0FBWTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBSXBDO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFLQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBS0E7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT1osWUFBWSxRQUFrRDtBQUNuRSxVQUFNO0FBQ04sU0FBSyxxQkFBcUIsT0FBTztBQUNqQyxTQUFLLHFCQUFxQixPQUFPO0FBQ2pDLFNBQUssbUJBQW1CLE9BQU87QUFDL0IsU0FBSyxhQUFhLE9BQU87QUFBQSxFQUMzQjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFZTyx3QkFBd0IsaUJBQWlEO0FBQzlFLFVBQU0sY0FBNEIsQ0FBQztBQUNuQyxlQUFXLGtCQUFrQixpQkFBaUI7QUFDNUMsWUFBTSxVQUFVLGVBQWUsYUFBYTtBQUk1QyxZQUFNLFlBQVksUUFBUTtBQUMxQixXQUFLLGlCQUFpQixXQUFXLE9BQU87QUFJeEMsWUFBTSxpQkFBaUIsSUFBSSxzQkFBc0IsS0FBSyxrQkFBa0I7QUFDeEUsWUFBTSxVQUE2QztBQUFBLFFBQ2pELG9CQUFvQixLQUFLO0FBQUEsUUFDekIsb0JBQW9CO0FBQUEsUUFDcEIsWUFBWSxLQUFLO0FBQUEsTUFDbkI7QUFFQSxZQUFNLGFBQWEsSUFBSSxxQ0FBbUI7QUFBQSxRQUN4QyxVQUFVLE1BQVk7QUFDcEIsZUFBSyxpQkFBaUIsY0FBYyxTQUFTO0FBQzdDLHlCQUFlLFFBQVE7QUFBQSxRQUN6QjtBQUFBLE1BQ0YsQ0FBQztBQUVELGtCQUFZLEtBQUssS0FBSyxtQkFBbUIsVUFBVSxDQUFDO0FBQ3BELDBDQUFrQixNQUFNLGVBQWUsYUFBYSxPQUFPLENBQUM7QUFBQSxJQUM5RDtBQUVBLFdBQU8sSUFBSSxvQ0FBa0IsRUFBRSxZQUFZLENBQUM7QUFBQSxFQUM5QztBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbW1hbmQtaGFuZGxlcnMvY29tbWFuZC1oYW5kbGVyLWNvbXBvbmVudC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbXBvbmVudCB0aGF0IHJlZ2lzdGVycyB7QGxpbmsgQ29tbWFuZEhhbmRsZXJ9cyB3aXRoIE9ic2lkaWFuIGFuZCB0aWVzIHRoZWlyIHJlbW92YWwgdG8gaXRzIGxpZmVjeWNsZS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IERpc3Bvc2FibGVFeCB9IGZyb20gJy4uLy4uL2Rpc3Bvc2FibGUudHMnO1xuaW1wb3J0IHR5cGUgeyBBY3RpdmVGaWxlUHJvdmlkZXIgfSBmcm9tICcuLi9hY3RpdmUtZmlsZS1wcm92aWRlci50cyc7XG5pbXBvcnQgdHlwZSB7IENvbW1hbmRSZWdpc3RyYXIgfSBmcm9tICcuLi9jb21tYW5kLXJlZ2lzdHJhci50cyc7XG5pbXBvcnQgdHlwZSB7XG4gIEVkaXRvck1lbnVFdmVudEhhbmRsZXIsXG4gIEZpbGVNZW51RXZlbnRIYW5kbGVyLFxuICBGaWxlc01lbnVFdmVudEhhbmRsZXIsXG4gIE1lbnVFdmVudFJlZ2lzdHJhclxufSBmcm9tICcuLi9tZW51LWV2ZW50LXJlZ2lzdHJhci50cyc7XG5pbXBvcnQgdHlwZSB7XG4gIENvbW1hbmRIYW5kbGVyLFxuICBDb21tYW5kSGFuZGxlclJlZ2lzdHJhdGlvbkNvbnRleHRcbn0gZnJvbSAnLi9jb21tYW5kLWhhbmRsZXIudHMnO1xuXG5pbXBvcnQge1xuICBDYWxsYmFja0Rpc3Bvc2FibGUsXG4gIENvbWJpbmVEaXNwb3NhYmxlLFxuICBEaXNwb3NhYmxlQmFzZVxufSBmcm9tICcuLi8uLi9kaXNwb3NhYmxlLnRzJztcbmltcG9ydCB7IENvbXBvbmVudEV4IH0gZnJvbSAnLi4vY29tcG9uZW50cy9jb21wb25lbnQtZXgudHMnO1xuXG4vKipcbiAqIEJ1aWxkcyBhIGZyZXNoIHNldCBvZiB7QGxpbmsgQ29tbWFuZEhhbmRsZXJ9cy5cbiAqXG4gKiBBIGZhY3RvcnkgcmF0aGVyIHRoYW4gYSByZWFkeS1tYWRlIGFycmF5IGJlY2F1c2Uge0BsaW5rIENvbW1hbmRIYW5kbGVyQ29tcG9uZW50fSByZWdpc3RlcnMgdGhlIHNhbWVcbiAqIGhhbmRsZXJzIGFnYWluc3Qgc2V2ZXJhbCBtZW51IHN1cmZhY2VzLCBhbmQgYSBoYW5kbGVyIGNhcnJpZXMgcGVyLXJlZ2lzdHJhdGlvbiBzdGF0ZSAoaXRzXG4gKiBhY3RpdmUtZmlsZSBwcm92aWRlciwgaXRzIHBsdWdpbiBuYW1lLCBhbmQgd2hhdGV2ZXIgYSBzdWJjbGFzcyByZWNvcmRzIGluXG4gKiB7QGxpbmsgQ29tbWFuZEhhbmRsZXIub25SZWdpc3RlcmVkfSkgXHUyMDE0IHNvIGV2ZXJ5IHN1cmZhY2UgbmVlZHMgaXRzIG93biBpbnN0YW5jZXMuXG4gKlxuICogUmV0dXJuaW5nIHNoYXJlZCBpbnN0YW5jZXMgKGAoKSA9PiBbaGFuZGxlcjFTaW5nbGV0b24sIGhhbmRsZXIyU2luZ2xldG9uXWApIHJlaW50cm9kdWNlcyBleGFjdGx5IHRoZVxuICogYnVnIHRoZSBmYWN0b3J5IGV4aXN0cyB0byBhdm9pZCwgc28gaXQgaXMgbm90IG1lcmVseSBkaXNjb3VyYWdlZDoge0BsaW5rIENvbW1hbmRIYW5kbGVyLm9uUmVnaXN0ZXJlZH1cbiAqIHRocm93cyBvbiB0aGUgc2Vjb25kIHJlZ2lzdHJhdGlvbiBvZiBhbiBpbnN0YW5jZS4ge0BsaW5rIENvbW1hbmRIYW5kbGVyQ29tcG9uZW50LnJlZ2lzdGVyQ29tbWFuZEhhbmRsZXJzfVxuICogYXdhaXRzIGl0LCBzbyB0aGF0IHRocm93IHJlamVjdHMgdGhlIGNhbGxlcidzIHByb21pc2UgaW5zdGVhZCBvZiBkZWdyYWRpbmcgaW50byBhIHdyb25nIGNvbnRleHQgbWVudS5cbiAqXG4gKiBAcmV0dXJucyBUaGUgY29tbWFuZCBoYW5kbGVycyB0byByZWdpc3Rlci4gQSBORVcgaW5zdGFuY2Ugb2YgZWFjaCBvbiBldmVyeSBjYWxsLlxuICovXG5leHBvcnQgdHlwZSBDb21tYW5kSGFuZGxlckZhY3RvcnkgPSAoKSA9PiBDb21tYW5kSGFuZGxlcltdO1xuXG5pbnRlcmZhY2UgQ29tbWFuZEhhbmRsZXJDb21wb25lbnRDb25zdHJ1Y3RvclBhcmFtcyB7XG4gIHJlYWRvbmx5IGFjdGl2ZUZpbGVQcm92aWRlcjogQWN0aXZlRmlsZVByb3ZpZGVyO1xuICByZWFkb25seSBhZGRpdGlvbmFsTWVudUV2ZW50UmVnaXN0cmFycz86IHJlYWRvbmx5IE1lbnVFdmVudFJlZ2lzdHJhcltdIHwgdW5kZWZpbmVkO1xuICByZWFkb25seSBjb21tYW5kUmVnaXN0cmFyOiBDb21tYW5kUmVnaXN0cmFyO1xuICByZWFkb25seSBtZW51RXZlbnRSZWdpc3RyYXI6IE1lbnVFdmVudFJlZ2lzdHJhcjtcbiAgcmVhZG9ubHkgcGx1Z2luTmFtZTogc3RyaW5nO1xufVxuXG5pbnRlcmZhY2UgQ29tbWFuZEhhbmRsZXJDb21wb25lbnRSZWdpc3Rlck1lbnVFdmVudEhhbmRsZXJzUGFyYW1zIHtcbiAgcmVhZG9ubHkgY29tbWFuZEhhbmRsZXI6IENvbW1hbmRIYW5kbGVyO1xuICByZWFkb25seSBtZW51RXZlbnRSZWdpc3RyYXI6IE1lbnVFdmVudFJlZ2lzdHJhcjtcbiAgcmVhZG9ubHkgc2hvdWxkQWRkQ29tbWFuZFRvU3VibWVudT86IGJvb2xlYW47XG59XG5cbi8qKlxuICogQSBwZXItY29tbWFuZCB7QGxpbmsgTWVudUV2ZW50UmVnaXN0cmFyfSB0aGF0IGRlbGVnYXRlcyB0byBhIHNoYXJlZCByZWdpc3RyYXIgd2hpbGUgY29sbGVjdGluZyB0aGVcbiAqIHtAbGluayBEaXNwb3NhYmxlRXh9IGVhY2ggcmVnaXN0cmF0aW9uIHJldHVybnMsIHNvIGRpc3Bvc2luZyB0aGlzIHNjb3BlIHVucmVnaXN0ZXJzIGV4YWN0bHkgdGhhdCBjb21tYW5kJ3NcbiAqIG1lbnUgZXZlbnRzLiBBIGhhbmRsZXIgbWF5IGtlZXAgdGhlIHNjb3BlIHBhc3Qge0BsaW5rIENvbW1hbmRIYW5kbGVyLm9uUmVnaXN0ZXJlZH0gYW5kIHJlZ2lzdGVyIG1lbnUgZXZlbnRzXG4gKiBsYXRlciBcdTIwMTQgYSBicmlkZ2UgYmluZGluZyBhdCBsYXlvdXQtcmVhZHksIHNheSBcdTIwMTQgc28gYSByZWdpc3RyYXRpb24gdGhhdCBhcnJpdmVzIGFmdGVyIHRoaXMgc2NvcGUgd2FzIGRpc3Bvc2VkXG4gKiBpcyBkaXNwb3NlZCBpbW1lZGlhdGVseSBpbnN0ZWFkIG9mIGxlYWtpbmcuXG4gKi9cbmNsYXNzIENvbW1hbmRNZW51RXZlbnRTY29wZSBleHRlbmRzIERpc3Bvc2FibGVCYXNlIGltcGxlbWVudHMgTWVudUV2ZW50UmVnaXN0cmFyIHtcbiAgcHJpdmF0ZSByZWFkb25seSBkaXNwb3NhYmxlczogRGlzcG9zYWJsZUV4W10gPSBbXTtcblxuICBwdWJsaWMgY29uc3RydWN0b3IocHJpdmF0ZSByZWFkb25seSBpbm5lcjogTWVudUV2ZW50UmVnaXN0cmFyKSB7XG4gICAgc3VwZXIoKTtcbiAgfVxuXG4gIHB1YmxpYyByZWdpc3RlckVkaXRvck1lbnVFdmVudEhhbmRsZXIoaGFuZGxlcjogRWRpdG9yTWVudUV2ZW50SGFuZGxlcik6IERpc3Bvc2FibGVFeCB7XG4gICAgcmV0dXJuIHRoaXMuY29sbGVjdCh0aGlzLmlubmVyLnJlZ2lzdGVyRWRpdG9yTWVudUV2ZW50SGFuZGxlcihoYW5kbGVyKSk7XG4gIH1cblxuICBwdWJsaWMgcmVnaXN0ZXJGaWxlTWVudUV2ZW50SGFuZGxlcihoYW5kbGVyOiBGaWxlTWVudUV2ZW50SGFuZGxlcik6IERpc3Bvc2FibGVFeCB7XG4gICAgcmV0dXJuIHRoaXMuY29sbGVjdCh0aGlzLmlubmVyLnJlZ2lzdGVyRmlsZU1lbnVFdmVudEhhbmRsZXIoaGFuZGxlcikpO1xuICB9XG5cbiAgcHVibGljIHJlZ2lzdGVyRmlsZXNNZW51RXZlbnRIYW5kbGVyKGhhbmRsZXI6IEZpbGVzTWVudUV2ZW50SGFuZGxlcik6IERpc3Bvc2FibGVFeCB7XG4gICAgcmV0dXJuIHRoaXMuY29sbGVjdCh0aGlzLmlubmVyLnJlZ2lzdGVyRmlsZXNNZW51RXZlbnRIYW5kbGVyKGhhbmRsZXIpKTtcbiAgfVxuXG4gIHByb3RlY3RlZCBvdmVycmlkZSBwZXJmb3JtRGlzcG9zZSgpOiB2b2lkIHtcbiAgICBmb3IgKGNvbnN0IGRpc3Bvc2FibGUgb2YgdGhpcy5kaXNwb3NhYmxlcykge1xuICAgICAgZGlzcG9zYWJsZS5kaXNwb3NlKCk7XG4gICAgfVxuICAgIHRoaXMuZGlzcG9zYWJsZXMubGVuZ3RoID0gMDtcbiAgfVxuXG4gIHByaXZhdGUgY29sbGVjdChkaXNwb3NhYmxlOiBEaXNwb3NhYmxlRXgpOiBEaXNwb3NhYmxlRXgge1xuICAgIGlmICh0aGlzLmlzRGlzcG9zZWQpIHtcbiAgICAgIGRpc3Bvc2FibGUuZGlzcG9zZSgpO1xuICAgIH0gZWxzZSB7XG4gICAgICB0aGlzLmRpc3Bvc2FibGVzLnB1c2goZGlzcG9zYWJsZSk7XG4gICAgfVxuXG4gICAgcmV0dXJuIGRpc3Bvc2FibGU7XG4gIH1cbn1cblxuLyoqXG4gKiBSZWdpc3RlcnMge0BsaW5rIENvbW1hbmRIYW5kbGVyfXMgd2l0aCBPYnNpZGlhbiBhbmQgbWFuYWdlcyB0aGVpciBsaWZlY3ljbGUuXG4gKlxuICogQ2FsbCB7QGxpbmsgcmVnaXN0ZXJDb21tYW5kSGFuZGxlcnN9IHRvIHJlZ2lzdGVyIGEgYmF0Y2ggb2YgaGFuZGxlcnMgb24gZGVtYW5kIChhcyBtYW55IHRpbWVzIGFzXG4gKiBuZWVkZWQgd2hpbGUgdGhlIGNvbXBvbmVudCBpcyBhbGl2ZSk7IGRpc3Bvc2UgdGhlIHJldHVybmVkIHtAbGluayBEaXNwb3NhYmxlRXh9IHRvIHVucmVnaXN0ZXIgZXhhY3RseVxuICogdGhvc2UgaGFuZGxlcnMgXHUyMDE0IGluY2x1ZGluZyBhbnkgbWVudSBldmVudHMgdGhleSByZWdpc3RlcmVkIFx1MjAxNCBvciBsZXQgdGhlIGNvbXBvbmVudCB1bmxvYWQgdG8gcmVtb3ZlIGV2ZXJ5XG4gKiBjb21tYW5kIHN0aWxsIHJlZ2lzdGVyZWQgdGhyb3VnaCBpdC5cbiAqXG4gKiBUaGUgc2FtZSBoYW5kbGVycyBhcmUgZmVkIHRvIGV2ZXJ5IG1lbnUgc3VyZmFjZSB0aGUgY29tcG9uZW50IGtub3dzIGFib3V0OiBPYnNpZGlhbidzIG93biB3b3Jrc3BhY2VcbiAqIGV2ZW50cywgcGx1cyBlYWNoIGFkZGl0aW9uYWwge0BsaW5rIE1lbnVFdmVudFJlZ2lzdHJhcn0gYnJpZGdpbmcgYW5vdGhlciBwbHVnaW4ncyBtZW51cy5cbiAqL1xuZXhwb3J0IGNsYXNzIENvbW1hbmRIYW5kbGVyQ29tcG9uZW50IGV4dGVuZHMgQ29tcG9uZW50RXgge1xuICAvKipcbiAgICogUHJvdmlkZXIgZm9yIGFjY2Vzc2luZyB0aGUgY3VycmVudGx5IGFjdGl2ZSBmaWxlLlxuICAgKi9cbiAgcHJvdGVjdGVkIHJlYWRvbmx5IGFjdGl2ZUZpbGVQcm92aWRlcjogQWN0aXZlRmlsZVByb3ZpZGVyO1xuXG4gIC8qKlxuICAgKiBSZWdpc3RyYXJzIGZvciBtZW51IHN1cmZhY2VzIHRoYXQgYnVpbGQgdGhlaXIgb3duIHBsdWdpbi10aXRsZWQgcGFyZW50IGVudHJ5LCBhbmQgdGhlcmVmb3JlIHRha2VcbiAgICogdGhlIGhhbmRsZXJzIHdpdGggdGhlaXIgc2VjdGlvbiBzdWJtZW51IGZvcmNlZCBvZmYuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgYWRkaXRpb25hbE1lbnVFdmVudFJlZ2lzdHJhcnM6IHJlYWRvbmx5IE1lbnVFdmVudFJlZ2lzdHJhcltdO1xuXG4gIC8qKlxuICAgKiBSZWdpc3RyYXIgdXNlZCB0byBhZGQgYW5kIHJlbW92ZSBjb21tYW5kcyB3aXRoIE9ic2lkaWFuLlxuICAgKi9cbiAgcHJvdGVjdGVkIHJlYWRvbmx5IGNvbW1hbmRSZWdpc3RyYXI6IENvbW1hbmRSZWdpc3RyYXI7XG5cbiAgLyoqXG4gICAqIFJlZ2lzdHJhciBmb3IgbWVudSBldmVudCBoYW5kbGVycy5cbiAgICovXG4gIHByb3RlY3RlZCByZWFkb25seSBtZW51RXZlbnRSZWdpc3RyYXI6IE1lbnVFdmVudFJlZ2lzdHJhcjtcblxuICAvKipcbiAgICogVGhlIG5hbWUgb2YgdGhlIHBsdWdpbiB0aGF0IG93bnMgdGhlIGNvbW1hbmRzLlxuICAgKi9cbiAgcHJvdGVjdGVkIHJlYWRvbmx5IHBsdWdpbk5hbWU6IHN0cmluZztcblxuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBjb21tYW5kIGhhbmRsZXIgY29tcG9uZW50LlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIGNvbnN0cnVjdG9yIHBhcmFtZXRlcnMuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocGFyYW1zOiBDb21tYW5kSGFuZGxlckNvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zKSB7XG4gICAgc3VwZXIoKTtcbiAgICB0aGlzLmFjdGl2ZUZpbGVQcm92aWRlciA9IHBhcmFtcy5hY3RpdmVGaWxlUHJvdmlkZXI7XG4gICAgdGhpcy5tZW51RXZlbnRSZWdpc3RyYXIgPSBwYXJhbXMubWVudUV2ZW50UmVnaXN0cmFyO1xuICAgIHRoaXMuYWRkaXRpb25hbE1lbnVFdmVudFJlZ2lzdHJhcnMgPSBwYXJhbXMuYWRkaXRpb25hbE1lbnVFdmVudFJlZ2lzdHJhcnMgPz8gW107XG4gICAgdGhpcy5jb21tYW5kUmVnaXN0cmFyID0gcGFyYW1zLmNvbW1hbmRSZWdpc3RyYXI7XG4gICAgdGhpcy5wbHVnaW5OYW1lID0gcGFyYW1zLnBsdWdpbk5hbWU7XG4gIH1cblxuICAvKipcbiAgICogQnVpbGRzIHRoZSBjb21tYW5kIGhhbmRsZXJzIGFuZCByZWdpc3RlcnMgdGhlbSB3aXRoIE9ic2lkaWFuLCBnaXZpbmcgZWFjaCBpdHMgb3duIHJ1bnRpbWVcbiAgICogcmVnaXN0cmF0aW9uIGNvbnRleHQuIEVhY2ggaGFuZGxlcidzIGNvbW1hbmQgaXMgYWRkZWQgaW1tZWRpYXRlbHk7IHRoZSByZXR1cm5lZFxuICAgKiB7QGxpbmsgRGlzcG9zYWJsZUV4fSByZW1vdmVzIHRoZSBjb21tYW5kcyByZWdpc3RlcmVkIGJ5IHRoaXMgY2FsbCBcdTIwMTQgYW5kIGFueSBtZW51IGV2ZW50cyB0aG9zZVxuICAgKiBoYW5kbGVycyByZWdpc3RlcmVkIHZpYSB0aGVpciBjb250ZXh0J3Mge0BsaW5rIE1lbnVFdmVudFJlZ2lzdHJhcn0gXHUyMDE0IHdoZW4gZGlzcG9zZWQuIEFueSBjb21tYW5kXG4gICAqIHN0aWxsIHJlZ2lzdGVyZWQgd2hlbiB0aGUgY29tcG9uZW50IHVubG9hZHMgaXMgcmVtb3ZlZCBhdXRvbWF0aWNhbGx5LlxuICAgKlxuICAgKiBUaGUgZmFjdG9yeSBpcyBpbnZva2VkIG9uY2UgbW9yZSBmb3IgZXZlcnkgYWRkaXRpb25hbCBtZW51IHN1cmZhY2UsIHNvIGEgcGx1Z2luIGRlY2xhcmVzIGl0c1xuICAgKiBoYW5kbGVycyBPTkNFIGFuZCBhbGwgc3VyZmFjZXMgYXJlIGZlZC4gVGhvc2UgZXh0cmEgcGFzc2VzIGFkZCBubyBjb21tYW5kcyBcdTIwMTQgdGhlIHBhbGV0dGUgYWxyZWFkeVxuICAgKiBoYXMgZXZlcnkgY29tbWFuZCBmcm9tIHRoZSBmaXJzdCBwYXNzLlxuICAgKlxuICAgKiBAcGFyYW0gY29tbWFuZEhhbmRsZXJGYWN0b3J5IC0gQnVpbGRzIGEgZnJlc2ggc2V0IG9mIGNvbW1hbmQgaGFuZGxlcnMsIG9uY2UgcGVyIG1lbnUgc3VyZmFjZS5cbiAgICogQHJldHVybnMgQSB7QGxpbmsgRGlzcG9zYWJsZUV4fSB0aGF0IHVucmVnaXN0ZXJzIHRoZSBoYW5kbGVycyAoY29tbWFuZHMgKyBtZW51IGV2ZW50cykgcmVnaXN0ZXJlZCBieSB0aGlzIGNhbGwuXG4gICAqL1xuICBwdWJsaWMgYXN5bmMgcmVnaXN0ZXJDb21tYW5kSGFuZGxlcnMoY29tbWFuZEhhbmRsZXJGYWN0b3J5OiBDb21tYW5kSGFuZGxlckZhY3RvcnkpOiBQcm9taXNlPERpc3Bvc2FibGVFeD4ge1xuICAgIGNvbnN0IGRpc3Bvc2FibGVzOiBEaXNwb3NhYmxlW10gPSBbXTtcbiAgICBmb3IgKGNvbnN0IGNvbW1hbmRIYW5kbGVyIG9mIGNvbW1hbmRIYW5kbGVyRmFjdG9yeSgpKSB7XG4gICAgICBjb25zdCBjb21tYW5kID0gY29tbWFuZEhhbmRsZXIuYnVpbGRDb21tYW5kKCk7XG4gICAgICAvLyBDYXB0dXJlIHRoZSBpZCBiZWZvcmUgcmVnaXN0ZXJpbmcuIGBQbHVnaW4uYWRkQ29tbWFuZGAgbXV0YXRlcyBgY29tbWFuZC5pZGAgKHByZWZpeGluZyBpdCB3aXRoXG4gICAgICAvLyBgdGhpcy5tYW5pZmVzdC5pZGApLCB3aGlsZSBgUGx1Z2luLnJlbW92ZUNvbW1hbmRgIHJlLXByZWZpeGVzIFx1MjAxNCBzbyByZW1vdmFsIG5lZWRzIHRoZSBvcmlnaW5hbCBpZC5cbiAgICAgIC8vIFJlYWRpbmcgYGNvbW1hbmQuaWRgIGFmdGVyIGBhZGRDb21tYW5kYCB3b3VsZCBkb3VibGUtcHJlZml4IGl0LCBzbyB0aGUgY29tbWFuZCBpcyBuZXZlciByZW1vdmVkLlxuICAgICAgY29uc3QgY29tbWFuZElkID0gY29tbWFuZC5pZDtcbiAgICAgIHRoaXMuY29tbWFuZFJlZ2lzdHJhci5hZGRDb21tYW5kKGNvbW1hbmQpO1xuXG4gICAgICAvLyBFYWNoIGNvbW1hbmQgZ2V0cyBpdHMgb3duIHJlZ2lzdHJhdGlvbiBjb250ZXh0IHdpdGggYSBwZXItY29tbWFuZCBtZW51LWV2ZW50IHNjb3BlLCBzbyBkaXNwb3Npbmcgb25lXG4gICAgICAvLyBDb21tYW5kIHRlYXJzIGRvd24gaXRzIG93biBtZW51IGV2ZW50cyB3aXRob3V0IGFmZmVjdGluZyB0aGUgb3RoZXJzLlxuICAgICAgY29uc3QgbWVudUV2ZW50U2NvcGUgPSBhd2FpdCB0aGlzLnJlZ2lzdGVyTWVudUV2ZW50SGFuZGxlcnMoeyBjb21tYW5kSGFuZGxlciwgbWVudUV2ZW50UmVnaXN0cmFyOiB0aGlzLm1lbnVFdmVudFJlZ2lzdHJhciB9KTtcblxuICAgICAgY29uc3QgZGlzcG9zYWJsZSA9IG5ldyBDYWxsYmFja0Rpc3Bvc2FibGUoe1xuICAgICAgICBjYWxsYmFjazogKCk6IHZvaWQgPT4ge1xuICAgICAgICAgIHRoaXMuY29tbWFuZFJlZ2lzdHJhci5yZW1vdmVDb21tYW5kKGNvbW1hbmRJZCk7XG4gICAgICAgICAgbWVudUV2ZW50U2NvcGUuZGlzcG9zZSgpO1xuICAgICAgICB9XG4gICAgICB9KTtcbiAgICAgIC8vIFRpZSByZW1vdmFsIHRvIHRoZSBjb21wb25lbnQncyB1bmxvYWQsIHNvIGEgY29tbWFuZCBuZXZlciBvdXRsaXZlcyB0aGUgY29tcG9uZW50LlxuICAgICAgZGlzcG9zYWJsZXMucHVzaCh0aGlzLnJlZ2lzdGVyRGlzcG9zYWJsZShkaXNwb3NhYmxlKSk7XG4gICAgfVxuXG4gICAgLy8gRXZlcnkgYWRkaXRpb25hbCBzdXJmYWNlIGdldHMgaXRzIE9XTiBoYW5kbGVyIGluc3RhbmNlcyBcdTIwMTQgYSBoYW5kbGVyIGNhcnJpZXMgcGVyLXJlZ2lzdHJhdGlvblxuICAgIC8vIFN0YXRlLCBzbyBvbmUgaW5zdGFuY2UgY2Fubm90IHNlcnZlIHR3byBzdXJmYWNlcyBcdTIwMTQgYW5kIHRha2VzIHRoZW0gd2l0aCB0aGUgc2VjdGlvbiBzdWJtZW51XG4gICAgLy8gRm9yY2VkIG9mZiwgYmVjYXVzZSBzdWNoIGEgc3VyZmFjZSB3cmFwcyBldmVyeXRoaW5nIGluIGEgcGx1Z2luLXRpdGxlZCBwYXJlbnQgZW50cnkgb2YgaXRzIG93bi5cbiAgICBmb3IgKGNvbnN0IGFkZGl0aW9uYWxNZW51RXZlbnRSZWdpc3RyYXIgb2YgdGhpcy5hZGRpdGlvbmFsTWVudUV2ZW50UmVnaXN0cmFycykge1xuICAgICAgZm9yIChjb25zdCBjb21tYW5kSGFuZGxlciBvZiBjb21tYW5kSGFuZGxlckZhY3RvcnkoKSkge1xuICAgICAgICBkaXNwb3NhYmxlcy5wdXNoKHRoaXMucmVnaXN0ZXJEaXNwb3NhYmxlKGF3YWl0IHRoaXMucmVnaXN0ZXJNZW51RXZlbnRIYW5kbGVycyh7IGNvbW1hbmRIYW5kbGVyLCBtZW51RXZlbnRSZWdpc3RyYXI6IGFkZGl0aW9uYWxNZW51RXZlbnRSZWdpc3RyYXIsIHNob3VsZEFkZENvbW1hbmRUb1N1Ym1lbnU6IGZhbHNlIH0pKSk7XG4gICAgICB9XG4gICAgfVxuXG4gICAgcmV0dXJuIG5ldyBDb21iaW5lRGlzcG9zYWJsZSh7IGRpc3Bvc2FibGVzIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIEhhbmRzIGEgY29tbWFuZCBoYW5kbGVyIGl0cyByZWdpc3RyYXRpb24gY29udGV4dCwgc2NvcGVkIHNvIHRoYXQgZGlzcG9zaW5nIHRoZSByZXR1cm5lZCBzY29wZVxuICAgKiB1bnJlZ2lzdGVycyBleGFjdGx5IHRoZSBtZW51IGV2ZW50cyB0aGF0IGhhbmRsZXIgcmVnaXN0ZXJlZC5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIGZvciB0aGlzIHJlZ2lzdHJhdGlvbi5cbiAgICogQHJldHVybnMgVGhlIGhhbmRsZXIncyBtZW51LWV2ZW50IHNjb3BlLlxuICAgKi9cbiAgcHJpdmF0ZSBhc3luYyByZWdpc3Rlck1lbnVFdmVudEhhbmRsZXJzKHBhcmFtczogQ29tbWFuZEhhbmRsZXJDb21wb25lbnRSZWdpc3Rlck1lbnVFdmVudEhhbmRsZXJzUGFyYW1zKTogUHJvbWlzZTxDb21tYW5kTWVudUV2ZW50U2NvcGU+IHtcbiAgICBjb25zdCBtZW51RXZlbnRTY29wZSA9IG5ldyBDb21tYW5kTWVudUV2ZW50U2NvcGUocGFyYW1zLm1lbnVFdmVudFJlZ2lzdHJhcik7XG4gICAgY29uc3QgY29udGV4dDogQ29tbWFuZEhhbmRsZXJSZWdpc3RyYXRpb25Db250ZXh0ID0ge1xuICAgICAgYWN0aXZlRmlsZVByb3ZpZGVyOiB0aGlzLmFjdGl2ZUZpbGVQcm92aWRlcixcbiAgICAgIG1lbnVFdmVudFJlZ2lzdHJhcjogbWVudUV2ZW50U2NvcGUsXG4gICAgICBwbHVnaW5OYW1lOiB0aGlzLnBsdWdpbk5hbWUsXG4gICAgICBzaG91bGRBZGRDb21tYW5kVG9TdWJtZW51OiBwYXJhbXMuc2hvdWxkQWRkQ29tbWFuZFRvU3VibWVudVxuICAgIH07XG4gICAgYXdhaXQgcGFyYW1zLmNvbW1hbmRIYW5kbGVyLm9uUmVnaXN0ZXJlZChjb250ZXh0KTtcbiAgICByZXR1cm4gbWVudUV2ZW50U2NvcGU7XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBb0JBLHdCQUlPO0FBQ1AsMEJBQTRCO0FBd0M1QixNQUFNLDhCQUE4QixpQ0FBNkM7QUFBQSxFQUd4RSxZQUE2QixPQUEyQjtBQUM3RCxVQUFNO0FBRDRCO0FBQUEsRUFFcEM7QUFBQSxFQUZvQztBQUFBLEVBRm5CLGNBQThCLENBQUM7QUFBQSxFQU16QywrQkFBK0IsU0FBK0M7QUFDbkYsV0FBTyxLQUFLLFFBQVEsS0FBSyxNQUFNLCtCQUErQixPQUFPLENBQUM7QUFBQSxFQUN4RTtBQUFBLEVBRU8sNkJBQTZCLFNBQTZDO0FBQy9FLFdBQU8sS0FBSyxRQUFRLEtBQUssTUFBTSw2QkFBNkIsT0FBTyxDQUFDO0FBQUEsRUFDdEU7QUFBQSxFQUVPLDhCQUE4QixTQUE4QztBQUNqRixXQUFPLEtBQUssUUFBUSxLQUFLLE1BQU0sOEJBQThCLE9BQU8sQ0FBQztBQUFBLEVBQ3ZFO0FBQUEsRUFFbUIsaUJBQXVCO0FBQ3hDLGVBQVcsY0FBYyxLQUFLLGFBQWE7QUFDekMsaUJBQVcsUUFBUTtBQUFBLElBQ3JCO0FBQ0EsU0FBSyxZQUFZLFNBQVM7QUFBQSxFQUM1QjtBQUFBLEVBRVEsUUFBUSxZQUF3QztBQUN0RCxRQUFJLEtBQUssWUFBWTtBQUNuQixpQkFBVyxRQUFRO0FBQUEsSUFDckIsT0FBTztBQUNMLFdBQUssWUFBWSxLQUFLLFVBQVU7QUFBQSxJQUNsQztBQUVBLFdBQU87QUFBQSxFQUNUO0FBQ0Y7QUFhTyxNQUFNLGdDQUFnQyxnQ0FBWTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBSXBDO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU1BO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFLQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBS0E7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT1osWUFBWSxRQUFrRDtBQUNuRSxVQUFNO0FBQ04sU0FBSyxxQkFBcUIsT0FBTztBQUNqQyxTQUFLLHFCQUFxQixPQUFPO0FBQ2pDLFNBQUssZ0NBQWdDLE9BQU8saUNBQWlDLENBQUM7QUFDOUUsU0FBSyxtQkFBbUIsT0FBTztBQUMvQixTQUFLLGFBQWEsT0FBTztBQUFBLEVBQzNCO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBZ0JBLE1BQWEsd0JBQXdCLHVCQUFxRTtBQUN4RyxVQUFNLGNBQTRCLENBQUM7QUFDbkMsZUFBVyxrQkFBa0Isc0JBQXNCLEdBQUc7QUFDcEQsWUFBTSxVQUFVLGVBQWUsYUFBYTtBQUk1QyxZQUFNLFlBQVksUUFBUTtBQUMxQixXQUFLLGlCQUFpQixXQUFXLE9BQU87QUFJeEMsWUFBTSxpQkFBaUIsTUFBTSxLQUFLLDBCQUEwQixFQUFFLGdCQUFnQixvQkFBb0IsS0FBSyxtQkFBbUIsQ0FBQztBQUUzSCxZQUFNLGFBQWEsSUFBSSxxQ0FBbUI7QUFBQSxRQUN4QyxVQUFVLE1BQVk7QUFDcEIsZUFBSyxpQkFBaUIsY0FBYyxTQUFTO0FBQzdDLHlCQUFlLFFBQVE7QUFBQSxRQUN6QjtBQUFBLE1BQ0YsQ0FBQztBQUVELGtCQUFZLEtBQUssS0FBSyxtQkFBbUIsVUFBVSxDQUFDO0FBQUEsSUFDdEQ7QUFLQSxlQUFXLGdDQUFnQyxLQUFLLCtCQUErQjtBQUM3RSxpQkFBVyxrQkFBa0Isc0JBQXNCLEdBQUc7QUFDcEQsb0JBQVksS0FBSyxLQUFLLG1CQUFtQixNQUFNLEtBQUssMEJBQTBCLEVBQUUsZ0JBQWdCLG9CQUFvQiw4QkFBOEIsMkJBQTJCLE1BQU0sQ0FBQyxDQUFDLENBQUM7QUFBQSxNQUN4TDtBQUFBLElBQ0Y7QUFFQSxXQUFPLElBQUksb0NBQWtCLEVBQUUsWUFBWSxDQUFDO0FBQUEsRUFDOUM7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBU0EsTUFBYywwQkFBMEIsUUFBZ0c7QUFDdEksVUFBTSxpQkFBaUIsSUFBSSxzQkFBc0IsT0FBTyxrQkFBa0I7QUFDMUUsVUFBTSxVQUE2QztBQUFBLE1BQ2pELG9CQUFvQixLQUFLO0FBQUEsTUFDekIsb0JBQW9CO0FBQUEsTUFDcEIsWUFBWSxLQUFLO0FBQUEsTUFDakIsMkJBQTJCLE9BQU87QUFBQSxJQUNwQztBQUNBLFVBQU0sT0FBTyxlQUFlLGFBQWEsT0FBTztBQUNoRCxXQUFPO0FBQUEsRUFDVDtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/cjs/obsidian/command-handlers/command-handler-component.d.cts

@@ -10,8 +10,25 @@ import type { CommandRegistrar } from '../command-registrar.cjs';
 import type { MenuEventRegistrar } from '../menu-event-registrar.cjs';
 import type { CommandHandler } from './command-handler.cjs';
 import { ComponentEx } from '../components/component-ex.cjs';
+/**
+ * Builds a fresh set of {@link CommandHandler}s.
+ *
+ * A factory rather than a ready-made array because {@link CommandHandlerComponent} registers the same
+ * handlers against several menu surfaces, and a handler carries per-registration state (its
+ * active-file provider, its plugin name, and whatever a subclass records in
+ * {@link CommandHandler.onRegistered}) — so every surface needs its own instances.
+ *
+ * Returning shared instances (`() => [handler1Singleton, handler2Singleton]`) reintroduces exactly the
+ * bug the factory exists to avoid, so it is not merely discouraged: {@link CommandHandler.onRegistered}
+ * throws on the second registration of an instance. {@link CommandHandlerComponent.registerCommandHandlers}
+ * awaits it, so that throw rejects the caller's promise instead of degrading into a wrong context menu.
+ *
+ * @returns The command handlers to register. A NEW instance of each on every call.
+ */
+export type CommandHandlerFactory = () => CommandHandler[];
 interface CommandHandlerComponentConstructorParams {
     readonly activeFileProvider: ActiveFileProvider;
+    readonly additionalMenuEventRegistrars?: readonly MenuEventRegistrar[] | undefined;
     readonly commandRegistrar: CommandRegistrar;
     readonly menuEventRegistrar: MenuEventRegistrar;
     readonly pluginName: string;
@@ -23,12 +40,20 @@ interface CommandHandlerComponentConstructorParams {
  * needed while the component is alive); dispose the returned {@link DisposableEx} to unregister exactly
  * those handlers — including any menu events they registered — or let the component unload to remove every
  * command still registered through it.
+ *
+ * The same handlers are fed to every menu surface the component knows about: Obsidian's own workspace
+ * events, plus each additional {@link MenuEventRegistrar} bridging another plugin's menus.
  */
 export declare class CommandHandlerComponent extends ComponentEx {
     /**
      * Provider for accessing the currently active file.
      */
     protected readonly activeFileProvider: ActiveFileProvider;
+    /**
+     * Registrars for menu surfaces that build their own plugin-titled parent entry, and therefore take
+     * the handlers with their section submenu forced off.
+     */
+    protected readonly additionalMenuEventRegistrars: readonly MenuEventRegistrar[];
     /**
      * Registrar used to add and remove commands with Obsidian.
      */
@@ -48,15 +73,27 @@ export declare class CommandHandlerComponent extends ComponentEx {
      */
     constructor(params: CommandHandlerComponentConstructorParams);
     /**
-     * Registers the given command handlers with Obsidian and provides 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.
+     * 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.
+     *
+     * @param commandHandlerFactory - Builds a fresh set of command handlers, once per menu surface.
+     * @returns A {@link DisposableEx} that unregisters the handlers (commands + menu events) registered by this call.
+     */
+    registerCommandHandlers(commandHandlerFactory: CommandHandlerFactory): Promise<DisposableEx>;
+    /**
+     * Hands a command handler its registration context, scoped so that disposing the returned scope
+     * unregisters exactly the menu events that handler registered.
      *
-     * @param commandHandlers - The command handlers to register.
-     * @returns A {@link DisposableEx} that unregisters the handlers (commands + menu events) passed to this call.
+     * @param params - The parameters for this registration.
+     * @returns The handler's menu-event scope.
      */
-    registerCommandHandlers(commandHandlers: CommandHandler[]): DisposableEx;
+    private registerMenuEventHandlers;
 }
 export {};

package/dist/lib/cjs/obsidian/command-handlers/command-handler.cjs

@@ -40,16 +40,11 @@ if you want to view the source, please visit the github repository of this plugi
     globalThisRecord[key] ??= newFuncs[key]?.();
   }
 
-  function name(obj) {
-    return obj;
-  }
-
   function extractDefault(module) {
     return module && module.__esModule && 'default' in module ? module.default : module;
   }
 
-  const OBSIDIAN_BUILT_IN_MODULE_NAMES = [
-  'obsidian',
+  const OBSIDIAN_BUILT_IN_MODULE_NAMES = new Set([
   '@codemirror/autocomplete',
   '@codemirror/collab',
   '@codemirror/commands',
@@ -60,11 +55,12 @@ if you want to view the source, please visit the github repository of this plugi
   '@codemirror/text',
   '@codemirror/view',
   '@lezer/common',
+  '@lezer/highlight',
   '@lezer/lr',
-  '@lezer/highlight'];
+  'obsidian']
+  );
 
-
-  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = [
+  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = new Set([
   '@codemirror/closebrackets',
   '@codemirror/comment',
   '@codemirror/fold',
@@ -76,11 +72,11 @@ if you want to view the source, please visit the github repository of this plugi
   '@codemirror/rangeset',
   '@codemirror/rectangular-selection',
   '@codemirror/stream-parser',
-  '@codemirror/tooltip'];
-
+  '@codemirror/tooltip']
+  );
 
   function requirePatched(id) {
-    if (OBSIDIAN_BUILT_IN_MODULE_NAMES.includes(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.includes(id)) {
+    if (OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id)) {
       return originalRequire?.(id);
     }
 
@@ -89,8 +85,8 @@ if you want to view the source, please visit the github repository of this plugi
       if (id === 'process' || id === 'node:process') {
         // eslint-disable-next-line no-console -- Valid usage.
         console.debug(`The most likely you can safely ignore this error. Module not found: ${id}. Fake process object is returned instead.`);
-        // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
-        return globalThis.process;
+
+        return process;
       }
     } else {
       const module = originalRequire?.(id);
@@ -166,10 +162,23 @@ class CommandHandler {
    * 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 (0, import_function.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;
   }
 }
@@ -177,4 +186,4 @@ class CommandHandler {
 0 && (module.exports = {
   CommandHandler
 });
-//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbW1hbmQtaGFuZGxlcnMvY29tbWFuZC1oYW5kbGVyLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQmFzZSBjbGFzcyBhbmQgaW50ZXJmYWNlcyBmb3IgY29tbWFuZCBoYW5kbGVycy5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7XG4gIENvbW1hbmQsXG4gIEljb25OYW1lXG59IGZyb20gJ29ic2lkaWFuJztcblxuaW1wb3J0IHR5cGUgeyBBY3RpdmVGaWxlUHJvdmlkZXIgfSBmcm9tICcuLi9hY3RpdmUtZmlsZS1wcm92aWRlci50cyc7XG5pbXBvcnQgdHlwZSB7IE1lbnVFdmVudFJlZ2lzdHJhciB9IGZyb20gJy4uL21lbnUtZXZlbnQtcmVnaXN0cmFyLnRzJztcblxuaW1wb3J0IHsgbm9vcEFzeW5jIH0gZnJvbSAnLi4vLi4vZnVuY3Rpb24udHMnO1xuaW1wb3J0IHsgZW5zdXJlTm9uTnVsbGFibGUgfSBmcm9tICcuLi8uLi90eXBlLWd1YXJkcy50cyc7XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3IgY3JlYXRpbmcgYSBjb21tYW5kIGhhbmRsZXIuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ29tbWFuZEhhbmRsZXJDb25zdHJ1Y3RvclBhcmFtcyB7XG4gIC8qKlxuICAgKiBUaGUgaWNvbiBmb3IgdGhlIGNvbW1hbmQuXG4gICAqL1xuICByZWFkb25seSBpY29uOiBJY29uTmFtZTtcblxuICAvKipcbiAgICogVGhlIElEIG9mIHRoZSBjb21tYW5kLlxuICAgKi9cbiAgcmVhZG9ubHkgaWQ6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIGRpc3BsYXkgbmFtZSBvZiB0aGUgY29tbWFuZC5cbiAgICovXG4gIHJlYWRvbmx5IG5hbWU6IHN0cmluZztcbn1cblxuLyoqXG4gKiBDb250ZXh0IHByb3ZpZGVkIHRvIGNvbW1hbmQgaGFuZGxlcnMgZHVyaW5nIHJlZ2lzdHJhdGlvbi5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBDb21tYW5kSGFuZGxlclJlZ2lzdHJhdGlvbkNvbnRleHQge1xuICAvKipcbiAgICogUHJvdmlkZXIgZm9yIGFjY2Vzc2luZyB0aGUgY3VycmVudGx5IGFjdGl2ZSBmaWxlLlxuICAgKi9cbiAgcmVhZG9ubHkgYWN0aXZlRmlsZVByb3ZpZGVyOiBBY3RpdmVGaWxlUHJvdmlkZXI7XG5cbiAgLyoqXG4gICAqIFJlZ2lzdHJhciBmb3IgbWVudSBldmVudCBoYW5kbGVycy5cbiAgICovXG4gIHJlYWRvbmx5IG1lbnVFdmVudFJlZ2lzdHJhcjogTWVudUV2ZW50UmVnaXN0cmFyO1xuXG4gIC8qKlxuICAgKiBUaGUgbmFtZSBvZiB0aGUgcGx1Z2luIHRoYXQgb3ducyB0aGlzIGNvbW1hbmQuXG4gICAqL1xuICByZWFkb25seSBwbHVnaW5OYW1lOiBzdHJpbmc7XG59XG5cbi8qKlxuICogQmFzZSBjbGFzcyBmb3IgY29tbWFuZCBoYW5kbGVycy5cbiAqXG4gKiBVbmxpa2UgdGhlIE9ic2lkaWFuIHtAbGluayBDb21tYW5kfSBpbnRlcmZhY2UsIGhhbmRsZXJzIGFyZSBuZXZlciBtdXRhdGVkIGJ5IE9ic2lkaWFuLlxuICogVGhlIHtAbGluayBidWlsZENvbW1hbmR9IG1ldGhvZCBwcm9kdWNlcyBhIHBsYWluIHtAbGluayBDb21tYW5kfSBvYmplY3QgZm9yIHJlZ2lzdHJhdGlvbi5cbiAqL1xuZXhwb3J0IGFic3RyYWN0IGNsYXNzIENvbW1hbmRIYW5kbGVyIHtcbiAgLyoqXG4gICAqIFRoZSBpY29uIGZvciB0aGUgY29tbWFuZC5cbiAgICovXG4gIHByb3RlY3RlZCByZWFkb25seSBpY29uOiBJY29uTmFtZTtcblxuICAvKipcbiAgICogVGhlIElEIG9mIHRoZSBjb21tYW5kLlxuICAgKi9cbiAgcHJvdGVjdGVkIHJlYWRvbmx5IGlkOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBkaXNwbGF5IG5hbWUgb2YgdGhlIGNvbW1hbmQuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgbmFtZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBHZXRzIHRoZSBwbHVnaW4gbmFtZS5cbiAgICpcbiAgICogQHJldHVybnMgVGhlIHBsdWdpbiBuYW1lLlxuICAgKi9cbiAgcHJvdGVjdGVkIGdldCBwbHVnaW5OYW1lKCk6IHN0cmluZyB7XG4gICAgcmV0dXJuIGVuc3VyZU5vbk51bGxhYmxlKHRoaXMuX3BsdWdpbk5hbWUpO1xuICB9XG5cbiAgcHJpdmF0ZSBfcGx1Z2luTmFtZT86IHN0cmluZztcblxuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBjb21tYW5kIGhhbmRsZXIuXG4gICAqXG4gICAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycyBmb3IgdGhlIGNvbW1hbmQgaGFuZGxlci5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3RvcihwYXJhbXM6IENvbW1hbmRIYW5kbGVyQ29uc3RydWN0b3JQYXJhbXMpIHtcbiAgICB0aGlzLmljb24gPSBwYXJhbXMuaWNvbjtcbiAgICB0aGlzLmlkID0gcGFyYW1zLmlkO1xuICAgIHRoaXMubmFtZSA9IHBhcmFtcy5uYW1lO1xuICB9XG5cbiAgLyoqXG4gICAqIEJ1aWxkcyBhIHBsYWluIE9ic2lkaWFuIHtAbGluayBDb21tYW5kfSBvYmplY3QgZm9yIHJlZ2lzdHJhdGlvbi5cbiAgICpcbiAgICogQHJldHVybnMgQSBuZXcge0BsaW5rIENvbW1hbmR9IG9iamVjdC4gT2JzaWRpYW4gbWF5IG11dGF0ZSB0aGlzIG9iamVjdCBhZnRlciByZWdpc3RyYXRpb24uXG4gICAqL1xuICBwdWJsaWMgYWJzdHJhY3QgYnVpbGRDb21tYW5kKCk6IENvbW1hbmQ7XG5cbiAgLyoqXG4gICAqIENhbGxlZCBhZnRlciB0aGUgY29tbWFuZCBoYXMgYmVlbiByZWdpc3RlcmVkIHdpdGggT2JzaWRpYW4uXG4gICAqIFN1YmNsYXNzZXMgdXNlIHRoZSBwcm92aWRlZCBjb250ZXh0IHRvIHJlZ2lzdGVyIG1lbnUgZXZlbnQgaGFuZGxlcnMuXG4gICAqXG4gICAqIEBwYXJhbSBjb250ZXh0IC0gVGhlIHJlZ2lzdHJhdGlvbiBjb250ZXh0IHByb3ZpZGluZyBydW50aW1lIGNhcGFiaWxpdGllcy5cbiAgICovXG4gIHB1YmxpYyBhc3luYyBvblJlZ2lzdGVyZWQoY29udGV4dDogQ29tbWFuZEhhbmRsZXJSZWdpc3RyYXRpb25Db250ZXh0KTogUHJvbWlzZTx2b2lkPiB7XG4gICAgYXdhaXQgbm9vcEFzeW5jKCk7XG4gICAgdGhpcy5fcGx1Z2luTmFtZSA9IGNvbnRleHQucGx1Z2luTmFtZTtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBY0Esc0JBQTBCO0FBQzFCLHlCQUFrQztBQWdEM0IsTUFBZSxlQUFlO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFJaEI7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFLQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9uQixJQUFjLGFBQXFCO0FBQ2pDLGVBQU8sc0NBQWtCLEtBQUssV0FBVztBQUFBLEVBQzNDO0FBQUEsRUFFUTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9ELFlBQVksUUFBeUM7QUFDMUQsU0FBSyxPQUFPLE9BQU87QUFDbkIsU0FBSyxLQUFLLE9BQU87QUFDakIsU0FBSyxPQUFPLE9BQU87QUFBQSxFQUNyQjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBZUEsTUFBYSxhQUFhLFNBQTJEO0FBQ25GLGNBQU0sMkJBQVU7QUFDaEIsU0FBSyxjQUFjLFFBQVE7QUFBQSxFQUM3QjtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbW1hbmQtaGFuZGxlcnMvY29tbWFuZC1oYW5kbGVyLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQmFzZSBjbGFzcyBhbmQgaW50ZXJmYWNlcyBmb3IgY29tbWFuZCBoYW5kbGVycy5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7XG4gIENvbW1hbmQsXG4gIEljb25OYW1lXG59IGZyb20gJ29ic2lkaWFuJztcblxuaW1wb3J0IHR5cGUgeyBBY3RpdmVGaWxlUHJvdmlkZXIgfSBmcm9tICcuLi9hY3RpdmUtZmlsZS1wcm92aWRlci50cyc7XG5pbXBvcnQgdHlwZSB7IE1lbnVFdmVudFJlZ2lzdHJhciB9IGZyb20gJy4uL21lbnUtZXZlbnQtcmVnaXN0cmFyLnRzJztcblxuaW1wb3J0IHsgbm9vcEFzeW5jIH0gZnJvbSAnLi4vLi4vZnVuY3Rpb24udHMnO1xuaW1wb3J0IHsgZW5zdXJlTm9uTnVsbGFibGUgfSBmcm9tICcuLi8uLi90eXBlLWd1YXJkcy50cyc7XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3IgY3JlYXRpbmcgYSBjb21tYW5kIGhhbmRsZXIuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ29tbWFuZEhhbmRsZXJDb25zdHJ1Y3RvclBhcmFtcyB7XG4gIC8qKlxuICAgKiBUaGUgaWNvbiBmb3IgdGhlIGNvbW1hbmQuXG4gICAqL1xuICByZWFkb25seSBpY29uOiBJY29uTmFtZTtcblxuICAvKipcbiAgICogVGhlIElEIG9mIHRoZSBjb21tYW5kLlxuICAgKi9cbiAgcmVhZG9ubHkgaWQ6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIGRpc3BsYXkgbmFtZSBvZiB0aGUgY29tbWFuZC5cbiAgICovXG4gIHJlYWRvbmx5IG5hbWU6IHN0cmluZztcbn1cblxuLyoqXG4gKiBDb250ZXh0IHByb3ZpZGVkIHRvIGNvbW1hbmQgaGFuZGxlcnMgZHVyaW5nIHJlZ2lzdHJhdGlvbi5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBDb21tYW5kSGFuZGxlclJlZ2lzdHJhdGlvbkNvbnRleHQge1xuICAvKipcbiAgICogUHJvdmlkZXIgZm9yIGFjY2Vzc2luZyB0aGUgY3VycmVudGx5IGFjdGl2ZSBmaWxlLlxuICAgKi9cbiAgcmVhZG9ubHkgYWN0aXZlRmlsZVByb3ZpZGVyOiBBY3RpdmVGaWxlUHJvdmlkZXI7XG5cbiAgLyoqXG4gICAqIFJlZ2lzdHJhciBmb3IgbWVudSBldmVudCBoYW5kbGVycy5cbiAgICovXG4gIHJlYWRvbmx5IG1lbnVFdmVudFJlZ2lzdHJhcjogTWVudUV2ZW50UmVnaXN0cmFyO1xuXG4gIC8qKlxuICAgKiBUaGUgbmFtZSBvZiB0aGUgcGx1Z2luIHRoYXQgb3ducyB0aGlzIGNvbW1hbmQuXG4gICAqL1xuICByZWFkb25seSBwbHVnaW5OYW1lOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIE92ZXJyaWRlcyB0aGUgaGFuZGxlcidzIG93biBgc2hvdWxkQWRkQ29tbWFuZFRvU3VibWVudWAsIG9yIGB1bmRlZmluZWRgIHRvIGxlYXZlIGl0IGFsb25lLlxuICAgKlxuICAgKiBBIG1lbnUgc3VyZmFjZSB0aGF0IGFscmVhZHkgd3JhcHMgZXZlcnkgY29udHJpYnV0ZWQgaXRlbSBpbiBhIHBsdWdpbi10aXRsZWQgcGFyZW50IGVudHJ5IFx1MjAxNCBzdWNoIGFzXG4gICAqIGBOb3RlYm9va05hdmlnYXRvck1lbnVFdmVudFJlZ2lzdHJhckNvbXBvbmVudGAgXHUyMDE0IHNldHMgdGhpcyB0byBgZmFsc2VgLCBiZWNhdXNlIGEgaGFuZGxlciBkZWNsYXJpbmdcbiAgICogYSBzZWN0aW9uIHN1Ym1lbnUgb2YgaXRzIG93biB3b3VsZCBtYWtlIGBNZW51LnNvcnQoKWAgbmVzdCBhIHNlY29uZCBwbHVnaW4tdGl0bGVkIGVudHJ5IGluc2lkZSB0aGVcbiAgICogZmlyc3QuIE9ubHkgYEFic3RyYWN0RmlsZUNvbW1hbmRIYW5kbGVyYCByZWFkcyBpdDogdGhlIHN1cmZhY2VzIHRoYXQgbmVlZCBpdCBicmlkZ2UgZmlsZSBhbmRcbiAgICogZm9sZGVyIG1lbnVzLCBuZXZlciB0aGUgZWRpdG9yIG1lbnUuXG4gICAqL1xuICByZWFkb25seSBzaG91bGRBZGRDb21tYW5kVG9TdWJtZW51PzogYm9vbGVhbiB8IHVuZGVmaW5lZDtcbn1cblxuLyoqXG4gKiBCYXNlIGNsYXNzIGZvciBjb21tYW5kIGhhbmRsZXJzLlxuICpcbiAqIFVubGlrZSB0aGUgT2JzaWRpYW4ge0BsaW5rIENvbW1hbmR9IGludGVyZmFjZSwgaGFuZGxlcnMgYXJlIG5ldmVyIG11dGF0ZWQgYnkgT2JzaWRpYW4uXG4gKiBUaGUge0BsaW5rIGJ1aWxkQ29tbWFuZH0gbWV0aG9kIHByb2R1Y2VzIGEgcGxhaW4ge0BsaW5rIENvbW1hbmR9IG9iamVjdCBmb3IgcmVnaXN0cmF0aW9uLlxuICovXG5leHBvcnQgYWJzdHJhY3QgY2xhc3MgQ29tbWFuZEhhbmRsZXIge1xuICAvKipcbiAgICogVGhlIGljb24gZm9yIHRoZSBjb21tYW5kLlxuICAgKi9cbiAgcHJvdGVjdGVkIHJlYWRvbmx5IGljb246IEljb25OYW1lO1xuXG4gIC8qKlxuICAgKiBUaGUgSUQgb2YgdGhlIGNvbW1hbmQuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgaWQ6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIGRpc3BsYXkgbmFtZSBvZiB0aGUgY29tbWFuZC5cbiAgICovXG4gIHByb3RlY3RlZCByZWFkb25seSBuYW1lOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEdldHMgdGhlIHBsdWdpbiBuYW1lLlxuICAgKlxuICAgKiBAcmV0dXJucyBUaGUgcGx1Z2luIG5hbWUuXG4gICAqL1xuICBwcm90ZWN0ZWQgZ2V0IHBsdWdpbk5hbWUoKTogc3RyaW5nIHtcbiAgICByZXR1cm4gZW5zdXJlTm9uTnVsbGFibGUodGhpcy5fcGx1Z2luTmFtZSk7XG4gIH1cblxuICBwcml2YXRlIF9wbHVnaW5OYW1lPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IGNvbW1hbmQgaGFuZGxlci5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIGZvciB0aGUgY29tbWFuZCBoYW5kbGVyLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHBhcmFtczogQ29tbWFuZEhhbmRsZXJDb25zdHJ1Y3RvclBhcmFtcykge1xuICAgIHRoaXMuaWNvbiA9IHBhcmFtcy5pY29uO1xuICAgIHRoaXMuaWQgPSBwYXJhbXMuaWQ7XG4gICAgdGhpcy5uYW1lID0gcGFyYW1zLm5hbWU7XG4gIH1cblxuICAvKipcbiAgICogQnVpbGRzIGEgcGxhaW4gT2JzaWRpYW4ge0BsaW5rIENvbW1hbmR9IG9iamVjdCBmb3IgcmVnaXN0cmF0aW9uLlxuICAgKlxuICAgKiBAcmV0dXJucyBBIG5ldyB7QGxpbmsgQ29tbWFuZH0gb2JqZWN0LiBPYnNpZGlhbiBtYXkgbXV0YXRlIHRoaXMgb2JqZWN0IGFmdGVyIHJlZ2lzdHJhdGlvbi5cbiAgICovXG4gIHB1YmxpYyBhYnN0cmFjdCBidWlsZENvbW1hbmQoKTogQ29tbWFuZDtcblxuICAvKipcbiAgICogQ2FsbGVkIGFmdGVyIHRoZSBjb21tYW5kIGhhcyBiZWVuIHJlZ2lzdGVyZWQgd2l0aCBPYnNpZGlhbi5cbiAgICogU3ViY2xhc3NlcyB1c2UgdGhlIHByb3ZpZGVkIGNvbnRleHQgdG8gcmVnaXN0ZXIgbWVudSBldmVudCBoYW5kbGVycy5cbiAgICpcbiAgICogVGhyb3dzIHdoZW4gdGhlIHNhbWUgaW5zdGFuY2UgaXMgcmVnaXN0ZXJlZCB0d2ljZS4gQSBoYW5kbGVyIHN0b3JlcyBwZXItcmVnaXN0cmF0aW9uIHN0YXRlIFx1MjAxNCB0aGVcbiAgICogcGx1Z2luIG5hbWUgaGVyZSwgdGhlIGFjdGl2ZS1maWxlIHByb3ZpZGVyIGFuZCB0aGUgc3VibWVudSBvdmVycmlkZSBpbiBgQWJzdHJhY3RGaWxlQ29tbWFuZEhhbmRsZXJgLFxuICAgKiBwbHVzIHdoYXRldmVyIGEgc3ViY2xhc3MgcmVjb3JkcyBcdTIwMTQgYW5kIHRoZSBtZW51IGNsb3N1cmVzIHJlZ2lzdGVyZWQgaGVyZSByZWFkIHRoYXQgc3RhdGUgbGF6aWx5LCBhdFxuICAgKiBtZW51LXJlbmRlciB0aW1lLiBTbyBhIHNlY29uZCByZWdpc3RyYXRpb24gc2lsZW50bHkgcmV3cml0ZXMgd2hhdCB0aGUgZmlyc3QgcmVnaXN0cmF0aW9uJ3MgY2xvc3VyZXNcbiAgICogd2lsbCBzZWUuIGBDb21tYW5kSGFuZGxlckNvbXBvbmVudGAgcmVnaXN0ZXJzIGEgaGFuZGxlciBzZXQgb25jZSBwZXIgbWVudSBzdXJmYWNlLCB3aGljaCBpcyB3aHlcbiAgICogYENvbW1hbmRIYW5kbGVyRmFjdG9yeWAgbXVzdCBidWlsZCBGUkVTSCBpbnN0YW5jZXMgb24gZXZlcnkgY2FsbDsgdGhpcyBndWFyZCB0dXJucyBhIGZhY3RvcnkgdGhhdFxuICAgKiBoYW5kcyBvdXQgc2hhcmVkIGluc3RhbmNlcyBpbnRvIGEgbG91ZCBmYWlsdXJlIGluc3RlYWQgb2YgYSB3cm9uZyBjb250ZXh0IG1lbnUuXG4gICAqXG4gICAqIEBwYXJhbSBjb250ZXh0IC0gVGhlIHJlZ2lzdHJhdGlvbiBjb250ZXh0IHByb3ZpZGluZyBydW50aW1lIGNhcGFiaWxpdGllcy5cbiAgICovXG4gIHB1YmxpYyBhc3luYyBvblJlZ2lzdGVyZWQoY29udGV4dDogQ29tbWFuZEhhbmRsZXJSZWdpc3RyYXRpb25Db250ZXh0KTogUHJvbWlzZTx2b2lkPiB7XG4gICAgYXdhaXQgbm9vcEFzeW5jKCk7XG4gICAgaWYgKHRoaXMuX3BsdWdpbk5hbWUgIT09IHVuZGVmaW5lZCkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgICBgQ29tbWFuZCBoYW5kbGVyICcke3RoaXMuaWR9JyBpcyBhbHJlYWR5IHJlZ2lzdGVyZWQuIEEgY29tbWFuZCBoYW5kbGVyIGluc3RhbmNlIGNhbm5vdCBiZSByZWdpc3RlcmVkIHR3aWNlIC0gdGhlIGNvbW1hbmQgaGFuZGxlciBmYWN0b3J5IG11c3QgYnVpbGQgZnJlc2ggaW5zdGFuY2VzIG9uIGV2ZXJ5IGNhbGwuYFxuICAgICAgKTtcbiAgICB9XG5cbiAgICB0aGlzLl9wbHVnaW5OYW1lID0gY29udGV4dC5wbHVnaW5OYW1lO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQWNBLHNCQUEwQjtBQUMxQix5QkFBa0M7QUEyRDNCLE1BQWUsZUFBZTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBSWhCO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFLQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBS0E7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFPbkIsSUFBYyxhQUFxQjtBQUNqQyxlQUFPLHNDQUFrQixLQUFLLFdBQVc7QUFBQSxFQUMzQztBQUFBLEVBRVE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFPRCxZQUFZLFFBQXlDO0FBQzFELFNBQUssT0FBTyxPQUFPO0FBQ25CLFNBQUssS0FBSyxPQUFPO0FBQ2pCLFNBQUssT0FBTyxPQUFPO0FBQUEsRUFDckI7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUF1QkEsTUFBYSxhQUFhLFNBQTJEO0FBQ25GLGNBQU0sMkJBQVU7QUFDaEIsUUFBSSxLQUFLLGdCQUFnQixRQUFXO0FBQ2xDLFlBQU0sSUFBSTtBQUFBLFFBQ1Isb0JBQW9CLEtBQUssRUFBRTtBQUFBLE1BQzdCO0FBQUEsSUFDRjtBQUVBLFNBQUssY0FBYyxRQUFRO0FBQUEsRUFDN0I7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/cjs/obsidian/command-handlers/command-handler.d.cts

@@ -40,6 +40,16 @@ export interface CommandHandlerRegistrationContext {
      * 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.
@@ -83,6 +93,14 @@ export declare abstract class CommandHandler {
      * 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>;