@vinaverse/react-native 0.0.0-stage → 0.1.0-alpha.2

package/dist/index.d.cts

@@ -0,0 +1,264 @@
+import * as react from 'react';
+import { ReactNode, ComponentType, ReactElement, RefObject } from 'react';
+import { HeldCard, CardItem, Question, MessageItem, TimelineItem, SystemItem, ProposalOutcome, ConversationStore } from '@vinaverse/client/conversation';
+import { CopyOverrides } from '@vinaverse/react';
+import { ImageProps, StyleProp, ViewStyle } from 'react-native';
+import { ColorScheme, Colors, font, space, radius, motion, size } from '@vinaverse/tokens';
+
+declare function CardFrame(props: {
+    readonly label: string;
+    readonly restored?: boolean;
+    readonly children?: ReactNode;
+    readonly testID?: string;
+}): react.JSX.Element;
+
+interface CardProps {
+    readonly card: HeldCard;
+    /** A proposal being decided: draw its buttons busy. */
+    readonly busy: boolean;
+    /** Restored after a restart: draw it as it was, taking no answer or action. */
+    readonly restored: boolean;
+    /** The kit's own renderer for this kind, to wrap rather than rewrite. */
+    readonly Default: ComponentType<Omit<CardProps, 'Default'>>;
+}
+
+/** The kit's own renderer for a kind. */
+declare function defaultCard(kind: string): ComponentType<Omit<CardProps, 'Default'>>;
+declare const CardView: react.NamedExoticComponent<{
+    readonly item: CardItem;
+}>;
+
+declare function InfoCard(props: Omit<CardProps, 'Default'>): react.JSX.Element;
+
+declare function NextStepCard(props: Omit<CardProps, 'Default'>): react.JSX.Element;
+
+/** A field's value as text, by its type (`text`, `list`, `time_range`, `address`, `money_cents`). */
+declare function fieldText(type: string, value: unknown, locale: string | undefined, timeZone: string | undefined): string;
+declare function ProposalCard(props: Omit<CardProps, 'Default'>): react.JSX.Element | null;
+
+declare function QuestionCard(props: Omit<CardProps, 'Default'>): react.JSX.Element | null;
+/** A recorded answer, in words. */
+declare function answerText(question: Question, locale: string | undefined, otherLabel: string): string | null;
+
+declare function TimeSlotsCard(props: Omit<CardProps, 'Default'>): react.JSX.Element;
+
+declare const ActivityLine: react.NamedExoticComponent<object>;
+
+declare const Avatar: react.NamedExoticComponent<{
+    readonly name: string;
+    readonly uri: string | null;
+    readonly person?: boolean;
+}>;
+
+interface ButtonProps {
+    readonly label: string;
+    readonly onPress: () => void;
+    readonly variant?: 'primary' | 'secondary' | 'text';
+    readonly disabled?: boolean;
+    readonly busy?: boolean;
+    /** A role other than a button: `radio` and `checkbox` for choices. */
+    readonly role?: 'button' | 'radio' | 'checkbox' | 'link';
+    readonly selected?: boolean;
+    readonly hint?: string;
+    readonly children?: ReactNode;
+    readonly testID?: string;
+}
+declare const Button: react.NamedExoticComponent<ButtonProps>;
+
+interface HeaderProps {
+    readonly name: string;
+    readonly avatarUrl: string | null;
+    /** While a person from the business replies: their role. */
+    readonly takeoverBy: string | null;
+    readonly Default: ComponentType<Omit<HeaderProps, 'Default'>>;
+}
+interface MessageBubbleProps {
+    readonly item: MessageItem;
+    /** The text to draw: the message's, or the streamed text so far. */
+    readonly text: string;
+    readonly Default: ComponentType<Omit<MessageBubbleProps, 'Default'>>;
+}
+interface ComposerProps {
+    readonly placeholder: string;
+    readonly responding: boolean;
+    readonly onSend: (text: string) => void;
+    readonly onStop: () => void;
+    readonly Default: ComponentType<Omit<ComposerProps, 'Default'>>;
+}
+interface EmptyStateProps {
+    readonly agentName: string;
+}
+/** The props the kit gives its list: FlashList's, so FlashList or LegendList take them as they are. */
+interface ListProps {
+    readonly data: readonly TimelineItem[];
+    readonly renderItem: (info: {
+        item: TimelineItem;
+        index: number;
+    }) => ReactElement | null;
+    readonly keyExtractor: (item: TimelineItem) => string;
+    readonly getItemType: (item: TimelineItem) => string;
+    readonly maintainVisibleContentPosition: {
+        readonly startRenderingFromBottom: boolean;
+        readonly autoscrollToBottomThreshold: number;
+        readonly animateAutoScrollToBottom: boolean;
+    };
+    readonly ListFooterComponent: ReactElement | null;
+    readonly ListEmptyComponent: ReactElement | null;
+    readonly keyboardShouldPersistTaps: 'handled';
+    readonly contentContainerStyle: object;
+}
+
+declare function DefaultHeader(props: Omit<HeaderProps, 'Default'>): react.JSX.Element;
+declare const ChatHeader: react.NamedExoticComponent<object>;
+
+declare const ChatSkeleton: react.NamedExoticComponent<object>;
+
+declare function DefaultComposer(props: Omit<ComposerProps, 'Default'>): react.JSX.Element;
+declare const Composer: react.NamedExoticComponent<{
+    readonly onError?: (error: unknown) => void;
+}>;
+
+declare const DisclosureBar: react.NamedExoticComponent<object>;
+
+declare function DefaultBubble(props: Omit<MessageBubbleProps, 'Default'>): react.JSX.Element;
+declare const MessageBubble: react.NamedExoticComponent<{
+    readonly item: MessageItem;
+    /** The first of a run from the same author: its label is shown. */
+    readonly showAuthor: boolean;
+}>;
+/** The reply streaming now: the only cell that re-renders as the text arrives. */
+declare const StreamingBubble: react.NamedExoticComponent<{
+    readonly item: MessageItem;
+    readonly showAuthor: boolean;
+}>;
+
+/** Rows of one kind recycle together. */
+declare function itemType(item: TimelineItem): string;
+declare const Row: react.NamedExoticComponent<{
+    readonly item: TimelineItem;
+    readonly showAuthor: boolean;
+}>;
+declare const MessageList: react.NamedExoticComponent<object>;
+
+declare const StatusBanner: react.NamedExoticComponent<object>;
+
+declare const SystemRow: react.NamedExoticComponent<{
+    readonly item: SystemItem;
+}>;
+
+type ProposalDecision = 'confirm' | 'decline';
+/** What the kit asks of the tenant's app. Only `onProposal` and `onOpenLink` are needed for the cards that use them. */
+interface ChatHandlers {
+    /**
+     * The person confirmed or declined a proposal: call your backend with the person's own token, then say what
+     * happened (`confirmed`, `declined`, `failed`, or `expired` when it had expired). The kit reports it to the session.
+     */
+    readonly onProposal?: (card: HeldCard, decision: ProposalDecision) => Promise<ProposalOutcome>;
+    /** Open a card's link in your app (it already passed the deep-link rule); route by the page it names. */
+    readonly onOpenLink?: (link: string, card: HeldCard) => void;
+    /** A card action without a link (`show_times`, …): sent to the session; this tells your app too. */
+    readonly onCardAction?: (card: HeldCard, action: string) => void;
+    /** A photo question: let the person pick one, upload it to your backend, and give back its `upload_ref`. */
+    readonly onPickPhoto?: (question: Question, card: HeldCard) => Promise<{
+        readonly upload_ref: string;
+    } | null>;
+    /** Development warnings: a theme that is hard to read, copy that says "assistant". */
+    readonly onWarning?: (message: string) => void;
+}
+/** Parts a tenant can replace. Each gets the default's props and the default itself (`Default`), to wrap it. */
+interface ChatSlots {
+    readonly Header?: ComponentType<HeaderProps>;
+    readonly MessageBubble?: ComponentType<MessageBubbleProps>;
+    readonly Composer?: ComponentType<ComposerProps>;
+    readonly EmptyState?: ComponentType<EmptyStateProps>;
+    readonly Image?: ComponentType<ImageProps>;
+    /** A list with FlashList's props (LegendList works). Default: FlashList. */
+    readonly ListComponent?: ComponentType<ListProps>;
+    /** Card renderers by kind (`professional`, `proposal`, …). */
+    readonly cards?: Readonly<Partial<Record<string, ComponentType<CardProps>>>>;
+}
+interface ChatContextValue {
+    readonly store: ConversationStore;
+    readonly handlers: RefObject<ChatHandlers>;
+    readonly slots: ChatSlots;
+    readonly agentAvatar: string | undefined;
+    readonly timeZone: string | undefined;
+}
+/** The conversation, handlers and slots; only inside `VinaverseChat` (or `VinaverseChatProvider`). */
+declare function useChat(): ChatContextValue;
+
+interface Theme {
+    readonly scheme: ColorScheme;
+    readonly colors: Colors;
+    readonly font: typeof font & {
+        readonly family?: string;
+    };
+    readonly space: typeof space;
+    readonly radius: typeof radius;
+    readonly motion: typeof motion;
+    readonly size: typeof size;
+}
+/** A tenant's brand: colors per scheme, a font family, radii. Anything left out keeps the Vinaverse default. */
+interface ThemeOverrides {
+    readonly light?: Partial<Colors>;
+    readonly dark?: Partial<Colors>;
+    readonly fontFamily?: string;
+    readonly radius?: Partial<typeof radius>;
+    readonly space?: Partial<typeof space>;
+}
+type ColorSchemeSetting = 'system' | 'light' | 'dark';
+/** The theme for a scheme, with the tenant's overrides on top. */
+declare function createTheme(scheme: ColorScheme, overrides?: ThemeOverrides): Theme;
+/** The pairs a tenant's colors made hard to read, in either scheme, as messages for a development warning. */
+declare function themeProblems(overrides?: ThemeOverrides): string[];
+declare function ThemeProvider(props: {
+    readonly theme?: ThemeOverrides | undefined;
+    readonly colorScheme?: ColorSchemeSetting | undefined;
+    readonly children?: ReactNode;
+}): ReactNode;
+declare function useTheme(): Theme;
+
+interface VinaverseChatProps extends ChatHandlers {
+    /** The conversation (`createConversation`), created where it can outlive the screen. */
+    readonly conversation: ConversationStore;
+    /** The person's locale: the copy, dates, money and text direction (pass the same one to `getSession`). */
+    readonly locale?: string;
+    /** For dates and times on cards; default: the device's. */
+    readonly timeZone?: string;
+    readonly copy?: CopyOverrides;
+    readonly theme?: ThemeOverrides;
+    readonly colorScheme?: ColorSchemeSetting;
+    /** Parts to replace. Keep the object stable (module level, or memoized). */
+    readonly components?: ChatSlots;
+    /** The agent's picture, until the session carries one. */
+    readonly agentAvatar?: string;
+    /** Hide the header (a screen that draws its own); the disclosure stays. */
+    readonly hideHeader?: boolean;
+    /** iOS: the height above the keyboard that is not this view's (a navigation header). */
+    readonly keyboardVerticalOffset?: number;
+    /**
+     * How the composer stays above the keyboard. Default: `padding` on iOS, none on Android (the window resizes). An
+     * edge-to-edge Android app whose window does not resize passes `padding`; one that manages the keyboard itself
+     * (react-native-keyboard-controller) passes `none`.
+     */
+    readonly keyboardBehavior?: 'padding' | 'height' | 'position' | 'none';
+    readonly style?: StyleProp<ViewStyle>;
+}
+/** The providers alone, for a tenant composing its own layout from the exported parts. */
+declare function VinaverseChatProvider(props: Omit<VinaverseChatProps, 'hideHeader' | 'keyboardVerticalOffset' | 'keyboardBehavior' | 'style'> & {
+    readonly children?: ReactNode;
+}): ReactNode;
+declare function VinaverseChat(props: VinaverseChatProps): ReactNode;
+
+/** The part of the conversation store the adapter drives. */
+interface LifecycleTarget {
+    setForeground(foreground: boolean): void;
+}
+/** Tells the store when the app comes to the foreground or goes to the background (it pings only in the foreground). */
+declare function useNativeLifecycle(store: LifecycleTarget): void;
+/** Whether the person asked for reduced motion: animations and animated scrolling stay off. */
+declare function useReducedMotion(): boolean;
+/** Reads a line to a screen reader, without moving focus. */
+declare function announce(text: string): void;
+
+export { ActivityLine, Avatar, Button, type ButtonProps, CardFrame, type CardProps, CardView, type ChatHandlers, ChatHeader, ChatSkeleton, type ChatSlots, type ColorSchemeSetting, Composer, type ComposerProps, DefaultBubble, DefaultComposer, DefaultHeader, DisclosureBar, type EmptyStateProps, type HeaderProps, InfoCard, type LifecycleTarget, type ListProps, MessageBubble, type MessageBubbleProps, MessageList, NextStepCard, ProposalCard, type ProposalDecision, QuestionCard, Row, StatusBanner, StreamingBubble, SystemRow, type Theme, type ThemeOverrides, ThemeProvider, TimeSlotsCard, VinaverseChat, type VinaverseChatProps, VinaverseChatProvider, announce, answerText, createTheme, defaultCard, fieldText, itemType, themeProblems, useChat, useNativeLifecycle, useReducedMotion, useTheme };

