@scanly/react 2.0.0

package/README.md

@@ -0,0 +1,3 @@
+# @scanly/react
+
+Thin lifecycle adapter around `@scanly/browser`. Decoding remains outside React; unmount disposes the browser session and Worker.

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { BrowserCaptureSession, type BrowserCaptureSessionOptions, type BrowserScanFileOptions } from "@scanly/browser";
+import type { ScanOutcome } from "@scanly/core";
+export interface UseScanlyResult {
+    session: BrowserCaptureSession;
+    outcome: ScanOutcome | null;
+    scanning: boolean;
+    scanFile(file: File, options?: BrowserScanFileOptions): Promise<ScanOutcome>;
+    cancel(): void;
+    reset(): void;
+}
+export declare function useScanly(options?: BrowserCaptureSessionOptions): UseScanlyResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACxH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7E,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,SAAS,CAAC,OAAO,GAAE,4BAAiC,GAAG,eAAe,CAsBrF"}

package/dist/index.js

@@ -0,0 +1,28 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+import { BrowserCaptureSession } from "@scanly/browser";
+export function useScanly(options = {}) {
+    const [session] = useState(() => new BrowserCaptureSession(options));
+    const [outcome, setOutcome] = useState(null);
+    const [scanning, setScanning] = useState(false);
+    useEffect(() => {
+        session.initialize();
+        session.start();
+        return () => { void session.dispose(); };
+    }, [session]);
+    const scanFile = useCallback(async (file, scanOptions = {}) => {
+        setScanning(true);
+        try {
+            const next = await session.scanFile(file, scanOptions);
+            setOutcome(next);
+            return next;
+        }
+        finally {
+            setScanning(false);
+        }
+    }, [session]);
+    const cancel = useCallback(() => { session.cancel(); setScanning(false); }, [session]);
+    const reset = useCallback(() => { session.cancel(); setScanning(false); setOutcome(null); }, [session]);
+    return { session, outcome, scanning, scanFile, cancel, reset };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAkE,MAAM,iBAAiB,CAAC;AAYxH,MAAM,UAAU,SAAS,CAAC,UAAwC,EAAE;IAClE,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,UAAU,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACd,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE,IAAU,EAAE,cAAsC,EAAE,EAAE,EAAE;QAC1F,WAAW,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACvD,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACd,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACvF,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACxG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACjE,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@scanly/react",
+  "version": "2.0.0",
+  "description": "React lifecycle adapter for Scanly browser SDK",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "@scanly/browser": "2.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=18 <20"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.3",
+    "react": "^18.3.1"
+  }
+}