@speechos/client 0.2.0

package/dist/index.js

@@ -0,0 +1,259 @@
+import { DEFAULT_HOST, events, events as events$1, getConfig, getConfig as getConfig$1, livekit, livekit as livekit$1, resetConfig, setConfig, setConfig as setConfig$1, state, state as state$1, transcriptStore, updateUserId } from "@speechos/core";
+
+//#region src/form-detector.ts
+/**
+* Check if an element is a form field that we should track
+*/
+function isFormField(element) {
+	if (!element || !(element instanceof HTMLElement)) return false;
+	const tagName = element.tagName.toLowerCase();
+	if (tagName === "input" || tagName === "textarea") {
+		if (tagName === "input") {
+			const type = element.type.toLowerCase();
+			const excludedTypes = [
+				"checkbox",
+				"radio",
+				"submit",
+				"button",
+				"reset",
+				"file",
+				"hidden"
+			];
+			if (excludedTypes.includes(type)) return false;
+		}
+		return true;
+	}
+	if (element.isContentEditable || element.getAttribute("contenteditable") === "true") return true;
+	return false;
+}
+/**
+* Form detector class that manages focus tracking
+*/
+var FormDetector = class {
+	isActive = false;
+	focusHandler = null;
+	blurHandler = null;
+	/**
+	* Start detecting form field focus events
+	*/
+	start() {
+		if (this.isActive) {
+			console.warn("FormDetector is already active");
+			return;
+		}
+		this.focusHandler = (event) => {
+			const target = event.target;
+			if (isFormField(target)) {
+				state$1.setFocusedElement(target);
+				state$1.show();
+				events$1.emit("form:focus", { element: target });
+			}
+		};
+		this.blurHandler = (event) => {
+			const target = event.target;
+			if (isFormField(target)) {
+				const relatedTarget = event.relatedTarget;
+				const widget = document.querySelector("speechos-widget");
+				const goingToFormField = isFormField(relatedTarget);
+				const goingToWidget = widget && (widget.contains(relatedTarget) || widget.shadowRoot?.contains(relatedTarget) || relatedTarget === widget);
+				if (goingToFormField || goingToWidget) return;
+				setTimeout(() => {
+					const activeElement = document.activeElement;
+					const isWidgetFocused = widget && (widget.contains(activeElement) || widget.shadowRoot?.contains(activeElement));
+					if (!isFormField(activeElement) && !isWidgetFocused) {
+						state$1.setFocusedElement(null);
+						state$1.hide();
+						events$1.emit("form:blur", { element: null });
+					}
+				}, 150);
+			}
+		};
+		document.addEventListener("focusin", this.focusHandler, true);
+		document.addEventListener("focusout", this.blurHandler, true);
+		this.isActive = true;
+	}
+	/**
+	* Stop detecting form field focus events
+	*/
+	stop() {
+		if (!this.isActive) return;
+		if (this.focusHandler) {
+			document.removeEventListener("focusin", this.focusHandler, true);
+			this.focusHandler = null;
+		}
+		if (this.blurHandler) {
+			document.removeEventListener("focusout", this.blurHandler, true);
+			this.blurHandler = null;
+		}
+		state$1.setFocusedElement(null);
+		state$1.hide();
+		this.isActive = false;
+	}
+	/**
+	* Check if the detector is currently active
+	*/
+	get active() {
+		return this.isActive;
+	}
+};
+const formDetector = new FormDetector();
+
+//#endregion
+//#region src/speechos.ts
+/**
+* Main SpeechOS class for initializing and managing the SDK with UI
+*/
+var SpeechOS = class SpeechOS {
+	static instance = null;
+	static widgetElement = null;
+	static isInitialized = false;
+	/**
+	* Initialize the SpeechOS SDK
+	* @param config - Configuration options
+	* @returns Promise that resolves when initialization is complete
+	* @throws Error if configuration is invalid (e.g., missing apiKey)
+	*/
+	static async init(config = {}) {
+		if (this.isInitialized) {
+			console.warn("SpeechOS is already initialized");
+			return;
+		}
+		try {
+			setConfig$1(config);
+		} catch (error) {
+			const errorMessage = error instanceof Error ? error.message : "Invalid configuration";
+			console.error(`[SpeechOS] Error: ${errorMessage} (init_config)`);
+			events$1.emit("error", {
+				code: "init_config",
+				message: errorMessage,
+				source: "init"
+			});
+			throw error;
+		}
+		const finalConfig = getConfig$1();
+		this.instance = new SpeechOS();
+		try {
+			if (finalConfig.debug) console.log("[SpeechOS] Fetching LiveKit token...");
+			await livekit$1.fetchToken();
+			if (finalConfig.debug) console.log("[SpeechOS] LiveKit token fetched successfully");
+		} catch (error) {
+			const errorMessage = error instanceof Error ? error.message : "Failed to fetch token";
+			console.error(`[SpeechOS] Error: ${errorMessage} (init_token_fetch)`);
+			events$1.emit("error", {
+				code: "init_token_fetch",
+				message: errorMessage,
+				source: "init"
+			});
+		}
+		formDetector.start();
+		this.mountWidget();
+		this.isInitialized = true;
+		if (finalConfig.debug) console.log("[SpeechOS] Initialized with config:", finalConfig);
+	}
+	/**
+	* Destroy the SpeechOS SDK and clean up resources
+	*/
+	static async destroy() {
+		if (!this.isInitialized) {
+			console.warn("SpeechOS is not initialized");
+			return;
+		}
+		formDetector.stop();
+		await livekit$1.disconnect();
+		this.unmountWidget();
+		events$1.clear();
+		state$1.reset();
+		this.instance = null;
+		this.isInitialized = false;
+		const config = getConfig$1();
+		if (config.debug) console.log("[SpeechOS] Destroyed and cleaned up");
+	}
+	/**
+	* Check if SpeechOS is initialized
+	*/
+	static get initialized() {
+		return this.isInitialized;
+	}
+	/**
+	* Get the current state
+	*/
+	static getState() {
+		return state$1.getState();
+	}
+	/**
+	* Get the event emitter for external listeners
+	*/
+	static get events() {
+		return events$1;
+	}
+	/**
+	* Mount the widget to the DOM
+	*/
+	static mountWidget() {
+		if (this.widgetElement) {
+			console.warn("Widget is already mounted");
+			return;
+		}
+		const widget = document.createElement("speechos-widget");
+		this.widgetElement = widget;
+		document.body.appendChild(widget);
+	}
+	/**
+	* Unmount the widget from the DOM
+	*/
+	static unmountWidget() {
+		if (this.widgetElement) {
+			this.widgetElement.remove();
+			this.widgetElement = null;
+		}
+	}
+	/**
+	* Show the widget programmatically
+	*/
+	static show() {
+		state$1.show();
+	}
+	/**
+	* Hide the widget programmatically
+	*/
+	static hide() {
+		state$1.hide();
+	}
+	/**
+	* Identify the current user
+	* Can be called after init() to associate sessions with a user identifier.
+	* Clears the cached token so the next voice session uses the new userId.
+	*
+	* @param userId - User identifier from your system (e.g., user ID, email)
+	*
+	* @example
+	* // Initialize SDK early
+	* SpeechOS.init({ apiKey: 'xxx' });
+	*
+	* // Later, after user logs in
+	* SpeechOS.identify('user_123');
+	*/
+	static identify(userId) {
+		if (!this.isInitialized) {
+			console.warn("SpeechOS.identify() called before init(). Call init() first.");
+			return;
+		}
+		const config = getConfig$1();
+		updateUserId(userId);
+		livekit$1.clearToken();
+		if (config.debug) console.log(`[SpeechOS] User identified: ${userId}`);
+	}
+	/**
+	* Private constructor to prevent direct instantiation
+	*/
+	constructor() {}
+};
+
+//#endregion
+//#region src/index.ts
+const VERSION = "0.1.0";
+var src_default = SpeechOS;
+
+//#endregion
+export { DEFAULT_HOST, FormDetector, SpeechOS, VERSION, src_default as default, events, formDetector, getConfig, livekit, resetConfig, setConfig, state, transcriptStore };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["element: Element | null","event: FocusEvent","formDetector: FormDetector","config: SpeechOSConfig","events","userId: string","SpeechOSClass"],"sources":["../src/form-detector.ts","../src/speechos.ts","../src/index.ts"],"sourcesContent":["/**\n * Form field focus detection for SpeechOS Client SDK\n * Detects when users focus on form fields and manages widget visibility\n */\n\nimport { events, state } from \"@speechos/core\";\n\n/**\n * Check if an element is a form field that we should track\n */\nfunction isFormField(element: Element | null): element is HTMLElement {\n  if (!element || !(element instanceof HTMLElement)) {\n    return false;\n  }\n\n  const tagName = element.tagName.toLowerCase();\n\n  // Check for input, textarea\n  if (tagName === \"input\" || tagName === \"textarea\") {\n    // Exclude certain input types that don't accept text\n    if (tagName === \"input\") {\n      const type = (element as HTMLInputElement).type.toLowerCase();\n      const excludedTypes = [\n        \"checkbox\",\n        \"radio\",\n        \"submit\",\n        \"button\",\n        \"reset\",\n        \"file\",\n        \"hidden\",\n      ];\n      if (excludedTypes.includes(type)) {\n        return false;\n      }\n    }\n    return true;\n  }\n\n  // Check for contenteditable\n  if (\n    element.isContentEditable ||\n    element.getAttribute(\"contenteditable\") === \"true\"\n  ) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Form detector class that manages focus tracking\n */\nexport class FormDetector {\n  private isActive = false;\n  private focusHandler: ((event: FocusEvent) => void) | null = null;\n  private blurHandler: ((event: FocusEvent) => void) | null = null;\n\n  /**\n   * Start detecting form field focus events\n   */\n  start(): void {\n    if (this.isActive) {\n      console.warn(\"FormDetector is already active\");\n      return;\n    }\n\n    // Create event handlers\n    this.focusHandler = (event: FocusEvent) => {\n      const target = event.target as Element | null;\n\n      if (isFormField(target)) {\n        state.setFocusedElement(target);\n        state.show();\n        events.emit(\"form:focus\", { element: target });\n      }\n    };\n\n    this.blurHandler = (event: FocusEvent) => {\n      const target = event.target as Element | null;\n\n      if (isFormField(target)) {\n        // Check relatedTarget (where focus is going) immediately\n        const relatedTarget = event.relatedTarget as Element | null;\n        const widget = document.querySelector(\"speechos-widget\");\n\n        // If focus is going to another form field or the widget, don't hide\n        const goingToFormField = isFormField(relatedTarget);\n        const goingToWidget =\n          widget &&\n          (widget.contains(relatedTarget) ||\n            widget.shadowRoot?.contains(relatedTarget) ||\n            relatedTarget === widget);\n\n        if (goingToFormField || goingToWidget) {\n          return;\n        }\n\n        // Delay hiding to allow for any edge cases\n        setTimeout(() => {\n          // Double-check: verify focus is still not on a form field or widget\n          const activeElement = document.activeElement;\n          const isWidgetFocused =\n            widget &&\n            (widget.contains(activeElement) ||\n              widget.shadowRoot?.contains(activeElement));\n\n          // Only hide if no form field is focused AND widget isn't focused\n          if (!isFormField(activeElement) && !isWidgetFocused) {\n            state.setFocusedElement(null);\n            state.hide();\n            events.emit(\"form:blur\", { element: null });\n          }\n        }, 150);\n      }\n    };\n\n    // Attach listeners to document\n    document.addEventListener(\"focusin\", this.focusHandler, true);\n    document.addEventListener(\"focusout\", this.blurHandler, true);\n\n    this.isActive = true;\n  }\n\n  /**\n   * Stop detecting form field focus events\n   */\n  stop(): void {\n    if (!this.isActive) {\n      return;\n    }\n\n    // Remove event listeners\n    if (this.focusHandler) {\n      document.removeEventListener(\"focusin\", this.focusHandler, true);\n      this.focusHandler = null;\n    }\n\n    if (this.blurHandler) {\n      document.removeEventListener(\"focusout\", this.blurHandler, true);\n      this.blurHandler = null;\n    }\n\n    // Reset state\n    state.setFocusedElement(null);\n    state.hide();\n\n    this.isActive = false;\n  }\n\n  /**\n   * Check if the detector is currently active\n   */\n  get active(): boolean {\n    return this.isActive;\n  }\n}\n\n// Export singleton instance\nexport const formDetector: FormDetector = new FormDetector();\n","/**\n * Main SpeechOS Client SDK class\n * Composes core logic with UI components\n */\n\nimport type { SpeechOSConfig, SpeechOSState, SpeechOSEventMap } from \"@speechos/core\";\nimport {\n  setConfig,\n  getConfig,\n  updateUserId,\n  state,\n  events,\n  livekit,\n  SpeechOSEventEmitter,\n} from \"@speechos/core\";\nimport { formDetector } from \"./form-detector.js\";\nimport \"./ui/index.js\"; // Auto-registers components\n\n/**\n * Main SpeechOS class for initializing and managing the SDK with UI\n */\nexport class SpeechOS {\n  private static instance: SpeechOS | null = null;\n  private static widgetElement: HTMLElement | null = null;\n  private static isInitialized = false;\n\n  /**\n   * Initialize the SpeechOS SDK\n   * @param config - Configuration options\n   * @returns Promise that resolves when initialization is complete\n   * @throws Error if configuration is invalid (e.g., missing apiKey)\n   */\n  static async init(config: SpeechOSConfig = {}): Promise<void> {\n    if (this.isInitialized) {\n      console.warn(\"SpeechOS is already initialized\");\n      return;\n    }\n\n    try {\n      // Validate and set configuration\n      setConfig(config);\n    } catch (error) {\n      // Configuration errors are fatal - log and re-throw\n      const errorMessage =\n        error instanceof Error ? error.message : \"Invalid configuration\";\n      console.error(`[SpeechOS] Error: ${errorMessage} (init_config)`);\n\n      // Emit error event before throwing\n      events.emit(\"error\", {\n        code: \"init_config\",\n        message: errorMessage,\n        source: \"init\",\n      });\n\n      throw error;\n    }\n\n    const finalConfig = getConfig();\n\n    // Create singleton instance\n    this.instance = new SpeechOS();\n\n    // Fetch LiveKit token\n    try {\n      if (finalConfig.debug) {\n        console.log(\"[SpeechOS] Fetching LiveKit token...\");\n      }\n      await livekit.fetchToken();\n      if (finalConfig.debug) {\n        console.log(\"[SpeechOS] LiveKit token fetched successfully\");\n      }\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : \"Failed to fetch token\";\n      console.error(`[SpeechOS] Error: ${errorMessage} (init_token_fetch)`);\n\n      // Emit error event for consumers\n      events.emit(\"error\", {\n        code: \"init_token_fetch\",\n        message: errorMessage,\n        source: \"init\",\n      });\n\n      // Continue initialization even if token fetch fails\n      // The token will be fetched again when needed\n    }\n\n    // Start form detection\n    formDetector.start();\n\n    // Create and mount widget\n    this.mountWidget();\n\n    this.isInitialized = true;\n\n    // Log initialization in debug mode\n    if (finalConfig.debug) {\n      console.log(\"[SpeechOS] Initialized with config:\", finalConfig);\n    }\n  }\n\n  /**\n   * Destroy the SpeechOS SDK and clean up resources\n   */\n  static async destroy(): Promise<void> {\n    if (!this.isInitialized) {\n      console.warn(\"SpeechOS is not initialized\");\n      return;\n    }\n\n    // Stop form detection\n    formDetector.stop();\n\n    // Disconnect from LiveKit (also clears token)\n    await livekit.disconnect();\n\n    // Remove widget from DOM\n    this.unmountWidget();\n\n    // Clear all event listeners\n    events.clear();\n\n    // Reset state\n    state.reset();\n\n    // Clear instance\n    this.instance = null;\n    this.isInitialized = false;\n\n    const config = getConfig();\n    if (config.debug) {\n      console.log(\"[SpeechOS] Destroyed and cleaned up\");\n    }\n  }\n\n  /**\n   * Check if SpeechOS is initialized\n   */\n  static get initialized(): boolean {\n    return this.isInitialized;\n  }\n\n  /**\n   * Get the current state\n   */\n  static getState(): SpeechOSState {\n    return state.getState();\n  }\n\n  /**\n   * Get the event emitter for external listeners\n   */\n  static get events(): SpeechOSEventEmitter {\n    return events;\n  }\n\n  /**\n   * Mount the widget to the DOM\n   */\n  private static mountWidget(): void {\n    if (this.widgetElement) {\n      console.warn(\"Widget is already mounted\");\n      return;\n    }\n\n    // Create widget element\n    const widget = document.createElement(\"speechos-widget\");\n    this.widgetElement = widget;\n\n    // Append to body\n    document.body.appendChild(widget);\n  }\n\n  /**\n   * Unmount the widget from the DOM\n   */\n  private static unmountWidget(): void {\n    if (this.widgetElement) {\n      this.widgetElement.remove();\n      this.widgetElement = null;\n    }\n  }\n\n  /**\n   * Show the widget programmatically\n   */\n  static show(): void {\n    state.show();\n  }\n\n  /**\n   * Hide the widget programmatically\n   */\n  static hide(): void {\n    state.hide();\n  }\n\n  /**\n   * Identify the current user\n   * Can be called after init() to associate sessions with a user identifier.\n   * Clears the cached token so the next voice session uses the new userId.\n   *\n   * @param userId - User identifier from your system (e.g., user ID, email)\n   *\n   * @example\n   * // Initialize SDK early\n   * SpeechOS.init({ apiKey: 'xxx' });\n   *\n   * // Later, after user logs in\n   * SpeechOS.identify('user_123');\n   */\n  static identify(userId: string): void {\n    if (!this.isInitialized) {\n      console.warn(\n        \"SpeechOS.identify() called before init(). Call init() first.\"\n      );\n      return;\n    }\n\n    const config = getConfig();\n\n    // Update the userId in config\n    updateUserId(userId);\n\n    // Clear cached token so next session gets a fresh one with the new userId\n    livekit.clearToken();\n\n    if (config.debug) {\n      console.log(`[SpeechOS] User identified: ${userId}`);\n    }\n  }\n\n  /**\n   * Private constructor to prevent direct instantiation\n   */\n  private constructor() {\n    // Singleton pattern - use SpeechOS.init() instead\n  }\n}\n\n// Export singleton class as default\nexport default SpeechOS;\n","/**\n * @speechos/client\n *\n * Vanilla JS client SDK for embedding SpeechOS into web applications.\n * Includes Web Components UI and DOM-based form detection.\n */\n\nimport { SpeechOS as SpeechOSClass } from \"./speechos.js\";\n\n// Re-export everything from core\nexport {\n  events,\n  state,\n  getConfig,\n  setConfig,\n  resetConfig,\n  livekit,\n  transcriptStore,\n  DEFAULT_HOST,\n} from \"@speechos/core\";\n\nexport type {\n  SpeechOSConfig,\n  SpeechOSState,\n  SpeechOSAction,\n  SpeechOSEventMap,\n  StateChangeCallback,\n  UnsubscribeFn,\n  RecordingState,\n  TranscriptEntry,\n  TranscriptAction,\n} from \"@speechos/core\";\n\n// Client-specific exports\nexport { formDetector, FormDetector } from \"./form-detector.js\";\n\n// Version\nexport const VERSION = \"0.1.0\";\n\n// Main SDK class\nexport { SpeechOSClass as SpeechOS };\nexport default SpeechOSClass;\n"],"mappings":"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"}

