@barcodesdk/react 0.1.0

package/LICENSE

@@ -0,0 +1,9 @@
+Copyright (c) 2026 Vijay Reddy
+
+All rights reserved.
+
+This software is proprietary beta software. Unauthorized copying,
+modification, distribution, or use is prohibited except under a written
+license agreement with the copyright holder.
+
+Third-party notices for bundled dependencies are in NOTICES.md.

package/dist/barcode-scanner-view.d.ts

@@ -0,0 +1,25 @@
+import { type CSSProperties, type ReactNode, type Ref } from "react";
+export interface BarcodeScannerViewHandle {
+    video: HTMLVideoElement | null;
+    start: () => Promise<void>;
+    stop: () => Promise<void>;
+}
+export interface BarcodeScannerViewProps {
+    className?: string;
+    style?: CSSProperties;
+    videoClassName?: string;
+    videoStyle?: CSSProperties;
+    /** Render overlay content inside the video frame (absolute positioned). */
+    children?: ReactNode;
+    /** Auto attach + start when the video element mounts and scanner is ready. */
+    autoStart?: boolean;
+    /** Forwarded ref with video + start/stop helpers. */
+    viewRef?: Ref<BarcodeScannerViewHandle>;
+    onStartError?: (error: unknown) => void;
+}
+/**
+ * Video preview bound to the Provider scanner.
+ * Overlay children should be absolutely positioned over the video.
+ */
+export declare function BarcodeScannerView({ className, style, videoClassName, videoStyle, children, autoStart, viewRef, onStartError, }: BarcodeScannerViewProps): import("react").JSX.Element;
+//# sourceMappingURL=barcode-scanner-view.d.ts.map

package/dist/barcode-scanner-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barcode-scanner-view.d.ts","sourceRoot":"","sources":["../src/barcode-scanner-view.tsx"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,GAAG,EACT,MAAM,OAAO,CAAC;AAGf,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,OAAO,CAAC,EAAE,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,SAAS,EACT,KAAK,EACL,cAAc,EACd,UAAU,EACV,QAAQ,EACR,SAAiB,EACjB,OAAO,EACP,YAAY,GACb,EAAE,uBAAuB,+BAmEzB"}

package/dist/context.d.ts

