@srsergio/taptapp-ar 1.1.7 โ†’ 1.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +59 -21
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,11 +1,23 @@
1
- # @srsergio/taptapp-ar
1
+ <div align="center">
2
+
3
+ # ๐ŸŽฏ @srsergio/taptapp-ar
2
4
 
3
- [![npm version](https://img.shields.io/npm/v/@srsergio/taptapp-ar.svg?style=flat-square)](https://www.npmjs.com/package/@srsergio/taptapp-ar)
4
- [![npm downloads](https://img.shields.io/npm/dm/@srsergio/taptapp-ar.svg?style=flat-square)](https://www.npmjs.com/package/@srsergio/taptapp-ar)
5
+ <img src="./docs/images/hero-banner.png" alt="TapTapp AR - High Performance Augmented Reality" width="100%"/>
6
+
7
+ [![npm version](https://img.shields.io/npm/v/@srsergio/taptapp-ar.svg?style=flat-square&color=00D4AA)](https://www.npmjs.com/package/@srsergio/taptapp-ar)
8
+ [![npm downloads](https://img.shields.io/npm/dm/@srsergio/taptapp-ar.svg?style=flat-square&color=7C3AED)](https://www.npmjs.com/package/@srsergio/taptapp-ar)
5
9
  [![License: Fair Source-0.9](https://img.shields.io/badge/License-Fair_Source--0.9-blue.svg?style=flat-square)](./LICENSE)
6
- [![Bundle Size](https://img.shields.io/bundlephobia/minzip/@srsergio/taptapp-ar?style=flat-square)](https://bundlephobia.com/package/@srsergio/taptapp-ar)
10
+ [![Bundle Size](https://img.shields.io/bundlephobia/minzip/@srsergio/taptapp-ar?style=flat-square&color=F59E0B)](https://bundlephobia.com/package/@srsergio/taptapp-ar)
11
+ [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
12
+ [![Zero Dependencies](https://img.shields.io/badge/Dependencies-Zero_TFJS-22C55E?style=flat-square)](https://www.npmjs.com/package/@srsergio/taptapp-ar)
13
+
14
+ ### ๐Ÿš€ Ultra-Fast AR Tracking โ€ข 100% Pure JavaScript โ€ข No TensorFlow Required
15
+
16
+ </div>
17
+
18
+ ---
7
19
 
8
- ๐Ÿš€ **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.
20
+ **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.
9
21
 
10
22
  **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.
11
23
 
@@ -30,21 +42,22 @@
30
42
 
31
43
  ## ๐ŸŒŸ Key Features
32
44
 
33
- - ๐ŸŽญ **Non-Rigid Surface Tracking**: Supports curved and deformable surfaces using **Delaunay Meshes** and **Mass-Spring Relaxation**.
34
- - ๐Ÿš€ **Nanite-style Virtualized Features**: Single-pass multi-octave detection with stratified sampling.
35
- - โšก **No TensorFlow Dependency**: No TFJS at all. Works natively in any JS environment (Node, Browser, Workers).
36
- - ๐Ÿงฌ **Fourier Positional Encoding**: Uses high-frequency sine/cosine mappings (GPT-style) for neural-like spatial consistency.
37
- - ๐Ÿš€ **Protocol V11 (Nanite)**:
38
- - **Stratified Multi-Octave Sampling**: 300 reliable features per octave, capped at 1,200 total per target.
39
- - **Dynamic Scale Filtering (LOD)**: Runtime matching engine skips irrelevant octaves based on estimated scale.
40
- - **4-bit Packed Tracking Data**: Grayscale images are compressed to 4-bit depth, slashing file size.
41
- - **64-bit LSH Descriptors**: Optimized Locality Sensitive Hashing with XOR folding support.
42
- - ๐Ÿงต **HD Precision Tracking**: Default resolution upgraded to **1280x960 (HD)** for superior sharpness on modern displays.
43
- - โšก **Zero-Config JIT Compilation**: No need for offline tools. Just pass an image URL and the engine compiles it on the fly.
44
- - ๐Ÿ“ **Virtualized Scale Range**: Stable tracking from **20% (distant targets)** to **1000% (close-up)** using a single high-res keyframe.
45
- - โšก **Immediate AR Detection**: Optimized "warm-up" period (15 frames) with relaxed inlier thresholds (6 pts) for instant tracking lock.
46
- - ๐Ÿ“ฆ **Framework Agnostic**: Includes wrappers for **React**, **A-Frame**, **Three.js**, and a raw **Controller**.
47
- - ๐Ÿ“‰ **Ultra-Compact Files**: Output `.taar` files are now **~100KB** (vs ~380KB+ previously).
45
+ <div align="center">
46
+ <img src="./docs/images/features-grid.png" alt="TapTapp AR Key Features" width="600"/>
47
+ </div>
48
+
49
+ <br/>
50
+
51
+ | Feature | Description |
52
+ |---------|-------------|
53
+ | ๐ŸŽญ **Non-Rigid Tracking** | Curved & deformable surfaces with Delaunay Meshes |
54
+ | ๐Ÿš€ **Nanite-style Features** | Single-pass multi-octave detection |
55
+ | โšก **Zero Dependencies** | No TensorFlow.js - Pure JavaScript |
56
+ | ๐Ÿงฌ **Neural Encoding** | Fourier positional encoding (GPT-style) |
57
+ | ๐Ÿงต **HD Precision** | 1280x960 default resolution |
58
+ | โšก **JIT Compilation** | Pass an image URL, track instantly |
59
+ | ๐Ÿ“ **20% - 1000% Scale** | Extreme scale range from a single keyframe |
60
+ | ๐Ÿ“ฆ **~100KB Output** | Ultra-compact `.taar` files |
48
61
 
49
62
  ---
50
63
 
@@ -58,6 +71,12 @@ npm install @srsergio/taptapp-ar
58
71
 
59
72
  ## ๐Ÿ“Š Industry-Leading Benchmarks (v7 Moonshot)
60
73
 
74
+ <div align="center">
75
+ <img src="./docs/images/performance-chart.png" alt="Performance Comparison" width="500"/>
76
+ </div>
77
+
78
+ <br/>
79
+
61
80
  | Metric | Official MindAR | TapTapp AR V11 | Improvement |
62
81
  | :--- | :--- | :--- | :--- |
63
82
  | **Compilation Time** | ~23.50s | **~1.69s (HD)** | ๐Ÿš€ **~14x Faster** |
@@ -130,6 +149,12 @@ const tracker = await startTracking({
130
149
 
131
150
  ## ๐ŸŽฅ Runtime Usage (AR Tracking)
132
151
 
152
+ <div align="center">
153
+ <img src="./docs/images/ar-tracking-demo.png" alt="AR Tracking Pipeline" width="700"/>
154
+ </div>
155
+
156
+ <br/>
157
+
133
158
  ### 1. The Easy Way: React Component โš›๏ธ
134
159
 
135
160
  The simplest, zero-config way to add AR to your app:
@@ -256,6 +281,13 @@ import { TaarThree } from '@srsergio/taptapp-ar';
256
281
  ---
257
282
 
258
283
  ## ๐Ÿ—๏ธ Protocol V11 (Nanite Virtualized Format)
284
+
285
+ <div align="center">
286
+ <img src="./docs/images/architecture-flow.png" alt="Architecture Pipeline" width="700"/>
287
+ </div>
288
+
289
+ <br/>
290
+
259
291
  TapTapp AR uses a proprietary **Nanite-style Vision Codec** that is significantly more efficient than standard AR formats.
260
292
 
261
293
  - **Virtualized Multi-Octave Features**: Instead of storing redundant images for each scale, V11 stores a single high-res keyframe with features stratified across 6 octaves.
@@ -270,7 +302,13 @@ TapTapp AR uses a proprietary **Nanite-style Vision Codec** that is significantl
270
302
 
271
303
  ---
272
304
 
273
- ## ๏ฟฝ Visual Search & Embeddings (NEW!) ๐Ÿš€
305
+ ## ๐Ÿ” Visual Search & Embeddings (NEW!) ๐Ÿš€
306
+
307
+ <div align="center">
308
+ <img src="./docs/images/visual-search.png" alt="Visual Search & Embeddings" width="600"/>
309
+ </div>
310
+
311
+ <br/>
274
312
 
275
313
  TapTapp AR now includes a state-of-the-art **Image Embedding** system based on Hyperdimensional Computing (HDC). This allows you to convert any image into a tiny mathematical fingerprint (vector) for ultra-fast visual search, deduplication, and clustering.
276
314
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@srsergio/taptapp-ar",
3
- "version": "1.1.7",
3
+ "version": "1.1.8",
4
4
  "description": "Ultra-fast Augmented Reality (AR) SDK for Node.js and Browser. Image tracking with 100% pure JavaScript, zero-dependencies, and high-performance compilation.",
5
5
  "keywords": [
6
6
  "augmented reality",