tiny-essentials 1.24.2 → 1.24.4

package/dist/v1/libs/TinyHtml.mjs

@@ -310,6 +310,12 @@ const __elemCollision = {
 class TinyHtml {
     /** @typedef {import('../basics/collision.mjs').ObjRect} ObjRect */
     static Utils = { ...TinyCollision };
+    /** @type {number} */
+    static #version = 1;
+    /** @returns {number} */
+    static get version() {
+        return this.#version;
+    }
     /**
      * Controls whether TinyHtml emits detailed debug output to the console.
      * When enabled, helper methods print structured diagnostics for easier troubleshooting.
@@ -945,7 +951,6 @@ class TinyHtml {
      * @param {string} where - The method name or context calling this.
      * @param {number} index - The index of the element to retrieve.
      * @returns {ConstructorElValues} - The instance's element.
-     * @readonly
      */
     _getElement(where, index) {
         if (!(this.#el[index] instanceof Element) &&
@@ -962,7 +967,6 @@ class TinyHtml {
      *
      * @param {string} where - The method name or context calling this.
      * @returns {ConstructorElValues[]} - The instance's elements.
-     * @readonly
      */
     _getElements(where) {
         if (!this.#el.every((el) => el instanceof Element ||
@@ -985,7 +989,6 @@ class TinyHtml {
      * @param {string[]} elemName - The list of expected element names for error reporting.
      * @returns {any[]} - A flat array of validated elements.
      * @throws {Error} - If any element is not an instance of one of the allowed types.
-     * @readonly
      */
     static _preElemsTemplate(elems, where, TheTinyElements, elemName) {
         /** @param {(TinyElement|EventTarget|null)[]} item */
@@ -1021,7 +1024,6 @@ class TinyHtml {
      * @param {string[]} elemName - The list of expected element names for error reporting.
      * @returns {any[]} - A flat array of validated elements.
      * @throws {Error} - If any element is not an instance of one of the allowed types.
-     * @readonly
      */
     _preElemsTemplate(where, TheTinyElements, elemName) {
         return TinyHtml._preElemsTemplate(this, where, TheTinyElements, elemName);
@@ -1036,7 +1038,6 @@ class TinyHtml {
      * @param {boolean} [canNull=false] - Whether `null` is allowed as a valid value.
      * @returns {any} - The validated element or `null` if allowed.
      * @throws {Error} - If the element is not valid or if multiple elements are provided.
-     * @readonly
      */
     static _preElemTemplate(elems, where, TheTinyElements, elemName, canNull = false) {
         /** @param {(TinyElement|EventTarget|null)[]} item */
@@ -1081,7 +1082,6 @@ class TinyHtml {
      * @param {boolean} [canNull=false] - Whether `null` is allowed as a valid value.
      * @returns {any} - The validated element or `null` if allowed.
      * @throws {Error} - If the element is not valid or if multiple elements are provided.
-     * @readonly
      */
     _preElemTemplate(where, TheTinyElements, elemName, canNull = false) {
         return TinyHtml._preElemTemplate(this, where, TheTinyElements, elemName, canNull);
@@ -1093,7 +1093,6 @@ class TinyHtml {
      * @param {TinyElement|TinyElement[]} elems - A single element or array of elements.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {Element[]} - Always returns an array of elements.
-     * @readonly
      */
     static _preElems(elems, where) {
         return TinyHtml._preElemsTemplate(elems, where, [Element], ['Element']);
@@ -1104,7 +1103,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {Element[]} - Always returns an array of elements.
-     * @readonly
      */
     _preElems(where) {
         return TinyHtml._preElems(this, where);
@@ -1116,7 +1114,6 @@ class TinyHtml {
      * @param {TinyElement|TinyElement[]} elems - A single element or array of elements.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {Element} - Always returns an single element.
-     * @readonly
      */
     static _preElem(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [Element], ['Element']);
@@ -1127,7 +1124,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {Element} - Always returns an single element.
-     * @readonly
      */
     _preElem(where) {
         return TinyHtml._preElem(this, where);
@@ -1139,7 +1135,6 @@ class TinyHtml {
      * @param {TinyNode|TinyNode[]} elems - A single node or array of nodes.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {Node[]} - Always returns an array of nodes.
-     * @readonly
      */
     static _preNodeElems(elems, where) {
         return TinyHtml._preElemsTemplate(elems, where, [Node], ['Node']);
@@ -1150,7 +1145,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {Node[]} - Always returns an array of nodes.
-     * @readonly
      */
     _preNodeElems(where) {
         return TinyHtml._preNodeElems(this, where);
@@ -1162,7 +1156,6 @@ class TinyHtml {
      * @param {TinyNode|TinyNode[]} elems - A single node or array of nodes.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {Node} - Always returns an single node.
-     * @readonly
      */
     static _preNodeElem(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [Node], ['Node']);
@@ -1173,7 +1166,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {Node} - Always returns an single node.
-     * @readonly
      */
     _preNodeElem(where) {
         return TinyHtml._preNodeElem(this, where);
@@ -1185,7 +1177,6 @@ class TinyHtml {
      * @param {TinyNode|TinyNode[]} elems - A single node or array of nodes.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {Node|null} - Always returns an single node or null.
-     * @readonly
      */
     static _preNodeElemWithNull(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [Node], ['Node'], true);
@@ -1196,7 +1187,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {Node|null} - Always returns an single node or null.
-     * @readonly
      */
     _preNodeElemWithNull(where) {
         return TinyHtml._preNodeElemWithNull(this, where);
@@ -1208,7 +1198,6 @@ class TinyHtml {
      * @param {TinyElement|TinyElement[]} elems - A single html element or array of html elements.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {HTMLElement[]} - Always returns an array of html elements.
-     * @readonly
      */
     static _preHtmlElems(elems, where) {
         return TinyHtml._preElemsTemplate(elems, where, [HTMLElement], ['HTMLElement']);
@@ -1219,7 +1208,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {HTMLElement[]} - Always returns an array of html elements.
-     * @readonly
      */
     _preHtmlElems(where) {
         return TinyHtml._preHtmlElems(this, where);
@@ -1231,7 +1219,6 @@ class TinyHtml {
      * @param {TinyElement|TinyElement[]} elems - A single html element or array of html elements.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {HTMLElement} - Always returns an single html element.
-     * @readonly
      */
     static _preHtmlElem(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [HTMLElement], ['HTMLElement']);
@@ -1242,7 +1229,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {HTMLElement} - Always returns an single html element.
-     * @readonly
      */
     _preHtmlElem(where) {
         return TinyHtml._preHtmlElem(this, where);
@@ -1254,7 +1240,6 @@ class TinyHtml {
      * @param {TinyInputElement|TinyInputElement[]} elems - A single event target element or array of html elements.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {InputElement[]} - Always returns an array of event target elements.
-     * @readonly
      */
     static _preInputElems(elems, where) {
         return TinyHtml._preElemsTemplate(elems, where, [HTMLInputElement, HTMLSelectElement, HTMLTextAreaElement, HTMLOptionElement], ['HTMLInputElement', 'HTMLSelectElement', 'HTMLTextAreaElement', 'HTMLOptionElement']);
@@ -1265,7 +1250,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {InputElement[]} - Always returns an array of event target elements.
-     * @readonly
      */
     _preInputElems(where) {
         return TinyHtml._preInputElems(this, where);
@@ -1277,7 +1261,6 @@ class TinyHtml {
      * @param {TinyInputElement|TinyInputElement[]} elems - A single event target element or array of html elements.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {InputElement} - Always returns an single event target element.
-     * @readonly
      */
     static _preInputElem(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [HTMLInputElement, HTMLSelectElement, HTMLTextAreaElement, HTMLOptionElement], ['HTMLInputElement', 'HTMLSelectElement', 'HTMLTextAreaElement', 'HTMLOptionElement']);
@@ -1288,7 +1271,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {InputElement} - Always returns an single event target element.
-     * @readonly
      */
     _preInputElem(where) {
         return TinyHtml._preInputElem(this, where);
@@ -1300,7 +1282,6 @@ class TinyHtml {
      * @param {TinyEventTarget|TinyEventTarget[]} elems - A single event target element or array of html elements.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {EventTarget[]} - Always returns an array of event target elements.
-     * @readonly
      */
     static _preEventTargetElems(elems, where) {
         return TinyHtml._preElemsTemplate(elems, where, [EventTarget], ['EventTarget']);
@@ -1311,7 +1292,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {EventTarget[]} - Always returns an array of event target elements.
-     * @readonly
      */
     _preEventTargetElems(where) {
         return TinyHtml._preEventTargetElems(this, where);
@@ -1323,7 +1303,6 @@ class TinyHtml {
      * @param {TinyEventTarget|TinyEventTarget[]} elems - A single event target element or array of html elements.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {EventTarget} - Always returns an single event target element.
-     * @readonly
      */
     static _preEventTargetElem(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [EventTarget], ['EventTarget']);
@@ -1334,7 +1313,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {EventTarget} - Always returns an single event target element.
-     * @readonly
      */
     _preEventTargetElem(where) {
         return TinyHtml._preEventTargetElem(this, where);
@@ -1346,7 +1324,6 @@ class TinyHtml {
      * @param {TinyElementAndWindow|TinyElementAndWindow[]} elems - A single element/window element or array of html elements.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {ElementAndWindow[]} - Always returns an array of element/window elements.
-     * @readonly
      */
     static _preElemsAndWindow(elems, where) {
         return TinyHtml._preElemsTemplate(elems, where, [Element, Window], ['Element', 'Window']);
@@ -1357,7 +1334,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {ElementAndWindow[]} - Always returns an array of element/window elements.
-     * @readonly
      */
     _preElemsAndWindow(where) {
         return TinyHtml._preElemsAndWindow(this, where);
@@ -1369,7 +1345,6 @@ class TinyHtml {
      * @param {TinyElementAndWindow|TinyElementAndWindow[]} elems - A single element/window element or array of html elements.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {ElementAndWindow} - Always returns an single element/window element.
-     * @readonly
      */
     static _preElemAndWindow(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [Element, Window], ['Element', 'Window']);
@@ -1380,7 +1355,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {ElementAndWindow} - Always returns an single element/window element.
-     * @readonly
      */
     _preElemAndWindow(where) {
         return TinyHtml._preElemAndWindow(this, where);
@@ -1392,7 +1366,6 @@ class TinyHtml {
      * @param {TinyElementAndWinAndDoc|TinyElementAndWinAndDoc[]} elems - A single element/document/window element or array of html elements.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {ElementAndWindow[]} - Always returns an array of element/document/window elements.
-     * @readonly
      */
     static _preElemsAndWinAndDoc(elems, where) {
         const result = TinyHtml._preElemsTemplate(elems, where, [Element, Window, Document], ['Element', 'Window', 'Document']);
@@ -1404,7 +1377,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {ElementAndWindow[]} - Always returns an array of element/document/window elements.
-     * @readonly
      */
     _preElemsAndWinAndDoc(where) {
         return TinyHtml._preElemsAndWinAndDoc(this, where);
@@ -1416,7 +1388,6 @@ class TinyHtml {
      * @param {TinyElementAndWinAndDoc|TinyElementAndWinAndDoc[]} elems - A single element/document/window element or array of html elements.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {ElementAndWindow} - Always returns an single element/document/window element.
-     * @readonly
      */
     static _preElemAndWinAndDoc(elems, where) {
         const result = TinyHtml._preElemTemplate(elems, where, [Element, Window, Document], ['Element', 'Window', 'Document']);
@@ -1430,7 +1401,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {ElementAndWindow} - Always returns an single element/document/window element.
-     * @readonly
      */
     _preElemAndWinAndDoc(where) {
         return TinyHtml._preElemAndWinAndDoc(this, where);
@@ -1442,7 +1412,6 @@ class TinyHtml {
      * @param {TinyElementWithDoc|TinyElementWithDoc[]} elems - A single element with document element or array of html elements.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {ElementWithDoc[]} - Always returns an array of element with document elements.
-     * @readonly
      */
     static _preElemsWithDoc(elems, where) {
         return TinyHtml._preElemsTemplate(elems, where, [Element, Document], ['Element', 'Document']);
@@ -1453,7 +1422,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {ElementWithDoc[]} - Always returns an array of element with document elements.
-     * @readonly
      */
     _preElemsWithDoc(where) {
         return TinyHtml._preElemsWithDoc(this, where);
@@ -1465,7 +1433,6 @@ class TinyHtml {
      * @param {TinyElementWithDoc|TinyElementWithDoc[]} elems - A single element/window element or array of html elements.
      * @param {string} where - The method or context name where validation is being called.
      * @returns {ElementWithDoc} - Always returns an single element/window element.
-     * @readonly
      */
     static _preElemWithDoc(elems, where) {
         return TinyHtml._preElemTemplate(elems, where, [Element, Document], ['Element', 'Document']);
@@ -1476,7 +1443,6 @@ class TinyHtml {
      *
      * @param {string} where - The method or context name where validation is being called.
      * @returns {ElementWithDoc} - Always returns an single element/window element.
-     * @readonly
      */
     _preElemWithDoc(where) {
         return TinyHtml._preElemWithDoc(this, where);
@@ -1753,7 +1719,6 @@ class TinyHtml {
      * Internal data selectors for accessing public or private data stores.
      *
      * @type {Record<string, (where: string, elem: TinyElement) => ElementDataStore>}
-     * @readonly
      */
     static _dataSelector = {
         public: (where, el) => {
@@ -1895,7 +1860,6 @@ class TinyHtml {
      * @param {"previousSibling"|"nextSibling"} direction
      * @param {string} where
      * @returns {ChildNode|null}
-     * @readonly
      */
     static _getSibling(el, direction, where) {
         /** @type {Node|null} */
@@ -1911,7 +1875,6 @@ class TinyHtml {
      * @param {Node|null} start
      * @param {Node|null} [exclude]
      * @returns {ChildNode[]}
-     * @readonly
      */
     static _getSiblings(start, exclude) {
         /** @type {Node|null} */
@@ -2187,7 +2150,6 @@ class TinyHtml {
      * Normalize and validate nodes before DOM insertion.
      * Converts TinyNode-like structures or strings into DOM-compatible nodes.
      * @type {(where: string, ...nodes: (AppendCheckerValues|Record<string, AppendCheckerValues>)[]) => (Node | string)[]}
-     * @readonly
      */
     static _appendChecker(where, ...nodes) {
         /** @type {(string | Node)[]} */
@@ -5543,7 +5505,6 @@ class TinyHtml {
     }
     ///////////////////////////////////////////////
     // TITLE: Value Stuff
-    /** @readonly */
     static _valHooks = {
         option: {
             /**
@@ -5715,7 +5676,6 @@ class TinyHtml {
     /**
      * Maps value types to their corresponding getter functions.
      * Each function extracts a value of a specific type from a compatible HTMLInputElement.
-     * @readonly
      */
     static _valTypes = {
         /**
@@ -5746,7 +5706,6 @@ class TinyHtml {
      * @param {string} where - The context/method name using this validation.
      * @returns {any} The extracted value, depending on the type.
      * @throws {Error} If the element is not an HTMLInputElement or if the type handler is invalid.
-     * @readonly
      */
     static _getValByType(elem, type, where) {
         if (typeof type !== 'string')
@@ -5768,7 +5727,6 @@ class TinyHtml {
      * @param {GetValueTypes} type - The type of value to retrieve ("string", "date", or "number").
      * @param {string} where - The context/method name using this validation.
      * @returns {any} The raw value retrieved from the element or hook.
-     * @readonly
      */
     static _val(el, where, type) {
         const elem = TinyHtml._preInputElem(el, where);
@@ -5788,7 +5746,6 @@ class TinyHtml {
      * @param {GetValueTypes} type - The type of value to retrieve ("string", "date", or "number").
      * @param {string} where - The context/method name using this validation.
      * @returns {any} The raw value retrieved from the element or hook.
-     * @readonly
      */
     _val(where, type) {
         return TinyHtml._val(this, where, type);
@@ -5841,7 +5798,6 @@ class TinyHtml {
      * @param {GetValueTypes} type - The type of value to retrieve ("string", "date", or "number").
      * @returns {SetValueBase[]} - The validated value as an array.
      * @throws {Error} If the returned value is not an array.
-     * @readonly
      */
     static _valArr(el, where, type) {
         /** @type {SetValueBase[]} */
@@ -5857,7 +5813,6 @@ class TinyHtml {
      * @param {GetValueTypes} type - The type of value to retrieve ("string", "date", or "number").
      * @returns {SetValueBase[]} - The validated value as an array.
      * @throws {Error} If the returned value is not an array.
-     * @readonly
      */
     _valArr(where, type) {
         return TinyHtml._valArr(this, where, type);
@@ -6988,7 +6943,6 @@ class TinyHtml {
      * @param {DOMRect} rect - The base rectangle to be cloned and extended.
      * @param {Partial<DOMRect>} extraRect - Additional dimensions to apply to the base rect (e.g., extra padding or offset).
      * @returns {DOMRect} - A new DOMRect object with the combined dimensions.
-     * @readonly
      */
     static _getCustomRect(rect, extraRect) {
         /** @type {DOMRect} */
@@ -7102,7 +7056,6 @@ class TinyHtml {
      * @param {Element} elem1 - The element to track collision state for.
      * @param {CollisionDirLock} lockDirection - The direction from which the collision was first detected.
      * @returns {boolean} Returns `true` if the element is still considered colliding (locked), otherwise `false`.
-     * @readonly
      */
     static _isCollWithLock(isColliding, rect1, rect2, elem1, lockDirection) {
         const lockMap = __elemCollision[lockDirection];

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

@@ -328,7 +328,7 @@ declare class TinyInventory {
      * Keys are item IDs, values are configuration objects created with {@link TinyInventory.defineItem}.
      * @type {Map<string, ItemDef>}
      */
-    static "__#28@#ItemRegistry": Map<string, ItemDef>;
+    static "__#private@#ItemRegistry": Map<string, ItemDef>;
     /**
      * Returns a deep-cloned snapshot of all registered items.
      * Ensures the caller cannot mutate the internal registry.