@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/cjs/editor-suggest-registrar.cjs

@@ -0,0 +1,186 @@
+/*
+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 keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+(function patchObsidianRequire() {
+  const originalRequire = require;
+  if (!originalRequire || originalRequire.__isPatched) {
+    return;
+  }
+
+  // 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
+    }
+  );
+
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+
+  const OBSIDIAN_BUILT_IN_MODULE_NAMES = new Set([
+  '@codemirror/autocomplete',
+  '@codemirror/collab',
+  '@codemirror/commands',
+  '@codemirror/language',
+  '@codemirror/lint',
+  '@codemirror/search',
+  '@codemirror/state',
+  '@codemirror/text',
+  '@codemirror/view',
+  '@lezer/common',
+  '@lezer/highlight',
+  '@lezer/lr',
+  'obsidian']
+  );
+
+  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = new Set([
+  '@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.has(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id)) {
+      return originalRequire?.(id);
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-deprecated, obsidianmd/no-global-this  -- 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.`);
+
+        return 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_suggest_registrar_exports = {};
+__export(editor_suggest_registrar_exports, {
+  PluginEditorSuggestRegistrar: () => PluginEditorSuggestRegistrar
+});
+module.exports = __toCommonJS(editor_suggest_registrar_exports);
+var import_obsidian = require('obsidian');
+class PluginEditorSuggestRegistrar {
+  /**
+   * Creates a new instance of the {@link PluginEditorSuggestRegistrar} class.
+   *
+   * @param plugin - The Obsidian plugin instance.
+   */
+  constructor(plugin) {
+    this.plugin = plugin;
+  }
+  plugin;
+  /**
+   * Registers an editor suggest.
+   *
+   * @param editorSuggest - The editor suggest to register.
+   */
+  registerEditorSuggest(editorSuggest) {
+    this.plugin.registerEditorSuggest(editorSuggest);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PluginEditorSuggestRegistrar
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2VkaXRvci1zdWdnZXN0LXJlZ2lzdHJhci50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIEVkaXRvciBzdWdnZXN0IHJlZ2lzdHJhcnMuXG4gKi9cblxuaW1wb3J0IHtcbiAgRWRpdG9yU3VnZ2VzdCxcbiAgUGx1Z2luXG59IGZyb20gJ29ic2lkaWFuJztcblxuLyoqXG4gKiBFZGl0b3Igc3VnZ2VzdCByZWdpc3RyYXIuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRWRpdG9yU3VnZ2VzdFJlZ2lzdHJhciB7XG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYW4gZWRpdG9yIHN1Z2dlc3QuXG4gICAqXG4gICAqIEBwYXJhbSBlZGl0b3JTdWdnZXN0IC0gVGhlIGVkaXRvciBzdWdnZXN0IHRvIHJlZ2lzdGVyLlxuICAgKi9cbiAgcmVnaXN0ZXJFZGl0b3JTdWdnZXN0OiAoZWRpdG9yU3VnZ2VzdDogRWRpdG9yU3VnZ2VzdDx1bmtub3duPikgPT4gdm9pZDtcbn1cblxuLyoqXG4gKiBFZGl0b3Igc3VnZ2VzdCByZWdpc3RyYXIgaW4gYW4gT2JzaWRpYW4gcGx1Z2luLlxuICovXG5leHBvcnQgY2xhc3MgUGx1Z2luRWRpdG9yU3VnZ2VzdFJlZ2lzdHJhciBpbXBsZW1lbnRzIEVkaXRvclN1Z2dlc3RSZWdpc3RyYXIge1xuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBpbnN0YW5jZSBvZiB0aGUge0BsaW5rIFBsdWdpbkVkaXRvclN1Z2dlc3RSZWdpc3RyYXJ9IGNsYXNzLlxuICAgKlxuICAgKiBAcGFyYW0gcGx1Z2luIC0gVGhlIE9ic2lkaWFuIHBsdWdpbiBpbnN0YW5jZS5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3Rvcihwcm90ZWN0ZWQgcmVhZG9ubHkgcGx1Z2luOiBQbHVnaW4pIHt9XG5cbiAgLyoqXG4gICAqIFJlZ2lzdGVycyBhbiBlZGl0b3Igc3VnZ2VzdC5cbiAgICpcbiAgICogQHBhcmFtIGVkaXRvclN1Z2dlc3QgLSBUaGUgZWRpdG9yIHN1Z2dlc3QgdG8gcmVnaXN0ZXIuXG4gICAqL1xuICBwdWJsaWMgcmVnaXN0ZXJFZGl0b3JTdWdnZXN0KGVkaXRvclN1Z2dlc3Q6IEVkaXRvclN1Z2dlc3Q8dW5rbm93bj4pOiB2b2lkIHtcbiAgICB0aGlzLnBsdWdpbi5yZWdpc3RlckVkaXRvclN1Z2dlc3QoZWRpdG9yU3VnZ2VzdCk7XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFNQSxzQkFHTztBQWlCQSxNQUFNLDZCQUErRDtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU1uRSxZQUErQixRQUFnQjtBQUFoQjtBQUFBLEVBQWlCO0FBQUEsRUFBakI7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFPL0Isc0JBQXNCLGVBQTZDO0FBQ3hFLFNBQUssT0FBTyxzQkFBc0IsYUFBYTtBQUFBLEVBQ2pEO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/cjs/editor-suggest-registrar.d.cts

@@ -0,0 +1,36 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * Editor suggest registrars.
+ */
+import { EditorSuggest, Plugin } from 'obsidian';
+/**
+ * Editor suggest registrar.
+ */
+export interface EditorSuggestRegistrar {
+    /**
+     * Registers an editor suggest.
+     *
+     * @param editorSuggest - The editor suggest to register.
+     */
+    registerEditorSuggest: (editorSuggest: EditorSuggest<unknown>) => void;
+}
+/**
+ * Editor suggest registrar in an Obsidian plugin.
+ */
+export declare class PluginEditorSuggestRegistrar implements EditorSuggestRegistrar {
+    protected readonly plugin: Plugin;
+    /**
+     * Creates a new instance of the {@link PluginEditorSuggestRegistrar} class.
+     *
+     * @param plugin - The Obsidian plugin instance.
+     */
+    constructor(plugin: Plugin);
+    /**
+     * Registers an editor suggest.
+     *
+     * @param editorSuggest - The editor suggest to register.
+     */
+    registerEditorSuggest(editorSuggest: EditorSuggest<unknown>): void;
+}

package/dist/lib/cjs/editor.cjs

@@ -0,0 +1,224 @@
+/*
+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 keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+(function patchObsidianRequire() {
+  const originalRequire = require;
+  if (!originalRequire || originalRequire.__isPatched) {
+    return;
+  }
+
+  // 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
+    }
+  );
+
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+
+  const OBSIDIAN_BUILT_IN_MODULE_NAMES = new Set([
+  '@codemirror/autocomplete',
+  '@codemirror/collab',
+  '@codemirror/commands',
+  '@codemirror/language',
+  '@codemirror/lint',
+  '@codemirror/search',
+  '@codemirror/state',
+  '@codemirror/text',
+  '@codemirror/view',
+  '@lezer/common',
+  '@lezer/highlight',
+  '@lezer/lr',
+  'obsidian']
+  );
+
+  const DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES = new Set([
+  '@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.has(id) || DEPRECATED_OBSIDIAN_BUILT_IN_MODULE_NAMES.has(id)) {
+      return originalRequire?.(id);
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-deprecated, obsidianmd/no-global-this  -- 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.`);
+
+        return 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_exports = {};
+__export(editor_exports, {
+  syncOpenEditorBuffersForPath: () => syncOpenEditorBuffersForPath,
+  toggleEditorReadOnly: () => toggleEditorReadOnly
+});
+module.exports = __toCommonJS(editor_exports);
+var import_state = require('@codemirror/state');
+var import_view = require('@codemirror/view');
+var import_object_utils = require('@mnaoumov/typescript-lib/object-utils');
+var import_implementations = require('@obsidian-typings/obsidian-public-latest/implementations');
+var import_obsidian = require('obsidian');
+var import_file_system = require('./file-system.cjs');
+const compartmentByCodeMirror = /* @__PURE__ */ new WeakMap();
+const moduleState = {
+  isProcessingLockedEditorKeydown: false
+};
+function syncOpenEditorBuffersForPath(app, pathOrFile, content) {
+  const path = (0, import_file_system.getPath)(app, pathOrFile);
+  for (const leaf of app.workspace.getLeavesOfType(import_implementations.ViewType.Markdown)) {
+    const view = leaf.view;
+    if (!(view instanceof import_obsidian.MarkdownView) || view.file?.path !== path) {
+      continue;
+    }
+    if (view.editor.getValue() !== content) {
+      view.editor.setValue(content);
+    }
+  }
+}
+function toggleEditorReadOnly(editor, isReadOnly) {
+  const compartment = ensureCompartment(editor);
+  editor.cm.dispatch({
+    effects: compartment.reconfigure(isReadOnly ? readOnlyExtension() : [])
+  });
+}
+function ensureCompartment(editor) {
+  const codeMirror = editor.cm;
+  const cachedCompartment = compartmentByCodeMirror.get(codeMirror);
+  if (cachedCompartment?.get((0, import_object_utils.castTo)(codeMirror.state)) !== void 0) {
+    return cachedCompartment;
+  }
+  const compartment = new import_state.Compartment();
+  compartmentByCodeMirror.set(codeMirror, compartment);
+  codeMirror.dispatch({
+    effects: import_state.StateEffect.appendConfig.of(compartment.of([]))
+  });
+  return compartment;
+}
+function readOnlyExtension() {
+  return [
+    import_state.EditorState.readOnly.of(true),
+    import_state.Prec.highest(import_view.EditorView.domEventHandlers({
+      keydown: () => {
+        moduleState.isProcessingLockedEditorKeydown = true;
+        queueMicrotask(() => {
+          moduleState.isProcessingLockedEditorKeydown = false;
+        });
+        return false;
+      }
+    })),
+    import_state.EditorState.changeFilter.of(() => !moduleState.isProcessingLockedEditorKeydown)
+  ];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  syncOpenEditorBuffersForPath,
+  toggleEditorReadOnly
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2VkaXRvci50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRoaXMgbW9kdWxlIHByb3ZpZGVzIHV0aWxpdHkgZnVuY3Rpb25zIGZvciB3b3JraW5nIHdpdGggbWFya2Rvd24gZWRpdG9ycyBpbiBPYnNpZGlhblxuICovXG5cbmltcG9ydCB0eXBlIHsgRXh0ZW5zaW9uIH0gZnJvbSAnQGNvZGVtaXJyb3Ivc3RhdGUnO1xuaW1wb3J0IHR5cGUge1xuICBBcHAsXG4gIEVkaXRvclxufSBmcm9tICdvYnNpZGlhbic7XG5cbmltcG9ydCB7XG4gIENvbXBhcnRtZW50LFxuICBFZGl0b3JTdGF0ZSxcbiAgUHJlYyxcbiAgU3RhdGVFZmZlY3Rcbn0gZnJvbSAnQGNvZGVtaXJyb3Ivc3RhdGUnO1xuaW1wb3J0IHsgRWRpdG9yVmlldyB9IGZyb20gJ0Bjb2RlbWlycm9yL3ZpZXcnO1xuaW1wb3J0IHsgY2FzdFRvIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL29iamVjdC11dGlscyc7XG5pbXBvcnQgeyBWaWV3VHlwZSB9IGZyb20gJ0BvYnNpZGlhbi10eXBpbmdzL29ic2lkaWFuLXB1YmxpYy1sYXRlc3QvaW1wbGVtZW50YXRpb25zJztcbmltcG9ydCB7IE1hcmtkb3duVmlldyB9IGZyb20gJ29ic2lkaWFuJztcblxuaW1wb3J0IHR5cGUgeyBQYXRoT3JGaWxlIH0gZnJvbSAnLi9maWxlLXN5c3RlbS50cyc7XG5cbmltcG9ydCB7IGdldFBhdGggfSBmcm9tICcuL2ZpbGUtc3lzdGVtLnRzJztcblxuY29uc3QgY29tcGFydG1lbnRCeUNvZGVNaXJyb3IgPSBuZXcgV2Vha01hcDxFZGl0b3JbJ2NtJ10sIENvbXBhcnRtZW50PigpO1xuXG4vLyBTZXQgdHJ1ZSB3aGlsZSBhIGxvY2tlZCBlZGl0b3IgcHJvY2Vzc2VzIGEgYGtleWRvd25gIHN5bmNocm9ub3VzbHkuXG4vLyBUaGUgcmVhZC1vbmx5IGNoYW5nZSBmaWx0ZXIgcmVhZHMgaXQgdG8gYmxvY2sgYSBrZXlib2FyZC1kcml2ZW4gZWRpdCBidXQgcGFzcyBhIHByb2dyYW1tYXRpYyBvbmUuXG4vLyBJdCBpcyByZXNldCBpbiBhIG1pY3JvdGFzaywgYWZ0ZXIgdGhlIGtleSBldmVudCdzIHN5bmNocm9ub3VzIGRpc3BhdGNoIGNvbXBsZXRlcy5cbi8qKlxuTW9kdWxlLWxldmVsIG11dGFibGUgc3RhdGUsIGhlbGQgaW4gb25lIG9iamVjdCBzbyBlYWNoIG11dGF0aW9uIG5hbWVzIGl0IGV4cGxpY2l0bHkuXG4gKi9cbmNvbnN0IG1vZHVsZVN0YXRlID0ge1xuICBpc1Byb2Nlc3NpbmdMb2NrZWRFZGl0b3JLZXlkb3duOiBmYWxzZVxufTtcbi8qKlxuICogT3ZlcndyaXRlcyB0aGUgYnVmZmVyIG9mIGV2ZXJ5IG9wZW4ge0BsaW5rIE1hcmtkb3duVmlld30gY3VycmVudGx5IHNob3dpbmcgdGhlIGdpdmVuIHBhdGggc28gdGhhdFxuICogaXQgcmVmbGVjdHMgYGNvbnRlbnRgLCBpbiBhbnkgd2luZG93IG9yIHBvcG91dC5cbiAqXG4gKiBUaGlzIGlzIHRoZSBmaXggZm9yIGEgc3VidGxlIGRhdGEtbG9zcyB3aW5kb3c6IHdoZW4gYSBub3RlIGlzIG9wZW4gaW4gYW4gZWRpdG9yIHdpdGggYSAqKmRpcnR5XG4gKiBidWZmZXIqKiAoYSBwZW5kaW5nLCBub3QteWV0LXNhdmVkIGVkaXQpIGFuZCBpdHMgZmlsZSBjb250ZW50IGlzIHJld3JpdHRlbiBvbiBkaXNrIG91dCBmcm9tIHVuZGVyXG4gKiB0aGUgZWRpdG9yLCB0aGUgZWRpdG9yJ3MgbmV4dCBhdXRvc2F2ZSByZS13cml0ZXMgaXRzIHN0YWxlIGJ1ZmZlciBhbmQgY2xvYmJlcnMgdGhlIG9uLWRpc2sgY29udGVudC5cbiAqIEEgY2FsbGVyIHRoYXQgcmVzdG9yZXMgYSBmaWxlJ3MgY29udGVudCBvbiBkaXNrIChlLmcuIHJvbGxpbmcgYmFjayBhIHRyYW5zYWN0aW9uKSBtdXN0IGFsc28gcmVzZXRcbiAqIHRoZSBvcGVuIGVkaXRvcidzIGJ1ZmZlciB0byB0aGUgc2FtZSBjb250ZW50LCBzbyBpdHMgbmV4dCBzYXZlIGlzIGEgbm8tb3AgaW5zdGVhZCBvZiBhIGNsb2JiZXIuXG4gKlxuICogT25seSB0aGUgdmlldyB3aG9zZSB7QGxpbmsgTWFya2Rvd25WaWV3LmZpbGV9IHN0aWxsIG1hdGNoZXMgYHBhdGhPckZpbGVgIGlzIHRvdWNoZWQgXHUyMDE0IGlmIHRoZSBlZGl0b3JcbiAqIGhhcyBzaW5jZSBuYXZpZ2F0ZWQgdG8gYW5vdGhlciBub3RlLCBpdCBpcyBsZWZ0IGFsb25lLiBUaGUgYnVmZmVyIGlzIHJlcGxhY2VkIG9ubHkgd2hlbiBpdCBhY3R1YWxseVxuICogZGlmZmVycyBmcm9tIGBjb250ZW50YCwgc28gYSBjbGVhbiBlZGl0b3IgYWxyZWFkeSBpbiBzeW5jIGlzIG5vdCBkaXN0dXJiZWQgKG5vIGN1cnNvciByZXNldCkuXG4gKlxuICogQHBhcmFtIGFwcCAtIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2UuXG4gKiBAcGFyYW0gcGF0aE9yRmlsZSAtIFRoZSBwYXRoIG9yIGZpbGUgd2hvc2Ugb3BlbiBlZGl0b3JzIHNob3VsZCBiZSBzeW5jaHJvbml6ZWQuXG4gKiBAcGFyYW0gY29udGVudCAtIFRoZSBjb250ZW50IHRvIG92ZXJ3cml0ZSBlYWNoIG1hdGNoaW5nIGVkaXRvcidzIGJ1ZmZlciB3aXRoLlxuICovXG5leHBvcnQgZnVuY3Rpb24gc3luY09wZW5FZGl0b3JCdWZmZXJzRm9yUGF0aChhcHA6IEFwcCwgcGF0aE9yRmlsZTogUGF0aE9yRmlsZSwgY29udGVudDogc3RyaW5nKTogdm9pZCB7XG4gIGNvbnN0IHBhdGggPSBnZXRQYXRoKGFwcCwgcGF0aE9yRmlsZSk7XG4gIGZvciAoY29uc3QgbGVhZiBvZiBhcHAud29ya3NwYWNlLmdldExlYXZlc09mVHlwZShWaWV3VHlwZS5NYXJrZG93bikpIHtcbiAgICBjb25zdCB2aWV3ID0gbGVhZi52aWV3O1xuICAgIGlmICghKHZpZXcgaW5zdGFuY2VvZiBNYXJrZG93blZpZXcpIHx8ICh2aWV3LmZpbGU/LnBhdGggIT09IHBhdGgpKSB7XG4gICAgICBjb250aW51ZTtcbiAgICB9XG4gICAgaWYgKHZpZXcuZWRpdG9yLmdldFZhbHVlKCkgIT09IGNvbnRlbnQpIHtcbiAgICAgIHZpZXcuZWRpdG9yLnNldFZhbHVlKGNvbnRlbnQpO1xuICAgIH1cbiAgfVxufVxuXG4vKipcbiAqIFRvZ2dsZXMgdGhlIHJlYWQtb25seSBzdGF0ZSBvZiBhIHNpbmdsZSBDb2RlTWlycm9yIGluc3RhbmNlIFx1MjAxNCB0aGUgbG93LWxldmVsIHByaW1pdGl2ZSBiZWhpbmRcbiAqIGVkaXRvciBsb2NraW5nLlxuICpcbiAqIFdoZW4gcmVhZC1vbmx5LCB0aGUgZWRpdG9yIHN0YXlzIGZvY3VzYWJsZSBhbmQgaW50ZXJhY3RpdmUgKHNlbGVjdGlvbiwgY29weSwgYW5kIGFwcCBob3RrZXlzIHN1Y2hcbiAqIGFzIHRoZSBjb21tYW5kIHBhbGV0dGUga2VlcCB3b3JraW5nKSBcdTIwMTQgb25seSBkb2N1bWVudCBlZGl0cyBhcmUgcHJldmVudGVkLCB2aWEgdGhlIENvZGVNaXJyb3JcbiAqIGByZWFkT25seWAgc3RhdGUgcGx1cyBhIGNoYW5nZSBmaWx0ZXIgdGhhdCBkcm9wcyBhbnkgdXNlci1vcmlnaW5hdGVkIGNoYW5nZSAoc2VlXG4gKiB7QGxpbmsgcmVhZE9ubHlFeHRlbnNpb259KS5cbiAqXG4gKiBUaGlzIHRvZ2dsZXMgT05FIENvZGVNaXJyb3IgaW5zdGFuY2UsIG5vdCBcImEgZmlsZVwiOiBhbiBPYnNpZGlhbiB7QGxpbmsgRWRpdG9yfSBpcyByZXVzZWQgYXMgaXRzXG4gKiBsZWFmIG5hdmlnYXRlcyBiZXR3ZWVuIG5vdGVzLCBzbyB0aGlzIHByaW1pdGl2ZSBkb2VzIG5vdCBmb2xsb3cgYSBub3RlIGFyb3VuZC4gVG8gbG9jayBhIG5vdGVcbiAqIGFjcm9zcyBldmVyeSBlZGl0b3IgdGhhdCBzaG93cyBpdCAoY3VycmVudCBhbmQgZnV0dXJlLCBpbiBhbnkgd2luZG93KSwgdXNlIGBsb2NrUmVzb3VyY2VGb3JQYXRoYFxuICogZnJvbSBgLi9yZXNvdXJjZS1sb2NrLnRzYC5cbiAqXG4gKiBAcGFyYW0gZWRpdG9yIC0gVGhlIGVkaXRvciB3aG9zZSBDb2RlTWlycm9yIGluc3RhbmNlIHRvIHRvZ2dsZS5cbiAqIEBwYXJhbSBpc1JlYWRPbmx5IC0gYHRydWVgIHRvIG1ha2UgdGhlIGVkaXRvciByZWFkLW9ubHksIGBmYWxzZWAgdG8gbWFrZSBpdCBlZGl0YWJsZSBhZ2Fpbi5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHRvZ2dsZUVkaXRvclJlYWRPbmx5KGVkaXRvcjogRWRpdG9yLCBpc1JlYWRPbmx5OiBib29sZWFuKTogdm9pZCB7XG4gIGNvbnN0IGNvbXBhcnRtZW50ID0gZW5zdXJlQ29tcGFydG1lbnQoZWRpdG9yKTtcbiAgZWRpdG9yLmNtLmRpc3BhdGNoKHtcbiAgICBlZmZlY3RzOiBjb21wYXJ0bWVudC5yZWNvbmZpZ3VyZShpc1JlYWRPbmx5ID8gcmVhZE9ubHlFeHRlbnNpb24oKSA6IFtdKVxuICB9KTtcbn1cblxuZnVuY3Rpb24gZW5zdXJlQ29tcGFydG1lbnQoZWRpdG9yOiBFZGl0b3IpOiBDb21wYXJ0bWVudCB7XG4gIC8vIEtleSB0aGUgY2FjaGUgYnkgdGhlIENvZGVNaXJyb3IgaW5zdGFuY2UsIG5vdCBieSB0aGUgYEVkaXRvcmAgd3JhcHBlci5cbiAgLy8gQW4gYEVkaXRvcmAga2VlcHMgaXRzIGlkZW50aXR5IHdoaWxlIGl0cyB1bmRlcmx5aW5nIENvZGVNaXJyb3IgdmlldyBpcyBzd2FwcGVkIG91dC5cbiAgY29uc3QgY29kZU1pcnJvciA9IGVkaXRvci5jbTtcbiAgY29uc3QgY2FjaGVkQ29tcGFydG1lbnQgPSBjb21wYXJ0bWVudEJ5Q29kZU1pcnJvci5nZXQoY29kZU1pcnJvcik7XG4gIC8vIFJldXNlIHRoZSBjYWNoZWQgY29tcGFydG1lbnQgb25seSB3aGlsZSBpdCBpcyBzdGlsbCBwYXJ0IG9mIHRoZSBjdXJyZW50IGNvbmZpZ3VyYXRpb24uXG4gIC8vIEEgdmlldyBjYW4gc2lsZW50bHkgZHJvcCBhbiBhcHBlbmRlZCBjb21wYXJ0bWVudCB3aGVuIGl0IHJlYnVpbGRzIGl0cyBzdGF0ZS5cbiAgLy8gT3BlbmluZyBhIG5vdGUgaW50byBhIGZyZXNobHkgY3JlYXRlZCBsZWFmIGRvZXMgdGhpczogaXQgaW5zdGFsbHMgdGhlIGNvbXBhcnRtZW50IG1pZC1vcGVuLlxuICAvLyBUaGUgc3Vic2VxdWVudCBsb2FkIHRoZW4gcmVwbGFjZXMgdGhlIHdob2xlIHN0YXRlLCB0YWtpbmcgdGhlIGNvbXBhcnRtZW50IHdpdGggaXQuXG4gIC8vIFRoZW4gYENvbXBhcnRtZW50LmdldGAgcmV0dXJucyBgdW5kZWZpbmVkYCwgc2luY2UgdGhlIGNvbXBhcnRtZW50IGlzIG5vIGxvbmdlciBjb25maWd1cmVkLlxuICAvLyBSZS1pbnN0YWxsIGl0IGluIHRoYXQgY2FzZSwgb3IgZXZlcnkgbGF0ZXIgYHJlY29uZmlndXJlYCBpcyBzaWxlbnRseSBpZ25vcmVkIGFuZCBub3RoaW5nIGxvY2tzLlxuICAvLyBUaGUgYGNhc3RUb2AgYnJpZGdlcyB0aGUgZHVhbCBDb21tb25KUyBhbmQgRVNNIGBFZGl0b3JTdGF0ZWAgZGVjbGFyYXRpb25zIG9mIGBAY29kZW1pcnJvci9zdGF0ZWAuXG4gIC8vIFRoZXkgYXJlIHN0cnVjdHVyYWxseSBpZGVudGljYWwsIGJ1dCBUeXBlU2NyaXB0IHRyZWF0cyB0aGVtIGFzIG5vbWluYWxseSBpbmNvbXBhdGlibGUuXG4gIGlmIChjYWNoZWRDb21wYXJ0bWVudD8uZ2V0KGNhc3RUbzxFZGl0b3JTdGF0ZT4oY29kZU1pcnJvci5zdGF0ZSkpICE9PSB1bmRlZmluZWQpIHtcbiAgICByZXR1cm4gY2FjaGVkQ29tcGFydG1lbnQ7XG4gIH1cblxuICBjb25zdCBjb21wYXJ0bWVudCA9IG5ldyBDb21wYXJ0bWVudCgpO1xuICBjb21wYXJ0bWVudEJ5Q29kZU1pcnJvci5zZXQoY29kZU1pcnJvciwgY29tcGFydG1lbnQpO1xuICAvLyBBIGBDb21wYXJ0bWVudGAgb25seSB0YWtlcyBlZmZlY3Qgb25jZSBpdCBpcyBwYXJ0IG9mIHRoZSBlZGl0b3IncyBjb25maWd1cmF0aW9uLlxuICAvLyBUaGUgY29tcGFydG1lbnQgaXMgY3JlYXRlZCBsYXppbHkgaGVyZSwgc28gaW5zdGFsbCBpdCAoaW5pdGlhbGx5IGVtcHR5KSB2aWEgYGFwcGVuZENvbmZpZ2AuXG4gIGNvZGVNaXJyb3IuZGlzcGF0Y2goe1xuICAgIGVmZmVjdHM6IFN0YXRlRWZmZWN0LmFwcGVuZENvbmZpZy5vZihjb21wYXJ0bWVudC5vZihbXSkpXG4gIH0pO1xuICByZXR1cm4gY29tcGFydG1lbnQ7XG59XG5cbi8qKlxuICogVGhlIGV4dGVuc2lvbiBpbnN0YWxsZWQgaW50byB0aGUgcmVhZC1vbmx5IGNvbXBhcnRtZW50IHdoaWxlIGEgbm90ZSBpcyBsb2NrZWQuXG4gKlxuICogYEVkaXRvclN0YXRlLnJlYWRPbmx5YCBhbG9uZSBpcyBub3QgZW5vdWdoOiBpdCBibG9ja3MgQ29kZU1pcnJvcidzIG93biBlZGl0aW5nIGNvbW1hbmRzIGFuZCBET01cbiAqIGlucHV0LCBidXQgT2JzaWRpYW4gYmluZHMgc29tZSBrZXlzIChub3RhYmx5IGBTaGlmdCtFbnRlcmApIHRvIGhhbmRsZXJzIHRoYXQgZGlzcGF0Y2ggYSBjaGFuZ2VcbiAqIHRyYW5zYWN0aW9uIGRpcmVjdGx5LCB3aGljaCBzbGlwcyBwYXN0IHRoZSBgcmVhZE9ubHlgIGZhY2V0IGFuZCBlZGl0cyB0aGUgXCJsb2NrZWRcIiBub3RlLiBTdWNoIGFcbiAqIHRyYW5zYWN0aW9uIGlzIGluZGlzdGluZ3Vpc2hhYmxlIGZyb20gYSBwcm9ncmFtbWF0aWMgb25lIGJ5IGl0cyBjb250ZW50cyAobm8gdXNlci1ldmVudFxuICogYW5ub3RhdGlvbiksIHNvIGl0IGlzIHRvbGQgYXBhcnQgYnkgb3JpZ2luIGluc3RlYWQ6IGEgaGlnaGVzdC1wcmVjZWRlbmNlIGBrZXlkb3duYCBoYW5kbGVyIG1hcmtzXG4gKiB0aGUgd2luZG93IGR1cmluZyB3aGljaCB0aGUga2V5IGlzIHByb2Nlc3NlZCBzeW5jaHJvbm91c2x5LCBhbmQgdGhlIGFkZGVkIGBjaGFuZ2VGaWx0ZXJgIGRyb3BzIHRoZVxuICogY2hhbmdlcyBvZiBhbnkgdHJhbnNhY3Rpb24gcHJvZHVjZWQgaW5zaWRlIHRoYXQgd2luZG93LiBQcm9ncmFtbWF0aWMgZWRpdHMgKGUuZy5cbiAqIGBzeW5jT3BlbkVkaXRvckJ1ZmZlcnNGb3JQYXRoYCByZXN0b3JpbmcgYSBidWZmZXIgb24gcm9sbGJhY2ssIG9yIE9ic2lkaWFuIHJlbG9hZGluZyB0aGUgYnVmZmVyXG4gKiBmcm9tIGRpc2spIGhhcHBlbiBvdXRzaWRlIGEga2V5ZG93biwgc28gdGhleSBzdGlsbCBnbyB0aHJvdWdoLlxuICpcbiAqIEByZXR1cm5zIFRoZSBleHRlbnNpb24gZW5mb3JjaW5nIHJlYWQtb25seSBmb3IgYSBsb2NrZWQgZWRpdG9yLlxuICovXG5mdW5jdGlvbiByZWFkT25seUV4dGVuc2lvbigpOiBFeHRlbnNpb24ge1xuICByZXR1cm4gW1xuICAgIEVkaXRvclN0YXRlLnJlYWRPbmx5Lm9mKHRydWUpLFxuICAgIFByZWMuaGlnaGVzdChFZGl0b3JWaWV3LmRvbUV2ZW50SGFuZGxlcnMoe1xuICAgICAga2V5ZG93bjogKCk6IGJvb2xlYW4gPT4ge1xuICAgICAgICBtb2R1bGVTdGF0ZS5pc1Byb2Nlc3NpbmdMb2NrZWRFZGl0b3JLZXlkb3duID0gdHJ1ZTtcbiAgICAgICAgcXVldWVNaWNyb3Rhc2soKCkgPT4ge1xuICAgICAgICAgIG1vZHVsZVN0YXRlLmlzUHJvY2Vzc2luZ0xvY2tlZEVkaXRvcktleWRvd24gPSBmYWxzZTtcbiAgICAgICAgfSk7XG4gICAgICAgIC8vIERvIG5vdCBjb25zdW1lIHRoZSBldmVudDogbGV0IENvZGVNaXJyb3IncyBrZXltYXAgcnVuIHNvIG5hdmlnYXRpb24vc2VsZWN0aW9uIGtleXMgd29yay5cbiAgICAgICAgcmV0dXJuIGZhbHNlO1xuICAgICAgfVxuICAgIH0pKSxcbiAgICBFZGl0b3JTdGF0ZS5jaGFuZ2VGaWx0ZXIub2YoKCkgPT4gIW1vZHVsZVN0YXRlLmlzUHJvY2Vzc2luZ0xvY2tlZEVkaXRvcktleWRvd24pXG4gIF07XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFZQSxtQkFLTztBQUNQLGtCQUEyQjtBQUMzQiwwQkFBdUI7QUFDdkIsNkJBQXlCO0FBQ3pCLHNCQUE2QjtBQUk3Qix5QkFBd0I7QUFFeEIsTUFBTSwwQkFBMEIsb0JBQUksUUFBbUM7QUFRdkUsTUFBTSxjQUFjO0FBQUEsRUFDbEIsaUNBQWlDO0FBQ25DO0FBbUJPLFNBQVMsNkJBQTZCLEtBQVUsWUFBd0IsU0FBdUI7QUFDcEcsUUFBTSxXQUFPLDRCQUFRLEtBQUssVUFBVTtBQUNwQyxhQUFXLFFBQVEsSUFBSSxVQUFVLGdCQUFnQixnQ0FBUyxRQUFRLEdBQUc7QUFDbkUsVUFBTSxPQUFPLEtBQUs7QUFDbEIsUUFBSSxFQUFFLGdCQUFnQixpQ0FBa0IsS0FBSyxNQUFNLFNBQVMsTUFBTztBQUNqRTtBQUFBLElBQ0Y7QUFDQSxRQUFJLEtBQUssT0FBTyxTQUFTLE1BQU0sU0FBUztBQUN0QyxXQUFLLE9BQU8sU0FBUyxPQUFPO0FBQUEsSUFDOUI7QUFBQSxFQUNGO0FBQ0Y7QUFtQk8sU0FBUyxxQkFBcUIsUUFBZ0IsWUFBMkI7QUFDOUUsUUFBTSxjQUFjLGtCQUFrQixNQUFNO0FBQzVDLFNBQU8sR0FBRyxTQUFTO0FBQUEsSUFDakIsU0FBUyxZQUFZLFlBQVksYUFBYSxrQkFBa0IsSUFBSSxDQUFDLENBQUM7QUFBQSxFQUN4RSxDQUFDO0FBQ0g7QUFFQSxTQUFTLGtCQUFrQixRQUE2QjtBQUd0RCxRQUFNLGFBQWEsT0FBTztBQUMxQixRQUFNLG9CQUFvQix3QkFBd0IsSUFBSSxVQUFVO0FBU2hFLE1BQUksbUJBQW1CLFFBQUksNEJBQW9CLFdBQVcsS0FBSyxDQUFDLE1BQU0sUUFBVztBQUMvRSxXQUFPO0FBQUEsRUFDVDtBQUVBLFFBQU0sY0FBYyxJQUFJLHlCQUFZO0FBQ3BDLDBCQUF3QixJQUFJLFlBQVksV0FBVztBQUduRCxhQUFXLFNBQVM7QUFBQSxJQUNsQixTQUFTLHlCQUFZLGFBQWEsR0FBRyxZQUFZLEdBQUcsQ0FBQyxDQUFDLENBQUM7QUFBQSxFQUN6RCxDQUFDO0FBQ0QsU0FBTztBQUNUO0FBaUJBLFNBQVMsb0JBQStCO0FBQ3RDLFNBQU87QUFBQSxJQUNMLHlCQUFZLFNBQVMsR0FBRyxJQUFJO0FBQUEsSUFDNUIsa0JBQUssUUFBUSx1QkFBVyxpQkFBaUI7QUFBQSxNQUN2QyxTQUFTLE1BQWU7QUFDdEIsb0JBQVksa0NBQWtDO0FBQzlDLHVCQUFlLE1BQU07QUFDbkIsc0JBQVksa0NBQWtDO0FBQUEsUUFDaEQsQ0FBQztBQUVELGVBQU87QUFBQSxNQUNUO0FBQUEsSUFDRixDQUFDLENBQUM7QUFBQSxJQUNGLHlCQUFZLGFBQWEsR0FBRyxNQUFNLENBQUMsWUFBWSwrQkFBK0I7QUFBQSxFQUNoRjtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/cjs/editor.d.cts

@@ -0,0 +1,45 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * This module provides utility functions for working with markdown editors in Obsidian
+ */
+import type { App, Editor } from 'obsidian' with { 'resolution-mode': 'import' };
+import type { PathOrFile } from './file-system.cjs';
+/**
+ * Overwrites the buffer of every open {@link MarkdownView} currently showing the given path so that
+ * it reflects `content`, in any window or popout.
+ *
+ * This is the fix for a subtle data-loss window: when a note is open in an editor with a **dirty
+ * buffer** (a pending, not-yet-saved edit) and its file content is rewritten on disk out from under
+ * the editor, the editor's next autosave re-writes its stale buffer and clobbers the on-disk content.
+ * A caller that restores a file's content on disk (e.g. rolling back a transaction) must also reset
+ * the open editor's buffer to the same content, so its next save is a no-op instead of a clobber.
+ *
+ * Only the view whose {@link MarkdownView.file} still matches `pathOrFile` is touched — if the editor
+ * has since navigated to another note, it is left alone. The buffer is replaced only when it actually
+ * differs from `content`, so a clean editor already in sync is not disturbed (no cursor reset).
+ *
+ * @param app - The Obsidian app instance.
+ * @param pathOrFile - The path or file whose open editors should be synchronized.
+ * @param content - The content to overwrite each matching editor's buffer with.
+ */
+export declare function syncOpenEditorBuffersForPath(app: App, pathOrFile: PathOrFile, content: string): void;
+/**
+ * Toggles the read-only state of a single CodeMirror instance — the low-level primitive behind
+ * editor locking.
+ *
+ * When read-only, the editor stays focusable and interactive (selection, copy, and app hotkeys such
+ * as the command palette keep working) — only document edits are prevented, via the CodeMirror
+ * `readOnly` state plus a change filter that drops any user-originated change (see
+ * {@link readOnlyExtension}).
+ *
+ * This toggles ONE CodeMirror instance, not "a file": an Obsidian {@link Editor} is reused as its
+ * leaf navigates between notes, so this primitive does not follow a note around. To lock a note
+ * across every editor that shows it (current and future, in any window), use `lockResourceForPath`
+ * from `./resource-lock.ts`.
+ *
+ * @param editor - The editor whose CodeMirror instance to toggle.
+ * @param isReadOnly - `true` to make the editor read-only, `false` to make it editable again.
+ */
+export declare function toggleEditorReadOnly(editor: Editor, isReadOnly: boolean): void;