mini-jstorch 1.2.2 → 1.3.2

package/MODULE.md

@@ -0,0 +1,41 @@
+## MODULE STATS ##
+
+New Files that automatically will All notable changes status state to *Mini-JSTorch* will be documented in this file.
+
+# MSG
+
+btw. This files is actually would be modified and note all changes system state automatically without manual i type with myself.
+
+---
+
+**OFFICIAL RELEASE:** 2025-Monday-August-23 time: 2:22 AM (estimated time release)
+**VERSION:** 1.3.1
+**LICENSE:** MIT © 2025
+**AUTHOR:** Rizal
+**MODULE NAME:** mini-jstorch
+**MODULE DESC:** A lightweight JavaScript neural network library for rapid frontend AI experimentation on low-resource devices Inspired by PyTorch.
+**MODULE TYPE:** module
+**ENGINE VERSIONS:** 1.2.1
+**UPDATE TITLE:** `PATCH` update.
+**ADDED FILES/FOLDER:** {
+    "N/A" //N/A [N/A]
+}
+
+---
+
+**MODIFIED FILES:** {
+    "src" //folder
+    "src/startup.cpu" //files
+    "src/MainEngine.js" //files
+    "tests/tests.js" //files [npmignore detected]
+    "tests" //folder
+    "src/Dummy/exp.js" //files [npmignore detected]
+    "package.json" //files
+    "src/EngState.json" //files [npmignore detected]
+    "src/state.txt" //files [npmignore detected]
+    "README.md" //files
+    ".npmignore" //files [npmignore detected]
+    "N/A" //N/A [N/A]
+}
+
+---

package/README.md

@@ -1,17 +1,126 @@
-# MINI JSTORCH #
+# Mini-JSTorch
+
+A lightweight JavaScript neural network library for rapid frontend AI experimentation on low-resource devices Inspired by PyTorch.
+
+## Overview
+
+Mini-JSTorch is a lightweight, high-performance JavaScript library for building neural networks that runs efficiently in both frontend and backend environments, including low-end devices. The library enables experimentation and learning in AI without compromising stability, accuracy, or training reliability.
+
+This release, **version 1.2.3**, is a just some fix a typo and delete not used files.
+
+---
+
+## Features Overview
+
+- Full **Conv2D support** with forward and backward operations.
+- **Tensor operations** now support broadcasting and reshaping.
+- Added new activations:  `LeakyReLU`, `GELU`.
+- Optimizers: `Adam` and `SGD` fully integrated with gradient updates.
+- Dropout layer added for regularization.
+- Advanced utilities for tensor manipulation: `flatten`, `stack`, `concat`, `eye`, `reshape`.
+- End-to-end training and prediction workflow now fully tested.
+- Save and load model functionality included for seamless persistence.
+- Optimized performance for both frontend and backend usage.
+- Maintained backward compatibility for previous core layers and activations.
+- folder tests files template that you can use it before make your models.
+
+---
+
+## Features
+
+- **Core Layers**: Linear, Conv2D  
+- **Activations**: ReLU, Sigmoid, Tanh, LeakyReLU, GELU  
+- **Loss Functions**: MSELoss, CrossEntropyLoss  
+- **Optimizers**: Adam, SGD  
+- **Utilities**: zeros, randomMatrix, softmax, crossEntropy, dot, addMatrices, reshape, stack, flatten, eye, concat  
+- **Model Container**: Sequential (for stacking layers with forward/backward passes)  
+
+---
+
+## Installation
+
+```bash
+npm install mini-jstorch
+# Node.js v20+ recommended for best performance
+```
 
 ---
 
+## Quick Start Example
 
-**Just Empty.. this versions only an note do not use it for your projects models.**
-**I ONLY WANNA GIVE A MESSAGES IF THE MAJOR UPDATE WOULD BE COMING AT TIME 2:22 AM JUST BE READY FOR IT GUYS!**
+```javascript
+import { Sequential, Linear, ReLU, Sigmoid, CrossEntropyLoss, Adam } from './src/MainEngine.js';
 
-# HUGE THANKS 🎉 #
+// Build model
+const model = new Sequential([
+  new Linear(2,4),
+  new ReLU(),
+  new Linear(4,2),
+  new Sigmoid()
+]);
 
-I genuinely appreciate everyone who has taken the time to install and try out this module. Every download isn’t just a number it’s a real person spending their time to explore, learn, or build something with this module!
+// Sample XOR dataset
+const X = [
+  [0,0], [0,1], [1,0], [1,1]
+];
+const Y = [
+  [1,0], [0,1], [0,1], [1,0]
+];
 
-Reaching 400+ weekly downloads might sound small compared to giant frameworks, but for me it’s huge. It means this project is actually helping people out there, and that alone makes every late-night coding session worth it.
+// Loss & optimizer
+const lossFn = new CrossEntropyLoss();
+const optimizer = new Adam(model.parameters(), 0.1);
+
+// Training loop
+for (let epoch = 1; epoch <= 100; epoch++) {
+  const pred = model.forward(X);
+  const loss = lossFn.forward(pred, Y);
+  const gradLoss = lossFn.backward();
+  model.backward(gradLoss);
+  optimizer.step();
+  if (epoch % 20 === 0) console.log(`Epoch ${epoch}, Loss: ${loss.toFixed(4)}`);
+}
+
+// Prediction
+const predTest = model.forward(X);
+predTest.forEach((p,i) => {
+  const predictedClass = p.indexOf(Math.max(...p));
+  console.log(`Input: ${X[i]}, Predicted class: ${predictedClass}, Raw output: ${p.map(v => v.toFixed(3))}`);
+});
+```
+
+---
+
+## Save & Load Models
+
+```javascript
+import { saveModel, loadModel } from 'mini-jstorch';
+
+const json = saveModel(model);
+const model2 = new Sequential([...]); // same architecture
+loadModel(model2, json);
+```
+
+---
+
+## Intended Use Cases
+ - Rapid prototyping of neural networks in frontend and backend.
+ - Learning and teaching foundational neural network concepts.
+ - Experimentation on low-end devices or mobile browsers.
+ - Lightweight AI projects without GPU dependency.
+
+---
+
+# License
+
+**MIT © 2025 Rizal**
+
+---
 
