@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,141 @@
1
+ import { defaultVocabulary, loadVocabulary } from '@link-foundation/ui-core';
2
+ import { defineKind } from '@link-foundation/ui-dom';
3
+ import { createEmbed } from './controller.js';
4
+
5
+ const attributes = [
6
+ 'provider',
7
+ 'id',
8
+ 'hash',
9
+ 'theme',
10
+ 'locale',
11
+ 'timeout',
12
+ 'script-timeout',
13
+ 'root-margin',
14
+ 'enabled',
15
+ 'toggle',
16
+ 'debug',
17
+ ];
18
+ const camel = (name) =>
19
+ name.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
20
+ function optionsOf(node, names = attributes) {
21
+ return Object.fromEntries(
22
+ names.map((name) => {
23
+ const value = node.getAttribute(name);
24
+ return [
25
+ camel(name),
26
+ ['enabled', 'toggle', 'debug'].includes(name)
27
+ ? value === null
28
+ ? name === 'enabled'
29
+ ? true
30
+ : false
31
+ : value !== 'false'
32
+ : (value ?? undefined),
33
+ ];
34
+ })
35
+ );
36
+ }
37
+
38
+ /** Define in an explicit window (jsdom/iframes), or the current browser. */
39
+ export function defineEmbedElement(win = globalThis.window) {
40
+ if (!win?.customElements || win.customElements.get('ui-embed')) {
41
+ return win?.customElements?.get('ui-embed');
42
+ }
43
+ class UiEmbed extends win.HTMLElement {
44
+ static observedAttributes = attributes;
45
+ connectedCallback() {
46
+ this.embed?.destroy();
47
+ this.pendingUpdate = undefined;
48
+ this.embed = createEmbed(this, optionsOf(this));
49
+ }
50
+ disconnectedCallback() {
51
+ this.embed?.destroy();
52
+ this.embed = undefined;
53
+ this.pendingUpdate = undefined;
54
+ }
55
+ attributeChangedCallback(name) {
56
+ if (!this.embed) {
57
+ return;
58
+ }
59
+ if (this.pendingUpdate?.controller === this.embed) {
60
+ this.pendingUpdate.names.add(name);
61
+ return;
62
+ }
63
+ const controller = this.embed;
64
+ const pending = { controller, names: new Set([name]) };
65
+ this.pendingUpdate = pending;
66
+ win.queueMicrotask(() => {
67
+ if (this.pendingUpdate !== pending) {
68
+ return;
69
+ }
70
+ this.pendingUpdate = undefined;
71
+ if (this.embed === controller) {
72
+ controller.update(optionsOf(this, [...pending.names]));
73
+ }
74
+ });
75
+ }
76
+ }
77
+ win.customElements.define('ui-embed', UiEmbed);
78
+ return UiEmbed;
79
+ }
80
+
81
+ export const EMBED_KIND_TEXT = `embed: kind
82
+ description 'An allow-listed deferred provider post, with archived children.'
83
+ property provider string
84
+ property id string
85
+ property hash string
86
+ property theme
87
+ enum light dark system
88
+ property locale string
89
+ property timeout number
90
+ property script-timeout number
91
+ property root-margin string
92
+ property enabled
93
+ enum true false
94
+ property toggle
95
+ enum true false
96
+ property debug
97
+ enum true false
98
+ children any`;
99
+
100
+ /** Opt-in extension; the core dialect and HTML import security remain unchanged. */
101
+ export function embedVocabulary(base = defaultVocabulary()) {
102
+ const extension = loadVocabulary(EMBED_KIND_TEXT);
103
+ return Object.freeze({
104
+ ...base,
105
+ kinds: new Map([...base.kinds, ...extension.kinds]),
106
+ });
107
+ }
108
+
109
+ const archives = new WeakMap();
110
+
111
+ defineKind('embed', {
112
+ tag: 'ui-embed',
113
+ create(el, ctx) {
114
+ // Static rendering produces only archive content, without a controller.
115
+ if (ctx.options.interactive !== false) {
116
+ defineEmbedElement(ctx.document.defaultView ?? undefined);
117
+ }
118
+ const node = ctx.document.createElement('ui-embed');
119
+ const archive = ctx.document.createElement('div');
120
+ archive.setAttribute('slot', 'fallback');
121
+ node.appendChild(archive);
122
+ archives.set(node, archive);
123
+ return node;
124
+ },
125
+ childrenSlot: (node) => archives.get(node),
126
+ update(node, el) {
127
+ for (const name of attributes) {
128
+ const value = el.props.get(name)?.[0];
129
+ if (value === undefined) {
130
+ node.removeAttribute(name);
131
+ } else if (node.getAttribute(name) !== String(value)) {
132
+ node.setAttribute(name, String(value));
133
+ }
134
+ }
135
+ },
136
+ destroy(node) {
137
+ node.embed?.destroy();
138
+ },
139
+ });
140
+
141
+ defineEmbedElement();
@@ -0,0 +1,75 @@
1
+ import type { Vocabulary } from '@link-foundation/ui-core';
2
+
3
+ export interface EmbedPost {
4
+ id: string;
5
+ hash: string;
6
+ }
7
+ export interface EmbedLabels {
8
+ title: string;
9
+ archive: string;
10
+ showEmbed: string;
11
+ showArchive: string;
12
+ }
13
+ export interface EmbedContext extends EmbedPost {
14
+ theme: 'light' | 'dark';
15
+ locale: string;
16
+ labels: EmbedLabels;
17
+ url: string;
18
+ window: Window;
19
+ signal: AbortSignal;
20
+ ready(): void;
21
+ unavailable(): void;
22
+ }
23
+ export interface EmbedProvider {
24
+ script: string | null;
25
+ validate(post: EmbedPost): boolean;
26
+ url(
27
+ post: EmbedPost,
28
+ context: { theme: 'light' | 'dark'; locale: string }
29
+ ): string;
30
+ render(
31
+ container: HTMLElement,
32
+ context: EmbedContext
33
+ ): void | (() => void) | Promise<void | (() => void)>;
34
+ }
35
+ export interface EmbedOptions {
36
+ provider?: string;
37
+ id?: string;
38
+ hash?: string;
39
+ theme?: 'light' | 'dark' | 'system';
40
+ locale?: string;
41
+ timeout?: number;
42
+ scriptTimeout?: number;
43
+ rootMargin?: string;
44
+ enabled?: boolean;
45
+ toggle?: boolean;
46
+ debug?: boolean;
47
+ labels?: Partial<EmbedLabels>;
48
+ log?: (...args: unknown[]) => void;
49
+ }
50
+ export interface EmbedController {
51
+ update(options: Partial<EmbedOptions>): void;
52
+ retry(): void;
53
+ destroy(): void;
54
+ }
55
+ export function registerEmbedProvider(
56
+ name: string,
57
+ provider: EmbedProvider
58
+ ): () => void;
59
+ export function getEmbedProvider(
60
+ name: string
61
+ ): Readonly<EmbedProvider> | undefined;
62
+ export function loadEmbedScript(
63
+ document: Document,
64
+ url: string,
65
+ options?: { timeout?: number }
66
+ ): Promise<void>;
67
+ export function createEmbed(
68
+ host: HTMLElement,
69
+ options?: EmbedOptions
70
+ ): EmbedController;
71
+ export function defineEmbedElement(
72
+ win?: Window
73
+ ): CustomElementConstructor | undefined;
74
+ export function embedVocabulary(base?: Vocabulary): Vocabulary;
75
+ export const EMBED_KIND_TEXT: string;
@@ -0,0 +1,9 @@
1
+ /** Opt-in embeds. Import provider adapters separately to populate the allow-list. */
2
+ export { registerEmbedProvider, getEmbedProvider } from './registry.js';
3
+ export { loadEmbedScript } from './script.js';
4
+ export { createEmbed } from './controller.js';
5
+ export {
6
+ defineEmbedElement,
7
+ embedVocabulary,
8
+ EMBED_KIND_TEXT,
9
+ } from './element.js';
@@ -0,0 +1,3 @@
1
+ import type { EmbedProvider } from '../index.js';
2
+ export const telegramProvider: Readonly<EmbedProvider>;
3
+ export const unregisterTelegram: () => void;
@@ -0,0 +1,38 @@
1
+ /** Official standalone post frame: https://core.telegram.org/widgets/post
2
+ * The frame owns its scripts. No parent message listener or cross-origin reads.
3
+ */
4
+ import { registerEmbedProvider } from '../registry.js';
5
+
6
+ export const telegramProvider = Object.freeze({
7
+ script: null,
8
+ validate: ({ id }) =>
9
+ typeof id === 'string' &&
10
+ id.trim() === id &&
11
+ /^[A-Za-z][A-Za-z0-9_]{0,63}\/[0-9]{1,30}$/.test(id),
12
+ url: ({ id }, { theme, locale }) =>
13
+ `https://t.me/${id}?embed=1&dark=${theme === 'dark' ? '1' : '0'}&lang=${encodeURIComponent(locale)}`,
14
+ render(container, context) {
15
+ const frame = container.ownerDocument.createElement('iframe');
16
+ frame.src = context.url;
17
+ frame.title = context.labels.title;
18
+ frame.referrerPolicy = 'no-referrer';
19
+ frame.style.cssText = 'width:100%;height:0;border:0;';
20
+ const loaded = () => {
21
+ frame.style.height = '600px';
22
+ context.ready();
23
+ };
24
+ const failed = () => context.unavailable();
25
+ frame.addEventListener('load', loaded);
26
+ frame.addEventListener('error', failed);
27
+ container.append(frame);
28
+ return () => {
29
+ frame.removeEventListener('load', loaded);
30
+ frame.removeEventListener('error', failed);
31
+ };
32
+ },
33
+ });
34
+
35
+ export const unregisterTelegram = registerEmbedProvider(
36
+ 'telegram',
37
+ telegramProvider
38
+ );
@@ -0,0 +1,3 @@
1
+ import type { EmbedProvider } from '../index.js';
2
+ export const vkProvider: Readonly<EmbedProvider>;
3
+ export const unregisterVK: () => void;
@@ -0,0 +1,42 @@
1
+ /** VK official post widget: https://dev.vk.com/ru/widgets/post */
2
+ import { registerEmbedProvider } from '../registry.js';
3
+ const counters = new WeakMap();
4
+
5
+ export const vkProvider = Object.freeze({
6
+ script: 'https://vk.com/js/api/openapi.js?169',
7
+ validate: ({ id, hash }) =>
8
+ typeof id === 'string' &&
9
+ id.trim() === id &&
10
+ /^-?[0-9]{1,16}_[0-9]{1,16}$/.test(id) &&
11
+ typeof hash === 'string' &&
12
+ hash.trim() === hash &&
13
+ /^[A-Za-z0-9_-]{1,256}$/.test(hash),
14
+ url: ({ id, hash }) => {
15
+ const [owner, post] = id.split('_');
16
+ return `https://vk.com/widget_post.php?owner_id=${owner}&post_id=${post}&hash=${encodeURIComponent(hash)}`;
17
+ },
18
+ render(container, context) {
19
+ const doc = container.ownerDocument;
20
+ const next = (counters.get(doc) ?? 0) + 1;
21
+ counters.set(doc, next);
22
+ container.id = `ui-embed-vk-${next}`;
23
+ const [owner, post] = context.id.split('_');
24
+ container.style.colorScheme = context.theme;
25
+ container.lang = context.locale;
26
+ const widgets = context.window.VK.Widgets;
27
+ const widgetId = widgets.Post(container.id, owner, post, context.hash, {
28
+ dark: context.theme === 'dark' ? 1 : 0,
29
+ lang: context.locale,
30
+ onReady: context.ready,
31
+ });
32
+ // The SDK owns resizing and exposes its RPC cleanup by widget ID.
33
+ return () => {
34
+ widgets.RPC?.[widgetId]?.destroy();
35
+ if (widgets.RPC) {
36
+ delete widgets.RPC[widgetId];
37
+ }
38
+ };
39
+ },
40
+ });
41
+
42
+ export const unregisterVK = registerEmbedProvider('vk', vkProvider);
@@ -0,0 +1,3 @@
1
+ import type { EmbedProvider } from '../index.js';
2
+ export const xProvider: Readonly<EmbedProvider>;
3
+ export const unregisterX: () => void;
@@ -0,0 +1,31 @@
1
+ /** X's official factory: https://developer.x.com/en/docs/x-for-websites */
2
+ import { registerEmbedProvider } from '../registry.js';
3
+
4
+ export const xProvider = Object.freeze({
5
+ script: 'https://platform.twitter.com/widgets.js',
6
+ validate: ({ id }) =>
7
+ typeof id === 'string' && id.trim() === id && /^[0-9]{1,30}$/.test(id),
8
+ url: ({ id }) =>
9
+ `https://platform.twitter.com/embed/Tweet.html?id=${encodeURIComponent(id)}&dnt=true`,
10
+ async render(container, context) {
11
+ const widget = await context.window.twttr.widgets.createTweet(
12
+ context.id,
13
+ container,
14
+ {
15
+ theme: context.theme,
16
+ lang: context.locale,
17
+ dnt: true,
18
+ }
19
+ );
20
+ if (context.signal.aborted) {
21
+ return;
22
+ }
23
+ if (widget) {
24
+ context.ready();
25
+ } else {
26
+ context.unavailable();
27
+ }
28
+ },
29
+ });
30
+
31
+ export const unregisterX = registerEmbedProvider('x', xProvider);
@@ -0,0 +1,35 @@
1
+ /** Adapters are trusted application code, never document-provided URLs/code. */
2
+ const providers = new Map();
3
+
4
+ export function registerEmbedProvider(name, adapter) {
5
+ if (!/^[a-z][a-z0-9-]*$/.test(name) || !adapter) {
6
+ throw new TypeError('Invalid embed provider');
7
+ }
8
+ for (const key of ['validate', 'url', 'render']) {
9
+ if (typeof adapter[key] !== 'function') {
10
+ throw new TypeError(`Embed provider requires ${key}`);
11
+ }
12
+ }
13
+ if (adapter.script !== null && !isEmbedUrl(adapter.script)) {
14
+ throw new TypeError('Embed scripts require an absolute HTTPS URL');
15
+ }
16
+ const value = Object.freeze({ ...adapter });
17
+ providers.set(name, value);
18
+ return () => {
19
+ if (providers.get(name) === value) {
20
+ providers.delete(name);
21
+ }
22
+ };
23
+ }
24
+
25
+ export const getEmbedProvider = (name) => providers.get(name);
26
+
27
+ /** Do not allow credentials, relative URLs or executable URL schemes. */
28
+ export function isEmbedUrl(value) {
29
+ try {
30
+ const url = new globalThis.URL(value);
31
+ return url.protocol === 'https:' && !url.username && !url.password;
32
+ } catch {
33
+ return false;
34
+ }
35
+ }
@@ -0,0 +1,73 @@
1
+ /** Shared per document. Pending requests are canceled when their last user leaves. */
2
+ import { isEmbedUrl } from './registry.js';
3
+ const pages = new WeakMap();
4
+
5
+ function requestScript(document, url, timeout) {
6
+ if (!isEmbedUrl(url)) {
7
+ throw new TypeError('Unsafe embed script URL');
8
+ }
9
+ let cache = pages.get(document);
10
+ if (!cache) {
11
+ cache = new Map();
12
+ pages.set(document, cache);
13
+ }
14
+ if (cache.has(url)) {
15
+ return cache.get(url);
16
+ }
17
+ const win = document.defaultView;
18
+ const script = document.createElement('script');
19
+ script.src = url;
20
+ script.async = true;
21
+ script.referrerPolicy = 'no-referrer';
22
+ const entry = { users: 0, pending: true };
23
+ entry.promise = new Promise((resolve, reject) => {
24
+ const timer = win.setTimeout(() => entry.cancel(), timeout);
25
+ const finish = (ok) => {
26
+ if (!entry.pending) {
27
+ return;
28
+ }
29
+ entry.pending = false;
30
+ win.clearTimeout(timer);
31
+ script.onload = null;
32
+ script.onerror = null;
33
+ if (ok) {
34
+ resolve();
35
+ } else {
36
+ cache.delete(url);
37
+ script.remove();
38
+ reject(new Error('Embed script failed or timed out'));
39
+ }
40
+ };
41
+ entry.cancel = () => finish(false);
42
+ script.onload = () => finish(true);
43
+ script.onerror = entry.cancel;
44
+ });
45
+ cache.set(url, entry);
46
+ (document.head ?? document.documentElement).append(script);
47
+ return entry;
48
+ }
49
+
50
+ /** Low-level page-owned request; use acquireEmbedScript for disposable widgets. */
51
+ export function loadEmbedScript(document, url, { timeout = 10000 } = {}) {
52
+ const entry = requestScript(document, url, timeout);
53
+ entry.users++;
54
+ return entry.promise;
55
+ }
56
+
57
+ export function acquireEmbedScript(document, url, { timeout = 10000 } = {}) {
58
+ const entry = requestScript(document, url, timeout);
59
+ entry.users++;
60
+ let released = false;
61
+ return {
62
+ promise: entry.promise,
63
+ release() {
64
+ if (!released) {
65
+ released = true;
66
+ entry.users--;
67
+ if (entry.users === 0 && entry.pending) {
68
+ entry.cancel();
69
+ }
70
+ }
71
+ },
72
+ };
73
+ }
@@ -0,0 +1,122 @@
1
+ /** All archive content is DOM supplied by the host, never unsanitized HTML text. */
2
+ export function embedView(host) {
3
+ const doc = host.ownerDocument;
4
+ const archive =
5
+ host.querySelector(':scope > [slot="fallback"]') ??
6
+ doc.createElement('div');
7
+ if (!archive.parentNode) {
8
+ archive.append(...host.childNodes);
9
+ }
10
+ archive.setAttribute('slot', 'fallback');
11
+ const live = doc.createElement('div');
12
+ live.dataset.part = 'embed';
13
+ const details = doc.createElement('details');
14
+ const summary = doc.createElement('summary');
15
+ const button = doc.createElement('button');
16
+ button.type = 'button';
17
+ details.append(summary, archive);
18
+ host.append(live, details, button);
19
+ return {
20
+ live,
21
+ archive,
22
+ button,
23
+ show(state, labels, toggle) {
24
+ const fallback = state === 'fallback' || state === 'off';
25
+ live.hidden = fallback;
26
+ if (fallback) {
27
+ details.before(archive);
28
+ } else {
29
+ details.append(archive);
30
+ }
31
+ details.hidden = fallback;
32
+ summary.textContent = labels.archive;
33
+ button.hidden = !toggle;
34
+ button.textContent = fallback ? labels.showEmbed : labels.showArchive;
35
+ button.setAttribute('aria-pressed', String(!fallback));
36
+ host.dataset.state = state;
37
+ host.toggleAttribute('data-loaded', state === 'ready');
38
+ },
39
+ destroy() {
40
+ host.append(archive);
41
+ live.remove();
42
+ details.remove();
43
+ button.remove();
44
+ host.removeAttribute('data-loaded');
45
+ host.removeAttribute('data-state');
46
+ },
47
+ };
48
+ }
49
+
50
+ const english = {
51
+ title: 'Embedded post',
52
+ archive: 'Archived post',
53
+ showEmbed: 'Show embed',
54
+ showArchive: 'Show archive',
55
+ };
56
+ const russian = {
57
+ title: 'Встроенная публикация',
58
+ archive: 'Архив публикации',
59
+ showEmbed: 'Показать публикацию',
60
+ showArchive: 'Показать архив',
61
+ };
62
+
63
+ function inherited(host, names) {
64
+ for (let node = host; node; node = node.parentElement) {
65
+ for (const name of names) {
66
+ const value = node.getAttribute(name);
67
+ if (value) {
68
+ return value;
69
+ }
70
+ }
71
+ }
72
+ }
73
+
74
+ export function embedContext(host, options, media) {
75
+ const scheme = options.theme ?? inherited(host, ['data-scheme']) ?? 'system';
76
+ const theme =
77
+ scheme === 'system' ? (media?.matches ? 'dark' : 'light') : scheme;
78
+ const locale =
79
+ options.locale ?? inherited(host, ['lang', 'data-locale']) ?? 'en';
80
+ const labels = {
81
+ ...(locale.startsWith('ru') ? russian : english),
82
+ ...options.labels,
83
+ };
84
+ return { theme: theme === 'dark' ? 'dark' : 'light', locale, labels };
85
+ }
86
+
87
+ /** Observe same-origin DOM attributes/size only; never inspect iframe documents. */
88
+ export function watchEmbedFrames(container, title, ready) {
89
+ const win = container.ownerDocument.defaultView;
90
+ const frames = new Set();
91
+ const resize = win.ResizeObserver ? new win.ResizeObserver(check) : null;
92
+ function check() {
93
+ for (const frame of container.querySelectorAll('iframe')) {
94
+ if (!frame.getAttribute('title')?.trim()) {
95
+ frame.title = title;
96
+ }
97
+ if (!frames.has(frame)) {
98
+ frames.add(frame);
99
+ resize?.observe(frame);
100
+ frame.addEventListener('load', check);
101
+ }
102
+ if (frame.getBoundingClientRect().height > 0 || frame.offsetHeight > 0) {
103
+ ready();
104
+ }
105
+ }
106
+ }
107
+ const mutations = new win.MutationObserver(check);
108
+ mutations.observe(container, {
109
+ childList: true,
110
+ subtree: true,
111
+ attributes: true,
112
+ attributeFilter: ['height', 'style', 'class', 'title'],
113
+ });
114
+ check();
115
+ return () => {
116
+ mutations.disconnect();
117
+ resize?.disconnect();
118
+ for (const frame of frames) {
119
+ frame.removeEventListener('load', check);
120
+ }
121
+ };
122
+ }
@@ -0,0 +1,15 @@
1
+ import type { AssetRecord } from '../index.js';
2
+ import type { AdapterOptions, AdapterSource, IconAdapter } from './shared.js';
3
+
4
+ export type { AdapterOptions, AdapterSource, IconAdapter } from './shared.js';
5
+ export const LUCIDE_NAMES: Readonly<Record<string, string>>;
6
+ /** Lucide icons derived from Feather (also MIT). */
7
+ export const FEATHER_DERIVED: ReadonlySet<string>;
8
+ export const LUCIDE_ATTRIBUTES: Readonly<Record<string, string | number>>;
9
+ export function lucideRecord(
10
+ name: string,
11
+ options?: { featherDerived?: boolean }
12
+ ): AssetRecord;
13
+ export function loadLucideSvg(name: string): Promise<string>;
14
+ export const LUCIDE: Readonly<IconAdapter>;
15
+ export function createLucideSource(options?: AdapterOptions): AdapterSource;