rift-ds 1.7.0 → 1.9.0

package/chat/demo.js

@@ -0,0 +1,28 @@
+import { createSimTransport } from "./sim.js";
+import { DEMO_SCRIPT } from "./demo-script.js";
+import { DEMO_STARTERS } from "./demo-script.js";
+import { DEMO_RENDERERS } from "./demo-cards.js";
+import { DEMO_ARTIFACT_RENDERERS, DEMO_DASHBOARD_ARTIFACT, DEMO_PAGE_ARTIFACT } from "./demo-artifacts.js";
+import { DEMO_MENTIONS, DEMO_MODELS, DEMO_PROJECTS, DEMO_THREADS, DEMO_THREAD_GROUPS, DEMO_THREAD_NAMES, DEMO_WELCOME_OPTIONS } from "./demo-fixtures.js";
+import { demoAgentTabs } from "./demo-agent.js";
+import { DemoBoard, DemoWelcome } from "./DemoWelcome.js";
+const createDemoTransport = (timing) => createSimTransport(DEMO_SCRIPT, timing);
+export {
+  DEMO_ARTIFACT_RENDERERS,
+  DEMO_DASHBOARD_ARTIFACT,
+  DEMO_MENTIONS,
+  DEMO_MODELS,
+  DEMO_PAGE_ARTIFACT,
+  DEMO_PROJECTS,
+  DEMO_RENDERERS,
+  DEMO_SCRIPT,
+  DEMO_STARTERS,
+  DEMO_THREADS,
+  DEMO_THREAD_GROUPS,
+  DEMO_THREAD_NAMES,
+  DEMO_WELCOME_OPTIONS,
+  DemoBoard,
+  DemoWelcome,
+  createDemoTransport,
+  demoAgentTabs
+};

package/chat/followups.d.ts

@@ -0,0 +1,41 @@
+import { ChatTurn } from './types';
+/** Chips offered under one answer. */
+export declare const MAX_FOLLOWUPS = 3;
+/**
+ * The written fallbacks a host that passes none gets: generic by design, so
+ * any of them makes sense under any answer. A host whose chat is about one
+ * product writes its own pool and passes it to the provider.
+ */
+export declare const DEFAULT_FALLBACK_FOLLOWUPS: readonly string[];
+/**
+ * Three questions from a fallback pool, rotated by the turn id (stable
+ * across re-renders) and skipping one identical to what the visitor just
+ * asked: offering their own question back would read as not listening.
+ */
+export declare function pickFallbackFollowups(pool: readonly string[], turnId: string, question: string): string[];
+/**
+ * Suggestions have no value once the visitor has moved on, and the widget
+ * never blocks on them, so a slow one is simply dropped.
+ */
+export declare const FOLLOWUPS_TIMEOUT_MS = 10000;
+/** A source of follow-up questions for a finished answer. */
+export type FollowupsSource = (question: string, answer: string, signal: AbortSignal) => Promise<string[]>;
+/**
+ * A source that asks an HTTP endpoint speaking the follow-ups protocol
+ * (`createFollowupsHandler` on the server): POST `{ question, answer }`,
+ * read `{ suggestions: string[] }`. Resolves to an empty array on any
+ * failure, which the provider stores as-is: it records that the turn was
+ * asked about and had nothing to offer, then substitutes the fallbacks.
+ */
+export declare function createFollowupsFetcher(endpoint?: string): FollowupsSource;
+/**
+ * The turn to ask about, or null when there is nothing to ask about yet:
+ * the newest turn must be a committed assistant answer that came from a
+ * backend (an exchange id is the marker, as it is for the thumbs) and has
+ * not been asked about already.
+ */
+export declare function followupTarget(turns: ChatTurn[]): {
+    id: string;
+    question: string;
+    answer: string;
+} | null;

package/chat/followups.js

