UI creation API (#1960)

* add JSProperty to pydom so it can be used to create descriptors mapping to specific JS attributes

* add pyweb.ui

* fix pyweb imports

* fix link and a elements and add a script element

* fix imports and add initialization to load resources to shoelace module

* new pyweb.ui test folder

* remove comments

* add Icon to shoelace components

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* use html property rather than accessing _js directly

* add markdown suppport

* move examples section out of stdlib pyweb to examples.py in the demo itself

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* simplify demo code

* improve docstrings

* precommit fixes

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* simplify code for main page

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* add load_resources to markdown

* add showlace extra style dynamically

* precommit

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* add gallery files

* add global attributes and dynamic property assignment

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Add shoelace radio component (#1961)

* add shoelace radio component

* [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>

* fix type that lead using the the JSDescriptor directly instead of the factory method

* add missing marked dependency

* refactor gallary to simplify codebase

* precommig lint

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* add text attribute to pydom Elements

* add global JS attributes to elements and improve demos

* lint

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* fix image instantiation on card since the API has changed

* add attributes to all classes in elements

* lint

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* change example creation functions to take the label and the object directly

* fix input name clashing with input keyword

* refactor examples to better simplify and automate

* fix div clashing names

* fix demo left menu width

* simplify base elements demo by moving all the examples to the examples module

* rename Grid to grid to align to other elements

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* reorg classes order in elements.py and add missing elements to examples

* fix issue related to now importing div from pyweb.ui

* improve demo

* link and fix spelling typo

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Add a bunch more elements (#1966)

* Add copy button

* Add skeleton and spinner

* Add Switch

* Add text area

* Add more elements

* More styling to each component

* [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>
Co-authored-by: Fabio Pliger <fpliger@users.noreply.github.com>

* Add radio group (#1963)

* add radio group

* [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>
Co-authored-by: Fabio Pliger <fpliger@users.noreply.github.com>

* Small tweaks to main demo page (#1962)

* Small tweaks to main demo page

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* [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>
Co-authored-by: Fabio Pliger <fpliger@users.noreply.github.com>

* fix post merge issues

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* fixed issues with renaming Grid to grid, after we merged

* lint

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* add multple HTML elements in alphabetical order from abbr to em

* fix attributes of some of the elements added in the previous commit and add embed

* fix embed attributes and add fieldset

* add figcation, figure and form. Also fix ordering of definitoin of img and input_

* add style and lint

* wrap up adding all major html elements

* fix test failing due to different error message from fake server compared to a real test server

* change default docstring associated with all classes dynamically patched

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* lint

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* add pyweb tests

* lint

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* add global attributes and change abbr test

* fix abbr to inherit from TextElementBase

* add address test and improve error messaging when ElementBase gets a bad input as style

* change test helper function to be more  flexible on attributes and manage content vs non content based elements. Also adds area tests

* add test for more elements up to caption

* fix canvas and caption as elements that have content and fix name typo on figcaption

* fix another typo on figcaption

* minor fixes and complete tests for all elements

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* adapt shoelace to latest upates in ui.elements

* fix issue with example code not showing created button

* move global attributes to base class

* replace all the calls to _add_js_properties with defining attributes directly in the classes

* finish moving all properties manually on each class

* remove _add_js_properties

* replace JSProperty with js_property

* replace JSProperty with js_property

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* fixed merge conflicts

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* remove js_property and just use JSProperty with name and allow_nones as arguments

* fix bug around Element not being able to map global attributes in subclasses

* remove js_property and fix references

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* precommit

* precommit again

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* lint

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* enable pyweb on micropython

* switch examples to micropython

* fix pydom issue with micropython, created by the monkeypatch around JsProxy

* print micropython version on micropython pydom example

* lint and remove of textwrap in stdlib for micropython compatibility

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* added msising attributes on the option Element. Tests are all passing now

* fix tests

* lint

* temp ugly fix for micropython, using the when decorator with a function without arguments

* small fixes and improvements to examples

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* fix examples and broken link from the removal of markdown and shoelace from stdlib

* lint

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* dynamically change the server address in tests

* use the right element in test_a

* lint

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* skipping test_audio in CI due to different behavior of fake_server vs a real server, that runs in local tests

* add conditional expected_missing_file_errors property to manage different behaviour between local tests and CI (due to fake_server)

* lint

* [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>
Co-authored-by: Askat <aaskat@users.noreply.github.com>
Co-authored-by: Fábio Rosado <hello@fabiorosado.dev>
Co-authored-by: Andrea Giammarchi <andrea.giammarchi@gmail.com>

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -2,62 +2,64 @@ name: Bug Report
 description: Create a report to help us improve
 labels: ["type: bug", "needs-triage"]
 body:
--   type: markdown
+  - type: markdown
     attributes:
-        value: |
-            Thanks for helping PyScript! 🐍
+      value: |
+        Thanks for helping PyScript! 🐍
 
-            Going through bugs and issues takes up a lot of time, so please be so kind and take a few minutes to fill out all the areas to the best of your ability.
+        Going through bugs and issues takes up a lot of time, so please be so kind and take a few minutes to fill out all the areas to the best of your ability.
 
-            There will always be more issues than there is time to do them, and so we will need to selectively close issues that don't provide enough information, so we can focus our time on helping people like you who fill out the issue form completely. Thank you for your collaboration!
+        There will always be more issues than there is time to do them, and so we will need to selectively close issues that don't provide enough information, so we can focus our time on helping people like you who fill out the issue form completely. Thank you for your collaboration!
 
-            There are also already a lot of open issues, so please take 2 minutes and search through existing ones to see if what you are experiencing already exists
+        There are also already a lot of open issues, so please take 2 minutes and search through existing ones to see if what you are experiencing already exists.
 
-            Thanks for helping PyScript be amazing. We are nothing without people like you helping build a better community 💐!
--   type: checkboxes
+        Finally, if you are opening **a bug report related to PyScript.com** please [use this repository instead](https://github.com/anaconda/pyscript-dot-com-issues/issues/new/choose).
+
+        Thanks for helping PyScript be amazing. We are nothing without people like you helping build a better community 💐!
+  - type: checkboxes
     id: checks
     attributes:
-        label: Checklist
-        description: Please confirm and check all the following options.
-        options:
-        -   label: I added a descriptive title
-            required: true
-        -   label: I searched for other issues and couldn't find a solution or duplication
-            required: true
-        -   label: I already searched in Google and didn't find any good information or help
-            required: true
--   type: textarea
+      label: Checklist
+      description: Please confirm and check all the following options.
+      options:
+        - label: I added a descriptive title
+          required: true
+        - label: I searched for other issues and couldn't find a solution or duplication
+          required: true
+        - label: I already searched in Google and didn't find any good information or help
+          required: true
+  - type: textarea
     id: what-happened
     attributes:
-        label: What happened?
-        description: And what should have happened instead? This really helps everyone review quicker and greatly increases the chance that someone can get around to solve your issue
-        placeholder: Tell us what you see!
+      label: What happened?
+      description: And what should have happened instead? This really helps everyone review quicker and greatly increases the chance that someone can get around to solve your issue
+      placeholder: Tell us what you see!
     validations:
-        required: true
--   type: dropdown
+      required: true
+  - type: dropdown
     id: browsers
     attributes:
-        label: What browsers are you seeing the problem on? (if applicable)
-        multiple: true
-        options:
-        -   Firefox
-        -   Chrome
-        -   Safari
-        -   Microsoft Edge
-        -   Other
+      label: What browsers are you seeing the problem on? (if applicable)
+      multiple: true
+      options:
+        - Firefox
+        - Chrome
+        - Safari
+        - Microsoft Edge
+        - Other
     validations:
-        required: false
--   type: textarea
+      required: false
+  - type: textarea
     id: list
     attributes:
-        label: Console info
-        description: |
-            If there are errors in your browser console then its helpful to be able to troubleshoot.
-            - Chrome , Firefox, and Edge: Right-click on the page and select *Inspect*. Alternatively  you can press F12 on your keyboard.
-            - Safari: Find instructions [here](https://support.apple.com/guide/safari/use-the-developer-tools-in-the-develop-menu-sfri20948/mac).
-        render: shell
--   type: textarea
+      label: Console info
+      description: |
+        If there are errors in your browser console then its helpful to be able to troubleshoot.
+        - Chrome , Firefox, and Edge: Right-click on the page and select *Inspect*. Alternatively  you can press F12 on your keyboard.
+        - Safari: Find instructions [here](https://support.apple.com/guide/safari/use-the-developer-tools-in-the-develop-menu-sfri20948/mac).
+      render: shell
+  - type: textarea
     id: context
     attributes:
-        label: Additional Context
-        description: Add any additional context information or screenshots you think are useful.
+      label: Additional Context
+      description: Add any additional context information or screenshots you think are useful.

.github/ISSUE_TEMPLATE/config.yml

@@ -1,5 +1,8 @@
-blank_issues_enabled: false
+blank_issues_enabled: true
 contact_links:
--   name: Question
-    url: https://community.anaconda.cloud/c/tech-topics/pyscript
+  - name: Feature Proposals
+    url: https://github.com/pyscript/pyscript/discussions/new?category=proposals
+    about: Create a feature request to make PyScript even better
+  - name: Questions
+    url: https://github.com/pyscript/pyscript/discussions/new?category=q-a
     about: For questions or discussions about pyscript

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -1,67 +0,0 @@
-name: Feature Request
-description: Create a feature request to make PyScript even better
-labels: ["type: enhancement", "needs-triage"]
-body:
--   type: markdown
-    attributes:
-        value: |
-            ### Thanks for helping PyScript! 🐍
-
-            Going through feature requests and issues takes up a lot of time, so please be so kind and take a few minutes to fill out all the areas to the best of your ability.
-
-            There will always be more great ideas than there is time to do them, and so we will need to selectively close issues that don't provide enough information, so everyone can focus our time on helping people like you who fill out the form completely. Thank you for your collaboration!
-
-            There are also already a lot of open requests, so please take 2 minutes and search through existing ones to see if your idea already exists. If you find something close, please upvote that request and comment.
-
-            Thanks for helping PyScript be amazing. We are nothing without people like you helping build a better community 💐!
-
-            ### Lets make sure you are in the right place. If you have an idea/request for:
-
-            - #### A specific package/library (such as pandas or scikit learn):
-
-              Search for that respective library on github repo or website. You will have much more success there.
-
-            - #### A general Python question/feature request:
-
-              Try out a forum post [here](https://discuss.python.org/c/users/7)
-
--   type: checkboxes
-    id: checks
-    attributes:
-        label: Checklist
-        description: Please confirm and check all the following options
-        options:
-        -   label: I added a descriptive title
-            required: true
-        -   label: I searched for other feature requests and couldn't find a duplicate (including also the ``type-feature`` tag)
-            required: true
-        -   label: I confirmed that it's not related to another project are area (see the above section)
-            required: true
--   type: textarea
-    id: request-idea
-    attributes:
-        label: What is the idea?
-        description: Describe what the feature is and the desired state
-        placeholder: This feature would allow any user of PyScript to type in a simple command in the console and show all variables currently in use
-    validations:
-        required: true
--   type: textarea
-    id: why
-    attributes:
-        label: Why is this needed
-        description: |
-            Who would benefit from this and why would this add value to them? What problem does this solve?
-        placeholder: This would benefit users who would like to see what is being used so they can learn and debug faster
--   type: textarea
-    id: what
-    attributes:
-        label: What should happen?
-        description: |
-            What should be the user experience with the feature? Describe from a user perpective what they would do and see
-        placeholder: A user would type in ``PyScript debug`` in the browser console and see a list of all variables created.
--   type: textarea
-    id: context
-    attributes:
-        label: Additional Context
-        description: |
-            Is there any other information that you think would be valuable for the team to know?

.github/ISSUE_TEMPLATE/misc.yml

@@ -1,37 +0,0 @@
-name: Miscellaneous
-description: For issues that don't belong in other categories
-labels: ["type: misc", "needs-triage"]
-body:
--   type: markdown
-    attributes:
-        value: |
-            Thanks for helping PyScript! 🐍
-
-            This issue is for things that doesn't make sense to put into the other issue categories and we don't want it to get lost.
-
-            Going through issues takes up a lot of time, so please be so kind and take a few minutes to fill out all the areas to the best of your ability.
-
-            There will always be more issues than there is time to do them, and so we will need to selectively close issues that don't provide enough information, so we can focus our time on helping people like you who fill out the issue form completely. Thank you for your collaboration!
-
-            There are also already a lot of open issues, so please take 2 minutes and search through existing ones to see if what you are experiencing already exists
-
-            Thanks for helping PyScript be amazing. We are nothing without people like you helping build a better community 💐!
--   type: checkboxes
-    id: checks
-    attributes:
-        label: Checklist
-        description: Please confirm and check all the following options.
-        options:
-        -   label: I added a descriptive title
-            required: true
-        -   label: I searched for other issues and couldn't find a duplication
-            required: true
-        -   label: I already searched in Google and didn't find any good information or help
-            required: true
--   type: textarea
-    id: what
-    attributes:
-        label: What is the issue/comment/problem?
-        description: This is a miscellaneous issue so this could be just about anything. We simply ask that you provide as many details as you can to help spur discussion or the outcome you want.
-    validations:
-        required: true

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,15 @@
+## Description
+
+<!--Please describe the changes in your pull request in few words here. -->
+
+## Changes
+
+<!-- List the changes done to fix a bug or introduce a new feature.Please note both user-facing changes and changes to internal API's here -->
+
+## Checklist
+
+<!-- Note: Only user-facing changes require a changelog entry. Internal-only API changes do not require a changelog entry. Changes in documentation do not require a changelog entry. -->
+
+-   [ ] All tests pass locally
+-   [ ] I have updated `CHANGELOG.md`
+-   [ ] I have created documentation for this(if applicable)

.github/dashboard.yaml

@@ -1,18 +0,0 @@
-name: Push issue to Github Project dashboard
-
-on:
-    issues:
-        types:
-        -   opened
-    pull_request_target:
-        types:
-        -   opened
-
-jobs:
-    add_to_project:
-        runs-on: ubuntu-latest
-        steps:
-        -   uses: actions/add-to-project@v0.0.3
-            with:
-                project-url: https://github.com/orgs/pyscript/projects/4/
-                github-token: ${{ secrets.PROJECT_TOKEN }}

.github/dependabot.yml

@@ -0,0 +1,13 @@
+# Keep GitHub Actions up to date with GitHub's Dependabot...
+# https://docs.github.com/en/code-security/dependabot/working-with-dependabot/keeping-your-actions-up-to-date-with-dependabot
+# https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file#package-ecosystem
+version: 2
+updates:
+    - package-ecosystem: github-actions
+      directory: /
+      groups:
+          github-actions:
+              patterns:
+                  - "*" # Group all Actions updates into a single larger pull request
+      schedule:
+          interval: weekly

.github/release.yml

@@ -1,5 +1,5 @@
 changelog:
     categories:
-    -   title: New Features
-    -   title: Breaking Changes
-    -   title: Known Issues
+        - title: New Features
+        - title: Breaking Changes
+        - title: Known Issues

.github/workflows/build-latest.yml

@@ -1,74 +0,0 @@
-name: '[CI] Build Latest'
-
-on:
-    push: # Only run on merges into main that modify files under pyscriptjs/
-        branches:
-        -   main
-        paths:
-        -   pyscriptjs/**
-        -   .github/workflows/build-latest.yml # Test that workflow works when changed
-
-    pull_request: # Run on any PR that modifies files in pyscriptjs/
-        branches:
-        -   main
-        paths:
-        -   pyscriptjs/**
-        -   .github/workflows/build-latest.yml # Test that workflow works when changed
-
-env:
-    MINICONDA_PYTHON_VERSION: py38
-    MINICONDA_VERSION: 4.11.0
-
-defaults:
-    run:
-        working-directory: pyscriptjs
-
-jobs:
-    build:
-        runs-on: ubuntu-latest
-        permissions:
-            contents: read
-            id-token: write
-        steps:
-
-        -   name: Checkout
-            uses: actions/checkout@v3
-
-        -   name: Install node
-            uses: actions/setup-node@v3
-            with:
-                node-version: 18.x
-
-        -   name: Cache node modules
-            uses: actions/cache@v3
-            env:
-                cache-name: cache-node-modules
-            with:
-              # npm cache files are stored in `~/.npm` on Linux/macOS
-                path: ~/.npm
-                key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
-                restore-keys: |
-                    ${{ runner.os }}-build-${{ env.cache-name }}-
-                    ${{ runner.os }}-build-
-                    ${{ runner.os }}-
-
-        -   name: setup Miniconda
-            uses: conda-incubator/setup-miniconda@v2
-
-        -   name: Setup Environment
-            run: make setup
-
-        -   name: Build and Test
-            run: make test
-
-        # Deploy to S3
-        -   name: Configure AWS credentials
-            if: github.ref == 'refs/heads/main' # Only deploy on merge into main
-            uses: aws-actions/configure-aws-credentials@v1.6.1
-            with:
-                aws-region: ${{secrets.AWS_REGION}}
-                role-to-assume: ${{ secrets.AWS_OIDC_RUNNER_ROLE }}
-
-        -   name: Sync to S3
-            if: github.ref == 'refs/heads/main'
-            run: aws s3 sync --quiet ./examples/build/ s3://pyscript.net/latest/

.github/workflows/build-release.yml

@@ -1,56 +0,0 @@
-name: '[CI] Build Release'
-
-on:
-    push:
-        tags:
-        -   '[0-9][0-9][0-9][0-9].[0-9][0-9].[0-9]+'  # YYYY.MM.MICRO
-
-env:
-    MINICONDA_PYTHON_VERSION: py38
-    MINICONDA_VERSION: 4.11.0
-
-defaults:
-    run:
-        working-directory: pyscriptjs
-
-jobs:
-    build:
-        runs-on: ubuntu-latest
-        steps:
-
-        -   name: Checkout
-            uses: actions/checkout@v3
-
-        -   name: Install node
-            uses: actions/setup-node@v3
-            with:
-                node-version: 18.x
-
-        -   name: Cache node modules
-            uses: actions/cache@v3
-            env:
-                cache-name: cache-node-modules
-            with:
-              # npm cache files are stored in `~/.npm` on Linux/macOS
-                path: ~/.npm
-                key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
-                restore-keys: |
-                    ${{ runner.os }}-build-${{ env.cache-name }}-
-                    ${{ runner.os }}-build-
-                    ${{ runner.os }}-
-
-        -   name: setup Miniconda
-            uses: conda-incubator/setup-miniconda@v2
-
-        -   name: Setup Environment
-            run: make setup
-
-        -   name: Build and Test
-            run: make test
-
-        -   name: Prepare Release
-            uses: softprops/action-gh-release@v1
-            with:
-                draft: true
-                prerelease: true
-                generate_release_notes: true

.github/workflows/docs-latest.yml

@@ -1,60 +0,0 @@
-name: '[Docs] Build Latest'
-
-on:
-    push:
-        branches:
-        -   main
-        paths:
-        -   docs/**
-
-jobs:
-    build:
-        runs-on: ubuntu-latest
-        permissions:
-            contents: read
-            id-token: write
-        env:
-            SPHINX_HTML_BASE_URL: https://docs.pyscript.net/
-        steps:
-
-        -   name: Checkout
-            uses: actions/checkout@v3
-            with:
-                persist-credentials: false # otherwise, the token used is the GITHUB_TOKEN, instead of your personal access token.
-                fetch-depth: 0 # otherwise, there would be errors pushing refs to the destination repository.
-
-        -   name: Setup
-            uses: conda-incubator/setup-miniconda@v2
-            with:
-                auto-update-conda: true
-                activate-environment: docs
-                environment-file: docs/environment.yml
-                python-version: '3.9'
-
-        -   name: Build
-            shell: bash -l {0}
-            run: |
-                cd docs/
-                make html
-
-        -   name: Upload artifacts
-            uses: actions/upload-artifact@v3
-            with:
-                name: pyscript-docs-latest
-                path: docs/_build/html/
-
-        # Deploy to S3
-        -   name: Configure AWS credentials
-            uses: aws-actions/configure-aws-credentials@v1.6.1
-            with:
-                aws-region: ${{secrets.AWS_REGION}}
-                role-to-assume: ${{ secrets.AWS_OIDC_RUNNER_ROLE }}
-
-        -   name: Copy redirect file
-            run: aws s3 cp --quiet ./docs/_build/html/_static/redirect.html s3://docs.pyscript.net/index.html
-
-        # -   name: Delete latest directory
-        #     run: aws s3 rm --recursive s3://docs.pyscript.net/latest/
-
-        -   name: Sync to S3
-            run: aws s3 sync --quiet ./docs/_build/html/ s3://docs.pyscript.net/latest/

.github/workflows/docs-release.yml

@@ -1,57 +0,0 @@
-name: '[Docs] Build Release'
-
-on:
-    release:
-        types: [published]
-
-jobs:
-    build:
-        runs-on: ubuntu-latest
-        permissions:
-            contents: read
-            id-token: write
-        env:
-            SPHINX_HTML_BASE_URL: https://docs.pyscript.net/
-        steps:
-
-        -   name: Checkout
-            uses: actions/checkout@v3
-            with:
-                persist-credentials: false # otherwise, the token used is the GITHUB_TOKEN, instead of your personal access token.
-                fetch-depth: 0 # otherwise, there would be errors pushing refs to the destination repository.
-
-        -   name: Setup
-            uses: conda-incubator/setup-miniconda@v2
-            with:
-                auto-update-conda: true
-                activate-environment: docs
-                environment-file: docs/environment.yml
-                python-version: '3.9'
-
-        -   name: Build
-            shell: bash -l {0}
-            run: |
-                cd docs/
-                make html
-
-        -   name: Upload artifacts
-            uses: actions/upload-artifact@v3
-            with:
-                name: pyscript-docs-${{ github.ref_name }}
-                path: docs/_build/html/
-
-        # Deploy to S3
-        -   name: Configure AWS credentials
-            uses: aws-actions/configure-aws-credentials@v1.6.1
-            with:
-                aws-region: ${{secrets.AWS_REGION}}
-                role-to-assume: ${{ secrets.AWS_OIDC_RUNNER_ROLE }}
-
-        -   name: Copy redirect file
-            run: aws s3 cp --quiet ./docs/_build/html/_static/redirect.html s3://docs.pyscript.net/index.html
-
-        # -   name: Delete release directory
-        #     run: aws s3 rm --recursive s3://docs.pyscript.net/${{ github.ref_name }}/
-
-        -   name: Sync to S3
-            run: aws s3 sync --quiet ./docs/_build/html/ s3://docs.pyscript.net/${{ github.ref_name }}/

.github/workflows/docs-review.yml

@@ -1,78 +0,0 @@
-name: '[Docs] Build Review'
-
-on:
-    pull_request:
-        branches:
-        -   '*'
-        paths:
-        -   docs/**
-
-concurrency:
-  # Concurrency group that uses the workflow name and PR number if available
-  # or commit SHA as a fallback. If a new build is triggered under that
-  # concurrency group while a previous build is running it will be canceled.
-  # Repeated pushes to a PR will cancel all previous builds, while multiple
-  # merges to main will not cancel.
-    group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.sha }}
-    cancel-in-progress: true
-
-jobs:
-    build:
-        if: >-
-            !github.event.repository.fork
-        runs-on: ubuntu-latest
-        permissions:
-            contents: read
-            id-token: write
-        env:
-            SPHINX_HTML_BASE_URL: https://docs.pyscript.net/
-        steps:
-
-        -   name: Checkout
-            uses: actions/checkout@v3
-            with:
-                persist-credentials: false # otherwise, the token used is the GITHUB_TOKEN, instead of your personal access token.
-                fetch-depth: 0 # otherwise, there would be errors pushing refs to the destination repository.
-
-        -   name: Setup
-            uses: conda-incubator/setup-miniconda@v2
-            with:
-                auto-update-conda: true
-                activate-environment: docs
-                environment-file: docs/environment.yml
-                python-version: '3.9'
-
-        -   name: Build
-            shell: bash -l {0}
-            run: |
-                cd docs/
-                make html
-
-        -   name: Upload artifacts
-            uses: actions/upload-artifact@v3
-            with:
-                name: pyscript-docs-review-${{ github.event.number }}
-                path: docs/_build/html/
-
-        # Deploy to S3
-        -   name: Configure AWS credentials
-            uses: aws-actions/configure-aws-credentials@v1.6.1
-            with:
-                aws-region: ${{secrets.AWS_REGION}}
-                role-to-assume: ${{ secrets.AWS_OIDC_RUNNER_ROLE }}
-
-        -   name: Copy redirect file
-            run: aws s3 cp --quiet ./docs/_build/html/_static/redirect.html s3://docs.pyscript.net/index.html
-
-        # -   name: Delete review directory
-        #     run: aws s3 rm --recursive s3://docs.pyscript.net/review/${{ github.event.number }}/
-
-        -   name: Sync to S3
-            run: aws s3 sync --quiet ./docs/_build/html/ s3://docs.pyscript.net/review/${{ github.event.number }}/
-
-        -   name: Adding step summary
-            run: |
-                echo "### Review documentation" >> $GITHUB_STEP_SUMMARY
-                echo "As with any pull request, you can find the rendered documentation version for pull request ${{ github.event.number }} here:"
-                echo "" >> $GITHUB_STEP_SUMMARY # this is a blank line
-                echo "https://docs.pyscript.net/review/${{ github.event.number }}/" >> $GITHUB_STEP_SUMMARY

.github/workflows/prepare-release.yml

@@ -0,0 +1,56 @@
+name: "Prepare Release"
+
+on:
+    push:
+        tags:
+            - "[0-9][0-9][0-9][0-9].[0-9][0-9].[0-9]+" # YYYY.MM.MICRO
+
+defaults:
+    run:
+        working-directory: ./pyscript.core
+
+jobs:
+    prepare-release:
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+
+            - name: Install node
+              uses: actions/setup-node@v4
+              with:
+                  node-version: 18.x
+
+            - name: Cache node modules
+              uses: actions/cache@v4
+              env:
+                  cache-name: cache-node-modules
+              with:
+                  # npm cache files are stored in `~/.npm` on Linux/macOS
+                  path: ~/.npm
+                  key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
+                  restore-keys: |
+                      ${{ runner.os }}-build-${{ env.cache-name }}-
+                      ${{ runner.os }}-build-
+                      ${{ runner.os }}-
+
+            - name: NPM Install
+              run: npm install && npx playwright install
+
+            - name: Build
+              run: npm run build
+
+            - name: Generate index.html
+              working-directory: .
+              run: sed 's#_PATH_#./#' ./public/index.html > ./pyscript.core/dist/index.html
+
+            - name: Zip dist folder
+              run: zip -r -q ./build.zip ./dist
+
+            - name: Prepare Release
+              uses: softprops/action-gh-release@v2
+              with:
+                  draft: true
+                  prerelease: true
+                  generate_release_notes: true
+                  files: ./build.zip

.github/workflows/publish-release.yml

@@ -1,61 +1,63 @@
-name: '[CI] Publish Release'
+name: "Publish Release"
 
 on:
     release:
         types: [published]
 
-env:
-    MINICONDA_PYTHON_VERSION: py38
-    MINICONDA_VERSION: 4.11.0
-
 defaults:
     run:
-        working-directory: pyscriptjs
+        working-directory: ./pyscript.core
 
 jobs:
-    build:
+    publish-release:
         runs-on: ubuntu-latest
         permissions:
-            contents: read
             id-token: write
+            contents: read
         steps:
-        -   name: Checkout
-            uses: actions/checkout@v3
+            - name: Checkout
+              uses: actions/checkout@v4
 
-        -   name: Install node
-            uses: actions/setup-node@v3
-            with:
-                node-version: 18.x
+            - name: Install node
+              uses: actions/setup-node@v4
+              with:
+                  node-version: 18.x
 
-        -   name: Cache node modules
-            uses: actions/cache@v3
-            env:
-                cache-name: cache-node-modules
-            with:
-              # npm cache files are stored in `~/.npm` on Linux/macOS
-                path: ~/.npm
-                key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
-                restore-keys: |
-                    ${{ runner.os }}-build-${{ env.cache-name }}-
-                    ${{ runner.os }}-build-
-                    ${{ runner.os }}-
+            - name: Cache node modules
+              uses: actions/cache@v4
+              env:
+                  cache-name: cache-node-modules
+              with:
+                  # npm cache files are stored in `~/.npm` on Linux/macOS
+                  path: ~/.npm
+                  key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
+                  restore-keys: |
+                      ${{ runner.os }}-build-${{ env.cache-name }}-
+                      ${{ runner.os }}-build-
+                      ${{ runner.os }}-
 
-        -   name: setup Miniconda
-            uses: conda-incubator/setup-miniconda@v2
+            - name: npm install
+              run: npm install && npx playwright install
 
-        -   name: Setup Environment
-            run: make setup
+            - name: build
+              run: npm run build
 
-        -   name: Build and Test
-            run: make test
+            - name: Generate index.html in snapshot
+              working-directory: .
+              run: sed 's#_PATH_#https://pyscript.net/releases/${{ github.ref_name }}/#' ./public/index.html > ./pyscript.core/dist/index.html
 
-        # Upload to S3
-        -   name: Configure AWS credentials
-            uses: aws-actions/configure-aws-credentials@v1.6.1
-            with:
-                aws-region: ${{secrets.AWS_REGION}}
-                role-to-assume: ${{ secrets.AWS_OIDC_RUNNER_ROLE }}
+            - name: Generate release.tar from snapshot and put it in dist/
+              working-directory: .
+              run: tar -cvf ../release.tar * && mv ../release.tar .
 
-        -   name: Sync to S3
-            run: | # Overwrite "latest" alpha + versioned subdirectory
-                aws s3 sync --quiet ./examples/build/ s3://pyscript.net/releases/${{ github.ref_name }}
+            - name: Configure AWS credentials
+              uses: aws-actions/configure-aws-credentials@v4
+              with:
+                  aws-region: ${{ secrets.AWS_REGION }}
+                  role-to-assume: ${{ secrets.AWS_OIDC_RUNNER_ROLE }}
+
+            - name: Sync to S3
+              run:
+                  | # Update /latest and create an explicitly versioned directory under releases/YYYY.MM.MICRO/
+                  aws s3 sync --quiet ./dist/ s3://pyscript.net/latest/
+                  aws s3 sync --quiet ./dist/ s3://pyscript.net/releases/${{ github.ref_name }}/

.github/workflows/publish-snapshot.yml

@@ -0,0 +1,61 @@
+name: "Publish Snapshot"
+
+on:
+    workflow_dispatch:
+        inputs:
+            snapshot_version:
+                description: "The calver version of this snapshot: 2022.09.1 or 2022.09.1.RC1"
+                type: string
+                required: true
+
+defaults:
+    run:
+        working-directory: ./pyscript.core
+
+jobs:
+    publish-snapshot:
+        runs-on: ubuntu-latest
+        permissions:
+            contents: read
+            id-token: write
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+
+            - name: Install node
+              uses: actions/setup-node@v4
+              with:
+                  node-version: 18.x
+
+            - name: Cache node modules
+              uses: actions/cache@v4
+              env:
+                  cache-name: cache-node-modules
+              with:
+                  # npm cache files are stored in `~/.npm` on Linux/macOS
+                  path: ~/.npm
+                  key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
+                  restore-keys: |
+                      ${{ runner.os }}-build-${{ env.cache-name }}-
+                      ${{ runner.os }}-build-
+                      ${{ runner.os }}-
+
+            - name: Install Dependencies
+              run: npm install && npx playwright install
+
+            - name: Build Pyscript.core
+              run: npm run build
+
+            - name: Configure AWS credentials
+              uses: aws-actions/configure-aws-credentials@v4
+              with:
+                  aws-region: ${{ secrets.AWS_REGION }}
+                  role-to-assume: ${{ secrets.AWS_OIDC_RUNNER_ROLE }}
+
+            - name: Generate index.html in snapshot
+              working-directory: .
+              run: sed 's#_PATH_#https://pyscript.net/snapshots/${{ inputs.snapshot_version }}/#' ./public/index.html > ./pyscript.core/dist/index.html
+
+            - name: Copy to Snapshot
+              run: >
+                  aws s3 sync ./dist/ s3://pyscript.net/snapshots/${{ inputs.snapshot_version }}/

.github/workflows/publish-unstable.yml

@@ -0,0 +1,61 @@
+name: "Publish Unstable"
+
+on:
+    push: # Only run on merges into main that modify files under pyscript.core/ and examples/
+        branches:
+            - main
+        paths:
+            - pyscript.core/**
+            - examples/**
+
+    workflow_dispatch:
+
+jobs:
+    publish-unstable:
+        runs-on: ubuntu-latest
+        permissions:
+            id-token: write
+            contents: read
+        defaults:
+            run:
+                working-directory: ./pyscript.core
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+
+            - name: Install node
+              uses: actions/setup-node@v4
+              with:
+                  node-version: 18.x
+
+            - name: Cache node modules
+              uses: actions/cache@v4
+              env:
+                  cache-name: cache-node-modules
+              with:
+                  # npm cache files are stored in `~/.npm` on Linux/macOS
+                  path: ~/.npm
+                  key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
+                  restore-keys: |
+                      ${{ runner.os }}-build-${{ env.cache-name }}-
+                      ${{ runner.os }}-build-
+                      ${{ runner.os }}-
+
+            - name: NPM Install
+              run: npm install && npx playwright install
+
+            - name: Build
+              run: npm run build
+
+            - name: Generate index.html in snapshot
+              working-directory: .
+              run: sed 's#_PATH_#https://pyscript.net/unstable/#' ./public/index.html > ./pyscript.core/dist/index.html
+
+            - name: Configure AWS credentials
+              uses: aws-actions/configure-aws-credentials@v4
+              with:
+                  aws-region: ${{ secrets.AWS_REGION }}
+                  role-to-assume: ${{ secrets.AWS_OIDC_RUNNER_ROLE }}
+
+            - name: Sync to S3
+              run: aws s3 sync --quiet ./dist/ s3://pyscript.net/unstable/

.github/workflows/sync-examples.yml

@@ -1,33 +0,0 @@
-name: '[CI] Sync Examples'
-
-on:
-    push: # Only run on merges into main that modify files under examples/
-        branches:
-        -   main
-        paths:
-        -   examples/**
-        -   .github/workflows/sync-examples.yml # Test that workflow works when changed
-
-jobs:
-    build:
-        runs-on: ubuntu-latest
-        permissions:
-            contents: read
-            id-token: write
-        defaults:
-            run:
-                working-directory: examples
-
-        steps:
-
-        # Deploy to S3
-        -   name: Checkout
-            uses: actions/checkout@v3
-        -   name: Configure AWS credentials
-            uses: aws-actions/configure-aws-credentials@v1.6.1
-            with:
-                aws-region: ${{secrets.AWS_REGION}}
-                role-to-assume: ${{ secrets.AWS_OIDC_RUNNER_ROLE }}
-        -   name: Sync to S3
-            # Sync outdated or new files, delete ones no longer in source
-            run: aws s3 sync --quiet --delete . s3://pyscript.net/examples/ # Sync directory, delete what is not in source

.github/workflows/test.yml

@@ -0,0 +1,92 @@
+name: "[CI] Test"
+
+on:
+    push: # Only run on merges into main that modify certain files
+        branches:
+            - main
+        paths:
+            - pyscript.core/**
+            - .github/workflows/test.yml
+
+    pull_request: # Only run on merges into main that modify certain files
+        branches:
+            - main
+        paths:
+            - pyscript.core/**
+            - .github/workflows/test.yml
+    workflow_dispatch:
+
+jobs:
+    BuildAndTest:
+        runs-on: ubuntu-latest-8core
+        env:
+            MINICONDA_PYTHON_VERSION: py38
+            MINICONDA_VERSION: 4.11.0
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+              with:
+                  fetch-depth: 3
+
+            # display a git log: when you run CI on PRs, github automatically
+            # merges the PR into main and run the CI on that commit. The idea
+            # here is to show enough of git log to understand what is the
+            # actual commit (in the PR) that we are using. See also
+            # 'fetch-depth: 3' above.
+            - name: git log
+              run: git log --graph -3
+
+            - name: Install node
+              uses: actions/setup-node@v4
+              with:
+                  node-version: 20.x
+
+            - name: Cache node modules
+              uses: actions/cache@v4
+              env:
+                  cache-name: cache-node-modules
+              with:
+                  # npm cache files are stored in `~/.npm` on Linux/macOS
+                  path: ~/.npm
+                  key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }}
+                  restore-keys: |
+                      ${{ runner.os }}-build-${{ env.cache-name }}-
+                      ${{ runner.os }}-build-
+                      ${{ runner.os }}-
+
+            - name: setup Miniconda
+              uses: conda-incubator/setup-miniconda@v3
+
+            - name: Create and activate virtual environment
+              run: |
+                  python3 -m venv test_venv
+                  source test_venv/bin/activate
+                  echo PATH=$PATH >> $GITHUB_ENV
+                  echo VIRTUAL_ENV=$VIRTUAL_ENV >> $GITHUB_ENV
+
+            - name: Setup dependencies in virtual environment
+              run: |
+                  make setup
+
+            - name: Build
+              run: make build
+
+            - name: Integration Tests
+              #run: make test-integration-parallel
+              run: |
+                  make test-integration
+
+            - uses: actions/upload-artifact@v4
+              with:
+                  name: pyscript
+                  path: |
+                      pyscript.core/dist/
+                  if-no-files-found: error
+                  retention-days: 7
+
+            - uses: actions/upload-artifact@v4
+              if: success() || failure()
+              with:
+                  name: test_results
+                  path: test_results/
+                  if-no-files-found: error

.github/workflows/test_report.yml

@@ -0,0 +1,16 @@
+name: Test Report
+on:
+    workflow_run:
+        workflows: ['\[CI\] Test']
+        types:
+            - completed
+jobs:
+    report:
+        runs-on: ubuntu-latest-8core
+        steps:
+            - uses: dorny/test-reporter@v1.9.0
+              with:
+                  artifact: test_results
+                  name: Test reports
+                  path: "*.xml"
+                  reporter: java-junit

.gitignore

@@ -51,7 +51,6 @@ coverage.xml
 *.py,cover
 .hypothesis/
 .pytest_cache/
-pyscriptjs/examples
 
 # Translations
 *.mo
@@ -136,3 +135,18 @@ dmypy.json
 .pyre/
 
 node_modules/
+
+coverage/
+
+# junit xml for test results
+test_results
+
+# @pyscript/core npm artifacts
+pyscript.core/test-results/*
+pyscript.core/core.*
+pyscript.core/dist
+pyscript.core/dist.zip
+pyscript.core/src/plugins.js
+pyscript.core/src/stdlib/pyscript.js
+pyscript.core/src/3rd-party/*
+!pyscript.core/src/3rd-party/READMEmd

.pre-commit-config.yaml

@@ -1,89 +1,53 @@
 # This is the configuration for pre-commit, a local framework for managing pre-commit hooks
 #   Check out the docs at: https://pre-commit.com/
+ci:
+    #skip: [eslint]
+    autoupdate_schedule: monthly
 
 default_stages: [commit]
 repos:
--   repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.3.0
-    hooks:
-    -   id: check-builtin-literals
-    -   id: check-case-conflict
-    -   id: check-docstring-first
-    -   id: check-executables-have-shebangs
-    -   id: check-json
-        exclude: tsconfig.json
-    -   id: check-toml
-    -   id: check-xml
-    -   id: check-yaml
-    -   id: detect-private-key
-    -   id: end-of-file-fixer
-        exclude: \.min\.js$
-    -   id: trailing-whitespace
+    - repo: https://github.com/pre-commit/pre-commit-hooks
+      rev: v4.6.0
+      hooks:
+          - id: check-builtin-literals
+          - id: check-case-conflict
+          - id: check-docstring-first
+          - id: check-executables-have-shebangs
+          - id: check-json
+            exclude: tsconfig\.json
+          - id: check-toml
+            exclude: bad\.toml
+          - id: check-xml
+          - id: check-yaml
+          - id: detect-private-key
+          - id: end-of-file-fixer
+            exclude: pyscript\.core/dist|\.min\.js$
+          - id: trailing-whitespace
 
--   repo: https://github.com/PyCQA/bandit
-    rev: 1.7.4
-    hooks:
-    -   id: bandit
-        args:
-        -   --skip=B201
+    - repo: https://github.com/psf/black
+      rev: 24.4.2
+      hooks:
+          - id: black
+            exclude: pyscript\.core/src/stdlib/pyscript/__init__\.py
 
--   repo: https://github.com/psf/black
-    rev: 22.3.0
-    hooks:
-    -   id: black
+    - repo: https://github.com/codespell-project/codespell
+      rev: v2.3.0
+      hooks:
+          - id: codespell # See 'pyproject.toml' for args
+            exclude: \.js\.map$
+            additional_dependencies:
+                - tomli
 
--   repo: https://github.com/codespell-project/codespell
-    rev: v2.1.0
-    hooks:
-    -   id: codespell  # See 'setup.cfg' for args
+    - repo: https://github.com/hoodmane/pyscript-prettier-precommit
+      rev: "v3.0.0-alpha.6"
+      hooks:
+          - id: prettier
+            exclude: pyscript\.core/test|pyscript\.core/dist|pyscript\.core/types|pyscript.core/src/stdlib/pyscript.js|pyscript\.sw/|pyscript.core/src/3rd-party
+            args: [--tab-width, "4"]
 
--   repo: https://github.com/PyCQA/flake8
-    rev: 4.0.1
-    hooks:
-    -   id: flake8  # See 'setup.cfg' for args
-        additional_dependencies: [flake8-bugbear, flake8-comprehensions]
-
--   repo: https://github.com/pycqa/isort
-    rev: 5.10.1
-    hooks:
-    -   id: isort
-        name: isort (python)
-        args: [--profile, black]
-
--   repo: https://github.com/macisamuele/language-formatters-pre-commit-hooks
-    rev: v2.3.0
-    hooks:
-    -   id: pretty-format-yaml
-        args: [--autofix, --indent, '4']
-        exclude: .github/ISSUE_TEMPLATE/.*\.yml$
-
--   repo: https://github.com/asottile/pyupgrade
-    rev: v2.34.0
-    hooks:
-    -   id: pyupgrade
-        args:
-        -   --py310-plus
-
--   repo: https://github.com/pre-commit/mirrors-eslint
-    rev: v8.18.0
-    hooks:
-    -   id: eslint
-        files: pyscriptjs/src/.*\.[jt]sx?$  # *.js, *.jsx, *.ts and *.tsx
-        types: [file]
-        additional_dependencies:
-        -   eslint
-        -   eslint-plugin-svelte3
-        -   typescript
-        -   '@typescript-eslint/eslint-plugin'
-        -   '@typescript-eslint/parser'
-
-# Commented out until mdformat-myst supports custom extensions
-# See https://github.com/executablebooks/mdformat-myst/pull/9
-# -   repo: https://github.com/executablebooks/mdformat
-#     rev: 0.7.14 # Use the ref you want to point at
-#     hooks:
-#     -   id: mdformat
-#         additional_dependencies:
-#         -   mdformat-gfm
-#         -   mdformat-myst
-#         -   mdformat-black
+    - repo: https://github.com/pycqa/isort
+      rev: 5.13.2
+      hooks:
+          - id: isort
+            name: isort (python)
+            args: [--profile, black]

.prettierignore

@@ -0,0 +1,5 @@
+ISSUE_TEMPLATE
+*.min.*
+package-lock.json
+docs
+examples/panel.html

.readthedocs.yml

@@ -25,4 +25,4 @@ conda:
 # Optionally declare the Python requirements required to build your docs
 python:
     install:
-    -   requirements: docs/requirements.txt
+        - requirements: docs/requirements.txt

CHANGELOG.md

@@ -0,0 +1,97 @@
+# Release Notes
+
+## 2024.05.21
+
+### Features
+
+### Bug fixes
+
+### Enhancements
+
+-   `py-editor` run buttons now display a spinner when disabled, which occurs when the editor is running code.
+
+## 2023.05.01
+
+### Features
+
+-   Added the `xterm` attribute to `py-config`. When set to `True` or `xterm`, an (output-only) [xterm.js](http://xtermjs.org/) terminal will be used in place of the default py-terminal.
+-   The default version of Pyodide is now `0.23.2`. See the [Pyodide Changelog](https://pyodide.org/en/stable/project/changelog.html#version-0-23-2) for a detailed list of changes.
+-   Added the `@when` decorator for attaching Python functions as event handlers
+-   The `py-mount` attribute on HTML elements has been deprecated, and will be removed in a future release.
+
+#### Runtime py- attributes
+
+-   Added logic to react to `py-*` attributes changes, removal, `py-*` attributes added to already live nodes but also `py-*` attributes added or defined via injected nodes (either appended or via `innerHTML` operations). ([#1435](https://github.com/pyscript/pyscript/pull/1435))
+
+#### <script type="py">
+
+-   Added the ability to optionally use `<script type="py">`, `<script type="pyscript">` or `<script type="py-script">` instead of a `<py-script>` custom element, in order to tackle cases where the content of the `<py-script>` tag, inevitably parsed by browsers, could accidentally contain _HTML_ able to break the surrounding page layout. ([#1396](https://github.com/pyscript/pyscript/pull/1396))
+
+#### &lt;py-terminal&gt;
+
+-   Added a `docked` field and attribute for the `<py-terminal>` custom element, enabled by default when the terminal is in `auto` mode, and able to dock the terminal at the bottom of the page with auto scroll on new code execution.
+
+#### &lt;py-script&gt;
+
+-   Restored the `output` attribute of `py-script` tags to route `sys.stdout` to a DOM element with the given ID. ([#1063](https://github.com/pyscript/pyscript/pull/1063))
+-   Added a `stderr` attribute of `py-script` tags to route `sys.stderr` to a DOM element with the given ID. ([#1063](https://github.com/pyscript/pyscript/pull/1063))
+
+#### &lt;py-repl&gt;
+
+-   The `output` attribute of `py-repl` tags now specifies the id of the DOM element that `sys.stdout`, `sys.stderr`, and the results of a REPL execution are written to. It no longer affects the location of calls to `display()`
+-   Added a `stderr` attribute of `py-repl` tags to route `sys.stderr` to a DOM element with the given ID. ([#1106](https://github.com/pyscript/pyscript/pull/1106))
+-   Resored the `output-mode` attribute of `py-repl` tags. If `output-mode` == 'append', the DOM element where output is printed is _not_ cleared before writing new results.
+-   Load code from the attribute src of py-repl and preload it into the corresponding py-repl tag by use the attribute `str` in your `py-repl` tag([#1292](https://github.com/pyscript/pyscript/pull/1292))
+-   &lt;py-repl&gt; elements now have a `getPySrc()` method, which returns the code inside the REPL as a string.([#1516](https://github.com/pyscript/pyscript/pull/1292))
+
+#### Plugins
+
+-   Plugins may now implement the `beforePyReplExec()` and `afterPyReplExec()` hooks, which are called immediately before and after code in a `py-repl` tag is executed. ([#1106](https://github.com/pyscript/pyscript/pull/1106))
+
+#### Web worker support
+
+-   introduced the new experimental `execution_thread` config option: if you set `execution_thread = "worker"`, the python interpreter runs inside a web worker
+-   worker support is still **very** experimental: not everything works, use it at your own risk
+
+### Bug fixes
+
+-   Fixes [#1280](https://github.com/pyscript/pyscript/issues/1280), which describes the errors on the PyRepl tests related to having auto-gen tags that shouldn't be there.
+
+### Enhancements
+
+-   Py-REPL tests now run on both osx and non osx OSs
+-   migrated from _rollup_ to _esbuild_ to create artifacts
+-   updated `@codemirror` dependency to its latest
+
+### Docs
+
+-   Add docs for event handlers
+
+## 2023.03.1
+
+### Features
+
+### Bug fixes
+
+-   Fixed an issue where `pyscript` would not be available when using the minified version of PyScript. ([#1054](https://github.com/pyscript/pyscript/pull/1054))
+-   Fixed missing closing tag when rendering an image with `display`. ([#1058](https://github.com/pyscript/pyscript/pull/1058))
+-   Fixed a bug where Python plugins methods were being executed twice. ([#1064](https://github.com/pyscript/pyscript/pull/1064))
+
+### Enhancements
+
+-   When adding a `py-` attribute to an element but didn't added an `id` attribute, PyScript will now generate a random ID for the element instead of throwing an error which caused the splash screen to not shutdown. ([#1122](https://github.com/pyscript/pyscript/pull/1122))
+-   You can now disable the splashscreen by setting `enabled = false` in your `py-config` under the `[splashscreen]` configuration section. ([#1138](https://github.com/pyscript/pyscript/pull/1138))
+
+### Documentation
+
+-   Fixed 'Direct usage of document is deprecated' warning in the getting started guide. ([#1052](https://github.com/pyscript/pyscript/pull/1052))
+-   Added reference documentation for the `py-splashscreen` plugin ([#1138](https://github.com/pyscript/pyscript/pull/1138))
+-   Adds doc for installing tests ([#1156](https://github.com/pyscript/pyscript/pull/1156))
+-   Adds docs for custom Pyscript attributes (`py-*`) that allow you to add event listeners to an element ([#1125](https://github.com/pyscript/pyscript/pull/1125))
+
+### Deprecations and Removals
+
+-   The py-config `runtimes` to specify an interpreter has been deprecated. The `interpreters` config should be used instead. ([#1082](https://github.com/pyscript/pyscript/pull/1082))
+-   The attributes `pys-onClick` and `pys-onKeyDown` have been deprecated, but the warning was only shown in the console. An alert banner will now be shown on the page if the attributes are used. They will be removed in the next release. ([#1084](https://github.com/pyscript/pyscript/pull/1084))
+-   The pyscript elements `py-button`, `py-inputbox`, `py-box` and `py-title` have now completed their deprecation cycle and have been removed. ([#1084](https://github.com/pyscript/pyscript/pull/1084))
+-   The attributes `pys-onClick` and `pys-onKeyDown` have been removed. Use `py-click` and `py-keydown` instead ([#1361](https://github.com/pyscript/pyscript/pull/1361))

CONTRIBUTING.md

@@ -4,87 +4,69 @@ Thank you for wanting to contribute to the PyScript project!
 
 ## Table of contents
 
-* [Code of Conduct](#code-of-conduct)
-* [Contributing](#contributing)
-    * [Reporting bugs](#reporting-bugs)
-    * [Reporting security issues](#reporting-security-issues)
-    * [Asking questions](#asking-questions)
-    * [Setting up your environment](#setting-up-your-environment)
-    * [Places to start](#places-to-start)
-    * [Submitting a change](#submitting-a-change)
-* [License terms for contributions](#license-terms-for-contributions)
-* [Becoming a maintainer](#becoming-a-maintainer)
-* [Trademarks](#trademarks)
+-   [Contributing to PyScript](#contributing-to-pyscript)
+    -   [Table of contents](#table-of-contents)
+-   [Code of Conduct](#code-of-conduct)
+-   [Contributing](#contributing)
+    -   [Reporting bugs](#reporting-bugs)
+    -   [Creating useful issues](#creating-useful-issues)
+    -   [Reporting security issues](#reporting-security-issues)
+    -   [Asking questions](#asking-questions)
+    -   [Setting up your local environment and developing](#setting-up-your-local-environment-and-developing)
+    -   [Developing](#developing)
+    -   [Rebasing changes](#rebasing-changes)
+    -   [Building the docs](#building-the-docs)
+    -   [Places to start](#places-to-start)
+    -   [Setting up your local environment and developing](#setting-up-your-local-environment-and-developing)
+    -   [Submitting a change](#submitting-a-change)
+-   [License terms for contributions](#license-terms-for-contributions)
+-   [Becoming a maintainer](#becoming-a-maintainer)
+-   [Trademarks](#trademarks)
 
-## Code of Conduct
+# Code of Conduct
 
 The [PyScript Code of Conduct](https://github.com/pyscript/governance/blob/main/CODE-OF-CONDUCT.md) governs the project and everyone participating in it. By participating, you are expected to uphold this code. Please report unacceptable behavior to the maintainers or administrators as described in that document.
 
-## Contributing
+# Contributing
 
-### Reporting bugs
+## Reporting bugs
 
 Bugs are tracked on the [project issues page](https://github.com/pyscript/pyscript/issues). Please check if your issue has already been filed by someone else by searching the existing issues before filing a new one. Once your issue is filed, it will be triaged by another contributor or maintainer. If there are questions raised about your issue, please respond promptly.
 
-#### Creating useful issues
+## Creating useful issues
 
-* Use a clear and descriptive title.
-* Describe the specific steps that reproduce the problem with as many details as possible so that someone can verify the issue.
-* Describe the behavior you observed, and the behavior you had expected.
-* Include screenshots if they help make the issue clear.
+-   Use a clear and descriptive title.
+-   Describe the specific steps that reproduce the problem with as many details as possible so that someone can verify the issue.
+-   Describe the behavior you observed, and the behavior you had expected.
+-   Include screenshots if they help make the issue clear.
 
-### Reporting security issues
+## Reporting security issues
 
 If you aren't confident that it is appropriate to submit a security issue using the above process, you can e-mail it to security@pyscript.net
 
-### Asking questions
+## Asking questions
 
 If you have questions about the project, using PyScript, or anything else, please ask in the [PyScript forum](https://community.anaconda.cloud/c/tech-topics/pyscript).
 
-### Setting up your environment
+## Places to start
 
-* clone the repo
-```
-    git clone https://github.com/pyscript/pyscript
-```
-* cd into the main project folder
-```
-    cd pyscript/pyscriptjs
-```
-* install the dependencies with npm install - make sure to use nodejs version >= 16
-```
-    npm install
-```
-* run npm run dev to build and run the dev server. This will also watch for changes and rebuild when a file is saved.
-```
-    npm run dev
-```
+If you would like to contribute to PyScript, but you aren't sure where to begin, here are some suggestions:
 
-### Places to start
+-   **Read over the existing documentation.** Are there things missing, or could they be clearer? Make some changes/additions to those documents.
+-   **Review the open issues.** Are they clear? Can you reproduce them? You can add comments, clarifications, or additions to those issues. If you think you have an idea of how to address the issue, submit a fix!
+-   **Look over the open pull requests.** Do you have comments or suggestions for the proposed changes? Add them.
+-   **Check out the examples.** Is there a use case that would be good to have sample code for? Create an example for it.
 
-If you would like to contribute to PyScript, but you aren't sure where to begin, here are some suggestions.
+## Setting up your local environment and developing
 
-* **Read over the existing documentation.** Are there things missing, or could they be clearer? Make some changes/additions to those documents.
-* **Review the open issues.** Are they clear? Can you reproduce them? You can add comments, clarifications, or additions to those issues. If you think you have an idea of how to address the issue, submit a fix!
-* **Look over the open pull requests.** Do you have comments or suggestions for the proposed changes? Add them.
-* **Check out the examples.** Is there a use case that would be good to have sample code for? Create an example for it.
+If you would like to contribute to PyScript, you will need to set up a local development environment. The [following instructions](https://docs.pyscript.net/latest/contributing/#set-up-your-development-environment) will help you get started.
 
-### Submitting a change
-
-All contributions must be licensed Apache 2.0, and all files must have a copy of the boilerplate license comment (can be copied from an existing file).
-
-To create a change for PyScript, you can follow the process described [here](https://docs.github.com/en/get-started/quickstart/contributing-to-projects).
-
-* Fork a personal copy of the PyScript project.
-* Make the changes you would like (don't forget to test them!)
-* Please squash all commits for a change into a single commit (this can be done using "git rebase -i"). Do your best to have a well-formed commit message for the change.
-* Open a pull request back to the PyScript project and address any comments/questions from the maintainers and other contributors.
+You can also read about PyScript's [development process](https://docs.pyscript.net/latest/developers/) to learn how to contribute code to PyScript, how to run tests and what's the PR etiquette of the community!
 
 ## License terms for contributions
 
 This Project welcomes contributions, suggestions, and feedback. All contributions, suggestions, and feedback you submitted are accepted under the [Apache 2.0](./LICENSE) license. You represent that if you do not own copyright in the code that you have the authority to submit it under the [Apache 2.0](./LICENSE) license. All feedback, suggestions, or contributions are not confidential.
 
-
 ## Becoming a maintainer
 
 Contributors are invited to be maintainers of the project by demonstrating good decision making in their contributions, a commitment to the goals of the project, and consistent adherence to the [code of conduct](https://github.com/pyscript/governance/blob/main/CODE-OF-CONDUCT.md). New maintainers are invited by a 3/4 vote of the existing maintainers.
@@ -94,5 +76,106 @@ Contributors are invited to be maintainers of the project by demonstrating good
 The Project abides by the Organization's [trademark policy](https://github.com/pyscript/governance/blob/main/TRADEMARKS.md).
 
 ---
+
 Part of MVG-0.1-beta.
 Made with love by GitHub. Licensed under the [CC-BY 4.0 License](https://creativecommons.org/licenses/by-sa/4.0/).
+
+# Quick guide to pytest
+
+We make heavy usage of pytest. Here is a quick guide and collection of useful options:
+
+-   To run all tests in the current directory and subdirectories: pytest
+
+-   To run tests in a specific directory or file: pytest path/to/dir/test_foo.py
+
+-   -s: disables output capturing
+
+-   --pdb: in case of exception, enter a (Pdb) prompt so that you can inspect what went wrong.
+
+-   -v: verbose mode
+
+-   -x: stop the execution as soon as one test fails
+
+-   -k foo: run only the tests whose full name contains foo
+
+-   -k 'foo and bar'
+
+-   -k 'foo and not bar'
+
+## Running integration tests under pytest
+
+make test is useful to run all the tests, but during the development is useful to have more control on how tests are run. The following guide assumes that you are in the directory pyscriptjs/tests/integration/.
+
+### To run all the integration tests, single or multi core
+
+$ pytest -xv
+...
+
+test_00_support.py::TestSupport::test_basic[chromium] PASSED [ 0%]
+test_00_support.py::TestSupport::test_console[chromium] PASSED [ 1%]
+test_00_support.py::TestSupport::test_check_js_errors_simple[chromium] PASSED [ 2%]
+test_00_support.py::TestSupport::test_check_js_errors_expected[chromium] PASSED [ 3%]
+test_00_support.py::TestSupport::test_check_js_errors_expected_but_didnt_raise[chromium] PASSED [ 4%]
+test_00_support.py::TestSupport::test_check_js_errors_multiple[chromium] PASSED [ 5%]
+...
+
+-x means "stop at the first failure". -v means "verbose", so that you can see all the test names one by one. We try to keep tests in a reasonable order, from most basic to most complex. This way, if you introduced some bug in very basic things, you will notice immediately.
+
+If you have the pytest-xdist plugin installed, you can run all the integration tests on 4 cores in parallel:
+
+$ pytest -n 4
+
+### To run a single test, headless
+
+$ pytest test_01_basic.py -k test_pyscript_hello -s
+...
+[ 0.00 page.goto ] pyscript_hello.html
+[ 0.01 request ] 200 - fake_server - http://fake_server/pyscript_hello.html
+...
+[ 0.17 console.info ] [py-loader] Downloading pyodide-x.y.z...
+[ 0.18 request ] 200 - CACHED - https://cdn.jsdelivr.net/pyodide/vx.y.z/full/pyodide.js
+...
+[ 3.59 console.info ] [pyscript/main] PyScript page fully initialized
+[ 3.60 console.log ] hello pyscript
+
+-k selects tests by pattern matching as described above. -s instructs pytest to show the output to the terminal instead of capturing it. In the output you can see various useful things, including network requests and JS console messages.
+
+### To run a single test, headed
+
+$ pytest test_01_basic.py -k test_pyscript_hello -s --headed
+...
+
+Same as above, but with --headed the browser is shown in a window, and you can interact with it. The browser uses a fake server, which means that HTTP requests are cached.
+
+Unfortunately, in this mode source maps does not seem to work, and you cannot debug the original typescript source code. This seems to be a bug in playwright, for which we have a workaround:
+
+$ pytest test_01_basic.py -k test_pyscript_hello -s --headed --no-fake-server
+...
+
+As the name implies, -no-fake-server disables the fake server: HTTP requests are not cached, but source-level debugging works.
+
+Finally:
+
+$ pytest test_01_basic.py -k test_pyscript_hello -s --dev
+...
+
+--dev implies --headed --no-fake-server. In addition, it also automatically open chrome dev tools.
+
+### To run only main thread or worker tests
+
+By default, we run each test twice: one with execution_thread = "main" and one with execution_thread = "worker". If you want to run only half of them, you can use -m:
+
+$ pytest -m main # run only the tests in the main thread
+$ pytest -m worker # ron only the tests in the web worker
+
+## Fake server, HTTP cache
+
+By default, our test machinery uses a playwright router which intercepts and cache HTTP requests, so that for example you don't have to download pyodide again and again. This also enables the possibility of running tests in parallel on multiple cores.
+
+The cache is stored using the pytest-cache plugin, which means that it survives across sessions.
+
+If you want to temporarily disable the cache, the easiest thing is to use --no-fake-server, which bypasses it completely.
+
+If you want to clear the cache, you can use the special option --clear-http-cache:
+
+NOTE: this works only if you are inside tests/integration, or if you explicitly specify tests/integration from the command line. This is due to how pytest decides to search for and load the various conftest.py.

GOVERNANCE.md

@@ -41,5 +41,6 @@ Any names, trademarks, logos, or goodwill developed by and associated with the P
 Amendments to this governance policy may be made by affirmative vote of 2/3 of all Maintainers, with approval by the Organization's Steering Committee.
 
 ---
+
 Part of MVG-0.1-beta.
 Made with love by GitHub. Licensed under the [CC-BY 4.0 License](https://creativecommons.org/licenses/by-sa/4.0/).

LICENSE

@@ -186,7 +186,11 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+
+   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.

MAINTAINERS.md

@@ -2,17 +2,23 @@
 
 This document lists the Maintainers of the Project. Maintainers may be added once approved by the existing maintainers as described in the [Governance document](https://github.com/pyscript/pyscript/blob/main/GOVERNANCE.md). By adding your name to this list you are agreeing to abide by the Project governance documents and to abide by all of the Organization's polices, including the [code of conduct](https://github.com/pyscript/governance/blob/main/CODE-OF-CONDUCT.md), [trademark policy](https://github.com/pyscript/governance/blob/main/TRADEMARKS.md), and [antitrust policy](https://github.com/pyscript/governance/blob/main/TRADEMARKS.md). If you are participating because of your affiliation with another organization (designated below), you represent that you have the authority to bind that organization to these policies.
 
-| **NAME**         | **Organization** |
-| ---------------- | ---------------- |
-| Fabio Pliger     | Anaconda, Inc    |
-| Antonio Cuni     | Anaconda, Inc    |
-| Philipp Rudiger  | Anaconda, Inc    |
-| Peter Wang       | Anaconda, Inc    |
-| Kevin Goldsmith  | Anaconda, Inc    |
-| Mariana Meireles | Anaconda, Inc    |
-| ---              | ---              |
+| **NAME**             | **Organization** |
+| -------------------- | ---------------- |
+| Fabio Pliger         | Anaconda, Inc    |
+| Antonio Cuni         | Anaconda, Inc    |
+| Philipp Rudiger      | Anaconda, Inc    |
+| Peter Wang           | Anaconda, Inc    |
+| Kevin Goldsmith      | Anaconda, Inc    |
+| Mariana Meireles     |                  |
+| Nicholas H.Tollervey | Anaconda, Inc    |
+| Madhur Tandon        | Anaconda, Inc    |
+| Ted Patrick          | Anaconda, Inc    |
+| Jeff Glass           |                  |
+| Paul Everitt         |                  |
+| Fabio Rosado         | Anaconda, Inc    |
+| Andrea Giammarchi    | Anaconda, Inc    |
 
-______________________________________________________________________
+---
 
 Part of MVG-0.1-beta.
 Made with love by GitHub. Licensed under the [CC-BY 4.0 License](https://creativecommons.org/licenses/by-sa/4.0/).

Makefile

@@ -0,0 +1,92 @@
+MIN_NODE_VER := 20
+MIN_NPM_VER  := 6
+MIN_PY3_VER  := 8
+NODE_VER     := $(shell node -v | cut -d. -f1 | sed 's/^v\(.*\)/\1/')
+NPM_VER      := $(shell npm -v | cut -d. -f1)
+PY3_VER      := $(shell python3 -c "import sys;t='{v[1]}'.format(v=list(sys.version_info[:2]));print(t)")
+PY_OK        := $(shell python3 -c "print(int($(PY3_VER) >= $(MIN_PY3_VER)))")
+
+all:
+	@echo "\nThere is no default Makefile target right now. Try:\n"
+	@echo "make setup - check your environment and install the dependencies."
+	@echo "make clean - clean up auto-generated assets."
+	@echo "make build - build PyScript."
+	@echo "make precommit-check - run the precommit checks (run eslint)."
+	@echo "make test-integration - run all integration tests sequentially."
+	@echo "make fmt - format the code."
+	@echo "make fmt-check - check the code formatting.\n"
+
+.PHONY: check-node
+check-node:
+	@if [ $(NODE_VER) -lt $(MIN_NODE_VER) ]; then \
+		echo "\033[0;31mBuild requires Node $(MIN_NODE_VER).x or higher: $(NODE_VER) detected.\033[0m"; \
+		false; \
+	fi
+
+.PHONY: check-npm
+check-npm:
+	@if [ $(NPM_VER) -lt $(MIN_NPM_VER) ]; then \
+		echo "\033[0;31mBuild requires Node $(MIN_NPM_VER).x or higher: $(NPM_VER) detected.\033[0m"; \
+		false; \
+	fi
+
+.PHONY: check-python
+check-python:
+	@if [ $(PY_OK) -eq 0 ]; then \
+		echo "\033[0;31mRequires Python 3.$(MIN_PY3_VER).x or higher: 3.$(PY3_VER) detected.\033[0m"; \
+		false; \
+	fi
+
+# Check the environment, install the dependencies.
+setup: check-node check-npm check-python
+	cd pyscript.core && npm install && cd ..
+ifeq ($(VIRTUAL_ENV),)
+	echo "\n\n\033[0;31mCannot install Python dependencies. Your virtualenv is not activated.\033[0m"
+	false
+else
+	python -m pip install -r requirements.txt
+	playwright install
+endif
+
+# Clean up generated assets.
+clean:
+	find . -name \*.py[cod] -delete
+	rm -rf $(env) *.egg-info
+	rm -rf .pytest_cache .coverage coverage.xml
+
+# Build PyScript.
+build:
+	cd pyscript.core && npx playwright install && npm run build
+
+# Run the precommit checks (run eslint).
+precommit-check:
+	pre-commit run --all-files
+
+# Run all integration tests sequentially.
+test-integration:
+	mkdir -p test_results
+	pytest -vv $(ARGS) pyscript.core/tests/integration/ --log-cli-level=warning --junitxml=test_results/integration.xml
+
+# Run all integration tests in parallel.
+test-integration-parallel:
+	mkdir -p test_results
+	pytest --numprocesses auto -vv $(ARGS) pyscript.core/tests/integration/ --log-cli-level=warning --junitxml=test_results/integration.xml
+
+# Format the code.
+fmt: fmt-py
+	@echo "Format completed"
+
+# Check the code formatting.
+fmt-check: fmt-py-check
+	@echo "Format check completed"
+
+# Format Python code.
+fmt-py:
+	black -l 88 --skip-string-normalization .
+	isort --profile black .
+
+# Check the format of Python code.
+fmt-py-check:
+	black -l 88 --check .
+
+.PHONY: $(MAKECMDGOALS)

README.md

@@ -4,44 +4,92 @@
 
 ### Summary
 
-PyScript is a Pythonic alternative to Scratch, JSFiddle, and other "easy to use" programming frameworks, with the goal of making the web a friendly, hackable place where anyone can author interesting and interactive applications.
+PyScript is a framework that allows users to create rich Python applications in the browser using HTML's interface and the power of [Pyodide](https://pyodide.org/en/stable/), [MicroPython](https://micropython.org/) and [WASM](https://webassembly.org/), and modern web technologies.
 
-To get started see the [getting started tutorial](docs/tutorials/getting-started.md).
+To get started see the [Beginning PyScript tutorial](https://docs.pyscript.net/latest/beginning-pyscript/).
 
-For examples see [here](examples).
+For examples see [here](https://pyscript.com/@examples).
+
+Other useful resources:
+
+-   The [official technical docs](https://docs.pyscript.net/).
+-   Our current [Home Page](https://pyscript.net/) on the web.
+-   A free-to-use [online editor](https://pyscript.com/) for trying PyScript.
+-   Our community [Discord Channel](https://discord.gg/BYB2kvyFwm), to keep in touch .
+
+Every Tuesday at 15:30 UTC there is the _PyScript Community Call_ on zoom, where we can talk about PyScript development in the open. Most of the maintainers regularly participate in the call, and everybody is welcome to join.
+
+Every other Thursday at 16:00 UTC there is the _PyScript FUN_ call: this is a call in which everybody is encouraged to show what they did with PyScript.
+
+For more details on how to join the calls and up to date schedule, consult the official calendar:
+
+-   [Google calendar](https://calendar.google.com/calendar/u/0/embed?src=d3afdd81f9c132a8c8f3290f5cc5966adebdf61017fca784eef0f6be9fd519e0@group.calendar.google.com&ctz=UTC) in UTC time;
+-   [iCal format](https://calendar.google.com/calendar/ical/d3afdd81f9c132a8c8f3290f5cc5966adebdf61017fca784eef0f6be9fd519e0%40group.calendar.google.com/public/basic.ics).
 
 ### Longer Version
+
 PyScript is a meta project that aims to combine multiple open technologies into a framework that allows users to create sophisticated browser applications with Python. It integrates seamlessly with the way the DOM works in the browser and allows users to add Python logic in a way that feels natural both to web and Python developers.
 
 ## Try PyScript
 
-To try PyScript, import the appropriate pyscript files to your html page with:
+To try PyScript, import the appropriate pyscript files into the `<head>` tag of your html page:
+
 ```html
-<link rel="stylesheet" href="https://pyscript.net/alpha/pyscript.css" />
-<script defer src="https://pyscript.net/alpha/pyscript.js"></script>
+<head>
+    <link
+        rel="stylesheet"
+        href="https://pyscript.net/releases/2024.5.2/core.css"
+    />
+    <script
+        type="module"
+        src="https://pyscript.net/releases/2024.5.2/core.js"
+    ></script>
+</head>
+<body>
+    <script type="py" terminal>
+        from pyscript import display
+        display("Hello World!") # this goes to the DOM
+        print("Hello terminal") # this goes to the terminal
+    </script>
+</body>
 ```
-You can then use PyScript components in your html page. PyScript currently implements the following elements:
 
-* `<py-script>`: can be used to define python code that is executable within the web page. The element itself is not rendered to the page and is only used to add logic
-* `<py-repl>`: creates a REPL component that is rendered to the page as a code editor and allows users to write executable code
+You can then use PyScript components in your html page. PyScript currently offers various ways of running Python code:
 
-Check out the [the examples directory](examples) folder for more examples on how to use it, all you need to do is open them in Chrome.
+-   `<script type="py">`: can be used to define python code that is executable within the web page.
+-   `<script type="py" src="hello.py">`: same as above, but the python source is fetched from the given URL.
+-   `<script type="py" terminal>`: same as above, but also creates a terminal where to display stdout and stderr (e.g., the output of `print()`); `input()` does not work.
+-   `<script type="py" terminal worker>`: run Python inside a web worker: the terminal is fully functional and `input()` works.
+-   `<py-script>`: same as `<script type="py">`, but it is not recommended because if the code contains HTML tags, they could be parsed wrongly.
+-   `<script type="mpy">`: same as above but use MicroPython instead of Python.
+
+Check out the [official docs](https://docs.pyscript.net/) for more detailed documentation.
 
 ## How to Contribute
 
-Read the [contributing guide](CONTRIBUTING.md) to learn about our development process, reporting bugs and improvements, creating issues and asking questions.
+Read the [contributing guide](https://docs.pyscript.net/latest/contributing/) to learn about our development process, reporting bugs and improvements, creating issues and asking questions.
 
-## Resources
-
-* [Discussion board](https://community.anaconda.cloud/c/tech-topics/pyscript)
-* [Home Page](https://pyscript.net/)
-* [Blog Post](https://engineering.anaconda.com/2022/04/welcome-pyscript.html)
-
-## Notes
-
-* This is an extremely experimental project, so expect things to break!
-* PyScript has been only tested on Chrome at the moment.
+Check out the [developing process](https://docs.pyscript.net/latest/developers/) documentation for more information on how to setup your development environment.
 
 ## Governance
 
 The [PyScript organization governance](https://github.com/pyscript/governance) is documented in a separate repository.
+
+## Release
+
+To cut a new release of PyScript simply
+[add a new release](https://github.com/pyscript/pyscript/releases) while
+remembering to write a comprehensive changelog. A [GitHub action](https://github.com/pyscript/pyscript/blob/main/.github/workflows/publish-release.yml)
+will kick in and ensure the release is described and deployed to a URL with the
+pattern: https://pyscript.net/releases/YYYY.M.v/ (year/month/version - as per
+our [CalVer](https://calver.org/) versioning scheme).
+
+Then, the following three separate repositories need updating:
+
+-   [Documentation](https://github.com/pyscript/docs) - Change the `version.json`
+    file in the root of the directory and then `node version-update.js`.
+-   [Homepage](https://github.com/pyscript/pyscript.net) - Ensure the version
+    referenced in `index.html` is the latest version.
+-   [PSDC](https://pyscript.com) - Use discord or Anaconda Slack (if you work at
+    Anaconda) to let the PSDC team know there's a new version, so they can update
+    their project templates.

TROUBLESHOOTING.md

@@ -0,0 +1,19 @@
+# Troubleshooting
+
+This page is meant for troubleshooting common problems with PyScript.
+
+## Table of contents:
+
+-   [Make Setup](#make-setup)
+
+## Make setup
+
+A lot of problems related to `make setup` are related to node and npm being outdated. Once npm and node are updated, `make setup` should work. You can follow the steps on the [npm documentation](https://docs.npmjs.com/try-the-latest-stable-version-of-npm) to update npm (the update command for Linux should work for Mac as well). Once npm has been updated you can continue to the instructions to update node below.
+
+To update Node run the following commands in order (Most likely you'll be prompted for your user password, this is normal):
+
+```
+sudo npm cache clean -f
+sudo npm install -g n
+sudo n stable
+```

docs/Makefile

@@ -1,45 +0,0 @@
-# Minimal makefile for Sphinx documentation
-#
-
-# You can set these variables from the command line, and also
-# from the environment for the first two.
-SPHINXOPTS    ?=
-SPHINXBUILD   ?= sphinx-build
-SOURCEDIR     = .
-BUILDDIR      = _build
-CONDA_ENV     ?= _env
-
-# Put it first so that "make" without argument is like "make help".
-help:
-	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
-
-env := $(CONDA_ENV)
-conda_run := conda run -p $(env)
-
-setup:
-	@if [ -z "$${CONDA_SHLVL:+x}" ]; then echo "Conda is not installed." && exit 1; fi
-	$(CONDA_EXE) env $(shell [ -d $(env) ] && echo update || echo create) -p $(env) --file environment.yml
-
-clean:
-	rm -rf $(BUILDDIR)
-
-clean-all: clean
-	rm -rf $(env) *.egg-info
-
-shell:
-	@export CONDA_ENV_PROMPT='<{name}>'
-	@echo 'conda activate $(env)'
-
-htmlserve:
-	python -m http.server -d "$(BUILDDIR)/html/"
-
-livehtml:
-	sphinx-autobuild "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
-
-
-.PHONY: help Makefile setup clean clean-all shell
-
-# Catch-all target: route all unknown targets to Sphinx using the new
-# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
-%: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/README.md

@@ -1,17 +0,0 @@
-# PyScript documentation
-
-Welcome to the PyScript documentation directory, where you can find
-and contribute to discussions around PyScript and related topics.
-
-## Getting started
-
-Before you start contributing to the documentation, it's worthwhile to
-take a look at the general contributing guidelines for the PyScript project. You can find these guidelines here
-[Contributing Guidelines](https://github.com/pyscript/pyscript/blob/main/CONTRIBUTING.md)
-
-### Setup
-
-The `docs` directory in the pyscript repository contains a
-[Sphinx](https://www.sphinx-doc.org/) documentation project. Sphinx is a system
-that takes plaintext files containing documentation written in Markdown, along with
-and static files like templates and themes, to build the static end result.

docs/_static/examples/what-is-pyscript.html

@@ -1,44 +0,0 @@
-<html>
-    <head>
-      <link rel="stylesheet" href="https://pyscript.net/alpha/pyscript.css" />
-      <script defer src="https://pyscript.net/alpha/pyscript.js"></script>
-      <style>
-        .pulse {
-            animation: pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
-        }
-
-        @keyframes pulse {
-          0%, 100% {
-            opacity: 1;
-          }
-          50% {
-            opacity: .2;
-          }
-        }
-      </style>
-      <py-env>
-        - numpy
-        - matplotlib
-      </py-env>
-    </head>
-
-  <body>
-    <h1>Let's plot random numbers</h1>
-    <div id="plot">
-      <div class="pulse" >
-        <p style='font-family: monospace sans-serif;'><big><big><big><big>&#10096;py&#10097;</big></big></big></big></p>
-      </div>
-    </div>
-    <py-script>
-import matplotlib.pyplot as plt
-import numpy as np
-
-x = np.random.randn(1000)
-y = np.random.randn(1000)
-
-fig, ax = plt.subplots()
-ax.scatter(x, y)
-pyscript.write('plot', fig)
-    </py-script>
-  </body>
-</html>

docs/_static/redirect.html

@@ -1 +0,0 @@
-<html><head><meta http-equiv="refresh" content="0; URL='/latest/'" /></head><body></body></html>

docs/concepts/governance/maintainers.md

@@ -1 +0,0 @@
-../../../MAINTAINERS.md

docs/concepts/governance/policy.md

@@ -1 +0,0 @@
-../../../GOVERNANCE.md

docs/concepts/index.md

@@ -1,12 +0,0 @@
-# Concepts
-
-This section contains various topics that are higher-level and useful to know.
-
-```{toctree}
----
-maxdepth: 2
-glob:
----
-what-is-pyscript
-governance/*
-```

docs/concepts/what-is-pyscript.md

@@ -1,34 +0,0 @@
-# What is PyScript?
-
-The PyScript library provides HTML tags for embedding and executing Python code in your browser. PyScript is built using [Pyodide](https://pyodide.org/en/stable/), the WebAssembly port of CPython, which is compiled using [Emscripten](https://emscripten.org/).
-
-PyScript turns the browser into a code deployment tool that anyone can learn to use.
-
-## Example
-
-In this example, we are using the `<py-script>` HTML tag to generate a Matplotlib figure and display it as an image.
-Click **Preview** to see the rendered HTML.
-
-To try it in your browser, copy the code below into an online HTML editor like W3School's [Tryit Editor](https://www.w3schools.com/html/tryit.asp?filename=tryhtml_default_default), which allows you to modify, run, and even save your code. Watch the video below to see it in action!
-
-```{youtube} ZtC7TCt_LhU
-```
-
-::::{tab-set}
-:::{tab-item} HTML Source
-
-```{literalinclude} ../_static/examples/what-is-pyscript.html
----
-linenos:
-```
-
-:::
-
-:::{tab-item} Preview
-
-```{raw} html
-<iframe height="600px" width="100%" scrolling="auto" frameborder="0" src="../_static/examples/what-is-pyscript.html"></iframe>
-```
-
-:::
-::::

docs/conf.py

@@ -1,103 +0,0 @@
-# Configuration file for the Sphinx documentation builder.
-#
-# This file only contains a selection of the most common options. For a full
-# list see the documentation:
-# https://www.sphinx-doc.org/en/master/usage/configuration.html
-
-# -- Path setup --------------------------------------------------------------
-
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-#
-import os
-
-# import sys
-# sys.path.insert(0, os.path.abspath('.'))
-
-
-# -- Project information -----------------------------------------------------
-
-project = "PyScript"
-copyright = "(c) 2022, Anaconda, Inc."
-author = "Anaconda, Inc."
-language = "en"
-
-# -- General configuration ---------------------------------------------------
-
-# Add any Sphinx extension module names here, as strings. They can be
-# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
-# ones.
-extensions = [
-    "myst_parser",
-    "sphinx_copybutton",
-    "sphinx_design",
-    "sphinx_togglebutton",
-    "sphinx_sitemap",
-    "sphinxemoji.sphinxemoji",
-    "sphinxcontrib.youtube",
-]
-
-# Add any paths that contain templates here, relative to this directory.
-templates_path = ["_templates"]
-
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-# This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = ["_build", "Thumbs.db", ".DS_Store", "_env", "README.md"]
-
-
-# -- Options for HTML output -------------------------------------------------
-
-# The theme to use for HTML and HTML Help pages.  See the documentation for
-# a list of builtin themes.
-#
-html_theme = "pydata_sphinx_theme"
-
-html_logo = "_static/images/avatar.jpg"
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ["_static"]
-# html_css_files = ["styles/custom.css"]
-
-html_baseurl = os.environ.get("SPHINX_HTML_BASE_URL", "http://127.0.0.1:8000/")
-sitemap_locales = [None]
-sitemap_url_scheme = "{link}"
-
-html_extra_path = ["robots.txt"]
-
-html_theme_options = {
-    "github_url": "https://github.com/pyscript/pyscript",
-    "twitter_url": "https://twitter.com/pyscript_dev",
-    "icon_links_label": "Quick Links",
-    # "google_analytics_id": "G-XXXXXXXXXX",
-    "use_edit_page_button": True,
-    "show_nav_level": 2,
-    "external_links": [
-        # {"name": "GitHub repo", "url": "https://github.com/pyscript/pyscript"},
-    ],
-}
-
-html_context = {
-    "default_mode": "dark",
-    "pygment_light_style": "tango",
-    "pygment_dark_style": "native",
-    "github_user": "pyscript",
-    "github_repo": "pyscript",
-    "github_version": "main",
-    "doc_path": "docs",
-}
-
-
-myst_enable_extensions = [
-    "dollarmath",
-    "amsmath",
-    "deflist",
-    "html_admonition",
-    "html_image",
-    "colon_fence",
-    "smartquotes",
-    "replacements",
-]

docs/environment.yml

@@ -1,18 +0,0 @@
-channels:
--   conda-forge
--   defaults
-dependencies:
--   python=3.9
--   pip=20.2.2
--   Sphinx=4.5.0
--   myst-parser=0.17.2
--   pydata-sphinx-theme
--   sphinx-copybutton
--   sphinx-design
--   sphinx-togglebutton
-
--   pip:
-    -   sphinxemoji
-    -   sphinx-sitemap
-    -   sphinx-autobuild
-    -   sphinxcontrib-youtube

docs/howtos/index.md

@@ -1,18 +0,0 @@
-# How-to guides
-
-Welcome to the how-to documentation section for PyScript. If you've already
-gained some experience with PyScript before and just need practical guides
-to get your ideas realized, you can learn step by step how to use PyScript here.
-
-```{note}
-Please head over to the [tutorials](../tutorials/index.md) section if you're only getting started.
-```
-
-```{toctree}
----
-maxdepth: 2
-glob:
-caption: 'Contents:'
----
-*
-```

docs/index.md

@@ -1,54 +0,0 @@
-# PyScript
-
-```{warning}
-Please note, this documentation is just a placeholder and **should not be used
-in reference material**. Thank you!
-```
-
-Welcome to the PyScript documentation!
-
-PyScript provides a way for you to run Python code directly in your browser, giving
-anyone the ability to program without infrastructure barriers. Add an interactive
-Python REPL directly to your website, share an interactive dashboard with a colleague
-as an HTML file, or create a client-side Python-powered web application. This documentation
-will show you how.
-
-::::{grid} 2
-:gutter: 3
-
-:::{grid-item-card} [Tutorials](tutorials/index.md)
-
-Just getting started with PyScript?
-
-Check out our [getting started guide](tutorials/getting-started.md)!
-:::
-:::{grid-item-card} [How-to guides](howtos/index.md)
-
-**Coming soon!**
-
-:::
-:::{grid-item-card} [Concepts](concepts/index.md)
-
-[What is PyScript?](concepts/what-is-pyscript.md)
-
-:::
-:::{grid-item-card} [Reference](reference/index.md)
-
-[Frequently asked questions](reference/faq.md)
-
-:::{toctree}
-:maxdepth: 1
-
-:::
-::::
-
-```{toctree}
----
-maxdepth: 1
-hidden:
----
-tutorials/index
-howtos/index
-concepts/index
-reference/index
-```

docs/make.bat

@@ -1,35 +0,0 @@
-@ECHO OFF
-
-pushd %~dp0
-
-REM Command file for Sphinx documentation
-
-if "%SPHINXBUILD%" == "" (
-	set SPHINXBUILD=sphinx-build
-)
-set SOURCEDIR=.
-set BUILDDIR=_build
-
-%SPHINXBUILD% >NUL 2>NUL
-if errorlevel 9009 (
-	echo.
-	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
-	echo.installed, then set the SPHINXBUILD environment variable to point
-	echo.to the full path of the 'sphinx-build' executable. Alternatively you
-	echo.may add the Sphinx directory to PATH.
-	echo.
-	echo.If you don't have Sphinx installed, grab it from
-	echo.https://www.sphinx-doc.org/
-	exit /b 1
-)
-
-if "%1" == "" goto help
-
-%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
-goto end
-
-:help
-%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
-
-:end
-popd

docs/reference/faq.md

@@ -1,160 +0,0 @@
-# Frequently asked questions
-
-As the world’s most popular programming language, Python is powerful in its capabilities and comparatively easy to learn, yet the limitations cannot be ignored: it’s hard to install Python and all necessary dependencies; it’s glued to the backend without the ability to make apps or websites; and it’s difficult to share your work.
-
-What if we could remove those limitations, making the power of Python accessible to the masses? The makers of PyScript set out to do just that by enabling Python in the browser for frontend web and application development. No more complicated installs. Projects can be shared with anyone, anywhere—all you need is a browser.
-
-We are fully leaning into the idea that the browser is the most ubiquitous VM by using Python to build a graphical, programmable OS on top to make and share applications. Harness the full power of canvas, webGL, WASI, and even in-browser support for P2P and CRDTs for serverless data sharing and collaboration.
-
-> “This is the exciting beginning for supporting new ways of programming, building, sharing, and deploying applications. Ultimately, we should be spending our time thinking and writing applications to solve the real problems we have, not dealing with mundane, hardware-induced challenges. Let's make programming more fun and simple.” - Fabio Pliger
-
-## Why PyScript?
-
-Exponentially expand accessibility and use cases for Python by enabling Python in the browser for building UIs. Reproduce environments without having to download Python or conda or install other packages. Projects can be shared with anyone and deployed anywhere—all you need is a browser and a web-accessible device (computer, tablet, or mobile).
-
-We are fully leaning into the idea that the browser is the most ubiquitous VM by using Python to build a graphical, programmable operating system on top of the browser to make and share applications. Harness the full power of canvas, webGL, WASI, and even in-browser support for P2P and CRDTs for serverless data sharing and collaboration.
-
-- [PyCon US 2022 Keynote with Peter Wang](https://anaconda.cloud/pyscript-pycon2022-peter-wang-keynote)
-- [Example demos from Keynote](https://pyscript.net/examples/index.html)
-
-## What is PyScript?
-
-PyScript is a framework that allows users to create rich Python applications in the browser using HTML's interface and the power of [Pyodide — Version 0.20.0](https://pyodide.org/en/stable/), [WebAssembly](https://webassembly.org/), and modern web technologies. The PyScript framework provides users at every experience level with access to an expressive, easy-to-learn programming language with countless applications.
-
-What is PyScript? Well, here are some of the core components:
-
-- Python in the browser: Enable drop-in content, external file hosting, and application hosting without the reliance on server-side configuration
-
-- Python ecosystem: Run many popular packages of Python and the scientific stack (such as numpy, pandas, scikit-learn, and more)
-
-- Python with JavaScript: Bi-directional communication between Python and Javascript objects and namespaces
-
-- Environment management: Allow users to define what packages and files to include for the page code to run
-
-- Visual application development: Use readily available curated UI components, such as buttons, containers, text boxes, and more
-
-- Flexible framework: A flexible framework that can be leveraged to create and share new pluggable and extensible components directly in Python
-
-All that to say... PyScript is just HTML, only a bit (okay, maybe a lot) more powerful, thanks to the rich and accessible ecosystem of Python libraries.
-
-In short, our mission is to enable programming for the 99%.
-
-## How can a user get started?
-
-Leveraging Python in HTML is literally as simple as adding a few lines of code to your page. The best place to learn more, get started, and stay updated on all things PyScript is [Pyscript.net](http://pyscript.net/). Additional shareable resources below:
-
-- [PyScript Repo](https://github.com/pyscript/pyscript)
-- [PyScript Announcement Blog](https://www.anaconda.com/blog/pyscript-python-in-the-browser)
-- [PyScript Technical Blog](https://engineering.anaconda.com/2022/04/welcome-pyscript.html)
-- [PyScript Nucleus Project](https://anaconda.cloud/s/pyscript)
-- [PyScript Documentation](https://docs.pyscript.net/)
-
-## Why isn't this going to be as terrible as PHP?
-
-This comparison is based on both PHP and PyScript having a similar way of declaring things: put a tag on the page and the interpreter handles it. PHP works on the server side and is itself a whole different programming language that has its own directives and semantics.
-
-The choice of using tags to allow people to execute Python is explicit; even if this functionality is similar to PHP, it works differently. First of all, everything runs in the browser itself rather than going to the server side. Secondly, PyScript lives close to the text and allows changes to be made to the visual elements. The PyScript REPL can generate output, plus it provides additional visual elements like buttons, titles, and input boxes. PyScript functions as a framework that generates UIs that makes sense as a tag in the html code.
-
-Currently, both PHP and PyScript operate with only one namespace. However, PyScript will soon support multiple namespaces and different types of isolation of code (scope), along with support for languages beyond Python.
-
-## Why not just learn JavaScript?
-
-JavaScript is not only a different language from python, but a challenging language at that. With PyScript, you now have two languages to choose from, with even more on the roadmap. PyScript allows you to use both libraries and makes JavaScript and Python compatible with one another.
-
-Python is incredibly powerful, super intuitive, and easy to learn. By adding Python to your toolkit, you can use Numpy, SciPy, Pandas, and more, seamlessly. One tradeoff is longer download times, so it isn’t the right tool for everything—but where it is the right tool, it’s almost irreplaceable.
-
-Ultimately, PyScript will enable the use of a variety of languages, offer a standard set of components that is well linked to the REPLs, and allow you to do an introspection on the code base—you can have, for example, a *modifiable* chart as a python object.
-
-## Will PyScript replace JavaScript?
-
-No. PyScript allows Python to leverage HTML, CSS, and JavaScript conventions to build elegant UIs and address general web application building, packaging, distribution, and deployment challenges (a huge pain). We expect the popularity and adoption of HTML, CSS, and JavaScript to rise alongside Python, ultimately making the web a more friendly and hackable place for everyone. That said, we do believe:
-
-- PyScript will displace some use cases that people have to rely on Javascript for now
-- PyScript will heavily leverage and interface with existing powerful, feature-full JS libraries, as appropriate
-- PyScript will open up web programming to tens of millions of people who would otherwise not have touched JavaScript; so in this way, it will outpace JavaScript
-
-But none of these above scenarios lead to a situation where "PyScript replaces all existing JavaScript." Just as Python itself didn't replace C, C++, or Java. But, it did take a LOT of market share for new use cases where those languages would otherwise have been used.
-
-## What is the difference between PyScript and Pyodide?
-
-![pyodide-pyscript](../img/pyodide-pyscript.png)
-
-PyScript provides HTML tags for embedding and executing Python code in your browser. As a ‘glue’ framework, it sits on top of a variety of tools and provides users access to Pyodide, the WebAssembly port of CPython, which is compiled using Emscripten. In other words, Pyodide enables PyScript users to take advantage of real CPython on the browser.
-
-Together, PyScript and Pyodide allow users to author applications by turning the browser into a code deployment tool that anyone can learn to use.
-
-With respect to the UI, PyScript is opinionated and purposeful, while Pyodide is agnostic, unopinionated, and intended for more general use.
-
-## What packages can I use? Can I use anything from PyPI?
-
-You can use anything within the Pyodide library, and pure python packages from PyPi that do not contain C dependencies should be supported by Pyodide.
-
-There is a list of packages built in Pyodide in [Packages built in Pyodide — Version 0.20.0](https://pyodide.org/en/stable/usage/packages-in-pyodide.html) (these are mostly packages with C extensions). You can also install pure Python packages from PyPI or custom URLs, assuming they have a wheel.
-
-In general, Pyodide doesn’t support all Python features—not because of Pyodide itself, but because some concepts just work differently on the browser (think of sockets/websockets, IO, threading, etc.). If it’s a pure python package that doesn’t have any non-supported features, you should expect it to work. If it has C dependencies, etc., don’t expect it to work unless someone builds/ports them. A lot of the features that don’t work can be made to work, but it will take human power to fix. For example, the PyTorch community wanted those features to work, so they rallied around it to make it happen. Expect the set of libraries that work to grow quickly given the volume of package builds coming from the community.
-
-## This package XXX is not supported because it has C dependencies. How can I make it work?
-
-See [Creating a Pyodide package — Version 0.20.0](https://pyodide.org/en/stable/development/new-packages.html).
-
-## Why is PyScript loading so slowly? Why can’t we put things behind a CDN?
-
-Packages are already served from the JsDelivr CDN. This is not a downloading speed problem—it's WASM assembly time. PyScript loads slowly because the Python standard library and packages are large and WebAssembly code needs to be compiled and run by the browser after they are loaded for the first time.
-
-Currently, there are efforts to mitigate the problem, and Pyodide is currently working on a bundler, for instance.
-
-## Is PyScript owned by Anaconda?
-
-Anaconda doesn’t own PyScript. It is an open source project developed by Anaconda internally, and Anaconda team members are currently the main contributors, but the repo itself is public. We are working on a steering council to ensure the project stays public and owned by the community.
-
-See [Maintainers](../concepts/governance/maintainers.md).
-
-See [Governance Policy](../concepts/governance/policy.md).
-
-## What is the governing model for PyScript?
-
-See [Governance Policy](../concepts/governance/policy.md).
-
-## What is the license?
-
-PyScript uses the Apache-2.0 license.
-
-Pyodide uses MPL-2.0 license. Various packages are distributed under their corresponding license.
-
-## Is Pyodide a replacement for CPython? How does PyScript and Pyodide compare to CPython on WASM?
-
-No. They have different elements that do different things, both of which are additive.
-
-PyScript sits on top of everything. Pyodide came before the work on CPython and WASM. Patches were created in order for it to work, but now that CPython/WASM are progressing, Pyodide is able to remove a few of those patches. Additionally, CPython doesn’t deal with building Python packages for WASM. WASM related work on upstream CPython will integrate into Pyodide in the near future.
-
-For a list of differences from “standard” CPython, see [Pyodide Python compatibility — Version 0.20.0](https://pyodide.org/en/stable/usage/wasm-constraints.html).
-
-## Hasn’t this already been done before by Brython/skulpt?
-
-No. Brython and Skulpt accomplish different things than PyScript and Pyodide.
-
-Brython is client-side and functions as syntax on top of Javascript—it is a reimplementation of Python on top of Javascript, without support for packages or a file system. The extraction of a package in normal Python has been replaced completely by something else. You should be able to run code with minimal changes; however, that isn’t possible with Brython.
-
-Skulpt is a cross compiler from Python to Javascript, leveraged for compatibility with the Python ecosystem. If you want to do any more Python, you would have to send it over.
-
-Fairly similar syntax to normal Python, but not exactly the same. If Brython was an interpreter and a full Python implementation, it could be used with PyScript to leverage packages like Numpy, but that isn’t possible as it stands today. They do have the Python script tag, but it is a smaller API and not as feature rich—which is why PyScript is built on Pyodide, Emscripten, and WebAssembly.
-
-## How can I contribute/help?
-
-**PyScript** - we are currently working on building documentation and a contributing guide. In the meantime, just ask to help on the PyScript [discussions page](https://anaconda.cloud/s/pyscript) or in the [repo](http://github.com/pyscript/pyscript).
-
-**Pyodide** - refer to [Pyodide docs](https://pyodide.org/en/stable/development/contributing.html).
-
-## WebAssembly Security
-
-See [WebAssembly docs](https://webassembly.org/docs/security/).
-
-## Why don’t Requests and Black work?
-
-Requests and Black do not work out of the box because they weren’t meant for the browser. On the browser, sockets multiprocessing works differently, so there is work to be done to actually match things.
-
-For Black, it’s a design choice that can be patched. This is currently being addressed by the team at Pyodide.
-
-Requests do not work because of the sockets issue (sockets and websockets are two different things) and requests are blocking—which you don’t want in the browser. It’ll require putting the runtime on a webworker and utilizing an assistant, but on the main thread it’s unlikely that it’ll work.
-
-There are options as a path forward. For example, Requests can be leveraged using javascript libraries, or building a python async version of Requests API or a python wrapper for fetch (pyfetch), etc. The websockets library has a client side that could be made to work—given that it has all asynchronous APIs, there’s nothing fundamentally difficult about getting it to work.

docs/reference/index.md

@@ -1,11 +0,0 @@
-# Reference
-
-This reference section will have manually documented or fully
-automated code documentation. **Coming soon!**
-
-```{toctree}
----
-maxdepth: 1
-glob:
----
-faq

docs/robots.txt

@@ -1,5 +0,0 @@
-User-agent: *
-Disallow: /review/
-
-Sitemap: https://docs.pyscript.net/sitemap.xml
-Host: docs.pyscript.net

docs/tutorials/deployment.md

@@ -1,3 +0,0 @@
-# Deployment
-
-**Coming soon!**

docs/tutorials/getting-started.md

@@ -1,267 +0,0 @@
-# Getting started with PyScript
-
-This page will guide you through getting started with PyScript.
-
-## Development setup
-
-PyScript does not require any development environment other
-than a web browser. We recommend using [Chrome](https://www.google.com/chrome/).
-
-If you're using [VSCode](https://code.visualstudio.com/), the
-[Live Server extension](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer)
-can be used to reload the page as you edit the HTML file.
-
-## Installation
-
-There is no installation required. In this document, we'll use
-the PyScript assets served on https://pyscript.net.
-
-If you want to download the source and build it yourself, follow
-the instructions in the [README.md](https://github.com/pyscript/pyscript/blob/main/README.md) file.
-
-## Your first PyScript HTML file
-
-Here's a "Hello, world!" example using PyScript.
-
-Using your favorite editor, create a new file called `hello.html` in
-the same directory as your PyScript, JavaScript, and CSS files with the
-following content, and open the file in your web browser. You can typically
-open an HTML by double-clicking it in your file explorer.
-
-```html
-<html>
-  <head>
-    <link rel="stylesheet" href="https://pyscript.net/alpha/pyscript.css" />
-    <script defer src="https://pyscript.net/alpha/pyscript.js"></script>
-  </head>
-  <body> <py-script> print('Hello, World!') </py-script> </body>
-</html>
-```
-
-Notice the use of the `<py-script>` tag in the HTML body. This
-is where you'll write your Python code. In the following sections, we'll
-introduce the eight tags provided by PyScript.
-
-## The py-script tag
-
-The `<py-script>` tag lets you execute multi-line Python scripts and
-print back onto the page. For example, we can compute π.
-
-```html
-<html>
-  <head>
-    <link rel="stylesheet" href="https://pyscript.net/alpha/pyscript.css" />
-    <script defer src="https://pyscript.net/alpha/pyscript.js"></script>
-  </head>
-  <body>
-      <py-script>
-        print("Let's compute π:")
-        def compute_pi(n):
-            pi = 2
-            for i in range(1,n):
-                pi *= 4 * i ** 2 / (4 * i ** 2 - 1)
-            return pi
-
-        pi = compute_pi(100000)
-        s = f"π is approximately {pi:.3f}"
-        print(s)
-      </py-script>
-  </body>
-</html>
-```
-
-### Writing into labeled elements
-
-In the example above, we had a single `<py-script>` tag printing
-one or more lines onto the page in order. Within the `<py-script>`, you
-have access to the `pyscript` module, which provides a `.write()` method
-to send strings into labeled elements on the page.
-
-For example, we'll add some style elements and provide placeholders for
-the `<py-script>` tag to write to.
-
-```html
-<html>
-    <head>
-      <link rel="stylesheet" href="https://pyscript.net/alpha/pyscript.css" />
-      <script defer src="https://pyscript.net/alpha/pyscript.js"></script>
-      <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css" rel="stylesheet" crossorigin="anonymous">
-    </head>
-
-  <body>
-    <b><p>Today is <u><label id='today'></label></u></p></b>
-    <br>
-    <div id="pi" class="alert alert-primary"></div>
-    <py-script>
-      import datetime as dt
-      pyscript.write('today', dt.date.today().strftime('%A %B %d, %Y'))
-
-      def compute_pi(n):
-          pi = 2
-          for i in range(1,n):
-              pi *= 4 * i ** 2 / (4 * i ** 2 - 1)
-          return pi
-
-      pi = compute_pi(100000)
-      pyscript.write('pi', f'π is approximately {pi:.3f}')
-    </py-script>
-  </body>
-</html>
-```
-
-## The py-env tag
-
-In addition to the [Python Standard Library](https://docs.python.org/3/library/) and
-the `pyscript` module, many 3rd-party OSS packages will work out-of-the-box with PyScript.
-
-In order to use them, you will need to declare the dependencies using the `<py-env>` tag in the
-HTML head. You can also link to `.whl` files directly on disk like in our [toga example](https://github.com/pyscript/pyscript/blob/main/examples/toga/freedom.html).
-
-```
-<py-env>
-- './static/wheels/travertino-0.1.3-py3-none-any.whl'
-</py-env>
-```
-
-If your `.whl` is not a pure Python wheel, then open a PR or issue with [pyodide](https://github.com/pyodide/pyodide) to get it added [here](https://github.com/pyodide/pyodide/tree/main/packages).
-If there's enough popular demand, the pyodide team will likely work on supporting your package. Regardless, things will likely move faster if you make the PR and consult with the team to get unblocked.
-
-For example, NumPy and Matplotlib are available. Notice here we're using `<py-script output="plot">`
-as a shortcut, which takes the expression on the last line of the script and runs `pyscript.write('plot', fig)`.
-
-```html
-<html>
-    <head>
-      <link rel="stylesheet" href="https://pyscript.net/alpha/pyscript.css" />
-      <script defer src="https://pyscript.net/alpha/pyscript.js"></script>
-      <py-env>
-        - numpy
-        - matplotlib
-      </py-env>
-    </head>
-
-  <body>
-    <h1>Let's plot random numbers</h1>
-    <div id="plot"></div>
-    <py-script output="plot">
-      import matplotlib.pyplot as plt
-      import numpy as np
-
-      x = np.random.randn(1000)
-      y = np.random.randn(1000)
-
-      fig, ax = plt.subplots()
-      ax.scatter(x, y)
-      fig
-    </py-script>
-  </body>
-</html>
-```
-
-### Local modules
-
-In addition to packages, you can declare local Python modules that will
-be imported in the `<py-script>` tag. For example, we can place the random
-number generation steps in a function in the file `data.py`.
-
-```python
-# data.py
-import numpy as np
-
-
-def make_x_and_y(n):
-    x = np.random.randn(n)
-    y = np.random.randn(n)
-    return x, y
-```
-
-In the HTML tag `<py-env>`, paths to local modules are provided in the
-`paths:` key.
-
-```html
-<html>
-    <head>
-      <link rel="stylesheet" href="https://pyscript.net/alpha/pyscript.css" />
-      <script defer src="https://pyscript.net/alpha/pyscript.js"></script>
-      <py-env>
-        - numpy
-        - matplotlib
-        - paths:
-          - ./data.py
-      </py-env>
-    </head>
-
-  <body>
-    <h1>Let's plot random numbers</h1>
-    <div id="plot"></div>
-    <py-script output="plot">
-      import matplotlib.pyplot as plt
-      from data import make_x_and_y
-
-      x, y = make_x_and_y(n=1000)
-
-      fig, ax = plt.subplots()
-      ax.scatter(x, y)
-      fig
-    </py-script>
-  </body>
-</html>
-```
-## The py-repl tag
-
-The `<py-repl>` tag creates a REPL component that is rendered to the page as a code editor, allowing you to write executable code inline.
-```html
-<html>
-  <head>
-    <link rel="stylesheet" href="https://pyscript.net/alpha/pyscript.css" />
-    <script defer src="https://pyscript.net/alpha/pyscript.js"></script>
-  </head>
-  <py-repl></py-repl>
-</html>
-```
-
-## The py-config tag
-
-Use the `<py-config>` tag to set and configure general metadata about your PyScript application in YAML format. If you are unfamiliar with YAML, consider reading [Red Hat's YAML for beginners](https://www.redhat.com/sysadmin/yaml-beginners) guide for more information.
-
-The `<py-config>` tag can be used as follows:
-
-```html
-<py-config>
-  autoclose_loader: false
-  runtimes:
-    - src: "https://cdn.jsdelivr.net/pyodide/v0.20.0/full/pyodide.js"
-      name: pyodide-0.20
-      lang: python
-</py-config>
-```
-
-The following optional values are supported by `<py-config>`:
-| Value | Type | Description |
-| ------ | ---- | ----------- |
-| `autoclose_loader` | boolean | If false, PyScript will not close the loading splash screen when the startup operations finish. |
-| `name` | string | Name of the user application. This field can be any string and is to be used by the application author for their own customization purposes. |
-| `version` | string | Version of the user application. This field can be any string and is to be used by the application author for their own customization purposes. It is not related to the PyScript version. |
- | `runtimes` | List of Runtimes | List of runtime configurations, described below.
-
- A runtime configuration consists of the following:
-| Value | Type | Description |
-| ----- | ---- | ----------- |
-| `src` | string (Required) | URL to the runtime source. |
-| `name` | string | Name of the runtime. This field can be any string and is to be used by the application author for their own customization purposes |
-| `lang` | string | Programming language supported by the runtime. This field can be used by the application author to provide clarification. It currently has no implications on how PyScript behaves. |
-
-## Visual component tags
-
-The following tags can be used to add visual attributes to your HTML page.
-
-| Tag             | Description |
-| ---             | ----------- |
-| `<py-inputbox>` | Adds an input box that can be used to prompt users to enter input values. |
-| `<py-box>`      | Creates a container object that can be used to host one or more visual components that define how elements of `<py-box>` should align and show on the page. |
-| `<py-button>`   | Adds a button to which authors can add labels and event handlers for actions on the button, such as `on_focus` or `on_click`. |
-| `<py-title>`    | Adds a static text title component that styles the text inside the tag as a page title. |
-
-```{note}
-All the elements above are experimental and not implemented at their full functionality. Use them with the understanding that the APIs or full support might change or be removed until the visual components are more mature.
-```

docs/tutorials/index.md

@@ -1,12 +0,0 @@
-# Tutorials
-
-This is the tutorials section for beginners.
-
-```{toctree}
----
-maxdepth: 2
----
-getting-started
-deployment
-setup
-```

docs/tutorials/setup.md

@@ -1,3 +0,0 @@
-# Setup
-
-**Coming soon!**

examples/altair.html

@@ -1,60 +0,0 @@
-<html>
-  <head>
-    <title>Altair</title>
-    <meta charset="utf-8">
-    <link rel="icon" type="image/x-icon" href="./favicon.png">
-    <link rel="stylesheet" href="https://pyscript.net/alpha/pyscript.css" />
-    <script defer src="https://pyscript.net/alpha/pyscript.js"></script>
-    <py-env>
-      - altair
-      - pandas
-      - vega_datasets
-    </py-env>
-    </head>
-    <body>
-      <div id="altair" style="width: 100%; height: 100%"></div>
-      <py-script output="altair">
-import altair as alt
-from vega_datasets import data
-
-source = data.movies.url
-
-pts = alt.selection(type="single", encodings=['x'])
-
-rect = alt.Chart(data.movies.url).mark_rect().encode(
-    alt.X('IMDB_Rating:Q', bin=True),
-    alt.Y('Rotten_Tomatoes_Rating:Q', bin=True),
-    alt.Color('count()',
-        scale=alt.Scale(scheme='greenblue'),
-        legend=alt.Legend(title='Total Records')
-    )
-)
-
-circ = rect.mark_point().encode(
-    alt.ColorValue('grey'),
-    alt.Size('count()',
-        legend=alt.Legend(title='Records in Selection')
-    )
-).transform_filter(
-    pts
-)
-
-bar = alt.Chart(source).mark_bar().encode(
-    x='Major_Genre:N',
-    y='count()',
-    color=alt.condition(pts, alt.ColorValue("steelblue"), alt.ColorValue("grey"))
-).properties(
-    width=550,
-    height=200
-).add_selection(pts)
-
-alt.vconcat(
-    rect + circ,
-    bar
-).resolve_legend(
-    color="independent",
-    size="independent"
-)
-      </py-script>
-    </body>
-</html>

examples/antigravity.html

@@ -1,20 +0,0 @@
-<html>
-  <head>
-    <title>Antigravity</title>
-    <meta charset="utf-8">
-    <link rel="icon" type="image/x-icon" href="./favicon.png">
-    <link rel="stylesheet" href="https://pyscript.net/alpha/pyscript.css" />
-    <script defer src="https://pyscript.net/alpha/pyscript.js"></script>
-  </head>
-  <py-env>
-- paths:
-  - ./antigravity.py
-  </py-env>
-  <body>
-    <b>Based on xkcd: antigravity https://xkcd.com/353/.</b>
-    <py-script>
-import antigravity
-antigravity.fly()
-    </py-script>
-  </body>
-</html>

examples/antigravity.py

@@ -1,45 +0,0 @@
-import random
-import sys
-
-from js import DOMParser, document, setInterval
-from pyodide import create_proxy
-from pyodide.http import open_url
-
-
-class Antigravity:
-
-    url = "./antigravity.svg"
-
-    def __init__(self, target=None, interval=10, append=True, fly=False):
-        target = target or sys.stdout._out
-        self.target = (
-            document.getElementById(target) if isinstance(target, str) else target
-        )
-        doc = DOMParser.new().parseFromString(
-            open_url(self.url).read(), "image/svg+xml"
-        )
-        self.node = doc.documentElement
-        if append:
-            self.target.append(self.node)
-        else:
-            self.target.replaceChildren(self.node)
-        self.xoffset, self.yoffset = 0, 0
-        self.interval = interval
-        if fly:
-            self.fly()
-
-    def fly(self):
-        setInterval(create_proxy(self.move), self.interval)
-
-    def move(self):
-        char = self.node.getElementsByTagName("g")[1]
-        char.setAttribute("transform", f"translate({self.xoffset}, {-self.yoffset})")
-        self.xoffset += random.normalvariate(0, 1) / 20
-        if self.yoffset < 50:
-            self.yoffset += 0.1
-        else:
-            self.yoffset += random.normalvariate(0, 1) / 20
-
-
-_auto = Antigravity(append=True)
-fly = _auto.fly

examples/assets/css/index.css

@@ -1,51 +0,0 @@
-.example {
-    margin-bottom: 5rem;
-}
-
-.example h2{
-    color: #000000;
-    font-family: "Inconsolata", monospace;
-    font-size: 2.25rem;
-    margin-bottom: 1rem;
-}
-
-.card {
-    height: 15rem;
-    background-color: #FFFFFF;
-    padding: 1rem;
-    -webkit-box-shadow: var(--card-shadow);
-    box-shadow: var(--card-shadow);
-}
-
-.card a h2 {
-    color: var(--color-primary);
-    margin: 0;
-    font-family: "Inconsolata", monospace;
-    font-size: 2.25rem;
-}
-
-.card-content {
-    height: 100%;
-    display: flex;
-    flex-direction: column;
-    justify-content: space-between;
-}
-
-.container-card {
-    max-width: 1500px;
-    margin: 0 auto;
-    display: grid;
-    gap: 1rem;
-}
-
-@media (min-width: 600px) {
-    .container-card {
-        grid-template-columns: repeat(2, 1fr);
-    }
-}
-
-@media (min-width: 900px) {
-    .container-card {
-        grid-template-columns: repeat(4, 1fr);
-    }
-}

examples/assets/css/main.css

@@ -1,17 +0,0 @@
-@import url("https://fonts.googleapis.com/css2?family=Inconsolata:wght@400;700&display=swap");
-@import "./variables.css";
-@import "./reset.css";
-
-.container {
-    max-width: 1510px;
-    margin: auto;
-    padding: 0 2rem;
-}
-
-.title-main {
-    color: #000000;
-    font-size: 4.25rem;
-    font-family: "Inconsolata", monospace;
-    text-align: center;
-    margin: 2rem 0;
-}

examples/assets/css/reset.css

@@ -1,22 +0,0 @@
-*,
-*:after,
-*:before {
-    margin: 0;
-    padding: 0;
-    box-sizing: border-box;
-    text-decoration: none;
-}
-
-body {
-    font-size: 100%;
-    list-style-type: none;
-}
-
-p {
-    font-family: "Inconsolata", monospace;
-    font-weight: 400;
-}
-
-a {
-    text-decoration: none;
-}

examples/assets/css/variables.css

@@ -1,4 +0,0 @@
-:root {
-    --color-primary: #2563eb;
-    --card-shadow: 0px 5px 11px 0px rgb(0 0 0 / 15%);
-}

examples/bokeh.html

@@ -1,48 +0,0 @@
-<html><head>
-    <title>Bokeh Example</title>
-    <meta charset="iso-8859-1">
-    <link rel="icon" type="image/x-icon" href="./favicon.png">
-    <script type="text/javascript" src="https://cdn.bokeh.org/bokeh/release/bokeh-2.4.2.min.js"></script>
-    <script type="text/javascript" src="https://cdn.bokeh.org/bokeh/release/bokeh-gl-2.4.2.min.js"></script>
-    <script type="text/javascript" src="https://cdn.bokeh.org/bokeh/release/bokeh-widgets-2.4.2.min.js"></script>
-    <script type="text/javascript" src="https://cdn.bokeh.org/bokeh/release/bokeh-tables-2.4.2.min.js"></script>
-    <script type="text/javascript" src="https://cdn.bokeh.org/bokeh/release/bokeh-mathjax-2.4.2.min.js"></script>
-
-    <script type="text/javascript">
-        Bokeh.set_log_level("info");
-    </script>
-    <link rel="stylesheet" href="https://pyscript.net/alpha/pyscript.css" />
-
-    <script defer src="https://pyscript.net/alpha/pyscript.js"></script>
-
-    </head>
-    <body>
-        <py-env>
-- bokeh
-- numpy
-        </py-env>
-        <h1>Bokeh Example</h1>
-        <div id="myplot"></div>
-
-    <py-script id="main">
-import json
-import pyodide
-
-from js import Bokeh, console, JSON
-
-from bokeh.embed import json_item
-from bokeh.plotting import figure
-from bokeh.resources import CDN
-
-# create a new plot with default tools, using figure
-p = figure(plot_width=400, plot_height=400)
-
-# add a circle renderer with x and y coordinates, size, color, and alpha
-p.circle([1, 2, 3, 4, 5], [6, 7, 2, 4, 5], size=15, line_color="navy", fill_color="orange", fill_alpha=0.5)
-p_json = json.dumps(json_item(p, "myplot"))
-
-Bokeh.embed.embed_item(JSON.parse(p_json))
-    </py-script>
-
-</body>
-</html>

examples/bokeh_interactive.html

@@ -1,98 +0,0 @@
-<html><head>
-    <title>Bokeh Example</title>
-    <meta charset="iso-8859-1">
-    <link rel="icon" type="image/x-icon" href="./favicon.png">
-    <script type="text/javascript" src="https://cdn.bokeh.org/bokeh/release/bokeh-2.4.2.js"></script>
-    <script type="text/javascript" src="https://cdn.bokeh.org/bokeh/release/bokeh-gl-2.4.2.min.js"></script>
-    <script type="text/javascript" src="https://cdn.bokeh.org/bokeh/release/bokeh-widgets-2.4.2.min.js"></script>
-    <script type="text/javascript" src="https://cdn.bokeh.org/bokeh/release/bokeh-tables-2.4.2.min.js"></script>
-    <script type="text/javascript" src="https://cdn.bokeh.org/bokeh/release/bokeh-mathjax-2.4.2.min.js"></script>
-
-    <script type="text/javascript">
-        Bokeh.set_log_level("info");
-    </script>
-    <link rel="stylesheet" href="https://pyscript.net/alpha/pyscript.css" />
-
-    <script defer src="https://pyscript.net/alpha/pyscript.js"></script>
-
-    </head>
-    <body>
-        <py-env>
-- bokeh
-- numpy
-        </py-env>
-        <h1>Bokeh Example</h1>
-        <div id="myplot"></div>
-
-	<py-script id="main">
-import asyncio
-import json
-import pyodide
-
-from js import Bokeh, console, JSON
-
-from bokeh import __version__
-from bokeh.document import Document
-from bokeh.embed.util import OutputDocumentFor, standalone_docs_json_and_render_items
-from bokeh.models import Slider, Div
-from bokeh.layouts import Row
-from bokeh.protocol.messages.patch_doc import process_document_events
-
-# create a new plot with default tools, using figure
-p = Slider(start=0.1, end=10, value=1, step=.1, title="Amplitude")
-div = Div(text=f'Amplitude is: {p.value}')
-
-def callback(attr, old, new):
-    div.text = f'Amplitude is: {new}'
-
-p.on_change('value', callback)
-
-row = Row(children=[p, div])
-
-def doc_json(model, target):
-    with OutputDocumentFor([model]) as doc:
-        doc.title = ""
-        docs_json, _ = standalone_docs_json_and_render_items(
-            [model], suppress_callback_warning=True
-        )
-
-    doc_json = list(docs_json.values())[0]
-    root_id = doc_json['roots']['root_ids'][0]
-
-    return doc, json.dumps(dict(
-        target_id = target,
-        root_id   = root_id,
-        doc       = doc_json,
-        version   = __version__,
-    ))
-
-def _link_docs(pydoc, jsdoc):
-    def jssync(event):
-        if getattr(event, 'setter_id', None) is not None:
-            return
-        events = [event]
-        json_patch = jsdoc.create_json_patch_string(pyodide.to_js(events))
-        pydoc.apply_json_patch(json.loads(json_patch))
-
-    jsdoc.on_change(pyodide.create_proxy(jssync), pyodide.to_js(False))
-
-    def pysync(event):
-        json_patch, buffers = process_document_events([event], use_buffers=True)
-        buffer_map = {}
-        for (ref, buffer) in buffers:
-            buffer_map[ref['id']] = buffer
-        jsdoc.apply_json_patch(JSON.parse(json_patch), pyodide.to_js(buffer_map), setter_id='js')
-
-    pydoc.on_change(pysync)
-
-async def show(plot, target):
-    pydoc, model_json = doc_json(plot, target)
-    views = await Bokeh.embed.embed_item(JSON.parse(model_json))
-    jsdoc = views[0].model.document
-    _link_docs(pydoc, jsdoc)
-
-await show(row, 'myplot')
-    </py-script>
-
-</body>
-</html>

examples/d3.html

@@ -1,170 +0,0 @@
-<html>
-  <head>
-    <title>d3: JavaScript & PyScript visualizations side-by-side</title>
-    <meta charset="utf-8">
-    <link rel="icon" type="image/x-icon" href="./favicon.png">
-
-    <link rel="stylesheet" href="https://pyscript.net/alpha/pyscript.css" />
-    <script defer src="https://pyscript.net/alpha/pyscript.js"></script>
-
-    <style>
-    .loading {
-      display: inline-block;
-      width: 50px;
-      height: 50px;
-      border: 3px solid rgba(255, 255, 255, 0.3);
-      border-radius: 50%;
-      border-top-color: black;
-      animation: spin 1s ease-in-out infinite;
-    }
-
-    @keyframes spin {
-      to {
-        transform: rotate(360deg);
-      }
-    }
-    </style>
-
-    </head>
-    <body>
-      <b>
-        Based on <i><a href="https://observablehq.com/@d3/learn-d3-shapes?collection=@d3/learn-d3>">Learn D3: Shapes</a></i> tutorial.
-      </b>
-      <div style="display: flex; flex-direction: row">
-        <div>
-          <div style="text-align: center">JavaScript version</div>
-          <div id="js" style="width: 400px; height: 400px">
-            <div class="loading"></div>
-          </div>
-        </div>
-        <div>
-          <div style="text-align: center">PyScript version</div>
-          <div id="py" style="width: 400px; height: 400px">
-            <div class="loading"></div>
-          </div>
-        </div>
-      </div>
-
-<script type="importmap">
-{
-  "imports": {
-    "d3": "https://cdn.skypack.dev/d3@7"
-  }
-}
-</script>
-
-<script type="module">
-import * as d3 from "https://cdn.skypack.dev/d3@7";
-
-const fruits = [
-  {name: "🍊", count: 21},
-  {name: "🍇", count: 13},
-  {name: "🍏", count: 8},
-  {name: "🍌", count: 5},
-  {name: "🍐", count: 3},
-  {name: "🍋", count: 2},
-  {name: "🍎", count: 1},
-  {name: "🍉", count: 1},
-]
-
-const fn = (d) => d.count
-const data = d3.pie().value(fn)(fruits)
-
-const arc = d3.arc()
-  .innerRadius(210)
-  .outerRadius(310)
-  .padRadius(300)
-  .padAngle(2 / 300)
-  .cornerRadius(8)
-
-const js = d3.select("#js")
-js.select(".loading").remove()
-
-const svg = js
-  .append("svg")
-  .attr("viewBox", "-320 -320 640 640")
-  .attr("width", "400")
-  .attr("height", "400")
-
-for (const d of data) {
-  svg.append("path")
-    .style("fill", "steelblue")
-    .attr("d", arc(d))
-
-  const text = svg.append("text")
-    .style("fill", "white")
-    .attr("transform", `translate(${arc.centroid(d).join(",")})`)
-    .attr("text-anchor", "middle")
-
-  text.append("tspan")
-    .style("font-size", "24")
-    .attr("x", "0").text(d.data.name)
-
-  text.append("tspan")
-    .style("font-size", "18")
-    .attr("x", "0")
-    .attr("dy", "1.3em")
-    .text(d.value)
-}
-</script>
-
-<py-script>
-from pyodide import create_proxy, to_js
-import d3
-
-fruits = [
-  dict(name="🍊", count=21),
-  dict(name="🍇", count=13),
-  dict(name="🍏", count=8),
-  dict(name="🍌", count=5),
-  dict(name="🍐", count=3),
-  dict(name="🍋", count=2),
-  dict(name="🍎", count=1),
-  dict(name="🍉", count=1),
-]
-
-fn = create_proxy(lambda d, *_: d["count"])
-data = d3.pie().value(fn)(to_js(fruits))
-
-arc = (d3.arc()
-  .innerRadius(210)
-  .outerRadius(310)
-  .padRadius(300)
-  .padAngle(2 / 300)
-  .cornerRadius(8))
-
-py = d3.select("#py")
-py.select(".loading").remove()
-
-svg = (py
-  .append("svg")
-  .attr("viewBox", "-320 -320 640 640")
-  .attr("width", "400")
-  .attr("height", "400"))
-
-for d in data:
-  d_py = d.to_py()
-
-  (svg.append("path")
-    .style("fill", "steelblue")
-    .attr("d", arc(d)))
-
-  text = (svg.append("text")
-    .style("fill", "white")
-    .attr("transform", f"translate({arc.centroid(d).join(',')})")
-    .attr("text-anchor", "middle"))
-
-  (text.append("tspan")
-    .style("font-size", "24")
-    .attr("x", "0")
-    .text(d_py["data"]["name"]))
-
-  (text.append("tspan")
-    .style("font-size", "18")
-    .attr("x", "0")
-    .attr("dy", "1.3em")
-    .text(d_py["value"]))
-</py-script>
-
-</body>
-</html>

examples/folium.html

@@ -1,49 +0,0 @@
-<html>
-  <head>
-    <title>Folium</title>
-    <meta charset="utf-8">
-    <link rel="icon" type="image/x-icon" href="./favicon.png">
-    <link rel="stylesheet" href="https://pyscript.net/alpha/pyscript.css" />
-    <script defer src="https://pyscript.net/alpha/pyscript.js"></script>
-    <py-env>
-      - folium
-      - pandas
-    </py-env>
-    </head>
-    <body>
-      <div id="folium" style="width: 100%; height: 100%"></div>
-      <py-script output="folium">
-import folium
-import json
-import pandas as pd
-
-from pyodide.http import open_url
-
-url = (
-    "https://raw.githubusercontent.com/python-visualization/folium/master/examples/data"
-)
-state_geo = f"{url}/us-states.json"
-state_unemployment = f"{url}/US_Unemployment_Oct2012.csv"
-state_data = pd.read_csv(open_url(state_unemployment))
-geo_json = json.loads(open_url(state_geo).read())
-
-m = folium.Map(location=[48, -102], zoom_start=3)
-
-folium.Choropleth(
-    geo_data=geo_json,
-    name="choropleth",
-    data=state_data,
-    columns=["State", "Unemployment"],
-    key_on="feature.id",
-    fill_color="YlGn",
-    fill_opacity=0.7,
-    line_opacity=0.2,
-    legend_name="Unemployment Rate (%)",
-).add_to(m)
-
-folium.LayerControl().add_to(m)
-
-m
-      </py-script>
-    </body>
-</html>

examples/fractals.py

@@ -1,139 +0,0 @@
-import numpy as np
-from numpy.polynomial import Polynomial
-
-
-def mandelbrot(
-    width: int,
-    height: int,
-    *,
-    x: float = -0.5,
-    y: float = 0,
-    zoom: int = 1,
-    max_iterations: int = 100
-) -> np.array:
-    """
-    https://www.learnpythonwithrune.org/numpy-compute-mandelbrot-set-by-vectorization
-    """
-    # To make navigation easier we calculate these values
-    x_width, y_height = 1.5, 1.5 * height / width
-    x_from, x_to = x - x_width / zoom, x + x_width / zoom
-    y_from, y_to = y - y_height / zoom, y + y_height / zoom
-
-    # Here the actual algorithm starts
-    x = np.linspace(x_from, x_to, width).reshape((1, width))
-    y = np.linspace(y_from, y_to, height).reshape((height, 1))
-    c = x + 1j * y
-
-    # Initialize z to all zero
-    z = np.zeros(c.shape, dtype=np.complex128)
-
-    # To keep track in which iteration the point diverged
-    div_time = np.zeros(z.shape, dtype=int)
-
-    # To keep track on which points did not converge so far
-    m = np.full(c.shape, True, dtype=bool)
-    for i in range(max_iterations):
-        z[m] = z[m] ** 2 + c[m]
-        diverged = np.greater(
-            np.abs(z), 2, out=np.full(c.shape, False), where=m
-        )  # Find diverging
-        div_time[diverged] = i  # set the value of the diverged iteration number
-        m[np.abs(z) > 2] = False  # to remember which have diverged
-
-    return div_time
-
-
-def julia(
-    width: int,
-    height: int,
-    *,
-    c: complex = -0.4 + 0.6j,
-    x: float = 0,
-    y: float = 0,
-    zoom: int = 1,
-    max_iterations: int = 100
-) -> np.array:
-    """
-    https://www.learnpythonwithrune.org/numpy-calculate-the-julia-set-with-vectorization
-    """
-    # To make navigation easier we calculate these values
-    x_width, y_height = 1.5, 1.5 * height / width
-    x_from, x_to = x - x_width / zoom, x + x_width / zoom
-    y_from, y_to = y - y_height / zoom, y + y_height / zoom
-
-    # Here the actual algorithm starts
-    x = np.linspace(x_from, x_to, width).reshape((1, width))
-    y = np.linspace(y_from, y_to, height).reshape((height, 1))
-    z = x + 1j * y
-
-    # Initialize z to all zero
-    c = np.full(z.shape, c)
-
-    # To keep track in which iteration the point diverged
-    div_time = np.zeros(z.shape, dtype=int)
-
-    # To keep track on which points did not converge so far
-    m = np.full(c.shape, True, dtype=bool)
-    for i in range(max_iterations):
-        z[m] = z[m] ** 2 + c[m]
-        m[np.abs(z) > 2] = False
-        div_time[m] = i
-
-    return div_time
-
-
-Range = tuple[float, float]
-
-
-def newton(
-    width: int,
-    height: int,
-    *,
-    p: Polynomial,
-    a: complex,
-    xr: Range = (-2.5, 1),
-    yr: Range = (-1, 1),
-    max_iterations: int = 100
-) -> tuple[np.array, np.array]:
-    """ """
-    # To make navigation easier we calculate these values
-    x_from, x_to = xr
-    y_from, y_to = yr
-
-    # Here the actual algorithm starts
-    x = np.linspace(x_from, x_to, width).reshape((1, width))
-    y = np.linspace(y_from, y_to, height).reshape((height, 1))
-    z = x + 1j * y
-
-    # Compute the derivative
-    dp = p.deriv()
-
-    # Compute roots
-    roots = p.roots()
-    epsilon = 1e-5
-
-    # Set the initial conditions
-    a = np.full(z.shape, a)
-
-    # To keep track in which iteration the point diverged
-    div_time = np.zeros(z.shape, dtype=int)
-
-    # To keep track on which points did not converge so far
-    m = np.full(a.shape, True, dtype=bool)
-
-    # To keep track which root each point converged to
-    r = np.full(a.shape, 0, dtype=int)
-
-    for i in range(max_iterations):
-        z[m] = z[m] - a[m] * p(z[m]) / dp(z[m])
-
-        for j, root in enumerate(roots):
-            converged = (np.abs(z.real - root.real) < epsilon) & (
-                np.abs(z.imag - root.imag) < epsilon
-            )
-            m[converged] = False
-            r[converged] = j + 1
-
-        div_time[m] = i
-
-    return div_time, r

examples/handtrack/say_hello.html

@@ -1,122 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width,initial-scale=1" />
-
-    <title>Svelte app</title>
-
-    <link rel="icon" type="image/png" href="../favicon.png" />
-    <link rel="stylesheet" href="../https://pyscript.net/alpha/pyscript.css" />
-
-    <script defer src="../https://pyscript.net/alpha/pyscript.js"></script>
-  </head>
-
-  <body>
-    <py-script>
-from js import handTrack, requestAnimationFrame
-from pyodide import create_once_callable
-import asyncio
-
-context = canvas.element.getContext("2d")
-
-isVideo = False
-model = None
-
-modelParams = {
-  "flipHorizontal": True, # flip e.g for video
-  "maxNumBoxes": 20, # maximum number of boxes to detect
-  "iouThreshold": 0.5, # ioU threshold for non-max suppression
-  "scoreThreshold": 0.6, # confidence threshold for predictions.
-}
-
-def toggle_video(evt):
-  global isVideo
-  if (not isVideo):
-    update_note.write("Starting video")
-    pyscript.run_until_complete(start_video())
-  else:
-    update_note.write("Stopping video")
-    handTrack.stopVideo(video.element)
-    isVideo = False
-    update_note.write("Video stopped")
-
-async def start_video():
-  global isVideo
-  update_note.write("Inside sstart video")
-  status = await handTrack.startVideo(video.element)
-  console.log("video started", status)
-  if status:
-    update_note.write("Video started. Now tracking")
-    isVideo = True
-    console.log( "Calling RUN DETECTION")
-    y = await run_detection()
-  else:
-    update_note.write( "Please enable video")
-
-def sync_run_detection(evt):
-  pyscript.run_until_complete(run_detection())
-
-async def run_detection():
-  console.log("in RUN DETECTION: ");
-  global model
-  global isVideo
-
-  console.log("...1")
-
-  predictions = await model.detect(video.element)
-  console.log("done...1")
-  console.log("Predictions: ", predictions);
-  model.renderPredictions(predictions, canvas.element, context, video.element);
-  console.log("is Video?", isVideo)
-  if (isVideo):
-    console.log("requestingAnimation!")
-    await requestAnimationFrame(create_once_callable(sync_run_detection));
-  console.log("...2")
-
-def run_detection_image(img):
-  console.log("in RUN DETECTION IMAGE", predictions);
-  global model
-  def detect(predition):
-    console.log("Predictions: ", predictions);
-    model.renderPredictions(predictions, canvas, context, img);
-  console.log("...3")
-  model.detect(img).then(detect)
-  console.log("...4")
-
-def handle_model(lmodel):
-  global model
-  model = lmodel
-  update_note.write("Loaded Model!")
-
-async def start():
-  console.log("creating x")
-  console.log("calling x")
-  model = await handTrack.load(modelParams)#.then(handle_model)
-  console.log("loaded model!")
-  console.log(model)
-  handle_model(model)
-  print(dir(x))
-  print(x)
-
-pyscript.run_until_complete(start())
-
-#});
-
-    </py-script>
-
-    <div class="mb10">
-      <button  id="trackbutton" class="bx--btn bx--btn--secondary" type="button" pys-onClick="toggle_video">
-        Toggle Video
-      </button>
-      <button id="nextimagebutton" class="mt10 bx--btn bx--btn--secondary" type="button" disabled>
-        Next Image
-      </button>
-      <div id="update-note" py-mount class="updatenote mt10">loading model ..</div>
-    </div>
-    <div>
-      <video autoplay="autoplay" id="myvideo" py-mount="video"></video>
-      <canvas id="canvas" py-mount class="border canvasbox"></canvas>
-    </div>
-    <script src="lib/handtrack.min.js"> </script>
-</html>

examples/hello_world.html

@@ -1,24 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width,initial-scale=1" />
-
-    <title>PyScript Hello World</title>
-
-    <link rel="icon" type="image/png" href="favicon.png" />
-    <link rel="stylesheet" href="https://pyscript.net/alpha/pyscript.css" />
-
-    <script defer src="https://pyscript.net/alpha/pyscript.js"></script>
-  </head>
-
-  <body>
-    Hello world! <br>
-    This is the current date and time, as computed by Python:
-    <py-script>
-from datetime import datetime
-now = datetime.now()
-now.strftime("%m/%d/%Y, %H:%M:%S")
-    </py-script>
-  </body>
-</html>

examples/index.html

@@ -1,290 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="utf-8" />
-  <meta name="viewport" content="width=device-width,initial-scale=1" />
-  <title>PyScript demo</title>
-  <link rel="icon" type="image/png" href="favicon.png" />
-  <link rel="stylesheet" href="./assets/css/main.css" />
-  <link rel="stylesheet" href="./assets/css/index.css" />
-</head>
-
-<body class="container">
-  <h1 class="title-main">PyScript demos</h1>
-  <section class="example">
-    <h2>Basic examples</h2>
-    <div class="container-card">
-      <div class="card">
-        <div class="card-content">
-          <a href="./hello_world.html" target="_blank">
-            <h2>Hello world</h2>
-          </a>
-          <p>
-            A static demo of the <code>&lt;py-script&gt;</code> tag
-          </p>
-        </div>
-      </div>
-
-      <div class="card">
-        <div class="card-content">
-          <a href="./simple_clock.html" target="_blank">
-            <h2>Simple clock</h2>
-          </a>
-          <p>
-            A dynamic demo of the <code>&lt;py-script&gt;</code> tag
-          </p>
-        </div>
-      </div>
-
-      <div class="card">
-        <div class="card-content">
-          <a href="./repl.html" target="_blank">
-            <h2>REPL</h2>
-          </a>
-          <p>
-            A Python REPL (Read Eval Print Loop).
-          </p>
-        </div>
-      </div>
-
-      <div class="card">
-        <div class="card-content">
-            <a href="./repl2.html" target="_blank">
-              <h2>REPL2</h2>
-             </a>
-            <p>
-              A Python REPL (Read Eval Print Loop) with slightly better formatting..
-            </p>
-          </div>
-      </div>
-
-      <div class="card">
-        <div class="card-content">
-            <a href="./todo.html" target="_blank">
-              <h2>TODO App</h2>
-            </a>
-            <p>
-              Demo showing how would a Simple TODO App would look like in PyScript</code> tag
-            </p>
-        </div>
-      </div>
-
-      <div class="card">
-        <div class="card-content">
-            <a href="./todo-pylist.html" target="_blank">
-              <h2>PyScript Native TODO App</h2>
-            </a>
-              <p>
-                Demo showing how would a Simple TODO App would look like in PyScript</code> tag
-              </p>
-          </div>
-      </div>
-    </div>
-  </section>
-
-  <section class="example">
-    <h2>MIME Rendering</h2>
-    <div class="container-card">
-      <div class="card">
-        <div class="card-content">
-            <a href="./matplotlib.html" target="_blank">
-              <h2>Matplotlib</h2>
-            </a>
-            <p>
-              Demonstrates rendering <a href="https://matplotlib.org/" target="_blank">Matplotlib</a> figure as output of the py-script tag
-            </p>
-        </div>
-      </div>
-
-      <div class="card">
-        <div class="card-content">
-            <a href="./altair.html" target="_blank">
-              <h2>
-                Altair
-              </h2>
-            </a>
-            <p>
-              Demonstrates rendering <a href="https://altair-viz.github.io/" target="_blank">Altair</a> plot as output of the py-script tag
-            </p>
-        </div>
-      </div>
-
-      <div class="card">
-        <div class="card-content">
-          <a href="./folium.html" target="_blank">
-            <h2>
-              Folium
-            </h2>
-          </a>
-          <p>
-            Demonstrates rendering
-            <a href="https://python-visualization.github.io/folium/" target="_blank">Folium</a>
-            map as output of the py-script tag
-          </p>
-        </div>
-      </div>
-    </div>
-  </section>
-
-  <section class="example">
-    <h2>JS Interaction</h2>
-    <div class="container-card">
-      <div class="card">
-        <div class="card-content">
-            <a href="./d3.html" target="_blank">
-              <h2>
-                Simple d3 visualization
-              </h2>
-            </a>
-            <p>
-              Minimal <a href="https://d3js.org/" target="_blank">D3</a>
-              demo demonstrating how to create a visualization
-            </p>
-          </div>
-      </div>
-
-      <div class="card">
-        <div class="card-content">
-            <a href="./webgl/raycaster/index.html" target="_blank">
-              <h2>
-                Webgl Icosahedron Example
-              </h2>
-            </a>
-            <p>
-              Demo showing how a Simple <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API" target="_blank">WebGL</a>
-              scene would work in PyScript</code> tag
-            </p>
-          </div>
-      </div>
-    </div>
-  </section>
-
-  <section class="example">
-    <h2>Visualizations & Dashboards</h2>
-    <div class="container-card">
-      <div class="card">
-        <div class="card-content">
-            <a href="./bokeh.html" target="_blank">
-              <h2>
-                Simple Static Bokeh Plot
-              </h2>
-            </a>
-            <p>
-              Minimal Bokeh demo demonstrating how to create a simple
-              <a href="https://bokeh.org/" target="_blank">Bokeh</a>
-              plot from code
-            </p>
-          </div>
-      </div>
-
-      <div class="card">
-        <div class="card-content">
-            <a href="./bokeh_interactive.html" target="_blank">
-              <h2 class="text-2xl font-bold text-blue-600">
-                Bokeh Interactive
-              </h2>
-            </a>
-            <p>
-              Interactive demo using a
-              <a href="https://bokeh.org/" target="_blank">Bokeh</a>
-              slider widget to dynamically change a value in the page
-              WARNING: This examples takes a little longer to load. So be patient :)
-            </p>
-        </div>
-      </div>
-
-      <div class="card">
-        <div class="card-content">
-            <a href="./panel_kmeans.html" target="_blank">
-              <h2 class="text-2xl font-bold text-blue-600">
-                KMeans Demo in Panel
-              </h2>
-            </a>
-            <p>
-              Interactive KMeans Chart using
-              <a href="https://panel.holoviz.org/" target="_blank">Panel</a>
-              WARNING: This examples takes a little longer to load. So be patient :)
-            </p>
-        </div>
-      </div>
-
-      <div class="card">
-        <div class="card-content">
-            <a href="./panel_stream.html" target="_blank">
-              <h2 class="text-2xl font-bold text-blue-600">
-                Streaming Demo in Panel
-              </h2>
-            </a>
-            <p>
-              Interactive Streaming Table and Bokeh plot using
-              <a href="https://panel.holoviz.org/" target="_blank">Panel</a>
-              WARNING: This examples takes a little longer to load. So be patient :)
-            </p>
-        </div>
-      </div>
-
-      <div class="card">
-        <div class="card-content">
-            <a href="./panel.html" target="_blank">
-              <h2 class="text-3xl font-bold text-blue-600">
-                Simple Panel Demo
-              </h2>
-            </a>
-            <p>
-              Simple demo showing
-              <a href="https://panel.holoviz.org/" target="_blank">Panel</a>
-              widgets interacting with parts of the page
-              WARNING: This examples takes a little longer to load. So be patient :)
-            </p>
-        </div>
-      </div>
-
-      <div class="card">
-        <div class="card-content">
-            <a href="./panel_deckgl.html" target="_blank">
-              <h2 class="text-2xl font-bold text-blue-600">
-                NYC Taxi Data Panel DeckGL Demo
-              </h2>
-            </a>
-            <p>
-              Interactive application exploring the NYC Taxi dataset using
-              <a href="https://panel.holoviz.org/" target="_blank">Panel</a> and <a href="https://deck.gl/" target="_blank">DeckGL</a>
-              WARNING: This examples takes a little longer to load. So be patient :)
-            </p>
-        </div>
-      </div>
-
-      <div class="card">
-        <div class="card-content">
-            <a href="./toga/freedom.html" target="_blank">
-              <h2 class="text-2xl font-bold text-blue-600">
-                Freedom Units!
-              </h2>
-            </a>
-            <p>
-              A <a href="https://beeware.org/project/projects/libraries/toga/" target="_blank">Toga</a>
-              application (a Fahrenheit to Celsius converter), rendered as a Single Page App
-            </p>
-        </div>
-      </div>
-
-      <div class="card">
-        <div class="card-content">
-            <a href="./numpy_canvas_fractals.html" target="_blank">
-              <h2 class="text-2xl font-bold text-blue-600">
-                Fractals with NumPy and canvas
-              </h2>
-            </a>
-            <p>
-              Visualization of Mandelbrot and Julia sets with
-              <a href="https://numpy.org/" target="_blank">Numpy</a> and
-              <a href="https://developer.mozilla.org/en-US/docs/Web/API/Canvas_API" target="_blank">
-                HTML5 canvas
-              </a>
-            </p>
-        </div>
-      </div>
-    </div>
-  </section>
-</body>
-</html>

examples/mario/css/game.css

@@ -1,32 +0,0 @@
-html, body, ul, li {
-  margin: 0;
-  border: 0;
-  padding: 0;
-}
-
-canvas {
-  display: block;
-  width: 762;
-  margin: 0 auto;
-  background-color: blue;
-}
-
-p {
-  text-align: center;
-}
-
-body {
-  overflow: hidden;
-  height: 100%;
-}
-
-html {
-  overflow: hidden;
-  height: 100%;
-}
-
-.info {
-  position: absolute;
-  top: 0;
-  left: 0;
-}

examples/mario/js/bcoin.js

@@ -1,45 +0,0 @@
-(function() {
-  if (typeof Mario === 'undefined')
-  window.Mario = {};
-
-  var Bcoin = Mario.Bcoin = function(pos) {
-    Mario.Entity.call(this, {
-      pos: pos,
-      sprite: level.bcoinSprite(),
-      hitbox: [0,0,16,16]
-    });
-  }
-
-  Mario.Util.inherits(Bcoin, Mario.Entity);
-
-  //I'm not sure whether it makes sense to use an array for vel and acc here
-  //in order to keep with convention, or to just use a single value, since
-  //it's literally impossible for these to move left or right.
-  Bcoin.prototype.spawn = function() {
-    sounds.coin.currentTime = 0.05;
-    sounds.coin.play();
-    this.idx = level.items.length;
-    level.items.push(this);
-    this.active = true;
-    this.vel = -12;
-    this.targetpos = this.pos[1] - 32;
-  }
-
-  Bcoin.prototype.update = function(dt) {
-    if (!this.active) return;
-
-    if (this.vel > 0 && this.pos[1] >= this.targetpos) {
-      player.coins += 1;
-      //spawn a score thingy.
-      delete level.items[this.idx];
-    }
-
-    this.acc = 0.75;
-    this.vel += this.acc;
-    this.pos[1] += this.vel;
-    this.sprite.update(dt);
-  }
-
-  Bcoin.prototype.checkCollisions = function() {;}
-
-})();

examples/mario/js/block.js

@@ -1,81 +0,0 @@
-(function() {
-  if (typeof Mario === 'undefined')
-    window.Mario = {};
-
-  //TODO: clean up the logic for sprite switching.
-  //TODO: There's a weird bug with the collision logic. Look into it.
-
-  var Block = Mario.Block = function(options) {
-    this.item = options.item;
-    this.usedSprite = options.usedSprite;
-    this.bounceSprite = options.bounceSprite;
-    this.breakable = options.breakable;
-
-    Mario.Entity.call(this, {
-      pos: options.pos,
-      sprite: options.sprite,
-      hitbox: [0,0,16,16]
-    });
-
-    this.standing = true;
-  }
-
-  Mario.Util.inherits(Block, Mario.Floor);
-
-  Block.prototype.break = function() {
-    sounds.breakBlock.play();
-    (new Mario.Rubble()).spawn(this.pos);
-    var x = this.pos[0] / 16, y = this.pos[1] / 16;
-    delete level.blocks[y][x];
-  }
-
-  Block.prototype.bonk = function(power) {
-    sounds.bump.play();
-    if (power > 0 && this.breakable) {
-      this.break();
-    } else if (this.standing){
-      this.standing = false;
-      if (this.item) {
-        this.item.spawn();
-        this.item = null;
-      }
-      this.opos = [];
-      this.opos[0] = this.pos[0];
-      this.opos[1] = this.pos[1];
-      if (this.bounceSprite) {
-        this.osprite = this.sprite;
-        this.sprite = this.bounceSprite;
-      } else {
-        this.sprite = this.usedSprite;
-      }
-
-      this.vel[1] = -2;
-    }
-  }
-
-  Block.prototype.update = function(dt, gameTime) {
-    if (!this.standing) {
-      if (this.pos[1] < this.opos[1] - 8) {
-        this.vel[1] = 2;
-      }
-      if (this.pos[1] > this.opos[1]) {
-        this.vel[1] = 0;
-        this.pos = this.opos;
-        if (this.osprite) {
-          this.sprite = this.osprite;
-        }
-        this.standing = true;
-      }
-    } else {
-      if (this.sprite === this.usedSprite) {
-        var x = this.pos[0] / 16, y = this.pos[1] / 16;
-        level.statics[y][x] = new Mario.Floor(this.pos, this.usedSprite);
-        delete level.blocks[y][x];
-      }
-    }
-
-    this.pos[1] += this.vel[1];
-    this.sprite.update(dt, gameTime);
-  }
-
-})();

examples/mario/js/coin.js

@@ -1,47 +0,0 @@
-(function() {
-  if (typeof Mario === 'undefined')
-  window.Mario = {};
-
-  var Coin = Mario.Coin = function(pos, sprite) {
-    Mario.Entity.call(this, {
-      pos: pos,
-      sprite: sprite,
-      hitbox: [0,0,16,16]
-    });
-    this.idx = level.items.length
-  }
-
-  Mario.Util.inherits(Coin, Mario.Entity);
-
-  Coin.prototype.isPlayerCollided = function() {
-    //the first two elements of the hitbox array are an offset, so let's do this now.
-    var hpos1 = [this.pos[0] + this.hitbox[0], this.pos[1] + this.hitbox[1]];
-    var hpos2 = [player.pos[0] + player.hitbox[0], player.pos[1] + player.hitbox[1]];
-
-    //if the hitboxes actually overlap
-    if (!(hpos1[0] > hpos2[0]+player.hitbox[2] || (hpos1[0]+this.hitbox[2] < hpos2[0]))) {
-      if (!(hpos1[1] > hpos2[1]+player.hitbox[3] || (hpos1[1]+this.hitbox[3] < hpos2[1]))) {
-        this.collect();
-      }
-    }
-  }
-
-  Coin.prototype.render = function(ctx, vX, vY) {
-    this.sprite.render(ctx, this.pos[0], this.pos[1], vX, vY);
-  }
-
-  //money is not affected by gravity, you see.
-  Coin.prototype.update = function(dt) {
-    this.sprite.update(dt);
-  }
-  Coin.prototype.checkCollisions = function() {
-    this.isPlayerCollided();
-  }
-
-  Coin.prototype.collect = function() {
-    sounds.coin.currentTime = 0.05;
-    sounds.coin.play();
-    player.coins += 1;
-    delete level.items[this.idx]
-  }
-})();

examples/mario/js/entity.js

@@ -1,34 +0,0 @@
-(function() {
-	if (typeof Mario === 'undefined')
-		window.Mario = {};
-
-	var Entity = Mario.Entity = function(options) {
-	  this.vel = [0,0];
-	  this.acc = [0,0];
-		this.standing = true;
-	  this.pos = options.pos;
-	  this.sprite = options.sprite;
-	  this.hitbox = options.hitbox;
-	  this.left = false;
-	}
-
-	Entity.prototype.render = function(ctx, vX, vY) {
-		this.sprite.render(ctx, this.pos[0], this.pos[1], vX, vY)
-	}
-
-	Entity.prototype.collideWall = function(wall) {
-		//the wall will always be a 16x16 block with hitbox = [0,0,16,16].
-		if (this.pos[0] > wall.pos[0]) {
-			//from the right
-			this.pos[0] = wall.pos[0] + wall.hitbox[2] - this.hitbox[0];
-			this.vel[0] = Math.max(0, this.vel[0]);
-			this.acc[0] = Math.max(0, this.acc[0]);
-		} else {
-			this.pos[0] = wall.pos[0] + wall.hitbox[0] - this.hitbox[2] - this.hitbox[0];
-			this.vel[0] = Math.min(0, this.vel[0]);
-			this.acc[0] = Math.min(0, this.acc[0]);
-		}
-	}
-
-	Entity.prototype.bump = function() {;}
-})();

examples/mario/js/fireball.js

@@ -1,126 +0,0 @@
-(function() {
-  if (typeof Mario === 'undefined')
-    window.Mario = {};
-
-  var Fireball = Mario.Fireball = function(pos) {
-    this.hit = 0;
-    this.standing = false;
-
-    Mario.Entity.call(this, {
-      pos: pos,
-      sprite: new Mario.Sprite('sprites/items.png', [96, 144], [8,8], 5, [0,1,2,3]),
-      hitbox: [0,0,8,8]
-    });
-  }
-
-  Mario.Util.inherits(Fireball, Mario.Entity);
-
-  Fireball.prototype.spawn = function(left) {
-    sounds.fireball.currentTime = 0;
-    sounds.fireball.play();
-    if (fireballs[0]) {
-      this.idx = 1;
-      fireballs[1] = this;
-    } else {
-      this.idx = 0;
-      fireballs[0] = this;
-    }
-    this.vel[0] = (left ? -5 : 5);
-    this.standing = false;
-    this.vel[1] = 0;
-  }
-
-  Fireball.prototype.render = function(ctx, vX, vY) {
-    this.sprite.render(ctx, this.pos[0], this.pos[1], vX, vY);
-  }
-
-  Fireball.prototype.update = function(dt) {
-    if (this.hit == 1) {
-      this.sprite.pos = [96, 160];
-      this.sprite.size = [16,16];
-      this.sprite.frames = [0,1,2];
-      this.sprite.speed = 8;
-      this.hit += 1;
-      return;
-    } else if (this.hit == 5) {
-      delete fireballs[this.idx];
-      player.fireballs -= 1;
-      return;
-    } else if (this.hit) {
-      this.hit += 1;
-      return;
-    }
-
-    //In retrospect, the way collision is being handled is RIDICULOUS
-    //but I don't have to use some horrible kludge for this.
-    if (this.standing) {
-      this.standing = false;
-      this.vel[1] = -4;
-    }
-
-    this.acc[1] = 0.5;
-
-    this.vel[1] += this.acc[1];
-    this.pos[0] += this.vel[0];
-    this.pos[1] += this.vel[1];
-    if (this.pos[0] < vX || this.pos[0] > vX + 256) {
-      this.hit = 1;
-    }
-    this.sprite.update(dt);
-  }
-
-  Fireball.prototype.collideWall = function() {
-    if (!this.hit) this.hit = 1;
-  }
-
-  Fireball.prototype.checkCollisions = function() {
-    if (this.hit) return;
-    var h = this.pos[1] % 16 < 8 ? 1 : 2;
-    var w = this.pos[0] % 16 < 8 ? 1 : 2;
-
-    var baseX = Math.floor(this.pos[0] / 16);
-    var baseY = Math.floor(this.pos[1] / 16);
-
-    if (baseY + h > 15) {
-      delete fireballs[this.idx];
-      player.fireballs -= 1;
-      return;
-    }
-
-    for (var i = 0; i < h; i++) {
-      for (var j = 0; j < w; j++) {
-        if (level.statics[baseY + i][baseX + j]) {
-          level.statics[baseY + i][baseX + j].isCollideWith(this);
-        }
-        if (level.blocks[baseY + i][baseX + j]) {
-          level.blocks[baseY + i][baseX + j].isCollideWith(this);
-        }
-      }
-    }
-
-    var that = this;
-    level.enemies.forEach(function(enemy){
-      if (enemy.flipping || enemy.pos[0] - vX > 336){ //stop checking once we get to far away dudes.
-        return;
-      } else {
-        that.isCollideWith(enemy);
-      }
-    });
-  }
-
-  Fireball.prototype.isCollideWith = function(ent) {
-    //the first two elements of the hitbox array are an offset, so let's do this now.
-    var hpos1 = [this.pos[0] + this.hitbox[0], this.pos[1] + this.hitbox[1]];
-    var hpos2 = [ent.pos[0] + ent.hitbox[0], ent.pos[1] + ent.hitbox[1]];
-
-    //if the hitboxes actually overlap
-    if (!(hpos1[0] > hpos2[0]+ent.hitbox[2] || (hpos1[0]+this.hitbox[2] < hpos2[0]))) {
-      if (!(hpos1[1] > hpos2[1]+ent.hitbox[3] || (hpos1[1]+this.hitbox[3] < hpos2[1]))) {
-        this.hit = 1;
-        ent.bump();
-      }
-    }
-  };
-
-  Fireball.prototype.bump = function() {;}
-})();

examples/mario/js/fireflower.js

@@ -1,74 +0,0 @@
-(function() {
-  if (typeof Mario === 'undefined')
-  window.Mario = {};
-
-  var Fireflower = Mario.Fireflower = function(pos) {
-    this.spawning = false;
-    this.waiting = 0;
-
-    Mario.Entity.call(this, {
-      pos: pos,
-      sprite: level.fireFlowerSprite,
-      hitbox: [0,0,16,16]
-    });
-  }
-
-  Mario.Util.inherits(Fireflower, Mario.Entity);
-
-  Fireflower.prototype.render = function(ctx, vX, vY) {
-    if (this.spawning > 1) return;
-    this.sprite.render(ctx, this.pos[0], this.pos[1], vX, vY);
-  }
-
-  Fireflower.prototype.spawn = function() {
-    sounds.itemAppear.play();
-    this.idx = level.items.length;
-    level.items.push(this);
-    this.spawning = 12;
-    this.targetpos = [];
-    this.targetpos[0] = this.pos[0];
-    this.targetpos[1] = this.pos[1] - 16;
-  }
-
-  Fireflower.prototype.update = function(dt) {
-    if (this.spawning > 1) {
-      this.spawning -= 1;
-      if (this.spawning == 1) this.vel[1] = -.5;
-      return;
-    }
-    if (this.spawning) {
-      if (this.pos[1] <= this.targetpos[1]) {
-        this.pos[1] = this.targetpos[1];
-        this.vel[1] = 0;
-        this.spawning = 0;
-      }
-    }
-
-      this.vel[1] += this.acc[1];
-      this.pos[0] += this.vel[0];
-      this.pos[1] += this.vel[1];
-      this.sprite.update(dt);
-  }
-
-  Fireflower.prototype.checkCollisions = function() {
-    if (this.spawning) {return;}
-    this.isPlayerCollided();
-  }
-
-  Fireflower.prototype.isPlayerCollided = function() {
-    //the first two elements of the hitbox array are an offset, so let's do this now.
-    var hpos1 = [this.pos[0] + this.hitbox[0], this.pos[1] + this.hitbox[1]];
-    var hpos2 = [player.pos[0] + player.hitbox[0], player.pos[1] + player.hitbox[1]];
-
-    //if the hitboxes actually overlap
-    if (!(hpos1[0] > hpos2[0]+player.hitbox[2] || (hpos1[0]+this.hitbox[2] < hpos2[0]))) {
-      if (!(hpos1[1] > hpos2[1]+player.hitbox[3] || (hpos1[1]+this.hitbox[3] < hpos2[1]))) {
-        player.powerUp(this.idx);
-      }
-    }
-  }
-
-  //This should never be called, but just in case.
-  Fireflower.prototype.bump = function() {;}
-
-})();

examples/mario/js/flag.js

@@ -1,47 +0,0 @@
-(function() {
-  if (typeof Mario === 'undefined')
-    window.Mario = {};
-
-  Flag = Mario.Flag = function(pos) {
-    //afaik flags always have the same height and Y-position
-    this.pos = [pos, 49];
-    this.hitbox = [0,0,0,0];
-    this.vel = [0,0];
-    this.acc = [0,0];
-  }
-
-  Flag.prototype.collideWall = function() {;
-  }
-
-  Flag.prototype.update = function(dt){
-    if (!this.done && this.pos[1] >= 170) {
-      this.vel = [0,0];
-      this.pos[1] = 170;
-      player.exit();
-      this.done = true;
-    }
-    this.pos[1] += this.vel[1];
-  }
-
-  Flag.prototype.checkCollisions = function() {
-    this.isPlayerCollided();
-  }
-
-  Flag.prototype.isPlayerCollided = function() {
-    if (this.hit) return;
-    if (player.pos[0] + 8 >= this.pos[0]) {
-      music.overworld.pause();
-      sounds.flagpole.play();
-      setTimeout(function() {
-        music.clear.play();
-      }, 2000);
-      this.hit = true;
-      player.flag();
-      this.vel = [0, 2];
-    }
-  }
-
-  Flag.prototype.render = function() {
-    level.flagpoleSprites[2].render(ctx, this.pos[0]-8, this.pos[1], vX, vY);
-  }
-})();

examples/mario/js/floor.js

@@ -1,56 +0,0 @@
-(function() {
-	if (typeof Mario === 'undefined')
-		window.Mario = {};
-
-	var Floor = Mario.Floor = function(pos, sprite) {
-
-		Mario.Entity.call(this, {
-			pos: pos,
-			sprite: sprite,
-			hitbox: [0,0,16,16]
-		});
-	}
-
-	Mario.Util.inherits(Floor, Mario.Entity);
-
-	Floor.prototype.isCollideWith = function (ent) {
-		//the first two elements of the hitbox array are an offset, so let's do this now.
-		var hpos1 = [Math.floor(this.pos[0] + this.hitbox[0]), Math.floor(this.pos[1] + this.hitbox[1])];
-		var hpos2 = [Math.floor(ent.pos[0] + ent.hitbox[0]), Math.floor(ent.pos[1] + ent.hitbox[1])];
-
-		//if the hitboxes actually overlap
-		if (!(hpos1[0] > hpos2[0]+ent.hitbox[2] || (hpos1[0]+this.hitbox[2] < hpos2[0]))) {
-			if (!(hpos1[1] > hpos2[1]+ent.hitbox[3] || (hpos1[1]+this.hitbox[3] < hpos2[1]))) {
-				if (!this.standing) {
-					ent.bump();
-				} else {
-					//if the entity is over the block, it's basically floor
-					var center = hpos2[0] + ent.hitbox[2] / 2;
-					if (Math.abs(hpos2[1] + ent.hitbox[3] - hpos1[1]) <= ent.vel[1]) {
-						if (level.statics[(this.pos[1] / 16) - 1][this.pos[0] / 16]) {return};
-						ent.vel[1] = 0;
-						ent.pos[1] = hpos1[1] - ent.hitbox[3] - ent.hitbox[1];
-						ent.standing = true;
-						if (ent instanceof Mario.Player) {
-							ent.jumping = 0;
-						}
-					} else if (Math.abs(hpos2[1] - hpos1[1] - this.hitbox[3]) > ent.vel[1] &&
-					center + 2 >= hpos1[0] && center - 2 <= hpos1[0] + this.hitbox[2]) {
-						//ent is under the block.
-						ent.vel[1] = 0;
-						ent.pos[1] = hpos1[1] + this.hitbox[3];
-						if (ent instanceof Mario.Player) {
-							this.bonk(ent.power);
-							ent.jumping = 0;
-						}
-					} else {
-						//entity is hitting it from the side, we're a wall
-						ent.collideWall(this);
-					}
-				}
-			}
-		}
-	}
-
-	Floor.prototype.bonk = function() {;}
-})();

examples/mario/js/game.js

@@ -1,241 +0,0 @@
-var requestAnimFrame = (function(){
-  return window.requestAnimationFrame       ||
-    window.webkitRequestAnimationFrame ||
-    window.mozRequestAnimationFrame    ||
-    window.oRequestAnimationFrame      ||
-    window.msRequestAnimationFrame     ||
-    function(callback){
-      window.setTimeout(callback, 1000 / 60);
-    };
-})();
-
-//create the canvas
-var canvas = document.createElement("canvas");
-var ctx = canvas.getContext('2d');
-var updateables = [];
-var fireballs = [];
-var player = new Mario.Player([0,0]);
-
-//we might have to get the size and calculate the scaling
-//but this method should let us make it however big.
-//Cool!
-//TODO: Automatically scale the game to work and look good on widescreen.
-//TODO: fiddling with scaled sprites looks BETTER, but not perfect. Hmm.
-canvas.width = 762;
-canvas.height = 720;
-ctx.scale(3,3);
-document.body.appendChild(canvas);
-
-//viewport
-var vX = 0,
-    vY = 0,
-    vWidth = 256,
-    vHeight = 240;
-
-//load our images
-resources.load([
-  'sprites/player.png',
-  'sprites/enemy.png',
-  'sprites/tiles.png',
-  'sprites/playerl.png',
-  'sprites/items.png',
-  'sprites/enemyr.png',
-]);
-
-resources.onReady(init);
-var level;
-var sounds;
-var music;
-
-//initialize
-var lastTime;
-function init() {
-  music = {
-    overworld: new Audio('sounds/aboveground_bgm.ogg'),
-    underground: new Audio('sounds/underground_bgm.ogg'),
-    clear: new Audio('sounds/stage_clear.wav'),
-    death: new Audio('sounds/mariodie.wav')
-  };
-  sounds = {
-    smallJump: new Audio('sounds/jump-small.wav'),
-    bigJump: new Audio('sounds/jump-super.wav'),
-    breakBlock: new Audio('sounds/breakblock.wav'),
-    bump: new Audio('sounds/bump.wav'),
-    coin: new Audio('sounds/coin.wav'),
-    fireball: new Audio('sounds/fireball.wav'),
-    flagpole: new Audio('sounds/flagpole.wav'),
-    kick: new Audio('sounds/kick.wav'),
-    pipe: new Audio('sounds/pipe.wav'),
-    itemAppear: new Audio('sounds/itemAppear.wav'),
-    powerup: new Audio('sounds/powerup.wav'),
-    stomp: new Audio('sounds/stomp.wav')
-  };
-  Mario.oneone();
-  lastTime = Date.now();
-  main();
-}
-
-var gameTime = 0;
-
-//set up the game loop
-function main() {
-  var now = Date.now();
-  var dt = (now - lastTime) / 1000.0;
-
-  update(dt);
-  render();
-
-  lastTime = now;
-  requestAnimFrame(main);
-}
-
-function update(dt) {
-  gameTime += dt;
-
-  handleInput(dt);
-  updateEntities(dt, gameTime);
-
-  checkCollisions();
-}
-
-function handleInput(dt) {
-  if (player.piping || player.dying || player.noInput) return; //don't accept input
-
-  if (input.isDown('RUN')){
-    player.run();
-  } else {
-    player.noRun();
-  }
-  if (input.isDown('JUMP')) {
-    player.jump();
-  } else {
-    //we need this to handle the timing for how long you hold it
-    player.noJump();
-  }
-
-  if (input.isDown('DOWN')) {
-    player.crouch();
-  } else {
-    player.noCrouch();
-  }
-
-  if (input.isDown('LEFT')) { // 'd' or left arrow
-    player.moveLeft();
-  }
-  else if (input.isDown('RIGHT')) { // 'k' or right arrow
-    player.moveRight();
-  } else {
-    player.noWalk();
-  }
-}
-
-//update all the moving stuff
-function updateEntities(dt, gameTime) {
-  player.update(dt, vX);
-  updateables.forEach (function(ent) {
-    ent.update(dt, gameTime);
-  });
-
-  //This should stop the jump when he switches sides on the flag.
-  if (player.exiting) {
-    if (player.pos[0] > vX + 96)
-      vX = player.pos[0] - 96
-  }else if (level.scrolling && player.pos[0] > vX + 80) {
-    vX = player.pos[0] - 80;
-  }
-
-  if (player.powering.length !== 0 || player.dying) { return; }
-  level.items.forEach (function(ent) {
-    ent.update(dt);
-  });
-
-  level.enemies.forEach (function(ent) {
-    ent.update(dt, vX);
-  });
-
-  fireballs.forEach(function(fireball) {
-    fireball.update(dt);
-  });
-  level.pipes.forEach (function(pipe) {
-    pipe.update(dt);
-  });
-}
-
-//scan for collisions
-function checkCollisions() {
-  if (player.powering.length !== 0 || player.dying) { return; }
-  player.checkCollisions();
-
-  //Apparently for each will just skip indices where things were deleted.
-  level.items.forEach(function(item) {
-    item.checkCollisions();
-  });
-  level.enemies.forEach (function(ent) {
-    ent.checkCollisions();
-  });
-  fireballs.forEach(function(fireball){
-    fireball.checkCollisions();
-  });
-  level.pipes.forEach (function(pipe) {
-    pipe.checkCollisions();
-  });
-}
-
-//draw the game!
-function render() {
-  updateables = [];
-  ctx.clearRect(0, 0, canvas.width, canvas.height);
-  ctx.fillStyle = level.background;
-  ctx.fillRect(0, 0, canvas.width, canvas.height);
-
-  //scenery gets drawn first to get layering right.
-  for(var i = 0; i < 15; i++) {
-    for (var j = Math.floor(vX / 16) - 1; j < Math.floor(vX / 16) + 20; j++){
-      if (level.scenery[i][j]) {
-        renderEntity(level.scenery[i][j]);
-      }
-    }
-  }
-
-  //then items
-  level.items.forEach (function (item) {
-    renderEntity(item);
-  });
-
-  level.enemies.forEach (function(enemy) {
-    renderEntity(enemy);
-  });
-
-
-
-  fireballs.forEach(function(fireball) {
-    renderEntity(fireball);
-  })
-
-  //then we draw every static object.
-  for(var i = 0; i < 15; i++) {
-    for (var j = Math.floor(vX / 16) - 1; j < Math.floor(vX / 16) + 20; j++){
-      if (level.statics[i][j]) {
-        renderEntity(level.statics[i][j]);
-      }
-      if (level.blocks[i][j]) {
-        renderEntity(level.blocks[i][j]);
-        updateables.push(level.blocks[i][j]);
-      }
-    }
-  }
-
-  //then the player
-  if (player.invincibility % 2 === 0) {
-    renderEntity(player);
-  }
-
-  //Mario goes INTO pipes, so naturally they go after.
-  level.pipes.forEach (function(pipe) {
-    renderEntity(pipe);
-  });
-}
-
-function renderEntity(entity) {
-  entity.render(ctx, vX, vY);
-}

examples/mario/js/goomba.js

@@ -1,129 +0,0 @@
-(function() {
-  if (typeof Mario === 'undefined')
-  window.Mario = {};
-
-  //TODO: On console the hitbox is smaller. Measure it and edit this.
-
-  var Goomba = Mario.Goomba = function(pos, sprite) {
-    this.dying = false;
-    Mario.Entity.call(this, {
-      pos: pos,
-      sprite: sprite,
-      hitbox: [0,0,16,16]
-    });
-    this.vel[0] = -0.5;
-    this.idx = level.enemies.length;
-  };
-
-  Goomba.prototype.render = function(ctx, vX, vY) {
-    this.sprite.render(ctx, this.pos[0], this.pos[1], vX, vY);
-  };
-
-  Goomba.prototype.update = function(dt, vX) {
-    if (this.pos[0] - vX > 336) { //if we're too far away, do nothing.
-      return;
-    } else if (this.pos[0] - vX < -32) {
-      delete level.enemies[this.idx];
-    }
-
-    if (this.dying) {
-      this.dying -= 1;
-      if (!this.dying) {
-        delete level.enemies[this.idx];
-      }
-    }
-    this.acc[1] = 0.2;
-    this.vel[1] += this.acc[1];
-    this.pos[0] += this.vel[0];
-    this.pos[1] += this.vel[1];
-    this.sprite.update(dt);
-  };
-
-  Goomba.prototype.collideWall = function() {
-    this.vel[0] = -this.vel[0];
-  };
-
-  Goomba.prototype.checkCollisions = function() {
-    if (this.flipping) {
-      return;
-    }
-
-    var h = this.pos[1] % 16 === 0 ? 1 : 2;
-    var w = this.pos[0] % 16 === 0 ? 1 : 2;
-
-    var baseX = Math.floor(this.pos[0] / 16);
-    var baseY = Math.floor(this.pos[1] / 16);
-
-    if (baseY + h > 15) {
-      delete level.enemies[this.idx];
-      return;
-    }
-
-    for (var i = 0; i < h; i++) {
-      for (var j = 0; j < w; j++) {
-        if (level.statics[baseY + i][baseX + j]) {
-          level.statics[baseY + i][baseX + j].isCollideWith(this);
-        }
-        if (level.blocks[baseY + i][baseX + j]) {
-          level.blocks[baseY + i][baseX + j].isCollideWith(this);
-        }
-      }
-    }
-    var that = this;
-    level.enemies.forEach(function(enemy){
-      if (enemy === that) { //don't check collisions with ourselves.
-        return;
-      } else if (enemy.pos[0] - vX > 336){ //stop checking once we get to far away dudes.
-        return;
-      } else {
-        that.isCollideWith(enemy);
-      }
-    });
-    this.isCollideWith(player);
-  };
-
-  Goomba.prototype.isCollideWith = function(ent) {
-    if (ent instanceof Mario.Player && (this.dying || ent.invincibility)) {
-      return;
-    }
-
-    //the first two elements of the hitbox array are an offset, so let's do this now.
-    var hpos1 = [this.pos[0] + this.hitbox[0], this.pos[1] + this.hitbox[1]];
-    var hpos2 = [ent.pos[0] + ent.hitbox[0], ent.pos[1] + ent.hitbox[1]];
-
-    //if the hitboxes actually overlap
-    if (!(hpos1[0] > hpos2[0]+ent.hitbox[2] || (hpos1[0]+this.hitbox[2] < hpos2[0]))) {
-      if (!(hpos1[1] > hpos2[1]+ent.hitbox[3] || (hpos1[1]+this.hitbox[3] < hpos2[1]))) {
-        if (ent instanceof Mario.Player) { //if we hit the player
-          if (ent.vel[1] > 0) { //then the goomba dies
-            this.stomp();
-          } else if (ent.starTime) {
-            this.bump();
-          } else { //or the player gets hit
-            ent.damage();
-          }
-        } else {
-          this.collideWall();
-        }
-      }
-    }
-  };
-
-  Goomba.prototype.stomp = function() {
-    sounds.stomp.play();
-    player.bounce = true;
-    this.sprite.pos[0] = 32;
-    this.sprite.speed = 0;
-    this.vel[0] = 0;
-    this.dying = 10;
-  };
-
-  Goomba.prototype.bump = function() {
-    sounds.kick.play();
-    this.sprite.img = 'sprites/enemyr.png';
-    this.flipping = true;
-    this.pos[1] -= 1;
-    this.vel[0] = 0;
-    this.vel[1] = -2.5;
-  };
-})();

examples/mario/js/input.js

@@ -1,54 +0,0 @@
-(function() {
-    var pressedKeys = {};
-
-    function setKey(event, status) {
-        var code = event.keyCode;
-        var key;
-
-        switch(code) {
-        case 32:
-            key = 'SPACE'; break;
-        case 37:
-            key = 'LEFT'; break;
-        case 38:
-            key = 'UP'; break;
-        case 39:
-            key = 'RIGHT'; break;
-        case 40:
-            key = 'DOWN'; break;
-        case 88:
-            key = 'JUMP'; break;
-        case 90:
-            key = 'RUN'; break;
-        default:
-            key = String.fromCharCode(code);
-        }
-
-        pressedKeys[key] = status;
-    }
-
-    document.addEventListener('keydown', function(e) {
-        setKey(e, true);
-    });
-
-    document.addEventListener('keyup', function(e) {
-        setKey(e, false);
-    });
-
-    window.addEventListener('blur', function() {
-        pressedKeys = {};
-    });
-
-    window.input = {
-        isDown: function(key) {
-            return pressedKeys[key.toUpperCase()];
-        },
-        reset: function() {
-          pressedKeys['RUN'] = false;
-          pressedKeys['LEFT'] = false;
-          pressedKeys['RIGHT'] = false;
-          pressedKeys['DOWN'] = false;
-          pressedKeys['JUMP'] = false;
-        }
-    };
-})();

examples/mario/js/koopa.js

@@ -1,211 +0,0 @@
-(function() {
-  if (typeof Mario === 'undefined')
-  window.Mario = {};
-
-  var Koopa = Mario.Koopa = function(pos, sprite, para) {
-    this.dying = false;
-    this.shell = false;
-
-    this.para = para; //para. As in, is it a paratroopa?
-
-    //So, funny story. The actual hitboxes don't reach all the way to the ground.
-    //What that means is, as long as I use them to keep things on the floor
-    //making the hitboxes accurate will make enemies sink into the ground.
-    Mario.Entity.call(this, {
-      pos: pos,
-      sprite: sprite,
-      hitbox: [2,8,12,24]
-    });
-    this.vel[0] = -0.5;
-    this.idx = level.enemies.length;
-  };
-
-  Koopa.prototype.render = function(ctx, vX, vY) {
-    this.sprite.render(ctx, this.pos[0], this.pos[1], vX, vY);
-  };
-
-  Koopa.prototype.update = function(dt, vX) {
-    if (this.turn) {
-      this.vel[0] = -this.vel[0];
-      if (this.shell) sounds.bump.play();
-      this.turn = false;
-    }
-    if (this.vel[0] != 0) {
-      this.left = (this.vel[0] < 0);
-    }
-
-    if (this.left) {
-      this.sprite.img = 'sprites/enemy.png';
-    } else {
-      this.sprite.img = 'sprites/enemyr.png';
-    }
-
-    if (this.pos[0] - vX > 336) { //if we're too far away, do nothing.
-      return;
-    } else if (this.pos[0] - vX < -32) {
-      delete level.enemies[this.idx];
-    }
-
-    if (this.dying) {
-      this.dying -= 1;
-      if (!this.dying) {
-        delete level.enemies[this.idx];
-      }
-    }
-
-    if (this.shell) {
-      if (this.vel[0] == 0) {
-        this.shell -= 1;
-        if (this.shell < 120) {
-          this.sprite.speed = 5;
-        }
-        if (this.shell == 0) {
-          this.sprite = level.koopaSprite();
-          this.hitbox = [2,8,12,24]
-          if (this.left) {
-            this.sprite.img = 'sprites/enemyr.png';
-            this.vel[0] = 0.5;
-            this.left = false;
-          } else {
-            this.vel[0] = -0.5;
-            this.left = true;
-          }
-          this.pos[1] -= 16;
-        }
-      } else {
-        this.shell = 360;
-        this.sprite.speed = 0;
-        this.sprite.setFrame(0);
-      }
-    }
-    this.acc[1] = 0.2;
-    this.vel[1] += this.acc[1];
-    this.pos[0] += this.vel[0];
-    this.pos[1] += this.vel[1];
-    this.sprite.update(dt);
-  };
-
-  Koopa.prototype.collideWall = function() {
-    //This stops us from flipping twice on the same frame if we collide
-    //with multiple wall tiles simultaneously.
-    this.turn = true;
-  };
-
-  Koopa.prototype.checkCollisions = function() {
-    var h = this.shell ? 1 : 2;
-    if (this.pos[1] % 16 !== 0) {
-      h += 1;
-    }
-    var w = this.pos[0] % 16 === 0 ? 1 : 2;
-
-    var baseX = Math.floor(this.pos[0] / 16);
-    var baseY = Math.floor(this.pos[1] / 16);
-
-    if (baseY + h > 15) {
-      delete level.enemies[this.idx];
-      return;
-    }
-
-    if (this.flipping) {
-      return;
-    }
-
-    for (var i = 0; i < h; i++) {
-      for (var j = 0; j < w; j++) {
-        if (level.statics[baseY + i][baseX + j]) {
-          level.statics[baseY + i][baseX + j].isCollideWith(this);
-        }
-        if (level.blocks[baseY + i][baseX + j]) {
-          level.blocks[baseY + i][baseX + j].isCollideWith(this);
-        }
-      }
-    }
-    var that = this;
-    level.enemies.forEach(function(enemy){
-      if (enemy === that) { //don't check collisions with ourselves.
-        return;
-      } else if (enemy.pos[0] - vX > 336){ //stop checking once we get to far away dudes.
-        return;
-      } else {
-        that.isCollideWith(enemy);
-      }
-    });
-    this.isCollideWith(player);
-  };
-
-  Koopa.prototype.isCollideWith = function(ent) {
-    if (ent instanceof Mario.Player && (this.dying || ent.invincibility)) {
-      return;
-    }
-
-    //the first two elements of the hitbox array are an offset, so let's do this now.
-    var hpos1 = [this.pos[0] + this.hitbox[0], this.pos[1] + this.hitbox[1]];
-    var hpos2 = [ent.pos[0] + ent.hitbox[0], ent.pos[1] + ent.hitbox[1]];
-
-    //if the hitboxes actually overlap
-    if (!(hpos1[0] > hpos2[0]+ent.hitbox[2] || (hpos1[0]+this.hitbox[2] < hpos2[0]))) {
-      if (!(hpos1[1] > hpos2[1]+ent.hitbox[3] || (hpos1[1]+this.hitbox[3] < hpos2[1]))) {
-        if (ent instanceof Mario.Player) {
-          if (ent.vel[1] > 0) {
-            player.bounce = true;
-          }
-          if (this.shell) {
-            sounds.kick.play();
-            if (this.vel[0] === 0) {
-              if (ent.left) { //I'm pretty sure this isn't the real logic.
-                this.vel[0] = -4;
-              } else {
-                this.vel[0] = 4;
-              }
-            } else {
-              if (ent.bounce) {
-                this.vel[0] = 0;
-              } else ent.damage();
-            }
-          } else if (ent.vel[1] > 0) { //then we get BOPPED.
-            this.stomp();
-          } else { //or the player gets hit
-            ent.damage();
-          }
-        } else {
-          if (this.shell && (ent instanceof Mario.Goomba)) {
-            ent.bump();
-          } else this.collideWall();
-        }
-      }
-    }
-  };
-
-  Koopa.prototype.stomp = function() {
-    //Turn this thing into a shell if it isn't already. Kick it if it is.
-    player.bounce = true;
-    if (this.para) {
-      this.para = false;
-      this.sprite.pos[0] -= 32;
-    } else {
-      sounds.stomp.play();
-      this.shell = 360;
-      this.sprite.pos[0] += 64;
-      this.sprite.pos[1] += 16;
-      this.sprite.size = [16,16];
-      this.hitbox = [2,0,12,16];
-      this.sprite.speed = 0;
-      this.frames = [0,1];
-      this.vel = [0,0];
-      this.pos[1] += 16;
-    }
-
-  };
-
-  Koopa.prototype.bump = function() {
-    sounds.kick.play();
-    if (this.flipping) return;
-    this.flipping = true;
-    this.sprite.pos = [160, 0];
-    this.sprite.size = [16,16];
-    this.hitbox = [2, 0, 12, 16];
-    this.sprite.speed = 0;
-    this.vel[0] = 0;
-    this.vel[1] = -2.5;
-  };
-})();

examples/mario/js/levels/11.js

@@ -1,219 +0,0 @@
-var oneone = Mario.oneone = function() {
-  //The things that need to be passed in are basically just dependent on what
-  //tileset we're in, so it makes more sense to just make one variable for that, so
-  //TODO: put as much of this in the Level object definition as possible.
-  level = new Mario.Level({
-    playerPos: [56,192],
-    loader: Mario.oneone,
-    background: "#7974FF",
-    scrolling: true,
-    invincibility: [144, 192, 240],
-    exit: 204,
-    floorSprite:  new Mario.Sprite('sprites/tiles.png', [0,0],[16,16],0),
-    cloudSprite:  new Mario.Sprite('sprites/tiles.png', [0,320],[48,32],0),
-    wallSprite: new Mario.Sprite('sprites/tiles.png', [0, 16],[16,16],0),
-    brickSprite: new Mario.Sprite('sprites/tiles.png', [16, 0], [16,16], 0),
-    brickBounceSprite: new Mario.Sprite('sprites/tiles.png',[32,0],[16,16],0),
-    rubbleSprite: function () {
-      return new Mario.Sprite('sprites/items.png', [64,0], [8,8], 3, [0,1])
-    },
-    ublockSprite: new Mario.Sprite('sprites/tiles.png', [48, 0], [16,16],0),
-    superShroomSprite: new Mario.Sprite('sprites/items.png', [0,0], [16,16], 0),
-    fireFlowerSprite: new Mario.Sprite('sprites/items.png', [0,32], [16,16], 20, [0,1,2,3]),
-    starSprite: new Mario.Sprite('sprites/items.png', [0,48], [16,16], 20, [0,1,2,3]),
-    pipeLEndSprite: new Mario.Sprite('sprites/tiles.png', [0, 128], [16,16], 0),
-    pipeREndSprite: new Mario.Sprite('sprites/tiles.png', [16, 128], [16,16], 0),
-    pipeLMidSprite: new Mario.Sprite('sprites/tiles.png', [0, 144], [16,16], 0),
-    pipeRMidSprite: new Mario.Sprite('sprites/tiles.png', [16, 144], [16,16], 0),
-
-    pipeUpMid: new Mario.Sprite('sprites/tiles.png', [0, 144], [32,16], 0),
-    pipeSideMid: new Mario.Sprite('sprites/tiles.png', [48, 128], [16,32], 0),
-    pipeLeft: new Mario.Sprite('sprites/tiles.png', [32, 128], [16,32], 0),
-    pipeTop: new Mario.Sprite('sprites/tiles.png', [0, 128], [32,16], 0),
-    qblockSprite: new Mario.Sprite('sprites/tiles.png', [384, 0], [16,16], 8, [0,0,0,0,1,2,1]),
-    bcoinSprite: function() {
-      return new Mario.Sprite('sprites/items.png', [0,112],[16,16], 20,[0,1,2,3]);
-    },
-    cloudSprites:[
-      new Mario.Sprite('sprites/tiles.png', [0,320],[16,32],0),
-      new Mario.Sprite('sprites/tiles.png', [16,320],[16,32],0),
-      new Mario.Sprite('sprites/tiles.png', [32,320],[16,32],0)
-    ],
-    hillSprites: [
-      new Mario.Sprite('sprites/tiles.png', [128,128],[16,16],0),
-      new Mario.Sprite('sprites/tiles.png', [144,128],[16,16],0),
-      new Mario.Sprite('sprites/tiles.png', [160,128],[16,16],0),
-      new Mario.Sprite('sprites/tiles.png', [128,144],[16,16],0),
-      new Mario.Sprite('sprites/tiles.png', [144,144],[16,16],0),
-      new Mario.Sprite('sprites/tiles.png', [160,144],[16,16],0)
-    ],
-    bushSprite: new Mario.Sprite('sprites/tiles.png', [176, 144], [48, 16], 0),
-    bushSprites: [
-     new Mario.Sprite('sprites/tiles.png', [176,144], [16,16],0),
-     new Mario.Sprite('sprites/tiles.png', [192,144], [16,16],0),
-     new Mario.Sprite('sprites/tiles.png', [208,144], [16,16],0)],
-   goombaSprite: function() {
-     return new Mario.Sprite('sprites/enemy.png', [0, 16], [16,16], 3, [0,1]);
-   },
-   koopaSprite: function() {
-     return new Mario.Sprite('sprites/enemy.png', [96,0], [16,32], 2, [0,1]);
-   },
-   flagPoleSprites: [
-     new Mario.Sprite('sprites/tiles.png', [256, 128], [16,16], 0),
-     new Mario.Sprite('sprites/tiles.png', [256, 144], [16,16], 0),
-     new Mario.Sprite('sprites/items.png', [128, 32], [16,16], 0)
-   ]
- });
-  ground = [[0,69],[71,86],[89,153],[155,212]];
-  player.pos[0] = level.playerPos[0];
-  player.pos[1] = level.playerPos[1];
-  vX = 0;
-
-  //build THE GROUND
-  ground.forEach(function(loc) {
-    level.putFloor(loc[0],loc[1]);
-  });
-
-  //build scenery
-  clouds = [[7,3],[19, 2],[56, 3],[67, 2],[87, 2],[103, 2],[152, 3],[163, 2],[200, 3]];
-  clouds.forEach(function(cloud){
-    level.putCloud(cloud[0],cloud[1]);
-  });
-
-  twoClouds = [[36,2],[132,2],[180,2]];
-  twoClouds.forEach(function(cloud){
-    level.putTwoCloud(cloud[0],cloud[1]);
-  });
-
-  threeClouds = [[27,3],[75,3],[123,3],[171,3]];
-  threeClouds.forEach(function(cloud){
-    level.putThreeCloud(cloud[0],cloud[1]);
-  });
-
-  bHills = [0,48,96,144,192]
-  bHills.forEach(function(hill) {
-    level.putBigHill(hill, 12);
-  });
-
-  sHills = [16,64,111,160];
-  sHills.forEach(function(hill) {
-    level.putSmallHill(hill, 12);
-  });
-
-  bushes = [23,71,118,167];
-  bushes.forEach(function(bush) {
-    level.putBush(bush, 12);
-  });
-
-  twoBushes = [41,89,137];
-  twoBushes.forEach(function(bush) {
-    level.putTwoBush(bush, 12);
-  });
-
-  threeBushes = [11,59,106];
-  threeBushes.forEach(function(bush) {
-    level.putThreeBush(bush, 12);
-  });
-
-  //interactable terrain
-  level.putQBlock(16, 9, new Mario.Bcoin([256, 144]));
-  level.putBrick(20, 9, null);
-  level.putQBlock(21, 9, new Mario.Mushroom([336, 144]));
-  level.putBrick(22, 9, null);
-  level.putQBlock(22, 5, new Mario.Bcoin([352, 80]));
-  level.putQBlock(23, 9, new Mario.Bcoin([368, 144]));
-  level.putBrick(24, 9, null);
-  level.putPipe(28, 13, 2);
-  level.putPipe(38, 13, 3);
-  level.putPipe(46, 13, 4);
-  level.putRealPipe(57, 9, 4, "DOWN", Mario.oneonetunnel);
-  level.putBrick(77, 9, null);
-  level.putQBlock(78, 9, new Mario.Mushroom([1248, 144]));
-  level.putBrick(79, 9, null);
-  level.putBrick(80, 5, null);
-  level.putBrick(81, 5, null);
-  level.putBrick(82, 5, null);
-  level.putBrick(83, 5, null);
-  level.putBrick(84, 5, null);
-  level.putBrick(85, 5, null);
-  level.putBrick(86, 5, null);
-  level.putBrick(87, 5, null);
-  level.putBrick(91, 5, null);
-  level.putBrick(92, 5, null);
-  level.putBrick(93, 5, null);
-  level.putQBlock(94, 5, new Mario.Bcoin([1504, 80]));
-  level.putBrick(94, 9, null);
-  level.putBrick(100, 9, new Mario.Star([1600, 144]));
-  level.putBrick(101, 9, null);
-  level.putQBlock(105, 9, new Mario.Bcoin([1680, 144]));
-  level.putQBlock(108, 9, new Mario.Bcoin([1728, 144]));
-  level.putQBlock(108, 5, new Mario.Mushroom([1728, 80]));
-  level.putQBlock(111, 9, new Mario.Bcoin([1776, 144]));
-  level.putBrick(117, 9, null);
-  level.putBrick(120, 5, null);
-  level.putBrick(121, 5, null);
-  level.putBrick(122, 5, null);
-  level.putBrick(123, 5, null);
-  level.putBrick(128, 5, null);
-  level.putQBlock(129, 5, new Mario.Bcoin([2074, 80]));
-  level.putBrick(129, 9, null);
-  level.putQBlock(130, 5, new Mario.Bcoin([2080, 80]));
-  level.putBrick(130, 9, null);
-  level.putBrick(131, 5, null);
-  level.putWall(134, 13, 1);
-  level.putWall(135, 13, 2);
-  level.putWall(136, 13, 3);
-  level.putWall(137, 13, 4);
-  level.putWall(140, 13, 4);
-  level.putWall(141, 13, 3);
-  level.putWall(142, 13, 2);
-  level.putWall(143, 13, 1);
-  level.putWall(148, 13, 1);
-  level.putWall(149, 13, 2);
-  level.putWall(150, 13, 3);
-  level.putWall(151, 13, 4);
-  level.putWall(152, 13, 4);
-  level.putWall(155, 13, 4);
-  level.putWall(156, 13, 3);
-  level.putWall(157, 13, 2);
-  level.putWall(158, 13, 1);
-  level.putPipe(163, 13, 2);
-  level.putBrick(168, 9, null);
-  level.putBrick(169, 9, null);
-  level.putQBlock(170, 9, new Mario.Bcoin([2720, 144]));
-  level.putBrick(171, 9, null);
-  level.putPipe(179, 13, 2);
-  level.putWall(181, 13, 1);
-  level.putWall(182, 13, 2);
-  level.putWall(183, 13, 3);
-  level.putWall(184, 13, 4);
-  level.putWall(185, 13, 5);
-  level.putWall(186, 13, 6);
-  level.putWall(187, 13, 7);
-  level.putWall(188, 13, 8);
-  level.putWall(189, 13, 8);
-  level.putFlagpole(198);
-
-  //and enemies
-  level.putGoomba(22, 12);
-  level.putGoomba(40, 12);
-  level.putGoomba(50, 12);
-  level.putGoomba(51, 12);
-  level.putGoomba(82, 4);
-  level.putGoomba(84, 4);
-  level.putGoomba(100, 12);
-  level.putGoomba(102, 12);
-  level.putGoomba(114, 12);
-  level.putGoomba(115, 12);
-  level.putGoomba(122, 12);
-  level.putGoomba(123, 12);
-  level.putGoomba(125, 12);
-  level.putGoomba(126, 12);
-  level.putGoomba(170, 12);
-  level.putGoomba(172, 12);
-  level.putKoopa(35, 11);
-
-  music.underground.pause();
-  // music.overworld.currentTime = 0;
-  music.overworld.play();
-};

examples/mario/js/levels/11tunnel.js

@@ -1,65 +0,0 @@
-var oneonetunnel = Mario.oneonetunnel = function() {
-  level = new Mario.Level({
-    playerPos: [40,16],
-    loader: Mario.oneonetunnel,
-    background: "#000000",
-    scrolling: false,
-    coinSprite: function() {
-      return new Mario.Sprite('sprites/items.png', [0,96],[16,16], 6,[0,0,0,0,1,2,1]);
-    },
-    floorSprite:  new Mario.Sprite('sprites/tiles.png', [0,32],[16,16],0),
-    wallSprite: new Mario.Sprite('sprites/tiles.png', [32, 32],[16,16],0),
-    brickSprite: new Mario.Sprite('sprites/tiles.png', [16, 0], [16,16], 0),
-    brickBounceSprite: new Mario.Sprite('sprites/tiles.png',[32,0],[16,16],0),
-    ublockSprite: new Mario.Sprite('sprites/tiles.png', [48, 0], [16,16],0),
-    pipeLMidSprite: new Mario.Sprite('sprites/tiles.png', [0, 144], [16,16], 0),
-    pipeRMidSprite: new Mario.Sprite('sprites/tiles.png', [16, 144], [16,16], 0),
-    pipeLEndSprite: new Mario.Sprite('sprites/tiles.png', [0, 128], [16,16], 0),
-    pipeREndSprite: new Mario.Sprite('sprites/tiles.png', [16, 128], [16,16], 0),
-    pipeUpMid: new Mario.Sprite('sprites/tiles.png', [0, 144], [32,16], 0),
-    pipeSideMid: new Mario.Sprite('sprites/tiles.png', [48, 128], [16,32], 0),
-    pipeLeft: new Mario.Sprite('sprites/tiles.png', [32, 128], [16,32], 0),
-    pipeTop: new Mario.Sprite('sprites/tiles.png', [0, 128], [32,16], 0),
-
-    LPipeSprites:[
-      new Mario.Sprite('sprites/tiles.png', [32,128],[16,16],0),
-      new Mario.Sprite('sprites/tiles.png', [32,144],[16,16],0),
-      new Mario.Sprite('sprites/tiles.png', [48,128],[16,16],0),
-      new Mario.Sprite('sprites/tiles.png', [48,144],[16,16],0),
-      new Mario.Sprite('sprites/tiles.png', [64,128],[16,16],0),
-      new Mario.Sprite('sprites/tiles.png', [64,144],[16,16],0),
-    ]
-
-  });
-
-  player.pos[0] = level.playerPos[0];
-  player.pos[1] = level.playerPos[1];
-  vX = 0;
-  level.putFloor(0,16);
-  level.putWall(0,13,11);
-  walls = [4,5,6,7,8,9,10];
-  walls.forEach(function(loc){
-    level.putWall(loc,13,3);
-    level.putWall(loc,3,1);
-  });
-
-  coins = [[5,5], [6,5], [7,5], [8,5], [9,5],
-           [4,7], [5,7], [6,7], [7,7], [8,7], [9,7], [10,7],
-           [4,9], [5,9], [6,9], [7,9], [8,9], [9,9], [10,9]];
-  coins.forEach(function(pos){
-    level.putCoin(pos[0],pos[1]);
-  });
-
-  //level.putLeftPipe(13,11);
-  level.putRealPipe(13,11,3,"RIGHT", function() {
-    Mario.oneone.call();
-    player.pos = [2616, 177]
-    player.pipe("UP", function() {;});
-  });
-
-  level.putPipe(15,13,13);
-
-  music.overworld.pause();
-  music.underground.currentTime = 0;
-  music.underground.play();
-};

examples/mario/js/levels/level.js

@@ -1,218 +0,0 @@
-(function() {
-  var Level = Mario.Level = function(options) {
-    this.playerPos = options.playerPos;
-    this.scrolling = options.scrolling;
-    this.loader = options.loader;
-    this.background = options.background;
-    this.exit = options.exit;
-
-    this.floorSprite = options.floorSprite;
-    this.cloudSprite = options.cloudSprite;
-    this.wallSprite = options.wallSprite;
-    this.brickSprite = options.brickSprite;
-    this.rubbleSprite = options.rubbleSprite;
-    this.brickBounceSprite = options.brickBounceSprite;
-    this.ublockSprite = options.ublockSprite;
-    this.superShroomSprite = options.superShroomSprite;
-    this.fireFlowerSprite = options.fireFlowerSprite;
-    this.starSprite = options.starSprite;
-    this.coinSprite = options.coinSprite;
-    this.bcoinSprite = options.bcoinSprite;
-    this.goombaSprite = options.goombaSprite;
-    this.koopaSprite = options.koopaSprite;
-
-    //prop pipe sprites, to be phased out
-    this.pipeLEndSprite = options.pipeLEndSprite;
-    this.pipeREndSprite = options.pipeREndSprite;
-    this.pipeLMidSprite = options.pipeLMidSprite;
-    this.pipeRMidSprite = options.pipeRMidSprite;
-
-    //real pipe sprites, use these.
-    this.pipeUpMid = options.pipeUpMid;
-    this.pipeSideMid = options.pipeSideMid;
-    this.pipeLeft = options.pipeLeft;
-    this.pipeTop = options.pipeTop;
-
-    this.flagpoleSprites = options.flagPoleSprites;
-
-    this.LPipeSprites = options.LPipeSprites;
-    this.cloudSprites = options.cloudSprites;
-    this.hillSprites = options.hillSprites;
-    this.bushSprite = options.bushSprite;
-    this.bushSprites = options.bushSprites;
-    this.qblockSprite = options.qblockSprite;
-
-    this.invincibility = options.invincibility;
-    this.statics = [];
-    this.scenery = [];
-    this.blocks = [];
-    this.enemies = [];
-    this.items = [];
-    this.pipes = [];
-
-    for (var i = 0; i < 15; i++) {
-      this.statics[i] = [];
-      this.scenery[i] = [];
-      this.blocks[i] = [];
-    }
-
-  };
-
-  Level.prototype.putFloor = function(start, end) {
-    for (var i = start; i < end; i++) {
-      this.statics[13][i] = new Mario.Floor([16*i,208], this.floorSprite);
-      this.statics[14][i] = new Mario.Floor([16*i,224], this.floorSprite);
-    }
-  };
-
-  Level.prototype.putGoomba = function(x, y) {
-    this.enemies.push(new Mario.Goomba([16*x, 16*y], this.goombaSprite() ));
-  };
-
-  Level.prototype.putKoopa = function(x, y) {
-    this.enemies.push(new Mario.Koopa([16*x, 16*y], this.koopaSprite(), false));
-  };
-
-  Level.prototype.putWall = function(x, y, height) {
-    //y is the bottom of the wall in this case.
-    for (var i = y-height; i < y; i++) {
-      this.statics[i][x] = new Mario.Floor([16*x, 16*i], this.wallSprite);
-    }
-  };
-
-  Level.prototype.putPipe = function(x, y, height) {
-    for (var i = y - height; i < y; i++) {
-      if (i === y - height) {
-        this.statics[i][x] = new Mario.Floor([16*x, 16*i], this.pipeLEndSprite);
-        this.statics[i][x+1] = new Mario.Floor([16*x+16, 16*i], this.pipeREndSprite);
-      } else {
-        this.statics[i][x] = new Mario.Floor([16*x, 16*i], this.pipeLMidSprite);
-        this.statics[i][x+1] = new Mario.Floor([16*x+16, 16*i], this.pipeRMidSprite);
-      }
-    }
-  };
-
-  //sometimes, pipes don't go straight up and down.
-  Level.prototype.putLeftPipe = function(x,y) {
-    this.statics[y][x] = new Mario.Floor([16*x, 16*y], this.LPipeSprites[0]);
-    this.statics[y+1][x] = new Mario.Floor([16*x,16*(y+1)], this.LPipeSprites[1]);
-    this.statics[y][x+1] = new Mario.Floor([16*(x+1),16*y], this.LPipeSprites[2]);
-    this.statics[y+1][x+1] = new Mario.Floor([16*(x+1),16*(y+1)], this.LPipeSprites[3]);
-    this.statics[y][x+2] = new Mario.Floor([16*(x+2),16*y], this.LPipeSprites[4]);
-    this.statics[y+1][x+2] = new Mario.Floor([16*(x+2),16*(y+1)], this.LPipeSprites[5]);
-  };
-
-  Level.prototype.putCoin = function(x, y) {
-    this.items.push(new Mario.Coin(
-      [x*16, y*16],
-      this.coinSprite()
-    ));
-  };
-
-  Level.prototype.putCloud = function(x, y) {
-    this.scenery[y][x] = new Mario.Prop([x*16, y*16], this.cloudSprite);
-  };
-
-  Level.prototype.putQBlock = function(x, y, item) {
-    this.blocks[y][x] = new Mario.Block( {
-      pos: [x*16, y*16],
-      item: item,
-      sprite: this.qblockSprite,
-      usedSprite: this.ublockSprite
-    });
-  };
-
-  Level.prototype.putBrick = function(x,y,item) {
-    this.blocks[y][x] = new Mario.Block({
-      pos: [x*16, y*16],
-      item: item,
-      sprite: this.brickSprite,
-      bounceSprite: this.brickBounceSprite,
-      usedSprite: this.ublockSprite,
-      breakable: !item
-    });
-  };
-
-  Level.prototype.putBigHill = function(x, y) {
-    var px = x*16, py = y*16;
-    this.scenery[y][x] = new Mario.Prop([px, py], this.hillSprites[0]);
-    this.scenery[y][x+1] = new Mario.Prop([px+16, py], this.hillSprites[3]);
-    this.scenery[y-1][x+1] = new Mario.Prop([px+16, py-16], this.hillSprites[0]);
-    this.scenery[y][x+2] = new Mario.Prop([px+32, py], this.hillSprites[4]);
-    this.scenery[y-1][x+2] = new Mario.Prop([px+32, py-16], this.hillSprites[3]);
-    this.scenery[y-2][x+2] = new Mario.Prop([px+32, py-32], this.hillSprites[1]);
-    this.scenery[y][x+3] = new Mario.Prop([px+48, py], this.hillSprites[5]);
-    this.scenery[y-1][x+3] = new Mario.Prop([px+48, py-16], this.hillSprites[2]);
-    this.scenery[y][x+4] = new Mario.Prop([px+64, py], this.hillSprites[2]);
-  };
-
-  Level.prototype.putBush = function(x, y) {
-    this.scenery[y][x] = new Mario.Prop([x*16, y*16], this.bushSprite);
-  };
-
-  Level.prototype.putThreeBush = function(x,y) {
-    px = x*16;
-    py = y*16;
-    this.scenery[y][x] = new Mario.Prop([px, py], this.bushSprites[0]);
-    this.scenery[y][x+1] = new Mario.Prop([px+16, py], this.bushSprites[1]);
-    this.scenery[y][x+2] = new Mario.Prop([px+32, py], this.bushSprites[1]);
-    this.scenery[y][x+3] = new Mario.Prop([px+48, py], this.bushSprites[1]);
-    this.scenery[y][x+4] = new Mario.Prop([px+64, py], this.bushSprites[2]);
-  };
-
-  Level.prototype.putTwoBush = function(x,y) {
-    px = x*16;
-    py = y*16;
-    this.scenery[y][x] = new Mario.Prop([px, py], this.bushSprites[0]);
-    this.scenery[y][x+1] = new Mario.Prop([px+16, py], this.bushSprites[1]);
-    this.scenery[y][x+2] = new Mario.Prop([px+32, py], this.bushSprites[1]);
-    this.scenery[y][x+3] = new Mario.Prop([px+48, py], this.bushSprites[2]);
-  };
-
-  Level.prototype.putSmallHill = function(x, y) {
-    var px = x*16, py = y*16;
-    this.scenery[y][x] = new Mario.Prop([px, py], this.hillSprites[0]);
-    this.scenery[y][x+1] = new Mario.Prop([px+16, py], this.hillSprites[3]);
-    this.scenery[y-1][x+1] = new Mario.Prop([px+16, py-16], this.hillSprites[1]);
-    this.scenery[y][x+2] = new Mario.Prop([px+32, py], this.hillSprites[2]);
-  };
-
-  Level.prototype.putTwoCloud = function(x,y) {
-    px = x*16;
-    py = y*16;
-    this.scenery[y][x] = new Mario.Prop([px, py], this.cloudSprites[0]);
-    this.scenery[y][x+1] = new Mario.Prop([px+16, py], this.cloudSprites[1]);
-    this.scenery[y][x+2] = new Mario.Prop([px+32, py], this.cloudSprites[1]);
-    this.scenery[y][x+3] = new Mario.Prop([px+48, py], this.cloudSprites[2]);
-  };
-
-  Level.prototype.putThreeCloud = function(x,y) {
-    px = x*16;
-    py = y*16;
-    this.scenery[y][x] = new Mario.Prop([px, py], this.cloudSprites[0]);
-    this.scenery[y][x+1] = new Mario.Prop([px+16, py], this.cloudSprites[1]);
-    this.scenery[y][x+2] = new Mario.Prop([px+32, py], this.cloudSprites[1]);
-    this.scenery[y][x+3] = new Mario.Prop([px+48, py], this.cloudSprites[1]);
-    this.scenery[y][x+4] = new Mario.Prop([px+64, py], this.cloudSprites[2]);
-  };
-
-  Level.prototype.putRealPipe = function(x, y, length, direction, destination) {
-    px = x*16;
-    py = y*16;
-    this.pipes.push(new Mario.Pipe({
-      pos: [px, py],
-      length: length,
-      direction: direction,
-      destination: destination
-    }));
-  }
-
-  Level.prototype.putFlagpole = function(x) {
-    this.statics[12][x] = new Mario.Floor([16*x, 192], this.wallSprite);
-    for (i=3; i < 12; i++) {
-      this.scenery[i][x] = new Mario.Prop([16*x, 16*i], this.flagpoleSprites[1])
-    }
-    this.scenery[2][x] = new Mario.Prop([16*x, 32], this.flagpoleSprites[0]);
-    this.items.push(new Mario.Flag(16*x));
-  }
-})();

examples/mario/js/mushroom.js

@@ -1,118 +0,0 @@
-(function() {
-  if (typeof Mario === 'undefined')
-  window.Mario = {};
-
-  var Mushroom = Mario.Mushroom = function(pos) {
-    this.spawning = false;
-    this.waiting = 0;
-
-    Mario.Entity.call(this, {
-      pos: pos,
-      sprite: level.superShroomSprite,
-      hitbox: [0,0,16,16]
-    });
-  }
-
-  Mario.Util.inherits(Mushroom, Mario.Entity);
-
-  Mushroom.prototype.render = function(ctx, vX, vY) {
-    if (this.spawning > 1) return;
-    this.sprite.render(ctx, this.pos[0], this.pos[1], vX, vY);
-  }
-
-  Mushroom.prototype.spawn = function() {
-    if (player.power > 0) {
-      //replace this with a fire flower
-      var ff = new Mario.Fireflower(this.pos)
-      ff.spawn();
-      return;
-    }
-    sounds.itemAppear.play();
-    this.idx = level.items.length;
-    level.items.push(this);
-    this.spawning = 12;
-    this.targetpos = [];
-    this.targetpos[0] = this.pos[0];
-    this.targetpos[1] = this.pos[1] - 16;
-  }
-
-  Mushroom.prototype.update = function(dt) {
-    if (this.spawning > 1) {
-      this.spawning -= 1;
-      if (this.spawning == 1) this.vel[1] = -.5;
-      return;
-    }
-    if (this.spawning) {
-      if (this.pos[1] <= this.targetpos[1]) {
-        this.pos[1] = this.targetpos[1];
-        this.vel[1] = 0;
-        this.waiting = 5;
-        this.spawning = 0;
-        this.vel[0] = 1;
-      }
-    } else {
-      this.acc[1] = 0.2;
-    }
-
-    if (this.waiting) {
-      this.waiting -= 1;
-    } else {
-      this.vel[1] += this.acc[1];
-      this.pos[0] += this.vel[0];
-      this.pos[1] += this.vel[1];
-      this.sprite.update(dt);
-    }
-  }
-
-  Mushroom.prototype.collideWall = function() {
-    this.vel[0] = -this.vel[0];
-  }
-
-  Mushroom.prototype.checkCollisions = function() {
-    if(this.spawning) {
-      return;
-    }
-    var h = this.pos[1] % 16 == 0 ? 1 : 2;
-    var w = this.pos[0] % 16 == 0 ? 1 : 2;
-
-    var baseX = Math.floor(this.pos[0] / 16);
-    var baseY = Math.floor(this.pos[1] / 16);
-
-    if (baseY + h > 15) {
-      delete level.items[this.idx];
-      return;
-    }
-
-    for (var i = 0; i < h; i++) {
-      for (var j = 0; j < w; j++) {
-        if (level.statics[baseY + i][baseX + j]) {
-          level.statics[baseY + i][baseX + j].isCollideWith(this);
-        }
-        if (level.blocks[baseY + i][baseX + j]) {
-          level.blocks[baseY + i][baseX + j].isCollideWith(this);
-        }
-      }
-    }
-
-    this.isPlayerCollided();
-  }
-
-  //we have access to player everywhere, so let's just do this.
-  Mushroom.prototype.isPlayerCollided = function() {
-    //the first two elements of the hitbox array are an offset, so let's do this now.
-    var hpos1 = [this.pos[0] + this.hitbox[0], this.pos[1] + this.hitbox[1]];
-    var hpos2 = [player.pos[0] + player.hitbox[0], player.pos[1] + player.hitbox[1]];
-
-    //if the hitboxes actually overlap
-    if (!(hpos1[0] > hpos2[0]+player.hitbox[2] || (hpos1[0]+this.hitbox[2] < hpos2[0]))) {
-      if (!(hpos1[1] > hpos2[1]+player.hitbox[3] || (hpos1[1]+this.hitbox[3] < hpos2[1]))) {
-        player.powerUp(this.idx);
-      }
-    }
-  }
-
-  Mushroom.prototype.bump = function() {
-    this.vel[1] = -2;
-  }
-
-})();

examples/mario/js/outline.txt

@@ -1,45 +0,0 @@
-Enemy:
-  #collideWith
-    checks collision. Bounces off of walls and other enemies. Kills marios.
-    gets killed by block bonk from below
-
-  Specific enemy behaviors:
-    koopas get replaced with shells
-    shells get kicked if touched from the side, instead of killing
-
-Mario:
-  #collideWith
-    gets expelled from walls, bonks blocks, destroys blocks as big Mario
-    note: collision with blocks is determined by which one is over the center
-      if you're slightly to the side, you slip past it.
-  Crazy-ass sprite shifting if you're in star mode!
-
-
-Item
-  #collideWith
-    item pickup logic
-
-Mushroom
-  #update
-    movement logic for mushrooms
-    get impulse from being block bonked
-      this can be implemented by giving them the appropriate accel
-      just if they overlap a block from the bottom.
-      of course, only AFTER they finish sliding out of the block.
-
-Water levels:
-  make a separate class for water Marios
-    less gravity
-    swimming sprite
-    fireballs are the same
-    jump works when not on the ground
-  different enemies
-
-
-TODO: Make level loader use hashes instead of arrays where possible.
-Should be a free performance gain.
-
-Should also make item deletion less weird.
-
-TODO: Make gravity exist higher up instead of having a magic number.
-Note from the future: Nope. Different objects have different gravity.

examples/mario/js/pipe.js

@@ -1,160 +0,0 @@
-(function() {
-  if (typeof Mario === 'undefined')
-    window.Mario = {};
-
-
-  //there are too many possible configurations of pipe to capture in a reasonable
-  //set of simple variables. Joints, etc. are just too much.
-  //To that end, the pipe class handles simple pipes, and we'll put together
-  //anything more complex with individual props. OK? OK.
-  Pipe = Mario.Pipe = function(options) {
-    this.pos = options.pos
-
-    //NOTE: direction is the direction you move INTO the pipe.
-    this.direction = options.direction
-    this.destination = options.destination
-    this.length = options.length;
-
-    if (this.direction === "UP" || this.direction === "DOWN") {
-      this.hitbox = [0,0, 32, this.length * 16];
-      this.midsection = level.pipeUpMid;
-      this.endsection = level.pipeTop;
-    } else {
-      this.hitbox = [0,0, 16*this.length, 32];
-      this.midsection = level.pipeSideMid;
-      this.endsection = level.pipeLeft;
-    }
-  }
-
-  Pipe.prototype.checkPipe = function() {
-    if (this.destination === undefined || !input.isDown(this.direction)) return;
-
-    var h = player.power===0 ? 16 : 32;
-    var x = Math.floor(player.pos[0]);
-    var y = Math.floor(player.pos[1]);
-    switch (this.direction) {
-      case 'RIGHT': if (x === this.pos[0]-16 &&
-                        y >= this.pos[1] &&
-                        y+h <= this.pos[1]+32) {
-                          player.pipe(this.direction, this.destination)
-                        }
-        break;
-      case 'LEFT': if (x === this.pos[0]+16*this.length &&
-                       y >= this.pos[1] &&
-                       y+h <= this.pos[1]+32) {
-                         player.pipe(this.direction, this.destination)
-                       }
-        break;
-      case 'UP': if (y === this.pos[1] + 16*this.length &&
-                     x >= this.pos[0] &&
-                     x+16 <= this.pos[0]+32) {
-                       player.pipe(this.direction, this.destination)
-                     }
-        break;
-      case 'DOWN': if (y+h === this.pos[1] &&
-                    x >= this.pos[0] &&
-                    x+16 <= this.pos[0]+32) {
-                      player.pipe(this.direction, this.destination);
-                    }
-        break;
-    }
-  }
-
-  //Note to self: next time, decide on a convention for which thing checks for collisions
-  //and stick to it. This is a pain.
-  Pipe.prototype.checkCollisions = function() {
-    var that = this;
-    level.enemies.forEach (function(ent) {
-      that.isCollideWith(ent);
-    });
-
-    level.items.forEach (function(ent) {
-      that.isCollideWith(ent);
-    });
-
-    fireballs.forEach(function(ent){
-      that.isCollideWith(ent)
-    });
-
-    if (!player.piping) this.isCollideWith(player);
-  }
-
-  Pipe.prototype.isCollideWith = function (ent) {
-    //long story short: because we scan every item, and and one 'rubble' item is four things with separate positions
-    //we'll crash without this line as soon as we destroy a block. OOPS.
-    if (ent.pos === undefined) return;
-
-
-    //the first two elements of the hitbox array are an offset, so let's do this now.
-    var hpos1 = [Math.floor(this.pos[0] + this.hitbox[0]), Math.floor(this.pos[1] + this.hitbox[1])];
-    var hpos2 = [Math.floor(ent.pos[0] + ent.hitbox[0]), Math.floor(ent.pos[1] + ent.hitbox[1])];
-
-    //if the hitboxes actually overlap
-    if (!(hpos1[0] > hpos2[0]+ent.hitbox[2] || (hpos1[0]+this.hitbox[2] < hpos2[0]))) {
-      if (!(hpos1[1] > hpos2[1]+ent.hitbox[3] || (hpos1[1]+this.hitbox[3] < hpos2[1]))) {
-        //if the entity is over the block, it's basically floor
-        var center = hpos2[0] + ent.hitbox[2] / 2;
-        if (Math.abs(hpos2[1] + ent.hitbox[3] - hpos1[1]) <= ent.vel[1]) {
-          ent.vel[1] = 0;
-          ent.pos[1] = hpos1[1] - ent.hitbox[3] - ent.hitbox[1];
-          ent.standing = true;
-          if (ent instanceof Mario.Player) {
-            ent.jumping = 0;
-          }
-        } else if (Math.abs(hpos2[1] - hpos1[1] - this.hitbox[3]) > ent.vel[1] &&
-        center + 2 >= hpos1[0] && center - 2 <= hpos1[0] + this.hitbox[2]) {
-          //ent is under the block.
-          ent.vel[1] = 0;
-          ent.pos[1] = hpos1[1] + this.hitbox[3];
-          if (ent instanceof Mario.Player) {
-            ent.jumping = 0;
-          }
-        } else {
-          //entity is hitting it from the side, we're a wall
-          ent.collideWall(this);
-        }
-      }
-    }
-  }
-
-  //we COULD try to write some shenanigans so that the check gets put into the
-  //collision code, but there won't ever be more than a handful of pipes in a level
-  //so the performance hit of scanning all of them is miniscule.
-  Pipe.prototype.update = function(dt) {
-    if (this.destination) this.checkPipe();
-  }
-
-  //http://stackoverflow.com/questions/11227809/why-is-processing-a-sorted-array-faster-than-an-unsorted-array
-  //I honestly have no idea if javascript does this, but I feel like it makes sense
-  //stylistically to prefer branching outside of loops when possible as convention
-
-  //TODO: edit the spritesheet so UP and LEFT pipes aren't backwards.
-  Pipe.prototype.render = function(ctx, vX, vY) {
-    switch (this.direction) {
-      case "DOWN":
-        this.endsection.render(ctx, this.pos[0], this.pos[1], vX, vY);
-        for (var i = 1; i < this.length; i++) {
-          this.midsection.render(ctx, this.pos[0], this.pos[1]+i*16, vX, vY)
-        }
-        break;
-      case "UP":
-        this.endsection.render(ctx, this.pos[0], this.pos[1]+16*(this.length-1), vX, vY)
-        for (var i=0; i < this.length - 1; i++) {
-          this.midsection.render(ctx, this.pos[0], this.pos[1]+i*16, vX, vY)
-        }
-        break;
-      case "RIGHT":
-        this.endsection.render(ctx, this.pos[0], this.pos[1], vX, vY)
-        for (var i = 1; i < this.length; i++) {
-          this.midsection.render(ctx, this.pos[0]+16*i, this.pos[1], vX, vY)
-        }
-        break;
-      case "LEFT":
-        this.endsection.render(ctx, this.pos[0]+16*(this.length-1), this.pos[1], vX, vY)
-        for (var i = 0; i < this.legth-1; i++) {
-          this.midsection.render(ctx, this.pos[0], this.pos[1]+i*16, vX, vY)
-        }
-        break;
-    }
-  }
-})();

examples/mario/js/player.js

@@ -1,446 +0,0 @@
-(function() {
-	if (typeof Mario === 'undefined')
-		window.Mario = {};
-
-	var Player = Mario.Player = function(pos) {
-		//I know, I know, there are a lot of variables tracking Mario's state.
-		//Maybe these can be consolidated some way? We'll see once they're all in.
-		this.power = 0;
-		this.coins = 0;
-		this.powering = [];
-		this.bounce = false;
-		this.jumping = 0;
-		this.canJump = true;
-		this.invincibility = 0;
-		this.crouching = false;
-		this.fireballs = 0;
-		this.runheld = false;
-		this.noInput = false;
-		this.targetPos = [];
-
-		Mario.Entity.call(this, {
-			pos: pos,
-			sprite: new Mario.Sprite('sprites/player.png', [80,32],[16,16],0),
-			hitbox: [0,0,16,16]
-		});
-	};
-
-	Mario.Util.inherits(Player, Mario.Entity);
-
-	Player.prototype.run = function() {
-		this.maxSpeed = 2.5;
-		if (this.power == 2 && !this.runheld) {
-			this.shoot();
-		}
-		this.runheld = true;
-	}
-
-	Player.prototype.shoot = function() {
-		if (this.fireballs >= 2) return; //Projectile limit!
-		this.fireballs += 1;
-		var fb = new Mario.Fireball([this.pos[0]+8,this.pos[1]]); //I hate you, Javascript.
-		fb.spawn(this.left);
-		this.shooting = 2;
-	}
-
-	Player.prototype.noRun = function() {
-		this.maxSpeed = 1.5;
-		this.moveAcc = 0.07;
-		this.runheld = false;
-	}
-
-	Player.prototype.moveRight = function() {
-		//we're on the ground
-		if (this.vel[1] === 0 && this.standing) {
-			if (this.crouching) {
-				this.noWalk();
-				return;
-			}
-			this.acc[0] = this.moveAcc;
-			this.left = false;
-		} else {
-			this.acc[0] = this.moveAcc;
-		}
-	};
-
-	Player.prototype.moveLeft = function() {
-		if (this.vel[1] === 0 && this.standing) {
-			if (this.crouching) {
-				this.noWalk();
-				return;
-			}
-			this.acc[0] = -this.moveAcc;
-			this.left = true;
-		} else {
-			this.acc[0] = -this.moveAcc;
-		}
-	};
-
-	Player.prototype.noWalk = function() {
-		this.maxSpeed = 0;
-		if (this.vel[0] === 0) return;
-
-		if (Math.abs(this.vel[0]) <= 0.1) {
-			this.vel[0] = 0;
-			this.acc[0] = 0;
-		}
-
-	};
-
-	Player.prototype.crouch = function() {
-		if (this.power === 0) {
-			this.crouching = false;
-			return;
-		}
-
-		if (this.standing) this.crouching = true;
-	}
-
-	Player.prototype.noCrouch = function() {
-		this.crouching = false;
-	}
-
-	Player.prototype.jump = function() {
-		if (this.vel[1] > 0) {
-			return;
-		}
-		if (this.jumping) {
-			this.jumping -= 1;
-		} else if (this.standing && this.canJump) {
-			this.jumping = 20;
-			this.canJump = false;
-			this.standing = false;
-			this.vel[1] = -6;
-			if (this.power === 0) {
-				sounds.smallJump.currentTime = 0;
-				sounds.smallJump.play();
-			} else {
-				sounds.bigJump.currentTime = 0;
-				sounds.bigJump.play();
-			}
-		}
-	};
-
-	Player.prototype.noJump = function() {
-		this.canJump = true;
-		if (this.jumping) {
-			if (this.jumping <= 16) {
-				this.vel[1] = 0;
-				this.jumping = 0;
-			} else this.jumping -= 1;
-		}
-	};
-
-  Player.prototype.setAnimation = function() {
-		if (this.dying) return;
-
-		if (this.starTime) {
-			var index;
-			if (this.starTime > 60)
-				index = Math.floor(this.starTime / 2) % 3;
-			else index = Math.floor(this.starTime / 8) % 3;
-
-			this.sprite.pos[1] = level.invincibility[index];
-			if (this.power == 0) {
-				this.sprite.pos[1] += 32;
-			}
-			this.starTime -= 1;
-			if (this.starTime == 0) {
-				switch(this.power) {
-					case 0: this.sprite.pos[1] = 32; break;
-					case 1: this.sprite.pos[1] = 0; break;
-					case 2: this.sprite.pos[1] = 96; break;
-				}
-			}
-		}
-		//okay cool, now set the sprite
-		if (this.crouching) {
-			this.sprite.pos[0] = 176;
-			this.sprite.speed = 0;
-			return;
-		}
-
-    if (this.jumping) {
-			this.sprite.pos[0] = 160;
-			this.sprite.speed = 0;
-		} else if (this.standing) {
-			if (Math.abs(this.vel[0]) > 0) {
-				if (this.vel[0] * this.acc[0] >= 0) {
-					this.sprite.pos[0] = 96;
-					this.sprite.frames = [0,1,2];
-					if (this.vel[0] < 0.2) {
-						this.sprite.speed = 5;
-					} else {
-						this.sprite.speed = Math.abs(this.vel[0]) * 8;
-					}
-				} else if ((this.vel[0] > 0 && this.left) || (this.vel[0] < 0 && !this.left)){
-					this.sprite.pos[0] = 144;
-					this.sprite.speed = 0;
-				}
-			} else {
-				this.sprite.pos[0] = 80;
-				this.sprite.speed = 0;
-			}
-			if (this.shooting) {
-				this.sprite.pos[0] += 160;
-				this.shooting -= 1;
-			}
-		}
-
-		if (this.flagging) {
-			this.sprite.pos[0] = 192;
-			this.sprite.frames = [0,1];
-			this.sprite.speed = 10;
-			if (this.vel[1] === 0) this.sprite.frames = [0];
-		}
-
-		//which way are we facing?
-		if (this.left) {
-			this.sprite.img = 'sprites/playerl.png';
-		} else {
-			this.sprite.img = 'sprites/player.png';
-		}
-  };
-
-	Player.prototype.update = function(dt, vX) {
-		if (this.powering.length !== 0) {
-			var next = this.powering.shift();
-			if (next == 5) return;
-			this.sprite.pos = this.powerSprites[next];
-			this.sprite.size = this.powerSizes[next];
-			this.pos[1] += this.shift[next];
-			if (this.powering.length === 0) {
-				delete level.items[this.touchedItem];
-			}
-			return;
-		}
-
-		if (this.invincibility) {
-			this.invincibility -= Math.round(dt * 60);
-		}
-
-		if (this.waiting) {
-			this.waiting -= dt;
-			if (this.waiting <= 0) {
-				this.waiting = 0;
-			} else return;
-		}
-
-		if (this.bounce) {
-			this.bounce = false;
-			this.standing = false;
-			this.vel[1] = -3;
-		}
-
-		if (this.pos[0] <= vX) {
-			this.pos[0] = vX;
-			this.vel[0] = Math.max(this.vel[0], 0);
-		}
-
-		if (Math.abs(this.vel[0]) > this.maxSpeed) {
-			this.vel[0] -= 0.05 *  this.vel[0] / Math.abs(this.vel[0]);
-			this.acc[0] = 0;
-		}
-
-		if (this.dying){
-			if (this.pos[1] < this.targetPos[1]) {
-				this.vel[1] = 1;
-			}
-			this.dying -= 1 * dt;
-			if (this.dying <= 0) {
-				player = new Mario.Player(level.playerPos);
-				level.loader.call();
-				input.reset();
-			}
-		}
-		else {
-			this.acc[1] = 0.25
-			if (this.pos[1] > 240) {
-				this.die();
-			}
-		}
-
-		if (this.piping) {
-			this.acc = [0,0];
-			var pos = [Math.round(this.pos[0]), Math.round(this.pos[1])]
-			if (pos[0] === this.targetPos[0] && pos[1] === this.targetPos[1]) {
-				this.piping = false;
-				this.pipeLoc.call();
-			}
-		}
-
-		if (this.flagging) {
-			this.acc = [0,0];
-		}
-
-		if (this.exiting) {
-			this.left = false;
-			this.flagging = false;
-			this.vel[0] = 1.5;
-			if (this.pos[0] >= this.targetPos[0]) {
-				this.sprite.size = [0,0];
-				this.vel = [0,0];
-				window.setTimeout(function() {
-					player.sprite.size = player.power===0 ? [16,16] : [16,32];
-					player.exiting = false;
-					player.noInput = false;
-					level.loader();
-					if (player.power !== 0) player.pos[1] -= 16;
-					music.overworld.currentTime = 0;
-				}, 5000);
-			}
-		}
-
-		//approximate acceleration
-		this.vel[0] += this.acc[0];
-		this.vel[1] += this.acc[1];
-		this.pos[0] += this.vel[0];
-		this.pos[1] += this.vel[1];
-
-    this.setAnimation();
-		this.sprite.update(dt);
-	};
-
-	Player.prototype.checkCollisions = function() {
-		if (this.piping || this.dying) return;
-		//x-axis first!
-		var h = this.power > 0 ? 2 : 1;
-		var w = 1;
-		if (this.pos[1] % 16 !== 0) {
-			h += 1;
-		}
-		if (this.pos[0] % 16 !== 0) {
-			w += 1;
-		}
-		var baseX = Math.floor(this.pos[0] / 16);
-		var baseY = Math.floor(this.pos[1] / 16);
-
-		for (var i = 0; i < h; i++) {
-			if (baseY + i < 0 || baseY + i >= 15) continue;
-			for (var j = 0; j < w; j++) {
-				if (baseY < 0) { i++;}
-				if (level.statics[baseY + i][baseX + j]) {
-					level.statics[baseY + i][baseX + j].isCollideWith(this);
-				}
-				if (level.blocks[baseY + i][baseX + j]) {
-					level.blocks[baseY + i][baseX + j].isCollideWith(this);
-				}
-			}
-		}
-	};
-
-	Player.prototype.powerUp = function(idx) {
-		sounds.powerup.play();
-	  this.powering = [0,5,2,5,1,5,2,5,1,5,2,5,3,5,1,5,2,5,3,5,1,5,4];
-		this.touchedItem = idx;
-
-		if (this.power === 0) {
-			this.sprite.pos[0] = 80;
-			var newy = this.sprite.pos[1] - 32;
-			this.powerSprites = [[80, newy+32], [80, newy+32], [320, newy], [80, newy], [128, newy]];
-			this.powerSizes = [[16,16],[16,16],[16,32],[16,32],[16,32]];
-			this.shift = [0,16,-16,0,-16];
-			this.power = 1;
-			this.hitbox = [0,0,16,32];
-		} else if (this.power == 1) {
-			var curx = this.sprite.pos[0];
-			this.powerSprites = [[curx, 96], [curx, level.invincibility[0]],
-				[curx, level.invincibility[1]], [curx, level.invincibility[2]],
-				[curx, 96]];
-			this.powerSizes[[16,32],[16,32],[16,32],[16,32],[16,32]];
-			this.shift = [0,0,0,0,0];
-			this.power = 2;
-		} else {
-			this.powering = [];
-			delete level.items[idx];
-			//no animation, but we play the sound and you get 5000 points.
-		}
-	};
-
-	Player.prototype.damage = function() {
-		if (this.power === 0) { //if you're already small, you dead!
-			this.die();
-		} else { //otherwise, you get turned into small mario
-			sounds.pipe.play();
-			this.powering = [0,5,1,5,2,5,1,5,2,5,1,5,2,5,1,5,2,5,1,5,2,5,3];
-			this.shift = [0,16,-16,16];
-			this.sprite.pos = [160, 0];
-			this.powerSprites = [[160,0], [240, 32], [240, 0], [160, 32]];
-			this.powerSizes = [[16, 32], [16,16], [16,32], [16,16]];
-			this.invincibility = 120;
-			this.power = 0;
-			this.hitbox = [0,0,16,16];
-		}
-	};
-
-	Player.prototype.die = function () {
-		//TODO: rewrite the way sounds work to emulate the channels of an NES.
-		music.overworld.pause();
-		music.underground.pause();
-		music.overworld.currentTime = 0;
-		music.death.play();
-		this.noWalk();
-		this.noRun();
-		this.noJump();
-
-		this.acc[0] = 0;
-		this.sprite.pos = [176, 32];
-		this.sprite.speed = 0;
-		this.power = 0;
-		this.waiting = 0.5;
-		this.dying = 2;
-
-		if (this.pos[1] < 240) { //falling into a pit doesn't do the animation.
-			this.targetPos = [this.pos[0], this.pos[1]-128];
-			this.vel = [0,-5];
-		} else {
-			this.vel = [0,0];
-			this.targetPos = [this.pos[0], this.pos[1] - 16];
-		}
-	};
-
-	Player.prototype.star = function(idx) {
-		delete level.items[idx];
-		this.starTime = 660;
-	}
-
-	Player.prototype.pipe = function(direction, destination) {
-		sounds.pipe.play();
-		this.piping = true;
-		this.pipeLoc = destination;
-		switch(direction) {
-			case "LEFT":
-				this.vel = [-1,0];
-				this.targetPos = [Math.round(this.pos[0]-16), Math.round(this.pos[1])]
-				break;
-			case "RIGHT":
-				this.vel = [1,0];
-				this.targetPos = [Math.round(this.pos[0]+16), Math.round(this.pos[1])]
-				break;
-			case "DOWN":
-				this.vel = [0,1];
-				this.targetPos = [Math.round(this.pos[0]), Math.round(this.pos[1]+this.hitbox[3])]
-				break;
-			case "UP":
-				this.vel = [0,-1];
-				this.targetPos = [Math.round(this.pos[0]), Math.round(this.pos[1]-this.hitbox[3])]
-				break;
-		}
-	}
-
-	Player.prototype.flag = function() {
-		this.noInput = true;
-		this.flagging = true;
-		this.vel = [0, 2];
-		this.acc = [0, 0];
-	}
-
-	Player.prototype.exit = function() {
-		this.pos[0] += 16;
-		this.targetPos[0] = level.exit * 16;
-		this.left = true;
-		this.setAnimation();
-		this.waiting = 1;
-		this.exiting = true;
-	}
-})();

examples/mario/js/prop.js

@@ -1,15 +0,0 @@
-(function() {
-  if (typeof Mario === 'undefined')
-  window.Mario = {};
-
-  //props do even less than entities, so they don't need to inherit really
-  var Prop = Mario.Prop = function(pos, sprite) {
-    this.pos = pos;
-    this.sprite = sprite;
-  }
-
-  //but we will be using the same Render, more or less.
-  Prop.prototype.render = function(ctx, vX, vY) {
-    this.sprite.render(ctx, this.pos[0], this.pos[1], vX, vY);
-  }
-})();

examples/mario/js/resources.js

@@ -1,62 +0,0 @@
-//simple resource loader
-(function() {
-    var resourceCache = {};
-    var loading = [];
-    var readyCallbacks = [];
-
-    // Load an image url or an array of image urls
-    function load(urlOrArr) {
-        if(urlOrArr instanceof Array) {
-            urlOrArr.forEach(function(url) {
-                _load(url);
-            });
-        }
-        else {
-            _load(urlOrArr);
-        }
-    }
-
-    function _load(url) {
-        if(resourceCache[url]) {
-            return resourceCache[url];
-        }
-        else {
-            var img = new Image();
-            img.onload = function() {
-                resourceCache[url] = img;
-
-                if(isReady()) {
-                    readyCallbacks.forEach(function(func) { func(); });
-                }
-            };
-            resourceCache[url] = false;
-            img.src = url;
-        }
-    }
-
-    function get(url) {
-        return resourceCache[url];
-    }
-
-    function isReady() {
-        var ready = true;
-        for(var k in resourceCache) {
-            if(resourceCache.hasOwnProperty(k) &&
-               !resourceCache[k]) {
-                ready = false;
-            }
-        }
-        return ready;
-    }
-
-    function onReady(func) {
-        readyCallbacks.push(func);
-    }
-
-    window.resources = {
-        load: load,
-        get: get,
-        onReady: onReady,
-        isReady: isReady
-    };
-})();

examples/mario/js/rubble.js

@@ -1,55 +0,0 @@
-(function() {
-  if (typeof Mario === 'undefined')
-  window.Mario = {};
-
-  //TODO: make each rubble an entity, use that render and write in Entity.update
-  var Rubble = Mario.Rubble = function() {
-    this.sprites = [];
-    this.poss = [];
-    this.vels = [];
-  }
-
-  Rubble.prototype.spawn = function(pos) {
-    this.idx = level.items.length;
-    level.items.push(this);
-    this.sprites[0] = level.rubbleSprite();
-    this.sprites[1] = level.rubbleSprite();
-    this.sprites[2] = level.rubbleSprite();
-    this.sprites[3] = level.rubbleSprite();
-    this.poss[0] = pos;
-    this.poss[1] = [ pos[0] + 8, pos[1] ];
-    this.poss[2] = [ pos[0], pos[1] + 8 ];
-    this.poss[3] = [ pos[0] + 8, pos[1] + 8 ];
-    this.vels[0] = [-1.25, -5];
-    this.vels[1] = [1.25, -5];
-    this.vels[2] = [-1.25, -3];
-    this.vels[3] = [1.25, -3];
-  }
-
-  Rubble.prototype.update = function(dt) {
-    for(var i = 0; i < 4; i++) {
-      if (this.sprites[i]===undefined) continue;
-      this.vels[i][1] += .3;
-      this.poss[i][0] += this.vels[i][0];
-      this.poss[i][1] += this.vels[i][1];
-      this.sprites[i].update(dt);
-      if (this.poss[i][1] > 256) {
-        delete this.sprites[i];
-      }
-    }
-    if (this.sprites.every(function (el) {return !el})) {
-      delete level.items[this.idx];
-    }
-  }
-
-  //You might argue that things that can't collide are more like scenery
-  //but these move and need to be deleted, and i'd rather deal with the 1d array.
-  Rubble.prototype.checkCollisions = function() {;}
-
-  Rubble.prototype.render = function() {
-    for(var i = 0; i < 4; i++) {
-      if (this.sprites[i] === undefined) continue;
-      this.sprites[i].render(ctx, this.poss[i][0], this.poss[i][1], vX, vY);
-    }
-  }
-})();