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

package/dist/chat.d.ts

@@ -0,0 +1,292 @@
+export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, forgetGreeting, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus, useAgentStatusState } from '@vinaverse/react/agent';
+import { b as CardProps, c as ChatHandlers, d as ChatSlots, g as Chip, I as ImagePolicy, H as HeaderProps, h as ComposerProps, j as FailureState, M as MessageBubbleProps } from './context-gHCLFsJh.js';
+export { C as CardCarousel, a as CardGroupProps, e as ChatStore, f as ChatWarning, E as EmptyStateProps, F as FailureAction, i as FailureProps, L as ListProps, P as ProposalDecision, u as useChat } from './context-gHCLFsJh.js';
+import * as react from 'react';
+import { ReactNode, ComponentType } from 'react';
+import * as _vinaverse_client_conversation from '@vinaverse/client/conversation';
+import { CardItem, Question, ConversationStore, MessageItem, TimelineItem, SystemItem, Welcome as Welcome$1 } from '@vinaverse/client/conversation';
+import { AgentKey, AgentPlace, AgentEntryPoint, AgentFailureReason, AgentRating } from '@vinaverse/client/agent';
+import { CopyOverrides } from '@vinaverse/react';
+import { StyleProp, ViewStyle } from 'react-native';
+import { a as ThemeOverrides, C as ColorSchemeSetting } from './theme-BhiEGv64.js';
+export { T as Theme, b as ThemeProvider, c as createTheme, t as themeProblems, u as useTheme } from './theme-BhiEGv64.js';
+import '@vinaverse/tokens';
+
+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;
+/** A photo the image policy allows: https, and from one of its hosts when it names them. */
+declare function allowedImage(url: string | undefined, hosts: readonly string[] | undefined): string | null;
+
+/** 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;
+    /** Inside a carousel (`CardCarousel`). */
+    readonly grouped?: boolean;
+}>;
+
+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;
+
+/** 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>;
+
+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>;
+    /** Chips for an empty conversation when the session brings no welcome (`Session.welcome` comes first). Keep stable. */
+    readonly starters?: readonly Chip[];
+    /** Which card photos are drawn, their frame, and what stands in for one that is not. Keep stable. */
+    readonly imagePolicy?: ImagePolicy;
+    /** One chip above the composer: a question about where the person now is (`AgentChat` offers it when they moved). */
+    readonly suggestion?: Chip | null;
+    /** The suggestion chip's test id. Default `vinaverse-suggestion`. */
+    readonly suggestionTestID?: string;
+    /** Drawn under the composer, inside the kit's providers (`AgentChat`'s thumbs and footer). */
+    readonly footer?: ReactNode;
+}
+/** The providers alone, for a tenant composing its own layout from the exported parts. */
+declare function VinaverseChatProvider(props: Omit<VinaverseChatProps, 'hideHeader' | 'keyboardVerticalOffset' | 'keyboardBehavior' | 'style' | 'suggestion' | 'suggestionTestID' | 'footer'> & {
+    readonly children?: ReactNode;
+}): ReactNode;
+declare function VinaverseChat(props: VinaverseChatProps): ReactNode;
+
+/**
+ * The full-screen states (`Ended`, `Unreachable`, `UnavailableScreen`) are slots: each gets everything its screen
+ * needs (why, the actions, a person to contact) and the kit's own part as `Default`, so an app replaces the layout and
+ * the words entirely, or only the words through `copy`.
+ */
+interface AgentEndedProps {
+    readonly onStartNew: () => void;
+    /** Why: `ended`, `not_found`, `expired`, `mismatch`, `completed`. */
+    readonly reason: AgentFailureReason | null;
+    /** The API's code (`conversation_not_found`, `conversation_expired`), when it gave one. */
+    readonly code: string | null;
+    /** A person instead (the chat's `onContact`); absent when the app gave none. */
+    readonly onContact: (() => void) | undefined;
+}
+/** No agent here: switched off for this tenant, mode or person, or the backend refused the session. */
+interface AgentUnavailableScreenProps {
+    /** Why: `off`, `auth`, `invalid_session`, … */
+    readonly reason: AgentFailureReason | null;
+    readonly code: string | null;
+    /** A person instead (the chat's `onContact`); absent when the app gave none. */
+    readonly onContact: (() => void) | undefined;
+    /** Ask again (after a sign-in, or the agent switched back on). */
+    readonly onRetry: () => void;
+}
+interface AgentUnreachableProps {
+    readonly onRetry: () => void;
+    /** Why: `network`, `server`, `rate_limited`, … */
+    readonly reason: AgentFailureReason | null;
+    /** A person instead (the chat's `onContact`); absent when the app gave none. */
+    readonly onContact: (() => void) | undefined;
+}
+/** A slot gets the kit's own part as `Default`, to wrap rather than rewrite. */
+type Slot<P> = ComponentType<P & {
+    readonly Default: ComponentType<P>;
+}>;
+interface AgentFooterProps {
+    /** The newest whole reply's turn, to rate; null when there is none or it was restored from before. */
+    readonly turnId: string | null;
+    readonly rating: AgentRating | undefined;
+    readonly onRate: (rating: AgentRating) => void;
+    readonly onOpenPrivacy: (() => void) | undefined;
+}
+interface AgentChatSlots extends ChatSlots {
+    readonly Ended?: Slot<AgentEndedProps>;
+    readonly Unreachable?: Slot<AgentUnreachableProps>;
+    /**
+     * The whole screen when there is no agent (off, or the session refused). Not `Unavailable`: that is the chat's own
+     * "couldn't connect" banner, still drawn for a session that drops.
+     */
+    readonly UnavailableScreen?: Slot<AgentUnavailableScreenProps>;
+    /** Under the composer; null hides it. Default: thumbs on the newest whole reply, and the privacy link. */
+    readonly Footer?: Slot<AgentFooterProps> | null;
+}
+interface AgentChatProps extends Omit<VinaverseChatProps, 'conversation' | 'components' | 'suggestion' | 'suggestionTestID' | 'footer'> {
+    /** Whose conversation: one per person, mode, business and thread. */
+    readonly agentKey: AgentKey;
+    /** Where the person asks from, told to the agent as a session opens. */
+    readonly place?: AgentPlace | null;
+    /** How the person came in: `launcher` and `ask` from the kit's parts, `deep_link`, or the app's own words. */
+    readonly entryPoint?: AgentEntryPoint | null;
+    /** The question about this place, offered when the session was told another one (`moved`). */
+    readonly askAbout?: string | null;
+    /** A person: offered on a failed turn, "couldn't connect" and no agent. */
+    readonly onContact?: () => void;
+    readonly onOpenPrivacy?: () => void;
+    /** The agent's name until the session or the status gives one. */
+    readonly agentName?: string;
+    /**
+     * A first question for a flow that asks for itself (setting a business up): a chip the person taps, offered until they
+     * say anything. Never sent in their name: what the transcript shows as theirs, they typed or tapped.
+     */
+    readonly opener?: Chip | null;
+    /** The opener chip's test id. Default `vinaverse-opener`. */
+    readonly openerTestID?: string;
+    readonly components?: AgentChatSlots;
+}
+declare function AgentChat(props: AgentChatProps): ReactNode;
+/** The newest reply when it came whole (not cut off, not a refusal): the one to rate. */
+declare function newestWholeReply(view: {
+    readonly items: readonly _vinaverse_client_conversation.TimelineItem[];
+}): string | null;
+/** The conversation is over: a new one starts only when the person asks. */
+declare function DefaultEnded(props: AgentEndedProps): ReactNode;
+/** No agent here: says so, and offers a person when the app has one. */
+declare function DefaultUnavailableScreen(props: AgentUnavailableScreenProps): ReactNode;
+/** The app's backend could not be reached, after its tries: try again. */
+declare function DefaultUnreachable(props: AgentUnreachableProps): ReactNode;
+/** Thumbs on the newest whole reply (thanks once given), and the privacy link. */
+declare function AgentFooter(props: AgentFooterProps): ReactNode;
+
+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>;
+
+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>;
+
+/** 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;
+    /** 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;
+/**
+ * Carousel groups of two or more cards (`group.layout: carousel`, the same `group.id` in the same turn), wherever in
+ * the turn they arrive, another card or a message between them included: drawn as one row where the group's first
+ * card is, by that card's key, with the keys of the cards the row draws after it. A row equal to the previous one is
+ * the same array, so it 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;
+
+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;
+}
+/** 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, AgentChat, type AgentChatProps, type AgentChatSlots, type AgentEndedProps, AgentFooter, type AgentFooterProps, type AgentUnavailableScreenProps, type AgentUnreachableProps, Avatar, Button, type ButtonProps, CardActions, CardFrame, CardProps, CardView, ChatHandlers, ChatHeader, ChatSkeleton, ChatSlots, Chip, ColorSchemeSetting, Composer, ComposerProps, DefaultBubble, DefaultComposer, DefaultEnded, DefaultHeader, DefaultTurnFailed, DefaultUnavailable, DefaultUnavailableScreen, DefaultUnreachable, DisclosureBar, FailureActionButton, FailureState, HeaderProps, ImagePolicy, InfoCard, type LifecycleTarget, LinksCard, ListingCard, MessageBubble, MessageBubbleProps, MessageList, NextStepCard, ProposalCard, QuestionCard, Row, StatusBanner, StreamingBubble, SystemRow, ThemeOverrides, TimeSlotsCard, VinaverseChat, type VinaverseChatProps, VinaverseChatProvider, Welcome, allowedImage, announce, answerText, carousels, defaultCard, fieldText, itemType, monogram, newestWholeReply, ratingText, useNativeLifecycle, useReducedMotion };

package/dist/chat.js

@@ -0,0 +1,5 @@
+export { AgentChat, AgentFooter, AgentRuntimeProvider, Composer, DefaultComposer, DefaultEnded, DefaultUnavailable, DefaultUnavailableScreen, DefaultUnreachable, StatusBanner, VinaverseChat, VinaverseChatProvider, forgetGreeting, greetedKey, newestWholeReply, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus, useAgentStatusState } from './chunk-2J2LIJLW.js';
+export { ActivityLine, Avatar, Button, CardActions, CardCarousel, CardFrame, CardView, ChatHeader, ChatSkeleton, DefaultBubble, DefaultHeader, DefaultTurnFailed, DisclosureBar, FailureActionButton, InfoCard, LinksCard, ListingCard, MessageBubble, MessageList, NextStepCard, ProposalCard, QuestionCard, Row, StreamingBubble, SystemRow, TimeSlotsCard, Welcome, allowedImage, answerText, carousels, defaultCard, fieldText, itemType, monogram, ratingText, useChat } from './chunk-KSHDF3MG.js';
+export { ThemeProvider, announce, createTheme, themeProblems, useNativeLifecycle, useReducedMotion, useTheme } from './chunk-EFEXTVIT.js';
+//# sourceMappingURL=chat.js.map
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chat.js"}