@speechos/client 0.2.0

package/dist/ui/index.d.ts

@@ -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;

package/dist/ui/mic-button.d.cts

@@ -0,0 +1,34 @@
+/**
+ * Microphone button component
+ * A circular button that toggles the action bubbles and handles recording states
+ */
+import { LitElement, type CSSResultGroup, type TemplateResult } from "lit";
+import type { RecordingState, SpeechOSAction } from "@speechos/core";
+export declare class SpeechOSMicButton extends LitElement {
+    static styles: CSSResultGroup;
+    expanded: boolean;
+    recordingState: RecordingState;
+    activeAction: SpeechOSAction | null;
+    editPreviewText: string;
+    errorMessage: string | null;
+    private handleClick;
+    private handleCancel;
+    private stopEvent;
+    private handleClose;
+    private handleRetry;
+    private getButtonClass;
+    private renderIcon;
+    private getAriaLabel;
+    /**
+     * Truncate and format preview text for display
+     */
+    private formatPreviewText;
+    private getStatusLabel;
+    private getStatusClass;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "speechos-mic-button": SpeechOSMicButton;
+    }
+}

package/dist/ui/mic-button.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Microphone button component
+ * A circular button that toggles the action bubbles and handles recording states
+ */
+import { LitElement, type CSSResultGroup, type TemplateResult } from "lit";
+import type { RecordingState, SpeechOSAction } from "@speechos/core";
+export declare class SpeechOSMicButton extends LitElement {
+    static styles: CSSResultGroup;
+    expanded: boolean;
+    recordingState: RecordingState;
+    activeAction: SpeechOSAction | null;
+    editPreviewText: string;
+    errorMessage: string | null;
+    private handleClick;
+    private handleCancel;
+    private stopEvent;
+    private handleClose;
+    private handleRetry;
+    private getButtonClass;
+    private renderIcon;
+    private getAriaLabel;
+    /**
+     * Truncate and format preview text for display
+     */
+    private formatPreviewText;
+    private getStatusLabel;
+    private getStatusClass;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "speechos-mic-button": SpeechOSMicButton;
+    }
+}

package/dist/ui/settings-button.d.cts

@@ -0,0 +1,16 @@
+/**
+ * Settings button component
+ * A small gear icon button that opens the settings modal
+ */
+import { LitElement, type CSSResultGroup } from "lit";
+export declare class SpeechOSSettingsButton extends LitElement {
+    static styles: CSSResultGroup;
+    visible: boolean;
+    private handleClick;
+    render(): import("lit").TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "speechos-settings-button": SpeechOSSettingsButton;
+    }
+}

package/dist/ui/settings-button.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Settings button component
+ * A small gear icon button that opens the settings modal
+ */
+import { LitElement, type CSSResultGroup } from "lit";
+export declare class SpeechOSSettingsButton extends LitElement {
+    static styles: CSSResultGroup;
+    visible: boolean;
+    private handleClick;
+    render(): import("lit").TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "speechos-settings-button": SpeechOSSettingsButton;
+    }
+}

package/dist/ui/settings-modal.d.cts

@@ -0,0 +1,34 @@
+/**
+ * Settings modal component
+ * Displays transcript history, help, about, and settings in a tabbed interface
+ */
+import { LitElement, type CSSResultGroup } from "lit";
+export declare class SpeechOSSettingsModal extends LitElement {
+    static styles: CSSResultGroup;
+    open: boolean;
+    private activeTab;
+    private transcripts;
+    private tabs;
+    connectedCallback(): void;
+    updated(changedProperties: Map<string, unknown>): void;
+    private loadTranscripts;
+    private handleOverlayClick;
+    private handleClose;
+    private close;
+    private handleTabClick;
+    private handleDeleteTranscript;
+    private handleClearAll;
+    private handleCopyTranscript;
+    private formatTime;
+    private renderTranscriptsTab;
+    private renderHelpTab;
+    private renderAboutTab;
+    private renderSettingsTab;
+    private renderTabContent;
+    render(): import("lit").TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "speechos-settings-modal": SpeechOSSettingsModal;
+    }
+}

package/dist/ui/settings-modal.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Settings modal component
+ * Displays transcript history, help, about, and settings in a tabbed interface
+ */
+import { LitElement, type CSSResultGroup } from "lit";
+export declare class SpeechOSSettingsModal extends LitElement {
+    static styles: CSSResultGroup;
+    open: boolean;
+    private activeTab;
+    private transcripts;
+    private tabs;
+    connectedCallback(): void;
+    updated(changedProperties: Map<string, unknown>): void;
+    private loadTranscripts;
+    private handleOverlayClick;
+    private handleClose;
+    private close;
+    private handleTabClick;
+    private handleDeleteTranscript;
+    private handleClearAll;
+    private handleCopyTranscript;
+    private formatTime;
+    private renderTranscriptsTab;
+    private renderHelpTab;
+    private renderAboutTab;
+    private renderSettingsTab;
+    private renderTabContent;
+    render(): import("lit").TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "speechos-settings-modal": SpeechOSSettingsModal;
+    }
+}

package/dist/ui/styles/theme.d.cts

@@ -0,0 +1,17 @@
+/**
+ * Shared styles and CSS variables for SpeechOS UI components
+ */
+import { type CSSResult } from 'lit';
+/**
+ * CSS variables and theme tokens
+ * These can be customized by the host application
+ */
+export declare const themeStyles: CSSResult;
+/**
+ * Common animation keyframes
+ */
+export declare const animations: CSSResult;
+/**
+ * Utility styles for common patterns
+ */
+export declare const utilityStyles: CSSResult;

