@srsergio/taptapp-ar 1.0.10 → 1.0.11

package/README.md

@@ -1,18 +1,18 @@
 # @srsergio/taptapp-ar
 
-🚀 **TapTapp AR** is a high-performance Augmented Reality (AR) compiler toolkit for **Node.js** and **Browser** environments. It provides an ultra-fast offline compiler for image targets.
+🚀 **TapTapp AR** is a high-performance Augmented Reality (AR) toolkit for **Node.js** and **Browser** environments. It provides an ultra-fast offline compiler and a lightweight runtime for image tracking.
 
-Built with performance in mind, this package features a **pure JavaScript offline compiler** that requires **no TensorFlow** for compilation, generating high-quality `.mind` files in record time.
+**100% Pure JavaScript**: This package is now completely independent of **TensorFlow.js** for both compilation and real-time tracking, resulting in massive performance gains and zero-latency initialization.
 
 ---
 
 ## 🌟 Key Features
 
-- 🖼️ **Ultra-Fast Offline Compiler**: Pure JavaScript compiler that generates `.mind` target files in **~1.3s per image**.
-- ⚡ **Zero TensorFlow for Compilation**: The offline compiler uses optimized pure JS algorithms - no TensorFlow installation required.
-- 🧵 **Multi-threaded Engine**: Truly parallel processing using Node.js `worker_threads` for bulk image compilation.
-- 🚀 **Serverless Ready**: Lightweight compiler with minimal dependencies, perfect for Vercel, AWS Lambda, and Netlify.
-- 📦 **Protocol V3 (Columnar Binary)**: Industry-leading performance with zero-copy loading and 80%+ smaller files.
+- 🖼️ **Hyper-Fast Compiler**: Pure JavaScript compiler that generates `.mind` files in **< 0.9s per image**.
+- ⚡ **No TensorFlow Dependency**: No TFJS at all. Works natively in any JS environment (Node, Browser, Workers).
+- 🚀 **Protocol V3 (Columnar Binary)**: Zero-copy loading with 80%+ smaller files and CPU-cache alignment.
+- 🧵 **Optimized Runtime**: Tracking engine with **Buffer Recycling** and **Zero-Copy** for smooth 60fps AR on low-end devices.
+- 📦 **Framework Agnostic**: Includes wrappers for **A-Frame**, **Three.js**, and a raw **Controller** for custom engines.
 
 ---
 
@@ -22,79 +22,104 @@ Built with performance in mind, this package features a **pure JavaScript offlin
 npm install @srsergio/taptapp-ar
 ```
 
-### 📦 Optional Dependencies
-
-> **Note:** TensorFlow is **NOT required** for the offline compiler. It only uses pure JavaScript.
-
 ---
 
-## 🖼️ High-Performance Compiler (Protocol V3)
-
-TaptApp AR features the industry's most advanced **pure JavaScript** offline compiler. With the introduction of **Protocol V3 (Columnar Binary Format)**, it sets a new standard for AR asset management.
+## 📊 Industry-Leading Benchmarks (v3)
 
-### ⚡ Industry-Leading Benchmarks
-
-| Metric | Official MindAR | TapTapp AR (v3) | Improvement |
+| Metric | Official MindAR | TapTapp AR | Improvement |
 | :--- | :--- | :--- | :--- |
-| **Compilation Time** | ~23.50s | **~1.71s** | 🚀 **13.7x Faster** |
+| **Compilation Time** | ~23.50s | **~0.89s** | 🚀 **26x Faster** |
 | **Output Size (.mind)** | ~770 KB | **~127 KB** | 📉 **83.5% Smaller** |
-| **Loading Latency** | >100ms | **2.6ms** | ⚡ **Zero-Copy** |
-| **Memory Footprint** | Heavy (JSON Objects) | **Minimal (Binary)** | 🧠 **CPU-Aligned** |
-
-> *Tested on 1024x1024 high-detail image target.*
-
-### 🚀 Key Technical Breakthroughs
+| **Tracking Latency** | Variable (TFJS) | **Constant (Pure JS)** | ⚡ **Stable 60fps** |
+| **Dependency Size** | ~20MB (TFJS) | **< 100KB** | 📦 **99% Smaller Bundle** |
 
-- **Protocol V3 (Columnar Binary)**: Uses TypedArrays to store coordinates, angles, and descriptors in a cache-aligned layout. No more thousands of slow JavaScript objects.
-- **Zero-Copy Loading**: The runtime reads directly from the binary buffer. Initialization is now virtualy instant.
-- **Aggressive Matching Optimization**: Tree-based hierarchical clustering compacted into a flattened binary format.
-- **No Dependencies**: Works in Node.js and Browser with zero external requirements for the compilation core.
+---
 
-### 🖥️ Usage (Node.js & Serverless)
+## 🖼️ Compiler Usage (Node.js & Web)
 
-Optimized for server-side compilation with multi-core parallelism:
+The compiler is designed to run in workers (Node.js or Browser) for maximum performance.
 
 ```javascript
 import { OfflineCompiler } from '@srsergio/taptapp-ar';
 
 const compiler = new OfflineCompiler();
 
