@arcships/light-ocr 0.3.4 → 0.4.0

package/README.md

@@ -1,14 +1,10 @@
 # @arcships/light-ocr
 
-Offline OCR for Node.js applications, powered by PP-OCRv6 Small.
+The default PP-OCRv6 Small entry for `light-ocr`. It exact-pins one compatible model-free runtime and one Small model package, and remains the only owner of the `light-ocr` command.
 
 ```bash
 npm install @arcships/light-ocr
+light-ocr info --version
 ```
 
-The default PP-OCRv6 Small model is included as a required dependency; no
-runtime model download or postinstall compilation is used.
-
-Documentation: https://github.com/arcships/light-ocr
-
-License: Apache-2.0
+`0.4.0` is the N2 topology cutover: the facade contains only Small model configuration and delegates the API, native loading, EXIF handling, and CLI implementation to the shared runtime. Tiny and Medium use separate packages and commands, so installing this package still installs only Small.

package/package.json

@@ -1,52 +1,36 @@
 {
   "bin": {
-    "light-ocr": "./bin/light-ocr.cjs"
+    "light-ocr": "./src/cli.cjs"
   },
   "bugs": {
     "url": "https://github.com/arcships/light-ocr/issues"
   },
   "dependencies": {
-    "@arcships/light-ocr-model-ppocrv6-small": "0.3.4"
+    "@arcships/light-ocr-model-ppocrv6-small": "0.3.4",
+    "@arcships/light-ocr-runtime": "0.1.0"
   },
-  "description": "Offline PP-OCRv6 OCR for Node.js, powered by an embeddable C++ core",
+  "description": "Offline PP-OCRv6 Small OCR for Node.js — the stable default tier",
   "engines": {
     "node": "^22.0.0 || ^24.0.0"
   },
   "exports": {
     ".": {
-      "import": "./js/index.mjs",
-      "require": "./js/index.cjs",
-      "types": "./js/index.d.ts"
+      "import": "./src/index.mjs",
+      "require": "./src/index.cjs",
+      "types": "./src/index.d.ts"
     }
   },
   "files": [
-    "js/",
-    "bin/",
+    "src/",
     "README.md",
     "LICENSE",
     "NOTICE"
   ],
   "homepage": "https://github.com/arcships/light-ocr#readme",
-  "keywords": [
-    "ocr",
-    "offline-ocr",
-    "pp-ocrv6",
-    "paddleocr",
-    "node-api",
-    "napi"
-  ],
   "license": "Apache-2.0",
-  "main": "./js/index.cjs",
-  "module": "./js/index.mjs",
+  "main": "./src/index.cjs",
+  "module": "./src/index.mjs",
   "name": "@arcships/light-ocr",
-  "optionalDependencies": {
-    "@arcships/light-ocr-darwin-arm64": "0.3.4",
-    "@arcships/light-ocr-darwin-x64": "0.3.4",
-    "@arcships/light-ocr-linux-arm64-gnu": "0.3.4",
-    "@arcships/light-ocr-linux-x64-gnu": "0.3.4",
-    "@arcships/light-ocr-win32-arm64": "0.3.4",
-    "@arcships/light-ocr-win32-x64": "0.3.4"
-  },
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -56,6 +40,6 @@
     "url": "git+https://github.com/arcships/light-ocr.git"
   },
   "type": "commonjs",
-  "types": "./js/index.d.ts",
-  "version": "0.3.4"
+  "types": "./src/index.d.ts",
+  "version": "0.4.0"
 }

package/src/cli.cjs

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+'use strict';
+
+const facade = require('./index.cjs');
+const { createCli } = require('@arcships/light-ocr-runtime/cli');
+const { coreVersion } = require('@arcships/light-ocr-runtime/metadata');
+const packageMetadata = require('../package.json');
+
+const cli = createCli({
+  ...facade,
+  commandName: 'light-ocr',
+  packageVersion: packageMetadata.version,
+  coreVersion,
+});
+
+if (require.main === module) {
+  cli.main(process.argv.slice(2)).then((code) => {
+    if (code !== cli.EXIT.success) process.exitCode = code;
+  });
+}
+
+module.exports = cli;

package/src/index.cjs

@@ -0,0 +1,27 @@
+'use strict';
+
+const { createModelFacade } = require('@arcships/light-ocr-runtime/facade');
+
+module.exports = createModelFacade({
+  model: 'ppocrv6-small',
+  modelPackage: '@arcships/light-ocr-model-ppocrv6-small',
+  compatibleBundleIds: [
+    'ppocrv6-small-onnx-20260714.2',
+    'ppocrv6-small-apple-20260715.1',
+    'ppocrv6-small-webgpu-20260719.1',
+    'ppocrv6-small-native-20260719.1',
+  ],
+  appleBundleIds: [
+    'ppocrv6-small-apple-20260715.1',
+    'ppocrv6-small-native-20260719.1',
+  ],
+  profile: {
+    tier: 'small',
+    model: 'ppocrv6-small',
+    bundleId: 'ppocrv6-small-native-20260719.1',
+    languages: 50,
+    excludedLanguages: [],
+    dictionaryEntries: 18709,
+    maturity: 'stable',
+  },
+});

package/src/index.d.ts

@@ -0,0 +1,21 @@
+export * from '@arcships/light-ocr-runtime';
+
+import type {
+  CreateEngineOptions as RuntimeCreateEngineOptions,
+  ModelProfile,
+  OcrEngine,
+} from '@arcships/light-ocr-runtime';
+
+export type BuiltInModel = 'ppocrv6-small';
+
+export type CreateEngineOptions = Omit<RuntimeCreateEngineOptions, 'bundlePath'> & {
+  readonly model?: BuiltInModel;
+  readonly bundlePath?: string;
+};
+
+export function createEngine(options?: CreateEngineOptions): Promise<OcrEngine>;
+export const modelProfile: ModelProfile & {
+  readonly tier: 'small';
+  readonly model: BuiltInModel;
+  readonly maturity: 'stable';
+};

package/{js → src}/index.mjs

@@ -2,3 +2,4 @@ import cjs from './index.cjs';
 
 export const createEngine = cjs.createEngine;
 export const OcrError = cjs.OcrError;
+export const modelProfile = cjs.modelProfile;