@alxxsck/ai-assistant 3.2.0 → 3.3.0

package/dist/ui/components/ChatWidgetFrame.d.ts

@@ -1,8 +1,11 @@
 import type { PropsWithChildren } from "react";
 import { type ChatSurfacePresentation } from "./ChatSurfaceFrameContext";
 import type { SurfaceFocusDisposition } from "@/domain/scenario-interaction/scenario-interaction.types";
+import type { AssistantOpenSurfaceMode, AssistantSurfaceMode } from "@/domain/ui/assistant-surface";
 type ChatWidgetFrameProps = PropsWithChildren<{
     open: boolean;
+    surfaceMode?: AssistantSurfaceMode;
+    lastOpenSurfaceMode?: AssistantOpenSurfaceMode;
     onOpenChange: (open: boolean) => void;
     presentation: ChatSurfacePresentation;
     hideOpenButton: boolean;
@@ -11,6 +14,7 @@ type ChatWidgetFrameProps = PropsWithChildren<{
     unreadIndicator?: React.ReactNode;
     launcherDescriptionId?: string;
     compactPreview?: React.ReactNode;
+    compactAssistant?: React.ReactNode;
     compactPreviewAnnouncement?: string;
     compactPreviewCollapsible?: boolean;
     compactPreviewSuspended?: boolean;
@@ -19,5 +23,5 @@ type ChatWidgetFrameProps = PropsWithChildren<{
     onLauncherDragSuspended?: (suspended: boolean) => void;
     onCompactPreviewCollapse?: () => void;
 }>;
-export declare function ChatWidgetFrame({ open, onOpenChange, presentation, hideOpenButton, loadingProgress, launcherImageSrc, unreadIndicator, launcherDescriptionId, compactPreview, compactPreviewAnnouncement, compactPreviewCollapsible, compactPreviewSuspended, closeFocusDisposition, storageScope, onLauncherDragSuspended, onCompactPreviewCollapse, children, }: ChatWidgetFrameProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatWidgetFrame({ open, surfaceMode, lastOpenSurfaceMode, onOpenChange, presentation, hideOpenButton, loadingProgress, launcherImageSrc, unreadIndicator, launcherDescriptionId, compactPreview, compactAssistant, compactPreviewAnnouncement, compactPreviewCollapsible, compactPreviewSuspended, closeFocusDisposition, storageScope, onLauncherDragSuspended, onCompactPreviewCollapse, children, }: ChatWidgetFrameProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/ui/components/CompactAssistantSurface.d.ts

@@ -0,0 +1,6 @@
+type CompactAssistantSurfaceProps = {
+    unreadIndicator?: React.ReactNode;
+    unreadDescriptionId?: string;
+};
+export declare function CompactAssistantSurface({ unreadIndicator, unreadDescriptionId, }: CompactAssistantSurfaceProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/ui/components/CompactScenarioPreview.d.ts

@@ -7,6 +7,7 @@ export type CompactScenarioPreviewLabels = {
 export type CompactScenarioPreviewProps = {
     candidate: CompactPreviewCandidate;
     phase: CompactPreviewPhase;
+    onOpenChat: () => void | Promise<void>;
     onDismiss: () => void;
     onChoice: (optionId: string) => void | Promise<void>;
     onCta: () => void | Promise<void>;

package/dist/ui/components/VoiceMicOrb.d.ts

@@ -0,0 +1,18 @@
+import { type VoiceInputAuraFrame, type VoiceInputAuraMeter } from "@/ui/hooks/useVoiceInputAura";
+import { type VoiceComposerPhase } from "./voice-waveform";
+export type VoiceMicOrbHandle = {
+    requestFrame: () => void;
+};
+export type VoiceMicOrbProps = {
+    phase?: VoiceComposerPhase;
+    microphoneEnabled?: boolean;
+    auraActive?: boolean;
+    microphoneLabel: string;
+    disabled?: boolean;
+    frozen?: boolean;
+    className?: string;
+    onToggleMicrophone: () => void;
+    meter?: VoiceInputAuraMeter;
+    onInputFrame?: (frame: VoiceInputAuraFrame) => boolean | void;
+};
+export declare const VoiceMicOrb: import("react").ForwardRefExoticComponent<VoiceMicOrbProps & import("react").RefAttributes<VoiceMicOrbHandle>>;

package/dist/ui/hooks/useVoiceInputAura.d.ts

@@ -0,0 +1,22 @@
+import { type VoiceAudioMeter } from "@/domain/voice/voice-audio-meter";
+import { type RefObject } from "react";
+export type VoiceInputAuraFrame = Readonly<{
+    frameTime: number;
+    elapsedMs: number;
+    inputLevel: number;
+    smoothedInputLevel: number;
+    reducedMotion: boolean;
+}>;
+export type VoiceInputAuraMeter = Pick<VoiceAudioMeter, "read" | "subscribe">;
+export type UseVoiceInputAuraOptions = {
+    auraRef: RefObject<HTMLElement | null>;
+    active: boolean;
+    frozen?: boolean;
+    meter?: VoiceInputAuraMeter;
+    onFrame?: (frame: VoiceInputAuraFrame) => boolean | void;
+};
+/**
+ * Drives the microphone aura directly on the DOM so live audio never causes
+ * React renders. Meter packets are coalesced into at most one animation frame.
+ */
+export declare function useVoiceInputAura({ auraRef, active, frozen, meter, onFrame, }: UseVoiceInputAuraOptions): (force?: boolean) => void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alxxsck/ai-assistant",
   "private": false,
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "Embeddable Lola AI assistant library",
   "type": "module",
   "main": "dist/bridge-ai-chat-widget.es.js",