@xerios/design-system 0.0.0-stage → 0.1.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 (214) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +403 -2
  3. package/dist/components/AnchorHeading.svelte +79 -0
  4. package/dist/components/AnchorHeading.svelte.d.ts +28 -0
  5. package/dist/components/Breadcrumbs.svelte +216 -0
  6. package/dist/components/Breadcrumbs.svelte.d.ts +37 -0
  7. package/dist/components/Button.svelte +178 -0
  8. package/dist/components/Button.svelte.d.ts +58 -0
  9. package/dist/components/Canvas.svelte +248 -0
  10. package/dist/components/Canvas.svelte.d.ts +91 -0
  11. package/dist/components/Collapsible.svelte +139 -0
  12. package/dist/components/Collapsible.svelte.d.ts +52 -0
  13. package/dist/components/CollapsibleAdvanced.svelte +174 -0
  14. package/dist/components/CollapsibleAdvanced.svelte.d.ts +43 -0
  15. package/dist/components/DashOutline.svelte +47 -0
  16. package/dist/components/DashOutline.svelte.d.ts +6 -0
  17. package/dist/components/Dialogs.svelte +123 -0
  18. package/dist/components/Dialogs.svelte.d.ts +6 -0
  19. package/dist/components/Drawer.svelte +231 -0
  20. package/dist/components/Drawer.svelte.d.ts +62 -0
  21. package/dist/components/ErrorMessage.svelte +140 -0
  22. package/dist/components/ErrorMessage.svelte.d.ts +41 -0
  23. package/dist/components/Icon.svelte +94 -0
  24. package/dist/components/Icon.svelte.d.ts +33 -0
  25. package/dist/components/InfoTip.svelte +183 -0
  26. package/dist/components/InfoTip.svelte.d.ts +28 -0
  27. package/dist/components/Md.svelte +28 -0
  28. package/dist/components/Md.svelte.d.ts +11 -0
  29. package/dist/components/Modal.svelte +91 -0
  30. package/dist/components/Modal.svelte.d.ts +41 -0
  31. package/dist/components/Notice.svelte +50 -0
  32. package/dist/components/Notice.svelte.d.ts +30 -0
  33. package/dist/components/Popover.svelte +212 -0
  34. package/dist/components/Popover.svelte.d.ts +70 -0
  35. package/dist/components/Shimmer.svelte +27 -0
  36. package/dist/components/Shimmer.svelte.d.ts +22 -0
  37. package/dist/components/Splitter.svelte +152 -0
  38. package/dist/components/Splitter.svelte.d.ts +41 -0
  39. package/dist/components/Table.svelte +448 -0
  40. package/dist/components/Table.svelte.d.ts +268 -0
  41. package/dist/components/Toast.svelte +273 -0
  42. package/dist/components/Toast.svelte.d.ts +31 -0
  43. package/dist/components/Tooltip.svelte +97 -0
  44. package/dist/components/Tooltip.svelte.d.ts +19 -0
  45. package/dist/components/WorkingBorder.svelte +105 -0
  46. package/dist/components/WorkingBorder.svelte.d.ts +26 -0
  47. package/dist/components/empty/Empty.svelte +55 -0
  48. package/dist/components/empty/Empty.svelte.d.ts +39 -0
  49. package/dist/components/empty/EmptyError.svelte +47 -0
  50. package/dist/components/empty/EmptyError.svelte.d.ts +28 -0
  51. package/dist/components/empty/index.d.ts +18 -0
  52. package/dist/components/empty/index.js +10 -0
  53. package/dist/components/filters/DateFilter.svelte +59 -0
  54. package/dist/components/filters/DateFilter.svelte.d.ts +23 -0
  55. package/dist/components/filters/FilterBar.svelte +342 -0
  56. package/dist/components/filters/FilterBar.svelte.d.ts +283 -0
  57. package/dist/components/filters/FilterChip.svelte +235 -0
  58. package/dist/components/filters/FilterChip.svelte.d.ts +68 -0
  59. package/dist/components/filters/OptionList.svelte +352 -0
  60. package/dist/components/filters/OptionList.svelte.d.ts +91 -0
  61. package/dist/components/filters/Panel.svelte +123 -0
  62. package/dist/components/filters/Panel.svelte.d.ts +25 -0
  63. package/dist/components/filters/index.d.ts +288 -0
  64. package/dist/components/filters/index.js +12 -0
  65. package/dist/components/icons.d.ts +54 -0
  66. package/dist/components/icons.js +58 -0
  67. package/dist/components/inputs/ButtonGroup.svelte +104 -0
  68. package/dist/components/inputs/ButtonGroup.svelte.d.ts +40 -0
  69. package/dist/components/inputs/Calendar.svelte +535 -0
  70. package/dist/components/inputs/Calendar.svelte.d.ts +45 -0
  71. package/dist/components/inputs/DateField.svelte +247 -0
  72. package/dist/components/inputs/DateField.svelte.d.ts +74 -0
  73. package/dist/components/inputs/DateInput.svelte +118 -0
  74. package/dist/components/inputs/DateInput.svelte.d.ts +43 -0
  75. package/dist/components/inputs/DatePicker.svelte +102 -0
  76. package/dist/components/inputs/DatePicker.svelte.d.ts +67 -0
  77. package/dist/components/inputs/DateRangePicker.svelte +208 -0
  78. package/dist/components/inputs/DateRangePicker.svelte.d.ts +76 -0
  79. package/dist/components/inputs/DateRangeSelect.svelte +548 -0
  80. package/dist/components/inputs/DateRangeSelect.svelte.d.ts +70 -0
  81. package/dist/components/inputs/FieldLabel.svelte +43 -0
  82. package/dist/components/inputs/FieldLabel.svelte.d.ts +28 -0
  83. package/dist/components/inputs/ListSearch.svelte +142 -0
  84. package/dist/components/inputs/ListSearch.svelte.d.ts +35 -0
  85. package/dist/components/inputs/RadioGroup.svelte +153 -0
  86. package/dist/components/inputs/RadioGroup.svelte.d.ts +49 -0
  87. package/dist/components/inputs/RangeShortcuts.svelte +90 -0
  88. package/dist/components/inputs/RangeShortcuts.svelte.d.ts +31 -0
  89. package/dist/components/inputs/RangeSlider.svelte +225 -0
  90. package/dist/components/inputs/RangeSlider.svelte.d.ts +37 -0
  91. package/dist/components/inputs/SearchField.svelte +24 -0
  92. package/dist/components/inputs/SearchField.svelte.d.ts +41 -0
  93. package/dist/components/inputs/Segmented.svelte +76 -0
  94. package/dist/components/inputs/Segmented.svelte.d.ts +43 -0
  95. package/dist/components/inputs/Select.svelte +552 -0
  96. package/dist/components/inputs/Select.svelte.d.ts +100 -0
  97. package/dist/components/inputs/Slider.svelte +177 -0
  98. package/dist/components/inputs/Slider.svelte.d.ts +33 -0
  99. package/dist/components/inputs/SliderTicks.svelte +62 -0
  100. package/dist/components/inputs/SliderTicks.svelte.d.ts +23 -0
  101. package/dist/components/inputs/Switch.svelte +120 -0
  102. package/dist/components/inputs/Switch.svelte.d.ts +31 -0
  103. package/dist/components/inputs/TagInput.svelte +296 -0
  104. package/dist/components/inputs/TagInput.svelte.d.ts +61 -0
  105. package/dist/components/inputs/TextArea.svelte +86 -0
  106. package/dist/components/inputs/TextArea.svelte.d.ts +56 -0
  107. package/dist/components/inputs/TextField.svelte +170 -0
  108. package/dist/components/inputs/TextField.svelte.d.ts +80 -0
  109. package/dist/components/menu/ContextMenu.svelte +25 -0
  110. package/dist/components/menu/ContextMenu.svelte.d.ts +26 -0
  111. package/dist/components/menu/MenuButton.svelte +46 -0
  112. package/dist/components/menu/MenuButton.svelte.d.ts +16 -0
  113. package/dist/components/menu/MenuList.svelte +319 -0
  114. package/dist/components/menu/MenuList.svelte.d.ts +30 -0
  115. package/dist/components/metadata/Metadata.svelte +38 -0
  116. package/dist/components/metadata/Metadata.svelte.d.ts +31 -0
  117. package/dist/components/metadata/MetadataRow.svelte +84 -0
  118. package/dist/components/metadata/MetadataRow.svelte.d.ts +26 -0
  119. package/dist/components/metadata/index.d.ts +8 -0
  120. package/dist/components/metadata/index.js +13 -0
  121. package/dist/components/side-menu/SideMenu.svelte +138 -0
  122. package/dist/components/side-menu/SideMenu.svelte.d.ts +25 -0
  123. package/dist/components/side-menu/SideMenuGroup.svelte +108 -0
  124. package/dist/components/side-menu/SideMenuGroup.svelte.d.ts +31 -0
  125. package/dist/components/side-menu/SideMenuItem.svelte +221 -0
  126. package/dist/components/side-menu/SideMenuItem.svelte.d.ts +46 -0
  127. package/dist/components/side-menu/context.d.ts +1 -0
  128. package/dist/components/side-menu/context.js +3 -0
  129. package/dist/components/side-menu/index.d.ts +62 -0
  130. package/dist/components/side-menu/index.js +15 -0
  131. package/dist/components/tiles/Tile.svelte +419 -0
  132. package/dist/components/tiles/Tile.svelte.d.ts +58 -0
  133. package/dist/components/tiles/TileGroup.svelte +135 -0
  134. package/dist/components/tiles/TileGroup.svelte.d.ts +45 -0
  135. package/dist/components/tiles/context.d.ts +35 -0
  136. package/dist/components/tiles/context.js +14 -0
  137. package/dist/components/tiles/index.d.ts +6 -0
  138. package/dist/components/tiles/index.js +13 -0
  139. package/dist/components/upload/FileCard.svelte +301 -0
  140. package/dist/components/upload/FileCard.svelte.d.ts +127 -0
  141. package/dist/components/upload/Thumb.svelte +274 -0
  142. package/dist/components/upload/Thumb.svelte.d.ts +101 -0
  143. package/dist/components/upload/UploadFile.svelte +123 -0
  144. package/dist/components/upload/UploadFile.svelte.d.ts +48 -0
  145. package/dist/components/upload/UploadFiles.svelte +177 -0
  146. package/dist/components/upload/UploadFiles.svelte.d.ts +50 -0
  147. package/dist/components/upload/UploadFolder.svelte +153 -0
  148. package/dist/components/upload/UploadFolder.svelte.d.ts +63 -0
  149. package/dist/components/upload/UploadImage.svelte +137 -0
  150. package/dist/components/upload/UploadImage.svelte.d.ts +52 -0
  151. package/dist/components/upload/UploadImages.svelte +172 -0
  152. package/dist/components/upload/UploadImages.svelte.d.ts +52 -0
  153. package/dist/components/upload/UploadZone.svelte +130 -0
  154. package/dist/components/upload/UploadZone.svelte.d.ts +41 -0
  155. package/dist/components/upload/common.d.ts +31 -0
  156. package/dist/components/upload/common.js +103 -0
  157. package/dist/components/upload/context.d.ts +18 -0
  158. package/dist/components/upload/context.js +10 -0
  159. package/dist/components/upload/index.d.ts +16 -0
  160. package/dist/components/upload/index.js +18 -0
  161. package/dist/css/atoms.css +892 -0
  162. package/dist/css/base.css +333 -0
  163. package/dist/css/effects.css +430 -0
  164. package/dist/css/index.css +10 -0
  165. package/dist/css/tokens.css +296 -0
  166. package/dist/fonts.d.ts +1 -0
  167. package/dist/fonts.js +7 -0
  168. package/dist/index.d.ts +68 -0
  169. package/dist/index.js +77 -0
  170. package/dist/lib/announce.d.ts +8 -0
  171. package/dist/lib/announce.js +48 -0
  172. package/dist/lib/controls.d.ts +10 -0
  173. package/dist/lib/controls.js +42 -0
  174. package/dist/lib/dates.d.ts +104 -0
  175. package/dist/lib/dates.js +235 -0
  176. package/dist/lib/dialogs.svelte.d.ts +8 -0
  177. package/dist/lib/dialogs.svelte.js +45 -0
  178. package/dist/lib/dom.d.ts +34 -0
  179. package/dist/lib/dom.js +90 -0
  180. package/dist/lib/field-errors.svelte.d.ts +40 -0
  181. package/dist/lib/field-errors.svelte.js +89 -0
  182. package/dist/lib/files.d.ts +74 -0
  183. package/dist/lib/files.js +215 -0
  184. package/dist/lib/inline-md.d.ts +1 -0
  185. package/dist/lib/inline-md.js +36 -0
  186. package/dist/lib/invalid.d.ts +4 -0
  187. package/dist/lib/invalid.js +35 -0
  188. package/dist/lib/list-search.d.ts +9 -0
  189. package/dist/lib/list-search.js +27 -0
  190. package/dist/lib/menu.svelte.d.ts +39 -0
  191. package/dist/lib/menu.svelte.js +98 -0
  192. package/dist/lib/morph.svelte.d.ts +17 -0
  193. package/dist/lib/morph.svelte.js +46 -0
  194. package/dist/lib/motion.d.ts +115 -0
  195. package/dist/lib/motion.js +174 -0
  196. package/dist/lib/observe.d.ts +36 -0
  197. package/dist/lib/observe.js +142 -0
  198. package/dist/lib/reveal.d.ts +7 -0
  199. package/dist/lib/reveal.js +28 -0
  200. package/dist/lib/roving.d.ts +16 -0
  201. package/dist/lib/roving.js +35 -0
  202. package/dist/lib/runs.d.ts +18 -0
  203. package/dist/lib/runs.js +25 -0
  204. package/dist/lib/scroll-fade.d.ts +4 -0
  205. package/dist/lib/scroll-fade.js +71 -0
  206. package/dist/lib/spotlight.d.ts +4 -0
  207. package/dist/lib/spotlight.js +109 -0
  208. package/dist/lib/ticks.d.ts +12 -0
  209. package/dist/lib/ticks.js +24 -0
  210. package/dist/lib/tooltip.d.ts +4 -0
  211. package/dist/lib/tooltip.js +110 -0
  212. package/dist/lib/validity.d.ts +16 -0
  213. package/dist/lib/validity.js +36 -0
  214. package/package.json +69 -3
