@mnaoumov/obsidian-lib 0.0.0 → 1.0.1

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

@@ -0,0 +1,413 @@
+/*
+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 { createAggregateError } from "@mnaoumov/typescript-lib/aggregate-error";
+import { snapshot } from "@mnaoumov/typescript-lib/array";
+import { dispose } from "@mnaoumov/typescript-lib/disposable";
+import {
+  ErrorWrapper,
+  SilentError
+} from "@mnaoumov/typescript-lib/error";
+import {
+  noop,
+  noopAsyncSingletonPromise
+} from "@mnaoumov/typescript-lib/function";
+import { Component } from "obsidian";
+class ComponentEx extends Component {
+  childrenSet = /* @__PURE__ */ new Set();
+  hasBeenLoaded = false;
+  loadErrors = [];
+  loadPromise = null;
+  parentComponent = null;
+  /**
+   * Adds a child component.
+   *
+   * Mirrors the native `Component.addChild` contract: if this component is already loaded, the child is loaded
+   * immediately, so `child._loaded` is set before this method returns even when this component has async load logic.
+   * The child's async tail (if any) is sequenced into the load promise so a later {@link loadWithPromises} call awaits it.
+   *
+   * Adding a child BEFORE the first load is legitimate: the child is queued and loaded when this component loads.
+   * Adding one AFTER this component has been unloaded is not — the child would never be loaded and never unloaded
+   * (a leak), so it is refused with a {@link SilentError}. The typical source of such a call is an `async` method
+   * that was suspended on an `await` when the component got unloaded and then resumed on the dead component; the
+   * {@link SilentError} unwinds it quietly (see {@link isUnloaded}).
+   *
+   * @typeParam TComponent - The type of component to add.
+   * @param component - The component instance to add.
+   * @returns The added component.
+   * @throws A {@link SilentError} if the component has already been unloaded.
+   */
+  addChild(component) {
+    if (this.isUnloaded()) {
+      throw new SilentError("Component is already unloaded");
+    }
+    this._children.push(component);
+    this.childrenSet.add(component);
+    if (component instanceof ComponentEx) {
+      component.parentComponent = this;
+    }
+    if (this._loaded) {
+      this.appendEagerLoadStep(this.extractLoadPromisable(component));
+    }
+    return component;
+  }
+  /**
+   * Checks whether a component is a direct child of this one.
+   *
+   * Only DIRECT children are reported — this is an ownership question, not a containment one. The caller that
+   * needs it is one holding several parents and deciding which of them a component belongs to, and for that a
+   * grandchild is the wrong answer: removing it from the parent that merely contains its parent would fail.
+   *
+   * @param component - The component to look for.
+   * @returns Whether the component is a direct child of this one.
+   */
+  hasChild(component) {
+    return this.childrenSet.has(component);
+  }
+  /**
+   * Loads the component.
+   *
+   * @returns Despite the declared `void` return type, this method returns a {@link Promise} that resolves when the component is loaded or `null` if the component is fully synchronous.
+   */
+  load() {
+    if (this._loaded) {
+      return;
+    }
+    this._loaded = true;
+    this.hasBeenLoaded = true;
+    this.resetLoadState();
+    this.onload();
+    const onloadAsyncPromise = this.onloadAsync();
+    if (onloadAsyncPromise !== noopAsyncSingletonPromise) {
+      this.appendEagerLoadStep(onloadAsyncPromise);
+    }
+    for (const child of snapshot(this._children)) {
+      this.appendSequentialLoadStep(() => this.extractLoadPromisable(child));
+    }
+    if (this.loadPromise) {
+      return this.loadPromise;
+    }
+  }
+  /**
+   * Loads the component with promises.
+   *
+   * Unlike {@link load}, this method never rejects with an individual error: every failure raised by {@link onloadAsync}
+   * or a child's load is collected, and once everything settles the returned {@link Promise} rejects with a single
+   * {@link AggregateError} holding all of them. Non-`Error` throwables are normalized via {@link ErrorWrapper.create}.
+   *
+   * The `AggregateError` is built by {@link createAggregateError}, so its own `message` names the failure rather
+   * than being empty: a lone failure lends its message to every aggregate above it, which is what lets a caller
+   * assert on the sentence that was actually thrown without walking `errors` to find it.
+   *
+   * @returns A {@link Promise} that resolves when the component and its children finish loading, rejects with an {@link AggregateError} if any load step failed, or `null` if the component and its children don't use `async` logic and none failed synchronously.
+   */
+  loadWithPromises() {
+    this.load();
+    const loadPromise = this.loadPromise;
+    if (!loadPromise) {
+      return this.loadErrors.length > 0 ? Promise.reject(createAggregateError(this.loadErrors)) : null;
+    }
+    return loadPromise.then(() => {
+      if (this.loadErrors.length > 0) {
+        throw createAggregateError(this.loadErrors);
+      }
+    });
+  }
+  /**
+   * Asynchronously loads the component.
+   *
+   * Override to add async load logic, which is executed after {@link Component.onload}.
+   *
+   * @returns A {@link Promise} that resolves when the component is loaded.
+   */
+  onloadAsync() {
+    return noopAsyncSingletonPromise;
+  }
+  /**
+   * Registers a {@link Disposable} so it is disposed when this component unloads, and returns it unchanged.
+   *
+   * The recurring "tie a disposable to the component's lifecycle, then keep using it" idiom: the disposable is
+   * disposed on {@link Component.unload} (or earlier, if the caller disposes it directly — dispose is expected to
+   * be idempotent). Guard with {@link ensureLoaded} at the call site when registering before load would be unsafe.
+   *
+   * @typeParam TDisposable - The type of the disposable.
+   * @param disposable - The disposable to register.
+   * @returns The same disposable, for chaining.
+   */
+  registerDisposable(disposable) {
+    this.register(() => {
+      dispose(disposable);
+    });
+    return disposable;
+  }
+  /**
+   * Removes a child component.
+   *
+   * @typeParam TComponent - The type of component to remove.
+   * @param component - The component instance to remove.
+   * @returns The removed component.
+   */
+  removeChild(component) {
+    super.removeChild(component);
+    this.childrenSet.delete(component);
+    if (component instanceof ComponentEx && component.parentComponent === this) {
+      component.parentComponent = null;
+    }
+    return component;
+  }
+  /**
+   * Disposes of the component.
+   */
+  [Symbol.dispose]() {
+    this.unload();
+  }
+  /**
+   * Ensures the component is loaded, throwing if it is not.
+   *
+   * Use this to guard public methods that register teardown-bearing resources (via {@link Component.register},
+   * {@link Component.registerEvent}, {@link Component.registerDomEvent}, etc.). Registering before load is unsafe:
+   * {@link Component.unload} is a no-op while the component is not loaded, so any teardown registered beforehand would
+   * never run if the component is unloaded without first being loaded.
+   *
+   * The two not-loaded cases are deliberately distinguished. A component that was NEVER loaded is a genuine
+   * programming error, so it throws a loud {@link Error}. A component that has ALREADY been unloaded is not —
+   * it is the expected outcome of work that outlived its component (e.g. an `async` method suspended on an
+   * `await` while the component was unloaded, then resumed) — so it throws a {@link SilentError}, which
+   * `handleSilentError` suppresses, letting such work unwind quietly instead of reporting an async error.
+   *
+   * @throws An {@link Error} if the component was never loaded, or a {@link SilentError} if it has already been unloaded.
+   */
+  ensureLoaded() {
+    if (this._loaded) {
+      return;
+    }
+    if (this.isUnloaded()) {
+      throw new SilentError("Component is already unloaded");
+    }
+    throw new Error("Component is not loaded");
+  }
+  /**
+   * Returns a {@link Promise} that settles once neither this component nor any {@link ComponentEx} ancestor has a load
+   * in flight, or `null` when none of them has one right now.
+   *
+   * {@link getInFlightLoadPromise} covers this component's OWN load only. A sibling this component depends on — most
+   * often the owning plugin's settings component, which reads `data.json` asynchronously — is outside it, but it is
+   * inside the load of a shared ancestor. Waiting for every ancestor therefore waits for the whole tree the component
+   * was loaded as part of: under `PluginBase` the chain ends at the plugin's universal wrapper, whose load covers the
+   * dependency gate, the feature surface and `onloadImpl`.
+   *
+   * The chain is followed through {@link ComponentEx} parents only. A plain {@link Component} anywhere between this
+   * component and an ancestor ends it, because a plain component records no parent and exposes no load promise.
+   *
+   * Never await this from inside a load step of one of those ancestors: the ancestor's load would then be waiting for
+   * itself. It is meant for work scheduled OUTSIDE the load, such as a layout-ready handler.
+   *
+   * @returns The promise, or `null` if nothing in the ancestry is loading.
+   */
+  getInFlightAncestryLoadPromise() {
+    return this.findInFlightAncestryLoadPromise() ? this.waitForAncestryLoad() : null;
+  }
+  /**
+   * Returns the component's in-flight load {@link Promise} (its {@link onloadAsync} plus children), or `null` when
+   * nothing is loading — either the component loaded fully synchronously or its async load has already settled.
+   *
+   * Lets a caller scheduled while the component is still loading await the async load tail before acting, instead of
+   * racing it: {@link Component.onload} has run (so `_loaded` is set) but {@link onloadAsync} may not have finished.
+   *
+   * It covers this component's OWN load only. A caller that also depends on a sibling's state — a layout-ready handler
+   * reading settings is the common one — wants {@link getInFlightAncestryLoadPromise}, which `LayoutReadyComponent`
+   * uses.
+   *
+   * @returns The in-flight load promise, or `null` if no load is in flight.
+   */
+  getInFlightLoadPromise() {
+    return this.loadPromise;
+  }
+  /**
+   * Returns whether the most recent load recorded any failure.
+   *
+   * Reflects the outcome of the last {@link load} / {@link loadWithPromises}: `true` when {@link onloadAsync} or any
+   * child's load threw (synchronously or asynchronously). Unlike {@link loadWithPromises}, reading this does NOT
+   * re-raise the collected errors — it lets a bystander (e.g. a layout-ready handler awaiting the in-flight load) tell
+   * whether the load succeeded without adopting a failure that the load's owner is already responsible for.
+   *
+   * @returns `true` if the last load recorded at least one error, otherwise `false`.
+   */
+  hasLoadErrors() {
+    return this.loadErrors.length > 0;
+  }
+  /**
+   * Returns whether the component has already been unloaded, as opposed to simply not having been loaded yet.
+   *
+   * Both states leave `_loaded` false, but they mean opposite things: a component that was never loaded is still
+   * ahead of its lifecycle (queueing children before load is legitimate), while an unloaded one is behind it and
+   * must not be used any further. The distinction is tracked by a flag set in {@link load}, NOT by an
+   * {@link Component.onunload} override, because subclasses override `onunload` and may not call `super`.
+   *
+   * Use it in a long-running `async` method to abandon work whose component was unloaded mid-flight, when
+   * unwinding via the {@link SilentError} thrown by {@link ensureLoaded} / {@link addChild} is not desired.
+   *
+   * @returns `true` if the component was loaded at some point and is currently unloaded, otherwise `false`.
+   */
+  isUnloaded() {
+    return this.hasBeenLoaded && !this._loaded;
+  }
+  /**
+   * Sequences an already-started load step into the load promise.
+   *
+   * The step is presumed to have started synchronously (so any `_loaded` flag it sets is already visible); only the
+   * awaiting of its async tail is sequenced here.
+   *
+   * @param loadPromisable - The result of an already-started load step.
+   */
+  appendEagerLoadStep(loadPromisable) {
+    const captured = this.captureSettled(loadPromisable);
+    if (!captured) {
+      return;
+    }
+    const previous = this.loadPromise;
+    this.setLoadPromise(previous ? previous.then(() => captured) : captured);
+  }
+  /**
+   * Sequences a deferred load step into the load promise, running it only after previously-appended steps settle.
+   *
+   * @param loadPromisableFunction - A function that starts the load step and returns its result.
+   */
+  appendSequentialLoadStep(loadPromisableFunction) {
+    const previous = this.loadPromise;
+    if (previous) {
+      this.setLoadPromise(previous.then(() => this.runAndCapture(loadPromisableFunction)));
+      return;
+    }
+    const captured = this.captureSync(loadPromisableFunction);
+    if (captured) {
+      this.setLoadPromise(captured);
+    }
+  }
+  /**
+   * Records a load failure.
+   *
+   * A failure raised by a child {@link ComponentEx} is itself an {@link AggregateError}; it is recorded as-is so the
+   * grouping by child component is preserved (own failures stay flat, child-subtree failures stay nested).
+   *
+   * @param error - The thrown value to record.
+   */
+  captureError(error) {
+    this.loadErrors.push(ErrorWrapper.create(error));
+  }
+  /**
+   * Wraps an already-started load result so it never rejects: any failure is recorded into `loadErrors`.
+   *
+   * @param loadPromisable - The load result to observe.
+   * @returns A never-rejecting {@link Promise}, or `null` if the result is fully synchronous.
+   */
+  captureSettled(loadPromisable) {
+    return loadPromisable === null || loadPromisable === void 0 ? null : Promise.resolve(loadPromisable).then(noop).catch((error) => {
+      this.captureError(error);
+    });
+  }
+  /**
+   * Runs a load step synchronously, recording a synchronous throw, and wraps any async tail so it never rejects.
+   *
+   * @param loadPromisableFunction - A function that starts the load step and returns its result.
+   * @returns A never-rejecting {@link Promise}, or `null` if the step is fully synchronous.
+   */
+  captureSync(loadPromisableFunction) {
+    let loadPromisable;
+    try {
+      loadPromisable = loadPromisableFunction();
+    } catch (error) {
+      this.captureError(error);
+      return null;
+    }
+    return this.captureSettled(loadPromisable);
+  }
+  extractLoadPromisable(component) {
+    if (!this.childrenSet.has(component)) {
+      return null;
+    }
+    return component instanceof ComponentEx ? component.loadWithPromises() : component.load();
+  }
+  findInFlightAncestryLoadPromise() {
+    return this.loadPromise ?? this.parentComponent?.findInFlightAncestryLoadPromise() ?? null;
+  }
+  resetLoadState() {
+    this.loadErrors = [];
+    this.loadPromise = null;
+  }
+  /**
+   * Runs a deferred load step, recording a synchronous throw or an async rejection without ever re-throwing.
+   *
+   * @param loadPromisableFunction - A function that starts the load step and returns its result.
+   */
+  async runAndCapture(loadPromisableFunction) {
+    try {
+      await (loadPromisableFunction() ?? void 0);
+    } catch (error) {
+      this.captureError(error);
+    }
+  }
+  setLoadPromise(loadPromise) {
+    const loadPromiseWithReset = loadPromise.then(() => {
+      if (this.loadPromise === loadPromiseWithReset) {
+        this.loadPromise = null;
+      }
+    });
+    this.loadPromise = loadPromiseWithReset;
+  }
+  /**
+   * Awaits in-flight loads in the ancestry until none is left.
+   *
+   * Looped rather than awaited once, because an ancestor's load can grow while it is being awaited: a child added
+   * to an already-loaded component appends its async tail to that component's load promise.
+   */
+  async waitForAncestryLoad() {
+    let loadPromise = this.findInFlightAncestryLoadPromise();
+    while (loadPromise) {
+      await loadPromise;
+      loadPromise = this.findInFlightAncestryLoadPromise();
+    }
+  }
+}
+export {
+  ComponentEx
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvY29tcG9uZW50LWV4LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogRXh0ZW5kZWQgQ29tcG9uZW50XG4gKi9cblxuaW1wb3J0IHR5cGUgeyBQcm9taXNhYmxlIH0gZnJvbSAndHlwZS1mZXN0JztcblxuaW1wb3J0IHsgY3JlYXRlQWdncmVnYXRlRXJyb3IgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvYWdncmVnYXRlLWVycm9yJztcbmltcG9ydCB7IHNuYXBzaG90IH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL2FycmF5JztcbmltcG9ydCB7IGRpc3Bvc2UgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvZGlzcG9zYWJsZSc7XG5pbXBvcnQge1xuICBFcnJvcldyYXBwZXIsXG4gIFNpbGVudEVycm9yXG59IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9lcnJvcic7XG5pbXBvcnQge1xuICBub29wLFxuICBub29wQXN5bmNTaW5nbGV0b25Qcm9taXNlXG59IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9mdW5jdGlvbic7XG5pbXBvcnQgeyBDb21wb25lbnQgfSBmcm9tICdvYnNpZGlhbic7XG5cbi8qKlxuICogRXh0ZW5kZWQgQ29tcG9uZW50XG4gKi9cbi8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBvYnNpZGlhbi1kZXYtdXRpbHMvcmVxdWlyZS1jb21wb25lbnQtc3VmZml4IC0tIEV4dGVuZGVkIGJhc2UgY2xhc3MuXG5leHBvcnQgY2xhc3MgQ29tcG9uZW50RXggZXh0ZW5kcyBDb21wb25lbnQgaW1wbGVtZW50cyBEaXNwb3NhYmxlIHtcbiAgcHJpdmF0ZSByZWFkb25seSBjaGlsZHJlblNldCA9IG5ldyBTZXQ8Q29tcG9uZW50PigpO1xuICBwcml2YXRlIGhhc0JlZW5Mb2FkZWQgPSBmYWxzZTtcbiAgcHJpdmF0ZSBsb2FkRXJyb3JzOiBFcnJvcltdID0gW107XG4gIHByaXZhdGUgbG9hZFByb21pc2U6IG51bGwgfCBQcm9taXNlPHZvaWQ+ID0gbnVsbDtcbiAgcHJpdmF0ZSBwYXJlbnRDb21wb25lbnQ6IENvbXBvbmVudEV4IHwgbnVsbCA9IG51bGw7XG5cbiAgLyoqXG4gICAqIEFkZHMgYSBjaGlsZCBjb21wb25lbnQuXG4gICAqXG4gICAqIE1pcnJvcnMgdGhlIG5hdGl2ZSBgQ29tcG9uZW50LmFkZENoaWxkYCBjb250cmFjdDogaWYgdGhpcyBjb21wb25lbnQgaXMgYWxyZWFkeSBsb2FkZWQsIHRoZSBjaGlsZCBpcyBsb2FkZWRcbiAgICogaW1tZWRpYXRlbHksIHNvIGBjaGlsZC5fbG9hZGVkYCBpcyBzZXQgYmVmb3JlIHRoaXMgbWV0aG9kIHJldHVybnMgZXZlbiB3aGVuIHRoaXMgY29tcG9uZW50IGhhcyBhc3luYyBsb2FkIGxvZ2ljLlxuICAgKiBUaGUgY2hpbGQncyBhc3luYyB0YWlsIChpZiBhbnkpIGlzIHNlcXVlbmNlZCBpbnRvIHRoZSBsb2FkIHByb21pc2Ugc28gYSBsYXRlciB7QGxpbmsgbG9hZFdpdGhQcm9taXNlc30gY2FsbCBhd2FpdHMgaXQuXG4gICAqXG4gICAqIEFkZGluZyBhIGNoaWxkIEJFRk9SRSB0aGUgZmlyc3QgbG9hZCBpcyBsZWdpdGltYXRlOiB0aGUgY2hpbGQgaXMgcXVldWVkIGFuZCBsb2FkZWQgd2hlbiB0aGlzIGNvbXBvbmVudCBsb2Fkcy5cbiAgICogQWRkaW5nIG9uZSBBRlRFUiB0aGlzIGNvbXBvbmVudCBoYXMgYmVlbiB1bmxvYWRlZCBpcyBub3QgXHUyMDE0IHRoZSBjaGlsZCB3b3VsZCBuZXZlciBiZSBsb2FkZWQgYW5kIG5ldmVyIHVubG9hZGVkXG4gICAqIChhIGxlYWspLCBzbyBpdCBpcyByZWZ1c2VkIHdpdGggYSB7QGxpbmsgU2lsZW50RXJyb3J9LiBUaGUgdHlwaWNhbCBzb3VyY2Ugb2Ygc3VjaCBhIGNhbGwgaXMgYW4gYGFzeW5jYCBtZXRob2RcbiAgICogdGhhdCB3YXMgc3VzcGVuZGVkIG9uIGFuIGBhd2FpdGAgd2hlbiB0aGUgY29tcG9uZW50IGdvdCB1bmxvYWRlZCBhbmQgdGhlbiByZXN1bWVkIG9uIHRoZSBkZWFkIGNvbXBvbmVudDsgdGhlXG4gICAqIHtAbGluayBTaWxlbnRFcnJvcn0gdW53aW5kcyBpdCBxdWlldGx5IChzZWUge0BsaW5rIGlzVW5sb2FkZWR9KS5cbiAgICpcbiAgICogQHR5cGVQYXJhbSBUQ29tcG9uZW50IC0gVGhlIHR5cGUgb2YgY29tcG9uZW50IHRvIGFkZC5cbiAgICogQHBhcmFtIGNvbXBvbmVudCAtIFRoZSBjb21wb25lbnQgaW5zdGFuY2UgdG8gYWRkLlxuICAgKiBAcmV0dXJucyBUaGUgYWRkZWQgY29tcG9uZW50LlxuICAgKiBAdGhyb3dzIEEge0BsaW5rIFNpbGVudEVycm9yfSBpZiB0aGUgY29tcG9uZW50IGhhcyBhbHJlYWR5IGJlZW4gdW5sb2FkZWQuXG4gICAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgYWRkQ2hpbGQ8VENvbXBvbmVudCBleHRlbmRzIENvbXBvbmVudD4oY29tcG9uZW50OiBUQ29tcG9uZW50KTogVENvbXBvbmVudCB7XG4gICAgaWYgKHRoaXMuaXNVbmxvYWRlZCgpKSB7XG4gICAgICB0aHJvdyBuZXcgU2lsZW50RXJyb3IoJ0NvbXBvbmVudCBpcyBhbHJlYWR5IHVubG9hZGVkJyk7XG4gICAgfVxuXG4gICAgdGhpcy5fY2hpbGRyZW4ucHVzaChjb21wb25lbnQpO1xuICAgIHRoaXMuY2hpbGRyZW5TZXQuYWRkKGNvbXBvbmVudCk7XG4gICAgaWYgKGNvbXBvbmVudCBpbnN0YW5jZW9mIENvbXBvbmVudEV4KSB7XG4gICAgICBjb21wb25lbnQucGFyZW50Q29tcG9uZW50ID0gdGhpcztcbiAgICB9XG5cbiAgICBpZiAodGhpcy5fbG9hZGVkKSB7XG4gICAgICB0aGlzLmFwcGVuZEVhZ2VyTG9hZFN0ZXAodGhpcy5leHRyYWN0TG9hZFByb21pc2FibGUoY29tcG9uZW50KSk7XG4gICAgfVxuXG4gICAgcmV0dXJuIGNvbXBvbmVudDtcbiAgfVxuXG4gIC8qKlxuICAgKiBDaGVja3Mgd2hldGhlciBhIGNvbXBvbmVudCBpcyBhIGRpcmVjdCBjaGlsZCBvZiB0aGlzIG9uZS5cbiAgICpcbiAgICogT25seSBESVJFQ1QgY2hpbGRyZW4gYXJlIHJlcG9ydGVkIFx1MjAxNCB0aGlzIGlzIGFuIG93bmVyc2hpcCBxdWVzdGlvbiwgbm90IGEgY29udGFpbm1lbnQgb25lLiBUaGUgY2FsbGVyIHRoYXRcbiAgICogbmVlZHMgaXQgaXMgb25lIGhvbGRpbmcgc2V2ZXJhbCBwYXJlbnRzIGFuZCBkZWNpZGluZyB3aGljaCBvZiB0aGVtIGEgY29tcG9uZW50IGJlbG9uZ3MgdG8sIGFuZCBmb3IgdGhhdCBhXG4gICAqIGdyYW5kY2hpbGQgaXMgdGhlIHdyb25nIGFuc3dlcjogcmVtb3ZpbmcgaXQgZnJvbSB0aGUgcGFyZW50IHRoYXQgbWVyZWx5IGNvbnRhaW5zIGl0cyBwYXJlbnQgd291bGQgZmFpbC5cbiAgICpcbiAgICogQHBhcmFtIGNvbXBvbmVudCAtIFRoZSBjb21wb25lbnQgdG8gbG9vayBmb3IuXG4gICAqIEByZXR1cm5zIFdoZXRoZXIgdGhlIGNvbXBvbmVudCBpcyBhIGRpcmVjdCBjaGlsZCBvZiB0aGlzIG9uZS5cbiAgICovXG4gIHB1YmxpYyBoYXNDaGlsZChjb21wb25lbnQ6IENvbXBvbmVudCk6IGJvb2xlYW4ge1xuICAgIHJldHVybiB0aGlzLmNoaWxkcmVuU2V0Lmhhcyhjb21wb25lbnQpO1xuICB9XG5cbiAgLyoqXG4gICAqIExvYWRzIHRoZSBjb21wb25lbnQuXG4gICAqXG4gICAqIEByZXR1cm5zIERlc3BpdGUgdGhlIGRlY2xhcmVkIGB2b2lkYCByZXR1cm4gdHlwZSwgdGhpcyBtZXRob2QgcmV0dXJucyBhIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdoZW4gdGhlIGNvbXBvbmVudCBpcyBsb2FkZWQgb3IgYG51bGxgIGlmIHRoZSBjb21wb25lbnQgaXMgZnVsbHkgc3luY2hyb25vdXMuXG4gICAqL1xuICBwdWJsaWMgb3ZlcnJpZGUgbG9hZCgpOiB2b2lkIHtcbiAgICBpZiAodGhpcy5fbG9hZGVkKSB7XG4gICAgICByZXR1cm47XG4gICAgfVxuXG4gICAgdGhpcy5fbG9hZGVkID0gdHJ1ZTtcbiAgICB0aGlzLmhhc0JlZW5Mb2FkZWQgPSB0cnVlO1xuICAgIHRoaXMucmVzZXRMb2FkU3RhdGUoKTtcblxuICAgIHRoaXMub25sb2FkKCk7XG5cbiAgICBjb25zdCBvbmxvYWRBc3luY1Byb21pc2UgPSB0aGlzLm9ubG9hZEFzeW5jKCk7XG4gICAgaWYgKG9ubG9hZEFzeW5jUHJvbWlzZSAhPT0gbm9vcEFzeW5jU2luZ2xldG9uUHJvbWlzZSkge1xuICAgICAgdGhpcy5hcHBlbmRFYWdlckxvYWRTdGVwKG9ubG9hZEFzeW5jUHJvbWlzZSk7XG4gICAgfVxuXG4gICAgZm9yIChjb25zdCBjaGlsZCBvZiBzbmFwc2hvdCh0aGlzLl9jaGlsZHJlbikpIHtcbiAgICAgIHRoaXMuYXBwZW5kU2VxdWVudGlhbExvYWRTdGVwKCgpID0+IHRoaXMuZXh0cmFjdExvYWRQcm9taXNhYmxlKGNoaWxkKSk7XG4gICAgfVxuXG4gICAgaWYgKHRoaXMubG9hZFByb21pc2UpIHtcbiAgICAgIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBAdHlwZXNjcmlwdC1lc2xpbnQvbm8taW52YWxpZC12b2lkLXR5cGUsIG5vLXJlc3RyaWN0ZWQtc3ludGF4IC0tIFdlIG5lZWQgdG8gYnlwYXNzIHR5cGUgc3lzdGVtIHRvIHJldHVybiBgUHJvbWlzZTx2b2lkPmAuXG4gICAgICByZXR1cm4gdGhpcy5sb2FkUHJvbWlzZSBhcyB1bmtub3duIGFzIHZvaWQ7XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIExvYWRzIHRoZSBjb21wb25lbnQgd2l0aCBwcm9taXNlcy5cbiAgICpcbiAgICogVW5saWtlIHtAbGluayBsb2FkfSwgdGhpcyBtZXRob2QgbmV2ZXIgcmVqZWN0cyB3aXRoIGFuIGluZGl2aWR1YWwgZXJyb3I6IGV2ZXJ5IGZhaWx1cmUgcmFpc2VkIGJ5IHtAbGluayBvbmxvYWRBc3luY31cbiAgICogb3IgYSBjaGlsZCdzIGxvYWQgaXMgY29sbGVjdGVkLCBhbmQgb25jZSBldmVyeXRoaW5nIHNldHRsZXMgdGhlIHJldHVybmVkIHtAbGluayBQcm9taXNlfSByZWplY3RzIHdpdGggYSBzaW5nbGVcbiAgICoge0BsaW5rIEFnZ3JlZ2F0ZUVycm9yfSBob2xkaW5nIGFsbCBvZiB0aGVtLiBOb24tYEVycm9yYCB0aHJvd2FibGVzIGFyZSBub3JtYWxpemVkIHZpYSB7QGxpbmsgRXJyb3JXcmFwcGVyLmNyZWF0ZX0uXG4gICAqXG4gICAqIFRoZSBgQWdncmVnYXRlRXJyb3JgIGlzIGJ1aWx0IGJ5IHtAbGluayBjcmVhdGVBZ2dyZWdhdGVFcnJvcn0sIHNvIGl0cyBvd24gYG1lc3NhZ2VgIG5hbWVzIHRoZSBmYWlsdXJlIHJhdGhlclxuICAgKiB0aGFuIGJlaW5nIGVtcHR5OiBhIGxvbmUgZmFpbHVyZSBsZW5kcyBpdHMgbWVzc2FnZSB0byBldmVyeSBhZ2dyZWdhdGUgYWJvdmUgaXQsIHdoaWNoIGlzIHdoYXQgbGV0cyBhIGNhbGxlclxuICAgKiBhc3NlcnQgb24gdGhlIHNlbnRlbmNlIHRoYXQgd2FzIGFjdHVhbGx5IHRocm93biB3aXRob3V0IHdhbGtpbmcgYGVycm9yc2AgdG8gZmluZCBpdC5cbiAgICpcbiAgICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyB3aGVuIHRoZSBjb21wb25lbnQgYW5kIGl0cyBjaGlsZHJlbiBmaW5pc2ggbG9hZGluZywgcmVqZWN0cyB3aXRoIGFuIHtAbGluayBBZ2dyZWdhdGVFcnJvcn0gaWYgYW55IGxvYWQgc3RlcCBmYWlsZWQsIG9yIGBudWxsYCBpZiB0aGUgY29tcG9uZW50IGFuZCBpdHMgY2hpbGRyZW4gZG9uJ3QgdXNlIGBhc3luY2AgbG9naWMgYW5kIG5vbmUgZmFpbGVkIHN5bmNocm9ub3VzbHkuXG4gICAqL1xuICBwdWJsaWMgbG9hZFdpdGhQcm9taXNlcygpOiBudWxsIHwgUHJvbWlzZTx2b2lkPiB7XG4gICAgdGhpcy5sb2FkKCk7XG5cbiAgICBjb25zdCBsb2FkUHJvbWlzZSA9IHRoaXMubG9hZFByb21pc2U7XG4gICAgaWYgKCFsb2FkUHJvbWlzZSkge1xuICAgICAgcmV0dXJuIHRoaXMubG9hZEVycm9ycy5sZW5ndGggPiAwID8gUHJvbWlzZS5yZWplY3QoY3JlYXRlQWdncmVnYXRlRXJyb3IodGhpcy5sb2FkRXJyb3JzKSkgOiBudWxsO1xuICAgIH1cblxuICAgIHJldHVybiBsb2FkUHJvbWlzZS50aGVuKCgpID0+IHtcbiAgICAgIGlmICh0aGlzLmxvYWRFcnJvcnMubGVuZ3RoID4gMCkge1xuICAgICAgICB0aHJvdyBjcmVhdGVBZ2dyZWdhdGVFcnJvcih0aGlzLmxvYWRFcnJvcnMpO1xuICAgICAgfVxuICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIEFzeW5jaHJvbm91c2x5IGxvYWRzIHRoZSBjb21wb25lbnQuXG4gICAqXG4gICAqIE92ZXJyaWRlIHRvIGFkZCBhc3luYyBsb2FkIGxvZ2ljLCB3aGljaCBpcyBleGVjdXRlZCBhZnRlciB7QGxpbmsgQ29tcG9uZW50Lm9ubG9hZH0uXG4gICAqXG4gICAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgd2hlbiB0aGUgY29tcG9uZW50IGlzIGxvYWRlZC5cbiAgICovXG4gIHB1YmxpYyBvbmxvYWRBc3luYygpOiBQcm9taXNlPHZvaWQ+IHtcbiAgICByZXR1cm4gbm9vcEFzeW5jU2luZ2xldG9uUHJvbWlzZTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYSB7QGxpbmsgRGlzcG9zYWJsZX0gc28gaXQgaXMgZGlzcG9zZWQgd2hlbiB0aGlzIGNvbXBvbmVudCB1bmxvYWRzLCBhbmQgcmV0dXJucyBpdCB1bmNoYW5nZWQuXG4gICAqXG4gICAqIFRoZSByZWN1cnJpbmcgXCJ0aWUgYSBkaXNwb3NhYmxlIHRvIHRoZSBjb21wb25lbnQncyBsaWZlY3ljbGUsIHRoZW4ga2VlcCB1c2luZyBpdFwiIGlkaW9tOiB0aGUgZGlzcG9zYWJsZSBpc1xuICAgKiBkaXNwb3NlZCBvbiB7QGxpbmsgQ29tcG9uZW50LnVubG9hZH0gKG9yIGVhcmxpZXIsIGlmIHRoZSBjYWxsZXIgZGlzcG9zZXMgaXQgZGlyZWN0bHkgXHUyMDE0IGRpc3Bvc2UgaXMgZXhwZWN0ZWQgdG9cbiAgICogYmUgaWRlbXBvdGVudCkuIEd1YXJkIHdpdGgge0BsaW5rIGVuc3VyZUxvYWRlZH0gYXQgdGhlIGNhbGwgc2l0ZSB3aGVuIHJlZ2lzdGVyaW5nIGJlZm9yZSBsb2FkIHdvdWxkIGJlIHVuc2FmZS5cbiAgICpcbiAgICogQHR5cGVQYXJhbSBURGlzcG9zYWJsZSAtIFRoZSB0eXBlIG9mIHRoZSBkaXNwb3NhYmxlLlxuICAgKiBAcGFyYW0gZGlzcG9zYWJsZSAtIFRoZSBkaXNwb3NhYmxlIHRvIHJlZ2lzdGVyLlxuICAgKiBAcmV0dXJucyBUaGUgc2FtZSBkaXNwb3NhYmxlLCBmb3IgY2hhaW5pbmcuXG4gICAqL1xuICBwdWJsaWMgcmVnaXN0ZXJEaXNwb3NhYmxlPFREaXNwb3NhYmxlIGV4dGVuZHMgRGlzcG9zYWJsZT4oZGlzcG9zYWJsZTogVERpc3Bvc2FibGUpOiBURGlzcG9zYWJsZSB7XG4gICAgdGhpcy5yZWdpc3RlcigoKSA9PiB7XG4gICAgICBkaXNwb3NlKGRpc3Bvc2FibGUpO1xuICAgIH0pO1xuICAgIHJldHVybiBkaXNwb3NhYmxlO1xuICB9XG5cbiAgLyoqXG4gICAqIFJlbW92ZXMgYSBjaGlsZCBjb21wb25lbnQuXG4gICAqXG4gICAqIEB0eXBlUGFyYW0gVENvbXBvbmVudCAtIFRoZSB0eXBlIG9mIGNvbXBvbmVudCB0byByZW1vdmUuXG4gICAqIEBwYXJhbSBjb21wb25lbnQgLSBUaGUgY29tcG9uZW50IGluc3RhbmNlIHRvIHJlbW92ZS5cbiAgICogQHJldHVybnMgVGhlIHJlbW92ZWQgY29tcG9uZW50LlxuICAgKi9cbiAgcHVibGljIG92ZXJyaWRlIHJlbW92ZUNoaWxkPFRDb21wb25lbnQgZXh0ZW5kcyBDb21wb25lbnQ+KGNvbXBvbmVudDogVENvbXBvbmVudCk6IFRDb21wb25lbnQge1xuICAgIHN1cGVyLnJlbW92ZUNoaWxkKGNvbXBvbmVudCk7XG4gICAgdGhpcy5jaGlsZHJlblNldC5kZWxldGUoY29tcG9uZW50KTtcbiAgICBpZiAoY29tcG9uZW50IGluc3RhbmNlb2YgQ29tcG9uZW50RXggJiYgY29tcG9uZW50LnBhcmVudENvbXBvbmVudCA9PT0gdGhpcykge1xuICAgICAgY29tcG9uZW50LnBhcmVudENvbXBvbmVudCA9IG51bGw7XG4gICAgfVxuICAgIHJldHVybiBjb21wb25lbnQ7XG4gIH1cblxuICAvKipcbiAgICogRGlzcG9zZXMgb2YgdGhlIGNvbXBvbmVudC5cbiAgICovXG4gIHB1YmxpYyBbU3ltYm9sLmRpc3Bvc2VdKCk6IHZvaWQge1xuICAgIHRoaXMudW5sb2FkKCk7XG4gIH1cblxuICAvKipcbiAgICogRW5zdXJlcyB0aGUgY29tcG9uZW50IGlzIGxvYWRlZCwgdGhyb3dpbmcgaWYgaXQgaXMgbm90LlxuICAgKlxuICAgKiBVc2UgdGhpcyB0byBndWFyZCBwdWJsaWMgbWV0aG9kcyB0aGF0IHJlZ2lzdGVyIHRlYXJkb3duLWJlYXJpbmcgcmVzb3VyY2VzICh2aWEge0BsaW5rIENvbXBvbmVudC5yZWdpc3Rlcn0sXG4gICAqIHtAbGluayBDb21wb25lbnQucmVnaXN0ZXJFdmVudH0sIHtAbGluayBDb21wb25lbnQucmVnaXN0ZXJEb21FdmVudH0sIGV0Yy4pLiBSZWdpc3RlcmluZyBiZWZvcmUgbG9hZCBpcyB1bnNhZmU6XG4gICAqIHtAbGluayBDb21wb25lbnQudW5sb2FkfSBpcyBhIG5vLW9wIHdoaWxlIHRoZSBjb21wb25lbnQgaXMgbm90IGxvYWRlZCwgc28gYW55IHRlYXJkb3duIHJlZ2lzdGVyZWQgYmVmb3JlaGFuZCB3b3VsZFxuICAgKiBuZXZlciBydW4gaWYgdGhlIGNvbXBvbmVudCBpcyB1bmxvYWRlZCB3aXRob3V0IGZpcnN0IGJlaW5nIGxvYWRlZC5cbiAgICpcbiAgICogVGhlIHR3byBub3QtbG9hZGVkIGNhc2VzIGFyZSBkZWxpYmVyYXRlbHkgZGlzdGluZ3Vpc2hlZC4gQSBjb21wb25lbnQgdGhhdCB3YXMgTkVWRVIgbG9hZGVkIGlzIGEgZ2VudWluZVxuICAgKiBwcm9ncmFtbWluZyBlcnJvciwgc28gaXQgdGhyb3dzIGEgbG91ZCB7QGxpbmsgRXJyb3J9LiBBIGNvbXBvbmVudCB0aGF0IGhhcyBBTFJFQURZIGJlZW4gdW5sb2FkZWQgaXMgbm90IFx1MjAxNFxuICAgKiBpdCBpcyB0aGUgZXhwZWN0ZWQgb3V0Y29tZSBvZiB3b3JrIHRoYXQgb3V0bGl2ZWQgaXRzIGNvbXBvbmVudCAoZS5nLiBhbiBgYXN5bmNgIG1ldGhvZCBzdXNwZW5kZWQgb24gYW5cbiAgICogYGF3YWl0YCB3aGlsZSB0aGUgY29tcG9uZW50IHdhcyB1bmxvYWRlZCwgdGhlbiByZXN1bWVkKSBcdTIwMTQgc28gaXQgdGhyb3dzIGEge0BsaW5rIFNpbGVudEVycm9yfSwgd2hpY2hcbiAgICogYGhhbmRsZVNpbGVudEVycm9yYCBzdXBwcmVzc2VzLCBsZXR0aW5nIHN1Y2ggd29yayB1bndpbmQgcXVpZXRseSBpbnN0ZWFkIG9mIHJlcG9ydGluZyBhbiBhc3luYyBlcnJvci5cbiAgICpcbiAgICogQHRocm93cyBBbiB7QGxpbmsgRXJyb3J9IGlmIHRoZSBjb21wb25lbnQgd2FzIG5ldmVyIGxvYWRlZCwgb3IgYSB7QGxpbmsgU2lsZW50RXJyb3J9IGlmIGl0IGhhcyBhbHJlYWR5IGJlZW4gdW5sb2FkZWQuXG4gICAqL1xuICBwcm90ZWN0ZWQgZW5zdXJlTG9hZGVkKCk6IHZvaWQge1xuICAgIGlmICh0aGlzLl9sb2FkZWQpIHtcbiAgICAgIHJldHVybjtcbiAgICB9XG5cbiAgICBpZiAodGhpcy5pc1VubG9hZGVkKCkpIHtcbiAgICAgIHRocm93IG5ldyBTaWxlbnRFcnJvcignQ29tcG9uZW50IGlzIGFscmVhZHkgdW5sb2FkZWQnKTtcbiAgICB9XG5cbiAgICB0aHJvdyBuZXcgRXJyb3IoJ0NvbXBvbmVudCBpcyBub3QgbG9hZGVkJyk7XG4gIH1cblxuICAvKipcbiAgICogUmV0dXJucyBhIHtAbGluayBQcm9taXNlfSB0aGF0IHNldHRsZXMgb25jZSBuZWl0aGVyIHRoaXMgY29tcG9uZW50IG5vciBhbnkge0BsaW5rIENvbXBvbmVudEV4fSBhbmNlc3RvciBoYXMgYSBsb2FkXG4gICAqIGluIGZsaWdodCwgb3IgYG51bGxgIHdoZW4gbm9uZSBvZiB0aGVtIGhhcyBvbmUgcmlnaHQgbm93LlxuICAgKlxuICAgKiB7QGxpbmsgZ2V0SW5GbGlnaHRMb2FkUHJvbWlzZX0gY292ZXJzIHRoaXMgY29tcG9uZW50J3MgT1dOIGxvYWQgb25seS4gQSBzaWJsaW5nIHRoaXMgY29tcG9uZW50IGRlcGVuZHMgb24gXHUyMDE0IG1vc3RcbiAgICogb2Z0ZW4gdGhlIG93bmluZyBwbHVnaW4ncyBzZXR0aW5ncyBjb21wb25lbnQsIHdoaWNoIHJlYWRzIGBkYXRhLmpzb25gIGFzeW5jaHJvbm91c2x5IFx1MjAxNCBpcyBvdXRzaWRlIGl0LCBidXQgaXQgaXNcbiAgICogaW5zaWRlIHRoZSBsb2FkIG9mIGEgc2hhcmVkIGFuY2VzdG9yLiBXYWl0aW5nIGZvciBldmVyeSBhbmNlc3RvciB0aGVyZWZvcmUgd2FpdHMgZm9yIHRoZSB3aG9sZSB0cmVlIHRoZSBjb21wb25lbnRcbiAgICogd2FzIGxvYWRlZCBhcyBwYXJ0IG9mOiB1bmRlciBgUGx1Z2luQmFzZWAgdGhlIGNoYWluIGVuZHMgYXQgdGhlIHBsdWdpbidzIHVuaXZlcnNhbCB3cmFwcGVyLCB3aG9zZSBsb2FkIGNvdmVycyB0aGVcbiAgICogZGVwZW5kZW5jeSBnYXRlLCB0aGUgZmVhdHVyZSBzdXJmYWNlIGFuZCBgb25sb2FkSW1wbGAuXG4gICAqXG4gICAqIFRoZSBjaGFpbiBpcyBmb2xsb3dlZCB0aHJvdWdoIHtAbGluayBDb21wb25lbnRFeH0gcGFyZW50cyBvbmx5LiBBIHBsYWluIHtAbGluayBDb21wb25lbnR9IGFueXdoZXJlIGJldHdlZW4gdGhpc1xuICAgKiBjb21wb25lbnQgYW5kIGFuIGFuY2VzdG9yIGVuZHMgaXQsIGJlY2F1c2UgYSBwbGFpbiBjb21wb25lbnQgcmVjb3JkcyBubyBwYXJlbnQgYW5kIGV4cG9zZXMgbm8gbG9hZCBwcm9taXNlLlxuICAgKlxuICAgKiBOZXZlciBhd2FpdCB0aGlzIGZyb20gaW5zaWRlIGEgbG9hZCBzdGVwIG9mIG9uZSBvZiB0aG9zZSBhbmNlc3RvcnM6IHRoZSBhbmNlc3RvcidzIGxvYWQgd291bGQgdGhlbiBiZSB3YWl0aW5nIGZvclxuICAgKiBpdHNlbGYuIEl0IGlzIG1lYW50IGZvciB3b3JrIHNjaGVkdWxlZCBPVVRTSURFIHRoZSBsb2FkLCBzdWNoIGFzIGEgbGF5b3V0LXJlYWR5IGhhbmRsZXIuXG4gICAqXG4gICAqIEByZXR1cm5zIFRoZSBwcm9taXNlLCBvciBgbnVsbGAgaWYgbm90aGluZyBpbiB0aGUgYW5jZXN0cnkgaXMgbG9hZGluZy5cbiAgICovXG4gIHByb3RlY3RlZCBnZXRJbkZsaWdodEFuY2VzdHJ5TG9hZFByb21pc2UoKTogbnVsbCB8IFByb21pc2U8dm9pZD4ge1xuICAgIHJldHVybiB0aGlzLmZpbmRJbkZsaWdodEFuY2VzdHJ5TG9hZFByb21pc2UoKSA/IHRoaXMud2FpdEZvckFuY2VzdHJ5TG9hZCgpIDogbnVsbDtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZXR1cm5zIHRoZSBjb21wb25lbnQncyBpbi1mbGlnaHQgbG9hZCB7QGxpbmsgUHJvbWlzZX0gKGl0cyB7QGxpbmsgb25sb2FkQXN5bmN9IHBsdXMgY2hpbGRyZW4pLCBvciBgbnVsbGAgd2hlblxuICAgKiBub3RoaW5nIGlzIGxvYWRpbmcgXHUyMDE0IGVpdGhlciB0aGUgY29tcG9uZW50IGxvYWRlZCBmdWxseSBzeW5jaHJvbm91c2x5IG9yIGl0cyBhc3luYyBsb2FkIGhhcyBhbHJlYWR5IHNldHRsZWQuXG4gICAqXG4gICAqIExldHMgYSBjYWxsZXIgc2NoZWR1bGVkIHdoaWxlIHRoZSBjb21wb25lbnQgaXMgc3RpbGwgbG9hZGluZyBhd2FpdCB0aGUgYXN5bmMgbG9hZCB0YWlsIGJlZm9yZSBhY3RpbmcsIGluc3RlYWQgb2ZcbiAgICogcmFjaW5nIGl0OiB7QGxpbmsgQ29tcG9uZW50Lm9ubG9hZH0gaGFzIHJ1biAoc28gYF9sb2FkZWRgIGlzIHNldCkgYnV0IHtAbGluayBvbmxvYWRBc3luY30gbWF5IG5vdCBoYXZlIGZpbmlzaGVkLlxuICAgKlxuICAgKiBJdCBjb3ZlcnMgdGhpcyBjb21wb25lbnQncyBPV04gbG9hZCBvbmx5LiBBIGNhbGxlciB0aGF0IGFsc28gZGVwZW5kcyBvbiBhIHNpYmxpbmcncyBzdGF0ZSBcdTIwMTQgYSBsYXlvdXQtcmVhZHkgaGFuZGxlclxuICAgKiByZWFkaW5nIHNldHRpbmdzIGlzIHRoZSBjb21tb24gb25lIFx1MjAxNCB3YW50cyB7QGxpbmsgZ2V0SW5GbGlnaHRBbmNlc3RyeUxvYWRQcm9taXNlfSwgd2hpY2ggYExheW91dFJlYWR5Q29tcG9uZW50YFxuICAgKiB1c2VzLlxuICAgKlxuICAgKiBAcmV0dXJucyBUaGUgaW4tZmxpZ2h0IGxvYWQgcHJvbWlzZSwgb3IgYG51bGxgIGlmIG5vIGxvYWQgaXMgaW4gZmxpZ2h0LlxuICAgKi9cbiAgcHJvdGVjdGVkIGdldEluRmxpZ2h0TG9hZFByb21pc2UoKTogbnVsbCB8IFByb21pc2U8dm9pZD4ge1xuICAgIHJldHVybiB0aGlzLmxvYWRQcm9taXNlO1xuICB9XG5cbiAgLyoqXG4gICAqIFJldHVybnMgd2hldGhlciB0aGUgbW9zdCByZWNlbnQgbG9hZCByZWNvcmRlZCBhbnkgZmFpbHVyZS5cbiAgICpcbiAgICogUmVmbGVjdHMgdGhlIG91dGNvbWUgb2YgdGhlIGxhc3Qge0BsaW5rIGxvYWR9IC8ge0BsaW5rIGxvYWRXaXRoUHJvbWlzZXN9OiBgdHJ1ZWAgd2hlbiB7QGxpbmsgb25sb2FkQXN5bmN9IG9yIGFueVxuICAgKiBjaGlsZCdzIGxvYWQgdGhyZXcgKHN5bmNocm9ub3VzbHkgb3IgYXN5bmNocm9ub3VzbHkpLiBVbmxpa2Uge0BsaW5rIGxvYWRXaXRoUHJvbWlzZXN9LCByZWFkaW5nIHRoaXMgZG9lcyBOT1RcbiAgICogcmUtcmFpc2UgdGhlIGNvbGxlY3RlZCBlcnJvcnMgXHUyMDE0IGl0IGxldHMgYSBieXN0YW5kZXIgKGUuZy4gYSBsYXlvdXQtcmVhZHkgaGFuZGxlciBhd2FpdGluZyB0aGUgaW4tZmxpZ2h0IGxvYWQpIHRlbGxcbiAgICogd2hldGhlciB0aGUgbG9hZCBzdWNjZWVkZWQgd2l0aG91dCBhZG9wdGluZyBhIGZhaWx1cmUgdGhhdCB0aGUgbG9hZCdzIG93bmVyIGlzIGFscmVhZHkgcmVzcG9uc2libGUgZm9yLlxuICAgKlxuICAgKiBAcmV0dXJucyBgdHJ1ZWAgaWYgdGhlIGxhc3QgbG9hZCByZWNvcmRlZCBhdCBsZWFzdCBvbmUgZXJyb3IsIG90aGVyd2lzZSBgZmFsc2VgLlxuICAgKi9cbiAgcHJvdGVjdGVkIGhhc0xvYWRFcnJvcnMoKTogYm9vbGVhbiB7XG4gICAgcmV0dXJuIHRoaXMubG9hZEVycm9ycy5sZW5ndGggPiAwO1xuICB9XG5cbiAgLyoqXG4gICAqIFJldHVybnMgd2hldGhlciB0aGUgY29tcG9uZW50IGhhcyBhbHJlYWR5IGJlZW4gdW5sb2FkZWQsIGFzIG9wcG9zZWQgdG8gc2ltcGx5IG5vdCBoYXZpbmcgYmVlbiBsb2FkZWQgeWV0LlxuICAgKlxuICAgKiBCb3RoIHN0YXRlcyBsZWF2ZSBgX2xvYWRlZGAgZmFsc2UsIGJ1dCB0aGV5IG1lYW4gb3Bwb3NpdGUgdGhpbmdzOiBhIGNvbXBvbmVudCB0aGF0IHdhcyBuZXZlciBsb2FkZWQgaXMgc3RpbGxcbiAgICogYWhlYWQgb2YgaXRzIGxpZmVjeWNsZSAocXVldWVpbmcgY2hpbGRyZW4gYmVmb3JlIGxvYWQgaXMgbGVnaXRpbWF0ZSksIHdoaWxlIGFuIHVubG9hZGVkIG9uZSBpcyBiZWhpbmQgaXQgYW5kXG4gICAqIG11c3Qgbm90IGJlIHVzZWQgYW55IGZ1cnRoZXIuIFRoZSBkaXN0aW5jdGlvbiBpcyB0cmFja2VkIGJ5IGEgZmxhZyBzZXQgaW4ge0BsaW5rIGxvYWR9LCBOT1QgYnkgYW5cbiAgICoge0BsaW5rIENvbXBvbmVudC5vbnVubG9hZH0gb3ZlcnJpZGUsIGJlY2F1c2Ugc3ViY2xhc3NlcyBvdmVycmlkZSBgb251bmxvYWRgIGFuZCBtYXkgbm90IGNhbGwgYHN1cGVyYC5cbiAgICpcbiAgICogVXNlIGl0IGluIGEgbG9uZy1ydW5uaW5nIGBhc3luY2AgbWV0aG9kIHRvIGFiYW5kb24gd29yayB3aG9zZSBjb21wb25lbnQgd2FzIHVubG9hZGVkIG1pZC1mbGlnaHQsIHdoZW5cbiAgICogdW53aW5kaW5nIHZpYSB0aGUge0BsaW5rIFNpbGVudEVycm9yfSB0aHJvd24gYnkge0BsaW5rIGVuc3VyZUxvYWRlZH0gLyB7QGxpbmsgYWRkQ2hpbGR9IGlzIG5vdCBkZXNpcmVkLlxuICAgKlxuICAgKiBAcmV0dXJucyBgdHJ1ZWAgaWYgdGhlIGNvbXBvbmVudCB3YXMgbG9hZGVkIGF0IHNvbWUgcG9pbnQgYW5kIGlzIGN1cnJlbnRseSB1bmxvYWRlZCwgb3RoZXJ3aXNlIGBmYWxzZWAuXG4gICAqL1xuICBwcm90ZWN0ZWQgaXNVbmxvYWRlZCgpOiBib29sZWFuIHtcbiAgICByZXR1cm4gdGhpcy5oYXNCZWVuTG9hZGVkICYmICF0aGlzLl9sb2FkZWQ7XG4gIH1cblxuICAvKipcbiAgICogU2VxdWVuY2VzIGFuIGFscmVhZHktc3RhcnRlZCBsb2FkIHN0ZXAgaW50byB0aGUgbG9hZCBwcm9taXNlLlxuICAgKlxuICAgKiBUaGUgc3RlcCBpcyBwcmVzdW1lZCB0byBoYXZlIHN0YXJ0ZWQgc3luY2hyb25vdXNseSAoc28gYW55IGBfbG9hZGVkYCBmbGFnIGl0IHNldHMgaXMgYWxyZWFkeSB2aXNpYmxlKTsgb25seSB0aGVcbiAgICogYXdhaXRpbmcgb2YgaXRzIGFzeW5jIHRhaWwgaXMgc2VxdWVuY2VkIGhlcmUuXG4gICAqXG4gICAqIEBwYXJhbSBsb2FkUHJvbWlzYWJsZSAtIFRoZSByZXN1bHQgb2YgYW4gYWxyZWFkeS1zdGFydGVkIGxvYWQgc3RlcC5cbiAgICovXG4gIHByaXZhdGUgYXBwZW5kRWFnZXJMb2FkU3RlcChsb2FkUHJvbWlzYWJsZTogbnVsbCB8IFByb21pc2FibGU8dm9pZD4pOiB2b2lkIHtcbiAgICBjb25zdCBjYXB0dXJlZCA9IHRoaXMuY2FwdHVyZVNldHRsZWQobG9hZFByb21pc2FibGUpO1xuICAgIGlmICghY2FwdHVyZWQpIHtcbiAgICAgIHJldHVybjtcbiAgICB9XG5cbiAgICBjb25zdCBwcmV2aW91cyA9IHRoaXMubG9hZFByb21pc2U7XG4gICAgdGhpcy5zZXRMb2FkUHJvbWlzZShwcmV2aW91cyA/IHByZXZpb3VzLnRoZW4oKCkgPT4gY2FwdHVyZWQpIDogY2FwdHVyZWQpO1xuICB9XG5cbiAgLyoqXG4gICAqIFNlcXVlbmNlcyBhIGRlZmVycmVkIGxvYWQgc3RlcCBpbnRvIHRoZSBsb2FkIHByb21pc2UsIHJ1bm5pbmcgaXQgb25seSBhZnRlciBwcmV2aW91c2x5LWFwcGVuZGVkIHN0ZXBzIHNldHRsZS5cbiAgICpcbiAgICogQHBhcmFtIGxvYWRQcm9taXNhYmxlRnVuY3Rpb24gLSBBIGZ1bmN0aW9uIHRoYXQgc3RhcnRzIHRoZSBsb2FkIHN0ZXAgYW5kIHJldHVybnMgaXRzIHJlc3VsdC5cbiAgICovXG4gIHByaXZhdGUgYXBwZW5kU2VxdWVudGlhbExvYWRTdGVwKGxvYWRQcm9taXNhYmxlRnVuY3Rpb246ICgpID0+IG51bGwgfCBQcm9taXNhYmxlPHZvaWQ+KTogdm9pZCB7XG4gICAgY29uc3QgcHJldmlvdXMgPSB0aGlzLmxvYWRQcm9taXNlO1xuICAgIGlmIChwcmV2aW91cykge1xuICAgICAgdGhpcy5zZXRMb2FkUHJvbWlzZShwcmV2aW91cy50aGVuKCgpID0+IHRoaXMucnVuQW5kQ2FwdHVyZShsb2FkUHJvbWlzYWJsZUZ1bmN0aW9uKSkpO1xuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIGNvbnN0IGNhcHR1cmVkID0gdGhpcy5jYXB0dXJlU3luYyhsb2FkUHJvbWlzYWJsZUZ1bmN0aW9uKTtcbiAgICBpZiAoY2FwdHVyZWQpIHtcbiAgICAgIHRoaXMuc2V0TG9hZFByb21pc2UoY2FwdHVyZWQpO1xuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBSZWNvcmRzIGEgbG9hZCBmYWlsdXJlLlxuICAgKlxuICAgKiBBIGZhaWx1cmUgcmFpc2VkIGJ5IGEgY2hpbGQge0BsaW5rIENvbXBvbmVudEV4fSBpcyBpdHNlbGYgYW4ge0BsaW5rIEFnZ3JlZ2F0ZUVycm9yfTsgaXQgaXMgcmVjb3JkZWQgYXMtaXMgc28gdGhlXG4gICAqIGdyb3VwaW5nIGJ5IGNoaWxkIGNvbXBvbmVudCBpcyBwcmVzZXJ2ZWQgKG93biBmYWlsdXJlcyBzdGF5IGZsYXQsIGNoaWxkLXN1YnRyZWUgZmFpbHVyZXMgc3RheSBuZXN0ZWQpLlxuICAgKlxuICAgKiBAcGFyYW0gZXJyb3IgLSBUaGUgdGhyb3duIHZhbHVlIHRvIHJlY29yZC5cbiAgICovXG4gIHByaXZhdGUgY2FwdHVyZUVycm9yKGVycm9yOiB1bmtub3duKTogdm9pZCB7XG4gICAgdGhpcy5sb2FkRXJyb3JzLnB1c2goRXJyb3JXcmFwcGVyLmNyZWF0ZShlcnJvcikpO1xuICB9XG5cbiAgLyoqXG4gICAqIFdyYXBzIGFuIGFscmVhZHktc3RhcnRlZCBsb2FkIHJlc3VsdCBzbyBpdCBuZXZlciByZWplY3RzOiBhbnkgZmFpbHVyZSBpcyByZWNvcmRlZCBpbnRvIGBsb2FkRXJyb3JzYC5cbiAgICpcbiAgICogQHBhcmFtIGxvYWRQcm9taXNhYmxlIC0gVGhlIGxvYWQgcmVzdWx0IHRvIG9ic2VydmUuXG4gICAqIEByZXR1cm5zIEEgbmV2ZXItcmVqZWN0aW5nIHtAbGluayBQcm9taXNlfSwgb3IgYG51bGxgIGlmIHRoZSByZXN1bHQgaXMgZnVsbHkgc3luY2hyb25vdXMuXG4gICAqL1xuICBwcml2YXRlIGNhcHR1cmVTZXR0bGVkKGxvYWRQcm9taXNhYmxlOiBudWxsIHwgUHJvbWlzYWJsZTx2b2lkPik6IG51bGwgfCBQcm9taXNlPHZvaWQ+IHtcbiAgICByZXR1cm4gbG9hZFByb21pc2FibGUgPT09IG51bGwgfHwgbG9hZFByb21pc2FibGUgPT09IHVuZGVmaW5lZFxuICAgICAgPyBudWxsXG4gICAgICA6IFByb21pc2UucmVzb2x2ZShsb2FkUHJvbWlzYWJsZSkudGhlbihub29wKS5jYXRjaCgoZXJyb3I6IHVua25vd24pID0+IHtcbiAgICAgICAgdGhpcy5jYXB0dXJlRXJyb3IoZXJyb3IpO1xuICAgICAgfSk7XG4gIH1cblxuICAvKipcbiAgICogUnVucyBhIGxvYWQgc3RlcCBzeW5jaHJvbm91c2x5LCByZWNvcmRpbmcgYSBzeW5jaHJvbm91cyB0aHJvdywgYW5kIHdyYXBzIGFueSBhc3luYyB0YWlsIHNvIGl0IG5ldmVyIHJlamVjdHMuXG4gICAqXG4gICAqIEBwYXJhbSBsb2FkUHJvbWlzYWJsZUZ1bmN0aW9uIC0gQSBmdW5jdGlvbiB0aGF0IHN0YXJ0cyB0aGUgbG9hZCBzdGVwIGFuZCByZXR1cm5zIGl0cyByZXN1bHQuXG4gICAqIEByZXR1cm5zIEEgbmV2ZXItcmVqZWN0aW5nIHtAbGluayBQcm9taXNlfSwgb3IgYG51bGxgIGlmIHRoZSBzdGVwIGlzIGZ1bGx5IHN5bmNocm9ub3VzLlxuICAgKi9cbiAgcHJpdmF0ZSBjYXB0dXJlU3luYyhsb2FkUHJvbWlzYWJsZUZ1bmN0aW9uOiAoKSA9PiBudWxsIHwgUHJvbWlzYWJsZTx2b2lkPik6IG51bGwgfCBQcm9taXNlPHZvaWQ+IHtcbiAgICBsZXQgbG9hZFByb21pc2FibGU6IG51bGwgfCBQcm9taXNhYmxlPHZvaWQ+O1xuICAgIHRyeSB7XG4gICAgICBsb2FkUHJvbWlzYWJsZSA9IGxvYWRQcm9taXNhYmxlRnVuY3Rpb24oKTtcbiAgICB9IGNhdGNoIChlcnJvcikge1xuICAgICAgdGhpcy5jYXB0dXJlRXJyb3IoZXJyb3IpO1xuICAgICAgcmV0dXJuIG51bGw7XG4gICAgfVxuXG4gICAgcmV0dXJuIHRoaXMuY2FwdHVyZVNldHRsZWQobG9hZFByb21pc2FibGUpO1xuICB9XG5cbiAgcHJpdmF0ZSBleHRyYWN0TG9hZFByb21pc2FibGUoY29tcG9uZW50OiBDb21wb25lbnQpOiBudWxsIHwgUHJvbWlzYWJsZTx2b2lkPiB7XG4gICAgaWYgKCF0aGlzLmNoaWxkcmVuU2V0Lmhhcyhjb21wb25lbnQpKSB7XG4gICAgICByZXR1cm4gbnVsbDtcbiAgICB9XG4gICAgLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby1jb25mdXNpbmctdm9pZC1leHByZXNzaW9uLCBAdHlwZXNjcmlwdC1lc2xpbnQvbm8tdW5uZWNlc3NhcnktdHlwZS1hc3NlcnRpb24gLS0gSXQgY2FuIGJlIGBQcm9taXNlPHZvaWQ+YCBpbiBydW50aW1lLiBXYW50IGV4cGxpY2l0bHkgY2FzdCB0byBzaG93IHdlIGtub3cgaXQgbWF5IGJlIHByb21pc2UsIGRlc3BpdGUgdGhlIGRlY2xhcmVkIHR5cGUgYHZvaWRgLlxuICAgIHJldHVybiBjb21wb25lbnQgaW5zdGFuY2VvZiBDb21wb25lbnRFeCA/IGNvbXBvbmVudC5sb2FkV2l0aFByb21pc2VzKCkgOiBjb21wb25lbnQubG9hZCgpIGFzIFByb21pc2FibGU8dm9pZD47XG4gIH1cblxuICBwcml2YXRlIGZpbmRJbkZsaWdodEFuY2VzdHJ5TG9hZFByb21pc2UoKTogbnVsbCB8IFByb21pc2U8dm9pZD4ge1xuICAgIHJldHVybiB0aGlzLmxvYWRQcm9taXNlID8/IHRoaXMucGFyZW50Q29tcG9uZW50Py5maW5kSW5GbGlnaHRBbmNlc3RyeUxvYWRQcm9taXNlKCkgPz8gbnVsbDtcbiAgfVxuXG4gIHByaXZhdGUgcmVzZXRMb2FkU3RhdGUoKTogdm9pZCB7XG4gICAgdGhpcy5sb2FkRXJyb3JzID0gW107XG4gICAgdGhpcy5sb2FkUHJvbWlzZSA9IG51bGw7XG4gIH1cblxuICAvKipcbiAgICogUnVucyBhIGRlZmVycmVkIGxvYWQgc3RlcCwgcmVjb3JkaW5nIGEgc3luY2hyb25vdXMgdGhyb3cgb3IgYW4gYXN5bmMgcmVqZWN0aW9uIHdpdGhvdXQgZXZlciByZS10aHJvd2luZy5cbiAgICpcbiAgICogQHBhcmFtIGxvYWRQcm9taXNhYmxlRnVuY3Rpb24gLSBBIGZ1bmN0aW9uIHRoYXQgc3RhcnRzIHRoZSBsb2FkIHN0ZXAgYW5kIHJldHVybnMgaXRzIHJlc3VsdC5cbiAgICovXG4gIHByaXZhdGUgYXN5bmMgcnVuQW5kQ2FwdHVyZShsb2FkUHJvbWlzYWJsZUZ1bmN0aW9uOiAoKSA9PiBudWxsIHwgUHJvbWlzYWJsZTx2b2lkPik6IFByb21pc2U8dm9pZD4ge1xuICAgIHRyeSB7XG4gICAgICBhd2FpdCAobG9hZFByb21pc2FibGVGdW5jdGlvbigpID8/IHVuZGVmaW5lZCk7XG4gICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgIHRoaXMuY2FwdHVyZUVycm9yKGVycm9yKTtcbiAgICB9XG4gIH1cblxuICBwcml2YXRlIHNldExvYWRQcm9taXNlKGxvYWRQcm9taXNlOiBQcm9taXNlPHZvaWQ+KTogdm9pZCB7XG4gICAgY29uc3QgbG9hZFByb21pc2VXaXRoUmVzZXQ6IFByb21pc2U8dm9pZD4gPSBsb2FkUHJvbWlzZS50aGVuKCgpID0+IHtcbiAgICAgIGlmICh0aGlzLmxvYWRQcm9taXNlID09PSBsb2FkUHJvbWlzZVdpdGhSZXNldCkge1xuICAgICAgICB0aGlzLmxvYWRQcm9taXNlID0gbnVsbDtcbiAgICAgIH1cbiAgICB9KTtcbiAgICB0aGlzLmxvYWRQcm9taXNlID0gbG9hZFByb21pc2VXaXRoUmVzZXQ7XG4gIH1cblxuICAvKipcbiAgICogQXdhaXRzIGluLWZsaWdodCBsb2FkcyBpbiB0aGUgYW5jZXN0cnkgdW50aWwgbm9uZSBpcyBsZWZ0LlxuICAgKlxuICAgKiBMb29wZWQgcmF0aGVyIHRoYW4gYXdhaXRlZCBvbmNlLCBiZWNhdXNlIGFuIGFuY2VzdG9yJ3MgbG9hZCBjYW4gZ3JvdyB3aGlsZSBpdCBpcyBiZWluZyBhd2FpdGVkOiBhIGNoaWxkIGFkZGVkXG4gICAqIHRvIGFuIGFscmVhZHktbG9hZGVkIGNvbXBvbmVudCBhcHBlbmRzIGl0cyBhc3luYyB0YWlsIHRvIHRoYXQgY29tcG9uZW50J3MgbG9hZCBwcm9taXNlLlxuICAgKi9cbiAgcHJpdmF0ZSBhc3luYyB3YWl0Rm9yQW5jZXN0cnlMb2FkKCk6IFByb21pc2U8dm9pZD4ge1xuICAgIGxldCBsb2FkUHJvbWlzZSA9IHRoaXMuZmluZEluRmxpZ2h0QW5jZXN0cnlMb2FkUHJvbWlzZSgpO1xuICAgIHdoaWxlIChsb2FkUHJvbWlzZSkge1xuICAgICAgYXdhaXQgbG9hZFByb21pc2U7XG4gICAgICBsb2FkUHJvbWlzZSA9IHRoaXMuZmluZEluRmxpZ2h0QW5jZXN0cnlMb2FkUHJvbWlzZSgpO1xuICAgIH1cbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFRQSxTQUFTLDRCQUE0QjtBQUNyQyxTQUFTLGdCQUFnQjtBQUN6QixTQUFTLGVBQWU7QUFDeEI7QUFBQSxFQUNFO0FBQUEsRUFDQTtBQUFBLE9BQ0s7QUFDUDtBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsT0FDSztBQUNQLFNBQVMsaUJBQWlCO0FBTW5CLE1BQU0sb0JBQW9CLFVBQWdDO0FBQUEsRUFDOUMsY0FBYyxvQkFBSSxJQUFlO0FBQUEsRUFDMUMsZ0JBQWdCO0FBQUEsRUFDaEIsYUFBc0IsQ0FBQztBQUFBLEVBQ3ZCLGNBQW9DO0FBQUEsRUFDcEMsa0JBQXNDO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFvQjlCLFNBQXVDLFdBQW1DO0FBQ3hGLFFBQUksS0FBSyxXQUFXLEdBQUc7QUFDckIsWUFBTSxJQUFJLFlBQVksK0JBQStCO0FBQUEsSUFDdkQ7QUFFQSxTQUFLLFVBQVUsS0FBSyxTQUFTO0FB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

package/dist/lib/esm/components/console-debug-component.d.mts

@@ -0,0 +1,30 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Component that provides namespaced console debug logging.
+ */
+import { ComponentEx } from './component-ex.mjs';
+/**
+ * Provides a namespaced `consoleDebug()` method for logging.
+ *
+ * Messages are not shown by default — enable the plugin's debugger namespace to see them.
+ *
+ * @see {@link https://mnaoumov.dev/obsidian-dev-utils/guides/debugging/} for more information.
+ */
+export declare class ConsoleDebugComponent extends ComponentEx {
+    protected readonly pluginId: string;
+    /**
+     * Creates a new console debug component.
+     *
+     * @param pluginId - The plugin ID (used as the debugger namespace).
+     */
+    constructor(pluginId: string);
+    /**
+     * Logs a message to the console under the plugin's debugger namespace.
+     *
+     * @param message - The message to log.
+     * @param $arguments - Additional arguments to log.
+     */
+    consoleDebug(message: string, ...$arguments: unknown[]): void;
+}

package/dist/lib/esm/components/console-debug-component.mjs

@@ -0,0 +1,73 @@
+/*
+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 { getDebugger } from "@mnaoumov/typescript-lib/debug";
+import { ComponentEx } from "./component-ex.mjs";
+class ConsoleDebugComponent extends ComponentEx {
+  /**
+   * Creates a new console debug component.
+   *
+   * @param pluginId - The plugin ID (used as the debugger namespace).
+   */
+  constructor(pluginId) {
+    super();
+    this.pluginId = pluginId;
+  }
+  pluginId;
+  /**
+   * Logs a message to the console under the plugin's debugger namespace.
+   *
+   * @param message - The message to log.
+   * @param $arguments - Additional arguments to log.
+   */
+  consoleDebug(message, ...$arguments) {
+    const FRAMES_TO_SKIP = 1;
+    const pluginDebugger = getDebugger(this.pluginId, FRAMES_TO_SKIP);
+    if (!this._loaded) {
+      pluginDebugger("Plugin is unloaded but sent the following message:");
+    }
+    pluginDebugger(message, ...$arguments);
+  }
+}
+export {
+  ConsoleDebugComponent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvY29uc29sZS1kZWJ1Zy1jb21wb25lbnQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBDb21wb25lbnQgdGhhdCBwcm92aWRlcyBuYW1lc3BhY2VkIGNvbnNvbGUgZGVidWcgbG9nZ2luZy5cbiAqL1xuXG5pbXBvcnQgeyBnZXREZWJ1Z2dlciB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9kZWJ1Zyc7XG5cbmltcG9ydCB7IENvbXBvbmVudEV4IH0gZnJvbSAnLi9jb21wb25lbnQtZXgudHMnO1xuXG4vKipcbiAqIFByb3ZpZGVzIGEgbmFtZXNwYWNlZCBgY29uc29sZURlYnVnKClgIG1ldGhvZCBmb3IgbG9nZ2luZy5cbiAqXG4gKiBNZXNzYWdlcyBhcmUgbm90IHNob3duIGJ5IGRlZmF1bHQgXHUyMDE0IGVuYWJsZSB0aGUgcGx1Z2luJ3MgZGVidWdnZXIgbmFtZXNwYWNlIHRvIHNlZSB0aGVtLlxuICpcbiAqIEBzZWUge0BsaW5rIGh0dHBzOi8vbW5hb3Vtb3YuZGV2L29ic2lkaWFuLWRldi11dGlscy9ndWlkZXMvZGVidWdnaW5nL30gZm9yIG1vcmUgaW5mb3JtYXRpb24uXG4gKi9cbmV4cG9ydCBjbGFzcyBDb25zb2xlRGVidWdDb21wb25lbnQgZXh0ZW5kcyBDb21wb25lbnRFeCB7XG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IGNvbnNvbGUgZGVidWcgY29tcG9uZW50LlxuICAgKlxuICAgKiBAcGFyYW0gcGx1Z2luSWQgLSBUaGUgcGx1Z2luIElEICh1c2VkIGFzIHRoZSBkZWJ1Z2dlciBuYW1lc3BhY2UpLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHByb3RlY3RlZCByZWFkb25seSBwbHVnaW5JZDogc3RyaW5nKSB7XG4gICAgc3VwZXIoKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBMb2dzIGEgbWVzc2FnZSB0byB0aGUgY29uc29sZSB1bmRlciB0aGUgcGx1Z2luJ3MgZGVidWdnZXIgbmFtZXNwYWNlLlxuICAgKlxuICAgKiBAcGFyYW0gbWVzc2FnZSAtIFRoZSBtZXNzYWdlIHRvIGxvZy5cbiAgICogQHBhcmFtICRhcmd1bWVudHMgLSBBZGRpdGlvbmFsIGFyZ3VtZW50cyB0byBsb2cuXG4gICAqL1xuICBwdWJsaWMgY29uc29sZURlYnVnKG1lc3NhZ2U6IHN0cmluZywgLi4uJGFyZ3VtZW50czogdW5rbm93bltdKTogdm9pZCB7XG4gICAgLy8gU2tpcCB0aGUgYGNvbnNvbGVEZWJ1ZygpYCBjYWxsIGl0c2VsZlxuICAgIGNvbnN0IEZSQU1FU19UT19TS0lQID0gMTtcbiAgICBjb25zdCBwbHVnaW5EZWJ1Z2dlciA9IGdldERlYnVnZ2VyKHRoaXMucGx1Z2luSWQsIEZSQU1FU19UT19TS0lQKTtcbiAgICBpZiAoIXRoaXMuX2xvYWRlZCkge1xuICAgICAgcGx1Z2luRGVidWdnZXIoJ1BsdWdpbiBpcyB1bmxvYWRlZCBidXQgc2VudCB0aGUgZm9sbG93aW5nIG1lc3NhZ2U6Jyk7XG4gICAgfVxuICAgIHBsdWdpbkRlYnVnZ2VyKG1lc3NhZ2UsIC4uLiRhcmd1bWVudHMpO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQU1BLFNBQVMsbUJBQW1CO0FBRTVCLFNBQVMsbUJBQW1CO0FBU3JCLE1BQU0sOEJBQThCLFlBQVk7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFNOUMsWUFBK0IsVUFBa0I7QUFDdEQsVUFBTTtBQUQ4QjtBQUFBLEVBRXRDO0FBQUEsRUFGc0M7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVUvQixhQUFhLFlBQW9CLFlBQTZCO0FBRW5FLFVBQU0saUJBQWlCO0FBQ3ZCLFVBQU0saUJBQWlCLFlBQVksS0FBSyxVQUFVLGNBQWM7QUFDaEUsUUFBSSxDQUFDLEtBQUssU0FBUztBQUNqQixxQkFBZSxvREFBb0Q7QUFBQSxJQUNyRTtBQUNBLG1CQUFlLFNBQVMsR0FBRyxVQUFVO0FBQUEsRUFDdkM7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K