obsidian-dev-utils 55.4.0 → 56.0.0

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

@@ -0,0 +1,143 @@
+/**
+ * @file
+ *
+ * Base class and interfaces for command handlers.
+ */
+import type { Command, Editor, IconName, MarkdownFileInfo, Menu, TAbstractFile, TFile, WorkspaceLeaf } from 'obsidian';
+/**
+ * Provides access to the currently active file.
+ */
+export interface ActiveFileProvider {
+    /**
+     * Gets the currently active file.
+     *
+     * @returns The active file, or `null` if no file is active.
+     */
+    getActiveFile(): null | TFile;
+}
+/**
+ * Parameters for creating a command handler.
+ */
+export interface CommandHandlerParams {
+    /**
+     * 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;
+    /**
+     * The name of the plugin that owns this command.
+     */
+    readonly pluginName: 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;
+}
+/**
+ * Handler for the editor context menu event.
+ *
+ * @param menu - The menu to add items to.
+ * @param editor - The editor instance.
+ * @param ctx - The markdown file context.
+ */
+export type EditorMenuEventHandler = (menu: Menu, editor: Editor, ctx: MarkdownFileInfo) => void;
+/**
+ * Handler for the single-file context menu event.
+ *
+ * @param menu - The menu to add items to.
+ * @param abstractFile - The file or folder.
+ * @param source - The source of the event.
+ * @param leaf - The workspace leaf, if available.
+ */
+export type FileMenuEventHandler = (menu: Menu, abstractFile: TAbstractFile, source: string, leaf?: WorkspaceLeaf) => void;
+/**
+ * Handler for the multi-file context menu event.
+ *
+ * @param menu - The menu to add items to.
+ * @param abstractFiles - The files or folders.
+ * @param source - The source of the event.
+ * @param leaf - The workspace leaf, if available.
+ */
+export type FilesMenuEventHandler = (menu: Menu, abstractFiles: TAbstractFile[], source: string, leaf?: WorkspaceLeaf) => void;
+/**
+ * Registers menu event handlers with lifecycle management.
+ */
+export interface MenuEventRegistrar {
+    /**
+     * 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;
+}
+/**
+ * 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.
+     */
+    readonly icon: IconName;
+    /**
+     * The ID of the command.
+     */
+    readonly id: string;
+    /**
+     * The display name of the command.
+     */
+    readonly name: string;
+    /**
+     * The name of the plugin that owns this command.
+     */
+    protected readonly pluginName: string;
+    /**
+     * Creates a new command handler.
+     *
+     * @param params - The parameters for the command handler.
+     */
+    constructor(params: CommandHandlerParams);
+    /**
+     * 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.
+     *
+     * @param _context - The registration context providing runtime capabilities.
+     */
+    onRegistered(_context: CommandHandlerRegistrationContext): Promise<void>;
+}

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

