docs: update README and changelog for 1.2.0

Rewrite the README around current features (packages, micropip, plots,
experimental pygame, console features), limitations and development
notes, replacing outdated sections. Group the 1.2.0 changelog into new,
improved, fixed and development changes, and add the missing 1.1.4 entry.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: bajrangCoder

README.md

@@ -1,54 +1,87 @@
-# acode-plugin-python
+# Python for Acode
 
-Plugin to run python code in [Acode](https://acode.foxdebug.com) editor for android. This plugin uses [Pyodide](https://pyodide.org) project to run python in browser.
+Run Python 3.14 in the [Acode](https://acode.app) editor on Android. Python runs on your device through [Pyodide](https://pyodide.org), so no server or Termux setup is needed.
 
-## Plugin is underdevelopment
+## Features
 
-Using this plugin you can run python codes but you cannot import other python files yet, so, this feature will be supportted in future updates.
+- **Run Python files**: open a `.py` file and tap the run button in the header
+- **Interactive console**: type Python after your program finishes; `input()` works too
+- **Python packages**: `import numpy`, `pandas`, `matplotlib` and many more are downloaded automatically the first time you use them
+- **Install from PyPI** with `micropip`
+- **Plots and images**: `matplotlib` figures and Pillow images are shown right in the console
+- **pygame (experimental)**: games draw to a canvas in the console
+- **Copy output**: console text can be selected and copied
+- **Line wrap**: toggle wrapping of long output lines from the header button
+- **Progress indicator**: a thin line under the header shows while Python is loading or your code is running
 
-### Update 1.0.7
+## Usage
 
-- Bugs fixes
-- Updated pyodide
+Open a Python file and tap the run button. The console shows your program's output, errors in red, and a prompt for `input()`.
 
-### Update 1.1.0
+After the program finishes, you can keep typing Python in the console. Use the up and down arrows to browse previous commands and `Ctrl+L` to clear the console.
 
-- Bugs fixes
-- Reduces waiting time
+### Packages
 
-### Update 1.2.0
+Packages built for Pyodide (numpy, pandas, scipy, matplotlib, Pillow and [many more](https://pyodide.org/en/stable/usage/packages-in-pyodide.html)) load automatically when imported. They are downloaded the first time, so an internet connection is needed then.
 
-- Python 3.14 (Pyodide 314.0.7)
-- Import packages like `numpy` or `pandas` directly. They are downloaded on first use (internet required)
-- Install pure Python packages from PyPI with `micropip`:
+Pure Python packages from PyPI can be installed with `micropip`:
 
 ```python
 import micropip
 await micropip.install("snowballstemmer")
+
+import snowballstemmer
+print(snowballstemmer.stemmer("english").stemWords(["running", "jumps"]))
 ```
 
 ### Plots and images
 
-`matplotlib` figures are shown in the console when you call `plt.show()`, and any figures left open are shown when the program ends. Figures default to the width of the console and are rendered at the screen's pixel density. Pillow's `Image.show()` works too.
+`plt.show()` displays matplotlib figures in the console, and any figures still open are shown when the program ends. Figures default to the width of the console and are rendered sharp on high-density screens. Pillow's `Image.show()` works too.
+
+```python
+import matplotlib.pyplot as plt
+import numpy as np
+
+x = np.linspace(0, 2 * np.pi, 200)
+plt.plot(x, np.sin(x), label="sin(x)")
+plt.legend()
+plt.show()
+```
 
 ### pygame (experimental)
 
-pygame programs can draw to a canvas in the console using Pyodide's [SDL support](https://pyodide.org/en/stable/usage/sdl.html). Ordinary game loops work as written:
+pygame programs draw to a canvas in the console using Pyodide's [SDL support](https://pyodide.org/en/stable/usage/sdl.html). Ordinary game loops work as written:
 
 ```python
 import pygame
 
 pygame.init()
 screen = pygame.display.set_mode((1280, 720))
 clock = pygame.time.Clock()
+running = True
+
+while running:
+    for event in pygame.event.get():
+        if event.type == pygame.QUIT:
+            running = False
 
-while True:
     screen.fill("purple")
     pygame.display.flip()
     clock.tick(60)
+
+pygame.quit()
 ```
 
-This needs a WebView with JSPI support (Android System WebView 137+), which lets the loop pause at `display.flip()` / `Clock.tick()` so the app stays responsive. On older WebViews, use an async loop (`await asyncio.sleep(0)` each frame) instead. If SDL cannot start, the program runs without a display. Running again or closing the console stops the game.
+- Blocking loops like this need Android System WebView 137 or newer (JSPI support). On older WebViews, make the loop async with `await asyncio.sleep(0)` each frame.
+- Running again or closing the console stops the game.
+- If SDL cannot start, the program runs without a display and the console explains why.
+
+## Limitations
+
+- Only the open file runs; importing your other `.py` files is not supported yet.
+- Code runs in the browser sandbox: no access to device files outside Python's in-memory file system, and no `subprocess` or threads.
+- Packages with native code must be [built for Pyodide](https://pyodide.org/en/stable/usage/packages-in-pyodide.html); others cannot be installed with `micropip`.
+- Requires a recent Android System WebView.
 
 ## Development
 
@@ -61,6 +94,12 @@ npm run check      # lint and format check (Biome)
 
 In Acode, install from **Plugins → + → Remote** using `http://<your-ip>:3000/plugin.zip`.
 
-## WARNING
+Source layout:
+
+- `src/main.js`: console page, run button and Acode integration
+- `src/worker.js`: runs Python in a web worker
+- `src/sdl.js`: experimental SDL runtime on the main thread, loaded only for pygame
+- `src/runtime.js`: Pyodide setup shared by both runtimes
+- `src/python/`: Python helpers for showing plots/images and running pygame loops
 
-This is plugin might not be supported in your device. To check weather this plugin is supported in your device or not, open console declare variable using 'const' key word. If it throws a error, your device doesn't support this plugin.
+See [changelog.md](changelog.md) for release notes.

changelog.md

@@ -2,19 +2,38 @@
 
 ## 1.2.0
 
-- Updated Pyodide to 314.0.7 (Python 3.14)
-- Packages such as `numpy`, `pandas` and `micropip` are now downloaded on demand when imported
-- Errors written to stderr are now shown in red
-- Console output can now be selected and copied
+### New
+
+- Python 3.14: updated Pyodide from 0.28.1 to 314.0.7
+- Packages such as `numpy`, `pandas`, `matplotlib` and `micropip` are downloaded automatically when imported (internet needed on first use)
+- matplotlib plots are shown in the console, on `plt.show()` or automatically when the program ends. Plots are sized to the console and rendered sharp on high-density screens
+- Pillow's `Image.show()` displays images in the console
+- Experimental pygame support: games draw to a canvas in the console, including ordinary blocking game loops on WebViews with JSPI (Android System WebView 137+). If SDL cannot start, the program runs without a display and the reason is shown
 - Header button to toggle line wrap in the console (remembered between sessions)
-- Thin progress line under the console header while Python loads or code is running
-- matplotlib plots are shown in the console (`plt.show()`, or automatically at the end of a run), as are Pillow `Image.show()` images. Plots are sized to the console and rendered sharp on high-density screens
-- Experimental SDL support: pygame programs draw to a canvas in the console, including ordinary blocking game loops on WebViews with JSPI. Falls back to running without a display if SDL cannot start
-- Python crashes no longer leave the console stuck; Python restarts on the next run
-- Fixed Python failing to load (or staying on "loading...") on some devices
-- Clear error message when Python fails to load, with automatic retry on the next run
-- Smaller plugin size (removed stale Pyodide files)
-- Migrated build tooling to esbuild, matching the official plugin template
+- Thin progress line under the console header while Python is loading or code is running
+
+### Improved
+
+- Console output can be selected and copied
+- Errors written to stderr are shown in red
+- Clear error message when Python fails to load, with an automatic retry on the next run
+- If Python crashes, the console no longer gets stuck; Python restarts on the next run
+- Smaller plugin download (removed stale Pyodide files)
+
+### Fixed
+
+- Python failing to load on some devices (`importScripts ... failed to load` followed by `Cannot read properties of undefined (reading 'loadPackagesFromImports')`)
+- Python staying on "loading..." forever when the device serves `.wasm` files with the wrong type
+- pygame failing with `Failed to connect to localhost/127.0.0.1:443` when another plugin replaces `fetch`
+
+### Development
+
+- Build tooling migrated from webpack, Babel, PostCSS and Sass to esbuild, matching the [official plugin template](https://github.com/Acode-Foundation/acode-plugin)
+- The Pyodide runtime is installed from npm and copied into the build, so a clean checkout builds a working plugin
+
+## 1.1.4
+
+- New run icon
 
 ## 1.1.3