@codexview/react 0.2.3 → 0.3.1

package/README.md

@@ -50,9 +50,15 @@ CodexView itself only renders `ChatStreamEvent[]`. Hosts convert their raw logs
 
 Session-level status (`idle | working | completed | stopped | failed`) is inferred automatically. Override via the `status` prop (e.g. when SSE drops, set `status="stopped"`).
 
+## Reading layout
+
+Consecutive tool-like items inside a turn (`tool_call`, `exec`, `search`, `patch`, `todo_list`) are wrapped automatically in a single collapsible `<ToolGroup>` titled by aggregated counts — e.g. `更新待办、执行 9 个命令、调用 4 个工具`. The transcript reads as narrative: text, a one-line summary of operations in between, more text. Messages, reasoning, and errors stay rendered standalone. See [docs/api.md#toolgroup](docs/api.md) for the API.
+
+The default light palette is a "warm paper" look (ivory page, deep ink-brown text, peach user bubble, warm-ink code blocks). To restore the previous cool palette, drop in the override snippet in [docs/styling.md](docs/styling.md#restoring-the-pre-021-cool-palette).
+
 ## Customizing
 
-- Swap any block via `components` prop: `<CodexTranscript components={{ ToolCallBlock: MyToolUI }} />`
+- Swap any block via `components` prop: `<CodexTranscript components={{ ToolCallBlock: MyToolUI, ToolGroup: MyGroupUI }} />`
 - Theme via CSS variables — see [docs/styling.md](docs/styling.md) for the full list.
 
 ## More docs

package/dist/components/CodexTranscript.d.ts

@@ -11,6 +11,7 @@ import { TodoListBlockProps } from './TodoListBlock.js';
 import { ErrorBlockProps } from './ErrorBlock.js';
 import { RawEventBlockProps } from './RawEventBlock.js';
 import { StatusBarProps } from './StatusBar.js';
+import { ToolGroupProps } from './ToolGroup.js';
 export interface CodexTranscriptComponents {
     StatusBar: ComponentType<StatusBarProps>;
     MessageBubble: ComponentType<MessageBubbleProps>;
@@ -22,6 +23,7 @@ export interface CodexTranscriptComponents {
     TodoListBlock: ComponentType<TodoListBlockProps>;
     ErrorBlock: ComponentType<ErrorBlockProps>;
     RawEventBlock: ComponentType<RawEventBlockProps>;
+    ToolGroup: ComponentType<ToolGroupProps>;
 }
 export interface CodexTranscriptProps {
     events: ChatStreamEvent[];

package/dist/components/ToolGroup.d.ts

@@ -0,0 +1,20 @@
+import { ReactNode } from 'react';
+import { ItemView } from '../types/model.js';
+export interface ToolGroupProps {
+    items: ItemView[];
+    /** Pre-rendered child blocks, one per item, in the same order as `items`. */
+    children: ReactNode;
+    /** Default to false (collapsed). Auto-expands while any item is pending/running. */
+    defaultOpen?: boolean;
+}
+export declare function isGroupableKind(kind: ItemView['kind']): boolean;
+export type Slice = {
+    kind: 'single';
+    item: ItemView;
+} | {
+    kind: 'group';
+    items: ItemView[];
+};
+export declare function partitionForGrouping(items: ItemView[]): Slice[];
+export declare function summarize(items: ItemView[]): string;
+export declare function ToolGroup({ items, children, defaultOpen }: ToolGroupProps): JSX.Element;

package/dist/index.d.ts

@@ -31,8 +31,10 @@ export { ErrorBlock } from './components/ErrorBlock.js';
 export type { ErrorBlockProps } from './components/ErrorBlock.js';
 export { RawEventBlock } from './components/RawEventBlock.js';
 export type { RawEventBlockProps } from './components/RawEventBlock.js';
+export { ToolGroup, partitionForGrouping, summarize as summarizeToolGroup, isGroupableKind } from './components/ToolGroup.js';
+export type { ToolGroupProps, Slice as ToolGroupSlice } from './components/ToolGroup.js';
 export { ItemErrorBoundary } from './components/ItemErrorBoundary.js';
 export type { ItemErrorBoundaryProps } from './components/ItemErrorBoundary.js';
 export { Markdown } from './components/Markdown.js';
 export type { MarkdownProps } from './components/Markdown.js';
-export declare const VERSION = "0.1.4";
+export declare const VERSION = "0.3.1";