@vinaverse/react-native 0.1.0-alpha.2 → 0.1.0-alpha.4

package/dist/index.d.cts

@@ -1,16 +1,95 @@
 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 { ComponentType, ReactElement, ReactNode, RefObject } from 'react';
+import { CardItem, MessageItem, Welcome as Welcome$1, TimelineItem, HeldCard, Question, 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';
 
+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 tenant's greeting and chips for the session's mode (`Session.welcome`), or null. */
+    readonly welcome: Welcome$1 | null;
+    /** Sends a chip's `message` as the person's own text. */
+    readonly onChip: (message: string) => void;
+}
+/** `components.CardGroup`: the cards one turn drew together with `group.layout: carousel`, in order. */
+interface CardGroupProps {
+    readonly items: readonly CardItem[];
+}
+/** 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;
+}
+/** A failure the person needs a way out of: a turn that failed before any reply, or no session to talk to. */
+interface FailureState {
+    /** `turn_failed`: a turn failed before any of its reply; `unavailable`: the backend gave no session, or none it could use. */
+    readonly kind: 'turn_failed' | 'unavailable';
+    /** Why: the turn's error `code` (`internal`, `timeout`, …), or the conversation's status (`unavailable`, `unauthorized`). */
+    readonly reason: string | null;
+    /** Try again, when it can be: the person's text again for a turn the server allows to retry, a new session otherwise. */
+    readonly retry: (() => void) | undefined;
+    /** The conversation, once a session named it: for your support records. */
+    readonly conversationId: string | null;
+}
+/** A slot for a failure (`components.Error`, `components.Unavailable`): the state, and the kit's own part to wrap. */
+interface FailureProps {
+    readonly state: FailureState;
+    readonly Default: ComponentType<{
+        readonly state: FailureState;
+    }>;
+}
+/** One action on every failure, drawn as a button by the kit's own parts: a person is always the way out. */
+interface FailureAction {
+    /** Default: the copy's `talkToPerson` ("Talk to a person"), in the person's language. */
+    readonly label?: string;
+    readonly onPress: (state: FailureState) => void;
+}
+
+declare function CardCarousel(props: CardGroupProps): react.JSX.Element;
+
 declare function CardFrame(props: {
     readonly label: string;
     readonly restored?: boolean;
     readonly children?: ReactNode;
     readonly testID?: string;
 }): react.JSX.Element;
