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

package/dist/launcher.cjs

@@ -0,0 +1,82 @@
+'use strict';
+
+var chunkMG32E4JI_cjs = require('./chunk-MG32E4JI.cjs');
+var chunk6QYDPGRS_cjs = require('./chunk-6QYDPGRS.cjs');
+var agent = require('@vinaverse/react/agent');
+
+
+
+Object.defineProperty(exports, "AgentLauncher", {
+  enumerable: true,
+  get: function () { return chunkMG32E4JI_cjs.AgentLauncher; }
+});
+Object.defineProperty(exports, "LAUNCHER_SIZE", {
+  enumerable: true,
+  get: function () { return chunkMG32E4JI_cjs.LAUNCHER_SIZE; }
+});
+Object.defineProperty(exports, "LauncherButton", {
+  enumerable: true,
+  get: function () { return chunkMG32E4JI_cjs.LauncherButton; }
+});
+Object.defineProperty(exports, "LauncherEntrance", {
+  enumerable: true,
+  get: function () { return chunkMG32E4JI_cjs.LauncherEntrance; }
+});
+Object.defineProperty(exports, "LauncherGreeting", {
+  enumerable: true,
+  get: function () { return chunkMG32E4JI_cjs.LauncherGreeting; }
+});
+Object.defineProperty(exports, "useKeyboardShown", {
+  enumerable: true,
+  get: function () { return chunkMG32E4JI_cjs.useKeyboardShown; }
+});
+Object.defineProperty(exports, "ThemeProvider", {
+  enumerable: true,
+  get: function () { return chunk6QYDPGRS_cjs.ThemeProvider; }
+});
+Object.defineProperty(exports, "useTheme", {
+  enumerable: true,
+  get: function () { return chunk6QYDPGRS_cjs.useTheme; }
+});
+Object.defineProperty(exports, "AgentRuntimeProvider", {
+  enumerable: true,
+  get: function () { return agent.AgentRuntimeProvider; }
+});
+Object.defineProperty(exports, "forgetGreeting", {
+  enumerable: true,
+  get: function () { return agent.forgetGreeting; }
+});
+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=launcher.cjs.map
+//# sourceMappingURL=launcher.cjs.map

package/dist/launcher.cjs.map

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

package/dist/launcher.d.cts