package/dist/speechos.d.cts

@@ -0,0 +1,74 @@
+/**
+ * Main SpeechOS Client SDK class
+ * Composes core logic with UI components
+ */
+import type { SpeechOSConfig, SpeechOSState } from "@speechos/core";
+import { SpeechOSEventEmitter } from "@speechos/core";
+import "./ui/index.js";
+/**
+ * Main SpeechOS class for initializing and managing the SDK with UI
+ */
+export declare class SpeechOS {
+    private static instance;
+    private static widgetElement;
+    private static isInitialized;
+    /**
+     * Initialize the SpeechOS SDK
+     * @param config - Configuration options
+     * @returns Promise that resolves when initialization is complete
+     * @throws Error if configuration is invalid (e.g., missing apiKey)
+     */
+    static init(config?: SpeechOSConfig): Promise<void>;
+    /**
+     * Destroy the SpeechOS SDK and clean up resources
+     */
+    static destroy(): Promise<void>;
+    /**
+     * Check if SpeechOS is initialized
+     */
+    static get initialized(): boolean;
+    /**
+     * Get the current state
+     */
+    static getState(): SpeechOSState;
+    /**
+     * Get the event emitter for external listeners
+     */
+    static get events(): SpeechOSEventEmitter;
+    /**
+     * Mount the widget to the DOM
+     */
+    private static mountWidget;
+    /**
+     * Unmount the widget from the DOM
+     */
+    private static unmountWidget;
+    /**
+     * Show the widget programmatically
+     */
+    static show(): void;
+    /**
+     * Hide the widget programmatically
+     */
+    static hide(): void;
+    /**
+     * Identify the current user
+     * Can be called after init() to associate sessions with a user identifier.
+     * Clears the cached token so the next voice session uses the new userId.
+     *
+     * @param userId - User identifier from your system (e.g., user ID, email)
+     *
+     * @example
+     * // Initialize SDK early
+     * SpeechOS.init({ apiKey: 'xxx' });
+     *
+     * // Later, after user logs in
+     * SpeechOS.identify('user_123');
+     */
+    static identify(userId: string): void;
+    /**
+     * Private constructor to prevent direct instantiation
+     */
+    private constructor();
+}
+export default SpeechOS;

