tiny-essentials 1.25.4 → 1.25.5

package/dist/v1/TinyMaInSys.min.js

@@ -0,0 +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})();

package/dist/v1/index.cjs

@@ -50,6 +50,7 @@ var TinyColorValidator = require('./libs/TinyColorValidator.cjs');
 var TinyAnalogClock = require('./libs/TinyAnalogClock.cjs');
 var TinyTextDiffer = require('./libs/TinyTextDiffer.cjs');
 var TinyArrayComparator = require('./libs/TinyArrayComparator.cjs');
+var TinyMamdaniInferenceSystem = require('./libs/TinyMamdaniInferenceSystem.cjs');
 
 
 
@@ -181,3 +182,7 @@ exports.TinyColorValidator = TinyColorValidator;
 exports.TinyAnalogClock = TinyAnalogClock;
 exports.TinyTextDiffer = TinyTextDiffer;
 exports.TinyArrayComparator = TinyArrayComparator;
+exports.FuzzySet = TinyMamdaniInferenceSystem.FuzzySet;
+exports.MamdaniInferenceSystem = TinyMamdaniInferenceSystem.MamdaniInferenceSystem;
+exports.defuzzifyCentroid = TinyMamdaniInferenceSystem.defuzzifyCentroid;
+exports.trapezoid = TinyMamdaniInferenceSystem.trapezoid;

package/dist/v1/index.d.mts

@@ -1,3 +1,5 @@
+import { FuzzySet } from './libs/TinyMamdaniInferenceSystem.mjs';
+import { MamdaniInferenceSystem } from './libs/TinyMamdaniInferenceSystem.mjs';
 import TinyArrayComparator from './libs/TinyArrayComparator.mjs';
 import TinyTextDiffer from './libs/TinyTextDiffer.mjs';
 import TinyAnalogClock from './libs/TinyAnalogClock.mjs';
@@ -37,6 +39,8 @@ import TinyRateLimiter from './libs/TinyRateLimiter.mjs';
 import ColorSafeStringify from './libs/ColorSafeStringify.mjs';
 import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
 import TinyLevelUp from './libs/TinyLevelUp.mjs';
+import { defuzzifyCentroid } from './libs/TinyMamdaniInferenceSystem.mjs';
+import { trapezoid } from './libs/TinyMamdaniInferenceSystem.mjs';
 import { diffArrayList } from './basics/array.mjs';
 import { diffStrings } from './basics/text.mjs';
 import { breakdownDuration } from './basics/clock.mjs';
@@ -126,5 +130,5 @@ import { getTimeDuration } from './basics/clock.mjs';
 import { shuffleArray } from './basics/array.mjs';
 import { toTitleCase } from './basics/text.mjs';
 import { toTitleCaseLowerFirst } from './basics/text.mjs';
