trebol 0.1.1 → 0.2.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 (300) hide show
  1. package/README.md +12 -1
  2. package/dist/cli.js +17097 -12238
  3. package/dist/fonts/OFL.txt +93 -0
  4. package/dist/fonts/inter-cyrillic-ext.woff2 +0 -0
  5. package/dist/fonts/inter-cyrillic.woff2 +0 -0
  6. package/dist/fonts/inter-greek-ext.woff2 +0 -0
  7. package/dist/fonts/inter-greek.woff2 +0 -0
  8. package/dist/fonts/inter-latin-ext.woff2 +0 -0
  9. package/dist/fonts/inter-latin.woff2 +0 -0
  10. package/dist/fonts/inter-vietnamese.woff2 +0 -0
  11. package/dist/lib/core/boot.js +12 -8
  12. package/dist/lib/core/eval.js +2 -2
  13. package/dist/lib/core/func.d.ts +4 -0
  14. package/dist/lib/core/machine/checks.d.ts +1 -0
  15. package/dist/lib/core/machine/checks.js +250 -0
  16. package/dist/lib/core/machine/events.d.ts +1 -0
  17. package/dist/lib/core/machine/events.js +365 -0
  18. package/dist/lib/core/machine/running.d.ts +1 -0
  19. package/dist/lib/core/machine/running.js +180 -0
  20. package/dist/lib/core/machine/shared.d.ts +1 -0
  21. package/dist/lib/core/machine/shared.js +123 -0
  22. package/dist/lib/core/machine/snapshot.d.ts +1 -0
  23. package/dist/lib/core/machine/snapshot.js +244 -0
  24. package/dist/lib/core/machine/spec.d.ts +1 -0
  25. package/dist/lib/core/machine/spec.js +274 -0
  26. package/dist/lib/core/machine/words.d.ts +1 -0
  27. package/dist/lib/core/machine/words.js +98 -0
  28. package/dist/lib/core/machine.d.ts +1 -0
  29. package/dist/lib/core/machine.js +17 -0
  30. package/dist/lib/core/mezz.js +31 -0
  31. package/dist/lib/core/natives/control.js +2 -2
  32. package/dist/lib/core/natives/data.js +6 -1
  33. package/dist/lib/core/natives/series.js +59 -9
  34. package/dist/lib/core/natives/text.js +3 -1
  35. package/dist/lib/host/browser/calendar.d.ts +34 -0
  36. package/dist/lib/host/browser/calendar.js +268 -0
  37. package/dist/lib/host/browser/count.d.ts +15 -0
  38. package/dist/lib/host/browser/count.js +48 -0
  39. package/dist/lib/host/browser/dialogs.d.ts +39 -0
  40. package/dist/lib/host/browser/dialogs.js +443 -0
  41. package/dist/lib/host/browser/drag.d.ts +70 -0
  42. package/dist/lib/host/browser/drag.js +268 -0
  43. package/dist/lib/host/browser/drawings.d.ts +30 -0
  44. package/dist/lib/host/browser/drawings.js +176 -0
  45. package/dist/lib/host/browser/events.d.ts +16 -0
  46. package/dist/lib/host/browser/events.js +125 -0
  47. package/dist/lib/host/browser/faces.d.ts +35 -0
  48. package/dist/lib/host/browser/faces.js +131 -0
  49. package/dist/lib/host/browser/fields.d.ts +16 -0
  50. package/dist/lib/host/browser/fields.js +322 -0
  51. package/dist/lib/host/browser/keys.d.ts +29 -0
  52. package/dist/lib/host/browser/keys.js +151 -0
  53. package/dist/lib/host/browser/lookup.d.ts +25 -0
  54. package/dist/lib/host/browser/lookup.js +275 -0
  55. package/dist/lib/host/browser/menus.d.ts +20 -0
  56. package/dist/lib/host/browser/menus.js +149 -0
  57. package/dist/lib/host/browser/mount.d.ts +92 -0
  58. package/dist/lib/host/browser/mount.js +448 -0
  59. package/dist/lib/host/browser/orbits.d.ts +90 -0
  60. package/dist/lib/host/browser/orbits.js +379 -0
  61. package/dist/lib/host/browser/page.d.ts +13 -0
  62. package/dist/lib/host/browser/page.js +35 -0
  63. package/dist/lib/host/browser/richtext.d.ts +19 -0
  64. package/dist/lib/host/browser/richtext.js +379 -0
  65. package/dist/lib/host/browser/row-faces.d.ts +5 -0
  66. package/dist/lib/host/browser/row-faces.js +74 -0
  67. package/dist/lib/host/browser/screens.d.ts +37 -0
  68. package/dist/lib/host/browser/screens.js +140 -0
  69. package/dist/lib/host/browser/swipe.d.ts +31 -0
  70. package/dist/lib/host/browser/swipe.js +178 -0
  71. package/dist/lib/host/browser/sync.d.ts +24 -0
  72. package/dist/lib/host/browser/sync.js +450 -0
  73. package/dist/lib/host/browser/tables.d.ts +65 -0
  74. package/dist/lib/host/browser/tables.js +505 -0
  75. package/dist/lib/host/browser/times.d.ts +14 -0
  76. package/dist/lib/host/browser/times.js +114 -0
  77. package/dist/lib/host/browser/toolbars.d.ts +17 -0
  78. package/dist/lib/host/browser/toolbars.js +129 -0
  79. package/dist/lib/host/browser/trees.d.ts +20 -0
  80. package/dist/lib/host/browser/trees.js +235 -0
  81. package/dist/lib/host/browser/uploads.d.ts +29 -0
  82. package/dist/lib/host/browser/uploads.js +370 -0
  83. package/dist/lib/host/browser/widget.d.ts +13 -0
  84. package/dist/lib/host/browser/widget.js +105 -0
  85. package/dist/lib/host/browser.d.ts +25 -0
  86. package/dist/lib/host/browser.js +129 -3964
  87. package/dist/lib/host/devlog.d.ts +11 -0
  88. package/dist/lib/host/devlog.js +13 -0
  89. package/dist/lib/host/devtools/console.d.ts +9 -0
  90. package/dist/lib/host/devtools/console.js +104 -0
  91. package/dist/lib/host/devtools/faces.d.ts +25 -0
  92. package/dist/lib/host/devtools/faces.js +169 -0
  93. package/dist/lib/host/devtools/log.d.ts +3 -0
  94. package/dist/lib/host/devtools/log.js +32 -0
  95. package/dist/lib/host/devtools/machines.d.ts +34 -0
  96. package/dist/lib/host/devtools/machines.js +212 -0
  97. package/dist/lib/host/devtools/read.d.ts +13 -0
  98. package/dist/lib/host/devtools/read.js +52 -0
  99. package/dist/lib/host/devtools/state.d.ts +90 -0
  100. package/dist/lib/host/devtools/state.js +123 -0
  101. package/dist/lib/host/devtools.d.ts +19 -0
  102. package/dist/lib/host/devtools.js +238 -0
  103. package/dist/lib/host/fonts/OFL.txt +93 -0
  104. package/dist/lib/host/fonts/inter-cyrillic-ext.woff2 +0 -0
  105. package/dist/lib/host/fonts/inter-cyrillic.woff2 +0 -0
  106. package/dist/lib/host/fonts/inter-greek-ext.woff2 +0 -0
  107. package/dist/lib/host/fonts/inter-greek.woff2 +0 -0
  108. package/dist/lib/host/fonts/inter-latin-ext.woff2 +0 -0
  109. package/dist/lib/host/fonts/inter-latin.woff2 +0 -0
  110. package/dist/lib/host/fonts/inter-vietnamese.woff2 +0 -0
  111. package/dist/lib/host/fonts.d.ts +11 -0
  112. package/dist/lib/host/fonts.js +30 -0
  113. package/dist/lib/host/icons.js +4 -0
  114. package/dist/lib/host/index.d.ts +5 -1
  115. package/dist/lib/host/index.js +110 -5
  116. package/dist/lib/host/js.d.ts +5 -0
  117. package/dist/lib/host/js.js +130 -0
  118. package/dist/lib/host/locale.d.ts +18 -0
  119. package/dist/lib/host/locale.js +75 -5
  120. package/dist/lib/host/markdown.d.ts +6 -0
  121. package/dist/lib/host/markdown.js +18 -0
  122. package/dist/lib/host/modules.d.ts +4 -0
  123. package/dist/lib/host/modules.js +157 -20
  124. package/dist/lib/host/motion.d.ts +32 -0
  125. package/dist/lib/host/motion.js +190 -0
  126. package/dist/lib/host/net.js +14 -3
  127. package/dist/lib/host/orbit.d.ts +121 -0
  128. package/dist/lib/host/orbit.js +374 -0
  129. package/dist/lib/host/palette.d.ts +17 -0
  130. package/dist/lib/host/palette.js +131 -0
  131. package/dist/lib/host/rows.d.ts +14 -0
  132. package/dist/lib/host/rows.js +29 -0
  133. package/dist/lib/host/scheduler.d.ts +8 -0
  134. package/dist/lib/host/scheduler.js +64 -36
  135. package/dist/lib/host/share.d.ts +31 -0
  136. package/dist/lib/host/share.js +134 -0
  137. package/dist/lib/host/theme/classic.d.ts +1 -0
  138. package/dist/lib/host/theme/classic.js +120 -0
  139. package/dist/lib/host/theme/cupertino.d.ts +1 -0
  140. package/dist/lib/host/theme/cupertino.js +65 -0
  141. package/dist/lib/host/theme/data.d.ts +1 -0
  142. package/dist/lib/host/theme/data.js +109 -0
  143. package/dist/lib/host/theme/devtools.d.ts +1 -0
  144. package/dist/lib/host/theme/devtools.js +166 -0
  145. package/dist/lib/host/theme/dialogs.d.ts +1 -0
  146. package/dist/lib/host/theme/dialogs.js +63 -0
  147. package/dist/lib/host/theme/fluent.d.ts +1 -0
  148. package/dist/lib/host/theme/fluent.js +64 -0
  149. package/dist/lib/host/theme/forms.d.ts +1 -0
  150. package/dist/lib/host/theme/forms.js +239 -0
  151. package/dist/lib/host/theme/fusion.d.ts +1 -0
  152. package/dist/lib/host/theme/fusion.js +66 -0
  153. package/dist/lib/host/theme/layout.d.ts +1 -0
  154. package/dist/lib/host/theme/layout.js +166 -0
  155. package/dist/lib/host/theme/media.d.ts +1 -0
  156. package/dist/lib/host/theme/media.js +106 -0
  157. package/dist/lib/host/theme/navigation.d.ts +1 -0
  158. package/dist/lib/host/theme/navigation.js +36 -0
  159. package/dist/lib/host/theme/panes.d.ts +1 -0
  160. package/dist/lib/host/theme/panes.js +99 -0
  161. package/dist/lib/host/theme/popups.d.ts +1 -0
  162. package/dist/lib/host/theme/popups.js +149 -0
  163. package/dist/lib/host/theme/responsive.d.ts +1 -0
  164. package/dist/lib/host/theme/responsive.js +103 -0
  165. package/dist/lib/host/theme/toasts.d.ts +1 -0
  166. package/dist/lib/host/theme/toasts.js +62 -0
  167. package/dist/lib/host/theme.js +19 -1179
  168. package/dist/lib/ui/dialect/events.trb +276 -0
  169. package/dist/lib/ui/dialect/faces.trb +135 -0
  170. package/dist/lib/ui/dialect/layout.trb +283 -0
  171. package/dist/lib/ui/dialect/palette.trb +87 -0
  172. package/dist/lib/ui/dialect/problems.trb +174 -0
  173. package/dist/lib/ui/dialect/reactions.trb +198 -0
  174. package/dist/lib/ui/dialect/rows.trb +208 -0
  175. package/dist/lib/ui/dialect/screens.trb +293 -0
  176. package/dist/lib/ui/dialect/steps.trb +203 -0
  177. package/dist/lib/ui/dialect/validation.trb +137 -0
  178. package/dist/lib/ui/dialect/view.trb +110 -0
  179. package/dist/lib/ui/dialect/walking.trb +98 -0
  180. package/dist/lib/ui/dialect/words.trb +70 -0
  181. package/dist/lib/ui/i18n.trb +23 -0
  182. package/dist/lib/ui/test.trb +12 -0
  183. package/dist/lib/ui/testing/actions.trb +421 -0
  184. package/dist/lib/ui/testing/faces.trb +148 -0
  185. package/dist/lib/ui/testing/server.trb +73 -0
  186. package/dist/lib/ui/ui.trb +25 -1234
  187. package/dist/trebol.js +4882 -1088
  188. package/editors/vscode/README.md +15 -0
  189. package/editors/vscode/language-configuration.json +28 -0
  190. package/editors/vscode/package.json +42 -0
  191. package/editors/vscode/syntaxes/trebol.tmLanguage.json +237 -0
  192. package/package.json +7 -3
  193. package/src/core/boot.ts +10 -7
  194. package/src/core/eval.ts +2 -2
  195. package/src/core/func.ts +4 -0
  196. package/src/core/machine/checks.ts +251 -0
  197. package/src/core/machine/events.ts +366 -0
  198. package/src/core/machine/running.ts +181 -0
  199. package/src/core/machine/shared.ts +124 -0
  200. package/src/core/machine/snapshot.ts +245 -0
  201. package/src/core/machine/spec.ts +275 -0
  202. package/src/core/machine/words.ts +99 -0
  203. package/src/core/machine.ts +20 -0
  204. package/src/core/mezz.ts +31 -0
  205. package/src/core/natives/control.ts +2 -2
  206. package/src/core/natives/data.ts +6 -1
  207. package/src/core/natives/parse.ts +1 -1
  208. package/src/core/natives/series.ts +55 -11
  209. package/src/core/natives/text.ts +2 -1
  210. package/src/host/browser/calendar.ts +264 -0
  211. package/src/host/browser/count.ts +48 -0
  212. package/src/host/browser/dialogs.ts +439 -0
  213. package/src/host/browser/drag.ts +278 -0
  214. package/src/host/browser/drawings.ts +178 -0
  215. package/src/host/browser/events.ts +117 -0
  216. package/src/host/browser/faces.ts +143 -0
  217. package/src/host/browser/fields.ts +315 -0
  218. package/src/host/browser/keys.ts +145 -0
  219. package/src/host/browser/lookup.ts +262 -0
  220. package/src/host/browser/menus.ts +146 -0
  221. package/src/host/browser/mount.ts +420 -0
  222. package/src/host/browser/orbits.ts +418 -0
  223. package/src/host/browser/page.ts +43 -0
  224. package/src/host/browser/richtext.ts +346 -0
  225. package/src/host/browser/row-faces.ts +75 -0
  226. package/src/host/browser/screens.ts +142 -0
  227. package/src/host/browser/swipe.ts +168 -0
  228. package/src/host/browser/sync.ts +354 -0
  229. package/src/host/browser/tables.ts +461 -0
  230. package/src/host/browser/times.ts +115 -0
  231. package/src/host/browser/toolbars.ts +126 -0
  232. package/src/host/browser/trees.ts +205 -0
  233. package/src/host/browser/uploads.ts +367 -0
  234. package/src/host/browser/widget.ts +103 -0
  235. package/src/host/browser.ts +128 -3747
  236. package/src/host/devlog.ts +16 -0
  237. package/src/host/devtools/console.ts +102 -0
  238. package/src/host/devtools/faces.ts +160 -0
  239. package/src/host/devtools/log.ts +34 -0
  240. package/src/host/devtools/machines.ts +208 -0
  241. package/src/host/devtools/read.ts +58 -0
  242. package/src/host/devtools/state.ts +148 -0
  243. package/src/host/devtools.ts +238 -0
  244. package/src/host/fonts/OFL.txt +93 -0
  245. package/src/host/fonts/inter-cyrillic-ext.woff2 +0 -0
  246. package/src/host/fonts/inter-cyrillic.woff2 +0 -0
  247. package/src/host/fonts/inter-greek-ext.woff2 +0 -0
  248. package/src/host/fonts/inter-greek.woff2 +0 -0
  249. package/src/host/fonts/inter-latin-ext.woff2 +0 -0
  250. package/src/host/fonts/inter-latin.woff2 +0 -0
  251. package/src/host/fonts/inter-vietnamese.woff2 +0 -0
  252. package/src/host/fonts.ts +40 -0
  253. package/src/host/icons.ts +4 -0
  254. package/src/host/index.ts +110 -5
  255. package/src/host/js.ts +127 -0
  256. package/src/host/locale.ts +71 -5
  257. package/src/host/markdown.ts +18 -0
  258. package/src/host/modules.ts +150 -22
  259. package/src/host/motion.ts +204 -0
  260. package/src/host/net.ts +13 -3
  261. package/src/host/orbit.ts +432 -0
  262. package/src/host/palette.ts +139 -0
  263. package/src/host/rows.ts +30 -0
  264. package/src/host/scheduler.ts +67 -36
  265. package/src/host/share.ts +168 -0
  266. package/src/host/theme/classic.ts +121 -0
  267. package/src/host/theme/cupertino.ts +66 -0
  268. package/src/host/theme/data.ts +110 -0
  269. package/src/host/theme/devtools.ts +167 -0
  270. package/src/host/theme/dialogs.ts +64 -0
  271. package/src/host/theme/fluent.ts +65 -0
  272. package/src/host/theme/forms.ts +240 -0
  273. package/src/host/theme/fusion.ts +67 -0
  274. package/src/host/theme/layout.ts +167 -0
  275. package/src/host/theme/media.ts +107 -0
  276. package/src/host/theme/navigation.ts +37 -0
  277. package/src/host/theme/panes.ts +100 -0
  278. package/src/host/theme/popups.ts +150 -0
  279. package/src/host/theme/responsive.ts +104 -0
  280. package/src/host/theme/toasts.ts +63 -0
  281. package/src/host/theme.ts +19 -1179
  282. package/src/ui/dialect/events.trb +276 -0
  283. package/src/ui/dialect/faces.trb +135 -0
  284. package/src/ui/dialect/layout.trb +283 -0
  285. package/src/ui/dialect/palette.trb +87 -0
  286. package/src/ui/dialect/problems.trb +174 -0
  287. package/src/ui/dialect/reactions.trb +198 -0
  288. package/src/ui/dialect/rows.trb +208 -0
  289. package/src/ui/dialect/screens.trb +293 -0
  290. package/src/ui/dialect/steps.trb +203 -0
  291. package/src/ui/dialect/validation.trb +137 -0
  292. package/src/ui/dialect/view.trb +110 -0
  293. package/src/ui/dialect/walking.trb +98 -0
  294. package/src/ui/dialect/words.trb +70 -0
  295. package/src/ui/i18n.trb +23 -0
  296. package/src/ui/test.trb +12 -0
  297. package/src/ui/testing/actions.trb +421 -0
  298. package/src/ui/testing/faces.trb +148 -0
  299. package/src/ui/testing/server.trb +73 -0
  300. package/src/ui/ui.trb +25 -1234