package/dist/speechos.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Main SpeechOS Client SDK class
+ * Composes core logic with UI components
+ */
+import type { SpeechOSConfig, SpeechOSState } from "@speechos/core";
+import { SpeechOSEventEmitter } from "@speechos/core";
+import "./ui/index.js";
+/**
+ * Main SpeechOS class for initializing and managing the SDK with UI
+ */
+export declare class SpeechOS {
+    private static instance;
+    private static widgetElement;
+    private static isInitialized;
+    /**
+     * Initialize the SpeechOS SDK
+     * @param config - Configuration options
+     * @returns Promise that resolves when initialization is complete
+     * @throws Error if configuration is invalid (e.g., missing apiKey)
+     */
+    static init(config?: SpeechOSConfig): Promise<void>;
+    /**
+     * Destroy the SpeechOS SDK and clean up resources
+     */
+    static destroy(): Promise<void>;
+    /**
+     * Check if SpeechOS is initialized
+     */
+    static get initialized(): boolean;
+    /**
+     * Get the current state
+     */
+    static getState(): SpeechOSState;
+    /**
+     * Get the event emitter for external listeners
+     */
+    static get events(): SpeechOSEventEmitter;
+    /**
+     * Mount the widget to the DOM
+     */
+    private static mountWidget;
+    /**
+     * Unmount the widget from the DOM
+     */
+    private static unmountWidget;
+    /**
+     * Show the widget programmatically
+     */
+    static show(): void;
+    /**
+     * Hide the widget programmatically
+     */
+    static hide(): void;
+    /**
+     * Identify the current user
+     * Can be called after init() to associate sessions with a user identifier.
+     * Clears the cached token so the next voice session uses the new userId.
+     *
+     * @param userId - User identifier from your system (e.g., user ID, email)
+     *
+     * @example
+     * // Initialize SDK early
+     * SpeechOS.init({ apiKey: 'xxx' });
+     *
+     * // Later, after user logs in
+     * SpeechOS.identify('user_123');
+     */
+    static identify(userId: string): void;
+    /**
+     * Private constructor to prevent direct instantiation
+     */
+    private constructor();
+}
+export default SpeechOS;

