npm - tiny-essentials - Versions diffs - 1.26.1 → 1.26.3 - Mend

tiny-essentials 1.26.1 → 1.26.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (24) hide show

package/README.md +1 -1
package/changelog/1/26/2.md +10 -0
package/changelog/1/26/3.md +4 -0
package/dist/v1/TinyClassManager.min.js +1 -0
package/dist/v1/TinyEssentials.min.js +1 -1
package/dist/v1/basics/text.cjs +17 -0
package/dist/v1/basics/text.d.mts +17 -0
package/dist/v1/basics/text.mjs +17 -0
package/dist/v1/build/TinyClassManager.cjs +7 -0
package/dist/v1/build/TinyClassManager.d.mts +3 -0
package/dist/v1/build/TinyClassManager.mjs +2 -0
package/dist/v1/css/aiMarker.min.css +1 -1
package/dist/v1/index.cjs +2 -0
package/dist/v1/index.d.mts +2 -1
package/dist/v1/index.mjs +2 -1
package/dist/v1/libs/TinyClassManager.cjs +121 -0
package/dist/v1/libs/TinyClassManager.d.mts +68 -0
package/dist/v1/libs/TinyClassManager.mjs +103 -0
package/dist/v1/libs/examples/TinyClassManager.cjs +76 -0
package/dist/v1/libs/examples/TinyClassManager.d.mts +2 -0
package/dist/v1/libs/examples/TinyClassManager.mjs +66 -0
package/docs/v1/README.md +10 -5
package/docs/v1/libs/TinyClassManager.md +174 -0
package/package.json +5 -1

package/dist/v1/basics/text.cjs CHANGED Viewed

