tiny-essentials 1.26.4 → 1.27.0

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

@@ -329,7 +329,7 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
         };
     };
     /** @type {number} */
-    static "__#private@#version": number;
+    static #version: number;
     /** @returns {number} */
     static get version(): number;
     /**
@@ -337,7 +337,7 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      * When enabled, helper methods print structured diagnostics for easier troubleshooting.
      * @type {boolean}
      */
-    static "__#private@#elemDebug": boolean;
+    static #elemDebug: boolean;
     /**
      * Enables or disables debug output.
      * @param {boolean} value True to enable debug output; false to disable.
@@ -374,25 +374,8 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      * @returns {Record<string,string>}
      */
     static parseStyle(styleText: string): Record<string, string>;
-    /**
-     * Flag to determine if element observer should start automatically.
-     * @type {boolean}
-     */
-    static "__#private@#autoStartElemObserver": boolean;
-    /**
-     * Set the auto-start flag for the observer.
-     * @param {boolean} value
-     */
-    static set autoStartElemObserver(value: boolean);
-    /**
-     * Get the auto-start flag for the observer.
-     * @returns {boolean}
-     */
-    static get autoStartElemObserver(): boolean;
-    /** @type {TinyElementObserver} */
-    static "__#private@#tinyObserver": TinyElementObserver;
-    /** @returns {TinyElementObserver} */
-    static get tinyObserver(): TinyElementObserver;
+    static #tinyObserver: TinyElementObserver<HTMLElement> | undefined;
+    static get tinyObserver(): TinyElementObserver<HTMLElement> | undefined;
     /**
      * Fetches an HTML file from the given URL, parses it to JSON.
      *
@@ -1186,7 +1169,7 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      *
      * @type {Record<string | symbol, string>}
      */
-    static "__#private@#cssPropAliases": Record<string | symbol, string>;
+    static #cssPropAliases: Record<string | symbol, string>;
     /**
      * Public proxy to manage camelCase ➝ kebab-case CSS property aliasing.
      *
@@ -1433,7 +1416,7 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      */
     static outerWidth(el: TinyElementAndWinAndDoc, includeMargin?: boolean): number;
     /** @type {string} */
-    static "__#private@#defaultDisplay": string;
+    static #defaultDisplay: string;
     /**
      * Sets the default display value.
      * @param {string} value
@@ -1469,7 +1452,7 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      *
      * @type {boolean}
      */
-    static "__#private@#cancelOldStyleFx": boolean;
+    static #cancelOldStyleFx: boolean;
     /**
      * Updates the global setting that determines whether old style-based animations
      * are cancelled before new ones start.
@@ -1494,7 +1477,7 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      *
      * @type {Record<string, number | KeyframeAnimationOptions>}
      */
-    static "__#private@#styleFxSpeeds": Record<string, number | KeyframeAnimationOptions>;
+    static #styleFxSpeeds: Record<string, number | KeyframeAnimationOptions>;
     /**
      * Replace the predefined animation speeds.
      * @param {Record<string, number | KeyframeAnimationOptions>} speeds
@@ -1539,12 +1522,12 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      * CSS expansion shorthand used by genStyleFx to include margin/padding values.
      * @typedef {['Top', 'Right', 'Bottom', 'Left']}
      */
-    static "__#private@#cssExpand": string[];
+    static #cssExpand: string[];
     /**
      * Generate shortcuts
      * @type {Record<string, StyleEffects>}
      */
-    static "__#private@#styleEffects": Record<string, StyleEffects>;
+    static #styleEffects: Record<string, StyleEffects>;
     /**
      * Replace the entire styleEffects map with a new one.
      *
@@ -1585,7 +1568,7 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      * Style Effect Inverse Values
      * @type {Record<string, string>}
      */
-    static "__#private@#styleEffectInverse": Record<string, string>;
+    static #styleEffectInverse: Record<string, string>;
     /**
      * Replace the style inverse values.
      * @param {Record<string, string>} values
@@ -1630,7 +1613,7 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      * Style Effect Repeat Detector
      * @type {Record<string, StyleEffectsRdFn>}
      */
-    static "__#private@#styleEffectsRd": Record<string, StyleEffectsRdFn>;
+    static #styleEffectsRd: Record<string, StyleEffectsRdFn>;
     /**
      * Replace the style effects repeat detectors.
      * @param {Record<string, StyleEffectsRdFn>} detectors
@@ -1677,7 +1660,7 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      *
      * @type {StyleEffectsProps}
      */
-    static "__#private@#styleEffectsProps": StyleEffectsProps;
+    static #styleEffectsProps: StyleEffectsProps;
     /**
      * Replace the entire styleEffectsProps map with a new one.
      *
@@ -1941,7 +1924,7 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      */
     static padding(el: TinyElement): HtmlElBoxSides;
     /** @type {boolean} */
-    static "__#private@#classCanWhitespace": boolean;
+    static #classCanWhitespace: boolean;
     /**
      * Sets the value of classCanWhitespace.
      * @param {boolean} value
@@ -2429,7 +2412,7 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      *
      * @type {Record<string | symbol, string>}
      */
