@mnaoumov/typescript-lib 0.0.0 → 1.0.0

package/dist/lib/esm/value-wrapper.mjs

@@ -0,0 +1,106 @@
+/*
+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 { noop } from "./function.mjs";
+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() {
+    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();
+  }
+}
+export {
+  ValueWrapper
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL3ZhbHVlLXdyYXBwZXIudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBXcmFwcGVyIHR5cGUgZm9yIHN0b3JpbmcgdmFsdWVzLlxuICovXG5cbmltcG9ydCB7IG5vb3AgfSBmcm9tICcuL2Z1bmN0aW9uLnRzJztcblxuLyoqXG4gKiBXcmFwcGVyIHR5cGUgZm9yIHN0b3JpbmcgdmFsdWVzLlxuICpcbiAqIEB0eXBlUGFyYW0gVCAtIFRoZSB0eXBlIG9mIHRoZSB3cmFwcGVkIHZhbHVlLlxuICovXG5leHBvcnQgY2xhc3MgVmFsdWVXcmFwcGVyPFQgPSB1bmtub3duPiB7XG4gIC8qKlxuICAgKiBHZXRzIHRoZSB3cmFwcGVkIHZhbHVlLlxuICAgKlxuICAgKiBAcmV0dXJucyBUaGUgd3JhcHBlZCB2YWx1ZS5cbiAgICogQHRocm93cyBBbiB7QGxpbmsgRXJyb3J9IGlmIHRoZSB2YWx1ZSBoYXMgbm90IGJlZW4gc2V0LlxuICAgKi9cbiAgcHVibGljIGdldCB2YWx1ZSgpOiBUIHtcbiAgICBpZiAoIXRoaXMuaGFzVmFsdWUpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcignVmFsdWUgaXMgbm90IHNldCcpO1xuICAgIH1cblxuICAgIHJldHVybiB0aGlzLl92YWx1ZSBhcyBUO1xuICB9XG5cbiAgLyoqXG4gICAqIFNldHMgdGhlIHdyYXBwZWQgdmFsdWUuXG4gICAqXG4gICAqIEBwYXJhbSB2YWx1ZSAtIFRoZSB2YWx1ZSB0byB3cmFwLlxuICAgKi9cbiAgcHVibGljIHNldCB2YWx1ZSh2YWx1ZTogVCkge1xuICAgIHRoaXMuX3ZhbHVlID0gdmFsdWU7XG4gICAgdGhpcy5oYXNWYWx1ZSA9IHRydWU7XG4gIH1cblxuICBwcml2YXRlIF92YWx1ZTogbnVsbCB8IFQgPSBudWxsO1xuXG4gIHByaXZhdGUgaGFzVmFsdWUgPSBmYWxzZTtcblxuICAvKipcbiAgICogQ3JlYXRlcyBhIG5ldyB2YWx1ZSB3cmFwcGVyLiBVc2Uge0BsaW5rIFZhbHVlV3JhcHBlci5vZn0gb3Ige0BsaW5rIFZhbHVlV3JhcHBlci51bnNldH0gaW5zdGVhZC5cbiAgICovXG4gIHByaXZhdGUgY29uc3RydWN0b3IoKSB7XG4gICAgbm9vcCgpO1xuICB9XG5cbiAgLyoqXG4gICAqIE1ha2Ugd3JhcHBlciBmcm9tIHRoZSB2YWx1ZS5cbiAgICpcbiAgICogQHR5cGVQYXJhbSBUIC0gVHlwZSBvZiB0aGUgdmFsdWUgdG8gd3JhcC5cbiAgICogQHBhcmFtIHZhbHVlIC0gVGhlIHZhbHVlIHRvIHdyYXAuXG4gICAqIEByZXR1cm5zIFRoZSB3cmFwcGVyLlxuICAgKi9cbiAgcHVibGljIHN0YXRpYyBvZjxUPih2YWx1ZTogVCk6IFZhbHVlV3JhcHBlcjxUPiB7XG4gICAgY29uc3Qgd3JhcHBlciA9IG5ldyBWYWx1ZVdyYXBwZXI8VD4oKTtcbiAgICB3cmFwcGVyLnZhbHVlID0gdmFsdWU7XG4gICAgcmV0dXJuIHdyYXBwZXI7XG4gIH1cblxuICAvKipcbiAgICogTWFrZSB0aGUgd3JhcHBlciB3aXRoIHVuc2V0IHZhbHVlLlxuICAgKlxuICAgKiBAdHlwZVBhcmFtIFQgLSBUeXBlIG9mIHRoZSB2YWx1ZSB0byB3cmFwLlxuICAgKiBAcmV0dXJucyBUaGUgd3JhcHBlci5cbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgdW5zZXQ8VD4oKTogVmFsdWVXcmFwcGVyPFQ+IHtcbiAgICByZXR1cm4gbmV3IFZhbHVlV3JhcHBlcjxUPigpO1xuICB9XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBTUEsU0FBUyxZQUFZO0FBT2QsTUFBTSxhQUEwQjtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBT3JDLElBQVcsUUFBVztBQUNwQixRQUFJLENBQUMsS0FBSyxVQUFVO0FBQ2xCLFlBQU0sSUFBSSxNQUFNLGtCQUFrQjtBQUFBLElBQ3BDO0FBRUEsV0FBTyxLQUFLO0FBQUEsRUFDZDtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQU9BLElBQVcsTUFBTSxPQUFVO0FBQ3pCLFNBQUssU0FBUztBQUNkLFNBQUssV0FBVztBQUFBLEVBQ2xCO0FBQUEsRUFFUSxTQUFtQjtBQUFBLEVBRW5CLFdBQVc7QUFBQTtBQUFBO0FBQUE7QUFBQSxFQUtYLGNBQWM7QUFDcEIsU0FBSztBQUFBLEVBQ1A7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBU0EsT0FBYyxHQUFNLE9BQTJCO0FBQzdDLFVBQU0sVUFBVSxJQUFJLGFBQWdCO0FBQ3BDLFlBQVEsUUFBUTtBQUNoQixXQUFPO0FBQUEsRUFDVDtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLEVBUUEsT0FBYyxRQUE0QjtBQUN4QyxXQUFPLElBQUksYUFBZ0I7QUFBQSxFQUM3QjtBQUNGOyIsCiAgIm5hbWVzIjogW10KfQo=

package/package.json

@@ -1,14 +1,112 @@
-{
-  "name": "@mnaoumov/typescript-lib",
-  "version": "0.0.0",
-  "description": "Placeholder. The first real release follows from mnaoumov/obsidian-dev-utils.",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/mnaoumov/obsidian-dev-utils.git",
-    "directory": "packages/typescript-lib"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
+{
+  "name": "@mnaoumov/typescript-lib",
+  "version": "1.0.0",
+  "description": "Generic TypeScript utilities: async helpers, errors, disposables, strings, paths, debug logging and more, usable in any TypeScript project.",
+  "keywords": [
+    "typescript",
+    "utilities"
+  ],
+  "homepage": "https://github.com/mnaoumov/obsidian-dev-utils/tree/main/packages/typescript-lib#readme",
+  "bugs": {
+    "url": "https://github.com/mnaoumov/obsidian-dev-utils/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mnaoumov/obsidian-dev-utils.git",
+    "directory": "packages/typescript-lib"
+  },
+  "license": "MIT",
+  "author": "Michael Naumov",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/lib/esm/index.d.mts",
+        "default": "./dist/lib/esm/index.mjs"
+      },
+      "require": {
+        "types": "./dist/lib/cjs/index.d.cts",
+        "default": "./dist/lib/cjs/index.cjs"
+      }
+    },
+    "./*": {
+      "import": {
+        "types": "./dist/lib/esm/*.d.mts",
+        "default": "./dist/lib/esm/*.mjs"
+      },
+      "require": {
+        "types": "./dist/lib/cjs/*.d.cts",
+        "default": "./dist/lib/cjs/*.cjs"
+      }
+    },
+    "./@types/*": {
+      "import": {
+        "types": "./dist/lib/esm/@types/*.d.mts"
+      },
+      "require": {
+        "types": "./dist/lib/cjs/@types/*.d.cts"
+      }
+    },
+    "./transformers": {
+      "import": {
+        "types": "./dist/lib/esm/transformers/index.d.mts",
+        "default": "./dist/lib/esm/transformers/index.mjs"
+      },
+      "require": {
+        "types": "./dist/lib/cjs/transformers/index.d.cts",
+        "default": "./dist/lib/cjs/transformers/index.cjs"
+      }
+    },
+    "./transformers/*": {
+      "import": {
+        "types": "./dist/lib/esm/transformers/*.d.mts",
+        "default": "./dist/lib/esm/transformers/*.mjs"
+      },
+      "require": {
+        "types": "./dist/lib/cjs/transformers/*.d.cts",
+        "default": "./dist/lib/cjs/transformers/*.cjs"
+      }
+    }
+  },
+  "files": [
+    "**/package.json",
+    "dist/",
+    "!dist/*.tgz",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node ../../scripts/run.mjs ../../scripts/build.ts",
+    "build:clean": "node ../../scripts/run.mjs ../../scripts/build-clean.ts",
+    "build:compile": "node ../../scripts/run.mjs ../../scripts/build-compile.ts",
+    "build:compile:typescript": "node ../../scripts/run.mjs ../../scripts/build-compile-typescript.ts",
+    "build:generate-exports": "node ../../scripts/run.mjs ../../scripts/build-generate-exports.ts",
+    "build:generate-index": "node ../../scripts/run.mjs ../../scripts/build-generate-index.ts",
+    "build:lib": "node ../../scripts/run.mjs ../../scripts/build-lib.ts",
+    "build:types": "node ../../scripts/run.mjs ../../scripts/build-types.ts",
+    "build:validate-declarations": "node ../../scripts/run.mjs ../../scripts/build-validate-declarations.ts",
+    "find-overexposed": "node ../../scripts/run.mjs ../../scripts/find-overexposed.ts",
+    "find-overexposed:fix": "node ../../scripts/run.mjs ../../scripts/find-overexposed-fix.ts",
+    "test": "node ../../scripts/run.mjs ../../scripts/package-test.ts",
+    "test:coverage": "node ../../scripts/run.mjs ../../scripts/package-test-coverage.ts",
+    "test:watch": "node ../../scripts/run.mjs ../../scripts/package-test-watch.ts"
+  },
+  "dependencies": {
+    "@types/path-browserify": "^1.0.3",
+    "debug": "^4.4.3",
+    "path-browserify": "^1.0.1",
+    "type-fest": "^5.10.0"
+  },
+  "devDependencies": {
+    "@mnaoumov/typescript-test-toolkit": "^1.0.0",
+    "fflate": "^0.8.3",
+    "jsdom": "^30.1.0",
+    "vitest": "^5.0.1"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/transformers/date-transformer/package.json

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

package/transformers/group-transformer/package.json

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

package/transformers/index/package.json

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

package/transformers/map-transformer/package.json

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

package/transformers/package.json

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

package/transformers/set-transformer/package.json

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

package/transformers/skip-private-property-transformer/package.json

@@ -0,0 +1,6 @@
+{
+  "main": "../../dist/lib/cjs/transformers/skip-private-property-transformer.cjs",
+  "module": "../../dist/lib/esm/transformers/skip-private-property-transformer.mjs",
+  "type": "module",
+  "types": "../../dist/lib/cjs/transformers/skip-private-property-transformer.d.cts"
+}

package/transformers/transformer/package.json

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

package/transformers/two-way-map-transformer/package.json

@@ -0,0 +1,6 @@
+{
+  "main": "../../dist/lib/cjs/transformers/two-way-map-transformer.cjs",
+  "module": "../../dist/lib/esm/transformers/two-way-map-transformer.mjs",
+  "type": "module",
+  "types": "../../dist/lib/cjs/transformers/two-way-map-transformer.d.cts"
+}

package/transformers/typed-transformer/package.json

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