@mnaoumov/obsidian-lib 7.1.0 → 8.1.0

package/dist/lib/esm/i18n/custom-type-options.mjs

@@ -4,4 +4,4 @@ if you want to view the source, please visit the github repository of this plugi
 */
 
 import { DEFAULT_NS } from "./i18n.mjs";
-//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2kxOG4vY3VzdG9tLXR5cGUtb3B0aW9ucy50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRoaXMgZmlsZSBkZWZpbmVzIGEgY3VzdG9tIHR5cGUgb3B0aW9ucyBiYXNlIGZvciBgaTE4bmV4dGAuXG4gKi9cblxuLyogdjggaWdub3JlIHN0YXJ0IC0tIEludGVyZmFjZS1vbmx5IG1vZHVsZTsgbm8gcnVudGltZSBjb2RlIHRvIHRlc3QuICovXG5cbmltcG9ydCB0eXBlIHsgRGVmYXVsdFRyYW5zbGF0aW9uc0Jhc2UgfSBmcm9tICcuL2RlZmF1bHQtdHJhbnNsYXRpb25zLnRzJztcblxuaW1wb3J0IHsgREVGQVVMVF9OUyB9IGZyb20gJy4vaTE4bi50cyc7XG5cbi8qKlxuICogQSBjdXN0b20gdHlwZSBvcHRpb25zIGJhc2UgZm9yIGBpMThuZXh0YC5cbiAqXG4gKiBAdHlwZVBhcmFtIERlZmF1bHRUcmFuc2xhdGlvbnMgLSBUaGUgZGVmYXVsdCB0cmFuc2xhdGlvbnMgdHlwZS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBDdXN0b21UeXBlT3B0aW9uc0Jhc2U8RGVmYXVsdFRyYW5zbGF0aW9ucyBleHRlbmRzIERlZmF1bHRUcmFuc2xhdGlvbnNCYXNlPiB7XG4gIC8qKlxuICAgKiBUaGUgZGVmYXVsdCBuYW1lc3BhY2UuXG4gICAqL1xuICBkZWZhdWx0TlM6IHR5cGVvZiBERUZBVUxUX05TO1xuXG4gIC8qKlxuICAgKiBXaGV0aGVyIHRvIGVuYWJsZSB0aGUgc2VsZWN0b3IuXG4gICAqL1xuICBlbmFibGVTZWxlY3RvcjogdHJ1ZTtcblxuICAvKipcbiAgICogVGhlIHJlc291cmNlcy5cbiAgICovXG4gIHJlc291cmNlczogQ3VzdG9tVHlwZU9wdGlvbnNSZXNvdXJjZXM8RGVmYXVsdFRyYW5zbGF0aW9ucz47XG59XG5cbi8qKlxuICogVGhlIHJlc291cmNlcyBmb3IgYGkxOG5leHRgIGN1c3RvbSB0eXBlIG9wdGlvbnMuXG4gKlxuICogQHR5cGVQYXJhbSBEZWZhdWx0VHJhbnNsYXRpb25zIC0gVGhlIGRlZmF1bHQgdHJhbnNsYXRpb25zIHR5cGUuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ3VzdG9tVHlwZU9wdGlvbnNSZXNvdXJjZXM8RGVmYXVsdFRyYW5zbGF0aW9ucyBleHRlbmRzIERlZmF1bHRUcmFuc2xhdGlvbnNCYXNlPiB7XG4gIC8qKlxuICAgKiBUaGUgZGVmYXVsdCBuYW1lc3BhY2UuXG4gICAqL1xuICBbREVGQVVMVF9OU106IERlZmF1bHRUcmFuc2xhdGlvbnM7XG59XG5cbi8qIHY4IGlnbm9yZSBzdG9wICovXG4iXSwKICAibWFwcGluZ3MiOiAiOzs7OztBQVVBLFNBQVMsa0JBQWtCOyIsCiAgIm5hbWVzIjogW10KfQo=
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2kxOG4vY3VzdG9tLXR5cGUtb3B0aW9ucy50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRoaXMgZmlsZSBkZWZpbmVzIGEgY3VzdG9tIHR5cGUgb3B0aW9ucyBiYXNlIGZvciBgaTE4bmV4dGAuXG4gKi9cblxuLyogdjggaWdub3JlIHN0YXJ0IC0tIEludGVyZmFjZS1vbmx5IG1vZHVsZTsgbm8gcnVudGltZSBjb2RlIHRvIHRlc3QuICovXG5cbmltcG9ydCB0eXBlIHsgRGVmYXVsdFRyYW5zbGF0aW9uc0Jhc2UgfSBmcm9tICcuL2RlZmF1bHQtdHJhbnNsYXRpb25zLnRzJztcblxuaW1wb3J0IHsgREVGQVVMVF9OUyB9IGZyb20gJy4vaTE4bi50cyc7XG5cbi8qKlxuICogQSBjdXN0b20gdHlwZSBvcHRpb25zIGJhc2UgZm9yIGBpMThuZXh0YC5cbiAqXG4gKiBAdHlwZVBhcmFtIERlZmF1bHRUcmFuc2xhdGlvbnMgLSBUaGUgZGVmYXVsdCB0cmFuc2xhdGlvbnMgdHlwZS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBDdXN0b21UeXBlT3B0aW9uc0Jhc2U8RGVmYXVsdFRyYW5zbGF0aW9ucyBleHRlbmRzIERlZmF1bHRUcmFuc2xhdGlvbnNCYXNlPiB7XG4gIC8qKlxuICAgKiBUaGUgZGVmYXVsdCBuYW1lc3BhY2UuXG4gICAqL1xuICByZWFkb25seSBkZWZhdWx0TlM6IHR5cGVvZiBERUZBVUxUX05TO1xuXG4gIC8qKlxuICAgKiBXaGV0aGVyIHRvIGVuYWJsZSB0aGUgc2VsZWN0b3IuXG4gICAqL1xuICByZWFkb25seSBlbmFibGVTZWxlY3RvcjogdHJ1ZTtcblxuICAvKipcbiAgICogVGhlIHJlc291cmNlcy5cbiAgICovXG4gIHJlYWRvbmx5IHJlc291cmNlczogQ3VzdG9tVHlwZU9wdGlvbnNSZXNvdXJjZXM8RGVmYXVsdFRyYW5zbGF0aW9ucz47XG59XG5cbi8qKlxuICogVGhlIHJlc291cmNlcyBmb3IgYGkxOG5leHRgIGN1c3RvbSB0eXBlIG9wdGlvbnMuXG4gKlxuICogQHR5cGVQYXJhbSBEZWZhdWx0VHJhbnNsYXRpb25zIC0gVGhlIGRlZmF1bHQgdHJhbnNsYXRpb25zIHR5cGUuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ3VzdG9tVHlwZU9wdGlvbnNSZXNvdXJjZXM8RGVmYXVsdFRyYW5zbGF0aW9ucyBleHRlbmRzIERlZmF1bHRUcmFuc2xhdGlvbnNCYXNlPiB7XG4gIC8qKlxuICAgKiBUaGUgZGVmYXVsdCBuYW1lc3BhY2UuXG4gICAqL1xuICByZWFkb25seSBbREVGQVVMVF9OU106IERlZmF1bHRUcmFuc2xhdGlvbnM7XG59XG5cbi8qIHY4IGlnbm9yZSBzdG9wICovXG4iXSwKICAibWFwcGluZ3MiOiAiOzs7OztBQVVBLFNBQVMsa0JBQWtCOyIsCiAgIm5hbWVzIjogW10KfQo=

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

