@vinaverse/react-native 0.1.0-alpha.5 → 0.1.0-alpha.6

package/README.md

@@ -41,7 +41,9 @@ out of reach, status, name, ratings and sign-out are the runtime's.
 
 ```tsx
 import { createAgentRuntime } from '@vinaverse/client/agent';
-import { AgentChat, AgentLauncher, AgentRuntimeProvider, AskAboutRow, CardCarousel } from '@vinaverse/react-native';
+import { AgentChat, CardCarousel } from '@vinaverse/react-native/chat';
+import { AgentLauncher, AgentRuntimeProvider } from '@vinaverse/react-native/launcher';
+import { AskAboutRow } from '@vinaverse/react-native/ask';
 
 const agent = createAgentRuntime({ backend: { openSession, refreshSecret, status }, conversation: { locale } });
 const components = { CardGroup: CardCarousel, Image: ExpoImage }; // module level: stable
@@ -108,6 +110,60 @@ npm install @vinaverse/react-native@alpha @vinaverse/client@alpha @shopify/flash
 Alphas are published under the `alpha` tag. Keep every `@vinaverse/*` package on the same version, so your app and the
 kit share one copy of `@vinaverse/client`.
 
+**Import by part.** The package has an entry per part: `@vinaverse/react-native/chat` (the conversation, `AgentChat`,
+`VinaverseChat`, cards, theme), `/launcher` (`AgentLauncher` and its parts) and `/ask` (`AskAboutRow`). The launcher and
+the ask row each re-export the runtime bindings (`AgentRuntimeProvider`, the hooks) and the theme. The entries share
+their modules, so two of them still mean one theme and one chat context. `@vinaverse/react-native` itself still exports
+everything.
+
+What it buys, honestly. Metro without tree shaking (its default) puts every module an app imports statically, anywhere,
+into the one bundle it writes for iOS or Android. Measured on the kit alone (minified, brotli, peers excluded):
+
+| The app imports | Ships |
+|---|---|
+| `@vinaverse/react-native` | 14.9 kB |
+| `/launcher` and `/ask`, no chat screen | 2.9 kB |
+| `/launcher`, `/ask` and `/chat` (a chat screen anywhere) | 15.1 kB |
+
+- **The bundle** shrinks only for an app that never imports `/chat`. An app with a chat screen ships the whole kit
+  whichever way it imports it; the separate entries add about 0.1 kB.
+- **Start-up** is where an app with a chat screen gains: a screen that imports only `/launcher` runs the kit's 2.5 kB
+  of launcher code when it loads, not all 15 kB (with `@vinaverse/react-native`, using the launcher loads every part).
+  Inline requires (`inlineRequires`) defer a module until its first use, but they do not split the kit's own entry:
+  only the per-part imports do.
+- **Both** need the chat screen loaded lazily (`React.lazy`, or Expo Router's async routes). On iOS and Android a
+  production Metro bundle is still one file, so lazy loading defers when the chat's code runs, never whether it ships;
+  on the web, async routes put it in a bundle of its own.
+
+Loading the chat screen lazily. On the web, Expo Router's async routes (`"asyncRoutes"` in the `expo-router` plugin's
+options in `app.json`, e.g. `{ "web": true, "default": "development" }`) put each route's code in a bundle of its own,
+loaded the first time it is visited. That setting makes routes async on iOS and Android in development only, so a
+production iOS or Android build gets no deferral from it: there, `React.lazy` is what defers the chat:
+
+```tsx
+import { lazy, Suspense } from 'react';
+import { AgentLauncher, AgentRuntimeProvider } from '@vinaverse/react-native/launcher'; // the tabs: 2.5 kB of the kit
+
+// Only this file imports /chat, and only when the screen is first drawn.
+const ChatScreen = lazy(() => import('./ChatScreen')); // ChatScreen.tsx: import { AgentChat } from '@vinaverse/react-native/chat'
+
+export function Chat() {
+  return (
+    <Suspense fallback={null}>
+      <ChatScreen />
+    </Suspense>
+  );
+}
+```
+
+What is lost without it: a screen that imports `/chat` statically, or anything that does, loads and runs the whole chat
+(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.
+
 ## Peer dependencies
 
 | Package | Range | Why |

package/dist/ask.cjs

@@ -0,0 +1,58 @@
+'use strict';
+
+var chunk643GOUTG_cjs = require('./chunk-643GOUTG.cjs');
+var chunkOWUKWVEZ_cjs = require('./chunk-OWUKWVEZ.cjs');
+var agent = require('@vinaverse/react/agent');
+
+
+
+Object.defineProperty(exports, "AskAboutRow", {
+  enumerable: true,
+  get: function () { return chunk643GOUTG_cjs.AskAboutRow; }
+});
+Object.defineProperty(exports, "ThemeProvider", {
+  enumerable: true,
+  get: function () { return chunkOWUKWVEZ_cjs.ThemeProvider; }
+});
+Object.defineProperty(exports, "useTheme", {
+  enumerable: true,
+  get: function () { return chunkOWUKWVEZ_cjs.useTheme; }
+});
+Object.defineProperty(exports, "AgentRuntimeProvider", {
+  enumerable: true,
+  get: function () { return agent.AgentRuntimeProvider; }
+});
+Object.defineProperty(exports, "greetedKey", {
+  enumerable: true,
+  get: function () { return agent.greetedKey; }
+});
+Object.defineProperty(exports, "useAgentConversation", {
+  enumerable: true,
+  get: function () { return agent.useAgentConversation; }
+});
+Object.defineProperty(exports, "useAgentFeatures", {
+  enumerable: true,
+  get: function () { return agent.useAgentFeatures; }
+});
+Object.defineProperty(exports, "useAgentLauncher", {
+  enumerable: true,
+  get: function () { return agent.useAgentLauncher; }
+});
+Object.defineProperty(exports, "useAgentName", {
+  enumerable: true,
+  get: function () { return agent.useAgentName; }
+});
+Object.defineProperty(exports, "useAgentProfile", {
+  enumerable: true,
+  get: function () { return agent.useAgentProfile; }
+});
+Object.defineProperty(exports, "useAgentRuntime", {
+  enumerable: true,
+  get: function () { return agent.useAgentRuntime; }
+});
+Object.defineProperty(exports, "useAgentStatus", {
+  enumerable: true,
+  get: function () { return agent.useAgentStatus; }
+});
+//# sourceMappingURL=ask.cjs.map
+//# sourceMappingURL=ask.cjs.map

package/dist/ask.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"ask.cjs","sourcesContent":[]}

package/dist/ask.d.cts

@@ -0,0 +1,25 @@
+export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
+import { CopyOverrides } from '@vinaverse/react';
+import { ComponentType, ReactNode } from 'react';
+import { a as ThemeOverrides, C as ColorSchemeSetting } from './theme-BhiEGv64.cjs';
+export { T as Theme, b as ThemeProvider, u as useTheme } from './theme-BhiEGv64.cjs';
+import '@vinaverse/tokens';
+
+interface AskAboutRowProps {
+    /** "Ask Example Agent about Riley Sample". */
+    readonly title: string;
+    readonly body?: string;
+    readonly onPress: () => void;
+    /** The app's brand mark at the row's start; default the agent name's first letter. */
+    readonly Mark?: ComponentType<{
+        readonly size: number;
+        readonly color: string;
+    }>;
+    readonly locale?: string;
+    readonly copy?: CopyOverrides;
+    readonly theme?: ThemeOverrides;
+    readonly colorScheme?: ColorSchemeSetting;
+}
+declare function AskAboutRow(props: AskAboutRowProps): ReactNode;
+
+export { AskAboutRow, type AskAboutRowProps, ColorSchemeSetting, ThemeOverrides };

