Add m/py:progress events description

Author: WebReflection

docs/api.md

@@ -766,6 +766,52 @@ The following code demonstrates a `pyscript.WebSocket` in action.
     ws = WebSocket(url="ws://example.com/socket", onmessage=onmessage)
     ```
 
+### `pyscript.js_import`
+
+If a JavaScript module is only needed under certain circumstances, we provide
+an asynchronous way to import packages that were not originally referenced in
+your configuration.
+
+```html title="A pyscript.js_import example."
+<script type="py">
+from pyscript import js_import, window
+
+escaper, = await js_import("https://esm.run/html-escaper")
+
+window.console.log(escaper)
+```
+
+The `js_import` call returns an asynchronous tuple containing the JavaScript
+modules referenced as string arguments.
+
+### `pyscript.py_import`
+
+!!! warning
+
+    **This is an experimental feature.**
+
+    Feedback and bug reports are welcome!
+
+If you have a lot of Python packages referenced in your configuration, startup
+performance may be degraded as these are downloaded.
+
+If a Python package is only needed under certain circumstances, we provide an
+asynchronous way to import packages that were not originally referenced in your
+configuration.
+
+```html title="A pyscript.py_import example."
+<script type="py">
+from pyscript import py_import
+
+matplotlib, regex, = await py_import("matplotlib", "regex")
+
+print(matplotlib, regex)
+</script>
+```
+
+The `py_import` call returns an asynchronous tuple containing the Python
+modules provided by the packages referenced as string arguments.
+
 ## Main-thread only features
 
 ### `pyscript.PyWorker`
@@ -863,52 +909,6 @@ for el in document.querySelectorAll("[type='py'][worker][name]"):
 
 ## Worker only features
 
-### `pyscript.js_import`
-
-If a JavaScript module is only needed under certain circumstances, we provide
-an asynchronous way to import packages that were not originally referenced in
-your configuration.
-
-```html title="A pyscript.js_import example."
-<script type="py">
-from pyscript import js_import, window
-
-escaper, = await js_import("https://esm.run/html-escaper")
-
-window.console.log(escaper)
-```
-
-The `js_import` call returns an asynchronous tuple containing the JavaScript
-modules referenced as string arguments.
-
-### `pyscript.py_import`
-
-!!! warning
-
-    **This is an experimental feature.**
-
-    Feedback and bug reports are welcome!
-
-If you have a lot of Python packages referenced in your configuration, startup
-performance may be degraded as these are downloaded.
-
-If a Python package is only needed under certain circumstances, we provide an
-asynchronous way to import packages that were not originally referenced in your
-configuration.
-
-```html title="A pyscript.py_import example."
-<script type="py">
-from pyscript import py_import
-
-matplotlib, regex, = await py_import("matplotlib", "regex")
-
-print(matplotlib, regex)
-</script>
-```
-
-The `py_import` call returns an asynchronous tuple containing the Python
-modules provided by the packages referenced as string arguments.
-
 ### `pyscript.sync`
 
 A function used to pass serializable data from workers to the main thread. 

docs/faq.md

@@ -682,6 +682,22 @@ done"` message is written to the browser's console.
 </script>
 ```
 
+#### m/py:progress
+
+The `py:progress` or `mpy:progress` event triggers on the main thread *during* interpreter bootstrap, being this either on *main* or *worker*.
+
+Following previous work around progress events from *micropip*, the received `event.detail` will be a string that confine operations between `Loading {what}` and `Loaded {what}`, where the first event would hence be `Loading Pyodide` and the last one per each bootstrap would be `Loaded Pyodide`.
+
+In between all operations will be forwarded as `event.detail`, such as:
+
+  * `Loading files` and `Loaded files`, when `[files]` is found in the optional config
+  * `Loading fetch` and `Loaded fetch`, when `[fetch]` is found in the optional config
+  * `Loading JS modules` and `Loaded JS modules`, when `[js_modules.main]` or `[js_modules.worker]`
+is found in the optional config
+  * finally, all optional packages handled via *micropip* or *mip* will also trigger various `Loading ...` and `Loaded ...` events so that users can actually see what is going on while the *app* is bootstrapping
+
+An example of this listener applied to a dialog cna be found in here: https://agiammarchi.pyscriptapps.com/kmeans-in-panel-copy/v1/
+
 ### Packaging pointers
 
 Applications need third party packages and [PyScript can be configured to