+/** A rating in millionths as the locale writes it, one decimal: 4.8, or 4,8 in Spanish and Portuguese. */
+declare function ratingText(valuePpm: number, locale: string | undefined): string;
 
 interface CardProps {
     readonly card: HeldCard;
@@ -29,6 +108,14 @@ declare const CardView: react.NamedExoticComponent<{
 }>;
 
 declare function InfoCard(props: Omit<CardProps, 'Default'>): react.JSX.Element;
+/** A card's actions: a link that passes the deep-link rule opens the tenant's page, any other goes to the session. */
+declare function CardActions(props: Omit<CardProps, 'Default'>): react.JSX.Element | null;
+
+declare function LinksCard(props: Omit<CardProps, 'Default'>): react.JSX.Element;
+
+declare function ListingCard(props: Omit<CardProps, 'Default'>): react.JSX.Element;
+/** The first letters of the first two words: "Bell's Barber Lounge" is "BB". */
+declare function monogram(title: string): string;
 
 declare function NextStepCard(props: Omit<CardProps, 'Default'>): react.JSX.Element;
 
@@ -65,49 +152,6 @@ interface ButtonProps {
 }
 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>;
 
@@ -120,6 +164,11 @@ declare const Composer: react.NamedExoticComponent<{
 
 declare const DisclosureBar: react.NamedExoticComponent<object>;
 
+/** The tenant's failure action as a button, or nothing when there is none. */
+declare function FailureActionButton(props: {
+    readonly state: FailureState;
+}): ReactNode;
+
 declare function DefaultBubble(props: Omit<MessageBubbleProps, 'Default'>): react.JSX.Element;
 declare const MessageBubble: react.NamedExoticComponent<{
     readonly item: MessageItem;
@@ -134,17 +183,38 @@ declare const StreamingBubble: react.NamedExoticComponent<{
 
 /** Rows of one kind recycle together. */
 declare function itemType(item: TimelineItem): string;
+/**
+ * Runs of two or more consecutive cards with one carousel group (`group.layout: carousel`, the same `group.id`): by
+ * the first card's key, and the keys of the cards the run draws after it. A run equal to the previous one is the
+ * same array, so its row does not render again.
+ */
+declare function carousels(items: readonly TimelineItem[], previous: ReadonlyMap<string, readonly CardItem[]>): {
+    runs: Map<string, readonly CardItem[]>;
+    inside: Set<string>;
+};
 declare const Row: react.NamedExoticComponent<{
     readonly item: TimelineItem;
     readonly showAuthor: boolean;
+    /** The carousel this card starts (`components.CardGroup`). */
+    readonly run?: readonly CardItem[] | undefined;
+    /** A card a carousel earlier in the list draws. */
+    readonly inside?: boolean;
 }>;
 declare const MessageList: react.NamedExoticComponent<object>;
 
 declare const StatusBanner: react.NamedExoticComponent<object>;
+/** The kit's own "Couldn't connect." banner: try again, and the tenant's failure action when there is one. */
+declare function DefaultUnavailable(props: {
+    readonly state: FailureState;
+}): ReactNode;
 
 declare const SystemRow: react.NamedExoticComponent<{
     readonly item: SystemItem;
 }>;
+/** The kit's own failed-turn row: "Something went wrong.", and the tenant's failure action when there is one. */
+declare function DefaultTurnFailed(props: {
+    readonly state: FailureState;
+}): ReactNode;
 
 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. */
@@ -154,7 +224,10 @@ interface ChatHandlers {
      * 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. */
+    /**
+     * Open a card's link in your app: a deep link that already passed the deep-link rule (route by the page it names),
+     * or a `links` card's https page (your in-app browser; without this handler the system opens it).
+     */
     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;
@@ -162,6 +235,11 @@ interface ChatHandlers {
     readonly onPickPhoto?: (question: Question, card: HeldCard) => Promise<{
         readonly upload_ref: string;
     } | null>;
+    /**
+     * A way out on a failed turn and on "couldn't connect": a button with your label (default "Talk to a person"),
+     * drawn by the kit's own parts when no `components.Error` or `components.Unavailable` replaces them.
+     */
+    readonly failureAction?: FailureAction;
     /** Development warnings: a theme that is hard to read, copy that says "assistant". */
     readonly onWarning?: (message: string) => void;
 }
@@ -174,6 +252,15 @@ interface ChatSlots {
     readonly Image?: ComponentType<ImageProps>;
     /** A list with FlashList's props (LegendList works). Default: FlashList. */
     readonly ListComponent?: ComponentType<ListProps>;
+    /** A turn that failed before any reply: replaces the "Something went wrong." row. */
+    readonly Error?: ComponentType<FailureProps>;
+    /** No session to talk to: replaces the "Couldn't connect." banner. */
+    readonly Unavailable?: ComponentType<FailureProps>;
+    /**
+     * Draws a turn's cards that ask for a carousel (`group.layout: carousel`) in one row: the kit's `CardCarousel`, or
+     * yours. Without it they draw one under another. Opt-in, so an app that never draws a carousel does not ship one.
+     */
+    readonly CardGroup?: ComponentType<CardGroupProps>;
     /** Card renderers by kind (`professional`, `proposal`, …). */
     readonly cards?: Readonly<Partial<Record<string, ComponentType<CardProps>>>>;
 }
@@ -183,6 +270,10 @@ interface ChatContextValue {
     readonly slots: ChatSlots;
     readonly agentAvatar: string | undefined;
     readonly timeZone: string | undefined;
+    /** The failure action's label when there is one (`label` undefined: the copy's); `onPress` is read from `handlers`. */
+    readonly failureAction: {
+        readonly label: string | undefined;
+    } | null;
 }
 /** The conversation, handlers and slots; only inside `VinaverseChat` (or `VinaverseChatProvider`). */
 declare function useChat(): ChatContextValue;
@@ -250,6 +341,11 @@ declare function VinaverseChatProvider(props: Omit<VinaverseChatProps, 'hideHead
 }): ReactNode;
 declare function VinaverseChat(props: VinaverseChatProps): ReactNode;
 
+declare const Welcome: react.NamedExoticComponent<{
+    readonly welcome: Welcome$1;
+    readonly onChip: (message: string) => void;
+}>;
+
 /** The part of the conversation store the adapter drives. */
 interface LifecycleTarget {
     setForeground(foreground: boolean): void;
@@ -261,4 +357,4 @@ 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 };
+export { ActivityLine, Avatar, Button, type ButtonProps, CardActions, CardCarousel, CardFrame, type CardGroupProps, type CardProps, CardView, type ChatHandlers, ChatHeader, ChatSkeleton, type ChatSlots, type ColorSchemeSetting, Composer, type ComposerProps, DefaultBubble, DefaultComposer, DefaultHeader, DefaultTurnFailed, DefaultUnavailable, DisclosureBar, type EmptyStateProps, type FailureAction, FailureActionButton, type FailureProps, type FailureState, type HeaderProps, InfoCard, type LifecycleTarget, LinksCard, type ListProps, ListingCard, MessageBubble, type MessageBubbleProps, MessageList, NextStepCard, ProposalCard, type ProposalDecision, QuestionCard, Row, StatusBanner, StreamingBubble, SystemRow, type Theme, type ThemeOverrides, ThemeProvider, TimeSlotsCard, VinaverseChat, type VinaverseChatProps, VinaverseChatProvider, Welcome, announce, answerText, carousels, createTheme, defaultCard, fieldText, itemType, monogram, ratingText, themeProblems, useChat, useNativeLifecycle, useReducedMotion, useTheme };

package/dist/index.d.ts

@@ -1,16 +1,95 @@
 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 { ComponentType, ReactElement, ReactNode, RefObject } from 'react';
+import { CardItem, MessageItem, Welcome as Welcome$1, TimelineItem, HeldCard, Question, 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';
 
+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 tenant's greeting and chips for the session's mode (`Session.welcome`), or null. */
+    readonly welcome: Welcome$1 | null;
+    /** Sends a chip's `message` as the person's own text. */
+    readonly onChip: (message: string) => void;
+}
+/** `components.CardGroup`: the cards one turn drew together with `group.layout: carousel`, in order. */
+interface CardGroupProps {
+    readonly items: readonly CardItem[];
+}
+/** 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;
+}
+/** A failure the person needs a way out of: a turn that failed before any reply, or no session to talk to. */
+interface FailureState {
+    /** `turn_failed`: a turn failed before any of its reply; `unavailable`: the backend gave no session, or none it could use. */
+    readonly kind: 'turn_failed' | 'unavailable';
+    /** Why: the turn's error `code` (`internal`, `timeout`, …), or the conversation's status (`unavailable`, `unauthorized`). */
+    readonly reason: string | null;
+    /** Try again, when it can be: the person's text again for a turn the server allows to retry, a new session otherwise. */
+    readonly retry: (() => void) | undefined;
+    /** The conversation, once a session named it: for your support records. */
+    readonly conversationId: string | null;
+}
+/** A slot for a failure (`components.Error`, `components.Unavailable`): the state, and the kit's own part to wrap. */
+interface FailureProps {
+    readonly state: FailureState;
+    readonly Default: ComponentType<{
+        readonly state: FailureState;
+    }>;
+}
+/** One action on every failure, drawn as a button by the kit's own parts: a person is always the way out. */
+interface FailureAction {
+    /** Default: the copy's `talkToPerson` ("Talk to a person"), in the person's language. */
+    readonly label?: string;
+    readonly onPress: (state: FailureState) => void;
+}
+
+declare function CardCarousel(props: CardGroupProps): react.JSX.Element;
+
 declare function CardFrame(props: {
     readonly label: string;
     readonly restored?: boolean;
     readonly children?: ReactNode;
     readonly testID?: string;
 }): react.JSX.Element;
+/** A rating in millionths as the locale writes it, one decimal: 4.8, or 4,8 in Spanish and Portuguese. */
+declare function ratingText(valuePpm: number, locale: string | undefined): string;
 
 interface CardProps {
     readonly card: HeldCard;
@@ -29,6 +108,14 @@ declare const CardView: react.NamedExoticComponent<{
 }>;
 
 declare function InfoCard(props: Omit<CardProps, 'Default'>): react.JSX.Element;
+/** A card's actions: a link that passes the deep-link rule opens the tenant's page, any other goes to the session. */
+declare function CardActions(props: Omit<CardProps, 'Default'>): react.JSX.Element | null;
+
+declare function LinksCard(props: Omit<CardProps, 'Default'>): react.JSX.Element;
+
+declare function ListingCard(props: Omit<CardProps, 'Default'>): react.JSX.Element;
+/** The first letters of the first two words: "Bell's Barber Lounge" is "BB". */
+declare function monogram(title: string): string;
 
 declare function NextStepCard(props: Omit<CardProps, 'Default'>): react.JSX.Element;
 
@@ -65,49 +152,6 @@ interface ButtonProps {
 }
 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>;
 
@@ -120,6 +164,11 @@ declare const Composer: react.NamedExoticComponent<{
 
 declare const DisclosureBar: react.NamedExoticComponent<object>;
 
+/** The tenant's failure action as a button, or nothing when there is none. */
+declare function FailureActionButton(props: {
+    readonly state: FailureState;
+}): ReactNode;
+
 declare function DefaultBubble(props: Omit<MessageBubbleProps, 'Default'>): react.JSX.Element;
 declare const MessageBubble: react.NamedExoticComponent<{
     readonly item: MessageItem;
@@ -134,17 +183,38 @@ declare const StreamingBubble: react.NamedExoticComponent<{
 
 /** Rows of one kind recycle together. */
 declare function itemType(item: TimelineItem): string;
+/**
+ * Runs of two or more consecutive cards with one carousel group (`group.layout: carousel`, the same `group.id`): by
+ * the first card's key, and the keys of the cards the run draws after it. A run equal to the previous one is the
+ * same array, so its row does not render again.
+ */
+declare function carousels(items: readonly TimelineItem[], previous: ReadonlyMap<string, readonly CardItem[]>): {
+    runs: Map<string, readonly CardItem[]>;
+    inside: Set<string>;
+};
 declare const Row: react.NamedExoticComponent<{
     readonly item: TimelineItem;
     readonly showAuthor: boolean;
+    /** The carousel this card starts (`components.CardGroup`). */
+    readonly run?: readonly CardItem[] | undefined;
+    /** A card a carousel earlier in the list draws. */
+    readonly inside?: boolean;
 }>;
 declare const MessageList: react.NamedExoticComponent<object>;
 
 declare const StatusBanner: react.NamedExoticComponent<object>;
+/** The kit's own "Couldn't connect." banner: try again, and the tenant's failure action when there is one. */
+declare function DefaultUnavailable(props: {
+    readonly state: FailureState;
+}): ReactNode;
 
 declare const SystemRow: react.NamedExoticComponent<{
     readonly item: SystemItem;
 }>;
+/** The kit's own failed-turn row: "Something went wrong.", and the tenant's failure action when there is one. */
+declare function DefaultTurnFailed(props: {
+    readonly state: FailureState;
+}): ReactNode;
 
 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. */
@@ -154,7 +224,10 @@ interface ChatHandlers {
      * 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. */
+    /**
+     * Open a card's link in your app: a deep link that already passed the deep-link rule (route by the page it names),
+     * or a `links` card's https page (your in-app browser; without this handler the system opens it).
+     */
     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;
@@ -162,6 +235,11 @@ interface ChatHandlers {
     readonly onPickPhoto?: (question: Question, card: HeldCard) => Promise<{
         readonly upload_ref: string;
     } | null>;
+    /**
+     * A way out on a failed turn and on "couldn't connect": a button with your label (default "Talk to a person"),
+     * drawn by the kit's own parts when no `components.Error` or `components.Unavailable` replaces them.
+     */
+    readonly failureAction?: FailureAction;
     /** Development warnings: a theme that is hard to read, copy that says "assistant". */
     readonly onWarning?: (message: string) => void;
 }
@@ -174,6 +252,15 @@ interface ChatSlots {
     readonly Image?: ComponentType<ImageProps>;
     /** A list with FlashList's props (LegendList works). Default: FlashList. */
     readonly ListComponent?: ComponentType<ListProps>;
+    /** A turn that failed before any reply: replaces the "Something went wrong." row. */
+    readonly Error?: ComponentType<FailureProps>;
+    /** No session to talk to: replaces the "Couldn't connect." banner. */
+    readonly Unavailable?: ComponentType<FailureProps>;
+    /**
+     * Draws a turn's cards that ask for a carousel (`group.layout: carousel`) in one row: the kit's `CardCarousel`, or
+     * yours. Without it they draw one under another. Opt-in, so an app that never draws a carousel does not ship one.
+     */
+    readonly CardGroup?: ComponentType<CardGroupProps>;
     /** Card renderers by kind (`professional`, `proposal`, …). */
     readonly cards?: Readonly<Partial<Record<string, ComponentType<CardProps>>>>;
 }
@@ -183,6 +270,10 @@ interface ChatContextValue {
     readonly slots: ChatSlots;
     readonly agentAvatar: string | undefined;
     readonly timeZone: string | undefined;
+    /** The failure action's label when there is one (`label` undefined: the copy's); `onPress` is read from `handlers`. */
+    readonly failureAction: {
+        readonly label: string | undefined;
+    } | null;
 }
 /** The conversation, handlers and slots; only inside `VinaverseChat` (or `VinaverseChatProvider`). */
 declare function useChat(): ChatContextValue;
@@ -250,6 +341,11 @@ declare function VinaverseChatProvider(props: Omit<VinaverseChatProps, 'hideHead
 }): ReactNode;
 declare function VinaverseChat(props: VinaverseChatProps): ReactNode;
 
+declare const Welcome: react.NamedExoticComponent<{
+    readonly welcome: Welcome$1;
+    readonly onChip: (message: string) => void;
+}>;
+
 /** The part of the conversation store the adapter drives. */
 interface LifecycleTarget {
     setForeground(foreground: boolean): void;
@@ -261,4 +357,4 @@ 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 };
+export { ActivityLine, Avatar, Button, type ButtonProps, CardActions, CardCarousel, CardFrame, type CardGroupProps, type CardProps, CardView, type ChatHandlers, ChatHeader, ChatSkeleton, type ChatSlots, type ColorSchemeSetting, Composer, type ComposerProps, DefaultBubble, DefaultComposer, DefaultHeader, DefaultTurnFailed, DefaultUnavailable, DisclosureBar, type EmptyStateProps, type FailureAction, FailureActionButton, type FailureProps, type FailureState, type HeaderProps, InfoCard, type LifecycleTarget, LinksCard, type ListProps, ListingCard, MessageBubble, type MessageBubbleProps, MessageList, NextStepCard, ProposalCard, type ProposalDecision, QuestionCard, Row, StatusBanner, StreamingBubble, SystemRow, type Theme, type ThemeOverrides, ThemeProvider, TimeSlotsCard, VinaverseChat, type VinaverseChatProps, VinaverseChatProvider, Welcome, announce, answerText, carousels, createTheme, defaultCard, fieldText, itemType, monogram, ratingText, themeProblems, useChat, useNativeLifecycle, useReducedMotion, useTheme };