@@ -73,6 +73,23 @@ function toTitleCaseLowerFirst(str) {
  * If executed outside of a browser environment (e.g., in Node.js), the function logs an error and exits.
  * If the `<body>` is not available at the moment the shortcut is triggered, a warning is logged.
  *
+ * -------------------------------------------------
+ *
+ * Any content wrapped inside an `<ai>example</ai>` or `<span class="made-by-ai"></span>` tag was generated purely by artificial intelligence,
+ * without any direct or indirect human intervention during the content generation process.
+ *
+ * -------------------------------------------------
+ *
+ * Any content wrapped inside a `<semi-ai>example</semi-ai>` or `<span class="made-by-semi-ai"></span>` tag was partially generated by artificial
+ * intelligence. In this case, the context of the message was fully shaped by a human source guiding how the content should be written (i.e.,
+ * transforming a purely human text into a polished version enhanced by AI).
+ *
+ * These texts are characterized as improved versions of original human work, where the AI is strictly utilized to enhance the
+ * structure of a human-written text. This tag does **not** apply to texts translated by AI (or any other non-AI translation tools),
+ * nor does it apply to scenarios where an AI minimally refines an existing text by acting solely as a spell checker or basic grammar corrector.
+ *
+ * -------------------------------------------------
+ *
  * @param {Object} [config={}] - Configuration object.
  * @param {string} [config.key='a'] - The lowercase character key to be used in combination with `Ctrl` and `Alt`.
  * @param {string} [config.className='detect-made-by-ai'] - The CSS class to toggle on the `<body>` element.

package/dist/v1/basics/text.d.mts CHANGED Viewed

@@ -44,6 +44,23 @@ export function toTitleCaseLowerFirst(str: string): string;
  * If executed outside of a browser environment (e.g., in Node.js), the function logs an error and exits.
  * If the `<body>` is not available at the moment the shortcut is triggered, a warning is logged.
  *
+ * -------------------------------------------------
+ *
+ * Any content wrapped inside an `<ai>example</ai>` or `<span class="made-by-ai"></span>` tag was generated purely by artificial intelligence,
+ * without any direct or indirect human intervention during the content generation process.
+ *
+ * -------------------------------------------------
+ *
+ * Any content wrapped inside a `<semi-ai>example</semi-ai>` or `<span class="made-by-semi-ai"></span>` tag was partially generated by artificial
+ * intelligence. In this case, the context of the message was fully shaped by a human source guiding how the content should be written (i.e.,
+ * transforming a purely human text into a polished version enhanced by AI).
+ *
+ * These texts are characterized as improved versions of original human work, where the AI is strictly utilized to enhance the
+ * structure of a human-written text. This tag does **not** apply to texts translated by AI (or any other non-AI translation tools),
+ * nor does it apply to scenarios where an AI minimally refines an existing text by acting solely as a spell checker or basic grammar corrector.
+ *
+ * -------------------------------------------------
+ *
  * @param {Object} [config={}] - Configuration object.
  * @param {string} [config.key='a'] - The lowercase character key to be used in combination with `Ctrl` and `Alt`.
  * @param {string} [config.className='detect-made-by-ai'] - The CSS class to toggle on the `<body>` element.

package/dist/v1/basics/text.mjs CHANGED Viewed

@@ -62,6 +62,23 @@ export function toTitleCaseLowerFirst(str) {
  * If executed outside of a browser environment (e.g., in Node.js), the function logs an error and exits.
  * If the `<body>` is not available at the moment the shortcut is triggered, a warning is logged.
  *
+ * -------------------------------------------------
+ *
+ * Any content wrapped inside an `<ai>example</ai>` or `<span class="made-by-ai"></span>` tag was generated purely by artificial intelligence,
+ * without any direct or indirect human intervention during the content generation process.
+ *
+ * -------------------------------------------------
+ *
+ * Any content wrapped inside a `<semi-ai>example</semi-ai>` or `<span class="made-by-semi-ai"></span>` tag was partially generated by artificial
+ * intelligence. In this case, the context of the message was fully shaped by a human source guiding how the content should be written (i.e.,
+ * transforming a purely human text into a polished version enhanced by AI).
+ *
+ * These texts are characterized as improved versions of original human work, where the AI is strictly utilized to enhance the
+ * structure of a human-written text. This tag does **not** apply to texts translated by AI (or any other non-AI translation tools),
+ * nor does it apply to scenarios where an AI minimally refines an existing text by acting solely as a spell checker or basic grammar corrector.
+ *
+ * -------------------------------------------------
+ *
  * @param {Object} [config={}] - Configuration object.
  * @param {string} [config.key='a'] - The lowercase character key to be used in combination with `Ctrl` and `Alt`.
  * @param {string} [config.className='detect-made-by-ai'] - The CSS class to toggle on the `<body>` element.

package/dist/v1/build/TinyClassManager.cjs ADDED Viewed

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

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

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

package/dist/v1/build/TinyClassManager.mjs ADDED Viewed

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

package/dist/v1/css/aiMarker.min.css CHANGED Viewed

	@@ -1 +1 @@
1	- body.detect-made-by-ai .made-by-ai{~~color:#ff0;~~text-shadow:-1px -1px 0 ~~#000~~,1px -1px 0 ~~#000~~,-1px 1px 0 ~~#000~~,1px 1px 0 ~~#000~~}
1	+ :root{--ai-text-color: yellow;--semi-ai-text-color: deepskyblue;--ai-text-shadow-color: #000}ai,semi-ai{display:inline}body.detect-made-by-ai .made-by-ai,body.detect-made-by-ai .made-by-semi-ai,body.detect-made-by-ai ai,body.detect-made-by-ai semi-ai{text-shadow:-1px -1px 0 var(--ai-text-shadow-color),1px -1px 0 var(--ai-text-shadow-color),-1px 1px 0 var(--ai-text-shadow-color),1px 1px 0 var(--ai-text-shadow-color)}body.detect-made-by-ai .made-by-ai,body.detect-made-by-ai ai{color:var(--ai-text-color)}body.detect-made-by-ai .made-by-semi-ai,body.detect-made-by-ai semi-ai{color:var(--semi-ai-text-color)}

package/dist/v1/index.cjs CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

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

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

@@ -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 CHANGED Viewed

@@ -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.
 ---