@@ -0,0 +1,55 @@
+import { fitsChip } from "./suggestions.js";
+const MAX_FOLLOWUPS = 3;
+const DEFAULT_FALLBACK_FOLLOWUPS = [
+  "Can you say more about that?",
+  "What should I do next?",
+  "Where can I read more?",
+  "Can you give an example?",
+  "What are the alternatives?"
+];
+function pickFallbackFollowups(pool, turnId, question) {
+  const asked = question.trim().toLowerCase();
+  const usable = pool.filter((label) => label.toLowerCase() !== asked && fitsChip(label));
+  let hash = 0;
+  for (const char of turnId) hash = hash * 31 + char.charCodeAt(0) >>> 0;
+  return Array.from(
+    { length: Math.min(MAX_FOLLOWUPS, usable.length) },
+    (_, index) => usable[(hash + index) % usable.length]
+  );
+}
+const FOLLOWUPS_TIMEOUT_MS = 1e4;
+function createFollowupsFetcher(endpoint = "/api/chat/followups") {
+  return async (question, answer, signal) => {
+    try {
+      const response = await fetch(endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ question, answer }),
+        signal
+      });
+      if (!response.ok) return [];
+      const payload = await response.json();
+      const suggestions = payload?.suggestions;
+      if (!Array.isArray(suggestions)) return [];
+      return suggestions.filter((item) => typeof item === "string" && fitsChip(item)).slice(0, MAX_FOLLOWUPS);
+    } catch {
+      return [];
+    }
+  };
+}
+function followupTarget(turns) {
+  const last = turns[turns.length - 1];
+  if (!last || last.role !== "assistant") return null;
+  if (!last.exchangeId || last.followups || last.text === "") return null;
+  const question = turns[turns.length - 2];
+  if (!question || question.role !== "user") return null;
+  return { id: last.id, question: question.text, answer: last.text };
+}
+export {
+  DEFAULT_FALLBACK_FOLLOWUPS,
+  FOLLOWUPS_TIMEOUT_MS,
+  MAX_FOLLOWUPS,
+  createFollowupsFetcher,
+  followupTarget,
+  pickFallbackFollowups
+};

package/chat/greeting.d.ts

@@ -0,0 +1,11 @@
+/** The three greetings, overridable by a host that speaks differently. */
+export interface GreetingCopy {
+    morning: string;
+    afternoon: string;
+    evening: string;
+}
+export declare const DEFAULT_GREETING_COPY: GreetingCopy;
+export declare const greetingFor: (hour: number, copy?: GreetingCopy) => string;
+export declare const subscribeClock: () => () => void;
+export declare const readGreeting: () => string;
+export declare const serverGreeting: () => string;

package/chat/greeting.js

@@ -0,0 +1,21 @@
+const DEFAULT_GREETING_COPY = {
+  morning: "Good morning",
+  afternoon: "Good afternoon",
+  evening: "Good evening"
+};
+const greetingFor = (hour, copy = DEFAULT_GREETING_COPY) => {
+  if (hour >= 5 && hour < 12) return copy.morning;
+  if (hour >= 12 && hour < 17) return copy.afternoon;
+  return copy.evening;
+};
+const subscribeClock = () => () => {
+};
+const readGreeting = () => greetingFor((/* @__PURE__ */ new Date()).getHours());
+const serverGreeting = () => "";
+export {
+  DEFAULT_GREETING_COPY,
+  greetingFor,
+  readGreeting,
+  serverGreeting,
+  subscribeClock
+};

