@futdevpro/fsm-dynamo 1.16.4 → 1.16.7

package/src/_models/control-models/range-value.control-model.ts

@@ -1,289 +1,289 @@
-
-
-export type DyFM_RangeV<T> = DyFM_RangeValue<T>;
-
-/**
- * A class that represents a range value.
- * 
- * @example
- * ```ts
- * const range: DyFM_RangeValue<number> = new DyFM_RangeValue(1, 10);
- * ```
- */
-export class DyFM_RangeValue<T = number> {
-  readonly isRange: boolean = true;
-
-  from: T;
-  to: T;
-
-  constructor(
-    from: T | DyFM_RangeValue<T>,
-    to?: T,
-  ) {
-    if ((from as DyFM_RangeValue<T>)?.isRange) {
-      this.from = (from as DyFM_RangeValue<T>).from;
-      this.to = (from as DyFM_RangeValue<T>).to;
-
-      return;
-    } else {
-      this.from = from as T;
-      this.to = to ?? from as T;
-    }
-  }
-  
-  constructed?(): boolean { 
-    return true; 
-  }
-
-  newValues?(value: DyFM_RangeValue<T>): void {
-    this.from = value.from;
-    this.to = value.to;
-  }
-
-  addRange?(range: DyFM_RangeValue<number>): void {
-    (this as DyFM_RangeValue<number>).from += range.from;
-    (this as DyFM_RangeValue<number>).to += range.to;
-  }
-  
-  subtractRange?(range: DyFM_RangeValue<number>): void {
-    (this as DyFM_RangeValue<number>).from -= range.from;
-    (this as DyFM_RangeValue<number>).to -= range.to;
-  }
-
-  multiplyRange?(range: DyFM_RangeValue<number>): void {
-    (this as DyFM_RangeValue<number>).from *= range.from;
-    (this as DyFM_RangeValue<number>).to *= range.to;
-  }
-
-  divideRange?(range: DyFM_RangeValue<number>): void {
-    (this as DyFM_RangeValue<number>).from /= range.from;
-    (this as DyFM_RangeValue<number>).to /= range.to;
-  }
-
-  add?(value: number): void {
-    (this as DyFM_RangeValue<number>).from += value;
-    (this as DyFM_RangeValue<number>).to += value;
-  }
-
-  subtract?(value: number): void {
-    (this as DyFM_RangeValue<number>).from -= value;
-    (this as DyFM_RangeValue<number>).to -= value;
-  }
-
-  multiply?(value: number): void {
-    (this as DyFM_RangeValue<number>).from *= value;
-    (this as DyFM_RangeValue<number>).to *= value;
-  }
-
-  divide?(value: number): void {
-    (this as DyFM_RangeValue<number>).from /= value;
-    (this as DyFM_RangeValue<number>).to /= value;
-  }
-
-  clone?(): DyFM_RangeValue<T> {
-    return new DyFM_RangeValue<T>(this.from, this.to);
-  }
-
-  applyTransform?<K = T>(transform: (value: T) => K): DyFM_RangeValue<K> {
-    return new DyFM_RangeValue<K>(transform(this.from), transform(this.to));
-  }
-
-  toString? = this.stringify;
-  stringify?(spaces: boolean = true, auto: boolean = true): string {
-    if (auto && this.from === this.to) {
-      return `${this.from}`;
-    } else if (spaces) {
-      return `${this.from} - ${this.to}`;
-    } else {
-      return `${this.from}-${this.to}`;
-    }
-  }
-
-  /**
-   * Re-types the range value
-   * @param value - The range value to re-type
-   * @returns The re-typed range value
-   * 
-   * @example
-   * ```ts
-   * const range: DyFM_RangeValue<number> = new DyFM_RangeValue<number>(5, 100);
-   * const retyped: DyFM_RangeValue<number> = DyFM_RangeValue.reType(range);
-   * ```
-   */
-  static reType<T>(value: DyFM_RangeValue<T>): DyFM_RangeValue<T> {
-    return new DyFM_RangeValue<T>(value.from, value.to);
-  }
-
-  /**
-   * Adds two range values
-   * @param a - The first range value
-   * @param b - The second range value
-   * @returns The sum of the two range values
-   * 
-   * @example
-   * ```ts
-   * const a = new DyFM_RangeValue<number>(5, 10);
-   * const b = new DyFM_RangeValue<number>(2, 3);
-   * const result = DyFM_RangeValue.addRange(a, b);
-   * console.log(result); // 7 - 13
-   * ```
-   */
-  static addRange(
-    a: DyFM_RangeValue<number>, 
-    b: DyFM_RangeValue<number>
-  ): DyFM_RangeValue<number> {
-    return new DyFM_RangeValue<number>(a.from + b.from, a.to + b.to);
-  }
-  
-  /**
-   * Subtracts two range values
-   * @param a - The first range value
-   * @param b - The second range value
-   * @returns The difference of the two range values
-   * 
-   * @example
-   * ```ts
-   * const a = new DyFM_RangeValue<number>(5, 10);
-   * const b = new DyFM_RangeValue<number>(2, 3);
-   * const result = DyFM_RangeValue.subtractRange(a, b);
-   * console.log(result); // 3 - 7
-   * ```
-   */
-  static subtractRange(
-    from: DyFM_RangeValue<number>, 
-    value: DyFM_RangeValue<number>
-  ): DyFM_RangeValue<number> {
-    return new DyFM_RangeValue<number>(from.from - value.from, from.to - value.to);
-  }
-
-  /**
-   * Multiplies two range values
-   * @param a - The first range value
-   * @param b - The second range value
-   * @returns The product of the two range values
-   * 
-   * @example
-   * ```ts
-   * const a = new DyFM_RangeValue<number>(5, 10);
-   * const b = new DyFM_RangeValue<number>(2, 3);
-   * const result = DyFM_RangeValue.multiplyRange(a, b);
-   * console.log(result); // 10 - 30
-   * ```
-   */
-  static multiplyRange(
-    from: DyFM_RangeValue<number>, 
-    value: DyFM_RangeValue<number>
-  ): DyFM_RangeValue<number> {
-    return new DyFM_RangeValue<number>(from.from * value.from, from.to * value.to);
-  }
-
-  /**
-   * Divides two range values
-   * @param a - The first range value
-   * @param b - The second range value
-   * @returns The quotient of the two range values
-   * 
-   * @example
-   * ```ts
-   * const a = new DyFM_RangeValue<number>(10, 20);
-   * const b = new DyFM_RangeValue<number>(2, 4);
-   * const result = DyFM_RangeValue.divideRange(a, b);
-   * console.log(result); // 5 - 5
-   * ```
-   */
-  static divideRange(
-    from: DyFM_RangeValue<number>, 
-    value: DyFM_RangeValue<number>
-  ): DyFM_RangeValue<number> {
-    return new DyFM_RangeValue<number>(from.from / value.from, from.to / value.to);
-  }
-
-  /**
-   * Adds a number to a range value
-   * @param a - The range value
-   * @param b - The number to add
-   * @returns The sum of the range value and the number
-   * 
-   * @example
-   * ```ts
-   * const a = new DyFM_RangeValue<number>(5, 10);
-   * const result = DyFM_RangeValue.add(a, 5);
-   * console.log(result); // 10 - 15
-   * ```
-   */
-  static add(a: DyFM_RangeValue<number>, b: number): DyFM_RangeValue<number> {
-    return new DyFM_RangeValue<number>(a.from + b, a.to + b);
-  }
-
-  /**
-   * Subtracts a number from a range value
-   * @param a - The range value
-   * @param b - The number to subtract
-   * @returns The difference of the range value and the number
-   * 
-   * @example
-   * ```ts
-   * const a = new DyFM_RangeValue<number>(5, 10);
-   * const result = DyFM_RangeValue.subtract(a, 5);
-   * console.log(result); // 0 - 5
-   * ```
-   */
-  static subtract(a: DyFM_RangeValue<number>, b: number): DyFM_RangeValue<number> {
-    return new DyFM_RangeValue<number>(a.from - b, a.to - b);
-  }
-
-  /**
-   * Multiplies a range value by a number
-   * @param a - The range value
-   * @param b - The number to multiply
-   * @returns The product of the range value and the number
-   * 
-   * @example
-   * ```ts
-   * const a = new DyFM_RangeValue<number>(5, 10);
-   * const result = DyFM_RangeValue.multiply(a, 5);
-   * console.log(result); // 25 - 50
-   * ```
-   */
-  static multiply(a: DyFM_RangeValue<number>, b: number): DyFM_RangeValue<number> {
-    return new DyFM_RangeValue<number>(a.from * b, a.to * b);
-  }
-
-  /**
-   * Divides a range value by a number
-   * @param a - The range value
-   * @param b - The number to divide
-   * @returns The quotient of the range value and the number
-   * 
-   * @example
-   * ```ts
-   * const a = new DyFM_RangeValue<number>(10, 20);
-   * const result = DyFM_RangeValue.divide(a, 5);
-   * console.log(result); // 2 - 4
-   * ```
-   */
-  static divide(a: DyFM_RangeValue<number>, b: number): DyFM_RangeValue<number> {
-    return new DyFM_RangeValue<number>(a.from / b, a.to / b);
-  }
-
-  /**
-   * Checks if a value is in a range value
-   * @param value - The value to check
-   * @param range - The range value to check
-   * @returns True if the value is in the range, false otherwise
-   * 
-   * @example
-   * ```ts
-   * const value = 5;
-   * const range = new DyFM_RangeValue<number>(0, 10);
-   * const result = DyFM_RangeValue.isInRange(value, range);
-   * console.log(result); // true
-   * ```
-   */
-  static isInRange(value: number, range: DyFM_RangeValue<number>): boolean {
-    return range.from <= value && value <= range.to;
-  }
-}
-
-
-
+
+
+export type DyFM_RangeV<T> = DyFM_RangeValue<T>;
+
+/**
+ * A class that represents a range value.
+ * 
+ * @example
+ * ```ts
+ * const range: DyFM_RangeValue<number> = new DyFM_RangeValue(1, 10);
+ * ```
+ */
+export class DyFM_RangeValue<T = number> {
+  readonly isRange: boolean = true;
+
+  from: T;
+  to: T;
+
+  constructor(
+    from: T | DyFM_RangeValue<T>,
+    to?: T,
+  ) {
+    if ((from as DyFM_RangeValue<T>)?.isRange) {
+      this.from = (from as DyFM_RangeValue<T>).from;
+      this.to = (from as DyFM_RangeValue<T>).to;
+
+      return;
+    } else {
+      this.from = from as T;
+      this.to = to ?? from as T;
+    }
+  }
+  
+  constructed?(): boolean { 
+    return true; 
+  }
+
+  newValues?(value: DyFM_RangeValue<T>): void {
+    this.from = value.from;
+    this.to = value.to;
+  }
+
+  addRange?(range: DyFM_RangeValue<number>): void {
+    (this as DyFM_RangeValue<number>).from += range.from;
+    (this as DyFM_RangeValue<number>).to += range.to;
+  }
+  
+  subtractRange?(range: DyFM_RangeValue<number>): void {
+    (this as DyFM_RangeValue<number>).from -= range.from;
+    (this as DyFM_RangeValue<number>).to -= range.to;
+  }
+
+  multiplyRange?(range: DyFM_RangeValue<number>): void {
+    (this as DyFM_RangeValue<number>).from *= range.from;
+    (this as DyFM_RangeValue<number>).to *= range.to;
+  }
+
+  divideRange?(range: DyFM_RangeValue<number>): void {
+    (this as DyFM_RangeValue<number>).from /= range.from;
+    (this as DyFM_RangeValue<number>).to /= range.to;
+  }
+
+  add?(value: number): void {
+    (this as DyFM_RangeValue<number>).from += value;
+    (this as DyFM_RangeValue<number>).to += value;
+  }
+
+  subtract?(value: number): void {
+    (this as DyFM_RangeValue<number>).from -= value;
+    (this as DyFM_RangeValue<number>).to -= value;
+  }
+
+  multiply?(value: number): void {
+    (this as DyFM_RangeValue<number>).from *= value;
+    (this as DyFM_RangeValue<number>).to *= value;
+  }
+
+  divide?(value: number): void {
+    (this as DyFM_RangeValue<number>).from /= value;
+    (this as DyFM_RangeValue<number>).to /= value;
+  }
+
+  clone?(): DyFM_RangeValue<T> {
+    return new DyFM_RangeValue<T>(this.from, this.to);
+  }
+
+  applyTransform?<K = T>(transform: (value: T) => K): DyFM_RangeValue<K> {
+    return new DyFM_RangeValue<K>(transform(this.from), transform(this.to));
+  }
+
+  toString? = this.stringify;
+  stringify?(spaces: boolean = true, auto: boolean = true): string {
+    if (auto && this.from === this.to) {
+      return `${this.from}`;
+    } else if (spaces) {
+      return `${this.from} - ${this.to}`;
+    } else {
+      return `${this.from}-${this.to}`;
+    }
+  }
+
+  /**
+   * Re-types the range value
+   * @param value - The range value to re-type
+   * @returns The re-typed range value
+   * 
+   * @example
+   * ```ts
+   * const range: DyFM_RangeValue<number> = new DyFM_RangeValue<number>(5, 100);
+   * const retyped: DyFM_RangeValue<number> = DyFM_RangeValue.reType(range);
+   * ```
+   */
+  static reType<T>(value: DyFM_RangeValue<T>): DyFM_RangeValue<T> {
+    return new DyFM_RangeValue<T>(value.from, value.to);
+  }
+
+  /**
+   * Adds two range values
+   * @param a - The first range value
+   * @param b - The second range value
+   * @returns The sum of the two range values
+   * 
+   * @example
+   * ```ts
+   * const a = new DyFM_RangeValue<number>(5, 10);
+   * const b = new DyFM_RangeValue<number>(2, 3);
+   * const result = DyFM_RangeValue.addRange(a, b);
+   * console.log(result); // 7 - 13
+   * ```
+   */
+  static addRange(
+    a: DyFM_RangeValue<number>, 
+    b: DyFM_RangeValue<number>
+  ): DyFM_RangeValue<number> {
+    return new DyFM_RangeValue<number>(a.from + b.from, a.to + b.to);
+  }
+  
+  /**
+   * Subtracts two range values
+   * @param a - The first range value
+   * @param b - The second range value
+   * @returns The difference of the two range values
+   * 
+   * @example
+   * ```ts
+   * const a = new DyFM_RangeValue<number>(5, 10);
+   * const b = new DyFM_RangeValue<number>(2, 3);
+   * const result = DyFM_RangeValue.subtractRange(a, b);
+   * console.log(result); // 3 - 7
+   * ```
+   */
+  static subtractRange(
+    from: DyFM_RangeValue<number>, 
+    value: DyFM_RangeValue<number>
+  ): DyFM_RangeValue<number> {
+    return new DyFM_RangeValue<number>(from.from - value.from, from.to - value.to);
+  }
+
+  /**
+   * Multiplies two range values
+   * @param a - The first range value
+   * @param b - The second range value
+   * @returns The product of the two range values
+   * 
+   * @example
+   * ```ts
+   * const a = new DyFM_RangeValue<number>(5, 10);
+   * const b = new DyFM_RangeValue<number>(2, 3);
+   * const result = DyFM_RangeValue.multiplyRange(a, b);
+   * console.log(result); // 10 - 30
+   * ```
+   */
+  static multiplyRange(
+    from: DyFM_RangeValue<number>, 
+    value: DyFM_RangeValue<number>
+  ): DyFM_RangeValue<number> {
+    return new DyFM_RangeValue<number>(from.from * value.from, from.to * value.to);
+  }
+
+  /**
+   * Divides two range values
+   * @param a - The first range value
+   * @param b - The second range value
+   * @returns The quotient of the two range values
+   * 
+   * @example
+   * ```ts
+   * const a = new DyFM_RangeValue<number>(10, 20);
+   * const b = new DyFM_RangeValue<number>(2, 4);
+   * const result = DyFM_RangeValue.divideRange(a, b);
+   * console.log(result); // 5 - 5
+   * ```
+   */
+  static divideRange(
+    from: DyFM_RangeValue<number>, 
+    value: DyFM_RangeValue<number>
+  ): DyFM_RangeValue<number> {
+    return new DyFM_RangeValue<number>(from.from / value.from, from.to / value.to);
+  }
+
+  /**
+   * Adds a number to a range value
+   * @param a - The range value
+   * @param b - The number to add
+   * @returns The sum of the range value and the number
+   * 
+   * @example
+   * ```ts
+   * const a = new DyFM_RangeValue<number>(5, 10);
+   * const result = DyFM_RangeValue.add(a, 5);
+   * console.log(result); // 10 - 15
+   * ```
+   */
+  static add(a: DyFM_RangeValue<number>, b: number): DyFM_RangeValue<number> {
+    return new DyFM_RangeValue<number>(a.from + b, a.to + b);
+  }
+
+  /**
+   * Subtracts a number from a range value
+   * @param a - The range value
+   * @param b - The number to subtract
+   * @returns The difference of the range value and the number
+   * 
+   * @example
+   * ```ts
+   * const a = new DyFM_RangeValue<number>(5, 10);
+   * const result = DyFM_RangeValue.subtract(a, 5);
+   * console.log(result); // 0 - 5
+   * ```
+   */
+  static subtract(a: DyFM_RangeValue<number>, b: number): DyFM_RangeValue<number> {
+    return new DyFM_RangeValue<number>(a.from - b, a.to - b);
+  }
+
+  /**
+   * Multiplies a range value by a number
+   * @param a - The range value
+   * @param b - The number to multiply
+   * @returns The product of the range value and the number
+   * 
+   * @example
+   * ```ts
+   * const a = new DyFM_RangeValue<number>(5, 10);
+   * const result = DyFM_RangeValue.multiply(a, 5);
+   * console.log(result); // 25 - 50
+   * ```
+   */
+  static multiply(a: DyFM_RangeValue<number>, b: number): DyFM_RangeValue<number> {
+    return new DyFM_RangeValue<number>(a.from * b, a.to * b);
+  }
+
+  /**
+   * Divides a range value by a number
+   * @param a - The range value
+   * @param b - The number to divide
+   * @returns The quotient of the range value and the number
+   * 
+   * @example
+   * ```ts
+   * const a = new DyFM_RangeValue<number>(10, 20);
+   * const result = DyFM_RangeValue.divide(a, 5);
+   * console.log(result); // 2 - 4
+   * ```
+   */
+  static divide(a: DyFM_RangeValue<number>, b: number): DyFM_RangeValue<number> {
+    return new DyFM_RangeValue<number>(a.from / b, a.to / b);
+  }
+
+  /**
+   * Checks if a value is in a range value
+   * @param value - The value to check
+   * @param range - The range value to check
+   * @returns True if the value is in the range, false otherwise
+   * 
+   * @example
+   * ```ts
+   * const value = 5;
+   * const range = new DyFM_RangeValue<number>(0, 10);
+   * const result = DyFM_RangeValue.isInRange(value, range);
+   * console.log(result); // true
+   * ```
+   */
+  static isInRange(value: number, range: DyFM_RangeValue<number>): boolean {
+    return range.from <= value && value <= range.to;
+  }
+}
+
+
+