@tangle-network/ui 11.24.0 → 11.26.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @tangle-network/ui
 
+## 11.26.0
+
+### Minor Changes
+
+- 950b7ca: `./files` gains document primitives. `PdfViewer` renders a PDF's pages to canvas with pdf.js, so a file reads the same on Android Chrome and iOS Safari as on a desktop: a scrolling column of pages with page navigation, zoom, fit-to-width and Download, one toolbar row at 360px, and only the pages near the screen holding a canvas. `FilePreview` and `FileArtifactPane` now show PDFs through it. `pdfjs-dist` (6.x) is a new optional peer, reached only through a caught dynamic import; without it, or when a file will not open, the viewer says why and falls back to the browser's `<object>` viewer and then a download card. `configurePdfViewer({ workerSrc, assetsUrl })` sets the page-wide worker and the decoder assets that scanned pages need; with neither, pdf.js runs on the main thread and no CDN is contacted. `FileCard` describes one file with its kind, size, date, uploader and actions, and replaces FilePreview's private download card. `FileList` is a flat document list whose rows open, download or delete a file and hand the host's own record back.
+
+## 11.25.0
+
+### Minor Changes
+
+- cf29d7e: Chat transcripts can carry more than one person beside the agent, such as a client and an attorney. `ChatMessage`, `UserMessage` and `AgentTimeline` message items take an optional `author` (`ChatAuthor`: `id`, `name`, optional `role` and `avatarUrl`), and `ChatMessage`, `UserMessage` and `AgentTimeline` take the reader's `viewerId`. The reader's own messages keep the end-aligned inverse bubble. Anyone else's sit at the start on a card under a `MessageAuthor` line: avatar (image, or initials on a tone keyed to the author's id), name, and role tag. An agent's author line opens its turn in `AgentTimeline` and is not repeated after each tool row. Without `author`, every component renders exactly the markup it did before. `MessageAuthor`, `isViewerMessage` and `ChatAuthor` are exported from `./chat`, and `ChatAuthor` from `./types`.
+
 ## 11.24.0
 
 ### Minor Changes

package/README.md

@@ -131,6 +131,28 @@ A TypeScript consumer resolves these entries through the emitted declarations, a
 
 Because the peers now resolve at first render rather than at build time, a missing one surfaces as a thrown error while React renders. Wrap the editors in an error boundary, so the install list reaches a surface you control instead of unmounting the tree.
 
+### PDF pages
+
+`pdfjs-dist` backs `PdfViewer` in `./files`, which `FilePreview` and `FileArtifactPane` use for PDFs. It follows the editor's rule: the entry reaches it only through a caught dynamic `import()`, so a consumer without it builds under Vite and esbuild. Without it, `PdfViewer` says so and shows the browser's own viewer through `<object>`, which Android Chrome does not have, so a reader there gets a download card instead of pages.
+
+```sh
+pnpm add pdfjs-dist
+```
+
+`PdfViewer` imports pdf.js's legacy build, which carries the polyfills that phone browsers a year or two old need. Two settings are page-wide, because pdf.js's own worker setting is. Set them once, before the first viewer renders:
+
+```ts
+import { configurePdfViewer } from "@tangle-network/ui/files";
+import workerSrc from "pdfjs-dist/legacy/build/pdf.worker.min.mjs?url"; // Vite
+
+configurePdfViewer({ workerSrc, assetsUrl: "/pdfjs/" });
+```
+
+- `workerSrc` moves parsing into a worker. Without it, the viewer runs pdf.js's worker code on the main thread, which needs no bundler setup and no CDN, at the cost of scrolling while a large file parses.
+- `assetsUrl` is where the app serves the installed pdfjs-dist's `wasm/`, `cmaps/`, `standard_fonts/` and `iccs/` directories. pdf.js 6 decodes JBIG2, CCITT fax and JPEG 2000 images with the wasm modules, and black-and-white scans use the first two, so without it a scanned page renders blank. The viewer warns once in the console when it is missing. Copy the directories at build time; they must come from the same pdfjs-dist version as the worker.
+
+An http(s) `src` on another origin needs CORS, as any `fetch` does. When it fails, the viewer falls back to `<object>`, which does not.
+
 `nanostores` and `@nanostores/react` back `./stores`, and `react-router` backs `./nav`.
 Those entries create values at module scope, so consumers must install their peers before importing them.
 The package root also re-exports `./stores`, so a root import requires both nanostores peers.

