@mnaoumov/obsidian-lib 0.0.0 → 1.0.1

package/dist/lib/cjs/frontmatter-link-cache-with-offsets.cjs

@@ -0,0 +1,159 @@
+/*
+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"
+  };
+  const existingProcess = globalThis.process;
+  if (!existingProcess) {
+    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() {
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord["__name"] ??= keepName;
+  globalThisRecord["__extractDefault"] ??= extractDefault;
+  ensureBrowserProcess();
+  function extractDefault(module) {
+    return module && module.__esModule && "default" in module ? module.default : module;
+  }
+})();
+})();
+(function patchObsidianRequire() {
+  const originalRequire = require;
+  if (!originalRequire || originalRequire.__isPatched) {
+    return;
+  }
+  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 = /* @__PURE__ */ 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 = /* @__PURE__ */ 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);
+    }
+    if (globalThis.app.isMobile) {
+      if (id === "process" || id === "node:process") {
+        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);
+      }
+    }
+    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 frontmatter_link_cache_with_offsets_exports = {};
+__export(frontmatter_link_cache_with_offsets_exports, {
+  isFrontmatterLinkCacheWithOffsets: () => isFrontmatterLinkCacheWithOffsets,
+  toFrontmatterLinkCacheWithOffsets: () => toFrontmatterLinkCacheWithOffsets
+});
+module.exports = __toCommonJS(frontmatter_link_cache_with_offsets_exports);
+var import_implementations = require('@obsidian-typings/obsidian-public-latest/implementations');
+function isFrontmatterLinkCacheWithOffsets(reference) {
+  if (!(0, import_implementations.isFrontmatterLinkCache)(reference)) {
+    return false;
+  }
+  const frontmatterLinkCacheWithOffsets = reference;
+  return frontmatterLinkCacheWithOffsets.startOffset !== void 0 && frontmatterLinkCacheWithOffsets.endOffset !== void 0;
+}
+function toFrontmatterLinkCacheWithOffsets(reference) {
+  return isFrontmatterLinkCacheWithOffsets(reference) ? reference : {
+    ...reference,
+    endOffset: reference.original.length,
+    startOffset: 0
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isFrontmatterLinkCacheWithOffsets,
+  toFrontmatterLinkCacheWithOffsets
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2Zyb250bWF0dGVyLWxpbmstY2FjaGUtd2l0aC1vZmZzZXRzLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogVGhpcyBtb2R1bGUgcHJvdmlkZXMgYSB0eXBlIGZvciBmcm9udG1hdHRlciBsaW5rIGNhY2hlIHdpdGggb2Zmc2V0cy5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7XG4gIEZyb250bWF0dGVyTGlua0NhY2hlLFxuICBSZWZlcmVuY2Vcbn0gZnJvbSAnb2JzaWRpYW4nO1xuXG5pbXBvcnQgeyBpc0Zyb250bWF0dGVyTGlua0NhY2hlIH0gZnJvbSAnQG9ic2lkaWFuLXR5cGluZ3Mvb2JzaWRpYW4tcHVibGljLWxhdGVzdC9pbXBsZW1lbnRhdGlvbnMnO1xuXG4vKipcbiAqIFR5cGUgZm9yIGZyb250bWF0dGVyIGxpbmsgY2FjaGUgd2l0aCBvZmZzZXRzLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEZyb250bWF0dGVyTGlua0NhY2hlV2l0aE9mZnNldHMgZXh0ZW5kcyBGcm9udG1hdHRlckxpbmtDYWNoZSB7XG4gIC8qKlxuICAgKiBBbiBlbmQgb2Zmc2V0IG9mIHRoZSBsaW5rIGluIHRoZSBwcm9wZXJ0eSB2YWx1ZS5cbiAgICovXG4gIGVuZE9mZnNldDogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBBIHN0YXJ0IG9mZnNldCBvZiB0aGUgbGluayBpbiB0aGUgcHJvcGVydHkgdmFsdWUuXG4gICAqL1xuICBzdGFydE9mZnNldDogbnVtYmVyO1xufVxuXG4vKipcbiAqIENoZWNrcyBpZiB0aGUgcmVmZXJlbmNlIGlzIGEgZnJvbnRtYXR0ZXIgbGluayBjYWNoZSB3aXRoIG9mZnNldHMuXG4gKlxuICogQHBhcmFtIHJlZmVyZW5jZSAtIFRoZSByZWZlcmVuY2UgdG8gY2hlY2suXG4gKiBAcmV0dXJucyBXaGV0aGVyIHRoZSByZWZlcmVuY2UgaXMgYSBmcm9udG1hdHRlciBsaW5rIGNhY2hlIHdpdGggb2Zmc2V0cy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzRnJvbnRtYXR0ZXJMaW5rQ2FjaGVXaXRoT2Zmc2V0cyhyZWZlcmVuY2U6IFJlZmVyZW5jZSk6IHJlZmVyZW5jZSBpcyBGcm9udG1hdHRlckxpbmtDYWNoZVdpdGhPZmZzZXRzIHtcbiAgaWYgKCFpc0Zyb250bWF0dGVyTGlua0NhY2hlKHJlZmVyZW5jZSkpIHtcbiAgICByZXR1cm4gZmFsc2U7XG4gIH1cblxuICBjb25zdCBmcm9udG1hdHRlckxpbmtDYWNoZVdpdGhPZmZzZXRzID0gcmVmZXJlbmNlIGFzIFBhcnRpYWw8RnJvbnRtYXR0ZXJMaW5rQ2FjaGVXaXRoT2Zmc2V0cz47XG4gIHJldHVybiBmcm9udG1hdHRlckxpbmtDYWNoZVdpdGhPZmZzZXRzLnN0YXJ0T2Zmc2V0ICE9PSB1bmRlZmluZWQgJiYgZnJvbnRtYXR0ZXJMaW5rQ2FjaGVXaXRoT2Zmc2V0cy5lbmRPZmZzZXQgIT09IHVuZGVmaW5lZDtcbn1cblxuLyoqXG4gKiBDb252ZXJ0cyBhIGZyb250bWF0dGVyIGxpbmsgY2FjaGUgdG8gYSBmcm9udG1hdHRlciBsaW5rIGNhY2hlIHdpdGggb2Zmc2V0cy5cbiAqXG4gKiBAcGFyYW0gcmVmZXJlbmNlIC0gVGhlIHJlZmVyZW5jZSB0byBjb252ZXJ0LlxuICogQHJldHVybnMgVGhlIGNvbnZlcnRlZCByZWZlcmVuY2UuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB0b0Zyb250bWF0dGVyTGlua0NhY2hlV2l0aE9mZnNldHMocmVmZXJlbmNlOiBGcm9udG1hdHRlckxpbmtDYWNoZSk6IEZyb250bWF0dGVyTGlua0NhY2hlV2l0aE9mZnNldHMge1xuICByZXR1cm4gaXNGcm9udG1hdHRlckxpbmtDYWNoZVdpdGhPZmZzZXRzKHJlZmVyZW5jZSlcbiAgICA/IHJlZmVyZW5jZVxuICAgIDoge1xuICAgICAgLi4ucmVmZXJlbmNlLFxuICAgICAgZW5kT2Zmc2V0OiByZWZlcmVuY2Uub3JpZ2luYWwubGVuZ3RoLFxuICAgICAgc3RhcnRPZmZzZXQ6IDBcbiAgICB9O1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBV0EsNkJBQXVDO0FBdUJoQyxTQUFTLGtDQUFrQyxXQUFvRTtBQUNwSCxNQUFJLEtBQUMsK0NBQXVCLFNBQVMsR0FBRztBQUN0QyxXQUFPO0FBQUEsRUFDVDtBQUVBLFFBQU0sa0NBQWtDO0FBQ3hDLFNBQU8sZ0NBQWdDLGdCQUFnQixVQUFhLGdDQUFnQyxjQUFjO0FBQ3BIO0FBUU8sU0FBUyxrQ0FBa0MsV0FBa0U7QUFDbEgsU0FBTyxrQ0FBa0MsU0FBUyxJQUM5QyxZQUNBO0FBQUEsSUFDQSxHQUFHO0FBQUEsSUFDSCxXQUFXLFVBQVUsU0FBUztBQUFBLElBQzlCLGFBQWE7QUFBQSxFQUNmO0FBQ0o7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/cjs/frontmatter-link-cache-with-offsets.d.cts

@@ -0,0 +1,34 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * This module provides a type for frontmatter link cache with offsets.
+ */
+import type { FrontmatterLinkCache, Reference } from 'obsidian' with { 'resolution-mode': 'import' };
+/**
+ * Type for frontmatter link cache with offsets.
+ */
+export interface FrontmatterLinkCacheWithOffsets extends FrontmatterLinkCache {
+    /**
+     * An end offset of the link in the property value.
+     */
+    endOffset: number;
+    /**
+     * A start offset of the link in the property value.
+     */
+    startOffset: number;
+}
+/**
+ * Checks if the reference is a frontmatter link cache with offsets.
+ *
+ * @param reference - The reference to check.
+ * @returns Whether the reference is a frontmatter link cache with offsets.
+ */
+export declare function isFrontmatterLinkCacheWithOffsets(reference: Reference): reference is FrontmatterLinkCacheWithOffsets;
+/**
+ * Converts a frontmatter link cache to a frontmatter link cache with offsets.
+ *
+ * @param reference - The reference to convert.
+ * @returns The converted reference.
+ */
+export declare function toFrontmatterLinkCacheWithOffsets(reference: FrontmatterLinkCache): FrontmatterLinkCacheWithOffsets;

package/dist/lib/cjs/frontmatter.cjs

@@ -0,0 +1,271 @@
+/*
+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"
+  };
+  const existingProcess = globalThis.process;
+  if (!existingProcess) {
+    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() {
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord["__name"] ??= keepName;
+  globalThisRecord["__extractDefault"] ??= extractDefault;
+  ensureBrowserProcess();
+  function extractDefault(module) {
+    return module && module.__esModule && "default" in module ? module.default : module;
+  }
+})();
+})();
+(function patchObsidianRequire() {
+  const originalRequire = require;
+  if (!originalRequire || originalRequire.__isPatched) {
+    return;
+  }
+  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 = /* @__PURE__ */ 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 = /* @__PURE__ */ 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);
+    }
+    if (globalThis.app.isMobile) {
+      if (id === "process" || id === "node:process") {
+        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);
+      }
+    }
+    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 frontmatter_exports = {};
+__export(frontmatter_exports, {
+  checkIsPlainObject: () => checkIsPlainObject,
+  parseFrontmatter: () => parseFrontmatter,
+  registerFrontmatterFormattingPreserver: () => registerFrontmatterFormattingPreserver,
+  removeEmptyFrontmatterValues: () => removeEmptyFrontmatterValues,
+  setFrontmatter: () => setFrontmatter
+});
+module.exports = __toCommonJS(frontmatter_exports);
+var import_array = require('@mnaoumov/typescript-lib/array');
+var import_error = require('@mnaoumov/typescript-lib/error');
+var import_string = require('@mnaoumov/typescript-lib/string');
+var import_obsidian = require('obsidian');
+var import_obsidian_dev_utils_state = require('./obsidian-dev-utils-state.cjs');
+const FRONTMATTER_FORMATTING_PRESERVER_STATE_KEY = "frontmatterFormattingPreserver";
+const KEY_PATH_SEPARATOR = ".";
+class EmptyFrontmatterValueRemover {
+  removedKeyPaths = [];
+  shouldRemoveEmptyArrays;
+  shouldRemoveEmptyObjects;
+  shouldRemoveNulls;
+  /**
+   * Creates a new remover, resolving the provided options against the defaults.
+   *
+   * @param params - The parameters for removing the empty front matter values.
+   */
+  constructor(params) {
+    this.shouldRemoveEmptyArrays = params.shouldRemoveEmptyArrays ?? false;
+    this.shouldRemoveEmptyObjects = params.shouldRemoveEmptyObjects ?? false;
+    this.shouldRemoveNulls = params.shouldRemoveNulls ?? false;
+  }
+  /**
+   * Removes the empty values from the given front matter object, modifying it in place.
+   *
+   * @param frontmatter - The front matter object to remove the empty values from.
+   * @returns The key paths of the removed values, in the order they were removed.
+   */
+  remove(frontmatter) {
+    this.pruneObject(frontmatter, "");
+    return this.removedKeyPaths;
+  }
+  checkIsEmpty(value) {
+    if (value === "") {
+      return true;
+    }
+    if (value === null || value === void 0) {
+      return this.shouldRemoveNulls;
+    }
+    return Array.isArray(value) ? value.length === 0 && this.shouldRemoveEmptyArrays : checkIsPlainObject(value) && Object.keys(value).length === 0 && this.shouldRemoveEmptyObjects;
+  }
+  joinKeyPath(keyPath, key) {
+    return keyPath ? `${keyPath}${KEY_PATH_SEPARATOR}${key}` : key;
+  }
+  prune(value, keyPath) {
+    if (Array.isArray(value)) {
+      this.pruneArray(value, keyPath);
+    } else if (checkIsPlainObject(value)) {
+      this.pruneObject(value, keyPath);
+    }
+  }
+  pruneArray(array, keyPath) {
+    (0, import_array.filterInPlace)(array, (item, index) => {
+      const itemKeyPath = this.joinKeyPath(keyPath, String(index));
+      this.prune(item, itemKeyPath);
+      if (!this.checkIsEmpty(item)) {
+        return true;
+      }
+      this.removedKeyPaths.push(itemKeyPath);
+      return false;
+    });
+  }
+  pruneObject($object, keyPath) {
+    for (const [key, value] of Object.entries($object)) {
+      const valueKeyPath = this.joinKeyPath(keyPath, key);
+      this.prune(value, valueKeyPath);
+      if (!this.checkIsEmpty(value)) {
+        continue;
+      }
+      this.removedKeyPaths.push(valueKeyPath);
+      delete $object[key];
+    }
+  }
+}
+function checkIsPlainObject(value) {
+  return typeof value === "object" && value !== null && Object.getPrototypeOf(value) === Object.prototype;
+}
+function parseFrontmatter(content) {
+  const frontmatterInfo = (0, import_obsidian.getFrontMatterInfo)(content);
+  return (0, import_obsidian.parseYaml)(frontmatterInfo.frontmatter) ?? {};
+}
+function registerFrontmatterFormattingPreserver(preserver) {
+  getFrontmatterFormattingPreserverWrapper().value = preserver;
+}
+function removeEmptyFrontmatterValues(params) {
+  return new EmptyFrontmatterValueRemover(params).remove(params.frontmatter);
+}
+function setFrontmatter(content, newFrontmatter) {
+  const preservedContent = preserveFormatting(content, newFrontmatter);
+  if (preservedContent !== null) {
+    return preservedContent;
+  }
+  const frontmatterInfo = (0, import_obsidian.getFrontMatterInfo)(content);
+  if (Object.keys(newFrontmatter).length === 0) {
+    return content.slice(frontmatterInfo.contentStart);
+  }
+  const newFrontmatterString = (0, import_obsidian.stringifyYaml)(newFrontmatter);
+  return frontmatterInfo.exists ? (0, import_string.insertAt)({
+    $string: content,
+    endIndex: frontmatterInfo.to,
+    startIndex: frontmatterInfo.from,
+    substring: newFrontmatterString
+  }) : `---
+${newFrontmatterString}---
+${content}`;
+}
+function getFrontmatterFormattingPreserverWrapper() {
+  return (0, import_obsidian_dev_utils_state.getObsidianDevUtilsState)(FRONTMATTER_FORMATTING_PRESERVER_STATE_KEY, null);
+}
+function preserveFormatting(content, newFrontmatter) {
+  const preserver = getFrontmatterFormattingPreserverWrapper().value;
+  if (!preserver) {
+    return null;
+  }
+  try {
+    return preserver(content, newFrontmatter);
+  } catch (error) {
+    (0, import_error.printError)(new Error("The registered front matter formatting preserver threw. Falling back to rewriting the whole block.", { cause: error }));
+    return null;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  checkIsPlainObject,
+  parseFrontmatter,
+  registerFrontmatterFormattingPreserver,
+  removeEmptyFrontmatterValues,
+  setFrontmatter
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2Zyb250bWF0dGVyLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogVGhpcyBtb2R1bGUgcHJvdmlkZXMgdXRpbGl0eSBmdW5jdGlvbnMgZm9yIHByb2Nlc3NpbmcgYW5kIG1hbmFnaW5nIFlBTUwgZnJvbnQgbWF0dGVyIGluIE9ic2lkaWFuIG5vdGVzLlxuICovXG5cbmltcG9ydCB0eXBlIHsgR2VuZXJpY09iamVjdCB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi90eXBlLWd1YXJkcyc7XG5pbXBvcnQgdHlwZSB7IFZhbHVlV3JhcHBlciB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi92YWx1ZS13cmFwcGVyJztcblxuaW1wb3J0IHsgZmlsdGVySW5QbGFjZSB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9hcnJheSc7XG5pbXBvcnQgeyBwcmludEVycm9yIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL2Vycm9yJztcbmltcG9ydCB7IGluc2VydEF0IH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL3N0cmluZyc7XG5pbXBvcnQge1xuICBnZXRGcm9udE1hdHRlckluZm8sXG4gIHBhcnNlWWFtbCxcbiAgc3RyaW5naWZ5WWFtbFxufSBmcm9tICdvYnNpZGlhbic7XG5cbmltcG9ydCB7IGdldE9ic2lkaWFuRGV2VXRpbHNTdGF0ZSB9IGZyb20gJy4vb2JzaWRpYW4tZGV2LXV0aWxzLXN0YXRlLnRzJztcblxuLyoqXG4gKiBBIGNvbWJpbmVkIGZyb250IG1hdHRlciBvZiBhIGRvY3VtZW50LlxuICogSXQgaXMgYSB1bmlvbiBvZiBjdXN0b20gZnJvbnQgbWF0dGVyLCBPYnNpZGlhbiBmcm9udCBtYXR0ZXIsIGFuZCBhZGRpdGlvbmFsIHByb3BlcnRpZXMuXG4gKlxuICogQHR5cGVQYXJhbSBDdXN0b21Gcm9udG1hdHRlciAtIFRoZSB0eXBlIG9mIGN1c3RvbSBmcm9udCBtYXR0ZXIuXG4gKi9cbmV4cG9ydCB0eXBlIENvbWJpbmVkRnJvbnRtYXR0ZXI8Q3VzdG9tRnJvbnRtYXR0ZXI+ID0gR2VuZXJpY09iamVjdDxDdXN0b21Gcm9udG1hdHRlciAmIE9ic2lkaWFuRnJvbnRtYXR0ZXI+O1xuXG4vKipcbiAqIEEgcmV3cml0ZSBvZiBhIG5vdGUncyBmcm9udCBtYXR0ZXIgdGhhdCBrZWVwcyB0aGUgYXV0aG9yJ3Mgb3JpZ2luYWwgZm9ybWF0dGluZyB3aGVyZXZlciB0aGUgY2hhbmdlIGRvZXMgbm90IHJlYWNoIGl0LlxuICpcbiAqIEl0IGlzIGhhbmRlZCB0aGUgd2hvbGUgbm90ZSBhbmQgdGhlIGZyb250IG1hdHRlciB0byB3cml0ZSwgYW5kIHJldHVybnMgdGhlIHdob2xlIG5ldyBub3RlIFx1MjAxNCBvciBgbnVsbGAgd2hlbiBpdCBjYW5ub3QgYmUgZmFpdGhmdWwsIHdoaWNoIGhhbmRzIHRoZSB3cml0ZSBiYWNrIHRvIHtAbGluayBzZXRGcm9udG1hdHRlcn0ncyBvd24gcGFyc2UtYW5kLXN0cmluZ2lmeSBwYXRoLiBSZXR1cm5pbmcgYG51bGxgIGlzIG5ldmVyIGFuIGVycm9yOiBpdCBpcyBob3cgdGhlIHByZXNlcnZlciBndWFyYW50ZWVzIGl0IGNhbiBvbmx5IGV2ZXIgbWF0Y2ggb3IgaW1wcm92ZSBvbiB0aGF0IHBhdGgsIG5ldmVyIGRvIHdvcnNlIHRoYW4gaXQuXG4gKlxuICogQHBhcmFtIGNvbnRlbnQgLSBUaGUgbm90ZSB0byByZXdyaXRlIHRoZSBmcm9udCBtYXR0ZXIgb2YuXG4gKiBAcGFyYW0gbmV3RnJvbnRtYXR0ZXIgLSBUaGUgZnJvbnQgbWF0dGVyIHRvIHdyaXRlLlxuICogQHJldHVybnMgVGhlIG5ldyBub3RlLCBvciBgbnVsbGAgdG8gbGV0IHtAbGluayBzZXRGcm9udG1hdHRlcn0gd3JpdGUgaXQgaW5zdGVhZC5cbiAqL1xuZXhwb3J0IHR5cGUgRnJvbnRtYXR0ZXJGb3JtYXR0aW5nUHJlc2VydmVyID0gKHRoaXM6IHZvaWQsIGNvbnRlbnQ6IHN0cmluZywgbmV3RnJvbnRtYXR0ZXI6IG9iamVjdCkgPT4gbnVsbCB8IHN0cmluZztcblxuLyoqXG4gKiBBIGZyb250IG1hdHRlciBvZiBhbiBPYnNpZGlhbiBmaWxlLlxuICpcbiAqIEBzZWUge0BsaW5rIGh0dHBzOi8vaGVscC5vYnNpZGlhbi5tZC9FZGl0aW5nK2FuZCtmb3JtYXR0aW5nL1Byb3BlcnRpZXMjRGVmYXVsdCtwcm9wZXJ0aWVzfVxuICovXG5leHBvcnQgaW50ZXJmYWNlIE9ic2lkaWFuRnJvbnRtYXR0ZXIge1xuICAvKipcbiAgICogQW4gYXJyYXkgb2YgYWxpYXNlcyBmb3IgdGhlIG5vdGUuXG4gICAqL1xuICBhbGlhc2VzPzogc3RyaW5nW107XG5cbiAgLyoqXG4gICAqIEFuIGFycmF5IG9mIENTUyBjbGFzc2VzIHRvIGFwcGx5IHRvIHRoZSBub3RlLlxuICAgKi9cbiAgY3NzY2xhc3Nlcz86IHN0cmluZ1tdO1xuXG4gIC8qKlxuICAgKiBBbiBhcnJheSBvZiB0YWdzIGZvciB0aGUgbm90ZS5cbiAgICovXG4gIHRhZ3M/OiBzdHJpbmdbXTtcbn1cblxuLyoqXG4gKiBBIGZyb250IG1hdHRlciBmb3IgcHVibGlzaGluZyBpbiBPYnNpZGlhbi5cbiAqXG4gKiBAc2VlIHtAbGluayBodHRwczovL2hlbHAub2JzaWRpYW4ubWQvRWRpdGluZythbmQrZm9ybWF0dGluZy9Qcm9wZXJ0aWVzI1Byb3BlcnRpZXMrZm9yK09ic2lkaWFuK1B1Ymxpc2h9XG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgT2JzaWRpYW5QdWJsaXNoRnJvbnRtYXR0ZXIge1xuICAvKipcbiAgICogQSBjb3ZlciBpbWFnZSBmb3IgdGhlIG5vdGUuXG4gICAqL1xuICBjb3Zlcj86IHN0cmluZztcblxuICAvKipcbiAgICogQSBkZXNjcmlwdGlvbiBmb3IgdGhlIG5vdGUuXG4gICAqL1xuICBkZXNjcmlwdGlvbj86IHN0cmluZztcblxuICAvKipcbiAgICogQW4gaW1hZ2UgZm9yIHRoZSBub3RlLlxuICAgKi9cbiAgaW1hZ2U/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIEEgcGVybWFuZW50IGxpbmsgZm9yIHRoZSBub3RlLlxuICAgKi9cbiAgcGVybWFsaW5rPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBXaGV0aGVyIHRoZSBub3RlIGlzIHB1Ymxpc2hlZC5cbiAgICovXG4gIHB1Ymxpc2g/OiBib29sZWFuO1xufVxuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHtAbGluayByZW1vdmVFbXB0eUZyb250bWF0dGVyVmFsdWVzfS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBSZW1vdmVFbXB0eUZyb250bWF0dGVyVmFsdWVzUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBmcm9udCBtYXR0ZXIgb2JqZWN0IHRvIHJlbW92ZSB0aGUgZW1wdHkgdmFsdWVzIGZyb20uIEl0IGlzIG1vZGlmaWVkIGluIHBsYWNlLlxuICAgKi9cbiAgcmVhZG9ubHkgZnJvbnRtYXR0ZXI6IEdlbmVyaWNPYmplY3Q7XG5cbiAgLyoqXG4gICAqIFdoZXRoZXIgdG8gcmVtb3ZlIGFycmF5cyB0aGF0IGFyZSBlbXB0eSwgaW5jbHVkaW5nIHRoZSBvbmVzIHRoYXQgYmVjYW1lIGVtcHR5IGFmdGVyIHRoZWlyIG93biBpdGVtcyB3ZXJlIHJlbW92ZWQuXG4gICAqXG4gICAqIEBkZWZhdWx0IGBmYWxzZWBcbiAgICovXG4gIHJlYWRvbmx5IHNob3VsZFJlbW92ZUVtcHR5QXJyYXlzPzogYm9vbGVhbjtcblxuICAvKipcbiAgICogV2hldGhlciB0byByZW1vdmUgcGxhaW4gb2JqZWN0cyB0aGF0IGFyZSBlbXB0eSwgaW5jbHVkaW5nIHRoZSBvbmVzIHRoYXQgYmVjYW1lIGVtcHR5IGFmdGVyIHRoZWlyIG93biBwcm9wZXJ0aWVzIHdlcmUgcmVtb3ZlZC5cbiAgICpcbiAgICogQGRlZmF1bHQgYGZhbHNlYFxuICAgKi9cbiAgcmVhZG9ubHkgc2hvdWxkUmVtb3ZlRW1wdHlPYmplY3RzPzogYm9vbGVhbjtcblxuICAvKipcbiAgICogV2hldGhlciB0byByZW1vdmUgYG51bGxgIGFuZCBgdW5kZWZpbmVkYCB2YWx1ZXMuIEJvdGggYXJlIHRyZWF0ZWQgdGhlIHNhbWU6IHRoZXkgYXJlIHRoZSB0d28gd2F5cyBhIGtleSBjYW4gYmUgcHJlc2VudCBidXQgY2Fycnkgbm8gdmFsdWUsIGFuZCBgdW5kZWZpbmVkYCBjYW5ub3Qgc3Vydml2ZSBhIFlBTUwgcm91bmQtdHJpcCBhbnl3YXkuXG4gICAqXG4gICAqIEBkZWZhdWx0IGBmYWxzZWBcbiAgICovXG4gIHJlYWRvbmx5IHNob3VsZFJlbW92ZU51bGxzPzogYm9vbGVhbjtcbn1cblxuY29uc3QgRlJPTlRNQVRURVJfRk9STUFUVElOR19QUkVTRVJWRVJfU1RBVEVfS0VZID0gJ2Zyb250bWF0dGVyRm9ybWF0dGluZ1ByZXNlcnZlcic7XG5jb25zdCBLRVlfUEFUSF9TRVBBUkFUT1IgPSAnLic7XG5cbi8qKlxuICogUmVtb3ZlcyBlbXB0eSB2YWx1ZXMgZnJvbSBhIGZyb250IG1hdHRlciBvYmplY3QsIHJlY3Vyc2luZyBpbnRvIG5lc3RlZCBvYmplY3RzIGFuZCBhcnJheXMuXG4gKlxuICogVGhlIHRyYXZlcnNhbCBpcyBib3R0b20tdXA6IGEgY29udGFpbmVyIGlzIHBydW5lZCBiZWZvcmUgaXQgaXMgaXRzZWxmIHRlc3RlZCBmb3IgZW1wdGluZXNzLCBzbyBhIGNvbnRhaW5lciB0aGF0IGhvbGRzIG5vdGhpbmcgYnV0IGVtcHR5IHZhbHVlcyBpcyByZW1vdmVkIGFzIHdlbGwgd2hlbiB0aGUgbWF0Y2hpbmcgb3B0aW9uIGlzIGVuYWJsZWQuXG4gKi9cbmNsYXNzIEVtcHR5RnJvbnRtYXR0ZXJWYWx1ZVJlbW92ZXIge1xuICBwcml2YXRlIHJlYWRvbmx5IHJlbW92ZWRLZXlQYXRoczogc3RyaW5nW10gPSBbXTtcbiAgcHJpdmF0ZSByZWFkb25seSBzaG91bGRSZW1vdmVFbXB0eUFycmF5czogYm9vbGVhbjtcbiAgcHJpdmF0ZSByZWFkb25seSBzaG91bGRSZW1vdmVFbXB0eU9iamVjdHM6IGJvb2xlYW47XG4gIHByaXZhdGUgcmVhZG9ubHkgc2hvdWxkUmVtb3ZlTnVsbHM6IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgcmVtb3ZlciwgcmVzb2x2aW5nIHRoZSBwcm92aWRlZCBvcHRpb25zIGFnYWluc3QgdGhlIGRlZmF1bHRzLlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBhcmFtZXRlcnMgZm9yIHJlbW92aW5nIHRoZSBlbXB0eSBmcm9udCBtYXR0ZXIgdmFsdWVzLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHBhcmFtczogUmVtb3ZlRW1wdHlGcm9udG1hdHRlclZhbHVlc1BhcmFtcykge1xuICAgIHRoaXMuc2hvdWxkUmVtb3ZlRW1wdHlBcnJheXMgPSBwYXJhbXMuc2hvdWxkUmVtb3ZlRW1wdHlBcnJheXMgPz8gZmFsc2U7XG4gICAgdGhpcy5zaG91bGRSZW1vdmVFbXB0eU9iamVjdHMgPSBwYXJhbXMuc2hvdWxkUmVtb3ZlRW1wdHlPYmplY3RzID8/IGZhbHNlO1xuICAgIHRoaXMuc2hvdWxkUmVtb3ZlTnVsbHMgPSBwYXJhbXMuc2hvdWxkUmVtb3ZlTnVsbHMgPz8gZmFsc2U7XG4gIH1cblxuICAvKipcbiAgICogUmVtb3ZlcyB0aGUgZW1wdHkgdmFsdWVzIGZyb20gdGhlIGdpdmVuIGZyb250IG1hdHRlciBvYmplY3QsIG1vZGlmeWluZyBpdCBpbiBwbGFjZS5cbiAgICpcbiAgICogQHBhcmFtIGZyb250bWF0dGVyIC0gVGhlIGZyb250IG1hdHRlciBvYmplY3QgdG8gcmVtb3ZlIHRoZSBlbXB0eSB2YWx1ZXMgZnJvbS5cbiAgICogQHJldHVybnMgVGhlIGtleSBwYXRocyBvZiB0aGUgcmVtb3ZlZCB2YWx1ZXMsIGluIHRoZSBvcmRlciB0aGV5IHdlcmUgcmVtb3ZlZC5cbiAgICovXG4gIHB1YmxpYyByZW1vdmUoZnJvbnRtYXR0ZXI6IEdlbmVyaWNPYmplY3QpOiBzdHJpbmdbXSB7XG4gICAgdGhpcy5wcnVuZU9iamVjdChmcm9udG1hdHRlciwgJycpO1xuICAgIHJldHVybiB0aGlzLnJlbW92ZWRLZXlQYXRocztcbiAgfVxuXG4gIHByaXZhdGUgY2hlY2tJc0VtcHR5KHZhbHVlOiB1bmtub3duKTogYm9vbGVhbiB7XG4gICAgaWYgKHZhbHVlID09PSAnJykge1xuICAgICAgcmV0dXJuIHRydWU7XG4gICAgfVxuXG4gICAgaWYgKHZhbHVlID09PSBudWxsIHx8IHZhbHVlID09PSB1bmRlZmluZWQpIHtcbiAgICAgIHJldHVybiB0aGlzLnNob3VsZFJlbW92ZU51bGxzO1xuICAgIH1cblxuICAgIHJldHVybiBBcnJheS5pc0FycmF5KHZhbHVlKVxuICAgICAgPyB2YWx1ZS5sZW5ndGggPT09IDAgJiYgdGhpcy5zaG91bGRSZW1vdmVFbXB0eUFycmF5c1xuICAgICAgOiBjaGVja0lzUGxhaW5PYmplY3QodmFsdWUpICYmIE9iamVjdC5rZXlzKHZhbHVlKS5sZW5ndGggPT09IDAgJiYgdGhpcy5zaG91bGRSZW1vdmVFbXB0eU9iamVjdHM7XG4gIH1cblxuICBwcml2YXRlIGpvaW5LZXlQYXRoKGtleVBhdGg6IHN0cmluZywga2V5OiBzdHJpbmcpOiBzdHJpbmcge1xuICAgIHJldHVybiBrZXlQYXRoID8gYCR7a2V5UGF0aH0ke0tFWV9QQVRIX1NFUEFSQVRPUn0ke2tleX1gIDoga2V5O1xuICB9XG5cbiAgcHJpdmF0ZSBwcnVuZSh2YWx1ZTogdW5rbm93biwga2V5UGF0aDogc3RyaW5nKTogdm9pZCB7XG4gICAgaWYgKEFycmF5LmlzQXJyYXkodmFsdWUpKSB7XG4gICAgICB0aGlzLnBydW5lQXJyYXkodmFsdWUsIGtleVBhdGgpO1xuICAgIH0gZWxzZSBpZiAoY2hlY2tJc1BsYWluT2JqZWN0KHZhbHVlKSkge1xuICAgICAgdGhpcy5wcnVuZU9iamVjdCh2YWx1ZSwga2V5UGF0aCk7XG4gICAgfVxuICB9XG5cbiAgcHJpdmF0ZSBwcnVuZUFycmF5KGFycmF5OiB1bmtub3duW10sIGtleVBhdGg6IHN0cmluZyk6IHZvaWQge1xuICAgIGZpbHRlckluUGxhY2UoYXJyYXksIChpdGVtLCBpbmRleCkgPT4ge1xuICAgICAgY29uc3QgaXRlbUtleVBhdGggPSB0aGlzLmpvaW5LZXlQYXRoKGtleVBhdGgsIFN0cmluZyhpbmRleCkpO1xuICAgICAgdGhpcy5wcnVuZShpdGVtLCBpdGVtS2V5UGF0aCk7XG4gICAgICBpZiAoIXRoaXMuY2hlY2tJc0VtcHR5KGl0ZW0pKSB7XG4gICAgICAgIHJldHVybiB0cnVlO1xuICAgICAgfVxuXG4gICAgICB0aGlzLnJlbW92ZWRLZXlQYXRocy5wdXNoKGl0ZW1LZXlQYXRoKTtcbiAgICAgIHJldHVybiBmYWxzZTtcbiAgICB9KTtcbiAgfVxuXG4gIHByaXZhdGUgcHJ1bmVPYmplY3QoJG9iamVjdDogR2VuZXJpY09iamVjdCwga2V5UGF0aDogc3RyaW5nKTogdm9pZCB7XG4gICAgZm9yIChjb25zdCBba2V5LCB2YWx1ZV0gb2YgT2JqZWN0LmVudHJpZXMoJG9iamVjdCkpIHtcbiAgICAgIGNvbnN0IHZhbHVlS2V5UGF0aCA9IHRoaXMuam9pbktleVBhdGgoa2V5UGF0aCwga2V5KTtcbiAgICAgIHRoaXMucHJ1bmUodmFsdWUsIHZhbHVlS2V5UGF0aCk7XG4gICAgICBpZiAoIXRoaXMuY2hlY2tJc0VtcHR5KHZhbHVlKSkge1xuICAgICAgICBjb250aW51ZTtcbiAgICAgIH1cblxuICAgICAgdGhpcy5yZW1vdmVkS2V5UGF0aHMucHVzaCh2YWx1ZUtleVBhdGgpO1xuICAgICAgLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby1keW5hbWljLWRlbGV0ZSAtLSBXZSBoYXZlIG5vIG90aGVyIHdheSB0byBkZWxldGUgdGhlIHByb3BlcnR5LlxuICAgICAgZGVsZXRlICRvYmplY3Rba2V5XTtcbiAgICB9XG4gIH1cbn1cblxuLyoqXG4gKiBDaGVja3Mgd2hldGhlciB0aGUgdmFsdWUgaXMgYSBwbGFpbiBvYmplY3QsIGkuZS4gYW4gb2JqZWN0IGxpdGVyYWwgcmF0aGVyIHRoYW4gYW4gYXJyYXkgb3IgYSBjbGFzcyBpbnN0YW5jZS5cbiAqXG4gKiBgcGFyc2VZYW1sKClgIHR1cm5zIGEgWUFNTCB0aW1lc3RhbXAgaW50byBhIHtAbGluayBEYXRlfSwgd2hpY2ggaGFzIG5vIG93biBlbnVtZXJhYmxlIHByb3BlcnRpZXMsIHNvIGEgcGxhaW4gYHR5cGVvZiB2YWx1ZSA9PT0gJ29iamVjdCdgIHRlc3Qgd291bGQgcmVwb3J0IGV2ZXJ5IGRhdGUgYXMgYW4gZW1wdHkgb2JqZWN0LlxuICpcbiAqIEBwYXJhbSB2YWx1ZSAtIFRoZSB2YWx1ZSB0byBjaGVjay5cbiAqIEByZXR1cm5zIFdoZXRoZXIgdGhlIHZhbHVlIGlzIGEgcGxhaW4gb2JqZWN0LlxuICovXG5leHBvcnQgZnVuY3Rpb24gY2hlY2tJc1BsYWluT2JqZWN0KHZhbHVlOiB1bmtub3duKTogdmFsdWUgaXMgR2VuZXJpY09iamVjdCB7XG4gIHJldHVybiB0eXBlb2YgdmFsdWUgPT09ICdvYmplY3QnICYmIHZhbHVlICE9PSBudWxsICYmIE9iamVjdC5nZXRQcm90b3R5cGVPZih2YWx1ZSkgPT09IE9iamVjdC5wcm90b3R5cGU7XG59XG5cbi8qKlxuICogUGFyc2VzIHRoZSBmcm9udCBtYXR0ZXIgb2YgYSBnaXZlbiBjb250ZW50IHN0cmluZy5cbiAqXG4gKiBAdHlwZVBhcmFtIEN1c3RvbUZyb250bWF0dGVyIC0gVGhlIHR5cGUgb2YgdGhlIGN1c3RvbSBmcm9udCBtYXR0ZXIuXG4gKiBAcGFyYW0gY29udGVudCAtIFRoZSBjb250ZW50IHN0cmluZyB0byBwYXJzZS5cbiAqIEByZXR1cm5zIFRoZSBwYXJzZWQgZnJvbnQgbWF0dGVyLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcGFyc2VGcm9udG1hdHRlcjxDdXN0b21Gcm9udG1hdHRlciA9IHVua25vd24+KGNvbnRlbnQ6IHN0cmluZyk6IENvbWJpbmVkRnJvbnRtYXR0ZXI8Q3VzdG9tRnJvbnRtYXR0ZXI+IHtcbiAgY29uc3QgZnJvbnRtYXR0ZXJJbmZvID0gZ2V0RnJvbnRNYXR0ZXJJbmZvKGNvbnRlbnQpO1xuICByZXR1cm4gKHBhcnNlWWFtbChmcm9udG1hdHRlckluZm8uZnJvbnRtYXR0ZXIpID8/IHt9KSBhcyBDb21iaW5lZEZyb250bWF0dGVyPEN1c3RvbUZyb250bWF0dGVyPjtcbn1cblxuLyoqXG4gKiBSZWdpc3RlcnMgdGhlIHtAbGluayBGcm9udG1hdHRlckZvcm1hdHRpbmdQcmVzZXJ2ZXJ9IGV2ZXJ5IGZyb250LW1hdHRlciB3cml0ZSBpbiB0aGlzIGxpYnJhcnkgcm91dGVzIHRocm91Z2guXG4gKlxuICogVGhlcmUgaXMgYXQgbW9zdCBvbmUsIHNoYXJlZCBieSBldmVyeSBwbHVnaW4gbG9hZGVkIGluIHRoZSBzYW1lIHJlYWxtIFx1MjAxNCBsaWtlIGV2ZXJ5IG90aGVyIHJlZ2lzdHJhdGlvbiBpbiB0aGlzIGxpYnJhcnkgaXQgbGl2ZXMgaW4gdGhlIGBnbG9iYWxUaGlzLl9fb2JzaWRpYW5EZXZVdGlsc2AgYmFnIFx1MjAxNCBzbyBhIHNpbmdsZSBjYWxsIG1ha2VzIGV2ZXJ5IHdyaXRlIHRoaXMgbGlicmFyeSBwZXJmb3JtcyBmb3JtYXR0aW5nLXByZXNlcnZpbmcsIGBwcm9jZXNzRnJvbnRtYXR0ZXIoKWAgYW5kIGBhcHBseUZpbGVDaGFuZ2VzKClgIGluY2x1ZGVkLiBQYXNzIGBudWxsYCB0byB1bnJlZ2lzdGVyLlxuICpcbiAqIFRoZSBwcmVzZXJ2ZXIgaXMgTk9UIHJlZ2lzdGVyZWQgYnkgZGVmYXVsdCwgYW5kIHRoYXQgaXMgYSBidW5kbGUtc2l6ZSBkZWNpc2lvbiByYXRoZXIgdGhhbiBhIGRvdWJ0IGFib3V0IHRoZSBlbmdpbmU6IHRoZSBvbmUgdGhpcyBsaWJyYXJ5IHNoaXBzIG5lZWRzIHRoZSBgeWFtbGAgcGFja2FnZSdzIENTVCBBUEksIHdoaWNoIE9ic2lkaWFuIGRvZXMgbm90IGhhbmQgdG8gcGx1Z2lucyBhbmQgd2hpY2ggY29zdHMgYWJvdXQgMTAwIEtCIG9mIGEgcGx1Z2luJ3MgYG1haW4uanNgLiBBIHBsdWdpbiB0aGF0IHdhbnRzIGl0IGNhbGxzIGBlbmFibGVGcm9udG1hdHRlckZvcm1hdHRpbmdQcmVzZXJ2YXRpb24oKWAgZnJvbSBgb2JzaWRpYW4tZGV2LXV0aWxzL29ic2lkaWFuL2Zyb250bWF0dGVyLWZvcm1hdHRpbmdgLCBhbmQgcGF5cyBmb3IgaXQgb25seSB0aGVuLlxuICpcbiAqIEBwYXJhbSBwcmVzZXJ2ZXIgLSBUaGUgcHJlc2VydmVyIHRvIHJvdXRlIGZyb250LW1hdHRlciB3cml0ZXMgdGhyb3VnaCwgb3IgYG51bGxgIHRvIHVucmVnaXN0ZXIgdGhlIGN1cnJlbnQgb25lLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVnaXN0ZXJGcm9udG1hdHRlckZvcm1hdHRpbmdQcmVzZXJ2ZXIocHJlc2VydmVyOiBGcm9udG1hdHRlckZvcm1hdHRpbmdQcmVzZXJ2ZXIgfCBudWxsKTogdm9pZCB7XG4gIGdldEZyb250bWF0dGVyRm9ybWF0dGluZ1ByZXNlcnZlcldyYXBwZXIoKS52YWx1ZSA9IHByZXNlcnZlcjtcbn1cblxuLyoqXG4gKiBSZW1vdmVzIHRoZSBlbXB0eSB2YWx1ZXMgZnJvbSBhIGZyb250IG1hdHRlciBvYmplY3QsIGF0IGFueSBuZXN0aW5nIGRlcHRoLlxuICpcbiAqIEJ5IGRlZmF1bHQgb25seSBlbXB0eSBzdHJpbmdzIGFyZSByZW1vdmVkIFx1MjAxNCBib3RoIGFzIHByb3BlcnR5IHZhbHVlcyBhbmQgYXMgYXJyYXkgaXRlbXMuIGBudWxsYCwgYHVuZGVmaW5lZGAsIGVtcHR5IGFycmF5cyBhbmQgZW1wdHkgb2JqZWN0cyBhcmUga2VwdCB1bmxlc3MgdGhlIGNvcnJlc3BvbmRpbmcgb3B0aW9uIGlzIGVuYWJsZWQuXG4gKlxuICogVGhlIG9iamVjdCBpcyBtb2RpZmllZCBpbiBwbGFjZSwgc28gdGhlIGZ1bmN0aW9uIGNhbiBiZSBjYWxsZWQgc3RyYWlnaHQgZnJvbSBhIGBwcm9jZXNzRnJvbnRtYXR0ZXIoKWAgY2FsbGJhY2suXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIGZvciByZW1vdmluZyB0aGUgZW1wdHkgZnJvbnQgbWF0dGVyIHZhbHVlcy5cbiAqIEByZXR1cm5zIFRoZSBkb3Qtc2VwYXJhdGVkIGtleSBwYXRocyBvZiB0aGUgcmVtb3ZlZCB2YWx1ZXMsIGluIHRoZSBvcmRlciB0aGV5IHdlcmUgcmVtb3ZlZC4gQW4gYXJyYXkgaXRlbSBpcyByZXBvcnRlZCBieSBpdHMgaW5kZXggd2l0aGluIHRoZSBhcnJheSBhcyBpdCB3YXMgYmVmb3JlIGFueSBvZiBpdHMgc2libGluZ3Mgd2VyZSByZW1vdmVkLCBlLmcuIGB0YWdzLjBgLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVtb3ZlRW1wdHlGcm9udG1hdHRlclZhbHVlcyhwYXJhbXM6IFJlbW92ZUVtcHR5RnJvbnRtYXR0ZXJWYWx1ZXNQYXJhbXMpOiBzdHJpbmdbXSB7XG4gIHJldHVybiBuZXcgRW1wdHlGcm9udG1hdHRlclZhbHVlUmVtb3ZlcihwYXJhbXMpLnJlbW92ZShwYXJhbXMuZnJvbnRtYXR0ZXIpO1xufVxuXG4vKipcbiAqIFNldHMgdGhlIGZyb250IG1hdHRlciBvZiBhIGdpdmVuIGNvbnRlbnQgc3RyaW5nLlxuICpcbiAqIFdoZW4gYSB7QGxpbmsgRnJvbnRtYXR0ZXJGb3JtYXR0aW5nUHJlc2VydmVyfSBpcyByZWdpc3RlcmVkIChzZWUge0BsaW5rIHJlZ2lzdGVyRnJvbnRtYXR0ZXJGb3JtYXR0aW5nUHJlc2VydmVyfSkgdGhlIHdyaXRlIGdvZXMgdGhyb3VnaCBpdCBmaXJzdCwgc28gdGhlIHBhcnRzIG9mIHRoZSBibG9jayB0aGUgY2hhbmdlIGRvZXMgbm90IHJlYWNoIGtlZXAgdGhlIGJ5dGVzIHRoZWlyIGF1dGhvciB3cm90ZSBcdTIwMTQgdGhlaXIgY29tbWVudHMsIHF1b3RpbmcsIGJsYW5rIGxpbmVzIGFuZCBpbmRlbnRhdGlvbi4gV2l0aG91dCBvbmUsIGFuZCB3aGVuZXZlciB0aGUgcHJlc2VydmVyIHJlcG9ydHMgaXQgY2Fubm90IGJlIGZhaXRoZnVsLCB0aGUgd2hvbGUgYmxvY2sgaXMgcGFyc2VkIGFuZCB3cml0dGVuIG91dCBhZ2Fpbiwgd2hpY2ggaXMgd2hhdCBPYnNpZGlhbidzIG93biBgcHJvY2Vzc0Zyb250TWF0dGVyKClgIGRvZXMuXG4gKlxuICogQHBhcmFtIGNvbnRlbnQgLSBUaGUgY29udGVudCBzdHJpbmcgdG8gc2V0IHRoZSBmcm9udCBtYXR0ZXIgaW4uXG4gKiBAcGFyYW0gbmV3RnJvbnRtYXR0ZXIgLSBUaGUgbmV3IGZyb250IG1hdHRlciB0byBzZXQuXG4gKiBAcmV0dXJucyBUaGUgbmV3IGNvbnRlbnQgc3RyaW5nIHdpdGggdGhlIGZyb250IG1hdHRlciBzZXQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzZXRGcm9udG1hdHRlcihjb250ZW50OiBzdHJpbmcsIG5ld0Zyb250bWF0dGVyOiBvYmplY3QpOiBzdHJpbmcge1xuICBjb25zdCBwcmVzZXJ2ZWRDb250ZW50ID0gcHJlc2VydmVGb3JtYXR0aW5nKGNvbnRlbnQsIG5ld0Zyb250bWF0dGVyKTtcbiAgaWYgKHByZXNlcnZlZENvbnRlbnQgIT09IG51bGwpIHtcbiAgICByZXR1cm4gcHJlc2VydmVkQ29udGVudDtcbiAgfVxuXG4gIGNvbnN0IGZyb250bWF0dGVySW5mbyA9IGdldEZyb250TWF0dGVySW5mbyhjb250ZW50KTtcbiAgaWYgKE9iamVjdC5rZXlzKG5ld0Zyb250bWF0dGVyKS5sZW5ndGggPT09IDApIHtcbiAgICByZXR1cm4gY29udGVudC5zbGljZShmcm9udG1hdHRlckluZm8uY29udGVudFN0YXJ0KTtcbiAgfVxuXG4gIGNvbnN0IG5ld0Zyb250bWF0dGVyU3RyaW5nID0gc3RyaW5naWZ5WWFtbChuZXdGcm9udG1hdHRlcik7XG5cbiAgcmV0dXJuIGZyb250bWF0dGVySW5mby5leGlzdHNcbiAgICA/IGluc2VydEF0KHtcbiAgICAgICRzdHJpbmc6IGNvbnRlbnQsXG4gICAgICBlbmRJbmRleDogZnJvbnRtYXR0ZXJJbmZvLnRvLFxuICAgICAgc3RhcnRJbmRleDogZnJvbnRtYXR0ZXJJbmZvLmZyb20sXG4gICAgICBzdWJzdHJpbmc6IG5ld0Zyb250bWF0dGVyU3RyaW5nXG4gICAgfSlcbiAgICA6IGAtLS1cXG4ke25ld0Zyb250bWF0dGVyU3RyaW5nfS0tLVxcbiR7Y29udGVudH1gO1xufVxuXG5mdW5jdGlvbiBnZXRGcm9udG1hdHRlckZvcm1hdHRpbmdQcmVzZXJ2ZXJXcmFwcGVyKCk6IFZhbHVlV3JhcHBlcjxGcm9udG1hdHRlckZvcm1hdHRpbmdQcmVzZXJ2ZXIgfCBudWxsPiB7XG4gIHJldHVybiBnZXRPYnNpZGlhbkRldlV0aWxzU3RhdGU8RnJvbnRtYXR0ZXJGb3JtYXR0aW5nUHJlc2VydmVyIHwgbnVsbD4oRlJPTlRNQVRURVJfRk9STUFUVElOR19QUkVTRVJWRVJfU1RBVEVfS0VZLCBudWxsKTtcbn1cblxuZnVuY3Rpb24gcHJlc2VydmVGb3JtYXR0aW5nKGNvbnRlbnQ6IHN0cmluZywgbmV3RnJvbnRtYXR0ZXI6IG9iamVjdCk6IG51bGwgfCBzdHJpbmcge1xuICBjb25zdCBwcmVzZXJ2ZXIgPSBnZXRGcm9udG1hdHRlckZvcm1hdHRpbmdQcmVzZXJ2ZXJXcmFwcGVyKCkudmFsdWU7XG4gIGlmICghcHJlc2VydmVyKSB7XG4gICAgcmV0dXJuIG51bGw7XG4gIH1cblxuICAvLyBBIHByZXNlcnZlciBjYW4gYmUgc3VwcGxpZWQgYnkgYW55IHBsdWdpbiwgYW5kIHRoaXMgcnVucyBpbnNpZGUgdGhlIHdyaXRlIHF1ZXVlLCB3aGVyZSBhIHRocm93IHdlZGdlcyBldmVyeSB3cml0ZVxuICAvLyBiZWhpbmQgaXQuIFNvIGEgYnJva2VuIHByZXNlcnZlciBpcyByZXBvcnRlZCBhbmQgc3RlcHBlZCBhcm91bmQgcmF0aGVyIHRoYW4gYWxsb3dlZCB0byB0YWtlIHRoZSB3cml0ZSBkb3duLlxuICB0cnkge1xuICAgIHJldHVybiBwcmVzZXJ2ZXIoY29udGVudCwgbmV3RnJvbnRtYXR0ZXIpO1xuICB9IGNhdGNoIChlcnJvcikge1xuICAgIHByaW50RXJyb3IobmV3IEVycm9yKCdUaGUgcmVnaXN0ZXJlZCBmcm9udCBtYXR0ZXIgZm9ybWF0dGluZyBwcmVzZXJ2ZXIgdGhyZXcuIEZhbGxpbmcgYmFjayB0byByZXdyaXRpbmcgdGhlIHdob2xlIGJsb2NrLicsIHsgY2F1c2U6IGVycm9yIH0pKTtcbiAgICByZXR1cm4gbnVsbDtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBU0EsbUJBQThCO0FBQzlCLG1CQUEyQjtBQUMzQixvQkFBeUI7QUFDekIsc0JBSU87QUFFUCxzQ0FBeUM7QUEwR3pDLE1BQU0sNkNBQTZDO0FBQ25ELE1BQU0scUJBQXFCO0FBTzNCLE1BQU0sNkJBQTZCO0FBQUEsRUFDaEIsa0JBQTRCLENBQUM7QUFBQSxFQUM3QjtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT1YsWUFBWSxRQUE0QztBQUM3RCxTQUFLLDBCQUEwQixPQUFPLDJCQUEyQjtBQUNqRSxTQUFLLDJCQUEyQixPQUFPLDRCQUE0QjtBQUNuRSxTQUFLLG9CQUFvQixPQUFPLHFCQUFxQjtBQUFBLEVBQ3ZEO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFRTyxPQUFPLGFBQXNDO0FBQ2xELFNBQUssWUFBWSxhQUFhLEVBQUU7QUFDaEMsV0FBTyxLQUFLO0FBQUEsRUFDZDtBQUFBLEVBRVEsYUFBYSxPQUF5QjtBQUM1QyxRQUFJLFVBQVUsSUFBSTtBQUNoQixhQUFPO0FBQUEsSUFDVDtBQUVBLFFBQUksVUFBVSxRQUFRLFVBQVUsUUFBVztBQUN6QyxhQUFPLEtBQUs7QUFBQSxJQUNkO0FB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

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

@@ -0,0 +1,145 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * This module provides utility functions for processing and managing YAML front matter in Obsidian notes.
+ */
+import type { GenericObject } from '@mnaoumov/typescript-lib/type-guards' with { 'resolution-mode': 'import' };
+/**
+ * A combined front matter of a document.
+ * It is a union of custom front matter, Obsidian front matter, and additional properties.
+ *
+ * @typeParam CustomFrontmatter - The type of custom front matter.
+ */
+export type CombinedFrontmatter<CustomFrontmatter> = GenericObject<CustomFrontmatter & ObsidianFrontmatter>;
+/**
+ * A rewrite of a note's front matter that keeps the author's original formatting wherever the change does not reach it.
+ *
+ * It is handed the whole note and the front matter to write, and returns the whole new note — or `null` when it cannot be faithful, which hands the write back to {@link setFrontmatter}'s own parse-and-stringify path. Returning `null` is never an error: it is how the preserver guarantees it can only ever match or improve on that path, never do worse than it.
+ *
+ * @param content - The note to rewrite the front matter of.
+ * @param newFrontmatter - The front matter to write.
+ * @returns The new note, or `null` to let {@link setFrontmatter} write it instead.
+ */
+export type FrontmatterFormattingPreserver = (this: void, content: string, newFrontmatter: object) => null | string;
+/**
+ * A front matter of an Obsidian file.
+ *
+ * @see {@link https://help.obsidian.md/Editing+and+formatting/Properties#Default+properties}
+ */
+export interface ObsidianFrontmatter {
+    /**
+     * An array of aliases for the note.
+     */
+    aliases?: string[];
+    /**
+     * An array of CSS classes to apply to the note.
+     */
+    cssclasses?: string[];
+    /**
+     * An array of tags for the note.
+     */
+    tags?: string[];
+}
+/**
+ * A front matter for publishing in Obsidian.
+ *
+ * @see {@link https://help.obsidian.md/Editing+and+formatting/Properties#Properties+for+Obsidian+Publish}
+ */
+export interface ObsidianPublishFrontmatter {
+    /**
+     * A cover image for the note.
+     */
+    cover?: string;
+    /**
+     * A description for the note.
+     */
+    description?: string;
+    /**
+     * An image for the note.
+     */
+    image?: string;
+    /**
+     * A permanent link for the note.
+     */
+    permalink?: string;
+    /**
+     * Whether the note is published.
+     */
+    publish?: boolean;
+}
+/**
+ * Parameters for {@link removeEmptyFrontmatterValues}.
+ */
+export interface RemoveEmptyFrontmatterValuesParams {
+    /**
+     * The front matter object to remove the empty values from. It is modified in place.
+     */
+    readonly frontmatter: GenericObject;
+    /**
+     * Whether to remove arrays that are empty, including the ones that became empty after their own items were removed.
+     *
+     * @default `false`
+     */
+    readonly shouldRemoveEmptyArrays?: boolean;
+    /**
+     * Whether to remove plain objects that are empty, including the ones that became empty after their own properties were removed.
+     *
+     * @default `false`
+     */
+    readonly shouldRemoveEmptyObjects?: boolean;
+    /**
+     * Whether to remove `null` and `undefined` values. Both are treated the same: they are the two ways a key can be present but carry no value, and `undefined` cannot survive a YAML round-trip anyway.
+     *
+     * @default `false`
+     */
+    readonly shouldRemoveNulls?: boolean;
+}
+/**
+ * Checks whether the value is a plain object, i.e. an object literal rather than an array or a class instance.
+ *
+ * `parseYaml()` turns a YAML timestamp into a {@link Date}, which has no own enumerable properties, so a plain `typeof value === 'object'` test would report every date as an empty object.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a plain object.
+ */
+export declare function checkIsPlainObject(value: unknown): value is GenericObject;
+/**
+ * Parses the front matter of a given content string.
+ *
+ * @typeParam CustomFrontmatter - The type of the custom front matter.
+ * @param content - The content string to parse.
+ * @returns The parsed front matter.
+ */
+export declare function parseFrontmatter<CustomFrontmatter = unknown>(content: string): CombinedFrontmatter<CustomFrontmatter>;
+/**
+ * Registers the {@link FrontmatterFormattingPreserver} every front-matter write in this library routes through.
+ *
+ * There is at most one, shared by every plugin loaded in the same realm — like every other registration in this library it lives in the `globalThis.__obsidianDevUtils` bag — so a single call makes every write this library performs formatting-preserving, `processFrontmatter()` and `applyFileChanges()` included. Pass `null` to unregister.
+ *
+ * The preserver is NOT registered by default, and that is a bundle-size decision rather than a doubt about the engine: the one this library ships needs the `yaml` package's CST API, which Obsidian does not hand to plugins and which costs about 100 KB of a plugin's `main.js`. A plugin that wants it calls `enableFrontmatterFormattingPreservation()` from `obsidian-dev-utils/obsidian/frontmatter-formatting`, and pays for it only then.
+ *
+ * @param preserver - The preserver to route front-matter writes through, or `null` to unregister the current one.
+ */
+export declare function registerFrontmatterFormattingPreserver(preserver: FrontmatterFormattingPreserver | null): void;
+/**
+ * Removes the empty values from a front matter object, at any nesting depth.
+ *
+ * By default only empty strings are removed — both as property values and as array items. `null`, `undefined`, empty arrays and empty objects are kept unless the corresponding option is enabled.
+ *
+ * The object is modified in place, so the function can be called straight from a `processFrontmatter()` callback.
+ *
+ * @param params - The parameters for removing the empty front matter values.
+ * @returns The dot-separated key paths of the removed values, in the order they were removed. An array item is reported by its index within the array as it was before any of its siblings were removed, e.g. `tags.0`.
+ */
+export declare function removeEmptyFrontmatterValues(params: RemoveEmptyFrontmatterValuesParams): string[];
+/**
+ * Sets the front matter of a given content string.
+ *
+ * When a {@link FrontmatterFormattingPreserver} is registered (see {@link registerFrontmatterFormattingPreserver}) the write goes through it first, so the parts of the block the change does not reach keep the bytes their author wrote — their comments, quoting, blank lines and indentation. Without one, and whenever the preserver reports it cannot be faithful, the whole block is parsed and written out again, which is what Obsidian's own `processFrontMatter()` does.
+ *
+ * @param content - The content string to set the front matter in.
+ * @param newFrontmatter - The new front matter to set.
+ * @returns The new content string with the front matter set.
+ */
+export declare function setFrontmatter(content: string, newFrontmatter: object): string;