-// Compile target image
-const compiledData = await compiler.compileImageTargets(
+// Compile target image (provide grayscale pixel data)
+await compiler.compileImageTargets(
   [{ width, height, data: grayscaleUint8Array }], 
   (progress) => console.log(`Compiling: ${progress}%`)
 );
 
-// Export to Protocol V3 binary format
-const binaryBuffer = compiler.exportData(); // Yields a much smaller .mind file
+// Export to high-efficiency binary format
+const binaryBuffer = compiler.exportData(); 
 ```
 
-### 🌐 Frontend (Zero-Latency Loading)
+---
 
-```javascript
-import { OfflineCompiler } from '@srsergio/taptapp-ar';
+## 🎥 Runtime Usage (AR Tracking)
 
-const compiler = new OfflineCompiler();
-// Loading 127KB instead of 800KB saves bandwidth and CPU parsing time
-compiler.importData(binaryBuffer); 
+### 1. Simple A-Frame Integration
+The easiest way to use TapTapp AR in a web app:
+
+```html
+<script src="https://aframe.io/releases/1.5.0/aframe.min.js"></script>
+<script src="path/to/@srsergio/taptapp-ar/dist/index.js"></script>
+
+<a-scene mindar-image="imageTargetSrc: ./targets.mind;">
+  <a-camera position="0 0 0" look-controls="enabled: false"></a-camera>
+  <a-entity mindar-image-target="targetIndex: 0">
+    <a-plane position="0 0 0" height="0.552" width="1"></a-plane>
+  </a-entity>
+</a-scene>
 ```
 
----
+### 2. High-Performance Three.js Wrapper
+For custom Three.js applications:
 
-## 🏗 Development
+```javascript
+import { MindARThree } from '@srsergio/taptapp-ar';
 
-```bash
-# Install dependencies
-npm install
+const mindarThree = new MindARThree({
+  container: document.querySelector("#container"),
+  imageTargetSrc: './targets.mind',
+});
+
+const {renderer, scene, camera} = mindarThree;
 
-# Build the package
-npm run build
+const anchor = mindarThree.addAnchor(0);
+// Add your 3D models to anchor.group
+
+await mindarThree.start();
+renderer.setAnimationLoop(() => {
+  renderer.render(scene, camera);
+});
 ```
 
-The package uses **TypeScript** and exports both ESM and CJS compatible builds located in the `dist` folder.
+### 3. Raw Controller (Custom Logic)
+Use the `Controller` directly for maximum control:
+
+```javascript
+import { Controller } from '@srsergio/taptapp-ar';
+
+const controller = new Controller({
+  inputWidth: 640,
+  inputHeight: 480,
+  onUpdate: (data) => {
+    if (data.type === 'updateMatrix') {
+      // worldMatrix found! Apply to your 3D engine
+      const { targetIndex, worldMatrix } = data;
+    }
+  }
+});
+
+await controller.addImageTargets('./targets.mind');
+controller.processVideo(videoElement);
+```
 
 ---
 
-## 📄 License
+## 📄 License & Credits
 
 MIT © [srsergiolazaro](https://github.com/srsergiolazaro)
+
+Based on the core research of MindAR, but completely re-written for high-performance binary processing and JS-only execution.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@srsergio/taptapp-ar",
-    "version": "1.0.10",
+    "version": "1.0.11",
     "description": "AR Compiler for Node.js and Browser",
     "repository": {
         "type": "git",