@jaak.ai/stamps 2.0.0 → 2.1.0-dev.10

package/dist/types/components/my-component/my-component.d.ts

@@ -7,6 +7,7 @@ export declare class JaakStamps {
     maskSize: number;
     cropMargin: number;
     useDocumentClassification: boolean;
+    useDocumentDetector: boolean;
     preferredCamera: 'auto' | 'front' | 'back';
     captureDelay: number;
     enableBackDocumentTimer: boolean;
@@ -31,6 +32,18 @@ export declare class JaakStamps {
     showCameraSelector: boolean;
     isSwitchingCamera: boolean;
     hasDocumentDetected: boolean;
+    cameraInfoWithAutofocus: {
+        availableCameras: Array<{
+            id: string;
+            label: string;
+            selected: boolean;
+            hasAutofocus: boolean;
+        }>;
+        selectedCameraId: string | null;
+        deviceType: string;
+        isMultipleCamerasAvailable: boolean;
+        preferredFacing: 'environment' | 'user' | null;
+    };
     currentStatus: {
         message: string;
         description?: string;
@@ -48,8 +61,12 @@ export declare class JaakStamps {
         detectionRate: number;
     };
     backDocumentTimerRemaining: number;
+    showManualCaptureButton: boolean;
+    performanceDegradedMode: boolean;
+    showPerformanceMessage: boolean;
+    captureStateVersion: number;
+    processingButton: 'capture-front' | 'capture-back' | 'skip-back' | null;
     private serviceContainer;
-    private logger;
     private eventBus;
     private stateManager;
     private cameraService;
@@ -64,14 +81,25 @@ export declare class JaakStamps {
     private alignmentStartTime?;
     private alignmentTimer?;
     private backDocumentTimer?;
+    private orientationTimer?;
     private performanceMetrics;
     private performanceUpdateInterval?;
     private frameSkipCounter;
-    private readonly FRAME_SKIP;
+    private readonly BASE_FRAME_SKIP;
+    private readonly MAX_FRAME_SKIP;
     private consecutiveFailures;
     private readonly MAX_FAILURES;
     private lastInferenceTime;
     private readonly MIN_INFERENCE_INTERVAL;
+    private performanceHistory;
+    private readonly PERFORMANCE_HISTORY_SIZE;
+    private readonly PERFORMANCE_THRESHOLD_MS;
+    private readonly SLOW_FRAMES_TO_TRIGGER;
+    private slowFrameCount;
+    private processedFramesCount;
+    private hasAutoSwitchedToManual;
+    private canvasPool;
+    private readonly MAX_CANVAS_POOL_SIZE;
     componentDidLoad(): Promise<void>;
     private initializeServices;
     private setupEventListeners;
@@ -81,16 +109,44 @@ export declare class JaakStamps {
     private finalizeInitialization;
     private updateStatus;
     private emitReadyEvent;
+    private checkCameraPermissions;
     private handleStateChange;
     private initializeResizeObserver;
     private handleResize;
+    private triggerRerender;
+    private getGuideText;
     private updateMaskDimensions;
+    private isComponentReady;
     getCapturedImages(): Promise<CapturedImagesResponse>;
     isProcessCompleted(): Promise<boolean>;
-    startCapture(): Promise<void>;
-    stopCapture(): Promise<void>;
-    resetCapture(): Promise<void>;
-    skipBackCapture(): Promise<void>;
+    startCapture(): Promise<{
+        success: boolean;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: any;
+    }>;
+    stopCapture(): Promise<{
+        success: boolean;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: any;
+    }>;
+    resetCapture(): Promise<{
+        success: boolean;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: any;
+    }>;
+    skipBackCapture(): Promise<{
+        success: boolean;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: any;
+    }>;
     getStatus(): Promise<StatusResponse>;
     preloadModel(): Promise<{
         success: boolean;
@@ -106,23 +162,24 @@ export declare class JaakStamps {
         success: boolean;
         selectedCamera: string;
         availableCameras: number;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: any;
+        selectedCamera: any;
+        availableCameras: number;
     }>;
     setCaptureDelay(delay: number): Promise<{
         success: boolean;
+        error: string;
         captureDelay: number;
-    }>;
-    getCaptureDelay(): Promise<number>;
-    setTorchEnabled(enabled: boolean): Promise<{
-        success: boolean;
-        enabled: boolean;
-    }>;
-    focusAtPoint(x: number, y: number): Promise<{
+    } | {
         success: boolean;
-        coordinates: {
-            x: number;
-            y: number;
-        };
+        captureDelay: number;
+        error?: undefined;
     }>;
+    getCaptureDelay(): Promise<number>;
+    private checkDeviceCapabilities;
     private startDetection;
     private initializeVideoStream;
     private detectFrame;
@@ -131,13 +188,22 @@ export declare class JaakStamps {
     render(): any;
     private updateDetectionBoxes;
     private updateMaskColor;
+    private takeManualScreenshot;
+    private takeScreenshotWithMaskCoordinates;
     private takeScreenshot;
     private triggerCaptureAnimation;
+    private switchToManualMode;
+    private switchToManualModeWithWarning;
+    private continueWithCameraSetup;
+    private switchToManualModeWithError;
+    private stopPerformanceMonitoring;
+    private releaseOnnxResources;
     private completeProcess;
     private stopDetection;
     private startBackDocumentTimer;
     private clearBackDocumentTimer;
     private toggleCameraSelector;
+    private updateCameraInfoWithAutofocus;
     private handleCameraSwitch;
     private resetDetection;
     private exitSession;
@@ -145,4 +211,8 @@ export declare class JaakStamps {
     private updatePerformanceMetrics;
     private recordOnnxPerformance;
     private recordFrameProcessing;
+    private getAdaptiveFrameSkip;
+    private resetMaskToWhite;
+    private getPooledCanvas;
+    private returnCanvasToPool;
 }

package/dist/types/components.d.ts

@@ -33,7 +33,6 @@ export namespace Components {
           * @default false
          */
         "enableBackDocumentTimer": boolean;
-        "focusAtPoint": (x: number, y: number) => Promise<{ success: boolean; coordinates: { x: number; y: number; }; }>;
         "getCameraInfo": () => Promise<CameraInfoResponse>;
         "getCaptureDelay": () => Promise<number>;
         "getCapturedImages": () => Promise<CapturedImagesResponse>;
@@ -48,17 +47,20 @@ export namespace Components {
          */
         "preferredCamera": 'auto' | 'front' | 'back';
         "preloadModel": () => Promise<{ success: boolean; message: string; error?: undefined; } | { success: boolean; error: any; message?: undefined; }>;
-        "resetCapture": () => Promise<void>;
-        "setCaptureDelay": (delay: number) => Promise<{ success: boolean; captureDelay: number; }>;
-        "setPreferredCamera": (camera: "auto" | "front" | "back") => Promise<{ success: boolean; selectedCamera: string; availableCameras: number; }>;
-        "setTorchEnabled": (enabled: boolean) => Promise<{ success: boolean; enabled: boolean; }>;
-        "skipBackCapture": () => Promise<void>;
-        "startCapture": () => Promise<void>;
-        "stopCapture": () => Promise<void>;
+        "resetCapture": () => Promise<{ success: boolean; error?: undefined; } | { success: boolean; error: any; }>;
+        "setCaptureDelay": (delay: number) => Promise<{ success: boolean; error: string; captureDelay: number; } | { success: boolean; captureDelay: number; error?: undefined; }>;
+        "setPreferredCamera": (camera: "auto" | "front" | "back") => Promise<{ success: boolean; selectedCamera: string; availableCameras: number; error?: undefined; } | { success: boolean; error: any; selectedCamera: any; availableCameras: number; }>;
+        "skipBackCapture": () => Promise<{ success: boolean; error?: undefined; } | { success: boolean; error: any; }>;
+        "startCapture": () => Promise<{ success: boolean; error?: undefined; } | { success: boolean; error: any; }>;
+        "stopCapture": () => Promise<{ success: boolean; error?: undefined; } | { success: boolean; error: any; }>;
         /**
           * @default false
          */
         "useDocumentClassification": boolean;
+        /**
+          * @default true
+         */
+        "useDocumentDetector": boolean;
     }
 }
 export interface JaakStampsCustomEvent<T> extends CustomEvent<T> {
@@ -128,6 +130,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "useDocumentClassification"?: boolean;
+        /**
+          * @default true
+         */
+        "useDocumentDetector"?: boolean;
     }
     interface IntrinsicElements {
         "jaak-stamps": JaakStamps;

package/dist/types/services/CameraService.d.ts

@@ -1,16 +1,18 @@
 import { ICameraService, CameraInfo } from './interfaces/ICameraService';
-import { ILogger } from './interfaces/ILogger';
 import { IEventBus } from './interfaces/IEventBus';
 export declare class CameraService implements ICameraService {
-    private logger;
     private eventBus;
     private availableCameras;
     private selectedCameraId;
     private deviceType;
     private preferredCameraFacing;
     private preferredCamera;
-    private isManuallySelected;
-    constructor(logger: ILogger, eventBus: IEventBus, preferredCamera?: 'auto' | 'front' | 'back');
+    private static cameraCapabilitiesCache;
+    private static deviceEnumerationCache;
+    private static readonly CACHE_DURATION;
+    private currentStreamPromise?;
+    private lastStreamConstraints?;
+    constructor(eventBus: IEventBus, preferredCamera?: 'auto' | 'front' | 'back');
     detectDeviceType(): Promise<'mobile' | 'desktop' | 'tablet'>;
     enumerateDevices(): Promise<MediaDeviceInfo[]>;
     getAvailableCameras(): MediaDeviceInfo[];
@@ -20,28 +22,24 @@ export declare class CameraService implements ICameraService {
     getPreferredFacing(): 'environment' | 'user' | null;
     setupCamera(constraints?: MediaTrackConstraints): Promise<MediaStream>;
     switchCamera(cameraId: string): Promise<void>;
-    flipToNextCamera(): Promise<void>;
-    savePreference(): void;
-    loadPreference(): void;
     isRearCamera(stream: MediaStream): boolean;
-    getCameraInfo(): {
+    getCameraInfo(): Promise<{
         availableCameras: CameraInfo[];
         selectedCameraId: string | null;
         deviceType: string;
         isMultipleCamerasAvailable: boolean;
         preferredFacing: 'environment' | 'user' | null;
-    };
+    }>;
     private checkCameraPermission;
     private handleCameraPermissionError;
     private setInitialCameraPreference;
+    private checkCameraAutofocus;
     private selectFrontCamera;
     private selectBackCamera;
     private selectAutoCamera;
     private updatePreferredFacing;
     private getMaxResolution;
-    private applyAdvancedCameraSettings;
-    private applyBasicFocusSettings;
-    private getCapabilitiesSummary;
-    setTorchEnabled(enabled: boolean, stream?: MediaStream): Promise<boolean>;
-    focusAtPoint(x: number, y: number, stream?: MediaStream): Promise<boolean>;
+    private constraintsEqual;
+    static clearCaches(): void;
+    invalidateDeviceCache(): void;
 }

package/dist/types/services/DetectionService.d.ts

@@ -1,9 +1,8 @@
 import { IDetectionService, DetectionBox, SideAlignment, ClassificationResult } from './interfaces/IDetectionService';
-import { ILogger } from './interfaces/ILogger';
 export declare class DetectionService implements IDetectionService {
-    private logger;
     private debug;
     private useDocumentClassification;
+    private useDocumentDetector;
     private session?;
     private mobileNetSession?;
     private mobileNetClassMap?;
@@ -17,7 +16,9 @@ export declare class DetectionService implements IDetectionService {
     private preprocessCanvas?;
     private preprocessCtx?;
     private captureCanvas?;
-    constructor(logger: ILogger, debug?: boolean, useDocumentClassification?: boolean);
+    private static canvasPool;
+    private static readonly MAX_POOL_SIZE;
+    constructor(debug?: boolean, useDocumentClassification?: boolean, useDocumentDetector?: boolean);
     loadModel(): Promise<void>;
     loadClassificationModel(): Promise<void>;
     isModelLoaded(): boolean;
@@ -32,4 +33,10 @@ export declare class DetectionService implements IDetectionService {
     private cleanupCanvasPool;
     private float32ToFloat16;
     private preprocessMobileNet;
+    private getCanvas;
+    private returnCanvas;
+    static clearCanvasPools(): void;
+    getPoolStats(): {
+        [key: string]: number;
+    };
 }

package/dist/types/services/ServiceContainer.d.ts

@@ -1,4 +1,3 @@
-import { ILogger } from './interfaces/ILogger';
 import { ICameraService } from './interfaces/ICameraService';
 import { IDetectionService } from './interfaces/IDetectionService';
 import { IStateManager } from './interfaces/IStateManager';
@@ -9,6 +8,7 @@ export interface ComponentConfig {
     maskSize: number;
     cropMargin: number;
     useDocumentClassification: boolean;
+    useDocumentDetector: boolean;
     preferredCamera: 'auto' | 'front' | 'back';
     captureDelay: number;
 }
@@ -17,7 +17,6 @@ export declare class ServiceContainer {
     constructor(config: ComponentConfig);
     private initializeServices;
     get<T>(serviceName: string): T;
-    getLogger(): ILogger;
     getEventBus(): IEventBus;
     getStateManager(): IStateManager;
     getCameraService(): ICameraService;

package/dist/types/services/interfaces/ICameraService.d.ts

@@ -2,11 +2,7 @@ export interface CameraInfo {
     id: string;
     label: string;
     selected: boolean;
-}
-export interface CameraPreference {
-    cameraId: string;
-    facing: 'environment' | 'user' | null;
-    timestamp: number;
+    hasAutofocus: boolean;
 }
 export interface ICameraService {
     detectDeviceType(): Promise<'mobile' | 'desktop' | 'tablet'>;
@@ -18,17 +14,12 @@ export interface ICameraService {
     getPreferredFacing(): 'environment' | 'user' | null;
     setupCamera(constraints?: MediaTrackConstraints): Promise<MediaStream>;
     switchCamera(cameraId: string): Promise<void>;
-    flipToNextCamera(): Promise<void>;
-    savePreference(): void;
-    loadPreference(): void;
     isRearCamera(stream: MediaStream): boolean;
-    setTorchEnabled(enabled: boolean, stream?: MediaStream): Promise<boolean>;
-    focusAtPoint(x: number, y: number, stream?: MediaStream): Promise<boolean>;
-    getCameraInfo(): {
+    getCameraInfo(): Promise<{
         availableCameras: CameraInfo[];
         selectedCameraId: string | null;
         deviceType: string;
         isMultipleCamerasAvailable: boolean;
         preferredFacing: 'environment' | 'user' | null;
-    };
+    }>;
 }

package/dist/types/stencil-public-runtime.d.ts

@@ -846,7 +846,7 @@ export declare namespace JSXBase {
     interface DetailsHTMLAttributes<T> extends HTMLAttributes<T> {
         open?: boolean;
         name?: string;
-        onToggle?: (event: Event) => void;
+        onToggle?: (event: ToggleEvent) => void;
     }
     interface DelHTMLAttributes<T> extends HTMLAttributes<T> {
         cite?: string;
@@ -1552,6 +1552,13 @@ export declare namespace JSXBase {
         z?: number | string;
         zoomAndPan?: string;
     }
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/ToggleEvent) */
+    interface ToggleEvent extends Event {
+        /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/ToggleEvent/newState) */
+        readonly newState: string;
+        /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/ToggleEvent/oldState) */
+        readonly oldState: string;
+    }
     interface DOMAttributes<T> extends JSXAttributes<T> {
         slot?: string;
         part?: string;
@@ -1568,6 +1575,10 @@ export declare namespace JSXBase {
         onCompositionstartCapture?: (event: CompositionEvent) => void;
         onCompositionupdate?: (event: CompositionEvent) => void;
         onCompositionupdateCapture?: (event: CompositionEvent) => void;
+        onBeforeToggle?: (event: ToggleEvent) => void;
+        onBeforeToggleCapture?: (event: ToggleEvent) => void;
+        onToggle?: (event: ToggleEvent) => void;
+        onToggleCapture?: (event: ToggleEvent) => void;
         onFocus?: (event: FocusEvent) => void;
         onFocusCapture?: (event: FocusEvent) => void;
         onFocusin?: (event: FocusEvent) => void;
@@ -1586,10 +1597,6 @@ export declare namespace JSXBase {
         onSubmitCapture?: (event: Event) => void;
         onInvalid?: (event: Event) => void;
         onInvalidCapture?: (event: Event) => void;
-        onBeforeToggle?: (event: Event) => void;
-        onBeforeToggleCapture?: (event: Event) => void;
-        onToggle?: (event: Event) => void;
-        onToggleCapture?: (event: Event) => void;
         onLoad?: (event: Event) => void;
         onLoadCapture?: (event: Event) => void;
         onError?: (event: Event) => void;

package/dist/types/types/component-types.d.ts

@@ -11,6 +11,7 @@ export interface CameraInfoResponse {
     deviceType: string;
     isMultipleCamerasAvailable: boolean;
     preferredFacing: 'environment' | 'user' | null;
+    error?: string;
 }
 export interface CapturedImagesResponse {
     front: {
@@ -33,4 +34,6 @@ export interface StatusResponse {
     hasImages: boolean;
     isProcessCompleted: boolean;
     isModelPreloaded: boolean;
+    componentStatus?: 'initializing' | 'loading' | 'ready' | 'error';
+    componentMessage?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaak.ai/stamps",
-  "version": "2.0.0",
+  "version": "2.1.0-dev.10",
   "description": "Jaak Document Identifier",
   "main": "dist/index.cjs.js",
   "module": "dist/index.js",
@@ -34,6 +34,7 @@
   "scripts": {
     "build": "stencil build",
     "start": "stencil build --dev --watch --serve",
+    "start:demo": "http-server src -p 8080 -o /demo.html",
     "test": "stencil test --spec --e2e",
     "test.watch": "stencil test --spec --e2e --watchAll",
     "generate": "stencil generate"
@@ -42,6 +43,7 @@
     "@stencil/core": "^4.27.1",
     "@types/jest": "^29.5.14",
     "@types/node": "^22.13.5",
+    "http-server": "^14.1.1",
     "jest": "^29.7.0",
     "jest-cli": "^29.7.0",
     "puppeteer": "^24.3.0"
@@ -51,7 +53,7 @@
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^11.0.3",
+    "@semantic-release/github": "^11.0.4",
     "@semantic-release/npm": "^12.0.2",
     "@semantic-release/release-notes-generator": "^14.0.3",
     "semantic-release": "^24.2.7"