@@ -0,0 +1,122 @@
+import { GreetingStorage } from '@vinaverse/react/agent';
+export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, forgetGreeting, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
+import { CopyOverrides } from '@vinaverse/react';
+import { ComponentType, ReactNode } from 'react';
+import { StyleProp, ViewStyle } from 'react-native';
+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';
+
+/** The launcher's button side, in dp. */
+declare const LAUNCHER_SIZE = 56;
+/** The launcher's look: a ring around the button, its shadow, the bubble's tail toward it. */
+interface LauncherAppearance {
+    /** Default none. */
+    readonly ring?: {
+        readonly color: string;
+        readonly width: number;
+    } | null;
+    /** Default true. */
+    readonly shadow?: boolean;
+    /** Default true. */
+    readonly tail?: boolean;
+}
+/** Where it floats: the screen's edge, its distance from the bottom (above a tab bar) and from the side. */
+interface LauncherPlacement {
+    /** Default `right`. */
+    readonly edge?: 'left' | 'right';
+    /** Default 16. */
+    readonly bottom?: number;
+    /** Default 16. */
+    readonly inset?: number;
+}
+interface LauncherButtonProps {
+    readonly label: string;
+    readonly name: string;
+    readonly onPress: () => void;
+    readonly Mark: ComponentType<{
+        readonly size: number;
+        readonly color: string;
+    }> | undefined;
+    readonly ring: {
+        readonly color: string;
+        readonly width: number;
+    } | null;
+    readonly shadow: boolean;
+}
+interface LauncherGreetingProps {
+    readonly text: string;
+    readonly closeLabel: string;
+    readonly onOpen: () => void;
+    readonly onClose: () => void;
+    readonly tail: boolean;
+    readonly edge: 'left' | 'right';
+}
+/** How the button and the bubble come in; `reducedMotion` when the person asked for none. */
+interface LauncherEntranceProps {
+    readonly part: 'button' | 'greeting';
+    readonly reducedMotion: boolean;
+    readonly children: ReactNode;
+}
+type Slot<P> = ComponentType<P & {
+    readonly Default: ComponentType<P>;
+}>;
+/** Where the person opened the agent from: the app's route, the mode, and `entryPoint` to give the chat. */
+interface LauncherContext {
+    readonly route: string | null;
+    readonly mode: string;
+    readonly entryPoint: 'launcher';
+}
+interface AgentLauncherProps {
+    readonly subject: string | null;
+    readonly mode: string;
+    readonly onOpen: (from: LauncherContext) => void;
+    /** The app's current route; with `routes`, the launcher shows only on those. */
+    readonly route?: string | null;
+    readonly routes?: readonly string[];
+    /** The app says step aside (a sheet is up, a map with its own cards…). */
+    readonly hidden?: boolean;
+    /** Hidden while the keyboard is up. Default true. */
+    readonly hideWithKeyboard?: boolean;
+    /** Where it remembers the greeting was shown (the app's preferences store); default: for this launch only. */
+    readonly storage?: GreetingStorage;
+    /** The storage's key for a person and mode (a record the app already keeps); default `greetedKey`. */
+    readonly storageKey?: (subject: string | null, mode: string) => string;
+    /** The greeting's words, or by mode; default the copy's `launcherGreeting`. */
+    readonly greeting?: string | ((mode: string) => string);
+    /** How long after showing the greeting appears. Default 1200 ms. */
+    readonly delayMs?: number;
+    /** The app's brand mark inside the button; default the agent name's first letter. */
+    readonly Mark?: ComponentType<{
+        readonly size: number;
+        readonly color: string;
+    }>;
+    /** Reads the greeting to a screen reader as it appears. Default: the platform's. */
+    readonly announce?: (text: string) => void;
+    readonly components?: {
+        readonly Button?: Slot<LauncherButtonProps>;
+        readonly Greeting?: Slot<LauncherGreetingProps>;
+        /** Default: a short fade and scale; none with reduced motion. */
+        readonly Entrance?: Slot<LauncherEntranceProps>;
+    };
+    readonly appearance?: LauncherAppearance;
+    /** Where it floats over the app's screens; `style` comes after it, for anything else. */
+    readonly placement?: LauncherPlacement;
+    readonly style?: StyleProp<ViewStyle>;
+    /** As on the chat: the person's locale, the app's words, theme and color scheme. */
+    readonly locale?: string;
+    readonly copy?: CopyOverrides;
+    readonly theme?: ThemeOverrides;
+    readonly colorScheme?: ColorSchemeSetting;
+}
+declare function AgentLauncher(props: AgentLauncherProps): ReactNode;
+/** Whether the keyboard is up: on iOS from the moment it starts to rise or fall, on Android (no `Will` events) once it has. */
+declare function useKeyboardShown(): boolean;
+/** The kit's entrance: a short fade and scale up; none when the person asked for reduced motion. */
+declare function LauncherEntrance(props: LauncherEntranceProps): ReactNode;
+/** The kit's greeting bubble: the words (a tap opens the agent), a close button, and a tail toward the button. */
+declare function LauncherGreeting(props: LauncherGreetingProps): ReactNode;
+/** The kit's round button: the app's mark, else the agent name's first letter; its ring and shadow as asked. */
+declare function LauncherButton(props: LauncherButtonProps): ReactNode;
+
+export { AgentLauncher, type AgentLauncherProps, ColorSchemeSetting, LAUNCHER_SIZE, type LauncherAppearance, LauncherButton, type LauncherButtonProps, type LauncherContext, LauncherEntrance, type LauncherEntranceProps, LauncherGreeting, type LauncherGreetingProps, type LauncherPlacement, ThemeOverrides, useKeyboardShown };

package/dist/launcher.d.ts

