@alexkroman1/aai-ui 0.12.2 → 1.0.2

package/dist/signals.js

@@ -1,161 +0,0 @@
-import { createContext, h } from "preact";
-import { useContext, useEffect, useRef } from "preact/hooks";
-import { batch, effect, signal, useSignalEffect } from "@preact/signals";
-//#region signals.ts
-/**
-* Wrap a {@link VoiceSession} in Preact signals for reactive UI binding.
-*
-* Creates higher-level controls (start, toggle, reset) on top of the raw
-* session, and automatically sets `running` to `false` when the session
-* enters an error state.
-*
-* @param session - The voice session to wrap.
-* @returns A {@link SessionSignals} object for use in Preact components.
-*
-* @public
-*/
-function createSessionControls(session) {
-	const started = signal(false);
-	const running = signal(true);
-	const dispose = effect(() => {
-		if (session.state.value === "error") running.value = false;
-	});
-	return {
-		session,
-		started,
-		running,
-		dispose,
-		start() {
-			batch(() => {
-				started.value = true;
-				running.value = true;
-			});
-			session.connect();
-		},
-		toggle() {
-			if (running.value) {
-				session.cancel();
-				session.disconnect();
-			} else session.connect();
-			running.value = !running.value;
-		},
-		reset() {
-			session.reset();
-		},
-		[Symbol.dispose]() {
-			dispose();
-		}
-	};
-}
-const Ctx = createContext(null);
-/**
-* Preact context provider that makes session signals available to descendant
-* components via {@link useSession}.
-*
-* @param props - Provider props. `value` is the session signals to provide. `children` are child components that may consume the context.
-* @returns A Preact VNode wrapping children in the session context.
-*
-* @public
-*/
-function SessionProvider({ value, children }) {
-	return h(Ctx.Provider, { value }, children);
-}
-/**
-* Hook to access session signals from within a {@link SessionProvider}.
-*
-* @returns The {@link SessionSignals} from the nearest provider.
-* @throws If called outside of a `SessionProvider`.
-*
-* @public
-*/
-function useSession() {
-	const ctx = useContext(Ctx);
-	if (!ctx) throw new Error("Hook useSession() requires a SessionProvider");
-	return ctx;
-}
-function tryParseJSON(str) {
-	try {
-		return JSON.parse(str);
-	} catch {
-		return str;
-	}
-}
-function isNewCompletedCall(tc, seen, filterName) {
-	if (tc.status !== "done" || !tc.result) return false;
-	if (seen.has(tc.toolCallId)) return false;
-	if (filterName && tc.toolName !== filterName) return false;
-	return true;
-}
-/**
-* Shared helper for hooks that need to fire a callback once per new tool call.
-*
-* Handles deduplication via a `Set<string>` ref, automatic reset when the
-* signal array is cleared, and a stable callback ref to avoid stale closures.
-*
-* @param session - The voice session whose `toolCalls` signal to watch.
-* @param shouldProcess - Predicate that decides whether a tool call is eligible.
-*   Called with the tool call and the seen-IDs set. Must NOT mutate the set.
-* @param onNew - Invoked for each eligible tool call that hasn't been seen yet.
-*/
-function useToolCallEffect(session, shouldProcess, onNew) {
-	const seenRef = useRef(/* @__PURE__ */ new Set());
-	const cbRef = useRef(onNew);
-	cbRef.current = onNew;
-	const predicateRef = useRef(shouldProcess);
-	predicateRef.current = shouldProcess;
-	useEffect(() => effect(() => {
-		const toolCalls = session.toolCalls.value;
-		if (toolCalls.length === 0) {
-			seenRef.current.clear();
-			return;
-		}
-		for (const tc of toolCalls) {
-			if (!predicateRef.current(tc, seenRef.current)) continue;
-			if (seenRef.current.has(tc.toolCallId)) continue;
-			seenRef.current.add(tc.toolCallId);
-			cbRef.current(tc);
-		}
-	}), [session]);
-}
-function useToolResult(toolNameOrCallback, maybeCallback) {
-	const filterName = typeof toolNameOrCallback === "string" ? toolNameOrCallback : void 0;
-	const callback = typeof toolNameOrCallback === "function" ? toolNameOrCallback : (_name, result, tc) => maybeCallback?.(result, tc);
-	const { session } = useSession();
-	useToolCallEffect(session, (tc, seen) => isNewCompletedCall(tc, seen, filterName), (tc) => callback(tc.toolName, tryParseJSON(tc.result), tc));
-}
-/**
-* Hook that fires a callback when a new tool call starts (status: "pending").
-*
-* Use this to show a loading/skeleton UI immediately when the agent invokes
-* a tool, rather than waiting for the full result. The callback receives the
-* tool name, parsed arguments, and the full {@link ToolCallInfo}.
-*
-* @param callback - Called once per new tool call at start time.
-*
-* @public
-*/
-function useToolCallStart(callback) {
-	const { session } = useSession();
-	useToolCallEffect(session, () => true, (tc) => callback(tc.toolName, tc.args, tc));
-}
-/**
-* Auto-scroll a container to the bottom when messages, tool calls,
-* or utterances change. Returns a ref to attach to a sentinel `<div>`
-* at the bottom of the scrollable area.
-*
-* @public
-*/
-function useAutoScroll() {
-	const { session } = useSession();
-	const ref = useRef(null);
-	useSignalEffect(() => {
-		session.messages.value;
-		session.toolCalls.value;
-		session.userUtterance.value;
-		session.agentUtterance.value;
-		ref.current?.scrollIntoView({ behavior: "smooth" });
-	});
-	return ref;
-}
-//#endregion
-export { SessionProvider, createSessionControls, useAutoScroll, useSession, useToolCallStart, useToolResult };

package/dist/types.test-d.d.ts

@@ -1,7 +0,0 @@
-/**
- * Type-level tests for the public API surface of @alexkroman1/aai-ui.
- *
- * These are checked by tsc (via vitest typecheck) but never executed.
- * A failure here means a public type contract has regressed.
- */
-export {};