package/dist/ui/styles/theme.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared styles and CSS variables for SpeechOS UI components
+ */
+import { type CSSResult } from 'lit';
+/**
+ * CSS variables and theme tokens
+ * These can be customized by the host application
+ */
+export declare const themeStyles: CSSResult;
+/**
+ * Common animation keyframes
+ */
+export declare const animations: CSSResult;
+/**
+ * Utility styles for common patterns
+ */
+export declare const utilityStyles: CSSResult;

package/dist/ui/widget.d.cts

@@ -0,0 +1,64 @@
+/**
+ * Main widget container component
+ * Composes mic button and action bubbles with state management
+ */
+import { LitElement, type CSSResultGroup, type TemplateResult } from "lit";
+import "./mic-button.js";
+import "./action-bubbles.js";
+import "./settings-button.js";
+import "./settings-modal.js";
+export declare class SpeechOSWidget extends LitElement {
+    static styles: CSSResultGroup;
+    private widgetState;
+    private settingsOpen;
+    private stateUnsubscribe?;
+    private errorEventUnsubscribe?;
+    private dictationTargetElement;
+    private editTargetElement;
+    private dictationCursorStart;
+    private dictationCursorEnd;
+    private editSelectionStart;
+    private editSelectionEnd;
+    private editSelectedText;
+    private boundClickOutsideHandler;
+    private modalElement;
+    private customPosition;
+    private isDragging;
+    private dragStartPos;
+    private dragOffset;
+    private boundDragMove;
+    private boundDragEnd;
+    private static readonly DRAG_THRESHOLD;
+    private suppressNextClick;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changedProperties: Map<string, unknown>): void;
+    private handleClickOutside;
+    private isFormField;
+    private updatePosition;
+    private handleMicClick;
+    private handleStopRecording;
+    private handleCancelOperation;
+    private handleRetryConnection;
+    private handleCloseWidget;
+    private handleSettingsClick;
+    private handleDragStart;
+    private handleDragMove;
+    private handleDragEnd;
+    private applyCustomPosition;
+    private insertTranscription;
+    private handleActionSelect;
+    private withMinDisplayTime;
+    private startDictation;
+    private startEdit;
+    private handleStopEdit;
+    private supportsSelection;
+    private getElementContent;
+    private applyEdit;
+    render(): TemplateResult | string;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "speechos-widget": SpeechOSWidget;
+    }
+}

package/dist/ui/widget.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Main widget container component
+ * Composes mic button and action bubbles with state management
+ */
+import { LitElement, type CSSResultGroup, type TemplateResult } from "lit";
+import "./mic-button.js";
+import "./action-bubbles.js";
+import "./settings-button.js";
+import "./settings-modal.js";
+export declare class SpeechOSWidget extends LitElement {
+    static styles: CSSResultGroup;
+    private widgetState;
+    private settingsOpen;
+    private stateUnsubscribe?;
+    private errorEventUnsubscribe?;
+    private dictationTargetElement;
+    private editTargetElement;
+    private dictationCursorStart;
+    private dictationCursorEnd;
+    private editSelectionStart;
+    private editSelectionEnd;
+    private editSelectedText;
+    private boundClickOutsideHandler;
+    private modalElement;
+    private customPosition;
+    private isDragging;
+    private dragStartPos;
+    private dragOffset;
+    private boundDragMove;
+    private boundDragEnd;
+    private static readonly DRAG_THRESHOLD;
+    private suppressNextClick;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changedProperties: Map<string, unknown>): void;
+    private handleClickOutside;
+    private isFormField;
+    private updatePosition;
+    private handleMicClick;
+    private handleStopRecording;
+    private handleCancelOperation;
+    private handleRetryConnection;
+    private handleCloseWidget;
+    private handleSettingsClick;
+    private handleDragStart;
+    private handleDragMove;
+    private handleDragEnd;
+    private applyCustomPosition;
+    private insertTranscription;
+    private handleActionSelect;
+    private withMinDisplayTime;
+    private startDictation;
+    private startEdit;
+    private handleStopEdit;
+    private supportsSelection;
+    private getElementContent;
+    private applyEdit;
+    render(): TemplateResult | string;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "speechos-widget": SpeechOSWidget;
+    }
+}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@speechos/client",
+  "version": "0.2.0",
+  "description": "Vanilla JS client SDK for embedding SpeechOS into web applications",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/speechos-org/speechos.git",
+    "directory": "speechos-client/packages/client"
+  },
+  "homepage": "https://speechos.ai",
+  "bugs": {
+    "url": "https://github.com/speechos-org/speechos/issues"
+  },
+  "scripts": {
+    "build": "npm run build:ts && npm run build:iife",
+    "build:ts": "tsdown",
+    "build:iife": "rollup -c rollup.config.js",
+    "dev": "tsdown --watch",
+    "dev:iife": "rollup -c rollup.config.js --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "speechos",
+    "sdk",
+    "client",
+    "embed",
+    "voice",
+    "ai"
+  ],
+  "author": "SpeechOS",
+  "license": "MIT",
+  "devDependencies": {
+    "@rollup/plugin-alias": "^6.0.0",
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "happy-dom": "^20.1.0",
+    "rollup": "^4.30.1",
+    "tsdown": "^0.2.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.16"
+  },
+  "dependencies": {
+    "@speechos/core": "*",
+    "lit": "^3.3.2",
+    "lucide": "^0.562.0"
+  }
+}