jsf.js_next_gen 4.1.0-beta.20 → 4.1.0-beta.21

package/README.md

@@ -281,6 +281,16 @@ Tests
 - Added tests for HiddenInputBuilder, Lang, and async queue     
 
 
+## 4.1.0-beta.21
+
+- Performance improvements on DOM operations
+  - Faster deep element lookups on large pages: shadow-root collection in `mona-dish`
+    now iterates the raw `NodeList` directly instead of materializing every element of
+    the page into intermediate arrays, avoiding several full-page-size array copies per
+    deep search (relevant for partial updates replacing very large DOM trees).
+- Dependency update
+  - Updated `mona-dish` to `0.50.0-beta.8`
+
 ## 4.1.0-beta.20
 
 - Bugfix: focus bug in the new refocus code of `mona-dish`

package/dist/docs/index.html

@@ -249,6 +249,40 @@ enqueues on separate instances to cancel each other's debounce window</li>
 <li>Added tests for ExtDomQuery (nonce DOM fallback, runHeadInserts text-node path) and ExtConfig (append, appendIf, deepCopy)</li>
 <li>Added tests for HiddenInputBuilder, Lang, and async queue</li>
 </ul>
+<h2 id="410-beta20" class="tsd-anchor-link">4.1.0-beta.20<a href="#410-beta20" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
+<ul>
+<li>Bugfix: focus bug in the new refocus code of <code>mona-dish</code>
+<ul>
+<li>Fixed upstream in <code>mona-dish</code> <code>0.50.0-beta.6</code>; the bundles are rebuilt against that version.</li>
+</ul>
+</li>
+<li>Dependency update
+<ul>
+<li>Updated <code>mona-dish</code> to <code>0.50.0-beta.6</code></li>
+</ul>
+</li>
+</ul>
+<h2 id="410-beta19" class="tsd-anchor-link">4.1.0-beta.19<a href="#410-beta19" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
+<ul>
+<li>Bugfix: Chromium error on huge DOM replacements
+<ul>
+<li>Partial responses replacing very large DOM trees (~150,000 nodes) failed on Chromium-based
+browsers because unchunked large arrays were passed in a single <code>push(...array)</code> /
+constructor-spread call, exceeding the engine's argument-count limit. <code>mona-dish</code> now
+appends in chunks of 30,000 elements (<code>pushChunked</code> / <code>Es2019ArrayFrom</code>), and all
+<code>DomQuery</code> node-list paths go through the chunk-safe code.</li>
+</ul>
+</li>
+<li>Dependency update
+<ul>
+<li>Updated <code>mona-dish</code> to <code>0.50.0-beta.5</code></li>
+</ul>
+</li>
+</ul>
+<h2 id="410-beta18" class="tsd-anchor-link">4.1.0-beta.18<a href="#410-beta18" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
+<ul>
+<li>Added missing ASL2 license headers</li>
+</ul>
 <h2 id="410-beta17" class="tsd-anchor-link">4.1.0-beta.17<a href="#410-beta17" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <ul>
 <li>Bugfix: caret position regression on partial updates
@@ -330,4 +364,4 @@ itself.</li>
 generative AI Tooling, as per <a href="https://www.apache.org/legal/generative-tooling.html">https://www.apache.org/legal/generative-tooling.html</a>
 disclosures now are added!
 See AI_CONTRIBUTIONS.md for full disclosure</p>