-    static "__#private@#propFix": Record<string | symbol, string>;
+    static #propFix: Record<string | symbol, string>;
     /**
      * Public proxy for normalized DOM property names.
      *

package/dist/v1/libs/TinyHtml.mjs

@@ -417,84 +417,60 @@ class TinyHtml {
         return styles;
     }
     /////////////////////////////////////////////////////////////////////
-    /**
-     * Flag to determine if element observer should start automatically.
-     * @type {boolean}
-     */
-    static #autoStartElemObserver = true;
-    /**
-     * Get the auto-start flag for the observer.
-     * @returns {boolean}
-     */
-    static get autoStartElemObserver() {
-        return TinyHtml.#autoStartElemObserver;
-    }
-    /**
-     * Set the auto-start flag for the observer.
-     * @param {boolean} value
-     */
-    static set autoStartElemObserver(value) {
-        if (typeof value !== 'boolean')
-            throw new TypeError('autoStartElemObserver must be a boolean.');
-        TinyHtml.#autoStartElemObserver = value;
-    }
-    /** @type {TinyElementObserver} */
-    static #tinyObserver = new TinyElementObserver({
-        el: typeof window !== 'undefined' && typeof window.document !== 'undefined'
-            ? window.document.documentElement
-            : undefined,
-        initDetectors: [
-            // Style Detector
-            [
-                'tinyStyleEvent',
-                (mutation) => {
-                    if (mutation.type !== 'attributes' ||
-                        mutation.attributeName !== 'style' ||
-                        !(mutation.target instanceof HTMLElement))
-                        return;
-                    const oldVal = mutation.oldValue || '';
-                    const newVal = mutation.target.getAttribute('style') || '';
-                    const oldStyles = TinyHtml.parseStyle(oldVal);
-                    const newStyles = TinyHtml.parseStyle(newVal);
-                    const changes = diffStrings(oldStyles, newStyles);
-                    if (Object.keys(changes.added).length ||
-                        Object.keys(changes.removed).length ||
-                        Object.keys(changes.modified).length) {
-                        mutation.target.dispatchEvent(new CustomEvent('tinyhtml.stylechanged', {
-                            detail: changes,
-                        }));
-                    }
-                },
-            ],
-            // Class Detector
-            [
-                'tinyClassEvent',
-                (mutation) => {
-                    if (mutation.type !== 'attributes' ||
-                        mutation.attributeName !== 'class' ||
-                        !(mutation.target instanceof HTMLElement))
-                        return;
-                    const oldVal = mutation.oldValue || '';
-                    const newVal = mutation.target.className || '';
-                    const oldClasses = oldVal.split(/\s+/).filter(Boolean);
-                    const newClasses = newVal.split(/\s+/).filter(Boolean);
-                    const changes = diffArrayList(oldClasses, newClasses);
-                    if (changes.added.length || changes.removed.length) {
-                        mutation.target.dispatchEvent(new CustomEvent('tinyhtml.classchanged', {
-                            detail: changes,
-                        }));
-                    }
-                },
+    static #tinyObserver = typeof window !== 'undefined' && typeof window.document !== 'undefined'
+        ? new TinyElementObserver(window.document.documentElement, {
+            initDetectors: [
+                // Style Detector
+                [
+                    'tinyStyleEvent',
+                    (mutation) => {
+                        if (mutation.type !== 'attributes' ||
+                            mutation.attributeName !== 'style' ||
+                            !(mutation.target instanceof HTMLElement))
+                            return;
+                        const oldVal = mutation.oldValue || '';
+                        const newVal = mutation.target.getAttribute('style') || '';
+                        const oldStyles = TinyHtml.parseStyle(oldVal);
+                        const newStyles = TinyHtml.parseStyle(newVal);
+                        const changes = diffStrings(oldStyles, newStyles);
+                        if (Object.keys(changes.added).length ||
+                            Object.keys(changes.removed).length ||
+                            Object.keys(changes.modified).length) {
+                            mutation.target.dispatchEvent(new CustomEvent('tinyhtml.stylechanged', {
+                                detail: changes,
+                            }));
+                        }
+                    },
+                ],
+                // Class Detector
+                [
+                    'tinyClassEvent',
+                    (mutation) => {
+                        if (mutation.type !== 'attributes' ||
+                            mutation.attributeName !== 'class' ||
+                            !(mutation.target instanceof HTMLElement))
+                            return;
+                        const oldVal = mutation.oldValue || '';
+                        const newVal = mutation.target.className || '';
+                        const oldClasses = oldVal.split(/\s+/).filter(Boolean);
+                        const newClasses = newVal.split(/\s+/).filter(Boolean);
+                        const changes = diffArrayList(oldClasses, newClasses);
+                        if (changes.added.length || changes.removed.length) {
+                            mutation.target.dispatchEvent(new CustomEvent('tinyhtml.classchanged', {
+                                detail: changes,
+                            }));
+                        }
+                    },
+                ],
             ],
-        ],
-        initCfg: {
-            attributeOldValue: true,
-            attributes: true,
-            subtree: true,
-            attributeFilter: ['style', 'class'],
-        },
-    });
-    /** @returns {TinyElementObserver} */
+            initCfg: {
+                attributeOldValue: true,
+                attributes: true,
+                subtree: true,
+                attributeFilter: ['style', 'class'],
+            },
+        })
+        : undefined;
     static get tinyObserver() {
         return TinyHtml.#tinyObserver;
     }

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 "__#private@#ItemRegistry": Map<string, ItemDef>;
+    static #ItemRegistry: Map<string, ItemDef>;
     /**
      * Returns a deep-cloned snapshot of all registered items.
      * Ensures the caller cannot mutate the internal registry.