@wcomp/elementum 0.0.0-stage → 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 (102) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +282 -2
  3. package/custom-elements.json +3613 -0
  4. package/mcp/server.js +593 -0
  5. package/package.json +77 -4
  6. package/skills/elementum-break-ui/CATALOG.md +11 -0
  7. package/skills/elementum-break-ui/SKILL.md +16 -0
  8. package/skills/elementum-mobile/SKILL.md +18 -0
  9. package/skills/elementum-motion/SKILL.md +18 -0
  10. package/skills/elementum-motion/STANDARDS.md +15 -0
  11. package/skills/elementum-penpot/SKILL.md +45 -0
  12. package/skills/elementum-ui/CATALOG.md +14 -0
  13. package/skills/elementum-ui/SKILL.md +21 -0
  14. package/src/ag-ui.js +474 -0
  15. package/src/behaviors/index.js +760 -0
  16. package/src/components/el-accordion.js +201 -0
  17. package/src/components/el-alert-dialog.js +186 -0
  18. package/src/components/el-alert.js +254 -0
  19. package/src/components/el-aspect-ratio.js +73 -0
  20. package/src/components/el-autocomplete.js +775 -0
  21. package/src/components/el-avatar.js +271 -0
  22. package/src/components/el-badge.js +131 -0
  23. package/src/components/el-border-beam.js +135 -0
  24. package/src/components/el-breadcrumb.js +203 -0
  25. package/src/components/el-button.js +231 -0
  26. package/src/components/el-calendar.js +436 -0
  27. package/src/components/el-callout.js +158 -0
  28. package/src/components/el-card.js +298 -0
  29. package/src/components/el-carousel.js +308 -0
  30. package/src/components/el-chart.js +632 -0
  31. package/src/components/el-checkbox-card.js +221 -0
  32. package/src/components/el-checkbox.js +208 -0
  33. package/src/components/el-chip.js +276 -0
  34. package/src/components/el-code-block.js +230 -0
  35. package/src/components/el-collapsible.js +124 -0
  36. package/src/components/el-command.js +556 -0
  37. package/src/components/el-context-menu.js +328 -0
  38. package/src/components/el-data-list.js +210 -0
  39. package/src/components/el-datepicker.js +192 -0
  40. package/src/components/el-dialog.js +272 -0
  41. package/src/components/el-diff-viewer.js +441 -0
  42. package/src/components/el-drawer.js +782 -0
  43. package/src/components/el-dropdown.js +182 -0
  44. package/src/components/el-dropzone.js +242 -0
  45. package/src/components/el-empty-state.js +130 -0
  46. package/src/components/el-field.js +394 -0
  47. package/src/components/el-form.js +185 -0
  48. package/src/components/el-input.js +229 -0
  49. package/src/components/el-inset.js +90 -0
  50. package/src/components/el-insight-card.js +263 -0
  51. package/src/components/el-kbd.js +151 -0
  52. package/src/components/el-menubar.js +254 -0
  53. package/src/components/el-meter.js +183 -0
  54. package/src/components/el-navbar.js +294 -0
  55. package/src/components/el-navigation-menu.js +327 -0
  56. package/src/components/el-number-field.js +510 -0
  57. package/src/components/el-number-flow.js +164 -0
  58. package/src/components/el-otp-input.js +266 -0
  59. package/src/components/el-pagination.js +231 -0
  60. package/src/components/el-popover.js +288 -0
  61. package/src/components/el-preview-card.js +202 -0
  62. package/src/components/el-progress.js +179 -0
  63. package/src/components/el-prompt-input.js +383 -0
  64. package/src/components/el-radio-card.js +360 -0
  65. package/src/components/el-radio.js +257 -0
  66. package/src/components/el-rating.js +165 -0
  67. package/src/components/el-reasoning-card.js +293 -0
  68. package/src/components/el-resizable.js +324 -0
  69. package/src/components/el-router.js +305 -0
  70. package/src/components/el-scroll-area.js +150 -0
  71. package/src/components/el-segmented-control.js +282 -0
  72. package/src/components/el-select.js +220 -0
  73. package/src/components/el-separator.js +85 -0
  74. package/src/components/el-sidebar.js +386 -0
  75. package/src/components/el-skeleton.js +156 -0
  76. package/src/components/el-slider.js +351 -0
  77. package/src/components/el-sources.js +288 -0
  78. package/src/components/el-spinner.js +159 -0
  79. package/src/components/el-streaming-text.js +199 -0
  80. package/src/components/el-switch.js +221 -0
  81. package/src/components/el-table.js +397 -0
  82. package/src/components/el-tabs.js +235 -0
  83. package/src/components/el-task-list.js +230 -0
  84. package/src/components/el-textarea.js +175 -0
  85. package/src/components/el-theme-switch.js +120 -0
  86. package/src/components/el-timeline.js +254 -0
  87. package/src/components/el-toast.js +778 -0
  88. package/src/components/el-toggle.js +311 -0
  89. package/src/components/el-tool-call.js +386 -0
  90. package/src/components/el-toolbar.js +183 -0
  91. package/src/components/el-tooltip.js +172 -0
  92. package/src/components/el-tree-view.js +261 -0
  93. package/src/components/el-visually-hidden.js +32 -0
  94. package/src/elementum.js +504 -0
  95. package/src/index.d.ts +1093 -0
  96. package/src/index.js +112 -0
  97. package/src/signal.js +215 -0
  98. package/src/ssr.js +136 -0
  99. package/src/template.js +321 -0
  100. package/src/tokens.css +416 -0
  101. package/tokens/figma-tokens.json +69 -0
  102. package/tokens/penpot-tokens.json +98 -0
