@exegia/corpora-ui 0.29.0 → 1.0.0

package/dist-lib/src/components/composed/action-bar/utils.d.ts

@@ -0,0 +1,57 @@
+import { ComponentType } from 'react';
+import { Tooltip } from '@base-ui/react/tooltip';
+import { ActionBarSegment, ActionEntry, ActionItemsByGroup, ActionKey, ActionMap, EmojiActionBarProps } from './types';
+import { Emoji } from 'frimousse';
+export declare const tooltipHandle: Tooltip.Handle<ComponentType>;
+export declare const isSeparator: (key: string) => boolean;
+/**
+ * Splits `actions` into render-ready segments at every `separator-*` key.
+ *
+ * Order comes from the map's insertion order (see `ActionMap`) — the grouping
+ * is positional, so actions written before a separator group ahead of it.
+ * Empty groups are dropped, which is what keeps a leading, trailing or
+ * doubled separator from rendering a `ToolbarGroup` with nothing in it.
+ */
+export declare const useActionBar: ({ actions, }: {
+    actions: ActionMap<ActionKey>;
+}) => {
+    segments: ActionBarSegment[];
+    entries: ActionEntry[];
+    hasGroups: boolean;
+    groupsCount: number;
+    separatorCount: number;
+    actionItemsByGroup: ActionItemsByGroup;
+};
+/**
+ * The quick row. frimousse has no way to render a subset — `EmojiPicker.Root`
+ * takes `columns`/`skinTone`/`locale`/`emojiVersion`/`emojibaseUrl`/`sticky`
+ * and nothing else, and its list is virtualized on fixed-height rows, so a
+ * custom `Emoji` component that returns null leaves holes rather than a short
+ * row. A fixed list is the only way to show just these, and it costs no
+ * network request — the CDN fetch only happens if "More" is opened.
+ */
+export declare const QUICK_REACTIONS: readonly Emoji[];
+/**
+ * Hook for managing the emoji picker state and actions.
+ *
+ * @param props - The emoji picker props.
+ * @returns The emoji picker state and actions.
+ *
+ * @example
+ * ```tsx
+ * const { isFullPicker, quickReactions, actions, togglePicker, selectEmoji } = useEmojiPicker({ onEmojiSelect });
+ * ```
+ */
+export declare const useEmojiPicker: ({ onEmojiSelect, reactions, hideMore, }: EmojiActionBarProps) => {
+    isFullPicker: boolean;
+    quickReactions: readonly {
+        emoji: string;
+        label: string;
+    }[];
+    actions: readonly {
+        emoji: string;
+        label: string;
+    }[];
+    togglePicker: () => void;
+    selectEmoji: (emoji: Emoji) => void;
+};

package/dist-lib/src/components/composed/ai/avatar.d.ts

@@ -0,0 +1 @@
+export declare const Avatar: () => import("react").JSX.Element;

package/dist-lib/src/components/composed/ai/index.d.ts

@@ -0,0 +1,17 @@
+import { Message } from './message';
+import { StreamingText } from './streaming-text';
+import { ResearchAnswer } from './research-answer';
+import { SuggestedPrompt } from './suggested-prompt';
+export type { SuggestedPromptProps } from './suggested-prompt';
+export { accentRing, accentSolid, accentText, agentText, ghostMuted, glassCard, mutedText, surface, } from './shared';
+export { type StreamingTextProps, type StreamingToken } from './streaming-text';
+export type { ResearchAnswerProps } from './research-answer';
+export type { AISuggestionBase, DiffRow, ReferenceBase, SuggestionState, } from './types';
+declare const AI: {
+    Message: typeof Message;
+    Avatar: () => import("react").JSX.Element;
+    StreamingText: typeof StreamingText;
+    SuggestedPrompt: typeof SuggestedPrompt;
+    ResearchAnswer: typeof ResearchAnswer;
+};
+export default AI;

package/dist-lib/src/components/composed/ai/message.d.ts

@@ -0,0 +1,7 @@
+import { AIMessageProps, AIMessageType } from './types';
+/**
+ * An agent turn: author row, prose body and — when the model proposed
+ * changes — a "Suggestions" disclosure that fans the cards out below with a
+ * staggered spring.
+ */
+export declare function Message<T extends AIMessageType>({ children, isStreaming, className, AttachedContent, type, contentProps, ...props }: AIMessageProps<T>): React.ReactElement;

