@joniguerini/lume 0.0.0-stage → 1.9.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 (226) hide show
  1. package/LICENSE +25 -0
  2. package/README.md +62 -2
  3. package/base.css +165 -0
  4. package/bin/lumeui.mjs +163 -0
  5. package/components/alert.css +156 -0
  6. package/components/banner.css +98 -0
  7. package/components/button.css +291 -0
  8. package/components/calendar.css +532 -0
  9. package/components/carousel.css +175 -0
  10. package/components/chart.css +813 -0
  11. package/components/chat.css +670 -0
  12. package/components/checkbox.css +212 -0
  13. package/components/chip.css +224 -0
  14. package/components/code.css +36 -0
  15. package/components/color-picker.css +192 -0
  16. package/components/command.css +148 -0
  17. package/components/content.css +211 -0
  18. package/components/editor.css +174 -0
  19. package/components/feedback.css +320 -0
  20. package/components/filters.css +103 -0
  21. package/components/form.css +455 -0
  22. package/components/image-viewer.css +237 -0
  23. package/components/layers.css +138 -0
  24. package/components/link.css +87 -0
  25. package/components/loading.css +260 -0
  26. package/components/menu.css +180 -0
  27. package/components/modal.css +209 -0
  28. package/components/navigation.css +507 -0
  29. package/components/notifications.css +186 -0
  30. package/components/number-field.css +52 -0
  31. package/components/otp.css +119 -0
  32. package/components/panel.css +208 -0
  33. package/components/picker.css +207 -0
  34. package/components/rating.css +143 -0
  35. package/components/resizable.css +173 -0
  36. package/components/scrollbar.css +110 -0
  37. package/components/select.css +477 -0
  38. package/components/shell.css +837 -0
  39. package/components/slider.css +189 -0
  40. package/components/sortable.css +287 -0
  41. package/components/surfaces.css +182 -0
  42. package/components/switch.css +115 -0
  43. package/components/table.css +228 -0
  44. package/components/tabs.css +190 -0
  45. package/components/tags.css +83 -0
  46. package/components/toast.css +164 -0
  47. package/components/toolbar.css +80 -0
  48. package/components/upload.css +181 -0
  49. package/ds.css +48 -0
  50. package/fonts/Geist-LICENSE.txt +92 -0
  51. package/fonts/Geist-Variable.woff2 +0 -0
  52. package/fonts/GeistSerif-Regular.woff2 +0 -0
  53. package/fonts/JetBrainsMono-LICENSE.txt +93 -0
  54. package/fonts/JetBrainsMono-Variable.woff2 +0 -0
  55. package/fonts.css +29 -0
  56. package/icons/icons.d.ts +5 -0
  57. package/icons/icons.js +266 -0
  58. package/js/back-to-top.d.ts +2 -0
  59. package/js/back-to-top.js +62 -0
  60. package/js/banner.js +87 -0
  61. package/js/calendar.d.ts +3 -0
  62. package/js/calendar.js +472 -0
  63. package/js/carousel.d.ts +2 -0
  64. package/js/carousel.js +258 -0
  65. package/js/charts/bar.js +361 -0
  66. package/js/charts/core.js +604 -0
  67. package/js/charts/donut.js +206 -0
  68. package/js/charts/figures.js +97 -0
  69. package/js/charts/heatmap.js +410 -0
  70. package/js/charts/line.js +268 -0
  71. package/js/charts/scatter.js +211 -0
  72. package/js/charts.d.ts +12 -0
  73. package/js/charts.js +27 -0
  74. package/js/code-block.d.ts +3 -0
  75. package/js/code-block.js +32 -0
  76. package/js/color-picker.d.ts +4 -0
  77. package/js/color-picker.js +448 -0
  78. package/js/command-palette.js +233 -0
  79. package/js/composer.js +573 -0
  80. package/js/context-menu.d.ts +2 -0
  81. package/js/context-menu.js +154 -0
  82. package/js/date-picker.d.ts +2 -0
  83. package/js/date-picker.js +430 -0
  84. package/js/drawer.js +48 -0
  85. package/js/editor.d.ts +5 -0
  86. package/js/editor.js +615 -0
  87. package/js/field-support.js +77 -0
  88. package/js/file-upload.d.ts +2 -0
  89. package/js/file-upload.js +230 -0
  90. package/js/filters.js +266 -0
  91. package/js/form.d.ts +2 -0
  92. package/js/form.js +409 -0
  93. package/js/i18n.d.ts +14 -0
  94. package/js/i18n.js +83 -0
  95. package/js/image-viewer.d.ts +4 -0
  96. package/js/image-viewer.js +275 -0
  97. package/js/menu.d.ts +4 -0
  98. package/js/menu.js +237 -0
  99. package/js/messages.js +908 -0
  100. package/js/modal.d.ts +7 -0
  101. package/js/modal.js +183 -0
  102. package/js/notifications.d.ts +4 -0
  103. package/js/notifications.js +204 -0
  104. package/js/number-field.d.ts +2 -0
  105. package/js/number-field.js +175 -0
  106. package/js/otp-field.d.ts +2 -0
  107. package/js/otp-field.js +107 -0
  108. package/js/pagination.d.ts +3 -0
  109. package/js/pagination.js +143 -0
  110. package/js/popover.d.ts +2 -0
  111. package/js/popover.js +155 -0
  112. package/js/progress-ring.js +48 -0
  113. package/js/rating.d.ts +3 -0
  114. package/js/rating.js +130 -0
  115. package/js/resizable.d.ts +2 -0
  116. package/js/resizable.js +311 -0
  117. package/js/scrollbar.d.ts +2 -0
  118. package/js/scrollbar.js +273 -0
  119. package/js/segmented.js +60 -0
  120. package/js/select.d.ts +3 -0
  121. package/js/select.js +784 -0
  122. package/js/shell.d.ts +6 -0
  123. package/js/shell.js +373 -0
  124. package/js/slider.d.ts +2 -0
  125. package/js/slider.js +89 -0
  126. package/js/sortable.d.ts +5 -0
  127. package/js/sortable.js +463 -0
  128. package/js/stepper.d.ts +2 -0
  129. package/js/stepper.js +72 -0
  130. package/js/tabs.js +99 -0
  131. package/js/tag-field.d.ts +2 -0
  132. package/js/tag-field.js +177 -0
  133. package/js/theme.d.ts +9 -0
  134. package/js/theme.js +114 -0
  135. package/js/time-picker.d.ts +2 -0
  136. package/js/time-picker.js +279 -0
  137. package/js/toast.d.ts +17 -0
  138. package/js/toast.js +171 -0
  139. package/js/toolbar.d.ts +2 -0
  140. package/js/toolbar.js +107 -0
  141. package/js/tooltip.d.ts +2 -0
  142. package/js/tooltip.js +208 -0
  143. package/js/tree.d.ts +2 -0
  144. package/js/tree.js +168 -0
  145. package/lume.css +11574 -0
  146. package/lume.d.ts +104 -0
  147. package/lume.js +67 -0
  148. package/package.json +66 -4
  149. package/react/Alert.d.ts +24 -0
  150. package/react/Alert.js +21 -0
  151. package/react/AppShell.d.ts +67 -0
  152. package/react/AppShell.js +94 -0
  153. package/react/Avatar.d.ts +39 -0
  154. package/react/Avatar.js +40 -0
  155. package/react/Badge.d.ts +17 -0
  156. package/react/Badge.js +10 -0
  157. package/react/Button.d.ts +32 -0
  158. package/react/Button.js +17 -0
  159. package/react/Calendar.d.ts +48 -0
  160. package/react/Calendar.js +67 -0
  161. package/react/Carousel.d.ts +30 -0
  162. package/react/Carousel.js +38 -0
  163. package/react/Charts.d.ts +186 -0
  164. package/react/Charts.js +58 -0
  165. package/react/Chip.d.ts +34 -0
  166. package/react/Chip.js +26 -0
  167. package/react/Choice.d.ts +72 -0
  168. package/react/Choice.js +51 -0
  169. package/react/ColorPicker.d.ts +43 -0
  170. package/react/ColorPicker.js +73 -0
  171. package/react/Content.d.ts +58 -0
  172. package/react/Content.js +42 -0
  173. package/react/Controls.d.ts +97 -0
  174. package/react/Controls.js +118 -0
  175. package/react/Editor.d.ts +28 -0
  176. package/react/Editor.js +57 -0
  177. package/react/Field.d.ts +90 -0
  178. package/react/Field.js +65 -0
  179. package/react/Form.d.ts +36 -0
  180. package/react/Form.js +45 -0
  181. package/react/Icon.d.ts +13 -0
  182. package/react/Icon.js +8 -0
  183. package/react/IconButton.d.ts +19 -0
  184. package/react/IconButton.js +12 -0
  185. package/react/ImageViewer.d.ts +20 -0
  186. package/react/ImageViewer.js +22 -0
  187. package/react/InlineAction.d.ts +15 -0
  188. package/react/InlineAction.js +12 -0
  189. package/react/Layers.d.ts +118 -0
  190. package/react/Layers.js +115 -0
  191. package/react/Link.d.ts +32 -0
  192. package/react/Link.js +26 -0
  193. package/react/Loading.d.ts +67 -0
  194. package/react/Loading.js +49 -0
  195. package/react/Navigation.d.ts +181 -0
  196. package/react/Navigation.js +197 -0
  197. package/react/Notices.d.ts +43 -0
  198. package/react/Notices.js +89 -0
  199. package/react/Panel.d.ts +57 -0
  200. package/react/Panel.js +33 -0
  201. package/react/Pickers.d.ts +83 -0
  202. package/react/Pickers.js +70 -0
  203. package/react/Rating.d.ts +39 -0
  204. package/react/Rating.js +41 -0
  205. package/react/Resizable.d.ts +44 -0
  206. package/react/Resizable.js +30 -0
  207. package/react/Select.d.ts +53 -0
  208. package/react/Select.js +79 -0
  209. package/react/Sortable.d.ts +52 -0
  210. package/react/Sortable.js +113 -0
  211. package/react/Table.d.ts +60 -0
  212. package/react/Table.js +34 -0
  213. package/react/Toolbar.d.ts +45 -0
  214. package/react/Toolbar.js +45 -0
  215. package/react/cx.d.ts +2 -0
  216. package/react/cx.js +5 -0
  217. package/react/icon-names.d.ts +1 -0
  218. package/react/icon-names.js +2 -0
  219. package/react/index.d.ts +42 -0
  220. package/react/index.js +52 -0
  221. package/react/useController.d.ts +8 -0
  222. package/react/useController.js +16 -0
  223. package/react/useLocale.d.ts +5 -0
  224. package/react/useLocale.js +15 -0
  225. package/tokens.css +739 -0
  226. package/tokens.js +4911 -0
