@threadplane/chat 0.0.55 → 0.0.57

package/README.md

@@ -28,7 +28,7 @@ Part of [Threadplane](https://github.com/cacheplane/angular-agent-framework).
 ## Install
 
 ```bash
-npm install @threadplane/chat @threadplane/langgraph marked
+npm install @threadplane/chat @threadplane/langgraph @langchain/core @langchain/langgraph-sdk marked
 ```
 
 **Peer dependencies:**
@@ -149,6 +149,9 @@ interface Citation {
   title?: string;
   url?: string;
   snippet?: string;
+  sourceType?: string; // 'web' | 'file' | 'app' | 'memory' | custom
+  iconUrl?: string;    // provider-supplied favicon/logo URL or data URI
+  publishedAt?: string | number | Date;
   extra?: unknown;    // adapter-specific fields
 }
 ```
@@ -167,6 +170,7 @@ Use `<chat-citations>` to render a collapsible sources panel under assistant mes
 Inline citation markers are rendered automatically by `MarkdownCitationReferenceComponent` inside streaming markdown output — superscript indices link to the corresponding card in the sources panel.
 
 `CitationsResolverService` resolves raw `Citation` references into `ResolvedCitation` objects with full source metadata.
+Citation display helpers derive the visible source type badge from `sourceType` and fall back to `web` when a URL is present.
 
 **Adapter integration:**
 - **LangGraph** — reads from `message.additional_kwargs.citations` (preferred) or `.sources` (fallback).
@@ -227,6 +231,41 @@ Without `katex` installed, or without the stylesheet, math degrades gracefully
 
 ### Theming
 
+Chat compositions and primitives expose a `--tplane-chat-*` CSS variable API for colors, typography, spacing, radii, and z-index layers. Override those variables on `:root`, on the `<chat>` host, or on any ancestor:
+
+```css
+:root {
+  --tplane-chat-primary: #2563eb;
+  --tplane-chat-on-primary: #ffffff;
+  --tplane-chat-radius-bubble: 12px;
+}
+```
+
+If your app already has design-system tokens, keep them as the source of truth and bridge them into the chat API:
+
+```css
+:root {
+  --ds-canvas: #ffffff;
+  --ds-surface: #f8fafc;
+  --ds-border: #e2e8f0;
+  --ds-text-primary: #0f172a;
+  --ds-text-muted: #64748b;
+  --ds-accent: #2563eb;
+  --ds-font-sans: Inter, system-ui, sans-serif;
+
+  --tplane-chat-bg: var(--ds-canvas);
+  --tplane-chat-surface: var(--ds-surface);
+  --tplane-chat-surface-alt: var(--ds-surface);
+  --tplane-chat-separator: var(--ds-border);
+  --tplane-chat-text: var(--ds-text-primary);
+  --tplane-chat-text-muted: var(--ds-text-muted);
+  --tplane-chat-primary: var(--ds-accent);
+  --tplane-chat-font-family: var(--ds-font-sans);
+}
+```
+
+Use app tokens for app layout and `--tplane-chat-*` tokens at chat boundaries or custom chat-adjacent views. That keeps chat's public theming surface stable even if your app design-system token names change.
+
 `<a2ui-surface>` declares ~50 `--a2ui-*` CSS custom properties at `:host` with dark-theme defaults covering color, spacing, typography, shape radius, focus ring, motion, and elevation. Catalog components consume them via `var(--a2ui-*)`.
 
 **Built-in presets** — import one in your global stylesheet: