@mnaoumov/obsidian-lib 0.0.0 → 1.0.1

package/dist/lib/esm/components/monkey-around-component.d.mts

@@ -0,0 +1,241 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Improved type-safe wrapper of {@link https://www.npmjs.com/package/monkey-around} library.
+ */
+import type { GenericFunction } from '@mnaoumov/typescript-lib/function';
+import type { MaybeReturn } from '@mnaoumov/typescript-lib/type';
+import type { ConditionalKeys } from 'type-fest';
+import { ComponentEx } from './component-ex.mjs';
+/**
+ * A type of the factories to apply to the object.
+ *
+ * @typeParam $Object - The object to patch.
+ */
+export type Factories<$Object extends object> = Partial<FullFactories<$Object>>;
+/**
+ * Keys of `Obj` whose value is callable — a method, or a function-like object such as a `Debouncer`. These are the members
+ * accepted by {@link MonkeyAroundComponent#registerFunctionPatch}.
+ *
+ * @typeParam $Object - The object whose keys are filtered.
+ */
+export type FunctionKeys<$Object extends object> = ConditionalKeys<$Object, GenericFunction | undefined> & keyof $Object;
+/**
+ * Keys of `Obj` whose value is a plain function (a "real method"). Function-like objects that carry extra members are
+ * excluded — e.g. a `Debouncer` (which adds `cancel`/`run`) belongs to {@link MonkeyAroundComponent#registerFunctionPatch},
+ * not {@link MonkeyAroundComponent#registerMethodPatch}. The check is whether the member has any own keys beyond a bare
+ * function's (`Exclude<keyof T, keyof GenericFunction>` is `never`).
+ *
+ * @typeParam $Object - The object whose keys are filtered.
+ */
+export type MethodKeys<$Object extends object> = MethodKeysMap<$Object>[FunctionKeys<$Object>];
+/**
+ * Parameters passed to {@link MonkeyAroundComponent#registerFunctionPatch}.
+ *
+ * @typeParam $Object - The object to patch.
+ * @typeParam FunctionName - The function name to patch.
+ */
+export interface MonkeyAroundComponentRegisterFunctionPatchParams<$Object extends object, FunctionName extends FunctionKeys<$Object>> {
+    /**
+     * The object to patch.
+     */
+    readonly $object: $Object;
+    /**
+     * The function name to patch.
+     */
+    readonly functionName: FunctionName;
+    /**
+     * When `true`, the patch uninstalls itself the first time the patched function is invoked (by
+     * unloading this component), restoring the original — so the interception happens exactly once.
+     * Intended for a component dedicated to this single patch. Existing callers that omit it are
+     * unaffected.
+     *
+     * @default `false`
+     */
+    readonly once?: boolean;
+    /**
+     * Patch handler function that takes the original value and returns the patched value.
+     *
+     * @param originalValue - The original value of the function.
+     * @returns The patched value of the function.
+     */
+    readonly patchHandler: (originalValue: $Object[FunctionName]) => $Object[FunctionName];
+}
+/**
+ * Parameters passed to {@link MonkeyAroundComponent#registerMethodPatch}.
+ *
+ * @typeParam $Object - The object to patch.
+ * @typeParam MethodName - The method name to patch.
+ */
+export interface MonkeyAroundComponentRegisterMethodPatchParams<$Object extends object, MethodName extends MethodKeys<$Object>> {
+    /**
+     * The object to patch.
+     */
+    readonly $object: $Object;
+    /**
+     * The method name to patch.
+     */
+    readonly methodName: MethodName;
+    /**
+     * When `true`, the patch uninstalls itself the first time the patched method is invoked, restoring
+     * the original — so the interception happens exactly once. Existing callers that omit it are
+     * unaffected.
+     *
+     * @default `false`
+     */
+    readonly once?: boolean;
+    /**
+     * The patch handler function.
+     */
+    readonly patchHandler: PatchHandlerFunction<$Object, MethodName>;
+    /**
+     * An optional token to identify the patch.
+     *
+     * The token is recorded against the method this patch INSTALLS, so the next patch of the same method
+     * detects it via {@link hasPatchToken} on its own `originalMethod` and can defer to this one. The
+     * patch that installs a token therefore never sees its own token — only the patches stacked on top of
+     * it do. Use a `Symbol.for` token to make the detection work across independently bundled copies of
+     * this library.
+     *
+     * The token is dropped when this component unloads, so a later patch that had deferred takes over on
+     * its next call.
+     */
+    readonly patchToken?: symbol;
+    /**
+     * An optional post-patch handler function that runs after the patch is applied.
+     */
+    readonly postPatchHandler?: PostPatchHandlerFunction<$Object, MethodName>;
+}
+/**
+ * A patch handler function that intercepts calls to a method on an object.
+ *
+ * @typeParam $Object - The object being patched.
+ * @typeParam MethodName - The method name being patched.
+ */
+export type PatchHandlerFunction<$Object extends object, MethodName extends MethodKeys<$Object>> = (params: PatchHandlerParams<$Object, MethodName>) => ReturnType<ExtractFunction<$Object, MethodName>>;
+/**
+ * Parameters passed to a {@link PatchHandlerFunction} callback.
+ *
+ * @typeParam $Object - The object being patched.
+ * @typeParam MethodName - The method name being patched.
+ */
+export interface PatchHandlerParams<$Object extends object, MethodName extends MethodKeys<$Object>> {
+    /**
+     * Invokes the original method with the original `this` and arguments.
+     *
+     * @returns Whatever the original method returns.
+     */
+    readonly fallback: () => ReturnType<ExtractFunction<$Object, MethodName>>;
+    /**
+     * The original arguments of the intercepted call, as a tuple.
+     */
+    readonly originalArguments: Parameters<ExtractFunction<$Object, MethodName>>;
+    /**
+     * The original (unpatched) method. Call via `originalFn.call(originalThis, ...originalArgs)`.
+     */
+    readonly originalMethod: ExtractFunction<$Object, MethodName>;
+    /**
+     * The original method, but with the `this` context already bound to the original object. Call via `originalMethodBound(...originalArgs)`.
+     */
+    readonly originalMethodBound: OmitThisParameter<ExtractFunction<$Object, MethodName>>;
+    /**
+     * The original `this` context of the intercepted call.
+     */
+    readonly originalThis: $Object;
+}
+/**
+ * A post-patch handler function that runs after a patch is applied.
+ *
+ * @typeParam $Object - The object being patched.
+ * @typeParam MethodName - The method name being patched.
+ */
+export type PostPatchHandlerFunction<$Object extends object, MethodName extends MethodKeys<$Object>> = (params: PostPatchHandlerParams<$Object, MethodName>) => MaybeReturn<ExtractFunction<$Object, MethodName>>;
+/**
+ * Parameters passed to a {@link PostPatchHandlerFunction} callback.
+ *
+ * @typeParam $Object - The object being patched.
+ * @typeParam MethodName - The method name being patched.
+ */
+export interface PostPatchHandlerParams<$Object extends object, MethodName extends MethodKeys<$Object>> {
+    /**
+     * The original (unpatched) method. Call via `originalFn.call(originalThis, ...originalArgs)`.
+     */
+    readonly originalMethod: ExtractFunction<$Object, MethodName>;
+    /**
+     * The patched method.
+     */
+    readonly patchedMethod: ExtractFunction<$Object, MethodName>;
+}
+type ExtractFunction<$Object extends object, MethodName extends MethodKeys<$Object>> = GenericFunction<Parameters<Extract<$Object[MethodName], GenericFunction>>, ReturnType<Extract<$Object[MethodName], GenericFunction>>>;
+type FullFactories<$Object extends object> = {
+    [Key in keyof $Object]: (originalValue: $Object[Key]) => $Object[Key];
+};
+type MethodKeysMap<$Object extends object> = {
+    [Key in FunctionKeys<$Object>]: [Exclude<keyof NonNullable<$Object[Key]>, keyof GenericFunction>] extends [never] ? Key : never;
+};
+type Uninstaller = () => void;
+/**
+ * A component that manages monkey-patches with lifecycle-bound cleanup.
+ * All patches registered via this component are automatically uninstalled when the component unloads.
+ */
+export declare class MonkeyAroundComponent extends ComponentEx {
+    /**
+     * Registers a patch for a single function-like member (a method, or a callable such as a `Debouncer`) using a simplified handler.
+     *
+     * @typeParam $Object - The object to patch.
+     * @typeParam FunctionName - The function name to patch.
+     * @param params - The parameters of the patch.
+     */
+    registerFunctionPatch<$Object extends object, const FunctionName extends FunctionKeys<$Object>>(params: MonkeyAroundComponentRegisterFunctionPatchParams<$Object, FunctionName>): void;
+    /**
+     * Registers a single-method patch using a simplified handler.
+     *
+     * @typeParam $Object - The object to patch.
+     * @typeParam MethodName - The method name to patch.
+     * @param params - The parameters of the patch.
+     */
+    registerMethodPatch<$Object extends object, const MethodName extends MethodKeys<$Object>>(params: MonkeyAroundComponentRegisterMethodPatchParams<$Object, MethodName>): void;
+    /**
+     * Registers a patch using raw factories (advanced API).
+     *
+     * @typeParam $Object - The object to patch.
+     * @param $object - The object to patch.
+     * @param factories - The factories to apply to the object.
+     */
+    registerPatch<$Object extends object>($object: $Object, factories: Factories<$Object>): void;
+}
+/**
+ * Applies a patch to the object.
+ * Better strongly-typed version of `monkey-around`.
+ *
+ * @typeParam $Object - The object to patch.
+ * @param $object - The object to patch.
+ * @param factories - The factories to apply to the object.
+ * @returns The uninstaller that removes the patch when called.
+ */
+export declare function around<$Object extends object>($object: $Object, factories: Factories<$Object>): Uninstaller;
+/**
+ * Checks if a function has a specific patch token.
+ *
+ * A token is carried by the method a {@link MonkeyAroundComponent#registerMethodPatch} call INSTALLED, so
+ * the intended caller is a later patch of the same method, checking the `originalMethod` it wrapped in
+ * order to defer to the patch already in place:
+ *
+ * ```ts
+ * patchHandler: ({ fallback, originalMethod }) => {
+ *   if (hasPatchToken(originalMethod, PATCH_TOKEN)) {
+ *     return fallback();
+ *   }
+ *   ...
+ * }
+ * ```
+ *
+ * The check is made per call, so it stops reporting the earlier patch once that patch's component unloads.
+ *
+ * @param $function - The function to check.
+ * @param patchToken - The patch token to check for.
+ * @returns Whether the function has the patch token.
+ */
+export declare function hasPatchToken($function: GenericFunction, patchToken: symbol): boolean;
+export {};

package/dist/lib/esm/components/monkey-around-component.mjs

@@ -0,0 +1,146 @@
+/*
+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 { around as originalAround } from "monkey-around";
+import { getObsidianDevUtilsState } from "../obsidian-dev-utils-state.mjs";
+import { ComponentEx } from "./component-ex.mjs";
+class MonkeyAroundComponent extends ComponentEx {
+  /**
+   * Registers a patch for a single function-like member (a method, or a callable such as a `Debouncer`) using a simplified handler.
+   *
+   * @typeParam $Object - The object to patch.
+   * @typeParam FunctionName - The function name to patch.
+   * @param params - The parameters of the patch.
+   */
+  registerFunctionPatch(params) {
+    this.ensureLoaded();
+    const factories = {};
+    factories[params.functionName] = (originalValue) => {
+      const patchedValue = params.patchHandler(originalValue);
+      if (!params.once) {
+        return patchedValue;
+      }
+      const unloadComponent = () => {
+        this.unload();
+      };
+      function oncePatchedValue(...$arguments) {
+        try {
+          return Reflect.apply(patchedValue, this, $arguments);
+        } finally {
+          unloadComponent();
+        }
+      }
+      return Object.assign(oncePatchedValue, patchedValue);
+    };
+    this.registerPatch(params.$object, factories);
+  }
+  /**
+   * Registers a single-method patch using a simplified handler.
+   *
+   * @typeParam $Object - The object to patch.
+   * @typeParam MethodName - The method name to patch.
+   * @param params - The parameters of the patch.
+   */
+  registerMethodPatch(params) {
+    this.ensureLoaded();
+    this.registerFunctionPatch({
+      $object: params.$object,
+      functionName: params.methodName,
+      once: params.once ?? false,
+      patchHandler: (originalMethodRaw) => {
+        const originalMethod = originalMethodRaw;
+        const finalPatchedMethod = params.postPatchHandler?.({
+          originalMethod,
+          patchedMethod: patchedMethod2
+        }) ?? patchedMethod2;
+        return finalPatchedMethod;
+        function patchedMethod2(...originalArguments) {
+          const originalThis = this;
+          return params.patchHandler({
+            fallback() {
+              return originalMethod.call(originalThis, ...originalArguments);
+            },
+            originalArguments,
+            originalMethod,
+            originalMethodBound: originalMethod.bind(originalThis),
+            originalThis
+          });
+        }
+      }
+    });
+    if (!params.patchToken) {
+      return;
+    }
+    const patchedMethod = params.$object[params.methodName];
+    const monkeyAroundPatches = getMonkeyAroundPatches();
+    monkeyAroundPatches.set(patchedMethod, params.patchToken);
+    this.register(() => {
+      monkeyAroundPatches.delete(patchedMethod);
+    });
+  }
+  /**
+   * Registers a patch using raw factories (advanced API).
+   *
+   * @typeParam $Object - The object to patch.
+   * @param $object - The object to patch.
+   * @param factories - The factories to apply to the object.
+   */
+  registerPatch($object, factories) {
+    this.ensureLoaded();
+    const uninstaller = around($object, factories);
+    this.register(uninstaller);
+  }
+}
+function around($object, factories) {
+  return originalAround($object, factories);
+}
+function hasPatchToken($function, patchToken) {
+  return getMonkeyAroundPatches().get($function) === patchToken;
+}
+function getMonkeyAroundPatches() {
+  return getObsidianDevUtilsState("monkeyAroundPatches", /* @__PURE__ */ new WeakMap()).value;
+}
+export {
+  MonkeyAroundComponent,
+  around,
+  hasPatchToken
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvbW9ua2V5LWFyb3VuZC1jb21wb25lbnQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBJbXByb3ZlZCB0eXBlLXNhZmUgd3JhcHBlciBvZiB7QGxpbmsgaHR0cHM6Ly93d3cubnBtanMuY29tL3BhY2thZ2UvbW9ua2V5LWFyb3VuZH0gbGlicmFyeS5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IEdlbmVyaWNGdW5jdGlvbiB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9mdW5jdGlvbic7XG5pbXBvcnQgdHlwZSB7IE1heWJlUmV0dXJuIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL3R5cGUnO1xuaW1wb3J0IHR5cGUgeyBHZW5lcmljT2JqZWN0IH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL3R5cGUtZ3VhcmRzJztcbmltcG9ydCB0eXBlIHsgQ29uZGl0aW9uYWxLZXlzIH0gZnJvbSAndHlwZS1mZXN0JztcblxuaW1wb3J0IHsgYXJvdW5kIGFzIG9yaWdpbmFsQXJvdW5kIH0gZnJvbSAnbW9ua2V5LWFyb3VuZCc7XG5cbmltcG9ydCB7IGdldE9ic2lkaWFuRGV2VXRpbHNTdGF0ZSB9IGZyb20gJy4uL29ic2lkaWFuLWRldi11dGlscy1zdGF0ZS50cyc7XG5pbXBvcnQgeyBDb21wb25lbnRFeCB9IGZyb20gJy4vY29tcG9uZW50LWV4LnRzJztcblxuLyoqXG4gKiBBIHR5cGUgb2YgdGhlIGZhY3RvcmllcyB0byBhcHBseSB0byB0aGUgb2JqZWN0LlxuICpcbiAqIEB0eXBlUGFyYW0gJE9iamVjdCAtIFRoZSBvYmplY3QgdG8gcGF0Y2guXG4gKi9cbmV4cG9ydCB0eXBlIEZhY3RvcmllczwkT2JqZWN0IGV4dGVuZHMgb2JqZWN0PiA9IFBhcnRpYWw8RnVsbEZhY3RvcmllczwkT2JqZWN0Pj47XG5cbi8qKlxuICogS2V5cyBvZiBgT2JqYCB3aG9zZSB2YWx1ZSBpcyBjYWxsYWJsZSBcdTIwMTQgYSBtZXRob2QsIG9yIGEgZnVuY3Rpb24tbGlrZSBvYmplY3Qgc3VjaCBhcyBhIGBEZWJvdW5jZXJgLiBUaGVzZSBhcmUgdGhlIG1lbWJlcnNcbiAqIGFjY2VwdGVkIGJ5IHtAbGluayBNb25rZXlBcm91bmRDb21wb25lbnQjcmVnaXN0ZXJGdW5jdGlvblBhdGNofS5cbiAqXG4gKiBAdHlwZVBhcmFtICRPYmplY3QgLSBUaGUgb2JqZWN0IHdob3NlIGtleXMgYXJlIGZpbHRlcmVkLlxuICovXG5leHBvcnQgdHlwZSBGdW5jdGlvbktleXM8JE9iamVjdCBleHRlbmRzIG9iamVjdD4gPSBDb25kaXRpb25hbEtleXM8JE9iamVjdCwgR2VuZXJpY0Z1bmN0aW9uIHwgdW5kZWZpbmVkPiAmIGtleW9mICRPYmplY3Q7XG5cbi8qKlxuICogS2V5cyBvZiBgT2JqYCB3aG9zZSB2YWx1ZSBpcyBhIHBsYWluIGZ1bmN0aW9uIChhIFwicmVhbCBtZXRob2RcIikuIEZ1bmN0aW9uLWxpa2Ugb2JqZWN0cyB0aGF0IGNhcnJ5IGV4dHJhIG1lbWJlcnMgYXJlXG4gKiBleGNsdWRlZCBcdTIwMTQgZS5nLiBhIGBEZWJvdW5jZXJgICh3aGljaCBhZGRzIGBjYW5jZWxgL2BydW5gKSBiZWxvbmdzIHRvIHtAbGluayBNb25rZXlBcm91bmRDb21wb25lbnQjcmVnaXN0ZXJGdW5jdGlvblBhdGNofSxcbiAqIG5vdCB7QGxpbmsgTW9ua2V5QXJvdW5kQ29tcG9uZW50I3JlZ2lzdGVyTWV0aG9kUGF0Y2h9LiBUaGUgY2hlY2sgaXMgd2hldGhlciB0aGUgbWVtYmVyIGhhcyBhbnkgb3duIGtleXMgYmV5b25kIGEgYmFyZVxuICogZnVuY3Rpb24ncyAoYEV4Y2x1ZGU8a2V5b2YgVCwga2V5b2YgR2VuZXJpY0Z1bmN0aW9uPmAgaXMgYG5ldmVyYCkuXG4gKlxuICogQHR5cGVQYXJhbSAkT2JqZWN0IC0gVGhlIG9iamVjdCB3aG9zZSBrZXlzIGFyZSBmaWx0ZXJlZC5cbiAqL1xuZXhwb3J0IHR5cGUgTWV0aG9kS2V5czwkT2JqZWN0IGV4dGVuZHMgb2JqZWN0PiA9IE1ldGhvZEtleXNNYXA8JE9iamVjdD5bRnVuY3Rpb25LZXlzPCRPYmplY3Q+XTtcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIHBhc3NlZCB0byB7QGxpbmsgTW9ua2V5QXJvdW5kQ29tcG9uZW50I3JlZ2lzdGVyRnVuY3Rpb25QYXRjaH0uXG4gKlxuICogQHR5cGVQYXJhbSAkT2JqZWN0IC0gVGhlIG9iamVjdCB0byBwYXRjaC5cbiAqIEB0eXBlUGFyYW0gRnVuY3Rpb25OYW1lIC0gVGhlIGZ1bmN0aW9uIG5hbWUgdG8gcGF0Y2guXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTW9ua2V5QXJvdW5kQ29tcG9uZW50UmVnaXN0ZXJGdW5jdGlvblBhdGNoUGFyYW1zPCRPYmplY3QgZXh0ZW5kcyBvYmplY3QsIEZ1bmN0aW9uTmFtZSBleHRlbmRzIEZ1bmN0aW9uS2V5czwkT2JqZWN0Pj4ge1xuICAvKipcbiAgICogVGhlIG9iamVjdCB0byBwYXRjaC5cbiAgICovXG4gIHJlYWRvbmx5ICRvYmplY3Q6ICRPYmplY3Q7XG5cbiAgLyoqXG4gICAqIFRoZSBmdW5jdGlvbiBuYW1lIHRvIHBhdGNoLlxuICAgKi9cbiAgcmVhZG9ubHkgZnVuY3Rpb25OYW1lOiBGdW5jdGlvbk5hbWU7XG5cbiAgLyoqXG4gICAqIFdoZW4gYHRydWVgLCB0aGUgcGF0Y2ggdW5pbnN0YWxscyBpdHNlbGYgdGhlIGZpcnN0IHRpbWUgdGhlIHBhdGNoZWQgZnVuY3Rpb24gaXMgaW52b2tlZCAoYnlcbiAgICogdW5sb2FkaW5nIHRoaXMgY29tcG9uZW50KSwgcmVzdG9yaW5nIHRoZSBvcmlnaW5hbCBcdTIwMTQgc28gdGhlIGludGVyY2VwdGlvbiBoYXBwZW5zIGV4YWN0bHkgb25jZS5cbiAgICogSW50ZW5kZWQgZm9yIGEgY29tcG9uZW50IGRlZGljYXRlZCB0byB0aGlzIHNpbmdsZSBwYXRjaC4gRXhpc3RpbmcgY2FsbGVycyB0aGF0IG9taXQgaXQgYXJlXG4gICAqIHVuYWZmZWN0ZWQuXG4gICAqXG4gICAqIEBkZWZhdWx0IGBmYWxzZWBcbiAgICovXG4gIHJlYWRvbmx5IG9uY2U/OiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBQYXRjaCBoYW5kbGVyIGZ1bmN0aW9uIHRoYXQgdGFrZXMgdGhlIG9yaWdpbmFsIHZhbHVlIGFuZCByZXR1cm5zIHRoZSBwYXRjaGVkIHZhbHVlLlxuICAgKlxuICAgKiBAcGFyYW0gb3JpZ2luYWxWYWx1ZSAtIFRoZSBvcmlnaW5hbCB2YWx1ZSBvZiB0aGUgZnVuY3Rpb24uXG4gICAqIEByZXR1cm5zIFRoZSBwYXRjaGVkIHZhbHVlIG9mIHRoZSBmdW5jdGlvbi5cbiAgICovXG4gIHJlYWRvbmx5IHBhdGNoSGFuZGxlcjogKG9yaWdpbmFsVmFsdWU6ICRPYmplY3RbRnVuY3Rpb25OYW1lXSkgPT4gJE9iamVjdFtGdW5jdGlvbk5hbWVdO1xufVxuXG4vKipcbiAqIFBhcmFtZXRlcnMgcGFzc2VkIHRvIHtAbGluayBNb25rZXlBcm91bmRDb21wb25lbnQjcmVnaXN0ZXJNZXRob2RQYXRjaH0uXG4gKlxuICogQHR5cGVQYXJhbSAkT2JqZWN0IC0gVGhlIG9iamVjdCB0byBwYXRjaC5cbiAqIEB0eXBlUGFyYW0gTWV0aG9kTmFtZSAtIFRoZSBtZXRob2QgbmFtZSB0byBwYXRjaC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBNb25rZXlBcm91bmRDb21wb25lbnRSZWdpc3Rlck1ldGhvZFBhdGNoUGFyYW1zPCRPYmplY3QgZXh0ZW5kcyBvYmplY3QsIE1ldGhvZE5hbWUgZXh0ZW5kcyBNZXRob2RLZXlzPCRPYmplY3Q+PiB7XG4gIC8qKlxuICAgKiBUaGUgb2JqZWN0IHRvIHBhdGNoLlxuICAgKi9cbiAgcmVhZG9ubHkgJG9iamVjdDogJE9iamVjdDtcblxuICAvKipcbiAgICogVGhlIG1ldGhvZCBuYW1lIHRvIHBhdGNoLlxuICAgKi9cbiAgcmVhZG9ubHkgbWV0aG9kTmFtZTogTWV0aG9kTmFtZTtcblxuICAvKipcbiAgICogV2hlbiBgdHJ1ZWAsIHRoZSBwYXRjaCB1bmluc3RhbGxzIGl0c2VsZiB0aGUgZmlyc3QgdGltZSB0aGUgcGF0Y2hlZCBtZXRob2QgaXMgaW52b2tlZCwgcmVzdG9yaW5nXG4gICAqIHRoZSBvcmlnaW5hbCBcdTIwMTQgc28gdGhlIGludGVyY2VwdGlvbiBoYXBwZW5zIGV4YWN0bHkgb25jZS4gRXhpc3RpbmcgY2FsbGVycyB0aGF0IG9taXQgaXQgYXJlXG4gICAqIHVuYWZmZWN0ZWQuXG4gICAqXG4gICAqIEBkZWZhdWx0IGBmYWxzZWBcbiAgICovXG4gIHJlYWRvbmx5IG9uY2U/OiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBUaGUgcGF0Y2ggaGFuZGxlciBmdW5jdGlvbi5cbiAgICovXG4gIHJlYWRvbmx5IHBhdGNoSGFuZGxlcjogUGF0Y2hIYW5kbGVyRnVuY3Rpb248JE9iamVjdCwgTWV0aG9kTmFtZT47XG5cbiAgLyoqXG4gICAqIEFuIG9wdGlvbmFsIHRva2VuIHRvIGlkZW50aWZ5IHRoZSBwYXRjaC5cbiAgICpcbiAgICogVGhlIHRva2VuIGlzIHJlY29yZGVkIGFnYWluc3QgdGhlIG1ldGhvZCB0aGlzIHBhdGNoIElOU1RBTExTLCBzbyB0aGUgbmV4dCBwYXRjaCBvZiB0aGUgc2FtZSBtZXRob2RcbiAgICogZGV0ZWN0cyBpdCB2aWEge0BsaW5rIGhhc1BhdGNoVG9rZW59IG9uIGl0cyBvd24gYG9yaWdpbmFsTWV0aG9kYCBhbmQgY2FuIGRlZmVyIHRvIHRoaXMgb25lLiBUaGVcbiAgICogcGF0Y2ggdGhhdCBpbnN0YWxscyBhIHRva2VuIHRoZXJlZm9yZSBuZXZlciBzZWVzIGl0cyBvd24gdG9rZW4gXHUyMDE0IG9ubHkgdGhlIHBhdGNoZXMgc3RhY2tlZCBvbiB0b3Agb2ZcbiAgICogaXQgZG8uIFVzZSBhIGBTeW1ib2wuZm9yYCB0b2tlbiB0byBtYWtlIHRoZSBkZXRlY3Rpb24gd29yayBhY3Jvc3MgaW5kZXBlbmRlbnRseSBidW5kbGVkIGNvcGllcyBvZlxuICAgKiB0aGlzIGxpYnJhcnkuXG4gICAqXG4gICAqIFRoZSB0b2tlbiBpcyBkcm9wcGVkIHdoZW4gdGhpcyBjb21wb25lbnQgdW5sb2Fkcywgc28gYSBsYXRlciBwYXRjaCB0aGF0IGhhZCBkZWZlcnJlZCB0YWtlcyBvdmVyIG9uXG4gICAqIGl0cyBuZXh0IGNhbGwuXG4gICAqL1xuICByZWFkb25seSBwYXRjaFRva2VuPzogc3ltYm9sO1xuXG4gIC8qKlxuICAgKiBBbiBvcHRpb25hbCBwb3N0LXBhdGNoIGhhbmRsZXIgZnVuY3Rpb24gdGhhdCBydW5zIGFmdGVyIHRoZSBwYXRjaCBpcyBhcHBsaWVkLlxuICAgKi9cbiAgcmVhZG9ubHkgcG9zdFBhdGNoSGFuZGxlcj86IFBvc3RQYXRjaEhhbmRsZXJGdW5jdGlvbjwkT2JqZWN0LCBNZXRob2ROYW1lPjtcbn1cblxuLyoqXG4gKiBBIHBhdGNoIGhhbmRsZXIgZnVuY3Rpb24gdGhhdCBpbnRlcmNlcHRzIGNhbGxzIHRvIGEgbWV0aG9kIG9uIGFuIG9iamVjdC5cbiAqXG4gKiBAdHlwZVBhcmFtICRPYmplY3QgLSBUaGUgb2JqZWN0IGJlaW5nIHBhdGNoZWQuXG4gKiBAdHlwZVBhcmFtIE1ldGhvZE5hbWUgLSBUaGUgbWV0aG9kIG5hbWUgYmVpbmcgcGF0Y2hlZC5cbiAqL1xuZXhwb3J0IHR5cGUgUGF0Y2hIYW5kbGVyRnVuY3Rpb248JE9iamVjdCBleHRlbmRzIG9iamVjdCwgTWV0aG9kTmFtZSBleHRlbmRzIE1ldGhvZEtleXM8JE9iamVjdD4+ID0gKFxuICBwYXJhbXM6IFBhdGNoSGFuZGxlclBhcmFtczwkT2JqZWN0LCBNZXRob2ROYW1lPlxuKSA9PiBSZXR1cm5UeXBlPEV4dHJhY3RGdW5jdGlvbjwkT2JqZWN0LCBNZXRob2ROYW1lPj47XG5cbi8qKlxuICogUGFyYW1ldGVycyBwYXNzZWQgdG8gYSB7QGxpbmsgUGF0Y2hIYW5kbGVyRnVuY3Rpb259IGNhbGxiYWNrLlxuICpcbiAqIEB0eXBlUGFyYW0gJE9iamVjdCAtIFRoZSBvYmplY3QgYmVpbmcgcGF0Y2hlZC5cbiAqIEB0eXBlUGFyYW0gTWV0aG9kTmFtZSAtIFRoZSBtZXRob2QgbmFtZSBiZWluZyBwYXRjaGVkLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFBhdGNoSGFuZGxlclBhcmFtczwkT2JqZWN0IGV4dGVuZHMgb2JqZWN0LCBNZXRob2ROYW1lIGV4dGVuZHMgTWV0aG9kS2V5czwkT2JqZWN0Pj4ge1xuICAvKipcbiAgICogSW52b2tlcyB0aGUgb3JpZ2luYWwgbWV0aG9kIHdpdGggdGhlIG9yaWdpbmFsIGB0aGlzYCBhbmQgYXJndW1lbnRzLlxuICAgKlxuICAgKiBAcmV0dXJucyBXaGF0ZXZlciB0aGUgb3JpZ2luYWwgbWV0aG9kIHJldHVybnMuXG4gICAqL1xuICByZWFkb25seSBmYWxsYmFjazogKCkgPT4gUmV0dXJuVHlwZTxFeHRyYWN0RnVuY3Rpb248JE9iamVjdCwgTWV0aG9kTmFtZT4+O1xuXG4gIC8qKlxuICAgKiBUaGUgb3JpZ2luYWwgYXJndW1lbnRzIG9mIHRoZSBpbnRlcmNlcHRlZCBjYWxsLCBhcyBhIHR1cGxlLlxuICAgKi9cbiAgcmVhZG9ubHkgb3JpZ2luYWxBcmd1bWVudHM6IFBhcmFtZXRlcnM8RXh0cmFjdEZ1bmN0aW9uPCRPYmplY3QsIE1ldGhvZE5hbWU+PjtcblxuICAvKipcbiAgICogVGhlIG9yaWdpbmFsICh1bnBhdGNoZWQpIG1ldGhvZC4gQ2FsbCB2aWEgYG9yaWdpbmFsRm4uY2FsbChvcmlnaW5hbFRoaXMsIC4uLm9yaWdpbmFsQXJncylgLlxuICAgKi9cbiAgcmVhZG9ubHkgb3JpZ2luYWxNZXRob2Q6IEV4dHJhY3RGdW5jdGlvbjwkT2JqZWN0LCBNZXRob2ROYW1lPjtcblxuICAvKipcbiAgICogVGhlIG9yaWdpbmFsIG1ldGhvZCwgYnV0IHdpdGggdGhlIGB0aGlzYCBjb250ZXh0IGFscmVhZHkgYm91bmQgdG8gdGhlIG9yaWdpbmFsIG9iamVjdC4gQ2FsbCB2aWEgYG9yaWdpbmFsTWV0aG9kQm91bmQoLi4ub3JpZ2luYWxBcmdzKWAuXG4gICAqL1xuICByZWFkb25seSBvcmlnaW5hbE1ldGhvZEJvdW5kOiBPbWl0VGhpc1BhcmFtZXRlcjxFeHRyYWN0RnVuY3Rpb248JE9iamVjdCwgTWV0aG9kTmFtZT4+O1xuXG4gIC8qKlxuICAgKiBUaGUgb3JpZ2luYWwgYHRoaXNgIGNvbnRleHQgb2YgdGhlIGludGVyY2VwdGVkIGNhbGwuXG4gICAqL1xuICByZWFkb25seSBvcmlnaW5hbFRoaXM6ICRPYmplY3Q7XG59XG5cbi8qKlxuICogQSBwb3N0LXBhdGNoIGhhbmRsZXIgZnVuY3Rpb24gdGhhdCBydW5zIGFmdGVyIGEgcGF0Y2ggaXMgYXBwbGllZC5cbiAqXG4gKiBAdHlwZVBhcmFtICRPYmplY3QgLSBUaGUgb2JqZWN0IGJlaW5nIHBhdGNoZWQuXG4gKiBAdHlwZVBhcmFtIE1ldGhvZE5hbWUgLSBUaGUgbWV0aG9kIG5hbWUgYmVpbmcgcGF0Y2hlZC5cbiAqL1xuZXhwb3J0IHR5cGUgUG9zdFBhdGNoSGFuZGxlckZ1bmN0aW9uPCRPYmplY3QgZXh0ZW5kcyBvYmplY3QsIE1ldGhvZE5hbWUgZXh0ZW5kcyBNZXRob2RLZXlzPCRPYmplY3Q+PiA9IChcbiAgcGFyYW1zOiBQb3N0UGF0Y2hIYW5kbGVyUGFyYW1zPCRPYmplY3QsIE1ldGhvZE5hbWU+XG4pID0+IE1heWJlUmV0dXJuPEV4dHJhY3RGdW5jdGlvbjwkT2JqZWN0LCBNZXRob2ROYW1lPj47XG5cbi8qKlxuICogUGFyYW1ldGVycyBwYXNzZWQgdG8gYSB7QGxpbmsgUG9zdFBhdGNoSGFuZGxlckZ1bmN0aW9ufSBjYWxsYmFjay5cbiAqXG4gKiBAdHlwZVBhcmFtICRPYmplY3QgLSBUaGUgb2JqZWN0IGJlaW5nIHBhdGNoZWQuXG4gKiBAdHlwZVBhcmFtIE1ldGhvZE5hbWUgLSBUaGUgbWV0aG9kIG5hbWUgYmVpbmcgcGF0Y2hlZC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBQb3N0UGF0Y2hIYW5kbGVyUGFyYW1zPCRPYmplY3QgZXh0ZW5kcyBvYmplY3QsIE1ldGhvZE5hbWUgZXh0ZW5kcyBNZXRob2RLZXlzPCRPYmplY3Q+PiB7XG4gIC8qKlxuICAgKiBUaGUgb3JpZ2luYWwgKHVucGF0Y2hlZCkgbWV0aG9kLiBDYWxsIHZpYSBgb3JpZ2luYWxGbi5jYWxsKG9yaWdpbmFsVGhpcywgLi4ub3JpZ2luYWxBcmdzKWAuXG4gICAqL1xuICByZWFkb25seSBvcmlnaW5hbE1ldGhvZDogRXh0cmFjdEZ1bmN0aW9uPCRPYmplY3QsIE1ldGhvZE5hbWU+O1xuXG4gIC8qKlxuICAgKiBUaGUgcGF0Y2hlZCBtZXRob2QuXG4gICAqL1xuICByZWFkb25seSBwYXRjaGVkTWV0aG9kOiBFeHRyYWN0RnVuY3Rpb248JE9iamVjdCwgTWV0aG9kTmFtZT47XG59XG5cbnR5cGUgRXh0cmFjdEZ1bmN0aW9uPCRPYmplY3QgZXh0ZW5kcyBvYmplY3QsIE1ldGhvZE5hbWUgZXh0ZW5kcyBNZXRob2RLZXlzPCRPYmplY3Q+PiA9IEdlbmVyaWNGdW5jdGlvbjxQYXJhbWV0ZXJzPEV4dHJhY3Q8JE9iamVjdFtNZXRob2ROYW1lXSwgR2VuZXJpY0Z1bmN0aW9uPj4sIFJldHVyblR5cGU8RXh0cmFjdDwkT2JqZWN0W01ldGhvZE5hbWVdLCBHZW5lcmljRnVuY3Rpb24+Pj47XG5cbnR5cGUgRnVsbEZhY3RvcmllczwkT2JqZWN0IGV4dGVuZHMgb2JqZWN0PiA9IHtcbiAgW0tleSBpbiBrZXlvZiAkT2JqZWN0XTogKG9yaWdpbmFsVmFsdWU6ICRPYmplY3RbS2V5XSkgPT4gJE9iamVjdFtLZXldO1xufTtcblxudHlwZSBNZXRob2RLZXlzTWFwPCRPYmplY3QgZXh0ZW5kcyBvYmplY3Q+ID0ge1xuICBbS2V5IGluIEZ1bmN0aW9uS2V5czwkT2JqZWN0Pl06IFtFeGNsdWRlPGtleW9mIE5vbk51bGxhYmxlPCRPYmplY3RbS2V5XT4sIGtleW9mIEdlbmVyaWNGdW5jdGlvbj5dIGV4dGVuZHMgW25ldmVyXSA/IEtleSA6IG5ldmVyO1xufTtcblxudHlwZSBPcmlnaW5hbEZhY3RvcmllczwkT2JqZWN0IGV4dGVuZHMgR2VuZXJpY09iamVjdD4gPSBQYXJhbWV0ZXJzPHR5cGVvZiBvcmlnaW5hbEFyb3VuZDwkT2JqZWN0Pj5bMV07XG5cbnR5cGUgVW5pbnN0YWxsZXIgPSAoKSA9PiB2b2lkO1xuXG4vKipcbiAqIEEgY29tcG9uZW50IHRoYXQgbWFuYWdlcyBtb25rZXktcGF0Y2hlcyB3aXRoIGxpZmVjeWNsZS1ib3VuZCBjbGVhbnVwLlxuICogQWxsIHBhdGNoZXMgcmVnaXN0ZXJlZCB2aWEgdGhpcyBjb21wb25lbnQgYXJlIGF1dG9tYXRpY2FsbHkgdW5pbnN0YWxsZWQgd2hlbiB0aGUgY29tcG9uZW50IHVubG9hZHMuXG4gKi9cbmV4cG9ydCBjbGFzcyBNb25rZXlBcm91bmRDb21wb25lbnQgZXh0ZW5kcyBDb21wb25lbnRFeCB7XG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYSBwYXRjaCBmb3IgYSBzaW5nbGUgZnVuY3Rpb24tbGlrZSBtZW1iZXIgKGEgbWV0aG9kLCBvciBhIGNhbGxhYmxlIHN1Y2ggYXMgYSBgRGVib3VuY2VyYCkgdXNpbmcgYSBzaW1wbGlmaWVkIGhhbmRsZXIuXG4gICAqXG4gICAqIEB0eXBlUGFyYW0gJE9iamVjdCAtIFRoZSBvYmplY3QgdG8gcGF0Y2guXG4gICAqIEB0eXBlUGFyYW0gRnVuY3Rpb25OYW1lIC0gVGhlIGZ1bmN0aW9uIG5hbWUgdG8gcGF0Y2guXG4gICAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycyBvZiB0aGUgcGF0Y2guXG4gICAqL1xuICBwdWJsaWMgcmVnaXN0ZXJGdW5jdGlvblBhdGNoPCRPYmplY3QgZXh0ZW5kcyBvYmplY3QsIGNvbnN0IEZ1bmN0aW9uTmFtZSBleHRlbmRzIEZ1bmN0aW9uS2V5czwkT2JqZWN0Pj4oXG4gICAgcGFyYW1zOiBNb25rZXlBcm91bmRDb21wb25lbnRSZWdpc3RlckZ1bmN0aW9uUGF0Y2hQYXJhbXM8JE9iamVjdCwgRnVuY3Rpb25OYW1lPlxuICApOiB2b2lkIHtcbiAgICB0aGlzLmVuc3VyZUxvYWRlZCgpO1xuXG4gICAgY29uc3QgZmFjdG9yaWVzOiBGYWN0b3JpZXM8JE9iamVjdD4gPSB7fTtcbiAgICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgdW5pY29ybi9uby1pbW1lZGlhdGUtbXV0YXRpb24gLS0gQSBjb21wdXRlZCBrZXkgaW4gYW4gb2JqZWN0IGxpdGVyYWwgZG9lcyBub3QgbWF0Y2ggYFBhcnRpYWw8RnVsbEZhY3RvcmllczwkT2JqZWN0Pj5gIHdoZW4gdGhlIGtleSB0eXBlIGlzIGdlbmVyaWM7IGFzc2lnbmluZyBhZnRlciBkZWNsYXJhdGlvbiBrZWVwcyB0aGUgdGFyZ2V0IHR5cGUga25vd24uXG4gICAgZmFjdG9yaWVzW3BhcmFtcy5mdW5jdGlvbk5hbWVdID0gKG9yaWdpbmFsVmFsdWU6ICRPYmplY3RbRnVuY3Rpb25OYW1lXSk6ICRPYmplY3RbRnVuY3Rpb25OYW1lXSA9PiB7XG4gICAgICBjb25zdCBwYXRjaGVkVmFsdWUgPSBwYXJhbXMucGF0Y2hIYW5kbGVyKG9yaWdpbmFsVmFsdWUpO1xuICAgICAgaWYgKCFwYXJhbXMub25jZSkge1xuICAgICAgICByZXR1cm4gcGF0Y2hlZFZhbHVlO1xuICAgICAgfVxuXG4gICAgICAvLyBBIGBvbmNlYCBwYXRjaCB1bmxvYWRzIHRoaXMgY29tcG9uZW50IGFmdGVyIHRoZSBmaXJzdCBpbnZvY2F0aW9uIFx1MjAxNCBydW5uaW5nIHRoZSByZWdpc3RlcmVkXG4gICAgICAvLyB1bmluc3RhbGxlciBhbmQgcmVzdG9yaW5nIHRoZSBvcmlnaW5hbC4gYHVubG9hZENvbXBvbmVudGAgaXMgYW4gYXJyb3cgc28gaXQgY2FwdHVyZXMgdGhlXG4gICAgICAvLyBjb21wb25lbnQgYHRoaXNgOyB0aGUgbmVzdGVkIGBvbmNlUGF0Y2hlZFZhbHVlYCBtdXN0IGJlIGEgZnVuY3Rpb24gdG8gcmVjZWl2ZSB0aGUgY2FsbC10aW1lXG4gICAgICAvLyBgdGhpc2AuIE93biBtZW1iZXJzIChlLmcuIGEgYERlYm91bmNlcmAncyBgY2FuY2VsYC9gcnVuYCkgYXJlIGNvcGllZCBvbnRvIGl0IHNvIGZ1bmN0aW9uLWxpa2VcbiAgICAgIC8vIHZhbHVlcyBrZWVwIHdvcmtpbmcuXG4gICAgICBjb25zdCB1bmxvYWRDb21wb25lbnQgPSAoKTogdm9pZCA9PiB7XG4gICAgICAgIHRoaXMudW5sb2FkKCk7XG4gICAgICB9O1xuICAgICAgZnVuY3Rpb24gb25jZVBhdGNoZWRWYWx1ZSh0aGlzOiB1bmtub3duLCAuLi4kYXJndW1lbnRzOiB1bmtub3duW10pOiB1bmtub3duIHtcbiAgICAgICAgdHJ5IHtcbiAgICAgICAgICByZXR1cm4gUmVmbGVjdC5hcHBseShwYXRjaGVkVmFsdWUsIHRoaXMsICRhcmd1bWVudHMpO1xuICAgICAgICB9IGZpbmFsbHkge1xuICAgICAgICAgIHVubG9hZENvbXBvbmVudCgpO1xuICAgICAgICB9XG4gICAgICB9XG4gICAgICByZXR1cm4gT2JqZWN0LmFzc2lnbihvbmNlUGF0Y2hlZFZhbHVlLCBwYXRjaGVkVmFsdWUpIGFzICRPYmplY3RbRnVuY3Rpb25OYW1lXTtcbiAgICB9O1xuXG4gICAgdGhpcy5yZWdpc3RlclBhdGNoKHBhcmFtcy4kb2JqZWN0LCBmYWN0b3JpZXMpO1xuICB9XG5cbiAgLyoqXG4gICAqIFJlZ2lzdGVycyBhIHNpbmdsZS1tZXRob2QgcGF0Y2ggdXNpbmcgYSBzaW1wbGlmaWVkIGhhbmRsZXIuXG4gICAqXG4gICAqIEB0eXBlUGFyYW0gJE9iamVjdCAtIFRoZSBvYmplY3QgdG8gcGF0Y2guXG4gICAqIEB0eXBlUGFyYW0gTWV0aG9kTmFtZSAtIFRoZSBtZXRob2QgbmFtZSB0byBwYXRjaC5cbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIG9mIHRoZSBwYXRjaC5cbiAgICovXG4gIHB1YmxpYyByZWdpc3Rlck1ldGhvZFBhdGNoPCRPYmplY3QgZXh0ZW5kcyBvYmplY3QsIGNvbnN0IE1ldGhvZE5hbWUgZXh0ZW5kcyBNZXRob2RLZXlzPCRPYmplY3Q+PihcbiAgICBwYXJhbXM6IE1vbmtleUFyb3VuZENvbXBvbmVudFJlZ2lzdGVyTWV0aG9kUGF0Y2hQYXJhbXM8JE9iamVjdCwgTWV0aG9kTmFtZT5cbiAgKTogdm9pZCB7XG4gICAgdGhpcy5lbnN1cmVMb2FkZWQoKTtcblxuICAgIHR5cGUgJEZ1bmN0aW9uID0gRXh0cmFjdEZ1bmN0aW9uPCRPYmplY3QsIE1ldGhvZE5hbWU+O1xuXG4gICAgdGhpcy5yZWdpc3RlckZ1bmN0aW9uUGF0Y2goe1xuICAgICAgJG9iamVjdDogcGFyYW1zLiRvYmplY3QsXG4gICAgICBmdW5jdGlvbk5hbWU6IHBhcmFtcy5tZXRob2ROYW1lLFxuICAgICAgb25jZTogcGFyYW1zLm9uY2UgPz8gZmFsc2UsXG4gICAgICBwYXRjaEhhbmRsZXI6IChvcmlnaW5hbE1ldGhvZFJhdykgPT4ge1xuICAgICAgICBjb25zdCBvcmlnaW5hbE1ldGhvZCA9IG9yaWdpbmFsTWV0aG9kUmF3IGFzICRGdW5jdGlvbjtcbiAgICAgICAgY29uc3QgZmluYWxQYXRjaGVkTWV0aG9kID0gcGFyYW1zLnBvc3RQYXRjaEhhbmRsZXI/Lih7XG4gICAgICAgICAgb3JpZ2luYWxNZXRob2QsXG4gICAgICAgICAgcGF0Y2hlZE1ldGhvZFxuICAgICAgICB9KSA/PyBwYXRjaGVkTWV0aG9kO1xuICAgICAgICByZXR1cm4gZmluYWxQYXRjaGVkTWV0aG9kIGFzICRPYmplY3RbTWV0aG9kTmFtZV07XG5cbiAgICAgICAgZnVuY3Rpb24gcGF0Y2hlZE1ldGhvZCh0aGlzOiAkT2JqZWN0LCAuLi5vcmlnaW5hbEFyZ3VtZW50czogUGFyYW1ldGVyczwkRnVuY3Rpb24+KTogUmV0dXJuVHlwZTwkRnVuY3Rpb24+IHtcbiAgICAgICAgICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgY29uc2lzdGVudC10aGlzLCBAdHlwZXNjcmlwdC1lc2xpbnQvbm8tdGhpcy1hbGlhcywgdW5pY29ybi9uby10aGlzLWFzc2lnbm1lbnQgLS0gV2UgbmVlZCB0byB1c2UgdGhlIGB0aGlzYCBjb250ZXh0LlxuICAgICAgICAgIGNvbnN0IG9yaWdpbmFsVGhpcyA9IHRoaXM7XG4gICAgICAgICAgcmV0dXJuIHBhcmFtcy5wYXRjaEhhbmRsZXIoe1xuICAgICAgICAgICAgZmFsbGJhY2soKSB7XG4gICAgICAgICAgICAgIHJldHVybiBvcmlnaW5hbE1ldGhvZC5jYWxsKG9yaWdpbmFsVGhpcywgLi4ub3JpZ2luYWxBcmd1bWVudHMpO1xuICAgICAgICAgICAgfSxcbiAgICAgICAgICAgIG9yaWdpbmFsQXJndW1lbnRzLFxuICAgICAgICAgICAgb3JpZ2luYWxNZXRob2QsXG4gICAgICAgICAgICBvcmlnaW5hbE1ldGhvZEJvdW5kOiBvcmlnaW5hbE1ldGhvZC5iaW5kKG9yaWdpbmFsVGhpcyksXG4gICAgICAgICAgICBvcmlnaW5hbFRoaXNcbiAgICAgICAgICB9KTtcbiAgICAgICAgfVxuICAgICAgfVxuICAgIH0pO1xuXG4gICAgaWYgKCFwYXJhbXMucGF0Y2hUb2tlbikge1xuICAgICAgcmV0dXJuO1xuICAgIH1cblxuICAgIC8vIFRoZSB0b2tlbiBtYXJrcyB0aGUgSU5TVEFMTEVEIG1ldGhvZCwgcmVhZCBiYWNrIG9uY2UgdGhlIHBhdGNoIGlzIGluIHBsYWNlLlxuICAgIC8vIFRoYXQgaXMgdGhlIGlkZW50aXR5IHRoZSBuZXh0IHBhdGNoIG9mIHRoZSBzYW1lIG1ldGhvZCByZWNlaXZlcyBhcyBpdHMgYG9yaWdpbmFsTWV0aG9kYC5cbiAgICAvLyBgbW9ua2V5LWFyb3VuZGAgaW5zdGFsbHMgYSB3cmFwcGVyIG9mIGl0cyBvd24gYW5kIGV4cG9zZXMgdGhlIHZhbHVlIGJ1aWx0IGFib3ZlIG9ubHkgdmlhIGl0cyBwcm90b3R5cGUuXG4gICAgLy8gTWFya2luZyB0aGF0IHZhbHVlLCBvciB0aGUgbWV0aG9kIGJlaW5nIHdyYXBwZWQgYXMgdGhpcyBvbmNlIGRpZCwgbWF0Y2hlcyBub3RoaW5nIHRoZSBuZXh0IHBhdGNoIHNlZXMuXG4gICAgLy8gRHJvcHBpbmcgdGhlIHRva2VuIG9uIHVubG9hZCBsZXRzIGEgZGVmZXJyaW5nIGxhdGVyIHBhdGNoIHRha2Ugb3Zlciwgc2luY2UgdGhlIGd1YXJkIGlzIHJlYWQgcGVyIGNhbGwuXG4gICAgY29uc3QgcGF0Y2hlZE1ldGhvZCA9IHBhcmFtcy4kb2JqZWN0W3BhcmFtcy5tZXRob2ROYW1lXSBhcyBHZW5lcmljRnVuY3Rpb247XG4gICAgY29uc3QgbW9ua2V5QXJvdW5kUGF0Y2hlcyA9IGdldE1vbmtleUFyb3VuZFBhdGNoZXMoKTtcbiAgICBtb25rZXlBcm91bmRQYXRjaGVzLnNldChwYXRjaGVkTWV0aG9kLCBwYXJhbXMucGF0Y2hUb2tlbik7XG4gICAgdGhpcy5yZWdpc3RlcigoKSA9PiB7XG4gICAgICBtb25rZXlBcm91bmRQYXRjaGVzLmRlbGV0ZShwYXRjaGVkTWV0aG9kKTtcbiAgICB9KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZWdpc3RlcnMgYSBwYXRjaCB1c2luZyByYXcgZmFjdG9yaWVzIChhZHZhbmNlZCBBUEkpLlxuICAgKlxuICAgKiBAdHlwZVBhcmFtICRPYmplY3QgLSBUaGUgb2JqZWN0IHRvIHBhdGNoLlxuICAgKiBAcGFyYW0gJG9iamVjdCAtIFRoZSBvYmplY3QgdG8gcGF0Y2guXG4gICAqIEBwYXJhbSBmYWN0b3JpZXMgLSBUaGUgZmFjdG9yaWVzIHRvIGFwcGx5IHRvIHRoZSBvYmplY3QuXG4gICAqL1xuICBwdWJsaWMgcmVnaXN0ZXJQYXRjaDwkT2JqZWN0IGV4dGVuZHMgb2JqZWN0Pigkb2JqZWN0OiAkT2JqZWN0LCBmYWN0b3JpZXM6IEZhY3RvcmllczwkT2JqZWN0Pik6IHZvaWQge1xuICAgIHRoaXMuZW5zdXJlTG9hZGVkKCk7XG5cbiAgICBjb25zdCB1bmluc3RhbGxlciA9IGFyb3VuZCgkb2JqZWN0LCBmYWN0b3JpZXMpO1xuICAgIHRoaXMucmVnaXN0ZXIodW5pbnN0YWxsZXIpO1xuICB9XG59XG5cbi8qKlxuICogQXBwbGllcyBhIHBhdGNoIHRvIHRoZSBvYmplY3QuXG4gKiBCZXR0ZXIgc3Ryb25nbHktdHlwZWQgdmVyc2lvbiBvZiBgbW9ua2V5LWFyb3VuZGAuXG4gKlxuICogQHR5cGVQYXJhbSAkT2JqZWN0IC0gVGhlIG9iamVjdCB0byBwYXRjaC5cbiAqIEBwYXJhbSAkb2JqZWN0IC0gVGhlIG9iamVjdCB0byBwYXRjaC5cbiAqIEBwYXJhbSBmYWN0b3JpZXMgLSBUaGUgZmFjdG9yaWVzIHRvIGFwcGx5IHRvIHRoZSBvYmplY3QuXG4gKiBAcmV0dXJucyBUaGUgdW5pbnN0YWxsZXIgdGhhdCByZW1vdmVzIHRoZSBwYXRjaCB3aGVuIGNhbGxlZC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGFyb3VuZDwkT2JqZWN0IGV4dGVuZHMgb2JqZWN0Pigkb2JqZWN0OiAkT2JqZWN0LCBmYWN0b3JpZXM6IEZhY3RvcmllczwkT2JqZWN0Pik6IFVuaW5zdGFsbGVyIHtcbiAgcmV0dXJuIG9yaWdpbmFsQXJvdW5kKCRvYmplY3QgYXMgR2VuZXJpY09iamVjdCwgZmFjdG9yaWVzIGFzIE9yaWdpbmFsRmFjdG9yaWVzPEdlbmVyaWNPYmplY3Q+KTtcbn1cblxuLyoqXG4gKiBDaGVja3MgaWYgYSBmdW5jdGlvbiBoYXMgYSBzcGVjaWZpYyBwYXRjaCB0b2tlbi5cbiAqXG4gKiBBIHRva2VuIGlzIGNhcnJpZWQgYnkgdGhlIG1ldGhvZCBhIHtAbGluayBNb25rZXlBcm91bmRDb21wb25lbnQjcmVnaXN0ZXJNZXRob2RQYXRjaH0gY2FsbCBJTlNUQUxMRUQsIHNvXG4gKiB0aGUgaW50ZW5kZWQgY2FsbGVyIGlzIGEgbGF0ZXIgcGF0Y2ggb2YgdGhlIHNhbWUgbWV0aG9kLCBjaGVja2luZyB0aGUgYG9yaWdpbmFsTWV0aG9kYCBpdCB3cmFwcGVkIGluXG4gKiBvcmRlciB0byBkZWZlciB0byB0aGUgcGF0Y2ggYWxyZWFkeSBpbiBwbGFjZTpcbiAqXG4gKiBgYGB0c1xuICogcGF0Y2hIYW5kbGVyOiAoeyBmYWxsYmFjaywgb3JpZ2luYWxNZXRob2QgfSkgPT4ge1xuICogICBpZiAoaGFzUGF0Y2hUb2tlbihvcmlnaW5hbE1ldGhvZCwgUEFUQ0hfVE9LRU4pKSB7XG4gKiAgICAgcmV0dXJuIGZhbGxiYWNrKCk7XG4gKiAgIH1cbiAqICAgLi4uXG4gKiB9XG4gKiBgYGBcbiAqXG4gKiBUaGUgY2hlY2sgaXMgbWFkZSBwZXIgY2FsbCwgc28gaXQgc3RvcHMgcmVwb3J0aW5nIHRoZSBlYXJsaWVyIHBhdGNoIG9uY2UgdGhhdCBwYXRjaCdzIGNvbXBvbmVudCB1bmxvYWRzLlxuICpcbiAqIEBwYXJhbSAkZnVuY3Rpb24gLSBUaGUgZnVuY3Rpb24gdG8gY2hlY2suXG4gKiBAcGFyYW0gcGF0Y2hUb2tlbiAtIFRoZSBwYXRjaCB0b2tlbiB0byBjaGVjayBmb3IuXG4gKiBAcmV0dXJucyBXaGV0aGVyIHRoZSBmdW5jdGlvbiBoYXMgdGhlIHBhdGNoIHRva2VuLlxuICovXG5leHBvcnQgZnVuY3Rpb24gaGFzUGF0Y2hUb2tlbigkZnVuY3Rpb246IEdlbmVyaWNGdW5jdGlvbiwgcGF0Y2hUb2tlbjogc3ltYm9sKTogYm9vbGVhbiB7XG4gIHJldHVybiBnZXRNb25rZXlBcm91bmRQYXRjaGVzKCkuZ2V0KCRmdW5jdGlvbikgPT09IHBhdGNoVG9rZW47XG59XG5cbmZ1bmN0aW9uIGdldE1vbmtleUFyb3VuZFBhdGNoZXMoKTogV2Vha01hcDxHZW5lcmljRnVuY3Rpb24sIHN5bWJvbD4ge1xuICByZXR1cm4gZ2V0T2JzaWRpYW5EZXZVdGlsc1N0YXRlKCdtb25rZXlBcm91bmRQYXRjaGVzJywgbmV3IFdlYWtNYXA8R2VuZXJpY0Z1bmN0aW9uLCBzeW1ib2w+KCkpLnZhbHVlO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFXQSxTQUFTLFVBQVUsc0JBQXNCO0FBRXpDLFNBQVMsZ0NBQWdDO0FBQ3pDLFNBQVMsbUJBQW1CO0FBNk1yQixNQUFNLDhCQUE4QixZQUFZO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVE5QyxzQkFDTCxRQUNNO0FBQ04sU0FBSyxhQUFhO0FBRWxCLFVBQU0sWUFBZ0MsQ0FBQztBQUV2QyxjQUFVLE9BQU8sWUFBWSxJQUFJLENBQUMsa0JBQWdFO0FBQ2hHLFlBQU0sZUFBZSxPQUFPLGFBQWEsYUFBYTtBQUN0RCxVQUFJLENBQUMsT0FBTyxNQUFNO0FBQ2hCLGVBQU87QUFBQSxNQUNUO0FBT0EsWUFBTSxrQkFBa0IsTUFBWTtBQUNsQyxhQUFLLE9BQU87QUFBQSxNQUNkO0FBQ0EsZUFBUyxvQkFBbUMsWUFBZ0M7QUFDMUUsWUFBSTtBQUNGLGlCQUFPLFFBQVEsTUFBTSxjQUFjLE1BQU0sVUFBVTtBQUFBLFFBQ3JELFVBQUU7QUFDQSwwQkFBZ0I7QUFBQSxRQUNsQjtBQUFBLE1BQ0Y7QUFDQSxhQUFPLE9BQU8sT0FBTyxrQkFBa0IsWUFBWTtBQUFBLElBQ3JEO0FBRUEsU0FBSyxjQUFjLE9BQU8sU0FBUyxTQUFTO0FBQUEsRUFDOUM7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBU08sb0JBQ0wsUUFDTTtBQUNOLFNBQUssYUFBYTtBQUlsQixTQUFLLHNCQUFzQjtBQUFBLE1BQ3pCLFNBQVMsT0FBTztBQUFBLE1BQ2hCLGNBQWMsT0FBTztBQUFBLE1BQ3JCLE1BQU0sT0FBTyxRQUFRO0FBQUEsTUFDckIsY0FBYyxDQUFDLHNCQUFzQjtBQUNuQyxjQUFNLGlCQUFpQjtBQUN2QixjQUFNLHFCQUFxQixPQUFPLG1CQUFtQjtBQUFBLFVBQ25EO0FBQUEsVUFDQSxlQUFBQTtBQUFBLFFBQ0YsQ0FBQyxLQUFLQTtBQUNOLGVBQU87QUFFUCxpQkFBU0Esa0JBQWdDLG1CQUFpRTtBQUV4RyxnQkFBTSxlQUFlO0FBQ3JCLGlCQUFPLE9BQU8sYUFBYTtBQUFBLFlBQ3pCLFdBQVc7QUFDVCxxQkFBTyxlQUFlLEtBQUssY0FBYyxHQUFHLGlCQUFpQjtBQUFBLFlBQy9EO0FBQUEsWUFDQTtBQUFBLFlBQ0E7QUFBQSxZQUNBLHFCQUFxQixlQUFlLEtBQUssWUFBWTtBQUFBLFlBQ3JEO0FBQUEsVUFDRixDQUFDO0FBQUEsUUFDSDtBQUFBLE1BQ0Y7QUFBQSxJQUNGLENBQUM7QUFFRCxRQUFJLENBQUMsT0FBTyxZQUFZO0FBQ3RCO0FBQUEsSUFDRjtBQU9BLFVBQU0sZ0JBQWdCLE9BQU8sUUFBUSxPQUFPLFVBQVU7QUFDdEQsVUFBTSxzQkFBc0IsdUJBQXVCO0FBQ25ELHdCQUFvQixJQUFJLGVBQWUsT0FBTyxVQUFVO0FBQ3hELFNBQUssU0FBUyxNQUFNO0FBQ2xCLDBCQUFvQixPQUFPLGFBQWE7QUFBQSxJQUMxQyxDQUFDO0FBQUEsRUFDSDtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFTTyxjQUFzQyxTQUFrQixXQUFxQztBQUNsRyxTQUFLLGFBQWE7QUFFbEIsVUFBTSxjQUFjLE9BQU8sU0FBUyxTQUFTO0FBQzdDLFNBQUssU0FBUyxXQUFXO0FBQUEsRUFDM0I7QUFDRjtBQVdPLFNBQVMsT0FBK0IsU0FBa0IsV0FBNEM7QUFDM0csU0FBTyxlQUFlLFNBQTBCLFNBQTZDO0FBQy9GO0FBd0JPLFNBQVMsY0FBYyxXQUE0QixZQUE2QjtBQUNyRixTQUFPLHVCQUF1QixFQUFFLElBQUksU0FBUyxNQUFNO0FBQ3JEO0FBRUEsU0FBUyx5QkFBMkQ7QUFDbEUsU0FBTyx5QkFBeUIsdUJBQXVCLG9CQUFJLFFBQWlDLENBQUMsRUFBRTtBQUNqRzsiLAogICJuYW1lcyI6IFsicGF0Y2hlZE1ldGhvZCJdCn0K

package/dist/lib/esm/components/notebook-navigator-menu-event-registrar-component.d.mts

@@ -0,0 +1,150 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Bridges the file and files context-menu events into Notebook Navigator's own menus.
+ *
+ * Notebook Navigator draws its own file tree and never raises Obsidian's `file-menu` / `files-menu`
+ * workspace events, so a plugin's context-menu items vanish for anyone browsing through it. This
+ * component is a {@link MenuEventRegistrar} backed by Notebook Navigator's extension API instead of
+ * the workspace, so the very same handlers reach both surfaces.
+ */
+import type { DisposableEx } from '@mnaoumov/typescript-lib/disposable';
+import type { App, IconName } from 'obsidian';
+import type { EditorMenuEventHandler, FileMenuEventHandler, FilesMenuEventHandler, MarkdownViewportMenuEventHandler, MenuEventRegistrar } from '../menu-event-registrar.mjs';
+import { LayoutReadyComponent } from './layout-ready-component.mjs';
+/**
+ * Parameters for {@link NotebookNavigatorMenuEventRegistrarComponent}.
+ */
+export interface NotebookNavigatorMenuEventRegistrarComponentConstructorParams {
+    /**
+     * The application instance.
+     */
+    readonly app: App;
+    /**
+     * The plugin's display name, which titles the parent entry.
+     */
+    readonly pluginName: string;
+    /**
+     * The icon for the parent entry.
+     *
+     * @default `''` (no icon)
+     */
+    readonly submenuIcon?: IconName | undefined;
+}
+/**
+ * {@link MenuEventRegistrar} backed by Notebook Navigator's menu-extension API.
+ *
+ * Handlers registered here are collected eagerly and bound to Notebook Navigator once the workspace
+ * layout is ready. When Notebook Navigator is not installed the component simply stays dormant.
+ *
+ * Every collected handler writes into a plugin-titled parent entry's submenu, so a handler must NOT
+ * declare a section submenu of its own — `Menu.sort()` would fold that into a second, nested
+ * plugin-titled entry. `CommandHandlerComponent` takes care of this by forcing
+ * `CommandHandlerRegistrationContext.shouldAddCommandToSubmenu` off for the surfaces it feeds here.
+ */
+export declare class NotebookNavigatorMenuEventRegistrarComponent extends LayoutReadyComponent implements MenuEventRegistrar {
+    /**
+     * The plugin's display name, which titles the parent entry.
+     */
+    protected readonly pluginName: string;
+    /**
+     * The icon for the parent entry.
+     */
+    protected readonly submenuIcon: IconName;
+    private fileMenuEventHandlers;
+    private filesMenuEventHandlers;
+    /**
+     * Creates a new Notebook Navigator menu event registrar.
+     *
+     * @param params - The parameters for the component.
+     */
+    constructor(params: NotebookNavigatorMenuEventRegistrarComponentConstructorParams);
+    /**
+     * Accepts an editor-menu registration and does nothing with it.
+     *
+     * Notebook Navigator extends the file tree, not the editor — an editor menu there is Obsidian's
+     * own, which the handlers already reach through the workspace event. The registration is inert
+     * rather than refused so a handler that declares one is not a load-time error.
+     *
+     * @param _handler - The handler, deliberately unused.
+     * @returns A {@link DisposableEx} that has nothing to undo.
+     */
+    registerEditorMenuEventHandler(_handler: EditorMenuEventHandler): DisposableEx;
+    /**
+     * Collects a single-file menu handler.
+     *
+     * @param handler - The handler to collect.
+     * @returns A {@link DisposableEx} that drops the handler again (or on component unload).
+     */
+    registerFileMenuEventHandler(handler: FileMenuEventHandler): DisposableEx;
+    /**
+     * Collects a multi-file menu handler.
+     *
+     * @param handler - The handler to collect.
+     * @returns A {@link DisposableEx} that drops the handler again (or on component unload).
+     */
+    registerFilesMenuEventHandler(handler: FilesMenuEventHandler): DisposableEx;
+    /**
+     * Accepts a markdown-viewport-menu registration and does nothing with it.
+     *
+     * Notebook Navigator extends the file tree, not the editor — the margin beside a note's text is
+     * Obsidian's own viewport, which the handlers already reach through the workspace event. The
+     * registration is inert rather than refused so a handler that declares one is not a load-time error.
+     *
+     * @param _handler - The handler, deliberately unused.
+     * @returns A {@link DisposableEx} that has nothing to undo.
+     */
+    registerMarkdownViewportMenuEventHandler(_handler: MarkdownViewportMenuEventHandler): DisposableEx;
+    /**
+     * Binds to Notebook Navigator once every plugin has loaded.
+     *
+     * Layout-ready rather than `onload`: plugin load order is not ours to choose, and Notebook
+     * Navigator's API only exists once its own plugin is up. When it is not installed the component
+     * stays dormant — enabling it later takes an Obsidian reload, exactly as it does for anything else
+     * that reads another plugin at startup.
+     */
+    protected onLayoutReady(): void;
+    /**
+     * Adds the plugin's entry, unless the handlers had nothing to contribute.
+     *
+     * The menu is populated TWICE, and both runs are needed: Notebook Navigator's `addItem` cannot be
+     * taken back once called, so the only way to keep an unrelated file's menu clean is to ask the
+     * handlers first, against a menu nobody sees. The gates they answer with are metadata reads, so the
+     * second run costs nothing and cannot disagree with the first.
+     *
+     * @param context - The Notebook Navigator menu being built.
+     * @param populate - Runs the collected handlers against a menu.
+     */
+    private contribute;
+    /**
+     * Handles a file menu, single or multi-selection.
+     *
+     * @param context - The Notebook Navigator menu being built.
+     */
+    private handleFileMenu;
+    /**
+     * Handles a folder menu.
+     *
+     * A folder goes through the SINGLE-file handlers, because that is how Obsidian's own `file-menu`
+     * carries one — the event is typed {@link TAbstractFile}, and the folder handlers are the ones that
+     * narrow it.
+     *
+     * @param context - The Notebook Navigator menu being built.
+     */
+    private handleFolderMenu;
+    /**
+     * Runs the single-file handlers against a menu.
+     *
+     * @param menu - The menu to populate.
+     * @param abstractFile - The file or folder the menu was raised on.
+     */
+    private runFileMenuHandlers;
+    /**
+     * Runs the multi-file handlers against a menu.
+     *
+     * @param menu - The menu to populate.
+     * @param abstractFiles - The files the menu was raised on.
+     */
+    private runFilesMenuHandlers;
+}