@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,344 @@
1
+ /// <reference lib="dom" />
2
+
3
+ import type { Link } from 'links-notation';
4
+
5
+ /** The marks of a chart. */
6
+ export type Mark =
7
+ | 'line'
8
+ | 'area'
9
+ | 'bar'
10
+ | 'point'
11
+ | 'arc'
12
+ | 'calendar'
13
+ | 'range'
14
+ | 'composition';
15
+ /** The type of a field (as in Vega-Lite). */
16
+ export type FieldType = 'quantitative' | 'temporal' | 'ordinal' | 'nominal';
17
+ /** How a chart is drawn. */
18
+ export type Renderer = 'svg' | 'echarts';
19
+
20
+ /** A field of the data on a channel. */
21
+ export interface FieldDef {
22
+ /** The data field. */
23
+ scale?: { type: 'log'; base?: number };
24
+ field: string;
25
+ type: FieldType;
26
+ /** The axis or legend title (default: the field). */
27
+ title: string | null;
28
+ }
29
+
30
+ export interface MarkDef {
31
+ type: Mark;
32
+ /** The line and area curve. */
33
+ interpolate: 'linear' | 'monotone' | 'step';
34
+ /** Draw a point on every value of a line or area. */
35
+ point: boolean;
36
+ /** The hole of an arc (a donut), in pixels. */
37
+ innerRadius: number;
38
+ }
39
+
40
+ export interface Encoding {
41
+ x?: FieldDef;
42
+ x2?: FieldDef;
43
+ y?: FieldDef;
44
+ theta?: FieldDef;
45
+ color?: FieldDef;
46
+ size?: FieldDef;
47
+ tooltip?: FieldDef[];
48
+ }
49
+
50
+ /** A `(NAME: chart (data ...) (mark ...) (encoding ...))` spec. */
51
+ export interface ChartSpec {
52
+ kind: 'chart';
53
+ cornerRadius?: number;
54
+ labels?: 'peaks' | 'last';
55
+ emphasis?: string;
56
+ topN?: number;
57
+ weekStart?: number;
58
+ thresholds?: number[];
59
+ /** Snapshot end for ongoing rows; default: next year after latest data date. */
60
+ ongoingEnd?: string;
61
+ tooltip?: {
62
+ layer?: 'top' | 'inline';
63
+ content?: (datum: Record<string, string | number>) => {
64
+ title?: string;
65
+ value?: string | number;
66
+ rows?: [string, string | number][];
67
+ };
68
+ };
69
+ id: string | null;
70
+ title: string | null;
71
+ description: string | null;
72
+ renderer: Renderer;
73
+ width: number | null;
74
+ height: number | null;
75
+ mark: MarkDef;
76
+ /** The typed rows. */
77
+ data: { values: Record<string, string | number>[] };
78
+ encoding: Encoding;
79
+ }
80
+
81
+ export interface GaugeSpec {
82
+ kind: 'gauge';
83
+ id: string | null;
84
+ label: string | null;
85
+ description: string | null;
86
+ value: number;
87
+ /** Default 0. */
88
+ min: number;
89
+ /** Default 100. */
90
+ max: number;
91
+ unit: string | null;
92
+ }
93
+
94
+ export interface StatTileSpec {
95
+ kind: 'stat-tile';
96
+ notation?: 'compact';
97
+ compactThreshold?: number;
98
+ hint?: string;
99
+ footnote?: { label: string; href: string };
100
+ id: string | null;
101
+ label: string | null;
102
+ description: string | null;
103
+ value: number;
104
+ unit: string | null;
105
+ /** The change, in percent. */
106
+ delta: number | null;
107
+ /** Recent values, drawn as a sparkline. */
108
+ trend: number[];
109
+ }
110
+
111
+ export interface SparklineSpec {
112
+ kind: 'sparkline';
113
+ id: string | null;
114
+ label: string | null;
115
+ description: string | null;
116
+ values: number[];
117
+ mark: 'line' | 'area' | 'bar';
118
+ }
119
+
120
+ export type SmallChartSpec = GaugeSpec | StatTileSpec | SparklineSpec;
121
+ export interface TagCloudSpec {
122
+ kind: 'tag-cloud';
123
+ id: string | null;
124
+ label: string | null;
125
+ description: string | null;
126
+ minSize: number;
127
+ maxSize: number;
128
+ items: {
129
+ name: string;
130
+ count?: number | null;
131
+ color?: string | null;
132
+ emphasis?: boolean;
133
+ }[];
134
+ }
135
+ export type AnyChartSpec = ChartSpec | SmallChartSpec | TagCloudSpec;
136
+
137
+ /**
138
+ * Where a bad link is: the indexes from the top-level link down to it, and
139
+ * its LiNo text.
140
+ */
141
+ export interface LinkPosition {
142
+ path: number[];
143
+ link: string | null;
144
+ }
145
+
146
+ /** A spec that does not follow the chart dialect. */
147
+ export declare class ChartSpecError extends Error {
148
+ constructor(code: string, reason: string, position: LinkPosition);
149
+ readonly name: 'ChartSpecError';
150
+ /** A stable machine-readable reason (`unknown-mark`). */
151
+ readonly code: string;
152
+ /** The human-readable reason. */
153
+ readonly reason: string;
154
+ /** The position of the bad link. */
155
+ readonly path: number[];
156
+ /** The LiNo text of the bad link. */
157
+ readonly link: string | null;
158
+ }
159
+
160
+ export declare const MARKS: readonly Mark[];
161
+ export declare const FIELD_TYPES: readonly FieldType[];
162
+ export declare const CHANNELS: readonly string[];
163
+ export declare const RENDERERS: readonly Renderer[];
164
+ export declare const CHART_KINDS: readonly AnyChartSpec['kind'][];
165
+ export declare const SMALL_KINDS: readonly SmallChartSpec['kind'][];
166
+ export declare const SPARKLINE_MARKS: readonly SparklineSpec['mark'][];
167
+
168
+ /** Every chart of a list of links (a document may hold other elements). */
169
+ export declare function chartsFromLinks(links: readonly Link[]): AnyChartSpec[];
170
+ /** The first chart of a list of links. Throws ChartSpecError. */
171
+ export declare function chartFromLinks(links: readonly Link[]): AnyChartSpec;
172
+ /** Parse LiNo text with the official parser and read its first chart. */
173
+ export declare function parseChart(text: string): AnyChartSpec;
174
+ /** Write a spec as LiNo text; `chartFromLinks` reads it back equal. */
175
+ export declare function chartToLino(spec: AnyChartSpec): string;
176
+
177
+ /** Token path to colour, as an object or a Map. */
178
+ export type ChartTokenValues =
179
+ | Record<string, string>
180
+ | Map<string, string>
181
+ | null;
182
+
183
+ export interface RenderOptions {
184
+ width?: number;
185
+ height?: number;
186
+ /** Literal colours; by default the SVG uses CSS custom properties. */
187
+ tokens?: ChartTokenValues;
188
+ }
189
+
190
+ /** A value a keyboard user can move to. */
191
+ export interface ChartPoint {
192
+ /** The series index. */
193
+ series: number;
194
+ /** The index of the point in its series. */
195
+ index: number;
196
+ /** The index of the data row. */
197
+ row: number;
198
+ /** Navigation anchor, in SVG pixels. */
199
+ x: number;
200
+ y: number;
201
+ datum: Record<string, string | number>;
202
+ day?: number;
203
+ /** The tooltip and announcement. */
204
+ text: string;
205
+ }
206
+
207
+ export interface ChartSeries {
208
+ /** The colour value, or null for a single series. */
209
+ key: string | null;
210
+ color: string;
211
+ points: ChartPoint[];
212
+ /** The marks: `{tag, attrs}`. */
213
+ shapes: { tag: string; attrs: Record<string, string | number> }[];
214
+ }
215
+
216
+ export interface ChartLayout {
217
+ width: number;
218
+ height: number;
219
+ title: string | null;
220
+ weeks?: number;
221
+ accessibleMarks: boolean;
222
+ diagnostics: {
223
+ code: string;
224
+ channel: string;
225
+ row: number;
226
+ value: string | number;
227
+ message: string;
228
+ }[];
229
+ /** The accessible name. */
230
+ label: string;
231
+ plot: { x: number; y: number; width: number; height: number };
232
+ axes: object[];
233
+ legend: {
234
+ label: string;
235
+ color: string;
236
+ x: number;
237
+ y: number;
238
+ pattern?: 'solid' | 'hatched' | 'dotted';
239
+ }[];
240
+ series: ChartSeries[];
241
+ }
242
+
243
+ export declare const DEFAULT_WIDTH: number;
244
+ export declare const DEFAULT_HEIGHT: number;
245
+ /** The pixel layout of a chart: scales, marks, axes and points. */
246
+ export declare function layoutChart(
247
+ spec: ChartSpec,
248
+ options?: RenderOptions
249
+ ): ChartLayout;
250
+ /** Deterministic SVG text: the same spec gives the same bytes. */
251
+ export declare function renderChartSvg(
252
+ spec: AnyChartSpec,
253
+ options?: RenderOptions
254
+ ): string;
255
+
256
+ /** A sentence that describes the data of a chart. */
257
+ export declare function summarizeChart(spec: AnyChartSpec): string;
258
+ /** The accessible name: description, else title or label, else summary. */
259
+ export declare function chartLabel(spec: AnyChartSpec): string;
260
+ /** The data table twin of a chart. */
261
+ export declare function chartTable(spec: AnyChartSpec): {
262
+ caption: string;
263
+ columns: string[];
264
+ numeric: boolean[];
265
+ rows: string[][];
266
+ };
267
+
268
+ /** The number of series colours (`color.chart.1` … `color.chart.8`). */
269
+ export declare const SERIES_COUNT: number;
270
+ /** The chart colour tokens of the light and dark themes. */
271
+ export declare const CHART_TOKENS: Readonly<{
272
+ light: Readonly<Record<string, string>>;
273
+ dark: Readonly<Record<string, string>>;
274
+ }>;
275
+ /** The tokens as CSS custom properties (light, dark, `data-theme`). */
276
+ export declare const CHART_CSS: string;
277
+ /** The token of a series: `color.chart.<index % 8 + 1>`. */
278
+ export declare function seriesToken(index: number): string;
279
+ /** A literal colour from `tokens`, else a CSS variable with a fallback. */
280
+ export declare function tokenColor(
281
+ path: string,
282
+ tokens?: ChartTokenValues
283
+ ): string;
284
+ /** The chart tokens as a `@link-foundation/ui-tokens` theme in LiNo. */
285
+ export declare function chartTokensLino(name?: string): string;
286
+
287
+ /** `type="text/lino"`: the script that holds a chart inside an element. */
288
+ export declare const LINO_SCRIPT_TYPE: string;
289
+ /** Add the chart styles to a document (once). */
290
+ export declare function ensureChartStyles(document: Document): void;
291
+
292
+ /** The base of the chart elements. */
293
+ export interface ChartElement extends HTMLElement {
294
+ /** The LiNo text of the chart; setting it renders again. */
295
+ lino: string | null;
296
+ /** The normalised spec shown; setting it renders again. */
297
+ spec: AnyChartSpec | null;
298
+ }
299
+
300
+ /**
301
+ * `<ui-chart>`: an SVG `role="img"` named by the description, a table twin
302
+ * behind "Show data table", and arrow-key navigation announced through
303
+ * aria-live. Events: `chart-point` (detail: ChartPoint) and `chart-error`
304
+ * (detail: ChartSpecError or the ECharts load error).
305
+ */
306
+ export interface UiChartElement extends ChartElement {
307
+ /** Resolves when the chart (and ECharts, if used) has rendered. */
308
+ ready: Promise<void>;
309
+ /** Replaces `import('echarts')` for `(renderer echarts)`. */
310
+ loadECharts: (() => Promise<unknown>) | undefined;
311
+ /** The point moved to with the keyboard or pointer, or null. */
312
+ readonly activePoint: ChartPoint | null;
313
+ }
314
+
315
+ export declare const CHART_TAG: 'ui-chart';
316
+ export declare const GAUGE_TAG: 'ui-gauge';
317
+ export declare const SPARKLINE_TAG: 'ui-sparkline';
318
+ export declare const STAT_TILE_TAG: 'ui-stat-tile';
319
+
320
+ /** The `<ui-chart>` class of a window. */
321
+ export declare function createChartClass(win: Window): new () => UiChartElement;
322
+ /** Define `<ui-chart>` in a window, unless the tag is taken. */
323
+ export declare function defineChartElement(
324
+ win?: Window
325
+ ): CustomElementConstructor;
326
+ /** Define `<ui-gauge>` (attributes: label value min max unit). */
327
+ export declare function defineGaugeElement(
328
+ win?: Window
329
+ ): CustomElementConstructor;
330
+ /** Define `<ui-sparkline>` (attributes: label values mark). */
331
+ export declare function defineSparklineElement(
332
+ win?: Window
333
+ ): CustomElementConstructor;
334
+ /** Define `<ui-stat-tile>` (attributes: label value unit delta trend). */
335
+ export declare function defineStatTileElement(
336
+ win?: Window
337
+ ): CustomElementConstructor;
338
+ /** Define every chart element in a window (each once). */
339
+ export declare function defineChartElements(win?: Window): {
340
+ chart: CustomElementConstructor;
341
+ statTile: CustomElementConstructor;
342
+ gauge: CustomElementConstructor;
343
+ sparkline: CustomElementConstructor;
344
+ };
@@ -0,0 +1,59 @@
1
+ /**
2
+ * Charts of the associative UI framework: the chart dialect (a Vega-Lite
3
+ * style `data`, `mark`, `encoding` written in Links Notation), its
4
+ * deterministic SVG renderer, the chart colour tokens and the custom
5
+ * elements `<ui-chart>`, `<ui-stat-tile>`, `<ui-gauge>` and
6
+ * `<ui-sparkline>`.
7
+ *
8
+ * The ECharts adapter is a separate entry
9
+ * (`@link-foundation/ui-components/charts/echarts`); `<ui-chart>` loads it
10
+ * only for `(renderer echarts)`.
11
+ */
12
+
13
+ import { defineChartElement } from './chart.js';
14
+ import { defineGaugeElement } from './gauge.js';
15
+ import { defineSparklineElement } from './sparkline.js';
16
+ import { defineStatTileElement } from './stat-tile.js';
17
+
18
+ export {
19
+ CHANNELS,
20
+ CHART_KINDS,
21
+ ChartSpecError,
22
+ FIELD_TYPES,
23
+ MARKS,
24
+ RENDERERS,
25
+ chartFromLinks,
26
+ chartToLino,
27
+ chartsFromLinks,
28
+ parseChart,
29
+ } from './chart-model.js';
30
+ export { SMALL_KINDS, SPARKLINE_MARKS } from './small-model.js';
31
+ export { DEFAULT_HEIGHT, DEFAULT_WIDTH, layoutChart } from './layout.js';
32
+ export { renderChartSvg } from './svg-renderer.js';
33
+ export { chartLabel, chartTable, summarizeChart } from './summary.js';
34
+ export {
35
+ CHART_CSS,
36
+ CHART_TOKENS,
37
+ SERIES_COUNT,
38
+ chartTokensLino,
39
+ seriesToken,
40
+ tokenColor,
41
+ } from './tokens.js';
42
+ export { CHART_TAG, createChartClass, defineChartElement } from './chart.js';
43
+ export { GAUGE_TAG, defineGaugeElement } from './gauge.js';
44
+ export { SPARKLINE_TAG, defineSparklineElement } from './sparkline.js';
45
+ export { STAT_TILE_TAG, defineStatTileElement } from './stat-tile.js';
46
+ export { LINO_SCRIPT_TYPE, ensureChartStyles } from './element.js';
47
+
48
+ /**
49
+ * Define every chart element in a window (each once).
50
+ * @param {Window} [win]
51
+ */
52
+ export function defineChartElements(win = globalThis.window) {
53
+ return {
54
+ chart: defineChartElement(win),
55
+ statTile: defineStatTileElement(win),
56
+ gauge: defineGaugeElement(win),
57
+ sparkline: defineSparklineElement(win),
58
+ };
59
+ }