tiny-essentials 1.25.5 → 1.25.6

package/dist/v1/TinyMaInSys.min.js

@@ -1 +1 @@
-(()=>{"use strict";var e={d:(t,r)=>{for(var a in r)e.o(r,a)&&!e.o(t,a)&&Object.defineProperty(t,a,{enumerable:!0,get:r[a]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r:e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})}},t={};e.r(t),e.d(t,{FuzzySet:()=>s,MamdaniInferenceSystem:()=>u,defuzzifyCentroid:()=>a,trapezoid:()=>n});const r=e=>{if(!Array.isArray(e))throw new TypeError("Parameter 'sets' must be an array.");if(!e.every(e=>e instanceof s))throw new TypeError("All elements in the array must be instances of FuzzySet.")},a=(e,t,a=.5)=>{i(e,"object","defuzzifyCentroid.fuzzyOutput");for(const t in e)i(e[t],"number",`fuzzyOutput['${t}']`);r(t),i(a,"number","defuzzifyCentroid.step");let n=0,s=0;for(let r=0;r<=100;r+=a){let a=0;t.forEach(t=>{const n=e[t.name]||0,i=Math.min(n,t.calculate(r));a=Math.max(a,i)}),n+=r*a,s+=a}return 0===s?0:n/s},n=(e,t,r,a,n)=>{if(e<=t||e>=n)return 0;if(e>=r&&e<=a)return 1;const i=t===r?1:(e-t)/(r-t),s=a===n?1:(n-e)/(n-a),u=Math.max(0,Math.min(i,1,s));return isNaN(u)?0:u},i=(e,t,r)=>{if(typeof e!==t)throw new TypeError(`Parameter '${r}' must be a ${t}.`)};class s{static trapezoid(e,t,r,a,i){return n(e,t,r,a,i)}#e="";#t=0;#r=0;#a=0;#n=0;get name(){return this.#e}set name(e){i(e,"string","FuzzySet.name"),this.#e=e}get a(){return this.#t}set a(e){i(e,"number","FuzzySet.a"),this.#t=e}get b(){return this.#r}set b(e){i(e,"number","FuzzySet.b"),this.#r=e}get c(){return this.#a}set c(e){i(e,"number","FuzzySet.c"),this.#a=e}get d(){return this.#n}set d(e){i(e,"number","FuzzySet.d"),this.#n=e}constructor(e,t,r,a,n){this.name=e,this.a=t,this.b=r,this.c=a,this.d=n}calculate(e){return i(e,"number","calculate.x"),s.trapezoid(e,this.#t,this.#r,this.#a,this.#n)}}class u{#i=new Map;addVariable(e,t){i(e,"string","addVariable.name"),r(t),this.#i.set(e,t)}removeVariable(e){return i(e,"string","removeVariable.name"),this.#i.delete(e)}getVariable(e){i(e,"string","getVariable.name");const t=this.#i.get(e);if(!t)throw new Error(`Linguistic variable '${e}' not found in the inference system.`);return[...t]}hasVariable(e){return i(e,"string","hasVariable.name"),this.#i.has(e)}fuzzify(e,t){i(e,"string","fuzzify.varName"),i(t,"number","fuzzify.value");const r=this.#i.get(e)||[],a={};return r.forEach(e=>{a[e.name]=e.calculate(t)}),a}}window.TinyMaInSys=t})();
+(()=>{"use strict";var e={d:(t,r)=>{for(var a in r)e.o(r,a)&&!e.o(t,a)&&Object.defineProperty(t,a,{enumerable:!0,get:r[a]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r:e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})}},t={};e.r(t),e.d(t,{FuzzySet:()=>s,MamdaniInferenceSystem:()=>o,defuzzifyCentroid:()=>a,trapezoid:()=>i});const r=e=>{if(!Array.isArray(e))throw new TypeError("Parameter 'sets' must be an array.");if(!e.every(e=>e instanceof s))throw new TypeError("All elements in the array must be instances of FuzzySet.")},a=(e,t,a=.5)=>{n(e,"object","defuzzifyCentroid.fuzzyOutput");for(const t in e)n(e[t],"number",`fuzzyOutput['${t}']`);r(t),n(a,"number","defuzzifyCentroid.step");let i=0,s=0;for(let r=0;r<=100;r+=a){let a=0;t.forEach(t=>{const i=e[t.name]||0,n=Math.min(i,t.calculate(r));a=Math.max(a,n)}),i+=r*a,s+=a}return 0===s?0:i/s},i=(e,t,r,a,i,n=!1)=>{if(n){if(e<=t||e>=i)return 0;if(e>=r&&e<=a)return 1}const s=t===r?1:(e-t)/(r-t),o=a===i?1:(i-e)/(i-a),u=Math.max(0,Math.min(s,1,o));return isNaN(u)?0:u},n=(e,t,r)=>{if(typeof e!==t)throw new TypeError(`Parameter '${r}' must be a ${t}.`)};class s{static trapezoid(e,t,r,a,n,s=!1){return i(e,t,r,a,n,s)}#e="";#t=0;#r=0;#a=0;#i=0;#n=!1;get name(){return this.#e}set name(e){n(e,"string","FuzzySet.name"),this.#e=e}get a(){return this.#t}set a(e){n(e,"number","FuzzySet.a"),this.#t=e}get b(){return this.#r}set b(e){n(e,"number","FuzzySet.b"),this.#r=e}get c(){return this.#a}set c(e){n(e,"number","FuzzySet.c"),this.#a=e}get d(){return this.#i}set d(e){n(e,"number","FuzzySet.d"),this.#i=e}get optimize(){return this.#n}set optimize(e){n(e,"boolean","FuzzySet.optimize"),this.#n=e}constructor(e,t,r,a,i,n=!1){this.name=e,this.a=t,this.b=r,this.c=a,this.d=i,this.optimize=n}calculate(e){return n(e,"number","calculate.x"),s.trapezoid(e,this.#t,this.#r,this.#a,this.#i,this.#n)}}class o{#s=new Map;addVariable(e,t){n(e,"string","addVariable.name"),r(t),this.#s.set(e,t)}removeVariable(e){return n(e,"string","removeVariable.name"),this.#s.delete(e)}getVariable(e){n(e,"string","getVariable.name");const t=this.#s.get(e);if(!t)throw new Error(`Linguistic variable '${e}' not found in the inference system.`);return[...t]}hasVariable(e){return n(e,"string","hasVariable.name"),this.#s.has(e)}fuzzify(e,t){n(e,"string","fuzzify.varName"),n(t,"number","fuzzify.value");const r=this.#s.get(e)||[],a={};return r.forEach(e=>{a[e.name]=e.calculate(t)}),a}}window.TinyMaInSys=t})();

package/dist/v1/libs/TinyMamdaniInferenceSystem.cjs

@@ -63,13 +63,16 @@ const defuzzifyCentroid = (fuzzyOutput, outputSets, step = 0.5) => {
  * @param {number} b - End of the rise (start of plateau).
  * @param {number} c - Start of the fall (end of plateau).
  * @param {number} d - End of the fall.
+ * @param {boolean} [optimize=false] - Optimizes performance by skipping math for absolute bounds.
  * @returns {number} Degree of membership [0, 1].
  */
-const trapezoid = (value, a, b, c, d) => {
-  // If the value is completely outside the outer bounds, return 0 immediately (Performance optimization)
-  if (value <= a || value >= d) return 0;
-  // If the value is entirely within the plateau, return 1 immediately
-  if (value >= b && value <= c) return 1;
+const trapezoid = (value, a, b, c, d, optimize = false) => {
+  if (optimize) {
+    // If the value is completely outside the outer bounds, return 0 immediately
+    if (value <= a || value >= d) return 0;
+    // If the value is entirely within the plateau, return 1 immediately
+    if (value >= b && value <= c) return 1;
+  }
 
   /** @type {number} - Safely calculate rising slope */
   const rise = a === b ? 1 : (value - a) / (b - a);
@@ -106,10 +109,11 @@ class FuzzySet {
    * @param {number} b - End of the rise (start of plateau).
    * @param {number} c - Start of the fall (end of plateau).
    * @param {number} d - End of the fall.
+   * @param {boolean} [optimize=false] - Performance optimization flag.
    * @returns {number} Degree of membership [0, 1].
    */
-  static trapezoid(value, a, b, c, d) {
-    return trapezoid(value, a, b, c, d);
+  static trapezoid(value, a, b, c, d, optimize = false) {
+    return trapezoid(value, a, b, c, d, optimize);
   }
 
   /** @type {string} - Internal name of the fuzzy set */
@@ -122,6 +126,8 @@ class FuzzySet {
   #c = 0;
   /** @type {number} - Internal right foot coordinate */
   #d = 0;
+  /** @type {boolean} - Internal flag to enable calculation optimization */
+  #optimize = false;
 
   get name() {
     return this.#name;
@@ -163,19 +169,29 @@ class FuzzySet {
     this.#d = value;
   }
 
+  get optimize() {
+    return this.#optimize;
+  }
+  set optimize(value) {
+    validateType(value, 'boolean', 'FuzzySet.optimize');
+    this.#optimize = value;
+  }
+
   /**
    * @param {string} name - Name of the set (e.g., "Hot").
    * @param {number} a - Left foot.
    * @param {number} b - Left shoulder.
    * @param {number} c - Right shoulder.
    * @param {number} d - Right feet.
+   * @param {boolean} [optimize=false] - Enables performance optimization.
    */
-  constructor(name, a, b, c, d) {
+  constructor(name, a, b, c, d, optimize = false) {
     this.name = name;
     this.a = a;
     this.b = b;
     this.c = c;
     this.d = d;
+    this.optimize = optimize;
   }
 
   /**
@@ -185,7 +201,7 @@ class FuzzySet {
    */
   calculate(x) {
     validateType(x, 'number', 'calculate.x');
-    return FuzzySet.trapezoid(x, this.#a, this.#b, this.#c, this.#d);
+    return FuzzySet.trapezoid(x, this.#a, this.#b, this.#c, this.#d, this.#optimize);
   }
 }
 

package/dist/v1/libs/TinyMamdaniInferenceSystem.d.mts

@@ -1,7 +1,7 @@
 export function defuzzifyCentroid(fuzzyOutput: {
     [x: string]: number;
 }, outputSets: FuzzySet[], step?: number): number;
-export function trapezoid(value: number, a: number, b: number, c: number, d: number): number;
+export function trapezoid(value: number, a: number, b: number, c: number, d: number, optimize?: boolean): number;
 /**
  * Represents a single Membership Function (Trapezoidal).
  */
@@ -13,17 +13,19 @@ export class FuzzySet {
      * @param {number} b - End of the rise (start of plateau).
      * @param {number} c - Start of the fall (end of plateau).
      * @param {number} d - End of the fall.
+     * @param {boolean} [optimize=false] - Performance optimization flag.
      * @returns {number} Degree of membership [0, 1].
      */
-    static trapezoid(value: number, a: number, b: number, c: number, d: number): number;
+    static trapezoid(value: number, a: number, b: number, c: number, d: number, optimize?: boolean): number;
     /**
      * @param {string} name - Name of the set (e.g., "Hot").
      * @param {number} a - Left foot.
      * @param {number} b - Left shoulder.
      * @param {number} c - Right shoulder.
      * @param {number} d - Right feet.
+     * @param {boolean} [optimize=false] - Enables performance optimization.
      */
-    constructor(name: string, a: number, b: number, c: number, d: number);
+    constructor(name: string, a: number, b: number, c: number, d: number, optimize?: boolean);
     set name(value: string);
     get name(): string;
     set a(value: number);
@@ -34,6 +36,8 @@ export class FuzzySet {
     get c(): number;
     set d(value: number);
     get d(): number;
+    set optimize(value: boolean);
+    get optimize(): boolean;
     /**
      * Calculates the membership degree.
      * @param {number} x - Crisp input.

package/dist/v1/libs/TinyMamdaniInferenceSystem.mjs

@@ -51,15 +51,18 @@ export const defuzzifyCentroid = (fuzzyOutput, outputSets, step = 0.5) => {
  * @param {number} b - End of the rise (start of plateau).
  * @param {number} c - Start of the fall (end of plateau).
  * @param {number} d - End of the fall.
+ * @param {boolean} [optimize=false] - Optimizes performance by skipping math for absolute bounds.
  * @returns {number} Degree of membership [0, 1].
  */
-export const trapezoid = (value, a, b, c, d) => {
-    // If the value is completely outside the outer bounds, return 0 immediately (Performance optimization)
-    if (value <= a || value >= d)
-        return 0;
-    // If the value is entirely within the plateau, return 1 immediately
-    if (value >= b && value <= c)
-        return 1;
+export const trapezoid = (value, a, b, c, d, optimize = false) => {
+    if (optimize) {
+        // If the value is completely outside the outer bounds, return 0 immediately
+        if (value <= a || value >= d)
+            return 0;
+        // If the value is entirely within the plateau, return 1 immediately
+        if (value >= b && value <= c)
+            return 1;
+    }
     /** @type {number} - Safely calculate rising slope */
     const rise = a === b ? 1 : (value - a) / (b - a);
     /** @type {number} - Safely calculate falling slope */
@@ -90,10 +93,11 @@ class FuzzySet {
      * @param {number} b - End of the rise (start of plateau).
      * @param {number} c - Start of the fall (end of plateau).
      * @param {number} d - End of the fall.
+     * @param {boolean} [optimize=false] - Performance optimization flag.
      * @returns {number} Degree of membership [0, 1].
      */
-    static trapezoid(value, a, b, c, d) {
-        return trapezoid(value, a, b, c, d);
+    static trapezoid(value, a, b, c, d, optimize = false) {
+        return trapezoid(value, a, b, c, d, optimize);
     }
     /** @type {string} - Internal name of the fuzzy set */
     #name = '';
@@ -105,6 +109,8 @@ class FuzzySet {
     #c = 0;
     /** @type {number} - Internal right foot coordinate */
     #d = 0;
+    /** @type {boolean} - Internal flag to enable calculation optimization */
+    #optimize = false;
     get name() {
         return this.#name;
     }
@@ -140,19 +146,28 @@ class FuzzySet {
         validateType(value, 'number', 'FuzzySet.d');
         this.#d = value;
     }
+    get optimize() {
+        return this.#optimize;
+    }
+    set optimize(value) {
+        validateType(value, 'boolean', 'FuzzySet.optimize');
+        this.#optimize = value;
+    }
     /**
      * @param {string} name - Name of the set (e.g., "Hot").
      * @param {number} a - Left foot.
      * @param {number} b - Left shoulder.
      * @param {number} c - Right shoulder.
      * @param {number} d - Right feet.
+     * @param {boolean} [optimize=false] - Enables performance optimization.
      */
-    constructor(name, a, b, c, d) {
+    constructor(name, a, b, c, d, optimize = false) {
         this.name = name;
         this.a = a;
         this.b = b;
         this.c = c;
         this.d = d;
+        this.optimize = optimize;
     }
     /**
      * Calculates the membership degree.
@@ -161,7 +176,7 @@ class FuzzySet {
      */
     calculate(x) {
         validateType(x, 'number', 'calculate.x');
-        return FuzzySet.trapezoid(x, this.#a, this.#b, this.#c, this.#d);
+        return FuzzySet.trapezoid(x, this.#a, this.#b, this.#c, this.#d, this.#optimize);
     }
 }
 /**

package/docs/v1/libs/TinyMamdaniInferenceSystem.md

@@ -6,7 +6,7 @@ Welcome to the official documentation for the **Fuzzy Logic Engine**! 🚀 This
 
 ## 🛠️ Core Utilities
 
-### 📐 `trapezoid(value, a, b, c, d)`
+### 📐 `trapezoid(value, a, b, c, d, optimize = false)`
 A high-performance utility to safely calculate the fuzzy membership degree using a trapezoidal shape. It includes built-in protections against division by zero and short-circuit optimizations.
 
 **Parameters:**
@@ -17,6 +17,7 @@ A high-performance utility to safely calculate the fuzzy membership degree using
 | `b` | `number` | End of the rise / start of plateau (membership = 1). |
 | `c` | `number` | Start of the fall / end of plateau (membership = 1). |
 | `d` | `number` | End of the fall (membership = 0). |
+| `optimize` | `boolean`, optional | Enables performance optimization by skipping math for absolute bounds. Default is `false`. |
 
 **Returns:** * `number` - The degree of membership, safely clamped between `[0, 1]`.
 
@@ -44,20 +45,21 @@ Represents a single linguistic term (e.g., "Cold", "High", "Severe") defined by
 
 #### ⚙️ Constructor
 ```javascript
-new FuzzySet(name, a, b, c, d)
+new FuzzySet(name, a, b, c, d, optimize = false)
 ```
 
 #### 📦 Properties
 * **`name`** (`string`): The name of the fuzzy set.
 * **`a`, `b`, `c`, `d`** (`number`): The coordinates defining the trapezoidal shape.
+* **`optimize`** (`boolean`): Internal flag to enable calculation optimization for absolute bounds.
 
 #### 🧮 Methods
 * **`calculate(x)`**
-  Calculates the membership degree for a specific input using the set's coordinates.
+  Calculates the membership degree for a specific input using the set's coordinates and optimization flag.
   * **Parameters:** `x` (`number`) - The crisp input value.
   * **Returns:** `number` - Degree of membership `[0, 1]`.
 
-* **`static trapezoid(value, a, b, c, d)`**
+* **`static trapezoid(value, a, b, c, d, optimize = false)`**
   Static wrapper for the global `trapezoid` utility.
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.25.5",
+  "version": "1.25.6",
   "description": "Collection of small, essential scripts designed to be used across various projects. These simple utilities are crafted for speed, ease of use, and versatility.",
   "scripts": {
     "test": "npm run test:mjs && npm run test:cjs && npm run test:js",