@repeato/native-cv 0.1.1

package/LICENSE

@@ -0,0 +1,28 @@
+Proprietary License
+
+Copyright (c) 2025 NetRabbit e.U. All rights reserved.
+
+This software and associated documentation files (the "Software") are the 
+proprietary property of NetRabbit e.U.
+
+Permission is hereby granted to use the Software solely in connection with 
+Repeato products and services. 
+
+The following restrictions apply:
+
+1. You may NOT modify, adapt, or create derivative works of the Software.
+2. You may NOT reverse engineer, decompile, or disassemble the Software.
+3. You may NOT redistribute, sublicense, sell, or transfer the Software to 
+   any third party without prior written consent from NetRabbit e.U.
+4. You may NOT use the Software for any purpose other than in connection 
+   with Repeato products and services.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+For licensing inquiries, contact: info@repeato.app

package/README.internal.md

@@ -0,0 +1,144 @@
+# repeato-native-cv
+
+Native OpenCV-based template matching module for Node.js with static linking for Electron distribution.
+
+## Features
+
+- **Static Linking**: All OpenCV dependencies are statically linked, no need for users to install OpenCV
+- **Electron Ready**: Pre-built for Electron applications
+- **Cross-Platform**: Supports macOS, Windows, and Linux
+- **Template Matching**: High-performance template matching using OpenCV
+- **SIFT Features**: Advanced feature detection and matching
+
+## Installation
+
+```bash
+npm install
+npm run build:static
+```
+
+For Electron apps:
+```bash
+npm run build:electron
+```
+
+## Usage
+
+```javascript
+const native = require('./build/Release/repeato-native-cv.node');
+
+// SiftObjectFinder requires parameters
+const sof = new native.SiftObjectFinder({
+  kMinMatches: 10,        // Minimum matches required
+  goodMatchTh: 0.75,      // Good match threshold (0.0-1.0)
+  clusterSearchRadius: 50  // Cluster search radius in pixels
+});
+
+// TemplateMatcherWorker can be instantiated without parameters
+const tmw = new native.TemplateMatcherWorker();
+```
+
+### Electron Integration
+
+```javascript
+const path = require('path');
+const native = require(path.join(__dirname, 'native', 'repeato-native-cv.node'));
+
+const sof = new native.SiftObjectFinder({
+  kMinMatches: 10,
+  goodMatchTh: 0.75,
+  clusterSearchRadius: 50
+});
+```
+
+## Build Scripts
+
+| Script | Description |
+|--------|-------------|
+| `npm run build:static` | Build with statically linked OpenCV (recommended) |
+| `npm run build:electron` | Build specifically for Electron |
+| `npm run build:all` | Cross-platform build for distribution |
+| `npm run clean` | Clean all build artifacts |
+| `npm run rebuild` | Clean and rebuild from scratch |
+| `npm test` | Run test suite |
+
+## Static Build
+
+The static build downloads OpenCV source and compiles it with static libraries. All OpenCV code is bundled into the final `.node` file.
+
+**Pros**:
+- No external dependencies
+- Perfect for Electron distribution
+- Users don't need to install OpenCV
+
+**Cons**:
+- Long build time (20+ minutes)
+- Larger module size
+
+**Verify no external dependencies**:
+```bash
+otool -L build/Release/repeato-native-cv.node
+# Should only show: /usr/lib/libc++.1.dylib, /usr/lib/libSystem.B.dylib
+```
+
+## System Requirements
+
+### All Platforms
+- Node.js 16+
+- Python 3.9-3.12 (for node-gyp, see note below)
+- CMake 3.15+
+- C++14 compatible compiler
+
+### macOS
+- Xcode Command Line Tools
+- macOS 10.15+
+
+### Windows
+- Visual Studio Build Tools 2019+
+- Windows 10+
+
+### Linux
+- GCC 7+ or Clang 6+
+- Build essentials (cmake, git, pkg-config)
+
+## Troubleshooting
+
+### Python Version Issues
+```
+Error: ModuleNotFoundError: No module named 'distutils'
+```
+**Solution**: Python 3.13+ removed `distutils`. Use Python 3.9-3.12:
+```bash
+npm config set python /opt/homebrew/opt/python@3.9/bin/python3.9
+```
+
+### Corrupted Downloads
+```
+Error: Failed to extract file
+```
+**Solution**: Delete `deps/` folder and retry:
+```bash
+rm -rf deps/ build/
+npm run build:static
+```
+
+## File Structure
+
+```
+repeato-native-cv/
+├── src/
+│   ├── module.cc              # Main N-API module
+│   ├── template_matcher.cc    # Template matching implementation
+│   └── sift_object_finder.cc  # SIFT/ORB object detection
+├── scripts/
+│   ├── download-opencv.js     # OpenCV download/build
+│   ├── build-electron.js      # Electron build script
+│   └── build-all.js           # Full build orchestrator
+├── binding.gyp                # Node.js build configuration
+└── build/Release/
+    └── repeato-native-cv.node # Built module
+```
+
+## License
+
+MIT

