@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,230 @@
1
+ import { add, sub, scale, pathBounds, segmentLength } from './geometry.js';
2
+ import { doubletPairs, readDoubletOptions } from './doublet-options.js';
3
+ import { doubletPlaces } from './doublet-layout.js';
4
+ import { doubletCurves, trimCubic } from './doublet-curves.js';
5
+ import {
6
+ markerExtent,
7
+ placeDoubletMarkers,
8
+ compensatedMarker,
9
+ markerTipExtension,
10
+ } from './doublet-markers.js';
11
+ import { doubletToSvg, doubletCaption } from './doublet-svg.js';
12
+
13
+ function fit(curves, o, pairs) {
14
+ const width = 100 * Math.max(1, o.width / o.height),
15
+ height = 100 * Math.max(1, o.height / o.width);
16
+ const caption = doubletCaption(pairs, o, '0') ? o.caption.size * 1.8 + 2 : 0;
17
+ const margin = Math.min(
18
+ 48,
19
+ Math.max(
20
+ o.padding,
21
+ ...['start', 'end', 'middle'].map(
22
+ (key) => markerExtent(o[key], o) + o.strokeWidth / 2
23
+ )
24
+ )
25
+ );
26
+ const boxes = curves.map((c) => pathBounds(c.path));
27
+ const box = boxes.reduce(
28
+ (b, c) => ({
29
+ minX: Math.min(b.minX, c.minX),
30
+ minY: Math.min(b.minY, c.minY),
31
+ maxX: Math.max(b.maxX, c.maxX),
32
+ maxY: Math.max(b.maxY, c.maxY),
33
+ }),
34
+ { minX: Infinity, minY: Infinity, maxX: -Infinity, maxY: -Infinity }
35
+ );
36
+ if (!curves.length) {
37
+ Object.assign(box, { minX: 0, minY: 0, maxX: 0, maxY: 0 });
38
+ }
39
+ const inset = o.card.inset + (o.card.border === 'none' ? 0 : o.card.width);
40
+ const availableWidth = Math.max(1, width - 2 * (margin + inset)),
41
+ availableHeight = Math.max(1, height - 2 * (margin + inset) - caption);
42
+ const k = Math.min(
43
+ 60,
44
+ availableWidth / (box.maxX - box.minX || 1),
45
+ availableHeight / (box.maxY - box.minY || 1)
46
+ );
47
+ const transform = o.frame ?? [
48
+ k,
49
+ width / 2 - ((box.minX + box.maxX) * k) / 2,
50
+ (height - caption) / 2 - ((box.minY + box.maxY) * k) / 2,
51
+ ];
52
+ return {
53
+ bounds: { x: 0, y: 0, width, height },
54
+ transform,
55
+ margin,
56
+ captionRoom: caption,
57
+ };
58
+ }
59
+ /**
60
+ * A start/end gap at another link's middle moves that end and its handle back
61
+ * along the end tangent, so the end keeps its direction near the middle.
62
+ * Free and self-loop ends are trimmed by arc length.
63
+ */
64
+ function backedEnds(path, gaps, references = [false, false]) {
65
+ const moved = path.map((s, side) => {
66
+ if (!references[side] || !gaps[side]) {
67
+ return s;
68
+ }
69
+ const [end, handle] = side === 0 ? ['p0', 'c1'] : ['p3', 'c2'];
70
+ const tangent = sub(s[handle], s[end]);
71
+ const length = Math.hypot(tangent.x, tangent.y);
72
+ if (length < 1e-12) {
73
+ return s;
74
+ }
75
+ const shift = scale(tangent, gaps[side] / length);
76
+ return { ...s, [end]: add(s[end], shift), [handle]: add(s[handle], shift) };
77
+ });
78
+ return {
79
+ path: moved,
80
+ gaps: gaps.map((g, i) => (i < 2 && moved[i] !== path[i] ? 0 : g)),
81
+ };
82
+ }
83
+ function fittedCurve(curve, transform, o) {
84
+ const [k, x, y] = transform,
85
+ point = (p) => add(scale(p, k), { x, y });
86
+ const path = curve.path.map((s) =>
87
+ Object.fromEntries(Object.entries(s).map(([key, p]) => [key, point(p)]))
88
+ );
89
+ const gaps = (o.links[curve.id]?.gaps ?? [null, null, null, null]).map(
90
+ (v, i) => (v ?? o.gaps[i]) * (i < 2 ? k : 1)
91
+ );
92
+ const cut = backedEnds(path, gaps, curve.references);
93
+ const markers = placeDoubletMarkers({ path: cut.path }, cut.gaps, o);
94
+ const cap = o.linecap === 'butt' ? 0 : o.strokeWidth / 2;
95
+ const trim = ['start', 'end'].map((end) =>
96
+ compensatedMarker(o[end], end, o) ? markerTipExtension(o[end], o) + cap : 0
97
+ );
98
+ const visible = [
99
+ trimCubic(cut.path[0], cut.gaps[0] + trim[0], gaps[2]),
100
+ trimCubic(cut.path[1], gaps[3], cut.gaps[1] + trim[1]),
101
+ ];
102
+ return {
103
+ ...curve,
104
+ middle: point(curve.middle),
105
+ path,
106
+ visible,
107
+ gaps,
108
+ markers,
109
+ lengths: path.map((s) => segmentLength(s)),
110
+ };
111
+ }
112
+
113
+ /** Independently implemented doublet frame; options are canonical LiNo text. */
114
+ export function doubletGeometry(items, options = '', index = '0') {
115
+ const pairs = doubletPairs(items),
116
+ o = readDoubletOptions(options, pairs.length);
117
+ const places = doubletPlaces(pairs, o),
118
+ layoutCurves = doubletCurves(pairs, places, o);
119
+ const fitted = fit(layoutCurves, o, pairs);
120
+ const [k, x, y] = fitted.transform;
121
+ return {
122
+ ...fitted,
123
+ positions: new Map(
124
+ [...places].map(([id, p]) => [id, add(scale(p, k), { x, y })])
125
+ ),
126
+ pins: new Map(),
127
+ places,
128
+ layoutCurves,
129
+ curves: layoutCurves.map((c) => fittedCurve(c, fitted.transform, o)),
130
+ pairs,
131
+ options: o,
132
+ index,
133
+ };
134
+ }
135
+
136
+ /** Built-in provider for createNetworkPresentation and <links-network>. */
137
+ export function createDoubletProvider({ debug } = {}) {
138
+ return {
139
+ geometry({ input }) {
140
+ const frame = doubletGeometry(input.items, input.options, input.index);
141
+ debug?.('doublet:geometry', {
142
+ links: frame.pairs.length,
143
+ transform: frame.transform,
144
+ margin: frame.margin,
145
+ });
146
+ return frame;
147
+ },
148
+ svg({ frame }) {
149
+ if (!frame?.curves) {
150
+ throw new TypeError('A prepared doublet frame is required');
151
+ }
152
+ return doubletToSvg(frame);
153
+ },
154
+ };
155
+ }
156
+
157
+ /** Reports geometry/style controls that can affect this network and options. */
158
+ export function doubletOptionAvailability(items, options = '') {
159
+ const pairs = doubletPairs(items),
160
+ o = readDoubletOptions(options, pairs.length);
161
+ const loop = pairs.some((p, i) => p.includes(i + 1)),
162
+ free = pairs.some((p) => p.includes(0));
163
+ const referenceCounts = pairs.map(
164
+ (p, i) => p.filter((id) => id !== 0 && id !== i + 1).length
165
+ );
166
+ const reference = referenceCounts.some((count) => count > 0);
167
+ const singleReference = referenceCounts.includes(1);
168
+ const result = {
169
+ ...Object.fromEntries(Object.keys(o).map((key) => [key, true])),
170
+ loop,
171
+ loopBend: loop,
172
+ free,
173
+ bulge: loop || singleReference,
174
+ tension: reference || free,
175
+ angles: reference,
176
+ sourceAngle: reference && o.angles === 'fixed',
177
+ targetAngle: reference && o.angles === 'fixed',
178
+ turns: pairs.length > 0,
179
+ order:
180
+ pairs.length > 1 &&
181
+ (o.layout === 'circle' || (o.layout === 'auto' && pairs.length <= 4)),
182
+ columns:
183
+ ['grid', 'hex', 'dice'].includes(o.layout) ||
184
+ (o.layout === 'auto' && pairs.length > 4),
185
+ layoutAspect: pairs.length > 1,
186
+ spread: pairs.length > 1,
187
+ rotation: pairs.length > 0,
188
+ padding: !o.frame,
189
+ start: pairs.length > 0,
190
+ end: pairs.length > 0,
191
+ middle: pairs.length > 0,
192
+ backgroundAngle: o.background.type === 'linear',
193
+ captionText: o.caption.mode === 'custom',
194
+ cardWidth: o.card.border !== 'none',
195
+ arrowJoin: ['start', 'end', 'middle'].some((key) =>
196
+ ['arrow', 'triangle', 'tail'].includes(o[key].shape)
197
+ ),
198
+ balanceArrows: ['start', 'end'].some((key) =>
199
+ compensatedMarker(o[key], key, { ...o, balanceArrows: true })
200
+ ),
201
+ };
202
+ for (const key of ['start', 'end', 'middle']) {
203
+ Object.assign(result, markerAvailability(key, o[key], pairs.length > 0));
204
+ }
205
+ return Object.assign(result, {
206
+ 'background.angle': o.background.type === 'linear',
207
+ 'background.color': o.background.type !== 'transparent',
208
+ 'background.color2': ['linear', 'radial'].includes(o.background.type),
209
+ 'caption.text': o.caption.mode === 'custom',
210
+ 'caption.font': o.caption.mode !== 'none',
211
+ 'caption.size': o.caption.mode !== 'none',
212
+ 'caption.color': o.caption.mode !== 'none',
213
+ 'card.width': o.card.border !== 'none',
214
+ 'card.borderColor': o.card.border !== 'none',
215
+ 'card.color': o.card.opacity > 0,
216
+ });
217
+ }
218
+ function markerAvailability(key, marker, hasLinks) {
219
+ const visible = hasLinks && marker.shape !== 'none';
220
+ return {
221
+ [`${key}.shape`]: hasLinks,
222
+ [`${key}.size`]: visible,
223
+ [`${key}.offset`]: visible,
224
+ [`${key}.across`]: visible,
225
+ [`${key}.angle`]:
226
+ visible && ['arrow', 'triangle', 'tail'].includes(marker.shape),
227
+ [`${key}.rotation`]: visible && !['circle', 'dot'].includes(marker.shape),
228
+ };
229
+ }
230
+ export { DOUBLET_MARKERS, readDoubletOptions } from './doublet-options.js';
@@ -0,0 +1,146 @@
1
+ import { linkColors } from './tokens.js';
2
+ import { escapeAttribute } from './markers.js';
3
+ import {
4
+ networkShapes,
5
+ networkItemSvg,
6
+ networkDefs,
7
+ networkPointSvg,
8
+ networkLabels,
9
+ networkLabelSvg,
10
+ highlightIds,
11
+ } from './network-scene.js';
12
+
13
+ /** The same markup builder used by the preview, including labels and selection. */
14
+ export function networkToSvg(network, positions, style = {}) {
15
+ const {
16
+ width = 640,
17
+ height = 400,
18
+ view = { x: 0, y: 0, k: 1 },
19
+ colors = linkColors(),
20
+ selected = [],
21
+ hovered,
22
+ } = style;
23
+ const shapes = style.shapes ?? networkShapes(network, positions, style.style);
24
+ const highlighted = highlightIds(network, hovered);
25
+ const items = [...shapes.values()]
26
+ .map((shape) =>
27
+ networkItemSvg(
28
+ shape,
29
+ positions,
30
+ colors,
31
+ selected.includes(shape.id),
32
+ highlighted.has(shape.id)
33
+ )
34
+ )
35
+ .join('');
36
+ const points = [...network.points.keys()]
37
+ .map((id) =>
38
+ networkPointSvg(
39
+ id,
40
+ positions.get(id),
41
+ colors,
42
+ selected.includes(id),
43
+ highlighted.has(id)
44
+ )
45
+ )
46
+ .join('');
47
+ const labels = networkLabels(
48
+ network,
49
+ positions,
50
+ view.k,
51
+ style.labels,
52
+ selected
53
+ )
54
+ .map((label) => networkLabelSvg(label, colors))
55
+ .join('');
56
+ return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" aria-hidden="true"><defs>${networkDefs(colors)}</defs><rect width="${width}" height="${height}" fill="${escapeAttribute(colors.background)}"></rect><g data-part="view" transform="translate(${view.x} ${view.y}) scale(${view.k})"><g data-part="items">${items}</g><g data-part="points">${points}</g><g data-part="labels">${labels}</g></g></svg>`;
57
+ }
58
+
59
+ /** Rasterize an exported SVG locally; always release the object URL. */
60
+ export function networkToPng(
61
+ svg,
62
+ scale = 1,
63
+ {
64
+ document = globalThis.document,
65
+ URL = globalThis.URL,
66
+ Image = globalThis.Image,
67
+ } = {}
68
+ ) {
69
+ return networkToRaster(svg, {
70
+ scale,
71
+ document,
72
+ URL,
73
+ Image,
74
+ maxPixels: Number.MAX_SAFE_INTEGER,
75
+ });
76
+ }
77
+
78
+ function validateRaster({ type, scale, quality, maxPixels }) {
79
+ if (!['image/png', 'image/jpeg', 'image/webp'].includes(type)) {
80
+ throw new RangeError('Unsupported network raster format');
81
+ }
82
+ if (!(Number.isFinite(scale) && scale > 0)) {
83
+ throw new RangeError('Raster scale must be positive and finite');
84
+ }
85
+ if (!(Number.isFinite(quality) && quality >= 0 && quality <= 1)) {
86
+ throw new RangeError('Raster quality must be between zero and one');
87
+ }
88
+ if (!(Number.isSafeInteger(maxPixels) && maxPixels > 0)) {
89
+ throw new RangeError('Raster pixel limit must be a positive safe integer');
90
+ }
91
+ }
92
+
93
+ /** Encode the same SVG as PNG, JPEG or WebP; JPEG gets an explicit matte.
94
+ * The pixel cap bounds allocation before touching the canvas.
95
+ */
96
+ export async function networkToRaster(
97
+ svg,
98
+ {
99
+ type = 'image/png',
100
+ scale = 1,
101
+ quality = 0.92,
102
+ background = '#ffffff',
103
+ maxPixels = 16777216,
104
+ document = globalThis.document,
105
+ URL = globalThis.URL,
106
+ Image = globalThis.Image,
107
+ } = {}
108
+ ) {
109
+ validateRaster({ type, scale, quality, maxPixels });
110
+ const blob = new globalThis.Blob([svg], { type: 'image/svg+xml' });
111
+ const url = URL.createObjectURL(blob);
112
+ try {
113
+ const image = new Image();
114
+ await new Promise((resolve, reject) => {
115
+ image.onload = resolve;
116
+ image.onerror = () => reject(new Error('Unable to load network SVG'));
117
+ image.src = url;
118
+ });
119
+ const width = Math.ceil(image.width * scale);
120
+ const height = Math.ceil(image.height * scale);
121
+ if (!(width > 0 && height > 0 && width * height <= maxPixels)) {
122
+ throw new RangeError('Network raster exceeds pixel limit');
123
+ }
124
+ const canvas = document.createElement('canvas');
125
+ canvas.width = width;
126
+ canvas.height = height;
127
+ const context = canvas.getContext('2d');
128
+ if (type === 'image/jpeg') {
129
+ context.fillStyle = background;
130
+ context.fillRect(0, 0, width, height);
131
+ }
132
+ context.drawImage(image, 0, 0, width, height);
133
+ return await new Promise((resolve, reject) =>
134
+ canvas.toBlob(
135
+ (result) =>
136
+ result?.type === type
137
+ ? resolve(result)
138
+ : reject(new Error(`Raster encoding failed: ${type}`)),
139
+ type,
140
+ quality
141
+ )
142
+ );
143
+ } finally {
144
+ URL.revokeObjectURL(url);
145
+ }
146
+ }