@mnaoumov/obsidian-lib 10.11.0 → 11.0.0

package/dist/lib/cjs/plugin/plugin-instance.d.cts

@@ -0,0 +1,258 @@
+/// <reference path="../library-references.d.cts" />
+/// <reference lib="dom" />
+/**
+ * @file
+ *
+ * Another plugin's INSTANCE: whether it is there, waiting for it, and asking the user to bring it in.
+ *
+ * This is the path for a plugin that publishes nothing through the library's registry, which is most of
+ * them. A provider that does publish is better reached through `watchPluginApi` (`./plugin-api.ts`): its
+ * reference is live, version-negotiated and revoked when the provider goes away, none of which a bare
+ * instance offers. And a plugin that must STOP running when another one goes away declares it through
+ * `PluginBase.getPluginDependencies()`, whose gate owns that teardown — {@link requirePlugin} is a one-shot
+ * wait, not a second dependency system.
+ *
+ * What "loaded" can and cannot mean, read from Obsidian `1.15.1`:
+ *
+ * - `Plugins.loadPlugin` stores the instance in `app.plugins.plugins` BEFORE it awaits `plugin.load()`, and
+ *   `Plugin.load` sets `_loaded` before it awaits `onload()`. So `app.plugins.getPlugin(id)` can return a
+ *   plugin whose `onload` is still running, and `_loaded` cannot tell the two apart.
+ *   `Plugins.enablePlugin` brackets the load with `loadingPluginId`, which is the one signal that does, so
+ *   an instance whose id is `loadingPluginId` reads as {@link PluginAvailability.Loading}.
+ * - `onload` having settled is the most anything can promise. A plugin that starts further work from
+ *   `onload` without awaiting it, or waits for layout-ready, is "loaded" before that work is done, and
+ *   Obsidian has no hook saying every plugin has finished initializing. A plugin built on this library
+ *   says more through the `obsidian-lib:plugin-loaded` broadcast, which follows its published APIs.
+ * - `app.plugins` is an `Events` source that triggers `changed`, debounced by one macrotask, after every
+ *   enable, disable, install, uninstall and manifest reload. That is what a wait subscribes to, so nothing
+ *   here polls. It fires after `enablePlugin` returned, when `loadingPluginId` is `null` again.
+ *
+ * A type argument alone is a caller's ASSERTION about the instance, not a check: nothing at runtime knows
+ * what `TPlugin` is. Pass `isPlugin` to have the shape verified; an instance failing it reads as
+ * {@link PluginAvailability.ShapeMismatch}, the usual sign of a release that renamed what the caller uses.
+ */
+import type { App, Plugin } from 'obsidian' with { 'resolution-mode': 'import' };
+import { Component } from 'obsidian';
+import type { PluginNoticeComponent } from '../components/plugin-notice-component.cjs';
+/**
+ * The event `app.plugins` triggers after every enable, disable, install, uninstall and manifest reload.
+ *
+ * Read from Obsidian `1.15.1`: `didChange` triggers it debounced by one macrotask, so several changes in one
+ * task arrive as one event, after `enablePlugin` / `disablePlugin` returned.
+ */
+export declare const PLUGINS_CHANGED_EVENT_NAME = "changed";
+/**
+ * Whether another plugin's instance can be used right now, and if not, why.
+ */
+export declare enum PluginAvailability {
+    /**
+     * Loaded, `onload` settled, and every declared requirement met.
+     */
+    Available = "available",
+    /**
+     * Running at a release whose `manifest.version` cannot be parsed, while the caller declared a
+     * {@link GetPluginAvailabilityParams.minPluginVersion}. Counts as unavailable, because failing closed is the
+     * safe direction.
+     */
+    InvalidVersion = "invalidVersion",
+    /**
+     * The instance exists but its `onload` has not settled yet.
+     */
+    Loading = "loading",
+    /**
+     * Installed but neither enabled nor running.
+     */
+    NotEnabled = "notEnabled",
+    /**
+     * Not installed in this vault.
+     */
+    NotInstalled = "notInstalled",
+    /**
+     * Installed and enabled in the configuration, but no instance is running. At startup that is a plugin
+     * Obsidian has not reached yet; later it is one that failed to load, or one switched off by a disable that
+     * does not touch the configuration.
+     */
+    NotLoaded = "notLoaded",
+    /**
+     * Running at a release older than the caller's {@link GetPluginAvailabilityParams.minPluginVersion}.
+     */
+    Outdated = "outdated",
+    /**
+     * Running, but the caller's {@link GetPluginAvailabilityParams.isPlugin} rejected the instance.
+     */
+    ShapeMismatch = "shapeMismatch"
+}
+/**
+ * Parameters for {@link getLoadedPlugin}.
+ *
+ * @typeParam TPlugin - The plugin type the caller expects.
+ */
+export type GetLoadedPluginParams<TPlugin extends Plugin = Plugin> = GetPluginAvailabilityParams<TPlugin>;
+/**
+ * Parameters for {@link getPluginAvailability}.
+ *
+ * @typeParam TPlugin - The plugin type the caller expects.
+ */
+export interface GetPluginAvailabilityParams<TPlugin extends Plugin = Plugin> {
+    /**
+     * The Obsidian app instance.
+     */
+    readonly app: App;
+    /**
+     * Verifies that the running instance is the shape the caller uses. Without it, `TPlugin` is an
+     * assertion nothing checks.
+     *
+     * @param plugin - The running instance.
+     * @returns Whether the instance is a `TPlugin`.
+     */
+    readonly isPlugin?: (plugin: Plugin) => plugin is TPlugin;
+    /**
+     * The oldest release of the plugin the caller works with, compared with its `manifest.version`. This is
+     * a plugin RELEASE, never an API contract version: a provider publishing a versioned contract is reached
+     * through `watchPluginApi`'s `apiVersionRange` instead.
+     */
+    readonly minPluginVersion?: string;
+    /**
+     * The `manifest.id` of the plugin.
+     */
+    readonly pluginId: string;
+}
+/**
+ * Parameters for the {@link PluginInstanceUnavailableError} constructor.
+ */
+export interface PluginInstanceUnavailableErrorConstructorParams {
+    /**
+     * Why the plugin was unavailable when the wait gave up.
+     */
+    readonly availability: PluginAvailability;
+    /**
+     * The `manifest.id` of the plugin.
+     */
+    readonly pluginId: string;
+}
+/**
+ * Parameters for {@link requirePlugin}.
+ *
+ * @typeParam TPlugin - The plugin type the caller expects.
+ */
+export interface RequirePluginParams<TPlugin extends Plugin = Plugin> extends GetPluginAvailabilityParams<TPlugin> {
+    /**
+     * Ends the wait early; the promise rejects with the signal's reason.
+     */
+    readonly abortSignal?: AbortSignal;
+    /**
+     * The component owning the wait and its notice. Its unload ends both, rejecting the promise.
+     */
+    readonly component: Component;
+    /**
+     * The display name of the required plugin, shown to the user.
+     */
+    readonly pluginName: string;
+    /**
+     * The asking plugin's notice component, which shows what is missing and the button that fixes it.
+     */
+    readonly pluginNoticeComponent: PluginNoticeComponent;
+    /**
+     * The display name of the asking plugin, named in the notice.
+     */
+    readonly requestingPluginName: string;
+    /**
+     * How long to wait before giving up. By default the wait lasts until the user repairs the plugin, the
+     * {@link RequirePluginParams.abortSignal} aborts or the {@link RequirePluginParams.component} unloads.
+     */
+    readonly timeoutInMilliseconds?: number;
+}
+/**
+ * Parameters for {@link waitForPlugin}.
+ *
+ * @typeParam TPlugin - The plugin type the caller expects.
+ */
+export interface WaitForPluginParams<TPlugin extends Plugin = Plugin> extends GetPluginAvailabilityParams<TPlugin> {
+    /**
+     * Ends the wait early; the promise rejects with the signal's reason.
+     */
+    readonly abortSignal?: AbortSignal;
+    /**
+     * A component whose unload ends the wait, rejecting the promise. Pass the waiting plugin, or the
+     * component that will use the instance, so a wait never outlives its consumer.
+     */
+    readonly component?: Component;
+    /**
+     * How long to wait before rejecting with a {@link PluginInstanceUnavailableError}.
+     *
+     * @default 10000
+     */
+    readonly timeoutInMilliseconds?: number;
+}
+/**
+ * Thrown when a plugin did not become available before a wait gave up.
+ */
+export declare class PluginInstanceUnavailableError extends Error {
+    /**
+     * Why the plugin was unavailable when the wait gave up.
+     */
+    readonly availability: PluginAvailability;
+    /**
+     * The `manifest.id` of the plugin.
+     */
+    readonly pluginId: string;
+    /**
+     * Creates an instance of {@link PluginInstanceUnavailableError}.
+     *
+     * @param params - The constructor parameters.
+     */
+    constructor(params: PluginInstanceUnavailableErrorConstructorParams);
+}
+/**
+ * Returns another plugin's instance when it is {@link PluginAvailability.Available}, and `null` otherwise.
+ *
+ * Unlike `app.plugins.getPlugin`, it never returns an instance whose `onload` is still running.
+ *
+ * @typeParam TPlugin - The plugin type the caller expects; checked only through `isPlugin`.
+ * @param params - The {@link GetPluginAvailabilityParams}.
+ * @returns The instance, or `null`.
+ */
+export declare function getLoadedPlugin<TPlugin extends Plugin = Plugin>(params: GetLoadedPluginParams<NoInfer<TPlugin>>): null | TPlugin;
+/**
+ * Reads whether another plugin's instance can be used right now, and if not, why.
+ *
+ * @typeParam TPlugin - The plugin type the caller expects.
+ * @param params - The {@link GetPluginAvailabilityParams}.
+ * @returns The {@link PluginAvailability}.
+ */
+export declare function getPluginAvailability<TPlugin extends Plugin = Plugin>(params: GetPluginAvailabilityParams<NoInfer<TPlugin>>): PluginAvailability;
+/**
+ * Waits for another plugin to become {@link PluginAvailability.Available}, asking the user to repair it
+ * while it is not.
+ *
+ * Resolves at once when it already is. Otherwise, once the workspace layout is ready — before that, a
+ * plugin Obsidian has not loaded yet is indistinguishable from a missing one — a notice says what is wrong
+ * and offers the matching repair: install, enable, or update, plus a way to the community plugins list.
+ * The notice follows the state as it changes and goes away when the wait settles. A repair that fails is
+ * reported and leaves the wait running, so the user can try again or fix it by hand.
+ *
+ * The promise settles ONCE. It does not watch the plugin afterwards: a consumer that must stop when the
+ * plugin goes away declares a dependency through `PluginBase.getPluginDependencies()` instead.
+ *
+ * @typeParam TPlugin - The plugin type the caller expects; checked only through `isPlugin`.
+ * @param params - The {@link RequirePluginParams}.
+ * @returns A {@link Promise} resolving with the instance.
+ * @throws The abort reason, or an error naming the unloaded component, when the wait is ended early.
+ * @throws {@link PluginInstanceUnavailableError} When {@link RequirePluginParams.timeoutInMilliseconds} elapses.
+ */
+export declare function requirePlugin<TPlugin extends Plugin = Plugin>(params: RequirePluginParams<NoInfer<TPlugin>>): Promise<TPlugin>;
+/**
+ * Waits for another plugin to become {@link PluginAvailability.Available}.
+ *
+ * Resolves at once when it already is, which covers a consumer reloaded after its dependency. Otherwise it
+ * re-reads the state on every `app.plugins` `changed` and every `obsidian-lib:plugin-loaded` broadcast, so a
+ * plugin enabled, updated or reloaded later is picked up with no polling. It subscribes before its first
+ * read, so a change landing in between cannot be missed. Every listener and timer is removed when it settles.
+ *
+ * @typeParam TPlugin - The plugin type the caller expects; checked only through `isPlugin`.
+ * @param params - The {@link WaitForPluginParams}.
+ * @returns A {@link Promise} resolving with the instance.
+ * @throws The abort reason, or an error naming the unloaded component, when the wait is ended early.
+ * @throws {@link PluginInstanceUnavailableError} When the timeout elapses, carrying the availability at that moment.
+ */
+export declare function waitForPlugin<TPlugin extends Plugin = Plugin>(params: WaitForPluginParams<NoInfer<TPlugin>>): Promise<TPlugin>;