-Thank you for giving this module a chance. Your support and trust are what keep this project moving forward! 🚀
+## Facts
 
-# BE READY FOR IT... SET YOUR TIME CLOCK. #
+- **This module is implemented entirely in pure JavaScript.**
+- **The `Dummy` folder contains modules used for development, testing, and debugging before integration into the main engine.**
+- **files startup.cpu is actually an some random files lol.**
+- **This module was created by a `single` developer.**
+- **You can join to the `mjs-group` Organization on my profile!**

package/hh.js

@@ -0,0 +1,38 @@
+import { Sequential, Linear, ReLU, Sigmoid, CrossEntropyLoss, Adam } from './src/MainEngine.js';
+
+// Build model
+const model = new Sequential([
+  new Linear(2,4),
+  new ReLU(),
+  new Linear(4,2),
+  new Sigmoid()
+]);
+
+// Sample XOR dataset
+const X = [
+  [0,0], [0,1], [1,0], [1,1]
+];
+const Y = [
+  [1,0], [0,1], [0,1], [1,0]
+];
+
+// Loss & optimizer
+const lossFn = new CrossEntropyLoss();
+const optimizer = new Adam(model.parameters(), 0.1);
+
+// Training loop
+for (let epoch = 1; epoch <= 500; epoch++) {
+  const pred = model.forward(X);
+  const loss = lossFn.forward(pred, Y);
+  const gradLoss = lossFn.backward();
+  model.backward(gradLoss);
+  optimizer.step();
+  if (epoch % 20 === 0) console.log(`Epoch ${epoch}, Loss: ${loss.toFixed(4)}`);
+}
+
+// Prediction
+const predTest = model.forward(X);
+predTest.forEach((p,i) => {
+  const predictedClass = p.indexOf(Math.max(...p));
+  console.log(`Input: ${X[i]}, Predicted class: ${predictedClass}, Raw output: ${p.map(v => v.toFixed(3))}`);
+});

package/index.js

@@ -1,6 +1,90 @@
-// Entry point of the library, export main classes and functions [DEPRECATED]
-export { Seq } from './models/seq.js';
-export { Dense } from './layers/dense.js';
-export * as act from './act/linear.js';
-export { SGD } from './optim/sgd.js';
-export { train } from './train/loop.js';
+// =====================================================
+// FILE: index.js - Main entry point
+// =====================================================
+
+// Import all modules
+import { Tensor } from './src/tensor.js';
+import { 
+    Linear, Dense, Conv2d, MaxPool2d, AvgPool2d, Flatten, Dropout, 
+    BatchNorm2d, ReLU, Sigmoid, Tanh, LeakyReLU, ELU, Softmax, Sequential 
+} from './src/layers.js';
+import { MSELoss, CrossEntropyLoss, BCELoss } from './src/loss.js';
+import { SGD, Adam, RMSprop } from './src/optimizers.js';
+import { Model, Trainer, models, optimizers, losses, layers, tensors, utils } from './src/model.js';
+
+// Export everything
+export {
+    // Core classes
+    Tensor,
+    Model,
+    Trainer,
+    
+    // Layer classes
+    Linear,
+    Dense,
+    Conv2d,
+    MaxPool2d,
+    AvgPool2d,
+    Flatten,
+    Dropout,
+    BatchNorm2d,
+    ReLU,
+    Sigmoid,
+    Tanh,
+    LeakyReLU,
+    ELU,
+    Softmax,
+    Sequential,
+    
+    // Loss classes
+    MSELoss,
+    CrossEntropyLoss,
+    BCELoss,
+    
+    // Optimizer classes
+    SGD,
+    Adam,
+    RMSprop,
+    
+    // Factory functions
+    models,
+    optimizers,
+    losses,
+    layers,
+    tensors,
+    utils
+};
+
+// Default export
+export default {
+    Tensor,
+    Model,
+    Trainer,
+    Linear,
+    Dense,
+    Conv2d,
+    MaxPool2d,
+    AvgPool2d,
+    Flatten,
+    Dropout,
+    BatchNorm2d,
+    ReLU,
+    Sigmoid,
+    Tanh,
+    LeakyReLU,
+    ELU,
+    Softmax,
+    Sequential,
+    MSELoss,
+    CrossEntropyLoss,
+    BCELoss,
+    SGD,
+    Adam,
+    RMSprop,
+    models,
+    optimizers,
+    losses,
+    layers,
+    tensors,
+    utils
+};

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "mini-jstorch",
-  "version": "1.2.2",
+  "version": "1.3.2",
   "type": "module", 
   "description": "A lightweight JavaScript neural network library for rapid frontend AI experimentation on low-resource devices Inspired by PyTorch.",
   "main": "index.js",
   "keywords": [
     "neural-network",
     "javascript",
+    "lightweight-torch",
     "lightweight",
+    "small",
+    "javascript-torch",
     "ai",
     "jstorch",
     "pytorch",