@mnaoumov/typescript-lib 0.0.0 → 1.0.0

package/dist/lib/cjs/typescript-lib-state.d.cts

@@ -0,0 +1,56 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * Provides access to the process-wide shared-state bag of the generic, non-Obsidian part of the library.
+ *
+ * The bag lives on `globalThis` under a `Symbol.for` key, so every copy of this module loaded in one realm shares
+ * it, whichever version it is. It holds what must exist once per realm: the debuggers, the `debug` instance and the
+ * shared abort controller. Obsidian-specific state stays in `obsidian-dev-utils-state.ts`.
+ *
+ * The slot is a cross-version wire format: its key and the {@link TypescriptLibStateSlot} shape only ever change
+ * additively.
+ */
+import { ValueWrapper } from './value-wrapper.cjs';
+/**
+ * The version of the {@link TypescriptLibStateSlot} shape this copy writes.
+ */
+export declare const TYPESCRIPT_LIB_STATE_VERSION = 1;
+/**
+ * The key of the global slot holding the {@link TypescriptLibStateSlot}.
+ */
+export declare const TYPESCRIPT_LIB_STATE_KEY: unique symbol;
+/**
+ * The shared-state slot stored on `globalThis`.
+ */
+export interface TypescriptLibStateSlot {
+    /**
+     * The shared values, each in a {@link ValueWrapper} so a holder can replace the value in place.
+     */
+    readonly values: Record<string, ValueWrapper>;
+    /**
+     * The version of the slot shape the creator wrote. Informational: the shape only changes additively.
+     */
+    readonly version: number;
+}
+/**
+ * Retrieves or creates a shared-state {@link ValueWrapper} for a given key.
+ *
+ * @typeParam T - The type of the shared state value.
+ * @param key - The key to store or retrieve the shared state under.
+ * @param defaultValue - The default value to use if the shared state does not exist yet.
+ * @returns The {@link ValueWrapper} that stores the shared state.
+ */
+export declare function getTypescriptLibState<T>(key: string, defaultValue: T): ValueWrapper<T>;
+/**
+ * Retrieves or creates the shared-state slot.
+ *
+ * @returns The {@link TypescriptLibStateSlot}.
+ */
+export declare function getTypescriptLibStateSlot(): TypescriptLibStateSlot;
+/**
+ * Clears the shared-state bag.
+ *
+ * Intended for test isolation: call it before each test so accumulated state does not leak between tests.
+ */
+export declare function resetTypescriptLibState(): void;

package/dist/lib/cjs/url.cjs

