numpy-ts 0.5.0 → 0.7.0

package/README.md

@@ -3,22 +3,20 @@
 ![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
 [![npm version](https://img.shields.io/npm/v/numpy-ts)](https://www.npmjs.com/package/numpy-ts)
 ![bundle size](https://img.shields.io/bundlephobia/minzip/numpy-ts)
-![Under Construction](https://img.shields.io/badge/Under%20Construction-red)
+![numpy api coverage](https://img.shields.io/badge/numpy_api_coverage-65%20%25-yellow)
 
 ```
-                                        _            
- _ __  _   _ _ __ ___  _ __  _   _ ____| |_ ___ 
-| '_ \| | | | '_ ` _ \| '_ \| | | |____| __/ __)
-| | | | |_| | | | | | | |_) | |_| |    | |_\__ \
-|_| |_|\__,_|_| |_| |_| .__/ \__, |     \__(___/              
-                      |_|    (___/                
+███╗   ██╗██╗   ██╗███╗   ███╗██████╗ ██╗   ██╗  ████████╗███████╗
+████╗  ██║██║   ██║████╗ ████║██╔══██╗╚██╗ ██╔╝  ╚══██╔══╝██╔════╝
+██╔██╗ ██║██║   ██║██╔████╔██║██████╔╝ ╚████╔╝█████╗██║   ███████╗
+██║╚██╗██║██║   ██║██║╚██╔╝██║██╔═══╝   ╚██╔╝ ╚════╝██║   ╚════██║
+██║ ╚████║╚██████╔╝██║ ╚═╝ ██║██║        ██║        ██║   ███████║
+╚═╝  ╚═══╝ ╚═════╝ ╚═╝     ╚═╝╚═╝        ╚═╝        ╚═╝   ╚══════╝
 ```
 
 Complete NumPy implementation for TypeScript and JavaScript
 
-> **⚠️ Under active development** — API may change before v1.0
-
-A faithful NumPy 2.0+ implementation for TypeScript/JavaScript, validated against Python NumPy. **128 of 333 NumPy functions (38.4% complete)** covering array creation, manipulation, linear algebra, reductions, and more.
+**⚠️ Under active development** — API may change before v1.0
 
 ```bash
 npm install numpy-ts
@@ -26,8 +24,8 @@ npm install numpy-ts
 
 ## Why numpy-ts?
 
-- **📊 Extensive API** — 120+ NumPy functions with 1365+ tests validated against Python NumPy
-- **✅ NumPy-validated** — 1365+ test cases cross-validated against Python NumPy
+- **📊 Extensive API** — **218 of 333 NumPy functions (65.5% coverage)**
+- **✅ NumPy-validated** — 2000+ test cases cross-validated against Python NumPy
 - **🔒 Type-safe** — Full TypeScript support with shape and dtype inference
 - **🌐 Universal** — Works in Node.js and browsers with .npy/.npz file support
 - **🎯 Zero dependencies** — Pure TypeScript, no heavy external libraries
@@ -64,17 +62,17 @@ Progress toward complete NumPy API compatibility:
 
 | Category | Complete | Total | Status |
 |----------|----------|-------|--------|
+| **Arithmetic** | 19/19 | 100% | ✅ |
+| **Array Creation** | 32/32 | 100% | ✅ |
+| **Array Manipulation** | 35/35 | 100% | ✅ |
+| **Bit Operations** | 9/9 | 100% | ✅ |
+| **Broadcasting** | 3/3 | 100% | ✅ |
+| **Comparison** | 10/10 | 100% | ✅ |
 | **Hyperbolic** | 6/6 | 100% | ✅ |
-| **Comparison** | 9/10 | 90% | 🟡 |
-| **Trigonometric** | 10/12 | 83% | 🟡 |
-| **Arithmetic** | 13/19 | 68% | 🟡 |
-| **Broadcasting** | 2/3 | 67% | 🟡 |
-| **Linear Algebra** | 6/9 | 67% | 🟡 |
-| **Array Creation** | 17/32 | 53% | 🟡 |
-| **Array Manipulation** | 18/35 | 51% | 🟡 |
-| **Reductions** | 11/30 | 37% | 🔴 |
-| **Indexing** | 3/20 | 15% | 🔴 |
-| **Bit Operations** | 0/9 | 0% | 🔴 |
+| **Indexing** | 20/20 | 100% | ✅ |
+| **Linear Algebra** | 9/9 | 100% | ✅ |
+| **Reductions** | 30/30 | 100% | ✅ |
+| **Trigonometric** | 12/12 | 100% | ✅ |
 | **Exponential** | 0/9 | 0% | 🔴 |
 | **FFT** | 0/18 | 0% | 🔴 |
 | **Gradient** | 0/4 | 0% | 🔴 |
@@ -89,7 +87,7 @@ Progress toward complete NumPy API compatibility:
 | **Sorting** | 0/6 | 0% | 🔴 |
 | **Statistics** | 0/9 | 0% | 🔴 |
 
-**Overall: 128/333 functions (38.4% complete)**
+**Overall: 218/333 functions (65.5% complete)**
 
 See the complete [API Reference](docs/API-REFERENCE.md) for detailed function list.
 
@@ -144,20 +142,20 @@ console.log(arr.flags.C_CONTIGUOUS); // true - row-major layout
 ## Architecture
 
 ```
-┌───────────────────────────────────┐
-│  NumPy-Compatible API             │
-│  Broadcasting, DType Promotion    │
-└─────────────────┬─────────────────┘
-                  │
-┌─────────────────┴─────────────────┐
-│  NDArray (Views & Memory Mgmt)    │
-│  Strided Arrays, Base Tracking    │
-└─────────────────┬─────────────────┘
-                  │- - - - - - - - - - - - - - - - - - - ┐  
-┌─────────────────┴─────────────────┐  ┌ ─ ─ ─ ─ ─ ─ ─ ─ ┴ ─ ─ ─ ─ ─ ─ ─ ─ ┐
-│  TypeScript / JavaScript Core     │  │  WASM Compute Engine (Future)     │
-│  Computational Engine             │  │  Optimized BLAS / arithmetic      │
-└───────────────────────────────────┘  └ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘
+┌─────────────────────────────────┐
+│  NumPy-Compatible API           │
+│  Broadcasting, DType Promotion  │
+└───────────────┬─────────────────┘
+                │
+┌───────────────┴─────────────────┐
+│  NDArray (Views & Memory Mgmt)  │
+│  Strided Arrays, Base Tracking  │
+└───────────────┬─────────────────┘
+                │- - - - - - - - - - - - - - - - - - ┐  
+┌───────────────┴─────────────────┐  ┌ ─ ─ ─ ─ ─ ─ ─ ┴ ─ ─ ─ ─ ─ ─ ─ ─┐
+│  TypeScript / JavaScript Core   │  │  WASM Compute Engine (Future)  │
+│  Computational Engine           │  │  Optimized BLAS / arithmetic   │
+└─────────────────────────────────┘  └ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─┘
 ```
 
 Pure TypeScript implementation built from scratch for correctness and NumPy compatibility.
@@ -239,7 +237,7 @@ arr.sum();  // Type: number
 
 | Feature | numpy-ts | numjs | ndarray | TensorFlow.js |
 |---------|----------|-------|---------|---------------|
-| NumPy API Coverage | 128/333 (38%) | ~20% | Different | ML-focused |
+| NumPy API Coverage | 218/333 (65%) | ~20% | Different | ML-focused |
 | TypeScript Native | ✅ Full | Partial | ❌ No | ✅ Yes |
 | NumPy Validated | ✅ 1365+ tests | Mostly | ❌ No | ❌ No |
 | .npy/.npz Files | ✅ v1/v2/v3 | ❌ No | ❌ No | ❌ No |