@link-foundation/ui-components 0.0.0-stage → 0.1.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,240 @@
1
+ /**
2
+ * The optional ECharts renderer of the chart dialect, for `(renderer
3
+ * echarts)`.
4
+ *
5
+ * `toEChartsOption(spec)` is pure: it turns a chart spec into an ECharts
6
+ * option object (no functions, so it is plain data and can be compared in
7
+ * tests). `renderECharts` loads ECharts with a dynamic `import('echarts')`
8
+ * only when called, so ECharts (an optional peer dependency) is never part
9
+ * of a page that does not use `(renderer echarts)`.
10
+ *
11
+ * The series and their data follow the order of `layoutChart`, so the
12
+ * keyboard points of `<ui-chart>` map to `(seriesIndex, dataIndex)`.
13
+ */
14
+
15
+ import { supportsECharts } from './renderer-features.js';
16
+ import { layoutChart } from './layout.js';
17
+ import {
18
+ continuousValue,
19
+ discreteDomain,
20
+ fieldTitle,
21
+ isDiscrete,
22
+ sizeScale,
23
+ } from './scales.js';
24
+ import { chartLabel } from './summary.js';
25
+ import { CHART_TOKENS, SERIES_COUNT, seriesToken } from './tokens.js';
26
+
27
+ /** The ECharts axis type of a field. */
28
+ function axisType(def) {
29
+ if (isDiscrete(def)) {
30
+ return 'category';
31
+ }
32
+ return def.type === 'temporal' ? 'time' : 'value';
33
+ }
34
+
35
+ /** An axis option of a field. */
36
+ function axisOption(def, rows, colors, zero) {
37
+ const type = axisType(def);
38
+ return {
39
+ type,
40
+ name: fieldTitle(def),
41
+ nameLocation: 'middle',
42
+ nameGap: 32,
43
+ ...(type === 'category' ? { data: discreteDomain(def, rows) } : {}),
44
+ ...(type === 'value' ? { scale: !zero } : {}),
45
+ axisLine: { lineStyle: { color: colors.axis } },
46
+ axisLabel: { color: colors.muted },
47
+ nameTextStyle: { color: colors.text },
48
+ splitLine: { lineStyle: { color: colors.grid } },
49
+ };
50
+ }
51
+
52
+ /** The value of a field on an ECharts axis. */
53
+ const axisValue = (def, value) =>
54
+ isDiscrete(def) ? String(value) : continuousValue(def, value);
55
+
56
+ const SERIES_TYPES = {
57
+ line: 'line',
58
+ area: 'line',
59
+ bar: 'bar',
60
+ point: 'scatter',
61
+ };
62
+
63
+ /** The style options of a mark. */
64
+ function markOptions(spec, stacked) {
65
+ const { mark } = spec;
66
+ return {
67
+ ...(mark.type === 'area' ? { areaStyle: { opacity: 0.35 } } : {}),
68
+ ...(mark.type === 'line' || mark.type === 'area'
69
+ ? {
70
+ showSymbol: mark.point,
71
+ smooth: mark.interpolate === 'monotone',
72
+ ...(mark.interpolate === 'step' ? { step: 'end' } : {}),
73
+ }
74
+ : {}),
75
+ ...(stacked ? { stack: 'total' } : {}),
76
+ };
77
+ }
78
+
79
+ function cartesianSeries(spec, layout, colors) {
80
+ const { x, y, size } = spec.encoding;
81
+ const rows = spec.data.values;
82
+ const radius = sizeScale(size, rows);
83
+ const stacked =
84
+ (spec.mark.type === 'bar' || spec.mark.type === 'area') &&
85
+ spec.encoding.color !== undefined;
86
+ return layout.series.map((series, s) => ({
87
+ type: SERIES_TYPES[spec.mark.type],
88
+ name: series.key ?? fieldTitle(y),
89
+ itemStyle: { color: colors.series[s % SERIES_COUNT] },
90
+ ...markOptions(spec, stacked),
91
+ data: series.points.map((point) => {
92
+ const row = rows[point.row];
93
+ return {
94
+ name: point.text,
95
+ value: [axisValue(x, row[x.field]), axisValue(y, row[y.field])],
96
+ ...(size === undefined
97
+ ? {}
98
+ : { symbolSize: Math.round(radius(row[size.field]) * 2) }),
99
+ };
100
+ }),
101
+ }));
102
+ }
103
+
104
+ function arcSeries(spec, layout, colors) {
105
+ const { theta, color } = spec.encoding;
106
+ const rows = spec.data.values;
107
+ const domain = color === undefined ? [] : discreteDomain(color, rows);
108
+ const radius = Math.min(layout.plot.width, layout.plot.height) / 2;
109
+ return [
110
+ {
111
+ type: 'pie',
112
+ name: fieldTitle(theta),
113
+ radius: [spec.mark.innerRadius, Math.round(radius)],
114
+ label: { color: colors.text },
115
+ data: layout.series[0].points.map((point, i) => {
116
+ const row = rows[point.row];
117
+ const index =
118
+ color === undefined
119
+ ? i
120
+ : Math.max(0, domain.indexOf(String(row[color.field])));
121
+ return {
122
+ name: color === undefined ? point.text : String(row[color.field]),
123
+ value: Number(row[theta.field]),
124
+ tooltip: { formatter: point.text },
125
+ itemStyle: { color: colors.series[index % SERIES_COUNT] },
126
+ };
127
+ }),
128
+ },
129
+ ];
130
+ }
131
+
132
+ /** The colours of a mode as literal values (ECharts cannot read CSS vars). */
133
+ function modeColors(theme) {
134
+ const tokens = CHART_TOKENS[theme] ?? CHART_TOKENS.light;
135
+ return {
136
+ series: Array.from(
137
+ { length: SERIES_COUNT },
138
+ (_, i) => tokens[seriesToken(i)]
139
+ ),
140
+ background: tokens['color.chart.background'],
141
+ text: tokens['color.chart.text'],
142
+ muted: tokens['color.chart.muted'],
143
+ axis: tokens['color.chart.axis'],
144
+ grid: tokens['color.chart.grid'],
145
+ };
146
+ }
147
+
148
+ /**
149
+ * The ECharts option of a chart spec: pure and deterministic.
150
+ * @param {import('./chart-model.js').ChartSpec} spec
151
+ * @param {{theme?: 'light'|'dark', width?: number, height?: number}} [options]
152
+ * @returns {object}
153
+ */
154
+ export function toEChartsOption(spec, options = {}) {
155
+ if (spec.kind !== 'chart') {
156
+ throw new TypeError(`ECharts renders (chart ...) links, not ${spec.kind}`);
157
+ }
158
+ if (!supportsECharts(spec)) {
159
+ throw new TypeError(
160
+ 'Activity features require the SVG renderer; use renderChartSvg or ui-chart'
161
+ );
162
+ }
163
+ const colors = modeColors(options.theme ?? 'light');
164
+ const layout = layoutChart(spec, options);
165
+ const arc = spec.mark.type === 'arc';
166
+ const legend =
167
+ spec.encoding.color === undefined
168
+ ? {}
169
+ : {
170
+ legend: {
171
+ top: spec.title ? 28 : 4,
172
+ textStyle: { color: colors.text },
173
+ },
174
+ };
175
+ const option = {
176
+ animation: false,
177
+ backgroundColor: colors.background,
178
+ color: colors.series,
179
+ textStyle: { color: colors.text },
180
+ aria: { enabled: true, label: { description: chartLabel(spec) } },
181
+ ...(spec.title
182
+ ? { title: { text: spec.title, textStyle: { color: colors.text } } }
183
+ : {}),
184
+ tooltip: { trigger: 'item', formatter: '{b}' },
185
+ ...legend,
186
+ series: arc
187
+ ? arcSeries(spec, layout, colors)
188
+ : cartesianSeries(spec, layout, colors),
189
+ };
190
+ if (!arc) {
191
+ const filled = spec.mark.type === 'bar' || spec.mark.type === 'area';
192
+ const horizontal = spec.mark.type === 'bar' && isDiscrete(spec.encoding.y);
193
+ const rows = spec.data.values;
194
+ option.grid = {
195
+ left: layout.plot.x,
196
+ top: layout.plot.y,
197
+ width: layout.plot.width,
198
+ height: layout.plot.height,
199
+ };
200
+ option.xAxis = axisOption(
201
+ spec.encoding.x,
202
+ rows,
203
+ colors,
204
+ filled && horizontal
205
+ );
206
+ option.yAxis = axisOption(
207
+ spec.encoding.y,
208
+ rows,
209
+ colors,
210
+ filled && !horizontal
211
+ );
212
+ }
213
+ return option;
214
+ }
215
+
216
+ /**
217
+ * Render a chart spec with ECharts into a container, loading ECharts on
218
+ * first use.
219
+ * @param {HTMLElement} container sized to the chart
220
+ * @param {import('./chart-model.js').ChartSpec} spec
221
+ * @param {object} [options]
222
+ * @param {() => Promise<object>} [options.loadECharts] default `import('echarts')`
223
+ * @param {'light'|'dark'} [options.theme]
224
+ * @param {number} [options.width]
225
+ * @param {number} [options.height]
226
+ * @returns {Promise<{instance: object, option: object}>}
227
+ */
228
+ export async function renderECharts(container, spec, options = {}) {
229
+ const load = options.loadECharts ?? (() => import('echarts'));
230
+ const module = await load();
231
+ const echarts = module.init === undefined ? module.default : module;
232
+ const option = toEChartsOption(spec, options);
233
+ const instance = echarts.init(container, null, {
234
+ renderer: 'svg',
235
+ width: options.width ?? spec.width ?? undefined,
236
+ height: options.height ?? spec.height ?? undefined,
237
+ });
238
+ instance.setOption(option);
239
+ return { instance, option };
240
+ }
@@ -0,0 +1,330 @@
1
+ /**
2
+ * The shared base of the chart custom elements (`<ui-chart>`,
3
+ * `<ui-stat-tile>`, `<ui-gauge>`, `<ui-sparkline>`): where the spec comes
4
+ * from, the chart style sheet, the data table twin and error reporting.
5
+ *
6
+ * The elements render into their light DOM, so page styles and the token
7
+ * custom properties apply. Every element is built for a given window (a
8
+ * browser window, or a jsdom window in tests), so nothing touches globals.
9
+ */
10
+
11
+ import { drawTagCloud } from './tag-cloud.js';
12
+ import { chartFromLinks, chartToLino, parseChart } from './chart-model.js';
13
+ import { atomNode, formatNode, parseLino, prop } from './lino.js';
14
+ import { renderSmallChartSvg } from './small-svg.js';
15
+ import { chartTable } from './summary.js';
16
+ import { CHART_CSS } from './tokens.js';
17
+
18
+ /** The `<script>` type of an inline spec: `<script type="text/lino">`. */
19
+ export const LINO_SCRIPT_TYPE = 'text/lino';
20
+
21
+ const counters = new WeakMap();
22
+
23
+ /** An ID that is unique in the document: `ui-chart-1`, `ui-chart-2`... */
24
+ export function uniqueId(document, prefix = 'ui-chart') {
25
+ const next = (counters.get(document) ?? 0) + 1;
26
+ counters.set(document, next);
27
+ return `${prefix}-${next}`;
28
+ }
29
+
30
+ /** Add the chart style sheet to the document once. */
31
+ export function ensureChartStyles(document) {
32
+ if (document.querySelector('style[data-ui-chart]') !== null) {
33
+ return;
34
+ }
35
+ const style = document.createElement('style');
36
+ style.setAttribute('data-ui-chart', '');
37
+ style.textContent = CHART_CSS;
38
+ (document.head ?? document.documentElement).append(style);
39
+ }
40
+
41
+ /**
42
+ * The data table twin of a chart: a caption, column headers, and one row
43
+ * per data row. Built with DOM methods, so every value is text.
44
+ * @param {Document} document
45
+ * @param {object} spec
46
+ * @param {string} id
47
+ */
48
+ export function createTable(document, spec, id) {
49
+ const { caption, columns, numeric, rows } = chartTable(spec);
50
+ const table = document.createElement('table');
51
+ table.id = id;
52
+ table.className = 'ui-chart-table';
53
+ table.setAttribute('role', 'table');
54
+ const captionEl = document.createElement('caption');
55
+ captionEl.textContent = caption;
56
+ const head = document.createElement('thead');
57
+ const headRow = document.createElement('tr');
58
+ for (const column of columns) {
59
+ const th = document.createElement('th');
60
+ th.scope = 'col';
61
+ th.textContent = column;
62
+ headRow.append(th);
63
+ }
64
+ head.append(headRow);
65
+ const body = document.createElement('tbody');
66
+ for (const row of rows) {
67
+ const tr = document.createElement('tr');
68
+ row.forEach((value, i) => {
69
+ const td = document.createElement('td');
70
+ td.textContent = value;
71
+ if (numeric[i]) {
72
+ td.style.textAlign = 'end';
73
+ }
74
+ tr.append(td);
75
+ });
76
+ body.append(tr);
77
+ }
78
+ table.append(captionEl, head, body);
79
+ return table;
80
+ }
81
+
82
+ /** A `<div>` with a class name. */
83
+ export function div(document, className) {
84
+ const el = document.createElement('div');
85
+ el.className = className;
86
+ return el;
87
+ }
88
+
89
+ /**
90
+ * The base class of the chart elements in a window. Subclasses set
91
+ * `static kinds` (the chart kinds they show) and implement `draw(spec)`,
92
+ * which returns the nodes to show.
93
+ * @param {Window} win
94
+ */
95
+ export function createChartElementClass(win) {
96
+ return class ChartElement extends win.HTMLElement {
97
+ /** @type {string[]|null} the kinds this element shows; null: any */
98
+ static kinds = null;
99
+
100
+ #lino = null;
101
+ #spec = null;
102
+ #rendered = null;
103
+ #output = [];
104
+
105
+ /** The LiNo text of the chart; setting it renders the element again. */
106
+ get lino() {
107
+ return this.#lino ?? this.inlineLino();
108
+ }
109
+
110
+ set lino(text) {
111
+ this.#lino = text === null ? null : String(text);
112
+ this.#spec = null;
113
+ this.update();
114
+ }
115
+
116
+ /** The normalised spec shown (`null` before the first render). */
117
+ get spec() {
118
+ return this.#rendered;
119
+ }
120
+
121
+ /** Show a spec object (as `chartFromLinks` returns). */
122
+ set spec(spec) {
123
+ this.#spec = spec;
124
+ this.#lino = null;
125
+ this.update();
126
+ }
127
+
128
+ connectedCallback() {
129
+ if (this.#rendered === null) {
130
+ this.update();
131
+ }
132
+ }
133
+
134
+ /** The text of the inline `<script type="text/lino">` child, or null. */
135
+ inlineLino() {
136
+ const script = [...this.children].find(
137
+ (child) =>
138
+ child.localName === 'script' &&
139
+ child.getAttribute('type') === LINO_SCRIPT_TYPE
140
+ );
141
+ return script === undefined ? null : script.textContent;
142
+ }
143
+
144
+ /** LiNo text built from the attributes (small charts), or null. */
145
+ attributeLino() {
146
+ return null;
147
+ }
148
+
149
+ /** The spec to show, read and checked by the chart model. */
150
+ readSpec() {
151
+ if (this.#spec !== null) {
152
+ // Normalise (and check) a spec object by writing and reading it.
153
+ const normalized = parseChart(chartToLino(this.#spec));
154
+ if (this.#spec.tooltip?.content) {
155
+ normalized.tooltip = {
156
+ ...normalized.tooltip,
157
+ content: this.#spec.tooltip.content,
158
+ };
159
+ }
160
+ return normalized;
161
+ }
162
+ const text = this.lino ?? this.attributeLino();
163
+ if (text === null) {
164
+ return null;
165
+ }
166
+ const spec = chartFromLinks(parseLino(text));
167
+ const { kinds } = this.constructor;
168
+ if (kinds !== null && !kinds.includes(spec.kind)) {
169
+ throw new TypeError(
170
+ `<${this.localName}> shows ${kinds.join(', ')}, not ${spec.kind}`
171
+ );
172
+ }
173
+ return spec;
174
+ }
175
+
176
+ /** Render the element again from its current source. */
177
+ update() {
178
+ const document = this.ownerDocument;
179
+ ensureChartStyles(document);
180
+ this.#output.forEach((node) => node.remove());
181
+ let spec;
182
+ try {
183
+ spec = this.readSpec();
184
+ } catch (error) {
185
+ this.#rendered = null;
186
+ this.show([this.errorNode(error)]);
187
+ this.dispatchEvent(
188
+ new win.CustomEvent('chart-error', { detail: error, bubbles: true })
189
+ );
190
+ return;
191
+ }
192
+ this.#rendered = spec;
193
+ this.show(spec === null ? [] : this.draw(spec));
194
+ }
195
+
196
+ /** Append the rendered nodes, remembering them for the next update. */
197
+ show(nodes) {
198
+ this.#output = nodes;
199
+ this.append(...nodes);
200
+ }
201
+
202
+ /** The message of a spec that cannot be shown. */
203
+ errorNode(error) {
204
+ const p = this.ownerDocument.createElement('p');
205
+ p.className = 'ui-chart-error';
206
+ p.setAttribute('role', 'alert');
207
+ p.textContent = `Chart error: ${error.message}`;
208
+ return p;
209
+ }
210
+
211
+ /**
212
+ * The nodes of a spec.
213
+ * @param {object} spec
214
+ * @returns {Node[]}
215
+ */
216
+ // eslint-disable-next-line no-unused-vars
217
+ draw(spec) {
218
+ return [];
219
+ }
220
+ };
221
+ }
222
+
223
+ /**
224
+ * Define a custom element in a window unless the tag is taken.
225
+ * @param {Window} win
226
+ * @param {string} tag
227
+ * @param {(win: Window) => CustomElementConstructor} create
228
+ */
229
+ export function defineElement(win, tag, create) {
230
+ const registry = win?.customElements;
231
+ if (registry === undefined) {
232
+ throw new TypeError('defineChartElements needs a window');
233
+ }
234
+ const existing = registry.get(tag);
235
+ if (existing !== undefined) {
236
+ return existing;
237
+ }
238
+ const constructor = create(win);
239
+ registry.define(tag, constructor);
240
+ return constructor;
241
+ }
242
+
243
+ /**
244
+ * LiNo text of a small chart from element attributes: `(id: kind (name
245
+ * value...) ...)`. Written with the links-notation writer, so attribute
246
+ * values are escaped, and read back by the chart model, which checks them.
247
+ * @param {Element} element
248
+ * @param {string} kind
249
+ * @param {string[]} names the attributes, in order
250
+ * @param {string[]} [lists] the attributes that hold numbers split by spaces
251
+ * @returns {string|null} null when none of the attributes is set
252
+ */
253
+ export function attributesLino(element, kind, names, lists = []) {
254
+ const props = names
255
+ .filter((name) => element.hasAttribute(name))
256
+ .map((name) => {
257
+ const value = element.getAttribute(name);
258
+ return lists.includes(name)
259
+ ? prop(name, ...value.split(/\s+/u).filter(Boolean))
260
+ : prop(name, value);
261
+ });
262
+ if (props.length === 0) {
263
+ return null;
264
+ }
265
+ const id = element.id === '' ? kind : element.id;
266
+ return formatNode({ id, values: [atomNode(kind), ...props] });
267
+ }
268
+
269
+ /**
270
+ * A small chart (stat tile, gauge, sparkline): its SVG and a visually
271
+ * hidden data table twin in a box.
272
+ * @param {Document} document
273
+ * @param {object} spec
274
+ * @param {string} [className]
275
+ * @param {string} [tag]
276
+ */
277
+ export function drawSmallChart(
278
+ document,
279
+ spec,
280
+ className = `ui-${spec.kind}`,
281
+ tag = 'div'
282
+ ) {
283
+ const box = document.createElement(tag);
284
+ box.className = className;
285
+ if (spec.kind === 'tag-cloud') {
286
+ box.append(drawTagCloud(document, spec));
287
+ } else {
288
+ box.innerHTML = renderSmallChartSvg(spec);
289
+ }
290
+ if (spec.footnote) {
291
+ const link = document.createElement('a');
292
+ link.textContent = spec.footnote.label;
293
+ link.href = spec.footnote.href;
294
+ box.append(link);
295
+ }
296
+ const table = createTable(document, spec, uniqueId(document));
297
+ table.classList.add('ui-visually-hidden');
298
+ box.append(table);
299
+ return box;
300
+ }
301
+
302
+ /**
303
+ * The class of a small chart element (`<ui-stat-tile>`, `<ui-gauge>`,
304
+ * `<ui-sparkline>`): its SVG (`role="img"` with an accessible name) and a
305
+ * visually hidden data table twin.
306
+ * @param {Window} win
307
+ * @param {{kind: string, className: string, names: string[], lists?: string[], tag?: string}} options
308
+ */
309
+ export function createSmallChartClass(win, options) {
310
+ const { kind, className, names, lists = [], tag = 'div' } = options;
311
+ return class SmallChartElement extends createChartElementClass(win) {
312
+ static kinds = [kind];
313
+
314
+ static observedAttributes = names;
315
+
316
+ attributeChangedCallback() {
317
+ if (this.isConnected) {
318
+ this.update();
319
+ }
320
+ }
321
+
322
+ attributeLino() {
323
+ return attributesLino(this, kind, names, lists);
324
+ }
325
+
326
+ draw(spec) {
327
+ return [drawSmallChart(this.ownerDocument, spec, className, tag)];
328
+ }
329
+ };
330
+ }
@@ -0,0 +1,62 @@
1
+ /**
2
+ * The error of a chart spec that cannot be read, with the position of the
3
+ * bad link so an author can find it.
4
+ */
5
+
6
+ import { formatNode } from './lino.js';
7
+
8
+ /**
9
+ * The position of a link: its index path in the unfolded tree of the
10
+ * document (`[0, 3, 1]` is the second value of the fourth value of the
11
+ * first top-level link) and its LiNo text.
12
+ * @typedef {{ path: number[], link: string|null }} LinkPosition
13
+ */
14
+
15
+ /**
16
+ * A position of a node.
17
+ * @param {number[]} path
18
+ * @param {import('./lino.js').Node} [node]
19
+ * @returns {LinkPosition}
20
+ */
21
+ export const at = (path, node) => ({
22
+ path: [...path],
23
+ link: node === undefined ? null : formatNode(node),
24
+ });
25
+
26
+ /** The position as text: `link 1 > 4 > 2: (mark pie)` (1-based). */
27
+ export function describePosition({ path, link }) {
28
+ const where =
29
+ path.length === 0
30
+ ? 'document'
31
+ : `link ${path.map((i) => i + 1).join(' > ')}`;
32
+ return link === null ? where : `${where}: ${link}`;
33
+ }
34
+
35
+ /** A chart spec that cannot be read. */
36
+ export class ChartSpecError extends Error {
37
+ /**
38
+ * @param {string} code a stable machine-readable reason (`unknown-mark`)
39
+ * @param {string} reason the human-readable reason
40
+ * @param {LinkPosition} position where the bad link is
41
+ */
42
+ constructor(code, reason, position) {
43
+ super(`${reason} (at ${describePosition(position)})`);
44
+ this.name = 'ChartSpecError';
45
+ this.code = code;
46
+ this.reason = reason;
47
+ this.path = position.path;
48
+ this.link = position.link;
49
+ }
50
+ }
51
+
52
+ /**
53
+ * Throw a ChartSpecError at a node.
54
+ * @param {string} code
55
+ * @param {string} reason
56
+ * @param {import('./lino.js').Node} node
57
+ * @param {number[]} path
58
+ * @returns {never}
59
+ */
60
+ export function fail(code, reason, node, path) {
61
+ throw new ChartSpecError(code, reason, at(path, node));
62
+ }
@@ -0,0 +1,27 @@
1
+ /**
2
+ * The `<ui-gauge>` element: a gauge chart (`(id: gauge ...)`) as SVG with
3
+ * `role="img"`, an accessible name and a visually hidden data table twin.
4
+ * The spec is an inline `<script type="text/lino">` child, the `lino` or
5
+ * `spec` property, or the attributes ('label', 'value', 'min', 'max', 'unit', 'description').
6
+ */
7
+
8
+ import { createSmallChartClass, defineElement } from './element.js';
9
+
10
+ /** The tag of the element. */
11
+ export const GAUGE_TAG = 'ui-gauge';
12
+
13
+ /**
14
+ * Define `<ui-gauge>` in a window, unless the tag is taken.
15
+ * @param {Window} [win]
16
+ * @returns {CustomElementConstructor}
17
+ */
18
+ export const defineGaugeElement = (win = globalThis.window) =>
19
+ defineElement(win, GAUGE_TAG, (w) =>
20
+ createSmallChartClass(w, {
21
+ kind: 'gauge',
22
+ className: 'ui-gauge',
23
+ names: ['label', 'value', 'min', 'max', 'unit', 'description'],
24
+ lists: [],
25
+ tag: 'div',
26
+ })
27
+ );