@@ -0,0 +1,136 @@
+/*
+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 keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var url_exports = {};
+__export(url_exports, {
+  encodeUrl: () => encodeUrl,
+  isFileUrl: () => isFileUrl,
+  isUrl: () => isUrl,
+  normalizeFileUrl: () => normalizeFileUrl,
+  pathToFileUrl: () => pathToFileUrl
+});
+module.exports = __toCommonJS(url_exports);
+var import_string = require('./string.cjs');
+const SCHEME_REG_EXP = /^[A-Za-z][A-Za-z0-9+\-.]*:\S+$/;
+const FILE_SCHEME_REG_EXP = /^file:/i;
+const LEADING_SLASHES_REG_EXP = /^\/+/;
+const SPECIAL_URL_SYMBOLS_REG_EXP = /[\\\x00\x08\x0B\x0C\x0E-\x1F ]/g;
+const SPECIAL_URL_SYMBOLS_WITH_PERCENT_REG_EXP = /[%\\\x00\x08\x0B\x0C\x0E-\x1F ]/g;
+function encodeUrl(url, shouldEncodePercent) {
+  return (0, import_string.replaceAll)({
+    $string: url,
+    replacer: ({ substring: specialUrlSymbol }) => encodeURIComponent(specialUrlSymbol),
+    searchValue: shouldEncodePercent ? SPECIAL_URL_SYMBOLS_WITH_PERCENT_REG_EXP : SPECIAL_URL_SYMBOLS_REG_EXP
+  });
+}
+function isFileUrl($string) {
+  return FILE_SCHEME_REG_EXP.test($string);
+}
+function isUrl($string) {
+  if (/\s/.test($string)) {
+    return false;
+  }
+  if ($string.includes("://")) {
+    try {
+      new URL($string);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  return SCHEME_REG_EXP.test($string);
+}
+function normalizeFileUrl(url) {
+  return isFileUrl(url) ? url.replaceAll("\\", "/") : url;
+}
+function pathToFileUrl(path, shouldEncodePercent) {
+  const encodedPath = encodeUrl(path, shouldEncodePercent).replaceAll("%5C", "/");
+  return `file:///${encodedPath.replace(LEADING_SLASHES_REG_EXP, "")}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  encodeUrl,
+  isFileUrl,
+  isUrl,
+  normalizeFileUrl,
+  pathToFileUrl
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3VybC50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbnRhaW5zIHV0aWxpdHkgZnVuY3Rpb25zIGZvciB2YWxpZGF0aW5nLCBlbmNvZGluZyBhbmQgbm9ybWFsaXppbmcgVVJMcy5cbiAqL1xuXG5pbXBvcnQgeyByZXBsYWNlQWxsIH0gZnJvbSAnLi9zdHJpbmcudHMnO1xuXG5jb25zdCBTQ0hFTUVfUkVHX0VYUCA9IC9eW0EtWmEtel1bQS1aYS16MC05K1xcLS5dKjpcXFMrJC87XG5cbmNvbnN0IEZJTEVfU0NIRU1FX1JFR19FWFAgPSAvXmZpbGU6L2k7XG5cbmNvbnN0IExFQURJTkdfU0xBU0hFU19SRUdfRVhQID0gL15cXC8rLztcblxuLyoqXG4gKiBSZWd1bGFyIGV4cHJlc3Npb24gZm9yIHRoZSBzeW1ib2xzIHRoYXQgaGF2ZSB0byBiZSBwZXJjZW50LWVuY29kZWQgaW4gYSBVUkwuXG4gKi9cbi8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBuby1jb250cm9sLXJlZ2V4LCB1bmljb3JuL3ByZWZlci11bmljb2RlLWNvZGUtcG9pbnQtZXNjYXBlcyAtLSBUaGUgcmVndWxhciBleHByZXNzaW9uIGlzIHdyaXR0ZW4gdG8gY2FwdHVyZSBjb250cm9sIGNoYXJhY3RlcnMsIHdoaWNoIGFyZSBjb252ZW50aW9uYWxseSBzcGVsbGVkIGFzIGBcXHhgIGVzY2FwZXM7IGBcXHV7MH1gLXN0eWxlIGVzY2FwZXMgd291bGQgb2JzY3VyZSB0aGUgYFxceDBFLVxceDFGYCByYW5nZSB3aXRob3V0IGV4cHJlc3NpbmcgYW55dGhpbmcgdGhlIHR3by1kaWdpdCBmb3JtIGNhbm5vdC5cbmNvbnN0IFNQRUNJQUxfVVJMX1NZTUJPTFNfUkVHX0VYUCA9IC9bXFxcXFxceDAwXFx4MDhcXHgwQlxceDBDXFx4MEUtXFx4MUYgXS9nO1xuXG4vKipcbiAqIFNhbWUgYXMge0BsaW5rIFNQRUNJQUxfVVJMX1NZTUJPTFNfUkVHX0VYUH0sIGJ1dCBhZGRpdGlvbmFsbHkgbWF0Y2hlcyBhIGxpdGVyYWwgYCVgLlxuICovXG4vLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgbm8tY29udHJvbC1yZWdleCwgdW5pY29ybi9wcmVmZXItdW5pY29kZS1jb2RlLXBvaW50LWVzY2FwZXMgLS0gVGhlIHJlZ3VsYXIgZXhwcmVzc2lvbiBpcyB3cml0dGVuIHRvIGNhcHR1cmUgY29udHJvbCBjaGFyYWN0ZXJzLCB3aGljaCBhcmUgY29udmVudGlvbmFsbHkgc3BlbGxlZCBhcyBgXFx4YCBlc2NhcGVzOyBgXFx1ezB9YC1zdHlsZSBlc2NhcGVzIHdvdWxkIG9ic2N1cmUgdGhlIGBcXHgwRS1cXHgxRmAgcmFuZ2Ugd2l0aG91dCBleHByZXNzaW5nIGFueXRoaW5nIHRoZSB0d28tZGlnaXQgZm9ybSBjYW5ub3QuXG5jb25zdCBTUEVDSUFMX1VSTF9TWU1CT0xTX1dJVEhfUEVSQ0VOVF9SRUdfRVhQID0gL1slXFxcXFxceDAwXFx4MDhcXHgwQlxceDBDXFx4MEUtXFx4MUYgXS9nO1xuXG4vKipcbiAqIFBlcmNlbnQtZW5jb2RlcyB0aGUgc3ltYm9scyB0aGF0IGJyZWFrIGEgVVJMOiBiYWNrc2xhc2hlcywgc3BhY2VzIGFuZCB0aGUgY29udHJvbCBjaGFyYWN0ZXJzLiBFdmVyeVxuICogb3RoZXIgY2hhcmFjdGVyIFx1MjAxNCBpbmNsdWRpbmcgbm9uLUFTQ0lJIG9uZXMgYW5kIGEgbGl0ZXJhbCBgJWAgXHUyMDE0IGlzIGxlZnQgYXMgaXMsIHNvIHRoZSByZXN1bHQgc3RheXNcbiAqIHJlYWRhYmxlLlxuICpcbiAqIEEgbGl0ZXJhbCBgJWAgaXMgb25seSBlbmNvZGVkIHdoZW4gYHNob3VsZEVuY29kZVBlcmNlbnRgIGlzIHNldC4gTGVhdmluZyBpdCBhbG9uZSBpcyB0aGUgZGVmYXVsdFxuICogYmVjYXVzZSBpdCBrZWVwcyB0aGUgZW5jb2RpbmcgaWRlbXBvdGVudCBmb3IgYWxyZWFkeS1lbmNvZGVkIGlucHV0OyB0aGUgY29zdCBpcyB0aGF0IGEgcGF0aCB3aGljaFxuICogZ2VudWluZWx5IGNvbnRhaW5zIGAlYCAoYSBmb2xkZXIgYWN0dWFsbHkgbmFtZWQgYGElMjBiYCkgZGVjb2RlcyBiYWNrIHRvIHNvbWV0aGluZyBlbHNlLiBUdXJuIHRoZSBmbGFnXG4gKiBvbiB3aGVuZXZlciB0aGUgaW5wdXQgaXMgYSByYXcgZmlsZXN5c3RlbSBwYXRoIHRoYXQgbWF5IGNvbnRhaW4gYCVgLlxuICpcbiAqIEBwYXJhbSB1cmwgLSBUaGUgVVJMIHRvIGVuY29kZS5cbiAqIEBwYXJhbSBzaG91bGRFbmNvZGVQZXJjZW50IC0gV2hldGhlciB0byBlbmNvZGUgYSBsaXRlcmFsIGAlYCBhcyBgJTI1YC4gRGVmYXVsdHMgdG8gYGZhbHNlYC5cbiAqIEByZXR1cm5zIFRoZSBlbmNvZGVkIFVSTC5cbiAqXG4gKiBAZXhhbXBsZVxuICogYGBgdHNcbiAqIGVuY29kZVVybChTdHJpbmcucmF3YHBhdGhcXHRvIHRoZVxcZmlsZS5tZGApIC8vICdwYXRoJTVDdG8lMjB0aGUlNUNmaWxlLm1kJ1xuICogZW5jb2RlVXJsKCdhJTIwYicpIC8vICdhJTIwYidcbiAqIGVuY29kZVVybCgnYSUyMGInLCB0cnVlKSAvLyAnYSUyNTIwYidcbiAqIGBgYFxuICovXG5leHBvcnQgZnVuY3Rpb24gZW5jb2RlVXJsKHVybDogc3RyaW5nLCBzaG91bGRFbmNvZGVQZXJjZW50PzogYm9vbGVhbik6IHN0cmluZyB7XG4gIHJldHVybiByZXBsYWNlQWxsKHtcbiAgICAkc3RyaW5nOiB1cmwsXG4gICAgcmVwbGFjZXI6ICh7IHN1YnN0cmluZzogc3BlY2lhbFVybFN5bWJvbCB9KSA9PiBlbmNvZGVVUklDb21wb25lbnQoc3BlY2lhbFVybFN5bWJvbCksXG4gICAgc2VhcmNoVmFsdWU6IHNob3VsZEVuY29kZVBlcmNlbnQgPyBTUEVDSUFMX1VSTF9TWU1CT0xTX1dJVEhfUEVSQ0VOVF9SRUdfRVhQIDogU1BFQ0lBTF9VUkxfU1lNQk9MU19SRUdfRVhQXG4gIH0pO1xufVxuXG4vKipcbiAqIERldGVybWluZXMgd2hldGhlciBhIGdpdmVuIHN0cmluZyBpcyBhIGBmaWxlOi8vYCBVUkwuXG4gKlxuICogQHBhcmFtICRzdHJpbmcgLSBUaGUgc3RyaW5nIHRvIGNoZWNrLlxuICogQHJldHVybnMgYHRydWVgIGlmIHRoZSBzdHJpbmcgdXNlcyB0aGUgYGZpbGU6YCBzY2hlbWUsIG90aGVyd2lzZSBgZmFsc2VgLlxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNGaWxlVXJsKCRzdHJpbmc6IHN0cmluZyk6IGJvb2xlYW4ge1xuICByZXR1cm4gRklMRV9TQ0hFTUVfUkVHX0VYUC50ZXN0KCRzdHJpbmcpO1xufVxuXG4vKipcbiAqIERldGVybWluZXMgd2hldGhlciBhIGdpdmVuIHN0cmluZyBpcyBhIHZhbGlkIFVSTFxuICpcbiAqIEBwYXJhbSAkc3RyaW5nIC0gVGhlIHN0cmluZyB0byB2YWxpZGF0ZSBhcyBhIFVSTC5cbiAqIEByZXR1cm5zIGB0cnVlYCBpZiB0aGUgc3RyaW5nIGlzIGEgdmFsaWQgVVJMLCBvdGhlcndpc2UgYGZhbHNlYC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzVXJsKCRzdHJpbmc6IHN0cmluZyk6IGJvb2xlYW4ge1xuICBpZiAoL1xccy8udGVzdCgkc3RyaW5nKSkge1xuICAgIHJldHVybiBmYWxzZTtcbiAgfVxuICBpZiAoJHN0cmluZy5pbmNsdWRlcygnOi8vJykpIHtcbiAgICB0cnkge1xuICAgICAgbmV3IFVSTCgkc3RyaW5nKTtcbiAgICAgIHJldHVybiB0cnVlO1xuICAgIH0gY2F0Y2gge1xuICAgICAgcmV0dXJuIGZhbHNlO1xuICAgIH1cbiAgfVxuXG4gIHJldHVybiBTQ0hFTUVfUkVHX0VYUC50ZXN0KCRzdHJpbmcpO1xufVxuXG4vKipcbiAqIE5vcm1hbGl6ZXMgYSBgZmlsZTovL2AgVVJMIHRvIGEgcHJldHR5IGZvcm0gYnkgY29udmVydGluZyBiYWNrc2xhc2hlcyB0byBmb3J3YXJkIHNsYXNoZXMuIFRoZSBVUkwgaXNcbiAqIGV4cGVjdGVkIHRvIGFscmVhZHkgYmUgZGVjb2RlZC4gTm9uLWBmaWxlOi8vYCBVUkxzIGFyZSByZXR1cm5lZCB1bmNoYW5nZWQuXG4gKlxuICogQHBhcmFtIHVybCAtIFRoZSBVUkwgdG8gbm9ybWFsaXplLlxuICogQHJldHVybnMgVGhlIG5vcm1hbGl6ZWQgVVJMLlxuICovXG5leHBvcnQgZnVuY3Rpb24gbm9ybWFsaXplRmlsZVVybCh1cmw6IHN0cmluZyk6IHN0cmluZyB7XG4gIHJldHVybiBpc0ZpbGVVcmwodXJsKSA/IHVybC5yZXBsYWNlQWxsKCdcXFxcJywgJy8nKSA6IHVybDtcbn1cblxuLyoqXG4gKiBDb252ZXJ0cyBhIGZpbGVzeXN0ZW0gcGF0aCBpbnRvIGEgYGZpbGU6Ly8vYCBVUkwsIHBlcmNlbnQtZW5jb2RpbmcgaXQgd2l0aCB7QGxpbmsgZW5jb2RlVXJsfS5cbiAqXG4gKiBUaGUgYmFja3NsYXNoZXMgYXJlIHR1cm5lZCBpbnRvIGZvcndhcmQgc2xhc2hlcyAqKmFmdGVyKiogdGhlIGVuY29kaW5nLCBub3QgYmVmb3JlIFx1MjAxNCBhIFdpbmRvd3MgcGF0aCBpc1xuICogZW5jb2RlZCB0byBgJTVDYCBmaXJzdCBhbmQgb25seSB0aGVuIHJld3JpdHRlbiB0byBgL2AsIHdoaWNoIGlzIHdoYXQgbWFrZXMgYEM6XFxhIGJcXGNgIHByb2R1Y2UgdGhlXG4gKiB3b3JraW5nIGBmaWxlOi8vL0M6L2ElMjBiL2NgIHJhdGhlciB0aGFuIGEgbGluayBicm9rZW4gYXQgdGhlIGZpcnN0IHNwYWNlLlxuICpcbiAqIFRoZSBgZmlsZTovLy9gIHByZWZpeCBhbHdheXMgZW5kcyB1cCB3aXRoIGV4YWN0bHkgdGhyZWUgc2xhc2hlczogYW55IGxlYWRpbmcgc2xhc2hlcyB0aGUgcGF0aCBhbHJlYWR5XG4gKiBoYXMgYXJlIGRyb3BwZWQgZmlyc3QsIGJlY2F1c2UgYGZpbGU6Ly8vL2hvbWUveGAgcGFyc2VzIGFzIHRoZSBwYXRoIGAvL2hvbWUveGAsIG5vdCBgL2hvbWUveGAuIEFcbiAqIFdpbmRvd3MgVU5DIHBhdGggKGBcXFxcc2VydmVyXFxzaGFyZWApIGlzIHRoZXJlZm9yZSByZW5kZXJlZCBhcyBgZmlsZTovLy9zZXJ2ZXIvc2hhcmVgIHJhdGhlciB0aGFuIHRoZVxuICogY2Fub25pY2FsIGhvc3QgZm9ybSBgZmlsZTovL3NlcnZlci9zaGFyZWAsIHdoaWNoIHRoaXMgZnVuY3Rpb24gZGVsaWJlcmF0ZWx5IGRvZXMgbm90IHByb2R1Y2UuXG4gKlxuICogQHBhcmFtIHBhdGggLSBUaGUgZmlsZXN5c3RlbSBwYXRoIHRvIGNvbnZlcnQuXG4gKiBAcGFyYW0gc2hvdWxkRW5jb2RlUGVyY2VudCAtIFdoZXRoZXIgdG8gZW5jb2RlIGEgbGl0ZXJhbCBgJWAgaW4gdGhlIHBhdGggYXMgYCUyNWAuIERlZmF1bHRzIHRvIGBmYWxzZWAuXG4gKiAgIFNlZSB7QGxpbmsgZW5jb2RlVXJsfSBmb3IgdGhlIHRyYWRlLW9mZi5cbiAqIEByZXR1cm5zIFRoZSBgZmlsZTovLy9gIFVSTC5cbiAqXG4gKiBAZXhhbXBsZVxuICogYGBgdHNcbiAqIHBhdGhUb0ZpbGVVcmwoU3RyaW5nLnJhd2BDOlxcYSBiXFxjLnR4dGApIC8vICdmaWxlOi8vL0M6L2ElMjBiL2MudHh0J1xuICogcGF0aFRvRmlsZVVybCgnL2hvbWUvdXNlci9hIGIudHh0JykgLy8gJ2ZpbGU6Ly8vaG9tZS91c2VyL2ElMjBiLnR4dCdcbiAqIGBgYFxuICovXG5leHBvcnQgZnVuY3Rpb24gcGF0aFRvRmlsZVVybChwYXRoOiBzdHJpbmcsIHNob3VsZEVuY29kZVBlcmNlbnQ/OiBib29sZWFuKTogc3RyaW5nIHtcbiAgY29uc3QgZW5jb2RlZFBhdGggPSBlbmNvZGVVcmwocGF0aCwgc2hvdWxkRW5jb2RlUGVyY2VudCkucmVwbGFjZUFsbCgnJTVDJywgJy8nKTtcbiAgcmV0dXJuIGBmaWxlOi8vLyR7ZW5jb2RlZFBhdGgucmVwbGFjZShMRUFESU5HX1NMQVNIRVNfUkVHX0VYUCwgJycpfWA7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFNQSxvQkFBMkI7QUFFM0IsTUFBTSxpQkFBaUI7QUFFdkIsTUFBTSxzQkFBc0I7QUFFNUIsTUFBTSwwQkFBMEI7QUFNaEMsTUFBTSw4QkFBOEI7QUFNcEMsTUFBTSwyQ0FBMkM7QUF1QjFDLFNBQVMsVUFBVSxLQUFhLHFCQUF1QztBQUM1RSxhQUFPLDBCQUFXO0FBQUEsSUFDaEIsU0FBUztBQUFBLElBQ1QsVUFBVSxDQUFDLEVBQUUsV0FBVyxpQkFBaUIsTUFBTSxtQkFBbUIsZ0JBQWdCO0FBQUEsSUFDbEYsYUFBYSxzQkFBc0IsMkNBQTJDO0FBQUEsRUFDaEYsQ0FBQztBQUNIO0FBUU8sU0FBUyxVQUFVLFNBQTBCO0FBQ2xELFNBQU8sb0JBQW9CLEtBQUssT0FBTztBQUN6QztBQVFPLFNBQVMsTUFBTSxTQUEwQjtBQUM5QyxNQUFJLEtBQUssS0FBSyxPQUFPLEdBQUc7QUFDdEIsV0FBTztBQUFBLEVBQ1Q7QUFDQSxNQUFJLFFBQVEsU0FBUyxLQUFLLEdBQUc7QUFDM0IsUUFBSTtBQUNGLFVBQUksSUFBSSxPQUFPO0FBQ2YsYUFBTztBQUFBLElBQ1QsUUFBUTtBQUNOLGFBQU87QUFBQSxJQUNUO0FBQUEsRUFDRjtBQUVBLFNBQU8sZUFBZSxLQUFLLE9BQU87QUFDcEM7QUFTTyxTQUFTLGlCQUFpQixLQUFxQjtBQUNwRCxTQUFPLFVBQVUsR0FBRyxJQUFJLElBQUksV0FBVyxNQUFNLEdBQUcsSUFBSTtBQUN0RDtBQXlCTyxTQUFTLGNBQWMsTUFBYyxxQkFBdUM7QUFDakYsUUFBTSxjQUFjLFVBQVUsTUFBTSxtQkFBbUIsRUFBRSxXQUFXLE9BQU8sR0FBRztBQUM5RSxTQUFPLFdBQVcsWUFBWSxRQUFRLHlCQUF5QixFQUFFLENBQUM7QUFDcEU7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/cjs/url.d.cts

@@ -0,0 +1,74 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * Contains utility functions for validating, encoding and normalizing URLs.
+ */
+/**
+ * Percent-encodes the symbols that break a URL: backslashes, spaces and the control characters. Every
+ * other character — including non-ASCII ones and a literal `%` — is left as is, so the result stays
+ * readable.
+ *
+ * A literal `%` is only encoded when `shouldEncodePercent` is set. Leaving it alone is the default
+ * because it keeps the encoding idempotent for already-encoded input; the cost is that a path which
+ * genuinely contains `%` (a folder actually named `a%20b`) decodes back to something else. Turn the flag
+ * on whenever the input is a raw filesystem path that may contain `%`.
+ *
+ * @param url - The URL to encode.
+ * @param shouldEncodePercent - Whether to encode a literal `%` as `%25`. Defaults to `false`.
+ * @returns The encoded URL.
+ *
+ * @example
+ * ```ts
+ * encodeUrl(String.raw`path\to the\file.md`) // 'path%5Cto%20the%5Cfile.md'
+ * encodeUrl('a%20b') // 'a%20b'
+ * encodeUrl('a%20b', true) // 'a%2520b'
+ * ```
+ */
+export declare function encodeUrl(url: string, shouldEncodePercent?: boolean): string;
+/**
+ * Determines whether a given string is a `file://` URL.
+ *
+ * @param $string - The string to check.
+ * @returns `true` if the string uses the `file:` scheme, otherwise `false`.
+ */
+export declare function isFileUrl($string: string): boolean;
+/**
+ * Determines whether a given string is a valid URL
+ *
+ * @param $string - The string to validate as a URL.
+ * @returns `true` if the string is a valid URL, otherwise `false`.
+ */
+export declare function isUrl($string: string): boolean;
+/**
+ * Normalizes a `file://` URL to a pretty form by converting backslashes to forward slashes. The URL is
+ * expected to already be decoded. Non-`file://` URLs are returned unchanged.
+ *
+ * @param url - The URL to normalize.
+ * @returns The normalized URL.
+ */
+export declare function normalizeFileUrl(url: string): string;
+/**
+ * Converts a filesystem path into a `file:///` URL, percent-encoding it with {@link encodeUrl}.
+ *
+ * The backslashes are turned into forward slashes **after** the encoding, not before — a Windows path is
+ * encoded to `%5C` first and only then rewritten to `/`, which is what makes `C:\a b\c` produce the
+ * working `file:///C:/a%20b/c` rather than a link broken at the first space.
+ *
+ * The `file:///` prefix always ends up with exactly three slashes: any leading slashes the path already
+ * has are dropped first, because `file:////home/x` parses as the path `//home/x`, not `/home/x`. A
+ * Windows UNC path (`\\server\share`) is therefore rendered as `file:///server/share` rather than the
+ * canonical host form `file://server/share`, which this function deliberately does not produce.
+ *
+ * @param path - The filesystem path to convert.
+ * @param shouldEncodePercent - Whether to encode a literal `%` in the path as `%25`. Defaults to `false`.
+ *   See {@link encodeUrl} for the trade-off.
+ * @returns The `file:///` URL.
+ *
+ * @example
+ * ```ts
+ * pathToFileUrl(String.raw`C:\a b\c.txt`) // 'file:///C:/a%20b/c.txt'
+ * pathToFileUrl('/home/user/a b.txt') // 'file:///home/user/a%20b.txt'
+ * ```
+ */
+export declare function pathToFileUrl(path: string, shouldEncodePercent?: boolean): string;

