jsf.js_next_gen 4.1.0-beta.1 → 4.1.0-beta.11

package/README.md

@@ -1,54 +1,53 @@
-# 🚀 Scratchpad for the typescript based reimplementation of jsf js
+# 🚀 Scratchpad for the TypeScript-based reimplementation of jsf.js
 
 ## What is this?
 
-This project is a work in progress for a next gen typescript based 
-reimplementation of jsf.js/faces.js
+This project is a work in progress for a next-generation TypeScript-based
+reimplementation of jsf.js/faces.js.
 
-The main goal is maintainability. It omits legacy browsers
-with Edge 14 and Ecmascript 2015 being the browser and ES baseline for the moment.
+The main goal is maintainability. It omits legacy browsers,
+with Edge 14 and ECMAScript 2015 as the browser and ES baseline for now.
 
-It uses functional constructs on micro scale
-to keep the maintainability and uses 
-my own [mona-dish](https://github.com/werpu/mona-dish/) project as core framework base, to avoid
-unnecessary colliding dependencies.
+It uses functional constructs on a small scale for maintainability and uses
+my own [mona-dish](https://github.com/werpu/mona-dish/) project as its core framework base to avoid
+unnecessary dependency collisions.
 
-But it still uses classes modules and inheritance
+But it still uses classes, modules, and inheritance
 for code structuring.
-The reason for this is, I do not like the one function for all
-approach, especially given we have Typescript now as implementation language
-which allows a proper code structuring and modularization.
+The reason for this is that I do not like the one-function-for-all
+approach, especially since TypeScript is now the implementation language
+and allows proper code structure and modularization.
 
 Webpack can take care of the packaging.
 
-Having smaller code parts, makes it easier to test certain
+Having smaller code parts makes it easier to test certain
 aspects of the implementation.
 
-Also one additional aspect of the new implementation: it has a proper
-test coverage via Mocha based unit tests.
+One additional aspect of the new implementation: it has proper
+test coverage via Mocha-based unit tests.
 
 This was also severely lacking in my old implementation
-where I just ran a set of 20 integration tests on macro scale.
+where I just ran a set of 20 integration tests on a macro scale.
 
 ## Status
 
 We now have a stable version!
-The current stable version (and first stable version is 4.0)
+The current stable version, and first stable version, is 4.0.
 Why 4.0 and not 1.0?
-The reason for this is, it is faces 4.0 compliant (but also faces 2.3 compliant)
-and also used in MyFaces 4.0.
-In order to avoid version confusion the projects stable version always will be in 
-sync with the Faces implementation level it provides now and in the future.
+The reason is that it is Faces 4.0 compliant, but also Faces 2.3 compliant,
+and is used in MyFaces 4.0.
+To avoid version confusion, the project's stable version will always stay
+in sync with the Faces implementation level it provides now and in the future.
 
-### Special info    
-Due to a small api change, if you want to embed the 4.0 version (faces.js)
+### Special Info
+Due to a small API change, if you want to embed the 4.0 version (faces.js)
 in your code, a new attribute specified by the Faces 4.0 spec is not set
-at its proper value, *contextpath*. This attribute atm is a value expression
+to its proper value: *contextpath*. This attribute is currently a value expression
 which needs to be set by the loading implementation.
 
-Now if you want to provide your own embedded solution and you will have
+If you want to provide your own embedded solution, you will have
 to set this value yourself. While my code does not use the attribute in the faces
-namespace, other libraries or the users might.
+namespace, other libraries or users might.
 
 If you serve the code from MyFaces 4 instead of embedding it, the value will be preset
 by the internal resource loader.
@@ -59,90 +58,91 @@ All other attributes behave the same in both versions as in the original legacy
 
 
 
-### General build 
+### General Build
 
-run 
-
-* npm install
+Run:
+* npm install ;to install the build time dependencies
+* npm run build
 
 #### On Windows
 
-if not done yet
+If not done yet:
 
 * npm install --global --production windows-build-tools
 
-run
+
+Run:
  
-* npm install
+* npm run build
 
 
 ### Tests
 
-run
+Run:
 
-* npm test
+* npm run test
 
 ### Test Coverage
 
-* npm coverage
+* npm run coverage
 
 
 
 ### Changelist compared to the original implementation
 
 * *no_portlet_env* is no more
-the configuration parameter 'no_portlet_env' has become obsolete with 
-jsf 2.3 which introduced a proper namespaced viewstate handling
-so it is gone now
+The configuration parameter `no_portlet_env` became obsolete with
+JSF 2.3, which introduced proper namespaced view state handling,
+so it is gone now.
 
 * pps disabled for the moment
 
-We had a special pps handling introduced in myfaces, a feature
+We had special PPS handling introduced in MyFaces, a feature
 probably never used (you basically could reduce the parameters
-sent down by sending a list of pps ids). I have disabled it for the time being.
-The code still is in there for the moment, but will be dropped
+sent down by sending a list of PPS IDs). I have disabled it for the time being.
+The code is still there for now, but it will be dropped
 if no demand arises to enable it again.
 
 * legacy browsers
 
-In order to improve the maintainability I have dropped a lot
+In order to improve maintainability, I have dropped a lot
 of shim and legacy code which was needed to support old browsers.
-Since our main aim is long term maintainability there is a clear cut.
+Since our main aim is long-term maintainability, there is a clear cut.
 The lowest supported browser for the moment is Edge 14.
-Older browsers are now cut off. This should suffice for most, if 
-not all important environments. If you still use an older browser than 
-Edge 14 you still can revert to the old codebase for the time being
-(final cutoff point probably will come within the next few years)
+Older browsers are now cut off. This should suffice for most, if
+not all, important environments. If you still use a browser older than
+Edge 14, you can still revert to the old codebase for the time being.
+The final cutoff point will probably come within the next few years.
 
 
 * performance
 
-Given that we now have faster browsers and end user devices in the mobile
-area than 10 years ago and the spec conformity has improved a lot, my main focus was maintainability.
-Maintainability and readability now comes before performance. So I sacrificed some
-of the performance to achieve it.
-Given that the most critical performance hits do not happen in the ajax area
+Given that we now have faster browsers and end-user devices in the mobile
+area than 10 years ago, and spec conformity has improved a lot, my main focus was maintainability.
+Maintainability and readability now come before performance, so I sacrificed some
+performance to achieve it.
+Given that the most critical performance hits do not happen in the AJAX area,
 this is a sacrifice I can live with, for the time being.
 
-* Client side i18n
+* Client-side i18n
 
-The client side i18n error message translations have become more
+The client-side i18n error message translations have become more
 of a liability than a feature.
-For the time being all client side errors are reported in english.
-I can reintroduce them, if there is real demand.
+For the time being, all client-side errors are reported in English.
+I can reintroduce them if there is real demand.
 But the size and maintainability tradeoff, compared to what they
-bring was not worth it to keep them anymore.
+bring, was not worth keeping them anymore.
  
 
 * Mapping file support
 
 The original implementation had various builds to support easier debugging (split, combined, compressed)
 
-We now have only two builds prod and development.
-However I have introduced a mapping file support.
+We now have only two builds: production and development.
+However, I have introduced mapping file support.
 To enable this support you have to reference the FacesJSMappingDecorator unless the mapping file
 is reachable via the normal request (mapping files are bundled).
-This works for normal includes, but if you include the jsf.js in a resource library you have to use
+This works for normal includes, but if you include jsf.js in a resource library, you have to use
 the decorator provided.
 
 Usage *faces-config.xml*
@@ -153,12 +153,12 @@ Usage *faces-config.xml*
 </application>
 ```
 
-This resource decorator detects automatically a faces*.js file coming from a resource library
-and adjusts the references in the resource accordingly to the request patterns
+This resource decorator automatically detects a faces*.js file coming from a resource library
+and adjusts the references in the resource according to the request patterns.
 
 ## Upload Support
 
-As non standard extension XMLHttpRequestUpload support is added
+As a non-standard extension, XMLHttpRequestUpload support is added.
 
 ```json
 faces.ajax.request(document.getElementById("cmd_eval"), null,
@@ -172,11 +172,11 @@ faces.ajax.request(document.getElementById("cmd_eval"), null,
             },
             preinit: (upload: XMLHttpRequestUpload) => preinitTriggered = true,
             loadstart: (upload: XMLHttpRequestUpload, event: ProgressEvent) => loadstartTriggered = true,
-            load: (upload: XMLHttpRequestUpload,  event: ProgressEvent) => loadTriggered = true,
-            loadend: (upload: XMLHttpRequestUpload,  event: ProgressEvent) => loadendTriggered = true,
-            error: (upload: XMLHttpRequestUpload,  event: ProgressEvent) => errorTriggered = true,
-            abort: (upload: XMLHttpRequestUpload,  event: ProgressEvent) => abortTriggered = true,
-            timeout: (upload: XMLHttpRequestUpload,  event: ProgressEvent) => timeoutTriggered = true,
+            load: (upload: XMLHttpRequestUpload, event: ProgressEvent) => loadTriggered = true,
+            loadend: (upload: XMLHttpRequestUpload, event: ProgressEvent) => loadendTriggered = true,
+            error: (upload: XMLHttpRequestUpload, event: ProgressEvent) => errorTriggered = true,
+            abort: (upload: XMLHttpRequestUpload, event: ProgressEvent) => abortTriggered = true,
+            timeout: (upload: XMLHttpRequestUpload, event: ProgressEvent) => timeoutTriggered = true,
         }
     }
 });