package/dist/index.d.ts

@@ -0,0 +1,264 @@
+import * as react from 'react';
+import { ReactNode, ComponentType, ReactElement, RefObject } from 'react';
+import { HeldCard, CardItem, Question, MessageItem, TimelineItem, SystemItem, ProposalOutcome, ConversationStore } from '@vinaverse/client/conversation';
+import { CopyOverrides } from '@vinaverse/react';
+import { ImageProps, StyleProp, ViewStyle } from 'react-native';
+import { ColorScheme, Colors, font, space, radius, motion, size } from '@vinaverse/tokens';
+
+declare function CardFrame(props: {
+    readonly label: string;
+    readonly restored?: boolean;
+    readonly children?: ReactNode;
+    readonly testID?: string;
+}): react.JSX.Element;
+
+interface CardProps {
+    readonly card: HeldCard;
+    /** A proposal being decided: draw its buttons busy. */
+    readonly busy: boolean;
+    /** Restored after a restart: draw it as it was, taking no answer or action. */
+    readonly restored: boolean;
+    /** The kit's own renderer for this kind, to wrap rather than rewrite. */
+    readonly Default: ComponentType<Omit<CardProps, 'Default'>>;
+}
+
+/** The kit's own renderer for a kind. */
+declare function defaultCard(kind: string): ComponentType<Omit<CardProps, 'Default'>>;
+declare const CardView: react.NamedExoticComponent<{
+    readonly item: CardItem;
+}>;
+
+declare function InfoCard(props: Omit<CardProps, 'Default'>): react.JSX.Element;
+
+declare function NextStepCard(props: Omit<CardProps, 'Default'>): react.JSX.Element;
+
+/** A field's value as text, by its type (`text`, `list`, `time_range`, `address`, `money_cents`). */
+declare function fieldText(type: string, value: unknown, locale: string | undefined, timeZone: string | undefined): string;
+declare function ProposalCard(props: Omit<CardProps, 'Default'>): react.JSX.Element | null;
+
+declare function QuestionCard(props: Omit<CardProps, 'Default'>): react.JSX.Element | null;
+/** A recorded answer, in words. */
+declare function answerText(question: Question, locale: string | undefined, otherLabel: string): string | null;
+
+declare function TimeSlotsCard(props: Omit<CardProps, 'Default'>): react.JSX.Element;
+
+declare const ActivityLine: react.NamedExoticComponent<object>;
+
+declare const Avatar: react.NamedExoticComponent<{
+    readonly name: string;
+    readonly uri: string | null;
+    readonly person?: boolean;
+}>;
+
+interface ButtonProps {
+    readonly label: string;
+    readonly onPress: () => void;
+    readonly variant?: 'primary' | 'secondary' | 'text';
+    readonly disabled?: boolean;
+    readonly busy?: boolean;
+    /** A role other than a button: `radio` and `checkbox` for choices. */
+    readonly role?: 'button' | 'radio' | 'checkbox' | 'link';
+    readonly selected?: boolean;
+    readonly hint?: string;
+    readonly children?: ReactNode;
+    readonly testID?: string;
+}
+declare const Button: react.NamedExoticComponent<ButtonProps>;
+
+interface HeaderProps {
+    readonly name: string;
+    readonly avatarUrl: string | null;
+    /** While a person from the business replies: their role. */
+    readonly takeoverBy: string | null;
+    readonly Default: ComponentType<Omit<HeaderProps, 'Default'>>;
+}
+interface MessageBubbleProps {
+    readonly item: MessageItem;
+    /** The text to draw: the message's, or the streamed text so far. */
+    readonly text: string;
+    readonly Default: ComponentType<Omit<MessageBubbleProps, 'Default'>>;
+}
+interface ComposerProps {
+    readonly placeholder: string;
+    readonly responding: boolean;
+    readonly onSend: (text: string) => void;
+    readonly onStop: () => void;
+    readonly Default: ComponentType<Omit<ComposerProps, 'Default'>>;
+}
+interface EmptyStateProps {
+    readonly agentName: string;
+}
+/** The props the kit gives its list: FlashList's, so FlashList or LegendList take them as they are. */
+interface ListProps {
+    readonly data: readonly TimelineItem[];
+    readonly renderItem: (info: {
+        item: TimelineItem;
+        index: number;
+    }) => ReactElement | null;
+    readonly keyExtractor: (item: TimelineItem) => string;
+    readonly getItemType: (item: TimelineItem) => string;
+    readonly maintainVisibleContentPosition: {
+        readonly startRenderingFromBottom: boolean;
+        readonly autoscrollToBottomThreshold: number;
+        readonly animateAutoScrollToBottom: boolean;
+    };
+    readonly ListFooterComponent: ReactElement | null;
+    readonly ListEmptyComponent: ReactElement | null;
+    readonly keyboardShouldPersistTaps: 'handled';
+    readonly contentContainerStyle: object;
+}
+
+declare function DefaultHeader(props: Omit<HeaderProps, 'Default'>): react.JSX.Element;
+declare const ChatHeader: react.NamedExoticComponent<object>;
+
+declare const ChatSkeleton: react.NamedExoticComponent<object>;
+
+declare function DefaultComposer(props: Omit<ComposerProps, 'Default'>): react.JSX.Element;
+declare const Composer: react.NamedExoticComponent<{
+    readonly onError?: (error: unknown) => void;
+}>;
+
+declare const DisclosureBar: react.NamedExoticComponent<object>;
+
+declare function DefaultBubble(props: Omit<MessageBubbleProps, 'Default'>): react.JSX.Element;
+declare const MessageBubble: react.NamedExoticComponent<{
+    readonly item: MessageItem;
+    /** The first of a run from the same author: its label is shown. */
+    readonly showAuthor: boolean;
+}>;
+/** The reply streaming now: the only cell that re-renders as the text arrives. */
+declare const StreamingBubble: react.NamedExoticComponent<{
+    readonly item: MessageItem;
+    readonly showAuthor: boolean;
+}>;
+
+/** Rows of one kind recycle together. */
+declare function itemType(item: TimelineItem): string;
+declare const Row: react.NamedExoticComponent<{
+    readonly item: TimelineItem;
+    readonly showAuthor: boolean;
+}>;
+declare const MessageList: react.NamedExoticComponent<object>;
+
+declare const StatusBanner: react.NamedExoticComponent<object>;
+
+declare const SystemRow: react.NamedExoticComponent<{
+    readonly item: SystemItem;
+}>;
+
+type ProposalDecision = 'confirm' | 'decline';
+/** What the kit asks of the tenant's app. Only `onProposal` and `onOpenLink` are needed for the cards that use them. */
+interface ChatHandlers {
+    /**
+     * The person confirmed or declined a proposal: call your backend with the person's own token, then say what
+     * happened (`confirmed`, `declined`, `failed`, or `expired` when it had expired). The kit reports it to the session.
+     */
+    readonly onProposal?: (card: HeldCard, decision: ProposalDecision) => Promise<ProposalOutcome>;
+    /** Open a card's link in your app (it already passed the deep-link rule); route by the page it names. */
+    readonly onOpenLink?: (link: string, card: HeldCard) => void;
+    /** A card action without a link (`show_times`, …): sent to the session; this tells your app too. */
+    readonly onCardAction?: (card: HeldCard, action: string) => void;
+    /** A photo question: let the person pick one, upload it to your backend, and give back its `upload_ref`. */
+    readonly onPickPhoto?: (question: Question, card: HeldCard) => Promise<{
+        readonly upload_ref: string;
+    } | null>;
+    /** Development warnings: a theme that is hard to read, copy that says "assistant". */
+    readonly onWarning?: (message: string) => void;
+}
+/** Parts a tenant can replace. Each gets the default's props and the default itself (`Default`), to wrap it. */
+interface ChatSlots {
+    readonly Header?: ComponentType<HeaderProps>;
+    readonly MessageBubble?: ComponentType<MessageBubbleProps>;
+    readonly Composer?: ComponentType<ComposerProps>;
+    readonly EmptyState?: ComponentType<EmptyStateProps>;
+    readonly Image?: ComponentType<ImageProps>;
+    /** A list with FlashList's props (LegendList works). Default: FlashList. */
+    readonly ListComponent?: ComponentType<ListProps>;
+    /** Card renderers by kind (`professional`, `proposal`, …). */
+    readonly cards?: Readonly<Partial<Record<string, ComponentType<CardProps>>>>;
+}
+interface ChatContextValue {
+    readonly store: ConversationStore;
+    readonly handlers: RefObject<ChatHandlers>;
+    readonly slots: ChatSlots;
+    readonly agentAvatar: string | undefined;
+    readonly timeZone: string | undefined;
+}
+/** The conversation, handlers and slots; only inside `VinaverseChat` (or `VinaverseChatProvider`). */
+declare function useChat(): ChatContextValue;
+
+interface Theme {
+    readonly scheme: ColorScheme;
+    readonly colors: Colors;
+    readonly font: typeof font & {
+        readonly family?: string;
+    };
+    readonly space: typeof space;
+    readonly radius: typeof radius;
+    readonly motion: typeof motion;
+    readonly size: typeof size;
+}
+/** A tenant's brand: colors per scheme, a font family, radii. Anything left out keeps the Vinaverse default. */
+interface ThemeOverrides {
+    readonly light?: Partial<Colors>;
+    readonly dark?: Partial<Colors>;
+    readonly fontFamily?: string;
+    readonly radius?: Partial<typeof radius>;
+    readonly space?: Partial<typeof space>;
+}
+type ColorSchemeSetting = 'system' | 'light' | 'dark';
+/** The theme for a scheme, with the tenant's overrides on top. */
+declare function createTheme(scheme: ColorScheme, overrides?: ThemeOverrides): Theme;
+/** The pairs a tenant's colors made hard to read, in either scheme, as messages for a development warning. */
+declare function themeProblems(overrides?: ThemeOverrides): string[];
+declare function ThemeProvider(props: {
+    readonly theme?: ThemeOverrides | undefined;
+    readonly colorScheme?: ColorSchemeSetting | undefined;
+    readonly children?: ReactNode;
+}): ReactNode;
+declare function useTheme(): Theme;
+
+interface VinaverseChatProps extends ChatHandlers {
+    /** The conversation (`createConversation`), created where it can outlive the screen. */
+    readonly conversation: ConversationStore;
+    /** The person's locale: the copy, dates, money and text direction (pass the same one to `getSession`). */
+    readonly locale?: string;
+    /** For dates and times on cards; default: the device's. */
+    readonly timeZone?: string;
+    readonly copy?: CopyOverrides;
+    readonly theme?: ThemeOverrides;
+    readonly colorScheme?: ColorSchemeSetting;
+    /** Parts to replace. Keep the object stable (module level, or memoized). */
+    readonly components?: ChatSlots;
+    /** The agent's picture, until the session carries one. */
+    readonly agentAvatar?: string;
+    /** Hide the header (a screen that draws its own); the disclosure stays. */
+    readonly hideHeader?: boolean;
+    /** iOS: the height above the keyboard that is not this view's (a navigation header). */
+    readonly keyboardVerticalOffset?: number;
+    /**
+     * How the composer stays above the keyboard. Default: `padding` on iOS, none on Android (the window resizes). An
+     * edge-to-edge Android app whose window does not resize passes `padding`; one that manages the keyboard itself
+     * (react-native-keyboard-controller) passes `none`.
+     */
+    readonly keyboardBehavior?: 'padding' | 'height' | 'position' | 'none';
+    readonly style?: StyleProp<ViewStyle>;
+}
+/** The providers alone, for a tenant composing its own layout from the exported parts. */
+declare function VinaverseChatProvider(props: Omit<VinaverseChatProps, 'hideHeader' | 'keyboardVerticalOffset' | 'keyboardBehavior' | 'style'> & {
+    readonly children?: ReactNode;
+}): ReactNode;
+declare function VinaverseChat(props: VinaverseChatProps): ReactNode;
+
+/** The part of the conversation store the adapter drives. */
+interface LifecycleTarget {
+    setForeground(foreground: boolean): void;
+}
+/** Tells the store when the app comes to the foreground or goes to the background (it pings only in the foreground). */
+declare function useNativeLifecycle(store: LifecycleTarget): void;
+/** Whether the person asked for reduced motion: animations and animated scrolling stay off. */
+declare function useReducedMotion(): boolean;
+/** Reads a line to a screen reader, without moving focus. */
+declare function announce(text: string): void;
+
+export { ActivityLine, Avatar, Button, type ButtonProps, CardFrame, type CardProps, CardView, type ChatHandlers, ChatHeader, ChatSkeleton, type ChatSlots, type ColorSchemeSetting, Composer, type ComposerProps, DefaultBubble, DefaultComposer, DefaultHeader, DisclosureBar, type EmptyStateProps, type HeaderProps, InfoCard, type LifecycleTarget, type ListProps, MessageBubble, type MessageBubbleProps, MessageList, NextStepCard, ProposalCard, type ProposalDecision, QuestionCard, Row, StatusBanner, StreamingBubble, SystemRow, type Theme, type ThemeOverrides, ThemeProvider, TimeSlotsCard, VinaverseChat, type VinaverseChatProps, VinaverseChatProvider, announce, answerText, createTheme, defaultCard, fieldText, itemType, themeProblems, useChat, useNativeLifecycle, useReducedMotion, useTheme };