feat!: change Lazy Data arguments signature with (resolve, reject)

Author: ghiscoding

README.md

@@ -110,7 +110,7 @@ Changes and new options:
   - `onClose(reason)` callback that will be executed when the dropdown closes (see [demo](https://ghiscoding.github.io/multiple-select-vanilla/#/events))
   - `preFilter` provide a Filter predicate to pre-filter data (see [demo](https://ghiscoding.github.io/multiple-select-vanilla/#/options40))
   - `preSort` provide a Sort Comparer to pre-sort data (see [demo](https://ghiscoding.github.io/multiple-select-vanilla/#/options41))
-  - `lazyData` provide a function callback that will return a Promise with data collection (see [demo](https://ghiscoding.github.io/multiple-select-vanilla/#/options42))
+  - `lazyData` provide a function with callback arguments to load data asynchronously (see [demo](https://ghiscoding.github.io/multiple-select-vanilla/#/options42))
 
 ## CSP Compliance
 The library is now CSP (Content Security Policy) compliant, there are however some exceptions to be aware of. When using any HTML strings as template (when using `textTemplate`, `labelTemplate`, `renderOptionLabelAsHtml` or `useSelectOptionLabelToHtml`), you will not be fully compliant unless you return [`TrustedHTML`](https://developer.mozilla.org/en-US/docs/Web/API/TrustedHTML). You can achieve this by using the `sanitizer` method in combo with an external library like [DOMPurify](https://github.com/cure53/DOMPurify) (recommended) to return `TrustedHTML` as shown below and with that in place you will be CSP compliant.
@@ -149,9 +149,12 @@ with this code in place, we can now use the following CSP meta tag (which is wha
 ### version 4.0
 - build ESM-Only and drop CJS (CommonJS) build (aka `require()`)
 
+
 ### version 5.0
 
-Locale management has been refactored to remove usage of the global `window` object. Locales are now provided via a modular registry and injected through options. This change affects how you load, switch, and reference locales. Also, the `multiple-select-` prefix has been removed from all locale import paths (single and merged) and no longer exists on the `window` object
+- **Locale management** has been refactored to remove usage of the global `window` object. Locales are now provided via a modular registry and injected through options. The `multiple-select-` prefix has been removed from all locale import paths (single and merged) and no longer exists on the `window` object.
+
+- **Lazy loading API change:** The `lazyData` option now uses a callback signature: `lazyData(resolve, reject)` instead of returning a Promise. This allows for more flexible async data loading and error handling. See the demo and documentation for updated usage examples.
 
 **Migration Example:**
 
@@ -172,6 +175,10 @@ Locale management has been refactored to remove usage of the global `window` obj
 + import { locales } from 'multiple-select-vanilla/dist/locales/all-locales.js';
 + // OR default import
 + import locales from 'multiple-select-vanilla/dist/locales/all-locales.js';
+
+// 3. lazyData option (old vs new)
+- lazyData: () => Promise<CollectionData>
++ lazyData: (resolve, reject) => void
 ```
 
 See the [Example09](https://ghiscoding.github.io/multiple-select-vanilla/#/example09) for details on dynamic locale loading.

packages/demo/src/options/options42.html

@@ -16,10 +16,12 @@ <h2 class="bd-title">
       </span>
     </h2>
     <div class="demo-subtitle">
-      Use <code>&#123; lazyData: () => Promise &#125;</code>to lazy load data only after clicking and opening the select dropdown. Note that
-      once the data is loaded, it no longer needs to be lazy loaded again and so re-opening the select dropdown will show instantly
-      afterward. You can refresh the page, or click the button to retest the lazy loading. Also note that any pre-selected options will only
-      show up after the data is fully loaded.
+      Use <code>&#123; lazyData: (resolve, reject) &#125;</code>to lazy load data, the 2 arguments are callback functions to call when the
+      data is ready. Lazy data will only be loaded once and reopening the dropdown will show instantly. If a failure happened and the
+      <code>reject</code> callback is called, it will be retried after you close and reopen the dropdown. For testing purposes, you can
+      refresh the page or click the button to retest the lazy loading. <br>
+      <strong>Note:</strong> any pre-selected options will only show up after the data is fully loaded (e.g. 4th select with "Filter &amp;
+      OK button").
     </div>
   </div>
 </div>
@@ -65,4 +67,12 @@ <h2 class="bd-title">
       <select id="group" class="full-width" multiple data-test="select4"></select>
     </div>
   </div>
+
+  <div class="mb-3 row">
+    <label class="col-sm-2">Lazy Data Failure</label>
+
+    <div class="col-sm-10">
+      <select id="group" class="full-width" multiple data-test="select5"></select>
+    </div>
+  </div>
 </div>