@mnaoumov/obsidian-lib 10.12.0 → 11.0.0

package/dist/lib/esm/worker-protocol.d.mts

@@ -0,0 +1,282 @@
+/// <reference path="./library-references.d.mts" />
+/// <reference lib="dom" />
+/// <reference lib="dom.iterable" />
+/**
+ * @file
+ *
+ * The message protocol between `WorkerComponent` on the main thread and {@link exposeWorkerApi} inside a worker.
+ *
+ * This module imports nothing, so a worker entry point bundled by `@mnaoumov/obsidian-dev-toolkit`'s `workers` feature
+ * can import it: a worker has no `obsidian` module and no Node builtins. Its message shapes are a wire format between
+ * the plugin's main bundle and its worker bundle, which may come from different copies of this library, so fields are
+ * only ever added and a change of meaning moves to a new {@link WORKER_PROTOCOL} value.
+ */
+/**
+ * The tag every message of this protocol carries. Messages without it are ignored on both sides, so a worker can
+ * exchange its own messages too.
+ */
+export declare const WORKER_PROTOCOL = "obsidian-lib-worker-v1";
+/**
+ * An error reduced to plain data, because an `Error` loses its class across the worker boundary.
+ */
+export interface SerializedWorkerError {
+    /**
+     * The error message.
+     */
+    readonly message: string;
+    /**
+     * The error name.
+     */
+    readonly name: string;
+    /**
+     * The stack in the worker, when there was one.
+     */
+    readonly stack?: string;
+}
+/**
+ * A result marked to transfer some of its objects rather than copy them. Build it with {@link withTransfer}.
+ *
+ * @typeParam TValue - The value type.
+ */
+export interface TransferredValue<TValue> {
+    /**
+     * The marker that identifies the wrapper structurally, so a wrapper built by another copy of this library is
+     * recognized too.
+     */
+    readonly __obsidianLibTransferredValue: true;
+    /**
+     * The objects to transfer.
+     */
+    readonly transfer: readonly Transferable[];
+    /**
+     * The value.
+     */
+    readonly value: TValue;
+}
+/**
+ * A value split from its transfer list, ready to post.
+ */
+export interface UnwrappedTransferredValue {
+    /**
+     * The objects to transfer.
+     */
+    readonly transfer: Transferable[];
+    /**
+     * The value to post.
+     */
+    readonly value: unknown;
+}
+/**
+ * An API a worker exposes: an object whose every member is a function.
+ *
+ * @typeParam TApi - The API type.
+ */
+export type WorkerApi<TApi> = {
+    readonly [TMethod in keyof TApi]: (...parameters: never[]) => unknown;
+};
+/**
+ * The handlers implementing a {@link WorkerApi}, with the {@link WorkerCallContext} as `this`.
+ *
+ * Each handler takes the method's arguments and returns its result, or a promise of it, or the result wrapped by
+ * {@link withTransfer} to transfer buffers back instead of copying them. Declare the handlers as methods or `function`
+ * expressions, not arrow functions, when they need `this`.
+ *
+ * @typeParam TApi - The API type.
+ */
+export type WorkerApiHandlers<TApi extends WorkerApi<TApi>> = {
+    readonly [TMethod in keyof TApi]: (this: WorkerCallContext, ...parameters: Parameters<TApi[TMethod]>) => WorkerHandlerResult<Awaited<ReturnType<TApi[TMethod]>>>;
+};
+/**
+ * The context of one call, passed to a handler as `this`.
+ */
+export interface WorkerCallContext {
+    /**
+     * Aborted when the caller cancels the call. A long handler checks it between steps; nothing interrupts a synchronous
+     * loop, so a job that cannot check it is stopped only by terminating the worker.
+     */
+    readonly abortSignal: AbortSignal;
+}
+/**
+ * A call from the main thread.
+ */
+export interface WorkerCallMessage {
+    /**
+     * The method's arguments.
+     */
+    readonly arguments: readonly unknown[];
+    /**
+     * The call id, unique per `WorkerComponent`.
+     */
+    readonly id: number;
+    /**
+     * The message kind.
+     */
+    readonly kind: 'call';
+    /**
+     * The method name.
+     */
+    readonly method: string;
+    /**
+     * The protocol tag.
+     */
+    readonly protocol: typeof WORKER_PROTOCOL;
+}
+/**
+ * A cancellation of a call from the main thread.
+ */
+export interface WorkerCancelMessage {
+    /**
+     * The id of the call to cancel.
+     */
+    readonly id: number;
+    /**
+     * The message kind.
+     */
+    readonly kind: 'cancel';
+    /**
+     * The protocol tag.
+     */
+    readonly protocol: typeof WORKER_PROTOCOL;
+}
+/**
+ * A failed call, answered by the worker.
+ */
+export interface WorkerErrorMessage {
+    /**
+     * The error, reduced to plain data.
+     */
+    readonly error: SerializedWorkerError;
+    /**
+     * The id of the call.
+     */
+    readonly id: number;
+    /**
+     * The message kind.
+     */
+    readonly kind: 'error';
+    /**
+     * The protocol tag.
+     */
+    readonly protocol: typeof WORKER_PROTOCOL;
+}
+/**
+ * What a handler may return.
+ *
+ * @typeParam TResult - The method's result type.
+ */
+export type WorkerHandlerResult<TResult> = Promise<TransferredValue<TResult> | TResult> | TransferredValue<TResult> | TResult;
+/**
+ * The port a worker talks through: the worker's global scope, or a test double.
+ */
+export interface WorkerMessagePort {
+    /**
+     * Subscribes to messages.
+     *
+     * @param type - Always `message`.
+     * @param listener - The listener.
+     */
+    readonly addEventListener: (type: 'message', listener: ($event: MessageEvent<unknown>) => void) => void;
+    /**
+     * Posts a message.
+     *
+     * @param message - The message.
+     * @param transfer - The objects to transfer.
+     */
+    readonly postMessage: (message: unknown, transfer: Transferable[]) => void;
+}
+/**
+ * Any message sent to the worker.
+ */
+export type WorkerRequestMessage = WorkerCallMessage | WorkerCancelMessage;
+/**
+ * Any message sent by the worker.
+ */
+export type WorkerResponseMessage = WorkerErrorMessage | WorkerResultMessage;
+/**
+ * A successful call, answered by the worker.
+ */
+export interface WorkerResultMessage {
+    /**
+     * The id of the call.
+     */
+    readonly id: number;
+    /**
+     * The message kind.
+     */
+    readonly kind: 'result';
+    /**
+     * The protocol tag.
+     */
+    readonly protocol: typeof WORKER_PROTOCOL;
+    /**
+     * The result.
+     */
+    readonly value: unknown;
+}
+/**
+ * Exposes handlers to the main thread. Call it once, at the top level of a worker entry point.
+ *
+ * A handler that throws or rejects answers with a {@link SerializedWorkerError}, which the caller receives as a
+ * `WorkerCallError`. An unknown method answers with an error too, so a caller never waits for nothing.
+ *
+ * @typeParam TApi - The API type.
+ * @param handlers - The handlers.
+ * @param port - The port to talk through. Defaults to the worker's global scope.
+ */
+export declare function exposeWorkerApi<TApi extends WorkerApi<TApi>>(handlers: WorkerApiHandlers<TApi>, port?: WorkerMessagePort): void;
+/**
+ * Calls one handler by name, as the worker does. `WorkerComponent` uses it for its main-thread fallback, so both paths
+ * behave alike.
+ *
+ * @param handlers - The handlers.
+ * @param method - The method name.
+ * @param callArguments - The arguments.
+ * @param context - The call context.
+ * @returns The result, or a {@link TransferredValue} wrapping it.
+ */
+export declare function invokeWorkerHandler(handlers: object, method: string, callArguments: readonly unknown[], context: WorkerCallContext): Promise<unknown>;
+/**
+ * Tells whether a value is a {@link TransferredValue}.
+ *
+ * @param value - The value.
+ * @returns Whether it is one.
+ */
+export declare function isTransferredValue(value: unknown): value is TransferredValue<unknown>;
+/**
+ * Tells whether a message is a request of this protocol.
+ *
+ * @param message - The message.
+ * @returns Whether it is one.
+ */
+export declare function isWorkerRequestMessage(message: unknown): message is WorkerRequestMessage;
+/**
+ * Tells whether a message is a response of this protocol.
+ *
+ * @param message - The message.
+ * @returns Whether it is one.
+ */
+export declare function isWorkerResponseMessage(message: unknown): message is WorkerResponseMessage;
+/**
+ * Reduces a thrown value to plain data.
+ *
+ * @param error - The thrown value.
+ * @returns The serialized error.
+ */
+export declare function serializeWorkerError(error: unknown): SerializedWorkerError;
+/**
+ * Splits a result into the value to post and the objects to transfer.
+ *
+ * @param result - A result, possibly wrapped by {@link withTransfer}.
+ * @returns The value and its transfer list.
+ */
+export declare function unwrapTransferredValue(result: unknown): UnwrappedTransferredValue;
+/**
+ * Marks a result to transfer some of its objects (an `ArrayBuffer`, a `MessagePort`, an `OffscreenCanvas`...) instead
+ * of copying them. A transferred object is unusable on the sending side afterwards.
+ *
+ * @typeParam TValue - The value type.
+ * @param value - The value.
+ * @param transfer - The objects inside it to transfer.
+ * @returns The wrapped value.
+ */
+export declare function withTransfer<TValue>(value: TValue, transfer: readonly Transferable[]): TransferredValue<TValue>;