package/chat/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * rift-ds/chat: the composed chat widget and the engine under it.
+ *
+ * The widget: ChatProvider (the state), ChatWidget (the surface), ChatLauncher
+ * (the floating button and the docked / overlay / floating / takeover panel).
+ * The engine, importable on its own under your own markup: useChat, the
+ * transports, useThreads, and the event contract. The server half lives in
+ * rift-ds/chat/server; a scripted conversation for previews in
+ * rift-ds/chat/demo.
+ *
+ * Hand-written, unlike the component barrels: the registry generator never
+ * reaches src/chat, and this file is the one place the widget's public
+ * surface is declared (src/chat/registry.json names the same exports for the
+ * documentation, and validate-chat-widget.mjs holds the two together).
+ */
+export { ChatProvider, type ChatProviderProps } from './ChatProvider';
+export { ChatWidget, type ChatWidgetProps, type ChatAgentOptions, type RailSlot } from './ChatWidget';
+export { ChatLauncher, CHAT_PANEL_ID, type ChatLauncherProps } from './ChatLauncher';
+export { ChatThreads, type ChatThreadsProps } from './ChatThreads';
+export { ChatTabs, type ChatTabsProps } from './ChatTabs';
+export { ChatAgentPane, type ChatAgentPaneProps } from './ChatAgentPane';
+export { ChatArtifactPane, type ChatArtifactPaneProps } from './ChatArtifactPane';
+export { ChatArtifactCard, type ChatArtifactCardProps } from './ChatArtifactCard';
+export { useChatWidget, isInternalPath, createFeedbackPoster, type ChatView, type ChatArtifactRenderers, type ChatCardRenderers, type ChatLinkRenderer, type ChatWidgetContextValue, type FeedbackSink, } from './context';
+export { DOCK_QUERY, TAKEOVER_QUERY, THREADS_RAIL_MIN_WIDTH, ASIDE_RAIL_MIN_WIDTH, ARTIFACT_MIN_COLUMN_WIDTH, ASIDE_WITH_THREADS_MIN_WIDTH, useTakeoverViewport, } from './queries';
+export { useChat, DEFAULT_PLACEHOLDER_COPY, type ChatState, type ChatPlaceholderCopy, } from './useChat';
+export { useThreads, THREAD_NAMING_DELAY_MS, type ThreadsOptions, type ThreadsState } from './threads';
+export { createFetchTransport, DEFAULT_FETCH_COPY, FIRST_BYTE_TIMEOUT_MS, MAX_TRANSPORT_TURNS, type FetchTransportOptions, type FetchTransportCopy, } from './transport';
+export { scriptChat, createSimTransport, defaultFilesReply, DEFAULT_FALLBACK_REPLY, DEFAULT_SIM_TIMING, type ChatScript, type ChatScriptBuilder, type ScriptNode, type ScriptStep, type ScriptedReply, type SimTiming, } from './sim';
+export { createFollowupsFetcher, followupTarget, pickFallbackFollowups, DEFAULT_FALLBACK_FOLLOWUPS, MAX_FOLLOWUPS, FOLLOWUPS_TIMEOUT_MS, type FollowupsSource, } from './followups';
+export { SUGGESTION_MAX_CHARS, fitsChip } from './suggestions';
+export { STARTER_COUNT, pickStarters, namedStarter, hashString, mulberry32, } from './starters';
+export { greetingFor, readGreeting, serverGreeting, subscribeClock, DEFAULT_GREETING_COPY, type GreetingCopy, } from './greeting';
+export { CHAT_PLACEMENTS, chatPlacement, DOCK_MIN_WIDTH, DOCK_MAX_WIDTH, FLOAT_MAX_SCALE, FLOAT_EDGE_GAP, dockWidthFromDrag, isFloatDragStart, clampFloatPosition, type ChatPlacement, type ChatSide, } from './placement';
+export { artifactCard, cardArtifact } from './artifacts';
+export { ARTIFACT_CARD_KIND, CHAT_EVENT_KINDS, type ChatArtifact, type ChatCard, type ChatEvent, type ChatTransport, type ChatTransportMessage, type ChatTurn, type ChatModelOption, type ChatFeedbackVerdict, type LivePhase, type LiveResponse, type Starter, } from './types';
+export { chatWidget, chatWidgetRegistry, WIDGET_COUNT, type ChatWidgetMeta } from './registry';

package/chat/index.js

