@tanstack/ai-preact 0.14.3 → 0.15.0

package/src/create-chat-hook.ts

@@ -0,0 +1,47 @@
+import { useChat as useUnboundChat } from './use-chat'
+import type { AnyClientTool, InterruptDefinition } from '@tanstack/ai/client'
+import type { InferredClientContext } from '@tanstack/ai-client'
+import type { UseChatOptions } from './types'
+
+type ChatHookOverrides<
+  TTools extends ReadonlyArray<AnyClientTool>,
+  TContext,
+  TInterrupts extends ReadonlyArray<InterruptDefinition<any, any, any, any>>,
+> = {
+  threadId?: string
+  live?: boolean
+  forwardedProps?: Record<string, any>
+  body?: Record<string, any>
+  initialMessages?: UseChatOptions<
+    TTools,
+    TContext,
+    TInterrupts
+  >['initialMessages']
+}
+
+/**
+ * Bind chat options once at module scope. The returned `useChat` hook
+ * creates a chat instance from those options.
+ *
+ * Pass per-call overrides for instance keys such as `threadId`,
+ * `initialMessages`, `live`, and `forwardedProps`. Do not change `tools`,
+ * `interrupts`, or `outputSchema` here. Those stay on the factory options.
+ */
+export function createChatHook<
+  const TTools extends ReadonlyArray<AnyClientTool> = any,
+  TContext = InferredClientContext<TTools>,
+  const TInterrupts extends ReadonlyArray<
+    InterruptDefinition<any, any, any, any>
+  > = readonly [],
+>(options: UseChatOptions<TTools, TContext, TInterrupts>) {
+  function useChat(
+    overrides?: ChatHookOverrides<TTools, TContext, TInterrupts>,
+  ) {
+    if (!overrides) {
+      return useUnboundChat(options)
+    }
+    return useUnboundChat({ ...options, ...overrides })
+  }
+
+  return { useChat }
+}

package/src/index.ts

@@ -1,4 +1,5 @@
 export { useChat } from './use-chat'
+export { createChatHook } from './create-chat-hook'
 export { useByok } from './use-byok'
 export { useMcpAppBridge } from './use-mcp-app-bridge'
 export type { UseMcpAppBridgeOptions } from './use-mcp-app-bridge'

package/src/ui.ts

@@ -0,0 +1,20 @@
+// Barrel entry for the `@tanstack/ai-preact/ui` subpath.
+export {
+  createChatUI,
+  type ChatUIComponents,
+  type ChatUIFactoryConfig,
+  type ChatUIHost,
+  type ChatUIQueueItem,
+  type InputProps,
+  type InterruptProps,
+  type LayoutProps,
+  type MessageProps,
+  type PartProps,
+  type QueueProps,
+  type ToolProps,
+} from './chat-ui/create-ui'
+export { createChatHook } from './chat-ui/create-chat-hook'
+export {
+  createChatHookContexts,
+  type ChatUIContexts,
+} from './chat-ui/create-ui-contexts'