package/dist/ask.d.ts

@@ -0,0 +1,25 @@
+export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
+import { CopyOverrides } from '@vinaverse/react';
+import { ComponentType, ReactNode } from 'react';
+import { a as ThemeOverrides, C as ColorSchemeSetting } from './theme-BhiEGv64.js';
+export { T as Theme, b as ThemeProvider, u as useTheme } from './theme-BhiEGv64.js';
+import '@vinaverse/tokens';
+
+interface AskAboutRowProps {
+    /** "Ask Example Agent about Riley Sample". */
+    readonly title: string;
+    readonly body?: string;
+    readonly onPress: () => void;
+    /** The app's brand mark at the row's start; default the agent name's first letter. */
+    readonly Mark?: ComponentType<{
+        readonly size: number;
+        readonly color: string;
+    }>;
+    readonly locale?: string;
+    readonly copy?: CopyOverrides;
+    readonly theme?: ThemeOverrides;
+    readonly colorScheme?: ColorSchemeSetting;
+}
+declare function AskAboutRow(props: AskAboutRowProps): ReactNode;
+
+export { AskAboutRow, type AskAboutRowProps, ColorSchemeSetting, ThemeOverrides };

package/dist/ask.js

@@ -0,0 +1,5 @@
+export { AskAboutRow } from './chunk-Y7P7DDHD.js';
+export { ThemeProvider, useTheme } from './chunk-WKRCCPSN.js';
+export { AgentRuntimeProvider, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
+//# sourceMappingURL=ask.js.map
+//# sourceMappingURL=ask.js.map

package/dist/ask.js.map

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

package/dist/chat.cjs

@@ -0,0 +1,266 @@
+'use strict';
+
+var chunkH2Y2YW2Q_cjs = require('./chunk-H2Y2YW2Q.cjs');
+var chunkPYPO6F7L_cjs = require('./chunk-PYPO6F7L.cjs');
+var chunkOWUKWVEZ_cjs = require('./chunk-OWUKWVEZ.cjs');
+
+
+
+Object.defineProperty(exports, "ActivityLine", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.ActivityLine; }
+});
+Object.defineProperty(exports, "AgentChat", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.AgentChat; }
+});
+Object.defineProperty(exports, "AgentFooter", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.AgentFooter; }
+});
+Object.defineProperty(exports, "AgentRuntimeProvider", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.AgentRuntimeProvider; }
+});
+Object.defineProperty(exports, "Avatar", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.Avatar; }
+});
+Object.defineProperty(exports, "Button", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.Button; }
+});
+Object.defineProperty(exports, "CardActions", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.CardActions; }
+});
+Object.defineProperty(exports, "CardCarousel", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.CardCarousel; }
+});
+Object.defineProperty(exports, "CardFrame", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.CardFrame; }
+});
+Object.defineProperty(exports, "CardView", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.CardView; }
+});
+Object.defineProperty(exports, "ChatHeader", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.ChatHeader; }
+});
+Object.defineProperty(exports, "ChatSkeleton", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.ChatSkeleton; }
+});
+Object.defineProperty(exports, "Composer", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.Composer; }
+});
+Object.defineProperty(exports, "DefaultBubble", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.DefaultBubble; }
+});
+Object.defineProperty(exports, "DefaultComposer", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.DefaultComposer; }
+});
+Object.defineProperty(exports, "DefaultEnded", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.DefaultEnded; }
+});
+Object.defineProperty(exports, "DefaultHeader", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.DefaultHeader; }
+});
+Object.defineProperty(exports, "DefaultTurnFailed", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.DefaultTurnFailed; }
+});
+Object.defineProperty(exports, "DefaultUnavailable", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.DefaultUnavailable; }
+});
+Object.defineProperty(exports, "DefaultUnavailableScreen", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.DefaultUnavailableScreen; }
+});
+Object.defineProperty(exports, "DefaultUnreachable", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.DefaultUnreachable; }
+});
+Object.defineProperty(exports, "DisclosureBar", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.DisclosureBar; }
+});
+Object.defineProperty(exports, "FailureActionButton", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.FailureActionButton; }
+});
+Object.defineProperty(exports, "InfoCard", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.InfoCard; }
+});
+Object.defineProperty(exports, "LinksCard", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.LinksCard; }
+});
+Object.defineProperty(exports, "ListingCard", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.ListingCard; }
+});
+Object.defineProperty(exports, "MessageBubble", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.MessageBubble; }
+});
+Object.defineProperty(exports, "MessageList", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.MessageList; }
+});
+Object.defineProperty(exports, "NextStepCard", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.NextStepCard; }
+});
+Object.defineProperty(exports, "ProposalCard", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.ProposalCard; }
+});
+Object.defineProperty(exports, "QuestionCard", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.QuestionCard; }
+});
+Object.defineProperty(exports, "Row", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.Row; }
+});
+Object.defineProperty(exports, "StatusBanner", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.StatusBanner; }
+});
+Object.defineProperty(exports, "StreamingBubble", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.StreamingBubble; }
+});
+Object.defineProperty(exports, "SystemRow", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.SystemRow; }
+});
+Object.defineProperty(exports, "TimeSlotsCard", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.TimeSlotsCard; }
+});
+Object.defineProperty(exports, "VinaverseChat", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.VinaverseChat; }
+});
+Object.defineProperty(exports, "VinaverseChatProvider", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.VinaverseChatProvider; }
+});
+Object.defineProperty(exports, "Welcome", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.Welcome; }
+});
+Object.defineProperty(exports, "allowedImage", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.allowedImage; }
+});
+Object.defineProperty(exports, "answerText", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.answerText; }
+});
+Object.defineProperty(exports, "carousels", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.carousels; }
+});
+Object.defineProperty(exports, "defaultCard", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.defaultCard; }
+});
+Object.defineProperty(exports, "fieldText", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.fieldText; }
+});
+Object.defineProperty(exports, "greetedKey", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.greetedKey; }
+});
+Object.defineProperty(exports, "itemType", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.itemType; }
+});
+Object.defineProperty(exports, "monogram", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.monogram; }
+});
+Object.defineProperty(exports, "newestWholeReply", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.newestWholeReply; }
+});
+Object.defineProperty(exports, "ratingText", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.ratingText; }
+});
+Object.defineProperty(exports, "useAgentConversation", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.useAgentConversation; }
+});
+Object.defineProperty(exports, "useAgentFeatures", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.useAgentFeatures; }
+});
+Object.defineProperty(exports, "useAgentLauncher", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.useAgentLauncher; }
+});
+Object.defineProperty(exports, "useAgentName", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.useAgentName; }
+});
+Object.defineProperty(exports, "useAgentProfile", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.useAgentProfile; }
+});
+Object.defineProperty(exports, "useAgentRuntime", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.useAgentRuntime; }
+});
+Object.defineProperty(exports, "useAgentStatus", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.useAgentStatus; }
+});
+Object.defineProperty(exports, "useChat", {
+  enumerable: true,
+  get: function () { return chunkH2Y2YW2Q_cjs.useChat; }
+});
+Object.defineProperty(exports, "announce", {
+  enumerable: true,
+  get: function () { return chunkPYPO6F7L_cjs.announce; }
+});
+Object.defineProperty(exports, "useNativeLifecycle", {
+  enumerable: true,
+  get: function () { return chunkPYPO6F7L_cjs.useNativeLifecycle; }
+});
+Object.defineProperty(exports, "useReducedMotion", {
+  enumerable: true,
+  get: function () { return chunkPYPO6F7L_cjs.useReducedMotion; }
+});
+Object.defineProperty(exports, "ThemeProvider", {
+  enumerable: true,
+  get: function () { return chunkOWUKWVEZ_cjs.ThemeProvider; }
+});
+Object.defineProperty(exports, "createTheme", {
+  enumerable: true,
+  get: function () { return chunkOWUKWVEZ_cjs.createTheme; }
+});
+Object.defineProperty(exports, "themeProblems", {
+  enumerable: true,
+  get: function () { return chunkOWUKWVEZ_cjs.themeProblems; }
+});
+Object.defineProperty(exports, "useTheme", {
+  enumerable: true,
+  get: function () { return chunkOWUKWVEZ_cjs.useTheme; }
+});
+//# sourceMappingURL=chat.cjs.map
+//# sourceMappingURL=chat.cjs.map

package/dist/chat.cjs.map

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