@f-ewald/components 1.38.0 → 1.40.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 (197) hide show
  1. package/README.md +48 -0
  2. package/custom-elements.json +1052 -131
  3. package/dist/address-autocomplete.js +2 -2
  4. package/dist/address-autocomplete.js.map +1 -1
  5. package/dist/app-shell.js +4 -4
  6. package/dist/app-shell.js.map +1 -1
  7. package/dist/app-sidebar.js +2 -2
  8. package/dist/app-sidebar.js.map +1 -1
  9. package/dist/audio-player.js +1 -1
  10. package/dist/audio-player.js.map +1 -1
  11. package/dist/autocomplete-input.js +2 -2
  12. package/dist/autocomplete-input.js.map +1 -1
  13. package/dist/breadcrumb-nav.d.ts +69 -0
  14. package/dist/breadcrumb-nav.d.ts.map +1 -0
  15. package/dist/breadcrumb-nav.js +235 -0
  16. package/dist/breadcrumb-nav.js.map +1 -0
  17. package/dist/button-group.js +2 -2
  18. package/dist/button-group.js.map +1 -1
  19. package/dist/calendar-day.js +3 -3
  20. package/dist/calendar-day.js.map +1 -1
  21. package/dist/calendar-month.d.ts.map +1 -1
  22. package/dist/calendar-month.js +4 -1
  23. package/dist/calendar-month.js.map +1 -1
  24. package/dist/calendar-week.js +4 -4
  25. package/dist/calendar-week.js.map +1 -1
  26. package/dist/chat-message.js +1 -1
  27. package/dist/chat-message.js.map +1 -1
  28. package/dist/comment-composer.js +1 -1
  29. package/dist/comment-composer.js.map +1 -1
  30. package/dist/confirm-dialog.d.ts.map +1 -1
  31. package/dist/confirm-dialog.js +5 -2
  32. package/dist/confirm-dialog.js.map +1 -1
  33. package/dist/content-divider.js +1 -1
  34. package/dist/content-divider.js.map +1 -1
  35. package/dist/cron-schedule.d.ts.map +1 -1
  36. package/dist/cron-schedule.js +6 -5
  37. package/dist/cron-schedule.js.map +1 -1
  38. package/dist/data-table.d.ts.map +1 -1
  39. package/dist/data-table.js +3 -2
  40. package/dist/data-table.js.map +1 -1
  41. package/dist/dropdown-button.d.ts.map +1 -1
  42. package/dist/dropdown-button.js +4 -2
  43. package/dist/dropdown-button.js.map +1 -1
  44. package/dist/editable-text.js +1 -1
  45. package/dist/editable-text.js.map +1 -1
  46. package/dist/empty-state.d.ts +42 -0
  47. package/dist/empty-state.d.ts.map +1 -0
  48. package/dist/empty-state.js +172 -0
  49. package/dist/empty-state.js.map +1 -0
  50. package/dist/form-field.js +1 -1
  51. package/dist/form-field.js.map +1 -1
  52. package/dist/form-select.js +3 -3
  53. package/dist/form-select.js.map +1 -1
  54. package/dist/frame-box.js +1 -1
  55. package/dist/frame-box.js.map +1 -1
  56. package/dist/fullscreen-button.js +1 -1
  57. package/dist/fullscreen-button.js.map +1 -1
  58. package/dist/icons.d.ts +2 -0
  59. package/dist/icons.d.ts.map +1 -1
  60. package/dist/icons.js +2 -0
  61. package/dist/icons.js.map +1 -1
  62. package/dist/index.d.ts +6 -1
  63. package/dist/index.d.ts.map +1 -1
  64. package/dist/index.js +6 -1
  65. package/dist/index.js.map +1 -1
  66. package/dist/kanban-card.js +1 -1
  67. package/dist/kanban-card.js.map +1 -1
  68. package/dist/kanban-column.js +3 -3
  69. package/dist/kanban-column.js.map +1 -1
  70. package/dist/kbd-hint.d.ts.map +1 -1
  71. package/dist/kbd-hint.js +2 -1
  72. package/dist/kbd-hint.js.map +1 -1
  73. package/dist/link-card.js +1 -1
  74. package/dist/link-card.js.map +1 -1
  75. package/dist/markdown-view.js +3 -3
  76. package/dist/markdown-view.js.map +1 -1
  77. package/dist/modal-dialog.js +1 -1
  78. package/dist/modal-dialog.js.map +1 -1
  79. package/dist/multi-select.js +5 -5
  80. package/dist/multi-select.js.map +1 -1
  81. package/dist/pagination-nav.d.ts.map +1 -1
  82. package/dist/pagination-nav.js +5 -1
  83. package/dist/pagination-nav.js.map +1 -1
  84. package/dist/photo-gallery.js +1 -1
  85. package/dist/photo-gallery.js.map +1 -1
  86. package/dist/popover-panel.d.ts.map +1 -1
  87. package/dist/popover-panel.js +4 -2
  88. package/dist/popover-panel.js.map +1 -1
  89. package/dist/progress-bar.d.ts.map +1 -1
  90. package/dist/progress-bar.js +1 -0
  91. package/dist/progress-bar.js.map +1 -1
  92. package/dist/radio-cards.js +1 -1
  93. package/dist/radio-cards.js.map +1 -1
  94. package/dist/radio-pills.js +1 -1
  95. package/dist/radio-pills.js.map +1 -1
  96. package/dist/reveal-button.js +1 -1
  97. package/dist/reveal-button.js.map +1 -1
  98. package/dist/scroll-to-bottom.js +1 -1
  99. package/dist/scroll-to-bottom.js.map +1 -1
  100. package/dist/scroll-to-top.js +1 -1
  101. package/dist/scroll-to-top.js.map +1 -1
  102. package/dist/skip-link.d.ts +30 -0
  103. package/dist/skip-link.d.ts.map +1 -0
  104. package/dist/skip-link.js +136 -0
  105. package/dist/skip-link.js.map +1 -0
  106. package/dist/slide-panel.js +1 -1
  107. package/dist/slide-panel.js.map +1 -1
  108. package/dist/spec-list.d.ts +49 -0
  109. package/dist/spec-list.d.ts.map +1 -0
  110. package/dist/spec-list.js +168 -0
  111. package/dist/spec-list.js.map +1 -0
  112. package/dist/stat-meter.d.ts.map +1 -1
  113. package/dist/stat-meter.js +1 -0
  114. package/dist/stat-meter.js.map +1 -1
  115. package/dist/tab-bar.js +1 -1
  116. package/dist/tab-bar.js.map +1 -1
  117. package/dist/text-area.js +1 -1
  118. package/dist/text-area.js.map +1 -1
  119. package/dist/tile-grid.js +1 -1
  120. package/dist/tile-grid.js.map +1 -1
  121. package/dist/tokens.css +42 -1
  122. package/dist/tokens.d.ts +50 -0
  123. package/dist/tokens.d.ts.map +1 -1
  124. package/dist/tokens.js +132 -0
  125. package/dist/tokens.js.map +1 -1
  126. package/dist/tree-view.js +2 -2
  127. package/dist/tree-view.js.map +1 -1
  128. package/dist/ui-admonition.js +1 -1
  129. package/dist/ui-admonition.js.map +1 -1
  130. package/dist/ui-button.js +1 -1
  131. package/dist/ui-button.js.map +1 -1
  132. package/dist/ui-checkbox.d.ts +10 -1
  133. package/dist/ui-checkbox.d.ts.map +1 -1
  134. package/dist/ui-checkbox.js +11 -2
  135. package/dist/ui-checkbox.js.map +1 -1
  136. package/dist/video-player.js +1 -1
  137. package/dist/video-player.js.map +1 -1
  138. package/dist/vote-control.d.ts +40 -0
  139. package/dist/vote-control.d.ts.map +1 -0
  140. package/dist/vote-control.js +311 -0
  141. package/dist/vote-control.js.map +1 -0
  142. package/docs/address-autocomplete.md +1 -0
  143. package/docs/app-shell.md +1 -0
  144. package/docs/app-sidebar.md +1 -0
  145. package/docs/audio-player.md +1 -0
  146. package/docs/autocomplete-input.md +1 -0
  147. package/docs/breadcrumb-nav.md +70 -0
  148. package/docs/button-group.md +1 -0
  149. package/docs/calendar-day.md +1 -0
  150. package/docs/calendar-month.md +1 -0
  151. package/docs/calendar-week.md +1 -0
  152. package/docs/chat-message.md +1 -0
  153. package/docs/comment-composer.md +1 -0
  154. package/docs/confirm-dialog.md +1 -0
  155. package/docs/content-divider.md +1 -0
  156. package/docs/cron-schedule.md +2 -0
  157. package/docs/data-table.md +2 -0
  158. package/docs/design-language.md +57 -5
  159. package/docs/dropdown-button.md +1 -0
  160. package/docs/editable-text.md +1 -0
  161. package/docs/empty-state.md +55 -0
  162. package/docs/form-field.md +1 -0
  163. package/docs/form-select.md +1 -0
  164. package/docs/frame-box.md +1 -0
  165. package/docs/fullscreen-button.md +1 -0
  166. package/docs/icons.md +1 -0
  167. package/docs/kanban-card.md +1 -0
  168. package/docs/kanban-column.md +1 -0
  169. package/docs/kbd-hint.md +1 -0
  170. package/docs/link-card.md +1 -0
  171. package/docs/markdown-view.md +1 -0
  172. package/docs/modal-dialog.md +1 -0
  173. package/docs/multi-select.md +1 -0
  174. package/docs/pagination-nav.md +2 -0
  175. package/docs/photo-gallery.md +1 -0
  176. package/docs/popover-panel.md +1 -0
  177. package/docs/progress-bar.md +1 -0
  178. package/docs/radio-cards.md +1 -0
  179. package/docs/radio-pills.md +1 -0
  180. package/docs/reveal-button.md +1 -0
  181. package/docs/scroll-to-bottom.md +1 -0
  182. package/docs/scroll-to-top.md +1 -0
  183. package/docs/skip-link.md +54 -0
  184. package/docs/slide-panel.md +1 -0
  185. package/docs/spec-list.md +71 -0
  186. package/docs/stat-meter.md +1 -0
  187. package/docs/tab-bar.md +1 -0
  188. package/docs/text-area.md +1 -0
  189. package/docs/tile-grid.md +1 -0
  190. package/docs/tree-view.md +1 -0
  191. package/docs/ui-admonition.md +1 -0
  192. package/docs/ui-button.md +1 -0
  193. package/docs/ui-checkbox.md +13 -2
  194. package/docs/video-player.md +1 -0
  195. package/docs/vote-control.md +73 -0
  196. package/llms.txt +210 -49
  197. package/package.json +1 -1