@@ -0,0 +1,90 @@
+import { ChatProvider } from "./ChatProvider.js";
+import { ChatWidget } from "./ChatWidget.js";
+import { CHAT_PANEL_ID, ChatLauncher } from "./ChatLauncher.js";
+import { ChatThreads } from "./ChatThreads.js";
+import { ChatTabs } from "./ChatTabs.js";
+import { ChatAgentPane } from "./ChatAgentPane.js";
+import { ChatArtifactPane } from "./ChatArtifactPane.js";
+import { ChatArtifactCard } from "./ChatArtifactCard.js";
+import { createFeedbackPoster, isInternalPath, useChatWidget } from "./context.js";
+import { ARTIFACT_MIN_COLUMN_WIDTH, ASIDE_RAIL_MIN_WIDTH, ASIDE_WITH_THREADS_MIN_WIDTH, DOCK_QUERY, TAKEOVER_QUERY, THREADS_RAIL_MIN_WIDTH, useTakeoverViewport } from "./queries.js";
+import { DEFAULT_PLACEHOLDER_COPY, useChat } from "./useChat.js";
+import { THREAD_NAMING_DELAY_MS, useThreads } from "./threads.js";
+import { DEFAULT_FETCH_COPY, FIRST_BYTE_TIMEOUT_MS, MAX_TRANSPORT_TURNS, createFetchTransport } from "./transport.js";
+import { DEFAULT_FALLBACK_REPLY, DEFAULT_SIM_TIMING, createSimTransport, defaultFilesReply, scriptChat } from "./sim.js";
+import { DEFAULT_FALLBACK_FOLLOWUPS, FOLLOWUPS_TIMEOUT_MS, MAX_FOLLOWUPS, createFollowupsFetcher, followupTarget, pickFallbackFollowups } from "./followups.js";
+import { SUGGESTION_MAX_CHARS, fitsChip } from "./suggestions.js";
+import { STARTER_COUNT, hashString, mulberry32, namedStarter, pickStarters } from "./starters.js";
+import { DEFAULT_GREETING_COPY, greetingFor, readGreeting, serverGreeting, subscribeClock } from "./greeting.js";
+import { CHAT_PLACEMENTS, DOCK_MAX_WIDTH, DOCK_MIN_WIDTH, FLOAT_EDGE_GAP, FLOAT_MAX_SCALE, chatPlacement, clampFloatPosition, dockWidthFromDrag, isFloatDragStart } from "./placement.js";
+import { artifactCard, cardArtifact } from "./artifacts.js";
+import { ARTIFACT_CARD_KIND, CHAT_EVENT_KINDS } from "./types.js";
+import { WIDGET_COUNT, chatWidget, chatWidgetRegistry } from "./registry.js";
+export {
+  ARTIFACT_CARD_KIND,
+  ARTIFACT_MIN_COLUMN_WIDTH,
+  ASIDE_RAIL_MIN_WIDTH,
+  ASIDE_WITH_THREADS_MIN_WIDTH,
+  CHAT_EVENT_KINDS,
+  CHAT_PANEL_ID,
+  CHAT_PLACEMENTS,
+  ChatAgentPane,
+  ChatArtifactCard,
+  ChatArtifactPane,
+  ChatLauncher,
+  ChatProvider,
+  ChatTabs,
+  ChatThreads,
+  ChatWidget,
+  DEFAULT_FALLBACK_FOLLOWUPS,
+  DEFAULT_FALLBACK_REPLY,
+  DEFAULT_FETCH_COPY,
+  DEFAULT_GREETING_COPY,
+  DEFAULT_PLACEHOLDER_COPY,
+  DEFAULT_SIM_TIMING,
+  DOCK_MAX_WIDTH,
+  DOCK_MIN_WIDTH,
+  DOCK_QUERY,
+  FIRST_BYTE_TIMEOUT_MS,
+  FLOAT_EDGE_GAP,
+  FLOAT_MAX_SCALE,
+  FOLLOWUPS_TIMEOUT_MS,
+  MAX_FOLLOWUPS,
+  MAX_TRANSPORT_TURNS,
+  STARTER_COUNT,
+  SUGGESTION_MAX_CHARS,
+  TAKEOVER_QUERY,
+  THREADS_RAIL_MIN_WIDTH,
+  THREAD_NAMING_DELAY_MS,
+  WIDGET_COUNT,
+  artifactCard,
+  cardArtifact,
+  chatPlacement,
+  chatWidget,
+  chatWidgetRegistry,
+  clampFloatPosition,
+  createFeedbackPoster,
+  createFetchTransport,
+  createFollowupsFetcher,
+  createSimTransport,
+  defaultFilesReply,
+  dockWidthFromDrag,
+  fitsChip,
+  followupTarget,
+  greetingFor,
+  hashString,
+  isFloatDragStart,
+  isInternalPath,
+  mulberry32,
+  namedStarter,
+  pickFallbackFollowups,
+  pickStarters,
+  readGreeting,
+  scriptChat,
+  serverGreeting,
+  subscribeClock,
+  useChat,
+  useChatWidget,
+  useTakeoverViewport,
+  useThreads
+};

