tiny-essentials 1.28.19 → 1.29.0

package/dist/v1/libs/fs/stats.d.mts

@@ -0,0 +1,226 @@
+/**
+ * @file Immutable metadata snapshots returned by {@link TinyFSCore#stat}.
+ */
+export type FSEntryKind = 'file' | 'directory' | 'symbolic-link';
+export type FSStatDescriptor = {
+    /**
+     * Base name of the entry.
+     */
+    name: string;
+    /**
+     * Entry kind.
+     */
+    kind: FSEntryKind;
+    /**
+     * Size in bytes. Ignored for directories.
+     */
+    size: number;
+    /**
+     * Last modification time in milliseconds since the epoch.
+     */
+    mtimeMs: number;
+};
+export type FSDirectoryEntry = {
+    /**
+     * Base name of the entry.
+     */
+    name: string;
+    /**
+     * Entry kind.
+     */
+    kind: FSEntryKind;
+};
+export type FSMetadata = {
+    /**
+     * POSIX permission bits, or `null` when unset.
+     */
+    mode: number | null;
+    /**
+     * Owner user id.
+     */
+    uid: number | null;
+    /**
+     * Owner group id.
+     */
+    gid: number | null;
+    /**
+     * Last access time in milliseconds since the epoch.
+     */
+    atimeMs: number | null;
+    /**
+     * Last modification time in milliseconds since the epoch.
+     */
+    mtimeMs: number | null;
+    /**
+     * Creation time in milliseconds since the epoch.
+     */
+    birthtimeMs: number | null;
+};
+export type StatsOptions = {
+    /**
+     * Absolute path of the entry.
+     */
+    path: string;
+    /**
+     * Base name of the entry.
+     */
+    name: string;
+    /**
+     * Entry kind.
+     */
+    kind: FSEntryKind;
+    /**
+     * Size in bytes.
+     */
+    size: number;
+    /**
+     * POSIX permission bits.
+     */
+    mode: number;
+    /**
+     * Owner user id.
+     */
+    uid: number;
+    /**
+     * Owner group id.
+     */
+    gid: number;
+    /**
+     * Last access time in milliseconds since the epoch.
+     */
+    atimeMs: number;
+    /**
+     * Last modification time in milliseconds since the epoch.
+     */
+    mtimeMs: number;
+    /**
+     * Creation time in milliseconds since the epoch.
+     */
+    birthtimeMs: number;
+    /**
+     * Inode number. `0` when the backend has no inodes.
+     */
+    ino: number;
+};
+/**
+ * @typedef {'file' | 'directory' | 'symbolic-link'} FSEntryKind
+ */
+/**
+ * @typedef {Object} FSStatDescriptor
+ * @property {string} name Base name of the entry.
+ * @property {FSEntryKind} kind Entry kind.
+ * @property {number} size Size in bytes. Ignored for directories.
+ * @property {number} mtimeMs Last modification time in milliseconds since the epoch.
+ */
+/**
+ * @typedef {Object} FSDirectoryEntry
+ * @property {string} name Base name of the entry.
+ * @property {FSEntryKind} kind Entry kind.
+ */
+/**
+ * @typedef {Object} FSMetadata
+ * @property {number | null} mode POSIX permission bits, or `null` when unset.
+ * @property {number | null} uid Owner user id.
+ * @property {number | null} gid Owner group id.
+ * @property {number | null} atimeMs Last access time in milliseconds since the epoch.
+ * @property {number | null} mtimeMs Last modification time in milliseconds since the epoch.
+ * @property {number | null} birthtimeMs Creation time in milliseconds since the epoch.
+ */
+/**
+ * @typedef {Object} StatsOptions
+ * @property {string} path Absolute path of the entry.
+ * @property {string} name Base name of the entry.
+ * @property {FSEntryKind} kind Entry kind.
+ * @property {number} size Size in bytes.
+ * @property {number} mode POSIX permission bits.
+ * @property {number} uid Owner user id.
+ * @property {number} gid Owner group id.
+ * @property {number} atimeMs Last access time in milliseconds since the epoch.
+ * @property {number} mtimeMs Last modification time in milliseconds since the epoch.
+ * @property {number} birthtimeMs Creation time in milliseconds since the epoch.
+ * @property {number} ino Inode number. `0` when the backend has no inodes.
+ */
+/**
+ * Immutable snapshot of a file system entry, shaped like `node:fs.Stats`.
+ */
+export declare class Stats {
+    #private;
+    /**
+     * @param {StatsOptions} options Snapshot values.
+     */
+    constructor(options: StatsOptions);
+    /** @returns {string} Absolute path of the entry. */
+    get path(): string;
+    /** @returns {string} Base name of the entry. */
+    get name(): string;
+    /** @returns {number} Size in bytes, or `0` for directories. */
+    get size(): number;
+    /** @returns {number} POSIX permission bits. */
+    get mode(): number;
+    /** @returns {number} Owner user id. */
+    get uid(): number;
+    /** @returns {number} Owner group id. */
+    get gid(): number;
+    /** @returns {number} Inode number, or `0` when unsupported. */
+    get ino(): number;
+    /** @returns {number} Number of hard links. Always `1`. */
+    get nlink(): number;
+    /** @returns {number} Last access time in milliseconds since the epoch. */
+    get atimeMs(): number;
+    /** @returns {number} Last modification time in milliseconds since the epoch. */
+    get mtimeMs(): number;
+    /** @returns {number} Creation time in milliseconds since the epoch. */
+    get birthtimeMs(): number;
+    /** @returns {Date} Last access time. */
+    get atime(): Date;
+    /** @returns {Date} Last modification time. */
+    get mtime(): Date;
+    /** @returns {Date} Change time. Alias of `mtime`. */
+    get ctime(): Date;
+    /** @returns {Date} Creation time. */
+    get birthtime(): Date;
+    /** @returns {boolean} `true` when the entry is a regular file. */
+    isFile(): boolean;
+    /** @returns {boolean} `true` when the entry is a directory. */
+    isDirectory(): boolean;
+    /** @returns {boolean} `true` when the entry is a symbolic link. */
+    isSymbolicLink(): boolean;
+    /** @returns {boolean} Always `false`. */
+    isBlockDevice(): boolean;
+    /** @returns {boolean} Always `false`. */
+    isCharacterDevice(): boolean;
+    /** @returns {boolean} Always `false`. */
+    isFIFO(): boolean;
+    /** @returns {boolean} Always `false`. */
+    isSocket(): boolean;
+    /** @returns {number} The `st_mode` field, including the file type bits. */
+    get modeWithType(): number;
+}
+/**
+ * Directory entry returned by `readdir` when `withFileTypes` is `true`.
+ */
+export declare class Dirent {
+    #private;
+    /**
+     * @param {string} name Base name of the entry.
+     * @param {FSEntryKind} kind Entry kind.
+     */
+    constructor(name: string, kind: FSEntryKind);
+    /** @returns {string} Base name of the entry. */
+    get name(): string;
+    /** @returns {boolean} `true` when the entry is a regular file. */
+    isFile(): boolean;
+    /** @returns {boolean} `true` when the entry is a directory. */
+    isDirectory(): boolean;
+    /** @returns {boolean} `true` when the entry is a symbolic link. */
+    isSymbolicLink(): boolean;
+    /** @returns {boolean} Always `false`. */
+    isBlockDevice(): boolean;
+    /** @returns {boolean} Always `false`. */
+    isCharacterDevice(): boolean;
+    /** @returns {boolean} Always `false`. */
+    isFIFO(): boolean;
+    /** @returns {boolean} Always `false`. */
+    isSocket(): boolean;
+}
+//# sourceMappingURL=stats.d.mts.map