@@ -0,0 +1,122 @@
+import { GreetingStorage } from '@vinaverse/react/agent';
+export { AgentRuntimeProvider, GreetingStorage, UseAgentConversation, UseAgentLauncher, forgetGreeting, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
+import { CopyOverrides } from '@vinaverse/react';
+import { ComponentType, ReactNode } from '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, u as useTheme } from './theme-BhiEGv64.js';
+import '@vinaverse/tokens';
+
+/** The launcher's button side, in dp. */
+declare const LAUNCHER_SIZE = 56;
+/** The launcher's look: a ring around the button, its shadow, the bubble's tail toward it. */
+interface LauncherAppearance {
+    /** Default none. */
+    readonly ring?: {
+        readonly color: string;
+        readonly width: number;
+    } | null;
+    /** Default true. */
+    readonly shadow?: boolean;
+    /** Default true. */
+    readonly tail?: boolean;
+}
+/** Where it floats: the screen's edge, its distance from the bottom (above a tab bar) and from the side. */
+interface LauncherPlacement {
+    /** Default `right`. */
+    readonly edge?: 'left' | 'right';
+    /** Default 16. */
+    readonly bottom?: number;
+    /** Default 16. */
+    readonly inset?: number;
+}
+interface LauncherButtonProps {
+    readonly label: string;
+    readonly name: string;
+    readonly onPress: () => void;
+    readonly Mark: ComponentType<{
+        readonly size: number;
+        readonly color: string;
+    }> | undefined;
+    readonly ring: {
+        readonly color: string;
+        readonly width: number;
+    } | null;
+    readonly shadow: boolean;
+}
+interface LauncherGreetingProps {
+    readonly text: string;
+    readonly closeLabel: string;
+    readonly onOpen: () => void;
+    readonly onClose: () => void;
+    readonly tail: boolean;
+    readonly edge: 'left' | 'right';
+}
+/** How the button and the bubble come in; `reducedMotion` when the person asked for none. */
+interface LauncherEntranceProps {
+    readonly part: 'button' | 'greeting';
+    readonly reducedMotion: boolean;
+    readonly children: ReactNode;
+}
+type Slot<P> = ComponentType<P & {
+    readonly Default: ComponentType<P>;
+}>;
+/** Where the person opened the agent from: the app's route, the mode, and `entryPoint` to give the chat. */
+interface LauncherContext {
+    readonly route: string | null;
+    readonly mode: string;
+    readonly entryPoint: 'launcher';
+}
+interface AgentLauncherProps {
+    readonly subject: string | null;
+    readonly mode: string;
+    readonly onOpen: (from: LauncherContext) => void;
+    /** The app's current route; with `routes`, the launcher shows only on those. */
+    readonly route?: string | null;
+    readonly routes?: readonly string[];
+    /** The app says step aside (a sheet is up, a map with its own cards…). */
+    readonly hidden?: boolean;
+    /** Hidden while the keyboard is up. Default true. */
+    readonly hideWithKeyboard?: boolean;
+    /** Where it remembers the greeting was shown (the app's preferences store); default: for this launch only. */
+    readonly storage?: GreetingStorage;
+    /** The storage's key for a person and mode (a record the app already keeps); default `greetedKey`. */
+    readonly storageKey?: (subject: string | null, mode: string) => string;
+    /** The greeting's words, or by mode; default the copy's `launcherGreeting`. */
+    readonly greeting?: string | ((mode: string) => string);
+    /** How long after showing the greeting appears. Default 1200 ms. */
+    readonly delayMs?: number;
+    /** The app's brand mark inside the button; default the agent name's first letter. */
+    readonly Mark?: ComponentType<{
+        readonly size: number;
+        readonly color: string;
+    }>;
+    /** Reads the greeting to a screen reader as it appears. Default: the platform's. */
+    readonly announce?: (text: string) => void;
+    readonly components?: {
+        readonly Button?: Slot<LauncherButtonProps>;
+        readonly Greeting?: Slot<LauncherGreetingProps>;
+        /** Default: a short fade and scale; none with reduced motion. */
+        readonly Entrance?: Slot<LauncherEntranceProps>;
+    };
+    readonly appearance?: LauncherAppearance;
+    /** Where it floats over the app's screens; `style` comes after it, for anything else. */
+    readonly placement?: LauncherPlacement;
+    readonly style?: StyleProp<ViewStyle>;
+    /** As on the chat: the person's locale, the app's words, theme and color scheme. */
+    readonly locale?: string;
+    readonly copy?: CopyOverrides;
+    readonly theme?: ThemeOverrides;
+    readonly colorScheme?: ColorSchemeSetting;
+}
+declare function AgentLauncher(props: AgentLauncherProps): ReactNode;
+/** Whether the keyboard is up: on iOS from the moment it starts to rise or fall, on Android (no `Will` events) once it has. */
+declare function useKeyboardShown(): boolean;
+/** The kit's entrance: a short fade and scale up; none when the person asked for reduced motion. */
+declare function LauncherEntrance(props: LauncherEntranceProps): ReactNode;
+/** The kit's greeting bubble: the words (a tap opens the agent), a close button, and a tail toward the button. */
+declare function LauncherGreeting(props: LauncherGreetingProps): ReactNode;
+/** The kit's round button: the app's mark, else the agent name's first letter; its ring and shadow as asked. */
+declare function LauncherButton(props: LauncherButtonProps): ReactNode;
+
+export { AgentLauncher, type AgentLauncherProps, ColorSchemeSetting, LAUNCHER_SIZE, type LauncherAppearance, LauncherButton, type LauncherButtonProps, type LauncherContext, LauncherEntrance, type LauncherEntranceProps, LauncherGreeting, type LauncherGreetingProps, type LauncherPlacement, ThemeOverrides, useKeyboardShown };

package/dist/launcher.js

@@ -0,0 +1,5 @@
+export { AgentLauncher, LAUNCHER_SIZE, LauncherButton, LauncherEntrance, LauncherGreeting, useKeyboardShown } from './chunk-POJP52GE.js';
+export { ThemeProvider, useTheme } from './chunk-EFEXTVIT.js';
+export { AgentRuntimeProvider, forgetGreeting, greetedKey, useAgentConversation, useAgentFeatures, useAgentLauncher, useAgentName, useAgentProfile, useAgentRuntime, useAgentStatus } from '@vinaverse/react/agent';
+//# sourceMappingURL=launcher.js.map
+//# sourceMappingURL=launcher.js.map

package/dist/launcher.js.map

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

package/dist/theme-BhiEGv64.d.cts

@@ -0,0 +1,35 @@
+import { Colors, radius, space, ColorScheme, font, motion, size } from '@vinaverse/tokens';
+import { ReactNode } from 'react';
+
+interface Theme {
+    readonly scheme: ColorScheme;
+    readonly colors: Colors;
+    readonly font: typeof font & {
+        readonly family?: string;
+    };
+    readonly space: typeof space;
+    readonly radius: typeof radius;
+    readonly motion: typeof motion;
+    readonly size: typeof size;
+}
+/** A tenant's brand: colors per scheme, a font family, radii. Anything left out keeps the Vinaverse default. */
+interface ThemeOverrides {
+    readonly light?: Partial<Colors>;
+    readonly dark?: Partial<Colors>;
+    readonly fontFamily?: string;
+    readonly radius?: Partial<typeof radius>;
+    readonly space?: Partial<typeof space>;
+}
+type ColorSchemeSetting = 'system' | 'light' | 'dark';
+/** The theme for a scheme, with the tenant's overrides on top. */
+declare function createTheme(scheme: ColorScheme, overrides?: ThemeOverrides): Theme;
+/** The pairs a tenant's colors made hard to read, in either scheme, as messages for a development warning. */
+declare function themeProblems(overrides?: ThemeOverrides): string[];
+declare function ThemeProvider(props: {
+    readonly theme?: ThemeOverrides | undefined;
+    readonly colorScheme?: ColorSchemeSetting | undefined;
+    readonly children?: ReactNode;
+}): ReactNode;
+declare function useTheme(): Theme;
+
+export { type ColorSchemeSetting as C, type Theme as T, type ThemeOverrides as a, ThemeProvider as b, createTheme as c, themeProblems as t, useTheme as u };

package/dist/theme-BhiEGv64.d.ts

@@ -0,0 +1,35 @@
+import { Colors, radius, space, ColorScheme, font, motion, size } from '@vinaverse/tokens';
+import { ReactNode } from 'react';
+
+interface Theme {
+    readonly scheme: ColorScheme;
+    readonly colors: Colors;
+    readonly font: typeof font & {
+        readonly family?: string;
+    };
+    readonly space: typeof space;
+    readonly radius: typeof radius;
+    readonly motion: typeof motion;
+    readonly size: typeof size;
+}
+/** A tenant's brand: colors per scheme, a font family, radii. Anything left out keeps the Vinaverse default. */
+interface ThemeOverrides {
+    readonly light?: Partial<Colors>;
+    readonly dark?: Partial<Colors>;
+    readonly fontFamily?: string;
+    readonly radius?: Partial<typeof radius>;
+    readonly space?: Partial<typeof space>;
+}
+type ColorSchemeSetting = 'system' | 'light' | 'dark';
+/** The theme for a scheme, with the tenant's overrides on top. */
+declare function createTheme(scheme: ColorScheme, overrides?: ThemeOverrides): Theme;
+/** The pairs a tenant's colors made hard to read, in either scheme, as messages for a development warning. */
+declare function themeProblems(overrides?: ThemeOverrides): string[];
+declare function ThemeProvider(props: {
+    readonly theme?: ThemeOverrides | undefined;
+    readonly colorScheme?: ColorSchemeSetting | undefined;
+    readonly children?: ReactNode;
+}): ReactNode;
+declare function useTheme(): Theme;
+
+export { type ColorSchemeSetting as C, type Theme as T, type ThemeOverrides as a, ThemeProvider as b, createTheme as c, themeProblems as t, useTheme as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vinaverse/react-native",
-  "version": "0.1.0-alpha.5",
+  "version": "0.1.0-alpha.7",
   "description": "Vinaverse for React Native: a ready, themeable agent conversation for Expo and bare apps, built on the conversation store; every part replaceable, the AI disclosure never.",
   "license": "Apache-2.0",
   "author": "Vinaverse, Inc.",
@@ -30,18 +30,61 @@
         "default": "./dist/index.cjs"
       }
     },
