@adia-ai/web-components 0.4.6 → 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 (284) hide show
  1. package/USAGE.md +29 -9
  2. package/components/accordion/accordion.d.ts +17 -0
  3. package/components/accordion/accordion.js +10 -117
  4. package/components/accordion/class.js +132 -0
  5. package/components/action-list/action-list.d.ts +15 -0
  6. package/components/action-list/action-list.js +9 -140
  7. package/components/action-list/class.js +156 -0
  8. package/components/agent-artifact/agent-artifact.d.ts +25 -0
  9. package/components/agent-artifact/agent-artifact.js +8 -181
  10. package/components/agent-artifact/class.js +200 -0
  11. package/components/agent-feedback-bar/agent-feedback-bar.d.ts +21 -0
  12. package/components/agent-feedback-bar/agent-feedback-bar.js +8 -143
  13. package/components/agent-feedback-bar/class.js +162 -0
  14. package/components/agent-questions/agent-questions.d.ts +23 -0
  15. package/components/agent-questions/agent-questions.js +8 -180
  16. package/components/agent-questions/class.js +199 -0
  17. package/components/agent-reasoning/agent-reasoning.d.ts +23 -0
  18. package/components/agent-reasoning/agent-reasoning.js +8 -494
  19. package/components/agent-reasoning/class.js +513 -0
  20. package/components/agent-suggestions/agent-suggestions.d.ts +21 -0
  21. package/components/agent-suggestions/agent-suggestions.js +8 -78
  22. package/components/agent-suggestions/class.js +97 -0
  23. package/components/agent-trace/agent-trace.d.ts +19 -0
  24. package/components/alert/alert.d.ts +29 -0
  25. package/components/alert/alert.js +8 -175
  26. package/components/alert/class.js +194 -0
  27. package/components/avatar/avatar.d.ts +27 -0
  28. package/components/avatar/avatar.js +9 -159
  29. package/components/avatar/class.js +173 -0
  30. package/components/badge/badge.d.ts +27 -0
  31. package/components/badge/badge.js +9 -75
  32. package/components/badge/class.js +93 -0
  33. package/components/block/block.d.ts +19 -0
  34. package/components/block/block.js +9 -15
  35. package/components/block/class.js +33 -0
  36. package/components/breadcrumb/breadcrumb.d.ts +23 -0
  37. package/components/breadcrumb/breadcrumb.js +8 -113
  38. package/components/breadcrumb/class.js +132 -0
  39. package/components/button/button.d.ts +34 -0
  40. package/components/button/button.js +15 -66
  41. package/components/button/class.js +80 -0
  42. package/components/calendar-picker/calendar-picker.a2ui.json +6 -1
  43. package/components/calendar-picker/calendar-picker.js +8 -332
  44. package/components/calendar-picker/calendar-picker.yaml +51 -177
  45. package/components/calendar-picker/class.js +351 -0
  46. package/components/canvas/canvas.a2ui.json +6 -1
  47. package/components/canvas/canvas.d.ts +17 -0
  48. package/components/canvas/canvas.yaml +19 -36
  49. package/components/card/card.a2ui.json +3 -0
  50. package/components/card/card.d.ts +27 -0
  51. package/components/card/card.js +9 -50
  52. package/components/card/card.yaml +171 -433
  53. package/components/card/class.js +68 -0
  54. package/components/chart/chart.d.ts +41 -0
  55. package/components/chart/chart.js +8 -2131
  56. package/components/chart/class.js +2150 -0
  57. package/components/chart-legend/chart-legend.d.ts +27 -0
  58. package/components/chart-legend/chart-legend.js +8 -197
  59. package/components/chart-legend/class.js +215 -0
  60. package/components/chat-thread/chat-thread.d.ts +17 -0
  61. package/components/chat-thread/chat-thread.js +8 -157
  62. package/components/chat-thread/class.js +176 -0
  63. package/components/check/check.js +11 -52
  64. package/components/check/class.js +68 -0
  65. package/components/code/class.js +501 -0
  66. package/components/code/code.js +8 -482
  67. package/components/col/class.js +30 -0
  68. package/components/col/col.d.ts +23 -0
  69. package/components/col/col.js +10 -13
  70. package/components/color-picker/class.js +550 -0
  71. package/components/color-picker/color-picker.js +8 -531
  72. package/components/command/class.js +364 -0
  73. package/components/command/command.a2ui.json +3 -0
  74. package/components/command/command.d.ts +19 -0
  75. package/components/command/command.js +8 -345
  76. package/components/command/command.yaml +105 -124
  77. package/components/demo-toggle/class.js +153 -0
  78. package/components/demo-toggle/demo-toggle.d.ts +23 -0
  79. package/components/demo-toggle/demo-toggle.js +8 -135
  80. package/components/description-list/class.js +86 -0
  81. package/components/description-list/description-list.d.ts +21 -0
  82. package/components/description-list/description-list.js +8 -67
  83. package/components/divider/class.js +57 -0
  84. package/components/divider/divider.d.ts +19 -0
  85. package/components/divider/divider.js +10 -40
  86. package/components/drawer/class.js +306 -0
  87. package/components/drawer/drawer.d.ts +25 -0
  88. package/components/drawer/drawer.js +8 -287
  89. package/components/embed/class.js +73 -0
  90. package/components/embed/embed.d.ts +23 -0
  91. package/components/embed/embed.js +9 -55
  92. package/components/empty-state/class.js +108 -0
  93. package/components/empty-state/empty-state.d.ts +21 -0
  94. package/components/empty-state/empty-state.js +9 -90
  95. package/components/feed/class.js +381 -0
  96. package/components/feed/feed.d.ts +19 -0
  97. package/components/feed/feed.js +9 -367
  98. package/components/field/class.js +266 -0
  99. package/components/field/field.d.ts +23 -0
  100. package/components/field/field.js +8 -247
  101. package/components/fields/class.js +106 -0
  102. package/components/fields/fields.d.ts +19 -0
  103. package/components/fields/fields.js +8 -87
  104. package/components/grid/class.js +31 -0
  105. package/components/grid/grid.d.ts +23 -0
  106. package/components/grid/grid.js +10 -14
  107. package/components/heatmap/class.js +305 -0
  108. package/components/heatmap/heatmap.d.ts +31 -0
  109. package/components/heatmap/heatmap.js +8 -286
  110. package/components/icon/class.js +54 -0
  111. package/components/icon/icon.d.ts +23 -0
  112. package/components/icon/icon.js +13 -40
  113. package/components/image/class.js +112 -0
  114. package/components/image/image.d.ts +33 -0
  115. package/components/image/image.js +9 -94
  116. package/components/input/class.js +773 -0
  117. package/components/input/input.a2ui.json +3 -0
  118. package/components/input/input.js +8 -755
  119. package/components/input/input.yaml +171 -442
  120. package/components/inspector/class.js +142 -0
  121. package/components/inspector/inspector.a2ui.json +8 -1
  122. package/components/inspector/inspector.d.ts +17 -0
  123. package/components/inspector/inspector.js +8 -124
  124. package/components/inspector/inspector.yaml +15 -30
  125. package/components/kbd/class.js +34 -0
  126. package/components/kbd/kbd.a2ui.json +3 -0
  127. package/components/kbd/kbd.d.ts +17 -0
  128. package/components/kbd/kbd.js +10 -17
  129. package/components/kbd/kbd.yaml +54 -185
  130. package/components/link/class.js +187 -0
  131. package/components/link/link.d.ts +55 -0
  132. package/components/link/link.js +8 -168
  133. package/components/list/class.js +249 -0
  134. package/components/list/list.d.ts +23 -0
  135. package/components/list/list.js +9 -231
  136. package/components/menu/class.js +332 -0
  137. package/components/menu/menu.d.ts +21 -0
  138. package/components/menu/menu.js +11 -316
  139. package/components/modal/class.js +231 -0
  140. package/components/modal/modal.a2ui.json +5 -1
  141. package/components/modal/modal.d.ts +23 -0
  142. package/components/modal/modal.js +8 -212
  143. package/components/modal/modal.yaml +19 -39
  144. package/components/nav/class.js +150 -0
  145. package/components/nav/nav.d.ts +31 -0
  146. package/components/nav/nav.js +8 -131
  147. package/components/nav-group/class.js +152 -0
  148. package/components/nav-group/nav-group.d.ts +35 -0
  149. package/components/nav-group/nav-group.js +9 -134
  150. package/components/nav-item/class.js +86 -0
  151. package/components/nav-item/nav-item.d.ts +37 -0
  152. package/components/nav-item/nav-item.js +10 -69
  153. package/components/noodles/class.js +510 -0
  154. package/components/noodles/noodles.d.ts +33 -0
  155. package/components/noodles/noodles.js +9 -493
  156. package/components/option-card/class.js +167 -0
  157. package/components/option-card/option-card.js +8 -149
  158. package/components/otp-input/class.js +180 -0
  159. package/components/otp-input/otp-input.a2ui.json +5 -1
  160. package/components/otp-input/otp-input.js +9 -162
  161. package/components/otp-input/otp-input.yaml +45 -174
  162. package/components/page/class.js +97 -0
  163. package/components/page/page.d.ts +46 -0
  164. package/components/page/page.js +8 -79
  165. package/components/pagination/class.js +195 -0
  166. package/components/pagination/pagination.d.ts +23 -0
  167. package/components/pagination/pagination.js +9 -177
  168. package/components/pane/class.js +186 -0
  169. package/components/pane/pane.a2ui.json +12 -1
  170. package/components/pane/pane.d.ts +31 -0
  171. package/components/pane/pane.js +8 -167
  172. package/components/pane/pane.yaml +57 -157
  173. package/components/pipeline-status/class.js +189 -0
  174. package/components/pipeline-status/pipeline-status.a2ui.json +7 -1
  175. package/components/pipeline-status/pipeline-status.d.ts +21 -0
  176. package/components/pipeline-status/pipeline-status.js +9 -172
  177. package/components/pipeline-status/pipeline-status.yaml +34 -72
  178. package/components/popover/class.js +194 -0
  179. package/components/popover/popover.d.ts +23 -0
  180. package/components/popover/popover.js +9 -176
  181. package/components/progress/class.js +74 -0
  182. package/components/progress/progress.a2ui.json +3 -0
  183. package/components/progress/progress.d.ts +19 -0
  184. package/components/progress/progress.js +10 -57
  185. package/components/progress/progress.yaml +124 -287
  186. package/components/progress-row/class.js +110 -0
  187. package/components/progress-row/progress-row.d.ts +23 -0
  188. package/components/progress-row/progress-row.js +8 -92
  189. package/components/radio/class.js +83 -0
  190. package/components/radio/radio.js +11 -67
  191. package/components/range/class.js +194 -0
  192. package/components/range/range.js +9 -176
  193. package/components/rating/class.js +148 -0
  194. package/components/rating/rating.js +9 -130
  195. package/components/richtext/class.js +87 -0
  196. package/components/richtext/richtext.a2ui.json +7 -1
  197. package/components/richtext/richtext.d.ts +19 -0
  198. package/components/richtext/richtext.js +8 -68
  199. package/components/richtext/richtext.yaml +30 -65
  200. package/components/row/class.js +50 -0
  201. package/components/row/row.d.ts +27 -0
  202. package/components/row/row.js +10 -33
  203. package/components/search/class.js +134 -0
  204. package/components/search/search.js +10 -117
  205. package/components/segment/class.js +62 -0
  206. package/components/segment/segment.d.ts +25 -0
  207. package/components/segment/segment.js +10 -45
  208. package/components/segmented/class.js +165 -0
  209. package/components/segmented/segmented.a2ui.json +4 -0
  210. package/components/segmented/segmented.js +10 -148
  211. package/components/segmented/segmented.yaml +41 -59
  212. package/components/select/class.js +408 -0
  213. package/components/select/select.js +15 -396
  214. package/components/skeleton/class.js +52 -0
  215. package/components/skeleton/skeleton.d.ts +23 -0
  216. package/components/skeleton/skeleton.js +8 -34
  217. package/components/slider/class.js +184 -0
  218. package/components/slider/slider.js +9 -166
  219. package/components/stack/class.js +28 -0
  220. package/components/stack/stack.d.ts +17 -0
  221. package/components/stack/stack.js +10 -11
  222. package/components/step-progress/class.js +98 -0
  223. package/components/step-progress/step-progress.d.ts +27 -0
  224. package/components/step-progress/step-progress.js +8 -79
  225. package/components/stepper/class.js +126 -0
  226. package/components/stepper/stepper.d.ts +19 -0
  227. package/components/stepper/stepper.js +9 -112
  228. package/components/stream/class.js +109 -0
  229. package/components/stream/stream.d.ts +19 -0
  230. package/components/stream/stream.js +8 -90
  231. package/components/swatch/class.js +131 -0
  232. package/components/swatch/swatch.d.ts +28 -0
  233. package/components/swatch/swatch.js +8 -112
  234. package/components/swiper/class.js +373 -0
  235. package/components/swiper/swiper.a2ui.json +4 -0
  236. package/components/swiper/swiper.d.ts +31 -0
  237. package/components/swiper/swiper.js +8 -354
  238. package/components/swiper/swiper.yaml +68 -212
  239. package/components/switch/class.js +63 -0
  240. package/components/switch/switch.a2ui.json +6 -1
  241. package/components/switch/switch.js +11 -47
  242. package/components/switch/switch.yaml +70 -265
  243. package/components/table/class.js +1453 -0
  244. package/components/table/table.d.ts +37 -0
  245. package/components/table/table.js +8 -1435
  246. package/components/table-toolbar/class.js +680 -0
  247. package/components/table-toolbar/table-toolbar.d.ts +33 -0
  248. package/components/table-toolbar/table-toolbar.js +8 -689
  249. package/components/tabs/class.js +242 -0
  250. package/components/tabs/tabs.d.ts +21 -0
  251. package/components/tabs/tabs.js +8 -223
  252. package/components/tag/class.js +99 -0
  253. package/components/tag/tag.d.ts +27 -0
  254. package/components/tag/tag.js +8 -80
  255. package/components/text/class.js +46 -0
  256. package/components/text/text.d.ts +25 -0
  257. package/components/text/text.js +9 -28
  258. package/components/textarea/class.js +134 -0
  259. package/components/textarea/textarea.js +11 -118
  260. package/components/timeline/class.js +176 -0
  261. package/components/timeline/timeline.d.ts +19 -0
  262. package/components/timeline/timeline.js +9 -162
  263. package/components/toast/class.js +92 -0
  264. package/components/toast/toast.d.ts +23 -0
  265. package/components/toast/toast.js +9 -76
  266. package/components/toggle-group/class.js +154 -0
  267. package/components/toggle-group/toggle-group.d.ts +19 -0
  268. package/components/toggle-group/toggle-group.js +11 -140
  269. package/components/toggle-scheme/class.js +286 -0
  270. package/components/toggle-scheme/toggle-scheme.d.ts +41 -0
  271. package/components/toggle-scheme/toggle-scheme.js +8 -268
  272. package/components/toolbar/class.js +388 -0
  273. package/components/toolbar/toolbar.d.ts +23 -0
  274. package/components/toolbar/toolbar.js +10 -376
  275. package/components/tooltip/class.js +299 -0
  276. package/components/tooltip/tooltip.d.ts +27 -0
  277. package/components/tooltip/tooltip.js +8 -280
  278. package/components/tree/class.js +245 -0
  279. package/components/tree/tree.d.ts +15 -0
  280. package/components/tree/tree.js +9 -244
  281. package/components/upload/class.js +199 -0
  282. package/components/upload/upload.js +11 -183
  283. package/index.d.ts +159 -5
  284. package/package.json +5 -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 };