@jcsoftdev/ui 0.2.3 → 0.4.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 (601) hide show
  1. package/CHANGELOG.md +390 -7
  2. package/README.md +57 -3
  3. package/bin/ui-theme.mjs +1162 -25
  4. package/dist/ai/attachment/attachment.js +1 -1
  5. package/dist/ai/chat-list/group.js +3 -1
  6. package/dist/ai/conversation/conversation.js +1 -1
  7. package/dist/ai/internal/use-copy.d.ts +1 -5
  8. package/dist/ai/internal/use-copy.js +1 -32
  9. package/dist/ai/markdown/parse.js +59 -17
  10. package/dist/ai/source/source.js +1 -1
  11. package/dist/atoms/avatar/avatar.d.ts +13 -3
  12. package/dist/atoms/avatar/avatar.js +40 -2
  13. package/dist/atoms/avatar/index.d.ts +1 -1
  14. package/dist/atoms/avatar/index.js +3 -1
  15. package/dist/atoms/button/button.d.ts +4 -1
  16. package/dist/atoms/button/button.js +4 -2
  17. package/dist/atoms/checkbox/checkbox.d.ts +8 -3
  18. package/dist/atoms/checkbox/checkbox.js +26 -3
  19. package/dist/atoms/chip/chip.d.ts +19 -5
  20. package/dist/atoms/chip/chip.js +34 -5
  21. package/dist/atoms/chip/index.d.ts +1 -1
  22. package/dist/atoms/chip/index.js +6 -1
  23. package/dist/atoms/due-chip/due-chip.d.ts +31 -0
  24. package/dist/atoms/due-chip/due-chip.js +41 -0
  25. package/dist/atoms/due-chip/index.d.ts +2 -0
  26. package/dist/atoms/due-chip/index.js +6 -0
  27. package/dist/atoms/due-chip/model.d.ts +25 -0
  28. package/dist/atoms/due-chip/model.js +44 -0
  29. package/dist/atoms/icon-button/icon-button.d.ts +22 -0
  30. package/dist/atoms/icon-button/icon-button.js +38 -0
  31. package/dist/atoms/icon-button/index.d.ts +1 -0
  32. package/dist/atoms/icon-button/index.js +8 -0
  33. package/dist/atoms/index.d.ts +5 -0
  34. package/dist/atoms/index.js +5 -0
  35. package/dist/atoms/internal/hit-area.d.ts +6 -0
  36. package/dist/atoms/internal/hit-area.js +4 -0
  37. package/dist/atoms/kbd/index.d.ts +1 -0
  38. package/dist/atoms/kbd/index.js +4 -0
  39. package/dist/atoms/kbd/kbd.d.ts +7 -0
  40. package/dist/atoms/kbd/kbd.js +17 -0
  41. package/dist/atoms/radio-group/radio-group.js +6 -2
  42. package/dist/atoms/seal/index.d.ts +1 -0
  43. package/dist/atoms/seal/index.js +4 -0
  44. package/dist/atoms/seal/seal.d.ts +30 -0
  45. package/dist/atoms/seal/seal.js +71 -0
  46. package/dist/atoms/spinner/index.d.ts +1 -0
  47. package/dist/atoms/spinner/index.js +5 -0
  48. package/dist/atoms/spinner/spinner.d.ts +19 -0
  49. package/dist/atoms/spinner/spinner.js +31 -0
  50. package/dist/atoms/status-dot/index.d.ts +1 -1
  51. package/dist/atoms/status-dot/status-dot.d.ts +4 -2
  52. package/dist/atoms/status-dot/status-dot.js +5 -1
  53. package/dist/atoms/switch/switch.js +3 -1
  54. package/dist/calendar/date-calendar/date-calendar.d.ts +32 -0
  55. package/dist/calendar/date-calendar/date-calendar.js +189 -0
  56. package/dist/calendar/date-calendar/index.d.ts +1 -0
  57. package/dist/calendar/date-calendar/index.js +6 -0
  58. package/dist/calendar/index.d.ts +1 -0
  59. package/dist/calendar/index.js +1 -0
  60. package/dist/calendar/internal/date-utils.d.ts +26 -0
  61. package/dist/calendar/internal/date-utils.js +95 -1
  62. package/dist/charts/bar-chart/bar-race-chart.js +1 -0
  63. package/dist/charts/beeswarm-chart/beeswarm-chart.js +1 -1
  64. package/dist/charts/chord-chart/chord-chart.js +13 -5
  65. package/dist/charts/core/cartesian/cartesian-chart.d.ts +1 -1
  66. package/dist/charts/core/cartesian/cartesian-chart.js +48 -11
  67. package/dist/charts/core/cartesian/layout.d.ts +6 -1
  68. package/dist/charts/core/cartesian/layout.js +14 -5
  69. package/dist/charts/core/cartesian/marks.d.ts +2 -2
  70. package/dist/charts/core/cartesian/marks.js +1 -1
  71. package/dist/charts/core/cartesian/types.d.ts +28 -2
  72. package/dist/charts/core/category-explorer.d.ts +2 -2
  73. package/dist/charts/core/category-explorer.js +8 -4
  74. package/dist/charts/core/chart-dock.d.ts +26 -0
  75. package/dist/charts/core/chart-dock.js +45 -0
  76. package/dist/charts/core/chart-frame.d.ts +9 -2
  77. package/dist/charts/core/chart-frame.js +105 -25
  78. package/dist/charts/core/distribution/explorer.d.ts +5 -2
  79. package/dist/charts/core/distribution/explorer.js +12 -5
  80. package/dist/charts/core/distribution/xy-points.js +1 -1
  81. package/dist/charts/core/index.d.ts +3 -0
  82. package/dist/charts/core/index.js +3 -0
  83. package/dist/charts/core/leave-grace.d.ts +11 -0
  84. package/dist/charts/core/leave-grace.js +26 -0
  85. package/dist/charts/core/nearest.d.ts +14 -0
  86. package/dist/charts/core/nearest.js +22 -0
  87. package/dist/charts/core/plot-overlay.js +9 -3
  88. package/dist/charts/core/pointer.test-utils.d.ts +38 -0
  89. package/dist/charts/core/pointer.test-utils.js +123 -0
  90. package/dist/charts/core/tooltip.d.ts +25 -2
  91. package/dist/charts/core/tooltip.js +115 -40
  92. package/dist/charts/core/touch-select.d.ts +20 -0
  93. package/dist/charts/core/touch-select.js +184 -0
  94. package/dist/charts/core/types.d.ts +8 -4
  95. package/dist/charts/core/types.js +5 -0
  96. package/dist/charts/core/use-index-navigation.d.ts +17 -6
  97. package/dist/charts/core/use-index-navigation.js +47 -10
  98. package/dist/charts/donut-chart/donut-chart.d.ts +5 -1
  99. package/dist/charts/donut-chart/donut-chart.js +40 -1
  100. package/dist/charts/donut-chart/slice-labels.d.ts +20 -0
  101. package/dist/charts/donut-chart/slice-labels.js +20 -0
  102. package/dist/charts/dumbbell-chart/dumbbell-chart.js +6 -3
  103. package/dist/charts/fill-gauge-chart/fill-gauge-chart.js +1 -0
  104. package/dist/charts/funnel-chart/funnel-chart.js +2 -1
  105. package/dist/charts/gauge-chart/gauge-chart.js +2 -1
  106. package/dist/charts/heatmap-chart/heatmap-chart.d.ts +4 -1
  107. package/dist/charts/heatmap-chart/heatmap-chart.js +3 -1
  108. package/dist/charts/heatmap-chart/heatmap-grid.d.ts +4 -1
  109. package/dist/charts/heatmap-chart/heatmap-grid.js +3 -1
  110. package/dist/charts/hex-tile-map/hex-tile-map.js +124 -115
  111. package/dist/charts/hierarchy-morph/hierarchy-morph.js +2 -1
  112. package/dist/charts/icicle-chart/icicle-chart.js +7 -9
  113. package/dist/charts/lollipop-chart/lollipop-chart.js +6 -3
  114. package/dist/charts/maps/geo/map-viewport.js +1 -1
  115. package/dist/charts/polar-area-chart/polar-area-chart.js +42 -12
  116. package/dist/charts/progress-units/progress-units.js +1 -0
  117. package/dist/charts/radar-chart/radar-chart.js +1 -1
  118. package/dist/charts/radial-bar-chart/radial-bar-chart.js +2 -1
  119. package/dist/charts/range-area-chart/range-area-chart.js +3 -2
  120. package/dist/charts/sankey-chart/sankey-chart.js +12 -4
  121. package/dist/charts/tree-chart/tree-chart.js +1 -0
  122. package/dist/charts/treemap-chart/treemap-chart.js +2 -7
  123. package/dist/charts/waterfall-chart/waterfall-chart.js +6 -3
  124. package/dist/containers/action-bar/action-bar.d.ts +11 -2
  125. package/dist/containers/action-bar/action-bar.js +4 -1
  126. package/dist/containers/aside/aside.d.ts +14 -0
  127. package/dist/containers/aside/aside.js +25 -0
  128. package/dist/containers/aside/index.d.ts +1 -0
  129. package/dist/containers/aside/index.js +5 -0
  130. package/dist/containers/banner/banner.d.ts +4 -1
  131. package/dist/containers/banner/banner.js +9 -1
  132. package/dist/containers/card/card.d.ts +21 -3
  133. package/dist/containers/card/card.js +20 -5
  134. package/dist/containers/description-list/description-list.d.ts +29 -6
  135. package/dist/containers/description-list/description-list.js +47 -6
  136. package/dist/containers/feed/feed.d.ts +23 -0
  137. package/dist/containers/feed/feed.js +77 -0
  138. package/dist/containers/feed/index.d.ts +2 -0
  139. package/dist/containers/feed/index.js +10 -0
  140. package/dist/containers/feed/model.d.ts +19 -0
  141. package/dist/containers/feed/model.js +38 -0
  142. package/dist/containers/grid/grid.d.ts +15 -0
  143. package/dist/containers/grid/grid.js +24 -0
  144. package/dist/containers/grid/index.d.ts +1 -0
  145. package/dist/containers/grid/index.js +4 -0
  146. package/dist/containers/index.d.ts +9 -0
  147. package/dist/containers/index.js +9 -0
  148. package/dist/containers/kpi/kpi.d.ts +60 -7
  149. package/dist/containers/kpi/kpi.js +142 -28
  150. package/dist/containers/kpi-group/index.d.ts +1 -1
  151. package/dist/containers/kpi-group/index.js +3 -1
  152. package/dist/containers/kpi-group/kpi-group.d.ts +9 -1
  153. package/dist/containers/kpi-group/kpi-group.js +11 -1
  154. package/dist/containers/list-detail/index.d.ts +1 -0
  155. package/dist/containers/list-detail/index.js +20 -0
  156. package/dist/containers/list-detail/list-detail.d.ts +55 -0
  157. package/dist/containers/list-detail/list-detail.js +221 -0
  158. package/dist/containers/note/index.d.ts +1 -0
  159. package/dist/containers/note/index.js +4 -0
  160. package/dist/containers/note/note.d.ts +13 -0
  161. package/dist/containers/note/note.js +27 -0
  162. package/dist/containers/page/index.d.ts +1 -0
  163. package/dist/containers/page/index.js +4 -0
  164. package/dist/containers/page/page.d.ts +7 -0
  165. package/dist/containers/page/page.js +14 -0
  166. package/dist/containers/page-header/page-header.d.ts +8 -3
  167. package/dist/containers/page-header/page-header.js +35 -8
  168. package/dist/containers/responsive-list/responsive-list.d.ts +1 -1
  169. package/dist/containers/responsive-list/responsive-list.js +6 -3
  170. package/dist/containers/section/index.d.ts +1 -0
  171. package/dist/containers/section/index.js +6 -0
  172. package/dist/containers/section/section.d.ts +68 -0
  173. package/dist/containers/section/section.js +198 -0
  174. package/dist/containers/shortcuts/index.d.ts +1 -0
  175. package/dist/containers/shortcuts/index.js +8 -0
  176. package/dist/containers/shortcuts/shortcuts.d.ts +18 -0
  177. package/dist/containers/shortcuts/shortcuts.js +50 -0
  178. package/dist/containers/stack/index.d.ts +1 -0
  179. package/dist/containers/stack/index.js +6 -0
  180. package/dist/containers/stack/stack.d.ts +15 -0
  181. package/dist/containers/stack/stack.js +43 -0
  182. package/dist/containers/table/selection.d.ts +9 -0
  183. package/dist/containers/table/selection.js +20 -0
  184. package/dist/containers/table/table.d.ts +66 -4
  185. package/dist/containers/table/table.js +128 -7
  186. package/dist/containers/timeline/index.d.ts +1 -1
  187. package/dist/containers/timeline/index.js +4 -2
  188. package/dist/containers/timeline/timeline.d.ts +32 -5
  189. package/dist/containers/timeline/timeline.js +154 -90
  190. package/dist/forms/chip-group/chip-group.d.ts +54 -0
  191. package/dist/forms/chip-group/chip-group.js +114 -0
  192. package/dist/forms/chip-group/index.d.ts +1 -0
  193. package/dist/forms/chip-group/index.js +6 -0
  194. package/dist/forms/combobox/combobox.d.ts +60 -0
  195. package/dist/forms/combobox/combobox.js +281 -0
  196. package/dist/forms/combobox/index.d.ts +1 -0
  197. package/dist/forms/combobox/index.js +6 -0
  198. package/dist/forms/copy-field/copy-field.d.ts +17 -0
  199. package/dist/forms/copy-field/copy-field.js +72 -0
  200. package/dist/forms/copy-field/index.d.ts +1 -0
  201. package/dist/forms/copy-field/index.js +4 -0
  202. package/dist/forms/date-picker/date-picker.d.ts +40 -0
  203. package/dist/forms/date-picker/date-picker.js +183 -0
  204. package/dist/forms/date-picker/date-time-picker.d.ts +43 -0
  205. package/dist/forms/date-picker/date-time-picker.js +121 -0
  206. package/dist/forms/date-picker/index.d.ts +2 -0
  207. package/dist/forms/date-picker/index.js +10 -0
  208. package/dist/forms/date-picker/model.d.ts +35 -0
  209. package/dist/forms/date-picker/model.js +83 -0
  210. package/dist/forms/dropzone/dropzone.d.ts +30 -2
  211. package/dist/forms/dropzone/dropzone.js +153 -23
  212. package/dist/forms/emoji-picker/emoji-picker.js +1 -1
  213. package/dist/forms/field/field.d.ts +16 -10
  214. package/dist/forms/field/field.js +41 -5
  215. package/dist/forms/form/form.d.ts +15 -0
  216. package/dist/forms/form/form.js +29 -0
  217. package/dist/forms/form/index.d.ts +1 -0
  218. package/dist/forms/form/index.js +10 -0
  219. package/dist/forms/index.d.ts +6 -0
  220. package/dist/forms/index.js +6 -0
  221. package/dist/forms/input/index.d.ts +1 -1
  222. package/dist/forms/input/index.js +6 -2
  223. package/dist/forms/input/input.d.ts +23 -3
  224. package/dist/forms/input/input.js +78 -7
  225. package/dist/forms/input-icon/input-icon.d.ts +1 -1
  226. package/dist/forms/internal/listbox-items.d.ts +18 -0
  227. package/dist/forms/internal/listbox-items.js +88 -0
  228. package/dist/forms/internal/listbox.d.ts +44 -0
  229. package/dist/forms/internal/listbox.js +74 -0
  230. package/dist/forms/number-stepper/model.d.ts +16 -0
  231. package/dist/forms/number-stepper/model.js +23 -0
  232. package/dist/forms/number-stepper/number-stepper.d.ts +36 -6
  233. package/dist/forms/number-stepper/number-stepper.js +86 -37
  234. package/dist/forms/select-menu/index.d.ts +1 -0
  235. package/dist/forms/select-menu/index.js +6 -0
  236. package/dist/forms/select-menu/select-menu.d.ts +35 -0
  237. package/dist/forms/select-menu/select-menu.js +230 -0
  238. package/dist/glass/crystal-map.d.ts +70 -0
  239. package/dist/glass/crystal-map.js +88 -0
  240. package/dist/glass/displacement-map.d.ts +117 -0
  241. package/dist/glass/displacement-map.js +201 -0
  242. package/dist/glass/index.d.ts +8 -0
  243. package/dist/glass/index.js +63 -0
  244. package/dist/glass/lens-crystal.d.ts +29 -0
  245. package/dist/glass/lens-crystal.js +161 -0
  246. package/dist/glass/lens-dispersion.d.ts +11 -0
  247. package/dist/glass/lens-dispersion.js +19 -0
  248. package/dist/glass/liquid-glass.d.ts +41 -0
  249. package/dist/glass/liquid-glass.js +256 -0
  250. package/dist/glass/liquid-motion.d.ts +53 -0
  251. package/dist/glass/liquid-motion.js +302 -0
  252. package/dist/glass/liquid-options.d.ts +162 -0
  253. package/dist/glass/liquid-options.js +179 -0
  254. package/dist/glass/refraction.d.ts +100 -0
  255. package/dist/glass/refraction.js +714 -0
  256. package/dist/glass/specular-map.d.ts +26 -0
  257. package/dist/glass/specular-map.js +75 -0
  258. package/dist/glass/spring.d.ts +79 -0
  259. package/dist/glass/spring.js +58 -0
  260. package/dist/glass/support.d.ts +13 -0
  261. package/dist/glass/support.js +14 -0
  262. package/dist/glass/use-glass-refraction.d.ts +8 -0
  263. package/dist/glass/use-glass-refraction.js +16 -0
  264. package/dist/i18n/strings.d.ts +113 -0
  265. package/dist/i18n/strings.js +70 -2
  266. package/dist/i18n/ui-strings-provider.d.ts +1 -1
  267. package/dist/i18n/ui-strings-provider.js +6 -2
  268. package/dist/icons/index.d.ts +2 -0
  269. package/dist/icons/index.js +4 -0
  270. package/dist/icons/key.d.ts +2 -0
  271. package/dist/icons/key.js +12 -0
  272. package/dist/icons/webhook.d.ts +2 -0
  273. package/dist/icons/webhook.js +12 -0
  274. package/dist/liquid/index.d.ts +3 -0
  275. package/dist/liquid/index.js +29 -0
  276. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +29 -0
  277. package/dist/navigation/breadcrumbs/breadcrumbs.js +70 -0
  278. package/dist/navigation/breadcrumbs/index.d.ts +1 -0
  279. package/dist/navigation/breadcrumbs/index.js +6 -0
  280. package/dist/navigation/index.d.ts +2 -0
  281. package/dist/navigation/index.js +2 -0
  282. package/dist/navigation/segmented/index.d.ts +1 -1
  283. package/dist/navigation/segmented/model.d.ts +5 -0
  284. package/dist/navigation/segmented/model.js +6 -0
  285. package/dist/navigation/segmented/segmented.d.ts +17 -3
  286. package/dist/navigation/segmented/segmented.js +20 -4
  287. package/dist/navigation/stepper/index.d.ts +1 -1
  288. package/dist/navigation/stepper/index.js +3 -1
  289. package/dist/navigation/stepper/stepper.d.ts +8 -0
  290. package/dist/navigation/stepper/stepper.js +68 -45
  291. package/dist/navigation/tabs/index.d.ts +1 -0
  292. package/dist/navigation/tabs/index.js +6 -0
  293. package/dist/navigation/tabs/tabs-nav.d.ts +37 -0
  294. package/dist/navigation/tabs/tabs-nav.js +57 -0
  295. package/dist/navigation/wizard/index.d.ts +1 -0
  296. package/dist/navigation/wizard/index.js +6 -0
  297. package/dist/navigation/wizard/model.d.ts +33 -0
  298. package/dist/navigation/wizard/model.js +34 -0
  299. package/dist/navigation/wizard/wizard.d.ts +45 -0
  300. package/dist/navigation/wizard/wizard.js +169 -0
  301. package/dist/overlays/alert-dialog/alert-dialog.d.ts +103 -0
  302. package/dist/overlays/alert-dialog/alert-dialog.js +342 -0
  303. package/dist/overlays/alert-dialog/index.d.ts +1 -0
  304. package/dist/overlays/alert-dialog/index.js +26 -0
  305. package/dist/overlays/context-menu/context-menu.d.ts +9 -1
  306. package/dist/overlays/context-menu/context-menu.js +4 -1
  307. package/dist/overlays/dialog/dialog.d.ts +9 -1
  308. package/dist/overlays/dialog/dialog.js +3 -0
  309. package/dist/overlays/drawer/drawer.d.ts +9 -1
  310. package/dist/overlays/drawer/drawer.js +3 -0
  311. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +25 -1
  312. package/dist/overlays/dropdown-menu/dropdown-menu.js +14 -4
  313. package/dist/overlays/dropdown-menu/index.d.ts +1 -1
  314. package/dist/overlays/dropdown-menu/index.js +8 -2
  315. package/dist/overlays/hover-card/hover-card.d.ts +10 -1
  316. package/dist/overlays/hover-card/hover-card.js +4 -1
  317. package/dist/overlays/index.d.ts +2 -0
  318. package/dist/overlays/index.js +2 -0
  319. package/dist/overlays/popover/popover.d.ts +9 -1
  320. package/dist/overlays/popover/popover.js +3 -0
  321. package/dist/overlays/testing/index.d.ts +5 -0
  322. package/dist/overlays/testing/index.js +4 -0
  323. package/dist/overlays/toaster/index.d.ts +2 -1
  324. package/dist/overlays/toaster/index.js +4 -2
  325. package/dist/overlays/toaster/toast-store.d.ts +6 -2
  326. package/dist/overlays/toaster/toast.d.ts +3 -0
  327. package/dist/overlays/toaster/toast.js +3 -0
  328. package/dist/overlays/toaster/toaster.d.ts +3 -0
  329. package/dist/overlays/toaster/toaster.js +36 -3
  330. package/dist/overlays/tooltip/index.d.ts +1 -0
  331. package/dist/overlays/tooltip/index.js +4 -0
  332. package/dist/overlays/tooltip/model.d.ts +10 -0
  333. package/dist/overlays/tooltip/model.js +13 -0
  334. package/dist/overlays/tooltip/tooltip.d.ts +41 -0
  335. package/dist/overlays/tooltip/tooltip.js +116 -0
  336. package/dist/palette/command-palette/command-palette.d.ts +12 -2
  337. package/dist/palette/command-palette/command-palette.js +5 -0
  338. package/dist/primitives/command/command.d.ts +3 -2
  339. package/dist/primitives/command/command.js +2 -0
  340. package/dist/primitives/menu/menu.js +1 -1
  341. package/dist/primitives/popper/popper.js +5 -0
  342. package/dist/primitives/use-dismissable-layer.js +1 -1
  343. package/dist/rich-text/rich-text-editor.js +94 -8
  344. package/dist/rich-text/sanitize.js +70 -20
  345. package/dist/shell/app-shell/app-shell.d.ts +17 -0
  346. package/dist/shell/app-shell/app-shell.js +44 -4
  347. package/dist/shell/bottom-nav/bottom-nav.d.ts +34 -0
  348. package/dist/shell/bottom-nav/bottom-nav.js +124 -0
  349. package/dist/shell/bottom-nav/index.d.ts +2 -0
  350. package/dist/shell/bottom-nav/index.js +9 -0
  351. package/dist/shell/bottom-nav/split.d.ts +11 -0
  352. package/dist/shell/bottom-nav/split.js +10 -0
  353. package/dist/shell/sidebar/sidebar.d.ts +16 -2
  354. package/dist/shell/sidebar/sidebar.js +46 -4
  355. package/dist/shell/topbar/topbar.d.ts +20 -9
  356. package/dist/shell/topbar/topbar.js +16 -9
  357. package/dist/states/empty-state/empty-state.d.ts +3 -1
  358. package/dist/states/empty-state/empty-state.js +9 -1
  359. package/dist/states/error-state/error-state.d.ts +8 -1
  360. package/dist/states/error-state/error-state.js +15 -9
  361. package/dist/states/index.d.ts +1 -0
  362. package/dist/states/index.js +1 -0
  363. package/dist/states/live-status-bar/index.d.ts +1 -0
  364. package/dist/states/live-status-bar/index.js +6 -0
  365. package/dist/states/live-status-bar/live-status-bar.d.ts +17 -0
  366. package/dist/states/live-status-bar/live-status-bar.js +49 -0
  367. package/dist/states/offline-banner/offline-banner.d.ts +3 -1
  368. package/dist/states/offline-banner/offline-banner.js +8 -4
  369. package/dist/states/skeleton/skeleton.d.ts +8 -2
  370. package/dist/states/skeleton/skeleton.js +44 -2
  371. package/dist/utils/class-groups.js +17 -0
  372. package/dist/utils/index.d.ts +1 -0
  373. package/dist/utils/index.js +2 -0
  374. package/dist/utils/material.d.ts +13 -0
  375. package/dist/utils/material.js +6 -0
  376. package/dist/utils/tone.d.ts +8 -0
  377. package/dist/utils/tone.js +17 -0
  378. package/dist/utils/use-copy.d.ts +5 -0
  379. package/dist/utils/use-copy.js +35 -0
  380. package/icons/svg/key.svg +5 -0
  381. package/icons/svg/webhook.svg +5 -0
  382. package/package.json +31 -21
  383. package/scripts/build-theme.d.mts +22 -0
  384. package/scripts/build-theme.mjs +248 -5
  385. package/src/ai/attachment/attachment.tsx +1 -1
  386. package/src/ai/chat-list/group.ts +3 -1
  387. package/src/ai/conversation/conversation.tsx +1 -1
  388. package/src/ai/internal/use-copy.ts +1 -38
  389. package/src/ai/markdown/parse.ts +74 -17
  390. package/src/ai/source/source.tsx +1 -1
  391. package/src/atoms/avatar/avatar.tsx +57 -4
  392. package/src/atoms/avatar/index.ts +8 -1
  393. package/src/atoms/button/button.tsx +8 -3
  394. package/src/atoms/checkbox/checkbox.tsx +33 -4
  395. package/src/atoms/chip/chip.tsx +55 -8
  396. package/src/atoms/chip/index.ts +9 -1
  397. package/src/atoms/due-chip/due-chip.tsx +75 -0
  398. package/src/atoms/due-chip/index.ts +2 -0
  399. package/src/atoms/due-chip/model.ts +67 -0
  400. package/src/atoms/icon-button/icon-button.tsx +58 -0
  401. package/src/atoms/icon-button/index.ts +6 -0
  402. package/src/atoms/index.ts +5 -0
  403. package/src/atoms/internal/hit-area.ts +7 -0
  404. package/src/atoms/kbd/index.ts +1 -0
  405. package/src/atoms/kbd/kbd.tsx +20 -0
  406. package/src/atoms/radio-group/radio-group.tsx +8 -2
  407. package/src/atoms/seal/index.ts +1 -0
  408. package/src/atoms/seal/seal.tsx +107 -0
  409. package/src/atoms/spinner/index.ts +1 -0
  410. package/src/atoms/spinner/spinner.tsx +49 -0
  411. package/src/atoms/status-dot/index.ts +1 -0
  412. package/src/atoms/status-dot/status-dot.tsx +15 -3
  413. package/src/atoms/switch/switch.tsx +3 -1
  414. package/src/calendar/date-calendar/date-calendar.tsx +230 -0
  415. package/src/calendar/date-calendar/index.ts +5 -0
  416. package/src/calendar/index.ts +1 -0
  417. package/src/calendar/internal/date-utils.ts +115 -0
  418. package/src/charts/README.md +21 -0
  419. package/src/charts/bar-chart/bar-race-chart.tsx +1 -0
  420. package/src/charts/beeswarm-chart/beeswarm-chart.tsx +1 -1
  421. package/src/charts/chord-chart/chord-chart.tsx +13 -5
  422. package/src/charts/core/cartesian/cartesian-chart.tsx +55 -10
  423. package/src/charts/core/cartesian/layout.ts +29 -10
  424. package/src/charts/core/cartesian/marks.tsx +3 -3
  425. package/src/charts/core/cartesian/types.ts +30 -2
  426. package/src/charts/core/category-explorer.tsx +12 -6
  427. package/src/charts/core/chart-dock.tsx +68 -0
  428. package/src/charts/core/chart-frame.tsx +116 -27
  429. package/src/charts/core/distribution/explorer.tsx +17 -7
  430. package/src/charts/core/distribution/xy-points.tsx +1 -1
  431. package/src/charts/core/index.ts +3 -0
  432. package/src/charts/core/leave-grace.ts +35 -0
  433. package/src/charts/core/nearest.ts +38 -0
  434. package/src/charts/core/plot-overlay.tsx +9 -3
  435. package/src/charts/core/pointer.test-utils.ts +146 -0
  436. package/src/charts/core/tooltip.tsx +129 -15
  437. package/src/charts/core/touch-select.ts +250 -0
  438. package/src/charts/core/types.ts +13 -4
  439. package/src/charts/core/use-index-navigation.ts +70 -11
  440. package/src/charts/donut-chart/donut-chart.tsx +53 -3
  441. package/src/charts/donut-chart/slice-labels.ts +39 -0
  442. package/src/charts/dumbbell-chart/dumbbell-chart.tsx +8 -3
  443. package/src/charts/fill-gauge-chart/fill-gauge-chart.tsx +1 -0
  444. package/src/charts/funnel-chart/funnel-chart.tsx +2 -1
  445. package/src/charts/gauge-chart/gauge-chart.tsx +2 -1
  446. package/src/charts/heatmap-chart/heatmap-chart.tsx +5 -0
  447. package/src/charts/heatmap-chart/heatmap-grid.tsx +5 -1
  448. package/src/charts/hex-tile-map/hex-tile-map.tsx +6 -1
  449. package/src/charts/hierarchy-morph/hierarchy-morph.tsx +2 -1
  450. package/src/charts/icicle-chart/icicle-chart.tsx +8 -9
  451. package/src/charts/lollipop-chart/lollipop-chart.tsx +8 -3
  452. package/src/charts/maps/geo/map-viewport.tsx +1 -1
  453. package/src/charts/polar-area-chart/polar-area-chart.tsx +37 -12
  454. package/src/charts/progress-units/progress-units.tsx +1 -0
  455. package/src/charts/radar-chart/radar-chart.tsx +1 -1
  456. package/src/charts/radial-bar-chart/radial-bar-chart.tsx +2 -1
  457. package/src/charts/range-area-chart/range-area-chart.tsx +3 -2
  458. package/src/charts/sankey-chart/sankey-chart.tsx +12 -4
  459. package/src/charts/tree-chart/tree-chart.tsx +1 -0
  460. package/src/charts/treemap-chart/treemap-chart.tsx +2 -7
  461. package/src/charts/waterfall-chart/waterfall-chart.tsx +8 -3
  462. package/src/containers/action-bar/action-bar.tsx +13 -2
  463. package/src/containers/aside/aside.tsx +40 -0
  464. package/src/containers/aside/index.ts +1 -0
  465. package/src/containers/banner/banner.tsx +18 -1
  466. package/src/containers/card/card.tsx +43 -4
  467. package/src/containers/description-list/description-list.tsx +85 -9
  468. package/src/containers/feed/feed.tsx +99 -0
  469. package/src/containers/feed/index.ts +8 -0
  470. package/src/containers/feed/model.ts +54 -0
  471. package/src/containers/grid/grid.tsx +37 -0
  472. package/src/containers/grid/index.ts +1 -0
  473. package/src/containers/index.ts +9 -0
  474. package/src/containers/kpi/kpi.tsx +231 -38
  475. package/src/containers/kpi-group/index.ts +7 -1
  476. package/src/containers/kpi-group/kpi-group.tsx +26 -1
  477. package/src/containers/list-detail/index.ts +15 -0
  478. package/src/containers/list-detail/list-detail.tsx +293 -0
  479. package/src/containers/note/index.ts +1 -0
  480. package/src/containers/note/note.tsx +38 -0
  481. package/src/containers/page/index.ts +1 -0
  482. package/src/containers/page/page.tsx +17 -0
  483. package/src/containers/page-header/page-header.tsx +38 -8
  484. package/src/containers/responsive-list/responsive-list.tsx +7 -4
  485. package/src/containers/section/index.ts +11 -0
  486. package/src/containers/section/section.tsx +281 -0
  487. package/src/containers/shortcuts/index.ts +6 -0
  488. package/src/containers/shortcuts/shortcuts.tsx +92 -0
  489. package/src/containers/stack/index.ts +7 -0
  490. package/src/containers/stack/stack.tsx +55 -0
  491. package/src/containers/table/selection.ts +26 -0
  492. package/src/containers/table/table.tsx +215 -13
  493. package/src/containers/timeline/index.ts +3 -0
  494. package/src/containers/timeline/timeline.tsx +204 -93
  495. package/src/forms/chip-group/chip-group.tsx +184 -0
  496. package/src/forms/chip-group/index.ts +8 -0
  497. package/src/forms/combobox/combobox.tsx +359 -0
  498. package/src/forms/combobox/index.ts +7 -0
  499. package/src/forms/copy-field/copy-field.tsx +88 -0
  500. package/src/forms/copy-field/index.ts +1 -0
  501. package/src/forms/date-picker/date-picker.tsx +239 -0
  502. package/src/forms/date-picker/date-time-picker.tsx +178 -0
  503. package/src/forms/date-picker/index.ts +10 -0
  504. package/src/forms/date-picker/model.ts +108 -0
  505. package/src/forms/dropzone/dropzone.tsx +217 -35
  506. package/src/forms/emoji-picker/emoji-picker.tsx +1 -1
  507. package/src/forms/field/field.tsx +72 -7
  508. package/src/forms/form/form.tsx +46 -0
  509. package/src/forms/form/index.ts +8 -0
  510. package/src/forms/index.ts +6 -0
  511. package/src/forms/input/index.ts +8 -1
  512. package/src/forms/input/input.tsx +103 -7
  513. package/src/forms/input-icon/input-icon.tsx +1 -1
  514. package/src/forms/internal/listbox-items.tsx +103 -0
  515. package/src/forms/internal/listbox.ts +124 -0
  516. package/src/forms/number-stepper/model.ts +35 -0
  517. package/src/forms/number-stepper/number-stepper.tsx +132 -42
  518. package/src/forms/select-menu/index.ts +7 -0
  519. package/src/forms/select-menu/select-menu.tsx +280 -0
  520. package/src/glass/crystal-map.ts +150 -0
  521. package/src/glass/displacement-map.ts +317 -0
  522. package/src/glass/index.ts +43 -0
  523. package/src/glass/lens-crystal.ts +226 -0
  524. package/src/glass/lens-dispersion.ts +34 -0
  525. package/src/glass/liquid-glass.tsx +371 -0
  526. package/src/glass/liquid-motion.ts +395 -0
  527. package/src/glass/liquid-options.ts +306 -0
  528. package/src/glass/refraction.ts +1010 -0
  529. package/src/glass/specular-map.ts +95 -0
  530. package/src/glass/spring.ts +98 -0
  531. package/src/glass/support.ts +27 -0
  532. package/src/glass/use-glass-refraction.ts +21 -0
  533. package/src/i18n/strings.ts +113 -0
  534. package/src/i18n/ui-strings-provider.tsx +15 -4
  535. package/src/icons/index.ts +2 -0
  536. package/src/icons/key.tsx +13 -0
  537. package/src/icons/webhook.tsx +13 -0
  538. package/src/liquid/index.ts +24 -0
  539. package/src/navigation/breadcrumbs/breadcrumbs.tsx +103 -0
  540. package/src/navigation/breadcrumbs/index.ts +8 -0
  541. package/src/navigation/index.ts +2 -0
  542. package/src/navigation/segmented/index.ts +1 -0
  543. package/src/navigation/segmented/model.ts +11 -0
  544. package/src/navigation/segmented/segmented.tsx +45 -6
  545. package/src/navigation/stepper/index.ts +7 -1
  546. package/src/navigation/stepper/stepper.tsx +41 -5
  547. package/src/navigation/tabs/index.ts +7 -0
  548. package/src/navigation/tabs/tabs-nav.tsx +131 -0
  549. package/src/navigation/wizard/index.ts +7 -0
  550. package/src/navigation/wizard/model.ts +61 -0
  551. package/src/navigation/wizard/wizard.tsx +222 -0
  552. package/src/overlays/alert-dialog/alert-dialog.tsx +486 -0
  553. package/src/overlays/alert-dialog/index.ts +19 -0
  554. package/src/overlays/context-menu/context-menu.tsx +11 -1
  555. package/src/overlays/dialog/dialog.tsx +10 -0
  556. package/src/overlays/drawer/drawer.tsx +10 -0
  557. package/src/overlays/dropdown-menu/dropdown-menu.tsx +38 -4
  558. package/src/overlays/dropdown-menu/index.ts +3 -0
  559. package/src/overlays/hover-card/hover-card.tsx +12 -1
  560. package/src/overlays/index.ts +2 -0
  561. package/src/overlays/popover/popover.tsx +10 -0
  562. package/src/overlays/testing/index.ts +5 -0
  563. package/src/overlays/toaster/index.ts +2 -0
  564. package/src/overlays/toaster/toast-store.ts +6 -2
  565. package/src/overlays/toaster/toast.ts +6 -0
  566. package/src/overlays/toaster/toaster.tsx +44 -2
  567. package/src/overlays/tooltip/index.ts +1 -0
  568. package/src/overlays/tooltip/model.ts +18 -0
  569. package/src/overlays/tooltip/tooltip.tsx +166 -0
  570. package/src/palette/command-palette/command-palette.tsx +15 -1
  571. package/src/primitives/command/command.tsx +4 -0
  572. package/src/primitives/menu/menu.tsx +1 -1
  573. package/src/primitives/popper/popper.tsx +10 -0
  574. package/src/primitives/use-dismissable-layer.ts +7 -2
  575. package/src/rich-text/rich-text-editor.tsx +116 -13
  576. package/src/rich-text/sanitize.ts +94 -23
  577. package/src/shell/app-shell/app-shell.tsx +60 -4
  578. package/src/shell/bottom-nav/bottom-nav.tsx +187 -0
  579. package/src/shell/bottom-nav/index.ts +8 -0
  580. package/src/shell/bottom-nav/split.ts +20 -0
  581. package/src/shell/sidebar/sidebar.tsx +51 -5
  582. package/src/shell/topbar/topbar.tsx +81 -58
  583. package/src/states/empty-state/empty-state.tsx +11 -1
  584. package/src/states/error-state/error-state.tsx +23 -8
  585. package/src/states/index.ts +1 -0
  586. package/src/states/live-status-bar/index.ts +6 -0
  587. package/src/states/live-status-bar/live-status-bar.tsx +62 -0
  588. package/src/states/offline-banner/offline-banner.tsx +13 -5
  589. package/src/states/skeleton/skeleton.tsx +68 -2
  590. package/src/utils/class-groups.ts +17 -0
  591. package/src/utils/index.ts +1 -0
  592. package/src/utils/material.ts +16 -0
  593. package/src/utils/tone.ts +29 -0
  594. package/src/utils/use-copy.ts +38 -0
  595. package/styles/Theme.kt +64 -3
  596. package/styles/base.css +51 -0
  597. package/styles/tailwind.css +836 -0
  598. package/styles/theme.css +579 -34
  599. package/styles/tokens.css +788 -15
  600. package/tokens/default.json +918 -29
  601. package/scripts/build-theme.d.ts +0 -18
