@oxide-js/spiking 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# @oxide-js/spiking
+
+## 1.1.0
+
+### Minor Changes
+
+- 7db4802: Spiking Neural Networks (SNN) & JSON Compression
+
+  - Added new `@oxide-js/spiking` package for Biomimetic AI, featuring LIF dynamics and Hebbian Contrastive Learning.
+  - Optimized `BaseModel.serialize()` and `setWeights()` in `@oxide-js/models` to compress Float32Array into regular arrays, achieving up to 75% JSON size reductions.
+  - Added `mj.argmax` and `mj.threshold` primitives in `@oxide-js/core`.
+  - Included `"threshold"` activation typing inside `ActivationType`.

package/examples/demo.ts

@@ -0,0 +1,101 @@
+import { SpikingNetwork } from "../src/core/SpikingNetwork.js";
+import { STDP } from "../src/learning/STDP.js";
+import { PoissonEncoder } from "../src/encoding/PoissonEncoder.js";
+
+/**
+ * Simulasi Pengenalan Pola Sederhana menggunakan SNN
+ * --------------------------------------------------
+ * 1. Kita memiliki 3 neuron Input dan 1 neuron Output (Total 4 Neuron)
+ * 2. Input merepresentasikan intensitas sinyal (misalnya: [0.9, 0.1, 0.8])
+ * 3. Neuron Input terhubung ke Neuron Output
+ * 4. STDP akan mengamati dan memperkuat bobot dari input yang sering "menyala" (0.9 dan 0.8)
+ */
+async function runDemo() {
+  console.log("=== Memulai Simulasi SNN Add-Only ===\n");
+
+  // Konfigurasi
+  const NUM_INPUTS = 3;
+  const NUM_OUTPUTS = 1;
+  const TOTAL_NEURONS = NUM_INPUTS + NUM_OUTPUTS;
+  const TIME_STEPS = 100;
+
+  // 1. Inisialisasi Jaringan & Komponen
+  // Threshold di-set rendah agar output mudah menembakkan spike
+  const net = new SpikingNetwork(TOTAL_NEURONS, 0.8, 2.0);
+  const stdp = new STDP(net, {
+    learningRate: 0.05,
+    aPlus: 1.5,
+    aMinus: 0.5, // LTD diturunkan agar sinyal yang sering aktif (berkorelasi kuat) membesar
+    wMax: 10.0,
+    wMin: 0.0    // Bobot tidak boleh negatif dalam contoh ini
+  });
+  const encoder = new PoissonEncoder(1.0);
+
+  // Neuron Output berada di indeks ke-3 (karena 0,1,2 adalah input)
+  const OUTPUT_NEURON = 3;
+
+  // 2. Hubungkan Input ke Output dengan bobot awal yang seragam (kecil)
+  console.log("Membangun koneksi awal:");
+  for (let i = 0; i < NUM_INPUTS; i++) {
+    net.connect(i, OUTPUT_NEURON, 1.0);
+    console.log(`- Input Neuron ${i} -> Output Neuron ${OUTPUT_NEURON} (Bobot Awal: 1.0)`);
+  }
+  console.log("\n");
+
+  // 3. Menyiapkan Pola Input
+  // Neuron 0 (Sinyal Kuat), Neuron 1 (Sinyal Lemah), Neuron 2 (Sinyal Kuat)
+  const inputPattern = [0.9, 0.1, 0.8];
+  
+  let totalOutputSpikes = 0;
+
+  console.log(`Menjalankan simulasi selama ${TIME_STEPS} time-steps...`);
+  
+  for (let t = 0; t < TIME_STEPS; t++) {
+    // A. Encode sinyal input kontinu menjadi Spike
+    const currentSpikes = encoder.encodeArray(inputPattern);
+
+    // B. Injeksi spike input secara langsung ke neuron input
+    // (Beri potensial yang cukup agar mereka seketika menembakkan spike di step ini)
+    for (let i = 0; i < NUM_INPUTS; i++) {
+      if (currentSpikes[i] === 1) {
+        // Injeksi arus yang jauh di atas threshold (2.0) agar pasti spike
+        net.injectCurrent(i, 10.0); 
+      }
+    }
+
+    // C. Evaluasi Jaringan (Add-Only Propagation)
+    net.step();
+
+    // D. Hitung Spike Output
+    if (net.spikes[OUTPUT_NEURON] === 1) {
+      totalOutputSpikes++;
+    }
+
+    // E. Lakukan Proses Pembelajaran (Plasticity)
+    stdp.updateWeights();
+  }
+
+  // 4. Hasil Simulasi
+  console.log("\n=== Hasil Simulasi ===");
+  console.log(`Total tembakan (spikes) dari Neuron Output: ${totalOutputSpikes}`);
+  console.log("\nPerubahan Bobot Akhir (Setelah proses Belajar STDP):");
+  
+  for (let i = 0; i < NUM_INPUTS; i++) {
+    // Bobot ke-0 dari array koneksi neuron input 'i'
+    const finalWeight = net.weights[i][0];
+    const initialInput = inputPattern[i];
+    
+    let status = "";
+    if (finalWeight > 1.0) status = "📈 Diperkuat (LTP)";
+    else if (finalWeight < 1.0) status = "📉 Diperlemah (LTD)";
+    else status = "➖ Tetap";
+
+    console.log(`Neuron ${i} (Intensitas Sinyal: ${initialInput}) -> Bobot Akhir: ${finalWeight.toFixed(4)} ${status}`);
+  }
+
+  console.log("\nKesimpulan:");
+  console.log("Seperti yang terlihat, SNN secara otomatis mengenali dan memperkuat koneksi dari neuron input yang aktif (Intensitas 0.9 & 0.8),");
+  console.log("sementara neuron yang jarang aktif (Intensitas 0.1) bobotnya melemah secara natural melalui aturan STDP.");
+}
+
+runDemo().catch(console.error);

