tiny-essentials 1.28.0 → 1.28.2

package/dist/v1/libs/TinyAnalogClock.mjs

@@ -1,3 +1,5 @@
+import { createCheckDestroyed } from './utils.mjs';
+const checkDestroy = createCheckDestroyed('TinyAnalogClock');
 /**
  * Configuration object for the Analog Clock.
  * @typedef {Object} ClockConfig
@@ -32,6 +34,19 @@ class TinyAnalogClock {
     #config;
     /** @type {number|null} */
     #animationFrame = null;
+    /**
+     * Tracks whether the instance has been destroyed.
+     * @type {boolean}
+     */
+    #destroyed = false;
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed() {
+        return this.#destroyed;
+    }
     /**
      * Retrieves the current date and extracts the specific hour, minute, and second components.
      * @returns {{ now: Date, s: number, m: number, h: number }}
@@ -297,6 +312,7 @@ class TinyAnalogClock {
      * @returns {HTMLElement} The clock container.
      */
     get element() {
+        checkDestroy(this.#destroyed);
         return this.#element;
     }
     /**
@@ -305,6 +321,7 @@ class TinyAnalogClock {
      * @throws {Error} If value is not a positive number.
      */
     set size(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'number' || value <= 0 || isNaN(value)) {
             throw new Error(`TinyAnalogClock: 'size' must be a positive number. Received: ${value}`);
         }
@@ -316,6 +333,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get size() {
+        checkDestroy(this.#destroyed);
         return this.#config.size;
     }
     /**
@@ -324,6 +342,7 @@ class TinyAnalogClock {
      * @throws {Error} If value is not a string or null.
      */
     set skinUrl(url) {
+        checkDestroy(this.#destroyed);
         if (url !== null && typeof url !== 'string') {
             throw new Error(`TinyAnalogClock: 'skin' must be a URL string or null. Received type: ${typeof url}`);
         }
@@ -335,6 +354,7 @@ class TinyAnalogClock {
      * @returns {string|null}
      */
     get skinUrl() {
+        checkDestroy(this.#destroyed);
         return this.#config.skinUrl;
     }
     /**
@@ -343,6 +363,7 @@ class TinyAnalogClock {
      * @throws {Error} If value is not a non-empty string.
      */
     set borderColor(color) {
+        checkDestroy(this.#destroyed);
         if (typeof color !== 'string' || color.trim() === '') {
             throw new Error(`TinyAnalogClock: 'borderColor' must be a non-empty string. Received: ${color}`);
         }
@@ -355,6 +376,7 @@ class TinyAnalogClock {
      * @returns {string}
      */
     get borderColor() {
+        checkDestroy(this.#destroyed);
         return this.#config.borderColor;
     }
     /**
@@ -363,6 +385,7 @@ class TinyAnalogClock {
      * @throws {Error} If value is not a non-empty string.
      */
     set markColor(color) {
+        checkDestroy(this.#destroyed);
         if (typeof color !== 'string' || color.trim() === '') {
             throw new Error(`TinyAnalogClock: 'markColor' must be a non-empty string. Received: ${color}`);
         }
@@ -375,6 +398,7 @@ class TinyAnalogClock {
      * @returns {string}
      */
     get markColor() {
+        checkDestroy(this.#destroyed);
         return this.#config.markColor;
     }
     /**
@@ -383,6 +407,7 @@ class TinyAnalogClock {
      * @throws {Error} If value is not a non-empty string.
      */
     set textColor(color) {
+        checkDestroy(this.#destroyed);
         if (typeof color !== 'string' || color.trim() === '') {
             throw new Error(`TinyAnalogClock: 'textColor' must be a non-empty string. Received: ${color}`);
         }
@@ -395,6 +420,7 @@ class TinyAnalogClock {
      * @returns {string}
      */
     get textColor() {
+        checkDestroy(this.#destroyed);
         return this.#config.textColor;
     }
     /**
@@ -403,6 +429,7 @@ class TinyAnalogClock {
      * @throws {Error} If value is not a boolean.
      */
     set showNumbers(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'boolean') {
             throw new Error(`TinyAnalogClock: 'showNumbers' must be a boolean. Received type: ${typeof value}`);
         }
@@ -414,6 +441,7 @@ class TinyAnalogClock {
      * @returns {boolean}
      */
     get showNumbers() {
+        checkDestroy(this.#destroyed);
         return this.#config.showNumbers;
     }
     /**
@@ -421,6 +449,7 @@ class TinyAnalogClock {
      * @param {string} value
      */
     set bgColor(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'string' || !value)
             throw new Error("TinyAnalogClock: 'bgColor' must be a non-empty string.");
         this.#config.bgColor = value;
@@ -431,6 +460,7 @@ class TinyAnalogClock {
      * @returns {string}
      */
     get bgColor() {
+        checkDestroy(this.#destroyed);
         return this.#config.bgColor;
     }
     /**
@@ -438,6 +468,7 @@ class TinyAnalogClock {
      * @param {number} value
      */
     set borderWidth(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'number' || value < 0)
             throw new Error("TinyAnalogClock: 'borderWidth' must be a non-negative number.");
         this.#config.borderWidth = value;
@@ -449,6 +480,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get borderWidth() {
+        checkDestroy(this.#destroyed);
         return this.#config.borderWidth;
     }
     /**
@@ -456,6 +488,7 @@ class TinyAnalogClock {
      * @param {string} value
      */
     set hourHandColor(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'string' || !value)
             throw new Error("TinyAnalogClock: 'hourHandColor' must be a non-empty string.");
         this.#config.hourHandColor = value;
@@ -466,6 +499,7 @@ class TinyAnalogClock {
      * @returns {string}
      */
     get hourHandColor() {
+        checkDestroy(this.#destroyed);
         return this.#config.hourHandColor;
     }
     /**
@@ -473,6 +507,7 @@ class TinyAnalogClock {
      * @param {string} value
      */
     set minuteHandColor(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'string' || !value)
             throw new Error("TinyAnalogClock: 'minuteHandColor' must be a non-empty string.");
         this.#config.minuteHandColor = value;
@@ -483,6 +518,7 @@ class TinyAnalogClock {
      * @returns {string}
      */
     get minuteHandColor() {
+        checkDestroy(this.#destroyed);
         return this.#config.minuteHandColor;
     }
     /**
@@ -490,6 +526,7 @@ class TinyAnalogClock {
      * @param {string} value
      */
     set secondHandColor(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'string' || !value)
             throw new Error("TinyAnalogClock: 'secondHandColor' must be a non-empty string.");
         this.#config.secondHandColor = value;
@@ -500,6 +537,7 @@ class TinyAnalogClock {
      * @returns {string}
      */
     get secondHandColor() {
+        checkDestroy(this.#destroyed);
         return this.#config.secondHandColor;
     }
     /**
@@ -507,6 +545,7 @@ class TinyAnalogClock {
      * @param {boolean} value
      */
     set showSeconds(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'boolean')
             throw new Error("TinyAnalogClock: 'showSeconds' must be a boolean.");
         this.#config.showSeconds = value;
@@ -517,6 +556,7 @@ class TinyAnalogClock {
      * @returns {boolean}
      */
     get showSeconds() {
+        checkDestroy(this.#destroyed);
         return this.#config.showSeconds;
     }
     /**
@@ -524,6 +564,7 @@ class TinyAnalogClock {
      * @param {number} value - Positive number.
      */
     set sizeAdjust(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'number' || value <= 0)
             throw new Error("TinyAnalogClock: 'sizeAdjust' must be a positive number.");
         this.#config.sizeAdjust = value;
@@ -534,6 +575,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get sizeAdjust() {
+        checkDestroy(this.#destroyed);
         return this.#config.sizeAdjust;
     }
     /**
@@ -541,6 +583,7 @@ class TinyAnalogClock {
      * @param {number} value - Non-negative number in pixels.
      */
     set padding(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'number' || value < 0)
             throw new Error("TinyAnalogClock: 'padding' must be a non-negative number.");
         this.#config.padding = value;
@@ -551,6 +594,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get padding() {
+        checkDestroy(this.#destroyed);
         return this.#config.padding;
     }
     /**
@@ -558,6 +602,7 @@ class TinyAnalogClock {
      * @param {number} value - Positive number.
      */
     set angleDistance(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'number' || value <= 0)
             throw new Error("TinyAnalogClock: 'angleDistance' must be a positive number.");
         this.#config.angleDistance = value;
@@ -568,6 +613,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get angleDistance() {
+        checkDestroy(this.#destroyed);
         return this.#config.angleDistance;
     }
     /**
@@ -575,6 +621,7 @@ class TinyAnalogClock {
      * @param {number} value - Positive number.
      */
     set pwH(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'number' || value <= 0)
             throw new Error("TinyAnalogClock: 'pwH' must be a positive number.");
         this.#config.pwH = value;
@@ -585,6 +632,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get pwH() {
+        checkDestroy(this.#destroyed);
         return this.#config.pwH;
     }
     /**
@@ -592,6 +640,7 @@ class TinyAnalogClock {
      * @param {number} value - Positive number.
      */
     set phH(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'number' || value <= 0)
             throw new Error("TinyAnalogClock: 'phH' must be a positive number.");
         this.#config.phH = value;
@@ -602,6 +651,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get phH() {
+        checkDestroy(this.#destroyed);
         return this.#config.phH;
     }
     /**
@@ -609,6 +659,7 @@ class TinyAnalogClock {
      * @param {number} value - Positive number.
      */
     set pwM(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'number' || value <= 0)
             throw new Error("TinyAnalogClock: 'pwM' must be a positive number.");
         this.#config.pwM = value;
@@ -619,6 +670,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get pwM() {
+        checkDestroy(this.#destroyed);
         return this.#config.pwM;
     }
     /**
@@ -626,6 +678,7 @@ class TinyAnalogClock {
      * @param {number} value - Positive number.
      */
     set phM(value) {
+        checkDestroy(this.#destroyed);
         if (typeof value !== 'number' || value <= 0)
             throw new Error("TinyAnalogClock: 'phM' must be a positive number.");
         this.#config.phM = value;
@@ -636,6 +689,7 @@ class TinyAnalogClock {
      * @returns {number}
      */
     get phM() {
+        checkDestroy(this.#destroyed);
         return this.#config.phM;
     }
     /**
@@ -643,11 +697,14 @@ class TinyAnalogClock {
      * @returns {void}
      */
     destroy() {
+        if (this.#destroyed)
+            return;
         if (this.#animationFrame) {
             cancelAnimationFrame(this.#animationFrame);
             this.#animationFrame = null;
         }
         this.#element.remove();
+        this.#destroyed = true;
     }
 }
 export default TinyAnalogClock;

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

@@ -1,8 +1,8 @@
-export default TinyArrayComparator;
 /**
- * Holds the internal tracking variables during the comparison process.
+ * @fileoverview Array comparison utility.
+ * @module TinyArrayComparator
  */
-export type InternalState<ArrayItem extends unknown> = {
+export type InternalState<ArrayItem extends any> = {
     /**
      * - A map storing the hash as the key and the original item as the value.
      */
@@ -12,17 +12,10 @@ export type InternalState<ArrayItem extends unknown> = {
      */
     affectedItems: AffectedItems<ArrayItem>;
 };
-/**
- * The final array that collects added or deleted items.
- */
-export type AffectedItems<ArrayItem extends unknown> = Array<{
+export type AffectedItems<ArrayItem extends any> = Array<{
     item: ArrayItem;
-    status: "added" | "deleted";
+    status: 'added' | 'deleted';
 }>;
-/**
- * @fileoverview Array comparison utility.
- * @module TinyArrayComparator
- */
 /**
  * @template {any} ArrayItem
  * @typedef {Object} InternalState
@@ -39,7 +32,8 @@ export type AffectedItems<ArrayItem extends unknown> = Array<{
  * Compares two arrays efficiently by hashing their items to detect additions and deletions.
  * @template {any} ArrayItem
  */
-declare class TinyArrayComparator<ArrayItem extends unknown> {
+declare class TinyArrayComparator<ArrayItem extends any> {
+    #private;
     /**
      * Generates a simple 32-bit integer hash converted to a base36 string.
      * @param {any} item - The item to be hashed (can be an object, array, string, or number).
@@ -47,10 +41,10 @@ declare class TinyArrayComparator<ArrayItem extends unknown> {
      */
     static generateHash(item: any): string;
     /**
-     * Initializes the comparator with an optional base array.
-     * @param {ArrayItem[]} [oldArray] - The initial state of the array to be stored.
+     * Gets the current base array used for comparisons.
+     * @returns {ArrayItem[]} The current initial state of the array.
      */
-    constructor(oldArray?: ArrayItem[]);
+    get oldArray(): ArrayItem[];
     /**
      * Sets a new base array for future comparisons.
      * @param {ArrayItem[]} oldArray - The initial state of the array.
@@ -58,10 +52,10 @@ declare class TinyArrayComparator<ArrayItem extends unknown> {
      */
     set oldArray(oldArray: ArrayItem[]);
     /**
-     * Gets the current base array used for comparisons.
-     * @returns {ArrayItem[]} The current initial state of the array.
+     * Initializes the comparator with an optional base array.
+     * @param {ArrayItem[]} [oldArray] - The initial state of the array to be stored.
      */
-    get oldArray(): ArrayItem[];
+    constructor(oldArray?: ArrayItem[]);
     /**
      * Proxy to generates a hash converted to a string.
      * @param {ArrayItem} item - The item to be hashed (can be an object, array, string, or number).
@@ -77,6 +71,6 @@ declare class TinyArrayComparator<ArrayItem extends unknown> {
      * @throws {TypeError} Throws an error if the provided value is not an array.
      */
     compare(newArray: ArrayItem[]): AffectedItems<ArrayItem>;
-    #private;
 }
+export default TinyArrayComparator;
 //# sourceMappingURL=TinyArrayComparator.d.mts.map

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

@@ -1,10 +1,16 @@
-export default TinyArrayPaginator;
 /**
  * A predicate function used to determine whether an item should be included in the filtered results.
  * Works similarly to the callback function of `Array.prototype.filter`.
+ *
+ * @template {any} ArrayItem
+ * @callback GetFilter
+ * @param {ArrayItem} value - The current element being processed in the array.
+ * @param {number} index - The index of the current element within the array.
+ * @param {ArrayItem[]} array - The full array being processed.
+ * @returns {boolean} Returns `true` to include the element in the results, or `false` to exclude it.
  */
-export type GetFilter<ArrayItem extends unknown> = (value: ArrayItem, index: number, array: ArrayItem[]) => boolean;
-export type GetterResult<ArrayItem extends unknown> = {
+export type GetFilter<ArrayItem extends any> = (value: ArrayItem, index: number, array: ArrayItem[]) => boolean;
+export type GetterResult<ArrayItem extends any> = {
     /**
      * - The subset of items for the requested page.
      */
@@ -34,17 +40,6 @@ export type GetterResult<ArrayItem extends unknown> = {
      */
     hasNext: boolean;
 };
-/**
- * A predicate function used to determine whether an item should be included in the filtered results.
- * Works similarly to the callback function of `Array.prototype.filter`.
- *
- * @template {any} ArrayItem
- * @callback GetFilter
- * @param {ArrayItem} value - The current element being processed in the array.
- * @param {number} index - The index of the current element within the array.
- * @param {ArrayItem[]} array - The full array being processed.
- * @returns {boolean} Returns `true` to include the element in the results, or `false` to exclude it.
- */
 /**
  * @template {any} ArrayItem
  * @typedef {Object} GetterResult
@@ -62,29 +57,30 @@ export type GetterResult<ArrayItem extends unknown> = {
  * while keeping the source array safe from direct modifications.
  * @template {any} ArrayItem
  */
-declare class TinyArrayPaginator<ArrayItem extends unknown> {
+declare class TinyArrayPaginator<ArrayItem extends any> {
+    #private;
     /**
-     * Creates a new paginator instance for the given data array.
-     * @param {ArrayItem[]|Set<ArrayItem>} data - The array to be paginated.
-     * @throws {TypeError} If the provided data is not an array.
+     * Gets current stored array.
+     * @returns {ArrayItem[]|Set<ArrayItem>}
      */
-    constructor(data: ArrayItem[] | Set<ArrayItem>);
+    get data(): ArrayItem[] | Set<ArrayItem>;
     /**
      * Replaces the current data array.
      * @param {ArrayItem[]|Set<ArrayItem>} value - The new array to be used as the data source.
      * @throws {TypeError} If the provided value is not an array.
      */
     set data(value: ArrayItem[] | Set<ArrayItem>);
-    /**
-     * Gets current stored array.
-     * @returns {ArrayItem[]|Set<ArrayItem>}
-     */
-    get data(): ArrayItem[] | Set<ArrayItem>;
     /**
      * Gets the total number of items in the current data array.
      * @returns {number} Total number of stored items.
      */
     get size(): number;
+    /**
+     * Creates a new paginator instance for the given data array.
+     * @param {ArrayItem[]|Set<ArrayItem>} data - The array to be paginated.
+     * @throws {TypeError} If the provided data is not an array.
+     */
+    constructor(data: ArrayItem[] | Set<ArrayItem>);
     /**
      * Filters data according to a search query and returns paginated results.
      * @param {Object} settings
@@ -98,8 +94,8 @@ declare class TinyArrayPaginator<ArrayItem extends unknown> {
     get({ page, perPage, filter }: {
         page: number;
         perPage: number;
-        filter?: Record<string, RegExp | ArrayItem> | GetFilter<ArrayItem> | undefined;
+        filter?: Record<string, ArrayItem | RegExp> | GetFilter<ArrayItem>;
     }): GetterResult<ArrayItem>;
-    #private;
 }
+export default TinyArrayPaginator;
 //# sourceMappingURL=TinyArrayPaginator.d.mts.map

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

@@ -1,4 +1,3 @@
-export default TinyPluginInliner;
 export type RootReplacement = {
     /**
      * - The directory name to replace (e.g., 'src').
@@ -25,7 +24,7 @@ export type InlinerConfig = {
     /**
      * - Optional customization to remap project import roots.
      */
-    rootReplacement?: RootReplacement | undefined;
+    rootReplacement?: RootReplacement;
 };
 /**
  * @typedef {Object} RootReplacement
@@ -40,12 +39,6 @@ export type InlinerConfig = {
  * @property {RootReplacement} [rootReplacement] - Optional customization to remap project import roots.
  */
 declare class TinyPluginInliner {
-    /**
-     * Creates an instance of the TinyPluginInliner.
-     *
-     * @param {InlinerConfig} config - The configuration object for the build process.
-     */
-    constructor(config: InlinerConfig);
     config: InlinerConfig;
     entryFile: string;
     outDir: string;
@@ -53,6 +46,12 @@ declare class TinyPluginInliner {
     entryDir: string;
     hoistedImports: Set<any>;
     hoistedTypedefs: Set<any>;
+    /**
+     * Creates an instance of the TinyPluginInliner.
+     *
+     * @param {InlinerConfig} config - The configuration object for the build process.
+     */
+    constructor(config: InlinerConfig);
     /**
      * Rewrites all import paths (both standard and inside JSDocs) in a given code string.
      * Handles local path root replacements and NPM package absolute path conversion.
@@ -89,4 +88,5 @@ declare class TinyPluginInliner {
      */
     build(): Promise<void>;
 }
+export default TinyPluginInliner;
 //# sourceMappingURL=TinyPluginInliner.d.mts.map

package/dist/v1/libs/TinyClassManager.cjs

@@ -9,7 +9,7 @@
  * @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, AppliedPluginClasses): TExtended} apply - Function that receives the base class and returns the extended class.
+ * @property {(Base: TBase, classes: AppliedPluginClasses) => TExtended} apply - Function that receives the base class and returns the extended class.
  */
 
 /**
@@ -18,8 +18,6 @@
  * @template {T|NewTinyClass} oldT
  */
 class TinyClassManager {
-  /** @typedef {[...oldT[], T]} AppliedPluginClasses */
-
   /**
    * @type {Set<string>}
    * Tracks the names of successfully applied plugins to prevent duplication and check dependencies.
@@ -36,7 +34,7 @@ class TinyClassManager {
   }
 
   /**
-   * @type {AppliedPluginClasses}
+   * @type {[...oldT[], T]}
    * Tracks the classes of successfully applied plugins to prevent duplication and check dependencies.
    */
   // @ts-ignore
@@ -44,7 +42,7 @@ class TinyClassManager {
 
   /**
    * Gets the list of plugin classes currently applied to this instance.
-   * @returns {AppliedPluginClasses} Array of applied plugin classes.
+   * @returns {[...oldT[], T]} Array of applied plugin classes.
    */
   get appliedPluginClasses() {
     if (this.#used) throw new Error(`[TinyClassManager] Cannot get a consumed manager instance.`);
@@ -140,7 +138,7 @@ class TinyClassManager {
    * Applies a plugin to the class chain using a definition object.
    * @deprecated Use {@link insert} instead.
    * @template {NewTinyClass} R
-   * @param {PluginDefinition<T, R, AppliedPluginClasses>} plugin - The plugin module to be integrated.
+   * @param {PluginDefinition<T, R, [...oldT[], T]>} plugin - The plugin module to be integrated.
    * @returns {TinyClassManager<R, T | oldT>} A new manager instance holding the extended class chain.
    * @throws {Error} Throws if instance is already consumed, plugin is duplicate, or dependencies are missing.
    */
@@ -164,7 +162,7 @@ class TinyClassManager {
    * Inserts a plugin directly by passing its apply function.
    * It reads `_tinyDepName` and `_tinyDeps` statically from the returned class.
    * @template {NewTinyClass} R
-   * @param {function(T, AppliedPluginClasses): R} applyFn - Function that receives the base class and returns the extended class.
+   * @param {(ClassItem: T, classes: [...oldT[], T]) => R} applyFn - Function that receives the base class and returns the extended class.
    * @returns {TinyClassManager<R, T | oldT>} A new manager instance holding the extended class chain.
    * @throws {Error} Throws if static properties are missing, instance is consumed, or validation fails.
    */