obsidian-dev-utils 80.0.2 → 81.0.0

package/dist/lib/esm/obsidian/file-manager.mjs

@@ -21,7 +21,10 @@ if you want to view the source, please visit the github repository of this plugi
   globalThis.process = browserProcess;
 })();
 
-import { deepEqual } from "../object-utils.mjs";
+import {
+  deepEqual,
+  normalizeOptionalProperties
+} from "../object-utils.mjs";
 import {
   getFile,
   getPath,
@@ -32,63 +35,92 @@ import {
   setFrontmatter
 } from "./frontmatter.mjs";
 import { process } from "./vault.mjs";
-async function addAlias(app, pathOrFile, alias) {
+async function addAlias(params) {
+  const {
+    alias,
+    app,
+    pathOrFile
+  } = params;
   if (!alias) {
     return;
   }
-  const file = getFile(app, pathOrFile);
+  const file = getFile({ app, pathOrFile });
   if (!isMarkdownFile(file)) {
     throw new Error(`File ${file.path} is not a markdown file.`);
   }
   if (alias === file.basename || alias === file.name) {
     return;
   }
-  await processFrontmatter(app, pathOrFile, (frontmatter) => {
-    frontmatter.aliases ??= [];
-    if (!frontmatter.aliases.includes(alias)) {
-      frontmatter.aliases.push(alias);
-    }
+  await processFrontmatter({
+    app,
+    frontmatterFn: (frontmatter) => {
+      frontmatter.aliases ??= [];
+      if (!frontmatter.aliases.includes(alias)) {
+        frontmatter.aliases.push(alias);
+      }
+    },
+    pathOrFile
   });
 }
-async function deleteAlias(app, pathOrFile, alias) {
+async function deleteAlias(params) {
+  const {
+    alias,
+    app,
+    pathOrFile
+  } = params;
   if (!alias) {
     return;
   }
   if (!isMarkdownFile(pathOrFile)) {
     throw new Error(`File ${getPath(app, pathOrFile)} is not a markdown file.`);
   }
-  await processFrontmatter(app, pathOrFile, (frontmatter) => {
-    if (!frontmatter.aliases) {
-      return;
-    }
-    frontmatter.aliases = frontmatter.aliases.filter((a) => a !== alias);
-    if (frontmatter.aliases.length === 0) {
-      delete frontmatter.aliases;
-    }
+  await processFrontmatter({
+    app,
+    frontmatterFn: (frontmatter) => {
+      if (!frontmatter.aliases) {
+        return;
+      }
+      frontmatter.aliases = frontmatter.aliases.filter((a) => a !== alias);
+      if (frontmatter.aliases.length === 0) {
+        delete frontmatter.aliases;
+      }
+    },
+    pathOrFile
   });
 }
-async function processFrontmatter(app, pathOrFile, frontmatterFn, options = {}) {
+async function processFrontmatter(params) {
+  const {
+    app,
+    frontmatterFn,
+    pathOrFile,
+    ...options
+  } = params;
   if (!isMarkdownFile(pathOrFile)) {
     throw new Error(`File ${getPath(app, pathOrFile)} is not a markdown file.`);
   }
-  await process(app, pathOrFile, async ({ abortSignal, content }) => {
-    abortSignal.throwIfAborted();
-    const oldFrontmatter = parseFrontmatter(content);
-    const newFrontmatter = parseFrontmatter(content);
-    const result = await frontmatterFn(newFrontmatter, abortSignal);
-    abortSignal.throwIfAborted();
-    if (result === null) {
-      return null;
-    }
-    if (deepEqual(oldFrontmatter, newFrontmatter)) {
-      return content;
-    }
-    return setFrontmatter(content, newFrontmatter);
-  }, options);
+  await process(normalizeOptionalProperties({
+    app,
+    async newContentProvider({ abortSignal, content }) {
+      abortSignal.throwIfAborted();
+      const oldFrontmatter = parseFrontmatter(content);
+      const newFrontmatter = parseFrontmatter(content);
+      const result = await frontmatterFn(newFrontmatter, abortSignal);
+      abortSignal.throwIfAborted();
+      if (result === null) {
+        return null;
+      }
+      if (deepEqual(oldFrontmatter, newFrontmatter)) {
+        return content;
+      }
+      return setFrontmatter(content, newFrontmatter);
+    },
+    pathOrFile,
+    ...options
+  }));
 }
 export {
   addAlias,
   deleteAlias,
   processFrontmatter
 };
-//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2ZpbGUtbWFuYWdlci50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbnRhaW5zIHV0aWxpdHkgZnVuY3Rpb25zIGZvciBtYW5hZ2luZyBmaWxlcyBpbiBPYnNpZGlhbi5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IEFwcCB9IGZyb20gJ29ic2lkaWFuJztcbmltcG9ydCB0eXBlIHsgUHJvbWlzYWJsZSB9IGZyb20gJ3R5cGUtZmVzdCc7XG5cbmltcG9ydCB0eXBlIHsgTWF5YmVSZXR1cm4gfSBmcm9tICcuLi90eXBlLnRzJztcbmltcG9ydCB0eXBlIHsgUGF0aE9yRmlsZSB9IGZyb20gJy4vZmlsZS1zeXN0ZW0udHMnO1xuaW1wb3J0IHR5cGUgeyBDb21iaW5lZEZyb250bWF0dGVyIH0gZnJvbSAnLi9mcm9udG1hdHRlci50cyc7XG5pbXBvcnQgdHlwZSB7IFByb2Nlc3NPcHRpb25zIH0gZnJvbSAnLi92YXVsdC50cyc7XG5cbmltcG9ydCB7IGRlZXBFcXVhbCB9IGZyb20gJy4uL29iamVjdC11dGlscy50cyc7XG5pbXBvcnQge1xuICBnZXRGaWxlLFxuICBnZXRQYXRoLFxuICBpc01hcmtkb3duRmlsZVxufSBmcm9tICcuL2ZpbGUtc3lzdGVtLnRzJztcbmltcG9ydCB7XG4gIHBhcnNlRnJvbnRtYXR0ZXIsXG4gIHNldEZyb250bWF0dGVyXG59IGZyb20gJy4vZnJvbnRtYXR0ZXIudHMnO1xuaW1wb3J0IHsgcHJvY2VzcyB9IGZyb20gJy4vdmF1bHQudHMnO1xuXG4vKipcbiAqIE9wdGlvbnMgZm9yIHtAbGluayBwcm9jZXNzRnJvbnRtYXR0ZXJ9LlxuICovXG5leHBvcnQgdHlwZSBQcm9jZXNzRnJvbnRtYXR0ZXJPcHRpb25zID0gUHJvY2Vzc09wdGlvbnM7XG5cbi8qKlxuICogQWRkcyBhbiBhbGlhcyB0byB0aGUgZnJvbnQgbWF0dGVyIG9mIGEgZ2l2ZW4gZmlsZSBpZiBpdCBkb2VzIG5vdCBhbHJlYWR5IGV4aXN0LlxuICpcbiAqIEBwYXJhbSBhcHAgLSBUaGUgT2JzaWRpYW4gYXBwIGluc3RhbmNlLlxuICogQHBhcmFtIHBhdGhPckZpbGUgLSBUaGUgcGF0aCBvciBURmlsZSBvYmplY3QgcmVwcmVzZW50aW5nIHRoZSBub3RlLlxuICogQHBhcmFtIGFsaWFzIC0gVGhlIGFsaWFzIHRvIGFkZC5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgd2hlbiB0aGUgYWxpYXMgaGFzIGJlZW4gYWRkZWQuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBhZGRBbGlhcyhhcHA6IEFwcCwgcGF0aE9yRmlsZTogUGF0aE9yRmlsZSwgYWxpYXM/OiBzdHJpbmcpOiBQcm9taXNlPHZvaWQ+IHtcbiAgaWYgKCFhbGlhcykge1xuICAgIHJldHVybjtcbiAgfVxuXG4gIGNvbnN0IGZpbGUgPSBnZXRGaWxlKGFwcCwgcGF0aE9yRmlsZSk7XG5cbiAgaWYgKCFpc01hcmtkb3duRmlsZShmaWxlKSkge1xuICAgIHRocm93IG5ldyBFcnJvcihgRmlsZSAke2ZpbGUucGF0aH0gaXMgbm90IGEgbWFya2Rvd24gZmlsZS5gKTtcbiAgfVxuXG4gIGlmIChhbGlhcyA9PT0gZmlsZS5iYXNlbmFtZSB8fCBhbGlhcyA9PT0gZmlsZS5uYW1lKSB7XG4gICAgcmV0dXJuO1xuICB9XG5cbiAgYXdhaXQgcHJvY2Vzc0Zyb250bWF0dGVyKGFwcCwgcGF0aE9yRmlsZSwgKGZyb250bWF0dGVyKSA9PiB7XG4gICAgZnJvbnRtYXR0ZXIuYWxpYXNlcyA/Pz0gW107XG5cbiAgICBpZiAoIWZyb250bWF0dGVyLmFsaWFzZXMuaW5jbHVkZXMoYWxpYXMpKSB7XG4gICAgICBmcm9udG1hdHRlci5hbGlhc2VzLnB1c2goYWxpYXMpO1xuICAgIH1cbiAgfSk7XG59XG5cbi8qKlxuICogRGVsZXRlcyBhbiBhbGlhcyBmcm9tIHRoZSBmcm9udCBtYXR0ZXIgb2YgYSBnaXZlbiBmaWxlIGlmIGl0IGV4aXN0cy5cbiAqXG4gKiBAcGFyYW0gYXBwIC0gVGhlIE9ic2lkaWFuIGFwcCBpbnN0YW5jZS5cbiAqIEBwYXJhbSBwYXRoT3JGaWxlIC0gVGhlIHBhdGggb3IgVEZpbGUgb2JqZWN0IHJlcHJlc2VudGluZyB0aGUgbm90ZS5cbiAqIEBwYXJhbSBhbGlhcyAtIFRoZSBhbGlhcyB0byBkZWxldGUuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdoZW4gdGhlIGFsaWFzIGhhcyBiZWVuIGRlbGV0ZWQuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBkZWxldGVBbGlhcyhhcHA6IEFwcCwgcGF0aE9yRmlsZTogUGF0aE9yRmlsZSwgYWxpYXM/OiBzdHJpbmcpOiBQcm9taXNlPHZvaWQ+IHtcbiAgaWYgKCFhbGlhcykge1xuICAgIHJldHVybjtcbiAgfVxuXG4gIGlmICghaXNNYXJrZG93bkZpbGUocGF0aE9yRmlsZSkpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IoYEZpbGUgJHtnZXRQYXRoKGFwcCwgcGF0aE9yRmlsZSl9IGlzIG5vdCBhIG1hcmtkb3duIGZpbGUuYCk7XG4gIH1cblxuICBhd2FpdCBwcm9jZXNzRnJvbnRtYXR0ZXIoYXBwLCBwYXRoT3JGaWxlLCAoZnJvbnRtYXR0ZXIpID0+IHtcbiAgICBpZiAoIWZyb250bWF0dGVyLmFsaWFzZXMpIHtcbiAgICAgIHJldHVybjtcbiAgICB9XG5cbiAgICBmcm9udG1hdHRlci5hbGlhc2VzID0gZnJvbnRtYXR0ZXIuYWxpYXNlcy5maWx0ZXIoKGEpID0+IGEgIT09IGFsaWFzKTtcblxuICAgIGlmIChmcm9udG1hdHRlci5hbGlhc2VzLmxlbmd0aCA9PT0gMCkge1xuICAgICAgZGVsZXRlIGZyb250bWF0dGVyLmFsaWFzZXM7XG4gICAgfVxuICB9KTtcbn1cblxuLyoqXG4gKiBQcm9jZXNzZXMgdGhlIGZyb250IG1hdHRlciBvZiBhIGdpdmVuIGZpbGUsIGFsbG93aW5nIG1vZGlmaWNhdGlvbnMgdmlhIGEgcHJvdmlkZWQgZnVuY3Rpb24uXG4gKlxuICogQHR5cGVQYXJhbSBDdXN0b21Gcm9udG1hdHRlciAtIFRoZSB0eXBlIG9mIGN1c3RvbSBmcm9udCBtYXR0ZXIuXG4gKiBAcGFyYW0gYXBwIC0gVGhlIE9ic2lkaWFuIGFwcCBpbnN0YW5jZS5cbiAqIEBwYXJhbSBwYXRoT3JGaWxlIC0gVGhlIHBhdGggb3IgVEZpbGUgb2JqZWN0IHJlcHJlc2VudGluZyB0aGUgbm90ZS5cbiAqIEBwYXJhbSBmcm9udG1hdHRlckZuIC0gQSBmdW5jdGlvbiB0aGF0IG1vZGlmaWVzIHRoZSBmcm9udCBtYXR0ZXIuXG4gKiBAcGFyYW0gb3B0aW9ucyAtIE9wdGlvbmFsLiBDb25maWd1cmF0aW9uIG9wdGlvbnMgZm9yIHJldHJ5aW5nIHRoZSBwcm9jZXNzLiBJZiBub3QgcHJvdmlkZWQsIGRlZmF1bHQgb3B0aW9ucyB3aWxsIGJlIHVzZWQuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdoZW4gdGhlIGZyb250IG1hdHRlciBoYXMgYmVlbiBwcm9jZXNzZWQgYW5kIHNhdmVkLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gcHJvY2Vzc0Zyb250bWF0dGVyPEN1c3RvbUZyb250bWF0dGVyID0gdW5rbm93bj4oXG4gIGFwcDogQXBwLFxuICBwYXRoT3JGaWxlOiBQYXRoT3JGaWxlLFxuICBmcm9udG1hdHRlckZuOiAoZnJvbnRtYXR0ZXI6IENvbWJpbmVkRnJvbnRtYXR0ZXI8Q3VzdG9tRnJvbnRtYXR0ZXI+LCBhYm9ydFNpZ25hbDogQWJvcnRTaWduYWwpID0+IFByb21pc2FibGU8TWF5YmVSZXR1cm48bnVsbD4+LFxuICBvcHRpb25zOiBQcm9jZXNzRnJvbnRtYXR0ZXJPcHRpb25zID0ge31cbik6IFByb21pc2U8dm9pZD4ge1xuICBpZiAoIWlzTWFya2Rvd25GaWxlKHBhdGhPckZpbGUpKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGBGaWxlICR7Z2V0UGF0aChhcHAsIHBhdGhPckZpbGUpfSBpcyBub3QgYSBtYXJrZG93biBmaWxlLmApO1xuICB9XG5cbiAgYXdhaXQgcHJvY2VzcyhhcHAsIHBhdGhPckZpbGUsIGFzeW5jICh7IGFib3J0U2lnbmFsLCBjb250ZW50IH0pID0+IHtcbiAgICBhYm9ydFNpZ25hbC50aHJvd0lmQWJvcnRlZCgpO1xuXG4gICAgY29uc3Qgb2xkRnJvbnRtYXR0ZXIgPSBwYXJzZUZyb250bWF0dGVyPEN1c3RvbUZyb250bWF0dGVyPihjb250ZW50KTtcbiAgICBjb25zdCBuZXdGcm9udG1hdHRlciA9IHBhcnNlRnJvbnRtYXR0ZXI8Q3VzdG9tRnJvbnRtYXR0ZXI+KGNvbnRlbnQpO1xuICAgIGNvbnN0IHJlc3VsdCA9IGF3YWl0IGZyb250bWF0dGVyRm4obmV3RnJvbnRtYXR0ZXIsIGFib3J0U2lnbmFsKTtcbiAgICBhYm9ydFNpZ25hbC50aHJvd0lmQWJvcnRlZCgpO1xuXG4gICAgaWYgKHJlc3VsdCA9PT0gbnVsbCkge1xuICAgICAgcmV0dXJuIG51bGw7XG4gICAgfVxuXG4gICAgaWYgKGRlZXBFcXVhbChvbGRGcm9udG1hdHRlciwgbmV3RnJvbnRtYXR0ZXIpKSB7XG4gICAgICByZXR1cm4gY29udGVudDtcbiAgICB9XG5cbiAgICByZXR1cm4gc2V0RnJvbnRtYXR0ZXIoY29udGVudCwgbmV3RnJvbnRtYXR0ZXIpO1xuICB9LCBvcHRpb25zKTtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBY0EsU0FBUyxpQkFBaUI7QUFDMUI7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxPQUNLO0FBQ1A7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFDUCxTQUFTLGVBQWU7QUFleEIsZUFBc0IsU0FBUyxLQUFVLFlBQXdCLE9BQStCO0FBQzlGLE1BQUksQ0FBQyxPQUFPO0FBQ1Y7QUFBQSxFQUNGO0FBRUEsUUFBTSxPQUFPLFFBQVEsS0FBSyxVQUFVO0FBRXBDLE1BQUksQ0FBQyxlQUFlLElBQUksR0FBRztBQUN6QixVQUFNLElBQUksTUFBTSxRQUFRLEtBQUssSUFBSSwwQkFBMEI7QUFBQSxFQUM3RDtBQUVBLE1BQUksVUFBVSxLQUFLLFlBQVksVUFBVSxLQUFLLE1BQU07QUFDbEQ7QUFBQSxFQUNGO0FBRUEsUUFBTSxtQkFBbUIsS0FBSyxZQUFZLENBQUMsZ0JBQWdCO0FBQ3pELGdCQUFZLFlBQVksQ0FBQztBQUV6QixRQUFJLENBQUMsWUFBWSxRQUFRLFNBQVMsS0FBSyxHQUFHO0FBQ3hDLGtCQUFZLFFBQVEsS0FBSyxLQUFLO0FBQUEsSUFDaEM7QUFBQSxFQUNGLENBQUM7QUFDSDtBQVVBLGVBQXNCLFlBQVksS0FBVSxZQUF3QixPQUErQjtBQUNqRyxNQUFJLENBQUMsT0FBTztBQUNWO0FBQUEsRUFDRjtBQUVBLE1BQUksQ0FBQyxlQUFlLFVBQVUsR0FBRztBQUMvQixVQUFNLElBQUksTUFBTSxRQUFRLFFBQVEsS0FBSyxVQUFVLENBQUMsMEJBQTBCO0FBQUEsRUFDNUU7QUFFQSxRQUFNLG1CQUFtQixLQUFLLFlBQVksQ0FBQyxnQkFBZ0I7QUFDekQsUUFBSSxDQUFDLFlBQVksU0FBUztBQUN4QjtBQUFBLElBQ0Y7QUFFQSxnQkFBWSxVQUFVLFlBQVksUUFBUSxPQUFPLENBQUMsTUFBTSxNQUFNLEtBQUs7QUFFbkUsUUFBSSxZQUFZLFFBQVEsV0FBVyxHQUFHO0FBQ3BDLGFBQU8sWUFBWTtBQUFBLElBQ3JCO0FBQUEsRUFDRixDQUFDO0FBQ0g7QUFZQSxlQUFzQixtQkFDcEIsS0FDQSxZQUNBLGVBQ0EsVUFBcUMsQ0FBQyxHQUN2QjtBQUNmLE1BQUksQ0FBQyxlQUFlLFVBQVUsR0FBRztBQUMvQixVQUFNLElBQUksTUFBTSxRQUFRLFFBQVEsS0FBSyxVQUFVLENBQUMsMEJBQTBCO0FBQUEsRUFDNUU7QUFFQSxRQUFNLFFBQVEsS0FBSyxZQUFZLE9BQU8sRUFBRSxhQUFhLFFBQVEsTUFBTTtBQUNqRSxnQkFBWSxlQUFlO0FBRTNCLFVBQU0saUJBQWlCLGlCQUFvQyxPQUFPO0FBQ2xFLFVBQU0saUJBQWlCLGlCQUFvQyxPQUFPO0FBQ2xFLFVBQU0sU0FBUyxNQUFNLGNBQWMsZ0JBQWdCLFdBQVc7QUFDOUQsZ0JBQVksZUFBZTtBQUUzQixRQUFJLFdBQVcsTUFBTTtBQUNuQixhQUFPO0FBQUEsSUFDVDtBQUVBLFFBQUksVUFBVSxnQkFBZ0IsY0FBYyxHQUFHO0FBQzdDLGFBQU87QUFBQSxJQUNUO0FBRUEsV0FBTyxlQUFlLFNBQVMsY0FBYztBQUFBLEVBQy9DLEdBQUcsT0FBTztBQUNaOyIsCiAgIm5hbWVzIjogW10KfQo=
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL29ic2lkaWFuL2ZpbGUtbWFuYWdlci50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbnRhaW5zIHV0aWxpdHkgZnVuY3Rpb25zIGZvciBtYW5hZ2luZyBmaWxlcyBpbiBPYnNpZGlhbi5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IEFwcCB9IGZyb20gJ29ic2lkaWFuJztcbmltcG9ydCB0eXBlIHsgUHJvbWlzYWJsZSB9IGZyb20gJ3R5cGUtZmVzdCc7XG5cbmltcG9ydCB0eXBlIHsgTWF5YmVSZXR1cm4gfSBmcm9tICcuLi90eXBlLnRzJztcbmltcG9ydCB0eXBlIHsgUGF0aE9yRmlsZSB9IGZyb20gJy4vZmlsZS1zeXN0ZW0udHMnO1xuaW1wb3J0IHR5cGUgeyBDb21iaW5lZEZyb250bWF0dGVyIH0gZnJvbSAnLi9mcm9udG1hdHRlci50cyc7XG5pbXBvcnQgdHlwZSB7XG4gIFByb2Nlc3NPcHRpb25zLFxuICBQcm9jZXNzUGFyYW1zXG59IGZyb20gJy4vdmF1bHQudHMnO1xuXG5pbXBvcnQge1xuICBkZWVwRXF1YWwsXG4gIG5vcm1hbGl6ZU9wdGlvbmFsUHJvcGVydGllc1xufSBmcm9tICcuLi9vYmplY3QtdXRpbHMudHMnO1xuaW1wb3J0IHtcbiAgZ2V0RmlsZSxcbiAgZ2V0UGF0aCxcbiAgaXNNYXJrZG93bkZpbGVcbn0gZnJvbSAnLi9maWxlLXN5c3RlbS50cyc7XG5pbXBvcnQge1xuICBwYXJzZUZyb250bWF0dGVyLFxuICBzZXRGcm9udG1hdHRlclxufSBmcm9tICcuL2Zyb250bWF0dGVyLnRzJztcbmltcG9ydCB7IHByb2Nlc3MgfSBmcm9tICcuL3ZhdWx0LnRzJztcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgYWRkQWxpYXN9LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEFkZEFsaWFzUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBhbGlhcyB0byBhZGQuXG4gICAqL1xuICByZWFkb25seSBhbGlhcz86IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIE9ic2lkaWFuIGFwcCBpbnN0YW5jZS5cbiAgICovXG4gIHJlYWRvbmx5IGFwcDogQXBwO1xuXG4gIC8qKlxuICAgKiBUaGUgcGF0aCBvciBURmlsZSBvYmplY3QgcmVwcmVzZW50aW5nIHRoZSBub3RlLlxuICAgKi9cbiAgcmVhZG9ubHkgcGF0aE9yRmlsZTogUGF0aE9yRmlsZTtcbn1cblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgZGVsZXRlQWxpYXN9LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIERlbGV0ZUFsaWFzUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBhbGlhcyB0byBkZWxldGUuXG4gICAqL1xuICByZWFkb25seSBhbGlhcz86IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIE9ic2lkaWFuIGFwcCBpbnN0YW5jZS5cbiAgICovXG4gIHJlYWRvbmx5IGFwcDogQXBwO1xuXG4gIC8qKlxuICAgKiBUaGUgcGF0aCBvciBURmlsZSBvYmplY3QgcmVwcmVzZW50aW5nIHRoZSBub3RlLlxuICAgKi9cbiAgcmVhZG9ubHkgcGF0aE9yRmlsZTogUGF0aE9yRmlsZTtcbn1cblxuLyoqXG4gKiBPcHRpb25zIGZvciB7QGxpbmsgcHJvY2Vzc0Zyb250bWF0dGVyfS5cbiAqL1xuZXhwb3J0IHR5cGUgUHJvY2Vzc0Zyb250bWF0dGVyT3B0aW9ucyA9IFByb2Nlc3NPcHRpb25zO1xuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHtAbGluayBwcm9jZXNzRnJvbnRtYXR0ZXJ9LlxuICpcbiAqIEB0eXBlUGFyYW0gQ3VzdG9tRnJvbnRtYXR0ZXIgLSBUaGUgdHlwZSBvZiBjdXN0b20gZnJvbnQgbWF0dGVyLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFByb2Nlc3NGcm9udG1hdHRlclBhcmFtczxDdXN0b21Gcm9udG1hdHRlciA9IHVua25vd24+IGV4dGVuZHMgUHJvY2Vzc0Zyb250bWF0dGVyT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBUaGUgT2JzaWRpYW4gYXBwIGluc3RhbmNlLlxuICAgKi9cbiAgcmVhZG9ubHkgYXBwOiBBcHA7XG5cbiAgLyoqXG4gICAqIEEgZnVuY3Rpb24gdGhhdCBtb2RpZmllcyB0aGUgZnJvbnQgbWF0dGVyLlxuICAgKlxuICAgKiBAcGFyYW0gZnJvbnRtYXR0ZXIgLSBUaGUgZnJvbnQgbWF0dGVyIHRvIG1vZGlmeS5cbiAgICogQHBhcmFtIGFib3J0U2lnbmFsIC0gVGhlIGFib3J0IHNpZ25hbCB0byBsaXN0ZW4gdG8uXG4gICAqIEByZXR1cm5zIEEgdmFsdWUgdGhhdCBtYXkgYmUgYG51bGxgIHRvIGFib3J0IHRoZSBwcm9jZXNzLlxuICAgKi9cbiAgZnJvbnRtYXR0ZXJGbih0aGlzOiB2b2lkLCBmcm9udG1hdHRlcjogQ29tYmluZWRGcm9udG1hdHRlcjxDdXN0b21Gcm9udG1hdHRlcj4sIGFib3J0U2lnbmFsOiBBYm9ydFNpZ25hbCk6IFByb21pc2FibGU8TWF5YmVSZXR1cm48bnVsbD4+O1xuXG4gIC8qKlxuICAgKiBUaGUgcGF0aCBvciBURmlsZSBvYmplY3QgcmVwcmVzZW50aW5nIHRoZSBub3RlLlxuICAgKi9cbiAgcmVhZG9ubHkgcGF0aE9yRmlsZTogUGF0aE9yRmlsZTtcbn1cblxuLyoqXG4gKiBBZGRzIGFuIGFsaWFzIHRvIHRoZSBmcm9udCBtYXR0ZXIgb2YgYSBnaXZlbiBmaWxlIGlmIGl0IGRvZXMgbm90IGFscmVhZHkgZXhpc3QuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIGZvciBhZGRpbmcgdGhlIGFsaWFzLlxuICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyB3aGVuIHRoZSBhbGlhcyBoYXMgYmVlbiBhZGRlZC5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGFkZEFsaWFzKHBhcmFtczogQWRkQWxpYXNQYXJhbXMpOiBQcm9taXNlPHZvaWQ+IHtcbiAgY29uc3Qge1xuICAgIGFsaWFzLFxuICAgIGFwcCxcbiAgICBwYXRoT3JGaWxlXG4gIH0gPSBwYXJhbXM7XG4gIGlmICghYWxpYXMpIHtcbiAgICByZXR1cm47XG4gIH1cblxuICBjb25zdCBmaWxlID0gZ2V0RmlsZSh7IGFwcCwgcGF0aE9yRmlsZSB9KTtcblxuICBpZiAoIWlzTWFya2Rvd25GaWxlKGZpbGUpKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGBGaWxlICR7ZmlsZS5wYXRofSBpcyBub3QgYSBtYXJrZG93biBmaWxlLmApO1xuICB9XG5cbiAgaWYgKGFsaWFzID09PSBmaWxlLmJhc2VuYW1lIHx8IGFsaWFzID09PSBmaWxlLm5hbWUpIHtcbiAgICByZXR1cm47XG4gIH1cblxuICBhd2FpdCBwcm9jZXNzRnJvbnRtYXR0ZXIoe1xuICAgIGFwcCxcbiAgICBmcm9udG1hdHRlckZuOiAoZnJvbnRtYXR0ZXIpID0+IHtcbiAgICAgIGZyb250bWF0dGVyLmFsaWFzZXMgPz89IFtdO1xuXG4gICAgICBpZiAoIWZyb250bWF0dGVyLmFsaWFzZXMuaW5jbHVkZXMoYWxpYXMpKSB7XG4gICAgICAgIGZyb250bWF0dGVyLmFsaWFzZXMucHVzaChhbGlhcyk7XG4gICAgICB9XG4gICAgfSxcbiAgICBwYXRoT3JGaWxlXG4gIH0pO1xufVxuXG4vKipcbiAqIERlbGV0ZXMgYW4gYWxpYXMgZnJvbSB0aGUgZnJvbnQgbWF0dGVyIG9mIGEgZ2l2ZW4gZmlsZSBpZiBpdCBleGlzdHMuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIGZvciBkZWxldGluZyB0aGUgYWxpYXMuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdoZW4gdGhlIGFsaWFzIGhhcyBiZWVuIGRlbGV0ZWQuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBkZWxldGVBbGlhcyhwYXJhbXM6IERlbGV0ZUFsaWFzUGFyYW1zKTogUHJvbWlzZTx2b2lkPiB7XG4gIGNvbnN0IHtcbiAgICBhbGlhcyxcbiAgICBhcHAsXG4gICAgcGF0aE9yRmlsZVxuICB9ID0gcGFyYW1zO1xuICBpZiAoIWFsaWFzKSB7XG4gICAgcmV0dXJuO1xuICB9XG5cbiAgaWYgKCFpc01hcmtkb3duRmlsZShwYXRoT3JGaWxlKSkge1xuICAgIHRocm93IG5ldyBFcnJvcihgRmlsZSAke2dldFBhdGgoYXBwLCBwYXRoT3JGaWxlKX0gaXMgbm90IGEgbWFya2Rvd24gZmlsZS5gKTtcbiAgfVxuXG4gIGF3YWl0IHByb2Nlc3NGcm9udG1hdHRlcih7XG4gICAgYXBwLFxuICAgIGZyb250bWF0dGVyRm46IChmcm9udG1hdHRlcikgPT4ge1xuICAgICAgaWYgKCFmcm9udG1hdHRlci5hbGlhc2VzKSB7XG4gICAgICAgIHJldHVybjtcbiAgICAgIH1cblxuICAgICAgZnJvbnRtYXR0ZXIuYWxpYXNlcyA9IGZyb250bWF0dGVyLmFsaWFzZXMuZmlsdGVyKChhKSA9PiBhICE9PSBhbGlhcyk7XG5cbiAgICAgIGlmIChmcm9udG1hdHRlci5hbGlhc2VzLmxlbmd0aCA9PT0gMCkge1xuICAgICAgICBkZWxldGUgZnJvbnRtYXR0ZXIuYWxpYXNlcztcbiAgICAgIH1cbiAgICB9LFxuICAgIHBhdGhPckZpbGVcbiAgfSk7XG59XG5cbi8qKlxuICogUHJvY2Vzc2VzIHRoZSBmcm9udCBtYXR0ZXIgb2YgYSBnaXZlbiBmaWxlLCBhbGxvd2luZyBtb2RpZmljYXRpb25zIHZpYSBhIHByb3ZpZGVkIGZ1bmN0aW9uLlxuICpcbiAqIEB0eXBlUGFyYW0gQ3VzdG9tRnJvbnRtYXR0ZXIgLSBUaGUgdHlwZSBvZiBjdXN0b20gZnJvbnQgbWF0dGVyLlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIGZvciBwcm9jZXNzaW5nIHRoZSBmcm9udCBtYXR0ZXIuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdoZW4gdGhlIGZyb250IG1hdHRlciBoYXMgYmVlbiBwcm9jZXNzZWQgYW5kIHNhdmVkLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gcHJvY2Vzc0Zyb250bWF0dGVyPEN1c3RvbUZyb250bWF0dGVyID0gdW5rbm93bj4ocGFyYW1zOiBQcm9jZXNzRnJvbnRtYXR0ZXJQYXJhbXM8Q3VzdG9tRnJvbnRtYXR0ZXI+KTogUHJvbWlzZTx2b2lkPiB7XG4gIGNvbnN0IHtcbiAgICBhcHAsXG4gICAgZnJvbnRtYXR0ZXJGbixcbiAgICBwYXRoT3JGaWxlLFxuICAgIC4uLm9wdGlvbnNcbiAgfSA9IHBhcmFtcztcbiAgaWYgKCFpc01hcmtkb3duRmlsZShwYXRoT3JGaWxlKSkge1xuICAgIHRocm93IG5ldyBFcnJvcihgRmlsZSAke2dldFBhdGgoYXBwLCBwYXRoT3JGaWxlKX0gaXMgbm90IGEgbWFya2Rvd24gZmlsZS5gKTtcbiAgfVxuXG4gIGF3YWl0IHByb2Nlc3Mobm9ybWFsaXplT3B0aW9uYWxQcm9wZXJ0aWVzPFByb2Nlc3NQYXJhbXM+KHtcbiAgICBhcHAsXG4gICAgYXN5bmMgbmV3Q29udGVudFByb3ZpZGVyKHsgYWJvcnRTaWduYWwsIGNvbnRlbnQgfSkge1xuICAgICAgYWJvcnRTaWduYWwudGhyb3dJZkFib3J0ZWQoKTtcblxuICAgICAgY29uc3Qgb2xkRnJvbnRtYXR0ZXIgPSBwYXJzZUZyb250bWF0dGVyPEN1c3RvbUZyb250bWF0dGVyPihjb250ZW50KTtcbiAgICAgIGNvbnN0IG5ld0Zyb250bWF0dGVyID0gcGFyc2VGcm9udG1hdHRlcjxDdXN0b21Gcm9udG1hdHRlcj4oY29udGVudCk7XG4gICAgICBjb25zdCByZXN1bHQgPSBhd2FpdCBmcm9udG1hdHRlckZuKG5ld0Zyb250bWF0dGVyLCBhYm9ydFNpZ25hbCk7XG4gICAgICBhYm9ydFNpZ25hbC50aHJvd0lmQWJvcnRlZCgpO1xuXG4gICAgICBpZiAocmVzdWx0ID09PSBudWxsKSB7XG4gICAgICAgIHJldHVybiBudWxsO1xuICAgICAgfVxuXG4gICAgICBpZiAoZGVlcEVxdWFsKG9sZEZyb250bWF0dGVyLCBuZXdGcm9udG1hdHRlcikpIHtcbiAgICAgICAgcmV0dXJuIGNvbnRlbnQ7XG4gICAgICB9XG5cbiAgICAgIHJldHVybiBzZXRGcm9udG1hdHRlcihjb250ZW50LCBuZXdGcm9udG1hdHRlcik7XG4gICAgfSxcbiAgICBwYXRoT3JGaWxlLFxuICAgIC4uLm9wdGlvbnNcbiAgfSkpO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFpQkE7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFDUDtBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFDUDtBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsT0FDSztBQUNQLFNBQVMsZUFBZTtBQStFeEIsZUFBc0IsU0FBUyxRQUF1QztBQUNwRSxRQUFNO0FBQUEsSUFDSjtBQUFBLElBQ0E7QUFBQSxJQUNBO0FBQUEsRUFDRixJQUFJO0FBQ0osTUFBSSxDQUFDLE9BQU87QUFDVjtBQUFBLEVBQ0Y7QUFFQSxRQUFNLE9BQU8sUUFBUSxFQUFFLEtBQUssV0FBVyxDQUFDO0FBRXhDLE1BQUksQ0FBQyxlQUFlLElBQUksR0FBRztBQUN6QixVQUFNLElBQUksTUFBTSxRQUFRLEtBQUssSUFBSSwwQkFBMEI7QUFBQSxFQUM3RDtBQUVBLE1BQUksVUFBVSxLQUFLLFlBQVksVUFBVSxLQUFLLE1BQU07QUFDbEQ7QUFBQSxFQUNGO0FBRUEsUUFBTSxtQkFBbUI7QUFBQSxJQUN2QjtBQUFBLElBQ0EsZUFBZSxDQUFDLGdCQUFnQjtBQUM5QixrQkFBWSxZQUFZLENBQUM7QUFFekIsVUFBSSxDQUFDLFlBQVksUUFBUSxTQUFTLEtBQUssR0FBRztBQUN4QyxvQkFBWSxRQUFRLEtBQUssS0FBSztBQUFBLE1BQ2hDO0FBQUEsSUFDRjtBQUFBLElBQ0E7QUFBQSxFQUNGLENBQUM7QUFDSDtBQVFBLGVBQXNCLFlBQVksUUFBMEM7QUFDMUUsUUFBTTtBQUFBLElBQ0o7QUFBQSxJQUNBO0FBQUEsSUFDQTtBQUFBLEVBQ0YsSUFBSTtBQUNKLE1BQUksQ0FBQyxPQUFPO0FBQ1Y7QUFBQSxFQUNGO0FBRUEsTUFBSSxDQUFDLGVBQWUsVUFBVSxHQUFHO0FBQy9CLFVBQU0sSUFBSSxNQUFNLFFBQVEsUUFBUSxLQUFLLFVBQVUsQ0FBQywwQkFBMEI7QUFBQSxFQUM1RTtBQUVBLFFBQU0sbUJBQW1CO0FBQUEsSUFDdkI7QUFBQSxJQUNBLGVBQWUsQ0FBQyxnQkFBZ0I7QUFDOUIsVUFBSSxDQUFDLFlBQVksU0FBUztBQUN4QjtBQUFBLE1BQ0Y7QUFFQSxrQkFBWSxVQUFVLFlBQVksUUFBUSxPQUFPLENBQUMsTUFBTSxNQUFNLEtBQUs7QUFFbkUsVUFBSSxZQUFZLFFBQVEsV0FBVyxHQUFHO0FBQ3BDLGVBQU8sWUFBWTtBQUFBLE1BQ3JCO0FBQUEsSUFDRjtBQUFBLElBQ0E7QUFBQSxFQUNGLENBQUM7QUFDSDtBQVNBLGVBQXNCLG1CQUFnRCxRQUFvRTtBQUN4SSxRQUFNO0FBQUEsSUFDSjtBQUFBLElBQ0E7QUFBQSxJQUNBO0FBQUEsSUFDQSxHQUFHO0FBQUEsRUFDTCxJQUFJO0FBQ0osTUFBSSxDQUFDLGVBQWUsVUFBVSxHQUFHO0FBQy9CLFVBQU0sSUFBSSxNQUFNLFFBQVEsUUFBUSxLQUFLLFVBQVUsQ0FBQywwQkFBMEI7QUFBQSxFQUM1RTtBQUVBLFFBQU0sUUFBUSw0QkFBMkM7QUFBQSxJQUN2RDtBQUFBLElBQ0EsTUFBTSxtQkFBbUIsRUFBRSxhQUFhLFFBQVEsR0FBRztBQUNqRCxrQkFBWSxlQUFlO0FBRTNCLFlBQU0saUJBQWlCLGlCQUFvQyxPQUFPO0FBQ2xFLFlBQU0saUJBQWlCLGlCQUFvQyxPQUFPO0FBQ2xFLFlBQU0sU0FBUyxNQUFNLGNBQWMsZ0JBQWdCLFdBQVc7QUFDOUQsa0JBQVksZUFBZTtBQUUzQixVQUFJLFdBQVcsTUFBTTtBQUNuQixlQUFPO0FBQUEsTUFDVDtBQUVBLFVBQUksVUFBVSxnQkFBZ0IsY0FBYyxHQUFHO0FBQzdDLGVBQU87QUFBQSxNQUNUO0FBRUEsYUFBTyxlQUFlLFNBQVMsY0FBYztBQUFBLElBQy9DO0FBQUEsSUFDQTtBQUFBLElBQ0EsR0FBRztBQUFBLEVBQ0wsQ0FBQyxDQUFDO0FBQ0o7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/obsidian/file-system.d.mts

@@ -31,6 +31,158 @@ export declare enum FileSystemType {
      */
     Folder = "folder"
 }
+/**
+ * Parameters for {@link exists}.
+ */
+export interface ExistsParams {
+    /**
+     * The Obsidian App instance.
+     */
+    readonly app: App;
+    /**
+     * Specifies whether to perform a case-insensitive search. Default is `undefined`.
+     */
+    readonly isCaseInsensitive?: boolean;
+    /**
+     * The path to check.
+     */
+    readonly path: string;
+    /**
+     * The type of the file system object to check. Default is `undefined`.
+     */
+    readonly type?: FileSystemType;
+}
+/**
+ * Parameters for {@link getAbstractFileOrNull}.
+ */
+export interface GetAbstractFileOrNullParams {
+    /**
+     * The Obsidian App instance.
+     */
+    readonly app: App;
+    /**
+     * Specifies whether to perform a case-insensitive search. Default is `false`.
+     */
+    readonly isCaseInsensitive?: boolean;
+    /**
+     * The path or abstract file to retrieve.
+     */
+    readonly pathOrFile: null | PathOrAbstractFile;
+}
+/**
+ * Parameters for {@link getAbstractFile}.
+ */
+export interface GetAbstractFileParams {
+    /**
+     * The Obsidian App instance.
+     */
+    readonly app: App;
+    /**
+     * Specifies whether to perform a case-insensitive search. Default is `false`.
+     */
+    readonly isCaseInsensitive?: boolean;
+    /**
+     * The path or abstract file to retrieve the abstract file for.
+     */
+    readonly pathOrFile: PathOrAbstractFile;
+}
+/**
+ * Parameters for {@link getFileOrNull}.
+ */
+export interface GetFileOrNullParams {
+    /**
+     * The Obsidian App instance.
+     */
+    readonly app: App;
+    /**
+     * Specifies whether to perform a case-insensitive search. Default is `false`.
+     */
+    readonly isCaseInsensitive?: boolean;
+    /**
+     * The path or file.
+     */
+    readonly pathOrFile: null | PathOrFile;
+}
+/**
+ * Parameters for {@link getFile}.
+ */
+export interface GetFileParams {
+    /**
+     * The Obsidian App instance.
+     */
+    readonly app: App;
+    /**
+     * Specifies whether to perform a case-insensitive search. Default is `false`.
+     */
+    readonly isCaseInsensitive?: boolean;
+    /**
+     * The path or file to retrieve the file for.
+     */
+    readonly pathOrFile: PathOrFile;
+    /**
+     * Whether to include a non-existing file.
+     *  If `true`, a new file is created for the provided path.
+     *  If `false`, an error is thrown if the file is not found.
+     */
+    readonly shouldIncludeNonExisting?: boolean;
+}
+/**
+ * Parameters for {@link getFolderOrNull}.
+ */
+export interface GetFolderOrNullParams {
+    /**
+     * The Obsidian App instance.
+     */
+    readonly app: App;
+    /**
+     * Specifies whether to perform a case-insensitive search. Default is `false`.
+     */
+    readonly isCaseInsensitive?: boolean;
+    /**
+     * The path or folder to retrieve the folder from.
+     */
+    readonly pathOrFolder: null | PathOrFolder;
+}
+/**
+ * Parameters for {@link getFolder}.
+ */
+export interface GetFolderParams {
+    /**
+     * The Obsidian App instance.
+     */
+    readonly app: App;
+    /**
+     * Specifies whether to perform a case-insensitive search. Default is `false`.
+     */
+    readonly isCaseInsensitive?: boolean;
+    /**
+     * The path or folder identifier.
+     */
+    readonly pathOrFolder: PathOrFolder;
+    /**
+     * Whether to allow the folder to not exist.
+     *  If `true`, a new folder is created for the provided path.
+     *  If `false`, an error is thrown if the folder is not found.
+     */
+    readonly shouldIncludeNonExisting?: boolean;
+}
+/**
+ * Parameters for {@link getMarkdownFiles}.
+ */
+export interface GetMarkdownFilesParams {
+    /**
+     * The Obsidian App instance.
+     */
+    readonly app: App;
+    /**
+     * Specifies whether to recursively search for markdown files within subfolders. Default is `false`.
+     */
+    readonly isRecursive?: boolean;
+    /**
+     * The path or folder to retrieve the markdown files from.
+     */
+    readonly pathOrFolder: PathOrFolder;
+}
 /**
  * A path or an abstract file.
  */
@@ -102,56 +254,42 @@ export declare function checkExtension(pathOrFile: null | PathOrAbstractFile, ex
 /**
  * Checks if the given path exists.
  *
- * @param app - The Obsidian App instance.
- * @param path - The path to check.
- * @param type - The type of the file system object to check. Default is `undefined`.
- * @param isCaseInsensitive - Specifies whether to perform a case-insensitive search. Default is `undefined`.
+ * @param params - The parameters for the check.
  * @returns `true` if the path exists, `false` otherwise.
  */
-export declare function exists(app: App, path: string, type?: FileSystemType, isCaseInsensitive?: boolean): boolean;
+export declare function exists(params: ExistsParams): boolean;
 /**
  * Retrieves the TAbstractFile object for the given path or abstract file.
  *
- * @param app - The App instance.
- * @param pathOrFile - The path or abstract file to retrieve the abstract file for.
- * @param isCaseInsensitive - Specifies whether to perform a case-insensitive search. Default is `false`.
+ * @param params - The parameters for the retrieval.
  * @returns The abstract file.
  * @throws Error if the abstract file is not found.
  */
-export declare function getAbstractFile(app: App, pathOrFile: PathOrAbstractFile, isCaseInsensitive?: boolean): TAbstractFile;
+export declare function getAbstractFile(params: GetAbstractFileParams): TAbstractFile;
 /**
  * Retrieves an abstract file or `null` based on the provided path or abstract file.
  *
- * @param app - The application instance.
- * @param pathOrFile - The path or abstract file to retrieve.
- * @param isCaseInsensitive - Specifies whether to perform a case-insensitive search. Default is `false`.
+ * @param params - The parameters for the retrieval.
  * @returns The abstract file if found, otherwise `null`.
  */
-export declare function getAbstractFileOrNull(app: App, pathOrFile: null | PathOrAbstractFile, isCaseInsensitive?: boolean): null | TAbstractFile;
+export declare function getAbstractFileOrNull(params: GetAbstractFileOrNullParams): null | TAbstractFile;
 /**
  * Retrieves a file based on the provided path or file.
  *
- * @param app - The Obsidian App instance.
- * @param pathOrFile - The path or file to retrieve the file for.
- * @param shouldIncludeNonExisting - Whether to include a non-existing file.
- *  If `true`, a new file is created for the provided path.
- *  If `false`, an error is thrown if the file is not found.
- * @param isCaseInsensitive - Specifies whether to perform a case-insensitive search. Default is `false`.
+ * @param params - The parameters for the retrieval.
  * @returns The file corresponding to the provided path or file.
  * @throws Error if the file is not found.
  */
-export declare function getFile(app: App, pathOrFile: PathOrFile, shouldIncludeNonExisting?: boolean, isCaseInsensitive?: boolean): TFile;
+export declare function getFile(params: GetFileParams): TFile;
 /**
  * Retrieves a file or `null` based on the provided path or file.
  * If the provided argument is already a file, it is returned as is.
  * Otherwise, the function uses the app's vault to retrieve the file by its path.
  *
- * @param app - The Obsidian App instance.
- * @param pathOrFile - The path or file.
- * @param isCaseInsensitive - Specifies whether to perform a case-insensitive search. Default is `false`.
+ * @param params - The parameters for the retrieval.
  * @returns The file if found, otherwise `null`.
  */
-export declare function getFileOrNull(app: App, pathOrFile: null | PathOrFile, isCaseInsensitive?: boolean): null | TFile;
+export declare function getFileOrNull(params: GetFileOrNullParams): null | TFile;
 /**
  * Gets the type of a file system object.
  *
@@ -163,34 +301,25 @@ export declare function getFileSystemType(abstractFile: TAbstractFile): FileSyst
 /**
  * Retrieves a folder based on the provided app and pathOrFolder.
  *
- * @param app - The Obsidian app instance.
- * @param pathOrFolder - The path or folder identifier.
- * @param shouldIncludeNonExisting - Whether to allow the folder to not exist.
- *  If `true`, a new folder is created for the provided path.
- *  If `false`, an error is thrown if the folder is not found.
- * @param isCaseInsensitive - Specifies whether to perform a case-insensitive search. Default is `false`.
+ * @param params - The parameters for the retrieval.
  * @returns The retrieved folder.
  * @throws If the folder is not found.
  */
-export declare function getFolder(app: App, pathOrFolder: PathOrFolder, shouldIncludeNonExisting?: boolean, isCaseInsensitive?: boolean): TFolder;
+export declare function getFolder(params: GetFolderParams): TFolder;
 /**
  * Retrieves a folder or `null` based on the provided path or folder.
  *
- * @param app - The Obsidian application instance.
- * @param pathOrFolder - The path or folder to retrieve the folder from.
- * @param isCaseInsensitive - Specifies whether to perform a case-insensitive search. Default is `false`.
+ * @param params - The parameters for the retrieval.
  * @returns The folder if found, otherwise `null`.
  */
-export declare function getFolderOrNull(app: App, pathOrFolder: null | PathOrFolder, isCaseInsensitive?: boolean): null | TFolder;
+export declare function getFolderOrNull(params: GetFolderOrNullParams): null | TFolder;
 /**
  * Retrieves an array of files representing the markdown files within a specified folder or path.
  *
- * @param app - The Obsidian App instance.
- * @param pathOrFolder - The path or folder to retrieve the markdown files from.
- * @param isRecursive - Optional. Specifies whether to recursively search for markdown files within subfolders. Default is `false`.
+ * @param params - The parameters for the retrieval.
  * @returns An array of files representing the markdown files.
  */
-export declare function getMarkdownFiles(app: App, pathOrFolder: PathOrFolder, isRecursive?: boolean): TFile[];
+export declare function getMarkdownFiles(params: GetMarkdownFilesParams): TFile[];
 /**
  * Retrieves the file for the given path or creates a new one if it does not exist.
  *