@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/esm/code-block-markdown-information.mjs

@@ -0,0 +1,50 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFtdLAogICJzb3VyY2VzQ29udGVudCI6IFtdLAogICJtYXBwaW5ncyI6ICIiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/code-block-reg-exp.d.mts

@@ -0,0 +1,39 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * Provides the regular expression used to locate fenced code blocks within a Markdown note, including
+ * blocks nested inside callouts of any depth.
+ */
+/**
+ * Creates a regular expression that matches a single fenced code block anywhere in a Markdown note.
+ *
+ * A fresh instance is returned on each call so callers may safely use stateful methods (e.g.
+ * {@link RegExp.exec}) without sharing `lastIndex` between scans.
+ *
+ * Named capture groups:
+ * - `LinePrefix` — the leading indentation / callout blockquote prefix (`> ` repeated once per nesting
+ *   level) shared by every line of the block.
+ * - `CodeBlockStartDelimiter` / `CodeBlockStartDelimiterChar` — the opening fence (3+ backticks or tildes)
+ *   and the fence character.
+ * - `CodeBlockLanguage` — the info-string language token immediately after the opening fence.
+ * - `CodeBlockArgs` — any extra arguments after the language token.
+ * - `CodeBlockContent` — the block body. Each content line carries the same `LinePrefix`.
+ * - `CodeBlockEndDelimiter` — the closing fence.
+ *
+ * The `CodeBlockContent` group is written as `\k<LinePrefix>.*(?:\n\k<LinePrefix>.*)*?` — a first line
+ * followed by zero or more lines each introduced by a **mandatory** newline. This deliberately avoids the
+ * ambiguous `(?:\n?\k<LinePrefix>.*)+?` form (optional newline + repeatable line remainder), which lets a
+ * single line be partitioned in exponentially many ways and causes catastrophic backtracking — a
+ * synchronous freeze — when the scan meets a fence-open with no valid closing fence before the end of the
+ * note. The mandatory-newline form matches the same text linearly.
+ *
+ * A block starts at the start of the text or right after a line break, which the `m` flag's `^` expresses
+ * without a lookbehind: a lookbehind is a syntax error on iOS before 16.4, below the iOS 15 that Obsidian
+ * mobile still supports, and a regex literal that cannot parse fails the whole bundle. The `m` flag's `^`
+ * also accepts as that line break a lone `\r`, which CommonMark treats as one too, and the Unicode line and
+ * paragraph separators, which no editor writes between note lines. The block end is `(?![\s\S])` rather than `$`, so the `m` flag does not let a closing fence end before a `\r`.
+ *
+ * @returns A fresh global {@link RegExp} matching one fenced code block.
+ */
+export declare function createCodeBlockRegExp(): RegExp;

package/dist/lib/esm/code-block-reg-exp.mjs