package/dist-lib/src/components/composed/ai/research-answer.d.ts

@@ -0,0 +1,30 @@
+import type * as React from "react";
+export interface ResearchReference {
+    /** Pill label, e.g. "Iliad · Homer corpus". */
+    label: React.ReactNode;
+    /** Preview-card content shown on hover. */
+    favicon?: string;
+    title?: React.ReactNode;
+    description?: React.ReactNode;
+    href?: string;
+}
+export interface ResearchAnswerProps extends Omit<React.ComponentPropsWithoutRef<"div">, "content"> {
+    kicker?: React.ReactNode;
+    /** "Answered from 3 passages · 0.8 s" */
+    kickerSub?: React.ReactNode;
+    content: React.ReactNode;
+    source?: React.ReactNode | ResearchReference;
+    date?: React.ReactNode;
+    authors?: React.ReactNode | ResearchReference;
+    onCopyCitation?: () => void;
+    onShare?: () => void;
+    /** TODO(spec 003): the design shows the control only; behaviour is the caller's. */
+    onAddToList?: () => void;
+    bare?: boolean;
+}
+/**
+ * Research answer card: kicker, content, Source / Date / Author(s) meta, actions.
+ *
+ * @sketch "Component / Research Answer"
+ */
+export declare function ResearchAnswer({ kicker, kickerSub, content, source, date, authors, onCopyCitation, onShare, onAddToList, bare, className, ...props }: ResearchAnswerProps): React.ReactElement;

package/dist-lib/src/components/composed/ai/shared.d.ts

@@ -0,0 +1,19 @@
+import { Variants } from 'motion';
+import type * as React from "react";
+export declare const accentText = "text-amber-600 dark:text-amber-300/90";
+export declare const accentRing = "ring-offset-0 focus-visible:ring-amber-400/40";
+export declare const accentSolid: string;
+export declare const agentText = "text-violet-600 dark:text-violet-400";
+export declare const ghostMuted: string;
+export declare const mutedText = "text-[13px] leading-5 text-muted-foreground";
+export declare const surface = "border bg-popover text-popover-foreground shadow-lg";
+/** The AI spark — the accent-coloured ✦ that marks every AI affordance. */
+export declare function AiIcon({ className, }: {
+    className?: string;
+}): React.ReactElement;
+export declare function CloseIcon(): React.ReactElement;
+export declare const glassCard = "rounded-md border-0 border-t-2 border-t-white/70 bg-neutral-200/45 shadow-none backdrop-blur-[3px] backdrop-saturate-125 before:hidden dark:border-t-neutral-700 dark:bg-neutral-800/50";
+export declare const LIST_VARIANTS: Variants;
+export declare const ITEM_VARIANTS: Variants;
+/** Children.toArray, but looking through fragments so `<>{a}{b}</>` counts two. */
+export declare function flattenChildren(children: React.ReactNode): React.ReactNode[];

package/dist-lib/src/components/composed/ai/streaming-text.d.ts

@@ -0,0 +1,26 @@
+import * as React from "react";
+/** A word, or an inline citation; extra fields turn the chip into a hover preview. */
+export type StreamingToken = {
+    text: string;
+} | {
+    cite: string;
+    favicon?: string;
+    title?: string;
+    description?: string;
+    href?: string;
+};
+export interface StreamingTextProps extends React.ComponentPropsWithoutRef<"div"> {
+    /** Paragraphs, each a token list; a string is split on spaces. */
+    paragraphs: (string | StreamingToken[])[];
+    /** Reveal words over time and show the caret. */
+    streaming?: boolean;
+    /** Reveal gap in ms; defaults to the --stream-gap token (60ms). */
+    wordMs?: number;
+}
+/**
+ * Streamed answer: paragraphs with inline source previews and a caret.
+ * Actions, sources and follow-ups belong to the host.
+ *
+ * @sketch "Component / Streaming Text"
+ */
+export declare function StreamingText({ paragraphs, streaming, wordMs, className, ...props }: StreamingTextProps): React.ReactElement;

package/dist-lib/src/components/composed/ai/suggested-prompt.d.ts