package/dist/chat/agent-timeline.d.ts

@@ -1,3 +1,4 @@
+import { ChatAuthor } from "../types/message.js";
 import { ToolPart } from "../types/parts.js";
 import { MessageRole } from "./chat-message.js";
 import { ToolCallData } from "../run/tool-call-feed.js";
@@ -15,6 +16,12 @@ export interface AgentTimelineMessageItem {
    *  timestamp of its own — the turn's user message dates the exchange. */
   timestamp?: Date;
   after?: ReactNode;
+  /**
+   * Who wrote the message, when more than one person shares the transcript.
+   * A person's message is compared with the timeline's `viewerId`; an agent's
+   * author line opens its turn and is not repeated after each tool row.
+   */
+  author?: ChatAuthor;
 }
 export interface AgentTimelineToolItem {
   id: string;
@@ -72,6 +79,11 @@ export interface AgentTimelineProps {
    *  except user messages) behind a "Show N more steps" toggle. Omit to always
    *  show every row. */
   collapseAfter?: number;
+  /**
+   * The reader's participant id. A user message whose `author` has another
+   * id is someone else's: it sits at the start, on a card, under its author.
+   */
+  viewerId?: string;
 }
 /**
  * AgentTimeline — unified mixed-content transcript for agent-backed sandbox
@@ -79,5 +91,5 @@ export interface AgentTimelineProps {
  * as one plain column: prose at the reading size, tool calls as quiet
  * one-liners between the paragraphs, no connector chrome.
  */
-export declare function AgentTimeline({ items, isThinking, emptyState, className, renderToolActions, collapseAfter }: AgentTimelineProps): import("react").JSX.Element | null;
+export declare function AgentTimeline({ items, isThinking, emptyState, className, renderToolActions, collapseAfter, viewerId }: AgentTimelineProps): import("react").JSX.Element | null;
 //#endregion

package/dist/chat/agent-timeline.js

@@ -1,6 +1,7 @@
 import { focusRing } from "../lib/focus.js";
 import { cn } from "../lib/utils.js";
 import { Markdown } from "../markdown/markdown.js";
+import { MessageAuthor } from "./message-author.js";
 import { UserMessage } from "./user-message.js";
 import { ThinkingIndicator } from "./thinking-indicator.js";
 import { ToolCallGroup, ToolCallStep } from "../run/tool-call-step.js";
@@ -54,8 +55,12 @@ function spacingBefore(prev, next) {
 }
 const ROW_BLEED = "-mx-3";
 const STREAMING_CARET = "[&>:last-child:not(ul,ol)]:after:ml-0.5 [&>:last-child:not(ul,ol)]:after:inline-block [&>:last-child:not(ul,ol)]:after:h-[1em] [&>:last-child:not(ul,ol)]:after:w-0.5 [&>:last-child:not(ul,ol)]:after:animate-pulse [&>:last-child:not(ul,ol)]:after:rounded-full [&>:last-child:not(ul,ol)]:after:bg-muted-foreground [&>:last-child:not(ul,ol)]:after:align-text-bottom [&>:last-child:not(ul,ol)]:after:content-[''] [&>:is(ul,ol):last-child>li:last-child]:after:ml-0.5 [&>:is(ul,ol):last-child>li:last-child]:after:inline-block [&>:is(ul,ol):last-child>li:last-child]:after:h-[1em] [&>:is(ul,ol):last-child>li:last-child]:after:w-0.5 [&>:is(ul,ol):last-child>li:last-child]:after:animate-pulse [&>:is(ul,ol):last-child>li:last-child]:after:rounded-full [&>:is(ul,ol):last-child>li:last-child]:after:bg-muted-foreground [&>:is(ul,ol):last-child>li:last-child]:after:align-text-bottom [&>:is(ul,ol):last-child>li:last-child]:after:content-['']";