@@ -102,13 +102,13 @@ export interface BacklinksLike {
      * @param key - The path of the backlink-holding note.
      * @returns The links, or a nullish value.
      */
-    get: (key: string) => null | readonly Reference[] | undefined;
+    readonly get: (key: string) => null | readonly Reference[] | undefined;
     /**
      * Returns the paths of the backlink-holding notes.
      *
      * @returns The paths.
      */
-    keys: () => Iterable<string>;
+    readonly keys: () => Iterable<string>;
 }
 /**
  * A captured snapshot of a set of backlinks: the path of each backlink-holding note, mapped to the identity
@@ -414,6 +414,14 @@ export interface EditLinksInContentParams {
      * @default `false`
      */
     readonly shouldEditMultiValueFrontmatterExternalLinks?: boolean;
+    /**
+     * Whether to leave every link inside a heading unchanged: the converter is not called for it, so it stays
+     * byte-for-byte as written. A link in a heading is part of the heading's text, so rewriting it changes
+     * that text and breaks every `#heading` subpath pointing at the heading. See {@link isReferenceInHeading}.
+     *
+     * @default `false`
+     */
+    readonly shouldSkipLinksInHeadings?: boolean;
 }
 /**
  * Options for {@link editLinks}.
@@ -477,6 +485,14 @@ export interface EditLinksParams extends EditLinksOptions {
      * @default `false`
      */
     readonly shouldEditMultiValueFrontmatterExternalLinks?: boolean;
