@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/esm/editor.mjs

@@ -0,0 +1,115 @@
+/*
+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 {
+  Compartment,
+  EditorState,
+  Prec,
+  StateEffect
+} from "@codemirror/state";
+import { EditorView } from "@codemirror/view";
+import { castTo } from "@mnaoumov/typescript-lib/object-utils";
+import { ViewType } from "@obsidian-typings/obsidian-public-latest/implementations";
+import { MarkdownView } from "obsidian";
+import { getPath } from "./file-system.mjs";
+const compartmentByCodeMirror = /* @__PURE__ */ new WeakMap();
+const moduleState = {
+  isProcessingLockedEditorKeydown: false
+};
+function syncOpenEditorBuffersForPath(app, pathOrFile, content) {
+  const path = getPath(app, pathOrFile);
+  for (const leaf of app.workspace.getLeavesOfType(ViewType.Markdown)) {
+    const view = leaf.view;
+    if (!(view instanceof 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(castTo(codeMirror.state)) !== void 0) {
+    return cachedCompartment;
+  }
+  const compartment = new Compartment();
+  compartmentByCodeMirror.set(codeMirror, compartment);
+  codeMirror.dispatch({
+    effects: StateEffect.appendConfig.of(compartment.of([]))
+  });
+  return compartment;
+}
+function readOnlyExtension() {
+  return [
+    EditorState.readOnly.of(true),
+    Prec.highest(EditorView.domEventHandlers({
+      keydown: () => {
+        moduleState.isProcessingLockedEditorKeydown = true;
+        queueMicrotask(() => {
+          moduleState.isProcessingLockedEditorKeydown = false;
+        });
+        return false;
+      }
+    })),
+    EditorState.changeFilter.of(() => !moduleState.isProcessingLockedEditorKeydown)
+  ];
+}
+export {
+  syncOpenEditorBuffersForPath,
+  toggleEditorReadOnly
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2VkaXRvci50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRoaXMgbW9kdWxlIHByb3ZpZGVzIHV0aWxpdHkgZnVuY3Rpb25zIGZvciB3b3JraW5nIHdpdGggbWFya2Rvd24gZWRpdG9ycyBpbiBPYnNpZGlhblxuICovXG5cbmltcG9ydCB0eXBlIHsgRXh0ZW5zaW9uIH0gZnJvbSAnQGNvZGVtaXJyb3Ivc3RhdGUnO1xuaW1wb3J0IHR5cGUge1xuICBBcHAsXG4gIEVkaXRvclxufSBmcm9tICdvYnNpZGlhbic7XG5cbmltcG9ydCB7XG4gIENvbXBhcnRtZW50LFxuICBFZGl0b3JTdGF0ZSxcbiAgUHJlYyxcbiAgU3RhdGVFZmZlY3Rcbn0gZnJvbSAnQGNvZGVtaXJyb3Ivc3RhdGUnO1xuaW1wb3J0IHsgRWRpdG9yVmlldyB9IGZyb20gJ0Bjb2RlbWlycm9yL3ZpZXcnO1xuaW1wb3J0IHsgY2FzdFRvIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL29iamVjdC11dGlscyc7XG5pbXBvcnQgeyBWaWV3VHlwZSB9IGZyb20gJ0BvYnNpZGlhbi10eXBpbmdzL29ic2lkaWFuLXB1YmxpYy1sYXRlc3QvaW1wbGVtZW50YXRpb25zJztcbmltcG9ydCB7IE1hcmtkb3duVmlldyB9IGZyb20gJ29ic2lkaWFuJztcblxuaW1wb3J0IHR5cGUgeyBQYXRoT3JGaWxlIH0gZnJvbSAnLi9maWxlLXN5c3RlbS50cyc7XG5cbmltcG9ydCB7IGdldFBhdGggfSBmcm9tICcuL2ZpbGUtc3lzdGVtLnRzJztcblxuY29uc3QgY29tcGFydG1lbnRCeUNvZGVNaXJyb3IgPSBuZXcgV2Vha01hcDxFZGl0b3JbJ2NtJ10sIENvbXBhcnRtZW50PigpO1xuXG4vLyBTZXQgdHJ1ZSB3aGlsZSBhIGxvY2tlZCBlZGl0b3IgcHJvY2Vzc2VzIGEgYGtleWRvd25gIHN5bmNocm9ub3VzbHkuXG4vLyBUaGUgcmVhZC1vbmx5IGNoYW5nZSBmaWx0ZXIgcmVhZHMgaXQgdG8gYmxvY2sgYSBrZXlib2FyZC1kcml2ZW4gZWRpdCBidXQgcGFzcyBhIHByb2dyYW1tYXRpYyBvbmUuXG4vLyBJdCBpcyByZXNldCBpbiBhIG1pY3JvdGFzaywgYWZ0ZXIgdGhlIGtleSBldmVudCdzIHN5bmNocm9ub3VzIGRpc3BhdGNoIGNvbXBsZXRlcy5cbi8qKlxuTW9kdWxlLWxldmVsIG11dGFibGUgc3RhdGUsIGhlbGQgaW4gb25lIG9iamVjdCBzbyBlYWNoIG11dGF0aW9uIG5hbWVzIGl0IGV4cGxpY2l0bHkuXG4gKi9cbmNvbnN0IG1vZHVsZVN0YXRlID0ge1xuICBpc1Byb2Nlc3NpbmdMb2NrZWRFZGl0b3JLZXlkb3duOiBmYWxzZVxufTtcbi8qKlxuICogT3ZlcndyaXRlcyB0aGUgYnVmZmVyIG9mIGV2ZXJ5IG9wZW4ge0BsaW5rIE1hcmtkb3duVmlld30gY3VycmVudGx5IHNob3dpbmcgdGhlIGdpdmVuIHBhdGggc28gdGhhdFxuICogaXQgcmVmbGVjdHMgYGNvbnRlbnRgLCBpbiBhbnkgd2luZG93IG9yIHBvcG91dC5cbiAqXG4gKiBUaGlzIGlzIHRoZSBmaXggZm9yIGEgc3VidGxlIGRhdGEtbG9zcyB3aW5kb3c6IHdoZW4gYSBub3RlIGlzIG9wZW4gaW4gYW4gZWRpdG9yIHdpdGggYSAqKmRpcnR5XG4gKiBidWZmZXIqKiAoYSBwZW5kaW5nLCBub3QteWV0LXNhdmVkIGVkaXQpIGFuZCBpdHMgZmlsZSBjb250ZW50IGlzIHJld3JpdHRlbiBvbiBkaXNrIG91dCBmcm9tIHVuZGVyXG4gKiB0aGUgZWRpdG9yLCB0aGUgZWRpdG9yJ3MgbmV4dCBhdXRvc2F2ZSByZS13cml0ZXMgaXRzIHN0YWxlIGJ1ZmZlciBhbmQgY2xvYmJlcnMgdGhlIG9uLWRpc2sgY29udGVudC5cbiAqIEEgY2FsbGVyIHRoYXQgcmVzdG9yZXMgYSBmaWxlJ3MgY29udGVudCBvbiBkaXNrIChlLmcuIHJvbGxpbmcgYmFjayBhIHRyYW5zYWN0aW9uKSBtdXN0IGFsc28gcmVzZXRcbiAqIHRoZSBvcGVuIGVkaXRvcidzIGJ1ZmZlciB0byB0aGUgc2FtZSBjb250ZW50LCBzbyBpdHMgbmV4dCBzYXZlIGlzIGEgbm8tb3AgaW5zdGVhZCBvZiBhIGNsb2JiZXIuXG4gKlxuICogT25seSB0aGUgdmlldyB3aG9zZSB7QGxpbmsgTWFya2Rvd25WaWV3LmZpbGV9IHN0aWxsIG1hdGNoZXMgYHBhdGhPckZpbGVgIGlzIHRvdWNoZWQgXHUyMDE0IGlmIHRoZSBlZGl0b3JcbiAqIGhhcyBzaW5jZSBuYXZpZ2F0ZWQgdG8gYW5vdGhlciBub3RlLCBpdCBpcyBsZWZ0IGFsb25lLiBUaGUgYnVmZmVyIGlzIHJlcGxhY2VkIG9ubHkgd2hlbiBpdCBhY3R1YWxseVxuICogZGlmZmVycyBmcm9tIGBjb250ZW50YCwgc28gYSBjbGVhbiBlZGl0b3IgYWxyZWFkeSBpbiBzeW5jIGlzIG5vdCBkaXN0dXJiZWQgKG5vIGN1cnNvciByZXNldCkuXG4gKlxuICogQHBhcmFtIGFwcCAtIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2UuXG4gKiBAcGFyYW0gcGF0aE9yRmlsZSAtIFRoZSBwYXRoIG9yIGZpbGUgd2hvc2Ugb3BlbiBlZGl0b3JzIHNob3VsZCBiZSBzeW5jaHJvbml6ZWQuXG4gKiBAcGFyYW0gY29udGVudCAtIFRoZSBjb250ZW50IHRvIG92ZXJ3cml0ZSBlYWNoIG1hdGNoaW5nIGVkaXRvcidzIGJ1ZmZlciB3aXRoLlxuICovXG5leHBvcnQgZnVuY3Rpb24gc3luY09wZW5FZGl0b3JCdWZmZXJzRm9yUGF0aChhcHA6IEFwcCwgcGF0aE9yRmlsZTogUGF0aE9yRmlsZSwgY29udGVudDogc3RyaW5nKTogdm9pZCB7XG4gIGNvbnN0IHBhdGggPSBnZXRQYXRoKGFwcCwgcGF0aE9yRmlsZSk7XG4gIGZvciAoY29uc3QgbGVhZiBvZiBhcHAud29ya3NwYWNlLmdldExlYXZlc09mVHlwZShWaWV3VHlwZS5NYXJrZG93bikpIHtcbiAgICBjb25zdCB2aWV3ID0gbGVhZi52aWV3O1xuICAgIGlmICghKHZpZXcgaW5zdGFuY2VvZiBNYXJrZG93blZpZXcpIHx8ICh2aWV3LmZpbGU/LnBhdGggIT09IHBhdGgpKSB7XG4gICAgICBjb250aW51ZTtcbiAgICB9XG4gICAgaWYgKHZpZXcuZWRpdG9yLmdldFZhbHVlKCkgIT09IGNvbnRlbnQpIHtcbiAgICAgIHZpZXcuZWRpdG9yLnNldFZhbHVlKGNvbnRlbnQpO1xuICAgIH1cbiAgfVxufVxuXG4vKipcbiAqIFRvZ2dsZXMgdGhlIHJlYWQtb25seSBzdGF0ZSBvZiBhIHNpbmdsZSBDb2RlTWlycm9yIGluc3RhbmNlIFx1MjAxNCB0aGUgbG93LWxldmVsIHByaW1pdGl2ZSBiZWhpbmRcbiAqIGVkaXRvciBsb2NraW5nLlxuICpcbiAqIFdoZW4gcmVhZC1vbmx5LCB0aGUgZWRpdG9yIHN0YXlzIGZvY3VzYWJsZSBhbmQgaW50ZXJhY3RpdmUgKHNlbGVjdGlvbiwgY29weSwgYW5kIGFwcCBob3RrZXlzIHN1Y2hcbiAqIGFzIHRoZSBjb21tYW5kIHBhbGV0dGUga2VlcCB3b3JraW5nKSBcdTIwMTQgb25seSBkb2N1bWVudCBlZGl0cyBhcmUgcHJldmVudGVkLCB2aWEgdGhlIENvZGVNaXJyb3JcbiAqIGByZWFkT25seWAgc3RhdGUgcGx1cyBhIGNoYW5nZSBmaWx0ZXIgdGhhdCBkcm9wcyBhbnkgdXNlci1vcmlnaW5hdGVkIGNoYW5nZSAoc2VlXG4gKiB7QGxpbmsgcmVhZE9ubHlFeHRlbnNpb259KS5cbiAqXG4gKiBUaGlzIHRvZ2dsZXMgT05FIENvZGVNaXJyb3IgaW5zdGFuY2UsIG5vdCBcImEgZmlsZVwiOiBhbiBPYnNpZGlhbiB7QGxpbmsgRWRpdG9yfSBpcyByZXVzZWQgYXMgaXRzXG4gKiBsZWFmIG5hdmlnYXRlcyBiZXR3ZWVuIG5vdGVzLCBzbyB0aGlzIHByaW1pdGl2ZSBkb2VzIG5vdCBmb2xsb3cgYSBub3RlIGFyb3VuZC4gVG8gbG9jayBhIG5vdGVcbiAqIGFjcm9zcyBldmVyeSBlZGl0b3IgdGhhdCBzaG93cyBpdCAoY3VycmVudCBhbmQgZnV0dXJlLCBpbiBhbnkgd2luZG93KSwgdXNlIGBsb2NrUmVzb3VyY2VGb3JQYXRoYFxuICogZnJvbSBgLi9yZXNvdXJjZS1sb2NrLnRzYC5cbiAqXG4gKiBAcGFyYW0gZWRpdG9yIC0gVGhlIGVkaXRvciB3aG9zZSBDb2RlTWlycm9yIGluc3RhbmNlIHRvIHRvZ2dsZS5cbiAqIEBwYXJhbSBpc1JlYWRPbmx5IC0gYHRydWVgIHRvIG1ha2UgdGhlIGVkaXRvciByZWFkLW9ubHksIGBmYWxzZWAgdG8gbWFrZSBpdCBlZGl0YWJsZSBhZ2Fpbi5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHRvZ2dsZUVkaXRvclJlYWRPbmx5KGVkaXRvcjogRWRpdG9yLCBpc1JlYWRPbmx5OiBib29sZWFuKTogdm9pZCB7XG4gIGNvbnN0IGNvbXBhcnRtZW50ID0gZW5zdXJlQ29tcGFydG1lbnQoZWRpdG9yKTtcbiAgZWRpdG9yLmNtLmRpc3BhdGNoKHtcbiAgICBlZmZlY3RzOiBjb21wYXJ0bWVudC5yZWNvbmZpZ3VyZShpc1JlYWRPbmx5ID8gcmVhZE9ubHlFeHRlbnNpb24oKSA6IFtdKVxuICB9KTtcbn1cblxuZnVuY3Rpb24gZW5zdXJlQ29tcGFydG1lbnQoZWRpdG9yOiBFZGl0b3IpOiBDb21wYXJ0bWVudCB7XG4gIC8vIEtleSB0aGUgY2FjaGUgYnkgdGhlIENvZGVNaXJyb3IgaW5zdGFuY2UsIG5vdCBieSB0aGUgYEVkaXRvcmAgd3JhcHBlci5cbiAgLy8gQW4gYEVkaXRvcmAga2VlcHMgaXRzIGlkZW50aXR5IHdoaWxlIGl0cyB1bmRlcmx5aW5nIENvZGVNaXJyb3IgdmlldyBpcyBzd2FwcGVkIG91dC5cbiAgY29uc3QgY29kZU1pcnJvciA9IGVkaXRvci5jbTtcbiAgY29uc3QgY2FjaGVkQ29tcGFydG1lbnQgPSBjb21wYXJ0bWVudEJ5Q29kZU1pcnJvci5nZXQoY29kZU1pcnJvcik7XG4gIC8vIFJldXNlIHRoZSBjYWNoZWQgY29tcGFydG1lbnQgb25seSB3aGlsZSBpdCBpcyBzdGlsbCBwYXJ0IG9mIHRoZSBjdXJyZW50IGNvbmZpZ3VyYXRpb24uXG4gIC8vIEEgdmlldyBjYW4gc2lsZW50bHkgZHJvcCBhbiBhcHBlbmRlZCBjb21wYXJ0bWVudCB3aGVuIGl0IHJlYnVpbGRzIGl0cyBzdGF0ZS5cbiAgLy8gT3BlbmluZyBhIG5vdGUgaW50byBhIGZyZXNobHkgY3JlYXRlZCBsZWFmIGRvZXMgdGhpczogaXQgaW5zdGFsbHMgdGhlIGNvbXBhcnRtZW50IG1pZC1vcGVuLlxuICAvLyBUaGUgc3Vic2VxdWVudCBsb2FkIHRoZW4gcmVwbGFjZXMgdGhlIHdob2xlIHN0YXRlLCB0YWtpbmcgdGhlIGNvbXBhcnRtZW50IHdpdGggaXQuXG4gIC8vIFRoZW4gYENvbXBhcnRtZW50LmdldGAgcmV0dXJucyBgdW5kZWZpbmVkYCwgc2luY2UgdGhlIGNvbXBhcnRtZW50IGlzIG5vIGxvbmdlciBjb25maWd1cmVkLlxuICAvLyBSZS1pbnN0YWxsIGl0IGluIHRoYXQgY2FzZSwgb3IgZXZlcnkgbGF0ZXIgYHJlY29uZmlndXJlYCBpcyBzaWxlbnRseSBpZ25vcmVkIGFuZCBub3RoaW5nIGxvY2tzLlxuICAvLyBUaGUgYGNhc3RUb2AgYnJpZGdlcyB0aGUgZHVhbCBDb21tb25KUyBhbmQgRVNNIGBFZGl0b3JTdGF0ZWAgZGVjbGFyYXRpb25zIG9mIGBAY29kZW1pcnJvci9zdGF0ZWAuXG4gIC8vIFRoZXkgYXJlIHN0cnVjdHVyYWxseSBpZGVudGljYWwsIGJ1dCBUeXBlU2NyaXB0IHRyZWF0cyB0aGVtIGFzIG5vbWluYWxseSBpbmNvbXBhdGlibGUuXG4gIGlmIChjYWNoZWRDb21wYXJ0bWVudD8uZ2V0KGNhc3RUbzxFZGl0b3JTdGF0ZT4oY29kZU1pcnJvci5zdGF0ZSkpICE9PSB1bmRlZmluZWQpIHtcbiAgICByZXR1cm4gY2FjaGVkQ29tcGFydG1lbnQ7XG4gIH1cblxuICBjb25zdCBjb21wYXJ0bWVudCA9IG5ldyBDb21wYXJ0bWVudCgpO1xuICBjb21wYXJ0bWVudEJ5Q29kZU1pcnJvci5zZXQoY29kZU1pcnJvciwgY29tcGFydG1lbnQpO1xuICAvLyBBIGBDb21wYXJ0bWVudGAgb25seSB0YWtlcyBlZmZlY3Qgb25jZSBpdCBpcyBwYXJ0IG9mIHRoZSBlZGl0b3IncyBjb25maWd1cmF0aW9uLlxuICAvLyBUaGUgY29tcGFydG1lbnQgaXMgY3JlYXRlZCBsYXppbHkgaGVyZSwgc28gaW5zdGFsbCBpdCAoaW5pdGlhbGx5IGVtcHR5KSB2aWEgYGFwcGVuZENvbmZpZ2AuXG4gIGNvZGVNaXJyb3IuZGlzcGF0Y2goe1xuICAgIGVmZmVjdHM6IFN0YXRlRWZmZWN0LmFwcGVuZENvbmZpZy5vZihjb21wYXJ0bWVudC5vZihbXSkpXG4gIH0pO1xuICByZXR1cm4gY29tcGFydG1lbnQ7XG59XG5cbi8qKlxuICogVGhlIGV4dGVuc2lvbiBpbnN0YWxsZWQgaW50byB0aGUgcmVhZC1vbmx5IGNvbXBhcnRtZW50IHdoaWxlIGEgbm90ZSBpcyBsb2NrZWQuXG4gKlxuICogYEVkaXRvclN0YXRlLnJlYWRPbmx5YCBhbG9uZSBpcyBub3QgZW5vdWdoOiBpdCBibG9ja3MgQ29kZU1pcnJvcidzIG93biBlZGl0aW5nIGNvbW1hbmRzIGFuZCBET01cbiAqIGlucHV0LCBidXQgT2JzaWRpYW4gYmluZHMgc29tZSBrZXlzIChub3RhYmx5IGBTaGlmdCtFbnRlcmApIHRvIGhhbmRsZXJzIHRoYXQgZGlzcGF0Y2ggYSBjaGFuZ2VcbiAqIHRyYW5zYWN0aW9uIGRpcmVjdGx5LCB3aGljaCBzbGlwcyBwYXN0IHRoZSBgcmVhZE9ubHlgIGZhY2V0IGFuZCBlZGl0cyB0aGUgXCJsb2NrZWRcIiBub3RlLiBTdWNoIGFcbiAqIHRyYW5zYWN0aW9uIGlzIGluZGlzdGluZ3Vpc2hhYmxlIGZyb20gYSBwcm9ncmFtbWF0aWMgb25lIGJ5IGl0cyBjb250ZW50cyAobm8gdXNlci1ldmVudFxuICogYW5ub3RhdGlvbiksIHNvIGl0IGlzIHRvbGQgYXBhcnQgYnkgb3JpZ2luIGluc3RlYWQ6IGEgaGlnaGVzdC1wcmVjZWRlbmNlIGBrZXlkb3duYCBoYW5kbGVyIG1hcmtzXG4gKiB0aGUgd2luZG93IGR1cmluZyB3aGljaCB0aGUga2V5IGlzIHByb2Nlc3NlZCBzeW5jaHJvbm91c2x5LCBhbmQgdGhlIGFkZGVkIGBjaGFuZ2VGaWx0ZXJgIGRyb3BzIHRoZVxuICogY2hhbmdlcyBvZiBhbnkgdHJhbnNhY3Rpb24gcHJvZHVjZWQgaW5zaWRlIHRoYXQgd2luZG93LiBQcm9ncmFtbWF0aWMgZWRpdHMgKGUuZy5cbiAqIGBzeW5jT3BlbkVkaXRvckJ1ZmZlcnNGb3JQYXRoYCByZXN0b3JpbmcgYSBidWZmZXIgb24gcm9sbGJhY2ssIG9yIE9ic2lkaWFuIHJlbG9hZGluZyB0aGUgYnVmZmVyXG4gKiBmcm9tIGRpc2spIGhhcHBlbiBvdXRzaWRlIGEga2V5ZG93biwgc28gdGhleSBzdGlsbCBnbyB0aHJvdWdoLlxuICpcbiAqIEByZXR1cm5zIFRoZSBleHRlbnNpb24gZW5mb3JjaW5nIHJlYWQtb25seSBmb3IgYSBsb2NrZWQgZWRpdG9yLlxuICovXG5mdW5jdGlvbiByZWFkT25seUV4dGVuc2lvbigpOiBFeHRlbnNpb24ge1xuICByZXR1cm4gW1xuICAgIEVkaXRvclN0YXRlLnJlYWRPbmx5Lm9mKHRydWUpLFxuICAgIFByZWMuaGlnaGVzdChFZGl0b3JWaWV3LmRvbUV2ZW50SGFuZGxlcnMoe1xuICAgICAga2V5ZG93bjogKCk6IGJvb2xlYW4gPT4ge1xuICAgICAgICBtb2R1bGVTdGF0ZS5pc1Byb2Nlc3NpbmdMb2NrZWRFZGl0b3JLZXlkb3duID0gdHJ1ZTtcbiAgICAgICAgcXVldWVNaWNyb3Rhc2soKCkgPT4ge1xuICAgICAgICAgIG1vZHVsZVN0YXRlLmlzUHJvY2Vzc2luZ0xvY2tlZEVkaXRvcktleWRvd24gPSBmYWxzZTtcbiAgICAgICAgfSk7XG4gICAgICAgIC8vIERvIG5vdCBjb25zdW1lIHRoZSBldmVudDogbGV0IENvZGVNaXJyb3IncyBrZXltYXAgcnVuIHNvIG5hdmlnYXRpb24vc2VsZWN0aW9uIGtleXMgd29yay5cbiAgICAgICAgcmV0dXJuIGZhbHNlO1xuICAgICAgfVxuICAgIH0pKSxcbiAgICBFZGl0b3JTdGF0ZS5jaGFuZ2VGaWx0ZXIub2YoKCkgPT4gIW1vZHVsZVN0YXRlLmlzUHJvY2Vzc2luZ0xvY2tlZEVkaXRvcktleWRvd24pXG4gIF07XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBWUE7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsT0FDSztBQUNQLFNBQVMsa0JBQWtCO0FBQzNCLFNBQVMsY0FBYztBQUN2QixTQUFTLGdCQUFnQjtBQUN6QixTQUFTLG9CQUFvQjtBQUk3QixTQUFTLGVBQWU7QUFFeEIsTUFBTSwwQkFBMEIsb0JBQUksUUFBbUM7QUFRdkUsTUFBTSxjQUFjO0FBQUEsRUFDbEIsaUNBQWlDO0FBQ25DO0FBbUJPLFNBQVMsNkJBQTZCLEtBQVUsWUFBd0IsU0FBdUI7QUFDcEcsUUFBTSxPQUFPLFFBQVEsS0FBSyxVQUFVO0FBQ3BDLGFBQVcsUUFBUSxJQUFJLFVBQVUsZ0JBQWdCLFNBQVMsUUFBUSxHQUFHO0FBQ25FLFVBQU0sT0FBTyxLQUFLO0FBQ2xCLFFBQUksRUFBRSxnQkFBZ0IsaUJBQWtCLEtBQUssTUFBTSxTQUFTLE1BQU87QUFDakU7QUFBQSxJQUNGO0FBQ0EsUUFBSSxLQUFLLE9BQU8sU0FBUyxNQUFNLFNBQVM7QUFDdEMsV0FBSyxPQUFPLFNBQVMsT0FBTztBQUFBLElBQzlCO0FBQUEsRUFDRjtBQUNGO0FBbUJPLFNBQVMscUJBQXFCLFFBQWdCLFlBQTJCO0FBQzlFLFFBQU0sY0FBYyxrQkFBa0IsTUFBTTtBQUM1QyxTQUFPLEdBQUcsU0FBUztBQUFBLElBQ2pCLFNBQVMsWUFBWSxZQUFZLGFBQWEsa0JBQWtCLElBQUksQ0FBQyxDQUFDO0FBQUEsRUFDeEUsQ0FBQztBQUNIO0FBRUEsU0FBUyxrQkFBa0IsUUFBNkI7QUFHdEQsUUFBTSxhQUFhLE9BQU87QUFDMUIsUUFBTSxvQkFBb0Isd0JBQXdCLElBQUksVUFBVTtBQVNoRSxNQUFJLG1CQUFtQixJQUFJLE9BQW9CLFdBQVcsS0FBSyxDQUFDLE1BQU0sUUFBVztBQUMvRSxXQUFPO0FBQUEsRUFDVDtBQUVBLFFBQU0sY0FBYyxJQUFJLFlBQVk7QUFDcEMsMEJBQXdCLElBQUksWUFBWSxXQUFXO0FBR25ELGFBQVcsU0FBUztBQUFBLElBQ2xCLFNBQVMsWUFBWSxhQUFhLEdBQUcsWUFBWSxHQUFHLENBQUMsQ0FBQyxDQUFDO0FBQUEsRUFDekQsQ0FBQztBQUNELFNBQU87QUFDVDtBQWlCQSxTQUFTLG9CQUErQjtBQUN0QyxTQUFPO0FBQUEsSUFDTCxZQUFZLFNBQVMsR0FBRyxJQUFJO0FBQUEsSUFDNUIsS0FBSyxRQUFRLFdBQVcsaUJBQWlCO0FBQUEsTUFDdkMsU0FBUyxNQUFlO0FBQ3RCLG9CQUFZLGtDQUFrQztBQUM5Qyx1QkFBZSxNQUFNO0FBQ25CLHNCQUFZLGtDQUFrQztBQUFBLFFBQ2hELENBQUM7QUFFRCxlQUFPO0FBQUEsTUFDVDtBQUFBLElBQ0YsQ0FBQyxDQUFDO0FBQUEsSUFDRixZQUFZLGFBQWEsR0FBRyxNQUFNLENBQUMsWUFBWSwrQkFBK0I7QUFBQSxFQUNoRjtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/esm/events.d.mts

@@ -0,0 +1,98 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * Typed helpers for subscribing to an Obsidian {@link Events} source. Both derive the valid event names and their
+ * callback argument types from the source's overloaded `on` method (via {@link ExtractEventMap}), so the event
+ * name and handler are fully autocompleted. {@link subscribeEvent} returns the raw {@link EventRef} (parity with
+ * {@link Events.on}); {@link subscribeDisposableEvent} returns a {@link DisposableEx} that unregisters it.
+ */
+import type { DisposableEx } from '@mnaoumov/typescript-lib/disposable';
+import type { ExtractEventMap } from '@mnaoumov/typescript-lib/type';
+import type { EventRef, Events } from 'obsidian';
+import { DisposableBase } from '@mnaoumov/typescript-lib/disposable';
+/**
+ * Parameters for {@link subscribeDisposableEvent}. Same shape as {@link SubscribeEventParams}.
+ *
+ * @typeParam Source - The {@link Events} source type.
+ * @typeParam EventName - The event name, constrained to the source's known events.
+ */
+export type SubscribeDisposableEventParams<Source extends Events, EventName extends EventNameOf<Source>> = SubscribeEventParams<Source, EventName>;
+/**
+ * Parameters for {@link subscribeEvent}.
+ *
+ * @typeParam Source - The {@link Events} source type.
+ * @typeParam EventName - The event name, constrained to the source's known events.
+ */
+export interface SubscribeEventParams<Source extends Events, EventName extends EventNameOf<Source>> {
+    /**
+     * The event callback. Its argument types are inferred from {@link SubscribeEventParams.name}.
+     */
+    readonly callback: EventCallbackOf<Source, EventName>;
+    /**
+     * The event source to subscribe on.
+     */
+    readonly events: Source;
+    /**
+     * The event name to subscribe to.
+     */
+    readonly name: EventName;
+    /**
+     * The context passed as `this` to the callback.
+     */
+    readonly thisArgument?: unknown;
+}
+/**
+ * The callback type for a given event on a {@link Events} source, with its argument tuple inferred from
+ * {@link ExtractEventMap}.
+ *
+ * @typeParam Source - The {@link Events} source type.
+ * @typeParam EventName - The event name.
+ */
+type EventCallbackOf<Source extends Events, EventName extends EventNameOf<Source>> = ExtractEventMap<Source>[EventName] extends infer Arguments extends unknown[] ? (...$arguments: Arguments) => unknown : never;
+/**
+ * The union of known event names for a {@link Events} source, derived from its `on` overloads.
+ *
+ * @typeParam Source - The {@link Events} source type.
+ */
+type EventNameOf<Source extends Events> = keyof ExtractEventMap<Source> & string;
+/**
+ * A {@link DisposableEx} that unregisters an Obsidian {@link EventRef} on dispose, via the event source exposed on
+ * the ref itself (`eventRef.e`).
+ */
+export declare class EventRefDisposable extends DisposableBase {
+    private readonly eventRef;
+    /**
+     * Creates a disposable wrapping an existing {@link EventRef}.
+     *
+     * @param eventRef - The event reference to unregister on dispose.
+     */
+    constructor(eventRef: EventRef);
+    /**
+     * Unregisters the event via the source stored on the ref (`eventRef.e.offref`).
+     */
+    protected performDispose(): void;
+}
+/**
+ * Subscribes to an event on an {@link Events} source and returns a {@link DisposableEx} that unregisters it on
+ * dispose. Typed wrapper over {@link Events.on}: the event name and callback arguments are autocompleted from the
+ * source's overloads.
+ *
+ * @typeParam Source - The {@link Events} source type.
+ * @typeParam EventName - The event name.
+ * @param params - The subscription parameters.
+ * @returns A {@link DisposableEx} that unregisters the handler when disposed.
+ */
+export declare function subscribeDisposableEvent<Source extends Events, EventName extends EventNameOf<Source>>(params: SubscribeDisposableEventParams<Source, EventName>): DisposableEx;
+/**
+ * Subscribes to an event on an {@link Events} source and returns the raw {@link EventRef} (parity with
+ * {@link Events.on}). Typed wrapper: the event name and callback arguments are autocompleted from the source's
+ * overloads.
+ *
+ * @typeParam Source - The {@link Events} source type.
+ * @typeParam EventName - The event name.
+ * @param params - The subscription parameters.
+ * @returns The {@link EventRef} for the registered handler.
+ */
+export declare function subscribeEvent<Source extends Events, EventName extends EventNameOf<Source>>(params: SubscribeEventParams<Source, EventName>): EventRef;
+export {};

package/dist/lib/esm/events.mjs

@@ -0,0 +1,81 @@
+/*
+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 { DisposableBase } from "@mnaoumov/typescript-lib/disposable";
+import { castTo } from "@mnaoumov/typescript-lib/object-utils";
+class EventRefDisposable extends DisposableBase {
+  /**
+   * Creates a disposable wrapping an existing {@link EventRef}.
+   *
+   * @param eventRef - The event reference to unregister on dispose.
+   */
+  constructor(eventRef) {
+    super();
+    this.eventRef = eventRef;
+  }
+  eventRef;
+  /**
+   * Unregisters the event via the source stored on the ref (`eventRef.e.offref`).
+   */
+  performDispose() {
+    this.eventRef.e.offref(this.eventRef);
+  }
+}
+function subscribeDisposableEvent(params) {
+  return new EventRefDisposable(subscribeEvent(params));
+}
+function subscribeEvent(params) {
+  return params.events.on(params.name, castTo(params.callback), params.thisArgument);
+}
+export {
+  EventRefDisposable,
+  subscribeDisposableEvent,
+  subscribeEvent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2V2ZW50cy50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFR5cGVkIGhlbHBlcnMgZm9yIHN1YnNjcmliaW5nIHRvIGFuIE9ic2lkaWFuIHtAbGluayBFdmVudHN9IHNvdXJjZS4gQm90aCBkZXJpdmUgdGhlIHZhbGlkIGV2ZW50IG5hbWVzIGFuZCB0aGVpclxuICogY2FsbGJhY2sgYXJndW1lbnQgdHlwZXMgZnJvbSB0aGUgc291cmNlJ3Mgb3ZlcmxvYWRlZCBgb25gIG1ldGhvZCAodmlhIHtAbGluayBFeHRyYWN0RXZlbnRNYXB9KSwgc28gdGhlIGV2ZW50XG4gKiBuYW1lIGFuZCBoYW5kbGVyIGFyZSBmdWxseSBhdXRvY29tcGxldGVkLiB7QGxpbmsgc3Vic2NyaWJlRXZlbnR9IHJldHVybnMgdGhlIHJhdyB7QGxpbmsgRXZlbnRSZWZ9IChwYXJpdHkgd2l0aFxuICoge0BsaW5rIEV2ZW50cy5vbn0pOyB7QGxpbmsgc3Vic2NyaWJlRGlzcG9zYWJsZUV2ZW50fSByZXR1cm5zIGEge0BsaW5rIERpc3Bvc2FibGVFeH0gdGhhdCB1bnJlZ2lzdGVycyBpdC5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IERpc3Bvc2FibGVFeCB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9kaXNwb3NhYmxlJztcbmltcG9ydCB0eXBlIHsgR2VuZXJpY0Z1bmN0aW9uIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL2Z1bmN0aW9uJztcbmltcG9ydCB0eXBlIHsgRXh0cmFjdEV2ZW50TWFwIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL3R5cGUnO1xuaW1wb3J0IHR5cGUge1xuICBFdmVudFJlZixcbiAgRXZlbnRzXG59IGZyb20gJ29ic2lkaWFuJztcblxuaW1wb3J0IHsgRGlzcG9zYWJsZUJhc2UgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvZGlzcG9zYWJsZSc7XG5pbXBvcnQgeyBjYXN0VG8gfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvb2JqZWN0LXV0aWxzJztcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgc3Vic2NyaWJlRGlzcG9zYWJsZUV2ZW50fS4gU2FtZSBzaGFwZSBhcyB7QGxpbmsgU3Vic2NyaWJlRXZlbnRQYXJhbXN9LlxuICpcbiAqIEB0eXBlUGFyYW0gU291cmNlIC0gVGhlIHtAbGluayBFdmVudHN9IHNvdXJjZSB0eXBlLlxuICogQHR5cGVQYXJhbSBFdmVudE5hbWUgLSBUaGUgZXZlbnQgbmFtZSwgY29uc3RyYWluZWQgdG8gdGhlIHNvdXJjZSdzIGtub3duIGV2ZW50cy5cbiAqL1xuZXhwb3J0IHR5cGUgU3Vic2NyaWJlRGlzcG9zYWJsZUV2ZW50UGFyYW1zPFNvdXJjZSBleHRlbmRzIEV2ZW50cywgRXZlbnROYW1lIGV4dGVuZHMgRXZlbnROYW1lT2Y8U291cmNlPj4gPSBTdWJzY3JpYmVFdmVudFBhcmFtczxcbiAgU291cmNlLFxuICBFdmVudE5hbWVcbj47XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIHN1YnNjcmliZUV2ZW50fS5cbiAqXG4gKiBAdHlwZVBhcmFtIFNvdXJjZSAtIFRoZSB7QGxpbmsgRXZlbnRzfSBzb3VyY2UgdHlwZS5cbiAqIEB0eXBlUGFyYW0gRXZlbnROYW1lIC0gVGhlIGV2ZW50IG5hbWUsIGNvbnN0cmFpbmVkIHRvIHRoZSBzb3VyY2UncyBrbm93biBldmVudHMuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgU3Vic2NyaWJlRXZlbnRQYXJhbXM8U291cmNlIGV4dGVuZHMgRXZlbnRzLCBFdmVudE5hbWUgZXh0ZW5kcyBFdmVudE5hbWVPZjxTb3VyY2U+PiB7XG4gIC8qKlxuICAgKiBUaGUgZXZlbnQgY2FsbGJhY2suIEl0cyBhcmd1bWVudCB0eXBlcyBhcmUgaW5mZXJyZWQgZnJvbSB7QGxpbmsgU3Vic2NyaWJlRXZlbnRQYXJhbXMubmFtZX0uXG4gICAqL1xuICByZWFkb25seSBjYWxsYmFjazogRXZlbnRDYWxsYmFja09mPFNvdXJjZSwgRXZlbnROYW1lPjtcblxuICAvKipcbiAgICogVGhlIGV2ZW50IHNvdXJjZSB0byBzdWJzY3JpYmUgb24uXG4gICAqL1xuICByZWFkb25seSBldmVudHM6IFNvdXJjZTtcblxuICAvKipcbiAgICogVGhlIGV2ZW50IG5hbWUgdG8gc3Vic2NyaWJlIHRvLlxuICAgKi9cbiAgcmVhZG9ubHkgbmFtZTogRXZlbnROYW1lO1xuXG4gIC8qKlxuICAgKiBUaGUgY29udGV4dCBwYXNzZWQgYXMgYHRoaXNgIHRvIHRoZSBjYWxsYmFjay5cbiAgICovXG4gIHJlYWRvbmx5IHRoaXNBcmd1bWVudD86IHVua25vd247XG59XG5cbi8qKlxuICogVGhlIGNhbGxiYWNrIHR5cGUgZm9yIGEgZ2l2ZW4gZXZlbnQgb24gYSB7QGxpbmsgRXZlbnRzfSBzb3VyY2UsIHdpdGggaXRzIGFyZ3VtZW50IHR1cGxlIGluZmVycmVkIGZyb21cbiAqIHtAbGluayBFeHRyYWN0RXZlbnRNYXB9LlxuICpcbiAqIEB0eXBlUGFyYW0gU291cmNlIC0gVGhlIHtAbGluayBFdmVudHN9IHNvdXJjZSB0eXBlLlxuICogQHR5cGVQYXJhbSBFdmVudE5hbWUgLSBUaGUgZXZlbnQgbmFtZS5cbiAqL1xudHlwZSBFdmVudENhbGxiYWNrT2Y8U291cmNlIGV4dGVuZHMgRXZlbnRzLCBFdmVudE5hbWUgZXh0ZW5kcyBFdmVudE5hbWVPZjxTb3VyY2U+PiA9IEV4dHJhY3RFdmVudE1hcDxTb3VyY2U+W0V2ZW50TmFtZV0gZXh0ZW5kcyBpbmZlciBBcmd1bWVudHMgZXh0ZW5kcyB1bmtub3duW10gPyAoLi4uJGFyZ3VtZW50czogQXJndW1lbnRzKSA9PiB1bmtub3duXG4gIDogbmV2ZXI7XG5cbi8qKlxuICogVGhlIHVuaW9uIG9mIGtub3duIGV2ZW50IG5hbWVzIGZvciBhIHtAbGluayBFdmVudHN9IHNvdXJjZSwgZGVyaXZlZCBmcm9tIGl0cyBgb25gIG92ZXJsb2Fkcy5cbiAqXG4gKiBAdHlwZVBhcmFtIFNvdXJjZSAtIFRoZSB7QGxpbmsgRXZlbnRzfSBzb3VyY2UgdHlwZS5cbiAqL1xudHlwZSBFdmVudE5hbWVPZjxTb3VyY2UgZXh0ZW5kcyBFdmVudHM+ID0ga2V5b2YgRXh0cmFjdEV2ZW50TWFwPFNvdXJjZT4gJiBzdHJpbmc7XG5cbi8qKlxuICogQSB7QGxpbmsgRGlzcG9zYWJsZUV4fSB0aGF0IHVucmVnaXN0ZXJzIGFuIE9ic2lkaWFuIHtAbGluayBFdmVudFJlZn0gb24gZGlzcG9zZSwgdmlhIHRoZSBldmVudCBzb3VyY2UgZXhwb3NlZCBvblxuICogdGhlIHJlZiBpdHNlbGYgKGBldmVudFJlZi5lYCkuXG4gKi9cbmV4cG9ydCBjbGFzcyBFdmVudFJlZkRpc3Bvc2FibGUgZXh0ZW5kcyBEaXNwb3NhYmxlQmFzZSB7XG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgZGlzcG9zYWJsZSB3cmFwcGluZyBhbiBleGlzdGluZyB7QGxpbmsgRXZlbnRSZWZ9LlxuICAgKlxuICAgKiBAcGFyYW0gZXZlbnRSZWYgLSBUaGUgZXZlbnQgcmVmZXJlbmNlIHRvIHVucmVnaXN0ZXIgb24gZGlzcG9zZS5cbiAgICovXG4gIHB1YmxpYyBjb25zdHJ1Y3Rvcihwcml2YXRlIHJlYWRvbmx5IGV2ZW50UmVmOiBFdmVudFJlZikge1xuICAgIHN1cGVyKCk7XG4gIH1cblxuICAvKipcbiAgICogVW5yZWdpc3RlcnMgdGhlIGV2ZW50IHZpYSB0aGUgc291cmNlIHN0b3JlZCBvbiB0aGUgcmVmIChgZXZlbnRSZWYuZS5vZmZyZWZgKS5cbiAgICovXG4gIHByb3RlY3RlZCBvdmVycmlkZSBwZXJmb3JtRGlzcG9zZSgpOiB2b2lkIHtcbiAgICB0aGlzLmV2ZW50UmVmLmUub2ZmcmVmKHRoaXMuZXZlbnRSZWYpO1xuICB9XG59XG5cbi8qKlxuICogU3Vic2NyaWJlcyB0byBhbiBldmVudCBvbiBhbiB7QGxpbmsgRXZlbnRzfSBzb3VyY2UgYW5kIHJldHVybnMgYSB7QGxpbmsgRGlzcG9zYWJsZUV4fSB0aGF0IHVucmVnaXN0ZXJzIGl0IG9uXG4gKiBkaXNwb3NlLiBUeXBlZCB3cmFwcGVyIG92ZXIge0BsaW5rIEV2ZW50cy5vbn06IHRoZSBldmVudCBuYW1lIGFuZCBjYWxsYmFjayBhcmd1bWVudHMgYXJlIGF1dG9jb21wbGV0ZWQgZnJvbSB0aGVcbiAqIHNvdXJjZSdzIG92ZXJsb2Fkcy5cbiAqXG4gKiBAdHlwZVBhcmFtIFNvdXJjZSAtIFRoZSB7QGxpbmsgRXZlbnRzfSBzb3VyY2UgdHlwZS5cbiAqIEB0eXBlUGFyYW0gRXZlbnROYW1lIC0gVGhlIGV2ZW50IG5hbWUuXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHN1YnNjcmlwdGlvbiBwYXJhbWV0ZXJzLlxuICogQHJldHVybnMgQSB7QGxpbmsgRGlzcG9zYWJsZUV4fSB0aGF0IHVucmVnaXN0ZXJzIHRoZSBoYW5kbGVyIHdoZW4gZGlzcG9zZWQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzdWJzY3JpYmVEaXNwb3NhYmxlRXZlbnQ8U291cmNlIGV4dGVuZHMgRXZlbnRzLCBFdmVudE5hbWUgZXh0ZW5kcyBFdmVudE5hbWVPZjxTb3VyY2U+PihcbiAgcGFyYW1zOiBTdWJzY3JpYmVEaXNwb3NhYmxlRXZlbnRQYXJhbXM8U291cmNlLCBFdmVudE5hbWU+XG4pOiBEaXNwb3NhYmxlRXgge1xuICByZXR1cm4gbmV3IEV2ZW50UmVmRGlzcG9zYWJsZShzdWJzY3JpYmVFdmVudChwYXJhbXMpKTtcbn1cblxuLyoqXG4gKiBTdWJzY3JpYmVzIHRvIGFuIGV2ZW50IG9uIGFuIHtAbGluayBFdmVudHN9IHNvdXJjZSBhbmQgcmV0dXJucyB0aGUgcmF3IHtAbGluayBFdmVudFJlZn0gKHBhcml0eSB3aXRoXG4gKiB7QGxpbmsgRXZlbnRzLm9ufSkuIFR5cGVkIHdyYXBwZXI6IHRoZSBldmVudCBuYW1lIGFuZCBjYWxsYmFjayBhcmd1bWVudHMgYXJlIGF1dG9jb21wbGV0ZWQgZnJvbSB0aGUgc291cmNlJ3NcbiAqIG92ZXJsb2Fkcy5cbiAqXG4gKiBAdHlwZVBhcmFtIFNvdXJjZSAtIFRoZSB7QGxpbmsgRXZlbnRzfSBzb3VyY2UgdHlwZS5cbiAqIEB0eXBlUGFyYW0gRXZlbnROYW1lIC0gVGhlIGV2ZW50IG5hbWUuXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHN1YnNjcmlwdGlvbiBwYXJhbWV0ZXJzLlxuICogQHJldHVybnMgVGhlIHtAbGluayBFdmVudFJlZn0gZm9yIHRoZSByZWdpc3RlcmVkIGhhbmRsZXIuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzdWJzY3JpYmVFdmVudDxTb3VyY2UgZXh0ZW5kcyBFdmVudHMsIEV2ZW50TmFtZSBleHRlbmRzIEV2ZW50TmFtZU9mPFNvdXJjZT4+KFxuICBwYXJhbXM6IFN1YnNjcmliZUV2ZW50UGFyYW1zPFNvdXJjZSwgRXZlbnROYW1lPlxuKTogRXZlbnRSZWYge1xuICAvLyBBIGdlbmVyaWMgYG5hbWVgIGNhbm5vdCBzZWxlY3Qgb25lIG9mIGBvbmAncyBzcGVjaWZpYyBvdmVybG9hZHMsIHNvIHRoZSBjYWxsIHJlc29sdmVzIGFnYWluc3QgdGhlIGJhc2VcbiAgLy8gYG9uKG5hbWU6IHN0cmluZywgY2FsbGJhY2ssIGN0eD8pYCBzaWduYXR1cmUgXHUyMDE0IHRoZSBjYWxsYmFjayBpcyBjYXN0IHRvIHRoYXQgc2lnbmF0dXJlJ3MgcGFyYW1ldGVyIHR5cGUuXG4gIHJldHVybiBwYXJhbXMuZXZlbnRzLm9uKHBhcmFtcy5uYW1lLCBjYXN0VG88R2VuZXJpY0Z1bmN0aW9uPHVua25vd25bXT4+KHBhcmFtcy5jYWxsYmFjayksIHBhcmFtcy50aGlzQXJndW1lbnQpO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQWlCQSxTQUFTLHNCQUFzQjtBQUMvQixTQUFTLGNBQWM7QUE4RGhCLE1BQU0sMkJBQTJCLGVBQWU7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFNOUMsWUFBNkIsVUFBb0I7QUFDdEQsVUFBTTtBQUQ0QjtBQUFBLEVBRXBDO0FBQUEsRUFGb0M7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9qQixpQkFBdUI7QUFDeEMsU0FBSyxTQUFTLEVBQUUsT0FBTyxLQUFLLFFBQVE7QUFBQSxFQUN0QztBQUNGO0FBWU8sU0FBUyx5QkFDZCxRQUNjO0FBQ2QsU0FBTyxJQUFJLG1CQUFtQixlQUFlLE1BQU0sQ0FBQztBQUN0RDtBQVlPLFNBQVMsZUFDZCxRQUNVO0FBR1YsU0FBTyxPQUFPLE9BQU8sR0FBRyxPQUFPLE1BQU0sT0FBbUMsT0FBTyxRQUFRLEdBQUcsT0FBTyxZQUFZO0FBQy9HOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/esm/extensions-registrar.d.mts

@@ -0,0 +1,51 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * Extensions registrars.
+ */
+import { Plugin } from 'obsidian';
+/**
+ * Extensions registrar.
+ */
+export interface ExtensionsRegistrar {
+    /**
+     * Registers extensions.
+     *
+     * @param params - The parameters for the extensions registration.
+     */
+    registerExtensions: (params: ExtensionsRegistrarRegisterExtensionsParams) => void;
+}
+/**
+ * Parameters for registering extensions.
+ */
+export interface ExtensionsRegistrarRegisterExtensionsParams {
+    /**
+     * The extensions to register.
+     */
+    readonly extensions: string[];
+    /**
+     * The view type to register the extensions for.
+     */
+    readonly viewType: string;
+}
+type PluginExtensionsRegistrarRegisterExtensionsParams = ExtensionsRegistrarRegisterExtensionsParams;
+/**
+ * Extensions registrar in an Obsidian plugin.
+ */
+export declare class PluginExtensionsRegistrar implements ExtensionsRegistrar {
+    protected readonly plugin: Plugin;
+    /**
+     * Creates a new instance of the {@link PluginExtensionsRegistrar} class.
+     *
+     * @param plugin - The Obsidian plugin instance.
+     */
+    constructor(plugin: Plugin);
+    /**
+     * Registers extensions.
+     *
+     * @param params - The parameters for the extensions registration.
+     */
+    registerExtensions(params: PluginExtensionsRegistrarRegisterExtensionsParams): void;
+}
+export {};

package/dist/lib/esm/extensions-registrar.mjs

@@ -0,0 +1,73 @@
+/*
+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 { Plugin } from "obsidian";
+class PluginExtensionsRegistrar {
+  /**
+   * Creates a new instance of the {@link PluginExtensionsRegistrar} class.
+   *
+   * @param plugin - The Obsidian plugin instance.
+   */
+  constructor(plugin) {
+    this.plugin = plugin;
+  }
+  plugin;
+  /**
+   * Registers extensions.
+   *
+   * @param params - The parameters for the extensions registration.
+   */
+  registerExtensions(params) {
+    this.plugin.registerExtensions(params.extensions, params.viewType);
+  }
+}
+export {
+  PluginExtensionsRegistrar
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2V4dGVuc2lvbnMtcmVnaXN0cmFyLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogRXh0ZW5zaW9ucyByZWdpc3RyYXJzLlxuICovXG5cbmltcG9ydCB7IFBsdWdpbiB9IGZyb20gJ29ic2lkaWFuJztcblxuLyoqXG4gKiBFeHRlbnNpb25zIHJlZ2lzdHJhci5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBFeHRlbnNpb25zUmVnaXN0cmFyIHtcbiAgLyoqXG4gICAqIFJlZ2lzdGVycyBleHRlbnNpb25zLlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBhcmFtZXRlcnMgZm9yIHRoZSBleHRlbnNpb25zIHJlZ2lzdHJhdGlvbi5cbiAgICovXG4gIHJlZ2lzdGVyRXh0ZW5zaW9uczogKHBhcmFtczogRXh0ZW5zaW9uc1JlZ2lzdHJhclJlZ2lzdGVyRXh0ZW5zaW9uc1BhcmFtcykgPT4gdm9pZDtcbn1cblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciByZWdpc3RlcmluZyBleHRlbnNpb25zLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEV4dGVuc2lvbnNSZWdpc3RyYXJSZWdpc3RlckV4dGVuc2lvbnNQYXJhbXMge1xuICAvKipcbiAgICogVGhlIGV4dGVuc2lvbnMgdG8gcmVnaXN0ZXIuXG4gICAqL1xuICByZWFkb25seSBleHRlbnNpb25zOiBzdHJpbmdbXTtcblxuICAvKipcbiAgICogVGhlIHZpZXcgdHlwZSB0byByZWdpc3RlciB0aGUgZXh0ZW5zaW9ucyBmb3IuXG4gICAqL1xuICByZWFkb25seSB2aWV3VHlwZTogc3RyaW5nO1xufVxuXG50eXBlIFBsdWdpbkV4dGVuc2lvbnNSZWdpc3RyYXJSZWdpc3RlckV4dGVuc2lvbnNQYXJhbXMgPSBFeHRlbnNpb25zUmVnaXN0cmFyUmVnaXN0ZXJFeHRlbnNpb25zUGFyYW1zO1xuXG4vKipcbiAqIEV4dGVuc2lvbnMgcmVnaXN0cmFyIGluIGFuIE9ic2lkaWFuIHBsdWdpbi5cbiAqL1xuZXhwb3J0IGNsYXNzIFBsdWdpbkV4dGVuc2lvbnNSZWdpc3RyYXIgaW1wbGVtZW50cyBFeHRlbnNpb25zUmVnaXN0cmFyIHtcbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgaW5zdGFuY2Ugb2YgdGhlIHtAbGluayBQbHVnaW5FeHRlbnNpb25zUmVnaXN0cmFyfSBjbGFzcy5cbiAgICpcbiAgICogQHBhcmFtIHBsdWdpbiAtIFRoZSBPYnNpZGlhbiBwbHVnaW4gaW5zdGFuY2UuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocHJvdGVjdGVkIHJlYWRvbmx5IHBsdWdpbjogUGx1Z2luKSB7fVxuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgZXh0ZW5zaW9ucy5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIGZvciB0aGUgZXh0ZW5zaW9ucyByZWdpc3RyYXRpb24uXG4gICAqL1xuICBwdWJsaWMgcmVnaXN0ZXJFeHRlbnNpb25zKHBhcmFtczogUGx1Z2luRXh0ZW5zaW9uc1JlZ2lzdHJhclJlZ2lzdGVyRXh0ZW5zaW9uc1BhcmFtcyk6IHZvaWQge1xuICAgIHRoaXMucGx1Z2luLnJlZ2lzdGVyRXh0ZW5zaW9ucyhwYXJhbXMuZXh0ZW5zaW9ucywgcGFyYW1zLnZpZXdUeXBlKTtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQU1BLFNBQVMsY0FBYztBQWtDaEIsTUFBTSwwQkFBeUQ7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFNN0QsWUFBK0IsUUFBZ0I7QUFBaEI7QUFBQSxFQUFpQjtBQUFBLEVBQWpCO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBTy9CLG1CQUFtQixRQUFpRTtBQUN6RixTQUFLLE9BQU8sbUJBQW1CLE9BQU8sWUFBWSxPQUFPLFFBQVE7QUFBQSxFQUNuRTtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/esm/file-change.d.mts

@@ -0,0 +1,156 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * Contains utility types and functions for handling file changes in Obsidian.
+ */
+import type { ValueProvider } from '@mnaoumov/typescript-lib/value-provider';
+import type { App, FrontmatterLinkCache, Reference, ReferenceCache } from 'obsidian';
+import type { PathOrFile } from './file-system.mjs';
+import type { FrontmatterLinkCacheWithOffsets } from './frontmatter-link-cache-with-offsets.mjs';
+import type { CanvasFileNodeReference, CanvasReference, CanvasTextNodeReference } from './reference.mjs';
+import type { ContentArguments, ProcessOptions } from './vault.mjs';
+/**
+ * Parameters for {@link applyContentChanges}.
+ */
+export interface ApplyContentChangesParams {
+    /**
+     * The abort signal to control the execution of the function.
+     */
+    readonly abortSignal: AbortSignal;
+    /**
+     * A provider that returns an array of content changes to apply.
+     */
+    readonly changesProvider: ValueProvider<FileChange[] | null, ContentArguments>;
+    /**
+     * The content to which the changes should be applied.
+     */
+    readonly content: string;
+    /**
+     * The path to which the changes should be applied.
+     */
+    readonly path: string;
+    /**
+     * Whether to retry the operation if the changes are invalid.
+     *
+     * @default `true`
+     */
+    readonly shouldRetryOnInvalidChanges?: boolean;
+}
+/**
+ * Options for {@link applyFileChanges}.
+ */
+export type ApplyFileChangesOptions = ProcessOptions;
+/**
+ * Parameters for {@link applyFileChanges}.
+ */
+export interface ApplyFileChangesParams extends ApplyFileChangesOptions {
+    /**
+     * The application instance where the file changes will be applied.
+     */
+    readonly app: App;
+    /**
+     * A provider that returns an array of file changes to apply.
+     */
+    readonly changesProvider: ValueProvider<FileChange[] | null, ContentArguments>;
+    /**
+     * The path or file to which the changes should be applied.
+     */
+    readonly pathOrFile: PathOrFile;
+    /**
+     * Whether to retry the operation if the changes are invalid.
+     *
+     * @default `true`
+     */
+    readonly shouldRetryOnInvalidChanges?: boolean;
+}
+/**
+ * A file change in the vault.
+ */
+export interface FileChange {
+    /**
+     * A new content to replace the old content.
+     */
+    newContent: string;
+    /**
+     * An old content that will be replaced.
+     */
+    oldContent: string;
+    /**
+     * A reference that caused the change.
+     */
+    reference: Reference;
+}
+type CanvasChange = FileChange & WithReference<CanvasReference>;
+type CanvasFileNodeChange = FileChange & WithReference<CanvasFileNodeReference>;
+type CanvasTextNodeChange = FileChange & WithReference<CanvasTextNodeReference>;
+type ContentChange = FileChange & WithReference<ReferenceCache>;
+type FrontmatterChange = FileChange & WithReference<FrontmatterLinkCache>;
+type FrontmatterChangeWithOffsets = FileChange & WithReference<FrontmatterLinkCacheWithOffsets>;
+interface WithReference<R extends Reference> {
+    reference: R;
+}
+/**
+ * Applies a series of content changes to the specified content.
+ *
+ * @param params - The parameters for applying the content changes.
+ * @returns A {@link Promise} that resolves to the updated content or to `null` if update didn't succeed.
+ */
+export declare function applyContentChanges(params: ApplyContentChangesParams): Promise<null | string>;
+/**
+ * Applies a series of file changes to the specified file or path within the application.
+ *
+ * @param params - The parameters for applying the file changes.
+ * @returns A {@link Promise} that resolves when the file changes have been successfully applied.
+ */
+export declare function applyFileChanges(params: ApplyFileChangesParams): Promise<void>;
+/**
+ * Checks if a file change is a canvas change.
+ *
+ * @param change - The file change to check.
+ * @returns Whether the file change is a canvas change.
+ */
+export declare function isCanvasChange(change: FileChange): change is CanvasChange;
+/**
+ * Checks if a file change is a canvas file node change.
+ *
+ * @param change - The file change to check.
+ * @returns Whether the file change is a canvas file node change.
+ */
+export declare function isCanvasFileNodeChange(change: FileChange): change is CanvasFileNodeChange;
+/**
+ * Checks if a file change is a canvas text node change.
+ *
+ * @param change - The file change to check.
+ * @returns Whether the file change is a canvas text node change.
+ */
+export declare function isCanvasTextNodeChange(change: FileChange): change is CanvasTextNodeChange;
+/**
+ * Checks if a file change is a content change.
+ *
+ * @param fileChange - The file change to check.
+ * @returns A boolean indicating whether the file change is a content change.
+ */
+export declare function isContentChange(fileChange: FileChange): fileChange is ContentChange;
+/**
+ * Checks if a file change is a frontmatter change.
+ *
+ * @param fileChange - The file change to check.
+ * @returns A boolean indicating whether the file change is a frontmatter change.
+ */
+export declare function isFrontmatterChange(fileChange: FileChange): fileChange is FrontmatterChange;
+/**
+ * Checks if a file change is a frontmatter change with offsets.
+ *
+ * @param fileChange - The file change to check.
+ * @returns A boolean indicating whether the file change is a frontmatter change with offsets.
+ */
+export declare function isFrontmatterChangeWithOffsets(fileChange: FileChange): fileChange is FrontmatterChangeWithOffsets;
+/**
+ * Converts a frontmatter change to a frontmatter change with offsets.
+ *
+ * @param fileChange - The file change to convert.
+ * @returns The converted file change.
+ */
+export declare function toFrontmatterChangeWithOffsets(fileChange: FrontmatterChange): FrontmatterChangeWithOffsets;
+export {};