package/chat/placement.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Where a chat panel sits: docked to either edge, or popped out as a
+ * floating card the visitor moves and sizes. One roster, so the header menu
+ * (ChatWidget), the launcher and any host stage all name the same three
+ * seats the same way. design.md's ChatWidget spec owns the behaviour each
+ * seat promises.
+ *
+ * No React and no component imports, like the dock query's home in
+ * ChatProvider: hosts deep in the tree read it without pulling the widget.
+ */
+/** The edge a docked panel takes, and the edge it overlays from below the dock threshold. */
+export type ChatSide = 'left' | 'right';
+/** A panel's seat: a dock edge, or floating free of both. */
+export type ChatPlacement = ChatSide | 'floating';
+export declare const CHAT_PLACEMENTS: readonly {
+    id: ChatPlacement;
+    label: string;
+    icon: string;
+}[];
+/** The roster entry for a placement: the header trigger wears its icon. */
+export declare const chatPlacement: (id: ChatPlacement) => {
+    id: ChatPlacement;
+    label: string;
+    icon: string;
+};
+export declare const DOCK_MIN_WIDTH = 420;
+export declare const DOCK_MAX_WIDTH = 655;
+/** A docked panel's width after a grip drag: the inner edge is the one
+    that moves, and it faces the other way on the left dock. */
+export declare function dockWidthFromDrag(startWidth: number, pointerDelta: number, side: ChatSide): number;
+export declare const FLOAT_MAX_SCALE = 1.2;
+export declare const FLOAT_EDGE_GAP = 8;
+/** Whether a pointerdown on `target` should start moving a floating card. */
+export declare function isFloatDragStart(target: EventTarget | null): boolean;
+/** Holds a moved card inside `bounds`, FLOAT_EDGE_GAP off each edge. A card
+    larger than the bounds pins to the leading edge rather than oscillating. */
+export declare function clampFloatPosition(x: number, y: number, size: {
+    width: number;
+    height: number;
+}, bounds: {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}): {
+    x: number;
+    y: number;
+};

package/chat/placement.js

@@ -0,0 +1,39 @@
+const CHAT_PLACEMENTS = [
+  { id: "right", label: "Dock right", icon: "dock_to_left" },
+  { id: "left", label: "Dock left", icon: "dock_to_right" },
+  { id: "floating", label: "Floating", icon: "picture_in_picture" }
+];
+const chatPlacement = (id) => CHAT_PLACEMENTS.find((placement) => placement.id === id) ?? CHAT_PLACEMENTS[0];
+const DOCK_MIN_WIDTH = 420;
+const DOCK_MAX_WIDTH = 655;
+function dockWidthFromDrag(startWidth, pointerDelta, side) {
+  const grown = startWidth + (side === "left" ? pointerDelta : -pointerDelta);
+  return Math.round(Math.min(DOCK_MAX_WIDTH, Math.max(DOCK_MIN_WIDTH, grown)));
+}
+const FLOAT_MAX_SCALE = 1.2;
+const FLOAT_EDGE_GAP = 8;
+const FLOAT_DRAG_ZONE = ".ds-chat-header";
+const FLOAT_DRAG_EXEMPT = "button, a, input, textarea, select, [role='button'], [role='menu']";
+function isFloatDragStart(target) {
+  if (!(target instanceof Element)) return false;
+  return Boolean(target.closest(FLOAT_DRAG_ZONE)) && !target.closest(FLOAT_DRAG_EXEMPT);
+}
+function clampFloatPosition(x, y, size, bounds) {
+  const minX = bounds.left + FLOAT_EDGE_GAP;
+  const minY = bounds.top + FLOAT_EDGE_GAP;
+  return {
+    x: Math.round(Math.min(Math.max(minX, bounds.right - size.width - FLOAT_EDGE_GAP), Math.max(minX, x))),
+    y: Math.round(Math.min(Math.max(minY, bounds.bottom - size.height - FLOAT_EDGE_GAP), Math.max(minY, y)))
+  };
+}
+export {
+  CHAT_PLACEMENTS,
+  DOCK_MAX_WIDTH,
+  DOCK_MIN_WIDTH,
+  FLOAT_EDGE_GAP,
+  FLOAT_MAX_SCALE,
+  chatPlacement,
+  clampFloatPosition,
+  dockWidthFromDrag,
+  isFloatDragStart
+};

package/chat/queries.d.ts