@@ -0,0 +1,73 @@
1
+ # `<vote-control>`
2
+
3
+ An up/down vote widget with a live score readout — the "vote an entry up or
4
+ down toward a promotion threshold" pattern from a public register site,
5
+ where one member casts a single vote that can be changed or withdrawn at any
6
+ time. Two native `<button>`s flank a score; the button matching the user's
7
+ own cast `vote` reads as pressed (`aria-pressed`), and clicking it again
8
+ withdraws the vote. Set an optional `target` to render a thin progress meter
9
+ toward the promotion threshold beneath (vertical) or beside (horizontal) the
10
+ buttons.
11
+
12
+ ## Install
13
+
14
+ ```js
15
+ import "@f-ewald/components/vote-control.js";
16
+ ```
17
+
18
+ ## Usage
19
+
20
+ ```html
21
+ <vote-control value="7" target="10" label="Vote for this entry"></vote-control>
22
+ <vote-control orientation="horizontal" value="42" target="50"></vote-control>
23
+ <vote-control value="3" disabled></vote-control>
24
+ ```
25
+
26
+ ## Attributes / properties
27
+
28
+ | Property | Attribute | Type | Default | Description |
29
+ | --- | --- | --- | --- | --- |
30
+ | `value` | `value` | `number` | `0` | The current net score shown between the buttons. |
31
+ | `vote` | `vote` | `"up" | "down" | null` | `null` | This user's own cast vote, or `null` if they have not voted. Reflected so CSS can style the pressed button. |
32
+ | `disabled` | `disabled` | `boolean` | `false` | Disables both buttons and dims the control. |
33
+ | `orientation` | `orientation` | `"vertical" | "horizontal"` | `"vertical"` | Layout — `vertical` is the compact stacked box (default); `horizontal` is the wide inline variant. |
34
+ | `target` | `target` | `number` | `0` | Promotion threshold. When > 0, a thin progress meter toward it renders; when 0 (default) no meter renders and no space is reserved for it. |
35
+ | `label` | `label` | `string` | `"Vote"` | Accessible label naming the vote group. |
36
+
37
+ ## Events
38
+
39
+ | Event | Description |
40
+ | --- | --- |
41
+ | `vote-change` | The user cast, switched, or withdrew their vote; detail: { vote: "up" | "down" | null, value: number }. |
42
+
43
+ ## Slots
44
+
45
+ _None._
46
+
47
+ ## CSS custom properties
48
+
49
+ | Custom property |
50
+ | --- |
51
+ | `--ui-border` |
52
+ | `--ui-border-width` |
53
+ | `--ui-button-accent` |
54
+ | `--ui-danger` |
55
+ | `--ui-focus-ring` |
56
+ | `--ui-font` |
57
+ | `--ui-font-size-lg` |
58
+ | `--ui-font-size-xs` |
59
+ | `--ui-font-weight-medium` |
60
+ | `--ui-font-weight-semibold` |
61
+ | `--ui-label-transform` |
62
+ | `--ui-line-height-tight` |
63
+ | `--ui-numeric` |
64
+ | `--ui-primary` |
65
+ | `--ui-radius` |
66
+ | `--ui-radius-pill` |
67
+ | `--ui-radius-sm` |
68
+ | `--ui-success` |
69
+ | `--ui-surface` |
70
+ | `--ui-surface-muted` |
71
+ | `--ui-text` |
72
+ | `--ui-text-muted` |
73
+ | `--ui-tracking-wide` |