package/README.md

@@ -0,0 +1,5 @@
+# repeato-native-cv
+
+Native OpenCV-based computer vision module for Node.js with static linking for Electron distribution.
+
+Used in Repeato-CLI and Repeato-Studio. Learn more at https://www.repeato.app

package/Rect.js

@@ -0,0 +1,31 @@
+// Rect class for representing rectangles
+class Rect {
+  constructor(x, y, width, height) {
+    this.x = x || 0;
+    this.y = y || 0;
+    this.width = width || 0;
+    this.height = height || 0;
+  }
+  
+  get area() {
+    return this.width * this.height;
+  }
+  
+  get center() {
+    return {
+      x: this.x + this.width / 2,
+      y: this.y + this.height / 2
+    };
+  }
+  
+  contains(x, y) {
+    return x >= this.x && x < this.x + this.width &&
+           y >= this.y && y < this.y + this.height;
+  }
+  
+  toString() {
+    return `Rect(${this.x}, ${this.y}, ${this.width}, ${this.height})`;
+  }
+}
+
+module.exports = Rect;

package/Vec3.js

@@ -0,0 +1,32 @@
+// Vec3 class for representing 3D vectors
+class Vec3 {
+  constructor(x, y, z) {
+    this.x = x || 0;
+    this.y = y || 0;
+    this.z = z || 0;
+  }
+  
+  get length() {
+    return Math.sqrt(this.x * this.x + this.y * this.y + this.z * this.z);
+  }
+  
+  normalize() {
+    const len = this.length;
+    if (len === 0) return new Vec3();
+    return new Vec3(this.x / len, this.y / len, this.z / len);
+  }
+  
+  add(other) {
+    return new Vec3(this.x + other.x, this.y + other.y, this.z + other.z);
+  }
+  
+  dot(other) {
+    return this.x * other.x + this.y * other.y + this.z * other.z;
+  }
+  
+  toString() {
+    return `Vec3(${this.x}, ${this.y}, ${this.z})`;
+  }
+}
+
+module.exports = Vec3;

package/index.js

@@ -0,0 +1,17 @@
+// Main entry point for repeato-native-cv module
+// Uses node-gyp-build to load prebuilt binaries
+
+const nativeCV = require('node-gyp-build')(__dirname);
+
+// Export the native functions directly
+module.exports = {
+  TemplateMatcher: nativeCV.TemplateMatcher,
+  SiftObjectFinder: nativeCV.SiftObjectFinder,
+  
+  // JavaScript wrapper classes
+  Rect: require('./Rect.js'), 
+  Vec3: require('./Vec3.js'),
+  
+  // Native module for direct access
+  native: nativeCV
+};

package/native.js

