obsidian-dev-utils 55.4.1 → 56.0.1

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

@@ -0,0 +1,178 @@
+/**
+ * @file
+ *
+ * Command handler for abstract file commands with file/files menu integration.
+ */
+import type { IconName, TAbstractFile, WorkspaceLeaf } from 'obsidian';
+import type { CommandHandlerParams, CommandHandlerRegistrationContext } from './command-handler.cjs';
+import { GlobalCommandHandler } from './global-command-handler.cjs';
+/**
+ * Parameters for creating an abstract file command handler.
+ */
+export interface AbstractFileCommandHandlerParams extends CommandHandlerParams {
+    /**
+     * The item name to use in the single-file menu.
+     */
+    readonly fileMenuItemName?: string | undefined;
+    /**
+     * The section to use in the single-file menu.
+     */
+    readonly fileMenuSection?: string | undefined;
+    /**
+     * The icon to use in the single-file menu submenu.
+     */
+    readonly fileMenuSubmenuIcon?: IconName | undefined;
+    /**
+     * The item name to use in the multi-file menu.
+     */
+    readonly filesMenuItemName?: string | undefined;
+    /**
+     * The section to use in the multi-file menu.
+     */
+    readonly filesMenuSection?: string | undefined;
+    /**
+     * The icon to use in the multi-file menu submenu.
+     */
+    readonly filesMenuSubmenuIcon?: IconName | undefined;
+    /**
+     * Whether to add the command to a submenu.
+     */
+    readonly shouldAddCommandToSubmenu?: boolean | undefined;
+}
+/**
+ * Command handler for abstract file commands.
+ *
+ * Handles both single-file and multi-file context menus.
+ * Subclasses override {@link canExecuteAbstractFile} and {@link executeAbstractFile}.
+ */
+export declare abstract class AbstractFileCommandHandler extends GlobalCommandHandler {
+    /**
+     * Gets the item name to use in the single-file menu.
+     *
+     * @returns The item name, or `undefined` to use the command name.
+     */
+    protected get fileMenuItemName(): string | undefined;
+    /**
+     * Gets the section to use in the single-file menu.
+     *
+     * @returns The section name, or `undefined` to use the plugin name.
+     */
+    protected get fileMenuSection(): string | undefined;
+    /**
+     * Gets the icon to use in the single-file menu submenu.
+     *
+     * @returns The icon, or `undefined` for no icon.
+     */
+    protected get fileMenuSubmenuIcon(): IconName | undefined;
+    /**
+     * Gets the item name to use in the multi-file menu.
+     *
+     * @returns The item name, or `undefined` to fall back to single-file item name.
+     */
+    protected get filesMenuItemName(): string | undefined;
+    /**
+     * Gets the section to use in the multi-file menu.
+     *
+     * @returns The section name, or `undefined` to fall back to single-file section.
+     */
+    protected get filesMenuSection(): string | undefined;
+    /**
+     * Gets the icon to use in the multi-file menu submenu.
+     *
+     * @returns The icon, or `undefined` to fall back to single-file submenu icon.
+     */
+    protected get filesMenuSubmenuIcon(): IconName | undefined;
+    /**
+     * Gets whether to add the command to a submenu.
+     *
+     * @returns Whether to add to a submenu.
+     */
+    protected get shouldAddCommandToSubmenu(): boolean | undefined;
+    private readonly _fileMenuItemName?;
+    private readonly _fileMenuSection?;
+    private readonly _fileMenuSubmenuIcon?;
+    private readonly _filesMenuItemName?;
+    private readonly _filesMenuSection?;
+    private readonly _filesMenuSubmenuIcon?;
+    private readonly _shouldAddCommandToSubmenu?;
+    private activeFileProvider?;
+    /**
+     * Creates a new abstract file command handler.
+     *
+     * @param params - The parameters for the abstract file command handler.
+     */
+    constructor(params: AbstractFileCommandHandlerParams);
+    /**
+     * Registers file-menu and files-menu event handlers.
+     *
+     * @param context - The registration context.
+     */
+    onRegistered(context: CommandHandlerRegistrationContext): Promise<void>;
+    /**
+     * Checks whether the command can execute from the command palette.
+     * Uses the active file as the target.
+     *
+     * @returns Whether the command can execute.
+     */
+    protected canExecute(): boolean;
+    /**
+     * Checks whether the command can execute for a single abstract file.
+     *
+     * @param _abstractFile - The file or folder.
+     * @returns Whether the command can execute.
+     */
+    protected canExecuteAbstractFile(_abstractFile: TAbstractFile): boolean;
+    /**
+     * Checks whether the command can execute for multiple abstract files.
+     * Default implementation checks each file individually.
+     *
+     * @param abstractFiles - The files or folders.
+     * @returns Whether the command can execute.
+     */
+    protected canExecuteAbstractFiles(abstractFiles: TAbstractFile[]): boolean;
+    /**
+     * Executes the command from the command palette using the active file.
+     */
+    protected execute(): Promise<void>;
+    /**
+     * Executes the command for a single abstract file.
+     *
+     * @param abstractFile - The file or folder.
+     */
+    protected abstract executeAbstractFile(abstractFile: TAbstractFile): Promise<void>;
+    /**
+     * Executes the command for multiple abstract files.
+     * Default implementation executes sequentially.
+     *
+     * @param abstractFiles - The files or folders.
+     */
+    protected executeAbstractFiles(abstractFiles: TAbstractFile[]): Promise<void>;
+    /**
+     * Checks whether the command should appear in the single-file context menu.
+     *
+     * @param _abstractFile - The file or folder.
+     * @param _source - The source of the event.
+     * @param _leaf - The workspace leaf, if available.
+     * @returns Whether to add to the file menu.
+     */
+    protected shouldAddToAbstractFileMenu(_abstractFile: TAbstractFile, _source: string, _leaf?: WorkspaceLeaf): boolean;
+    /**
+     * Checks whether the command should appear in the multi-file context menu.
+     * Default implementation checks each file individually.
+     *
+     * @param abstractFiles - The files or folders.
+     * @param source - The source of the event.
+     * @param leaf - The workspace leaf, if available.
+     * @returns Whether to add to the files menu.
+     */
+    protected shouldAddToAbstractFilesMenu(abstractFiles: TAbstractFile[], source: string, leaf?: WorkspaceLeaf): boolean;
+    /**
+     * Checks whether the command should appear in the command palette.
+     *
+     * @returns Whether to add to the command palette.
+     */
+    protected shouldAddToCommandPalette(): boolean;
+    private getActiveFile;
+    private handleAbstractFileMenu;
+    private handleAbstractFilesMenu;
+}