package/dist/lib/cjs/value-provider.cjs

@@ -0,0 +1,100 @@
+/*
+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 keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var value_provider_exports = {};
+__export(value_provider_exports, {
+  resolveValue: () => resolveValue
+});
+module.exports = __toCommonJS(value_provider_exports);
+var import_abort_controller = require('./abort-controller.cjs');
+async function resolveValue(provider, $arguments) {
+  const fullArguments = { ...$arguments, abortSignal: $arguments.abortSignal ?? (0, import_abort_controller.abortSignalNever)() };
+  fullArguments.abortSignal.throwIfAborted();
+  return isFunction(provider) ? await provider(fullArguments) : provider;
+}
+function isFunction(value) {
+  return typeof value === "function";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  resolveValue
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3ZhbHVlLXByb3ZpZGVyLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29udGFpbnMgdXRpbGl0eSB0eXBlcyBhbmQgZnVuY3Rpb25zIGZvciBoYW5kbGluZyB2YWx1ZSBwcm92aWRlcnMsIHdoaWNoIGNhbiBiZSBlaXRoZXIgZGlyZWN0IHZhbHVlcyBvciBmdW5jdGlvbnMgdGhhdCByZXR1cm4gdmFsdWVzLlxuICovXG5cbmltcG9ydCB0eXBlIHsgUHJvbWlzYWJsZSB9IGZyb20gJ3R5cGUtZmVzdCc7XG5cbmltcG9ydCB7IGFib3J0U2lnbmFsTmV2ZXIgfSBmcm9tICcuL2Fib3J0LWNvbnRyb2xsZXIudHMnO1xuXG4vKipcbiAqIFZhbHVlIHByb3ZpZGVyIHRoYXQgY2FuIGVpdGhlciBiZSBhIGRpcmVjdCB2YWx1ZSBvZiB0eXBlIHtAbGluayBWYWx1ZX0gb3IgYSBmdW5jdGlvbiB0aGF0IHJldHVybnMgYSB2YWx1ZSBvZiB0eXBlIHtAbGluayBWYWx1ZX0uXG4gKlxuICogQHR5cGVQYXJhbSBWYWx1ZSAtIFRoZSB0eXBlIG9mIHRoZSB2YWx1ZSBwcm92aWRlZC5cbiAqIEB0eXBlUGFyYW0gQXJndW1lbnRzIC0gVGhlIHR5cGVzIG9mIGFyZ3VtZW50cyBwYXNzZWQgdG8gdGhlIGZ1bmN0aW9uIGlmIHRoZSBwcm92aWRlciBpcyBhIGZ1bmN0aW9uLlxuICovXG5leHBvcnQgdHlwZSBWYWx1ZVByb3ZpZGVyPFZhbHVlLCBBcmd1bWVudHMgZXh0ZW5kcyBvYmplY3QgPSBvYmplY3Q+ID0gKCgkYXJndW1lbnRzOiBBcmd1bWVudHMgJiBDb21tb25Bcmd1bWVudHMpID0+IFByb21pc2FibGU8VmFsdWU+KSB8IFZhbHVlO1xuXG5pbnRlcmZhY2UgQ29tbW9uQXJndW1lbnRzIHtcbiAgYWJvcnRTaWduYWw6IEFib3J0U2lnbmFsO1xufVxuXG4vKipcbiAqIFJlc29sdmVzIGEgdmFsdWUgZnJvbSBhIHZhbHVlIHByb3ZpZGVyLCB3aGljaCBjYW4gYmUgZWl0aGVyIGEgZGlyZWN0IHZhbHVlIG9yIGEgZnVuY3Rpb24gdGhhdCByZXR1cm5zIGEgdmFsdWUuXG4gKlxuICogQHR5cGVQYXJhbSBBcmd1bWVudHMgLSBUaGUgdHlwZXMgb2YgYXJndW1lbnRzIHBhc3NlZCB0byB0aGUgZnVuY3Rpb24gaWYgdGhlIHByb3ZpZGVyIGlzIGEgZnVuY3Rpb24uXG4gKiBAdHlwZVBhcmFtIFZhbHVlIC0gVGhlIHR5cGUgb2YgdGhlIHZhbHVlIHByb3ZpZGVkLlxuICogQHBhcmFtIHByb3ZpZGVyIC0gVGhlIHZhbHVlIHByb3ZpZGVyIHRvIHJlc29sdmUuXG4gKiBAcGFyYW0gJGFyZ3VtZW50cyAtIFRoZSBhcmd1bWVudHMgdG8gcGFzcyB0byB0aGUgZnVuY3Rpb24gaWYgdGhlIHByb3ZpZGVyIGlzIGEgZnVuY3Rpb24uXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdpdGggdGhlIHZhbHVlIHByb3ZpZGVkIGJ5IHRoZSB2YWx1ZSBwcm92aWRlci5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIHJlc29sdmVWYWx1ZTxWYWx1ZSwgQXJndW1lbnRzIGV4dGVuZHMgb2JqZWN0ID0gb2JqZWN0PihcbiAgcHJvdmlkZXI6IFZhbHVlUHJvdmlkZXI8VmFsdWUsIEFyZ3VtZW50cz4sXG4gICRhcmd1bWVudHM6IEFyZ3VtZW50cyAmIFBhcnRpYWw8Q29tbW9uQXJndW1lbnRzPlxuKTogUHJvbWlzZTxWYWx1ZT4ge1xuICBjb25zdCBmdWxsQXJndW1lbnRzID0geyAuLi4kYXJndW1lbnRzLCBhYm9ydFNpZ25hbDogJGFyZ3VtZW50cy5hYm9ydFNpZ25hbCA/PyBhYm9ydFNpZ25hbE5ldmVyKCkgfTtcbiAgZnVsbEFyZ3VtZW50cy5hYm9ydFNpZ25hbC50aHJvd0lmQWJvcnRlZCgpO1xuICByZXR1cm4gaXNGdW5jdGlvbihwcm92aWRlcikgPyAoYXdhaXQgcHJvdmlkZXIoZnVsbEFyZ3VtZW50cykpIDogcHJvdmlkZXI7XG59XG5cbi8qKlxuICogRGV0ZXJtaW5lcyB3aGV0aGVyIGEgZ2l2ZW4gdmFsdWUgcHJvdmlkZXIgaXMgYSBmdW5jdGlvbi5cbiAqXG4gKiBAdHlwZVBhcmFtIFZhbHVlIC0gVGhlIHR5cGUgb2YgdGhlIHZhbHVlIHByb3ZpZGVkLlxuICogQHR5cGVQYXJhbSBBcmd1bWVudHMgLSBUaGUgdHlwZXMgb2YgYXJndW1lbnRzIHBhc3NlZCB0byB0aGUgZnVuY3Rpb24gaWYgdGhlIHByb3ZpZGVyIGlzIGEgZnVuY3Rpb24uXG4gKiBAcGFyYW0gdmFsdWUgLSBUaGUgdmFsdWUgcHJvdmlkZXIgdG8gY2hlY2suXG4gKiBAcmV0dXJucyBgdHJ1ZWAgaWYgdGhlIHZhbHVlIHByb3ZpZGVyIGlzIGEgZnVuY3Rpb24sIG90aGVyd2lzZSBgZmFsc2VgLlxuICovXG5mdW5jdGlvbiBpc0Z1bmN0aW9uPFZhbHVlLCBBcmd1bWVudHMgZXh0ZW5kcyBvYmplY3QgPSBvYmplY3Q+KHZhbHVlOiBWYWx1ZVByb3ZpZGVyPFZhbHVlLCBBcmd1bWVudHM+KTogdmFsdWUgaXMgKCRhcmd1bWVudHM6IEFyZ3VtZW50cyAmIENvbW1vbkFyZ3VtZW50cykgPT4gUHJvbWlzYWJsZTxWYWx1ZT4ge1xuICByZXR1cm4gdHlwZW9mIHZhbHVlID09PSAnZnVuY3Rpb24nO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQVFBLDhCQUFpQztBQXVCakMsZUFBc0IsYUFDcEIsVUFDQSxZQUNnQjtBQUNoQixRQUFNLGdCQUFnQixFQUFFLEdBQUcsWUFBWSxhQUFhLFdBQVcsbUJBQWUsMENBQWlCLEVBQUU7QUFDakcsZ0JBQWMsWUFBWSxlQUFlO0FBQ3pDLFNBQU8sV0FBVyxRQUFRLElBQUssTUFBTSxTQUFTLGFBQWEsSUFBSztBQUNsRTtBQVVBLFNBQVMsV0FBcUQsT0FBaUg7QUFDN0ssU0FBTyxPQUFPLFVBQVU7QUFDMUI7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/cjs/value-provider.d.cts

@@ -0,0 +1,28 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * Contains utility types and functions for handling value providers, which can be either direct values or functions that return values.
+ */
+import type { Promisable } from 'type-fest' with { 'resolution-mode': 'import' };
+/**
+ * Value provider that can either be a direct value of type {@link Value} or a function that returns a value of type {@link Value}.
+ *
+ * @typeParam Value - The type of the value provided.
+ * @typeParam Arguments - The types of arguments passed to the function if the provider is a function.
+ */
+export type ValueProvider<Value, Arguments extends object = object> = (($arguments: Arguments & CommonArguments) => Promisable<Value>) | Value;
+interface CommonArguments {
+    abortSignal: AbortSignal;
+}
+/**
+ * Resolves a value from a value provider, which can be either a direct value or a function that returns a value.
+ *
+ * @typeParam Arguments - The types of arguments passed to the function if the provider is a function.
+ * @typeParam Value - The type of the value provided.
+ * @param provider - The value provider to resolve.
+ * @param $arguments - The arguments to pass to the function if the provider is a function.
+ * @returns A {@link Promise} that resolves with the value provided by the value provider.
+ */
+export declare function resolveValue<Value, Arguments extends object = object>(provider: ValueProvider<Value, Arguments>, $arguments: Arguments & Partial<CommonArguments>): Promise<Value>;
+export {};

