@mnaoumov/typescript-lib 0.0.0 → 1.0.1

package/dist/lib/esm/error.mjs

@@ -0,0 +1,204 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+import { AsyncEvents } from "./async-events.mjs";
+import {
+  CallbackDisposable,
+  MultipleDisposeBehavior
+} from "./disposable.mjs";
+import { ensureNonNullable } from "./type-guards.mjs";
+const errorAsyncEvents = new AsyncEvents();
+errorAsyncEvents.on("asyncError", handleAsyncError);
+const moduleState = {
+  asyncErrorIgnoreContextDepth: 0,
+  collectedUnhandledAsyncErrors: null
+};
+const ASYNC_WRAPPER_ERROR_MESSAGE = "An unhandled error occurred executing async operation";
+const STACK_TRACE_PREFIX = "    at";
+const ERROR_HEADER_REG_EXP = /^\w*Error(?:: |$)/;
+const STACK_HEADER_PROBE_MESSAGE = "stack header probe";
+class CustomStackTraceError extends Error {
+  /**
+   * Creates a new CustomStackTraceError.
+   *
+   * @param params - The parameters for the error.
+   */
+  constructor(params) {
+    const { cause, message, stackTrace } = params;
+    super(message, { cause });
+    this.name = "CustomStackTraceError";
+    let rootCause = cause;
+    const parentCauses = /* @__PURE__ */ new Set();
+    while (rootCause instanceof CustomStackTraceError) {
+      if (parentCauses.has(rootCause)) {
+        throw new Error("Circular cause detected");
+      }
+      parentCauses.add(rootCause);
+      rootCause = rootCause.cause;
+    }
+    const stackLines = stackTrace.split("\n");
+    if (ERROR_HEADER_REG_EXP.test(ensureNonNullable(stackLines[0]))) {
+      stackLines.shift();
+    }
+    if (hasStackHeader()) {
+      stackLines.unshift(getErrorHeader(this));
+    }
+    this.stack = stackLines.join("\n");
+  }
+}
+class ErrorWrapper extends Error {
+  /**
+   * Creates a new ErrorWrapper.
+   *
+   * @param thrownValue - The original non-`Error` value that was thrown.
+   */
+  constructor(thrownValue) {
+    super(`A non-Error value was thrown: ${String(thrownValue)}`, { cause: thrownValue });
+    this.name = "ErrorWrapper";
+  }
+  /**
+   * Normalizes any thrown value to an `Error`.
+   *
+   * Returns the value unchanged if it is already an `Error`, otherwise wraps it in an {@link ErrorWrapper}.
+   *
+   * @param thrownValue - The thrown value to normalize.
+   * @returns An `Error` instance: the original value if it is already an `Error`, otherwise an {@link ErrorWrapper}.
+   */
+  static create(thrownValue) {
+    return thrownValue instanceof Error ? thrownValue : new ErrorWrapper(thrownValue);
+  }
+}
+class SilentError extends Error {
+  /**
+   * Creates a new SilentError.
+   *
+   * @param message - The message of the error.
+   */
+  constructor(message) {
+    super(message);
+    this.name = "SilentError";
+  }
+}
+function drainCollectedUnhandledAsyncErrors() {
+  return moduleState.collectedUnhandledAsyncErrors?.splice(0) ?? [];
+}
+function emitAsyncErrorEvent(asyncError, shouldIgnore = false) {
+  const isIgnored = shouldIgnore || moduleState.asyncErrorIgnoreContextDepth > 0;
+  if (moduleState.collectedUnhandledAsyncErrors && !isIgnored) {
+    moduleState.collectedUnhandledAsyncErrors.push(asyncError);
+  }
+  errorAsyncEvents.trigger("asyncError", asyncError);
+}
+function errorToString(error) {
+  return getErrorLines(error).map((line) => line.text).join("\n");
+}
+function getStackTrace(framesToSkip = 0) {
+  const GET_STACK_TRACE_FRAME_COUNT = 1;
+  const additionalLinesToSkip = GET_STACK_TRACE_FRAME_COUNT + (hasStackHeader() ? 1 : 0);
+  const stack = ensureNonNullable(new Error().stack);
+  const lines = stack.split("\n");
+  return lines.slice(framesToSkip + additionalLinesToSkip).join("\n");
+}
+function isAsyncErrorIgnoreContextActive() {
+  return moduleState.asyncErrorIgnoreContextDepth > 0;
+}
+function printError(error, console) {
+  console ??= globalThis.console;
+  console.error(errorToString(error));
+}
+function registerAsyncErrorEventHandler(handler) {
+  const eventRef = errorAsyncEvents.on("asyncError", handler);
+  return new CallbackDisposable({
+    callback: () => {
+      errorAsyncEvents.offref(eventRef);
+    },
+    multipleDisposeBehavior: MultipleDisposeBehavior.Ignore
+  });
+}
+function startAsyncErrorIgnoreContext() {
+  moduleState.asyncErrorIgnoreContextDepth++;
+  return new CallbackDisposable({
+    callback: () => {
+      moduleState.asyncErrorIgnoreContextDepth--;
+    },
+    multipleDisposeBehavior: MultipleDisposeBehavior.Ignore
+  });
+}
+function startCollectingUnhandledAsyncErrors() {
+  moduleState.collectedUnhandledAsyncErrors = [];
+}
+function stopCollectingUnhandledAsyncErrors() {
+  const collectedErrors = moduleState.collectedUnhandledAsyncErrors ?? [];
+  moduleState.collectedUnhandledAsyncErrors = null;
+  return collectedErrors;
+}
+function throwExpression(error) {
+  throw error;
+}
+function generateNestedErrorLines(nestedError, title) {
+  const lines = [toTitleLine(title), ...getErrorLines(nestedError).filter((line) => line.text.trim() !== "")];
+  return lines.map((line) => line.isFrame ? line : { isFrame: true, text: generateStackTraceLine(line.text) });
+}
+function generateStackTraceLine(title) {
+  return `${STACK_TRACE_PREFIX} --- ${title} --- (0)`;
+}
+function getErrorHeader(error) {
+  return error.message ? `${error.name}: ${error.message}` : error.name;
+}
+function getErrorLines(error) {
+  if (!(error instanceof Error)) {
+    return String(error).split("\n").map((text) => toTitleLine(text));
+  }
+  const lines = getOwnErrorLines(error);
+  if (error.cause !== void 0) {
+    lines.push(...generateNestedErrorLines(error.cause, "Caused by:"));
+  }
+  if (error instanceof AggregateError) {
+    const aggregatedErrors = error.errors;
+    for (const [index, aggregatedError] of aggregatedErrors.entries()) {
+      lines.push(...generateNestedErrorLines(aggregatedError, `Aggregated error #${String(index + 1)}:`));
+    }
+  }
+  return lines;
+}
+function getOwnErrorLines(error) {
+  const headerLines = getErrorHeader(error).split("\n").map((text) => toTitleLine(text));
+  if (error.stack === void 0) {
+    return headerLines;
+  }
+  const stackLines = error.stack.split("\n");
+  if (hasStackHeader()) {
+    return stackLines.map((text) => ({ isFrame: text.startsWith(STACK_TRACE_PREFIX), text }));
+  }
+  return [...headerLines, ...stackLines.filter((text) => text.trim() !== "").map((text) => ({ isFrame: true, text }))];
+}
+function handleAsyncError(asyncError) {
+  printError(asyncError);
+}
+function hasStackHeader() {
+  const firstLine = new Error(STACK_HEADER_PROBE_MESSAGE).stack?.split("\n", 1)[0];
+  return firstLine === `Error: ${STACK_HEADER_PROBE_MESSAGE}`;
+}
+function toTitleLine(text) {
+  return { isFrame: false, text };
+}
+export {
+  ASYNC_WRAPPER_ERROR_MESSAGE,
+  CustomStackTraceError,
+  ErrorWrapper,
+  SilentError,
+  drainCollectedUnhandledAsyncErrors,
+  emitAsyncErrorEvent,
+  errorToString,
+  getStackTrace,
+  isAsyncErrorIgnoreContextActive,
+  printError,
+  registerAsyncErrorEventHandler,
+  startAsyncErrorIgnoreContext,
+  startCollectingUnhandledAsyncErrors,
+  stopCollectingUnhandledAsyncErrors,
+  throwExpression
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2Vycm9yLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29udGFpbnMgdXRpbGl0eSBmdW5jdGlvbnMgZm9yIGVycm9yIGhhbmRsaW5nLlxuICovXG5cbmltcG9ydCB7IEFzeW5jRXZlbnRzIH0gZnJvbSAnLi9hc3luYy1ldmVudHMudHMnO1xuaW1wb3J0IHtcbiAgQ2FsbGJhY2tEaXNwb3NhYmxlLFxuICBNdWx0aXBsZURpc3Bvc2VCZWhhdmlvclxufSBmcm9tICcuL2Rpc3Bvc2FibGUudHMnO1xuaW1wb3J0IHsgZW5zdXJlTm9uTnVsbGFibGUgfSBmcm9tICcuL3R5cGUtZ3VhcmRzLnRzJztcblxuaW50ZXJmYWNlIEVycm9yQXN5bmNFdmVudE1hcCB7XG4gIGFzeW5jRXJyb3I6IFtlcnJvcjogdW5rbm93bl07XG59XG5cbmNvbnN0IGVycm9yQXN5bmNFdmVudHMgPSBuZXcgQXN5bmNFdmVudHM8RXJyb3JBc3luY0V2ZW50TWFwPigpO1xuLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIHVuaWNvcm4vbm8tdG9wLWxldmVsLXNpZGUtZWZmZWN0cyAtLSBJbnN0YWxsaW5nIHRoZSBkZWZhdWx0IGhhbmRsZXIgb24gaW1wb3J0IGlzIHdoYXQgdGhpcyBtb2R1bGUgaXMgZm9yLiBEZWZlcnJpbmcgaXQgYmVoaW5kIGEgY2FsbCB3b3VsZCBtZWFuIGV2ZXJ5IGNvbnN1bWVyIGhhZCB0byByZW1lbWJlciB0byBtYWtlIHRoYXQgY2FsbCBiZWZvcmUgdGhlIGZpcnN0IGFzeW5jIGVycm9yLCB3aGljaCBpcyBwcmVjaXNlbHkgdGhlIG1vbWVudCB0aGUgaGFuZGxlciBuZWVkcyB0byBhbHJlYWR5IGV4aXN0LlxuZXJyb3JBc3luY0V2ZW50cy5vbignYXN5bmNFcnJvcicsIGhhbmRsZUFzeW5jRXJyb3IpO1xuXG5pbnRlcmZhY2UgTW9kdWxlU3RhdGUge1xuICAvKipcbiAgICogVGhlIG5lc3RpbmcgZGVwdGggb2YgYWN0aXZlIHtAbGluayBzdGFydEFzeW5jRXJyb3JJZ25vcmVDb250ZXh0fSBzY29wZXMuIFdoaWxlIGdyZWF0ZXIgdGhhbiBgMGAsIGFuXG4gICAqIGFzeW5jIGVycm9yIGVtaXR0ZWQgKG9yIGEgZmlyZS1hbmQtZm9yZ2V0IG9wZXJhdGlvbiB3aG9zZSByZWplY3Rpb24gd2FzIGNhcHR1cmVkKSB3aXRoaW4gdGhlIHNjb3BlIGlzXG4gICAqIHRyZWF0ZWQgYXMgZXhwZWN0ZWQgYW5kIG5vdCBjb2xsZWN0ZWQgYXMgdW5oYW5kbGVkLlxuICAgKi9cbiAgYXN5bmNFcnJvcklnbm9yZUNvbnRleHREZXB0aDogbnVtYmVyO1xuXG4gIC8qKlxuICAgKiBUaGUgYnVmZmVyIHRoYXQgY29sbGVjdHMgdW5oYW5kbGVkIGFzeW5jIGVycm9ycyB3aGlsZSBhIGNvbGxlY3Rpb24gd2luZG93IGlzIG9wZW4sIG9yIGBudWxsYCB3aGVuXG4gICAqIG5vIHdpbmRvdyBpcyBvcGVuICh0aGUgZGVmYXVsdCBpbiBwcm9kdWN0aW9uKS4gT3BlbmVkIGJ5IHtAbGluayBzdGFydENvbGxlY3RpbmdVbmhhbmRsZWRBc3luY0Vycm9yc30sXG4gICAqIGVtcHRpZWQgd2l0aG91dCBjbG9zaW5nIGJ5IHtAbGluayBkcmFpbkNvbGxlY3RlZFVuaGFuZGxlZEFzeW5jRXJyb3JzfSwgYW5kIGRyYWluZWQtYW5kLWNsb3NlZCBieVxuICAgKiB7QGxpbmsgc3RvcENvbGxlY3RpbmdVbmhhbmRsZWRBc3luY0Vycm9yc30gXHUyMDE0IHVzZWQgYnkgdGhlIHRlc3QgaGFybmVzcyB0byBmYWlsIGEgdGVzdCB0aGF0IHN3YWxsb3dlZFxuICAgKiBhbiBhc3luYyBlcnJvci5cbiAgICovXG4gIGNvbGxlY3RlZFVuaGFuZGxlZEFzeW5jRXJyb3JzOiBudWxsIHwgdW5rbm93bltdO1xufVxuXG4vKipcbk1vZHVsZS1sZXZlbCBtdXRhYmxlIHN0YXRlLCBoZWxkIGluIG9uZSBvYmplY3Qgc28gZWFjaCBtdXRhdGlvbiBuYW1lcyBpdCBleHBsaWNpdGx5LlxuICovXG5jb25zdCBtb2R1bGVTdGF0ZTogTW9kdWxlU3RhdGUgPSB7XG4gIGFzeW5jRXJyb3JJZ25vcmVDb250ZXh0RGVwdGg6IDAsXG4gIGNvbGxlY3RlZFVuaGFuZGxlZEFzeW5jRXJyb3JzOiBudWxsXG59O1xuLyoqXG4gKiBBIG1lc3NhZ2Ugb2YgdGhlIEFzeW5jV3JhcHBlckVycm9yLlxuICovXG5leHBvcnQgY29uc3QgQVNZTkNfV1JBUFBFUl9FUlJPUl9NRVNTQUdFID0gJ0FuIHVuaGFuZGxlZCBlcnJvciBvY2N1cnJlZCBleGVjdXRpbmcgYXN5bmMgb3BlcmF0aW9uJztcblxuY29uc3QgU1RBQ0tfVFJBQ0VfUFJFRklYID0gJyAgICBhdCc7XG5cbmNvbnN0IEVSUk9SX0hFQURFUl9SRUdfRVhQID0gL15cXHcqRXJyb3IoPzo6IHwkKS87XG5cbmNvbnN0IFNUQUNLX0hFQURFUl9QUk9CRV9NRVNTQUdFID0gJ3N0YWNrIGhlYWRlciBwcm9iZSc7XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3IgdGhlIHtAbGluayBDdXN0b21TdGFja1RyYWNlRXJyb3J9IGNvbnN0cnVjdG9yLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEN1c3RvbVN0YWNrVHJhY2VFcnJvckNvbnN0cnVjdG9yUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBjYXVzZSBvZiB0aGUgZXJyb3IuXG4gICAqL1xuICByZWFkb25seSBjYXVzZTogdW5rbm93bjtcblxuICAvKipcbiAgICogVGhlIG1lc3NhZ2Ugb2YgdGhlIGVycm9yLlxuICAgKi9cbiAgcmVhZG9ubHkgbWVzc2FnZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgc3RhY2sgdHJhY2Ugb2YgdGhlIGVycm9yLlxuICAgKi9cbiAgcmVhZG9ubHkgc3RhY2tUcmFjZTogc3RyaW5nO1xufVxuXG4vKipcbiAqIE9uZSBsaW5lIG9mIGFuIGVycm9yJ3Mgc3RyaW5nIGZvcm0sIHRhZ2dlZCB3aXRoIHdoZXRoZXIgaXQgaXMgYSBzdGFjayBmcmFtZS5cbiAqXG4gKiBBIHRpdGxlIChhbiBlcnJvciBoZWFkZXIsIGEgYENhdXNlZCBieTpgIG1hcmtlciwgYSBsaW5lIG9mIGEgbXVsdGktbGluZSBtZXNzYWdlKSBpcyB3cmFwcGVkIGludG9cbiAqIHtAbGluayBnZW5lcmF0ZVN0YWNrVHJhY2VMaW5lfSdzIGZvcm0gd2hlbiB0aGUgZXJyb3IgaXQgYmVsb25ncyB0byBpcyBuZXN0ZWQ7IGEgZnJhbWUgaXMga2VwdCB2ZXJiYXRpbS5cbiAqL1xuaW50ZXJmYWNlIEVycm9yTGluZSB7XG4gIHJlYWRvbmx5IGlzRnJhbWU6IGJvb2xlYW47XG4gIHJlYWRvbmx5IHRleHQ6IHN0cmluZztcbn1cblxuLyoqXG4gKiBBbiBlcnJvciB0aGF0IHdyYXBzIGFuIGVycm9yIHdpdGggYSBjdXN0b20gc3RhY2sgdHJhY2UuXG4gKi9cbmV4cG9ydCBjbGFzcyBDdXN0b21TdGFja1RyYWNlRXJyb3IgZXh0ZW5kcyBFcnJvciB7XG4gIC8qKlxuICAgKiBDcmVhdGVzIGEgbmV3IEN1c3RvbVN0YWNrVHJhY2VFcnJvci5cbiAgICpcbiAgICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIGZvciB0aGUgZXJyb3IuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IocGFyYW1zOiBDdXN0b21TdGFja1RyYWNlRXJyb3JDb25zdHJ1Y3RvclBhcmFtcykge1xuICAgIGNvbnN0IHsgY2F1c2UsIG1lc3NhZ2UsIHN0YWNrVHJhY2UgfSA9IHBhcmFtcztcbiAgICBzdXBlcihtZXNzYWdlLCB7IGNhdXNlIH0pO1xuICAgIHRoaXMubmFtZSA9ICdDdXN0b21TdGFja1RyYWNlRXJyb3InO1xuXG4gICAgbGV0IHJvb3RDYXVzZSA9IGNhdXNlO1xuICAgIGNvbnN0IHBhcmVudENhdXNlcyA9IG5ldyBTZXQ8Q3VzdG9tU3RhY2tUcmFjZUVycm9yPigpO1xuICAgIHdoaWxlIChyb290Q2F1c2UgaW5zdGFuY2VvZiBDdXN0b21TdGFja1RyYWNlRXJyb3IpIHtcbiAgICAgIGlmIChwYXJlbnRDYXVzZXMuaGFzKHJvb3RDYXVzZSkpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKCdDaXJjdWxhciBjYXVzZSBkZXRlY3RlZCcpO1xuICAgICAgfVxuICAgICAgcGFyZW50Q2F1c2VzLmFkZChyb290Q2F1c2UpO1xuICAgICAgcm9vdENhdXNlID0gcm9vdENhdXNlLmNhdXNlO1xuICAgIH1cblxuICAgIGNvbnN0IHN0YWNrTGluZXMgPSBzdGFja1RyYWNlLnNwbGl0KCdcXG4nKTtcbiAgICBpZiAoRVJST1JfSEVBREVSX1JFR19FWFAudGVzdChlbnN1cmVOb25OdWxsYWJsZShzdGFja0xpbmVzWzBdKSkpIHtcbiAgICAgIHN0YWNrTGluZXMuc2hpZnQoKTtcbiAgICB9XG4gICAgLy8gS2VlcCB0aGUgZW5naW5lJ3Mgb3duIGAuc3RhY2tgIHNoYXBlOiBhIGhlYWRlciBvbmx5IHdoZXJlIHRoZSBlbmdpbmUgd3JpdGVzIG9uZSAoVjgpLCBmcmFtZXMgb25seSB3aGVyZSBpdCBkb2VzIG5vdCAoSmF2YVNjcmlwdENvcmUsIFNwaWRlck1vbmtleSkuXG4gICAgaWYgKGhhc1N0YWNrSGVhZGVyKCkpIHtcbiAgICAgIHN0YWNrTGluZXMudW5zaGlmdChnZXRFcnJvckhlYWRlcih0aGlzKSk7XG4gICAgfVxuICAgIHRoaXMuc3RhY2sgPSBzdGFja0xpbmVzLmpvaW4oJ1xcbicpO1xuICB9XG59XG5cbi8qKlxuICogQW4gZXJyb3IgdGhhdCB3cmFwcyBhIG5vbi1gRXJyb3JgIHZhbHVlIHRoYXQgd2FzIHRocm93biwgcHJlc2VydmluZyB0aGUgb3JpZ2luYWwgdmFsdWUgaW4gYGNhdXNlYC5cbiAqL1xuZXhwb3J0IGNsYXNzIEVycm9yV3JhcHBlciBleHRlbmRzIEVycm9yIHtcbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBuZXcgRXJyb3JXcmFwcGVyLlxuICAgKlxuICAgKiBAcGFyYW0gdGhyb3duVmFsdWUgLSBUaGUgb3JpZ2luYWwgbm9uLWBFcnJvcmAgdmFsdWUgdGhhdCB3YXMgdGhyb3duLlxuICAgKi9cbiAgcHVibGljIGNvbnN0cnVjdG9yKHRocm93blZhbHVlOiB1bmtub3duKSB7XG4gICAgc3VwZXIoYEEgbm9uLUVycm9yIHZhbHVlIHdhcyB0aHJvd246ICR7U3RyaW5nKHRocm93blZhbHVlKX1gLCB7IGNhdXNlOiB0aHJvd25WYWx1ZSB9KTtcbiAgICB0aGlzLm5hbWUgPSAnRXJyb3JXcmFwcGVyJztcbiAgfVxuXG4gIC8qKlxuICAgKiBOb3JtYWxpemVzIGFueSB0aHJvd24gdmFsdWUgdG8gYW4gYEVycm9yYC5cbiAgICpcbiAgICogUmV0dXJucyB0aGUgdmFsdWUgdW5jaGFuZ2VkIGlmIGl0IGlzIGFscmVhZHkgYW4gYEVycm9yYCwgb3RoZXJ3aXNlIHdyYXBzIGl0IGluIGFuIHtAbGluayBFcnJvcldyYXBwZXJ9LlxuICAgKlxuICAgKiBAcGFyYW0gdGhyb3duVmFsdWUgLSBUaGUgdGhyb3duIHZhbHVlIHRvIG5vcm1hbGl6ZS5cbiAgICogQHJldHVybnMgQW4gYEVycm9yYCBpbnN0YW5jZTogdGhlIG9yaWdpbmFsIHZhbHVlIGlmIGl0IGlzIGFscmVhZHkgYW4gYEVycm9yYCwgb3RoZXJ3aXNlIGFuIHtAbGluayBFcnJvcldyYXBwZXJ9LlxuICAgKi9cbiAgcHVibGljIHN0YXRpYyBjcmVhdGUodGhyb3duVmFsdWU6IHVua25vd24pOiBFcnJvciB7XG4gICAgcmV0dXJuIHRocm93blZhbHVlIGluc3RhbmNlb2YgRXJyb3IgPyB0aHJvd25WYWx1ZSA6IG5ldyBFcnJvcldyYXBwZXIodGhyb3duVmFsdWUpO1xuICB9XG59XG5cbi8qKlxuICogQW4gZXJyb3IgdGhhdCBpcyBub3QgcHJpbnRlZCB0byB0aGUgY29uc29sZS5cbiAqL1xuZXhwb3J0IGNsYXNzIFNpbGVudEVycm9yIGV4dGVuZHMgRXJyb3Ige1xuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyBTaWxlbnRFcnJvci5cbiAgICpcbiAgICogQHBhcmFtIG1lc3NhZ2UgLSBUaGUgbWVzc2FnZSBvZiB0aGUgZXJyb3IuXG4gICAqL1xuICBwdWJsaWMgY29uc3RydWN0b3IobWVzc2FnZTogc3RyaW5nKSB7XG4gICAgc3VwZXIobWVzc2FnZSk7XG4gICAgdGhpcy5uYW1lID0gJ1NpbGVudEVycm9yJztcbiAgfVxufVxuXG4vKipcbiAqIEVtcHRpZXMgdGhlIGNvbGxlY3Rpb24gd2luZG93IG9wZW5lZCBieSB7QGxpbmsgc3RhcnRDb2xsZWN0aW5nVW5oYW5kbGVkQXN5bmNFcnJvcnN9IGFuZCByZXR1cm5zIHdoYXQgaXRcbiAqIGhlbGQsIGxlYXZpbmcgdGhlIHdpbmRvdyAqKm9wZW4qKiBzbyBlcnJvcnMgZW1pdHRlZCBhZnRlcndhcmRzIGtlZXAgYmVpbmcgY29sbGVjdGVkLlxuICpcbiAqIFRoaXMgaXMgd2hhdCB0aGUgdGVzdCBzZXR1cCdzIChgQG1uYW91bW92L3R5cGVzY3JpcHQtdGVzdC10b29sa2l0L3NldHVwYCkgYGJlZm9yZUVhY2hgIC8gYGFmdGVyRWFjaGAgdXNlLCByYXRoZXIgdGhhblxuICoge0BsaW5rIHN0b3BDb2xsZWN0aW5nVW5oYW5kbGVkQXN5bmNFcnJvcnN9OiBhbiBhc3luYyBlcnJvciBlbWl0dGVkIGluIHRoZSBnYXAgYmV0d2VlbiB0d28gdGVzdHMgKGUuZy4gYnkgYVxuICogYHNldFRpbWVvdXRgIHRoZSB0ZXN0IGxlZnQgcGVuZGluZykgd291bGQgb3RoZXJ3aXNlIGxhbmQgb24gYSBjbG9zZWQgd2luZG93IGFuZCB2YW5pc2ggdW5yZXBvcnRlZC5cbiAqXG4gKiBAcmV0dXJucyBUaGUgdW5oYW5kbGVkIGFzeW5jIGVycm9ycyBjb2xsZWN0ZWQgc28gZmFyLCBvciBhbiBlbXB0eSBhcnJheSBpZiBubyB3aW5kb3cgaXMgb3Blbi5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGRyYWluQ29sbGVjdGVkVW5oYW5kbGVkQXN5bmNFcnJvcnMoKTogdW5rbm93bltdIHtcbiAgcmV0dXJuIG1vZHVsZVN0YXRlLmNvbGxlY3RlZFVuaGFuZGxlZEFzeW5jRXJyb3JzPy5zcGxpY2UoMCkgPz8gW107XG59XG5cbi8qKlxuICogRW1pdHMgYW4gYXN5bmNocm9ub3VzIGVycm9yIGV2ZW50LlxuICpcbiAqIFdoZW4gYSBjb2xsZWN0aW9uIHdpbmRvdyBpcyBvcGVuIChzZWUge0BsaW5rIHN0YXJ0Q29sbGVjdGluZ1VuaGFuZGxlZEFzeW5jRXJyb3JzfSkgdGhlIGVycm9yIGlzXG4gKiBjb2xsZWN0ZWQgYXMgdW5oYW5kbGVkIHVubGVzcyBpdCBpcyBpZ25vcmVkIFx1MjAxNCBlaXRoZXIgYmVjYXVzZSBgc2hvdWxkSWdub3JlYCBpcyBgdHJ1ZWAgb3IgYW5cbiAqIHtAbGluayBzdGFydEFzeW5jRXJyb3JJZ25vcmVDb250ZXh0fSBzY29wZSBpcyBhY3RpdmUuIEEgcmVnaXN0ZXJlZCBjb25zdW1lciBoYW5kbGVyIGRlbGliZXJhdGVseSBkb2VzXG4gKiAqKm5vdCoqIGV4ZW1wdCB0aGUgZXJyb3I6IGluIHByb2R1Y3Rpb24gaXQgc2hvd3MgdGhlIHVzZXIgYSBOb3RpY2UsIHdoaWNoIGlzIG5vdCBhIHRlc3QgYXNzZXJ0aW5nIHRoYXRcbiAqIHRoZSBlcnJvciB3YXMgZXhwZWN0ZWQuIHtAbGluayBzdGFydEFzeW5jRXJyb3JJZ25vcmVDb250ZXh0fSBpcyB0aGUgc2luZ2xlLCBleHBsaWNpdCBvcHQtb3V0LlxuICpcbiAqIEBwYXJhbSBhc3luY0Vycm9yIC0gVGhlIGVycm9yIHRvIGVtaXQgYXMgYW4gYXN5bmNocm9ub3VzIGVycm9yIGV2ZW50LlxuICogQHBhcmFtIHNob3VsZElnbm9yZSAtIFdoZXRoZXIgdG8gdHJlYXQgdGhlIGVycm9yIGFzIGV4cGVjdGVkIGFuZCBuZXZlciBjb2xsZWN0IGl0IGFzIHVuaGFuZGxlZCwgcmVnYXJkbGVzcyBvZiB0aGUgYWN0aXZlIGlnbm9yZSBjb250ZXh0LiBVc2VkIHRvIGNhcnJ5IHRoZSBzY2hlZHVsZS10aW1lIGlnbm9yZSBkZWNpc2lvbiBvZiBhIGRlZmVycmVkIGZpcmUtYW5kLWZvcmdldCByZWplY3Rpb24uXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBlbWl0QXN5bmNFcnJvckV2ZW50KGFzeW5jRXJyb3I6IHVua25vd24sIHNob3VsZElnbm9yZSA9IGZhbHNlKTogdm9pZCB7XG4gIGNvbnN0IGlzSWdub3JlZCA9IHNob3VsZElnbm9yZSB8fCBtb2R1bGVTdGF0ZS5hc3luY0Vycm9ySWdub3JlQ29udGV4dERlcHRoID4gMDtcbiAgaWYgKG1vZHVsZVN0YXRlLmNvbGxlY3RlZFVuaGFuZGxlZEFzeW5jRXJyb3JzICYmICFpc0lnbm9yZWQpIHtcbiAgICBtb2R1bGVTdGF0ZS5jb2xsZWN0ZWRVbmhhbmRsZWRBc3luY0Vycm9ycy5wdXNoKGFzeW5jRXJyb3IpO1xuICB9XG4gIGVycm9yQXN5bmNFdmVudHMudHJpZ2dlcignYXN5bmNFcnJvcicsIGFzeW5jRXJyb3IpO1xufVxuXG4vKipcbiAqIENvbnZlcnRzIGFuIGVycm9yIHRvIGEgc3RyaW5nIHJlcHJlc2VudGF0aW9uLCBpbmNsdWRpbmcgbmVzdGVkIGNhdXNlcyBhbmQgdGhlIGFnZ3JlZ2F0ZWQgZXJyb3JzIG9mXG4gKiBhbiBgQWdncmVnYXRlRXJyb3JgLCB3aXRoIGluZGVudGF0aW9uLlxuICpcbiAqIEBwYXJhbSBlcnJvciAtIFRoZSBlcnJvciB0byBjb252ZXJ0IHRvIGEgc3RyaW5nLlxuICogQHJldHVybnMgVGhlIHN0cmluZyByZXByZXNlbnRhdGlvbiBvZiB0aGUgZXJyb3IuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBlcnJvclRvU3RyaW5nKGVycm9yOiB1bmtub3duKTogc3RyaW5nIHtcbiAgcmV0dXJuIGdldEVycm9yTGluZXMoZXJyb3IpLm1hcCgobGluZSkgPT4gbGluZS50ZXh0KS5qb2luKCdcXG4nKTtcbn1cblxuLyoqXG4gKiBHZXRzIHRoZSBjdXJyZW50IHN0YWNrIHRyYWNlIGFzIGEgc3RyaW5nLCBleGNsdWRpbmcgdGhlIGN1cnJlbnQgZnVuY3Rpb24gY2FsbC5cbiAqXG4gKiBAcGFyYW0gZnJhbWVzVG9Ta2lwIC0gVGhlIG51bWJlciBvZiBmcmFtZXMgdG8gc2tpcCBpbiB0aGUgc3RhY2sgdHJhY2UuXG4gKiBAcmV0dXJucyBBIHN0cmluZyByZXByZXNlbnRhdGlvbiBvZiB0aGUgY3VycmVudCBzdGFjayB0cmFjZSwgZXhjbHVkaW5nIHRoZSBjdXJyZW50IGZ1bmN0aW9uIGNhbGwuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRTdGFja1RyYWNlKGZyYW1lc1RvU2tpcCA9IDApOiBzdHJpbmcge1xuICAvLyBTa2lwcGluZyB0aGUgYGdldFN0YWNrVHJhY2VgIGZyYW1lIGl0c2VsZiwgcGx1cyB0aGUgYEVycm9yYCBoZWFkZXIgbGluZSBvbiBhbiBlbmdpbmUgdGhhdCB3cml0ZXMgb25lLlxuICBjb25zdCBHRVRfU1RBQ0tfVFJBQ0VfRlJBTUVfQ09VTlQgPSAxO1xuICBjb25zdCBhZGRpdGlvbmFsTGluZXNUb1NraXAgPSBHRVRfU1RBQ0tfVFJBQ0VfRlJBTUVfQ09VTlQgKyAoaGFzU3RhY2tIZWFkZXIoKSA/IDEgOiAwKTtcbiAgY29uc3Qgc3RhY2sgPSBlbnN1cmVOb25OdWxsYWJsZShuZXcgRXJyb3IoKS5zdGFjayk7XG4gIGNvbnN0IGxpbmVzID0gc3RhY2suc3BsaXQoJ1xcbicpO1xuICByZXR1cm4gbGluZXMuc2xpY2UoZnJhbWVzVG9Ta2lwICsgYWRkaXRpb25hbExpbmVzVG9Ta2lwKS5qb2luKCdcXG4nKTtcbn1cblxuLyoqXG4gKiBDaGVja3Mgd2hldGhlciBhbiB7QGxpbmsgc3RhcnRBc3luY0Vycm9ySWdub3JlQ29udGV4dH0gc2NvcGUgaXMgY3VycmVudGx5IGFjdGl2ZS5cbiAqXG4gKiBAcmV0dXJucyBgdHJ1ZWAgaWYgYXQgbGVhc3Qgb25lIGlnbm9yZSBjb250ZXh0IGlzIGFjdGl2ZSwgYGZhbHNlYCBvdGhlcndpc2UuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc0FzeW5jRXJyb3JJZ25vcmVDb250ZXh0QWN0aXZlKCk6IGJvb2xlYW4ge1xuICByZXR1cm4gbW9kdWxlU3RhdGUuYXN5bmNFcnJvcklnbm9yZUNvbnRleHREZXB0aCA+IDA7XG59XG5cbi8qKlxuICogUHJpbnRzIGFuIGVycm9yIHRvIHRoZSBjb25zb2xlLCBpbmNsdWRpbmcgbmVzdGVkIGNhdXNlcyBhbmQgb3B0aW9uYWwgQU5TSSBzZXF1ZW5jZSBjbGVhcmluZy5cbiAqXG4gKiBAcGFyYW0gZXJyb3IgLSBUaGUgZXJyb3IgdG8gcHJpbnQuXG4gKiBAcGFyYW0gY29uc29sZSAtIFRoZSBjb25zb2xlIHRvIHByaW50IHRvIChkZWZhdWx0OiBgZ2xvYmFsVGhpcy5jb25zb2xlYCkuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBwcmludEVycm9yKGVycm9yOiB1bmtub3duLCBjb25zb2xlPzogQ29uc29sZSk6IHZvaWQge1xuICBjb25zb2xlID8/PSBnbG9iYWxUaGlzLmNvbnNvbGU7XG4gIGNvbnNvbGUuZXJyb3IoZXJyb3JUb1N0cmluZyhlcnJvcikpO1xufVxuXG4vKipcbiAqIFJlZ2lzdGVycyBhbiBldmVudCBoYW5kbGVyIGZvciBhc3luY2hyb25vdXMgZXJyb3JzLlxuICpcbiAqIFJlZ2lzdGVyaW5nIGEgaGFuZGxlciBkb2VzIG5vdCBtYXJrIHRoZSBlcnJvcnMgaXQgcmVjZWl2ZXMgYXMgZXhwZWN0ZWQgXHUyMDE0IHNlZVxuICoge0BsaW5rIGVtaXRBc3luY0Vycm9yRXZlbnR9LiBBIHRlc3QgdGhhdCBkZWxpYmVyYXRlbHkgdHJpZ2dlcnMgYW4gYXN5bmMgZXJyb3Igb3BlbnMgYVxuICoge0BsaW5rIHN0YXJ0QXN5bmNFcnJvcklnbm9yZUNvbnRleHR9IHNjb3BlIHJlZ2FyZGxlc3Mgb2Ygd2hvIGlzIGxpc3RlbmluZy5cbiAqXG4gKiBAcGFyYW0gaGFuZGxlciAtIFRoZSBoYW5kbGVyIGZ1bmN0aW9uIHRvIGJlIGNhbGxlZCB3aGVuIGFuIGFzeW5jaHJvbm91cyBlcnJvciBldmVudCBvY2N1cnMuXG4gKiBAcmV0dXJucyBBIHtAbGluayBEaXNwb3NhYmxlfSB0aGF0IHVucmVnaXN0ZXJzIHRoZSBoYW5kbGVyIHdoZW4gZGlzcG9zZWQsIGZvciB1c2Ugd2l0aCBgdXNpbmdgLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVnaXN0ZXJBc3luY0Vycm9yRXZlbnRIYW5kbGVyKGhhbmRsZXI6IChhc3luY0Vycm9yOiB1bmtub3duKSA9PiB2b2lkKTogRGlzcG9zYWJsZSB7XG4gIGNvbnN0IGV2ZW50UmVmID0gZXJyb3JBc3luY0V2ZW50cy5vbignYXN5bmNFcnJvcicsIGhhbmRsZXIpO1xuICByZXR1cm4gbmV3IENhbGxiYWNrRGlzcG9zYWJsZSh7XG4gICAgY2FsbGJhY2s6ICgpOiB2b2lkID0+IHtcbiAgICAgIGVycm9yQXN5bmNFdmVudHMub2ZmcmVmKGV2ZW50UmVmKTtcbiAgICB9LFxuICAgIG11bHRpcGxlRGlzcG9zZUJlaGF2aW9yOiBNdWx0aXBsZURpc3Bvc2VCZWhhdmlvci5JZ25vcmVcbiAgfSk7XG59XG5cbi8qKlxuICogT3BlbnMgYW4gaWdub3JlIGNvbnRleHQgaW4gd2hpY2ggYXN5bmMgZXJyb3JzIGFyZSB0cmVhdGVkIGFzIGV4cGVjdGVkIHJhdGhlciB0aGFuIHVuaGFuZGxlZCwgc28gdGhlXG4gKiB0ZXN0IGhhcm5lc3MgZG9lcyBub3QgZmFpbCB0aGUgdGVzdC5cbiAqXG4gKiBXaGlsZSB0aGUgcmV0dXJuZWQgZGlzcG9zYWJsZSBpcyBoZWxkLCBhbiBhc3luYyBlcnJvciBlbWl0dGVkIGRpcmVjdGx5IChzZWVcbiAqIHtAbGluayBlbWl0QXN5bmNFcnJvckV2ZW50fSkgaXMgbm90IGNvbGxlY3RlZCBhcyB1bmhhbmRsZWQuIENydWNpYWxseSwgYSBmaXJlLWFuZC1mb3JnZXQgb3BlcmF0aW9uXG4gKiBzY2hlZHVsZWQgd2l0aGluIHRoZSBzY29wZSAoZS5nLiB2aWEge0BsaW5rIGFzeW5jIWludm9rZUFzeW5jU2FmZWx5fSkgaXMgYWxzbyBpZ25vcmVkIHdoZW4gaXQgbGF0ZXJcbiAqIHJlamVjdHMgXHUyMDE0IGV2ZW4gYWZ0ZXIgdGhlIHNjb3BlIGhhcyBleGl0ZWQgXHUyMDE0IGJlY2F1c2Uge0BsaW5rIGFzeW5jIWFkZEVycm9ySGFuZGxlcn0gY2FwdHVyZXMgdGhlIGFjdGl2ZVxuICogaWdub3JlIGNvbnRleHQgYXQgc2NoZWR1bGUgdGltZS4gQSB0ZXN0IHRoZXJlZm9yZSBkb2VzIG5vdCBuZWVkIHRvIGRyYWluIHRoZSBvcGVyYXRpb24gaXRzZWxmOlxuICpcbiAqIGBgYHRzXG4gKiBpdCgnZG9lcyBub3QgZmFpbCcsICgpID0+IHtcbiAqICAgdXNpbmcgXyA9IHN0YXJ0QXN5bmNFcnJvcklnbm9yZUNvbnRleHQoKTtcbiAqICAgaW52b2tlQXN5bmNTYWZlbHkoKCkgPT4gUHJvbWlzZS5yZWplY3QobmV3IEVycm9yKCdkZWxpYmVyYXRlbHkgc3dhbGxvd2VkJykpKTtcbiAqIH0pO1xuICogYGBgXG4gKlxuICogQ29udGV4dHMgbmVzdDsgdGhlIGlnbm9yZSBvbmx5IGVuZHMgb25jZSBldmVyeSBvcGVuIGNvbnRleHQgaGFzIGJlZW4gZGlzcG9zZWQuXG4gKlxuICogQHJldHVybnMgQSB7QGxpbmsgRGlzcG9zYWJsZX0gdGhhdCBjbG9zZXMgdGhlIGlnbm9yZSBjb250ZXh0IHdoZW4gZGlzcG9zZWQsIGZvciB1c2Ugd2l0aCBgdXNpbmdgLlxuICovXG5leHBvcnQgZnVuY3Rpb24gc3RhcnRBc3luY0Vycm9ySWdub3JlQ29udGV4dCgpOiBEaXNwb3NhYmxlIHtcbiAgbW9kdWxlU3RhdGUuYXN5bmNFcnJvcklnbm9yZUNvbnRleHREZXB0aCsrO1xuICByZXR1cm4gbmV3IENhbGxiYWNrRGlzcG9zYWJsZSh7XG4gICAgY2FsbGJhY2s6ICgpOiB2b2lkID0+IHtcbiAgICAgIG1vZHVsZVN0YXRlLmFzeW5jRXJyb3JJZ25vcmVDb250ZXh0RGVwdGgtLTtcbiAgICB9LFxuICAgIG11bHRpcGxlRGlzcG9zZUJlaGF2aW9yOiBNdWx0aXBsZURpc3Bvc2VCZWhhdmlvci5JZ25vcmVcbiAgfSk7XG59XG5cbi8qKlxuICogT3BlbnMgYSB3aW5kb3cgaW4gd2hpY2ggYXN5bmMgZXJyb3JzIGVtaXR0ZWQgb3V0c2lkZSBhbiBpZ25vcmUgY29udGV4dCBhcmUgY29sbGVjdGVkIGFzIHVuaGFuZGxlZFxuICogKHNlZSB7QGxpbmsgZW1pdEFzeW5jRXJyb3JFdmVudH0pLCBkaXNjYXJkaW5nIGFueXRoaW5nIGNvbGxlY3RlZCBieSBhIHByZXZpb3VzIHdpbmRvdy5cbiAqXG4gKiBJbnRlbmRlZCBmb3IgdGhlIHRlc3QgaGFybmVzcyBvbmx5OiB0aGUgcGVyLXRlc3Qgc2V0dXAgb3BlbnMgYSB3aW5kb3cgYmVmb3JlIGVhY2ggdGVzdCBhbmQgZW1wdGllcyBpdFxuICogYWZ0ZXIgZWFjaCB0ZXN0IHZpYSB7QGxpbmsgZHJhaW5Db2xsZWN0ZWRVbmhhbmRsZWRBc3luY0Vycm9yc30sIGNsb3NpbmcgaXQgZm9yIGdvb2Qgd2l0aFxuICoge0BsaW5rIHN0b3BDb2xsZWN0aW5nVW5oYW5kbGVkQXN5bmNFcnJvcnN9IG9uY2UgdGhlIGZpbGUncyBsYXN0IHRlc3QgaGFzIHJ1bi4gSW4gcHJvZHVjdGlvbiBubyB3aW5kb3dcbiAqIGlzIG9wZW4sIHNvIGVtaXR0aW5nIGFuIGFzeW5jIGVycm9yIGNhcnJpZXMgbm8gYm9va2tlZXBpbmcgb3ZlcmhlYWQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzdGFydENvbGxlY3RpbmdVbmhhbmRsZWRBc3luY0Vycm9ycygpOiB2b2lkIHtcbiAgbW9kdWxlU3RhdGUuY29sbGVjdGVkVW5oYW5kbGVkQXN5bmNFcnJvcnMgPSBbXTtcbn1cblxuLyoqXG4gKiBDbG9zZXMgdGhlIHdpbmRvdyBvcGVuZWQgYnkge0BsaW5rIHN0YXJ0Q29sbGVjdGluZ1VuaGFuZGxlZEFzeW5jRXJyb3JzfSBhbmQgcmV0dXJucyB0aGUgdW5oYW5kbGVkXG4gKiBhc3luYyBlcnJvcnMgY29sbGVjdGVkIHdoaWxlIGl0IHdhcyBvcGVuLlxuICpcbiAqIFVzZSB7QGxpbmsgZHJhaW5Db2xsZWN0ZWRVbmhhbmRsZWRBc3luY0Vycm9yc30gaW5zdGVhZCB3aGVyZXZlciBjb2xsZWN0aW9uIG11c3QgY29udGludWUgYWZ0ZXJ3YXJkcyBcdTIwMTRcbiAqIG9uY2UgdGhlIHdpbmRvdyBpcyBjbG9zZWQsIGEgbGF0ZXIgYXN5bmMgZXJyb3IgaXMgbm90IGNvbGxlY3RlZCBieSBhbnlvbmUuXG4gKlxuICogQHJldHVybnMgVGhlIGNvbGxlY3RlZCB1bmhhbmRsZWQgYXN5bmMgZXJyb3JzLCBvciBhbiBlbXB0eSBhcnJheSBpZiBubyB3aW5kb3cgd2FzIG9wZW4uXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzdG9wQ29sbGVjdGluZ1VuaGFuZGxlZEFzeW5jRXJyb3JzKCk6IHVua25vd25bXSB7XG4gIGNvbnN0IGNvbGxlY3RlZEVycm9ycyA9IG1vZHVsZVN0YXRlLmNvbGxlY3RlZFVuaGFuZGxlZEFzeW5jRXJyb3JzID8/IFtdO1xuICBtb2R1bGVTdGF0ZS5jb2xsZWN0ZWRVbmhhbmRsZWRBc3luY0Vycm9ycyA9IG51bGw7XG4gIHJldHVybiBjb2xsZWN0ZWRFcnJvcnM7XG59XG5cbi8qKlxuICogVGhyb3dzIGFuIGVycm9yIHdpdGggdGhlIHNwZWNpZmllZCBtZXNzYWdlLlxuICpcbiAqIEBwYXJhbSBlcnJvciAtIFRoZSBlcnJvciB0byB0aHJvdy5cbiAqIEB0aHJvd3NcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHRocm93RXhwcmVzc2lvbihlcnJvcjogdW5rbm93bik6IG5ldmVyIHtcbiAgdGhyb3cgZXJyb3I7XG59XG5cbmZ1bmN0aW9uIGdlbmVyYXRlTmVzdGVkRXJyb3JMaW5lcyhuZXN0ZWRFcnJvcjogdW5rbm93biwgdGl0bGU6IHN0cmluZyk6IEVycm9yTGluZVtdIHtcbiAgY29uc3QgbGluZXMgPSBbdG9UaXRsZUxpbmUodGl0bGUpLCAuLi5nZXRFcnJvckxpbmVzKG5lc3RlZEVycm9yKS5maWx0ZXIoKGxpbmUpID0+IGxpbmUudGV4dC50cmltKCkgIT09ICcnKV07XG4gIHJldHVybiBsaW5lcy5tYXAoKGxpbmUpID0+IGxpbmUuaXNGcmFtZSA/IGxpbmUgOiB7IGlzRnJhbWU6IHRydWUsIHRleHQ6IGdlbmVyYXRlU3RhY2tUcmFjZUxpbmUobGluZS50ZXh0KSB9KTtcbn1cblxuZnVuY3Rpb24gZ2VuZXJhdGVTdGFja1RyYWNlTGluZSh0aXRsZTogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIGAke1NUQUNLX1RSQUNFX1BSRUZJWH0gLS0tICR7dGl0bGV9IC0tLSAoMClgO1xufVxuXG4vKipcbiAqIEJ1aWxkcyB0aGUgYE5hbWU6IG1lc3NhZ2VgIGhlYWRlciB0aGUgd2F5IFY4IHdyaXRlcyBpdCBpbnRvIGAuc3RhY2tgIChhIGJhcmUgYE5hbWVgIGZvciBhbiBlbXB0eSBtZXNzYWdlKS5cbiAqXG4gKiBAcGFyYW0gZXJyb3IgLSBUaGUgZXJyb3IuXG4gKiBAcmV0dXJucyBUaGUgaGVhZGVyLCB3aGljaCBzcGFucyBzZXZlcmFsIGxpbmVzIHdoZW4gdGhlIG1lc3NhZ2UgZG9lcy5cbiAqL1xuZnVuY3Rpb24gZ2V0RXJyb3JIZWFkZXIoZXJyb3I6IEVycm9yKTogc3RyaW5nIHtcbiAgcmV0dXJuIGVycm9yLm1lc3NhZ2UgPyBgJHtlcnJvci5uYW1lfTogJHtlcnJvci5tZXNzYWdlfWAgOiBlcnJvci5uYW1lO1xufVxuXG5mdW5jdGlvbiBnZXRFcnJvckxpbmVzKGVycm9yOiB1bmtub3duKTogRXJyb3JMaW5lW10ge1xuICBpZiAoIShlcnJvciBpbnN0YW5jZW9mIEVycm9yKSkge1xuICAgIHJldHVybiBTdHJpbmcoZXJyb3IpLnNwbGl0KCdcXG4nKS5tYXAoKHRleHQpID0+IHRvVGl0bGVMaW5lKHRleHQpKTtcbiAgfVxuXG4gIGNvbnN0IGxpbmVzID0gZ2V0T3duRXJyb3JMaW5lcyhlcnJvcik7XG4gIGlmIChlcnJvci5jYXVzZSAhPT0gdW5kZWZpbmVkKSB7XG4gICAgbGluZXMucHVzaCguLi5nZW5lcmF0ZU5lc3RlZEVycm9yTGluZXMoZXJyb3IuY2F1c2UsICdDYXVzZWQgYnk6JykpO1xuICB9XG4gIGlmIChlcnJvciBpbnN0YW5jZW9mIEFnZ3JlZ2F0ZUVycm9yKSB7XG4gICAgY29uc3QgYWdncmVnYXRlZEVycm9yczogcmVhZG9ubHkgdW5rbm93bltdID0gZXJyb3IuZXJyb3JzO1xuICAgIGZvciAoY29uc3QgW2luZGV4LCBhZ2dyZWdhdGVkRXJyb3JdIG9mIGFnZ3JlZ2F0ZWRFcnJvcnMuZW50cmllcygpKSB7XG4gICAgICBsaW5lcy5wdXNoKC4uLmdlbmVyYXRlTmVzdGVkRXJyb3JMaW5lcyhhZ2dyZWdhdGVkRXJyb3IsIGBBZ2dyZWdhdGVkIGVycm9yICMke1N0cmluZyhpbmRleCArIDEpfTpgKSk7XG4gICAgfVxuICB9XG4gIHJldHVybiBsaW5lcztcbn1cblxuZnVuY3Rpb24gZ2V0T3duRXJyb3JMaW5lcyhlcnJvcjogRXJyb3IpOiBFcnJvckxpbmVbXSB7XG4gIGNvbnN0IGhlYWRlckxpbmVzID0gZ2V0RXJyb3JIZWFkZXIoZXJyb3IpLnNwbGl0KCdcXG4nKS5tYXAoKHRleHQpID0+IHRvVGl0bGVMaW5lKHRleHQpKTtcbiAgaWYgKGVycm9yLnN0YWNrID09PSB1bmRlZmluZWQpIHtcbiAgICByZXR1cm4gaGVhZGVyTGluZXM7XG4gIH1cblxuICBjb25zdCBzdGFja0xpbmVzID0gZXJyb3Iuc3RhY2suc3BsaXQoJ1xcbicpO1xuICBpZiAoaGFzU3RhY2tIZWFkZXIoKSkge1xuICAgIHJldHVybiBzdGFja0xpbmVzLm1hcCgodGV4dCkgPT4gKHsgaXNGcmFtZTogdGV4dC5zdGFydHNXaXRoKFNUQUNLX1RSQUNFX1BSRUZJWCksIHRleHQgfSkpO1xuICB9XG5cbiAgLy8gT24gYW4gZW5naW5lIHdpdGhvdXQgYSBoZWFkZXIgbGluZSwgdGhlIGAuc3RhY2tgIGlzIGZyYW1lcyBvbmx5LCBpbiBpdHMgb3duIGBuYW1lQHVybDpsaW5lOmNvbGAgZm9ybSwgc28gdGhlIG1lc3NhZ2UgaXMgbm93aGVyZSBpbiBpdDpcbiAgLy8gUHJlcGVuZCB0aGUgaGVhZGVyLCBhbmQgdGFrZSBldmVyeSBzdGFjayBsaW5lIGFzIGEgZnJhbWUuXG4gIHJldHVybiBbLi4uaGVhZGVyTGluZXMsIC4uLnN0YWNrTGluZXMuZmlsdGVyKCh0ZXh0KSA9PiB0ZXh0LnRyaW0oKSAhPT0gJycpLm1hcCgodGV4dCkgPT4gKHsgaXNGcmFtZTogdHJ1ZSwgdGV4dCB9KSldO1xufVxuXG4vKipcbiAqIEhhbmRsZXMgYXN5bmNocm9ub3VzIGVycm9ycyBieSBwcmludGluZyB0aGVtLlxuICpcbiAqIEBwYXJhbSBhc3luY0Vycm9yIC0gVGhlIGFzeW5jaHJvbm91cyBlcnJvciB0byBoYW5kbGUuXG4gKi9cbmZ1bmN0aW9uIGhhbmRsZUFzeW5jRXJyb3IoYXN5bmNFcnJvcjogdW5rbm93bik6IHZvaWQge1xuICBwcmludEVycm9yKGFzeW5jRXJyb3IpO1xufVxuXG4vKipcbiAqIEFuc3dlcnMgd2hldGhlciB0aGlzIGVuZ2luZSdzIGAuc3RhY2tgIG9wZW5zIHdpdGggdGhlIGVycm9yJ3MgYE5hbWU6IG1lc3NhZ2VgIGhlYWRlciBsaW5lLlxuICpcbiAqIFY4IHdyaXRlcyBvbmU7IEphdmFTY3JpcHRDb3JlIChldmVyeSBBcHBsZSBwbGF0Zm9ybSwgc28gT2JzaWRpYW4gb24gaU9TIGFuZCBpUGFkT1MpIGFuZCBTcGlkZXJNb25rZXkgd3JpdGUgZnJhbWVzIG9ubHkuXG4gKiBUaGUgYW5zd2VyIGJlbG9uZ3MgdG8gdGhlIGVuZ2luZSwgbm90IHRoZSBwbGF0Zm9ybSwgc28gaXQgaXMgcHJvYmVkIHJhdGhlciB0aGFuIHJlYWQgb2ZmIGBQbGF0Zm9ybWAuIEl0IGlzIHByb2JlZCBvbiBldmVyeVxuICogY2FsbCByYXRoZXIgdGhhbiBjYWNoZWQsIGJlY2F1c2UgYEVycm9yLnByZXBhcmVTdGFja1RyYWNlYCBjYW4gcmVzaGFwZSBWOCdzIHN0YWNrIGF0IHJ1bnRpbWUsIGFuZCBvbmUgZXh0cmEgYEVycm9yYCBjb3N0c1xuICogbm90aGluZyBvbiBhIHBhdGggdGhhdCBpcyBhbHJlYWR5IGhhbmRsaW5nIG9uZS5cbiAqXG4gKiBAcmV0dXJucyBgdHJ1ZWAgaWYgYC5zdGFja2AgY2FycmllcyB0aGUgaGVhZGVyIGxpbmUuXG4gKi9cbmZ1bmN0aW9uIGhhc1N0YWNrSGVhZGVyKCk6IGJvb2xlYW4ge1xuICBjb25zdCBmaXJzdExpbmUgPSBuZXcgRXJyb3IoU1RBQ0tfSEVBREVSX1BST0JFX01FU1NBR0UpLnN0YWNrPy5zcGxpdCgnXFxuJywgMSlbMF07XG4gIHJldHVybiBmaXJzdExpbmUgPT09IGBFcnJvcjogJHtTVEFDS19IRUFERVJfUFJPQkVfTUVTU0FHRX1gO1xufVxuXG5mdW5jdGlvbiB0b1RpdGxlTGluZSh0ZXh0OiBzdHJpbmcpOiBFcnJvckxpbmUge1xuICByZXR1cm4geyBpc0ZyYW1lOiBmYWxzZSwgdGV4dCB9O1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7QUFNQSxTQUFTLG1CQUFtQjtBQUM1QjtBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsT0FDSztBQUNQLFNBQVMseUJBQXlCO0FBTWxDLE1BQU0sbUJBQW1CLElBQUksWUFBZ0M7QUFFN0QsaUJBQWlCLEdBQUcsY0FBYyxnQkFBZ0I7QUF1QmxELE1BQU0sY0FBMkI7QUFBQSxFQUMvQiw4QkFBOEI7QUFBQSxFQUM5QiwrQkFBK0I7QUFDakM7QUFJTyxNQUFNLDhCQUE4QjtBQUUzQyxNQUFNLHFCQUFxQjtBQUUzQixNQUFNLHVCQUF1QjtBQUU3QixNQUFNLDZCQUE2QjtBQW9DNUIsTUFBTSw4QkFBOEIsTUFBTTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU14QyxZQUFZLFFBQWdEO0FBQ2pFLFVBQU0sRUFBRSxPQUFPLFNBQVMsV0FBVyxJQUFJO0FBQ3ZDLFVBQU0sU0FBUyxFQUFFLE1BQU0sQ0FBQztBQUN4QixTQUFLLE9BQU87QUFFWixRQUFJLFlBQVk7QUFDaEIsVUFBTSxlQUFlLG9CQUFJLElBQTJCO0FBQ3BELFdBQU8scUJBQXFCLHVCQUF1QjtBQUNqRCxVQUFJLGFBQWEsSUFBSSxTQUFTLEdBQUc7QUFDL0IsY0FBTSxJQUFJLE1BQU0seUJBQXlCO0FBQUEsTUFDM0M7QUFDQSxtQkFBYSxJQUFJLFNBQVM7QUFDMUIsa0JBQVksVUFBVTtBQUFBLElBQ3hCO0FBRUEsVUFBTSxhQUFhLFdBQVcsTUFBTSxJQUFJO0FBQ3hDLFFBQUkscUJBQXFC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

package/dist/lib/esm/function.d.mts

@@ -0,0 +1,128 @@
+/// <reference path="./library-references.d.mts" />
+/**
+ * @file
+ *
+ * Contains utility functions and types for working with functions.
+ */
+import type { Promisable } from 'type-fest';
+/**
+ * Represents a generic async function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ * @typeParam Return - The awaited return type of the function.
+ */
+export type GenericAsyncFunction<Arguments extends unknown[] = never[], Return = unknown> = GenericFunction<Arguments, Promise<Return>>;
+/**
+ * Represents a generic async void function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ */
+export type GenericAsyncVoidFunction<Arguments extends unknown[] = never[]> = GenericAsyncFunction<Arguments, void>;
+/**
+ * Represents a generic function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ * @typeParam Return - The return type of the function.
+ */
+export type GenericFunction<Arguments extends unknown[] = never[], Return = unknown> = (...$arguments: Arguments) => Return;
+/**
+ * Represents a generic promisable function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ * @typeParam Return - The awaited return type of the function.
+ */
+export type GenericPromisableFunction<Arguments extends unknown[] = never[], Return = unknown> = GenericFunction<Arguments, Promisable<Return>>;
+/**
+ * Represents a generic promisable void function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ */
+export type GenericPromisableVoidFunction<Arguments extends unknown[] = never[]> = GenericPromisableFunction<Arguments, void>;
+/**
+ * Represents a generic void function.
+ *
+ * @typeParam Arguments - The arguments of the function.
+ */
+export type GenericVoidFunction<Arguments extends unknown[] = never[]> = GenericFunction<Arguments, void>;
+/**
+ * Converts a function into a string that is a valid function expression.
+ *
+ * `Function.prototype.toString()` on a shorthand method like `{ fn() {} }`
+ * returns `"fn() {}"`, which is not a valid expression.
+ * This helper detects that form and prefixes it with `function `.
+ *
+ * @param $function - The function to convert.
+ * @returns A string that is a valid function expression.
+ */
+export declare function getFunctionExpressionString($function: Function): string;
+/**
+ * A function that does nothing.
+ */
+export declare function noop(): void;
+/**
+ * A singleton no-op promise.
+ */
+export declare const noopAsyncSingletonPromise: Promise<void>;
+/**
+ * A function that does nothing.
+ *
+ * @returns A promise that resolves when the function is complete.
+ */
+export declare function noopAsync(): Promise<void>;
+/**
+ * Makes an async function that calls the original async function with the provided arguments and omits the return value.
+ *
+ * @typeParam Arguments - Arguments to be passed to the function.
+ * @param $function - Function to be called.
+ * @returns An async function that calls the original function with the provided arguments and omits the return value.
+ */
+export declare function omitAsyncReturnType<Arguments extends unknown[]>($function: GenericAsyncFunction<Arguments>): GenericAsyncVoidFunction<Arguments>;
+type ArgumentNamesOf<T extends GenericFunction> = MapToArgumentNames<Parameters<T>>;
+interface CreateFunctionArgumentlessParams {
+    readonly functionBody: string;
+}
+interface CreateFunctionParams<TFunction extends GenericFunction> extends CreateFunctionArgumentlessParams {
+    readonly argumentNames: ArgumentNamesOf<TFunction>;
+}
+type MapToArgumentNames<TArguments extends readonly unknown[]> = {
+    readonly [K in keyof TArguments]: string;
+};
+/**
+ * Clone a function by creating a new function that calls the original function.
+ *
+ * This is useful for creating a new instance of a function that has the same behavior but is not strictly equal to the original function.
+ *
+ * @typeParam TFunction - The type of the function to clone.
+ * @param $function - The function to clone.
+ * @returns A new function that has the same behavior as the original function.
+ */
+export declare function cloneFunction<TFunction extends GenericFunction>($function: TFunction): TFunction;
+/**
+ * Creates a function from the provided parameters.
+ *
+ * Function is argumentless, so `argNames` is not needed.
+ *
+ * @typeParam TFunction - The type of the function to create.
+ * @param params - The parameters to create the function with.
+ * @returns A function created from the provided parameters.
+ */
+export declare function createFunction<TFunction extends () => unknown>(params: CreateFunctionArgumentlessParams): TFunction;
+/**
+ * Creates a function from the provided parameters.
+ *
+ * Function has arguments, so `argNames` is required.
+ *
+ * @typeParam TFunction - The type of the function to create.
+ * @param params - The parameters to create the function with.
+ * @returns A function created from the provided parameters.
+ */
+export declare function createFunction<TFunction extends GenericFunction>(params: CreateFunctionParams<TFunction>): TFunction;
+/**
+ * Makes a function that calls the original function with the provided arguments and omits the return value.
+ *
+ * @typeParam Arguments - Arguments to be passed to the function.
+ * @param $function - Function to be called.
+ * @returns A function that calls the original function with the provided arguments and omits the return value.
+ */
+export declare function omitReturnType<Arguments extends unknown[]>($function: GenericFunction<Arguments>): GenericVoidFunction<Arguments>;
+export {};

package/dist/lib/esm/function.mjs

@@ -0,0 +1,52 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+function getFunctionExpressionString($function) {
+  const functionString = $function.toString();
+  if (FUNCTION_EXPRESSION_RE.test(functionString)) {
+    return functionString;
+  }
+  const asyncMatch = ASYNC_KEYWORD_RE.exec(functionString);
+  return asyncMatch ? `async function ${functionString.slice(asyncMatch[0].length)}` : `function ${functionString}`;
+}
+function noop() {
+}
+const noopAsyncSingletonPromise = Promise.resolve();
+function noopAsync() {
+  return noopAsyncSingletonPromise;
+}
+function omitAsyncReturnType($function) {
+  return async (...$arguments) => {
+    await $function(...$arguments);
+  };
+}
+const FUNCTION_EXPRESSION_RE = /^(?:function\b|async\b\s*(?:function\b|\()|\()/;
+const ASYNC_KEYWORD_RE = /^async\b\s*/;
+function cloneFunction($function) {
+  return clonedFunction;
+  function clonedFunction(...$arguments) {
+    return $function.apply(this, $arguments);
+  }
+}
+function createFunction(params) {
+  const argumentNames = params.argumentNames ?? [];
+  return new Function(...argumentNames, params.functionBody);
+}
+function omitReturnType($function) {
+  return (...$arguments) => {
+    $function(...$arguments);
+  };
+}
+export {
+  cloneFunction,
+  createFunction,
+  getFunctionExpressionString,
+  noop,
+  noopAsync,
+  noopAsyncSingletonPromise,
+  omitAsyncReturnType,
+  omitReturnType
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2Z1bmN0aW9uLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29udGFpbnMgdXRpbGl0eSBmdW5jdGlvbnMgYW5kIHR5cGVzIGZvciB3b3JraW5nIHdpdGggZnVuY3Rpb25zLlxuICovXG5cbmltcG9ydCB0eXBlIHsgUHJvbWlzYWJsZSB9IGZyb20gJ3R5cGUtZmVzdCc7XG5cbi8qKlxuICogUmVwcmVzZW50cyBhIGdlbmVyaWMgYXN5bmMgZnVuY3Rpb24uXG4gKlxuICogQHR5cGVQYXJhbSBBcmd1bWVudHMgLSBUaGUgYXJndW1lbnRzIG9mIHRoZSBmdW5jdGlvbi5cbiAqIEB0eXBlUGFyYW0gUmV0dXJuIC0gVGhlIGF3YWl0ZWQgcmV0dXJuIHR5cGUgb2YgdGhlIGZ1bmN0aW9uLlxuICovXG5leHBvcnQgdHlwZSBHZW5lcmljQXN5bmNGdW5jdGlvbjxBcmd1bWVudHMgZXh0ZW5kcyB1bmtub3duW10gPSBuZXZlcltdLCBSZXR1cm4gPSB1bmtub3duPiA9IEdlbmVyaWNGdW5jdGlvbjxBcmd1bWVudHMsIFByb21pc2U8UmV0dXJuPj47XG5cbi8qKlxuICogUmVwcmVzZW50cyBhIGdlbmVyaWMgYXN5bmMgdm9pZCBmdW5jdGlvbi5cbiAqXG4gKiBAdHlwZVBhcmFtIEFyZ3VtZW50cyAtIFRoZSBhcmd1bWVudHMgb2YgdGhlIGZ1bmN0aW9uLlxuICovXG5leHBvcnQgdHlwZSBHZW5lcmljQXN5bmNWb2lkRnVuY3Rpb248QXJndW1lbnRzIGV4dGVuZHMgdW5rbm93bltdID0gbmV2ZXJbXT4gPSBHZW5lcmljQXN5bmNGdW5jdGlvbjxBcmd1bWVudHMsIHZvaWQ+O1xuXG4vKipcbiAqIFJlcHJlc2VudHMgYSBnZW5lcmljIGZ1bmN0aW9uLlxuICpcbiAqIEB0eXBlUGFyYW0gQXJndW1lbnRzIC0gVGhlIGFyZ3VtZW50cyBvZiB0aGUgZnVuY3Rpb24uXG4gKiBAdHlwZVBhcmFtIFJldHVybiAtIFRoZSByZXR1cm4gdHlwZSBvZiB0aGUgZnVuY3Rpb24uXG4gKi9cbmV4cG9ydCB0eXBlIEdlbmVyaWNGdW5jdGlvbjxBcmd1bWVudHMgZXh0ZW5kcyB1bmtub3duW10gPSBuZXZlcltdLCBSZXR1cm4gPSB1bmtub3duPiA9ICguLi4kYXJndW1lbnRzOiBBcmd1bWVudHMpID0+IFJldHVybjtcblxuLyoqXG4gKiBSZXByZXNlbnRzIGEgZ2VuZXJpYyBwcm9taXNhYmxlIGZ1bmN0aW9uLlxuICpcbiAqIEB0eXBlUGFyYW0gQXJndW1lbnRzIC0gVGhlIGFyZ3VtZW50cyBvZiB0aGUgZnVuY3Rpb24uXG4gKiBAdHlwZVBhcmFtIFJldHVybiAtIFRoZSBhd2FpdGVkIHJldHVybiB0eXBlIG9mIHRoZSBmdW5jdGlvbi5cbiAqL1xuZXhwb3J0IHR5cGUgR2VuZXJpY1Byb21pc2FibGVGdW5jdGlvbjxBcmd1bWVudHMgZXh0ZW5kcyB1bmtub3duW10gPSBuZXZlcltdLCBSZXR1cm4gPSB1bmtub3duPiA9IEdlbmVyaWNGdW5jdGlvbjxBcmd1bWVudHMsIFByb21pc2FibGU8UmV0dXJuPj47XG5cbi8qKlxuICogUmVwcmVzZW50cyBhIGdlbmVyaWMgcHJvbWlzYWJsZSB2b2lkIGZ1bmN0aW9uLlxuICpcbiAqIEB0eXBlUGFyYW0gQXJndW1lbnRzIC0gVGhlIGFyZ3VtZW50cyBvZiB0aGUgZnVuY3Rpb24uXG4gKi9cbmV4cG9ydCB0eXBlIEdlbmVyaWNQcm9taXNhYmxlVm9pZEZ1bmN0aW9uPEFyZ3VtZW50cyBleHRlbmRzIHVua25vd25bXSA9IG5ldmVyW10+ID0gR2VuZXJpY1Byb21pc2FibGVGdW5jdGlvbjxBcmd1bWVudHMsIHZvaWQ+O1xuXG4vKipcbiAqIFJlcHJlc2VudHMgYSBnZW5lcmljIHZvaWQgZnVuY3Rpb24uXG4gKlxuICogQHR5cGVQYXJhbSBBcmd1bWVudHMgLSBUaGUgYXJndW1lbnRzIG9mIHRoZSBmdW5jdGlvbi5cbiAqL1xuZXhwb3J0IHR5cGUgR2VuZXJpY1ZvaWRGdW5jdGlvbjxBcmd1bWVudHMgZXh0ZW5kcyB1bmtub3duW10gPSBuZXZlcltdPiA9IEdlbmVyaWNGdW5jdGlvbjxBcmd1bWVudHMsIHZvaWQ+O1xuXG4vKipcbiAqIENvbnZlcnRzIGEgZnVuY3Rpb24gaW50byBhIHN0cmluZyB0aGF0IGlzIGEgdmFsaWQgZnVuY3Rpb24gZXhwcmVzc2lvbi5cbiAqXG4gKiBgRnVuY3Rpb24ucHJvdG90eXBlLnRvU3RyaW5nKClgIG9uIGEgc2hvcnRoYW5kIG1ldGhvZCBsaWtlIGB7IGZuKCkge30gfWBcbiAqIHJldHVybnMgYFwiZm4oKSB7fVwiYCwgd2hpY2ggaXMgbm90IGEgdmFsaWQgZXhwcmVzc2lvbi5cbiAqIFRoaXMgaGVscGVyIGRldGVjdHMgdGhhdCBmb3JtIGFuZCBwcmVmaXhlcyBpdCB3aXRoIGBmdW5jdGlvbiBgLlxuICpcbiAqIEBwYXJhbSAkZnVuY3Rpb24gLSBUaGUgZnVuY3Rpb24gdG8gY29udmVydC5cbiAqIEByZXR1cm5zIEEgc3RyaW5nIHRoYXQgaXMgYSB2YWxpZCBmdW5jdGlvbiBleHByZXNzaW9uLlxuICovXG4vLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgQHR5cGVzY3JpcHQtZXNsaW50L25vLXVuc2FmZS1mdW5jdGlvbi10eXBlIC0tIFdlIG5lZWQgdG8gdXNlIGBGdW5jdGlvbmAgdHlwZS5cbmV4cG9ydCBmdW5jdGlvbiBnZXRGdW5jdGlvbkV4cHJlc3Npb25TdHJpbmcoJGZ1bmN0aW9uOiBGdW5jdGlvbik6IHN0cmluZyB7XG4gIGNvbnN0IGZ1bmN0aW9uU3RyaW5nID0gJGZ1bmN0aW9uLnRvU3RyaW5nKCk7XG5cbiAgaWYgKEZVTkNUSU9OX0VYUFJFU1NJT05fUkUudGVzdChmdW5jdGlvblN0cmluZykpIHtcbiAgICByZXR1cm4gZnVuY3Rpb25TdHJpbmc7XG4gIH1cblxuICBjb25zdCBhc3luY01hdGNoID0gQVNZTkNfS0VZV09SRF9SRS5leGVjKGZ1bmN0aW9uU3RyaW5nKTtcbiAgcmV0dXJuIGFzeW5jTWF0Y2ggPyBgYXN5bmMgZnVuY3Rpb24gJHtmdW5jdGlvblN0cmluZy5zbGljZShhc3luY01hdGNoWzBdLmxlbmd0aCl9YCA6IGBmdW5jdGlvbiAke2Z1bmN0aW9uU3RyaW5nfWA7XG59XG5cbi8qKlxuICogQSBmdW5jdGlvbiB0aGF0IGRvZXMgbm90aGluZy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIG5vb3AoKTogdm9pZCB7XG4gIC8vIERvZXMgbm90aGluZy5cbn1cblxuLyoqXG4gKiBBIHNpbmdsZXRvbiBuby1vcCBwcm9taXNlLlxuICovXG4vLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgb2JzaWRpYW4tZGV2LXV0aWxzL3ByZWZlci1ub29wLWFzeW5jIC0tIEF2b2lkIGNpcmN1bGFyIHJlZmVyZW5jZS5cbmV4cG9ydCBjb25zdCBub29wQXN5bmNTaW5nbGV0b25Qcm9taXNlID0gUHJvbWlzZS5yZXNvbHZlKCk7XG5cbi8qKlxuICogQSBmdW5jdGlvbiB0aGF0IGRvZXMgbm90aGluZy5cbiAqXG4gKiBAcmV0dXJucyBBIHByb21pc2UgdGhhdCByZXNvbHZlcyB3aGVuIHRoZSBmdW5jdGlvbiBpcyBjb21wbGV0ZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIG5vb3BBc3luYygpOiBQcm9taXNlPHZvaWQ+IHtcbiAgcmV0dXJuIG5vb3BBc3luY1NpbmdsZXRvblByb21pc2U7XG59XG5cbi8qKlxuICogTWFrZXMgYW4gYXN5bmMgZnVuY3Rpb24gdGhhdCBjYWxscyB0aGUgb3JpZ2luYWwgYXN5bmMgZnVuY3Rpb24gd2l0aCB0aGUgcHJvdmlkZWQgYXJndW1lbnRzIGFuZCBvbWl0cyB0aGUgcmV0dXJuIHZhbHVlLlxuICpcbiAqIEB0eXBlUGFyYW0gQXJndW1lbnRzIC0gQXJndW1lbnRzIHRvIGJlIHBhc3NlZCB0byB0aGUgZnVuY3Rpb24uXG4gKiBAcGFyYW0gJGZ1bmN0aW9uIC0gRnVuY3Rpb24gdG8gYmUgY2FsbGVkLlxuICogQHJldHVybnMgQW4gYXN5bmMgZnVuY3Rpb24gdGhhdCBjYWxscyB0aGUgb3JpZ2luYWwgZnVuY3Rpb24gd2l0aCB0aGUgcHJvdmlkZWQgYXJndW1lbnRzIGFuZCBvbWl0cyB0aGUgcmV0dXJuIHZhbHVlLlxuICovXG5leHBvcnQgZnVuY3Rpb24gb21pdEFzeW5jUmV0dXJuVHlwZTxBcmd1bWVudHMgZXh0ZW5kcyB1bmtub3duW10+KCRmdW5jdGlvbjogR2VuZXJpY0FzeW5jRnVuY3Rpb248QXJndW1lbnRzPik6IEdlbmVyaWNBc3luY1ZvaWRGdW5jdGlvbjxBcmd1bWVudHM+IHtcbiAgcmV0dXJuIGFzeW5jICguLi4kYXJndW1lbnRzOiBBcmd1bWVudHMpID0+IHtcbiAgICBhd2FpdCAkZnVuY3Rpb24oLi4uJGFyZ3VtZW50cyk7XG4gIH07XG59XG5cbi8qKlxuICogTWF0Y2hlcyBzdHJpbmdzIHRoYXQgYXJlIGFscmVhZHkgdmFsaWQgZnVuY3Rpb24gZXhwcmVzc2lvbnM6XG4gKiAtIGBmdW5jdGlvbiAuLi5gIChrZXl3b3JkLCBub3QgaWRlbnRpZmllciBsaWtlIGBmdW5jdGlvbjFgKVxuICogLSBgKGAgKGFycm93IGZ1bmN0aW9uKVxuICogLSBgYXN5bmNcXGJgIGZvbGxvd2VkIGJ5IGBmdW5jdGlvblxcYmAgb3IgYChgIChhc3luYyBmdW5jdGlvbi9hcnJvdylcbiAqL1xuY29uc3QgRlVOQ1RJT05fRVhQUkVTU0lPTl9SRSA9IC9eKD86ZnVuY3Rpb25cXGJ8YXN5bmNcXGJcXHMqKD86ZnVuY3Rpb25cXGJ8XFwoKXxcXCgpLztcblxuLyoqXG4gKiBNYXRjaGVzIHRoZSBgYXN5bmNgIGtleXdvcmQgKHdvcmQgYm91bmRhcnksIG5vdCBgYXN5bmMxYCkgZm9sbG93ZWQgYnkgb3B0aW9uYWwgd2hpdGVzcGFjZS5cbiAqIFVzZWQgdG8gc3RyaXAgdGhlIGBhc3luY2AgcHJlZml4IGZyb20gYXN5bmMgc2hvcnRoYW5kIG1ldGhvZHMgYmVmb3JlIHJlLWFkZGluZyBgYXN5bmMgZnVuY3Rpb25gLlxuICovXG5jb25zdCBBU1lOQ19LRVlXT1JEX1JFID0gL15hc3luY1xcYlxccyovO1xuXG50eXBlIEFyZ3VtZW50TmFtZXNPZjxUIGV4dGVuZHMgR2VuZXJpY0Z1bmN0aW9uPiA9IE1hcFRvQXJndW1lbnROYW1lczxQYXJhbWV0ZXJzPFQ+PjtcblxuaW50ZXJmYWNlIENyZWF0ZUZ1bmN0aW9uQXJndW1lbnRsZXNzUGFyYW1zIHtcbiAgcmVhZG9ubHkgZnVuY3Rpb25Cb2R5OiBzdHJpbmc7XG59XG5cbmludGVyZmFjZSBDcmVhdGVGdW5jdGlvblBhcmFtczxURnVuY3Rpb24gZXh0ZW5kcyBHZW5lcmljRnVuY3Rpb24+IGV4dGVuZHMgQ3JlYXRlRnVuY3Rpb25Bcmd1bWVudGxlc3NQYXJhbXMge1xuICByZWFkb25seSBhcmd1bWVudE5hbWVzOiBBcmd1bWVudE5hbWVzT2Y8VEZ1bmN0aW9uPjtcbn1cblxudHlwZSBNYXBUb0FyZ3VtZW50TmFtZXM8VEFyZ3VtZW50cyBleHRlbmRzIHJlYWRvbmx5IHVua25vd25bXT4gPSB7XG4gIHJlYWRvbmx5IFtLIGluIGtleW9mIFRBcmd1bWVudHNdOiBzdHJpbmc7XG59O1xuXG4vKipcbiAqIENsb25lIGEgZnVuY3Rpb24gYnkgY3JlYXRpbmcgYSBuZXcgZnVuY3Rpb24gdGhhdCBjYWxscyB0aGUgb3JpZ2luYWwgZnVuY3Rpb24uXG4gKlxuICogVGhpcyBpcyB1c2VmdWwgZm9yIGNyZWF0aW5nIGEgbmV3IGluc3RhbmNlIG9mIGEgZnVuY3Rpb24gdGhhdCBoYXMgdGhlIHNhbWUgYmVoYXZpb3IgYnV0IGlzIG5vdCBzdHJpY3RseSBlcXVhbCB0byB0aGUgb3JpZ2luYWwgZnVuY3Rpb24uXG4gKlxuICogQHR5cGVQYXJhbSBURnVuY3Rpb24gLSBUaGUgdHlwZSBvZiB0aGUgZnVuY3Rpb24gdG8gY2xvbmUuXG4gKiBAcGFyYW0gJGZ1bmN0aW9uIC0gVGhlIGZ1bmN0aW9uIHRvIGNsb25lLlxuICogQHJldHVybnMgQSBuZXcgZnVuY3Rpb24gdGhhdCBoYXMgdGhlIHNhbWUgYmVoYXZpb3IgYXMgdGhlIG9yaWdpbmFsIGZ1bmN0aW9uLlxuICovXG5leHBvcnQgZnVuY3Rpb24gY2xvbmVGdW5jdGlvbjxURnVuY3Rpb24gZXh0ZW5kcyBHZW5lcmljRnVuY3Rpb24+KCRmdW5jdGlvbjogVEZ1bmN0aW9uKTogVEZ1bmN0aW9uIHtcbiAgcmV0dXJuIGNsb25lZEZ1bmN0aW9uIGFzIFRGdW5jdGlvbjtcblxuICBmdW5jdGlvbiBjbG9uZWRGdW5jdGlvbih0aGlzOiBUaGlzUGFyYW1ldGVyVHlwZTxURnVuY3Rpb24+LCAuLi4kYXJndW1lbnRzOiBQYXJhbWV0ZXJzPFRGdW5jdGlvbj4pOiBSZXR1cm5UeXBlPFRGdW5jdGlvbj4ge1xuICAgIHJldHVybiAkZnVuY3Rpb24uYXBwbHkodGhpcywgJGFyZ3VtZW50cykgYXMgUmV0dXJuVHlwZTxURnVuY3Rpb24+O1xuICB9XG59XG4vKipcbiAqIENyZWF0ZXMgYSBmdW5jdGlvbiBmcm9tIHRoZSBwcm92aWRlZCBwYXJhbWV0ZXJzLlxuICpcbiAqIEZ1bmN0aW9uIGlzIGFyZ3VtZW50bGVzcywgc28gYGFyZ05hbWVzYCBpcyBub3QgbmVlZGVkLlxuICpcbiAqIEB0eXBlUGFyYW0gVEZ1bmN0aW9uIC0gVGhlIHR5cGUgb2YgdGhlIGZ1bmN0aW9uIHRvIGNyZWF0ZS5cbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycyB0byBjcmVhdGUgdGhlIGZ1bmN0aW9uIHdpdGguXG4gKiBAcmV0dXJucyBBIGZ1bmN0aW9uIGNyZWF0ZWQgZnJvbSB0aGUgcHJvdmlkZWQgcGFyYW1ldGVycy5cbiAqL1xuLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIEB0eXBlc2NyaXB0LWVzbGludC9uby11bm5lY2Vzc2FyeS10eXBlLXBhcmFtZXRlcnMgLS0gV2UgbmVlZCByZXR1cm4gdHlwZS5cbmV4cG9ydCBmdW5jdGlvbiBjcmVhdGVGdW5jdGlvbjxURnVuY3Rpb24gZXh0ZW5kcyAoKSA9PiB1bmtub3duPihwYXJhbXM6IENyZWF0ZUZ1bmN0aW9uQXJndW1lbnRsZXNzUGFyYW1zKTogVEZ1bmN0aW9uO1xuLyoqXG4gKiBDcmVhdGVzIGEgZnVuY3Rpb24gZnJvbSB0aGUgcHJvdmlkZWQgcGFyYW1ldGVycy5cbiAqXG4gKiBGdW5jdGlvbiBoYXMgYXJndW1lbnRzLCBzbyBgYXJnTmFtZXNgIGlzIHJlcXVpcmVkLlxuICpcbiAqIEB0eXBlUGFyYW0gVEZ1bmN0aW9uIC0gVGhlIHR5cGUgb2YgdGhlIGZ1bmN0aW9uIHRvIGNyZWF0ZS5cbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUgcGFyYW1ldGVycyB0byBjcmVhdGUgdGhlIGZ1bmN0aW9uIHdpdGguXG4gKiBAcmV0dXJucyBBIGZ1bmN0aW9uIGNyZWF0ZWQgZnJvbSB0aGUgcHJvdmlkZWQgcGFyYW1ldGVycy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGNyZWF0ZUZ1bmN0aW9uPFRGdW5jdGlvbiBleHRlbmRzIEdlbmVyaWNGdW5jdGlvbj4ocGFyYW1zOiBDcmVhdGVGdW5jdGlvblBhcmFtczxURnVuY3Rpb24+KTogVEZ1bmN0aW9uO1xuLyoqXG4gKiBDcmVhdGVzIGEgZnVuY3Rpb24gZnJvbSB0aGUgcHJvdmlkZWQgcGFyYW1ldGVycy5cbiAqXG4gKiBAdHlwZVBhcmFtIFRGdW5jdGlvbiAtIFRoZSB0eXBlIG9mIHRoZSBmdW5jdGlvbiB0byBjcmVhdGUuXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIHRvIGNyZWF0ZSB0aGUgZnVuY3Rpb24gd2l0aC5cbiAqIEByZXR1cm5zIEEgZnVuY3Rpb24gY3JlYXRlZCBmcm9tIHRoZSBwcm92aWRlZCBwYXJhbWV0ZXJzLlxuICovXG5leHBvcnQgZnVuY3Rpb24gY3JlYXRlRnVuY3Rpb248VEZ1bmN0aW9uIGV4dGVuZHMgR2VuZXJpY0Z1bmN0aW9uPihcbiAgcGFyYW1zOiBDcmVhdGVGdW5jdGlvbkFyZ3VtZW50bGVzc1BhcmFtcyAmIFBhcnRpYWw8Q3JlYXRlRnVuY3Rpb25QYXJhbXM8VEZ1bmN0aW9uPj5cbik6IFRGdW5jdGlvbiB7XG4gIGNvbnN0IGFyZ3VtZW50TmFtZXMgPSBwYXJhbXMuYXJndW1lbnROYW1lcyA/PyBbXTtcbiAgLy8gZXNsaW50LWRpc2FibGUtbmV4dC1saW5lIG5vLW5ldy1mdW5jLCBAdHlwZXNjcmlwdC1lc2xpbnQvbm8taW1wbGllZC1ldmFsIC0tIE5lZWQgZnVuY3Rpb24gY29uc3RydWN0b3JcbiAgcmV0dXJuIG5ldyBGdW5jdGlvbiguLi5hcmd1bWVudE5hbWVzLCBwYXJhbXMuZnVuY3Rpb25Cb2R5KSBhcyBURnVuY3Rpb247XG59XG5cbi8qKlxuICogTWFrZXMgYSBmdW5jdGlvbiB0aGF0IGNhbGxzIHRoZSBvcmlnaW5hbCBmdW5jdGlvbiB3aXRoIHRoZSBwcm92aWRlZCBhcmd1bWVudHMgYW5kIG9taXRzIHRoZSByZXR1cm4gdmFsdWUuXG4gKlxuICogQHR5cGVQYXJhbSBBcmd1bWVudHMgLSBBcmd1bWVudHMgdG8gYmUgcGFzc2VkIHRvIHRoZSBmdW5jdGlvbi5cbiAqIEBwYXJhbSAkZnVuY3Rpb24gLSBGdW5jdGlvbiB0byBiZSBjYWxsZWQuXG4gKiBAcmV0dXJucyBBIGZ1bmN0aW9uIHRoYXQgY2FsbHMgdGhlIG9yaWdpbmFsIGZ1bmN0aW9uIHdpdGggdGhlIHByb3ZpZGVkIGFyZ3VtZW50cyBhbmQgb21pdHMgdGhlIHJldHVybiB2YWx1ZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIG9taXRSZXR1cm5UeXBlPEFyZ3VtZW50cyBleHRlbmRzIHVua25vd25bXT4oJGZ1bmN0aW9uOiBHZW5lcmljRnVuY3Rpb248QXJndW1lbnRzPik6IEdlbmVyaWNWb2lkRnVuY3Rpb248QXJndW1lbnRzPiB7XG4gIHJldHVybiAoLi4uJGFyZ3VtZW50czogQXJndW1lbnRzKSA9PiB7XG4gICAgJGZ1bmN0aW9uKC4uLiRhcmd1bWVudHMpO1xuICB9O1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7QUFnRU8sU0FBUyw0QkFBNEIsV0FBNkI7QUFDdkUsUUFBTSxpQkFBaUIsVUFBVSxTQUFTO0FBRTFDLE1BQUksdUJBQXVCLEtBQUssY0FBYyxHQUFHO0FBQy9DLFdBQU87QUFBQSxFQUNUO0FBRUEsUUFBTSxhQUFhLGlCQUFpQixLQUFLLGNBQWM7QUFDdkQsU0FBTyxhQUFhLGtCQUFrQixlQUFlLE1BQU0sV0FBVyxDQUFDLEVBQUUsTUFBTSxDQUFDLEtBQUssWUFBWSxjQUFjO0FBQ2pIO0FBS08sU0FBUyxPQUFhO0FBRTdCO0FBTU8sTUFBTSw0QkFBNEIsUUFBUSxRQUFRO0FBT2xELFNBQVMsWUFBMkI7QUFDekMsU0FBTztBQUNUO0FBU08sU0FBUyxvQkFBaUQsV0FBaUY7QUFDaEosU0FBTyxVQUFVLGVBQTBCO0FBQ3pDLFVBQU0sVUFBVSxHQUFHLFVBQVU7QUFBQSxFQUMvQjtBQUNGO0FBUUEsTUFBTSx5QkFBeUI7QUFNL0IsTUFBTSxtQkFBbUI7QUF5QmxCLFNBQVMsY0FBaUQsV0FBaUM7QUFDaEcsU0FBTztBQUVQLFdBQVMsa0JBQXNELFlBQTBEO0FBQ3ZILFdBQU8sVUFBVSxNQUFNLE1BQU0sVUFBVTtBQUFBLEVBQ3pDO0FBQ0Y7QUE4Qk8sU0FBUyxlQUNkLFFBQ1c7QUFDWCxRQUFNLGdCQUFnQixPQUFPLGlCQUFpQixDQUFDO0FBRS9DLFNBQU8sSUFBSSxTQUFTLEdBQUcsZUFBZSxPQUFPLFlBQVk7QUFDM0Q7QUFTTyxTQUFTLGVBQTRDLFdBQXVFO0FBQ2pJLFNBQU8sSUFBSSxlQUEwQjtBQUNuQyxjQUFVLEdBQUcsVUFBVTtBQUFBLEVBQ3pCO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/html-element.d.mts

@@ -0,0 +1,200 @@
+/// <reference path="./library-references.d.mts" />
+/// <reference lib="dom" />
+/**
+ * @file
+ *
+ * Obsidian-runtime-agnostic helpers for working with HTML elements.
+ *
+ * Several helpers here mirror behavior that the Obsidian runtime injects onto the DOM prototypes
+ * (`createEl`/`createDiv`/`createSpan`/`createSvg`/`createFragment`, `Node.prototype.instanceOf`,
+ * `Element.prototype.setText`/`setAttrs`). To stay independent of the Obsidian runtime, that behavior
+ * is reimplemented here in standard DOM, ported from Obsidian's own implementation in
+ * `obsidian.asar/enhance.js`. See the `obsidian-versions` project; revalidate the port when Obsidian
+ * changes `enhance.js` (there is a reminder in `CLAUDE.md`).
+ */
+import type { Promisable } from 'type-fest';
+/**
+ * The element information {@link createElAsync} and its siblings apply: the element-type-agnostic subset of
+ * Obsidian's `DomElementInfo`, declared here so this module needs no Obsidian typings. An Obsidian
+ * `DomElementInfo` value is assignable to it.
+ */
+export interface CreateHtmlElementInfo {
+    /**
+     * The attributes to set; `null` removes the attribute.
+     */
+    readonly attr?: Record<string, boolean | null | number | string>;
+    /**
+     * The CSS class or classes.
+     */
+    readonly cls?: string | string[];
+    /**
+     * The parent to insert the element into.
+     */
+    readonly parent?: Node;
+    /**
+     * Whether to insert the element as the parent's first child instead of its last.
+     */
+    readonly prepend?: boolean;
+    /**
+     * The text content.
+     */
+    readonly text?: DocumentFragment | string;
+    /**
+     * The tooltip text.
+     */
+    readonly title?: string;
+}
+/**
+ * The SVG element information {@link createSvgAsync} applies: the subset of Obsidian's `SvgElementInfo` it
+ * supports, declared here so this module needs no Obsidian typings.
+ */
+export interface CreateSvgElementInfo {
+    /**
+     * The attributes to set; `null` removes the attribute.
+     */
+    readonly attr?: Record<string, boolean | null | number | string>;
+    /**
+     * The CSS class or classes.
+     */
+    readonly cls?: string | string[];
+    /**
+     * The parent to insert the element into.
+     */
+    readonly parent?: Node;
+    /**
+     * Whether to insert the element as the parent's first child instead of its last.
+     */
+    readonly prepend?: boolean;
+}
+/**
+ * A HTML element that can be validated.
+ */
+export interface ValidatorElement extends HTMLElement {
+    /**
+     * Checks the validity of the element.
+     *
+     * @returns `true` if the element is valid, `false` otherwise.
+     */
+    checkValidity: () => boolean;
+    /**
+     * Reports the validity of the element.
+     */
+    reportValidity: () => boolean;
+    /**
+     * Sets a custom error message on the element.
+     *
+     * @param error - The error message to set on the element.
+     */
+    setCustomValidity: (error: string) => void;
+    /**
+     * An error message of the element.
+     */
+    readonly validationMessage: string;
+}
+/**
+ * Creates a div asynchronously.
+ *
+ * @param o - The element information.
+ * @param callback - The callback to call when the div is created.
+ * @returns A {@link Promise} that resolves to the div.
+ */
+export declare function createDivAsync(o?: CreateHtmlElementInfo | string, callback?: (element: HTMLDivElement) => Promisable<void>): Promise<HTMLDivElement>;
+/**
+ * Creates an element asynchronously.
+ *
+ * @typeParam K - The tag name key from `HTMLElementTagNameMap`.
+ * @param tag - The tag name of the element to create.
+ * @param o - The element information.
+ * @param callback - The callback to call when the element is created.
+ * @returns A {@link Promise} that resolves to the element.
+ * @remarks Not refactored to parameter-object pattern, to keep the parity with Obsidian's `createEl` (or createSvg, correspondingly).
+ */
+export declare function createElAsync<K extends keyof HTMLElementTagNameMap>(tag: K, o?: CreateHtmlElementInfo | string, callback?: (element: HTMLElementTagNameMap[K]) => Promisable<void>): Promise<HTMLElementTagNameMap[K]>;
+/**
+ * Creates a DocumentFragment asynchronously.
+ *
+ * @param callback - The callback to call when the DocumentFragment is created.
+ * @returns A {@link Promise} that resolves to the DocumentFragment.
+ */
+export declare function createFragmentAsync(callback?: (element: DocumentFragment) => Promisable<void>): Promise<DocumentFragment>;
+/**
+ * Creates a span asynchronously.
+ *
+ * @param o - The element information.
+ * @param callback - The callback to call when the span is created.
+ * @returns A {@link Promise} that resolves to the span.
+ */
+export declare function createSpanAsync(o?: CreateHtmlElementInfo | string, callback?: (element: HTMLSpanElement) => Promisable<void>): Promise<HTMLSpanElement>;
+/**
+ * Creates a svg asynchronously.
+ *
+ * @typeParam K - The tag name key from `SVGElementTagNameMap`.
+ * @param tag - The tag name of the svg to create.
+ * @param o - The svg information.
+ * @param callback - The callback to call when the svg is created.
+ * @returns A {@link Promise} that resolves to the svg.
+ * @remarks Not refactored to parameter-object pattern, to keep the parity with Obsidian's `createSvg` (or createEl, correspondingly).
+ */
+export declare function createSvgAsync<K extends keyof SVGElementTagNameMap>(tag: K, o?: CreateSvgElementInfo | string, callback?: (element: SVGElementTagNameMap[K]) => Promisable<void>): Promise<SVGElementTagNameMap[K]>;
+/**
+ * Ensures that the given element is loaded.
+ *
+ * @param element - The element to ensure is loaded.
+ * @returns A {@link Promise} that resolves when the element is loaded.
+ */
+export declare function ensureLoaded(element: Element): Promise<void>;
+/**
+ * Gets the window a document belongs to.
+ *
+ * A document is the one node whose `ownerDocument` is `null`, so the `ownerDocument`-chasing lookup
+ * used for ordinary nodes resolves a document to the wrong window. Reading `defaultView` off the
+ * document itself is what keeps a pop-out window's coordinates measured against that window.
+ *
+ * @param doc - The document to get the window of.
+ * @returns The window the document belongs to.
+ * @throws An {@link Error} if the document is detached and therefore has no window.
+ */
+export declare function getDocumentWindow(doc: Document): Window;
+/**
+ * Gets the z-index of the given element.
+ *
+ * @param element - The element to get the z-index of.
+ * @returns The z-index of the element.
+ */
+export declare function getZIndex(element: Element): number;
+/**
+ * Checks if the element is visible in the offset parent.
+ *
+ * @param element - The element to check.
+ * @returns `true` if the element is visible in the offset parent, `false` otherwise.
+ */
+export declare function isElementVisibleInOffsetParent(element: HTMLElement): boolean;
+/**
+ * Checks if the element is loaded.
+ *
+ * @param element - The element to check.
+ * @returns `true` if the element is loaded, `false` otherwise.
+ */
+export declare function isLoaded(element: Element): boolean;
+/**
+ * Adds an event listener to the ancestor nodes of the given node.
+ *
+ * @param node - The node to add the event listener to.
+ * @param callback - The callback to call when the event is triggered.
+ * @returns A {@link Disposable} that removes the event listeners when disposed, for use with `using`.
+ */
+export declare function onAncestorScrollOrResize(node: Node, callback: () => void): Disposable;
+/**
+ * Converts a number to a string with 'px' appended.
+ *
+ * @param value - The number to convert.
+ * @returns The number as a string with 'px' appended.
+ */
+export declare function toPx(value: number): string;
+/**
+ * Waits until the given element is connected to the DOM.
+ *
+ * @param element - The element to check.
+ * @returns A promise that resolves when the element is connected.
+ */
+export declare function waitUntilConnected(element: HTMLElement): Promise<void>;