@signosoft/signpad-js 0.4.7 → 0.4.9

package/dist/index.d.ts

@@ -66,6 +66,8 @@ 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.
@@ -83,9 +85,8 @@ declare class CanvasManager {
      */
     updateDrawingOptions(options: IDrawingOptions): void;
     /**
-     * Kept for backward compatibility with callers that may still invoke it.
-     * The actual stroke rendering is done in `src/lib/SignatureCapture.js`.
-     * @param penData - Ignored.
+     * Draws a stroke segment for mouse/touch fallback input.
+     * Physical tablet strokes are rendered by SignatureLayer/SignatureCapture.
      */
     drawSegment(penData: IPenData_2): void;
     /**
@@ -182,6 +183,8 @@ declare class ConnectionManager {
     private penDataToDispatch;
     /** @private Minimum delay between pen events (approx 60fps) */
     private throttleDelayMs;
+    /** @private Pen data accumulated during a mouse-fallback signing session */
+    private mouseFallbackPenLog;
     private static readonly POINTER_FALLBACK_DEVICE_NAME;
     /**
      * @param component - The host SignosoftSignpad instance.
@@ -227,6 +230,7 @@ declare class ConnectionManager {
      * @returns A promise resolving to true if the session started successfully.
      */
     startSigning(canvas: HTMLCanvasElement, drawingOptions?: IDrawingOptions): Promise<boolean>;
+    logMouseFallbackPenData(data: IPenData_2): void;
     /**
      * Stops the current signing session if active.
      * @returns Signature data if available.
@@ -331,6 +335,103 @@ 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;
+}
+
 declare interface IPenData_2 {
     relativeX: number;
     relativeY: number;
@@ -614,7 +715,7 @@ export declare class SignosoftSignpad extends LitElement {
     setHasStartedDrawing(value: boolean): void;
     setDeviceStatusText(value: string): void;
     canvasManager: CanvasManager | null;
-    pointerManager: PointerManager | null;
+    pointerManager: PointerManager | IosTouchManager | null;
     connectionManager: ConnectionManager;
     stateManager: StateManager;
     buttonManager: ButtonManager;