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

package/README.md

@@ -281,6 +281,13 @@ Tests
 - Added tests for HiddenInputBuilder, Lang, and async queue     
 
 
+## 4.1.0-beta.22
+
+- Bugfix: `faces.d.ts` circular type reference `const oam: typeof oam` (TS2502)
+  - The `build-dts.mjs` post-processor now correctly replaces the self-referential
+    `export const oam` declaration with an inlined `export namespace oam { ... }` block
+    containing the real member signatures (`setHiddenInput`, `clearHiddenInput`, `submitForm`).
+
 ## 4.1.0-beta.21
 
 - Performance improvements on DOM operations

package/dist/docs/index.html

@@ -249,6 +249,22 @@ 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-beta21" class="tsd-anchor-link">4.1.0-beta.21<a href="#410-beta21" 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>Performance improvements on DOM operations
+<ul>
+<li>Faster deep element lookups on large pages: shadow-root collection in <code>mona-dish</code>
+now iterates the raw <code>NodeList</code> 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).</li>
+</ul>
+</li>
+<li>Dependency update
+<ul>
+<li>Updated <code>mona-dish</code> to <code>0.50.0-beta.8</code></li>
+</ul>
+</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>
@@ -364,4 +380,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-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>
+</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-beta21"><span>4.1.0-<wbr/>beta.21</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.d.ts

@@ -289,5 +289,32 @@ declare namespace myfaces {
     /**
      * legacy oam functions
      */
-    export const oam: typeof oam;
+    export namespace oam {
+
+        /**
+         * sets a hidden input field
+         * @param formName the formName
+         * @param name the hidden field
+         * @param value the value to be rendered
+         */
+        export const setHiddenInput: (formName: string, name: string, value: string) => void;
+        /**
+         * clears a hidden input field
+         *
+         * @param formName formName for the input
+         * @param name the name of the input field
+         */
+        export const clearHiddenInput: (formName: string, name: string) => void;
+        /**
+         * does special form submit remapping
+         * re-maps the issuing command link into something,
+         * the "decode" of the command link on the server can understand
+         *
+         * @param formName
+         * @param linkId
+         * @param target
+         * @param params
+         */
+        export const submitForm: (formName: string, linkId?: string | null, target?: string | null, params?: Record<string, any> | [string, any][] | null) => boolean;
+    }
 }

package/dist/window/jsf.d.ts

@@ -288,5 +288,32 @@ declare namespace myfaces {
     /**
      * legacy oam functions
      */
-    export const oam: typeof oam;
+    export namespace oam {
+
+        /**
+         * sets a hidden input field
+         * @param formName the formName
+         * @param name the hidden field
+         * @param value the value to be rendered
+         */
+        export const setHiddenInput: (formName: string, name: string, value: string) => void;
+        /**
+         * clears a hidden input field
+         *
+         * @param formName formName for the input
+         * @param name the name of the input field
+         */
+        export const clearHiddenInput: (formName: string, name: string) => void;
+        /**
+         * does special form submit remapping
+         * re-maps the issuing command link into something,
+         * the "decode" of the command link on the server can understand
+         *
+         * @param formName
+         * @param linkId
+         * @param target
+         * @param params
+         */
+        export const submitForm: (formName: string, linkId?: string | null, target?: string | null, params?: Record<string, any> | [string, any][] | null) => boolean;
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsf.js_next_gen",
-  "version": "4.1.0-beta.21",
+  "version": "4.1.0-beta.22",
   "description": "A next generation typescript reimplementation of jsf.js",
   "main": "dist/window/faces.js",
   "scripts": {

package/scripts/build-dts.mjs

@@ -156,7 +156,7 @@ function makeGlobalDeclaration(content) {
       // Replace 'const oam: typeof oam;' with the inlined nested namespace.
       // 'export namespace' so that myfaces.oam is visible to TypeScript.
       content = content.replace(
-        /^([ \t]*)const oam: typeof oam;/m,
+        /^([ \t]*)(?:export )?const oam: typeof oam;/m,
         `$1export namespace oam {\n${inner}\n$1}`
       );
     }