package/dist/lib/cjs/value-wrapper.cjs

@@ -0,0 +1,144 @@
+/*
+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 keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  // eslint-disable-next-line obsidianmd/no-global-this -- Actively use globalThis.
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var value_wrapper_exports = {};
+__export(value_wrapper_exports, {
+  ValueWrapper: () => ValueWrapper
+});
+module.exports = __toCommonJS(value_wrapper_exports);
+var import_function = require('./function.cjs');
+class ValueWrapper {
+  /**
+   * Gets the wrapped value.
+   *
+   * @returns The wrapped value.
+   * @throws An {@link Error} if the value has not been set.
+   */
+  get value() {
+    if (!this.hasValue) {
+      throw new Error("Value is not set");
+    }
+    return this._value;
+  }
+  /**
+   * Sets the wrapped value.
+   *
+   * @param value - The value to wrap.
+   */
+  set value(value) {
+    this._value = value;
+    this.hasValue = true;
+  }
+  _value = null;
+  hasValue = false;
+  /**
+   * Creates a new value wrapper. Use {@link ValueWrapper.of} or {@link ValueWrapper.unset} instead.
+   */
+  constructor() {
+    (0, import_function.noop)();
+  }
+  /**
+   * Make wrapper from the value.
+   *
+   * @typeParam T - Type of the value to wrap.
+   * @param value - The value to wrap.
+   * @returns The wrapper.
+   */
+  static of(value) {
+    const wrapper = new ValueWrapper();
+    wrapper.value = value;
+    return wrapper;
+  }
+  /**
+   * Make the wrapper with unset value.
+   *
+   * @typeParam T - Type of the value to wrap.
+   * @returns The wrapper.
+   */
+  static unset() {
+    return new ValueWrapper();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ValueWrapper
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3ZhbHVlLXdyYXBwZXIudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBXcmFwcGVyIHR5cGUgZm9yIHN0b3JpbmcgdmFsdWVzLlxuICovXG5cbmltcG9ydCB7IG5vb3AgfSBmcm9tICcuL2Z1bmN0aW9uLnRzJztcblxuLyoqXG4gKiBXcmFwcGVyIHR5cGUgZm9yIHN0b3JpbmcgdmFsdWVzLlxuICpcbiAqIEB0eXBlUGFyYW0gVCAtIFRoZSB0eXBlIG9mIHRoZSB3cmFwcGVkIHZhbHVlLlxuICovXG5leHBvcnQgY2xhc3MgVmFsdWVXcmFwcGVyPFQgPSB1bmtub3duPiB7XG4gIC8qKlxuICAgKiBHZXRzIHRoZSB3cmFwcGVkIHZhbHVlLlxuICAgKlxuICAgKiBAcmV0dXJucyBUaGUgd3JhcHBlZCB2YWx1ZS5cbiAgICogQHRocm93cyBBbiB7QGxpbmsgRXJyb3J9IGlmIHRoZSB2YWx1ZSBoYXMgbm90IGJlZW4gc2V0LlxuICAgKi9cbiAgcHVibGljIGdldCB2YWx1ZSgpOiBUIHtcbiAgICBpZiAoIXRoaXMuaGFzVmFsdWUpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcignVmFsdWUgaXMgbm90IHNldCcpO1xuICAgIH1cblxuICAgIHJldHVybiB0aGlzLl92YWx1ZSBhcyBUO1xuICB9XG5cbiAgLyoqXG4gICAqIFNldHMgdGhlIHdyYXBwZWQgdmFsdWUuXG4gICAqXG4gICAqIEBwYXJhbSB2YWx1ZSAtIFRoZSB2YWx1ZSB0byB3cmFwLlxuICAgKi9cbiAgcHVibGljIHNldCB2YWx1ZSh2YWx1ZTogVCkge1xuICAgIHRoaXMuX3ZhbHVlID0gdmFsdWU7XG4gICAgdGhpcy5oYXNWYWx1ZSA9IHRydWU7XG4gIH1cblxuICBwcml2YXRlIF92YWx1ZTogbnVsbCB8IFQgPSBudWxsO1xuXG4gIHByaXZhdGUgaGFzVmFsdWUgPSBmYWxzZTtcblxuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyB2YWx1ZSB3cmFwcGVyLiBVc2Uge0BsaW5rIFZhbHVlV3JhcHBlci5vZn0gb3Ige0BsaW5rIFZhbHVlV3JhcHBlci51bnNldH0gaW5zdGVhZC5cbiAgICovXG4gIHByaXZhdGUgY29uc3RydWN0b3IoKSB7XG4gICAgbm9vcCgpO1xuICB9XG5cbiAgLyoqXG4gICAqIE1ha2Ugd3JhcHBlciBmcm9tIHRoZSB2YWx1ZS5cbiAgICpcbiAgICogQHR5cGVQYXJhbSBUIC0gVHlwZSBvZiB0aGUgdmFsdWUgdG8gd3JhcC5cbiAgICogQHBhcmFtIHZhbHVlIC0gVGhlIHZhbHVlIHRvIHdyYXAuXG4gICAqIEByZXR1cm5zIFRoZSB3cmFwcGVyLlxuICAgKi9cbiAgcHVibGljIHN0YXRpYyBvZjxUPih2YWx1ZTogVCk6IFZhbHVlV3JhcHBlcjxUPiB7XG4gICAgY29uc3Qgd3JhcHBlciA9IG5ldyBWYWx1ZVdyYXBwZXI8VD4oKTtcbiAgICB3cmFwcGVyLnZhbHVlID0gdmFsdWU7XG4gICAgcmV0dXJuIHdyYXBwZXI7XG4gIH1cblxuICAvKipcbiAgICogTWFrZSB0aGUgd3JhcHBlciB3aXRoIHVuc2V0IHZhbHVlLlxuICAgKlxuICAgKiBAdHlwZVBhcmFtIFQgLSBUeXBlIG9mIHRoZSB2YWx1ZSB0byB3cmFwLlxuICAgKiBAcmV0dXJucyBUaGUgd3JhcHBlci5cbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgdW5zZXQ8VD4oKTogVmFsdWVXcmFwcGVyPFQ+IHtcbiAgICByZXR1cm4gbmV3IFZhbHVlV3JhcHBlcjxUPigpO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBTUEsc0JBQXFCO0FBT2QsTUFBTSxhQUEwQjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT3JDLElBQVcsUUFBVztBQUNwQixRQUFJLENBQUMsS0FBSyxVQUFVO0FBQ2xCLFlBQU0sSUFBSSxNQUFNLGtCQUFrQjtBQUFBLElBQ3BDO0FBRUEsV0FBTyxLQUFLO0FBQUEsRUFDZDtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9BLElBQVcsTUFBTSxPQUFVO0FBQ3pCLFNBQUssU0FBUztBQUNkLFNBQUssV0FBVztBQUFBLEVBQ2xCO0FBQUEsRUFFUSxTQUFtQjtBQUFBLEVBRW5CLFdBQVc7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtYLGNBQWM7QUFDcEIsOEJBQUs7QUFBQSxFQUNQO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVNBLE9BQWMsR0FBTSxPQUEyQjtBQUM3QyxVQUFNLFVBQVUsSUFBSSxhQUFnQjtBQUNwQyxZQUFRLFFBQVE7QUFDaEIsV0FBTztBQUFBLEVBQ1Q7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQVFBLE9BQWMsUUFBNEI7QUFDeEMsV0FBTyxJQUFJLGFBQWdCO0FBQUEsRUFDN0I7QUFDRjsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/cjs/value-wrapper.d.cts

@@ -0,0 +1,47 @@
+/// <reference path="./library.d.cts" />
+/**
+ * @file
+ *
+ * Wrapper type for storing values.
+ */
+/**
+ * Wrapper type for storing values.
+ *
+ * @typeParam T - The type of the wrapped value.
+ */
+export declare class ValueWrapper<T = unknown> {
+    /**
+     * Gets the wrapped value.
+     *
+     * @returns The wrapped value.
+     * @throws An {@link Error} if the value has not been set.
+     */
+    get value(): T;
+    /**
+     * Sets the wrapped value.
+     *
+     * @param value - The value to wrap.
+     */
+    set value(value: T);
+    private _value;
+    private hasValue;
+    /**
+     * Creates a new value wrapper. Use {@link ValueWrapper.of} or {@link ValueWrapper.unset} instead.
+     */
+    private constructor();
+    /**
+     * Make wrapper from the value.
+     *
+     * @typeParam T - Type of the value to wrap.
+     * @param value - The value to wrap.
+     * @returns The wrapper.
+     */
+    static of<T>(value: T): ValueWrapper<T>;
+    /**
+     * Make the wrapper with unset value.
+     *
+     * @typeParam T - Type of the value to wrap.
+     * @returns The wrapper.
+     */
+    static unset<T>(): ValueWrapper<T>;
+}

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

@@ -0,0 +1,21 @@
+/// <reference path="../library.d.mts" />
+/**
+ * @file
+ *
+ * Fixed typings for the `debug` package.
+ *
+ * @see {@link https://www.npmjs.com/package/debug} for more information.
+ */
+
+export {};
+
+declare module 'debug' {
+  interface Debug {
+    /**
+     * Loads the debug configuration from the environment.
+     *
+     * @returns The loaded debug configuration.
+     */
+    load(): null | string;
+  }
+}