@dcg-overseas/scanner 0.1.0

package/dist/index.cjs

@@ -0,0 +1,321 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  useScanner: () => useScanner
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/useScanner.ts
+var import_react = require("react");
+var import_cv_worker = require("@dcg-overseas/cv-worker");
+var import_core = require("@dcg-overseas/core");
+var SCAN_DIM = 720;
+var VALID_FRAMES_REQUIRED = 2;
+var QR_REALTIME_CROP_PX = 600;
+var BRACKET_INSET = 12;
+var BRACKET_LEN_RATIO = 0.08;
+var STATUS_BAR_H = 40;
+async function openCamera() {
+  return navigator.mediaDevices.getUserMedia({
+    video: { width: { ideal: 3840 }, height: { ideal: 2160 }, facingMode: { ideal: "environment" } },
+    audio: false
+  });
+}
+function countFound(result) {
+  const aruco = [0, 1, 2].filter((id) => result.arucoMarkers.some((m) => m.id === id)).length;
+  return aruco + (result.qrCode.found ? 1 : 0);
+}
+function useScanner() {
+  const videoRef = (0, import_react.useRef)(null);
+  const overlayRef = (0, import_react.useRef)(null);
+  const captureCanvasRef = (0, import_react.useRef)(null);
+  const streamRef = (0, import_react.useRef)(null);
+  const rafRef = (0, import_react.useRef)(null);
+  const detectingRef = (0, import_react.useRef)(false);
+  const validCountRef = (0, import_react.useRef)(0);
+  const overlayDimRef = (0, import_react.useRef)({ w: 0, h: 0 });
+  const offscreenRef = (0, import_react.useRef)(null);
+  const offscreenDimRef = (0, import_react.useRef)({ w: 0, h: 0 });
+  const qrCropCanvasRef = (0, import_react.useRef)(null);
+  const barcodeDetectorRef = (0, import_react.useRef)(void 0);
+  const qrValueRef = (0, import_react.useRef)("");
+  const [scanState, setScanState] = (0, import_react.useState)("init");
+  const [capturedUrl, setCapturedUrl] = (0, import_react.useState)("");
+  const [errorMsg, setErrorMsg] = (0, import_react.useState)("");
+  const [statusMsg, setStatusMsg] = (0, import_react.useState)("Loading OpenCV\u2026");
+  const [foundCount, setFoundCount] = (0, import_react.useState)(0);
+  const [qrValue, setQrValue] = (0, import_react.useState)("");
+  (0, import_react.useEffect)(() => {
+    return () => {
+      streamRef.current?.getTracks().forEach((t) => t.stop());
+      if (rafRef.current) cancelAnimationFrame(rafRef.current);
+    };
+  }, []);
+  const capturedUrlRef = (0, import_react.useRef)("");
+  (0, import_react.useEffect)(() => {
+    capturedUrlRef.current = capturedUrl;
+  }, [capturedUrl]);
+  (0, import_react.useEffect)(() => {
+    return () => {
+      if (capturedUrlRef.current) URL.revokeObjectURL(capturedUrlRef.current);
+    };
+  }, []);
+  const attachStream = (0, import_react.useCallback)(async (stream) => {
+    const video = videoRef.current;
+    video.srcObject = stream;
+    await video.play();
+  }, []);
+  (0, import_react.useEffect)(() => {
+    let cancelled = false;
+    (async () => {
+      try {
+        setStatusMsg("Loading OpenCV\u2026");
+        await (0, import_cv_worker.initWorker)();
+        if (cancelled) return;
+        setStatusMsg("Opening camera\u2026");
+        const stream = await openCamera();
+        if (cancelled) {
+          stream.getTracks().forEach((t) => t.stop());
+          return;
+        }
+        streamRef.current = stream;
+        await attachStream(stream);
+        setScanState("scanning");
+      } catch (e) {
+        if (!cancelled) {
+          setErrorMsg(e instanceof Error ? e.message : "Camera or OpenCV error");
+          setScanState("error");
+        }
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [attachStream]);
+  const drawOverlay = (0, import_react.useCallback)((found, result) => {
+    const canvas = overlayRef.current;
+    const video = videoRef.current;
+    if (!canvas || !video) return;
+    const ctx = canvas.getContext("2d");
+    const rect = video.getBoundingClientRect();
+    if (rect.width !== overlayDimRef.current.w || rect.height !== overlayDimRef.current.h) {
+      canvas.width = rect.width;
+      canvas.height = rect.height;
+      overlayDimRef.current = { w: rect.width, h: rect.height };
+    }
+    ctx.clearRect(0, 0, canvas.width, canvas.height);
+    const allFound = found === 4;
+    const color = allFound ? "#00ff88" : "#ff4444";
+    const label = allFound ? "\u2713 All markers found" : `${found} / 4 markers found`;
+    const bw = canvas.width, bh = canvas.height;
+    const len = Math.min(bw, bh) * BRACKET_LEN_RATIO;
+    ctx.strokeStyle = color;
+    ctx.lineWidth = 3;
+    const drawBracket = (x, y, dx, dy) => {
+      ctx.beginPath();
+      ctx.moveTo(x + dx * len, y);
+      ctx.lineTo(x, y);
+      ctx.lineTo(x, y + dy * len);
+      ctx.stroke();
+    };
+    drawBracket(BRACKET_INSET, BRACKET_INSET, 1, 1);
+    drawBracket(bw - BRACKET_INSET, BRACKET_INSET, -1, 1);
+    drawBracket(BRACKET_INSET, bh - BRACKET_INSET, 1, -1);
+    drawBracket(bw - BRACKET_INSET, bh - BRACKET_INSET, -1, -1);
+    if (result) {
+      const sx = bw / result.imageWidth;
+      const sy = bh / result.imageHeight;
+      const markerColors = { 0: "#00e5ff", 1: "#ffe100", 2: "#ff4f00" };
+      const markerLabels = { 0: "TL", 1: "BR", 2: "BL" };
+      for (const m of result.arucoMarkers) {
+        const mc = markerColors[m.id] ?? "#ffffff";
+        ctx.strokeStyle = mc;
+        ctx.lineWidth = 2;
+        ctx.beginPath();
+        m.corners.forEach((p, i) => {
+          if (i === 0) ctx.moveTo(p.x * sx, p.y * sy);
+          else ctx.lineTo(p.x * sx, p.y * sy);
+        });
+        ctx.closePath();
+        ctx.stroke();
+        ctx.fillStyle = mc;
+        ctx.font = "bold 12px sans-serif";
+        ctx.textAlign = "left";
+        ctx.fillText(markerLabels[m.id] ?? `A${m.id}`, m.center.x * sx + 4, m.center.y * sy - 4);
+      }
+      if (result.qrCode.found) {
+        ctx.fillStyle = "#00ff88";
+        ctx.font = "bold 12px sans-serif";
+        ctx.textAlign = "left";
+        ctx.fillText("QR \u2713", 4, 16);
+      }
+    }
+    ctx.fillStyle = "rgba(0,0,0,0.55)";
+    ctx.fillRect(0, bh - STATUS_BAR_H, bw, STATUS_BAR_H);
+    ctx.fillStyle = color;
+    ctx.font = `bold ${Math.round(bh * 0.022 + 11)}px sans-serif`;
+    ctx.textAlign = "center";
+    ctx.fillText(label, bw / 2, bh - 12);
+  }, []);
+  const captureBestFrame = (0, import_react.useCallback)(() => {
+    const canvas = captureCanvasRef.current;
+    streamRef.current?.getTracks().forEach((t) => t.stop());
+    streamRef.current = null;
+    canvas.toBlob((blob) => {
+      if (!blob) return;
+      if (capturedUrlRef.current) URL.revokeObjectURL(capturedUrlRef.current);
+      setCapturedUrl(URL.createObjectURL(blob));
+    }, "image/png");
+    setScanState("captured");
+    setQrValue(qrValueRef.current);
+  }, []);
+  const startDetection = (0, import_react.useCallback)(() => {
+    if (rafRef.current) cancelAnimationFrame(rafRef.current);
+    detectingRef.current = false;
+    validCountRef.current = 0;
+    const loop = async () => {
+      const video = videoRef.current;
+      if (!video || video.readyState < 2 || detectingRef.current) {
+        rafRef.current = requestAnimationFrame(loop);
+        return;
+      }
+      detectingRef.current = true;
+      try {
+        const { videoWidth: vw, videoHeight: vh } = video;
+        const captureCanvas = captureCanvasRef.current;
+        if (captureCanvas.width !== vw || captureCanvas.height !== vh) {
+          captureCanvas.width = vw;
+          captureCanvas.height = vh;
+        }
+        captureCanvas.getContext("2d").drawImage(video, 0, 0);
+        const scale = Math.min(1, SCAN_DIM / Math.max(vw, vh));
+        const w = Math.round(vw * scale), h = Math.round(vh * scale);
+        if (!offscreenRef.current || offscreenDimRef.current.w !== w || offscreenDimRef.current.h !== h) {
+          offscreenRef.current = new OffscreenCanvas(w, h);
+          offscreenDimRef.current = { w, h };
+        }
+        const ctx = offscreenRef.current.getContext("2d", { willReadFrequently: true });
+        ctx.drawImage(video, 0, 0, w, h);
+        const result = await (0, import_cv_worker.detectInImageData)(ctx.getImageData(0, 0, w, h));
+        if (barcodeDetectorRef.current === void 0) {
+          const BD = window.BarcodeDetector;
+          barcodeDetectorRef.current = BD ? new BD({ formats: ["qr_code"] }) : null;
+        }
+        const hasAllAruco = [0, 1, 2].every((id) => result.arucoMarkers.some((m) => m.id === id));
+        if (hasAllAruco) {
+          if (qrValueRef.current) {
+            result.qrCode = { found: true };
+          } else {
+            const qrCrop = (0, import_core.estimateQRCropBox)(result.arucoMarkers, w, h, vw, vh);
+            if (qrCrop) {
+              const cropScale = Math.min(1, QR_REALTIME_CROP_PX / Math.max(qrCrop.w, qrCrop.h));
+              const qrW = Math.max(1, Math.round(qrCrop.w * cropScale));
+              const qrH = Math.max(1, Math.round(qrCrop.h * cropScale));
+              if (!qrCropCanvasRef.current || qrCropCanvasRef.current.width !== qrW || qrCropCanvasRef.current.height !== qrH) {
+                qrCropCanvasRef.current = new OffscreenCanvas(qrW, qrH);
+              }
+              const qrCtx = qrCropCanvasRef.current.getContext("2d", { willReadFrequently: true });
+              qrCtx.drawImage(captureCanvas, qrCrop.x0, qrCrop.y0, qrCrop.w, qrCrop.h, 0, 0, qrW, qrH);
+              const qrDet = await (0, import_core.detectQRInCrop)(qrCropCanvasRef.current, { barcodeDetector: barcodeDetectorRef.current });
+              if (qrDet.found) {
+                result.qrCode = { found: true };
+                if (qrDet.rawValue) qrValueRef.current = qrDet.rawValue;
+              }
+            }
+          }
+        }
+        const found = countFound(result);
+        setFoundCount(found);
+        drawOverlay(found, result);
+        if (found === 4) {
+          validCountRef.current += 1;
+          if (validCountRef.current >= VALID_FRAMES_REQUIRED) {
+            if (rafRef.current) cancelAnimationFrame(rafRef.current);
+            rafRef.current = null;
+            captureBestFrame();
+            return;
+          }
+        } else {
+          validCountRef.current = 0;
+        }
+      } catch (e) {
+        console.warn("[useScanner] detection error", e);
+        validCountRef.current = 0;
+      } finally {
+        detectingRef.current = false;
+      }
+      rafRef.current = requestAnimationFrame(loop);
+    };
+    rafRef.current = requestAnimationFrame(loop);
+  }, [drawOverlay, captureBestFrame]);
+  (0, import_react.useEffect)(() => {
+    if (scanState === "scanning") startDetection();
+    return () => {
+      if (rafRef.current) cancelAnimationFrame(rafRef.current);
+    };
+  }, [scanState, startDetection]);
+  const restart = (0, import_react.useCallback)(async () => {
+    if (rafRef.current) {
+      cancelAnimationFrame(rafRef.current);
+      rafRef.current = null;
+    }
+    streamRef.current?.getTracks().forEach((t) => t.stop());
+    streamRef.current = null;
+    validCountRef.current = 0;
+    if (capturedUrlRef.current) {
+      URL.revokeObjectURL(capturedUrlRef.current);
+      setCapturedUrl("");
+    }
+    setFoundCount(0);
+    setQrValue("");
+    qrValueRef.current = "";
+    setErrorMsg("");
+    setStatusMsg("Opening camera\u2026");
+    setScanState("init");
+    try {
+      const stream = await openCamera();
+      streamRef.current = stream;
+      await attachStream(stream);
+      setScanState("scanning");
+    } catch (e) {
+      setErrorMsg(e instanceof Error ? e.message : "Camera error");
+      setScanState("error");
+    }
+  }, [attachStream]);
+  return {
+    videoRef,
+    overlayRef,
+    captureCanvasRef,
+    scanState,
+    capturedUrl,
+    errorMsg,
+    statusMsg,
+    foundCount,
+    qrValue,
+    restart
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useScanner
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/useScanner.ts"],"sourcesContent":["export { useScanner } from './useScanner';\nexport type { UseScannerReturn, ScanState } from './useScanner';\n","import { useCallback, useEffect, useRef, useState } from 'react';\nimport type { RefObject } from 'react';\nimport { initWorker, detectInImageData } from '@dcg-overseas/cv-worker';\nimport { estimateQRCropBox, detectQRInCrop } from '@dcg-overseas/core';\nimport type { DetectionResult } from '@dcg-overseas/types';\n\n// ── 检测常量 ──────────────────────────────────────────────────────────────────\nconst SCAN_DIM             = 720;   // 检测缩略图长边（px）\nconst VALID_FRAMES_REQUIRED = 2;    // 连续有效帧数阈值\nconst QR_REALTIME_CROP_PX  = 600;   // QR 裁切图上限（px），只缩小不放大\n\n// ── Overlay 绘制常量 ──────────────────────────────────────────────────────────\nconst BRACKET_INSET    = 12;    // 取景框括号内缩距离（px）\nconst BRACKET_LEN_RATIO = 0.08; // 括号边长占短边比例\nconst STATUS_BAR_H     = 40;    // 底部状态栏高度（px）\n\nexport type ScanState = 'init' | 'scanning' | 'captured' | 'error';\n\nexport interface UseScannerReturn {\n  // ── DOM refs（直接绑定到 JSX 元素）──────────────────────────────────────────\n  videoRef:         RefObject<HTMLVideoElement | null>;\n  overlayRef:       RefObject<HTMLCanvasElement | null>;\n  captureCanvasRef: RefObject<HTMLCanvasElement | null>;\n  // ── 状态 ─────────────────────────────────────────────────────────────────────\n  scanState:   ScanState;\n  capturedUrl: string;\n  errorMsg:    string;\n  statusMsg:   string;\n  foundCount:  number;\n  qrValue:     string;\n  // ── 动作 ─────────────────────────────────────────────────────────────────────\n  restart: () => Promise<void>;\n}\n\nasync function openCamera(): Promise<MediaStream> {\n  return navigator.mediaDevices.getUserMedia({\n    video: { width: { ideal: 3840 }, height: { ideal: 2160 }, facingMode: { ideal: 'environment' } },\n    audio: false,\n  });\n}\n\nfunction countFound(result: DetectionResult): number {\n  const aruco = [0, 1, 2].filter(id => result.arucoMarkers.some(m => m.id === id)).length;\n  return aruco + (result.qrCode.found ? 1 : 0);\n}\n\nexport function useScanner(): UseScannerReturn {\n  const videoRef         = useRef<HTMLVideoElement>(null);\n  const overlayRef       = useRef<HTMLCanvasElement>(null);\n  const captureCanvasRef = useRef<HTMLCanvasElement>(null);\n  const streamRef        = useRef<MediaStream | null>(null);\n  const rafRef           = useRef<number | null>(null);\n  const detectingRef     = useRef(false);\n  const validCountRef    = useRef(0);\n  const overlayDimRef    = useRef({ w: 0, h: 0 });\n  const offscreenRef     = useRef<OffscreenCanvas | null>(null);\n  const offscreenDimRef  = useRef({ w: 0, h: 0 });\n  const qrCropCanvasRef  = useRef<OffscreenCanvas | null>(null);\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const barcodeDetectorRef = useRef<any>(undefined); // undefined=未检测, null=不支持, 否则为实例\n  // 检测循环中暂存 QR 文本，避免 setState 干扰帧率，捕获时一次性写入 state\n  const qrValueRef = useRef('');\n\n  const [scanState,   setScanState]   = useState<ScanState>('init');\n  const [capturedUrl, setCapturedUrl] = useState('');\n  const [errorMsg,    setErrorMsg]    = useState('');\n  const [statusMsg,   setStatusMsg]   = useState('Loading OpenCV…');\n  const [foundCount,  setFoundCount]  = useState(0);\n  const [qrValue,     setQrValue]     = useState('');\n\n  // ── unmount cleanup ───────────────────────────────────────────────────────\n  useEffect(() => {\n    return () => {\n      streamRef.current?.getTracks().forEach(t => t.stop());\n      if (rafRef.current) cancelAnimationFrame(rafRef.current);\n    };\n  }, []);\n\n  const capturedUrlRef = useRef('');\n  useEffect(() => { capturedUrlRef.current = capturedUrl; }, [capturedUrl]);\n  useEffect(() => {\n    return () => { if (capturedUrlRef.current) URL.revokeObjectURL(capturedUrlRef.current); };\n  }, []);\n\n  const attachStream = useCallback(async (stream: MediaStream) => {\n    const video = videoRef.current!;\n    video.srcObject = stream;\n    await video.play();\n  }, []);\n\n  // ── initial boot ──────────────────────────────────────────────────────────\n  useEffect(() => {\n    let cancelled = false;\n    (async () => {\n      try {\n        setStatusMsg('Loading OpenCV…');\n        await initWorker();\n        if (cancelled) return;\n        setStatusMsg('Opening camera…');\n        const stream = await openCamera();\n        if (cancelled) { stream.getTracks().forEach(t => t.stop()); return; }\n        streamRef.current = stream;\n        await attachStream(stream);\n        setScanState('scanning');\n      } catch (e: unknown) {\n        if (!cancelled) {\n          setErrorMsg(e instanceof Error ? e.message : 'Camera or OpenCV error');\n          setScanState('error');\n        }\n      }\n    })();\n    return () => { cancelled = true; };\n  }, [attachStream]);\n\n  // ── overlay drawing ───────────────────────────────────────────────────────\n  const drawOverlay = useCallback((found: number, result?: DetectionResult) => {\n    const canvas = overlayRef.current;\n    const video  = videoRef.current;\n    if (!canvas || !video) return;\n    const ctx  = canvas.getContext('2d')!;\n    const rect = video.getBoundingClientRect();\n\n    if (rect.width !== overlayDimRef.current.w || rect.height !== overlayDimRef.current.h) {\n      canvas.width  = rect.width;\n      canvas.height = rect.height;\n      overlayDimRef.current = { w: rect.width, h: rect.height };\n    }\n    ctx.clearRect(0, 0, canvas.width, canvas.height);\n\n    const allFound = found === 4;\n    const color    = allFound ? '#00ff88' : '#ff4444';\n    const label    = allFound ? '✓ All markers found' : `${found} / 4 markers found`;\n    const bw = canvas.width, bh = canvas.height;\n    const len = Math.min(bw, bh) * BRACKET_LEN_RATIO;\n\n    ctx.strokeStyle = color;\n    ctx.lineWidth   = 3;\n    const drawBracket = (x: number, y: number, dx: number, dy: number) => {\n      ctx.beginPath();\n      ctx.moveTo(x + dx * len, y); ctx.lineTo(x, y); ctx.lineTo(x, y + dy * len);\n      ctx.stroke();\n    };\n    drawBracket(BRACKET_INSET,      BRACKET_INSET,      1, 1);\n    drawBracket(bw - BRACKET_INSET, BRACKET_INSET,     -1, 1);\n    drawBracket(BRACKET_INSET,      bh - BRACKET_INSET, 1, -1);\n    drawBracket(bw - BRACKET_INSET, bh - BRACKET_INSET,-1, -1);\n\n    if (result) {\n      const sx = bw / result.imageWidth;\n      const sy = bh / result.imageHeight;\n      const markerColors: Record<number, string> = { 0: '#00e5ff', 1: '#ffe100', 2: '#ff4f00' };\n      const markerLabels: Record<number, string> = { 0: 'TL', 1: 'BR', 2: 'BL' };\n\n      for (const m of result.arucoMarkers) {\n        const mc = markerColors[m.id] ?? '#ffffff';\n        ctx.strokeStyle = mc; ctx.lineWidth = 2;\n        ctx.beginPath();\n        m.corners.forEach((p, i) => {\n          if (i === 0) ctx.moveTo(p.x * sx, p.y * sy); else ctx.lineTo(p.x * sx, p.y * sy);\n        });\n        ctx.closePath(); ctx.stroke();\n        ctx.fillStyle = mc; ctx.font = 'bold 12px sans-serif'; ctx.textAlign = 'left';\n        ctx.fillText(markerLabels[m.id] ?? `A${m.id}`, m.center.x * sx + 4, m.center.y * sy - 4);\n      }\n      if (result.qrCode.found) {\n        ctx.fillStyle = '#00ff88'; ctx.font = 'bold 12px sans-serif'; ctx.textAlign = 'left';\n        ctx.fillText('QR ✓', 4, 16);\n      }\n    }\n\n    ctx.fillStyle = 'rgba(0,0,0,0.55)';\n    ctx.fillRect(0, bh - STATUS_BAR_H, bw, STATUS_BAR_H);\n    ctx.fillStyle = color;\n    ctx.font = `bold ${Math.round(bh * 0.022 + 11)}px sans-serif`;\n    ctx.textAlign = 'center';\n    ctx.fillText(label, bw / 2, bh - 12);\n  }, []);\n\n  // ── capture ───────────────────────────────────────────────────────────────\n  // captureCanvasRef 在检测循环顶部已同步冻结当前帧，直接转 blob 即可\n  const captureBestFrame = useCallback(() => {\n    const canvas = captureCanvasRef.current!;\n    streamRef.current?.getTracks().forEach(t => t.stop());\n    streamRef.current = null;\n    canvas.toBlob(blob => {\n      if (!blob) return;\n      if (capturedUrlRef.current) URL.revokeObjectURL(capturedUrlRef.current);\n      setCapturedUrl(URL.createObjectURL(blob));\n    }, 'image/png');\n    setScanState('captured');\n    setQrValue(qrValueRef.current);\n  }, []);\n\n  // ── detection loop（rAF）────────────────────────────────────────────────\n  const startDetection = useCallback(() => {\n    if (rafRef.current) cancelAnimationFrame(rafRef.current);\n    detectingRef.current = false;\n    validCountRef.current = 0;\n\n    const loop = async () => {\n      const video = videoRef.current;\n      if (!video || video.readyState < 2 || detectingRef.current) {\n        rafRef.current = requestAnimationFrame(loop);\n        return;\n      }\n      detectingRef.current = true;\n      try {\n        const { videoWidth: vw, videoHeight: vh } = video;\n\n        // 同步冻结当前帧到 captureCanvas（await 前）\n        const captureCanvas = captureCanvasRef.current!;\n        if (captureCanvas.width !== vw || captureCanvas.height !== vh) {\n          captureCanvas.width = vw; captureCanvas.height = vh;\n        }\n        captureCanvas.getContext('2d')!.drawImage(video, 0, 0);\n\n        const scale = Math.min(1, SCAN_DIM / Math.max(vw, vh));\n        const w = Math.round(vw * scale), h = Math.round(vh * scale);\n        if (!offscreenRef.current || offscreenDimRef.current.w !== w || offscreenDimRef.current.h !== h) {\n          offscreenRef.current  = new OffscreenCanvas(w, h);\n          offscreenDimRef.current = { w, h };\n        }\n        const ctx = offscreenRef.current.getContext('2d', { willReadFrequently: true }) as OffscreenCanvasRenderingContext2D;\n        ctx.drawImage(video, 0, 0, w, h);\n        const result = await detectInImageData(ctx.getImageData(0, 0, w, h));\n\n        // ── QR 检测 ───────────────────────────────────────────────────────\n        if (barcodeDetectorRef.current === undefined) {\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          const BD = (window as any).BarcodeDetector;\n          barcodeDetectorRef.current = BD ? new BD({ formats: ['qr_code'] }) : null;\n        }\n        const hasAllAruco = [0, 1, 2].every(id => result.arucoMarkers.some(m => m.id === id));\n        if (hasAllAruco) {\n          if (qrValueRef.current) {\n            result.qrCode = { found: true }; // 已解码，复用缓存\n          } else {\n            const qrCrop = estimateQRCropBox(result.arucoMarkers, w, h, vw, vh);\n            if (qrCrop) {\n              const cropScale = Math.min(1, QR_REALTIME_CROP_PX / Math.max(qrCrop.w, qrCrop.h));\n              const qrW = Math.max(1, Math.round(qrCrop.w * cropScale));\n              const qrH = Math.max(1, Math.round(qrCrop.h * cropScale));\n              if (!qrCropCanvasRef.current ||\n                  qrCropCanvasRef.current.width !== qrW || qrCropCanvasRef.current.height !== qrH) {\n                qrCropCanvasRef.current = new OffscreenCanvas(qrW, qrH);\n              }\n              const qrCtx = qrCropCanvasRef.current.getContext('2d', { willReadFrequently: true }) as OffscreenCanvasRenderingContext2D;\n              qrCtx.drawImage(captureCanvas, qrCrop.x0, qrCrop.y0, qrCrop.w, qrCrop.h, 0, 0, qrW, qrH);\n              const qrDet = await detectQRInCrop(qrCropCanvasRef.current!, { barcodeDetector: barcodeDetectorRef.current });\n              if (qrDet.found) {\n                result.qrCode = { found: true };\n                if (qrDet.rawValue) qrValueRef.current = qrDet.rawValue;\n              }\n            }\n          }\n        }\n\n        const found = countFound(result);\n        setFoundCount(found);\n        drawOverlay(found, result);\n\n        if (found === 4) {\n          validCountRef.current += 1;\n          if (validCountRef.current >= VALID_FRAMES_REQUIRED) {\n            if (rafRef.current) cancelAnimationFrame(rafRef.current);\n            rafRef.current = null;\n            captureBestFrame();\n            return;\n          }\n        } else {\n          validCountRef.current = 0;\n        }\n      } catch (e) {\n        console.warn('[useScanner] detection error', e);\n        validCountRef.current = 0;\n      } finally {\n        detectingRef.current = false;\n      }\n      rafRef.current = requestAnimationFrame(loop);\n    };\n    rafRef.current = requestAnimationFrame(loop);\n  }, [drawOverlay, captureBestFrame]);\n\n  useEffect(() => {\n    if (scanState === 'scanning') startDetection();\n    return () => { if (rafRef.current) cancelAnimationFrame(rafRef.current); };\n  }, [scanState, startDetection]);\n\n  // ── restart ───────────────────────────────────────────────────────────────\n  const restart = useCallback(async () => {\n    if (rafRef.current) { cancelAnimationFrame(rafRef.current); rafRef.current = null; }\n    streamRef.current?.getTracks().forEach(t => t.stop());\n    streamRef.current = null;\n    validCountRef.current = 0;\n    if (capturedUrlRef.current) { URL.revokeObjectURL(capturedUrlRef.current); setCapturedUrl(''); }\n    setFoundCount(0); setQrValue(''); qrValueRef.current = '';\n    setErrorMsg(''); setStatusMsg('Opening camera…'); setScanState('init');\n    try {\n      const stream = await openCamera();\n      streamRef.current = stream;\n      await attachStream(stream);\n      setScanState('scanning');\n    } catch (e) {\n      setErrorMsg(e instanceof Error ? e.message : 'Camera error');\n      setScanState('error');\n    }\n  }, [attachStream]);\n\n  return {\n    videoRef, overlayRef, captureCanvasRef,\n    scanState, capturedUrl, errorMsg, statusMsg, foundCount, qrValue,\n    restart,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,18 @@
+import { RefObject } from 'react';
+
+type ScanState = 'init' | 'scanning' | 'captured' | 'error';
+interface UseScannerReturn {
+    videoRef: RefObject<HTMLVideoElement | null>;
+    overlayRef: RefObject<HTMLCanvasElement | null>;
+    captureCanvasRef: RefObject<HTMLCanvasElement | null>;
+    scanState: ScanState;
+    capturedUrl: string;
+    errorMsg: string;
+    statusMsg: string;
+    foundCount: number;
+    qrValue: string;
+    restart: () => Promise<void>;
+}
+declare function useScanner(): UseScannerReturn;
+
+export { type ScanState, type UseScannerReturn, useScanner };

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import { RefObject } from 'react';
+
+type ScanState = 'init' | 'scanning' | 'captured' | 'error';
+interface UseScannerReturn {
+    videoRef: RefObject<HTMLVideoElement | null>;
+    overlayRef: RefObject<HTMLCanvasElement | null>;
+    captureCanvasRef: RefObject<HTMLCanvasElement | null>;
+    scanState: ScanState;
+    capturedUrl: string;
+    errorMsg: string;
+    statusMsg: string;
+    foundCount: number;
+    qrValue: string;
+    restart: () => Promise<void>;
+}
+declare function useScanner(): UseScannerReturn;
+
+export { type ScanState, type UseScannerReturn, useScanner };

package/dist/index.js

@@ -0,0 +1,294 @@
+// src/useScanner.ts
+import { useCallback, useEffect, useRef, useState } from "react";
+import { initWorker, detectInImageData } from "@dcg-overseas/cv-worker";
+import { estimateQRCropBox, detectQRInCrop } from "@dcg-overseas/core";
+var SCAN_DIM = 720;
+var VALID_FRAMES_REQUIRED = 2;
+var QR_REALTIME_CROP_PX = 600;
+var BRACKET_INSET = 12;
+var BRACKET_LEN_RATIO = 0.08;
+var STATUS_BAR_H = 40;
+async function openCamera() {
+  return navigator.mediaDevices.getUserMedia({
+    video: { width: { ideal: 3840 }, height: { ideal: 2160 }, facingMode: { ideal: "environment" } },
+    audio: false
+  });
+}
+function countFound(result) {
+  const aruco = [0, 1, 2].filter((id) => result.arucoMarkers.some((m) => m.id === id)).length;
+  return aruco + (result.qrCode.found ? 1 : 0);
+}
+function useScanner() {
+  const videoRef = useRef(null);
+  const overlayRef = useRef(null);
+  const captureCanvasRef = useRef(null);
+  const streamRef = useRef(null);
+  const rafRef = useRef(null);
+  const detectingRef = useRef(false);
+  const validCountRef = useRef(0);
+  const overlayDimRef = useRef({ w: 0, h: 0 });
+  const offscreenRef = useRef(null);
+  const offscreenDimRef = useRef({ w: 0, h: 0 });
+  const qrCropCanvasRef = useRef(null);
+  const barcodeDetectorRef = useRef(void 0);
+  const qrValueRef = useRef("");
+  const [scanState, setScanState] = useState("init");
+  const [capturedUrl, setCapturedUrl] = useState("");
+  const [errorMsg, setErrorMsg] = useState("");
+  const [statusMsg, setStatusMsg] = useState("Loading OpenCV\u2026");
+  const [foundCount, setFoundCount] = useState(0);
+  const [qrValue, setQrValue] = useState("");
+  useEffect(() => {
+    return () => {
+      streamRef.current?.getTracks().forEach((t) => t.stop());
+      if (rafRef.current) cancelAnimationFrame(rafRef.current);
+    };
+  }, []);
+  const capturedUrlRef = useRef("");
+  useEffect(() => {
+    capturedUrlRef.current = capturedUrl;
+  }, [capturedUrl]);
+  useEffect(() => {
+    return () => {
+      if (capturedUrlRef.current) URL.revokeObjectURL(capturedUrlRef.current);
+    };
+  }, []);
+  const attachStream = useCallback(async (stream) => {
+    const video = videoRef.current;
+    video.srcObject = stream;
+    await video.play();
+  }, []);
+  useEffect(() => {
+    let cancelled = false;
+    (async () => {
+      try {
+        setStatusMsg("Loading OpenCV\u2026");
+        await initWorker();
+        if (cancelled) return;
+        setStatusMsg("Opening camera\u2026");
+        const stream = await openCamera();
+        if (cancelled) {
+          stream.getTracks().forEach((t) => t.stop());
+          return;
+        }
+        streamRef.current = stream;
+        await attachStream(stream);
+        setScanState("scanning");
+      } catch (e) {
+        if (!cancelled) {
+          setErrorMsg(e instanceof Error ? e.message : "Camera or OpenCV error");
+          setScanState("error");
+        }
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [attachStream]);
+  const drawOverlay = useCallback((found, result) => {
+    const canvas = overlayRef.current;
+    const video = videoRef.current;
+    if (!canvas || !video) return;
+    const ctx = canvas.getContext("2d");
+    const rect = video.getBoundingClientRect();
+    if (rect.width !== overlayDimRef.current.w || rect.height !== overlayDimRef.current.h) {
+      canvas.width = rect.width;
+      canvas.height = rect.height;
+      overlayDimRef.current = { w: rect.width, h: rect.height };
+    }
+    ctx.clearRect(0, 0, canvas.width, canvas.height);
+    const allFound = found === 4;
+    const color = allFound ? "#00ff88" : "#ff4444";
+    const label = allFound ? "\u2713 All markers found" : `${found} / 4 markers found`;
+    const bw = canvas.width, bh = canvas.height;
+    const len = Math.min(bw, bh) * BRACKET_LEN_RATIO;
+    ctx.strokeStyle = color;
+    ctx.lineWidth = 3;
+    const drawBracket = (x, y, dx, dy) => {
+      ctx.beginPath();
+      ctx.moveTo(x + dx * len, y);
+      ctx.lineTo(x, y);
+      ctx.lineTo(x, y + dy * len);
+      ctx.stroke();
+    };
+    drawBracket(BRACKET_INSET, BRACKET_INSET, 1, 1);
+    drawBracket(bw - BRACKET_INSET, BRACKET_INSET, -1, 1);
+    drawBracket(BRACKET_INSET, bh - BRACKET_INSET, 1, -1);
+    drawBracket(bw - BRACKET_INSET, bh - BRACKET_INSET, -1, -1);
+    if (result) {
+      const sx = bw / result.imageWidth;
+      const sy = bh / result.imageHeight;
+      const markerColors = { 0: "#00e5ff", 1: "#ffe100", 2: "#ff4f00" };
+      const markerLabels = { 0: "TL", 1: "BR", 2: "BL" };
+      for (const m of result.arucoMarkers) {
+        const mc = markerColors[m.id] ?? "#ffffff";
+        ctx.strokeStyle = mc;
+        ctx.lineWidth = 2;
+        ctx.beginPath();
+        m.corners.forEach((p, i) => {
+          if (i === 0) ctx.moveTo(p.x * sx, p.y * sy);
+          else ctx.lineTo(p.x * sx, p.y * sy);
+        });
+        ctx.closePath();
+        ctx.stroke();
+        ctx.fillStyle = mc;
+        ctx.font = "bold 12px sans-serif";
+        ctx.textAlign = "left";
+        ctx.fillText(markerLabels[m.id] ?? `A${m.id}`, m.center.x * sx + 4, m.center.y * sy - 4);
+      }
+      if (result.qrCode.found) {
+        ctx.fillStyle = "#00ff88";
+        ctx.font = "bold 12px sans-serif";
+        ctx.textAlign = "left";
+        ctx.fillText("QR \u2713", 4, 16);
+      }
+    }
+    ctx.fillStyle = "rgba(0,0,0,0.55)";
+    ctx.fillRect(0, bh - STATUS_BAR_H, bw, STATUS_BAR_H);
+    ctx.fillStyle = color;
+    ctx.font = `bold ${Math.round(bh * 0.022 + 11)}px sans-serif`;
+    ctx.textAlign = "center";
+    ctx.fillText(label, bw / 2, bh - 12);
+  }, []);
+  const captureBestFrame = useCallback(() => {
+    const canvas = captureCanvasRef.current;
+    streamRef.current?.getTracks().forEach((t) => t.stop());
+    streamRef.current = null;
+    canvas.toBlob((blob) => {
+      if (!blob) return;
+      if (capturedUrlRef.current) URL.revokeObjectURL(capturedUrlRef.current);
+      setCapturedUrl(URL.createObjectURL(blob));
+    }, "image/png");
+    setScanState("captured");
+    setQrValue(qrValueRef.current);
+  }, []);
+  const startDetection = useCallback(() => {
+    if (rafRef.current) cancelAnimationFrame(rafRef.current);
+    detectingRef.current = false;
+    validCountRef.current = 0;
+    const loop = async () => {
+      const video = videoRef.current;
+      if (!video || video.readyState < 2 || detectingRef.current) {
+        rafRef.current = requestAnimationFrame(loop);
+        return;
+      }
+      detectingRef.current = true;
+      try {
+        const { videoWidth: vw, videoHeight: vh } = video;
+        const captureCanvas = captureCanvasRef.current;
+        if (captureCanvas.width !== vw || captureCanvas.height !== vh) {
+          captureCanvas.width = vw;
+          captureCanvas.height = vh;
+        }
+        captureCanvas.getContext("2d").drawImage(video, 0, 0);
+        const scale = Math.min(1, SCAN_DIM / Math.max(vw, vh));
+        const w = Math.round(vw * scale), h = Math.round(vh * scale);
+        if (!offscreenRef.current || offscreenDimRef.current.w !== w || offscreenDimRef.current.h !== h) {
+          offscreenRef.current = new OffscreenCanvas(w, h);
+          offscreenDimRef.current = { w, h };
+        }
+        const ctx = offscreenRef.current.getContext("2d", { willReadFrequently: true });
+        ctx.drawImage(video, 0, 0, w, h);
+        const result = await detectInImageData(ctx.getImageData(0, 0, w, h));
+        if (barcodeDetectorRef.current === void 0) {
+          const BD = window.BarcodeDetector;
+          barcodeDetectorRef.current = BD ? new BD({ formats: ["qr_code"] }) : null;
+        }
+        const hasAllAruco = [0, 1, 2].every((id) => result.arucoMarkers.some((m) => m.id === id));
+        if (hasAllAruco) {
+          if (qrValueRef.current) {
+            result.qrCode = { found: true };
+          } else {
+            const qrCrop = estimateQRCropBox(result.arucoMarkers, w, h, vw, vh);
+            if (qrCrop) {
+              const cropScale = Math.min(1, QR_REALTIME_CROP_PX / Math.max(qrCrop.w, qrCrop.h));
+              const qrW = Math.max(1, Math.round(qrCrop.w * cropScale));
+              const qrH = Math.max(1, Math.round(qrCrop.h * cropScale));
+              if (!qrCropCanvasRef.current || qrCropCanvasRef.current.width !== qrW || qrCropCanvasRef.current.height !== qrH) {
+                qrCropCanvasRef.current = new OffscreenCanvas(qrW, qrH);
+              }
+              const qrCtx = qrCropCanvasRef.current.getContext("2d", { willReadFrequently: true });
+              qrCtx.drawImage(captureCanvas, qrCrop.x0, qrCrop.y0, qrCrop.w, qrCrop.h, 0, 0, qrW, qrH);
+              const qrDet = await detectQRInCrop(qrCropCanvasRef.current, { barcodeDetector: barcodeDetectorRef.current });
+              if (qrDet.found) {
+                result.qrCode = { found: true };
+                if (qrDet.rawValue) qrValueRef.current = qrDet.rawValue;
+              }
+            }
+          }
+        }
+        const found = countFound(result);
+        setFoundCount(found);
+        drawOverlay(found, result);
+        if (found === 4) {
+          validCountRef.current += 1;
+          if (validCountRef.current >= VALID_FRAMES_REQUIRED) {
+            if (rafRef.current) cancelAnimationFrame(rafRef.current);
+            rafRef.current = null;
+            captureBestFrame();
+            return;
+          }
+        } else {
+          validCountRef.current = 0;
+        }
+      } catch (e) {
+        console.warn("[useScanner] detection error", e);
+        validCountRef.current = 0;
+      } finally {
+        detectingRef.current = false;
+      }
+      rafRef.current = requestAnimationFrame(loop);
+    };
+    rafRef.current = requestAnimationFrame(loop);
+  }, [drawOverlay, captureBestFrame]);
+  useEffect(() => {
+    if (scanState === "scanning") startDetection();
+    return () => {
+      if (rafRef.current) cancelAnimationFrame(rafRef.current);
+    };
+  }, [scanState, startDetection]);
+  const restart = useCallback(async () => {
+    if (rafRef.current) {
+      cancelAnimationFrame(rafRef.current);
+      rafRef.current = null;
+    }
+    streamRef.current?.getTracks().forEach((t) => t.stop());
+    streamRef.current = null;
+    validCountRef.current = 0;
+    if (capturedUrlRef.current) {
+      URL.revokeObjectURL(capturedUrlRef.current);
+      setCapturedUrl("");
+    }
+    setFoundCount(0);
+    setQrValue("");
+    qrValueRef.current = "";
+    setErrorMsg("");
+    setStatusMsg("Opening camera\u2026");
+    setScanState("init");
+    try {
+      const stream = await openCamera();
+      streamRef.current = stream;
+      await attachStream(stream);
+      setScanState("scanning");
+    } catch (e) {
+      setErrorMsg(e instanceof Error ? e.message : "Camera error");
+      setScanState("error");
+    }
+  }, [attachStream]);
+  return {
+    videoRef,
+    overlayRef,
+    captureCanvasRef,
+    scanState,
+    capturedUrl,
+    errorMsg,
+    statusMsg,
+    foundCount,
+    qrValue,
+    restart
+  };
+}
+export {
+  useScanner
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useScanner.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\nimport type { RefObject } from 'react';\nimport { initWorker, detectInImageData } from '@dcg-overseas/cv-worker';\nimport { estimateQRCropBox, detectQRInCrop } from '@dcg-overseas/core';\nimport type { DetectionResult } from '@dcg-overseas/types';\n\n// ── 检测常量 ──────────────────────────────────────────────────────────────────\nconst SCAN_DIM             = 720;   // 检测缩略图长边（px）\nconst VALID_FRAMES_REQUIRED = 2;    // 连续有效帧数阈值\nconst QR_REALTIME_CROP_PX  = 600;   // QR 裁切图上限（px），只缩小不放大\n\n// ── Overlay 绘制常量 ──────────────────────────────────────────────────────────\nconst BRACKET_INSET    = 12;    // 取景框括号内缩距离（px）\nconst BRACKET_LEN_RATIO = 0.08; // 括号边长占短边比例\nconst STATUS_BAR_H     = 40;    // 底部状态栏高度（px）\n\nexport type ScanState = 'init' | 'scanning' | 'captured' | 'error';\n\nexport interface UseScannerReturn {\n  // ── DOM refs（直接绑定到 JSX 元素）──────────────────────────────────────────\n  videoRef:         RefObject<HTMLVideoElement | null>;\n  overlayRef:       RefObject<HTMLCanvasElement | null>;\n  captureCanvasRef: RefObject<HTMLCanvasElement | null>;\n  // ── 状态 ─────────────────────────────────────────────────────────────────────\n  scanState:   ScanState;\n  capturedUrl: string;\n  errorMsg:    string;\n  statusMsg:   string;\n  foundCount:  number;\n  qrValue:     string;\n  // ── 动作 ─────────────────────────────────────────────────────────────────────\n  restart: () => Promise<void>;\n}\n\nasync function openCamera(): Promise<MediaStream> {\n  return navigator.mediaDevices.getUserMedia({\n    video: { width: { ideal: 3840 }, height: { ideal: 2160 }, facingMode: { ideal: 'environment' } },\n    audio: false,\n  });\n}\n\nfunction countFound(result: DetectionResult): number {\n  const aruco = [0, 1, 2].filter(id => result.arucoMarkers.some(m => m.id === id)).length;\n  return aruco + (result.qrCode.found ? 1 : 0);\n}\n\nexport function useScanner(): UseScannerReturn {\n  const videoRef         = useRef<HTMLVideoElement>(null);\n  const overlayRef       = useRef<HTMLCanvasElement>(null);\n  const captureCanvasRef = useRef<HTMLCanvasElement>(null);\n  const streamRef        = useRef<MediaStream | null>(null);\n  const rafRef           = useRef<number | null>(null);\n  const detectingRef     = useRef(false);\n  const validCountRef    = useRef(0);\n  const overlayDimRef    = useRef({ w: 0, h: 0 });\n  const offscreenRef     = useRef<OffscreenCanvas | null>(null);\n  const offscreenDimRef  = useRef({ w: 0, h: 0 });\n  const qrCropCanvasRef  = useRef<OffscreenCanvas | null>(null);\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const barcodeDetectorRef = useRef<any>(undefined); // undefined=未检测, null=不支持, 否则为实例\n  // 检测循环中暂存 QR 文本，避免 setState 干扰帧率，捕获时一次性写入 state\n  const qrValueRef = useRef('');\n\n  const [scanState,   setScanState]   = useState<ScanState>('init');\n  const [capturedUrl, setCapturedUrl] = useState('');\n  const [errorMsg,    setErrorMsg]    = useState('');\n  const [statusMsg,   setStatusMsg]   = useState('Loading OpenCV…');\n  const [foundCount,  setFoundCount]  = useState(0);\n  const [qrValue,     setQrValue]     = useState('');\n\n  // ── unmount cleanup ───────────────────────────────────────────────────────\n  useEffect(() => {\n    return () => {\n      streamRef.current?.getTracks().forEach(t => t.stop());\n      if (rafRef.current) cancelAnimationFrame(rafRef.current);\n    };\n  }, []);\n\n  const capturedUrlRef = useRef('');\n  useEffect(() => { capturedUrlRef.current = capturedUrl; }, [capturedUrl]);\n  useEffect(() => {\n    return () => { if (capturedUrlRef.current) URL.revokeObjectURL(capturedUrlRef.current); };\n  }, []);\n\n  const attachStream = useCallback(async (stream: MediaStream) => {\n    const video = videoRef.current!;\n    video.srcObject = stream;\n    await video.play();\n  }, []);\n\n  // ── initial boot ──────────────────────────────────────────────────────────\n  useEffect(() => {\n    let cancelled = false;\n    (async () => {\n      try {\n        setStatusMsg('Loading OpenCV…');\n        await initWorker();\n        if (cancelled) return;\n        setStatusMsg('Opening camera…');\n        const stream = await openCamera();\n        if (cancelled) { stream.getTracks().forEach(t => t.stop()); return; }\n        streamRef.current = stream;\n        await attachStream(stream);\n        setScanState('scanning');\n      } catch (e: unknown) {\n        if (!cancelled) {\n          setErrorMsg(e instanceof Error ? e.message : 'Camera or OpenCV error');\n          setScanState('error');\n        }\n      }\n    })();\n    return () => { cancelled = true; };\n  }, [attachStream]);\n\n  // ── overlay drawing ───────────────────────────────────────────────────────\n  const drawOverlay = useCallback((found: number, result?: DetectionResult) => {\n    const canvas = overlayRef.current;\n    const video  = videoRef.current;\n    if (!canvas || !video) return;\n    const ctx  = canvas.getContext('2d')!;\n    const rect = video.getBoundingClientRect();\n\n    if (rect.width !== overlayDimRef.current.w || rect.height !== overlayDimRef.current.h) {\n      canvas.width  = rect.width;\n      canvas.height = rect.height;\n      overlayDimRef.current = { w: rect.width, h: rect.height };\n    }\n    ctx.clearRect(0, 0, canvas.width, canvas.height);\n\n    const allFound = found === 4;\n    const color    = allFound ? '#00ff88' : '#ff4444';\n    const label    = allFound ? '✓ All markers found' : `${found} / 4 markers found`;\n    const bw = canvas.width, bh = canvas.height;\n    const len = Math.min(bw, bh) * BRACKET_LEN_RATIO;\n\n    ctx.strokeStyle = color;\n    ctx.lineWidth   = 3;\n    const drawBracket = (x: number, y: number, dx: number, dy: number) => {\n      ctx.beginPath();\n      ctx.moveTo(x + dx * len, y); ctx.lineTo(x, y); ctx.lineTo(x, y + dy * len);\n      ctx.stroke();\n    };\n    drawBracket(BRACKET_INSET,      BRACKET_INSET,      1, 1);\n    drawBracket(bw - BRACKET_INSET, BRACKET_INSET,     -1, 1);\n    drawBracket(BRACKET_INSET,      bh - BRACKET_INSET, 1, -1);\n    drawBracket(bw - BRACKET_INSET, bh - BRACKET_INSET,-1, -1);\n\n    if (result) {\n      const sx = bw / result.imageWidth;\n      const sy = bh / result.imageHeight;\n      const markerColors: Record<number, string> = { 0: '#00e5ff', 1: '#ffe100', 2: '#ff4f00' };\n      const markerLabels: Record<number, string> = { 0: 'TL', 1: 'BR', 2: 'BL' };\n\n      for (const m of result.arucoMarkers) {\n        const mc = markerColors[m.id] ?? '#ffffff';\n        ctx.strokeStyle = mc; ctx.lineWidth = 2;\n        ctx.beginPath();\n        m.corners.forEach((p, i) => {\n          if (i === 0) ctx.moveTo(p.x * sx, p.y * sy); else ctx.lineTo(p.x * sx, p.y * sy);\n        });\n        ctx.closePath(); ctx.stroke();\n        ctx.fillStyle = mc; ctx.font = 'bold 12px sans-serif'; ctx.textAlign = 'left';\n        ctx.fillText(markerLabels[m.id] ?? `A${m.id}`, m.center.x * sx + 4, m.center.y * sy - 4);\n      }\n      if (result.qrCode.found) {\n        ctx.fillStyle = '#00ff88'; ctx.font = 'bold 12px sans-serif'; ctx.textAlign = 'left';\n        ctx.fillText('QR ✓', 4, 16);\n      }\n    }\n\n    ctx.fillStyle = 'rgba(0,0,0,0.55)';\n    ctx.fillRect(0, bh - STATUS_BAR_H, bw, STATUS_BAR_H);\n    ctx.fillStyle = color;\n    ctx.font = `bold ${Math.round(bh * 0.022 + 11)}px sans-serif`;\n    ctx.textAlign = 'center';\n    ctx.fillText(label, bw / 2, bh - 12);\n  }, []);\n\n  // ── capture ───────────────────────────────────────────────────────────────\n  // captureCanvasRef 在检测循环顶部已同步冻结当前帧，直接转 blob 即可\n  const captureBestFrame = useCallback(() => {\n    const canvas = captureCanvasRef.current!;\n    streamRef.current?.getTracks().forEach(t => t.stop());\n    streamRef.current = null;\n    canvas.toBlob(blob => {\n      if (!blob) return;\n      if (capturedUrlRef.current) URL.revokeObjectURL(capturedUrlRef.current);\n      setCapturedUrl(URL.createObjectURL(blob));\n    }, 'image/png');\n    setScanState('captured');\n    setQrValue(qrValueRef.current);\n  }, []);\n\n  // ── detection loop（rAF）────────────────────────────────────────────────\n  const startDetection = useCallback(() => {\n    if (rafRef.current) cancelAnimationFrame(rafRef.current);\n    detectingRef.current = false;\n    validCountRef.current = 0;\n\n    const loop = async () => {\n      const video = videoRef.current;\n      if (!video || video.readyState < 2 || detectingRef.current) {\n        rafRef.current = requestAnimationFrame(loop);\n        return;\n      }\n      detectingRef.current = true;\n      try {\n        const { videoWidth: vw, videoHeight: vh } = video;\n\n        // 同步冻结当前帧到 captureCanvas（await 前）\n        const captureCanvas = captureCanvasRef.current!;\n        if (captureCanvas.width !== vw || captureCanvas.height !== vh) {\n          captureCanvas.width = vw; captureCanvas.height = vh;\n        }\n        captureCanvas.getContext('2d')!.drawImage(video, 0, 0);\n\n        const scale = Math.min(1, SCAN_DIM / Math.max(vw, vh));\n        const w = Math.round(vw * scale), h = Math.round(vh * scale);\n        if (!offscreenRef.current || offscreenDimRef.current.w !== w || offscreenDimRef.current.h !== h) {\n          offscreenRef.current  = new OffscreenCanvas(w, h);\n          offscreenDimRef.current = { w, h };\n        }\n        const ctx = offscreenRef.current.getContext('2d', { willReadFrequently: true }) as OffscreenCanvasRenderingContext2D;\n        ctx.drawImage(video, 0, 0, w, h);\n        const result = await detectInImageData(ctx.getImageData(0, 0, w, h));\n\n        // ── QR 检测 ───────────────────────────────────────────────────────\n        if (barcodeDetectorRef.current === undefined) {\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          const BD = (window as any).BarcodeDetector;\n          barcodeDetectorRef.current = BD ? new BD({ formats: ['qr_code'] }) : null;\n        }\n        const hasAllAruco = [0, 1, 2].every(id => result.arucoMarkers.some(m => m.id === id));\n        if (hasAllAruco) {\n          if (qrValueRef.current) {\n            result.qrCode = { found: true }; // 已解码，复用缓存\n          } else {\n            const qrCrop = estimateQRCropBox(result.arucoMarkers, w, h, vw, vh);\n            if (qrCrop) {\n              const cropScale = Math.min(1, QR_REALTIME_CROP_PX / Math.max(qrCrop.w, qrCrop.h));\n              const qrW = Math.max(1, Math.round(qrCrop.w * cropScale));\n              const qrH = Math.max(1, Math.round(qrCrop.h * cropScale));\n              if (!qrCropCanvasRef.current ||\n                  qrCropCanvasRef.current.width !== qrW || qrCropCanvasRef.current.height !== qrH) {\n                qrCropCanvasRef.current = new OffscreenCanvas(qrW, qrH);\n              }\n              const qrCtx = qrCropCanvasRef.current.getContext('2d', { willReadFrequently: true }) as OffscreenCanvasRenderingContext2D;\n              qrCtx.drawImage(captureCanvas, qrCrop.x0, qrCrop.y0, qrCrop.w, qrCrop.h, 0, 0, qrW, qrH);\n              const qrDet = await detectQRInCrop(qrCropCanvasRef.current!, { barcodeDetector: barcodeDetectorRef.current });\n              if (qrDet.found) {\n                result.qrCode = { found: true };\n                if (qrDet.rawValue) qrValueRef.current = qrDet.rawValue;\n              }\n            }\n          }\n        }\n\n        const found = countFound(result);\n        setFoundCount(found);\n        drawOverlay(found, result);\n\n        if (found === 4) {\n          validCountRef.current += 1;\n          if (validCountRef.current >= VALID_FRAMES_REQUIRED) {\n            if (rafRef.current) cancelAnimationFrame(rafRef.current);\n            rafRef.current = null;\n            captureBestFrame();\n            return;\n          }\n        } else {\n          validCountRef.current = 0;\n        }\n      } catch (e) {\n        console.warn('[useScanner] detection error', e);\n        validCountRef.current = 0;\n      } finally {\n        detectingRef.current = false;\n      }\n      rafRef.current = requestAnimationFrame(loop);\n    };\n    rafRef.current = requestAnimationFrame(loop);\n  }, [drawOverlay, captureBestFrame]);\n\n  useEffect(() => {\n    if (scanState === 'scanning') startDetection();\n    return () => { if (rafRef.current) cancelAnimationFrame(rafRef.current); };\n  }, [scanState, startDetection]);\n\n  // ── restart ───────────────────────────────────────────────────────────────\n  const restart = useCallback(async () => {\n    if (rafRef.current) { cancelAnimationFrame(rafRef.current); rafRef.current = null; }\n    streamRef.current?.getTracks().forEach(t => t.stop());\n    streamRef.current = null;\n    validCountRef.current = 0;\n    if (capturedUrlRef.current) { URL.revokeObjectURL(capturedUrlRef.current); setCapturedUrl(''); }\n    setFoundCount(0); setQrValue(''); qrValueRef.current = '';\n    setErrorMsg(''); setStatusMsg('Opening camera…'); setScanState('init');\n    try {\n      const stream = await openCamera();\n      streamRef.current = stream;\n      await attachStream(stream);\n      setScanState('scanning');\n    } catch (e) {\n      setErrorMsg(e instanceof Error ? e.message : 'Camera error');\n      setScanState('error');\n    }\n  }, [attachStream]);\n\n  return {\n    videoRef, overlayRef, captureCanvasRef,\n    scanState, capturedUrl, errorMsg, statusMsg, foundCount, qrValue,\n    restart,\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@dcg-overseas/scanner",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@dcg-overseas/core": "0.1.1",
+    "@dcg-overseas/types": "0.1.1",
+    "@dcg-overseas/cv-worker": "0.1.6"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.14",
+    "react": "^19.2.4",
+    "tsup": "^8.0.0",
+    "typescript": "~5.9.3"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}