@mnaoumov/obsidian-lib 0.0.0 → 1.0.1

package/dist/lib/esm/modals/suggest-modal-command-builder.mjs

@@ -0,0 +1,47 @@
+/*
+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 initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import { ModalCommandBuilder } from "./modal-command-builder.mjs";
+const SuggestModalCommandBuilder = ModalCommandBuilder;
+export {
+  SuggestModalCommandBuilder
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL21vZGFscy9zdWdnZXN0LW1vZGFsLWNvbW1hbmQtYnVpbGRlci50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRoZSBmb3JtZXIgaG9tZSBvZiB0aGUgYFN1Z2dlc3RNb2RhbGAgaW5zdHJ1Y3Rpb24tYmFyIGJ1aWxkZXIuXG4gKlxuICogVGhlIGJ1aWxkZXIgaXMgbm8gbG9uZ2VyIHRpZWQgdG8gYFN1Z2dlc3RNb2RhbGAgXHUyMDE0IGl0IHJlbmRlcnMgaW50byBhIHBsYWluIGBNb2RhbGAgYW5kIGludG8gYSBiYXJlXG4gKiBlbGVtZW50ICsgYFNjb3BlYCB0b28gXHUyMDE0IHNvIGl0IG1vdmVkIHRvIGBtb2RhbC1jb21tYW5kLWJ1aWxkZXIudHNgIHVuZGVyIHRoZSBob25lc3QgbmFtZVxuICoge0BsaW5rIE1vZGFsQ29tbWFuZEJ1aWxkZXJ9LiBUaGlzIG1vZHVsZSBzdGF5cyBhcyBhIGRlcHJlY2F0ZWQgYWxpYXMgc28gZXhpc3RpbmcgaW1wb3J0ZXJzIGtlZXAgd29ya2luZ1xuICogdW5jaGFuZ2VkOyBpdCByZS1leHBvcnRzIHRoZSB2ZXJ5IHNhbWUgY2xhc3MsIG5vdCBhIGNvcHkuXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBNb2RhbENvbW1hbmRCdWlsZGVyQnVpbGRPcHRpb25zIH0gZnJvbSAnLi9tb2RhbC1jb21tYW5kLWJ1aWxkZXIudHMnO1xuXG5pbXBvcnQgeyBNb2RhbENvbW1hbmRCdWlsZGVyIH0gZnJvbSAnLi9tb2RhbC1jb21tYW5kLWJ1aWxkZXIudHMnO1xuXG5leHBvcnQgdHlwZSB7XG4gIENoZWNrYm94Q29tbWFuZCxcbiAgRHJvcERvd25Db21tYW5kLFxuICBLZXlib2FyZENvbW1hbmRcbn0gZnJvbSAnLi9tb2RhbC1jb21tYW5kLWJ1aWxkZXIudHMnO1xuXG4vKipcbiAqIE9wdGlvbnMgZm9yIHtAbGluayBTdWdnZXN0TW9kYWxDb21tYW5kQnVpbGRlci5idWlsZH0uXG4gKlxuICogQGRlcHJlY2F0ZWQgVXNlIHtAbGluayBNb2RhbENvbW1hbmRCdWlsZGVyQnVpbGRPcHRpb25zfSBmcm9tXG4gKiBgb2JzaWRpYW4tZGV2LXV0aWxzL29ic2lkaWFuL21vZGFscy9tb2RhbC1jb21tYW5kLWJ1aWxkZXJgIGluc3RlYWQuXG4gKi9cbmV4cG9ydCB0eXBlIFN1Z2dlc3RNb2RhbENvbW1hbmRCdWlsZGVyQnVpbGRPcHRpb25zID0gTW9kYWxDb21tYW5kQnVpbGRlckJ1aWxkT3B0aW9ucztcblxuLyoqXG4gKiBCdWlsZHMgYSBgU3VnZ2VzdE1vZGFsYCdzIGluc3RydWN0aW9uIGJhci5cbiAqXG4gKiBAZGVwcmVjYXRlZCBVc2Uge0BsaW5rIE1vZGFsQ29tbWFuZEJ1aWxkZXJ9IGZyb21cbiAqIGBvYnNpZGlhbi1kZXYtdXRpbHMvb2JzaWRpYW4vbW9kYWxzL21vZGFsLWNvbW1hbmQtYnVpbGRlcmAgaW5zdGVhZC5cbiAqL1xuZXhwb3J0IGNvbnN0IFN1Z2dlc3RNb2RhbENvbW1hbmRCdWlsZGVyID0gTW9kYWxDb21tYW5kQnVpbGRlcjtcblxuLyoqXG4gKiBCdWlsZHMgYSBgU3VnZ2VzdE1vZGFsYCdzIGluc3RydWN0aW9uIGJhci5cbiAqXG4gKiBAZGVwcmVjYXRlZCBVc2Uge0BsaW5rIE1vZGFsQ29tbWFuZEJ1aWxkZXJ9IGZyb21cbiAqIGBvYnNpZGlhbi1kZXYtdXRpbHMvb2JzaWRpYW4vbW9kYWxzL21vZGFsLWNvbW1hbmQtYnVpbGRlcmAgaW5zdGVhZC5cbiAqL1xuZXhwb3J0IHR5cGUgU3VnZ2VzdE1vZGFsQ29tbWFuZEJ1aWxkZXIgPSBNb2RhbENvbW1hbmRCdWlsZGVyO1xuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFhQSxTQUFTLDJCQUEyQjtBQXNCN0IsTUFBTSw2QkFBNkI7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/note-priority.d.mts

@@ -0,0 +1,154 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * Decides which of several notes referencing the same attachment owns it.
+ *
+ * An attachment referenced from more than one note has no single correct home, so collecting it falls
+ * back to whatever `collectAttachmentUsedByMultipleNotesMode` says — skip, copy, cancel, or ask. A
+ * priority list lets the user answer the question once instead: put `.md` above `.excalidraw` and an
+ * image shared by both lands in the markdown note's folder.
+ *
+ * A tie is deliberately NOT resolved here. Two notes of equal priority is exactly the ambiguity the
+ * existing mode setting already exists to handle, and inventing a second, silent rule for it would
+ * move a file the user never named.
+ *
+ * The tie is also the whole of what gets REPORTED. A note the list ranked below the best rank cannot
+ * resolve the ambiguity, so listing it only adds noise — and worse in a picker, where offering it
+ * invites an answer the priority list itself would not have given. That is why
+ * {@link filterHighestPriorityNotePaths} exists alongside the two functions that decide.
+ */
+/**
+ * Why the priority list did not settle which note owns an attachment.
+ *
+ * The three values are exactly the three ways {@link pickHighestPriorityNotePath} (plus its empty-list
+ * guard) can fail to name a winner, so a caller can tell the user the real reason instead of only
+ * reporting that the attachment is referenced by several notes.
+ */
+export declare enum NoPriorityWinnerReason {
+    /**
+     * The priority list is empty — its default. Nothing was configured to decide between the notes.
+     */
+    EmptyList = "EmptyList",
+    /**
+     * The list has entries, but none of the referencing notes matches any of them.
+     */
+    NoMatch = "NoMatch",
+    /**
+     * Several referencing notes tie for the best rank, so the list names no single owner.
+     */
+    Tie = "Tie"
+}
+/**
+ * Parameters for {@link filterHighestPriorityNotePaths}.
+ *
+ * The same question as {@link pickHighestPriorityNotePath} asks, so deliberately the same parameters:
+ * the two must be answered from identical inputs or they could disagree.
+ */
+export type FilterHighestPriorityNotePathsParams = PickHighestPriorityNotePathParams;
+/**
+ * Parameters for {@link findNoPriorityWinnerReason}.
+ */
+export interface FindNoPriorityWinnerReasonParams extends PickHighestPriorityNotePathParams {
+    /**
+     * The priority list, highest priority first.
+     */
+    readonly entries: readonly string[];
+}
+/**
+ * Parameters for {@link findNotePriorityRank}.
+ */
+export interface FindNotePriorityRankParams {
+    /**
+     * The priority list, highest priority first.
+     */
+    readonly entries: readonly string[];
+    /**
+     * The note's frontmatter, or `null` when it has none.
+     */
+    readonly frontmatter: null | Readonly<Record<string, unknown>>;
+    /**
+     * The vault-relative path of the note.
+     */
+    readonly notePath: string;
+}
+/**
+ * Parameters for {@link pickHighestPriorityNotePath}.
+ */
+export interface PickHighestPriorityNotePathParams {
+    /**
+     * The vault-relative paths of the notes referencing the attachment.
+     */
+    readonly notePaths: readonly string[];
+    /**
+     * The priority rank of a note. Lower wins; {@link NO_PRIORITY_MATCH} means the note matched nothing.
+     *
+     * @param notePath - The vault-relative path of the note.
+     * @returns The rank.
+     */
+    readonly rank: (notePath: string) => number;
+}
+/**
+ * The rank of a note that matches no entry in the priority list. Higher than any real rank, so a note
+ * that matches nothing always loses to one that matches something.
+ */
+export declare const NO_PRIORITY_MATCH: number;
+/**
+ * Narrows the referencing notes to the ones sharing the best rank.
+ *
+ * Those notes are the whole of the ambiguity: one the list ranked below them cannot resolve anything,
+ * so reporting it only adds noise. This mirrors {@link pickHighestPriorityNotePath}'s conditions
+ * rather than re-deciding anything, so the two can only ever agree — whenever that names a winner,
+ * this returns exactly that one note.
+ *
+ * A list that decides nothing at all — empty, or matching no note — ranks every note
+ * {@link NO_PRIORITY_MATCH}, so they all tie and every one of them is kept. That is the same list the
+ * user saw before, which is correct: nothing has ruled any of them out.
+ *
+ * @param params - The referencing notes and how to rank one.
+ * @returns The notes holding the best rank, in the order they were given.
+ */
+export declare function filterHighestPriorityNotePaths(params: FilterHighestPriorityNotePathsParams): string[];
+/**
+ * Explains why the priority list named no owner for an attachment.
+ *
+ * Only meaningful once {@link pickHighestPriorityNotePath} has returned `null` (or the list was empty
+ * and was never consulted); it mirrors that function's own conditions rather than re-deciding
+ * anything, so the two can only ever agree.
+ *
+ * @param params - The priority list, the referencing notes, and how to rank one.
+ * @returns Which of the three ways the list failed to settle it.
+ */
+export declare function findNoPriorityWinnerReason(params: FindNoPriorityWinnerReasonParams): NoPriorityWinnerReason;
+/**
+ * Finds how highly a note ranks in the priority list.
+ *
+ * An entry matches in one of four ways, picked by its shape so that one list can express all of them:
+ *
+ * - `property:name` — the note's frontmatter has `name`; `property:name=value` also compares the value.
+ * - `/regular expression/` — tested against the note's path.
+ * - `.ext` — the note's path ends with it, case-insensitively. This is the form the request asked for.
+ * - anything else — a path from the vault root, matching the vocabulary of the include / exclude
+ *   path settings.
+ *
+ * When a note matches several entries the **longest** one decides its rank, so the most specific
+ * entry wins and the order of the list is left to express priority. Without this an Excalidraw note
+ * could never rank below a plain markdown one: `drawing.excalidraw.md` also ends with `.md`, so
+ * `.md` above `.excalidraw.md` — the very example the request is built on — would tie instead of
+ * resolving. Equal-length matches fall to the earlier entry.
+ *
+ * @param params - The parameters for finding the rank.
+ * @returns The index of the most specific matching entry, or {@link NO_PRIORITY_MATCH} when none match.
+ */
+export declare function findNotePriorityRank(params: FindNotePriorityRankParams): number;
+/**
+ * Picks the single highest-priority note among those referencing an attachment.
+ *
+ * Returns `null` when the best rank is shared by more than one note, or when no note matches
+ * anything. Both are ties, and a tie is the caller's problem: it is what the multiple-notes mode
+ * setting is for.
+ *
+ * @param params - The parameters for picking the note.
+ * @returns The winning note's path, or `null` when there is no single winner.
+ */
+export declare function pickHighestPriorityNotePath(params: PickHighestPriorityNotePathParams): null | string;