@@ -2,6 +2,7 @@
2
2
 
3
3
  import {
4
4
  type ClipboardEvent,
5
+ type DragEvent,
5
6
  type KeyboardEvent,
6
7
  type ReactNode,
7
8
  useCallback,
@@ -122,6 +123,39 @@ function selectionIn(root: HTMLElement | null): Range | null {
122
123
  return root.contains(range.commonAncestorContainer) ? range : null;
123
124
  }
124
125
 
126
+ /** Sanitized HTML for transferred data: its `text/html`, else its `text/plain` as paragraphs, else "". */
127
+ function htmlFromTransfer(data: DataTransfer | null, fallbackText = ""): string {
128
+ const html = data?.getData("text/html") ?? "";
129
+ const text = data?.getData("text/plain") || fallbackText;
130
+ if (html) return sanitizeHtml(html);
131
+ if (!text) return "";
132
+ return sanitizeHtml(
133
+ text
134
+ .split(/\r?\n/)
135
+ .map((line) => `<p>${line.replace(/&/g, "&amp;").replace(/</g, "&lt;")}</p>`)
136
+ .join(""),
137
+ );
138
+ }
139
+
140
+ /** Moves the caret to the point under the pointer, when that point is inside `root`. */
141
+ function placeCaretAt(root: HTMLElement, x: number, y: number) {
142
+ const d = document as Document & {
143
+ caretPositionFromPoint?: (x: number, y: number) => { offsetNode: Node; offset: number } | null;
144
+ };
145
+ let range: Range | null = null;
146
+ const position = d.caretPositionFromPoint?.(x, y);
147
+ if (position) {
148
+ range = document.createRange();
149
+ range.setStart(position.offsetNode, position.offset);
150
+ range.collapse(true);
151
+ } else {
152
+ range = document.caretRangeFromPoint?.(x, y) ?? null;
153
+ }
154
+ if (!range || !root.contains(range.startContainer)) return;
155
+ window.getSelection()?.removeAllRanges();
156
+ window.getSelection()?.addRange(range);
157
+ }
158
+
125
159
  /**
126
160
  * Rich text editor on a plain `contenteditable`, with no dependencies. Supports bold, italic,
127
161
  * underline, a title, bullet and numbered lists and links (Ctrl/Cmd+B, I, U, K). Everything that
@@ -146,6 +180,7 @@ export function RichTextEditor({
146
180
  const toolbar = useRef<HTMLDivElement>(null);
147
181
  const linkInput = useRef<HTMLInputElement>(null);
148
182
  const savedRange = useRef<Range | null>(null);
183
+ const dragSource = useRef<Range | null>(null);
149
184
  const lastEmitted = useRef<string>("");
150
185
  const [empty, setEmpty] = useState(() => htmlToText(sanitizeHtml(value ?? defaultValue)) === "");
151
186
  const [active, setActive] = useState<Set<Command>>(new Set());
@@ -235,7 +270,10 @@ export function RichTextEditor({
235
270
  restoreSelection();
236
271
  const selection = window.getSelection();
237
272
  if (selection?.isCollapsed) {
238
- document.execCommand("insertHTML", false, sanitizeHtml(`<a href="${href}">${href}</a>`));
273
+ const anchor = document.createElement("a");
274
+ anchor.setAttribute("href", href);
275
+ anchor.textContent = href;
276
+ document.execCommand("insertHTML", false, sanitizeHtml(anchor.outerHTML));
239
277
  } else {
240
278
  document.execCommand("createLink", false, href);
241
279
  }
@@ -257,22 +295,84 @@ export function RichTextEditor({
257
295
  }
258
296
  };
259
297
 
298
+ const insertClean = useCallback(
299
+ (clean: string): boolean => {
300
+ const node = editor.current;
301
+ if (!clean || !node) return false;
302
+ node.focus();
303
+ if (!selectionIn(node)) {
304
+ const end = document.createRange();
305
+ end.selectNodeContents(node);
306
+ end.collapse(false);
307
+ window.getSelection()?.removeAllRanges();
308
+ window.getSelection()?.addRange(end);
309
+ }
310
+ document.execCommand("insertHTML", false, clean);
311
+ emit();
312
+ return true;
313
+ },
314
+ [emit],
315
+ );
316
+
260
317
  const onPaste = (event: ClipboardEvent<HTMLDivElement>) => {
261
318
  event.preventDefault();
262
- const html = event.clipboardData.getData("text/html");
263
- const text = event.clipboardData.getData("text/plain");
264
- const clean = html
265
- ? sanitizeHtml(html)
266
- : sanitizeHtml(
267
- text
268
- .split(/\r?\n/)
269
- .map((line) => `<p>${line.replace(/&/g, "&amp;").replace(/</g, "&lt;")}</p>`)
270
- .join(""),
271
- );
272
- document.execCommand("insertHTML", false, clean);
273
- emit();
319
+ insertClean(htmlFromTransfer(event.clipboardData));
320
+ };
321
+
322
+ // A drag that starts inside this editor moves its selection; one from elsewhere copies.
323
+ const onDragStart = () => {
324
+ const range = selectionIn(editor.current);
325
+ dragSource.current = range && !range.collapsed ? range.cloneRange() : null;
274
326
  };
275
327
 
328
+ const onDragEnd = () => {
329
+ dragSource.current = null;
330
+ };
331
+
332
+ const onDrop = (event: DragEvent<HTMLDivElement>) => {
333
+ event.preventDefault();
334
+ const source = dragSource.current;
335
+ dragSource.current = null;
336
+ if (editor.current) placeCaretAt(editor.current, event.clientX, event.clientY);
337
+ if (source) {
338
+ const target = selectionIn(editor.current);
339
+ if (target && source.isPointInRange(target.startContainer, target.startOffset)) return;
340
+ }
341
+ if (insertClean(htmlFromTransfer(event.dataTransfer)) && source) {
342
+ source.deleteContents();
343
+ emit();
344
+ }
345
+ };
346
+
347
+ // Whatever the browser would insert by itself from foreign data goes through the sanitizer.
348
+ // React's onBeforeInput is not the native event, so this listens directly.
349
+ useEffect(() => {
350
+ const node = editor.current;
351
+ if (!node) return;
352
+ const onBeforeInput = (event: InputEvent) => {
353
+ if (
354
+ event.inputType !== "insertFromDrop" &&
355
+ event.inputType !== "insertFromPaste" &&
356
+ event.inputType !== "insertReplacementText"
357
+ )
358
+ return;
359
+ event.preventDefault();
360
+ const target = event.getTargetRanges?.()[0];
361
+ if (target && event.inputType === "insertReplacementText") {
362
+ const range = document.createRange();
363
+ range.setStart(target.startContainer, target.startOffset);
364
+ range.setEnd(target.endContainer, target.endOffset);
365
+ if (node.contains(range.commonAncestorContainer)) {
366
+ window.getSelection()?.removeAllRanges();
367
+ window.getSelection()?.addRange(range);
368
+ }
369
+ }
370
+ insertClean(htmlFromTransfer(event.dataTransfer, event.data ?? ""));
371
+ };
372
+ node.addEventListener("beforeinput", onBeforeInput);
373
+ return () => node.removeEventListener("beforeinput", onBeforeInput);
374
+ }, [insertClean]);
375
+
276
376
  const onToolbarKeyDown = (event: KeyboardEvent<HTMLDivElement>) => {
277
377
  const buttons = Array.from(
278
378
  toolbar.current?.querySelectorAll<HTMLButtonElement>("button[data-tool]") ?? [],
@@ -439,6 +539,9 @@ export function RichTextEditor({
439
539
  spellCheck
440
540
  onInput={emit}
441
541
  onPaste={onPaste}
542
+ onDragStart={onDragStart}
543
+ onDragEnd={onDragEnd}
544
+ onDrop={onDrop}
442
545
  onKeyDown={onEditorKeyDown}
443
546
  onBlur={emit}
444
547
  style={{ minHeight: `${minHeightRem}rem` }}
@@ -63,19 +63,56 @@ const DROP_WITH_CONTENT = new Set([
63
63
 
64
64
  const VOID_TAGS = new Set(["br"]);
65
65
 
66
+ // Case-sensitive, as in HTML5 (`&Colon;` is a different character from `&colon;`).
66
67
  const NAMED_ENTITIES: Record<string, string> = {
67
68
  amp: "&",
69
+ AMP: "&",
68
70
  lt: "<",
71
+ LT: "<",
69
72
  gt: ">",
73
+ GT: ">",
70
74
  quot: '"',
75
+ QUOT: '"',
71
76
  apos: "'",
72
- nbsp: " ",
77
+ nbsp: "\u00a0",
73
78
  colon: ":",
74
- tab: "\t",
75
- newline: "\n",
79
+ Tab: "\t",
80
+ NewLine: "\n",
76
81
  sol: "/",
77
82
  };
78
83
 
84
+ let decoder: HTMLTextAreaElement | undefined;
85
+ const decodedNames = new Map<string, string>();
86
+
87
+ /**
88
+ * Full HTML5 named-entity decoding. With a DOM, the engine's own parser does it through a detached
89
+ * textarea (it runs no script and loads nothing, and the input is only `&name;` characters).
90
+ *
91
+ * Without a DOM (server rendering) only the table above applies, so other entities such as
92
+ * `&eacute;` stay as escaped text there and the same HTML can render differently on the server and
93
+ * in the browser. That is deliberate: a full table is too heavy to ship. Under Trusted Types the
94
+ * `innerHTML` assignment throws; the entity is then left undecoded, which stays escaped on emit.
95
+ */
96
+ function decodeNamed(match: string, body: string): string {
97
+ const known = NAMED_ENTITIES[body];
98
+ if (known !== undefined) return known;
99
+ if (decoder === undefined && typeof document !== "undefined")
100
+ decoder = document.createElement("textarea");
101
+ if (!decoder) return match;
102
+ let out = decodedNames.get(match);
103
+ if (out === undefined) {
104
+ try {
105
+ decoder.innerHTML = match;
106
+ out = decoder.value;
107
+ } catch {
108
+ return match;
109
+ }
110
+ if (decodedNames.size > 512) decodedNames.clear();
111
+ decodedNames.set(match, out);
112
+ }
113
+ return out;
114
+ }
115
+
79
116
  function decodeEntities(text: string): string {
80
117
  return text.replace(/&(#x[0-9a-f]+|#\d+|[a-z][a-z0-9]*);?/gi, (match, body: string) => {
81
118
  if (body[0] === "#") {
@@ -84,7 +121,7 @@ function decodeEntities(text: string): string {
84
121
  if (!Number.isFinite(code) || code <= 0 || code > 0x10ffff) return "";
85
122
  return String.fromCodePoint(code);
86
123
  }
87
- return NAMED_ENTITIES[body.toLowerCase()] ?? match;
124
+ return decodeNamed(match, body);
88
125
  });
89
126
  }
90
127
 
@@ -107,16 +144,32 @@ function isInvisible(code: number): boolean {
107
144
  );
108
145
  }
109
146
 
110
- /** True for http(s), mailto, tel and scheme-less (relative or fragment) URLs. */
111
- export function isSafeUrl(raw: string): boolean {
112
- // Browsers ignore control characters and whitespace inside the scheme ("java\tscript:").
113
- const url = Array.from(decodeEntities(raw))
147
+ const ALLOWED_PROTOCOLS = new Set(["http:", "https:", "mailto:", "tel:"]);
148
+ const IGNORED_IN_URL = /[\s\p{Cf}]/gu;
149
+
150
+ /** The one string that is validated and emitted: entities decoded once, ends trimmed. */
151
+ function normalizeHref(raw: string): string {
152
+ return decodeEntities(raw).trim();
153
+ }
154
+
155
+ function isAllowedHref(href: string): boolean {
156
+ // Browsers ignore control characters and whitespace around and inside the scheme ("java\tscript:").
157
+ // Strip every whitespace and format character too, so no prefix can hide a scheme from this check.
158
+ const url = Array.from(href)
114
159
  .filter((char) => !isInvisible(char.codePointAt(0) ?? 0))
115
- .join("");
160
+ .join("")
161
+ .replace(IGNORED_IN_URL, "");
116
162
  if (url === "") return false;
117
- const scheme = /^([a-z][a-z0-9+.-]*):/i.exec(url);
118
- if (!scheme) return true;
119
- return ["http", "https", "mailto", "tel"].includes((scheme[1] ?? "").toLowerCase());
163
+ try {
164
+ return ALLOWED_PROTOCOLS.has(new URL(url, "https://invalid.invalid/").protocol);
165
+ } catch {
166
+ return false;
167
+ }
168
+ }
169
+
170
+ /** True for http(s), mailto, tel and scheme-less (relative or fragment) URLs. */
171
+ export function isSafeUrl(raw: string): boolean {
172
+ return isAllowedHref(normalizeHref(raw));
120
173
  }
121
174
 
122
175
  interface ParsedTag {
@@ -172,6 +225,9 @@ function parseTag(html: string, start: number): ParsedTag | null {
172
225
  };
173
226
  }
174
227
 
228
+ /** Deepest run of open elements kept; tags beyond it are unwrapped (their text stays). */
229
+ const MAX_OPEN_DEPTH = 128;
230
+
175
231
  /** Returns safe, balanced HTML containing only the editor's vocabulary. */
176
232
  export function sanitizeHtml(input: string): string {
177
233
  const html = String(input ?? "");
@@ -179,10 +235,21 @@ export function sanitizeHtml(input: string): string {
179
235
  const stack: string[] = [];
180
236
  let i = 0;
181
237
 
238
+ // Open count per tag: an unmatched closer then costs O(1) instead of a scan of the whole stack.
239
+ const open: Record<string, number> = Object.create(null);
240
+ const pop = () => {
241
+ const name = stack.pop() as string;
242
+ open[name] = (open[name] as number) - 1;
243
+ out.push(`</${name}>`);
244
+ };
245
+ const push = (name: string) => {
246
+ stack.push(name);
247
+ open[name] = (open[name] ?? 0) + 1;
248
+ };
182
249
  const closeTo = (name: string) => {
250
+ if (!open[name]) return;
183
251
  const at = stack.lastIndexOf(name);
184
- if (at === -1) return;
185
- while (stack.length > at) out.push(`</${stack.pop()}>`);
252
+ while (stack.length > at) pop();
186
253
  };
187
254
 
188
255
  while (i < html.length) {
@@ -213,11 +280,13 @@ export function sanitizeHtml(input: string): string {
213
280
  i = tag.end;
214
281
 
215
282
  if (!tag.closing && DROP_WITH_CONTENT.has(tag.name)) {
216
- const closer = new RegExp(`</${tag.name}[\\s/>]`, "i").exec(html.slice(i));
217
- if (!closer) {
283
+ const closer = new RegExp(`</${tag.name}[\\s/>]`, "gi");
284
+ closer.lastIndex = i;
285
+ const found = closer.exec(html);
286
+ if (!found) {
218
287
  i = html.length;
219
288
  } else {
220
- const close = html.indexOf(">", i + closer.index);
289
+ const close = html.indexOf(">", found.index);
221
290
  i = close === -1 ? html.length : close + 1;
222
291
  }
223
292
  continue;
@@ -236,15 +305,16 @@ export function sanitizeHtml(input: string): string {
236
305
  }
237
306
  if (name === "a") {
238
307
  closeTo("a");
239
- const href = tag.attributes.href;
240
- if (href !== undefined && isSafeUrl(href)) {
308
+ if (stack.length >= MAX_OPEN_DEPTH) continue;
309
+ const href = tag.attributes.href === undefined ? "" : normalizeHref(tag.attributes.href);
310
+ if (isAllowedHref(href)) {
241
311
  out.push(
242
- `<a href="${escapeAttribute(decodeEntities(href).trim())}" rel="noopener noreferrer nofollow" target="_blank">`,
312
+ `<a href="${escapeAttribute(href)}" rel="noopener noreferrer nofollow" target="_blank">`,
243
313
  );
244
314
  } else {
245
315
  out.push("<a>");
246
316
  }
247
- stack.push("a");
317
+ push("a");
248
318
  continue;
249
319
  }
250
320
  // Block elements cannot nest inside inline ones or inside paragraphs; close what they would break.
@@ -252,11 +322,12 @@ export function sanitizeHtml(input: string): string {
252
322
  for (const open of ["p", "h2", "h3"]) closeTo(open);
253
323
  }
254
324
  if (name === "li") closeTo("li");
325
+ if (stack.length >= MAX_OPEN_DEPTH) continue;
255
326
  out.push(`<${name}>`);
256
- stack.push(name);
327
+ push(name);
257
328
  }
258
329
 
259
- while (stack.length) out.push(`</${stack.pop()}>`);
330
+ while (stack.length) pop();
260
331
  return out.join("").replace(/<a><\/a>/g, "");
261
332
  }
262
333
 
@@ -8,8 +8,10 @@ import {
8
8
  useContext,
9
9
  useEffect,
10
10
  useLayoutEffect,
11
+ useMemo,
11
12
  useRef,
12
13
  useState,
14
+ useSyncExternalStore,
13
15
  } from "react";
14
16
  import { cn } from "../../utils/cn.js";
15
17
  import { useComposedRefs } from "../../utils/compose.js";
@@ -48,11 +50,57 @@ interface AppShellState {
48
50
  compact: boolean;
49
51
  }
50
52
 
51
- const AppShellContext = createContext<AppShellState | null>(null);
53
+ /** Measured compact flag of one `AppShell`, readable through `useSyncExternalStore`. */
54
+ export interface AppShellStore {
55
+ subscribe: (listener: () => void) => () => void;
56
+ getSnapshot: () => boolean;
57
+ /** Same value the first client render reads, so hydration never sees a different snapshot. */
58
+ getServerSnapshot: () => boolean;
59
+ /** Starts measuring `element`; returns the stop function. */
60
+ observe: (element: HTMLElement) => () => void;
61
+ }
62
+
63
+ export function createAppShellStore(): AppShellStore {
64
+ let compact = false;
65
+ const listeners = new Set<() => void>();
66
+ const set = (next: boolean) => {
67
+ if (next === compact) return;
68
+ compact = next;
69
+ for (const listener of listeners) listener();
70
+ };
71
+ return {
72
+ subscribe(listener) {
73
+ listeners.add(listener);
74
+ return () => void listeners.delete(listener);
75
+ },
76
+ getSnapshot: () => compact,
77
+ getServerSnapshot: () => false,
78
+ observe(element) {
79
+ const measure = () => set(element.getBoundingClientRect().width < APP_SHELL_BREAKPOINT);
80
+ measure();
81
+ if (typeof ResizeObserver === "undefined") return () => {};
82
+ const observer = new ResizeObserver(measure);
83
+ observer.observe(element);
84
+ return () => observer.disconnect();
85
+ },
86
+ };
87
+ }
88
+
89
+ const noopSubscribe = () => () => {};
90
+ const alwaysFalse = () => false;
91
+
92
+ /** Not part of the public API; exported for the hydration test. */
93
+ export const AppShellContext = createContext<AppShellStore | null>(null);
52
94
 
53
95
  /** `null` outside an `AppShell`; otherwise whether the shell is narrower than 900 px. */
54
96
  export function useAppShell(): AppShellState | null {
55
- return useContext(AppShellContext);
97
+ const store = useContext(AppShellContext);
98
+ const compact = useSyncExternalStore(
99
+ store?.subscribe ?? noopSubscribe,
100
+ store?.getSnapshot ?? alwaysFalse,
101
+ alwaysFalse,
102
+ );
103
+ return useMemo(() => (store ? { compact } : null), [store, compact]);
56
104
  }
57
105
 
58
106
  export interface AppShellProps extends ComponentPropsWithRef<"div"> {
@@ -63,13 +111,21 @@ export interface AppShellProps extends ComponentPropsWithRef<"div"> {
63
111
  * Root of the app frame (sidebar + topbar + page). It is the `app` container: the sidebar turns
64
112
  * into a drawer and the topbar shows its menu button when the SHELL is under 900 px wide,
65
113
  * whatever the viewport is, so the same shell works in a full page, a preview or a story.
114
+ *
115
+ * The context value is a store that never changes identity, and it reads `false` on the server
116
+ * and on the first client render. Only components that call `useAppShell` update, and only once
117
+ * the measure arrives, so nothing above a still-dehydrated Suspense boundary re-renders during
118
+ * hydration (a provider value that changed there made Next.js client-render those boundaries).
66
119
  */
67
120
  export function AppShell({ children, className, ref: forwardedRef, ...props }: AppShellProps) {
68
121
  const ref = useRef<HTMLDivElement>(null);
69
- const compact = useCompactContainer(ref);
122
+ const [store] = useState(createAppShellStore);
70
123
  const composedRef = useComposedRefs(ref, forwardedRef);
124
+
125
+ useEffect(() => (ref.current ? store.observe(ref.current) : undefined), [store]);
126
+
71
127
  return (
72
- <AppShellContext.Provider value={{ compact }}>
128
+ <AppShellContext.Provider value={store}>
73
129
  <div ref={composedRef} {...props} className={cn("@container/app flex min-w-0", className)}>
74
130
  {children}
75
131
  </div>
@@ -0,0 +1,187 @@
1
+ "use client";
2
+
3
+ import { type ReactNode, useState } from "react";
4
+ import { useUiStrings } from "../../i18n/index.js";
5
+ import { Menu } from "../../icons/index.js";
6
+ import { Drawer, DrawerContent, DrawerTitle } from "../../overlays/drawer/index.js";
7
+ import type { ClassNames } from "../../utils/class-names.js";
8
+ import { cn } from "../../utils/cn.js";
9
+ import type { SidebarItem, SidebarLinkProps } from "../sidebar/index.js";
10
+ import { BOTTOM_NAV_MAX_SLOTS, splitBottomNavItems } from "./split.js";
11
+
12
+ export interface BottomNavLinkProps extends SidebarLinkProps {
13
+ /** Closes the "More" drawer after a navigation; pass it through to the rendered element. */
14
+ onClick?: () => void;
15
+ }
16
+
17
+ /** Renders a bottom-nav link; inject your router's link component here. */
18
+ export type BottomNavRenderLink = (props: BottomNavLinkProps) => ReactNode;
19
+
20
+ export type BottomNavPart =
21
+ | "root"
22
+ | "list"
23
+ | "item"
24
+ | "badge"
25
+ | "moreButton"
26
+ | "moreContent"
27
+ | "moreLink"
28
+ | "moreFooter";
29
+
30
+ export interface BottomNavProps {
31
+ /** Same items as `Sidebar` (`groups.flatMap((group) => group.items)`). Order decides what overflows. */
32
+ items: readonly SidebarItem[];
33
+ /** Accessible name of the bar landmark. */
34
+ ariaLabel: string;
35
+ /** Slots in the bar including "More". Defaults to 5; with fewer items than slots there is no "More". */
36
+ maxSlots?: number;
37
+ /** Text of the "More" button and the drawer title. Defaults to the localized "More". */
38
+ moreLabel?: string;
39
+ /** Pinned at the bottom of the "More" drawer, e.g. the account or a sign-out button. */
40
+ moreFooter?: ReactNode;
41
+ /** Link renderer; defaults to a plain anchor. */
42
+ renderLink?: BottomNavRenderLink;
43
+ className?: string;
44
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
45
+ classNames?: ClassNames<BottomNavPart>;
46
+ }
47
+
48
+ const defaultRenderLink: BottomNavRenderLink = ({ children, ...props }) => (
49
+ <a {...props}>{children}</a>
50
+ );
51
+
52
+ const slotClasses =
53
+ "relative flex min-h-14 w-full flex-col items-center justify-center gap-0.5 px-1 text-ink-2 text-meta focus-visible:focus-ring aria-[current=page]:font-bold aria-[current=page]:text-accent-ink data-[active=true]:font-bold data-[active=true]:text-accent-ink [&_svg]:size-5 [&_svg]:shrink-0";
54
+
55
+ /**
56
+ * Phone navigation bar for `Sidebar`'s items. The first items fill the bar and the rest move
57
+ * behind a "More" button that opens a drawer. Place it as the last child of the page column
58
+ * inside `AppShell`: it sticks to the bottom of the viewport and hides itself once the shell is
59
+ * 900 px or wider, where the sidebar takes over. Without an `AppShell` it is always visible.
60
+ */
61
+ export function BottomNav({
62
+ items,
63
+ ariaLabel,
64
+ maxSlots = BOTTOM_NAV_MAX_SLOTS,
65
+ moreLabel,
66
+ moreFooter,
67
+ renderLink = defaultRenderLink,
68
+ className,
69
+ classNames,
70
+ }: BottomNavProps) {
71
+ const strings = useUiStrings();
72
+ const [moreOpen, setMoreOpen] = useState(false);
73
+ const { visible, overflow } = splitBottomNavItems(items, maxSlots);
74
+ const more = moreLabel ?? strings.more;
75
+ const moreActive = overflow.some((item) => item.active);
76
+
77
+ return (
78
+ <>
79
+ <nav
80
+ aria-label={ariaLabel}
81
+ className={cn(
82
+ "sticky bottom-0 z-40 border-t-divider bg-surface pb-[env(safe-area-inset-bottom)] @min-[900px]/app:hidden",
83
+ classNames?.root,
84
+ className,
85
+ )}
86
+ >
87
+ <ul
88
+ className={cn(
89
+ "m-0 grid list-none auto-cols-[minmax(min-content,1fr)] grid-flow-col p-0",
90
+ classNames?.list,
91
+ )}
92
+ >
93
+ {visible.map((item) => (
94
+ <li key={item.id} className={classNames?.item}>
95
+ {renderLink({
96
+ href: item.href,
97
+ "aria-current": item.active ? "page" : undefined,
98
+ className: slotClasses,
99
+ children: (
100
+ <>
101
+ <span className="relative">
102
+ {item.icon}
103
+ {item.badge !== undefined ? (
104
+ <>
105
+ <span
106
+ aria-hidden="true"
107
+ className={cn(
108
+ "absolute -top-0.5 -right-1 size-2 rounded-pill",
109
+ item.badgeTone === "danger" ? "bg-danger" : "bg-warning",
110
+ classNames?.badge,
111
+ )}
112
+ />
113
+ <span className="sr-only">{item.badgeLabel ?? item.badge}</span>
114
+ </>
115
+ ) : null}
116
+ </span>
117
+ <span className="max-w-full truncate">{item.label}</span>
118
+ </>
119
+ ),
120
+ })}
121
+ </li>
122
+ ))}
123
+ {overflow.length > 0 ? (
124
+ <li className={classNames?.item}>
125
+ <button
126
+ type="button"
127
+ data-active={moreActive}
128
+ aria-haspopup="dialog"
129
+ aria-expanded={moreOpen}
130
+ onClick={() => setMoreOpen(true)}
131
+ className={cn(slotClasses, classNames?.moreButton)}
132
+ >
133
+ <Menu aria-hidden="true" />
134
+ <span>{more}</span>
135
+ </button>
136
+ </li>
137
+ ) : null}
138
+ </ul>
139
+ </nav>
140
+
141
+ {overflow.length > 0 ? (
142
+ <Drawer open={moreOpen} onOpenChange={setMoreOpen}>
143
+ <DrawerContent
144
+ aria-describedby={undefined}
145
+ className={cn("gap-4 p-4", classNames?.moreContent)}
146
+ >
147
+ <DrawerTitle className="font-semibold text-lede">{more}</DrawerTitle>
148
+ <nav aria-label={more} className="flex flex-col gap-px">
149
+ {overflow.map((item) => (
150
+ <div key={item.id}>
151
+ {renderLink({
152
+ href: item.href,
153
+ "aria-current": item.active ? "page" : undefined,
154
+ onClick: () => setMoreOpen(false),
155
+ className: cn(
156
+ "flex min-h-11 items-center gap-2.5 rounded-control px-2.5 py-2 text-control text-ink-2 hover:bg-surface-2 hover:text-ink focus-visible:focus-ring aria-[current=page]:bg-accent-soft aria-[current=page]:font-bold aria-[current=page]:text-accent-ink [&_svg]:size-4.25 [&_svg]:shrink-0",
157
+ classNames?.moreLink,
158
+ ),
159
+ children: (
160
+ <>
161
+ {item.icon}
162
+ <span className="min-w-0 truncate">{item.label}</span>
163
+ {item.badge !== undefined ? (
164
+ <span className="ml-auto shrink-0 rounded-chip bg-surface-2 px-1.5 py-0.75 text-count text-ink-2">
165
+ {item.badge}
166
+ {item.badgeLabel ? (
167
+ <span className="sr-only"> {item.badgeLabel}</span>
168
+ ) : null}
169
+ </span>
170
+ ) : null}
171
+ </>
172
+ ),
173
+ })}
174
+ </div>
175
+ ))}
176
+ </nav>
177
+ {moreFooter ? (
178
+ <div className={cn("mt-auto border-t-divider pt-3", classNames?.moreFooter)}>
179
+ {moreFooter}
180
+ </div>
181
+ ) : null}
182
+ </DrawerContent>
183
+ </Drawer>
184
+ ) : null}
185
+ </>
186
+ );
187
+ }
@@ -0,0 +1,8 @@
1
+ export {
2
+ BottomNav,
3
+ type BottomNavLinkProps,
4
+ type BottomNavPart,
5
+ type BottomNavProps,
6
+ type BottomNavRenderLink,
7
+ } from "./bottom-nav.js";
8
+ export { BOTTOM_NAV_MAX_SLOTS, type BottomNavSplit, splitBottomNavItems } from "./split.js";
@@ -0,0 +1,20 @@
1
+ /** Slots of a bottom bar on a phone, the "More" button included. */
2
+ export const BOTTOM_NAV_MAX_SLOTS = 5;
3
+
4
+ export interface BottomNavSplit<T> {
5
+ visible: T[];
6
+ overflow: T[];
7
+ }
8
+
9
+ /**
10
+ * Items shown in the bar and items moved behind "More". Everything fits when there are at most
11
+ * `maxSlots` items; otherwise one slot is given to "More" and the rest overflow in order.
12
+ */
13
+ export function splitBottomNavItems<T>(
14
+ items: readonly T[],
15
+ maxSlots: number = BOTTOM_NAV_MAX_SLOTS,
16
+ ): BottomNavSplit<T> {
17
+ const slots = Math.max(2, Math.floor(maxSlots));
18
+ if (items.length <= slots) return { visible: [...items], overflow: [] };
19
+ return { visible: items.slice(0, slots - 1), overflow: items.slice(slots - 1) };
20
+ }