+    "./chat": {
+      "import": {
+        "types": "./dist/chat.d.ts",
+        "default": "./dist/chat.js"
+      },
+      "require": {
+        "types": "./dist/chat.d.cts",
+        "default": "./dist/chat.cjs"
+      }
+    },
+    "./launcher": {
+      "import": {
+        "types": "./dist/launcher.d.ts",
+        "default": "./dist/launcher.js"
+      },
+      "require": {
+        "types": "./dist/launcher.d.cts",
+        "default": "./dist/launcher.cjs"
+      }
+    },
+    "./ask": {
+      "import": {
+        "types": "./dist/ask.d.ts",
+        "default": "./dist/ask.js"
+      },
+      "require": {
+        "types": "./dist/ask.d.cts",
+        "default": "./dist/ask.cjs"
+      }
+    },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.cts",
+  "typesVersions": {
+    "*": {
+      "chat": [
+        "./dist/chat.d.cts"
+      ],
+      "launcher": [
+        "./dist/launcher.d.cts"
+      ],
+      "ask": [
+        "./dist/ask.d.cts"
+      ]
+    }
+  },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@vinaverse/client": "0.1.0-alpha.5",
-    "@vinaverse/react": "0.1.0-alpha.5",
-    "@vinaverse/tokens": "0.1.0-alpha.5"
+    "@vinaverse/client": "0.1.0-alpha.7",
+    "@vinaverse/react": "0.1.0-alpha.7",
+    "@vinaverse/tokens": "0.1.0-alpha.7"
   },
   "peerDependencies": {
     "@shopify/flash-list": ">=2.3.2 <3",
@@ -56,7 +99,9 @@
     "@testing-library/react-native": "14.0.1",
     "@types/jest": "29.5.14",
     "babel-jest": "29.7.0",
+    "esbuild": "0.27.7",
     "jest": "29.7.0",
+    "metro-resolver": "0.84.6",
     "react-native": "0.86.3",
     "test-renderer": "1.3.0"
   },
