@calliopelabs/ui 0.12.0 → 0.14.0

package/dist/chat/useAgUiRun.js

@@ -0,0 +1,137 @@
+"use client";
+import { EventType } from "@ag-ui/core";
+import * as React from "react";
+import { createChatView, foldChat, reduceChat } from "./model.js";
+/** The person's own message as the events that fold it into the view. */
+export function userMessageEvents(id, text) {
+    return [
+        { type: EventType.TEXT_MESSAGE_START, messageId: id, role: "user" },
+        { type: EventType.TEXT_MESSAGE_CONTENT, messageId: id, delta: text },
+        { type: EventType.TEXT_MESSAGE_END, messageId: id },
+    ];
+}
+const message = (error) => error instanceof Error && error.message
+    ? error.message
+    : typeof error === "string" && error
+        ? error
+        : "The event stream failed.";
+/**
+ * Holds a `ChatView` and folds a host-provided AG-UI event source into it,
+ * one run at a time. No network code: the host connects, authenticates and
+ * sends input, and hands the hook what comes back.
+ *
+ *   const chat = useAgUiRun();
+ *   onSubmit={(text) => {
+ *     chat.dispatch(userMessageEvents(id(), text));
+ *     void chat.run(agent.stream({ threadId, text }));
+ *   }}
+ */
+export function useAgUiRun({ initialView, onError } = {}) {
+    const [view, setView] = React.useState(() => initialView ?? createChatView());
+    const [running, setRunning] = React.useState(false);
+    const current = React.useRef(null);
+    const onErrorRef = React.useRef(onError);
+    React.useEffect(() => {
+        onErrorRef.current = onError;
+    });
+    const release = React.useCallback(() => {
+        const active = current.current;
+        current.current = null;
+        active?.release();
+    }, []);
+    React.useEffect(() => release, [release]);
+    const run = React.useCallback((source) => {
+        release();
+        let live = true;
+        let cleanup = () => { };
+        let stopped = () => { };
+        const halted = new Promise((resolve) => {
+            stopped = () => resolve("stopped");
+        });
+        const token = {
+            release: () => {
+                live = false;
+                cleanup();
+                stopped();
+            },
+        };
+        current.current = token;
+        setRunning(true);
+        const fold = (event) => {
+            if (live)
+                setView((v) => reduceChat(v, event));
+        };
+        const end = (error) => {
+            if (!live)
+                return;
+            live = false;
+            if (current.current === token)
+                current.current = null;
+            if (error !== undefined) {
+                setView((v) => reduceChat(v, { type: EventType.RUN_ERROR, message: message(error) }));
+                onErrorRef.current?.(error);
+            }
+            setRunning(false);
+        };
+        if (typeof source === "function") {
+            let finished = () => { };
+            const ended = new Promise((resolve) => {
+                finished = resolve;
+            });
+            try {
+                const unsubscribe = source(fold, (error) => {
+                    end(error);
+                    finished();
+                });
+                if (live)
+                    cleanup = unsubscribe;
+                else
+                    unsubscribe();
+            }
+            catch (error) {
+                end(error);
+                finished();
+            }
+            return Promise.race([ended, halted]).then(() => { });
+        }
+        return (async () => {
+            try {
+                const iterator = source[Symbol.asyncIterator]();
+                cleanup = () => void iterator.return?.()?.catch(() => { });
+                for (;;) {
+                    const next = await Promise.race([iterator.next(), halted]);
+                    if (next === "stopped" || next.done)
+                        break;
+                    fold(next.value);
+                }
+                end();
+            }
+            catch (error) {
+                end(error);
+            }
+        })();
+    }, [release]);
+    const stop = React.useCallback(() => {
+        if (!current.current)
+            return;
+        release();
+        setRunning(false);
+        setView((v) => v.status === "running"
+            ? reduceChat(v, {
+                type: EventType.RUN_FINISHED,
+                threadId: v.threadId ?? "",
+                runId: v.runId ?? "",
+                outcome: { type: "cancelled" },
+            })
+            : v);
+    }, [release]);
+    const dispatch = React.useCallback((events) => {
+        setView((v) => foldChat(Array.isArray(events) ? events : [events], v));
+    }, []);
+    const reset = React.useCallback((next) => {
+        release();
+        setRunning(false);
+        setView(next ?? createChatView());
+    }, [release]);
+    return { view, running, run, stop, dispatch, reset };
+}

