tiny-essentials 1.28.1 → 1.28.3

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

@@ -1,4 +1,12 @@
-export default TinyNeedBar;
+/**
+ * @typedef {Object} TickResult
+ * @property {number} prevValue - Infinite value before applying decay.
+ * @property {number} removedTotal - Total amount removed this tick.
+ * @property {number} removedPercent - Percentage of max removed this tick.
+ * @property {number} currentPercent - Current percentage relative to max.
+ * @property {number} remainingValue - Current clamped value (≥ 0).
+ * @property {number} infiniteRemaining - Current infinite value (can be negative).
+ */
 export type TickResult = {
     /**
      * - Infinite value before applying decay.
@@ -25,12 +33,6 @@ export type TickResult = {
      */
     infiniteRemaining: number;
 };
-/**
- * Represents a decay factor applied to the need bar.
- *
- * - `amount`: base value reduced per tick.
- * - `multiplier`: multiplier applied to the amount.
- */
 export type BarFactor = {
     /**
      * - Base reduction value per tick.
@@ -41,12 +43,6 @@ export type BarFactor = {
      */
     multiplier: number;
 };
-/**
- * Represents the serialized state of a TinyNeedBar instance.
- *
- * This object is typically produced by {@link TinyNeedBar#toJSON} and
- * can be used to recreate an instance via {@link TinyNeedBar.fromJSON}.
- */
 export type SerializedData = {
     /**
      * - Maximum value of the bar at the moment of serialization.
@@ -65,15 +61,6 @@ export type SerializedData = {
      */
     factors: Record<string, BarFactor>;
 };
-/**
- * @typedef {Object} TickResult
- * @property {number} prevValue - Infinite value before applying decay.
- * @property {number} removedTotal - Total amount removed this tick.
- * @property {number} removedPercent - Percentage of max removed this tick.
- * @property {number} currentPercent - Current percentage relative to max.
- * @property {number} remainingValue - Current clamped value (≥ 0).
- * @property {number} infiniteRemaining - Current infinite value (can be negative).
- */
 /**
  * Represents a decay factor applied to the need bar.
  *
@@ -108,20 +95,7 @@ export type SerializedData = {
  * - `infiniteValue` → can decrease infinitely into negative numbers.
  */
 declare class TinyNeedBar {
-    /**
-     * Restores a need bar from a serialized object.
-     * @param {SerializedData} data
-     * @returns {TinyNeedBar}
-     */
-    static fromJSON(data: SerializedData): TinyNeedBar;
-    /**
-     * Creates a new need bar instance.
-     *
-     * @param {number} [maxValue=100] - Maximum value of the bar.
-     * @param {number} [baseDecay=1] - Base amount reduced each tick.
-     * @param {number} [baseDecayMulti=1] - Multiplier applied to the base decay.
-     */
-    constructor(maxValue?: number, baseDecay?: number, baseDecayMulti?: number);
+    #private;
     /**
      * Returns a snapshot of all currently active factors.
      * Each factor is returned as a plain object to prevent direct mutation of the internal map.
@@ -169,6 +143,14 @@ declare class TinyNeedBar {
      * @returns {number} Current infinite value.
      */
     get infiniteValue(): number;
+    /**
+     * Creates a new need bar instance.
+     *
+     * @param {number} [maxValue=100] - Maximum value of the bar.
+     * @param {number} [baseDecay=1] - Base amount reduced each tick.
+     * @param {number} [baseDecayMulti=1] - Multiplier applied to the base decay.
+     */
+    constructor(maxValue?: number, baseDecay?: number, baseDecayMulti?: number);
     /**
      * Retrieves a specific factor by its key.
      *
@@ -225,6 +207,12 @@ declare class TinyNeedBar {
      * @returns {SerializedData}
      */
     toJSON(): SerializedData;
+    /**
+     * Restores a need bar from a serialized object.
+     * @param {SerializedData} data
+     * @returns {TinyNeedBar}
+     */
+    static fromJSON(data: SerializedData): TinyNeedBar;
     /**
      * Creates a deep clone of this need bar.
      * @returns {TinyNeedBar}
@@ -234,6 +222,6 @@ declare class TinyNeedBar {
      * Clear the factors map, clearing all factor data.
      */
     clearFactors(): void;
-    #private;
 }
+export default TinyNeedBar;
 //# sourceMappingURL=TinyNeedBar.d.mts.map

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

