tiny-essentials 1.26.1 → 1.26.2

package/dist/v1/build/TinyClassManager.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var TinyClassManager = require('../libs/TinyClassManager.cjs');
+
+
+
+exports.TinyClassManager = TinyClassManager;

package/dist/v1/build/TinyClassManager.d.mts

@@ -0,0 +1,3 @@
+export { TinyClassManager };
+import TinyClassManager from '../libs/TinyClassManager.mjs';
+//# sourceMappingURL=TinyClassManager.d.mts.map

package/dist/v1/build/TinyClassManager.mjs

@@ -0,0 +1,2 @@
+import TinyClassManager from '../libs/TinyClassManager.mjs';
+export { TinyClassManager };

package/dist/v1/index.cjs

@@ -51,6 +51,7 @@ var TinyAnalogClock = require('./libs/TinyAnalogClock.cjs');
 var TinyTextDiffer = require('./libs/TinyTextDiffer.cjs');
 var TinyArrayComparator = require('./libs/TinyArrayComparator.cjs');
 var TinyMamdaniInferenceSystem = require('./libs/TinyMamdaniInferenceSystem.cjs');
+var TinyClassManager = require('./libs/TinyClassManager.cjs');
 
 
 
@@ -186,3 +187,4 @@ exports.FuzzySet = TinyMamdaniInferenceSystem.FuzzySet;
 exports.MamdaniInferenceSystem = TinyMamdaniInferenceSystem.MamdaniInferenceSystem;
 exports.defuzzifyCentroid = TinyMamdaniInferenceSystem.defuzzifyCentroid;
 exports.trapezoid = TinyMamdaniInferenceSystem.trapezoid;
+exports.TinyClassManager = TinyClassManager;

package/dist/v1/index.d.mts

@@ -1,3 +1,4 @@
+import TinyClassManager from './libs/TinyClassManager.mjs';
 import { FuzzySet } from './libs/TinyMamdaniInferenceSystem.mjs';
 import { MamdaniInferenceSystem } from './libs/TinyMamdaniInferenceSystem.mjs';
 import TinyArrayComparator from './libs/TinyArrayComparator.mjs';
