tiny-essentials 1.28.0 → 1.28.2

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

@@ -165,6 +165,7 @@ class TinyClipboard {
    * @param {string|null} [mimeFormat=null] - MIME type or prefix.
    * @param {boolean} [fixValue=false] - If true, exact match on MIME type.
    * @returns {Promise<Blob|string|Array<Blob|string>|null>} A promise resolving with matching data.
+   * @private
    */
   _readData(index = 0, type = null, mimeFormat = null, fixValue = false) {
     return new Promise((resolve, reject) => {
@@ -326,6 +327,7 @@ class TinyClipboard {
    *
    * @param {number|null} index - Index of the item to retrieve or null to get all.
    * @returns {Promise<ClipboardItem|ClipboardItems|null>} A promise resolving with a clipboard item or array of items.
+   * @private
    */
   _read(index) {
     return new Promise((resolve, reject) => {

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
@@ -62,8 +67,9 @@ declare class TinyClipboard {
      * @param {string|null} [mimeFormat=null] - MIME type or prefix.
      * @param {boolean} [fixValue=false] - If true, exact match on MIME type.
      * @returns {Promise<Blob|string|Array<Blob|string>|null>} A promise resolving with matching data.
+     * @private
      */
-    _readData(index?: number | null, type?: "text" | "custom" | null, mimeFormat?: string | null, fixValue?: boolean): Promise<Blob | string | Array<Blob | string> | null>;
+    private _readData;
     /**
      * Read plain text from the clipboard (single item by index).
      *
@@ -101,14 +107,15 @@ 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.
      *
      * @param {number|null} index - Index of the item to retrieve or null to get all.
      * @returns {Promise<ClipboardItem|ClipboardItems|null>} A promise resolving with a clipboard item or array of items.
+     * @private
      */
-    _read(index: number | null): Promise<ClipboardItem | ClipboardItems | null>;
+    private _read;
     /**
      * Read clipboard data at a specific index.
      *
@@ -150,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/TinyClipboard.mjs

@@ -152,6 +152,7 @@ class TinyClipboard {
      * @param {string|null} [mimeFormat=null] - MIME type or prefix.
      * @param {boolean} [fixValue=false] - If true, exact match on MIME type.
      * @returns {Promise<Blob|string|Array<Blob|string>|null>} A promise resolving with matching data.
+     * @private
      */
     _readData(index = 0, type = null, mimeFormat = null, fixValue = false) {
         return new Promise((resolve, reject) => {
@@ -307,6 +308,7 @@ class TinyClipboard {
      *
      * @param {number|null} index - Index of the item to retrieve or null to get all.
      * @returns {Promise<ClipboardItem|ClipboardItems|null>} A promise resolving with a clipboard item or array of items.
+     * @private
      */
     _read(index) {
         return new Promise((resolve, reject) => {

package/dist/v1/libs/TinyColorConverter.cjs

@@ -94,6 +94,7 @@ class TinyColorConverter {
    * @param {'rgb'|'hex'|'hsl'} [type='rgb'] - The format of the colors returned: `'rgb'`, `'hex'`, or `'hsl'`.
    * @param {boolean} [pastel=false] - If true, generates pastel tones by adjusting the intensity and offset.
    * @returns {Array<RgbResult|HexResult|HslResult>} An array of color values in the selected format:
+   * @private
    */
   static _rca(len, type, pastel) {
     let eq1 = 127;

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.
      *
@@ -164,8 +141,9 @@ declare class TinyColorConverter {
      * @param {'rgb'|'hex'|'hsl'} [type='rgb'] - The format of the colors returned: `'rgb'`, `'hex'`, or `'hsl'`.
      * @param {boolean} [pastel=false] - If true, generates pastel tones by adjusting the intensity and offset.
      * @returns {Array<RgbResult|HexResult|HslResult>} An array of color values in the selected format:
+     * @private
      */
-    static _rca(len?: number, type?: "rgb" | "hex" | "hsl", pastel?: boolean): Array<RgbResult | HexResult | HslResult>;
+    private static _rca;
     /**
      * Generates a smooth gradient of colors based on sine wave patterns.
      *
@@ -391,6 +369,6 @@ declare class TinyColorConverter {
      * @returns {ColorTypes}
      */
     getOriginal(): ColorTypes;
-    #private;
 }
+export default TinyColorConverter;
 //# sourceMappingURL=TinyColorConverter.d.mts.map

package/dist/v1/libs/TinyColorConverter.mjs

@@ -82,6 +82,7 @@ class TinyColorConverter {
      * @param {'rgb'|'hex'|'hsl'} [type='rgb'] - The format of the colors returned: `'rgb'`, `'hex'`, or `'hsl'`.
      * @param {boolean} [pastel=false] - If true, generates pastel tones by adjusting the intensity and offset.
      * @returns {Array<RgbResult|HexResult|HslResult>} An array of color values in the selected format:
+     * @private
      */
     static _rca(len, type, pastel) {
         let eq1 = 127;