@svadmin/ai-elements 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (142) hide show
  1. package/README.md +19 -6
  2. package/dist/components/ChatDialog.svelte +83 -28
  3. package/dist/components/ChatDialog.svelte.d.ts +6 -0
  4. package/dist/components/Conversation.svelte +37 -17
  5. package/dist/components/Conversation.svelte.d.ts +3 -2
  6. package/dist/components/ConversationContent.svelte +29 -4
  7. package/dist/components/ConversationContent.svelte.d.ts +3 -2
  8. package/dist/components/ConversationEmptyState.svelte +33 -7
  9. package/dist/components/ConversationEmptyState.svelte.d.ts +4 -2
  10. package/dist/components/ConversationScrollButton.svelte +47 -2
  11. package/dist/components/ConversationScrollButton.svelte.d.ts +8 -2
  12. package/dist/components/Message.svelte +30 -16
  13. package/dist/components/Message.svelte.d.ts +5 -5
  14. package/dist/components/MessageContent.svelte +23 -4
  15. package/dist/components/MessageContent.svelte.d.ts +3 -2
  16. package/dist/components/Reasoning.svelte +51 -9
  17. package/dist/components/Reasoning.svelte.d.ts +4 -3
  18. package/dist/components/artifact/ArtifactAction.svelte +37 -6
  19. package/dist/components/artifact/ArtifactAction.svelte.d.ts +5 -0
  20. package/dist/components/artifact/ArtifactClose.svelte +26 -6
  21. package/dist/components/artifact/ArtifactClose.svelte.d.ts +5 -2
  22. package/dist/components/artifact/index.d.ts +1 -0
  23. package/dist/components/audio-player/AudioPlayerControlBar.svelte +0 -1
  24. package/dist/components/audio-player/AudioPlayerDurationDisplay.svelte +0 -1
  25. package/dist/components/audio-player/AudioPlayerElement.svelte +0 -1
  26. package/dist/components/audio-player/AudioPlayerMuteButton.svelte +0 -1
  27. package/dist/components/audio-player/AudioPlayerPlayButton.svelte +0 -1
  28. package/dist/components/audio-player/AudioPlayerSeekBackwardButton.svelte +0 -1
  29. package/dist/components/audio-player/AudioPlayerSeekForwardButton.svelte +0 -1
  30. package/dist/components/audio-player/AudioPlayerTimeDisplay.svelte +0 -1
  31. package/dist/components/audio-player/AudioPlayerTimeRange.svelte +0 -1
  32. package/dist/components/audio-player/AudioPlayerVolumeRange.svelte +0 -1
  33. package/dist/components/checkpoint/index.d.ts +2 -2
  34. package/dist/components/context/Context.svelte +46 -5
  35. package/dist/components/context/Context.svelte.d.ts +5 -1
  36. package/dist/components/conversation/index.d.ts +4 -0
  37. package/dist/components/file-tree/FileTree.svelte +35 -16
  38. package/dist/components/file-tree/FileTree.svelte.d.ts +7 -1
  39. package/dist/components/file-tree/FileTreeFile.svelte +3 -3
  40. package/dist/components/file-tree/FileTreeFile.svelte.d.ts +1 -0
  41. package/dist/components/file-tree/context.svelte.d.ts +2 -0
  42. package/dist/components/inline-citation/InlineCitation.svelte +0 -1
  43. package/dist/components/inline-citation/InlineCitationCardBody.svelte +0 -1
  44. package/dist/components/inline-citation/InlineCitationCarouselHeader.svelte +0 -1
  45. package/dist/components/inline-citation/InlineCitationCarouselIndex.svelte +0 -1
  46. package/dist/components/inline-citation/InlineCitationCarouselNext.svelte +0 -1
  47. package/dist/components/inline-citation/InlineCitationCarouselPrev.svelte +0 -1
  48. package/dist/components/inline-citation/InlineCitationQuote.svelte +0 -1
  49. package/dist/components/inline-citation/InlineCitationText.svelte +0 -1
  50. package/dist/components/jsx-preview/JSXPreviewContent.svelte +43 -31
  51. package/dist/components/jsx-preview/index.d.ts +1 -1
  52. package/dist/components/jsx-preview/parser.d.ts +18 -8
  53. package/dist/components/jsx-preview/parser.js +1 -1
  54. package/dist/components/message/MessageAction.svelte +37 -7
  55. package/dist/components/message/MessageAction.svelte.d.ts +1 -1
  56. package/dist/components/message/MessageResponse.svelte +23 -7
  57. package/dist/components/message/MessageResponse.svelte.d.ts +5 -5
  58. package/dist/components/message/index.d.ts +2 -0
  59. package/dist/components/prompt-input/PromptInput.svelte +16 -3
  60. package/dist/components/prompt-input/PromptInput.svelte.d.ts +3 -1
  61. package/dist/components/prompt-input/PromptInputActionAddAttachments.svelte +0 -1
  62. package/dist/components/prompt-input/PromptInputActionMenuContent.svelte +0 -1
  63. package/dist/components/prompt-input/PromptInputActionMenuTrigger.svelte +0 -1
  64. package/dist/components/prompt-input/PromptInputBody.svelte +0 -1
  65. package/dist/components/prompt-input/PromptInputButton.svelte +0 -1
  66. package/dist/components/prompt-input/PromptInputCommand.svelte +0 -1
  67. package/dist/components/prompt-input/PromptInputCommandEmpty.svelte +0 -1
  68. package/dist/components/prompt-input/PromptInputCommandGroup.svelte +0 -1
  69. package/dist/components/prompt-input/PromptInputCommandInput.svelte +0 -1
  70. package/dist/components/prompt-input/PromptInputCommandList.svelte +0 -1
  71. package/dist/components/prompt-input/PromptInputCommandSeparator.svelte +0 -1
  72. package/dist/components/prompt-input/PromptInputFooter.svelte +0 -1
  73. package/dist/components/prompt-input/PromptInputHeader.svelte +0 -1
  74. package/dist/components/prompt-input/PromptInputHoverCardContent.svelte +0 -1
  75. package/dist/components/prompt-input/PromptInputHoverCardTrigger.svelte +0 -1
  76. package/dist/components/prompt-input/PromptInputSelectContent.svelte +0 -1
  77. package/dist/components/prompt-input/PromptInputSelectItem.svelte +0 -1
  78. package/dist/components/prompt-input/PromptInputSelectTrigger.svelte +0 -1
  79. package/dist/components/prompt-input/PromptInputSubmit.svelte +0 -1
  80. package/dist/components/prompt-input/PromptInputTab.svelte +0 -1
  81. package/dist/components/prompt-input/PromptInputTabBody.svelte +0 -1
  82. package/dist/components/prompt-input/PromptInputTabItem.svelte +0 -1
  83. package/dist/components/prompt-input/PromptInputTabLabel.svelte +0 -1
  84. package/dist/components/prompt-input/PromptInputTabsList.svelte +0 -1
  85. package/dist/components/prompt-input/PromptInputTextarea.svelte +3 -3
  86. package/dist/components/prompt-input/PromptInputTools.svelte +0 -1
  87. package/dist/components/prompt-input/context.svelte.d.ts +1 -0
  88. package/dist/components/reasoning/index.d.ts +1 -0
  89. package/dist/components/sandbox/SandboxHeader.svelte +13 -4
  90. package/dist/components/sandbox/SandboxHeader.svelte.d.ts +6 -5
  91. package/dist/components/sandbox/SandboxTabContent.svelte +1 -1
  92. package/dist/components/sandbox/SandboxTabs.svelte +2 -2
  93. package/dist/components/sandbox/SandboxTabs.svelte.d.ts +1 -0
  94. package/dist/components/sandbox/SandboxTabsTrigger.svelte +12 -2
  95. package/dist/components/sandbox/SandboxTabsTrigger.svelte.d.ts +4 -5
  96. package/dist/components/sandbox/context.svelte.d.ts +2 -0
  97. package/dist/components/snippet/index.d.ts +2 -2
  98. package/dist/components/stack-trace/StackTrace.svelte +6 -4
  99. package/dist/components/stack-trace/StackTrace.svelte.d.ts +2 -1
  100. package/dist/components/stack-trace/StackTraceCopyButton.svelte +48 -2
  101. package/dist/components/stack-trace/StackTraceHeader.svelte +37 -2
  102. package/dist/components/stack-trace/StackTraceHeader.svelte.d.ts +2 -2
  103. package/dist/components/suggestion/index.d.ts +1 -1
  104. package/dist/components/terminal/AnsiText.svelte +42 -0
  105. package/dist/components/terminal/AnsiText.svelte.d.ts +6 -0
  106. package/dist/components/terminal/Terminal.svelte +20 -10
  107. package/dist/components/terminal/Terminal.svelte.d.ts +2 -1
  108. package/dist/components/terminal/TerminalContent.svelte +2 -2
  109. package/dist/components/terminal/ansi.d.ts +12 -0
  110. package/dist/components/terminal/ansi.js +76 -0
  111. package/dist/components/tool/ToolHeader.svelte +4 -3
  112. package/dist/components/tool/ToolStatusBadge.svelte +4 -3
  113. package/dist/components/tool/index.d.ts +1 -1
  114. package/dist/components/tool/status.d.ts +4 -1
  115. package/dist/components/tool/status.js +7 -7
  116. package/dist/components/transcription/Transcription.svelte +22 -14
  117. package/dist/components/transcription/Transcription.svelte.d.ts +2 -1
  118. package/dist/components/transcription/TranscriptionSegment.svelte +1 -1
  119. package/dist/components/transcription/context.svelte.d.ts +1 -0
  120. package/dist/components/voice-selector/VoiceSelectorAccent.svelte +0 -1
  121. package/dist/components/voice-selector/VoiceSelectorAge.svelte +0 -1
  122. package/dist/components/voice-selector/VoiceSelectorAttributes.svelte +0 -1
  123. package/dist/components/voice-selector/VoiceSelectorBullet.svelte +0 -1
  124. package/dist/components/voice-selector/VoiceSelectorContent.svelte +0 -1
  125. package/dist/components/voice-selector/VoiceSelectorDescription.svelte +0 -1
  126. package/dist/components/voice-selector/VoiceSelectorDialog.svelte +0 -1
  127. package/dist/components/voice-selector/VoiceSelectorEmpty.svelte +0 -1
  128. package/dist/components/voice-selector/VoiceSelectorGender.svelte +0 -1
  129. package/dist/components/voice-selector/VoiceSelectorGroup.svelte +0 -1
  130. package/dist/components/voice-selector/VoiceSelectorInput.svelte +0 -1
  131. package/dist/components/voice-selector/VoiceSelectorList.svelte +0 -1
  132. package/dist/components/voice-selector/VoiceSelectorName.svelte +0 -1
  133. package/dist/components/voice-selector/VoiceSelectorPreview.svelte +0 -1
  134. package/dist/components/voice-selector/VoiceSelectorSeparator.svelte +0 -1
  135. package/dist/components/voice-selector/VoiceSelectorShortcut.svelte +0 -1
  136. package/dist/components/voice-selector/VoiceSelectorTrigger.svelte +0 -1
  137. package/dist/context.svelte.d.ts +1 -0
  138. package/dist/generated-components.d.ts +2 -1
  139. package/dist/index.d.ts +3 -2
  140. package/dist/index.js +1 -1
  141. package/dist/parity-manifest.js +1 -0
  142. package/package.json +2 -2
