@signosoft/signpad-js 0.5.2 → 0.5.3

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { ConnectionMode } from '@signosoft/tablet-driver';
 import { CSSResult } from 'lit';
 import { LitElement } from 'lit';
 import { TemplateResult } from 'lit-html';
@@ -176,11 +177,12 @@ declare class ConnectionManager {
     /**
      * Initiates the connection process to a physical device or a mouse fallback.
      *
-     * @param autoConnect - If true, attempts to connect without showing a device selection dialog.
+     * @param autoConnect - Connect mode: "manual" opens the browser device selection
+     *   dialog; "auto"/"hotplug" attempt already-authorized devices silently.
      * @param allowFallback - If true, enables mouse/pointer input if no physical device is found.
      * @returns A promise resolving to true if connection (or fallback) was successful.
      */
-    connect(autoConnect?: boolean, allowFallback?: boolean): Promise<boolean>;
+    connect(autoConnect?: ConnectionMode, allowFallback?: boolean): Promise<boolean>;
     /**
      * Terminates the connection with the device and cleans up the driver instance.
      * @returns Resolves when disconnection completes.
@@ -520,7 +522,8 @@ export declare class SignosoftSignpad extends LitElement {
     dispatch(name: string, detail?: any): void;
     /**
      * Attempts to establish a connection with a signature tablet.
-     * @param autoConnect - If true, tries to connect without showing a device picker.
+     * @param autoConnect - Connect mode: "manual" opens the browser HID picker;
+     *   "auto"/"hotplug" silently try already-authorized devices (see `ConnectionMode`).
      * @param allowFallback - If true, enables mouse/touch signing if no device is found.
      * @returns A promise resolving to true if connection (or fallback) succeeded.
      */
@@ -560,8 +563,24 @@ export declare class SignosoftSignpad extends LitElement {
      * - if physical is not available, allow fallback as a secondary attempt
      */
     connect: () => Promise<void>;
+    /**
+     * If currently in mouse fallback, tears that session down seamlessly
+     * (no DISCONNECTED UI flash) so a physical-device connect attempt can
+     * proceed cleanly.
+     */
     private prepareForManualConnect;
+    /**
+     * First step of the manual `connect()` flow: silently retries an
+     * already-authorized device (no HID picker) using "auto" mode.
+     * `allowFallback=false` ensures we only treat a real physical reconnect as success.
+     */
     private tryAuthorizedManualConnect;
+    /**
+     * Second step of the manual `connect()` flow, run only when the silent
+     * attempt above fails: opens the browser HID picker ("manual" mode) so
+     * the user can grant access to a new device. If the user cancels or no
+     * device is selected, falls back to one more silent "auto" attempt.
+     */
     private tryInteractiveManualConnectFallback;
     /**
      * UI disconnect action: delegates to the public disconnect method.