@scanfit/browser 0.1.0-alpha.0

package/dist/styles.css

@@ -0,0 +1 @@
+.sf-scanner{--sf-accent: #22644c;--sf-accent-soft: #edf5ef;--sf-ink: #202e27;--sf-muted: #66736c;--sf-border: #dce4dc;--sf-surface: #fff;--sf-radius: 16px;color:var(--sf-ink);background:var(--sf-surface);font:14px/1.5 ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;border:1px solid var(--sf-border);border-radius:var(--sf-radius);overflow:hidden;text-align:start}.sf-scanner *{box-sizing:border-box}.sf-scanner button,.sf-scanner select{font:inherit;color:inherit;min-height:40px;border:1px solid var(--sf-border);border-radius:8px;background:var(--sf-surface);padding:8px 12px;cursor:pointer}.sf-scanner button:hover:not(:disabled){border-color:var(--sf-accent);background:var(--sf-accent-soft)}.sf-scanner button:disabled{opacity:.5;cursor:not-allowed}.sf-scanner :focus-visible{outline:3px solid #4d9a7d;outline-offset:3px}.sf-scanner h2,.sf-scanner h3,.sf-scanner h4,.sf-scanner p{margin:0}.sf-scanner h2{font-size:20px;letter-spacing:-.5px}.sf-scanner h3{font-size:20px;letter-spacing:-.4px}.sf-scanner p{color:var(--sf-muted)}.sf-header{padding:24px 28px;display:flex;justify-content:space-between;align-items:center;border-bottom:1px solid var(--sf-border);gap:16px}.sf-header p{margin-top:4px}.sf-scanner .sf-primary{background:var(--sf-accent);border-color:var(--sf-accent);color:#fff;font-weight:600;display:inline-flex;align-items:center;justify-content:center;gap:20px}.sf-scanner .sf-primary:hover:not(:disabled){background:#174c39;color:#fff}.sf-scanner .sf-icon-button{font-size:24px;line-height:1;width:40px;padding:0}.sf-file-input{position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)}.sf-empty{padding:54px 24px 48px;text-align:center;background:radial-gradient(ellipse at 50% 20%,#f0f7ed,transparent 65%)}.sf-empty h3{font-size:25px;margin-top:28px}.sf-empty>p{max-width:360px;margin:10px auto 24px}.sf-empty-actions{display:flex;justify-content:center;gap:10px;margin-bottom:16px}.sf-empty small{color:var(--sf-muted);font-size:12px}.sf-paper-illustration{height:122px;width:92px;margin:auto;background:#fff;box-shadow:0 8px 24px #314d2312;border:1px solid #cbd9c7;transform:rotate(-8deg);border-radius:8px;padding:25px 16px;position:relative}.sf-paper-illustration span{display:block;height:4px;background:#d9e4d4;margin-bottom:9px;border-radius:2px}.sf-paper-illustration span:nth-child(2){width:75%}.sf-paper-illustration span:nth-child(4){width:65%}.sf-paper-illustration i{position:absolute;right:-15px;bottom:10px;width:37px;height:37px;display:grid;place-items:center;background:var(--sf-accent);color:#fff;font:24px system-ui;border:5px solid #f1f7ed;border-radius:50%;box-sizing:content-box}.sf-privacy{padding:16px 24px;border-top:1px solid var(--sf-border);font-size:12px;text-align:center;color:var(--sf-accent);background:#fafcf9}.sf-privacy small{display:block;font-size:11px;color:var(--sf-muted);margin-top:4px}.sf-toolbar,.sf-footer{padding:18px 24px;display:flex;align-items:center;justify-content:space-between;gap:12px}.sf-toolbar{border-bottom:1px solid var(--sf-border)}.sf-toolbar>div:last-child{display:flex;gap:8px}.sf-count{font-weight:600}.sf-workspace{display:grid;grid-template-columns:100px minmax(0,1fr);min-height:400px}.sf-pages{padding:20px 12px;background:#f7f9f5;border-inline-end:1px solid var(--sf-border);display:flex;flex-direction:column;gap:12px}.sf-scanner .sf-thumbnail{display:block;width:72px;height:94px;padding:5px;position:relative;overflow:hidden}.sf-thumbnail img{width:100%;height:100%;object-fit:contain}.sf-thumbnail span{position:absolute;bottom:4px;inset-inline-start:4px;background:#fff;border:1px solid var(--sf-border);font-size:10px;line-height:16px;padding:0 4px;border-radius:3px}.sf-scanner .sf-thumbnail.sf-current{border:2px solid var(--sf-accent);box-shadow:0 0 0 3px #22644c12}.sf-editor{padding:18px 24px;min-width:0}.sf-editor-heading,.sf-section-heading{display:flex;align-items:center;justify-content:space-between;gap:12px;margin-bottom:20px}.sf-editor-heading>span{font-size:12px;color:var(--sf-muted)}.sf-tabs{display:flex;gap:4px;background:#f3f5f0;padding:4px;border-radius:8px}.sf-scanner .sf-tabs button{border:0;background:transparent;min-height:32px;padding:5px 12px;font-size:12px}.sf-scanner .sf-tabs button[aria-pressed=true]{background:#fff;box-shadow:0 1px 4px #00000010;color:var(--sf-accent)}.sf-crop{padding:12px 0}.sf-image-wrap{position:relative;width:min(100%,400px);margin:8px auto 28px;background:#eef1eb}.sf-image-wrap>img{width:100%;height:100%;display:block;object-fit:contain}.sf-outline{position:absolute;inset:0;width:100%;height:100%;pointer-events:none;overflow:visible}.sf-outline polygon{fill:#21664912;stroke:#27875f;stroke-width:2;vector-effect:non-scaling-stroke}.sf-scanner .sf-handle{position:absolute;transform:translate(-50%,-50%);width:44px;height:44px;min-height:44px;border:0;background:transparent;padding:0;touch-action:none;border-radius:50%}.sf-handle:after{content:"";display:block;width:15px;height:15px;border:3px solid #fff;border-radius:50%;background:var(--sf-accent);box-shadow:0 1px 5px #0007;margin:auto}.sf-scanner .sf-handle:hover:not(:disabled),.sf-handle.sf-selected{background:#22644c15}.sf-corner-tools{display:flex;align-items:center;justify-content:center;flex-wrap:wrap;gap:16px}.sf-magnifier{width:96px;height:96px;border:2px solid var(--sf-border);border-radius:12px;background-repeat:no-repeat;flex-shrink:0;display:grid;place-items:center;background-color:#eef1eb}.sf-magnifier span{font:28px monospace;color:#cf3e32;text-shadow:0 0 2px #fff}.sf-label{display:flex;align-items:center;gap:8px;font-size:12px}.sf-nudges{display:flex;gap:4px;margin-top:6px}.sf-scanner .sf-nudges button{min-width:40px;padding:6px}.sf-crop-actions{display:flex;gap:6px;flex-direction:column}.sf-scanner .sf-hint{font-size:12px;color:var(--sf-muted);margin-top:12px}.sf-page-actions{display:flex;flex-wrap:wrap;gap:6px;align-items:center;margin-top:20px;border-top:1px solid var(--sf-border);padding-top:16px}.sf-page-actions label{display:flex;gap:6px;align-items:center;font-size:12px}.sf-page-actions button,.sf-page-actions select{font-size:12px}.sf-scanner .sf-danger{color:#a43d32}.sf-footer{border-top:1px solid var(--sf-border)}.sf-footer label{display:flex;gap:8px;align-items:center}.sf-export-actions{display:flex;align-items:center;gap:16px}.sf-export-actions>span{font-size:12px;color:var(--sf-muted)}.sf-error{color:#8e2b21;background:#fff2ee;border-bottom:1px solid #f3d5cc;padding:14px 24px}.sf-progress{padding:12px 24px;background:var(--sf-accent-soft)}.sf-progress>div{display:flex;align-items:center;justify-content:space-between}.sf-progress progress{width:100%;height:6px;accent-color:var(--sf-accent)}.sf-camera{padding:24px;text-align:center}.sf-camera video{display:block;width:100%;max-height:55vh;background:#16271f;border-radius:10px}.sf-camera p{margin:12px 0}.sf-processed{min-height:250px;display:grid;place-items:center;background:#f3f5f0;padding:16px}.sf-processed img{max-height:520px;max-width:100%;object-fit:contain}.sf-result-banner{display:flex;align-items:flex-start;gap:14px;padding:24px;background:#f3f8f0}.sf-result-banner p{margin-top:6px;font-size:13px}.sf-result-icon{width:32px;height:32px;display:grid;place-items:center;background:var(--sf-accent);color:#fff;border-radius:50%;flex-shrink:0}.sf-warning{background:#fff6e8}.sf-warning .sf-result-icon{background:#a66a17}.sf-review-layout{display:grid;grid-template-columns:minmax(0,1fr) 250px}.sf-final-stage{padding:20px;min-width:0;background:#f6f8f3}.sf-zoom-viewport{overflow:auto;max-height:520px;border:1px solid var(--sf-border);background:#e5e8e1}.sf-zoom-viewport img{display:block}.sf-report{padding:24px;border-inline-start:1px solid var(--sf-border)}.sf-size-number{font-size:32px;font-weight:650;letter-spacing:-1px}.sf-report>p{font-size:12px}.sf-budget-track{height:5px;background:#edf0e8;margin:16px 0 24px;border-radius:3px;overflow:hidden}.sf-budget-track span{height:100%;background:var(--sf-accent);display:block}.sf-report ol{list-style:none;padding:0;margin:10px 0}.sf-report li{display:flex;align-items:center;justify-content:space-between;border-bottom:1px solid #edf0e8;font-size:12px}.sf-scanner .sf-report li button{border:0;background:transparent;padding-inline:0;font-size:12px}.sf-report dl{font-size:12px;margin-top:24px}.sf-report dt{color:var(--sf-muted)}.sf-report dd{margin:2px 0 12px}.sf-dialog{width:min(980px,calc(100vw - 24px));max-height:calc(100dvh - 32px);padding:0;border:0;border-radius:16px;box-shadow:0 20px 100px #0003}.sf-dialog::backdrop{background:#15261eb0}.sf-dialog .sf-scanner{border:0}@media(max-width:650px){.sf-header{padding:18px}.sf-header h2{font-size:18px}.sf-workspace{grid-template-columns:1fr}.sf-pages{flex-direction:row;overflow:auto;border-inline-end:0;border-bottom:1px solid var(--sf-border);padding:12px}.sf-scanner .sf-thumbnail{width:52px;height:68px}.sf-editor{padding:16px}.sf-image-wrap{width:min(90%,350px)}.sf-crop-actions{flex-direction:row}.sf-magnifier{width:96px;height:96px}.sf-footer{flex-wrap:wrap;padding:16px}.sf-export-actions{width:100%;justify-content:space-between}.sf-toolbar{padding:12px}.sf-toolbar button{font-size:12px;padding:6px 8px}.sf-review-layout{grid-template-columns:1fr}.sf-report{border-inline-start:0;border-top:1px solid var(--sf-border)}.sf-empty{padding:40px 16px}.sf-empty h3{font-size:22px}.sf-result-banner{padding:18px}.sf-report ol{display:grid;grid-template-columns:1fr 1fr;gap:0 20px}.sf-page-actions{gap:8px}.sf-section-heading{flex-wrap:wrap}.sf-dialog{width:calc(100vw - 16px);max-height:calc(100dvh - 16px)}}@media(prefers-reduced-motion:reduce){.sf-scanner *{scroll-behavior:auto!important}}

package/dist/trigger.js

@@ -0,0 +1,59 @@
+import { jsxs as x, Fragment as E, jsx as o } from "react/jsx-runtime";
+import { useState as c, useRef as s, useEffect as g } from "react";
+function v({
+  children: p = "Scan documents",
+  loadingLabel: h = "Loading scanner…",
+  ...C
+}) {
+  const [l, u] = c(!1), [a, i] = c(!1), [f, d] = c(""), [r, y] = c(null), t = s(null), m = s(null), n = s(!0);
+  g(() => (n.current = !0, () => {
+    n.current = !1;
+  }), []), g(() => {
+    l && r && t.current?.showModal();
+  }, [l, r]);
+  const S = () => {
+    t.current?.close(), u(!1), m.current?.focus();
+  };
+  async function b() {
+    i(!0), d("");
+    try {
+      const e = await import("./react.js");
+      n.current && (y(() => e.DocumentScanner), u(!0));
+    } catch (e) {
+      n.current && d(
+        e instanceof Error ? e.message : "Could not load the scanner."
+      );
+    } finally {
+      n.current && i(!1);
+    }
+  }
+  return /* @__PURE__ */ x(E, { children: [
+    /* @__PURE__ */ o(
+      "button",
+      {
+        type: "button",
+        ref: m,
+        disabled: a,
+        onClick: () => {
+          b();
+        },
+        children: a ? h : p
+      }
+    ),
+    f ? /* @__PURE__ */ o("p", { role: "alert", children: f }) : null,
+    l && r ? /* @__PURE__ */ o(
+      "dialog",
+      {
+        ref: t,
+        className: "sf-dialog",
+        onCancel: (e) => {
+          e.preventDefault(), t.current?.querySelector(".sf-icon-button")?.click();
+        },
+        children: /* @__PURE__ */ o(r, { ...C, onClose: S })
+      }
+    ) : null
+  ] });
+}
+export {
+  v as ScannerTrigger
+};

package/dist/types/core/canvas-bridge.d.ts

@@ -0,0 +1,12 @@
+import type { BridgeAction } from "./protocol";
+/** Native canvas decode/encode only. Pixel transforms never run in this bridge. */
+export declare function canvasBridge(action: BridgeAction): Promise<{
+    buffer: ArrayBuffer;
+    width: number;
+    height: number;
+} | {
+    width: number;
+    height: number;
+    blob: Blob;
+    buffer?: undefined;
+}>;

package/dist/types/core/geometry.d.ts

@@ -0,0 +1,8 @@
+import { type PageEdits, type Quad } from "./types";
+export declare function validateQuad(q: Quad): void;
+export declare function fitDimensions(width: number, height: number, longEdge?: number, maxPixels?: number): {
+    width: number;
+    height: number;
+};
+/** Pure pixel transform; invoked only by the processing worker. */
+export declare function warpPixels(source: ImageData, edits: PageEdits): ImageData;

package/dist/types/core/headers.d.ts

@@ -0,0 +1,10 @@
+import { type SafetyLimits } from "./types";
+export interface ImageHeader {
+    width: number;
+    height: number;
+    orientation: number;
+    mime: string;
+}
+/** Bounded header inspection before any image decoder is called. */
+export declare function inspectImageBytes(bytes: Uint8Array): ImageHeader;
+export declare function inspectImage(blob: Blob, limits: SafetyLimits): Promise<ImageHeader>;

package/dist/types/core/index.d.ts

@@ -0,0 +1,20 @@
+import { type ExportOptions, type ExportResult, type PageEdits, type ScanPage, type ScanSnapshot, type SessionOptions } from "./types";
+export * from "./types";
+export { inspectImageBytes } from "./headers";
+export { validateQuad } from "./geometry";
+export interface ScanSession {
+    getSnapshot(): ScanSnapshot;
+    subscribe(listener: () => void): () => void;
+    addFiles(files: Iterable<Blob>, options?: {
+        signal?: AbortSignal;
+        replacePageId?: string;
+    }): Promise<ScanPage[]>;
+    updatePage(id: string, edits: Partial<PageEdits>): void;
+    movePage(id: string, index: number): void;
+    removePage(id: string): void;
+    renderPage(id: string, signal?: AbortSignal): Promise<Blob>;
+    exportPdf(options: ExportOptions): Promise<ExportResult>;
+    cancel(): void;
+    dispose(): void;
+}
+export declare function createScanSession(options?: SessionOptions): ScanSession;

package/dist/types/core/jpeg.d.ts

@@ -0,0 +1,2 @@
+/** Remove EXIF/XMP APP1 segments from a freshly encoded JPEG. */
+export declare function stripJpegApp1(blob: Blob): Promise<Blob>;

package/dist/types/core/processor.worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/core/protocol.d.ts

@@ -0,0 +1,34 @@
+import type { ImageHeader } from "./headers";
+import type { SessionOptions, StoredPage, ExportOptions } from "./types";
+export type WorkerTask = {
+    kind: "analyze";
+    blob: Blob;
+    header: ImageHeader;
+    options: Pick<SessionOptions, "detector" | "detectorModule" | "detectorOptions">;
+} | {
+    kind: "render";
+    page: StoredPage;
+} | {
+    kind: "export";
+    pages: StoredPage[];
+    options: Omit<ExportOptions, "signal">;
+};
+export type BridgeAction = {
+    kind: "decode";
+    blob: Blob;
+    width: number;
+    height: number;
+    region?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+} | {
+    kind: "encode";
+    buffer: ArrayBuffer;
+    width: number;
+    height: number;
+    quality: number;
+    longEdge: number;
+};

package/dist/types/core/types.d.ts

@@ -0,0 +1,132 @@
+export interface Point {
+    x: number;
+    y: number;
+}
+/** Clockwise TL, TR, BR, BL, normalized in the oriented source image. */
+export type Quad = [Point, Point, Point, Point];
+export type Filter = "natural" | "grayscale" | "contrast";
+export type Warning = "manual-crop" | "detection-unavailable" | "possibly-blurry" | "possibly-dark" | "low-resolution";
+export interface PageEdits {
+    corners: Quad;
+    rotation: 0 | 90 | 180 | 270;
+    filter: Filter;
+}
+export interface ScanPage {
+    id: string;
+    width: number;
+    height: number;
+    sourceBytes: number;
+    preview: Blob;
+    thumbnail: Blob;
+    edits: PageEdits;
+    warnings: Warning[];
+    /** Detector evidence for observability and honest automatic-crop fallbacks. */
+    detection?: DetectionDiagnostics;
+}
+export interface StoredPage extends ScanPage {
+    source: Blob;
+}
+export type DetectionFallbackReason = "invalid-image" | "uniform-image" | "no-candidate" | "low-confidence";
+export interface DetectionDiagnostics {
+    engine: string;
+    confidence: number;
+    candidateCount: number;
+    edgeThreshold: number;
+    edgeDensity: number;
+    durationMs: number;
+    coverage: number;
+    edgeSupport: number;
+    contrast: number;
+    rectangularity: number;
+    source?: "edges" | "hough-lines" | "bright-region" | "dark-region" | "border-contrast" | string;
+    fallbackReason?: DetectionFallbackReason;
+}
+export interface DetectionResult {
+    corners: Quad | null;
+    confidence?: number;
+    /** Optional evidence for debugging, benchmarks, and honest fallbacks. */
+    diagnostics?: DetectionDiagnostics;
+}
+export interface DocumentDetector {
+    detect(image: ImageData): Promise<DetectionResult>;
+}
+export interface DetectorOptions {
+    /** Minimum heuristic evidence confidence required to accept automatic corners. */
+    minConfidence?: number;
+    /** Maximum connected regions evaluated per evidence map. */
+    maxComponents?: number;
+    /** Maximum unique quadrilateral candidates scored. */
+    maxCandidates?: number;
+}
+export interface SafetyLimits {
+    maxPages: number;
+    maxFileBytes: number;
+    maxPixels: number;
+    maxSessionBytes: number;
+}
+export interface SessionOptions {
+    limits?: Partial<SafetyLimits>;
+    detector?: "auto" | "none";
+    detectorOptions?: DetectorOptions;
+    /** Optional same-origin ES module exporting createDetector(): DocumentDetector. */
+    detectorModule?: string;
+    /** For hosts with a custom worker asset pipeline. Must be same-origin. */
+    workerUrl?: string;
+}
+export type PageSize = "a4" | "letter" | "image";
+export interface ExportOptions {
+    maxBytes: number;
+    pageSize?: PageSize;
+    minQuality?: number;
+    minLongEdge?: number;
+    signal?: AbortSignal;
+}
+export interface PageReport {
+    id: string;
+    imageBytes: number;
+    width: number;
+    height: number;
+    quality: number;
+    attempts: number;
+    warnings: Warning[];
+    preview: Blob;
+}
+export interface ExportReport {
+    bytes: number;
+    maxBytes: number;
+    pageSize: PageSize;
+    pages: PageReport[];
+    limits: {
+        minQuality: number;
+        minLongEdge: number;
+        maxEncodesPerPage: 12;
+    };
+}
+export type ExportResult = {
+    status: "ready";
+    file: File;
+    report: ExportReport;
+} | {
+    status: "cannot-fit";
+    candidateBytes: number;
+    report: ExportReport;
+} | {
+    status: "cancelled";
+};
+export interface ScanSnapshot {
+    pages: readonly ScanPage[];
+    status: "idle" | "importing" | "exporting";
+    progress: number;
+    result: ExportResult | null;
+    error: ScanError | null;
+}
+export type ErrorCode = "INVALID_INPUT" | "UNSUPPORTED_FORMAT" | "LIMIT_EXCEEDED" | "INVALID_CORNERS" | "PROCESSING_FAILED" | "UNSUPPORTED_BROWSER" | "DISPOSED" | "CAMERA_UNAVAILABLE";
+export declare class ScanError extends Error {
+    readonly code: ErrorCode;
+    constructor(code: ErrorCode, message: string, options?: ErrorOptions);
+}
+export declare const DEFAULT_LIMITS: SafetyLimits;
+export declare const FULL_QUAD: Quad;
+export declare const copyQuad: (q: Quad) => Quad;
+export declare function abortIfNeeded(signal?: AbortSignal): void;
+export declare function asScanError(error: unknown): ScanError;

package/dist/types/core/worker-client.d.ts

@@ -0,0 +1,13 @@
+import type { WorkerTask } from "./protocol";
+export declare class WorkerClient {
+    private url?;
+    private worker;
+    private sequence;
+    private generation;
+    private tail;
+    private pending;
+    constructor(url?: string | undefined);
+    private ensure;
+    run<T>(task: WorkerTask, signal?: AbortSignal, progress?: (p: number) => void): Promise<T>;
+    reset(error?: unknown): void;
+}

package/dist/types/detector/index.d.ts

@@ -0,0 +1,11 @@
+import { type ClassicalDetectorOptions } from "./scanfit-classical";
+import type { DocumentDetector } from "../core/types";
+export type { DetectionDiagnostics, DetectionResult, DocumentDetector, } from "../core/types";
+export type { ClassicalDetectorOptions } from "./scanfit-classical";
+/**
+ * Scanfit's independent, worker-safe classical detector.
+ *
+ * The implementation uses standard image-processing techniques over typed
+ * arrays and contains no Scanic source or derived code.
+ */
+export declare function createDetector(options?: ClassicalDetectorOptions): DocumentDetector;

package/dist/types/detector/scanfit-classical.d.ts

@@ -0,0 +1,4 @@
+import type { DetectionResult, DetectorOptions } from "../core/types";
+export type ClassicalDetectorOptions = DetectorOptions;
+/** Independent detector entry point, exported separately for deterministic tests. */
+export declare function detectDocument(image: ImageData, options?: ClassicalDetectorOptions): DetectionResult;

package/dist/types/pdf/index.d.ts

@@ -0,0 +1,25 @@
+import { type ExportOptions, type ExportReport, type PageSize, type Warning } from "../core/types";
+export interface EncodedPage {
+    id: string;
+    jpeg: Blob;
+    width: number;
+    height: number;
+    quality: number;
+    warnings: Warning[];
+}
+export interface PdfPageSource {
+    id: string;
+    warnings: Warning[];
+}
+export interface PdfEncoder {
+    encode(index: number, longEdge: number, quality: number): Promise<EncodedPage>;
+}
+export interface PdfFitResult {
+    status: "ready" | "cannot-fit";
+    blob: Blob;
+    report: ExportReport;
+}
+export declare function validateExportOptions(options: ExportOptions): void;
+export declare function buildPdf(pages: readonly EncodedPage[], pageSize?: PageSize): Promise<Blob>;
+/** Bounded, measured search. A cannot-fit result is not a mathematical impossibility proof. */
+export declare function fitPdf(sources: readonly PdfPageSource[], encoder: PdfEncoder, options: ExportOptions, progress?: (value: number) => void): Promise<PdfFitResult>;

package/dist/types/react/Camera.d.ts

@@ -0,0 +1,6 @@
+import type { ScannerMessages } from "./messages";
+export declare function Camera({ onCapture, onClose, messages: m, }: {
+    onCapture: (file: Blob) => void;
+    onClose: () => void;
+    messages: ScannerMessages;
+}): import("react").JSX.Element;

package/dist/types/react/CornerEditor.d.ts

@@ -0,0 +1,8 @@
+import { type Quad, type ScanPage } from "../core";
+import type { ScannerMessages } from "./messages";
+export declare function CornerEditor({ page, onApply, messages: m, disabled, }: {
+    page: ScanPage;
+    onApply: (q: Quad) => void;
+    messages: ScannerMessages;
+    disabled: boolean;
+}): import("react").JSX.Element;

package/dist/types/react/DocumentScanner.d.ts

@@ -0,0 +1,28 @@
+import { type ReactNode } from "react";
+import { type ScanSession, type SessionOptions, type ScanPage, type ExportReport } from "../core";
+import { type ScannerMessages } from "./messages";
+import "./styles.css";
+export interface DocumentScannerProps {
+    maxBytes: number;
+    onComplete: (result: {
+        file: File;
+        report: ExportReport;
+    }) => void;
+    onClose?: () => void;
+    onError?: (error: Error) => void;
+    session?: ScanSession;
+    options?: SessionOptions;
+    qualityLimits?: {
+        minQuality?: number;
+        minLongEdge?: number;
+    };
+    messages?: Partial<ScannerMessages>;
+    dir?: "ltr" | "rtl";
+    className?: string;
+    renderHeader?: (context: {
+        pageCount: number;
+        maxBytes: number;
+    }) => ReactNode;
+    renderPageSummary?: (page: ScanPage, index: number) => ReactNode;
+}
+export declare function DocumentScanner(props: DocumentScannerProps): import("react").JSX.Element;

package/dist/types/react/hooks.d.ts

@@ -0,0 +1,10 @@
+import { type ScanSession, type SessionOptions } from "../core";
+export declare function useScanSession(options?: SessionOptions, external?: ScanSession): {
+    pages: readonly import("../core").ScanPage[];
+    status: "idle" | "importing" | "exporting";
+    progress: number;
+    result: import("../core").ExportResult | null;
+    error: import("../core").ScanError | null;
+    session: ScanSession | null;
+};
+export declare function useObjectUrl(blob: Blob | null | undefined): string;

package/dist/types/react/index.d.ts

@@ -0,0 +1,5 @@
+export { DocumentScanner } from "./DocumentScanner";
+export type { DocumentScannerProps } from "./DocumentScanner";
+export { useScanSession } from "./hooks";
+export { defaultMessages, formatBytes } from "./messages";
+export type { ScannerMessages } from "./messages";

package/dist/types/react/messages.d.ts

@@ -0,0 +1,77 @@
+export declare const defaultMessages: {
+    title: string;
+    subtitle: string;
+    addPhotos: string;
+    camera: string;
+    close: string;
+    cancel: string;
+    emptyTitle: string;
+    emptyDescription: string;
+    choosePhotos: string;
+    formats: string;
+    privacy: string;
+    page: string;
+    pages: string;
+    edit: string;
+    preview: string;
+    rotate: string;
+    retake: string;
+    remove: string;
+    moveUp: string;
+    moveDown: string;
+    natural: string;
+    grayscale: string;
+    contrast: string;
+    filter: string;
+    corner: string;
+    topLeft: string;
+    topRight: string;
+    bottomRight: string;
+    bottomLeft: string;
+    nudgeUp: string;
+    nudgeDown: string;
+    nudgeLeft: string;
+    nudgeRight: string;
+    resetCrop: string;
+    cropHelp: string;
+    prepare: string;
+    preparing: string;
+    importing: string;
+    pageSize: string;
+    a4: string;
+    letter: string;
+    image: string;
+    limit: string;
+    actualSize: string;
+    imageBytes: string;
+    quality: string;
+    dimensions: string;
+    qualityFloor: string;
+    resolutionFloor: string;
+    invalidLimit: string;
+    reviewTitle: string;
+    reviewDescription: string;
+    cannotFitTitle: string;
+    cannotFitDescription: string;
+    confirm: string;
+    back: string;
+    zoom: string;
+    qualityNote: string;
+    noRecovery: string;
+    discard: string;
+    removeConfirm: string;
+    cameraTitle: string;
+    shutter: string;
+    cameraStarting: string;
+    cameraHelp: string;
+    cameraError: string;
+    correctedPreview: string;
+    sourcePreview: string;
+    manualCrop: string;
+    detectorUnavailable: string;
+    blurry: string;
+    dark: string;
+    lowResolution: string;
+};
+export type ScannerMessages = typeof defaultMessages;
+export declare const formatBytes: (bytes: number) => string;

package/dist/types/trigger/ScannerTrigger.d.ts

@@ -0,0 +1,7 @@
+import { type ReactNode } from "react";
+import type { DocumentScannerProps } from "../react/DocumentScanner";
+/** Import this entry to keep the workflow and worker out of the initial JS graph. */
+export declare function ScannerTrigger({ children, loadingLabel, ...props }: Omit<DocumentScannerProps, "onClose"> & {
+    children?: ReactNode;
+    loadingLabel?: string;
+}): import("react").JSX.Element;

package/dist/types/trigger/index.d.ts

@@ -0,0 +1 @@
+export { ScannerTrigger } from "./ScannerTrigger";

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@scanfit/browser",
+  "version": "0.1.0-alpha.0",
+  "description": "Local, size-constrained scan-to-PDF workflows for the browser",
+  "keywords": [
+    "document-scanner",
+    "pdf",
+    "react",
+    "scan-to-pdf",
+    "typescript",
+    "web-worker"
+  ],
+  "homepage": "https://scanfit-two.vercel.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ahmedsultan09/scanfit.git",
+    "directory": "packages/scanfit"
+  },
+  "bugs": {
+    "url": "https://github.com/Ahmedsultan09/scanfit/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "dist",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "exports": {
+    "./core": {
+      "types": "./dist/types/core/index.d.ts",
+      "import": "./dist/core.js"
+    },
+    "./react": {
+      "types": "./dist/types/react/index.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./trigger": {
+      "types": "./dist/types/trigger/index.d.ts",
+      "import": "./dist/trigger.js"
+    },
+    "./detector": {
+      "types": "./dist/types/detector/index.d.ts",
+      "import": "./dist/detector.js"
+    },
+    "./pdf": {
+      "types": "./dist/types/pdf/index.d.ts",
+      "import": "./dist/pdf.js"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "tinypdf": "0.4.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}