zexus 1.7.2 → 1.8.1

package/README.md

@@ -2,7 +2,7 @@
 
 <div align="center">
 
-![Zexus Logo](https://img.shields.io/badge/Zexus-v1.7.2-FF6B35?style=for-the-badge)
+![Zexus Logo](https://img.shields.io/badge/Zexus-v1.8.1-FF6B35?style=for-the-badge)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)](LICENSE)
 [![Python](https://img.shields.io/badge/Python-3.8+-3776AB?style=for-the-badge&logo=python)](https://python.org)
 [![GitHub](https://img.shields.io/badge/GitHub-Zaidux/zexus--interpreter-181717?style=for-the-badge&logo=github)](https://github.com/Zaidux/zexus-interpreter)
@@ -67,9 +67,9 @@ Zexus is a next-generation, general-purpose programming language designed for se
 
 ---
 
-## 🎉 What's New in v1.7.2
+## 🎉 What's New in v1.8.1
 
-### Latest Features (v1.7.2)
+### Latest Features (v1.8.1)
 
 ✅ **FIND Keyword** - Declarative project search that resolves exact module paths with scope filtering and smart suggestions  
 ✅ **LOAD Keyword & Manager** - Provider-aware configuration loader with built-in ENV, JSON, and YAML support plus caching  
@@ -588,6 +588,22 @@ verify balance >= amount {
 pip install zexus
 ```
 
+### Full Install (Blockchain + Networking + Security Helpers)
+
+```bash
+pip install "zexus[full]"
+```
+
+### Install Matrix
+
+| Goal | Command | Notes |
+|---|---|---|
+| Minimal (interpreter + CLI) | `pip install zexus` | Pure-Python install. |
+| Full runtime features | `pip install "zexus[full]"` | Installs optional deps for blockchain/network/security helpers. |
+| From source | `./install.sh` | Installs `.[full]` and attempts Rust VM build when `cargo` exists. |
+| Optional Rust VM (`zexus_core`) | `pip install maturin && maturin develop -m rust_core/Cargo.toml --release` | Requires Rust toolchain; otherwise Zexus falls back automatically. |
+| Node/npm distribution | `npm i zexus` | Runs `pip install --user "zexus[full]"` and best-effort builds `zexus_core` if Rust is available. |
+
 **Includes:**
 - `zx` - Main Zexus CLI
 - `zpm` - Zexus Package Manager
@@ -597,14 +613,26 @@ pip install zexus
 ```bash
 git clone https://github.com/Zaidux/zexus-interpreter.git
 cd zexus-interpreter
-pip install -e .
+./install.sh
+
+# Or, directly via pip:
+pip install -e ".[full]"
+```
+
+### Optional: Enable Rust VM (`zexus_core`)
+
+If you have a Rust toolchain installed (`cargo` on PATH), you can build the Rust VM extension from source:
+
+```bash
+pip install maturin
+maturin develop -m rust_core/Cargo.toml --release
 ```
 
 ### Verify Installation
 
 ```bash
-zx --version   # Should show: Zexus v1.6.3
-zpm --version  # Should show: ZPM v1.6.3
+zx --version
+zpm --version
 ```
 
 ---
@@ -2592,6 +2620,29 @@ See [Ecosystem Strategy](docs/ECOSYSTEM_STRATEGY.md) for detailed roadmap.
 - Consider using `native` keyword for C/C++ FFI
 - Profile with `memory_stats()` to check for leaks
 
+#### PyPI upload fails on Termux with: "unsupported platform tag 'linux_aarch64'"
+- PyPI rejects wheels with generic `linux_*` platform tags (common when building on Termux).
+- **Fix**: upload an sdist (source distribution) and/or a pure-Python wheel:
+  - `python -m pip install --upgrade build twine`
+  - `python -m build`  # creates `dist/*.tar.gz` and (by default) a `py3-none-any.whl`
+  - `python -m twine upload dist/*.tar.gz dist/*-py3-none-any.whl`
+- `ZEXUS_BUILD_EXTENSIONS=1 python -m build` means: **build the optional native extensions** (Cython/C/C++) *in addition* to the Python code (it does not skip Python). This produces a **platform-specific** wheel.
+- If you want “everything compiled” locally, use:
+  - `ZEXUS_BUILD_EXTENSIONS=1 python -m build`
+  - or `ZEXUS_BUILD_EXTENSIONS=1 python -m pip install .`
+- For publishing native wheels to PyPI, build them in a manylinux environment (e.g. GitHub Actions + cibuildwheel). Wheels built on Termux are usually **not** PyPI-uploadable.
+  - This repo includes a workflow you can run: `.github/workflows/wheels.yml` (builds manylinux `aarch64` + `x86_64`, plus macOS/Windows wheels).
+  - To publish from GitHub Actions without API tokens, use **PyPI Trusted Publishing**:
+    - PyPI → your project → **Settings** → **Publishing** → **Trusted publishers** → **Add a new trusted publisher**
+    - Provider: **GitHub Actions**
+    - Owner: `Zaidux` (or your GitHub org/user)
+    - Repository: `zexus-interpreter`
+    - Workflow: `.github/workflows/wheels.yml`
+    - Environment: `pypi` (and optionally also add another trusted publisher entry for `testpypi`)
+    - Then either:
+      - Run **Actions → “Build wheels (cibuildwheel)” → Run workflow** and choose `testpypi` first, or
+      - Push a release tag like `v1.7.3` to auto-build + publish
+
 #### Blockchain/Contract issues
 - Remember `TX` is a global context object (uppercase)
 - Use `persistent storage` for contract state

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zexus",
-  "version": "1.7.2",
+  "version": "1.8.1",
   "description": "A modern, security-first programming language with blockchain support",
   "main": "index.js",
   "bin": {
@@ -52,6 +52,7 @@
   "files": [
     "bin/",
     "src/",
+    "rust_core/",
     "zexus.json",
     "shared_config.json",
     "README.md",