-</div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#🚀-scratchpad-for-the-typescript-based-reimplementation-of-jsfjs"><span>🚀 <wbr/>Scratchpad for the <wbr/>Type<wbr/>Script-<wbr/>based reimplementation of jsf.js</span></a><ul><li><a href="#what-is-this"><span>What is this?</span></a></li><li><a href="#status"><span>Status</span></a></li><li><ul><li><a href="#special-info"><span>Special <wbr/>Info</span></a></li><li><a href="#general-build"><span>General <wbr/>Build</span></a></li><li><ul><li><a href="#on-windows"><span>On <wbr/>Windows</span></a></li></ul></li><li><a href="#tests"><span>Tests</span></a></li><li><a href="#test-coverage"><span>Test <wbr/>Coverage</span></a></li><li><a href="#changelist-compared-to-the-original-implementation"><span>Changelist compared to the original implementation</span></a></li></ul></li><li><a href="#upload-support"><span>Upload <wbr/>Support</span></a></li><li><a href="#changes-since-40"><span>Changes since 4.0</span></a></li><li><a href="#changes-since-410-beta-10"><span>Changes since 4.1.0-<wbr/>beta-<wbr/>10</span></a></li><li><a href="#410-beta17"><span>4.1.0-<wbr/>beta.17</span></a></li><li><a href="#410-beta16"><span>4.1.0-<wbr/>beta.16</span></a></li><li><a href="#410-beta15"><span>4.1.0-<wbr/>beta.15</span></a></li><li><a href="#410-beta13-410-beta14"><span>4.1.0-<wbr/>beta.13 / 4.1.0-<wbr/>beta.14</span></a></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="modules.html">jsf.js_next_gen</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>
+</div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#🚀-scratchpad-for-the-typescript-based-reimplementation-of-jsfjs"><span>🚀 <wbr/>Scratchpad for the <wbr/>Type<wbr/>Script-<wbr/>based reimplementation of jsf.js</span></a><ul><li><a href="#what-is-this"><span>What is this?</span></a></li><li><a href="#status"><span>Status</span></a></li><li><ul><li><a href="#special-info"><span>Special <wbr/>Info</span></a></li><li><a href="#general-build"><span>General <wbr/>Build</span></a></li><li><ul><li><a href="#on-windows"><span>On <wbr/>Windows</span></a></li></ul></li><li><a href="#tests"><span>Tests</span></a></li><li><a href="#test-coverage"><span>Test <wbr/>Coverage</span></a></li><li><a href="#changelist-compared-to-the-original-implementation"><span>Changelist compared to the original implementation</span></a></li></ul></li><li><a href="#upload-support"><span>Upload <wbr/>Support</span></a></li><li><a href="#changes-since-40"><span>Changes since 4.0</span></a></li><li><a href="#changes-since-410-beta-10"><span>Changes since 4.1.0-<wbr/>beta-<wbr/>10</span></a></li><li><a href="#410-beta20"><span>4.1.0-<wbr/>beta.20</span></a></li><li><a href="#410-beta19"><span>4.1.0-<wbr/>beta.19</span></a></li><li><a href="#410-beta18"><span>4.1.0-<wbr/>beta.18</span></a></li><li><a href="#410-beta17"><span>4.1.0-<wbr/>beta.17</span></a></li><li><a href="#410-beta16"><span>4.1.0-<wbr/>beta.16</span></a></li><li><a href="#410-beta15"><span>4.1.0-<wbr/>beta.15</span></a></li><li><a href="#410-beta13-410-beta14"><span>4.1.0-<wbr/>beta.13 / 4.1.0-<wbr/>beta.14</span></a></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="modules.html">jsf.js_next_gen</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>

package/dist/window/faces-development.js

@@ -1055,15 +1055,46 @@ class DomQuery {
         if (queryRes.length) {
             found.push(queryRes);
         }
-        let shadowRoots = this.querySelectorAll("*").shadowRoot;
+        let shadowRoots = this._collectShadowRoots();
         if (shadowRoots.length) {
-            let shadowRes = shadowRoots.querySelectorAllDeep(queryStr);
+            let shadowRes = new DomQuery(shadowRoots).querySelectorAllDeep(queryStr);
             if (shadowRes.length) {
                 found.push(shadowRes);
             }
         }
         return new DomQuery(found);
     }
