@mnaoumov/obsidian-lib 0.0.0 → 1.0.0

package/dist/lib/esm/components/registry-component.mjs

@@ -0,0 +1,98 @@
+/*
+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'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    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 { ensureNonNullable } from "@mnaoumov/typescript-lib/type-guards";
+import { ComponentEx } from "./component-ex.mjs";
+class RegistryComponent extends ComponentEx {
+  /**
+   * Get the single child of the given type.
+   *
+   * @typeParam TComponent - The type of component to get.
+   * @param componentClass - The class of the component to get.
+   * @returns The single registered child of the given type.
+   */
+  getChild(componentClass) {
+    const child = this.getChildOrNull(componentClass);
+    if (child) {
+      return child;
+    }
+    throw new Error(`No instance of ${componentClass.name} registered`);
+  }
+  /**
+   * Get the single child of the given type.
+   *
+   * @typeParam TComponent - The type of component to get.
+   * @param componentClass - The class of the component to get.
+   * @returns The single registered child of the given type, or `null` if none are registered.
+   */
+  getChildOrNull(componentClass) {
+    const children = this.getChildren(componentClass);
+    if (children.length === 0) {
+      return null;
+    }
+    if (children.length === 1) {
+      return ensureNonNullable(children[0]);
+    }
+    throw new Error(`Multiple instances of ${componentClass.name} registered`);
+  }
+  /**
+   * Get all children of the given type.
+   *
+   * @typeParam TComponent - The type of component to get.
+   * @param componentClass - The class of the component to get.
+   * @returns All registered children of the given type.
+   */
+  getChildren(componentClass) {
+    return this._children.filter((child) => child instanceof componentClass);
+  }
+}
+export {
+  RegistryComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvcmVnaXN0cnktY29tcG9uZW50LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICoge0BsaW5rIFJlZ2lzdHJ5Q29tcG9uZW50fS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IENvbnN0cnVjdG9yIH0gZnJvbSAndHlwZS1mZXN0JztcblxuaW1wb3J0IHsgZW5zdXJlTm9uTnVsbGFibGUgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvdHlwZS1ndWFyZHMnO1xuXG5pbXBvcnQgeyBDb21wb25lbnRFeCB9IGZyb20gJy4vY29tcG9uZW50LWV4LnRzJztcblxuLyoqXG4gKiBBIGNvbXBvbmVudCB0aGF0IGtlZXBzIHJlZ2lzdHJ5IG9mIGl0cyBjaGlsZHJlbi5cbiAqL1xuZXhwb3J0IGNsYXNzIFJlZ2lzdHJ5Q29tcG9uZW50IGV4dGVuZHMgQ29tcG9uZW50RXgge1xuICAvKipcbiAgICogR2V0IHRoZSBzaW5nbGUgY2hpbGQgb2YgdGhlIGdpdmVuIHR5cGUuXG4gICAqXG4gICAqIEB0eXBlUGFyYW0gVENvbXBvbmVudCAtIFRoZSB0eXBlIG9mIGNvbXBvbmVudCB0byBnZXQuXG4gICAqIEBwYXJhbSBjb21wb25lbnRDbGFzcyAtIFRoZSBjbGFzcyBvZiB0aGUgY29tcG9uZW50IHRvIGdldC5cbiAgICogQHJldHVybnMgVGhlIHNpbmdsZSByZWdpc3RlcmVkIGNoaWxkIG9mIHRoZSBnaXZlbiB0eXBlLlxuICAgKi9cbiAgcHVibGljIGdldENoaWxkPFRDb21wb25lbnQ+KGNvbXBvbmVudENsYXNzOiBDb25zdHJ1Y3RvcjxUQ29tcG9uZW50Pik6IFRDb21wb25lbnQge1xuICAgIGNvbnN0IGNoaWxkID0gdGhpcy5nZXRDaGlsZE9yTnVsbChjb21wb25lbnRDbGFzcyk7XG4gICAgaWYgKGNoaWxkKSB7XG4gICAgICByZXR1cm4gY2hpbGQ7XG4gICAgfVxuXG4gICAgdGhyb3cgbmV3IEVycm9yKGBObyBpbnN0YW5jZSBvZiAke2NvbXBvbmVudENsYXNzLm5hbWV9IHJlZ2lzdGVyZWRgKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBHZXQgdGhlIHNpbmdsZSBjaGlsZCBvZiB0aGUgZ2l2ZW4gdHlwZS5cbiAgICpcbiAgICogQHR5cGVQYXJhbSBUQ29tcG9uZW50IC0gVGhlIHR5cGUgb2YgY29tcG9uZW50IHRvIGdldC5cbiAgICogQHBhcmFtIGNvbXBvbmVudENsYXNzIC0gVGhlIGNsYXNzIG9mIHRoZSBjb21wb25lbnQgdG8gZ2V0LlxuICAgKiBAcmV0dXJucyBUaGUgc2luZ2xlIHJlZ2lzdGVyZWQgY2hpbGQgb2YgdGhlIGdpdmVuIHR5cGUsIG9yIGBudWxsYCBpZiBub25lIGFyZSByZWdpc3RlcmVkLlxuICAgKi9cbiAgcHVibGljIGdldENoaWxkT3JOdWxsPFRDb21wb25lbnQ+KGNvbXBvbmVudENsYXNzOiBDb25zdHJ1Y3RvcjxUQ29tcG9uZW50Pik6IG51bGwgfCBUQ29tcG9uZW50IHtcbiAgICBjb25zdCBjaGlsZHJlbiA9IHRoaXMuZ2V0Q2hpbGRyZW4oY29tcG9uZW50Q2xhc3MpO1xuICAgIGlmIChjaGlsZHJlbi5sZW5ndGggPT09IDApIHtcbiAgICAgIHJldHVybiBudWxsO1xuICAgIH1cblxuICAgIGlmIChjaGlsZHJlbi5sZW5ndGggPT09IDEpIHtcbiAgICAgIHJldHVybiBlbnN1cmVOb25OdWxsYWJsZShjaGlsZHJlblswXSk7XG4gICAgfVxuXG4gICAgdGhyb3cgbmV3IEVycm9yKGBNdWx0aXBsZSBpbnN0YW5jZXMgb2YgJHtjb21wb25lbnRDbGFzcy5uYW1lfSByZWdpc3RlcmVkYCk7XG4gIH1cblxuICAvKipcbiAgICogR2V0IGFsbCBjaGlsZHJlbiBvZiB0aGUgZ2l2ZW4gdHlwZS5cbiAgICpcbiAgICogQHR5cGVQYXJhbSBUQ29tcG9uZW50IC0gVGhlIHR5cGUgb2YgY29tcG9uZW50IHRvIGdldC5cbiAgICogQHBhcmFtIGNvbXBvbmVudENsYXNzIC0gVGhlIGNsYXNzIG9mIHRoZSBjb21wb25lbnQgdG8gZ2V0LlxuICAgKiBAcmV0dXJucyBBbGwgcmVnaXN0ZXJlZCBjaGlsZHJlbiBvZiB0aGUgZ2l2ZW4gdHlwZS5cbiAgICovXG4gIHB1YmxpYyBnZXRDaGlsZHJlbjxUQ29tcG9uZW50Pihjb21wb25lbnRDbGFzczogQ29uc3RydWN0b3I8VENvbXBvbmVudD4pOiBUQ29tcG9uZW50W10ge1xuICAgIHJldHVybiB0aGlzLl9jaGlsZHJlbi5maWx0ZXIoKGNoaWxkKSA9PiBjaGlsZCBpbnN0YW5jZW9mIGNvbXBvbmVudENsYXNzKSBhcyBUQ29tcG9uZW50W107XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFRQSxTQUFTLHlCQUF5QjtBQUVsQyxTQUFTLG1CQUFtQjtBQUtyQixNQUFNLDBCQUEwQixZQUFZO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVExQyxTQUFxQixnQkFBcUQ7QUFDL0UsVUFBTSxRQUFRLEtBQUssZUFBZSxjQUFjO0FBQ2hELFFBQUksT0FBTztBQUNULGFBQU87QUFBQSxJQUNUO0FBRUEsVUFBTSxJQUFJLE1BQU0sa0JBQWtCLGVBQWUsSUFBSSxhQUFhO0FBQUEsRUFDcEU7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBU08sZUFBMkIsZ0JBQTREO0FBQzVGLFVBQU0sV0FBVyxLQUFLLFlBQVksY0FBYztBQUNoRCxRQUFJLFNBQVMsV0FBVyxHQUFHO0FBQ3pCLGFBQU87QUFBQSxJQUNUO0FBRUEsUUFBSSxTQUFTLFdBQVcsR0FBRztBQUN6QixhQUFPLGtCQUFrQixTQUFTLENBQUMsQ0FBQztBQUFBLElBQ3RDO0FBRUEsVUFBTSxJQUFJLE1BQU0seUJBQXlCLGVBQWUsSUFBSSxhQUFhO0FBQUEsRUFDM0U7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBU08sWUFBd0IsZ0JBQXVEO0FBQ3BGLFdBQU8sS0FBSyxVQUFVLE9BQU8sQ0FBQyxVQUFVLGlCQUFpQixjQUFjO0FBQUEsRUFDekU7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/components/release-notes-component.d.mts

@@ -0,0 +1,129 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Component that shows a plugin's release notes once, when the workspace layout is ready.
+ *
+ * Several plugins hand-rolled this popup, and every copy had the same defect: it was titled only
+ * `Release notes`, over headings that are bare version numbers, so nothing in it named the plugin. A user
+ * with dozens of plugins installed could not tell whose popup it was. This component always names the
+ * plugin in the title.
+ *
+ * It also owns the wait every copy needed. The notes already shown are stored in the host's settings, and
+ * the host's settings component is a SIBLING whose own async load is still in flight when the plugin is
+ * enabled after the layout is ready. Reading the list then sees the default empty one and shows every note
+ * again, on every start. See {@link PluginSettingsComponentBase.whenLoadedFromFile}.
+ */
+import type { App } from 'obsidian';
+import type { Promisable } from 'type-fest';
+import type { PluginSettingsComponentBase } from './plugin-settings-component.mjs';
+import { ComponentEx } from './component-ex.mjs';
+/**
+ * Release notes, keyed by the semantic version that introduced each one.
+ */
+export type ReleaseNotes = Readonly<Record<string, DocumentFragment>>;
+/**
+ * Parameters for the {@link ReleaseNotesComponent} constructor.
+ */
+export interface ReleaseNotesComponentConstructorParams {
+    /**
+     * The Obsidian app instance.
+     */
+    readonly app: App;
+    /**
+     * Returns the versions whose notes the user has already seen.
+     *
+     * Storage belongs to the host plugin, typically as one of its settings, because this component has no
+     * `data.json` of its own and the list has to outlive a reload.
+     *
+     * Only ever called once {@link pluginSettingsComponent} reports its settings loaded, so an implementation
+     * that reads a setting reads the stored value rather than its default.
+     *
+     * @returns The versions already shown.
+     */
+    readonly getShownReleaseNoteVersions: () => readonly string[];
+    /**
+     * The display name of the plugin, shown in the popup title.
+     */
+    readonly pluginName: string;
+    /**
+     * The settings component holding whatever {@link getShownReleaseNoteVersions} reads.
+     *
+     * Taken as a whole component rather than as a bare "ready" flag, so the host cannot forget to wire the
+     * wait.
+     */
+    readonly pluginSettingsComponent: PluginSettingsComponentBase<object>;
+    /**
+     * Builds the release notes.
+     *
+     * Called at layout ready rather than at construction, so the fragments are built only when they may be
+     * shown, and a localized string is read after the host's translations are set up.
+     *
+     * Every key must be a valid semantic version. The notes are shown in ascending version order, whatever
+     * order the keys were written in.
+     *
+     * @returns The release notes.
+     */
+    readonly releaseNotesProvider: () => ReleaseNotes;
+    /**
+     * Records the versions whose notes the user has now seen.
+     *
+     * Called before the popup is shown, with the full list: the versions already shown followed by the ones
+     * about to be.
+     *
+     * @param versions - The versions shown.
+     * @returns A {@link Promise} that resolves once the list is persisted.
+     */
+    readonly setShownReleaseNoteVersions: (versions: readonly string[]) => Promisable<void>;
+    /**
+     * Decides whether the release notes may be shown now.
+     *
+     * When it returns `false`, nothing is shown and nothing is recorded, so the notes are shown at a later
+     * start once it returns `true`. Use it when the notes only make sense while some feature is on.
+     *
+     * @returns `true` when the notes may be shown.
+     * @default Always `true`.
+     */
+    readonly shouldShowReleaseNotes?: () => Promisable<boolean>;
+}
+/**
+ * Shows a plugin's release notes that the user has not seen yet, once the workspace layout is ready.
+ */
+export declare class ReleaseNotesComponent extends ComponentEx {
+    /**
+     * The Obsidian app instance.
+     */
+    protected readonly app: App;
+    /**
+     * The display name of the plugin, shown in the popup title.
+     */
+    protected readonly pluginName: string;
+    /**
+     * The settings component whose load is awaited before the shown versions are read.
+     */
+    protected readonly pluginSettingsComponent: PluginSettingsComponentBase<object>;
+    private readonly getShownReleaseNoteVersions;
+    private readonly releaseNotesProvider;
+    private readonly setShownReleaseNoteVersions;
+    private readonly shouldShowReleaseNotes;
+    /**
+     * Creates an instance of {@link ReleaseNotesComponent}.
+     *
+     * @param params - The constructor parameters.
+     */
+    constructor(params: ReleaseNotesComponentConstructorParams);
+    /**
+     * Loads the component, showing the unseen release notes once the layout is ready AND the host's settings
+     * have been read from disk.
+     */
+    onload(): void;
+    /**
+     * Shows the release notes the user has not seen yet, and records them as seen.
+     *
+     * Does nothing when {@link ReleaseNotesComponentConstructorParams.shouldShowReleaseNotes} declines, or when
+     * every note has been shown already.
+     *
+     * @returns A {@link Promise} that resolves once the popup is closed, or at once when nothing is shown.
+     */
+    protected showUnseenReleaseNotes(): Promise<void>;
+}

package/dist/lib/esm/components/release-notes-component.mjs

@@ -0,0 +1,136 @@
+/*
+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'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    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 { compareVersions } from "compare-versions";
+import { t } from "../i18n/i18n.mjs";
+import { alert } from "../modals/alert.mjs";
+import { ComponentEx } from "./component-ex.mjs";
+import { CallbackLayoutReadyComponent } from "./layout-ready-component.mjs";
+class ReleaseNotesComponent extends ComponentEx {
+  /**
+   * The Obsidian app instance.
+   */
+  app;
+  /**
+   * The display name of the plugin, shown in the popup title.
+   */
+  pluginName;
+  /**
+   * The settings component whose load is awaited before the shown versions are read.
+   */
+  pluginSettingsComponent;
+  getShownReleaseNoteVersions;
+  releaseNotesProvider;
+  setShownReleaseNoteVersions;
+  shouldShowReleaseNotes;
+  /**
+   * Creates an instance of {@link ReleaseNotesComponent}.
+   *
+   * @param params - The constructor parameters.
+   */
+  constructor(params) {
+    super();
+    this.app = params.app;
+    this.getShownReleaseNoteVersions = params.getShownReleaseNoteVersions;
+    this.pluginName = params.pluginName;
+    this.pluginSettingsComponent = params.pluginSettingsComponent;
+    this.releaseNotesProvider = params.releaseNotesProvider;
+    this.setShownReleaseNoteVersions = params.setShownReleaseNoteVersions;
+    this.shouldShowReleaseNotes = params.shouldShowReleaseNotes ?? (() => true);
+  }
+  /**
+   * Loads the component, showing the unseen release notes once the layout is ready AND the host's settings
+   * have been read from disk.
+   */
+  onload() {
+    this.addChild(
+      new CallbackLayoutReadyComponent(this.app, async () => {
+        await this.pluginSettingsComponent.whenLoadedFromFile();
+        if (this.isUnloaded()) {
+          return;
+        }
+        await this.showUnseenReleaseNotes();
+      })
+    );
+  }
+  /**
+   * Shows the release notes the user has not seen yet, and records them as seen.
+   *
+   * Does nothing when {@link ReleaseNotesComponentConstructorParams.shouldShowReleaseNotes} declines, or when
+   * every note has been shown already.
+   *
+   * @returns A {@link Promise} that resolves once the popup is closed, or at once when nothing is shown.
+   */
+  async showUnseenReleaseNotes() {
+    if (!await this.shouldShowReleaseNotes()) {
+      return;
+    }
+    const shownVersions = this.getShownReleaseNoteVersions();
+    const shownVersionSet = new Set(shownVersions);
+    const unseenReleaseNotes = Object.entries(this.releaseNotesProvider()).filter(([version]) => !shownVersionSet.has(version)).sort(([version1], [version2]) => compareVersions(version1, version2));
+    if (unseenReleaseNotes.length === 0) {
+      return;
+    }
+    const message = createFragment();
+    for (const [version, releaseNote] of unseenReleaseNotes) {
+      message.createEl("h3", { text: version });
+      message.append(releaseNote);
+    }
+    await this.setShownReleaseNoteVersions([...shownVersions, ...unseenReleaseNotes.map(([version]) => version)]);
+    await alert({
+      app: this.app,
+      message,
+      title: t(($) => $.obsidianDevUtils.releaseNotes.title, { pluginName: this.pluginName })
+    });
+  }
+}
+export {
+  ReleaseNotesComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvcmVsZWFzZS1ub3Rlcy1jb21wb25lbnQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBDb21wb25lbnQgdGhhdCBzaG93cyBhIHBsdWdpbidzIHJlbGVhc2Ugbm90ZXMgb25jZSwgd2hlbiB0aGUgd29ya3NwYWNlIGxheW91dCBpcyByZWFkeS5cbiAqXG4gKiBTZXZlcmFsIHBsdWdpbnMgaGFuZC1yb2xsZWQgdGhpcyBwb3B1cCwgYW5kIGV2ZXJ5IGNvcHkgaGFkIHRoZSBzYW1lIGRlZmVjdDogaXQgd2FzIHRpdGxlZCBvbmx5XG4gKiBgUmVsZWFzZSBub3Rlc2AsIG92ZXIgaGVhZGluZ3MgdGhhdCBhcmUgYmFyZSB2ZXJzaW9uIG51bWJlcnMsIHNvIG5vdGhpbmcgaW4gaXQgbmFtZWQgdGhlIHBsdWdpbi4gQSB1c2VyXG4gKiB3aXRoIGRvemVucyBvZiBwbHVnaW5zIGluc3RhbGxlZCBjb3VsZCBub3QgdGVsbCB3aG9zZSBwb3B1cCBpdCB3YXMuIFRoaXMgY29tcG9uZW50IGFsd2F5cyBuYW1lcyB0aGVcbiAqIHBsdWdpbiBpbiB0aGUgdGl0bGUuXG4gKlxuICogSXQgYWxzbyBvd25zIHRoZSB3YWl0IGV2ZXJ5IGNvcHkgbmVlZGVkLiBUaGUgbm90ZXMgYWxyZWFkeSBzaG93biBhcmUgc3RvcmVkIGluIHRoZSBob3N0J3Mgc2V0dGluZ3MsIGFuZFxuICogdGhlIGhvc3QncyBzZXR0aW5ncyBjb21wb25lbnQgaXMgYSBTSUJMSU5HIHdob3NlIG93biBhc3luYyBsb2FkIGlzIHN0aWxsIGluIGZsaWdodCB3aGVuIHRoZSBwbHVnaW4gaXNcbiAqIGVuYWJsZWQgYWZ0ZXIgdGhlIGxheW91dCBpcyByZWFkeS4gUmVhZGluZyB0aGUgbGlzdCB0aGVuIHNlZXMgdGhlIGRlZmF1bHQgZW1wdHkgb25lIGFuZCBzaG93cyBldmVyeSBub3RlXG4gKiBhZ2Fpbiwgb24gZXZlcnkgc3RhcnQuIFNlZSB7QGxpbmsgUGx1Z2luU2V0dGluZ3NDb21wb25lbnRCYXNlLndoZW5Mb2FkZWRGcm9tRmlsZX0uXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBBcHAgfSBmcm9tICdvYnNpZGlhbic7XG5pbXBvcnQgdHlwZSB7IFByb21pc2FibGUgfSBmcm9tICd0eXBlLWZlc3QnO1xuXG5pbXBvcnQgeyBjb21wYXJlVmVyc2lvbnMgfSBmcm9tICdjb21wYXJlLXZlcnNpb25zJztcblxuaW1wb3J0IHR5cGUgeyBQbHVnaW5TZXR0aW5nc0NvbXBvbmVudEJhc2UgfSBmcm9tICcuL3BsdWdpbi1zZXR0aW5ncy1jb21wb25lbnQudHMnO1xuXG5pbXBvcnQgeyB0IH0gZnJvbSAnLi4vaTE4bi9pMThuLnRzJztcbmltcG9ydCB7IGFsZXJ0IH0gZnJvbSAnLi4vbW9kYWxzL2FsZXJ0LnRzJztcbmltcG9ydCB7IENvbXBvbmVudEV4IH0gZnJvbSAnLi9jb21wb25lbnQtZXgudHMnO1xuaW1wb3J0IHsgQ2FsbGJhY2tMYXlvdXRSZWFkeUNvbXBvbmVudCB9IGZyb20gJy4vbGF5b3V0LXJlYWR5LWNvbXBvbmVudC50cyc7XG5cbi8qKlxuICogUmVsZWFzZSBub3Rlcywga2V5ZWQgYnkgdGhlIHNlbWFudGljIHZlcnNpb24gdGhhdCBpbnRyb2R1Y2VkIGVhY2ggb25lLlxuICovXG5leHBvcnQgdHlwZSBSZWxlYXNlTm90ZXMgPSBSZWFkb25seTxSZWNvcmQ8c3RyaW5nLCBEb2N1bWVudEZyYWdtZW50Pj47XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3IgdGhlIHtAbGluayBSZWxlYXNlTm90ZXNDb21wb25lbnR9IGNvbnN0cnVjdG9yLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFJlbGVhc2VOb3Rlc0NvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2UuXG4gICAqL1xuICByZWFkb25seSBhcHA6IEFwcDtcblxuICAvKipcbiAgICogUmV0dXJucyB0aGUgdmVyc2lvbnMgd2hvc2Ugbm90ZXMgdGhlIHVzZXIgaGFzIGFscmVhZHkgc2Vlbi5cbiAgICpcbiAgICogU3RvcmFnZSBiZWxvbmdzIHRvIHRoZSBob3N0IHBsdWdpbiwgdHlwaWNhbGx5IGFzIG9uZSBvZiBpdHMgc2V0dGluZ3MsIGJlY2F1c2UgdGhpcyBjb21wb25lbnQgaGFzIG5vXG4gICAqIGBkYXRhLmpzb25gIG9mIGl0cyBvd24gYW5kIHRoZSBsaXN0IGhhcyB0byBvdXRsaXZlIGEgcmVsb2FkLlxuICAgKlxuICAgKiBPbmx5IGV2ZXIgY2FsbGVkIG9uY2Uge0BsaW5rIHBsdWdpblNldHRpbmdzQ29tcG9uZW50fSByZXBvcnRzIGl0cyBzZXR0aW5ncyBsb2FkZWQsIHNvIGFuIGltcGxlbWVudGF0aW9uXG4gICAqIHRoYXQgcmVhZHMgYSBzZXR0aW5nIHJlYWRzIHRoZSBzdG9yZWQgdmFsdWUgcmF0aGVyIHRoYW4gaXRzIGRlZmF1bHQuXG4gICAqXG4gICAqIEByZXR1cm5zIFRoZSB2ZXJzaW9ucyBhbHJlYWR5IHNob3duLlxuICAgKi9cbiAgcmVhZG9ubHkgZ2V0U2hvd25SZWxlYXNlTm90ZVZlcnNpb25zOiAoKSA9PiByZWFkb25seSBzdHJpbmdbXTtcblxuICAvKipcbiAgICogVGhlIGRpc3BsYXkgbmFtZSBvZiB0aGUgcGx1Z2luLCBzaG93biBpbiB0aGUgcG9wdXAgdGl0bGUuXG4gICAqL1xuICByZWFkb25seSBwbHVnaW5OYW1lOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBzZXR0aW5ncyBjb21wb25lbnQgaG9sZGluZyB3aGF0ZXZlciB7QGxpbmsgZ2V0U2hvd25SZWxlYXNlTm90ZVZlcnNpb25zfSByZWFkcy5cbiAgICpcbiAgICogVGFrZW4gYXMgYSB3aG9sZSBjb21wb25lbnQgcmF0aGVyIHRoYW4gYXMgYSBiYXJlIFwicmVhZHlcIiBmbGFnLCBzbyB0aGUgaG9zdCBjYW5ub3QgZm9yZ2V0IHRvIHdpcmUgdGhlXG4gICAqIHdhaXQuXG4gICAqL1xuICByZWFkb25seSBwbHVnaW5TZXR0aW5nc0NvbXBvbmVudDogUGx1Z2luU2V0dGluZ3NDb21wb25lbnRCYXNlPG9iamVjdD47XG5cbiAgLyoqXG4gICAqIEJ1aWxkcyB0aGUgcmVsZWFzZSBub3Rlcy5cbiAgICpcbiAgICogQ2FsbGVkIGF0IGxheW91dCByZWFkeSByYXRoZXIgdGhhbiBhdCBjb25zdHJ1Y3Rpb24sIHNvIHRoZSBmcmFnbWVudHMgYXJlIGJ1aWx0IG9ubHkgd2hlbiB0aGV5IG1heSBiZVxuICAgKiBzaG93biwgYW5kIGEgbG9jYWxpemVkIHN0cmluZyBpcyByZWFkIGFmdGVyIHRoZSBob3N0J3MgdHJhbnNsYXRpb25zIGFyZSBzZXQgdXAuXG4gICAqXG4gICAqIEV2ZXJ5IGtleSBtdXN0IGJlIGEgdmFsaWQgc2VtYW50aWMgdmVyc2lvbi4gVGhlIG5vdGVzIGFyZSBzaG93biBpbiBhc2NlbmRpbmcgdmVyc2lvbiBvcmRlciwgd2hhdGV2ZXJcbiAgICogb3JkZXIgdGhlIGtleXMgd2VyZSB3cml0dGVuIGluLlxuICAgKlxuICAgKiBAcmV0dXJucyBUaGUgcmVsZWFzZSBub3Rlcy5cbiAgICovXG4gIHJlYWRvbmx5IHJlbGVhc2VOb3Rlc1Byb3ZpZGVyOiAoKSA9PiBSZWxlYXNlTm90ZXM7XG5cbiAgLyoqXG4gICAqIFJlY29yZHMgdGhlIHZlcnNpb25zIHdob3NlIG5vdGVzIHRoZSB1c2VyIGhhcyBub3cgc2Vlbi5cbiAgICpcbiAgICogQ2FsbGVkIGJlZm9yZSB0aGUgcG9wdXAgaXMgc2hvd24sIHdpdGggdGhlIGZ1bGwgbGlzdDogdGhlIHZlcnNpb25zIGFscmVhZHkgc2hvd24gZm9sbG93ZWQgYnkgdGhlIG9uZXNcbiAgICogYWJvdXQgdG8gYmUuXG4gICAqXG4gICAqIEBwYXJhbSB2ZXJzaW9ucyAtIFRoZSB2ZXJzaW9ucyBzaG93bi5cbiAgICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyBvbmNlIHRoZSBsaXN0IGlzIHBlcnNpc3RlZC5cbiAgICovXG4gIHJlYWRvbmx5IHNldFNob3duUmVsZWFzZU5vdGVWZXJzaW9uczogKHZlcnNpb25zOiByZWFkb25seSBzdHJpbmdbXSkgPT4gUHJvbWlzYWJsZTx2b2lkPjtcblxuICAvKipcbiAgICogRGVjaWRlcyB3aGV0aGVyIHRoZSByZWxlYXNlIG5vdGVzIG1heSBiZSBzaG93biBub3cuXG4gICAqXG4gICAqIFdoZW4gaXQgcmV0dXJucyBgZmFsc2VgLCBub3RoaW5nIGlzIHNob3duIGFuZCBub3RoaW5nIGlzIHJlY29yZGVkLCBzbyB0aGUgbm90ZXMgYXJlIHNob3duIGF0IGEgbGF0ZXJcbiAgICogc3RhcnQgb25jZSBpdCByZXR1cm5zIGB0cnVlYC4gVXNlIGl0IHdoZW4gdGhlIG5vdGVzIG9ubHkgbWFrZSBzZW5zZSB3aGlsZSBzb21lIGZlYXR1cmUgaXMgb24uXG4gICAqXG4gICAqIEByZXR1cm5zIGB0cnVlYCB3aGVuIHRoZSBub3RlcyBtYXkgYmUgc2hvd24uXG4gICAqIEBkZWZhdWx0IEFsd2F5cyBgdHJ1ZWAuXG4gICAqL1xuICByZWFkb25seSBzaG91bGRTaG93UmVsZWFzZU5vdGVzPzogKCkgPT4gUHJvbWlzYWJsZTxib29sZWFuPjtcbn1cblxuLyoqXG4gKiBTaG93cyBhIHBsdWdpbidzIHJlbGVhc2Ugbm90ZXMgdGhhdCB0aGUgdXNlciBoYXMgbm90IHNlZW4geWV0LCBvbmNlIHRoZSB3b3Jrc3BhY2UgbGF5b3V0IGlzIHJlYWR5LlxuICovXG5leHBvcnQgY2xhc3MgUmVsZWFzZU5vdGVzQ29tcG9uZW50IGV4dGVuZHMgQ29tcG9uZW50RXgge1xuICAvKipcbiAgICogVGhlIE9ic2lkaWFuIGFwcCBpbnN0YW5jZS5cbiAgICovXG4gIHByb3RlY3RlZCByZWFkb25seSBhcHA6IEFwcDtcblxuICAvKipcbiAgICogVGhlIGRpc3BsYXkgbmFtZSBvZiB0aGUgcGx1Z2luLCBzaG93biBpbiB0aGUgcG9wdXAgdGl0bGUuXG4gICAqL1xuICBwcm90ZWN0ZWQgcmVhZG9ubHkgcGx1Z2luTmFtZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgc2V0dGluZ3MgY29tcG9uZW50IHdob3NlIGxvYWQgaXMgYXdhaXRlZCBiZWZvcmUgdGhlIHNob3duIHZlcnNpb25zIGFyZSByZWFkLlxuICAgKi9cbiAgcHJvdGVjdGVkIHJlYWRvbmx5IHBsdWdpblNldHRpbmdzQ29tcG9uZW50OiBQbHVnaW5TZXR0aW5nc0NvbXBvbmVudEJhc2U8b2JqZWN0PjtcblxuICBwcml2YXRlIHJlYWRvbmx5IGdldFNob3duUmVsZWFzZU5vdGVWZXJzaW9uczogKCkgPT4gcmVhZG9ubHkgc3RyaW5nW107XG4gIHByaXZhdGUgcmVhZG9ubHkgcmVsZWFzZU5vdGVzUHJvdmlkZXI6ICgpID0+IFJlbGVhc2VOb3RlcztcbiAgcHJpdmF0ZSByZWFkb25seSBzZXRTaG93blJlbGVhc2VOb3RlVmVyc2lvbnM6ICh2ZXJzaW9uczogcmVhZG9ubHkgc3RyaW5nW10pID0+IFByb21pc2FibGU8dm9pZD47XG4gIHByaXZhdGUgcmVhZG9ubHkgc2hvdWxkU2hvd1JlbGVhc2VOb3RlczogKCkgPT4gUHJvbWlzYWJsZTxib29sZWFuPjtcblxuICAvKipcbiAgICogQ3JlYXRlcyBhbiBpbnN0YW5jZSBvZiB7QGxpbmsgUmVsZWFzZU5vdGVzQ29tcG9uZW50fS5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBjb25zdHJ1Y3RvciBwYXJhbWV0ZXJzLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHBhcmFtczogUmVsZWFzZU5vdGVzQ29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXMpIHtcbiAgICBzdXBlcigpO1xuICAgIHRoaXMuYXBwID0gcGFyYW1zLmFwcDtcbiAgICB0aGlzLmdldFNob3duUmVsZWFzZU5vdGVWZXJzaW9ucyA9IHBhcmFtcy5nZXRTaG93blJlbGVhc2VOb3RlVmVyc2lvbnM7XG4gICAgdGhpcy5wbHVnaW5OYW1lID0gcGFyYW1zLnBsdWdpbk5hbWU7XG4gICAgdGhpcy5wbHVnaW5TZXR0aW5nc0NvbXBvbmVudCA9IHBhcmFtcy5wbHVnaW5TZXR0aW5nc0NvbXBvbmVudDtcbiAgICB0aGlzLnJlbGVhc2VOb3Rlc1Byb3ZpZGVyID0gcGFyYW1zLnJlbGVhc2VOb3Rlc1Byb3ZpZGVyO1xuICAgIHRoaXMuc2V0U2hvd25SZWxlYXNlTm90ZVZlcnNpb25zID0gcGFyYW1zLnNldFNob3duUmVsZWFzZU5vdGVWZXJzaW9ucztcbiAgICB0aGlzLnNob3VsZFNob3dSZWxlYXNlTm90ZXMgPSBwYXJhbXMuc2hvdWxkU2hvd1JlbGVhc2VOb3RlcyA/PyAoKCk6IGJvb2xlYW4gPT4gdHJ1ZSk7XG4gIH1cblxuICAvKipcbiAgICogTG9hZHMgdGhlIGNvbXBvbmVudCwgc2hvd2luZyB0aGUgdW5zZWVuIHJlbGVhc2Ugbm90ZXMgb25jZSB0aGUgbGF5b3V0IGlzIHJlYWR5IEFORCB0aGUgaG9zdCdzIHNldHRpbmdzXG4gICAqIGhhdmUgYmVlbiByZWFkIGZyb20gZGlzay5cbiAgICovXG4gIHB1YmxpYyBvdmVycmlkZSBvbmxvYWQoKTogdm9pZCB7XG4gICAgdGhpcy5hZGRDaGlsZChcbiAgICAgIG5ldyBDYWxsYmFja0xheW91dFJlYWR5Q29tcG9uZW50KHRoaXMuYXBwLCBhc3luYyAoKSA9PiB7XG4gICAgICAgIGF3YWl0IHRoaXMucGx1Z2luU2V0dGluZ3NDb21wb25lbnQud2hlbkxvYWRlZEZyb21GaWxlKCk7XG4gICAgICAgIGlmICh0aGlzLmlzVW5sb2FkZWQoKSkge1xuICAgICAgICAgIHJldHVybjtcbiAgICAgICAgfVxuXG4gICAgICAgIGF3YWl0IHRoaXMuc2hvd1Vuc2VlblJlbGVhc2VOb3RlcygpO1xuICAgICAgfSlcbiAgICApO1xuICB9XG5cbiAgLyoqXG4gICAqIFNob3dzIHRoZSByZWxlYXNlIG5vdGVzIHRoZSB1c2VyIGhhcyBub3Qgc2VlbiB5ZXQsIGFuZCByZWNvcmRzIHRoZW0gYXMgc2Vlbi5cbiAgICpcbiAgICogRG9lcyBub3RoaW5nIHdoZW4ge0BsaW5rIFJlbGVhc2VOb3Rlc0NvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zLnNob3VsZFNob3dSZWxlYXNlTm90ZXN9IGRlY2xpbmVzLCBvciB3aGVuXG4gICAqIGV2ZXJ5IG5vdGUgaGFzIGJlZW4gc2hvd24gYWxyZWFkeS5cbiAgICpcbiAgICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyBvbmNlIHRoZSBwb3B1cCBpcyBjbG9zZWQsIG9yIGF0IG9uY2Ugd2hlbiBub3RoaW5nIGlzIHNob3duLlxuICAgKi9cbiAgcHJvdGVjdGVkIGFzeW5jIHNob3dVbnNlZW5SZWxlYXNlTm90ZXMoKTogUHJvbWlzZTx2b2lkPiB7XG4gICAgaWYgKCFhd2FpdCB0aGlzLnNob3VsZFNob3dSZWxlYXNlTm90ZXMoKSkge1xuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIGNvbnN0IHNob3duVmVyc2lvbnMgPSB0aGlzLmdldFNob3duUmVsZWFzZU5vdGVWZXJzaW9ucygpO1xuICAgIGNvbnN0IHNob3duVmVyc2lvblNldCA9IG5ldyBTZXQoc2hvd25WZXJzaW9ucyk7XG4gICAgY29uc3QgdW5zZWVuUmVsZWFzZU5vdGVzID0gT2JqZWN0LmVudHJpZXModGhpcy5yZWxlYXNlTm90ZXNQcm92aWRlcigpKVxuICAgICAgLmZpbHRlcigoW3ZlcnNpb25dKSA9PiAhc2hvd25WZXJzaW9uU2V0Lmhhcyh2ZXJzaW9uKSlcbiAgICAgIC5zb3J0KChbdmVyc2lvbjFdLCBbdmVyc2lvbjJdKSA9PiBjb21wYXJlVmVyc2lvbnModmVyc2lvbjEsIHZlcnNpb24yKSk7XG5cbiAgICBpZiAodW5zZWVuUmVsZWFzZU5vdGVzLmxlbmd0aCA9PT0gMCkge1xuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIGNvbnN0IG1lc3NhZ2UgPSBjcmVhdGVGcmFnbWVudCgpO1xuICAgIGZvciAoY29uc3QgW3ZlcnNpb24sIHJlbGVhc2VOb3RlXSBvZiB1bnNlZW5SZWxlYXNlTm90ZXMpIHtcbiAgICAgIG1lc3NhZ2UuY3JlYXRlRWwoJ2gzJywgeyB0ZXh0OiB2ZXJzaW9uIH0pO1xuICAgICAgbWVzc2FnZS5hcHBlbmQocmVsZWFzZU5vdGUpO1xuICAgIH1cblxuICAgIC8vIFJlY29yZGVkIGJlZm9yZSB0aGUgcG9wdXAgaXMgc2hvd24sIHNvIGEgdXNlciB3aG8gcmVsb2FkcyB3aXRob3V0IGNsb3NpbmcgaXQgaXMgbm90IHNob3duIGl0IGFnYWluLlxuICAgIGF3YWl0IHRoaXMuc2V0U2hvd25SZWxlYXNlTm90ZVZlcnNpb25zKFsuLi5zaG93blZlcnNpb25zLCAuLi51bnNlZW5SZWxlYXNlTm90ZXMubWFwKChbdmVyc2lvbl0pID0+IHZlcnNpb24pXSk7XG5cbiAgICBhd2FpdCBhbGVydCh7XG4gICAgICBhcHA6IHRoaXMuYXBwLFxuICAgICAgbWVzc2FnZSxcbiAgICAgIHRpdGxlOiB0KCgkKSA9PiAkLm9ic2lkaWFuRGV2VXRpbHMucmVsZWFzZU5vdGVzLnRpdGxlLCB7IHBsdWdpbk5hbWU6IHRoaXMucGx1Z2luTmFtZSB9KVxuICAgIH0pO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBbUJBLFNBQVMsdUJBQXVCO0FBSWhDLFNBQVMsU0FBUztBQUNsQixTQUFTLGFBQWE7QUFDdEIsU0FBUyxtQkFBbUI7QUFDNUIsU0FBUyxvQ0FBb0M7QUFpRnRDLE1BQU0sOEJBQThCLFlBQVk7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUlsQztBQUFBO0FBQUE7QUFBQTtBQUFBLEVBS0E7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtBO0FBQUEsRUFFRjtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9WLFlBQVksUUFBZ0Q7QUFDakUsVUFBTTtBQUNOLFNBQUssTUFBTSxPQUFPO0FBQ2xCLFNBQUssOEJBQThCLE9BQU87QUFDMUMsU0FBSyxhQUFhLE9BQU87QUFDekIsU0FBSywwQkFBMEIsT0FBTztBQUN0QyxTQUFLLHVCQUF1QixPQUFPO0FBQ25DLFNBQUssOEJBQThCLE9BQU87QUFDMUMsU0FBSyx5QkFBeUIsT0FBTywyQkFBMkIsTUFBZTtBQUFBLEVBQ2pGO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU1nQixTQUFlO0FBQzdCLFNBQUs7QUFBQSxNQUNILElBQUksNkJBQTZCLEtBQUssS0FBSyxZQUFZO0FBQ3JELGNBQU0sS0FBSyx3QkFBd0IsbUJBQW1CO0FBQ3RELFlBQUksS0FBSyxXQUFXLEdBQUc7QUFDckI7QUFBQSxRQUNGO0FBRUEsY0FBTSxLQUFLLHVCQUF1QjtBQUFBLE1BQ3BDLENBQUM7QUFBQSxJQUNIO0FBQUEsRUFDRjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVVBLE1BQWdCLHlCQUF3QztBQUN0RCxRQUFJLENBQUMsTUFBTSxLQUFLLHVCQUF1QixHQUFHO0FBQ3hDO0FBQUEsSUFDRjtBQUVBLFVBQU0sZ0JBQWdCLEtBQUssNEJBQTRCO0FBQ3ZELFVBQU0sa0JBQWtCLElBQUksSUFBSSxhQUFhO0FBQzdDLFVBQU0scUJBQXFCLE9BQU8sUUFBUSxLQUFLLHFCQUFxQixDQUFDLEVBQ2xFLE9BQU8sQ0FBQyxDQUFDLE9BQU8sTUFBTSxDQUFDLGdCQUFnQixJQUFJLE9BQU8sQ0FBQyxFQUNuRCxLQUFLLENBQUMsQ0FBQyxRQUFRLEdBQUcsQ0FBQyxRQUFRLE1BQU0sZ0JBQWdCLFVBQVUsUUFBUSxDQUFDO0FBRXZFLFFBQUksbUJBQW1CLFdBQVcsR0FBRztBQUNuQztBQUFBLElBQ0Y7QUFFQSxVQUFNLFVBQVUsZUFBZTtBQUMvQixlQUFXLENBQUMsU0FBUyxXQUFXLEtBQUssb0JBQW9CO0FBQ3ZELGNBQVEsU0FBUyxNQUFNLEVBQUUsTUFBTSxRQUFRLENBQUM7QUFDeEMsY0FBUSxPQUFPLFdBQVc7QUFBQSxJQUM1QjtBQUdBLFVBQU0sS0FBSyw0QkFBNEIsQ0FBQyxHQUFHLGVBQWUsR0FBRyxtQkFBbUIsSUFBSSxDQUFDLENBQUMsT0FBTyxNQUFNLE9BQU8sQ0FBQyxDQUFDO0FBRTVHLFVBQU0sTUFBTTtBQUFBLE1BQ1YsS0FBSyxLQUFLO0FBQUEsTUFDVjtBQUFBLE1BQ0EsT0FBTyxFQUFFLENBQUMsTUFBTSxFQUFFLGlCQUFpQixhQUFhLE9BQU8sRUFBRSxZQUFZLEtBQUssV0FBVyxDQUFDO0FBQUEsSUFDeEYsQ0FBQztBQUFBLEVBQ0g7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/components/rename-delete-handler-component.d.mts

@@ -0,0 +1,165 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Contains utility functions for handling rename and delete events in Obsidian.
+ */
+import type { App } from 'obsidian';
+import type { LinkUpdateProgressReporter } from '../link-update-progress.mjs';
+import type { ResourceLockComponent } from '../resource-lock.mjs';
+import type { AbortSignalComponent } from './abort-signal-component.mjs';
+import type { PluginNoticeComponent } from './plugin-notice-component.mjs';
+import { EmptyFolderBehavior } from '../vault.mjs';
+import { ComponentEx } from './component-ex.mjs';
+/**
+ * Parameters for {@link RenameDeleteHandlerSettings.getRescuePath}.
+ */
+export interface GetRescuePathParams {
+    /**
+     * The path of the attachment that is about to be stranded.
+     */
+    readonly attachmentPath: string;
+    /**
+     * The paths of the notes that still reference the attachment once the deletion is done. Never empty.
+     */
+    readonly survivingNotePaths: readonly string[];
+}
+/**
+ * Settings for the rename/delete handler.
+ */
+export interface RenameDeleteHandlerSettings {
+    /**
+     * A behavior of the rename/delete handler when deleting empty folders.
+     */
+    emptyFolderBehavior: EmptyFolderBehavior;
+    /**
+     * Where to move an attachment that a deletion would otherwise strand — one that survives because another
+     * note still references it, but is left sitting in a folder whose owning note is gone.
+     *
+     * Deciding the destination is the plugin's attachment-path policy, which is why the handler asks rather
+     * than guesses. Returning `null` — or not implementing this at all — keeps the attachment where it is,
+     * which is the behavior every consumer had before this member existed.
+     */
+    getRescuePath?: (params: GetRescuePathParams) => Promise<null | string>;
+    /**
+     * Whether the path is a note.
+     */
+    isNote: (path: string) => boolean;
+    /**
+     * Whether to ignore the path.
+     */
+    isPathIgnored: (path: string) => boolean;
+    /**
+     * Whether to delete conflicting attachments.
+     */
+    shouldDeleteConflictingAttachments: boolean;
+    /**
+     * Whether to handle deletions.
+     */
+    shouldHandleDeletions: boolean;
+    /**
+     * Whether to handle renames.
+     */
+    shouldHandleRenames: boolean;
+    /**
+     * Whether to rename attachment files when a note is renamed.
+     */
+    shouldRenameAttachmentFiles: boolean;
+    /**
+     * Whether to rename attachment folder when a note is renamed.
+     */
+    shouldRenameAttachmentFolder: boolean;
+    /**
+     * Whether to update file name aliases when a note is renamed.
+     */
+    shouldUpdateFileNameAliases: boolean;
+}
+interface RenameDeleteHandlerComponentConstructorParams {
+    readonly abortSignalComponent: AbortSignalComponent;
+    readonly app: App;
+    readonly linkUpdateProgressReporter?: LinkUpdateProgressReporter;
+    readonly pluginNoticeComponent: PluginNoticeComponent;
+    readonly resourceLockComponent: null | ResourceLockComponent;
+    readonly settingsBuilder: () => Partial<RenameDeleteHandlerSettings>;
+}
+/**
+ * Resolves the settings the handler runs with.
+ *
+ * There is exactly one contributor: the component's own `settingsBuilder`. Earlier versions aggregated a
+ * registry of contributors and OR-merged their answers, because several plugins could each register a
+ * handler against the one shared vault. They no longer do, so there is no longer any question of whose
+ * setting wins.
+ *
+ * What remains is defaulting: the builder returns a `Partial`, so the two predicates and the empty-folder
+ * behavior need a value when it does not supply one.
+ */
+declare class SettingsManager {
+    private readonly settingsBuilder;
+    constructor(settingsBuilder: () => Partial<RenameDeleteHandlerSettings>);
+    getSettings(): Partial<RenameDeleteHandlerSettings>;
+    isNoteEx(path: string): boolean;
+}
+/**
+ * Component that handles rename and delete events in Obsidian.
+ * It listens to rename and delete events and updates links accordingly.
+ * It also handles edge cases such as case-only renames and collisions with existing files.
+ */
+export declare class RenameDeleteHandlerComponent extends ComponentEx {
+    /**
+     * The abort signal component whose signal cancels in-flight rename operations.
+     */
+    protected readonly abortSignalComponent: AbortSignalComponent;
+    /**
+     * The Obsidian app instance.
+     */
+    protected readonly app: App;
+    /**
+     * An optional reporter invoked once per backlink file whose links are updated during a rename/move,
+     * with the running count of processed files and the total. When `null`, no progress is reported.
+     */
+    protected readonly linkUpdateProgressReporter: LinkUpdateProgressReporter | null;
+    /**
+     * The notice component used to report updated links to the user.
+     */
+    protected readonly pluginNoticeComponent: PluginNoticeComponent;
+    /**
+     * The resource lock component used to guard link updates, or `null` if none is used.
+     */
+    protected readonly resourceLockComponent: null | ResourceLockComponent;
+    /**
+     * Builds this plugin's rename/delete handler settings.
+     */
+    protected readonly settingsBuilder: () => Partial<RenameDeleteHandlerSettings>;
+    /**
+     * The manager that aggregates rename/delete handler settings across registered plugins.
+     */
+    protected readonly settingsManager: SettingsManager;
+    private readonly deletedMetadataCacheMap;
+    private readonly handledRenames;
+    private readonly interruptedRenamesMap;
+    /**
+     * Creates an instance of RenameDeleteHandlerComponent.
+     *
+     * @param params - The parameters for the RenameDeleteHandlerComponent.
+     */
+    constructor(params: RenameDeleteHandlerComponentConstructorParams);
+    /**
+     * Loads the component
+     */
+    onload(): void;
+    private handleDelete;
+    private handleMetadataDeleted;
+    private handleRename;
+    /**
+     * With link rewriting off, the handler's only remaining jobs are moving a NOTE's attachments and pruning
+     * the folder a moved file vacated. A non-note rename needs neither when empty folders are kept, so there
+     * is nothing to queue.
+     *
+     * @param settings - The aggregated rename/delete handler settings.
+     * @param oldPath - The path the file was renamed from.
+     * @param newPath - The path the file was renamed to.
+     * @returns `true` when the handler would do no work for this rename.
+     */
+    private isNoOpRename;
+}
+export { EmptyFolderBehavior } from '../vault.mjs';