macos-vision 0.1.1 → 0.1.3

package/README.md

@@ -22,7 +22,41 @@ npm install macos-vision
 
 The native Swift binary is compiled automatically on install.
 
-## Usage
+## CLI
+
+```bash
+# OCR — plain text (default)
+npx macos-vision photo.jpg
+
+# Structured OCR blocks with bounding boxes
+npx macos-vision --blocks photo.jpg
+
+# Detect faces
+npx macos-vision --faces photo.jpg
+
+# Detect barcodes and QR codes
+npx macos-vision --barcodes photo.jpg
+
+# Detect rectangular shapes
+npx macos-vision --rectangles photo.jpg
+
+# Find document boundary
+npx macos-vision --document photo.jpg
+
+# Classify image content
+npx macos-vision --classify photo.jpg
+
+# Run all detections at once
+npx macos-vision --all photo.jpg
+```
+
+Multiple flags can be combined: `npx macos-vision --blocks --faces --classify photo.jpg`
+
+Structured results are printed as JSON to stdout.
+
+---
+
+## API
 
 ```js
 import { ocr, detectFaces, detectBarcodes, detectRectangles, detectDocument, classify } from 'macos-vision'

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { ocr, detectFaces, detectBarcodes, detectRectangles, detectDocument, classify, } from './index.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const USAGE = `
+Usage: vision-cli [options] <image>
+
+Options:
+  --ocr           OCR — plain text (default)
+  --blocks        OCR — structured blocks with coordinates
+  --faces         Face detection
+  --barcodes      Barcode & QR code detection
+  --rectangles    Rectangle detection
+  --document      Document boundary detection
+  --classify      Image classification
+  --all           Run all of the above
+
+  --help          Show this help
+
+Examples:
+  vision-cli photo.jpg
+  vision-cli --blocks --faces photo.jpg
+  vision-cli --all photo.jpg
+`.trim();
+const rawArgs = process.argv.slice(2);
+if (rawArgs.includes('--help') || rawArgs.length === 0) {
+    console.log(USAGE);
+    process.exit(0);
+}
+const flags = new Set(rawArgs.filter(a => a.startsWith('--')));
+const fileArgs = rawArgs.filter(a => !a.startsWith('--'));
+const imagePath = fileArgs[0] || resolve(__dirname, '../test/fixtures/sample.png');
+const runAll = flags.has('--all');
+const runOcr = runAll || flags.has('--ocr');
+const runBlocks = runAll || flags.has('--blocks');
+const runFaces = runAll || flags.has('--faces');
+const runBarcodes = runAll || flags.has('--barcodes');
+const runRects = runAll || flags.has('--rectangles');
+const runDoc = runAll || flags.has('--document');
+const runClassify = runAll || flags.has('--classify');
+// Default: OCR text when no feature flag is given
+const anyFeatureFlag = runAll || flags.has('--ocr') || flags.has('--blocks') ||
+    flags.has('--faces') || flags.has('--barcodes') || flags.has('--rectangles') ||
+    flags.has('--document') || flags.has('--classify');
+const useDefault = !anyFeatureFlag;
+async function main() {
+    try {
+        if (useDefault || runOcr) {
+            const text = await ocr(imagePath);
+            console.log(text);
+        }
+        if (runBlocks) {
+            const blocks = await ocr(imagePath, { format: 'blocks' });
+            console.log(JSON.stringify(blocks, null, 2));
+        }
+        if (runFaces) {
+            const faces = await detectFaces(imagePath);
+            console.log(JSON.stringify(faces, null, 2));
+        }
+        if (runBarcodes) {
+            const barcodes = await detectBarcodes(imagePath);
+            console.log(JSON.stringify(barcodes, null, 2));
+        }
+        if (runRects) {
+            const rectangles = await detectRectangles(imagePath);
+            console.log(JSON.stringify(rectangles, null, 2));
+        }
+        if (runDoc) {
+            const doc = await detectDocument(imagePath);
+            console.log(JSON.stringify(doc, null, 2));
+        }
+        if (runClassify) {
+            const labels = await classify(imagePath);
+            console.log(JSON.stringify(labels, null, 2));
+        }
+    }
+    catch (error) {
+        console.error('Error:', error);
+        process.exit(1);
+    }
+}
+main();

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "macos-vision",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Apple Vision OCR & image analysis for Node.js — native, fast, offline, no API keys",
   "author": "Adrian Wolczuk",
   "license": "MIT","type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "macos-vision": "./dist/cli.js"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/woladi/macos-vision.git"