package/dist/lib/cjs/plugin/plugin-lifecycle-events.cjs

@@ -104,4 +104,4 @@ function triggerPluginLifecycleEvent(params) {
   PLUGIN_UNLOADED_EVENT_NAME,
   triggerPluginLifecycleEvent
 });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9wbHVnaW4vcGx1Z2luLWxpZmVjeWNsZS1ldmVudHMudHMiXSwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRoZSBsaWZlY3ljbGUgYnJvYWRjYXN0IGV2ZXJ5IHtAbGluayBQbHVnaW5CYXNlfSBtYWtlczogYG9ic2lkaWFuLWxpYjpwbHVnaW4tbG9hZGVkYCB3aGVuIGl0IGhhc1xuICogZmluaXNoZWQgbG9hZGluZyBhbmQgYG9ic2lkaWFuLWxpYjpwbHVnaW4tdW5sb2FkZWRgIHdoZW4gaXQgZ29lcyBhd2F5LlxuICpcbiAqIE9ic2lkaWFuIGdpdmVzIGEgcGx1Z2luIG5vIHdheSB0byBsZWFybiB0aGF0IEFOT1RIRVIgcGx1Z2luIHdhcyBlbmFibGVkIG9yIGRpc2FibGVkIOKAlCB0aGVyZSBpcyBubyBzdWNoXG4gKiBldmVudCBvbiBgYXBwLnBsdWdpbnNgLCBhbmQgYSBwbHVnaW4ncyBvd24gYEV2ZW50c2Agc291cmNlIGNhbm5vdCBoZWxwIGEgbGlzdGVuZXIgdGhhdCBkb2VzIG5vdCB5ZXQgaG9sZFxuICogdGhlIGluc3RhbmNlLiBTbyB0aGUgYnJvYWRjYXN0IGdvZXMgdGhyb3VnaCBgYXBwLndvcmtzcGFjZWAsIHdoaWNoIGlzIG9uZSBvYmplY3QgZXZlcnkgcGx1Z2luIGluIHRoZVxuICogdmF1bHQgY2FuIHJlYWNoLiBEZWxpYmVyYXRlbHkgTk9UIHRoZSBgZ2xvYmFsVGhpcy5fX29ic2lkaWFuTGliYCBiYWcgdGhlIHJlc3Qgb2YgdGhlIGxpYnJhcnkgc2hhcmVzXG4gKiBpdHMgc3RhdGUgdGhyb3VnaDogYSBsaXN0ZW5lciB0aGVyZSBuZWVkcyBpdHMgb3duIGNvcHkgb2YgdGhpcyBsaWJyYXJ5LCBhbmQgdGhlc2UgZXZlbnRzIGFyZSBtZWFudCB0byBiZVxuICogY29uc3VtYWJsZSBieSBhbnkgcGx1Z2luIGF0IGFsbC5cbiAqXG4gKiBUaGUgbmFtZXMgYXJlIHBhc3QgdGVuc2UgYmVjYXVzZSBhIGJyb2FkY2FzdCBzdGF0ZXMgc29tZXRoaW5nIHRoYXQgaGFzIGFscmVhZHkgaGFwcGVuZWQuIGBsb2FkZWRgIGluXG4gKiBwYXJ0aWN1bGFyIGNhcnJpZXMgYSBndWFyYW50ZWU6IGl0IGlzIHRyaWdnZXJlZCBvbmx5IGFmdGVyIGV2ZXJ5IEFQSSB0aGUgcGx1Z2luIGRlY2xhcmVzIGhhcyBiZWVuXG4gKiBwdWJsaXNoZWQsIHNvIGEgbGlzdGVuZXIgbWF5IGNhbGwgdGhlbSBpbW1lZGlhdGVseS5cbiAqXG4gKiBCb3RoIHRoZSBldmVudCBuYW1lcyBhbmQge0BsaW5rIFBsdWdpbkxpZmVjeWNsZUV2ZW50UGF5bG9hZH0gYXJlIGEgQ1JPU1MtVkVSU0lPTiBDT05UUkFDVC4gQ29waWVzIG9mXG4gKiB0aGlzIGxpYnJhcnkgYXQgZGlmZmVyZW50IHZlcnNpb25zIHB1Ymxpc2ggYW5kIGNvbnN1bWUgdGhlbSBzaWRlIGJ5IHNpZGUgaW4gb25lIHZhdWx0LCBzbyBuZWl0aGVyIG1heVxuICogY2hhbmdlIGluY29tcGF0aWJseTogcGxhaW4gZGF0YSBvbmx5LCBhbmQgbmV3IHBheWxvYWQgZmllbGRzIG9ubHkgZXZlciBhZGRlZC5cbiAqXG4gKiBUaGF0IGNvbnRyYWN0IGlzIGFsc28gUFVCTElTSEVELCBhcyBvZiB0aGUgYFBsdWdpbiBBUEkgcHJvdG9jb2xgIGd1aWRlOiB0aGlyZC1wYXJ0eSBwbHVnaW5zIHRoYXQgd2lsbFxuICogbmV2ZXIgaW5zdGFsbCB0aGlzIGxpYnJhcnkgYXJlIHRvbGQgdG8gaGFyZGNvZGUgdGhlc2Ugc3RyaW5ncyBhbmQgdGhpcyBwYXlsb2FkIHNoYXBlLiBQdWJsaXNoaW5nIGl0XG4gKiBhZGRlZCBubyBuZXcgY29uc3RyYWludCDigJQgdGhlIGNyb3NzLWNvcHkgb25lIGFib3ZlIGFscmVhZHkgZm9yYmFkZSBldmVyeSBjaGFuZ2UgYW4gb3V0c2lkZXIgY291bGRcbiAqIG5vdGljZS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IEFwcCB9IGZyb20gJ29ic2lkaWFuJztcblxuLyoqXG4gKiBUaGUgbmFtZSBvZiBlaXRoZXIgbGlmZWN5Y2xlIGV2ZW50LlxuICovXG5leHBvcnQgdHlwZSBQbHVnaW5MaWZlY3ljbGVFdmVudE5hbWUgPSB0eXBlb2YgUExVR0lOX0xPQURFRF9FVkVOVF9OQU1FIHwgdHlwZW9mIFBMVUdJTl9VTkxPQURFRF9FVkVOVF9OQU1FO1xuXG4vKipcbiAqIFRoZSBwYXlsb2FkIG9mIHtAbGluayBQTFVHSU5fTE9BREVEX0VWRU5UX05BTUV9IGFuZCB7QGxpbmsgUExVR0lOX1VOTE9BREVEX0VWRU5UX05BTUV9LlxuICpcbiAqIFBsYWluIGRhdGEgYnkgZGVzaWduIOKAlCBubyBjbGFzcyBpbnN0YW5jZXMgYW5kIG5vIHR5cGVzIG93bmVkIGJ5IHRoaXMgbGlicmFyeSDigJQgYmVjYXVzZSBpdCBjcm9zc2VzXG4gKiBiZXR3ZWVuIGluZGVwZW5kZW50bHkgYnVuZGxlZCBjb3BpZXMgb2YgaXQsIGFuZCBiZXR3ZWVuIHBsdWdpbnMgdGhhdCBkbyBub3QgdXNlIGl0IGF0IGFsbC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBQbHVnaW5MaWZlY3ljbGVFdmVudFBheWxvYWQge1xuICAvKipcbiAgICogVGhlIGNvbnRyYWN0IHZlcnNpb25zIHRoZSBwbHVnaW4gcHVibGlzaGVkLCBlbXB0eSB3aGVuIGl0IHB1Ymxpc2hlcyBubyBBUEkuXG4gICAqXG4gICAqIEFuIGFycmF5IHJhdGhlciB0aGFuIGEgc2luZ2xlIHZlcnNpb24gYmVjYXVzZSBhIHByb3ZpZGVyIG1heSBwdWJsaXNoIHNldmVyYWwgY29udHJhY3QgdmVyc2lvbnMgc2lkZSBieVxuICAgKiBzaWRlLCBzbyBjb25zdW1lcnMgcGlubmVkIHRvIGFuIG9sZGVyIHJhbmdlIGtlZXAgd29ya2luZyBhY3Jvc3MgYSBicmVha2luZyBjaGFuZ2UuXG4gICAqXG4gICAqIFRoZSBBUEkgb2JqZWN0cyB0aGVtc2VsdmVzIGFyZSBkZWxpYmVyYXRlbHkgTk9UIGhlcmUuIEEgaGFuZGxlIGRlbGl2ZXJlZCBieSBhIG9uZS1zaG90IGV2ZW50IGlzIGFcbiAgICogcHJvYmU6IGl0IGFuc3dlcnMgXCJub3dcIiBhbmQgbmV2ZXIgc2F5cyB3aGVuIFwibm93XCIgY2hhbmdlZCwgYW5kIG9uZSB0aGF0IG91dGxpdmVzIHRoZSBwcm92aWRlciBpc1xuICAgKiBleGFjdGx5IHRoZSBzdGFsZSBoYW5kbGUgdGhlIHBsdWdpbi1hcGkgcmVnaXN0cnkncyByZXZvY2FibGUgaGFuZGxlcyBleGlzdCB0byBwcmV2ZW50LiBSZWFjaCB0aGUgQVBJXG4gICAqIHRocm91Z2ggYHdhdGNoUGx1Z2luQXBpYCBpbnN0ZWFkLCB3aG9zZSByZWZlcmVuY2Ugc3RheXMgY29ycmVjdCBhY3Jvc3MgdW5sb2FkIGFuZCByZS1lbmFibGUuXG4gICAqL1xuICByZWFkb25seSBhcGlWZXJzaW9uczogcmVhZG9ubHkgc3RyaW5nW107XG5cbiAgLyoqXG4gICAqIFRoZSBpZHMgb2YgdGhlIHBsdWdpbnMgdGhpcyBvbmUgZGVjbGFyZXMgYXMgbWFuZGF0b3J5IGRlcGVuZGVuY2llcywgZW1wdHkgd2hlbiBpdCBkZWNsYXJlcyBub25lLlxuICAgKlxuICAgKiBQcmVzZW50IHNvIHRoZSByZWxhdGlvbnNoaXAgY2FuIGJlIHJlYWQgZnJvbSB0aGUgT1RIRVIgZW5kOiBhIHByb3ZpZGVyIGhhcyBubyB3YXkgdG8gYXNrIHdobyBkZXBlbmRzXG4gICAqIG9uIGl0IOKAlCB0aGUgcmVnaXN0cnkgb25seSBhbnN3ZXJzIGNvbnN1bWVyLXRvLXByb3ZpZGVyIOKAlCBhbmQgXCJ3aGljaCBpbnN0YWxsZWQgcGx1Z2lucyBuZWVkIHRoaXMgb25lXCJcbiAgICogaXMgd2hhdCBsZXRzIGEgcHJvdmlkZXIncyBzZXR0aW5ncyB0YWIgdGVsbCB0aGUgdXNlciB3aHkgaXQgaXMgaW4gdGhlaXIgdmF1bHQgYXQgYWxsLlxuICAgKi9cbiAgcmVhZG9ubHkgZGVwZW5kZW5jeVBsdWdpbklkczogcmVhZG9ubHkgc3RyaW5nW107XG5cbiAgLyoqXG4gICAqIFRoZSBwbHVnaW4ncyBgbWFuaWZlc3QuaWRgLlxuICAgKi9cbiAgcmVhZG9ubHkgcGx1Z2luSWQ6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIHBsdWdpbidzIGBtYW5pZmVzdC5uYW1lYCwgZm9yIGRpc3BsYXkuXG4gICAqL1xuICByZWFkb25seSBwbHVnaW5OYW1lOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBwbHVnaW4ncyBgbWFuaWZlc3QudmVyc2lvbmAuXG4gICAqL1xuICByZWFkb25seSBwbHVnaW5WZXJzaW9uOiBzdHJpbmc7XG59XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIHRyaWdnZXJQbHVnaW5MaWZlY3ljbGVFdmVudH0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgVHJpZ2dlclBsdWdpbkxpZmVjeWNsZUV2ZW50UGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2Ugd2hvc2Ugd29ya3NwYWNlIGNhcnJpZXMgdGhlIGJyb2FkY2FzdC5cbiAgICovXG4gIHJlYWRvbmx5IGFwcDogQXBwO1xuXG4gIC8qKlxuICAgKiBUaGUgZXZlbnQgdG8gdHJpZ2dlci5cbiAgICovXG4gIHJlYWRvbmx5IG5hbWU6IFBsdWdpbkxpZmVjeWNsZUV2ZW50TmFtZTtcblxuICAvKipcbiAgICogVGhlIHBheWxvYWQgZGVzY3JpYmluZyB0aGUgcGx1Z2luLlxuICAgKi9cbiAgcmVhZG9ubHkgcGF5bG9hZDogUGx1Z2luTGlmZWN5Y2xlRXZlbnRQYXlsb2FkO1xufVxuXG4vKipcbiAqIFRyaWdnZXJlZCBvbmNlIGEgcGx1Z2luIGhhcyBmaW5pc2hlZCBsb2FkaW5nIEFORCBwdWJsaXNoZWQgZXZlcnkgQVBJIGl0IGRlY2xhcmVzLCBzbyBhIGxpc3RlbmVyIG1heSBjYWxsXG4gKiB0aG9zZSBBUElzIGltbWVkaWF0ZWx5LlxuICpcbiAqIE5hbWVzcGFjZWQgYnkgdGhlIHBhY2thZ2UgbmFtZSByYXRoZXIgdGhhbiBieSBhbiBhYmJyZXZpYXRpb24gb2YgaXQ6IHRoZSBldmVudCBpcyBnbG9iYWwgdG8gdGhlIHZhdWx0XG4gKiBhbmQgYWltZWQgYXQgcGx1Z2luIGF1dGhvcnMgd2hvIGhhdmUgbmV2ZXIgaGVhcmQgb2YgdGhpcyBsaWJyYXJ5LCBzbyB0aGUgcHJlZml4IGhhcyB0byBpZGVudGlmeSBpdHNlbGYuXG4gKi9cbmV4cG9ydCBjb25zdCBQTFVHSU5fTE9BREVEX0VWRU5UX05BTUUgPSAnb2JzaWRpYW4tbGliOnBsdWdpbi1sb2FkZWQnO1xuXG4vKipcbiAqIFRyaWdnZXJlZCBhcyBhIHBsdWdpbiB1bmxvYWRzIOKAlCB3aGV0aGVyIHRoZSB1c2VyIGRpc2FibGVkIGl0LCB1bmluc3RhbGxlZCBpdCwgb3IgT2JzaWRpYW4gaXMgc2h1dHRpbmdcbiAqIGRvd24uIEl0cyBBUElzIGFyZSByZXZva2VkIGJ5IHRoZSB0aW1lIGEgbGlzdGVuZXIgcnVucy5cbiAqL1xuZXhwb3J0IGNvbnN0IFBMVUdJTl9VTkxPQURFRF9FVkVOVF9OQU1FID0gJ29ic2lkaWFuLWxpYjpwbHVnaW4tdW5sb2FkZWQnO1xuXG5kZWNsYXJlIG1vZHVsZSAnb2JzaWRpYW4nIHtcbiAgaW50ZXJmYWNlIFdvcmtzcGFjZSB7XG4gICAgLyoqXG4gICAgICogU3Vic2NyaWJlcyB0byBhIHBsdWdpbiBmaW5pc2hpbmcgaXRzIGxvYWQsIG9yIHRvIG9uZSB1bmxvYWRpbmcuXG4gICAgICpcbiAgICAgKiBAcGFyYW0gbmFtZSAtIFNob3VsZCBiZSB7QGxpbmsgUExVR0lOX0xPQURFRF9FVkVOVF9OQU1FfSBvciB7QGxpbmsgUExVR0lOX1VOTE9BREVEX0VWRU5UX05BTUV9LlxuICAgICAqIEBwYXJhbSBjYWxsYmFjayAtIFRoZSBjYWxsYmFjayByZWNlaXZpbmcgdGhlIHBsdWdpbidzIHBheWxvYWQuXG4gICAgICogQHBhcmFtIGNvbnRleHQgLSBUaGUgY29udGV4dCBwYXNzZWQgYXMgYHRoaXNgIHRvIHRoZSBgY2FsbGJhY2tgIGZ1bmN0aW9uLlxuICAgICAqIEByZXR1cm5zIFRoZSBldmVudCByZWZlcmVuY2UuXG4gICAgICovXG4gICAgLypcbiAgICAgKiBBbiBhdWdtZW50YXRpb24gb2YgYW4gRVhJU1RJTkcgb3ZlcmxvYWQgc2V0IGhhcyB0byBzdGF5IGEgbWV0aG9kIHNpZ25hdHVyZS4gQSBwcm9wZXJ0eSBtZW1iZXIgZG9lcyBub3QgbWVyZ2UgaW50b1xuICAgICAqIGBXb3Jrc3BhY2Uub25gJ3Mgb3ZlcmxvYWRzLCBhbmQgVHlwZVNjcmlwdCBzYXlzIHNvIG5vd2hlcmUgbmVhciBoZXJlOiB0aGUgZGVjbGFyYXRpb24gaXRzZWxmIGNvbXBpbGVzLCBhbmQgZXZlcnlcbiAgICAgKiBjYWxsIHNpdGUgbG9zZXMgdGhlIHNpZ25hdHVyZSBpbnN0ZWFkIOKAlCBgb24oUExVR0lOX0xPQURFRF9FVkVOVF9OQU1FLCAuLi4pYCBmYWlscyB3aXRoIFwidGhlIGxhc3Qgb3ZlcmxvYWQgZ2F2ZSB0aGVcbiAgICAgKiBmb2xsb3dpbmcgZXJyb3JcIi4gVGhlIHJ1bGUgcmVwb3J0cyB0aGlzIG9uZSB3aXRob3V0IGEgZml4IGZvciB0aGUgc2FtZSByZWFzb24sIHNvIHRoZSBkaXNhYmxlIGJlbG93IGlzIHRoZSBhbnN3ZXJcbiAgICAgKiByYXRoZXIgdGhhbiBhIGRlZmVycmFsLlxuICAgICAqL1xuICAgIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBAdHlwZXNjcmlwdC1lc2xpbnQvbWV0aG9kLXNpZ25hdHVyZS1zdHlsZSAtLSBBIHByb3BlcnR5IG1lbWJlciBkb2VzIG5vdCBtZXJnZSBpbnRvIGFuIGV4aXN0aW5nIG92ZXJsb2FkIHNldC4gU2VlIGFib3ZlLlxuICAgIG9uKFxuICAgICAgbmFtZTogUGx1Z2luTGlmZWN5Y2xlRXZlbnROYW1lLFxuICAgICAgY2FsbGJhY2s6IChwYXlsb2FkOiBQbHVnaW5MaWZlY3ljbGVFdmVudFBheWxvYWQpID0+IHVua25vd24sXG4gICAgICBjb250ZXh0PzogdW5rbm93blxuICAgICk6IEV2ZW50UmVmO1xuICB9XG59XG5cbi8qKlxuICogVHJpZ2dlcnMgb25lIG9mIHRoZSB0d28gbGlmZWN5Y2xlIGV2ZW50cyBvbiB0aGUgYXBwJ3Mgd29ya3NwYWNlLlxuICpcbiAqIEEgdGhpbiB0eXBlZCB3cmFwcGVyIG92ZXIgYFdvcmtzcGFjZS50cmlnZ2VyYCwgd2hpY2ggYWNjZXB0cyBhbnkgZXZlbnQgbmFtZSBhbmQgYW55IGFyZ3VtZW50cywgc28gdGhhdCB0aGUgb25lXG4gKiBwbGFjZSBhIHBheWxvYWQgaXMgY29uc3RydWN0ZWQgaXMgY2hlY2tlZCBhZ2FpbnN0IHtAbGluayBQbHVnaW5MaWZlY3ljbGVFdmVudFBheWxvYWR9LlxuICpcbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUge0BsaW5rIFRyaWdnZXJQbHVnaW5MaWZlY3ljbGVFdmVudFBhcmFtc30uXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB0cmlnZ2VyUGx1Z2luTGlmZWN5Y2xlRXZlbnQocGFyYW1zOiBUcmlnZ2VyUGx1Z2luTGlmZWN5Y2xlRXZlbnRQYXJhbXMpOiB2b2lkIHtcbiAgY29uc3QgeyBhcHAsIG5hbWUsIHBheWxvYWQgfSA9IHBhcmFtcztcbiAgYXBwLndvcmtzcGFjZS50cmlnZ2VyKG5hbWUsIHBheWxvYWQpO1xufVxuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQTBHTyxNQUFNLDJCQUEyQjtBQU1qQyxNQUFNLDZCQUE2QjtBQW9DbkMsU0FBUyw0QkFBNEIsUUFBaUQ7QUFDM0YsUUFBTSxFQUFFLEtBQUssTUFBTSxRQUFRLElBQUk7QUFDL0IsTUFBSSxVQUFVLFFBQVEsTUFBTSxPQUFPO0FBQ3JDOyIsIm5hbWVzIjpbXX0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9wbHVnaW4vcGx1Z2luLWxpZmVjeWNsZS1ldmVudHMudHMiXSwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRoZSBsaWZlY3ljbGUgYnJvYWRjYXN0IGV2ZXJ5IHtAbGluayBQbHVnaW5CYXNlfSBtYWtlczogYG9ic2lkaWFuLWxpYjpwbHVnaW4tbG9hZGVkYCB3aGVuIGl0IGhhc1xuICogZmluaXNoZWQgbG9hZGluZyBhbmQgYG9ic2lkaWFuLWxpYjpwbHVnaW4tdW5sb2FkZWRgIHdoZW4gaXQgZ29lcyBhd2F5LlxuICpcbiAqIE9ic2lkaWFuIGRvZXMgc2F5IHRoYXQgU09NRSBwbHVnaW4gY2hhbmdlZDogcmVhZCBmcm9tIE9ic2lkaWFuIGAxLjE1LjFgLCBgYXBwLnBsdWdpbnNgIHRyaWdnZXJzXG4gKiBgY2hhbmdlZGAsIGRlYm91bmNlZCBieSBvbmUgbWFjcm90YXNrLCBhZnRlciBldmVyeSBlbmFibGUsIGRpc2FibGUsIGluc3RhbGwsIHVuaW5zdGFsbCBhbmQgbWFuaWZlc3RcbiAqIHJlbG9hZCwgYnV0IGl0IGNhcnJpZXMgbm8gcGF5bG9hZDogaXQgZG9lcyBub3Qgc2F5IHdoaWNoIHBsdWdpbiBjaGFuZ2VkLCBub3IgdGhhdCBpdHMgQVBJcyBhcmUgcHVibGlzaGVkLlxuICogVGhpcyBicm9hZGNhc3QgbmFtZXMgdGhlIHBsdWdpbiBhbmQgY29tZXMgYWZ0ZXIgaXRzIEFQSXMsIHNvIGl0IGlzIHRoZSBzaWduYWwgZm9yIFwidGhhdCBwbHVnaW4gaXMgcmVhZHlcbiAqIHRvIGNhbGxcIiwgYW5kIGBjaGFuZ2VkYCB0aGUgc2lnbmFsIGZvciBcInJlLXJlYWQgdGhlIG1hbmlmZXN0c1wiLiBUaGUgYnJvYWRjYXN0IGdvZXMgdGhyb3VnaFxuICogYGFwcC53b3Jrc3BhY2VgLCB3aGljaCBpcyBvbmUgb2JqZWN0IGV2ZXJ5IHBsdWdpbiBpbiB0aGUgdmF1bHQgY2FuIHJlYWNoLiBEZWxpYmVyYXRlbHkgTk9UIHRoZSBgZ2xvYmFsVGhpcy5fX29ic2lkaWFuTGliYCBiYWcgdGhlIHJlc3Qgb2YgdGhlIGxpYnJhcnkgc2hhcmVzXG4gKiBpdHMgc3RhdGUgdGhyb3VnaDogYSBsaXN0ZW5lciB0aGVyZSBuZWVkcyBpdHMgb3duIGNvcHkgb2YgdGhpcyBsaWJyYXJ5LCBhbmQgdGhlc2UgZXZlbnRzIGFyZSBtZWFudCB0byBiZVxuICogY29uc3VtYWJsZSBieSBhbnkgcGx1Z2luIGF0IGFsbC5cbiAqXG4gKiBUaGUgbmFtZXMgYXJlIHBhc3QgdGVuc2UgYmVjYXVzZSBhIGJyb2FkY2FzdCBzdGF0ZXMgc29tZXRoaW5nIHRoYXQgaGFzIGFscmVhZHkgaGFwcGVuZWQuIGBsb2FkZWRgIGluXG4gKiBwYXJ0aWN1bGFyIGNhcnJpZXMgYSBndWFyYW50ZWU6IGl0IGlzIHRyaWdnZXJlZCBvbmx5IGFmdGVyIGV2ZXJ5IEFQSSB0aGUgcGx1Z2luIGRlY2xhcmVzIGhhcyBiZWVuXG4gKiBwdWJsaXNoZWQsIHNvIGEgbGlzdGVuZXIgbWF5IGNhbGwgdGhlbSBpbW1lZGlhdGVseS5cbiAqXG4gKiBCb3RoIHRoZSBldmVudCBuYW1lcyBhbmQge0BsaW5rIFBsdWdpbkxpZmVjeWNsZUV2ZW50UGF5bG9hZH0gYXJlIGEgQ1JPU1MtVkVSU0lPTiBDT05UUkFDVC4gQ29waWVzIG9mXG4gKiB0aGlzIGxpYnJhcnkgYXQgZGlmZmVyZW50IHZlcnNpb25zIHB1Ymxpc2ggYW5kIGNvbnN1bWUgdGhlbSBzaWRlIGJ5IHNpZGUgaW4gb25lIHZhdWx0LCBzbyBuZWl0aGVyIG1heVxuICogY2hhbmdlIGluY29tcGF0aWJseTogcGxhaW4gZGF0YSBvbmx5LCBhbmQgbmV3IHBheWxvYWQgZmllbGRzIG9ubHkgZXZlciBhZGRlZC5cbiAqXG4gKiBUaGF0IGNvbnRyYWN0IGlzIGFsc28gUFVCTElTSEVELCBhcyBvZiB0aGUgYFBsdWdpbiBBUEkgcHJvdG9jb2xgIGd1aWRlOiB0aGlyZC1wYXJ0eSBwbHVnaW5zIHRoYXQgd2lsbFxuICogbmV2ZXIgaW5zdGFsbCB0aGlzIGxpYnJhcnkgYXJlIHRvbGQgdG8gaGFyZGNvZGUgdGhlc2Ugc3RyaW5ncyBhbmQgdGhpcyBwYXlsb2FkIHNoYXBlLiBQdWJsaXNoaW5nIGl0XG4gKiBhZGRlZCBubyBuZXcgY29uc3RyYWludCDigJQgdGhlIGNyb3NzLWNvcHkgb25lIGFib3ZlIGFscmVhZHkgZm9yYmFkZSBldmVyeSBjaGFuZ2UgYW4gb3V0c2lkZXIgY291bGRcbiAqIG5vdGljZS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IEFwcCB9IGZyb20gJ29ic2lkaWFuJztcblxuLyoqXG4gKiBUaGUgbmFtZSBvZiBlaXRoZXIgbGlmZWN5Y2xlIGV2ZW50LlxuICovXG5leHBvcnQgdHlwZSBQbHVnaW5MaWZlY3ljbGVFdmVudE5hbWUgPSB0eXBlb2YgUExVR0lOX0xPQURFRF9FVkVOVF9OQU1FIHwgdHlwZW9mIFBMVUdJTl9VTkxPQURFRF9FVkVOVF9OQU1FO1xuXG4vKipcbiAqIFRoZSBwYXlsb2FkIG9mIHtAbGluayBQTFVHSU5fTE9BREVEX0VWRU5UX05BTUV9IGFuZCB7QGxpbmsgUExVR0lOX1VOTE9BREVEX0VWRU5UX05BTUV9LlxuICpcbiAqIFBsYWluIGRhdGEgYnkgZGVzaWduIOKAlCBubyBjbGFzcyBpbnN0YW5jZXMgYW5kIG5vIHR5cGVzIG93bmVkIGJ5IHRoaXMgbGlicmFyeSDigJQgYmVjYXVzZSBpdCBjcm9zc2VzXG4gKiBiZXR3ZWVuIGluZGVwZW5kZW50bHkgYnVuZGxlZCBjb3BpZXMgb2YgaXQsIGFuZCBiZXR3ZWVuIHBsdWdpbnMgdGhhdCBkbyBub3QgdXNlIGl0IGF0IGFsbC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBQbHVnaW5MaWZlY3ljbGVFdmVudFBheWxvYWQge1xuICAvKipcbiAgICogVGhlIGNvbnRyYWN0IHZlcnNpb25zIHRoZSBwbHVnaW4gcHVibGlzaGVkLCBlbXB0eSB3aGVuIGl0IHB1Ymxpc2hlcyBubyBBUEkuXG4gICAqXG4gICAqIEFuIGFycmF5IHJhdGhlciB0aGFuIGEgc2luZ2xlIHZlcnNpb24gYmVjYXVzZSBhIHByb3ZpZGVyIG1heSBwdWJsaXNoIHNldmVyYWwgY29udHJhY3QgdmVyc2lvbnMgc2lkZSBieVxuICAgKiBzaWRlLCBzbyBjb25zdW1lcnMgcGlubmVkIHRvIGFuIG9sZGVyIHJhbmdlIGtlZXAgd29ya2luZyBhY3Jvc3MgYSBicmVha2luZyBjaGFuZ2UuXG4gICAqXG4gICAqIFRoZSBBUEkgb2JqZWN0cyB0aGVtc2VsdmVzIGFyZSBkZWxpYmVyYXRlbHkgTk9UIGhlcmUuIEEgaGFuZGxlIGRlbGl2ZXJlZCBieSBhIG9uZS1zaG90IGV2ZW50IGlzIGFcbiAgICogcHJvYmU6IGl0IGFuc3dlcnMgXCJub3dcIiBhbmQgbmV2ZXIgc2F5cyB3aGVuIFwibm93XCIgY2hhbmdlZCwgYW5kIG9uZSB0aGF0IG91dGxpdmVzIHRoZSBwcm92aWRlciBpc1xuICAgKiBleGFjdGx5IHRoZSBzdGFsZSBoYW5kbGUgdGhlIHBsdWdpbi1hcGkgcmVnaXN0cnkncyByZXZvY2FibGUgaGFuZGxlcyBleGlzdCB0byBwcmV2ZW50LiBSZWFjaCB0aGUgQVBJXG4gICAqIHRocm91Z2ggYHdhdGNoUGx1Z2luQXBpYCBpbnN0ZWFkLCB3aG9zZSByZWZlcmVuY2Ugc3RheXMgY29ycmVjdCBhY3Jvc3MgdW5sb2FkIGFuZCByZS1lbmFibGUuXG4gICAqL1xuICByZWFkb25seSBhcGlWZXJzaW9uczogcmVhZG9ubHkgc3RyaW5nW107XG5cbiAgLyoqXG4gICAqIFRoZSBpZHMgb2YgdGhlIHBsdWdpbnMgdGhpcyBvbmUgZGVjbGFyZXMgYXMgbWFuZGF0b3J5IGRlcGVuZGVuY2llcywgZW1wdHkgd2hlbiBpdCBkZWNsYXJlcyBub25lLlxuICAgKlxuICAgKiBQcmVzZW50IHNvIHRoZSByZWxhdGlvbnNoaXAgY2FuIGJlIHJlYWQgZnJvbSB0aGUgT1RIRVIgZW5kOiBhIHByb3ZpZGVyIGhhcyBubyB3YXkgdG8gYXNrIHdobyBkZXBlbmRzXG4gICAqIG9uIGl0IOKAlCB0aGUgcmVnaXN0cnkgb25seSBhbnN3ZXJzIGNvbnN1bWVyLXRvLXByb3ZpZGVyIOKAlCBhbmQgXCJ3aGljaCBpbnN0YWxsZWQgcGx1Z2lucyBuZWVkIHRoaXMgb25lXCJcbiAgICogaXMgd2hhdCBsZXRzIGEgcHJvdmlkZXIncyBzZXR0aW5ncyB0YWIgdGVsbCB0aGUgdXNlciB3aHkgaXQgaXMgaW4gdGhlaXIgdmF1bHQgYXQgYWxsLlxuICAgKi9cbiAgcmVhZG9ubHkgZGVwZW5kZW5jeVBsdWdpbklkczogcmVhZG9ubHkgc3RyaW5nW107XG5cbiAgLyoqXG4gICAqIFRoZSBwbHVnaW4ncyBgbWFuaWZlc3QuaWRgLlxuICAgKi9cbiAgcmVhZG9ubHkgcGx1Z2luSWQ6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIHBsdWdpbidzIGBtYW5pZmVzdC5uYW1lYCwgZm9yIGRpc3BsYXkuXG4gICAqL1xuICByZWFkb25seSBwbHVnaW5OYW1lOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBwbHVnaW4ncyBgbWFuaWZlc3QudmVyc2lvbmAuXG4gICAqL1xuICByZWFkb25seSBwbHVnaW5WZXJzaW9uOiBzdHJpbmc7XG59XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIHRyaWdnZXJQbHVnaW5MaWZlY3ljbGVFdmVudH0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgVHJpZ2dlclBsdWdpbkxpZmVjeWNsZUV2ZW50UGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBPYnNpZGlhbiBhcHAgaW5zdGFuY2Ugd2hvc2Ugd29ya3NwYWNlIGNhcnJpZXMgdGhlIGJyb2FkY2FzdC5cbiAgICovXG4gIHJlYWRvbmx5IGFwcDogQXBwO1xuXG4gIC8qKlxuICAgKiBUaGUgZXZlbnQgdG8gdHJpZ2dlci5cbiAgICovXG4gIHJlYWRvbmx5IG5hbWU6IFBsdWdpbkxpZmVjeWNsZUV2ZW50TmFtZTtcblxuICAvKipcbiAgICogVGhlIHBheWxvYWQgZGVzY3JpYmluZyB0aGUgcGx1Z2luLlxuICAgKi9cbiAgcmVhZG9ubHkgcGF5bG9hZDogUGx1Z2luTGlmZWN5Y2xlRXZlbnRQYXlsb2FkO1xufVxuXG4vKipcbiAqIFRyaWdnZXJlZCBvbmNlIGEgcGx1Z2luIGhhcyBmaW5pc2hlZCBsb2FkaW5nIEFORCBwdWJsaXNoZWQgZXZlcnkgQVBJIGl0IGRlY2xhcmVzLCBzbyBhIGxpc3RlbmVyIG1heSBjYWxsXG4gKiB0aG9zZSBBUElzIGltbWVkaWF0ZWx5LlxuICpcbiAqIE5hbWVzcGFjZWQgYnkgdGhlIHBhY2thZ2UgbmFtZSByYXRoZXIgdGhhbiBieSBhbiBhYmJyZXZpYXRpb24gb2YgaXQ6IHRoZSBldmVudCBpcyBnbG9iYWwgdG8gdGhlIHZhdWx0XG4gKiBhbmQgYWltZWQgYXQgcGx1Z2luIGF1dGhvcnMgd2hvIGhhdmUgbmV2ZXIgaGVhcmQgb2YgdGhpcyBsaWJyYXJ5LCBzbyB0aGUgcHJlZml4IGhhcyB0byBpZGVudGlmeSBpdHNlbGYuXG4gKi9cbmV4cG9ydCBjb25zdCBQTFVHSU5fTE9BREVEX0VWRU5UX05BTUUgPSAnb2JzaWRpYW4tbGliOnBsdWdpbi1sb2FkZWQnO1xuXG4vKipcbiAqIFRyaWdnZXJlZCBhcyBhIHBsdWdpbiB1bmxvYWRzIOKAlCB3aGV0aGVyIHRoZSB1c2VyIGRpc2FibGVkIGl0LCB1bmluc3RhbGxlZCBpdCwgb3IgT2JzaWRpYW4gaXMgc2h1dHRpbmdcbiAqIGRvd24uIEl0cyBBUElzIGFyZSByZXZva2VkIGJ5IHRoZSB0aW1lIGEgbGlzdGVuZXIgcnVucy5cbiAqL1xuZXhwb3J0IGNvbnN0IFBMVUdJTl9VTkxPQURFRF9FVkVOVF9OQU1FID0gJ29ic2lkaWFuLWxpYjpwbHVnaW4tdW5sb2FkZWQnO1xuXG5kZWNsYXJlIG1vZHVsZSAnb2JzaWRpYW4nIHtcbiAgaW50ZXJmYWNlIFdvcmtzcGFjZSB7XG4gICAgLyoqXG4gICAgICogU3Vic2NyaWJlcyB0byBhIHBsdWdpbiBmaW5pc2hpbmcgaXRzIGxvYWQsIG9yIHRvIG9uZSB1bmxvYWRpbmcuXG4gICAgICpcbiAgICAgKiBAcGFyYW0gbmFtZSAtIFNob3VsZCBiZSB7QGxpbmsgUExVR0lOX0xPQURFRF9FVkVOVF9OQU1FfSBvciB7QGxpbmsgUExVR0lOX1VOTE9BREVEX0VWRU5UX05BTUV9LlxuICAgICAqIEBwYXJhbSBjYWxsYmFjayAtIFRoZSBjYWxsYmFjayByZWNlaXZpbmcgdGhlIHBsdWdpbidzIHBheWxvYWQuXG4gICAgICogQHBhcmFtIGNvbnRleHQgLSBUaGUgY29udGV4dCBwYXNzZWQgYXMgYHRoaXNgIHRvIHRoZSBgY2FsbGJhY2tgIGZ1bmN0aW9uLlxuICAgICAqIEByZXR1cm5zIFRoZSBldmVudCByZWZlcmVuY2UuXG4gICAgICovXG4gICAgLypcbiAgICAgKiBBbiBhdWdtZW50YXRpb24gb2YgYW4gRVhJU1RJTkcgb3ZlcmxvYWQgc2V0IGhhcyB0byBzdGF5IGEgbWV0aG9kIHNpZ25hdHVyZS4gQSBwcm9wZXJ0eSBtZW1iZXIgZG9lcyBub3QgbWVyZ2UgaW50b1xuICAgICAqIGBXb3Jrc3BhY2Uub25gJ3Mgb3ZlcmxvYWRzLCBhbmQgVHlwZVNjcmlwdCBzYXlzIHNvIG5vd2hlcmUgbmVhciBoZXJlOiB0aGUgZGVjbGFyYXRpb24gaXRzZWxmIGNvbXBpbGVzLCBhbmQgZXZlcnlcbiAgICAgKiBjYWxsIHNpdGUgbG9zZXMgdGhlIHNpZ25hdHVyZSBpbnN0ZWFkIOKAlCBgb24oUExVR0lOX0xPQURFRF9FVkVOVF9OQU1FLCAuLi4pYCBmYWlscyB3aXRoIFwidGhlIGxhc3Qgb3ZlcmxvYWQgZ2F2ZSB0aGVcbiAgICAgKiBmb2xsb3dpbmcgZXJyb3JcIi4gVGhlIHJ1bGUgcmVwb3J0cyB0aGlzIG9uZSB3aXRob3V0IGEgZml4IGZvciB0aGUgc2FtZSByZWFzb24sIHNvIHRoZSBkaXNhYmxlIGJlbG93IGlzIHRoZSBhbnN3ZXJcbiAgICAgKiByYXRoZXIgdGhhbiBhIGRlZmVycmFsLlxuICAgICAqL1xuICAgIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBAdHlwZXNjcmlwdC1lc2xpbnQvbWV0aG9kLXNpZ25hdHVyZS1zdHlsZSAtLSBBIHByb3BlcnR5IG1lbWJlciBkb2VzIG5vdCBtZXJnZSBpbnRvIGFuIGV4aXN0aW5nIG92ZXJsb2FkIHNldC4gU2VlIGFib3ZlLlxuICAgIG9uKFxuICAgICAgbmFtZTogUGx1Z2luTGlmZWN5Y2xlRXZlbnROYW1lLFxuICAgICAgY2FsbGJhY2s6IChwYXlsb2FkOiBQbHVnaW5MaWZlY3ljbGVFdmVudFBheWxvYWQpID0+IHVua25vd24sXG4gICAgICBjb250ZXh0PzogdW5rbm93blxuICAgICk6IEV2ZW50UmVmO1xuICB9XG59XG5cbi8qKlxuICogVHJpZ2dlcnMgb25lIG9mIHRoZSB0d28gbGlmZWN5Y2xlIGV2ZW50cyBvbiB0aGUgYXBwJ3Mgd29ya3NwYWNlLlxuICpcbiAqIEEgdGhpbiB0eXBlZCB3cmFwcGVyIG92ZXIgYFdvcmtzcGFjZS50cmlnZ2VyYCwgd2hpY2ggYWNjZXB0cyBhbnkgZXZlbnQgbmFtZSBhbmQgYW55IGFyZ3VtZW50cywgc28gdGhhdCB0aGUgb25lXG4gKiBwbGFjZSBhIHBheWxvYWQgaXMgY29uc3RydWN0ZWQgaXMgY2hlY2tlZCBhZ2FpbnN0IHtAbGluayBQbHVnaW5MaWZlY3ljbGVFdmVudFBheWxvYWR9LlxuICpcbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUge0BsaW5rIFRyaWdnZXJQbHVnaW5MaWZlY3ljbGVFdmVudFBhcmFtc30uXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB0cmlnZ2VyUGx1Z2luTGlmZWN5Y2xlRXZlbnQocGFyYW1zOiBUcmlnZ2VyUGx1Z2luTGlmZWN5Y2xlRXZlbnRQYXJhbXMpOiB2b2lkIHtcbiAgY29uc3QgeyBhcHAsIG5hbWUsIHBheWxvYWQgfSA9IHBhcmFtcztcbiAgYXBwLndvcmtzcGFjZS50cmlnZ2VyKG5hbWUsIHBheWxvYWQpO1xufVxuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQTRHTyxNQUFNLDJCQUEyQjtBQU1qQyxNQUFNLDZCQUE2QjtBQW9DbkMsU0FBUyw0QkFBNEIsUUFBaUQ7QUFDM0YsUUFBTSxFQUFFLEtBQUssTUFBTSxRQUFRLElBQUk7QUFDL0IsTUFBSSxVQUFVLFFBQVEsTUFBTSxPQUFPO0FBQ3JDOyIsIm5hbWVzIjpbXX0=

