@mnaoumov/typescript-lib 0.0.0 → 1.0.0

package/dist/lib/esm/beeper.mjs

@@ -0,0 +1,88 @@
+/*
+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'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    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();
+})();
+})();
+
+const BEEP_DURATION_SECONDS = 0.08;
+const BEEP_FREQUENCY_HZ = 660;
+const BEEP_GAIN = 0.05;
+const BEEP_THROTTLE_MILLISECONDS = 200;
+class Beeper {
+  audioContext = null;
+  lastBeepMilliseconds = 0;
+  /**
+   * Plays a short beep. A no-op if called again within {@link BEEP_THROTTLE_MILLISECONDS} of the
+   * previous beep (so a burst of rejected actions does not stack into a buzz), or if the Web Audio API
+   * is unavailable (e.g. the jsdom test environment).
+   */
+  beep() {
+    const nowMilliseconds = Date.now();
+    if (nowMilliseconds - this.lastBeepMilliseconds < BEEP_THROTTLE_MILLISECONDS) {
+      return;
+    }
+    this.lastBeepMilliseconds = nowMilliseconds;
+    const AudioContextClass = window.AudioContext;
+    if (!AudioContextClass) {
+      return;
+    }
+    this.audioContext ??= new AudioContextClass();
+    const audioContext = this.audioContext;
+    const oscillator = audioContext.createOscillator();
+    const gainNode = audioContext.createGain();
+    oscillator.type = "sine";
+    oscillator.frequency.value = BEEP_FREQUENCY_HZ;
+    gainNode.gain.value = BEEP_GAIN;
+    oscillator.connect(gainNode);
+    gainNode.connect(audioContext.destination);
+    oscillator.start();
+    oscillator.stop(audioContext.currentTime + BEEP_DURATION_SECONDS);
+  }
+}
+export {
+  Beeper
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2JlZXBlci50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIEEgc21hbGwgYXVkaWJsZS1mZWVkYmFjayBoZWxwZXIgdGhhdCBwbGF5cyBhIHNob3J0LCB0aHJvdHRsZWQgYmVlcCB2aWEgdGhlIFdlYiBBdWRpbyBBUEkuIFVzZSBpdCB0b1xuICogc2lnbmFsIGEgcmVqZWN0ZWQgb3IgYmxvY2tlZCB1c2VyIGFjdGlvbiBcdTIwMTQgZS5nLiB0eXBpbmcgaW50byBhIGxvY2tlZCBub3RlLCBvciBhdHRlbXB0aW5nIGFuIGFjdGlvblxuICogd2hpbGUgYSBtb2RhbCBpcyBtaW5pbWl6ZWQuXG4gKi9cblxuY29uc3QgQkVFUF9EVVJBVElPTl9TRUNPTkRTID0gMC4wODtcbmNvbnN0IEJFRVBfRlJFUVVFTkNZX0haID0gNjYwO1xuY29uc3QgQkVFUF9HQUlOID0gMC4wNTtcbmNvbnN0IEJFRVBfVEhST1RUTEVfTUlMTElTRUNPTkRTID0gMjAwO1xuXG4vKipcbiAqIFBsYXlzIGEgc2hvcnQsIHRocm90dGxlZCBiZWVwIHRvIHNpZ25hbCBhIHJlamVjdGVkIG9yIGJsb2NrZWQgdXNlciBhY3Rpb24uXG4gKi9cbmV4cG9ydCBjbGFzcyBCZWVwZXIge1xuICBwcml2YXRlIGF1ZGlvQ29udGV4dDogQXVkaW9Db250ZXh0IHwgbnVsbCA9IG51bGw7XG4gIHByaXZhdGUgbGFzdEJlZXBNaWxsaXNlY29uZHMgPSAwO1xuXG4gIC8qKlxuICAgKiBQbGF5cyBhIHNob3J0IGJlZXAuIEEgbm8tb3AgaWYgY2FsbGVkIGFnYWluIHdpdGhpbiB7QGxpbmsgQkVFUF9USFJPVFRMRV9NSUxMSVNFQ09ORFN9IG9mIHRoZVxuICAgKiBwcmV2aW91cyBiZWVwIChzbyBhIGJ1cnN0IG9mIHJlamVjdGVkIGFjdGlvbnMgZG9lcyBub3Qgc3RhY2sgaW50byBhIGJ1enopLCBvciBpZiB0aGUgV2ViIEF1ZGlvIEFQSVxuICAgKiBpcyB1bmF2YWlsYWJsZSAoZS5nLiB0aGUganNkb20gdGVzdCBlbnZpcm9ubWVudCkuXG4gICAqL1xuICBwdWJsaWMgYmVlcCgpOiB2b2lkIHtcbiAgICAvLyBUaHJvdHRsZSBzbyBhIGJ1cnN0IG9mIHJlamVjdGVkIGFjdGlvbnMgZG9lcyBub3Qgc3RhY2sgb3ZlcmxhcHBpbmcgdG9uZXMgaW50byBhIGJ1enouXG4gICAgY29uc3Qgbm93TWlsbGlzZWNvbmRzID0gRGF0ZS5ub3coKTtcbiAgICBpZiAobm93TWlsbGlzZWNvbmRzIC0gdGhpcy5sYXN0QmVlcE1pbGxpc2Vjb25kcyA8IEJFRVBfVEhST1RUTEVfTUlMTElTRUNPTkRTKSB7XG4gICAgICByZXR1cm47XG4gICAgfVxuICAgIHRoaXMubGFzdEJlZXBNaWxsaXNlY29uZHMgPSBub3dNaWxsaXNlY29uZHM7XG5cbiAgICAvLyBgbGliLmRvbWAgdHlwZXMgYEF1ZGlvQ29udGV4dGAgYXMgYWx3YXlzIHByZXNlbnQsIGJ1dCBpdCBpcyBhYnNlbnQgaW4gc29tZSBydW50aW1lc1xuICAgIC8vIChlLmcuIHRoZSBqc2RvbSB0ZXN0IGVudmlyb25tZW50KSwgc28gdGhpcyBndWFyZCBpcyByZWFsLCBub3QgcmVkdW5kYW50LlxuICAgIGNvbnN0IEF1ZGlvQ29udGV4dENsYXNzID0gd2luZG93LkF1ZGlvQ29udGV4dDtcbiAgICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgQHR5cGVzY3JpcHQtZXNsaW50L25vLXVubmVjZXNzYXJ5LWNvbmRpdGlvbiAtLSBzZWUgdGhlIGNvbW1lbnQgYWJvdmUuXG4gICAgaWYgKCFBdWRpb0NvbnRleHRDbGFzcykge1xuICAgICAgcmV0dXJuO1xuICAgIH1cbiAgICB0aGlzLmF1ZGlvQ29udGV4dCA/Pz0gbmV3IEF1ZGlvQ29udGV4dENsYXNzKCk7XG4gICAgY29uc3QgYXVkaW9Db250ZXh0ID0gdGhpcy5hdWRpb0NvbnRleHQ7XG4gICAgY29uc3Qgb3NjaWxsYXRvciA9IGF1ZGlvQ29udGV4dC5jcmVhdGVPc2NpbGxhdG9yKCk7XG4gICAgY29uc3QgZ2Fpbk5vZGUgPSBhdWRpb0NvbnRleHQuY3JlYXRlR2FpbigpO1xuICAgIG9zY2lsbGF0b3IudHlwZSA9ICdzaW5lJztcbiAgICBvc2NpbGxhdG9yLmZyZXF1ZW5jeS52YWx1ZSA9IEJFRVBfRlJFUVVFTkNZX0haO1xuICAgIGdhaW5Ob2RlLmdhaW4udmFsdWUgPSBCRUVQX0dBSU47XG4gICAgb3NjaWxsYXRvci5jb25uZWN0KGdhaW5Ob2RlKTtcbiAgICBnYWluTm9kZS5jb25uZWN0KGF1ZGlvQ29udGV4dC5kZXN0aW5hdGlvbik7XG4gICAgb3NjaWxsYXRvci5zdGFydCgpO1xuICAgIG9zY2lsbGF0b3Iuc3RvcChhdWRpb0NvbnRleHQuY3VycmVudFRpbWUgKyBCRUVQX0RVUkFUSU9OX1NFQ09ORFMpO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBUUEsTUFBTSx3QkFBd0I7QUFDOUIsTUFBTSxvQkFBb0I7QUFDMUIsTUFBTSxZQUFZO0FBQ2xCLE1BQU0sNkJBQTZCO0FBSzVCLE1BQU0sT0FBTztBQUFBLEVBQ1YsZUFBb0M7QUFBQSxFQUNwQyx1QkFBdUI7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsRUFPeEIsT0FBYTtBQUVsQixVQUFNLGtCQUFrQixLQUFLLElBQUk7QUFDakMsUUFBSSxrQkFBa0IsS0FBSyx1QkFBdUIsNEJBQTRCO0FBQzVFO0FBQUEsSUFDRjtBQUNBLFNBQUssdUJBQXVCO0FBSTVCLFVBQU0sb0JBQW9CLE9BQU87QUFFakMsUUFBSSxDQUFDLG1CQUFtQjtBQUN0QjtBQUFBLElBQ0Y7QUFDQSxTQUFLLGlCQUFpQixJQUFJLGtCQUFrQjtBQUM1QyxVQUFNLGVBQWUsS0FBSztBQUMxQixVQUFNLGFBQWEsYUFBYSxpQkFBaUI7QUFDakQsVUFBTSxXQUFXLGFBQWEsV0FBVztBQUN6QyxlQUFXLE9BQU87QUFDbEIsZUFBVyxVQUFVLFFBQVE7QUFDN0IsYUFBUyxLQUFLLFFBQVE7QUFDdEIsZUFBVyxRQUFRLFFBQVE7QUFDM0IsYUFBUyxRQUFRLGFBQWEsV0FBVztBQUN6QyxlQUFXLE1BQU07QUFDakIsZUFBVyxLQUFLLGFBQWEsY0FBYyxxQkFBcUI7QUFBQSxFQUNsRTtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

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

@@ -0,0 +1,59 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * Contains utility functions for Blob objects.
+ */
+/**
+ * Options for {@link blobToJpegArrayBuffer}.
+ */
+export interface BlobToJpegArrayBufferOptions {
+    /**
+     * Whether to carry the source image's metadata segments (EXIF, GPS, XMP, ICC profile) into the
+     * re-encoded JPEG. Only has an effect when the source is a JPEG. Defaults to `false`, which is the
+     * behavior a canvas re-encode has always had.
+     */
+    readonly shouldPreserveMetadata?: boolean | undefined;
+}
+/**
+ * Converts a {@link Blob} object to an {@link ArrayBuffer}.
+ *
+ * @param blob - The Blob object to convert.
+ * @returns A {@link Promise} that resolves to an {@link ArrayBuffer}.
+ */
+export declare function blobToArrayBuffer(blob: Blob): Promise<ArrayBuffer>;
+/**
+ * Converts a {@link Blob} object to a data URL.
+ *
+ * @param blob - The Blob object to convert.
+ * @returns A {@link Promise} that resolves to a data URL.
+ */
+export declare function blobToDataUrl(blob: Blob): Promise<string>;
+/**
+ * Converts a {@link Blob} object to a JPEG ArrayBuffer with the specified quality.
+ *
+ * The conversion is a canvas re-encode, which keeps only the pixels — EXIF, GPS, XMP and the ICC
+ * profile are dropped by construction. Pass {@link BlobToJpegArrayBufferOptions.shouldPreserveMetadata}
+ * to carry those segments across from the source, which works only when the source is itself a JPEG:
+ * nothing else stores them in a form that can be copied verbatim.
+ *
+ * @param blob - The Blob object to convert.
+ * @param jpegQuality - The quality of the JPEG image (0 to 1).
+ * @param options - Conversion options.
+ * @returns A {@link Promise} that resolves to an {@link ArrayBuffer}.
+ */
+export declare function blobToJpegArrayBuffer(blob: Blob, jpegQuality: number, options?: BlobToJpegArrayBufferOptions): Promise<ArrayBuffer>;
+/**
+ * Converts a base64 encoded string to an {@link ArrayBuffer}.
+ *
+ * @param dataUrl - The data URL to convert.
+ * @returns The decoded ArrayBuffer.
+ */
+export declare function dataUrlToArrayBuffer(dataUrl: string): ArrayBuffer;
+/**
+ * Checks if a given file is an image.
+ *
+ * @param file - The file to check.
+ * @returns `true` if the file is an image, `false` otherwise.
+ */
+export declare function isImageFile(file: File): boolean;

package/dist/lib/esm/blob.mjs

@@ -0,0 +1,121 @@
+/*
+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'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    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 {
+  extractJpegMetadataSegments,
+  injectJpegMetadataSegments
+} from "./jpeg-metadata.mjs";
+import { assertNonNullable } from "./type-guards.mjs";
+async function blobToArrayBuffer(blob) {
+  return await blob.arrayBuffer();
+}
+async function blobToDataUrl(blob) {
+  return await new Promise((resolve) => {
+    const reader = new FileReader();
+    reader.addEventListener("loadend", handleLoadEnd);
+    reader.readAsDataURL(blob);
+    function handleLoadEnd() {
+      resolve(reader.result);
+    }
+  });
+}
+async function blobToJpegArrayBuffer(blob, jpegQuality, options) {
+  const sourceSegments = options?.shouldPreserveMetadata ? extractJpegMetadataSegments(new Uint8Array(await blob.arrayBuffer())) : [];
+  const dataUrl = await blobToDataUrl(blob);
+  return new Promise((resolve) => {
+    const image = new Image();
+    image.addEventListener("load", handleLoad);
+    image.src = dataUrl;
+    function handleLoad() {
+      const canvas = document.createElement("canvas");
+      const context = canvas.getContext("2d");
+      assertNonNullable(context, "Could not get 2D context.");
+      const imageWidth = image.width;
+      const imageHeight = image.height;
+      canvas.width = imageWidth;
+      canvas.height = imageHeight;
+      context.fillStyle = "#fff";
+      context.fillRect(0, 0, imageWidth, imageHeight);
+      context.save();
+      const HALF = 0.5;
+      context.translate(imageWidth * HALF, imageHeight * HALF);
+      context.drawImage(image, 0, 0, imageWidth, imageHeight, -imageWidth * HALF, -imageHeight * HALF, imageWidth, imageHeight);
+      context.restore();
+      const jpegDataUrl = canvas.toDataURL("image/jpeg", jpegQuality);
+      const arrayBuffer = dataUrlToArrayBuffer(jpegDataUrl);
+      const withMetadata = injectJpegMetadataSegments(new Uint8Array(arrayBuffer), sourceSegments);
+      resolve(withMetadata.buffer);
+    }
+  });
+}
+function dataUrlToArrayBuffer(dataUrl) {
+  const parts = dataUrl.split(";base64,");
+  const base64 = parts[1];
+  if (!base64) {
+    throw new Error("Invalid data URL");
+  }
+  const raw = atob(base64);
+  const rawLength = raw.length;
+  const uInt8Array = new Uint8Array(rawLength);
+  for (let index = 0; index < rawLength; index++) {
+    uInt8Array[index] = raw.charCodeAt(index);
+  }
+  return uInt8Array.buffer;
+}
+function isImageFile(file) {
+  return file.type.startsWith("image/");
+}
+export {
+  blobToArrayBuffer,
+  blobToDataUrl,
+  blobToJpegArrayBuffer,
+  dataUrlToArrayBuffer,
+  isImageFile
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2Jsb2IudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBDb250YWlucyB1dGlsaXR5IGZ1bmN0aW9ucyBmb3IgQmxvYiBvYmplY3RzLlxuICovXG5cbmltcG9ydCB7XG4gIGV4dHJhY3RKcGVnTWV0YWRhdGFTZWdtZW50cyxcbiAgaW5qZWN0SnBlZ01ldGFkYXRhU2VnbWVudHNcbn0gZnJvbSAnLi9qcGVnLW1ldGFkYXRhLnRzJztcbmltcG9ydCB7IGFzc2VydE5vbk51bGxhYmxlIH0gZnJvbSAnLi90eXBlLWd1YXJkcy50cyc7XG5cbi8qKlxuICogT3B0aW9ucyBmb3Ige0BsaW5rIGJsb2JUb0pwZWdBcnJheUJ1ZmZlcn0uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQmxvYlRvSnBlZ0FycmF5QnVmZmVyT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBXaGV0aGVyIHRvIGNhcnJ5IHRoZSBzb3VyY2UgaW1hZ2UncyBtZXRhZGF0YSBzZWdtZW50cyAoRVhJRiwgR1BTLCBYTVAsIElDQyBwcm9maWxlKSBpbnRvIHRoZVxuICAgKiByZS1lbmNvZGVkIEpQRUcuIE9ubHkgaGFzIGFuIGVmZmVjdCB3aGVuIHRoZSBzb3VyY2UgaXMgYSBKUEVHLiBEZWZhdWx0cyB0byBgZmFsc2VgLCB3aGljaCBpcyB0aGVcbiAgICogYmVoYXZpb3IgYSBjYW52YXMgcmUtZW5jb2RlIGhhcyBhbHdheXMgaGFkLlxuICAgKi9cbiAgcmVhZG9ubHkgc2hvdWxkUHJlc2VydmVNZXRhZGF0YT86IGJvb2xlYW4gfCB1bmRlZmluZWQ7XG59XG5cbi8qKlxuICogQ29udmVydHMgYSB7QGxpbmsgQmxvYn0gb2JqZWN0IHRvIGFuIHtAbGluayBBcnJheUJ1ZmZlcn0uXG4gKlxuICogQHBhcmFtIGJsb2IgLSBUaGUgQmxvYiBvYmplY3QgdG8gY29udmVydC5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgdG8gYW4ge0BsaW5rIEFycmF5QnVmZmVyfS5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGJsb2JUb0FycmF5QnVmZmVyKGJsb2I6IEJsb2IpOiBQcm9taXNlPEFycmF5QnVmZmVyPiB7XG4gIHJldHVybiBhd2FpdCBibG9iLmFycmF5QnVmZmVyKCk7XG59XG5cbi8qKlxuICogQ29udmVydHMgYSB7QGxpbmsgQmxvYn0gb2JqZWN0IHRvIGEgZGF0YSBVUkwuXG4gKlxuICogQHBhcmFtIGJsb2IgLSBUaGUgQmxvYiBvYmplY3QgdG8gY29udmVydC5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgdG8gYSBkYXRhIFVSTC5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGJsb2JUb0RhdGFVcmwoYmxvYjogQmxvYik6IFByb21pc2U8c3RyaW5nPiB7XG4gIHJldHVybiBhd2FpdCBuZXcgUHJvbWlzZSgocmVzb2x2ZSkgPT4ge1xuICAgIGNvbnN0IHJlYWRlciA9IG5ldyBGaWxlUmVhZGVyKCk7XG4gICAgcmVhZGVyLmFkZEV2ZW50TGlzdGVuZXIoJ2xvYWRlbmQnLCBoYW5kbGVMb2FkRW5kKTtcbiAgICByZWFkZXIucmVhZEFzRGF0YVVSTChibG9iKTtcblxuICAgIGZ1bmN0aW9uIGhhbmRsZUxvYWRFbmQoKTogdm9pZCB7XG4gICAgICByZXNvbHZlKHJlYWRlci5yZXN1bHQgYXMgc3RyaW5nKTtcbiAgICB9XG4gIH0pO1xufVxuXG4vKipcbiAqIENvbnZlcnRzIGEge0BsaW5rIEJsb2J9IG9iamVjdCB0byBhIEpQRUcgQXJyYXlCdWZmZXIgd2l0aCB0aGUgc3BlY2lmaWVkIHF1YWxpdHkuXG4gKlxuICogVGhlIGNvbnZlcnNpb24gaXMgYSBjYW52YXMgcmUtZW5jb2RlLCB3aGljaCBrZWVwcyBvbmx5IHRoZSBwaXhlbHMgXHUyMDE0IEVYSUYsIEdQUywgWE1QIGFuZCB0aGUgSUNDXG4gKiBwcm9maWxlIGFyZSBkcm9wcGVkIGJ5IGNvbnN0cnVjdGlvbi4gUGFzcyB7QGxpbmsgQmxvYlRvSnBlZ0FycmF5QnVmZmVyT3B0aW9ucy5zaG91bGRQcmVzZXJ2ZU1ldGFkYXRhfVxuICogdG8gY2FycnkgdGhvc2Ugc2VnbWVudHMgYWNyb3NzIGZyb20gdGhlIHNvdXJjZSwgd2hpY2ggd29ya3Mgb25seSB3aGVuIHRoZSBzb3VyY2UgaXMgaXRzZWxmIGEgSlBFRzpcbiAqIG5vdGhpbmcgZWxzZSBzdG9yZXMgdGhlbSBpbiBhIGZvcm0gdGhhdCBjYW4gYmUgY29waWVkIHZlcmJhdGltLlxuICpcbiAqIEBwYXJhbSBibG9iIC0gVGhlIEJsb2Igb2JqZWN0IHRvIGNvbnZlcnQuXG4gKiBAcGFyYW0ganBlZ1F1YWxpdHkgLSBUaGUgcXVhbGl0eSBvZiB0aGUgSlBFRyBpbWFnZSAoMCB0byAxKS5cbiAqIEBwYXJhbSBvcHRpb25zIC0gQ29udmVyc2lvbiBvcHRpb25zLlxuICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyB0byBhbiB7QGxpbmsgQXJyYXlCdWZmZXJ9LlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gYmxvYlRvSnBlZ0FycmF5QnVmZmVyKGJsb2I6IEJsb2IsIGpwZWdRdWFsaXR5OiBudW1iZXIsIG9wdGlvbnM/OiBCbG9iVG9KcGVnQXJyYXlCdWZmZXJPcHRpb25zKTogUHJvbWlzZTxBcnJheUJ1ZmZlcj4ge1xuICBjb25zdCBzb3VyY2VTZWdtZW50cyA9IG9wdGlvbnM/LnNob3VsZFByZXNlcnZlTWV0YWRhdGFcbiAgICA/IGV4dHJhY3RKcGVnTWV0YWRhdGFTZWdtZW50cyhuZXcgVWludDhBcnJheShhd2FpdCBibG9iLmFycmF5QnVmZmVyKCkpKVxuICAgIDogW107XG4gIGNvbnN0IGRhdGFVcmwgPSBhd2FpdCBibG9iVG9EYXRhVXJsKGJsb2IpO1xuICByZXR1cm4gbmV3IFByb21pc2UoKHJlc29sdmUpID0+IHtcbiAgICBjb25zdCBpbWFnZSA9IG5ldyBJbWFnZSgpO1xuICAgIGltYWdlLmFkZEV2ZW50TGlzdGVuZXIoJ2xvYWQnLCBoYW5kbGVMb2FkKTtcbiAgICBpbWFnZS5zcmMgPSBkYXRhVXJsO1xuXG4gICAgZnVuY3Rpb24gaGFuZGxlTG9hZCgpOiB2b2lkIHtcbiAgICAgIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBvYnNpZGlhbm1kL3ByZWZlci1jcmVhdGUtZWwgLS0gQWdub3N0aWMgbW9kdWxlLlxuICAgICAgY29uc3QgY2FudmFzID0gZG9jdW1lbnQuY3JlYXRlRWxlbWVudCgnY2FudmFzJyk7XG4gICAgICBjb25zdCBjb250ZXh0ID0gY2FudmFzLmdldENvbnRleHQoJzJkJyk7XG4gICAgICBhc3NlcnROb25OdWxsYWJsZShjb250ZXh0LCAnQ291bGQgbm90IGdldCAyRCBjb250ZXh0LicpO1xuICAgICAgY29uc3QgaW1hZ2VXaWR0aCA9IGltYWdlLndpZHRoO1xuICAgICAgY29uc3QgaW1hZ2VIZWlnaHQgPSBpbWFnZS5oZWlnaHQ7XG5cbiAgICAgIGNhbnZhcy53aWR0aCA9IGltYWdlV2lkdGg7XG4gICAgICBjYW52YXMuaGVpZ2h0ID0gaW1hZ2VIZWlnaHQ7XG5cbiAgICAgIGNvbnRleHQuZmlsbFN0eWxlID0gJyNmZmYnO1xuICAgICAgY29udGV4dC5maWxsUmVjdCgwLCAwLCBpbWFnZVdpZHRoLCBpbWFnZUhlaWdodCk7XG4gICAgICBjb250ZXh0LnNhdmUoKTtcblxuICAgICAgY29uc3QgSEFMRiA9IDAuNTtcbiAgICAgIGNvbnRleHQudHJhbnNsYXRlKGltYWdlV2lkdGggKiBIQUxGLCBpbWFnZUhlaWdodCAqIEhBTEYpO1xuICAgICAgY29udGV4dC5kcmF3SW1hZ2UoaW1hZ2UsIDAsIDAsIGltYWdlV2lkdGgsIGltYWdlSGVpZ2h0LCAtaW1hZ2VXaWR0aCAqIEhBTEYsIC1pbWFnZUhlaWdodCAqIEhBTEYsIGltYWdlV2lkdGgsIGltYWdlSGVpZ2h0KTtcbiAgICAgIGNvbnRleHQucmVzdG9yZSgpO1xuXG4gICAgICBjb25zdCBqcGVnRGF0YVVybCA9IGNhbnZhcy50b0RhdGFVUkwoJ2ltYWdlL2pwZWcnLCBqcGVnUXVhbGl0eSk7XG4gICAgICBjb25zdCBhcnJheUJ1ZmZlciA9IGRhdGFVcmxUb0FycmF5QnVmZmVyKGpwZWdEYXRhVXJsKTtcbiAgICAgIGNvbnN0IHdpdGhNZXRhZGF0YSA9IGluamVjdEpwZWdNZXRhZGF0YVNlZ21lbnRzKG5ldyBVaW50OEFycmF5KGFycmF5QnVmZmVyKSwgc291cmNlU2VnbWVudHMpO1xuICAgICAgcmVzb2x2ZSh3aXRoTWV0YWRhdGEuYnVmZmVyIGFzIEFycmF5QnVmZmVyKTtcbiAgICB9XG4gIH0pO1xufVxuXG4vKipcbiAqIENvbnZlcnRzIGEgYmFzZTY0IGVuY29kZWQgc3RyaW5nIHRvIGFuIHtAbGluayBBcnJheUJ1ZmZlcn0uXG4gKlxuICogQHBhcmFtIGRhdGFVcmwgLSBUaGUgZGF0YSBVUkwgdG8gY29udmVydC5cbiAqIEByZXR1cm5zIFRoZSBkZWNvZGVkIEFycmF5QnVmZmVyLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZGF0YVVybFRvQXJyYXlCdWZmZXIoZGF0YVVybDogc3RyaW5nKTogQXJyYXlCdWZmZXIge1xuICBjb25zdCBwYXJ0cyA9IGRhdGFVcmwuc3BsaXQoJztiYXNlNjQsJyk7XG4gIGNvbnN0IGJhc2U2NCA9IHBhcnRzWzFdO1xuICBpZiAoIWJhc2U2NCkge1xuICAgIHRocm93IG5ldyBFcnJvcignSW52YWxpZCBkYXRhIFVSTCcpO1xuICB9XG5cbiAgY29uc3QgcmF3ID0gYXRvYihiYXNlNjQpO1xuICBjb25zdCByYXdMZW5ndGggPSByYXcubGVuZ3RoO1xuXG4gIGNvbnN0IHVJbnQ4QXJyYXkgPSBuZXcgVWludDhBcnJheShyYXdMZW5ndGgpO1xuXG4gIGZvciAobGV0IGluZGV4ID0gMDsgaW5kZXggPCByYXdMZW5ndGg7IGluZGV4KyspIHtcbiAgICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgdW5pY29ybi9wcmVmZXItY29kZS1wb2ludCAtLSBgcmF3YCBpcyBhIGJpbmFyeSBzdHJpbmcsIG9uZSBieXRlIHBlciBjb2RlIHVuaXQuIGBjb2RlUG9pbnRBdGAgd291bGQgY29tYmluZSBhIHN1cnJvZ2F0ZSBwYWlyIGludG8gYSB2YWx1ZSBhYm92ZSAyNTUgYW5kIGNvbnN1bWUgdHdvIHBvc2l0aW9ucywgd2hpY2ggaXMgZXhhY3RseSB0aGUgd3JvbmcgcmVhZGluZyBoZXJlLlxuICAgIHVJbnQ4QXJyYXlbaW5kZXhdID0gcmF3LmNoYXJDb2RlQXQoaW5kZXgpO1xuICB9XG4gIHJldHVybiB1SW50OEFycmF5LmJ1ZmZlcjtcbn1cblxuLyoqXG4gKiBDaGVja3MgaWYgYSBnaXZlbiBmaWxlIGlzIGFuIGltYWdlLlxuICpcbiAqIEBwYXJhbSBmaWxlIC0gVGhlIGZpbGUgdG8gY2hlY2suXG4gKiBAcmV0dXJucyBgdHJ1ZWAgaWYgdGhlIGZpbGUgaXMgYW4gaW1hZ2UsIGBmYWxzZWAgb3RoZXJ3aXNlLlxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNJbWFnZUZpbGUoZmlsZTogRmlsZSk6IGJvb2xlYW4ge1xuICByZXR1cm4gZmlsZS50eXBlLnN0YXJ0c1dpdGgoJ2ltYWdlLycpO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQU1BO0FBQUEsRUFDRTtBQUFBLEVBQ0E7QUFBQSxPQUNLO0FBQ1AsU0FBUyx5QkFBeUI7QUFvQmxDLGVBQXNCLGtCQUFrQixNQUFrQztBQUN4RSxTQUFPLE1BQU0sS0FBSyxZQUFZO0FBQ2hDO0FBUUEsZUFBc0IsY0FBYyxNQUE2QjtBQUMvRCxTQUFPLE1BQU0sSUFBSSxRQUFRLENBQUMsWUFBWTtBQUNwQyxVQUFNLFNBQVMsSUFBSSxXQUFXO0FBQzlCLFdBQU8saUJBQWlCLFdBQVcsYUFBYTtBQUNoRCxXQUFPLGNBQWMsSUFBSTtBQUV6QixhQUFTLGdCQUFzQjtBQUM3QixjQUFRLE9BQU8sTUFBZ0I7QUFBQSxJQUNqQztBQUFBLEVBQ0YsQ0FBQztBQUNIO0FBZUEsZUFBc0Isc0JBQXNCLE1BQVksYUFBcUIsU0FBOEQ7QUFDekksUUFBTSxpQkFBaUIsU0FBUyx5QkFDNUIsNEJBQTRCLElBQUksV0FBVyxNQUFNLEtBQUssWUFBWSxDQUFDLENBQUMsSUFDcEUsQ0FBQztBQUNMLFFBQU0sVUFBVSxNQUFNLGNBQWMsSUFBSTtBQUN4QyxTQUFPLElBQUksUUFBUSxDQUFDLFlBQVk7QUFDOUIsVUFBTSxRQUFRLElBQUksTUFBTTtBQUN4QixVQUFNLGlCQUFpQixRQUFRLFVBQVU7QUFDekMsVUFBTSxNQUFNO0FBRVosYUFBUyxhQUFtQjtBQUUxQixZQUFNLFNBQVMsU0FBUyxjQUFjLFFBQVE7QUFDOUMsWUFBTSxVQUFVLE9BQU8sV0FBVyxJQUFJO0FBQ3RDLHdCQUFrQixTQUFTLDJCQUEyQjtBQUN0RCxZQUFNLGFBQWEsTUFBTTtBQUN6QixZQUFNLGNBQWMsTUFBTTtBQUUxQixhQUFPLFFBQVE7QUFDZixhQUFPLFNBQVM7QUFFaEIsY0FBUSxZQUFZO0FBQ3BCLGNBQVEsU0FBUyxHQUFHLEdBQUcsWUFBWSxXQUFXO0FBQzlDLGNBQVEsS0FBSztBQUViLFlBQU0sT0FBTztBQUNiLGNBQVEsVUFBVSxhQUFhLE1BQU0sY0FBYyxJQUFJO0FBQ3ZELGNBQVEsVUFBVSxPQUFPLEdBQUcsR0FBRyxZQUFZLGFBQWEsQ0FBQyxhQUFhLE1BQU0sQ0FBQyxjQUFjLE1BQU0sWUFBWSxXQUFXO0FBQ3hILGNBQVEsUUFBUTtBQUVoQixZQUFNLGNBQWMsT0FBTyxVQUFVLGNBQWMsV0FBVztBQUM5RCxZQUFNLGNBQWMscUJBQXFCLFdBQVc7QUFDcEQsWUFBTSxlQUFlLDJCQUEyQixJQUFJLFdBQVcsV0FBVyxHQUFHLGNBQWM7QUFDM0YsY0FBUSxhQUFhLE1BQXFCO0FBQUEsSUFDNUM7QUFBQSxFQUNGLENBQUM7QUFDSDtBQVFPLFNBQVMscUJBQXFCLFNBQThCO0FBQ2pFLFFBQU0sUUFBUSxRQUFRLE1BQU0sVUFBVTtBQUN0QyxRQUFNLFNBQVMsTUFBTSxDQUFDO0FBQ3RCLE1BQUksQ0FBQyxRQUFRO0FBQ1gsVUFBTSxJQUFJLE1BQU0sa0JBQWtCO0FBQUEsRUFDcEM7QUFFQSxRQUFNLE1BQU0sS0FBSyxNQUFNO0FBQ3ZCLFFBQU0sWUFBWSxJQUFJO0FBRXRCLFFBQU0sYUFBYSxJQUFJLFdBQVcsU0FBUztBQUUzQyxXQUFTLFFBQVEsR0FBRyxRQUFRLFdBQVcsU0FBUztBQUU5QyxlQUFXLEtBQUssSUFBSSxJQUFJLFdBQVcsS0FBSztBQUFBLEVBQzFDO0FBQ0EsU0FBTyxXQUFXO0FBQ3BCO0FBUU8sU0FBUyxZQUFZLE1BQXFCO0FBQy9DLFNBQU8sS0FBSyxLQUFLLFdBQVcsUUFBUTtBQUN0QzsiLAogICJuYW1lcyI6IFtdCn0K

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

@@ -0,0 +1,17 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * Contains utility functions for byte counts.
+ */
+/**
+ * Renders a byte count the way a file manager does, so a running total answers "is this getting huge?" at
+ * a glance.
+ *
+ * Past the largest unit the number keeps growing rather than starting over, because under-reporting a size
+ * by a factor of 1024 is worse than an ungainly number.
+ *
+ * @param bytes - The number of bytes.
+ * @returns The formatted size, e.g. `1.4 MB`.
+ */
+export declare function formatBytes(bytes: number): string;

package/dist/lib/esm/bytes.mjs

@@ -0,0 +1,76 @@
+/*
+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'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    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();
+})();
+})();
+
+const BYTES_PER_UNIT = 1024;
+const DECIMALS = 1;
+const UNITS = [
+  "B",
+  "KB",
+  "MB",
+  "GB",
+  "TB"
+];
+function formatBytes(bytes) {
+  let size = bytes;
+  let unit = UNITS[0];
+  let isInBytes = true;
+  for (const largerUnit of UNITS.slice(1)) {
+    if (size < BYTES_PER_UNIT) {
+      break;
+    }
+    size /= BYTES_PER_UNIT;
+    unit = largerUnit;
+    isInBytes = false;
+  }
+  return `${isInBytes ? String(size) : size.toFixed(DECIMALS)} ${unit}`;
+}
+export {
+  formatBytes
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2J5dGVzLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29udGFpbnMgdXRpbGl0eSBmdW5jdGlvbnMgZm9yIGJ5dGUgY291bnRzLlxuICovXG5cbmNvbnN0IEJZVEVTX1BFUl9VTklUID0gMTAyNDtcbmNvbnN0IERFQ0lNQUxTID0gMTtcbmNvbnN0IFVOSVRTID0gW1xuICAnQicsXG4gICdLQicsXG4gICdNQicsXG4gICdHQicsXG4gICdUQidcbl0gYXMgY29uc3Q7XG5cbi8qKlxuICogUmVuZGVycyBhIGJ5dGUgY291bnQgdGhlIHdheSBhIGZpbGUgbWFuYWdlciBkb2VzLCBzbyBhIHJ1bm5pbmcgdG90YWwgYW5zd2VycyBcImlzIHRoaXMgZ2V0dGluZyBodWdlP1wiIGF0XG4gKiBhIGdsYW5jZS5cbiAqXG4gKiBQYXN0IHRoZSBsYXJnZXN0IHVuaXQgdGhlIG51bWJlciBrZWVwcyBncm93aW5nIHJhdGhlciB0aGFuIHN0YXJ0aW5nIG92ZXIsIGJlY2F1c2UgdW5kZXItcmVwb3J0aW5nIGEgc2l6ZVxuICogYnkgYSBmYWN0b3Igb2YgMTAyNCBpcyB3b3JzZSB0aGFuIGFuIHVuZ2Fpbmx5IG51bWJlci5cbiAqXG4gKiBAcGFyYW0gYnl0ZXMgLSBUaGUgbnVtYmVyIG9mIGJ5dGVzLlxuICogQHJldHVybnMgVGhlIGZvcm1hdHRlZCBzaXplLCBlLmcuIGAxLjQgTUJgLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZm9ybWF0Qnl0ZXMoYnl0ZXM6IG51bWJlcik6IHN0cmluZyB7XG4gIGxldCBzaXplID0gYnl0ZXM7XG4gIGxldCB1bml0OiBzdHJpbmcgPSBVTklUU1swXTtcbiAgbGV0IGlzSW5CeXRlcyA9IHRydWU7XG5cbiAgZm9yIChjb25zdCBsYXJnZXJVbml0IG9mIFVOSVRTLnNsaWNlKDEpKSB7XG4gICAgaWYgKHNpemUgPCBCWVRFU19QRVJfVU5JVCkge1xuICAgICAgYnJlYWs7XG4gICAgfVxuXG4gICAgc2l6ZSAvPSBCWVRFU19QRVJfVU5JVDtcbiAgICB1bml0ID0gbGFyZ2VyVW5pdDtcbiAgICBpc0luQnl0ZXMgPSBmYWxzZTtcbiAgfVxuXG4gIC8vIFdob2xlIGJ5dGVzIG5ldmVyIHdhbnQgYSBkZWNpbWFsIHBvaW50OiBgODE3IEJgLCBub3QgYDgxNy4wIEJgLlxuICByZXR1cm4gYCR7aXNJbkJ5dGVzID8gU3RyaW5nKHNpemUpIDogc2l6ZS50b0ZpeGVkKERFQ0lNQUxTKX0gJHt1bml0fWA7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBTUEsTUFBTSxpQkFBaUI7QUFDdkIsTUFBTSxXQUFXO0FBQ2pCLE1BQU0sUUFBUTtBQUFBLEVBQ1o7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQ0Y7QUFZTyxTQUFTLFlBQVksT0FBdUI7QUFDakQsTUFBSSxPQUFPO0FBQ1gsTUFBSSxPQUFlLE1BQU0sQ0FBQztBQUMxQixNQUFJLFlBQVk7QUFFaEIsYUFBVyxjQUFjLE1BQU0sTUFBTSxDQUFDLEdBQUc7QUFDdkMsUUFBSSxPQUFPLGdCQUFnQjtBQUN6QjtBQUFBLElBQ0Y7QUFFQSxZQUFRO0FBQ1IsV0FBTztBQUNQLGdCQUFZO0FBQUEsRUFDZDtBQUdBLFNBQU8sR0FBRyxZQUFZLE9BQU8sSUFBSSxJQUFJLEtBQUssUUFBUSxRQUFRLENBQUMsSUFBSSxJQUFJO0FBQ3JFOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/esm/debug-controller.d.mts

@@ -0,0 +1,87 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * Provides the interface for controlling debug output through namespace management.
+ *
+ * Debug namespaces follow the pattern 'lorem', `lorem:ipsum`, `lorem:ipsum:dolor`, etc, and can use wildcards (`*`).
+ *
+ * @example
+ * - `lorem:*` matches all submodules of 'lorem'
+ * - `*:ipsum` matches all plugins' `ipsum` submodules
+ * - `*` matches everything
+ *
+ * Special syntax:
+ * - Namespaces prefixed with '-' are explicitly disabled
+ * - Multiple namespaces can be combined with commas: `lorem,-lorem:ipsum,dolor:*`
+ *
+ * @see {@link https://mnaoumov.dev/obsidian-dev-utils/guides/debugging/}
+ */
+/**
+ * Controls debug output by managing debug namespaces.
+ * Exposed globally as `window.DEBUG`.
+ *
+ * @remarks
+ * Debug settings persist across plugin reloads in localStorage.
+ */
+export interface DebugController {
+    /**
+     * Disable specific debug namespaces. Disabled namespaces take precedence
+     * over enabled ones when there's a conflict.
+     *
+     * @example
+     * ```typescript
+     * window.DEBUG.disable('foo-bar'); // hide all debug messages from the `foo-bar` plugin
+     * window.DEBUG.disable('foo-bar:*'); // hide all debug messages from the `foo-bar` plugin submodules
+     * window.DEBUG.disable(['foo-bar', 'baz-qux']); // disable multiple namespaces
+     * window.DEBUG.disable('foo-bar,baz-qux'); // disable multiple namespaces using comma-separated string
+     * window.DEBUG.disable('*'); // disable all debug messages
+     * ```
+     *
+     * @param namespaces - Single namespace string or array of namespace strings to disable
+     */
+    disable: (namespaces: string | string[]) => void;
+    /**
+     * Enable specific debug namespaces. Note that explicitly disabled
+     * namespaces (prefixed with '-') will remain disabled.
+     *
+     * @example
+     * ```typescript
+     * window.DEBUG.enable('foo-bar'); // show all debug messages from the `foo-bar` plugin
+     * window.DEBUG.enable('foo-bar:obsidian-dev-utils:*'); // show all debug messages from the `obsidian-dev-utils` library within the `foo-bar` plugin
+     * window.DEBUG.enable('foo-bar:*'); // show all debug messages from the `foo-bar` plugin and its submodules
+     * window.DEBUG.enable('*:obsidian-dev-utils:*'); // show all debug messages for the `obsidian-dev-utils` library within any plugin
+     * window.DEBUG.enable(['foo-bar', 'baz-qux']); // enable multiple namespaces
+     * window.DEBUG.enable('foo-bar,baz-qux'); // enable multiple namespaces using comma-separated string
+     * window.DEBUG.enable('*'); // show all debug messages
+     * ```
+     *
+     * @param namespaces - Single namespace string or array of namespace strings to enable
+     */
+    enable: (namespaces: string | string[]) => void;
+    /**
+     * Get currently configured debug namespaces.
+     *
+     * @example
+     * ```typescript
+     * window.DEBUG.get(); // returns ['foo-bar', 'baz-qux:*', '-lorem-ipsum']
+     * ```
+     *
+     * @returns Array of enabled and disabled (prefixed with `-`) debug namespaces
+     */
+    get: () => string[];
+    /**
+     * Set debug namespaces, replacing all previous configurations.
+     *
+     * @example
+     * ```typescript
+     * window.DEBUG.set(['foo-bar', 'baz-qux:*', '-lorem-ipsum']); // Enable 'foo-bar' and 'baz-qux:*', explicitly disable 'lorem-ipsum'
+     * window.DEBUG.set('foo-bar,baz-qux:*,-lorem-ipsum'); // Same thing using comma-separated string
+     * window.DEBUG.set('*'); // Enable all debug messages
+     * window.DEBUG.set(''); // Disable all debug messages
+     * ```
+     *
+     * @param namespaces - String or array of namespace patterns
+     */
+    set: (namespaces: string | string[]) => void;
+}

package/dist/lib/esm/debug-controller.mjs

@@ -0,0 +1,50 @@
+/*
+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'
+  };
+
+  // eslint-disable-next-line obsidianmd/no-global-this, unicorn/no-unnecessary-global-this -- Must stay `globalThis`-qualified: in the emitted banner a bare `process` is a free identifier, so reading it where the host has none throws a ReferenceError instead of yielding `undefined`. That is the very case this function exists to handle.
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+    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();
+})();
+})();
+
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFtdLAogICJzb3VyY2VzQ29udGVudCI6IFtdLAogICJtYXBwaW5ncyI6ICIiLAogICJuYW1lcyI6IFtdCn0K

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

@@ -0,0 +1,66 @@
+/// <reference path="./library.d.mts" />
+/**
+ * @file
+ *
+ * Contains utility functions for debugging.
+ */
+import type { Debugger } from 'debug';
+import type { DebugController } from './debug-controller.mjs';
+/**
+ * Parameters for {@link printWithStackTrace}.
+ */
+export interface PrintWithStackTraceParams {
+    /**
+     * The arguments to print.
+     */
+    readonly $arguments: unknown[];
+    /**
+     * The debugger instance.
+     */
+    readonly debuggerInstance: Debugger;
+    /**
+     * The message to print.
+     */
+    readonly message: string;
+    /**
+     * The stack trace to print.
+     */
+    readonly stackTrace: string;
+}
+/**
+ * Enables the debuggers for the library (under its debug namespace, see `Library.debugNamespace`).
+ */
+export declare function enableLibraryDebuggers(): void;
+/**
+ * Returns a debug controller.
+ *
+ * @returns A debug controller.
+ */
+export declare function getDebugController(): DebugController;
+/**
+ * Returns a debugger instance with a log function that includes the caller's file name and line number.
+ *
+ * @param namespace - The namespace for the debugger instance.
+ * @param framesToSkip - The number of frames to skip in the stack trace.
+ * @returns A debugger instance with a log function that includes the caller's file name and line number.
+ */
+export declare function getDebugger(namespace: string, framesToSkip?: number): Debugger;
+/**
+ * Returns a debugger instance for the library (under its debug namespace, see `Library.debugNamespace`).
+ *
+ * @param namespace - The namespace for the debugger instance.
+ * @returns A debugger instance for the library (under its debug namespace, see `Library.debugNamespace`).
+ */
+export declare function getLibDebugger(namespace: string): Debugger;
+/**
+ * Prints a message with a stack trace.
+ *
+ * @param params - The parameters for printing the message.
+ */
+export declare function printWithStackTrace(params: PrintWithStackTraceParams): void;
+/**
+ * Shows an initial debug message.
+ *
+ * @param pluginId - The plugin ID.
+ */
+export declare function showInitialDebugMessage(pluginId: string): void;