@@ -0,0 +1,269 @@
+/*
+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 editor_command_handler_exports = {};
+__export(editor_command_handler_exports, {
+  EditorCommandHandler: () => EditorCommandHandler
+});
+module.exports = __toCommonJS(editor_command_handler_exports);
+var import_async = require('../../async.cjs');
+var import_command_handler = require('./command-handler.cjs');
+class EditorCommandHandler extends import_command_handler.CommandHandler {
+  /**
+   * Gets the item name to use in the editor menu.
+   *
+   * @returns The item name, or `undefined` to use the command name.
+   */
+  get editorMenuItemName() {
+    return this._editorMenuItemName;
+  }
+  /**
+   * Gets the section to use in the editor menu.
+   *
+   * @returns The section name, or `undefined` to use the plugin name.
+   */
+  get editorMenuSection() {
+    return this._editorMenuSection;
+  }
+  /**
+   * Gets the icon to use in the editor menu submenu.
+   *
+   * @returns The icon, or `undefined` for no icon.
+   */
+  get editorMenuSubmenuIcon() {
+    return this._editorMenuSubmenuIcon;
+  }
+  /**
+   * Gets whether to add the command to a submenu.
+   *
+   * @returns Whether to add to a submenu.
+   */
+  get shouldAddCommandToSubmenu() {
+    return this._shouldAddCommandToSubmenu;
+  }
+  _editorMenuItemName;
+  _editorMenuSection;
+  _editorMenuSubmenuIcon;
+  _shouldAddCommandToSubmenu;
+  /**
+   * Creates a new editor command handler.
+   *
+   * @param params - The parameters for the editor command handler.
+   */
+  constructor(params) {
+    super(params);
+    this._editorMenuItemName = params.editorMenuItemName;
+    this._editorMenuSection = params.editorMenuSection;
+    this._editorMenuSubmenuIcon = params.editorMenuSubmenuIcon;
+    this._shouldAddCommandToSubmenu = params.shouldAddCommandToSubmenu;
+  }
+  /**
+   * Builds a plain Obsidian {@link Command} object with an `editorCheckCallback`.
+   *
+   * @returns A new {@link Command} object.
+   */
+  buildCommand() {
+    return {
+      editorCheckCallback: (checking, editor, ctx) => this.editorCheckCallback(checking, editor, ctx),
+      icon: this.icon,
+      id: this.id,
+      name: this.name
+    };
+  }
+  /**
+   * Registers the editor-menu event handler.
+   *
+   * @param context - The registration context.
+   */
+  async onRegistered(context) {
+    await super.onRegistered(context);
+    context.menuEventRegistrar.registerEditorMenuEventHandler(this.handleEditorMenu.bind(this));
+  }
+  /**
+   * Checks whether the command can execute for the given editor and context.
+   *
+   * @param _editor - The editor instance.
+   * @param _ctx - The markdown file context.
+   * @returns Whether the command can execute.
+   */
+  canExecuteEditor(_editor, _ctx) {
+    return true;
+  }
+  /**
+   * Checks whether the command should appear in the command palette.
+   *
+   * @returns Whether to add to the command palette.
+   */
+  shouldAddToCommandPalette() {
+    return true;
+  }
+  /**
+   * Checks whether the command should appear in the editor context menu.
+   *
+   * @param _editor - The editor instance.
+   * @param _ctx - The markdown file context.
+   * @returns Whether to add to the editor menu.
+   */
+  shouldAddToEditorMenu(_editor, _ctx) {
+    return false;
+  }
+  editorCheckCallback(checking, editor, ctx) {
+    if (!this.shouldAddToCommandPalette()) {
+      return false;
+    }
+    if (!this.canExecuteEditor(editor, ctx)) {
+      return false;
+    }
+    if (!checking) {
+      (0, import_async.invokeAsyncSafely)(() => this.executeEditor(editor, ctx));
+    }
+    return true;
+  }
+  handleEditorMenu(menu, editor, ctx) {
+    if (!this.shouldAddToEditorMenu(editor, ctx)) {
+      return;
+    }
+    if (!this.canExecuteEditor(editor, ctx)) {
+      return;
+    }
+    const section = this.editorMenuSection ?? this.pluginName;
+    if (this.shouldAddCommandToSubmenu) {
+      menu.setSectionSubmenu(section, {
+        icon: this.editorMenuSubmenuIcon ?? "",
+        title: section
+      });
+    }
+    menu.addItem((item) => {
+      item.setTitle(this.editorMenuItemName ?? this.name).setIcon(this.icon).setSection(section).onClick(() => {
+        (0, import_async.invokeAsyncSafely)(() => this.executeEditor(editor, ctx));
+      });
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EditorCommandHandler
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2NvbW1hbmQtaGFuZGxlcnMvZWRpdG9yLWNvbW1hbmQtaGFuZGxlci50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbW1hbmQgaGFuZGxlciBmb3IgZWRpdG9yIGNvbW1hbmRzIHdpdGggb3B0aW9uYWwgZWRpdG9yIG1lbnUgaW50ZWdyYXRpb24uXG4gKi9cblxuaW1wb3J0IHR5cGUge1xuICBDb21tYW5kLFxuICBFZGl0b3IsXG4gIEljb25OYW1lLFxuICBNYXJrZG93bkZpbGVJbmZvLFxuICBNZW51XG59IGZyb20gJ29ic2lkaWFuJztcblxuaW1wb3J0IHR5cGUge1xuICBDb21tYW5kSGFuZGxlclBhcmFtcyxcbiAgQ29tbWFuZEhhbmRsZXJSZWdpc3RyYXRpb25Db250ZXh0XG59IGZyb20gJy4vY29tbWFuZC1oYW5kbGVyLnRzJztcblxuaW1wb3J0IHsgaW52b2tlQXN5bmNTYWZlbHkgfSBmcm9tICcuLi8uLi9hc3luYy50cyc7XG5pbXBvcnQgeyBDb21tYW5kSGFuZGxlciB9IGZyb20gJy4vY29tbWFuZC1oYW5kbGVyLnRzJztcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciBjcmVhdGluZyBhbiBlZGl0b3IgY29tbWFuZCBoYW5kbGVyLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEVkaXRvckNvbW1hbmRIYW5kbGVyUGFyYW1zIGV4dGVuZHMgQ29tbWFuZEhhbmRsZXJQYXJhbXMge1xuICAvKipcbiAgICogVGhlIGl0ZW0gbmFtZSB0byB1c2UgaW4gdGhlIGVkaXRvciBtZW51LlxuICAgKi9cbiAgcmVhZG9ubHkgZWRpdG9yTWVudUl0ZW1OYW1lPzogc3RyaW5nIHwgdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBUaGUgc2VjdGlvbiB0byB1c2UgaW4gdGhlIGVkaXRvciBtZW51LlxuICAgKi9cbiAgcmVhZG9ubHkgZWRpdG9yTWVudVNlY3Rpb24/OiBzdHJpbmcgfCB1bmRlZmluZWQ7XG5cbiAgLyoqXG4gICAqIFRoZSBpY29uIHRvIHVzZSBpbiB0aGUgZWRpdG9yIG1lbnUgc3VibWVudS5cbiAgICovXG4gIHJlYWRvbmx5IGVkaXRvck1lbnVTdWJtZW51SWNvbj86IEljb25OYW1lIHwgdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBXaGV0aGVyIHRvIGFkZCB0aGUgY29tbWFuZCB0byBhIHN1Ym1lbnUuXG4gICAqL1xuICByZWFkb25seSBzaG91bGRBZGRDb21tYW5kVG9TdWJtZW51PzogYm9vbGVhbiB8IHVuZGVmaW5lZDtcbn1cblxuLyoqXG4gKiBDb21tYW5kIGhhbmRsZXIgZm9yIGVkaXRvciBjb21tYW5kcy5cbiAqXG4gKiBTdWJjbGFzc2VzIG92ZXJyaWRlIHtAbGluayBjYW5FeGVjdXRlRWRpdG9yfSBhbmQge0BsaW5rIGV4ZWN1dGVFZGl0b3J9IHRvIHByb3ZpZGUgYmVoYXZpb3IuXG4gKiBPcHRpb25hbGx5IGludGVncmF0ZXMgd2l0aCB0aGUgZWRpdG9yIGNvbnRleHQgbWVudSB2aWEge0BsaW5rIHNob3VsZEFkZFRvRWRpdG9yTWVudX0uXG4gKi9cbmV4cG9ydCBhYnN0cmFjdCBjbGFzcyBFZGl0b3JDb21tYW5kSGFuZGxlciBleHRlbmRzIENvbW1hbmRIYW5kbGVyIHtcbiAgLyoqXG4gICAqIEdldHMgdGhlIGl0ZW0gbmFtZSB0byB1c2UgaW4gdGhlIGVkaXRvciBtZW51LlxuICAgKlxuICAgKiBAcmV0dXJucyBUaGUgaXRlbSBuYW1lLCBvciBgdW5kZWZpbmVkYCB0byB1c2UgdGhlIGNvbW1hbmQgbmFtZS5cbiAgICovXG4gIHByb3RlY3RlZCBnZXQgZWRpdG9yTWVudUl0ZW1OYW1lKCk6IHN0cmluZyB8IHVuZGVmaW5lZCB7XG4gICAgcmV0dXJuIHRoaXMuX2VkaXRvck1lbnVJdGVtTmFtZTtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXRzIHRoZSBzZWN0aW9uIHRvIHVzZSBpbiB0aGUgZWRpdG9yIG1lbnUuXG4gICAqXG4gICAqIEByZXR1cm5zIFRoZSBzZWN0aW9uIG5hbWUsIG9yIGB1bmRlZmluZWRgIHRvIHVzZSB0aGUgcGx1Z2luIG5hbWUuXG4gICAqL1xuICBwcm90ZWN0ZWQgZ2V0IGVkaXRvck1lbnVTZWN0aW9uKCk6IHN0cmluZyB8IHVuZGVmaW5lZCB7XG4gICAgcmV0dXJuIHRoaXMuX2VkaXRvck1lbnVTZWN0aW9uO1xuICB9XG5cbiAgLyoqXG4gICAqIEdldHMgdGhlIGljb24gdG8gdXNlIGluIHRoZSBlZGl0b3IgbWVudSBzdWJtZW51LlxuICAgKlxuICAgKiBAcmV0dXJucyBUaGUgaWNvbiwgb3IgYHVuZGVmaW5lZGAgZm9yIG5vIGljb24uXG4gICAqL1xuICBwcm90ZWN0ZWQgZ2V0IGVkaXRvck1lbnVTdWJtZW51SWNvbigpOiBJY29uTmFtZSB8IHVuZGVmaW5lZCB7XG4gICAgcmV0dXJuIHRoaXMuX2VkaXRvck1lbnVTdWJtZW51SWNvbjtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXRzIHdoZXRoZXIgdG8gYWRkIHRoZSBjb21tYW5kIHRvIGEgc3VibWVudS5cbiAgICpcbiAgICogQHJldHVybnMgV2hldGhlciB0byBhZGQgdG8gYSBzdWJtZW51LlxuICAgKi9cbiAgcHJvdGVjdGVkIGdldCBzaG91bGRBZGRDb21tYW5kVG9TdWJtZW51KCk6IGJvb2xlYW4gfCB1bmRlZmluZWQge1xuICAgIHJldHVybiB0aGlzLl9zaG91bGRBZGRDb21tYW5kVG9TdWJtZW51O1xuICB9XG5cbiAgcHJpdmF0ZSByZWFkb25seSBfZWRpdG9yTWVudUl0ZW1OYW1lPzogc3RyaW5nIHwgdW5kZWZpbmVkO1xuICBwcml2YXRlIHJlYWRvbmx5IF9lZGl0b3JNZW51U2VjdGlvbj86IHN0cmluZyB8IHVuZGVmaW5lZDtcbiAgcHJpdmF0ZSByZWFkb25seSBfZWRpdG9yTWVudVN1Ym1lbnVJY29uPzogSWNvbk5hbWUgfCB1bmRlZmluZWQ7XG4gIHByaXZhdGUgcmVhZG9ubHkgX3Nob3VsZEFkZENvbW1hbmRUb1N1Ym1lbnU/OiBib29sZWFuIHwgdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IGVkaXRvciBjb21tYW5kIGhhbmRsZXIuXG4gICAqXG4gICAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycyBmb3IgdGhlIGVkaXRvciBjb21tYW5kIGhhbmRsZXIuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocGFyYW1zOiBFZGl0b3JDb21tYW5kSGFuZGxlclBhcmFtcykge1xuICAgIHN1cGVyKHBhcmFtcyk7XG4gICAgdGhpcy5fZWRpdG9yTWVudUl0ZW1OYW1lID0gcGFyYW1zLmVkaXRvck1lbnVJdGVtTmFtZTtcbiAgICB0aGlzLl9lZGl0b3JNZW51U2VjdGlvbiA9IHBhcmFtcy5lZGl0b3JNZW51U2VjdGlvbjtcbiAgICB0aGlzLl9lZGl0b3JNZW51U3VibWVudUljb24gPSBwYXJhbXMuZWRpdG9yTWVudVN1Ym1lbnVJY29uO1xuICAgIHRoaXMuX3Nob3VsZEFkZENvbW1hbmRUb1N1Ym1lbnUgPSBwYXJhbXMuc2hvdWxkQWRkQ29tbWFuZFRvU3VibWVudTtcbiAgfVxuXG4gIC8qKlxuICAgKiBCdWlsZHMgYSBwbGFpbiBPYnNpZGlhbiB7QGxpbmsgQ29tbWFuZH0gb2JqZWN0IHdpdGggYW4gYGVkaXRvckNoZWNrQ2FsbGJhY2tgLlxuICAgKlxuICAgKiBAcmV0dXJucyBBIG5ldyB7QGxpbmsgQ29tbWFuZH0gb2JqZWN0LlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIGJ1aWxkQ29tbWFuZCgpOiBDb21tYW5kIHtcbiAgICByZXR1cm4ge1xuICAgICAgZWRpdG9yQ2hlY2tDYWxsYmFjazogKGNoZWNraW5nLCBlZGl0b3IsIGN0eCkgPT4gdGhpcy5lZGl0b3JDaGVja0NhbGxiYWNrKGNoZWNraW5nLCBlZGl0b3IsIGN0eCksXG4gICAgICBpY29uOiB0aGlzLmljb24sXG4gICAgICBpZDogdGhpcy5pZCxcbiAgICAgIG5hbWU6IHRoaXMubmFtZVxuICAgIH07XG4gIH1cblxuICAvKipcbiAgICogUmVnaXN0ZXJzIHRoZSBlZGl0b3ItbWVudSBldmVudCBoYW5kbGVyLlxuICAgKlxuICAgKiBAcGFyYW0gY29udGV4dCAtIFRoZSByZWdpc3RyYXRpb24gY29udGV4dC5cbiAgICovXG4gIHB1YmxpYyBvdmVycmlkZSBhc3luYyBvblJlZ2lzdGVyZWQoY29udGV4dDogQ29tbWFuZEhhbmRsZXJSZWdpc3RyYXRpb25Db250ZXh0KTogUHJvbWlzZTx2b2lkPiB7XG4gICAgYXdhaXQgc3VwZXIub25SZWdpc3RlcmVkKGNvbnRleHQpO1xuICAgIGNvbnRleHQubWVudUV2ZW50UmVnaXN0cmFyLnJlZ2lzdGVyRWRpdG9yTWVudUV2ZW50SGFuZGxlcih0aGlzLmhhbmRsZUVkaXRvck1lbnUuYmluZCh0aGlzKSk7XG4gIH1cblxuICAvKipcbiAgICogQ2hlY2tzIHdoZXRoZXIgdGhlIGNvbW1hbmQgY2FuIGV4ZWN1dGUgZm9yIHRoZSBnaXZlbiBlZGl0b3IgYW5kIGNvbnRleHQuXG4gICAqXG4gICAqIEBwYXJhbSBfZWRpdG9yIC0gVGhlIGVkaXRvciBpbnN0YW5jZS5cbiAgICogQHBhcmFtIF9jdHggLSBUaGUgbWFya2Rvd24gZmlsZSBjb250ZXh0LlxuICAgKiBAcmV0dXJucyBXaGV0aGVyIHRoZSBjb21tYW5kIGNhbiBleGVjdXRlLlxuICAgKi9cbiAgcHJvdGVjdGVkIGNhbkV4ZWN1dGVFZGl0b3IoX2VkaXRvcjogRWRpdG9yLCBfY3R4OiBNYXJrZG93bkZpbGVJbmZvKTogYm9vbGVhbiB7XG4gICAgcmV0dXJuIHRydWU7XG4gIH1cblxuICAvKipcbiAgICogRXhlY3V0ZXMgdGhlIGNvbW1hbmQgZm9yIHRoZSBnaXZlbiBlZGl0b3IgYW5kIGNvbnRleHQuXG4gICAqXG4gICAqIEBwYXJhbSBlZGl0b3IgLSBUaGUgZWRpdG9yIGluc3RhbmNlLlxuICAgKiBAcGFyYW0gY3R4IC0gVGhlIG1hcmtkb3duIGZpbGUgY29udGV4dC5cbiAgICovXG4gIHByb3RlY3RlZCBhYnN0cmFjdCBleGVjdXRlRWRpdG9yKGVkaXRvcjogRWRpdG9yLCBjdHg6IE1hcmtkb3duRmlsZUluZm8pOiBQcm9taXNlPHZvaWQ+O1xuXG4gIC8qKlxuICAgKiBDaGVja3Mgd2hldGhlciB0aGUgY29tbWFuZCBzaG91bGQgYXBwZWFyIGluIHRoZSBjb21tYW5kIHBhbGV0dGUuXG4gICAqXG4gICAqIEByZXR1cm5zIFdoZXRoZXIgdG8gYWRkIHRvIHRoZSBjb21tYW5kIHBhbGV0dGUuXG4gICAqL1xuICBwcm90ZWN0ZWQgc2hvdWxkQWRkVG9Db21tYW5kUGFsZXR0ZSgpOiBib29sZWFuIHtcbiAgICByZXR1cm4gdHJ1ZTtcbiAgfVxuXG4gIC8qKlxuICAgKiBDaGVja3Mgd2hldGhlciB0aGUgY29tbWFuZCBzaG91bGQgYXBwZWFyIGluIHRoZSBlZGl0b3IgY29udGV4dCBtZW51LlxuICAgKlxuICAgKiBAcGFyYW0gX2VkaXRvciAtIFRoZSBlZGl0b3IgaW5zdGFuY2UuXG4gICAqIEBwYXJhbSBfY3R4IC0gVGhlIG1hcmtkb3duIGZpbGUgY29udGV4dC5cbiAgICogQHJldHVybnMgV2hldGhlciB0byBhZGQgdG8gdGhlIGVkaXRvciBtZW51LlxuICAgKi9cbiAgcHJvdGVjdGVkIHNob3VsZEFkZFRvRWRpdG9yTWVudShfZWRpdG9yOiBFZGl0b3IsIF9jdHg6IE1hcmtkb3duRmlsZUluZm8pOiBib29sZWFuIHtcbiAgICByZXR1cm4gZmFsc2U7XG4gIH1cblxuICBwcml2YXRlIGVkaXRvckNoZWNrQ2FsbGJhY2soY2hlY2tpbmc6IGJvb2xlYW4sIGVkaXRvcjogRWRpdG9yLCBjdHg6IE1hcmtkb3duRmlsZUluZm8pOiBib29sZWFuIHtcbiAgICBpZiAoIXRoaXMuc2hvdWxkQWRkVG9Db21tYW5kUGFsZXR0ZSgpKSB7XG4gICAgICByZXR1cm4gZmFsc2U7XG4gICAgfVxuXG4gICAgaWYgKCF0aGlzLmNhbkV4ZWN1dGVFZGl0b3IoZWRpdG9yLCBjdHgpKSB7XG4gICAgICByZXR1cm4gZmFsc2U7XG4gICAgfVxuXG4gICAgaWYgKCFjaGVja2luZykge1xuICAgICAgaW52b2tlQXN5bmNTYWZlbHkoKCkgPT4gdGhpcy5leGVjdXRlRWRpdG9yKGVkaXRvciwgY3R4KSk7XG4gICAgfVxuXG4gICAgcmV0dXJuIHRydWU7XG4gIH1cblxuICBwcml2YXRlIGhhbmRsZUVkaXRvck1lbnUobWVudTogTWVudSwgZWRpdG9yOiBFZGl0b3IsIGN0eDogTWFya2Rvd25GaWxlSW5mbyk6IHZvaWQge1xuICAgIGlmICghdGhpcy5zaG91bGRBZGRUb0VkaXRvck1lbnUoZWRpdG9yLCBjdHgpKSB7XG4gICAgICByZXR1cm47XG4gICAgfVxuXG4gICAgaWYgKCF0aGlzLmNhbkV4ZWN1dGVFZGl0b3IoZWRpdG9yLCBjdHgpKSB7XG4gICAgICByZXR1cm47XG4gICAgfVxuXG4gICAgY29uc3Qgc2VjdGlvbiA9IHRoaXMuZWRpdG9yTWVudVNlY3Rpb24gPz8gdGhpcy5wbHVnaW5OYW1lO1xuICAgIGlmICh0aGlzLnNob3VsZEFkZENvbW1hbmRUb1N1Ym1lbnUpIHtcbiAgICAgIG1lbnUuc2V0U2VjdGlvblN1Ym1lbnUoc2VjdGlvbiwge1xuICAgICAgICBpY29uOiB0aGlzLmVkaXRvck1lbnVTdWJtZW51SWNvbiA/PyAnJyxcbiAgICAgICAgdGl0bGU6IHNlY3Rpb25cbiAgICAgIH0pO1xuICAgIH1cblxuICAgIG1lbnUuYWRkSXRlbSgoaXRlbSkgPT4ge1xuICAgICAgaXRlbVxuICAgICAgICAuc2V0VGl0bGUodGhpcy5lZGl0b3JNZW51SXRlbU5hbWUgPz8gdGhpcy5uYW1lKVxuICAgICAgICAuc2V0SWNvbih0aGlzLmljb24pXG4gICAgICAgIC5zZXRTZWN0aW9uKHNlY3Rpb24pXG4gICAgICAgIC5vbkNsaWNrKCgpID0+IHtcbiAgICAgICAgICBpbnZva2VBc3luY1NhZmVseSgoKSA9PiB0aGlzLmV4ZWN1dGVFZGl0b3IoZWRpdG9yLCBjdHgpKTtcbiAgICAgICAgfSk7XG4gICAgfSk7XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7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

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

@@ -0,0 +1,114 @@
+/**
+ * @file
+ *
+ * Command handler for editor commands with optional editor menu integration.
+ */
+import type { Command, Editor, IconName, MarkdownFileInfo } from 'obsidian';
+import type { CommandHandlerParams, CommandHandlerRegistrationContext } from './command-handler.cjs';
+import { CommandHandler } from './command-handler.cjs';
+/**
+ * Parameters for creating an editor command handler.
+ */
+export interface EditorCommandHandlerParams extends CommandHandlerParams {
+    /**
+     * 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.
+     */
+    readonly shouldAddCommandToSubmenu?: boolean | undefined;
+}
+/**
+ * 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}.
+ */
+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;
+    /**
+     * Gets whether to add the command to a submenu.
+     *
+     * @returns Whether to add to a submenu.
+     */
+    protected get shouldAddCommandToSubmenu(): boolean | 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: EditorCommandHandlerParams);
+    /**
+     * Builds a plain Obsidian {@link Command} object with an `editorCheckCallback`.
+     *
+     * @returns A new {@link Command} object.
+     */
+    buildCommand(): Command;
+    /**
+     * Registers the editor-menu event handler.
+     *
+     * @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 _ctx - The markdown file context.
+     * @returns Whether the command can execute.
+     */
+    protected canExecuteEditor(_editor: Editor, _ctx: MarkdownFileInfo): boolean;
+    /**
+     * Executes the command for the given editor and context.
+     *
+     * @param editor - The editor instance.
+     * @param ctx - The markdown file context.
+     */
+    protected abstract executeEditor(editor: Editor, ctx: MarkdownFileInfo): Promise<void>;
+    /**
+     * 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 _ctx - The markdown file context.
+     * @returns Whether to add to the editor menu.
+     */
+    protected shouldAddToEditorMenu(_editor: Editor, _ctx: MarkdownFileInfo): boolean;
+    private editorCheckCallback;
+    private handleEditorMenu;
+}