package/dist/ui/action-bubbles.d.cts

@@ -0,0 +1,17 @@
+/**
+ * Action bubbles component
+ * Displays available actions (Dictate, Edit) above the mic button
+ */
+import { LitElement, type CSSResultGroup } from "lit";
+export declare class SpeechOSActionBubbles extends LitElement {
+    static styles: CSSResultGroup;
+    visible: boolean;
+    private actions;
+    private handleActionClick;
+    render(): import("lit").TemplateResult | string;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "speechos-action-bubbles": SpeechOSActionBubbles;
+    }
+}

package/dist/ui/action-bubbles.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Action bubbles component
+ * Displays available actions (Dictate, Edit) above the mic button
+ */
+import { LitElement, type CSSResultGroup } from "lit";
+export declare class SpeechOSActionBubbles extends LitElement {
+    static styles: CSSResultGroup;
+    visible: boolean;
+    private actions;
+    private handleActionClick;
+    render(): import("lit").TemplateResult | string;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "speechos-action-bubbles": SpeechOSActionBubbles;
+    }
+}

package/dist/ui/icons.d.cts

@@ -0,0 +1,88 @@
+/**
+ * Icon imports and templates using inline SVG
+ */
+import { type TemplateResult } from "lit";
+/**
+ * Microphone icon for the main button
+ * Lucide Mic icon paths
+ */
+export declare const micIcon: (size?: number) => TemplateResult;
+/**
+ * Message square icon for dictate action
+ * Lucide MessageSquare icon paths
+ */
+export declare const dictateIcon: (size?: number) => TemplateResult;
+/**
+ * Pencil icon for edit action
+ * Lucide Pencil icon paths
+ */
+export declare const editIcon: (size?: number) => TemplateResult;
+/**
+ * Stop/Square icon for stopping recording
+ * Lucide Square icon (filled)
+ */
+export declare const stopIcon: (size?: number) => TemplateResult;
+/**
+ * Loader/spinner icon for connecting state
+ */
+export declare const loaderIcon: (size?: number) => TemplateResult;
+/**
+ * Check icon for "Keep" action
+ * Lucide Check icon paths
+ */
+export declare const checkIcon: (size?: number) => TemplateResult;
+/**
+ * Undo icon for "Undo" action
+ * Lucide Undo2 icon paths
+ */
+export declare const undoIcon: (size?: number) => TemplateResult;
+/**
+ * Refresh icon for "Continue editing" action
+ * Lucide RefreshCw icon paths
+ */
+export declare const refreshIcon: (size?: number) => TemplateResult;
+/**
+ * X icon for cancel action
+ * Lucide X icon paths
+ */
+export declare const xIcon: (size?: number) => TemplateResult;
+/**
+ * More vertical (three dots) icon for settings button
+ * Lucide MoreVertical icon paths
+ */
+export declare const moreVerticalIcon: (size?: number) => TemplateResult;
+/**
+ * Clipboard/list icon for transcripts tab
+ * Lucide ClipboardList icon paths
+ */
+export declare const clipboardIcon: (size?: number) => TemplateResult;
+/**
+ * Help circle icon for help tab
+ * Lucide HelpCircle icon paths
+ */
+export declare const helpCircleIcon: (size?: number) => TemplateResult;
+/**
+ * Info icon for about tab
+ * Lucide Info icon paths
+ */
+export declare const infoIcon: (size?: number) => TemplateResult;
+/**
+ * Settings/cog icon for settings tab
+ * Lucide Settings icon paths
+ */
+export declare const settingsIcon: (size?: number) => TemplateResult;
+/**
+ * Trash icon for delete action
+ * Lucide Trash2 icon paths
+ */
+export declare const trashIcon: (size?: number) => TemplateResult;
+/**
+ * External link icon
+ * Lucide ExternalLink icon paths
+ */
+export declare const externalLinkIcon: (size?: number) => TemplateResult;
+/**
+ * Copy icon
+ * Lucide Copy icon paths
+ */
+export declare const copyIcon: (size?: number) => TemplateResult;