@@ -0,0 +1,18 @@
+export declare const DOCK_QUERY = "(min-width: 1440px)";
+export declare const TAKEOVER_QUERY = "(max-width: 719px)";
+/** The widget's own width thresholds for seating its rails inline. */
+export declare const THREADS_RAIL_MIN_WIDTH = 720;
+/** The trailing seat's threshold, one number for both of its tenants: at
+    this width and up the agent pane and the artifact panel sit beside the
+    conversation, below it each rises as a bottom sheet. */
+export declare const ASIDE_RAIL_MIN_WIDTH = 760;
+/** Below this the inline threads rail yields its room to a trailing panel
+    seated inline, and goes back behind the header's hamburger. */
+export declare const ASIDE_WITH_THREADS_MIN_WIDTH = 1040;
+/** The floor either column keeps while an artifact is dragged wider or
+    narrower: the conversation never loses more than this, nor the panel. */
+export declare const ARTIFACT_MIN_COLUMN_WIDTH = 320;
+/** Whether the viewport is a phone width (TAKEOVER_QUERY), false on the
+    server and for the first client render. Shared by the launcher and any
+    host stage, which both hand the widget its phone layout. */
+export declare function useTakeoverViewport(): boolean;

package/chat/queries.js

@@ -0,0 +1,26 @@
+"use client";
+import { useSyncExternalStore } from "react";
+const DOCK_QUERY = "(min-width: 1440px)";
+const TAKEOVER_QUERY = "(max-width: 719px)";
+const THREADS_RAIL_MIN_WIDTH = 720;
+const ASIDE_RAIL_MIN_WIDTH = 760;
+const ASIDE_WITH_THREADS_MIN_WIDTH = 1040;
+const ARTIFACT_MIN_COLUMN_WIDTH = 320;
+const subscribeTakeover = (onChange) => {
+  const media = window.matchMedia(TAKEOVER_QUERY);
+  media.addEventListener("change", onChange);
+  return () => media.removeEventListener("change", onChange);
+};
+const readTakeover = () => window.matchMedia(TAKEOVER_QUERY).matches;
+function useTakeoverViewport() {
+  return useSyncExternalStore(subscribeTakeover, readTakeover, () => false);
+}
+export {
+  ARTIFACT_MIN_COLUMN_WIDTH,
+  ASIDE_RAIL_MIN_WIDTH,
+  ASIDE_WITH_THREADS_MIN_WIDTH,
+  DOCK_QUERY,
+  TAKEOVER_QUERY,
+  THREADS_RAIL_MIN_WIDTH,
+  useTakeoverViewport
+};

package/chat/registry.d.ts

@@ -0,0 +1,25 @@
+/** One widget's metadata, as the registry records it. */
+export interface ChatWidgetMeta {
+    name: string;
+    slug: string;
+    label: string;
+    description: string;
+    /** The component category whose /components section and sidebar group the widget's page joins. */
+    category: string;
+    /** The init bin's subcommand that scaffolds it. */
+    command: string;
+    /** Each package subpath the widget occupies, with what it holds. */
+    subpaths: Record<string, string>;
+    /** The optional peer dependencies each subpath needs. */
+    peers: Record<string, string[]>;
+    /** The library components the widget composes. */
+    parts: string[];
+    /** The exported components whose props are documented through docgen. */
+    documented: string[];
+}
+export declare const chatWidgetRegistry: {
+    widgets: ChatWidgetMeta[];
+};
+/** The one widget, by design. */
+export declare const chatWidget: ChatWidgetMeta;
+export declare const WIDGET_COUNT: number;

package/chat/registry.js

@@ -0,0 +1,9 @@
+import registry from "./registry.json.js";
+const chatWidgetRegistry = registry;
+const chatWidget = registry.widgets[0];
+const WIDGET_COUNT = registry.widgets.length;
+export {
+  WIDGET_COUNT,
+  chatWidget,
+  chatWidgetRegistry
+};

package/chat/registry.json.d.ts

