@adia-ai/web-components 0.4.5 → 0.4.7

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 (316) hide show
  1. package/README.md +63 -24
  2. package/USAGE.md +604 -0
  3. package/components/accordion/accordion.d.ts +17 -0
  4. package/components/accordion/accordion.js +10 -117
  5. package/components/accordion/class.js +132 -0
  6. package/components/action-list/action-list.d.ts +15 -0
  7. package/components/action-list/action-list.js +9 -140
  8. package/components/action-list/class.js +156 -0
  9. package/components/agent-artifact/agent-artifact.d.ts +25 -0
  10. package/components/agent-artifact/agent-artifact.js +8 -181
  11. package/components/agent-artifact/class.js +200 -0
  12. package/components/agent-feedback-bar/agent-feedback-bar.d.ts +21 -0
  13. package/components/agent-feedback-bar/agent-feedback-bar.js +8 -143
  14. package/components/agent-feedback-bar/class.js +162 -0
  15. package/components/agent-questions/agent-questions.d.ts +23 -0
  16. package/components/agent-questions/agent-questions.js +8 -180
  17. package/components/agent-questions/class.js +199 -0
  18. package/components/agent-reasoning/agent-reasoning.d.ts +23 -0
  19. package/components/agent-reasoning/agent-reasoning.js +8 -494
  20. package/components/agent-reasoning/class.js +513 -0
  21. package/components/agent-suggestions/agent-suggestions.d.ts +21 -0
  22. package/components/agent-suggestions/agent-suggestions.js +8 -78
  23. package/components/agent-suggestions/class.js +97 -0
  24. package/components/agent-trace/agent-trace.d.ts +19 -0
  25. package/components/alert/alert.d.ts +29 -0
  26. package/components/alert/alert.js +8 -175
  27. package/components/alert/class.js +194 -0
  28. package/components/avatar/avatar.d.ts +27 -0
  29. package/components/avatar/avatar.js +9 -159
  30. package/components/avatar/class.js +173 -0
  31. package/components/badge/badge.d.ts +27 -0
  32. package/components/badge/badge.js +9 -75
  33. package/components/badge/class.js +93 -0
  34. package/components/block/block.d.ts +19 -0
  35. package/components/block/block.js +9 -15
  36. package/components/block/class.js +33 -0
  37. package/components/breadcrumb/breadcrumb.d.ts +23 -0
  38. package/components/breadcrumb/breadcrumb.js +8 -113
  39. package/components/breadcrumb/class.js +132 -0
  40. package/components/button/button.d.ts +34 -0
  41. package/components/button/button.js +15 -66
  42. package/components/button/class.js +80 -0
  43. package/components/calendar-picker/calendar-picker.a2ui.json +6 -1
  44. package/components/calendar-picker/calendar-picker.d.ts +27 -0
  45. package/components/calendar-picker/calendar-picker.js +8 -332
  46. package/components/calendar-picker/calendar-picker.yaml +51 -177
  47. package/components/calendar-picker/class.js +351 -0
  48. package/components/canvas/canvas.a2ui.json +6 -1
  49. package/components/canvas/canvas.d.ts +17 -0
  50. package/components/canvas/canvas.yaml +19 -36
  51. package/components/card/card.a2ui.json +3 -0
  52. package/components/card/card.d.ts +27 -0
  53. package/components/card/card.js +9 -50
  54. package/components/card/card.yaml +171 -433
  55. package/components/card/class.js +68 -0
  56. package/components/chart/chart.d.ts +41 -0
  57. package/components/chart/chart.js +8 -2131
  58. package/components/chart/class.js +2150 -0
  59. package/components/chart-legend/chart-legend.d.ts +27 -0
  60. package/components/chart-legend/chart-legend.js +8 -197
  61. package/components/chart-legend/class.js +215 -0
  62. package/components/chat-thread/chat-thread.d.ts +17 -0
  63. package/components/chat-thread/chat-thread.js +8 -157
  64. package/components/chat-thread/class.js +176 -0
  65. package/components/check/check.d.ts +30 -0
  66. package/components/check/check.js +11 -52
  67. package/components/check/class.js +68 -0
  68. package/components/code/class.js +501 -0
  69. package/components/code/code.d.ts +39 -0
  70. package/components/code/code.js +8 -482
  71. package/components/col/class.js +30 -0
  72. package/components/col/col.d.ts +23 -0
  73. package/components/col/col.js +10 -13
  74. package/components/color-picker/class.js +550 -0
  75. package/components/color-picker/color-picker.d.ts +37 -0
  76. package/components/color-picker/color-picker.js +8 -531
  77. package/components/command/class.js +364 -0
  78. package/components/command/command.a2ui.json +3 -0
  79. package/components/command/command.d.ts +19 -0
  80. package/components/command/command.js +8 -345
  81. package/components/command/command.yaml +105 -124
  82. package/components/demo-toggle/class.js +153 -0
  83. package/components/demo-toggle/demo-toggle.d.ts +23 -0
  84. package/components/demo-toggle/demo-toggle.js +8 -135
  85. package/components/description-list/class.js +86 -0
  86. package/components/description-list/description-list.d.ts +21 -0
  87. package/components/description-list/description-list.js +8 -67
  88. package/components/divider/class.js +57 -0
  89. package/components/divider/divider.d.ts +19 -0
  90. package/components/divider/divider.js +10 -40
  91. package/components/drawer/class.js +306 -0
  92. package/components/drawer/drawer.d.ts +25 -0
  93. package/components/drawer/drawer.js +8 -287
  94. package/components/embed/class.js +73 -0
  95. package/components/embed/embed.d.ts +23 -0
  96. package/components/embed/embed.js +9 -55
  97. package/components/empty-state/class.js +108 -0
  98. package/components/empty-state/empty-state.d.ts +21 -0
  99. package/components/empty-state/empty-state.js +9 -90
  100. package/components/feed/class.js +381 -0
  101. package/components/feed/feed.d.ts +19 -0
  102. package/components/feed/feed.js +9 -367
  103. package/components/field/class.js +266 -0
  104. package/components/field/field.d.ts +23 -0
  105. package/components/field/field.js +8 -247
  106. package/components/fields/class.js +106 -0
  107. package/components/fields/fields.d.ts +19 -0
  108. package/components/fields/fields.js +8 -87
  109. package/components/grid/class.js +31 -0
  110. package/components/grid/grid.d.ts +23 -0
  111. package/components/grid/grid.js +10 -14
  112. package/components/heatmap/class.js +305 -0
  113. package/components/heatmap/heatmap.d.ts +31 -0
  114. package/components/heatmap/heatmap.js +8 -286
  115. package/components/icon/class.js +54 -0
  116. package/components/icon/icon.d.ts +23 -0
  117. package/components/icon/icon.js +13 -40
  118. package/components/image/class.js +112 -0
  119. package/components/image/image.d.ts +33 -0
  120. package/components/image/image.js +9 -94
  121. package/components/index.js +1 -0
  122. package/components/input/class.js +773 -0
  123. package/components/input/input.a2ui.json +3 -0
  124. package/components/input/input.d.ts +61 -0
  125. package/components/input/input.js +8 -755
  126. package/components/input/input.yaml +171 -442
  127. package/components/inspector/class.js +142 -0
  128. package/components/inspector/inspector.a2ui.json +8 -1
  129. package/components/inspector/inspector.d.ts +17 -0
  130. package/components/inspector/inspector.js +8 -124
  131. package/components/inspector/inspector.yaml +15 -30
  132. package/components/kbd/class.js +34 -0
  133. package/components/kbd/kbd.a2ui.json +3 -0
  134. package/components/kbd/kbd.d.ts +17 -0
  135. package/components/kbd/kbd.js +10 -17
  136. package/components/kbd/kbd.yaml +54 -185
  137. package/components/link/class.js +187 -0
  138. package/components/link/link.d.ts +55 -0
  139. package/components/link/link.js +8 -168
  140. package/components/list/class.js +249 -0
  141. package/components/list/list.d.ts +23 -0
  142. package/components/list/list.js +9 -231
  143. package/components/menu/class.js +332 -0
  144. package/components/menu/menu.d.ts +21 -0
  145. package/components/menu/menu.js +11 -316
  146. package/components/modal/class.js +231 -0
  147. package/components/modal/modal.a2ui.json +5 -1
  148. package/components/modal/modal.d.ts +23 -0
  149. package/components/modal/modal.js +8 -212
  150. package/components/modal/modal.yaml +19 -39
  151. package/components/nav/class.js +150 -0
  152. package/components/nav/nav.d.ts +31 -0
  153. package/components/nav/nav.js +8 -131
  154. package/components/nav-group/class.js +152 -0
  155. package/components/nav-group/nav-group.d.ts +35 -0
  156. package/components/nav-group/nav-group.js +9 -134
  157. package/components/nav-item/class.js +86 -0
  158. package/components/nav-item/nav-item.d.ts +37 -0
  159. package/components/nav-item/nav-item.js +10 -69
  160. package/components/noodles/class.js +510 -0
  161. package/components/noodles/noodles.d.ts +33 -0
  162. package/components/noodles/noodles.js +9 -493
  163. package/components/option-card/class.js +167 -0
  164. package/components/option-card/option-card.d.ts +30 -0
  165. package/components/option-card/option-card.js +8 -149
  166. package/components/otp-input/class.js +180 -0
  167. package/components/otp-input/otp-input.a2ui.json +5 -1
  168. package/components/otp-input/otp-input.d.ts +25 -0
  169. package/components/otp-input/otp-input.js +9 -162
  170. package/components/otp-input/otp-input.yaml +45 -174
  171. package/components/page/class.js +97 -0
  172. package/components/page/page.d.ts +46 -0
  173. package/components/page/page.js +8 -79
  174. package/components/pagination/class.js +195 -0
  175. package/components/pagination/pagination.d.ts +23 -0
  176. package/components/pagination/pagination.js +9 -177
  177. package/components/pane/class.js +186 -0
  178. package/components/pane/pane.a2ui.json +12 -1
  179. package/components/pane/pane.css +10 -0
  180. package/components/pane/pane.d.ts +31 -0
  181. package/components/pane/pane.js +8 -143
  182. package/components/pane/pane.yaml +57 -157
  183. package/components/pipeline-status/class.js +189 -0
  184. package/components/pipeline-status/pipeline-status.a2ui.json +7 -1
  185. package/components/pipeline-status/pipeline-status.d.ts +21 -0
  186. package/components/pipeline-status/pipeline-status.js +9 -172
  187. package/components/pipeline-status/pipeline-status.yaml +34 -72
  188. package/components/popover/class.js +194 -0
  189. package/components/popover/popover.d.ts +23 -0
  190. package/components/popover/popover.js +9 -176
  191. package/components/progress/class.js +74 -0
  192. package/components/progress/progress.a2ui.json +3 -0
  193. package/components/progress/progress.d.ts +19 -0
  194. package/components/progress/progress.js +10 -57
  195. package/components/progress/progress.yaml +124 -287
  196. package/components/progress-row/class.js +110 -0
  197. package/components/progress-row/progress-row.d.ts +23 -0
  198. package/components/progress-row/progress-row.js +8 -92
  199. package/components/radio/class.js +83 -0
  200. package/components/radio/radio.d.ts +28 -0
  201. package/components/radio/radio.js +11 -67
  202. package/components/range/class.js +194 -0
  203. package/components/range/range.d.ts +31 -0
  204. package/components/range/range.js +9 -176
  205. package/components/rating/class.js +148 -0
  206. package/components/rating/rating.d.ts +33 -0
  207. package/components/rating/rating.js +9 -130
  208. package/components/richtext/class.js +87 -0
  209. package/components/richtext/richtext.a2ui.json +7 -1
  210. package/components/richtext/richtext.d.ts +19 -0
  211. package/components/richtext/richtext.js +8 -68
  212. package/components/richtext/richtext.yaml +30 -65
  213. package/components/row/class.js +50 -0
  214. package/components/row/row.d.ts +27 -0
  215. package/components/row/row.js +10 -33
  216. package/components/search/class.js +134 -0
  217. package/components/search/search.d.ts +35 -0
  218. package/components/search/search.js +10 -117
  219. package/components/segment/class.js +62 -0
  220. package/components/segment/segment.d.ts +25 -0
  221. package/components/segment/segment.js +10 -45
  222. package/components/segmented/class.js +165 -0
  223. package/components/segmented/segmented.a2ui.json +4 -0
  224. package/components/segmented/segmented.d.ts +24 -0
  225. package/components/segmented/segmented.js +10 -148
  226. package/components/segmented/segmented.yaml +41 -59
  227. package/components/select/class.js +408 -0
  228. package/components/select/select.d.ts +57 -0
  229. package/components/select/select.js +15 -396
  230. package/components/skeleton/class.js +52 -0
  231. package/components/skeleton/skeleton.d.ts +23 -0
  232. package/components/skeleton/skeleton.js +8 -34
  233. package/components/slider/class.js +184 -0
  234. package/components/slider/slider.d.ts +31 -0
  235. package/components/slider/slider.js +9 -166
  236. package/components/stack/class.js +28 -0
  237. package/components/stack/stack.d.ts +17 -0
  238. package/components/stack/stack.js +10 -11
  239. package/components/step-progress/class.js +98 -0
  240. package/components/step-progress/step-progress.d.ts +27 -0
  241. package/components/step-progress/step-progress.js +8 -79
  242. package/components/stepper/class.js +126 -0
  243. package/components/stepper/stepper.d.ts +19 -0
  244. package/components/stepper/stepper.js +9 -112
  245. package/components/stream/class.js +109 -0
  246. package/components/stream/stream.d.ts +19 -0
  247. package/components/stream/stream.js +8 -90
  248. package/components/swatch/class.js +131 -0
  249. package/components/swatch/swatch.d.ts +28 -0
  250. package/components/swatch/swatch.js +8 -112
  251. package/components/swiper/class.js +373 -0
  252. package/components/swiper/swiper.a2ui.json +4 -0
  253. package/components/swiper/swiper.d.ts +31 -0
  254. package/components/swiper/swiper.js +8 -354
  255. package/components/swiper/swiper.yaml +68 -212
  256. package/components/switch/class.js +63 -0
  257. package/components/switch/switch.a2ui.json +6 -1
  258. package/components/switch/switch.d.ts +30 -0
  259. package/components/switch/switch.js +11 -47
  260. package/components/switch/switch.yaml +70 -265
  261. package/components/table/class.js +1453 -0
  262. package/components/table/table.d.ts +37 -0
  263. package/components/table/table.js +8 -1435
  264. package/components/table-toolbar/class.js +680 -0
  265. package/components/table-toolbar/table-toolbar.d.ts +33 -0
  266. package/components/table-toolbar/table-toolbar.js +8 -689
  267. package/components/tabs/class.js +242 -0
  268. package/components/tabs/tabs.d.ts +21 -0
  269. package/components/tabs/tabs.js +8 -223
  270. package/components/tag/class.js +99 -0
  271. package/components/tag/tag.d.ts +27 -0
  272. package/components/tag/tag.js +8 -80
  273. package/components/text/class.js +46 -0
  274. package/components/text/text.d.ts +25 -0
  275. package/components/text/text.js +9 -28
  276. package/components/textarea/class.js +134 -0
  277. package/components/textarea/textarea.d.ts +31 -0
  278. package/components/textarea/textarea.js +11 -118
  279. package/components/timeline/class.js +176 -0
  280. package/components/timeline/timeline.d.ts +19 -0
  281. package/components/timeline/timeline.js +9 -162
  282. package/components/toast/class.js +92 -0
  283. package/components/toast/toast.d.ts +23 -0
  284. package/components/toast/toast.js +9 -76
  285. package/components/toggle-group/class.js +154 -0
  286. package/components/toggle-group/toggle-group.d.ts +19 -0
  287. package/components/toggle-group/toggle-group.js +11 -140
  288. package/components/toggle-scheme/class.js +286 -0
  289. package/components/toggle-scheme/toggle-scheme.a2ui.json +197 -0
  290. package/components/toggle-scheme/toggle-scheme.css +20 -0
  291. package/components/toggle-scheme/toggle-scheme.d.ts +41 -0
  292. package/components/toggle-scheme/toggle-scheme.js +17 -0
  293. package/components/toggle-scheme/toggle-scheme.yaml +173 -0
  294. package/components/toolbar/class.js +388 -0
  295. package/components/toolbar/toolbar.d.ts +23 -0
  296. package/components/toolbar/toolbar.js +10 -376
  297. package/components/tooltip/class.js +299 -0
  298. package/components/tooltip/tooltip.d.ts +27 -0
  299. package/components/tooltip/tooltip.js +8 -280
  300. package/components/tree/class.js +245 -0
  301. package/components/tree/tree.d.ts +15 -0
  302. package/components/tree/tree.js +9 -244
  303. package/components/upload/class.js +199 -0
  304. package/components/upload/upload.d.ts +27 -0
  305. package/components/upload/upload.js +11 -183
  306. package/core/element.d.ts +174 -0
  307. package/core/form.d.ts +108 -0
  308. package/core/index.d.ts +11 -0
  309. package/core/index.js +1 -0
  310. package/core/register.d.ts +25 -0
  311. package/core/register.js +58 -0
  312. package/core/signals.d.ts +94 -0
  313. package/core/template.d.ts +70 -0
  314. package/index.d.ts +315 -0
  315. package/package.json +25 -6
  316. package/traits/CATEGORIES.md +1 -1