package/dist/index.d.ts

@@ -76,7 +76,7 @@ export { ReviewPanel, type ReviewPanelProps } from "./workflow/ReviewPanel.js";
 export { MediaReview, formatTimecode, type MediaAnchor, type MediaCaptionTrack, type MediaComment, type MediaRegion, type MediaReviewProps, } from "./workflow/MediaReview.js";
 export { DocumentReview, type DocumentAnnotation, type DocumentBlock, type DocumentPage, type DocumentReviewProps, type DocumentSegment, type DocumentSignOff, type SignOffStatus, } from "./workflow/DocumentReview.js";
 export { FormReview, type FormField, type FormFieldBox, type FormFieldStatus, type FormReviewProps, type FormSourcePage, } from "./workflow/FormReview.js";
-export { IN, LOOP_IN, LOOP_OUT, OUT, WORKFLOW_DEFINITION_VERSION, WORKFLOW_NODE_KINDS, WORKFLOW_SELECTORS, addNode, canConnect, createNode, dataTypes, downstream, edgeId, exitLabel, exitsOf, findFact, findGateKind, findPreset, freshId, inputsOf, isJudge, moveNode, operatorsFor, outputsOf, portOf, removeEdge, removeNode, startOf, typeAccepts, updateEdge, updateNode, upstream, withFlow, type WorkflowCase, type WorkflowCheckNode, type WorkflowClassifierNode, type WorkflowClassifierOption, type WorkflowCondition, type WorkflowConditionNode, type WorkflowConnectReason, type WorkflowConnectResult, type WorkflowConnection, type WorkflowDataType, type WorkflowDefinition, type WorkflowEdge, type WorkflowEvaluatorNode, type WorkflowFact, type WorkflowFactType, type WorkflowFanoutNode, type WorkflowFlow, type WorkflowGateField, type WorkflowGateKind, type WorkflowGateNode, type WorkflowGatePolicy, type WorkflowGotoNode, type WorkflowJoinNode, type WorkflowJudgeNode, type WorkflowModuleSpec, type WorkflowNode, type WorkflowNodeKind, type WorkflowNodeOf, type WorkflowNodeTemplate, type WorkflowOperator, type WorkflowOption, type WorkflowPort, type WorkflowPosition, type WorkflowRegistry, type WorkflowSelection, type WorkflowSelector, type WorkflowStepNode, type WorkflowStepPreset, type WorkflowSubflowNode, type WorkflowVariant, type WorkflowVariantsNode, } from "./workflow/definition.js";
+export { IN, LOOP_IN, LOOP_OUT, OUT, WORKFLOW_DEFINITION_VERSION, WORKFLOW_FLOW_NAME, WORKFLOW_MAX_FLOWS, WORKFLOW_NODE_KINDS, WORKFLOW_SELECTORS, addFlow, addNode, canConnect, createNode, dataTypes, downstream, edgeId, exitLabel, exitsOf, findFact, findGateKind, findPreset, flowNameProblem, freshId, inputsOf, isJudge, moveNode, operatorsFor, outputsOf, portOf, removeEdge, removeNode, renameFlow, startOf, typeAccepts, updateEdge, updateNode, upstream, withFlow, type WorkflowCase, type WorkflowCheckNode, type WorkflowClassifierNode, type WorkflowClassifierOption, type WorkflowCondition, type WorkflowConditionNode, type WorkflowConnectReason, type WorkflowConnectResult, type WorkflowConnection, type WorkflowDataType, type WorkflowDefinition, type WorkflowEdge, type WorkflowEvaluatorNode, type WorkflowFact, type WorkflowFactType, type WorkflowFanoutNode, type WorkflowFlow, type WorkflowFlowNameProblem, type WorkflowGateField, type WorkflowGateKind, type WorkflowGateNode, type WorkflowGatePolicy, type WorkflowGotoNode, type WorkflowJoinNode, type WorkflowJudgeNode, type WorkflowModuleSpec, type WorkflowNode, type WorkflowNodeKind, type WorkflowNodeOf, type WorkflowNodeTemplate, type WorkflowOperator, type WorkflowOption, type WorkflowPort, type WorkflowPosition, type WorkflowRegistry, type WorkflowSelection, type WorkflowSelector, type WorkflowStepNode, type WorkflowStepPreset, type WorkflowSubflowNode, type WorkflowVariant, type WorkflowVariantsNode, } from "./workflow/definition.js";
 export { WORKFLOW_PROBLEM_CODES, blockingProblems, checkDefinition, definitionAvailability, nodeAvailability, type WorkflowProblem, type WorkflowProblemCode, type WorkflowProblemLevel, } from "./workflow/problems.js";
 export { WORKFLOW_PACKAGE_FORMAT, WORKFLOW_PACKAGE_VERSION, diffDefinitions, exportWorkflowPackage, previewWorkflowImport, readWorkflowDefinition, readWorkflowPackage, requirementsOf, sameDefinition, type WorkflowDefinitionDiff, type WorkflowDiffEdge, type WorkflowDiffItem, type WorkflowDisabledNode, type WorkflowFlowDiff, type WorkflowImportSummary, type WorkflowModuleGap, type WorkflowPackage, type WorkflowReadError, type WorkflowReadResult, type WorkflowRequirements, } from "./workflow/portable.js";
 export { NODE_HEADER, NODE_WIDTH, PORT_ROW, arrangeFlow, layoutFlow, nodeSize, portRows, ranksOf, regionsOf, type WorkflowRegion, } from "./workflow/layout.js";