@@ -0,0 +1,126 @@
1
+ // --- toolbars and breadcrumbs -------------------------------------------------------
2
+
3
+ import { K, NONE, form, wordOf, type Cell, type ObjectCell } from '../../core/index.ts';
4
+ import { translate } from '../index.ts';
5
+ import { get, keepOwn, word } from './faces.ts';
6
+ import { type Mounted, host, byNode, fire, el } from './mount.ts';
7
+ import { openMenu } from './menus.ts';
8
+ import { sync } from './sync.ts';
9
+
10
+ export const BAR_ITEMS = 'button, a[href], input, select, textarea, [tabindex]';
11
+
12
+ /** The controls of a toolbar, in order; `shown` skips hidden and disabled ones. */
13
+ export function barItems(bar: HTMLElement, shown = true): HTMLElement[] {
14
+ return Array.from(bar.querySelectorAll<HTMLElement>(BAR_ITEMS)).filter(e => e.closest('.tb-toolbar') === bar
15
+ && (!shown || e.getClientRects().length > 0 && !(e as HTMLButtonElement).disabled));
16
+ }
17
+
18
+ export function buildToolbar(): HTMLElement {
19
+ const bar = el('div', 'tb-toolbar');
20
+ bar.setAttribute('role', 'toolbar');
21
+ // one Tab stop: the arrows move between the controls (roving tabindex)
22
+ bar.addEventListener('keydown', ev => {
23
+ const at = ev.target as HTMLElement;
24
+ if (ev.altKey || ev.ctrlKey || ev.metaKey || at.matches('input, select, textarea')) return;
25
+ const items = barItems(bar);
26
+ const i = items.indexOf(at);
27
+ if (i < 0) return;
28
+ const to = ev.key === 'ArrowRight' ? (i + 1) % items.length : ev.key === 'ArrowLeft' ? (i - 1 + items.length) % items.length
29
+ : ev.key === 'Home' ? 0 : ev.key === 'End' ? items.length - 1 : -1;
30
+ if (to < 0) return;
31
+ ev.preventDefault();
32
+ items[to]!.focus();
33
+ });
34
+ bar.addEventListener('focusin', ev => {
35
+ const at = ev.target as HTMLElement;
36
+ if (!barItems(bar, false).includes(at)) return;
37
+ for (const e of barItems(bar, false)) e.tabIndex = e === at ? 0 : -1;
38
+ });
39
+ return bar;
40
+ }
41
+
42
+ /** Keeps exactly one control of a toolbar in the Tab order, and the text of its buttons as their tooltip. */
43
+ export function syncToolbar(bar: HTMLElement): void {
44
+ for (const e of Array.from(bar.children)) {
45
+ const m = byNode.get(e);
46
+ if (m !== undefined && m.el === e && word(m.face, 'style') === 'button') sync(m);
47
+ }
48
+ // the bar may not be on the page yet, so visibility is checked only when moving
49
+ const items = barItems(bar, false);
50
+ const current = items.find(e => e.tabIndex === 0 && e.hasAttribute('tabindex')) ?? items[0];
51
+ for (const e of items) e.tabIndex = e === current ? 0 : -1;
52
+ }
53
+
54
+ export interface Crumb { text: string; id: Cell }
55
+
56
+ /** The items of a breadcrumb: a label and a word or path each, the last one maybe without. */
57
+ export function crumbs(face: ObjectCell): Crumb[] {
58
+ const d = get(face, 'data');
59
+ if (d.t !== K.Block) return [];
60
+ const out: Crumb[] = [];
61
+ const cells = d.s.data.slice(d.i);
62
+ for (let i = 0; i < cells.length; i++) {
63
+ const c = cells[i]!;
64
+ if (c.t !== K.String && c.t !== K.Map) continue;
65
+ const next = cells[i + 1];
66
+ const id = next !== undefined && (next.t === K.Word || next.t === K.Path) ? next : NONE;
67
+ if (id !== NONE) i++;
68
+ out.push({ text: translate(c, host.rt), id });
69
+ }
70
+ return out;
71
+ }
72
+
73
+ export function buildBreadcrumb(m: Mounted): HTMLElement {
74
+ const nav = el('nav', 'tb-breadcrumb');
75
+ keepOwn(nav, 'breadcrumb', 'aria-label');
76
+ m.box = el('ol');
77
+ nav.append(m.box);
78
+ return nav;
79
+ }
80
+
81
+ /** Rebuilds the items; on narrow screens the middle ones hide behind a "…" that lists them in a menu. */
82
+ export function syncBreadcrumb(m: Mounted): void {
83
+ const f = m.face;
84
+ const items = crumbs(f);
85
+ // choosing an item sets value, which repaints the face: keep the nodes (and the focus) if nothing changed
86
+ const signature = items.map(c => `${c.text}\u0000${form(c.id)}`).join('\u0001');
87
+ if (m.kids === signature) return;
88
+ m.kids = signature;
89
+ // a lit-word or lit-path, so that passing it on does not evaluate it
90
+ const pick = (c: Crumb): void => void fire('ui-crumb', f, c.id.t === K.Path ? ({ ...c.id, t: K.LitPath } as Cell) : wordOf(K.LitWord, form(c.id)));
91
+ const middle = items.length > 3 ? items.slice(1, -2) : [];
92
+ const nodes: HTMLElement[] = items.map((c, i) => {
93
+ const li = el('li');
94
+ if (middle.includes(c)) li.className = 'tb-crumb-middle';
95
+ if (c.id === NONE) {
96
+ const span = el('span', 'tb-crumb');
97
+ span.textContent = c.text;
98
+ if (i === items.length - 1) span.setAttribute('aria-current', 'page');
99
+ li.append(span);
100
+ } else {
101
+ const b = el('button', 'tb-crumb');
102
+ b.type = 'button';
103
+ b.textContent = c.text;
104
+ b.addEventListener('click', () => pick(c));
105
+ li.append(b);
106
+ }
107
+ return li;
108
+ });
109
+ if (middle.length > 0) {
110
+ const li = el('li', 'tb-crumb-more');
111
+ const b = el('button', 'tb-crumb');
112
+ b.type = 'button';
113
+ b.textContent = '…';
114
+ keepOwn(b, 'more-levels', 'aria-label');
115
+ b.setAttribute('aria-haspopup', 'menu');
116
+ b.setAttribute('aria-expanded', 'false');
117
+ b.addEventListener('click', () => {
118
+ const r = b.getBoundingClientRect();
119
+ openMenu(middle.map(c => ({ text: c.text, run: () => pick(c) })), r.left, r.bottom + 4, b);
120
+ });
121
+ li.append(b);
122
+ nodes.splice(1, 0, li);
123
+ }
124
+ m.box!.replaceChildren(...nodes);
125
+ }
126
+
@@ -0,0 +1,205 @@
1
+ // --- trees ---------------------------------------------------------------------------
2
+
3
+ import { K, NONE, form, intern, type Cell, type ObjectCell, type BlockCell, type WordCell } from '../../core/index.ts';
4
+ import { rowField } from '../rows.ts';
5
+ import { get, str, own, flag, icon } from './faces.ts';
6
+ import { type Mounted, rowOf, fire, el } from './mount.ts';
7
+ import { type Source, type Target, insertionAt } from './drag.ts';
8
+ import { columns, sameRow, cellText } from './tables.ts';
9
+
10
+ export const CHILDREN = intern('children');
11
+ export const EXPANDED = intern('expanded');
12
+
13
+ export function treeItems(m: Mounted): HTMLElement[] {
14
+ return Array.from(m.box!.querySelectorAll<HTMLElement>('[role="treeitem"]'));
15
+ }
16
+
17
+ /** The node whose children a group holds; none for the root. */
18
+ export function groupParent(m: Mounted, group: HTMLElement): Cell {
19
+ if (group === m.box) return NONE;
20
+ const item = group.closest('[role="treeitem"]');
21
+ return item !== null ? rowOf.get(item) ?? NONE : NONE;
22
+ }
23
+
24
+ export function buildTree(face: ObjectCell, m: Mounted): HTMLElement {
25
+ const wrap = el('div', 'tb-tree-wrap');
26
+ const box = el('ul', 'tb-tree');
27
+ box.setAttribute('role', 'tree');
28
+ const empty = el('p', 'tb-empty');
29
+ wrap.append(box, empty);
30
+ box.addEventListener('click', ev => {
31
+ const target = ev.target as Element;
32
+ const item = target.closest<HTMLElement>('[role="treeitem"]');
33
+ if (item === null) return;
34
+ if (target.closest('.tb-tree-toggle') !== null) return toggleNode(m, item);
35
+ focusItem(m, item);
36
+ selectNode(m, item);
37
+ });
38
+ box.addEventListener('keydown', ev => treeKey(m, ev));
39
+ m.box = box;
40
+ m.rows = new Map();
41
+ m.empty = empty;
42
+ m.open = new Set();
43
+ return wrap;
44
+ }
45
+
46
+ export function newTreeItem(): HTMLElement {
47
+ const li = el('li');
48
+ li.setAttribute('role', 'treeitem');
49
+ const row = el('div', 'tb-tree-row');
50
+ const toggle = el('span', 'tb-tree-toggle');
51
+ toggle.setAttribute('aria-hidden', 'true');
52
+ const chevron = icon('chevron-right');
53
+ if (chevron !== null) toggle.append(chevron);
54
+ row.append(toggle, el('span', 'tb-tree-label'));
55
+ const group = el('ul');
56
+ group.setAttribute('role', 'group');
57
+ li.append(row, group);
58
+ return li;
59
+ }
60
+
61
+ /** Creates, updates, moves or removes the items of a tree, level by level, by key. */
62
+ export function syncTree(m: Mounted): void {
63
+ const f = m.face;
64
+ const label = columns(f)[0]?.sym ?? intern('name');
65
+ const keyWord = get(f, 'key');
66
+ const key = keyWord.t === K.Word || keyWord.t === K.LitWord ? (keyWord as WordCell).sym : intern('id');
67
+ const selected = get(f, 'selected');
68
+ const old = m.rows!;
69
+ const open = m.open!;
70
+ const next = new Map<string, HTMLElement>();
71
+ const level = (group: HTMLElement, nodes: Cell[], depth: number, parentKey: string): void => {
72
+ let cursor = group.firstChild;
73
+ nodes.forEach((node, i) => {
74
+ const id = rowField(node, key);
75
+ let k = id.t === K.None ? `${parentKey}/${i}` : `${id.t}:${form(id)}`;
76
+ if (next.has(k)) k = `${parentKey}/${i}#${k}`;
77
+ const known = old.get(k);
78
+ const item = known ?? newTreeItem();
79
+ next.set(k, item);
80
+ rowOf.set(item, node);
81
+ item.dataset['key'] = k;
82
+ item.setAttribute('aria-level', String(depth));
83
+ item.style.setProperty('--tb-level', String(depth - 1));
84
+ const text = cellText(rowField(node, label));
85
+ const name = item.firstElementChild!.lastElementChild!;
86
+ if (name.textContent !== text) name.textContent = text;
87
+ const kids = rowField(node, CHILDREN);
88
+ const folder = kids.t === K.Block;
89
+ // `expanded: true` opens a node the first time it shows
90
+ if (folder && known === undefined && rowField(node, EXPANDED).t === K.Logic && (rowField(node, EXPANDED) as { v: boolean }).v) open.add(k);
91
+ const isOpen = folder && open.has(k);
92
+ if (folder) item.setAttribute('aria-expanded', isOpen ? 'true' : 'false');
93
+ else item.removeAttribute('aria-expanded');
94
+ const sub = item.lastElementChild as HTMLElement;
95
+ if (isOpen) level(sub, (kids as BlockCell).s.data.slice((kids as BlockCell).i), depth + 1, k);
96
+ else sub.replaceChildren();
97
+ sub.hidden = sub.childElementCount === 0;
98
+ const on = selected.t !== K.None && sameRow(selected, node);
99
+ item.classList.toggle('tb-selected', on);
100
+ item.setAttribute('aria-selected', on ? 'true' : 'false');
101
+ if (item !== cursor) group.insertBefore(item, cursor);
102
+ else cursor = cursor.nextSibling;
103
+ });
104
+ // whatever is left after the last placed item is gone from the data
105
+ while (cursor !== null) {
106
+ const gone = cursor;
107
+ cursor = cursor.nextSibling;
108
+ gone.remove();
109
+ }
110
+ };
111
+ const data = get(f, 'data');
112
+ level(m.box!, data.t === K.Block ? data.s.data.slice(data.i) : [], 1, '');
113
+ m.rows = next;
114
+ // one Tab stop: the item that had it, else the selected one, else the first
115
+ const items = treeItems(m);
116
+ const current = items.find(e => e.tabIndex === 0 && e.hasAttribute('tabindex'))
117
+ ?? items.find(e => e.classList.contains('tb-selected')) ?? items[0];
118
+ for (const e of items) e.tabIndex = e === current ? 0 : -1;
119
+ m.empty!.textContent = str(f, 'text') ?? own('empty');
120
+ m.empty!.hidden = items.length > 0;
121
+ }
122
+
123
+ export function focusItem(m: Mounted, item: HTMLElement): void {
124
+ for (const e of treeItems(m)) e.tabIndex = e === item ? 0 : -1;
125
+ item.focus();
126
+ }
127
+
128
+ export function selectNode(m: Mounted, item: HTMLElement): void {
129
+ const node = rowOf.get(item);
130
+ if (node !== undefined) void fire('ui-select', m.face, node);
131
+ }
132
+
133
+ /** Opens or closes a folder; opening runs on-expand, which may load its children. */
134
+ export function toggleNode(m: Mounted, item: HTMLElement, want?: boolean): void {
135
+ if (!item.hasAttribute('aria-expanded')) return;
136
+ const k = item.dataset['key']!;
137
+ const open = want ?? !m.open!.has(k);
138
+ if (open === m.open!.has(k)) return;
139
+ const inside = document.activeElement !== item && item.contains(document.activeElement);
140
+ if (open) m.open!.add(k);
141
+ else m.open!.delete(k);
142
+ syncTree(m);
143
+ if (inside) focusItem(m, item);
144
+ const node = rowOf.get(item);
145
+ if (open && node !== undefined) void fire('ui-expand', m.face, node);
146
+ }
147
+
148
+ /** The keys of the treeview pattern: arrows, Home, End, Enter, Space and a letter to jump. */
149
+ export function treeKey(m: Mounted, ev: KeyboardEvent): void {
150
+ const item = (ev.target as Element).closest<HTMLElement>('[role="treeitem"]');
151
+ if (item === null || ev.altKey || ev.ctrlKey || ev.metaKey) return;
152
+ const items = treeItems(m);
153
+ const i = items.indexOf(item);
154
+ const expanded = item.getAttribute('aria-expanded');
155
+ let to: HTMLElement | null | undefined = null;
156
+ switch (ev.key) {
157
+ case 'ArrowDown': to = items[i + 1]; break;
158
+ case 'ArrowUp': to = items[i - 1]; break;
159
+ case 'Home': to = items[0]; break;
160
+ case 'End': to = items[items.length - 1]; break;
161
+ case 'ArrowRight':
162
+ if (expanded === 'false') toggleNode(m, item, true);
163
+ else if (expanded === 'true') to = item.querySelector<HTMLElement>('[role="treeitem"]');
164
+ break;
165
+ case 'ArrowLeft':
166
+ if (expanded === 'true') toggleNode(m, item, false);
167
+ else to = item.parentElement!.closest<HTMLElement>('[role="treeitem"]');
168
+ break;
169
+ case 'Enter': case ' ': selectNode(m, item); break;
170
+ default: {
171
+ if (ev.key.length !== 1 || ev.key.trim() === '') return;
172
+ const c = ev.key.toLowerCase();
173
+ const label = (e: HTMLElement): string => (e.querySelector('.tb-tree-label')?.textContent ?? '').toLowerCase();
174
+ to = [...items.slice(i + 1), ...items.slice(0, i)].find(e => label(e).startsWith(c));
175
+ }
176
+ }
177
+ ev.preventDefault();
178
+ if (to) focusItem(m, to);
179
+ }
180
+
181
+ /** Where a drag over a tree lands: between siblings, or into a folder when over the middle of its row. */
182
+ export function treeTarget(m: Mounted, src: Source, x: number, y: number): Target | null {
183
+ const at = document.elementFromPoint(x, y)?.closest<HTMLElement>('[role="treeitem"]');
184
+ const drop = flag(m.face, 'drop');
185
+ let t: Target;
186
+ if (at === null || at === undefined || !m.box!.contains(at)) {
187
+ t = { m, index: insertionAt(m, x, y), reorder: false, group: m.box!, parent: NONE };
188
+ } else {
189
+ const r = at.querySelector(':scope > .tb-tree-row')!.getBoundingClientRect();
190
+ if (at.hasAttribute('aria-expanded') && y > r.top + r.height / 4 && y < r.bottom - r.height / 4) {
191
+ const node = rowOf.get(at)!;
192
+ const kids = rowField(node, CHILDREN) as BlockCell;
193
+ t = { m, index: kids.s.data.length - kids.i, reorder: false, group: at.lastElementChild as HTMLElement, parent: node, into: at };
194
+ } else {
195
+ const group = at.parentElement!;
196
+ const index = Array.prototype.indexOf.call(group.children, at) + (y > r.top + r.height / 2 ? 1 : 0);
197
+ t = { m, index, reorder: false, group, parent: groupParent(m, group) };
198
+ }
199
+ }
200
+ // never into itself or below itself
201
+ if (src.el === t.into || src.el.contains(t.group!)) return null;
202
+ t.reorder = src.within === m && t.group === src.group && t.into === undefined;
203
+ return t.reorder || drop ? t : null;
204
+ }
205
+