@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/cjs/canvas.cjs

@@ -0,0 +1,239 @@
+/*
+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 canvas_exports = {};
+__export(canvas_exports, {
+  getCanvasReferences: () => getCanvasReferences
+});
+module.exports = __toCommonJS(canvas_exports);
+var import_type_guards = require('@mnaoumov/typescript-lib/type-guards');
+var import_metadata_cache = require('./metadata-cache.cjs');
+var import_vault = require('./vault.cjs');
+async function getCanvasReferences(app, pathOrFile) {
+  const content = await (0, import_vault.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 (0, import_metadata_cache.parseMetadata)(app, node.text, { shouldParseMultiValueFrontmatterLinks: hasFrontmatterMarkdownLinksPlugin });
+        if (hasFrontmatterMarkdownLinksPlugin) {
+          contributeMultiValueFrontmatterLinks(metadata);
+        }
+        const links = (0, import_metadata_cache.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 = (0, import_type_guards.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
+  ];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getCanvasReferences
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2NhbnZhcy50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbnRhaW5zIGEgdXRpbGl0eSBmdW5jdGlvbiBmb3IgZXh0cmFjdGluZyByZWZlcmVuY2VzIGZyb20gYSBjYW52YXMgKGAuY2FudmFzYCkgZmlsZS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IEFwcCB9IGZyb20gJ29ic2lkaWFuJztcbmltcG9ydCB0eXBlIHsgQ2FudmFzRGF0YSB9IGZyb20gJ29ic2lkaWFuL2NhbnZhcy5kLnRzJztcblxuaW1wb3J0IHsgZW5zdXJlTm9uTnVsbGFibGUgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvdHlwZS1ndWFyZHMnO1xuXG5pbXBvcnQgdHlwZSB7IFBhdGhPckZpbGUgfSBmcm9tICcuL2ZpbGUtc3lzdGVtLnRzJztcbmltcG9ydCB0eXBlIHsgQ2FjaGVkTWV0YWRhdGFFeCB9IGZyb20gJy4vbWV0YWRhdGEtY2FjaGUudHMnO1xuaW1wb3J0IHR5cGUge1xuICBDYW52YXNGaWxlTm9kZVJlZmVyZW5jZSxcbiAgQ2FudmFzUmVmZXJlbmNlLFxuICBDYW52YXNUZXh0Tm9kZVJlZmVyZW5jZVxufSBmcm9tICcuL3JlZmVyZW5jZS50cyc7XG5cbmltcG9ydCB7XG4gIGdldExpbmtzLFxuICBwYXJzZU1ldGFkYXRhXG59IGZyb20gJy4vbWV0YWRhdGEtY2FjaGUudHMnO1xuaW1wb3J0IHsgcmVhZFNhZmUgfSBmcm9tICcuL3ZhdWx0LnRzJztcblxuLyoqXG4gKiBFeHRyYWN0cyB0aGUgb3V0Z29pbmcgcmVmZXJlbmNlcyBvZiBhIGNhbnZhcyAoYC5jYW52YXNgKSBmaWxlLlxuICpcbiAqIE9ic2lkaWFuIGRvZXMgbm90IGluZGV4IGNhbnZhcyBsaW5rcyBpbnRvIHRoZSBwZXItZmlsZSBtZXRhZGF0YSBjYWNoZSwgc28gYSBjYW52YXMgZmlsZSdzXG4gKiB7QGxpbmsgaHR0cHM6Ly9kb2NzLm9ic2lkaWFuLm1kL1JlZmVyZW5jZS9UeXBlU2NyaXB0K0FQSS9DYWNoZWRNZXRhZGF0YSB8IENhY2hlZE1ldGFkYXRhfSBpcyBlbXB0eSBhbmQgdGhlXG4gKiB1c3VhbCBjYWNoZS1iYXNlZCByZWFkZXJzIHJldHVybiBub3RoaW5nIGZvciBpdC4gVGhpcyBoZWxwZXIgcmVhZHMgdGhlIGNhbnZhcyBKU09OIGRpcmVjdGx5IGFuZCByZXR1cm5zXG4gKiBib3RoIGl0cyBmaWxlLW5vZGUgbGlua3MgYW5kIGl0cyB0ZXh0LW5vZGUgZW1iZWRzIGFzIHtAbGluayBDYW52YXNSZWZlcmVuY2V9cy5cbiAqXG4gKiBUaGUgcmV0dXJuZWQgcmVmZXJlbmNlcyBjYXJyeSB0aGUgYG5vZGVJbmRleGAvYHR5cGVgIChhbmQsIGZvciB0ZXh0IG5vZGVzLCB0aGUgYG9yaWdpbmFsUmVmZXJlbmNlYCkgdGhhdFxuICogdGhlIGNhbnZhcy1hd2FyZSB3cml0ZSBwYXRoIG5lZWRzLCBzbyBhIGNvbnN1bWVyIGNhbiBtb3ZlIGEgY2FudmFzLXJlZmVyZW5jZWQgYXR0YWNobWVudCBhbmQgcmV3cml0ZSB0aGVcbiAqIGNhbnZhcyBieSBjb21wb3NpbmcgYHJlZmVyZW5jZVRvRmlsZUNoYW5nZWAgKGZyb20gYC4vcmVmZXJlbmNlLnRzYCkgd2l0aCBgYXBwbHlGaWxlQ2hhbmdlc2AgKGZyb21cbiAqIGAuL2ZpbGUtY2hhbmdlLnRzYCkuXG4gKlxuICogQHBhcmFtIGFwcCAtIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2UuXG4gKiBAcGFyYW0gcGF0aE9yRmlsZSAtIFRoZSBjYW52YXMgZmlsZSAob3IgaXRzIHBhdGgpIHRvIGV4dHJhY3QgcmVmZXJlbmNlcyBmcm9tLlxuICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyB0byB0aGUgY2FudmFzIHJlZmVyZW5jZXMsIG9yIGFuIGVtcHR5IGFycmF5IHdoZW4gdGhlIGZpbGUgaXNcbiAqIG1pc3Npbmcgb3IgaXRzIGNvbnRlbnQgaXMgbm90IHZhbGlkIGNhbnZhcyBKU09OLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gZ2V0Q2FudmFzUmVmZXJlbmNlcyhhcHA6IEFwcCwgcGF0aE9yRmlsZTogUGF0aE9yRmlsZSk6IFByb21pc2U8Q2FudmFzUmVmZXJlbmNlW10+IHtcbiAgY29uc3QgY29udGVudCA9IGF3YWl0IHJlYWRTYWZlKGFwcCwgcGF0aE9yRmlsZSk7XG4gIGlmIChjb250ZW50ID09PSBudWxsKSB7XG4gICAgcmV0dXJuIFtdO1xuICB9XG5cbiAgbGV0IHBhcnRpYWxDYW52YXNEYXRhOiBudWxsIHwgUGFydGlhbDxDYW52YXNEYXRhPjtcbiAgdHJ5IHtcbiAgICBwYXJ0aWFsQ2FudmFzRGF0YSA9IEpTT04ucGFyc2UoY29udGVudCkgYXMgbnVsbCB8IFBhcnRpYWw8Q2FudmFzRGF0YT47XG4gIH0gY2F0Y2gge1xuICAgIHJldHVybiBbXTtcbiAgfVxuXG4gIGNvbnN0IGNhbnZhc0RhdGEgPSBwYXJ0aWFsQ2FudmFzRGF0YT8ubm9kZXNcbiAgICA/IHBhcnRpYWxDYW52YXNEYXRhIGFzIENhbnZhc0RhdGFcbiAgICA6IHtcbiAgICAgIGVkZ2VzOiBbXSxcbiAgICAgIG5vZGVzOiBbXVxuICAgIH07XG5cbiAgY29uc3QgcmVmZXJlbmNlczogQ2FudmFzUmVmZXJlbmNlW10gPSBbXTtcbiAgY29uc3QgaGFzRnJvbnRtYXR0ZXJNYXJrZG93bkxpbmtzUGx1Z2luID0gISFhcHAucGx1Z2lucy5nZXRQbHVnaW4oJ2Zyb250bWF0dGVyLW1hcmtkb3duLWxpbmtzJyk7XG5cbiAgZm9yIChjb25zdCBbbm9kZUluZGV4LCBub2RlXSBvZiBjYW52YXNEYXRhLm5vZGVzLmVudHJpZXMoKSkge1xuICAgIHN3aXRjaCAobm9kZS50eXBlKSB7XG4gICAgICBjYXNlICdmaWxlJzoge1xuICAgICAgICBjb25zdCBjYW52YXNGaWxlTm9kZVJlZmVyZW5jZTogQ2FudmFzRmlsZU5vZGVSZWZlcmVuY2UgPSB7XG4gICAgICAgICAgaXNDYW52YXM6IHRydWUsXG4gICAgICAgICAga2V5OiBgbm9kZXMuJHtTdHJpbmcobm9kZUluZGV4KX0uZmlsZWAsXG4gICAgICAgICAgbGluazogbm9kZS5maWxlLFxuICAgICAgICAgIG5vZGVJbmRleCxcbiAgICAgICAgICBvcmlnaW5hbDogbm9kZS5maWxlLFxuICAgICAgICAgIHR5cGU6ICdmaWxlJ1xuICAgICAgICB9O1xuICAgICAgICByZWZlcmVuY2VzLnB1c2goY2FudmFzRmlsZU5vZGVSZWZlcmVuY2UpO1xuICAgICAgICBicmVhaztcbiAgICAgIH1cbiAgICAgIGNhc2UgJ3RleHQnOiB7XG4gICAgICAgIGNvbnN0IG1ldGFkYXRhID0gYXdhaXQgcGFyc2VNZXRhZGF0YShhcHAsIG5vZGUudGV4dCwgeyBzaG91bGRQYXJzZU11bHRpVmFsdWVGcm9udG1hdHRlckxpbmtzOiBoYXNGcm9udG1hdHRlck1hcmtkb3duTGlua3NQbHVnaW4gfSk7XG4gICAgICAgIGlmIChoYXNGcm9udG1hdHRlck1hcmtkb3duTGlua3NQbHVnaW4pIHtcbiAgICAgICAgICBjb250cmlidXRlTXVsdGlWYWx1ZUZyb250bWF0dGVyTGlua3MobWV0YWRhdGEpO1xuICAgICAgICB9XG4gICAgICAgIGNvbnN0IGxpbmtzID0gZ2V0TGlua3MoeyBjYWNoZTogbWV0YWRhdGEgfSk7XG4gICAgICAgIGZvciAoY29uc3QgW2xpbmtJbmRleCwgbGlua10gb2YgbGlua3MuZW50cmllcygpKSB7XG4gICAgICAgICAgY29uc3QgY2FudmFzVGV4dE5vZGVSZWZlcmVuY2U6IENhbnZhc1RleHROb2RlUmVmZXJlbmNlID0ge1xuICAgICAgICAgICAgaXNDYW52YXM6IHRydWUsXG4gICAgICAgICAgICBrZXk6IGBub2Rlcy4ke1N0cmluZyhub2RlSW5kZXgpfS50ZXh0LiR7U3RyaW5nKGxpbmtJbmRleCl9YCxcbiAgICAgICAgICAgIGxpbms6IGxpbmsubGluayxcbiAgICAgICAgICAgIG5vZGVJbmRleCxcbiAgICAgICAgICAgIG9yaWdpbmFsOiBsaW5rLm9yaWdpbmFsLFxuICAgICAgICAgICAgb3JpZ2luYWxSZWZlcmVuY2U6IGxpbmssXG4gICAgICAgICAgICB0eXBlOiAndGV4dCdcbiAgICAgICAgICB9O1xuICAgICAgICAgIHJlZmVyZW5jZXMucHVzaChjYW52YXNUZXh0Tm9kZVJlZmVyZW5jZSk7XG4gICAgICAgIH1cbiAgICAgICAgYnJlYWs7XG4gICAgICB9XG4gICAgICBkZWZhdWx0OiB7XG4gICAgICAgIGJyZWFrO1xuICAgICAgfVxuICAgIH1cbiAgfVxuXG4gIHJldHVybiByZWZlcmVuY2VzO1xufVxuXG4vKipcbiAqIE1ha2VzIHRoZSBvbmUgY2hhbmdlIHRvIGEgY2FudmFzIHRleHQgbm9kZSdzIG1ldGFkYXRhIHRoYXQgdGhlIEZyb250bWF0dGVyIE1hcmtkb3duIExpbmtzIHBsdWdpbiBtYWtlcyB0byBhXG4gKiBub3RlJ3MgY2FjaGUsIHNvIGEgdGV4dCBub2RlIHJlYWRzIGl0cyBsaW5rcyBhcyBhIG5vdGUgd2l0aCB0aGUgc2FtZSB0ZXh0IHdvdWxkLlxuICpcbiAqIE9ic2lkaWFuIGl0c2VsZiByZWFkcyBhIHByb3BlcnR5IHdob3NlIFdIT0xFIHZhbHVlIGlzIG9uZSBpbnRlcm5hbCBsaW5rLCBtYXJrZG93biBsaW5rcyBpbmNsdWRlZCwgc28gdGhlIHBsdWdpblxuICogY29udHJpYnV0ZXMgb25seSB0aGUgbGlua3MgZW1iZWRkZWQgaW4gYSBtdWx0aS1saW5rIHZhbHVlIChgW0FdKGEubWQpLCBbQl0oYi5tZClgKSBhbmQgcmVwbGFjZXMgd2hhdGV2ZXIgT2JzaWRpYW5cbiAqIHJlY29yZGVkIHVuZGVyIHRoZSBzYW1lIGtleS4gQSB0ZXh0IG5vZGUgaXMgcGFyc2VkIG91dHNpZGUgdGhlIG1ldGFkYXRhIGNhY2hlLCB3aGVyZSB0aGUgcGx1Z2luIG5ldmVyIHNlZXMgaXQsXG4gKiBzbyB0aGUgc2FtZSBzdGVwIGlzIHJlcGVhdGVkIGhlcmUuXG4gKlxuICogQHBhcmFtIG1ldGFkYXRhIC0gVGhlIHRleHQgbm9kZSdzIG1ldGFkYXRhLCBwYXJzZWQgd2l0aCBtdWx0aS12YWx1ZSBmcm9udG1hdHRlciBsaW5rcywgc29cbiAqIGBtdWx0aVZhbHVlRnJvbnRtYXR0ZXJMaW5rc2AgaXMgYWx3YXlzIHNldC5cbiAqL1xuZnVuY3Rpb24gY29udHJpYnV0ZU11bHRpVmFsdWVGcm9udG1hdHRlckxpbmtzKG1ldGFkYXRhOiBDYWNoZWRNZXRhZGF0YUV4KTogdm9pZCB7XG4gIGNvbnN0IGNvbnRyaWJ1dGVkTGlua3MgPSBlbnN1cmVOb25OdWxsYWJsZShtZXRhZGF0YS5tdWx0aVZhbHVlRnJvbnRtYXR0ZXJMaW5rcyk7XG4gIGlmIChjb250cmlidXRlZExpbmtzLmxlbmd0aCA9PT0gMCkge1xuICAgIHJldHVybjtcbiAgfVxuXG4gIGNvbnN0IGNvbnRyaWJ1dGVkS2V5cyA9IG5ldyBTZXQoY29udHJpYnV0ZWRMaW5rcy5tYXAoKGxpbmspID0+IGxpbmsua2V5KSk7XG4gIC8vIEEgY29udHJpYnV0ZWQgbGluayBtZWFucyB0aGUgbm90ZSBoYXMgYSBmcm9udG1hdHRlciByZWNvcmQsIGFuZCBPYnNpZGlhbiBhc3NpZ25zIGBmcm9udG1hdHRlckxpbmtzYCBiZXNpZGUgaXQuXG4gIC8qIHY4IGlnbm9yZSBuZXh0IC0tIE5ldmVyIG51bGxpc2ggd2hlbiBhIGxpbmsgd2FzIGNvbnRyaWJ1dGVkOyB0aGUgYD8/IFtdYCBpcyBkZWZlbnNpdmUuICovXG4gIGNvbnN0IG5hdGl2ZUxpbmtzID0gbWV0YWRhdGEuZnJvbnRtYXR0ZXJMaW5rcyA/PyBbXTtcbiAgbWV0YWRhdGEuZnJvbnRtYXR0ZXJMaW5rcyA9IFtcbiAgICAuLi5uYXRpdmVMaW5rcy5maWx0ZXIoKGxpbmspID0+ICFjb250cmlidXRlZEtleXMuaGFzKGxpbmsua2V5KSksXG4gICAgLi4uY29udHJpYnV0ZWRMaW5rc1xuICBdO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7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

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

@@ -0,0 +1,28 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * Contains a utility function for extracting references from a canvas (`.canvas`) file.
+ */
+import type { App } from 'obsidian' with { 'resolution-mode': 'import' };
+import type { PathOrFile } from './file-system.cjs';
+import type { CanvasReference } from './reference.cjs';
+/**
+ * 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/cjs/case-insensitive-file-index.cjs

@@ -0,0 +1,268 @@
+/*
+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 case_insensitive_file_index_exports = {};
+__export(case_insensitive_file_index_exports, {
+  CaseInsensitiveFileIndex: () => CaseInsensitiveFileIndex,
+  getCaseInsensitiveFileIndex: () => getCaseInsensitiveFileIndex,
+  setCaseInsensitiveFileIndex: () => setCaseInsensitiveFileIndex,
+  unsetCaseInsensitiveFileIndex: () => unsetCaseInsensitiveFileIndex
+});
+module.exports = __toCommonJS(case_insensitive_file_index_exports);
+var import_array = require('@mnaoumov/typescript-lib/array');
+var import_obsidian_dev_utils_state = require('./obsidian-dev-utils-state.cjs');
+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 (0, import_array.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 (0, import_array.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 = (0, import_obsidian_dev_utils_state.getObsidianDevUtilsState)(STATE_KEY, null).value;
+  return index?.ownsApp(app) ? index : null;
+}
+function setCaseInsensitiveFileIndex(index) {
+  (0, import_obsidian_dev_utils_state.getObsidianDevUtilsState)(STATE_KEY, null).value = index;
+}
+function unsetCaseInsensitiveFileIndex(index) {
+  const wrapper = (0, import_obsidian_dev_utils_state.getObsidianDevUtilsState)(STATE_KEY, null);
+  if (wrapper.value === index) {
+    wrapper.value = null;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CaseInsensitiveFileIndex,
+  getCaseInsensitiveFileIndex,
+  setCaseInsensitiveFileIndex,
+  unsetCaseInsensitiveFileIndex
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2Nhc2UtaW5zZW5zaXRpdmUtZmlsZS1pbmRleC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFByb3ZpZGVzIGFuIG9wdC1pbiBPKDEpIGNhc2UtaW5zZW5zaXRpdmUgcmVzb2x2ZXIgZm9yIE9ic2lkaWFuIHZhdWx0cy5cbiAqXG4gKiBPYnNpZGlhbidzIG5hdGl2ZSB7QGxpbmsgaHR0cHM6Ly9kb2NzLm9ic2lkaWFuLm1kL1JlZmVyZW5jZS9UeXBlU2NyaXB0K0FQSS9WYXVsdCB8IFZhdWx0fSByZXNvbHZlc1xuICogYSBzdHJpbmcgcGF0aCBjYXNlLWluc2Vuc2l0aXZlbHkgKHRoZSBXaW5kb3dzL21hY09TIGRlZmF1bHQpIGluIE8oMSkgb24gYSBoaXQgYnV0IHdpdGggYW5cbiAqIE8odmF1bHQpIHNjYW4gb24gYSBtaXNzLiBUaGUgbWlzcyBjYXNlIGlzIHRoZSBob3Qgb25lIGR1cmluZyBkZWxldGlvbiBjYXNjYWRlcywgd2hlcmUgZXh0ZW5zaW9uXG4gKiBjaGVja3MgYW5kIGNhY2hlIGxvb2t1cHMgYXJlIHBlcmZvcm1lZCBvbiBhbHJlYWR5LXJlbW92ZWQgcGF0aHMuIFRoaXMgbW9kdWxlIGJhY2tzIHRoZVxuICogY2FzZS1pbnNlbnNpdGl2ZSBsb29rdXAgd2l0aCBhIGBsb3dlcmNhc2UtcGF0aCBcdTIxOTIgVEFic3RyYWN0RmlsZWAgaW5kZXggc28gbWlzc2VzIGFyZSBPKDEpIHRvby5cbiAqXG4gKiBUaGUgaW5kZXggaXMgZXhwbGljaXRseSBvcHQtaW46IGEgY29uc3VtZXIgaW5zdGFsbHMgaXQgYnkgbG9hZGluZyBhXG4gKiB7QGxpbmsgaHR0cHM6Ly9kb2NzLm9ic2lkaWFuLm1kL1JlZmVyZW5jZS9UeXBlU2NyaXB0K0FQSS9Db21wb25lbnQgfCBDb21wb25lbnR9IHRoYXQga2VlcHMgaXQgaW5cbiAqIHN5bmMgd2l0aCBgY3JlYXRlYC9gZGVsZXRlYC9gcmVuYW1lYCBldmVudHMgKHNlZSBgQ2FzZUluc2Vuc2l0aXZlRmlsZUluZGV4Q29tcG9uZW50YCkuIFVudGlsIHRoZW4sXG4gKiB0aGUgcmVzb2x1dGlvbiBsYXllciBmYWxscyBiYWNrIHRvIHRoZSBuYXRpdmUgKE8odmF1bHQpLW9uLW1pc3MpIGxvb2t1cCwgc28gYmVoYXZpb3IgaXMgdW5jaGFuZ2VkLlxuICovXG5cbmltcG9ydCB0eXBlIHtcbiAgQXBwLFxuICBUQWJzdHJhY3RGaWxlXG59IGZyb20gJ29ic2lkaWFuJztcblxuaW1wb3J0IHsgc25hcHNob3QgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvYXJyYXknO1xuXG5pbXBvcnQgeyBnZXRPYnNpZGlhbkRldlV0aWxzU3RhdGUgfSBmcm9tICcuL29ic2lkaWFuLWRldi11dGlscy1zdGF0ZS50cyc7XG5cbmNvbnN0IFNUQVRFX0tFWSA9ICdjYXNlSW5zZW5zaXRpdmVGaWxlSW5kZXgnO1xuXG4vKipcbiAqIEFuIE8oMSkgY2FzZS1pbnNlbnNpdGl2ZSBpbmRleCBvZiB0aGUgbG9hZGVkIGZpbGVzIGFuZCBmb2xkZXJzIG9mIGEgc2luZ2xlIHZhdWx0LlxuICpcbiAqIFRoZSBpbmRleCBtYXBzIHRoZSBsb3dlcmNhc2VkIHBhdGggb2YgZWFjaCBhYnN0cmFjdCBmaWxlIHRvIHRoZSBhYnN0cmFjdCBmaWxlIGl0c2VsZi4gSXQgaXMga2VwdFxuICogaW4gc3luYyBieSBhbiBvd25pbmcgY29tcG9uZW50IHRoYXQgZm9yd2FyZHMgYGNyZWF0ZWAvYGRlbGV0ZWAvYHJlbmFtZWAgdmF1bHQgZXZlbnRzLlxuICovXG5leHBvcnQgY2xhc3MgQ2FzZUluc2Vuc2l0aXZlRmlsZUluZGV4IHtcbiAgcHJpdmF0ZSByZWFkb25seSBtYXAgPSBuZXcgTWFwPHN0cmluZywgVEFic3RyYWN0RmlsZT4oKTtcblxuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBjYXNlLWluc2Vuc2l0aXZlIGZpbGUgaW5kZXguXG4gICAqXG4gICAqIEBwYXJhbSBhcHAgLSBUaGUgT2JzaWRpYW4gYXBwbGljYXRpb24gaW5zdGFuY2Ugd2hvc2UgdmF1bHQgdGhpcyBpbmRleCBtaXJyb3JzLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHByb3RlY3RlZCByZWFkb25seSBhcHA6IEFwcCkge31cblxuICAvKipcbiAgICogQWRkcyBhbiBhYnN0cmFjdCBmaWxlIHRvIHRoZSBpbmRleC5cbiAgICpcbiAgICogQHBhcmFtIGFic3RyYWN0RmlsZSAtIFRoZSBhYnN0cmFjdCBmaWxlIHRvIGFkZC5cbiAgICovXG4gIHB1YmxpYyBhZGQoYWJzdHJhY3RGaWxlOiBUQWJzdHJhY3RGaWxlKTogdm9pZCB7XG4gICAgdGhpcy5tYXAuc2V0KGFic3RyYWN0RmlsZS5wYXRoLnRvTG93ZXJDYXNlKCksIGFic3RyYWN0RmlsZSk7XG4gIH1cblxuICAvKipcbiAgICogUmVtb3ZlcyB0aGUgYWJzdHJhY3QgZmlsZSBhdCB0aGUgZ2l2ZW4gcGF0aCBmcm9tIHRoZSBpbmRleCwgYWxvbmcgd2l0aCBhbGwgb2YgaXRzIGRlc2NlbmRhbnRzXG4gICAqIChmb3IgZm9sZGVyIGRlbGV0aW9ucywgd2hlcmUgT2JzaWRpYW4gcmVtb3ZlcyB0aGUgd2hvbGUgc3VidHJlZSkuXG4gICAqXG4gICAqIEBwYXJhbSBwYXRoIC0gVGhlIHBhdGggb2YgdGhlIGFic3RyYWN0IGZpbGUgdG8gcmVtb3ZlLlxuICAgKi9cbiAgcHVibGljIGRlbGV0ZShwYXRoOiBzdHJpbmcpOiB2b2lkIHtcbiAgICBjb25zdCBrZXkgPSBwYXRoLnRvTG93ZXJDYXNlKCk7XG4gICAgdGhpcy5tYXAuZGVsZXRlKGtleSk7XG4gICAgY29uc3QgZGVzY2VuZGFudFByZWZpeCA9IGAke2tleX0vYDtcbiAgICBmb3IgKGNvbnN0IGV4aXN0aW5nS2V5IG9mIHNuYXBzaG90KHRoaXMubWFwLmtleXMoKSkpIHtcbiAgICAgIGlmIChleGlzdGluZ0tleS5zdGFydHNXaXRoKGRlc2NlbmRhbnRQcmVmaXgpKSB7XG4gICAgICAgIHRoaXMubWFwLmRlbGV0ZShleGlzdGluZ0tleSk7XG4gICAgICB9XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIFJlc29sdmVzIGFuIGFic3RyYWN0IGZpbGUgYnkgaXRzIHBhdGgsIGNhc2UtaW5zZW5zaXRpdmVseSwgaW4gTygxKS5cbiAgICpcbiAgICogQHBhcmFtIHBhdGggLSBUaGUgcGF0aCB0byByZXNvbHZlLlxuICAgKiBAcmV0dXJucyBUaGUgYWJzdHJhY3QgZmlsZSBpZiBmb3VuZCwgb3RoZXJ3aXNlIGBudWxsYC5cbiAgICovXG4gIHB1YmxpYyBnZXQocGF0aDogc3RyaW5nKTogbnVsbCB8IFRBYnN0cmFjdEZpbGUge1xuICAgIHJldHVybiB0aGlzLm1hcC5nZXQocGF0aC50b0xvd2VyQ2FzZSgpKSA/PyBudWxsO1xuICB9XG5cbiAgLyoqXG4gICAqIENoZWNrcyB3aGV0aGVyIHRoaXMgaW5kZXggbWlycm9ycyB0aGUgZ2l2ZW4gYXBwbGljYXRpb24ncyB2YXVsdC5cbiAgICpcbiAgICogQHBhcmFtIGFwcCAtIFRoZSBhcHBsaWNhdGlvbiBpbnN0YW5jZSB0byBjaGVjayBhZ2FpbnN0LlxuICAgKiBAcmV0dXJucyBgdHJ1ZWAgaWYgdGhpcyBpbmRleCBiZWxvbmdzIHRvIHRoZSBnaXZlbiBhcHBsaWNhdGlvbiwgYGZhbHNlYCBvdGhlcndpc2UuXG4gICAqL1xuICBwdWJsaWMgb3duc0FwcChhcHA6IEFwcCk6IGJvb2xlYW4ge1xuICAgIHJldHVybiB0aGlzLmFwcCA9PT0gYXBwO1xuICB9XG5cbiAgLyoqXG4gICAqIFJlLWtleXMgYW4gYWJzdHJhY3QgZmlsZSAoYW5kLCBmb3IgZm9sZGVycywgYWxsIG9mIGl0cyBkZXNjZW5kYW50cykgYWZ0ZXIgYSByZW5hbWUuXG4gICAqXG4gICAqIE9ic2lkaWFuIGZpcmVzIGEgc2luZ2xlIGByZW5hbWVgIGV2ZW50IGZvciB0aGUgcmVuYW1lZCBhYnN0cmFjdCBmaWxlIGFuZCB1cGRhdGVzIGl0c1xuICAgKiBkZXNjZW5kYW50cycgcGF0aHMgaW4gcGxhY2Ugd2l0aG91dCBmaXJpbmcgcGVyLWRlc2NlbmRhbnQgZXZlbnRzLCBzbyBkZXNjZW5kYW50IGtleXMgYXJlXG4gICAqIHJlY29tcHV0ZWQgaGVyZSBieSBzd2FwcGluZyB0aGUgb2xkIHBhdGggcHJlZml4IGZvciB0aGUgbmV3IG9uZS4gSGFuZGxlcyBjYXNlLW9ubHkgcmVuYW1lcyAodGhlXG4gICAqIG9sZCBhbmQgbmV3IGtleXMgY29pbmNpZGUpLlxuICAgKlxuICAgKiBAcGFyYW0gb2xkUGF0aCAtIFRoZSBwYXRoIHRoZSBhYnN0cmFjdCBmaWxlIGhhZCBiZWZvcmUgdGhlIHJlbmFtZS5cbiAgICogQHBhcmFtIG5ld0Fic3RyYWN0RmlsZSAtIFRoZSBhYnN0cmFjdCBmaWxlIHdpdGggaXRzIHVwZGF0ZWQgKHBvc3QtcmVuYW1lKSBwYXRoLlxuICAgKi9cbiAgcHVibGljIHJlbmFtZShvbGRQYXRoOiBzdHJpbmcsIG5ld0Fic3RyYWN0RmlsZTogVEFic3RyYWN0RmlsZSk6IHZvaWQge1xuICAgIGNvbnN0IG9sZEtleSA9IG9sZFBhdGgudG9Mb3dlckNhc2UoKTtcbiAgICBjb25zdCBuZXdLZXkgPSBuZXdBYnN0cmFjdEZpbGUucGF0aC50b0xvd2VyQ2FzZSgpO1xuICAgIHRoaXMubWFwLmRlbGV0ZShvbGRLZXkpO1xuICAgIHRoaXMubWFwLnNldChuZXdLZXksIG5ld0Fic3RyYWN0RmlsZSk7XG5cbiAgICBjb25zdCBvbGREZXNjZW5kYW50UHJlZml4ID0gYCR7b2xkS2V5fS9gO1xuICAgIGNvbnN0IG5ld0Rlc2NlbmRhbnRQcmVmaXggPSBgJHtuZXdLZXl9L2A7XG4gICAgZm9yIChjb25zdCBbZXhpc3RpbmdLZXksIGV4aXN0aW5nVmFsdWVdIG9mIHNuYXBzaG90KHRoaXMubWFwKSkge1xuICAgICAgaWYgKCFleGlzdGluZ0tleS5zdGFydHNXaXRoKG9sZERlc2NlbmRhbnRQcmVmaXgpKSB7XG4gICAgICAgIGNvbnRpbnVlO1xuICAgICAgfVxuXG4gICAgICB0aGlzLm1hcC5kZWxldGUoZXhpc3RpbmdLZXkpO1xuICAgICAgdGhpcy5tYXAuc2V0KG5ld0Rlc2NlbmRhbnRQcmVmaXggKyBleGlzdGluZ0tleS5zbGljZShvbGREZXNjZW5kYW50UHJlZml4Lmxlbmd0aCksIGV4aXN0aW5nVmFsdWUpO1xuICAgIH1cbiAgfVxufVxuXG4vKipcbiAqIFJldHJpZXZlcyB0aGUgaW5zdGFsbGVkIGNhc2UtaW5zZW5zaXRpdmUgZmlsZSBpbmRleCBmb3IgdGhlIGdpdmVuIGFwcGxpY2F0aW9uLCBpZiBhbnkuXG4gKlxuICogQHBhcmFtIGFwcCAtIFRoZSBhcHBsaWNhdGlvbiBpbnN0YW5jZSB3aG9zZSBpbmRleCB0byByZXRyaWV2ZS5cbiAqIEByZXR1cm5zIFRoZSBpbmRleCBpZiBvbmUgaXMgaW5zdGFsbGVkIGZvciB0aGlzIGFwcGxpY2F0aW9uLCBvdGhlcndpc2UgYG51bGxgLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0Q2FzZUluc2Vuc2l0aXZlRmlsZUluZGV4KGFwcDogQXBwKTogQ2FzZUluc2Vuc2l0aXZlRmlsZUluZGV4IHwgbnVsbCB7XG4gIGNvbnN0IGluZGV4ID0gZ2V0T2JzaWRpYW5EZXZVdGlsc1N0YXRlPENhc2VJbnNlbnNpdGl2ZUZpbGVJbmRleCB8IG51bGw+KFNUQVRFX0tFWSwgbnVsbCkudmFsdWU7XG4gIHJldHVybiBpbmRleD8ub3duc0FwcChhcHApID8gaW5kZXggOiBudWxsO1xufVxuXG4vKipcbiAqIEluc3RhbGxzIGEgY2FzZS1pbnNlbnNpdGl2ZSBmaWxlIGluZGV4IGFzIHRoZSBhY3RpdmUgcmVzb2x2ZXIuXG4gKlxuICogQHBhcmFtIGluZGV4IC0gVGhlIGluZGV4IHRvIGluc3RhbGwuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzZXRDYXNlSW5zZW5zaXRpdmVGaWxlSW5kZXgoaW5kZXg6IENhc2VJbnNlbnNpdGl2ZUZpbGVJbmRleCk6IHZvaWQge1xuICBnZXRPYnNpZGlhbkRldlV0aWxzU3RhdGU8Q2FzZUluc2Vuc2l0aXZlRmlsZUluZGV4IHwgbnVsbD4oU1RBVEVfS0VZLCBudWxsKS52YWx1ZSA9IGluZGV4O1xufVxuXG4vKipcbiAqIFVuaW5zdGFsbHMgYSBjYXNlLWluc2Vuc2l0aXZlIGZpbGUgaW5kZXgsIGJ1dCBvbmx5IGlmIGl0IGlzIHRoZSBjdXJyZW50bHktaW5zdGFsbGVkIG9uZS5cbiAqXG4gKiBAcGFyYW0gaW5kZXggLSBUaGUgaW5kZXggdG8gdW5pbnN0YWxsLlxuICovXG5leHBvcnQgZnVuY3Rpb24gdW5zZXRDYXNlSW5zZW5zaXRpdmVGaWxlSW5kZXgoaW5kZXg6IENhc2VJbnNlbnNpdGl2ZUZpbGVJbmRleCk6IHZvaWQge1xuICBjb25zdCB3cmFwcGVyID0gZ2V0T2JzaWRpYW5EZXZVdGlsc1N0YXRlPENhc2VJbnNlbnNpdGl2ZUZpbGVJbmRleCB8IG51bGw+KFNUQVRFX0tFWSwgbnVsbCk7XG4gIGlmICh3cmFwcGVyLnZhbHVlID09PSBpbmRleCkge1xuICAgIHdyYXBwZXIudmFsdWUgPSBudWxsO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBc0JBLG1CQUF5QjtBQUV6QixzQ0FBeUM7QUFFekMsTUFBTSxZQUFZO0FBUVgsTUFBTSx5QkFBeUI7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFRN0IsWUFBK0IsS0FBVTtBQUFWO0FBQUEsRUFBVztBQUFBLEVBQVg7QUFBQSxFQVByQixNQUFNLG9CQUFJLElBQTJCO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBYy9DLElBQUksY0FBbUM7QUFDNUMsU0FBSyxJQUFJLElBQUksYUFBYSxLQUFLLFlBQVksR0FBRyxZQUFZO0FBQUEsRUFDNUQ7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVFPLE9BQU8sTUFBb0I7QUFDaEMsVUFBTSxNQUFNLEtBQUssWUFBWTtBQUM3QixTQUFLLElBQUksT0FBTyxHQUFHO0FBQ25CLFVBQU0sbUJBQW1CLEdBQUcsR0FBRztBQUMvQixlQUFXLG1CQUFlLHVCQUFTLEtBQUssSUFBSSxLQUFLLENBQUMsR0FBRztBQUNuRCxVQUFJLFlBQVksV0FBVyxnQkFBZ0IsR0FBRztBQUM1QyxhQUFLLElBQUksT0FBTyxXQUFXO0FBQUEsTUFDN0I7QUFBQSxJQUNGO0FBQUEsRUFDRjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBUU8sSUFBSSxNQUFvQztBQUM3QyxXQUFPLEtBQUssSUFBSSxJQUFJLEtBQUssWUFBWSxDQUFDLEtBQUs7QUFBQSxFQUM3QztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBUU8sUUFBUSxLQUFtQjtBQUNoQyxXQUFPLEtBQUssUUFBUTtBQUFBLEVBQ3RCO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBYU8sT0FBTyxTQUFpQixpQkFBc0M7QUFDbkUsVUFBTSxTQUFTLFFBQVEsWUFBWTtBQUNuQyxVQUFNLFNBQVMsZ0JBQWdCLEtBQUssWUFBWTtBQUNoRCxTQUFLLElBQUksT0FBTyxNQUFNO0FBQ3RCLFNBQUssSUFBSSxJQUFJLFFBQVEsZUFBZTtBQUVwQyxVQUFNLHNCQUFzQixHQUFHLE1BQU07QUFDckMsVUFBTSxzQkFBc0IsR0FBRyxNQUFNO0FBQ3JDLGVBQVcsQ0FBQyxhQUFhLGFBQWEsU0FBSyx1QkFBUyxLQUFLLEdBQUcsR0FBRztBQUM3RCxVQUFJLENBQUMsWUFBWSxXQUFXLG1CQUFtQixHQUFHO0FBQ2hEO0FBQUEsTUFDRjtBQUVBLFdBQUssSUFBSSxPQUFPLFdBQVc7QUFDM0IsV0FBSyxJQUFJLElBQUksc0JBQXNCLFlBQVksTUFBTSxvQkFBb0IsTUFBTSxHQUFHLGFBQWE7QUFBQSxJQUNqRztBQUFBLEVBQ0Y7QUFDRjtBQVFPLFNBQVMsNEJBQTRCLEtBQTJDO0FBQ3JGLFFBQU0sWUFBUSwwREFBMEQsV0FBVyxJQUFJLEVBQUU7QUFDekYsU0FBTyxPQUFPLFFBQVEsR0FBRyxJQUFJLFFBQVE7QUFDdkM7QUFPTyxTQUFTLDRCQUE0QixPQUF1QztBQUNqRixnRUFBMEQsV0FBVyxJQUFJLEVBQUUsUUFBUTtBQUNyRjtBQU9PLFNBQVMsOEJBQThCLE9BQXVDO0FBQ25GLFFBQU0sY0FBVSwwREFBMEQsV0FBVyxJQUFJO0FBQ3pGLE1BQUksUUFBUSxVQUFVLE9BQU87QUFDM0IsWUFBUSxRQUFRO0FBQUEsRUFDbEI7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/cjs/case-insensitive-file-index.d.cts

@@ -0,0 +1,92 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @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' with { 'resolution-mode': 'import' };
+/**
+ * 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;