@joniguerini/lume 0.0.0-stage → 1.9.1

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
@@ -0,0 +1,107 @@
1
+ /**
2
+ * Código de verificação — um dígito por casa, para login em duas etapas.
3
+ *
4
+ * <div class="ds-otp"><input class="ds-otp__input" id="codigo" name="codigo" aria-label="Código de verificação"></div>
5
+ *
6
+ * const otp = createOtpField(document.querySelector('.ds-otp'), {
7
+ * length: 6,
8
+ * group: 3, // separa em grupos de 3 (opcional)
9
+ * alphanumeric: false, // aceita letras também
10
+ * onComplete: (code) => verificar(code),
11
+ * });
12
+ * otp.value; otp.clear(); otp.setError(true); otp.destroy();
13
+ *
14
+ * Por baixo é um único <input> com autocomplete="one-time-code": o preenchimento automático do celular, colar e
15
+ * o leitor de tela funcionam como num campo comum. As casas são só o desenho, e ficam escondidas do leitor de tela.
16
+ */
17
+ export function createOtpField(root, options = {}) {
18
+ const o = { length: 6, ...options };
19
+ const input = root.querySelector('.ds-otp__input');
20
+ const allowed = o.alphanumeric ? /[^0-9a-z]/gi : /\D/g;
21
+
22
+ input.type = 'text';
23
+ input.maxLength = o.length;
24
+ input.autocomplete = 'one-time-code';
25
+ input.inputMode = o.alphanumeric ? 'text' : 'numeric';
26
+ input.autocapitalize = o.alphanumeric ? 'characters' : 'off';
27
+ input.spellcheck = false;
28
+ input.pattern = o.alphanumeric ? `[0-9A-Za-z]{${o.length}}` : `\\d{${o.length}}`;
29
+
30
+ const boxes = document.createElement('div');
31
+ boxes.className = 'ds-otp__boxes';
32
+ boxes.setAttribute('aria-hidden', 'true');
33
+ boxes.innerHTML = Array.from({ length: o.length }, (_, i) => `${o.group && i && i % o.group === 0 ? '<span class="ds-otp__gap"></span>' : ''}<span class="ds-otp__box" data-box="${i}"></span>`).join('');
34
+ input.after(boxes);
35
+ const cells = [...boxes.querySelectorAll('[data-box]')];
36
+
37
+ let completed = '';
38
+
39
+ function paint() {
40
+ const v = input.value;
41
+ const focused = document.activeElement === input;
42
+ const at = Math.min(input.selectionStart ?? v.length, o.length - 1);
43
+ cells.forEach((cell, i) => {
44
+ cell.textContent = v[i] ?? '';
45
+ cell.toggleAttribute('data-filled', i < v.length);
46
+ cell.toggleAttribute('data-active', focused && i === at);
47
+ });
48
+ }
49
+
50
+ const onInput = () => {
51
+ const clean = input.value.replace(allowed, '').slice(0, o.length);
52
+ const value = o.alphanumeric ? clean.toUpperCase() : clean;
53
+ if (value !== input.value) input.value = value;
54
+ root.removeAttribute('data-error');
55
+ if (input.getAttribute('aria-invalid') === 'true' && !input.form) input.removeAttribute('aria-invalid');
56
+ paint();
57
+ if (value.length === o.length && value !== completed) {
58
+ completed = value;
59
+ o.onComplete?.(value);
60
+ } else if (value.length < o.length) completed = '';
61
+ };
62
+ const onSelection = () => {
63
+ if (document.activeElement === input) paint();
64
+ };
65
+ const onFocus = () => {
66
+ // abre com o cursor no fim, onde a próxima tecla entra
67
+ const end = input.value.length;
68
+ input.setSelectionRange(end, end);
69
+ paint();
70
+ };
71
+
72
+ input.addEventListener('input', onInput);
73
+ input.addEventListener('focus', onFocus);
74
+ input.addEventListener('blur', paint);
75
+ document.addEventListener('selectionchange', onSelection);
76
+ paint();
77
+
78
+ return {
79
+ get value() {
80
+ return input.value;
81
+ },
82
+ setValue(next) {
83
+ input.value = next;
84
+ onInput();
85
+ },
86
+ clear() {
87
+ input.value = '';
88
+ completed = '';
89
+ root.removeAttribute('data-error');
90
+ input.removeAttribute('aria-invalid');
91
+ paint();
92
+ },
93
+ setError(on = true) {
94
+ root.toggleAttribute('data-error', on);
95
+ if (on) input.setAttribute('aria-invalid', 'true');
96
+ else input.removeAttribute('aria-invalid');
97
+ },
98
+ focus: () => input.focus(),
99
+ destroy() {
100
+ boxes.remove();
101
+ input.removeEventListener('input', onInput);
102
+ input.removeEventListener('focus', onFocus);
103
+ input.removeEventListener('blur', paint);
104
+ document.removeEventListener('selectionchange', onSelection);
105
+ },
106
+ };
107
+ }
@@ -0,0 +1,3 @@
1
+ // Gerado por scripts/build-react.mjs. Não edite.
2
+ export declare function createPagination(root: HTMLElement, options?: Record<string, unknown>): { page: number; pageSize: number; setPage(page: number): void; setTotal(total: number): void; destroy(): void };
3
+ export declare function pageRange(page: number, pages: number, siblings?: number): Array<number | string>;
@@ -0,0 +1,143 @@
1
+ /**
2
+ * Paginação — páginas de uma lista ou tabela, com total e itens por página.
3
+ *
4
+ * <nav class="ds-pagination" id="pedidos-paginas"></nav>
5
+ *
6
+ * const pagination = createPagination(document.querySelector('#pedidos-paginas'), {
7
+ * total: 248,
8
+ * page: 1,
9
+ * pageSize: 10,
10
+ * pageSizes: [10, 25, 50], // mostra o seletor de itens por página (opcional)
11
+ * siblings: 1, // páginas de cada lado da atual
12
+ * hrefFor: (page) => `?pagina=${page}`, // vira links de verdade (opcional)
13
+ * onChange: ({ page, pageSize }) => carregar(page, pageSize),
14
+ * });
15
+ * pagination.setPage(3); pagination.setTotal(100); pagination.destroy();
16
+ *
17
+ * Em telas estreitas, os números dão lugar a “3 de 25”, entre as setas.
18
+ * Acessibilidade: <nav> com nome, aria-current="page" na página atual e o intervalo anunciado em role="status".
19
+ */
20
+ import { icon } from '../icons/icons.js';
21
+ import { msg, numberFormat } from './i18n.js';
22
+ import { createMenu } from './menu.js';
23
+
24
+ const escape = (s) => String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/"/g, '&quot;');
25
+
26
+ /**
27
+ * Lista de páginas com reticências: [1, '…', 4, 5, 6, '…', 25]. O número de posições é sempre o mesmo,
28
+ * para os botões não mudarem de lugar; quando todas as páginas cabem nessas posições, não há reticências.
29
+ */
30
+ export function pageRange(page, pages, siblings = 1) {
31
+ const slots = siblings * 2 + 5;
32
+ const seq = (from, to) => Array.from({ length: to - from + 1 }, (_, i) => from + i);
33
+ if (pages <= slots) return seq(1, pages);
34
+ if (page <= siblings + 3) return [...seq(1, slots - 2), '…', pages];
35
+ if (page >= pages - siblings - 2) return [1, '…', ...seq(pages - slots + 3, pages)];
36
+ return [1, '…', ...seq(page - siblings, page + siblings), '…', pages];
37
+ }
38
+
39
+ export function createPagination(root, options = {}) {
40
+ const o = { total: 0, page: 1, pageSize: 10, siblings: 1, ...options };
41
+ let total = o.total;
42
+ let page = o.page;
43
+ let pageSize = o.pageSize;
44
+ let sizeMenu = null;
45
+
46
+ const n = (v) => numberFormat().format(v);
47
+ const pages = () => Math.max(1, Math.ceil(total / pageSize));
48
+
49
+ const emit = () => o.onChange?.({ page, pageSize });
50
+
51
+ function control(target, inner, { label, disabled, current, cls = 'ds-pagination__page' }) {
52
+ const attrs = `class="${cls}" aria-label="${escape(label)}"${current ? ' aria-current="page"' : ''}`;
53
+ if (o.hrefFor && !disabled) return `<a ${attrs} href="${escape(o.hrefFor(target))}" data-page="${target}">${inner}</a>`;
54
+ return `<button type="button" ${attrs} data-page="${target}"${disabled ? ' disabled' : ''}>${inner}</button>`;
55
+ }
56
+
57
+ function render({ focus } = {}) {
58
+ page = Math.min(Math.max(1, page), pages());
59
+ const first = total ? (page - 1) * pageSize + 1 : 0;
60
+ const last = Math.min(page * pageSize, total);
61
+ root.setAttribute('aria-label', o.label ?? msg('pagination.label'));
62
+ const sizes = o.pageSizes?.length
63
+ ? `<button type="button" class="ds-chip ds-chip--sm ds-pagination__size" data-size><span data-label>${escape(msg('pagination.perPage', pageSize))}</span><span class="ds-chip__chevron">${icon('chevron-down', { size: 14 })}</span></button>`
64
+ : '';
65
+ root.innerHTML = `
66
+ <p class="ds-pagination__summary" role="status">${escape(msg('pagination.range', n(first), n(last), n(total)))}</p>
67
+ ${sizes}
68
+ <ul class="ds-pagination__list" role="list">
69
+ <li>${control(page - 1, icon('chevron-left', { size: 18 }), { label: msg('pagination.prev'), disabled: page <= 1, cls: 'ds-pagination__page ds-pagination__arrow' })}</li>
70
+ ${pageRange(page, pages(), o.siblings)
71
+ .map((p) => (p === '…' ? '<li class="ds-pagination__gap" aria-hidden="true">…</li>' : `<li class="ds-pagination__number">${control(p, n(p), { label: msg('pagination.page', n(p)), current: p === page })}</li>`))
72
+ .join('')}
73
+ <li class="ds-pagination__compact" aria-hidden="true">${escape(msg('pagination.compact', n(page), n(pages())))}</li>
74
+ <li>${control(page + 1, icon('chevron-right', { size: 18 }), { label: msg('pagination.next'), disabled: page >= pages(), cls: 'ds-pagination__page ds-pagination__arrow' })}</li>
75
+ </ul>`;
76
+ bindSize();
77
+ if (focus) (root.querySelector(`.ds-pagination__arrow[data-page="${focus}"]:not(:disabled)`) ?? root.querySelector('[aria-current="page"]'))?.focus({ preventScroll: true });
78
+ }
79
+
80
+ function bindSize() {
81
+ sizeMenu?.destroy();
82
+ sizeMenu = null;
83
+ const chip = root.querySelector('[data-size]');
84
+ if (!chip) return;
85
+ sizeMenu = createMenu(chip, {
86
+ label: msg('pagination.pageSize'),
87
+ value: String(pageSize),
88
+ options: o.pageSizes.map((v) => ({ value: String(v), label: msg('pagination.perPage', v) })),
89
+ onChange: (value) => {
90
+ // mantém à vista o primeiro item que a pessoa estava vendo
91
+ const firstItem = (page - 1) * pageSize;
92
+ pageSize = Number(value);
93
+ page = Math.floor(firstItem / pageSize) + 1;
94
+ render();
95
+ root.querySelector('[data-size]')?.focus({ preventScroll: true });
96
+ emit();
97
+ },
98
+ });
99
+ }
100
+
101
+ const onClick = (event) => {
102
+ const target = event.target.closest('[data-page]');
103
+ if (!target || target.disabled) return;
104
+ const next = Number(target.dataset.page);
105
+ if (next === page) return;
106
+ if (!o.hrefFor) event.preventDefault();
107
+ const arrow = target.classList.contains('ds-pagination__arrow') ? target.dataset.page > page ? 'next' : 'prev' : null;
108
+ page = next;
109
+ render();
110
+ // setas seguem na seta (para avançar várias vezes); sem seta disponível, o foco vai para a página atual
111
+ const focusEl = arrow ? root.querySelectorAll('.ds-pagination__arrow')[arrow === 'next' ? 1 : 0] : null;
112
+ (focusEl && !focusEl.disabled ? focusEl : root.querySelector('[aria-current="page"]'))?.focus({ preventScroll: true });
113
+ emit();
114
+ };
115
+ const onLocale = () => render();
116
+
117
+ root.addEventListener('click', onClick);
118
+ document.documentElement.addEventListener('ds:localechange', onLocale);
119
+ render();
120
+
121
+ return {
122
+ get page() {
123
+ return page;
124
+ },
125
+ get pageSize() {
126
+ return pageSize;
127
+ },
128
+ setPage(next) {
129
+ page = next;
130
+ render();
131
+ },
132
+ setTotal(next) {
133
+ total = next;
134
+ render();
135
+ },
136
+ destroy() {
137
+ sizeMenu?.destroy();
138
+ root.removeEventListener('click', onClick);
139
+ document.documentElement.removeEventListener('ds:localechange', onLocale);
140
+ root.innerHTML = '';
141
+ },
142
+ };
143
+ }
@@ -0,0 +1,2 @@
1
+ // Gerado por scripts/build-react.mjs. Não edite.
2
+ export declare function createPopover(trigger: HTMLElement, options?: Record<string, unknown>): { el: HTMLElement; readonly isOpen: boolean; open(): void; close(returnFocus?: boolean): void; toggle(): void; reposition(): void; destroy(): void };
package/js/popover.js ADDED
@@ -0,0 +1,155 @@
1
+ /**
2
+ * Popover — conteúdo livre que abre ao clicar, preso ao gatilho, sem bloquear a tela.
3
+ *
4
+ * const popover = createPopover(botao, {
5
+ * title: 'Compartilhar', // opcional: dá nome e mostra o botão de fechar
6
+ * content: 'Texto ou HTML', // ou um Element
7
+ * placement: 'bottom', // 'bottom' | 'top' | 'right' | 'left'; troca de lado se não couber
8
+ * align: 'start', // 'start' | 'center' | 'end'
9
+ * label: 'Compartilhar', // nome para o leitor de tela, quando não há título
10
+ * onOpen: (panel) => …, onClose: () => …,
11
+ * });
12
+ * popover.open(); popover.close(); popover.toggle(); popover.reposition(); popover.destroy();
13
+ *
14
+ * Padrão ARIA: gatilho com aria-haspopup="dialog" e aria-expanded; painel com role="dialog", não modal.
15
+ * Abrir leva o foco para dentro. Esc fecha e devolve o foco; clicar fora ou sair com Tab fecha sem puxar o foco.
16
+ * Use o Tooltip para uma dica curta, o Menu para uma lista de ações e o Modal quando for preciso interromper.
17
+ */
18
+ import { icon } from '../icons/icons.js';
19
+ import { msg } from './i18n.js';
20
+ import { panelHost, inheritTheme } from './field-support.js';
21
+
22
+ let uid = 0;
23
+ const GAP = 8;
24
+ const MARGIN = 8;
25
+ const FOCUSABLE = 'a[href], button:not(:disabled), input:not(:disabled), select:not(:disabled), textarea:not(:disabled), [tabindex]:not([tabindex="-1"])';
26
+ const escape = (s) => String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/"/g, '&quot;');
27
+
28
+ /** Calcula a posição: troca de lado se não couber e nunca sai da tela. */
29
+ function place(panel, trigger, placement, align) {
30
+ const t = trigger.getBoundingClientRect();
31
+ const p = panel.getBoundingClientRect();
32
+ const room = { bottom: innerHeight - t.bottom, top: t.top, right: innerWidth - t.right, left: t.left };
33
+ const opposite = { bottom: 'top', top: 'bottom', right: 'left', left: 'right' };
34
+ const vertical = (s) => s === 'bottom' || s === 'top';
35
+ const need = (s) => (vertical(s) ? p.height : p.width) + GAP + MARGIN;
36
+ const side = room[placement] >= need(placement) || room[placement] >= room[opposite[placement]] ? placement : opposite[placement];
37
+ let x;
38
+ let y;
39
+ if (vertical(side)) {
40
+ y = side === 'bottom' ? t.bottom + GAP : t.top - p.height - GAP;
41
+ x = align === 'center' ? t.left + (t.width - p.width) / 2 : align === 'end' ? t.right - p.width : t.left;
42
+ } else {
43
+ x = side === 'right' ? t.right + GAP : t.left - p.width - GAP;
44
+ y = align === 'center' ? t.top + (t.height - p.height) / 2 : align === 'end' ? t.bottom - p.height : t.top;
45
+ }
46
+ x = Math.min(Math.max(MARGIN, x), innerWidth - p.width - MARGIN);
47
+ y = Math.min(Math.max(MARGIN, y), innerHeight - p.height - MARGIN);
48
+ panel.style.translate = `${Math.round(x)}px ${Math.round(y)}px`;
49
+ panel.dataset.side = side;
50
+ }
51
+
52
+ export function createPopover(trigger, options = {}) {
53
+ const o = { placement: 'bottom', align: 'start', ...options };
54
+ const id = `ds-popover-${++uid}`;
55
+
56
+ const panel = document.createElement('div');
57
+ panel.className = `ds-popover${o.className ? ` ${o.className}` : ''}`;
58
+ panel.id = id;
59
+ panel.tabIndex = -1;
60
+ panel.setAttribute('role', 'dialog');
61
+ if (o.title) panel.setAttribute('aria-labelledby', `${id}-title`);
62
+ else if (o.label) panel.setAttribute('aria-label', o.label);
63
+
64
+ const fill = () => {
65
+ panel.innerHTML = `${o.title ? `<header class="ds-popover__header"><h2 class="ds-popover__title" id="${id}-title">${escape(o.title)}</h2><button type="button" class="ds-icon-btn ds-icon-btn--sm ds-icon-btn--muted" data-popover-close aria-label="${escape(msg('common.close'))}">${icon('x', { size: 16 })}</button></header>` : ''}<div class="ds-popover__body"></div>`;
66
+ const body = panel.querySelector('.ds-popover__body');
67
+ if (o.content instanceof Element) body.append(o.content);
68
+ else body.innerHTML = o.content ?? '';
69
+ };
70
+ fill();
71
+
72
+ trigger.setAttribute('aria-haspopup', 'dialog');
73
+ trigger.setAttribute('aria-expanded', 'false');
74
+ trigger.setAttribute('aria-controls', id);
75
+
76
+ const isOpen = () => panel.hasAttribute('data-open');
77
+ const reposition = () => isOpen() && place(panel, trigger, o.placement, o.align);
78
+
79
+ function open() {
80
+ if (isOpen() || trigger.disabled) return;
81
+ inheritTheme(panel, trigger);
82
+ panelHost(trigger).append(panel);
83
+ place(panel, trigger, o.placement, o.align);
84
+ panel.setAttribute('data-open', '');
85
+ trigger.setAttribute('aria-expanded', 'true');
86
+ (panel.querySelector(`.ds-popover__body :is(${FOCUSABLE})`) ?? panel).focus({ preventScroll: true });
87
+ document.addEventListener('pointerdown', onOutside);
88
+ document.addEventListener('scroll', onScroll, true);
89
+ addEventListener('resize', reposition);
90
+ o.onOpen?.(panel);
91
+ }
92
+
93
+ function close(returnFocus = true) {
94
+ if (!isOpen()) return;
95
+ panel.removeAttribute('data-open');
96
+ panel.remove();
97
+ trigger.setAttribute('aria-expanded', 'false');
98
+ document.removeEventListener('pointerdown', onOutside);
99
+ document.removeEventListener('scroll', onScroll, true);
100
+ removeEventListener('resize', reposition);
101
+ if (returnFocus) trigger.focus({ preventScroll: true });
102
+ o.onClose?.();
103
+ }
104
+
105
+ const toggle = () => (isOpen() ? close() : open());
106
+ const onOutside = (event) => {
107
+ if (!panel.contains(event.target) && !trigger.contains(event.target)) close(false);
108
+ };
109
+ const onScroll = (event) => {
110
+ if (panel.contains(event.target)) return;
111
+ if (trigger.isConnected) reposition();
112
+ else close(false);
113
+ };
114
+ const onKey = (event) => {
115
+ if (event.key !== 'Escape') return;
116
+ event.preventDefault();
117
+ event.stopPropagation();
118
+ close();
119
+ };
120
+ const onFocusOut = (event) => {
121
+ const to = event.relatedTarget;
122
+ if (to && !panel.contains(to) && !trigger.contains(to)) close(false);
123
+ };
124
+ const onPanelClick = (event) => {
125
+ if (event.target.closest('[data-popover-close]')) close();
126
+ };
127
+ const onLocale = () => {
128
+ if (o.title) panel.querySelector('[data-popover-close]')?.setAttribute('aria-label', msg('common.close'));
129
+ };
130
+
131
+ trigger.addEventListener('click', toggle);
132
+ panel.addEventListener('keydown', onKey);
133
+ panel.addEventListener('focusout', onFocusOut);
134
+ panel.addEventListener('click', onPanelClick);
135
+ document.documentElement.addEventListener('ds:localechange', onLocale);
136
+
137
+ return {
138
+ el: panel,
139
+ get isOpen() {
140
+ return isOpen();
141
+ },
142
+ open,
143
+ close,
144
+ toggle,
145
+ reposition,
146
+ destroy() {
147
+ close(false);
148
+ trigger.removeEventListener('click', toggle);
149
+ document.documentElement.removeEventListener('ds:localechange', onLocale);
150
+ trigger.removeAttribute('aria-haspopup');
151
+ trigger.removeAttribute('aria-expanded');
152
+ trigger.removeAttribute('aria-controls');
153
+ },
154
+ };
155
+ }
@@ -0,0 +1,48 @@
1
+ /**
2
+ * Progresso circular — o anel da barra de progresso, para quando a barra não cabe (card, botão, lista).
3
+ *
4
+ * el.innerHTML = progressRingHtml(62, { label: 'Enviando', size: 'lg', tone: 'success' });
5
+ * setProgressRing(el.firstElementChild, 80); // muda o valor (null = indeterminado)
6
+ *
7
+ * value: de 0 a max (padrão 100); sem valor (null ou undefined), o arco gira: indeterminado.
8
+ * size: 'sm' (20 px, sem número, cabe numa linha de texto) · 'md' (56) · 'lg' (80).
9
+ * tone: 'success' · 'warning' · 'danger' — para o resultado, como na barra.
10
+ * label: o que está progredindo, para o leitor de tela. Padrão: “Progresso”, no idioma do Lume.
11
+ *
12
+ * É role="progressbar" com aria-valuenow; o número no meio é só visual (o leitor de tela lê o valor).
13
+ */
14
+ import { msg, numberFormat } from './i18n.js';
15
+
16
+ const pct = (value, max) => numberFormat({ style: 'percent', maximumFractionDigits: 0 }).format(value / max);
17
+ const clamp = (value, max) => Math.max(0, Math.min(max, Number(value) || 0));
18
+ const escape = (s) => String(s).replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' })[c]);
19
+
20
+ export function progressRingHtml(value, { max = 100, size = 'md', tone = '', label, text = true } = {}) {
21
+ const on = value !== null && value !== undefined;
22
+ const v = on ? clamp(value, max) : 0;
23
+ const cls = ['ds-progress-ring', size !== 'md' && `ds-progress-ring--${size}`, tone && tone !== 'brand' && `ds-progress-ring--${tone}`].filter(Boolean).join(' ');
24
+ const aria = on ? ` aria-valuemin="0" aria-valuemax="${max}" aria-valuenow="${v}" style="--ds-progress-value: ${(v / max) * 100}"` : '';
25
+ const number = on && text && size !== 'sm' ? `<span class="ds-progress-ring__value" aria-hidden="true">${pct(v, max)}</span>` : '';
26
+ return `<div class="${cls}" role="progressbar" aria-label="${escape(label ?? msg('progress.label'))}"${aria}><svg viewBox="0 0 40 40" aria-hidden="true" focusable="false"><circle class="ds-progress-ring__track" cx="20" cy="20" r="18"/><circle class="ds-progress-ring__bar" cx="20" cy="20" r="18" pathLength="100"/></svg>${number}</div>`;
27
+ }
28
+
29
+ /** Muda o valor de um anel já desenhado. null ou undefined: indeterminado. */
30
+ export function setProgressRing(el, value) {
31
+ const max = Number(el.getAttribute('aria-valuemax')) || 100;
32
+ const out = el.querySelector('.ds-progress-ring__value');
33
+ if (value === null || value === undefined) {
34
+ ['aria-valuemin', 'aria-valuemax', 'aria-valuenow'].forEach((name) => el.removeAttribute(name));
35
+ el.style.removeProperty('--ds-progress-value');
36
+ if (out) out.hidden = true;
37
+ return;
38
+ }
39
+ const v = clamp(value, max);
40
+ el.setAttribute('aria-valuemin', '0');
41
+ el.setAttribute('aria-valuemax', String(max));
42
+ el.setAttribute('aria-valuenow', String(v));
43
+ el.style.setProperty('--ds-progress-value', String((v / max) * 100));
44
+ if (out) {
45
+ out.hidden = false;
46
+ out.textContent = pct(v, max);
47
+ }
48
+ }
package/js/rating.d.ts ADDED
@@ -0,0 +1,3 @@
1
+ // Gerado por scripts/build-react.mjs. Não edite.
2
+ export declare function createRating(root: HTMLElement, options?: Record<string, unknown>): { value: number; setValue(value: number): void; destroy(): void };
3
+ export declare function ratingHtml(value: number, options?: Record<string, unknown>): string;
package/js/rating.js ADDED
@@ -0,0 +1,130 @@
1
+ /**
2
+ * Avaliação — estrelas para dar nota ou só mostrar a média.
3
+ *
4
+ * Para dar nota:
5
+ * <div class="ds-rating" aria-label="Sua nota"></div>
6
+ * const rating = createRating(document.querySelector('.ds-rating'), {
7
+ * name: 'nota', // o formulário envia o valor (1 a max) com este nome
8
+ * value: 0, // 0 = sem nota
9
+ * max: 5,
10
+ * clearable: true, // clicar de novo na estrela marcada tira a nota
11
+ * onChange: (value) => {},
12
+ * });
13
+ * rating.value; rating.setValue(4); rating.destroy();
14
+ *
15
+ * Só para mostrar (aceita meia estrela e qualquer decimal):
16
+ * el.innerHTML = ratingHtml(4.5, { max: 5, size: 'sm', text: true, count: 128 });
17
+ *
18
+ * Cada estrela é um rádio nativo dentro de um radiogroup: Tab entra, as setas trocam a nota, o formulário
19
+ * envia o valor e required funciona sem código. O nome de cada uma é “3 estrelas”.
20
+ */
21
+ import { msg, formatNumber } from './i18n.js';
22
+
23
+ const STAR = 'M12 3.5l2.6 5.3 5.9.9-4.3 4.1 1 5.8-5.2-2.7-5.2 2.7 1-5.8-4.3-4.1 5.9-.9z';
24
+ const svg = () => `<svg viewBox="0 0 24 24" fill="currentColor" stroke="currentColor" stroke-width="1.5" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="${STAR}"/></svg>`;
25
+ const starIcon = (fill) => `<span class="ds-rating__icon" aria-hidden="true">${svg()}<span class="ds-rating__fill"${fill === undefined ? '' : ` style="--_fill: ${fill}%"`}>${svg()}</span></span>`;
26
+
27
+ let uid = 0;
28
+
29
+ /** Marcação só de leitura: ratingHtml(4.5, { max, size: 'sm' | 'lg', label, text, count }). */
30
+ export function ratingHtml(value, { max = 5, size = '', label, text = false, count } = {}) {
31
+ const v = Math.max(0, Math.min(max, Number(value) || 0));
32
+ const name = label ?? msg('rating.value', formatNumber(v, { maximumFractionDigits: 1 }), max);
33
+ const stars = Array.from({ length: max }, (_, i) => `<span class="ds-rating__star">${starIcon(Math.round(Math.max(0, Math.min(1, v - i)) * 100))}</span>`).join('');
34
+ const number = text ? `<span class="ds-rating__text" aria-hidden="true">${formatNumber(v, { minimumFractionDigits: 1, maximumFractionDigits: 1 })}${count != null ? ` <span class="ds-rating__count">(${formatNumber(count)})</span>` : ''}</span>` : '';
35
+ return `<span class="ds-rating ds-rating--readonly${size ? ` ds-rating--${size}` : ''}" role="img" aria-label="${name}">${stars}${number}</span>`;
36
+ }
37
+
38
+ export function createRating(root, options = {}) {
39
+ const o = { name: root.dataset.name || `ds-rating-${++uid}`, value: Number(root.dataset.value) || 0, max: Number(root.dataset.max) || 5, clearable: true, disabled: false, required: false, onChange: null, ...options };
40
+ let value = Math.max(0, Math.min(o.max, Math.round(o.value)));
41
+ let before = value;
42
+
43
+ root.classList.add('ds-rating');
44
+ root.setAttribute('role', 'radiogroup');
45
+ if (o.disabled) root.setAttribute('aria-disabled', 'true');
46
+
47
+ function render() {
48
+ root.innerHTML = Array.from(
49
+ { length: o.max },
50
+ (_, i) => `<label class="ds-rating__star"${i < value ? ' data-on' : ''}>
51
+ <input class="ds-rating__input" type="radio" name="${o.name}" value="${i + 1}"${i + 1 === value ? ' checked' : ''}${o.disabled ? ' disabled' : ''}${o.required && i === 0 ? ' required' : ''}>
52
+ ${starIcon()}
53
+ <span class="ds-visually-hidden">${msg('rating.star', i + 1)}</span>
54
+ </label>`,
55
+ ).join('');
56
+ }
57
+
58
+ const stars = () => [...root.querySelectorAll('.ds-rating__star')];
59
+ function paint() {
60
+ stars().forEach((star, i) => star.toggleAttribute('data-on', i < value));
61
+ }
62
+
63
+ function set(next, notify) {
64
+ value = Math.max(0, Math.min(o.max, Math.round(next)));
65
+ root.querySelectorAll('.ds-rating__input').forEach((input) => (input.checked = Number(input.value) === value));
66
+ paint();
67
+ if (notify) o.onChange?.(value);
68
+ }
69
+
70
+ // antes do clique: guarda a nota, para saber se a pessoa clicou de novo na mesma (e tirar a nota).
71
+ // Pelo teclado (setas e espaço também disparam clique no rádio) nunca tira.
72
+ let keyboard = false;
73
+ const onPointerDown = () => {
74
+ keyboard = false;
75
+ before = value;
76
+ };
77
+ const onKeyDown = () => (keyboard = true);
78
+ const onChange = (event) => {
79
+ if (!event.target.classList.contains('ds-rating__input')) return;
80
+ set(Number(event.target.value), true);
81
+ };
82
+ const onClick = (event) => {
83
+ const input = event.target.closest('.ds-rating__input');
84
+ if (!input || !o.clearable || keyboard) return;
85
+ if (Number(input.value) === before && before === value) set(0, true);
86
+ before = value;
87
+ };
88
+ const onOver = (event) => {
89
+ const star = event.target.closest('.ds-rating__star');
90
+ if (!star) return;
91
+ const n = stars().indexOf(star);
92
+ root.setAttribute('data-preview', '');
93
+ stars().forEach((s, i) => s.toggleAttribute('data-preview-on', i <= n));
94
+ };
95
+ const onLeave = () => {
96
+ root.removeAttribute('data-preview');
97
+ stars().forEach((s) => s.removeAttribute('data-preview-on'));
98
+ };
99
+ const onLocale = () => {
100
+ root.querySelectorAll('.ds-rating__star .ds-visually-hidden').forEach((el, i) => (el.textContent = msg('rating.star', i + 1)));
101
+ };
102
+
103
+ render();
104
+ root.addEventListener('pointerdown', onPointerDown);
105
+ root.addEventListener('keydown', onKeyDown);
106
+ root.addEventListener('change', onChange);
107
+ root.addEventListener('click', onClick);
108
+ root.addEventListener('pointerover', onOver);
109
+ root.addEventListener('pointerleave', onLeave);
110
+ document.documentElement.addEventListener('ds:localechange', onLocale);
111
+
112
+ return {
113
+ get value() {
114
+ return value;
115
+ },
116
+ setValue: (next) => set(Number(next) || 0, false),
117
+ destroy() {
118
+ root.removeEventListener('pointerdown', onPointerDown);
119
+ root.removeEventListener('keydown', onKeyDown);
120
+ root.removeEventListener('change', onChange);
121
+ root.removeEventListener('click', onClick);
122
+ root.removeEventListener('pointerover', onOver);
123
+ root.removeEventListener('pointerleave', onLeave);
124
+ document.documentElement.removeEventListener('ds:localechange', onLocale);
125
+ root.innerHTML = '';
126
+ root.removeAttribute('role');
127
+ root.removeAttribute('data-preview');
128
+ },
129
+ };
130
+ }
@@ -0,0 +1,2 @@
1
+ // Gerado por scripts/build-react.mjs. Não edite.
2
+ export declare function createResizable(root: HTMLElement, options?: Record<string, unknown>): { sizes: number[]; setSizes(sizes: number[]): void; collapse(index: number): void; expand(index: number): void; reset(): void; destroy(): void };