@guuey/chat 0.4.0 → 0.5.0

package/dist/native/transcript.js

@@ -0,0 +1,86 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `<NativeTranscript>` — the plan walker + the §3.2 renderer obligations,
+ * restated over React Native's own mechanics:
+ *
+ *  - **Scroll contract, the inverted way.** The list is an INVERTED
+ *    FlatList over the reversed plan (the chat-app contract portal's
+ *    agent-chat screen ratified — guuey#94/#100): content grows at the
+ *    scroll ORIGIN, so "stick to bottom while streaming" and "never shift
+ *    the viewport while the reader is up in history" hold by construction
+ *    — no scrollTo calls during streaming, no re-pin race with content
+ *    resize (an R6 card growing at the origin cannot move the reader's
+ *    viewport). "Release on scroll-up" is likewise structural; the kit
+ *    adds the jump-to-latest affordance when the reader has left the
+ *    newest turn, and its scroll animation respects the platform
+ *    reduce-motion setting.
+ *  - **Windowing** is the list primitive's own virtualization — FlatList
+ *    windows the DOM-equivalent natively; the plan's stable keys are the
+ *    `keyExtractor`, so item identity survives streaming updates.
+ *  - **Accessibility** lives on the item components (`components.tsx`).
+ *
+ * Platform chrome (keyboard insets, dismiss modes, dock scroll policies)
+ * stays HOST-OWNED: `listProps` passes the host's FlatList behavior
+ * through, with the kit composing `onScroll` so both the host's policy and
+ * the jump affordance see every event. The kit owns data/renderItem/keys/
+ * inversion — a host overriding those would be fighting the plan.
+ */
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { AccessibilityInfo, FlatList, Pressable, Text, View, } from "react-native";
+import { DEFAULT_CHAT_THEME } from "../theme.js";
+import { defaultChatStrings } from "../strings.js";
+import { nativeTranscriptComponents, renderNativeItem, } from "./components.js";
+import { resolveNativeTheme } from "./theme-native.js";
+/** Offset (px) past which the reader counts as "up in history". */
+const JUMP_THRESHOLD_PX = 160;
+export function NativeTranscript(props) {
+    const { plan, components, strings = defaultChatStrings, theme = DEFAULT_CHAT_THEME, mode = "light", listProps, onToggle, onRetry, onPromptAction, onErrorAction, resolvedMounts, onViewPhase, } = props;
+    const tokens = useMemo(() => resolveNativeTheme(theme, mode), [theme, mode]);
+    const resolvedComponents = useMemo(() => ({ ...nativeTranscriptComponents, ...components }), [components]);
+    const ctx = useMemo(() => ({ strings, tokens, onToggle, onRetry, onPromptAction, onErrorAction, resolvedMounts, onViewPhase }), [strings, tokens, onToggle, onRetry, onPromptAction, onErrorAction, resolvedMounts, onViewPhase]);
+    // Inverted-list data: reversed plan, newest at index 0 (the visual
+    // bottom / scroll origin). Keys are the plan's stable keys.
+    const data = useMemo(() => [...plan.items].reverse(), [plan.items]);
+    // Reduce motion: the ONE animation the kit owns is the jump scroll.
+    const [reduceMotion, setReduceMotion] = useState(false);
+    useEffect(() => {
+        let alive = true;
+        void AccessibilityInfo.isReduceMotionEnabled().then((v) => {
+            if (alive)
+                setReduceMotion(v);
+        });
+        const sub = AccessibilityInfo.addEventListener("reduceMotionChanged", setReduceMotion);
+        return () => {
+            alive = false;
+            sub.remove();
+        };
+    }, []);
+    const listRef = useRef(null);
+    const [showJump, setShowJump] = useState(false);
+    const hostOnScroll = listProps?.onScroll;
+    const onScroll = useCallback((e) => {
+        // Inverted coordinates: offset 0 IS the newest turn.
+        setShowJump(e.nativeEvent.contentOffset.y > JUMP_THRESHOLD_PX);
+        hostOnScroll?.(e);
+    }, [hostOnScroll]);
+    const StatusComponent = resolvedComponents.status;
+    return (_jsxs(View, { style: { flex: 1, backgroundColor: tokens.palette.canvas }, children: [_jsx(FlatList, { ref: listRef, ...listProps, onScroll: onScroll, scrollEventThrottle: listProps?.scrollEventThrottle ?? 16, 
+                // Inverted only while non-empty: an inverted ListEmptyComponent
+                // renders upside-down (RN gotcha — portal's receipt).
+                inverted: data.length > 0, data: data, keyExtractor: (item) => item.key, renderItem: ({ item }) => (_jsx(View, { style: { paddingVertical: tokens.gap / 2 }, children: renderNativeItem(item, resolvedComponents, ctx) })), 
+                // Inverted list: the header renders at the VISUAL BOTTOM — where
+                // the live status line belongs.
+                ListHeaderComponent: plan.status !== null ? _jsx(StatusComponent, { item: plan.status, ctx: ctx }) : null }), showJump ? (_jsx(Pressable, { accessibilityRole: "button", onPress: () => {
+                    setShowJump(false);
+                    listRef.current?.scrollToOffset({ offset: 0, animated: !reduceMotion });
+                }, style: {
+                    position: "absolute",
+                    bottom: 12,
+                    alignSelf: "center",
+                    backgroundColor: tokens.palette.surface,
+                    borderRadius: 999,
+                    paddingHorizontal: 14,
+                    paddingVertical: 8,
+                    elevation: 3,
+                }, children: _jsx(Text, { style: { color: tokens.palette.ink, fontSize: tokens.fontSize - 2, fontFamily: tokens.fontFamily }, children: strings.jumpToLatest }) })) : null] }));
+}

package/dist/native.d.ts

@@ -0,0 +1,26 @@
+/**
+ * React Native entry point (`@guuey/chat/native`) — the RN renderer over
+ * the SAME headless view-model as `./react` (wave 3c, guuey#135).
+ *
+ * Zero duplication by construction: the view-model, policies, theme
+ * schema, and strings are the root subpath's exports, and the
+ * renderer-state hooks (`useTranscript`, `useTranscriptInputs`) are the
+ * SAME modules the web kit uses — they are React-generic (no DOM), so both
+ * arms share one implementation. Only the walk differs: RN primitives, the
+ * inverted-list scroll contract, and the schema's native theme projection
+ * (`resolveNativeTheme` — CSS custom properties are the web projection).
+ *
+ * The R6 default is the documented native default-gap: this tier ships
+ * WITHOUT a WebView dependency, so `view` is a required override (a
+ * labeled placeholder renders otherwise — never blank). See
+ * `native/components.tsx`.
+ *
+ * `react` and `react-native` are OPTIONAL peers — the root subpath stays
+ * importable everywhere; this arm loads only inside an RN runtime.
+ */
+export { NativeTranscript, type NativeTranscriptProps, type NativeTranscriptListProps, } from "./native/transcript.js";
+export { nativeTranscriptComponents, renderNativeItem, NativeUserMessage, NativeText, NativeReasoning, NativeTool, NativeToolGroup, NativeDataResult, NativeView, NativeMedia, NativeCode, NativeCitations, NativePrompt, NativeError, NativeHistoryBoundary, NativeCompaction, NativeUnknown, NativeStatus, type NativeTranscriptComponents, type NativeTranscriptItemContext, } from "./native/components.js";
+export { NativeMarkdown } from "./native/markdown.js";
+export { resolveNativeTheme, type NativeChatTokens, type NativeThemeMode, } from "./native/theme-native.js";
+export { useTranscript, useTranscriptInputs, type UseTranscriptArgs, type UseTranscriptResult, type UseTranscriptInputsResult, } from "./react/use-transcript.js";
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,GAC/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,GACjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,GAC/B,MAAM,2BAA2B,CAAC"}

package/dist/native.js

@@ -0,0 +1,27 @@
+/**
+ * React Native entry point (`@guuey/chat/native`) — the RN renderer over
+ * the SAME headless view-model as `./react` (wave 3c, guuey#135).
+ *
+ * Zero duplication by construction: the view-model, policies, theme
+ * schema, and strings are the root subpath's exports, and the
+ * renderer-state hooks (`useTranscript`, `useTranscriptInputs`) are the
+ * SAME modules the web kit uses — they are React-generic (no DOM), so both
+ * arms share one implementation. Only the walk differs: RN primitives, the
+ * inverted-list scroll contract, and the schema's native theme projection
+ * (`resolveNativeTheme` — CSS custom properties are the web projection).
+ *
+ * The R6 default is the documented native default-gap: this tier ships
+ * WITHOUT a WebView dependency, so `view` is a required override (a
+ * labeled placeholder renders otherwise — never blank). See
+ * `native/components.tsx`.
+ *
+ * `react` and `react-native` are OPTIONAL peers — the root subpath stays
+ * importable everywhere; this arm loads only inside an RN runtime.
+ */
+export { NativeTranscript, } from "./native/transcript.js";
+export { nativeTranscriptComponents, renderNativeItem, NativeUserMessage, NativeText, NativeReasoning, NativeTool, NativeToolGroup, NativeDataResult, NativeView, NativeMedia, NativeCode, NativeCitations, NativePrompt, NativeError, NativeHistoryBoundary, NativeCompaction, NativeUnknown, NativeStatus, } from "./native/components.js";
+export { NativeMarkdown } from "./native/markdown.js";
+export { resolveNativeTheme, } from "./native/theme-native.js";
+// The React-generic renderer-state owner + live assembler — shared with
+// the web kit (one implementation, two walks).
+export { useTranscript, useTranscriptInputs, } from "./react/use-transcript.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@guuey/chat",
-  "version": "0.4.0",
-  "description": "The default end-user transcript UI for guuey agents — the headless view-model (planTranscript), calm/debug presets, the GuueyChatTheme token schema, the ChatStrings i18n seam, and (at ./react) the component kit that renders it: per-category components, <Transcript>, the live + history input assemblers, and stick-to-bottom/windowed/accessible transcript behavior.",
+  "version": "0.5.0",
+  "description": "The default end-user transcript UI for guuey agents — the headless view-model (planTranscript), calm/debug presets, the GuueyChatTheme token schema, the ChatStrings i18n seam, and (at ./react) the component kit that renders it: per-category components, <Transcript>, the live + history input assemblers, and stick-to-bottom/windowed/accessible transcript behavior; at ./native, the React Native renderer over the same view-model.",
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -27,21 +27,31 @@
       "import": "./dist/react.js",
       "default": "./dist/react.js"
     },
+    "./native": {
+      "react-native": "./src/native.tsx",
+      "types": "./dist/native.d.ts",
+      "import": "./dist/native.js",
+      "default": "./dist/native.js"
+    },
     "./styles.css": "./styles.css"
   },
   "dependencies": {
     "@silverprotocol/core": "0.4.1",
     "@silverprotocol/richtext": "0.4.1",
     "zod": "^4.3.6",
-    "@guuey/agent-client": "0.4.0",
-    "@guuey/mcp-apps-host": "0.4.0"
+    "@guuey/agent-client": "0.5.0",
+    "@guuey/mcp-apps-host": "0.5.0"
   },
   "peerDependencies": {
-    "react": ">=18"
+    "react": ">=18",
+    "react-native": ">=0.76"
   },
   "peerDependenciesMeta": {
     "react": {
       "optional": true
+    },
+    "react-native": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -52,6 +62,7 @@
     "jsdom": "^25.0.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
+    "react-native": "0.81.5",
     "typescript": "^5.0.0",
     "vitest": "^3.0.0"
   },