@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,494 @@
1
+ /**
2
+ * The `link-view` custom element: one link drawn from Links Notation, as SVG
3
+ * (default) or on a canvas, with its own zoom and pan, keyboard zoom
4
+ * (`+`, `-`, `0` to reset, arrows to pan) and an accessible name such as
5
+ * "Link 1 from 1 to 2".
6
+ *
7
+ * ```html
8
+ * <link-view>(simple: link-view (link (id 1) (source 1) (target 2))
9
+ * (markers (source bar) (target arrow)) (blueprint true) (grid true))</link-view>
10
+ * ```
11
+ *
12
+ * The class is made inside `defineLinkView(win)`, because `HTMLElement`
13
+ * only exists in a window; the module itself holds no state. A redraw is
14
+ * requested through the animator, so changes in one frame draw once, and
15
+ * nothing runs while nothing changes.
16
+ */
17
+
18
+ import { defineKind } from '@link-foundation/ui-dom';
19
+ import { createAnimator } from './animator.js';
20
+ import { linkGeometry } from './geometry.js';
21
+ import {
22
+ accessibleName,
23
+ parseLinkView,
24
+ rawSublinks,
25
+ readLinkView,
26
+ } from './model.js';
27
+ import { drawLinkCanvas } from './render-canvas.js';
28
+ import { drawnMarkers, renderLinkSvg } from './render-svg.js';
29
+ import { GRID_SPACING, buildScene, fitView, sceneBounds } from './scene.js';
30
+ import { colorVariables, linkColors } from './tokens.js';
31
+ import { createZoomPan } from './zoom-pan.js';
32
+
33
+ /** The default tag name. */
34
+ export const LINK_VIEW_TAG = 'link-view';
35
+
36
+ /** The zoom factor of one `+` or `-` key press. */
37
+ export const KEY_ZOOM_STEP = 1.25;
38
+
39
+ /** The pan step of one arrow key press, in CSS pixels. */
40
+ export const KEY_PAN_STEP = 20;
41
+
42
+ /** The size drawn when the element has no layout size (no CSS, jsdom). */
43
+ export const FALLBACK_SIZE = Object.freeze({ width: 320, height: 200 });
44
+
45
+ /** The attributes that change what is drawn. */
46
+ export const LINK_VIEW_ATTRIBUTES = Object.freeze([
47
+ 'lino',
48
+ 'renderer',
49
+ 'theme',
50
+ 'blueprint',
51
+ 'grid',
52
+ 'bend',
53
+ 'label',
54
+ ]);
55
+
56
+ const STYLE = `:host {
57
+ display: inline-block;
58
+ position: relative;
59
+ width: 320px;
60
+ height: 200px;
61
+ overflow: hidden;
62
+ touch-action: none;
63
+ border-radius: 4px;
64
+ outline: none;
65
+ contain: content;
66
+ }
67
+ :host([hidden]) { display: none; }
68
+ :host(:focus-visible) {
69
+ outline: 2px solid var(${colorVariables().focus}, currentColor);
70
+ outline-offset: 2px;
71
+ }
72
+ .surface { position: absolute; inset: 0; }
73
+ .surface > svg, .surface > canvas { display: block; width: 100%; height: 100%; }`;
74
+
75
+ /**
76
+ * The world geometry of a link view: the source and target eight half
77
+ * steps apart around the origin (links-visuals), or a self-loop.
78
+ * @param {import('./model.js').LinkViewModel} model
79
+ * @param {{gridSpacing?: number}} [options]
80
+ */
81
+ export function linkViewGeometry(model, { gridSpacing = GRID_SPACING } = {}) {
82
+ const half = 4 * gridSpacing;
83
+ if (model.selfLoop) {
84
+ const radius = 2 * gridSpacing;
85
+ return linkGeometry({
86
+ source: { x: 0, y: 1.3 * radius },
87
+ selfLoop: true,
88
+ loopRadius: radius,
89
+ });
90
+ }
91
+ return linkGeometry({
92
+ source: { x: -half, y: 0 },
93
+ target: { x: half, y: 0 },
94
+ bend: model.bend,
95
+ });
96
+ }
97
+
98
+ /** A boolean attribute: absent → `fallback`, `false` → false, else true. */
99
+ function booleanAttribute(node, name, fallback) {
100
+ const value = node.getAttribute(name);
101
+ if (value === null) {
102
+ return fallback;
103
+ }
104
+ return value !== 'false';
105
+ }
106
+
107
+ /**
108
+ * The model with the attribute overrides (`blueprint`, `grid`, `bend`,
109
+ * `label`) applied.
110
+ */
111
+ function withAttributes(node, model) {
112
+ const bend = Number(node.getAttribute('bend'));
113
+ return {
114
+ ...model,
115
+ blueprint: booleanAttribute(node, 'blueprint', model.blueprint),
116
+ grid: booleanAttribute(node, 'grid', model.grid),
117
+ bend:
118
+ node.getAttribute('bend') !== null && Number.isFinite(bend)
119
+ ? bend
120
+ : model.bend,
121
+ label: node.getAttribute('label') ?? model.label,
122
+ };
123
+ }
124
+
125
+ /**
126
+ * The colours of an element: the `link-view` tokens in its colour scheme,
127
+ * then any `--color-link-*` custom property set on the page.
128
+ * @param {HTMLElement} node
129
+ * @param {Window} win
130
+ * @param {(mode: 'light'|'dark') => Readonly<Record<string, string>>}
131
+ * tokenColors the token colours of a mode
132
+ */
133
+ function elementColors(node, win, tokenColors) {
134
+ const theme = node.getAttribute('theme');
135
+ const dark =
136
+ theme === 'dark' ||
137
+ (theme !== 'light' &&
138
+ win.matchMedia?.('(prefers-color-scheme: dark)')?.matches === true);
139
+ const colors = { ...tokenColors(dark ? 'dark' : 'light') };
140
+ const computed = win.getComputedStyle?.(node);
141
+ for (const [role, name] of Object.entries(colorVariables())) {
142
+ const value = computed?.getPropertyValue(name)?.trim();
143
+ if (value) {
144
+ colors[role] = value;
145
+ }
146
+ }
147
+ return colors;
148
+ }
149
+
150
+ /** The token colours of a mode, read once per element. */
151
+ function colorsOf(state, mode) {
152
+ if (!state.tokenColors.has(mode)) {
153
+ state.tokenColors.set(
154
+ mode,
155
+ linkColors({ mode: mode === 'dark' ? 'dark' : null })
156
+ );
157
+ }
158
+ return state.tokenColors.get(mode);
159
+ }
160
+
161
+ /** The key bindings: zoom with `+`/`-`, reset with `0`, pan with arrows. */
162
+ function keyAction(zoom, key) {
163
+ const actions = {
164
+ '+': () => zoom.zoomBy(KEY_ZOOM_STEP),
165
+ '=': () => zoom.zoomBy(KEY_ZOOM_STEP),
166
+ '-': () => zoom.zoomBy(1 / KEY_ZOOM_STEP),
167
+ _: () => zoom.zoomBy(1 / KEY_ZOOM_STEP),
168
+ 0: () => zoom.reset(),
169
+ ArrowLeft: () => zoom.panBy(KEY_PAN_STEP, 0),
170
+ ArrowRight: () => zoom.panBy(-KEY_PAN_STEP, 0),
171
+ ArrowUp: () => zoom.panBy(0, KEY_PAN_STEP),
172
+ ArrowDown: () => zoom.panBy(0, -KEY_PAN_STEP),
173
+ };
174
+ return Object.hasOwn(actions, key) ? actions[key] : null;
175
+ }
176
+
177
+ /** Start the zoom, the animator and the listeners of a connected element. */
178
+ function connect(node, state) {
179
+ const { win, options } = state;
180
+ const defaults = {
181
+ role: 'img',
182
+ tabindex: '0',
183
+ 'aria-keyshortcuts': '+ - 0 ArrowUp ArrowDown ArrowLeft ArrowRight',
184
+ };
185
+ for (const [name, value] of Object.entries(defaults)) {
186
+ if (!node.hasAttribute(name)) {
187
+ node.setAttribute(name, value);
188
+ }
189
+ }
190
+ state.animator = createAnimator({
191
+ reducedMotion: () =>
192
+ win.matchMedia?.('(prefers-reduced-motion: reduce)')?.matches === true,
193
+ raf: (cb) => win.requestAnimationFrame(cb),
194
+ caf: (h) => win.cancelAnimationFrame(h),
195
+ ...options.animator,
196
+ });
197
+ state.zoom = createZoomPan(node, {
198
+ ...state.zoomLimits,
199
+ onChange: () => node.requestDraw(),
200
+ });
201
+ const listen = (target, type, fn) => {
202
+ target.addEventListener(type, fn);
203
+ state.cleanup.push(() => target.removeEventListener(type, fn));
204
+ };
205
+ listen(node, 'keydown', (event) => {
206
+ const action =
207
+ event.ctrlKey || event.metaKey || event.altKey
208
+ ? null
209
+ : keyAction(state.zoom, event.key);
210
+ if (action !== null) {
211
+ event.preventDefault();
212
+ action();
213
+ }
214
+ });
215
+ // Redraw on a colour scheme change and on resize.
216
+ const scheme = win.matchMedia?.('(prefers-color-scheme: dark)');
217
+ if (typeof scheme?.addEventListener === 'function') {
218
+ listen(scheme, 'change', () => node.requestDraw());
219
+ }
220
+ if (typeof win.ResizeObserver === 'function') {
221
+ const observer = new win.ResizeObserver(() => node.requestDraw());
222
+ observer.observe(node);
223
+ state.cleanup.push(() => observer.disconnect());
224
+ }
225
+ }
226
+
227
+ /** Stop everything `connect` started. */
228
+ function disconnect(state) {
229
+ state.zoom?.destroy();
230
+ state.animator?.destroy();
231
+ state.cleanup.forEach((fn) => fn());
232
+ state.cleanup = [];
233
+ state.zoom = null;
234
+ state.animator = null;
235
+ }
236
+
237
+ /** Read the model again (from raw links, `lino` or the text content). */
238
+ function readModel(node, state) {
239
+ if (state.links !== null) {
240
+ state.read = readLinkView(state.links.raw, { name: state.links.name });
241
+ } else {
242
+ const lino = node.getAttribute('lino');
243
+ state.read = parseLinkView(lino ?? node.textContent ?? '');
244
+ }
245
+ node.setAttribute('aria-label', accessibleName(node.model));
246
+ }
247
+
248
+ /** Draw on the canvas of the surface (made on first use). */
249
+ function drawCanvas(state, geometry, style) {
250
+ const { win, surface } = state;
251
+ let canvas = surface.firstElementChild;
252
+ if (canvas === null || canvas.localName !== 'canvas') {
253
+ canvas = win.document.createElement('canvas');
254
+ canvas.setAttribute('aria-hidden', 'true');
255
+ surface.replaceChildren(canvas);
256
+ }
257
+ const ratio = win.devicePixelRatio || 1;
258
+ const w = Math.round(style.width * ratio);
259
+ const h = Math.round(style.height * ratio);
260
+ if (canvas.width !== w || canvas.height !== h) {
261
+ canvas.width = w;
262
+ canvas.height = h;
263
+ }
264
+ const ctx = canvas.getContext?.('2d') ?? null;
265
+ if (ctx === null) {
266
+ return drawnMarkers(buildScene(geometry, style));
267
+ }
268
+ const options = { ...style, pixelRatio: ratio, Path2D: win.Path2D };
269
+ return drawLinkCanvas(ctx, geometry, options).markers;
270
+ }
271
+
272
+ /** Draw an element now; returns what was drawn. */
273
+ function draw(node, state) {
274
+ const model = node.model;
275
+ const width = node.clientWidth || FALLBACK_SIZE.width;
276
+ const height = node.clientHeight || FALLBACK_SIZE.height;
277
+ const geometry = linkViewGeometry(model);
278
+ const fit = fitView(sceneBounds(geometry), width, height, state.zoomLimits);
279
+ const user = node.view;
280
+ const style = {
281
+ width,
282
+ height,
283
+ view: {
284
+ x: user.k * fit.x + user.x,
285
+ y: user.k * fit.y + user.y,
286
+ k: user.k * fit.k,
287
+ },
288
+ colors: elementColors(node, state.win, (mode) => colorsOf(state, mode)),
289
+ ends: model.ends,
290
+ blueprint: model.blueprint,
291
+ grid: model.grid,
292
+ };
293
+ const renderer =
294
+ node.getAttribute('renderer') === 'canvas' ? 'canvas' : 'svg';
295
+ let markers;
296
+ if (renderer === 'canvas') {
297
+ markers = drawCanvas(state, geometry, style);
298
+ } else {
299
+ state.surface.innerHTML = renderLinkSvg(geometry, style);
300
+ markers = drawnMarkers(buildScene(geometry, style));
301
+ }
302
+ node.setAttribute('data-markers', markers.join(' '));
303
+ return Object.freeze({ renderer, markers, view: style.view });
304
+ }
305
+
306
+ /** The shadow root content: a style sheet and the drawing surface. */
307
+ function makeSurface(node, win) {
308
+ const root = node.attachShadow({ mode: 'open' });
309
+ const style = win.document.createElement('style');
310
+ style.textContent = STYLE;
311
+ const surface = win.document.createElement('div');
312
+ surface.className = 'surface';
313
+ surface.setAttribute('part', 'surface');
314
+ root.append(style, surface);
315
+ return surface;
316
+ }
317
+
318
+ /**
319
+ * Define the `link-view` element in a window. When the tag is already
320
+ * defined there, the class defined for it is returned.
321
+ * @param {Window & typeof globalThis} [win]
322
+ * @param {{tag?: string, animator?: import('./animator.js').AnimatorOptions,
323
+ * zoom?: {min?: number, max?: number}}} [options] `animator` options
324
+ * (clock, frame scheduler) for every element of the tag
325
+ * @returns {CustomElementConstructor}
326
+ */
327
+ export function defineLinkView(win = globalThis.window, options = {}) {
328
+ const tag = options.tag ?? LINK_VIEW_TAG;
329
+ const existing = win.customElements.get(tag);
330
+ if (existing !== undefined) {
331
+ return existing;
332
+ }
333
+ const zoomLimits = { min: 0.1, max: 20, ...options.zoom };
334
+
335
+ class LinkView extends win.HTMLElement {
336
+ static get observedAttributes() {
337
+ return [...LINK_VIEW_ATTRIBUTES];
338
+ }
339
+
340
+ #state;
341
+
342
+ constructor() {
343
+ super();
344
+ this.#state = {
345
+ win,
346
+ options,
347
+ zoomLimits,
348
+ surface: makeSurface(this, win),
349
+ links: null,
350
+ read: null,
351
+ zoom: null,
352
+ animator: null,
353
+ cleanup: [],
354
+ drawn: null,
355
+ tokenColors: new Map(),
356
+ };
357
+ }
358
+
359
+ connectedCallback() {
360
+ connect(this, this.#state);
361
+ readModel(this, this.#state);
362
+ this.requestDraw();
363
+ }
364
+
365
+ disconnectedCallback() {
366
+ disconnect(this.#state);
367
+ }
368
+
369
+ attributeChangedCallback() {
370
+ if (this.isConnected) {
371
+ readModel(this, this.#state);
372
+ this.requestDraw();
373
+ }
374
+ }
375
+
376
+ /** The model drawn, with the attribute overrides. */
377
+ get model() {
378
+ return withAttributes(
379
+ this,
380
+ this.#state.read?.model ?? readLinkView([]).model
381
+ );
382
+ }
383
+
384
+ /** The problems found reading the Links Notation. */
385
+ get diagnostics() {
386
+ return [...(this.#state.read?.diagnostics ?? [])];
387
+ }
388
+
389
+ /** The Links Notation text drawn (the `lino` attribute). */
390
+ get lino() {
391
+ return this.getAttribute('lino');
392
+ }
393
+
394
+ set lino(text) {
395
+ this.#state.links = null;
396
+ this.setAttribute('lino', String(text));
397
+ }
398
+
399
+ /**
400
+ * The sub-links of a `link-view` as raw values (what ui-dom gives a
401
+ * kind); when set, they are drawn and the text is not read.
402
+ * @param {{raw: readonly unknown[], name?: string|null}|null} value
403
+ */
404
+ set links(value) {
405
+ const next =
406
+ value === null ? null : { raw: value.raw, name: value.name ?? null };
407
+ if (JSON.stringify(next) !== JSON.stringify(this.#state.links)) {
408
+ this.#state.links = next;
409
+ if (this.isConnected) {
410
+ readModel(this, this.#state);
411
+ this.requestDraw();
412
+ }
413
+ }
414
+ }
415
+
416
+ get links() {
417
+ return this.#state.links;
418
+ }
419
+
420
+ /** The zoom and pan of this element (`{x, y, k}`, relative to fit). */
421
+ get view() {
422
+ return this.#state.zoom?.get() ?? { x: 0, y: 0, k: 1 };
423
+ }
424
+
425
+ set view(next) {
426
+ this.#state.zoom?.set(next);
427
+ }
428
+
429
+ /** What the last draw drew: renderer, marker ids and view. */
430
+ get drawn() {
431
+ return this.#state.drawn;
432
+ }
433
+
434
+ zoomBy(factor, pivot) {
435
+ return this.#state.zoom?.zoomBy(factor, pivot);
436
+ }
437
+
438
+ resetView() {
439
+ return this.#state.zoom?.reset();
440
+ }
441
+
442
+ /** Ask for a redraw on the next frame (several asks draw once). */
443
+ requestDraw() {
444
+ this.#state.animator?.start('draw', () => {
445
+ this.draw();
446
+ return false;
447
+ });
448
+ }
449
+
450
+ /** Draw now. */
451
+ draw() {
452
+ this.#state.drawn = draw(this, this.#state);
453
+ }
454
+ }
455
+
456
+ win.customElements.define(tag, LinkView);
457
+ return LinkView;
458
+ }
459
+
460
+ /**
461
+ * The ui-dom kind of `link-view`: a ui-dom document with a `link-view`
462
+ * element renders it as this element, drawing the element's sub-links.
463
+ * @param {{tag?: string}} [options]
464
+ * @returns {import('@link-foundation/ui-dom').KindSpec}
465
+ */
466
+ export function linkViewKind({ tag = LINK_VIEW_TAG } = {}) {
467
+ const setLinks = (node, el, ctx) => {
468
+ node.links = {
469
+ raw: rawSublinks(el, ctx.children?.() ?? []),
470
+ name: el.name,
471
+ };
472
+ };
473
+ return {
474
+ tag,
475
+ childrenSlot: null,
476
+ create(el, ctx) {
477
+ const node = ctx.document.createElement(tag);
478
+ setLinks(node, el, ctx);
479
+ return node;
480
+ },
481
+ update: (node, el, changed, ctx) => setLinks(node, el, ctx),
482
+ };
483
+ }
484
+
485
+ /**
486
+ * Define the element in a window and register it as the ui-dom renderer of
487
+ * the `link-view` kind.
488
+ * @param {Window & typeof globalThis} [win]
489
+ * @param {Parameters<typeof defineLinkView>[1]} [options]
490
+ */
491
+ export function registerLinkViewKind(win = globalThis.window, options = {}) {
492
+ defineLinkView(win, options);
493
+ return defineKind('link-view', linkViewKind(options));
494
+ }