@vinaverse/react-native 0.1.0-alpha.7 → 0.1.0-alpha.9

package/README.md

@@ -97,12 +97,13 @@ const imagePolicy = { hosts: ['images.example.com'], aspectRatio: 1.6, Placehold
   from. Every agent part asks the runtime to `sweep()` when the app comes back to the foreground. `AskAboutRow` is "ask the agent about this" on
   your own pages, decided once as the page draws, from the status already read: it is never added under a drawn page
   (an agent whose status arrives later shows from the next visit), and `appearance` gives it a tint (`background`) and the
-  `chevron` or none.
-- **Policies and adapters:** `imagePolicy` (photo hosts, frame, the stand-in for a missing photo) applies to every card
+  `chevron` or none, and `testID` its test id.
+- **Policies and adapters:** `imagePolicy` (photo hosts, frame, the stand-in for a missing photo, given the card's `title` and `kind`) applies to every card
   and every fetch ahead; `announce` reads finished replies and the greeting your way; `onChip` hears a tapped chip.
-  Card renderers get the card read once (`read`).
-- **Hooks** for your own parts: `useAgentConversation`, `useAgentStatus`, `useAgentFeatures`, `useAgentProfile`,
-  `useAgentName`, `useAgentLauncher`, `useAgentRuntime`.
+  Card renderers get the card read once (`read`). A listing with no rating draws `copy.ratingNone` in the rating's place (empty by default; "New", say).
+- **Hooks** for your own parts: `useAgentConversation`, `useAgentStatus`, `useAgentStatusState` (`{ status, reading,
+  failed }`: "still reading" apart from "could not read"), `useAgentFeatures`, `useAgentProfile`, `useAgentName`,
+  `useAgentLauncher`, `useAgentRuntime`.
 - **Events** for analytics through `onEvent`: sessions, ratings, chips, targets and links opened, the launcher shown,
   opened, greeted and its greeting closed.
 - **StrictMode, in development only:** React mounts, unmounts and mounts again, so a conversation still opening is let
@@ -168,9 +169,20 @@ What is lost without it: a screen that imports `/chat` statically, or anything t
 (about 13 kB of the kit, its cards and list) when that screen's module first runs; with inline requires, when it is
 first used. Nothing breaks either way, and the bundle is the same on iOS and Android.
 
-Metro resolves an ES `import` to the package's ES module build and a `require` to its CommonJS build: import the kit
-with `import` statements throughout (never a `require` beside them), so every part comes from one build. With tree
-shaking (Expo's production tree shaking, webpack, Rollup, esbuild) either way of importing costs the same.
+**One build under Metro.** Every `@vinaverse/*` entry lists the `react-native` condition first, which React Native's
+and Expo's Metro configs set for iOS and Android: Metro takes the CommonJS build for an `import`, a `require`, and a
+`require` Babel writes for you (an `export const X = ImportedBinding` becomes a getter that requires), so an app holds
+one copy of the kit and one of each React context. Before 0.1.0-alpha.8 an ES import and a require resolved to
+different builds, and a card drawn from the second found no chat around it; a `metro.config.js` that forces the `import`
+condition for `@vinaverse/*` is no longer needed (harmless if kept). Jest with jest-expo resolves the same CommonJS
+build, untransformed. Web bundlers (no `react-native` condition) take the ES module build for an import: import the kit
+with `import` statements there.
+
+**Size on iOS and Android comes from the per-part entries, not tree shaking.** Metro takes the CommonJS build there,
+which no tree shaking (Expo's production tree shaking included) can trim: a screen ships and runs every module of the
+entry it imports. So import by part (`/launcher`, `/ask`, `/chat`) to keep the kit's start-up work to the parts a
+screen draws. Tree shaking (webpack, Rollup, esbuild, Expo on the web) applies on the web only, where an import takes
+the ES module build.
 
 ## Peer dependencies
 
@@ -217,7 +229,7 @@ shaking (Expo's production tree shaking, webpack, Rollup, esbuild) either way of
 | `onCardAction(card, action)` | a card action without a link (also sent to the session) |
 | `onPickPhoto(question, card)` | a photo question: pick, upload to your backend, return `{ upload_ref }` |
 | `failureAction` | `{ label?, onPress(state) }`: a way out on a failed turn and on "couldn't connect" ([When the agent fails](#when-the-agent-fails)) |
-| `onWarning(message)` | development warnings: a hard-to-read theme, copy that says "assistant" |
+| `onWarning(message, { code })` | warnings for your logger, `code` one of `theme` (hard to read), `copy` (says "assistant"), `send_failed`, `answer_failed`, `proposal_failed`, `photo_failed`, so you count them without the text |
 
 ## When the agent fails
 
@@ -247,8 +259,13 @@ part as `Default`. With neither, the kit draws both as before.
 
 - **Professionals and spaces** draw as photo cards: the hero photo (through your `Image` slot, so `expo-image`'s cache
   applies), the name's monogram when there is none or it fails, rating with its count, "From $45" and the next open
-  time.
-- **A carousel** for the cards a turn draws together: add the kit's `CardCarousel`. Without it they draw one under
+  time, said as people say it ("Next: tomorrow, 10:00 AM"; `copy.today` and `copy.tomorrow`, else the date). The
+  photo frame is `imagePolicy.aspectRatio` (default 1.6); `'natural'` draws a card on its own in its photo's own
+  shape, held within `naturalAspect` (square to 2:1 by default), while a card in a carousel keeps the fixed frame.
+- **Bookings, services and every other card** show their `status` (a booking's "Confirmed") first among the badges,
+  and a tap opens what the card is about (its `ref`) through `onOpenTarget`, as a listing does.
+- **A carousel** for the cards a turn draws together: add the kit's `CardCarousel`. A turn's cards of one carousel
+  group join one row where the first of them is, even with another card between them. Without it they draw one under
   another; it is opt-in so an app that does not use it does not ship it.
 
   ```tsx

package/dist/ask.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkV6HHPE5K_cjs = require('./chunk-V6HHPE5K.cjs');
+var chunkNMKJ7LIJ_cjs = require('./chunk-NMKJ7LIJ.cjs');
 var chunk6QYDPGRS_cjs = require('./chunk-6QYDPGRS.cjs');
 var agent = require('@vinaverse/react/agent');
 
@@ -8,7 +8,7 @@ var agent = require('@vinaverse/react/agent');
 
 Object.defineProperty(exports, "AskAboutRow", {
   enumerable: true,
-  get: function () { return chunkV6HHPE5K_cjs.AskAboutRow; }
+  get: function () { return chunkNMKJ7LIJ_cjs.AskAboutRow; }
 });
 Object.defineProperty(exports, "ThemeProvider", {
   enumerable: true,

package/dist/ask.d.cts

@@ -30,6 +30,8 @@ interface AskAboutRowProps {
     readonly copy?: CopyOverrides;
     readonly theme?: ThemeOverrides;
     readonly colorScheme?: ColorSchemeSetting;
+    /** The row's test id. Default `vinaverse-ask-about`. */
+    readonly testID?: string;
 }
 declare function AskAboutRow(props: AskAboutRowProps): ReactNode;
 

package/dist/ask.d.ts

@@ -30,6 +30,8 @@ interface AskAboutRowProps {
     readonly copy?: CopyOverrides;
     readonly theme?: ThemeOverrides;
     readonly colorScheme?: ColorSchemeSetting;
+    /** The row's test id. Default `vinaverse-ask-about`. */
+    readonly testID?: string;
 }
 declare function AskAboutRow(props: AskAboutRowProps): ReactNode;
 

package/dist/ask.js

@@ -1,4 +1,4 @@
-export { AskAboutRow } from './chunk-NJ6ARGZS.js';
+export { AskAboutRow } from './chunk-7KPCO443.js';
 export { ThemeProvider, useTheme } from './chunk-EFEXTVIT.js';
 export { AgentRuntimeProvider, forgetGreeting, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
 //# sourceMappingURL=ask.js.map

package/dist/chat.cjs

@@ -1,241 +1,245 @@
 'use strict';
 
-var chunkAGZ7IH7E_cjs = require('./chunk-AGZ7IH7E.cjs');
+var chunkV7XYOLLT_cjs = require('./chunk-V7XYOLLT.cjs');
 var chunk6QYDPGRS_cjs = require('./chunk-6QYDPGRS.cjs');
 
 
 
 Object.defineProperty(exports, "ActivityLine", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.ActivityLine; }
+  get: function () { return chunkV7XYOLLT_cjs.ActivityLine; }
 });
 Object.defineProperty(exports, "AgentChat", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.AgentChat; }
+  get: function () { return chunkV7XYOLLT_cjs.AgentChat; }
 });
 Object.defineProperty(exports, "AgentFooter", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.AgentFooter; }
+  get: function () { return chunkV7XYOLLT_cjs.AgentFooter; }
 });
 Object.defineProperty(exports, "AgentRuntimeProvider", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.AgentRuntimeProvider; }
+  get: function () { return chunkV7XYOLLT_cjs.AgentRuntimeProvider; }
 });
 Object.defineProperty(exports, "Avatar", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.Avatar; }
+  get: function () { return chunkV7XYOLLT_cjs.Avatar; }
 });
 Object.defineProperty(exports, "Button", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.Button; }
+  get: function () { return chunkV7XYOLLT_cjs.Button; }
 });
 Object.defineProperty(exports, "CardActions", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.CardActions; }
+  get: function () { return chunkV7XYOLLT_cjs.CardActions; }
 });
 Object.defineProperty(exports, "CardCarousel", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.CardCarousel; }
+  get: function () { return chunkV7XYOLLT_cjs.CardCarousel; }
 });
 Object.defineProperty(exports, "CardFrame", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.CardFrame; }
+  get: function () { return chunkV7XYOLLT_cjs.CardFrame; }
 });
 Object.defineProperty(exports, "CardView", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.CardView; }
+  get: function () { return chunkV7XYOLLT_cjs.CardView; }
 });
 Object.defineProperty(exports, "ChatHeader", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.ChatHeader; }
+  get: function () { return chunkV7XYOLLT_cjs.ChatHeader; }
 });
 Object.defineProperty(exports, "ChatSkeleton", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.ChatSkeleton; }
+  get: function () { return chunkV7XYOLLT_cjs.ChatSkeleton; }
 });
 Object.defineProperty(exports, "Composer", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.Composer; }
+  get: function () { return chunkV7XYOLLT_cjs.Composer; }
 });
 Object.defineProperty(exports, "DefaultBubble", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.DefaultBubble; }
+  get: function () { return chunkV7XYOLLT_cjs.DefaultBubble; }
 });
 Object.defineProperty(exports, "DefaultComposer", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.DefaultComposer; }
+  get: function () { return chunkV7XYOLLT_cjs.DefaultComposer; }
 });
 Object.defineProperty(exports, "DefaultEnded", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.DefaultEnded; }
+  get: function () { return chunkV7XYOLLT_cjs.DefaultEnded; }
 });
 Object.defineProperty(exports, "DefaultHeader", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.DefaultHeader; }
+  get: function () { return chunkV7XYOLLT_cjs.DefaultHeader; }
 });
 Object.defineProperty(exports, "DefaultTurnFailed", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.DefaultTurnFailed; }
+  get: function () { return chunkV7XYOLLT_cjs.DefaultTurnFailed; }
 });
 Object.defineProperty(exports, "DefaultUnavailable", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.DefaultUnavailable; }
+  get: function () { return chunkV7XYOLLT_cjs.DefaultUnavailable; }
 });
 Object.defineProperty(exports, "DefaultUnavailableScreen", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.DefaultUnavailableScreen; }
+  get: function () { return chunkV7XYOLLT_cjs.DefaultUnavailableScreen; }
 });
 Object.defineProperty(exports, "DefaultUnreachable", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.DefaultUnreachable; }
+  get: function () { return chunkV7XYOLLT_cjs.DefaultUnreachable; }
 });
 Object.defineProperty(exports, "DisclosureBar", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.DisclosureBar; }
+  get: function () { return chunkV7XYOLLT_cjs.DisclosureBar; }
 });
 Object.defineProperty(exports, "FailureActionButton", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.FailureActionButton; }
+  get: function () { return chunkV7XYOLLT_cjs.FailureActionButton; }
 });
 Object.defineProperty(exports, "InfoCard", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.InfoCard; }
+  get: function () { return chunkV7XYOLLT_cjs.InfoCard; }
 });
 Object.defineProperty(exports, "LinksCard", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.LinksCard; }
+  get: function () { return chunkV7XYOLLT_cjs.LinksCard; }
 });
 Object.defineProperty(exports, "ListingCard", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.ListingCard; }
+  get: function () { return chunkV7XYOLLT_cjs.ListingCard; }
 });
 Object.defineProperty(exports, "MessageBubble", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.MessageBubble; }
+  get: function () { return chunkV7XYOLLT_cjs.MessageBubble; }
 });
 Object.defineProperty(exports, "MessageList", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.MessageList; }
+  get: function () { return chunkV7XYOLLT_cjs.MessageList; }
 });
 Object.defineProperty(exports, "NextStepCard", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.NextStepCard; }
+  get: function () { return chunkV7XYOLLT_cjs.NextStepCard; }
 });
 Object.defineProperty(exports, "ProposalCard", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.ProposalCard; }
+  get: function () { return chunkV7XYOLLT_cjs.ProposalCard; }
 });
 Object.defineProperty(exports, "QuestionCard", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.QuestionCard; }
+  get: function () { return chunkV7XYOLLT_cjs.QuestionCard; }
 });
 Object.defineProperty(exports, "Row", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.Row; }
+  get: function () { return chunkV7XYOLLT_cjs.Row; }
 });
 Object.defineProperty(exports, "StatusBanner", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.StatusBanner; }
+  get: function () { return chunkV7XYOLLT_cjs.StatusBanner; }
 });
 Object.defineProperty(exports, "StreamingBubble", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.StreamingBubble; }
+  get: function () { return chunkV7XYOLLT_cjs.StreamingBubble; }
 });
 Object.defineProperty(exports, "SystemRow", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.SystemRow; }
+  get: function () { return chunkV7XYOLLT_cjs.SystemRow; }
 });
 Object.defineProperty(exports, "TimeSlotsCard", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.TimeSlotsCard; }
+  get: function () { return chunkV7XYOLLT_cjs.TimeSlotsCard; }
 });
 Object.defineProperty(exports, "VinaverseChat", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.VinaverseChat; }
+  get: function () { return chunkV7XYOLLT_cjs.VinaverseChat; }
 });
 Object.defineProperty(exports, "VinaverseChatProvider", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.VinaverseChatProvider; }
+  get: function () { return chunkV7XYOLLT_cjs.VinaverseChatProvider; }
 });
 Object.defineProperty(exports, "Welcome", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.Welcome; }
+  get: function () { return chunkV7XYOLLT_cjs.Welcome; }
 });
 Object.defineProperty(exports, "allowedImage", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.allowedImage; }
+  get: function () { return chunkV7XYOLLT_cjs.allowedImage; }
 });
 Object.defineProperty(exports, "answerText", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.answerText; }
+  get: function () { return chunkV7XYOLLT_cjs.answerText; }
 });
 Object.defineProperty(exports, "carousels", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.carousels; }
+  get: function () { return chunkV7XYOLLT_cjs.carousels; }
 });
 Object.defineProperty(exports, "defaultCard", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.defaultCard; }
+  get: function () { return chunkV7XYOLLT_cjs.defaultCard; }
 });
 Object.defineProperty(exports, "fieldText", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.fieldText; }
+  get: function () { return chunkV7XYOLLT_cjs.fieldText; }
 });
 Object.defineProperty(exports, "forgetGreeting", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.forgetGreeting; }
+  get: function () { return chunkV7XYOLLT_cjs.forgetGreeting; }
 });
 Object.defineProperty(exports, "greetedKey", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.greetedKey; }
+  get: function () { return chunkV7XYOLLT_cjs.greetedKey; }
 });
 Object.defineProperty(exports, "itemType", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.itemType; }
+  get: function () { return chunkV7XYOLLT_cjs.itemType; }
 });
 Object.defineProperty(exports, "monogram", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.monogram; }
+  get: function () { return chunkV7XYOLLT_cjs.monogram; }
 });
 Object.defineProperty(exports, "newestWholeReply", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.newestWholeReply; }
+  get: function () { return chunkV7XYOLLT_cjs.newestWholeReply; }
 });
 Object.defineProperty(exports, "ratingText", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.ratingText; }
+  get: function () { return chunkV7XYOLLT_cjs.ratingText; }
 });
 Object.defineProperty(exports, "useAgentConversation", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.useAgentConversation; }
+  get: function () { return chunkV7XYOLLT_cjs.useAgentConversation; }
 });
 Object.defineProperty(exports, "useAgentFeatures", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.useAgentFeatures; }
+  get: function () { return chunkV7XYOLLT_cjs.useAgentFeatures; }
 });
 Object.defineProperty(exports, "useAgentLauncher", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.useAgentLauncher; }
+  get: function () { return chunkV7XYOLLT_cjs.useAgentLauncher; }
 });
 Object.defineProperty(exports, "useAgentName", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.useAgentName; }
+  get: function () { return chunkV7XYOLLT_cjs.useAgentName; }
 });
 Object.defineProperty(exports, "useAgentProfile", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.useAgentProfile; }
+  get: function () { return chunkV7XYOLLT_cjs.useAgentProfile; }
 });
 Object.defineProperty(exports, "useAgentRuntime", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.useAgentRuntime; }
+  get: function () { return chunkV7XYOLLT_cjs.useAgentRuntime; }
 });
 Object.defineProperty(exports, "useAgentStatus", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.useAgentStatus; }
+  get: function () { return chunkV7XYOLLT_cjs.useAgentStatus; }
+});
+Object.defineProperty(exports, "useAgentStatusState", {
+  enumerable: true,
+  get: function () { return chunkV7XYOLLT_cjs.useAgentStatusState; }
 });
 Object.defineProperty(exports, "useChat", {
   enumerable: true,
-  get: function () { return chunkAGZ7IH7E_cjs.useChat; }
+  get: function () { return chunkV7XYOLLT_cjs.useChat; }
 });
 Object.defineProperty(exports, "ThemeProvider", {
   enumerable: true,

package/dist/chat.d.cts

@@ -1,4 +1,4 @@
-export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, forgetGreeting, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
+export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, forgetGreeting, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus, useAgentStatusState } from '@vinaverse/react/agent';
 import * as react from 'react';
 import { ComponentType, ReactElement, ReactNode, RefObject } from 'react';
 import * as _vinaverse_client_conversation from '@vinaverse/client/conversation';
@@ -106,6 +106,8 @@ interface CardProps {
     readonly busy: boolean;
     /** Restored after a restart: draw it as it was, taking no answer or action. */
     readonly restored: boolean;
+    /** Drawn inside a carousel with its group: a photo keeps the policy's fixed frame, so the row stays even. */
+    readonly grouped?: boolean;
     /** The kit's own renderer for this kind, to wrap rather than rewrite. */
     readonly Default: ComponentType<Omit<CardProps, 'Default'>>;
 }
@@ -114,6 +116,8 @@ interface CardProps {
 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;
@@ -142,6 +146,10 @@ declare const ActivityLine: react.NamedExoticComponent<object>;
 
 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. */
+/** What a chat warning is about. */
+interface ChatWarning {
+    readonly code: 'theme' | 'copy' | 'send_failed' | 'answer_failed' | 'proposal_failed' | 'photo_failed';
+}
 interface ChatHandlers {
     /**
      * The person confirmed or declined a proposal: call your backend with the person's own token, then say what
@@ -164,8 +172,11 @@ interface ChatHandlers {
      * 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;
+    /**
+     * Warnings for the app's logger: a theme that is hard to read, copy that says "assistant", a send, an answer, a
+     * proposal or a photo pick that failed. `warning.code` says which, so a logger counts them without the text.
+     */
+    readonly onWarning?: (message: string, warning: ChatWarning) => void;
     /**
      * The person tapped a card about something of yours (its `ref`: a professional, a space, a booking): open its page
      * with your router. Without it, only the card's own actions open anything.
@@ -182,11 +193,24 @@ interface ChatHandlers {
 interface ImagePolicy {
     /** Hosts a photo may come from (exact names); default any https host. */
     readonly hosts?: readonly string[];
-    /** Width / height of a listing's photo frame. Default 1.6 (16:10). */
-    readonly aspectRatio?: number;
-    /** What stands in for a missing, refused or failed photo. Default the name's monogram. */
+    /**
+     * Width / height of a listing's photo frame. Default 1.6 (16:10). `natural`: a card on its own takes its photo's
+     * own shape (its `width` and `height`), held within `naturalAspect`; a card in a carousel keeps 1.6, so the row
+     * stays even, and a photo without its size too.
+     */
+    readonly aspectRatio?: number | 'natural';
+    /** The shapes a `natural` photo is held within. Default square to 2:1 (`{ min: 1, max: 2 }`). */
+    readonly naturalAspect?: {
+        readonly min: number;
+        readonly max: number;
+    };
+    /**
+     * What stands in for a missing, refused or failed photo, by the card's `kind` (a person's tile, a space's tile).
+     * Default the name's monogram.
+     */
     readonly Placeholder?: ComponentType<{
         readonly title: string;
+        readonly kind: string;
     }>;
 }
 /** Parts a tenant can replace. Each gets the default's props and the default itself (`Default`), to wrap it. */
@@ -410,9 +434,10 @@ 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.
+ * 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[]>;
@@ -458,4 +483,4 @@ 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, CardCarousel, CardFrame, type CardGroupProps, type CardProps, CardView, type ChatHandlers, ChatHeader, ChatSkeleton, type ChatSlots, type Chip, ColorSchemeSetting, Composer, type ComposerProps, DefaultBubble, DefaultComposer, DefaultEnded, DefaultHeader, DefaultTurnFailed, DefaultUnavailable, DefaultUnavailableScreen, DefaultUnreachable, DisclosureBar, type EmptyStateProps, type FailureAction, FailureActionButton, type FailureProps, type FailureState, type HeaderProps, type ImagePolicy, InfoCard, type LifecycleTarget, LinksCard, type ListProps, ListingCard, MessageBubble, type MessageBubbleProps, MessageList, NextStepCard, ProposalCard, type ProposalDecision, QuestionCard, Row, StatusBanner, StreamingBubble, SystemRow, ThemeOverrides, TimeSlotsCard, VinaverseChat, type VinaverseChatProps, VinaverseChatProvider, Welcome, allowedImage, announce, answerText, carousels, defaultCard, fieldText, itemType, monogram, newestWholeReply, ratingText, useChat, useNativeLifecycle, useReducedMotion };
+export { ActivityLine, AgentChat, type AgentChatProps, type AgentChatSlots, type AgentEndedProps, AgentFooter, type AgentFooterProps, type AgentUnavailableScreenProps, type AgentUnreachableProps, Avatar, Button, type ButtonProps, CardActions, CardCarousel, CardFrame, type CardGroupProps, type CardProps, CardView, type ChatHandlers, ChatHeader, ChatSkeleton, type ChatSlots, type ChatWarning, type Chip, ColorSchemeSetting, Composer, type ComposerProps, DefaultBubble, DefaultComposer, DefaultEnded, DefaultHeader, DefaultTurnFailed, DefaultUnavailable, DefaultUnavailableScreen, DefaultUnreachable, DisclosureBar, type EmptyStateProps, type FailureAction, FailureActionButton, type FailureProps, type FailureState, type HeaderProps, type ImagePolicy, InfoCard, type LifecycleTarget, LinksCard, type ListProps, ListingCard, MessageBubble, type MessageBubbleProps, MessageList, NextStepCard, ProposalCard, type ProposalDecision, QuestionCard, Row, StatusBanner, StreamingBubble, SystemRow, ThemeOverrides, TimeSlotsCard, VinaverseChat, type VinaverseChatProps, VinaverseChatProvider, Welcome, allowedImage, announce, answerText, carousels, defaultCard, fieldText, itemType, monogram, newestWholeReply, ratingText, useChat, useNativeLifecycle, useReducedMotion };

package/dist/chat.d.ts

@@ -1,4 +1,4 @@
-export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, forgetGreeting, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
+export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, forgetGreeting, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus, useAgentStatusState } from '@vinaverse/react/agent';
 import * as react from 'react';
 import { ComponentType, ReactElement, ReactNode, RefObject } from 'react';
 import * as _vinaverse_client_conversation from '@vinaverse/client/conversation';
@@ -106,6 +106,8 @@ interface CardProps {
     readonly busy: boolean;
     /** Restored after a restart: draw it as it was, taking no answer or action. */
     readonly restored: boolean;
+    /** Drawn inside a carousel with its group: a photo keeps the policy's fixed frame, so the row stays even. */
+    readonly grouped?: boolean;
     /** The kit's own renderer for this kind, to wrap rather than rewrite. */
     readonly Default: ComponentType<Omit<CardProps, 'Default'>>;
 }
@@ -114,6 +116,8 @@ interface CardProps {
 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;
@@ -142,6 +146,10 @@ declare const ActivityLine: react.NamedExoticComponent<object>;
 
 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. */
+/** What a chat warning is about. */
+interface ChatWarning {
+    readonly code: 'theme' | 'copy' | 'send_failed' | 'answer_failed' | 'proposal_failed' | 'photo_failed';
+}
 interface ChatHandlers {
     /**
      * The person confirmed or declined a proposal: call your backend with the person's own token, then say what
@@ -164,8 +172,11 @@ interface ChatHandlers {
      * 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;
+    /**
+     * Warnings for the app's logger: a theme that is hard to read, copy that says "assistant", a send, an answer, a
+     * proposal or a photo pick that failed. `warning.code` says which, so a logger counts them without the text.
+     */
+    readonly onWarning?: (message: string, warning: ChatWarning) => void;
     /**
      * The person tapped a card about something of yours (its `ref`: a professional, a space, a booking): open its page
      * with your router. Without it, only the card's own actions open anything.
@@ -182,11 +193,24 @@ interface ChatHandlers {
 interface ImagePolicy {
     /** Hosts a photo may come from (exact names); default any https host. */
     readonly hosts?: readonly string[];
-    /** Width / height of a listing's photo frame. Default 1.6 (16:10). */
-    readonly aspectRatio?: number;
-    /** What stands in for a missing, refused or failed photo. Default the name's monogram. */
+    /**
+     * Width / height of a listing's photo frame. Default 1.6 (16:10). `natural`: a card on its own takes its photo's
+     * own shape (its `width` and `height`), held within `naturalAspect`; a card in a carousel keeps 1.6, so the row
+     * stays even, and a photo without its size too.
+     */
+    readonly aspectRatio?: number | 'natural';
+    /** The shapes a `natural` photo is held within. Default square to 2:1 (`{ min: 1, max: 2 }`). */
+    readonly naturalAspect?: {
+        readonly min: number;
+        readonly max: number;
+    };
+    /**
+     * What stands in for a missing, refused or failed photo, by the card's `kind` (a person's tile, a space's tile).
+     * Default the name's monogram.
+     */
     readonly Placeholder?: ComponentType<{
         readonly title: string;
+        readonly kind: string;
     }>;
 }
 /** Parts a tenant can replace. Each gets the default's props and the default itself (`Default`), to wrap it. */
@@ -410,9 +434,10 @@ 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.
+ * 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[]>;
@@ -458,4 +483,4 @@ 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, CardCarousel, CardFrame, type CardGroupProps, type CardProps, CardView, type ChatHandlers, ChatHeader, ChatSkeleton, type ChatSlots, type Chip, ColorSchemeSetting, Composer, type ComposerProps, DefaultBubble, DefaultComposer, DefaultEnded, DefaultHeader, DefaultTurnFailed, DefaultUnavailable, DefaultUnavailableScreen, DefaultUnreachable, DisclosureBar, type EmptyStateProps, type FailureAction, FailureActionButton, type FailureProps, type FailureState, type HeaderProps, type ImagePolicy, InfoCard, type LifecycleTarget, LinksCard, type ListProps, ListingCard, MessageBubble, type MessageBubbleProps, MessageList, NextStepCard, ProposalCard, type ProposalDecision, QuestionCard, Row, StatusBanner, StreamingBubble, SystemRow, ThemeOverrides, TimeSlotsCard, VinaverseChat, type VinaverseChatProps, VinaverseChatProvider, Welcome, allowedImage, announce, answerText, carousels, defaultCard, fieldText, itemType, monogram, newestWholeReply, ratingText, useChat, useNativeLifecycle, useReducedMotion };
+export { ActivityLine, AgentChat, type AgentChatProps, type AgentChatSlots, type AgentEndedProps, AgentFooter, type AgentFooterProps, type AgentUnavailableScreenProps, type AgentUnreachableProps, Avatar, Button, type ButtonProps, CardActions, CardCarousel, CardFrame, type CardGroupProps, type CardProps, CardView, type ChatHandlers, ChatHeader, ChatSkeleton, type ChatSlots, type ChatWarning, type Chip, ColorSchemeSetting, Composer, type ComposerProps, DefaultBubble, DefaultComposer, DefaultEnded, DefaultHeader, DefaultTurnFailed, DefaultUnavailable, DefaultUnavailableScreen, DefaultUnreachable, DisclosureBar, type EmptyStateProps, type FailureAction, FailureActionButton, type FailureProps, type FailureState, type HeaderProps, type ImagePolicy, InfoCard, type LifecycleTarget, LinksCard, type ListProps, ListingCard, MessageBubble, type MessageBubbleProps, MessageList, NextStepCard, ProposalCard, type ProposalDecision, QuestionCard, Row, StatusBanner, StreamingBubble, SystemRow, ThemeOverrides, TimeSlotsCard, VinaverseChat, type VinaverseChatProps, VinaverseChatProvider, Welcome, allowedImage, announce, answerText, carousels, defaultCard, fieldText, itemType, monogram, newestWholeReply, ratingText, useChat, useNativeLifecycle, useReducedMotion };

package/dist/chat.js

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