@@ -1,7 +1,4 @@
-export default TinyNewWinEvents;
-/**
- * A function to handle incoming event payloads.
- */
+import { EventEmitter } from 'events';
 export type handler = (payload: any, event: MessageEvent<any>) => any;
 /**
  * @callback handler
@@ -18,32 +15,20 @@ export type handler = (payload: any, event: MessageEvent<any>) => any;
  *
  * @class
  */
-declare class TinyNewWinEvents extends EventEmitter<any> {
-    /**
-     * Initializes a TinyNewWinEvents instance for communication.
-     *
-     * @param {Object} [settings={}] Configuration object.
-     * @param {string} [settings.targetOrigin] Origin to enforce in postMessage.
-     * @param {string} [settings.url] URL string to open.
-     * @param {string} [settings.name] Window name (required if opening a new window).
-     * @param {string} [settings.features] Features string for `window.open`.
-     *
-     * @throws {Error} If `name` is "_blank", which is not allowed.
-     * @throws {TypeError} If `targetOrigin`, `url`, or `features` are not strings (when provided).
-     * @throws {Error} If the window reference is invalid or already being tracked.
-     */
-    constructor({ targetOrigin, url, name, features }?: {
-        targetOrigin?: string | undefined;
-        url?: string | undefined;
-        name?: string | undefined;
-        features?: string | undefined;
-    });
+declare class TinyNewWinEvents extends EventEmitter {
+    #private;
+    _handleMessage: (event: MessageEvent) => void;
     /**
      * Gets the current destruction status of the instance.
      *
      * @returns {boolean} True if the instance is destroyed, false otherwise.
      */
     get destroyed(): boolean;
+    /**
+     * Gets the internal handshake event name.
+     * @returns {string}
+     */
+    get readyEventName(): string;
     /**
      * Sets the internal handshake event name.
      * @param {string} name
@@ -51,10 +36,10 @@ declare class TinyNewWinEvents extends EventEmitter<any> {
      */
     set readyEventName(name: string);
     /**
-     * Gets the internal handshake event name.
+     * Gets the internal route event name.
      * @returns {string}
      */
-    get readyEventName(): string;
+    get routeEventName(): string;
     /**
      * Sets the internal route event name.
      * @param {string} name
@@ -62,11 +47,24 @@ declare class TinyNewWinEvents extends EventEmitter<any> {
      */
     set routeEventName(name: string);
     /**
-     * Gets the internal route event name.
-     * @returns {string}
+     * Initializes a TinyNewWinEvents instance for communication.
+     *
+     * @param {Object} [settings={}] Configuration object.
+     * @param {string} [settings.targetOrigin] Origin to enforce in postMessage.
+     * @param {string} [settings.url] URL string to open.
+     * @param {string} [settings.name] Window name (required if opening a new window).
+     * @param {string} [settings.features] Features string for `window.open`.
+     *
+     * @throws {Error} If `name` is "_blank", which is not allowed.
+     * @throws {TypeError} If `targetOrigin`, `url`, or `features` are not strings (when provided).
+     * @throws {Error} If the window reference is invalid or already being tracked.
      */
-    get routeEventName(): string;
-    _handleMessage: (event: MessageEvent) => void;
+    constructor({ targetOrigin, url, name, features }?: {
+        targetOrigin?: string;
+        url?: string;
+        name?: string;
+        features?: string;
+    });
     /**
      * Returns the internal window reference.
      *
@@ -122,7 +120,6 @@ declare class TinyNewWinEvents extends EventEmitter<any> {
      * @returns {void}
      */
     destroy(): void;
-    #private;
 }
-import { EventEmitter } from 'events';
+export default TinyNewWinEvents;
 //# sourceMappingURL=TinyNewWinEvents.d.mts.map

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

@@ -1,4 +1,3 @@
-export default TinyNotifications;
 /**
  * A utility class to manage browser notifications with sound and custom behavior.
  * Useful for triggering system notifications with optional sound, avatar icon, body truncation, and click actions.
@@ -6,6 +5,7 @@ export default TinyNotifications;
  * @class
  */
 declare class TinyNotifications {
+    #private;
     /**
      * Constructs a new instance of TinyNotifications.
      *
@@ -17,10 +17,10 @@ declare class TinyNotifications {
      * @throws {TypeError} If any of the parameters are of an invalid type.
      */
     constructor({ audio, defaultIcon, bodyLimit, defaultOnClick, }?: {
-        audio?: string | HTMLAudioElement | null | undefined;
-        defaultIcon?: string | null | undefined;
-        bodyLimit?: number | undefined;
-        defaultOnClick?: ((this: Notification, evt: Event) => any) | undefined;
+        audio?: string | HTMLAudioElement | null;
+        defaultIcon?: string | null;
+        bodyLimit?: number;
+        defaultOnClick?: (this: Notification, evt: Event) => any;
     });
     /**
      * Requests permission from the user to show notifications.
@@ -101,6 +101,6 @@ declare class TinyNotifications {
      * @throws {TypeError} If the value is not a function.
      */
     setDefaultOnClick(value: (this: Notification, evt: Event) => any): void;
-    #private;
 }
+export default TinyNotifications;
 //# sourceMappingURL=TinyNotifications.d.mts.map

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

@@ -1,10 +1,3 @@
-export default TinyNotifyCenter;
-/**
- * Represents a single notification entry.
- *
- * A notification can be provided as a simple string (treated as a plain message),
- * or as an object with additional data such as a title, an avatar image, and a click handler.
- */
 export type NotifyData = string | {
     title?: string;
     message: string;
@@ -42,6 +35,7 @@ export type NotifyData = string | {
  * @class
  */
 declare class TinyNotifyCenter {
+    #private;
     /**
      * Returns the full HTML structure for the notification system as a string.
      *
@@ -72,7 +66,13 @@ declare class TinyNotifyCenter {
      * @param {'beforebegin'|'afterbegin'|'beforeend'|'afterend'} [where='afterbegin']
      * The position relative to `document.body` where the HTML should be inserted.
      */
-    static insertTemplate(where?: "beforebegin" | "afterbegin" | "beforeend" | "afterend"): void;
+    static insertTemplate(where?: 'beforebegin' | 'afterbegin' | 'beforeend' | 'afterend'): void;
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed(): boolean;
     /**
      * Options for configuring the NotificationCenter instance.
      *
@@ -86,17 +86,11 @@ declare class TinyNotifyCenter {
      * @param {HTMLElement} [options.overlay=document.querySelector('.notify-overlay')] - The overlay element that covers the screen when the center is visible.
      */
     constructor(options?: {
-        center?: HTMLElement | undefined;
-        badge?: HTMLElement | undefined;
-        button?: HTMLElement | undefined;
-        overlay?: HTMLElement | undefined;
+        center?: HTMLElement;
+        badge?: HTMLElement;
+        button?: HTMLElement;
+        overlay?: HTMLElement;
     });
-    /**
-     * Gets the current destruction status of the instance.
-     *
-     * @returns {boolean} True if the instance is destroyed, false otherwise.
-     */
-    get destroyed(): boolean;
     /**
      * Enable or disable automatic mark-as-read on close.
      * @param {boolean} value
@@ -112,7 +106,7 @@ declare class TinyNotifyCenter {
      * @param {number} index
      * @returns {'text' | 'html' | null}
      */
-    getItemMode(index: number): "text" | "html" | null;
+    getItemMode(index: number): 'text' | 'html' | null;
     /**
      * Get a notify element by index.
      * @param {number} index
@@ -136,7 +130,7 @@ declare class TinyNotifyCenter {
      * @param {NotifyData} message - Notification content or a full object with title, avatar, and callback.
      * @param {'text'|'html'} [mode='text'] - How to treat the message content.
      */
-    add(message: NotifyData, mode?: "text" | "html"): void;
+    add(message: NotifyData, mode?: 'text' | 'html'): void;
     /**
      * Remove a notify by index.
      * @param {number} index
@@ -176,6 +170,6 @@ declare class TinyNotifyCenter {
      * @returns {void}
      */
     destroy(): void;
-    #private;
 }
+export default TinyNotifyCenter;
 //# sourceMappingURL=TinyNotifyCenter.d.mts.map

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

@@ -1,4 +1,12 @@
-export default TinyPromiseQueue;
+/**
+ * @typedef {Object} QueuedTask
+ * @property {(...args: any[]) => Promise<any>|Promise<any>} task - The async task to execute.
+ * @property {(value: any) => any} resolve - The resolve function from the Promise.
+ * @property {(reason?: any) => any} reject - The reject function from the Promise.
+ * @property {string|undefined} [id] - Optional identifier for the task.
+ * @property {string|null|undefined} [marker] - Optional marker for the task.
+ * @property {number|null|undefined} [delay] - Optional delay (in ms) before the task is executed.
+ */
 export type QueuedTask = {
     /**
      * - The async task to execute.
@@ -25,15 +33,6 @@ export type QueuedTask = {
      */
     delay?: number | null | undefined;
 };
-/**
- * @typedef {Object} QueuedTask
- * @property {(...args: any[]) => Promise<any>|Promise<any>} task - The async task to execute.
- * @property {(value: any) => any} resolve - The resolve function from the Promise.
- * @property {(reason?: any) => any} reject - The reject function from the Promise.
- * @property {string|undefined} [id] - Optional identifier for the task.
- * @property {string|null|undefined} [marker] - Optional marker for the task.
- * @property {number|null|undefined} [delay] - Optional delay (in ms) before the task is executed.
- */
 /**
  * A queue system for managing and executing asynchronous tasks sequentially, one at a time.
  *
@@ -43,6 +42,7 @@ export type QueuedTask = {
  * @class
  */
 declare class TinyPromiseQueue {
+    #private;
     /**
      * Returns whether the queue is currently processing a task.
      *
@@ -105,6 +105,6 @@ declare class TinyPromiseQueue {
      * @throws {Error} Throws if `id` is not a string.
      */
     cancelTask(id: string): boolean;
-    #private;
 }
+export default TinyPromiseQueue;
 //# sourceMappingURL=TinyPromiseQueue.d.mts.map

package/dist/v1/libs/TinyRadioFm.cjs

@@ -7,9 +7,10 @@ var utils = require('./utils.cjs');
 const checkDestroy = utils.createCheckDestroyed('TinyRadioFm');
 
 /**
+ * @typedef {import('../basics/mediaContent.mjs').PictureDataType} PictureDataType
  * @typedef {import('../basics/mediaContent.mjs').MediaContentBase} MediaContentBase
- * @typedef {import('../basics/mediaContent.mjs').MediaContentMetadata} MediaContentMetadata
- * @typedef {import('../basics/mediaContent.mjs').MediaContent} MediaContent
+ * @typedef {import('../basics/mediaContent.mjs').MediaContentMetadata<PictureDataType>} MediaContentMetadata
+ * @typedef {import('../basics/mediaContent.mjs').MediaContent<PictureDataType>} MediaContent
  * @typedef {import('../basics/mediaContent.mjs').IPicture} IPicture
  * @typedef {import('../basics/mediaContent.mjs').MediaNumber} MediaNumber
  * @typedef {import('../basics/mediaContent.mjs').MediaLoadingError} MediaLoadingError
@@ -600,7 +601,7 @@ class TinyRadioFm extends events.EventEmitter {
 
     /**
      * Filter function to match items against the provided ID.
-     * @type {function(any): boolean}
+     * @type {(item: any) => boolean}
      */
     const filterFn = (item) => item.id !== id && item.content?.id !== id;
 
@@ -726,10 +727,18 @@ class TinyRadioFm extends events.EventEmitter {
         const newItem = structuredClone(item);
         if (newItem.picture && Array.isArray(newItem.picture)) {
           newItem.picture = await Promise.all(
-            newItem.picture.map(async (pic) => ({
-              ...pic,
-              data: await mediaContent.blobUrlToBase64(pic.data),
-            })),
+            newItem.picture.map(async (pic) => {
+              // Only performs the asynchronous conversion if it really is a Blob URL
+              if (typeof pic.data === 'string' && pic.data.startsWith('blob:')) {
+                return {
+                  ...pic,
+                  data: await mediaContent.blobUrlToBase64(pic.data),
+                };
+              }
+
+              // If it is a normal URL, skip the process and keep it as it is
+              return pic;
+            }),
           );
         }
         return newItem;
@@ -826,7 +835,7 @@ class TinyRadioFm extends events.EventEmitter {
   /**
    * Mulberry32 Pseudo-Random Number Generator.
    * @param {number} seed - The initialization seed.
-   * @returns {function(): number} PRNG function returning a float between 0 and 1.
+   * @returns {() => number} PRNG function returning a float between 0 and 1.
    * @private
    */
   _prng(seed) {
@@ -1340,10 +1349,21 @@ class TinyRadioFm extends events.EventEmitter {
       return list.map((item) => {
         const newItem = { ...item };
         if (newItem.picture && Array.isArray(newItem.picture)) {
-          newItem.picture = newItem.picture.map((pic) => ({
-            ...pic,
-            data: mediaContent.convertToBlobUrl(pic.data, pic.format),
-          }));
+          newItem.picture = newItem.picture.map((pic) => {
+            // Check whether the data is compatible with the Blob structure (Base64 or Binary)
+            const isBase64 = typeof pic.data === 'string' && pic.data.startsWith('data:');
+            const isUint8Array = pic.data instanceof Uint8Array;
+
+            if (isBase64 || isUint8Array) {
+              return {
+                ...pic,
+                data: mediaContent.convertToBlobUrl(pic.data, pic.format),
+              };
+            }
+
+            // If it is a default web URL or local file, use the URL directly
+            return pic;
+          });
         }
         return newItem;
       });