tiny-essentials 1.28.1 → 1.28.2

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.
    */

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

@@ -1,4 +1,4 @@
-export default TinyClassManager;
+/** @typedef {new (...args: any[]) => any} NewTinyClass */
 export type NewTinyClass = new (...args: any[]) => any;
 export type PluginDefinition<TBase extends NewTinyClass, TExtended extends NewTinyClass, AppliedPluginClasses extends NewTinyClass[]> = {
     /**
@@ -8,13 +8,12 @@ export type PluginDefinition<TBase extends NewTinyClass, TExtended extends NewTi
     /**
      * - Array of plugin names required before applying this one.
      */
-    dependencies?: string[] | undefined;
+    dependencies?: string[];
     /**
      * - Function that receives the base class and returns the extended class.
      */
-    apply: (arg0: TBase, arg1: AppliedPluginClasses) => TExtended;
+    apply: (Base: TBase, classes: AppliedPluginClasses) => TExtended;
 };
-/** @typedef {new (...args: any[]) => any} NewTinyClass */
 /**
  * @template {NewTinyClass} TBase
  * @template {NewTinyClass} TExtended
@@ -22,7 +21,7 @@ export type PluginDefinition<TBase extends NewTinyClass, TExtended extends NewTi
  * @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.
  */
 /**
  * Manages the composition of a base class with multiple optional plugins (Mixins).
@@ -30,12 +29,7 @@ export type PluginDefinition<TBase extends NewTinyClass, TExtended extends NewTi
  * @template {T|NewTinyClass} oldT
  */
 declare class TinyClassManager<T extends NewTinyClass, oldT extends T | NewTinyClass> {
-    /**
-     * Initializes the manager with a core class.
-     * @param {T} coreClass - The foundational class to be extended.
-     * @param {oldT[]} [oldClasses=[]]
-     */
-    constructor(coreClass: T, oldClasses?: oldT[]);
+    #private;
     /**
      * Gets the list of plugins currently applied to this instance.
      * @returns {string[]} Array of applied plugin names.
@@ -43,7 +37,7 @@ declare class TinyClassManager<T extends NewTinyClass, oldT extends T | NewTinyC
     get appliedPlugins(): string[];
     /**
      * 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(): [...oldT[], T];
     /**
@@ -59,11 +53,17 @@ declare class TinyClassManager<T extends NewTinyClass, oldT extends T | NewTinyC
      * Protects the instance from being consumed or reused after transition.
      */
     get used(): boolean;
+    /**
+     * Initializes the manager with a core class.
+     * @param {T} coreClass - The foundational class to be extended.
+     * @param {oldT[]} [oldClasses=[]]
+     */
+    constructor(coreClass: T, oldClasses?: oldT[]);
     /**
      * 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.
      */
@@ -72,17 +72,17 @@ declare class TinyClassManager<T extends NewTinyClass, oldT extends T | NewTinyC
      * 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.
      */
-    insert<R extends NewTinyClass>(applyFn: (arg0: T, arg1: [...oldT[], T]) => R): TinyClassManager<R, T | oldT>;
+    insert<R extends NewTinyClass>(applyFn: (ClassItem: T, classes: [...oldT[], T]) => R): TinyClassManager<R, T | oldT>;
     /**
      * 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;
 }
+export default TinyClassManager;
 //# sourceMappingURL=TinyClassManager.d.mts.map

package/dist/v1/libs/TinyClassManager.mjs

@@ -6,7 +6,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.
  */
 /**
  * Manages the composition of a base class with multiple optional plugins (Mixins).
@@ -14,7 +14,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.
@@ -30,14 +29,14 @@ class TinyClassManager {
         return [...this.#appliedPlugins];
     }
     /**
-     * @type {AppliedPluginClasses}
+     * @type {[...oldT[], T]}
      * Tracks the classes of successfully applied plugins to prevent duplication and check dependencies.
      */
     // @ts-ignore
     #appliedPluginClasses = [];
     /**
      * 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)
@@ -120,7 +119,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.
      */
@@ -141,7 +140,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.
      */

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

@@ -1,9 +1,14 @@
-export default TinyClipboard;
 /**
  * Utility class to handle clipboard operations for text and blob data.
  * Supports modern Clipboard API, custom platform, and legacy execCommand fallback.
  */
 declare class TinyClipboard {
+    #private;
+    /**
+     * Constructs a new TinyClipboard instance.
+     * Automatically detects and configures available clipboard APIs.
+     */
+    constructor();
     /**
      * Override the default text copy behavior.
      * This allows you to provide your own clipboard implementation or
@@ -102,7 +107,7 @@ declare class TinyClipboard {
      * @param {string|null} [mimeFormat=null] - The MIME type or prefix to match.
      * @returns {Promise<Array<Blob|string>>} A promise resolving with matching data array.
      */
-    readAllData(type?: "text" | "custom" | null, mimeFormat?: string | null): Promise<Array<Blob | string>>;
+    readAllData(type?: 'text' | 'custom' | null, mimeFormat?: string | null): Promise<Array<Blob | string>>;
     /**
      * Read clipboard data at a specific index or all if null.
      *
@@ -152,6 +157,6 @@ declare class TinyClipboard {
      * @returns {((blob: Blob) => Promise<void>) | null} The current blob copy function or null if unavailable.
      */
     getCopyBlobFunc(): ((blob: Blob) => Promise<void>) | null;
-    #private;
 }
+export default TinyClipboard;
 //# sourceMappingURL=TinyClipboard.d.mts.map

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

@@ -1,32 +1,19 @@
-export default TinyColorConverter;
 /**
  * Represents a color in RGBA format.
  * Each element must be a number between 0 and 255.
  * The fourth value represents the alpha (transparency) channel.
+ *
+ * @typedef {number[]} RgbaColor
+ * @property {number} 0 - Red component (0–255)
+ * @property {number} 1 - Green component (0–255)
+ * @property {number} 2 - Blue component (0–255)
+ * @property {number} 3 - Alpha component (0–255)
  */
 export type RgbaColor = number[];
-/**
- * Represents a color in RGB format.
- * Each element must be a number between 0 and 255.
- */
 export type RgbColor = number[];
-/**
- * Represents a color in HSLA format.
- * The fourth value represents the alpha (transparency) channel.
- */
 export type HslaColor = number[];
-/**
- * Represents a color in HSL format.
- */
 export type HslColor = number[];
-/**
- * Represents a hex color.
- */
 export type HexColor = string;
-/**
- * A union type representing various accepted color formats.
- * Can be a hex color string, a numeric value, or an array-based RGB/RGBA representation.
- */
 export type ColorTypes = HexColor | number | RgbColor | RgbaColor;
 export type RgbaResult = {
     /**
@@ -80,17 +67,6 @@ export type HslResult = {
      */
     l: number;
 };
-/**
- * Represents a color in RGBA format.
- * Each element must be a number between 0 and 255.
- * The fourth value represents the alpha (transparency) channel.
- *
- * @typedef {number[]} RgbaColor
- * @property {number} 0 - Red component (0–255)
- * @property {number} 1 - Green component (0–255)
- * @property {number} 2 - Blue component (0–255)
- * @property {number} 3 - Alpha component (0–255)
- */
 /**
  * Represents a color in RGB format.
  * Each element must be a number between 0 and 255.
@@ -156,6 +132,7 @@ export type HslResult = {
  * A class that allows converting colors between all common formats.
  */
 declare class TinyColorConverter {
+    #private;
     /**
      * Generates a smooth gradient of colors based on sine wave patterns.
      *
@@ -392,6 +369,6 @@ declare class TinyColorConverter {
      * @returns {ColorTypes}
      */
     getOriginal(): ColorTypes;
-    #private;
 }
+export default TinyColorConverter;
 //# sourceMappingURL=TinyColorConverter.d.mts.map