@lavalogic/scoria 0.39.2 → 0.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 (141) hide show
  1. package/README.md +58 -58
  2. package/dist/Components/AccordionGroup.svelte +46 -46
  3. package/dist/Components/AccordionGroupButton.svelte +76 -76
  4. package/dist/Components/Action.svelte +136 -136
  5. package/dist/Components/AlertModal.svelte +195 -195
  6. package/dist/Components/AppointmentCalendar/AppointmentCalendar.svelte +729 -729
  7. package/dist/Components/Base/BaseModal.svelte +125 -125
  8. package/dist/Components/Base/ContextWrapper.svelte +72 -72
  9. package/dist/Components/Base/Pagination.svelte +198 -198
  10. package/dist/Components/Base/Snippets.svelte +36 -36
  11. package/dist/Components/BigRadioSet.svelte +38 -38
  12. package/dist/Components/Bubble.svelte +101 -101
  13. package/dist/Components/Button.svelte +209 -209
  14. package/dist/Components/Checkbox.svelte +86 -86
  15. package/dist/Components/CollapsibleCard.svelte +78 -78
  16. package/dist/Components/ConditionBuilder/ConditionBuilder.svelte +212 -0
  17. package/dist/Components/ConditionBuilder/ConditionBuilder.svelte.d.ts +25 -0
  18. package/dist/Components/ConditionBuilder/ConditionBuilderProps.d.ts +45 -0
  19. package/dist/Components/ConditionBuilder/ConditionBuilderProps.js +1 -0
  20. package/dist/Components/ConditionBuilder/ConditionTree.d.ts +27 -0
  21. package/dist/Components/ConditionBuilder/ConditionTree.js +9 -0
  22. package/dist/Components/Contexts/ContextMenu.svelte +164 -164
  23. package/dist/Components/Contexts/ContextMenuDivider.svelte +15 -15
  24. package/dist/Components/Contexts/ContextMenuOption.svelte +60 -60
  25. package/dist/Components/Contexts/Toast.svelte +86 -86
  26. package/dist/Components/Contexts/ToastContainer.svelte +65 -65
  27. package/dist/Components/Contexts/Tooltip.svelte +37 -37
  28. package/dist/Components/DataMatrixIcon.svelte +112 -112
  29. package/dist/Components/DateInput.svelte +148 -148
  30. package/dist/Components/DatePicker.svelte +300 -300
  31. package/dist/Components/DesktopModal.svelte +90 -90
  32. package/dist/Components/Dial.svelte +204 -204
  33. package/dist/Components/DimensionInput.svelte +170 -170
  34. package/dist/Components/DragMenu/DragMenuHolder.svelte +119 -119
  35. package/dist/Components/DragMenu/DraggableCard.svelte +77 -77
  36. package/dist/Components/FileCard.svelte +24 -24
  37. package/dist/Components/FileUpload.svelte +236 -236
  38. package/dist/Components/GridInput.svelte +196 -196
  39. package/dist/Components/GridInputSet.svelte +29 -29
  40. package/dist/Components/HorizontalTabGroup.svelte +82 -82
  41. package/dist/Components/HorizontalTabGroupButton.svelte +44 -44
  42. package/dist/Components/Icon.svelte +128 -128
  43. package/dist/Components/Icons.js +357 -357
  44. package/dist/Components/InfoAlert.svelte +35 -35
  45. package/dist/Components/LoadingAnimation.svelte +29 -29
  46. package/dist/Components/LoadingModal.svelte +45 -45
  47. package/dist/Components/LoadingOverlay.svelte +25 -25
  48. package/dist/Components/Modal.svelte +258 -258
  49. package/dist/Components/MultiSelect.svelte +220 -220
  50. package/dist/Components/Nav/Nav.svelte +110 -110
  51. package/dist/Components/Nav/NavServiceMenuList.svelte +43 -43
  52. package/dist/Components/Nav/NavTab.svelte +62 -62
  53. package/dist/Components/Nav/ServiceMenuItem.svelte +112 -112
  54. package/dist/Components/Nav/ServicesNav.svelte +80 -80
  55. package/dist/Components/NumberInput.svelte +157 -157
  56. package/dist/Components/PageHeading.svelte +25 -25
  57. package/dist/Components/PasswordInput.svelte +88 -88
  58. package/dist/Components/Portal.svelte +36 -36
  59. package/dist/Components/ProgressBubble.svelte +107 -107
  60. package/dist/Components/QuerySelect.svelte +366 -366
  61. package/dist/Components/SingleSelect.svelte +250 -250
  62. package/dist/Components/StepButton.svelte +70 -70
  63. package/dist/Components/StepForm.svelte +140 -140
  64. package/dist/Components/Switch.svelte +69 -69
  65. package/dist/Components/Table/ARCHITECTURE.md +298 -298
  66. package/dist/Components/Table/Body/QuickSearchCell.svelte +679 -679
  67. package/dist/Components/Table/Body/Rows/ColumnHighlight.svelte +51 -51
  68. package/dist/Components/Table/Body/Rows/ColumnList.svelte +59 -59
  69. package/dist/Components/Table/Body/Rows/ColumnListRow.svelte +454 -454
  70. package/dist/Components/Table/Body/Rows/Columns/AccessorComponent.svelte +79 -79
  71. package/dist/Components/Table/Body/Rows/Columns/ActionsCell.svelte +185 -185
  72. package/dist/Components/Table/Body/Rows/Columns/BubbleCell.svelte +124 -124
  73. package/dist/Components/Table/Body/Rows/Columns/ExpandCell.svelte +120 -120
  74. package/dist/Components/Table/Body/Rows/Columns/FocusableImmutableCell.svelte +234 -234
  75. package/dist/Components/Table/Body/Rows/Columns/ProgressCell.svelte +105 -105
  76. package/dist/Components/Table/Body/Rows/Columns/TableAction.svelte +87 -87
  77. package/dist/Components/Table/Body/Rows/Columns/TableCheckbox.svelte +126 -126
  78. package/dist/Components/Table/Body/Rows/Columns/TableColumn.svelte +159 -159
  79. package/dist/Components/Table/Body/Rows/Columns/TableDatePicker.svelte +246 -246
  80. package/dist/Components/Table/Body/Rows/Columns/TableNumberInput.svelte +216 -216
  81. package/dist/Components/Table/Body/Rows/Columns/TableQuerySelect.svelte +252 -252
  82. package/dist/Components/Table/Body/Rows/Columns/TableRowSelectionCheckbox.svelte +179 -179
  83. package/dist/Components/Table/Body/Rows/Columns/TableSelect.svelte +221 -221
  84. package/dist/Components/Table/Body/Rows/Columns/TableTextInput.svelte +197 -197
  85. package/dist/Components/Table/Body/Rows/Columns/ValidityCell.svelte +190 -190
  86. package/dist/Components/Table/Body/Rows/TableRow.svelte +290 -290
  87. package/dist/Components/Table/Body/TableBody.svelte +155 -155
  88. package/dist/Components/Table/Headers/HighlightAllHeader.svelte +41 -41
  89. package/dist/Components/Table/Headers/SelectAllHeader.svelte +30 -30
  90. package/dist/Components/Table/Headers/TableHead.svelte +415 -415
  91. package/dist/Components/Table/Misc/ColumnPanel.svelte +39 -39
  92. package/dist/Components/Table/Misc/ColumnPanelModal.svelte +39 -39
  93. package/dist/Components/Table/Misc/FilterInput.svelte +641 -641
  94. package/dist/Components/Table/Misc/FilterPanel.svelte +190 -190
  95. package/dist/Components/Table/Misc/FilterPanelModal.svelte +31 -31
  96. package/dist/Components/Table/Misc/ShareViewModal.svelte +291 -291
  97. package/dist/Components/Table/Misc/SidePanel.svelte +35 -35
  98. package/dist/Components/Table/Misc/TableConfigurationModal.svelte +644 -644
  99. package/dist/Components/Table/Misc/TableFooter.svelte +340 -340
  100. package/dist/Components/Table/Misc/TableHorizontalBar.svelte +140 -140
  101. package/dist/Components/Table/Misc/TableSidebar.svelte +200 -200
  102. package/dist/Components/Table/Misc/TableViewDropdown.svelte +105 -105
  103. package/dist/Components/Table/Misc/ToolboxPanel.svelte +100 -100
  104. package/dist/Components/Table/Misc/ToolboxPanelModal.svelte +107 -107
  105. package/dist/Components/Table/Misc/UpdateViewOptionsModal.svelte +192 -192
  106. package/dist/Components/Table/NestedTable.svelte +130 -130
  107. package/dist/Components/Table/Table.svelte +692 -692
  108. package/dist/Components/Test/TestContextConsumer.svelte +13 -13
  109. package/dist/Components/TextArea.svelte +130 -130
  110. package/dist/Components/TextInput.svelte +176 -176
  111. package/dist/Components/ThreeStateRadio.svelte +131 -131
  112. package/dist/Components/Touch/BoolCard.svelte +45 -45
  113. package/dist/Components/Touch/DateModal.svelte +209 -209
  114. package/dist/Components/Touch/EditCard.svelte +59 -59
  115. package/dist/Components/Touch/InfoCard.svelte +31 -31
  116. package/dist/Components/Touch/InfoTextCard.svelte +28 -28
  117. package/dist/Components/Touch/ModalExplanation.svelte +17 -17
  118. package/dist/Components/Touch/NumberKeyboard.svelte +225 -225
  119. package/dist/Components/Touch/NumberModal.svelte +79 -79
  120. package/dist/Components/Touch/PlusMinusCard.svelte +46 -46
  121. package/dist/Components/Touch/SelectModal.svelte +127 -127
  122. package/dist/Components/Touch/SummaryCard.svelte +93 -93
  123. package/dist/Components/Touch/TextAreaModal.svelte +95 -95
  124. package/dist/Components/Touch/TextModal.svelte +106 -106
  125. package/dist/Components/Touch/TouchCard.svelte +33 -33
  126. package/dist/Components/Touch/TouchModal.svelte +274 -274
  127. package/dist/Components/Touch/UtilityButton.svelte +109 -109
  128. package/dist/Components/VerticalTabGroup.svelte +79 -79
  129. package/dist/Components/VerticalTabGroupButton.svelte +58 -58
  130. package/dist/Helpers/Datamatrix.d.ts +19 -19
  131. package/dist/Helpers/Datamatrix.js +291 -291
  132. package/dist/Types/Examples/ExampleModal.svelte +35 -35
  133. package/dist/index.d.ts +3 -0
  134. package/dist/index.js +2 -0
  135. package/dist/scss/_basics.scss +12 -12
  136. package/dist/scss/_colours.scss +134 -134
  137. package/dist/scss/_mixins.scss +3392 -3392
  138. package/dist/scss/_motion.scss +57 -57
  139. package/dist/scss/_sizing.scss +85 -85
  140. package/dist/scss/_transitions.scss +8 -8
  141. package/package.json +1 -1