@@ -0,0 +1,27 @@
1
+ /**
2
+ * `<chart-legend-ui>` — Standalone legend primitive for the AdiaUI chart family. Renders a row of badge-ui chips (swatch + label) that are keyboard-focusable and click-toggleable. Composes with chart-ui via [for] id-ref (auto-mirror) or via explicit [items] JSON.
3
+ *
4
+ * @see https://ui-kit.exe.xyz/site/components/chart-legend
5
+ *
6
+ * Type declarations generated by scripts/build/dts-codegen.mjs from
7
+ * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
8
+ * run `npm run components`, then `npm run codegen:dts` to regenerate;
9
+ * or hand-author this file fully if rich event types are needed.
10
+ */
11
+
12
+ import { UIElement } from '../../core/element.js';
13
+
14
+ export class UIChartLegend extends UIElement {
15
+ /** JSON array of {key, label, slot?, pct?} legend items. Takes precedence over [for] when both are provided. */
16
+ items: string;
17
+ /** id-ref of a chart-ui / heatmap-ui to mirror series from. */
18
+ for: string;
19
+ /** Series-toggle mode emitted via the `toggle` event. `hide` removes the series from the render; `opacity` fades it. Wired via [for] on chart-ui. */
20
+ onToggle: 'hide' | 'opacity';
21
+ /** Layout hint — drives flex-direction. Actual placement follows DOM order. */
22
+ position: 'top' | 'bottom' | 'left' | 'right';
23
+ /** Swatch shape. Maps to badge-ui's icon for dot/square variants. */
24
+ shape: 'dot' | 'square' | 'line' | 'dashed';
25
+ /** When set, rows are non-interactive <span>s (no click, no toggle). */
26
+ static: boolean;
27
+ }
@@ -1,206 +1,17 @@
1
1
  /**
2
- * <chart-legend-ui shape="dot" position="bottom" items='[{"key":"revenue","label":"Revenue"},{"key":"users","label":"Users"}]'></chart-legend-ui>
2
+ * `<chart-legend-ui>` auto-registers the tag on import.
3
3
  *
4
- * Standalone legend primitive for the AdiaUI chart family. Renders a row
5
- * of badge-ui chips (swatch + label) that are keyboard-focusable and
6
- * click-toggleable — clicking emits a canonical `toggle` event that
7
- * consumers (or chart-ui via [for]) wire to series visibility.
4
+ * For non-side-effect class import (test isolation, tag override), use
5
+ * the `class` subpath:
8
6
  *
9
- * Attributes:
10
- * for — id-ref of a chart-ui / heatmap-ui to mirror. When set, the
11
- * legend reads series data from that element's `.legendData`
12
- * property and subscribes to its `legend-update` event.
13
- * (Auto-mirror ships behind [for] — explicit items still
14
- * override when both are provided.)
15
- * items — JSON array of {key, label, slot?, pct?} legend items.
16
- * Takes precedence over [for] if both are provided.
17
- * shape — dot | square | line | dashed. Default: dot. The swatch is
18
- * a `[data-swatch]` span inside each badge-ui row, styled by
19
- * the legend's [shape] attr. Custom span (rather than badge-
20
- * ui's [icon] slot) is required because line/dashed shapes
21
- * aren't representable as icon glyphs.
22
- * position — top | bottom | left | right. Layout hint; actual placement
23
- * is where the element is placed in the DOM. Drives
24
- * flex-direction.
25
- * static — when set, rows render as non-interactive badges (no
26
- * role/tabindex/handlers). Default is interactive
27
- * `role="button"` badges that toggle on click + Enter/Space.
28
- * on-toggle — hide | opacity. Default hide. Escape hatch per OD-CHART-09.
29
- * Reported via the `toggle` event detail; chart-ui reads it
30
- * when wired via [for].
7
+ * import { UIChartLegend } from '@adia-ai/web-components/components/chart-legend/class';
31
8
  *
32
- * Events:
33
- * toggle — detail: {key, active, mode}. Fires on row click when
34
- * not [static]. `active` is the new state (true=visible).
9
+ * @see ../../USAGE.md#registration--auto-vs-explicit
35
10
  */
