@speechos/client 0.2.0 → 0.2.3

package/dist/config.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Client configuration for SpeechOS
+ * Extends core config with UI/widget-specific options
+ */
+import type { SpeechOSCoreConfig, CommandDefinition } from "@speechos/core";
+import type { FormDetectorInterface } from "./form-detector.js";
+import type { TextInputHandlerInterface } from "./text-input-handler.js";
+/**
+ * Configuration options for SpeechOS Client
+ * Extends core config with widget-specific options
+ */
+export interface SpeechOSClientConfig extends SpeechOSCoreConfig {
+    /** Command definitions for voice command matching. If provided, shows Command button in widget. */
+    commands?: CommandDefinition[];
+    /** Custom z-index for widget overlay (default: 999999) */
+    zIndex?: number;
+    /**
+     * Form detection behavior:
+     * - true (default): Enable automatic form field detection
+     * - false: Disable automatic detection (manual control only)
+     * - FormDetectorInterface: Custom implementation
+     */
+    formDetection?: boolean | FormDetectorInterface;
+    /**
+     * Custom text input handler for cursor/selection detection and text operations.
+     * Default: handles input, textarea, and contenteditable elements.
+     */
+    textInputHandler?: TextInputHandlerInterface;
+}
+/**
+ * Resolved client config with defaults applied
+ */
+export interface ResolvedClientConfig {
+    commands: CommandDefinition[];
+    zIndex: number;
+}
+/**
+ * Validate and resolve client-specific config
+ * @param config - User-provided configuration
+ * @returns Resolved client configuration
+ */
+export declare function validateClientConfig(config: SpeechOSClientConfig): ResolvedClientConfig;
+/**
+ * Set the client configuration
+ * @param config - Client configuration to set
+ */
+export declare function setClientConfig(config: SpeechOSClientConfig): void;
+/**
+ * Get the current client configuration
+ */
+export declare function getClientConfig(): ResolvedClientConfig;
+/**
+ * Reset client configuration to defaults
+ */
+export declare function resetClientConfig(): void;
+/**
+ * Check if commands are configured (for showing Command button in widget)
+ */
+export declare function hasCommands(): boolean;
+/**
+ * Get configured commands
+ */
+export declare function getCommands(): CommandDefinition[];
+/**
+ * Get widget z-index
+ */
+export declare function getZIndex(): number;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,mGAAmG;IACnG,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAC;IAChD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAeD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAevF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAElE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,oBAAoB,CAEtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,iBAAiB,EAAE,CAEjD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/dist/form-detector.d.ts

@@ -2,13 +2,28 @@
  * Form field focus detection for SpeechOS Client SDK
  * Detects when users focus on form fields and manages widget visibility
  */
+/**
+ * Interface for form detector implementations
+ * Allows swapping out the default form detection behavior
+ */
+export interface FormDetectorInterface {
+    /** Start detecting form field focus events */
+    start(): void;
+    /** Stop detecting form field focus events */
+    stop(): void;
+    /** Whether the detector is currently active */
+    readonly active: boolean;
+}
 /**
  * Form detector class that manages focus tracking
  */
-export declare class FormDetector {
+export declare class FormDetector implements FormDetectorInterface {
     private isActive;
     private focusHandler;
     private blurHandler;
+    private touchHandler;
+    private mouseDownHandler;
+    private isWidgetBeingInteracted;
     /**
      * Start detecting form field focus events
      */
@@ -23,3 +38,4 @@ export declare class FormDetector {
     get active(): boolean;
 }
 export declare const formDetector: FormDetector;
+//# sourceMappingURL=form-detector.d.ts.map

package/dist/form-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-detector.d.ts","sourceRoot":"","sources":["../src/form-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8CH;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,KAAK,IAAI,IAAI,CAAC;IACd,6CAA6C;IAC7C,IAAI,IAAI,IAAI,CAAC;IACb,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,YAAa,YAAW,qBAAqB;IACxD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,uBAAuB,CAAS;IAExC;;OAEG;IACH,KAAK,IAAI,IAAI;IA4Ib;;OAEG;IACH,IAAI,IAAI,IAAI;IAkCZ;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;CACF;AAGD,eAAO,MAAM,YAAY,EAAE,YAAiC,CAAC"}

package/dist/form-detector.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for form field focus detection
+ */
+export {};
+//# sourceMappingURL=form-detector.test.d.ts.map

package/dist/form-detector.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-detector.test.d.ts","sourceRoot":"","sources":["../src/form-detector.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}