package/src/index.d.ts ADDED
@@ -0,0 +1,1093 @@
1
+ /**
2
+ * @wcomp/elementum TypeScript Declarations
3
+ * Fine-grained reactive Web Component framework & design system.
4
+ */
5
+
6
+ export interface AbortableOptions {
7
+ signal?: AbortSignal;
8
+ }
9
+
10
+ // ==========================================
11
+ // Signal Reactivity Primitives
12
+ // ==========================================
13
+
14
+ export class Signal<T = any> {
15
+ constructor(initialValue: T);
16
+ get value(): T;
17
+ set value(newValue: T);
18
+ peek(): T;
19
+ valueOf(): T;
20
+ toString(): string;
21
+ toUpperCase(): string;
22
+ toLowerCase(): string;
23
+ trim(): string;
24
+ slice(start?: number, end?: number): string;
25
+ substring(start: number, end?: number): string;
26
+ includes(searchString: string, position?: number): boolean;
27
+ indexOf(searchString: string, position?: number): number;
28
+ startsWith(searchString: string, position?: number): boolean;
29
+ endsWith(searchString: string, position?: number): boolean;
30
+ get length(): number;
31
+ [Symbol.toPrimitive](hint: string): string | number;
32
+ }
33
+
34
+ export function signal<T>(initialValue: T): Signal<T>;
35
+ export function isSignal(val: any): val is Signal<any>;
36
+
37
+ export class Computed<T = any> extends Signal<T> {
38
+ constructor(getter: () => T);
39
+ }
40
+
41
+ export function computed<T>(getter: () => T): Computed<T>;
42
+ export function effect(fn: () => void, options?: AbortableOptions): () => void;
43
+
44
+ // ==========================================
45
+ // Template & CSS Engine
46
+ // ==========================================
47
+
48
+ export class CSSResult {
49
+ readonly cssText: string;
50
+ readonly sheet: CSSStyleSheet | null;
51
+ }
52
+
53
+ export class TemplateResult {
54
+ readonly strings: TemplateStringsArray;
55
+ readonly values: any[];
56
+ }
57
+
58
+ export function html(strings: TemplateStringsArray, ...values: any[]): TemplateResult;
59
+ export function css(strings: TemplateStringsArray, ...values: any[]): CSSResult;
60
+ export function render(result: TemplateResult, container: HTMLElement | ShadowRoot, signal?: AbortSignal): void;
61
+
62
+ // ==========================================
63
+ // Elementum Base Class
64
+ // ==========================================
65
+
66
+ export class Elementum extends HTMLElement {
67
+ static shadowRoot: boolean;
68
+ static formAssociated: boolean;
69
+ static styles: CSSResult | CSSResult[] | null;
70
+ static observedAttributes: string[];
71
+
72
+ internals: ElementInternals | null;
73
+ root: HTMLElement | ShadowRoot;
74
+
75
+ get signal(): AbortSignal | undefined;
76
+ get validity(): ValidityState | undefined;
77
+ get validationMessage(): string;
78
+ get willValidate(): boolean;
79
+
80
+ checkValidity(): boolean;
81
+ reportValidity(): boolean;
82
+ setValidity(flags?: Partial<ValidityStateFlags>, message?: string, anchor?: HTMLElement): void;
83
+ setCustomValidity(message?: string): void;
84
+
85
+ connected(): void;
86
+ rendered(): void;
87
+ disconnected(): void;
88
+ attributeChanged(name: string, oldValue: string | null, newValue: string | null): void;
89
+ formReset(): void;
90
+ formDisabled?(disabled: boolean): void;
91
+
92
+ setFormValue(value: File | string | FormData | null): void;
93
+ emit<T = any>(eventName: string, detail?: T, options?: CustomEventInit<T>): boolean;
94
+ render(): TemplateResult | void;
95
+ }
96
+
97
+ // ==========================================
98
+ // Component Primitives
99
+ // ==========================================
100
+
101
+ export class ElButton extends Elementum {
102
+ variant: Signal<'primary' | 'secondary' | 'danger' | 'ghost'>;
103
+ size: Signal<'sm' | 'md' | 'lg'>;
104
+ disabled: Signal<boolean>;
105
+ loading: Signal<boolean>;
106
+ type: Signal<'button' | 'submit' | 'reset'>;
107
+ }
108
+
109
+ export class ElBadge extends Elementum {
110
+ variant: Signal<'default' | 'success' | 'danger'>;
111
+ count: Signal<string | number>;
112
+ }
113
+
114
+ export class ElInput extends Elementum {
115
+ value: Signal<string>;
116
+ placeholder: Signal<string>;
117
+ disabled: Signal<boolean>;
118
+ readonly: Signal<boolean>;
119
+ required: Signal<boolean>;
120
+ pattern: Signal<string>;
121
+ minlength: Signal<number>;
122
+ type: Signal<string>;
123
+ size: Signal<'sm' | 'md' | 'lg'>;
124
+ validate(): boolean;
125
+ }
126
+
127
+ export class ElDropdown extends Elementum {
128
+ isOpen: Signal<boolean>;
129
+ placement: Signal<'bottom-start' | 'bottom-end' | 'top-start' | 'top-end'>;
130
+ open(): void;
131
+ close(): void;
132
+ toggle(): void;
133
+ }
134
+
135
+ export class ElCalendar extends Elementum {
136
+ value: Signal<string>;
137
+ viewYear: Signal<number>;
138
+ viewMonth: Signal<number>;
139
+ selectDate(isoDate: string): void;
140
+ }
141
+
142
+ export class ElDatepicker extends Elementum {
143
+ value: Signal<string>;
144
+ placeholder: Signal<string>;
145
+ disabled: Signal<boolean>;
146
+ required: Signal<boolean>;
147
+ validate(): boolean;
148
+ }
149
+
150
+ export class ElDialog extends Elementum {
151
+ isOpen: Signal<boolean>;
152
+ dialogTitle: Signal<string>;
153
+ showModal(): void;
154
+ close(returnValue?: string): void;
155
+ }
156
+
157
+ export class ElTab extends Elementum {
158
+ label: Signal<string>;
159
+ value: Signal<string>;
160
+ }
161
+
162
+ export class ElTabs extends Elementum {
163
+ activeTab: Signal<string>;
164
+ selectTab(val: string): void;
165
+ }
166
+
167
+ export class ElSelect extends Elementum {
168
+ value: Signal<string>;
169
+ placeholder: Signal<string>;
170
+ disabled: Signal<boolean>;
171
+ required: Signal<boolean>;
172
+ name: Signal<string>;
173
+ validate(): boolean;
174
+ }
175
+
176
+ export class ElSwitch extends Elementum {
177
+ checked: Signal<boolean>;
178
+ disabled: Signal<boolean>;
179
+ required: Signal<boolean>;
180
+ name: Signal<string>;
181
+ value: Signal<string>;
182
+ size: Signal<'sm' | 'md' | 'lg'>;
183
+ toggle(): void;
184
+ validate(): boolean;
185
+ }
186
+
187
+ export class ElTooltip extends Elementum {
188
+ content: Signal<string>;
189
+ placement: Signal<'top' | 'bottom' | 'left' | 'right'>;
190
+ delay: Signal<number>;
191
+ disabled: Signal<boolean>;
192
+ visible: Signal<boolean>;
193
+ show(): void;
194
+ hide(): void;
195
+ }
196
+
197
+ export class ElAccordionItem extends Elementum {
198
+ itemTitle: Signal<string>;
199
+ value: Signal<string>;
200
+ isOpen: Signal<boolean>;
201
+ disabled: Signal<boolean>;
202
+ toggle(): void;
203
+ }
204
+
205
+ export class ElAccordion extends Elementum {
206
+ multiple: Signal<boolean>;
207
+ }
208
+
209
+ export interface TableColumn {
210
+ key: string;
211
+ label?: string;
212
+ sortable?: boolean;
213
+ width?: string;
214
+ }
215
+
216
+ export class ElTable extends Elementum {
217
+ data: Signal<Record<string, any>[]>;
218
+ columns: Signal<TableColumn[]>;
219
+ selectable: Signal<boolean>;
220
+ selected: Signal<number[]>;
221
+ sortKey: Signal<string>;
222
+ sortDirection: Signal<'asc' | 'desc' | ''>;
223
+ sortBy(key: string): void;
224
+ toggleSelectAll(): void;
225
+ toggleRow(index: number): void;
226
+ isRowSelected(index: number): boolean;
227
+ }
228
+
229
+ export class ElThemeSwitch extends Elementum {
230
+ theme: Signal<'light' | 'dark'>;
231
+ toggle(): void;
232
+ setTheme(theme: 'light' | 'dark'): void;
233
+ }
234
+
235
+ export interface ToastItem {
236
+ id: string;
237
+ message: string;
238
+ type: 'info' | 'success' | 'danger' | 'warning';
239
+ duration: number;
240
+ }
241
+
242
+ export interface ToastManager {
243
+ toasts: Signal<ToastItem[]>;
244
+ show(message: string, type?: ToastItem['type'], duration?: number): string;
245
+ info(msg: string, dur?: number): string;
246
+ success(msg: string, dur?: number): string;
247
+ error(msg: string, dur?: number): string;
248
+ warning(msg: string, dur?: number): string;
249
+ dismiss(id: string): void;
250
+ }
251
+
252
+ export const toast: ToastManager;
253
+
254
+ export class ElToaster extends Elementum {}
255
+
256
+ export class ElProgress extends Elementum {
257
+ value: Signal<number>;
258
+ max: Signal<number>;
259
+ variant: Signal<'primary' | 'success' | 'danger'>;
260
+ size: Signal<'sm' | 'md' | 'lg'>;
261
+ indeterminate: Signal<boolean>;
262
+ striped: Signal<boolean>;
263
+ }
264
+
265
+ export class ElSpinner extends Elementum {
266
+ size: Signal<'sm' | 'md' | 'lg'>;
267
+ variant: Signal<'primary' | 'muted' | 'white'>;
268
+ label: Signal<string>;
269
+ }
270
+
271
+ export class ElAvatar extends Elementum {
272
+ src: Signal<string>;
273
+ alt: Signal<string>;
274
+ name: Signal<string>;
275
+ size: Signal<'sm' | 'md' | 'lg'>;
276
+ shape: Signal<'circle' | 'square'>;
277
+ status: Signal<'online' | 'offline' | 'busy' | 'away' | ''>;
278
+ }
279
+
280
+ export class ElAvatarGroup extends Elementum {}
281
+
282
+ export class ElDrawer extends Elementum {
283
+ isOpen: Signal<boolean>;
284
+ placement: Signal<'left' | 'right' | 'top' | 'bottom'>;
285
+ titleText: Signal<string>;
286
+ show(): void;
287
+ close(): void;
288
+ }
289
+
290
+ export class ElSegmentedControl extends Elementum {
291
+ value: Signal<string>;
292
+ disabled: Signal<boolean>;
293
+ size: Signal<'sm' | 'md' | 'lg'>;
294
+ name: Signal<string>;
295
+ selectOption(val: string): void;
296
+ }
297
+
298
+ export class ElPagination extends Elementum {
299
+ page: Signal<number>;
300
+ total: Signal<number>;
301
+ pageSize: Signal<number>;
302
+ siblingCount: Signal<number>;
303
+ totalPages: Computed<number>;
304
+ setPage(p: number): void;
305
+ next(): void;
306
+ prev(): void;
307
+ }
308
+
309
+ export class ElChip extends Elementum {
310
+ variant: Signal<'primary' | 'success' | 'danger' | 'warning' | 'muted'>;
311
+ size: Signal<'sm' | 'md'>;
312
+ removable: Signal<boolean>;
313
+ selectable: Signal<boolean>;
314
+ selected: Signal<boolean>;
315
+ value: Signal<string>;
316
+ disabled: Signal<boolean>;
317
+ toggleSelected(): void;
318
+ }
319
+
320
+ export class ElAutocomplete extends Elementum {
321
+ name: Signal<string>;
322
+ value: Signal<string | number | any[]>;
323
+ displayLabel: Signal<string>;
324
+ placeholder: Signal<string>;
325
+ disabled: Signal<boolean>;
326
+ required: Signal<boolean>;
327
+ multiple: Signal<boolean>;
328
+ url: Signal<string>;
329
+ queryParam: Signal<string>;
330
+ debounce: Signal<number>;
331
+ minChars: Signal<number>;
332
+ labelKey: Signal<string>;
333
+ valueKey: Signal<string>;
334
+ size: Signal<'sm' | 'md' | 'lg'>;
335
+ data: Signal<any[]>;
336
+ suggestions: Signal<any[]>;
337
+ isOpen: Signal<boolean>;
338
+ isLoading: Signal<boolean>;
339
+ activeIndex: Signal<number>;
340
+ selectedItem: Signal<any>;
341
+ selectedItems: Signal<any[]>;
342
+ setData(items: any[]): void;
343
+ search(query: string): Promise<void>;
344
+ select(item: any): void;
345
+ removeItem(index: number): void;
346
+ clear(): void;
347
+ open(): void;
348
+ close(): void;
349
+ checkValidity(): boolean;
350
+ reportValidity(): boolean;
351
+ }
352
+
353
+ export class ElNumberFlow extends Elementum {
354
+ value: Signal<number | string>;
355
+ format: Signal<string>;
356
+ prefix: Signal<string>;
357
+ suffix: Signal<string>;
358
+ animated: Signal<boolean>;
359
+ }
360
+
361
+ export class ElOtpInput extends Elementum {
362
+ length: Signal<number>;
363
+ value: Signal<string>;
364
+ type: Signal<'text' | 'password'>;
365
+ disabled: Signal<boolean>;
366
+ required: Signal<boolean>;
367
+ autofocus: Signal<boolean>;
368
+ focus(): void;
369
+ blur(): void;
370
+ clear(): void;
371
+ }
372
+
373
+ export class ElCommand extends Elementum {
374
+ open: Signal<boolean>;
375
+ query: Signal<string>;
376
+ placeholder: Signal<string>;
377
+ shortcut: Signal<string>;
378
+ toggle(): void;
379
+ show(): void;
380
+ close(): void;
381
+ }
382
+
383
+ export class ElCommandGroup extends Elementum {
384
+ heading: Signal<string>;
385
+ }
386
+
387
+ export class ElCommandItem extends Elementum {
388
+ value: Signal<string>;
389
+ shortcut: Signal<string>;
390
+ disabled: Signal<boolean>;
391
+ active: Signal<boolean>;
392
+ }
393
+
394
+ export class ElPromptInput extends Elementum {
395
+ value: Signal<string>;
396
+ placeholder: Signal<string>;
397
+ disabled: Signal<boolean>;
398
+ loading: Signal<boolean>;
399
+ maxRows: Signal<number>;
400
+ minRows: Signal<number>;
401
+ clearOnSubmit: Signal<boolean>;
402
+ submit(): void;
403
+ focus(): void;
404
+ blur(): void;
405
+ }
406
+
407
+ export class ElReasoningCard extends Elementum {
408
+ open: Signal<boolean>;
409
+ thinking: Signal<boolean>;
410
+ duration: Signal<string>;
411
+ summary: Signal<string>;
412
+ toggle(): void;
413
+ }
414
+
415
+ export class ElBorderBeam extends Elementum {
416
+ size: Signal<number>;
417
+ duration: Signal<number>;
418
+ colorFrom: Signal<string>;
419
+ colorTo: Signal<string>;
420
+ borderWidth: Signal<number>;
421
+ reverse: Signal<boolean>;
422
+ }
423
+
424
+ export class ElStreamingText extends Elementum {
425
+ text: Signal<string>;
426
+ displayedText: Signal<string>;
427
+ speed: Signal<number>;
428
+ showCursor: Signal<boolean>;
429
+ isStreaming: Signal<boolean>;
430
+ isComplete: Signal<boolean>;
431
+ start(): void;
432
+ pause(): void;
433
+ resume(): void;
434
+ finish(): void;
435
+ }
436
+
437
+ export class ElChart extends Elementum {
438
+ type: Signal<'area' | 'line' | 'bar'>;
439
+ xKey: Signal<string>;
440
+ yKey: Signal<string>;
441
+ secondaryKey: Signal<string>;
442
+ height: Signal<number>;
443
+ showGrid: Signal<boolean>;
444
+ showDots: Signal<boolean>;
445
+ data: Record<string, any>[];
446
+ }
447
+
448
+ export class ElField extends Elementum {
449
+ label: Signal<string>;
450
+ description: Signal<string>;
451
+ error: Signal<string>;
452
+ required: Signal<boolean>;
453
+ disabled: Signal<boolean>;
454
+ invalid: Signal<boolean>;
455
+ }
456
+
457
+ export class ElNumberField extends Elementum {
458
+ value: Signal<number>;
459
+ min: Signal<number>;
460
+ max: Signal<number>;
461
+ step: Signal<number>;
462
+ precision: Signal<number>;
463
+ scrub: Signal<boolean>;
464
+ disabled: Signal<boolean>;
465
+ required: Signal<boolean>;
466
+ stepUp(multiplier?: number): void;
467
+ stepDown(multiplier?: number): void;
468
+ checkValidity(): boolean;
469
+ reportValidity(): boolean;
470
+ }
471
+
472
+ export class ElSlider extends Elementum {
473
+ value: Signal<number>;
474
+ min: Signal<number>;
475
+ max: Signal<number>;
476
+ step: Signal<number>;
477
+ orientation: Signal<'horizontal' | 'vertical'>;
478
+ disabled: Signal<boolean>;
479
+ }
480
+
481
+ export class ElPopover extends Elementum {
482
+ isOpen: Signal<boolean>;
483
+ placement: Signal<string>;
484
+ offset: Signal<number>;
485
+ hasArrow: Signal<boolean>;
486
+ open(): void;
487
+ close(): void;
488
+ toggle(): void;
489
+ }
490
+
491
+ export class ElCollapsible extends Elementum {
492
+ isOpen: Signal<boolean>;
493
+ disabled: Signal<boolean>;
494
+ open(): void;
495
+ close(): void;
496
+ toggle(): void;
497
+ }
498
+
499
+ export class ElScrollArea extends Elementum {
500
+ type: Signal<'auto' | 'always' | 'hover'>;
501
+ maxHeight: Signal<string>;
502
+ maxWidth: Signal<string>;
503
+ }
504
+
505
+ export class ElToggle extends Elementum {
506
+ isPressed: Signal<boolean>;
507
+ disabled: Signal<boolean>;
508
+ value: Signal<string>;
509
+ size: Signal<string>;
510
+ toggle(): void;
511
+ }
512
+
513
+ export class ElToggleGroup extends Elementum {
514
+ type: Signal<'single' | 'multiple'>;
515
+ value: Signal<string>;
516
+ disabled: Signal<boolean>;
517
+ }
518
+
519
+ export class ElCheckbox extends Elementum {
520
+ checked: Signal<boolean>;
521
+ indeterminate: Signal<boolean>;
522
+ disabled: Signal<boolean>;
523
+ required: Signal<boolean>;
524
+ value: Signal<string>;
525
+ toggle(): void;
526
+ }
527
+
528
+ export class ElRadio extends Elementum {
529
+ value: Signal<string>;
530
+ disabled: Signal<boolean>;
531
+ checked: Signal<boolean>;
532
+ select(): void;
533
+ }
534
+
535
+ export class ElRadioGroup extends Elementum {
536
+ value: Signal<string>;
537
+ disabled: Signal<boolean>;
538
+ required: Signal<boolean>;
539
+ orientation: Signal<string>;
540
+ selectValue(val: string): void;
541
+ }
542
+
543
+ export class ElPreviewCard extends Elementum {
544
+ isOpen: Signal<boolean>;
545
+ openDelay: Signal<number>;
546
+ closeDelay: Signal<number>;
547
+ placement: Signal<string>;
548
+ open(): void;
549
+ close(): void;
550
+ }
551
+
552
+ export class ElAlertDialog extends Elementum {
553
+ isOpen: Signal<boolean>;
554
+ heading: Signal<string>;
555
+ open(): void;
556
+ close(): void;
557
+ showModal(): void;
558
+ }
559
+
560
+ export class ElSeparator extends Elementum {
561
+ orientation: Signal<'horizontal' | 'vertical'>;
562
+ decorative: Signal<boolean>;
563
+ }
564
+
565
+ export class ElMeter extends Elementum {
566
+ value: Signal<number>;
567
+ min: Signal<number>;
568
+ max: Signal<number>;
569
+ low: Signal<number | null>;
570
+ high: Signal<number | null>;
571
+ optimum: Signal<number | null>;
572
+ size: Signal<'sm' | 'md' | 'lg'>;
573
+ }
574
+
575
+ export class ElToolbar extends Elementum {
576
+ orientation: Signal<'horizontal' | 'vertical'>;
577
+ disabled: Signal<boolean>;
578
+ }
579
+
580
+ export class ElContextMenu extends Elementum {
581
+ isOpen: Signal<boolean>;
582
+ disabled: Signal<boolean>;
583
+ open(x?: number, y?: number): void;
584
+ close(): void;
585
+ toggle(x?: number, y?: number): void;
586
+ }
587
+
588
+ export class ElMenubar extends Elementum {
589
+ activeMenu: Signal<HTMLElement | null>;
590
+ disabled: Signal<boolean>;
591
+ openMenu(item: HTMLElement): void;
592
+ closeMenu(): void;
593
+ }
594
+
595
+ export class ElSkeleton extends Elementum {
596
+ variant: Signal<'text' | 'circular' | 'rectangular'>;
597
+ animation: Signal<'pulse' | 'wave' | 'none'>;
598
+ width: Signal<string>;
599
+ height: Signal<string>;
600
+ }
601
+
602
+ export class ElBreadcrumb extends Elementum {
603
+ separator: Signal<string>;
604
+ }
605
+
606
+ export class ElBreadcrumbItem extends Elementum {
607
+ href: Signal<string | null>;
608
+ current: Signal<boolean>;
609
+ }
610
+
611
+ export class ElKbd extends Elementum {
612
+ keys: Signal<string[]>;
613
+ size: Signal<'sm' | 'md' | 'lg'>;
614
+ }
615
+
616
+ export class ElAlert extends Elementum {
617
+ variant: Signal<'default' | 'info' | 'success' | 'warning' | 'destructive'>;
618
+ alertTitle: Signal<string>;
619
+ dismissible: Signal<boolean>;
620
+ isDismissed: Signal<boolean>;
621
+ dismiss(): void;
622
+ }
623
+
624
+ export class ElCard extends Elementum {
625
+ hoverable: Signal<boolean>;
626
+ }
627
+
628
+ export class ElCardHeader extends Elementum {}
629
+ export class ElCardTitle extends Elementum {}
630
+ export class ElCardDescription extends Elementum {}
631
+ export class ElCardContent extends Elementum {}
632
+ export class ElCardFooter extends Elementum {}
633
+
634
+ export class ElAspectRatio extends Elementum {
635
+ ratio: Signal<string>;
636
+ }
637
+
638
+ export class ElTextarea extends Elementum {
639
+ value: Signal<string>;
640
+ placeholder: Signal<string>;
641
+ rows: Signal<number>;
642
+ autoResize: Signal<boolean>;
643
+ disabled: Signal<boolean>;
644
+ required: Signal<boolean>;
645
+ maxlength: Signal<number | null>;
646
+ focus(): void;
647
+ blur(): void;
648
+ }
649
+
650
+ export class ElResizable extends Elementum {
651
+ direction: Signal<'horizontal' | 'vertical'>;
652
+ size: Signal<number>;
653
+ min: Signal<number>;
654
+ max: Signal<number>;
655
+ disabled: Signal<boolean>;
656
+ setSize(val: number): void;
657
+ }
658
+
659
+ export class ElCarousel extends Elementum {
660
+ currentIndex: Signal<number>;
661
+ totalSlides: Signal<number>;
662
+ loop: Signal<boolean>;
663
+ autoPlay: Signal<boolean>;
664
+ interval: Signal<number>;
665
+ next(): void;
666
+ prev(): void;
667
+ goTo(index: number): void;
668
+ }
669
+
670
+ export class ElCarouselSlide extends Elementum {}
671
+
672
+ export class ElTimeline extends Elementum {
673
+ orientation: Signal<'vertical' | 'horizontal'>;
674
+ }
675
+
676
+ export class ElTimelineItem extends Elementum {
677
+ status: Signal<'default' | 'active' | 'success' | 'warning' | 'destructive'>;
678
+ date: Signal<string>;
679
+ }
680
+
681
+ export class ElTreeView extends Elementum {}
682
+
683
+ export class ElTreeItem extends Elementum {
684
+ label: Signal<string>;
685
+ expanded: Signal<boolean>;
686
+ selected: Signal<boolean>;
687
+ disabled: Signal<boolean>;
688
+ hasChildren: Signal<boolean>;
689
+ toggle(e?: Event): void;
690
+ select(): void;
691
+ }
692
+
693
+ export class ElEmptyState extends Elementum {
694
+ emptyTitle: Signal<string>;
695
+ description: Signal<string>;
696
+ }
697
+
698
+ export class ElRating extends Elementum {
699
+ value: Signal<number>;
700
+ max: Signal<number>;
701
+ readonly: Signal<boolean>;
702
+ disabled: Signal<boolean>;
703
+ hoverValue: Signal<number>;
704
+ setValue(val: number): void;
705
+ }
706
+
707
+ export class ElDropzone extends Elementum {
708
+ accept: Signal<string>;
709
+ maxSize: Signal<number | null>;
710
+ multiple: Signal<boolean>;
711
+ disabled: Signal<boolean>;
712
+ isDragOver: Signal<boolean>;
713
+ selectedFiles: Signal<File[]>;
714
+ openFileDialog(): void;
715
+ }
716
+
717
+ export class ElSidebar extends Elementum {
718
+ collapsed: Signal<boolean>;
719
+ collapsible: Signal<'offcanvas' | 'icon' | 'none'>;
720
+ side: Signal<'left' | 'right'>;
721
+ toggle(): void;
722
+ collapse(): void;
723
+ expand(): void;
724
+ }
725
+
726
+ export class ElSidebarHeader extends Elementum {}
727
+ export class ElSidebarContent extends Elementum {}
728
+ export class ElSidebarFooter extends Elementum {}
729
+ export class ElSidebarTrigger extends Elementum {}
730
+
731
+ export class ElForm extends Elementum {
732
+ validate(): boolean;
733
+ getData(): Record<string, any>;
734
+ reset(): void;
735
+ }
736
+
737
+ export class ElFieldset extends Elementum {
738
+ legend: Signal<string>;
739
+ disabled: Signal<boolean>;
740
+ }
741
+
742
+ export class ElCallout extends Elementum {}
743
+ export class ElCheckboxCard extends Elementum {}
744
+ export class ElCodeBlock extends Elementum {}
745
+ export class ElDataList extends Elementum {}
746
+ export class ElDataListItem extends Elementum {}
747
+ export class ElDiffViewer extends Elementum {}
748
+ export class ElInset extends Elementum {}
749
+ export class ElInsightCard extends Elementum {}
750
+ export class ElNavbar extends Elementum {}
751
+ export class ElNavigationMenu extends Elementum {}
752
+ export class ElNavigationMenuItem extends Elementum {}
753
+ export class ElNavigationMenuTrigger extends Elementum {}
754
+ export class ElNavigationMenuContent extends Elementum {}
755
+ export class ElRadioCard extends Elementum {}
756
+ export class ElRadioCardGroup extends Elementum {}
757
+ export class ElResizableHandle extends Elementum {}
758
+ export class ElResizablePanel extends Elementum {}
759
+ export class ElRoute extends Elementum {}
760
+ export class ElRouteLink extends Elementum {}
761
+ export class ElRouter extends Elementum {}
762
+ export class ElSources extends Elementum {}
763
+ export class ElTaskList extends Elementum {}
764
+ export class ElToolCall extends Elementum {}
765
+ export class ElVisuallyHidden extends Elementum {}
766
+
767
+ // ==========================================
768
+ // SSR (Declarative Shadow DOM)
769
+ // ==========================================
770
+
771
+ export function renderTemplateToString(templateResult: TemplateResult | any): string;
772
+ export function renderComponentToDSD(
773
+ tagName: string,
774
+ ComponentClass: any,
775
+ attributes?: Record<string, any>,
776
+ lightDOMChildren?: string
777
+ ): string;
778
+
779
+ // ==========================================
780
+ // AG-UI Protocol Adapter
781
+ // ==========================================
782
+
783
+ export function getByPointer(obj: any, pointer: string): any;
784
+ export function applyJsonPatch<T = any>(target: T, patch?: Array<{ op: 'add' | 'replace' | 'remove'; path: string; value?: any }>): T;
785
+ export function createAgUiStore<T extends Record<string, any> = Record<string, any>>(initialState?: T): {
786
+ state: Signal<T>;
787
+ status: Signal<'idle' | 'running' | 'finished' | 'error'>;
788
+ runId: Signal<string>;
789
+ stepName: Signal<string>;
790
+ thinking: Signal<boolean>;
791
+ thinkingText: Signal<string>;
792
+ currentText: Signal<string>;
793
+ messages: Signal<any[]>;
794
+ toolCalls: Signal<any[]>;
795
+ error: Signal<string | null>;
796
+ events: Signal<any[]>;
797
+ dispatch: (event: any) => void;
798
+ pathSignal: <V = any>(pointer: string, fallback?: V) => Signal<V>;
799
+ onEvent: (listener: (event: any) => void) => () => void;
800
+ bindComponents: (bindings?: Record<string, any>) => () => void;
801
+ connectSSE: (source: Response | ReadableStream | AsyncIterable<any>) => Promise<void>;
802
+ };
803
+
804
+ // ==========================================
805
+ // Behavior Controllers (React-Aria-Inspired)
806
+ // ==========================================
807
+
808
+ export function setHostState(host: Element, name: string, active: boolean): void;
809
+ export function isRTL(el?: Element | null): boolean;
810
+ export function formatLocaleNumber(value: number | string, locale?: string, options?: Intl.NumberFormatOptions): string;
811
+ export function formatLocaleDate(date: Date | number | string, locale?: string, options?: Intl.DateTimeFormatOptions): string;
812
+ export function announce(message: string, politeness?: 'polite' | 'assertive'): void;
813
+ export function clearAnnouncer(): void;
814
+ export function createPressBehavior(
815
+ host: Element,
816
+ target?: EventTarget,
817
+ options?: { isDisabled?: () => boolean; onPress?: (e: Event) => void; signal?: AbortSignal }
818
+ ): () => void;
819
+ export function createRovingFocus(
820
+ host: Element,
821
+ options?: {
822
+ getItems: () => HTMLElement[];
823
+ orientation?: 'horizontal' | 'vertical' | 'both' | (() => 'horizontal' | 'vertical' | 'both');
824
+ loop?: boolean;
825
+ typeahead?: boolean;
826
+ onFocusItem?: (el: HTMLElement, index: number) => void;
827
+ signal?: AbortSignal;
828
+ }
829
+ ): () => void;
830
+ export function createDismissableLayer(
831
+ host: Element,
832
+ options?: {
833
+ isOpen?: () => boolean;
834
+ onDismiss: (reason: 'escape' | 'outside-click', event: Event) => void;
835
+ closeOnEscape?: boolean;
836
+ closeOnOutsideClick?: boolean;
837
+ signal?: AbortSignal;
838
+ }
839
+ ): () => void;
840
+ export function createSelectionBehavior<K = string>(options?: {
841
+ mode?: 'single' | 'multiple' | 'none';
842
+ getKeys?: () => K[];
843
+ initialKeys?: K[];
844
+ disabledKeys?: K[];
845
+ onSelectionChange?: (selected: Set<K>) => void;
846
+ }): {
847
+ selectedKeys: Signal<Set<K>>;
848
+ isSelected: (key: K) => boolean;
849
+ select: (key: K, opts?: { shiftKey?: boolean; ctrlKey?: boolean; metaKey?: boolean; toggle?: boolean }) => void;
850
+ toggle: (key: K) => void;
851
+ selectRange: (fromKey: K, toKey: K) => void;
852
+ selectAll: () => void;
853
+ clear: () => void;
854
+ };
855
+ export function createReorderBehavior(
856
+ host: Element,
857
+ options: {
858
+ getItems: () => HTMLElement[];
859
+ orientation?: 'vertical' | 'horizontal';
860
+ onReorder: (detail: { fromIndex: number; toIndex: number; item: HTMLElement }) => void;
861
+ signal?: AbortSignal;
862
+ }
863
+ ): () => void;
864
+
865
+ // ==========================================
866
+ // DOM & JSX Global Typings
867
+ // ==========================================
868
+
869
+ declare global {
870
+ interface HTMLElementTagNameMap {
871
+ 'el-button': ElButton;
872
+ 'el-badge': ElBadge;
873
+ 'el-input': ElInput;
874
+ 'el-dropdown': ElDropdown;
875
+ 'el-calendar': ElCalendar;
876
+ 'el-datepicker': ElDatepicker;
877
+ 'el-dialog': ElDialog;
878
+ 'el-tabs': ElTabs;
879
+ 'el-tab': ElTab;
880
+ 'el-select': ElSelect;
881
+ 'el-switch': ElSwitch;
882
+ 'el-tooltip': ElTooltip;
883
+ 'el-accordion': ElAccordion;
884
+ 'el-accordion-item': ElAccordionItem;
885
+ 'el-table': ElTable;
886
+ 'el-theme-switch': ElThemeSwitch;
887
+ 'el-toaster': ElToaster;
888
+ 'el-progress': ElProgress;
889
+ 'el-spinner': ElSpinner;
890
+ 'el-avatar': ElAvatar;
891
+ 'el-avatar-group': ElAvatarGroup;
892
+ 'el-drawer': ElDrawer;
893
+ 'el-segmented-control': ElSegmentedControl;
894
+ 'el-pagination': ElPagination;
895
+ 'el-chip': ElChip;
896
+ 'el-autocomplete': ElAutocomplete;
897
+ 'el-number-flow': ElNumberFlow;
898
+ 'el-otp-input': ElOtpInput;
899
+ 'el-command': ElCommand;
900
+ 'el-command-group': ElCommandGroup;
901
+ 'el-command-item': ElCommandItem;
902
+ 'el-prompt-input': ElPromptInput;
903
+ 'el-reasoning-card': ElReasoningCard;
904
+ 'el-border-beam': ElBorderBeam;
905
+ 'el-streaming-text': ElStreamingText;
906
+ 'el-chart': ElChart;
907
+ 'el-field': ElField;
908
+ 'el-number-field': ElNumberField;
909
+ 'el-slider': ElSlider;
910
+ 'el-popover': ElPopover;
911
+ 'el-collapsible': ElCollapsible;
912
+ 'el-scroll-area': ElScrollArea;
913
+ 'el-toggle': ElToggle;
914
+ 'el-toggle-group': ElToggleGroup;
915
+ 'el-checkbox': ElCheckbox;
916
+ 'el-radio': ElRadio;
917
+ 'el-radio-group': ElRadioGroup;
918
+ 'el-preview-card': ElPreviewCard;
919
+ 'el-alert-dialog': ElAlertDialog;
920
+ 'el-separator': ElSeparator;
921
+ 'el-meter': ElMeter;
922
+ 'el-toolbar': ElToolbar;
923
+ 'el-context-menu': ElContextMenu;
924
+ 'el-menubar': ElMenubar;
925
+ 'el-skeleton': ElSkeleton;
926
+ 'el-breadcrumb': ElBreadcrumb;
927
+ 'el-breadcrumb-item': ElBreadcrumbItem;
928
+ 'el-kbd': ElKbd;
929
+ 'el-alert': ElAlert;
930
+ 'el-card': ElCard;
931
+ 'el-card-header': ElCardHeader;
932
+ 'el-card-title': ElCardTitle;
933
+ 'el-card-description': ElCardDescription;
934
+ 'el-card-content': ElCardContent;
935
+ 'el-card-footer': ElCardFooter;
936
+ 'el-aspect-ratio': ElAspectRatio;
937
+ 'el-textarea': ElTextarea;
938
+ 'el-resizable': ElResizable;
939
+ 'el-carousel': ElCarousel;
940
+ 'el-carousel-slide': ElCarouselSlide;
941
+ 'el-timeline': ElTimeline;
942
+ 'el-timeline-item': ElTimelineItem;
943
+ 'el-tree-view': ElTreeView;
944
+ 'el-tree-item': ElTreeItem;
945
+ 'el-empty-state': ElEmptyState;
946
+ 'el-rating': ElRating;
947
+ 'el-dropzone': ElDropzone;
948
+ 'el-sidebar': ElSidebar;
949
+ 'el-sidebar-header': ElSidebarHeader;
950
+ 'el-sidebar-content': ElSidebarContent;
951
+ 'el-sidebar-footer': ElSidebarFooter;
952
+ 'el-sidebar-trigger': ElSidebarTrigger;
953
+ 'el-form': ElForm;
954
+ 'el-fieldset': ElFieldset;
955
+ 'el-callout': ElCallout;
956
+ 'el-checkbox-card': ElCheckboxCard;
957
+ 'el-code-block': ElCodeBlock;
958
+ 'el-data-list': ElDataList;
959
+ 'el-data-list-item': ElDataListItem;
960
+ 'el-diff-viewer': ElDiffViewer;
961
+ 'el-inset': ElInset;
962
+ 'el-insight-card': ElInsightCard;
963
+ 'el-navbar': ElNavbar;
964
+ 'el-navigation-menu': ElNavigationMenu;
965
+ 'el-navigation-menu-item': ElNavigationMenuItem;
966
+ 'el-navigation-menu-trigger': ElNavigationMenuTrigger;
967
+ 'el-navigation-menu-content': ElNavigationMenuContent;
968
+ 'el-radio-card': ElRadioCard;
969
+ 'el-radio-card-group': ElRadioCardGroup;
970
+ 'el-resizable-handle': ElResizableHandle;
971
+ 'el-resizable-panel': ElResizablePanel;
972
+ 'el-route': ElRoute;
973
+ 'el-route-link': ElRouteLink;
974
+ 'el-router': ElRouter;
975
+ 'el-sources': ElSources;
976
+ 'el-task-list': ElTaskList;
977
+ 'el-tool-call': ElToolCall;
978
+ 'el-visually-hidden': ElVisuallyHidden;
979
+ }
980
+
981
+ namespace JSX {
982
+ interface IntrinsicElements {
983
+ 'el-button': any;
984
+ 'el-badge': any;
985
+ 'el-input': any;
986
+ 'el-dropdown': any;
987
+ 'el-calendar': any;
988
+ 'el-datepicker': any;
989
+ 'el-dialog': any;
990
+ 'el-tabs': any;
991
+ 'el-tab': any;
992
+ 'el-select': any;
993
+ 'el-switch': any;
994
+ 'el-tooltip': any;
995
+ 'el-accordion': any;
996
+ 'el-accordion-item': any;
997
+ 'el-table': any;
998
+ 'el-theme-switch': any;
999
+ 'el-toaster': any;
1000
+ 'el-progress': any;
1001
+ 'el-spinner': any;
1002
+ 'el-avatar': any;
1003
+ 'el-avatar-group': any;
1004
+ 'el-drawer': any;
1005
+ 'el-segmented-control': any;
1006
+ 'el-pagination': any;
1007
+ 'el-chip': any;
1008
+ 'el-autocomplete': any;
1009
+ 'el-number-flow': any;
1010
+ 'el-otp-input': any;
1011
+ 'el-command': any;
1012
+ 'el-command-group': any;
1013
+ 'el-command-item': any;
1014
+ 'el-prompt-input': any;
1015
+ 'el-reasoning-card': any;
1016
+ 'el-border-beam': any;
1017
+ 'el-streaming-text': any;
1018
+ 'el-chart': any;
1019
+ 'el-field': any;
1020
+ 'el-number-field': any;
1021
+ 'el-slider': any;
1022
+ 'el-popover': any;
1023
+ 'el-collapsible': any;
1024
+ 'el-scroll-area': any;
1025
+ 'el-toggle': any;
1026
+ 'el-toggle-group': any;
1027
+ 'el-checkbox': any;
1028
+ 'el-radio': any;
1029
+ 'el-radio-group': any;
1030
+ 'el-preview-card': any;
1031
+ 'el-alert-dialog': any;
1032
+ 'el-separator': any;
1033
+ 'el-meter': any;
1034
+ 'el-toolbar': any;
1035
+ 'el-context-menu': any;
1036
+ 'el-menubar': any;
1037
+ 'el-skeleton': any;
1038
+ 'el-breadcrumb': any;
1039
+ 'el-breadcrumb-item': any;
1040
+ 'el-kbd': any;
1041
+ 'el-alert': any;
1042
+ 'el-card': any;
1043
+ 'el-card-header': any;
1044
+ 'el-card-title': any;
1045
+ 'el-card-description': any;
1046
+ 'el-card-content': any;
1047
+ 'el-card-footer': any;
1048
+ 'el-aspect-ratio': any;
1049
+ 'el-textarea': any;
1050
+ 'el-resizable': any;
1051
+ 'el-carousel': any;
1052
+ 'el-carousel-slide': any;
1053
+ 'el-timeline': any;
1054
+ 'el-timeline-item': any;
1055
+ 'el-tree-view': any;
1056
+ 'el-tree-item': any;
1057
+ 'el-empty-state': any;
1058
+ 'el-rating': any;
1059
+ 'el-dropzone': any;
1060
+ 'el-sidebar': any;
1061
+ 'el-sidebar-header': any;
1062
+ 'el-sidebar-content': any;
1063
+ 'el-sidebar-footer': any;
1064
+ 'el-sidebar-trigger': any;
1065
+ 'el-form': any;
1066
+ 'el-fieldset': any;
1067
+ 'el-callout': any;
1068
+ 'el-checkbox-card': any;
1069
+ 'el-code-block': any;
1070
+ 'el-data-list': any;
1071
+ 'el-data-list-item': any;
1072
+ 'el-diff-viewer': any;
1073
+ 'el-inset': any;
1074
+ 'el-insight-card': any;
1075
+ 'el-navbar': any;
1076
+ 'el-navigation-menu': any;
1077
+ 'el-navigation-menu-item': any;
1078
+ 'el-navigation-menu-trigger': any;
1079
+ 'el-navigation-menu-content': any;
1080
+ 'el-radio-card': any;
1081
+ 'el-radio-card-group': any;
1082
+ 'el-resizable-handle': any;
1083
+ 'el-resizable-panel': any;
1084
+ 'el-route': any;
1085
+ 'el-route-link': any;
1086
+ 'el-router': any;
1087
+ 'el-sources': any;
1088
+ 'el-task-list': any;
1089
+ 'el-tool-call': any;
1090
+ 'el-visually-hidden': any;
1091
+ }
1092
+ }
1093
+ }