@mnaoumov/obsidian-lib 10.5.1 → 10.7.0

package/dist/lib/cjs/inline-token-renderer.d.cts

@@ -0,0 +1,88 @@
+/// <reference path="./library-references.d.cts" />
+/// <reference lib="dom" />
+/**
+ * @file
+ *
+ * One definition of an inline token that renders in both Reading view and Live Preview.
+ *
+ * A token is a regular expression and a render function. {@link registerInlineTokenRenderer} registers a Markdown
+ * post processor that renders every match found in the rendered text, and an editor extension that replaces every
+ * match with a widget in Live Preview, both calling the same function, so the two views cannot drift apart.
+ *
+ * The Reading-view half walks text nodes only, so a token is never matched across an element boundary, and it skips
+ * text inside the elements `skipSelector` names (code by default). The editor half matches each line's source text,
+ * Markdown markup included; see `shouldDecorate` to skip code there.
+ */
+import type { MarkdownPostProcessorContext } from 'obsidian' with { 'resolution-mode': 'import' };
+import type { CreateInlineTokenWidgetsExtensionParams, InlineTokenRenderFunction } from './codemirror/inline-token-widgets.cjs';
+import type { EditorExtensionRegistrar } from './editor-extension-registrar.cjs';
+import type { MarkdownPostProcessorRegistrar } from './markdown-post-processor-registrar.cjs';
+/**
+ * The default selector of the elements whose text is never matched in Reading view.
+ */
+export declare const DEFAULT_INLINE_TOKEN_SKIP_SELECTOR = "code, pre";
+/**
+ * Parameters for {@link createInlineTokenPostProcessor}.
+ */
+export interface CreateInlineTokenPostProcessorParams {
+    /**
+     * The regular expression a token matches. The `g` flag is added when missing.
+     */
+    readonly regExp: RegExp;
+    /**
+     * Renders a token into its element.
+     */
+    readonly render: InlineTokenRenderFunction;
+    /**
+     * The selector of the elements whose text is never matched.
+     *
+     * @default {@link DEFAULT_INLINE_TOKEN_SKIP_SELECTOR}
+     */
+    readonly skipSelector?: string;
+}
+/**
+ * Parameters for {@link registerInlineTokenRenderer}.
+ */
+export interface RegisterInlineTokenRendererParams extends CreateInlineTokenPostProcessorParams, CreateInlineTokenWidgetsExtensionParams {
+    /**
+     * The registrar the editor extension is registered through.
+     */
+    readonly editorExtensionRegistrar: EditorExtensionRegistrar;
+    /**
+     * The registrar the Reading-view post processor is registered through.
+     */
+    readonly markdownPostProcessorRegistrar: MarkdownPostProcessorRegistrar;
+    /**
+     * The sort order of the post processor.
+     *
+     * @default `0`
+     */
+    readonly sortOrder?: number;
+}
+/**
+ * Creates a Markdown post processor that renders every match of a regular expression found in the rendered text.
+ *
+ * @param params - The post processor parameters.
+ * @returns The post processor.
+ */
+export declare function createInlineTokenPostProcessor(params: CreateInlineTokenPostProcessorParams): (element: HTMLElement, context: Pick<MarkdownPostProcessorContext, 'sourcePath'>) => void;
+/**
+ * Registers an inline token in both Reading view and Live Preview, from one definition.
+ *
+ * Obsidian ties both registrations to the plugin's lifetime and offers no way to remove either earlier.
+ *
+ * @param params - The registration parameters.
+ *
+ * @example
+ * ```ts
+ * registerInlineTokenRenderer({
+ *   editorExtensionRegistrar: new PluginEditorExtensionRegistrar(this),
+ *   markdownPostProcessorRegistrar: new PluginMarkdownPostProcessorRegistrar(this),
+ *   regExp: /:([a-z]+):/,
+ *   render({ containerEl, match }) {
+ *     containerEl.setText(EMOJI[match[1] ?? ''] ?? match[0]);
+ *   }
+ * });
+ * ```
+ */
+export declare function registerInlineTokenRenderer(params: RegisterInlineTokenRendererParams): void;

package/dist/lib/cjs/link-and-tag-input-suggest.cjs

