@lavalogic/scoria 0.40.1 → 0.40.3

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 (137) 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/Contexts/ContextMenu.svelte +164 -164
  17. package/dist/Components/Contexts/ContextMenuDivider.svelte +15 -15
  18. package/dist/Components/Contexts/ContextMenuOption.svelte +60 -60
  19. package/dist/Components/Contexts/Toast.svelte +86 -86
  20. package/dist/Components/Contexts/ToastContainer.svelte +65 -65
  21. package/dist/Components/Contexts/Tooltip.svelte +37 -37
  22. package/dist/Components/DataMatrixIcon.svelte +112 -112
  23. package/dist/Components/DateInput.svelte +148 -148
  24. package/dist/Components/DatePicker.svelte +300 -300
  25. package/dist/Components/DesktopModal.svelte +90 -90
  26. package/dist/Components/Dial.svelte +204 -204
  27. package/dist/Components/DimensionInput.svelte +170 -170
  28. package/dist/Components/DragMenu/DragMenuHolder.svelte +119 -119
  29. package/dist/Components/DragMenu/DraggableCard.svelte +77 -77
  30. package/dist/Components/FileCard.svelte +24 -24
  31. package/dist/Components/FileUpload.svelte +236 -236
  32. package/dist/Components/GridInput.svelte +196 -196
  33. package/dist/Components/GridInputSet.svelte +29 -29
  34. package/dist/Components/HorizontalTabGroup.svelte +82 -82
  35. package/dist/Components/HorizontalTabGroupButton.svelte +44 -44
  36. package/dist/Components/Icon.svelte +128 -128
  37. package/dist/Components/Icons.js +357 -357
  38. package/dist/Components/InfoAlert.svelte +35 -35
  39. package/dist/Components/LoadingAnimation.svelte +29 -29
  40. package/dist/Components/LoadingModal.svelte +45 -45
  41. package/dist/Components/LoadingOverlay.svelte +25 -25
  42. package/dist/Components/Modal.svelte +258 -258
  43. package/dist/Components/MultiSelect.svelte +220 -220
  44. package/dist/Components/Nav/Nav.svelte +110 -110
  45. package/dist/Components/Nav/NavServiceMenuList.svelte +43 -43
  46. package/dist/Components/Nav/NavTab.svelte +62 -62
  47. package/dist/Components/Nav/ServiceMenuItem.svelte +112 -112
  48. package/dist/Components/Nav/ServicesNav.svelte +80 -80
  49. package/dist/Components/NumberInput.svelte +157 -157
  50. package/dist/Components/PageHeading.svelte +25 -25
  51. package/dist/Components/PasswordInput.svelte +88 -88
  52. package/dist/Components/Portal.svelte +36 -36
  53. package/dist/Components/ProgressBubble.svelte +107 -107
  54. package/dist/Components/QuerySelect.svelte +366 -366
  55. package/dist/Components/SingleSelect.svelte +250 -250
  56. package/dist/Components/StepButton.svelte +70 -70
  57. package/dist/Components/StepForm.svelte +140 -140
  58. package/dist/Components/Switch.svelte +69 -69
  59. package/dist/Components/Table/ARCHITECTURE.md +298 -298
  60. package/dist/Components/Table/Body/QuickSearchCell.svelte +679 -679
  61. package/dist/Components/Table/Body/Rows/ColumnHighlight.svelte +51 -51
  62. package/dist/Components/Table/Body/Rows/ColumnList.svelte +59 -59
  63. package/dist/Components/Table/Body/Rows/ColumnListRow.svelte +454 -454
  64. package/dist/Components/Table/Body/Rows/Columns/AccessorComponent.svelte +79 -79
  65. package/dist/Components/Table/Body/Rows/Columns/ActionsCell.svelte +185 -185
  66. package/dist/Components/Table/Body/Rows/Columns/BubbleCell.svelte +124 -124
  67. package/dist/Components/Table/Body/Rows/Columns/ExpandCell.svelte +163 -120
  68. package/dist/Components/Table/Body/Rows/Columns/FocusableImmutableCell.svelte +234 -234
  69. package/dist/Components/Table/Body/Rows/Columns/ProgressCell.svelte +105 -105
  70. package/dist/Components/Table/Body/Rows/Columns/TableAction.svelte +87 -87
  71. package/dist/Components/Table/Body/Rows/Columns/TableCheckbox.svelte +160 -126
  72. package/dist/Components/Table/Body/Rows/Columns/TableColumn.svelte +159 -159
  73. package/dist/Components/Table/Body/Rows/Columns/TableDatePicker.svelte +246 -246
  74. package/dist/Components/Table/Body/Rows/Columns/TableNumberInput.svelte +216 -216
  75. package/dist/Components/Table/Body/Rows/Columns/TableQuerySelect.svelte +252 -252
  76. package/dist/Components/Table/Body/Rows/Columns/TableRowSelectionCheckbox.svelte +179 -179
  77. package/dist/Components/Table/Body/Rows/Columns/TableSelect.svelte +221 -221
  78. package/dist/Components/Table/Body/Rows/Columns/TableTextInput.svelte +197 -197
  79. package/dist/Components/Table/Body/Rows/Columns/ValidityCell.svelte +190 -190
  80. package/dist/Components/Table/Body/Rows/TableRow.svelte +290 -290
  81. package/dist/Components/Table/Body/TableBody.svelte +155 -155
  82. package/dist/Components/Table/ColumnFactory.svelte.js +7 -0
  83. package/dist/Components/Table/Headers/HighlightAllHeader.svelte +41 -41
  84. package/dist/Components/Table/Headers/SelectAllHeader.svelte +30 -30
  85. package/dist/Components/Table/Headers/TableHead.svelte +415 -415
  86. package/dist/Components/Table/Misc/ColumnPanel.svelte +39 -39
  87. package/dist/Components/Table/Misc/ColumnPanelModal.svelte +39 -39
  88. package/dist/Components/Table/Misc/FilterInput.svelte +641 -641
  89. package/dist/Components/Table/Misc/FilterPanel.svelte +190 -190
  90. package/dist/Components/Table/Misc/FilterPanelModal.svelte +31 -31
  91. package/dist/Components/Table/Misc/ShareViewModal.svelte +291 -291
  92. package/dist/Components/Table/Misc/SidePanel.svelte +35 -35
  93. package/dist/Components/Table/Misc/TableConfigurationModal.svelte +644 -644
  94. package/dist/Components/Table/Misc/TableFooter.svelte +340 -340
  95. package/dist/Components/Table/Misc/TableHorizontalBar.svelte +140 -140
  96. package/dist/Components/Table/Misc/TableSidebar.svelte +200 -200
  97. package/dist/Components/Table/Misc/TableViewDropdown.svelte +105 -105
  98. package/dist/Components/Table/Misc/ToolboxPanel.svelte +100 -100
  99. package/dist/Components/Table/Misc/ToolboxPanelModal.svelte +107 -107
  100. package/dist/Components/Table/Misc/UpdateViewOptionsModal.svelte +192 -192
  101. package/dist/Components/Table/NestedTable.svelte +130 -130
  102. package/dist/Components/Table/Table.svelte +692 -692
  103. package/dist/Components/Table/Types/Columns/Definitions/Expand/ExpandDef.svelte.d.ts +9 -0
  104. package/dist/Components/Table/Types/Columns/Definitions/Expand/ExpandDef.svelte.js +6 -0
  105. package/dist/Components/Table/Types/Public/ColumnOptions.d.ts +19 -0
  106. package/dist/Components/Test/TestContextConsumer.svelte +13 -13
  107. package/dist/Components/TextArea.svelte +130 -130
  108. package/dist/Components/TextInput.svelte +176 -176
  109. package/dist/Components/ThreeStateRadio.svelte +131 -131
  110. package/dist/Components/Touch/BoolCard.svelte +45 -45
  111. package/dist/Components/Touch/DateModal.svelte +209 -209
  112. package/dist/Components/Touch/EditCard.svelte +59 -59
  113. package/dist/Components/Touch/InfoCard.svelte +31 -31
  114. package/dist/Components/Touch/InfoTextCard.svelte +28 -28
  115. package/dist/Components/Touch/ModalExplanation.svelte +17 -17
  116. package/dist/Components/Touch/NumberKeyboard.svelte +225 -225
  117. package/dist/Components/Touch/NumberModal.svelte +79 -79
  118. package/dist/Components/Touch/PlusMinusCard.svelte +46 -46
  119. package/dist/Components/Touch/SelectModal.svelte +127 -127
  120. package/dist/Components/Touch/SummaryCard.svelte +93 -93
  121. package/dist/Components/Touch/TextAreaModal.svelte +95 -95
  122. package/dist/Components/Touch/TextModal.svelte +106 -106
  123. package/dist/Components/Touch/TouchCard.svelte +33 -33
  124. package/dist/Components/Touch/TouchModal.svelte +274 -274
  125. package/dist/Components/Touch/UtilityButton.svelte +109 -109
  126. package/dist/Components/VerticalTabGroup.svelte +79 -79
  127. package/dist/Components/VerticalTabGroupButton.svelte +58 -58
  128. package/dist/Helpers/Datamatrix.d.ts +19 -19
  129. package/dist/Helpers/Datamatrix.js +291 -291
  130. package/dist/Types/Examples/ExampleModal.svelte +35 -35
  131. package/dist/scss/_basics.scss +12 -12
  132. package/dist/scss/_colours.scss +134 -134
  133. package/dist/scss/_mixins.scss +3392 -3392
  134. package/dist/scss/_motion.scss +57 -57
  135. package/dist/scss/_sizing.scss +85 -85
  136. package/dist/scss/_transitions.scss +8 -8
  137. 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>