package/dist/lib/esm/note-priority.mjs

@@ -0,0 +1,135 @@
+/*
+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 initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import { isValidRegExp } from "@mnaoumov/typescript-lib/reg-exp";
+import {
+  checkPropertyEntryMatches,
+  isPropertyEntry
+} from "./property-entry.mjs";
+const REG_EXP_DELIMITER = "/";
+const EXTENSION_PREFIX = ".";
+var NoPriorityWinnerReason = /* @__PURE__ */ ((NoPriorityWinnerReason2) => {
+  NoPriorityWinnerReason2["EmptyList"] = "EmptyList";
+  NoPriorityWinnerReason2["NoMatch"] = "NoMatch";
+  NoPriorityWinnerReason2["Tie"] = "Tie";
+  return NoPriorityWinnerReason2;
+})(NoPriorityWinnerReason || {});
+const NO_PRIORITY_MATCH = Infinity;
+function filterHighestPriorityNotePaths(params) {
+  const rankedNotePaths = params.notePaths.map((notePath) => ({
+    notePath,
+    rank: params.rank(notePath)
+  }));
+  let bestRank = NO_PRIORITY_MATCH;
+  for (const ranked of rankedNotePaths) {
+    if (ranked.rank < bestRank) {
+      bestRank = ranked.rank;
+    }
+  }
+  return rankedNotePaths.filter((ranked) => ranked.rank === bestRank).map((ranked) => ranked.notePath);
+}
+function findNoPriorityWinnerReason(params) {
+  if (params.entries.length === 0) {
+    return "EmptyList" /* EmptyList */;
+  }
+  let bestRank = NO_PRIORITY_MATCH;
+  for (const notePath of params.notePaths) {
+    const currentRank = params.rank(notePath);
+    if (currentRank < bestRank) {
+      bestRank = currentRank;
+    }
+  }
+  return bestRank === NO_PRIORITY_MATCH ? "NoMatch" /* NoMatch */ : "Tie" /* Tie */;
+}
+function findNotePriorityRank(params) {
+  let bestRank = NO_PRIORITY_MATCH;
+  let bestLength = -1;
+  for (const [index, entry] of params.entries.entries()) {
+    if (entry.length <= bestLength || !checkEntryMatches(entry, params)) {
+      continue;
+    }
+    bestRank = index;
+    bestLength = entry.length;
+  }
+  return bestRank;
+}
+function pickHighestPriorityNotePath(params) {
+  let bestRank = NO_PRIORITY_MATCH;
+  let bestNotePath = null;
+  let bestCount = 0;
+  for (const notePath of params.notePaths) {
+    const currentRank = params.rank(notePath);
+    if (currentRank < bestRank) {
+      bestRank = currentRank;
+      bestNotePath = notePath;
+      bestCount = 1;
+    } else if (currentRank === bestRank) {
+      bestCount++;
+    }
+  }
+  return bestCount !== 1 || bestRank === NO_PRIORITY_MATCH ? null : bestNotePath;
+}
+function checkEntryMatches(entry, params) {
+  if (!entry) {
+    return false;
+  }
+  if (isPropertyEntry(entry)) {
+    return checkPropertyEntryMatches({ entry, frontmatter: params.frontmatter });
+  }
+  if (entry.length > 1 && entry.startsWith(REG_EXP_DELIMITER) && entry.endsWith(REG_EXP_DELIMITER)) {
+    const source = entry.slice(1, -1);
+    return isValidRegExp(source) && new RegExp(source).test(params.notePath);
+  }
+  if (entry.startsWith(EXTENSION_PREFIX)) {
+    return params.notePath.toLowerCase().endsWith(entry.toLowerCase());
+  }
+  const prefix = entry.endsWith("/") ? entry : `${entry}/`;
+  return params.notePath === entry || params.notePath.startsWith(prefix);
+}
+export {
+  NO_PRIORITY_MATCH,
+  NoPriorityWinnerReason,
+  filterHighestPriorityNotePaths,
+  findNoPriorityWinnerReason,
+  findNotePriorityRank,
+  pickHighestPriorityNotePath
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL25vdGUtcHJpb3JpdHkudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBEZWNpZGVzIHdoaWNoIG9mIHNldmVyYWwgbm90ZXMgcmVmZXJlbmNpbmcgdGhlIHNhbWUgYXR0YWNobWVudCBvd25zIGl0LlxuICpcbiAqIEFuIGF0dGFjaG1lbnQgcmVmZXJlbmNlZCBmcm9tIG1vcmUgdGhhbiBvbmUgbm90ZSBoYXMgbm8gc2luZ2xlIGNvcnJlY3QgaG9tZSwgc28gY29sbGVjdGluZyBpdCBmYWxsc1xuICogYmFjayB0byB3aGF0ZXZlciBgY29sbGVjdEF0dGFjaG1lbnRVc2VkQnlNdWx0aXBsZU5vdGVzTW9kZWAgc2F5cyBcdTIwMTQgc2tpcCwgY29weSwgY2FuY2VsLCBvciBhc2suIEFcbiAqIHByaW9yaXR5IGxpc3QgbGV0cyB0aGUgdXNlciBhbnN3ZXIgdGhlIHF1ZXN0aW9uIG9uY2UgaW5zdGVhZDogcHV0IGAubWRgIGFib3ZlIGAuZXhjYWxpZHJhd2AgYW5kIGFuXG4gKiBpbWFnZSBzaGFyZWQgYnkgYm90aCBsYW5kcyBpbiB0aGUgbWFya2Rvd24gbm90ZSdzIGZvbGRlci5cbiAqXG4gKiBBIHRpZSBpcyBkZWxpYmVyYXRlbHkgTk9UIHJlc29sdmVkIGhlcmUuIFR3byBub3RlcyBvZiBlcXVhbCBwcmlvcml0eSBpcyBleGFjdGx5IHRoZSBhbWJpZ3VpdHkgdGhlXG4gKiBleGlzdGluZyBtb2RlIHNldHRpbmcgYWxyZWFkeSBleGlzdHMgdG8gaGFuZGxlLCBhbmQgaW52ZW50aW5nIGEgc2Vjb25kLCBzaWxlbnQgcnVsZSBmb3IgaXQgd291bGRcbiAqIG1vdmUgYSBmaWxlIHRoZSB1c2VyIG5ldmVyIG5hbWVkLlxuICpcbiAqIFRoZSB0aWUgaXMgYWxzbyB0aGUgd2hvbGUgb2Ygd2hhdCBnZXRzIFJFUE9SVEVELiBBIG5vdGUgdGhlIGxpc3QgcmFua2VkIGJlbG93IHRoZSBiZXN0IHJhbmsgY2Fubm90XG4gKiByZXNvbHZlIHRoZSBhbWJpZ3VpdHksIHNvIGxpc3RpbmcgaXQgb25seSBhZGRzIG5vaXNlIFx1MjAxNCBhbmQgd29yc2UgaW4gYSBwaWNrZXIsIHdoZXJlIG9mZmVyaW5nIGl0XG4gKiBpbnZpdGVzIGFuIGFuc3dlciB0aGUgcHJpb3JpdHkgbGlzdCBpdHNlbGYgd291bGQgbm90IGhhdmUgZ2l2ZW4uIFRoYXQgaXMgd2h5XG4gKiB7QGxpbmsgZmlsdGVySGlnaGVzdFByaW9yaXR5Tm90ZVBhdGhzfSBleGlzdHMgYWxvbmdzaWRlIHRoZSB0d28gZnVuY3Rpb25zIHRoYXQgZGVjaWRlLlxuICovXG5cbmltcG9ydCB7IGlzVmFsaWRSZWdFeHAgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvcmVnLWV4cCc7XG5cbmltcG9ydCB7XG4gIGNoZWNrUHJvcGVydHlFbnRyeU1hdGNoZXMsXG4gIGlzUHJvcGVydHlFbnRyeVxufSBmcm9tICcuL3Byb3BlcnR5LWVudHJ5LnRzJztcblxuY29uc3QgUkVHX0VYUF9ERUxJTUlURVIgPSAnLyc7XG5jb25zdCBFWFRFTlNJT05fUFJFRklYID0gJy4nO1xuXG4vKipcbiAqIFdoeSB0aGUgcHJpb3JpdHkgbGlzdCBkaWQgbm90IHNldHRsZSB3aGljaCBub3RlIG93bnMgYW4gYXR0YWNobWVudC5cbiAqXG4gKiBUaGUgdGhyZWUgdmFsdWVzIGFyZSBleGFjdGx5IHRoZSB0aHJlZSB3YXlzIHtAbGluayBwaWNrSGlnaGVzdFByaW9yaXR5Tm90ZVBhdGh9IChwbHVzIGl0cyBlbXB0eS1saXN0XG4gKiBndWFyZCkgY2FuIGZhaWwgdG8gbmFtZSBhIHdpbm5lciwgc28gYSBjYWxsZXIgY2FuIHRlbGwgdGhlIHVzZXIgdGhlIHJlYWwgcmVhc29uIGluc3RlYWQgb2Ygb25seVxuICogcmVwb3J0aW5nIHRoYXQgdGhlIGF0dGFjaG1lbnQgaXMgcmVmZXJlbmNlZCBieSBzZXZlcmFsIG5vdGVzLlxuICovXG5leHBvcnQgZW51bSBOb1ByaW9yaXR5V2lubmVyUmVhc29uIHtcbiAgLyoqXG4gICAqIFRoZSBwcmlvcml0eSBsaXN0IGlzIGVtcHR5IFx1MjAxNCBpdHMgZGVmYXVsdC4gTm90aGluZyB3YXMgY29uZmlndXJlZCB0byBkZWNpZGUgYmV0d2VlbiB0aGUgbm90ZXMuXG4gICAqL1xuICBFbXB0eUxpc3QgPSAnRW1wdHlMaXN0JyxcblxuICAvKipcbiAgICogVGhlIGxpc3QgaGFzIGVudHJpZXMsIGJ1dCBub25lIG9mIHRoZSByZWZlcmVuY2luZyBub3RlcyBtYXRjaGVzIGFueSBvZiB0aGVtLlxuICAgKi9cbiAgTm9NYXRjaCA9ICdOb01hdGNoJyxcblxuICAvKipcbiAgICogU2V2ZXJhbCByZWZlcmVuY2luZyBub3RlcyB0aWUgZm9yIHRoZSBiZXN0IHJhbmssIHNvIHRoZSBsaXN0IG5hbWVzIG5vIHNpbmdsZSBvd25lci5cbiAgICovXG4gIFRpZSA9ICdUaWUnXG59XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIGZpbHRlckhpZ2hlc3RQcmlvcml0eU5vdGVQYXRoc30uXG4gKlxuICogVGhlIHNhbWUgcXVlc3Rpb24gYXMge0BsaW5rIHBpY2tIaWdoZXN0UHJpb3JpdHlOb3RlUGF0aH0gYXNrcywgc28gZGVsaWJlcmF0ZWx5IHRoZSBzYW1lIHBhcmFtZXRlcnM6XG4gKiB0aGUgdHdvIG11c3QgYmUgYW5zd2VyZWQgZnJvbSBpZGVudGljYWwgaW5wdXRzIG9yIHRoZXkgY291bGQgZGlzYWdyZWUuXG4gKi9cbmV4cG9ydCB0eXBlIEZpbHRlckhpZ2hlc3RQcmlvcml0eU5vdGVQYXRoc1BhcmFtcyA9IFBpY2tIaWdoZXN0UHJpb3JpdHlOb3RlUGF0aFBhcmFtcztcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgZmluZE5vUHJpb3JpdHlXaW5uZXJSZWFzb259LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEZpbmROb1ByaW9yaXR5V2lubmVyUmVhc29uUGFyYW1zIGV4dGVuZHMgUGlja0hpZ2hlc3RQcmlvcml0eU5vdGVQYXRoUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBwcmlvcml0eSBsaXN0LCBoaWdoZXN0IHByaW9yaXR5IGZpcnN0LlxuICAgKi9cbiAgcmVhZG9ubHkgZW50cmllczogcmVhZG9ubHkgc3RyaW5nW107XG59XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIGZpbmROb3RlUHJpb3JpdHlSYW5rfS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBGaW5kTm90ZVByaW9yaXR5UmFua1BhcmFtcyB7XG4gIC8qKlxuICAgKiBUaGUgcHJpb3JpdHkgbGlzdCwgaGlnaGVzdCBwcmlvcml0eSBmaXJzdC5cbiAgICovXG4gIHJlYWRvbmx5IGVudHJpZXM6IHJlYWRvbmx5IHN0cmluZ1tdO1xuXG4gIC8qKlxuICAgKiBUaGUgbm90ZSdzIGZyb250bWF0dGVyLCBvciBgbnVsbGAgd2hlbiBpdCBoYXMgbm9uZS5cbiAgICovXG4gIHJlYWRvbmx5IGZyb250bWF0dGVyOiBudWxsIHwgUmVhZG9ubHk8UmVjb3JkPHN0cmluZywgdW5rbm93bj4+O1xuXG4gIC8qKlxuICAgKiBUaGUgdmF1bHQtcmVsYXRpdmUgcGF0aCBvZiB0aGUgbm90ZS5cbiAgICovXG4gIHJlYWRvbmx5IG5vdGVQYXRoOiBzdHJpbmc7XG59XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIHBpY2tIaWdoZXN0UHJpb3JpdHlOb3RlUGF0aH0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUGlja0hpZ2hlc3RQcmlvcml0eU5vdGVQYXRoUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSB2YXVsdC1yZWxhdGl2ZSBwYXRocyBvZiB0aGUgbm90ZXMgcmVmZXJlbmNpbmcgdGhlIGF0dGFjaG1lbnQuXG4gICAqL1xuICByZWFkb25seSBub3RlUGF0aHM6IHJlYWRvbmx5IHN0cmluZ1tdO1xuXG4gIC8qKlxuICAgKiBUaGUgcHJpb3JpdHkgcmFuayBvZiBhIG5vdGUuIExvd2VyIHdpbnM7IHtAbGluayBOT19QUklPUklUWV9NQVRDSH0gbWVhbnMgdGhlIG5vdGUgbWF0Y2hlZCBub3RoaW5nLlxuICAgKlxuICAgKiBAcGFyYW0gbm90ZVBhdGggLSBUaGUgdmF1bHQtcmVsYXRpdmUgcGF0aCBvZiB0aGUgbm90ZS5cbiAgICogQHJldHVybnMgVGhlIHJhbmsuXG4gICAqL1xuICByZWFkb25seSByYW5rOiAobm90ZVBhdGg6IHN0cmluZykgPT4gbnVtYmVyO1xufVxuXG4vKipcbiAqIFRoZSByYW5rIG9mIGEgbm90ZSB0aGF0IG1hdGNoZXMgbm8gZW50cnkgaW4gdGhlIHByaW9yaXR5IGxpc3QuIEhpZ2hlciB0aGFuIGFueSByZWFsIHJhbmssIHNvIGEgbm90ZVxuICogdGhhdCBtYXRjaGVzIG5vdGhpbmcgYWx3YXlzIGxvc2VzIHRvIG9uZSB0aGF0IG1hdGNoZXMgc29tZXRoaW5nLlxuICovXG5leHBvcnQgY29uc3QgTk9fUFJJT1JJVFlfTUFUQ0ggPSBJbmZpbml0eTtcblxuLyoqXG4gKiBOYXJyb3dzIHRoZSByZWZlcmVuY2luZyBub3RlcyB0byB0aGUgb25lcyBzaGFyaW5nIHRoZSBiZXN0IHJhbmsuXG4gKlxuICogVGhvc2Ugbm90ZXMgYXJlIHRoZSB3aG9sZSBvZiB0aGUgYW1iaWd1aXR5OiBvbmUgdGhlIGxpc3QgcmFua2VkIGJlbG93IHRoZW0gY2Fubm90IHJlc29sdmUgYW55dGhpbmcsXG4gKiBzbyByZXBvcnRpbmcgaXQgb25seSBhZGRzIG5vaXNlLiBUaGlzIG1pcnJvcnMge0BsaW5rIHBpY2tIaWdoZXN0UHJpb3JpdHlOb3RlUGF0aH0ncyBjb25kaXRpb25zXG4gKiByYXRoZXIgdGhhbiByZS1kZWNpZGluZyBhbnl0aGluZywgc28gdGhlIHR3byBjYW4gb25seSBldmVyIGFncmVlIFx1MjAxNCB3aGVuZXZlciB0aGF0IG5hbWVzIGEgd2lubmVyLFxuICogdGhpcyByZXR1cm5zIGV4YWN0bHkgdGhhdCBvbmUgbm90ZS5cbiAqXG4gKiBBIGxpc3QgdGhhdCBkZWNpZGVzIG5vdGhpbmcgYXQgYWxsIFx1MjAxNCBlbXB0eSwgb3IgbWF0Y2hpbmcgbm8gbm90ZSBcdTIwMTQgcmFua3MgZXZlcnkgbm90ZVxuICoge0BsaW5rIE5PX1BSSU9SSVRZX01BVENIfSwgc28gdGhleSBhbGwgdGllIGFuZCBldmVyeSBvbmUgb2YgdGhlbSBpcyBrZXB0LiBUaGF0IGlzIHRoZSBzYW1lIGxpc3QgdGhlXG4gKiB1c2VyIHNhdyBiZWZvcmUsIHdoaWNoIGlzIGNvcnJlY3Q6IG5vdGhpbmcgaGFzIHJ1bGVkIGFueSBvZiB0aGVtIG91dC5cbiAqXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHJlZmVyZW5jaW5nIG5vdGVzIGFuZCBob3cgdG8gcmFuayBvbmUuXG4gKiBAcmV0dXJucyBUaGUgbm90ZXMgaG9sZGluZyB0aGUgYmVzdCByYW5rLCBpbiB0aGUgb3JkZXIgdGhleSB3ZXJlIGdpdmVuLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZmlsdGVySGlnaGVzdFByaW9yaXR5Tm90ZVBhdGhzKHBhcmFtczogRmlsdGVySGlnaGVzdFByaW9yaXR5Tm90ZVBhdGhzUGFyYW1zKTogc3RyaW5nW10ge1xuICAvLyBSYW5raW5nIGNhbiBoaXQgdGhlIHZhdWx0IGFuZCB0aGUgbWV0YWRhdGEgY2FjaGUsIHNvIGVhY2ggbm90ZSBpcyByYW5rZWQgb25jZSBhbmQgY2FycmllZC5cbiAgY29uc3QgcmFua2VkTm90ZVBhdGhzID0gcGFyYW1zLm5vdGVQYXRocy5tYXAoKG5vdGVQYXRoKSA9PiAoe1xuICAgIG5vdGVQYXRoLFxuICAgIHJhbms6IHBhcmFtcy5yYW5rKG5vdGVQYXRoKVxuICB9KSk7XG5cbiAgbGV0IGJlc3RSYW5rID0gTk9fUFJJT1JJVFlfTUFUQ0g7XG4gIGZvciAoY29uc3QgcmFua2VkIG9mIHJhbmtlZE5vdGVQYXRocykge1xuICAgIGlmIChyYW5rZWQucmFuayA8IGJlc3RSYW5rKSB7XG4gICAgICBiZXN0UmFuayA9IHJhbmtlZC5yYW5rO1xuICAgIH1cbiAgfVxuXG4gIHJldHVybiByYW5rZWROb3RlUGF0aHNcbiAgICAuZmlsdGVyKChyYW5rZWQpID0+IHJhbmtlZC5yYW5rID09PSBiZXN0UmFuaylcbiAgICAubWFwKChyYW5rZWQpID0+IHJhbmtlZC5ub3RlUGF0aCk7XG59XG5cbi8qKlxuICogRXhwbGFpbnMgd2h5IHRoZSBwcmlvcml0eSBsaXN0IG5hbWVkIG5vIG93bmVyIGZvciBhbiBhdHRhY2htZW50LlxuICpcbiAqIE9ubHkgbWVhbmluZ2Z1bCBvbmNlIHtAbGluayBwaWNrSGlnaGVzdFByaW9yaXR5Tm90ZVBhdGh9IGhhcyByZXR1cm5lZCBgbnVsbGAgKG9yIHRoZSBsaXN0IHdhcyBlbXB0eVxuICogYW5kIHdhcyBuZXZlciBjb25zdWx0ZWQpOyBpdCBtaXJyb3JzIHRoYXQgZnVuY3Rpb24ncyBvd24gY29uZGl0aW9ucyByYXRoZXIgdGhhbiByZS1kZWNpZGluZ1xuICogYW55dGhpbmcsIHNvIHRoZSB0d28gY2FuIG9ubHkgZXZlciBhZ3JlZS5cbiAqXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHByaW9yaXR5IGxpc3QsIHRoZSByZWZlcmVuY2luZyBub3RlcywgYW5kIGhvdyB0byByYW5rIG9uZS5cbiAqIEByZXR1cm5zIFdoaWNoIG9mIHRoZSB0aHJlZSB3YXlzIHRoZSBsaXN0IGZhaWxlZCB0byBzZXR0bGUgaXQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBmaW5kTm9Qcmlvcml0eVdpbm5lclJlYXNvbihwYXJhbXM6IEZpbmROb1ByaW9yaXR5V2lubmVyUmVhc29uUGFyYW1zKTogTm9Qcmlvcml0eVdpbm5lclJlYXNvbiB7XG4gIGlmIChwYXJhbXMuZW50cmllcy5sZW5ndGggPT09IDApIHtcbiAgICByZXR1cm4gTm9Qcmlvcml0eVdpbm5lclJlYXNvbi5FbXB0eUxpc3Q7XG4gIH1cblxuICBsZXQgYmVzdFJhbmsgPSBOT19QUklPUklUWV9NQVRDSDtcbiAgZm9yIChjb25zdCBub3RlUGF0aCBvZiBwYXJhbXMubm90ZVBhdGhzKSB7XG4gICAgY29uc3QgY3VycmVudFJhbmsgPSBwYXJhbXMucmFuayhub3RlUGF0aCk7XG4gICAgaWYgKGN1cnJlbnRSYW5rIDwgYmVzdFJhbmspIHtcbiAgICAgIGJlc3RSYW5rID0gY3VycmVudFJhbms7XG4gICAgfVxuICB9XG5cbiAgcmV0dXJuIGJlc3RSYW5rID09PSBOT19QUklPUklUWV9NQVRDSCA/IE5vUHJpb3JpdHlXaW5uZXJSZWFzb24uTm9NYXRjaCA6IE5vUHJpb3JpdHlXaW5uZXJSZWFzb24uVGllO1xufVxuXG4vKipcbiAqIEZpbmRzIGhvdyBoaWdobHkgYSBub3RlIHJhbmtzIGluIHRoZSBwcmlvcml0eSBsaXN0LlxuICpcbiAqIEFuIGVudHJ5IG1hdGNoZXMgaW4gb25lIG9mIGZvdXIgd2F5cywgcGlja2VkIGJ5IGl0cyBzaGFwZSBzbyB0aGF0IG9uZSBsaXN0IGNhbiBleHByZXNzIGFsbCBvZiB0aGVtOlxuICpcbiAqIC0gYHByb3BlcnR5Om5hbWVgIFx1MjAxNCB0aGUgbm90ZSdzIGZyb250bWF0dGVyIGhhcyBgbmFtZWA7IGBwcm9wZXJ0eTpuYW1lPXZhbHVlYCBhbHNvIGNvbXBhcmVzIHRoZSB2YWx1ZS5cbiAqIC0gYC9yZWd1bGFyIGV4cHJlc3Npb24vYCBcdTIwMTQgdGVzdGVkIGFnYWluc3QgdGhlIG5vdGUncyBwYXRoLlxuICogLSBgLmV4dGAgXHUyMDE0IHRoZSBub3RlJ3MgcGF0aCBlbmRzIHdpdGggaXQsIGNhc2UtaW5zZW5zaXRpdmVseS4gVGhpcyBpcyB0aGUgZm9ybSB0aGUgcmVxdWVzdCBhc2tlZCBmb3IuXG4gKiAtIGFueXRoaW5nIGVsc2UgXHUyMDE0IGEgcGF0aCBmcm9tIHRoZSB2YXVsdCByb290LCBtYXRjaGluZyB0aGUgdm9jYWJ1bGFyeSBvZiB0aGUgaW5jbHVkZSAvIGV4Y2x1ZGVcbiAqICAgcGF0aCBzZXR0aW5ncy5cbiAqXG4gKiBXaGVuIGEgbm90ZSBtYXRjaGVzIHNldmVyYWwgZW50cmllcyB0aGUgKipsb25nZXN0Kiogb25lIGRlY2lkZXMgaXRzIHJhbmssIHNvIHRoZSBtb3N0IHNwZWNpZmljXG4gKiBlbnRyeSB3aW5zIGFuZCB0aGUgb3JkZXIgb2YgdGhlIGxpc3QgaXMgbGVmdCB0byBleHByZXNzIHByaW9yaXR5LiBXaXRob3V0IHRoaXMgYW4gRXhjYWxpZHJhdyBub3RlXG4gKiBjb3VsZCBuZXZlciByYW5rIGJlbG93IGEgcGxhaW4gbWFya2Rvd24gb25lOiBgZHJhd2luZy5leGNhbGlkcmF3Lm1kYCBhbHNvIGVuZHMgd2l0aCBgLm1kYCwgc29cbiAqIGAubWRgIGFib3ZlIGAuZXhjYWxpZHJhdy5tZGAgXHUyMDE0IHRoZSB2ZXJ5IGV4YW1wbGUgdGhlIHJlcXVlc3QgaXMgYnVpbHQgb24gXHUyMDE0IHdvdWxkIHRpZSBpbnN0ZWFkIG9mXG4gKiByZXNvbHZpbmcuIEVxdWFsLWxlbmd0aCBtYXRjaGVzIGZhbGwgdG8gdGhlIGVhcmxpZXIgZW50cnkuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIGZvciBmaW5kaW5nIHRoZSByYW5rLlxuICogQHJldHVybnMgVGhlIGluZGV4IG9mIHRoZSBtb3N0IHNwZWNpZmljIG1hdGNoaW5nIGVudHJ5LCBvciB7QGxpbmsgTk9fUFJJT1JJVFlfTUFUQ0h9IHdoZW4gbm9uZSBtYXRjaC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGZpbmROb3RlUHJpb3JpdHlSYW5rKHBhcmFtczogRmluZE5vdGVQcmlvcml0eVJhbmtQYXJhbXMpOiBudW1iZXIge1xuICBsZXQgYmVzdFJhbmsgPSBOT19QUklPUklUWV9NQVRDSDtcbiAgbGV0IGJlc3RMZW5ndGggPSAtMTtcblxuICBmb3IgKGNvbnN0IFtpbmRleCwgZW50cnldIG9mIHBhcmFtcy5lbnRyaWVzLmVudHJpZXMoKSkge1xuICAgIC8vIEEgc2hvcnRlciBlbnRyeSBjYW4gbmV2ZXIgYmVhdCBvbmUgdGhhdCBhbHJlYWR5IG1hdGNoZWQsIHNvIGl0IGlzIG5vdCB3b3J0aCB0ZXN0aW5nLlxuICAgIGlmICgoZW50cnkubGVuZ3RoIDw9IGJlc3RMZW5ndGgpIHx8ICFjaGVja0VudHJ5TWF0Y2hlcyhlbnRyeSwgcGFyYW1zKSkge1xuICAgICAgY29udGludWU7XG4gICAgfVxuXG4gICAgYmVzdFJhbmsgPSBpbmRleDtcbiAgICBiZXN0TGVuZ3RoID0gZW50cnkubGVuZ3RoO1xuICB9XG5cbiAgcmV0dXJuIGJlc3RSYW5rO1xufVxuXG4vKipcbiAqIFBpY2tzIHRoZSBzaW5nbGUgaGlnaGVzdC1wcmlvcml0eSBub3RlIGFtb25nIHRob3NlIHJlZmVyZW5jaW5nIGFuIGF0dGFjaG1lbnQuXG4gKlxuICogUmV0dXJucyBgbnVsbGAgd2hlbiB0aGUgYmVzdCByYW5rIGlzIHNoYXJlZCBieSBtb3JlIHRoYW4gb25lIG5vdGUsIG9yIHdoZW4gbm8gbm90ZSBtYXRjaGVzXG4gKiBhbnl0aGluZy4gQm90aCBhcmUgdGllcywgYW5kIGEgdGllIGlzIHRoZSBjYWxsZXIncyBwcm9ibGVtOiBpdCBpcyB3aGF0IHRoZSBtdWx0aXBsZS1ub3RlcyBtb2RlXG4gKiBzZXR0aW5nIGlzIGZvci5cbiAqXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBhcmFtZXRlcnMgZm9yIHBpY2tpbmcgdGhlIG5vdGUuXG4gKiBAcmV0dXJucyBUaGUgd2lubmluZyBub3RlJ3MgcGF0aCwgb3IgYG51bGxgIHdoZW4gdGhlcmUgaXMgbm8gc2luZ2xlIHdpbm5lci5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHBpY2tIaWdoZXN0UHJpb3JpdHlOb3RlUGF0aChwYXJhbXM6IFBpY2tIaWdoZXN0UHJpb3JpdHlOb3RlUGF0aFBhcmFtcyk6IG51bGwgfCBzdHJpbmcge1xuICBsZXQgYmVzdFJhbmsgPSBOT19QUklPUklUWV9NQVRDSDtcbiAgbGV0IGJlc3ROb3RlUGF0aDogbnVsbCB8IHN0cmluZyA9IG51bGw7XG4gIGxldCBiZXN0Q291bnQgPSAwO1xuXG4gIGZvciAoY29uc3Qgbm90ZVBhdGggb2YgcGFyYW1zLm5vdGVQYXRocykge1xuICAgIGNvbnN0IGN1cnJlbnRSYW5rID0gcGFyYW1zLnJhbmsobm90ZVBhdGgpO1xuICAgIGlmIChjdXJyZW50UmFuayA8IGJlc3RSYW5rKSB7XG4gICAgICBiZXN0UmFuayA9IGN1cnJlbnRSYW5rO1xuICAgICAgYmVzdE5vdGVQYXRoID0gbm90ZVBhdGg7XG4gICAgICBiZXN0Q291bnQgPSAxO1xuICAgIH0gZWxzZSBpZiAoY3VycmVudFJhbmsgPT09IGJlc3RSYW5rKSB7XG4gICAgICBiZXN0Q291bnQrKztcbiAgICB9XG4gIH1cblxuICByZXR1cm4gYmVzdENvdW50ICE9PSAxIHx8IGJlc3RSYW5rID09PSBOT19QUklPUklUWV9NQVRDSCA/IG51bGwgOiBiZXN0Tm90ZVBhdGg7XG59XG5cbmZ1bmN0aW9uIGNoZWNrRW50cnlNYXRjaGVzKGVudHJ5OiBzdHJpbmcsIHBhcmFtczogRmluZE5vdGVQcmlvcml0eVJhbmtQYXJhbXMpOiBib29sZWFuIHtcbiAgaWYgKCFlbnRyeSkge1xuICAgIHJldHVybiBmYWxzZTtcbiAgfVxuXG4gIGlmIChpc1Byb3BlcnR5RW50cnkoZW50cnkpKSB7XG4gICAgcmV0dXJuIGNoZWNrUHJvcGVydHlFbnRyeU1hdGNoZXMoeyBlbnRyeSwgZnJvbnRtYXR0ZXI6IHBhcmFtcy5mcm9udG1hdHRlciB9KTtcbiAgfVxuXG4gIGlmIChlbnRyeS5sZW5ndGggPiAxICYmIGVudHJ5LnN0YXJ0c1dpdGgoUkVHX0VYUF9ERUxJTUlURVIpICYmIGVudHJ5LmVuZHNXaXRoKFJFR19FWFBfREVMSU1JVEVSKSkge1xuICAgIGNvbnN0IHNvdXJjZSA9IGVudHJ5LnNsaWNlKDEsIC0xKTtcbiAgICAvLyBBbiB1bnBhcnNlYWJsZSBleHByZXNzaW9uIG11c3Qgbm90IHRocm93IG1pZC1jb2xsZWN0aW9uOyBpdCBzaW1wbHkgbWF0Y2hlcyBub3RoaW5nLlxuICAgIHJldHVybiBpc1ZhbGlkUmVnRXhwKHNvdXJjZSkgJiYgbmV3IFJlZ0V4cChzb3VyY2UpLnRlc3QocGFyYW1zLm5vdGVQYXRoKTtcbiAgfVxuXG4gIGlmIChlbnRyeS5zdGFydHNXaXRoKEVYVEVOU0lPTl9QUkVGSVgpKSB7XG4gICAgcmV0dXJuIHBhcmFtcy5ub3RlUGF0aC50b0xvd2VyQ2FzZSgpLmVuZHNXaXRoKGVudHJ5LnRvTG93ZXJDYXNlKCkpO1xuICB9XG5cbiAgY29uc3QgcHJlZml4ID0gZW50cnkuZW5kc1dpdGgoJy8nKSA/IGVudHJ5IDogYCR7ZW50cnl9L2A7XG4gIHJldHVybiBwYXJhbXMubm90ZVBhdGggPT09IGVudHJ5IHx8IHBhcmFtcy5ub3RlUGF0aC5zdGFydHNXaXRoKHByZWZpeCk7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQW9CQSxTQUFTLHFCQUFxQjtBQUU5QjtBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsT0FDSztBQUVQLE1BQU0sb0JBQW9CO0FBQzFCLE1BQU0sbUJBQW1CO0FBU2xCLElBQUsseUJBQUwsa0JBQUtBLDRCQUFMO0FBSUwsRUFBQUEsd0JBQUEsZUFBWTtBQUtaLEVBQUFBLHdCQUFBLGFBQVU7QUFLVixFQUFBQSx3QkFBQSxTQUFNO0FBZEksU0FBQUE7QUFBQSxHQUFBO0FBNkVMLE1BQU0sb0JBQW9CO0FBaUIxQixTQUFTLCtCQUErQixRQUF3RDtBQUVyRyxRQUFNLGtCQUFrQixPQUFPLFVBQVUsSUFBSSxDQUFDLGNBQWM7QUFBQSxJQUMxRDtBQUFBLElBQ0EsTUFBTSxPQUFPLEtBQUssUUFBUTtBQUFBLEVBQzVCLEVBQUU7QUFFRixNQUFJLFdBQVc7QUFDZixhQUFXLFVBQVUsaUJBQWlCO0FBQ3BDLFFBQUksT0FBTyxPQUFPLFVBQVU7QUFDMUIsaUJBQVcsT0FBTztBQUFBLElBQ3BCO0FBQUEsRUFDRjtBQUVBLFNBQU8sZ0JBQ0osT0FBTyxDQUFDLFdBQVcsT0FBTyxTQUFTLFFBQVEsRUFDM0MsSUFBSSxDQUFDLFdBQVcsT0FBTyxRQUFRO0FBQ3BDO0FBWU8sU0FBUywyQkFBMkIsUUFBa0U7QUFDM0csTUFBSSxPQUFPLFFBQVEsV0FBVyxHQUFHO0FBQy9CLFdBQU87QUFBQSxFQUNUO0FBRUEsTUFBSSxXQUFXO0FBQ2YsYUFBVyxZQUFZLE9BQU8sV0FBVztBQUN2QyxVQUFNLGNBQWMsT0FBTyxLQUFLLFFBQVE7QUFDeEMsUUFBSSxjQUFjLFVBQVU7QUFDMUIsaUJBQVc7QUFBQSxJQUNiO0FBQUEsRUFDRjtBQUVBLFNBQU8sYUFBYSxvQkFBb0IsMEJBQWlDO0FBQzNFO0FBc0JPLFNBQVMscUJBQXFCLFFBQTRDO0FBQy9FLE1BQUksV0FBVztBQUNmLE1BQUksYUFBYTtBQUVqQixhQUFXLENBQUMsT0FBTyxLQUFLLEtBQUssT0FBTyxRQUFRLFFBQVEsR0FBRztBQUVyRCxRQUFLLE1BQU0sVUFBVSxjQUFlLENBQUMsa0JBQWtCLE9BQU8sTUFBTSxHQUFHO0FBQ3JFO0FBQUEsSUFDRjtBQUVBLGVBQVc7QUFDWCxpQkFBYSxNQUFNO0FBQUEsRUFDckI7QUFFQSxTQUFPO0FBQ1Q7QUFZTyxTQUFTLDRCQUE0QixRQUEwRDtBQUNwRyxNQUFJLFdBQVc7QUFDZixNQUFJLGVBQThCO0FBQ2xDLE1BQUksWUFBWTtBQUVoQixhQUFXLFlBQVksT0FBTyxXQUFXO0FBQ3ZDLFVBQU0sY0FBYyxPQUFPLEtBQUssUUFBUTtBQUN4QyxRQUFJLGNBQWMsVUFBVTtBQUMxQixpQkFBVztBQUNYLHFCQUFlO0FBQ2Ysa0JBQVk7QUFBQSxJQUNkLFdBQVcsZ0JBQWdCLFVBQVU7QUFDbkM7QUFBQSxJQUNGO0FBQUEsRUFDRjtBQUVBLFNBQU8sY0FBYyxLQUFLLGFBQWEsb0JBQW9CLE9BQU87QUFDcEU7QUFFQSxTQUFTLGtCQUFrQixPQUFlLFFBQTZDO0FBQ3JGLE1BQUksQ0FBQyxPQUFPO0FBQ1YsV0FBTztBQUFBLEVBQ1Q7QUFFQSxNQUFJLGdCQUFnQixLQUFLLEdBQUc7QUFDMUIsV0FBTywwQkFBMEIsRUFBRSxPQUFPLGFBQWEsT0FBTyxZQUFZLENBQUM7QUFBQSxFQUM3RTtBQUVBLE1BQUksTUFBTSxTQUFTLEtBQUssTUFBTSxXQUFXLGlCQUFpQixLQUFLLE1BQU0sU0FBUyxpQkFBaUIsR0FBRztBQUNoRyxVQUFNLFNBQVMsTUFBTSxNQUFNLEdBQUcsRUFBRTtBQUVoQyxXQUFPLGNBQWMsTUFBTSxLQUFLLElBQUksT0FBTyxNQUFNLEVBQUUsS0FBSyxPQUFPLFFBQVE7QUFBQSxFQUN6RTtBQUVBLE1BQUksTUFBTSxXQUFXLGdCQUFnQixHQUFHO0FBQ3RDLFdBQU8sT0FBTyxTQUFTLFlBQVksRUFBRSxTQUFTLE1BQU0sWUFBWSxDQUFDO0FBQUEsRUFDbkU7QUFFQSxRQUFNLFNBQVMsTUFBTSxTQUFTLEdBQUcsSUFBSSxRQUFRLEdBQUcsS0FBSztBQUNyRCxTQUFPLE9BQU8sYUFBYSxTQUFTLE9BQU8sU0FBUyxXQUFXLE1BQU07QUFDdkU7IiwKICAibmFtZXMiOiBbIk5vUHJpb3JpdHlXaW5uZXJSZWFzb24iXQp9Cg==

package/dist/lib/esm/notebook-navigator.d.mts

@@ -0,0 +1,132 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * The slice of Notebook Navigator's public API this library talks to, and the runtime narrowing that
+ * gets hold of it.
+ *
+ * **Notebook Navigator draws its own file tree, so it never raises Obsidian's `file-menu` /
+ * `files-menu` workspace events** — which is why a plugin's context-menu items simply disappear for
+ * anyone browsing through it. What it offers instead is a documented extension API
+ * (`docs/api-reference.md` + `src/api/public/notebook-navigator.d.ts` in `johansan/notebook-navigator`,
+ * API 2.0.0), reachable at runtime as `app.plugins.getPlugin('notebook-navigator').api`.
+ *
+ * The types below are DECLARED HERE rather than imported: Notebook Navigator ships its `.d.ts` for
+ * download, not as an npm package, and depending on it would turn an optional integration into a
+ * build-time dependency. They are deliberately the narrowest shape this library uses — the API also
+ * carries `metadata`, `navigation`, `selection`, `tagCollections`, `propertyNodes` and an event bus,
+ * none of which apply to a file/folder command surface.
+ */
+import type { App, MenuItem, TFile, TFolder } from 'obsidian';
+/**
+ * Notebook Navigator's public API object, narrowed to what this library uses.
+ */
+export interface NotebookNavigatorApi {
+    /**
+     * The menu-extension namespace.
+     */
+    readonly menus: NotebookNavigatorMenus;
+}
+/**
+ * What `menus.registerFileMenu` hands a subscriber when a FILE is right-clicked.
+ *
+ * There is no `Menu` here — an item is contributed through `addItem` alone, which is why the
+ * file/files menu handlers cannot simply be forwarded to it and have to be bridged (see
+ * `components/notebook-navigator-menu-event-registrar-component.ts`).
+ */
+export interface NotebookNavigatorFileMenuContext extends NotebookNavigatorMenuContext {
+    /**
+     * The file that was right-clicked.
+     */
+    readonly file: TFile;
+    /**
+     * What the tree had selected when the menu was raised.
+     */
+    readonly selection: NotebookNavigatorFileMenuSelection;
+}
+/**
+ * The selection a file menu was raised on.
+ */
+export interface NotebookNavigatorFileMenuSelection {
+    /**
+     * Every selected file, which for `single` is just the right-clicked one.
+     */
+    readonly files: readonly TFile[];
+    /**
+     * Whether one file or several are selected.
+     */
+    readonly mode: NotebookNavigatorFileMenuSelectionMode;
+}
+/**
+ * Whether a file menu covers one file or a multi-selection.
+ */
+export type NotebookNavigatorFileMenuSelectionMode = 'multiple' | 'single';
+/**
+ * What `menus.registerFolderMenu` hands a subscriber when a FOLDER is right-clicked.
+ */
+export interface NotebookNavigatorFolderMenuContext extends NotebookNavigatorMenuContext {
+    /**
+     * The folder that was right-clicked.
+     */
+    readonly folder: TFolder;
+}
+/**
+ * What every Notebook Navigator menu context has in common: a way to add an item, and nothing else.
+ *
+ * The absence of a `Menu` is the whole shape of the integration problem — command handlers write into
+ * a `Menu`, so something has to sit between them and this.
+ */
+export interface NotebookNavigatorMenuContext {
+    /**
+     * Adds an item to the menu Notebook Navigator is building.
+     *
+     * @param callback - Receives the created item, to be configured in place.
+     */
+    addItem: (callback: (item: MenuItem) => void) => void;
+}
+/**
+ * Unregisters a menu extension. Notebook Navigator returns a bare function rather than a disposable,
+ * so it is registered with the bridging component's `register`.
+ */
+export type NotebookNavigatorMenuDispose = () => void;
+/**
+ * The `menus` namespace of Notebook Navigator's API.
+ *
+ * Only the file and folder registrars are declared: the tag and property registrars extend menus
+ * raised on things a file/folder command handler has no counterpart for.
+ */
+export interface NotebookNavigatorMenus {
+    /**
+     * Registers a contributor to the file context menu.
+     *
+     * @param callback - Invoked while the menu is being built.
+     * @returns A function that unregisters the contributor.
+     */
+    registerFileMenu: (callback: (context: NotebookNavigatorFileMenuContext) => void) => NotebookNavigatorMenuDispose;
+    /**
+     * Registers a contributor to the folder context menu.
+     *
+     * @param callback - Invoked while the menu is being built.
+     * @returns A function that unregisters the contributor.
+     */
+    registerFolderMenu: (callback: (context: NotebookNavigatorFolderMenuContext) => void) => NotebookNavigatorMenuDispose;
+}
+/**
+ * The `source` handed to the menu event handlers for a Notebook Navigator menu.
+ *
+ * Obsidian's own File Explorer sends `file-explorer-context-menu`; nothing in this library gates on
+ * the value, but the handlers are contracted to receive one, and a distinct string is what makes a
+ * handler able to tell the two surfaces apart.
+ */
+export declare const NOTEBOOK_NAVIGATOR_MENU_SOURCE = "notebook-navigator-context-menu";
+/**
+ * Notebook Navigator's plugin id, as its manifest declares it.
+ */
+export declare const NOTEBOOK_NAVIGATOR_PLUGIN_ID = "notebook-navigator";
+/**
+ * Gets Notebook Navigator's API, when it is installed, enabled and new enough.
+ *
+ * @param app - The application instance.
+ * @returns The API, or `null` when Notebook Navigator is not there to talk to.
+ */
+export declare function resolveNotebookNavigatorApi(app: App): NotebookNavigatorApi | null;

package/dist/lib/esm/notebook-navigator.mjs

@@ -0,0 +1,64 @@
+/*
+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 initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+const NOTEBOOK_NAVIGATOR_MENU_SOURCE = "notebook-navigator-context-menu";
+const NOTEBOOK_NAVIGATOR_PLUGIN_ID = "notebook-navigator";
+function resolveNotebookNavigatorApi(app) {
+  const plugin = app.plugins.getPlugin(NOTEBOOK_NAVIGATOR_PLUGIN_ID);
+  if (!plugin || !("api" in plugin)) {
+    return null;
+  }
+  const api = plugin.api;
+  return isNotebookNavigatorApi(api) ? api : null;
+}
+function isNotebookNavigatorApi(value) {
+  if (typeof value !== "object" || value === null || !("menus" in value)) {
+    return false;
+  }
+  const menus = value.menus;
+  return typeof menus === "object" && menus !== null && "registerFileMenu" in menus && typeof menus.registerFileMenu === "function" && "registerFolderMenu" in menus && typeof menus.registerFolderMenu === "function";
+}
+export {
+  NOTEBOOK_NAVIGATOR_MENU_SOURCE,
+  NOTEBOOK_NAVIGATOR_PLUGIN_ID,
+  resolveNotebookNavigatorApi
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL25vdGVib29rLW5hdmlnYXRvci50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRoZSBzbGljZSBvZiBOb3RlYm9vayBOYXZpZ2F0b3IncyBwdWJsaWMgQVBJIHRoaXMgbGlicmFyeSB0YWxrcyB0bywgYW5kIHRoZSBydW50aW1lIG5hcnJvd2luZyB0aGF0XG4gKiBnZXRzIGhvbGQgb2YgaXQuXG4gKlxuICogKipOb3RlYm9vayBOYXZpZ2F0b3IgZHJhd3MgaXRzIG93biBmaWxlIHRyZWUsIHNvIGl0IG5ldmVyIHJhaXNlcyBPYnNpZGlhbidzIGBmaWxlLW1lbnVgIC9cbiAqIGBmaWxlcy1tZW51YCB3b3Jrc3BhY2UgZXZlbnRzKiogXHUyMDE0IHdoaWNoIGlzIHdoeSBhIHBsdWdpbidzIGNvbnRleHQtbWVudSBpdGVtcyBzaW1wbHkgZGlzYXBwZWFyIGZvclxuICogYW55b25lIGJyb3dzaW5nIHRocm91Z2ggaXQuIFdoYXQgaXQgb2ZmZXJzIGluc3RlYWQgaXMgYSBkb2N1bWVudGVkIGV4dGVuc2lvbiBBUElcbiAqIChgZG9jcy9hcGktcmVmZXJlbmNlLm1kYCArIGBzcmMvYXBpL3B1YmxpYy9ub3RlYm9vay1uYXZpZ2F0b3IuZC50c2AgaW4gYGpvaGFuc2FuL25vdGVib29rLW5hdmlnYXRvcmAsXG4gKiBBUEkgMi4wLjApLCByZWFjaGFibGUgYXQgcnVudGltZSBhcyBgYXBwLnBsdWdpbnMuZ2V0UGx1Z2luKCdub3RlYm9vay1uYXZpZ2F0b3InKS5hcGlgLlxuICpcbiAqIFRoZSB0eXBlcyBiZWxvdyBhcmUgREVDTEFSRUQgSEVSRSByYXRoZXIgdGhhbiBpbXBvcnRlZDogTm90ZWJvb2sgTmF2aWdhdG9yIHNoaXBzIGl0cyBgLmQudHNgIGZvclxuICogZG93bmxvYWQsIG5vdCBhcyBhbiBucG0gcGFja2FnZSwgYW5kIGRlcGVuZGluZyBvbiBpdCB3b3VsZCB0dXJuIGFuIG9wdGlvbmFsIGludGVncmF0aW9uIGludG8gYVxuICogYnVpbGQtdGltZSBkZXBlbmRlbmN5LiBUaGV5IGFyZSBkZWxpYmVyYXRlbHkgdGhlIG5hcnJvd2VzdCBzaGFwZSB0aGlzIGxpYnJhcnkgdXNlcyBcdTIwMTQgdGhlIEFQSSBhbHNvXG4gKiBjYXJyaWVzIGBtZXRhZGF0YWAsIGBuYXZpZ2F0aW9uYCwgYHNlbGVjdGlvbmAsIGB0YWdDb2xsZWN0aW9uc2AsIGBwcm9wZXJ0eU5vZGVzYCBhbmQgYW4gZXZlbnQgYnVzLFxuICogbm9uZSBvZiB3aGljaCBhcHBseSB0byBhIGZpbGUvZm9sZGVyIGNvbW1hbmQgc3VyZmFjZS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7XG4gIEFwcCxcbiAgTWVudUl0ZW0sXG4gIFRGaWxlLFxuICBURm9sZGVyXG59IGZyb20gJ29ic2lkaWFuJztcblxuLyoqXG4gKiBOb3RlYm9vayBOYXZpZ2F0b3IncyBwdWJsaWMgQVBJIG9iamVjdCwgbmFycm93ZWQgdG8gd2hhdCB0aGlzIGxpYnJhcnkgdXNlcy5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBOb3RlYm9va05hdmlnYXRvckFwaSB7XG4gIC8qKlxuICAgKiBUaGUgbWVudS1leHRlbnNpb24gbmFtZXNwYWNlLlxuICAgKi9cbiAgcmVhZG9ubHkgbWVudXM6IE5vdGVib29rTmF2aWdhdG9yTWVudXM7XG59XG5cbi8qKlxuICogV2hhdCBgbWVudXMucmVnaXN0ZXJGaWxlTWVudWAgaGFuZHMgYSBzdWJzY3JpYmVyIHdoZW4gYSBGSUxFIGlzIHJpZ2h0LWNsaWNrZWQuXG4gKlxuICogVGhlcmUgaXMgbm8gYE1lbnVgIGhlcmUgXHUyMDE0IGFuIGl0ZW0gaXMgY29udHJpYnV0ZWQgdGhyb3VnaCBgYWRkSXRlbWAgYWxvbmUsIHdoaWNoIGlzIHdoeSB0aGVcbiAqIGZpbGUvZmlsZXMgbWVudSBoYW5kbGVycyBjYW5ub3Qgc2ltcGx5IGJlIGZvcndhcmRlZCB0byBpdCBhbmQgaGF2ZSB0byBiZSBicmlkZ2VkIChzZWVcbiAqIGBjb21wb25lbnRzL25vdGVib29rLW5hdmlnYXRvci1tZW51LWV2ZW50LXJlZ2lzdHJhci1jb21wb25lbnQudHNgKS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBOb3RlYm9va05hdmlnYXRvckZpbGVNZW51Q29udGV4dCBleHRlbmRzIE5vdGVib29rTmF2aWdhdG9yTWVudUNvbnRleHQge1xuICAvKipcbiAgICogVGhlIGZpbGUgdGhhdCB3YXMgcmlnaHQtY2xpY2tlZC5cbiAgICovXG4gIHJlYWRvbmx5IGZpbGU6IFRGaWxlO1xuXG4gIC8qKlxuICAgKiBXaGF0IHRoZSB0cmVlIGhhZCBzZWxlY3RlZCB3aGVuIHRoZSBtZW51IHdhcyByYWlzZWQuXG4gICAqL1xuICByZWFkb25seSBzZWxlY3Rpb246IE5vdGVib29rTmF2aWdhdG9yRmlsZU1lbnVTZWxlY3Rpb247XG59XG5cbi8qKlxuICogVGhlIHNlbGVjdGlvbiBhIGZpbGUgbWVudSB3YXMgcmFpc2VkIG9uLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIE5vdGVib29rTmF2aWdhdG9yRmlsZU1lbnVTZWxlY3Rpb24ge1xuICAvKipcbiAgICogRXZlcnkgc2VsZWN0ZWQgZmlsZSwgd2hpY2ggZm9yIGBzaW5nbGVgIGlzIGp1c3QgdGhlIHJpZ2h0LWNsaWNrZWQgb25lLlxuICAgKi9cbiAgcmVhZG9ubHkgZmlsZXM6IHJlYWRvbmx5IFRGaWxlW107XG5cbiAgLyoqXG4gICAqIFdoZXRoZXIgb25lIGZpbGUgb3Igc2V2ZXJhbCBhcmUgc2VsZWN0ZWQuXG4gICAqL1xuICByZWFkb25seSBtb2RlOiBOb3RlYm9va05hdmlnYXRvckZpbGVNZW51U2VsZWN0aW9uTW9kZTtcbn1cblxuLyoqXG4gKiBXaGV0aGVyIGEgZmlsZSBtZW51IGNvdmVycyBvbmUgZmlsZSBvciBhIG11bHRpLXNlbGVjdGlvbi5cbiAqL1xuZXhwb3J0IHR5cGUgTm90ZWJvb2tOYXZpZ2F0b3JGaWxlTWVudVNlbGVjdGlvbk1vZGUgPSAnbXVsdGlwbGUnIHwgJ3NpbmdsZSc7XG5cbi8qKlxuICogV2hhdCBgbWVudXMucmVnaXN0ZXJGb2xkZXJNZW51YCBoYW5kcyBhIHN1YnNjcmliZXIgd2hlbiBhIEZPTERFUiBpcyByaWdodC1jbGlja2VkLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIE5vdGVib29rTmF2aWdhdG9yRm9sZGVyTWVudUNvbnRleHQgZXh0ZW5kcyBOb3RlYm9va05hdmlnYXRvck1lbnVDb250ZXh0IHtcbiAgLyoqXG4gICAqIFRoZSBmb2xkZXIgdGhhdCB3YXMgcmlnaHQtY2xpY2tlZC5cbiAgICovXG4gIHJlYWRvbmx5IGZvbGRlcjogVEZvbGRlcjtcbn1cblxuLyoqXG4gKiBXaGF0IGV2ZXJ5IE5vdGVib29rIE5hdmlnYXRvciBtZW51IGNvbnRleHQgaGFzIGluIGNvbW1vbjogYSB3YXkgdG8gYWRkIGFuIGl0ZW0sIGFuZCBub3RoaW5nIGVsc2UuXG4gKlxuICogVGhlIGFic2VuY2Ugb2YgYSBgTWVudWAgaXMgdGhlIHdob2xlIHNoYXBlIG9mIHRoZSBpbnRlZ3JhdGlvbiBwcm9ibGVtIFx1MjAxNCBjb21tYW5kIGhhbmRsZXJzIHdyaXRlIGludG9cbiAqIGEgYE1lbnVgLCBzbyBzb21ldGhpbmcgaGFzIHRvIHNpdCBiZXR3ZWVuIHRoZW0gYW5kIHRoaXMuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTm90ZWJvb2tOYXZpZ2F0b3JNZW51Q29udGV4dCB7XG4gIC8qKlxuICAgKiBBZGRzIGFuIGl0ZW0gdG8gdGhlIG1lbnUgTm90ZWJvb2sgTmF2aWdhdG9yIGlzIGJ1aWxkaW5nLlxuICAgKlxuICAgKiBAcGFyYW0gY2FsbGJhY2sgLSBSZWNlaXZlcyB0aGUgY3JlYXRlZCBpdGVtLCB0byBiZSBjb25maWd1cmVkIGluIHBsYWNlLlxuICAgKi9cbiAgYWRkSXRlbTogKGNhbGxiYWNrOiAoaXRlbTogTWVudUl0ZW0pID0+IHZvaWQpID0+IHZvaWQ7XG59XG5cbi8qKlxuICogVW5yZWdpc3RlcnMgYSBtZW51IGV4dGVuc2lvbi4gTm90ZWJvb2sgTmF2aWdhdG9yIHJldHVybnMgYSBiYXJlIGZ1bmN0aW9uIHJhdGhlciB0aGFuIGEgZGlzcG9zYWJsZSxcbiAqIHNvIGl0IGlzIHJlZ2lzdGVyZWQgd2l0aCB0aGUgYnJpZGdpbmcgY29tcG9uZW50J3MgYHJlZ2lzdGVyYC5cbiAqL1xuZXhwb3J0IHR5cGUgTm90ZWJvb2tOYXZpZ2F0b3JNZW51RGlzcG9zZSA9ICgpID0+IHZvaWQ7XG5cbi8qKlxuICogVGhlIGBtZW51c2AgbmFtZXNwYWNlIG9mIE5vdGVib29rIE5hdmlnYXRvcidzIEFQSS5cbiAqXG4gKiBPbmx5IHRoZSBmaWxlIGFuZCBmb2xkZXIgcmVnaXN0cmFycyBhcmUgZGVjbGFyZWQ6IHRoZSB0YWcgYW5kIHByb3BlcnR5IHJlZ2lzdHJhcnMgZXh0ZW5kIG1lbnVzXG4gKiByYWlzZWQgb24gdGhpbmdzIGEgZmlsZS9mb2xkZXIgY29tbWFuZCBoYW5kbGVyIGhhcyBubyBjb3VudGVycGFydCBmb3IuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTm90ZWJvb2tOYXZpZ2F0b3JNZW51cyB7XG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYSBjb250cmlidXRvciB0byB0aGUgZmlsZSBjb250ZXh0IG1lbnUuXG4gICAqXG4gICAqIEBwYXJhbSBjYWxsYmFjayAtIEludm9rZWQgd2hpbGUgdGhlIG1lbnUgaXMgYmVpbmcgYnVpbHQuXG4gICAqIEByZXR1cm5zIEEgZnVuY3Rpb24gdGhhdCB1bnJlZ2lzdGVycyB0aGUgY29udHJpYnV0b3IuXG4gICAqL1xuICByZWdpc3RlckZpbGVNZW51OiAoY2FsbGJhY2s6IChjb250ZXh0OiBOb3RlYm9va05hdmlnYXRvckZpbGVNZW51Q29udGV4dCkgPT4gdm9pZCkgPT4gTm90ZWJvb2tOYXZpZ2F0b3JNZW51RGlzcG9zZTtcblxuICAvKipcbiAgICogUmVnaXN0ZXJzIGEgY29udHJpYnV0b3IgdG8gdGhlIGZvbGRlciBjb250ZXh0IG1lbnUuXG4gICAqXG4gICAqIEBwYXJhbSBjYWxsYmFjayAtIEludm9rZWQgd2hpbGUgdGhlIG1lbnUgaXMgYmVpbmcgYnVpbHQuXG4gICAqIEByZXR1cm5zIEEgZnVuY3Rpb24gdGhhdCB1bnJlZ2lzdGVycyB0aGUgY29udHJpYnV0b3IuXG4gICAqL1xuICByZWdpc3RlckZvbGRlck1lbnU6IChjYWxsYmFjazogKGNvbnRleHQ6IE5vdGVib29rTmF2aWdhdG9yRm9sZGVyTWVudUNvbnRleHQpID0+IHZvaWQpID0+IE5vdGVib29rTmF2aWdhdG9yTWVudURpc3Bvc2U7XG59XG5cbi8qKlxuICogVGhlIGBzb3VyY2VgIGhhbmRlZCB0byB0aGUgbWVudSBldmVudCBoYW5kbGVycyBmb3IgYSBOb3RlYm9vayBOYXZpZ2F0b3IgbWVudS5cbiAqXG4gKiBPYnNpZGlhbidzIG93biBGaWxlIEV4cGxvcmVyIHNlbmRzIGBmaWxlLWV4cGxvcmVyLWNvbnRleHQtbWVudWA7IG5vdGhpbmcgaW4gdGhpcyBsaWJyYXJ5IGdhdGVzIG9uXG4gKiB0aGUgdmFsdWUsIGJ1dCB0aGUgaGFuZGxlcnMgYXJlIGNvbnRyYWN0ZWQgdG8gcmVjZWl2ZSBvbmUsIGFuZCBhIGRpc3RpbmN0IHN0cmluZyBpcyB3aGF0IG1ha2VzIGFcbiAqIGhhbmRsZXIgYWJsZSB0byB0ZWxsIHRoZSB0d28gc3VyZmFjZXMgYXBhcnQuXG4gKi9cbmV4cG9ydCBjb25zdCBOT1RFQk9PS19OQVZJR0FUT1JfTUVOVV9TT1VSQ0UgPSAnbm90ZWJvb2stbmF2aWdhdG9yLWNvbnRleHQtbWVudSc7XG5cbi8qKlxuICogTm90ZWJvb2sgTmF2aWdhdG9yJ3MgcGx1Z2luIGlkLCBhcyBpdHMgbWFuaWZlc3QgZGVjbGFyZXMgaXQuXG4gKi9cbmV4cG9ydCBjb25zdCBOT1RFQk9PS19OQVZJR0FUT1JfUExVR0lOX0lEID0gJ25vdGVib29rLW5hdmlnYXRvcic7XG5cbi8qKlxuICogR2V0cyBOb3RlYm9vayBOYXZpZ2F0b3IncyBBUEksIHdoZW4gaXQgaXMgaW5zdGFsbGVkLCBlbmFibGVkIGFuZCBuZXcgZW5vdWdoLlxuICpcbiAqIEBwYXJhbSBhcHAgLSBUaGUgYXBwbGljYXRpb24gaW5zdGFuY2UuXG4gKiBAcmV0dXJucyBUaGUgQVBJLCBvciBgbnVsbGAgd2hlbiBOb3RlYm9vayBOYXZpZ2F0b3IgaXMgbm90IHRoZXJlIHRvIHRhbGsgdG8uXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiByZXNvbHZlTm90ZWJvb2tOYXZpZ2F0b3JBcGkoYXBwOiBBcHApOiBOb3RlYm9va05hdmlnYXRvckFwaSB8IG51bGwge1xuICBjb25zdCBwbHVnaW4gPSBhcHAucGx1Z2lucy5nZXRQbHVnaW4oTk9URUJPT0tfTkFWSUdBVE9SX1BMVUdJTl9JRCk7XG4gIGlmICghcGx1Z2luIHx8ICEoJ2FwaScgaW4gcGx1Z2luKSkge1xuICAgIHJldHVybiBudWxsO1xuICB9XG5cbiAgY29uc3QgYXBpOiB1bmtub3duID0gcGx1Z2luLmFwaTtcbiAgcmV0dXJuIGlzTm90ZWJvb2tOYXZpZ2F0b3JBcGkoYXBpKSA/IGFwaSA6IG51bGw7XG59XG5cbi8qKlxuICogQ2hlY2tzIHRoYXQgYSB2YWx1ZSBpcyBOb3RlYm9vayBOYXZpZ2F0b3IncyBBUEksIGJ5IHRoZSBtZW1iZXJzIHRoaXMgbGlicmFyeSBhY3R1YWxseSBjYWxscy5cbiAqXG4gKiBBIHByZWRpY2F0ZSByYXRoZXIgdGhhbiBhIGNhc3Qgb24gcHVycG9zZTogYGFwaWAgaXMgbm90IHBhcnQgb2YgT2JzaWRpYW4ncyBgUGx1Z2luYCB0eXBlLCBzbyB0aGVcbiAqIHZhbHVlIGFycml2ZXMgYXMgYHVua25vd25gIGFuZCB0aGUgb25seSBob25lc3Qgd2F5IHRvIHR5cGUgaXQgaXMgdG8gVkVSSUZZIGl0LiBBIE5vdGVib29rIE5hdmlnYXRvclxuICogb2xkIGVub3VnaCB0byBwcmVkYXRlIHRoZSBtZW51cyBuYW1lc3BhY2UsIG9yIGEgZnV0dXJlIG9uZSB0aGF0IHJlbmFtZXMgaXQsIHRoZXJlZm9yZSByZWFkcyBhc1xuICogXCJubyBBUElcIiBhbmQgdGhlIGludGVncmF0aW9uIHN0YXlzIGRvcm1hbnQgaW5zdGVhZCBvZiB0aHJvd2luZyBhdCBtZW51IHRpbWUuXG4gKlxuICogQHBhcmFtIHZhbHVlIC0gVGhlIGNhbmRpZGF0ZSBgYXBpYCBvYmplY3QuXG4gKiBAcmV0dXJucyBXaGV0aGVyIGl0IGNhcnJpZXMgYm90aCBtZW51IHJlZ2lzdHJhcnMuXG4gKi9cbmZ1bmN0aW9uIGlzTm90ZWJvb2tOYXZpZ2F0b3JBcGkodmFsdWU6IHVua25vd24pOiB2YWx1ZSBpcyBOb3RlYm9va05hdmlnYXRvckFwaSB7XG4gIGlmICh0eXBlb2YgdmFsdWUgIT09ICdvYmplY3QnIHx8IHZhbHVlID09PSBudWxsIHx8ICEoJ21lbnVzJyBpbiB2YWx1ZSkpIHtcbiAgICByZXR1cm4gZmFsc2U7XG4gIH1cblxuICBjb25zdCBtZW51czogdW5rbm93biA9IHZhbHVlLm1lbnVzO1xuICByZXR1cm4gdHlwZW9mIG1lbnVzID09PSAnb2JqZWN0JyAmJiBtZW51cyAhPT0gbnVsbFxuICAgICYmICdyZWdpc3RlckZpbGVNZW51JyBpbiBtZW51cyAmJiB0eXBlb2YgbWVudXMucmVnaXN0ZXJGaWxlTWVudSA9PT0gJ2Z1bmN0aW9uJ1xuICAgICYmICdyZWdpc3RlckZvbGRlck1lbnUnIGluIG1lbnVzICYmIHR5cGVvZiBtZW51cy5yZWdpc3RlckZvbGRlck1lbnUgPT09ICdmdW5jdGlvbic7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQXlJTyxNQUFNLGlDQUFpQztBQUt2QyxNQUFNLCtCQUErQjtBQVFyQyxTQUFTLDRCQUE0QixLQUF1QztBQUNqRixRQUFNLFNBQVMsSUFBSSxRQUFRLFVBQVUsNEJBQTRCO0FBQ2pFLE1BQUksQ0FBQyxVQUFVLEVBQUUsU0FBUyxTQUFTO0FBQ2pDLFdBQU87QUFBQSxFQUNUO0FBRUEsUUFBTSxNQUFlLE9BQU87QUFDNUIsU0FBTyx1QkFBdUIsR0FBRyxJQUFJLE1BQU07QUFDN0M7QUFhQSxTQUFTLHVCQUF1QixPQUErQztBQUM3RSxNQUFJLE9BQU8sVUFBVSxZQUFZLFVBQVUsUUFBUSxFQUFFLFdBQVcsUUFBUTtBQUN0RSxXQUFPO0FBQUEsRUFDVDtBQUVBLFFBQU0sUUFBaUIsTUFBTTtBQUM3QixTQUFPLE9BQU8sVUFBVSxZQUFZLFVBQVUsUUFDekMsc0JBQXNCLFNBQVMsT0FBTyxNQUFNLHFCQUFxQixjQUNqRSx3QkFBd0IsU0FBUyxPQUFPLE1BQU0sdUJBQXVCO0FBQzVFOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/esm/obsidian-dev-utils-state.d.mts

@@ -0,0 +1,42 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * Provides access to a process-wide shared-state bag used internally by `obsidian-dev-utils`.
+ *
+ * The bag is stored on `globalThis.__obsidianDevUtils`, i.e. on the global object of the realm in
+ * which `obsidian-dev-utils` is loaded. Because a function's `globalThis` resolves to its defining
+ * realm (not the caller's), every consumer that bundles the library in the main Obsidian renderer
+ * shares the same bag, regardless of which window is currently active. This intentionally replaces
+ * the previous `App`-scoped storage, so callers no longer need to pass an `App` instance.
+ *
+ * The generic, non-Obsidian state (the debuggers, the `debug` instance and the shared abort controller) lives in
+ * `typescript-lib-state.ts` instead. {@link shareTypescriptLibStateWithObsidianDevUtilsState} links the two, so
+ * plugins bundling an older copy of this library, which still keep that state here, share it with newer ones.
+ */
+import { ValueWrapper } from '@mnaoumov/typescript-lib/value-wrapper';
+/**
+ * Retrieves or creates a shared-state {@link ValueWrapper} for a given key on `globalThis.__obsidianDevUtils`.
+ *
+ * @typeParam T - The type of the shared state value.
+ * @param key - The key to store or retrieve the shared state under.
+ * @param defaultValue - The default value to use if the shared state does not exist yet.
+ * @returns The {@link ValueWrapper} that stores the shared state.
+ */
+export declare function getObsidianDevUtilsState<T>(key: string, defaultValue: T): ValueWrapper<T>;
+/**
+ * Clears the shared-state bag on `globalThis.__obsidianDevUtils`.
+ *
+ * Intended for test isolation: call it before each test so accumulated state (debuggers, queues,
+ * registered handlers, etc.) does not leak between tests.
+ */
+export declare function resetObsidianDevUtilsState(): void;
+/**
+ * Makes the generic shared state and `__obsidianDevUtils` hold the same {@link ValueWrapper} for each key that
+ * moved between them.
+ *
+ * A wrapper already under `__obsidianDevUtils` wins, because an older copy of this library loaded first and its
+ * callers already hold that instance. Otherwise the generic wrapper is published under `__obsidianDevUtils`, for
+ * older copies loaded later and for the devtools console.
+ */
+export declare function shareTypescriptLibStateWithObsidianDevUtilsState(): void;