package/dist/v1/libs/fs/stats.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/fs/stats.mjs"],"names":[],"mappings":"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"}

package/dist/v1/libs/fs/stats.mjs

@@ -0,0 +1,197 @@
+/**
+ * @file Immutable metadata snapshots returned by {@link TinyFSCore#stat}.
+ */
+import { FILE_TYPE } from './constants.mjs';
+/**
+ * @typedef {'file' | 'directory' | 'symbolic-link'} FSEntryKind
+ */
+/**
+ * @typedef {Object} FSStatDescriptor
+ * @property {string} name Base name of the entry.
+ * @property {FSEntryKind} kind Entry kind.
+ * @property {number} size Size in bytes. Ignored for directories.
+ * @property {number} mtimeMs Last modification time in milliseconds since the epoch.
+ */
+/**
+ * @typedef {Object} FSDirectoryEntry
+ * @property {string} name Base name of the entry.
+ * @property {FSEntryKind} kind Entry kind.
+ */
+/**
+ * @typedef {Object} FSMetadata
+ * @property {number | null} mode POSIX permission bits, or `null` when unset.
+ * @property {number | null} uid Owner user id.
+ * @property {number | null} gid Owner group id.
+ * @property {number | null} atimeMs Last access time in milliseconds since the epoch.
+ * @property {number | null} mtimeMs Last modification time in milliseconds since the epoch.
+ * @property {number | null} birthtimeMs Creation time in milliseconds since the epoch.
+ */
+/**
+ * @typedef {Object} StatsOptions
+ * @property {string} path Absolute path of the entry.
+ * @property {string} name Base name of the entry.
+ * @property {FSEntryKind} kind Entry kind.
+ * @property {number} size Size in bytes.
+ * @property {number} mode POSIX permission bits.
+ * @property {number} uid Owner user id.
+ * @property {number} gid Owner group id.
+ * @property {number} atimeMs Last access time in milliseconds since the epoch.
+ * @property {number} mtimeMs Last modification time in milliseconds since the epoch.
+ * @property {number} birthtimeMs Creation time in milliseconds since the epoch.
+ * @property {number} ino Inode number. `0` when the backend has no inodes.
+ */
+/**
+ * Immutable snapshot of a file system entry, shaped like `node:fs.Stats`.
+ */
+export class Stats {
+    /** @type {StatsOptions} */
+    #options;
+    /**
+     * @param {StatsOptions} options Snapshot values.
+     */
+    constructor(options) {
+        this.#options = Object.freeze({ ...options });
+    }
+    /** @returns {string} Absolute path of the entry. */
+    get path() {
+        return this.#options.path;
+    }
+    /** @returns {string} Base name of the entry. */
+    get name() {
+        return this.#options.name;
+    }
+    /** @returns {number} Size in bytes, or `0` for directories. */
+    get size() {
+        return this.#options.kind === 'directory' ? 0 : this.#options.size;
+    }
+    /** @returns {number} POSIX permission bits. */
+    get mode() {
+        return this.#options.mode;
+    }
+    /** @returns {number} Owner user id. */
+    get uid() {
+        return this.#options.uid;
+    }
+    /** @returns {number} Owner group id. */
+    get gid() {
+        return this.#options.gid;
+    }
+    /** @returns {number} Inode number, or `0` when unsupported. */
+    get ino() {
+        return this.#options.ino;
+    }
+    /** @returns {number} Number of hard links. Always `1`. */
+    get nlink() {
+        return 1;
+    }
+    /** @returns {number} Last access time in milliseconds since the epoch. */
+    get atimeMs() {
+        return this.#options.atimeMs;
+    }
+    /** @returns {number} Last modification time in milliseconds since the epoch. */
+    get mtimeMs() {
+        return this.#options.mtimeMs;
+    }
+    /** @returns {number} Creation time in milliseconds since the epoch. */
+    get birthtimeMs() {
+        return this.#options.birthtimeMs;
+    }
+    /** @returns {Date} Last access time. */
+    get atime() {
+        return new Date(this.#options.atimeMs);
+    }
+    /** @returns {Date} Last modification time. */
+    get mtime() {
+        return new Date(this.#options.mtimeMs);
+    }
+    /** @returns {Date} Change time. Alias of `mtime`. */
+    get ctime() {
+        return new Date(this.#options.mtimeMs);
+    }
+    /** @returns {Date} Creation time. */
+    get birthtime() {
+        return new Date(this.#options.birthtimeMs);
+    }
+    /** @returns {boolean} `true` when the entry is a regular file. */
+    isFile() {
+        return this.#options.kind === 'file';
+    }
+    /** @returns {boolean} `true` when the entry is a directory. */
+    isDirectory() {
+        return this.#options.kind === 'directory';
+    }
+    /** @returns {boolean} `true` when the entry is a symbolic link. */
+    isSymbolicLink() {
+        return this.#options.kind === 'symbolic-link';
+    }
+    /** @returns {boolean} Always `false`. */
+    isBlockDevice() {
+        return false;
+    }
+    /** @returns {boolean} Always `false`. */
+    isCharacterDevice() {
+        return false;
+    }
+    /** @returns {boolean} Always `false`. */
+    isFIFO() {
+        return false;
+    }
+    /** @returns {boolean} Always `false`. */
+    isSocket() {
+        return false;
+    }
+    /** @returns {number} The `st_mode` field, including the file type bits. */
+    get modeWithType() {
+        const type = this.isDirectory() ? FILE_TYPE.DIRECTORY : FILE_TYPE.FILE;
+        return type | this.#options.mode;
+    }
+}
+/**
+ * Directory entry returned by `readdir` when `withFileTypes` is `true`.
+ */
+export class Dirent {
+    /** @type {string} */
+    #name;
+    /** @type {FSEntryKind} */
+    #kind;
+    /**
+     * @param {string} name Base name of the entry.
+     * @param {FSEntryKind} kind Entry kind.
+     */
+    constructor(name, kind) {
+        this.#name = name;
+        this.#kind = kind;
+    }
+    /** @returns {string} Base name of the entry. */
+    get name() {
+        return this.#name;
+    }
+    /** @returns {boolean} `true` when the entry is a regular file. */
+    isFile() {
+        return this.#kind === 'file';
+    }
+    /** @returns {boolean} `true` when the entry is a directory. */
+    isDirectory() {
+        return this.#kind === 'directory';
+    }
+    /** @returns {boolean} `true` when the entry is a symbolic link. */
+    isSymbolicLink() {
+        return this.#kind === 'symbolic-link';
+    }
+    /** @returns {boolean} Always `false`. */
+    isBlockDevice() {
+        return false;
+    }
+    /** @returns {boolean} Always `false`. */
+    isCharacterDevice() {
+        return false;
+    }
+    /** @returns {boolean} Always `false`. */
+    isFIFO() {
+        return false;
+    }
+    /** @returns {boolean} Always `false`. */
+    isSocket() {
+        return false;
+    }
+}

package/dist/v1/libs/html/events/TinyIframeEvents.cjs

@@ -35,6 +35,15 @@ const instances = new WeakMap();
  * @property {'iframe' | 'parent'} direction - Indicates the sender: 'iframe' or 'parent'.
  */
 
+/**
+ * Event map for {@link TinyIframeEvents}.
+ * All routed events are prefixed with `win:` followed by the event name.
+ * @typedef {Record<`win:${string}`, (payload: any, event: MessageEvent) => void> & Record<string, (...args: any[]) => void>} TinyIframeEventsMap
+ */
+
+/** @type {new (config?: TinyIframeEventsConfig) => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyIframeEventsMap>} */
+const TypedEventEmitter = /** @type {any} */ (events.EventEmitter);
+
 /**
  * A highly secure and flexible event routing system for structured communication
  * between a parent window and its iframe using `MessageChannel`.
@@ -49,7 +58,7 @@ const instances = new WeakMap();
  * - Queue management for messages sent before the connection is established.
  * - Auto-reconnects and resets ports if the target iframe is reloaded.
  */
-class TinyIframeEvents extends events.EventEmitter {
+class TinyIframeEvents extends TypedEventEmitter {
   /** @type {Window} */
   #targetWindow;
 

package/dist/v1/libs/html/events/TinyIframeEvents.d.mts

@@ -1,4 +1,3 @@
-import { EventEmitter } from 'events';
 export type handler = (payload: any, event: MessageEvent<any>) => any;
 export type TinyIframeEventsConfig = {
     /**
@@ -40,6 +39,7 @@ export type IframeEventBase = {
      */
     direction: 'iframe' | 'parent';
 };
+export type TinyIframeEventsMap = Record<`win:${string}`, (payload: any, event: MessageEvent) => void> & Record<string, (...args: any[]) => void>;
 /**
  * @callback handler
  * A function to handle incoming event payloads.
@@ -63,6 +63,13 @@ export type IframeEventBase = {
  * @property {any} payload - The data being sent (can be any type).
  * @property {'iframe' | 'parent'} direction - Indicates the sender: 'iframe' or 'parent'.
  */
+/**
+ * Event map for {@link TinyIframeEvents}.
+ * All routed events are prefixed with `win:` followed by the event name.
+ * @typedef {Record<`win:${string}`, (payload: any, event: MessageEvent) => void> & Record<string, (...args: any[]) => void>} TinyIframeEventsMap
+ */
+/** @type {new (config?: TinyIframeEventsConfig) => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyIframeEventsMap>} */
+declare const TypedEventEmitter: new (config?: TinyIframeEventsConfig) => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyIframeEventsMap>;
 /**
  * A highly secure and flexible event routing system for structured communication
  * between a parent window and its iframe using `MessageChannel`.
@@ -77,7 +84,7 @@ export type IframeEventBase = {
  * - Queue management for messages sent before the connection is established.
  * - Auto-reconnects and resets ports if the target iframe is reloaded.
  */
-declare class TinyIframeEvents extends EventEmitter {
+declare class TinyIframeEvents extends TypedEventEmitter {
     #private;
     _boundWindowMessage: (event: MessageEvent<any>) => void;
     _boundPortMessage: (event: MessageEvent<any>) => void;

package/dist/v1/libs/html/events/TinyIframeEvents.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"TinyIframeEvents.d.mts","sourceRoot":"","sources":["../../../../../src/v1/libs/html/events/TinyIframeEvents.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAUnC,YAAU,OAAO,GAEjB,CAAa,OAAO,EAAZ,GACR,EAA2B,KAAK,EAAxB,YAAY,CAAC,GAAG,CAC1B,QAAA,CAAA;AAGE,YAAkB,sBAAsB,GAExC;;;;IAA+B,YAAY,AAA3C,CACA,EADW,iBAAiB,CAC5B;;;;IAAoB,YAAY,AAAhC,CACA,EADW,MAAM,CACjB;;;;IAAoB,eAAe,AAAnC,CACA,EADW,MAAM,CACjB;;;;IAAoB,kBAAkB,AAAtC,CACA,EADW,MAAM,CACjB;;;;IAAoB,cAAc,AAAlC,CACF,EADa,MAAM,CACnB;CAAA,CAAA;AAGE,YAAkB,eAAe,GAEjC;;;;IAAqB,eAAe,AAApC,CACA,EADW,OAAO,CAClB;;;;IAAmB,SAAS,EAAjB,MAAM,CACjB;;;;IAAgB,OAAO,EAAZ,GAAG,CACd;;;;IAAgC,SAAS,EAA9B,QAAQ,GAAG,QAAQ,CAChC;CAAA,CAAA;AAxBD;;;;;GAKG;AAEH;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AAEH;;;;;;;;;;;;;GAaG;AACH,cAAM,gBAAiB,SAAQ,YAAY;;IAoHlC,mBAAmB,UA4Gf,YAAY,CAAC,GAAG,CAAC;IA3GrB,iBAAiB,UA8Hb,YAAY,CAAC,GAAG,CAAC;IA/O5B,IAAI,YAAY,WAGf;IAKD,IAAI,mBAAmB,kCAGtB;IAKD,IAAI,YAAY,WAGf;IAKD,IAAI,QAAQ,wBAGX;IAQD,IAAI,KAAK,YAGR;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAFJ,MAAM,IAEF,QAOd;IAoBD;;;;;OAKG;IACH,YAAY,EACV,YAAY,EACZ,YAAqC,EACrC,eAAuC,EACvC,kBAA8C,EAC9C,cAAsC,GACvC,GARU,sBAQL,EAgCL;IAED;;;OAGG;IACH,IAAI,eAAe,IAFN,MAAM,CAKlB;IAED;;;;OAIG;IACH,IAAI,eAAe,CAAC,IAAI,EAHb,MAGa,EAKvB;IAED;;;OAGG;IACH,IAAI,kBAAkB,IAFT,MAAM,CAKlB;IAED;;;;OAIG;IACH,IAAI,kBAAkB,CAAC,IAAI,EAHhB,MAGgB,EAK1B;IAED;;;OAGG;IACH,IAAI,cAAc,IAFL,MAAM,CAKlB;IAED;;;;OAIG;IACH,IAAI,cAAc,CAAC,IAAI,EAHZ,MAGY,EAKtB;IAgHD;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS,EALN,MAKM,EAAE,OAAO,EAJf,GAIe,QAmBzB;IAED;;;;OAIG;IACH,WAAW,IAFE,OAAO,CAInB;IAED;;;OAGG;IACH,OAAO,SAmBN;CACF;eAEc,gBAAgB"}
+{"version":3,"file":"TinyIframeEvents.d.mts","sourceRoot":"","sources":["../../../../../src/v1/libs/html/events/TinyIframeEvents.mjs"],"names":[],"mappings":"AAUG,YAAU,OAAO,GAEjB,CAAa,OAAO,EAAZ,GACR,EAA2B,KAAK,EAAxB,YAAY,CAAC,GAAG,CAC1B,QAAA,CAAA;AAGE,YAAkB,sBAAsB,GAExC;;;;IAA+B,YAAY,AAA3C,CACA,EADW,iBAAiB,CAC5B;;;;IAAoB,YAAY,AAAhC,CACA,EADW,MAAM,CACjB;;;;IAAoB,eAAe,AAAnC,CACA,EADW,MAAM,CACjB;;;;IAAoB,kBAAkB,AAAtC,CACA,EADW,MAAM,CACjB;;;;IAAoB,cAAc,AAAlC,CACF,EADa,MAAM,CACnB;CAAA,CAAA;AAGE,YAAkB,eAAe,GAEjC;;;;IAAqB,eAAe,AAApC,CACA,EADW,OAAO,CAClB;;;;IAAmB,SAAS,EAAjB,MAAM,CACjB;;;;IAAgB,OAAO,EAAZ,GAAG,CACd;;;;IAAgC,SAAS,EAA9B,QAAQ,GAAG,QAAQ,CAChC;CAAA,CAAA;AAKE,YAA2H,mBAAmB,GAApI,MAAM,CAAC,OAAO,MAAM,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC,CAAqB;AA7BjJ;;;;;GAKG;AAEH;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AAEH;;;;GAIG;AAEH,0IAA0I;AAC1I,QAAA,MAAM,iBAAiB,EADZ,KAAK,MAAM,CAAC,EAAE,sBAAsB,KAAK,OAAO,iCAAiC,EAAE,mBAAmB,CAAC,mBAAmB,CAC1E,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,cAAM,gBAAiB,SAAQ,iBAAiB;;IAoHvC,mBAAmB,UA4Gf,YAAY,CAAC,GAAG,CAAC;IA3GrB,iBAAiB,UA8Hb,YAAY,CAAC,GAAG,CAAC;IA/O5B,IAAI,YAAY,WAGf;IAKD,IAAI,mBAAmB,kCAGtB;IAKD,IAAI,YAAY,WAGf;IAKD,IAAI,QAAQ,wBAGX;IAQD,IAAI,KAAK,YAGR;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAFJ,MAAM,IAEF,QAOd;IAoBD;;;;;OAKG;IACH,YAAY,EACV,YAAY,EACZ,YAAqC,EACrC,eAAuC,EACvC,kBAA8C,EAC9C,cAAsC,GACvC,GARU,sBAQL,EAgCL;IAED;;;OAGG;IACH,IAAI,eAAe,IAFN,MAAM,CAKlB;IAED;;;;OAIG;IACH,IAAI,eAAe,CAAC,IAAI,EAHb,MAGa,EAKvB;IAED;;;OAGG;IACH,IAAI,kBAAkB,IAFT,MAAM,CAKlB;IAED;;;;OAIG;IACH,IAAI,kBAAkB,CAAC,IAAI,EAHhB,MAGgB,EAK1B;IAED;;;OAGG;IACH,IAAI,cAAc,IAFL,MAAM,CAKlB;IAED;;;;OAIG;IACH,IAAI,cAAc,CAAC,IAAI,EAHZ,MAGY,EAKtB;IAgHD;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS,EALN,MAKM,EAAE,OAAO,EAJf,GAIe,QAmBzB;IAED;;;;OAIG;IACH,WAAW,IAFE,OAAO,CAInB;IAED;;;OAGG;IACH,OAAO,SAmBN;CACF;eAEc,gBAAgB"}

package/dist/v1/libs/html/events/TinyIframeEvents.mjs

@@ -27,6 +27,13 @@ const instances = new WeakMap();
  * @property {any} payload - The data being sent (can be any type).
  * @property {'iframe' | 'parent'} direction - Indicates the sender: 'iframe' or 'parent'.
  */
+/**
+ * Event map for {@link TinyIframeEvents}.
+ * All routed events are prefixed with `win:` followed by the event name.
+ * @typedef {Record<`win:${string}`, (payload: any, event: MessageEvent) => void> & Record<string, (...args: any[]) => void>} TinyIframeEventsMap
+ */
+/** @type {new (config?: TinyIframeEventsConfig) => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyIframeEventsMap>} */
+const TypedEventEmitter = /** @type {any} */ (EventEmitter);
 /**
  * A highly secure and flexible event routing system for structured communication
  * between a parent window and its iframe using `MessageChannel`.
@@ -41,7 +48,7 @@ const instances = new WeakMap();
  * - Queue management for messages sent before the connection is established.
  * - Auto-reconnects and resets ports if the target iframe is reloaded.
  */
-class TinyIframeEvents extends EventEmitter {
+class TinyIframeEvents extends TypedEventEmitter {
     /** @type {Window} */
     #targetWindow;
     get targetWindow() {

package/dist/v1/libs/html/events/TinyNewWinEvents.cjs

@@ -16,10 +16,21 @@ const pollClosedInterval = new WeakMap();
 /**
  * @callback handler
  * A function to handle incoming event payloads.
- * @param {any} payload - The data sent by the emitter.
- * @param {MessageEvent<any>} event - Metadata about the message.
+ * @param {any} [payload] - The data sent by the emitter.
+ * @param {MessageEvent<any>} [event] - Metadata about the message.
  */
 
+/**
+ * Event map for {@link TinyNewWinEvents}.
+ * Routed events are prefixed with `win:` followed by the route name.
+ * @typedef {Record<`win:${string}`, (payload: any, event: MessageEvent) => void> & {
+ *   WINDOW_REF_CLOSED: () => void,
+ * }} TinyNewWinEventsMap
+ */
+
+/** @type {new (settings?: { targetOrigin?: string, url?: string, name?: string, features?: string }) => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyNewWinEventsMap>} */
+const TypedEventEmitter = /** @type {any} */ (events.EventEmitter);
+
 /**
  * TinyNewWinEvents provides structured communication between a main window
  * and a child window (created using window.open) using postMessage.
@@ -29,7 +40,7 @@ const pollClosedInterval = new WeakMap();
  *
  * @class
  */
-class TinyNewWinEvents extends events.EventEmitter {
+class TinyNewWinEvents extends TypedEventEmitter {
   /** @type {Window|null} Reference to the opened or parent window */
   #windowRef;
 

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

@@ -1,11 +1,27 @@
-import { EventEmitter } from 'events';
-export type handler = (payload: any, event: MessageEvent<any>) => any;
+export type handler = (payload?: any, event?: MessageEvent<any>) => any;
+export type TinyNewWinEventsMap = Record<`win:${string}`, (payload: any, event: MessageEvent) => void> & {
+    WINDOW_REF_CLOSED: () => void;
+};
 /**
  * @callback handler
  * A function to handle incoming event payloads.
- * @param {any} payload - The data sent by the emitter.
- * @param {MessageEvent<any>} event - Metadata about the message.
+ * @param {any} [payload] - The data sent by the emitter.
+ * @param {MessageEvent<any>} [event] - Metadata about the message.
  */
+/**
+ * Event map for {@link TinyNewWinEvents}.
+ * Routed events are prefixed with `win:` followed by the route name.
+ * @typedef {Record<`win:${string}`, (payload: any, event: MessageEvent) => void> & {
+ *   WINDOW_REF_CLOSED: () => void,
+ * }} TinyNewWinEventsMap
+ */
+/** @type {new (settings?: { targetOrigin?: string, url?: string, name?: string, features?: string }) => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyNewWinEventsMap>} */
+declare const TypedEventEmitter: new (settings?: {
+    targetOrigin?: string;
+    url?: string;
+    name?: string;
+    features?: string;
+}) => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyNewWinEventsMap>;
 /**
  * TinyNewWinEvents provides structured communication between a main window
  * and a child window (created using window.open) using postMessage.
@@ -15,7 +31,7 @@ export type handler = (payload: any, event: MessageEvent<any>) => any;
  *
  * @class
  */
-declare class TinyNewWinEvents extends EventEmitter {
+declare class TinyNewWinEvents extends TypedEventEmitter {
     #private;
     _handleMessage: (event: MessageEvent) => void;
     /**

package/dist/v1/libs/html/events/TinyNewWinEvents.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"TinyNewWinEvents.d.mts","sourceRoot":"","sources":["../../../../../src/v1/libs/html/events/TinyNewWinEvents.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAcnC,YAAU,OAAO,GAEjB,CAAa,OAAO,EAAZ,GACR,EAA2B,KAAK,EAAxB,YAAY,CAAC,GAAG,CAC1B,QAAA,CAAA;AALD;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,cAAM,gBAAiB,SAAQ,YAAY;;IAuHlC,cAAc,UAuBV,YAAY,KACV,IAAI;IAhHjB;;;;OAIG;IACH,IAAI,SAAS,IAFA,OAAO,CAInB;IAED;;;OAGG;IACH,IAAI,cAAc,IAFL,MAAM,CAKlB;IAED;;;;OAIG;IACH,IAAI,cAAc,CAAC,IAAI,EAHZ,MAGY,EAKtB;IAED;;;OAGG;IACH,IAAI,cAAc,IAFL,MAAM,CAKlB;IAED;;;;OAIG;IACH,IAAI,cAAc,CAAC,IAAI,EAHZ,MAGY,EAKtB;IAED;;;;;;;;;;;;OAYG;IACH,YAAY,EAAE,YAAY,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,AAV9C,CAMA,EALA;QAA0B,YAAY,AAAtC,CACA,EADQ,MAAM,CACd;QAA0B,GAAG,AAA7B,CACA,EADQ,MAAM,CACd;QAA0B,IAAI,AAA9B,CACA,EADQ,MAAM,CACd;QAA0B,QAAQ,AAAlC,CAEA,EAFQ,MAAM,CAEd;KAImD,EAgCrD;IAED;;;;OAIG;IACH,MAAM,IAFO,MAAM,GAAC,IAAI,CAKvB;IAmDD;;;;OAIG;IACH,KAAK,IAFQ,IAAI,CAMhB;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,KAAK,EALF,MAKE,EAAE,OAAO,EAJX,GAIW,GAFT,IAAI,CAWhB;IAED;;;;OAIG;IACH,WAAW,IAFE,OAAO,CAKnB;IAkBD;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAHL,OAGK,GAFH,IAAI,CAKhB;IAED;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAHN,OAGM,GAFJ,IAAI,CAKhB;IAED;;;;OAIG;IACH,WAAW,IAFE,OAAO,CAInB;IAED;;;;OAIG;IACH,OAAO,IAFM,IAAI,CAehB;CACF;eAEc,gBAAgB"}
+{"version":3,"file":"TinyNewWinEvents.d.mts","sourceRoot":"","sources":["../../../../../src/v1/libs/html/events/TinyNewWinEvents.mjs"],"names":[],"mappings":"AAcG,YAAU,OAAO,GAEjB,CAAc,OAAO,AAArB,CACA,EADQ,GACR,EAA4B,KAAK,AAAjC,CACF,EADU,YAAY,CAAC,GAAG,CAC1B,QAAA,CAAA;AAKE,YAEG,mBAAmB,GAFZ,MAAM,CAAC,OAAO,MAAM,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG;IAC/E,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B,CAAqB;AAZzB;;;;;GAKG;AAEH;;;;;;GAMG;AAEH,+LAA+L;AAC/L,QAAA,MAAM,iBAAiB,EADZ,KAAK,QAAQ,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,iCAAiC,EAAE,mBAAmB,CAAC,mBAAmB,CAC/H,CAAC;AAE5D;;;;;;;;GAQG;AACH,cAAM,gBAAiB,SAAQ,iBAAiB;;IAuHvC,cAAc,UAuBV,YAAY,KACV,IAAI;IAhHjB;;;;OAIG;IACH,IAAI,SAAS,IAFA,OAAO,CAInB;IAED;;;OAGG;IACH,IAAI,cAAc,IAFL,MAAM,CAKlB;IAED;;;;OAIG;IACH,IAAI,cAAc,CAAC,IAAI,EAHZ,MAGY,EAKtB;IAED;;;OAGG;IACH,IAAI,cAAc,IAFL,MAAM,CAKlB;IAED;;;;OAIG;IACH,IAAI,cAAc,CAAC,IAAI,EAHZ,MAGY,EAKtB;IAED;;;;;;;;;;;;OAYG;IACH,YAAY,EAAE,YAAY,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,AAV9C,CAMA,EALA;QAA0B,YAAY,AAAtC,CACA,EADQ,MAAM,CACd;QAA0B,GAAG,AAA7B,CACA,EADQ,MAAM,CACd;QAA0B,IAAI,AAA9B,CACA,EADQ,MAAM,CACd;QAA0B,QAAQ,AAAlC,CAEA,EAFQ,MAAM,CAEd;KAImD,EAgCrD;IAED;;;;OAIG;IACH,MAAM,IAFO,MAAM,GAAC,IAAI,CAKvB;IAmDD;;;;OAIG;IACH,KAAK,IAFQ,IAAI,CAMhB;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,KAAK,EALF,MAKE,EAAE,OAAO,EAJX,GAIW,GAFT,IAAI,CAWhB;IAED;;;;OAIG;IACH,WAAW,IAFE,OAAO,CAKnB;IAkBD;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAHL,OAGK,GAFH,IAAI,CAKhB;IAED;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAHN,OAGM,GAFJ,IAAI,CAKhB;IAED;;;;OAIG;IACH,WAAW,IAFE,OAAO,CAInB;IAED;;;;OAIG;IACH,OAAO,IAFM,IAAI,CAehB;CACF;eAEc,gBAAgB"}

package/dist/v1/libs/html/events/TinyNewWinEvents.mjs

@@ -11,9 +11,18 @@ const pollClosedInterval = new WeakMap();
 /**
  * @callback handler
  * A function to handle incoming event payloads.
- * @param {any} payload - The data sent by the emitter.
- * @param {MessageEvent<any>} event - Metadata about the message.
+ * @param {any} [payload] - The data sent by the emitter.
+ * @param {MessageEvent<any>} [event] - Metadata about the message.
  */
+/**
+ * Event map for {@link TinyNewWinEvents}.
+ * Routed events are prefixed with `win:` followed by the route name.
+ * @typedef {Record<`win:${string}`, (payload: any, event: MessageEvent) => void> & {
+ *   WINDOW_REF_CLOSED: () => void,
+ * }} TinyNewWinEventsMap
+ */
+/** @type {new (settings?: { targetOrigin?: string, url?: string, name?: string, features?: string }) => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyNewWinEventsMap>} */
+const TypedEventEmitter = /** @type {any} */ (EventEmitter);
 /**
  * TinyNewWinEvents provides structured communication between a main window
  * and a child window (created using window.open) using postMessage.
@@ -23,7 +32,7 @@ const pollClosedInterval = new WeakMap();
  *
  * @class
  */
-class TinyNewWinEvents extends EventEmitter {
+class TinyNewWinEvents extends TypedEventEmitter {
     /** @type {Window|null} Reference to the opened or parent window */
     #windowRef;
     /** @type {string} Expected origin for postMessage communication */

package/dist/v1/libs/html/scroll/TinySmartScroller.cjs

@@ -33,6 +33,18 @@ const checkDestroy = tools.createCheckDestroyed('TinySmartScroller');
  * @returns {void}
  */
 
+/**
+ * Event map for {@link TinySmartScroller}.
+ * @typedef {Object} TinySmartScrollerEvents
+ * @property {(data: any) => void} onScrollBoundary - Emitted when the scroll boundary state changes.
+ * @property {(data: any) => void} onExtraScrollBoundary - Emitted when the custom scroll boundary state changes.
+ * @property {(data: any) => void} onAutoScroll - Emitted when an auto-scroll occurs.
+ * @property {(data: any) => void} onScrollPause - Emitted when auto-scroll is paused.
+ */
+
+/** @type {new (...args: any[]) => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinySmartScrollerEvents>} */
+const TypedEventEmitter = /** @type {any} */ (events.EventEmitter);
+
 /**
  * TinySmartScroller is a utility class designed to enhance and manage scroll behaviors within containers or the window.
  *
@@ -51,7 +63,7 @@ const checkDestroy = tools.createCheckDestroyed('TinySmartScroller');
  * This class is **not framework-dependent** and works with vanilla DOM elements and the window object.
  * @template {Element|Window} HTMLTarget
  */
-class TinySmartScroller extends events.EventEmitter {
+class TinySmartScroller extends TypedEventEmitter {
   static Utils = { ...collision, TinyHtml };
 
   /** @type {WeakMap<Element, NodeSizes>} */