package/dist/lib/cjs/plugin/plugin-lifecycle-events.d.cts

@@ -5,10 +5,12 @@
  * The lifecycle broadcast every {@link PluginBase} makes: `obsidian-lib:plugin-loaded` when it has
  * finished loading and `obsidian-lib:plugin-unloaded` when it goes away.
  *
- * Obsidian gives a plugin no way to learn that ANOTHER plugin was enabled or disabled — there is no such
- * event on `app.plugins`, and a plugin's own `Events` source cannot help a listener that does not yet hold
- * the instance. So the broadcast goes through `app.workspace`, which is one object every plugin in the
- * vault can reach. Deliberately NOT the `globalThis.__obsidianLib` bag the rest of the library shares
+ * Obsidian does say that SOME plugin changed: read from Obsidian `1.15.1`, `app.plugins` triggers
+ * `changed`, debounced by one macrotask, after every enable, disable, install, uninstall and manifest
+ * reload, but it carries no payload: it does not say which plugin changed, nor that its APIs are published.
+ * This broadcast names the plugin and comes after its APIs, so it is the signal for "that plugin is ready
+ * to call", and `changed` the signal for "re-read the manifests". The broadcast goes through
+ * `app.workspace`, which is one object every plugin in the vault can reach. Deliberately NOT the `globalThis.__obsidianLib` bag the rest of the library shares
  * its state through: a listener there needs its own copy of this library, and these events are meant to be
  * consumable by any plugin at all.
  *

