@mnaoumov/obsidian-lib 10.10.0 → 10.12.0

package/dist/lib/esm/components/shared-component-pool-component.d.mts

@@ -0,0 +1,129 @@
+/// <reference path="../library-references.d.mts" />
+/// <reference lib="dom" />
+/**
+ * @file
+ *
+ * A pool that shares one loaded component per caller-defined key among several consumers, and unloads it when the
+ * last consumer releases it.
+ */
+import type { DisposableEx } from '@mnaoumov/typescript-lib/disposable';
+import { Component } from 'obsidian';
+import { ComponentEx } from './component-ex.mjs';
+/**
+ * One consumer's hold on a shared component.
+ *
+ * Releasing it is idempotent: the first call drops the hold, and every later call — including the one the consumer
+ * link makes when the consumer unloads — does nothing.
+ *
+ * @typeParam TComponent - The type of the shared component.
+ */
+export interface SharedComponentAcquisition<TComponent extends Component> extends DisposableEx {
+    /**
+     * The shared component, loaded. Every consumer of the same key receives the same instance.
+     */
+    readonly component: TComponent;
+    /**
+     * Whether this acquisition has been released.
+     */
+    readonly isReleased: boolean;
+    /**
+     * Releases this acquisition. The shared component is unloaded when its last acquisition is released.
+     */
+    readonly release: () => void;
+}
+/**
+ * Options of {@link SharedComponentPoolComponent.acquire}.
+ */
+export interface SharedComponentPoolComponentAcquireOptions {
+    /**
+     * Cancels the acquisition while the shared component is still loading. An abort after the acquisition resolved does
+     * nothing; release the acquisition instead.
+     */
+    readonly abortSignal?: AbortSignal;
+    /**
+     * A component whose unload releases the acquisition automatically.
+     *
+     * The link is a child component added to the consumer, so it follows Obsidian's own rules: a consumer that is not
+     * loaded yet starts holding the link when it loads, and a {@link ComponentEx} consumer that is already unloaded
+     * refuses it with a {@link SilentError}. Releasing the acquisition by hand removes the link again, so a long-lived
+     * consumer that acquires and releases many times accumulates nothing.
+     */
+    readonly consumer?: Component;
+}
+/**
+ * Parameters of {@link SharedComponentPoolComponent}.
+ *
+ * @typeParam TKey - The type of the resource key.
+ * @typeParam TComponent - The type of the shared component.
+ */
+export interface SharedComponentPoolComponentConstructorParams<TKey, TComponent extends Component> {
+    /**
+     * Creates the component shared under a key. Called once per key each time the key goes from no consumer to one; the
+     * pool loads the component itself, so the factory must return it unloaded.
+     *
+     * @param key - The resource key.
+     * @returns The new, not yet loaded component.
+     */
+    readonly createComponent: (key: TKey) => TComponent;
+}
+/**
+ * Shares one loaded component per caller-defined key among several consumers.
+ *
+ * The first {@link acquire} of a key creates the component through the factory and loads it; every further acquire of
+ * the same key, concurrent or later, receives the same instance; the release of the last acquisition unloads it, and
+ * the next acquire creates a fresh one. A {@link ComponentEx} is loaded through {@link ComponentEx.loadWithPromises}, so
+ * an acquire resolves only once its `onloadAsync` and children have settled, and a failed load rejects every waiting
+ * acquire, unloads the component and leaves the key free for a fresh attempt.
+ *
+ * The pool is itself a component, and its parent is the owner of every shared instance: add it with `addChild` to the
+ * plugin (or any longer-lived component). Unloading the owner unloads every shared component still held, rejects
+ * every acquire still waiting with a {@link SilentError}, and refuses later acquires. Keys are compared the way a
+ * {@link Map} compares them, so two equal-looking object keys are two resources. The instances live on the pool
+ * object only, never in the shared-state bag, so two plugins — or two pools of one plugin — never share anything.
+ *
+ * Reach for it only when SEVERAL independent consumers want the same expensive component and none of them owns it.
+ * A component with a single owner is that owner's child: `addChild` is simpler and already unloads it with its owner.
+ *
+ * @typeParam TKey - The type of the resource key.
+ * @typeParam TComponent - The type of the shared component.
+ */
+export declare class SharedComponentPoolComponent<TKey, TComponent extends Component> extends ComponentEx {
+    /**
+     * Creates the component shared under a key; see {@link SharedComponentPoolComponentConstructorParams.createComponent}.
+     */
+    protected readonly createComponent: (key: TKey) => TComponent;
+    private readonly creatingKeys;
+    private readonly entries;
+    /**
+     * Creates a new pool.
+     *
+     * @param params - The pool parameters.
+     */
+    constructor(params: SharedComponentPoolComponentConstructorParams<TKey, TComponent>);
+    /**
+     * Acquires the component shared under a key, creating and loading it when the key has no consumer yet.
+     *
+     * @param key - The resource key.
+     * @param options - The acquisition options.
+     * @returns The acquisition, once the shared component has loaded.
+     * @throws An {@link Error} when the pool was never loaded, when the factory or the load fails, or when called for a
+     *   key from inside that key's own factory or synchronous load; a {@link SilentError} when the pool is unloaded, or
+     *   when the consumer unloads or the acquisition is released before the load completes; the abort reason when
+     *   `abortSignal` aborts first.
+     */
+    acquire(key: TKey, options?: SharedComponentPoolComponentAcquireOptions): Promise<SharedComponentAcquisition<TComponent>>;
+    /**
+     * Returns how many acquisitions currently hold the component shared under a key, pending ones included.
+     *
+     * @param key - The resource key.
+     * @returns The number of consumers, `0` when the key has no shared component.
+     */
+    getConsumerCount(key: TKey): number;
+    /**
+     * Registers the teardown that unloads every shared component when the pool unloads.
+     */
+    onload(): void;
+    private createEntry;
+    private releaseReference;
+    private unloadEntry;
+}

package/dist/lib/esm/components/shared-component-pool-component.mjs