@@ -138,7 +183,7 @@
       "limit": "13 kB"
     },
     {
-      "name": "@vinaverse/react-native, <AgentLauncher> alone",
+      "name": "@vinaverse/react-native, <AgentLauncher> alone (without the chat: the kit's parts are pure)",
       "path": "dist/index.js",
       "import": "{ AgentLauncher }",
       "ignore": [
@@ -153,10 +198,10 @@
         "@vinaverse/client/agent",
         "@vinaverse/react/agent"
       ],
-      "limit": "13 kB"
+      "limit": "2.5 kB"
     },
     {
-      "name": "@vinaverse/react-native, <AskAboutRow> alone",
+      "name": "@vinaverse/react-native, <AskAboutRow> alone (without the chat)",
       "path": "dist/index.js",
       "import": "{ AskAboutRow }",
       "ignore": [
@@ -171,13 +216,13 @@
         "@vinaverse/client/agent",
         "@vinaverse/react/agent"
       ],
-      "limit": "13 kB"
+      "limit": "1.25 kB"
     }
   ],
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p test/tsconfig.json",
     "test": "jest",
-    "package:check": "publint --strict && attw --pack . && size-limit"
+    "package:check": "publint --strict && attw --pack . && size-limit && node scripts/check-entries.mjs && jest --ci --config jest.built.config.cjs"
   }
 }