36
11
 
37
- import { UIElement } from '../../core/element.js';
12
+ import { defineIfFree } from '../../core/register.js';
13
+ import { UIChartLegend } from './class.js';
38
14
 
39
- class UIChartLegend extends UIElement {
40
- static properties = {
41
- for: { type: String, default: '', reflect: true },
42
- // Items is a JSON-encoded array; reflecting to the attribute would
43
- // serialize a potentially long array on every change. The property is
44
- // the source of truth; the attribute is intentionally write-only.
45
- items: { type: String, default: '', reflect: false },
46
- shape: { type: String, default: 'dot', reflect: true },
47
- position: { type: String, default: 'bottom', reflect: true },
48
- static: { type: Boolean, default: false, reflect: true },
49
- onToggle: { type: String, default: 'hide', reflect: true, attribute: 'on-toggle' },
50
- };
51
-
52
- static template = () => null;
53
-
54
- #target = null;
55
- #targetListener = null;
56
- #hiddenKeys = new Set();
57
-
58
- connected() {
59
- this.setAttribute('role', 'list');
60
- this.#resolveTarget();
61
- this.#paint();
62
- }
63
-
64
- disconnected() {
65
- this.#detachTarget();
66
- }
67
-
68
- render() {
69
- this.#resolveTarget();
70
- this.#paint();
71
- }
72
-
73
- /* ── Target resolution ──────────────────────────────────────────── */
74
-
75
- #resolveTarget() {
76
- this.#detachTarget();
77
- if (!this.for) return;
78
- const el = this.getRootNode()?.getElementById?.(this.for)
79
- || document.getElementById(this.for);
80
- if (!el) {
81
- // Warn once per (element × id) pair
82
- if (!UIChartLegend._warned) UIChartLegend._warned = new WeakSet();
83
- const marker = { el: this, id: this.for };
84
- if (!UIChartLegend._warned.has(this)) {
85
- console.warn(`[chart-legend-ui] [for="${this.for}"] did not resolve to an element.`);
86
- UIChartLegend._warned.add(this);
87
- }
88
- return;
89
- }
90
- this.#target = el;
91
- this.#targetListener = () => this.#paint();
92
- el.addEventListener('legend-update', this.#targetListener);
93
- }
94
-
95
- #detachTarget() {
96
- if (this.#target && this.#targetListener) {
97
- this.#target.removeEventListener('legend-update', this.#targetListener);
98
- }
99
- this.#target = null;
100
- this.#targetListener = null;
101
- }
102
-
103
- /* ── Item source ────────────────────────────────────────────────── */
104
-
105
- #resolveItems() {
106
- /* Explicit items prop wins. */
107
- if (this.items) {
108
- try {
109
- const parsed = JSON.parse(this.items);
110
- if (Array.isArray(parsed)) return parsed;
111
- } catch (_) { /* fall through */ }
112
- }
113
- /* Mirror from [for] target when present. */
114
- if (this.#target && Array.isArray(this.#target.legendData)) {
115
- return this.#target.legendData;
116
- }
117
- return [];
118
- }
119
-
120
- /* ── Render ─────────────────────────────────────────────────────── */
121
-
122
- #paint() {
123
- const items = this.#resolveItems();
124
- this.innerHTML = '';
125
- if (!items.length) return;
126
-
127
- for (const item of items) {
128
- const key = item.key ?? item.label ?? '';
129
- const label = item.label ?? key;
130
- const slot = item.slot != null ? item.slot : 0;
131
- const active = !this.#hiddenKeys.has(key);
132
-
133
- /* Each row is a <badge-ui> chip — the canonical AdiaUI primitive for
134
- legend pills (per badge.yaml's documented "chart-legend" example).
135
- badge-ui carries the pill chrome (radius, padding, font-size, hover
136
- affordance), the legend layers shape-specific swatch CSS + the
137
- click-to-toggle behavior on top. Interactive rows get
138
- role="button" + tabindex="0" + Enter/Space handlers so they're
139
- keyboard-operable without a wrapping <button>. */
140
- const row = document.createElement('badge-ui');
141
- row.setAttribute('data-row', '');
142
- row.setAttribute('role', this.static ? 'listitem' : 'button');
143
- row.setAttribute('text', label);
144
- if (key) row.setAttribute('data-key', key);
145
- if (active) row.setAttribute('data-active', '');
146
- if (!this.static) {
147
- row.setAttribute('tabindex', '0');
148
- row.setAttribute('aria-pressed', active ? 'true' : 'false');
149
- }
150
-
151
- /* Swatch — composed via `<swatch-ui>` with the legend's [shape] attr
152
- passed through. Pre-2026-05-01 this was a hand-rolled `<span
153
- data-swatch>` plus per-shape CSS in this file; that drift caused
154
- a cascade-leak collision with the docs-shell's `[data-swatch]`
155
- demo rule (token-colors page). Compose the primitive instead and
156
- the swatch's dot / square / line / dashed variants live in one
157
- place. Color resolves via --color-{key} with a --a-data-{slot}
158
- fallback; the legend can render standalone (without a chart-ui
159
- ancestor) so the fallback must reference the global data palette
160
- directly, not chart-ui's scoped --chart-{N} alias. */
161
- const swatchShape = this.shape || 'dot';
162
- const swatch = document.createElement('swatch-ui');
163
- swatch.setAttribute('shape', swatchShape);
164
- swatch.setAttribute('size', 'sm');
165
- const swatchColor = key
166
- ? `var(--color-${key}, var(--a-data-${slot}))`
167
- : `var(--a-data-${slot})`;
168
- swatch.style.setProperty('--swatch-color', swatchColor);
169
- row.appendChild(swatch);
170
-
171
- if (!this.static) {
172
- row.addEventListener('click', (e) => this.#onRowToggle(e, key));
173
- row.addEventListener('keydown', (e) => {
174
- if (e.key === 'Enter' || e.key === ' ') {
175
- e.preventDefault();
176
- this.#onRowToggle(e, key);
177
- }
178
- });
179
- }
180
-
181
- this.appendChild(row);
182
- }
183
- }
184
-
185
- #onRowToggle(e, key) {
186
- if (!key) return;
187
- const currentlyActive = !this.#hiddenKeys.has(key);
188
- const newActive = !currentlyActive;
189
- if (newActive) this.#hiddenKeys.delete(key);
190
- else this.#hiddenKeys.add(key);
191
-
192
- const row = e.currentTarget;
193
- if (newActive) row.setAttribute('data-active', '');
194
- else row.removeAttribute('data-active');
195
- row.setAttribute('aria-pressed', newActive ? 'true' : 'false');
196
-
197
- this.dispatchEvent(new CustomEvent('toggle', {
198
- bubbles: true,
199
- detail: { key, active: newActive, mode: this.onToggle || 'hide' },
200
- }));
201
- }
202
- }
203
-
204
- customElements.define('chart-legend-ui', UIChartLegend);
15
+ defineIfFree('chart-legend-ui', UIChartLegend);
205
16
 
