@signosoft/signpad-js 0.5.0 → 0.5.1

package/README.md

@@ -679,7 +679,6 @@ The complete list of keys that can be translated is maintained in `src/i18n/en.j
 | `CONNECTION_ERROR`           | Connection error.                                   |
 | `ERROR_DISCONNECTION`        | Error during disconnection.                         |
 | `ERROR_INSTANTIATING_DRIVER` | Error instantiating driver.                         |
-| `SIGNPAD_DISCONNECTED`       | Signpad disconnected.                               |
 | `INVALID_LICENSE_KEY`        | Invalid license key.                                |
 | `READY_TO_CONNECT`           | Ready to connect.                                   |
 | `SIGNPAD_DETECTED`           | Signpad detected. Click 'Connect Signpad' to begin. |

package/dist/index.d.ts

@@ -66,8 +66,6 @@ declare class CanvasManager {
     private ctx;
     /** @private The active configuration for line styles */
     private currentDrawingOptions;
-    /** @private Last drawn point for mouse-fallback stroke continuity */
-    private lastDrawPoint;
     /**
      * Creates an instance of CanvasManager.
      * @param canvas - The HTMLCanvasElement to draw on.
@@ -84,11 +82,6 @@ declare class CanvasManager {
      * @param options - The new drawing configuration.
      */
     updateDrawingOptions(options: IDrawingOptions): void;
-    /**
-     * Draws a stroke segment for mouse/touch fallback input.
-     * Physical tablet strokes are rendered by SignatureLayer.
-     */
-    drawSegment(penData: IPenData): void;
     /**
      * Wipes the canvas clean and resets the drawing state.
      */
@@ -157,12 +150,6 @@ declare class ConfigManager {
     private clearConfigEventHandlers;
 }
 
-export declare interface ConnectAttempt {
-    connected: boolean;
-    deviceInfo: any | null;
-    isPointerFallback: boolean;
-}
-
 /**
  * `ConnectionManager` handles the lifecycle of the signature pad connection.
  * It manages driver initialization, license authentication, device handshaking,
@@ -173,8 +160,6 @@ declare class ConnectionManager {
     private component;
     /** @private The low-level driver instance */
     private sigLayer;
-    /** @private Debug counter for callback registrations */
-    private debugCallbackRegistrationCount;
     /** @private Cached device info from the last successful connect */
     private cachedDeviceInfo;
     /** @private Timestamp of the last pen event dispatch */
@@ -183,7 +168,6 @@ declare class ConnectionManager {
     private penDataToDispatch;
     /** @private Minimum delay between pen events (approx 60fps) */
     private throttleDelayMs;
-    private penDataLog;
     /** @private Wall-clock time when the current signing session started, for timestampInSeconds */
     private sessionStartTime;
     private static readonly POINTER_FALLBACK_DEVICE_NAME;
@@ -219,11 +203,6 @@ declare class ConnectionManager {
      * @returns True if a device is connected.
      */
     isDeviceConnected(): boolean;
-    /**
-     * Returns true if the SignatureLayer is in signing mode.
-     * @returns True if a signing session is active.
-     */
-    isSigningActive(): boolean;
     /**
      * Starts a signing session on the provided canvas.
      * @param canvasElement - Optional canvas reference.
@@ -231,13 +210,11 @@ declare class ConnectionManager {
      * @returns A promise resolving to true if the session started successfully.
      */
     startSigning(canvas: HTMLCanvasElement, drawingOptions?: IDrawingOptions): Promise<boolean>;
-    logPenData(data: IPenData): void;
     /**
      * Calculates the seconds elapsed since the start of the signing session.
      * @private
      */
     private timestampToSeconds;
-    private buildConfirmationData;
     /**
      * Stops the current signing session if active.
      * @returns Signature data if available.
@@ -287,15 +264,6 @@ declare class ConnectionManager {
      * This step only decides state; it does not trigger HID dialog itself.
      */
     private resolveConnectionTarget;
-    /**
-     * Starts a fresh signing session for whichever target mode was selected.
-     */
-    private prepareSigningSession;
-}
-
-export declare interface ConnectionTarget {
-    targetState: SignpadState;
-    statusMessageKey: string;
 }
 
 export declare enum DeviceStatusText {
@@ -315,14 +283,6 @@ export declare interface IDrawingOptions {
     color?: string;
 }
 
-export declare interface IDriverInfo {
-    name: string;
-    ready: boolean;
-    aspectRatio: number;
-    isCanvasStyleTablet: boolean;
-    supportedCommands: string[];
-}
-
 export declare interface IEventCallbacks {
     onConnect?: (event: CustomEvent<{
         deviceInfo: any;
@@ -342,119 +302,24 @@ export declare interface ILanguageOptions {
     translations?: ITranslationSet | Record<string, ITranslationSet>;
 }
 
-/**
- * `IosTouchManager` handles touch interactions on iOS devices and converts them
- * into standardized `IPenData`. Uses the Touch Events API and reads `Touch.force`
- * for real pressure data on devices that support 3D Touch / Haptic Touch.
- * Falls back to 0.5 pressure on hardware without force sensing.
- */
-declare class IosTouchManager {
-    /** @private */
-    private canvas;
-    /** @private */
-    private onPenData;
-    /** @private */
-    private isDrawing;
-    /** @private */
-    private sequenceCounter;
-    /** @private */
-    private sessionStartTime;
-    /** @private Debug counter for listener registrations */
-    private debugListenerRegistrationCount;
-    /** @private */
-    private listenersAttached;
-    private boundHandleTouchStart;
-    private boundHandleTouchMove;
-    private boundHandleTouchEnd;
-    private boundHandleTouchCancel;
-    /**
-     * Creates an instance of IosTouchManager.
-     * @param canvas - The HTMLCanvasElement to attach touch listeners to.
-     * @param onPenDataCallback - The callback function that receives generated IPenData.
-     */
-    constructor(canvas: HTMLCanvasElement, onPenDataCallback: IPenDataCallback);
-    /**
-     * Returns whether the user is currently in the middle of a drawing stroke.
-     */
-    get isCurrentlyDrawing(): boolean;
-    /**
-     * Attaches touch event listeners to the canvas to enable signature capture.
-     */
-    addListeners(): void;
-    /**
-     * Removes touch event listeners from the canvas and stops active drawing.
-     */
-    removeListeners(): void;
-    /**
-     * Returns true if touch listeners are currently attached.
-     */
-    areListenersAttached(): boolean;
-    /**
-     * Resets the internal session state, including sequence counters and start time.
-     */
-    resetSession(): void;
-    /**
-     * Handles the 'touchstart' event: starts a stroke and initializes the session time.
-     * @private
-     */
-    private handleTouchStart;
-    /**
-     * Handles the 'touchmove' event: continues the stroke.
-     * @private
-     */
-    private handleTouchMove;
-    /**
-     * Handles the 'touchend' event: ends the stroke.
-     * @private
-     */
-    private handleTouchEnd;
-    /**
-     * Handles the 'touchcancel' event: terminates a stroke interrupted by the OS.
-     * @private
-     */
-    private handleTouchCancel;
-    /**
-     * Core logic to transform a Touch into IPenData.
-     * @param touch - The raw browser Touch object.
-     * @param inContact - Whether the finger is actively drawing on the surface.
-     * @private
-     */
-    private processTouchEvent;
-    /**
-     * Returns the pressure value from a Touch event.
-     * Reads Touch.force (0–1) on devices with 3D Touch / Haptic Touch.
-     * Falls back to 0.5 when force is unavailable or zero (non-force hardware).
-     * @private
-     */
-    private getPressure;
-    /**
-     * Converts absolute touch coordinates into a normalized 0-1 range relative to canvas size.
-     * @private
-     */
-    private getNormalizedCoordinates;
-    /**
-     * Calculates the seconds elapsed since the start of the signature session.
-     * @private
-     */
-    private timestampToSeconds;
-}
-
 export declare interface IPenData {
     relativeX: number;
     relativeY: number;
-    absoluteX?: number;
-    absoluteY?: number;
     pressure?: number;
-    ready?: boolean;
-    sequence?: number;
     timestamp?: number;
     timestampInSeconds?: number;
     inContact: boolean;
     [key: string]: any;
 }
 
-export declare interface IPenDataCallback {
-    (penData: IPenData): void;
+export declare interface IPenDataPoint {
+    relativeX: number;
+    relativeY: number;
+    absoluteX?: number;
+    absoluteY?: number;
+    pressure: number;
+    timestamp: number;
+    inContact: boolean;
 }
 
 export declare interface ISignatureCanvasMeta {
@@ -471,7 +336,7 @@ export declare interface ISignatureCanvasMeta {
 }
 
 export declare type ISignatureConfirmationData = [
-points: IPenData[],
+points: IPenDataPoint[],
 imageBase64: string,
 metadata: ISignatureResultMeta
 ];
@@ -590,110 +455,6 @@ declare class LocalizationManager {
     private constructUrl;
 }
 
-/**
- * `PointerManager` handles pointer interactions on a canvas element and converts them
- * into standardized `IPenData`. This serves as a fallback mechanism for
- * signature capture when a physical signature tablet is not available.
- * Uses the Pointer Events API to support mouse, touch, and Apple Pencil uniformly.
- */
-declare class PointerManager {
-    /** @private */
-    private canvas;
-    /** @private */
-    private onPenData;
-    /** @private */
-    private isDrawing;
-    /** @private */
-    private sequenceCounter;
-    /** @private */
-    private sessionStartTime;
-    /** @private Debug counter for listener registrations */
-    private debugListenerRegistrationCount;
-    /** @private */
-    private listenersAttached;
-    private boundHandlePointerDown;
-    private boundHandlePointerMove;
-    private boundHandlePointerUp;
-    private boundHandlePointerLeave;
-    private boundHandlePointerCancel;
-    /**
-     * Creates an instance of PointerManager.
-     * @param canvas - The HTMLCanvasElement to attach pointer listeners to.
-     * @param onPenDataCallback - The callback function that receives generated IPenData.
-     */
-    constructor(canvas: HTMLCanvasElement, onPenDataCallback: IPenDataCallback);
-    /**
-     * Returns whether the user is currently in the middle of a drawing stroke.
-     */
-    get isCurrentlyDrawing(): boolean;
-    /**
-     * Attaches pointer event listeners to the canvas to enable signature capture.
-     */
-    addListeners(): void;
-    /**
-     * Removes pointer event listeners from the canvas and stops active drawing.
-     */
-    removeListeners(): void;
-    /**
-     * Returns true if pointer listeners are currently attached.
-     */
-    areListenersAttached(): boolean;
-    /**
-     * Resets the internal session state, including sequence counters and start time.
-     */
-    resetSession(): void;
-    /**
-     * Handles the 'pointerdown' event: starts a stroke and initializes the session time.
-     * @private
-     */
-    private handlePointerDown;
-    /**
-     * Handles the 'pointermove' event: continues the stroke if pointer is down.
-     * @private
-     */
-    private handlePointerMove;
-    /**
-     * Handles the 'pointerup' event: ends the stroke.
-     * @private
-     */
-    private handlePointerUp;
-    /**
-     * Handles the 'pointerleave' event: ends the stroke if the pointer leaves the canvas area.
-     * @private
-     */
-    private handlePointerLeave;
-    /**
-     * Handles the 'pointercancel' event: terminates a stroke interrupted by the browser
-     * (e.g. iOS scroll taking over, incoming call, screen lock).
-     * @private
-     */
-    private handlePointerCancel;
-    /**
-     * Core logic to transform a PointerEvent into IPenData.
-     * @param event - The raw browser PointerEvent.
-     * @param inContact - Whether the pointer is actively drawing on the surface.
-     * @private
-     */
-    private processPointerEvent;
-    /**
-     * Returns the pressure value for a pointer event.
-     * Pen devices (Apple Pencil, stylus) report real pressure in the 0–1 range.
-     * Mouse and touch devices fall back to 0.5 (in contact) / 0 (not in contact).
-     * @private
-     */
-    private getPressure;
-    /**
-     * Converts absolute pointer coordinates into a normalized 0-1 range relative to canvas size.
-     * @private
-     */
-    private getNormalizedCoordinates;
-    /**
-     * Calculates the seconds elapsed since the start of the signature session.
-     * @private
-     */
-    private timestampToSeconds;
-}
-
 /**
  * SignosoftSignpad Web Component.
  * A professional signature capture component supporting physical tablets and mouse fallback.
@@ -723,7 +484,6 @@ export declare class SignosoftSignpad extends LitElement {
     setHasStartedDrawing(value: boolean): void;
     setDeviceStatusText(value: string): void;
     canvasManager: CanvasManager | null;
-    pointerManager: PointerManager | IosTouchManager | null;
     connectionManager: ConnectionManager;
     stateManager: StateManager;
     buttonManager: ButtonManager;
@@ -846,24 +606,12 @@ export declare class SignosoftSignpad extends LitElement {
      * @returns void
      */
     private initializeCanvasManager;
-    /**
-     * Initializes the PointerManager for pointer/touch fallback.
-     * @private
-     * @returns void
-     */
-    private initializePointerManager;
-    /**
-     * Throttles pen event dispatch to avoid excessive callback pressure.
-     * Drawing is still processed for every sample; only event emission is throttled.
-     */
-    private dispatchPenEventThrottled;
     /**
      * Initializes the driver once a lease is provided via config.
      * Safe to call repeatedly; initialization is performed at most once.
      */
     private initializeFromConfigLeaseIfNeeded;
     private autoConnectIfConfigured;
-    private canAttemptAutoConnect;
     private ensureSignatureLayerReady;
     private deferAutoConnectForState;
     private clearPendingAutoConnectTimeout;
@@ -943,7 +691,6 @@ export declare enum SignpadMessage {
     CONNECTION_ERROR = "CONNECTION_ERROR",
     ERROR_DISCONNECTION = "ERROR_DISCONNECTION",
     ERROR_INSTANTIATING_DRIVER = "ERROR_INSTANTIATING_DRIVER",
-    SIGNPAD_DISCONNECTED = "SIGNPAD_DISCONNECTED",
     INVALID_LICENSE_KEY = "INVALID_LICENSE_KEY",
     READY_TO_CONNECT = "READY_TO_CONNECT",
     SIGNPAD_DETECTED = "SIGNPAD_DETECTED",
@@ -966,15 +713,6 @@ export declare enum SignpadState {
     ERROR = "error"
 }
 
-export declare enum SignpadUI {
-    OK = "OK",
-    CLEAR = "CLEAR",
-    CANCEL = "CANCEL",
-    CLEAR_SIGNATURE = "CLEAR_SIGNATURE",
-    DISCONNECT = "DISCONNECT",
-    CONNECT_SIGNPAD = "CONNECT_SIGNPAD"
-}
-
 /**
  * Manages the finite state machine and UI logic for the Signpad component.
  * It handles state transitions, side effects (like adding/removing listeners),