@@ -84,9 +84,18 @@ export { insertPaletteItem, paletteOf, type WorkflowPaletteGroup, type WorkflowP
 export { READABLE_ZOOM, WorkflowCanvas, type WorkflowCanvasProps, } from "./workflow/canvas/WorkflowCanvas.js";
 export { WorkflowPalette, type WorkflowPaletteProps } from "./workflow/editor/WorkflowPalette.js";
 export { WorkflowProblems, problemTarget, type WorkflowProblemsProps, } from "./workflow/editor/WorkflowProblems.js";
-export { ConditionEditor, GatePolicyEditor, WorkflowInspector, type WorkflowInspectorProps, } from "./workflow/editor/WorkflowInspector.js";
+export { ConditionEditor, GatePolicyEditor, WorkflowInspector, type WorkflowInspectorProps, type WorkflowNodeFieldsContext, } from "./workflow/editor/WorkflowInspector.js";
 export { WorkflowJsonView, type WorkflowJsonViewProps, } from "./workflow/editor/WorkflowJsonView.js";
 export { documentStatus, type WorkflowDocumentStatus, type WorkflowRevision, } from "./workflow/workspace.js";
 export { WorkflowDiff, type WorkflowDiffProps } from "./workflow/editor/WorkflowDiff.js";
 export { WorkflowImportPreview, type WorkflowImportPreviewProps, } from "./workflow/editor/WorkflowImportPreview.js";
 export { WorkflowWorkspace, type WorkflowWorkspaceProps, } from "./workflow/editor/WorkflowWorkspace.js";
+export { contentText, createChatView, foldChat, isChatRunning, parseToolCallArgs, reduceChat, type AgUiEvent, type AgUiInterrupt, type ChatApproval, type ChatMessage, type ChatRole, type ChatRunStatus, type ChatStep, type ChatStepStatus, type ChatTimelineItem, type ChatToolCall, type ChatToolCallStatus, type ChatView, } from "./chat/model.js";
+export { applyJsonPatch } from "./chat/patch.js";
+export { MessageBubble, type ChatContentRenderer, type MessageBubbleProps, } from "./chat/MessageBubble.js";
+export { MessageList, type MessageListProps } from "./chat/MessageList.js";
+export { Composer, type ComposerProps } from "./chat/Composer.js";
+export { ToolCallCard, type ToolCallCardProps } from "./chat/ToolCallCard.js";
+export { AgentProgress, CHAT_RUN_TONE, chatStepStages, type AgentProgressProps, } from "./chat/AgentProgress.js";
+export { ModelPicker, type ModelPickerProps } from "./chat/ModelPicker.js";
+export { useAgUiRun, userMessageEvents, type AgUiEventSource, type AgUiRun, type AgUiSubscribe, type UseAgUiRunOptions, } from "./chat/useAgUiRun.js";

package/dist/index.js

@@ -85,7 +85,7 @@ export { ReviewPanel } from "./workflow/ReviewPanel.js";
 export { MediaReview, formatTimecode, } from "./workflow/MediaReview.js";
 export { DocumentReview, } from "./workflow/DocumentReview.js";
 export { FormReview, } from "./workflow/FormReview.js";
-export { IN, LOOP_IN, LOOP_OUT, OUT, WORKFLOW_DEFINITION_VERSION, WORKFLOW_NODE_KINDS, WORKFLOW_SELECTORS, addNode, canConnect, createNode, dataTypes, downstream, edgeId, exitLabel, exitsOf, findFact, findGateKind, findPreset, freshId, inputsOf, isJudge, moveNode, operatorsFor, outputsOf, portOf, removeEdge, removeNode, startOf, typeAccepts, updateEdge, updateNode, upstream, withFlow, } from "./workflow/definition.js";
+export { IN, LOOP_IN, LOOP_OUT, OUT, WORKFLOW_DEFINITION_VERSION, WORKFLOW_FLOW_NAME, WORKFLOW_MAX_FLOWS, WORKFLOW_NODE_KINDS, WORKFLOW_SELECTORS, addFlow, addNode, canConnect, createNode, dataTypes, downstream, edgeId, exitLabel, exitsOf, findFact, findGateKind, findPreset, flowNameProblem, freshId, inputsOf, isJudge, moveNode, operatorsFor, outputsOf, portOf, removeEdge, removeNode, renameFlow, startOf, typeAccepts, updateEdge, updateNode, upstream, withFlow, } from "./workflow/definition.js";
 export { WORKFLOW_PROBLEM_CODES, blockingProblems, checkDefinition, definitionAvailability, nodeAvailability, } from "./workflow/problems.js";
 export { WORKFLOW_PACKAGE_FORMAT, WORKFLOW_PACKAGE_VERSION, diffDefinitions, exportWorkflowPackage, previewWorkflowImport, readWorkflowDefinition, readWorkflowPackage, requirementsOf, sameDefinition, } from "./workflow/portable.js";
 export { NODE_HEADER, NODE_WIDTH, PORT_ROW, arrangeFlow, layoutFlow, nodeSize, portRows, ranksOf, regionsOf, } from "./workflow/layout.js";
@@ -99,3 +99,13 @@ export { documentStatus, } from "./workflow/workspace.js";
 export { WorkflowDiff } from "./workflow/editor/WorkflowDiff.js";
 export { WorkflowImportPreview, } from "./workflow/editor/WorkflowImportPreview.js";
 export { WorkflowWorkspace, } from "./workflow/editor/WorkflowWorkspace.js";
+// Chat (AG-UI)
+export { contentText, createChatView, foldChat, isChatRunning, parseToolCallArgs, reduceChat, } from "./chat/model.js";
+export { applyJsonPatch } from "./chat/patch.js";
+export { MessageBubble, } from "./chat/MessageBubble.js";
+export { MessageList } from "./chat/MessageList.js";
+export { Composer } from "./chat/Composer.js";
+export { ToolCallCard } from "./chat/ToolCallCard.js";
+export { AgentProgress, CHAT_RUN_TONE, chatStepStages, } from "./chat/AgentProgress.js";
+export { ModelPicker } from "./chat/ModelPicker.js";
+export { useAgUiRun, userMessageEvents, } from "./chat/useAgUiRun.js";

package/dist/primitives/Button.d.ts

@@ -6,7 +6,7 @@ import type * as React from "react";
  * reaches buttons as it reaches panels.
  */
 export declare const buttonVariants: (props?: ({
-    variant?: "link" | "default" | "outline" | "secondary" | "ghost" | "destructive" | null | undefined;
+    variant?: "destructive" | "link" | "default" | "outline" | "secondary" | "ghost" | null | undefined;
     size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface ButtonProps extends React.ComponentProps<"button">, VariantProps<typeof buttonVariants> {

package/dist/provider/messages.d.ts

@@ -1,8 +1,9 @@
 import type { ProductTheme } from "../appearance/product.js";
+import type { ChatRole, ChatRunStatus, ChatToolCallStatus } from "../chat/model.js";
 import type { WorkflowQuestionState } from "../workflow/question.js";
 import type { WorkflowAction, WorkflowAvailability, WorkflowScope, WorkflowStatus } from "../workflow/model.js";
 import type { ArtifactStatus, GateStatus, ReviewDecision, ReviewVerdict, RunStageStatus } from "../workflow/run.js";
-import type { WorkflowConnectReason, WorkflowNode, WorkflowNodeKind, WorkflowSelector } from "../workflow/definition.js";
+import type { WorkflowConnectReason, WorkflowFlowNameProblem, WorkflowNode, WorkflowNodeKind, WorkflowSelector } from "../workflow/definition.js";
 /** The names a node's summary line uses, looked up by the caller. */
 export interface WorkflowSummaryNames {
     /** A step's or variants' preset, and its module. */
@@ -394,6 +395,22 @@ export interface Messages {
         importing: string;
         importedNotice: string;
         importAvailability: (status: WorkflowAvailability["status"]) => string;
+        newFlow: string;
+        newFlowTitle: string;
+        newFlowDescription: string;
+        createFlow: string;
+        renameFlow: string;
+        renameFlowTitle: (name: string) => string;
+        renameFlowDescription: string;
+        rename: string;
+        flowName: string;
+        flowNameHint: string;
+        flowLabel: string;
+        flowLabelHint: string;
+        flowNameProblem: (problem: WorkflowFlowNameProblem) => string;
+        flowsFull: (max: number) => string;
+        flowCreatedNotice: (name: string) => string;
+        flowRenamedNotice: (name: string) => string;
         modules: string;
         noModules: string;
         moduleStatus: (status: "available" | "missing" | "version" | "unavailable", installed?: string) => string;
@@ -534,6 +551,71 @@ export interface Messages {
         /** A field extraction found nothing in. */
         empty: string;
     };
+    chat: {
+        /** The message list's name. */
+        conversation: string;
+        empty: string;
+        emptyDescription: string;
+        /** Who said it: "You", "Assistant", "System", "Developer", "Tool". */
+        role: (role: ChatRole) => string;
+        /** A message's accessible name. */
+        messageFrom: (speaker: string) => string;
+        /** An answer that has started but has no text yet. */
+        thinking: string;
+        /** Read after a message still being written. */
+        writing: string;
+        jumpToLatest: string;
+        runFailed: string;
+        retry: string;
+        /** The composer's field. */
+        composer: string;
+        placeholder: string;
+        composerHint: string;
+        send: string;
+        stop: string;
+        attachments: string;
+        /** A tool call's accessible name. */
+        toolCall: (name: string) => string;
+        toolStatus: (status: ChatToolCallStatus | "approval") => string;
+        details: string;
+        arguments: string;
+        noArguments: string;
+        result: string;
+        toolError: string;
+        approvalNeeded: string;
+        approve: string;
+        deny: string;
+        approveTitle: (name: string) => string;
+        approveDescription: string;
+        denyTitle: (name: string) => string;
+        denyDescription: string;
+        denyReason: string;
+        /** The agent progress section's name. */
+        progress: string;
+        steps: string;
+        runStatus: (status: ChatRunStatus) => string;
+        model: string;
+    };
+    agent: {
+        /** The assistant's name: the panel's title and the launcher's. Takes the product's name when there is one. */
+        title: (product?: string) => string;
+        /** The launcher's name when closed and open. */
+        open: (title: string) => string;
+        close: string;
+        /** Read with the launcher's name: "2 unread". */
+        unread: (count: number) => string;
+        newConversation: string;
+        expand: string;
+        restore: string;
+        /** The suggestion chips' group. */
+        suggestions: string;
+        emptyTitle: string;
+        emptyDescription: string;
+        /** Under the composer while a tool waits on the person. */
+        waitingOnYou: string;
+        /** The shortcut as people read it, from the key list ("⌘/", "Ctrl+/"). */
+        shortcut: (keys: string) => string;
+    };
 }
 export declare const defaultMessages: Messages;
 /** Any subset of the messages, one level deep. */

package/dist/provider/messages.js

@@ -600,6 +600,26 @@ export const defaultMessages = {
         importAction: "Import",
         importing: "Importing",
         importedNotice: "Imported.",
+        newFlow: "New flow",
+        newFlowTitle: "New flow",
+        newFlowDescription: "An empty flow beside the others. A sub-flow node runs it.",
+        createFlow: "Create flow",
+        renameFlow: "Rename flow",
+        renameFlowTitle: (name) => `Rename ${name}`,
+        renameFlowDescription: "Sub-flow nodes that run it, and the main flow, follow the new name.",
+        rename: "Rename",
+        flowName: "Name",
+        flowNameHint: "Lowercase letters, digits and dashes, starting with a letter. Up to 32.",
+        flowLabel: "Label",
+        flowLabelHint: "How the flow is shown. Its name when empty.",
+        flowNameProblem: (problem) => ({
+            empty: "Give the flow a name.",
+            format: "Use lowercase letters, digits and dashes, starting with a letter, up to 32.",
+            taken: "Another flow has this name.",
+        })[problem],
+        flowsFull: (max) => `A workflow holds at most ${count(max)} flows.`,
+        flowCreatedNotice: (name) => `Flow ${name} created.`,
+        flowRenamedNotice: (name) => `Flow renamed to ${name}.`,
         importAvailability: (status) => ({
             available: "Runs here",
             "missing-capabilities": "Missing capabilities here",
@@ -761,6 +781,77 @@ export const defaultMessages = {
         cancel: "Cancel",
         empty: "Nothing found",
     },
+    chat: {
+        conversation: "Conversation",
+        empty: "No messages yet",
+        emptyDescription: "Ask a question to start.",
+        role: (role) => ({
+            user: "You",
+            assistant: "Assistant",
+            system: "System",
+            developer: "Developer",
+            tool: "Tool",
+        })[role],
+        messageFrom: (speaker) => `Message from ${speaker}`,
+        thinking: "Thinking",
+        writing: "Still writing",
+        jumpToLatest: "Jump to latest",
+        runFailed: "The run failed",
+        retry: "Retry",
+        composer: "Message",
+        placeholder: "Ask anything",
+        composerHint: "Enter to send, Shift+Enter for a new line.",
+        send: "Send",
+        stop: "Stop",
+        attachments: "Attachments",
+        toolCall: (name) => `Tool call ${name}`,
+        toolStatus: (status) => ({
+            streaming: "preparing",
+            running: "running",
+            complete: "done",
+            failed: "failed",
+            cancelled: "cancelled",
+            approval: "needs approval",
+        })[status],
+        details: "Details",
+        arguments: "Arguments",
+        noArguments: "No arguments",
+        result: "Result",
+        toolError: "Error",
+        approvalNeeded: "The agent is waiting for your approval to run this.",
+        approve: "Approve",
+        deny: "Deny",
+        approveTitle: (name) => `Run ${name}?`,
+        approveDescription: "The agent runs it with the arguments shown and continues.",
+        denyTitle: (name) => `Deny ${name}?`,
+        denyDescription: "The agent does not run it and is told why.",
+        denyReason: "Reason",
+        progress: "Agent progress",
+        steps: "Steps",
+        runStatus: (status) => ({
+            idle: "idle",
+            running: "running",
+            finished: "finished",
+            interrupted: "waiting for you",
+            cancelled: "stopped",
+            error: "failed",
+        })[status],
+        model: "Model",
+    },
+    agent: {
+        title: (product) => (product ? `${product} assistant` : "Assistant"),
+        open: (title) => `Open ${title}`,
+        close: "Close",
+        unread: (count) => `${count.toLocaleString("en")} unread`,
+        newConversation: "New conversation",
+        expand: "Expand",
+        restore: "Restore",
+        suggestions: "Suggestions",
+        emptyTitle: "How can I help?",
+        emptyDescription: "Ask about what is on this page, or pick a starting point.",
+        waitingOnYou: "Answer the card above to continue.",
+        shortcut: (keys) => `Shortcut ${keys}`,
+    },
 };
 export function mergeMessages(overrides) {
     if (!overrides)

package/dist/theme/mappings/palette.d.ts

@@ -0,0 +1,52 @@
+import { ACCENT_KEYS, DEFAULT_ACCENT, GROUNDS, GROUND_KEYS, type FamilyAccent, type Ground, type StatusName } from "../tokens.js";
+export declare const COLOR_TOKENS: readonly ["background", "foreground", "card", "card-foreground", "popover", "popover-foreground", "primary", "primary-foreground", "secondary", "secondary-foreground", "muted", "muted-foreground", "accent", "accent-foreground", "destructive", "border", "input", "ring", "chart-1", "chart-2", "chart-3", "chart-4", "chart-5", "sidebar", "sidebar-foreground", "sidebar-primary", "sidebar-primary-foreground", "sidebar-accent", "sidebar-accent-foreground", "sidebar-border", "sidebar-ring", "sidebar-muted-foreground", "surface-0", "surface-1", "surface-2", ...(StatusName | "success-fg" | "warning-fg" | "info-fg" | "danger-fg" | "success-bg" | "warning-bg" | "info-bg" | "danger-bg" | "success-border" | "warning-border" | "info-border" | "danger-border")[]];
+export type ColorToken = (typeof COLOR_TOKENS)[number];
+export type Palette = Record<ColorToken, string>;
+export { ACCENT_KEYS, DEFAULT_ACCENT, GROUNDS, GROUND_KEYS };
+export type { FamilyAccent, Ground };
+/** The ground `:root` paints when nothing chooses one (the preset's default). */
+export declare const DEFAULT_GROUND: Ground;
+/**
+ * The type stacks of the preset (`--font-sans`, `--font-mono`, `--font-head`
+ * in preset.css; a test holds them equal). Each names the app's loaded font
+ * variable first, then the family, then system fallbacks.
+ */
+export declare const FONTS: {
+    readonly sans: "var(--font-plex-sans, \"IBM Plex Sans\"), system-ui, sans-serif";
+    readonly mono: "var(--font-plex-mono, \"IBM Plex Mono\"), ui-monospace, SFMono-Regular, Menlo, monospace";
+    readonly head: "var(--font-dm-sans, \"DM Sans\"), system-ui, sans-serif";
+};
+/** The family a stack names, for targets that take one font name (React Native). */
+export declare function fontFamily(stack: string): string;
+/** `--radius` in px, and the motion durations in ms, as numbers. */
+export declare function staticNumbers(): {
+    radius: number;
+    motion: Record<"fast" | "base" | "slow", number>;
+};
+export interface Rgba {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+/** Parses `#rrggbb` or `rgba(r, g, b, a)`; anything else is a token this module does not know. */
+export declare function parseColor(value: string): Rgba;
+/**
+ * A translucent token laid on its surface, for targets with no alpha
+ * (a terminal, Tk): `sidebar-*` tokens on the sidebar, the rest on the
+ * background. Opaque tokens come back as they are.
+ */
+export declare function flatten(palette: Palette, token: ColorToken): Rgba;
+/** The concrete palette of one ground with one family accent, with no product brand. */
+export declare function resolvePalette(ground: Ground, accent?: FamilyAccent): Palette;
+/** Every ground with every family accent. */
+export declare function allPalettes(): Record<Ground, Record<FamilyAccent, Palette>>;
+/**
+ * A target's values split for compact output: per ground, the entries every
+ * accent agrees on, and per ground and accent, the entries that move with
+ * the accent.
+ */
+export declare function splitByAccent<K extends string, V>(values: (ground: Ground, accent: FamilyAccent) => Record<K, V>): {
+    ground: Record<Ground, Partial<Record<K, V>>>;
+    accent: Record<Ground, Record<FamilyAccent, Partial<Record<K, V>>>>;
+};