@tstdl/base 0.87.13 → 0.88.0-alpha1

package/random/series.js

@@ -1,45 +1,43 @@
-"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 series_exports = {};
-__export(series_exports, {
-  randomSeries: () => randomSeries
-});
-module.exports = __toCommonJS(series_exports);
-var import_math = require("../utils/math.js");
-var import_type_guards = require("../utils/type-guards.js");
-var import_random_number_generator_function = require("./number-generator/random-number-generator-function.js");
-function* randomSeries({ bounds, initial = bounds ?? 1, volatility = 0.025, relativeTo = "initial", generator = import_random_number_generator_function.defaultRandomNumberGeneratorFn, regressionExponent = 10 } = {}) {
-  const initialValue = (0, import_type_guards.isNumber)(initial) ? initial : (0, import_math.randomFloat)(initial[0], initial[1]);
-  const isRelativeToCurrent = relativeTo == "current";
-  const hasBounds = (0, import_type_guards.isDefined)(bounds);
-  const min = hasBounds ? bounds[0] : void 0;
-  const max = hasBounds ? bounds[1] : void 0;
-  const volatilityProvider = (0, import_type_guards.isNumber)(volatility) ? () => volatility : (value2) => volatility.next(value2).value;
-  let value = initialValue;
-  while (true) {
-    const currentVolatility = volatilityProvider(value);
-    let changePercent = currentVolatility * ((0.5 - generator()) * 2);
-    if (hasBounds) {
-      const normalizedDeltaFromMean = (0, import_math.linearInterpolate)(value, min, max, -1, 1);
-      const regressFactor = (0, import_math.clamp)(Math.abs(normalizedDeltaFromMean) ** regressionExponent * Math.sign(normalizedDeltaFromMean), -1.5, 1.5);
-      changePercent -= currentVolatility * regressFactor;
+import { clamp, linearInterpolate, randomFloat } from '../utils/math.js';
+import { isDefined, isNumber } from '../utils/type-guards.js';
+import { defaultRandomNumberGeneratorFn } from './number-generator/random-number-generator-function.js';
+/**
+ * Generator to create random series data like stock charts or measurements over time.
+ *
+ * @example
+ *
+ * // very simple: series starting at 1 without bounds
+ * randomSeries();
+ *
+ * // bounded: series between 100 and 200
+ * randomSeries({ bounds: [100, 200] });
+ *
+ * // complex: series between 5 and 50 with dynamic volatility like a stock chart
+ * randomSeries({
+ *   bounds: [5, 50],
+ *   volatility: randomSeries({ bounds: [0.01, 0.2], volatility: 0.2, regressionExponent: 2 }),
+ *   relativeTo: 'current',
+ *   regressionExponent: 8
+ * });
+ */
+export function* randomSeries({ bounds, initial = bounds ?? 1, volatility = 0.025, relativeTo = 'initial', generator = defaultRandomNumberGeneratorFn, regressionExponent = 10 } = {}) {
+    const initialValue = isNumber(initial) ? initial : randomFloat(initial[0], initial[1]);
+    const isRelativeToCurrent = (relativeTo == 'current');
+    const hasBounds = isDefined(bounds);
+    const min = hasBounds ? bounds[0] : undefined;
+    const max = hasBounds ? bounds[1] : undefined;
+    const volatilityProvider = isNumber(volatility)
+        ? () => volatility
+        : (value) => volatility.next(value).value;
+    let value = initialValue;
+    while (true) {
+        const currentVolatility = volatilityProvider(value);
+        let changePercent = currentVolatility * ((0.5 - generator()) * 2);
+        if (hasBounds) {
+            const normalizedDeltaFromMean = linearInterpolate(value, min, max, -1, 1);
+            const regressFactor = clamp((Math.abs(normalizedDeltaFromMean) ** regressionExponent) * Math.sign(normalizedDeltaFromMean), -1.5, 1.5);
+            changePercent -= currentVolatility * regressFactor;
+        }
+        yield (value += isRelativeToCurrent ? (value * changePercent) : (initialValue * changePercent));
     }
-    yield value += isRelativeToCurrent ? value * changePercent : initialValue * changePercent;
-  }
 }

package/reflection/decorator-data.js

@@ -1,81 +1,64 @@
-"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 decorator_data_exports = {};
-__export(decorator_data_exports, {
-  getDecoratorData: () => getDecoratorData
-});
-module.exports = __toCommonJS(decorator_data_exports);
-var import_details_error = require("../error/details.error.js");
-var import_type_guards = require("../utils/type-guards.js");
-var import_utils = require("./utils.js");
-function getDecoratorData(target, propertyKey, descriptorOrParameterIndex) {
-  const constructor = (0, import_utils.getConstructor)(target);
-  const prototype = constructor.prototype;
-  const isStatic = typeof target == "function";
-  if ((0, import_type_guards.isUndefined)(propertyKey) && (0, import_type_guards.isUndefined)(descriptorOrParameterIndex)) {
-    return {
-      type: "class",
-      constructor,
-      prototype
-    };
-  } else if ((0, import_type_guards.isDefined)(propertyKey) && (0, import_type_guards.isUndefined)(descriptorOrParameterIndex)) {
-    return {
-      type: "property",
-      constructor,
-      prototype,
-      static: isStatic,
-      propertyKey
-    };
-  } else if ((0, import_type_guards.isDefined)(propertyKey) && (0, import_type_guards.isObject)(descriptorOrParameterIndex) && (0, import_type_guards.isFunction)(descriptorOrParameterIndex.get ?? descriptorOrParameterIndex.set)) {
-    return {
-      type: "accessor",
-      constructor,
-      prototype,
-      static: isStatic,
-      propertyKey,
-      descriptor: descriptorOrParameterIndex
-    };
-  } else if ((0, import_type_guards.isDefined)(propertyKey) && (0, import_type_guards.isObject)(descriptorOrParameterIndex) && (0, import_type_guards.isFunction)(descriptorOrParameterIndex.value)) {
-    return {
-      type: "method",
-      constructor,
-      prototype,
-      static: isStatic,
-      methodKey: propertyKey,
-      descriptor: descriptorOrParameterIndex
-    };
-  } else if ((0, import_type_guards.isDefined)(propertyKey) && (0, import_type_guards.isNumber)(descriptorOrParameterIndex)) {
-    return {
-      type: "method-parameter",
-      constructor,
-      prototype,
-      static: isStatic,
-      methodKey: propertyKey,
-      index: descriptorOrParameterIndex
-    };
-  } else if ((0, import_type_guards.isNumber)(descriptorOrParameterIndex)) {
-    return {
-      type: "constructor-parameter",
-      constructor,
-      prototype,
-      index: descriptorOrParameterIndex
-    };
-  }
-  throw new import_details_error.DetailsError("unknown type", { type: constructor, isStatic, propertyKey, descriptorOrParameterIndex });
+import { DetailsError } from '../error/details.error.js';
+import { isDefined, isFunction, isNumber, isObject, isUndefined } from '../utils/type-guards.js';
+import { getConstructor } from './utils.js';
+// eslint-disable-next-line max-lines-per-function
+export function getDecoratorData(target, propertyKey, descriptorOrParameterIndex) {
+    const constructor = getConstructor(target);
+    const prototype = constructor.prototype;
+    const isStatic = typeof target == 'function';
+    if (isUndefined(propertyKey) && isUndefined(descriptorOrParameterIndex)) {
+        return {
+            type: 'class',
+            constructor,
+            prototype
+        };
+    }
+    else if (isDefined(propertyKey) && isUndefined(descriptorOrParameterIndex)) {
+        return {
+            type: 'property',
+            constructor,
+            prototype,
+            static: isStatic,
+            propertyKey
+        };
+    }
+    else if (isDefined(propertyKey) && isObject(descriptorOrParameterIndex) && (isFunction(descriptorOrParameterIndex.get ?? descriptorOrParameterIndex.set))) { // eslint-disable-line @typescript-eslint/unbound-method
+        return {
+            type: 'accessor',
+            constructor,
+            prototype,
+            static: isStatic,
+            propertyKey,
+            descriptor: descriptorOrParameterIndex
+        };
+    }
+    else if (isDefined(propertyKey) && isObject(descriptorOrParameterIndex) && isFunction(descriptorOrParameterIndex.value)) {
+        return {
+            type: 'method',
+            constructor,
+            prototype,
+            static: isStatic,
+            methodKey: propertyKey,
+            descriptor: descriptorOrParameterIndex
+        };
+    }
+    else if (isDefined(propertyKey) && isNumber(descriptorOrParameterIndex)) {
+        return {
+            type: 'method-parameter',
+            constructor,
+            prototype,
+            static: isStatic,
+            methodKey: propertyKey,
+            index: descriptorOrParameterIndex
+        };
+    }
+    else if (isNumber(descriptorOrParameterIndex)) {
+        return {
+            type: 'constructor-parameter',
+            constructor,
+            prototype,
+            index: descriptorOrParameterIndex
+        };
+    }
+    throw new DetailsError('unknown type', { type: constructor, isStatic, propertyKey, descriptorOrParameterIndex });
 }

package/reflection/decorators.js

@@ -1,70 +1,40 @@
-"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 decorators_exports = {};
-__export(decorators_exports, {
-  Accessor: () => Accessor,
-  Class: () => Class,
-  ConstructorParameter: () => ConstructorParameter,
-  Decorate: () => Decorate,
-  Method: () => Method,
-  MethodParameter: () => MethodParameter,
-  Parameter: () => Parameter,
-  Property: () => Property,
-  PropertyOrAccessor: () => PropertyOrAccessor
-});
-module.exports = __toCommonJS(decorators_exports);
-var import_reflect_metadata = require("reflect-metadata");
-var import_noop = require("../utils/noop.js");
-var import_utils = require("./utils.js");
-function Decorate({ handler, ...options } = {}) {
-  return (0, import_utils.createDecorator)({
-    ...options,
-    class: true,
-    property: true,
-    accessor: true,
-    method: true,
-    parameter: true,
-    methodParameter: true,
-    constructorParameter: true
-  }, handler ?? import_noop.noop);
-}
-function Class(options) {
-  return (0, import_utils.createClassDecorator)(options);
-}
-function Property(options) {
-  return (0, import_utils.createPropertyDecorator)(options);
-}
-function Accessor(options) {
-  return (0, import_utils.createAccessorDecorator)(options);
-}
-function PropertyOrAccessor(options) {
-  return (0, import_utils.createPropertyOrAccessorDecorator)(options);
-}
-function Method(options) {
-  return (0, import_utils.createMethodDecorator)(options);
-}
-function MethodParameter(options) {
-  return (0, import_utils.createMethodParameterDecorator)(options);
-}
-function ConstructorParameter(options) {
-  return (0, import_utils.createConstructorParameterDecorator)(options);
-}
-function Parameter(options) {
-  return (0, import_utils.createParameterDecorator)(options);
+/* eslint-disable @typescript-eslint/naming-convention */
+import 'reflect-metadata'; // eslint-disable-line import/no-unassigned-import
+import { noop } from '../utils/noop.js';
+import { createAccessorDecorator, createClassDecorator, createConstructorParameterDecorator, createDecorator, createMethodDecorator, createMethodParameterDecorator, createParameterDecorator, createPropertyDecorator, createPropertyOrAccessorDecorator } from './utils.js';
+export function Decorate({ handler, ...options } = {}) {
+    return createDecorator({
+        ...options,
+        class: true,
+        property: true,
+        accessor: true,
+        method: true,
+        parameter: true,
+        methodParameter: true,
+        constructorParameter: true
+    }, handler ?? noop);
+}
+export function Class(options) {
+    return createClassDecorator(options);
+}
+export function Property(options) {
+    return createPropertyDecorator(options);
+}
+export function Accessor(options) {
+    return createAccessorDecorator(options);
+}
+export function PropertyOrAccessor(options) {
+    return createPropertyOrAccessorDecorator(options);
+}
+export function Method(options) {
+    return createMethodDecorator(options);
+}
+export function MethodParameter(options) {
+    return createMethodParameterDecorator(options);
+}
+export function ConstructorParameter(options) {
+    return createConstructorParameterDecorator(options);
+}
+export function Parameter(options) {
+    return createParameterDecorator(options);
 }

package/reflection/index.js

@@ -1,22 +1,5 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var reflection_exports = {};
-module.exports = __toCommonJS(reflection_exports);
-__reExport(reflection_exports, require("./decorator-data.js"), module.exports);
-__reExport(reflection_exports, require("./decorators.js"), module.exports);
-__reExport(reflection_exports, require("./registry.js"), module.exports);
-__reExport(reflection_exports, require("./types.js"), module.exports);
-__reExport(reflection_exports, require("./utils.js"), module.exports);
+export * from './decorator-data.js';
+export * from './decorators.js';
+export * from './registry.js';
+export * from './types.js';
+export * from './utils.js';

package/reflection/reflection-data-map.js

@@ -1,59 +1,36 @@
-"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 reflection_data_map_exports = {};
-__export(reflection_data_map_exports, {
-  ReflectionDataMap: () => ReflectionDataMap
-});
-module.exports = __toCommonJS(reflection_data_map_exports);
-var import_merge = require("../utils/merge.js");
-var import_object = require("../utils/object/object.js");
-var import_type_guards = require("../utils/type-guards.js");
-class ReflectionDataMap {
-  data;
-  constructor() {
-    this.data = /* @__PURE__ */ new Map();
-  }
-  has(key) {
-    return this.data.has(key);
-  }
-  tryGet(key) {
-    return this.data.get(key);
-  }
-  get(key) {
-    const data = this.tryGet(key);
-    if ((0, import_type_guards.isUndefined)(data)) {
-      throw new Error(`No data for ${String(key)} available.`);
+import { merge } from '../utils/merge.js';
+import { objectEntries } from '../utils/object/object.js';
+import { isUndefined } from '../utils/type-guards.js';
+export class ReflectionDataMap {
+    data;
+    constructor() {
+        this.data = new Map();
     }
-    return data;
-  }
-  set(key, value, mergeValue = false) {
-    if (!mergeValue) {
-      this.data.set(key, value);
-      return;
+    has(key) {
+        return this.data.has(key);
     }
-    const existing = this.data.get(key) ?? {};
-    const newData = (0, import_merge.merge)(existing, value);
-    this.data.set(key, newData);
-  }
-  setMany(data, mergeValues = false) {
-    for (const [key, value] of (0, import_object.objectEntries)(data)) {
-      this.set(key, value, mergeValues);
+    tryGet(key) {
+        return this.data.get(key);
+    }
+    get(key) {
+        const data = this.tryGet(key);
+        if (isUndefined(data)) {
+            throw new Error(`No data for ${String(key)} available.`);
+        }
+        return data;
+    }
+    set(key, value, mergeValue = false) {
+        if (!mergeValue) {
+            this.data.set(key, value);
+            return;
+        }
+        const existing = this.data.get(key) ?? {};
+        const newData = merge(existing, value);
+        this.data.set(key, newData);
+    }
+    setMany(data, mergeValues = false) {
+        for (const [key, value] of objectEntries(data)) {
+            this.set(key, value, mergeValues);
+        }
     }
-  }
 }