206
17
  export { UIChartLegend };
@@ -0,0 +1,215 @@
1
+ /**
2
+ * Non-side-effect class export for `<chart-legend-ui>`.
3
+ *
4
+ * Importing this file gives you the class(es) without auto-registering the tag.
5
+ * Useful for test isolation, subclassing with tag-name override, or selective
6
+ * composition.
7
+ *
8
+ * The auto-register path stays at `@adia-ai/web-components/components/chart-legend`
9
+ * (which imports this file + calls `defineIfFree()`).
10
+ *
11
+ * @see ../../USAGE.md#registration--auto-vs-explicit
12
+ */
13
+
14
+ /**
15
+ * <chart-legend-ui shape="dot" position="bottom" items='[{"key":"revenue","label":"Revenue"},{"key":"users","label":"Users"}]'></chart-legend-ui>
16
+ *
17
+ * Standalone legend primitive for the AdiaUI chart family. Renders a row
18
+ * of badge-ui chips (swatch + label) that are keyboard-focusable and
19
+ * click-toggleable — clicking emits a canonical `toggle` event that
20
+ * consumers (or chart-ui via [for]) wire to series visibility.
21
+ *
22
+ * Attributes:
23
+ * for — id-ref of a chart-ui / heatmap-ui to mirror. When set, the
24
+ * legend reads series data from that element's `.legendData`
25
+ * property and subscribes to its `legend-update` event.
26
+ * (Auto-mirror ships behind [for] — explicit items still
27
+ * override when both are provided.)
28
+ * items — JSON array of {key, label, slot?, pct?} legend items.
29
+ * Takes precedence over [for] if both are provided.
30
+ * shape — dot | square | line | dashed. Default: dot. The swatch is
31
+ * a `[data-swatch]` span inside each badge-ui row, styled by
32
+ * the legend's [shape] attr. Custom span (rather than badge-
33
+ * ui's [icon] slot) is required because line/dashed shapes
34
+ * aren't representable as icon glyphs.
35
+ * position — top | bottom | left | right. Layout hint; actual placement
36
+ * is where the element is placed in the DOM. Drives
37
+ * flex-direction.
38
+ * static — when set, rows render as non-interactive badges (no
39
+ * role/tabindex/handlers). Default is interactive
40
+ * `role="button"` badges that toggle on click + Enter/Space.
41
+ * on-toggle — hide | opacity. Default hide. Escape hatch per OD-CHART-09.
42
+ * Reported via the `toggle` event detail; chart-ui reads it
43
+ * when wired via [for].
44
+ *
45
+ * Events:
46
+ * toggle — detail: {key, active, mode}. Fires on row click when
47
+ * not [static]. `active` is the new state (true=visible).
48
+ */
49
+
50
+ import { UIElement } from '../../core/element.js';
51
+
52
+ export class UIChartLegend extends UIElement {
53
+ static properties = {
54
+ for: { type: String, default: '', reflect: true },
55
+ // Items is a JSON-encoded array; reflecting to the attribute would
56
+ // serialize a potentially long array on every change. The property is
57
+ // the source of truth; the attribute is intentionally write-only.
58
+ items: { type: String, default: '', reflect: false },
59
+ shape: { type: String, default: 'dot', reflect: true },
60
+ position: { type: String, default: 'bottom', reflect: true },
61
+ static: { type: Boolean, default: false, reflect: true },
62
+ onToggle: { type: String, default: 'hide', reflect: true, attribute: 'on-toggle' },
63
+ };
64
+
65
+ static template = () => null;
66
+
67
+ #target = null;
68
+ #targetListener = null;
69
+ #hiddenKeys = new Set();
70
+
71
+ connected() {
72
+ this.setAttribute('role', 'list');
73
+ this.#resolveTarget();
74
+ this.#paint();
75
+ }
76
+
77
+ disconnected() {
78
+ this.#detachTarget();
79
+ }
80
+
81
+ render() {
82
+ this.#resolveTarget();
83
+ this.#paint();
84
+ }
85
+
86
+ /* ── Target resolution ──────────────────────────────────────────── */
87
+
88
+ #resolveTarget() {
89
+ this.#detachTarget();
90
+ if (!this.for) return;
91
+ const el = this.getRootNode()?.getElementById?.(this.for)
92
+ || document.getElementById(this.for);
93
+ if (!el) {
94
+ // Warn once per (element × id) pair
95
+ if (!UIChartLegend._warned) UIChartLegend._warned = new WeakSet();
96
+ const marker = { el: this, id: this.for };
97
+ if (!UIChartLegend._warned.has(this)) {
98
+ console.warn(`[chart-legend-ui] [for="${this.for}"] did not resolve to an element.`);
99
+ UIChartLegend._warned.add(this);
100
+ }
101
+ return;
102
+ }
103
+ this.#target = el;
104
+ this.#targetListener = () => this.#paint();
105
+ el.addEventListener('legend-update', this.#targetListener);
106
+ }
107
+
108
+ #detachTarget() {
109
+ if (this.#target && this.#targetListener) {
110
+ this.#target.removeEventListener('legend-update', this.#targetListener);
111
+ }
112
+ this.#target = null;
113
+ this.#targetListener = null;
114
+ }
115
+
116
+ /* ── Item source ────────────────────────────────────────────────── */
117
+
118
+ #resolveItems() {
119
+ /* Explicit items prop wins. */
120
+ if (this.items) {
121
+ try {
122
+ const parsed = JSON.parse(this.items);
123
+ if (Array.isArray(parsed)) return parsed;
124
+ } catch (_) { /* fall through */ }
125
+ }
126
+ /* Mirror from [for] target when present. */
127
+ if (this.#target && Array.isArray(this.#target.legendData)) {
128
+ return this.#target.legendData;
129
+ }
130
+ return [];
131
+ }
132
+
133
+ /* ── Render ─────────────────────────────────────────────────────── */
134
+
135
+ #paint() {
136
+ const items = this.#resolveItems();
137
+ this.innerHTML = '';
138
+ if (!items.length) return;
139
+
140
+ for (const item of items) {
141
+ const key = item.key ?? item.label ?? '';
142
+ const label = item.label ?? key;
143
+ const slot = item.slot != null ? item.slot : 0;
144
+ const active = !this.#hiddenKeys.has(key);
145
+
146
+ /* Each row is a <badge-ui> chip — the canonical AdiaUI primitive for
147
+ legend pills (per badge.yaml's documented "chart-legend" example).
148
+ badge-ui carries the pill chrome (radius, padding, font-size, hover
149
+ affordance), the legend layers shape-specific swatch CSS + the
150
+ click-to-toggle behavior on top. Interactive rows get
151
+ role="button" + tabindex="0" + Enter/Space handlers so they're
152
+ keyboard-operable without a wrapping <button>. */
153
+ const row = document.createElement('badge-ui');
154
+ row.setAttribute('data-row', '');
155
+ row.setAttribute('role', this.static ? 'listitem' : 'button');
156
+ row.setAttribute('text', label);
157
+ if (key) row.setAttribute('data-key', key);
158
+ if (active) row.setAttribute('data-active', '');
159
+ if (!this.static) {
160
+ row.setAttribute('tabindex', '0');
161
+ row.setAttribute('aria-pressed', active ? 'true' : 'false');
162
+ }
163
+
164
+ /* Swatch — composed via `<swatch-ui>` with the legend's [shape] attr
165
+ passed through. Pre-2026-05-01 this was a hand-rolled `<span
166
+ data-swatch>` plus per-shape CSS in this file; that drift caused
167
+ a cascade-leak collision with the docs-shell's `[data-swatch]`
168
+ demo rule (token-colors page). Compose the primitive instead and
169
+ the swatch's dot / square / line / dashed variants live in one
170
+ place. Color resolves via --color-{key} with a --a-data-{slot}
171
+ fallback; the legend can render standalone (without a chart-ui
172
+ ancestor) so the fallback must reference the global data palette
173
+ directly, not chart-ui's scoped --chart-{N} alias. */
174
+ const swatchShape = this.shape || 'dot';
175
+ const swatch = document.createElement('swatch-ui');
176
+ swatch.setAttribute('shape', swatchShape);
177
+ swatch.setAttribute('size', 'sm');
178
+ const swatchColor = key
179
+ ? `var(--color-${key}, var(--a-data-${slot}))`
180
+ : `var(--a-data-${slot})`;
181
+ swatch.style.setProperty('--swatch-color', swatchColor);
182
+ row.appendChild(swatch);
183
+
184
+ if (!this.static) {
185
+ row.addEventListener('click', (e) => this.#onRowToggle(e, key));
186
+ row.addEventListener('keydown', (e) => {
187
+ if (e.key === 'Enter' || e.key === ' ') {
188
+ e.preventDefault();
189
+ this.#onRowToggle(e, key);
190
+ }
191
+ });
192
+ }
193
+
194
+ this.appendChild(row);
195
+ }
196
+ }
197
+
198
+ #onRowToggle(e, key) {
199
+ if (!key) return;
200
+ const currentlyActive = !this.#hiddenKeys.has(key);
201
+ const newActive = !currentlyActive;
202
+ if (newActive) this.#hiddenKeys.delete(key);
203
+ else this.#hiddenKeys.add(key);
204
+
205
+ const row = e.currentTarget;
206
+ if (newActive) row.setAttribute('data-active', '');
207
+ else row.removeAttribute('data-active');
208
+ row.setAttribute('aria-pressed', newActive ? 'true' : 'false');
209
+
210
+ this.dispatchEvent(new CustomEvent('toggle', {
211
+ bubbles: true,
212
+ detail: { key, active: newActive, mode: this.onToggle || 'hide' },
213
+ }));
214
+ }
215
+ }
@@ -0,0 +1,17 @@
1
+ /**
2
+ * `<chat-thread-ui>` — Minimal chat-thread container.
3
+ *
4
+ * @see https://ui-kit.exe.xyz/site/components/chat-thread
5
+ *
6
+ * Type declarations generated by scripts/build/dts-codegen.mjs from
7
+ * the component's `.a2ui.json` sidecar. Edit the source `.yaml`,
8
+ * run `npm run components`, then `npm run codegen:dts` to regenerate;
9
+ * or hand-author this file fully if rich event types are needed.
10
+ */
11
+
12
+ import { UIElement } from '../../core/element.js';
13
+
14
+ export class UIChatThread extends UIElement {
15
+ /** Component property: streaming. */
16
+ streaming: boolean;
17
+ }
@@ -1,166 +1,17 @@
1
- import { UIElement } from '../../core/element.js';
2
- import { renderMarkdown } from '../../core/markdown.js';
3
-
4
- function escapeHTML(s) {
5
- return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
6
- }
7
-
8
1
  /**
9
- * <chat-thread-ui>Minimal chat-thread container.
2
+ * `<chat-thread-ui>`auto-registers the tag on import.
10
3
  *
11
- * Structure:
12
- * <chat-thread-ui>
13
- * <header>
14
- * <span slot="avatar">AI</span>
15
- * <span slot="name">Assistant</span>
16
- * </header>
17
- * <section>
18
- * <!-- messages rendered here -->
19
- * </section>
20
- * <footer>
21
- * <chat-input-ui placeholder="Type a message..."></chat-input-ui>
22
- * </footer>
23
- * </chat-thread-ui>
4
+ * For non-side-effect class import (test isolation, tag override), use
5
+ * the `class` subpath:
24
6
  *
25
- * JS API:
26
- * chat.appendMessage({ role: 'user', content: 'Hello' })
27
- * chat.appendMessage({ role: 'assistant', content: 'Hi!' })
28
- * chat.appendChunk('token') // append to last assistant message
29
- * chat.startStreaming() // show cursor, disable input
30
- * chat.stopStreaming() // hide cursor, enable input
31
- * chat.clear()
32
- * chat.messages // read all messages
7
+ * import { UIChatThread } from '@adia-ai/web-components/components/chat-thread/class';
33
8
  *
34
- * Events:
35
- * submit — user pressed send (detail: { text, model })
9
+ * @see ../../USAGE.md#registration--auto-vs-explicit
36
10
  */
