@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/esm/callout.mjs

@@ -0,0 +1,132 @@
+/*
+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 { normalizeOptionalProperties } from "@mnaoumov/typescript-lib/object-utils";
+import {
+  assertNever,
+  ensureNonNullable
+} from "@mnaoumov/typescript-lib/type-guards";
+import { resolveValue } from "@mnaoumov/typescript-lib/value-provider";
+import { getRenderedContainer } from "./dataview.mjs";
+import { t } from "./i18n/i18n.mjs";
+import { addToQueue } from "./queue.mjs";
+var CalloutMode = /* @__PURE__ */ ((CalloutMode2) => {
+  CalloutMode2[CalloutMode2["Default"] = 0] = "Default";
+  CalloutMode2[CalloutMode2["FoldableCollapsed"] = 1] = "FoldableCollapsed";
+  CalloutMode2[CalloutMode2["FoldableExpanded"] = 2] = "FoldableExpanded";
+  return CalloutMode2;
+})(CalloutMode || {});
+function renderCallout(params) {
+  const {
+    contentProvider = "",
+    dv,
+    header = "",
+    mode = 1 /* FoldableCollapsed */,
+    type = "NOTE"
+  } = params;
+  const modifier = getModifier(mode);
+  const callout = dv.paragraph(`> [!${type}]${modifier} ${header}
+>
+> <div class="content"></div>`);
+  const contentDiv = ensureNonNullable(callout.querySelector(".content"), "Content div not found");
+  dv.paragraph("Loading... \u23F3", { container: contentDiv });
+  const observer = new IntersectionObserver((entries) => {
+    for (const entry of entries) {
+      if (!entry.isIntersecting) {
+        continue;
+      }
+      observer.unobserve(entry.target);
+      addToQueue(normalizeOptionalProperties({
+        abortSignal: params.abortSignal,
+        operationFunction: loadContent,
+        operationName: t(($) => $.obsidianDevUtils.callout.loadContent)
+      }));
+    }
+  });
+  observer.observe(contentDiv);
+  async function loadContent(abortSignal) {
+    abortSignal.throwIfAborted();
+    let content;
+    const paragraph = await getRenderedContainer(dv, async () => {
+      content = await resolveValue(contentProvider, abortSignal);
+      abortSignal.throwIfAborted();
+    });
+    abortSignal.throwIfAborted();
+    content ??= paragraph;
+    contentDiv.empty();
+    dv.paragraph(content, { container: contentDiv });
+  }
+}
+function wrapForCallout(content) {
+  const lines = content.split("\n");
+  const prefixedLines = lines.map((line) => `> ${line}`);
+  return prefixedLines.join("\n");
+}
+function getModifier(mode) {
+  switch (mode) {
+    case 0 /* Default */: {
+      return "";
+    }
+    case 1 /* FoldableCollapsed */: {
+      return "-";
+    }
+    case 2 /* FoldableExpanded */: {
+      return "+";
+    }
+    default: {
+      assertNever(mode);
+    }
+  }
+}
+export {
+  CalloutMode,
+  renderCallout,
+  wrapForCallout
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2NhbGxvdXQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBUaGlzIG1vZHVsZSBwcm92aWRlcyB1dGlsaXR5IGZ1bmN0aW9ucyBmb3IgcmVuZGVyaW5nIGNhbGxvdXRzIGluIERhdGF2aWV3LlxuICovXG5cbmltcG9ydCB0eXBlIHsgTWF5YmVSZXR1cm4gfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvdHlwZSc7XG5pbXBvcnQgdHlwZSB7IFZhbHVlUHJvdmlkZXIgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvdmFsdWUtcHJvdmlkZXInO1xuXG5pbXBvcnQgeyBub3JtYWxpemVPcHRpb25hbFByb3BlcnRpZXMgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvb2JqZWN0LXV0aWxzJztcbmltcG9ydCB7XG4gIGFzc2VydE5ldmVyLFxuICBlbnN1cmVOb25OdWxsYWJsZVxufSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvdHlwZS1ndWFyZHMnO1xuaW1wb3J0IHsgcmVzb2x2ZVZhbHVlIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL3ZhbHVlLXByb3ZpZGVyJztcblxuaW1wb3J0IHR5cGUgeyBEYXRhdmlld0lubGluZUFwaSB9IGZyb20gJy4vZGF0YXZpZXcudHMnO1xuaW1wb3J0IHR5cGUgeyBBZGRUb1F1ZXVlUGFyYW1zIH0gZnJvbSAnLi9xdWV1ZS50cyc7XG5cbmltcG9ydCB7IGdldFJlbmRlcmVkQ29udGFpbmVyIH0gZnJvbSAnLi9kYXRhdmlldy50cyc7XG5pbXBvcnQgeyB0IH0gZnJvbSAnLi9pMThuL2kxOG4udHMnO1xuaW1wb3J0IHsgYWRkVG9RdWV1ZSB9IGZyb20gJy4vcXVldWUudHMnO1xuXG4vKipcbiAqIEVudW0gcmVwcmVzZW50aW5nIHRoZSBtb2RlIG9mIGEgY2FsbG91dC5cbiAqL1xuZXhwb3J0IGVudW0gQ2FsbG91dE1vZGUge1xuICAvKipcbiAgRGVmYXVsdCBtb2RlLCB3aXRoIG5vIHNwZWNpYWwgYmVoYXZpb3IuXG4gICAqL1xuICBEZWZhdWx0LFxuXG4gIC8qKlxuICBGb2xkYWJsZSBtb2RlIHdpdGggdGhlIGNhbGxvdXQgY29sbGFwc2VkLlxuICAgKi9cbiAgRm9sZGFibGVDb2xsYXBzZWQsXG5cbiAgLyoqXG4gIEZvbGRhYmxlIG1vZGUgd2l0aCB0aGUgY2FsbG91dCBleHBhbmRlZC5cbiAgICovXG4gIEZvbGRhYmxlRXhwYW5kZWRcbn1cblxuLyoqXG4gKiBPcHRpb25zIGZvciB7QGxpbmsgcmVuZGVyQ2FsbG91dH0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUmVuZGVyQ2FsbG91dFBhcmFtcyB7XG4gIC8qKlxuICAgKiBBbiBhYm9ydCBzaWduYWwuXG4gICAqL1xuICByZWFkb25seSBhYm9ydFNpZ25hbD86IEFib3J0U2lnbmFsO1xuXG4gIC8qKlxuICAgKiBBbiBvcHRpb25hbCBwcm92aWRlciBmb3IgdGhlIGNvbnRlbnQsIHdoaWNoIGNhbiBiZSBlaXRoZXIgYSBzdHJpbmcgb3IgYSBOb2RlLlxuICAgKlxuICAgKiBAZGVmYXVsdCBgJydgXG4gICAqL1xuICByZWFkb25seSBjb250ZW50UHJvdmlkZXI/OiBWYWx1ZVByb3ZpZGVyPE1heWJlUmV0dXJuPE5vZGUgfCBzdHJpbmc+PjtcblxuICAvKipcbiAgICogQSB7QGxpbmsgRGF0YXZpZXdJbmxpbmVBcGl9IGluc3RhbmNlLlxuICAgKi9cbiAgcmVhZG9ubHkgZHY6IERhdGF2aWV3SW5saW5lQXBpO1xuXG4gIC8qKlxuICAgKiBBIGhlYWRlciB0ZXh0IG9mIHRoZSBjYWxsb3V0LCBkZWZhdWx0IGlzIGFuIGVtcHR5IHN0cmluZy5cbiAgICpcbiAgICogQGRlZmF1bHQgYCcnYFxuICAgKi9cbiAgcmVhZG9ubHkgaGVhZGVyPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBBIGNhbGxvdXQgbW9kZSwgZGVmYXVsdCBpcyBgQ2FsbG91dE1vZGUuRm9sZGFibGVDb2xsYXBzZWRgLlxuICAgKlxuICAgKiBAZGVmYXVsdCB7QGxpbmsgQ2FsbG91dE1vZGUuRm9sZGFibGVDb2xsYXBzZWR9XG4gICAqL1xuICByZWFkb25seSBtb2RlPzogQ2FsbG91dE1vZGU7XG5cbiAgLyoqXG4gICAqIEEgdHlwZSBvZiB0aGUgY2FsbG91dCwgZGVmYXVsdCBpcyBgXCJOT1RFXCJgLlxuICAgKlxuICAgKiBAZGVmYXVsdCBgJ05PVEUnYFxuICAgKi9cbiAgcmVhZG9ubHkgdHlwZT86IHN0cmluZztcbn1cblxuLyoqXG4gKiBSZW5kZXJzIGEgY2FsbG91dCBibG9jayBpbiBEYXRhdmlldy5cbiAqXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBhcmFtZXRlcnMgZm9yIHJlbmRlcmluZyB0aGUgY2FsbG91dC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlbmRlckNhbGxvdXQocGFyYW1zOiBSZW5kZXJDYWxsb3V0UGFyYW1zKTogdm9pZCB7XG4gIGNvbnN0IHtcbiAgICBjb250ZW50UHJvdmlkZXIgPSAnJyxcbiAgICBkdixcbiAgICBoZWFkZXIgPSAnJyxcbiAgICBtb2RlID0gQ2FsbG91dE1vZGUuRm9sZGFibGVDb2xsYXBzZWQsXG4gICAgdHlwZSA9ICdOT1RFJ1xuICB9ID0gcGFyYW1zO1xuICBjb25zdCBtb2RpZmllciA9IGdldE1vZGlmaWVyKG1vZGUpO1xuICBjb25zdCBjYWxsb3V0ID0gZHYucGFyYWdyYXBoKGA+IFshJHt0eXBlfV0ke21vZGlmaWVyfSAke2hlYWRlcn1cXG4+XFxuPiA8ZGl2IGNsYXNzPVwiY29udGVudFwiPjwvZGl2PmApO1xuICBjb25zdCBjb250ZW50RGl2ID0gZW5zdXJlTm9uTnVsbGFibGUoY2FsbG91dC5xdWVyeVNlbGVjdG9yPEhUTUxEaXZFbGVtZW50PignLmNvbnRlbnQnKSwgJ0NvbnRlbnQgZGl2IG5vdCBmb3VuZCcpO1xuICBkdi5wYXJhZ3JhcGgoJ0xvYWRpbmcuLi4gXHUyM0YzJywgeyBjb250YWluZXI6IGNvbnRlbnREaXYgfSk7XG5cbiAgY29uc3Qgb2JzZXJ2ZXIgPSBuZXcgSW50ZXJzZWN0aW9uT2JzZXJ2ZXIoKGVudHJpZXM6IEludGVyc2VjdGlvbk9ic2VydmVyRW50cnlbXSkgPT4ge1xuICAgIGZvciAoY29uc3QgZW50cnkgb2YgZW50cmllcykge1xuICAgICAgaWYgKCFlbnRyeS5pc0ludGVyc2VjdGluZykge1xuICAgICAgICBjb250aW51ZTtcbiAgICAgIH1cblxuICAgICAgb2JzZXJ2ZXIudW5vYnNlcnZlKGVudHJ5LnRhcmdldCk7XG4gICAgICBhZGRUb1F1ZXVlKG5vcm1hbGl6ZU9wdGlvbmFsUHJvcGVydGllczxBZGRUb1F1ZXVlUGFyYW1zPih7XG4gICAgICAgIGFib3J0U2lnbmFsOiBwYXJhbXMuYWJvcnRTaWduYWwsXG4gICAgICAgIG9wZXJhdGlvbkZ1bmN0aW9uOiBsb2FkQ29udGVudCxcbiAgICAgICAgb3BlcmF0aW9uTmFtZTogdCgoJCkgPT4gJC5vYnNpZGlhbkRldlV0aWxzLmNhbGxvdXQubG9hZENvbnRlbnQpXG4gICAgICB9KSk7XG4gICAgfVxuICB9KTtcbiAgb2JzZXJ2ZXIub2JzZXJ2ZShjb250ZW50RGl2KTtcblxuICBhc3luYyBmdW5jdGlvbiBsb2FkQ29udGVudChhYm9ydFNpZ25hbDogQWJvcnRTaWduYWwpOiBQcm9taXNlPHZvaWQ+IHtcbiAgICBhYm9ydFNpZ25hbC50aHJvd0lmQWJvcnRlZCgpO1xuICAgIGxldCBjb250ZW50OiBNYXliZVJldHVybjxOb2RlIHwgc3RyaW5nIHwgdW5kZWZpbmVkPjtcblxuICAgIGNvbnN0IHBhcmFncmFwaCA9IGF3YWl0IGdldFJlbmRlcmVkQ29udGFpbmVyKGR2LCBhc3luYyAoKSA9PiB7XG4gICAgICBjb250ZW50ID0gYXdhaXQgcmVzb2x2ZVZhbHVlKGNvbnRlbnRQcm92aWRlciwgYWJvcnRTaWduYWwpO1xuICAgICAgYWJvcnRTaWduYWwudGhyb3dJZkFib3J0ZWQoKTtcbiAgICB9KTtcbiAgICBhYm9ydFNpZ25hbC50aHJvd0lmQWJvcnRlZCgpO1xuXG4gICAgY29udGVudCA/Pz0gcGFyYWdyYXBoO1xuXG4gICAgY29udGVudERpdi5lbXB0eSgpO1xuICAgIGR2LnBhcmFncmFwaChjb250ZW50LCB7IGNvbnRhaW5lcjogY29udGVudERpdiB9KTtcbiAgfVxufVxuXG4vKipcbiAqIFdyYXBzIHRoZSBwcm92aWRlZCBjb250ZW50IGluIGJsb2NrcXVvdGUgc3ludGF4IGZvciBhIGNhbGxvdXQuXG4gKlxuICogQHBhcmFtIGNvbnRlbnQgLSBUaGUgY29udGVudCB0byB3cmFwLlxuICogQHJldHVybnMgVGhlIGNvbnRlbnQgd3JhcHBlZCBpbiBibG9ja3F1b3RlIHN5bnRheC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHdyYXBGb3JDYWxsb3V0KGNvbnRlbnQ6IHN0cmluZyk6IHN0cmluZyB7XG4gIGNvbnN0IGxpbmVzID0gY29udGVudC5zcGxpdCgnXFxuJyk7XG4gIGNvbnN0IHByZWZpeGVkTGluZXMgPSBsaW5lcy5tYXAoKGxpbmUpID0+IGA+ICR7bGluZX1gKTtcbiAgcmV0dXJuIHByZWZpeGVkTGluZXMuam9pbignXFxuJyk7XG59XG5cbi8qKlxuICogUmV0dXJucyB0aGUgbW9kaWZpZXIgc3RyaW5nIGJhc2VkIG9uIHRoZSBjYWxsb3V0IG1vZGUuXG4gKlxuICogQHBhcmFtIG1vZGUgLSBUaGUgbW9kZSBvZiB0aGUgY2FsbG91dC5cbiAqIEByZXR1cm5zIFRoZSBjb3JyZXNwb25kaW5nIG1vZGlmaWVyIHN0cmluZy5cbiAqL1xuZnVuY3Rpb24gZ2V0TW9kaWZpZXIobW9kZTogQ2FsbG91dE1vZGUpOiBzdHJpbmcge1xuICBzd2l0Y2ggKG1vZGUpIHtcbiAgICBjYXNlIENhbGxvdXRNb2RlLkRlZmF1bHQ6IHtcbiAgICAgIHJldHVybiAnJztcbiAgICB9XG4gICAgY2FzZSBDYWxsb3V0TW9kZS5Gb2xkYWJsZUNvbGxhcHNlZDoge1xuICAgICAgcmV0dXJuICctJztcbiAgICB9XG4gICAgY2FzZSBDYWxsb3V0TW9kZS5Gb2xkYWJsZUV4cGFuZGVkOiB7XG4gICAgICByZXR1cm4gJysnO1xuICAgIH1cbiAgICBkZWZhdWx0OiB7XG4gICAgICBhc3NlcnROZXZlcihtb2RlKTtcbiAgICB9XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFTQSxTQUFTLG1DQUFtQztBQUM1QztBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsT0FDSztBQUNQLFNBQVMsb0JBQW9CO0FBSzdCLFNBQVMsNEJBQTRCO0FBQ3JDLFNBQVMsU0FBUztBQUNsQixTQUFTLGtCQUFrQjtBQUtwQixJQUFLLGNBQUwsa0JBQUtBLGlCQUFMO0FBSUwsRUFBQUEsMEJBQUE7QUFLQSxFQUFBQSwwQkFBQTtBQUtBLEVBQUFBLDBCQUFBO0FBZFUsU0FBQUE7QUFBQSxHQUFBO0FBaUVMLFNBQVMsY0FBYyxRQUFtQztBQUMvRCxRQUFNO0FBQUEsSUFDSixrQkFBa0I7QUFBQSxJQUNsQjtBQUFBLElBQ0EsU0FBUztBQUFBLElBQ1QsT0FBTztBQUFBLElBQ1AsT0FBTztBQUFBLEVBQ1QsSUFBSTtBQUNKLFFBQU0sV0FBVyxZQUFZLElBQUk7QUFDakMsUUFBTSxVQUFVLEdBQUcsVUFBVSxPQUFPLElBQUksSUFBSSxRQUFRLElBQUksTUFBTTtBQUFBO0FBQUEsOEJBQW9DO0FBQ2xHLFFBQU0sYUFBYSxrQkFBa0IsUUFBUSxjQUE4QixVQUFVLEdBQUcsdUJBQXVCO0FBQy9HLEtBQUcsVUFBVSxxQkFBZ0IsRUFBRSxXQUFXLFdBQVcsQ0FBQztBQUV0RCxRQUFNLFdBQVcsSUFBSSxxQkFBcUIsQ0FBQyxZQUF5QztBQUNsRixlQUFXLFNBQVMsU0FBUztBQUMzQixVQUFJLENBQUMsTUFBTSxnQkFBZ0I7QUFDekI7QUFBQSxNQUNGO0FBRUEsZUFBUyxVQUFVLE1BQU0sTUFBTTtBQUMvQixpQkFBVyw0QkFBOEM7QUFBQSxRQUN2RCxhQUFhLE9BQU87QUFBQSxRQUNwQixtQkFBbUI7QUFBQSxRQUNuQixlQUFlLEVBQUUsQ0FBQyxNQUFNLEVBQUUsaUJBQWlCLFFBQVEsV0FBVztBQUFBLE1BQ2hFLENBQUMsQ0FBQztBQUFBLElBQ0o7QUFBQSxFQUNGLENBQUM7QUFDRCxXQUFTLFFBQVEsVUFBVTtBQUUzQixpQkFBZSxZQUFZLGFBQXlDO0FBQ2xFLGdCQUFZLGVBQWU7QUFDM0IsUUFBSTtBQUVKLFVBQU0sWUFBWSxNQUFNLHFCQUFxQixJQUFJLFlBQVk7QUFDM0QsZ0JBQVUsTUFBTSxhQUFhLGlCQUFpQixXQUFXO0FBQ3pELGtCQUFZLGVBQWU7QUFBQSxJQUM3QixDQUFDO0FBQ0QsZ0JBQVksZUFBZTtBQUUzQixnQkFBWTtBQUVaLGVBQVcsTUFBTTtBQUNqQixPQUFHLFVBQVUsU0FBUyxFQUFFLFdBQVcsV0FBVyxDQUFDO0FBQUEsRUFDakQ7QUFDRjtBQVFPLFNBQVMsZUFBZSxTQUF5QjtBQUN0RCxRQUFNLFFBQVEsUUFBUSxNQUFNLElBQUk7QUFDaEMsUUFBTSxnQkFBZ0IsTUFBTSxJQUFJLENBQUMsU0FBUyxLQUFLLElBQUksRUFBRTtBQUNyRCxTQUFPLGNBQWMsS0FBSyxJQUFJO0FBQ2hDO0FBUUEsU0FBUyxZQUFZLE1BQTJCO0FBQzlDLFVBQVEsTUFBTTtBQUFBLElBQ1osS0FBSyxpQkFBcUI7QUFDeEIsYUFBTztBQUFBLElBQ1Q7QUFBQSxJQUNBLEtBQUssMkJBQStCO0FBQ2xDLGFBQU87QUFBQSxJQUNUO0FBQUEsSUFDQSxLQUFLLDBCQUE4QjtBQUNqQyxhQUFPO0FBQUEsSUFDVDtBQUFBLElBQ0EsU0FBUztBQUNQLGtCQUFZLElBQUk7QUFBQSxJQUNsQjtBQUFBLEVBQ0Y7QUFDRjsiLAogICJuYW1lcyI6IFsiQ2FsbG91dE1vZGUiXQp9Cg==

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

@@ -0,0 +1,28 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * Contains a utility function for extracting references from a canvas (`.canvas`) file.
+ */
+import type { App } from 'obsidian';
+import type { PathOrFile } from './file-system.mjs';
+import type { CanvasReference } from './reference.mjs';
+/**
+ * Extracts the outgoing references of a canvas (`.canvas`) file.
+ *
+ * Obsidian does not index canvas links into the per-file metadata cache, so a canvas file's
+ * {@link https://docs.obsidian.md/Reference/TypeScript+API/CachedMetadata | CachedMetadata} is empty and the
+ * usual cache-based readers return nothing for it. This helper reads the canvas JSON directly and returns
+ * both its file-node links and its text-node embeds as {@link CanvasReference}s.
+ *
+ * The returned references carry the `nodeIndex`/`type` (and, for text nodes, the `originalReference`) that
+ * the canvas-aware write path needs, so a consumer can move a canvas-referenced attachment and rewrite the
+ * canvas by composing `referenceToFileChange` (from `./reference.ts`) with `applyFileChanges` (from
+ * `./file-change.ts`).
+ *
+ * @param app - The Obsidian app instance.
+ * @param pathOrFile - The canvas file (or its path) to extract references from.
+ * @returns A {@link Promise} that resolves to the canvas references, or an empty array when the file is
+ * missing or its content is not valid canvas JSON.
+ */
+export declare function getCanvasReferences(app: App, pathOrFile: PathOrFile): Promise<CanvasReference[]>;

package/dist/lib/esm/canvas.mjs

@@ -0,0 +1,129 @@
+/*
+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 { ensureNonNullable } from "@mnaoumov/typescript-lib/type-guards";
+import {
+  getLinks,
+  parseMetadata
+} from "./metadata-cache.mjs";
+import { readSafe } from "./vault.mjs";
+async function getCanvasReferences(app, pathOrFile) {
+  const content = await readSafe(app, pathOrFile);
+  if (content === null) {
+    return [];
+  }
+  let partialCanvasData;
+  try {
+    partialCanvasData = JSON.parse(content);
+  } catch {
+    return [];
+  }
+  const canvasData = partialCanvasData?.nodes ? partialCanvasData : {
+    edges: [],
+    nodes: []
+  };
+  const references = [];
+  const hasFrontmatterMarkdownLinksPlugin = !!app.plugins.getPlugin("frontmatter-markdown-links");
+  for (const [nodeIndex, node] of canvasData.nodes.entries()) {
+    switch (node.type) {
+      case "file": {
+        const canvasFileNodeReference = {
+          isCanvas: true,
+          key: `nodes.${String(nodeIndex)}.file`,
+          link: node.file,
+          nodeIndex,
+          original: node.file,
+          type: "file"
+        };
+        references.push(canvasFileNodeReference);
+        break;
+      }
+      case "text": {
+        const metadata = await parseMetadata(app, node.text, { shouldParseMultiValueFrontmatterLinks: hasFrontmatterMarkdownLinksPlugin });
+        if (hasFrontmatterMarkdownLinksPlugin) {
+          contributeMultiValueFrontmatterLinks(metadata);
+        }
+        const links = getLinks({ cache: metadata });
+        for (const [linkIndex, link] of links.entries()) {
+          const canvasTextNodeReference = {
+            isCanvas: true,
+            key: `nodes.${String(nodeIndex)}.text.${String(linkIndex)}`,
+            link: link.link,
+            nodeIndex,
+            original: link.original,
+            originalReference: link,
+            type: "text"
+          };
+          references.push(canvasTextNodeReference);
+        }
+        break;
+      }
+      default: {
+        break;
+      }
+    }
+  }
+  return references;
+}
+function contributeMultiValueFrontmatterLinks(metadata) {
+  const contributedLinks = ensureNonNullable(metadata.multiValueFrontmatterLinks);
+  if (contributedLinks.length === 0) {
+    return;
+  }
+  const contributedKeys = new Set(contributedLinks.map((link) => link.key));
+  const nativeLinks = metadata.frontmatterLinks ?? [];
+  metadata.frontmatterLinks = [
+    ...nativeLinks.filter((link) => !contributedKeys.has(link.key)),
+    ...contributedLinks
+  ];
+}
+export {
+  getCanvasReferences
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2NhbnZhcy50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbnRhaW5zIGEgdXRpbGl0eSBmdW5jdGlvbiBmb3IgZXh0cmFjdGluZyByZWZlcmVuY2VzIGZyb20gYSBjYW52YXMgKGAuY2FudmFzYCkgZmlsZS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IEFwcCB9IGZyb20gJ29ic2lkaWFuJztcbmltcG9ydCB0eXBlIHsgQ2FudmFzRGF0YSB9IGZyb20gJ29ic2lkaWFuL2NhbnZhcy5kLnRzJztcblxuaW1wb3J0IHsgZW5zdXJlTm9uTnVsbGFibGUgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvdHlwZS1ndWFyZHMnO1xuXG5pbXBvcnQgdHlwZSB7IFBhdGhPckZpbGUgfSBmcm9tICcuL2ZpbGUtc3lzdGVtLnRzJztcbmltcG9ydCB0eXBlIHsgQ2FjaGVkTWV0YWRhdGFFeCB9IGZyb20gJy4vbWV0YWRhdGEtY2FjaGUudHMnO1xuaW1wb3J0IHR5cGUge1xuICBDYW52YXNGaWxlTm9kZVJlZmVyZW5jZSxcbiAgQ2FudmFzUmVmZXJlbmNlLFxuICBDYW52YXNUZXh0Tm9kZVJlZmVyZW5jZVxufSBmcm9tICcuL3JlZmVyZW5jZS50cyc7XG5cbmltcG9ydCB7XG4gIGdldExpbmtzLFxuICBwYXJzZU1ldGFkYXRhXG59IGZyb20gJy4vbWV0YWRhdGEtY2FjaGUudHMnO1xuaW1wb3J0IHsgcmVhZFNhZmUgfSBmcm9tICcuL3ZhdWx0LnRzJztcblxuLyoqXG4gKiBFeHRyYWN0cyB0aGUgb3V0Z29pbmcgcmVmZXJlbmNlcyBvZiBhIGNhbnZhcyAoYC5jYW52YXNgKSBmaWxlLlxuICpcbiAqIE9ic2lkaWFuIGRvZXMgbm90IGluZGV4IGNhbnZhcyBsaW5rcyBpbnRvIHRoZSBwZXItZmlsZSBtZXRhZGF0YSBjYWNoZSwgc28gYSBjYW52YXMgZmlsZSdzXG4gKiB7QGxpbmsgaHR0cHM6Ly9kb2NzLm9ic2lkaWFuLm1kL1JlZmVyZW5jZS9UeXBlU2NyaXB0K0FQSS9DYWNoZWRNZXRhZGF0YSB8IENhY2hlZE1ldGFkYXRhfSBpcyBlbXB0eSBhbmQgdGhlXG4gKiB1c3VhbCBjYWNoZS1iYXNlZCByZWFkZXJzIHJldHVybiBub3RoaW5nIGZvciBpdC4gVGhpcyBoZWxwZXIgcmVhZHMgdGhlIGNhbnZhcyBKU09OIGRpcmVjdGx5IGFuZCByZXR1cm5zXG4gKiBib3RoIGl0cyBmaWxlLW5vZGUgbGlua3MgYW5kIGl0cyB0ZXh0LW5vZGUgZW1iZWRzIGFzIHtAbGluayBDYW52YXNSZWZlcmVuY2V9cy5cbiAqXG4gKiBUaGUgcmV0dXJuZWQgcmVmZXJlbmNlcyBjYXJyeSB0aGUgYG5vZGVJbmRleGAvYHR5cGVgIChhbmQsIGZvciB0ZXh0IG5vZGVzLCB0aGUgYG9yaWdpbmFsUmVmZXJlbmNlYCkgdGhhdFxuICogdGhlIGNhbnZhcy1hd2FyZSB3cml0ZSBwYXRoIG5lZWRzLCBzbyBhIGNvbnN1bWVyIGNhbiBtb3ZlIGEgY2FudmFzLXJlZmVyZW5jZWQgYXR0YWNobWVudCBhbmQgcmV3cml0ZSB0aGVcbiAqIGNhbnZhcyBieSBjb21wb3NpbmcgYHJlZmVyZW5jZVRvRmlsZUNoYW5nZWAgKGZyb20gYC4vcmVmZXJlbmNlLnRzYCkgd2l0aCBgYXBwbHlGaWxlQ2hhbmdlc2AgKGZyb21cbiAqIGAuL2ZpbGUtY2hhbmdlLnRzYCkuXG4gKlxuICogQHBhcmFtIGFwcCAtIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2UuXG4gKiBAcGFyYW0gcGF0aE9yRmlsZSAtIFRoZSBjYW52YXMgZmlsZSAob3IgaXRzIHBhdGgpIHRvIGV4dHJhY3QgcmVmZXJlbmNlcyBmcm9tLlxuICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyB0byB0aGUgY2FudmFzIHJlZmVyZW5jZXMsIG9yIGFuIGVtcHR5IGFycmF5IHdoZW4gdGhlIGZpbGUgaXNcbiAqIG1pc3Npbmcgb3IgaXRzIGNvbnRlbnQgaXMgbm90IHZhbGlkIGNhbnZhcyBKU09OLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gZ2V0Q2FudmFzUmVmZXJlbmNlcyhhcHA6IEFwcCwgcGF0aE9yRmlsZTogUGF0aE9yRmlsZSk6IFByb21pc2U8Q2FudmFzUmVmZXJlbmNlW10+IHtcbiAgY29uc3QgY29udGVudCA9IGF3YWl0IHJlYWRTYWZlKGFwcCwgcGF0aE9yRmlsZSk7XG4gIGlmIChjb250ZW50ID09PSBudWxsKSB7XG4gICAgcmV0dXJuIFtdO1xuICB9XG5cbiAgbGV0IHBhcnRpYWxDYW52YXNEYXRhOiBudWxsIHwgUGFydGlhbDxDYW52YXNEYXRhPjtcbiAgdHJ5IHtcbiAgICBwYXJ0aWFsQ2FudmFzRGF0YSA9IEpTT04ucGFyc2UoY29udGVudCkgYXMgbnVsbCB8IFBhcnRpYWw8Q2FudmFzRGF0YT47XG4gIH0gY2F0Y2gge1xuICAgIHJldHVybiBbXTtcbiAgfVxuXG4gIGNvbnN0IGNhbnZhc0RhdGEgPSBwYXJ0aWFsQ2FudmFzRGF0YT8ubm9kZXNcbiAgICA/IHBhcnRpYWxDYW52YXNEYXRhIGFzIENhbnZhc0RhdGFcbiAgICA6IHtcbiAgICAgIGVkZ2VzOiBbXSxcbiAgICAgIG5vZGVzOiBbXVxuICAgIH07XG5cbiAgY29uc3QgcmVmZXJlbmNlczogQ2FudmFzUmVmZXJlbmNlW10gPSBbXTtcbiAgY29uc3QgaGFzRnJvbnRtYXR0ZXJNYXJrZG93bkxpbmtzUGx1Z2luID0gISFhcHAucGx1Z2lucy5nZXRQbHVnaW4oJ2Zyb250bWF0dGVyLW1hcmtkb3duLWxpbmtzJyk7XG5cbiAgZm9yIChjb25zdCBbbm9kZUluZGV4LCBub2RlXSBvZiBjYW52YXNEYXRhLm5vZGVzLmVudHJpZXMoKSkge1xuICAgIHN3aXRjaCAobm9kZS50eXBlKSB7XG4gICAgICBjYXNlICdmaWxlJzoge1xuICAgICAgICBjb25zdCBjYW52YXNGaWxlTm9kZVJlZmVyZW5jZTogQ2FudmFzRmlsZU5vZGVSZWZlcmVuY2UgPSB7XG4gICAgICAgICAgaXNDYW52YXM6IHRydWUsXG4gICAgICAgICAga2V5OiBgbm9kZXMuJHtTdHJpbmcobm9kZUluZGV4KX0uZmlsZWAsXG4gICAgICAgICAgbGluazogbm9kZS5maWxlLFxuICAgICAgICAgIG5vZGVJbmRleCxcbiAgICAgICAgICBvcmlnaW5hbDogbm9kZS5maWxlLFxuICAgICAgICAgIHR5cGU6ICdmaWxlJ1xuICAgICAgICB9O1xuICAgICAgICByZWZlcmVuY2VzLnB1c2goY2FudmFzRmlsZU5vZGVSZWZlcmVuY2UpO1xuICAgICAgICBicmVhaztcbiAgICAgIH1cbiAgICAgIGNhc2UgJ3RleHQnOiB7XG4gICAgICAgIGNvbnN0IG1ldGFkYXRhID0gYXdhaXQgcGFyc2VNZXRhZGF0YShhcHAsIG5vZGUudGV4dCwgeyBzaG91bGRQYXJzZU11bHRpVmFsdWVGcm9udG1hdHRlckxpbmtzOiBoYXNGcm9udG1hdHRlck1hcmtkb3duTGlua3NQbHVnaW4gfSk7XG4gICAgICAgIGlmIChoYXNGcm9udG1hdHRlck1hcmtkb3duTGlua3NQbHVnaW4pIHtcbiAgICAgICAgICBjb250cmlidXRlTXVsdGlWYWx1ZUZyb250bWF0dGVyTGlua3MobWV0YWRhdGEpO1xuICAgICAgICB9XG4gICAgICAgIGNvbnN0IGxpbmtzID0gZ2V0TGlua3MoeyBjYWNoZTogbWV0YWRhdGEgfSk7XG4gICAgICAgIGZvciAoY29uc3QgW2xpbmtJbmRleCwgbGlua10gb2YgbGlua3MuZW50cmllcygpKSB7XG4gICAgICAgICAgY29uc3QgY2FudmFzVGV4dE5vZGVSZWZlcmVuY2U6IENhbnZhc1RleHROb2RlUmVmZXJlbmNlID0ge1xuICAgICAgICAgICAgaXNDYW52YXM6IHRydWUsXG4gICAgICAgICAgICBrZXk6IGBub2Rlcy4ke1N0cmluZyhub2RlSW5kZXgpfS50ZXh0LiR7U3RyaW5nKGxpbmtJbmRleCl9YCxcbiAgICAgICAgICAgIGxpbms6IGxpbmsubGluayxcbiAgICAgICAgICAgIG5vZGVJbmRleCxcbiAgICAgICAgICAgIG9yaWdpbmFsOiBsaW5rLm9yaWdpbmFsLFxuICAgICAgICAgICAgb3JpZ2luYWxSZWZlcmVuY2U6IGxpbmssXG4gICAgICAgICAgICB0eXBlOiAndGV4dCdcbiAgICAgICAgICB9O1xuICAgICAgICAgIHJlZmVyZW5jZXMucHVzaChjYW52YXNUZXh0Tm9kZVJlZmVyZW5jZSk7XG4gICAgICAgIH1cbiAgICAgICAgYnJlYWs7XG4gICAgICB9XG4gICAgICBkZWZhdWx0OiB7XG4gICAgICAgIGJyZWFrO1xuICAgICAgfVxuICAgIH1cbiAgfVxuXG4gIHJldHVybiByZWZlcmVuY2VzO1xufVxuXG4vKipcbiAqIE1ha2VzIHRoZSBvbmUgY2hhbmdlIHRvIGEgY2FudmFzIHRleHQgbm9kZSdzIG1ldGFkYXRhIHRoYXQgdGhlIEZyb250bWF0dGVyIE1hcmtkb3duIExpbmtzIHBsdWdpbiBtYWtlcyB0byBhXG4gKiBub3RlJ3MgY2FjaGUsIHNvIGEgdGV4dCBub2RlIHJlYWRzIGl0cyBsaW5rcyBhcyBhIG5vdGUgd2l0aCB0aGUgc2FtZSB0ZXh0IHdvdWxkLlxuICpcbiAqIE9ic2lkaWFuIGl0c2VsZiByZWFkcyBhIHByb3BlcnR5IHdob3NlIFdIT0xFIHZhbHVlIGlzIG9uZSBpbnRlcm5hbCBsaW5rLCBtYXJrZG93biBsaW5rcyBpbmNsdWRlZCwgc28gdGhlIHBsdWdpblxuICogY29udHJpYnV0ZXMgb25seSB0aGUgbGlua3MgZW1iZWRkZWQgaW4gYSBtdWx0aS1saW5rIHZhbHVlIChgW0FdKGEubWQpLCBbQl0oYi5tZClgKSBhbmQgcmVwbGFjZXMgd2hhdGV2ZXIgT2JzaWRpYW5cbiAqIHJlY29yZGVkIHVuZGVyIHRoZSBzYW1lIGtleS4gQSB0ZXh0IG5vZGUgaXMgcGFyc2VkIG91dHNpZGUgdGhlIG1ldGFkYXRhIGNhY2hlLCB3aGVyZSB0aGUgcGx1Z2luIG5ldmVyIHNlZXMgaXQsXG4gKiBzbyB0aGUgc2FtZSBzdGVwIGlzIHJlcGVhdGVkIGhlcmUuXG4gKlxuICogQHBhcmFtIG1ldGFkYXRhIC0gVGhlIHRleHQgbm9kZSdzIG1ldGFkYXRhLCBwYXJzZWQgd2l0aCBtdWx0aS12YWx1ZSBmcm9udG1hdHRlciBsaW5rcywgc29cbiAqIGBtdWx0aVZhbHVlRnJvbnRtYXR0ZXJMaW5rc2AgaXMgYWx3YXlzIHNldC5cbiAqL1xuZnVuY3Rpb24gY29udHJpYnV0ZU11bHRpVmFsdWVGcm9udG1hdHRlckxpbmtzKG1ldGFkYXRhOiBDYWNoZWRNZXRhZGF0YUV4KTogdm9pZCB7XG4gIGNvbnN0IGNvbnRyaWJ1dGVkTGlua3MgPSBlbnN1cmVOb25OdWxsYWJsZShtZXRhZGF0YS5tdWx0aVZhbHVlRnJvbnRtYXR0ZXJMaW5rcyk7XG4gIGlmIChjb250cmlidXRlZExpbmtzLmxlbmd0aCA9PT0gMCkge1xuICAgIHJldHVybjtcbiAgfVxuXG4gIGNvbnN0IGNvbnRyaWJ1dGVkS2V5cyA9IG5ldyBTZXQoY29udHJpYnV0ZWRMaW5rcy5tYXAoKGxpbmspID0+IGxpbmsua2V5KSk7XG4gIC8vIEEgY29udHJpYnV0ZWQgbGluayBtZWFucyB0aGUgbm90ZSBoYXMgYSBmcm9udG1hdHRlciByZWNvcmQsIGFuZCBPYnNpZGlhbiBhc3NpZ25zIGBmcm9udG1hdHRlckxpbmtzYCBiZXNpZGUgaXQuXG4gIC8qIHY4IGlnbm9yZSBuZXh0IC0tIE5ldmVyIG51bGxpc2ggd2hlbiBhIGxpbmsgd2FzIGNvbnRyaWJ1dGVkOyB0aGUgYD8/IFtdYCBpcyBkZWZlbnNpdmUuICovXG4gIGNvbnN0IG5hdGl2ZUxpbmtzID0gbWV0YWRhdGEuZnJvbnRtYXR0ZXJMaW5rcyA/PyBbXTtcbiAgbWV0YWRhdGEuZnJvbnRtYXR0ZXJMaW5rcyA9IFtcbiAgICAuLi5uYXRpdmVMaW5rcy5maWx0ZXIoKGxpbmspID0+ICFjb250cmlidXRlZEtleXMuaGFzKGxpbmsua2V5KSksXG4gICAgLi4uY29udHJpYnV0ZWRMaW5rc1xuICBdO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQVNBLFNB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

package/dist/lib/esm/case-insensitive-file-index.d.mts

@@ -0,0 +1,92 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * Provides an opt-in O(1) case-insensitive resolver for Obsidian vaults.
+ *
+ * Obsidian's native {@link https://docs.obsidian.md/Reference/TypeScript+API/Vault | Vault} resolves
+ * a string path case-insensitively (the Windows/macOS default) in O(1) on a hit but with an
+ * O(vault) scan on a miss. The miss case is the hot one during deletion cascades, where extension
+ * checks and cache lookups are performed on already-removed paths. This module backs the
+ * case-insensitive lookup with a `lowercase-path → TAbstractFile` index so misses are O(1) too.
+ *
+ * The index is explicitly opt-in: a consumer installs it by loading a
+ * {@link https://docs.obsidian.md/Reference/TypeScript+API/Component | Component} that keeps it in
+ * sync with `create`/`delete`/`rename` events (see `CaseInsensitiveFileIndexComponent`). Until then,
+ * the resolution layer falls back to the native (O(vault)-on-miss) lookup, so behavior is unchanged.
+ */
+import type { App, TAbstractFile } from 'obsidian';
+/**
+ * An O(1) case-insensitive index of the loaded files and folders of a single vault.
+ *
+ * The index maps the lowercased path of each abstract file to the abstract file itself. It is kept
+ * in sync by an owning component that forwards `create`/`delete`/`rename` vault events.
+ */
+export declare class CaseInsensitiveFileIndex {
+    protected readonly app: App;
+    private readonly map;
+    /**
+     * Creates a new case-insensitive file index.
+     *
+     * @param app - The Obsidian application instance whose vault this index mirrors.
+     */
+    constructor(app: App);
+    /**
+     * Adds an abstract file to the index.
+     *
+     * @param abstractFile - The abstract file to add.
+     */
+    add(abstractFile: TAbstractFile): void;
+    /**
+     * Removes the abstract file at the given path from the index, along with all of its descendants
+     * (for folder deletions, where Obsidian removes the whole subtree).
+     *
+     * @param path - The path of the abstract file to remove.
+     */
+    delete(path: string): void;
+    /**
+     * Resolves an abstract file by its path, case-insensitively, in O(1).
+     *
+     * @param path - The path to resolve.
+     * @returns The abstract file if found, otherwise `null`.
+     */
+    get(path: string): null | TAbstractFile;
+    /**
+     * Checks whether this index mirrors the given application's vault.
+     *
+     * @param app - The application instance to check against.
+     * @returns `true` if this index belongs to the given application, `false` otherwise.
+     */
+    ownsApp(app: App): boolean;
+    /**
+     * Re-keys an abstract file (and, for folders, all of its descendants) after a rename.
+     *
+     * Obsidian fires a single `rename` event for the renamed abstract file and updates its
+     * descendants' paths in place without firing per-descendant events, so descendant keys are
+     * recomputed here by swapping the old path prefix for the new one. Handles case-only renames (the
+     * old and new keys coincide).
+     *
+     * @param oldPath - The path the abstract file had before the rename.
+     * @param newAbstractFile - The abstract file with its updated (post-rename) path.
+     */
+    rename(oldPath: string, newAbstractFile: TAbstractFile): void;
+}
+/**
+ * Retrieves the installed case-insensitive file index for the given application, if any.
+ *
+ * @param app - The application instance whose index to retrieve.
+ * @returns The index if one is installed for this application, otherwise `null`.
+ */
+export declare function getCaseInsensitiveFileIndex(app: App): CaseInsensitiveFileIndex | null;
+/**
+ * Installs a case-insensitive file index as the active resolver.
+ *
+ * @param index - The index to install.
+ */
+export declare function setCaseInsensitiveFileIndex(index: CaseInsensitiveFileIndex): void;
+/**
+ * Uninstalls a case-insensitive file index, but only if it is the currently-installed one.
+ *
+ * @param index - The index to uninstall.
+ */
+export declare function unsetCaseInsensitiveFileIndex(index: CaseInsensitiveFileIndex): void;

package/dist/lib/esm/case-insensitive-file-index.mjs

@@ -0,0 +1,152 @@
+/*
+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 { snapshot } from "@mnaoumov/typescript-lib/array";
+import { getObsidianDevUtilsState } from "./obsidian-dev-utils-state.mjs";
+const STATE_KEY = "caseInsensitiveFileIndex";
+class CaseInsensitiveFileIndex {
+  /**
+   * Creates a new case-insensitive file index.
+   *
+   * @param app - The Obsidian application instance whose vault this index mirrors.
+   */
+  constructor(app) {
+    this.app = app;
+  }
+  app;
+  map = /* @__PURE__ */ new Map();
+  /**
+   * Adds an abstract file to the index.
+   *
+   * @param abstractFile - The abstract file to add.
+   */
+  add(abstractFile) {
+    this.map.set(abstractFile.path.toLowerCase(), abstractFile);
+  }
+  /**
+   * Removes the abstract file at the given path from the index, along with all of its descendants
+   * (for folder deletions, where Obsidian removes the whole subtree).
+   *
+   * @param path - The path of the abstract file to remove.
+   */
+  delete(path) {
+    const key = path.toLowerCase();
+    this.map.delete(key);
+    const descendantPrefix = `${key}/`;
+    for (const existingKey of snapshot(this.map.keys())) {
+      if (existingKey.startsWith(descendantPrefix)) {
+        this.map.delete(existingKey);
+      }
+    }
+  }
+  /**
+   * Resolves an abstract file by its path, case-insensitively, in O(1).
+   *
+   * @param path - The path to resolve.
+   * @returns The abstract file if found, otherwise `null`.
+   */
+  get(path) {
+    return this.map.get(path.toLowerCase()) ?? null;
+  }
+  /**
+   * Checks whether this index mirrors the given application's vault.
+   *
+   * @param app - The application instance to check against.
+   * @returns `true` if this index belongs to the given application, `false` otherwise.
+   */
+  ownsApp(app) {
+    return this.app === app;
+  }
+  /**
+   * Re-keys an abstract file (and, for folders, all of its descendants) after a rename.
+   *
+   * Obsidian fires a single `rename` event for the renamed abstract file and updates its
+   * descendants' paths in place without firing per-descendant events, so descendant keys are
+   * recomputed here by swapping the old path prefix for the new one. Handles case-only renames (the
+   * old and new keys coincide).
+   *
+   * @param oldPath - The path the abstract file had before the rename.
+   * @param newAbstractFile - The abstract file with its updated (post-rename) path.
+   */
+  rename(oldPath, newAbstractFile) {
+    const oldKey = oldPath.toLowerCase();
+    const newKey = newAbstractFile.path.toLowerCase();
+    this.map.delete(oldKey);
+    this.map.set(newKey, newAbstractFile);
+    const oldDescendantPrefix = `${oldKey}/`;
+    const newDescendantPrefix = `${newKey}/`;
+    for (const [existingKey, existingValue] of snapshot(this.map)) {
+      if (!existingKey.startsWith(oldDescendantPrefix)) {
+        continue;
+      }
+      this.map.delete(existingKey);
+      this.map.set(newDescendantPrefix + existingKey.slice(oldDescendantPrefix.length), existingValue);
+    }
+  }
+}
+function getCaseInsensitiveFileIndex(app) {
+  const index = getObsidianDevUtilsState(STATE_KEY, null).value;
+  return index?.ownsApp(app) ? index : null;
+}
+function setCaseInsensitiveFileIndex(index) {
+  getObsidianDevUtilsState(STATE_KEY, null).value = index;
+}
+function unsetCaseInsensitiveFileIndex(index) {
+  const wrapper = getObsidianDevUtilsState(STATE_KEY, null);
+  if (wrapper.value === index) {
+    wrapper.value = null;
+  }
+}
+export {
+  CaseInsensitiveFileIndex,
+  getCaseInsensitiveFileIndex,
+  setCaseInsensitiveFileIndex,
+  unsetCaseInsensitiveFileIndex
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2Nhc2UtaW5zZW5zaXRpdmUtZmlsZS1pbmRleC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFByb3ZpZGVzIGFuIG9wdC1pbiBPKDEpIGNhc2UtaW5zZW5zaXRpdmUgcmVzb2x2ZXIgZm9yIE9ic2lkaWFuIHZhdWx0cy5cbiAqXG4gKiBPYnNpZGlhbidzIG5hdGl2ZSB7QGxpbmsgaHR0cHM6Ly9kb2NzLm9ic2lkaWFuLm1kL1JlZmVyZW5jZS9UeXBlU2NyaXB0K0FQSS9WYXVsdCB8IFZhdWx0fSByZXNvbHZlc1xuICogYSBzdHJpbmcgcGF0aCBjYXNlLWluc2Vuc2l0aXZlbHkgKHRoZSBXaW5kb3dzL21hY09TIGRlZmF1bHQpIGluIE8oMSkgb24gYSBoaXQgYnV0IHdpdGggYW5cbiAqIE8odmF1bHQpIHNjYW4gb24gYSBtaXNzLiBUaGUgbWlzcyBjYXNlIGlzIHRoZSBob3Qgb25lIGR1cmluZyBkZWxldGlvbiBjYXNjYWRlcywgd2hlcmUgZXh0ZW5zaW9uXG4gKiBjaGVja3MgYW5kIGNhY2hlIGxvb2t1cHMgYXJlIHBlcmZvcm1lZCBvbiBhbHJlYWR5LXJlbW92ZWQgcGF0aHMuIFRoaXMgbW9kdWxlIGJhY2tzIHRoZVxuICogY2FzZS1pbnNlbnNpdGl2ZSBsb29rdXAgd2l0aCBhIGBsb3dlcmNhc2UtcGF0aCBcdTIxOTIgVEFic3RyYWN0RmlsZWAgaW5kZXggc28gbWlzc2VzIGFyZSBPKDEpIHRvby5cbiAqXG4gKiBUaGUgaW5kZXggaXMgZXhwbGljaXRseSBvcHQtaW46IGEgY29uc3VtZXIgaW5zdGFsbHMgaXQgYnkgbG9hZGluZyBhXG4gKiB7QGxpbmsgaHR0cHM6Ly9kb2NzLm9ic2lkaWFuLm1kL1JlZmVyZW5jZS9UeXBlU2NyaXB0K0FQSS9Db21wb25lbnQgfCBDb21wb25lbnR9IHRoYXQga2VlcHMgaXQgaW5cbiAqIHN5bmMgd2l0aCBgY3JlYXRlYC9gZGVsZXRlYC9gcmVuYW1lYCBldmVudHMgKHNlZSBgQ2FzZUluc2Vuc2l0aXZlRmlsZUluZGV4Q29tcG9uZW50YCkuIFVudGlsIHRoZW4sXG4gKiB0aGUgcmVzb2x1dGlvbiBsYXllciBmYWxscyBiYWNrIHRvIHRoZSBuYXRpdmUgKE8odmF1bHQpLW9uLW1pc3MpIGxvb2t1cCwgc28gYmVoYXZpb3IgaXMgdW5jaGFuZ2VkLlxuICovXG5cbmltcG9ydCB0eXBlIHtcbiAgQXBwLFxuICBUQWJzdHJhY3RGaWxlXG59IGZyb20gJ29ic2lkaWFuJztcblxuaW1wb3J0IHsgc25hcHNob3QgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvYXJyYXknO1xuXG5pbXBvcnQgeyBnZXRPYnNpZGlhbkRldlV0aWxzU3RhdGUgfSBmcm9tICcuL29ic2lkaWFuLWRldi11dGlscy1zdGF0ZS50cyc7XG5cbmNvbnN0IFNUQVRFX0tFWSA9ICdjYXNlSW5zZW5zaXRpdmVGaWxlSW5kZXgnO1xuXG4vKipcbiAqIEFuIE8oMSkgY2FzZS1pbnNlbnNpdGl2ZSBpbmRleCBvZiB0aGUgbG9hZGVkIGZpbGVzIGFuZCBmb2xkZXJzIG9mIGEgc2luZ2xlIHZhdWx0LlxuICpcbiAqIFRoZSBpbmRleCBtYXBzIHRoZSBsb3dlcmNhc2VkIHBhdGggb2YgZWFjaCBhYnN0cmFjdCBmaWxlIHRvIHRoZSBhYnN0cmFjdCBmaWxlIGl0c2VsZi4gSXQgaXMga2VwdFxuICogaW4gc3luYyBieSBhbiBvd25pbmcgY29tcG9uZW50IHRoYXQgZm9yd2FyZHMgYGNyZWF0ZWAvYGRlbGV0ZWAvYHJlbmFtZWAgdmF1bHQgZXZlbnRzLlxuICovXG5leHBvcnQgY2xhc3MgQ2FzZUluc2Vuc2l0aXZlRmlsZUluZGV4IHtcbiAgcHJpdmF0ZSByZWFkb25seSBtYXAgPSBuZXcgTWFwPHN0cmluZywgVEFic3RyYWN0RmlsZT4oKTtcblxuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBjYXNlLWluc2Vuc2l0aXZlIGZpbGUgaW5kZXguXG4gICAqXG4gICAqIEBwYXJhbSBhcHAgLSBUaGUgT2JzaWRpYW4gYXBwbGljYXRpb24gaW5zdGFuY2Ugd2hvc2UgdmF1bHQgdGhpcyBpbmRleCBtaXJyb3JzLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHByb3RlY3RlZCByZWFkb25seSBhcHA6IEFwcCkge31cblxuICAvKipcbiAgICogQWRkcyBhbiBhYnN0cmFjdCBmaWxlIHRvIHRoZSBpbmRleC5cbiAgICpcbiAgICogQHBhcmFtIGFic3RyYWN0RmlsZSAtIFRoZSBhYnN0cmFjdCBmaWxlIHRvIGFkZC5cbiAgICovXG4gIHB1YmxpYyBhZGQoYWJzdHJhY3RGaWxlOiBUQWJzdHJhY3RGaWxlKTogdm9pZCB7XG4gICAgdGhpcy5tYXAuc2V0KGFic3RyYWN0RmlsZS5wYXRoLnRvTG93ZXJDYXNlKCksIGFic3RyYWN0RmlsZSk7XG4gIH1cblxuICAvKipcbiAgICogUmVtb3ZlcyB0aGUgYWJzdHJhY3QgZmlsZSBhdCB0aGUgZ2l2ZW4gcGF0aCBmcm9tIHRoZSBpbmRleCwgYWxvbmcgd2l0aCBhbGwgb2YgaXRzIGRlc2NlbmRhbnRzXG4gICAqIChmb3IgZm9sZGVyIGRlbGV0aW9ucywgd2hlcmUgT2JzaWRpYW4gcmVtb3ZlcyB0aGUgd2hvbGUgc3VidHJlZSkuXG4gICAqXG4gICAqIEBwYXJhbSBwYXRoIC0gVGhlIHBhdGggb2YgdGhlIGFic3RyYWN0IGZpbGUgdG8gcmVtb3ZlLlxuICAgKi9cbiAgcHVibGljIGRlbGV0ZShwYXRoOiBzdHJpbmcpOiB2b2lkIHtcbiAgICBjb25zdCBrZXkgPSBwYXRoLnRvTG93ZXJDYXNlKCk7XG4gICAgdGhpcy5tYXAuZGVsZXRlKGtleSk7XG4gICAgY29uc3QgZGVzY2VuZGFudFByZWZpeCA9IGAke2tleX0vYDtcbiAgICBmb3IgKGNvbnN0IGV4aXN0aW5nS2V5IG9mIHNuYXBzaG90KHRoaXMubWFwLmtleXMoKSkpIHtcbiAgICAgIGlmIChleGlzdGluZ0tleS5zdGFydHNXaXRoKGRlc2NlbmRhbnRQcmVmaXgpKSB7XG4gICAgICAgIHRoaXMubWFwLmRlbGV0ZShleGlzdGluZ0tleSk7XG4gICAgICB9XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIFJlc29sdmVzIGFuIGFic3RyYWN0IGZpbGUgYnkgaXRzIHBhdGgsIGNhc2UtaW5zZW5zaXRpdmVseSwgaW4gTygxKS5cbiAgICpcbiAgICogQHBhcmFtIHBhdGggLSBUaGUgcGF0aCB0byByZXNvbHZlLlxuICAgKiBAcmV0dXJucyBUaGUgYWJzdHJhY3QgZmlsZSBpZiBmb3VuZCwgb3RoZXJ3aXNlIGBudWxsYC5cbiAgICovXG4gIHB1YmxpYyBnZXQocGF0aDogc3RyaW5nKTogbnVsbCB8IFRBYnN0cmFjdEZpbGUge1xuICAgIHJldHVybiB0aGlzLm1hcC5nZXQocGF0aC50b0xvd2VyQ2FzZSgpKSA/PyBudWxsO1xuICB9XG5cbiAgLyoqXG4gICAqIENoZWNrcyB3aGV0aGVyIHRoaXMgaW5kZXggbWlycm9ycyB0aGUgZ2l2ZW4gYXBwbGljYXRpb24ncyB2YXVsdC5cbiAgICpcbiAgICogQHBhcmFtIGFwcCAtIFRoZSBhcHBsaWNhdGlvbiBpbnN0YW5jZSB0byBjaGVjayBhZ2FpbnN0LlxuICAgKiBAcmV0dXJucyBgdHJ1ZWAgaWYgdGhpcyBpbmRleCBiZWxvbmdzIHRvIHRoZSBnaXZlbiBhcHBsaWNhdGlvbiwgYGZhbHNlYCBvdGhlcndpc2UuXG4gICAqL1xuICBwdWJsaWMgb3duc0FwcChhcHA6IEFwcCk6IGJvb2xlYW4ge1xuICAgIHJldHVybiB0aGlzLmFwcCA9PT0gYXBwO1xuICB9XG5cbiAgLyoqXG4gICAqIFJlLWtleXMgYW4gYWJzdHJhY3QgZmlsZSAoYW5kLCBmb3IgZm9sZGVycywgYWxsIG9mIGl0cyBkZXNjZW5kYW50cykgYWZ0ZXIgYSByZW5hbWUuXG4gICAqXG4gICAqIE9ic2lkaWFuIGZpcmVzIGEgc2luZ2xlIGByZW5hbWVgIGV2ZW50IGZvciB0aGUgcmVuYW1lZCBhYnN0cmFjdCBmaWxlIGFuZCB1cGRhdGVzIGl0c1xuICAgKiBkZXNjZW5kYW50cycgcGF0aHMgaW4gcGxhY2Ugd2l0aG91dCBmaXJpbmcgcGVyLWRlc2NlbmRhbnQgZXZlbnRzLCBzbyBkZXNjZW5kYW50IGtleXMgYXJlXG4gICAqIHJlY29tcHV0ZWQgaGVyZSBieSBzd2FwcGluZyB0aGUgb2xkIHBhdGggcHJlZml4IGZvciB0aGUgbmV3IG9uZS4gSGFuZGxlcyBjYXNlLW9ubHkgcmVuYW1lcyAodGhlXG4gICAqIG9sZCBhbmQgbmV3IGtleXMgY29pbmNpZGUpLlxuICAgKlxuICAgKiBAcGFyYW0gb2xkUGF0aCAtIFRoZSBwYXRoIHRoZSBhYnN0cmFjdCBmaWxlIGhhZCBiZWZvcmUgdGhlIHJlbmFtZS5cbiAgICogQHBhcmFtIG5ld0Fic3RyYWN0RmlsZSAtIFRoZSBhYnN0cmFjdCBmaWxlIHdpdGggaXRzIHVwZGF0ZWQgKHBvc3QtcmVuYW1lKSBwYXRoLlxuICAgKi9cbiAgcHVibGljIHJlbmFtZShvbGRQYXRoOiBzdHJpbmcsIG5ld0Fic3RyYWN0RmlsZTogVEFic3RyYWN0RmlsZSk6IHZvaWQge1xuICAgIGNvbnN0IG9sZEtleSA9IG9sZFBhdGgudG9Mb3dlckNhc2UoKTtcbiAgICBjb25zdCBuZXdLZXkgPSBuZXdBYnN0cmFjdEZpbGUucGF0aC50b0xvd2VyQ2FzZSgpO1xuICAgIHRoaXMubWFwLmRlbGV0ZShvbGRLZXkpO1xuICAgIHRoaXMubWFwLnNldChuZXdLZXksIG5ld0Fic3RyYWN0RmlsZSk7XG5cbiAgICBjb25zdCBvbGREZXNjZW5kYW50UHJlZml4ID0gYCR7b2xkS2V5fS9gO1xuICAgIGNvbnN0IG5ld0Rlc2NlbmRhbnRQcmVmaXggPSBgJHtuZXdLZXl9L2A7XG4gICAgZm9yIChjb25zdCBbZXhpc3RpbmdLZXksIGV4aXN0aW5nVmFsdWVdIG9mIHNuYXBzaG90KHRoaXMubWFwKSkge1xuICAgICAgaWYgKCFleGlzdGluZ0tleS5zdGFydHNXaXRoKG9sZERlc2NlbmRhbnRQcmVmaXgpKSB7XG4gICAgICAgIGNvbnRpbnVlO1xuICAgICAgfVxuXG4gICAgICB0aGlzLm1hcC5kZWxldGUoZXhpc3RpbmdLZXkpO1xuICAgICAgdGhpcy5tYXAuc2V0KG5ld0Rlc2NlbmRhbnRQcmVmaXggKyBleGlzdGluZ0tleS5zbGljZShvbGREZXNjZW5kYW50UHJlZml4Lmxlbmd0aCksIGV4aXN0aW5nVmFsdWUpO1xuICAgIH1cbiAgfVxufVxuXG4vKipcbiAqIFJldHJpZXZlcyB0aGUgaW5zdGFsbGVkIGNhc2UtaW5zZW5zaXRpdmUgZmlsZSBpbmRleCBmb3IgdGhlIGdpdmVuIGFwcGxpY2F0aW9uLCBpZiBhbnkuXG4gKlxuICogQHBhcmFtIGFwcCAtIFRoZSBhcHBsaWNhdGlvbiBpbnN0YW5jZSB3aG9zZSBpbmRleCB0byByZXRyaWV2ZS5cbiAqIEByZXR1cm5zIFRoZSBpbmRleCBpZiBvbmUgaXMgaW5zdGFsbGVkIGZvciB0aGlzIGFwcGxpY2F0aW9uLCBvdGhlcndpc2UgYG51bGxgLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0Q2FzZUluc2Vuc2l0aXZlRmlsZUluZGV4KGFwcDogQXBwKTogQ2FzZUluc2Vuc2l0aXZlRmlsZUluZGV4IHwgbnVsbCB7XG4gIGNvbnN0IGluZGV4ID0gZ2V0T2JzaWRpYW5EZXZVdGlsc1N0YXRlPENhc2VJbnNlbnNpdGl2ZUZpbGVJbmRleCB8IG51bGw+KFNUQVRFX0tFWSwgbnVsbCkudmFsdWU7XG4gIHJldHVybiBpbmRleD8ub3duc0FwcChhcHApID8gaW5kZXggOiBudWxsO1xufVxuXG4vKipcbiAqIEluc3RhbGxzIGEgY2FzZS1pbnNlbnNpdGl2ZSBmaWxlIGluZGV4IGFzIHRoZSBhY3RpdmUgcmVzb2x2ZXIuXG4gKlxuICogQHBhcmFtIGluZGV4IC0gVGhlIGluZGV4IHRvIGluc3RhbGwuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzZXRDYXNlSW5zZW5zaXRpdmVGaWxlSW5kZXgoaW5kZXg6IENhc2VJbnNlbnNpdGl2ZUZpbGVJbmRleCk6IHZvaWQge1xuICBnZXRPYnNpZGlhbkRldlV0aWxzU3RhdGU8Q2FzZUluc2Vuc2l0aXZlRmlsZUluZGV4IHwgbnVsbD4oU1RBVEVfS0VZLCBudWxsKS52YWx1ZSA9IGluZGV4O1xufVxuXG4vKipcbiAqIFVuaW5zdGFsbHMgYSBjYXNlLWluc2Vuc2l0aXZlIGZpbGUgaW5kZXgsIGJ1dCBvbmx5IGlmIGl0IGlzIHRoZSBjdXJyZW50bHktaW5zdGFsbGVkIG9uZS5cbiAqXG4gKiBAcGFyYW0gaW5kZXggLSBUaGUgaW5kZXggdG8gdW5pbnN0YWxsLlxuICovXG5leHBvcnQgZnVuY3Rpb24gdW5zZXRDYXNlSW5zZW5zaXRpdmVGaWxlSW5kZXgoaW5kZXg6IENhc2VJbnNlbnNpdGl2ZUZpbGVJbmRleCk6IHZvaWQge1xuICBjb25zdCB3cmFwcGVyID0gZ2V0T2JzaWRpYW5EZXZVdGlsc1N0YXRlPENhc2VJbnNlbnNpdGl2ZUZpbGVJbmRleCB8IG51bGw+KFNUQVRFX0tFWSwgbnVsbCk7XG4gIGlmICh3cmFwcGVyLnZhbHVlID09PSBpbmRleCkge1xuICAgIHdyYXBwZXIudmFsdWUgPSBudWxsO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBc0JBLFNBQVMsZ0JBQWdCO0FBRXpCLFNBQVMsZ0NBQWdDO0FBRXpDLE1BQU0sWUFBWTtBQVFYLE1BQU0seUJBQXlCO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBUTdCLFlBQStCLEtBQVU7QUFBVjtBQUFBLEVBQVc7QUFBQSxFQUFYO0FBQUEsRUFQckIsTUFBTSxvQkFBSSxJQUEyQjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQWMvQyxJQUFJLGNBQW1DO0FBQzVDLFNBQUssSUFBSSxJQUFJLGFBQWEsS0FBSyxZQUFZLEdBQUcsWUFBWTtBQUFBLEVBQzVEO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFRTyxPQUFPLE1BQW9CO0FBQ2hDLFVBQU0sTUFBTSxLQUFLLFlBQVk7QUFDN0IsU0FBSyxJQUFJLE9BQU8sR0FBRztBQUNuQixVQUFNLG1CQUFtQixHQUFHLEdBQUc7QUFDL0IsZUFBVyxlQUFlLFNBQVMsS0FBSyxJQUFJLEtBQUssQ0FBQyxHQUFHO0FBQ25ELFVBQUksWUFBWSxXQUFXLGdCQUFnQixHQUFHO0FBQzVDLGFBQUssSUFBSSxPQUFPLFdBQVc7QUFBQSxNQUM3QjtBQUFBLElBQ0Y7QUFBQSxFQUNGO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFRTyxJQUFJLE1BQW9DO0FBQzdDLFdBQU8sS0FBSyxJQUFJLElBQUksS0FBSyxZQUFZLENBQUMsS0FBSztBQUFBLEVBQzdDO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFRTyxRQUFRLEtBQW1CO0FBQ2hDLFdBQU8sS0FBSyxRQUFRO0FBQUEsRUFDdEI7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFhTyxPQUFPLFNBQWlCLGlCQUFzQztBQUNuRSxVQUFNLFNBQVMsUUFBUSxZQUFZO0FBQ25DLFVBQU0sU0FBUyxnQkFBZ0IsS0FBSyxZQUFZO0FBQ2hELFNBQUssSUFBSSxPQUFPLE1BQU07QUFDdEIsU0FBSyxJQUFJLElBQUksUUFBUSxlQUFlO0FBRXBDLFVBQU0sc0JBQXNCLEdBQUcsTUFBTTtBQUNyQyxVQUFNLHNCQUFzQixHQUFHLE1BQU07QUFDckMsZUFBVyxDQUFDLGFBQWEsYUFBYSxLQUFLLFNBQVMsS0FBSyxHQUFHLEdBQUc7QUFDN0QsVUFBSSxDQUFDLFlBQVksV0FBVyxtQkFBbUIsR0FBRztBQUNoRDtBQUFBLE1BQ0Y7QUFFQSxXQUFLLElBQUksT0FBTyxXQUFXO0FBQzNCLFdBQUssSUFBSSxJQUFJLHNCQUFzQixZQUFZLE1BQU0sb0JBQW9CLE1BQU0sR0FBRyxhQUFhO0FBQUEsSUFDakc7QUFBQSxFQUNGO0FBQ0Y7QUFRTyxTQUFTLDRCQUE0QixLQUEyQztBQUNyRixRQUFNLFFBQVEseUJBQTBELFdBQVcsSUFBSSxFQUFFO0FBQ3pGLFNBQU8sT0FBTyxRQUFRLEdBQUcsSUFBSSxRQUFRO0FBQ3ZDO0FBT08sU0FBUyw0QkFBNEIsT0FBdUM7QUFDakYsMkJBQTBELFdBQVcsSUFBSSxFQUFFLFFBQVE7QUFDckY7QUFPTyxTQUFTLDhCQUE4QixPQUF1QztBQUNuRixRQUFNLFVBQVUseUJBQTBELFdBQVcsSUFBSTtBQUN6RixNQUFJLFFBQVEsVUFBVSxPQUFPO0FBQzNCLFlBQVEsUUFBUTtBQUFBLEVBQ2xCO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/code-block-markdown-information.d.mts

@@ -0,0 +1,48 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * This module provides a helper type for the information about a code block in a markdown file.
+ */
+import type { MarkdownSectionInformation, Pos } from 'obsidian';
+/**
+ * Information about a code block in a markdown file.
+ */
+export interface CodeBlockMarkdownInformation {
+    /**
+     * Arguments of the code block.
+     */
+    $arguments: string[];
+    /**
+     * An end delimiter of the code block.
+     */
+    endDelimiter: string;
+    /**
+     * A language of the code block.
+     */
+    language: string;
+    /**
+     * A line prefix of each line of the code block.
+     */
+    linePrefix: string;
+    /**
+     * A content of the note.
+     */
+    noteContent: string;
+    /**
+     * A position of the code block in the note.
+     */
+    positionInNote: Pos;
+    /**
+     * Raw arguments string of the code block.
+     */
+    rawArgumentsString: string;
+    /**
+     * A section information of the code block.
+     */
+    sectionInfo: MarkdownSectionInformation;
+    /**
+     * A start delimiter of the code block.
+     */
+    startDelimiter: string;
+}