@@ -0,0 +1,35 @@
+import { HTMLMotionProps } from 'motion/react';
+import type * as React from "react";
+export interface SuggestedPromptProps extends Omit<HTMLMotionProps<"button">, "children" | "onSelect"> {
+    /** The prompt itself — what the person would have typed. */
+    children: React.ReactNode;
+    onSelect?: () => void;
+    /**
+     * Shared-layout id. Give the resulting message bubble the same id and the
+     * row flies into it when this one unmounts.
+     */
+    layoutId?: string;
+}
+/**
+ * One suggested prompt: a violet spark, the prompt, and a `+` marking that
+ * picking it drops the prompt into the thread. The whole row is the control —
+ * the `+` is an affordance, not a second action.
+ */
+export declare function SuggestedPrompt({ children, onSelect, layoutId, className, ...props }: SuggestedPromptProps): React.ReactElement;
+export interface SuggestedPromptsProps extends Omit<HTMLMotionProps<"div">, "children"> {
+    /** The `SuggestedPrompt` rows. */
+    children: React.ReactNode;
+    /** Overrides the count derived from `children`. */
+    count?: number;
+    /** Names the disclosure. `Suggestions (n)` by default. */
+    label?: (count: number) => React.ReactNode;
+    defaultOpen?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+/**
+ * The "Suggestions (n)" disclosure above the composer: a chevron that swings
+ * from left (folded) to down (open) and a panel of prompts that fans out
+ * beneath it, its bottom edge tucked behind the composer pill.
+ */
+export declare function SuggestedPrompts({ children, count, label, defaultOpen, open: openProp, onOpenChange, className, ...props }: SuggestedPromptsProps): React.ReactElement | null;

package/dist-lib/src/components/composed/ai/types.d.ts

@@ -0,0 +1,66 @@
+import { ChartProps, ComposerSuggestionsProps, MarkdownProps, RecommendationStackProps, ResearchAnswerProps, UserType } from '../../../index';
+import type * as React from "react";
+export type SuggestionState = "accepted" | "rejected" | "pending";
+export interface DiffRow {
+    type: "add" | "remove";
+    value: React.ReactNode;
+    field?: string;
+}
+/** A word, or an inline citation; extra fields turn the chip into a hover preview. */
+export type StreamingToken = {
+    text: string;
+} | {
+    cite: string;
+    favicon?: string;
+    title?: string;
+    description?: string;
+    href?: string;
+};
+export interface StreamingTextProps extends React.ComponentPropsWithoutRef<"div"> {
+    /** Paragraphs, each a token list; a string is split on spaces. */
+    paragraphs: (string | StreamingToken[])[];
+    /** Reveal words over time and show the caret. */
+    streaming?: boolean;
+    /** Reveal gap in ms; defaults to the --stream-gap token (60ms). */
+    wordMs?: number;
+}
+/** Kind → props map for message content; the source of truth for `AIContentProps`. */
+export interface AIContentPropsMap {
+    markdown: MarkdownProps;
+    research: ResearchAnswerProps;
+    chart: ChartProps;
+    suggestion: ComposerSuggestionsProps;
+    recommendation: RecommendationStackProps;
+}
+export type AIMessageType = keyof AIContentPropsMap;
+/** Discriminated union of `{ kind } & props`, distributed over `T`. */
+export type AIContentProps<T extends AIMessageType = AIMessageType> = {
+    [K in T]: {
+        kind: K;
+    } & AIContentPropsMap[K];
+}[T];
+export interface AIMessageProps<T extends AIMessageType = AIMessageType> {
+    /** Identity shown in the header. */
+    user?: UserType;
+    type: T;
+    thinking?: boolean;
+    /** Replaces the default `User.Info` identity row in the header. */
+    AttachedContent?: React.ComponentType<AIContentProps<T>>;
+    /** Props forwarded to `AttachedContent`, typed by `type`. */
+    contentProps?: AIContentPropsMap[T];
+    children?: React.ReactNode;
+    isStreaming?: boolean;
+    className?: string;
+}
+export interface ReferenceBase {
+    id: string;
+    title?: string;
+    url?: string;
+}
+export interface AISuggestionBase {
+    heading: string;
+    description?: string | React.ReactNode;
+    state?: SuggestionState;
+    updatedAt?: string;
+    references?: ReferenceBase[] | ReferenceBase;
+}

package/dist-lib/src/components/composed/attachment.story.d.ts

@@ -0,0 +1,3 @@
+import { Attachment } from './chat/attachment';
+export declare const story: import('@fumadocs/story/vite/client').Story<typeof Attachment>;
+export declare const Preview: import('react').FC;

package/dist-lib/src/components/composed/chart.story.d.ts

@@ -0,0 +1,3 @@
+import { FC } from 'react';
+export declare const story: import('@fumadocs/story/vite/client').Story<FC<Pick<import('./chat').ChartProps, "data" | "title" | "type" | "subtitle" | "series" | "headerless" | "plotHeight">>>;
+export declare const Preview: FC;

package/dist-lib/src/components/composed/chat/__tests__/attachment.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/src/components/composed/chat/__tests__/beautiful-ui.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/src/components/composed/chat/__tests__/chart.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/src/components/composed/chat/__tests__/code-block.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/src/components/composed/chat/__tests__/composer-attachments.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/src/components/composed/chat/__tests__/composer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/src/components/composed/chat/__tests__/flowchart.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/src/components/composed/chat/__tests__/markdown.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/src/components/composed/chat/actions.d.ts

@@ -0,0 +1,2 @@
+import { IBubbleActionsProps, TBubbleActionKey } from './type';
+export declare function Actions<K extends TBubbleActionKey = TBubbleActionKey>({ actions, size, onClick, }: IBubbleActionsProps<K>): import("react").JSX.Element;

package/dist-lib/src/components/composed/chat/attachment.d.ts

@@ -0,0 +1,62 @@
+import type * as React from "react";
+export type AttachmentKind = "document" | "image" | "media" | "text-selection" | "chat-reply" | "username-handle" | "url-link";
+export type AttachmentVariant = "default" | "preview";
+interface AttachmentBase {
+    id?: string;
+    className?: string;
+    style?: React.CSSProperties;
+    /** `default` is the 240×52 composer chip; `preview` the in-bubble rendering. */
+    variant?: AttachmentVariant;
+    /** Primary line of the chip (file name, handle, URL, source…). */
+    title: React.ReactNode;
+    /** Secondary line of the chip ("PDF · 2.4 MB", "Link · fetching preview"…). */
+    meta?: React.ReactNode;
+    /** Fires from the chip's ✕. Omit (or pass `removable={false}`) to hide it. */
+    onRemove?: () => void;
+    removable?: boolean;
+}
+export type AttachmentProps = AttachmentBase & ({
+    kind: "document";
+    onAction?: () => void;
+    actionIcon?: React.ReactNode;
+} | {
+    kind: "image";
+    src?: string;
+    alt?: string;
+} | {
+    kind: "media";
+    src?: string;
+    poster?: string;
+    duration?: React.ReactNode;
+    audio?: boolean;
+    onPlay?: () => void;
+    waveform?: number[];
+} | {
+    kind: "text-selection";
+    quote?: React.ReactNode;
+} | {
+    kind: "chat-reply";
+    author?: React.ReactNode;
+    time?: React.ReactNode;
+    body?: React.ReactNode;
+} | {
+    kind: "username-handle";
+    src?: string;
+    initials?: string;
+} | {
+    kind: "url-link";
+    src?: string;
+    domain?: React.ReactNode;
+    description?: React.ReactNode;
+    favicon?: string;
+    href?: string;
+});
+/**
+ * One attachment in every shape the chat needs — a composer chip before
+ * sending (`variant="default"`) or the rendering inside a bubble
+ * (`variant="preview"`).
+ *
+ * @sketch "Component / Attachment / {Image, Media, Document, Text Selection, Chat Reply, Username Handle, URL Link} / {Default, Preview}", "Component / Attachment / Media / Preview Audio"
+ */
+export declare function Attachment(props: AttachmentProps): React.ReactElement;
+export {};

package/dist-lib/src/components/composed/chat/chart.d.ts

@@ -0,0 +1,41 @@
+import type * as React from "react";
+export type ChartType = "pie" | "area" | "line" | "bar";
+export interface ChartSeries {
+    /** Key into each data row. */
+    key: string;
+    label: React.ReactNode;
+    /** Defaults to `var(--chart-series-N)` by position. */
+    color?: string;
+    /** Renders a value in the legend and tooltip (`v => \`${v}%\``). */
+    format?: (value: number) => React.ReactNode;
+}
+export type ChartDatum = {
+    label: string;
+    [key: string]: string | number;
+};
+export interface ChartProps extends Omit<React.ComponentPropsWithoutRef<"div">, "title"> {
+    type: ChartType;
+    title?: React.ReactNode;
+    subtitle?: React.ReactNode;
+    /** Pill text; defaults to the capitalised type. */
+    badge?: React.ReactNode;
+    data: ChartDatum[];
+    /** Series to plot; pie uses the first one. */
+    series: ChartSeries[];
+    /** Pie only: big number and caption in the donut's centre. */
+    center?: {
+        value: React.ReactNode;
+        label?: React.ReactNode;
+    };
+    /** Drop the title row (InsightCards embeds a bare plot). */
+    headerless?: boolean;
+    /** Plot height in px; the card is 244 tall with the header. */
+    plotHeight?: number;
+}
+/**
+ * 320×244 chart card: title, subtitle, type pill, plot, x labels, legend.
+ * Series colours are the `--chart-series-*` tokens, grid is `--chart-grid`.
+ *
+ * @sketch "Component / Chart / {Pie, Area, Line, Bar}"
+ */
+export declare function Chart({ type, title, subtitle, badge, data, series, center, headerless, plotHeight, className, ...props }: ChartProps): React.ReactElement;

package/dist-lib/src/components/composed/chat/code-block.d.ts

@@ -0,0 +1,26 @@
+import * as React from "react";
+export interface CodeDiffLine {
+    type?: "add" | "remove" | "context";
+    text: string;
+}
+export interface CodeBlockProps extends Omit<React.ComponentPropsWithoutRef<"div">, "onCopy"> {
+    filename?: React.ReactNode;
+    code: string;
+    /** Optional diff view; when absent the toggle is hidden. */
+    diff?: CodeDiffLine[];
+    view?: "code" | "diff";
+    defaultView?: "code" | "diff";
+    onViewChange?: (view: "code" | "diff") => void;
+    onCopy?: (code: string) => void;
+    /** Extra keywords for the tokenizer. */
+    keywords?: string[];
+}
+/** Minimal highlighter: string literals and keywords only, as in the design. */
+export declare function tokenize(line: string, keywords: ReadonlySet<string>): React.ReactNode[];
+/**
+ * Code card: filename header, Code | Diff toggle, Copy; gutter line numbers
+ * and keyword / string tinting from the `--code-*` tokens.
+ *
+ * @sketch "Component / Code Block"
+ */
+export declare function CodeBlock({ filename, code, diff, view, defaultView, onViewChange, onCopy, keywords, className, ...props }: CodeBlockProps): React.ReactElement;

package/dist-lib/src/components/composed/chat/composer/add-button.d.ts

@@ -0,0 +1,5 @@
+import { ButtonProps } from '../../../ui/button';
+import { PopoverTriggerState } from '@base-ui/react';
+export declare function AddButton({ state, ...props }: ButtonProps & {
+    state: PopoverTriggerState;
+}): import("react").JSX.Element;

package/dist-lib/src/components/composed/chat/composer/base.d.ts

@@ -0,0 +1,8 @@
+import { IComposerProps } from '../type';
+import type * as React from "react";
+/**
+ * Prompt field with two shapes: a pill at rest showing the "⌘ + ↵" hint,
+ * that squares off into a taller field on focus with the attach and Send
+ * controls springing in along its bottom edge.
+ */
+export declare function Composer({ value, onValueChange, composerId, attachments: seedAttachments, isStreaming, disabled, safetyNote, expanded, placeholder, SubmitButton, ComposerMenu, Suggestions, defaultValue, onSubmit, onStop, className, }: IComposerProps): React.ReactElement;

package/dist-lib/src/components/composed/chat/composer/command-menu.d.ts

@@ -0,0 +1,2 @@
+import { IComposerMenuProps } from '../type';
+export declare function CommandMenu({ items, onCommand, }: IComposerMenuProps): React.ReactElement;

package/dist-lib/src/components/composed/chat/composer/hooks.d.ts

@@ -0,0 +1,9 @@
+import { ComposerAttachment } from '../type';
+/** Read the tray of one composer. */
+export declare function useComposerAttachments(composerId: string): ComposerAttachment[];
+/** Write-only tray actions; never re-renders the caller when the tray changes. */
+export declare function useComposerAttachmentActions(composerId: string): {
+    add: (item: ComposerAttachment) => void;
+    remove: (itemId: string) => void;
+    clear: () => void;
+};

package/dist-lib/src/components/composed/chat/composer/index.d.ts

@@ -0,0 +1,10 @@
+import { Composer } from './base';
+export type * from '../type';
+export { Composer };
+export { SendButton } from './send-button';
+export { AddButton } from './add-button';
+export { CommandMenu } from './command-menu';
+export { SuggestedPrompts } from './suggestions';
+export { addComposerAttachmentAtom, clearComposerAttachmentsAtom, composerAttachmentsAtom, removeComposerAttachmentAtom, removeComposerInstance, } from './utils';
+export { useComposerAttachmentActions, useComposerAttachments } from './hooks';
+export default Composer;

package/dist-lib/src/components/composed/chat/composer/send-button.d.ts

@@ -0,0 +1,3 @@
+import { ButtonProps } from '../../../ui/button';
+import { IComposerSubmitButtonProps } from '../type';
+export declare function SendButton({ isStreaming, isExpanded, disabled, onStop, ...props }: IComposerSubmitButtonProps & ButtonProps): React.ReactElement;

package/dist-lib/src/components/composed/chat/composer/suggestions.d.ts

@@ -0,0 +1,7 @@
+import { SuggestedPromptsProps } from '../type';
+/**
+ * The "Suggestions (n)" disclosure above the composer: a chevron that swings
+ * from left (folded) to down (open) and a panel of prompts that fans out
+ * beneath it, its bottom edge tucked behind the composer pill.
+ */
+export declare function SuggestedPrompts({ children, count, label, defaultOpen, open: openProp, onOpenChange, className, ...props }: SuggestedPromptsProps): React.ReactElement | null;

package/dist-lib/src/components/composed/chat/composer/utils.d.ts

@@ -0,0 +1,19 @@
+import { ComposerAttachment } from '../type';
+import { Variants } from 'motion';
+export declare const composerAttachmentsAtom: import('../../../../lib/keyed-atom').Family<import('jotai').PrimitiveAtom<ComposerAttachment[]> & {
+    init: ComposerAttachment[];
+}>;
+export declare const addComposerAttachmentAtom: import('../../../../lib/keyed-atom').Family<import('jotai').WritableAtom<null, [item: ComposerAttachment], void> & {
+    init: null;
+}>;
+export declare const removeComposerAttachmentAtom: import('../../../../lib/keyed-atom').Family<import('jotai').WritableAtom<null, [itemId: string], void> & {
+    init: null;
+}>;
+export declare const clearComposerAttachmentsAtom: import('../../../../lib/keyed-atom').Family<import('jotai').WritableAtom<null, [], void> & {
+    init: null;
+}>;
+export declare const removeComposerInstance: (id: string) => void;
+/** Children.toArray, but looking through fragments so `<>{a}{b}</>` counts two. */
+export declare function flattenChildren(children: React.ReactNode): React.ReactNode[];
+export declare const LIST_VARIANTS: Variants;
+export declare const ITEM_VARIANTS: Variants;

package/dist-lib/src/components/composed/chat/context-cards.d.ts

@@ -0,0 +1,27 @@
+import type * as React from "react";
+export interface ContextCard {
+    id?: string;
+    title: React.ReactNode;
+    /** "290 characters" */
+    meta?: React.ReactNode;
+    snippet: React.ReactNode;
+    file?: {
+        name: React.ReactNode;
+        type: string;
+    };
+    icon?: React.ReactNode;
+}
+export interface ContextCardsProps extends React.ComponentPropsWithoutRef<"div"> {
+    header?: React.ReactNode;
+    cards: ContextCard[];
+    /** Count pill; defaults to `cards.length`. */
+    count?: React.ReactNode;
+    onOpen?: (card: ContextCard, index: number) => void;
+}
+/**
+ * Retrieved chunks: header with a count pill, then one card per chunk with
+ * title, character count, snippet and the source file pill.
+ *
+ * @sketch "Component / Context Cards"
+ */
+export declare function ContextCards({ header, cards, count, onOpen, className, ...props }: ContextCardsProps): React.ReactElement;

package/dist-lib/src/components/composed/chat/filter-table.d.ts

@@ -0,0 +1,40 @@
+import { DotTone } from '../../ui/chat';
+import * as React from "react";
+/** Active filter id, keyed by `tableId`; `null` means "All". */
+export declare const filterTableFilterAtom: import('../../../lib/keyed-atom').Family<import('jotai').PrimitiveAtom<string | null> & {
+    init: string | null;
+}>;
+export declare const removeFilterTableInstance: (id: string) => void;
+export interface FilterTableStatus {
+    id: string;
+    label: React.ReactNode;
+    tone: DotTone;
+}
+export interface FilterTableColumn<Row> {
+    key: keyof Row & string;
+    header: React.ReactNode;
+    className?: string;
+}
+export interface FilterTableProps<Row extends {
+    id: string;
+    status: string;
+}> extends React.ComponentPropsWithoutRef<"div"> {
+    tableId?: string;
+    statuses: FilterTableStatus[];
+    columns: FilterTableColumn<Row>[];
+    /** Column key rendered with the status dot (defaults to "status"). */
+    statusKey?: keyof Row & string;
+    rows: Row[];
+    allLabel?: React.ReactNode;
+    filter?: string | null;
+    onFilterChange?: (filter: string | null) => void;
+}
+/**
+ * Status filter pills over a compact task table.
+ *
+ * @sketch "Component / Filter Table"
+ */
+export declare function FilterTable<Row extends {
+    id: string;
+    status: string;
+}>({ tableId, statuses, columns, statusKey, rows, allLabel, filter, onFilterChange, className, ...props }: FilterTableProps<Row>): React.ReactElement;

package/dist-lib/src/components/composed/chat/flowchart/chart-node.d.ts

@@ -0,0 +1,2 @@
+import { ChartNodeProps } from './types';
+export declare function ChartNode({ node, index, onRef, children }: ChartNodeProps): import("react").JSX.Element;

package/dist-lib/src/components/composed/chat/flowchart/connector.d.ts

@@ -0,0 +1,2 @@
+import { ConnectorProps } from './types';
+export declare function Connector({ edge, isLit, selected, onPick, strokeWidth, ...props }: ConnectorProps): import("react").JSX.Element;

package/dist-lib/src/components/composed/chat/flowchart/constant.d.ts

@@ -0,0 +1,15 @@
+export declare const PAD_Y = 24;
+export declare const ROW_GAP = 64;
+export declare const PILL_OFFSET = 30;
+export declare const SNAP_RADIUS = 40;
+export declare const PURPLE = "#9a5cff";
+export declare const AMBER = "#f09a2f";
+export declare const EST_H: Record<string, number>;
+export declare const PROPERTIES: string[];
+export declare const FLAVORS: {
+    name: string;
+    tag: string;
+}[];
+export declare const TOPPINGS: {
+    name: string;
+}[];

package/dist-lib/src/components/composed/chat/flowchart/default.d.ts

@@ -0,0 +1,7 @@
+import { FlowchartProps } from './types';
+/**
+ * Dot-grid canvas of draggable, selectable step cards joined by bezier connectors.
+ *
+ * @sketch "Component / Flowchart"
+ */
+export default function Flowchart({ steps, edges, readOnly, zoomable, height, onDrag, onAdd, onRemove, onEdgeRemove, onEdgeConnect, onEdgeChange, onRename, onDuplicate, className, children }: FlowchartProps): import("react").JSX.Element;

package/dist-lib/src/components/composed/chat/flowchart/edge-toolbar.d.ts

@@ -0,0 +1,9 @@
+import { Edge } from './types';
+import { Point } from './utils';
+/** Floats at a selected connector's midpoint: stroke widths, colours, disconnect. */
+export declare function EdgeToolbar({ edge, at, onChange, onRemove, }: {
+    edge: Edge;
+    at: Point;
+    onChange?: (id: string, patch: Pick<Edge, "strokeWidth" | "color">) => void;
+    onRemove?: (id: string) => void;
+}): import("react").JSX.Element;