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

package/AI_CONTRIBUTIONS.md

@@ -0,0 +1,71 @@
+# AI Contributions Disclosure
+
+In accordance with the [Apache Software Foundation policy on generative AI tooling](https://www.apache.org/legal/generative-tooling.html), this file discloses that portions of this project were created or substantially modified with assistance from generative AI tools.
+
+## Tool used
+
+**Claude** (Anthropic) — conversational AI coding assistant
+
+## Scope
+
+All new source files and substantial modifications introduced from the TypeScript 6 migration onwards (starting with commit `d609321` in http://github.com/werpu/jsf_js_ts) were produced with AI assistance. This covers both production source code and test code.
+
+### Newly created files (AI-generated)
+
+- `src/main/typescript/@types/definitions/modules.d.ts`
+- `src/main/typescript/api/_api_ae_stub.d.ts`
+- `src/main/typescript/test/api/JsfPushShimTest.spec.ts`
+- `src/main/typescript/test/api/PushTypeCompatibility.ts`
+- `src/main/typescript/test/impl/AssertionsTest.spec.ts`
+- `src/main/typescript/test/impl/FileUtilsTest.spec.ts`
+- `src/main/typescript/test/impl/ResponseDataResolverTest.spec.ts`
+- `src/main/typescript/test/impl/util/ExtLangTest.spec.ts`
+- `src/main/typescript/test/impl/util/HiddenInputBuilderTest.spec.ts`
+- `src/main/typescript/test/xhrCore/WebsocketTest.spec.ts`
+- `src/main/typescript/tsconfig.ae.json`
+- `scripts/build-dts.mjs`
+
+### Substantially modified files (AI-assisted)
+
+- `src/main/typescript/api/_api.ts`
+- `src/main/typescript/api/faces.ts`
+- `src/main/typescript/api/jsf.ts`
+- `src/main/typescript/impl/AjaxImpl.ts`
+- `src/main/typescript/impl/PushImpl.ts`
+- `src/main/typescript/impl/core/Const.ts`
+- `src/main/typescript/impl/util/Assertions.ts`
+- `src/main/typescript/impl/util/AsyncRunnable.ts`
+- `src/main/typescript/impl/util/ExtDomQuery.ts`
+- `src/main/typescript/impl/util/FileUtils.ts`
+- `src/main/typescript/impl/util/HiddenInputBuilder.ts`
+- `src/main/typescript/impl/util/Lang.ts`
+- `src/main/typescript/impl/util/XhrQueueController.ts`
+- `src/main/typescript/impl/xhrCore/ErrorData.ts`
+- `src/main/typescript/impl/xhrCore/EventData.ts`
+- `src/main/typescript/impl/xhrCore/IResponseProcessor.ts`
+- `src/main/typescript/impl/xhrCore/RequestDataResolver.ts`
+- `src/main/typescript/impl/xhrCore/Response.ts`
+- `src/main/typescript/impl/xhrCore/ResponseDataResolver.ts`
+- `src/main/typescript/impl/xhrCore/ResponseProcessor.ts`
+- `src/main/typescript/impl/xhrCore/XhrFormData.ts`
+- `src/main/typescript/impl/xhrCore/XhrRequest.ts`
+- `src/main/typescript/myfaces/OamSubmit.ts`
+- `src/main/typescript/test/frameworkBase/_ext/monadish/DomQueryTest.spec.ts`
+- `src/main/typescript/test/frameworkBase/_ext/shared/StandardInits.ts`
+- `src/main/typescript/test/impl/util/ExtDomQueryTest.spec.ts`
+- `src/main/typescript/test/myfaces/OamSubmit.spec.ts`
+- `src/main/typescript/test/queue/AsynchronousQueueTest.spec.ts`
+- `src/main/typescript/test/xhrCore/ErrorChainTest.spec.ts`
+- `src/main/typescript/test/xhrCore/FakeWebsocket.ts`
+- `src/main/typescript/test/xhrCore/RequestTest.spec.ts`
+- `src/main/typescript/test/xhrCore/ResponseTest.spec.ts`
+- `src/main/typescript/test/xhrCore/TobagoFileUploadTest.spec.ts`
+- `src/main/typescript/test/xhrCore/XhrFormDataTest.spec.ts`
+- `src/main/typescript/@types/definitions/index.d.ts`
+- `api-extractor.faces.json`
+
+## Nature of AI assistance
+
+The AI assistant was used interactively: the human author directed the work, reviewed all output, made corrections, 
+and approved each change before it was applied. 
+The AI did not commit code autonomously. All contributions remain under the Apache License 2.0.

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,178 @@ 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.
+  * JSF 2.3 jsf.push.init compatibility test added
+
+4.1.0-beta.12
+
+Bug Fixes
+
+- WebSocket push spec alignment (PushImpl.ts): Full compliance with the Jakarta Faces push specification on 4+ and 2.3 level
+  - hasEverConnected flag is now set before firing onopen callbacks (prevents re-entrant terminal-close edge case)
+  - Code 1000 (normal closure) is now always treated as terminal regardless of reason, per spec
+  - reconnectAttempts and hasEverConnected are reset after a terminal close, allowing faces.push.open() to re-establish a connection and fire onopen again
+- XhrQueueController debounce race condition: Each XhrQueueController instance now uses a unique debounce key — previously all instances shared one key, causing     
+  enqueues on separate instances to cancel each other's debounce window
+- Code cleanup: Removed dead exports from ResponseDataResolver.ts; minor cleanup in _api.ts and PushImpl.ts
+
+Improvements
+
+- PushImpl.ts readability: Lifecycle code refactored for clarity
+- FileUtils.ts: Minor code improvements (stricter equality, cleaner split)
+
+Tests
+
+- Added tests for WebSocket re-open after terminal close
+- Added XhrQueueController two-instance debounce isolation test
+- Added direct unit tests for FileUtils (encodeFormData, decodeEncodedValues, fixEmptyParameters)
+- Added tests for Assertions.ts — branch coverage up to ~88%
+- Added tests for ResponseDataResolver.resolveContexts
+- Added tests for ExtDomQuery (nonce DOM fallback, runHeadInserts text-node path) and ExtConfig (append, appendIf, deepCopy)
+- Added tests for HiddenInputBuilder, Lang, and async queue     
+
+
+## 4.1.0-beta.20
+
+- Bugfix: focus bug in the new refocus code of `mona-dish`
+  - Fixed upstream in `mona-dish` `0.50.0-beta.6`; the bundles are rebuilt against that version.
+- Dependency update
+  - Updated `mona-dish` to `0.50.0-beta.6`
+
+## 4.1.0-beta.19
+
+- Bugfix: Chromium error on huge DOM replacements
+  - Partial responses replacing very large DOM trees (~150,000 nodes) failed on Chromium-based
+    browsers because unchunked large arrays were passed in a single `push(...array)` /
+    constructor-spread call, exceeding the engine's argument-count limit. `mona-dish` now
+    appends in chunks of 30,000 elements (`pushChunked` / `Es2019ArrayFrom`), and all
+    `DomQuery` node-list paths go through the chunk-safe code.
+- Dependency update
+  - Updated `mona-dish` to `0.50.0-beta.5`
+
+## 4.1.0-beta.18
+
+- Added missing ASL2 license headers
+
+## 4.1.0-beta.17
+
+- Bugfix: caret position regression on partial updates
+  - After typing into an input that triggers an ajax request, the keyboard caret jumped to
+    the beginning of the field (e.g. typing `123` resulted in `321`). This regressed in
+    `mona-dish` `0.50.0-beta.3`'s caret restoration and is fixed there; the focused input now
+    keeps its caret whether a partial response re-renders a different component or the input
+    itself.
+- Dependency update
+  - Updated `mona-dish` to `0.50.0-beta.3`
+- Tests added
+  - Added two protocol-level regression tests (`ResponseTest`) reproducing the Tobago
+    `<tc:in>`/`<tc:out>` scenario: typing `123` keeps the caret in order for both the
+    "re-render only the output" and the "re-render the input itself" cases.
+
+## 4.1.0-beta.16
+
+- Dependency update
+  - Updated `mona-dish` to `0.50.0-beta.2`
+
+- Build / tooling improvements
+  - `dist/**`, `target/**`, `**/*.d.ts`, and `**/*.mjs` are now excluded from the `nyc` coverage report so only the implementation source is measured.
+  - Apache license header added to `dist/window/faces.d.ts` and `dist/window/jsf.d.ts` (prepended by the `build-dts` post-processing step).
+  - Apache license header added to `scripts/build-dts.mjs` and `webpack.config.ts`.
+
+## 4.1.0-beta.15
+
+- Tests added or expanded
+  - Added tests for `ExtDomQuery.runHeadInserts(false)` — covers the `suppressDoubleIncludes=false` path in `resourceIsNew` that bypasses deduplication.
+  - Added test for checked checkbox as issuing element with `execute="@none"` — covers `XhrRequest.appendIssuingItem` adding the element keyed by its ID when it is absent from the encoded form data.
+  - Added test verifying `execute="@none"` deletes `P_EXECUTE` from the pass-through context via `AjaxImpl.remapDefaultConstants`.
+  - Added unit tests for `StateHolder.hasNameSpace` — covers the getter returning `false` (no namespace prefix) and `true` (namespace prefix present).
+  - Added test for `ExtLang.getMessage` with a key that exists in `Messages` — covers the left branch of the `??` fallback chain.
+
+- Type system improvements
+  - `$faces()` in `Const.ts` now returns `typeof faces` instead of `any`, giving full type-safe access to the faces namespace throughout the implementation and catching typos at compile time.
+  - Stale hand-written method interface definitions (`IErrorData`, `IEventData`, `Ajax`, `Util`, `Push`, `FacesAPI`, `OAM`, `MyFacesAPI`) removed from `index.d.ts`; the `Window` augmentation now derives its types directly from `_api.ts` via `typeof faces` / `typeof myfaces`.
+  - `ErrorData` and `EventData` no longer implement the removed `IErrorData` / `IEventData` interfaces.
+
+- Build improvements
+  - Self-contained `dist/window/faces.d.ts` and `dist/window/jsf.d.ts` declaration files are now generated deterministically via `@microsoft/api-extractor` as part of the build (`npm run build-dts`).
+  - `jsf.d.ts` is derived from `faces.d.ts` by automated text transforms: namespace renamed to `jsf`, `contextpath` removed, `onerror` parameter removed from `push.init` (JSF 2.3 compatibility).
+  - A dedicated `tsconfig.ae.json` isolates the api-extractor compiler program from source `.ts` files, preventing the `ae-wrong-input-file-type` error caused by the `index.d.ts` import chain.
+  - Generated `faces.d.ts` is a strict superset of the Jakarta Faces specification `faces.d.ts` — all spec members are present; widened unions and additional optional fields are implementation extensions.
+  - `specversion`, `implversion`, `separatorchar`, and `contextpath` are now declared as `const` (matching the Jakarta Faces 5.0 spec) instead of `var` in both `_api.ts` and the generated declaration files.
+  - Post-processing now restores the missing `export` keyword on `const` namespace members in the generated `faces.d.ts` and `jsf.d.ts` (api-extractor omits it for `const` declarations); without it, members like `faces.specversion` would not be TypeScript-accessible.
+
+## 4.1.0-beta.13 / 4.1.0-beta.14
 
+- Added AI disclaimers to fulfill the ASF criteria for code being integrated into the Apache MyFaces codebase
+
+Note as of Version 4.0 starting with the ts6 conversion, the code has been improved with the help of 
+generative AI Tooling, as per https://www.apache.org/legal/generative-tooling.html
+disclosures now are added!
+See AI_CONTRIBUTIONS.md for full disclosure
 

package/api-extractor.faces.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
+
+  "mainEntryPointFilePath": "<projectFolder>/target/dts/src/main/typescript/api/_api.d.ts",
+
+  "compiler": {
+    "tsconfigFilePath": "<projectFolder>/src/main/typescript/tsconfig.ae.json"
+  },
+
+  "apiReport": {
+    "enabled": false
+  },
+
+  "docModel": {
+    "enabled": false
+  },
+
+  "dtsRollup": {
+    "enabled": true,
+    "untrimmedFilePath": "",
+    "publicTrimmedFilePath": "<projectFolder>/dist/window/faces.d.ts"
+  },
+
+  "tsdocMetadata": {
+    "enabled": false
+  },
+
+  "messages": {
+    "extractorMessageReporting": {
+      "ae-missing-release-tag": { "logLevel": "none" },
+      "ae-internal-missing-underscore": { "logLevel": "none" },
+      "ae-forgotten-export": { "logLevel": "none" }
+    },
+    "tsdocMessageReporting": {
+      "default": { "logLevel": "none" }
+    }
+  }
+}

package/dist/docs/assets/hierarchy.js

@@ -1 +1 @@
-window.hierarchyData = "eJyrVirKzy8pVrKKjtVRKkpNy0lNLsnMzwMKVNfWAgCbHgqm"
+window.hierarchyData = "eJyNjsEKgzAQRP9lz9GikiLeCu1XFA/BrJg2JrDZloLk35sI7cFTLnPYmdk3G5D3HGC4N90ogHC2OLHxLp02aLqsTq0IA1we6nNVrEDA0zgNQyvPAl5kk2ccI81qwnDatf6F64VXmxqTVSG9BA66yu3q38jmYqwmdHlFL1o5RgFNf0Df3ui4mL2nC+CJ1MojichTOSmnS0gxfgH5/Xio"

package/dist/docs/assets/navigation.js

@@ -1 +1 @@
-window.navigationData = "eJyNlMtOwzAQRf/F6wokqFh0C2wBgQSLqoupM21c4ge2k7ZC/Du2aZsH9TS7JHPmaHw18fybedx5NmMr4OjYhBnwZXiVuqgrdNfp81XpZRVqn0IVbDadMF6KqrCo2Gx+EsAGdrn+WBsnKYpn9Wittq1qVSvuhVY9WQv2vXfTn8nA1qDyo2wRJGwWv2p0l1QHivQ4E5rwougP+2dadFymdmUu9FgbFTqvNDVN8iSGOJRQgkgmKSJCGLQJU9GGiJBx1F5UuThibVwcJQhikuRJDDkK1yo+JcnJ1YAVsGxn6kB92e1NN1tpqgatC0PkVR2IUDk0YMFrGw5g87IeRukM8ouTdSBCtUZ/X4nwB36Emt7m8x+AxEYF8sXqDXL/5mFNbPgApJXvArcB87TvRJFLIveZa/dQGLWvGuS58I+KUCZih+W5Yxx7YUn9sOpBy1eEYk8pWoq+EtE2+AQyXHqhjRIO2TMBL34BrWRbeQ=="
+window.navigationData = "eJyNlk1z2yAQhv+Lzp5+pEk69a3jdKaXxJ10pj1kclhLG4tEAhWQE0+n/72AbQnJsHCU9uERgpeVHv4WGt90sSyeoERVLIoOdG0uW1H1Dar37va7WreNqb0wXhXLy0VR1qypJPJi+TAI4BneYuNtLUtyj396VHoluLsx6Ji5ls7lG6f09AEXV9f/FnPvutNMcJXpPdKUd82/SSnkCppmA+XLKNb7buqckTPphy+fP15dTMU75DpP7JMpMVTVcSqj86nnpXtV3zuCU+X15ZnNPj/LZkHCJg/rnlAdKdKjOjMIk6IDdmZ69Fxdr+pYrG0tK9ZrvmqEwu/AqwZleDOdbApmhMTuT47WB9PaW1QKtlnznaJp9bpDnuP1uJS0tEsW32sndAwRGcYZkTunsAhhEGbCCYNFyLD1mjWxsNlaVtjKGhgxE+dxDDmVr+aE3IAGoleeEKpBWmbWbYKeQKMJiKaNJiw67zGRGf3UoHsVDuEMSiVweHDSOUIp5w8pnrG08BbDQp9InpHDN9JZBtkOJIPNGDEPmvo++SrWds0OpTKZiqs8iFAp7ECCFtLkUcZlE4zSdVgmZ+ZBhGqLetUws1m/TU28xo/TDCQahCHDexpQxrd2rvzF8NUGivYNFHnm233kL/BYyGo/AtrQ4p8UpkwsO2xCr3EaCxuq//Ib0d4jVHtKMVL0/wPKHd5Ba/4QzDBKOGcDC/z4H/5457I="

package/dist/docs/assets/search.js

@@ -1 +1 @@
-window.searchData = "eJylmE1z2jAQhv+LzkzCynxf2x56aTvtTHpgmI6DlcSpbbm2Ickw/PeuZINWSCYK3JC1+74r60Ef3rFKvtRssdyxv2mRsMVowIo4F2zBHuK1qNmAbaoMW7lMNpmob/XTm6cmz7BrncV1jUELxvYDVyF+jl97BFSXR2XAyrgSRXO0N7ITopsk34svVSWro/rDplg3qSwsfRMXYKVTzvltVXCAn4q7zq8S/zaifsesC7rWqS5RV7xn1UZd4GWsyk391AOD6roYhnUmz9SvpXVISPG6Rq9LWqT986FNVMR1HrIUxXkPFXGBh7HYNGnWMwmq6/JJeIrT/tq1tA4JKV7XaFwiblxk0YjXpowbQ9I2rtL43gyDxHxsNMQnzctsK6oah9DrQ2Iu9qkFRsWNrPDdVL1OVtTlXqVYvzcmEnMxCY+i+ZSlGPYbe+RLLxMncdf4/ajks1g3v5r4sX8hOIm7xu8uFS8o0pw1OwZ9zMkY5W/+Dbh7fnYLJvMu49wz3wcR7D1f36EK/75473kDB+n4/gplWXyW+U8RJ29nHEzQFU64t4lqK75hqy4x7IzfaWig62qAu0ciXtlixw7/wAXjN9HNHOMfUpEl6gDWFoRqMs/bk0Yi1xv9c9WF3SG9slLBbfTtkA2WwwGf3UA0Wq0Gy0Oy7tAPDhrmiU4EbIEvEZxEsBI5trgvkTuJ3EqMsBX5EiMnMbISR9ga+RJHTuLIShxja+xLHDuJYytxgq2JL3HiJE6sxCm2pr7EqZM4tRJn2Jr5EmdO4sxKRIKWc1/i3Emc2wAoHsDLDrjwwAk9Gh8/Px6AbIJAcQFehsCFCGyKQLEBXo7ABQlskkDxAV6WwIUJbJpAMQJensAFCmyiQHECXqbAhQpsqkCxAl6uwAULbLJA8QJetsCFC2y6QDEDXr7ABQxswrhihnsJ4y5h3CaMK2a4lzDuEsZP1ii9SPlXKc8yZRPGFTPcSxh3Cese6SUe1/ZGJF/bpR5XaLU77tifbu3HwXRbzo5hvYvdfm/WemyR5V71KRe8TspCtNdcIkR0PiDT3l6NTGRkojAZfZk3AmQ8YcPp7ghEgUoEarSXPaMxNRLTMAV6hyC1kNcKYe+1O54ZjaGRGAYp4DFxrc/AL91ZmdQzIfVMQtXK9oRbtydhokZeE4S9J1Tb4hG2bs+5RGpGpGZBUtZ1iigRBCGMwfYWbiRILWGlHA/VpIw5KWMepKLP1OQfSSaeh828xPnOq/Z8S4TofzsMwvabgZEggwkbS/tZxggQ7sKwO36sMhojozEK1NAn68IcwslLIZjwMEzMVy0jMzYq4yCRk8s5AYYMD8LGZ12+iRIpCsKqaj/gEAnCHgSwhztVmZYiSwtMWa72+/8C3iCp";
+window.searchData = "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";

package/dist/docs/functions/faces.ajax.addOnError.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>addOnError | 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.ajax.html">ajax</a></li><li><a href="" aria-current="page">addOnError</a></li></ul><h1>Function addOnError</h1></div><section class="tsd-panel"><ul class="tsd-signatures"><li class=""><div class="tsd-signature tsd-anchor-link" id="addonerror"><span class="tsd-kind-call-signature">addOnError</span><span class="tsd-signature-symbol">(</span><span class="tsd-kind-parameter">errorFunc</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-symbol">(</span><span class="tsd-kind-parameter">data</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">ErrorData</span><span class="tsd-signature-symbol">)</span> <span class="tsd-signature-symbol">=&gt;</span> <span class="tsd-signature-type">void</span><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">void</span><a href="#addonerror" 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>Adds an error handler to our global error queue.
+<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>addOnError | 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><script async src="../assets/hierarchy.js" id="tsd-hierarchy-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.ajax.html">ajax</a></li><li><a href="" aria-current="page">addOnError</a></li></ul><h1>Function addOnError</h1></div><section class="tsd-panel"><ul class="tsd-signatures"><li class=""><div class="tsd-signature tsd-anchor-link" id="addonerror"><span class="tsd-kind-call-signature">addOnError</span><span class="tsd-signature-symbol">(</span><span class="tsd-kind-parameter">errorFunc</span><span class="tsd-signature-symbol">:</span> <a href="../types/faces.ajax.OnErrorCallback.html" class="tsd-signature-type tsd-kind-type-alias">OnErrorCallback</a><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">void</span><a href="#addonerror" 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>Adds an error handler to our global error queue.
 the error handler must be of the format <i>function errorListener(&lt;errorData&gt;)</i>
 with errorData being of following format:</p>
 <ul>
@@ -10,5 +10,5 @@ with errorData being of following format:</p>
     <li> eventData.responseCode: the response code (aka http request response code, 401 etc...) </li>
     <li> eventData.responseText: the request response text </li>
     <li> eventData.responseXML: the request response xml </li>
-</ul></div><div class="tsd-parameters"><h4 class="tsd-parameters-title">Parameters</h4><ul class="tsd-parameter-list"><li><span><span class="tsd-kind-parameter">errorFunc</span>: <span class="tsd-signature-symbol">(</span><span class="tsd-kind-parameter">data</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">ErrorData</span><span class="tsd-signature-symbol">)</span> <span class="tsd-signature-symbol">=&gt;</span> <span class="tsd-signature-type">void</span></span><div class="tsd-comment tsd-typography"><p>error handler must be of the format <i>function errorListener(&lt;errorData&gt;)</i></p>
+</ul></div><div class="tsd-parameters"><h4 class="tsd-parameters-title">Parameters</h4><ul class="tsd-parameter-list"><li><span><span class="tsd-kind-parameter">errorFunc</span>: <a href="../types/faces.ajax.OnErrorCallback.html" class="tsd-signature-type tsd-kind-type-alias">OnErrorCallback</a></span><div class="tsd-comment tsd-typography"><p>error handler must be of the format <i>function errorListener(&lt;errorData&gt;)</i></p>
 </div></li></ul></div><h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">void</span></h4></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>