+    /**
+     * Whether to leave every link inside a heading unchanged: the converter is not called for it, so it stays
+     * byte-for-byte as written. A link in a heading is part of the heading's text, so rewriting it changes
+     * that text and breaks every `#heading` subpath pointing at the heading. See {@link isReferenceInHeading}.
+     *
+     * @default `false`
+     */
+    readonly shouldSkipLinksInHeadings?: boolean;
 }
 /**
  * Parameters for {@link extractLinkFile}.
@@ -779,6 +795,13 @@ export interface UpdateFileUrlLinksInContentParams {
      * @default `undefined`
      */
     readonly offsetRange?: OffsetRange;
+    /**
+     * Whether to leave every link inside a heading unchanged. See
+     * {@link EditLinksInContentParams.shouldSkipLinksInHeadings}.
+     *
+     * @default `false`
+     */
+    readonly shouldSkipLinksInHeadings?: boolean;
     /**
      * Whether to emit the normalized links with angle brackets and raw spaces instead of `%20`-encoding.
      *
@@ -818,6 +841,12 @@ export interface UpdateFileUrlLinksInFileParams extends ProcessOptions {
      * The path or file to normalize the `file://` links in.
      */
     readonly pathOrFile: PathOrFile;
+    /**
+     * Whether to leave every link inside a heading unchanged. See {@link EditLinksParams.shouldSkipLinksInHeadings}.
+     *
+     * @default `false`
+     */
+    readonly shouldSkipLinksInHeadings?: boolean;
     /**
      * Whether to emit the normalized links with angle brackets and raw spaces instead of `%20`-encoding.
      *
@@ -1031,6 +1060,15 @@ export interface UpdateLinksInFileParams extends ProcessOptions {
      * @default `false`
      */
     readonly shouldIncludeAttachmentExtensionToEmbedAlias?: boolean;
+    /**
+     * Whether to leave every link inside a heading unchanged: it is neither converted nor restyled, so it
+     * stays byte-for-byte as written. A link in a heading is part of the heading's text, so rewriting it
+     * changes that text and breaks every `#heading` subpath pointing at the heading. See
+     * {@link isReferenceInHeading}.
+     *
+     * @default `false`
+     */
+    readonly shouldSkipLinksInHeadings?: boolean;
     /**
      * Whether to update only embedded links.
      */
@@ -1167,6 +1205,15 @@ interface UpdateLinksInContentParams {
      * @default `false`
      */
     readonly shouldIncludeAttachmentExtensionToEmbedAlias?: boolean;
+    /**
+     * Whether to leave every link inside a heading unchanged: it is neither converted nor restyled, so it
+     * stays byte-for-byte as written. A link in a heading is part of the heading's text, so rewriting it
+     * changes that text and breaks every `#heading` subpath pointing at the heading. See
+     * {@link isReferenceInHeading}.
+     *
+     * @default `false`
+     */
+    readonly shouldSkipLinksInHeadings?: boolean;
     /**
      * Whether to update only embedded links.
      */