-export { TinyArrayComparator, TinyTextDiffer, TinyAnalogClock, TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyEvents, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, diffArrayList, diffStrings, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getLatestBackupPath, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+export { FuzzySet, MamdaniInferenceSystem, TinyArrayComparator, TinyTextDiffer, TinyAnalogClock, TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyEvents, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, defuzzifyCentroid, trapezoid, diffArrayList, diffStrings, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getLatestBackupPath, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
 //# sourceMappingURL=index.d.mts.map

package/dist/v1/index.mjs

@@ -48,7 +48,8 @@ import TinyColorValidator from './libs/TinyColorValidator.mjs';
 import TinyAnalogClock from './libs/TinyAnalogClock.mjs';
 import TinyTextDiffer from './libs/TinyTextDiffer.mjs';
 import TinyArrayComparator from './libs/TinyArrayComparator.mjs';
+import { FuzzySet, MamdaniInferenceSystem, trapezoid, defuzzifyCentroid, } from './libs/TinyMamdaniInferenceSystem.mjs';
 // import TinyHtmlElems from './libs/TinyHtml/index.mjs';
-export { TinyArrayComparator, TinyTextDiffer, TinyAnalogClock, 
+export { FuzzySet, MamdaniInferenceSystem, TinyArrayComparator, TinyTextDiffer, TinyAnalogClock, 
 // TinyHtmlElems,
-TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyEvents, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, diffArrayList, diffStrings, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getLatestBackupPath, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyEvents, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, defuzzifyCentroid, trapezoid, diffArrayList, diffStrings, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getLatestBackupPath, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/dist/v1/libs/TinyMamdaniInferenceSystem.cjs

@@ -0,0 +1,273 @@
+'use strict';
+
+/**
+ * Internal helper to validate an array of FuzzySets.
+ * @param {FuzzySet[]} sets
+ */
+const validateFuzzySets = (sets) => {
+  if (!Array.isArray(sets)) {
+    throw new TypeError("Parameter 'sets' must be an array.");
+  }
+  if (!sets.every((set) => set instanceof FuzzySet)) {
+    throw new TypeError('All elements in the array must be instances of FuzzySet.');
+  }
+};
+
+/**
+ * Performs defuzzification using the Centroid (Center of Gravity) method.
+ * @param {Object.<string, number>} fuzzyOutput - Results from rule evaluation.
+ * @param {FuzzySet[]} outputSets - The sets defining the output range.
+ * @param {number} [step=0.5] - Resolution of the integral approximation.
+ * @returns {number} The crisp output value.
+ */
+const defuzzifyCentroid = (fuzzyOutput, outputSets, step = 0.5) => {
+  validateType(fuzzyOutput, 'object', 'defuzzifyCentroid.fuzzyOutput');
+
+  for (const outputName in fuzzyOutput) {
+    validateType(fuzzyOutput[outputName], 'number', `fuzzyOutput['${outputName}']`);
+  }
+
+  validateFuzzySets(outputSets);
+  validateType(step, 'number', 'defuzzifyCentroid.step');
+
+  /** @type {number} - Accumulated weighted area for centroid */
+  let totalAreaWeighted = 0;
+  /** @type {number} - Accumulated total area */
+  let totalArea = 0;
+
+  // Numerical integration (Centroid approximation)
+  for (let i = 0; i <= 100; i += step) {
+    /** @type {number} - Maximum membership found at point x(i) */
+    let maxMembershipAtX = 0;
+
+    outputSets.forEach((set) => {
+      /** @type {number} - Rule strength applied to the output set */
+      const strength = fuzzyOutput[set.name] || 0;
+      /** @type {number} - Cut or scale the output set membership */
+      const membership = Math.min(strength, set.calculate(i));
+
+      maxMembershipAtX = Math.max(maxMembershipAtX, membership);
+    });
+
+    totalAreaWeighted += i * maxMembershipAtX;
+    totalArea += maxMembershipAtX;
+  }
+
+  return totalArea === 0 ? 0 : totalAreaWeighted / totalArea;
+};
+
+/**
+ * Utility to calculate fuzzy membership using a trapezoidal shape safely.
+ * @param {number} value - The input value to check.
+ * @param {number} a - Start of the rise.
+ * @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.
+ * @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;
+
+  /** @type {number} - Safely calculate rising slope */
+  const rise = a === b ? 1 : (value - a) / (b - a);
+
+  /** @type {number} - Safely calculate falling slope */
+  const fall = c === d ? 1 : (d - value) / (d - c);
+
+  /** @type {number} - Internal value clamping between 0 and 1 */
+  const membership = Math.max(0, Math.min(rise, 1, fall));
+
+  return isNaN(membership) ? 0 : membership;
+};
+
+/**
+ * Utility to validate types and throw formatted errors, preventing code repetition.
+ * @param {any} value - The value to evaluate.
+ * @param {string} expectedType - The expected data type.
+ * @param {string} paramName - The name of the parameter for the error message.
+ */
+const validateType = (value, expectedType, paramName) => {
+  if (typeof value !== expectedType) {
+    throw new TypeError(`Parameter '${paramName}' must be a ${expectedType}.`);
+  }
+};
+
+/**
+ * Represents a single Membership Function (Trapezoidal).
+ */
+class FuzzySet {
+  /**
+   * Utility to calculate fuzzy membership using a trapezoidal shape.
+   * @param {number} value - The input value to check.
+   * @param {number} a - Start of the rise.
+   * @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.
+   * @returns {number} Degree of membership [0, 1].
+   */
+  static trapezoid(value, a, b, c, d) {
+    return trapezoid(value, a, b, c, d);
+  }
+
+  /** @type {string} - Internal name of the fuzzy set */
+  #name = '';
+  /** @type {number} - Internal left foot coordinate */
+  #a = 0;
+  /** @type {number} - Internal left shoulder coordinate */
+  #b = 0;
+  /** @type {number} - Internal right shoulder coordinate */
+  #c = 0;
+  /** @type {number} - Internal right foot coordinate */
+  #d = 0;
+
+  get name() {
+    return this.#name;
+  }
+  set name(value) {
+    validateType(value, 'string', 'FuzzySet.name');
+    this.#name = value;
+  }
+
+  get a() {
+    return this.#a;
+  }
+  set a(value) {
+    validateType(value, 'number', 'FuzzySet.a');
+    this.#a = value;
+  }
+
+  get b() {
+    return this.#b;
+  }
+  set b(value) {
+    validateType(value, 'number', 'FuzzySet.b');
+    this.#b = value;
+  }
+
+  get c() {
+    return this.#c;
+  }
+  set c(value) {
+    validateType(value, 'number', 'FuzzySet.c');
+    this.#c = value;
+  }
+
+  get d() {
+    return this.#d;
+  }
+  set d(value) {
+    validateType(value, 'number', 'FuzzySet.d');
+    this.#d = 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.
+   */
+  constructor(name, a, b, c, d) {
+    this.name = name;
+    this.a = a;
+    this.b = b;
+    this.c = c;
+    this.d = d;
+  }
+
+  /**
+   * Calculates the membership degree.
+   * @param {number} x - Crisp input.
+   * @returns {number}
+   */
+  calculate(x) {
+    validateType(x, 'number', 'calculate.x');
+    return FuzzySet.trapezoid(x, this.#a, this.#b, this.#c, this.#d);
+  }
+}
+
+/**
+ * The Inference Engine handles linguistic variables and defuzzification.
+ */
+class MamdaniInferenceSystem {
+  /** @type {Map<string, FuzzySet[]>} - Storage for linguistic variables */
+  #variables = new Map();
+
+  /**
+   * Registers a linguistic variable and its sets.
+   * @param {string} name - Variable name (e.g., "temperature").
+   * @param {FuzzySet[]} sets - Array of fuzzy sets.
+   */
+  addVariable(name, sets) {
+    validateType(name, 'string', 'addVariable.name');
+    validateFuzzySets(sets);
+    this.#variables.set(name, sets);
+  }
+
+  /**
+   * Removes a linguistic variable.
+   * @param {string} name - Variable name (e.g., "temperature").
+   * @returns {boolean} True if the element was successfully removed.
+   */
+  removeVariable(name) {
+    validateType(name, 'string', 'removeVariable.name');
+    return this.#variables.delete(name);
+  }
+
+  /**
+   * Gets a linguistic variable and its sets.
+   * @param {string} name - Variable name (e.g., "temperature").
+   * @returns {FuzzySet[]}
+   */
+  getVariable(name) {
+    validateType(name, 'string', 'getVariable.name');
+
+    /** @type {FuzzySet[] | undefined} - Attempted fetch from map */
+    const result = this.#variables.get(name);
+
+    if (!result)
+      throw new Error(`Linguistic variable '${name}' not found in the inference system.`);
+
+    return [...result];
+  }
+
+  /**
+   * Checks if a linguistic variable exists.
+   * @param {string} name - Variable name (e.g., "temperature").
+   * @returns {boolean}
+   */
+  hasVariable(name) {
+    validateType(name, 'string', 'hasVariable.name');
+    return this.#variables.has(name);
+  }
+
+  /**
+   * Fuzzifies a crisp input into a map of memberships.
+   * @param {string} varName
+   * @param {number} value
+   * @returns {Object.<string, number>}
+   */
+  fuzzify(varName, value) {
+    validateType(varName, 'string', 'fuzzify.varName');
+    validateType(value, 'number', 'fuzzify.value');
+
+    /** @type {FuzzySet[]} - The sets associated with the variable */
+    const sets = this.#variables.get(varName) || [];
+    /** @type {Object.<string, number>} - The fuzzified results dictionary */
+    const results = {};
+
+    sets.forEach((set) => {
+      results[set.name] = set.calculate(value);
+    });
+
+    return results;
+  }
+}
+
+exports.FuzzySet = FuzzySet;
+exports.MamdaniInferenceSystem = MamdaniInferenceSystem;
+exports.defuzzifyCentroid = defuzzifyCentroid;
+exports.trapezoid = trapezoid;

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

@@ -0,0 +1,84 @@
+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;
+/**
+ * Represents a single Membership Function (Trapezoidal).
+ */
+export class FuzzySet {
+    /**
+     * Utility to calculate fuzzy membership using a trapezoidal shape.
+     * @param {number} value - The input value to check.
+     * @param {number} a - Start of the rise.
+     * @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.
+     * @returns {number} Degree of membership [0, 1].
+     */
+    static trapezoid(value: number, a: number, b: number, c: number, d: number): 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.
+     */
+    constructor(name: string, a: number, b: number, c: number, d: number);
+    set name(value: string);
+    get name(): string;
+    set a(value: number);
+    get a(): number;
+    set b(value: number);
+    get b(): number;
+    set c(value: number);
+    get c(): number;
+    set d(value: number);
+    get d(): number;
+    /**
+     * Calculates the membership degree.
+     * @param {number} x - Crisp input.
+     * @returns {number}
+     */
+    calculate(x: number): number;
+    #private;
+}
+/**
+ * The Inference Engine handles linguistic variables and defuzzification.
+ */
+export class MamdaniInferenceSystem {
+    /**
+     * Registers a linguistic variable and its sets.
+     * @param {string} name - Variable name (e.g., "temperature").
+     * @param {FuzzySet[]} sets - Array of fuzzy sets.
+     */
+    addVariable(name: string, sets: FuzzySet[]): void;
+    /**
+     * Removes a linguistic variable.
+     * @param {string} name - Variable name (e.g., "temperature").
+     * @returns {boolean} True if the element was successfully removed.
+     */
+    removeVariable(name: string): boolean;
+    /**
+     * Gets a linguistic variable and its sets.
+     * @param {string} name - Variable name (e.g., "temperature").
+     * @returns {FuzzySet[]}
+     */
+    getVariable(name: string): FuzzySet[];
+    /**
+     * Checks if a linguistic variable exists.
+     * @param {string} name - Variable name (e.g., "temperature").
+     * @returns {boolean}
+     */
+    hasVariable(name: string): boolean;
+    /**
+     * Fuzzifies a crisp input into a map of memberships.
+     * @param {string} varName
+     * @param {number} value
+     * @returns {Object.<string, number>}
+     */
+    fuzzify(varName: string, value: number): {
+        [x: string]: number;
+    };
+    #private;
+}
+//# sourceMappingURL=TinyMamdaniInferenceSystem.d.mts.map

package/dist/v1/libs/TinyMamdaniInferenceSystem.mjs

@@ -0,0 +1,233 @@
+/**
+ * Internal helper to validate an array of FuzzySets.
+ * @param {FuzzySet[]} sets
+ */
+const validateFuzzySets = (sets) => {
+    if (!Array.isArray(sets)) {
+        throw new TypeError("Parameter 'sets' must be an array.");
+    }
+    if (!sets.every((set) => set instanceof FuzzySet)) {
+        throw new TypeError('All elements in the array must be instances of FuzzySet.');
+    }
+};
+/**
+ * Performs defuzzification using the Centroid (Center of Gravity) method.
+ * @param {Object.<string, number>} fuzzyOutput - Results from rule evaluation.
+ * @param {FuzzySet[]} outputSets - The sets defining the output range.
+ * @param {number} [step=0.5] - Resolution of the integral approximation.
+ * @returns {number} The crisp output value.
+ */
+export const defuzzifyCentroid = (fuzzyOutput, outputSets, step = 0.5) => {
+    validateType(fuzzyOutput, 'object', 'defuzzifyCentroid.fuzzyOutput');
+    for (const outputName in fuzzyOutput) {
+        validateType(fuzzyOutput[outputName], 'number', `fuzzyOutput['${outputName}']`);
+    }
+    validateFuzzySets(outputSets);
+    validateType(step, 'number', 'defuzzifyCentroid.step');
+    /** @type {number} - Accumulated weighted area for centroid */
+    let totalAreaWeighted = 0;
+    /** @type {number} - Accumulated total area */
+    let totalArea = 0;
+    // Numerical integration (Centroid approximation)
+    for (let i = 0; i <= 100; i += step) {
+        /** @type {number} - Maximum membership found at point x(i) */
+        let maxMembershipAtX = 0;
+        outputSets.forEach((set) => {
+            /** @type {number} - Rule strength applied to the output set */
+            const strength = fuzzyOutput[set.name] || 0;
+            /** @type {number} - Cut or scale the output set membership */
+            const membership = Math.min(strength, set.calculate(i));
+            maxMembershipAtX = Math.max(maxMembershipAtX, membership);
+        });
+        totalAreaWeighted += i * maxMembershipAtX;
+        totalArea += maxMembershipAtX;
+    }
+    return totalArea === 0 ? 0 : totalAreaWeighted / totalArea;
+};
+/**
+ * Utility to calculate fuzzy membership using a trapezoidal shape safely.
+ * @param {number} value - The input value to check.
+ * @param {number} a - Start of the rise.
+ * @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.
+ * @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;
+    /** @type {number} - Safely calculate rising slope */
+    const rise = a === b ? 1 : (value - a) / (b - a);
+    /** @type {number} - Safely calculate falling slope */
+    const fall = c === d ? 1 : (d - value) / (d - c);
+    /** @type {number} - Internal value clamping between 0 and 1 */
+    const membership = Math.max(0, Math.min(rise, 1, fall));
+    return isNaN(membership) ? 0 : membership;
+};
+/**
+ * Utility to validate types and throw formatted errors, preventing code repetition.
+ * @param {any} value - The value to evaluate.
+ * @param {string} expectedType - The expected data type.
+ * @param {string} paramName - The name of the parameter for the error message.
+ */
+const validateType = (value, expectedType, paramName) => {
+    if (typeof value !== expectedType) {
+        throw new TypeError(`Parameter '${paramName}' must be a ${expectedType}.`);
+    }
+};
+/**
+ * Represents a single Membership Function (Trapezoidal).
+ */
+class FuzzySet {
+    /**
+     * Utility to calculate fuzzy membership using a trapezoidal shape.
+     * @param {number} value - The input value to check.
+     * @param {number} a - Start of the rise.
+     * @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.
+     * @returns {number} Degree of membership [0, 1].
+     */
+    static trapezoid(value, a, b, c, d) {
+        return trapezoid(value, a, b, c, d);
+    }
+    /** @type {string} - Internal name of the fuzzy set */
+    #name = '';
+    /** @type {number} - Internal left foot coordinate */
+    #a = 0;
+    /** @type {number} - Internal left shoulder coordinate */
+    #b = 0;
+    /** @type {number} - Internal right shoulder coordinate */
+    #c = 0;
+    /** @type {number} - Internal right foot coordinate */
+    #d = 0;
+    get name() {
+        return this.#name;
+    }
+    set name(value) {
+        validateType(value, 'string', 'FuzzySet.name');
+        this.#name = value;
+    }
+    get a() {
+        return this.#a;
+    }
+    set a(value) {
+        validateType(value, 'number', 'FuzzySet.a');
+        this.#a = value;
+    }
+    get b() {
+        return this.#b;
+    }
+    set b(value) {
+        validateType(value, 'number', 'FuzzySet.b');
+        this.#b = value;
+    }
+    get c() {
+        return this.#c;
+    }
+    set c(value) {
+        validateType(value, 'number', 'FuzzySet.c');
+        this.#c = value;
+    }
+    get d() {
+        return this.#d;
+    }
+    set d(value) {
+        validateType(value, 'number', 'FuzzySet.d');
+        this.#d = 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.
+     */
+    constructor(name, a, b, c, d) {
+        this.name = name;
+        this.a = a;
+        this.b = b;
+        this.c = c;
+        this.d = d;
+    }
+    /**
+     * Calculates the membership degree.
+     * @param {number} x - Crisp input.
+     * @returns {number}
+     */
+    calculate(x) {
+        validateType(x, 'number', 'calculate.x');
+        return FuzzySet.trapezoid(x, this.#a, this.#b, this.#c, this.#d);
+    }
+}
+/**
+ * The Inference Engine handles linguistic variables and defuzzification.
+ */
+class MamdaniInferenceSystem {
+    /** @type {Map<string, FuzzySet[]>} - Storage for linguistic variables */
+    #variables = new Map();
+    /**
+     * Registers a linguistic variable and its sets.
+     * @param {string} name - Variable name (e.g., "temperature").
+     * @param {FuzzySet[]} sets - Array of fuzzy sets.
+     */
+    addVariable(name, sets) {
+        validateType(name, 'string', 'addVariable.name');
+        validateFuzzySets(sets);
+        this.#variables.set(name, sets);
+    }
+    /**
+     * Removes a linguistic variable.
+     * @param {string} name - Variable name (e.g., "temperature").
+     * @returns {boolean} True if the element was successfully removed.
+     */
+    removeVariable(name) {
+        validateType(name, 'string', 'removeVariable.name');
+        return this.#variables.delete(name);
+    }
+    /**
+     * Gets a linguistic variable and its sets.
+     * @param {string} name - Variable name (e.g., "temperature").
+     * @returns {FuzzySet[]}
+     */
+    getVariable(name) {
+        validateType(name, 'string', 'getVariable.name');
+        /** @type {FuzzySet[] | undefined} - Attempted fetch from map */
+        const result = this.#variables.get(name);
+        if (!result)
+            throw new Error(`Linguistic variable '${name}' not found in the inference system.`);
+        return [...result];
+    }
+    /**
+     * Checks if a linguistic variable exists.
+     * @param {string} name - Variable name (e.g., "temperature").
+     * @returns {boolean}
+     */
+    hasVariable(name) {
+        validateType(name, 'string', 'hasVariable.name');
+        return this.#variables.has(name);
+    }
+    /**
+     * Fuzzifies a crisp input into a map of memberships.
+     * @param {string} varName
+     * @param {number} value
+     * @returns {Object.<string, number>}
+     */
+    fuzzify(varName, value) {
+        validateType(varName, 'string', 'fuzzify.varName');
+        validateType(value, 'number', 'fuzzify.value');
+        /** @type {FuzzySet[]} - The sets associated with the variable */
+        const sets = this.#variables.get(varName) || [];
+        /** @type {Object.<string, number>} - The fuzzified results dictionary */
+        const results = {};
+        sets.forEach((set) => {
+            results[set.name] = set.calculate(value);
+        });
+        return results;
+    }
+}
+export { FuzzySet, MamdaniInferenceSystem };

package/docs/v1/README.md

@@ -63,6 +63,7 @@ This folder contains the core scripts we have worked on so far. Each file is a m
 * 📝 **[TinyTextDiffer](./libs/TinyTextDiffer.md)** — A granular text comparison utility using the LCS algorithm to detect additions, deletions, and unchanged segments between multiple history versions, returning a clean, parseable diff structure.
 * 🕒 **[TinyAnalogClock](./libs/TinyAnalogClock.md)** — A lightweight analog clock engine for managing time-based rotations, supporting custom offsets, smooth transitions, and easy binding to CSS variables rendering.
 * 🔍 **[TinyArrayComparator](./libs/TinyArrayComparator.md)** — A lightweight, highly optimized JavaScript utility class designed to compare two arrays and efficiently detect which items were **added** or **deleted**.
+* 🧠 **[TinyMamdaniInferenceSystem](./libs/TinyMamdaniInferenceSystem.md)** — A implementation of a Mamdani Inference System, allowing you to model logic using trapezoidal membership functions.
 
 ### 3. **`fileManager/`**
 * 📁 **[Main](./fileManager/main.md)** — A Node.js file/directory utility module with support for JSON, backups, renaming, size analysis, and more.