@rustors/react 0.0.0-stage → 0.3.0

package/dist/index.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resultsToJson = exports.resultsToCsv = exports.resultsToText = exports.calculateScale = exports.scaleQuad = exports.scaleFrame = exports.DropzonePreview = exports.DropzonePrompt = exports.OcrDropzone = exports.BoundingBox = exports.OcrOverlay = exports.defaultOcrService = exports.OcrService = exports.useOcr = exports.useRusto = exports.RustoContext = exports.RustoProvider = void 0;
+// Provider & Context
+var RustoProvider_js_1 = require("./context/RustoProvider.js");
+Object.defineProperty(exports, "RustoProvider", { enumerable: true, get: function () { return RustoProvider_js_1.RustoProvider; } });
+var RustoContext_js_1 = require("./context/RustoContext.js");
+Object.defineProperty(exports, "RustoContext", { enumerable: true, get: function () { return RustoContext_js_1.RustoContext; } });
+// Hooks
+var useRusto_js_1 = require("./hooks/useRusto.js");
+Object.defineProperty(exports, "useRusto", { enumerable: true, get: function () { return useRusto_js_1.useRusto; } });
+var useOcr_js_1 = require("./hooks/useOcr.js");
+Object.defineProperty(exports, "useOcr", { enumerable: true, get: function () { return useOcr_js_1.useOcr; } });
+// Services
+var ocrService_js_1 = require("./services/ocrService.js");
+Object.defineProperty(exports, "OcrService", { enumerable: true, get: function () { return ocrService_js_1.OcrService; } });
+Object.defineProperty(exports, "defaultOcrService", { enumerable: true, get: function () { return ocrService_js_1.defaultOcrService; } });
+// UI Components
+var OcrOverlay_js_1 = require("./components/OcrOverlay.js");
+Object.defineProperty(exports, "OcrOverlay", { enumerable: true, get: function () { return OcrOverlay_js_1.OcrOverlay; } });
+var BoundingBox_js_1 = require("./components/BoundingBox.js");
+Object.defineProperty(exports, "BoundingBox", { enumerable: true, get: function () { return BoundingBox_js_1.BoundingBox; } });
+var OcrDropzone_js_1 = require("./components/OcrDropzone.js");
+Object.defineProperty(exports, "OcrDropzone", { enumerable: true, get: function () { return OcrDropzone_js_1.OcrDropzone; } });
+var DropzonePrompt_js_1 = require("./components/DropzonePrompt.js");
+Object.defineProperty(exports, "DropzonePrompt", { enumerable: true, get: function () { return DropzonePrompt_js_1.DropzonePrompt; } });
+var DropzonePreview_js_1 = require("./components/DropzonePreview.js");
+Object.defineProperty(exports, "DropzonePreview", { enumerable: true, get: function () { return DropzonePreview_js_1.DropzonePreview; } });
+// Geometry & Formatters
+var geometry_js_1 = require("./utils/geometry.js");
+Object.defineProperty(exports, "scaleFrame", { enumerable: true, get: function () { return geometry_js_1.scaleFrame; } });
+Object.defineProperty(exports, "scaleQuad", { enumerable: true, get: function () { return geometry_js_1.scaleQuad; } });
+Object.defineProperty(exports, "calculateScale", { enumerable: true, get: function () { return geometry_js_1.calculateScale; } });
+var formatters_js_1 = require("./utils/formatters.js");
+Object.defineProperty(exports, "resultsToText", { enumerable: true, get: function () { return formatters_js_1.resultsToText; } });
+Object.defineProperty(exports, "resultsToCsv", { enumerable: true, get: function () { return formatters_js_1.resultsToCsv; } });
+Object.defineProperty(exports, "resultsToJson", { enumerable: true, get: function () { return formatters_js_1.resultsToJson; } });
+// Types
+__exportStar(require("./types/index.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qBAAqB;AACrB,+DAA2D;AAAlD,iHAAA,aAAa,OAAA;AACtB,6DAAyD;AAAhD,+GAAA,YAAY,OAAA;AAErB,QAAQ;AACR,mDAA+C;AAAtC,uGAAA,QAAQ,OAAA;AACjB,+CAA2C;AAAlC,mGAAA,MAAM,OAAA;AAEf,WAAW;AACX,0DAAyE;AAAhE,2GAAA,UAAU,OAAA;AAAE,kHAAA,iBAAiB,OAAA;AAEtC,gBAAgB;AAChB,4DAAwD;AAA/C,2GAAA,UAAU,OAAA;AACnB,8DAA0D;AAAjD,6GAAA,WAAW,OAAA;AACpB,8DAA0D;AAAjD,6GAAA,WAAW,OAAA;AACpB,oEAAgE;AAAvD,mHAAA,cAAc,OAAA;AACvB,sEAAkE;AAAzD,qHAAA,eAAe,OAAA;AAExB,wBAAwB;AACxB,mDAA4E;AAAnE,yGAAA,UAAU,OAAA;AAAE,wGAAA,SAAS,OAAA;AAAE,6GAAA,cAAc,OAAA;AAC9C,uDAAmF;AAA1E,8GAAA,aAAa,OAAA;AAAE,6GAAA,YAAY,OAAA;AAAE,8GAAA,aAAa,OAAA;AAEnD,QAAQ;AACR,mDAAiC"}

package/dist/services/ocrService.d.ts

@@ -0,0 +1,12 @@
+import { WebOcrEngine, type DetectTextOptions, type ImageSource, type InitializeConfig, type TextResult } from '@rustors/web';
+export declare class OcrService {
+    private engine;
+    constructor(engineInstance?: WebOcrEngine);
+    init(config?: InitializeConfig): Promise<void>;
+    isReady(): boolean;
+    detect(source: ImageSource, options?: DetectTextOptions): Promise<TextResult[] | string>;
+    terminate(): void;
+    getEngine(): WebOcrEngine;
+}
+export declare const defaultOcrService: OcrService;
+//# sourceMappingURL=ocrService.d.ts.map

package/dist/services/ocrService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocrService.d.ts","sourceRoot":"","sources":["../../src/services/ocrService.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAEtB,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAe;gBAEjB,cAAc,CAAC,EAAE,YAAY;IAI5B,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,OAAO,IAAI,OAAO;IAIZ,MAAM,CACjB,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC;IAO1B,SAAS,IAAI,IAAI;IAIjB,SAAS,IAAI,YAAY;CAGjC;AAED,eAAO,MAAM,iBAAiB,YAAmB,CAAC"}

package/dist/services/ocrService.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultOcrService = exports.OcrService = void 0;
+const web_1 = require("@rustors/web");
+class OcrService {
+    constructor(engineInstance) {
+        this.engine = engineInstance || new web_1.WebOcrEngine();
+    }
+    async init(config) {
+        await this.engine.initialize(config);
+    }
+    isReady() {
+        return this.engine.isInitialized();
+    }
+    async detect(source, options) {
+        if (!this.engine.isInitialized()) {
+            throw new Error('OCR Service engine is not ready. Call init() first.');
+        }
+        return this.engine.detectText(source, options);
+    }
+    terminate() {
+        this.engine.terminate();
+    }
+    getEngine() {
+        return this.engine;
+    }
+}
+exports.OcrService = OcrService;
+exports.defaultOcrService = new OcrService();
+//# sourceMappingURL=ocrService.js.map

package/dist/services/ocrService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ocrService.js","sourceRoot":"","sources":["../../src/services/ocrService.ts"],"names":[],"mappings":";;;AAAA,sCAMsB;AAEtB,MAAa,UAAU;IAGrB,YAAY,cAA6B;QACvC,IAAI,CAAC,MAAM,GAAG,cAAc,IAAI,IAAI,kBAAY,EAAE,CAAC;IACrD,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,MAAyB;QACzC,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAEM,OAAO;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IACrC,CAAC;IAEM,KAAK,CAAC,MAAM,CACjB,MAAmB,EACnB,OAA2B;QAE3B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAEM,SAAS;QACd,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC;IAEM,SAAS;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAhCD,gCAgCC;AAEY,QAAA,iBAAiB,GAAG,IAAI,UAAU,EAAE,CAAC"}

package/dist/types/components.d.ts

@@ -0,0 +1,44 @@
+import type { CSSProperties, ReactNode } from 'react';
+import type { TextResult, DetectTextOptions } from '@rustors/web';
+export interface BoundingBoxProps {
+    item: TextResult;
+    scaleX: number;
+    scaleY: number;
+    highlightColor?: string;
+    showTooltip?: boolean;
+    className?: string;
+    style?: CSSProperties;
+    onClick?: (item: TextResult) => void;
+}
+export interface OcrOverlayProps {
+    imageSrc: string;
+    results: TextResult[];
+    naturalWidth?: number;
+    naturalHeight?: number;
+    highlightColor?: string;
+    showTooltips?: boolean;
+    className?: string;
+    style?: CSSProperties;
+    onItemClick?: (item: TextResult) => void;
+}
+export interface DropzonePromptProps {
+    title?: string;
+    subtitle?: string;
+    icon?: ReactNode;
+    className?: string;
+}
+export interface DropzonePreviewProps {
+    previewUrl: string;
+    onClear: () => void;
+    className?: string;
+}
+export interface OcrDropzoneProps {
+    onFileSelect?: (file: File) => void;
+    onDetect?: (results: TextResult[] | string) => void;
+    autoDetect?: boolean;
+    detectOptions?: DetectTextOptions;
+    accept?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+//# sourceMappingURL=components.d.ts.map

package/dist/types/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/types/components.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAElE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,KAAK,IAAI,CAAC;IACpD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB"}

package/dist/types/components.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=components.js.map

package/dist/types/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../../src/types/components.ts"],"names":[],"mappings":""}

package/dist/types/context.d.ts

@@ -0,0 +1,16 @@
+import type { InitializeConfig } from '@rustors/web';
+import type { OcrService } from '../services/ocrService.js';
+export type RustoStatus = 'idle' | 'initializing' | 'ready' | 'error';
+export interface RustoContextValue {
+    status: RustoStatus;
+    isReady: boolean;
+    error: Error | null;
+    initialize: (config?: InitializeConfig) => Promise<void>;
+    service: OcrService;
+}
+export interface RustoProviderProps {
+    children: React.ReactNode;
+    config?: InitializeConfig;
+    autoInitialize?: boolean;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/types/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/dist/types/context.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=context.js.map

package/dist/types/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":""}

package/dist/types/hooks.d.ts

@@ -0,0 +1,14 @@
+import type { DetectTextOptions, ImageSource, TextResult } from '@rustors/web';
+export interface UseOcrOptions extends DetectTextOptions {
+    onSuccess?: (results: TextResult[] | string) => void;
+    onError?: (error: Error) => void;
+}
+export interface UseOcrReturn {
+    detect: (source: ImageSource, overrideOptions?: DetectTextOptions) => Promise<TextResult[] | string>;
+    results: TextResult[];
+    spatialText: string;
+    isProcessing: boolean;
+    error: Error | null;
+    reset: () => void;
+}
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,UAAU,EACX,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,KAAK,IAAI,CAAC;IACrD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,CACN,MAAM,EAAE,WAAW,EACnB,eAAe,CAAC,EAAE,iBAAiB,KAChC,OAAO,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,CAAC;IACpC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB"}

package/dist/types/hooks.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=hooks.js.map

package/dist/types/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './context.js';
+export * from './hooks.js';
+export * from './components.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./context.js"), exports);
+__exportStar(require("./hooks.js"), exports);
+__exportStar(require("./components.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,6CAA2B;AAC3B,kDAAgC"}

package/dist/utils/formatters.d.ts

@@ -0,0 +1,14 @@
+import type { TextResult } from '@rustors/web';
+/**
+ * Combines all recognized text tokens into a single text block.
+ */
+export declare function resultsToText(results: TextResult[]): string;
+/**
+ * Formats OCR results into standard CSV with bounding box coordinates and scores.
+ */
+export declare function resultsToCsv(results: TextResult[]): string;
+/**
+ * Pretty formats OCR results as a JSON string.
+ */
+export declare function resultsToJson(results: TextResult[], indent?: number): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/utils/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAO1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM,CAE/E"}

package/dist/utils/formatters.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resultsToText = resultsToText;
+exports.resultsToCsv = resultsToCsv;
+exports.resultsToJson = resultsToJson;
+/**
+ * Combines all recognized text tokens into a single text block.
+ */
+function resultsToText(results) {
+    return results.map((r) => r.text).join('\n');
+}
+/**
+ * Formats OCR results into standard CSV with bounding box coordinates and scores.
+ */
+function resultsToCsv(results) {
+    const header = 'text,score,left,top,width,height';
+    const rows = results.map((r) => {
+        const escapedText = `"${r.text.replace(/"/g, '""')}"`;
+        return `${escapedText},${r.score.toFixed(4)},${r.frame.left},${r.frame.top},${r.frame.width},${r.frame.height}`;
+    });
+    return [header, ...rows].join('\n');
+}
+/**
+ * Pretty formats OCR results as a JSON string.
+ */
+function resultsToJson(results, indent = 2) {
+    return JSON.stringify(results, null, indent);
+}
+//# sourceMappingURL=formatters.js.map

package/dist/utils/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":";;AAKA,sCAEC;AAKD,oCAOC;AAKD,sCAEC;AAxBD;;GAEG;AACH,SAAgB,aAAa,CAAC,OAAqB;IACjD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,OAAqB;IAChD,MAAM,MAAM,GAAG,kCAAkC,CAAC;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;QACtD,OAAO,GAAG,WAAW,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IAClH,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,OAAqB,EAAE,SAAiB,CAAC;IACrE,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC"}

package/dist/utils/geometry.d.ts

@@ -0,0 +1,9 @@
+import type { Frame } from '@rustors/web';
+export type QuadPoints = [[number, number], [number, number], [number, number], [number, number]];
+export declare function scaleFrame(frame: Frame, scaleX: number, scaleY: number): Frame;
+export declare function scaleQuad(quad: QuadPoints, scaleX: number, scaleY: number): QuadPoints;
+export declare function calculateScale(naturalWidth: number, naturalHeight: number, renderWidth: number, renderHeight: number): {
+    scaleX: number;
+    scaleY: number;
+};
+//# sourceMappingURL=geometry.d.ts.map

package/dist/utils/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/utils/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAElG,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAO9E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAOtF;AAED,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAQpC"}

package/dist/utils/geometry.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scaleFrame = scaleFrame;
+exports.scaleQuad = scaleQuad;
+exports.calculateScale = calculateScale;
+function scaleFrame(frame, scaleX, scaleY) {
+    return {
+        left: Math.round(frame.left * scaleX * 100) / 100,
+        top: Math.round(frame.top * scaleY * 100) / 100,
+        width: Math.round(frame.width * scaleX * 100) / 100,
+        height: Math.round(frame.height * scaleY * 100) / 100,
+    };
+}
+function scaleQuad(quad, scaleX, scaleY) {
+    return [
+        [Math.round(quad[0][0] * scaleX * 100) / 100, Math.round(quad[0][1] * scaleY * 100) / 100],
+        [Math.round(quad[1][0] * scaleX * 100) / 100, Math.round(quad[1][1] * scaleY * 100) / 100],
+        [Math.round(quad[2][0] * scaleX * 100) / 100, Math.round(quad[2][1] * scaleY * 100) / 100],
+        [Math.round(quad[3][0] * scaleX * 100) / 100, Math.round(quad[3][1] * scaleY * 100) / 100],
+    ];
+}
+function calculateScale(naturalWidth, naturalHeight, renderWidth, renderHeight) {
+    if (naturalWidth <= 0 || naturalHeight <= 0 || renderWidth <= 0 || renderHeight <= 0) {
+        return { scaleX: 1, scaleY: 1 };
+    }
+    return {
+        scaleX: renderWidth / naturalWidth,
+        scaleY: renderHeight / naturalHeight,
+    };
+}
+//# sourceMappingURL=geometry.js.map

package/dist/utils/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../../src/utils/geometry.ts"],"names":[],"mappings":";;AAIA,gCAOC;AAED,8BAOC;AAED,wCAaC;AA/BD,SAAgB,UAAU,CAAC,KAAY,EAAE,MAAc,EAAE,MAAc;IACrE,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG;QACjD,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG;QAC/C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG;QACnD,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG;KACtD,CAAC;AACJ,CAAC;AAED,SAAgB,SAAS,CAAC,IAAgB,EAAE,MAAc,EAAE,MAAc;IACxE,OAAO;QACL,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1F,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1F,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1F,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;KAC3F,CAAC;AACJ,CAAC;AAED,SAAgB,cAAc,CAC5B,YAAoB,EACpB,aAAqB,EACrB,WAAmB,EACnB,YAAoB;IAEpB,IAAI,YAAY,IAAI,CAAC,IAAI,aAAa,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QACrF,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAClC,CAAC;IACD,OAAO;QACL,MAAM,EAAE,WAAW,GAAG,YAAY;QAClC,MAAM,EAAE,YAAY,GAAG,aAAa;KACrC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@rustors/react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "description": "React hooks, provider, and UI components for RustO! OCR engine",
+  "keywords": [
+    "ocr",
+    "rusto",
+    "react",
+    "hooks",
+    "components",
+    "text-recognition",
+    "typescript"
+  ],
+  "homepage": "https://github.com/byrizki/rusto-rs#readme",
+  "bugs": {
+    "url": "https://github.com/byrizki/rusto-rs/issues"
+  },
+  "license": "MIT",
+  "author": "byrizki <contact@byrizki.com> (https://github.com/byrizki)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/byrizki/rusto-rs.git",
+    "directory": "packages/react"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "@rustors/web": ">=0.2.5"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "react": "^18.2.0",
+    "@rustors/web": "file:../web",
+    "typescript": "^5.0.2"
+  }
+}

package/src/components/BoundingBox.tsx

@@ -0,0 +1,63 @@
+import { type ReactElement } from 'react';
+import type { BoundingBoxProps } from '../types/index.js';
+import { scaleFrame } from '../utils/geometry.js';
+
+export function BoundingBox({
+  item,
+  scaleX,
+  scaleY,
+  highlightColor = 'rgba(59, 130, 246, 0.4)',
+  showTooltip = true,
+  className,
+  style,
+  onClick,
+}: BoundingBoxProps): ReactElement {
+  const scaled = scaleFrame(item.frame, scaleX, scaleY);
+
+  const boxStyle: React.CSSProperties = {
+    position: 'absolute',
+    left: `${scaled.left}px`,
+    top: `${scaled.top}px`,
+    width: `${scaled.width}px`,
+    height: `${scaled.height}px`,
+    border: `1.5px solid ${highlightColor}`,
+    backgroundColor: highlightColor.replace(/[\d.]+\)$/, '0.15)'),
+    cursor: onClick ? 'pointer' : 'default',
+    pointerEvents: 'auto',
+    boxSizing: 'border-box',
+    borderRadius: '2px',
+    ...style,
+  };
+
+  const tooltipStyle: React.CSSProperties = {
+    position: 'absolute',
+    bottom: '100%',
+    left: '0',
+    backgroundColor: '#1f2937',
+    color: '#ffffff',
+    fontSize: '11px',
+    lineHeight: '1.2',
+    padding: '2px 6px',
+    borderRadius: '4px',
+    whiteSpace: 'nowrap',
+    pointerEvents: 'none',
+    zIndex: 10,
+    transform: 'translateY(-2px)',
+    boxShadow: '0 2px 4px rgba(0,0,0,0.2)',
+  };
+
+  return (
+    <div
+      className={className}
+      style={boxStyle}
+      onClick={() => onClick?.(item)}
+      title={`${item.text} (${Math.round(item.score * 100)}%)`}
+    >
+      {showTooltip && (
+        <span style={tooltipStyle}>
+          {item.text} <small style={{ opacity: 0.75 }}>({Math.round(item.score * 100)}%)</small>
+        </span>
+      )}
+    </div>
+  );
+}

package/src/components/DropzonePreview.tsx

@@ -0,0 +1,61 @@
+import { type ReactElement } from 'react';
+import type { DropzonePreviewProps } from '../types/index.js';
+
+export function DropzonePreview({
+  previewUrl,
+  onClear,
+  className,
+}: DropzonePreviewProps): ReactElement {
+  return (
+    <div
+      className={className}
+      style={{
+        position: 'relative',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        padding: '12px',
+        width: '100%',
+        boxSizing: 'border-box',
+      }}
+    >
+      <img
+        src={previewUrl}
+        alt="Uploaded Preview"
+        style={{
+          maxHeight: '260px',
+          maxWidth: '100%',
+          objectFit: 'contain',
+          borderRadius: '4px',
+        }}
+      />
+      <button
+        type="button"
+        onClick={(e) => {
+          e.stopPropagation();
+          onClear();
+        }}
+        style={{
+          position: 'absolute',
+          top: '16px',
+          right: '16px',
+          backgroundColor: 'rgba(0, 0, 0, 0.65)',
+          color: '#ffffff',
+          border: 'none',
+          borderRadius: '50%',
+          width: '28px',
+          height: '28px',
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'center',
+          cursor: 'pointer',
+          fontSize: '14px',
+          lineHeight: 1,
+        }}
+        aria-label="Remove image"
+      >
+        ×
+      </button>
+    </div>
+  );
+}

package/src/components/DropzonePrompt.tsx

@@ -0,0 +1,46 @@
+import { type ReactElement } from 'react';
+import type { DropzonePromptProps } from '../types/index.js';
+
+export function DropzonePrompt({
+  title = 'Click or drag image here to scan',
+  subtitle = 'Supports PNG, JPEG, WebP, and document scans',
+  icon,
+  className,
+}: DropzonePromptProps): ReactElement {
+  return (
+    <div
+      className={className}
+      style={{
+        display: 'flex',
+        flexDirection: 'column',
+        alignItems: 'center',
+        justifyContent: 'center',
+        padding: '32px 16px',
+        textAlign: 'center',
+        pointerEvents: 'none',
+      }}
+    >
+      {icon || (
+        <svg
+          style={{ width: '40px', height: '40px', color: '#6b7280', marginBottom: '12px' }}
+          fill="none"
+          stroke="currentColor"
+          viewBox="0 0 24 24"
+        >
+          <path
+            strokeLinecap="round"
+            strokeLinejoin="round"
+            strokeWidth={1.5}
+            d="M4 16l4.586-4.586a2 2 0 012.828 0L16 16m-2-2l1.586-1.586a2 2 0 012.828 0L20 14m-6-6h.01M6 20h12a2 2 0 002-2V6a2 2 0 00-2-2H6a2 2 0 00-2 2v12a2 2 0 002 2z"
+          />
+        </svg>
+      )}
+      <p style={{ margin: '0 0 4px', fontSize: '14px', fontWeight: 600, color: '#374151' }}>
+        {title}
+      </p>
+      <p style={{ margin: 0, fontSize: '12px', color: '#6b7280' }}>
+        {subtitle}
+      </p>
+    </div>
+  );
+}