@signosoft/signpad-js 0.3.3 → 0.3.5

package/README.md

@@ -660,7 +660,6 @@ The complete list of keys that can be translated is maintained in `src/i18n/en.j
 | `CLEAR_SIGNATURE`            | Clear signature                                     |
 | `DISCONNECT`                 | Disconnect                                          |
 | `CONNECT_SIGNPAD`            | Connect Signpad                                     |
-| `NOT_CONNECTED`              | Not Connected                                       |
 | `MOUSE`                      | Mouse                                               |
 | `CONNECTED_UNKNOWN_DEVICE`   | Connected (Unknown Device)                          |
 | `AUTO_CONNECTING`            | Auto-connecting to device...                        |

package/dist/index.d.ts

@@ -161,6 +161,12 @@ 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,
@@ -181,6 +187,7 @@ declare class ConnectionManager {
     private penDataToDispatch;
     /** @private Minimum delay between pen events (approx 60fps) */
     private throttleDelayMs;
+    private static readonly POINTER_FALLBACK_DEVICE_NAME;
     /**
      * @param component - The host SignosoftSignpad instance.
      */
@@ -263,10 +270,29 @@ declare class ConnectionManager {
      * @returns Normalized device info or null.
      */
     private normalizeDeviceInfo;
+    /**
+     * Driver connect step (this is where interactive vs silent HID behavior happens).
+     * `autoConnect = false` may open the browser HID picker.
+     * `autoConnect = true` tries reconnecting already-authorized devices silently.
+     */
+    private runDriverConnectAttempt;
+    /**
+     * Chooses whether the component should finish in physical mode or mouse fallback.
+     * 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 {
-    NOT_CONNECTED = "NOT_CONNECTED",
     MOUSE = "MOUSE",
     CONNECTED_UNKNOWN = "CONNECTED_UNKNOWN_DEVICE"
 }
@@ -278,8 +304,19 @@ export declare interface IActionHandlers {
 }
 
 export declare interface IAutoconnectOptions {
+    /**
+     * Enables silent reconnect attempts to already-authorized devices
+     * during component startup/config updates.
+     */
     autoConnect?: boolean;
+    /**
+     * Triggers auto-connect flow when WebHID reports a plug-in event.
+     * If used without `autoConnect`, connection is attempted only after plug-in.
+     */
     autoConnectOnPlugIn?: boolean;
+    /**
+     * Starts a fresh signing session automatically after OK/Clear/Cancel actions.
+     */
     autoRestartSigningAfterAction?: boolean;
 }
 
@@ -315,7 +352,7 @@ export declare interface ILanguageOptions {
     translations?: ITranslationSet | Record<string, ITranslationSet>;
 }
 
-declare type IPenData_2 = {
+declare interface IPenData_2 {
     relativeX: number;
     relativeY: number;
     absoluteX?: number;
@@ -326,7 +363,7 @@ declare type IPenData_2 = {
     timestamp?: number | bigint;
     inContact: boolean;
     [key: string]: any;
-};
+}
 export { IPenData_2 as IPenData }
 
 export declare interface IPenDataCallback {
@@ -632,9 +669,9 @@ export declare class SignosoftSignpad extends LitElement {
      * @param allowFallback - If true, enables mouse/touch signing if no device is found.
      * @returns A promise resolving to true if connection (or fallback) succeeded.
      */
-    connect(autoConnect?: boolean, allowFallback?: boolean): Promise<boolean>;
+    private connectWith;
     /**
-     * Closes the active tablet connection and cleans up the state.
+     * Closes the active tablet connection and switches to mouse fallback mode.
      * @returns A promise that resolves when disconnection is complete.
      */
     disconnect(): Promise<void>;
@@ -661,16 +698,18 @@ export declare class SignosoftSignpad extends LitElement {
      */
     private handleWindowResize;
     /**
-     * Connect button workflow:
+     * Runs the full connect flow:
      * - if currently in mouse fallback, disconnect it first
-     * - then try physical device connect
+     * - then silently reconnect already-authorized HID devices that are plugged in
+     * - otherwise run the interactive physical-device connect flow
      * - if physical is not available, allow fallback as a secondary attempt
      */
-    private handleConnectClick;
+    connect: () => Promise<void>;
+    private prepareForManualConnect;
+    private tryAuthorizedManualConnect;
+    private tryInteractiveManualConnectFallback;
     /**
-     * UI disconnect action:
-     * when physical device is active, switch seamlessly to mouse fallback.
-     * For other states, perform regular disconnect.
+     * UI disconnect action: delegates to the public disconnect method.
      */
     private handleDisconnectClick;
     /**
@@ -690,22 +729,22 @@ export declare class SignosoftSignpad extends LitElement {
      * @private
      * @returns void
      */
-    private handleHIDConnect;
+    private onHidDeviceConnected;
     /**
      * Handler for HID device disconnection.
      * @private
      * @returns void
      */
-    private handleHIDDisconnect;
-    private shouldPromoteMouseFallback;
+    private onHidDeviceDisconnected;
+    private isMouseFallbackActive;
     private shouldAutoConnectOnPlugIn;
-    private showSignpadDetectedState;
+    private showDeviceDetectedState;
     /**
      * Initializes the CanvasManager for rendering signature strokes.
      * @private
      * @returns void
      */
-    private initializeCanvasManger;
+    private initializeCanvasManager;
     /**
      * Initializes the MouseManager for mouse and touch fallback.
      * @private
@@ -738,6 +777,16 @@ export declare class SignosoftSignpad extends LitElement {
      * Used for smooth mode switching (mouse <-> physical).
      */
     private disconnectForSeamlessSwitch;
+    /**
+     * Forces the component into mouse fallback mode without re-attempting physical reconnection.
+     */
+    private activateMouseFallbackMode;
+    /**
+     * Starts fallback signing without running device connect flow.
+     * This keeps mouse drawing active after manual disconnect, even if a tablet
+     * stays physically plugged in.
+     */
+    private startMouseFallbackSigningSession;
     /**
      * Switches from physical tablet mode to mouse fallback after disconnect.
      */
@@ -746,11 +795,6 @@ export declare class SignosoftSignpad extends LitElement {
      * Promotes active mouse fallback session to a physical tablet when one is plugged in.
      */
     private promoteMouseFallbackToPhysical;
-    /**
-     * Renders the HTML template for the component.
-     * Uses Lit's html template literal.
-     * @returns Rendered template.
-     */
     render(): TemplateResult<1>;
 }