package/js/toast.js ADDED
@@ -0,0 +1,171 @@
1
+ /**
2
+ * Toast — aviso curto e passageiro, anunciado para leitores de tela.
3
+ *
4
+ * toast('Link copiado');
5
+ * toast('Projeto arquivado', { tone: 'success', action: { label: 'Desfazer', onClick: () => … } });
6
+ * const t = toast('Sincronizando…', { duration: Infinity }); t.close();
7
+ * copyText('var(--ds-color-brand-500)'); // copia e avisa
8
+ *
9
+ * toast('Nova mensagem', { position: 'top-end' });
10
+ * setToastPosition('bottom-end'); // padrão do app (salvo no navegador)
11
+ *
12
+ * Opções: icon (nome do ícone), tone ('neutral' | 'success' | 'warning' | 'danger' | 'info'),
13
+ * action ({ label, onClick }), duration (ms; padrão 2200, 5000 com ação; Infinity = até fechar),
14
+ * position ('top-start' | 'top-center' | 'top-end' | 'bottom-start' | 'bottom-center' | 'bottom-end').
15
+ * O tempo pausa enquanto o ponteiro ou o foco estão no toast. No máximo 3 por posição.
16
+ * Cada posição tem a própria região (role="status", aria-live="polite"), criada quando é usada.
17
+ */
18
+ import { icon } from '../icons/icons.js';
19
+ import { msg } from './i18n.js';
20
+
21
+ const DURATION = 2200;
22
+ const DURATION_WITH_ACTION = 5000;
23
+ const MAX_VISIBLE = 3;
24
+ const TONE_ICONS = { success: 'check-circle', warning: 'alert-triangle', danger: 'alert-circle', info: 'info' };
25
+
26
+ export const TOAST_POSITIONS = ['top-start', 'top-center', 'top-end', 'bottom-start', 'bottom-center', 'bottom-end'];
27
+ const DEFAULT_POSITION = 'bottom-center';
28
+ const POSITION_KEY = 'ds-toast-position';
29
+ const regions = new Map();
30
+
31
+ const isPosition = (value) => TOAST_POSITIONS.includes(value);
32
+
33
+ /** Posição padrão do app (a salva no navegador, ou embaixo ao centro). */
34
+ export function getToastPosition() {
35
+ try {
36
+ const saved = localStorage.getItem(POSITION_KEY);
37
+ if (isPosition(saved)) return saved;
38
+ } catch {}
39
+ return DEFAULT_POSITION;
40
+ }
41
+
42
+ /** Define a posição padrão do app e salva no navegador. Devolve a posição aplicada. */
43
+ export function setToastPosition(position) {
44
+ const next = isPosition(position) ? position : DEFAULT_POSITION;
45
+ try {
46
+ if (next === DEFAULT_POSITION) localStorage.removeItem(POSITION_KEY);
47
+ else localStorage.setItem(POSITION_KEY, next);
48
+ } catch {}
49
+ return next;
50
+ }
51
+
52
+ function ensureRegion(position) {
53
+ const existing = regions.get(position);
54
+ if (existing?.isConnected) return existing;
55
+ const region = document.createElement('div');
56
+ region.className = `ds-toast-region ds-toast-region--${position}`;
57
+ region.dataset.position = position;
58
+ region.setAttribute('role', 'status');
59
+ region.setAttribute('aria-live', 'polite');
60
+ document.body.append(region);
61
+ regions.set(position, region);
62
+ return region;
63
+ }
64
+
65
+ const escape = (s) => String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/"/g, '&quot;');
66
+
67
+ /** HTML interno do toast — usado pela API e pelas prévias estáticas da documentação. */
68
+ export function toastContent(message, { icon: name, tone = 'neutral', action, dismissible = false } = {}) {
69
+ const toned = tone !== 'neutral';
70
+ const glyph = name ?? TONE_ICONS[tone] ?? 'check';
71
+ return `<span class="ds-toast__icon">${icon(glyph, { size: toned ? 14 : 18 })}</span>
72
+ <span class="ds-toast__message">${escape(message)}</span>
73
+ ${action ? `<button type="button" class="ds-toast__action" data-toast-action>${escape(action.label)}</button>` : ''}
74
+ ${dismissible ? `<button type="button" class="ds-toast__close" data-toast-close aria-label="${msg('toast.close')}">${icon('x', { size: 16 })}</button>` : ''}`;
75
+ }
76
+
77
+ export const toastClasses = ({ tone = 'neutral' } = {}) => `ds-toast${tone !== 'neutral' ? ` ds-toast--${tone}` : ''}`;
78
+
79
+ export function toast(message, options = {}) {
80
+ const { action, duration } = options;
81
+ const position = isPosition(options.position) ? options.position : getToastPosition();
82
+ const time = duration ?? (action ? DURATION_WITH_ACTION : DURATION);
83
+ const persistent = !Number.isFinite(time) || time <= 0;
84
+
85
+ const el = document.createElement('div');
86
+ el.className = toastClasses(options);
87
+ el.innerHTML = toastContent(message, { ...options, dismissible: persistent });
88
+
89
+ const host = ensureRegion(position);
90
+ host.append(el);
91
+ // excesso: os mais antigos saem primeiro
92
+ const visible = [...host.querySelectorAll('.ds-toast:not([data-leaving])')];
93
+ visible.slice(0, Math.max(0, visible.length - MAX_VISIBLE)).forEach((old) => old.dsClose?.());
94
+
95
+ let timer;
96
+ let remaining = time;
97
+ let started = 0;
98
+ let closed = false;
99
+
100
+ const close = () => {
101
+ if (closed) return;
102
+ closed = true;
103
+ clearTimeout(timer);
104
+ el.setAttribute('data-leaving', '');
105
+ el.removeAttribute('data-open');
106
+ setTimeout(() => el.remove(), 320);
107
+ };
108
+ el.dsClose = close;
109
+
110
+ const start = () => {
111
+ if (persistent || closed) return;
112
+ started = Date.now();
113
+ timer = setTimeout(close, remaining);
114
+ };
115
+ const pause = () => {
116
+ if (persistent || closed) return;
117
+ clearTimeout(timer);
118
+ remaining = Math.max(800, remaining - (Date.now() - started));
119
+ };
120
+
121
+ el.addEventListener('pointerenter', pause);
122
+ el.addEventListener('pointerleave', start);
123
+ el.addEventListener('focusin', pause);
124
+ el.addEventListener('focusout', start);
125
+ el.addEventListener('click', (event) => {
126
+ if (event.target.closest('[data-toast-action]')) {
127
+ action?.onClick?.();
128
+ close();
129
+ } else if (event.target.closest('[data-toast-close]')) {
130
+ close();
131
+ }
132
+ });
133
+
134
+ requestAnimationFrame(() => requestAnimationFrame(() => el.setAttribute('data-open', '')));
135
+ start();
136
+
137
+ return { el, close, position };
138
+ }
139
+
140
+ /** Fecha todos os toasts visíveis, em todas as posições (útil ao sair de uma página). */
141
+ export function clearToasts() {
142
+ regions.forEach((region) => region.querySelectorAll('.ds-toast').forEach((el) => el.dsClose?.()));
143
+ }
144
+
145
+ /** Plano B para navegadores/contextos sem a API de clipboard. */
146
+ function legacyCopy(text) {
147
+ const area = document.createElement('textarea');
148
+ area.value = text;
149
+ area.setAttribute('readonly', '');
150
+ area.style.cssText = 'position:fixed;opacity:0;pointer-events:none';
151
+ document.body.append(area);
152
+ area.select();
153
+ let ok = false;
154
+ try {
155
+ ok = document.execCommand('copy');
156
+ } catch {}
157
+ area.remove();
158
+ return ok;
159
+ }
160
+
161
+ export async function copyText(text, label = msg('toast.copied'), { echo = true } = {}) {
162
+ let ok = false;
163
+ try {
164
+ await navigator.clipboard.writeText(text);
165
+ ok = true;
166
+ } catch {
167
+ ok = legacyCopy(text);
168
+ }
169
+ if (ok) toast(echo ? `${label}: ${text}` : label);
170
+ else toast(msg('toast.copyFailed'), { icon: 'alert-circle' });
171
+ }
@@ -0,0 +1,2 @@
1
+ // Gerado por scripts/build-react.mjs. Não edite.
2
+ export declare function createToolbar(root: HTMLElement, options?: Record<string, unknown>): { focus(): void; refresh(): void; destroy(): void };
package/js/toolbar.js ADDED
@@ -0,0 +1,107 @@
1
+ /**
2
+ * Barra de ferramentas — botões de ícone agrupados, com setas para andar entre eles.
3
+ *
4
+ * <div class="ds-toolbar" aria-label="Formatação">
5
+ * <div class="ds-toolbar__group">
6
+ * <button type="button" class="ds-icon-btn" aria-label="Negrito" aria-pressed="false" data-value="bold">…</button>
7
+ * </div>
8
+ * <div class="ds-toolbar__separator"></div>
9
+ * <div class="ds-toolbar__group" data-exclusive>…</div>
10
+ * </div>
11
+ *
12
+ * const toolbar = createToolbar(document.querySelector('.ds-toolbar'), {
13
+ * orientation: 'horizontal', // ou 'vertical'
14
+ * onToggle: (button, pressed) => {}, // botão com aria-pressed: troca sozinho e avisa
15
+ * });
16
+ * toolbar.focus(); toolbar.destroy();
17
+ *
18
+ * Padrão ARIA de toolbar: a barra toda é uma parada só do Tab (o último botão usado fica com ela);
19
+ * as setas andam entre os botões, Home e End vão às pontas, os desativados são pulados.
20
+ * Botão com aria-pressed vira liga e desliga; num grupo com data-exclusive, só um fica apertado
21
+ * (e clicar no apertado não solta, como o alinhamento de um editor).
22
+ */
23
+ const FOCUSABLE = 'button, [role="button"], a[href], input, select, [tabindex]';
24
+
25
+ export function createToolbar(root, options = {}) {
26
+ const o = { orientation: root.getAttribute('aria-orientation') || 'horizontal', onToggle: null, ...options };
27
+ const vertical = o.orientation === 'vertical';
28
+ root.setAttribute('role', 'toolbar');
29
+ if (vertical) root.setAttribute('aria-orientation', 'vertical');
30
+ else root.removeAttribute('aria-orientation');
31
+ root.querySelectorAll('.ds-toolbar__separator').forEach((sep) => {
32
+ sep.setAttribute('role', 'separator');
33
+ sep.setAttribute('aria-orientation', vertical ? 'horizontal' : 'vertical');
34
+ });
35
+
36
+ const items = () => [...root.querySelectorAll(FOCUSABLE)].filter((el) => !el.disabled && el.getAttribute('aria-disabled') !== 'true' && !el.closest('[hidden]') && el.closest('.ds-toolbar') === root);
37
+ let current = null;
38
+
39
+ // um só com tabindex 0: o que tinha antes, se ainda vale; senão, o primeiro
40
+ function roving(next) {
41
+ const list = items();
42
+ current = next && list.includes(next) ? next : list.includes(current) ? current : list[0] ?? null;
43
+ list.forEach((el) => (el.tabIndex = el === current ? 0 : -1));
44
+ }
45
+
46
+ function move(step, to) {
47
+ const list = items();
48
+ if (!list.length) return;
49
+ const i = list.indexOf(document.activeElement);
50
+ const next = to === 'first' ? list[0] : to === 'last' ? list.at(-1) : list[(i + step + list.length) % list.length];
51
+ roving(next);
52
+ next.focus();
53
+ }
54
+
55
+ const onKeyDown = (event) => {
56
+ if (!items().includes(event.target)) return;
57
+ // campo de texto dentro da barra: as setas laterais andam no texto, não na barra
58
+ if (event.target.matches('input, select') && !vertical) return;
59
+ const back = vertical ? 'ArrowUp' : 'ArrowLeft';
60
+ const forward = vertical ? 'ArrowDown' : 'ArrowRight';
61
+ const rtl = !vertical && getComputedStyle(root).direction === 'rtl' ? -1 : 1;
62
+ if (event.key === back) move(-1 * rtl);
63
+ else if (event.key === forward) move(1 * rtl);
64
+ else if (event.key === 'Home') move(0, 'first');
65
+ else if (event.key === 'End') move(0, 'last');
66
+ else return;
67
+ event.preventDefault();
68
+ };
69
+
70
+ const onFocusIn = (event) => {
71
+ if (items().includes(event.target)) roving(event.target);
72
+ };
73
+
74
+ const onClick = (event) => {
75
+ const button = event.target.closest('[aria-pressed]');
76
+ if (!button || !root.contains(button) || button.disabled) return;
77
+ const group = button.closest('[data-exclusive]');
78
+ const pressed = button.getAttribute('aria-pressed') === 'true';
79
+ if (group && root.contains(group)) {
80
+ if (pressed) return;
81
+ group.querySelectorAll('[aria-pressed="true"]').forEach((other) => {
82
+ other.setAttribute('aria-pressed', 'false');
83
+ o.onToggle?.(other, false);
84
+ });
85
+ }
86
+ button.setAttribute('aria-pressed', String(!pressed));
87
+ o.onToggle?.(button, !pressed);
88
+ };
89
+
90
+ roving();
91
+ root.addEventListener('keydown', onKeyDown);
92
+ root.addEventListener('focusin', onFocusIn);
93
+ root.addEventListener('click', onClick);
94
+
95
+ return {
96
+ /** Põe o foco no botão que está com a vez (depois de mudar a barra, chame refresh). */
97
+ focus: () => current?.focus(),
98
+ refresh: () => roving(),
99
+ destroy() {
100
+ root.removeEventListener('keydown', onKeyDown);
101
+ root.removeEventListener('focusin', onFocusIn);
102
+ root.removeEventListener('click', onClick);
103
+ items().forEach((el) => el.removeAttribute('tabindex'));
104
+ root.removeAttribute('role');
105
+ },
106
+ };
107
+ }
@@ -0,0 +1,2 @@
1
+ // Gerado por scripts/build-react.mjs. Não edite.
2
+ export declare function initTooltips(): void;
package/js/tooltip.js ADDED
@@ -0,0 +1,208 @@
1
+ /**
2
+ * Tooltip global por delegação.
3
+ *
4
+ * <button data-ds-tooltip="Recolher menu" data-ds-tooltip-placement="top|right|bottom|left" data-ds-tooltip-kbd="⌘B">
5
+ *
6
+ * Desative em uma região com data-ds-tooltips="off" num ancestral
7
+ * (o shell usa isso para só mostrar tooltips da sidebar quando ela está recolhida).
8
+ *
9
+ * WCAG 1.4.13 (conteúdo em hover ou foco):
10
+ * - dá para apontar o próprio tooltip sem que ele suma (ponte entre gatilho e balão + tolerância de saída);
11
+ * - Esc fecha sem mover o foco nem o ponteiro, e ele não volta até você sair do gatilho;
12
+ * - fica aberto enquanto o gatilho estiver em hover ou foco — nada de sumir sozinho.
13
+ */
14
+
15
+ const DELAY = 450;
16
+ const WARM_WINDOW = 400;
17
+ const GRACE = 160;
18
+ const GAP = 10;
19
+ const MARGIN = 8;
20
+
21
+ let tip;
22
+ let anchor = null;
23
+ let showTimer;
24
+ let hideTimer;
25
+ let coolTimer;
26
+ let warm = false;
27
+ let overAnchor = false;
28
+ let overTip = false;
29
+ let focusAnchor = false;
30
+ /** Gatilho fechado com Esc (ou clicado): não reabre até o ponteiro sair dele ou o foco ir para outro lugar. */
31
+ let dismissed = null;
32
+ let frame = 0;
33
+
34
+ function enabled(el) {
35
+ return el && !el.closest('[data-ds-tooltips="off"]');
36
+ }
37
+
38
+ function position(el) {
39
+ const placement = el.dataset.dsTooltipPlacement ?? 'top';
40
+ const r = el.getBoundingClientRect();
41
+ const t = tip.getBoundingClientRect();
42
+ let x;
43
+ let y;
44
+ if (placement === 'right') {
45
+ x = r.right + GAP;
46
+ y = r.top + r.height / 2 - t.height / 2;
47
+ } else if (placement === 'left') {
48
+ x = r.left - t.width - GAP;
49
+ y = r.top + r.height / 2 - t.height / 2;
50
+ } else if (placement === 'bottom') {
51
+ x = r.left + r.width / 2 - t.width / 2;
52
+ y = r.bottom + GAP;
53
+ } else {
54
+ x = r.left + r.width / 2 - t.width / 2;
55
+ y = r.top - t.height - GAP;
56
+ }
57
+ x = Math.min(Math.max(MARGIN, x), innerWidth - t.width - MARGIN);
58
+ y = Math.min(Math.max(MARGIN, y), innerHeight - t.height - MARGIN);
59
+ tip.dataset.placement = placement;
60
+ tip.style.transform = '';
61
+ tip.style.translate = `${Math.round(x)}px ${Math.round(y)}px`;
62
+ }
63
+
64
+ function show(el) {
65
+ clearTimeout(showTimer);
66
+ clearTimeout(hideTimer);
67
+ clearTimeout(coolTimer);
68
+ if (!el.isConnected) return;
69
+ anchor = el;
70
+ const kbd = el.dataset.dsTooltipKbd;
71
+ tip.textContent = el.dataset.dsTooltip;
72
+ if (kbd) {
73
+ const k = document.createElement('kbd');
74
+ k.className = 'ds-kbd';
75
+ k.textContent = kbd;
76
+ tip.append(k);
77
+ }
78
+ position(el);
79
+ tip.setAttribute('data-open', '');
80
+ warm = true;
81
+ }
82
+
83
+ function hide() {
84
+ clearTimeout(showTimer);
85
+ clearTimeout(hideTimer);
86
+ overAnchor = false;
87
+ overTip = false;
88
+ focusAnchor = false;
89
+ if (!anchor) return;
90
+ anchor = null;
91
+ tip.removeAttribute('data-open');
92
+ coolTimer = setTimeout(() => (warm = false), WARM_WINDOW);
93
+ }
94
+
95
+ /** Só fecha se nem o gatilho nem o balão estiverem em hover ou foco — com uma tolerância para cruzar o vão. */
96
+ function release() {
97
+ clearTimeout(hideTimer);
98
+ hideTimer = setTimeout(() => {
99
+ if (!anchor) return;
100
+ if (!anchor.isConnected || (!overAnchor && !overTip && !focusAnchor)) hide();
101
+ }, GRACE);
102
+ }
103
+
104
+ function schedule(el) {
105
+ clearTimeout(showTimer);
106
+ if (warm) show(el);
107
+ else showTimer = setTimeout(() => show(el), DELAY);
108
+ }
109
+
110
+ export function initTooltips() {
111
+ if (tip) return;
112
+ tip = document.createElement('div');
113
+ tip.className = 'ds-tooltip';
114
+ tip.setAttribute('role', 'tooltip');
115
+ tip.setAttribute('aria-hidden', 'true');
116
+ document.body.append(tip);
117
+
118
+ document.addEventListener('pointerover', (event) => {
119
+ if (event.pointerType === 'touch') return;
120
+ if (tip.contains(event.target)) {
121
+ if (anchor) {
122
+ overTip = true;
123
+ clearTimeout(hideTimer);
124
+ }
125
+ return;
126
+ }
127
+ const el = event.target.closest?.('[data-ds-tooltip]');
128
+ if (!enabled(el)) {
129
+ clearTimeout(showTimer);
130
+ if (anchor) {
131
+ overAnchor = false;
132
+ release();
133
+ }
134
+ return;
135
+ }
136
+ if (el === dismissed) return;
137
+ if (el === anchor) {
138
+ overAnchor = true;
139
+ clearTimeout(hideTimer);
140
+ return;
141
+ }
142
+ if (anchor) hide();
143
+ overAnchor = true;
144
+ schedule(el);
145
+ });
146
+
147
+ document.addEventListener('pointerout', (event) => {
148
+ const to = event.relatedTarget;
149
+ if (dismissed && dismissed.contains(event.target) && !dismissed.contains(to)) dismissed = null;
150
+ if (!anchor) {
151
+ if (!to || !event.target.closest?.('[data-ds-tooltip]')?.contains(to)) clearTimeout(showTimer);
152
+ return;
153
+ }
154
+ if (tip.contains(event.target) && !tip.contains(to)) {
155
+ overTip = false;
156
+ if (!anchor.contains(to)) release();
157
+ } else if (anchor.contains(event.target) && !anchor.contains(to)) {
158
+ overAnchor = false;
159
+ if (!tip.contains(to)) release();
160
+ }
161
+ });
162
+
163
+ document.addEventListener('focusin', (event) => {
164
+ const el = event.target.closest?.('[data-ds-tooltip]');
165
+ if (dismissed && dismissed !== el) dismissed = null;
166
+ if (!enabled(el) || el === dismissed || !el.matches(':focus-visible')) return;
167
+ if (anchor && anchor !== el) hide();
168
+ focusAnchor = true;
169
+ show(el);
170
+ });
171
+
172
+ document.addEventListener('focusout', (event) => {
173
+ if (dismissed?.contains(event.target) && !dismissed.matches(':hover')) dismissed = null;
174
+ if (!anchor || !anchor.contains(event.target)) return;
175
+ focusAnchor = false;
176
+ if (!overAnchor && !overTip) hide();
177
+ });
178
+
179
+ document.addEventListener('pointerdown', (event) => {
180
+ if (tip.contains(event.target)) return;
181
+ const el = event.target.closest?.('[data-ds-tooltip]');
182
+ if (el) dismissed = el;
183
+ hide();
184
+ });
185
+
186
+ // Rolar não fecha: o balão acompanha o gatilho e só some se o gatilho sair da tela.
187
+ document.addEventListener(
188
+ 'scroll',
189
+ () => {
190
+ if (!anchor) return;
191
+ cancelAnimationFrame(frame);
192
+ frame = requestAnimationFrame(() => {
193
+ if (!anchor) return;
194
+ const r = anchor.getBoundingClientRect();
195
+ if (!anchor.isConnected || r.bottom < 0 || r.top > innerHeight || r.right < 0 || r.left > innerWidth) hide();
196
+ else position(anchor);
197
+ });
198
+ },
199
+ true,
200
+ );
201
+ addEventListener('resize', hide);
202
+
203
+ document.addEventListener('keydown', (event) => {
204
+ if (event.key !== 'Escape' || !anchor) return;
205
+ dismissed = anchor;
206
+ hide();
207
+ });
208
+ }
package/js/tree.d.ts ADDED
@@ -0,0 +1,2 @@
1
+ // Gerado por scripts/build-react.mjs. Não edite.
2
+ export declare function createTree(root: HTMLElement, options?: Record<string, unknown>): { selected: string | null; select(id: string): void; expand(id: string): void; collapse(id: string): void; setItems(items: any[]): void; destroy(): void };
package/js/tree.js ADDED
@@ -0,0 +1,168 @@
1
+ /**
2
+ * Árvore — pastas e níveis aninhados, com teclado.
3
+ *
4
+ * <div class="ds-tree" id="arquivos" aria-label="Arquivos"></div>
5
+ *
6
+ * const tree = createTree(document.querySelector('#arquivos'), {
7
+ * items: [
8
+ * { id: 'src', label: 'src', icon: 'folder', children: [
9
+ * { id: 'app', label: 'app.js', icon: 'file-text' },
10
+ * ] },
11
+ * ],
12
+ * expanded: ['src'],
13
+ * selected: 'app',
14
+ * onSelect: (item) => abrir(item),
15
+ * onToggle: (item, open) => …,
16
+ * });
17
+ * tree.select('app'); tree.expand('src'); tree.collapse('src'); tree.setItems(lista); tree.destroy();
18
+ *
19
+ * Padrão ARIA: tree com treeitem. Teclado: ↑/↓ andam pelas linhas visíveis; → abre ou entra; ← fecha ou volta
20
+ * para o nível de cima; Home/End vão à primeira e à última; Enter ou Espaço escolhem; letras pulam para o item.
21
+ */
22
+ import { icon } from '../icons/icons.js';
23
+
24
+ const escape = (s) => String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/"/g, '&quot;');
25
+ const normalize = (s) => String(s).normalize('NFD').replace(/[̀-ͯ]/g, '').toLowerCase();
26
+
27
+ export function createTree(root, options = {}) {
28
+ const o = { items: [], ...options };
29
+ let items = o.items;
30
+ const expanded = new Set(o.expanded ?? []);
31
+ let selected = o.selected ?? null;
32
+ let active = null; // a linha que recebe o Tab
33
+
34
+ const byId = new Map();
35
+ const index = (list) => list.forEach((i) => {
36
+ byId.set(i.id, i);
37
+ if (i.children) index(i.children);
38
+ });
39
+
40
+ const node = (item, level) => {
41
+ const branch = Boolean(item.children?.length);
42
+ const open = expanded.has(item.id);
43
+ return `<li class="ds-tree__item" role="treeitem" data-id="${escape(item.id)}" aria-level="${level}" aria-selected="${item.id === selected}"${branch ? ` aria-expanded="${open}"` : ''}${item.disabled ? ' aria-disabled="true"' : ''} tabindex="-1">
44
+ <div class="ds-tree__row" style="--_level:${level - 1}">
45
+ <span class="ds-tree__toggle" aria-hidden="true">${branch ? icon('chevron-right', { size: 16 }) : ''}</span>
46
+ ${item.icon ? `<span class="ds-tree__icon" aria-hidden="true">${icon(item.icon, { size: 18 })}</span>` : ''}
47
+ <span class="ds-tree__label">${escape(item.label)}</span>
48
+ ${item.meta ? `<span class="ds-tree__meta">${escape(item.meta)}</span>` : ''}
49
+ </div>
50
+ ${branch ? `<ul class="ds-tree__group" role="group" ${open ? '' : 'hidden'}>${item.children.map((c) => node(c, level + 1)).join('')}</ul>` : ''}
51
+ </li>`;
52
+ };
53
+
54
+ function render() {
55
+ byId.clear();
56
+ index(items);
57
+ root.setAttribute('role', 'tree');
58
+ root.innerHTML = `<ul class="ds-tree__group" role="presentation">${items.map((i) => node(i, 1)).join('')}</ul>`;
59
+ setActive(selected && visibleEl(selected) ? selected : (items[0]?.id ?? null));
60
+ }
61
+
62
+ const elOf = (id) => root.querySelector(`[data-id="${CSS.escape(String(id))}"]`);
63
+ const visibleEl = (id) => {
64
+ const el = elOf(id);
65
+ return el && !el.parentElement.closest('ul[hidden]') ? el : null;
66
+ };
67
+ const visible = () => [...root.querySelectorAll('[role="treeitem"]')].filter((el) => !el.parentElement.closest('ul[hidden]'));
68
+
69
+ function setActive(id, focus = false) {
70
+ active = id;
71
+ root.querySelectorAll('[role="treeitem"]').forEach((el) => (el.tabIndex = el.dataset.id === String(id) ? 0 : -1));
72
+ if (focus) elOf(id)?.focus({ preventScroll: false });
73
+ }
74
+
75
+ function setOpen(id, open, { notify = true } = {}) {
76
+ const el = elOf(id);
77
+ if (!el || !el.hasAttribute('aria-expanded')) return;
78
+ if (open) expanded.add(id);
79
+ else expanded.delete(id);
80
+ el.setAttribute('aria-expanded', String(open));
81
+ el.querySelector(':scope > .ds-tree__group').hidden = !open;
82
+ // ao fechar uma pasta com o foco lá dentro, o foco volta para ela
83
+ if (!open && active !== id && el.querySelector(`[data-id="${CSS.escape(String(active))}"]`)) setActive(id, true);
84
+ if (notify) o.onToggle?.(byId.get(id), open);
85
+ }
86
+
87
+ function select(id, { notify = true } = {}) {
88
+ const item = byId.get(id);
89
+ if (!item || item.disabled) return;
90
+ selected = id;
91
+ root.querySelectorAll('[role="treeitem"]').forEach((el) => el.setAttribute('aria-selected', String(el.dataset.id === String(id))));
92
+ if (notify) o.onSelect?.(item);
93
+ }
94
+
95
+ const onClick = (event) => {
96
+ const el = event.target.closest('[role="treeitem"]');
97
+ if (!el) return;
98
+ const id = el.dataset.id;
99
+ setActive(id, true);
100
+ const onChevron = event.target.closest('.ds-tree__toggle');
101
+ if (el.hasAttribute('aria-expanded')) setOpen(id, el.getAttribute('aria-expanded') !== 'true');
102
+ if (!onChevron) select(id);
103
+ };
104
+
105
+ const onKey = (event) => {
106
+ const el = event.target.closest('[role="treeitem"]');
107
+ if (!el) return;
108
+ const list = visible();
109
+ const i = list.indexOf(el);
110
+ const id = el.dataset.id;
111
+ const go = (target) => {
112
+ event.preventDefault();
113
+ if (target) setActive(target.dataset.id, true);
114
+ };
115
+ switch (event.key) {
116
+ case 'ArrowDown': return go(list[i + 1]);
117
+ case 'ArrowUp': return go(list[i - 1]);
118
+ case 'Home': return go(list[0]);
119
+ case 'End': return go(list.at(-1));
120
+ case 'ArrowRight':
121
+ if (el.getAttribute('aria-expanded') === 'false') {
122
+ event.preventDefault();
123
+ setOpen(id, true);
124
+ } else if (el.getAttribute('aria-expanded') === 'true') go(list[i + 1]);
125
+ return;
126
+ case 'ArrowLeft':
127
+ if (el.getAttribute('aria-expanded') === 'true') {
128
+ event.preventDefault();
129
+ setOpen(id, false);
130
+ } else go(el.parentElement.closest('[role="treeitem"]'));
131
+ return;
132
+ case 'Enter':
133
+ case ' ':
134
+ event.preventDefault();
135
+ select(id);
136
+ return;
137
+ default:
138
+ if (event.key.length === 1 && /\S/.test(event.key) && !event.metaKey && !event.ctrlKey && !event.altKey) {
139
+ const ch = normalize(event.key);
140
+ const order = [...list.slice(i + 1), ...list.slice(0, i + 1)];
141
+ const match = order.find((n) => normalize(n.querySelector('.ds-tree__label').textContent).startsWith(ch));
142
+ if (match) go(match);
143
+ }
144
+ }
145
+ };
146
+
147
+ root.addEventListener('click', onClick);
148
+ root.addEventListener('keydown', onKey);
149
+ render();
150
+
151
+ return {
152
+ get selected() {
153
+ return selected;
154
+ },
155
+ select,
156
+ expand: (id) => setOpen(id, true),
157
+ collapse: (id) => setOpen(id, false),
158
+ setItems(next) {
159
+ items = next;
160
+ render();
161
+ },
162
+ destroy() {
163
+ root.removeEventListener('click', onClick);
164
+ root.removeEventListener('keydown', onKey);
165
+ root.innerHTML = '';
166
+ },
167
+ };
168
+ }