package/dist/lib/esm/worker-protocol.mjs

@@ -0,0 +1,113 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+const WORKER_PROTOCOL = "obsidian-lib-worker-v1";
+function exposeWorkerApi(handlers, port) {
+  const messagePort = port ?? getWorkerGlobalScope();
+  const abortControllers = /* @__PURE__ */ new Map();
+  messagePort.addEventListener("message", ($event) => {
+    const message = $event.data;
+    if (!isWorkerRequestMessage(message)) {
+      return;
+    }
+    if (message.kind === "cancel") {
+      abortControllers.get(message.id)?.abort(new Error("The call was cancelled"));
+      return;
+    }
+    const abortController = new AbortController();
+    abortControllers.set(message.id, abortController);
+    void answerCall(message, abortController.signal);
+  });
+  async function answerCall(message, abortSignal) {
+    let response;
+    try {
+      const value = await invokeWorkerHandler(handlers, message.method, message.arguments, { abortSignal });
+      response = { id: message.id, kind: "result", protocol: WORKER_PROTOCOL, value };
+    } catch (error) {
+      response = { error: serializeWorkerError(error), id: message.id, kind: "error", protocol: WORKER_PROTOCOL };
+    }
+    abortControllers.delete(message.id);
+    postResponse(messagePort, response);
+  }
+}
+async function invokeWorkerHandler(handlers, method, callArguments, context) {
+  const handler = Object.hasOwn(handlers, method) ? handlers[method] : void 0;
+  if (typeof handler !== "function") {
+    throw new TypeError(`The worker exposes no method named '${method}'`);
+  }
+  return await handler.apply(context, [...callArguments]);
+}
+function isTransferredValue(value) {
+  return typeof value === "object" && value !== null && value.__obsidianLibTransferredValue === true;
+}
+function isWorkerRequestMessage(message) {
+  if (!hasProtocol(message)) {
+    return false;
+  }
+  const candidate = message;
+  if (typeof candidate.id !== "number") {
+    return false;
+  }
+  if (candidate.kind === "cancel") {
+    return true;
+  }
+  return candidate.kind === "call" && typeof candidate.method === "string" && Array.isArray(candidate.arguments);
+}
+function isWorkerResponseMessage(message) {
+  if (!hasProtocol(message)) {
+    return false;
+  }
+  const candidate = message;
+  if (typeof candidate.id !== "number") {
+    return false;
+  }
+  if (candidate.kind === "result") {
+    return true;
+  }
+  return candidate.kind === "error" && typeof candidate.error === "object";
+}
+function serializeWorkerError(error) {
+  if (!(error instanceof Error)) {
+    return { message: String(error), name: "Error" };
+  }
+  return error.stack === void 0 ? { message: error.message, name: error.name } : { message: error.message, name: error.name, stack: error.stack };
+}
+function unwrapTransferredValue(result) {
+  return isTransferredValue(result) ? { transfer: [...result.transfer], value: result.value } : { transfer: [], value: result };
+}
+function withTransfer(value, transfer) {
+  return { __obsidianLibTransferredValue: true, transfer, value };
+}
+function getWorkerGlobalScope() {
+  const scope = globalThis;
+  return scope;
+}
+function hasProtocol(message) {
+  return typeof message === "object" && message !== null && message.protocol === WORKER_PROTOCOL;
+}
+function postResponse(port, response) {
+  if (response.kind === "error") {
+    port.postMessage(response, []);
+    return;
+  }
+  const { transfer, value } = unwrapTransferredValue(response.value);
+  try {
+    port.postMessage({ ...response, value }, transfer);
+  } catch (error) {
+    port.postMessage({ error: serializeWorkerError(error), id: response.id, kind: "error", protocol: WORKER_PROTOCOL }, []);
+  }
+}
+export {
+  WORKER_PROTOCOL,
+  exposeWorkerApi,
+  invokeWorkerHandler,
+  isTransferredValue,
+  isWorkerRequestMessage,
+  isWorkerResponseMessage,
+  serializeWorkerError,
+  unwrapTransferredValue,
+  withTransfer
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3dvcmtlci1wcm90b2NvbC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFRoZSBtZXNzYWdlIHByb3RvY29sIGJldHdlZW4gYFdvcmtlckNvbXBvbmVudGAgb24gdGhlIG1haW4gdGhyZWFkIGFuZCB7QGxpbmsgZXhwb3NlV29ya2VyQXBpfSBpbnNpZGUgYSB3b3JrZXIuXG4gKlxuICogVGhpcyBtb2R1bGUgaW1wb3J0cyBub3RoaW5nLCBzbyBhIHdvcmtlciBlbnRyeSBwb2ludCBidW5kbGVkIGJ5IGBAbW5hb3Vtb3Yvb2JzaWRpYW4tZGV2LXRvb2xraXRgJ3MgYHdvcmtlcnNgIGZlYXR1cmVcbiAqIGNhbiBpbXBvcnQgaXQ6IGEgd29ya2VyIGhhcyBubyBgb2JzaWRpYW5gIG1vZHVsZSBhbmQgbm8gTm9kZSBidWlsdGlucy4gSXRzIG1lc3NhZ2Ugc2hhcGVzIGFyZSBhIHdpcmUgZm9ybWF0IGJldHdlZW5cbiAqIHRoZSBwbHVnaW4ncyBtYWluIGJ1bmRsZSBhbmQgaXRzIHdvcmtlciBidW5kbGUsIHdoaWNoIG1heSBjb21lIGZyb20gZGlmZmVyZW50IGNvcGllcyBvZiB0aGlzIGxpYnJhcnksIHNvIGZpZWxkcyBhcmVcbiAqIG9ubHkgZXZlciBhZGRlZCBhbmQgYSBjaGFuZ2Ugb2YgbWVhbmluZyBtb3ZlcyB0byBhIG5ldyB7QGxpbmsgV09SS0VSX1BST1RPQ09MfSB2YWx1ZS5cbiAqL1xuXG4vKipcbiAqIFRoZSB0YWcgZXZlcnkgbWVzc2FnZSBvZiB0aGlzIHByb3RvY29sIGNhcnJpZXMuIE1lc3NhZ2VzIHdpdGhvdXQgaXQgYXJlIGlnbm9yZWQgb24gYm90aCBzaWRlcywgc28gYSB3b3JrZXIgY2FuXG4gKiBleGNoYW5nZSBpdHMgb3duIG1lc3NhZ2VzIHRvby5cbiAqL1xuZXhwb3J0IGNvbnN0IFdPUktFUl9QUk9UT0NPTCA9ICdvYnNpZGlhbi1saWItd29ya2VyLXYxJztcblxuLyoqXG4gKiBBbiBlcnJvciByZWR1Y2VkIHRvIHBsYWluIGRhdGEsIGJlY2F1c2UgYW4gYEVycm9yYCBsb3NlcyBpdHMgY2xhc3MgYWNyb3NzIHRoZSB3b3JrZXIgYm91bmRhcnkuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgU2VyaWFsaXplZFdvcmtlckVycm9yIHtcbiAgLyoqXG4gICAqIFRoZSBlcnJvciBtZXNzYWdlLlxuICAgKi9cbiAgcmVhZG9ubHkgbWVzc2FnZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgZXJyb3IgbmFtZS5cbiAgICovXG4gIHJlYWRvbmx5IG5hbWU6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIHN0YWNrIGluIHRoZSB3b3JrZXIsIHdoZW4gdGhlcmUgd2FzIG9uZS5cbiAgICovXG4gIHJlYWRvbmx5IHN0YWNrPzogc3RyaW5nO1xufVxuXG4vKipcbiAqIEEgcmVzdWx0IG1hcmtlZCB0byB0cmFuc2ZlciBzb21lIG9mIGl0cyBvYmplY3RzIHJhdGhlciB0aGFuIGNvcHkgdGhlbS4gQnVpbGQgaXQgd2l0aCB7QGxpbmsgd2l0aFRyYW5zZmVyfS5cbiAqXG4gKiBAdHlwZVBhcmFtIFRWYWx1ZSAtIFRoZSB2YWx1ZSB0eXBlLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFRyYW5zZmVycmVkVmFsdWU8VFZhbHVlPiB7XG4gIC8qKlxuICAgKiBUaGUgbWFya2VyIHRoYXQgaWRlbnRpZmllcyB0aGUgd3JhcHBlciBzdHJ1Y3R1cmFsbHksIHNvIGEgd3JhcHBlciBidWlsdCBieSBhbm90aGVyIGNvcHkgb2YgdGhpcyBsaWJyYXJ5IGlzXG4gICAqIHJlY29nbml6ZWQgdG9vLlxuICAgKi9cbiAgcmVhZG9ubHkgX19vYnNpZGlhbkxpYlRyYW5zZmVycmVkVmFsdWU6IHRydWU7XG5cbiAgLyoqXG4gICAqIFRoZSBvYmplY3RzIHRvIHRyYW5zZmVyLlxuICAgKi9cbiAgcmVhZG9ubHkgdHJhbnNmZXI6IHJlYWRvbmx5IFRyYW5zZmVyYWJsZVtdO1xuXG4gIC8qKlxuICAgKiBUaGUgdmFsdWUuXG4gICAqL1xuICByZWFkb25seSB2YWx1ZTogVFZhbHVlO1xufVxuXG4vKipcbiAqIEEgdmFsdWUgc3BsaXQgZnJvbSBpdHMgdHJhbnNmZXIgbGlzdCwgcmVhZHkgdG8gcG9zdC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBVbndyYXBwZWRUcmFuc2ZlcnJlZFZhbHVlIHtcbiAgLyoqXG4gICAqIFRoZSBvYmplY3RzIHRvIHRyYW5zZmVyLlxuICAgKi9cbiAgcmVhZG9ubHkgdHJhbnNmZXI6IFRyYW5zZmVyYWJsZVtdO1xuXG4gIC8qKlxuICAgKiBUaGUgdmFsdWUgdG8gcG9zdC5cbiAgICovXG4gIHJlYWRvbmx5IHZhbHVlOiB1bmtub3duO1xufVxuXG4vKipcbiAqIEFuIEFQSSBhIHdvcmtlciBleHBvc2VzOiBhbiBvYmplY3Qgd2hvc2UgZXZlcnkgbWVtYmVyIGlzIGEgZnVuY3Rpb24uXG4gKlxuICogQHR5cGVQYXJhbSBUQXBpIC0gVGhlIEFQSSB0eXBlLlxuICovXG5leHBvcnQgdHlwZSBXb3JrZXJBcGk8VEFwaT4gPSB7IHJlYWRvbmx5IFtUTWV0aG9kIGluIGtleW9mIFRBcGldOiAoLi4ucGFyYW1ldGVyczogbmV2ZXJbXSkgPT4gdW5rbm93biB9O1xuXG4vKipcbiAqIFRoZSBoYW5kbGVycyBpbXBsZW1lbnRpbmcgYSB7QGxpbmsgV29ya2VyQXBpfSwgd2l0aCB0aGUge0BsaW5rIFdvcmtlckNhbGxDb250ZXh0fSBhcyBgdGhpc2AuXG4gKlxuICogRWFjaCBoYW5kbGVyIHRha2VzIHRoZSBtZXRob2QncyBhcmd1bWVudHMgYW5kIHJldHVybnMgaXRzIHJlc3VsdCwgb3IgYSBwcm9taXNlIG9mIGl0LCBvciB0aGUgcmVzdWx0IHdyYXBwZWQgYnlcbiAqIHtAbGluayB3aXRoVHJhbnNmZXJ9IHRvIHRyYW5zZmVyIGJ1ZmZlcnMgYmFjayBpbnN0ZWFkIG9mIGNvcHlpbmcgdGhlbS4gRGVjbGFyZSB0aGUgaGFuZGxlcnMgYXMgbWV0aG9kcyBvciBgZnVuY3Rpb25gXG4gKiBleHByZXNzaW9ucywgbm90IGFycm93IGZ1bmN0aW9ucywgd2hlbiB0aGV5IG5lZWQgYHRoaXNgLlxuICpcbiAqIEB0eXBlUGFyYW0gVEFwaSAtIFRoZSBBUEkgdHlwZS5cbiAqL1xuZXhwb3J0IHR5cGUgV29ya2VyQXBpSGFuZGxlcnM8VEFwaSBleHRlbmRzIFdvcmtlckFwaTxUQXBpPj4gPSB7XG4gIHJlYWRvbmx5IFtUTWV0aG9kIGluIGtleW9mIFRBcGldOiAoXG4gICAgdGhpczogV29ya2VyQ2FsbENvbnRleHQsXG4gICAgLi4ucGFyYW1ldGVyczogUGFyYW1ldGVyczxUQXBpW1RNZXRob2RdPlxuICApID0+IFdvcmtlckhhbmRsZXJSZXN1bHQ8QXdhaXRlZDxSZXR1cm5UeXBlPFRBcGlbVE1ldGhvZF0+Pj47XG59O1xuXG4vKipcbiAqIFRoZSBjb250ZXh0IG9mIG9uZSBjYWxsLCBwYXNzZWQgdG8gYSBoYW5kbGVyIGFzIGB0aGlzYC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBXb3JrZXJDYWxsQ29udGV4dCB7XG4gIC8qKlxuICAgKiBBYm9ydGVkIHdoZW4gdGhlIGNhbGxlciBjYW5jZWxzIHRoZSBjYWxsLiBBIGxvbmcgaGFuZGxlciBjaGVja3MgaXQgYmV0d2VlbiBzdGVwczsgbm90aGluZyBpbnRlcnJ1cHRzIGEgc3luY2hyb25vdXNcbiAgICogbG9vcCwgc28gYSBqb2IgdGhhdCBjYW5ub3QgY2hlY2sgaXQgaXMgc3RvcHBlZCBvbmx5IGJ5IHRlcm1pbmF0aW5nIHRoZSB3b3JrZXIuXG4gICAqL1xuICByZWFkb25seSBhYm9ydFNpZ25hbDogQWJvcnRTaWduYWw7XG59XG5cbi8qKlxuICogQSBjYWxsIGZyb20gdGhlIG1haW4gdGhyZWFkLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFdvcmtlckNhbGxNZXNzYWdlIHtcbiAgLyoqXG4gICAqIFRoZSBtZXRob2QncyBhcmd1bWVudHMuXG4gICAqL1xuICByZWFkb25seSBhcmd1bWVudHM6IHJlYWRvbmx5IHVua25vd25bXTtcblxuICAvKipcbiAgICogVGhlIGNhbGwgaWQsIHVuaXF1ZSBwZXIgYFdvcmtlckNvbXBvbmVudGAuXG4gICAqL1xuICByZWFkb25seSBpZDogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBUaGUgbWVzc2FnZSBraW5kLlxuICAgKi9cbiAgcmVhZG9ubHkga2luZDogJ2NhbGwnO1xuXG4gIC8qKlxuICAgKiBUaGUgbWV0aG9kIG5hbWUuXG4gICAqL1xuICByZWFkb25seSBtZXRob2Q6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIHByb3RvY29sIHRhZy5cbiAgICovXG4gIHJlYWRvbmx5IHByb3RvY29sOiB0eXBlb2YgV09SS0VSX1BST1RPQ09MO1xufVxuXG4vKipcbiAqIEEgY2FuY2VsbGF0aW9uIG9mIGEgY2FsbCBmcm9tIHRoZSBtYWluIHRocmVhZC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBXb3JrZXJDYW5jZWxNZXNzYWdlIHtcbiAgLyoqXG4gICAqIFRoZSBpZCBvZiB0aGUgY2FsbCB0byBjYW5jZWwuXG4gICAqL1xuICByZWFkb25seSBpZDogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBUaGUgbWVzc2FnZSBraW5kLlxuICAgKi9cbiAgcmVhZG9ubHkga2luZDogJ2NhbmNlbCc7XG5cbiAgLyoqXG4gICAqIFRoZSBwcm90b2NvbCB0YWcuXG4gICAqL1xuICByZWFkb25seSBwcm90b2NvbDogdHlwZW9mIFdPUktFUl9QUk9UT0NPTDtcbn1cblxuLyoqXG4gKiBBIGZhaWxlZCBjYWxsLCBhbnN3ZXJlZCBieSB0aGUgd29ya2VyLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFdvcmtlckVycm9yTWVzc2FnZSB7XG4gIC8qKlxuICAgKiBUaGUgZXJyb3IsIHJlZHVjZWQgdG8gcGxhaW4gZGF0YS5cbiAgICovXG4gIHJlYWRvbmx5IGVycm9yOiBTZXJpYWxpemVkV29ya2VyRXJyb3I7XG5cbiAgLyoqXG4gICAqIFRoZSBpZCBvZiB0aGUgY2FsbC5cbiAgICovXG4gIHJlYWRvbmx5IGlkOiBudW1iZXI7XG5cbiAgLyoqXG4gICAqIFRoZSBtZXNzYWdlIGtpbmQuXG4gICAqL1xuICByZWFkb25seSBraW5kOiAnZXJyb3InO1xuXG4gIC8qKlxuICAgKiBUaGUgcHJvdG9jb2wgdGFnLlxuICAgKi9cbiAgcmVhZG9ubHkgcHJvdG9jb2w6IHR5cGVvZiBXT1JLRVJfUFJPVE9DT0w7XG59XG5cbi8qKlxuICogV2hhdCBhIGhhbmRsZXIgbWF5IHJldHVybi5cbiAqXG4gKiBAdHlwZVBhcmFtIFRSZXN1bHQgLSBUaGUgbWV0aG9kJ3MgcmVzdWx0IHR5cGUuXG4gKi9cbmV4cG9ydCB0eXBlIFdvcmtlckhhbmRsZXJSZXN1bHQ8VFJlc3VsdD4gPSBQcm9taXNlPFRyYW5zZmVycmVkVmFsdWU8VFJlc3VsdD4gfCBUUmVzdWx0PiB8IFRyYW5zZmVycmVkVmFsdWU8VFJlc3VsdD4gfCBUUmVzdWx0O1xuXG4vKipcbiAqIFRoZSBwb3J0IGEgd29ya2VyIHRhbGtzIHRocm91Z2g6IHRoZSB3b3JrZXIncyBnbG9iYWwgc2NvcGUsIG9yIGEgdGVzdCBkb3VibGUuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgV29ya2VyTWVzc2FnZVBvcnQge1xuICAvKipcbiAgICogU3Vic2NyaWJlcyB0byBtZXNzYWdlcy5cbiAgICpcbiAgICogQHBhcmFtIHR5cGUgLSBBbHdheXMgYG1lc3NhZ2VgLlxuICAgKiBAcGFyYW0gbGlzdGVuZXIgLSBUaGUgbGlzdGVuZXIuXG4gICAqL1xuICByZWFkb25seSBhZGRFdmVudExpc3RlbmVyOiAodHlwZTogJ21lc3NhZ2UnLCBsaXN0ZW5lcjogKCRldmVudDogTWVzc2FnZUV2ZW50PHVua25vd24+KSA9PiB2b2lkKSA9PiB2b2lkO1xuXG4gIC8qKlxuICAgKiBQb3N0cyBhIG1lc3NhZ2UuXG4gICAqXG4gICAqIEBwYXJhbSBtZXNzYWdlIC0gVGhlIG1lc3NhZ2UuXG4gICAqIEBwYXJhbSB0cmFuc2ZlciAtIFRoZSBvYmplY3RzIHRvIHRyYW5zZmVyLlxuICAgKi9cbiAgcmVhZG9ubHkgcG9zdE1lc3NhZ2U6IChtZXNzYWdlOiB1bmtub3duLCB0cmFuc2ZlcjogVHJhbnNmZXJhYmxlW10pID0+IHZvaWQ7XG59XG5cbi8qKlxuICogQW55IG1lc3NhZ2Ugc2VudCB0byB0aGUgd29ya2VyLlxuICovXG5leHBvcnQgdHlwZSBXb3JrZXJSZXF1ZXN0TWVzc2FnZSA9IFdvcmtlckNhbGxNZXNzYWdlIHwgV29ya2VyQ2FuY2VsTWVzc2FnZTtcblxuLyoqXG4gKiBBbnkgbWVzc2FnZSBzZW50IGJ5IHRoZSB3b3JrZXIuXG4gKi9cbmV4cG9ydCB0eXBlIFdvcmtlclJlc3BvbnNlTWVzc2FnZSA9IFdvcmtlckVycm9yTWVzc2FnZSB8IFdvcmtlclJlc3VsdE1lc3NhZ2U7XG5cbi8qKlxuICogQSBzdWNjZXNzZnVsIGNhbGwsIGFuc3dlcmVkIGJ5IHRoZSB3b3JrZXIuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgV29ya2VyUmVzdWx0TWVzc2FnZSB7XG4gIC8qKlxuICAgKiBUaGUgaWQgb2YgdGhlIGNhbGwuXG4gICAqL1xuICByZWFkb25seSBpZDogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBUaGUgbWVzc2FnZSBraW5kLlxuICAgKi9cbiAgcmVhZG9ubHkga2luZDogJ3Jlc3VsdCc7XG5cbiAgLyoqXG4gICAqIFRoZSBwcm90b2NvbCB0YWcuXG4gICAqL1xuICByZWFkb25seSBwcm90b2NvbDogdHlwZW9mIFdPUktFUl9QUk9UT0NPTDtcblxuICAvKipcbiAgICogVGhlIHJlc3VsdC5cbiAgICovXG4gIHJlYWRvbmx5IHZhbHVlOiB1bmtub3duO1xufVxuXG5pbnRlcmZhY2UgUHJvdG9jb2xUYWdnZWRNZXNzYWdlIHtcbiAgcmVhZG9ubHkgcHJvdG9jb2w/OiB1bmtub3duO1xufVxuXG4vKipcbiAqIEV4cG9zZXMgaGFuZGxlcnMgdG8gdGhlIG1haW4gdGhyZWFkLiBDYWxsIGl0IG9uY2UsIGF0IHRoZSB0b3AgbGV2ZWwgb2YgYSB3b3JrZXIgZW50cnkgcG9pbnQuXG4gKlxuICogQSBoYW5kbGVyIHRoYXQgdGhyb3dzIG9yIHJlamVjdHMgYW5zd2VycyB3aXRoIGEge0BsaW5rIFNlcmlhbGl6ZWRXb3JrZXJFcnJvcn0sIHdoaWNoIHRoZSBjYWxsZXIgcmVjZWl2ZXMgYXMgYVxuICogYFdvcmtlckNhbGxFcnJvcmAuIEFuIHVua25vd24gbWV0aG9kIGFuc3dlcnMgd2l0aCBhbiBlcnJvciB0b28sIHNvIGEgY2FsbGVyIG5ldmVyIHdhaXRzIGZvciBub3RoaW5nLlxuICpcbiAqIEB0eXBlUGFyYW0gVEFwaSAtIFRoZSBBUEkgdHlwZS5cbiAqIEBwYXJhbSBoYW5kbGVycyAtIFRoZSBoYW5kbGVycy5cbiAqIEBwYXJhbSBwb3J0IC0gVGhlIHBvcnQgdG8gdGFsayB0aHJvdWdoLiBEZWZhdWx0cyB0byB0aGUgd29ya2VyJ3MgZ2xvYmFsIHNjb3BlLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZXhwb3NlV29ya2VyQXBpPFRBcGkgZXh0ZW5kcyBXb3JrZXJBcGk8VEFwaT4+KGhhbmRsZXJzOiBXb3JrZXJBcGlIYW5kbGVyczxUQXBpPiwgcG9ydD86IFdvcmtlck1lc3NhZ2VQb3J0KTogdm9pZCB7XG4gIGNvbnN0IG1lc3NhZ2VQb3J0ID0gcG9ydCA/PyBnZXRXb3JrZXJHbG9iYWxTY29wZSgpO1xuICBjb25zdCBhYm9ydENvbnRyb2xsZXJzID0gbmV3IE1hcDxudW1iZXIsIEFib3J0Q29udHJvbGxlcj4oKTtcblxuICBtZXNzYWdlUG9ydC5hZGRFdmVudExpc3RlbmVyKCdtZXNzYWdlJywgKCRldmVudCk6IHZvaWQgPT4ge1xuICAgIGNvbnN0IG1lc3NhZ2UgPSAkZXZlbnQuZGF0YTtcbiAgICBpZiAoIWlzV29ya2VyUmVxdWVzdE1lc3NhZ2UobWVzc2FnZSkpIHtcbiAgICAgIHJldHVybjtcbiAgICB9XG5cbiAgICBpZiAobWVzc2FnZS5raW5kID09PSAnY2FuY2VsJykge1xuICAgICAgYWJvcnRDb250cm9sbGVycy5nZXQobWVzc2FnZS5pZCk/LmFib3J0KG5ldyBFcnJvcignVGhlIGNhbGwgd2FzIGNhbmNlbGxlZCcpKTtcbiAgICAgIHJldHVybjtcbiAgICB9XG5cbiAgICBjb25zdCBhYm9ydENvbnRyb2xsZXIgPSBuZXcgQWJvcnRDb250cm9sbGVyKCk7XG4gICAgYWJvcnRDb250cm9sbGVycy5zZXQobWVzc2FnZS5pZCwgYWJvcnRDb250cm9sbGVyKTtcbiAgICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgbm8tdm9pZCAtLSBgYW5zd2VyQ2FsbGAgbmV2ZXIgcmVqZWN0czogaXQgYW5zd2VycyBldmVyeSBmYWlsdXJlIGFzIGEgbWVzc2FnZS5cbiAgICB2b2lkIGFuc3dlckNhbGwobWVzc2FnZSwgYWJvcnRDb250cm9sbGVyLnNpZ25hbCk7XG4gIH0pO1xuXG4gIGFzeW5jIGZ1bmN0aW9uIGFuc3dlckNhbGwobWVzc2FnZTogV29ya2VyQ2FsbE1lc3NhZ2UsIGFib3J0U2lnbmFsOiBBYm9ydFNpZ25hbCk6IFByb21pc2U8dm9pZD4ge1xuICAgIGxldCByZXNwb25zZTogV29ya2VyUmVzcG9uc2VNZXNzYWdlO1xuICAgIHRyeSB7XG4gICAgICBjb25zdCB2YWx1ZSA9IGF3YWl0IGludm9rZVdvcmtlckhhbmRsZXIoaGFuZGxlcnMsIG1lc3NhZ2UubWV0aG9kLCBtZXNzYWdlLmFyZ3VtZW50cywgeyBhYm9ydFNpZ25hbCB9KTtcbiAgICAgIHJlc3BvbnNlID0geyBpZDogbWVzc2FnZS5pZCwga2luZDogJ3Jlc3VsdCcsIHByb3RvY29sOiBXT1JLRVJfUFJPVE9DT0wsIHZhbHVlIH07XG4gICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgIHJlc3BvbnNlID0geyBlcnJvcjogc2VyaWFsaXplV29ya2VyRXJyb3IoZXJyb3IpLCBpZDogbWVzc2FnZS5pZCwga2luZDogJ2Vycm9yJywgcHJvdG9jb2w6IFdPUktFUl9QUk9UT0NPTCB9O1xuICAgIH1cbiAgICBhYm9ydENvbnRyb2xsZXJzLmRlbGV0ZShtZXNzYWdlLmlkKTtcbiAgICBwb3N0UmVzcG9uc2UobWVzc2FnZVBvcnQsIHJlc3BvbnNlKTtcbiAgfVxufVxuXG4vKipcbiAqIENhbGxzIG9uZSBoYW5kbGVyIGJ5IG5hbWUsIGFzIHRoZSB3b3JrZXIgZG9lcy4gYFdvcmtlckNvbXBvbmVudGAgdXNlcyBpdCBmb3IgaXRzIG1haW4tdGhyZWFkIGZhbGxiYWNrLCBzbyBib3RoIHBhdGhzXG4gKiBiZWhhdmUgYWxpa2UuXG4gKlxuICogQHBhcmFtIGhhbmRsZXJzIC0gVGhlIGhhbmRsZXJzLlxuICogQHBhcmFtIG1ldGhvZCAtIFRoZSBtZXRob2QgbmFtZS5cbiAqIEBwYXJhbSBjYWxsQXJndW1lbnRzIC0gVGhlIGFyZ3VtZW50cy5cbiAqIEBwYXJhbSBjb250ZXh0IC0gVGhlIGNhbGwgY29udGV4dC5cbiAqIEByZXR1cm5zIFRoZSByZXN1bHQsIG9yIGEge0BsaW5rIFRyYW5zZmVycmVkVmFsdWV9IHdyYXBwaW5nIGl0LlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gaW52b2tlV29ya2VySGFuZGxlcihcbiAgaGFuZGxlcnM6IG9iamVjdCxcbiAgbWV0aG9kOiBzdHJpbmcsXG4gIGNhbGxBcmd1bWVudHM6IHJlYWRvbmx5IHVua25vd25bXSxcbiAgY29udGV4dDogV29ya2VyQ2FsbENvbnRleHRcbik6IFByb21pc2U8dW5rbm93bj4ge1xuICBjb25zdCBoYW5kbGVyID0gT2JqZWN0Lmhhc093bihoYW5kbGVycywgbWV0aG9kKSA/IChoYW5kbGVycyBhcyBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPilbbWV0aG9kXSA6IHVuZGVmaW5lZDtcbiAgaWYgKHR5cGVvZiBoYW5kbGVyICE9PSAnZnVuY3Rpb24nKSB7XG4gICAgdGhyb3cgbmV3IFR5cGVFcnJvcihgVGhlIHdvcmtlciBleHBvc2VzIG5vIG1ldGhvZCBuYW1lZCAnJHttZXRob2R9J2ApO1xuICB9XG4gIHJldHVybiBhd2FpdCAoaGFuZGxlciBhcyAodGhpczogV29ya2VyQ2FsbENvbnRleHQsIC4uLmhhbmRsZXJBcmd1bWVudHM6IHVua25vd25bXSkgPT4gdW5rbm93bikuYXBwbHkoY29udGV4dCwgWy4uLmNhbGxBcmd1bWVudHNdKTtcbn1cblxuLyoqXG4gKiBUZWxscyB3aGV0aGVyIGEgdmFsdWUgaXMgYSB7QGxpbmsgVHJhbnNmZXJyZWRWYWx1ZX0uXG4gKlxuICogQHBhcmFtIHZhbHVlIC0gVGhlIHZhbHVlLlxuICogQHJldHVybnMgV2hldGhlciBpdCBpcyBvbmUuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc1RyYW5zZmVycmVkVmFsdWUodmFsdWU6IHVua25vd24pOiB2YWx1ZSBpcyBUcmFuc2ZlcnJlZFZhbHVlPHVua25vd24+IHtcbiAgcmV0dXJuIHR5cGVvZiB2YWx1ZSA9PT0gJ29iamVjdCcgJiYgdmFsdWUgIT09IG51bGwgJiYgKHZhbHVlIGFzIFBhcnRpYWw8VHJhbnNmZXJyZWRWYWx1ZTx1bmtub3duPj4pLl9fb2JzaWRpYW5MaWJUcmFuc2ZlcnJlZFZhbHVlID09PSB0cnVlO1xufVxuXG4vKipcbiAqIFRlbGxzIHdoZXRoZXIgYSBtZXNzYWdlIGlzIGEgcmVxdWVzdCBvZiB0aGlzIHByb3RvY29sLlxuICpcbiAqIEBwYXJhbSBtZXNzYWdlIC0gVGhlIG1lc3NhZ2UuXG4gKiBAcmV0dXJucyBXaGV0aGVyIGl0IGlzIG9uZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzV29ya2VyUmVxdWVzdE1lc3NhZ2UobWVzc2FnZTogdW5rbm93bik6IG1lc3NhZ2UgaXMgV29ya2VyUmVxdWVzdE1lc3NhZ2Uge1xuICBpZiAoIWhhc1Byb3RvY29sKG1lc3NhZ2UpKSB7XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG4gIGNvbnN0IGNhbmRpZGF0ZSA9IG1lc3NhZ2UgYXMgUGFydGlhbDxXb3JrZXJDYWxsTWVzc2FnZT4gfCBQYXJ0aWFsPFdvcmtlckNhbmNlbE1lc3NhZ2U+O1xuICBpZiAodHlwZW9mIGNhbmRpZGF0ZS5pZCAhPT0gJ251bWJlcicpIHtcbiAgICByZXR1cm4gZmFsc2U7XG4gIH1cbiAgaWYgKGNhbmRpZGF0ZS5raW5kID09PSAnY2FuY2VsJykge1xuICAgIHJldHVybiB0cnVlO1xuICB9XG4gIHJldHVybiBjYW5kaWRhdGUua2luZCA9PT0gJ2NhbGwnICYmIHR5cGVvZiBjYW5kaWRhdGUubWV0aG9kID09PSAnc3RyaW5nJyAmJiBBcnJheS5pc0FycmF5KGNhbmRpZGF0ZS5hcmd1bWVudHMpO1xufVxuXG4vKipcbiAqIFRlbGxzIHdoZXRoZXIgYSBtZXNzYWdlIGlzIGEgcmVzcG9uc2Ugb2YgdGhpcyBwcm90b2NvbC5cbiAqXG4gKiBAcGFyYW0gbWVzc2FnZSAtIFRoZSBtZXNzYWdlLlxuICogQHJldHVybnMgV2hldGhlciBpdCBpcyBvbmUuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc1dvcmtlclJlc3BvbnNlTWVzc2FnZShtZXNzYWdlOiB1bmtub3duKTogbWVzc2FnZSBpcyBXb3JrZXJSZXNwb25zZU1lc3NhZ2Uge1xuICBpZiAoIWhhc1Byb3RvY29sKG1lc3NhZ2UpKSB7XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG4gIGNvbnN0IGNhbmRpZGF0ZSA9IG1lc3NhZ2UgYXMgUGFydGlhbDxXb3JrZXJFcnJvck1lc3NhZ2U+IHwgUGFydGlhbDxXb3JrZXJSZXN1bHRNZXNzYWdlPjtcbiAgaWYgKHR5cGVvZiBjYW5kaWRhdGUuaWQgIT09ICdudW1iZXInKSB7XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG4gIGlmIChjYW5kaWRhdGUua2luZCA9PT0gJ3Jlc3VsdCcpIHtcbiAgICByZXR1cm4gdHJ1ZTtcbiAgfVxuICByZXR1cm4gY2FuZGlkYXRlLmtpbmQgPT09ICdlcnJvcicgJiYgdHlwZW9mIGNhbmRpZGF0ZS5lcnJvciA9PT0gJ29iamVjdCc7XG59XG5cbi8qKlxuICogUmVkdWNlcyBhIHRocm93biB2YWx1ZSB0byBwbGFpbiBkYXRhLlxuICpcbiAqIEBwYXJhbSBlcnJvciAtIFRoZSB0aHJvd24gdmFsdWUuXG4gKiBAcmV0dXJucyBUaGUgc2VyaWFsaXplZCBlcnJvci5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHNlcmlhbGl6ZVdvcmtlckVycm9yKGVycm9yOiB1bmtub3duKTogU2VyaWFsaXplZFdvcmtlckVycm9yIHtcbiAgaWYgKCEoZXJyb3IgaW5zdGFuY2VvZiBFcnJvcikpIHtcbiAgICByZXR1cm4geyBtZXNzYWdlOiBTdHJpbmcoZXJyb3IpLCBuYW1lOiAnRXJyb3InIH07XG4gIH1cbiAgcmV0dXJuIGVycm9yLnN0YWNrID09PSB1bmRlZmluZWRcbiAgICA/IHsgbWVzc2FnZTogZXJyb3IubWVzc2FnZSwgbmFtZTogZXJyb3IubmFtZSB9XG4gICAgOiB7IG1lc3NhZ2U6IGVycm9yLm1lc3NhZ2UsIG5hbWU6IGVycm9yLm5hbWUsIHN0YWNrOiBlcnJvci5zdGFjayB9O1xufVxuXG4vKipcbiAqIFNwbGl0cyBhIHJlc3VsdCBpbnRvIHRoZSB2YWx1ZSB0byBwb3N0IGFuZCB0aGUgb2JqZWN0cyB0byB0cmFuc2Zlci5cbiAqXG4gKiBAcGFyYW0gcmVzdWx0IC0gQSByZXN1bHQsIHBvc3NpYmx5IHdyYXBwZWQgYnkge0BsaW5rIHdpdGhUcmFuc2Zlcn0uXG4gKiBAcmV0dXJucyBUaGUgdmFsdWUgYW5kIGl0cyB0cmFuc2ZlciBsaXN0LlxuICovXG5leHBvcnQgZnVuY3Rpb24gdW53cmFwVHJhbnNmZXJyZWRWYWx1ZShyZXN1bHQ6IHVua25vd24pOiBVbndyYXBwZWRUcmFuc2ZlcnJlZFZhbHVlIHtcbiAgcmV0dXJuIGlzVHJhbnNmZXJyZWRWYWx1ZShyZXN1bHQpXG4gICAgPyB7IHRyYW5zZmVyOiBbLi4ucmVzdWx0LnRyYW5zZmVyXSwgdmFsdWU6IHJlc3VsdC52YWx1ZSB9XG4gICAgOiB7IHRyYW5zZmVyOiBbXSwgdmFsdWU6IHJlc3VsdCB9O1xufVxuXG4vKipcbiAqIE1hcmtzIGEgcmVzdWx0IHRvIHRyYW5zZmVyIHNvbWUgb2YgaXRzIG9iamVjdHMgKGFuIGBBcnJheUJ1ZmZlcmAsIGEgYE1lc3NhZ2VQb3J0YCwgYW4gYE9mZnNjcmVlbkNhbnZhc2AuLi4pIGluc3RlYWRcbiAqIG9mIGNvcHlpbmcgdGhlbS4gQSB0cmFuc2ZlcnJlZCBvYmplY3QgaXMgdW51c2FibGUgb24gdGhlIHNlbmRpbmcgc2lkZSBhZnRlcndhcmRzLlxuICpcbiAqIEB0eXBlUGFyYW0gVFZhbHVlIC0gVGhlIHZhbHVlIHR5cGUuXG4gKiBAcGFyYW0gdmFsdWUgLSBUaGUgdmFsdWUuXG4gKiBAcGFyYW0gdHJhbnNmZXIgLSBUaGUgb2JqZWN0cyBpbnNpZGUgaXQgdG8gdHJhbnNmZXIuXG4gKiBAcmV0dXJucyBUaGUgd3JhcHBlZCB2YWx1ZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHdpdGhUcmFuc2ZlcjxUVmFsdWU+KHZhbHVlOiBUVmFsdWUsIHRyYW5zZmVyOiByZWFkb25seSBUcmFuc2ZlcmFibGVbXSk6IFRyYW5zZmVycmVkVmFsdWU8VFZhbHVlPiB7XG4gIHJldHVybiB7IF9fb2JzaWRpYW5MaWJUcmFuc2ZlcnJlZFZhbHVlOiB0cnVlLCB0cmFuc2ZlciwgdmFsdWUgfTtcbn1cblxuZnVuY3Rpb24gZ2V0V29ya2VyR2xvYmFsU2NvcGUoKTogV29ya2VyTWVzc2FnZVBvcnQge1xuICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgb2JzaWRpYW5tZC9uby1nbG9iYWwtdGhpcyAtLSBBIHdvcmtlciBoYXMgbm8gYHdpbmRvd2A6IGl0cyBnbG9iYWwgc2NvcGUgaXMgdGhlIHBvcnQuXG4gIGNvbnN0IHNjb3BlOiB1bmtub3duID0gZ2xvYmFsVGhpcztcbiAgcmV0dXJuIHNjb3BlIGFzIFdvcmtlck1lc3NhZ2VQb3J0O1xufVxuXG5mdW5jdGlvbiBoYXNQcm90b2NvbChtZXNzYWdlOiB1bmtub3duKTogYm9vbGVhbiB7XG4gIHJldHVybiB0eXBlb2YgbWVzc2FnZSA9PT0gJ29iamVjdCcgJiYgbWVzc2FnZSAhPT0gbnVsbCAmJiAobWVzc2FnZSBhcyBQcm90b2NvbFRhZ2dlZE1lc3NhZ2UpLnByb3RvY29sID09PSBXT1JLRVJfUFJPVE9DT0w7XG59XG5cbmZ1bmN0aW9uIHBvc3RSZXNwb25zZShwb3J0OiBXb3JrZXJNZXNzYWdlUG9ydCwgcmVzcG9uc2U6IFdvcmtlclJlc3BvbnNlTWVzc2FnZSk6IHZvaWQge1xuICBpZiAocmVzcG9uc2Uua2luZCA9PT0gJ2Vycm9yJykge1xuICAgIHBvcnQucG9zdE1lc3NhZ2UocmVzcG9uc2UsIFtdKTtcbiAgICByZXR1cm47XG4gIH1cbiAgY29uc3QgeyB0cmFuc2ZlciwgdmFsdWUgfSA9IHVud3JhcFRyYW5zZmVycmVkVmFsdWUocmVzcG9uc2UudmFsdWUpO1xuICB0cnkge1xuICAgIHBvcnQucG9zdE1lc3NhZ2UoeyAuLi5yZXNwb25zZSwgdmFsdWUgfSwgdHJhbnNmZXIpO1xuICB9IGNhdGNoIChlcnJvcikge1xuICAgIC8vIEEgcmVzdWx0IHRoYXQgY2Fubm90IGJlIGNsb25lZCAoYSBmdW5jdGlvbiwgYSBET00gbm9kZSkgc3RpbGwgYW5zd2Vycywgc28gdGhlIGNhbGxlciBpcyBuZXZlciBsZWZ0IHdhaXRpbmcuXG4gICAgcG9ydC5wb3N0TWVzc2FnZSh7IGVycm9yOiBzZXJpYWxpemVXb3JrZXJFcnJvcihlcnJvciksIGlkOiByZXNwb25zZS5pZCwga2luZDogJ2Vycm9yJywgcHJvdG9jb2w6IFdPUktFUl9QUk9UT0NPTCB9LCBbXSk7XG4gIH1cbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7O0FBZU8sTUFBTSxrQkFBa0I7QUFzUHhCLFNBQVMsZ0JBQThDLFVBQW1DLE1BQWdDO0FBQy9ILFFBQU0sY0FBYyxRQUFRLHFCQUFxQjtBQUNqRCxRQUFNLG1CQUFtQixvQkFBSSxJQUE2QjtBQUUxRCxjQUFZLGlCQUFpQixXQUFXLENBQUMsV0FBaUI7QUFDeEQsVUFBTSxVQUFVLE9BQU87QUFDdkIsUUFBSSxDQUFDLHVCQUF1QixPQUFPLEdBQUc7QUFDcEM7QUFBQSxJQUNGO0FBRUEsUUFBSSxRQUFRLFNBQVMsVUFBVTtBQUM3Qix1QkFBaUIsSUFBSSxRQUFRLEVBQUUsR0FBRyxNQUFNLElBQUksTUFBTSx3QkFBd0IsQ0FBQztBQUMzRTtBQUFBLElBQ0Y7QUFFQSxVQUFNLGtCQUFrQixJQUFJLGdCQUFnQjtBQUM1QyxxQkFBaUIsSUFBSSxRQUFRLElBQUksZUFBZTtBQUVo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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnaoumov/obsidian-lib",
-  "version": "10.12.0",
+  "version": "11.0.0",
   "description": "Runtime library for Obsidian plugin development: plugin base classes, components, settings, modals, vault and metadata helpers.",
   "keywords": [
     "obsidian",
@@ -347,11 +347,13 @@
     "test": "jiti scripts/test.ts",
     "test:coverage": "jiti scripts/test-coverage.ts",
     "test:integration": "jiti scripts/test-integration.ts integration-tests obsidian-integration-tests",
+    "test:integration:android": "jiti scripts/test-integration.ts obsidian-integration-tests:android",
     "test:mutation": "jiti scripts/test-mutation.ts",
     "test:watch": "jiti scripts/test-watch.ts",
     "version": "jiti scripts/version.ts"
   },
   "overrides": {
+    "@mnaoumov/typescript-lib": "$@mnaoumov/typescript-lib",
     "@puppeteer/browsers": "^3.2.2",
     "@vitest/coverage-v8": "$@vitest/coverage-v8",
     "deepmerge-ts": "^8.0.2",
@@ -363,13 +365,12 @@
     "katex": "^0.18.2",
     "markdown-it@>=15.0.0": "^15.0.3",
     "moment": "^2.31.0",
-    "re2js": "^2.9.1",
     "smol-toml": "^1.8.0",
     "typescript": "$typescript"
   },
   "dependencies": {
     "@mnaoumov/obsidian-dataview": "^1.0.0",
-    "@mnaoumov/typescript-lib": "^2.0.0",
+    "@mnaoumov/typescript-lib": "^4.0.0",
     "@standard-schema/spec": "^1.1.0",
     "@types/react": "^19.3.0",
     "compare-versions": "^6.1.1",
@@ -391,10 +392,10 @@
     "@commitlint/cli": "^21.2.2",
     "@commitlint/config-conventional": "^21.2.2",
     "@lezer/common": "1.5.2",
-    "@mnaoumov/obsidian-dev-toolkit": "^8.2.1",
-    "@mnaoumov/typescript-dev-toolkit": "^6.1.0",
+    "@mnaoumov/obsidian-dev-toolkit": "^10.0.0",
+    "@mnaoumov/typescript-dev-toolkit": "^7.0.3",
     "@mnaoumov/typescript-test-toolkit": "^1.0.3",
-    "@obsidian-typings/obsidian-public-latest": "^6.59.0",
+    "@obsidian-typings/obsidian-public-latest": "^6.60.0",
     "@resvg/resvg-js": "^2.6.2",
     "@stryker-mutator/core": "^10.1.1",
     "@stryker-mutator/vitest-runner": "^10.1.1",
@@ -412,7 +413,7 @@
     "esbuild": "^0.28.2",
     "eslint": "^10.11.0",
     "eslint-plugin-jsdoc": "^64.5.4",
-    "eslint-plugin-obsidianmd": "^0.4.2",
+    "eslint-plugin-obsidianmd": "^0.5.1",
     "eslint-plugin-tsdoc": "^0.5.3",
     "fake-indexeddb": "^6.2.6",
     "fflate": "^0.8.3",
@@ -423,7 +424,7 @@
     "nano-staged": "^1.0.2",
     "obsidian": "^1.14.4",
     "obsidian-integration-testing": "^17.7.4",
-    "obsidian-test-mocks": "^7.2.3",
+    "obsidian-test-mocks": "^8.0.0",
     "prismjs": "^1.30.0",
     "sass": "^1.104.1",
     "satori": "^0.33.5",

package/plugin/third-party-plugin/package.json

@@ -0,0 +1,6 @@
+{
+  "main": "../../dist/lib/cjs/plugin/third-party-plugin.cjs",
+  "module": "../../dist/lib/esm/plugin/third-party-plugin.mjs",
+  "type": "module",
+  "types": "../../dist/lib/cjs/plugin/third-party-plugin.d.cts"
+}