package/dist/ui/icons.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Icon imports and templates using inline SVG
+ */
+import { type TemplateResult } from "lit";
+/**
+ * Microphone icon for the main button
+ * Lucide Mic icon paths
+ */
+export declare const micIcon: (size?: number) => TemplateResult;
+/**
+ * Message square icon for dictate action
+ * Lucide MessageSquare icon paths
+ */
+export declare const dictateIcon: (size?: number) => TemplateResult;
+/**
+ * Pencil icon for edit action
+ * Lucide Pencil icon paths
+ */
+export declare const editIcon: (size?: number) => TemplateResult;
+/**
+ * Stop/Square icon for stopping recording
+ * Lucide Square icon (filled)
+ */
+export declare const stopIcon: (size?: number) => TemplateResult;
+/**
+ * Loader/spinner icon for connecting state
+ */
+export declare const loaderIcon: (size?: number) => TemplateResult;
+/**
+ * Check icon for "Keep" action
+ * Lucide Check icon paths
+ */
+export declare const checkIcon: (size?: number) => TemplateResult;
+/**
+ * Undo icon for "Undo" action
+ * Lucide Undo2 icon paths
+ */
+export declare const undoIcon: (size?: number) => TemplateResult;
+/**
+ * Refresh icon for "Continue editing" action
+ * Lucide RefreshCw icon paths
+ */
+export declare const refreshIcon: (size?: number) => TemplateResult;
+/**
+ * X icon for cancel action
+ * Lucide X icon paths
+ */
+export declare const xIcon: (size?: number) => TemplateResult;
+/**
+ * More vertical (three dots) icon for settings button
+ * Lucide MoreVertical icon paths
+ */
+export declare const moreVerticalIcon: (size?: number) => TemplateResult;
+/**
+ * Clipboard/list icon for transcripts tab
+ * Lucide ClipboardList icon paths
+ */
+export declare const clipboardIcon: (size?: number) => TemplateResult;
+/**
+ * Help circle icon for help tab
+ * Lucide HelpCircle icon paths
+ */
+export declare const helpCircleIcon: (size?: number) => TemplateResult;
+/**
+ * Info icon for about tab
+ * Lucide Info icon paths
+ */
+export declare const infoIcon: (size?: number) => TemplateResult;
+/**
+ * Settings/cog icon for settings tab
+ * Lucide Settings icon paths
+ */
+export declare const settingsIcon: (size?: number) => TemplateResult;
+/**
+ * Trash icon for delete action
+ * Lucide Trash2 icon paths
+ */
+export declare const trashIcon: (size?: number) => TemplateResult;
+/**
+ * External link icon
+ * Lucide ExternalLink icon paths
+ */
+export declare const externalLinkIcon: (size?: number) => TemplateResult;
+/**
+ * Copy icon
+ * Lucide Copy icon paths
+ */
+export declare const copyIcon: (size?: number) => TemplateResult;

package/dist/ui/index.d.cts

@@ -0,0 +1,20 @@
+/**
+ * UI module exports
+ * Lit-based Shadow DOM components
+ */
+import "./widget.js";
+import "./mic-button.js";
+import "./action-bubbles.js";
+import "./settings-button.js";
+import "./settings-modal.js";
+export { SpeechOSWidget } from "./widget.js";
+export { SpeechOSMicButton } from "./mic-button.js";
+export { SpeechOSActionBubbles } from "./action-bubbles.js";
+export { SpeechOSSettingsButton } from "./settings-button.js";
+export { SpeechOSSettingsModal } from "./settings-modal.js";
+/**
+ * Register all custom elements
+ * This is automatically called when importing this module,
+ * but can be called explicitly if needed
+ */
+export declare function registerComponents(): void;