@link-foundation/ui-components 0.0.0-stage → 0.0.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 (402) hide show
  1. package/CONFIGURATIONS.md +74 -0
  2. package/ICONS.md +76 -0
  3. package/LICENSE +24 -0
  4. package/README.md +1499 -2
  5. package/bin/lino-network.mjs +71 -0
  6. package/dist/icons/ATTRIBUTION.md +602 -0
  7. package/dist/icons/NOTICE.lino +1261 -0
  8. package/dist/icons/brand.js +31 -0
  9. package/dist/icons/brand.svg +3 -0
  10. package/dist/icons/licenses/brand/DISCLAIMER.md +51 -0
  11. package/dist/icons/licenses/brand/LICENSE.md +30 -0
  12. package/dist/icons/licenses/lucide/LICENSE +43 -0
  13. package/dist/icons/licenses/material-symbols/LICENSE +202 -0
  14. package/dist/icons/licenses/material-symbols/NOTICE +12 -0
  15. package/dist/icons/licenses/tabler/LICENSE +21 -0
  16. package/dist/icons/lucide.js +681 -0
  17. package/dist/icons/lucide.svg +34 -0
  18. package/dist/icons/material-symbols.js +681 -0
  19. package/dist/icons/material-symbols.svg +34 -0
  20. package/dist/icons/own.js +521 -0
  21. package/dist/icons/own.svg +34 -0
  22. package/dist/icons/tabler.js +681 -0
  23. package/dist/icons/tabler.svg +34 -0
  24. package/dist/network-layout-NOTICE.md +6 -0
  25. package/dist/network-layout-d3-dispatch-LICENSE.txt +13 -0
  26. package/dist/network-layout-d3-force-LICENSE.txt +13 -0
  27. package/dist/network-layout-d3-quadtree-LICENSE.txt +13 -0
  28. package/dist/network-layout-d3-timer-LICENSE.txt +13 -0
  29. package/dist/network-layout-dagre-LICENSE.txt +19 -0
  30. package/dist/network-layout.worker.mjs +2 -0
  31. package/package.json +246 -4
  32. package/src/a11y/announce.js +88 -0
  33. package/src/a11y/bind-machine.js +181 -0
  34. package/src/a11y/focus.js +169 -0
  35. package/src/a11y/index.d.ts +89 -0
  36. package/src/a11y/index.js +19 -0
  37. package/src/a11y/keys.js +182 -0
  38. package/src/a11y/roving.js +167 -0
  39. package/src/a11y/typeahead.js +82 -0
  40. package/src/behavior/actions.js +235 -0
  41. package/src/behavior/diagnostics.js +73 -0
  42. package/src/behavior/dom.d.ts +38 -0
  43. package/src/behavior/dom.js +420 -0
  44. package/src/behavior/index.d.ts +211 -0
  45. package/src/behavior/index.js +29 -0
  46. package/src/behavior/interpret.js +454 -0
  47. package/src/behavior/machines/disclosure.lino +46 -0
  48. package/src/behavior/machines/index.js +91 -0
  49. package/src/behavior/machines/toggle.lino +25 -0
  50. package/src/behavior/parse-machine.js +367 -0
  51. package/src/charts/README.md +78 -0
  52. package/src/charts/activity-layout.js +350 -0
  53. package/src/charts/activity-model.js +130 -0
  54. package/src/charts/activity-validation.js +31 -0
  55. package/src/charts/chart-model.js +667 -0
  56. package/src/charts/chart.js +518 -0
  57. package/src/charts/echarts-adapter.d.ts +23 -0
  58. package/src/charts/echarts-adapter.js +240 -0
  59. package/src/charts/element.js +330 -0
  60. package/src/charts/errors.js +62 -0
  61. package/src/charts/gauge.js +27 -0
  62. package/src/charts/index.d.ts +344 -0
  63. package/src/charts/index.js +59 -0
  64. package/src/charts/layout.js +542 -0
  65. package/src/charts/lino.js +158 -0
  66. package/src/charts/mark-options.js +78 -0
  67. package/src/charts/read.js +101 -0
  68. package/src/charts/renderer-features.js +8 -0
  69. package/src/charts/scales.js +223 -0
  70. package/src/charts/small-model.js +223 -0
  71. package/src/charts/small-svg.js +269 -0
  72. package/src/charts/sparkline.js +27 -0
  73. package/src/charts/stat-tile.js +37 -0
  74. package/src/charts/summary.js +193 -0
  75. package/src/charts/svg-renderer.js +226 -0
  76. package/src/charts/svg.js +69 -0
  77. package/src/charts/tag-cloud.js +129 -0
  78. package/src/charts/tokens.js +171 -0
  79. package/src/charts/tooltip.js +47 -0
  80. package/src/charts/values.js +146 -0
  81. package/src/chat/README.md +142 -0
  82. package/src/chat/actions.js +75 -0
  83. package/src/chat/chat-contract.js +95 -0
  84. package/src/chat/chat-list.js +42 -0
  85. package/src/chat/chat-model.js +125 -0
  86. package/src/chat/chat.css +228 -0
  87. package/src/chat/composer.js +131 -0
  88. package/src/chat/day-separator.js +12 -0
  89. package/src/chat/dom.js +33 -0
  90. package/src/chat/follow.js +49 -0
  91. package/src/chat/index.d.ts +142 -0
  92. package/src/chat/index.js +13 -0
  93. package/src/chat/message-bubble.js +191 -0
  94. package/src/chat/message-stream.js +331 -0
  95. package/src/chat/reasoning-trace.js +70 -0
  96. package/src/chat/selection.js +39 -0
  97. package/src/chat/skins/bubbles.lino +2 -0
  98. package/src/chat/skins/cards.lino +4 -0
  99. package/src/chat/skins/compact.lino +4 -0
  100. package/src/chat/skins/signal.lino +25 -0
  101. package/src/chat/skins/t3.lino +25 -0
  102. package/src/chat/skins/telegram.lino +31 -0
  103. package/src/chat/skins/whatsapp.lino +25 -0
  104. package/src/chat/stream-keys.js +57 -0
  105. package/src/chat/stream-window.js +159 -0
  106. package/src/chat/vocabulary.js +19 -0
  107. package/src/controls/accordion.js +160 -0
  108. package/src/controls/avatar.js +80 -0
  109. package/src/controls/badge.js +48 -0
  110. package/src/controls/button-template.js +32 -0
  111. package/src/controls/button.js +97 -0
  112. package/src/controls/catalog.lino +84 -0
  113. package/src/controls/checkbox.js +112 -0
  114. package/src/controls/chip.js +140 -0
  115. package/src/controls/choices.js +45 -0
  116. package/src/controls/color-field.js +217 -0
  117. package/src/controls/color-popover.js +135 -0
  118. package/src/controls/color-rgb.js +80 -0
  119. package/src/controls/color.js +67 -0
  120. package/src/controls/combobox.js +192 -0
  121. package/src/controls/dom.js +261 -0
  122. package/src/controls/icon-button.js +33 -0
  123. package/src/controls/index.d.ts +163 -0
  124. package/src/controls/index.js +182 -0
  125. package/src/controls/kinds-text.js +358 -0
  126. package/src/controls/kinds.lino +350 -0
  127. package/src/controls/label.js +52 -0
  128. package/src/controls/link.js +101 -0
  129. package/src/controls/listbox.js +144 -0
  130. package/src/controls/machines/button.lino +20 -0
  131. package/src/controls/machines/checkbox.lino +17 -0
  132. package/src/controls/machines/chip.lino +20 -0
  133. package/src/controls/machines/color-field.lino +23 -0
  134. package/src/controls/machines/combobox.lino +82 -0
  135. package/src/controls/machines/icon-button.lino +20 -0
  136. package/src/controls/machines/index.js +586 -0
  137. package/src/controls/machines/number-field.lino +71 -0
  138. package/src/controls/machines/radio-group.lino +17 -0
  139. package/src/controls/machines/select.lino +122 -0
  140. package/src/controls/machines/slider.lino +99 -0
  141. package/src/controls/machines/switch.lino +19 -0
  142. package/src/controls/machines/text-area.lino +26 -0
  143. package/src/controls/machines/text-field.lino +26 -0
  144. package/src/controls/number-field.js +239 -0
  145. package/src/controls/numeric-keys.js +125 -0
  146. package/src/controls/option.js +54 -0
  147. package/src/controls/progress.js +76 -0
  148. package/src/controls/radio-group.js +234 -0
  149. package/src/controls/select.js +229 -0
  150. package/src/controls/slider.js +234 -0
  151. package/src/controls/stories.js +172 -0
  152. package/src/controls/styles.css +1060 -0
  153. package/src/controls/switch.js +95 -0
  154. package/src/controls/text-area.js +39 -0
  155. package/src/controls/text-field.js +131 -0
  156. package/src/controls/vocabulary.js +164 -0
  157. package/src/data/data.css +95 -0
  158. package/src/data/index.d.ts +83 -0
  159. package/src/data/index.js +10 -0
  160. package/src/data/keyboard.js +189 -0
  161. package/src/data/list.js +215 -0
  162. package/src/data/render-data.js +116 -0
  163. package/src/data/selection-dom.js +39 -0
  164. package/src/data/selection-model.js +43 -0
  165. package/src/data/sort-model.js +42 -0
  166. package/src/data/source.js +45 -0
  167. package/src/data/table.js +160 -0
  168. package/src/data/tree-model.js +41 -0
  169. package/src/data/tree.js +55 -0
  170. package/src/data/viewport.js +216 -0
  171. package/src/data/virtual-range.js +92 -0
  172. package/src/data/vocabulary.js +67 -0
  173. package/src/diagrams/diagram-model.js +511 -0
  174. package/src/diagrams/diagram.js +204 -0
  175. package/src/diagrams/index.d.ts +225 -0
  176. package/src/diagrams/index.js +48 -0
  177. package/src/diagrams/layout-dagre.js +164 -0
  178. package/src/diagrams/layout-plugins.js +131 -0
  179. package/src/diagrams/mermaid-export.js +232 -0
  180. package/src/diagrams/mermaid-view.js +229 -0
  181. package/src/diagrams/svg-diagram.js +215 -0
  182. package/src/editor/code-editor.js +206 -0
  183. package/src/editor/documents-model.js +170 -0
  184. package/src/editor/documents-persistence.js +85 -0
  185. package/src/editor/editor-engine.js +22 -0
  186. package/src/editor/editor-ui.js +203 -0
  187. package/src/editor/editor.css +106 -0
  188. package/src/editor/engines/codemirror.js +227 -0
  189. package/src/editor/engines/monaco.js +219 -0
  190. package/src/editor/index.d.ts +111 -0
  191. package/src/editor/index.js +14 -0
  192. package/src/editor/lino-highlight.js +106 -0
  193. package/src/editor/lino-structure.js +85 -0
  194. package/src/editor/validate-lino.js +43 -0
  195. package/src/embed/README.md +161 -0
  196. package/src/embed/controller.js +223 -0
  197. package/src/embed/element.js +141 -0
  198. package/src/embed/index.d.ts +75 -0
  199. package/src/embed/index.js +9 -0
  200. package/src/embed/providers/telegram.d.ts +3 -0
  201. package/src/embed/providers/telegram.js +38 -0
  202. package/src/embed/providers/vk.d.ts +3 -0
  203. package/src/embed/providers/vk.js +42 -0
  204. package/src/embed/providers/x.d.ts +3 -0
  205. package/src/embed/providers/x.js +31 -0
  206. package/src/embed/registry.js +35 -0
  207. package/src/embed/script.js +73 -0
  208. package/src/embed/view.js +122 -0
  209. package/src/icons/adapters/lucide.d.ts +15 -0
  210. package/src/icons/adapters/lucide.js +142 -0
  211. package/src/icons/adapters/material-symbols.d.ts +13 -0
  212. package/src/icons/adapters/material-symbols.js +113 -0
  213. package/src/icons/adapters/shared.d.ts +38 -0
  214. package/src/icons/adapters/shared.js +157 -0
  215. package/src/icons/adapters/simple-icons.d.ts +9 -0
  216. package/src/icons/adapters/simple-icons.js +38 -0
  217. package/src/icons/adapters/tabler.d.ts +9 -0
  218. package/src/icons/adapters/tabler.js +86 -0
  219. package/src/icons/icon-registry.js +215 -0
  220. package/src/icons/icon.js +356 -0
  221. package/src/icons/index.d.ts +123 -0
  222. package/src/icons/index.js +30 -0
  223. package/src/icons/names.js +51 -0
  224. package/src/icons/own-icons.js +521 -0
  225. package/src/icons/presentation.js +55 -0
  226. package/src/icons/svg.js +136 -0
  227. package/src/index.d.ts +14 -0
  228. package/src/index.js +40 -0
  229. package/src/layout/README.md +102 -0
  230. package/src/layout/app-shell.js +150 -0
  231. package/src/layout/catalog.lino +27 -0
  232. package/src/layout/dock-model.js +576 -0
  233. package/src/layout/dock-view.js +312 -0
  234. package/src/layout/dock.js +352 -0
  235. package/src/layout/dom.js +312 -0
  236. package/src/layout/grid.js +192 -0
  237. package/src/layout/index.d.ts +267 -0
  238. package/src/layout/index.js +60 -0
  239. package/src/layout/layer-manager.js +120 -0
  240. package/src/layout/layout.css +760 -0
  241. package/src/layout/menu.js +141 -0
  242. package/src/layout/nav-strip.js +174 -0
  243. package/src/layout/page-links.js +166 -0
  244. package/src/layout/panel.js +26 -0
  245. package/src/layout/pref-switches.js +209 -0
  246. package/src/layout/split-model.js +270 -0
  247. package/src/layout/split.js +430 -0
  248. package/src/layout/stack.js +86 -0
  249. package/src/layout/surfaces.js +119 -0
  250. package/src/layout/tab-group.js +151 -0
  251. package/src/layout/tab-strip.js +277 -0
  252. package/src/layout/vocabulary.js +229 -0
  253. package/src/layout/window-frame.js +222 -0
  254. package/src/layout/window.js +146 -0
  255. package/src/links-view/animator.js +144 -0
  256. package/src/links-view/configuration-classes.js +150 -0
  257. package/src/links-view/configuration-model.js +191 -0
  258. package/src/links-view/configuration-notations.js +230 -0
  259. package/src/links-view/configurations.d.ts +73 -0
  260. package/src/links-view/configurations.js +33 -0
  261. package/src/links-view/create-layout-runner.js +79 -0
  262. package/src/links-view/doublet-curves.js +239 -0
  263. package/src/links-view/doublet-layout.js +148 -0
  264. package/src/links-view/doublet-markers.js +109 -0
  265. package/src/links-view/doublet-options.js +369 -0
  266. package/src/links-view/doublet-svg.js +156 -0
  267. package/src/links-view/doublet.js +230 -0
  268. package/src/links-view/export.js +146 -0
  269. package/src/links-view/geometry.js +409 -0
  270. package/src/links-view/index.d.ts +1029 -0
  271. package/src/links-view/index.js +140 -0
  272. package/src/links-view/labels.js +28 -0
  273. package/src/links-view/layout-worker-entry.mjs +2 -0
  274. package/src/links-view/layout-worker.js +28 -0
  275. package/src/links-view/layouts/circle.js +7 -0
  276. package/src/links-view/layouts/force.js +76 -0
  277. package/src/links-view/layouts/grid.js +7 -0
  278. package/src/links-view/layouts/hex.js +8 -0
  279. package/src/links-view/layouts/index.js +15 -0
  280. package/src/links-view/layouts/layered.js +29 -0
  281. package/src/links-view/layouts/regular.js +27 -0
  282. package/src/links-view/layouts/spiral.js +10 -0
  283. package/src/links-view/link-view.js +494 -0
  284. package/src/links-view/links-gallery.js +306 -0
  285. package/src/links-view/links-network.js +496 -0
  286. package/src/links-view/lino-network-source.js +122 -0
  287. package/src/links-view/lino-network.js +233 -0
  288. package/src/links-view/lino-to-network.js +252 -0
  289. package/src/links-view/markers.js +192 -0
  290. package/src/links-view/model.js +233 -0
  291. package/src/links-view/network-editor/dom.js +36 -0
  292. package/src/links-view/network-editor/editor.js +202 -0
  293. package/src/links-view/network-editor/model.js +163 -0
  294. package/src/links-view/network-editor/options.js +265 -0
  295. package/src/links-view/network-editor/panels.js +423 -0
  296. package/src/links-view/network-editor/presets.js +76 -0
  297. package/src/links-view/network-editor/provider.js +93 -0
  298. package/src/links-view/network-editor/remap.js +45 -0
  299. package/src/links-view/network-editor/schema.js +224 -0
  300. package/src/links-view/network-editor/share.js +232 -0
  301. package/src/links-view/network-editor/styles.js +19 -0
  302. package/src/links-view/network-editor/url-sync.js +131 -0
  303. package/src/links-view/network-interaction.js +228 -0
  304. package/src/links-view/network-model.js +85 -0
  305. package/src/links-view/network-renderer.js +259 -0
  306. package/src/links-view/network-scene.js +245 -0
  307. package/src/links-view/network-source.js +82 -0
  308. package/src/links-view/network-vocabulary.js +18 -0
  309. package/src/links-view/presentation.js +199 -0
  310. package/src/links-view/render-canvas.js +102 -0
  311. package/src/links-view/render-svg.js +118 -0
  312. package/src/links-view/scene.js +233 -0
  313. package/src/links-view/solver-job.js +106 -0
  314. package/src/links-view/tokens.js +114 -0
  315. package/src/links-view/zoom-pan.js +203 -0
  316. package/src/overlays/catalog.lino +89 -0
  317. package/src/overlays/context-menu.js +110 -0
  318. package/src/overlays/dialog.js +117 -0
  319. package/src/overlays/dom.js +168 -0
  320. package/src/overlays/drawer.js +8 -0
  321. package/src/overlays/index.d.ts +80 -0
  322. package/src/overlays/index.js +25 -0
  323. package/src/overlays/kinds.lino +137 -0
  324. package/src/overlays/list-popover.js +129 -0
  325. package/src/overlays/machines/index.js +71 -0
  326. package/src/overlays/machines/surface.lino +11 -0
  327. package/src/overlays/machines/tabs.lino +7 -0
  328. package/src/overlays/machines/toast.lino +16 -0
  329. package/src/overlays/machines/tooltip.lino +29 -0
  330. package/src/overlays/menu.js +240 -0
  331. package/src/overlays/popover.js +194 -0
  332. package/src/overlays/position.js +84 -0
  333. package/src/overlays/radial-geometry.js +38 -0
  334. package/src/overlays/radial-menu.js +50 -0
  335. package/src/overlays/styles.css +155 -0
  336. package/src/overlays/tabs.js +125 -0
  337. package/src/overlays/toast-queue.js +105 -0
  338. package/src/overlays/toast.js +163 -0
  339. package/src/overlays/tooltip.js +110 -0
  340. package/src/overlays/vocabulary.js +3 -0
  341. package/src/settings/conditions.js +44 -0
  342. package/src/settings/control-for.js +62 -0
  343. package/src/settings/field-control.js +201 -0
  344. package/src/settings/index.d.ts +201 -0
  345. package/src/settings/index.js +3 -0
  346. package/src/settings/messages.js +112 -0
  347. package/src/settings/miniature.js +26 -0
  348. package/src/settings/panel-actions.js +234 -0
  349. package/src/settings/panel-model.js +49 -0
  350. package/src/settings/panel-refresh.js +56 -0
  351. package/src/settings/panel-rows.js +200 -0
  352. package/src/settings/preset-cards.js +43 -0
  353. package/src/settings/saved-looks.js +227 -0
  354. package/src/settings/section-layout.js +95 -0
  355. package/src/settings/section-tabs.js +175 -0
  356. package/src/settings/settings-panel.js +192 -0
  357. package/src/settings/settings.css +178 -0
  358. package/stories/accordion.lino +14 -0
  359. package/stories/alert-dialog.lino +4 -0
  360. package/stories/app-bar.lino +10 -0
  361. package/stories/avatar.lino +7 -0
  362. package/stories/badge.lino +12 -0
  363. package/stories/button.lino +17 -0
  364. package/stories/card.lino +10 -0
  365. package/stories/checkbox.lino +14 -0
  366. package/stories/chip.lino +19 -0
  367. package/stories/color-field.lino +9 -0
  368. package/stories/combobox.lino +10 -0
  369. package/stories/container.lino +11 -0
  370. package/stories/context-menu.lino +15 -0
  371. package/stories/dialog.lino +16 -0
  372. package/stories/drawer.lino +12 -0
  373. package/stories/icon-button.lino +13 -0
  374. package/stories/label.lino +7 -0
  375. package/stories/link-cards.lino +9 -0
  376. package/stories/link.lino +9 -0
  377. package/stories/menu-item.lino +6 -0
  378. package/stories/menu-separator.lino +7 -0
  379. package/stories/menu.lino +30 -0
  380. package/stories/nav-strip.lino +11 -0
  381. package/stories/number-field.lino +16 -0
  382. package/stories/option.lino +10 -0
  383. package/stories/paper.lino +11 -0
  384. package/stories/popover.lino +4 -0
  385. package/stories/pref-switches.lino +4 -0
  386. package/stories/progress.lino +14 -0
  387. package/stories/radial-menu.lino +19 -0
  388. package/stories/radio-group.lino +22 -0
  389. package/stories/radio.lino +10 -0
  390. package/stories/section-nav.lino +9 -0
  391. package/stories/select.lino +16 -0
  392. package/stories/slider.lino +14 -0
  393. package/stories/switch.lino +10 -0
  394. package/stories/tab-panel.lino +7 -0
  395. package/stories/tab.lino +7 -0
  396. package/stories/tabs.lino +25 -0
  397. package/stories/text-area.lino +12 -0
  398. package/stories/text-field.lino +23 -0
  399. package/stories/titled-section.lino +7 -0
  400. package/stories/toast.lino +3 -0
  401. package/stories/toaster.lino +2 -0
  402. package/stories/tooltip.lino +3 -0