package/index.d.ts

@@ -0,0 +1,19 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+export declare function dotProductAddOnlyNative(aData: Float32Array, aRowsOrig: number, aColsOrig: number, bData: Float32Array, bRowsOrig: number, bColsOrig: number, transA: boolean, transB: boolean, outData: Float32Array): void
+export declare class NativeSpikingNetwork {
+  constructor(numNeurons: number, beta: number, defaultThreshold: number)
+  connect(pre: number, post: number, weight: number): void
+  injectCurrent(neuronIdx: number, current: number): void
+  inhibitRange(startIdx: number, endIdx: number, exceptIdx: number, current: number): void
+  step(): void
+  resetState(): void
+  getSpikes(): Array<number>
+  getPotentials(): Array<number>
+  updateStdp(learningRate: number, tauPlus: number, tauMinus: number, aPlus: number, aMinus: number, wMax: number, wMin: number): void
+  saveToFile(filepath: string): void
+  loadFromFile(filepath: string): void
+}

package/index.js

@@ -0,0 +1,316 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'spiking-native.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./spiking-native.android-arm64.node')
+          } else {
+            nativeBinding = require('@oxide-js/spiking-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'spiking-native.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./spiking-native.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('@oxide-js/spiking-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'spiking-native.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./spiking-native.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('@oxide-js/spiking-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'spiking-native.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./spiking-native.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('@oxide-js/spiking-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'spiking-native.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./spiking-native.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('@oxide-js/spiking-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'spiking-native.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./spiking-native.darwin-universal.node')
+      } else {
+        nativeBinding = require('@oxide-js/spiking-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'spiking-native.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./spiking-native.darwin-x64.node')
+          } else {
+            nativeBinding = require('@oxide-js/spiking-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'spiking-native.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./spiking-native.darwin-arm64.node')
+          } else {
+            nativeBinding = require('@oxide-js/spiking-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'spiking-native.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./spiking-native.freebsd-x64.node')
+      } else {
+        nativeBinding = require('@oxide-js/spiking-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'spiking-native.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./spiking-native.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('@oxide-js/spiking-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'spiking-native.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./spiking-native.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('@oxide-js/spiking-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'spiking-native.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./spiking-native.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('@oxide-js/spiking-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'spiking-native.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./spiking-native.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('@oxide-js/spiking-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'spiking-native.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./spiking-native.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('@oxide-js/spiking-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'spiking-native.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./spiking-native.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('@oxide-js/spiking-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'spiking-native.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./spiking-native.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('@oxide-js/spiking-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'spiking-native.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./spiking-native.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('@oxide-js/spiking-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'spiking-native.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./spiking-native.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('@oxide-js/spiking-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { NativeSpikingNetwork, dotProductAddOnlyNative } = nativeBinding
+
+module.exports.NativeSpikingNetwork = NativeSpikingNetwork
+module.exports.dotProductAddOnlyNative = dotProductAddOnlyNative

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@oxide-js/spiking",
+  "version": "1.1.0",
+  "type": "module",
+  "description": "Oxide-JS Spiking: Add-Only Event-Driven Spiking Neural Network implementation.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Akhyar11/Oxide-JS.git",
+    "directory": "packages/spiking"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "napi": {
+    "name": "spiking-native"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:rust": "napi build --platform --release --cargo-cwd src-rust",
+    "postinstall": "node -e \"try{require('child_process').execSync('npm run build:rust',{stdio:'inherit'})}catch(e){console.warn('[oxide-js/spiking] Rust native build skipped')}\""
+  },
+  "keywords": [
+    "snn",
+    "spiking",
+    "neuromorphic",
+    "add-only",
+    "oxide-js"
+  ],
+  "author": "Akhyar",
+  "license": "ISC",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@napi-rs/cli": "^2.18.0",
+    "@napi-rs/wasm-runtime": "^0.2.4"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+
+export { default as dotProductAddOnly } from "./math/dotProductAddOnly.js";
+export { SpikingDense, type SpikingDenseConfig } from "./layers/SpikingDense.js";
+export { SpikingEmbedding, type SpikingEmbeddingConfig } from "./layers/SpikingEmbedding.js";
+export { SpikingSentenceEmbedder, type SpikingSentenceConfig } from "./models/SpikingSentenceEmbedder.js";