package/README.md CHANGED
@@ -59,8 +59,8 @@ The packed-package verification loads the root entry through `vite.ssrLoadModule
59
59
  Conversation,
60
60
  Message,
61
61
  MessageParts,
62
+ messageText,
62
63
  PromptInput,
63
- Response,
64
64
  } from '@svadmin/ai-elements';
65
65
 
66
66
  let prompt = $state('');
@@ -74,9 +74,9 @@ The packed-package verification loads the root entry through `vite.ssrLoadModule
74
74
  </script>
75
75
 
76
76
  <Conversation>
77
- <Message {message}>
77
+ <Message from={message.role} data-message-id={message.id}>
78
78
  <MessageParts.Content>
79
- <Response content="How can I help?" />
79
+ <MessageParts.Response content={messageText(message)} />
80
80
  </MessageParts.Content>
81
81
  </Message>
82
82
  </Conversation>
@@ -87,7 +87,9 @@ The packed-package verification loads the root entry through `vite.ssrLoadModule
87
87
  Messages use the `ChatMessagePart` contract from `@svadmin/core`, including text, reasoning, tool calls/results, sources, images, files, approvals, and generated components.
88
88
 
89
89
  Generated components use TypeBox as their runtime boundary. The schema also
90
- drives the Svelte component prop type:
90
+ drives the Svelte component prop type. Root object schemas are strict by
91
+ default, so undeclared model-provided props are rejected even when the caller
92
+ does not set `additionalProperties: false`:
91
93
 
92
94
  ```ts
