@svadmin/ai-elements 0.3.0 → 0.4.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.
package/README.md CHANGED
@@ -139,6 +139,11 @@ interaction or pixel parity. `JSXPreview` intentionally uses a restricted,
139
139
  TypeBox-validated parser instead of executing arbitrary JSX. `Tool.getStatusBadge`
140
140
  returns Svelte-renderable status metadata instead of a React element.
141
141
 
142
+ The architecture comparison, adopted Sikandar patterns, component counts, and
143
+ intentional framework differences are documented in
144
+ [`UPSTREAM_PARITY.md`](./UPSTREAM_PARITY.md). Behavior classifications must be
145
+ backed by an existing test file in the parity manifest.
146
+
142
147
  ## AdminApp Integration
143
148
 
144
149
  Pass providers through the owning Svelte tree and render the assistant through
@@ -0,0 +1,69 @@
1
+ # Upstream architecture and parity assessment
2
+
3
+ This package is evaluated against fixed source snapshots so that component
4
+ counts and behavior claims remain reproducible:
5
+
6
+ - `vercel/ai-elements` at `6a9d5b1822ffb10bba4bd97175f01edd7d8651cd`
7
+ - `vuepont/ai-elements-vue` at `ad4818f6081a2fe6e5b7bb53cebc5a66d9a24148`
8
+ - `SikandarJODD/ai-elements` at `fa4bc217f84bc571378bc371332a154106772614`
9
+
10
+ ## Architecture decision
11
+
12
+ SVAdmin keeps its package-first architecture instead of copying the reference
13
+ applications wholesale. The current structure is stronger for an admin
14
+ framework because it provides:
15
+
16
+ - Svelte 5 runes, snippets, bindable state, and scoped context instead of React
17
+ compatibility wrappers;
18
+ - structured `ChatMessagePart` data for text, reasoning, tools, sources,
19
+ attachments, approvals, and generated components;
20
+ - TypeBox runtime boundaries for generated component props and agent tool
21
+ arguments;
22
+ - SSR, package-export, packed-consumer, and workspace integration gates;
23
+ - semantic design tokens and tenant/provider ownership inherited from SVAdmin.
24
+
25
+ The Sikandar project is stronger as a component-learning reference. Its
26
+ co-located examples, registry organization, concise component files, and
27
+ Svelte-native compound APIs make individual components easy to inspect. We
28
+ adopted the useful parts without importing its application routing or registry
29
+ runtime into the package:
30
+
31
+ - generic `Action` and `Code` families;
32
+ - message and prompt attachment composition;
33
+ - workflow subpath aggregation;
34
+ - small compound component files and Svelte context APIs;
35
+ - explicit `content` props for Markdown responses rather than attempting to
36
+ recover text from compiled Svelte snippets.
37
+
38
+ ## Component inventory
39
+
40
+ The pinned official package exposes 49 component families and 398 runtime
41
+ exports. `vuepont/ai-elements-vue` exposes 48 comparable families. The Sikandar
42
+ documentation registry lists a smaller application-focused set, while SVAdmin
43
+ also includes admin-specific chat surfaces such as `ChatDialog`,
44
+ `CopilotPanel`, `AICommandBar`, `InsightCard`, `SmartSuggest`, and `VoiceInput`.
45
+
46
+ `AI_ELEMENT_PARITY` is the authoritative machine-readable inventory. Every
47
+ official runtime export is mapped to a local Svelte export. Behavior status is
48
+ tracked separately and must name an existing test file before a family can be
49
+ classified as verified. This prevents an export-only audit from being reported
50
+ as functional parity.
51
+
52
+ ## Intentional framework differences
53
+
54
+ Two official helpers intentionally differ while preserving the user-facing
55
+ capability:
56
+
57
+ - `JSXPreview` parses a restricted, TypeBox-validated component grammar rather
58
+ than executing arbitrary JSX.
59
+ - `Tool.getStatusBadge` returns Svelte-renderable status metadata rather than a
60
+ React element.
61
+
62
+ `MessageResponse` accepts Markdown through `content` or `text`. Plain Svelte
63
+ children remain snippets and are rendered as authored UI; they are not mounted
64
+ into a hidden DOM node and scraped back into a string. This matches the
65
+ Sikandar Svelte implementation and preserves SSR and streaming reactivity.
66
+
67
+ Visual evidence remains independent from behavior evidence. A component can
68
+ be behavior-verified without claiming pixel identity across React, Vue, and
69
+ Svelte rendering stacks.
package/dist/ai.css CHANGED
@@ -58,9 +58,9 @@
58
58
 
59
59
  .svadmin-ai__icon-button {
60
60
  display: inline-flex;
61
- width: 2rem;
62
- height: 2rem;
63
- min-height: 2rem;
61
+ width: 1.75rem;
62
+ height: 1.75rem;
63
+ min-height: 1.75rem;
64
64
  align-items: center;
65
65
  justify-content: center;
66
66
  border: 1px solid transparent;
@@ -70,18 +70,32 @@
70
70
  color: var(--muted-foreground, currentColor);
71
71
  font: inherit;
72
72
  cursor: pointer;
73
- transition: background-color 120ms ease, border-color 120ms ease, color 120ms ease;
73
+ transition: background-color 120ms ease, color 120ms ease, box-shadow 120ms ease, transform 80ms ease;
74
74
  }
75
75
 
76
76
  .svadmin-ai__icon-button:hover:not(:disabled) {
77
- border-color: var(--border, currentColor);
78
- background: var(--muted, transparent);
77
+ background: color-mix(in oklch, var(--muted, transparent) 72%, transparent);
79
78
  color: var(--foreground, currentColor);
80
79
  }
81
80
 
82
81
  .svadmin-ai__icon-button:focus-visible {
83
- outline: 2px solid var(--ring, currentColor);
84
- outline-offset: 2px;
82
+ outline: 0;
83
+ box-shadow:
84
+ 0 0 0 1px var(--card, Canvas),
85
+ 0 0 0 3px var(--ring, currentColor);
86
+ }
87
+
88
+ .svadmin-ai__icon-button:active:not(:disabled) {
89
+ background: var(--muted, transparent);
90
+ transform: translateY(1px);
91
+ }
92
+
93
+ .svadmin-ai__icon-button--close {
94
+ color: color-mix(in oklch, var(--muted-foreground, currentColor) 88%, transparent);
95
+ }
96
+
97
+ .svadmin-ai__icon-button--close:hover:not(:disabled) {
98
+ background: var(--muted, transparent);
85
99
  }