package/dist/lib/cjs/plugin/plugin-settings-tab.cjs

@@ -118,21 +118,21 @@ __export(plugin_settings_tab_exports, {
   SAVE_TO_FILE_CONTEXT: () => SAVE_TO_FILE_CONTEXT
 });
 module.exports = __toCommonJS(plugin_settings_tab_exports);
-var import_async = require('@mnaoumov/typescript-lib/async');
-var import_async_events = require('@mnaoumov/typescript-lib/async-events');
-var import_function = require('@mnaoumov/typescript-lib/function');
-var import_object_utils = require('@mnaoumov/typescript-lib/object-utils');
-var import_type_guards = require('@mnaoumov/typescript-lib/type-guards');
-var import_obsidian = require('obsidian');
-var import_async_events_component = require('../components/async-events-component.cjs');
-var import_component_ex = require('../components/component-ex.cjs');
-var import_css_class = require('../css-class.cjs');
-var import_setting_component_wrapper = require('../setting-components/setting-component-wrapper.cjs');
-var import_text_based_component = require('../setting-components/text-based-component.cjs');
-var import_validator_component = require('../setting-components/validator-component.cjs');
-var import_setting_ex = require('../setting-ex.cjs');
-var import_validation = require('../validation.cjs');
-var import_plugin_context = require('./plugin-context.cjs');
+var import_async = require("@mnaoumov/typescript-lib/async");
+var import_async_events = require("@mnaoumov/typescript-lib/async-events");
+var import_function = require("@mnaoumov/typescript-lib/function");
+var import_object_utils = require("@mnaoumov/typescript-lib/object-utils");
+var import_type_guards = require("@mnaoumov/typescript-lib/type-guards");
+var import_obsidian = require("obsidian");
+var import_async_events_component = require("../components/async-events-component.cjs");
+var import_component_ex = require("../components/component-ex.cjs");
+var import_css_class = require("../css-class.cjs");
+var import_setting_component_wrapper = require("../setting-components/setting-component-wrapper.cjs");
+var import_text_based_component = require("../setting-components/text-based-component.cjs");
+var import_validator_component = require("../setting-components/validator-component.cjs");
+var import_setting_ex = require("../setting-ex.cjs");
+var import_validation = require("../validation.cjs");
+var import_plugin_context = require("./plugin-context.cjs");
 const SAVE_TO_FILE_CONTEXT = "PluginSettingsTab";
 class PluginSettingsTabEventsComponent extends import_component_ex.ComponentEx {
   params;