@@ -0,0 +1,518 @@
1
+ /**
2
+ * The `<ui-chart>` element: a chart of the chart dialect, accessible to
3
+ * keyboard and screen reader users.
4
+ *
5
+ * - The chart is a deterministic SVG (`renderChartSvg`) with `role="img"`
6
+ * and an `aria-label` from `(description ...)` (else the title, else a
7
+ * summary computed from the data).
8
+ * - A data table twin is always in the page, visually hidden; the "Show
9
+ * data table" button (`aria-expanded`) shows it.
10
+ * - The plot is focusable: Left and Right move between the points of a
11
+ * series, Up and Down between series, Home and End to the first and last
12
+ * point, Escape hides the tooltip. The value of the point is shown in a
13
+ * tooltip and announced through an `aria-live` region.
14
+ * - `(renderer echarts)` loads the ECharts adapter, and ECharts itself, on
15
+ * first use only; until it loads (or if it fails) the SVG is shown.
16
+ *
17
+ * The spec is an inline `<script type="text/lino">` child, or the `lino`
18
+ * (text) or `spec` (object) property.
19
+ */
20
+
21
+ import {
22
+ createChartElementClass,
23
+ createTable,
24
+ defineElement,
25
+ div,
26
+ drawSmallChart,
27
+ uniqueId,
28
+ } from './element.js';
29
+ import { tooltipContent, showTopTooltip } from './tooltip.js';
30
+ import { supportsECharts } from './renderer-features.js';
31
+ import { layoutChart } from './layout.js';
32
+ import { summarizeChart } from './summary.js';
33
+ import { layoutToSvg } from './svg-renderer.js';
34
+
35
+ /** The tag of the element. */
36
+ export const CHART_TAG = 'ui-chart';
37
+
38
+ const SVG_NS = 'http://www.w3.org/2000/svg';
39
+ const POINTER_REACH = 24;
40
+
41
+ /** The keys of the plot and the move each makes. */
42
+ const MOVES = {
43
+ ArrowRight: (at) => ({ ...at, index: at.index + 1 }),
44
+ ArrowLeft: (at) => ({ ...at, index: at.index - 1 }),
45
+ ArrowDown: (at) => ({ ...at, series: at.series + 1 }),
46
+ ArrowUp: (at) => ({ ...at, series: at.series - 1 }),
47
+ Home: (at) => ({ ...at, index: 0 }),
48
+ End: (at) => ({ ...at, index: Number.MAX_SAFE_INTEGER }),
49
+ };
50
+
51
+ const clamp = (value, low, high) => Math.min(high, Math.max(low, value));
52
+
53
+ /** The layout series that have points. */
54
+ const navigable = (layout) =>
55
+ layout.series.filter((series) => series.points.length > 0);
56
+
57
+ /** The show / hide text of the table toggle. */
58
+ const toggleText = (shown) => (shown ? 'Hide data table' : 'Show data table');
59
+
60
+ /** The number of points a keyboard user can reach. */
61
+ const pointCount = (layout) =>
62
+ navigable(layout).reduce((sum, series) => sum + series.points.length, 0);
63
+
64
+ /** The focusable plot: the SVG (`role="img"`) and the tooltip. */
65
+ function createCanvas(document, layout) {
66
+ const canvas = div(document, 'ui-chart-canvas');
67
+ canvas.innerHTML = layoutToSvg(layout);
68
+ canvas.tabIndex = 0;
69
+ canvas.setAttribute('role', 'group');
70
+ canvas.setAttribute('aria-roledescription', 'chart');
71
+ canvas.setAttribute('aria-label', layout.label);
72
+ const tooltip = div(document, 'ui-chart-tooltip');
73
+ tooltip.setAttribute('role', 'tooltip');
74
+ tooltip.id = uniqueId(document);
75
+ tooltip.hidden = true;
76
+ canvas.append(tooltip);
77
+ return { canvas, tooltip };
78
+ }
79
+
80
+ /**
81
+ * The canvas, tooltip, keyboard hint, live region, summary, table toggle
82
+ * and table of a chart (no listeners).
83
+ * @param {Document} document
84
+ * @param {object} spec
85
+ * @param {object} layout
86
+ */
87
+ function createParts(document, spec, layout) {
88
+ const { canvas, tooltip } = createCanvas(document, layout);
89
+ const count = pointCount(layout);
90
+ const hint = div(document, 'ui-chart-hint ui-visually-hidden');
91
+ hint.id = uniqueId(document);
92
+ hint.textContent =
93
+ count === 0
94
+ ? 'The chart has no data points.'
95
+ : `${count} data points. Use the arrow keys to move between them, Up and Down to change series.`;
96
+ canvas.setAttribute('aria-describedby', hint.id);
97
+ const live = div(document, 'ui-chart-live ui-visually-hidden');
98
+ live.setAttribute('aria-live', 'polite');
99
+ live.setAttribute('aria-atomic', 'true');
100
+ const summary = document.createElement('figcaption');
101
+ summary.className = 'ui-chart-summary';
102
+ summary.textContent = summarizeChart(spec);
103
+ const table = createTable(document, spec, uniqueId(document));
104
+ table.classList.add('ui-visually-hidden');
105
+ const toggle = document.createElement('button');
106
+ toggle.type = 'button';
107
+ toggle.className = 'ui-chart-toggle';
108
+ toggle.textContent = toggleText(false);
109
+ toggle.setAttribute('aria-expanded', 'false');
110
+ toggle.setAttribute('aria-controls', table.id);
111
+ const figure = document.createElement('figure');
112
+ figure.className = 'ui-chart-figure';
113
+ figure.append(canvas, hint, live, summary, toggle, table);
114
+ return { figure, canvas, hint, tooltip, live, summary, toggle, table };
115
+ }
116
+
117
+ /** The announcement of a point: its value and where it is. */
118
+ function announcement(series, s, i) {
119
+ const { points } = series[s];
120
+ const where =
121
+ series.length > 1
122
+ ? `point ${i + 1} of ${points.length}, series ${s + 1} of ${series.length}`
123
+ : `point ${i + 1} of ${points.length}`;
124
+ return `${points[i].text}, ${where}`;
125
+ }
126
+
127
+ /** The point nearest to (x, y) in layout pixels, within reach, or null. */
128
+ function nearestPoint(layout, x, y) {
129
+ let best = null;
130
+ for (const series of navigable(layout)) {
131
+ for (const point of series.points) {
132
+ const distance = Math.hypot(point.x - x, point.y - y);
133
+ if (distance <= POINTER_REACH && (!best || distance < best.d)) {
134
+ best = { point, d: distance };
135
+ }
136
+ }
137
+ }
138
+ return best?.point ?? null;
139
+ }
140
+
141
+ /** The scale of the drawn SVG to layout pixels (1 when unknown). */
142
+ function svgScale(canvas, layout) {
143
+ const svg = canvas.querySelector('svg');
144
+ const drawn = svg?.getBoundingClientRect().width ?? 0;
145
+ return drawn > 0 ? drawn / layout.width : 1;
146
+ }
147
+
148
+ /** Draw (or move) the ring around the active point in an SVG. */
149
+ function placeFocusRing(svg, point) {
150
+ let ring = svg.querySelector('.ui-chart-focus');
151
+ if (ring === null) {
152
+ ring = svg.ownerDocument.createElementNS(SVG_NS, 'circle');
153
+ ring.setAttribute('class', 'ui-chart-focus');
154
+ ring.setAttribute('r', '8');
155
+ ring.setAttribute('aria-hidden', 'true');
156
+ svg.append(ring);
157
+ }
158
+ ring.setAttribute('cx', String(point.x));
159
+ ring.setAttribute('cy', String(point.y));
160
+ }
161
+
162
+ /** The colour scheme around an element: `[data-theme]`, else the media. */
163
+ function pageTheme(element, win) {
164
+ const set = element.closest('[data-theme]')?.getAttribute('data-theme');
165
+ if (set === 'dark' || set === 'light') {
166
+ return set;
167
+ }
168
+ const dark = win.matchMedia?.('(prefers-color-scheme: dark)').matches;
169
+ return dark ? 'dark' : 'light';
170
+ }
171
+
172
+ /**
173
+ * Draw a chart with ECharts in a host over the SVG of a canvas, loading the
174
+ * adapter (and ECharts) on first use.
175
+ * @returns {Promise<object>} the ECharts instance
176
+ */
177
+ async function mountECharts(canvas, spec, layout, options) {
178
+ const { renderECharts } = await import('./echarts-adapter.js');
179
+ const host = div(canvas.ownerDocument, 'ui-chart-echarts');
180
+ host.setAttribute('aria-hidden', 'true');
181
+ host.style.width = `${layout.width}px`;
182
+ host.style.height = `${layout.height}px`;
183
+ canvas.insertBefore(host, canvas.querySelector('svg'));
184
+ const { instance } = await renderECharts(host, spec, {
185
+ ...options,
186
+ width: layout.width,
187
+ height: layout.height,
188
+ });
189
+ return instance;
190
+ }
191
+
192
+ function positionPointTooltip(tooltip, canvas, layout, point, pointer, scale) {
193
+ const box = canvas.querySelector('svg').getBoundingClientRect();
194
+ const markBox = canvas
195
+ .querySelector(
196
+ `.ui-chart-marks [data-series="${point.series}"][data-row="${point.row}"]`
197
+ )
198
+ ?.getBoundingClientRect();
199
+ const x =
200
+ pointer?.clientX ??
201
+ (markBox ? markBox.left + markBox.width / 2 : box.left + point.x * scale);
202
+ const y = pointer?.clientY ?? markBox?.top ?? box.top + point.y * scale;
203
+ return showTopTooltip(
204
+ tooltip,
205
+ canvas,
206
+ x,
207
+ y,
208
+ x > box.left + (layout.plot.x + layout.plot.width * 0.6) * scale
209
+ );
210
+ }
211
+
212
+ function showPointTooltip(
213
+ { parts, layout, spec, echarts, stop },
214
+ point,
215
+ pointer
216
+ ) {
217
+ const { tooltip, canvas } = parts;
218
+ const scale = svgScale(parts.canvas, layout);
219
+ stop?.();
220
+ stop = null;
221
+ tooltipContent(tooltip, point, spec);
222
+ tooltip.style.left = `${point.x * scale}px`;
223
+ tooltip.style.top = `${point.y * scale}px`;
224
+ tooltip.hidden = echarts;
225
+ if (!pointer && spec.mark.type === 'calendar') {
226
+ const target = point.x * scale;
227
+ if (
228
+ target < canvas.scrollLeft ||
229
+ target > canvas.scrollLeft + canvas.clientWidth
230
+ ) {
231
+ canvas.scrollLeft = target - canvas.clientWidth / 2;
232
+ }
233
+ }
234
+ if (spec.tooltip?.layer === 'top') {
235
+ stop = positionPointTooltip(tooltip, canvas, layout, point, pointer, scale);
236
+ }
237
+ canvas.setAttribute('aria-describedby', tooltip.id);
238
+ const svg = canvas.querySelector('svg');
239
+ if (svg !== null) {
240
+ placeFocusRing(svg, point);
241
+ }
242
+ return stop;
243
+ }
244
+
245
+ function initializeActivity(element, spec, parts, layout, win) {
246
+ if (spec.mark.type === 'calendar') {
247
+ parts.canvas.classList.add('ui-calendar-scroll');
248
+ parts.canvas.setAttribute('role', 'region');
249
+ win.queueMicrotask(() => {
250
+ if (parts.canvas.isConnected) {
251
+ parts.canvas.scrollLeft = parts.canvas.scrollWidth;
252
+ }
253
+ });
254
+ }
255
+ for (const diagnostic of layout.diagnostics) {
256
+ element.dispatchEvent(
257
+ new win.CustomEvent('chart-diagnostic', {
258
+ detail: diagnostic,
259
+ bubbles: true,
260
+ })
261
+ );
262
+ }
263
+ }
264
+
265
+ function calendarMove(element, layout, active, key) {
266
+ if (
267
+ element.spec.mark.type !== 'calendar' ||
268
+ active === null ||
269
+ !key.startsWith('Arrow')
270
+ ) {
271
+ return false;
272
+ }
273
+ const points = navigable(layout)[0].points;
274
+ const delta = { ArrowRight: 7, ArrowLeft: -7, ArrowDown: 1, ArrowUp: -1 }[
275
+ key
276
+ ];
277
+ const index = points.findIndex(
278
+ (point) => point.day === points[active.index].day + delta
279
+ );
280
+ if (index >= 0) {
281
+ element.focusPoint(0, index);
282
+ }
283
+ return true;
284
+ }
285
+
286
+ function toggleParts(parts, show) {
287
+ const { toggle, table } = parts;
288
+ const shown = show ?? toggle.getAttribute('aria-expanded') !== 'true';
289
+ toggle.setAttribute('aria-expanded', String(shown));
290
+ toggle.textContent = toggleText(shown);
291
+ table.classList.toggle('ui-visually-hidden', !shown);
292
+ }
293
+
294
+ function pointerPoint(canvas, layout, event) {
295
+ const svg = canvas.querySelector('svg');
296
+ const box = svg.getBoundingClientRect();
297
+ const scale = svgScale(canvas, layout);
298
+ const x = (event.clientX - box.left) / scale;
299
+ const y = (event.clientY - box.top) / scale;
300
+ const row = event.target.closest?.('[data-row]')?.getAttribute('data-row');
301
+ return row !== undefined && row !== null
302
+ ? (navigable(layout)
303
+ .flatMap((series) => series.points)
304
+ .find((point) => point.row === Number(row)) ??
305
+ nearestPoint(layout, x, y))
306
+ : nearestPoint(layout, x, y);
307
+ }
308
+
309
+ function wireParts(element, document, spec, layout) {
310
+ const parts = createParts(document, spec, layout);
311
+ const { canvas, toggle } = parts;
312
+ toggle.addEventListener('click', () => element.toggleTable());
313
+ canvas.addEventListener('keydown', (event) => element.onKey(event));
314
+ canvas.addEventListener('blur', () => element.hideTooltip());
315
+ canvas.addEventListener('pointermove', (event) => element.onPointer(event));
316
+ canvas.addEventListener('pointerleave', () => element.hideTooltip());
317
+ canvas.addEventListener('focusin', (event) => {
318
+ const row = event.target.getAttribute('data-row');
319
+ if (spec.mark.type === 'range' && row !== null) {
320
+ element.focusPoint(0, Number(row));
321
+ }
322
+ });
323
+ canvas.addEventListener('focusout', (event) => {
324
+ if (!canvas.contains(event.relatedTarget)) {
325
+ element.hideTooltip();
326
+ }
327
+ });
328
+ return parts;
329
+ }
330
+
331
+ /**
332
+ * The `<ui-chart>` class of a window.
333
+ * @param {Window} win
334
+ */
335
+ export function createChartClass(win) {
336
+ return class UiChart extends createChartElementClass(win) {
337
+ /** @type {{series: number, index: number}|null} the active point */
338
+ #active = null;
339
+ #layout = null;
340
+ #parts = null;
341
+ #echarts = null;
342
+ #stopTooltip = null;
343
+
344
+ /** Resolves when the chart (and ECharts, if used) has rendered. */
345
+ ready = Promise.resolve();
346
+
347
+ /** Load ECharts (tests and pages may replace it). */
348
+ loadECharts = undefined;
349
+
350
+ /** The active point (`{series, index, row, text}`) or null. */
351
+ get activePoint() {
352
+ if (this.#active === null || this.#layout === null) {
353
+ return null;
354
+ }
355
+ const series = navigable(this.#layout)[this.#active.series];
356
+ return series?.points[this.#active.index] ?? null;
357
+ }
358
+
359
+ disconnectedCallback() {
360
+ this.hideTooltip();
361
+ this.#echarts?.dispose?.();
362
+ }
363
+
364
+ draw(spec) {
365
+ this.hideTooltip();
366
+ this.#echarts?.dispose?.();
367
+ this.#active = null;
368
+ this.#echarts = null;
369
+ if (spec.kind !== 'chart') {
370
+ this.#layout = null;
371
+ return [drawSmallChart(this.ownerDocument, spec)];
372
+ }
373
+ const document = this.ownerDocument;
374
+ const width = Number(this.getAttribute('width')) || undefined;
375
+ const height = Number(this.getAttribute('height')) || undefined;
376
+ this.#layout = layoutChart(spec, { width, height });
377
+ const parts = wireParts(this, document, spec, this.#layout);
378
+ this.#parts = parts;
379
+ initializeActivity(this, spec, parts, this.#layout, win);
380
+ this.ready =
381
+ spec.renderer === 'echarts' && supportsECharts(spec)
382
+ ? this.useECharts(spec, parts.canvas)
383
+ : Promise.resolve();
384
+ return [parts.figure];
385
+ }
386
+
387
+ /** Show or hide the data table (it is always in the accessibility tree). */
388
+ toggleTable(show) {
389
+ toggleParts(this.#parts, show);
390
+ }
391
+
392
+ onKey(event) {
393
+ const move = MOVES[event.key];
394
+ if (event.key === 'Escape') {
395
+ this.hideTooltip();
396
+ return;
397
+ }
398
+ if (move === undefined || this.#layout === null) {
399
+ return;
400
+ }
401
+ const series = navigable(this.#layout);
402
+ if (series.length === 0) {
403
+ return;
404
+ }
405
+ event.preventDefault();
406
+ if (calendarMove(this, this.#layout, this.#active, event.key)) {
407
+ return;
408
+ }
409
+ const next =
410
+ this.#active === null
411
+ ? {
412
+ series: 0,
413
+ index: event.key === 'End' ? Number.MAX_SAFE_INTEGER : 0,
414
+ }
415
+ : move(this.#active);
416
+ this.focusPoint(next.series, next.index);
417
+ }
418
+
419
+ /**
420
+ * Move to a point (clamped to the chart), show its tooltip and
421
+ * announce its value.
422
+ * @param {number} seriesIndex
423
+ * @param {number} index
424
+ */
425
+ focusPoint(seriesIndex, index) {
426
+ const series = navigable(this.#layout);
427
+ const s = clamp(seriesIndex, 0, series.length - 1);
428
+ const i = clamp(index, 0, series[s].points.length - 1);
429
+ this.#active = { series: s, index: i };
430
+ const point = series[s].points[i];
431
+ this.#parts.live.textContent = announcement(series, s, i);
432
+ this.showTooltip(point);
433
+ if (this.#echarts !== null) {
434
+ const index = this.#layout.series.indexOf(series[s]);
435
+ this.#echarts.dispatchAction({
436
+ type: 'showTip',
437
+ seriesIndex: index,
438
+ dataIndex: i,
439
+ });
440
+ }
441
+ this.dispatchEvent(
442
+ new win.CustomEvent('chart-point', {
443
+ detail: { series: s, index: i, row: point.row, text: point.text },
444
+ bubbles: true,
445
+ })
446
+ );
447
+ }
448
+
449
+ showTooltip(point, pointer = null) {
450
+ this.#stopTooltip = showPointTooltip(
451
+ {
452
+ parts: this.#parts,
453
+ layout: this.#layout,
454
+ spec: this.spec,
455
+ echarts: this.#echarts !== null,
456
+ stop: this.#stopTooltip,
457
+ },
458
+ point,
459
+ pointer
460
+ );
461
+ }
462
+
463
+ hideTooltip() {
464
+ if (this.#parts === null) {
465
+ return;
466
+ }
467
+ this.#stopTooltip?.();
468
+ this.#stopTooltip = null;
469
+ if (this.#parts.tooltip.hasAttribute('popover')) {
470
+ this.#parts.tooltip.hidePopover?.();
471
+ }
472
+ this.#parts.tooltip.hidden = true;
473
+ this.#parts.canvas.querySelector('.ui-chart-focus')?.remove();
474
+ this.#parts.canvas.setAttribute('aria-describedby', this.#parts.hint.id);
475
+ }
476
+
477
+ /** The tooltip of the point nearest the pointer, if close enough. */
478
+ onPointer(event) {
479
+ if (this.#layout === null || this.#echarts !== null) {
480
+ return;
481
+ }
482
+ const point = pointerPoint(this.#parts.canvas, this.#layout, event);
483
+ if (point === null) {
484
+ this.hideTooltip();
485
+ } else {
486
+ this.showTooltip(point, event);
487
+ }
488
+ }
489
+
490
+ /** Replace the SVG with ECharts once the adapter and ECharts load. */
491
+ async useECharts(spec, canvas) {
492
+ const svg = canvas.querySelector('svg');
493
+ try {
494
+ const instance = await mountECharts(canvas, spec, this.#layout, {
495
+ loadECharts: this.loadECharts,
496
+ theme: pageTheme(this, win),
497
+ });
498
+ // The SVG stays as the accessible image; ECharts draws the marks.
499
+ svg.classList.add('ui-visually-hidden');
500
+ this.#echarts = instance;
501
+ this.setAttribute('data-renderer', 'echarts');
502
+ } catch (error) {
503
+ canvas.querySelector('.ui-chart-echarts')?.remove();
504
+ this.dispatchEvent(
505
+ new win.CustomEvent('chart-error', { detail: error, bubbles: true })
506
+ );
507
+ }
508
+ }
509
+ };
510
+ }
511
+
512
+ /**
513
+ * Define `<ui-chart>` in a window, unless the tag is taken.
514
+ * @param {Window} [win]
515
+ * @returns {CustomElementConstructor}
516
+ */
517
+ export const defineChartElement = (win = globalThis.window) =>
518
+ defineElement(win, CHART_TAG, createChartClass);
@@ -0,0 +1,23 @@
1
+ import type { ChartSpec } from './index.js';
2
+
3
+ export interface EChartsOptions {
4
+ theme?: 'light' | 'dark';
5
+ width?: number;
6
+ height?: number;
7
+ }
8
+
9
+ /**
10
+ * The ECharts option of a chart spec: plain data (no functions), the same
11
+ * for the same spec, with the literal chart token colours of the theme.
12
+ */
13
+ export declare function toEChartsOption(
14
+ spec: ChartSpec,
15
+ options?: EChartsOptions
16
+ ): Record<string, unknown>;
17
+
18
+ /** Draw a chart with ECharts, loaded on demand (`import('echarts')`). */
19
+ export declare function renderECharts(
20
+ container: HTMLElement,
21
+ spec: ChartSpec,
22
+ options?: EChartsOptions & { loadECharts?: () => Promise<unknown> }
23
+ ): Promise<{ instance: unknown; option: Record<string, unknown> }>;