@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,269 @@
1
+ /**
2
+ * SVG of the small charts: the gauge dial, the sparkline, and the stat
3
+ * tile card (value, change and trend). Deterministic, like the chart SVG.
4
+ */
5
+
6
+ import { arc as d3Arc, area as d3Area, line as d3Line } from 'd3-shape';
7
+ import { scaleBand, scaleLinear } from 'd3-scale';
8
+ import { chartLabel, deltaText, withUnit } from './summary.js';
9
+ import { el, paint, svgRoot, text } from './svg.js';
10
+ import { tokenColor } from './tokens.js';
11
+ import { formatNumber } from './values.js';
12
+
13
+ /**
14
+ * The marks of a sparkline in a box.
15
+ * @param {number[]} values
16
+ * @param {'line'|'area'|'bar'} mark
17
+ * @param {{x: number, y: number, width: number, height: number}} box
18
+ * @param {string} color
19
+ */
20
+ export function sparklineMarks(values, mark, box, color) {
21
+ const low = Math.min(0, ...values);
22
+ const high = Math.max(...values, low + 1);
23
+ const y = scaleLinear(
24
+ [mark === 'line' ? Math.min(...values) : low, high],
25
+ [box.y + box.height, box.y]
26
+ );
27
+ if (mark === 'bar') {
28
+ const x = scaleBand(
29
+ values.map((_, i) => i),
30
+ [box.x, box.x + box.width]
31
+ ).padding(0.2);
32
+ return values.map((value, i) =>
33
+ el('rect', {
34
+ x: x(i),
35
+ y: Math.min(y(value), y(0)),
36
+ width: x.bandwidth(),
37
+ height: Math.abs(y(value) - y(0)),
38
+ style: paint('fill', color),
39
+ })
40
+ );
41
+ }
42
+ const x = scaleLinear(
43
+ [0, Math.max(1, values.length - 1)],
44
+ [box.x, box.x + box.width]
45
+ );
46
+ const points = values.map((value, i) => [x(i), y(value)]);
47
+ const line = d3Line().digits(2);
48
+ const marks = [];
49
+ if (mark === 'area') {
50
+ const area = d3Area()
51
+ .y0(box.y + box.height)
52
+ .digits(2);
53
+ marks.push(
54
+ el('path', {
55
+ d: area(points),
56
+ style: `${paint('fill', color)};fill-opacity:0.3`,
57
+ })
58
+ );
59
+ }
60
+ const [lastX, lastY] = points.at(-1);
61
+ marks.push(
62
+ el('path', {
63
+ d: line(points),
64
+ fill: 'none',
65
+ 'stroke-width': 1.5,
66
+ style: paint('stroke', color),
67
+ }),
68
+ el('circle', { cx: lastX, cy: lastY, r: 2, style: paint('fill', color) })
69
+ );
70
+ return marks;
71
+ }
72
+
73
+ function sparklineSvg(spec, options) {
74
+ const width = options.width ?? 120;
75
+ const height = options.height ?? 32;
76
+ const color = tokenColor('color.chart.1', options.tokens ?? null);
77
+ return svgRoot(
78
+ {
79
+ width,
80
+ height,
81
+ label: chartLabel(spec),
82
+ title: spec.label,
83
+ className: 'ui-sparkline-svg',
84
+ },
85
+ sparklineMarks(
86
+ spec.values,
87
+ spec.mark,
88
+ { x: 2, y: 3, width: width - 4, height: height - 6 },
89
+ color
90
+ )
91
+ );
92
+ }
93
+
94
+ function gaugeSvg(spec, options) {
95
+ const tokens = options.tokens ?? null;
96
+ const width = options.width ?? 200;
97
+ const height = options.height ?? 132;
98
+ const radius = Math.min(width / 2 - 12, height - 40);
99
+ const cx = width / 2;
100
+ const cy = radius + 12;
101
+ const share = Math.min(
102
+ 1,
103
+ Math.max(0, (spec.value - spec.min) / (spec.max - spec.min))
104
+ );
105
+ const start = -Math.PI / 2;
106
+ const arc = d3Arc()
107
+ .innerRadius(radius * 0.72)
108
+ .outerRadius(radius)
109
+ .cornerRadius(2)
110
+ .digits(2);
111
+ const muted = tokenColor('color.chart.muted', tokens);
112
+ const textColor = tokenColor('color.chart.text', tokens);
113
+ return svgRoot(
114
+ {
115
+ width,
116
+ height,
117
+ label: chartLabel(spec),
118
+ title: spec.label,
119
+ className: 'ui-gauge-svg',
120
+ },
121
+ [
122
+ el('g', { transform: `translate(${cx},${cy})`, 'aria-hidden': 'true' }, [
123
+ el('path', {
124
+ d: arc({ startAngle: start, endAngle: Math.PI / 2 }),
125
+ style: paint('fill', tokenColor('color.chart.grid', tokens)),
126
+ }),
127
+ el('path', {
128
+ class: 'ui-gauge-value',
129
+ d: arc({ startAngle: start, endAngle: start + share * Math.PI }),
130
+ style: paint('fill', tokenColor('color.chart.1', tokens)),
131
+ }),
132
+ text(
133
+ {
134
+ x: 0,
135
+ y: -4,
136
+ 'text-anchor': 'middle',
137
+ 'font-size': 22,
138
+ 'font-weight': 600,
139
+ style: paint('fill', textColor),
140
+ },
141
+ withUnit(spec.value, spec.unit)
142
+ ),
143
+ text(
144
+ {
145
+ x: -radius * 0.86,
146
+ y: 16,
147
+ 'text-anchor': 'middle',
148
+ 'font-size': 11,
149
+ style: paint('fill', muted),
150
+ },
151
+ formatNumber(spec.min)
152
+ ),
153
+ text(
154
+ {
155
+ x: radius * 0.86,
156
+ y: 16,
157
+ 'text-anchor': 'middle',
158
+ 'font-size': 11,
159
+ style: paint('fill', muted),
160
+ },
161
+ formatNumber(spec.max)
162
+ ),
163
+ ]),
164
+ spec.label
165
+ ? text(
166
+ {
167
+ x: cx,
168
+ y: height - 8,
169
+ 'text-anchor': 'middle',
170
+ 'font-size': 13,
171
+ style: paint('fill', textColor),
172
+ 'aria-hidden': 'true',
173
+ },
174
+ spec.label
175
+ )
176
+ : '',
177
+ ]
178
+ );
179
+ }
180
+
181
+ const ARROWS = { up: '▲', down: '▼', unchanged: '■' };
182
+
183
+ /** The arrow of a change: ▲ up, ▼ down, ■ unchanged. */
184
+ export const deltaArrow = (delta) => {
185
+ if (delta > 0) {
186
+ return ARROWS.up;
187
+ }
188
+ return delta < 0 ? ARROWS.down : ARROWS.unchanged;
189
+ };
190
+
191
+ function statTileSvg(spec, options) {
192
+ const tokens = options.tokens ?? null;
193
+ const width = options.width ?? 220;
194
+ const height = options.height ?? (spec.hint ? 128 : 104);
195
+ const textColor = tokenColor('color.chart.text', tokens);
196
+ const muted = tokenColor('color.chart.muted', tokens);
197
+ const children = [
198
+ text(
199
+ { x: 12, y: 22, 'font-size': 13, style: paint('fill', muted) },
200
+ spec.label ?? ''
201
+ ),
202
+ text(
203
+ {
204
+ x: 12,
205
+ y: 52,
206
+ 'font-size': 26,
207
+ 'font-weight': 600,
208
+ style: paint('fill', textColor),
209
+ },
210
+ spec.notation === 'compact' &&
211
+ Math.abs(spec.value) >= (spec.compactThreshold ?? 10000)
212
+ ? `${new Intl.NumberFormat('en-US', { notation: 'compact', maximumFractionDigits: 0 }).format(spec.value)}${spec.unit ? ` ${spec.unit}` : ''}`
213
+ : withUnit(spec.value, spec.unit)
214
+ ),
215
+ ];
216
+ if (spec.delta !== null) {
217
+ children.push(
218
+ text(
219
+ { x: 12, y: 76, 'font-size': 13, style: paint('fill', textColor) },
220
+ `${deltaArrow(spec.delta)} ${deltaText(spec.delta)}`
221
+ )
222
+ );
223
+ }
224
+ if (spec.trend.length > 1) {
225
+ children.push(
226
+ ...sparklineMarks(
227
+ spec.trend,
228
+ 'line',
229
+ { x: width - 92, y: 62, width: 80, height: 28 },
230
+ tokenColor('color.chart.1', tokens)
231
+ )
232
+ );
233
+ }
234
+ if (spec.hint) {
235
+ children.push(
236
+ text(
237
+ { x: 12, y: height - 8, 'font-size': 12, style: paint('fill', muted) },
238
+ spec.hint
239
+ )
240
+ );
241
+ }
242
+ return svgRoot(
243
+ {
244
+ width,
245
+ height,
246
+ label: chartLabel(spec),
247
+ title:
248
+ spec.notation === 'compact'
249
+ ? `${spec.label ?? 'Value'}: ${spec.value}`
250
+ : spec.label,
251
+ className: 'ui-stat-tile-svg',
252
+ },
253
+ [el('g', { 'aria-hidden': 'true' }, children)]
254
+ );
255
+ }
256
+
257
+ const RENDERERS = {
258
+ gauge: gaugeSvg,
259
+ 'stat-tile': statTileSvg,
260
+ sparkline: sparklineSvg,
261
+ };
262
+
263
+ /**
264
+ * A small chart spec as an SVG string.
265
+ * @param {import('./small-model.js').SmallChartSpec} spec
266
+ * @param {{width?: number, height?: number, tokens?: Record<string, string>|Map<string, string>|null}} [options]
267
+ */
268
+ export const renderSmallChartSvg = (spec, options = {}) =>
269
+ RENDERERS[spec.kind](spec, options);
@@ -0,0 +1,27 @@
1
+ /**
2
+ * The `<ui-sparkline>` element: a sparkline chart (`(id: sparkline ...)`) 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', 'values', 'mark', 'description').
6
+ */
7
+
8
+ import { createSmallChartClass, defineElement } from './element.js';
9
+
10
+ /** The tag of the element. */
11
+ export const SPARKLINE_TAG = 'ui-sparkline';
12
+
13
+ /**
14
+ * Define `<ui-sparkline>` in a window, unless the tag is taken.
15
+ * @param {Window} [win]
16
+ * @returns {CustomElementConstructor}
17
+ */
18
+ export const defineSparklineElement = (win = globalThis.window) =>
19
+ defineElement(win, SPARKLINE_TAG, (w) =>
20
+ createSmallChartClass(w, {
21
+ kind: 'sparkline',
22
+ className: 'ui-sparkline',
23
+ names: ['label', 'values', 'mark', 'description'],
24
+ lists: ['values'],
25
+ tag: 'span',
26
+ })
27
+ );
@@ -0,0 +1,37 @@
1
+ /**
2
+ * The `<ui-stat-tile>` element: a stat-tile chart (`(id: stat-tile ...)`) 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', 'unit', 'delta', 'trend', 'description').
6
+ */
7
+
8
+ import { createSmallChartClass, defineElement } from './element.js';
9
+
10
+ /** The tag of the element. */
11
+ export const STAT_TILE_TAG = 'ui-stat-tile';
12
+
13
+ /**
14
+ * Define `<ui-stat-tile>` in a window, unless the tag is taken.
15
+ * @param {Window} [win]
16
+ * @returns {CustomElementConstructor}
17
+ */
18
+ export const defineStatTileElement = (win = globalThis.window) =>
19
+ defineElement(win, STAT_TILE_TAG, (w) =>
20
+ createSmallChartClass(w, {
21
+ kind: 'stat-tile',
22
+ className: 'ui-stat-tile',
23
+ names: [
24
+ 'label',
25
+ 'value',
26
+ 'unit',
27
+ 'delta',
28
+ 'trend',
29
+ 'description',
30
+ 'notation',
31
+ 'compact-threshold',
32
+ 'hint',
33
+ ],
34
+ lists: ['trend'],
35
+ tag: 'div',
36
+ })
37
+ );
@@ -0,0 +1,193 @@
1
+ /**
2
+ * Text alternatives of a chart: a one-sentence summary, the accessible
3
+ * name, and the data table twin that every chart element carries.
4
+ */
5
+
6
+ import { fieldTitle, formatValue } from './scales.js';
7
+ import { formatNumber } from './values.js';
8
+
9
+ const MARK_NAMES = {
10
+ calendar: 'Calendar heatmap',
11
+ range: 'Range timeline',
12
+ composition: 'Composition bar',
13
+ line: 'Line chart',
14
+ area: 'Area chart',
15
+ bar: 'Bar chart',
16
+ point: 'Scatter plot',
17
+ arc: 'Pie chart',
18
+ };
19
+
20
+ /** `12` or `12 %` or `30,200 USD`. */
21
+ export const withUnit = (value, unit) =>
22
+ unit === null || unit === undefined
23
+ ? formatNumber(value)
24
+ : `${formatNumber(value)} ${unit}`;
25
+
26
+ /** The range of a quantitative field as text. */
27
+ function rangeText(spec, def) {
28
+ const values = spec.data.values.map((row) => Number(row[def.field]));
29
+ const low = Math.min(...values);
30
+ const high = Math.max(...values);
31
+ return `${fieldTitle(def)} from ${formatValue(def, low)} to ${formatValue(def, high)}`;
32
+ }
33
+
34
+ function summarizeMarkChart(spec) {
35
+ const { x, y, theta, color } = spec.encoding;
36
+ const count = spec.data.values.length;
37
+ const name =
38
+ spec.mark.type === 'arc' && spec.mark.innerRadius > 0
39
+ ? 'Donut chart'
40
+ : MARK_NAMES[spec.mark.type];
41
+ const parts = ['arc', 'composition'].includes(spec.mark.type)
42
+ ? [
43
+ `${name} of ${fieldTitle(theta)}${color ? ` by ${fieldTitle(color)}` : ''}`,
44
+ ]
45
+ : [`${name} of ${fieldTitle(y)} by ${fieldTitle(x)}`];
46
+ if (color && spec.mark.type !== 'arc') {
47
+ const series = new Set(
48
+ spec.data.values.map((row) => String(row[color.field]))
49
+ );
50
+ parts.push(`${series.size} series by ${fieldTitle(color)}`);
51
+ }
52
+ parts.push(`${count} ${count === 1 ? 'value' : 'values'}`);
53
+ const measured = [x, y, theta].find((def) => def?.type === 'quantitative');
54
+ if (measured !== undefined && spec.mark.type !== 'arc') {
55
+ parts.push(rangeText(spec, measured));
56
+ }
57
+ return `${parts.join(', ')}.`;
58
+ }
59
+
60
+ const trendWord = (delta) => {
61
+ if (delta > 0) {
62
+ return 'up';
63
+ }
64
+ return delta < 0 ? 'down' : 'unchanged';
65
+ };
66
+
67
+ /** A delta in percent as text: `up 12.5 %`. */
68
+ export const deltaText = (delta) =>
69
+ delta === 0
70
+ ? 'unchanged'
71
+ : `${trendWord(delta)} ${formatNumber(Math.abs(delta))} %`;
72
+
73
+ const SMALL_SUMMARIES = {
74
+ gauge: (spec) =>
75
+ `${spec.label ?? 'Gauge'}: ${withUnit(spec.value, spec.unit)} of a range from ${formatNumber(spec.min)} to ${formatNumber(spec.max)}.`,
76
+ 'stat-tile': (spec) =>
77
+ `${spec.label ?? 'Value'}: ${withUnit(spec.value, spec.unit)}${spec.delta === null ? '' : `, ${deltaText(spec.delta)}`}.`,
78
+ sparkline: (spec) => {
79
+ const { values } = spec;
80
+ return `${spec.label ?? 'Trend'}: ${values.length} values from ${formatNumber(values[0])} to ${formatNumber(values.at(-1))}, lowest ${formatNumber(Math.min(...values))}, highest ${formatNumber(Math.max(...values))}.`;
81
+ },
82
+ };
83
+
84
+ /**
85
+ * A one-sentence summary of what a chart shows, computed from its data.
86
+ * @param {import('./chart-model.js').ChartSpec|import('./small-model.js').SmallChartSpec} spec
87
+ */
88
+ export function summarizeChart(spec) {
89
+ if (spec.kind === 'tag-cloud') {
90
+ return `${spec.label ?? 'Tags'}: ${spec.items.length} items.`;
91
+ }
92
+ const small = SMALL_SUMMARIES[spec.kind];
93
+ return small === undefined ? summarizeMarkChart(spec) : small(spec);
94
+ }
95
+
96
+ /**
97
+ * The accessible name of a chart: its description, else its title (or
98
+ * label), else the summary. Never empty.
99
+ */
100
+ export function chartLabel(spec) {
101
+ if (spec.kind === 'stat-tile' && spec.notation === 'compact') {
102
+ return `${spec.description ?? spec.label ?? 'Value'}: ${spec.value}${spec.unit ? ` ${spec.unit}` : ''}${spec.hint ? `, ${spec.hint}` : ''}`;
103
+ }
104
+ for (const text of [spec.description, spec.title, spec.label]) {
105
+ if (typeof text === 'string' && text.trim() !== '') {
106
+ return text;
107
+ }
108
+ }
109
+ return summarizeChart(spec);
110
+ }
111
+
112
+ /** The columns of a mark chart: every encoded field, then the others. */
113
+ function markColumns(spec) {
114
+ const encoded = ['x', 'x2', 'theta', 'color', 'y', 'size']
115
+ .map((name) => spec.encoding[name])
116
+ .concat(spec.encoding.tooltip ?? [])
117
+ .filter(Boolean);
118
+ const columns = [];
119
+ const seen = new Set();
120
+ for (const def of encoded) {
121
+ if (!seen.has(def.field)) {
122
+ seen.add(def.field);
123
+ columns.push(def);
124
+ }
125
+ }
126
+ return columns;
127
+ }
128
+
129
+ function markTable(spec) {
130
+ const columns = markColumns(spec);
131
+ return {
132
+ columns: columns.map(fieldTitle),
133
+ numeric: columns.map((def) => def.type === 'quantitative'),
134
+ rows: spec.data.values.map((row) =>
135
+ columns.map((def) =>
136
+ row[def.field] === undefined || row[def.field] === 'ongoing'
137
+ ? 'ongoing'
138
+ : formatValue(def, row[def.field])
139
+ )
140
+ ),
141
+ };
142
+ }
143
+
144
+ const SMALL_TABLES = {
145
+ gauge: (spec) => ({
146
+ columns: ['Value', 'Minimum', 'Maximum'],
147
+ numeric: [true, true, true],
148
+ rows: [
149
+ [
150
+ withUnit(spec.value, spec.unit),
151
+ formatNumber(spec.min),
152
+ formatNumber(spec.max),
153
+ ],
154
+ ],
155
+ }),
156
+ 'stat-tile': (spec) => ({
157
+ columns: ['Value', 'Change', ...(spec.trend.length ? ['Trend'] : [])],
158
+ numeric: [true, false, false],
159
+ rows: [
160
+ [
161
+ withUnit(spec.value, spec.unit),
162
+ spec.delta === null ? '' : deltaText(spec.delta),
163
+ ...(spec.trend.length
164
+ ? [spec.trend.map((v) => formatNumber(v)).join(', ')]
165
+ : []),
166
+ ],
167
+ ],
168
+ }),
169
+ sparkline: (spec) => ({
170
+ columns: ['Position', spec.label ?? 'Value'],
171
+ numeric: [true, true],
172
+ rows: spec.values.map((value, i) => [String(i + 1), formatNumber(value)]),
173
+ }),
174
+ };
175
+
176
+ /**
177
+ * The data table twin of a chart: a caption, column headers and the rows
178
+ * as people read them (dates and numbers formatted).
179
+ * @returns {{caption: string, columns: string[], numeric: boolean[], rows: string[][]}}
180
+ */
181
+ export function chartTable(spec) {
182
+ if (spec.kind === 'tag-cloud') {
183
+ return {
184
+ caption: spec.label ?? 'Tags',
185
+ columns: ['Tag', 'Count'],
186
+ numeric: [false, true],
187
+ rows: spec.items.map((item) => [item.name, String(item.count ?? 0)]),
188
+ };
189
+ }
190
+ const small = SMALL_TABLES[spec.kind];
191
+ const table = small === undefined ? markTable(spec) : small(spec);
192
+ return { caption: spec.title ?? spec.label ?? chartLabel(spec), ...table };
193
+ }