@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,369 @@
1
+ import { parseNested } from '@link-foundation/ui-core';
2
+
3
+ export const DOUBLET_MARKERS = Object.freeze([
4
+ 'bar',
5
+ 'arrow',
6
+ 'triangle',
7
+ 'tail',
8
+ 'dot',
9
+ 'circle',
10
+ 'square',
11
+ 'diamond',
12
+ 'none',
13
+ ]);
14
+
15
+ // Each call owns its mutable configuration, including explicit marker fields.
16
+ function defaults() {
17
+ const marker = (shape, size, angle = 45, offset = 0) => ({
18
+ shape,
19
+ size,
20
+ angle,
21
+ offset,
22
+ across: 0,
23
+ rotation: 0,
24
+ explicit: [],
25
+ });
26
+ return {
27
+ layout: 'auto',
28
+ layoutAspect: 1,
29
+ columns: 0,
30
+ spread: 1,
31
+ rotation: 0,
32
+ free: 1,
33
+ loop: 1,
34
+ bulge: 0,
35
+ loopBend: 0,
36
+ angles: 'fixed',
37
+ sourceAngle: 30,
38
+ targetAngle: 30,
39
+ tension: 0.4,
40
+ gaps: [0.08, 0.08, 0, 0],
41
+ links: {},
42
+ order: null,
43
+ frame: null,
44
+ padding: 9,
45
+ start: marker('bar', 2.5, 70, 2.5),
46
+ end: marker('arrow', 3.5),
47
+ middle: marker('dot', 2),
48
+ strokeWidth: 1,
49
+ color: '#202b3d',
50
+ dash: 'solid',
51
+ linecap: 'round',
52
+ opacity: 1,
53
+ glow: 0,
54
+ arrowJoin: 'miter',
55
+ balanceArrows: true,
56
+ background: {
57
+ type: 'transparent',
58
+ color: '#ffffff',
59
+ color2: '#dbeafe',
60
+ angle: 0,
61
+ },
62
+ card: {
63
+ color: '#ffffff',
64
+ opacity: 0,
65
+ border: 'none',
66
+ borderColor: '#202b3d',
67
+ width: 1,
68
+ radius: 0,
69
+ inset: 0,
70
+ },
71
+ caption: {
72
+ mode: 'none',
73
+ text: '',
74
+ font: 'mono',
75
+ size: 5,
76
+ color: '#202b3d',
77
+ },
78
+ width: 640,
79
+ height: 640,
80
+ };
81
+ }
82
+
83
+ const RANGES = Object.freeze({
84
+ layoutAspect: Object.freeze([0.3, 3]),
85
+ columns: Object.freeze([0, 30]),
86
+ spread: Object.freeze([0, 100]),
87
+ rotation: Object.freeze([-180, 180]),
88
+ free: Object.freeze([0, 10]),
89
+ loop: Object.freeze([0, 10]),
90
+ bulge: Object.freeze([-180, 180]),
91
+ loopBend: Object.freeze([-180, 180]),
92
+ sourceAngle: Object.freeze([-180, 180]),
93
+ targetAngle: Object.freeze([-180, 180]),
94
+ tension: Object.freeze([0, 2]),
95
+ padding: Object.freeze([0, 48]),
96
+ strokeWidth: Object.freeze([0.5, 10]),
97
+ opacity: Object.freeze([0.1, 1]),
98
+ glow: Object.freeze([0, 12]),
99
+ width: Object.freeze([64, 4096]),
100
+ height: Object.freeze([64, 4096]),
101
+ });
102
+ const ENUMS = Object.freeze({
103
+ layout: 'auto circle grid hex spiral dice cards force layered',
104
+ angles: 'fixed mirror',
105
+ dash: 'solid dashed dotted dashdot long',
106
+ linecap: 'butt round square',
107
+ arrowJoin: 'miter round bevel',
108
+ });
109
+ function numeric(value, range, name) {
110
+ const n =
111
+ typeof value === 'number'
112
+ ? value
113
+ : value.trim() === ''
114
+ ? NaN
115
+ : Number(value);
116
+ if (!Number.isFinite(n) || n < range[0] || n > range[1]) {
117
+ throw new RangeError(`${name} must be in ${range[0]}..${range[1]}`);
118
+ }
119
+ return n;
120
+ }
121
+ function choice(value, choices, name) {
122
+ if (!choices.split(' ').includes(value)) {
123
+ throw new RangeError(`Unknown ${name}: ${value}`);
124
+ }
125
+ return value;
126
+ }
127
+ const atom = (link) => {
128
+ if (link.values.length || link.id === null) {
129
+ throw new TypeError('Expected an option atom');
130
+ }
131
+ return link.id;
132
+ };
133
+ function fields(links, apply) {
134
+ const seen = new Set();
135
+ for (const link of links) {
136
+ const [head, ...values] = link.values;
137
+ const name = link.id ?? (head && atom(head));
138
+ const rest = link.id === null ? values : link.values;
139
+ if (!name || seen.has(name)) {
140
+ throw new TypeError(`Missing or duplicate option: ${name}`);
141
+ }
142
+ seen.add(name);
143
+ apply(name, rest);
144
+ }
145
+ }
146
+ function scalar(values) {
147
+ if (values.length !== 1) {
148
+ throw new TypeError('Expected one option value');
149
+ }
150
+ return atom(values[0]);
151
+ }
152
+ function vector(values, ranges, name, inherit = false) {
153
+ if (values.length !== ranges.length) {
154
+ throw new TypeError(`${name} needs ${ranges.length} values`);
155
+ }
156
+ return values.map((v, i) =>
157
+ inherit && ['~', 'null'].includes(atom(v))
158
+ ? null
159
+ : numeric(atom(v), ranges[i], name)
160
+ );
161
+ }
162
+ function markerOptions(target, values) {
163
+ fields(values, (name, list) => {
164
+ const value = scalar(list);
165
+ if (name === 'shape') {
166
+ target.shape = choice(value, DOUBLET_MARKERS.join(' '), name);
167
+ } else {
168
+ const ranges = {
169
+ size: [0.5, 15],
170
+ angle: [5, 85],
171
+ offset: [-20, 20],
172
+ across: [-20, 20],
173
+ rotation: [-180, 180],
174
+ };
175
+ if (!Object.hasOwn(ranges, name)) {
176
+ throw new TypeError(`Unknown marker option: ${name}`);
177
+ }
178
+ target[name] = numeric(value, ranges[name], name);
179
+ }
180
+ target.explicit.push(name);
181
+ });
182
+ }
183
+ function styleGroup(target, values, group) {
184
+ fields(values, (name, list) => {
185
+ const value = scalar(list);
186
+ if (!Object.hasOwn(target, name)) {
187
+ throw new TypeError(`Unknown ${group} option: ${name}`);
188
+ }
189
+ const enums = {
190
+ type: 'transparent solid linear radial',
191
+ border: 'solid dashed dotted double none',
192
+ mode: 'none theory pairs number links custom',
193
+ font: 'mono sans serif',
194
+ };
195
+ const ranges = {
196
+ opacity: [0, 1],
197
+ width: [0.1, 6],
198
+ radius: [0, 50],
199
+ inset: [0, 30],
200
+ size: [3, 14],
201
+ angle: [-180, 180],
202
+ };
203
+ target[name] = enums[name]
204
+ ? choice(value, enums[name], name)
205
+ : ranges[name]
206
+ ? numeric(value, ranges[name], name)
207
+ : value;
208
+ if (name === 'text' && [...value].length > 80) {
209
+ throw new RangeError('Caption text exceeds 80 characters');
210
+ }
211
+ });
212
+ }
213
+ function linkOptions(values, config, count) {
214
+ const id = numeric(atom(values[0]), [1, count], 'link id');
215
+ if (!Number.isInteger(id) || config.links[id]) {
216
+ throw new RangeError('Duplicate or noninteger link id');
217
+ }
218
+ const entry = { turns: [0, 0], gaps: [null, null, null, null] };
219
+ fields(values.slice(1), (name, list) => {
220
+ if (name === 'turns') {
221
+ entry.turns = vector(
222
+ list,
223
+ [
224
+ [-180, 180],
225
+ [-180, 180],
226
+ ],
227
+ name
228
+ );
229
+ if (!entry.turns.every(Number.isInteger)) {
230
+ throw new RangeError('Turns must be integer degrees');
231
+ }
232
+ } else if (name === 'gaps') {
233
+ entry.gaps = vector(
234
+ list,
235
+ [
236
+ [0, 1],
237
+ [0, 1],
238
+ [0, 30],
239
+ [0, 30],
240
+ ],
241
+ name,
242
+ true
243
+ );
244
+ } else {
245
+ throw new TypeError(`Unknown per-link option: ${name}`);
246
+ }
247
+ });
248
+ config.links[id] = entry;
249
+ }
250
+ function readFrame(values) {
251
+ const raw = values.length === 1 ? parseNested(scalar(values)) : [];
252
+ if (raw.length > 1) {
253
+ throw new TypeError('Frame needs exactly three numbers');
254
+ }
255
+ const parts = raw.length
256
+ ? raw[0].id === null
257
+ ? raw[0].values
258
+ : raw
259
+ : values;
260
+ const frame = vector(
261
+ parts,
262
+ [
263
+ [-1e6, 1e6],
264
+ [-1e6, 1e6],
265
+ [-1e6, 1e6],
266
+ ],
267
+ 'frame'
268
+ );
269
+ if (frame[0] <= 1e-9 || frame[0] > 60) {
270
+ throw new RangeError('Frame scale must be in (1e-9, 60]');
271
+ }
272
+ return frame;
273
+ }
274
+ function specialOption(config, name, values, count) {
275
+ if (name === 'gaps') {
276
+ config.gaps = vector(
277
+ values,
278
+ [
279
+ [0, 1],
280
+ [0, 1],
281
+ [0, 30],
282
+ [0, 30],
283
+ ],
284
+ name
285
+ );
286
+ } else if (name === 'order') {
287
+ config.order = values.map((v) => numeric(atom(v), [1, count], name));
288
+ if (
289
+ config.order.length !== count ||
290
+ new Set(config.order).size !== count ||
291
+ !config.order.every(Number.isInteger)
292
+ ) {
293
+ throw new RangeError('Circle order must be a permutation of every id');
294
+ }
295
+ } else if (name === 'frame') {
296
+ config.frame = readFrame(values);
297
+ } else if (['start', 'end', 'middle'].includes(name)) {
298
+ markerOptions(config[name], values);
299
+ } else if (['background', 'card', 'caption'].includes(name)) {
300
+ styleGroup(config[name], values, name);
301
+ } else if (name === 'balanceArrows') {
302
+ config[name] = choice(scalar(values), 'true false', name) === 'true';
303
+ } else if (name === 'color') {
304
+ config.color = scalar(values);
305
+ } else {
306
+ throw new TypeError(`Unknown doublet option: ${name}`);
307
+ }
308
+ }
309
+
310
+ /** Strict provider options in official, nested Links Notation. */
311
+ export function readDoubletOptions(text = '', count = 0) {
312
+ const config = defaults();
313
+ // Repeated `link` records carry separate per-link overrides.
314
+ const links = parseNested(text);
315
+ const global = [];
316
+ for (const link of links) {
317
+ const name = link.id ?? link.values[0]?.id;
318
+ if (name === 'link') {
319
+ linkOptions(
320
+ link.id === null ? link.values.slice(1) : link.values,
321
+ config,
322
+ count
323
+ );
324
+ } else {
325
+ global.push(link);
326
+ }
327
+ }
328
+ fields(global, (name, values) => {
329
+ if (Object.hasOwn(RANGES, name)) {
330
+ config[name] = numeric(scalar(values), RANGES[name], name);
331
+ } else if (Object.hasOwn(ENUMS, name)) {
332
+ config[name] = choice(scalar(values), ENUMS[name], name);
333
+ } else {
334
+ specialOption(config, name, values, count);
335
+ }
336
+ });
337
+ if (!Number.isInteger(config.columns)) {
338
+ throw new RangeError('Columns must be an integer');
339
+ }
340
+ return config;
341
+ }
342
+
343
+ /** Normalize pairs or the bridge's explicit 1-based item records. */
344
+ export function doubletPairs(items) {
345
+ if (!Array.isArray(items)) {
346
+ throw new TypeError('Doublets must be an array');
347
+ }
348
+ return items.map((item, i) => {
349
+ const pair = Array.isArray(item) ? item : [item?.source, item?.target];
350
+ if (
351
+ pair.length !== 2 ||
352
+ (!Array.isArray(item) && String(item.id) !== String(i + 1))
353
+ ) {
354
+ throw new TypeError(
355
+ 'Doublet items need two ends and sequential 1-based ids'
356
+ );
357
+ }
358
+ return pair.map((value) => {
359
+ const n =
360
+ typeof value === 'string' && value.trim() !== ''
361
+ ? Number(value)
362
+ : value;
363
+ if (!Number.isInteger(n) || n < 0 || n > items.length) {
364
+ throw new RangeError('Doublet references must be integers in 0..n');
365
+ }
366
+ return n;
367
+ });
368
+ });
369
+ }
@@ -0,0 +1,156 @@
1
+ import { fmt } from './geometry.js';
2
+ import { escapeAttribute } from './markers.js';
3
+ import { doubletMarkerSvg } from './doublet-markers.js';
4
+
5
+ /** Compact pair spelling is unambiguous through id 9; larger ids get commas. */
6
+ export function doubletNotation(pairs) {
7
+ return pairs
8
+ .map((pair) =>
9
+ pair.every((id) => id < 10) ? pair.join('') : `(${pair.join(',')})`
10
+ )
11
+ .join(' ');
12
+ }
13
+ export function doubletCaption(pairs, o, index) {
14
+ const { mode, text } = o.caption;
15
+ if (mode === 'none') {
16
+ return '';
17
+ }
18
+ if (mode === 'custom') {
19
+ return text;
20
+ }
21
+ if (mode === 'number') {
22
+ return index;
23
+ }
24
+ if (mode === 'pairs') {
25
+ return pairs.map((p) => `(${p.join(', ')})`).join(' ');
26
+ }
27
+ if (mode === 'links') {
28
+ return pairs.map((p, i) => `${i + 1}: ${p.join(' ')}`).join('; ');
29
+ }
30
+ return `L = {${pairs.map((p, i) => `${i + 1}=(${p.join(',')})`).join(', ')}}`;
31
+ }
32
+ function identifier(frame) {
33
+ const text = JSON.stringify([frame.pairs, frame.options, frame.index]);
34
+ let hash = 2166136261;
35
+ for (let i = 0; i < text.length; i++) {
36
+ hash = Math.imul(hash ^ text.charCodeAt(i), 16777619);
37
+ }
38
+ return `doublet-${hash >>> 0}`;
39
+ }
40
+ function background(o, b, id) {
41
+ const { type, color, color2, angle } = o.background;
42
+ if (type === 'transparent') {
43
+ return { defs: '', body: '' };
44
+ }
45
+ let defs = '';
46
+ const stops = `<stop stop-color="${escapeAttribute(color)}"></stop><stop offset="1" stop-color="${escapeAttribute(color2)}"></stop>`;
47
+ if (type === 'linear') {
48
+ defs = `<linearGradient id="${id}-background" x1="0" x2="1" y1="0.5" y2="0.5" gradientTransform="rotate(${angle} .5 .5)">${stops}</linearGradient>`;
49
+ }
50
+ if (type === 'radial') {
51
+ defs = `<radialGradient id="${id}-background">${stops}</radialGradient>`;
52
+ }
53
+ const fill =
54
+ type === 'solid' ? escapeAttribute(color) : `url(#${id}-background)`;
55
+ return {
56
+ defs,
57
+ body: `<rect data-part="background" width="${b.width}" height="${b.height}" fill="${fill}"></rect>`,
58
+ };
59
+ }
60
+ function rect(card, b, inset, stroke, width, extra = '') {
61
+ const w = Math.max(0, b.width - 2 * inset),
62
+ h = Math.max(0, b.height - 2 * inset);
63
+ return `<rect x="${inset}" y="${inset}" width="${w}" height="${h}" rx="${Math.min(card.radius, w / 2, h / 2)}" ${stroke ? `fill="none" stroke="${escapeAttribute(card.borderColor)}" stroke-width="${width}"` : `fill="${escapeAttribute(card.color)}" fill-opacity="${card.opacity}"`}${extra ? ` ${extra}` : ''}></rect>`;
64
+ }
65
+ function cardSvg(o, b) {
66
+ const c = o.card,
67
+ inset = c.inset + c.width / 2;
68
+ let border = '';
69
+ if (c.border !== 'none') {
70
+ if (c.border === 'double') {
71
+ border =
72
+ rect(c, b, inset, true, c.width / 3) +
73
+ rect(c, b, inset + (c.width * 2) / 3, true, c.width / 3);
74
+ } else {
75
+ const dash =
76
+ c.border === 'dashed'
77
+ ? `${c.width * 3} ${c.width * 2}`
78
+ : c.border === 'dotted'
79
+ ? `0 ${c.width * 2}`
80
+ : '';
81
+ border = rect(
82
+ c,
83
+ b,
84
+ inset,
85
+ true,
86
+ c.width,
87
+ `stroke-dasharray="${dash}" stroke-linecap="round"`
88
+ );
89
+ }
90
+ }
91
+ return `<g data-part="card">${rect(c, b, c.inset, false, 0)}${border}</g>`;
92
+ }
93
+ function captionSvg(frame) {
94
+ const o = frame.options,
95
+ text = doubletCaption(frame.pairs, o, frame.index);
96
+ if (!text) {
97
+ return '';
98
+ }
99
+ const inset =
100
+ o.card.inset + (o.card.border === 'none' ? 0 : o.card.width) + 2;
101
+ const available = Math.max(1, frame.bounds.width - 2 * inset);
102
+ const font = { mono: 'monospace', sans: 'sans-serif', serif: 'serif' }[
103
+ o.caption.font
104
+ ];
105
+ const compress =
106
+ [...text].length * o.caption.size > available
107
+ ? ` textLength="${available}" lengthAdjust="spacingAndGlyphs"`
108
+ : '';
109
+ return `<text data-part="caption" x="${frame.bounds.width / 2}" y="${frame.bounds.height - inset - o.caption.size * 0.3}" text-anchor="middle" font-family="${font}" font-size="${o.caption.size}" fill="${escapeAttribute(o.caption.color)}"${compress}>${escapeAttribute(text)}</text>`;
110
+ }
111
+ function curveData(visible) {
112
+ const point = (p) => `${fmt(p.x, 8)} ${fmt(p.y, 8)}`;
113
+ let data = '',
114
+ previous;
115
+ visible.forEach((s) => {
116
+ if (!s) {
117
+ return;
118
+ }
119
+ if (!previous || previous.x !== s.p0.x || previous.y !== s.p0.y) {
120
+ data += `M ${point(s.p0)} `;
121
+ }
122
+ data += `C ${point(s.c1)} ${point(s.c2)} ${point(s.p3)} `;
123
+ previous = s.p3;
124
+ });
125
+ return data.trim();
126
+ }
127
+
128
+ /** Deterministic preview/export markup, all measurements in the 100-unit box. */
129
+ export function doubletToSvg(frame) {
130
+ const o = frame.options,
131
+ b = frame.bounds,
132
+ id = identifier(frame),
133
+ bg = background(o, b, id);
134
+ const label = `Links network${frame.pairs.length ? ` ${doubletNotation(frame.pairs)}` : ''}`;
135
+ const dash = {
136
+ solid: '',
137
+ dashed: '4 2',
138
+ dotted: '0 2',
139
+ dashdot: '4 2 0 2',
140
+ long: '8 3',
141
+ }[o.dash]
142
+ .split(' ')
143
+ .filter(Boolean)
144
+ .map((v) => Number(v) * o.strokeWidth)
145
+ .join(' ');
146
+ const glow = o.glow
147
+ ? `<filter id="${id}-glow" x="-100%" y="-100%" width="300%" height="300%"><feGaussianBlur stdDeviation="${o.glow / 3}"></feGaussianBlur><feMerge><feMergeNode></feMergeNode><feMergeNode in="SourceGraphic"></feMergeNode></feMerge></filter>`
148
+ : '';
149
+ const items = frame.curves
150
+ .map((curve) => {
151
+ const d = curveData(curve.visible);
152
+ return `<g data-doublet="${curve.id}">${d ? `<path data-link="${curve.id}" d="${d}" fill="none" stroke="currentColor" stroke-width="${o.strokeWidth}" stroke-linecap="${o.linecap}" stroke-dasharray="${dash}"></path>` : ''}${curve.markers.map((p) => doubletMarkerSvg(p, o)).join('')}</g>`;
153
+ })
154
+ .join('');
155
+ return `<svg xmlns="http://www.w3.org/2000/svg" width="${o.width}" height="${o.height}" viewBox="0 0 ${b.width} ${b.height}" role="img" aria-label="${escapeAttribute(label)}"><title>${escapeAttribute(label)}</title><defs>${bg.defs}${glow}</defs>${bg.body}${cardSvg(o, b)}<g data-part="links" color="${escapeAttribute(o.color)}" opacity="${o.opacity}"${o.glow ? ` filter="url(#${id}-glow)"` : ''}>${items}</g>${captionSvg(frame)}</svg>`;
156
+ }