@@ -0,0 +1,56 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+function createCodeBlockRegExp() {
+  return /^(?<LinePrefix> {0,3}(?:> {1,3})*)(?<CodeBlockStartDelimiter>(?<CodeBlockStartDelimiterChar>[`~])(?:\k<CodeBlockStartDelimiterChar>{2,}))(?<CodeBlockLanguage>\S*)(?:[ \t](?<CodeBlockArgs>.*?))?(?:\n(?<CodeBlockContent>\k<LinePrefix>.*(?:\n\k<LinePrefix>.*)*?))?\n\k<LinePrefix>(?<CodeBlockEndDelimiter>\k<CodeBlockStartDelimiter>\k<CodeBlockStartDelimiterChar>*)[ \t]*(?=\n|(?![\s\S]))/gm;
+}
+export {
+  createCodeBlockRegExp
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2NvZGUtYmxvY2stcmVnLWV4cC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFByb3ZpZGVzIHRoZSByZWd1bGFyIGV4cHJlc3Npb24gdXNlZCB0byBsb2NhdGUgZmVuY2VkIGNvZGUgYmxvY2tzIHdpdGhpbiBhIE1hcmtkb3duIG5vdGUsIGluY2x1ZGluZ1xuICogYmxvY2tzIG5lc3RlZCBpbnNpZGUgY2FsbG91dHMgb2YgYW55IGRlcHRoLlxuICovXG5cbi8qKlxuICogQ3JlYXRlcyBhIHJlZ3VsYXIgZXhwcmVzc2lvbiB0aGF0IG1hdGNoZXMgYSBzaW5nbGUgZmVuY2VkIGNvZGUgYmxvY2sgYW55d2hlcmUgaW4gYSBNYXJrZG93biBub3RlLlxuICpcbiAqIEEgZnJlc2ggaW5zdGFuY2UgaXMgcmV0dXJuZWQgb24gZWFjaCBjYWxsIHNvIGNhbGxlcnMgbWF5IHNhZmVseSB1c2Ugc3RhdGVmdWwgbWV0aG9kcyAoZS5nLlxuICoge0BsaW5rIFJlZ0V4cC5leGVjfSkgd2l0aG91dCBzaGFyaW5nIGBsYXN0SW5kZXhgIGJldHdlZW4gc2NhbnMuXG4gKlxuICogTmFtZWQgY2FwdHVyZSBncm91cHM6XG4gKiAtIGBMaW5lUHJlZml4YCBcdTIwMTQgdGhlIGxlYWRpbmcgaW5kZW50YXRpb24gLyBjYWxsb3V0IGJsb2NrcXVvdGUgcHJlZml4IChgPiBgIHJlcGVhdGVkIG9uY2UgcGVyIG5lc3RpbmdcbiAqICAgbGV2ZWwpIHNoYXJlZCBieSBldmVyeSBsaW5lIG9mIHRoZSBibG9jay5cbiAqIC0gYENvZGVCbG9ja1N0YXJ0RGVsaW1pdGVyYCAvIGBDb2RlQmxvY2tTdGFydERlbGltaXRlckNoYXJgIFx1MjAxNCB0aGUgb3BlbmluZyBmZW5jZSAoMysgYmFja3RpY2tzIG9yIHRpbGRlcylcbiAqICAgYW5kIHRoZSBmZW5jZSBjaGFyYWN0ZXIuXG4gKiAtIGBDb2RlQmxvY2tMYW5ndWFnZWAgXHUyMDE0IHRoZSBpbmZvLXN0cmluZyBsYW5ndWFnZSB0b2tlbiBpbW1lZGlhdGVseSBhZnRlciB0aGUgb3BlbmluZyBmZW5jZS5cbiAqIC0gYENvZGVCbG9ja0FyZ3NgIFx1MjAxNCBhbnkgZXh0cmEgYXJndW1lbnRzIGFmdGVyIHRoZSBsYW5ndWFnZSB0b2tlbi5cbiAqIC0gYENvZGVCbG9ja0NvbnRlbnRgIFx1MjAxNCB0aGUgYmxvY2sgYm9keS4gRWFjaCBjb250ZW50IGxpbmUgY2FycmllcyB0aGUgc2FtZSBgTGluZVByZWZpeGAuXG4gKiAtIGBDb2RlQmxvY2tFbmREZWxpbWl0ZXJgIFx1MjAxNCB0aGUgY2xvc2luZyBmZW5jZS5cbiAqXG4gKiBUaGUgYENvZGVCbG9ja0NvbnRlbnRgIGdyb3VwIGlzIHdyaXR0ZW4gYXMgYFxcazxMaW5lUHJlZml4Pi4qKD86XFxuXFxrPExpbmVQcmVmaXg+LiopKj9gIFx1MjAxNCBhIGZpcnN0IGxpbmVcbiAqIGZvbGxvd2VkIGJ5IHplcm8gb3IgbW9yZSBsaW5lcyBlYWNoIGludHJvZHVjZWQgYnkgYSAqKm1hbmRhdG9yeSoqIG5ld2xpbmUuIFRoaXMgZGVsaWJlcmF0ZWx5IGF2b2lkcyB0aGVcbiAqIGFtYmlndW91cyBgKD86XFxuP1xcazxMaW5lUHJlZml4Pi4qKSs/YCBmb3JtIChvcHRpb25hbCBuZXdsaW5lICsgcmVwZWF0YWJsZSBsaW5lIHJlbWFpbmRlciksIHdoaWNoIGxldHMgYVxuICogc2luZ2xlIGxpbmUgYmUgcGFydGl0aW9uZWQgaW4gZXhwb25lbnRpYWxseSBtYW55IHdheXMgYW5kIGNhdXNlcyBjYXRhc3Ryb3BoaWMgYmFja3RyYWNraW5nIFx1MjAxNCBhXG4gKiBzeW5jaHJvbm91cyBmcmVlemUgXHUyMDE0IHdoZW4gdGhlIHNjYW4gbWVldHMgYSBmZW5jZS1vcGVuIHdpdGggbm8gdmFsaWQgY2xvc2luZyBmZW5jZSBiZWZvcmUgdGhlIGVuZCBvZiB0aGVcbiAqIG5vdGUuIFRoZSBtYW5kYXRvcnktbmV3bGluZSBmb3JtIG1hdGNoZXMgdGhlIHNhbWUgdGV4dCBsaW5lYXJseS5cbiAqXG4gKiBBIGJsb2NrIHN0YXJ0cyBhdCB0aGUgc3RhcnQgb2YgdGhlIHRleHQgb3IgcmlnaHQgYWZ0ZXIgYSBsaW5lIGJyZWFrLCB3aGljaCB0aGUgYG1gIGZsYWcncyBgXmAgZXhwcmVzc2VzXG4gKiB3aXRob3V0IGEgbG9va2JlaGluZDogYSBsb29rYmVoaW5kIGlzIGEgc3ludGF4IGVycm9yIG9uIGlPUyBiZWZvcmUgMTYuNCwgYmVsb3cgdGhlIGlPUyAxNSB0aGF0IE9ic2lkaWFuXG4gKiBtb2JpbGUgc3RpbGwgc3VwcG9ydHMsIGFuZCBhIHJlZ2V4IGxpdGVyYWwgdGhhdCBjYW5ub3QgcGFyc2UgZmFpbHMgdGhlIHdob2xlIGJ1bmRsZS4gVGhlIGBtYCBmbGFnJ3MgYF5gXG4gKiBhbHNvIGFjY2VwdHMgYXMgdGhhdCBsaW5lIGJyZWFrIGEgbG9uZSBgXFxyYCwgd2hpY2ggQ29tbW9uTWFyayB0cmVhdHMgYXMgb25lIHRvbywgYW5kIHRoZSBVbmljb2RlIGxpbmUgYW5kXG4gKiBwYXJhZ3JhcGggc2VwYXJhdG9ycywgd2hpY2ggbm8gZWRpdG9yIHdyaXRlcyBiZXR3ZWVuIG5vdGUgbGluZXMuIFRoZSBibG9jayBlbmQgaXMgYCg/IVtcXHNcXFNdKWAgcmF0aGVyIHRoYW4gYCRgLCBzbyB0aGUgYG1gIGZsYWcgZG9lcyBub3QgbGV0IGEgY2xvc2luZyBmZW5jZSBlbmQgYmVmb3JlIGEgYFxccmAuXG4gKlxuICogQHJldHVybnMgQSBmcmVzaCBnbG9iYWwge0BsaW5rIFJlZ0V4cH0gbWF0Y2hpbmcgb25lIGZlbmNlZCBjb2RlIGJsb2NrLlxuICovXG5leHBvcnQgZnVuY3Rpb24gY3JlYXRlQ29kZUJsb2NrUmVnRXhwKCk6IFJlZ0V4cCB7XG4gIHJldHVybiAvXig/PExpbmVQcmVmaXg+IHswLDN9KD86PiB7MSwzfSkqKSg/PENvZGVCbG9ja1N0YXJ0RGVsaW1pdGVyPig/PENvZGVCbG9ja1N0YXJ0RGVsaW1pdGVyQ2hhcj5bYH5dKSg/OlxcazxDb2RlQmxvY2tTdGFydERlbGltaXRlckNoYXI+ezIsfSkpKD88Q29kZUJsb2NrTGFuZ3VhZ2U+XFxTKikoPzpbIFxcdF0oPzxDb2RlQmxvY2tBcmdzPi4qPykpPyg/Olxcbig/PENvZGVCbG9ja0NvbnRlbnQ+XFxrPExpbmVQcmVmaXg+LiooPzpcXG5cXGs8TGluZVByZWZpeD4uKikqPykpP1xcblxcazxMaW5lUHJlZml4Pig/PENvZGVCbG9ja0VuZERlbGltaXRlcj5cXGs8Q29kZUJsb2NrU3RhcnREZWxpbWl0ZXI+XFxrPENvZGVCbG9ja1N0YXJ0RGVsaW1pdGVyQ2hhcj4qKVsgXFx0XSooPz1cXG58KD8hW1xcc1xcU10pKS9nbTtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFzQ08sU0FBUyx3QkFBZ0M7QUFDOUMsU0FBTztBQUNUOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/esm/codemirror/index.d.mts

@@ -0,0 +1,2 @@
+/// <reference path="../library.d.mts" />
+export * as 'state-field-spec' from './state-field-spec.mjs';

package/dist/lib/esm/codemirror/index.mjs

@@ -0,0 +1,54 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import * as state_field_spec from "./state-field-spec.mjs";
+export {
+  state_field_spec as "state-field-spec"
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvZGVtaXJyb3IvaW5kZXgudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qIFRISVMgSVMgQSBHRU5FUkFURUQvQlVORExFRCBGSUxFIEJZIEJVSUxEIFNDUklQVCAqL1xuXG5leHBvcnQgKiBhcyAnc3RhdGUtZmllbGQtc3BlYycgZnJvbSAnLi9zdGF0ZS1maWVsZC1zcGVjLnRzJztcbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFFQSxZQUFZQSxzQkFBd0I7IiwKICAibmFtZXMiOiBbInN0YXRlLWZpZWxkLXNwZWMiXQp9Cg==

package/dist/lib/esm/codemirror/state-field-spec.d.mts

@@ -0,0 +1,72 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Contains a specification for a state field.
+ */
+import type { EditorState, Extension, StateField, Transaction } from '@codemirror/state';
+/**
+ * A specification for a state field.
+ *
+ * @typeParam Value - The type of the state field value.
+ */
+export interface StateFieldSpec<Value> {
+    /**
+     * Compare two values of the field, returning `true` when they are
+     * the same. This is used to avoid recomputing facets that depend
+     * on the field when its value did not change. Defaults to using
+     * `===`.
+     *
+     * @param a - The first value to compare.
+     * @param b - The second value to compare.
+     * @returns `true` if the values are the same, `false` otherwise.
+     */
+    compare?: (a: Value, b: Value) => boolean;
+    /**
+     * Creates the initial value for the field when a state is created.
+     *
+     * @param state - The state to create the value for.
+     * @returns The initial value for the field.
+     */
+    create: (state: EditorState) => Value;
+    /**
+     * A function that deserializes the JSON representation of this
+     * field's content.
+     *
+     * @param json - The JSON representation of the value.
+     * @param state - The state to deserialize the value for.
+     * @returns The deserialized value.
+     */
+    fromJSON?: (json: unknown, state: EditorState) => Value;
+    /**
+     * Provide extensions based on this field. The given function will
+     * be called once with the initialized field. It will usually want
+     * to call some facet's [`from`](https://codemirror.net/6/docs/ref/#state.Facet.from) method to
+     * create facet inputs from this field, but can also return other
+     * extensions that should be enabled when the field is present in a
+     * configuration.
+     *
+     * @param field - The initialized field.
+     * @returns The extensions to enable when the field is present in a configuration.
+     */
+    provide?: (field: StateField<Value>) => Extension;
+    /**
+     * A function used to serialize this field's content to JSON. Only
+     * necessary when this field is included in the argument to
+     * [`EditorState.toJSON`](https://codemirror.net/6/docs/ref/#state.EditorState.toJSON).
+     *
+     * @param value - The value to serialize.
+     * @param state - The state to serialize the value for.
+     * @returns The serialized value.
+     */
+    toJSON?: (value: Value, state: EditorState) => unknown;
+    /**
+     * Compute a new value from the field's previous value and a
+     * [transaction](https://codemirror.net/6/docs/ref/#state.Transaction).
+     *
+     * @param value - The previous value of the field.
+     * @param transaction - The transaction to compute the new value from.
+     * @returns The new value of the field.
+     */
+    update: (value: Value, transaction: Transaction) => Value;
+}

package/dist/lib/esm/codemirror/state-field-spec.mjs

@@ -0,0 +1,50 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFtdLAogICJzb3VyY2VzQ29udGVudCI6IFtdLAogICJtYXBwaW5ncyI6ICIiLAogICJuYW1lcyI6IFtdCn0K

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

@@ -0,0 +1,274 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Command handler for abstract file commands with file/files menu integration.
+ */
+import type { IconName, Menu, TAbstractFile, WorkspaceLeaf } from 'obsidian';
+import type { Promisable } from 'type-fest';
+import type { ActiveFileProvider } from '../active-file-provider.mjs';
+import type { CommandHandlerConstructorParams, CommandHandlerRegistrationContext } from './command-handler.mjs';
+import { GlobalCommandHandler } from './global-command-handler.mjs';
+/**
+ * Parameters for creating an abstract file command handler.
+ */
+export interface AbstractFileCommandHandlerConstructorParams extends CommandHandlerConstructorParams {
+    /**
+     * 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.
+     *
+     * @default `false`
+     */
+    readonly shouldAddCommandToSubmenu?: boolean | undefined;
+}
+/**
+ * Parameters for {@link AbstractFileCommandHandler.handleAbstractFileMenu}.
+ */
+export interface AbstractFileCommandHandlerHandleAbstractFileMenuParams {
+    /**
+     * The file or folder.
+     */
+    readonly abstractFile: TAbstractFile;
+    /**
+     * The workspace leaf, if available.
+     */
+    readonly leaf?: undefined | WorkspaceLeaf;
+    /**
+     * The menu to add items to.
+     */
+    readonly menu: Menu;
+    /**
+     * The source of the event.
+     */
+    readonly source: string;
+}
+/**
+ * Parameters for {@link AbstractFileCommandHandler.handleAbstractFilesMenu}.
+ */
+export interface AbstractFileCommandHandlerHandleAbstractFilesMenuParams {
+    /**
+     * The files or folders.
+     */
+    readonly abstractFiles: TAbstractFile[];
+    /**
+     * The workspace leaf, if available.
+     */
+    readonly leaf?: undefined | WorkspaceLeaf;
+    /**
+     * The menu to add items to.
+     */
+    readonly menu: Menu;
+    /**
+     * The source of the event.
+     */
+    readonly source: string;
+}
+/**
+ * Parameters for {@link AbstractFileCommandHandler.shouldAddToAbstractFileMenu}.
+ */
+export interface AbstractFileCommandHandlerShouldAddToAbstractFileMenuParams {
+    /**
+     * The file or folder.
+     */
+    readonly abstractFile: TAbstractFile;
+    /**
+     * The workspace leaf, if available.
+     */
+    readonly leaf?: undefined | WorkspaceLeaf;
+    /**
+     * The source of the event.
+     */
+    readonly source: string;
+}
+/**
+ * Parameters for {@link AbstractFileCommandHandler.shouldAddToAbstractFilesMenu}.
+ */
+export interface AbstractFileCommandHandlerShouldAddToAbstractFilesMenuParams {
+    /**
+     * The files or folders.
+     */
+    readonly abstractFiles: TAbstractFile[];
+    /**
+     * The workspace leaf, if available.
+     */
+    readonly leaf?: undefined | WorkspaceLeaf;
+    /**
+     * The source of the event.
+     */
+    readonly source: string;
+}
+/**
+ * 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 {
+    /**
+     * Get the active file provider.
+     *
+     * @returns The active file provider.
+     */
+    protected get activeFileProvider(): ActiveFileProvider;
+    /**
+     * 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;
+    private _activeFileProvider?;
+    private readonly _fileMenuItemName?;
+    private readonly _fileMenuSection?;
+    private readonly _fileMenuSubmenuIcon?;
+    private readonly _filesMenuItemName?;
+    private readonly _filesMenuSection?;
+    private readonly _filesMenuSubmenuIcon?;
+    private _registrationShouldAddCommandToSubmenu?;
+    private readonly _shouldAddCommandToSubmenu?;
+    /**
+     * Creates a new abstract file command handler.
+     *
+     * @param params - The parameters for the abstract file command handler.
+     */
+    constructor(params: AbstractFileCommandHandlerConstructorParams);
+    /**
+     * 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.
+     *
+     * @returns `Promisable<void>` that resolves when command had been executed.
+     */
+    protected execute(): Promisable<void>;
+    /**
+     * Executes the command for a single abstract file.
+     *
+     * @param abstractFile - The file or folder.
+     */
+    protected abstract executeAbstractFile(abstractFile: TAbstractFile): Promisable<void>;
+    /**
+     * Executes the command for multiple abstract files.
+     * Default implementation executes sequentially.
+     *
+     * @param abstractFiles - The files or folders.
+     * @returns `Promisable<void>` that resolves when all abstract files have been executed.
+     */
+    protected executeAbstractFiles(abstractFiles: TAbstractFile[]): Promisable<void>;
+    /**
+     * Gets the active file, if any, to use as the target when executing from the command palette.
+     *
+     * @returns The active file or `null` if none is active.
+     */
+    protected getActiveFile(): null | TAbstractFile;
+    /**
+     * 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;
+    /**
+     * Checks whether the command should appear in the single-file context menu.
+     *
+     * @param params - The parameters for the single-file menu check.
+     * @returns Whether to add to the file menu.
+     */
+    protected shouldAddToAbstractFileMenu(params: AbstractFileCommandHandlerShouldAddToAbstractFileMenuParams): boolean;
+    /**
+     * Checks whether the command should appear in the multi-file context menu.
+     * Default implementation checks each file individually.
+     *
+     * @param params - The parameters for the multi-file menu check.
+     * @returns Whether to add to the files menu.
+     */
+    protected shouldAddToAbstractFilesMenu(params: AbstractFileCommandHandlerShouldAddToAbstractFilesMenuParams): boolean;
+    /**
+     * Checks whether the command should appear in the command palette.
+     *
+     * @returns Whether to add to the command palette.
+     */
+    protected shouldAddToCommandPalette(): boolean;
+    private handleAbstractFileMenu;
+    private handleAbstractFilesMenu;
+}