Fix #2360 - Better shared env/setup handling (#2361 )

Intermediate release with async worker handler fixes (#2359 )
Update Polyscript with latest Micropython (#2357 )
2025-12-19 18:27:29 -05:00 · 2025-07-11 10:56:14 +02:00 · 2025-07-10 15:21:50 +02:00 · 2025-07-04 09:34:12 +02:00 · 2025-07-01 14:01:51 +02:00 · 2025-07-01 13:07:28 +02:00
103 changed files with 3066 additions and 650 deletions
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -28,19 +28,26 @@ repos:
      rev: 25.1.0
      hooks:
          - id: black
+            exclude: core/tests
            args: ["-l", "88", "--skip-string-normalization"]

    - repo: https://github.com/codespell-project/codespell
      rev: v2.4.1
      hooks:
          - id: codespell # See 'pyproject.toml' for args
-            exclude: \.js\.map$
+            exclude: fs\.py|\.js\.map$
            additional_dependencies:
                - tomli

+    - repo: https://github.com/astral-sh/ruff-pre-commit
+      rev: v0.11.8
+      hooks:
+          - id: ruff
+            exclude: core/tests
+
    - repo: https://github.com/hoodmane/pyscript-prettier-precommit
      rev: "v3.0.0-alpha.6"
      hooks:
          - id: prettier
-            exclude: core/test|core/dist|core/types|core/src/stdlib/pyscript.js|pyscript\.sw/|core/src/3rd-party
+            exclude: core/tests|core/dist|core/types|core/src/stdlib/pyscript.js|pyscript\.sw/|core/src/3rd-party
            args: [--tab-width, "4"]
--- a/.prettierignore
+++ b/.prettierignore
@@ -1,3 +1,4 @@
 ISSUE_TEMPLATE
 *.min.*
 package-lock.json
+bridge/
--- a/4
+++ b/4
@@ -41,8 +41,8 @@ check-python:
 # Check the environment, install the dependencies.
 setup: check-node check-npm check-python
 	cd core && npm ci && cd ..
-ifeq ($(VIRTUAL_ENV),)
-	echo "\n\n\033[0;31mCannot install Python dependencies. Your virtualenv is not activated.\033[0m"
+ifeq (,$(VIRTUAL_ENV)$(CONDA_PREFIX))
+	echo "\n\n\033[0;31mCannot install Python dependencies. Your virtualenv or conda env is not activated.\033[0m"
 	false
 else
 	python -m pip install -r requirements.txt
--- a/README.md
+++ b/README.md
@@ -13,15 +13,15 @@ Using PyScript is as simple as:
        <title>PyScript!</title>
        <link
            rel="stylesheet"
-            href="https://pyscript.net/snapshots/2024.9.2/core.css"
+            href="https://pyscript.net/releases/2025.7.2/core.css"
        />
        <script
            type="module"
-            src="https://pyscript.net/snapshots/2024.9.2/core.js"
+            src="https://pyscript.net/releases/2025.7.2/core.js"
        ></script>
    </head>
    <body>
-        <!-- Use MicroPython to evaluate some Python -->
+        <!-- type mpy (MicroPython) or py (Pyodide) to run some Python -->
        <script type="mpy" terminal>
            print("Hello, world!")
        </script>
@@ -83,3 +83,12 @@ documentation for more information on how to setup your development environment.

 The [PyScript organization governance](https://github.com/pyscript/governance)
 is documented in a separate repository.
+
+## Supporters
+
+PyScript is an independent open source project.
+
+However, PyScript was born at [Anaconda Inc](https://anaconda.com/) and its
+core contributors are currently employed by Anaconda to work on PyScript. We
+would like to acknowledge and celebrate Anaconda's continued support of this
+project. Thank you [Anaconda Inc](https://anaconda.com/)!
--- a/bridge/README.md
+++ b/bridge/README.md
@@ -0,0 +1,57 @@
+# @pyscript/bridge
+
+Import Python utilities directly in JS
+
+```js
+// main thread
+const { ffi: { func_a, func_b } } = await import('./test.js');
+
+// test.js
+import bridge from 'https://esm.run/@pyscript/bridge';
+export const ffi = bridge(import.meta.url, { type: 'mpy', worker: false });
+
+// test.py
+def func_a(value):
+    print(f"hello {value}")
+
+def func_b():
+    import sys
+    return sys.version
+```
+
+### Options
+
+  * **type**: `py` by default to bootstrap *Pyodide*.
+  * **worker**: `true` by default to bootstrap in a *Web Worker*.
+  * **config**: either a *string* or a PyScript compatible config *JS literal* to make it possible to bootstrap files and whatnot. If specified, the `worker` becomes implicitly `true` to avoid multiple configs conflicting on the main thread.
+  * **env**: to share the same environment across multiple modules loaded at different times.
+
+
+## Tests
+
+Run `npx mini-coi .` within this folder to then reach out `http://localhost:8080/test/` that will show:
+
+```
+PyScript Bridge
+------------------
+no config
+```
+
+The [test.js](./test/test.js) files uses the following defaults:
+
+  * `type` as `"mpy"`
+  * `worker` as `false`
+  * `config` as `undefined`
+  * `env` as `undefined`
+
+To test any variant use query string parameters so that `?type=py` will use `py` instead, `worker` will use a worker and `config` will use a basic *config* that brings in another file from the same folder which exposes the version.
+
+To recap: `http://localhost:8080/test/?type=py&worker&config` will show this instead:
+
+```
+PyScript Bridge
+------------------
+3.12.7 (main, May 15 2025, 18:47:24) ...
+```
+
+Please note when a *config* is used, the `worker` attribute is always `true`.
--- a/bridge/index.js
+++ b/bridge/index.js
@@ -0,0 +1,150 @@
+/*! (c) PyScript Development Team */
+
+const { stringify } = JSON;
+const { create, entries } = Object;
+
+/**
+ * Transform a list of keys into a Python dictionary.
+ * `['a', 'b']` => `{ "a": a, "b": b }`
+ * @param {Iterable<string>} keys
+ * @returns {string}
+ */
+const dictionary = keys => {
+  const fields = [];
+  for (const key of keys)
+    fields.push(`${stringify(key)}: ${key}`);
+  return `{ ${fields.join(',')} }`;
+};
+
+/**
+ * Resolve properly config files relative URLs.
+ * @param {string|Object} config - The configuration to normalize.
+ * @param {string} base - The base URL to resolve relative URLs against.
+ * @returns {string} - The JSON serialized config.
+ */
+const normalize = async (config, base) => {
+  if (typeof config === 'string') {
+    base = config;
+    config = await fetch(config).then(res => res.json());
+  }
+  if (typeof config.files === 'object') {
+    const files = {};
+    for (const [key, value] of entries(config.files)) {
+      files[key.startsWith('{') ? key : new URL(key, base)] = value;
+    }
+    config.files = files;
+  }
+  return stringify(config);
+};
+
+// this logic is based on a 3 levels cache ...
+const cache = new Map;
+
+/**
+ * Return a bridge to a Python module via a `.js` file that has a `.py` alter ego.
+ * @param {string} url - The URL of the JS module that has a Python counterpart.
+ * @param {Object} options - The options for the bridge.
+ * @param {string} [options.type='py'] - The `py` or `mpy` interpreter type, `py` by default.
+ * @param {boolean} [options.worker=true] - Whether to use a worker, `true` by default.
+ * @param {string|Object} [options.config=null] - The configuration for the bridge, `null` by default.
+ * @param {string} [options.env=null] - The optional shared environment to use.
+ * @param {string} [options.serviceWorker=null] - The optional service worker to use as fallback.
+ * @returns {Object} - The bridge to the Python module.
+ */
+export default (url, {
+  type = 'py',
+  worker = true,
+  config = null,
+  env = null,
+  serviceWorker = null,
+} = {}) => {
+  const { protocol, host, pathname } = new URL(url);
+  const py = pathname.replace(/\.m?js(?:\/\+\w+)?$/, '.py');
+  const file = `${protocol}//${host}${py}`;
+
+  // the first cache is about the desired file in the wild ...
+  if (!cache.has(file)) {
+    // the second cache is about all fields one needs to access out there
+    const exports = new Map;
+    let python;
+
+    cache.set(file, new Proxy(create(null), {
+      get(_, field) {
+        if (!exports.has(field)) {
+          // create an async callback once and always return the same later on
+          exports.set(field, async (...args) => {
+            // the third cache is about reaching lazily the code only once
+            // augmenting its content with exports once and drop it on done
+            if (!python) {
+              // do not await or multiple calls will fetch multiple times
+              // just assign the fetch `Promise` once and return it
+              python = fetch(file).then(async response => {
+                const code = await response.text();
+                // create a unique identifier for the Python context
+                const identifier = pathname.replace(/[^a-zA-Z0-9_]/g, '');
+                const name = `__pyscript_${identifier}${Date.now()}`;
+                // create a Python dictionary with all accessed fields
+                const detail = `{"detail":${dictionary(exports.keys())}}`;
+                // create the arguments for the `dispatchEvent` call
+                const eventArgs = `${stringify(name)},${name}to_ts(${detail})`;
+                // bootstrap the script element type and its attributes
+                const script = document.createElement('script');
+                script.type = type;
+
+                // if config is provided it needs to be a worker to avoid
+                // conflicting with main config on the main thread (just like always)
+                script.toggleAttribute('worker', !!config || !!worker);
+                if (config) {
+                  const attribute = await normalize(config, file);
+                  script.setAttribute('config', attribute);
+                }
+
+                if (env) script.setAttribute('env', env);
+                if (serviceWorker) script.setAttribute('service-worker', serviceWorker);
+
+                // augment the code with the previously accessed fields at the end
+                script.textContent = [
+                  '\n', code, '\n',
+                  // this is to avoid local scope name clashing
+                  `from pyscript import window as ${name}`,
+                  `from pyscript.ffi import to_js as ${name}to_ts`,
+                  `${name}.dispatchEvent(${name}.CustomEvent.new(${eventArgs}))`,
+                  // remove these references even if non-clashing to keep
+                  // the local scope clean from undesired entries
+                  `del ${name}`,
+                  `del ${name}to_ts`,
+                ].join('\n');
+
+                // let PyScript resolve and execute this script
+                document.body.appendChild(script);
+
+                // intercept once the unique event identifier with all exports
+                globalThis.addEventListener(
+                  name,
+                  event => {
+                    resolve(event.detail);
+                    script.remove();
+                  },
+                  { once: true }
+                );
+
+                // return a promise that will resolve only once the event
+                // has been emitted and the interpreter evaluated the code
+                const { promise, resolve } = Promise.withResolvers();
+                return promise;
+              });
+            }
+
+            // return the `Promise` that will after invoke the exported field
+            return python.then(foreign => foreign[field](...args));
+          });
+        }
+
+        // return the lazily to be resolved once callback to invoke
+        return exports.get(field);
+      }
+    }));
+  }
+
+  return cache.get(file);
+};
--- a/bridge/package.json
+++ b/bridge/package.json
@@ -0,0 +1,27 @@
+{
+  "name": "@pyscript/bridge",
+  "version": "0.1.0",
+  "description": "A JS based way to use PyScript modules",
+  "type": "module",
+  "module": "./index.js",
+  "unpkg": "./index.js",
+  "jsdelivr": "./jsdelivr.js",
+  "browser": "./index.js",
+  "main": "./index.js",
+  "keywords": [
+    "PyScript",
+    "JS",
+    "Python",
+    "bridge"
+  ],
+  "author": "Anaconda Inc.",
+  "license": "APACHE-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pyscript/pyscript.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pyscript/pyscript/issues"
+  },
+  "homepage": "https://github.com/pyscript/pyscript#readme"
+}
--- a/bridge/test/index.html
+++ b/bridge/test/index.html
@@ -0,0 +1,33 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="utf-8">
+        <meta name="viewport" content="width=device-width,initial-scale=1">
+        <title>PyScript Bridge</title>
+        <style>body { font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif; }</style>
+        <link rel="stylesheet" href="https://pyscript.net/releases/2025.5.1/core.css" />
+        <script type="module" src="https://pyscript.net/releases/2025.5.1/core.js"></script>
+        <!-- for local testing purpose only-->
+        <script type="importmap">{"imports":{"https://esm.run/@pyscript/bridge":"../index.js"}}</script>
+        <script type="module">
+          const { ffi: { test_func, test_other, version } } = await import('./test.js');
+
+          console.time("⏱️ first invoke");
+          const result = await test_func("PyScript Bridge");
+          console.timeEnd("⏱️ first invoke");
+
+          document.body.append(
+            Object.assign(
+              document.createElement("h3"),
+              { textContent: result },
+            ),
+            document.createElement("hr"),
+            await version(),
+          );
+
+          console.time("⏱️ other invokes");
+          await test_other("🐍");
+          console.timeEnd("⏱️ other invokes");
+        </script>
+    </head>
+</html>
--- a/bridge/test/remote/index.html
+++ b/bridge/test/remote/index.html
@@ -0,0 +1,40 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="utf-8">
+        <meta name="viewport" content="width=device-width,initial-scale=1">
+        <title>PyScript Bridge</title>
+        <script type="importmap">
+          {
+            "imports": {
+              "https://esm.run/@pyscript/bridge": "https://esm.run/@pyscript/bridge@latest",
+              "https://esm.run/@pyscript/bridge/test/test.js": "https://esm.run/@pyscript/bridge@latest/test/test.js"
+            }
+          }
+        </script>
+        <style>body { font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Open Sans', 'Helvetica Neue', sans-serif; }</style>
+        <link rel="stylesheet" href="https://pyscript.net/releases/2025.5.1/core.css" />
+        <script type="module" src="https://pyscript.net/releases/2025.5.1/core.js"></script>
+        <script type="module">
+          const cdn_test = 'https://esm.run/@pyscript/bridge/test/test.js';
+          const { ffi: { test_func, test_other, version } } = await import(cdn_test);
+
+          console.time("⏱️ first invoke");
+          const result = await test_func("PyScript Bridge");
+          console.timeEnd("⏱️ first invoke");
+
+          document.body.append(
+            Object.assign(
+              document.createElement("h3"),
+              { textContent: result },
+            ),
+            document.createElement("hr"),
+            await version(),
+          );
+
+          console.time("⏱️ other invokes");
+          await test_other("🐍");
+          console.timeEnd("⏱️ other invokes");
+        </script>
+    </head>
+</html>
--- a/bridge/test/sys_version.py
+++ b/bridge/test/sys_version.py
@@ -0,0 +1,5 @@
+import sys
+
+
+def version():
+    return sys.version
--- a/bridge/test/test.js
+++ b/bridge/test/test.js
@@ -0,0 +1,17 @@
+import bridge from "https://esm.run/@pyscript/bridge";
+
+// for local testing purpose only
+const { searchParams } = new URL(location.href);
+
+// the named (or default) export for test.py
+export const ffi = bridge(import.meta.url, {
+  env: searchParams.get("env"),
+  type: searchParams.get("type") || "mpy",
+  worker: searchParams.has("worker"),
+  config: searchParams.has("config") ?
+    ({
+      files: {
+        "./sys_version.py": "./sys_version.py",
+      },
+    }) : undefined,
+});
--- a/bridge/test/test.py
+++ b/bridge/test/test.py
@@ -0,0 +1,22 @@
+from pyscript import config, RUNNING_IN_WORKER
+
+type = config["type"]
+print(f"{type}-script", RUNNING_IN_WORKER and "worker" or "main")
+
+
+def test_func(message):
+    print("Python", message)
+    return message
+
+
+def test_other(message):
+    print("Python", message)
+    return message
+
+
+def version():
+    try:
+        from sys_version import version
+    except ImportError:
+        version = lambda: "no config"
+    return version()
--- a/core/LICENSE
+++ b/core/LICENSE
@@ -0,0 +1,205 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+
+   Copyright (c) 2022-present, PyScript Development Team
+
+   Originated at Anaconda, Inc. in 2022
+
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
--- a/core/package-lock.json
+++ b/core/package-lock.json
--- a/core/package.json
+++ b/core/package.json
@@ -1,6 +1,6 @@
 {
    "name": "@pyscript/core",
-    "version": "0.6.26",
+    "version": "0.6.65",
    "type": "module",
    "description": "PyScript",
    "module": "./index.js",
@@ -25,12 +25,19 @@
            "types": "./types/core.d.ts",
            "import": "./src/core.js"
        },
+        "./js": {
+            "types": "./types/core.d.ts",
+            "import": "./dist/core.js"
+        },
        "./css": {
            "import": "./dist/core.css"
        },
        "./storage": {
            "import": "./dist/storage.js"
        },
+        "./service-worker": {
+            "import": "./dist/service-worker.js"
+        },
        "./package.json": "./package.json"
    },
    "scripts": {
@@ -43,7 +50,7 @@
        "build:3rd-party": "node rollup/3rd-party.cjs",
        "build:tests-index": "node rollup/build_test_index.cjs",
        "clean:3rd-party": "rm src/3rd-party/*.js && rm src/3rd-party/*.css",
-        "test:integration": "npm run test:ws; static-handler --coi . 2>/dev/null & SH_PID=$!; EXIT_CODE=0; playwright test tests/js_tests.spec.js tests/py_tests.spec.js || EXIT_CODE=$?; kill $SH_PID 2>/dev/null; exit $EXIT_CODE",
+        "test:integration": "npm run test:ws; static-handler --coi . 2>/dev/null & SH_PID=$!; EXIT_CODE=0; (playwright test tests/js_tests.spec.js && playwright test tests/py_tests.main.spec.js && playwright test tests/py_tests.worker.spec.js) || EXIT_CODE=$?; kill $SH_PID 2>/dev/null; exit $EXIT_CODE",
        "test:ws": "bun tests/javascript/ws/index.js & playwright test tests/javascript/ws/index.spec.js",
        "dev": "node dev.cjs",
        "release": "npm run build && npm run zip",
@@ -60,40 +67,40 @@
    "dependencies": {
        "@ungap/with-resolvers": "^0.1.0",
        "@webreflection/idb-map": "^0.3.2",
+        "@webreflection/utils": "^0.1.1",
        "add-promise-listener": "^0.1.3",
        "basic-devtools": "^0.1.6",
-        "polyscript": "^0.16.11",
-        "sabayon": "^0.6.6",
+        "polyscript": "^0.18.3",
        "sticky-module": "^0.1.1",
        "to-json-callback": "^0.1.1",
        "type-checked-collections": "^0.1.7"
    },
    "devDependencies": {
-        "@codemirror/commands": "^6.8.0",
-        "@codemirror/lang-python": "^6.1.7",
-        "@codemirror/language": "^6.10.8",
+        "@codemirror/commands": "^6.8.1",
+        "@codemirror/lang-python": "^6.2.1",
+        "@codemirror/language": "^6.11.2",
        "@codemirror/state": "^6.5.2",
-        "@codemirror/view": "^6.36.2",
-        "@playwright/test": "1.45.3",
-        "@rollup/plugin-commonjs": "^28.0.2",
-        "@rollup/plugin-node-resolve": "^16.0.0",
+        "@codemirror/view": "^6.38.0",
+        "@playwright/test": "^1.54.0",
+        "@rollup/plugin-commonjs": "^28.0.6",
+        "@rollup/plugin-node-resolve": "^16.0.1",
        "@rollup/plugin-terser": "^0.4.4",
-        "@webreflection/toml-j0.4": "^1.1.3",
+        "@webreflection/toml-j0.4": "^1.1.4",
        "@xterm/addon-fit": "^0.10.0",
        "@xterm/addon-web-links": "^0.11.0",
        "@xterm/xterm": "^5.5.0",
-        "bun": "^1.2.2",
+        "bun": "^1.2.18",
        "chokidar": "^4.0.3",
        "codedent": "^0.1.2",
-        "codemirror": "^6.0.1",
-        "eslint": "^9.19.0",
-        "flatted": "^3.3.2",
-        "rollup": "^4.34.4",
+        "codemirror": "^6.0.2",
+        "eslint": "^9.30.1",
+        "flatted": "^3.3.3",
+        "rollup": "^4.44.2",
        "rollup-plugin-postcss": "^4.0.2",
        "rollup-plugin-string": "^3.0.0",
        "static-handler": "^0.5.3",
        "string-width": "^7.2.0",
-        "typescript": "^5.7.3",
+        "typescript": "^5.8.3",
        "xterm-readline": "^1.1.2"
    },
    "repository": {
--- a/core/rollup/core.config.js
+++ b/core/rollup/core.config.js
@@ -53,4 +53,15 @@ export default [
            sourcemap: true,
        },
    },
+    {
+        input: "./src/service-worker.js",
+        plugins: plugins.concat(
+            process.env.NO_MIN
+                ? [nodeResolve(), commonjs()]
+                : [nodeResolve(), commonjs(), terser()],
+        ),
+        output: {
+            file: "./dist/service-worker.js",
+        },
+    },
 ];
--- a/core/src/3rd-party-licenses/codemirror.license.txt
+++ b/core/src/3rd-party-licenses/codemirror.license.txt
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (C) 2018-2021 by Marijn Haverbeke <marijnh@gmail.com> and others
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
--- a/core/src/3rd-party-licenses/codemirror_commands.license.txt
+++ b/core/src/3rd-party-licenses/codemirror_commands.license.txt
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (C) 2018-2021 by Marijn Haverbeke <marijn@haverbeke.berlin> and others
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
--- a/core/src/3rd-party-licenses/codemirror_lang-python.license.txt
+++ b/core/src/3rd-party-licenses/codemirror_lang-python.license.txt
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (C) 2018-2021 by Marijn Haverbeke <marijn@haverbeke.berlin> and others
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
--- a/core/src/3rd-party-licenses/codemirror_language.license.txt
+++ b/core/src/3rd-party-licenses/codemirror_language.license.txt
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (C) 2018-2021 by Marijn Haverbeke <marijn@haverbeke.berlin> and others
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
--- a/core/src/3rd-party-licenses/codemirror_state.license.txt
+++ b/core/src/3rd-party-licenses/codemirror_state.license.txt
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (C) 2018-2021 by Marijn Haverbeke <marijn@haverbeke.berlin> and others
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
--- a/core/src/3rd-party-licenses/codemirror_view.license.txt
+++ b/core/src/3rd-party-licenses/codemirror_view.license.txt
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (C) 2018-2021 by Marijn Haverbeke <marijn@haverbeke.berlin> and others
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
--- a/core/src/3rd-party-licenses/toml.license.txt
+++ b/core/src/3rd-party-licenses/toml.license.txt
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Jak Wings
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
--- a/core/src/3rd-party-licenses/xterm-readline.license.txt
+++ b/core/src/3rd-party-licenses/xterm-readline.license.txt
@@ -0,0 +1,25 @@
+Copyright 2021 Erik Bremen
+
+Permission is hereby granted, free of charge, to any
+person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the
+Software without restriction, including without
+limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice
+shall be included in all copies or substantial portions
+of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
+SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
--- a/core/src/3rd-party-licenses/xterm.license.txt
+++ b/core/src/3rd-party-licenses/xterm.license.txt
@@ -0,0 +1,21 @@
+Copyright (c) 2017-2019, The xterm.js authors (https://github.com/xtermjs/xterm.js)
+Copyright (c) 2014-2016, SourceLair Private Company (https://www.sourcelair.com)
+Copyright (c) 2012-2013, Christopher Jeffrey (https://github.com/chjj/)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
--- a/core/src/3rd-party-licenses/xterm_addon-fit.license.txt
+++ b/core/src/3rd-party-licenses/xterm_addon-fit.license.txt
@@ -0,0 +1,19 @@
+Copyright (c) 2019, The xterm.js authors (https://github.com/xtermjs/xterm.js)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
--- a/core/src/3rd-party-licenses/xterm_addon-web-links.lixense.txt
+++ b/core/src/3rd-party-licenses/xterm_addon-web-links.lixense.txt
@@ -0,0 +1,19 @@
+Copyright (c) 2017, The xterm.js authors (https://github.com/xtermjs/xterm.js)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
--- a/core/src/3rd-party/README.md
+++ b/core/src/3rd-party/README.md
@@ -5,3 +5,7 @@ This folder contains artifacts created via [3rd-party.cjs](../../rollup/3rd-part
 As we would like to offer a way to run PyScript offline, and we already offer a `dist` folder with all the necessary scripts, we have created a foreign dependencies resolver that allow to lazy-load CDN dependencies out of the box.

 Please **note** these dependencies are **not interpreters**, because interpreters have their own mechanism, folders structure, WASM files, and whatnot, to work locally, but at least XTerm or the TOML parser, among other lazy dependencies, should be available within the dist folder.
+
+## Licenses
+
+All licenses provided by 3rd-party authors can be found in [3rd-party-licenses](../3rd-party-licenses/) folder.
--- a/core/src/3rd-party/xterm-readline.js
+++ b/core/src/3rd-party/xterm-readline.js
@@ -1,5 +1,5 @@
 /**
- * Bundled by jsDelivr using Rollup v2.79.1 and Terser v5.19.2.
+ * Bundled by jsDelivr using Rollup v2.79.2 and Terser v5.39.0.
 * Original file: /npm/xterm-readline@1.1.2/lib/readline.js
 *
 * Do NOT use SRI with dynamically generated files! More information: https://www.jsdelivr.com/using-sri-with-dynamic-files
--- a/core/src/3rd-party/xterm.css
+++ b/core/src/3rd-party/xterm.css
@@ -1,5 +1,5 @@
 /**
- * Minified by jsDelivr using clean-css v5.3.2.
+ * Minified by jsDelivr using clean-css v5.3.3.
 * Original file: /npm/@xterm/xterm@5.5.0/css/xterm.css
 *
 * Do NOT use SRI with dynamically generated files! More information: https://www.jsdelivr.com/using-sri-with-dynamic-files
--- a/core/src/3rd-party/xterm.js
+++ b/core/src/3rd-party/xterm.js
--- a/core/src/3rd-party/xterm_addon-fit.js
+++ b/core/src/3rd-party/xterm_addon-fit.js
@@ -1,5 +1,5 @@
 /**
- * Bundled by jsDelivr using Rollup v2.79.1 and Terser v5.19.2.
+ * Bundled by jsDelivr using Rollup v2.79.2 and Terser v5.39.0.
 * Original file: /npm/@xterm/addon-fit@0.10.0/lib/addon-fit.js
 *
 * Do NOT use SRI with dynamically generated files! More information: https://www.jsdelivr.com/using-sri-with-dynamic-files
--- a/core/src/3rd-party/xterm_addon-web-links.js
+++ b/core/src/3rd-party/xterm_addon-web-links.js
@@ -1,5 +1,5 @@
 /**
- * Bundled by jsDelivr using Rollup v2.79.1 and Terser v5.19.2.
+ * Bundled by jsDelivr using Rollup v2.79.2 and Terser v5.39.0.
 * Original file: /npm/@xterm/addon-web-links@0.11.0/lib/addon-web-links.js
 *
 * Do NOT use SRI with dynamically generated files! More information: https://www.jsdelivr.com/using-sri-with-dynamic-files
--- a/core/src/all-done.js
+++ b/core/src/all-done.js
@@ -1,3 +1,4 @@
+import withResolvers from "@webreflection/utils/with-resolvers";
 import TYPES from "./types.js";

 const waitForIt = [];
@@ -5,7 +6,7 @@ const waitForIt = [];
 for (const [TYPE] of TYPES) {
    const selectors = [`script[type="${TYPE}"]`, `${TYPE}-script`];
    for (const element of document.querySelectorAll(selectors.join(","))) {
-        const { promise, resolve } = Promise.withResolvers();
+        const { promise, resolve } = withResolvers();
        waitForIt.push(promise);
        element.addEventListener(`${TYPE}:done`, resolve, { once: true });
    }
--- a/core/src/config.js
+++ b/core/src/config.js
@@ -154,6 +154,9 @@ for (const [TYPE] of TYPES) {
        return await Promise.all(toBeAwaited);
    };

+    if (Number.isSafeInteger(parsed?.experimental_ffi_timeout))
+        globalThis.reflected_ffi_timeout = parsed?.experimental_ffi_timeout;
+
    configs.set(TYPE, { config: parsed, configURL, plugins, error });
 }

--- a/core/src/core.css
+++ b/core/src/core.css
@@ -28,53 +28,34 @@ mpy-config {
 .py-editor-run-button,
 .mpy-editor-run-button {
    position: absolute;
+    display: flex;
    right: 0.5rem;
    bottom: 0.5rem;
    opacity: 0;
    transition: opacity 0.25s;
    z-index: 1;
+    padding: 0;
 }
 .py-editor-box:hover .py-editor-run-button,
 .mpy-editor-box:hover .mpy-editor-run-button,
 .py-editor-run-button:focus,
-.py-editor-run-button:disabled,
+.py-editor-run-button.running,
 .mpy-editor-run-button:focus,
-.mpy-editor-run-button:disabled {
+.mpy-editor-run-button.running {
    opacity: 1;
 }

-@keyframes spinner {
-    to {
-        transform: rotate(360deg);
-    }
-}
-.py-editor-run-button:disabled > *,
-.mpy-editor-run-button:disabled > * {
-    display: none; /* hide all the child elements of the run button when it is disabled */
-}
-.py-editor-run-button:disabled,
-.mpy-editor-run-button:disabled {
-    border-width: 0;
-}
-.py-editor-run-button:disabled::before,
-.mpy-editor-run-button:disabled::before {
-    content: "";
-    box-sizing: border-box;
-    position: absolute;
-    top: 100%;
-    left: 100%;
-    width: 20px;
-    height: 20px;
-    margin-top: -23px; /* hardcoded value to center the spinner on the run button */
-    margin-left: -26px; /* hardcoded value to center the spinner on the run button */
-    border-radius: 50%;
-    border: 2px solid #aaa;
-    border-top-color: #000;
-    background-color: #fff;
-    animation: spinner 0.6s linear infinite;
-}
-
 py-terminal span,
 mpy-terminal span {
    letter-spacing: 0 !important;
 }
+
+dialog.pyscript-fs {
+    border-radius: 8px;
+    border-width: 1px;
+}
+
+dialog.pyscript-fs > div {
+    display: flex;
+    justify-content: space-between;
+}
--- a/core/src/core.js
+++ b/core/src/core.js
@@ -1,7 +1,8 @@
 /*! (c) PyScript Development Team */

+import "./zero-redirect.js";
 import stickyModule from "sticky-module";
-import "@ungap/with-resolvers";
+import withResolvers from "@webreflection/utils/with-resolvers";

 import {
    INVALID_CONTENT,
@@ -33,6 +34,7 @@ import {
    createFunction,
    inputFailure,
 } from "./hooks.js";
+import * as fs from "./fs.js";

 import codemirror from "./plugins/codemirror.js";
 export { codemirror };
@@ -167,6 +169,8 @@ for (const [TYPE, interpreter] of TYPES) {
        // enrich the Python env with some JS utility for main
        interpreter.registerJsModule("_pyscript", {
            PyWorker,
+            fs,
+            interpreter,
            js_import: (...urls) => Promise.all(urls.map((url) => import(url))),
            get target() {
                return isScript(currentElement)
@@ -324,7 +328,7 @@ for (const [TYPE, interpreter] of TYPES) {
                class extends HTMLElement {
                    constructor() {
                        assign(super(), {
-                            _wrap: Promise.withResolvers(),
+                            _wrap: withResolvers(),
                            srcCode: "",
                            executed: false,
                        });
--- a/core/src/fs.js
+++ b/core/src/fs.js
@@ -0,0 +1,82 @@
+import IDBMap from "@webreflection/idb-map";
+import withResolvers from "@webreflection/utils/with-resolvers";
+import { assign } from "polyscript/exports";
+import { $$ } from "basic-devtools";
+
+const stop = (event) => {
+    event.preventDefault();
+    event.stopImmediatePropagation();
+};
+
+// ⚠️ these two constants MUST be passed as `fs`
+//     within the worker onBeforeRunAsync hook!
+export const NAMESPACE = "@pyscript.fs";
+export const ERROR = "storage permissions not granted";
+
+export const idb = new IDBMap(NAMESPACE);
+
+/**
+ * Ask a user action via dialog and returns the directory handler once granted.
+ * @param {{id?:string, mode?:"read"|"readwrite", hint?:"desktop"|"documents"|"downloads"|"music"|"pictures"|"videos"}} options
+ * @returns {Promise<FileSystemDirectoryHandle>}
+ */
+export const getFileSystemDirectoryHandle = async (options) => {
+    if (!("showDirectoryPicker" in globalThis)) {
+        return Promise.reject(
+            new Error("showDirectoryPicker is not supported"),
+        );
+    }
+
+    const { promise, resolve, reject } = withResolvers();
+
+    const how = { id: "pyscript", mode: "readwrite", ...options };
+    if (options.hint) how.startIn = options.hint;
+
+    const transient = async () => {
+        try {
+            /* eslint-disable */
+            const handler = await showDirectoryPicker(how);
+            /* eslint-enable */
+            if ((await handler.requestPermission(how)) === "granted") {
+                resolve(handler);
+                return true;
+            }
+        } catch ({ message }) {
+            console.warn(message);
+        }
+        return false;
+    };
+
+    // in case the user decided to attach the event itself
+    // as opposite of relying our dialog walkthrough
+    if (navigator.userActivation?.isActive) {
+        if (!(await transient())) reject(new Error(ERROR));
+    } else {
+        const dialog = assign(document.createElement("dialog"), {
+            className: "pyscript-fs",
+            innerHTML: [
+                "<strong>ℹ️ Persistent FileSystem</strong><hr>",
+                "<p><small>PyScript would like to access a local folder.</small></p>",
+                "<div><button title='ok'>✅ Authorize</button>",
+                "<button title='cancel'>❌</button></div>",
+            ].join(""),
+        });
+
+        const [ok, cancel] = $$("button", dialog);
+
+        ok.addEventListener("click", async (event) => {
+            stop(event);
+            if (await transient()) dialog.close();
+        });
+
+        cancel.addEventListener("click", async (event) => {
+            stop(event);
+            reject(new Error(ERROR));
+            dialog.close();
+        });
+
+        document.body.appendChild(dialog).showModal();
+    }
+
+    return promise;
+};
--- a/core/src/hooks.js
+++ b/core/src/hooks.js
@@ -88,7 +88,19 @@ export const hooks = {
        /** @type {Set<function>} */
        onBeforeRun: new SetFunction(),
        /** @type {Set<function>} */
-        onBeforeRunAsync: new SetFunction(),
+        onBeforeRunAsync: new SetFunction([
+            ({ interpreter }) => {
+                interpreter.registerJsModule("_pyscript", {
+                    // cannot be imported from fs.js
+                    // because this code is stringified
+                    fs: {
+                        ERROR: "storage permissions not granted",
+                        NAMESPACE: "@pyscript.fs",
+                    },
+                    interpreter,
+                });
+            },
+        ]),
        /** @type {Set<function>} */
        onAfterRun: new SetFunction(),
        /** @type {Set<function>} */
--- a/core/src/plugins/py-editor.js
+++ b/core/src/plugins/py-editor.js
@@ -1,16 +1,19 @@
 // PyScript py-editor plugin
+import withResolvers from "@webreflection/utils/with-resolvers";
 import { Hook, XWorker, dedent, defineProperties } from "polyscript/exports";
 import { TYPES, offline_interpreter, relative_url, stdlib } from "../core.js";
 import { notify } from "./error.js";
 import codemirror from "./codemirror.js";

-const RUN_BUTTON = `<svg style="height:20px;width:20px;vertical-align:-.125em;transform-origin:center;overflow:visible;color:green" viewBox="0 0 384 512" aria-hidden="true" role="img" xmlns="http://www.w3.org/2000/svg"><g transform="translate(192 256)" transform-origin="96 0"><g transform="translate(0,0) scale(1,1)"><path d="M361 215C375.3 223.8 384 239.3 384 256C384 272.7 375.3 288.2 361 296.1L73.03 472.1C58.21 482 39.66 482.4 24.52 473.9C9.377 465.4 0 449.4 0 432V80C0 62.64 9.377 46.63 24.52 38.13C39.66 29.64 58.21 29.99 73.03 39.04L361 215z" fill="currentColor" transform="translate(-192 -256)"></path></g></g></svg>`;
+const RUN_BUTTON = `<svg style="height:24px;width:24px" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19,12a1,1,0,0,1-.55.89l-10,5A1,1,0,0,1,8,18a1,1,0,0,1-.53-.15A1,1,0,0,1,7,17V7a1,1,0,0,1,1.45-.89l10,5A1,1,0,0,1,19,12Z" fill="#464646"/></svg>`;
+const STOP_BUTTON = `<svg style="height:24px;width:24px" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M7 7h10v10H7z" style="fill:#464646;stroke:#464646;stroke-width:1;stroke-linecap:butt;stroke-linejoin:round;stroke-dasharray:none;paint-order:normal"/></svg>`;

 let id = 0;
 const getID = (type) => `${type}-editor-${id++}`;

 const envs = new Map();
 const configs = new Map();
+const editors = new WeakMap();

 const hooks = {
    worker: {
@@ -30,12 +33,18 @@ const validate = (config, result) => {
    return result;
 };

-async function execute({ currentTarget }) {
+const getRelatedScript = (target, type) => {
+    const editor = target.closest(`.${type}-editor-box`);
+    return editor?.parentNode?.previousElementSibling;
+};
+
+async function execute({ currentTarget, script }) {
    const { env, pySrc, outDiv } = this;
    const hasRunButton = !!currentTarget;

    if (hasRunButton) {
-        currentTarget.disabled = true;
+        currentTarget.classList.add("running");
+        currentTarget.innerHTML = STOP_BUTTON;
        outDiv.innerHTML = "";
    }

@@ -82,17 +91,15 @@ async function execute({ currentTarget }) {
        // creation and destruction of editors on the fly
        if (hasRunButton) {
            for (const type of TYPES.keys()) {
-                const editor = currentTarget.closest(`.${type}-editor-box`);
-                const script = editor?.parentNode?.previousElementSibling;
-                if (script) {
-                    defineProperties(script, { xworker: { value: xworker } });
-                    break;
-                }
+                script = getRelatedScript(currentTarget, type);
+                if (script) break;
            }
        }

+        defineProperties(script, { xworker: { value: xworker } });
+
        const { sync } = xworker;
-        const { promise, resolve } = Promise.withResolvers();
+        const { promise, resolve } = withResolvers();
        envs.set(env, promise);
        sync.revoke = () => {
            URL.revokeObjectURL(srcLink);
@@ -116,7 +123,18 @@ async function execute({ currentTarget }) {
        };

        const enable = () => {
-            if (hasRunButton) currentTarget.disabled = false;
+            if (hasRunButton) {
+                currentTarget.classList.remove("running");
+                currentTarget.innerHTML = RUN_BUTTON;
+                const { previousElementSibling } =
+                    currentTarget.closest("[data-env]").parentElement;
+                previousElementSibling?.dispatchEvent(
+                    new Event("py-editor:done", {
+                        bubbles: true,
+                        cancelable: true,
+                    }),
+                );
+            }
        };
        const { sync } = xworker;
        sync.write = (str) => {
@@ -138,12 +156,54 @@ async function execute({ currentTarget }) {
    });
 }

+const replaceScript = (script, type) => {
+    script.xworker?.terminate();
+    const clone = script.cloneNode(true);
+    clone.type = `${type}-editor`;
+    const editor = editors.get(script);
+    if (editor) {
+        const content = editor.state.doc.toString();
+        clone.textContent = content;
+        editors.delete(script);
+        script.nextElementSibling.remove();
+    }
+    script.replaceWith(clone);
+};
+
 const makeRunButton = (handler, type) => {
    const runButton = document.createElement("button");
    runButton.className = `absolute ${type}-editor-run-button`;
    runButton.innerHTML = RUN_BUTTON;
    runButton.setAttribute("aria-label", "Python Script Run Button");
    runButton.addEventListener("click", async (event) => {
+        if (
+            runButton.classList.contains("running") &&
+            confirm("Stop evaluating this code?")
+        ) {
+            const script = getRelatedScript(runButton, type);
+            if (script) {
+                const env = script.getAttribute("env");
+                // remove the bootstrapped env which could be one or shared
+                if (env) {
+                    for (const [key, value] of TYPES) {
+                        if (key === type) {
+                            configs.delete(`${value}-${env}`);
+                            envs.delete(`${value}-${env}`);
+                            break;
+                        }
+                    }
+                }
+                // lonley script without setup node should be replaced
+                if (script.xworker) replaceScript(script, type);
+                // all scripts sharing the same env should be replaced
+                else {
+                    const sel = `script[type^="${type}-editor"][env="${env}"]`;
+                    for (const script of document.querySelectorAll(sel))
+                        replaceScript(script, type);
+                }
+            }
+            return;
+        }
        runButton.blur();
        await handler.handleEvent(event);
    });
@@ -328,7 +388,7 @@ const init = async (script, type, interpreter) => {
    };

    if (isSetup) {
-        await context.handleEvent({ currentTarget: null });
+        await context.handleEvent({ currentTarget: null, script });
        notifyEditor();
        return;
    }
@@ -387,6 +447,7 @@ const init = async (script, type, interpreter) => {
        doc,
    });

+    editors.set(script, editor);
    editor.focus();
    notifyEditor();
 };
--- a/core/src/plugins/py-game.js
+++ b/core/src/plugins/py-game.js
@@ -1,9 +1,27 @@
-import { dedent, define } from "polyscript/exports";
+import {
+    dedent,
+    define,
+    createProgress,
+    loadProgress,
+} from "polyscript/exports";

 import { stdlib } from "../core.js";
 import { configDetails } from "../config.js";
 import { getText } from "../fetch.js";

+const progress = createProgress("py-game");
+
+const inputPatch = `
+import builtins
+def input(prompt=""):
+    import js
+    return js.prompt(prompt)
+
+builtins.input = input
+del builtins
+del input
+`;
+
 let toBeWarned = true;

 const hooks = {
@@ -13,10 +31,11 @@ const hooks = {
                toBeWarned = false;
                console.warn("⚠️ EXPERIMENTAL `py-game` FEATURE");
            }
+
+            let config = {};
            if (script.hasAttribute("config")) {
                const value = script.getAttribute("config");
-                const { json, toml, text } = configDetails(value);
-                let config = {};
+                const { json, toml, text, url } = await configDetails(value);
                if (json) config = JSON.parse(text);
                else if (toml) {
                    const { parse } = await import(
@@ -25,12 +44,20 @@ const hooks = {
                    config = parse(text);
                }
                if (config.packages) {
+                    await wrap.interpreter.loadPackage("micropip");
                    const micropip = wrap.interpreter.pyimport("micropip");
                    await micropip.install(config.packages, {
                        keep_going: true,
                    });
                    micropip.destroy();
                }
+                await loadProgress(
+                    "py-game",
+                    progress,
+                    wrap.interpreter,
+                    config,
+                    url ? new URL(url, location.href).href : location.href,
+                );
            }

            wrap.interpreter.registerJsModule("_pyscript", {
@@ -47,6 +74,7 @@ const hooks = {
            });

            await wrap.interpreter.runPythonAsync(stdlib);
+            wrap.interpreter.runPython(inputPatch);

            let code = dedent(script.textContent);
            if (script.src) code = await fetch(script.src).then(getText);
@@ -54,6 +82,22 @@ const hooks = {
            const target = script.getAttribute("target") || "canvas";
            const canvas = document.getElementById(target);
            wrap.interpreter.canvas.setCanvas2D(canvas);
+
+            // allow 3rd party to hook themselves right before
+            // the code gets executed
+            const event = new CustomEvent("py-game", {
+                bubbles: true,
+                cancelable: true,
+                detail: {
+                    canvas,
+                    code,
+                    config,
+                    wrap,
+                },
+            });
+            script.dispatchEvent(event);
+            // run only if the default was not prevented
+            if (!event.defaultPrevented)
                await wrap.interpreter.runPythonAsync(code);
        },
    },
--- a/core/src/plugins/py-terminal/mpy.js
+++ b/core/src/plugins/py-terminal/mpy.js
@@ -1,4 +1,5 @@
 // PyScript pyodide terminal plugin
+import withResolvers from "@webreflection/utils/with-resolvers";
 import { defineProperties } from "polyscript/exports";
 import { hooks, inputFailure } from "../../core.js";

@@ -146,7 +147,7 @@ export default async (element) => {
            // frees the worker on \r
            sync.pyterminal_read = (buffer) => {
                terminal.write(buffer);
-                promisedChunks = Promise.withResolvers();
+                promisedChunks = withResolvers();
                return promisedChunks.promise;
            };

--- a/core/src/service-worker.js
+++ b/core/src/service-worker.js
@@ -0,0 +1 @@
+import "polyscript/service-worker";
--- a/core/src/stdlib/pyscript.js
+++ b/core/src/stdlib/pyscript.js
--- a/core/src/stdlib/pyscript/display.py
+++ b/core/src/stdlib/pyscript/display.py
@@ -73,14 +73,14 @@ def _eval_formatter(obj, print_method):
    """
    if print_method == "__repr__":
        return repr(obj)
-    elif hasattr(obj, print_method):
+    if hasattr(obj, print_method):
        if print_method == "savefig":
            buf = io.BytesIO()
            obj.savefig(buf, format="png")
            buf.seek(0)
            return base64.b64encode(buf.read()).decode("utf-8")
        return getattr(obj, print_method)()
-    elif print_method == "_repr_mimebundle_":
+    if print_method == "_repr_mimebundle_":
        return {}, {}
    return None

@@ -107,7 +107,7 @@ def _format_mime(obj):

        if output is None:
            continue
-        elif mime_type not in _MIME_RENDERERS:
+        if mime_type not in _MIME_RENDERERS:
            not_available.append(mime_type)
            continue
        break
@@ -149,9 +149,11 @@ def display(*values, target=None, append=True):
    if target is None:
        target = current_target()
    elif not isinstance(target, str):
-        raise TypeError(f"target must be str or None, not {target.__class__.__name__}")
+        msg = f"target must be str or None, not {target.__class__.__name__}"
+        raise TypeError(msg)
    elif target == "":
-        raise ValueError("Cannot have an empty target")
+        msg = "Cannot have an empty target"
+        raise ValueError(msg)
    elif target.startswith("#"):
        # note: here target is str and not None!
        # align with @when behavior
@@ -161,9 +163,8 @@ def display(*values, target=None, append=True):

    # If target cannot be found on the page, a ValueError is raised
    if element is None:
-        raise ValueError(
-            f"Invalid selector with id={target}. Cannot be found in the page."
-        )
+        msg = f"Invalid selector with id={target}. Cannot be found in the page."
+        raise ValueError(msg)

    # if element is a <script type="py">, it has a 'target' attribute which
    # points to the visual element holding the displayed values. In that case,
--- a/core/src/stdlib/pyscript/events.py
+++ b/core/src/stdlib/pyscript/events.py
@@ -36,7 +36,8 @@ class Event:
            if listener not in self._listeners:
                self._listeners.append(listener)
        else:
-            raise ValueError("Listener must be callable or awaitable.")
+            msg = "Listener must be callable or awaitable."
+            raise ValueError(msg)

    def remove_listener(self, *args):
        """
@@ -76,7 +77,8 @@ def when(target, *args, **kwargs):
        # Extract the selector from the arguments or keyword arguments.
        selector = args[0] if args else kwargs.pop("selector")
        if not selector:
-            raise ValueError("No selector provided.")
+            msg = "No selector provided."
+            raise ValueError(msg)
        # Grab the DOM elements to which the target event will be attached.
        from pyscript.web import Element, ElementCollection

--- a/core/src/stdlib/pyscript/ffi.py
+++ b/core/src/stdlib/pyscript/ffi.py
@@ -16,3 +16,27 @@ except:

 create_proxy = _cp
 to_js = _tjs
+
+try:
+    from polyscript import ffi as _ffi
+
+    direct = _ffi.direct
+    gather = _ffi.gather
+    query = _ffi.query
+
+    def assign(source, *args):
+        for arg in args:
+            _ffi.assign(source, to_js(arg))
+        return source
+
+except:
+    import js
+
+    _assign = js.Object.assign
+
+    direct = lambda source: source
+
+    def assign(source, *args):
+        for arg in args:
+            _assign(source, to_js(arg))
+        return source
--- a/core/src/stdlib/pyscript/flatted.py
+++ b/core/src/stdlib/pyscript/flatted.py
@@ -31,7 +31,7 @@ def _object_keys(value):


 def _is_array(value):
-    return isinstance(value, list) or isinstance(value, tuple)
+    return isinstance(value, (list, tuple))


 def _is_object(value):
@@ -60,10 +60,10 @@ def _loop(keys, input, known, output):


 def _ref(key, value, input, known, output):
-    if _is_array(value) and not value in known:
+    if _is_array(value) and value not in known:
        known.append(value)
        value = _loop(_array_keys(value), input, known, value)
-    elif _is_object(value) and not value in known:
+    elif _is_object(value) and value not in known:
        known.append(value)
        value = _loop(_object_keys(value), input, known, value)

--- a/core/src/stdlib/pyscript/fs.py
+++ b/core/src/stdlib/pyscript/fs.py
@@ -0,0 +1,60 @@
+mounted = {}
+
+
+async def mount(path, mode="readwrite", root="", id="pyscript"):
+    import js
+    from _pyscript import fs, interpreter
+    from pyscript.ffi import to_js
+    from pyscript.magic_js import (
+        RUNNING_IN_WORKER,
+        sync,
+    )
+
+    js.console.warn("experimental pyscript.fs ⚠️")
+
+    handler = None
+
+    uid = f"{path}@{id}"
+
+    options = {"id": id, "mode": mode}
+    if root != "":
+        options["startIn"] = root
+
+    if RUNNING_IN_WORKER:
+        fsh = sync.storeFSHandler(uid, to_js(options))
+
+        # allow both async and/or SharedArrayBuffer use case
+        if isinstance(fsh, bool):
+            success = fsh
+        else:
+            success = await fsh
+
+        if success:
+            from polyscript import IDBMap
+
+            idb = IDBMap.new(fs.NAMESPACE)
+            handler = await idb.get(uid)
+        else:
+            raise RuntimeError(fs.ERROR)
+
+    else:
+        success = await fs.idb.has(uid)
+
+        if success:
+            handler = await fs.idb.get(uid)
+        else:
+            handler = await fs.getFileSystemDirectoryHandle(to_js(options))
+            await fs.idb.set(uid, handler)
+
+    mounted[path] = await interpreter.mountNativeFS(path, handler)
+
+
+async def sync(path):
+    await mounted[path].syncfs()
+
+
+async def unmount(path):
+    from _pyscript import interpreter
+
+    await sync(path)
+    interpreter._module.FS.unmount(path)
--- a/core/src/stdlib/pyscript/magic_js.py
+++ b/core/src/stdlib/pyscript/magic_js.py
@@ -25,6 +25,7 @@ class JSModule:
        # avoid pyodide looking for non existent fields
        if not field.startswith("_"):
            return getattr(getattr(js_modules, self.name), field)
+        return None


 # generate N modules in the system that will proxy the real value
--- a/core/src/stdlib/pyscript/media.py
+++ b/core/src/stdlib/pyscript/media.py
@@ -31,26 +31,22 @@ class Device:

    @classmethod
    async def load(cls, audio=False, video=True):
-        """Load the device stream."""
-        options = window.Object.new()
-        options.audio = audio
+        """
+        Load the device stream.
+        """
+        options = {}
+        options["audio"] = audio
        if isinstance(video, bool):
-            options.video = video
+            options["video"] = video
        else:
-            # TODO: Think this can be simplified but need to check it on the pyodide side
-
-            # TODO: this is pyodide specific. shouldn't be!
-            options.video = window.Object.new()
+            options["video"] = {}
            for k in video:
-                setattr(options.video, k, to_js(video[k]))
-
-        stream = await window.navigator.mediaDevices.getUserMedia(options)
-        return stream
+                options["video"][k] = video[k]
+        return await window.navigator.mediaDevices.getUserMedia(to_js(options))

    async def get_stream(self):
        key = self.kind.replace("input", "").replace("output", "")
        options = {key: {"deviceId": {"exact": self.id}}}
-
        return await self.load(**options)


--- a/core/src/stdlib/pyscript/storage.py
+++ b/core/src/stdlib/pyscript/storage.py
@@ -10,10 +10,11 @@ def _to_idb(value):
    if isinstance(value, (bool, float, int, str, list, dict, tuple)):
        return _stringify(["generic", value])
    if isinstance(value, bytearray):
-        return _stringify(["bytearray", [v for v in value]])
+        return _stringify(["bytearray", list(value)])
    if isinstance(value, memoryview):
-        return _stringify(["memoryview", [v for v in value]])
-    raise TypeError(f"Unexpected value: {value}")
+        return _stringify(["memoryview", list(value)])
+    msg = f"Unexpected value: {value}"
+    raise TypeError(msg)


 # convert an IndexedDB compatible entry into a Python value
@@ -56,5 +57,6 @@ class Storage(dict):

 async def storage(name="", storage_class=Storage):
    if not name:
-        raise ValueError("The storage name must be defined")
+        msg = "The storage name must be defined"
+        raise ValueError(msg)
    return storage_class(await _storage(f"@pyscript/{name}"))
--- a/core/src/stdlib/pyscript/util.py
+++ b/core/src/stdlib/pyscript/util.py
@@ -11,7 +11,7 @@ def as_bytearray(buffer):
    ui8a = js.Uint8Array.new(buffer)
    size = ui8a.length
    ba = bytearray(size)
-    for i in range(0, size):
+    for i in range(size):
        ba[i] = ui8a[i]
    return ba

--- a/core/src/stdlib/pyscript/web.py
+++ b/core/src/stdlib/pyscript/web.py
@@ -2,7 +2,10 @@

 # `when` is not used in this module. It is imported here save the user an additional
 # import (i.e. they can get what they need from `pyscript.web`).
-from pyscript import document, when, Event  # NOQA
+
+# from __future__ import annotations  # CAUTION: This is not supported in MicroPython.
+
+from pyscript import document, when, Event  # noqa: F401
 from pyscript.ffi import create_proxy


@@ -100,7 +103,7 @@ class Element:
        If `key` is an integer or a slice we use it to index/slice the element's
        children. Otherwise, we use `key` as a query selector.
        """
-        if isinstance(key, int) or isinstance(key, slice):
+        if isinstance(key, (int, slice)):
            return self.children[key]

        return self.find(key)
@@ -120,7 +123,12 @@ class Element:
        # attribute `for` which is a Python keyword, so you can access it on the
        # Element instance via `for_`).
        if name.endswith("_"):
-            name = name[:-1]
+            name = name[:-1]  # noqa: FURB188 No str.removesuffix() in MicroPython.
+        if name == "for":
+            # The `for` attribute is a special case as it is a keyword in both
+            # Python and JavaScript.
+            # We need to get it from the underlying DOM element as `htmlFor`.
+            name = "htmlFor"
        return getattr(self._dom_element, name)

    def __setattr__(self, name, value):
@@ -138,7 +146,12 @@ class Element:
            # attribute `for` which is a Python keyword, so you can access it on the
            # Element instance via `for_`).
            if name.endswith("_"):
-                name = name[:-1]
+                name = name[:-1]  # noqa: FURB188 No str.removesuffix() in MicroPython.
+            if name == "for":
+                # The `for` attribute is a special case as it is a keyword in both
+                # Python and JavaScript.
+                # We need to set it on the underlying DOM element as `htmlFor`.
+                name = "htmlFor"

            if name.startswith("on_"):
                # Ensure on-events are cached in the _on_events dict if the
@@ -152,10 +165,12 @@ class Element:
        Get an `Event` instance for the specified event name.
        """
        if not name.startswith("on_"):
-            raise ValueError("Event names must start with 'on_'.")
+            msg = "Event names must start with 'on_'."
+            raise ValueError(msg)
        event_name = name[3:]  # Remove the "on_" prefix.
        if not hasattr(self._dom_element, event_name):
-            raise ValueError(f"Element has no '{event_name}' event.")
+            msg = f"Element has no '{event_name}' event."
+            raise ValueError(msg)
        if name in self._on_events:
            return self._on_events[name]
        # Such an on-event exists in the DOM element, but we haven't yet
@@ -203,7 +218,7 @@ class Element:
            # We check for list/tuple here and NOT for any iterable as it will match
            # a JS Nodelist which is handled explicitly below.
            # NodeList.
-            elif isinstance(item, list) or isinstance(item, tuple):
+            elif isinstance(item, (list, tuple)):
                for child in item:
                    self.append(child)

@@ -227,10 +242,11 @@ class Element:

                    except AttributeError:
                        # Nope! This is not an element or a NodeList.
-                        raise TypeError(
+                        msg = (
                            f'Element "{item}" is a proxy object, "'
                            f"but not a valid element or a NodeList."
                        )
+                        raise TypeError(msg)

    def clone(self, clone_id=None):
        """Make a clone of the element (clones the underlying DOM object too)."""
@@ -401,8 +417,7 @@ class Options:

        new_option = option(**kwargs)

-        if before:
-            if isinstance(before, Element):
+        if before and isinstance(before, Element):
            before = before._dom_element

        self._element._dom_element.add(new_option._dom_element, before)
@@ -463,7 +478,7 @@ class ContainerElement(Element):
        )

        for child in list(args) + (children or []):
-            if isinstance(child, Element) or isinstance(child, ElementCollection):
+            if isinstance(child, (Element, ElementCollection)):
                self.append(child)

            else:
@@ -493,14 +508,13 @@ class ClassesCollection:
        )

    def __iter__(self):
-        for class_name in self._all_class_names():
-            yield class_name
+        yield from self._all_class_names()

    def __len__(self):
        return len(self._all_class_names())

    def __repr__(self):
-        return f"ClassesCollection({repr(self._collection)})"
+        return f"ClassesCollection({self._collection!r})"

    def __str__(self):
        return " ".join(self._all_class_names())
@@ -553,7 +567,7 @@ class StyleCollection:
            element.style[key] = value

    def __repr__(self):
-        return f"StyleCollection({repr(self._collection)})"
+        return f"StyleCollection({self._collection!r})"

    def remove(self, key):
        """Remove a CSS property from the elements in the collection."""
@@ -588,7 +602,7 @@ class ElementCollection:
        if isinstance(key, int):
            return self._elements[key]

-        elif isinstance(key, slice):
+        if isinstance(key, slice):
            return ElementCollection(self._elements[key])

        return self.find(key)
@@ -1125,7 +1139,8 @@ class video(ContainerElement):

        elif isinstance(to, Element):
            if to.tag != "canvas":
-                raise TypeError("Element to snap to must be a canvas.")
+                msg = "Element to snap to must be a canvas."
+                raise TypeError(msg)

        elif getattr(to, "tagName", "") == "CANVAS":
            to = canvas(dom_element=to)
@@ -1134,10 +1149,12 @@ class video(ContainerElement):
        elif isinstance(to, str):
            nodelist = document.querySelectorAll(to)  # NOQA
            if nodelist.length == 0:
-                raise TypeError("No element with selector {to} to snap to.")
+                msg = "No element with selector {to} to snap to."
+                raise TypeError(msg)

            if nodelist[0].tagName != "CANVAS":
-                raise TypeError("Element to snap to must be a canvas.")
+                msg = "Element to snap to must be a canvas."
+                raise TypeError(msg)

            to = canvas(dom_element=nodelist[0])

--- a/core/src/stdlib/pyscript/websocket.py
+++ b/core/src/stdlib/pyscript/websocket.py
@@ -24,7 +24,7 @@ class EventMessage:
        return value


-class WebSocket(object):
+class WebSocket:
    CONNECTING = 0
    OPEN = 1
    CLOSING = 2
--- a/core/src/stdlib/pyscript/workers.py
+++ b/core/src/stdlib/pyscript/workers.py
@@ -25,10 +25,12 @@ async def create_named_worker(src="", name="", config=None, type="py"):
    from json import dumps

    if not src:
-        raise ValueError("Named workers require src")
+        msg = "Named workers require src"
+        raise ValueError(msg)

    if not name:
-        raise ValueError("Named workers require a name")
+        msg = "Named workers require a name"
+        raise ValueError(msg)

    s = _js.document.createElement("script")
    s.type = type
@@ -37,7 +39,7 @@ async def create_named_worker(src="", name="", config=None, type="py"):
    _set(s, "name", name)

    if config:
-        _set(s, "config", isinstance(config, str) and config or dumps(config))
+        _set(s, "config", (isinstance(config, str) and config) or dumps(config))

    _js.document.body.append(s)
    return await workers[name]
--- a/core/src/storage.js
+++ b/core/src/storage.js
@@ -1,14 +1,14 @@
-import { ArrayBuffer, TypedArray } from "sabayon/shared";
 import IDBMapSync from "@webreflection/idb-map/sync";
 import { parse, stringify } from "flatted";

+const { isView } = ArrayBuffer;
+
 const to_idb = (value) => {
    if (value == null) return stringify(["null", 0]);
    /* eslint-disable no-fallthrough */
    switch (typeof value) {
        case "object": {
-            if (value instanceof TypedArray)
-                return stringify(["memoryview", [...value]]);
+            if (isView(value)) return stringify(["memoryview", [...value]]);
            if (value instanceof ArrayBuffer)
                return stringify(["bytearray", [...new Uint8Array(value)]]);
        }
--- a/core/src/sync.js
+++ b/core/src/sync.js
@@ -1,3 +1,5 @@
+import { idb, getFileSystemDirectoryHandle } from "./fs.js";
+
 export default {
    // allow pyterminal checks to bootstrap
    is_pyterminal: () => false,
@@ -9,4 +11,21 @@ export default {
    sleep(seconds) {
        return new Promise(($) => setTimeout($, seconds * 1000));
    },
+
+    /**
+     * Ask a user action via dialog and returns the directory handler once granted.
+     * @param {string} uid
+     * @param {{id?:string, mode?:"read"|"readwrite", hint?:"desktop"|"documents"|"downloads"|"music"|"pictures"|"videos"}} options
+     * @returns {boolean}
+     */
+    async storeFSHandler(uid, options = {}) {
+        if (await idb.has(uid)) return true;
+        return getFileSystemDirectoryHandle(options).then(
+            async (handler) => {
+                await idb.set(uid, handler);
+                return true;
+            },
+            () => false,
+        );
+    },
 };
--- a/core/src/zero-redirect.js
+++ b/core/src/zero-redirect.js
@@ -0,0 +1,7 @@
+/* eslint no-unused-vars: 0 */
+try {
+    crypto.randomUUID();
+} catch (_) {
+    if (location.href.startsWith("http://0.0.0.0"))
+        location.href = location.href.replace("0.0.0.0", "localhost");
+}
--- a/core/tests/index.html
+++ b/core/tests/index.html
--- a/core/tests/javascript/media.html
+++ b/core/tests/javascript/media.html
@@ -0,0 +1,39 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Pyodide Media Module Test</title>
+  <link rel="stylesheet" href="../../dist/core.css">
+  <script type="module" src="../../dist/core.js"></script>
+</head>
+<body>
+<h1>Pyodide Media Module Test</h1>
+<div id="test-results">Running tests...</div>
+
+<script type="py" terminal>
+  from pyscript import window, document
+  from pyscript import media
+
+  async def run_tests():
+      # Test basic module structure
+      assert hasattr(media, "Device"), "media module should have Device class"
+      assert hasattr(media, "list_devices"), "media module should have list_devices function"
+
+      # Test device enumeration
+      devices = await media.list_devices()
+      assert isinstance(devices, list), "list_devices should return a list"
+
+      # If we have devices, test properties of one
+      if devices:
+          device = devices[0]
+          assert hasattr(device, "id"), "Device should have id property"
+          assert hasattr(device, "group"), "Device should have group property"
+          assert hasattr(device, "kind"), "Device should have kind property"
+          assert hasattr(device, "label"), "Device should have label property"
+
+      document.getElementById('test-results').innerText = "Success!"
+      document.documentElement.classList.add('media-ok')
+
+  await run_tests()
+</script>
+</body>
+</html>
--- a/core/tests/javascript/pyodide-cache/index.py
+++ b/core/tests/javascript/pyodide-cache/index.py
@@ -1,6 +1,6 @@
-import numpy
-import matplotlib
+import numpy as np
+import matplotlib as mpl

 # just do something with the packages
-print(len(dir(numpy)))
-print(len(dir(matplotlib)))
+print(len(dir(np)))
+print(len(dir(mpl)))
--- a/core/tests/javascript/worker-symbols.html
+++ b/core/tests/javascript/worker-symbols.html
@@ -0,0 +1,36 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>PyScript VS Symbols</title>
+  <script>
+    globalThis.hasSymbol = (symbol, ref) => symbol in ref;
+    globalThis.getSymbol = (symbol, ref) => ref[symbol];
+
+    // some 3rd party JS library might use symbols to brand-check
+    // so it's not about symbols traveling from MicroPython
+    // it's about MicroPython proxies traps not understanding symbols
+    globalThis.hasIterator = ref => Symbol.iterator in ref;
+  </script>
+  <link rel="stylesheet" href="../../dist/core.css">
+  <script type="module" src="../../dist/core.js"></script>
+  <script type="mpy">
+    import js
+
+    symbol = js.Symbol.iterator
+
+    if js.getSymbol(symbol, []) and js.hasSymbol(symbol, []) and js.hasIterator([]):
+      js.document.documentElement.classList.add("main")
+  </script>
+  <script type="mpy" worker>
+    from pyscript import window
+    import js
+
+    symbol = js.Symbol.iterator
+
+    if window.getSymbol(symbol, []) and window.hasSymbol(symbol, []) and window.hasIterator([]):
+      window.document.documentElement.classList.add("worker")
+  </script>
+</head>
+</html>
--- a/core/tests/javascript/workers/worker.py
+++ b/core/tests/javascript/workers/worker.py
@@ -4,4 +4,4 @@ def runtime_version():
    return sys.version


-__export__ = ['runtime_version']
+__export__ = ["runtime_version"]
--- a/core/tests/js_tests.spec.js
+++ b/core/tests/js_tests.spec.js
@@ -59,6 +59,11 @@ test('MicroPython + configURL', async ({ page }) => {
  await page.waitForSelector('html.main.worker');
 });

+test('MicroPython + Symbols', async ({ page }) => {
+  await page.goto('http://localhost:8080/tests/javascript/worker-symbols.html');
+  await page.waitForSelector('html.main.worker');
+});
+
 test('Pyodide + terminal on Main', async ({ page }) => {
  await page.goto('http://localhost:8080/tests/javascript/py-terminal-main.html');
  await page.waitForSelector('html.ok');
@@ -171,3 +176,24 @@ test('MicroPython buffered NO error', async ({ page }) => {
  const body = await page.evaluate(() => document.body.textContent.trim());
  await expect(body).toBe('');
 });
+
+test('Pyodide media module', async ({ page }) => {
+  await page.context().grantPermissions(['camera', 'microphone']);
+  await page.context().addInitScript(() => {
+    const originalEnumerateDevices = navigator.mediaDevices.enumerateDevices;
+    navigator.mediaDevices.enumerateDevices = async function() {
+      const realDevices = await originalEnumerateDevices.call(this);
+      if (!realDevices || realDevices.length === 0) {
+        return [
+          { deviceId: 'camera1', groupId: 'group1', kind: 'videoinput', label: 'Simulated Camera' },
+          { deviceId: 'mic1', groupId: 'group2', kind: 'audioinput', label: 'Simulated Microphone' }
+        ];
+      }
+      return realDevices;
+    };
+  });
+  await page.goto('http://localhost:8080/tests/javascript/media.html');
+  await page.waitForSelector('html.media-ok', { timeout: 10000 });
+  const isSuccess = await page.evaluate(() => document.documentElement.classList.contains('media-ok'));
+  expect(isSuccess).toBe(true);
+});
--- a/core/tests/manual/ffi_timeout/index.html
+++ b/core/tests/manual/ffi_timeout/index.html
@@ -0,0 +1,21 @@
+<!DOCTYPE html>
+<html>
+  <head>
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+      <link rel="stylesheet" href="../../../dist/core.css">
+      <script>
+        window.Worker = class extends Worker {
+          constructor(url, ...rest) {
+            console.log(rest[0]);
+            return super(url, ...rest);
+          }
+        };
+        window.start = Date.now();
+      </script>
+      <script type="module" src="../../../dist/core.js"></script>
+  </head>
+  <body>
+    <script type="py" config="./index.toml" src="index.py" worker></script>
+  </body>
+</html>
--- a/core/tests/manual/ffi_timeout/index.py
+++ b/core/tests/manual/ffi_timeout/index.py
@@ -0,0 +1,3 @@
+from pyscript import document, window
+
+document.body.append(window.Date.now() - window.start)
--- a/core/tests/manual/ffi_timeout/index.toml
+++ b/core/tests/manual/ffi_timeout/index.toml
@@ -0,0 +1,2 @@
+experimental_ffi_timeout = 0
+package_cache = "passthrough"
--- a/core/tests/manual/fs/index.html
+++ b/core/tests/manual/fs/index.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+  <head>
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+      <link rel="stylesheet" href="../../../dist/core.css">
+      <script type="module" src="../../../dist/core.js"></script>
+  </head>
+  <body>
+    <script type="mpy" src="index.py"></script>
+  </body>
+</html>
--- a/core/tests/manual/fs/index.py
+++ b/core/tests/manual/fs/index.py
@@ -0,0 +1,46 @@
+import os
+from pyscript import RUNNING_IN_WORKER, fs
+
+
+TEST = "implicit"
+
+if TEST == "implicit":
+    await fs.mount("/persistent")
+
+    print(
+        (RUNNING_IN_WORKER and "Worker") or "Main",
+        os.listdir("/persistent"),
+    )
+
+    from random import random
+
+    with open("/persistent/random.txt", "w") as f:
+        f.write(str(random()))
+
+    await fs.sync("/persistent")
+
+elif not RUNNING_IN_WORKER:
+    from pyscript import document
+
+    button = document.createElement("button")
+    button.textContent = "mount"
+    document.body.append(button)
+
+    async def mount(event):
+        try:
+            await fs.mount("/persistent")
+            print(os.listdir("/persistent"))
+            button.textContent = "unmount"
+            button.onclick = unmount
+
+        except:
+            import js
+
+            js.alert("unable to grant access")
+
+    async def unmount(event):
+        await fs.unmount("/persistent")
+        button.textContent = "mount"
+        button.onclick = mount
+
+    button.onclick = mount
--- a/core/tests/manual/game/aliens.py
+++ b/core/tests/manual/game/aliens.py
@@ -35,7 +35,8 @@ import pygame

 # see if we can load more than standard BMP
 if not pygame.image.get_extended():
-    raise SystemExit("Sorry, extended image module required")
+    msg = "Sorry, extended image module required"
+    raise SystemExit(msg)


 # game constants
@@ -56,7 +57,8 @@ def load_image(file):
    try:
        surface = pygame.image.load(file)
    except pygame.error:
-        raise SystemExit(f'Could not load image "{file}" {pygame.get_error()}')
+        msg = f'Could not load image "{file}" {pygame.get_error()}'
+        raise SystemExit(msg)
    return surface.convert()


@@ -66,8 +68,7 @@ def load_sound(file):
        return None
    file = os.path.join(main_dir, "data", file)
    try:
-        sound = pygame.mixer.Sound(file)
-        return sound
+        return pygame.mixer.Sound(file)
    except pygame.error:
        print(f"Warning, unable to load, {file}")
    return None
@@ -227,7 +228,7 @@ class Score(pygame.sprite.Sprite):

    def update(self):
        """We only update the score in update() when it has changed."""
-        if SCORE != self.lastscore:
+        if self.lastscore != SCORE:
            self.lastscore = SCORE
            msg = "Score: %d" % SCORE
            self.image = self.font.render(msg, 0, self.color)
@@ -296,7 +297,7 @@ async def main(winstyle=0):
    # Create Some Starting Values
    global score
    alienreload = ALIEN_RELOAD
-    clock = pygame.Clock()
+    _clock = pygame.Clock()

    # initialize our starting sprites
    global SCORE
@@ -313,8 +314,7 @@ async def main(winstyle=0):
                return
            if event.type == pygame.KEYDOWN and event.key == pygame.K_ESCAPE:
                return
-            elif event.type == pygame.KEYDOWN:
-                if event.key == pygame.K_f:
+            if event.type == pygame.KEYDOWN and event.key == pygame.K_f:
                if not fullscreen:
                    print("Changing to FULLSCREEN")
                    screen_backup = screen.copy()
@@ -371,7 +371,7 @@ async def main(winstyle=0):
            player.kill()

        # See if shots hit the aliens.
-        for alien in pygame.sprite.groupcollide(aliens, shots, 1, 1).keys():
+        for alien in pygame.sprite.groupcollide(aliens, shots, 1, 1):
            if pygame.mixer:
                boom_sound.play()
            Explosion(alien)
--- a/core/tests/manual/game/config.toml
+++ b/core/tests/manual/game/config.toml
--- a/core/tests/manual/game/index.html
+++ b/core/tests/manual/game/index.html
@@ -8,7 +8,7 @@
      <script type="module" src="../../../dist/core.js"></script>
  </head>
  <body>
-      <script type="py-game" src="aliens.py"></script>
+      <script type="py-game" src="aliens.py" config="./config.toml"></script>
      <div class="demo">
          <div class="demo-header">pygame.examples.aliens</div>
          <div class="demo-content">
--- a/core/tests/manual/issue-2302/assets/genuary25-18.m4a
+++ b/core/tests/manual/issue-2302/assets/genuary25-18.m4a
--- a/core/tests/manual/issue-2302/glue/multipyjs.py
+++ b/core/tests/manual/issue-2302/glue/multipyjs.py
@@ -0,0 +1,20 @@
+from pyscript import config
+
+MICROPYTHON = config["type"] == "mpy"
+
+if MICROPYTHON:
+    def new(obj, *args, **kwargs):
+        return obj.new(*args, kwargs) if kwargs else obj.new(*args)
+    def call(obj, *args, **kwargs):
+        return obj(*args, kwargs) if kwargs else obj(*args)
+else:
+    def new(obj, *args, **kwargs):
+        return obj.new(*args, **kwargs)
+    def call(obj, *args, **kwargs):
+        return obj(*args, **kwargs)
+
+if not MICROPYTHON:
+    import pyodide_js
+    pyodide_js.setDebug(True)
+
+from pyscript.ffi import to_js, create_proxy
--- a/core/tests/manual/issue-2302/glue/perlin-0.0.0-cp312-cp312-pyodide_2024_0_wasm32.whl
+++ b/core/tests/manual/issue-2302/glue/perlin-0.0.0-cp312-cp312-pyodide_2024_0_wasm32.whl
--- a/core/tests/manual/issue-2302/index.html
+++ b/core/tests/manual/issue-2302/index.html
@@ -0,0 +1,69 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <title>Genuary</title>
+
+    <!-- Recommended meta tags -->
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0">
+
+    <!-- PyScript CSS -->
+    <link rel="stylesheet" href="../../../dist/core.css">
+
+    <style>
+        body {
+            margin: 0;
+            overflow: hidden;
+            background-color: #4a315e;
+            color: white;
+            font-family: Inconsolata, Consolas, Monaco, Courier New;
+        }
+
+        .gutter {
+            background-color: #eee;
+            background-repeat: no-repeat;
+            background-position: 50%;
+        }
+
+        .gutter.gutter-vertical {
+            background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB4AAAAFAQMAAABo7865AAAABlBMVEVHcEzMzMzyAv2sAAAAAXRSTlMAQObYZgAAABBJREFUeF5jOAMEEAIEEFwAn3kMwcB6I2AAAAAASUVORK5CYII=');
+            cursor: row-resize;
+        }
+
+        py-terminal {
+            max-height: 7em;
+            max-width: calc(100vw - 90px);
+        }
+
+        #pyterm {
+            background-color: #191a1a;
+        }
+
+        #pyterm,
+        #threejs {
+            position: relative;
+            overflow: hidden;
+        }
+    </style>
+
+    <!-- This script tag bootstraps PyScript -->
+    <script type="importmap">
+    {
+        "imports": {
+            "three": "https://cdn.jsdelivr.net/npm/three@v0.173.0/build/three.module.js"
+        }
+    }
+    </script>
+    <script type="module" src="../../../dist/core.js"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/split.js/1.6.5/split.min.js"></script>
+</head>
+<body>
+    <div id="stats"></div>
+    <div id="stats-off"></div>
+    <div class="split">
+        <div id="pyterm"></div>
+        <div id="threejs"></div>
+    </div>
+    <script type="py" src="./main.py" config="./pyscript.toml" async terminal></script>
+</body>
+</html>
--- a/core/tests/manual/issue-2302/libfft.py
+++ b/core/tests/manual/issue-2302/libfft.py
@@ -0,0 +1,83 @@
+from dataclasses import dataclass, field
+import sys
+
+@dataclass
+class BeatSync:
+    fft_res: int = field()
+
+    on_beat: bool = False
+    beat: int = -1
+    since_last_beat: float = sys.maxsize
+
+    _prev: int = 0
+    _count: int = 0
+    _bins: list[int] = field(default_factory=list)
+    _last_detection: float = -1.0
+    _threshold: int = 50
+    _diff: int = 40
+    _cooldown: float = 0.2
+
+    _highest: int = 0
+
+    def __post_init__(self):
+        self._bins = [int(13/16*self.fft_res/2)+17, int(13/16*self.fft_res/2)+18]
+
+    def reset(self):
+        self.beat = -1
+        self._prev = 0
+        self._count = 0
+        self._last_detection = -1.0
+        self.since_last_beat = sys.maxsize
+        # print('bs reset')
+
+    def update(self, data, running_time):
+        self._count += 1
+        self.since_last_beat = running_time - self._last_detection
+        d = sum(data[bin] for bin in self._bins)
+        if d < self._threshold:
+            self.on_beat = False
+        elif d - self._prev < self._diff:
+            self.on_beat = False
+        elif self.since_last_beat < self._cooldown:
+            self.on_beat = False
+        else:
+            self._last_detection = running_time
+            self.since_last_beat = 0
+            self.on_beat = True
+            self.beat += 1
+        self._prev = d
+
+@dataclass
+class FreqIntensity:
+    freq: float = field()
+    fft_res: int = field()
+
+    intensity: float = 0.0
+    intensity_slew: float = 0.0
+    scale_min: float = 0.0
+    scale_max: float = 350
+    max: float = 0.0
+    _sample_rate: int = 48000
+    _bin_indexes: list[int] = field(default_factory=list)
+    _harmonics: int = 8
+    _slew_factor: float = 0.8
+
+    def __post_init__(self):
+        self._bin_indexes = [
+            round((harmonic+1) * self.freq / self._sample_rate * self.fft_res / 2)
+            for harmonic in range(self._harmonics)
+        ]
+        print(self._bin_indexes)
+
+    def update(self, data):
+        intensity = 0.0
+        for bin in range(self._harmonics):
+            intensity += data[self._bin_indexes[bin]]/(bin+1)
+        self.intensity = intensity
+        self.intensity_slew = self._slew_factor * self.intensity_slew + (1 - self._slew_factor) * intensity
+        self.max = max(intensity, self.max)
+
+    @property
+    def intensity_scaled(self):
+        raw = max(0, min(1.0, (self.intensity_slew - self.scale_min)/(self.scale_max - self.scale_min)))
+        return raw * raw
--- a/core/tests/manual/issue-2302/libthree.py
+++ b/core/tests/manual/issue-2302/libthree.py
@@ -0,0 +1,189 @@
+import asyncio
+from dataclasses import dataclass, field
+from typing import Callable
+
+from pyscript import document, window
+
+from pyscript.js_modules import three as THREE
+from pyscript.js_modules.stats_gl import default as StatsGL
+from pyscript.js_modules import lsgeo, line2, linemat
+
+from multipyjs import MICROPYTHON, new, call, to_js, create_proxy
+
+@dataclass
+class SoundPlayer:
+    sound: THREE.Audio = field()
+    on_start: Callable[[], None] = field()
+    on_stop: Callable[[], None] = field(default=lambda: None)
+
+    _start_time: float = -1.0
+
+    def play(self):
+        self.sound.stop()
+        self.on_start()
+        self._start_time = self.sound.context.currentTime
+        self.sound.play()
+
+    def stop(self):
+        self.sound.stop()
+        self.on_stop()
+        self._start_time = -1.0
+
+    def toggle(self):
+        if self.sound.isPlaying:
+            self.stop()
+        else:
+            self.play()
+
+    @property
+    def running_time(self):
+        if self.sound.isPlaying:
+            return self.sound.context.currentTime - self._start_time
+        elif self._start_time != -1.0:
+            self.stop()
+        return 0.0
+
+def get_renderer():
+    renderer = new(THREE.WebGLRenderer, antialias=True)
+    renderer.setSize(window.innerWidth, window.innerHeight)
+    renderer.setPixelRatio(window.devicePixelRatio)
+    renderer.setClearColor(0xF5F0DC)
+    pyterms = list(document.getElementsByTagName("py-terminal"))
+    if pyterms:
+        pyterm = pyterms[0]
+        pyterm.parentNode.removeChild(pyterm)
+        document.getElementById("pyterm").appendChild(pyterm)
+
+    document.getElementById("threejs").appendChild(renderer.domElement)
+
+    initial = {0: "115px", 1: "calc(100vh - 120px)"}
+    @create_proxy
+    def split_element_style(dimension, size, gutter_size, index):
+        if index in initial:
+            result = {dimension: initial.pop(index)}
+        else:
+            result = {dimension: f"calc({int(size)}vh - {gutter_size}px)"}
+        return to_js(result)
+
+    call(
+        window.Split,
+        ["#pyterm", "#threejs"],
+        direction="vertical",
+        elementStyle=split_element_style,
+        minSize=0,
+        maxSize=to_js([120, 10000]),
+    )
+    return renderer
+
+def get_ortho_camera(view_size):
+    aspect_ratio = window.innerWidth / window.innerHeight
+    camera = new(
+        THREE.OrthographicCamera,
+        -view_size * aspect_ratio,  # Left
+        view_size * aspect_ratio,   # Right
+        view_size,                  # Top
+        -view_size,                 # Bottom
+        -view_size,                 # Near plane
+        view_size,                  # Far plane
+    )
+    camera.updateProjectionMatrix()
+    camera.position.set(0, 0, 0)
+    return camera
+
+def get_loading_manager():
+    loading_mgr = new(THREE.LoadingManager)
+    ev = asyncio.Event()
+
+    @create_proxy
+    def on_start(url, itemsLoaded, itemsTotal):
+        print(f'[{itemsLoaded}/{itemsTotal}] Started loading file: {url}')
+    loading_mgr.onStart = on_start
+
+    @create_proxy
+    def on_progress(url, itemsLoaded, itemsTotal):
+        print(f'[{itemsLoaded}/{itemsTotal}] Loading file: {url}')
+    loading_mgr.onProgress = on_progress
+
+    @create_proxy
+    def on_error(url):
+        print(f'There was a problem loading {url}')
+    loading_mgr.onError = on_error
+
+    @create_proxy
+    def on_load():
+        print('Loading assets complete!')
+        ev.set()
+    loading_mgr.onLoad = on_load
+
+    return loading_mgr, ev
+
+
+def get_perspective_camera():
+    aspect_ratio = window.innerWidth / window.innerHeight
+    camera = new(
+        THREE.PerspectiveCamera,
+        45,             # fov
+        aspect_ratio,
+        0.25,           # near plane
+        300,            # far plane
+    )
+    camera.position.set(0, 0, 30)
+    return camera
+
+def get_stats_gl(renderer):
+    stats = new(StatsGL, trackGPU=True, horizontal=False)
+    stats.init(renderer)
+    stats.dom.style.removeProperty("left")
+    stats.dom.style.right = "90px"
+    document.getElementById("stats").appendChild(stats.dom)
+    return stats
+
+def bg_from_v(*vertices):
+    geometry = new(THREE.BufferGeometry)
+    vertices_f32a = new(Float32Array, vertices)
+    attr = new(THREE.Float32BufferAttribute, vertices_f32a, 3)
+    return geometry.setAttribute('position', attr)
+
+def bg_from_p(*points):
+    buf = new(THREE.BufferGeometry)
+    buf.setFromPoints(
+        [new(THREE.Vector3, p[0], p[1], p[2]) for p in points]
+    )
+    return buf
+
+def clear():
+    # toggle stats and terminal?
+    stats_style = document.getElementById("stats-off").style
+    if stats_style.display == "none":
+        # turn stuff back on
+        stats_style.removeProperty("display")
+        document.getElementById("pyterm").style.height = "115px"
+        document.getElementById("threejs").style.height = "calc(100vh - 120px)"
+        for e in document.getElementsByClassName("gutter"):
+            e.style.removeProperty("display")
+        for e in document.getElementsByClassName("xterm-helper-textarea"):
+            e.focus()
+            break
+        return
+
+    # no longer focus on xterm
+    document.activeElement.blur()
+    # hide stats
+    document.getElementById("stats-off").style.display = "none"
+    # hide pyterm and split gutter
+    document.getElementById("pyterm").style.height = "0vh"
+    document.getElementById("threejs").style.height = "100vh"
+    for e in document.getElementsByClassName("gutter"):
+        e.style.display = "none"
+    # hide ltk ad
+    for e in document.getElementsByClassName("ltk-built-with"):
+        e.style.display = "none"
+    # hide pyscript ad
+    for e in document.getElementsByTagName("div"):
+        style = e.getAttribute("style")
+        if style and style.startswith("z-index:999"):
+            e.style.display = "none"
+    for e in document.getElementsByTagName("svg"):
+        style = e.getAttribute("style")
+        if style and style.startswith("z-index:999"):
+            e.style.display = "none"
--- a/core/tests/manual/issue-2302/main.py
+++ b/core/tests/manual/issue-2302/main.py
@@ -0,0 +1,285 @@
+print("Starting up...")
+
+from array import array
+import asyncio
+import math
+import time
+
+from pyscript import document, window, PyWorker
+
+from libthree import THREE, clear, SoundPlayer
+from libthree import get_renderer, get_ortho_camera
+from libthree import get_loading_manager, get_stats_gl
+from libthree import lsgeo, line2, linemat, lsgeo
+from libfft import BeatSync
+
+from multipyjs import MICROPYTHON, new, call, to_js, create_proxy
+
+from js import Float32Array
+
+scene = new(THREE.Scene)
+
+view_size = 1
+renderer = get_renderer()
+camera = get_ortho_camera(view_size)
+loading_mgr, loaded_event = get_loading_manager()
+
+t_loader = new(THREE.TextureLoader, loading_mgr)
+t_loader.setPath('assets/')
+
+light = new(THREE.AmbientLight, 0xffffff, 1.0)
+scene.add(light)
+
+fft_res = 2048
+audio_listener = new(THREE.AudioListener)
+camera.add(audio_listener)
+sound = new(THREE.Audio, audio_listener)
+audio_loader = new(THREE.AudioLoader, loading_mgr)
+analyser = new(THREE.AudioAnalyser, sound, fft_res)
+
+@create_proxy
+def on_audio_load(buffer):
+    sound.setBuffer(buffer)
+    sound.setVolume(0.9)
+    sound.setLoop(False)
+
+audio_loader.load("assets/genuary25-18.m4a", on_audio_load)
+
+spheres = new(THREE.Group)
+scene.add(spheres)
+
+line_basic_mat = new(
+    THREE.LineBasicMaterial,
+    color=0xffffff,
+)
+
+zero_mat = new(
+    linemat.LineMaterial,
+    color=0x662503,
+    linewidth=3,
+)
+
+other_mat = new(
+    linemat.LineMaterial,
+    color=0x662503,
+    linewidth=1.5,
+)
+
+grid_mat = new(
+    linemat.LineMaterial,
+    color=0x662503,
+    linewidth=1,
+    dashed=True,
+    dashScale=1,
+    dashSize=0.5,
+    gapSize=1,
+    dashOffset=0,
+)
+
+lines = [new(THREE.Group), new(THREE.Group)]
+scene.add(lines[0])
+scene.add(lines[1])
+
+def draw_lines(line_coords, mat_name, spy=False):
+    if spy:
+        line_coords_f32a = new(Float32Array, line_coords.length)
+        _it = line_coords.items
+        for i in range(line_coords.length):
+            line_coords_f32a[i] = _it[i]
+    else:
+        line_coords_f32a = new(Float32Array, line_coords)
+    if mat_name == 'zero':
+        mat = zero_mat
+    elif mat_name == 'grid':
+        mat = grid_mat
+    else:
+        mat = other_mat
+
+    geo = new(THREE.BufferGeometry)
+    geo.setAttribute('position', new(THREE.BufferAttribute, line_coords_f32a, 3))
+    seg = new(THREE.LineSegments, geo, line_basic_mat)
+
+    lsg = new(lsgeo.LineSegmentsGeometry)
+    lsg.fromLineSegments(seg)
+    l1 = new(line2.Line2, lsg, mat)
+    l1.computeLineDistances()
+    l2 = new(line2.Line2, lsg, mat)
+    l2.computeLineDistances()
+    lines[0].add(l1)
+    lines[1].add(l2)
+
+    seg.geometry.dispose()
+    del geo
+    del seg
+
+def drawing_done():
+    maybe_with_spy = "with SPy" if USE_SPY else "with pure Python"
+    print(f"Time elapsed computing {maybe_with_spy}:", time.time() - start_ts)
+    drawing_event.set()
+
+grid_width = 0
+grid_height = 0
+scroll_offset = 0
+def scale_lines(grid_ws=None, grid_hs=None, offset=None):
+    global grid_width, grid_height, scroll_offset
+
+    if grid_ws:
+        grid_width = grid_ws
+    else:
+        grid_ws = grid_width
+
+    if grid_hs:
+        grid_height = grid_hs
+    else:
+        grid_hs = grid_height
+
+    if offset:
+        scroll_offset = offset
+    else:
+        offset = scroll_offset
+
+    scale = 2.04/grid_hs
+    lines[0].scale.set(scale, scale, scale)
+    lines[1].scale.set(scale, scale, scale)
+    lines[0].position.set((offset - grid_ws/2) * scale, -grid_hs/2 * scale, 0)
+    lines[1].position.set((offset + grid_ws/2) * scale, -grid_hs/2 * scale, 0)
+
+def append_p(lines, p1, p2):
+    lines.append(p1[0])
+    lines.append(p1[1])
+    lines.append(0)
+    lines.append(p2[0])
+    lines.append(p2[1])
+    lines.append(0)
+
+def initial_calc():
+    grid_w = int(1920 * 4)
+    grid_h = 1080 * 2
+    grid_scale = 10
+    noise_factor = 500
+    grid_hs = int(grid_h/grid_scale)
+    grid_ws = int(grid_w/grid_scale)
+    crossfade_range = int(grid_ws/12.5)
+
+    def grid_lines():
+        lines = array("d")
+        grid_goal = 24
+        grid_size_i = int(round((grid_ws - crossfade_range) / grid_goal))
+        grid_actual = (grid_ws - crossfade_range) / grid_size_i
+        for i in range(0, grid_size_i):
+            x = i * grid_actual
+            append_p(lines, (x, 0), (x, grid_hs))
+        for y in range(0, grid_hs, grid_goal):
+            append_p(lines, (0, y), (grid_ws-crossfade_range, y))
+        return lines
+
+    import perlin
+    spy_perlin = perlin.lib
+    spy_perlin.init()
+    spy_perlin.seed(44)
+    scale_lines(grid_ws - crossfade_range, grid_hs)
+    print("Computing the height map")
+    spy_perlin.make_height_map(grid_ws, grid_hs)
+    spy_perlin.update_height_map(grid_ws, grid_hs, grid_scale / noise_factor, 0)
+    print("Cross-fading the height map")
+    spy_perlin.crossfade_height_map(grid_ws, grid_hs, crossfade_range)
+    print("Drawing grid")
+    draw_lines(grid_lines(), 'grid')
+    print("Marching squares")
+    draw_lines(spy_perlin.marching_squares(grid_ws, grid_hs, 0), 'zero', spy=True)
+    draw_lines(spy_perlin.marching_squares(grid_ws, grid_hs, 0.3), 'positive', spy=True)
+    draw_lines(spy_perlin.marching_squares(grid_ws, grid_hs, -0.3), 'negative', spy=True)
+    draw_lines(spy_perlin.marching_squares(grid_ws, grid_hs, 0.45), 'positive', spy=True)
+    draw_lines(spy_perlin.marching_squares(grid_ws, grid_hs, -0.45), 'negative', spy=True)
+    draw_lines(spy_perlin.marching_squares(grid_ws, grid_hs, 0.6), 'positive', spy=True)
+    draw_lines(spy_perlin.marching_squares(grid_ws, grid_hs, -0.6), 'negative', spy=True)
+    draw_lines(spy_perlin.marching_squares(grid_ws, grid_hs, -0.8), 'negative', spy=True)
+    draw_lines(spy_perlin.marching_squares(grid_ws, grid_hs, 0.8), 'positive', spy=True)
+    drawing_done()
+
+drawing_event = asyncio.Event()
+start_ts = time.time()
+
+USE_SPY = True
+if USE_SPY:
+    initial_calc()
+else:
+    worker = PyWorker("./worker.py", type="pyodide", configURL="./pyscript.toml")
+    worker.sync.draw_lines = draw_lines
+    worker.sync.drawing_done = drawing_done
+    worker.sync.scale_lines = scale_lines
+    worker.sync.print = print
+
+@create_proxy
+def on_tap(event):
+    clear()
+    player.toggle()
+document.addEventListener("click", on_tap)
+
+@create_proxy
+def on_key_down(event):
+    element = document.activeElement
+    _class = element.getAttribute("class")
+    in_xterm = element.tagName != "BODY" and _class and "xterm" in _class
+
+    if event.code == "Backquote":
+        # Screenshot mode.
+        clear()
+    elif not in_xterm:
+        # Don't react to those bindings when typing code.
+        if event.code == "Space":
+            player.toggle()
+document.addEventListener("keydown", on_key_down)
+
+@create_proxy
+def on_window_resize(event):
+    aspect_ratio = window.innerWidth / window.innerHeight
+    if camera.type == "OrthographicCamera":
+        camera.left = -view_size * aspect_ratio
+        camera.right = view_size * aspect_ratio
+        camera.top = view_size
+        camera.bottom = -view_size
+        camera.updateProjectionMatrix()
+    elif camera.type == "PerspectiveCamera":
+        camera.aspect = window.innerWidth / window.innerHeight
+        camera.updateProjectionMatrix()
+    else:
+        raise ValueError("Unknown camera type")
+    renderer.setSize(window.innerWidth, window.innerHeight)
+    scale_lines()
+
+window.addEventListener("resize", on_window_resize)
+
+@create_proxy
+def animate(now=0.0):
+    data = analyser.getFrequencyData()#.to_py() in Pyodide
+    audio_now = player.running_time
+    bs.update(data, audio_now)
+
+    if grid_width:
+        offset = -((20 * audio_now) % grid_width)
+        scale_lines(offset=offset)
+
+    renderer.render(scene, camera)
+    stats_gl.update()
+
+def reset():
+    global scroll_offset
+    bs.reset()
+    scale_lines()
+
+def on_stop():
+    global scroll_offset
+    bs.reset()
+    scale_lines()
+
+await loaded_event.wait()
+
+stats_gl = get_stats_gl(renderer)
+player = SoundPlayer(sound=sound, on_start=reset, on_stop=on_stop)
+bs = BeatSync(fft_res=fft_res)
+renderer.setAnimationLoop(animate)
+print("Waiting for the contours...")
+
+await drawing_event.wait()
+print("Tap the map to start...")
--- a/core/tests/manual/issue-2302/perlin_py.py
+++ b/core/tests/manual/issue-2302/perlin_py.py
@@ -0,0 +1,110 @@
+# Translated from https://github.com/josephg/noisejs.
+from libthree import THREE
+from multipyjs import new
+
+class V3:
+    def __init__(self, x, y, z):
+        self.x = x
+        self.y = y
+        self.z = z
+
+    def __repr__(self):
+        return f"V3({self.x}, {self.y}, {self.z})"
+
+    def dot2(self, x, y):
+        return self.x * x + self.y * y
+
+    def dot3(self, x, y, z):
+        return self.x * x + self.y * y + self.z * z
+
+    def to_js(self, scale=1.0):
+        return new(THREE.Vector3, self.x * scale, self.y * scale, self.z * scale)
+
+PERM = [0] * 512
+V3_P = [0] * 512  # assigned V3s in seed()
+P = [151, 160, 137, 91, 90, 15,
+     131, 13, 201, 95, 96, 53, 194, 233, 7, 225, 140, 36, 103, 30, 69, 142, 8, 99, 37, 240, 21, 10, 23,
+     190, 6, 148, 247, 120, 234, 75, 0, 26, 197, 62, 94, 252, 219, 203, 117, 35, 11, 32, 57, 177, 33,
+     88, 237, 149, 56, 87, 174, 20, 125, 136, 171, 168, 68, 175, 74, 165, 71, 134, 139, 48, 27, 166,
+     77, 146, 158, 231, 83, 111, 229, 122, 60, 211, 133, 230, 220, 105, 92, 41, 55, 46, 245, 40, 244,
+     102, 143, 54, 65, 25, 63, 161, 1, 216, 80, 73, 209, 76, 132, 187, 208, 89, 18, 169, 200, 196,
+     135, 130, 116, 188, 159, 86, 164, 100, 109, 198, 173, 186, 3, 64, 52, 217, 226, 250, 124, 123,
+     5, 202, 38, 147, 118, 126, 255, 82, 85, 212, 207, 206, 59, 227, 47, 16, 58, 17, 182, 189, 28, 42,
+     223, 183, 170, 213, 119, 248, 152, 2, 44, 154, 163, 70, 221, 153, 101, 155, 167, 43, 172, 9,
+     129, 22, 39, 253, 19, 98, 108, 110, 79, 113, 224, 232, 178, 185, 112, 104, 218, 246, 97, 228,
+     251, 34, 242, 193, 238, 210, 144, 12, 191, 179, 162, 241, 81, 51, 145, 235, 249, 14, 239, 107,
+     49, 192, 214, 31, 181, 199, 106, 157, 184, 84, 204, 176, 115, 121, 50, 45, 127, 4, 150, 254,
+     138, 236, 205, 93, 222, 114, 67, 29, 24, 72, 243, 141, 128, 195, 78, 66, 215, 61, 156, 180]
+V3_I = [V3(1, 1, 0), V3(-1, 1, 0), V3(1, -1, 0), V3(-1, -1, 0),
+        V3(1, 0, 1), V3(-1, 0, 1), V3(1, 0, -1), V3(-1, 0, -1),
+        V3(0, 1, 1), V3(0, -1, 1), V3(0, 1, -1), V3(0, -1, -1)]
+
+def seed(s):
+    if isinstance(s, float) and 0.0 < s < 1.0:
+        s *= 65536
+
+    s = int(s)
+    if s < 256:
+        s |= s << 8
+
+    for i in range(256):
+        if i & 1:
+            v = P[i] ^ (s & 255)
+        else:
+            v = P[i] ^ ((s >> 8) & 255)
+
+        PERM[i] = PERM[i + 256] = v
+        V3_P[i] = V3_P[i + 256] = V3_I[v % 12]
+
+seed(0)
+
+def fade(t):
+    return t * t * t * (t * (t * 6 - 15) + 10)
+
+def lerp(a, b, t):
+    return (1 - t) * a + t * b
+
+def perlin3(x, y, z):
+    # grid cells
+    x_c = int(x)
+    y_c = int(y)
+    z_c = int(z)
+    # relative coords within the cell
+    x -= x_c
+    y -= y_c
+    z -= z_c
+    # wrap cells
+    x_c &= 255
+    y_c &= 255
+    z_c &= 255
+    # noise contributions to corners
+    n000 = V3_P[x_c + PERM[y_c + PERM[z_c]]].dot3(x, y, z)
+    n001 = V3_P[x_c + PERM[y_c + PERM[z_c + 1]]].dot3(x, y, z - 1)
+    n010 = V3_P[x_c + PERM[y_c + 1 + PERM[z_c]]].dot3(x, y - 1, z)
+    n011 = V3_P[x_c + PERM[y_c + 1 + PERM[z_c + 1]]].dot3(x, y - 1, z - 1)
+    n100 = V3_P[x_c + 1 + PERM[y_c + PERM[z_c]]].dot3(x - 1, y, z)
+    n101 = V3_P[x_c + 1 + PERM[y_c + PERM[z_c + 1]]].dot3(x - 1, y, z - 1)
+    n110 = V3_P[x_c + 1 + PERM[y_c + 1 + PERM[z_c]]].dot3(x - 1, y - 1, z)
+    n111 = V3_P[x_c + 1 + PERM[y_c + 1 + PERM[z_c + 1]]].dot3(x - 1, y - 1, z - 1)
+    # fade curve
+    u = fade(x)
+    v = fade(y)
+    w = fade(z)
+    # interpolation
+    return lerp(
+        lerp(lerp(n000, n100, u), lerp(n001, n101, u), w),
+        lerp(lerp(n010, n110, u), lerp(n011, n111, u), w),
+        v,
+    )
+
+def curl2(x, y, z):
+    # https://www.bit-101.com/2017/2021/07/curl-noise/
+    delta = 0.01
+    n1 = perlin3(x + delta, y, z)
+    n2 = perlin3(x - delta, y, z)
+    cy = -(n1 - n2) / (delta * 2)
+    n1 = perlin3(x, y + delta, z)
+    n2 = perlin3(x, y - delta, z)
+    cx = -(n1 - n2) / (delta * 2)
+    print(n1, n2)
+    return V3(cx, cy, 0)
--- a/core/tests/manual/issue-2302/pyscript.toml
+++ b/core/tests/manual/issue-2302/pyscript.toml
@@ -0,0 +1,16 @@
+name = "Marching Squares with SPy Copy Copy"
+packages = [ "cffi", "./glue/perlin-0.0.0-cp312-cp312-pyodide_2024_0_wasm32.whl",]
+
+[files]
+"./libthree.py" = ""
+"./libfft.py" = ""
+"./perlin_py.py" = ""
+"./worker.py" = ""
+"./glue/multipyjs.py" = "./multipyjs.py"
+
+[js_modules.main]
+"https://cdn.jsdelivr.net/npm/three@v0.173.0/build/three.module.js" = "three"
+"https://cdn.jsdelivr.net/npm/three@v0.173.0/examples/jsm/lines/LineMaterial.js" = "linemat"
+"https://cdn.jsdelivr.net/npm/three@v0.173.0/examples/jsm/lines/Line2.js" = "line2"
+"https://cdn.jsdelivr.net/npm/three@v0.173.0/examples/jsm/lines/LineSegmentsGeometry.js" = "lsgeo"
+"https://cdn.jsdelivr.net/npm/stats-gl@3.6.0/dist/main.js" = "stats_gl"
--- a/core/tests/manual/issue-2302/worker.py
+++ b/core/tests/manual/issue-2302/worker.py
@@ -0,0 +1,141 @@
+from array import array
+
+from pyscript import sync, window
+from perlin_py import perlin3, seed
+
+grid_w = int(1920 * 4)
+grid_h = 1080 * 2
+grid_scale = 10
+noise_factor = 500
+grid_hs = int(grid_h/grid_scale)
+grid_ws = int(grid_w/grid_scale)
+crossfade_range = int(grid_ws/12.5)
+height_map = array("d", [0.0] * (grid_hs * grid_ws))
+edge_table = [
+    (), # 0
+    ((3, 2),), # 1
+    ((2, 1),), # 2
+    ((3, 1),), # 3
+    ((0, 1),), # 4
+    ((0, 3), (1, 2)), # 5 (ambiguous)
+    ((0, 2),), # 6
+    ((0, 3),), # 7
+    ((0, 3),), # 8
+    ((0, 2),), # 9
+    ((0, 1), (2, 3)), # 10 (ambiguous)
+    ((0, 1),), # 11
+    ((3, 1),), # 12
+    ((2, 1),), # 13
+    ((3, 2),), # 14
+    (),        # 15
+]
+
+def update_height_map(z):
+    i = 0
+    for y in range(0, grid_h, grid_scale):
+        for x in range(0, grid_w, grid_scale):
+            # 3 octaves of noise
+            n = perlin3(x/noise_factor, y/noise_factor, z)
+            n += 0.50 * perlin3(2*x/noise_factor, 2*y/noise_factor, z)
+            n += 0.25 * perlin3(4*x/noise_factor, 4*y/noise_factor, z)
+            height_map[i] = n
+            i += 1
+
+def crossfade_height_map():
+    for y in range(grid_hs):
+        for x in range(crossfade_range):
+            pos_i = y*grid_ws + x
+            neg_i = y*grid_ws + grid_ws - crossfade_range + x
+            weight = x/crossfade_range
+            old_pos = height_map[pos_i]
+            old_neg = height_map[neg_i]
+            height_map[neg_i] = height_map[pos_i] = weight * old_pos + (1.0 - weight) * old_neg
+
+
+def _crossfade_height_map():
+    for y in range(grid_hs):
+        for x in range(crossfade_range):
+            pos_i = y*grid_ws + x
+            neg_i = y*grid_ws + grid_ws - x - 1
+            old_pos = height_map[pos_i]
+            old_neg = height_map[neg_i]
+            weight = 0.5 - x/crossfade_range/2
+            height_map[pos_i] = (1.0 - weight) * old_pos + weight * old_neg
+            height_map[neg_i] = (1.0 - weight) * old_neg + weight * old_pos
+
+def interpolate(sq_threshold, v1, v2):
+    if v1 == v2:
+        return v1
+    return (sq_threshold - v1) / (v2 - v1)
+
+stats = {'maxx': 0, 'maxy': 0, 'minx': 0, 'miny': 0}
+def append_p(lines, p1, p2):
+    lines.append(p1[0])
+    lines.append(p1[1])
+    lines.append(0)
+    lines.append(p2[0])
+    lines.append(p2[1])
+    lines.append(0)
+    stats['maxy'] = max(p1[1], p2[1], stats['maxy'])
+    stats['miny'] = min(p1[1], p2[1], stats['miny'])
+    stats['maxx'] = max(p1[0], p2[0], stats['maxx'])
+    stats['minx'] = min(p1[0], p2[0], stats['minx'])
+
+def marching_squares(height_map, sq_threshold):
+    lines = array("d")
+
+    for y in range(grid_hs-1):
+        for x in range(grid_ws-1): #cf
+            tl = height_map[y*grid_ws + x]
+            tr = height_map[y*grid_ws + x+1]
+            bl = height_map[(y+1)*grid_ws + x]
+            br = height_map[(y+1)*grid_ws + x+1]
+
+            sq_idx = 0
+            if tl > sq_threshold:
+                sq_idx |= 8
+            if tr > sq_threshold:
+                sq_idx |= 4
+            if br > sq_threshold:
+                sq_idx |= 2
+            if bl > sq_threshold:
+                sq_idx |= 1
+
+            edge_points = [
+                (x + interpolate(sq_threshold, tl, tr), y),
+                (x + 1, y + interpolate(sq_threshold, tr, br)),
+                (x + interpolate(sq_threshold, bl, br), y + 1),
+                (x, y + interpolate(sq_threshold, tl, bl)),
+            ]
+
+            for a, b in edge_table[sq_idx]:
+                append_p(lines, edge_points[a], edge_points[b])
+
+    return lines
+
+def grid_lines():
+    lines = array("d")
+    for x in range(0, grid_ws - crossfade_range, 26):
+        append_p(lines, (x, 0), (x, grid_hs))
+    for y in range(0, grid_hs, 24):
+        append_p(lines, (0, y), (grid_ws-crossfade_range, y))
+    return lines
+
+seed(44)
+sync.scale_lines(grid_ws - crossfade_range, grid_hs)
+sync.print("Computing the height map")
+update_height_map(0)
+sync.print("Cross-fading the height map")
+crossfade_height_map()
+sync.draw_lines(grid_lines(), 'grid')
+sync.draw_lines(marching_squares(height_map, 0), 'zero')
+sync.draw_lines(marching_squares(height_map, 0.3), 'positive')
+sync.draw_lines(marching_squares(height_map, -0.3), 'negative')
+sync.draw_lines(marching_squares(height_map, 0.45), 'positive')
+sync.draw_lines(marching_squares(height_map, -0.45), 'negative')
+sync.draw_lines(marching_squares(height_map, 0.6), 'positive')
+sync.draw_lines(marching_squares(height_map, -0.6), 'negative')
+sync.draw_lines(marching_squares(height_map, -0.8), 'negative')
+sync.draw_lines(marching_squares(height_map, 0.8), 'positive')
+print(stats)
+sync.drawing_done()
--- a/core/tests/manual/issue-2304/index.html
+++ b/core/tests/manual/issue-2304/index.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <link rel="stylesheet" href="../../../dist/core.css">
+  <script type="module" src="../../../dist/core.js"></script>
+</head>
+<body>
+  <div id="status">Status:</div>
+  <canvas id="canvas" width="200" height="200"></canvas>
+  <script type="py-game" src="./main.py" config="./pyscript.toml"></script>
+</body>
+</html>
--- a/core/tests/manual/issue-2304/main.py
+++ b/core/tests/manual/issue-2304/main.py
@@ -0,0 +1,34 @@
+import sys
+print("Starting test...")
+
+# Try NumPy
+try:
+    import numpy as np
+    arr = np.array([1, 2, 3])
+    print(f"NumPy works: {arr.mean()}")
+except Exception as e:
+    print(f"NumPy error: {e}")
+
+# Try PyGame without NumPy first
+try:
+    print("Testing PyGame...")
+    import pygame
+    screen = pygame.display.set_mode((200, 200))
+    screen.fill((255, 0, 0))  # Fill with red
+    pygame.display.flip()
+    print("PyGame works!")
+except Exception as e:
+    print(f"PyGame error: {e}")
+
+# Now try PyGame with NumPy
+try:
+    print("Testing PyGame+NumPy...")
+    color_array = np.random.randint(0, 255, size=(50, 50, 3), dtype=np.uint8)
+    surface = pygame.surfarray.make_surface(color_array)
+    screen.blit(surface, (75, 75))
+    pygame.display.flip()
+    print("PyGame+NumPy integration works!")
+except Exception as e:
+    print(f"PyGame+NumPy integration error: {e}")
+
+print("Test completed")
--- a/core/tests/manual/issue-2304/pyscript.toml
+++ b/core/tests/manual/issue-2304/pyscript.toml
@@ -0,0 +1,2 @@
+name = "PyGame Numpy Minimal Example Copy"
+packages = [ "numpy", ]
--- a/core/tests/py_tests.main.spec.js
+++ b/core/tests/py_tests.main.spec.js
@@ -0,0 +1,21 @@
+import { test, expect } from '@playwright/test';
+
+const timeout = 60 * 1000;
+
+test.setTimeout(timeout);
+
+test('Python unit tests - MicroPython on MAIN thread', async ({ page }) => {
+  await page.goto('http://localhost:8080/tests/python/index.html');
+  const result = page.locator("#result");  // Payload for results will be here.
+  await result.waitFor({ timeout });  // wait for the result.
+  const data = JSON.parse(await result.textContent());  // get the result data.
+  await expect(data.fails).toMatchObject([]);  // ensure no test failed.
+});
+
+test('Python unit tests - Pyodide on MAIN thread', async ({ page }) => {
+  await page.goto('http://localhost:8080/tests/python/index.html?type=py');
+  const result = page.locator("#result");  // Payload for results will be here.
+  await result.waitFor({ timeout });  // wait for the result.
+  const data = JSON.parse(await result.textContent());  // get the result data.
+  await expect(data.fails).toMatchObject([]);  // ensure no test failed.
+});
--- a/core/tests/py_tests.spec.js
+++ b/core/tests/py_tests.spec.js
@@ -1,35 +0,0 @@
-import { test, expect } from '@playwright/test';
-
-test.setTimeout(120 * 1000);
-
-test('Python unit tests - MicroPython on MAIN thread', async ({ page }) => {
-  await page.goto('http://localhost:8080/tests/python/index.html');
-  const result = page.locator("#result");  // Payload for results will be here.
-  await result.waitFor();  // wait for the result.
-  const data = JSON.parse(await result.textContent());  // get the result data.
-  await expect(data.fails).toMatchObject([]);  // ensure no test failed.
-});
-
-test('Python unit tests - Pyodide on MAIN thread', async ({ page }) => {
-  await page.goto('http://localhost:8080/tests/python/index.html?type=py');
-  const result = page.locator("#result");  // Payload for results will be here.
-  await result.waitFor();  // wait for the result.
-  const data = JSON.parse(await result.textContent());  // get the result data.
-  await expect(data.fails).toMatchObject([]);  // ensure no test failed.
-});
-
-test('Python unit tests - MicroPython on WORKER', async ({ page }) => {
-  await page.goto('http://localhost:8080/tests/python/index.html?worker');
-  const result = page.locator("#result");  // Payload for results will be here.
-  await result.waitFor();  // wait for the result.
-  const data = JSON.parse(await result.textContent());  // get the result data.
-  await expect(data.fails).toMatchObject([]);  // ensure no test failed.
-});
-
-test('Python unit tests - Pyodide on WORKER', async ({ page }) => {
-  await page.goto('http://localhost:8080/tests/python/index.html?type=py&worker');
-  const result = page.locator("#result");  // Payload for results will be here.
-  await result.waitFor();  // wait for the result.
-  const data = JSON.parse(await result.textContent());  // get the result data.
-  await expect(data.fails).toMatchObject([]);  // ensure no test failed.
-});
--- a/core/tests/py_tests.worker.spec.js
+++ b/core/tests/py_tests.worker.spec.js
@@ -0,0 +1,21 @@
+import { test, expect } from '@playwright/test';
+
+const timeout = 120 * 1000;
+
+test.setTimeout(timeout);
+
+test('Python unit tests - MicroPython on WORKER', async ({ page }) => {
+  await page.goto('http://localhost:8080/tests/python/index.html?worker');
+  const result = page.locator("#result");  // Payload for results will be here.
+  await result.waitFor({ timeout });  // wait for the result.
+  const data = JSON.parse(await result.textContent());  // get the result data.
+  await expect(data.fails).toMatchObject([]);  // ensure no test failed.
+});
+
+test('Python unit tests - Pyodide on WORKER', async ({ page }) => {
+  await page.goto('http://localhost:8080/tests/python/index.html?type=py&worker');
+  const result = page.locator("#result");  // Payload for results will be here.
+  await result.waitFor({ timeout });  // wait for the result.
+  const data = JSON.parse(await result.textContent());  // get the result data.
+  await expect(data.fails).toMatchObject([]);  // ensure no test failed.
+});
--- a/core/tests/python/settings_mpy.json
+++ b/core/tests/python/settings_mpy.json
@@ -8,6 +8,7 @@
        "./tests/test_fetch.py": "tests/test_fetch.py",
        "./tests/test_ffi.py": "tests/test_ffi.py",
        "./tests/test_js_modules.py": "tests/test_js_modules.py",
+        "./tests/test_media.py": "tests/test_media.py",
        "./tests/test_storage.py": "tests/test_storage.py",
        "./tests/test_running_in_worker.py": "tests/test_running_in_worker.py",
        "./tests/test_web.py": "tests/test_web.py",
--- a/core/tests/python/settings_py.json
+++ b/core/tests/python/settings_py.json
@@ -7,6 +7,7 @@
        "./tests/test_document.py": "tests/test_document.py",
        "./tests/test_fetch.py": "tests/test_fetch.py",
        "./tests/test_ffi.py": "tests/test_ffi.py",
+        "./tests/test_media.py": "tests/test_media.py",
        "./tests/test_js_modules.py": "tests/test_js_modules.py",
        "./tests/test_storage.py": "tests/test_storage.py",
        "./tests/test_running_in_worker.py": "tests/test_running_in_worker.py",
@@ -23,5 +24,6 @@
            "./example_js_worker_module.js": "greeting_worker"
        }
    },
-    "packages": ["Pillow" ]
+    "packages": ["Pillow" ],
+    "experimental_ffi_timeout": 0
 }
--- a/core/tests/python/tests/test_current_target.py
+++ b/core/tests/python/tests/test_current_target.py
@@ -13,10 +13,7 @@ def test_current_target():
    """
    expected = "py-0"
    if is_micropython:
-        if RUNNING_IN_WORKER:
-            expected = "mpy-w0-target"
-        else:
-            expected = "mpy-0"
+        expected = "mpy-w0-target" if RUNNING_IN_WORKER else "mpy-0"
    elif RUNNING_IN_WORKER:
        expected = "py-w0-target"
    assert current_target() == expected, f"Expected {expected} got {current_target()}"
--- a/core/tests/python/tests/test_display.py
+++ b/core/tests/python/tests/test_display.py
@@ -256,7 +256,7 @@ async def test_image_display():
    """
    Check an image is displayed correctly.
    """
-    mpl = await py_import("matplotlib")
+    _mpl = await py_import("matplotlib")
    import matplotlib.pyplot as plt

    xpoints = [3, 6, 9]
--- a/core/tests/python/tests/test_media.py
+++ b/core/tests/python/tests/test_media.py
@@ -0,0 +1,87 @@
+""""
+Tests for the PyScript media module.
+"""
+
+from pyscript import media
+import upytest
+
+from pyscript import media
+
+
+@upytest.skip(
+    "Uses Pyodide-specific to_js function in MicroPython",
+    skip_when=upytest.is_micropython,
+)
+async def test_device_enumeration():
+    """Test enumerating media devices."""
+    devices = await media.list_devices()
+    assert isinstance(devices, list), "list_devices should return a list"
+
+    # If devices are found, verify they have the expected functionality
+    if devices:
+        device = devices[0]
+
+        # Test real device properties exist (but don't assert on their values)
+        # Browser security might restrict actual values until permissions are granted
+        assert hasattr(device, "id"), "Device should have id property"
+        assert hasattr(device, "kind"), "Device should have kind property"
+        assert device.kind in [
+            "videoinput",
+            "audioinput",
+            "audiooutput",
+        ], f"Device should have a valid kind, got: {device.kind}"
+
+        # Verify dictionary access works with actual device
+        assert (
+            device["id"] == device.id
+        ), "Dictionary access should match property access"
+        assert (
+            device["kind"] == device.kind
+        ), "Dictionary access should match property access"
+
+
+@upytest.skip("Waiting on a bug-fix in MicroPython, for this test to work.", skip_when=upytest.is_micropython)
+async def test_video_stream_acquisition():
+    """Test video stream."""
+    try:
+        # Load a video stream
+        stream = await media.Device.load(video=True)
+
+        # Verify we get a real stream with expected properties
+        assert hasattr(stream, "active"), "Stream should have active property"
+
+        # Check for video tracks, but don't fail if permissions aren't granted
+        if stream._dom_element and hasattr(stream._dom_element, "getVideoTracks"):
+            tracks = stream._dom_element.getVideoTracks()
+            if tracks.length > 0:
+                assert True, "Video stream has video tracks"
+    except Exception as e:
+        # If the browser blocks access, the test should still pass
+        # This is because we're testing the API works, not that permissions are granted
+        assert (
+            True
+        ), f"Stream acquisition attempted but may require permissions: {str(e)}"
+
+
+@upytest.skip("Waiting on a bug-fix in MicroPython, for this test to work.", skip_when=upytest.is_micropython)
+async def test_custom_video_constraints():
+    """Test loading video with custom constraints."""
+    try:
+        # Define custom constraints
+        constraints = {"width": 640, "height": 480}
+
+        # Load stream with custom constraints
+        stream = await media.Device.load(video=constraints)
+
+        # Basic stream property check
+        assert hasattr(stream, "active"), "Stream should have active property"
+
+        # Check for tracks only if we have access
+        if stream._dom_element and hasattr(stream._dom_element, "getVideoTracks"):
+            tracks = stream._dom_element.getVideoTracks()
+            if tracks.length > 0 and hasattr(tracks[0], "getSettings"):
+                # Settings verification is optional - browsers may handle constraints differently
+                pass
+    except Exception as e:
+        # If the browser blocks access, test that the API structure works
+        assert True, f"Custom constraint test attempted: {str(e)}"
--- a/core/tests/python/tests/test_storage.py
+++ b/core/tests/python/tests/test_storage.py
@@ -65,7 +65,6 @@ async def test_storage_types():
    assert test_store["string"] == "hello"
    assert isinstance(test_store["string"], str)
    assert test_store["none"] is None
-    assert isinstance(test_store["none"], type(None))
    assert test_store["list"] == [1, 2, 3]
    assert isinstance(test_store["list"], list)
    assert test_store["dict"] == {"a": 1, "b": 2}
--- a/core/tests/python/tests/test_web.py
+++ b/core/tests/python/tests/test_web.py
@@ -248,7 +248,7 @@ class TestCollection:

    def test_iter_eq_children(self):
        elements = web.page.find(".multi-elems")
-        assert [el for el in elements] == [el for el in elements.elements]
+        assert list(elements) == list(elements.elements)
        assert len(elements) == 3

    def test_slices(self):
@@ -427,18 +427,18 @@ class TestInput:
 class TestSelect:

    def test_select_options_iter(self):
-        select = web.page.find(f"#test_select_element_w_options")[0]
+        select = web.page.find("#test_select_element_w_options")[0]

        for i, option in enumerate(select.options, 1):
            assert option.value == f"{i}"
            assert option.innerHTML == f"Option {i}"

    def test_select_options_len(self):
-        select = web.page.find(f"#test_select_element_w_options")[0]
+        select = web.page.find("#test_select_element_w_options")[0]
        assert len(select.options) == 2

    def test_select_options_clear(self):
-        select = web.page.find(f"#test_select_element_to_clear")[0]
+        select = web.page.find("#test_select_element_to_clear")[0]
        assert len(select.options) == 3

        select.options.clear()
@@ -447,7 +447,7 @@ class TestSelect:

    def test_select_element_add(self):
        # GIVEN the existing select element with no options
-        select = web.page.find(f"#test_select_element")[0]
+        select = web.page.find("#test_select_element")[0]

        # EXPECT the select element to have no options
        assert len(select.options) == 0
@@ -498,20 +498,14 @@ class TestSelect:
        # EXPECT the middle option to have the value and html we passed in
        assert select.options[0].value == "1"
        assert select.options[0].innerHTML == "Option 1"
-        assert (
-            select.options[0].selected
-            == select.options[0]._dom_element.selected
-            == False
-        )
+        assert select.options[0].selected == select.options[0]._dom_element.selected
+        assert select.options[0].selected is False
        assert select.options[1].value == "2"
        assert select.options[1].innerHTML == "Option 2"
        assert select.options[2].value == "3"
        assert select.options[2].innerHTML == "Option 3"
-        assert (
-            select.options[2].selected
-            == select.options[2]._dom_element.selected
-            == True
-        )
+        assert select.options[2].selected == select.options[2]._dom_element.selected
+        assert select.options[2].selected is True
        assert select.options[3].value == ""
        assert select.options[3].innerHTML == ""

@@ -538,7 +532,7 @@ class TestSelect:

    def test_select_options_remove(self):
        # GIVEN the existing select element with 3 options
-        select = web.page.find(f"#test_select_element_to_remove")[0]
+        select = web.page.find("#test_select_element_to_remove")[0]

        # EXPECT the select element to have 3 options
        assert len(select.options) == 4
@@ -560,7 +554,7 @@ class TestSelect:

    def test_select_get_selected_option(self):
        # GIVEN the existing select element with one selected option
-        select = web.page.find(f"#test_select_element_w_options")[0]
+        select = web.page.find("#test_select_element_w_options")[0]

        # WHEN we get the selected option
        selected_option = select.options.selected
@@ -568,7 +562,8 @@ class TestSelect:
        # EXPECT the selected option to be correct
        assert selected_option.value == "2"
        assert selected_option.innerHTML == "Option 2"
-        assert selected_option.selected == selected_option._dom_element.selected == True
+        assert selected_option.selected == selected_option._dom_element.selected
+        assert selected_option.selected is True


 class TestElements:
@@ -625,7 +620,8 @@ class TestElements:
            el = klass(*args, **kwargs)
            container.append(el)
        except Exception as e:
-            assert False, f"Failed to create element {el_type}: {e}"
+            msg = f"Failed to create element {el_type}: {e}"
+            raise AssertionError(msg)

        # Let's keep the tag in 2 variables, one for the selector and another to
        # check the return tag from the selector
@@ -875,7 +871,17 @@ class TestElements:
        self._create_el_and_basic_asserts("kbd", "some text")

    def test_label(self):
-        self._create_el_and_basic_asserts("label", "some text")
+        label_text = "Luke, I am your father"
+        label_for = "some-id"
+        # Let's create the element
+        el = web.label(label_text, for_=label_for)
+        # Let's check the element was configured correctly.
+        assert isinstance(el, web.label), "The new element should be a label."
+        assert el.textContent == label_text, "The label text should match."
+        assert el._dom_element.tagName == "LABEL"
+        assert el.for_ == label_for, "The label should have the correct for attribute."
+        # Ensure the label element is rendered with the correct "for" attribute
+        assert f'for="{label_for}"' in el.outerHTML, "The label should have the correct 'for' attribute in its HTML."

    def test_legend(self):
        self._create_el_and_basic_asserts("legend", "some text")
--- a/core/tests/python/tests/test_websocket.py
+++ b/core/tests/python/tests/test_websocket.py
@@ -3,10 +3,12 @@ Exercise the pyscript.Websocket class.
 """

 import asyncio
+import upytest

 from pyscript import WebSocket


+@upytest.skip("Websocket tests are disabled.")
 async def test_websocket_with_attributes():
    """
    Event handlers assigned via object attributes.
@@ -52,6 +54,7 @@ async def test_websocket_with_attributes():
    assert closed_flag is True


+@upytest.skip("Websocket tests are disabled.")
 async def test_websocket_with_init():
    """
    Event handlers assigned via __init__ arguments.
--- a/core/types/fs.d.ts
+++ b/core/types/fs.d.ts
@@ -0,0 +1,8 @@
+export const NAMESPACE: "@pyscript.fs";
+export const ERROR: "storage permissions not granted";
+export const idb: any;
+export function getFileSystemDirectoryHandle(options: {
+    id?: string;
+    mode?: "read" | "readwrite";
+    hint?: "desktop" | "documents" | "downloads" | "music" | "pictures" | "videos";
+}): Promise<FileSystemDirectoryHandle>;
--- a/core/types/stdlib/pyscript.d.ts
+++ b/core/types/stdlib/pyscript.d.ts
@@ -6,6 +6,7 @@ declare namespace _default {
        "fetch.py": string;
        "ffi.py": string;
        "flatted.py": string;
+        "fs.py": string;
        "magic_js.py": string;
        "media.py": string;
        "storage.py": string;
--- a/core/types/sync.d.ts
+++ b/core/types/sync.d.ts
@@ -5,5 +5,16 @@ declare namespace _default {
     * @param {number} seconds The number of seconds to sleep.
     */
    function sleep(seconds: number): Promise<any>;
+    /**
+     * Ask a user action via dialog and returns the directory handler once granted.
+     * @param {string} uid
+     * @param {{id?:string, mode?:"read"|"readwrite", hint?:"desktop"|"documents"|"downloads"|"music"|"pictures"|"videos"}} options
+     * @returns {boolean}
+     */
+    function storeFSHandler(uid: string, options?: {
+        id?: string;
+        mode?: "read" | "readwrite";
+        hint?: "desktop" | "documents" | "downloads" | "music" | "pictures" | "videos";
+    }): boolean;
 }
 export default _default;
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Andrea Giammarchi	eaa6711756	Fix #2360 - Better shared env/setup handling (#2361 )	2025-07-11 10:56:14 +02:00
Andrea Giammarchi	b528ba67a9	Intermediate release with async worker handler fixes (#2359 )	2025-07-10 15:21:50 +02:00
Andrea Giammarchi	71ad1a40cb	Update Polyscript with latest Micropython (#2357 )	2025-07-04 09:34:12 +02:00
Andrea Giammarchi	e433275938	Readme update (#2356 ) * Updated the README with latest PyScript version * [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --------- Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>	2025-07-01 14:01:51 +02:00
Andrea Giammarchi	87256a662b	Updated Polyscript to its latest (#2355 ) * Updated Polyscript to its latest * added tests for `experimental_ffi_timeout`	2025-07-01 13:07:28 +02:00
Andrea Giammarchi	7336ae545e	The PyScript Bridge Helper (#2353 ) * The PyScript Bridge Helper * added importmap to test latest versions with ease	2025-06-26 12:41:29 +02:00
Nicholas Tollervey	d68260c0c7	Fix a bug in `<label>` handling where 'for_' attribute should be 'htmlFor' on underlying HTML element. (#2352 ) * Fix bug in label handling where 'for_' attribute should be 'htmlFor' on underlying HTML element. * Fix comment.	2025-06-18 15:01:33 +01:00
Nicholas Tollervey	14cc05fb80	Fix code example problem in the release HTML. (#2345 )	2025-05-21 16:27:27 +01:00
Andrea Giammarchi	42c6cb775e	Added all 3rd party licenses to this project (#2343 )	2025-05-21 14:30:55 +01:00
Andrea Giammarchi	b11fb2e893	Added polyscript/service-worker as workaround for missing sabayon (#2334 ) * Added polyscript/service-worker as workaround for missing sabayon * [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci * updated polyscript to its latest * Updated polyscript one mor time --------- Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>	2025-05-15 18:20:38 +02:00
pre-commit-ci[bot]	3223a9c7e9	[pre-commit.ci] pre-commit autoupdate (#2336 ) updates: - [github.com/astral-sh/ruff-pre-commit: v0.11.4 → v0.11.8](https://github.com/astral-sh/ruff-pre-commit/compare/v0.11.4...v0.11.8) Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>	2025-05-06 09:22:05 -04:00
Andrea Giammarchi	139ce9b5fb	Updated Polyscript & Coincident to their latest (#2327 )	2025-04-23 17:56:06 +02:00
pre-commit-ci[bot]	3b1af0688c	[pre-commit.ci] pre-commit autoupdate (#2307 ) updates: - [github.com/astral-sh/ruff-pre-commit: v0.9.6 → v0.11.4](https://github.com/astral-sh/ruff-pre-commit/compare/v0.9.6...v0.11.4) Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com> Co-authored-by: Dan Yeaw <dan@yeaw.me>	2025-04-18 12:02:24 -04:00
Andrea Giammarchi	7284f7f15f	Fix #2320 - Dispatch an event on code run in PyEditor (#2329 ) * Fix #2320 - Dispatch an event on code run in PyEditor	2025-04-16 22:01:40 +02:00
Andrea Giammarchi	16ebc50481	Fix #2326 - Redirect to localhost when on 0.0.0.0 (#2328 ) * Fix #2326 - Redirect to localhost when on 0.0.0.0	2025-04-14 15:55:10 +02:00
Dan Yeaw	b911ea99fb	Add media module tests (#2306 ) * Add media Python tests * Add media js test * Remove try except blocks * Make Python tests more end-to-end * Add media Python tests * Add media js test * Remove try except blocks * Make Python tests more end-to-end * MicroPython explorations. * Fix websocket tests, so they just skip. * Fix MicroPython media tests, if no permission is given for a video device. --------- Co-authored-by: Nicholas H.Tollervey <ntoll@ntoll.org> Co-authored-by: Andrea Giammarchi <andrea.giammarchi@gmail.com>	2025-03-20 14:35:01 +01:00
Dan Yeaw	46ca9154c4	Add conda as a make setup option (#2305 ) Co-authored-by: Andrea Giammarchi <andrea.giammarchi@gmail.com>	2025-03-20 12:10:31 +01:00
Andrea Giammarchi	afd7a8eb00	Updated Pyodide to v0.27.4 (#2318 )	2025-03-19 15:00:20 +01:00
Andrea Giammarchi	b22f384d73	PyGame - TOML + JSON absolute URL + input patch (#2313 ) * Make config URL canonical * Better baseURL + input patch	2025-03-11 11:32:30 +01:00
Andrea Giammarchi	caeab77a8e	Fix #2304 - Make pyimport work as expected (#2311 ) * Fix #2304 - Make pyimport work as expected * [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --------- Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>	2025-03-10 16:28:42 +01:00
Andrea Giammarchi	f2bbc6ed5f	Fix #2309 - Use all config options (#2310 ) * Fix #2309 - Use all config options * dropped websocket test as it takes forever even locally	2025-03-10 15:57:12 +01:00
Andrea Giammarchi	1d666b92a2	Dispatch `py-game` event right before executing code (#2287 ) deal, thanks 🙏	2025-02-27 12:39:58 +01:00
Andrea Giammarchi	290eb03388	Fix #2302 - Updated Polyscript to its latest (#2303 ) * Fix #2302 - Updated Polyscript to its latest	2025-02-27 11:09:46 +01:00
Nicholas Tollervey	55031f2347	Update README to include acknowledgement of Anaconda's role in the project. (#2297 )	2025-02-26 16:50:51 +00:00
Andrea Giammarchi	8168383653	Updated Pyodide to v0.27.3 (#2300 ) This has been published on npm as `https://cdn.jsdelivr.net/npm/@pyscript/core@0.6.33/dist/core.js` and `https://cdn.jsdelivr.net/npm/@pyscript/core@0.6.33/dist/core.css`	2025-02-26 15:06:17 +01:00
Andrea Giammarchi	3ff2c171bc	PyEditor kill switch (#2295 )	2025-02-26 14:39:17 +01:00
Andrea Giammarchi	edbac13713	Splitting integration tests (#2296 )	2025-02-20 15:16:36 +01:00
Christian Clauss	46239caa19	Re ruff (#2292 ) * Ruff fixes * Ruff fixes * from __future__ import annotations breaks MicroPython * noqa: FURB188 because there is no str.replacesuffix() in MicroPython * Add ruff to pre-commit	2025-02-20 09:43:09 +01:00
Andrea Giammarchi	0366e48fad	Introducing pyscript.fs namespace/module (#2289 ) * introducing pyscript.fs namespace/module * Added proper rejection when showDirectoryPicker is not supported * Improved exports to make explicit import in 3rd party modules easier * implemented `fs.unmount(path)`: * verified that RAM gets freed * allowed to mount different handlers within the same path through different `id` as that's the Web best way to do so	2025-02-17 14:45:43 +01:00