@mnaoumov/obsidian-lib 10.5.1 → 10.7.0

package/dist/lib/esm/anchored-suggest.d.mts

@@ -0,0 +1,116 @@
+/// <reference path="./library-references.d.mts" />
+/// <reference lib="dom" />
+/**
+ * @file
+ *
+ * A suggest popover opened at an element or a rectangle, with no input behind it.
+ */
+import type { App, Scope } from 'obsidian';
+import { PopoverSuggest } from 'obsidian';
+/**
+ * Parameters for {@link AnchoredSuggest.openAt}.
+ */
+export interface AnchoredSuggestOpenAtParams {
+    /**
+     * The element or the viewport rectangle the popover is placed against. When an element is given, the popover closes
+     * once the element leaves the DOM, and a pointer-down on it does not count as an outside click.
+     */
+    readonly anchor: DOMRectReadOnly | HTMLElement;
+    /**
+     * The query handed to {@link AnchoredSuggest.getSuggestions}. Defaults to `''`.
+     */
+    readonly query?: string;
+}
+/**
+ * A suggest popover opened at an anchor, for a picker that has no text input: a toolbar button, a context-menu action,
+ * a decoration in the editor.
+ *
+ * Obsidian's `AbstractInputSuggest` opens only from an input and `EditorSuggest` only from the editor. This one is
+ * opened by {@link AnchoredSuggest.openAt} and closes on Escape, on a pointer-down outside it, and when its anchor
+ * element leaves the DOM. The keyboard works as in Obsidian's own popovers: arrows move, Enter picks.
+ *
+ * ```ts
+ * class ColorSuggest extends AnchoredSuggest<string> {
+ *   protected getSuggestions(): string[] {
+ *     return ['red', 'green', 'blue'];
+ *   }
+ *
+ *   public renderSuggestion(color: string, el: HTMLElement): void {
+ *     el.setText(color);
+ *   }
+ *
+ *   protected onChooseSuggestion(color: string): void {
+ *     console.log(color);
+ *   }
+ * }
+ *
+ * await new ColorSuggest(this.app).openAt({ anchor: buttonEl });
+ * ```
+ *
+ * It relies on `PopoverSuggest` members that `obsidian.d.ts` does not declare (`suggestions`, `reposition`,
+ * `setAutoDestroy`, `suggestEl`), read from Obsidian `1.15.0`.
+ *
+ * @typeParam T - The type of a suggestion.
+ */
+export declare abstract class AnchoredSuggest<T> extends PopoverSuggest<T> {
+    /**
+     * The maximum number of suggestions shown. `0` disables the limit. Defaults to `100`.
+     */
+    limit: number;
+    private anchorEl;
+    private anchorRect;
+    private outsidePointerDownDocument;
+    private readonly outsidePointerDownHandler;
+    private requestCount;
+    /**
+     * Creates a new anchored suggest.
+     *
+     * @param app - The Obsidian app.
+     * @param scope - The parent keymap scope.
+     */
+    constructor(app: App, scope?: Scope);
+    /**
+     * Closes the popover.
+     */
+    close(): void;
+    /**
+     * Opens the popover at an anchor, or moves it there when it is already open.
+     *
+     * @param params - The parameters.
+     * @returns Whether the popover is open: `false` when there is nothing to suggest, or when it was closed or reopened
+     *   while the suggestions were computed.
+     */
+    openAt(params: AnchoredSuggestOpenAtParams): Promise<boolean>;
+    /**
+     * Picks a suggestion: closes the popover, then hands the suggestion to {@link AnchoredSuggest.onChooseSuggestion}.
+     *
+     * @param value - The suggestion.
+     * @param $event - The event that picked it.
+     */
+    selectSuggestion(value: T, $event: KeyboardEvent | MouseEvent): void;
+    /**
+     * Recomputes the suggestions for a new query at the current anchor.
+     *
+     * @param query - The query.
+     * @returns Whether the popover is open afterwards.
+     */
+    setQuery(query: string): Promise<boolean>;
+    /**
+     * Gets the suggestions for a query.
+     *
+     * @param query - The query passed to {@link AnchoredSuggest.openAt} or {@link AnchoredSuggest.setQuery}.
+     * @returns The suggestions, directly or as a promise.
+     */
+    protected abstract getSuggestions(query: string): Promise<T[]> | T[];
+    /**
+     * Called with the suggestion the user picked, after the popover closed.
+     *
+     * @param value - The suggestion.
+     * @param $event - The event that picked it.
+     */
+    protected abstract onChooseSuggestion(value: T, $event: KeyboardEvent | MouseEvent): void;
+    private addOutsidePointerDownHandler;
+    private onOutsidePointerDown;
+    private refresh;
+    private removeOutsidePointerDownHandler;
+}

package/dist/lib/esm/anchored-suggest.mjs