@@ -0,0 +1,280 @@
+/*
+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;
+}
+
+ensureDisposeSymbols();
+ensureBrowserProcess();
+})();
+
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __using = (stack, value, async) => {
+  if (value != null) {
+    if (typeof value !== "object" && typeof value !== "function") __typeError("Object expected");
+    var dispose, inner;
+    if (async) dispose = value[__knownSymbol("asyncDispose")];
+    if (dispose === void 0) {
+      dispose = value[__knownSymbol("dispose")];
+      if (async) inner = dispose;
+    }
+    if (typeof dispose !== "function") __typeError("Object not disposable");
+    if (inner) dispose = function() {
+      try {
+        inner.call(this);
+      } catch (e) {
+        return Promise.reject(e);
+      }
+    };
+    stack.push([async, dispose, value]);
+  } else if (async) {
+    stack.push([async]);
+  }
+  return value;
+};
+var __callDispose = (stack, error, hasError) => {
+  var E = typeof SuppressedError === "function" ? SuppressedError : function(e, s, m, _) {
+    return _ = Error(m), _.name = "SuppressedError", _.error = e, _.suppressed = s, _;
+  };
+  var fail = (e) => error = hasError ? new E(e, error, "An error was suppressed during disposal") : (hasError = true, e);
+  var next = (it) => {
+    while (it = stack.pop()) {
+      try {
+        var result = it[1] && it[1].call(it[2]);
+        if (it[0]) return Promise.resolve(result).then(next, (e) => (fail(e), next()));
+      } catch (e) {
+        fail(e);
+      }
+    }
+    if (hasError) throw error;
+  };
+  return next();
+};
+import { onAbort } from "@mnaoumov/typescript-lib/abort-controller";
+import { snapshot } from "@mnaoumov/typescript-lib/array";
+import { SilentError } from "@mnaoumov/typescript-lib/error";
+import { noop } from "@mnaoumov/typescript-lib/function";
+import { Component } from "obsidian";
+import { ComponentEx } from "./component-ex.mjs";
+class SharedComponentAcquisitionImpl {
+  constructor(component, onRelease) {
+    this.component = component;
+    this.onRelease = onRelease;
+  }
+  component;
+  onRelease;
+  get isReleased() {
+    return this._isReleased;
+  }
+  _isReleased = false;
+  unlinkConsumer = null;
+  dispose() {
+    this.release();
+  }
+  linkConsumer(consumer) {
+    const consumerLink = new Component();
+    consumerLink.register(() => {
+      this.unlinkConsumer = null;
+      this.release();
+    });
+    consumer.addChild(consumerLink);
+    this.unlinkConsumer = () => {
+      consumer.removeChild(consumerLink);
+    };
+  }
+  release() {
+    if (this._isReleased) {
+      return;
+    }
+    this._isReleased = true;
+    const unlinkConsumer = this.unlinkConsumer;
+    this.unlinkConsumer = null;
+    unlinkConsumer?.();
+    this.onRelease();
+  }
+  [Symbol.dispose]() {
+    this.release();
+  }
+}
+class SharedComponentPoolComponent extends ComponentEx {
+  /**
+   * Creates the component shared under a key; see {@link SharedComponentPoolComponentConstructorParams.createComponent}.
+   */
+  createComponent;
+  creatingKeys = /* @__PURE__ */ new Set();
+  entries = /* @__PURE__ */ new Map();
+  /**
+   * Creates a new pool.
+   *
+   * @param params - The pool parameters.
+   */
+  constructor(params) {
+    super();
+    this.createComponent = params.createComponent;
+  }
+  /**
+   * Acquires the component shared under a key, creating and loading it when the key has no consumer yet.
+   *
+   * @param key - The resource key.
+   * @param options - The acquisition options.
+   * @returns The acquisition, once the shared component has loaded.
+   * @throws An {@link Error} when the pool was never loaded, when the factory or the load fails, or when called for a
+   *   key from inside that key's own factory or synchronous load; a {@link SilentError} when the pool is unloaded, or
+   *   when the consumer unloads or the acquisition is released before the load completes; the abort reason when
+   *   `abortSignal` aborts first.
+   */
+  async acquire(key, options = {}) {
+    var _stack = [];
+    try {
+      this.ensureLoaded();
+      options.abortSignal?.throwIfAborted();
+      if (this.creatingKeys.has(key)) {
+        throw new Error("A shared component cannot be acquired from inside its own creation");
+      }
+      const entry = this.entries.get(key) ?? this.createEntry(key);
+      entry.consumerCount++;
+      const cancellation = createDeferred();
+      const acquisition = new SharedComponentAcquisitionImpl(entry.component, () => {
+        cancellation.reject(new SilentError("The shared component acquisition was released"));
+        this.releaseReference(entry);
+      });
+      const _abortListener = __using(_stack, options.abortSignal ? onAbort(options.abortSignal, (abortSignal) => {
+        cancellation.reject(abortSignal.reason);
+        acquisition.release();
+      }) : null);
+      try {
+        if (options.consumer) {
+          acquisition.linkConsumer(options.consumer);
+        }
+        await Promise.race([entry.ready.promise, cancellation.promise]);
+      } catch (error) {
+        acquisition.release();
+        throw error;
+      }
+      if (acquisition.isReleased) {
+        throw new SilentError("The shared component acquisition was released");
+      }
+      return acquisition;
+    } catch (_) {
+      var _error = _, _hasError = true;
+    } finally {
+      __callDispose(_stack, _error, _hasError);
+    }
+  }
+  /**
+   * Returns how many acquisitions currently hold the component shared under a key, pending ones included.
+   *
+   * @param key - The resource key.
+   * @returns The number of consumers, `0` when the key has no shared component.
+   */
+  getConsumerCount(key) {
+    return this.entries.get(key)?.consumerCount ?? 0;
+  }
+  /**
+   * Registers the teardown that unloads every shared component when the pool unloads.
+   */
+  onload() {
+    this.register(() => {
+      for (const entry of snapshot([...this.entries.values()])) {
+        this.unloadEntry(entry, new SilentError("The shared component pool is unloaded"));
+      }
+    });
+  }
+  createEntry(key) {
+    this.creatingKeys.add(key);
+    try {
+      const component = this.createComponent(key);
+      const entry = {
+        component,
+        consumerCount: 0,
+        isUnloaded: false,
+        key,
+        ready: createDeferred()
+      };
+      this.entries.set(key, entry);
+      let loadPromise = null;
+      try {
+        if (component instanceof ComponentEx) {
+          loadPromise = component.loadWithPromises();
+        } else {
+          component.load();
+        }
+      } catch (error) {
+        this.unloadEntry(entry, error);
+        throw error;
+      }
+      if (loadPromise) {
+        loadPromise.then(() => {
+          entry.ready.resolve();
+        }).catch((error) => {
+          this.unloadEntry(entry, error);
+        });
+      } else {
+        entry.ready.resolve();
+      }
+      return entry;
+    } finally {
+      this.creatingKeys.delete(key);
+    }
+  }
+  releaseReference(entry) {
+    entry.consumerCount--;
+    if (entry.consumerCount <= 0) {
+      this.unloadEntry(entry, new SilentError("The last consumer released the shared component before it loaded"));
+    }
+  }
+  unloadEntry(entry, reason) {
+    if (entry.isUnloaded) {
+      return;
+    }
+    entry.isUnloaded = true;
+    this.entries.delete(entry.key);
+    entry.ready.reject(reason);
+    entry.component.unload();
+  }
+}
+function createDeferred() {
+  let resolve = noop;
+  let reject = noop;
+  const promise = new Promise((resolvePromise, rejectPromise) => {
+    resolve = resolvePromise;
+    reject = rejectPromise;
+  });
+  promise.catch(noop);
+  return { promise, reject, resolve };
+}
+export {
+  SharedComponentPoolComponent
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9jb21wb25lbnRzL3NoYXJlZC1jb21wb25lbnQtcG9vbC1jb21wb25lbnQudHMiXSwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIEEgcG9vbCB0aGF0IHNoYXJlcyBvbmUgbG9hZGVkIGNvbXBvbmVudCBwZXIgY2FsbGVyLWRlZmluZWQga2V5IGFtb25nIHNldmVyYWwgY29uc3VtZXJzLCBhbmQgdW5sb2FkcyBpdCB3aGVuIHRoZVxuICogbGFzdCBjb25zdW1lciByZWxlYXNlcyBpdC5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IERpc3Bvc2FibGVFeCB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9kaXNwb3NhYmxlJztcblxuaW1wb3J0IHsgb25BYm9ydCB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9hYm9ydC1jb250cm9sbGVyJztcbmltcG9ydCB7IHNuYXBzaG90IH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL2FycmF5JztcbmltcG9ydCB7IFNpbGVudEVycm9yIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL2Vycm9yJztcbmltcG9ydCB7IG5vb3AgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvZnVuY3Rpb24nO1xuaW1wb3J0IHsgQ29tcG9uZW50IH0gZnJvbSAnb2JzaWRpYW4nO1xuXG5pbXBvcnQgeyBDb21wb25lbnRFeCB9IGZyb20gJy4vY29tcG9uZW50LWV4LnRzJztcblxuLyoqXG4gKiBPbmUgY29uc3VtZXIncyBob2xkIG9uIGEgc2hhcmVkIGNvbXBvbmVudC5cbiAqXG4gKiBSZWxlYXNpbmcgaXQgaXMgaWRlbXBvdGVudDogdGhlIGZpcnN0IGNhbGwgZHJvcHMgdGhlIGhvbGQsIGFuZCBldmVyeSBsYXRlciBjYWxsIOKAlCBpbmNsdWRpbmcgdGhlIG9uZSB0aGUgY29uc3VtZXJcbiAqIGxpbmsgbWFrZXMgd2hlbiB0aGUgY29uc3VtZXIgdW5sb2FkcyDigJQgZG9lcyBub3RoaW5nLlxuICpcbiAqIEB0eXBlUGFyYW0gVENvbXBvbmVudCAtIFRoZSB0eXBlIG9mIHRoZSBzaGFyZWQgY29tcG9uZW50LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFNoYXJlZENvbXBvbmVudEFjcXVpc2l0aW9uPFRDb21wb25lbnQgZXh0ZW5kcyBDb21wb25lbnQ+IGV4dGVuZHMgRGlzcG9zYWJsZUV4IHtcbiAgLyoqXG4gICAqIFRoZSBzaGFyZWQgY29tcG9uZW50LCBsb2FkZWQuIEV2ZXJ5IGNvbnN1bWVyIG9mIHRoZSBzYW1lIGtleSByZWNlaXZlcyB0aGUgc2FtZSBpbnN0YW5jZS5cbiAgICovXG4gIHJlYWRvbmx5IGNvbXBvbmVudDogVENvbXBvbmVudDtcblxuICAvKipcbiAgICogV2hldGhlciB0aGlzIGFjcXVpc2l0aW9uIGhhcyBiZWVuIHJlbGVhc2VkLlxuICAgKi9cbiAgcmVhZG9ubHkgaXNSZWxlYXNlZDogYm9vbGVhbjtcblxuICAvKipcbiAgICogUmVsZWFzZXMgdGhpcyBhY3F1aXNpdGlvbi4gVGhlIHNoYXJlZCBjb21wb25lbnQgaXMgdW5sb2FkZWQgd2hlbiBpdHMgbGFzdCBhY3F1aXNpdGlvbiBpcyByZWxlYXNlZC5cbiAgICovXG4gIHJlYWRvbmx5IHJlbGVhc2U6ICgpID0+IHZvaWQ7XG59XG5cbi8qKlxuICogT3B0aW9ucyBvZiB7QGxpbmsgU2hhcmVkQ29tcG9uZW50UG9vbENvbXBvbmVudC5hY3F1aXJlfS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBTaGFyZWRDb21wb25lbnRQb29sQ29tcG9uZW50QWNxdWlyZU9wdGlvbnMge1xuICAvKipcbiAgICogQ2FuY2VscyB0aGUgYWNxdWlzaXRpb24gd2hpbGUgdGhlIHNoYXJlZCBjb21wb25lbnQgaXMgc3RpbGwgbG9hZGluZy4gQW4gYWJvcnQgYWZ0ZXIgdGhlIGFjcXVpc2l0aW9uIHJlc29sdmVkIGRvZXNcbiAgICogbm90aGluZzsgcmVsZWFzZSB0aGUgYWNxdWlzaXRpb24gaW5zdGVhZC5cbiAgICovXG4gIHJlYWRvbmx5IGFib3J0U2lnbmFsPzogQWJvcnRTaWduYWw7XG5cbiAgLyoqXG4gICAqIEEgY29tcG9uZW50IHdob3NlIHVubG9hZCByZWxlYXNlcyB0aGUgYWNxdWlzaXRpb24gYXV0b21hdGljYWxseS5cbiAgICpcbiAgICogVGhlIGxpbmsgaXMgYSBjaGlsZCBjb21wb25lbnQgYWRkZWQgdG8gdGhlIGNvbnN1bWVyLCBzbyBpdCBmb2xsb3dzIE9ic2lkaWFuJ3Mgb3duIHJ1bGVzOiBhIGNvbnN1bWVyIHRoYXQgaXMgbm90XG4gICAqIGxvYWRlZCB5ZXQgc3RhcnRzIGhvbGRpbmcgdGhlIGxpbmsgd2hlbiBpdCBsb2FkcywgYW5kIGEge0BsaW5rIENvbXBvbmVudEV4fSBjb25zdW1lciB0aGF0IGlzIGFscmVhZHkgdW5sb2FkZWRcbiAgICogcmVmdXNlcyBpdCB3aXRoIGEge0BsaW5rIFNpbGVudEVycm9yfS4gUmVsZWFzaW5nIHRoZSBhY3F1aXNpdGlvbiBieSBoYW5kIHJlbW92ZXMgdGhlIGxpbmsgYWdhaW4sIHNvIGEgbG9uZy1saXZlZFxuICAgKiBjb25zdW1lciB0aGF0IGFjcXVpcmVzIGFuZCByZWxlYXNlcyBtYW55IHRpbWVzIGFjY3VtdWxhdGVzIG5vdGhpbmcuXG4gICAqL1xuICByZWFkb25seSBjb25zdW1lcj86IENvbXBvbmVudDtcbn1cblxuLyoqXG4gKiBQYXJhbWV0ZXJzIG9mIHtAbGluayBTaGFyZWRDb21wb25lbnRQb29sQ29tcG9uZW50fS5cbiAqXG4gKiBAdHlwZVBhcmFtIFRLZXkgLSBUaGUgdHlwZSBvZiB0aGUgcmVzb3VyY2Uga2V5LlxuICogQHR5cGVQYXJhbSBUQ29tcG9uZW50IC0gVGhlIHR5cGUgb2YgdGhlIHNoYXJlZCBjb21wb25lbnQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgU2hhcmVkQ29tcG9uZW50UG9vbENvbXBvbmVudENvbnN0cnVjdG9yUGFyYW1zPFRLZXksIFRDb21wb25lbnQgZXh0ZW5kcyBDb21wb25lbnQ+IHtcbiAgLyoqXG4gICAqIENyZWF0ZXMgdGhlIGNvbXBvbmVudCBzaGFyZWQgdW5kZXIgYSBrZXkuIENhbGxlZCBvbmNlIHBlciBrZXkgZWFjaCB0aW1lIHRoZSBrZXkgZ29lcyBmcm9tIG5vIGNvbnN1bWVyIHRvIG9uZTsgdGhlXG4gICAqIHBvb2wgbG9hZHMgdGhlIGNvbXBvbmVudCBpdHNlbGYsIHNvIHRoZSBmYWN0b3J5IG11c3QgcmV0dXJuIGl0IHVubG9hZGVkLlxuICAgKlxuICAgKiBAcGFyYW0ga2V5IC0gVGhlIHJlc291cmNlIGtleS5cbiAgICogQHJldHVybnMgVGhlIG5ldywgbm90IHlldCBsb2FkZWQgY29tcG9uZW50LlxuICAgKi9cbiAgcmVhZG9ubHkgY3JlYXRlQ29tcG9uZW50OiAoa2V5OiBUS2V5KSA9PiBUQ29tcG9uZW50O1xufVxuXG5pbnRlcmZhY2UgRGVmZXJyZWQge1xuICByZWFkb25seSBwcm9taXNlOiBQcm9taXNlPHZvaWQ+O1xuICByZWFkb25seSByZWplY3Q6IChyZWFzb246IHVua25vd24pID0+IHZvaWQ7XG4gIHJlYWRvbmx5IHJlc29sdmU6ICgpID0+IHZvaWQ7XG59XG5cbmludGVyZmFjZSBQb29sRW50cnk8VEtleSwgVENvbXBvbmVudCBleHRlbmRzIENvbXBvbmVudD4ge1xuICByZWFkb25seSBjb21wb25lbnQ6IFRDb21wb25lbnQ7XG4gIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSB0eXBlc2NyaXB0LWRldi10b29sa2l0L3JlYWRvbmx5LWludGVyZmFjZS1tZW1iZXJzIC0tIE11dGFibGUgYm9va2tlZXBpbmcgb2YgdGhlIHBvb2wuXG4gIGNvbnN1bWVyQ291bnQ6IG51bWJlcjtcbiAgLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIHR5cGVzY3JpcHQtZGV2LXRvb2xraXQvcmVhZG9ubHktaW50ZXJmYWNlLW1lbWJlcnMgLS0gTXV0YWJsZSBib29ra2VlcGluZyBvZiB0aGUgcG9vbC5cbiAgaXNVbmxvYWRlZDogYm9vbGVhbjtcbiAgcmVhZG9ubHkga2V5OiBUS2V5O1xuICByZWFkb25seSByZWFkeTogRGVmZXJyZWQ7XG59XG5cbmNsYXNzIFNoYXJlZENvbXBvbmVudEFjcXVpc2l0aW9uSW1wbDxUQ29tcG9uZW50IGV4dGVuZHMgQ29tcG9uZW50PiBpbXBsZW1lbnRzIFNoYXJlZENvbXBvbmVudEFjcXVpc2l0aW9uPFRDb21wb25lbnQ+IHtcbiAgcHVibGljIGdldCBpc1JlbGVhc2VkKCk6IGJvb2xlYW4ge1xuICAgIHJldHVybiB0aGlzLl9pc1JlbGVhc2VkO1xuICB9XG5cbiAgcHJpdmF0ZSBfaXNSZWxlYXNlZCA9IGZhbHNlO1xuICBwcml2YXRlIHVubGlua0NvbnN1bWVyOiAoKCkgPT4gdm9pZCkgfCBudWxsID0gbnVsbDtcblxuICBwdWJsaWMgY29uc3RydWN0b3IocHVibGljIHJlYWRvbmx5IGNvbXBvbmVudDogVENvbXBvbmVudCwgcHJpdmF0ZSByZWFkb25seSBvblJlbGVhc2U6ICgpID0+IHZvaWQpIHt9XG5cbiAgcHVibGljIGRpc3Bvc2UoKTogdm9pZCB7XG4gICAgdGhpcy5yZWxlYXNlKCk7XG4gIH1cblxuICBwdWJsaWMgbGlua0NvbnN1bWVyKGNvbnN1bWVyOiBDb21wb25lbnQpOiB2b2lkIHtcbiAgICBjb25zdCBjb25zdW1lckxpbmsgPSBuZXcgQ29tcG9uZW50KCk7XG4gICAgY29uc3VtZXJMaW5rLnJlZ2lzdGVyKCgpID0+IHtcbiAgICAgIHRoaXMudW5saW5rQ29uc3VtZXIgPSBudWxsO1xuICAgICAgdGhpcy5yZWxlYXNlKCk7XG4gICAgfSk7XG4gICAgY29uc3VtZXIuYWRkQ2hpbGQoY29uc3VtZXJMaW5rKTtcbiAgICB0aGlzLnVubGlua0NvbnN1bWVyID0gKCk6IHZvaWQgPT4ge1xuICAgICAgY29uc3VtZXIucmVtb3ZlQ2hpbGQoY29uc3VtZXJMaW5rKTtcbiAgICB9O1xuICB9XG5cbiAgcHVibGljIHJlbGVhc2UoKTogdm9pZCB7XG4gICAgaWYgKHRoaXMuX2lzUmVsZWFzZWQpIHtcbiAgICAgIHJldHVybjtcbiAgICB9XG5cbiAgICB0aGlzLl9pc1JlbGVhc2VkID0gdHJ1ZTtcbiAgICBjb25zdCB1bmxpbmtDb25zdW1lciA9IHRoaXMudW5saW5rQ29uc3VtZXI7XG4gICAgdGhpcy51bmxpbmtDb25zdW1lciA9IG51bGw7XG4gICAgdW5saW5rQ29uc3VtZXI/LigpO1xuICAgIHRoaXMub25SZWxlYXNlKCk7XG4gIH1cblxuICBwdWJsaWMgW1N5bWJvbC5kaXNwb3NlXSgpOiB2b2lkIHtcbiAgICB0aGlzLnJlbGVhc2UoKTtcbiAgfVxufVxuXG4vKipcbiAqIFNoYXJlcyBvbmUgbG9hZGVkIGNvbXBvbmVudCBwZXIgY2FsbGVyLWRlZmluZWQga2V5IGFtb25nIHNldmVyYWwgY29uc3VtZXJzLlxuICpcbiAqIFRoZSBmaXJzdCB7QGxpbmsgYWNxdWlyZX0gb2YgYSBrZXkgY3JlYXRlcyB0aGUgY29tcG9uZW50IHRocm91Z2ggdGhlIGZhY3RvcnkgYW5kIGxvYWRzIGl0OyBldmVyeSBmdXJ0aGVyIGFjcXVpcmUgb2ZcbiAqIHRoZSBzYW1lIGtleSwgY29uY3VycmVudCBvciBsYXRlciwgcmVjZWl2ZXMgdGhlIHNhbWUgaW5zdGFuY2U7IHRoZSByZWxlYXNlIG9mIHRoZSBsYXN0IGFjcXVpc2l0aW9uIHVubG9hZHMgaXQsIGFuZFxuICogdGhlIG5leHQgYWNxdWlyZSBjcmVhdGVzIGEgZnJlc2ggb25lLiBBIHtAbGluayBDb21wb25lbnRFeH0gaXMgbG9hZGVkIHRocm91Z2gge0BsaW5rIENvbXBvbmVudEV4LmxvYWRXaXRoUHJvbWlzZXN9LCBzb1xuICogYW4gYWNxdWlyZSByZXNvbHZlcyBvbmx5IG9uY2UgaXRzIGBvbmxvYWRBc3luY2AgYW5kIGNoaWxkcmVuIGhhdmUgc2V0dGxlZCwgYW5kIGEgZmFpbGVkIGxvYWQgcmVqZWN0cyBldmVyeSB3YWl0aW5nXG4gKiBhY3F1aXJlLCB1bmxvYWRzIHRoZSBjb21wb25lbnQgYW5kIGxlYXZlcyB0aGUga2V5IGZyZWUgZm9yIGEgZnJlc2ggYXR0ZW1wdC5cbiAqXG4gKiBUaGUgcG9vbCBpcyBpdHNlbGYgYSBjb21wb25lbnQsIGFuZCBpdHMgcGFyZW50IGlzIHRoZSBvd25lciBvZiBldmVyeSBzaGFyZWQgaW5zdGFuY2U6IGFkZCBpdCB3aXRoIGBhZGRDaGlsZGAgdG8gdGhlXG4gKiBwbHVnaW4gKG9yIGFueSBsb25nZXItbGl2ZWQgY29tcG9uZW50KS4gVW5sb2FkaW5nIHRoZSBvd25lciB1bmxvYWRzIGV2ZXJ5IHNoYXJlZCBjb21wb25lbnQgc3RpbGwgaGVsZCwgcmVqZWN0c1xuICogZXZlcnkgYWNxdWlyZSBzdGlsbCB3YWl0aW5nIHdpdGggYSB7QGxpbmsgU2lsZW50RXJyb3J9LCBhbmQgcmVmdXNlcyBsYXRlciBhY3F1aXJlcy4gS2V5cyBhcmUgY29tcGFyZWQgdGhlIHdheSBhXG4gKiB7QGxpbmsgTWFwfSBjb21wYXJlcyB0aGVtLCBzbyB0d28gZXF1YWwtbG9va2luZyBvYmplY3Qga2V5cyBhcmUgdHdvIHJlc291cmNlcy4gVGhlIGluc3RhbmNlcyBsaXZlIG9uIHRoZSBwb29sXG4gKiBvYmplY3Qgb25seSwgbmV2ZXIgaW4gdGhlIHNoYXJlZC1zdGF0ZSBiYWcsIHNvIHR3byBwbHVnaW5zIOKAlCBvciB0d28gcG9vbHMgb2Ygb25lIHBsdWdpbiDigJQgbmV2ZXIgc2hhcmUgYW55dGhpbmcuXG4gKlxuICogUmVhY2ggZm9yIGl0IG9ubHkgd2hlbiBTRVZFUkFMIGluZGVwZW5kZW50IGNvbnN1bWVycyB3YW50IHRoZSBzYW1lIGV4cGVuc2l2ZSBjb21wb25lbnQgYW5kIG5vbmUgb2YgdGhlbSBvd25zIGl0LlxuICogQSBjb21wb25lbnQgd2l0aCBhIHNpbmdsZSBvd25lciBpcyB0aGF0IG93bmVyJ3MgY2hpbGQ6IGBhZGRDaGlsZGAgaXMgc2ltcGxlciBhbmQgYWxyZWFkeSB1bmxvYWRzIGl0IHdpdGggaXRzIG93bmVyLlxuICpcbiAqIEB0eXBlUGFyYW0gVEtleSAtIFRoZSB0eXBlIG9mIHRoZSByZXNvdXJjZSBrZXkuXG4gKiBAdHlwZVBhcmFtIFRDb21wb25lbnQgLSBUaGUgdHlwZSBvZiB0aGUgc2hhcmVkIGNvbXBvbmVudC5cbiAqL1xuZXhwb3J0IGNsYXNzIFNoYXJlZENvbXBvbmVudFBvb2xDb21wb25lbnQ8VEtleSwgVENvbXBvbmVudCBleHRlbmRzIENvbXBvbmVudD4gZXh0ZW5kcyBDb21wb25lbnRFeCB7XG4gIC8qKlxuICAgKiBDcmVhdGVzIHRoZSBjb21wb25lbnQgc2hhcmVkIHVuZGVyIGEga2V5OyBzZWUge0BsaW5rIFNoYXJlZENvbXBvbmVudFBvb2xDb21wb25lbnRDb25zdHJ1Y3RvclBhcmFtcy5jcmVhdGVDb21wb25lbnR9LlxuICAgKi9cbiAgcHJvdGVjdGVkIHJlYWRvbmx5IGNyZWF0ZUNvbXBvbmVudDogKGtleTogVEtleSkgPT4gVENvbXBvbmVudDtcblxuICBwcml2YXRlIHJlYWRvbmx5IGNyZWF0aW5nS2V5cyA9IG5ldyBTZXQ8VEtleT4oKTtcbiAgcHJpdmF0ZSByZWFkb25seSBlbnRyaWVzID0gbmV3IE1hcDxUS2V5LCBQb29sRW50cnk8VEtleSwgVENvbXBvbmVudD4+KCk7XG5cbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgcG9vbC5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwb29sIHBhcmFtZXRlcnMuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocGFyYW1zOiBTaGFyZWRDb21wb25lbnRQb29sQ29tcG9uZW50Q29uc3RydWN0b3JQYXJhbXM8VEtleSwgVENvbXBvbmVudD4pIHtcbiAgICBzdXBlcigpO1xuICAgIHRoaXMuY3JlYXRlQ29tcG9uZW50ID0gcGFyYW1zLmNyZWF0ZUNvbXBvbmVudDtcbiAgfVxuXG4gIC8qKlxuICAgKiBBY3F1aXJlcyB0aGUgY29tcG9uZW50IHNoYXJlZCB1bmRlciBhIGtleSwgY3JlYXRpbmcgYW5kIGxvYWRpbmcgaXQgd2hlbiB0aGUga2V5IGhhcyBubyBjb25zdW1lciB5ZXQuXG4gICAqXG4gICAqIEBwYXJhbSBrZXkgLSBUaGUgcmVzb3VyY2Uga2V5LlxuICAgKiBAcGFyYW0gb3B0aW9ucyAtIFRoZSBhY3F1aXNpdGlvbiBvcHRpb25zLlxuICAgKiBAcmV0dXJucyBUaGUgYWNxdWlzaXRpb24sIG9uY2UgdGhlIHNoYXJlZCBjb21wb25lbnQgaGFzIGxvYWRlZC5cbiAgICogQHRocm93cyBBbiB7QGxpbmsgRXJyb3J9IHdoZW4gdGhlIHBvb2wgd2FzIG5ldmVyIGxvYWRlZCwgd2hlbiB0aGUgZmFjdG9yeSBvciB0aGUgbG9hZCBmYWlscywgb3Igd2hlbiBjYWxsZWQgZm9yIGFcbiAgICogICBrZXkgZnJvbSBpbnNpZGUgdGhhdCBrZXkncyBvd24gZmFjdG9yeSBvciBzeW5jaHJvbm91cyBsb2FkOyBhIHtAbGluayBTaWxlbnRFcnJvcn0gd2hlbiB0aGUgcG9vbCBpcyB1bmxvYWRlZCwgb3JcbiAgICogICB3aGVuIHRoZSBjb25zdW1lciB1bmxvYWRzIG9yIHRoZSBhY3F1aXNpdGlvbiBpcyByZWxlYXNlZCBiZWZvcmUgdGhlIGxvYWQgY29tcGxldGVzOyB0aGUgYWJvcnQgcmVhc29uIHdoZW5cbiAgICogICBgYWJvcnRTaWduYWxgIGFib3J0cyBmaXJzdC5cbiAgICovXG4gIHB1YmxpYyBhc3luYyBhY3F1aXJlKGtleTogVEtleSwgb3B0aW9uczogU2hhcmVkQ29tcG9uZW50UG9vbENvbXBvbmVudEFjcXVpcmVPcHRpb25zID0ge30pOiBQcm9taXNlPFNoYXJlZENvbXBvbmVudEFjcXVpc2l0aW9uPFRDb21wb25lbnQ+PiB7XG4gICAgdGhpcy5lbnN1cmVMb2FkZWQoKTtcbiAgICBvcHRpb25zLmFib3J0U2lnbmFsPy50aHJvd0lmQWJvcnRlZCgpO1xuXG4gICAgaWYgKHRoaXMuY3JlYXRpbmdLZXlzLmhhcyhrZXkpKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoJ0Egc2hhcmVkIGNvbXBvbmVudCBjYW5ub3QgYmUgYWNxdWlyZWQgZnJvbSBpbnNpZGUgaXRzIG93biBjcmVhdGlvbicpO1xuICAgIH1cblxuICAgIGNvbnN0IGVudHJ5ID0gdGhpcy5lbnRyaWVzLmdldChrZXkpID8/IHRoaXMuY3JlYXRlRW50cnkoa2V5KTtcbiAgICBlbnRyeS5jb25zdW1lckNvdW50Kys7XG5cbiAgICBjb25zdCBjYW5jZWxsYXRpb24gPSBjcmVhdGVEZWZlcnJlZCgpO1xuICAgIGNvbnN0IGFjcXVpc2l0aW9uID0gbmV3IFNoYXJlZENvbXBvbmVudEFjcXVpc2l0aW9uSW1wbChlbnRyeS5jb21wb25lbnQsICgpID0+IHtcbiAgICAgIGNhbmNlbGxhdGlvbi5yZWplY3QobmV3IFNpbGVudEVycm9yKCdUaGUgc2hhcmVkIGNvbXBvbmVudCBhY3F1aXNpdGlvbiB3YXMgcmVsZWFzZWQnKSk7XG4gICAgICB0aGlzLnJlbGVhc2VSZWZlcmVuY2UoZW50cnkpO1xuICAgIH0pO1xuXG4gICAgdXNpbmcgX2Fib3J0TGlzdGVuZXIgPSBvcHRpb25zLmFib3J0U2lnbmFsXG4gICAgICA/IG9uQWJvcnQob3B0aW9ucy5hYm9ydFNpZ25hbCwgKGFib3J0U2lnbmFsKSA9PiB7XG4gICAgICAgIGNhbmNlbGxhdGlvbi5yZWplY3QoYWJvcnRTaWduYWwucmVhc29uKTtcbiAgICAgICAgYWNxdWlzaXRpb24ucmVsZWFzZSgpO1xuICAgICAgfSlcbiAgICAgIDogbnVsbDtcblxuICAgIHRyeSB7XG4gICAgICBpZiAob3B0aW9ucy5jb25zdW1lcikge1xuICAgICAgICBhY3F1aXNpdGlvbi5saW5rQ29uc3VtZXIob3B0aW9ucy5jb25zdW1lcik7XG4gICAgICB9XG4gICAgICBhd2FpdCBQcm9taXNlLnJhY2UoW2VudHJ5LnJlYWR5LnByb21pc2UsIGNhbmNlbGxhdGlvbi5wcm9taXNlXSk7XG4gICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgIGFjcXVpc2l0aW9uLnJlbGVhc2UoKTtcbiAgICAgIHRocm93IGVycm9yO1xuICAgIH1cblxuICAgIGlmIChhY3F1aXNpdGlvbi5pc1JlbGVhc2VkKSB7XG4gICAgICB0aHJvdyBuZXcgU2lsZW50RXJyb3IoJ1RoZSBzaGFyZWQgY29tcG9uZW50IGFjcXVpc2l0aW9uIHdhcyByZWxlYXNlZCcpO1xuICAgIH1cblxuICAgIHJldHVybiBhY3F1aXNpdGlvbjtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZXR1cm5zIGhvdyBtYW55IGFjcXVpc2l0aW9ucyBjdXJyZW50bHkgaG9sZCB0aGUgY29tcG9uZW50IHNoYXJlZCB1bmRlciBhIGtleSwgcGVuZGluZyBvbmVzIGluY2x1ZGVkLlxuICAgKlxuICAgKiBAcGFyYW0ga2V5IC0gVGhlIHJlc291cmNlIGtleS5cbiAgICogQHJldHVybnMgVGhlIG51bWJlciBvZiBjb25zdW1lcnMsIGAwYCB3aGVuIHRoZSBrZXkgaGFzIG5vIHNoYXJlZCBjb21wb25lbnQuXG4gICAqL1xuICBwdWJsaWMgZ2V0Q29uc3VtZXJDb3VudChrZXk6IFRLZXkpOiBudW1iZXIge1xuICAgIHJldHVybiB0aGlzLmVudHJpZXMuZ2V0KGtleSk/LmNvbnN1bWVyQ291bnQgPz8gMDtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgdGhlIHRlYXJkb3duIHRoYXQgdW5sb2FkcyBldmVyeSBzaGFyZWQgY29tcG9uZW50IHdoZW4gdGhlIHBvb2wgdW5sb2Fkcy5cbiAgICovXG4gIHB1YmxpYyBvdmVycmlkZSBvbmxvYWQoKTogdm9pZCB7XG4gICAgdGhpcy5yZWdpc3RlcigoKSA9PiB7XG4gICAgICBmb3IgKGNvbnN0IGVudHJ5IG9mIHNuYXBzaG90KFsuLi50aGlzLmVudHJpZXMudmFsdWVzKCldKSkge1xuICAgICAgICB0aGlzLnVubG9hZEVudHJ5KGVudHJ5LCBuZXcgU2lsZW50RXJyb3IoJ1RoZSBzaGFyZWQgY29tcG9uZW50IHBvb2wgaXMgdW5sb2FkZWQnKSk7XG4gICAgICB9XG4gICAgfSk7XG4gIH1cblxuICBwcml2YXRlIGNyZWF0ZUVudHJ5KGtleTogVEtleSk6IFBvb2xFbnRyeTxUS2V5LCBUQ29tcG9uZW50PiB7XG4gICAgdGhpcy5jcmVhdGluZ0tleXMuYWRkKGtleSk7XG4gICAgdHJ5IHtcbiAgICAgIGNvbnN0IGNvbXBvbmVudCA9IHRoaXMuY3JlYXRlQ29tcG9uZW50KGtleSk7XG4gICAgICBjb25zdCBlbnRyeTogUG9vbEVudHJ5PFRLZXksIFRDb21wb25lbnQ+ID0ge1xuICAgICAgICBjb21wb25lbnQsXG4gICAgICAgIGNvbnN1bWVyQ291bnQ6IDAsXG4gICAgICAgIGlzVW5sb2FkZWQ6IGZhbHNlLFxuICAgICAgICBrZXksXG4gICAgICAgIHJlYWR5OiBjcmVhdGVEZWZlcnJlZCgpXG4gICAgICB9O1xuICAgICAgdGhpcy5lbnRyaWVzLnNldChrZXksIGVudHJ5KTtcblxuICAgICAgbGV0IGxvYWRQcm9taXNlOiBudWxsIHwgUHJvbWlzZTx2b2lkPiA9IG51bGw7XG4gICAgICB0cnkge1xuICAgICAgICBpZiAoY29tcG9uZW50IGluc3RhbmNlb2YgQ29tcG9uZW50RXgpIHtcbiAgICAgICAgICBsb2FkUHJvbWlzZSA9IGNvbXBvbmVudC5sb2FkV2l0aFByb21pc2VzKCk7XG4gICAgICAgIH0gZWxzZSB7XG4gICAgICAgICAgY29tcG9uZW50LmxvYWQoKTtcbiAgICAgICAgfVxuICAgICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgICAgdGhpcy51bmxvYWRFbnRyeShlbnRyeSwgZXJyb3IpO1xuICAgICAgICB0aHJvdyBlcnJvcjtcbiAgICAgIH1cblxuICAgICAgaWYgKGxvYWRQcm9taXNlKSB7XG4gICAgICAgIGxvYWRQcm9taXNlLnRoZW4oKCkgPT4ge1xuICAgICAgICAgIGVudHJ5LnJlYWR5LnJlc29sdmUoKTtcbiAgICAgICAgfSkuY2F0Y2goKGVycm9yOiB1bmtub3duKSA9PiB7XG4gICAgICAgICAgdGhpcy51bmxvYWRFbnRyeShlbnRyeSwgZXJyb3IpO1xuICAgICAgICB9KTtcbiAgICAgIH0gZWxzZSB7XG4gICAgICAgIGVudHJ5LnJlYWR5LnJlc29sdmUoKTtcbiAgICAgIH1cblxuICAgICAgcmV0dXJuIGVudHJ5O1xuICAgIH0gZmluYWxseSB7XG4gICAgICB0aGlzLmNyZWF0aW5nS2V5cy5kZWxldGUoa2V5KTtcbiAgICB9XG4gIH1cblxuICBwcml2YXRlIHJlbGVhc2VSZWZlcmVuY2UoZW50cnk6IFBvb2xFbnRyeTxUS2V5LCBUQ29tcG9uZW50Pik6IHZvaWQge1xuICAgIGVudHJ5LmNvbnN1bWVyQ291bnQtLTtcbiAgICBpZiAoZW50cnkuY29uc3VtZXJDb3VudCA8PSAwKSB7XG4gICAgICB0aGlzLnVubG9hZEVudHJ5KGVudHJ5LCBuZXcgU2lsZW50RXJyb3IoJ1RoZSBsYXN0IGNvbnN1bWVyIHJlbGVhc2VkIHRoZSBzaGFyZWQgY29tcG9uZW50IGJlZm9yZSBpdCBsb2FkZWQnKSk7XG4gICAgfVxuICB9XG5cbiAgcHJpdmF0ZSB1bmxvYWRFbnRyeShlbnRyeTogUG9vbEVudHJ5PFRLZXksIFRDb21wb25lbnQ+LCByZWFzb246IHVua25vd24pOiB2b2lkIHtcbiAgICBpZiAoZW50cnkuaXNVbmxvYWRlZCkge1xuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIGVudHJ5LmlzVW5sb2FkZWQgPSB0cnVlO1xuICAgIC8vIEFuIGVudHJ5IHN0YXlzIGluIHRoZSBtYXAgdW50aWwgaXQgaXMgdW5sb2FkZWQsIGFuZCBvbmx5IG9uY2UsIHNvIHRoZSBrZXkgc3RpbGwgbWFwcyB0byB0aGlzIGVudHJ5LlxuICAgIHRoaXMuZW50cmllcy5kZWxldGUoZW50cnkua2V5KTtcbiAgICBlbnRyeS5yZWFkeS5yZWplY3QocmVhc29uKTtcbiAgICBlbnRyeS5jb21wb25lbnQudW5sb2FkKCk7XG4gIH1cbn1cblxuZnVuY3Rpb24gY3JlYXRlRGVmZXJyZWQoKTogRGVmZXJyZWQge1xuICBsZXQgcmVzb2x2ZTogKCkgPT4gdm9pZCA9IG5vb3A7XG4gIGxldCByZWplY3Q6IChyZWFzb246IHVua25vd24pID0+IHZvaWQgPSBub29wO1xuICBjb25zdCBwcm9taXNlID0gbmV3IFByb21pc2U8dm9pZD4oKHJlc29sdmVQcm9taXNlLCByZWplY3RQcm9taXNlKSA9PiB7XG4gICAgcmVzb2x2ZSA9IHJlc29sdmVQcm9taXNlO1xuICAgIHJlamVjdCA9IHJlamVjdFByb21pc2U7XG4gIH0pO1xuICAvLyBBIGRlZmVycmVkIG1heSBiZSByZWplY3RlZCB3aGlsZSBub2JvZHkgYXdhaXRzIGl0OyBtYXJrIGl0IGhhbmRsZWQgc28gdGhhdCBpcyBub3QgYW4gdW5oYW5kbGVkIHJlamVjdGlvbi5cbiAgcHJvbWlzZS5jYXRjaChub29wKTtcbiAgcmV0dXJuIHsgcHJvbWlzZSwgcmVqZWN0LCByZXNvbHZlIH07XG59XG4iXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBU0EsU0FBUyxlQUFlO0FBQ3hCLFNBQVMsZ0JBQWdCO0FBQ3pCLFNBQVMsbUJBQW1CO0FBQzVCLFNBQVMsWUFBWTtBQUNyQixTQUFTLGlCQUFpQjtBQUUxQixTQUFTLG1CQUFtQjtBQWlGNUIsTUFBTSwrQkFBK0c7QUFBQSxFQVE1RyxZQUE0QixXQUF3QyxXQUF1QjtBQUEvRDtBQUF3QztBQUFBLEVBQXdCO0FBQUEsRUFBaEU7QUFBQSxFQUF3QztBQUFBLEVBUDNFLElBQVcsYUFBc0I7QUFDL0IsV0FBTyxLQUFLO0FBQUEsRUFDZDtBQUFBLEVBRVEsY0FBYztBQUFBLEVBQ2QsaUJBQXNDO0FBQUEsRUFJdkMsVUFBZ0I7QUFDckIsU0FBSyxRQUFRO0FBQUEsRUFDZjtBQUFBLEVBRU8sYUFBYSxVQUEyQjtBQUM3QyxVQUFNLGVBQWUsSUFBSSxVQUFVO0FBQ25DLGlCQUFhLFNBQVMsTUFBTTtBQUMxQixXQUFLLGlCQUFpQjtBQUN0QixXQUFLLFFBQVE7QUFBQSxJQUNmLENBQUM7QUFDRCxhQUFTLFNBQVMsWUFBWTtBQUM5QixTQUFLLGlCQUFpQixNQUFZO0FBQ2hDLGVBQVMsWUFBWSxZQUFZO0FBQUEsSUFDbkM7QUFBQSxFQUNGO0FBQUEsRUFFTyxVQUFnQjtBQUNyQixRQUFJLEtBQUssYUFBYTtBQUNwQjtBQUFBLElBQ0Y7QUFF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

package/dist/lib/esm/components/workspace-layout-state-component.d.mts

@@ -0,0 +1,239 @@
+/// <reference path="../library-references.d.mts" />
+/**
+ * @file
+ *
+ * Keeps a plugin's layout-scoped state in the workspace layout itself, so each saved workspace remembers its own value
+ * and switching workspaces restores it, instead of one global value in `data.json`.
+ *
+ * Read from Obsidian `1.15.1`: `Workspace.getLayout()` builds a fresh object (`main`, `left`, `right`, `left-ribbon`,
+ * `floating`, `active`) and `Workspace.setLayout()` ignores every other top-level key. `deserializeLayout` keeps each
+ * item's `id`, popout leaves included. The Workspaces core plugin saves through `getLayout()` and loads through
+ * `changeLayout()`, which calls `setLayout()`. Startup goes through `loadLayout()`, `readWorkspaceFile()` and
+ * `setLayout()`, after the plugins enabled at startup have loaded. So two patches on the `app.workspace` instance carry
+ * the whole thing: `getLayout` writes the records under {@link WORKSPACE_LAYOUT_STATE_LAYOUT_KEY}, and `setLayout`
+ * replaces them from the layout it is handed before any view is restored. Per-leaf state is keyed by leaf id at the
+ * layout level, so no `WorkspaceItem.serialize` or `deserializeLayout` patch is needed.
+ *
+ * A view the plugin owns needs none of this: `View.getState` / `setState` already ride in each leaf's state. This
+ * component is for the scope those methods cannot represent: the whole layout, and leaves of views the plugin does not
+ * own.
+ *
+ * Every plugin bundles its own copy of this library, so the records, the subscriptions and ONE installation of the
+ * patches live in the shared-state bag under a versioned key, owned by one subscriber. When the owner unloads while
+ * others remain, the next subscriber installs again from its own copy. What crosses that boundary is a wire format
+ * between copies of different versions: plain objects and plain functions only, fields only ever added, and a change of
+ * meaning moves to a new key. The layout record is a wire format too, persisted in `workspace.json` and in every saved
+ * workspace.
+ */
+import type { App, WorkspaceLeaf } from 'obsidian';
+import type { JsonValue } from 'type-fest';
+import { ComponentEx } from './component-ex.mjs';
+/**
+ * The top-level key of a serialized layout that holds the records.
+ */
+export declare const WORKSPACE_LAYOUT_STATE_LAYOUT_KEY = "obsidianLibLayoutStateV1";
+/**
+ * A change of one key's value, in one scope.
+ *
+ * @typeParam T - The value type.
+ */
+export interface WorkspaceLayoutStateChange<T> {
+    /**
+     * The leaf whose value changed, or `null` for the workspace scope or a leaf no longer in the layout.
+     */
+    readonly leaf: null | WorkspaceLeaf;
+    /**
+     * The id of the leaf whose value changed, or `null` for the workspace scope.
+     */
+    readonly leafId: null | string;
+    /**
+     * The value before the change, as {@link WorkspaceLayoutStateKey.get} read it.
+     */
+    readonly oldValue: T;
+    /**
+     * The value after the change, as {@link WorkspaceLayoutStateKey.get} reads it.
+     */
+    readonly value: T;
+}
+/**
+ * Parameters for {@link WorkspaceLayoutStateComponent}.
+ */
+export interface WorkspaceLayoutStateComponentConstructorParams {
+    /**
+     * The Obsidian app instance.
+     */
+    readonly app: App;
+    /**
+     * The id of the plugin the values belong to. Every value is namespaced by it.
+     */
+    readonly pluginId: string;
+}
+/**
+ * A typed handle to one layout-scoped key.
+ *
+ * Every method takes an optional leaf. Without one, the value belongs to the whole layout (the workspace scope).
+ *
+ * @typeParam T - The value type.
+ */
+export interface WorkspaceLayoutStateKey<T> {
+    /**
+     * Reads the value: a clone of the stored one, or of the default when nothing is stored or the stored value fails the
+     * key's guard.
+     *
+     * @param leaf - The leaf, or nothing for the workspace scope.
+     * @returns The value.
+     */
+    readonly get: (leaf?: WorkspaceLeaf) => T;
+    /**
+     * Checks whether a value is stored, valid or not.
+     *
+     * @param leaf - The leaf, or nothing for the workspace scope.
+     * @returns Whether a value is stored.
+     */
+    readonly has: (leaf?: WorkspaceLeaf) => boolean;
+    /**
+     * The key name, unique within the plugin.
+     */
+    readonly key: string;
+    /**
+     * Subscribes to changes of this key made through `set` or `unset`, in any scope and from any copy of the library. A
+     * layout load is reported through {@link WorkspaceLayoutStateComponent.onLayoutLoad} instead.
+     *
+     * @param callback - Called after each change.
+     * @returns A function that unsubscribes. Unloading the component unsubscribes too.
+     */
+    readonly onChange: (callback: (change: WorkspaceLayoutStateChange<T>) => void) => () => void;
+    /**
+     * Stores a clone of the value and requests a layout save. Storing a value equal to the stored one does nothing.
+     *
+     * @param value - The value. It must be JSON-safe; `null` is stored as `null`.
+     * @param leaf - The leaf, or nothing for the workspace scope.
+     * @throws A `TypeError` if the value is not JSON-safe.
+     */
+    readonly set: (value: T, leaf?: WorkspaceLeaf) => void;
+    /**
+     * Removes the stored value, so `get` reads the default again, and requests a layout save.
+     *
+     * @param leaf - The leaf, or nothing for the workspace scope.
+     */
+    readonly unset: (leaf?: WorkspaceLeaf) => void;
+}
+/**
+ * Defines a layout-scoped key.
+ *
+ * @typeParam T - The value type.
+ */
+export interface WorkspaceLayoutStateKeyDefinition<T> {
+    /**
+     * The value read when nothing valid is stored.
+     */
+    readonly defaultValue: T;
+    /**
+     * Checks a stored value. A value that fails reads as the default and stays stored until it is replaced or unset.
+     *
+     * @default Accepts every JSON value.
+     */
+    readonly isValid?: (value: unknown) => value is T;
+    /**
+     * The key name, unique within the plugin.
+     */
+    readonly key: string;
+}
+/**
+ * One plugin's records. Fields a newer copy adds are preserved.
+ */
+export interface WorkspaceLayoutStatePluginRecord {
+    /**
+     * The values by leaf id, then by key.
+     */
+    readonly leaves: Record<string, JsonRecord>;
+    /**
+     * Fields a newer copy of the library added.
+     */
+    readonly [field: string]: unknown;
+    /**
+     * The workspace-scope values by key.
+     */
+    readonly workspace: JsonRecord;
+}
+/**
+ * The record persisted under {@link WORKSPACE_LAYOUT_STATE_LAYOUT_KEY}. Fields a newer copy adds are preserved.
+ */
+export interface WorkspaceLayoutStateRecord {
+    /**
+     * The records by plugin id.
+     */
+    readonly plugins: Record<string, WorkspaceLayoutStatePluginRecord>;
+    /**
+     * Fields a newer copy of the library added.
+     */
+    readonly [field: string]: unknown;
+}
+type JsonRecord = Record<string, JsonValue>;
+/**
+ * Keeps a plugin's layout-scoped values in the workspace layout, so saved workspaces each restore their own.
+ *
+ * Any number of these, in any number of plugins, share one installation per {@link App}. Values are restored when a
+ * layout loads, which REPLACES every value: write them after {@link Workspace.onLayoutReady}, and re-read them in
+ * {@link onLayoutLoad}.
+ */
+export declare class WorkspaceLayoutStateComponent extends ComponentEx {
+    /**
+     * The Obsidian app instance.
+     */
+    protected readonly app: App;
+    /**
+     * The id of the plugin the values belong to.
+     */
+    protected readonly pluginId: string;
+    private readonly layoutLoadListeners;
+    private readonly recordChangeListeners;
+    /**
+     * Creates a new workspace layout state component.
+     *
+     * @param params - The parameters.
+     * @throws A `TypeError` if the plugin id is empty.
+     */
+    constructor(params: WorkspaceLayoutStateComponentConstructorParams);
+    /**
+     * Defines a typed key.
+     *
+     * @typeParam T - The value type.
+     * @param definition - The key definition.
+     * @returns The key handle.
+     * @throws A `TypeError` if the key is empty or the default value is not JSON-safe.
+     */
+    defineKey<T>(definition: WorkspaceLayoutStateKeyDefinition<T>): WorkspaceLayoutStateKey<T>;
+    /**
+     * Subscribes to layout loads: a saved workspace loaded, the layout restored at startup, or the saved layout read when
+     * the component is first loaded after layout-ready. Every value may have changed.
+     *
+     * @param callback - Called after the layout is loaded, once its leaves exist.
+     * @returns A function that unsubscribes. Unloading the component unsubscribes too.
+     */
+    onLayoutLoad(callback: () => void): () => void;
+    /**
+     * Subscribes to the shared installation, installing it when nobody has yet.
+     */
+    onload(): void;
+    private subscribeToRecordChanges;
+}
+/**
+ * Parses a persisted record. A part that is malformed is dropped one level at a time: a malformed record reads as
+ * empty, a malformed plugin record drops only that plugin, and a malformed leaf bucket drops only that leaf. Fields this
+ * copy does not know are kept.
+ *
+ * @param value - The value found under {@link WORKSPACE_LAYOUT_STATE_LAYOUT_KEY}.
+ * @returns The parsed record, sharing nothing with the input.
+ */
+export declare function parseWorkspaceLayoutStateRecord(value: unknown): WorkspaceLayoutStateRecord;
+/**
+ * Builds the record to persist into a serialized layout: leaf buckets for leaves absent from the layout are left out,
+ * and so are plugins with nothing left.
+ *
+ * @param record - The current record.
+ * @param layout - The serialized layout.
+ * @returns The record to persist, or `null` when there is nothing to persist.
+ */
+export declare function serializeWorkspaceLayoutStateRecord(record: WorkspaceLayoutStateRecord, layout: unknown): null | WorkspaceLayoutStateRecord;
+export {};