-function AssistantMessage({ item }) {
+function AssistantMessage({ item, author }) {
 	return /* @__PURE__ */ jsxs("div", { children: [
+		author && /* @__PURE__ */ jsx(MessageAuthor, {
+			author,
+			className: "mb-1.5"
+		}),
 		item.content && /* @__PURE__ */ jsx(Markdown, {
 			className: cn("tangle-prose text-[length:var(--font-size-base)] leading-[1.5]", item.isStreaming && STREAMING_CARET),
 			children: item.content
@@ -151,7 +156,7 @@ function ArtifactCard({ item }) {
 * as one plain column: prose at the reading size, tool calls as quiet
 * one-liners between the paragraphs, no connector chrome.
 */
-function AgentTimeline({ items, isThinking, emptyState, className, renderToolActions, collapseAfter }) {
+function AgentTimeline({ items, isThinking, emptyState, className, renderToolActions, collapseAfter, viewerId }) {
 	const [expanded, setExpanded] = useState(false);
 	if (items.length === 0 && !isThinking) return emptyState ? /* @__PURE__ */ jsx("div", {
 		className: cn("flex h-full items-center justify-center p-4", className),
@@ -180,11 +185,27 @@ function AgentTimeline({ items, isThinking, emptyState, className, renderToolAct
 		renderList = visible;
 		hiddenCount = stepItems.length - limit;
 	}
+	const headedAgentMessages = /* @__PURE__ */ new Set();
+	let speakingAgent;
+	for (const item of renderList) {
+		if (item.kind !== "message") continue;
+		if (item.role === "user") {
+			speakingAgent = void 0;
+			continue;
+		}
+		if (item.author && item.author.id !== speakingAgent) headedAgentMessages.add(item.id);
+		speakingAgent = item.author?.id;
+	}
 	const renderItem = (item) => {
 		if (item.kind === "message") return item.role === "user" ? /* @__PURE__ */ jsx(UserMessage, {
 			content: item.content,
-			timestamp: item.timestamp
-		}) : /* @__PURE__ */ jsx(AssistantMessage, { item });
+			timestamp: item.timestamp,
+			author: item.author,
+			viewerId
+		}) : /* @__PURE__ */ jsx(AssistantMessage, {
+			item,
+			author: headedAgentMessages.has(item.id) ? item.author : void 0
+		});
 		if (item.kind === "tool") return /* @__PURE__ */ jsx(ToolCallStep, {
 			type: item.call.type,
 			label: item.call.label,

package/dist/chat/chat-message.d.ts

@@ -1,3 +1,4 @@
+import { ChatAuthor } from "../types/message.js";
 import { ReactNode } from "react";
 //#region src/chat/chat-message.d.ts
 export type MessageRole = "user" | "assistant" | "system";
@@ -17,6 +18,17 @@ export interface ChatMessageProps {
   assistantLabel?: string;
   /** Hide the role label row entirely */
   hideRoleLabel?: boolean;
+  /**
+   * Who wrote the message, when more than one person shares the transcript.
+   * It replaces the role label with the author's avatar, name and role,
+   * except on the reader's own messages, which keep `userLabel`.
+   */
+  author?: ChatAuthor;
+  /**
+   * The reader's participant id. A user message whose `author` has another
+   * id is someone else's: it sits at the start, on a card, under its author.
+   */
+  viewerId?: string;
 }
-export declare function ChatMessage({ role, content, toolCalls, isStreaming, timestamp, className, userLabel, assistantLabel, hideRoleLabel }: ChatMessageProps): import("react").JSX.Element;
+export declare function ChatMessage({ role, content, toolCalls, isStreaming, timestamp, className, userLabel, assistantLabel, hideRoleLabel, author, viewerId }: ChatMessageProps): import("react").JSX.Element;
 //#endregion

package/dist/chat/chat-message.js

@@ -1,15 +1,19 @@
 import { cn } from "../lib/utils.js";
 import { Markdown } from "../markdown/markdown.js";
+import { MessageAuthor, isViewerMessage } from "./message-author.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region src/chat/chat-message.tsx
-function ChatMessage({ role, content, toolCalls, isStreaming, timestamp, className, userLabel = "You", assistantLabel = "Agent", hideRoleLabel }) {
+function ChatMessage({ role, content, toolCalls, isStreaming, timestamp, className, userLabel = "You", assistantLabel = "Agent", hideRoleLabel, author, viewerId }) {
 	const isUser = role === "user";
 	const isAssistant = role === "assistant";
+	const fromViewer = isUser && isViewerMessage(author, viewerId);
+	const fromOtherPerson = isUser && !fromViewer;
+	const shownAuthor = fromViewer ? void 0 : author;
 	return /* @__PURE__ */ jsxs("div", {
-		className: cn("flex flex-col gap-1", isUser ? "items-end" : "items-start", className),
+		className: cn("flex flex-col gap-1", fromViewer ? "items-end" : "items-start", className),
 		children: [!hideRoleLabel && /* @__PURE__ */ jsxs("div", {
-			className: cn("flex items-center gap-2 px-1", isUser && "flex-row-reverse"),
-			children: [/* @__PURE__ */ jsx("span", {
+			className: cn("flex items-center gap-2 px-1", fromViewer && "flex-row-reverse"),
+			children: [shownAuthor ? /* @__PURE__ */ jsx(MessageAuthor, { author: shownAuthor }) : /* @__PURE__ */ jsx("span", {
 				className: "font-medium text-foreground text-xs",
 				children: isUser ? userLabel : assistantLabel
 			}), timestamp && /* @__PURE__ */ jsx("span", {
@@ -17,7 +21,7 @@ function ChatMessage({ role, content, toolCalls, isStreaming, timestamp, classNa
 				children: formatTime(timestamp)
 			})]
 		}), /* @__PURE__ */ jsxs("div", {
-			className: cn("min-w-0 max-w-[85%] space-y-1", isUser ? "rounded-[var(--radius-lg)] bg-foreground px-[var(--chat-message-px)] py-[var(--chat-message-py)] text-background" : isAssistant ? "text-foreground" : "rounded-[var(--radius-lg)] border border-border bg-card px-[var(--chat-message-px)] py-[var(--chat-message-py)]"),
+			className: cn("min-w-0 max-w-[85%] space-y-1", fromViewer ? "rounded-[var(--radius-lg)] bg-foreground px-[var(--chat-message-px)] py-[var(--chat-message-py)] text-background" : fromOtherPerson ? "rounded-[var(--radius-lg)] border border-border bg-card px-[var(--chat-message-px)] py-[var(--chat-message-py)] text-foreground" : isAssistant ? "text-foreground" : "rounded-[var(--radius-lg)] border border-border bg-card px-[var(--chat-message-px)] py-[var(--chat-message-py)]"),
 			children: [isUser ? /* @__PURE__ */ jsx("div", {
 				className: "whitespace-pre-wrap text-[length:var(--font-size-base)] leading-[var(--line-height-base)]",
 				children: content

package/dist/chat/message-author.d.ts

@@ -0,0 +1,24 @@
+import { ChatAuthor } from "../types/message.js";
+import { HTMLAttributes } from "react";
+//#region src/chat/message-author.d.ts
+/**
+ * Whether the reader wrote a human message. A message without an author is
+ * the reader's, which keeps a two-party transcript as it was. A message with
+ * an author is the reader's only when that author is `viewerId`; with no
+ * `viewerId`, every authored message belongs to someone else.
+ */
+export declare function isViewerMessage(author: ChatAuthor | undefined, viewerId: string | undefined): boolean;
+export interface MessageAuthorProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+  author: ChatAuthor;
+}
+/**
+ * The line above a message in a transcript with several participants: the
+ * author's avatar, name and, when given, their role as a tag.
+ *
+ * The avatar's tone comes from the author's id, so a participant keeps one
+ * colour for the whole thread and in every product. Tones can repeat between
+ * participants, so the name is always shown beside it. The avatar repeats the
+ * visible name and is hidden from assistive technology.
+ */
+export declare function MessageAuthor({ author, className, ...props }: MessageAuthorProps): import("react").JSX.Element;
+//#endregion

package/dist/chat/message-author.js

@@ -0,0 +1,53 @@
+import { cn } from "../lib/utils.js";
+import { toneFor } from "../primitives/tone.js";
+import { Tag } from "../primitives/tag.js";
+import { IconTile } from "../primitives/icon-tile.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/chat/message-author.tsx
+/**
+* Whether the reader wrote a human message. A message without an author is
+* the reader's, which keeps a two-party transcript as it was. A message with
+* an author is the reader's only when that author is `viewerId`; with no
+* `viewerId`, every authored message belongs to someone else.
+*/
+function isViewerMessage(author, viewerId) {
+	return author === void 0 || author.id === viewerId;
+}
+/**
+* The line above a message in a transcript with several participants: the
+* author's avatar, name and, when given, their role as a tag.
+*
+* The avatar's tone comes from the author's id, so a participant keeps one
+* colour for the whole thread and in every product. Tones can repeat between
+* participants, so the name is always shown beside it. The avatar repeats the
+* visible name and is hidden from assistive technology.
+*/
+function MessageAuthor({ author, className, ...props }) {
+	return /* @__PURE__ */ jsxs("div", {
+		"data-message-author": "",
+		className: cn("flex min-w-0 max-w-full items-center gap-2", className),
+		...props,
+		children: [
+			/* @__PURE__ */ jsx(IconTile, {
+				size: "xs",
+				src: author.avatarUrl,
+				name: author.name,
+				tone: toneFor(author.id),
+				className: "rounded-full"
+			}),
+			/* @__PURE__ */ jsx("span", {
+				className: "min-w-0 truncate font-medium text-foreground text-sm",
+				title: author.name,
+				children: author.name
+			}),
+			author.role ? /* @__PURE__ */ jsx(Tag, {
+				size: "sm",
+				emphasis: "outline",
+				className: "max-w-[50%]",
+				children: author.role
+			}) : null
+		]
+	});
+}
+//#endregion
+export { MessageAuthor, isViewerMessage };

package/dist/chat/user-message.d.ts

@@ -1,4 +1,4 @@
-import { SessionMessage } from "../types/message.js";
+import { ChatAuthor, SessionMessage } from "../types/message.js";
 import { SessionPart } from "../types/parts.js";
 import { ReactNode } from "react";
 //#region src/chat/user-message.d.ts
@@ -10,10 +10,20 @@ export interface UserMessageProps {
   content?: string;
   timestamp?: Date;
   actions?: ReactNode;
+  /**
+   * Who wrote the message, when more than one person shares the transcript.
+   * Omit it in a two-party chat: the message renders as the reader's.
+   */
+  author?: ChatAuthor;
+  /**
+   * The reader's participant id. A message whose `author` has another id is
+   * someone else's: it sits at the start, on a card, under its author.
+   */
+  viewerId?: string;
 }
 /**
  * User speech retains the inverse-theme bubble and direct-content contract.
  * Application notes interrupt the bubble in source order, outside its attribution.
  */
-export declare const UserMessage: import("react").MemoExoticComponent<({ message: _message, parts, content, timestamp, actions }: UserMessageProps) => import("react").JSX.Element | null>;
+export declare const UserMessage: import("react").MemoExoticComponent<({ message: _message, parts, content, timestamp, actions, author, viewerId }: UserMessageProps) => import("react").JSX.Element | null>;
 //#endregion

package/dist/chat/user-message.js

@@ -1,4 +1,5 @@
 import { SyntheticText, userTextSegments } from "./synthetic-text.js";
+import { MessageAuthor, isViewerMessage } from "./message-author.js";
 import { memo } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/chat/user-message.tsx
@@ -8,9 +9,9 @@ function formatTime(date) {
 		minute: "2-digit"
 	});
 }
-function MessageActions({ children }) {
+function MessageActions({ children, align = "end" }) {
 	return /* @__PURE__ */ jsx("div", {
-		className: "flex flex-wrap items-center justify-end gap-1.5 text-xs text-muted-foreground",
+		className: `flex flex-wrap items-center ${align === "end" ? "justify-end" : "justify-start"} gap-1.5 text-xs text-muted-foreground`,
 		children
 	});
 }
@@ -34,28 +35,63 @@ function UserBubble({ text, timestamp, actions }) {
 	});
 }
 /**
+* Another person's speech: start-aligned under its author, on a card rather
+* than the reader's inverse fill, so "mine" and "theirs" differ before the
+* names are read. The timestamp is revealed on the bubble's far side.
+*/
+function OtherPersonBubble({ text, timestamp, actions, author }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: "flex justify-start",
+		children: /* @__PURE__ */ jsxs("div", {
+			className: "group flex min-w-0 max-w-[78%] flex-col items-start gap-1.5",
+			children: [
+				author ? /* @__PURE__ */ jsx(MessageAuthor, { author }) : null,
+				/* @__PURE__ */ jsxs("div", {
+					className: "relative min-w-0 max-w-full rounded-2xl border border-border bg-card px-4 py-3 text-foreground",
+					children: [timestamp ? /* @__PURE__ */ jsx("span", {
+						"data-user-message-time": "",
+						className: "pointer-events-none absolute left-full top-1/2 ml-3 -translate-y-1/2 whitespace-nowrap text-[length:var(--font-size-xs)] text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100",
+						children: formatTime(timestamp)
+					}) : null, /* @__PURE__ */ jsx("div", {
+						className: "break-words whitespace-pre-wrap text-[length:var(--font-size-base)] leading-[1.5]",
+						children: text
+					})]
+				}),
+				actions ? /* @__PURE__ */ jsx(MessageActions, {
+					align: "start",
+					children: actions
+				}) : null
+			]
+		})
+	});
+}
+/**
 * User speech retains the inverse-theme bubble and direct-content contract.
 * Application notes interrupt the bubble in source order, outside its attribution.
 */
-const UserMessage = memo(({ message: _message, parts, content, timestamp, actions }) => {
-	if (content != null) return content.trim() ? /* @__PURE__ */ jsx(UserBubble, {
-		text: content,
+const UserMessage = memo(({ message: _message, parts, content, timestamp, actions, author, viewerId }) => {
+	const other = isViewerMessage(author, viewerId) ? void 0 : author;
+	const bubble = (text, bubbleActions, headed = true, key) => other ? /* @__PURE__ */ jsx(OtherPersonBubble, {
+		text,
+		timestamp,
+		actions: bubbleActions,
+		author: headed ? other : void 0
+	}, key) : /* @__PURE__ */ jsx(UserBubble, {
+		text,
 		timestamp,
-		actions
-	}) : null;
+		actions: bubbleActions
+	}, key);
+	if (content != null) return content.trim() ? bubble(content, actions) : null;
 	const segments = userTextSegments(parts ?? []);
 	if (segments.length === 0) return null;
-	if (segments.length === 1 && !segments[0].synthetic) return /* @__PURE__ */ jsx(UserBubble, {
-		text: segments[0].text,
-		timestamp,
-		actions
-	});
+	if (segments.length === 1 && !segments[0].synthetic) return bubble(segments[0].text, actions);
+	const firstSpoken = segments.find((segment) => !segment.synthetic);
 	return /* @__PURE__ */ jsxs("div", {
 		className: "space-y-2",
-		children: [segments.map((segment) => segment.synthetic ? /* @__PURE__ */ jsx(SyntheticText, { text: segment.text }, segment.index) : /* @__PURE__ */ jsx(UserBubble, {
-			text: segment.text,
-			timestamp
-		}, segment.index)), actions ? /* @__PURE__ */ jsx(MessageActions, { children: actions }) : null]
+		children: [segments.map((segment) => segment.synthetic ? /* @__PURE__ */ jsx(SyntheticText, { text: segment.text }, segment.index) : bubble(segment.text, void 0, segment === firstSpoken, segment.index)), actions ? /* @__PURE__ */ jsx(MessageActions, {
+			align: other ? "start" : "end",
+			children: actions
+		}) : null]
 	});
 });
 UserMessage.displayName = "UserMessage";

package/dist/chat.d.ts

@@ -1,7 +1,9 @@
+import { ChatAuthor } from "./types/message.js";
 import { ChatContainer, ChatContainerProps } from "./chat/chat-container.js";
 import { MessageList, MessageListProps } from "./chat/message-list.js";
 import { UserMessage, UserMessageProps } from "./chat/user-message.js";
 import { ChatMessage, ChatMessageProps, MessageRole } from "./chat/chat-message.js";
+import { MessageAuthor, MessageAuthorProps, isViewerMessage } from "./chat/message-author.js";
 import { ThinkingIndicator, ThinkingIndicatorProps } from "./chat/thinking-indicator.js";
 import { AgentTimeline, AgentTimelineArtifactItem, AgentTimelineCustomItem, AgentTimelineItem, AgentTimelineMessageItem, AgentTimelineProps, AgentTimelineStatusItem, AgentTimelineTone, AgentTimelineToolGroupItem, AgentTimelineToolItem } from "./chat/agent-timeline.js";
-export { AgentTimeline, type AgentTimelineArtifactItem, type AgentTimelineCustomItem, type AgentTimelineItem, type AgentTimelineMessageItem, type AgentTimelineProps, type AgentTimelineStatusItem, type AgentTimelineTone, type AgentTimelineToolGroupItem, type AgentTimelineToolItem, ChatContainer, type ChatContainerProps, ChatMessage, type ChatMessageProps, MessageList, type MessageListProps, type MessageRole, ThinkingIndicator, type ThinkingIndicatorProps, UserMessage, type UserMessageProps };
+export { AgentTimeline, type AgentTimelineArtifactItem, type AgentTimelineCustomItem, type AgentTimelineItem, type AgentTimelineMessageItem, type AgentTimelineProps, type AgentTimelineStatusItem, type AgentTimelineTone, type AgentTimelineToolGroupItem, type AgentTimelineToolItem, type ChatAuthor, ChatContainer, type ChatContainerProps, ChatMessage, type ChatMessageProps, MessageAuthor, type MessageAuthorProps, MessageList, type MessageListProps, type MessageRole, ThinkingIndicator, type ThinkingIndicatorProps, UserMessage, type UserMessageProps, isViewerMessage };

package/dist/chat.js

@@ -1,7 +1,8 @@
+import { MessageAuthor, isViewerMessage } from "./chat/message-author.js";
 import { UserMessage } from "./chat/user-message.js";
 import { MessageList } from "./chat/message-list.js";
 import { ThinkingIndicator } from "./chat/thinking-indicator.js";
 import { AgentTimeline } from "./chat/agent-timeline.js";
 import { ChatContainer } from "./chat/chat-container.js";
 import { ChatMessage } from "./chat/chat-message.js";
-export { AgentTimeline, ChatContainer, ChatMessage, MessageList, ThinkingIndicator, UserMessage };
+export { AgentTimeline, ChatContainer, ChatMessage, MessageAuthor, MessageList, ThinkingIndicator, UserMessage, isViewerMessage };

package/dist/editor/editor-peers.js

@@ -1,3 +1,4 @@
+import { isMissingPeerError, rethrow } from "../lib/optional-peer.js";
 //#region src/editor/editor-peers.ts
 const DOCUMENT_PEERS_MISSING = "@tangle-network/ui/editor needs its optional editor peers. Install @tiptap/react and @tiptap/starter-kit.";
 const PROVIDER_PEERS_MISSING = "@tangle-network/ui/editor needs its optional collaboration transport peers. Install @hocuspocus/provider and yjs.";
@@ -20,27 +21,6 @@ var MissingEditorPeersError = class extends Error {
 function isMissingEditorPeersError(error) {
 	return error instanceof Error && error.name === "MissingEditorPeersError";
 }
-/** The messages a bundler or a runtime gives for a module it cannot resolve. */
-const RESOLUTION_FAILURE = /could not resolve|cannot find (?:module|package)|can't resolve|failed to resolve|module not found/i;
-/**
-* True when the rejection says the package is not installed. Only such an
-* error gets the install list: a transient chunk-fetch failure that reads as
-* "install the peers" sends the reader to the wrong fix. An error this
-* predicate does not match keeps its own message, so it can only
-* under-report.
-*/
-function isMissingPeerError(error) {
-	return error instanceof Error && RESOLUTION_FAILURE.test(error.message);
-}
-/**
-* Hands an `import()` rejection on unchanged. esbuild reports an unresolvable
-* literal `import()` as a build error and defers it to run time only when the
-* call carries a `.catch()`, so every peer import attaches this handler. It
-* changes nothing at run time.
-*/
-function rethrow(error) {
-	throw error;
-}
 /**
 * Every optional peer the `./editor` entry needs at run time. The loaders
 * import all but `@tiptap/core`, which the tiptap packages need in turn: a

package/dist/files/file-card.d.ts

@@ -0,0 +1,30 @@
+import "../primitives/icon-tile.js";
+import * as React from "react";
+//#region src/files/file-card.d.ts
+/** Who added a file, as a reader of the list should see them. */
+export interface FileUploader {
+  name: string;
+  /** Their relationship to the work, e.g. "Client" or "Attorney". */
+  role?: string;
+}
+/** What FileCard and FileList show about one file. */
+export interface FileDetails {
+  filename: string;
+  /** Wins over the extension when choosing the kind, as in FilePreview. */
+  mimeType?: string;
+  /** Size in bytes. */
+  size?: number;
+  /** When the file was added or last changed. */
+  date?: Date | string | number;
+  uploader?: FileUploader;
+}
+export interface FileCardProps extends FileDetails, Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+  /** One sentence under the details, such as why there is no preview. */
+  description?: React.ReactNode;
+  /** Adds a Download button. */
+  onDownload?: () => void;
+  /** Further buttons after Download, such as Open or Delete. */
+  actions?: React.ReactNode;
+}
+export declare const FileCard: React.ForwardRefExoticComponent<FileCardProps & React.RefAttributes<HTMLDivElement>>;
+//#endregion