@@ -1,417 +1,417 @@
1
- <svelte:options runes />
2
-
3
- <script
4
- module
5
- lang="ts"
6
- >
7
- import Icon from '../../Icon.svelte';
8
- import { TooltipContext } from '../../../Contexts/TooltipContext.svelte.js';
9
- import { Delay } from '../../../Delay/Delay.js';
10
- import { Colour } from '../../../scss/colours.js';
11
- import { Side } from '../../../Types/Internal/Side.js';
12
- import { Size } from '../../../Types/Internal/Size.js';
13
- import { Variant } from '../../../Types/Internal/Variant.js';
14
- import { getContext } from 'svelte';
15
- import type { ColumnDef } from '../Types/Columns/Definitions/ColumnDef.svelte.js';
16
- import { ExpandDef } from '../Types/Columns/Definitions/Expand/ExpandDef.svelte.js';
17
- import { RowSelectionDef } from '../Types/Columns/Definitions/RowSelection/RowSelectionDef.svelte.js';
18
- import { TableContext } from '../Types/Context/TableContext.svelte.js';
19
- import type { Primitive } from '../Types/Context/TableInitOptions.js';
20
- import type { Header } from '../Types/Header.js';
21
-
22
- /** Local alias: scoria's headers never carry custom filter generics here. */
23
- type AnyHeader<T extends object> = Header<T, never>;
24
- import HighlightAllHeader from './HighlightAllHeader.svelte';
25
- import SelectAllHeader from './SelectAllHeader.svelte';
26
- import type { TableHeadProps } from './TableHeadProps.js';
27
-
28
- /** Per-column toggle queue. The header onclick funnels through this so
29
- * multiple clicks inside the debounce window stack and apply on a
30
- * single timer flush. A fast double-click thus cycles straight to
31
- * desc (or clear-sort) without waiting for the asc state to apply and
32
- * reload data first. ~150 ms is below the perceived-latency threshold
33
- * while still wide enough to batch dblclicks. */
34
- const SORT_DEBOUNCE_MS = 150;
35
- const sortDebounce = new WeakMap<
36
- object,
37
- { count: number; timer: ReturnType<typeof setTimeout> | null }
38
- >();
39
- function debouncedSortToggle(
40
- columnRef: object,
41
- // `never[]` rest sidesteps TypeScript's strict-function-type
42
- // contravariance: any concrete handler signature (e.g. the
43
- // MouseEvent-typed one tanstack returns) is assignable here, and
44
- // the body never passes any args.
45
- handler: ((...args: never[]) => void) | undefined
46
- ): void {
47
- if (!handler) {
48
- return;
49
- }
50
- let entry = sortDebounce.get(columnRef);
51
- if (!entry) {
52
- entry = { count: 0, timer: null };
53
- sortDebounce.set(columnRef, entry);
54
- }
55
- entry.count += 1;
56
- if (entry.timer != null) {
57
- clearTimeout(entry.timer);
58
- }
59
- entry.timer = setTimeout(() => {
60
- const toFire = entry!.count;
61
- entry!.count = 0;
62
- entry!.timer = null;
63
- for (let i = 0; i < toFire; i++) {
64
- handler();
65
- }
66
- }, SORT_DEBOUNCE_MS);
67
- }
68
- </script>
69
-
70
- <script
71
- lang="ts"
72
- generics="T extends object, IdType extends Primitive"
73
- >
74
- const { oncontextmenu }: TableHeadProps = $props();
75
-
76
- const tableContext = getContext<TableContext<T, IdType>>(TableContext.identifier);
77
- const tooltipContext = getContext<TooltipContext>(TooltipContext.identifier);
78
-
79
- const leftHeaders: Array<AnyHeader<T>> = $derived.by(() => {
80
- void tableContext.table.columnVisibility;
81
- void tableContext.table.columnPinning.left?.size;
82
- void tableContext.table.columnPinning.right?.size;
83
- return tableContext.table.getLeftHeaderGroups().flatMap((it) => it.headers);
84
- });
85
-
86
- const centreHeaders: Array<AnyHeader<T>> = $derived.by(() => {
87
- void tableContext.table.columnVisibility;
88
- void tableContext.table.columnPinning.left?.size;
89
- void tableContext.table.columnPinning.right?.size;
90
- return tableContext.table.getCenterHeaderGroups().flatMap((it) => it.headers);
91
- });
92
-
93
- const rightHeaders: Array<AnyHeader<T>> = $derived.by(() => {
94
- void tableContext.table.columnVisibility;
95
- void tableContext.table.columnPinning.left?.size;
96
- void tableContext.table.columnPinning.right?.size;
97
- return tableContext.table.getRightHeaderGroups().flatMap((it) => it.headers);
98
- });
99
-
100
- // Cumulative pinning offsets for sticky-positioned cells. Each
101
- // pinned-left cell anchors to `left: (sum of preceding pinned-left
102
- // widths)`; pinned-right cells anchor to `right: (sum of following
103
- // pinned-right widths)`. Recomputed on resize-handle drag and
104
- // column-sizing reset.
105
- //
106
- // Rendered widths come from the shared context map populated by the
107
- // ResizeObserver below. The `header.getSize()` fallback (declared
108
- // width) covers the first frame before the observer fires.
109
- function renderedWidth(columnId: string, declared: number): number {
110
- return tableContext._columnRenderedWidths.get(columnId) ?? declared;
111
- }
112
-
113
- // Single ResizeObserver shared across all header cells. Each
114
- // `<div role="columnheader">` registers via the `observeHeader`
115
- // attachment; the callback writes the cell's rendered inline-size
116
- // into `_columnRenderedWidths` so TableRow / TableHead / TableBody
117
- // can read accurate sticky pinning offsets.
118
- // eslint-disable-next-line svelte/prefer-svelte-reactivity
119
- const elementToColumnId = new WeakMap<Element, string>();
120
- const headerObserver =
121
- typeof ResizeObserver === 'undefined'
122
- ? null
123
- : new ResizeObserver((entries) => {
124
- for (const entry of entries) {
125
- const columnId = elementToColumnId.get(entry.target);
126
- if (columnId == null) {
127
- continue;
128
- }
129
- const inlineSize = entry.borderBoxSize[0]?.inlineSize ?? entry.contentRect.width;
130
- tableContext._columnRenderedWidths.set(columnId, inlineSize);
131
- }
132
- });
133
-
134
- $effect(() => () => {
135
- headerObserver?.disconnect();
136
- });
137
-
138
- function observeHeader(node: HTMLElement, columnId: string): () => void {
139
- if (!headerObserver) {
140
- return () => {};
141
- }
142
- elementToColumnId.set(node, columnId);
143
- headerObserver.observe(node);
144
- return () => {
145
- headerObserver.unobserve(node);
146
- elementToColumnId.delete(node);
147
- tableContext._columnRenderedWidths.delete(columnId);
148
- };
149
- }
150
-
151
- const leftOffsets: Array<number> = $derived.by(() => {
152
- void tableContext._columnRenderedWidths.size;
153
- const offsets: Array<number> = [];
154
- // Highlight column is 20px wide and the first pinned-left cell
155
- // when present, so subsequent pinned-left headers offset past it.
156
- let cumulative = showHighlightColumn ? 20 : 0;
157
- for (const header of leftHeaders) {
158
- offsets.push(cumulative);
159
- cumulative += renderedWidth(header.column.id, header.getSize());
160
- }
161
- return offsets;
162
- });
163
-
164
- const rightOffsets: Array<number> = $derived.by(() => {
165
- void tableContext._columnRenderedWidths.size;
166
- const offsets = new Array<number>(rightHeaders.length).fill(0);
167
- let cumulative = 0;
168
- for (let i = rightHeaders.length - 1; i >= 0; i--) {
169
- offsets[i] = cumulative;
170
- cumulative += renderedWidth(rightHeaders[i].column.id, rightHeaders[i].getSize());
171
- }
172
- return offsets;
173
- });
174
-
175
- const showHighlightColumn = $derived(
176
- leftHeaders.length > 0 || centreHeaders.length > 0 || rightHeaders.length > 0
177
- );
178
-
179
- const iconNames = {
180
- asc: 'sort-asc',
181
- desc: 'sort-desc',
182
- none: 'sort-none',
183
- } as const;
184
-
185
- let currentDropTarget: HTMLElement | null = $state(null);
186
-
187
- function setCurrentDropTarget(target: EventTarget | null) {
188
- currentDropTarget = target as HTMLElement | null;
189
- }
190
-
191
- function showtooltip(e: MouseEvent, columnDef: ColumnDef<T>): void {
192
- if (columnDef instanceof ExpandDef) {
193
- const rect = (e.target as HTMLElement)
194
- .closest('[role="columnheader"]')
195
- ?.getBoundingClientRect();
196
-
197
- if (!rect) {
198
- console.warn('could not find closest columnheader');
199
-
200
- return;
201
- }
202
-
203
- tooltipContext.showTooltip({
204
- text: `Show ${typeof columnDef.header === 'string' ? columnDef.header : columnDef.id}`,
205
- arrow: Side.Bottom,
206
- delay: Delay.Default,
207
- rect,
208
- });
209
- }
210
- }
211
-
212
- function hideTooltip(columnDef: ColumnDef<T>): void {
213
- if (columnDef instanceof ExpandDef) {
214
- tooltipContext.hideTooltip(
215
- `Show ${typeof columnDef.header === 'string' ? columnDef.header : columnDef.id}`
216
- );
217
- }
218
- }
219
-
220
- function onDrop() {
221
- if (!tableContext.dragTarget) {
222
- return;
223
- }
224
-
225
- const dropTarget = currentDropTarget?.closest<HTMLElement>('[role="columnheader"]');
226
-
227
- if (dropTarget) {
228
- tableContext.reorderColumn(dropTarget);
229
- }
230
-
231
- currentDropTarget = null;
232
- }
233
-
234
- function ariaSort(state: 'asc' | 'desc' | 'none'): 'ascending' | 'descending' | 'none' {
235
- if (state === 'asc') {
236
- return 'ascending';
237
- }
238
- if (state === 'desc') {
239
- return 'descending';
240
- }
241
- return 'none';
242
- }
243
-
244
- function setDragTarget(def: ColumnDef<T>) {
245
- tableContext.dragTarget = def;
246
- }
247
-
248
- const currentDropTargetId = $derived(
249
- (currentDropTarget as HTMLElement | null | undefined)?.closest('[role="columnheader"]')?.id
250
- );
251
- </script>
252
-
253
- <div
254
- role="rowgroup"
255
- class="datatable-header"
256
- {oncontextmenu}
257
- >
258
- <div
259
- role="row"
260
- class="datatable-row header-row"
261
- >
262
- {#if showHighlightColumn}
263
- <div
264
- role="columnheader"
265
- id="highlight-header"
266
- class="cell header highlight-column pinned-left"
267
- style="left: 0px"
268
- >
269
- <div class="th">
270
- <HighlightAllHeader />
271
- </div>
272
- </div>
273
- {/if}
274
-
275
- {#each leftHeaders as header, index (header.id)}
276
- <!-- eslint-disable-next-line @typescript-eslint/no-confusing-void-expression -->
277
- {@render headerCell(header, 'left', leftOffsets[index])}
278
- {/each}
279
- {#each centreHeaders as header (header.id)}
280
- <!-- eslint-disable-next-line @typescript-eslint/no-confusing-void-expression -->
281
- {@render headerCell(header, undefined, 0)}
282
- {/each}
283
- {#each rightHeaders as header, index (header.id)}
284
- <!-- eslint-disable-next-line @typescript-eslint/no-confusing-void-expression -->
285
- {@render headerCell(header, 'right', rightOffsets[index])}
286
- {/each}
287
- </div>
288
- </div>
289
-
290
- {#snippet headerCell(header: AnyHeader<T>, side: 'left' | 'right' | undefined, offset: number)}
291
- {@const headerId = `${tableContext.tableName}-header-${header.id}`}
292
- <!-- svelte-ignore a11y_interactive_supports_focus -->
293
- <div
294
- role="columnheader"
295
- id={headerId}
296
- {@attach (node: HTMLElement) => observeHeader(node, header.column.id)}
297
- draggable={tableContext.allowColumnReordering}
298
- class="cell header"
299
- class:pinned-left={side === 'left'}
300
- class:pinned-right={side === 'right'}
301
- class:action-column={!header.column.getCanSort()}
302
- class:targeted={currentDropTargetId === headerId}
303
- style:left={side === 'left' ? `${offset}px` : null}
304
- style:right={side === 'right' ? `${offset}px` : null}
305
- aria-sort={header.column.getCanSort() ? ariaSort(header.column.getIsSorted()) : undefined}
306
- ondragstart={() => {
307
- setDragTarget(header.column.columnDef);
308
- }}
309
- ondragover={(e) => {
310
- e.preventDefault();
311
- if (tableContext.dragTarget?.id !== header.id) {
312
- setCurrentDropTarget(e.target);
313
- } else {
314
- setCurrentDropTarget(null);
315
- }
316
- }}
317
- ondrop={onDrop}
318
- >
319
- {#if !header.isPlaceholder}
320
- <div class="margin-right">
321
- {#if header.column.getCanSort()}
322
- <button
323
- onmouseenter={(e) => {
324
- showtooltip(e, header.column.columnDef);
325
- }}
326
- onmouseleave={() => {
327
- hideTooltip(header.column.columnDef);
328
- }}
329
- class="contents"
330
- onclick={() => debouncedSortToggle(header.column, header.column.getToggleSortingHandler())}
331
- >
332
- <div class="th cursor-pointer select-none">
333
- <div class="header-text-wrapper">
334
- {#if header.column.columnDef instanceof RowSelectionDef}
335
- <SelectAllHeader />
336
- {:else}
337
- {#if header.column.columnDef instanceof ExpandDef}
338
- <Icon
339
- name={header.column.columnDef.headerIcon}
340
- colour={Colour['$font-primary']}
341
- />
342
- {:else if typeof header.column.columnDef.header == 'string'}
343
- {header.column.columnDef.header}
344
- {:else}
345
- {@render header.column.columnDef.header()}
346
- {/if}
347
- <Icon
348
- variant={Variant.HeaderIcon}
349
- size={Size.Medium}
350
- name={iconNames[header.column.getIsSorted()]}
351
- />
352
- {/if}
353
- </div>
354
- </div>
355
- </button>
356
- {:else}
357
- {@const isRowSelect = header.column.columnDef instanceof RowSelectionDef}
358
- <!-- svelte-ignore a11y_no_static_element_interactions -->
359
- <div
360
- onmouseenter={(e) => {
361
- showtooltip(e, header.column.columnDef);
362
- }}
363
- onmouseleave={() => {
364
- hideTooltip(header.column.columnDef);
365
- }}
366
- class="contents"
367
- >
368
- <div
369
- class="th"
370
- class:nopadding={isRowSelect}
371
- >
372
- <div class="header-text-wrapper no-sort cursor-pointer select-none">
373
- {#if isRowSelect}
374
- <SelectAllHeader />
375
- {:else if header.column.columnDef instanceof ExpandDef}
376
- <Icon
377
- name={header.column.columnDef.headerIcon}
378
- colour={Colour['$font-primary']}
379
- />
380
- {:else if typeof header.column.columnDef.header == 'string'}
381
- {header.column.columnDef.header}
382
- {:else}
383
- {@render header.column.columnDef.header()}
384
- {/if}
385
- </div>
386
- </div>
387
- </div>
388
- {/if}
389
-
390
- {#if tableContext.enableResize}
391
- <!-- svelte-ignore a11y_no_static_element_interactions -->
392
- <div
393
- onmousedown={(e) => {
394
- e.preventDefault();
395
- e.stopImmediatePropagation();
396
- const handler = header.getResizeHandler();
397
- handler(e);
398
- }}
399
- ondblclick={() => {
400
- // Reset the column to its factory-default width and
401
- // clear the user-resized flag so the grid track
402
- // returns to its original `minmax(W, 1fr)` or
403
- // fixed-`${W}px` branch.
404
- header.column.columnDef.resetWidth();
405
- }}
406
- class="resizer right"
407
- class:isResizing={header.column.getIsResizing()}
408
- ></div>
409
- {/if}
410
- </div>
411
- {/if}
412
- </div>
413
- {/snippet}
414
-
1
+ <svelte:options runes />
2
+
3
+ <script
4
+ module
5
+ lang="ts"
6
+ >
7
+ import Icon from '../../Icon.svelte';
8
+ import { TooltipContext } from '../../../Contexts/TooltipContext.svelte.js';
9
+ import { Delay } from '../../../Delay/Delay.js';
10
+ import { Colour } from '../../../scss/colours.js';
11
+ import { Side } from '../../../Types/Internal/Side.js';
12
+ import { Size } from '../../../Types/Internal/Size.js';
13
+ import { Variant } from '../../../Types/Internal/Variant.js';
14
+ import { getContext } from 'svelte';
15
+ import type { ColumnDef } from '../Types/Columns/Definitions/ColumnDef.svelte.js';
16
+ import { ExpandDef } from '../Types/Columns/Definitions/Expand/ExpandDef.svelte.js';
17
+ import { RowSelectionDef } from '../Types/Columns/Definitions/RowSelection/RowSelectionDef.svelte.js';
18
+ import { TableContext } from '../Types/Context/TableContext.svelte.js';
19
+ import type { Primitive } from '../Types/Context/TableInitOptions.js';
20
+ import type { Header } from '../Types/Header.js';
21
+
22
+ /** Local alias: scoria's headers never carry custom filter generics here. */
23
+ type AnyHeader<T extends object> = Header<T, never>;
24
+ import HighlightAllHeader from './HighlightAllHeader.svelte';
25
+ import SelectAllHeader from './SelectAllHeader.svelte';
26
+ import type { TableHeadProps } from './TableHeadProps.js';
27
+
28
+ /** Per-column toggle queue. The header onclick funnels through this so
29
+ * multiple clicks inside the debounce window stack and apply on a
30
+ * single timer flush. A fast double-click thus cycles straight to
31
+ * desc (or clear-sort) without waiting for the asc state to apply and
32
+ * reload data first. ~150 ms is below the perceived-latency threshold
33
+ * while still wide enough to batch dblclicks. */
34
+ const SORT_DEBOUNCE_MS = 150;
35
+ const sortDebounce = new WeakMap<
36
+ object,
37
+ { count: number; timer: ReturnType<typeof setTimeout> | null }
38
+ >();
39
+ function debouncedSortToggle(
40
+ columnRef: object,
41
+ // `never[]` rest sidesteps TypeScript's strict-function-type
42
+ // contravariance: any concrete handler signature (e.g. the
43
+ // MouseEvent-typed one tanstack returns) is assignable here, and
44
+ // the body never passes any args.
45
+ handler: ((...args: never[]) => void) | undefined
46
+ ): void {
47
+ if (!handler) {
48
+ return;
49
+ }
50
+ let entry = sortDebounce.get(columnRef);
51
+ if (!entry) {
52
+ entry = { count: 0, timer: null };
53
+ sortDebounce.set(columnRef, entry);
54
+ }
55
+ entry.count += 1;
56
+ if (entry.timer != null) {
57
+ clearTimeout(entry.timer);
58
+ }
59
+ entry.timer = setTimeout(() => {
60
+ const toFire = entry!.count;
61
+ entry!.count = 0;
62
+ entry!.timer = null;
63
+ for (let i = 0; i < toFire; i++) {
64
+ handler();
65
+ }
66
+ }, SORT_DEBOUNCE_MS);
67
+ }
68
+ </script>
69
+
70
+ <script
71
+ lang="ts"
72
+ generics="T extends object, IdType extends Primitive"
73
+ >
74
+ const { oncontextmenu }: TableHeadProps = $props();
75
+
76
+ const tableContext = getContext<TableContext<T, IdType>>(TableContext.identifier);
77
+ const tooltipContext = getContext<TooltipContext>(TooltipContext.identifier);
78
+
79
+ const leftHeaders: Array<AnyHeader<T>> = $derived.by(() => {
80
+ void tableContext.table.columnVisibility;
81
+ void tableContext.table.columnPinning.left?.size;
82
+ void tableContext.table.columnPinning.right?.size;
83
+ return tableContext.table.getLeftHeaderGroups().flatMap((it) => it.headers);
84
+ });
85
+
86
+ const centreHeaders: Array<AnyHeader<T>> = $derived.by(() => {
87
+ void tableContext.table.columnVisibility;
88
+ void tableContext.table.columnPinning.left?.size;
89
+ void tableContext.table.columnPinning.right?.size;
90
+ return tableContext.table.getCenterHeaderGroups().flatMap((it) => it.headers);
91
+ });
92
+
93
+ const rightHeaders: Array<AnyHeader<T>> = $derived.by(() => {
94
+ void tableContext.table.columnVisibility;
95
+ void tableContext.table.columnPinning.left?.size;
96
+ void tableContext.table.columnPinning.right?.size;
97
+ return tableContext.table.getRightHeaderGroups().flatMap((it) => it.headers);
98
+ });
99
+
100
+ // Cumulative pinning offsets for sticky-positioned cells. Each
101
+ // pinned-left cell anchors to `left: (sum of preceding pinned-left
102
+ // widths)`; pinned-right cells anchor to `right: (sum of following
103
+ // pinned-right widths)`. Recomputed on resize-handle drag and
104
+ // column-sizing reset.
105
+ //
106
+ // Rendered widths come from the shared context map populated by the
107
+ // ResizeObserver below. The `header.getSize()` fallback (declared
108
+ // width) covers the first frame before the observer fires.
109
+ function renderedWidth(columnId: string, declared: number): number {
110
+ return tableContext._columnRenderedWidths.get(columnId) ?? declared;
111
+ }
112
+
113
+ // Single ResizeObserver shared across all header cells. Each
114
+ // `<div role="columnheader">` registers via the `observeHeader`
115
+ // attachment; the callback writes the cell's rendered inline-size
116
+ // into `_columnRenderedWidths` so TableRow / TableHead / TableBody
117
+ // can read accurate sticky pinning offsets.
118
+ // eslint-disable-next-line svelte/prefer-svelte-reactivity
119
+ const elementToColumnId = new WeakMap<Element, string>();
120
+ const headerObserver =
121
+ typeof ResizeObserver === 'undefined'
122
+ ? null
123
+ : new ResizeObserver((entries) => {
124
+ for (const entry of entries) {
125
+ const columnId = elementToColumnId.get(entry.target);
126
+ if (columnId == null) {
127
+ continue;
128
+ }
129
+ const inlineSize = entry.borderBoxSize[0]?.inlineSize ?? entry.contentRect.width;
130
+ tableContext._columnRenderedWidths.set(columnId, inlineSize);
131
+ }
132
+ });
133
+
134
+ $effect(() => () => {
135
+ headerObserver?.disconnect();
136
+ });
137
+
138
+ function observeHeader(node: HTMLElement, columnId: string): () => void {
139
+ if (!headerObserver) {
140
+ return () => {};
141
+ }
142
+ elementToColumnId.set(node, columnId);
143
+ headerObserver.observe(node);
144
+ return () => {
145
+ headerObserver.unobserve(node);
146
+ elementToColumnId.delete(node);
147
+ tableContext._columnRenderedWidths.delete(columnId);
148
+ };
149
+ }
150
+
151
+ const leftOffsets: Array<number> = $derived.by(() => {
152
+ void tableContext._columnRenderedWidths.size;
153
+ const offsets: Array<number> = [];
154
+ // Highlight column is 20px wide and the first pinned-left cell
155
+ // when present, so subsequent pinned-left headers offset past it.
156
+ let cumulative = showHighlightColumn ? 20 : 0;
157
+ for (const header of leftHeaders) {
158
+ offsets.push(cumulative);
159
+ cumulative += renderedWidth(header.column.id, header.getSize());
160
+ }
161
+ return offsets;
162
+ });
163
+
164
+ const rightOffsets: Array<number> = $derived.by(() => {
165
+ void tableContext._columnRenderedWidths.size;
166
+ const offsets = new Array<number>(rightHeaders.length).fill(0);
167
+ let cumulative = 0;
168
+ for (let i = rightHeaders.length - 1; i >= 0; i--) {
169
+ offsets[i] = cumulative;
170
+ cumulative += renderedWidth(rightHeaders[i].column.id, rightHeaders[i].getSize());
171
+ }
172
+ return offsets;
173
+ });
174
+
175
+ const showHighlightColumn = $derived(
176
+ leftHeaders.length > 0 || centreHeaders.length > 0 || rightHeaders.length > 0
177
+ );
178
+
179
+ const iconNames = {
180
+ asc: 'sort-asc',
181
+ desc: 'sort-desc',
182
+ none: 'sort-none',
183
+ } as const;
184
+
185
+ let currentDropTarget: HTMLElement | null = $state(null);
186
+
187
+ function setCurrentDropTarget(target: EventTarget | null) {
188
+ currentDropTarget = target as HTMLElement | null;
189
+ }
190
+
191
+ function showtooltip(e: MouseEvent, columnDef: ColumnDef<T>): void {
192
+ if (columnDef instanceof ExpandDef) {
193
+ const rect = (e.target as HTMLElement)
194
+ .closest('[role="columnheader"]')
195
+ ?.getBoundingClientRect();
196
+
197
+ if (!rect) {
198
+ console.warn('could not find closest columnheader');
199
+
200
+ return;
201
+ }
202
+
203
+ tooltipContext.showTooltip({
204
+ text: `Show ${typeof columnDef.header === 'string' ? columnDef.header : columnDef.id}`,
205
+ arrow: Side.Bottom,
206
+ delay: Delay.Default,
207
+ rect,
208
+ });
209
+ }
210
+ }
211
+
212
+ function hideTooltip(columnDef: ColumnDef<T>): void {
213
+ if (columnDef instanceof ExpandDef) {
214
+ tooltipContext.hideTooltip(
215
+ `Show ${typeof columnDef.header === 'string' ? columnDef.header : columnDef.id}`
216
+ );
217
+ }
218
+ }
219
+
220
+ function onDrop() {
221
+ if (!tableContext.dragTarget) {
222
+ return;
223
+ }
224
+
225
+ const dropTarget = currentDropTarget?.closest<HTMLElement>('[role="columnheader"]');
226
+
227
+ if (dropTarget) {
228
+ tableContext.reorderColumn(dropTarget);
229
+ }
230
+
231
+ currentDropTarget = null;
232
+ }
233
+
234
+ function ariaSort(state: 'asc' | 'desc' | 'none'): 'ascending' | 'descending' | 'none' {
235
+ if (state === 'asc') {
236
+ return 'ascending';
237
+ }
238
+ if (state === 'desc') {
239
+ return 'descending';
240
+ }
241
+ return 'none';
242
+ }
243
+
244
+ function setDragTarget(def: ColumnDef<T>) {
245
+ tableContext.dragTarget = def;
246
+ }
247
+
248
+ const currentDropTargetId = $derived(
249
+ (currentDropTarget as HTMLElement | null | undefined)?.closest('[role="columnheader"]')?.id
250
+ );
251
+ </script>
252
+
253
+ <div
254
+ role="rowgroup"
255
+ class="datatable-header"
256
+ {oncontextmenu}
257
+ >
258
+ <div
259
+ role="row"
260
+ class="datatable-row header-row"
261
+ >
262
+ {#if showHighlightColumn}
263
+ <div
264
+ role="columnheader"
265
+ id="highlight-header"
266
+ class="cell header highlight-column pinned-left"
267
+ style="left: 0px"
268
+ >
269
+ <div class="th">
270
+ <HighlightAllHeader />
271
+ </div>
272
+ </div>
273
+ {/if}
274
+
275
+ {#each leftHeaders as header, index (header.id)}
276
+ <!-- eslint-disable-next-line @typescript-eslint/no-confusing-void-expression -->
277
+ {@render headerCell(header, 'left', leftOffsets[index])}
278
+ {/each}
279
+ {#each centreHeaders as header (header.id)}
280
+ <!-- eslint-disable-next-line @typescript-eslint/no-confusing-void-expression -->
281
+ {@render headerCell(header, undefined, 0)}
282
+ {/each}
283
+ {#each rightHeaders as header, index (header.id)}
284
+ <!-- eslint-disable-next-line @typescript-eslint/no-confusing-void-expression -->
285
+ {@render headerCell(header, 'right', rightOffsets[index])}
286
+ {/each}
287
+ </div>
288
+ </div>
289
+
290
+ {#snippet headerCell(header: AnyHeader<T>, side: 'left' | 'right' | undefined, offset: number)}
291
+ {@const headerId = `${tableContext.tableName}-header-${header.id}`}
292
+ <!-- svelte-ignore a11y_interactive_supports_focus -->
293
+ <div
294
+ role="columnheader"
295
+ id={headerId}
296
+ {@attach (node: HTMLElement) => observeHeader(node, header.column.id)}
297
+ draggable={tableContext.allowColumnReordering}
298
+ class="cell header"
299
+ class:pinned-left={side === 'left'}
300
+ class:pinned-right={side === 'right'}
301
+ class:action-column={!header.column.getCanSort()}
302
+ class:targeted={currentDropTargetId === headerId}
303
+ style:left={side === 'left' ? `${offset}px` : null}
304
+ style:right={side === 'right' ? `${offset}px` : null}
305
+ aria-sort={header.column.getCanSort() ? ariaSort(header.column.getIsSorted()) : undefined}
306
+ ondragstart={() => {
307
+ setDragTarget(header.column.columnDef);
308
+ }}
309
+ ondragover={(e) => {
310
+ e.preventDefault();
311
+ if (tableContext.dragTarget?.id !== header.id) {
312
+ setCurrentDropTarget(e.target);
313
+ } else {
314
+ setCurrentDropTarget(null);
315
+ }
316
+ }}
317
+ ondrop={onDrop}
318
+ >
319
+ {#if !header.isPlaceholder}
320
+ <div class="margin-right">
321
+ {#if header.column.getCanSort()}
322
+ <button
323
+ onmouseenter={(e) => {
324
+ showtooltip(e, header.column.columnDef);
325
+ }}
326
+ onmouseleave={() => {
327
+ hideTooltip(header.column.columnDef);
328
+ }}
329
+ class="contents"
330
+ onclick={() => debouncedSortToggle(header.column, header.column.getToggleSortingHandler())}
331
+ >
332
+ <div class="th cursor-pointer select-none">
333
+ <div class="header-text-wrapper">
334
+ {#if header.column.columnDef instanceof RowSelectionDef}
335
+ <SelectAllHeader />
336
+ {:else}
337
+ {#if header.column.columnDef instanceof ExpandDef}
338
+ <Icon
339
+ name={header.column.columnDef.headerIcon}
340
+ colour={Colour['$font-primary']}
341
+ />
342
+ {:else if typeof header.column.columnDef.header == 'string'}
343
+ {header.column.columnDef.header}
344
+ {:else}
345
+ {@render header.column.columnDef.header()}
346
+ {/if}
347
+ <Icon
348
+ variant={Variant.HeaderIcon}
349
+ size={Size.Medium}
350
+ name={iconNames[header.column.getIsSorted()]}
351
+ />
352
+ {/if}
353
+ </div>
354
+ </div>
355
+ </button>
356
+ {:else}
357
+ {@const isRowSelect = header.column.columnDef instanceof RowSelectionDef}
358
+ <!-- svelte-ignore a11y_no_static_element_interactions -->
359
+ <div
360
+ onmouseenter={(e) => {
361
+ showtooltip(e, header.column.columnDef);
362
+ }}
363
+ onmouseleave={() => {
364
+ hideTooltip(header.column.columnDef);
365
+ }}
366
+ class="contents"
367
+ >
368
+ <div
369
+ class="th"
370
+ class:nopadding={isRowSelect}
371
+ >
372
+ <div class="header-text-wrapper no-sort cursor-pointer select-none">
373
+ {#if isRowSelect}
374
+ <SelectAllHeader />
375
+ {:else if header.column.columnDef instanceof ExpandDef}
376
+ <Icon
377
+ name={header.column.columnDef.headerIcon}
378
+ colour={Colour['$font-primary']}
379
+ />
380
+ {:else if typeof header.column.columnDef.header == 'string'}
381
+ {header.column.columnDef.header}
382
+ {:else}
383
+ {@render header.column.columnDef.header()}
384
+ {/if}
385
+ </div>
386
+ </div>
387
+ </div>
388
+ {/if}
389
+
390
+ {#if tableContext.enableResize}
391
+ <!-- svelte-ignore a11y_no_static_element_interactions -->
392
+ <div
393
+ onmousedown={(e) => {
394
+ e.preventDefault();
395
+ e.stopImmediatePropagation();
396
+ const handler = header.getResizeHandler();
397
+ handler(e);
398
+ }}
399
+ ondblclick={() => {
400
+ // Reset the column to its factory-default width and
401
+ // clear the user-resized flag so the grid track
402
+ // returns to its original `minmax(W, 1fr)` or
403
+ // fixed-`${W}px` branch.
404
+ header.column.columnDef.resetWidth();
405
+ }}
406
+ class="resizer right"
407
+ class:isResizing={header.column.getIsResizing()}
408
+ ></div>
409
+ {/if}
410
+ </div>
411
+ {/if}
412
+ </div>
413
+ {/snippet}
414
+
415
415
  <style>.cell.header {
416
416
  position: relative;
417
417
  min-width: 0;
@@ -562,4 +562,4 @@ div.th::after {
562
562
  width: 20px;
563
563
  overflow: hidden;
564
564
  border-right: solid 1px #cbd4da;
565
- }</style>
565
+ }</style>