86
100
 
87
101
  .svadmin-ai__icon-button:disabled {
@@ -52,18 +52,18 @@
52
52
  };
53
53
 
54
54
  type Props = {
55
- /** 在布局工具栏内渲染紧凑启动按钮。 */
55
+ /** Renders a compact launcher button in the layout toolbar. */
56
56
  docked?: boolean;
57
- /** 启用 localStorage 的隔离键。必须包含稳定用户身份;未传或空字符串时不持久化。 */
57
+ /** Enables an isolated localStorage key; persistence requires a stable user identity. */
58
58
  persistKey?: string;
59
59
  onPersist?: (messages: ChatMessage[]) => void;
60
60
  onRestore?: () => ChatMessage[];
61
61
  onPersistenceError?: (detail: ChatPersistenceErrorDetail) => void;
62
- /** 定向接收 `svadmin:ask-ai` 事件的稳定作用域。 */
62
+ /** Stable scope for targeted `svadmin:ask-ai` events. */
63
63
  scope?: string;
64
- /** 所属 Layout 作用域,用于仲裁全局快捷键。 */
64
+ /** Owning Layout scope used to arbitrate global shortcuts. */
65
65
  ownerScope?: string;
66
- /** Agent 可渲染的受控组件注册表。未注册名称不会动态加载。 */
66
+ /** Controlled component registry available to Agent rendering; unregistered names are never loaded dynamically. */
67
67
  componentRegistry?: ComponentRegistry;
68
68
  class?: string;
69
69
  };
@@ -171,7 +171,7 @@
171
171
  try {
172
172
  apiUrl = adminContext.getDataProvider().getApiUrl();
173
173
  } catch {
174
- // 允许仅配置 AI provider 的独立使用场景。
174
+ // Allow standalone usage with only an AI provider configured.
175
175
  }
176
176
  const tenantIdentity = adminContext.tenantCacheKey?.__svadminTenant;
177
177
  const typedTenant = tenantIdentity === undefined
@@ -477,10 +477,10 @@
477
477
  return file ? { id, type: 'file', file } : null;
478
478
  }
479
479
  case 'approval':
480
- // 审批依赖运行时能力,已处理与未处理状态都不能从存储中复活。
480
+ // Approvals depend on runtime capabilities; neither resolved nor pending states can be restored from storage.
481
481
  return null;
482
482
  case 'component':
483
- // generated component 可能承载宿主动作,恢复时按能力状态丢弃。
483
+ // Generated components may carry host actions; discard them during restore based on capability state.
484
484
  return null;
485
485
  default:
486
486
  return null;
@@ -639,7 +639,7 @@
639
639
  return () => window.removeEventListener('svadmin:ask-ai', handler);
640
640
  });
641
641
 
642
- // 延迟快照必须写回创建它时捕获的 callback,不能被 rerender 后的新 callback 接管。
642
+ // A delayed snapshot must use the callback captured at creation, not a newer callback after rerender.
643
643
  $effect.pre(() => {
644
644
  const callback = onPersist;
645
645
  untrack(() => {
@@ -654,7 +654,7 @@
654
654
  });
655
655
  });
656
656
 
657
- // 每个 API + 类型化租户 + 显式用户键拥有独立历史和运行作用域。
657
+ // Each API, typed tenant, and explicit user key has an isolated history and run scope.
658
658
  $effect.pre(() => {
659
659
  const scopeToken = historyScopeToken;
660
660
  const key = resolvedPersistKey;
@@ -694,7 +694,7 @@
694
694
  });
695
695
  });
696
696
 