@@ -184,12 +184,70 @@ faces.ajax.request(document.getElementById("cmd_eval"), null,
 
 ## Changes since 4.0
 
-* Elimination of Streams in favor of native arrays
-* Providing an internal non intrusive shim for browsers which do not have array map and flapMap
-(older Edge and Chromium versions) - done in mona-dish
-* Adding a progress monitoring functionality under the myfaces namespace
-* Bugfixes which improve tck compliance
-* Integration in myfaces 4.0+ as default faces.js implementation
-
-
-
+* Core fixes
+    * Updated the codebase build to TypeScript 6.
+    * Fixed code for TypeScript 6's stronger type enforcement rules.
+    * Fixes cases like `404`/`500` with empty, HTML, invalid XML, or otherwise non-partial-response bodies being incorrectly reported as `malformedXML` or
+      `emptyResponse`.
+    * Malformed XML is now only reported as `malformedXML` for successful HTTP responses.
+    * XHR timeout now emits the timeout event and reports `httpError`.
+    * XHR abort now reports `httpError`.
+    * Fixed handling of browser-cancelled XHRs: cancellation-style responses (`status=0`, `readyState=4`, empty response text, and null XML), observed in older Safari/WebKit and Chrome/Chromium versions during navigation or download handoff, are treated as queue cleanup and do not fire user `onerror`.
+    * Multipart requests no longer get an explicit URL-encoded `Content-Type`; the browser can set the proper multipart boundary.
+    * WebSocket Faces `onerror` now matches the spec: reconnectable abnormal closes call `onerror` before reconnecting.
+    * WebSocket reconnect scheduling now keeps the correct `this` binding.
+    * WebSocket reconnect now increments attempts before scheduling, clears the stale socket, and creates a fresh socket on reconnect.
+    * `PushImpl.reset()` now closes existing sockets before clearing socket/component registries.
+    * Pending WebSocket callbacks now return cleanly if the channel registry has already been torn down.
+    * Preserved stale WebSocket component pruning when moving Faces `onerror` handling from native `WebSocket.onerror` to reconnectable close handling.
+    * The JSF 2.3 compatibility shim now adapts the old `jsf.push.init` signature without mutating the shared Faces 4 `faces.push` object.
+    * Push typings now include both the Faces 4 signature with `onerror` and the legacy JSF-compatible signature without it.
+    * Renamed the reference to the shared API to `myfacesApi` for code clarity.
+    * Cleaned up `myfaces.ab` init code in `jsf.ts` to match the `faces.ts` init code.
+
+* Core improvements
+    * Refactored upload callback registration in `XhrRequest` into `registerUploadCallbacks()`.
+    * Simplified timeout/header setup.
+    * Cleaned up and simplified `XhrFormData`.
+    * Clarified view state ordering so it is applied after field encoding and not double-counted.
+
+* Tests added or expanded
+    * Added tests for `4xx` non-XML responses returning `httpError`.
+    * Added tests for `5xx` valid XML responses still returning `httpError`.
+    * Added tests for successful empty responses returning `emptyResponse`.
+    * Added tests for successful malformed XML returning `malformedXML`.
+    * Added tests for XHR timeout behavior.
+    * Added tests for XHR abort behavior.
+    * Added tests for browser-cancelled XHR handling using the observed `status=0` cancellation fingerprint.
+    * Added or expanded `XhrFormData` tests for normal encoding, multi-value fields, view state, view state de-duplication, partial IDs, multipart detection,
+      `FormData` output, and naming-container remapping.
+    * Expanded WebSocket tests for Faces 4 `onerror`.
+    * Expanded WebSocket tests for abnormal-close reconnect behavior.
+    * Expanded WebSocket tests for cumulative reconnect delays and stale socket cleanup across consecutive failed reconnect attempts.
+    * Expanded WebSocket tests for terminal expired-close behavior.
+    * Expanded WebSocket tests for stale component cleanup.
+    * Expanded WebSocket tests for idempotent init.
+    * Expanded WebSocket tests for behavior dispatch.
+    * Expanded WebSocket tests for shared socket fan-out.
+    * Renamed the websocket test file from `WebsocketTest.ts` to `WebsocketTest.spec.ts`; the old name prevented the tests from running.
+
+
+## Changes since 4.1.0-beta-10
+
+* Core fixes
+
+  * Push/Websocket onOpen onClose callback lifecycle fixes according to spec behavior
+  * WebSocket `onopen` now fires only for the first connection attempt, not for automatic reconnects.
+  * Failed first WebSocket connection attempts are now treated as terminal: `onclose` is called, no reconnect is scheduled, and `onerror` is not called.
+  * WebSocket close code `1000` is now treated as terminal for any reason, not only `REASON_EXPIRED`.
+  * WebSocket close code `1008` (`Policy Violation`) is now treated as terminal and does not reconnect.
+  * WebSocket reconnect exhaustion now calls `onclose` and stops reconnecting after `MAX_RECONNECT_ATTEMPTS`.
+  * Terminal WebSocket closes now reset reconnect state so a later explicit `open()` starts as a fresh connection.
+
+* Tests added or expanded
+  * Added tests to verify the `onopen`/`onclose` callback lifecycle.
+  * Added tests that `onopen` is not fired again after a successful automatic reconnect.
+  * Added tests that reconnect attempts reset after a successful reconnect.
+  * Added tests that max reconnect exhaustion calls `onclose`.
+  * Added tests that close code `1008` is terminal and does not reconnect.
+  * Added tests that explicit `open()` after a terminal close fires `onopen` again as a fresh connection.

package/dist/docs/functions/faces.getClientWindow.html

@@ -1,3 +1,3 @@
-<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>getClientWindow | jsf.js_next_gen</title><meta name="description" content="Documentation for jsf.js_next_gen"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../index.html" class="title">jsf.js_next_gen</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="../modules/faces.html">faces</a></li><li><a href="" aria-current="page">getClientWindow</a></li></ul><h1>Function getClientWindow</h1></div><section class="tsd-panel"><ul class="tsd-signatures"><li class=""><div class="tsd-signature tsd-anchor-link" id="getclientwindow"><span class="tsd-kind-call-signature">getClientWindow</span><span class="tsd-signature-symbol">(</span><span class="tsd-kind-parameter">rootNode</span><span class="tsd-signature-symbol">?:</span> <span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">Element</span><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span><a href="#getclientwindow" 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></div><div class="tsd-description"><div class="tsd-comment tsd-typography"><p>returns the window identifier for the given node / window</p>
-</div><div class="tsd-parameters"><h4 class="tsd-parameters-title">Parameters</h4><ul class="tsd-parameter-list"><li><span><code class="tsd-tag">Optional</code><span class="tsd-kind-parameter">rootNode</span>: <span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">Element</span></span></li></ul></div><h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">string</span></h4><p>the window identifier or null if none is found</p>
+<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>getClientWindow | jsf.js_next_gen</title><meta name="description" content="Documentation for jsf.js_next_gen"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../index.html" class="title">jsf.js_next_gen</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="../modules/faces.html">faces</a></li><li><a href="" aria-current="page">getClientWindow</a></li></ul><h1>Function getClientWindow</h1></div><section class="tsd-panel"><ul class="tsd-signatures"><li class=""><div class="tsd-signature tsd-anchor-link" id="getclientwindow"><span class="tsd-kind-call-signature">getClientWindow</span><span class="tsd-signature-symbol">(</span><span class="tsd-kind-parameter">rootNode</span><span class="tsd-signature-symbol">?:</span> <span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">Element</span><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">null</span><a href="#getclientwindow" 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></div><div class="tsd-description"><div class="tsd-comment tsd-typography"><p>returns the window identifier for the given node / window</p>
+</div><div class="tsd-parameters"><h4 class="tsd-parameters-title">Parameters</h4><ul class="tsd-parameter-list"><li><span><code class="tsd-tag">Optional</code><span class="tsd-kind-parameter">rootNode</span>: <span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">Element</span></span></li></ul></div><h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">null</span></h4><p>the window identifier or null if none is found</p>
 </div></li></ul></section></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></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/docs/functions/faces.getProjectStage.html

@@ -1,4 +1,4 @@
-<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>getProjectStage | jsf.js_next_gen</title><meta name="description" content="Documentation for jsf.js_next_gen"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../index.html" class="title">jsf.js_next_gen</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="../modules/faces.html">faces</a></li><li><a href="" aria-current="page">getProjectStage</a></li></ul><h1>Function getProjectStage</h1></div><section class="tsd-panel"><ul class="tsd-signatures"><li class=""><div class="tsd-signature tsd-anchor-link" id="getprojectstage"><span class="tsd-kind-call-signature">getProjectStage</span><span class="tsd-signature-symbol">()</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span><a href="#getprojectstage" 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></div><div class="tsd-description"><div class="tsd-comment tsd-typography"><p>This method is responsible for the return of a given project stage as defined
+<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>getProjectStage | jsf.js_next_gen</title><meta name="description" content="Documentation for jsf.js_next_gen"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../index.html" class="title">jsf.js_next_gen</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="../modules/faces.html">faces</a></li><li><a href="" aria-current="page">getProjectStage</a></li></ul><h1>Function getProjectStage</h1></div><section class="tsd-panel"><ul class="tsd-signatures"><li class=""><div class="tsd-signature tsd-anchor-link" id="getprojectstage"><span class="tsd-kind-call-signature">getProjectStage</span><span class="tsd-signature-symbol">()</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">null</span><a href="#getprojectstage" 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></div><div class="tsd-description"><div class="tsd-comment tsd-typography"><p>This method is responsible for the return of a given project stage as defined
 by the jsf specification.</p>
 <p/>
 Valid return values are:
@@ -7,6 +7,6 @@ Valid return values are:
     <li>&quot;Development&quot;</li>
     <li>&quot;SystemTest&quot;</li>
     <li>&quot;UnitTest&quot;</li>
-</li></div><h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">string</span></h4><p>the current project state emitted by the server side method:
+</li></div><h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">null</span></h4><p>the current project state emitted by the server side method:
 <i>jakarta.faces.application.Application.getProjectStage()</i></p>
 </div></li></ul></section></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></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/docs/functions/faces.util.chain.html

@@ -1,6 +1,6 @@
-<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>chain | jsf.js_next_gen</title><meta name="description" content="Documentation for jsf.js_next_gen"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../index.html" class="title">jsf.js_next_gen</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="../modules/faces.html">faces</a></li><li><a href="../modules/faces.util.html">util</a></li><li><a href="" aria-current="page">chain</a></li></ul><h1>Function chain</h1></div><section class="tsd-panel"><ul class="tsd-signatures"><li class=""><div class="tsd-signature tsd-anchor-link" id="chain"><span class="tsd-kind-call-signature">chain</span><span class="tsd-signature-symbol">(</span><br/>    <span class="tsd-kind-parameter">source</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">HTMLElement</span><span class="tsd-signature-symbol">,</span><br/>    <span class="tsd-kind-parameter">event</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">Event</span><span class="tsd-signature-symbol">,</span><br/>    <span class="tsd-signature-symbol">...</span><span class="tsd-kind-parameter">funcs</span><span class="tsd-signature-symbol">:</span> (<span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">Function</span>)<span class="tsd-signature-symbol">[]</span><span class="tsd-signature-symbol">,</span><br/><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">boolean</span><a href="#chain" 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></div><div class="tsd-description"><div class="tsd-comment tsd-typography"><p>varargs function which executes a chain of code (functions or any other code)</p>
+<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>chain | jsf.js_next_gen</title><meta name="description" content="Documentation for jsf.js_next_gen"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../index.html" class="title">jsf.js_next_gen</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="../modules/faces.html">faces</a></li><li><a href="../modules/faces.util.html">util</a></li><li><a href="" aria-current="page">chain</a></li></ul><h1>Function chain</h1></div><section class="tsd-panel"><ul class="tsd-signatures"><li class=""><div class="tsd-signature tsd-anchor-link" id="chain"><span class="tsd-kind-call-signature">chain</span><span class="tsd-signature-symbol">(</span><br/>    <span class="tsd-kind-parameter">source</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">HTMLElement</span><span class="tsd-signature-symbol">,</span><br/>    <span class="tsd-kind-parameter">event</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">Event</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">null</span><span class="tsd-signature-symbol">,</span><br/>    <span class="tsd-signature-symbol">...</span><span class="tsd-kind-parameter">funcs</span><span class="tsd-signature-symbol">:</span> (<span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">Function</span>)<span class="tsd-signature-symbol">[]</span><span class="tsd-signature-symbol">,</span><br/><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">boolean</span><a href="#chain" 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></div><div class="tsd-description"><div class="tsd-comment tsd-typography"><p>varargs function which executes a chain of code (functions or any other code)</p>
 <p>if any of the code returns false, the execution
 is terminated prematurely skipping the rest of the code!</p>
-</div><div class="tsd-parameters"><h4 class="tsd-parameters-title">Parameters</h4><ul class="tsd-parameter-list"><li><span><span class="tsd-kind-parameter">source</span>: <span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">HTMLElement</span></span></li><li><span><span class="tsd-kind-parameter">event</span>: <span class="tsd-signature-type">Event</span></span></li><li><span><span class="tsd-signature-symbol">...</span><span class="tsd-kind-parameter">funcs</span>: (<span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">Function</span>)<span class="tsd-signature-symbol">[]</span></span><div class="tsd-comment tsd-typography"><p>... arbitrary array of functions or strings</p>
+</div><div class="tsd-parameters"><h4 class="tsd-parameters-title">Parameters</h4><ul class="tsd-parameter-list"><li><span><span class="tsd-kind-parameter">source</span>: <span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">HTMLElement</span></span></li><li><span><span class="tsd-kind-parameter">event</span>: <span class="tsd-signature-type">Event</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">null</span></span></li><li><span><span class="tsd-signature-symbol">...</span><span class="tsd-kind-parameter">funcs</span>: (<span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">Function</span>)<span class="tsd-signature-symbol">[]</span></span><div class="tsd-comment tsd-typography"><p>... arbitrary array of functions or strings</p>
 </div></li></ul></div><h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">boolean</span></h4><p>true if the chain has succeeded false otherwise</p>
 </div></li></ul></section></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></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>