+    /**
+     * Collects the shadow roots hosted by the light-DOM descendants of each root
+     * node in a single pass.
+     *
+     * This replaces the prior `querySelectorAll("*").shadowRoot`, which
+     * materialized a DomQuery wrapping every element on the page and then walked
+     * that throwaway collection a second time through the shadowRoot getter. We
+     * still have to inspect every element - there is no CSS selector for "has a
+     * shadow root", so the cost stays O(number of elements) - but we drop the
+     * intermediate all-elements DomQuery and the redundant second traversal.
+     *
+     * @private
+     */
+    _collectShadowRoots() {
+        var _a, _b;
+        let shadowRoots = [];
+        for (let cnt = 0; cnt < ((_b = (_a = this === null || this === void 0 ? void 0 : this.rootNode) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0); cnt++) {
+            let root = this.rootNode[cnt];
+            if (!(root === null || root === void 0 ? void 0 : root.querySelectorAll)) {
+                continue;
+            }
+            let all = root.querySelectorAll("*");
+            for (let i = 0, len = all.length; i < len; i++) {
+                let shadowRoot = all[i].shadowRoot;
+                if (shadowRoot) {
+                    shadowRoots.push(shadowRoot);
+                }
+            }
+        }
+        return shadowRoots;
+    }
     /**
      * disabled flag
      */
@@ -1085,7 +1116,11 @@ class DomQuery {
     get childNodes() {
         let childNodeArr = [];
         this.eachElem((item) => {
-            childNodeArr = childNodeArr.concat(objToArray(item.childNodes));
+            // push the live childNodes list straight into the single target in
+            // chunks instead of concat(objToArray(...)) per root, which both
+            // copied each child list and reallocated the growing accumulator
+            // (O(roots * total children))
+            (0,_Es2019Array__WEBPACK_IMPORTED_MODULE_4__.pushChunked)(childNodeArr, item.childNodes);
         });
         return new DomQuery(childNodeArr);
     }
@@ -1339,6 +1374,11 @@ class DomQuery {
                 .filter(item => id == item.id)
                 .map(item => new DomQuery(item)));
         }
+        // a "deep" id search must collect matches across every scope: ids are
+        // unique only within a single node-tree, so the same id may legitimately
+        // exist in the light DOM and inside one or more shadow roots at once.
+        // We therefore cannot short-circuit on a light-DOM hit and must run the
+        // full deep search.
         let subItems = this.querySelectorAllDeep(`[id="${id}"]`);
         if (subItems.length) {
             res.push(subItems);
@@ -1355,9 +1395,12 @@ class DomQuery {
         var _a;
         let res = [];
         if (includeRoot) {
-            res = (0,_Es2019Array__WEBPACK_IMPORTED_MODULE_4__.Es2019ArrayFrom)((_a = this === null || this === void 0 ? void 0 : this.rootNode) !== null && _a !== void 0 ? _a : [])
-                .filter(element => (element === null || element === void 0 ? void 0 : element.tagName) == tagName)
-                .reduce((reduction, item) => reduction.concat([item]), res);
+            // append the matching roots in a single pass; the prior
+            // reduce(reduction.concat([item])) reallocated the accumulator on
+            // every match (O(matches^2))
+            let matchingRoots = (0,_Es2019Array__WEBPACK_IMPORTED_MODULE_4__.Es2019ArrayFrom)((_a = this === null || this === void 0 ? void 0 : this.rootNode) !== null && _a !== void 0 ? _a : [])
+                .filter(element => (element === null || element === void 0 ? void 0 : element.tagName) == tagName);
+            (0,_Es2019Array__WEBPACK_IMPORTED_MODULE_4__.pushChunked)(res, matchingRoots);
         }
         (deep) ? res.push(this.querySelectorAllDeep(tagName)) : res.push(this.querySelectorAll(tagName));
         return new DomQuery(res);
@@ -2457,7 +2500,11 @@ class DomQuery {
                 continue;
             }
             let res = this.rootNode[cnt].querySelectorAll(selector);
-            nodes = nodes.concat(objToArray(res));
+            // push the NodeList straight into the single target array in
+            // argument-stack-safe chunks; this avoids the objToArray copy plus
+            // the concat reallocation, which doubled a large result set (e.g. the
+            // querySelectorAll("*") shadow scan) on every root iteration
+            (0,_Es2019Array__WEBPACK_IMPORTED_MODULE_4__.pushChunked)(nodes, res);
         }
         return new DomQuery(nodes);
     }