@@ -0,0 +1,235 @@
1
+ <script>
2
+ /**
3
+ * One applied filter as a joined pill (Linear's filter chips): the field it looks at, the condition, the value and a ✕,
4
+ * split by hairlines. The condition opens a menu of the others; the value opens a panel under it with whatever edits
5
+ * it (an OptionList, a calendar…); the ✕ removes the filter. FilterBar draws these from data; use one directly for a
6
+ * filter row of your own.
7
+ *
8
+ * <FilterChip field={{ label: 'Status', icon: 'circleDashed' }} operator="is" operators={['is', 'is not']}
9
+ * onoperator={(op) => (f.op = op)} onremove={() => remove(f)}>
10
+ * {#snippet value()}<Icon name="checkCircle" size="sm" />Done{/snippet}
11
+ * {#snippet panel({ close })}<OptionList bind:value={f.value} options={STATUSES} label="Status" />{/snippet}
12
+ * </FilterChip>
13
+ *
14
+ * field: { label, icon? } (an Icon name). operator: the condition shown ("is", "after"). operators: the conditions it
15
+ * can switch to; with more than one the condition is a button opening them as a menu (the context menu layer, so mount
16
+ * <ContextMenu />), else plain text. onoperator(op). onremove(): the ✕ (removeLabel names it, default "Remove filter").
17
+ * open (bindable): whether the value's panel is open. onclose(): after the panel closes, however it closed.
18
+ * value: snippet drawing the value on its button. panel: snippet ({ close }) drawing the editor in the panel; close()
19
+ * closes it and puts the focus back on the value.
20
+ * focus(): puts the focus on the value button.
21
+ * Keyboard: each part is a button in the tab order. On the value, Enter, Space or ArrowDown opens the panel; Esc in it
22
+ * closes it, and Tab past its last control closes it and moves on. The group is named by its parts ("Status is Done").
23
+ * Other attributes (class…) and attachments go to the group.
24
+ */
25
+ import Icon from '../Icon.svelte'
26
+ import Panel from './Panel.svelte'
27
+ import { tooltip } from '../../lib/tooltip.js'
28
+ import { menu, openMenuFrom, closeMenu } from '../../lib/menu.svelte.js'
29
+
30
+ /**
31
+ * @typedef {object} Props
32
+ * @property {{ label: string, icon?: string }} field
33
+ * @property {string} operator
34
+ * @property {string[]} [operators]
35
+ * @property {(op: string) => void} [onoperator]
36
+ * @property {() => void} onremove
37
+ * @property {string} [removeLabel]
38
+ * @property {boolean} [open] bindable
39
+ * @property {() => void} [onclose]
40
+ * @property {import('svelte').Snippet} value
41
+ * @property {import('svelte').Snippet<[{ close: () => void }]>} [panel]
42
+ */
43
+ /** @type {Props & Omit<import('svelte/elements').HTMLAttributes<HTMLDivElement>, keyof Props>} */
44
+ let {
45
+ field,
46
+ operator,
47
+ operators = [],
48
+ onoperator,
49
+ onremove,
50
+ removeLabel = 'Remove filter',
51
+ open = $bindable(false),
52
+ onclose,
53
+ value,
54
+ panel,
55
+ class: className,
56
+ ...rest
57
+ } = $props()
58
+
59
+ const uid = $props.id()
60
+ const anchor = `--filter-${uid}`
61
+ /** @type {HTMLButtonElement | undefined} */
62
+ let valueButton = $state()
63
+ /** @type {HTMLButtonElement | undefined} */
64
+ let opButton = $state()
65
+ const choosable = $derived(operators.length > 1)
66
+ const opOpen = $derived(menu.open && !!opButton && menu.trigger === opButton)
67
+
68
+ export function focus() {
69
+ valueButton?.focus()
70
+ }
71
+
72
+ /** @param {boolean} refocus */
73
+ function close(refocus) {
74
+ if (!open) return
75
+ open = false
76
+ if (refocus) valueButton?.focus()
77
+ onclose?.()
78
+ }
79
+
80
+ /** @param {MouseEvent} e */
81
+ function toggleOperators(e) {
82
+ e.stopPropagation()
83
+ if (opOpen) return closeMenu()
84
+ if (!opButton) return
85
+ openMenuFrom(
86
+ opButton,
87
+ operators.map((op) => ({ label: op, checked: op === operator, action: () => onoperator?.(op) })),
88
+ `${field.label} condition`,
89
+ )
90
+ }
91
+
92
+ /** @param {KeyboardEvent} e */
93
+ function onValueKey(e) {
94
+ if (e.key === 'ArrowDown' && !open && panel) {
95
+ e.preventDefault()
96
+ open = true
97
+ }
98
+ }
99
+ </script>
100
+
101
+ <div class={['filter-chip', className]} role="group" aria-labelledby="{uid}-field {uid}-op {uid}-value" {...rest}>
102
+ <span class="seg field" id="{uid}-field">
103
+ {#if field.icon}<Icon name={field.icon} size="sm" />{/if}
104
+ {field.label}
105
+ </span>
106
+ {#if choosable}
107
+ <button
108
+ bind:this={opButton}
109
+ type="button"
110
+ class="seg op"
111
+ id="{uid}-op"
112
+ aria-haspopup="menu"
113
+ aria-expanded={opOpen}
114
+ {@attach tooltip('Change condition')}
115
+ onclick={toggleOperators}>{operator}</button
116
+ >
117
+ {:else}
118
+ <span class="seg op" id="{uid}-op">{operator}</span>
119
+ {/if}
120
+ <button
121
+ bind:this={valueButton}
122
+ type="button"
123
+ class="seg value"
124
+ id="{uid}-value"
125
+ style:anchor-name={anchor}
126
+ aria-haspopup={panel ? 'dialog' : undefined}
127
+ aria-expanded={panel ? open : undefined}
128
+ disabled={!panel}
129
+ onclick={() => (open ? close(true) : (open = true))}
130
+ onkeydown={onValueKey}>{@render value()}</button
131
+ >
132
+ <button type="button" class="seg remove" aria-label={removeLabel} {@attach tooltip(removeLabel)} onclick={onremove}>
133
+ <Icon name="x" size="sm" />
134
+ </button>
135
+ </div>
136
+
137
+ {#if open && panel && valueButton}
138
+ <Panel anchor={valueButton} name={anchor} label={field.label} onclose={close}>
139
+ {@render panel({ close: () => close(true) })}
140
+ </Panel>
141
+ {/if}
142
+
143
+ <style>
144
+ /* Segments on one faint control fill, split by hairlines that run the pill's full height. */
145
+ /* Chrome, not content: its field name and condition are plain spans, which base.css doesn't cover. */
146
+ .filter-chip {
147
+ user-select: none;
148
+ display: inline-flex;
149
+ align-items: stretch;
150
+ flex: none;
151
+ max-width: 100%;
152
+ min-height: 26px;
153
+ border-radius: var(--r-sm);
154
+ background: var(--control-1);
155
+ font: var(--w-medium) 12px/14px var(--font-body);
156
+ white-space: nowrap;
157
+ }
158
+ .seg {
159
+ display: inline-flex;
160
+ align-items: center;
161
+ gap: 6px;
162
+ min-width: 0;
163
+ padding: 0 var(--space-2);
164
+ border: 0;
165
+ border-radius: 0;
166
+ background: none;
167
+ color: var(--fg-2);
168
+ font: inherit;
169
+ transition:
170
+ background-color var(--dur) var(--ease-out),
171
+ color var(--dur) var(--ease-out);
172
+ }
173
+ .seg + .seg {
174
+ border-inline-start: 1px solid var(--line);
175
+ }
176
+ .seg:first-child {
177
+ border-start-start-radius: inherit;
178
+ border-end-start-radius: inherit;
179
+ }
180
+ .seg:last-child {
181
+ border-start-end-radius: inherit;
182
+ border-end-end-radius: inherit;
183
+ }
184
+ .field :global(.icon) {
185
+ color: var(--muted);
186
+ }
187
+ /* As readable as the field name beside it (it is a button too); hovering changes only the fill. */
188
+ .op {
189
+ color: var(--fg-2);
190
+ }
191
+ /* clip, not hidden: an element with overflow: hidden is a scroll container, which Chrome may put on a layer of its own
192
+ while the pointer is over it, redrawing its text with other smoothing (the text seems to shift as it is hovered). */
193
+ .value {
194
+ max-width: 280px;
195
+ overflow: clip;
196
+ color: var(--fg);
197
+ }
198
+ /* An icon may brighten as it is hovered (no text to shift). */
199
+ .remove:hover,
200
+ .remove:active {
201
+ color: var(--fg);
202
+ }
203
+ .remove {
204
+ justify-content: center;
205
+ min-width: 26px;
206
+ padding: 0;
207
+ color: var(--muted);
208
+ }
209
+ button.seg {
210
+ cursor: pointer;
211
+ }
212
+ button.seg:hover:not(:disabled) {
213
+ background: var(--control-3);
214
+ }
215
+ button.seg:active:not(:disabled),
216
+ button.seg[aria-expanded='true'] {
217
+ background: var(--control-4);
218
+ }
219
+ .value:disabled {
220
+ cursor: default;
221
+ }
222
+ /* Inside the pill, so the next segment doesn't cover the ring. */
223
+ button.seg:focus-visible {
224
+ outline-offset: -2px;
225
+ }
226
+ @media (forced-colors: active) {
227
+ .filter-chip {
228
+ outline: 1px solid CanvasText;
229
+ outline-offset: -1px;
230
+ }
231
+ .seg + .seg {
232
+ border-color: CanvasText;
233
+ }
234
+ }
235
+ </style>
@@ -0,0 +1,68 @@
1
+ export default FilterChip;
2
+ type FilterChip = {
3
+ $on?(type: string, callback: (e: any) => void): () => void;
4
+ $set?(props: Partial<Props & Omit<HTMLAttributes<HTMLDivElement>, keyof Props>>): void;
5
+ } & {
6
+ focus: () => void;
7
+ };
8
+ declare const FilterChip: import("svelte").Component<{
9
+ field: {
10
+ label: string;
11
+ icon?: string;
12
+ };
13
+ operator: string;
14
+ operators?: string[] | undefined;
15
+ onoperator?: ((op: string) => void) | undefined;
16
+ onremove: () => void;
17
+ removeLabel?: string | undefined;
18
+ /**
19
+ * bindable
20
+ */
21
+ open?: boolean | undefined;
22
+ onclose?: (() => void) | undefined;
23
+ value: import("svelte").Snippet;
24
+ panel?: import("svelte").Snippet<[{
25
+ close: () => void;
26
+ }]> | undefined;
27
+ } & Omit<import("svelte/elements").HTMLAttributes<HTMLDivElement>, keyof {
28
+ field: {
29
+ label: string;
30
+ icon?: string;
31
+ };
32
+ operator: string;
33
+ operators?: string[] | undefined;
34
+ onoperator?: ((op: string) => void) | undefined;
35
+ onremove: () => void;
36
+ removeLabel?: string | undefined;
37
+ /**
38
+ * bindable
39
+ */
40
+ open?: boolean | undefined;
41
+ onclose?: (() => void) | undefined;
42
+ value: import("svelte").Snippet;
43
+ panel?: import("svelte").Snippet<[{
44
+ close: () => void;
45
+ }]> | undefined;
46
+ }>, {
47
+ focus: () => void;
48
+ }, "open">;
49
+ type Props = {
50
+ field: {
51
+ label: string;
52
+ icon?: string;
53
+ };
54
+ operator: string;
55
+ operators?: string[] | undefined;
56
+ onoperator?: ((op: string) => void) | undefined;
57
+ onremove: () => void;
58
+ removeLabel?: string | undefined;
59
+ /**
60
+ * bindable
61
+ */
62
+ open?: boolean | undefined;
63
+ onclose?: (() => void) | undefined;
64
+ value: import("svelte").Snippet;
65
+ panel?: import("svelte").Snippet<[{
66
+ close: () => void;
67
+ }]> | undefined;
68
+ };
@@ -0,0 +1,352 @@
1
+ <script>
2
+ /**
3
+ * A list to tick values in (several, or one with `multiple={false}`), drawn flat to sit inside a floating panel: the
4
+ * value editor of a filter, the field list of FilterBar's add button, or any popover of your own. Each row has a check
5
+ * box, an optional icon (in a tone's colour) and a muted hint on the right, such as how many items have that value.
6
+ * The ticked values move to the top, above a rule, when the list opens; ticking while it is open leaves the rows where
7
+ * they are, so the one under the pointer doesn't jump away.
8
+ *
9
+ * <OptionList bind:value={statuses} options={STATUSES} label="Status" />
10
+ * <OptionList value={field} options={FIELDS} multiple={false} label="Filter by" onpick={(key) => open(key)} />
11
+ *
12
+ * value (bindable): the ticked values, an array (in the options' order); with `multiple={false}`, one value.
13
+ * options: [{ value, label, icon?, tone?, hint? }]. `icon` is an Icon name; `tone` (success, warning, danger, info,
14
+ * neutral or an app's own) colours it through [data-tone]; `hint` sits on the right in tabular figures ("15 projects").
15
+ * label: the list's accessible name. multiple: tick several (default) or pick one.
16
+ * search: 'auto' (default: a ListSearch field to narrow the list when it has more than 8 options), true or false.
17
+ * placeholder: the search field's text ("Filter…"). empty: what shows when nothing matches ("No matches").
18
+ * onchange(value): after every tick. onpick(value): a pick in a single list (the host closes on it).
19
+ * onback(): Backspace with the search empty (FilterBar goes back to the field list with it).
20
+ * lead: snippet (option) drawing the left of a row in place of the icon, for something an icon name can't say.
21
+ * autofocus: takes the focus as it appears (default true).
22
+ * Keyboard: ArrowUp / ArrowDown move, Home / End (without a search field) jump to the ends, Space (without a search
23
+ * field) or Enter ticks or picks; without a search field a letter jumps to the next option starting with it. Esc clears
24
+ * the search, else is left to the panel around it, as Tab is. With a search field the focus stays in it (combobox); otherwise on the list.
25
+ * Other attributes (class…) and attachments go to the wrapper.
26
+ */
27
+ import { tick, untrack } from 'svelte'
28
+ import Icon from '../Icon.svelte'
29
+ import ListSearch from '../inputs/ListSearch.svelte'
30
+ import { matches, wantsSearch } from '../../lib/list-search.js'
31
+ import { reveal } from '../../lib/reveal.js'
32
+
33
+ /**
34
+ * @typedef {{ value: any, label: string, icon?: string, tone?: string, hint?: string }} Option
35
+ * @typedef {object} Props
36
+ * @property {any} [value] bindable: an array, or one value when not `multiple`
37
+ * @property {Option[]} options
38
+ * @property {string} label
39
+ * @property {boolean} [multiple]
40
+ * @property {'auto' | boolean} [search]
41
+ * @property {string} [placeholder]
42
+ * @property {string} [empty]
43
+ * @property {(value: any) => void} [onchange]
44
+ * @property {(value: any) => void} [onpick]
45
+ * @property {() => void} [onback]
46
+ * @property {import('svelte').Snippet<[Option]>} [lead]
47
+ * @property {boolean} [autofocus]
48
+ */
49
+ /** @type {Props & Omit<import('svelte/elements').HTMLAttributes<HTMLDivElement>, keyof Props>} */
50
+ let {
51
+ value = $bindable(),
52
+ options,
53
+ label,
54
+ multiple = true,
55
+ search = 'auto',
56
+ placeholder = 'Filter…',
57
+ empty = 'No matches',
58
+ onchange,
59
+ onpick,
60
+ onback,
61
+ lead,
62
+ autofocus = true,
63
+ class: className,
64
+ ...rest
65
+ } = $props()
66
+
67
+ const uid = $props.id()
68
+ /** @type {HTMLUListElement | undefined} */
69
+ let list = $state()
70
+ let query = $state('')
71
+
72
+ /** @param {any} v */
73
+ const isOn = (v) => (multiple ? Array.isArray(value) && value.includes(v) : value === v)
74
+ // The values ticked as the list opened: these rows lead, above the rule, for as long as it stays open.
75
+ const pinned = untrack(() => new Set(multiple && Array.isArray(value) ? value : []))
76
+ const searchable = $derived(wantsSearch(search, options.length))
77
+ const found = $derived(options.filter((o) => matches(o.label, query)))
78
+ const top = $derived(found.filter((o) => pinned.has(o.value)))
79
+ const others = $derived(found.filter((o) => !pinned.has(o.value)))
80
+ const shown = $derived([...top, ...others])
81
+ const hasLead = $derived(!!lead || options.some((o) => o.icon))
82
+ // A single list marks its pick with a tick; with nothing picked (a list of things to pick from, such as FilterBar's
83
+ // fields), it has no tick column, so its rows don't start with an empty gap.
84
+ const hasTick = $derived(multiple || options.some((o) => o.value === value))
85
+ // The row holding the keyboard: back to the top whenever the search changes; on the picked one as a single list opens.
86
+ let active = $derived.by(() => {
87
+ void query
88
+ return untrack(() => (multiple ? 0 : Math.max(0, shown.findIndex((o) => o.value === value))))
89
+ })
90
+
91
+ /** @param {Option} o */
92
+ function choose(o) {
93
+ if (!multiple) {
94
+ value = o.value
95
+ onchange?.(value)
96
+ onpick?.(value)
97
+ return
98
+ }
99
+ const was = Array.isArray(value) ? value : []
100
+ const on = !was.includes(o.value)
101
+ const next = new Set(was)
102
+ if (on) next.add(o.value)
103
+ else next.delete(o.value)
104
+ // In the options' order, so a summary of them reads the way the list does; values not among the options stay last.
105
+ const order = options.map((x) => x.value)
106
+ value = [...order.filter((v) => next.has(v)), ...was.filter((v) => next.has(v) && !order.includes(v))]
107
+ onchange?.(value)
108
+ }
109
+
110
+ /** @param {number} i */
111
+ function moveTo(i) {
112
+ active = i
113
+ reveal(list, list?.querySelector(`[data-i="${i}"]`))
114
+ }
115
+
116
+ /** @param {KeyboardEvent} e */
117
+ function onkeydown(e) {
118
+ const n = shown.length
119
+ switch (e.key) {
120
+ case 'ArrowDown':
121
+ if (n) moveTo((active + 1) % n)
122
+ break
123
+ case 'ArrowUp':
124
+ if (n) moveTo((active - 1 + n) % n)
125
+ break
126
+ case 'Home':
127
+ case 'End':
128
+ if (searchable) return // the caret's
129
+ if (n) moveTo(e.key === 'Home' ? 0 : n - 1)
130
+ break
131
+ case 'Enter':
132
+ if (shown[active]) choose(shown[active])
133
+ break
134
+ case ' ':
135
+ if (searchable) return // a space in the search
136
+ if (shown[active]) choose(shown[active])
137
+ break
138
+ case 'Backspace':
139
+ if (query || !onback) return
140
+ onback()
141
+ break
142
+ default: {
143
+ if (searchable || e.key.length !== 1 || e.ctrlKey || e.metaKey || e.altKey) return
144
+ const k = e.key.toLowerCase()
145
+ const order = [...shown.keys()].slice(active + 1).concat([...shown.keys()].slice(0, active + 1))
146
+ const hit = order.find((i) => shown[i].label.toLowerCase().startsWith(k))
147
+ if (hit == null) return
148
+ moveTo(hit)
149
+ }
150
+ }
151
+ e.preventDefault()
152
+ }
153
+
154
+ /** Attachment: takes the focus once the list is in place (the panel around it may still be moving into the top layer). */
155
+ const focusIn = (/** @type {HTMLElement} */ node) => {
156
+ if (autofocus) tick().then(() => node.focus({ preventScroll: true }))
157
+ }
158
+ const activeId = $derived(shown.length ? `${uid}-o-${active}` : undefined)
159
+ </script>
160
+
161
+ {#snippet row(/** @type {Option} */ o, /** @type {number} */ i)}
162
+ <!-- Keyboard is handled on the search field or the listbox (aria-activedescendant); options take pointer input only. -->
163
+ <!-- svelte-ignore a11y_click_events_have_key_events -->
164
+ <li
165
+ id="{uid}-o-{i}"
166
+ data-i={i}
167
+ class="option"
168
+ class:active={i === active}
169
+ role="option"
170
+ aria-selected={isOn(o.value)}
171
+ onpointerenter={() => (active = i)}
172
+ onclick={() => choose(o)}
173
+ >
174
+ {#if multiple}
175
+ <span class="box" aria-hidden="true"><Icon name="checkBold" size="sm" /></span>
176
+ {:else if hasTick}
177
+ <span class="tick" aria-hidden="true">{#if isOn(o.value)}<Icon name="check" size="sm" />{/if}</span>
178
+ {/if}
179
+ {#if hasLead}
180
+ <span class="lead" data-tone={o.tone} aria-hidden="true">
181
+ {#if lead}{@render lead(o)}{:else if o.icon}<Icon name={o.icon} />{/if}
182
+ </span>
183
+ {/if}
184
+ <span class="label">{o.label}</span>
185
+ {#if o.hint}<span class="hint">{o.hint}</span>{/if}
186
+ </li>
187
+ {/snippet}
188
+
189
+ <div class={['option-list', className]} {...rest}>
190
+ {#if searchable}
191
+ <ListSearch
192
+ value={query}
193
+ oninput={(text) => (query = text)}
194
+ {label}
195
+ controls="{uid}-list"
196
+ active={activeId}
197
+ {placeholder}
198
+ {onkeydown}
199
+ {@attach focusIn}
200
+ />
201
+ {/if}
202
+ {#if shown.length}
203
+ <!-- With a search field the focus stays in it: a press on the list mustn't take it (mousedown is what moves it). -->
204
+ <ul
205
+ id="{uid}-list"
206
+ bind:this={list}
207
+ class="list"
208
+ role="listbox"
209
+ aria-label={label}
210
+ aria-multiselectable={multiple || undefined}
211
+ tabindex={searchable ? -1 : 0}
212
+ aria-activedescendant={searchable ? undefined : activeId}
213
+ onkeydown={searchable ? undefined : onkeydown}
214
+ onmousedown={searchable ? (e) => e.preventDefault() : undefined}
215
+ {@attach searchable ? null : focusIn}
216
+ >
217
+ {#each top as o, i (o.value)}{@render row(o, i)}{/each}
218
+ {#if top.length && others.length}<li class="sep" role="none"></li>{/if}
219
+ {#each others as o, j (o.value)}{@render row(o, top.length + j)}{/each}
220
+ </ul>
221
+ {:else}
222
+ <p class="empty" id="{uid}-list" role="status">{empty}</p>
223
+ {/if}
224
+ </div>
225
+
226
+ <style>
227
+ .option-list {
228
+ display: flex;
229
+ flex-direction: column;
230
+ min-width: 0;
231
+ min-height: 0;
232
+ }
233
+ /* On the list, not the wrapper: an ancestor of the search field set to none stops Safari typing in it. */
234
+ .list {
235
+ user-select: none;
236
+ margin: 0;
237
+ padding: 4px;
238
+ list-style: none;
239
+ max-height: 296px;
240
+ overflow-y: auto;
241
+ overscroll-behavior: contain;
242
+ }
243
+ .list:focus {
244
+ outline: none;
245
+ }
246
+ /* Check, icon, label, hint; whichever the list has (a column only some rows fill keeps its width on the others). */
247
+ .option {
248
+ display: flex;
249
+ gap: var(--space-2);
250
+ align-items: center;
251
+ min-height: 32px;
252
+ padding: 0 10px 0 8px;
253
+ border-radius: var(--r-sm);
254
+ font-size: 13px;
255
+ font-weight: var(--w-medium);
256
+ color: var(--fg);
257
+ white-space: nowrap;
258
+ }
259
+ /* The keyboard's row shows only while the list is in use (focused or under the pointer), not in a list at rest. */
260
+ .option-list:is(:focus-within, :hover) .option.active {
261
+ background: var(--control-3);
262
+ }
263
+ .list:focus-visible .option.active {
264
+ box-shadow: inset 0 0 0 2px var(--accent);
265
+ }
266
+ /* The check box (Tile's): hidden on rows that are neither ticked nor under the pointer or keyboard, so the column of
267
+ empty boxes doesn't crowd the list; brand-filled with a tick once ticked. */
268
+ .box,
269
+ .tick,
270
+ .lead {
271
+ flex: none;
272
+ width: 16px;
273
+ }
274
+ .box {
275
+ display: grid;
276
+ place-items: center;
277
+ width: 16px;
278
+ height: 16px;
279
+ border: 1px solid var(--faint);
280
+ border-radius: calc(var(--r-sm) - 2px);
281
+ background: var(--control-1);
282
+ color: var(--accent-ink);
283
+ opacity: 0;
284
+ transition:
285
+ opacity var(--dur-fast) var(--ease-out),
286
+ background-color var(--dur) var(--ease-out),
287
+ border-color var(--dur) var(--ease-out);
288
+ }
289
+ .box :global(.icon) {
290
+ opacity: 0;
291
+ scale: 0.5;
292
+ transition:
293
+ opacity var(--dur) var(--ease-out),
294
+ scale var(--dur) var(--ease-out);
295
+ }
296
+ .option-list:is(:focus-within, :hover) .active .box,
297
+ [aria-selected='true'] .box {
298
+ opacity: 1;
299
+ }
300
+ [aria-selected='true'] .box {
301
+ border-color: var(--brand);
302
+ background: var(--brand);
303
+ }
304
+ [aria-selected='true'] .box :global(.icon) {
305
+ opacity: 1;
306
+ scale: 1;
307
+ }
308
+ .tick {
309
+ display: inline-flex;
310
+ color: var(--accent);
311
+ }
312
+ .lead {
313
+ display: inline-flex;
314
+ color: var(--muted);
315
+ }
316
+ .lead[data-tone] {
317
+ color: var(--tone);
318
+ }
319
+ .label {
320
+ flex: 1;
321
+ min-width: 0;
322
+ overflow: clip;
323
+ text-overflow: ellipsis;
324
+ }
325
+ .hint {
326
+ flex: none;
327
+ color: var(--muted);
328
+ font: var(--w-normal) 12px var(--font-data);
329
+ font-variant-numeric: tabular-nums;
330
+ }
331
+ /* Between the ticked rows and the rest: across the whole list, through its padding. */
332
+ .sep {
333
+ height: 1px;
334
+ margin: 4px -4px;
335
+ background: var(--line);
336
+ }
337
+ .empty {
338
+ margin: 0;
339
+ padding: var(--space-3);
340
+ color: var(--muted);
341
+ font-size: 13px;
342
+ }
343
+ @media (forced-colors: active) {
344
+ .box {
345
+ opacity: 1;
346
+ border-color: CanvasText;
347
+ }
348
+ [aria-selected='true'] .box {
349
+ background: Highlight;
350
+ }
351
+ }
352
+ </style>