697
- // provider 身份可以在持久化 key 不变时变化,迟到结果仍必须失效。
697
+ // The provider identity may change while the persistence key stays stable; late results must still be invalidated.
698
698
  $effect.pre(() => {
699
699
  const nextRunScope = {
700
700
  tenantIdentity: adminContext.tenantCacheKey?.__svadminTenant,
@@ -871,7 +871,7 @@
871
871
  const activeProvider = provider;
872
872
  if ((value.length === 0 && attachments.length === 0) || isStreaming || (!activeAgent && !activeProvider)) return;
873
873
 
874
- // 新运行会撤销上一轮仍未解决的审批能力。
874
+ // A new run revokes unresolved approval capabilities from the previous run.
875
875
  if (approvalEntries.size > 0 || abortController) invalidateActiveRun();
876
876
  approvalIds.clear();
877
877
 
@@ -1185,40 +1185,43 @@
1185
1185
  </p>
1186
1186
  </div>
1187
1187
  </div>
1188
- <div class="flex shrink-0 items-center gap-1">
1189
- {#if messages.length > 0}
1188
+ <div class="flex shrink-0 items-center" role="toolbar" aria-label="AI assistant controls">
1189
+ <div class="flex items-center gap-0.5">
1190
+ {#if messages.length > 0}
1191
+ <button
1192
+ type="button"
1193
+ class="svadmin-ai__icon-button"
1194
+ aria-label="Clear conversation"
1195
+ title="Clear conversation"
1196
+ onclick={clearChat}
1197
+ >
1198
+ <Trash2 size={14} strokeWidth={1.75} aria-hidden="true" />
1199
+ </button>
1200
+ {/if}
1190
1201
  <button
1191
1202
  type="button"
1192
1203
  class="svadmin-ai__icon-button"
1193
- aria-label="Clear conversation"
1194
- title="Clear conversation"
1195
- onclick={clearChat}
1204
+ aria-label={minimized ? 'Expand AI assistant' : 'Minimize AI assistant'}
1205
+ title={minimized ? 'Expand AI assistant' : 'Minimize AI assistant'}
1206
+ aria-expanded={!minimized}
1207
+ onclick={() => { minimized = !minimized; }}
1196
1208
  >
1197
- <Trash2 size={15} aria-hidden="true" />
1209
+ {#if minimized}
1210
+ <Maximize2 size={14} strokeWidth={1.75} aria-hidden="true" />
1211
+ {:else}
1212
+ <Minus size={14} strokeWidth={1.75} aria-hidden="true" />
1213
+ {/if}
1198
1214
  </button>
1199
- {/if}
1200
- <button
1201
- type="button"
1202
- class="svadmin-ai__icon-button"
1203
- aria-label={minimized ? 'Expand AI assistant' : 'Minimize AI assistant'}
1204
- title={minimized ? 'Expand AI assistant' : 'Minimize AI assistant'}
1205
- aria-expanded={!minimized}
1206
- onclick={() => { minimized = !minimized; }}
1207
- >
1208
- {#if minimized}
1209
- <Maximize2 size={15} aria-hidden="true" />
1210
- {:else}
1211
- <Minus size={15} aria-hidden="true" />
1212
- {/if}
1213
- </button>
1215
+ </div>
1216
+ <span class="mx-1.5 h-4 w-px bg-border/70" aria-hidden="true"></span>
1214
1217
  <button
1215
1218
  type="button"
1216
- class="svadmin-ai__icon-button"
1219
+ class="svadmin-ai__icon-button svadmin-ai__icon-button--close"
1217
1220
  aria-label="Close AI assistant"
1218
1221
  title="Close AI assistant"
1219
1222
  onclick={closeDialog}
1220
1223
  >
1221
- <X size={15} aria-hidden="true" />
1224
+ <X size={14} strokeWidth={1.75} aria-hidden="true" />
1222
1225
  </button>
1223
1226
  </div>
1224
1227
  </header>
@@ -7,18 +7,18 @@ export interface ChatPersistenceErrorDetail {
7
7
  error: unknown;
8
8
  }
9
9
  type Props = {
10
- /** 在布局工具栏内渲染紧凑启动按钮。 */
10
+ /** Renders a compact launcher button in the layout toolbar. */
11
11
  docked?: boolean;
12
- /** 启用 localStorage 的隔离键。必须包含稳定用户身份;未传或空字符串时不持久化。 */
12
+ /** Enables an isolated localStorage key; persistence requires a stable user identity. */
13
13
  persistKey?: string;
14
14
  onPersist?: (messages: ChatMessage[]) => void;
15
15
  onRestore?: () => ChatMessage[];
16
16
  onPersistenceError?: (detail: ChatPersistenceErrorDetail) => void;
17
- /** 定向接收 `svadmin:ask-ai` 事件的稳定作用域。 */
17
+ /** Stable scope for targeted `svadmin:ask-ai` events. */
18
18
  scope?: string;
19
- /** 所属 Layout 作用域,用于仲裁全局快捷键。 */
19
+ /** Owning Layout scope used to arbitrate global shortcuts. */
20
20
  ownerScope?: string;
21
- /** Agent 可渲染的受控组件注册表。未注册名称不会动态加载。 */
21
+ /** Controlled component registry available to Agent rendering; unregistered names are never loaded dynamically. */
22
22
  componentRegistry?: ComponentRegistry;
23
23
  class?: string;
24
24
  };
@@ -127,8 +127,8 @@ Use bullet points and do not include introductory text.`;
127
127
  <Sparkles class="size-4 text-primary" aria-hidden="true" />
128
128
  Copilot
129
129
  </h2>
130
- <button type="button" class="svadmin-ai__button svadmin-ai__button--ghost min-h-8 px-2" aria-label="Close copilot" onclick={close}>
131
- <X class="size-4" aria-hidden="true" />
130
+ <button type="button" class="svadmin-ai__icon-button svadmin-ai__icon-button--close" aria-label="Close copilot" title="Close copilot" onclick={close}>
131
+ <X size={14} strokeWidth={1.75} aria-hidden="true" />
132
132
  </button>
133
133
  </header>
134
134
 
@@ -1,2 +1,11 @@
1
1
  <script lang="ts">import type { Snippet } from 'svelte'; import { cn } from '../../utils.js'; let { class: className = '', children, ...rest }: { class?: string; children?: Snippet; [key: string]: unknown } = $props();</script>
2
- <div class={cn('flex items-center gap-1', className)} role="group" onclick={(event) => event.stopPropagation()} onkeydown={(event) => event.stopPropagation()} {...rest}>{@render children?.()}</div>
2
+ <div
3
+ class={cn('flex items-center gap-1', className)}
4
+ role="group"
5
+ onclickcapture={(event) => event.preventDefault()}
6
+ onclick={(event) => {
7
+ event.stopPropagation();
8
+ }}
9
+ onkeydown={(event) => event.stopPropagation()}
10
+ {...rest}
11
+ >{@render children?.()}</div>
@@ -18,6 +18,7 @@ export interface AIElementParityEntry {
18
18
  surfaceStatus: AIElementParityStatus;
19
19
  componentSurfaceStatus: AIElementParityStatus;
20
20
  behaviorStatus: AIElementParityVerificationStatus;
21
+ behaviorEvidence: readonly string[];
21
22
  visualStatus: AIElementParityVerificationStatus;
22
23
  exactExports: readonly string[];
23
24
  fallbackExports: readonly string[];
@@ -52,6 +52,7 @@ function family(upstream, exportName, definition) {
52
52
  surfaceStatus: getStatus(exports),
53
53
  componentSurfaceStatus: getStatus(componentExports),
54
54
  behaviorStatus: definition.behavior ?? 'unverified',
55
+ behaviorEvidence: names(definition.behaviorEvidence ?? ''),
55
56
  visualStatus: definition.visual ?? 'unverified',
56
57
  exactExports: exports
57
58
  .filter(({ surfaceStatus }) => surfaceStatus === 'exact')
@@ -71,210 +72,306 @@ export const AI_ELEMENT_PARITY = [
71
72
  family('agent', 'Agent', {
72
73
  official: 'Agent AgentHeader AgentContent AgentInstructions AgentTools AgentTool AgentOutput',
73
74
  exact: 'Agent AgentHeader AgentContent AgentInstructions AgentTools AgentTool AgentOutput',
75
+ behavior: 'verified',
76
+ behaviorEvidence: 'src/components/family-behavior-parity.test.svelte.ts',
74
77
  }),
75
78
  family('artifact', 'Artifact', {
76
79
  official: 'Artifact ArtifactHeader ArtifactClose ArtifactTitle ArtifactDescription ArtifactActions ArtifactAction ArtifactContent',
77
80
  exact: 'Artifact ArtifactHeader ArtifactClose ArtifactTitle ArtifactDescription ArtifactActions ArtifactAction ArtifactContent',
81
+ behavior: 'verified',
82
+ behaviorEvidence: 'src/components/compound-foundations.test.svelte.ts',
78
83
  }),
79
84
  family('attachments', 'Attachments', {
80
85
  official: 'getMediaCategory getAttachmentLabel useAttachmentsContext useAttachmentContext Attachments Attachment AttachmentPreview AttachmentInfo AttachmentRemove AttachmentHoverCard AttachmentHoverCardTrigger AttachmentHoverCardContent AttachmentEmpty',
81
86
  exact: 'getMediaCategory getAttachmentLabel useAttachmentsContext useAttachmentContext Attachments Attachment AttachmentPreview AttachmentInfo AttachmentRemove AttachmentHoverCard AttachmentHoverCardTrigger AttachmentHoverCardContent AttachmentEmpty',
82
87
  helpers: 'getMediaCategory getAttachmentLabel useAttachmentsContext useAttachmentContext',
88
+ behavior: 'verified',
89
+ behaviorEvidence: 'src/components/attachments/attachments.test.svelte.ts',
83
90
  }),
84
91
  family('audio-player', 'AudioPlayer', {
85
92
  official: 'AudioPlayer AudioPlayerElement AudioPlayerControlBar AudioPlayerPlayButton AudioPlayerSeekBackwardButton AudioPlayerSeekForwardButton AudioPlayerTimeDisplay AudioPlayerTimeRange AudioPlayerDurationDisplay AudioPlayerMuteButton AudioPlayerVolumeRange',
86
93
  exact: 'AudioPlayer AudioPlayerElement AudioPlayerControlBar AudioPlayerPlayButton AudioPlayerSeekBackwardButton AudioPlayerSeekForwardButton AudioPlayerTimeDisplay AudioPlayerTimeRange AudioPlayerDurationDisplay AudioPlayerMuteButton AudioPlayerVolumeRange',
94
+ behavior: 'verified',
95
+ behaviorEvidence: 'src/components/audio-player/AudioPlayer.test.svelte.ts',
87
96
  }),
88
97
  family('canvas', 'Canvas', {
89
98
  official: 'Canvas',
90
99
  exact: 'Canvas',
100
+ behavior: 'verified',
101
+ behaviorEvidence: 'src/components/canvas/workflow-primitives.test.svelte.ts',
91
102
  }),
92
103
  family('chain-of-thought', 'ChainOfThought', {
93
104
  official: 'ChainOfThought ChainOfThoughtHeader ChainOfThoughtStep ChainOfThoughtSearchResults ChainOfThoughtSearchResult ChainOfThoughtContent ChainOfThoughtImage',
94
105
  exact: 'ChainOfThought ChainOfThoughtHeader ChainOfThoughtStep ChainOfThoughtSearchResults ChainOfThoughtSearchResult ChainOfThoughtContent ChainOfThoughtImage',
106
+ behavior: 'verified',
107
+ behaviorEvidence: 'src/components/family-behavior-parity.test.svelte.ts',
95
108
  }),
96
109
  family('checkpoint', 'Checkpoint', {
97
110
  official: 'Checkpoint CheckpointIcon CheckpointTrigger',
98
111
  exact: 'Checkpoint CheckpointIcon CheckpointTrigger',
112
+ behavior: 'verified',
113
+ behaviorEvidence: 'src/components/snippet/display-primitives.test.svelte.ts',
99
114
  }),
100
115
  family('code-block', 'CodeBlock', {
101
116
  official: 'highlightCode CodeBlockContainer CodeBlockHeader CodeBlockTitle CodeBlockFilename CodeBlockActions CodeBlockContent CodeBlock CodeBlockCopyButton CodeBlockLanguageSelector CodeBlockLanguageSelectorTrigger CodeBlockLanguageSelectorValue CodeBlockLanguageSelectorContent CodeBlockLanguageSelectorItem',
102
117
  exact: 'highlightCode CodeBlockContainer CodeBlockHeader CodeBlockTitle CodeBlockFilename CodeBlockActions CodeBlockContent CodeBlock CodeBlockCopyButton CodeBlockLanguageSelector CodeBlockLanguageSelectorTrigger CodeBlockLanguageSelectorValue CodeBlockLanguageSelectorContent CodeBlockLanguageSelectorItem',
103
118
  helpers: 'highlightCode',
119
+ behavior: 'verified',
120
+ behaviorEvidence: 'src/components/code-block/code-block.test.svelte.ts',
104
121
  }),
105
122
  family('commit', 'Commit', {
106
123
  official: 'Commit CommitHeader CommitHash CommitMessage CommitMetadata CommitSeparator CommitInfo CommitAuthor CommitAuthorAvatar CommitTimestamp CommitActions CommitCopyButton CommitContent CommitFiles CommitFile CommitFileInfo CommitFileStatus CommitFileIcon CommitFilePath CommitFileChanges CommitFileAdditions CommitFileDeletions',
107
124
  exact: 'Commit CommitHeader CommitHash CommitMessage CommitMetadata CommitSeparator CommitInfo CommitAuthor CommitAuthorAvatar CommitTimestamp CommitActions CommitCopyButton CommitContent CommitFiles CommitFile CommitFileInfo CommitFileStatus CommitFileIcon CommitFilePath CommitFileChanges CommitFileAdditions CommitFileDeletions',
125
+ behavior: 'verified',
126
+ behaviorEvidence: 'src/components/family-behavior-parity.test.svelte.ts',
108
127
  }),
109
128
  family('confirmation', 'Confirmation', {
110
129
  official: 'Confirmation ConfirmationTitle ConfirmationRequest ConfirmationAccepted ConfirmationRejected ConfirmationActions ConfirmationAction',
111
130
  exact: 'Confirmation ConfirmationTitle ConfirmationRequest ConfirmationAccepted ConfirmationRejected ConfirmationActions ConfirmationAction',
131
+ behavior: 'verified',
132
+ behaviorEvidence: 'src/components/chat-core-compounds.test.svelte.ts',
112
133
  }),
113
134
  family('connection', 'Connection', {
114
135
  official: 'Connection',
115
136
  exact: 'Connection',
137
+ behavior: 'verified',
138
+ behaviorEvidence: 'src/components/canvas/workflow-primitives.test.svelte.ts',
116
139
  }),
117
140
  family('context', 'Context', {
118
141
  official: 'Context ContextTrigger ContextContent ContextContentHeader ContextContentBody ContextContentFooter ContextInputUsage ContextOutputUsage ContextReasoningUsage ContextCacheUsage',
119
142
  exact: 'Context ContextTrigger ContextContent ContextContentHeader ContextContentBody ContextContentFooter ContextInputUsage ContextOutputUsage ContextReasoningUsage ContextCacheUsage',
143
+ behavior: 'verified',
144
+ behaviorEvidence: 'src/components/official-parity-regressions.test.svelte.ts',
120
145
  }),
121
146
  family('controls', 'Controls', {
122
147
  official: 'Controls',
123
148
  exact: 'Controls',
149
+ behavior: 'verified',
150
+ behaviorEvidence: 'src/components/canvas/workflow-primitives.test.svelte.ts',
124
151
  }),
125
152
  family('conversation', 'Conversation', {
126
153
  official: 'Conversation ConversationContent ConversationEmptyState ConversationScrollButton messagesToMarkdown ConversationDownload',
127
154
  exact: 'Conversation ConversationContent ConversationEmptyState ConversationScrollButton messagesToMarkdown ConversationDownload',
128
155
  helpers: 'messagesToMarkdown',
156
+ behavior: 'verified',
157
+ behaviorEvidence: 'src/components/chat-core-compounds.test.svelte.ts',
129
158
  }),
130
159
  family('edge', 'Edge', {
131
160
  official: 'Edge',
132
161
  exact: 'Edge',
162
+ behavior: 'verified',
163
+ behaviorEvidence: 'src/components/canvas/workflow-primitives.test.svelte.ts',
133
164
  }),
134
165
  family('environment-variables', 'EnvironmentVariables', {
135
166
  official: 'EnvironmentVariables EnvironmentVariablesHeader EnvironmentVariablesTitle EnvironmentVariablesToggle EnvironmentVariablesContent EnvironmentVariableGroup EnvironmentVariableName EnvironmentVariableValue EnvironmentVariable EnvironmentVariableCopyButton EnvironmentVariableRequired',
136
167
  exact: 'EnvironmentVariables EnvironmentVariablesHeader EnvironmentVariablesTitle EnvironmentVariablesToggle EnvironmentVariablesContent EnvironmentVariableGroup EnvironmentVariableName EnvironmentVariableValue EnvironmentVariable EnvironmentVariableCopyButton EnvironmentVariableRequired',
168
+ behavior: 'verified',
169
+ behaviorEvidence: 'src/components/family-behavior-parity.test.svelte.ts',
137
170
  }),
138
171
  family('file-tree', 'FileTree', {
139
172
  official: 'FileTree FileTreeIcon FileTreeName FileTreeFolder FileTreeFile FileTreeActions',
140
173
  exact: 'FileTree FileTreeIcon FileTreeName FileTreeFolder FileTreeFile FileTreeActions',
174
+ behavior: 'verified',
175
+ behaviorEvidence: 'src/components/official-parity-regressions.test.svelte.ts',
141
176
  }),
142
177
  family('image', 'Image', {
143
178
  official: 'Image',
144
179
  exact: 'Image',
180
+ behavior: 'verified',
181
+ behaviorEvidence: 'src/components/snippet/display-primitives.test.svelte.ts',
145
182
  }),
146
183
  family('inline-citation', 'InlineCitation', {
147
184
  official: 'InlineCitation InlineCitationText InlineCitationCard InlineCitationCardTrigger InlineCitationCardBody InlineCitationCarousel InlineCitationCarouselContent InlineCitationCarouselItem InlineCitationCarouselHeader InlineCitationCarouselIndex InlineCitationCarouselPrev InlineCitationCarouselNext InlineCitationSource InlineCitationQuote',
148
185
  exact: 'InlineCitation InlineCitationText InlineCitationCard InlineCitationCardTrigger InlineCitationCardBody InlineCitationCarousel InlineCitationCarouselContent InlineCitationCarouselItem InlineCitationCarouselHeader InlineCitationCarouselIndex InlineCitationCarouselPrev InlineCitationCarouselNext InlineCitationSource InlineCitationQuote',
186
+ behavior: 'verified',
187
+ behaviorEvidence: 'src/components/inline-citation/InlineCitation.compound.test.svelte.ts',
149
188
  }),
150
189
  family('jsx-preview', 'JSXPreview', {
151
190
  official: 'useJSXPreview JSXPreview JSXPreviewContent JSXPreviewError',
152
191
  exact: 'useJSXPreview JSXPreview JSXPreviewContent JSXPreviewError',
153
192
  helpers: 'useJSXPreview',
154
193
  behavior: 'intentional-difference',
194
+ behaviorEvidence: 'src/components/jsx-preview/jsx-preview.test.svelte.ts',
155
195
  }),
156
196
  family('message', 'Message', {
157
197
  official: 'Message MessageContent MessageActions MessageAction MessageBranch MessageBranchContent MessageBranchSelector MessageBranchPrevious MessageBranchNext MessageBranchPage MessageResponse MessageToolbar',
158
198
  exact: 'Message MessageContent MessageActions MessageAction MessageBranch MessageBranchContent MessageBranchSelector MessageBranchPrevious MessageBranchNext MessageBranchPage MessageResponse MessageToolbar',
199
+ behavior: 'verified',
200
+ behaviorEvidence: 'src/components/chat-core-compounds.test.svelte.ts',
159
201
  }),
160
202
  family('mic-selector', 'MicSelector', {
161
203
  official: 'useAudioDevices MicSelector MicSelectorTrigger MicSelectorContent MicSelectorInput MicSelectorList MicSelectorEmpty MicSelectorItem MicSelectorLabel MicSelectorValue',
162
204
  exact: 'useAudioDevices MicSelector MicSelectorTrigger MicSelectorContent MicSelectorInput MicSelectorList MicSelectorEmpty MicSelectorItem MicSelectorLabel MicSelectorValue',
163
205
  helpers: 'useAudioDevices',
206
+ behavior: 'verified',
207
+ behaviorEvidence: 'src/components/speech-input/interactive-primitives.test.svelte.ts',
164
208
  }),
165
209
  family('model-selector', 'ModelSelector', {
166
210
  official: 'ModelSelector ModelSelectorTrigger ModelSelectorContent ModelSelectorDialog ModelSelectorInput ModelSelectorList ModelSelectorEmpty ModelSelectorGroup ModelSelectorItem ModelSelectorShortcut ModelSelectorSeparator ModelSelectorLogo ModelSelectorLogoGroup ModelSelectorName',
167
211
  exact: 'ModelSelector ModelSelectorTrigger ModelSelectorContent ModelSelectorDialog ModelSelectorInput ModelSelectorList ModelSelectorEmpty ModelSelectorGroup ModelSelectorItem ModelSelectorShortcut ModelSelectorSeparator ModelSelectorLogo ModelSelectorLogoGroup ModelSelectorName',
212
+ behavior: 'verified',
213
+ behaviorEvidence: 'src/components/model-selector/model-selector.test.svelte.ts',
168
214
  }),
169
215
  family('node', 'Node', {
170
216
  official: 'Node NodeHeader NodeTitle NodeDescription NodeAction NodeContent NodeFooter',
171
217
  exact: 'Node NodeHeader NodeTitle NodeDescription NodeAction NodeContent NodeFooter',
218
+ behavior: 'verified',
219
+ behaviorEvidence: 'src/components/canvas/workflow-primitives.test.svelte.ts',
172
220
  }),
173
221
  family('open-in-chat', 'OpenIn', {
174
222
  official: 'OpenIn OpenInContent OpenInItem OpenInLabel OpenInSeparator OpenInTrigger OpenInChatGPT OpenInClaude OpenInT3 OpenInScira OpenInv0 OpenInCursor',
175
223
  exact: 'OpenIn OpenInContent OpenInItem OpenInLabel OpenInSeparator OpenInTrigger OpenInChatGPT OpenInClaude OpenInT3 OpenInScira OpenInv0 OpenInCursor',
224
+ behavior: 'verified',
225
+ behaviorEvidence: 'src/components/core-contracts.test.svelte.ts',
176
226
  }),
177
227
  family('package-info', 'PackageInfo', {
178
228
  official: 'PackageInfoHeader PackageInfoName PackageInfoChangeType PackageInfoVersion PackageInfo PackageInfoDescription PackageInfoContent PackageInfoDependencies PackageInfoDependency',
179
229
  exact: 'PackageInfoHeader PackageInfoName PackageInfoChangeType PackageInfoVersion PackageInfo PackageInfoDescription PackageInfoContent PackageInfoDependencies PackageInfoDependency',
230
+ behavior: 'verified',
231
+ behaviorEvidence: 'src/components/family-behavior-parity.test.svelte.ts',
180
232
  }),
181
233
  family('panel', 'Panel', {
182
234
  official: 'Panel',
183
235
  exact: 'Panel',
236
+ behavior: 'verified',
237
+ behaviorEvidence: 'src/components/canvas/workflow-primitives.test.svelte.ts',
184
238
  }),
185
239
  family('persona', 'Persona', {
186
240
  official: 'Persona',
187
241
  exact: 'Persona',
242
+ behavior: 'verified',
243
+ behaviorEvidence: 'src/components/persona/Persona.test.svelte.ts',
188
244
  }),
189
245
  family('plan', 'Plan', {
190
246
  official: 'Plan PlanHeader PlanTitle PlanDescription PlanAction PlanContent PlanFooter PlanTrigger',
191
247
  exact: 'Plan PlanHeader PlanTitle PlanDescription PlanAction PlanContent PlanFooter PlanTrigger',
248
+ behavior: 'verified',
249
+ behaviorEvidence: 'src/components/compound-foundations.test.svelte.ts',
192
250
  }),
193
251
  family('prompt-input', 'PromptInput', {
194
252
  official: 'usePromptInputController useProviderAttachments PromptInputProvider usePromptInputAttachments LocalReferencedSourcesContext usePromptInputReferencedSources PromptInputActionAddAttachments PromptInputActionAddScreenshot PromptInput PromptInputBody PromptInputTextarea PromptInputHeader PromptInputFooter PromptInputTools PromptInputButton PromptInputActionMenu PromptInputActionMenuTrigger PromptInputActionMenuContent PromptInputActionMenuItem PromptInputSubmit PromptInputSelect PromptInputSelectTrigger PromptInputSelectContent PromptInputSelectItem PromptInputSelectValue PromptInputHoverCard PromptInputHoverCardTrigger PromptInputHoverCardContent PromptInputTabsList PromptInputTab PromptInputTabLabel PromptInputTabBody PromptInputTabItem PromptInputCommand PromptInputCommandInput PromptInputCommandList PromptInputCommandEmpty PromptInputCommandGroup PromptInputCommandItem PromptInputCommandSeparator',
195
253
  exact: 'usePromptInputController useProviderAttachments PromptInputProvider usePromptInputAttachments LocalReferencedSourcesContext usePromptInputReferencedSources PromptInputActionAddAttachments PromptInputActionAddScreenshot PromptInput PromptInputBody PromptInputTextarea PromptInputHeader PromptInputFooter PromptInputTools PromptInputButton PromptInputActionMenu PromptInputActionMenuTrigger PromptInputActionMenuContent PromptInputActionMenuItem PromptInputSubmit PromptInputSelect PromptInputSelectTrigger PromptInputSelectContent PromptInputSelectItem PromptInputSelectValue PromptInputHoverCard PromptInputHoverCardTrigger PromptInputHoverCardContent PromptInputTabsList PromptInputTab PromptInputTabLabel PromptInputTabBody PromptInputTabItem PromptInputCommand PromptInputCommandInput PromptInputCommandList PromptInputCommandEmpty PromptInputCommandGroup PromptInputCommandItem PromptInputCommandSeparator',
196
254
  helpers: 'usePromptInputController useProviderAttachments usePromptInputAttachments usePromptInputReferencedSources',
255
+ behavior: 'verified',
256
+ behaviorEvidence: 'src/components/prompt-input/PromptInput.test.svelte.ts',
197
257
  }),
198
258
  family('question', 'Question', {
199
259
  official: 'Question QuestionPrompt QuestionDescription QuestionOptions QuestionOption QuestionInput QuestionActions QuestionSubmit',
200
260
  exact: 'Question QuestionPrompt QuestionDescription QuestionOptions QuestionOption QuestionInput QuestionActions QuestionSubmit',
261
+ behavior: 'verified',
262
+ behaviorEvidence: 'src/components/question/workflow-components.test.svelte.ts',
201
263
  }),
202
264
  family('queue', 'Queue', {
203
265
  official: 'QueueItem QueueItemIndicator QueueItemContent QueueItemDescription QueueItemActions QueueItemAction QueueItemAttachment QueueItemImage QueueItemFile QueueList QueueSection QueueSectionTrigger QueueSectionLabel QueueSectionContent Queue',
204
266
  exact: 'QueueItem QueueItemIndicator QueueItemContent QueueItemDescription QueueItemActions QueueItemAction QueueItemAttachment QueueItemImage QueueItemFile QueueList QueueSection QueueSectionTrigger QueueSectionLabel QueueSectionContent Queue',
267
+ behavior: 'verified',
268
+ behaviorEvidence: 'src/components/compound-foundations.test.svelte.ts',
205
269
  }),
206
270
  family('reasoning', 'Reasoning', {
207
271
  official: 'useReasoning Reasoning ReasoningTrigger ReasoningContent',
208
272
  exact: 'useReasoning Reasoning ReasoningTrigger ReasoningContent',
209
273
  helpers: 'useReasoning',
274
+ behavior: 'verified',
275
+ behaviorEvidence: 'src/components/core-contracts.test.svelte.ts',
210
276
  }),
211
277
  family('sandbox', 'Sandbox', {
212
278
  official: 'Sandbox SandboxHeader SandboxContent SandboxTabs SandboxTabsBar SandboxTabsList SandboxTabsTrigger SandboxTabContent',
213
279
  exact: 'Sandbox SandboxHeader SandboxContent SandboxTabs SandboxTabsBar SandboxTabsList SandboxTabsTrigger SandboxTabContent',
280
+ behavior: 'verified',
281
+ behaviorEvidence: 'src/components/official-parity-regressions.test.svelte.ts',
214
282
  }),
215
283
  family('schema-display', 'SchemaDisplay', {
216
284
  official: 'SchemaDisplayHeader SchemaDisplayMethod SchemaDisplayPath SchemaDisplayDescription SchemaDisplayContent SchemaDisplayParameter SchemaDisplayParameters SchemaDisplayProperty SchemaDisplayRequest SchemaDisplayResponse SchemaDisplay SchemaDisplayBody SchemaDisplayExample',
217
285
  exact: 'SchemaDisplayHeader SchemaDisplayMethod SchemaDisplayPath SchemaDisplayDescription SchemaDisplayContent SchemaDisplayParameter SchemaDisplayParameters SchemaDisplayProperty SchemaDisplayRequest SchemaDisplayResponse SchemaDisplay SchemaDisplayBody SchemaDisplayExample',
286
+ behavior: 'verified',
287
+ behaviorEvidence: 'src/components/web-preview/display-family-compounds.test.svelte.ts',
218
288
  }),
219
289
  family('shimmer', 'Shimmer', {
220
290
  official: 'Shimmer',
221
291
  exact: 'Shimmer',
292
+ behavior: 'verified',
293
+ behaviorEvidence: 'src/components/snippet/display-primitives.test.svelte.ts',
222
294
  }),
223
295
  family('snippet', 'Snippet', {
224
296
  official: 'Snippet SnippetAddon SnippetText SnippetInput SnippetCopyButton',
225
297
  exact: 'Snippet SnippetAddon SnippetText SnippetInput SnippetCopyButton',
298
+ behavior: 'verified',
299
+ behaviorEvidence: 'src/components/snippet/display-primitives.test.svelte.ts',
226
300
  }),
227
301
  family('sources', 'Sources', {
228
302
  official: 'Sources SourcesTrigger SourcesContent Source',
229
303
  exact: 'Sources SourcesTrigger SourcesContent Source',
304
+ behavior: 'verified',
305
+ behaviorEvidence: 'src/components/chat-core-compounds.test.svelte.ts',
230
306
  }),
231
307
  family('speech-input', 'SpeechInput', {
232
308
  official: 'SpeechInput',
233
309
  exact: 'SpeechInput',
310
+ behavior: 'verified',
311
+ behaviorEvidence: 'src/components/speech-input/interactive-primitives.test.svelte.ts',
234
312
  }),
235
313
  family('stack-trace', 'StackTrace', {
236
314
  official: 'StackTrace StackTraceHeader StackTraceError StackTraceErrorType StackTraceErrorMessage StackTraceActions StackTraceCopyButton StackTraceExpandButton StackTraceContent StackTraceFrames',
237
315
  exact: 'StackTrace StackTraceHeader StackTraceError StackTraceErrorType StackTraceErrorMessage StackTraceActions StackTraceCopyButton StackTraceExpandButton StackTraceContent StackTraceFrames',
316
+ behavior: 'verified',
317
+ behaviorEvidence: 'src/components/official-parity-regressions.test.svelte.ts',
238
318
  }),
239
319
  family('suggestion', 'Suggestions', {
240
320
  official: 'Suggestions Suggestion',
241
321
  exact: 'Suggestions Suggestion',
242
322
  namespaceExport: 'SuggestionParts',
323
+ behavior: 'verified',
324
+ behaviorEvidence: 'src/components/snippet/display-primitives.test.svelte.ts',
243
325
  }),
244
326
  family('task', 'Task', {
245
327
  official: 'TaskItemFile TaskItem Task TaskTrigger TaskContent',
246
328
  exact: 'TaskItemFile TaskItem Task TaskTrigger TaskContent',
329
+ behavior: 'verified',
330
+ behaviorEvidence: 'src/components/compound-foundations.test.svelte.ts',
247
331
  }),
248
332
  family('terminal', 'Terminal', {
249
333
  official: 'TerminalHeader TerminalTitle TerminalStatus TerminalActions TerminalCopyButton TerminalClearButton TerminalContent Terminal',
250
334
  exact: 'TerminalHeader TerminalTitle TerminalStatus TerminalActions TerminalCopyButton TerminalClearButton TerminalContent Terminal',
335
+ behavior: 'verified',
336
+ behaviorEvidence: 'src/components/official-parity-regressions.test.svelte.ts',
251
337
  }),
252
338
  family('test-results', 'TestResults', {
253
339
  official: 'TestResultsHeader TestResultsDuration TestResultsSummary TestResults TestResultsProgress TestResultsContent TestSuite TestSuiteName TestSuiteStats TestSuiteContent TestName TestDuration TestStatus Test TestError TestErrorMessage TestErrorStack',
254
340
  exact: 'TestResultsHeader TestResultsDuration TestResultsSummary TestResults TestResultsProgress TestResultsContent TestSuite TestSuiteName TestSuiteStats TestSuiteContent TestName TestDuration TestStatus Test TestError TestErrorMessage TestErrorStack',
341
+ behavior: 'verified',
342
+ behaviorEvidence: 'src/components/web-preview/display-family-compounds.test.svelte.ts',
255
343
  }),
256
344
  family('tool', 'Tool', {
257
345
  official: 'Tool getStatusBadge ToolHeader ToolContent ToolInput ToolOutput',
258
346
  exact: 'Tool getStatusBadge ToolHeader ToolContent ToolInput ToolOutput',
259
347
  helpers: 'getStatusBadge',
260
348
  behavior: 'intentional-difference',
349
+ behaviorEvidence: 'src/components/chat-core-compounds.test.svelte.ts',
261
350
  }),
262
351
  family('toolbar', 'Toolbar', {
263
352
  official: 'Toolbar',
264
353
  exact: 'Toolbar',
354
+ behavior: 'verified',
355
+ behaviorEvidence: 'src/components/canvas/workflow-primitives.test.svelte.ts',
265
356
  }),
266
357
  family('transcription', 'Transcription', {
267
358
  official: 'Transcription TranscriptionSegment',
268
359
  exact: 'Transcription TranscriptionSegment',
360
+ behavior: 'verified',
361
+ behaviorEvidence: 'src/components/official-parity-regressions.test.svelte.ts',
269
362
  }),
270
363
  family('voice-selector', 'VoiceSelector', {
271
364
  official: 'useVoiceSelector VoiceSelector VoiceSelectorTrigger VoiceSelectorContent VoiceSelectorDialog VoiceSelectorInput VoiceSelectorList VoiceSelectorEmpty VoiceSelectorGroup VoiceSelectorItem VoiceSelectorShortcut VoiceSelectorSeparator VoiceSelectorGender VoiceSelectorAccent VoiceSelectorAge VoiceSelectorName VoiceSelectorDescription VoiceSelectorAttributes VoiceSelectorBullet VoiceSelectorPreview',
272
365
  exact: 'useVoiceSelector VoiceSelector VoiceSelectorTrigger VoiceSelectorContent VoiceSelectorDialog VoiceSelectorInput VoiceSelectorList VoiceSelectorEmpty VoiceSelectorGroup VoiceSelectorItem VoiceSelectorShortcut VoiceSelectorSeparator VoiceSelectorGender VoiceSelectorAccent VoiceSelectorAge VoiceSelectorName VoiceSelectorDescription VoiceSelectorAttributes VoiceSelectorBullet VoiceSelectorPreview',
273
366
  helpers: 'useVoiceSelector',
367
+ behavior: 'verified',
368
+ behaviorEvidence: 'src/components/voice-selector/VoiceSelector.test.svelte.ts',
274
369
  }),
275
370
  family('web-preview', 'WebPreview', {
276
371
  official: 'WebPreview WebPreviewNavigation WebPreviewNavigationButton WebPreviewUrl WebPreviewBody WebPreviewConsole',
277
372
  exact: 'WebPreview WebPreviewNavigation WebPreviewNavigationButton WebPreviewUrl WebPreviewBody WebPreviewConsole',
373
+ behavior: 'verified',
374
+ behaviorEvidence: 'src/components/web-preview/display-family-compounds.test.svelte.ts',
278
375
  }),
279
376
  ];
280
377
  function getBreakdown(exports) {
package/dist/utils.d.ts CHANGED
@@ -1,5 +1,4 @@
1
- import { type ClassValue } from 'clsx';
2
- export declare function cn(...inputs: ClassValue[]): string;
1
+ export { cn } from 'cn';
3
2
  export type SnippetLike = import('svelte').Snippet;
4
3
  export declare function stopPropagation(event: Event): void;
5
4
  export declare function isPromiseLike(value: unknown): value is PromiseLike<unknown>;
package/dist/utils.js CHANGED
@@ -1,9 +1,5 @@
1
- import { clsx } from 'clsx';
2
- import { twMerge } from 'tailwind-merge';
1
+ export { cn } from 'cn';
3
2
  const RESOURCE_PROTOCOLS = new Set(['http:', 'https:', 'blob:']);
4
- export function cn(...inputs) {
5
- return twMerge(clsx(inputs));
6
- }
7
3
  export function stopPropagation(event) {
8
4
  event.stopPropagation();
9
5
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@svadmin/ai-elements",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "description": "Composable Svelte 5 AI interaction components for SVAdmin",
5
5
  "type": "module",
6
6
  "sideEffects": [
@@ -9,6 +9,7 @@
9
9
  "files": [
10
10
  "dist",
11
11
  "README.md",
12
+ "UPSTREAM_PARITY.md",
12
13
  "THIRD_PARTY_NOTICES.md",
13
14
  "!dist/**/*.test.*",
14
15
  "!dist/**/*.test-*",
@@ -64,7 +65,7 @@
64
65
  "@rive-app/webgl2": "^2.41.0",
65
66
  "@sinclair/typebox": "^0.34.52",
66
67
  "@xyflow/svelte": "^1.6.5",
67
- "clsx": "^2.1.1",
68
+ "cn": "^0.2.4",
68
69
  "streamdown-svelte": "^3.0.6",
69
70
  "tailwind-merge": "^3.6.0",
70
71
  "tailwind-variants": "^3.3.1"