37
- class UIChatThread extends UIElement {
38
- static properties = {
39
- streaming: { type: Boolean, default: false, reflect: true },
40
- };
41
-
42
- static template = () => null; // wrapper mode
43
-
44
- #messages = [];
45
- #messagesEl = null;
46
- #inputEl = null;
47
- #scrollRaf = null;
48
-
49
- get messages() { return [...this.#messages]; }
50
-
51
- connected() {
52
- // Stamp default structure if empty
53
- if (!this.querySelector('header') && !this.querySelector('section')) {
54
- this.innerHTML = `
55
- <header>
56
- <span slot="avatar">AI</span>
57
- <span slot="name">Assistant</span>
58
- </header>
59
- <section></section>
60
- <footer>
61
- <chat-input-ui placeholder="Type a message..."></chat-input-ui>
62
- </footer>
63
- `;
64
- }
65
-
66
- this.#messagesEl = this.querySelector('section');
67
- this.#inputEl = this.querySelector('chat-input-ui');
68
-
69
- this.#inputEl?.addEventListener('submit', this.#onSubmit);
70
- }
71
-
72
- disconnected() {
73
- if (this.#scrollRaf != null) {
74
- cancelAnimationFrame(this.#scrollRaf);
75
- this.#scrollRaf = null;
76
- }
77
- this.#inputEl?.removeEventListener('submit', this.#onSubmit);
78
- this.#messagesEl = null;
79
- this.#inputEl = null;
80
- }
81
-
82
- #onSubmit = (e) => {
83
- if (this.streaming) return;
84
- const { text, model } = e.detail || {};
85
- if (!text) return;
86
- this.#inputEl.clear();
87
- this.dispatchEvent(new CustomEvent('submit', { bubbles: true, detail: { text, model } }));
88
- };
89
-
90
- appendMessage({ role, content = '', render = false }) {
91
- this.#messages.push({ role, content });
92
- const el = document.createElement('div');
93
- el.setAttribute('data-role', role);
94
-
95
- const body = render ? renderMarkdown(content) : escapeHTML(content);
96
-
97
- if (role === 'user') {
98
- el.innerHTML = `<div slot="bubble">${body}</div>`;
99
- } else {
100
- const cursor = render ? '' : '<span slot="cursor"></span>';
101
- el.innerHTML = `
102
- <span slot="avatar">${role === 'assistant' ? 'AI' : role[0].toUpperCase()}</span>
103
- <div slot="bubble">${body}${cursor}</div>
104
- `;
105
- }
106
-
107
- this.#messagesEl?.appendChild(el);
108
- this.#scrollToBottom();
109
- return el;
110
- }
111
-
112
- appendChunk(text) {
113
- const last = this.#messages[this.#messages.length - 1];
114
- if (!last || last.role === 'user') return;
115
- last.content += text;
116
-
117
- const bubble = this.#messagesEl?.querySelector('[data-role]:last-child [slot="bubble"]');
118
- if (bubble) {
119
- const cursor = bubble.querySelector('[slot="cursor"]');
120
- if (cursor) cursor.remove();
121
- bubble.insertAdjacentText('beforeend', text);
122
- bubble.insertAdjacentHTML('beforeend', '<span slot="cursor"></span>');
123
- }
124
- this.#scrollToBottom();
125
- }
126
-
127
- startStreaming() {
128
- this.streaming = true;
129
- if (this.#inputEl) this.#inputEl.disabled = true;
130
- }
131
-
132
- stopStreaming() {
133
- this.streaming = false;
134
- if (this.#inputEl) this.#inputEl.disabled = false;
135
- // Remove cursor from last message
136
- this.#messagesEl?.querySelector('[data-role]:last-child [slot="cursor"]')?.remove();
137
-
138
- // Render markdown in the last assistant bubble
139
- const last = this.#messages[this.#messages.length - 1];
140
- if (last && last.role === 'assistant' && last.content) {
141
- const bubble = this.#messagesEl?.querySelector('[data-role]:last-child [slot="bubble"]');
142
- if (bubble) bubble.innerHTML = renderMarkdown(last.content);
143
- }
144
-
145
- this.#inputEl?.focus();
146
- }
147
11
 
148
- clear() {
149
- this.#messages.length = 0;
150
- if (this.#messagesEl) this.#messagesEl.innerHTML = '';
151
- }
12
+ import { defineIfFree } from '../../core/register.js';
13
+ import { UIChatThread } from './class.js';
152
14
 
153
- #scrollToBottom() {
154
- const el = this.#messagesEl;
155
- if (!el) return;
156
- if (this.#scrollRaf != null) cancelAnimationFrame(this.#scrollRaf);
157
- this.#scrollRaf = requestAnimationFrame(() => {
158
- this.#scrollRaf = null;
159
- if (!this.isConnected) return;
160
- el.scrollTop = el.scrollHeight;
161
- });
162
- }
163
- }
164
- customElements.define('chat-thread-ui', UIChatThread);
15
+ defineIfFree('chat-thread-ui', UIChatThread);
165
16
 
166
17
  export { UIChatThread };