package/dist/lib/cjs/obsidian/{commands/index.cjs → command-handlers/app-active-file-provider.cjs}

@@ -4,6 +4,7 @@ if you want to view the source, please visit the github repository of this plugi
 */
 
 (function initCjs() {
+  // eslint-disable-next-line obsidianmd/prefer-active-doc -- Actively use globalThis.
   const globalThisRecord = globalThis;
   globalThisRecord['__name'] ??= name;
   const originalRequire = require;
@@ -83,11 +84,12 @@ if you want to view the source, please visit the github repository of this plugi
       return originalRequire?.(id);
     }
 
-    // eslint-disable-next-line @typescript-eslint/no-deprecated, @typescript-eslint/no-unnecessary-condition -- We need access to app here which might not be available yet.
-    if (globalThis?.app?.isMobile) {
+    // eslint-disable-next-line @typescript-eslint/no-deprecated, obsidianmd/prefer-active-doc  -- Need access to app. Actively use globalThis.
+    if (globalThis.app.isMobile) {
       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/prefer-active-doc -- Actively use globalThis.
         return globalThis.process;
       }
     } else {
@@ -104,11 +106,9 @@ if you want to view the source, please visit the github repository of this plugi
 })();
 
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -122,38 +122,33 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var commands_exports = {};
-__export(commands_exports, {
-  abstract_file_command_base: () => abstract_file_command_base,
-  command_base: () => command_base,
-  editor_command_base: () => editor_command_base,
-  file_command_base: () => file_command_base,
-  folder_command_base: () => folder_command_base,
-  non_editor_command_base: () => non_editor_command_base
+var app_active_file_provider_exports = {};
+__export(app_active_file_provider_exports, {
+  AppActiveFileProvider: () => AppActiveFileProvider
 });
-module.exports = __toCommonJS(commands_exports);
-var abstract_file_command_base = __toESM(__extractDefault(require('./abstract-file-command-base.cjs')), 1);
-var command_base = __toESM(__extractDefault(require('./command-base.cjs')), 1);
-var editor_command_base = __toESM(__extractDefault(require('./editor-command-base.cjs')), 1);
-var file_command_base = __toESM(__extractDefault(require('./file-command-base.cjs')), 1);
-var folder_command_base = __toESM(__extractDefault(require('./folder-command-base.cjs')), 1);
-var non_editor_command_base = __toESM(__extractDefault(require('./non-editor-command-base.cjs')), 1);
+module.exports = __toCommonJS(app_active_file_provider_exports);
+class AppActiveFileProvider {
+  /**
+   * Creates a new app-backed active file provider.
+   *
+   * @param app - The Obsidian app instance.
+   */
+  constructor(app) {
+    this.app = app;
+  }
+  app;
+  /**
+   * Gets the currently active file from the workspace.
+   *
+   * @returns The active file, or `null` if no file is active.
+   */
+  getActiveFile() {
+    return this.app.workspace.getActiveFile();
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  abstract_file_command_base,
-  command_base,
-  editor_command_base,
-  file_command_base,
-  folder_command_base,
-  non_editor_command_base
+  AppActiveFileProvider
 });
-//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbW1hbmRzL2luZGV4LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKiBUSElTIElTIEEgR0VORVJBVEVEL0JVTkRMRUQgRklMRSBCWSBCVUlMRCBTQ1JJUFQgKi9cblxuZXhwb3J0ICogYXMgYWJzdHJhY3RfZmlsZV9jb21tYW5kX2Jhc2UgZnJvbSAnLi9hYnN0cmFjdC1maWxlLWNvbW1hbmQtYmFzZS50cyc7XG5leHBvcnQgKiBhcyBjb21tYW5kX2Jhc2UgZnJvbSAnLi9jb21tYW5kLWJhc2UudHMnO1xuZXhwb3J0ICogYXMgZWRpdG9yX2NvbW1hbmRfYmFzZSBmcm9tICcuL2VkaXRvci1jb21tYW5kLWJhc2UudHMnO1xuZXhwb3J0ICogYXMgZmlsZV9jb21tYW5kX2Jhc2UgZnJvbSAnLi9maWxlLWNvbW1hbmQtYmFzZS50cyc7XG5leHBvcnQgKiBhcyBmb2xkZXJfY29tbWFuZF9iYXNlIGZyb20gJy4vZm9sZGVyLWNvbW1hbmQtYmFzZS50cyc7XG5leHBvcnQgKiBhcyBub25fZWRpdG9yX2NvbW1hbmRfYmFzZSBmcm9tICcuL25vbi1lZGl0b3ItY29tbWFuZC1iYXNlLnRzJztcbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUVBLGlDQUE0QztBQUM1QyxtQkFBOEI7QUFDOUIsMEJBQXFDO0FBQ3JDLHdCQUFtQztBQUNuQywwQkFBcUM7QUFDckMsOEJBQXlDOyIsCiAgIm5hbWVzIjogW10KfQo=
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbW1hbmQtaGFuZGxlcnMvYXBwLWFjdGl2ZS1maWxlLXByb3ZpZGVyLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQXBwLWJhY2tlZCBpbXBsZW1lbnRhdGlvbiBvZiB7QGxpbmsgQWN0aXZlRmlsZVByb3ZpZGVyfS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7XG4gIEFwcCxcbiAgVEZpbGVcbn0gZnJvbSAnb2JzaWRpYW4nO1xuXG5pbXBvcnQgdHlwZSB7IEFjdGl2ZUZpbGVQcm92aWRlciB9IGZyb20gJy4vY29tbWFuZC1oYW5kbGVyLnRzJztcblxuLyoqXG4gKiB7QGxpbmsgQWN0aXZlRmlsZVByb3ZpZGVyfSBiYWNrZWQgYnkgT2JzaWRpYW4ncyB7QGxpbmsgQXBwfS5cbiAqL1xuZXhwb3J0IGNsYXNzIEFwcEFjdGl2ZUZpbGVQcm92aWRlciBpbXBsZW1lbnRzIEFjdGl2ZUZpbGVQcm92aWRlciB7XG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IGFwcC1iYWNrZWQgYWN0aXZlIGZpbGUgcHJvdmlkZXIuXG4gICAqXG4gICAqIEBwYXJhbSBhcHAgLSBUaGUgT2JzaWRpYW4gYXBwIGluc3RhbmNlLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHByaXZhdGUgcmVhZG9ubHkgYXBwOiBBcHApIHt9XG5cbiAgLyoqXG4gICAqIEdldHMgdGhlIGN1cnJlbnRseSBhY3RpdmUgZmlsZSBmcm9tIHRoZSB3b3Jrc3BhY2UuXG4gICAqXG4gICAqIEByZXR1cm5zIFRoZSBhY3RpdmUgZmlsZSwgb3IgYG51bGxgIGlmIG5vIGZpbGUgaXMgYWN0aXZlLlxuICAgKi9cbiAgcHVibGljIGdldEFjdGl2ZUZpbGUoKTogbnVsbCB8IFRGaWxlIHtcbiAgICByZXR1cm4gdGhpcy5hcHAud29ya3NwYWNlLmdldEFjdGl2ZUZpbGUoKTtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBZ0JPLE1BQU0sc0JBQW9EO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBTXhELFlBQTZCLEtBQVU7QUFBVjtBQUFBLEVBQVc7QUFBQSxFQUFYO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBTzdCLGdCQUE4QjtBQUNuQyxXQUFPLEtBQUssSUFBSSxVQUFVLGNBQWM7QUFBQSxFQUMxQztBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/cjs/obsidian/command-handlers/app-active-file-provider.d.cts

@@ -0,0 +1,25 @@
+/**
+ * @file
+ *
+ * App-backed implementation of {@link ActiveFileProvider}.
+ */
+import type { App, TFile } from 'obsidian';
+import type { ActiveFileProvider } from './command-handler.cjs';
+/**
+ * {@link ActiveFileProvider} backed by Obsidian's {@link App}.
+ */
+export declare class AppActiveFileProvider implements ActiveFileProvider {
+    private readonly app;
+    /**
+     * Creates a new app-backed active file provider.
+     *
+     * @param app - The Obsidian app instance.
+     */
+    constructor(app: App);
+    /**
+     * Gets the currently active file from the workspace.
+     *
+     * @returns The active file, or `null` if no file is active.
+     */
+    getActiveFile(): null | TFile;
+}

package/dist/lib/cjs/obsidian/command-handlers/app-menu-event-registrar.cjs

@@ -0,0 +1,173 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function initCjs() {
+  // eslint-disable-next-line obsidianmd/prefer-active-doc -- Actively use globalThis.
+  const globalThisRecord = globalThis;
+  globalThisRecord['__name'] ??= name;
+  const originalRequire = require;
+  if (originalRequire && !originalRequire.__isPatched) {
+    // eslint-disable-next-line no-global-assign, no-implicit-globals -- We need to patch the `require()` function.
+    require = Object.assign(
+      (id) => requirePatched(id),
+      originalRequire,
+      {
+        __isPatched: true
+      }
+    );
+  }
+
+  const newFuncs = {
+    __extractDefault() {
+      return extractDefault;
+    },
+    process() {
+      const browserProcess = {
+        browser: true,
+        cwd() {
+          return '/';
+        },
+        env: {},
+        platform: 'android'
+      };
+      return browserProcess;
+    }
+  };
+
+  for (const key of Object.keys(newFuncs)) {
+    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',
+  '@codemirror/autocomplete',
+  '@codemirror/collab',
+  '@codemirror/commands',
+  '@codemirror/language',
+  '@codemirror/lint',
+  '@codemirror/search',
+  '@codemirror/state',
+  '@codemirror/text',
+  '@codemirror/view',
+  '@lezer/common',
+  '@lezer/lr',
+  '@lezer/highlight'];
+
+
+  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = [
+  '@codemirror/closebrackets',
+  '@codemirror/comment',
+  '@codemirror/fold',
+  '@codemirror/gutter',
+  '@codemirror/highlight',
+  '@codemirror/history',
+  '@codemirror/matchbrackets',
+  '@codemirror/panel',
+  '@codemirror/rangeset',
+  '@codemirror/rectangular-selection',
+  '@codemirror/stream-parser',
+  '@codemirror/tooltip'];
+
+
+  function requirePatched(id) {
+    if (OBSIDIAN_BUILT_IN_MODULE_NAMES.includes(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.includes(id)) {
+      return originalRequire?.(id);
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-deprecated, obsidianmd/prefer-active-doc  -- Need access to app. Actively use globalThis.
+    if (globalThis.app.isMobile) {
+      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/prefer-active-doc -- Actively use globalThis.
+        return globalThis.process;
+      }
+    } else {
+      const module = originalRequire?.(id);
+      if (module) {
+        return extractDefault(module);
+      }
+    }
+
+    // eslint-disable-next-line no-console -- Valid usage.
+    console.debug(`The most likely you can safely ignore this error. Module not found: ${id}. Empty object is returned instead.`);
+    return {};
+  }
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var app_menu_event_registrar_exports = {};
+__export(app_menu_event_registrar_exports, {
+  AppMenuEventRegistrar: () => AppMenuEventRegistrar
+});
+module.exports = __toCommonJS(app_menu_event_registrar_exports);
+class AppMenuEventRegistrar {
+  /**
+   * Creates a new app-backed menu event registrar.
+   *
+   * @param app - The Obsidian app instance.
+   * @param component - The component for lifecycle management.
+   */
+  constructor(app, component) {
+    this.app = app;
+    this.component = component;
+  }
+  app;
+  component;
+  /**
+   * Registers a handler for the editor context menu event.
+   *
+   * @param handler - The handler to register.
+   */
+  registerEditorMenuEventHandler(handler) {
+    this.component.registerEvent(this.app.workspace.on("editor-menu", handler));
+  }
+  /**
+   * Registers a handler for the single-file context menu event.
+   *
+   * @param handler - The handler to register.
+   */
+  registerFileMenuEventHandler(handler) {
+    this.component.registerEvent(this.app.workspace.on("file-menu", handler));
+  }
+  /**
+   * Registers a handler for the multi-file context menu event.
+   *
+   * @param handler - The handler to register.
+   */
+  registerFilesMenuEventHandler(handler) {
+    this.component.registerEvent(this.app.workspace.on("files-menu", handler));
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AppMenuEventRegistrar
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbW1hbmQtaGFuZGxlcnMvYXBwLW1lbnUtZXZlbnQtcmVnaXN0cmFyLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQXBwLWJhY2tlZCBpbXBsZW1lbnRhdGlvbiBvZiB7QGxpbmsgTWVudUV2ZW50UmVnaXN0cmFyfS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7XG4gIEFwcCxcbiAgQ29tcG9uZW50XG59IGZyb20gJ29ic2lkaWFuJztcblxuaW1wb3J0IHR5cGUge1xuICBFZGl0b3JNZW51RXZlbnRIYW5kbGVyLFxuICBGaWxlTWVudUV2ZW50SGFuZGxlcixcbiAgRmlsZXNNZW51RXZlbnRIYW5kbGVyLFxuICBNZW51RXZlbnRSZWdpc3RyYXJcbn0gZnJvbSAnLi9jb21tYW5kLWhhbmRsZXIudHMnO1xuXG4vKipcbiAqIHtAbGluayBNZW51RXZlbnRSZWdpc3RyYXJ9IGJhY2tlZCBieSBPYnNpZGlhbidzIHtAbGluayBBcHB9IHdvcmtzcGFjZSBldmVudHMuXG4gKlxuICogRXZlbnQgaGFuZGxlcnMgYXJlIHJlZ2lzdGVyZWQgd2l0aCB0aGUgcHJvdmlkZWQge0BsaW5rIENvbXBvbmVudH0gZm9yIGxpZmVjeWNsZSBtYW5hZ2VtZW50LlxuICovXG5leHBvcnQgY2xhc3MgQXBwTWVudUV2ZW50UmVnaXN0cmFyIGltcGxlbWVudHMgTWVudUV2ZW50UmVnaXN0cmFyIHtcbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgYXBwLWJhY2tlZCBtZW51IGV2ZW50IHJlZ2lzdHJhci5cbiAgICpcbiAgICogQHBhcmFtIGFwcCAtIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2UuXG4gICAqIEBwYXJhbSBjb21wb25lbnQgLSBUaGUgY29tcG9uZW50IGZvciBsaWZlY3ljbGUgbWFuYWdlbWVudC5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3RvcihcbiAgICBwcml2YXRlIHJlYWRvbmx5IGFwcDogQXBwLFxuICAgIHByaXZhdGUgcmVhZG9ubHkgY29tcG9uZW50OiBDb21wb25lbnRcbiAgKSB7fVxuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYSBoYW5kbGVyIGZvciB0aGUgZWRpdG9yIGNvbnRleHQgbWVudSBldmVudC5cbiAgICpcbiAgICogQHBhcmFtIGhhbmRsZXIgLSBUaGUgaGFuZGxlciB0byByZWdpc3Rlci5cbiAgICovXG4gIHB1YmxpYyByZWdpc3RlckVkaXRvck1lbnVFdmVudEhhbmRsZXIoaGFuZGxlcjogRWRpdG9yTWVudUV2ZW50SGFuZGxlcik6IHZvaWQge1xuICAgIHRoaXMuY29tcG9uZW50LnJlZ2lzdGVyRXZlbnQodGhpcy5hcHAud29ya3NwYWNlLm9uKCdlZGl0b3ItbWVudScsIGhhbmRsZXIpKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYSBoYW5kbGVyIGZvciB0aGUgc2luZ2xlLWZpbGUgY29udGV4dCBtZW51IGV2ZW50LlxuICAgKlxuICAgKiBAcGFyYW0gaGFuZGxlciAtIFRoZSBoYW5kbGVyIHRvIHJlZ2lzdGVyLlxuICAgKi9cbiAgcHVibGljIHJlZ2lzdGVyRmlsZU1lbnVFdmVudEhhbmRsZXIoaGFuZGxlcjogRmlsZU1lbnVFdmVudEhhbmRsZXIpOiB2b2lkIHtcbiAgICB0aGlzLmNvbXBvbmVudC5yZWdpc3RlckV2ZW50KHRoaXMuYXBwLndvcmtzcGFjZS5vbignZmlsZS1tZW51JywgaGFuZGxlcikpO1xuICB9XG5cbiAgLyoqXG4gICAqIFJlZ2lzdGVycyBhIGhhbmRsZXIgZm9yIHRoZSBtdWx0aS1maWxlIGNvbnRleHQgbWVudSBldmVudC5cbiAgICpcbiAgICogQHBhcmFtIGhhbmRsZXIgLSBUaGUgaGFuZGxlciB0byByZWdpc3Rlci5cbiAgICovXG4gIHB1YmxpYyByZWdpc3RlckZpbGVzTWVudUV2ZW50SGFuZGxlcihoYW5kbGVyOiBGaWxlc01lbnVFdmVudEhhbmRsZXIpOiB2b2lkIHtcbiAgICB0aGlzLmNvbXBvbmVudC5yZWdpc3RlckV2ZW50KHRoaXMuYXBwLndvcmtzcGFjZS5vbignZmlsZXMtbWVudScsIGhhbmRsZXIpKTtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBdUJPLE1BQU0sc0JBQW9EO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFPeEQsWUFDWSxLQUNBLFdBQ2pCO0FBRmlCO0FBQ0E7QUFBQSxFQUNoQjtBQUFBLEVBRmdCO0FBQUEsRUFDQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVFaLCtCQUErQixTQUF1QztBQUMzRSxTQUFLLFVBQVUsY0FBYyxLQUFLLElBQUksVUFBVSxHQUFHLGVBQWUsT0FBTyxDQUFDO0FBQUEsRUFDNUU7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFPTyw2QkFBNkIsU0FBcUM7QUFDdkUsU0FBSyxVQUFVLGNBQWMsS0FBSyxJQUFJLFVBQVUsR0FBRyxhQUFhLE9BQU8sQ0FBQztBQUFBLEVBQzFFO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT08sOEJBQThCLFNBQXNDO0FBQ3pFLFNBQUssVUFBVSxjQUFjLEtBQUssSUFBSSxVQUFVLEdBQUcsY0FBYyxPQUFPLENBQUM7QUFBQSxFQUMzRTtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/cjs/obsidian/command-handlers/app-menu-event-registrar.d.cts

@@ -0,0 +1,41 @@
+/**
+ * @file
+ *
+ * App-backed implementation of {@link MenuEventRegistrar}.
+ */
+import type { App, Component } from 'obsidian';
+import type { EditorMenuEventHandler, FileMenuEventHandler, FilesMenuEventHandler, MenuEventRegistrar } from './command-handler.cjs';
+/**
+ * {@link MenuEventRegistrar} backed by Obsidian's {@link App} workspace events.
+ *
+ * Event handlers are registered with the provided {@link Component} for lifecycle management.
+ */
+export declare class AppMenuEventRegistrar implements MenuEventRegistrar {
+    private readonly app;
+    private readonly component;
+    /**
+     * Creates a new app-backed menu event registrar.
+     *
+     * @param app - The Obsidian app instance.
+     * @param component - The component for lifecycle management.
+     */
+    constructor(app: App, component: Component);
+    /**
+     * Registers a handler for the editor context menu event.
+     *
+     * @param handler - The handler to register.
+     */
+    registerEditorMenuEventHandler(handler: EditorMenuEventHandler): void;
+    /**
+     * Registers a handler for the single-file context menu event.
+     *
+     * @param handler - The handler to register.
+     */
+    registerFileMenuEventHandler(handler: FileMenuEventHandler): void;
+    /**
+     * Registers a handler for the multi-file context menu event.
+     *
+     * @param handler - The handler to register.
+     */
+    registerFilesMenuEventHandler(handler: FilesMenuEventHandler): void;
+}