@signosoft/signpad-js 0.4.7 → 0.4.8

package/dist/index.d.ts

@@ -331,6 +331,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 +711,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;