@@ -0,0 +1,325 @@
+/*
+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();
+})();
+(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);
+    }
+    const app = globalThis.app;
+    if (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 link_and_tag_input_suggest_exports = {};
+__export(link_and_tag_input_suggest_exports, {
+  LinkAndTagCompletionKind: () => LinkAndTagCompletionKind,
+  LinkAndTagInputSuggest: () => LinkAndTagInputSuggest,
+  getLinkAndTagCompletionTrigger: () => getLinkAndTagCompletionTrigger,
+  getVaultTagSuggestions: () => getVaultTagSuggestions
+});
+module.exports = __toCommonJS(link_and_tag_input_suggest_exports);
+var import_object_utils = require('@mnaoumov/typescript-lib/object-utils');
+var import_obsidian = require('obsidian');
+var LinkAndTagCompletionKind = /* @__PURE__ */ ((LinkAndTagCompletionKind2) => {
+  LinkAndTagCompletionKind2["Link"] = "link";
+  LinkAndTagCompletionKind2["Tag"] = "tag";
+  return LinkAndTagCompletionKind2;
+})(LinkAndTagCompletionKind || {});
+const LINK_OPEN = "[[";
+const LINK_CLOSE = "]]";
+const TAG_PREFIX = "#";
+const TAG_BEFORE_CARET_REG_EXP = /(?:^|\s)#[\p{L}\p{N}_/-]*$/u;
+class LinkAndTagInputSuggest extends import_obsidian.AbstractInputSuggest {
+  /**
+   * The element the suggest completes in.
+   */
+  inputEl;
+  /**
+   * Whether `[[` completes links.
+   */
+  shouldSuggestLinks;
+  /**
+   * Whether `#` completes tags.
+   */
+  shouldSuggestTags;
+  /**
+   * The path that inserted links are relative to.
+   */
+  sourcePath;
+  /**
+   * Creates the suggest and attaches it to the element.
+   *
+   * @param params - The parameters.
+   */
+  constructor(params) {
+    super(params.app, (0, import_object_utils.castTo)(params.inputEl));
+    this.inputEl = params.inputEl;
+    this.shouldSuggestLinks = params.shouldSuggestLinks ?? true;
+    this.shouldSuggestTags = params.shouldSuggestTags ?? true;
+    this.sourcePath = params.sourcePath ?? "";
+  }
+  /**
+   * Gets the value of the element.
+   *
+   * @returns The value.
+   */
+  getValue() {
+    return this.inputEl.value;
+  }
+  /**
+   * Renders a suggestion.
+   *
+   * @param suggestion - The suggestion.
+   * @param el - The element to render into.
+   */
+  renderSuggestion(suggestion, el) {
+    if (suggestion.kind === "link" /* Link */) {
+      el.createDiv({ cls: "suggestion-title", text: suggestion.linktext });
+      if (suggestion.linktext !== suggestion.file.path) {
+        el.createDiv({ cls: "suggestion-note", text: suggestion.file.path });
+      }
+      return;
+    }
+    el.addClass("mod-complex");
+    el.createDiv({ cls: "suggestion-content", text: `${TAG_PREFIX}${suggestion.tag}` });
+    el.createDiv({ cls: "suggestion-aux", text: String(suggestion.count) });
+  }
+  /**
+   * Inserts the suggestion in place of the trigger, moves the caret after it and dispatches an `input` event, so a
+   * component listening on the element sees the change.
+   *
+   * @param suggestion - The suggestion.
+   * @param $event - The event that selected it.
+   */
+  selectSuggestion(suggestion, $event) {
+    const trigger = this.getTrigger();
+    if (trigger) {
+      const value = this.getValue();
+      let after = value.slice(trigger.end);
+      let insertion;
+      if (suggestion.kind === "link" /* Link */) {
+        insertion = `${LINK_OPEN}${suggestion.linktext}${LINK_CLOSE}`;
+        if (after.startsWith(LINK_CLOSE)) {
+          after = after.slice(LINK_CLOSE.length);
+        }
+      } else {
+        insertion = `${TAG_PREFIX}${suggestion.tag} `;
+      }
+      this.setValue(value.slice(0, trigger.start) + insertion + after);
+      const caret = trigger.start + insertion.length;
+      this.inputEl.setSelectionRange(caret, caret);
+      this.inputEl.dispatchEvent(new Event("input", { bubbles: true }));
+    }
+    super.selectSuggestion(suggestion, $event);
+    this.close();
+  }
+  /**
+   * Sets the value of the element.
+   *
+   * @param value - The value.
+   */
+  setValue(value) {
+    this.inputEl.value = value;
+  }
+  /**
+   * Gets the link suggestions for a query.
+   *
+   * @param query - The text typed after `[[`.
+   * @returns The suggestions, best match first.
+   */
+  getLinkSuggestions(query) {
+    const fuzzySearch = (0, import_obsidian.prepareFuzzySearch)(query);
+    const results = [];
+    for (const file of this.app.vault.getFiles()) {
+      const linktext = this.app.metadataCache.fileToLinktext(file, this.sourcePath, true);
+      const match = fuzzySearch(linktext) ?? fuzzySearch(file.path);
+      if (match) {
+        results.push({ match, suggestion: { file, kind: "link" /* Link */, linktext } });
+      }
+    }
+    (0, import_obsidian.sortSearchResults)(results);
+    return results.map((result) => result.suggestion);
+  }
+  /**
+   * Gets the suggestions for the trigger before the caret. The query Obsidian passes is the whole value, so it is
+   * ignored.
+   *
+   * @returns The suggestions.
+   */
+  getSuggestions() {
+    const trigger = this.getTrigger();
+    if (trigger?.kind === "link" /* Link */) {
+      return this.getLinkSuggestions(trigger.query);
+    }
+    return trigger?.kind === "tag" /* Tag */ ? this.getTagSuggestions(trigger.query) : [];
+  }
+  /**
+   * Gets the tag suggestions for a query, from the tags of every note.
+   *
+   * @param query - The text typed after `#`.
+   * @returns The suggestions, best match first, then the most used.
+   */
+  getTagSuggestions(query) {
+    return getVaultTagSuggestions({ app: this.app, query });
+  }
+  /**
+   * Gets the enabled trigger before the caret.
+   *
+   * @returns The trigger, or `null`.
+   */
+  getTrigger() {
+    const value = this.getValue();
+    const trigger = getLinkAndTagCompletionTrigger(value, this.inputEl.selectionStart ?? value.length);
+    if (trigger?.kind === "link" /* Link */ && !this.shouldSuggestLinks) {
+      return null;
+    }
+    return trigger?.kind === "tag" /* Tag */ && !this.shouldSuggestTags ? null : trigger;
+  }
+}
+function getLinkAndTagCompletionTrigger(text, caret) {
+  const beforeCaret = text.slice(0, caret);
+  const linkStart = beforeCaret.lastIndexOf(LINK_OPEN);
+  if (linkStart !== -1) {
+    const query = beforeCaret.slice(linkStart + LINK_OPEN.length);
+    if (!query.includes(LINK_CLOSE) && !query.includes("\n") && !query.includes("|")) {
+      return { end: caret, kind: "link" /* Link */, query, start: linkStart };
+    }
+  }
+  if (TAG_BEFORE_CARET_REG_EXP.test(beforeCaret)) {
+    const start = beforeCaret.lastIndexOf(TAG_PREFIX);
+    return { end: caret, kind: "tag" /* Tag */, query: beforeCaret.slice(start + TAG_PREFIX.length), start };
+  }
+  return null;
+}
+function getVaultTagSuggestions(params) {
+  const { app, query } = params;
+  const counts = /* @__PURE__ */ new Map();
+  for (const file of app.vault.getMarkdownFiles()) {
+    const cache = app.metadataCache.getFileCache(file);
+    for (const tag of (cache ? (0, import_obsidian.getAllTags)(cache) : null) ?? []) {
+      const name = tag.slice(TAG_PREFIX.length);
+      counts.set(name, (counts.get(name) ?? 0) + 1);
+    }
+  }
+  const fuzzySearch = (0, import_obsidian.prepareFuzzySearch)(query);
+  const results = [];
+  const sortedCounts = [...counts].sort(([tag1, count1], [tag2, count2]) => count2 - count1 || tag1.localeCompare(tag2));
+  for (const [tag, count] of sortedCounts) {
+    const match = fuzzySearch(tag);
+    if (match) {
+      results.push({ match, suggestion: { count, kind: "tag" /* Tag */, tag } });
+    }
+  }
+  (0, import_obsidian.sortSearchResults)(results);
+  return results.map((result) => result.suggestion);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LinkAndTagCompletionKind,
+  LinkAndTagInputSuggest,
+  getLinkAndTagCompletionTrigger,
+  getVaultTagSuggestions
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saW5rLWFuZC10YWctaW5wdXQtc3VnZ2VzdC50cyJdLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29tcGxldGVzIGBbW2AgbGlua3MgYW5kIGAjYCB0YWdzIGF0IHRoZSBjYXJldCBvZiBhbnkgYDxpbnB1dD5gIG9yIGA8dGV4dGFyZWE+YCwgdGhlIHdheSB0aGUgZWRpdG9yIGRvZXMuXG4gKi9cblxuaW1wb3J0IHR5cGUge1xuICBBcHAsXG4gIFNlYXJjaFJlc3VsdCxcbiAgVEZpbGVcbn0gZnJvbSAnb2JzaWRpYW4nO1xuXG5pbXBvcnQgeyBjYXN0VG8gfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvb2JqZWN0LXV0aWxzJztcbmltcG9ydCB7XG4gIEFic3RyYWN0SW5wdXRTdWdnZXN0LFxuICBnZXRBbGxUYWdzLFxuICBwcmVwYXJlRnV6enlTZWFyY2gsXG4gIHNvcnRTZWFyY2hSZXN1bHRzXG59IGZyb20gJ29ic2lkaWFuJztcblxuLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby11bnVzZWQtdmFycyAtLSBXZSBuZWVkIHRvIGltcG9ydCBgVGFnTGlzdENvbXBvbmVudGAgdG8gdXNlIGl0IGluIHRoZSB0c2RvY3MuXG5pbXBvcnQgdHlwZSB7IFRhZ0xpc3RDb21wb25lbnQgfSBmcm9tICcuL3NldHRpbmctY29tcG9uZW50cy90YWctbGlzdC1jb21wb25lbnQudHMnO1xuXG4vKipcbiAqIFdoYXQgYSBjb21wbGV0aW9uIHRyaWdnZXIgY29tcGxldGVzLlxuICovXG5leHBvcnQgZW51bSBMaW5rQW5kVGFnQ29tcGxldGlvbktpbmQge1xuICAvKipcbiAgICogQSBgW1tgIHdpa2lsaW5rIHRvIGEgdmF1bHQgZmlsZS5cbiAgICovXG4gIExpbmsgPSAnbGluaycsXG5cbiAgLyoqXG4gICAqIEEgYCNgIHRhZy5cbiAgICovXG4gIFRhZyA9ICd0YWcnXG59XG5cbi8qKlxuICogQSBjb21wbGV0aW9uIHRyaWdnZXIgZm91bmQgYmVmb3JlIHRoZSBjYXJldC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBMaW5rQW5kVGFnQ29tcGxldGlvblRyaWdnZXIge1xuICAvKipcbiAgICogVGhlIG9mZnNldCBvZiB0aGUgY2FyZXQsIHdoZXJlIHRoZSBxdWVyeSBlbmRzLlxuICAgKi9cbiAgcmVhZG9ubHkgZW5kOiBudW1iZXI7XG5cbiAgLyoqXG4gICAqIFdoYXQgdGhlIHRyaWdnZXIgY29tcGxldGVzLlxuICAgKi9cbiAgcmVhZG9ubHkga2luZDogTGlua0FuZFRhZ0NvbXBsZXRpb25LaW5kO1xuXG4gIC8qKlxuICAgKiBUaGUgdGV4dCB0eXBlZCBhZnRlciB0aGUgdHJpZ2dlciBjaGFyYWN0ZXJzLlxuICAgKi9cbiAgcmVhZG9ubHkgcXVlcnk6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIG9mZnNldCBvZiB0aGUgdHJpZ2dlciBjaGFyYWN0ZXJzOiB0aGUgZmlyc3QgYFtgIG9mIGBbW2AsIG9yIHRoZSBgI2AuXG4gICAqL1xuICByZWFkb25seSBzdGFydDogbnVtYmVyO1xufVxuXG4vKipcbiAqIFBhcmFtZXRlcnMgb2Yge0BsaW5rIExpbmtBbmRUYWdJbnB1dFN1Z2dlc3R9LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIExpbmtBbmRUYWdJbnB1dFN1Z2dlc3RDb25zdHJ1Y3RvclBhcmFtcyB7XG4gIC8qKlxuICAgKiBUaGUgT2JzaWRpYW4gYXBwIGluc3RhbmNlLlxuICAgKi9cbiAgcmVhZG9ubHkgYXBwOiBBcHA7XG5cbiAgLyoqXG4gICAqIFRoZSBlbGVtZW50IHRvIGNvbXBsZXRlIGluLlxuICAgKi9cbiAgcmVhZG9ubHkgaW5wdXRFbDogSFRNTElucHV0RWxlbWVudCB8IEhUTUxUZXh0QXJlYUVsZW1lbnQ7XG5cbiAgLyoqXG4gICAqIFdoZXRoZXIgYFtbYCBjb21wbGV0ZXMgbGlua3MuIERlZmF1bHRzIHRvIGB0cnVlYC5cbiAgICovXG4gIHJlYWRvbmx5IHNob3VsZFN1Z2dlc3RMaW5rcz86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIFdoZXRoZXIgYCNgIGNvbXBsZXRlcyB0YWdzLiBEZWZhdWx0cyB0byBgdHJ1ZWAuXG4gICAqL1xuICByZWFkb25seSBzaG91bGRTdWdnZXN0VGFncz86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIFRoZSBwYXRoIHRoYXQgaW5zZXJ0ZWQgbGlua3MgYXJlIHJlbGF0aXZlIHRvLiBEZWZhdWx0cyB0byB0aGUgdmF1bHQgcm9vdC5cbiAgICovXG4gIHJlYWRvbmx5IHNvdXJjZVBhdGg/OiBzdHJpbmc7XG59XG5cbi8qKlxuICogQSBzdWdnZXN0aW9uIG9mIHtAbGluayBMaW5rQW5kVGFnSW5wdXRTdWdnZXN0fS5cbiAqL1xuZXhwb3J0IHR5cGUgTGlua0FuZFRhZ1N1Z2dlc3Rpb24gPSBMaW5rU3VnZ2VzdGlvbiB8IFRhZ1N1Z2dlc3Rpb247XG5cbi8qKlxuICogQSBzdWdnZXN0ZWQgbGluay5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBMaW5rU3VnZ2VzdGlvbiB7XG4gIC8qKlxuICAgKiBUaGUgZmlsZSB0aGUgbGluayBwb2ludHMgdG8uXG4gICAqL1xuICByZWFkb25seSBmaWxlOiBURmlsZTtcblxuICAvKipcbiAgICogVGhlIGtpbmQgb2YgdGhlIHN1Z2dlc3Rpb24uXG4gICAqL1xuICByZWFkb25seSBraW5kOiBMaW5rQW5kVGFnQ29tcGxldGlvbktpbmQuTGluaztcblxuICAvKipcbiAgICogVGhlIGxpbmsgdGV4dCBpbnNlcnRlZCBiZXR3ZWVuIGBbW2AgYW5kIGBdXWAuXG4gICAqL1xuICByZWFkb25seSBsaW5rdGV4dDogc3RyaW5nO1xufVxuXG4vKipcbiAqIEEgc3VnZ2VzdGVkIHRhZy5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBUYWdTdWdnZXN0aW9uIHtcbiAgLyoqXG4gICAqIEhvdyBtYW55IHRhZyBvY2N1cnJlbmNlcyB0aGUgdmF1bHQgaG9sZHMuXG4gICAqL1xuICByZWFkb25seSBjb3VudDogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBUaGUga2luZCBvZiB0aGUgc3VnZ2VzdGlvbi5cbiAgICovXG4gIHJlYWRvbmx5IGtpbmQ6IExpbmtBbmRUYWdDb21wbGV0aW9uS2luZC5UYWc7XG5cbiAgLyoqXG4gICAqIFRoZSB0YWcsIHdpdGhvdXQgaXRzIGAjYC5cbiAgICovXG4gIHJlYWRvbmx5IHRhZzogc3RyaW5nO1xufVxuXG5pbnRlcmZhY2UgU3VnZ2VzdGlvblNlYXJjaFJlc3VsdDxUPiB7XG4gIHJlYWRvbmx5IG1hdGNoOiBTZWFyY2hSZXN1bHQ7XG4gIHJlYWRvbmx5IHN1Z2dlc3Rpb246IFQ7XG59XG5cbmNvbnN0IExJTktfT1BFTiA9ICdbWyc7XG5jb25zdCBMSU5LX0NMT1NFID0gJ11dJztcbmNvbnN0IFRBR19QUkVGSVggPSAnIyc7XG5jb25zdCBUQUdfQkVGT1JFX0NBUkVUX1JFR19FWFAgPSAvKD86XnxcXHMpI1tcXHB7TH1cXHB7Tn1fLy1dKiQvdTtcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgZ2V0VmF1bHRUYWdTdWdnZXN0aW9uc30uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgR2V0VmF1bHRUYWdTdWdnZXN0aW9uc1BhcmFtcyB7XG4gIC8qKlxuICAgKiBUaGUgT2JzaWRpYW4gYXBwLlxuICAgKi9cbiAgcmVhZG9ubHkgYXBwOiBBcHA7XG5cbiAgLyoqXG4gICAqIFRoZSB0ZXh0IHR5cGVkLCB3aXRob3V0IHRoZSBgI2AuXG4gICAqL1xuICByZWFkb25seSBxdWVyeTogc3RyaW5nO1xufVxuXG4vKipcbiAqIENvbXBsZXRlcyBgW1tgIGxpbmtzIGFuZCBgI2AgdGFncyBpbnNpZGUgYW55IGA8aW5wdXQ+YCBvciBgPHRleHRhcmVhPmAuXG4gKlxuICogT2JzaWRpYW4ncyB7QGxpbmsgQWJzdHJhY3RJbnB1dFN1Z2dlc3R9IHRyZWF0cyB0aGUgd2hvbGUgdmFsdWUgYXMgdGhlIHF1ZXJ5IGFuZCByZXBsYWNlcyBpdCBvbiBzZWxlY3Rpb24uIFRoaXMgb25lXG4gKiByZWFkcyB0aGUgdHJpZ2dlciBiZWZvcmUgdGhlIGNhcmV0IGFuZCByZXBsYWNlcyBvbmx5IHRoYXQsIHNvIGl0IHdvcmtzIGluc2lkZSBmcmVlIHRleHQgc3VjaCBhcyBhIHRlbXBsYXRlIG9yIGFcbiAqIGRlc2NyaXB0aW9uIHNldHRpbmcsIGFuZCBpdCBhY2NlcHRzIGEgYDx0ZXh0YXJlYT5gIHRvby5cbiAqXG4gKiBgYGB0c1xuICogbmV3IFNldHRpbmcoY29udGFpbmVyRWwpLmFkZFRleHRBcmVhKCh0ZXh0QXJlYSkgPT4ge1xuICogICBuZXcgTGlua0FuZFRhZ0lucHV0U3VnZ2VzdCh7IGFwcDogdGhpcy5hcHAsIGlucHV0RWw6IHRleHRBcmVhLmlucHV0RWwgfSk7XG4gKiB9KTtcbiAqIGBgYFxuICovXG5leHBvcnQgY2xhc3MgTGlua0FuZFRhZ0lucHV0U3VnZ2VzdCBleHRlbmRzIEFic3RyYWN0SW5wdXRTdWdnZXN0PExpbmtBbmRUYWdTdWdnZXN0aW9uPiB7XG4gIC8qKlxuICAgKiBUaGUgZWxlbWVudCB0aGUgc3VnZ2VzdCBjb21wbGV0ZXMgaW4uXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgaW5wdXRFbDogSFRNTElucHV0RWxlbWVudCB8IEhUTUxUZXh0QXJlYUVsZW1lbnQ7XG5cbiAgLyoqXG4gICAqIFdoZXRoZXIgYFtbYCBjb21wbGV0ZXMgbGlua3MuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgc2hvdWxkU3VnZ2VzdExpbmtzOiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBXaGV0aGVyIGAjYCBjb21wbGV0ZXMgdGFncy5cbiAgICovXG4gIHByb3RlY3RlZCByZWFkb25seSBzaG91bGRTdWdnZXN0VGFnczogYm9vbGVhbjtcblxuICAvKipcbiAgICogVGhlIHBhdGggdGhhdCBpbnNlcnRlZCBsaW5rcyBhcmUgcmVsYXRpdmUgdG8uXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgc291cmNlUGF0aDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBDcmVhdGVzIHRoZSBzdWdnZXN0IGFuZCBhdHRhY2hlcyBpdCB0byB0aGUgZWxlbWVudC5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHBhcmFtczogTGlua0FuZFRhZ0lucHV0U3VnZ2VzdENvbnN0cnVjdG9yUGFyYW1zKSB7XG4gICAgLy8gT2JzaWRpYW4ncyBzdWdnZXN0IHJlYWRzIHRoZSB2YWx1ZSBvbmx5IHRocm91Z2ggYGdldFZhbHVlYCBhbmQgYHNldFZhbHVlYCwgYm90aCBvdmVycmlkZGVuIGhlcmUsIHNvIGEgdGV4dGFyZWEgd29ya3MgdG9vLlxuICAgIHN1cGVyKHBhcmFtcy5hcHAsIGNhc3RUbzxIVE1MSW5wdXRFbGVtZW50PihwYXJhbXMuaW5wdXRFbCkpO1xuICAgIHRoaXMuaW5wdXRFbCA9IHBhcmFtcy5pbnB1dEVsO1xuICAgIHRoaXMuc2hvdWxkU3VnZ2VzdExpbmtzID0gcGFyYW1zLnNob3VsZFN1Z2dlc3RMaW5rcyA/PyB0cnVlO1xuICAgIHRoaXMuc2hvdWxkU3VnZ2VzdFRhZ3MgPSBwYXJhbXMuc2hvdWxkU3VnZ2VzdFRhZ3MgPz8gdHJ1ZTtcbiAgICB0aGlzLnNvdXJjZVBhdGggPSBwYXJhbXMuc291cmNlUGF0aCA/PyAnJztcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXRzIHRoZSB2YWx1ZSBvZiB0aGUgZWxlbWVudC5cbiAgICpcbiAgICogQHJldHVybnMgVGhlIHZhbHVlLlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIGdldFZhbHVlKCk6IHN0cmluZyB7XG4gICAgcmV0dXJuIHRoaXMuaW5wdXRFbC52YWx1ZTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZW5kZXJzIGEgc3VnZ2VzdGlvbi5cbiAgICpcbiAgICogQHBhcmFtIHN1Z2dlc3Rpb24gLSBUaGUgc3VnZ2VzdGlvbi5cbiAgICogQHBhcmFtIGVsIC0gVGhlIGVsZW1lbnQgdG8gcmVuZGVyIGludG8uXG4gICAqL1xuICBwdWJsaWMgcmVuZGVyU3VnZ2VzdGlvbihzdWdnZXN0aW9uOiBMaW5rQW5kVGFnU3VnZ2VzdGlvbiwgZWw6IEhUTUxFbGVtZW50KTogdm9pZCB7XG4gICAgaWYgKHN1Z2dlc3Rpb24ua2luZCA9PT0gTGlua0FuZFRhZ0NvbXBsZXRpb25LaW5kLkxpbmspIHtcbiAgICAgIGVsLmNyZWF0ZURpdih7IGNsczogJ3N1Z2dlc3Rpb24tdGl0bGUnLCB0ZXh0OiBzdWdnZXN0aW9uLmxpbmt0ZXh0IH0pO1xuICAgICAgaWYgKHN1Z2dlc3Rpb24ubGlua3RleHQgIT09IHN1Z2dlc3Rpb24uZmlsZS5wYXRoKSB7XG4gICAgICAgIGVsLmNyZWF0ZURpdih7IGNsczogJ3N1Z2dlc3Rpb24tbm90ZScsIHRleHQ6IHN1Z2dlc3Rpb24uZmlsZS5wYXRoIH0pO1xuICAgICAgfVxuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIGVsLmFkZENsYXNzKCdtb2QtY29tcGxleCcpO1xuICAgIGVsLmNyZWF0ZURpdih7IGNsczogJ3N1Z2dlc3Rpb24tY29udGVudCcsIHRleHQ6IGAke1RBR19QUkVGSVh9JHtzdWdnZXN0aW9uLnRhZ31gIH0pO1xuICAgIGVsLmNyZWF0ZURpdih7IGNsczogJ3N1Z2dlc3Rpb24tYXV4JywgdGV4dDogU3RyaW5nKHN1Z2dlc3Rpb24uY291bnQpIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIEluc2VydHMgdGhlIHN1Z2dlc3Rpb24gaW4gcGxhY2Ugb2YgdGhlIHRyaWdnZXIsIG1vdmVzIHRoZSBjYXJldCBhZnRlciBpdCBhbmQgZGlzcGF0Y2hlcyBhbiBgaW5wdXRgIGV2ZW50LCBzbyBhXG4gICAqIGNvbXBvbmVudCBsaXN0ZW5pbmcgb24gdGhlIGVsZW1lbnQgc2VlcyB0aGUgY2hhbmdlLlxuICAgKlxuICAgKiBAcGFyYW0gc3VnZ2VzdGlvbiAtIFRoZSBzdWdnZXN0aW9uLlxuICAgKiBAcGFyYW0gJGV2ZW50IC0gVGhlIGV2ZW50IHRoYXQgc2VsZWN0ZWQgaXQuXG4gICAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgc2VsZWN0U3VnZ2VzdGlvbihzdWdnZXN0aW9uOiBMaW5rQW5kVGFnU3VnZ2VzdGlvbiwgJGV2ZW50OiBLZXlib2FyZEV2ZW50IHwgTW91c2VFdmVudCk6IHZvaWQge1xuICAgIGNvbnN0IHRyaWdnZXIgPSB0aGlzLmdldFRyaWdnZXIoKTtcbiAgICBpZiAodHJpZ2dlcikge1xuICAgICAgY29uc3QgdmFsdWUgPSB0aGlzLmdldFZhbHVlKCk7XG4gICAgICBsZXQgYWZ0ZXIgPSB2YWx1ZS5zbGljZSh0cmlnZ2VyLmVuZCk7XG4gICAgICBsZXQgaW5zZXJ0aW9uOiBzdHJpbmc7XG4gICAgICBpZiAoc3VnZ2VzdGlvbi5raW5kID09PSBMaW5rQW5kVGFnQ29tcGxldGlvbktpbmQuTGluaykge1xuICAgICAgICBpbnNlcnRpb24gPSBgJHtMSU5LX09QRU59JHtzdWdnZXN0aW9uLmxpbmt0ZXh0fSR7TElOS19DTE9TRX1gO1xuICAgICAgICBpZiAoYWZ0ZXIuc3RhcnRzV2l0aChMSU5LX0NMT1NFKSkge1xuICAgICAgICAgIGFmdGVyID0gYWZ0ZXIuc2xpY2UoTElOS19DTE9TRS5sZW5ndGgpO1xuICAgICAgICB9XG4gICAgICB9IGVsc2Uge1xuICAgICAgICBpbnNlcnRpb24gPSBgJHtUQUdfUFJFRklYfSR7c3VnZ2VzdGlvbi50YWd9IGA7XG4gICAgICB9XG5cbiAgICAgIHRoaXMuc2V0VmFsdWUodmFsdWUuc2xpY2UoMCwgdHJpZ2dlci5zdGFydCkgKyBpbnNlcnRpb24gKyBhZnRlcik7XG4gICAgICBjb25zdCBjYXJldCA9IHRyaWdnZXIuc3RhcnQgKyBpbnNlcnRpb24ubGVuZ3RoO1xuICAgICAgdGhpcy5pbnB1dEVsLnNldFNlbGVjdGlvblJhbmdlKGNhcmV0LCBjYXJldCk7XG4gICAgICB0aGlzLmlucHV0RWwuZGlzcGF0Y2hFdmVudChuZXcgRXZlbnQoJ2lucHV0JywgeyBidWJibGVzOiB0cnVlIH0pKTtcbiAgICB9XG5cbiAgICBzdXBlci5zZWxlY3RTdWdnZXN0aW9uKHN1Z2dlc3Rpb24sICRldmVudCk7XG4gICAgdGhpcy5jbG9zZSgpO1xuICB9XG5cbiAgLyoqXG4gICAqIFNldHMgdGhlIHZhbHVlIG9mIHRoZSBlbGVtZW50LlxuICAgKlxuICAgKiBAcGFyYW0gdmFsdWUgLSBUaGUgdmFsdWUuXG4gICAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgc2V0VmFsdWUodmFsdWU6IHN0cmluZyk6IHZvaWQge1xuICAgIHRoaXMuaW5wdXRFbC52YWx1ZSA9IHZhbHVlO1xuICB9XG5cbiAgLyoqXG4gICAqIEdldHMgdGhlIGxpbmsgc3VnZ2VzdGlvbnMgZm9yIGEgcXVlcnkuXG4gICAqXG4gICAqIEBwYXJhbSBxdWVyeSAtIFRoZSB0ZXh0IHR5cGVkIGFmdGVyIGBbW2AuXG4gICAqIEByZXR1cm5zIFRoZSBzdWdnZXN0aW9ucywgYmVzdCBtYXRjaCBmaXJzdC5cbiAgICovXG4gIHByb3RlY3RlZCBnZXRMaW5rU3VnZ2VzdGlvbnMocXVlcnk6IHN0cmluZyk6IExpbmtTdWdnZXN0aW9uW10ge1xuICAgIGNvbnN0IGZ1enp5U2VhcmNoID0gcHJlcGFyZUZ1enp5U2VhcmNoKHF1ZXJ5KTtcbiAgICBjb25zdCByZXN1bHRzOiBTdWdnZXN0aW9uU2VhcmNoUmVzdWx0PExpbmtTdWdnZXN0aW9uPltdID0gW107XG4gICAgZm9yIChjb25zdCBmaWxlIG9mIHRoaXMuYXBwLnZhdWx0LmdldEZpbGVzKCkpIHtcbiAgICAgIGNvbnN0IGxpbmt0ZXh0ID0gdGhpcy5hcHAubWV0YWRhdGFDYWNoZS5maWxlVG9MaW5rdGV4dChmaWxlLCB0aGlzLnNvdXJjZVBhdGgsIHRydWUpO1xuICAgICAgY29uc3QgbWF0Y2ggPSBmdXp6eVNlYXJjaChsaW5rdGV4dCkgPz8gZnV6enlTZWFyY2goZmlsZS5wYXRoKTtcbiAgICAgIGlmIChtYXRjaCkge1xuICAgICAgICByZXN1bHRzLnB1c2goeyBtYXRjaCwgc3VnZ2VzdGlvbjogeyBmaWxlLCBraW5kOiBMaW5rQW5kVGFnQ29tcGxldGlvbktpbmQuTGluaywgbGlua3RleHQgfSB9KTtcbiAgICAgIH1cbiAgICB9XG4gICAgc29ydFNlYXJjaFJlc3VsdHMocmVzdWx0cyk7XG4gICAgcmV0dXJuIHJlc3VsdHMubWFwKChyZXN1bHQpID0+IHJlc3VsdC5zdWdnZXN0aW9uKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXRzIHRoZSBzdWdnZXN0aW9ucyBmb3IgdGhlIHRyaWdnZXIgYmVmb3JlIHRoZSBjYXJldC4gVGhlIHF1ZXJ5IE9ic2lkaWFuIHBhc3NlcyBpcyB0aGUgd2hvbGUgdmFsdWUsIHNvIGl0IGlzXG4gICAqIGlnbm9yZWQuXG4gICAqXG4gICAqIEByZXR1cm5zIFRoZSBzdWdnZXN0aW9ucy5cbiAgICovXG4gIHByb3RlY3RlZCBvdmVycmlkZSBnZXRTdWdnZXN0aW9ucygpOiBMaW5rQW5kVGFnU3VnZ2VzdGlvbltdIHtcbiAgICBjb25zdCB0cmlnZ2VyID0gdGhpcy5nZXRUcmlnZ2VyKCk7XG4gICAgaWYgKHRyaWdnZXI/LmtpbmQgPT09IExpbmtBbmRUYWdDb21wbGV0aW9uS2luZC5MaW5rKSB7XG4gICAgICByZXR1cm4gdGhpcy5nZXRMaW5rU3VnZ2VzdGlvbnModHJpZ2dlci5xdWVyeSk7XG4gICAgfVxuICAgIHJldHVybiB0cmlnZ2VyPy5raW5kID09PSBMaW5rQW5kVGFnQ29tcGxldGlvbktpbmQuVGFnID8gdGhpcy5nZXRUYWdTdWdnZXN0aW9ucyh0cmlnZ2VyLnF1ZXJ5KSA6IFtdO1xuICB9XG5cbiAgLyoqXG4gICAqIEdldHMgdGhlIHRhZyBzdWdnZXN0aW9ucyBmb3IgYSBxdWVyeSwgZnJvbSB0aGUgdGFncyBvZiBldmVyeSBub3RlLlxuICAgKlxuICAgKiBAcGFyYW0gcXVlcnkgLSBUaGUgdGV4dCB0eXBlZCBhZnRlciBgI2AuXG4gICAqIEByZXR1cm5zIFRoZSBzdWdnZXN0aW9ucywgYmVzdCBtYXRjaCBmaXJzdCwgdGhlbiB0aGUgbW9zdCB1c2VkLlxuICAgKi9cbiAgcHJvdGVjdGVkIGdldFRhZ1N1Z2dlc3Rpb25zKHF1ZXJ5OiBzdHJpbmcpOiBUYWdTdWdnZXN0aW9uW10ge1xuICAgIHJldHVybiBnZXRWYXVsdFRhZ1N1Z2dlc3Rpb25zKHsgYXBwOiB0aGlzLmFwcCwgcXVlcnkgfSk7XG4gIH1cblxuICAvKipcbiAgICogR2V0cyB0aGUgZW5hYmxlZCB0cmlnZ2VyIGJlZm9yZSB0aGUgY2FyZXQuXG4gICAqXG4gICAqIEByZXR1cm5zIFRoZSB0cmlnZ2VyLCBvciBgbnVsbGAuXG4gICAqL1xuICBwcm90ZWN0ZWQgZ2V0VHJpZ2dlcigpOiBMaW5rQW5kVGFnQ29tcGxldGlvblRyaWdnZXIgfCBudWxsIHtcbiAgICBjb25zdCB2YWx1ZSA9IHRoaXMuZ2V0VmFsdWUoKTtcbiAgICBjb25zdCB0cmlnZ2VyID0gZ2V0TGlua0FuZFRhZ0NvbXBsZXRpb25UcmlnZ2VyKHZhbHVlLCB0aGlzLmlucHV0RWwuc2VsZWN0aW9uU3RhcnQgPz8gdmFsdWUubGVuZ3RoKTtcbiAgICBpZiAodHJpZ2dlcj8ua2luZCA9PT0gTGlua0FuZFRhZ0NvbXBsZXRpb25LaW5kLkxpbmsgJiYgIXRoaXMuc2hvdWxkU3VnZ2VzdExpbmtzKSB7XG4gICAgICByZXR1cm4gbnVsbDtcbiAgICB9XG4gICAgcmV0dXJuIHRyaWdnZXI/LmtpbmQgPT09IExpbmtBbmRUYWdDb21wbGV0aW9uS2luZC5UYWcgJiYgIXRoaXMuc2hvdWxkU3VnZ2VzdFRhZ3MgPyBudWxsIDogdHJpZ2dlcjtcbiAgfVxufVxuXG4vKipcbiAqIEZpbmRzIHRoZSBgW1tgIGxpbmsgb3IgYCNgIHRhZyBiZWluZyB0eXBlZCBiZWZvcmUgdGhlIGNhcmV0LlxuICpcbiAqIEEgbGluayB0cmlnZ2VyIGlzIGFuIHVuY2xvc2VkIGBbW2Agb24gdGhlIGNhcmV0J3MgbGluZSB3aXRoIG5vIGB8YCBhZnRlciBpdCwgc28gYW4gYWxpYXMgYmVpbmcgdHlwZWQgaXMgbGVmdCBhbG9uZS4gQVxuICogdGFnIHRyaWdnZXIgaXMgYSBgI2AgYXQgdGhlIHN0YXJ0IG9mIHRoZSB0ZXh0IG9yIGFmdGVyIHdoaXRlc3BhY2UsIGZvbGxvd2VkIG9ubHkgYnkgdGFnIGNoYXJhY3RlcnMuXG4gKlxuICogQHBhcmFtIHRleHQgLSBUaGUgdGV4dCBvZiB0aGUgZWxlbWVudC5cbiAqIEBwYXJhbSBjYXJldCAtIFRoZSBvZmZzZXQgb2YgdGhlIGNhcmV0LlxuICogQHJldHVybnMgVGhlIHRyaWdnZXIsIG9yIGBudWxsYCB3aGVuIHRoZSBjYXJldCBpcyBub3QgaW4gb25lLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0TGlua0FuZFRhZ0NvbXBsZXRpb25UcmlnZ2VyKHRleHQ6IHN0cmluZywgY2FyZXQ6IG51bWJlcik6IExpbmtBbmRUYWdDb21wbGV0aW9uVHJpZ2dlciB8IG51bGwge1xuICBjb25zdCBiZWZvcmVDYXJldCA9IHRleHQuc2xpY2UoMCwgY2FyZXQpO1xuICBjb25zdCBsaW5rU3RhcnQgPSBiZWZvcmVDYXJldC5sYXN0SW5kZXhPZihMSU5LX09QRU4pO1xuICBpZiAobGlua1N0YXJ0ICE9PSAtMSkge1xuICAgIGNvbnN0IHF1ZXJ5ID0gYmVmb3JlQ2FyZXQuc2xpY2UobGlua1N0YXJ0ICsgTElOS19PUEVOLmxlbmd0aCk7XG4gICAgaWYgKCFxdWVyeS5pbmNsdWRlcyhMSU5LX0NMT1NFKSAmJiAhcXVlcnkuaW5jbHVkZXMoJ1xcbicpICYmICFxdWVyeS5pbmNsdWRlcygnfCcpKSB7XG4gICAgICByZXR1cm4geyBlbmQ6IGNhcmV0LCBraW5kOiBMaW5rQW5kVGFnQ29tcGxldGlvbktpbmQuTGluaywgcXVlcnksIHN0YXJ0OiBsaW5rU3RhcnQgfTtcbiAgICB9XG4gIH1cblxuICBpZiAoVEFHX0JFRk9SRV9DQVJFVF9SRUdfRVhQLnRlc3QoYmVmb3JlQ2FyZXQpKSB7XG4gICAgLy8gVGhlIHF1ZXJ5IGhvbGRzIG5vICMsIHNvIHRoZSBsYXN0IG9uZSBpcyB0aGUgdHJpZ2dlci5cbiAgICBjb25zdCBzdGFydCA9IGJlZm9yZUNhcmV0Lmxhc3RJbmRleE9mKFRBR19QUkVGSVgpO1xuICAgIHJldHVybiB7IGVuZDogY2FyZXQsIGtpbmQ6IExpbmtBbmRUYWdDb21wbGV0aW9uS2luZC5UYWcsIHF1ZXJ5OiBiZWZvcmVDYXJldC5zbGljZShzdGFydCArIFRBR19QUkVGSVgubGVuZ3RoKSwgc3RhcnQgfTtcbiAgfVxuXG4gIHJldHVybiBudWxsO1xufVxuXG4vKipcbiAqIEdldHMgdGhlIHRhZ3Mgb2YgZXZlcnkgbm90ZSBtYXRjaGluZyBhIHF1ZXJ5LCBhcyB7QGxpbmsgTGlua0FuZFRhZ0lucHV0U3VnZ2VzdH0gYW5kIHtAbGluayBUYWdMaXN0Q29tcG9uZW50fVxuICogc3VnZ2VzdCB0aGVtLlxuICpcbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycy5cbiAqIEByZXR1cm5zIFRoZSBzdWdnZXN0aW9ucywgYmVzdCBtYXRjaCBmaXJzdCwgdGhlbiB0aGUgbW9zdCB1c2VkLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0VmF1bHRUYWdTdWdnZXN0aW9ucyhwYXJhbXM6IEdldFZhdWx0VGFnU3VnZ2VzdGlvbnNQYXJhbXMpOiBUYWdTdWdnZXN0aW9uW10ge1xuICBjb25zdCB7IGFwcCwgcXVlcnkgfSA9IHBhcmFtcztcbiAgY29uc3QgY291bnRzID0gbmV3IE1hcDxzdHJpbmcsIG51bWJlcj4oKTtcbiAgZm9yIChjb25zdCBmaWxlIG9mIGFwcC52YXVsdC5nZXRNYXJrZG93bkZpbGVzKCkpIHtcbiAgICBjb25zdCBjYWNoZSA9IGFwcC5tZXRhZGF0YUNhY2hlLmdldEZpbGVDYWNoZShmaWxlKTtcbiAgICBmb3IgKGNvbnN0IHRhZyBvZiAoY2FjaGUgPyBnZXRBbGxUYWdzKGNhY2hlKSA6IG51bGwpID8/IFtdKSB7XG4gICAgICBjb25zdCBuYW1lID0gdGFnLnNsaWNlKFRBR19QUkVGSVgubGVuZ3RoKTtcbiAgICAgIGNvdW50cy5zZXQobmFtZSwgKGNvdW50cy5nZXQobmFtZSkgPz8gMCkgKyAxKTtcbiAgICB9XG4gIH1cblxuICBjb25zdCBmdXp6eVNlYXJjaCA9IHByZXBhcmVGdXp6eVNlYXJjaChxdWVyeSk7XG4gIGNvbnN0IHJlc3VsdHM6IFN1Z2dlc3Rpb25TZWFyY2hSZXN1bHQ8VGFnU3VnZ2VzdGlvbj5bXSA9IFtdO1xuICBjb25zdCBzb3J0ZWRDb3VudHMgPSBbLi4uY291bnRzXS5zb3J0KChbdGFnMSwgY291bnQxXSwgW3RhZzIsIGNvdW50Ml0pID0+IGNvdW50MiAtIGNvdW50MSB8fCB0YWcxLmxvY2FsZUNvbXBhcmUodGFnMikpO1xuICBmb3IgKGNvbnN0IFt0YWcsIGNvdW50XSBvZiBzb3J0ZWRDb3VudHMpIHtcbiAgICBjb25zdCBtYXRjaCA9IGZ1enp5U2VhcmNoKHRhZyk7XG4gICAgaWYgKG1hdGNoKSB7XG4gICAgICByZXN1bHRzLnB1c2goeyBtYXRjaCwgc3VnZ2VzdGlvbjogeyBjb3VudCwga2luZDogTGlua0FuZFRhZ0NvbXBsZXRpb25LaW5kLlRhZywgdGFnIH0gfSk7XG4gICAgfVxuICB9XG4gIHNvcnRTZWFyY2hSZXN1bHRzKHJlc3VsdHMpO1xuICByZXR1cm4gcmVzdWx0cy5tYXAoKHJlc3VsdCkgPT4gcmVzdWx0LnN1Z2dlc3Rpb24pO1xufVxuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBWUEsMEJBQXVCO0FBQ3ZCLHNCQUtPO0FBUUEsSUFBSywyQkFBTCxrQkFBS0EsOEJBQUw7QUFJTCxFQUFBQSwwQkFBQSxVQUFPO0FBS1AsRUFBQUEsMEJBQUEsU0FBTTtBQVRJLFNBQUFBO0FBQUEsR0FBQTtBQXFIWixNQUFNLFlBQVk7QUFDbEIsTUFBTSxhQUFhO0FBQ25CLE1BQU0sYUFBYTtBQUNuQixNQUFNLDJCQUEyQjtBQThCMUIsTUFBTSwrQkFBK0IscUNBQTJDO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFJbEU7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtBO0FBQUE7QUFBQTtB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

package/dist/lib/cjs/link-and-tag-input-suggest.d.cts

@@ -0,0 +1,229 @@
+/// <reference path="./library-references.d.cts" />
+/// <reference lib="dom" />
+/**
+ * @file
+ *
+ * Completes `[[` links and `#` tags at the caret of any `<input>` or `<textarea>`, the way the editor does.
+ */
+import type { App, TFile } from 'obsidian' with { 'resolution-mode': 'import' };
+import { AbstractInputSuggest } from 'obsidian';
+/**
+ * What a completion trigger completes.
+ */
+export declare enum LinkAndTagCompletionKind {
+    /**
+     * A `[[` wikilink to a vault file.
+     */
+    Link = "link",
+    /**
+     * A `#` tag.
+     */
+    Tag = "tag"
+}
+/**
+ * A completion trigger found before the caret.
+ */
+export interface LinkAndTagCompletionTrigger {
+    /**
+     * The offset of the caret, where the query ends.
+     */
+    readonly end: number;
+    /**
+     * What the trigger completes.
+     */
+    readonly kind: LinkAndTagCompletionKind;
+    /**
+     * The text typed after the trigger characters.
+     */
+    readonly query: string;
+    /**
+     * The offset of the trigger characters: the first `[` of `[[`, or the `#`.
+     */
+    readonly start: number;
+}
+/**
+ * Parameters of {@link LinkAndTagInputSuggest}.
+ */
+export interface LinkAndTagInputSuggestConstructorParams {
+    /**
+     * The Obsidian app instance.
+     */
+    readonly app: App;
+    /**
+     * The element to complete in.
+     */
+    readonly inputEl: HTMLInputElement | HTMLTextAreaElement;
+    /**
+     * Whether `[[` completes links. Defaults to `true`.
+     */
+    readonly shouldSuggestLinks?: boolean;
+    /**
+     * Whether `#` completes tags. Defaults to `true`.
+     */
+    readonly shouldSuggestTags?: boolean;
+    /**
+     * The path that inserted links are relative to. Defaults to the vault root.
+     */
+    readonly sourcePath?: string;
+}
+/**
+ * A suggestion of {@link LinkAndTagInputSuggest}.
+ */
+export type LinkAndTagSuggestion = LinkSuggestion | TagSuggestion;
+/**
+ * A suggested link.
+ */
+export interface LinkSuggestion {
+    /**
+     * The file the link points to.
+     */
+    readonly file: TFile;
+    /**
+     * The kind of the suggestion.
+     */
+    readonly kind: LinkAndTagCompletionKind.Link;
+    /**
+     * The link text inserted between `[[` and `]]`.
+     */
+    readonly linktext: string;
+}
+/**
+ * A suggested tag.
+ */
+export interface TagSuggestion {
+    /**
+     * How many tag occurrences the vault holds.
+     */
+    readonly count: number;
+    /**
+     * The kind of the suggestion.
+     */
+    readonly kind: LinkAndTagCompletionKind.Tag;
+    /**
+     * The tag, without its `#`.
+     */
+    readonly tag: string;
+}
+/**
+ * Parameters for {@link getVaultTagSuggestions}.
+ */
+export interface GetVaultTagSuggestionsParams {
+    /**
+     * The Obsidian app.
+     */
+    readonly app: App;
+    /**
+     * The text typed, without the `#`.
+     */
+    readonly query: string;
+}
+/**
+ * Completes `[[` links and `#` tags inside any `<input>` or `<textarea>`.
+ *
+ * Obsidian's {@link AbstractInputSuggest} treats the whole value as the query and replaces it on selection. This one
+ * reads the trigger before the caret and replaces only that, so it works inside free text such as a template or a
+ * description setting, and it accepts a `<textarea>` too.
+ *
+ * ```ts
+ * new Setting(containerEl).addTextArea((textArea) => {
+ *   new LinkAndTagInputSuggest({ app: this.app, inputEl: textArea.inputEl });
+ * });
+ * ```
+ */
+export declare class LinkAndTagInputSuggest extends AbstractInputSuggest<LinkAndTagSuggestion> {
+    /**
+     * The element the suggest completes in.
+     */
+    protected readonly inputEl: HTMLInputElement | HTMLTextAreaElement;
+    /**
+     * Whether `[[` completes links.
+     */
+    protected readonly shouldSuggestLinks: boolean;
+    /**
+     * Whether `#` completes tags.
+     */
+    protected readonly shouldSuggestTags: boolean;
+    /**
+     * The path that inserted links are relative to.
+     */
+    protected readonly sourcePath: string;
+    /**
+     * Creates the suggest and attaches it to the element.
+     *
+     * @param params - The parameters.
+     */
+    constructor(params: LinkAndTagInputSuggestConstructorParams);
+    /**
+     * Gets the value of the element.
+     *
+     * @returns The value.
+     */
+    getValue(): string;
+    /**
+     * Renders a suggestion.
+     *
+     * @param suggestion - The suggestion.
+     * @param el - The element to render into.
+     */
+    renderSuggestion(suggestion: LinkAndTagSuggestion, el: HTMLElement): void;
+    /**
+     * Inserts the suggestion in place of the trigger, moves the caret after it and dispatches an `input` event, so a
+     * component listening on the element sees the change.
+     *
+     * @param suggestion - The suggestion.
+     * @param $event - The event that selected it.
+     */
+    selectSuggestion(suggestion: LinkAndTagSuggestion, $event: KeyboardEvent | MouseEvent): void;
+    /**
+     * Sets the value of the element.
+     *
+     * @param value - The value.
+     */
+    setValue(value: string): void;
+    /**
+     * Gets the link suggestions for a query.
+     *
+     * @param query - The text typed after `[[`.
+     * @returns The suggestions, best match first.
+     */
+    protected getLinkSuggestions(query: string): LinkSuggestion[];
+    /**
+     * Gets the suggestions for the trigger before the caret. The query Obsidian passes is the whole value, so it is
+     * ignored.
+     *
+     * @returns The suggestions.
+     */
+    protected getSuggestions(): LinkAndTagSuggestion[];
+    /**
+     * Gets the tag suggestions for a query, from the tags of every note.
+     *
+     * @param query - The text typed after `#`.
+     * @returns The suggestions, best match first, then the most used.
+     */
+    protected getTagSuggestions(query: string): TagSuggestion[];
+    /**
+     * Gets the enabled trigger before the caret.
+     *
+     * @returns The trigger, or `null`.
+     */
+    protected getTrigger(): LinkAndTagCompletionTrigger | null;
+}
+/**
+ * Finds the `[[` link or `#` tag being typed before the caret.
+ *
+ * A link trigger is an unclosed `[[` on the caret's line with no `|` after it, so an alias being typed is left alone. A
+ * tag trigger is a `#` at the start of the text or after whitespace, followed only by tag characters.
+ *
+ * @param text - The text of the element.
+ * @param caret - The offset of the caret.
+ * @returns The trigger, or `null` when the caret is not in one.
+ */
+export declare function getLinkAndTagCompletionTrigger(text: string, caret: number): LinkAndTagCompletionTrigger | null;
+/**
+ * Gets the tags of every note matching a query, as {@link LinkAndTagInputSuggest} and {@link TagListComponent}
+ * suggest them.
+ *
+ * @param params - The parameters.
+ * @returns The suggestions, best match first, then the most used.
+ */
+export declare function getVaultTagSuggestions(params: GetVaultTagSuggestionsParams): TagSuggestion[];