@@ -0,0 +1,74 @@
+declare const _default: {
+  "$comment": "The widget registry: the fourth kind of thing the package ships, between the components and the templates. One member by design. `parts` names the library components the widget composes (held to src/components/registry.json by scripts/validate-chat-widget.mjs), `subpaths` the package exports it occupies (held to scripts/package-manifest.mjs), `category` the component category whose section and sidebar group its page joins (held to src/components/registry.json), `peers` the optional peer dependencies each subpath needs (held to package.json). The widget's page under /components, the /docs/chat page, the chat corpus and the MCP tools read this file; never type its facts elsewhere.",
+  "widgets": [
+    {
+      "name": "ChatWidget",
+      "slug": "ai-chat",
+      "label": "AI chat",
+      "category": "ai",
+      "description": "The whole AI chat, assembled: the panel, the streaming replies, the history, the cards a reply can carry and the server handlers, set up with props.",
+      "command": "init chat",
+      "subpaths": {
+        "./chat": "The widget, the provider, the launcher and the engine under them.",
+        "./chat/server": "The streaming chat handler and its follow-ups and feedback siblings, for any web-standard route.",
+        "./chat/upstash": "Rate limits, a daily budget and the exchange log over Upstash Redis, as the handlers' guardrails.",
+        "./chat/demo": "A scripted conversation with rich cards and fixtures, for a preview that needs no key.",
+        "./chat/chat.css": "The widget's stylesheet."
+      },
+      "peers": {
+        "./chat": [
+          "react-markdown",
+          "remark-gfm"
+        ],
+        "./chat/server": [
+          "@anthropic-ai/sdk"
+        ],
+        "./chat/upstash": [
+          "@upstash/ratelimit",
+          "@upstash/redis"
+        ],
+        "./chat/demo": [
+          "recharts"
+        ]
+      },
+      "parts": [
+        "AgentRail",
+        "AgentStatus",
+        "AiButton",
+        "ArtifactCard",
+        "ArtifactPanel",
+        "AttachmentDropZone",
+        "AttachmentGroup",
+        "ChatHeader",
+        "ChatMessage",
+        "ChatThread",
+        "CircularButton",
+        "CodeBlock",
+        "Composer",
+        "DropdownMenu",
+        "EmptyState",
+        "Mention",
+        "ModelPicker",
+        "PixelAvatar",
+        "PromptSuggestions",
+        "Prose",
+        "Reasoning",
+        "ThreadPanel",
+        "ThreadTabs"
+      ],
+      "documented": [
+        "ChatWidget",
+        "ChatProvider",
+        "ChatLauncher",
+        "ChatThreads",
+        "ChatTabs",
+        "ChatAgentPane",
+        "ChatArtifactPane",
+        "ChatArtifactCard"
+      ]
+    }
+  ]
+}
+;
+
+export default _default;

package/chat/registry.json.js

@@ -0,0 +1,11 @@
+const $comment = "The widget registry: the fourth kind of thing the package ships, between the components and the templates. One member by design. `parts` names the library components the widget composes (held to src/components/registry.json by scripts/validate-chat-widget.mjs), `subpaths` the package exports it occupies (held to scripts/package-manifest.mjs), `category` the component category whose section and sidebar group its page joins (held to src/components/registry.json), `peers` the optional peer dependencies each subpath needs (held to package.json). The widget's page under /components, the /docs/chat page, the chat corpus and the MCP tools read this file; never type its facts elsewhere.";
+const widgets = [{ "name": "ChatWidget", "slug": "ai-chat", "label": "AI chat", "category": "ai", "description": "The whole AI chat, assembled: the panel, the streaming replies, the history, the cards a reply can carry and the server handlers, set up with props.", "command": "init chat", "subpaths": { "./chat": "The widget, the provider, the launcher and the engine under them.", "./chat/server": "The streaming chat handler and its follow-ups and feedback siblings, for any web-standard route.", "./chat/upstash": "Rate limits, a daily budget and the exchange log over Upstash Redis, as the handlers' guardrails.", "./chat/demo": "A scripted conversation with rich cards and fixtures, for a preview that needs no key.", "./chat/chat.css": "The widget's stylesheet." }, "peers": { "./chat": ["react-markdown", "remark-gfm"], "./chat/server": ["@anthropic-ai/sdk"], "./chat/upstash": ["@upstash/ratelimit", "@upstash/redis"], "./chat/demo": ["recharts"] }, "parts": ["AgentRail", "AgentStatus", "AiButton", "ArtifactCard", "ArtifactPanel", "AttachmentDropZone", "AttachmentGroup", "ChatHeader", "ChatMessage", "ChatThread", "CircularButton", "CodeBlock", "Composer", "DropdownMenu", "EmptyState", "Mention", "ModelPicker", "PixelAvatar", "PromptSuggestions", "Prose", "Reasoning", "ThreadPanel", "ThreadTabs"], "documented": ["ChatWidget", "ChatProvider", "ChatLauncher", "ChatThreads", "ChatTabs", "ChatAgentPane", "ChatArtifactPane", "ChatArtifactCard"] }];
+const registry = {
+  $comment,
+  widgets
+};
+export {
+  $comment,
+  registry as default,
+  widgets
+};