@@ -130,5 +131,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 { 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 };
+export { TinyClassManager, 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

@@ -49,7 +49,8 @@ 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 TinyClassManager from './libs/TinyClassManager.mjs';
 // import TinyHtmlElems from './libs/TinyHtml/index.mjs';
-export { FuzzySet, MamdaniInferenceSystem, TinyArrayComparator, TinyTextDiffer, TinyAnalogClock, 
+export { TinyClassManager, 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, 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/TinyClassManager.cjs

@@ -0,0 +1,121 @@
+'use strict';
+
+/**
+ * @template {new (...args: any[]) => any} TBase
+ * @template {new (...args: any[]) => any} TExtended
+ * @typedef {Object} PluginDefinition
+ * @property {string} name - The unique identifier for the plugin.
+ * @property {string[]} [dependencies] - Array of plugin names required before applying this one.
+ * @property {function(TBase): TExtended} apply - Function that receives the base class and returns the extended class.
+ */
+
+/**
+ * Manages the composition of a base class with multiple optional plugins (Mixins).
+ * @template {new (...args: any[]) => any} T
+ */
+class TinyClassManager {
+  /**
+   * @type {Set<string>}
+   * Tracks the names of successfully applied plugins to prevent duplication and check dependencies.
+   */
+  #appliedPlugins = new Set();
+
+  /**
+   * Gets the list of plugins currently applied to this instance.
+   * @returns {string[]} Array of applied plugin names.
+   */
+  get appliedPlugins() {
+    return [...this.#appliedPlugins];
+  }
+
+  /**
+   * Gets the total size of the current class chain hierarchy.
+   * @returns {number} The count of applied plugins plus the core base.
+   */
+  get size() {
+    return this.#appliedPlugins.size + 1;
+  }
+
+  /**
+   * @type {T}
+   * Holds the current state of the class chain.
+   */
+  #currentClass;
+
+  /**
+   * Holds the current state of the class chain.
+   */
+  get currentClass() {
+    return this.#currentClass;
+  }
+
+  /**
+   * Protects the instance from being consumed or reused after transition.
+   */
+  #used = false;
+
+  /**
+   * Protects the instance from being consumed or reused after transition.
+   */
+  get used() {
+    return this.#used;
+  }
+
+  /**
+   * Initializes the manager with a core class.
+   * @param {T} coreClass - The foundational class to be extended.
+   */
+  constructor(coreClass) {
+    this.#currentClass = coreClass;
+  }
+
+  /**
+   * Applies a plugin to the class chain if all conditions are met.
+   * @template {new (...args: any[]) => any} R
+   * @param {PluginDefinition<T, R>} plugin - The plugin module to be integrated.
+   * @returns {TinyClassManager<R>} A new manager instance holding the extended class chain.
+   * @throws {Error} Throws if instance is already consumed, plugin is duplicate, or dependencies are missing.
+   */
+  use(plugin) {
+    if (this.#used) throw new Error(`[TinyClassManager] Cannot reuse a consumed manager instance.`);
+    if (this.#appliedPlugins.has(plugin.name))
+      throw new Error(`[TinyClassManager] Plugin conflict: "${plugin.name}" is already installed.`);
+
+    /**
+     * @type {string[]}
+     * Extracted dependencies array with fallback for undefined properties.
+     */
+    const deps = plugin.dependencies || [];
+
+    for (const dep of deps) {
+      if (!this.#appliedPlugins.has(dep)) {
+        throw new Error(
+          `[TinyClassManager] Missing Dependency: "${plugin.name}" requires "${dep}" to be installed first.`,
+        );
+      }
+    }
+
+    const newClassManager = new TinyClassManager(plugin.apply(this.#currentClass));
+    this.#appliedPlugins.forEach((name) => newClassManager.#appliedPlugins.add(name));
+    newClassManager.#appliedPlugins.add(plugin.name);
+
+    this.#used = true;
+    this.#appliedPlugins.clear();
+    return newClassManager;
+  }
+
+  /**
+   * Finalizes the composition and returns the fully built class.
+   * @returns {T} The final class representing the last extended version in the chain.
+   * @throws {Error} Throws if the manager instance has already been used or finalized.
+   */
+  build() {
+    if (this.#used)
+      throw new Error(`[TinyClassManager] Cannot build from an already finalized manager.`);
+    this.#used = true;
+    this.#appliedPlugins.clear();
+    return this.#currentClass;
+  }
+}
+
+module.exports = TinyClassManager;

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

@@ -0,0 +1,68 @@
+export default TinyClassManager;
+export type PluginDefinition<TBase extends new (...args: any[]) => any, TExtended extends new (...args: any[]) => any> = {
+    /**
+     * - The unique identifier for the plugin.
+     */
+    name: string;
+    /**
+     * - Array of plugin names required before applying this one.
+     */
+    dependencies?: string[] | undefined;
+    /**
+     * - Function that receives the base class and returns the extended class.
+     */
+    apply: (arg0: TBase) => TExtended;
+};
+/**
+ * @template {new (...args: any[]) => any} TBase
+ * @template {new (...args: any[]) => any} TExtended
+ * @typedef {Object} PluginDefinition
+ * @property {string} name - The unique identifier for the plugin.
+ * @property {string[]} [dependencies] - Array of plugin names required before applying this one.
+ * @property {function(TBase): TExtended} apply - Function that receives the base class and returns the extended class.
+ */
+/**
+ * Manages the composition of a base class with multiple optional plugins (Mixins).
+ * @template {new (...args: any[]) => any} T
+ */
+declare class TinyClassManager<T extends new (...args: any[]) => any> {
+    /**
+     * Initializes the manager with a core class.
+     * @param {T} coreClass - The foundational class to be extended.
+     */
+    constructor(coreClass: T);
+    /**
+     * Gets the list of plugins currently applied to this instance.
+     * @returns {string[]} Array of applied plugin names.
+     */
+    get appliedPlugins(): string[];
+    /**
+     * Gets the total size of the current class chain hierarchy.
+     * @returns {number} The count of applied plugins plus the core base.
+     */
+    get size(): number;
+    /**
+     * Holds the current state of the class chain.
+     */
+    get currentClass(): T;
+    /**
+     * Protects the instance from being consumed or reused after transition.
+     */
+    get used(): boolean;
+    /**
+     * Applies a plugin to the class chain if all conditions are met.
+     * @template {new (...args: any[]) => any} R
+     * @param {PluginDefinition<T, R>} plugin - The plugin module to be integrated.
+     * @returns {TinyClassManager<R>} A new manager instance holding the extended class chain.
+     * @throws {Error} Throws if instance is already consumed, plugin is duplicate, or dependencies are missing.
+     */
+    use<R extends new (...args: any[]) => any>(plugin: PluginDefinition<T, R>): TinyClassManager<R>;
+    /**
+     * Finalizes the composition and returns the fully built class.
+     * @returns {T} The final class representing the last extended version in the chain.
+     * @throws {Error} Throws if the manager instance has already been used or finalized.
+     */
+    build(): T;
+    #private;
+}
+//# sourceMappingURL=TinyClassManager.d.mts.map

package/dist/v1/libs/TinyClassManager.mjs

@@ -0,0 +1,103 @@
+/**
+ * @template {new (...args: any[]) => any} TBase
+ * @template {new (...args: any[]) => any} TExtended
+ * @typedef {Object} PluginDefinition
+ * @property {string} name - The unique identifier for the plugin.
+ * @property {string[]} [dependencies] - Array of plugin names required before applying this one.
+ * @property {function(TBase): TExtended} apply - Function that receives the base class and returns the extended class.
+ */
+/**
+ * Manages the composition of a base class with multiple optional plugins (Mixins).
+ * @template {new (...args: any[]) => any} T
+ */
+class TinyClassManager {
+    /**
+     * @type {Set<string>}
+     * Tracks the names of successfully applied plugins to prevent duplication and check dependencies.
+     */
+    #appliedPlugins = new Set();
+    /**
+     * Gets the list of plugins currently applied to this instance.
+     * @returns {string[]} Array of applied plugin names.
+     */
+    get appliedPlugins() {
+        return [...this.#appliedPlugins];
+    }
+    /**
+     * Gets the total size of the current class chain hierarchy.
+     * @returns {number} The count of applied plugins plus the core base.
+     */
+    get size() {
+        return this.#appliedPlugins.size + 1;
+    }
+    /**
+     * @type {T}
+     * Holds the current state of the class chain.
+     */
+    #currentClass;
+    /**
+     * Holds the current state of the class chain.
+     */
+    get currentClass() {
+        return this.#currentClass;
+    }
+    /**
+     * Protects the instance from being consumed or reused after transition.
+     */
+    #used = false;
+    /**
+     * Protects the instance from being consumed or reused after transition.
+     */
+    get used() {
+        return this.#used;
+    }
+    /**
+     * Initializes the manager with a core class.
+     * @param {T} coreClass - The foundational class to be extended.
+     */
+    constructor(coreClass) {
+        this.#currentClass = coreClass;
+    }
+    /**
+     * Applies a plugin to the class chain if all conditions are met.
+     * @template {new (...args: any[]) => any} R
+     * @param {PluginDefinition<T, R>} plugin - The plugin module to be integrated.
+     * @returns {TinyClassManager<R>} A new manager instance holding the extended class chain.
+     * @throws {Error} Throws if instance is already consumed, plugin is duplicate, or dependencies are missing.
+     */
+    use(plugin) {
+        if (this.#used)
+            throw new Error(`[TinyClassManager] Cannot reuse a consumed manager instance.`);
+        if (this.#appliedPlugins.has(plugin.name))
+            throw new Error(`[TinyClassManager] Plugin conflict: "${plugin.name}" is already installed.`);
+        /**
+         * @type {string[]}
+         * Extracted dependencies array with fallback for undefined properties.
+         */
+        const deps = plugin.dependencies || [];
+        for (const dep of deps) {
+            if (!this.#appliedPlugins.has(dep)) {
+                throw new Error(`[TinyClassManager] Missing Dependency: "${plugin.name}" requires "${dep}" to be installed first.`);
+            }
+        }
+        const newClassManager = new TinyClassManager(plugin.apply(this.#currentClass));
+        this.#appliedPlugins.forEach((name) => newClassManager.#appliedPlugins.add(name));
+        newClassManager.#appliedPlugins.add(plugin.name);
+        this.#used = true;
+        this.#appliedPlugins.clear();
+        return newClassManager;
+    }
+    /**
+     * Finalizes the composition and returns the fully built class.
+     * @returns {T} The final class representing the last extended version in the chain.
+     * @throws {Error} Throws if the manager instance has already been used or finalized.
+     */
+    build() {
+        if (this.#used)
+            throw new Error(`[TinyClassManager] Cannot build from an already finalized manager.`);
+        this.#used = true;
+        this.#appliedPlugins.clear();
+        return this.#currentClass;
+    }
+}
+export default TinyClassManager;

package/dist/v1/libs/examples/TinyClassManager.cjs

@@ -0,0 +1,76 @@
+'use strict';
+
+var TinyClassManager = require('../TinyClassManager.cjs');
+
+// ============================================================================
+// Example & Usage Context
+// ============================================================================
+
+// 1. The Core Class (The foundation)
+class EntityCore {
+  /** @param {string} id */
+  constructor(id) {
+    this.id = id;
+  }
+}
+
+// 2. Creating Dependent DLCs
+const Health = {
+  name: 'Health',
+  dependencies: [], // No dependencies, works just with the Core
+  /** @param {typeof EntityCore} Base */
+  apply: (Base) =>
+    class HealthModule extends Base {
+      /** @param {string} id */
+      constructor(id) {
+        super(id);
+        this.hp = 100;
+      }
+
+      /**
+       * Deducts health from the entity.
+       * @param {number} amount - The amount of raw damage to deal.
+       */
+      takeDamage(amount) {
+        this.hp -= amount;
+        console.log(`Took ${amount} damage. HP left: ${this.hp}`);
+      }
+    },
+};
+
+// 3. Creating Independent DLCs
+const Armor = {
+  name: 'Armor',
+  dependencies: ['Health'], // Strictly requires the Health module to be installed first
+  /** @param {ReturnType<typeof Health.apply>} Base */
+  apply: (Base) =>
+    class ArmorModule extends Base {
+      /** @param {string} id */
+      constructor(id) {
+        super(id);
+        this.armor = 50;
+      }
+
+      /**
+       * Deducts health, factoring in damage mitigation provided by armor.
+       * @param {number} amount - The initial damage before armor reduction.
+       */
+      takeDamage(amount) {
+        const reducedDamage = Math.max(0, amount - this.armor * 0.1);
+        super.takeDamage(reducedDamage);
+      }
+    },
+};
+
+// 4. Building the final class
+try {
+  const CoreTest = new TinyClassManager(EntityCore);
+  const FullyArmoredEntity = CoreTest.use(Health).use(Armor).build();
+
+  const myEntity = new FullyArmoredEntity('Player_1');
+  myEntity.takeDamage(30);
+  console.log(`Armor value: ${myEntity.armor}`);
+  console.log(`Current HP: ${myEntity.hp}`);
+} catch (error) {
+  if (error instanceof Error) console.error(error.message);
+}

package/dist/v1/libs/examples/TinyClassManager.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TinyClassManager.d.mts.map

package/dist/v1/libs/examples/TinyClassManager.mjs

@@ -0,0 +1,66 @@
+import TinyClassManager from '../TinyClassManager.mjs';
+// ============================================================================
+// Example & Usage Context
+// ============================================================================
+// 1. The Core Class (The foundation)
+class EntityCore {
+    /** @param {string} id */
+    constructor(id) {
+        this.id = id;
+    }
+}
+// 2. Creating Dependent DLCs
+const Health = {
+    name: 'Health',
+    dependencies: [], // No dependencies, works just with the Core
+    /** @param {typeof EntityCore} Base */
+    apply: (Base) => class HealthModule extends Base {
+        /** @param {string} id */
+        constructor(id) {
+            super(id);
+            this.hp = 100;
+        }
+        /**
+         * Deducts health from the entity.
+         * @param {number} amount - The amount of raw damage to deal.
+         */
+        takeDamage(amount) {
+            this.hp -= amount;
+            console.log(`Took ${amount} damage. HP left: ${this.hp}`);
+        }
+    },
+};
+// 3. Creating Independent DLCs
+const Armor = {
+    name: 'Armor',
+    dependencies: ['Health'], // Strictly requires the Health module to be installed first
+    /** @param {ReturnType<typeof Health.apply>} Base */
+    apply: (Base) => class ArmorModule extends Base {
+        /** @param {string} id */
+        constructor(id) {
+            super(id);
+            this.armor = 50;
+        }
+        /**
+         * Deducts health, factoring in damage mitigation provided by armor.
+         * @param {number} amount - The initial damage before armor reduction.
+         */
+        takeDamage(amount) {
+            const reducedDamage = Math.max(0, amount - this.armor * 0.1);
+            super.takeDamage(reducedDamage);
+        }
+    },
+};
+// 4. Building the final class
+try {
+    const CoreTest = new TinyClassManager(EntityCore);
+    const FullyArmoredEntity = CoreTest.use(Health).use(Armor).build();
+    const myEntity = new FullyArmoredEntity('Player_1');
+    myEntity.takeDamage(30);
+    console.log(`Armor value: ${myEntity.armor}`);
+    console.log(`Current HP: ${myEntity.hp}`);
+}
+catch (error) {
+    if (error instanceof Error)
+        console.error(error.message);
+}

package/docs/v1/README.md

@@ -8,9 +8,7 @@ Here, you can navigate through different sections of the project. Below are the
 
 ## 📚 Main Directories
 
-### 1. **`basics/`** 
-
-This folder contains the core scripts we have worked on so far. Each file is a module focused on specific functionality.
+### 1. **`basics/`** This folder contains the core scripts we have worked on so far. Each file is a module focused on specific functionality.
 
 - 📦 **[Array](./basics/array.md)** — A tiny utility for shuffling arrays using the Fisher–Yates algorithm.
 - ⏰ **[Clock](./basics/clock.md)** — A versatile time utility module for calculating and formatting time durations.
@@ -64,6 +62,7 @@ This folder contains the core scripts we have worked on so far. Each file is a m
 * 🕒 **[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.
+* ⚙️ **[TinyClassManager](./libs/TinyClassManager.md)** — A lightweight, immutable manager designed to linearly compose a base class with multiple modular plugins, featuring automatic dependency verification and duplicate conflict protection.
 
 ### 3. **`fileManager/`**
 * 📁 **[Main](./fileManager/main.md)** — A Node.js file/directory utility module with support for JSON, backups, renaming, size analysis, and more.
@@ -72,9 +71,15 @@ This folder contains the core scripts we have worked on so far. Each file is a m
 
 ## 📚 Tip Directories
 
-### 1. **`libs/`** 
+### 1. **`libs/`** - 🧱 **[TinyHtml](./libs/TinyHtmlTips.md)** — Usage examples and practical tips.
+
+---
+
+## 🔌 Want to Extend These Libraries?
+
+Did you find a class in our `libs/` that *almost* perfectly fits your needs, but you want to add your own custom features, modules, or plugins to it? 
 
-- 🧱 **[TinyHtml](./libs/TinyHtmlTips.md)** — Usage examples and practical tips.
+We highly recommend using **[⚙️ TinyClassManager](./libs/TinyClassManager.md)**! It was specifically built for this purpose. It allows you to safely and cleanly inject your own plugins into our existing classes using a linear mixin architecture, automatically handling dependencies and preventing conflicts without you ever having to touch the original source code.
 
 ---