@@ -0,0 +1,50 @@
+const path = require('path')
+
+let native
+const isProduction = process.env.NODE_ENV === 'production'
+
+// Try different loading paths (primary dev + optional production) - removed fragile upward path
+const tryPaths = [
+  path.join(__dirname, 'build/Release/repeato-native-cv.node'),
+  isProduction ? path.join(process.resourcesPath || __dirname, 'native/repeato-native-cv.node') : null
+].filter(Boolean)
+
+let lastError
+for (const modulePath of tryPaths) {
+  try {
+    if (!isProduction) console.log('[native-cv] Trying to load native module from:', modulePath)
+    // eslint-disable-next-line import/no-dynamic-require, global-require
+    native = require(modulePath)
+    if (!isProduction) console.log('[native-cv] Loaded native module:', modulePath)
+    break
+  } catch (e) {
+    lastError = e
+  }
+}
+
+if (!native) {
+  console.error('[native-cv] Failed to load native module.')
+  console.error('[native-cv] Tried paths:')
+  tryPaths.forEach(p => console.error('  -', p))
+  console.error('[native-cv] Last error:', lastError?.message)
+
+  const errorMessage = `Native OpenCV module not found. Build it first:\n  cd repeato-native-cv && npm run build\nTried paths:\n${tryPaths.map(p=>`  - ${p}`).join('\n')}\nLast error: ${lastError?.message}`
+  const makeMissing = (name) => function () { throw new Error(errorMessage + `\nRequested native class: ${name}`) }
+
+  native = {
+    TemplateMatcherWorker: makeMissing('TemplateMatcherWorker'),
+    SiftObjectFinder: makeMissing('SiftObjectFinder')
+  }
+} else {
+  // Ensure both expected classes are present; if not, provide explicit error placeholders.
+  const expected = ['TemplateMatcherWorker', 'SiftObjectFinder']
+  for (const key of expected) {
+    if (!Object.prototype.hasOwnProperty.call(native, key)) {
+      const msg = `Native build missing expected export '${key}'. Did you forget to call ${key}::Init in module.cc?`
+      console.warn('[native-cv] ' + msg)
+      native[key] = () => { throw new Error(msg) }
+    }
+  }
+}
+
+module.exports = native

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@repeato/native-cv",
+  "version": "0.1.1",
+  "description": "Native OpenCV-based template matching module for Node.js, replacing opencv4nodejs-m1.",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "scripts": {
+    "install": "node-gyp-build",
+    "build": "node-gyp configure build",
+    "build:static": "node scripts/download-opencv.js && node-gyp configure build",
+    "build:electron": "node scripts/build-electron.js",
+    "build:all": "node scripts/build-all.js",
+    "build:prebuilt": "node scripts/build-prebuilt.js",
+    "prebuildify": "prebuildify --napi --strip",
+    "check-env": "node scripts/check-env.js",
+    "clean": "rm -rf build/ deps/ prebuilds/ && npm install",
+    "rebuild": "npm run clean && npm run build:static",
+    "test": "node test-runner.js",
+    "test:debug": "node test-runner.js --debug",
+    "test:verbose": "node test-runner.js --verbose",
+    "test:scale-invariant": "node test-runner.js --only-scale-invariant"
+  },
+  "gypfile": true,
+  "keywords": [
+    "opencv",
+    "native",
+    "template-matching",
+    "node-addon-api",
+    "computer-vision",
+    "electron"
+  ],
+  "author": "Repeato QA",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/repeato-qa/repeato-native-cv.git"
+  },
+  "dependencies": {
+    "node-addon-api": "^7.0.0",
+    "node-gyp-build": "^4.8.4"
+  },
+  "devDependencies": {
+    "chalk": "^5.6.2",
+    "meow": "^13.2.0",
+    "mocha": "^10.0.0",
+    "prebuildify": "^6.0.1"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "native.js",
+    "Vec3.js",
+    "Rect.js",
+    "prebuilds/",
+    "LICENSE"
+  ],
+  "os": [
+    "darwin",
+    "win32",
+    "linux"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "binary": {
+    "napi_versions": [
+      3
+    ]
+  }
+}