e2eea086dc
═══════════════════════════════════════════════════════════════════════
@bytelyst/ai-ui bump 0.1.0 → 0.4.0
═══════════════════════════════════════════════════════════════════════
Folds three more roadmap milestones into the flagship package.
0.2: <ToolCallCard> — disclosure card; status pill, JSON preview
<CitationChip> — inline citation marker + hover preview
useToolCalls() — per-turn tool-invocation state machine
(begin/update/settle/clear); preserves insertion
order across updates; auto-computes durationMs
0.3: <AgentTimeline> — vertical think→act→observe→respond trace;
embeds ToolCallCard for kind='tool_call' steps
<ModelPicker> — model dropdown with capability chips, cost,
latency, context window, disabled gating
0.4: <ToolPalette> — searchable tool list with MCP-style discovery
(source can be ToolDescriptor[] OR an
'mcp://...' URL resolved via a discover
adapter; default adapter is fetch+JSON)
Types extended:
- ToolInvocation, ToolCallStatus, Citation added
- Message gains optional toolInvocations + citations
Tests: 53/53 (27 old + 26 new) · typecheck clean · 7.65 KB / 35 KB
═══════════════════════════════════════════════════════════════════════
NEW PACKAGE: @bytelyst/command-palette@0.1.0
═══════════════════════════════════════════════════════════════════════
Wave 3 deliverable — Cmd-K dialog with three modes and pluggable command
registration. Roadmap §Wave 3 of ROADMAP_2026.md.
What's exported:
<CommandRegistryProvider> — wrap your app once
<CommandPalette> — the dialog (Cmd-K / Ctrl-K)
useRegisterCommands() — contribute commands for component lifetime
useCommands() — read snapshot
useCommandRegistry() — imperative access
useCommandPalette() — open/close state + global hotkey
fuzzyScore / scoreCommand — exposed for tests + custom UIs
Three modes:
actions — invoke a registered run()
navigate — jump to href via onNavigate or window.location
ask-ai — host-supplied askAiPanel; default renders an 'Ask AI: <q>'
suggestion that products can wire to <ChatStream>
Keyboard:
↑ ↓ navigate selection
Enter activate
Tab cycle mode tabs (Shift+Tab reverses)
Esc close
Niceties:
- Fuzzy matcher (substring + subsequence with light scoring)
- localStorage-backed recents float to top of actions mode
- requires() gate hides commands wholesale (auth / feature-flag)
- aria-haspopup, role=dialog, role=listbox, role=option, aria-selected
- Backdrop click closes; Esc handler at document level
- Hotkey suppressed by Cmd-K / Ctrl-K default; configurable
Tests: 26/26 · typecheck clean · 3.91 KB / 15 KB
═══════════════════════════════════════════════════════════════════════
CI plumbing
═══════════════════════════════════════════════════════════════════════
- .size-limit.cjs gains @bytelyst/command-palette entry
- .gitea/workflows/size-limit.yml build filter expanded
- All 8 measured packages comfortably under budget
Refs:
learning_ai_uxui_web/docs/ROADMAP_2026.md §Wave 2 (0.2/0.3/0.4)
learning_ai_uxui_web/docs/ROADMAP_2026.md §Wave 3 (Command palette)
docs/ROADMAP_2026_DECISIONS.md §10 (Vercel AI SDK shape continues)
65 lines
2.5 KiB
TypeScript
65 lines
2.5 KiB
TypeScript
/**
|
|
* @bytelyst/ai-ui — AI-native UI primitives.
|
|
*
|
|
* Exports (Wave 2 — 0.4.0):
|
|
* Components
|
|
* 0.1: <ChatStream>, <MessageBubble>, <PromptComposer>
|
|
* 0.2: <ToolCallCard>, <CitationChip>
|
|
* 0.3: <AgentTimeline>, <ModelPicker>
|
|
* 0.4: <ToolPalette> (MCP-style discovery)
|
|
* Hooks
|
|
* 0.1: useChat()
|
|
* 0.2: useToolCalls()
|
|
* Utilities
|
|
* 0.1: streamText()
|
|
*
|
|
* Coming in 0.5.x (per ROADMAP §Wave 2):
|
|
* - <Markdown>, <CodeDiff>, <ExplainThis>
|
|
* - usePromptHistory(), useTokenCount()
|
|
*/
|
|
|
|
export { ChatStream } from './ChatStream.js';
|
|
export type { ChatStreamProps } from './ChatStream.js';
|
|
|
|
export { MessageBubble } from './MessageBubble.js';
|
|
export type { MessageBubbleProps } from './MessageBubble.js';
|
|
|
|
export { PromptComposer } from './PromptComposer.js';
|
|
export type { PromptComposerHandle, PromptComposerProps } from './PromptComposer.js';
|
|
|
|
export { useChat } from './useChat.js';
|
|
export { streamText } from './useStreamingText.js';
|
|
|
|
// ── 0.2 surfaces ───────────────────────────────────────────────────────────
|
|
export { ToolCallCard } from './ToolCallCard.js';
|
|
export type { ToolCallCardProps } from './ToolCallCard.js';
|
|
|
|
export { CitationChip } from './CitationChip.js';
|
|
export type { CitationChipProps } from './CitationChip.js';
|
|
|
|
export { useToolCalls } from './useToolCalls.js';
|
|
export type { UseToolCallsHelpers } from './useToolCalls.js';
|
|
|
|
// ── 0.3 surfaces ───────────────────────────────────────────────────────────
|
|
export { AgentTimeline } from './AgentTimeline.js';
|
|
export type { AgentStep, AgentStepKind, AgentTimelineProps } from './AgentTimeline.js';
|
|
|
|
export { ModelPicker } from './ModelPicker.js';
|
|
export type { ModelCapability, ModelOption, ModelPickerProps } from './ModelPicker.js';
|
|
|
|
// ── 0.4 surfaces ───────────────────────────────────────────────────────────
|
|
export { ToolPalette } from './ToolPalette.js';
|
|
export type { ToolDescriptor, ToolPaletteProps } from './ToolPalette.js';
|
|
|
|
export type {
|
|
ChatTransportOptions,
|
|
Citation,
|
|
Message,
|
|
MessageRole,
|
|
StreamProtocol,
|
|
ToolCallStatus,
|
|
ToolInvocation,
|
|
UseChatHelpers,
|
|
UseChatOptions,
|
|
} from './types.js';
|