@@ -0,0 +1,4 @@
+import type { ScannerStore } from "./store.js";
+export declare const ScannerStoreContext: import("react").Context<ScannerStore | null>;
+export declare function useScannerStoreContext(): ScannerStore;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,mBAAmB,8CAA2C,CAAC;AAE5E,wBAAgB,sBAAsB,IAAI,YAAY,CAQrD"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { createScannerStore, ScannerStore } from "./store.js";
+export type { ScannerStoreOptions, ScannerStoreSnapshot, } from "./store.js";
+export { BarcodeScannerProvider } from "./provider.js";
+export type { BarcodeScannerProviderProps } from "./provider.js";
+export { useBarcodeScanner } from "./use-barcode-scanner.js";
+export type { UseBarcodeScannerResult } from "./use-barcode-scanner.js";
+export { BarcodeScannerView } from "./barcode-scanner-view.js";
+export type { BarcodeScannerViewHandle, BarcodeScannerViewProps, } from "./barcode-scanner-view.js";
+//# 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":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9D,YAAY,EACV,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EACV,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,391 @@
+"use client";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+import { createBarcodeScanner } from "@barcodesdk/core";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { createContext, useContext, useState, useEffect, useSyncExternalStore, useCallback, useMemo, useRef, useImperativeHandle } from "react";
+const EMPTY_SNAPSHOT = {
+  state: "idle",
+  results: [],
+  accepted: [],
+  acceptedHistory: [],
+  lastError: null,
+  metrics: null,
+  capabilities: null
+};
+function mergeAcceptedHistory(previous, accepted, limit) {
+  if (accepted.length === 0) {
+    return previous;
+  }
+  const next = [...previous];
+  for (const item of accepted) {
+    if (!next.some(
+      (existing) => existing.format === item.format && existing.text === item.text
+    )) {
+      next.unshift(item);
+    }
+  }
+  return next.slice(0, limit);
+}
+class ScannerStore {
+  constructor(options) {
+    __publicField(this, "scanner");
+    __publicField(this, "ownsScanner");
+    __publicField(this, "snapshot");
+    __publicField(this, "listeners", /* @__PURE__ */ new Set());
+    __publicField(this, "unsubscribers", []);
+    __publicField(this, "acceptedHistoryLimit");
+    __publicField(this, "destroyed", false);
+    __publicField(this, "subscribe", (listener) => {
+      this.listeners.add(listener);
+      return () => {
+        this.listeners.delete(listener);
+      };
+    });
+    __publicField(this, "getSnapshot", () => this.snapshot);
+    __publicField(this, "getServerSnapshot", () => EMPTY_SNAPSHOT);
+    if (!options.config && !options.scanner) {
+      throw new Error("ScannerStore requires either config or scanner.");
+    }
+    if (options.config && options.scanner) {
+      throw new Error("Pass either config or scanner, not both.");
+    }
+    this.ownsScanner = Boolean(options.config);
+    this.scanner = options.scanner ?? createBarcodeScanner(options.config);
+    this.acceptedHistoryLimit = options.acceptedHistoryLimit ?? 12;
+    this.snapshot = {
+      ...EMPTY_SNAPSHOT,
+      state: this.scanner.getState(),
+      capabilities: this.scanner.getCapabilities()
+    };
+    this.unsubscribers.push(
+      this.scanner.on("state", ({ state }) => {
+        this.update({ state, lastError: state === "error" ? this.snapshot.lastError : this.snapshot.lastError });
+      })
+    );
+    this.unsubscribers.push(
+      this.scanner.on("result", ({ results, accepted, metrics }) => {
+        this.update({
+          results,
+          accepted: accepted ?? [],
+          acceptedHistory: mergeAcceptedHistory(
+            this.snapshot.acceptedHistory,
+            accepted ?? [],
+            this.acceptedHistoryLimit
+          ),
+          metrics: metrics ?? this.snapshot.metrics
+        });
+      })
+    );
+    this.unsubscribers.push(
+      this.scanner.on("error", (info) => {
+        this.update({ lastError: info });
+      })
+    );
+    if (options.autoInitialize !== false) {
+      void this.initialize();
+    }
+  }
+  /** True after `destroy()`; used to recreate the store on Strict Mode remount. */
+  get isDestroyed() {
+    return this.destroyed;
+  }
+  async initialize() {
+    this.assertAlive();
+    await this.scanner.initialize();
+    if (this.destroyed) {
+      return;
+    }
+    this.update({
+      state: this.scanner.getState(),
+      capabilities: this.scanner.getCapabilities()
+    });
+  }
+  async attach(target) {
+    this.assertAlive();
+    await this.scanner.attach(target);
+  }
+  async start() {
+    this.assertAlive();
+    this.update({
+      results: [],
+      accepted: [],
+      lastError: null
+    });
+    await this.scanner.start();
+  }
+  async stop() {
+    this.assertAlive();
+    await this.scanner.stop();
+    if (this.destroyed) {
+      return;
+    }
+    this.update({ results: [], accepted: [] });
+  }
+  async pause() {
+    this.assertAlive();
+    await this.scanner.pause();
+  }
+  async resume() {
+    this.assertAlive();
+    await this.scanner.resume();
+  }
+  async scanImage(source) {
+    this.assertAlive();
+    const results = await this.scanner.scanImage(source);
+    if (this.destroyed) {
+      return [];
+    }
+    return results;
+  }
+  clearError() {
+    this.update({ lastError: null });
+  }
+  clearAcceptedHistory() {
+    this.update({ acceptedHistory: [] });
+  }
+  async destroy() {
+    if (this.destroyed) {
+      return;
+    }
+    this.destroyed = true;
+    for (const unsubscribe of this.unsubscribers) {
+      unsubscribe();
+    }
+    this.unsubscribers.length = 0;
+    this.listeners.clear();
+    if (this.ownsScanner) {
+      await this.scanner.destroy();
+    }
+    this.snapshot = {
+      ...EMPTY_SNAPSHOT,
+      state: this.ownsScanner ? "destroyed" : this.scanner.getState()
+    };
+  }
+  update(patch) {
+    this.snapshot = { ...this.snapshot, ...patch };
+    for (const listener of [...this.listeners]) {
+      listener();
+    }
+  }
+  assertAlive() {
+    if (this.destroyed) {
+      throw new Error("ScannerStore has been destroyed.");
+    }
+  }
+}
+function createScannerStore(options) {
+  return new ScannerStore(options);
+}
+const ScannerStoreContext = createContext(null);
+function useScannerStoreContext() {
+  const store = useContext(ScannerStoreContext);
+  if (!store) {
+    throw new Error(
+      "useBarcodeScanner must be used within a BarcodeScannerProvider."
+    );
+  }
+  return store;
+}
+function createOwnedStore({
+  config,
+  scanner,
+  acceptedHistoryLimit,
+  autoInitialize
+}) {
+  return createScannerStore({
+    config,
+    scanner,
+    acceptedHistoryLimit,
+    autoInitialize
+  });
+}
+function BarcodeScannerProvider({
+  children,
+  config,
+  scanner,
+  acceptedHistoryLimit,
+  autoInitialize = true,
+  store: externalStore
+}) {
+  const [ownedStore, setOwnedStore] = useState(
+    () => createOwnedStore({
+      config,
+      scanner,
+      acceptedHistoryLimit,
+      autoInitialize
+    })
+  );
+  if (!externalStore && ownedStore.isDestroyed) {
+    setOwnedStore(
+      createOwnedStore({
+        config,
+        scanner,
+        acceptedHistoryLimit,
+        autoInitialize
+      })
+    );
+  }
+  const store = externalStore ?? ownedStore;
+  useEffect(() => {
+    if (externalStore) {
+      return;
+    }
+    if (store.isDestroyed) {
+      setOwnedStore(
+        createOwnedStore({
+          config,
+          scanner,
+          acceptedHistoryLimit,
+          autoInitialize
+        })
+      );
+      return;
+    }
+    const active = store;
+    return () => {
+      void active.destroy();
+    };
+  }, [store, externalStore]);
+  return /* @__PURE__ */ jsx(ScannerStoreContext.Provider, { value: store, children });
+}
+function useBarcodeScanner() {
+  const store = useScannerStoreContext();
+  const snapshot = useSyncExternalStore(
+    store.subscribe,
+    store.getSnapshot,
+    store.getServerSnapshot
+  );
+  const initialize = useCallback(() => store.initialize(), [store]);
+  const attach = useCallback(
+    (target) => store.attach(target),
+    [store]
+  );
+  const start = useCallback(() => store.start(), [store]);
+  const stop = useCallback(() => store.stop(), [store]);
+  const pause = useCallback(() => store.pause(), [store]);
+  const resume = useCallback(() => store.resume(), [store]);
+  const scanImage = useCallback(
+    (source) => store.scanImage(source),
+    [store]
+  );
+  const clearError = useCallback(() => store.clearError(), [store]);
+  const clearAcceptedHistory = useCallback(
+    () => store.clearAcceptedHistory(),
+    [store]
+  );
+  return useMemo(
+    () => ({
+      ...snapshot,
+      scanner: store.scanner,
+      initialize,
+      attach,
+      start,
+      stop,
+      pause,
+      resume,
+      scanImage,
+      clearError,
+      clearAcceptedHistory
+    }),
+    [
+      snapshot,
+      store.scanner,
+      initialize,
+      attach,
+      start,
+      stop,
+      pause,
+      resume,
+      scanImage,
+      clearError,
+      clearAcceptedHistory
+    ]
+  );
+}
+function BarcodeScannerView({
+  className,
+  style,
+  videoClassName,
+  videoStyle,
+  children,
+  autoStart = false,
+  viewRef,
+  onStartError
+}) {
+  const videoRef = useRef(null);
+  const { state, attach, start, stop } = useBarcodeScanner();
+  const startedRef = useRef(false);
+  const runStart = useCallback(async () => {
+    const video = videoRef.current;
+    if (!video) {
+      return;
+    }
+    await attach({ video });
+    await start();
+    startedRef.current = true;
+  }, [attach, start]);
+  const runStop = useCallback(async () => {
+    await stop();
+    startedRef.current = false;
+  }, [stop]);
+  useImperativeHandle(
+    viewRef,
+    () => ({
+      video: videoRef.current,
+      start: runStart,
+      stop: runStop
+    }),
+    [runStart, runStop]
+  );
+  useEffect(() => {
+    if (!autoStart) {
+      return;
+    }
+    if (state !== "ready" && state !== "paused") {
+      return;
+    }
+    if (startedRef.current) {
+      return;
+    }
+    void runStart().catch((error) => {
+      onStartError == null ? void 0 : onStartError(error);
+    });
+  }, [autoStart, state, runStart, onStartError]);
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className,
+      style: { position: "relative", overflow: "hidden", ...style },
+      children: [
+        /* @__PURE__ */ jsx(
+          "video",
+          {
+            ref: videoRef,
+            className: videoClassName,
+            "aria-label": "Barcode camera preview",
+            style: {
+              display: "block",
+              width: "100%",
+              height: "100%",
+              objectFit: "contain",
+              ...videoStyle
+            },
+            muted: true,
+            playsInline: true
+          }
+        ),
+        children
+      ]
+    }
+  );
+}
+export {
+  BarcodeScannerProvider,
+  BarcodeScannerView,
+  ScannerStore,
+  createScannerStore,
+  useBarcodeScanner
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/store.ts","../src/context.tsx","../src/provider.tsx","../src/use-barcode-scanner.ts","../src/barcode-scanner-view.tsx"],"sourcesContent":["import {\n  createBarcodeScanner,\n  type AttachTarget,\n  type BarcodeResult,\n  type BarcodeScanner,\n  type ImageScanSource,\n  type ScannerCapabilities,\n  type ScannerConfig,\n  type ScannerErrorInfo,\n  type ScannerMetrics,\n  type ScannerState,\n} from \"@barcodesdk/core\";\n\nexport interface ScannerStoreSnapshot {\n  state: ScannerState;\n  results: BarcodeResult[];\n  /** Most recent accepted batch from the tracker. */\n  accepted: BarcodeResult[];\n  /** Deduped accepted history for UI lists (ring buffer). */\n  acceptedHistory: BarcodeResult[];\n  lastError: ScannerErrorInfo | null;\n  metrics: ScannerMetrics | null;\n  capabilities: ScannerCapabilities | null;\n}\n\nexport interface ScannerStoreOptions {\n  /** Create and own a scanner from config. Mutually exclusive with `scanner`. */\n  config?: ScannerConfig;\n  /** Share an existing scanner instance (Provider will not destroy it). */\n  scanner?: BarcodeScanner;\n  /** Max unique accepted codes retained in history (default 12). */\n  acceptedHistoryLimit?: number;\n  /** Auto-call initialize() after store creation (default true). */\n  autoInitialize?: boolean;\n}\n\nconst EMPTY_SNAPSHOT: ScannerStoreSnapshot = {\n  state: \"idle\",\n  results: [],\n  accepted: [],\n  acceptedHistory: [],\n  lastError: null,\n  metrics: null,\n  capabilities: null,\n};\n\nfunction mergeAcceptedHistory(\n  previous: BarcodeResult[],\n  accepted: BarcodeResult[],\n  limit: number,\n): BarcodeResult[] {\n  if (accepted.length === 0) {\n    return previous;\n  }\n  const next = [...previous];\n  for (const item of accepted) {\n    if (\n      !next.some(\n        (existing) =>\n          existing.format === item.format && existing.text === item.text,\n      )\n    ) {\n      next.unshift(item);\n    }\n  }\n  return next.slice(0, limit);\n}\n\n/**\n * External store wrapping `@barcodesdk/core`. Designed for\n * `useSyncExternalStore` — React never duplicates scanner state in useState.\n */\nexport class ScannerStore {\n  readonly scanner: BarcodeScanner;\n  readonly ownsScanner: boolean;\n  private snapshot: ScannerStoreSnapshot;\n  private readonly listeners = new Set<() => void>();\n  private readonly unsubscribers: Array<() => void> = [];\n  private readonly acceptedHistoryLimit: number;\n  private destroyed = false;\n\n  /** True after `destroy()`; used to recreate the store on Strict Mode remount. */\n  get isDestroyed(): boolean {\n    return this.destroyed;\n  }\n\n  constructor(options: ScannerStoreOptions) {\n    if (!options.config && !options.scanner) {\n      throw new Error(\"ScannerStore requires either config or scanner.\");\n    }\n    if (options.config && options.scanner) {\n      throw new Error(\"Pass either config or scanner, not both.\");\n    }\n\n    this.ownsScanner = Boolean(options.config);\n    this.scanner = options.scanner ?? createBarcodeScanner(options.config!);\n    this.acceptedHistoryLimit = options.acceptedHistoryLimit ?? 12;\n    this.snapshot = {\n      ...EMPTY_SNAPSHOT,\n      state: this.scanner.getState(),\n      capabilities: this.scanner.getCapabilities(),\n    };\n\n    this.unsubscribers.push(\n      this.scanner.on(\"state\", ({ state }) => {\n        this.update({ state, lastError: state === \"error\" ? this.snapshot.lastError : this.snapshot.lastError });\n      }),\n    );\n    this.unsubscribers.push(\n      this.scanner.on(\"result\", ({ results, accepted, metrics }) => {\n        this.update({\n          results,\n          accepted: accepted ?? [],\n          acceptedHistory: mergeAcceptedHistory(\n            this.snapshot.acceptedHistory,\n            accepted ?? [],\n            this.acceptedHistoryLimit,\n          ),\n          metrics: metrics ?? this.snapshot.metrics,\n        });\n      }),\n    );\n    this.unsubscribers.push(\n      this.scanner.on(\"error\", (info) => {\n        this.update({ lastError: info });\n      }),\n    );\n\n    if (options.autoInitialize !== false) {\n      void this.initialize();\n    }\n  }\n\n  subscribe = (listener: () => void): (() => void) => {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  };\n\n  getSnapshot = (): ScannerStoreSnapshot => this.snapshot;\n\n  getServerSnapshot = (): ScannerStoreSnapshot => EMPTY_SNAPSHOT;\n\n  async initialize(): Promise<void> {\n    this.assertAlive();\n    await this.scanner.initialize();\n    if (this.destroyed) {\n      return;\n    }\n    this.update({\n      state: this.scanner.getState(),\n      capabilities: this.scanner.getCapabilities(),\n    });\n  }\n\n  async attach(target: AttachTarget): Promise<void> {\n    this.assertAlive();\n    await this.scanner.attach(target);\n  }\n\n  async start(): Promise<void> {\n    this.assertAlive();\n    this.update({\n      results: [],\n      accepted: [],\n      lastError: null,\n    });\n    await this.scanner.start();\n  }\n\n  async stop(): Promise<void> {\n    this.assertAlive();\n    await this.scanner.stop();\n    if (this.destroyed) {\n      return;\n    }\n    this.update({ results: [], accepted: [] });\n  }\n\n  async pause(): Promise<void> {\n    this.assertAlive();\n    await this.scanner.pause();\n  }\n\n  async resume(): Promise<void> {\n    this.assertAlive();\n    await this.scanner.resume();\n  }\n\n  async scanImage(source: ImageScanSource): Promise<BarcodeResult[]> {\n    this.assertAlive();\n    const results = await this.scanner.scanImage(source);\n    if (this.destroyed) {\n      return [];\n    }\n    return results;\n  }\n\n  clearError(): void {\n    this.update({ lastError: null });\n  }\n\n  clearAcceptedHistory(): void {\n    this.update({ acceptedHistory: [] });\n  }\n\n  async destroy(): Promise<void> {\n    if (this.destroyed) {\n      return;\n    }\n    this.destroyed = true;\n    for (const unsubscribe of this.unsubscribers) {\n      unsubscribe();\n    }\n    this.unsubscribers.length = 0;\n    this.listeners.clear();\n    if (this.ownsScanner) {\n      await this.scanner.destroy();\n    }\n    this.snapshot = {\n      ...EMPTY_SNAPSHOT,\n      state: this.ownsScanner ? \"destroyed\" : this.scanner.getState(),\n    };\n  }\n\n  private update(patch: Partial<ScannerStoreSnapshot>): void {\n    this.snapshot = { ...this.snapshot, ...patch };\n    for (const listener of [...this.listeners]) {\n      listener();\n    }\n  }\n\n  private assertAlive(): void {\n    if (this.destroyed) {\n      throw new Error(\"ScannerStore has been destroyed.\");\n    }\n  }\n}\n\nexport function createScannerStore(options: ScannerStoreOptions): ScannerStore {\n  return new ScannerStore(options);\n}\n","\"use client\";\n\nimport { createContext, useContext } from \"react\";\nimport type { ScannerStore } from \"./store.js\";\n\nexport const ScannerStoreContext = createContext<ScannerStore | null>(null);\n\nexport function useScannerStoreContext(): ScannerStore {\n  const store = useContext(ScannerStoreContext);\n  if (!store) {\n    throw new Error(\n      \"useBarcodeScanner must be used within a BarcodeScannerProvider.\",\n    );\n  }\n  return store;\n}\n","\"use client\";\n\nimport { useEffect, useState, type ReactNode } from \"react\";\nimport type { BarcodeScanner, ScannerConfig } from \"@barcodesdk/core\";\nimport { ScannerStoreContext } from \"./context.js\";\nimport { createScannerStore, type ScannerStore } from \"./store.js\";\n\nexport type BarcodeScannerProviderProps = {\n  children: ReactNode;\n  /**\n   * Create a Provider-owned scanner from config.\n   * The store destroys the scanner on unmount.\n   */\n  config?: ScannerConfig;\n  /**\n   * Share an existing scanner. Provider will not destroy it on unmount.\n   * Mutually exclusive with `config`.\n   */\n  scanner?: BarcodeScanner;\n  /** Max unique accepted codes kept in history (default 12). */\n  acceptedHistoryLimit?: number;\n  /** Auto initialize after mount (default true). */\n  autoInitialize?: boolean;\n  /** Optional external store (advanced); when set, config/scanner are ignored. */\n  store?: ScannerStore;\n};\n\nfunction createOwnedStore({\n  config,\n  scanner,\n  acceptedHistoryLimit,\n  autoInitialize,\n}: Pick<\n  BarcodeScannerProviderProps,\n  \"config\" | \"scanner\" | \"acceptedHistoryLimit\" | \"autoInitialize\"\n>): ScannerStore {\n  return createScannerStore({\n    config,\n    scanner,\n    acceptedHistoryLimit,\n    autoInitialize,\n  });\n}\n\n/**\n * Owns or shares a ScannerStore for the subtree.\n *\n * Ownership rules:\n * - `config` → Provider creates + destroys the core scanner\n * - `scanner` → shared instance; caller owns destroy\n * - `store` → advanced: inject a prebuilt store\n */\nexport function BarcodeScannerProvider({\n  children,\n  config,\n  scanner,\n  acceptedHistoryLimit,\n  autoInitialize = true,\n  store: externalStore,\n}: BarcodeScannerProviderProps) {\n  const [ownedStore, setOwnedStore] = useState(() =>\n    createOwnedStore({\n      config,\n      scanner,\n      acceptedHistoryLimit,\n      autoInitialize,\n    }),\n  );\n\n  if (!externalStore && ownedStore.isDestroyed) {\n    setOwnedStore(\n      createOwnedStore({\n        config,\n        scanner,\n        acceptedHistoryLimit,\n        autoInitialize,\n      }),\n    );\n  }\n\n  const store = externalStore ?? ownedStore;\n\n  useEffect(() => {\n    if (externalStore) {\n      return;\n    }\n\n    if (store.isDestroyed) {\n      setOwnedStore(\n        createOwnedStore({\n          config,\n          scanner,\n          acceptedHistoryLimit,\n          autoInitialize,\n        }),\n      );\n      return;\n    }\n\n    const active = store;\n    return () => {\n      void active.destroy();\n    };\n  }, [store, externalStore]);\n\n  return (\n    <ScannerStoreContext.Provider value={store}>\n      {children}\n    </ScannerStoreContext.Provider>\n  );\n}\n","\"use client\";\n\nimport { useCallback, useMemo, useSyncExternalStore } from \"react\";\nimport type {\n  AttachTarget,\n  BarcodeResult,\n  ImageScanSource,\n} from \"@barcodesdk/core\";\nimport { useScannerStoreContext } from \"./context.js\";\nimport type { ScannerStoreSnapshot } from \"./store.js\";\n\nexport interface UseBarcodeScannerResult extends ScannerStoreSnapshot {\n  scanner: ReturnType<typeof useScannerStoreContext>[\"scanner\"];\n  initialize: () => Promise<void>;\n  attach: (target: AttachTarget) => Promise<void>;\n  start: () => Promise<void>;\n  stop: () => Promise<void>;\n  pause: () => Promise<void>;\n  resume: () => Promise<void>;\n  scanImage: (source: ImageScanSource) => Promise<BarcodeResult[]>;\n  clearError: () => void;\n  clearAcceptedHistory: () => void;\n}\n\n/**\n * Subscribe to scanner state via `useSyncExternalStore`.\n * Core owns state; this hook only mirrors the store snapshot.\n */\nexport function useBarcodeScanner(): UseBarcodeScannerResult {\n  const store = useScannerStoreContext();\n  const snapshot = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getServerSnapshot,\n  );\n\n  const initialize = useCallback(() => store.initialize(), [store]);\n  const attach = useCallback(\n    (target: AttachTarget) => store.attach(target),\n    [store],\n  );\n  const start = useCallback(() => store.start(), [store]);\n  const stop = useCallback(() => store.stop(), [store]);\n  const pause = useCallback(() => store.pause(), [store]);\n  const resume = useCallback(() => store.resume(), [store]);\n  const scanImage = useCallback(\n    (source: ImageScanSource) => store.scanImage(source),\n    [store],\n  );\n  const clearError = useCallback(() => store.clearError(), [store]);\n  const clearAcceptedHistory = useCallback(\n    () => store.clearAcceptedHistory(),\n    [store],\n  );\n\n  return useMemo(\n    () => ({\n      ...snapshot,\n      scanner: store.scanner,\n      initialize,\n      attach,\n      start,\n      stop,\n      pause,\n      resume,\n      scanImage,\n      clearError,\n      clearAcceptedHistory,\n    }),\n    [\n      snapshot,\n      store.scanner,\n      initialize,\n      attach,\n      start,\n      stop,\n      pause,\n      resume,\n      scanImage,\n      clearError,\n      clearAcceptedHistory,\n    ],\n  );\n}\n","\"use client\";\n\nimport {\n  useCallback,\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  type CSSProperties,\n  type ReactNode,\n  type Ref,\n} from \"react\";\nimport { useBarcodeScanner } from \"./use-barcode-scanner.js\";\n\nexport interface BarcodeScannerViewHandle {\n  video: HTMLVideoElement | null;\n  start: () => Promise<void>;\n  stop: () => Promise<void>;\n}\n\nexport interface BarcodeScannerViewProps {\n  className?: string;\n  style?: CSSProperties;\n  videoClassName?: string;\n  videoStyle?: CSSProperties;\n  /** Render overlay content inside the video frame (absolute positioned). */\n  children?: ReactNode;\n  /** Auto attach + start when the video element mounts and scanner is ready. */\n  autoStart?: boolean;\n  /** Forwarded ref with video + start/stop helpers. */\n  viewRef?: Ref<BarcodeScannerViewHandle>;\n  onStartError?: (error: unknown) => void;\n}\n\n/**\n * Video preview bound to the Provider scanner.\n * Overlay children should be absolutely positioned over the video.\n */\nexport function BarcodeScannerView({\n  className,\n  style,\n  videoClassName,\n  videoStyle,\n  children,\n  autoStart = false,\n  viewRef,\n  onStartError,\n}: BarcodeScannerViewProps) {\n  const videoRef = useRef<HTMLVideoElement>(null);\n  const { state, attach, start, stop } = useBarcodeScanner();\n  const startedRef = useRef(false);\n\n  const runStart = useCallback(async () => {\n    const video = videoRef.current;\n    if (!video) {\n      return;\n    }\n    await attach({ video });\n    await start();\n    startedRef.current = true;\n  }, [attach, start]);\n\n  const runStop = useCallback(async () => {\n    await stop();\n    startedRef.current = false;\n  }, [stop]);\n\n  useImperativeHandle(\n    viewRef,\n    () => ({\n      video: videoRef.current,\n      start: runStart,\n      stop: runStop,\n    }),\n    [runStart, runStop],\n  );\n\n  useEffect(() => {\n    if (!autoStart) {\n      return;\n    }\n    if (state !== \"ready\" && state !== \"paused\") {\n      return;\n    }\n    if (startedRef.current) {\n      return;\n    }\n    void runStart().catch((error) => {\n      onStartError?.(error);\n    });\n  }, [autoStart, state, runStart, onStartError]);\n\n  return (\n    <div\n      className={className}\n      style={{ position: \"relative\", overflow: \"hidden\", ...style }}\n    >\n      <video\n        ref={videoRef}\n        className={videoClassName}\n        aria-label=\"Barcode camera preview\"\n        style={{\n          display: \"block\",\n          width: \"100%\",\n          height: \"100%\",\n          objectFit: \"contain\",\n          ...videoStyle,\n        }}\n        muted\n        playsInline\n      />\n      {children}\n    </div>\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/provider.d.ts

@@ -0,0 +1,32 @@
+import { type ReactNode } from "react";
+import type { BarcodeScanner, ScannerConfig } from "@barcodesdk/core";
+import { type ScannerStore } from "./store.js";
+export type BarcodeScannerProviderProps = {
+    children: ReactNode;
+    /**
+     * Create a Provider-owned scanner from config.
+     * The store destroys the scanner on unmount.
+     */
+    config?: ScannerConfig;
+    /**
+     * Share an existing scanner. Provider will not destroy it on unmount.
+     * Mutually exclusive with `config`.
+     */
+    scanner?: BarcodeScanner;
+    /** Max unique accepted codes kept in history (default 12). */
+    acceptedHistoryLimit?: number;
+    /** Auto initialize after mount (default true). */
+    autoInitialize?: boolean;
+    /** Optional external store (advanced); when set, config/scanner are ignored. */
+    store?: ScannerStore;
+};
+/**
+ * Owns or shares a ScannerStore for the subtree.
+ *
+ * Ownership rules:
+ * - `config` → Provider creates + destroys the core scanner
+ * - `scanner` → shared instance; caller owns destroy
+ * - `store` → advanced: inject a prebuilt store
+ */
+export declare function BarcodeScannerProvider({ children, config, scanner, acceptedHistoryLimit, autoInitialize, store: externalStore, }: BarcodeScannerProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kDAAkD;IAClD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gFAAgF;IAChF,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,CAAC;AAmBF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,QAAQ,EACR,MAAM,EACN,OAAO,EACP,oBAAoB,EACpB,cAAqB,EACrB,KAAK,EAAE,aAAa,GACrB,EAAE,2BAA2B,+BAmD7B"}

package/dist/store.d.ts

@@ -0,0 +1,55 @@
+import { type AttachTarget, type BarcodeResult, type BarcodeScanner, type ImageScanSource, type ScannerCapabilities, type ScannerConfig, type ScannerErrorInfo, type ScannerMetrics, type ScannerState } from "@barcodesdk/core";
+export interface ScannerStoreSnapshot {
+    state: ScannerState;
+    results: BarcodeResult[];
+    /** Most recent accepted batch from the tracker. */
+    accepted: BarcodeResult[];
+    /** Deduped accepted history for UI lists (ring buffer). */
+    acceptedHistory: BarcodeResult[];
+    lastError: ScannerErrorInfo | null;
+    metrics: ScannerMetrics | null;
+    capabilities: ScannerCapabilities | null;
+}
+export interface ScannerStoreOptions {
+    /** Create and own a scanner from config. Mutually exclusive with `scanner`. */
+    config?: ScannerConfig;
+    /** Share an existing scanner instance (Provider will not destroy it). */
+    scanner?: BarcodeScanner;
+    /** Max unique accepted codes retained in history (default 12). */
+    acceptedHistoryLimit?: number;
+    /** Auto-call initialize() after store creation (default true). */
+    autoInitialize?: boolean;
+}
+/**
+ * External store wrapping `@barcodesdk/core`. Designed for
+ * `useSyncExternalStore` — React never duplicates scanner state in useState.
+ */
+export declare class ScannerStore {
+    readonly scanner: BarcodeScanner;
+    readonly ownsScanner: boolean;
+    private snapshot;
+    private readonly listeners;
+    private readonly unsubscribers;
+    private readonly acceptedHistoryLimit;
+    private destroyed;
+    /** True after `destroy()`; used to recreate the store on Strict Mode remount. */
+    get isDestroyed(): boolean;
+    constructor(options: ScannerStoreOptions);
+    subscribe: (listener: () => void) => (() => void);
+    getSnapshot: () => ScannerStoreSnapshot;
+    getServerSnapshot: () => ScannerStoreSnapshot;
+    initialize(): Promise<void>;
+    attach(target: AttachTarget): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+    scanImage(source: ImageScanSource): Promise<BarcodeResult[]>;
+    clearError(): void;
+    clearAcceptedHistory(): void;
+    destroy(): Promise<void>;
+    private update;
+    private assertAlive;
+}
+export declare function createScannerStore(options: ScannerStoreOptions): ScannerStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,mDAAmD;IACnD,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,2DAA2D;IAC3D,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,yEAAyE;IACzE,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,kEAAkE;IAClE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kEAAkE;IAClE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAkCD;;;GAGG;AACH,qBAAa,YAAY;IACvB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IACvD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,SAAS,CAAS;IAE1B,iFAAiF;IACjF,IAAI,WAAW,IAAI,OAAO,CAEzB;gBAEW,OAAO,EAAE,mBAAmB;IA+CxC,SAAS,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAK9C;IAEF,WAAW,QAAO,oBAAoB,CAAkB;IAExD,iBAAiB,QAAO,oBAAoB,CAAmB;IAEzD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IASlE,UAAU,IAAI,IAAI;IAIlB,oBAAoB,IAAI,IAAI;IAItB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB9B,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,WAAW;CAKpB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAE7E"}

package/dist/use-barcode-scanner.d.ts

@@ -0,0 +1,21 @@
+import type { AttachTarget, BarcodeResult, ImageScanSource } from "@barcodesdk/core";
+import { useScannerStoreContext } from "./context.js";
+import type { ScannerStoreSnapshot } from "./store.js";
+export interface UseBarcodeScannerResult extends ScannerStoreSnapshot {
+    scanner: ReturnType<typeof useScannerStoreContext>["scanner"];
+    initialize: () => Promise<void>;
+    attach: (target: AttachTarget) => Promise<void>;
+    start: () => Promise<void>;
+    stop: () => Promise<void>;
+    pause: () => Promise<void>;
+    resume: () => Promise<void>;
+    scanImage: (source: ImageScanSource) => Promise<BarcodeResult[]>;
+    clearError: () => void;
+    clearAcceptedHistory: () => void;
+}
+/**
+ * Subscribe to scanner state via `useSyncExternalStore`.
+ * Core owns state; this hook only mirrors the store snapshot.
+ */
+export declare function useBarcodeScanner(): UseBarcodeScannerResult;
+//# sourceMappingURL=use-barcode-scanner.d.ts.map

package/dist/use-barcode-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-barcode-scanner.d.ts","sourceRoot":"","sources":["../src/use-barcode-scanner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,OAAO,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,SAAS,CAAC,CAAC;IAC9D,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACjE,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,oBAAoB,EAAE,MAAM,IAAI,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CAuD3D"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@barcodesdk/react",
+  "version": "0.1.0",
+  "description": "React provider, hook, and scanner view for Barcode WebSDK",
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Vijay Reddy",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vjiayreddy/barcodesdk.git",
+    "directory": "packages/react"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@barcodesdk/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "jsdom": "^26",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
+    "typescript": "^5",
+    "vite": "^6",
+    "vitest": "^3"
+  },
+  "scripts": {
+    "build": "vite build && tsc --emitDeclarationOnly -p tsconfig.build.json",
+    "dev": "vite build --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}