@arcships/light-ocr 0.1.0 → 0.2.0

package/js/index.cjs

@@ -7,7 +7,7 @@ const { loadNative } = require('./load-native.cjs');
 
 const DEFAULT_MODEL = 'ppocrv6-small';
 const MODEL_PACKAGE = '@arcships/light-ocr-model-ppocrv6-small';
-const EXPECTED_BUNDLE_ID = 'ppocrv6-small-onnx-20260714.1';
+const EXPECTED_BUNDLE_ID = 'ppocrv6-small-onnx-20260714.2';
 
 class OcrError extends Error {
   constructor(code, message, detail) {
@@ -117,6 +117,14 @@ class OcrEngineImpl {
   }
 
   recognize(image, options = {}) {
+    return this.#recognize('recognize', image, options);
+  }
+
+  recognizeEncoded(data, options = {}) {
+    return this.#recognize('recognizeEncoded', data, options);
+  }
+
+  #recognize(nativeMethod, image, options) {
     let signal;
     let nativeOptions;
     try {
@@ -136,7 +144,7 @@ class OcrEngineImpl {
 
     let operation;
     try {
-      operation = this.#native.recognize(image, nativeOptions);
+      operation = this.#native[nativeMethod](image, nativeOptions);
     } catch (error) {
       return Promise.reject(normalizeNativeError(error));
     }

package/js/index.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="node" />
 
 export type PixelFormat = 'gray8' | 'rgb8' | 'bgr8' | 'rgba8';
-export type DetectionStrategy = 'bounded' | 'upstreamExact';
+export type DetectionStrategy = 'bounded' | 'tiled' | 'upstreamExact';
 export type BuiltInModel = 'ppocrv6-small';
 
 export interface DetectionOptions {
@@ -23,6 +23,7 @@ export interface ResourceLimits {
   readonly maxPixels: number;
   readonly maxDetectionSide: number;
   readonly maxDetectionCandidates: number;
+  readonly maxDetectionTiles: number;
   readonly maxRecognitionBatchSize: number;
   readonly maxRecognitionWidth: number;
   readonly maxTemporaryBytes: number;
@@ -35,7 +36,10 @@ export interface CreateEngineOptions {
   readonly interOpThreads?: number;
   readonly recognitionScoreThreshold?: number;
   readonly recognitionBatchSize?: number;
-  readonly reducedLimits?: ResourceLimits;
+  readonly reducedLimits?: Omit<ResourceLimits, 'maxDetectionTiles'> & {
+    /** Omission preserves the 0.1 reducedLimits source shape. */
+    readonly maxDetectionTiles?: number;
+  };
   readonly queueCapacity?: number;
   readonly maxPendingInputBytes?: number;
   readonly detection?: DetectionOptions;
@@ -64,6 +68,17 @@ export interface RecognitionBatchShape {
   readonly height: number;
   readonly width: number;
 }
+export interface DetectionPassShape {
+  readonly tileOrdinal: number;
+  readonly x: number;
+  readonly y: number;
+  readonly width: number;
+  readonly height: number;
+  readonly tensorWidth: number;
+  readonly tensorHeight: number;
+  readonly contourCandidates: number;
+  readonly rawCandidates: number;
+}
 export interface Diagnostics {
   readonly rejectedLines: readonly RejectedLine[];
   readonly warnings: readonly DiagnosticWarning[];
@@ -71,14 +86,20 @@ export interface Diagnostics {
   readonly acceptedBoxes: number;
   readonly detectionInputWidth: number;
   readonly detectionInputHeight: number;
+  readonly rawDetectionBoxes: number;
+  readonly suppressedDuplicateBoxes: number;
+  readonly maxLiveDetectionPassBuffers: number;
+  readonly detectionPasses: readonly DetectionPassShape[];
   readonly recognitionBatchShapes: readonly RecognitionBatchShape[];
 }
 export interface TimingUs {
   readonly total: number;
+  readonly decode: number;
   readonly inputValidation: number;
   readonly detectionPreprocess: number;
   readonly detectionInference: number;
   readonly detectionPostprocess: number;
+  readonly detectionMerge: number;
   readonly cropAndSort: number;
   readonly recognitionPreprocess: number;
   readonly recognitionInference: number;
@@ -92,16 +113,26 @@ export interface OcrResult {
   readonly timingUs: TimingUs;
   readonly diagnostics?: Diagnostics;
 }
+export interface TiledDetectionInfo {
+  readonly contractVersion: 'tiled-v1';
+  readonly tileSide: 1280;
+  readonly minimumOverlap: 128;
+  readonly artificialBoundaryMargin: 32;
+  readonly mergeIouThreshold: 0.5;
+  readonly mergeIosThreshold: 0.8;
+}
 export interface EngineInfo {
   readonly coreVersion: string;
   readonly modelBundleId: string;
   readonly modelBundleSchemaVersion: string;
+  readonly normalizedConfigSchemaVersion: string;
   readonly backend: string;
   readonly executionProvider: string;
   readonly capabilities: {
     readonly detection: boolean;
     readonly recognition: boolean;
     readonly textlineOrientation: boolean;
+    readonly tiledDetection: boolean;
   };
   readonly concurrencyMode: 'serialized_reject_when_busy';
   readonly limits: ResourceLimits & { readonly maxConcurrentCalls: 1 };
@@ -109,6 +140,7 @@ export interface EngineInfo {
   readonly interOpThreads: number;
   readonly detectionStrategy: DetectionStrategy;
   readonly detectionMaxSide: number;
+  readonly tiledDetection?: TiledDetectionInfo;
   readonly defaultRecognitionScoreThreshold: number;
   readonly defaultRecognitionBatchSize: number;
   readonly adapter: {
@@ -139,6 +171,7 @@ export class OcrError extends Error {
 export interface OcrEngine {
   readonly info: EngineInfo;
   recognize(image: RawImage, options?: RecognizeOptions): Promise<OcrResult>;
+  recognizeEncoded(data: Uint8Array, options?: RecognizeOptions): Promise<OcrResult>;
   close(): Promise<void>;
 }
 

package/package.json

@@ -3,7 +3,7 @@
     "url": "https://github.com/arcships/light-ocr/issues"
   },
   "dependencies": {
-    "@arcships/light-ocr-model-ppocrv6-small": "0.1.0"
+    "@arcships/light-ocr-model-ppocrv6-small": "0.2.0"
   },
   "description": "Offline PP-OCRv6 OCR for Node.js, powered by an embeddable C++ core",
   "engines": {
@@ -36,10 +36,10 @@
   "module": "./js/index.mjs",
   "name": "@arcships/light-ocr",
   "optionalDependencies": {
-    "@arcships/light-ocr-darwin-arm64": "0.1.0",
-    "@arcships/light-ocr-darwin-x64": "0.1.0",
-    "@arcships/light-ocr-linux-x64-gnu": "0.1.0",
-    "@arcships/light-ocr-win32-x64": "0.1.0"
+    "@arcships/light-ocr-darwin-arm64": "0.2.0",
+    "@arcships/light-ocr-darwin-x64": "0.2.0",
+    "@arcships/light-ocr-linux-x64-gnu": "0.2.0",
+    "@arcships/light-ocr-win32-x64": "0.2.0"
   },
   "publishConfig": {
     "access": "public",
@@ -51,5 +51,5 @@
   },
   "type": "commonjs",
   "types": "./js/index.d.ts",
-  "version": "0.1.0"
+  "version": "0.2.0"
 }