93
95
  import { Type } from '@sinclair/typebox';
@@ -100,11 +102,20 @@ export const componentRegistry = {
100
102
  schema: Type.Object({
101
103
  warehouse: Type.String(),
102
104
  count: Type.Number(),
103
- }, { additionalProperties: false }),
105
+ }),
104
106
  }),
105
107
  };
106
108
  ```
107
109
 
110
+ ## Upstream parity
111
+
112
+ `AI_ELEMENT_PARITY` pins the audited `vercel/ai-elements` commit and verifies
113
+ the 49-family, 398-export package surface. Export presence, behavior, and visual
114
+ fidelity are tracked independently: an exact export name is not proof of
115
+ interaction or pixel parity. `JSXPreview` intentionally uses a restricted,
116
+ TypeBox-validated parser instead of executing arbitrary JSX. `Tool.getStatusBadge`
117
+ returns Svelte-renderable status metadata instead of a React element.
118
+
108
119
  ## AdminApp Integration
109
120
 
110
121
  Pass providers through the owning Svelte tree and render the assistant through
@@ -125,4 +136,6 @@ the `AdminApp` snippet:
125
136
 
126
137
  History is in-memory by default. A non-empty `persistKey` enables
127
138
  `localStorage`; include a stable, non-secret user identity in the key. Use
128
- `onPersist` and `onRestore` for host-managed persistence.
139
+ `onPersist` and `onRestore` for host-managed persistence. If restoration fails,
140
+ the dialog blocks writes for that history scope instead of overwriting remote
141
+ history; use `onPersistenceError` to report the failed operation.
@@ -39,6 +39,13 @@
39
39
  GeneratedComponentRegistry,
40
40
  } from '../generated-components.js';
41
41
 
42
+ export type ChatPersistenceOperation = 'restore' | 'persist';
43
+
44
+ export interface ChatPersistenceErrorDetail {
45
+ operation: ChatPersistenceOperation;
46
+ error: unknown;
47
+ }
48
+
42
49
  type ResolvedGeneratedComponent = {
43
50
  component: Component<GeneratedProps>;
44
51
  props: GeneratedProps;
@@ -51,6 +58,7 @@
51
58
  persistKey?: string;
52
59
  onPersist?: (messages: ChatMessage[]) => void;
53
60
  onRestore?: () => ChatMessage[];
61
+ onPersistenceError?: (detail: ChatPersistenceErrorDetail) => void;
54
62
  /** 定向接收 `svadmin:ask-ai` 事件的稳定作用域。 */
55
63
  scope?: string;
56
64
  /** 所属 Layout 作用域,用于仲裁全局快捷键。 */
@@ -69,11 +77,16 @@
69
77
  type PersistSnapshot = {
70
78
  key: string;
71
79
  messages: ChatMessage[];
80
+ errorHandler?: (detail: ChatPersistenceErrorDetail) => void;
72
81
  } & (
73
82
  | { sink: 'callback'; callback: (messages: ChatMessage[]) => void }
74
83
  | { sink: 'storage'; storage: Storage | null }
75
84
  );
76
85
 
86
+ type RestoreResult =
87
+ | { ok: true; messages: ChatMessage[] }
88
+ | { ok: false; error: unknown };
89
+
77
90
  type ApprovalEntry = {
78
91
  agent: AgentProvider;
79
92
  controller: AbortController;
@@ -95,6 +108,7 @@
95
108
  persistKey,
96
109
  onPersist,
97
110
  onRestore,
111
+ onPersistenceError,
98
112
  scope,
99
113
  ownerScope,
100
114
  componentRegistry = {},
@@ -148,6 +162,8 @@
148
162
  let restoredCallback: Props['onRestore'];
149
163
  let previousPersistCallback: Props['onPersist'];
150
164
  let hasPersistCallbackSnapshot = false;
165
+ let persistBlockedScope: string | null = null;
166
+ let persistenceError = $state<string | null>(null);
151
167
  let statusAnnouncement = $state('');
152
168
 
153
169
  const historyScopeToken = $derived.by(() => {
@@ -266,11 +282,19 @@
266
282
 
267
283
  function getChatStorage(): Storage | null {
268
284
  if (typeof window === 'undefined') return null;
269
- try {
270
- return window.localStorage;
271
- } catch {
272
- return null;
273
- }
285
+ return window.localStorage;
286
+ }
287
+
288
+ function reportPersistenceError(
289
+ operation: ChatPersistenceOperation,
290
+ error: unknown,
291
+ errorHandler = onPersistenceError,
292
+ ): void {
293
+ persistenceError = operation === 'restore'
294
+ ? 'Conversation history could not be restored. New messages will not be saved until restoration succeeds.'
295
+ : 'Conversation history could not be saved.';
296
+ statusAnnouncement = persistenceError;
297
+ errorHandler?.({ operation, error });
274
298
  }
275
299
 
276
300
  function flushPersist(snapshot: PersistSnapshot): void {
@@ -280,8 +304,8 @@
280
304
  } else if (snapshot.key) {
281
305
  snapshot.storage?.setItem(snapshot.key, JSON.stringify(snapshot.messages));
282
306
  }
283
- } catch {
284
- // 持久化失败不应打断聊天状态机。
307
+ } catch (error) {
308
+ reportPersistenceError('persist', error, snapshot.errorHandler);
285
309
  }
286
310
  }
287
311
 
@@ -305,6 +329,7 @@
305
329
  }
306
330
 
307
331
  function schedulePersist(nextMessages: ChatMessage[]): void {
332
+ if (persistBlockedScope === historyScopeToken) return;
308
333
  const persistedMessages = cloneMessages(nextMessages);
309
334
  const callback = onPersist;
310
335
  let snapshot: PersistSnapshot;
@@ -315,15 +340,24 @@
315
340
  key: restoredPersistKey ?? resolvedPersistKey,
316
341
  messages: persistedMessages,
317
342
  callback,
343
+ errorHandler: onPersistenceError,
318
344
  };
319
345
  } else {
320
346
  const key = restoredPersistKey;
321
347
  if (key === null || !key || key !== resolvedPersistKey) return;
348
+ let storage: Storage | null;
349
+ try {
350
+ storage = getChatStorage();
351
+ } catch (error) {
352
+ reportPersistenceError('persist', error);
353
+ return;
354
+ }
322
355
  snapshot = {
323
356
  sink: 'storage',
324
357
  key,
325
358
  messages: persistedMessages,
326
- storage: getChatStorage(),
359
+ storage,
360
+ errorHandler: onPersistenceError,
327
361
  };
328
362
  }
329
363
 
@@ -496,14 +530,18 @@
496
530
  return restored;
497
531
  }
498
532
 
499
- function readStoredMessages(key: string): ChatMessage[] {
500
- const storage = getChatStorage();
501
- if (!key || !storage) return [];
533
+ function readStoredMessages(key: string): RestoreResult {
534
+ if (!key) return { ok: true, messages: [] };
502
535
  try {
536
+ const storage = getChatStorage();
537
+ if (!storage) return { ok: true, messages: [] };
503
538
  const stored = storage.getItem(key);
504
- return stored === null ? [] : parseStoredMessages(JSON.parse(stored) as unknown);
505
- } catch {
506
- return [];
539
+ return {
540
+ ok: true,
541
+ messages: stored === null ? [] : parseStoredMessages(JSON.parse(stored) as unknown),
542
+ };
543
+ } catch (error) {
544
+ return { ok: false, error };
507
545
  }
508
546
  }
509
547
 
@@ -632,17 +670,26 @@
632
670
  restoredHistoryScope = null;
633
671
  restoredPersistKey = null;
634
672
  restoredCallback = restore;
673
+ persistBlockedScope = null;
674
+ persistenceError = null;
635
675
 
636
676
  if (restore) {
637
- let restored: ChatMessage[];
638
677
  try {
639
- restored = parseStoredMessages(restore());
640
- } catch {
641
- restored = [];
678
+ finishRestore(scopeToken, key, parseStoredMessages(restore()), true);
679
+ } catch (error) {
680
+ persistBlockedScope = scopeToken;
681
+ finishRestore(scopeToken, key, []);
682
+ reportPersistenceError('restore', error);
642
683
  }
643
- finishRestore(scopeToken, key, restored, true);
644
684
  } else {
645
- finishRestore(scopeToken, key, readStoredMessages(key));
685
+ const restored = readStoredMessages(key);
686
+ if (!restored.ok) {
687
+ persistBlockedScope = scopeToken;
688
+ finishRestore(scopeToken, key, []);
689
+ reportPersistenceError('restore', restored.error);
690
+ } else {
691
+ finishRestore(scopeToken, key, restored.messages);
692
+ }
646
693
  }
647
694
  });
648
695
  });
@@ -1025,6 +1072,8 @@
1025
1072
  function clearChat(): void {
1026
1073
  invalidateActiveRun({ persist: false });
1027
1074
  cancelPendingPersist();
1075
+ persistBlockedScope = null;
1076
+ persistenceError = null;
1028
1077
  replaceMessages([], false);
1029
1078
  statusAnnouncement = 'Conversation cleared.';
1030
1079
  const key = restoredPersistKey ?? resolvedPersistKey;
@@ -1034,8 +1083,8 @@
1034
1083
  } else if (key) {
1035
1084
  try {
1036
1085
  getChatStorage()?.removeItem(key);
1037
- } catch {
1038
- // localStorage 为可选能力。
1086
+ } catch (error) {
1087
+ reportPersistenceError('persist', error);
1039
1088
  }
1040
1089
  }
1041
1090
  }
@@ -1172,13 +1221,19 @@
1172
1221
  </header>
1173
1222
 
1174
1223
  {#if !minimized}
1224
+ {#if persistenceError}
1225
+ <div class="border-b border-destructive/25 bg-destructive/10 px-4 py-2 text-xs text-destructive" role="alert">
1226
+ {persistenceError}
1227
+ </div>
1228
+ {/if}
1175
1229
  <Conversation {messages} {isStreaming} class="min-h-0 flex-1 rounded-none border-0">
1176
- <ConversationContent class="space-y-2">
1230
+ <ConversationContent class="gap-2">
1177
1231
  {#if messages.length === 0}
1178
- <ConversationEmptyState
1179
- title="How can I help?"
1180
- description="Ask about the current resource, record, or workflow."
1181
- >
1232
+ <ConversationEmptyState>
1233
+ <div class="space-y-1">
1234
+ <h3 class="text-sm font-medium">How can I help?</h3>
1235
+ <p class="svadmin-ai__muted text-sm">Ask about the current resource, record, or workflow.</p>
1236
+ </div>
1182
1237
  <div class="mt-3 flex w-full max-w-72 flex-col gap-2">
1183
1238
  {#each suggestions as suggestion (suggestion)}
1184
1239
  <button
@@ -1194,7 +1249,7 @@
1194
1249
  {/if}
1195
1250
 
1196
1251
  {#each messages as message (message.id)}
1197
- <Message {message}>
1252
+ <Message from={message.role} id={message.id}>
1198
1253
  <MessageContent class={message.role === 'user' ? 'bg-primary text-primary-foreground' : ''}>
1199
1254
  {#if message.parts.length === 0 && message.status === 'streaming'}
1200
1255
  <p class="svadmin-ai__muted text-sm">Thinking...</p>
@@ -1,6 +1,11 @@
1
1
  import { type Component } from 'svelte';
2
2
  import type { ChatMessage } from '../contracts.js';
3
3
  import { type GeneratedComponentRegistry as ComponentRegistry } from '../generated-components.js';
4
+ export type ChatPersistenceOperation = 'restore' | 'persist';
5
+ export interface ChatPersistenceErrorDetail {
6
+ operation: ChatPersistenceOperation;
7
+ error: unknown;
8
+ }
4
9
  type Props = {
5
10
  /** 在布局工具栏内渲染紧凑启动按钮。 */
6
11
  docked?: boolean;
@@ -8,6 +13,7 @@ type Props = {
8
13
  persistKey?: string;
9
14
  onPersist?: (messages: ChatMessage[]) => void;
10
15
  onRestore?: () => ChatMessage[];
16
+ onPersistenceError?: (detail: ChatPersistenceErrorDetail) => void;
11
17
  /** 定向接收 `svadmin:ask-ai` 事件的稳定作用域。 */
12
18
  scope?: string;
13
19
  /** 所属 Layout 作用域,用于仲裁全局快捷键。 */
@@ -1,29 +1,44 @@
1
- <script lang="ts">
1
+ <script module lang="ts">
2
2
  import type { Snippet } from 'svelte';
3
- import { untrack } from 'svelte';
3
+ import type { HTMLAttributes } from 'svelte/elements';
4
4
  import type { ChatMessage } from '../contracts.js';
5
- import { provideConversationContext } from '../context.svelte.js';
6
- import { cn } from '../utils.js';
7
5
 
8
- type Props = {
6
+ export type ConversationProps = Omit<HTMLAttributes<HTMLElement>, 'children' | 'class'> & {
9
7
  messages?: ChatMessage[];
10
8
  isStreaming?: boolean;
11
9
  class?: string;
12
10
  children?: Snippet;
13
11
  };
12
+ </script>
13
+
14
+ <script lang="ts">
15
+ import { untrack } from 'svelte';
16
+ import { provideConversationContext } from '../context.svelte.js';
17
+ import { cn } from '../utils.js';
14
18
 
15
- let { messages = [], isStreaming = false, class: className = '', children }: Props = $props();
19
+ let {
20
+ messages = [],
21
+ isStreaming = false,
22
+ class: className = '',
23
+ children,
24
+ 'aria-label': ariaLabel = 'Conversation',
25
+ ...rest
26
+ }: ConversationProps = $props();
16
27
  let contentElement = $state<HTMLElement | null>(null);
17
- let showScrollButton = $state(false);
28
+ let isAtBottom = $state(true);
18
29
 
19
30
  function scrollToBottom(): void {
20
- contentElement?.scrollTo({ top: contentElement.scrollHeight, behavior: 'smooth' });
31
+ const element = contentElement;
32
+ if (!element) return;
33
+ isAtBottom = true;
34
+ if (typeof element.scrollTo === 'function') element.scrollTo({ top: element.scrollHeight, behavior: 'smooth' });
35
+ else element.scrollTop = element.scrollHeight;
21
36
  }
22
37
 
23
38
  function updateScrollState(): void {
24
39
  const element = contentElement;
25
40
  if (!element) return;
26
- showScrollButton = element.scrollHeight - element.scrollTop - element.clientHeight > 48;
41
+ isAtBottom = element.scrollHeight - element.scrollTop - element.clientHeight <= 48;
27
42
  }
28
43
 
29
44
  function registerContent(element: HTMLElement | null): void {
@@ -38,6 +53,7 @@
38
53
  provideConversationContext({
39
54
  get messages() { return messages; },
40
55
  get isStreaming() { return isStreaming; },
56
+ get isAtBottom() { return isAtBottom; },
41
57
  scrollToBottom,
42
58
  registerContent,
43
59
  });
@@ -46,19 +62,23 @@
46
62
  void messages;
47
63
  void isStreaming;
48
64
  queueMicrotask(() => {
49
- if (!showScrollButton) contentElement?.scrollTo({ top: contentElement.scrollHeight });
65
+ const element = contentElement;
66
+ if (element && isAtBottom) {
67
+ if (typeof element.scrollTo === 'function') element.scrollTo({ top: element.scrollHeight });
68
+ else element.scrollTop = element.scrollHeight;
69
+ }
50
70
  updateScrollState();
51
71
  });
52
72
  });
53
73
  </script>
54
74
 
55
- <section class={cn('svadmin-ai svadmin-ai__surface flex min-h-0 flex-col', className)} aria-label="Conversation">
75
+ <section
76
+ {...rest}
77
+ class={cn('svadmin-ai svadmin-ai__surface relative flex min-h-0 flex-col overflow-hidden', className)}
78
+ aria-label={ariaLabel}
79
+ data-slot="conversation"
80
+ >
56
81
  {@render children?.()}
57
- {#if showScrollButton}
58
- <button type="button" class="svadmin-ai__button svadmin-ai__button--ghost mx-auto mb-2" aria-label="Scroll to latest message" onclick={scrollToBottom}>
59
- ↓ Latest
60
- </button>
61
- {/if}
62
82
  </section>
63
83
 
64
- <svelte:window onresize={updateScrollState} />
84
+ <svelte:window onresize={updateScrollState} />
@@ -1,11 +1,12 @@
1
1
  import type { Snippet } from 'svelte';
2
+ import type { HTMLAttributes } from 'svelte/elements';
2
3
  import type { ChatMessage } from '../contracts.js';
3
- type Props = {
4
+ export type ConversationProps = Omit<HTMLAttributes<HTMLElement>, 'children' | 'class'> & {
4
5
  messages?: ChatMessage[];
5
6
  isStreaming?: boolean;
6
7
  class?: string;
7
8
  children?: Snippet;
8
9
  };
9
- declare const Conversation: import("svelte").Component<Props, {}, "">;
10
+ declare const Conversation: import("svelte").Component<ConversationProps, {}, "">;
10
11
  type Conversation = ReturnType<typeof Conversation>;
11
12
  export default Conversation;
@@ -1,17 +1,42 @@
1
- <script lang="ts">
1
+ <script module lang="ts">
2
2
  import type { Snippet } from 'svelte';
3
+ import type { HTMLAttributes } from 'svelte/elements';
4
+
5
+ export type ConversationContentProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'class'> & {
6
+ class?: string;
7
+ children?: Snippet;
8
+ };
9
+ </script>
10
+
11
+ <script lang="ts">
3
12
  import { useConversationContext } from '../context.svelte.js';
4
13
  import { cn } from '../utils.js';
5
- type Props = { class?: string; children?: Snippet };
6
- let { class: className = '', children }: Props = $props();
14
+
15
+ let {
16
+ class: className = '',
17
+ children,
18
+ role = 'log',
19
+ 'aria-live': ariaLive,
20
+ 'aria-busy': ariaBusy,
21
+ ...rest
22
+ }: ConversationContentProps = $props();
7
23
  let contentElement = $state<HTMLElement | null>(null);
8
24
  const conversation = useConversationContext();
25
+
9
26
  $effect(() => {
10
27
  conversation.registerContent(contentElement);
11
28
  return () => conversation.registerContent(null);
12
29
  });
13
30
  </script>
14
31
 
15
- <div bind:this={contentElement} class={cn('min-h-0 flex-1 overflow-y-auto p-4', className)} role="log" aria-live={conversation.isStreaming ? 'off' : 'polite'} aria-busy={conversation.isStreaming}>
32
+ <div
33
+ {...rest}
34
+ bind:this={contentElement}
35
+ class={cn('flex min-h-0 flex-1 flex-col gap-8 overflow-y-auto p-4', className)}
36
+ {role}
37
+ aria-live={ariaLive ?? (conversation.isStreaming ? 'off' : 'polite')}
38
+ aria-busy={ariaBusy ?? conversation.isStreaming}
39
+ data-slot="conversation-content"
40
+ >
16
41
  {@render children?.()}
17
42
  </div>
@@ -1,8 +1,9 @@
1
1
  import type { Snippet } from 'svelte';
2
- type Props = {
2
+ import type { HTMLAttributes } from 'svelte/elements';
3
+ export type ConversationContentProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'class'> & {
3
4
  class?: string;
4
5
  children?: Snippet;
5
6
  };
6
- declare const ConversationContent: import("svelte").Component<Props, {}, "">;
7
+ declare const ConversationContent: import("svelte").Component<ConversationContentProps, {}, "">;
7
8
  type ConversationContent = ReturnType<typeof ConversationContent>;
8
9
  export default ConversationContent;
@@ -1,11 +1,37 @@
1
- <script lang="ts">
1
+ <script module lang="ts">
2
2
  import type { Snippet } from 'svelte';
3
+ import type { HTMLAttributes } from 'svelte/elements';
4
+
5
+ export type ConversationEmptyStateProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'class' | 'title'> & {
6
+ title?: string;
7
+ description?: string;
8
+ icon?: Snippet;
9
+ class?: string;
10
+ children?: Snippet;
11
+ };
12
+ </script>
13
+
14
+ <script lang="ts">
3
15
  import { cn } from '../utils.js';
4
- type Props = { title?: string; description?: string; class?: string; children?: Snippet };
5
- let { title = 'Start a conversation', description = 'Ask a question to get started.', class: className = '', children }: Props = $props();
16
+
17
+ let {
18
+ title = 'No messages yet',
19
+ description = 'Start a conversation to see messages here',
20
+ icon,
21
+ class: className = '',
22
+ children,
23
+ ...rest
24
+ }: ConversationEmptyStateProps = $props();
6
25
  </script>
7
- <div class={cn('flex min-h-48 flex-col items-center justify-center gap-2 p-6 text-center', className)}>
8
- <h2 class="text-base font-semibold">{title}</h2>
9
- <p class="svadmin-ai__muted text-sm">{description}</p>
10
- {@render children?.()}
26
+
27
+ <div {...rest} class={cn('flex size-full min-h-48 flex-col items-center justify-center gap-3 p-8 text-center', className)} data-slot="conversation-empty-state">
28
+ {#if children}
29
+ {@render children()}
30
+ {:else}
31
+ {#if icon}<div class="text-muted-foreground" data-slot="conversation-empty-state-icon">{@render icon()}</div>{/if}
32
+ <div class="space-y-1">
33
+ <h3 class="text-sm font-medium">{title}</h3>
34
+ {#if description}<p class="svadmin-ai__muted text-sm">{description}</p>{/if}
35
+ </div>
36
+ {/if}
11
37
  </div>
@@ -1,10 +1,12 @@
1
1
  import type { Snippet } from 'svelte';
2
- type Props = {
2
+ import type { HTMLAttributes } from 'svelte/elements';
3
+ export type ConversationEmptyStateProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'class' | 'title'> & {
3
4
  title?: string;
4
5
  description?: string;
6
+ icon?: Snippet;
5
7
  class?: string;
6
8
  children?: Snippet;
7
9
  };
8
- declare const ConversationEmptyState: import("svelte").Component<Props, {}, "">;
10
+ declare const ConversationEmptyState: import("svelte").Component<ConversationEmptyStateProps, {}, "">;
9
11
  type ConversationEmptyState = ReturnType<typeof ConversationEmptyState>;
10
12
  export default ConversationEmptyState;
@@ -1,6 +1,51 @@
1
+ <script module lang="ts">
2
+ import type { Snippet } from 'svelte';
3
+ import type { HTMLButtonAttributes } from 'svelte/elements';
4
+
5
+ export type ConversationScrollButtonProps = Omit<HTMLButtonAttributes, 'children' | 'class' | 'onclick'> & {
6
+ class?: string;
7
+ children?: Snippet;
8
+ onclick?: (event: MouseEvent & { currentTarget: EventTarget & HTMLButtonElement }) => void;
9
+ };
10
+ </script>
11
+
1
12
  <script lang="ts">
13
+ import { ArrowDown } from '@lucide/svelte';
2
14
  import { useConversationContext } from '../context.svelte.js';
3
- let { class: className = '' }: { class?: string } = $props();
15
+ import { cn } from '../utils.js';
16
+
17
+ let {
18
+ class: className = '',
19
+ children,
20
+ onclick,
21
+ type = 'button',
22
+ 'aria-label': ariaLabel = 'Scroll to latest message',
23
+ ...rest
24
+ }: ConversationScrollButtonProps = $props();
4
25
  const conversation = useConversationContext();
26
+
27
+ function click(event: MouseEvent & { currentTarget: EventTarget & HTMLButtonElement }): void {
28
+ onclick?.(event);
29
+ if (!event.defaultPrevented) conversation.scrollToBottom();
30
+ }
5
31
  </script>
6
- <button type="button" class="svadmin-ai__button svadmin-ai__button--ghost {className}" aria-label="Scroll to latest message" onclick={conversation.scrollToBottom}>↓ Latest</button>
32
+
33
+ {#if !conversation.isAtBottom}
34
+ <button
35
+ {...rest}
36
+ {type}
37
+ class={cn(
38
+ 'svadmin-ai__button absolute bottom-4 left-1/2 size-9 min-h-9 -translate-x-1/2 rounded-full border border-border bg-background p-0 shadow-sm',
39
+ className,
40
+ )}
41
+ aria-label={ariaLabel}
42
+ data-slot="conversation-scroll-button"
43
+ onclick={click}
44
+ >
45
+ {#if children}
46
+ {@render children()}
47
+ {:else}
48
+ <ArrowDown size={16} aria-hidden="true" />
49
+ {/if}
50
+ </button>
51
+ {/if}
@@ -1,6 +1,12 @@
1
- type $$ComponentProps = {
1
+ import type { Snippet } from 'svelte';
2
+ import type { HTMLButtonAttributes } from 'svelte/elements';
3
+ export type ConversationScrollButtonProps = Omit<HTMLButtonAttributes, 'children' | 'class' | 'onclick'> & {
2
4
  class?: string;
5
+ children?: Snippet;
6
+ onclick?: (event: MouseEvent & {
7
+ currentTarget: EventTarget & HTMLButtonElement;
8
+ }) => void;
3
9
  };
4
- declare const ConversationScrollButton: import("svelte").Component<$$ComponentProps, {}, "">;
10
+ declare const ConversationScrollButton: import("svelte").Component<ConversationScrollButtonProps, {}, "">;
5
11
  type ConversationScrollButton = ReturnType<typeof ConversationScrollButton>;
6
12
  export default ConversationScrollButton;
@@ -1,23 +1,37 @@
1
- <script lang="ts">
1
+ <script module lang="ts">
2
2
  import type { Snippet } from 'svelte';
3
+ import type { HTMLAttributes } from 'svelte/elements';
3
4
  import type { ChatMessage } from '../contracts.js';
4
- import { cn } from '../utils.js';
5
5
 
6
- type Props = {
7
- message: ChatMessage;
8
- children?: Snippet;
6
+ export type MessageProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'class'> & {
7
+ from: ChatMessage['role'];
9
8
  class?: string;
10
- onaction?: (action: string, message: ChatMessage) => void;
9
+ children?: Snippet;
11
10
  };
12
- let { message, children, class: className = '' }: Props = $props();
13
- const isUser = $derived(message.role === 'user');
14
11
  </script>
15
12
 
16
- <article class={cn('flex gap-3 py-3', isUser && 'flex-row-reverse', className)} data-message-id={message.id} data-role={message.role}>
17
- <div class="flex size-8 shrink-0 items-center justify-center rounded-full border border-border bg-muted text-xs font-semibold" aria-hidden="true">
18
- {isUser ? 'U' : message.role === 'system' ? 'S' : 'AI'}
19
- </div>
20
- <div class={cn('min-w-0 max-w-[min(86%,48rem)] flex-1', isUser && 'text-right')}>
21
- {@render children?.()}
22
- </div>
23
- </article>
13
+ <script lang="ts">
14
+ import { cn } from '../utils.js';
15
+
16
+ let {
17
+ from,
18
+ id,
19
+ class: className = '',
20
+ children,
21
+ ...rest
22
+ }: MessageProps = $props();
23
+ </script>
24
+
25
+ <div
26
+ {...rest}
27
+ {id}
28
+ class={cn(
29
+ 'group flex w-full max-w-[95%] flex-col gap-2',
30
+ from === 'user' ? 'is-user ml-auto justify-end' : 'is-assistant',
31
+ className,
32
+ )}
33
+ data-message-id={id}
34
+ data-role={from}
35
+ >
36
+ {@render children?.()}
37
+ </div>