@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,97 @@
1
+ /**
2
+ * `button`: a native `<button>` (keyboard activation, focus and the button
3
+ * role for free) with an optional icon and a label. The machine
4
+ * (`button-machine`) tracks the pressed state for styling; activation is
5
+ * the native click, which ui-dom maps to `(on press ...)`.
6
+ *
7
+ * (save: button 'Save' (variant filled) (icon check) (on press (emit save)))
8
+ */
9
+
10
+ import { buttonParts } from './button-template.js';
11
+ import { defineIconElement } from '../icons/icon.js';
12
+ import {
13
+ atomOf,
14
+ changesOf,
15
+ flagOf,
16
+ isLive,
17
+ partId,
18
+ partOf,
19
+ setAttr,
20
+ setText,
21
+ startControl,
22
+ stopControl,
23
+ controlOf,
24
+ } from './dom.js';
25
+
26
+ const TYPES = new Set(['button', 'submit', 'reset']);
27
+
28
+ /** The native button of a button node. */
29
+ const buttonOf = (node) => node.firstChild;
30
+
31
+ /**
32
+ * Build `<tag><button data-part=root><ui-icon data-part=icon>
33
+ * <span data-part=label></button></tag>` and start the machine.
34
+ */
35
+ export function createButton(el, ctx, { tag, kind }) {
36
+ const doc = ctx.document;
37
+ if (isLive(ctx)) {
38
+ defineIconElement(doc.defaultView);
39
+ }
40
+ const node = doc.createElement(tag);
41
+ const button = partOf(doc, 'button', 'root', {
42
+ type: 'button',
43
+ id: partId(el.id),
44
+ });
45
+ const icon = partOf(doc, 'ui-icon', 'icon', { 'aria-hidden': 'true' });
46
+ const label = partOf(doc, 'span', 'label');
47
+ if (!buttonParts(button, ctx, kind)) {
48
+ button.appendChild(icon);
49
+ button.appendChild(label);
50
+ }
51
+ node.appendChild(button);
52
+ startControl(node, el, ctx, {
53
+ kind,
54
+ parts: { root: button },
55
+ target: button,
56
+ });
57
+ return node;
58
+ }
59
+
60
+ /** Apply the properties every button kind has. */
61
+ export function updateButton(node, el, has) {
62
+ const button = buttonOf(node);
63
+ const icon = button.querySelector('[data-part="icon"]');
64
+ if (has('icon')) {
65
+ setAttr(icon, 'name', atomOf(el, 'icon'));
66
+ icon.toggleAttribute('hidden', atomOf(el, 'icon') === undefined);
67
+ }
68
+ if (has('type')) {
69
+ const type = atomOf(el, 'type');
70
+ button.setAttribute('type', TYPES.has(type) ? type : 'button');
71
+ }
72
+ if (has('disabled')) {
73
+ const disabled = flagOf(el, 'disabled');
74
+ button.toggleAttribute('disabled', disabled);
75
+ controlOf(node)?.assign({ disabled });
76
+ }
77
+ }
78
+
79
+ export const BUTTON_KIND = Object.freeze({
80
+ tag: 'ui-button',
81
+ childrenSlot: null,
82
+ attributes: { variant: 'string', disabled: 'boolean' },
83
+ create: (el, ctx) =>
84
+ createButton(el, ctx, { tag: 'ui-button', kind: 'button' }),
85
+ eventTarget: buttonOf,
86
+ update(node, el, changed) {
87
+ const has = changesOf(node, changed);
88
+ updateButton(node, el, has);
89
+ if (has('label')) {
90
+ setText(
91
+ buttonOf(node).querySelector('[data-part="label"]'),
92
+ atomOf(el, 'label')
93
+ );
94
+ }
95
+ },
96
+ destroy: stopControl,
97
+ });
@@ -0,0 +1,84 @@
1
+ button: control
2
+ title 'Button'
3
+ stories button-stories
4
+ apg button
5
+ icon-button: control
6
+ title 'Icon button'
7
+ stories icon-button-stories
8
+ apg button
9
+ label: control
10
+ title 'Label'
11
+ stories label-stories
12
+ apg none
13
+ link: control
14
+ title 'Link'
15
+ stories link-stories
16
+ apg link
17
+ text-field: control
18
+ title 'Text field'
19
+ stories text-field-stories
20
+ apg none
21
+ text-area: control
22
+ title 'Text area'
23
+ stories text-area-stories
24
+ apg none
25
+ number-field: control
26
+ title 'Number field'
27
+ stories number-field-stories
28
+ apg spinbutton
29
+ color-field: control
30
+ title 'Colour field'
31
+ stories color-field-stories
32
+ apg none
33
+ checkbox: control
34
+ title 'Checkbox'
35
+ stories checkbox-stories
36
+ apg checkbox
37
+ radio-group: control
38
+ title 'Radio group'
39
+ stories radio-group-stories
40
+ apg radio
41
+ radio: control
42
+ title 'Radio'
43
+ stories radio-stories
44
+ apg radio
45
+ switch: control
46
+ title 'Switch'
47
+ stories switch-stories
48
+ apg switch
49
+ slider: control
50
+ title 'Slider'
51
+ stories slider-stories
52
+ apg slider
53
+ select: control
54
+ title 'Select'
55
+ stories select-stories
56
+ apg combobox
57
+ combobox: control
58
+ title 'Combobox'
59
+ stories combobox-stories
60
+ apg combobox
61
+ option: control
62
+ title 'Option'
63
+ stories option-stories
64
+ apg listbox
65
+ progress: control
66
+ title 'Progress'
67
+ stories progress-stories
68
+ apg none
69
+ badge: control
70
+ title 'Badge'
71
+ stories badge-stories
72
+ apg none
73
+ avatar: control
74
+ title 'Avatar'
75
+ stories avatar-stories
76
+ apg none
77
+ chip: control
78
+ title 'Chip'
79
+ stories chip-stories
80
+ apg none
81
+ accordion: control
82
+ title 'Accordion'
83
+ stories accordion-stories
84
+ apg accordion
@@ -0,0 +1,112 @@
1
+ /**
2
+ * `checkbox`: a native `<input type=checkbox>` in its `<label>`.
3
+ * `(checked mixed)` is the indeterminate state (shown with the native
4
+ * `indeterminate` flag, read as "mixed"); the next toggle checks it.
5
+ * A form submits `value` (default `on`) when it is checked.
6
+ *
7
+ * (terms: checkbox 'I accept the terms' (name terms) (required true))
8
+ * (all: checkbox 'Select all' (checked mixed))
9
+ */
10
+
11
+ import {
12
+ atomOf,
13
+ changesOf,
14
+ commitValue,
15
+ controlOf,
16
+ flagOf,
17
+ partId,
18
+ partOf,
19
+ receive,
20
+ setAttr,
21
+ setText,
22
+ startControl,
23
+ stopControl,
24
+ } from './dom.js';
25
+
26
+ /** The `checked` property: `true`, `false` or `'mixed'`. */
27
+ export function checkedOf(el) {
28
+ const value = atomOf(el, 'checked');
29
+ if (value === 'mixed') {
30
+ return 'mixed';
31
+ }
32
+ return value === 'true';
33
+ }
34
+
35
+ /** Show the state on the native input, then commit a user change. */
36
+ function render(control) {
37
+ const { input } = control.parts;
38
+ const checked = control.service.context.checked;
39
+ input.checked = checked === true;
40
+ input.indeterminate = checked === 'mixed';
41
+ commitValue(control, 'checked', checked);
42
+ }
43
+
44
+ /** `<tag><label data-part=root><input data-part=input><span data-part=indicator><span data-part=label></label></tag>` */
45
+ export function createCheckControl(el, ctx, tag, inputAttrs) {
46
+ const doc = ctx.document;
47
+ const node = doc.createElement(tag);
48
+ const root = partOf(doc, 'label', 'root');
49
+ const input = partOf(doc, 'input', 'input', {
50
+ id: partId(el.id),
51
+ ...inputAttrs,
52
+ });
53
+ const indicator = partOf(doc, 'span', 'indicator', { 'aria-hidden': 'true' });
54
+ const label = partOf(doc, 'span', 'label');
55
+ root.appendChild(input);
56
+ root.appendChild(indicator);
57
+ root.appendChild(label);
58
+ node.appendChild(root);
59
+ return { node, input, indicator, label };
60
+ }
61
+
62
+ export const CHECKBOX_KIND = Object.freeze({
63
+ tag: 'ui-checkbox',
64
+ childrenSlot: null,
65
+ attributes: { disabled: 'boolean', invalid: 'boolean' },
66
+ create(el, ctx) {
67
+ const { node, input, label } = createCheckControl(el, ctx, 'ui-checkbox', {
68
+ type: 'checkbox',
69
+ });
70
+ startControl(node, el, ctx, {
71
+ kind: 'checkbox',
72
+ parts: { input, label },
73
+ target: input,
74
+ render,
75
+ });
76
+ return node;
77
+ },
78
+ eventTarget: (node) => node.firstChild.firstChild,
79
+ update(node, el, changed, ctx) {
80
+ const has = changesOf(node, changed);
81
+ const control = controlOf(node);
82
+ const { input, label } = control.parts;
83
+ if (has('label')) {
84
+ const text = atomOf(el, 'label');
85
+ setText(label, text);
86
+ if (text === undefined || text === '') {
87
+ ctx.diagnostic('missing-label', 'warning', { property: 'label' });
88
+ }
89
+ }
90
+ if (has('name')) {
91
+ setAttr(input, 'name', atomOf(el, 'name'));
92
+ }
93
+ if (has('value')) {
94
+ setAttr(input, 'value', atomOf(el, 'value') ?? 'on');
95
+ }
96
+ for (const name of ['disabled', 'required', 'invalid']) {
97
+ if (has(name)) {
98
+ const on = flagOf(el, name);
99
+ if (name !== 'invalid') {
100
+ input.toggleAttribute(name, on);
101
+ }
102
+ control.assign({ [name]: on });
103
+ }
104
+ }
105
+ if (has('checked')) {
106
+ const checked = checkedOf(el);
107
+ input.toggleAttribute('checked', checked === true);
108
+ receive(control, checked, { checked });
109
+ }
110
+ },
111
+ destroy: stopControl,
112
+ });
@@ -0,0 +1,140 @@
1
+ /**
2
+ * `chip`: a compact label. With `(removable true)` it has a native remove
3
+ * button, named `Remove LABEL` unless `remove-label` says otherwise (give
4
+ * a translated one in a localized document). A click, Enter, Space, Delete
5
+ * or Backspace removes the chip: it commits `(removed true)` as a
6
+ * `ui-change` event, hides, and passes keyboard focus to the next chip of
7
+ * its row, else the previous one, else the row itself, so focus is never
8
+ * lost. `(on change ...)` is where a host removes the value it stands for.
9
+ *
10
+ * (ada: chip Ada (value ada) (removable true)
11
+ * (on change (emit person-removed)))
12
+ */
13
+
14
+ import {
15
+ atomOf,
16
+ changesOf,
17
+ commitValue,
18
+ controlOf,
19
+ driveControl,
20
+ flagOf,
21
+ partOf,
22
+ setAttr,
23
+ setText,
24
+ startControl,
25
+ stopControl,
26
+ updateLabel,
27
+ } from './dom.js';
28
+
29
+ export const CHIP_VARIANTS = Object.freeze(['filled', 'outlined']);
30
+ export const CHIP_TONES = Object.freeze(['neutral', 'primary', 'error']);
31
+
32
+ /** The remove button of a chip, when it can take focus. */
33
+ const removeOf = (chip) => {
34
+ const button = chip.querySelector(':scope [data-part="remove"]');
35
+ return button && !button.hidden && !button.disabled ? button : null;
36
+ };
37
+
38
+ /** Pass focus on from a chip that is about to hide. */
39
+ function passFocus(node) {
40
+ const row = node.parentElement;
41
+ if (row === null) {
42
+ return;
43
+ }
44
+ const chips = [...row.children].filter(
45
+ (child) => child.localName === 'ui-chip' && !child.hidden
46
+ );
47
+ const at = chips.indexOf(node);
48
+ const next = [...chips.slice(at + 1), ...chips.slice(0, at).reverse()]
49
+ .map(removeOf)
50
+ .find(Boolean);
51
+ if (next) {
52
+ next.focus();
53
+ } else {
54
+ row.setAttribute('tabindex', '-1');
55
+ row.focus();
56
+ }
57
+ }
58
+
59
+ function render(control) {
60
+ const { node, parts, service } = control;
61
+ const removed = service.state === 'removed';
62
+ if (removed && parts.remove.ownerDocument.activeElement === parts.remove) {
63
+ passFocus(node);
64
+ }
65
+ node.toggleAttribute('hidden', removed);
66
+ if (!control.driven) {
67
+ commitValue(control, 'removed', removed);
68
+ }
69
+ }
70
+
71
+ export const CHIP_KIND = Object.freeze({
72
+ tag: 'ui-chip',
73
+ childrenSlot: null,
74
+ attributes: { disabled: 'boolean' },
75
+ create(el, ctx) {
76
+ const doc = ctx.document;
77
+ const node = doc.createElement('ui-chip');
78
+ const root = partOf(doc, 'span', 'root');
79
+ const label = partOf(doc, 'span', 'label');
80
+ const remove = partOf(doc, 'button', 'remove', { type: 'button' });
81
+ remove.appendChild(partOf(doc, 'span', 'icon', { 'aria-hidden': 'true' }));
82
+ setText(remove.firstChild, '×');
83
+ root.appendChild(label);
84
+ root.appendChild(remove);
85
+ node.appendChild(root);
86
+ const control = startControl(node, el, ctx, {
87
+ kind: 'chip',
88
+ parts: { root, remove },
89
+ target: node,
90
+ render,
91
+ });
92
+ control.label = label;
93
+ control.value = false;
94
+ return node;
95
+ },
96
+ update(node, el, changed, ctx) {
97
+ const has = changesOf(node, changed);
98
+ const control = controlOf(node);
99
+ const { remove } = control.parts;
100
+ if (has('label')) {
101
+ updateLabel(control.label, el, ctx);
102
+ }
103
+ if (has('label') || has('remove-label')) {
104
+ setAttr(
105
+ remove,
106
+ 'aria-label',
107
+ atomOf(el, 'remove-label') ??
108
+ `Remove ${atomOf(el, 'label') ?? ''}`.trim()
109
+ );
110
+ }
111
+ if (has('value')) {
112
+ setAttr(node, 'data-value', atomOf(el, 'value'));
113
+ }
114
+ if (has('variant')) {
115
+ const variant = atomOf(el, 'variant');
116
+ setAttr(
117
+ node,
118
+ 'variant',
119
+ CHIP_VARIANTS.includes(variant) ? variant : 'filled'
120
+ );
121
+ }
122
+ if (has('tone')) {
123
+ const tone = atomOf(el, 'tone');
124
+ setAttr(node, 'tone', CHIP_TONES.includes(tone) ? tone : 'neutral');
125
+ }
126
+ if (has('removable')) {
127
+ remove.toggleAttribute('hidden', !flagOf(el, 'removable'));
128
+ }
129
+ const disabled = flagOf(el, 'disabled');
130
+ if (has('disabled')) {
131
+ remove.toggleAttribute('disabled', disabled);
132
+ control.assign({ disabled });
133
+ }
134
+ if (has('removed')) {
135
+ const removed = flagOf(el, 'removed');
136
+ driveControl(control, removed ? 'remove' : 'restore', removed, disabled);
137
+ }
138
+ },
139
+ destroy: stopControl,
140
+ });
@@ -0,0 +1,45 @@
1
+ /**
2
+ * The chosen child of a choice control (`radio-group` with `radio`
3
+ * children, `select` and `combobox` with `option` children).
4
+ *
5
+ * A live control marks its children itself (it watches them); in the
6
+ * static document of `renderToHTML` the children are rendered after their
7
+ * parent, so the parent records which child IDs are chosen here and the
8
+ * child reads it when it renders.
9
+ */
10
+
11
+ import { atomOf, isLive } from './dom.js';
12
+
13
+ const chosen = new WeakMap();
14
+
15
+ /** The value of a choice child: its `value`, else its ID. */
16
+ export const choiceValue = (el) => atomOf(el, 'value') ?? el.id;
17
+
18
+ /**
19
+ * Record (static rendering) which children of a choice control are
20
+ * chosen: the ones whose value is `value`.
21
+ */
22
+ export function recordChosen(ctx, value) {
23
+ if (isLive(ctx)) {
24
+ return;
25
+ }
26
+ let ids = chosen.get(ctx.document);
27
+ if (ids === undefined) {
28
+ ids = new Set();
29
+ chosen.set(ctx.document, ids);
30
+ }
31
+ for (const child of ctx.children()) {
32
+ if (value !== null && choiceValue(child) === value) {
33
+ ids.add(child.id);
34
+ } else {
35
+ ids.delete(child.id);
36
+ }
37
+ }
38
+ }
39
+
40
+ /** Whether a child was recorded as chosen (static rendering). */
41
+ export const wasChosen = (ctx, id) =>
42
+ chosen.get(ctx.document)?.has(id) === true;
43
+
44
+ /** The visible label of a choice child (its `label`, else its value). */
45
+ export const choiceLabel = (el) => atomOf(el, 'label') ?? choiceValue(el);
@@ -0,0 +1,217 @@
1
+ /**
2
+ * `color-field`: a hex text input and the native colour picker
3
+ * (`<input type=color>`, the `indicator` part) side by side. Both commit
4
+ * the normalised `#rrggbb`; text that is not a hex colour makes the field
5
+ * invalid and keeps the last colour. Escape restores it.
6
+ *
7
+ * (accent: color-field 'Accent' (name accent) (value '#6750a4'))
8
+ */
9
+
10
+ import { contrastRatio } from '@link-foundation/ui-tokens/themes';
11
+ import {
12
+ changesOf,
13
+ commitValue,
14
+ partOf,
15
+ receive,
16
+ setAttr,
17
+ stopControl,
18
+ textOf,
19
+ setText,
20
+ flagOf,
21
+ } from './dom.js';
22
+ import { colorPopover, paletteGroups } from './color-popover.js';
23
+ import { createRgb, renderRgb, updateRgb } from './color-rgb.js';
24
+ import { formatColor as formatHex } from './color.js';
25
+ import { createTextControl, inputOf, updateTextControl } from './text-field.js';
26
+
27
+ /** The picker shows black for no colour. */
28
+ const PICKER_DEFAULT = '#000000';
29
+
30
+ function paintSwatch(node, color) {
31
+ node.style.backgroundColor = color;
32
+ node.style.color =
33
+ contrastRatio('#000000', color) >= 4.5 ? '#000000' : '#ffffff';
34
+ }
35
+
36
+ const actions = (input, getControl) => ({
37
+ 'read-value': (args, meta) => {
38
+ const text = input.value.trim();
39
+ const strict = getControl().strictHex;
40
+ const hex =
41
+ strict && !/^#[0-9a-f]{6}$/i.test(input.value) ? null : formatHex(text);
42
+ if (text === '' && !strict) {
43
+ meta.assign({ value: null, invalid: false });
44
+ } else {
45
+ meta.assign(
46
+ hex === null ? { invalid: true } : { value: hex, invalid: false }
47
+ );
48
+ }
49
+ },
50
+ 'read-picker': (args, meta) => {
51
+ const picker = input.nextSibling;
52
+ meta.assign({ value: formatHex(picker.value), invalid: false });
53
+ },
54
+ 'restore-value': (args, meta) => {
55
+ meta.assign({ invalid: false });
56
+ input.value = meta.context.value ?? '';
57
+ },
58
+ });
59
+
60
+ /** Show the colour in both inputs, then commit it when the user changed it. */
61
+ function render(control) {
62
+ const { context } = control.service;
63
+ const { input, indicator } = control.parts;
64
+ if (context.invalid !== true && input.value !== (context.value ?? '')) {
65
+ input.value = context.value ?? '';
66
+ }
67
+ const picked = context.value ?? PICKER_DEFAULT;
68
+ if (indicator.value !== picked) {
69
+ indicator.value = picked;
70
+ }
71
+ renderRgb(control);
72
+ if (control.parts.swatch) {
73
+ paintSwatch(control.parts.swatch, picked);
74
+ }
75
+ for (const { button, color } of control.parts.paletteButtons) {
76
+ button.setAttribute('aria-pressed', String(color === picked));
77
+ }
78
+ commitValue(control);
79
+ }
80
+
81
+ function updatePalette(control, el, doc) {
82
+ const palette = control.parts.palette;
83
+ setText(palette, '');
84
+ control.parts.paletteButtons = [];
85
+ const groups = paletteGroups(el.props.get('palettes'));
86
+ for (const group of groups) {
87
+ const fieldset = partOf(doc, 'fieldset', null);
88
+ const legend = partOf(doc, 'legend', null);
89
+ setText(legend, group.name);
90
+ fieldset.appendChild(legend);
91
+ palette.appendChild(fieldset);
92
+ for (const item of group.colors ?? []) {
93
+ const color = formatHex(item.hex);
94
+ if (!color) {
95
+ continue;
96
+ }
97
+ const chip = partOf(doc, 'button', null, {
98
+ type: 'button',
99
+ 'aria-label': `${item.name} ${color}`,
100
+ });
101
+ chip.setAttribute('data-color', color);
102
+ control.parts.paletteButtons.push({ button: chip, color });
103
+ setText(chip, item.name);
104
+ paintSwatch(chip, color);
105
+ chip.addEventListener('click', () => {
106
+ if (
107
+ !control.service.context.disabled &&
108
+ !control.service.context.readonly
109
+ ) {
110
+ control.assign({ value: color, invalid: false });
111
+ }
112
+ });
113
+ fieldset.appendChild(chip);
114
+ }
115
+ }
116
+ for (const pair of el.props.get('palette') ?? []) {
117
+ const values = Array.isArray(pair) ? pair : pair?.values;
118
+ if (!Array.isArray(values) || values.length !== 2) {
119
+ continue;
120
+ }
121
+ const [name, raw] = values;
122
+ const color = formatHex(raw);
123
+ if (!color) {
124
+ continue;
125
+ }
126
+ const button = partOf(doc, 'button', null, { type: 'button' });
127
+ setText(button, name);
128
+ button.setAttribute('data-color', color);
129
+ control.parts.paletteButtons.push({ button, color });
130
+ button.setAttribute('aria-label', `${name} ${color}`);
131
+ button.addEventListener('click', () => {
132
+ if (
133
+ !control.service.context.disabled &&
134
+ !control.service.context.readonly
135
+ ) {
136
+ control.assign({ value: color, invalid: false });
137
+ }
138
+ });
139
+ palette.appendChild(button);
140
+ }
141
+ }
142
+
143
+ export const COLOR_FIELD_KIND = Object.freeze({
144
+ tag: 'ui-color-field',
145
+ childrenSlot: null,
146
+ attributes: { disabled: 'boolean', invalid: 'boolean' },
147
+ create: (el, ctx) =>
148
+ createTextControl(el, ctx, {
149
+ tag: 'ui-color-field',
150
+ kind: 'color-field',
151
+ attrs: {
152
+ type: 'text',
153
+ autocomplete: 'off',
154
+ spellcheck: 'false',
155
+ maxlength: '32',
156
+ },
157
+ children: (doc, node, getControl) => {
158
+ const indicator = partOf(doc, 'input', 'indicator', {
159
+ type: 'color',
160
+ tabindex: '-1',
161
+ 'aria-hidden': 'true',
162
+ value: PICKER_DEFAULT,
163
+ });
164
+ node.appendChild(indicator);
165
+ const palette = partOf(doc, 'div', 'palette', {
166
+ role: 'group',
167
+ 'aria-label': 'Palette',
168
+ });
169
+ node.appendChild(palette);
170
+ return {
171
+ indicator,
172
+ palette,
173
+ paletteButtons: [],
174
+ ...createRgb(doc, node, getControl),
175
+ };
176
+ },
177
+ actions,
178
+ render,
179
+ }),
180
+ eventTarget: inputOf,
181
+ update(node, el, changed, ctx) {
182
+ const has = changesOf(node, changed);
183
+ const { input, control } = updateTextControl(node, el, ctx, has);
184
+ control.strictHex = textOf(el, 'mode') === 'popover';
185
+ colorPopover(control, el);
186
+ control.popover?.update(el);
187
+ const { indicator } = control.parts;
188
+ const disabled = flagOf(el, 'disabled') || flagOf(el, 'readonly');
189
+ indicator.toggleAttribute('disabled', disabled);
190
+ control.parts.palette.setAttribute(
191
+ 'aria-label',
192
+ textOf(el, 'palette-label') || `${textOf(el, 'label') || el.id} palette`
193
+ );
194
+ if (has('palette') || has('palettes')) {
195
+ updatePalette(control, el, ctx.document);
196
+ render(control);
197
+ }
198
+ control.parts.palette.toggleAttribute(
199
+ 'hidden',
200
+ control.parts.palette.children.length === 0
201
+ );
202
+ for (const { button } of control.parts.paletteButtons) {
203
+ button.toggleAttribute('disabled', disabled);
204
+ }
205
+ updateRgb(control, el);
206
+ if (control.strictHex) {
207
+ control.parts.rgb.hidden = false;
208
+ }
209
+ if (has('value')) {
210
+ const hex = formatHex(textOf(el, 'value'));
211
+ setAttr(input, 'value', hex ?? '');
212
+ setAttr(indicator, 'value', hex ?? PICKER_DEFAULT);
213
+ receive(control, hex);
214
+ }
215
+ },
216
+ destroy: stopControl,
217
+ });