@@ -0,0 +1,144 @@
+/*
+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 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;
+}
+
+ensureBrowserProcess();
+})();
+
+import { PopoverSuggest } from "obsidian";
+const DEFAULT_LIMIT = 100;
+class AnchoredSuggest extends PopoverSuggest {
+  /**
+   * The maximum number of suggestions shown. `0` disables the limit. Defaults to `100`.
+   */
+  limit = DEFAULT_LIMIT;
+  anchorEl = null;
+  anchorRect = null;
+  outsidePointerDownDocument = null;
+  outsidePointerDownHandler = this.onOutsidePointerDown.bind(this);
+  requestCount = 0;
+  /**
+   * Creates a new anchored suggest.
+   *
+   * @param app - The Obsidian app.
+   * @param scope - The parent keymap scope.
+   */
+  constructor(app, scope) {
+    super(app, scope);
+  }
+  /**
+   * Closes the popover.
+   */
+  close() {
+    this.requestCount++;
+    this.removeOutsidePointerDownHandler();
+    super.close();
+  }
+  /**
+   * Opens the popover at an anchor, or moves it there when it is already open.
+   *
+   * @param params - The parameters.
+   * @returns Whether the popover is open: `false` when there is nothing to suggest, or when it was closed or reopened
+   *   while the suggestions were computed.
+   */
+  async openAt(params) {
+    const { anchor } = params;
+    if (isElement(anchor)) {
+      this.anchorEl = anchor;
+      this.anchorRect = anchor.getBoundingClientRect();
+    } else {
+      this.anchorEl = null;
+      this.anchorRect = anchor;
+    }
+    return await this.refresh(params.query ?? "", this.anchorRect);
+  }
+  /**
+   * Picks a suggestion: closes the popover, then hands the suggestion to {@link AnchoredSuggest.onChooseSuggestion}.
+   *
+   * @param value - The suggestion.
+   * @param $event - The event that picked it.
+   */
+  selectSuggestion(value, $event) {
+    this.close();
+    this.onChooseSuggestion(value, $event);
+  }
+  /**
+   * Recomputes the suggestions for a new query at the current anchor.
+   *
+   * @param query - The query.
+   * @returns Whether the popover is open afterwards.
+   */
+  async setQuery(query) {
+    return this.anchorRect ? await this.refresh(query, this.anchorRect) : false;
+  }
+  addOutsidePointerDownHandler() {
+    this.removeOutsidePointerDownHandler();
+    this.outsidePointerDownDocument = this.suggestEl.ownerDocument;
+    this.outsidePointerDownDocument.addEventListener("pointerdown", this.outsidePointerDownHandler, { capture: true });
+  }
+  onOutsidePointerDown(event_) {
+    const path = event_.composedPath();
+    if (path.includes(this.suggestEl) || this.anchorEl && path.includes(this.anchorEl)) {
+      return;
+    }
+    this.close();
+  }
+  async refresh(query, anchorRect) {
+    const requestId = ++this.requestCount;
+    let suggestions = await this.getSuggestions(query);
+    if (requestId !== this.requestCount) {
+      return false;
+    }
+    if (suggestions.length === 0) {
+      this.close();
+      return false;
+    }
+    if (this.limit > 0) {
+      suggestions = suggestions.slice(0, this.limit);
+    }
+    this.suggestions.setSuggestions(suggestions);
+    this.open();
+    this.reposition(DOMRect.fromRect(anchorRect));
+    if (this.anchorEl) {
+      this.setAutoDestroy(this.anchorEl);
+    }
+    this.addOutsidePointerDownHandler();
+    return true;
+  }
+  removeOutsidePointerDownHandler() {
+    this.outsidePointerDownDocument?.removeEventListener("pointerdown", this.outsidePointerDownHandler, { capture: true });
+    this.outsidePointerDownDocument = null;
+  }
+}
+function isElement(anchor) {
+  return "getBoundingClientRect" in anchor;
+}
+export {
+  AnchoredSuggest
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9hbmNob3JlZC1zdWdnZXN0LnRzIl0sInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBBIHN1Z2dlc3QgcG9wb3ZlciBvcGVuZWQgYXQgYW4gZWxlbWVudCBvciBhIHJlY3RhbmdsZSwgd2l0aCBubyBpbnB1dCBiZWhpbmQgaXQuXG4gKi9cblxuaW1wb3J0IHR5cGUge1xuICBBcHAsXG4gIFNjb3BlXG59IGZyb20gJ29ic2lkaWFuJztcblxuaW1wb3J0IHsgUG9wb3ZlclN1Z2dlc3QgfSBmcm9tICdvYnNpZGlhbic7XG5cbmNvbnN0IERFRkFVTFRfTElNSVQgPSAxMDA7XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIEFuY2hvcmVkU3VnZ2VzdC5vcGVuQXR9LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEFuY2hvcmVkU3VnZ2VzdE9wZW5BdFBhcmFtcyB7XG4gIC8qKlxuICAgKiBUaGUgZWxlbWVudCBvciB0aGUgdmlld3BvcnQgcmVjdGFuZ2xlIHRoZSBwb3BvdmVyIGlzIHBsYWNlZCBhZ2FpbnN0LiBXaGVuIGFuIGVsZW1lbnQgaXMgZ2l2ZW4sIHRoZSBwb3BvdmVyIGNsb3Nlc1xuICAgKiBvbmNlIHRoZSBlbGVtZW50IGxlYXZlcyB0aGUgRE9NLCBhbmQgYSBwb2ludGVyLWRvd24gb24gaXQgZG9lcyBub3QgY291bnQgYXMgYW4gb3V0c2lkZSBjbGljay5cbiAgICovXG4gIHJlYWRvbmx5IGFuY2hvcjogRE9NUmVjdFJlYWRPbmx5IHwgSFRNTEVsZW1lbnQ7XG5cbiAgLyoqXG4gICAqIFRoZSBxdWVyeSBoYW5kZWQgdG8ge0BsaW5rIEFuY2hvcmVkU3VnZ2VzdC5nZXRTdWdnZXN0aW9uc30uIERlZmF1bHRzIHRvIGAnJ2AuXG4gICAqL1xuICByZWFkb25seSBxdWVyeT86IHN0cmluZztcbn1cblxuLyoqXG4gKiBBIHN1Z2dlc3QgcG9wb3ZlciBvcGVuZWQgYXQgYW4gYW5jaG9yLCBmb3IgYSBwaWNrZXIgdGhhdCBoYXMgbm8gdGV4dCBpbnB1dDogYSB0b29sYmFyIGJ1dHRvbiwgYSBjb250ZXh0LW1lbnUgYWN0aW9uLFxuICogYSBkZWNvcmF0aW9uIGluIHRoZSBlZGl0b3IuXG4gKlxuICogT2JzaWRpYW4ncyBgQWJzdHJhY3RJbnB1dFN1Z2dlc3RgIG9wZW5zIG9ubHkgZnJvbSBhbiBpbnB1dCBhbmQgYEVkaXRvclN1Z2dlc3RgIG9ubHkgZnJvbSB0aGUgZWRpdG9yLiBUaGlzIG9uZSBpc1xuICogb3BlbmVkIGJ5IHtAbGluayBBbmNob3JlZFN1Z2dlc3Qub3BlbkF0fSBhbmQgY2xvc2VzIG9uIEVzY2FwZSwgb24gYSBwb2ludGVyLWRvd24gb3V0c2lkZSBpdCwgYW5kIHdoZW4gaXRzIGFuY2hvclxuICogZWxlbWVudCBsZWF2ZXMgdGhlIERPTS4gVGhlIGtleWJvYXJkIHdvcmtzIGFzIGluIE9ic2lkaWFuJ3Mgb3duIHBvcG92ZXJzOiBhcnJvd3MgbW92ZSwgRW50ZXIgcGlja3MuXG4gKlxuICogYGBgdHNcbiAqIGNsYXNzIENvbG9yU3VnZ2VzdCBleHRlbmRzIEFuY2hvcmVkU3VnZ2VzdDxzdHJpbmc+IHtcbiAqICAgcHJvdGVjdGVkIGdldFN1Z2dlc3Rpb25zKCk6IHN0cmluZ1tdIHtcbiAqICAgICByZXR1cm4gWydyZWQnLCAnZ3JlZW4nLCAnYmx1ZSddO1xuICogICB9XG4gKlxuICogICBwdWJsaWMgcmVuZGVyU3VnZ2VzdGlvbihjb2xvcjogc3RyaW5nLCBlbDogSFRNTEVsZW1lbnQpOiB2b2lkIHtcbiAqICAgICBlbC5zZXRUZXh0KGNvbG9yKTtcbiAqICAgfVxuICpcbiAqICAgcHJvdGVjdGVkIG9uQ2hvb3NlU3VnZ2VzdGlvbihjb2xvcjogc3RyaW5nKTogdm9pZCB7XG4gKiAgICAgY29uc29sZS5sb2coY29sb3IpO1xuICogICB9XG4gKiB9XG4gKlxuICogYXdhaXQgbmV3IENvbG9yU3VnZ2VzdCh0aGlzLmFwcCkub3BlbkF0KHsgYW5jaG9yOiBidXR0b25FbCB9KTtcbiAqIGBgYFxuICpcbiAqIEl0IHJlbGllcyBvbiBgUG9wb3ZlclN1Z2dlc3RgIG1lbWJlcnMgdGhhdCBgb2JzaWRpYW4uZC50c2AgZG9lcyBub3QgZGVjbGFyZSAoYHN1Z2dlc3Rpb25zYCwgYHJlcG9zaXRpb25gLFxuICogYHNldEF1dG9EZXN0cm95YCwgYHN1Z2dlc3RFbGApLCByZWFkIGZyb20gT2JzaWRpYW4gYDEuMTUuMGAuXG4gKlxuICogQHR5cGVQYXJhbSBUIC0gVGhlIHR5cGUgb2YgYSBzdWdnZXN0aW9uLlxuICovXG5leHBvcnQgYWJzdHJhY3QgY2xhc3MgQW5jaG9yZWRTdWdnZXN0PFQ+IGV4dGVuZHMgUG9wb3ZlclN1Z2dlc3Q8VD4ge1xuICAvKipcbiAgICogVGhlIG1heGltdW0gbnVtYmVyIG9mIHN1Z2dlc3Rpb25zIHNob3duLiBgMGAgZGlzYWJsZXMgdGhlIGxpbWl0LiBEZWZhdWx0cyB0byBgMTAwYC5cbiAgICovXG4gIHB1YmxpYyBsaW1pdCA9IERFRkFVTFRfTElNSVQ7XG5cbiAgcHJpdmF0ZSBhbmNob3JFbDogSFRNTEVsZW1lbnQgfCBudWxsID0gbnVsbDtcbiAgcHJpdmF0ZSBhbmNob3JSZWN0OiBET01SZWN0UmVhZE9ubHkgfCBudWxsID0gbnVsbDtcbiAgcHJpdmF0ZSBvdXRzaWRlUG9pbnRlckRvd25Eb2N1bWVudDogRG9jdW1lbnQgfCBudWxsID0gbnVsbDtcbiAgcHJpdmF0ZSByZWFkb25seSBvdXRzaWRlUG9pbnRlckRvd25IYW5kbGVyID0gdGhpcy5vbk91dHNpZGVQb2ludGVyRG93bi5iaW5kKHRoaXMpO1xuICBwcml2YXRlIHJlcXVlc3RDb3VudCA9IDA7XG5cbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgYW5jaG9yZWQgc3VnZ2VzdC5cbiAgICpcbiAgICogQHBhcmFtIGFwcCAtIFRoZSBPYnNpZGlhbiBhcHAuXG4gICAqIEBwYXJhbSBzY29wZSAtIFRoZSBwYXJlbnQga2V5bWFwIHNjb3BlLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKGFwcDogQXBwLCBzY29wZT86IFNjb3BlKSB7XG4gICAgc3VwZXIoYXBwLCBzY29wZSk7XG4gIH1cblxuICAvKipcbiAgICogQ2xvc2VzIHRoZSBwb3BvdmVyLlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIGNsb3NlKCk6IHZvaWQge1xuICAgIHRoaXMucmVxdWVzdENvdW50Kys7XG4gICAgdGhpcy5yZW1vdmVPdXRzaWRlUG9pbnRlckRvd25IYW5kbGVyKCk7XG4gICAgc3VwZXIuY2xvc2UoKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBPcGVucyB0aGUgcG9wb3ZlciBhdCBhbiBhbmNob3IsIG9yIG1vdmVzIGl0IHRoZXJlIHdoZW4gaXQgaXMgYWxyZWFkeSBvcGVuLlxuICAgKlxuICAgKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBhcmFtZXRlcnMuXG4gICAqIEByZXR1cm5zIFdoZXRoZXIgdGhlIHBvcG92ZXIgaXMgb3BlbjogYGZhbHNlYCB3aGVuIHRoZXJlIGlzIG5vdGhpbmcgdG8gc3VnZ2VzdCwgb3Igd2hlbiBpdCB3YXMgY2xvc2VkIG9yIHJlb3BlbmVkXG4gICAqICAgd2hpbGUgdGhlIHN1Z2dlc3Rpb25zIHdlcmUgY29tcHV0ZWQuXG4gICAqL1xuICBwdWJsaWMgYXN5bmMgb3BlbkF0KHBhcmFtczogQW5jaG9yZWRTdWdnZXN0T3BlbkF0UGFyYW1zKTogUHJvbWlzZTxib29sZWFuPiB7XG4gICAgY29uc3QgeyBhbmNob3IgfSA9IHBhcmFtcztcbiAgICBpZiAoaXNFbGVtZW50KGFuY2hvcikpIHtcbiAgICAgIHRoaXMuYW5jaG9yRWwgPSBhbmNob3I7XG4gICAgICB0aGlzLmFuY2hvclJlY3QgPSBhbmNob3IuZ2V0Qm91bmRpbmdDbGllbnRSZWN0KCk7XG4gICAgfSBlbHNlIHtcbiAgICAgIHRoaXMuYW5jaG9yRWwgPSBudWxsO1xuICAgICAgdGhpcy5hbmNob3JSZWN0ID0gYW5jaG9yO1xuICAgIH1cbiAgICByZXR1cm4gYXdhaXQgdGhpcy5yZWZyZXNoKHBhcmFtcy5xdWVyeSA/PyAnJywgdGhpcy5hbmNob3JSZWN0KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBQaWNrcyBhIHN1Z2dlc3Rpb246IGNsb3NlcyB0aGUgcG9wb3ZlciwgdGhlbiBoYW5kcyB0aGUgc3VnZ2VzdGlvbiB0byB7QGxpbmsgQW5jaG9yZWRTdWdnZXN0Lm9uQ2hvb3NlU3VnZ2VzdGlvbn0uXG4gICAqXG4gICAqIEBwYXJhbSB2YWx1ZSAtIFRoZSBzdWdnZXN0aW9uLlxuICAgKiBAcGFyYW0gJGV2ZW50IC0gVGhlIGV2ZW50IHRoYXQgcGlja2VkIGl0LlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIHNlbGVjdFN1Z2dlc3Rpb24odmFsdWU6IFQsICRldmVudDogS2V5Ym9hcmRFdmVudCB8IE1vdXNlRXZlbnQpOiB2b2lkIHtcbiAgICB0aGlzLmNsb3NlKCk7XG4gICAgdGhpcy5vbkNob29zZVN1Z2dlc3Rpb24odmFsdWUsICRldmVudCk7XG4gIH1cblxuICAvKipcbiAgICogUmVjb21wdXRlcyB0aGUgc3VnZ2VzdGlvbnMgZm9yIGEgbmV3IHF1ZXJ5IGF0IHRoZSBjdXJyZW50IGFuY2hvci5cbiAgICpcbiAgICogQHBhcmFtIHF1ZXJ5IC0gVGhlIHF1ZXJ5LlxuICAgKiBAcmV0dXJucyBXaGV0aGVyIHRoZSBwb3BvdmVyIGlzIG9wZW4gYWZ0ZXJ3YXJkcy5cbiAgICovXG4gIHB1YmxpYyBhc3luYyBzZXRRdWVyeShxdWVyeTogc3RyaW5nKTogUHJvbWlzZTxib29sZWFuPiB7XG4gICAgcmV0dXJuIHRoaXMuYW5jaG9yUmVjdCA/IChhd2FpdCB0aGlzLnJlZnJlc2gocXVlcnksIHRoaXMuYW5jaG9yUmVjdCkpIDogZmFsc2U7XG4gIH1cblxuICAvKipcbiAgICogR2V0cyB0aGUgc3VnZ2VzdGlvbnMgZm9yIGEgcXVlcnkuXG4gICAqXG4gICAqIEBwYXJhbSBxdWVyeSAtIFRoZSBxdWVyeSBwYXNzZWQgdG8ge0BsaW5rIEFuY2hvcmVkU3VnZ2VzdC5vcGVuQXR9IG9yIHtAbGluayBBbmNob3JlZFN1Z2dlc3Quc2V0UXVlcnl9LlxuICAgKiBAcmV0dXJucyBUaGUgc3VnZ2VzdGlvbnMsIGRpcmVjdGx5IG9yIGFzIGEgcHJvbWlzZS5cbiAgICovXG4gIHByb3RlY3RlZCBhYnN0cmFjdCBnZXRTdWdnZXN0aW9ucyhxdWVyeTogc3RyaW5nKTogUHJvbWlzZTxUW10+IHwgVFtdO1xuXG4gIC8qKlxuICAgKiBDYWxsZWQgd2l0aCB0aGUgc3VnZ2VzdGlvbiB0aGUgdXNlciBwaWNrZWQsIGFmdGVyIHRoZSBwb3BvdmVyIGNsb3NlZC5cbiAgICpcbiAgICogQHBhcmFtIHZhbHVlIC0gVGhlIHN1Z2dlc3Rpb24uXG4gICAqIEBwYXJhbSAkZXZlbnQgLSBUaGUgZXZlbnQgdGhhdCBwaWNrZWQgaXQuXG4gICAqL1xuICBwcm90ZWN0ZWQgYWJzdHJhY3Qgb25DaG9vc2VTdWdnZXN0aW9uKHZhbHVlOiBULCAkZXZlbnQ6IEtleWJvYXJkRXZlbnQgfCBNb3VzZUV2ZW50KTogdm9pZDtcblxuICBwcml2YXRlIGFkZE91dHNpZGVQb2ludGVyRG93bkhhbmRsZXIoKTogdm9pZCB7XG4gICAgdGhpcy5yZW1vdmVPdXRzaWRlUG9pbnRlckRvd25IYW5kbGVyKCk7XG4gICAgdGhpcy5vdXRzaWRlUG9pbnRlckRvd25Eb2N1bWVudCA9IHRoaXMuc3VnZ2VzdEVsLm93bmVyRG9jdW1lbnQ7XG4gICAgdGhpcy5vdXRzaWRlUG9pbnRlckRvd25Eb2N1bWVudC5hZGRFdmVudExpc3RlbmVyKCdwb2ludGVyZG93bicsIHRoaXMub3V0c2lkZVBvaW50ZXJEb3duSGFuZGxlciwgeyBjYXB0dXJlOiB0cnVlIH0pO1xuICB9XG5cbiAgcHJpdmF0ZSBvbk91dHNpZGVQb2ludGVyRG93bihldmVudF86IFBvaW50ZXJFdmVudCk6IHZvaWQge1xuICAgIGNvbnN0IHBhdGggPSBldmVudF8uY29tcG9zZWRQYXRoKCk7XG4gICAgaWYgKHBhdGguaW5jbHVkZXModGhpcy5zdWdnZXN0RWwpIHx8ICh0aGlzLmFuY2hvckVsICYmIHBhdGguaW5jbHVkZXModGhpcy5hbmNob3JFbCkpKSB7XG4gICAgICByZXR1cm47XG4gICAgfVxuICAgIHRoaXMuY2xvc2UoKTtcbiAgfVxuXG4gIHByaXZhdGUgYXN5bmMgcmVmcmVzaChxdWVyeTogc3RyaW5nLCBhbmNob3JSZWN0OiBET01SZWN0UmVhZE9ubHkpOiBQcm9taXNlPGJvb2xlYW4+IHtcbiAgICBjb25zdCByZXF1ZXN0SWQgPSArK3RoaXMucmVxdWVzdENvdW50O1xuICAgIGxldCBzdWdnZXN0aW9ucyA9IGF3YWl0IHRoaXMuZ2V0U3VnZ2VzdGlvbnMocXVlcnkpO1xuICAgIGlmIChyZXF1ZXN0SWQgIT09IHRoaXMucmVxdWVzdENvdW50KSB7XG4gICAgICByZXR1cm4gZmFsc2U7XG4gICAgfVxuICAgIGlmIChzdWdnZXN0aW9ucy5sZW5ndGggPT09IDApIHtcbiAgICAgIHRoaXMuY2xvc2UoKTtcbiAgICAgIHJldHVybiBmYWxzZTtcbiAgICB9XG4gICAgaWYgKHRoaXMubGltaXQgPiAwKSB7XG4gICAgICBzdWdnZXN0aW9ucyA9IHN1Z2dlc3Rpb25zLnNsaWNlKDAsIHRoaXMubGltaXQpO1xuICAgIH1cblxuICAgIHRoaXMuc3VnZ2VzdGlvbnMuc2V0U3VnZ2VzdGlvbnMoc3VnZ2VzdGlvbnMpO1xuICAgIHRoaXMub3BlbigpO1xuICAgIHRoaXMucmVwb3NpdGlvbihET01SZWN0LmZyb21SZWN0KGFuY2hvclJlY3QpKTtcbiAgICBpZiAodGhpcy5hbmNob3JFbCkge1xuICAgICAgdGhpcy5zZXRBdXRvRGVzdHJveSh0aGlzLmFuY2hvckVsKTtcbiAgICB9XG4gICAgdGhpcy5hZGRPdXRzaWRlUG9pbnRlckRvd25IYW5kbGVyKCk7XG4gICAgcmV0dXJuIHRydWU7XG4gIH1cblxuICBwcml2YXRlIHJlbW92ZU91dHNpZGVQb2ludGVyRG93bkhhbmRsZXIoKTogdm9pZCB7XG4gICAgdGhpcy5vdXRzaWRlUG9pbnRlckRvd25Eb2N1bWVudD8ucmVtb3ZlRXZlbnRMaXN0ZW5lcigncG9pbnRlcmRvd24nLCB0aGlzLm91dHNpZGVQb2ludGVyRG93bkhhbmRsZXIsIHsgY2FwdHVyZTogdHJ1ZSB9KTtcbiAgICB0aGlzLm91dHNpZGVQb2ludGVyRG93bkRvY3VtZW50ID0gbnVsbDtcbiAgfVxufVxuXG5mdW5jdGlvbiBpc0VsZW1lbnQoYW5jaG9yOiBET01SZWN0UmVhZE9ubHkgfCBIVE1MRWxlbWVudCk6IGFuY2hvciBpcyBIVE1MRWxlbWVudCB7XG4gIHJldHVybiAnZ2V0Qm91bmRpbmdDbGllbnRSZWN0JyBpbiBhbmNob3I7XG59XG4iXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBV0EsU0FBUyxzQkFBc0I7QUFFL0IsTUFBTSxnQkFBZ0I7QUFpRGYsTUFBZSx3QkFBMkIsZUFBa0I7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUkxRCxRQUFRO0FBQUEsRUFFUCxXQUErQjtBQUFBLEVBQy9CLGFBQXFDO0FBQUEsRUFDckMsNkJBQThDO0FBQUEsRUFDckMsNEJBQTRCLEtBQUsscUJBQXFCLEtBQUssSUFBSTtBQUFBLEVBQ3hFLGVBQWU7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVFoQixZQUFZLEtBQVUsT0FBZTtBQUMxQyxVQUFNLEtBQUssS0FBSztBQUFBLEVBQ2xCO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFLZ0IsUUFBYztBQUM1QixTQUFLO0FBQ0wsU0FBSyxnQ0FBZ0M7QUFDckMsVUFBTSxNQUFNO0FBQUEsRUFDZDtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFTQSxNQUFhLE9BQU8sUUFBdUQ7QUFDekUsVUFBTSxFQUFFLE9BQU8sSUFBSTtBQUNuQixRQUFJLFVBQVUsTUFBTSxHQUFHO0FBQ3JCLFdBQUssV0FBVztBQUNoQixXQUFLLGFBQWEsT0FBTyxzQkFBc0I7QUFBQSxJQUNqRCxPQUFPO0FBQ0wsV0FBSyxXQUFXO0FBQ2hCLFdBQUssYUFBYTtBQUFBLElBQ3BCO0FBQ0EsV0FBTyxNQUFNLEtBQUssUUFBUSxPQUFPLFNBQVMsSUFBSSxLQUFLLFVBQVU7QUFBQSxFQUMvRDtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBUWdCLGlCQUFpQixPQUFVLFFBQTBDO0FBQ25GLFNBQUssTUFBTTtBQUNYLFNBQUssbUJBQW1CLE9BQU8sTUFBTTtBQUFBLEVBQ3ZDO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFRQSxNQUFhLFNBQVMsT0FBaUM7QUFDckQsV0FBTyxLQUFLLGFBQWMsTUFBTSxLQUFLLFFBQVEsT0FBTyxLQUFLLFVBQVUsSUFBSztBQUFBLEVBQzFFO0FBQUEsRUFrQlEsK0JBQXFDO0FBQzNDLFNBQUssZ0NBQWdDO0FBQ3JDLFNBQUssNkJBQTZCLEtBQUssVUFBVTtBQUNqRCxTQUFLLDJCQUEyQixpQkFBaUIsZUFBZSxLQUFLLDJCQUEyQixFQUFFLFNBQVMsS0FBSyxDQUFDO0FBQUEsRUFDbkg7QUFBQSxFQUVRLHFCQUFxQixRQUE0QjtBQUN2RCxVQUFNLE9BQU8sT0FBTyxhQUFhO0FBQ2pDLFFBQUksS0FBSyxTQUFTLEtBQUssU0FBUyxLQUFNLEtBQUssWUFBWSxLQUFLLFNBQVMsS0FBSyxRQUFRLEdBQUk7QUFDcEY7QUFBQSxJQUNGO0FBQ0EsU0FBSyxNQUFNO0FBQUEsRUFDYjtBQUFBLEVBRUEsTUFBYyxRQUFRLE9BQWUsWUFBK0M7QUFDbEYsVUFBTSxZQUFZLEVBQUUsS0FBSztBQUN6QixRQUFJLGNBQWMsTUFBTSxLQUFLLGVBQWUsS0FBSztBQUNqRCxRQUFJLGNBQWMsS0FBSyxjQUFjO0FBQ25DLGFBQU87QUFBQSxJQUNUO0FBQ0EsUUFBSSxZQUFZLFdBQVcsR0FBRztBQUM1QixXQUFLLE1BQU07QUFDWCxhQUFPO0FBQUEsSUFDVDtBQUNBLFFBQUksS0FBSyxRQUFRLEdBQUc7QUFDbEIsb0JBQWMsWUFBWSxNQUFNLEdBQUcsS0FBSyxLQUFLO0FBQUEsSUFDL0M7QUFFQSxTQUFLLFlBQVksZUFBZSxXQUFXO0FBQzNDLFNBQUssS0FBSztBQUNWLFNBQUssV0FBVyxRQUFRLFNBQVMsVUFBVSxDQUFDO0FBQzVDLFFBQUksS0FBSyxVQUFVO0FBQ2pCLFdBQUssZUFBZSxLQUFLLFFBQVE7QUFBQSxJQUNuQztBQUNBLFNBQUssNkJBQTZCO0FBQ2xDLFdBQU87QUFBQSxFQUNUO0FBQUEsRUFFUSxrQ0FBd0M7QUFDOUMsU0FBSyw0QkFBNEIsb0JBQW9CLGVBQWUsS0FBSywyQkFBMkIsRUFBRSxTQUFTLEtBQUssQ0FBQztBQUNySCxTQUFLLDZCQUE2QjtBQUFBLEVBQ3BDO0FBQ0Y7QUFFQSxTQUFTLFVBQVUsUUFBOEQ7QUFDL0UsU0FBTywyQkFBMkI7QUFDcEM7IiwibmFtZXMiOltdfQ==

package/dist/lib/esm/broken-link-candidates.d.mts

@@ -0,0 +1,181 @@
+/// <reference path="./library-references.d.mts" />
+/**
+ * @file
+ *
+ * Where did a missing link target go? Pure, no `App`: every question about which file a broken link most likely
+ * meant is answerable from a list of paths, the notes' aliases and titles, and the vault's git renames.
+ *
+ * A rename is not recoverable from the link alone: a link to `alpha/bravo/charlie/!.md` says nothing about
+ * `charlie` having become `delta`. So every candidate carries the evidence that produced it, from outside the
+ * link, and the finder never picks one of several: a caller offers a one-click fix only when exactly one
+ * candidate exists.
+ */
+/**
+ * The kind of evidence that makes a file a candidate for a missing link target.
+ *
+ * Candidates list evidence strongest first, in EVIDENCE_KIND_ORDER below.
+ */
+export declare enum BrokenLinkEvidenceKind {
+    /**
+     * The candidate's `aliases` hold the missing target's old name.
+     */
+    Alias = "Alias",
+    /**
+     * The candidate's path differs from the missing one only in letter case.
+     */
+    CaseChange = "CaseChange",
+    /**
+     * The vault's git history records the missing path being renamed to the candidate.
+     */
+    GitRename = "GitRename",
+    /**
+     * The missing target's folder is gone, and a sibling folder holds every missing target that was under it.
+     */
+    RenamedFolder = "RenamedFolder",
+    /**
+     * A file with the same name, and the longest run of the same parent folders, sits elsewhere.
+     */
+    SameName = "SameName",
+    /**
+     * The candidate's `title` is the missing target's old name.
+     */
+    Title = "Title"
+}
+/**
+ * One file that a missing link target may have become, and why.
+ */
+export interface BrokenLinkCandidate {
+    /**
+     * Every reason this file is a candidate, strongest first.
+     */
+    readonly evidence: readonly BrokenLinkEvidence[];
+    /**
+     * The candidate's vault path.
+     */
+    readonly path: string;
+}
+/**
+ * The parameters for {@link BrokenLinkCandidateFinder}.
+ */
+export interface BrokenLinkCandidateFinderConstructorParams {
+    /**
+     * Each note's `aliases`, by note path.
+     */
+    readonly aliasesByPath: ReadonlyMap<string, readonly string[]>;
+    /**
+     * Every file in the vault.
+     */
+    readonly filePaths: readonly string[];
+    /**
+     * The file names a folder note is stored under, such as `index.md`. Such a name says nothing about which
+     * note it is, so a same-name candidate must share its folder's name too, and the old name an alias is
+     * matched against is the folder's.
+     */
+    readonly folderNoteFileNames: readonly string[];
+    /**
+     * The vault's git renames: each old vault path to the path it was renamed to, chains already followed.
+     */
+    readonly gitRenames: ReadonlyMap<string, GitRename>;
+    /**
+     * Each note's `title`, by note path.
+     */
+    readonly titlesByPath: ReadonlyMap<string, string>;
+}
+/**
+ * One reason a file is a candidate for a missing link target.
+ */
+export interface BrokenLinkEvidence {
+    /**
+     * A sentence naming the evidence, for the user to judge it by.
+     */
+    readonly description: string;
+    /**
+     * The kind of evidence.
+     */
+    readonly kind: BrokenLinkEvidenceKind;
+}
+/**
+ * A rename recorded in the vault's git history.
+ */
+export interface GitRename {
+    /**
+     * The abbreviated hash of the commit that made the last rename of the chain.
+     */
+    readonly commit: string;
+    /**
+     * The vault path the file was last renamed to.
+     */
+    readonly newPath: string;
+}
+/**
+ * The part of a missing path that a candidate replaced: what a "fix all like this" applies to every other link.
+ */
+export interface PathMapping {
+    /**
+     * The part of the candidate path that replaced {@link oldPrefix}; `''` for the vault root.
+     */
+    readonly newPrefix: string;
+    /**
+     * The leading part of the missing path that no longer exists; `''` for the vault root.
+     */
+    readonly oldPrefix: string;
+}
+/**
+ * Finds the candidates for missing link targets, from one snapshot of the vault.
+ */
+export declare class BrokenLinkCandidateFinder {
+    private readonly aliasesByPath;
+    private readonly childFoldersByFolder;
+    private readonly filePathSet;
+    private readonly filesByLowerCasePath;
+    private readonly filesByName;
+    private readonly folderNoteFileNames;
+    private readonly folderPaths;
+    private readonly gitRenames;
+    private readonly titlesByPath;
+    /**
+     * Indexes the vault snapshot.
+     *
+     * @param params - The snapshot.
+     */
+    constructor(params: BrokenLinkCandidateFinderConstructorParams);
+    /**
+     * Finds the candidates for every missing path at once.
+     *
+     * All at once because one kind of evidence is collective: a renamed folder is recognized by every missing
+     * target that was under it turning up together under one sibling folder.
+     *
+     * @param missingPaths - The vault paths that links lead to and no file holds.
+     * @returns The candidates for each missing path, strongest first; an empty list when nothing is known.
+     */
+    findAll(missingPaths: Iterable<string>): Map<string, BrokenLinkCandidate[]>;
+    private addAliasAndTitleCandidates;
+    private addCaseChangeCandidates;
+    private addGitRenameCandidate;
+    private addRenamedFolderCandidates;
+    private addSameNameCandidates;
+    /**
+     * Groups the missing paths by the highest missing folder above each, the root of a subtree that may have been
+     * renamed as a whole.
+     *
+     * @param missingPaths - The missing paths.
+     * @returns Each missing path's subtree; a path whose own folder exists has none.
+     */
+    private getMissingSubtrees;
+}
+/**
+ * The parent folder of a vault path.
+ *
+ * @param path - The path.
+ * @returns The parent folder; `''` for the vault root.
+ */
+export declare function getParentPath(path: string): string;
+/**
+ * The part of a missing path that a candidate path replaced, found by dropping the path segments they end with
+ * in common.
+ *
+ * @param oldPath - The missing path.
+ * @param newPath - The candidate path.
+ * @returns The prefixes that differ.
+ */
+export declare function getPathMapping(oldPath: string, newPath: string): PathMapping;