@lavalogic/scoria 0.37.44 → 0.37.45

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 (237) 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/ActionProps.d.ts +2 -6
  6. package/dist/Components/AlertModal.svelte +195 -183
  7. package/dist/Components/AppointmentCalendar/AppointmentCalendar.svelte +702 -702
  8. package/dist/Components/Base/BaseModal.svelte +125 -125
  9. package/dist/Components/Base/ContextWrapper.svelte +72 -72
  10. package/dist/Components/Base/Pagination.svelte +198 -198
  11. package/dist/Components/Base/Snippets.svelte +36 -36
  12. package/dist/Components/BigRadioSet.svelte +38 -38
  13. package/dist/Components/Bubble.svelte +101 -101
  14. package/dist/Components/Button.svelte +209 -209
  15. package/dist/Components/ButtonProps.d.ts +2 -6
  16. package/dist/Components/Checkbox.svelte +86 -86
  17. package/dist/Components/CollapsibleCard.svelte +78 -78
  18. package/dist/Components/Contexts/ContextMenu.svelte +164 -164
  19. package/dist/Components/Contexts/ContextMenuDivider.svelte +15 -15
  20. package/dist/Components/Contexts/ContextMenuOption.svelte +60 -60
  21. package/dist/Components/Contexts/Toast.svelte +83 -83
  22. package/dist/Components/Contexts/ToastContainer.svelte +65 -65
  23. package/dist/Components/Contexts/Tooltip.svelte +37 -37
  24. package/dist/Components/DataMatrixIcon.svelte +112 -112
  25. package/dist/Components/DataMatrixIconProps.d.ts +3 -13
  26. package/dist/Components/DateInput.svelte +148 -148
  27. package/dist/Components/DatePicker.svelte +300 -300
  28. package/dist/Components/DesktopModal.svelte +90 -90
  29. package/dist/Components/Dial.svelte +204 -204
  30. package/dist/Components/DialProps.d.ts +1 -18
  31. package/dist/Components/DimensionInput.svelte +170 -170
  32. package/dist/Components/DragMenu/DragMenuHolder.svelte +119 -119
  33. package/dist/Components/DragMenu/DraggableCard.svelte +77 -77
  34. package/dist/Components/FileCard.svelte +24 -24
  35. package/dist/Components/FileUpload.svelte +236 -236
  36. package/dist/Components/GridInput.svelte +196 -200
  37. package/dist/Components/GridInputSet.svelte +29 -29
  38. package/dist/Components/HorizontalTabGroup.svelte +82 -82
  39. package/dist/Components/HorizontalTabGroupButton.svelte +44 -44
  40. package/dist/Components/Icon.svelte +128 -128
  41. package/dist/Components/IconProps.d.ts +2 -7
  42. package/dist/Components/Icons.js +357 -357
  43. package/dist/Components/LoadingAnimation.svelte +29 -29
  44. package/dist/Components/LoadingModal.svelte +45 -45
  45. package/dist/Components/LoadingOverlay.svelte +25 -25
  46. package/dist/Components/LoadingOverlayProps.d.ts +3 -7
  47. package/dist/Components/Modal.svelte +258 -258
  48. package/dist/Components/ModalProps.d.ts +0 -3
  49. package/dist/Components/MultiSelect.svelte +220 -220
  50. package/dist/Components/MultiSelectCommonProps.d.ts +6 -17
  51. package/dist/Components/Nav/Nav.svelte +99 -99
  52. package/dist/Components/Nav/NavProps.d.ts +4 -11
  53. package/dist/Components/Nav/NavServiceMenuList.svelte +43 -43
  54. package/dist/Components/Nav/NavTab.svelte +62 -62
  55. package/dist/Components/Nav/ServiceMenuItem.svelte +100 -100
  56. package/dist/Components/Nav/ServicesNav.svelte +80 -80
  57. package/dist/Components/NumberInput.svelte +157 -157
  58. package/dist/Components/PageHeading.svelte +25 -25
  59. package/dist/Components/PasswordInput.svelte +88 -88
  60. package/dist/Components/Portal.svelte +36 -36
  61. package/dist/Components/ProgressBubble.svelte +107 -108
  62. package/dist/Components/ProgressBubbleProps.d.ts +3 -3
  63. package/dist/Components/QuerySelect.svelte +366 -366
  64. package/dist/Components/QuerySelectProps.d.ts +4 -14
  65. package/dist/Components/SingleSelect.svelte +250 -250
  66. package/dist/Components/SingleSelectCommonProps.d.ts +3 -19
  67. package/dist/Components/StepButton.svelte +70 -70
  68. package/dist/Components/StepForm.svelte +140 -140
  69. package/dist/Components/Switch.svelte +69 -69
  70. package/dist/Components/Table/ARCHITECTURE.md +298 -0
  71. package/dist/Components/Table/Body/QuickSearchCell.svelte +679 -694
  72. package/dist/Components/Table/Body/Rows/ColumnHighlight.svelte +51 -51
  73. package/dist/Components/Table/Body/Rows/ColumnList.svelte +59 -59
  74. package/dist/Components/Table/Body/Rows/ColumnListRow.svelte +456 -478
  75. package/dist/Components/Table/Body/Rows/Columns/AccessorComponent.svelte +79 -79
  76. package/dist/Components/Table/Body/Rows/Columns/ActionsCell.svelte +185 -188
  77. package/dist/Components/Table/Body/Rows/Columns/BubbleCell.svelte +124 -124
  78. package/dist/Components/Table/Body/Rows/Columns/ExpandCell.svelte +120 -120
  79. package/dist/Components/Table/Body/Rows/Columns/FocusableImmutableCell.svelte +230 -230
  80. package/dist/Components/Table/Body/Rows/Columns/ProgressCell.svelte +105 -105
  81. package/dist/Components/Table/Body/Rows/Columns/SelectColumn.d.ts +12 -9
  82. package/dist/Components/Table/Body/Rows/Columns/SelectTableCell.d.ts +5 -5
  83. package/dist/Components/Table/Body/Rows/Columns/TableAction.svelte +87 -87
  84. package/dist/Components/Table/Body/Rows/Columns/TableCheckbox.svelte +126 -126
  85. package/dist/Components/Table/Body/Rows/Columns/TableColumn.svelte +159 -159
  86. package/dist/Components/Table/Body/Rows/Columns/TableDatePicker.svelte +246 -246
  87. package/dist/Components/Table/Body/Rows/Columns/TableDatePickerProps.d.ts +4 -4
  88. package/dist/Components/Table/Body/Rows/Columns/TableNumberInput.svelte +216 -216
  89. package/dist/Components/Table/Body/Rows/Columns/TableQueryCell.d.ts +6 -5
  90. package/dist/Components/Table/Body/Rows/Columns/TableQueryColumn.d.ts +7 -6
  91. package/dist/Components/Table/Body/Rows/Columns/TableQuerySelect.svelte +252 -257
  92. package/dist/Components/Table/Body/Rows/Columns/TableRowSelectionCheckbox.svelte +179 -179
  93. package/dist/Components/Table/Body/Rows/Columns/TableSelect.svelte +221 -229
  94. package/dist/Components/Table/Body/Rows/Columns/TableSelect.svelte.d.ts +11 -11
  95. package/dist/Components/Table/Body/Rows/Columns/TableTextInput.svelte +197 -197
  96. package/dist/Components/Table/Body/Rows/Columns/ValidityCell.svelte +190 -190
  97. package/dist/Components/Table/Body/Rows/TableRow.svelte +290 -290
  98. package/dist/Components/Table/Body/TableBody.svelte +155 -155
  99. package/dist/Components/Table/ColumnDefinitions/ExampleItemColumnDefRepository.svelte.js +2 -3
  100. package/dist/Components/Table/ColumnFactory.svelte.d.ts +9 -11
  101. package/dist/Components/Table/ColumnFactory.svelte.js +101 -118
  102. package/dist/Components/Table/ColumnKindRegistry.d.ts +112 -0
  103. package/dist/Components/Table/ColumnKindRegistry.js +63 -0
  104. package/dist/Components/Table/Headers/HighlightAllHeader.svelte +41 -41
  105. package/dist/Components/Table/Headers/SelectAllHeader.svelte +30 -30
  106. package/dist/Components/Table/Headers/TableHead.svelte +415 -413
  107. package/dist/Components/Table/Misc/ColumnPanel.svelte +94 -94
  108. package/dist/Components/Table/Misc/ColumnPanelModal.svelte +112 -112
  109. package/dist/Components/Table/Misc/FilterInput.svelte +620 -644
  110. package/dist/Components/Table/Misc/FilterInput.svelte.d.ts +12 -12
  111. package/dist/Components/Table/Misc/FilterInputProps.d.ts +2 -2
  112. package/dist/Components/Table/Misc/FilterPanel.svelte +257 -257
  113. package/dist/Components/Table/Misc/FilterPanelModal.svelte +30 -30
  114. package/dist/Components/Table/Misc/SidePanel.svelte +35 -35
  115. package/dist/Components/Table/Misc/TableFooter.svelte +311 -311
  116. package/dist/Components/Table/Misc/TableHorizontalBar.svelte +125 -125
  117. package/dist/Components/Table/Misc/TableSidebar.svelte +157 -157
  118. package/dist/Components/Table/Misc/ToolboxPanel.svelte +100 -100
  119. package/dist/Components/Table/Misc/ToolboxPanelModal.svelte +107 -107
  120. package/dist/Components/Table/NestedTable.svelte +130 -133
  121. package/dist/Components/Table/SubApis.svelte.d.ts +1 -5
  122. package/dist/Components/Table/SubApis.svelte.js +33 -32
  123. package/dist/Components/Table/Table.svelte +692 -745
  124. package/dist/Components/Table/TableHelpers.svelte.d.ts +6 -19
  125. package/dist/Components/Table/TableHelpers.svelte.js +6 -14
  126. package/dist/Components/Table/Types/Columns/Column.d.ts +2 -2
  127. package/dist/Components/Table/Types/Columns/DateColumn.d.ts +3 -3
  128. package/dist/Components/Table/Types/Columns/DateTableCell.d.ts +7 -7
  129. package/dist/Components/Table/Types/Columns/Definitions/Accessors/AccessorDef.svelte.d.ts +7 -8
  130. package/dist/Components/Table/Types/Columns/Definitions/Accessors/AccessorDef.svelte.js +4 -5
  131. package/dist/Components/Table/Types/Columns/Definitions/Accessors/CheckboxDef.svelte.d.ts +11 -14
  132. package/dist/Components/Table/Types/Columns/Definitions/Accessors/CheckboxDef.svelte.js +3 -4
  133. package/dist/Components/Table/Types/Columns/Definitions/Accessors/DateInputDef.svelte.d.ts +7 -11
  134. package/dist/Components/Table/Types/Columns/Definitions/Accessors/DateInputDef.svelte.js +3 -3
  135. package/dist/Components/Table/Types/Columns/Definitions/Accessors/NumberInputDef.svelte.d.ts +13 -18
  136. package/dist/Components/Table/Types/Columns/Definitions/Accessors/NumberInputDef.svelte.js +4 -5
  137. package/dist/Components/Table/Types/Columns/Definitions/Accessors/QueryDef.svelte.d.ts +5 -5
  138. package/dist/Components/Table/Types/Columns/Definitions/Accessors/QueryDef.svelte.js +2 -2
  139. package/dist/Components/Table/Types/Columns/Definitions/Accessors/SelectDef.svelte.d.ts +15 -12
  140. package/dist/Components/Table/Types/Columns/Definitions/Accessors/SelectDef.svelte.js +4 -5
  141. package/dist/Components/Table/Types/Columns/Definitions/Accessors/TextInputDef.svelte.d.ts +8 -12
  142. package/dist/Components/Table/Types/Columns/Definitions/Accessors/TextInputDef.svelte.js +3 -3
  143. package/dist/Components/Table/Types/Columns/Definitions/Actions/ActionsDef.svelte.d.ts +6 -6
  144. package/dist/Components/Table/Types/Columns/Definitions/Actions/ActionsDef.svelte.js +3 -3
  145. package/dist/Components/Table/Types/Columns/Definitions/ColumnDef.svelte.d.ts +49 -16
  146. package/dist/Components/Table/Types/Columns/Definitions/ColumnDef.svelte.js +27 -5
  147. package/dist/Components/Table/Types/Columns/Definitions/Display/AbstractDisplayDef.svelte.d.ts +7 -7
  148. package/dist/Components/Table/Types/Columns/Definitions/Display/AbstractDisplayDef.svelte.js +4 -4
  149. package/dist/Components/Table/Types/Columns/Definitions/Display/BubbleDef.svelte.d.ts +5 -5
  150. package/dist/Components/Table/Types/Columns/Definitions/Display/BubbleDef.svelte.js +2 -2
  151. package/dist/Components/Table/Types/Columns/Definitions/Display/DisplayDef.svelte.d.ts +5 -5
  152. package/dist/Components/Table/Types/Columns/Definitions/Display/DisplayDef.svelte.js +2 -2
  153. package/dist/Components/Table/Types/Columns/Definitions/Display/ProgressBarDef.svelte.d.ts +5 -5
  154. package/dist/Components/Table/Types/Columns/Definitions/Display/ProgressBarDef.svelte.js +2 -2
  155. package/dist/Components/Table/Types/Columns/Definitions/Display/ValidityDef.svelte.d.ts +5 -5
  156. package/dist/Components/Table/Types/Columns/Definitions/Display/ValidityDef.svelte.js +2 -2
  157. package/dist/Components/Table/Types/Columns/Definitions/Expand/ExpandDef.svelte.d.ts +11 -19
  158. package/dist/Components/Table/Types/Columns/Definitions/Expand/ExpandDef.svelte.js +4 -8
  159. package/dist/Components/Table/Types/Columns/Definitions/FilterOnly/FilterOnlyDef.svelte.d.ts +6 -7
  160. package/dist/Components/Table/Types/Columns/Definitions/FilterOnly/FilterOnlyDef.svelte.js +3 -4
  161. package/dist/Components/Table/Types/Columns/Definitions/RowSelection/RowSelectionDef.svelte.d.ts +9 -9
  162. package/dist/Components/Table/Types/Columns/Definitions/RowSelection/RowSelectionDef.svelte.js +4 -4
  163. package/dist/Components/Table/Types/Columns/ExpandTableCell.d.ts +5 -5
  164. package/dist/Components/Table/Types/Columns/ProgressBarTableCell.d.ts +6 -6
  165. package/dist/Components/Table/Types/Columns/TableCell.d.ts +7 -6
  166. package/dist/Components/Table/Types/Context/ClipboardState.svelte.d.ts +98 -0
  167. package/dist/Components/Table/Types/Context/ClipboardState.svelte.js +290 -0
  168. package/dist/Components/Table/Types/Context/ColumnLayoutState.svelte.d.ts +17 -45
  169. package/dist/Components/Table/Types/Context/ColumnLayoutState.svelte.js +17 -45
  170. package/dist/Components/Table/Types/Context/FilteringState.svelte.d.ts +9 -20
  171. package/dist/Components/Table/Types/Context/FilteringState.svelte.js +9 -20
  172. package/dist/Components/Table/Types/Context/FocusState.svelte.d.ts +23 -42
  173. package/dist/Components/Table/Types/Context/FocusState.svelte.js +32 -59
  174. package/dist/Components/Table/Types/Context/ITable.d.ts +5 -8
  175. package/dist/Components/Table/Types/Context/PreferencesState.svelte.d.ts +29 -56
  176. package/dist/Components/Table/Types/Context/PreferencesState.svelte.js +28 -55
  177. package/dist/Components/Table/Types/Context/QueryValuesState.svelte.d.ts +50 -0
  178. package/dist/Components/Table/Types/Context/QueryValuesState.svelte.js +62 -0
  179. package/dist/Components/Table/Types/Context/SelectionState.svelte.d.ts +17 -28
  180. package/dist/Components/Table/Types/Context/SelectionState.svelte.js +17 -28
  181. package/dist/Components/Table/Types/Context/SortingState.svelte.d.ts +15 -29
  182. package/dist/Components/Table/Types/Context/SortingState.svelte.js +17 -31
  183. package/dist/Components/Table/Types/Context/TableContext.svelte.d.ts +212 -325
  184. package/dist/Components/Table/Types/Context/TableContext.svelte.js +292 -706
  185. package/dist/Components/Table/Types/Context/VirtualisationState.svelte.d.ts +62 -79
  186. package/dist/Components/Table/Types/Context/VirtualisationState.svelte.js +54 -73
  187. package/dist/Components/Table/Types/DataRepository/BuiltInRemoteRepository.svelte.d.ts +16 -27
  188. package/dist/Components/Table/Types/DataRepository/BuiltInRemoteRepository.svelte.js +16 -27
  189. package/dist/Components/Table/Types/DataRepository/IDataRepository.d.ts +12 -15
  190. package/dist/Components/Table/Types/DataRepository/TableDataRepository.svelte.d.ts +15 -30
  191. package/dist/Components/Table/Types/DataRepository/TableDataRepository.svelte.js +16 -28
  192. package/dist/Components/Table/Types/Header.d.ts +4 -4
  193. package/dist/Components/Table/Types/HeaderGroup.d.ts +5 -5
  194. package/dist/Components/Table/Types/Public/index.d.ts +2 -4
  195. package/dist/Components/Table/Types/Public/index.js +2 -4
  196. package/dist/Components/Table/clipboardEscape.d.ts +32 -0
  197. package/dist/Components/Table/clipboardEscape.js +45 -0
  198. package/dist/Components/Table/createTable.svelte.d.ts +8 -18
  199. package/dist/Components/Table/createTable.svelte.js +19 -47
  200. package/dist/Components/Test/TestContextConsumer.svelte +13 -13
  201. package/dist/Components/TextArea.svelte +130 -130
  202. package/dist/Components/TextInput.svelte +176 -176
  203. package/dist/Components/ThreeStateRadio.svelte +131 -131
  204. package/dist/Components/Touch/BoolCard.svelte +45 -45
  205. package/dist/Components/Touch/DateModal.svelte +209 -209
  206. package/dist/Components/Touch/EditCard.svelte +59 -59
  207. package/dist/Components/Touch/InfoCard.svelte +31 -31
  208. package/dist/Components/Touch/InfoTextCard.svelte +28 -28
  209. package/dist/Components/Touch/ModalExplanation.svelte +17 -17
  210. package/dist/Components/Touch/NumberKeyboard.svelte +225 -225
  211. package/dist/Components/Touch/NumberModal.svelte +79 -79
  212. package/dist/Components/Touch/PlusMinusCard.svelte +46 -46
  213. package/dist/Components/Touch/SelectModal.svelte +123 -123
  214. package/dist/Components/Touch/SummaryCard.svelte +93 -93
  215. package/dist/Components/Touch/TextAreaModal.svelte +95 -95
  216. package/dist/Components/Touch/TextModal.svelte +106 -106
  217. package/dist/Components/Touch/TouchCard.svelte +33 -33
  218. package/dist/Components/Touch/TouchModal.svelte +274 -274
  219. package/dist/Components/Touch/UtilityButton.svelte +109 -109
  220. package/dist/Components/VerticalTabGroup.svelte +79 -79
  221. package/dist/Components/VerticalTabGroupButton.svelte +58 -58
  222. package/dist/Contexts/ToastContext.svelte.js +3 -4
  223. package/dist/Helpers/Datamatrix.d.ts +19 -19
  224. package/dist/Helpers/Datamatrix.js +291 -291
  225. package/dist/Helpers/Helpers.svelte.d.ts +2 -4
  226. package/dist/Helpers/Helpers.svelte.js +2 -4
  227. package/dist/Helpers/dropdownPortal.d.ts +26 -41
  228. package/dist/Helpers/dropdownPortal.js +62 -116
  229. package/dist/Types/Examples/ExampleModal.svelte +35 -35
  230. package/dist/index.d.ts +0 -1
  231. package/dist/scss/_basics.scss +12 -12
  232. package/dist/scss/_colours.scss +134 -134
  233. package/dist/scss/_mixins.scss +3348 -3360
  234. package/dist/scss/_motion.scss +57 -57
  235. package/dist/scss/_sizing.scss +85 -85
  236. package/dist/scss/_transitions.scss +8 -8
  237. package/package.json +2 -1
@@ -1,200 +1,200 @@
1
- <svelte:options runes />
2
-
3
- <!--
4
- @component
5
- Generic local-collection paginator. Renders a window of items via a
6
- `snippet` plus a control bar with page-number buttons, a jump-to-page
7
- input, and previous/next buttons. The component is generic over
8
- `T extends object` with a `key: keyof T` used as the
9
- `{#each}` key inside the rendered page.
10
-
11
- ### Usage
12
-
13
- ```svelte
14
- <Pagination snippet={itemSnippet} pageSize={20} items={dataWrapper.value} key="id" />
15
- ```
16
-
17
- The `pageButtons` window (up to five numbered buttons) is recomputed
18
- via `$derived`, not via an `$effect`, so the page bar diffs in a
19
- single reactive pass and the keyed `{#each pageButtons as page ...}`
20
- preserves button identity across page changes.
21
- -->
22
- <script
23
- lang="ts"
24
- generics="T extends object"
25
- >
26
- import { autoPluralise, generateWeakId } from '../../Helpers/Helpers.svelte.js';
27
- import { Colour } from '../../scss/colours.js';
28
- import { Side } from '../../Types/Internal/Side.js';
29
- import { Size } from '../../Types/Internal/Size.js';
30
- import { Variant } from '../../Types/Internal/Variant.js';
31
- import Button from '../Button.svelte';
32
- import Icon from '../Icon.svelte';
33
- import NumberInput from '../NumberInput.svelte';
34
- import type { PaginationProps } from './PaginationProps.js';
35
-
36
- const {
37
- items,
38
- key,
39
- pageSize = 20,
40
- snippet,
41
- itemName = 'Item',
42
- border = false,
43
- padding = '1.5rem', // sizing.$regular-padding
44
- gap = '1.5rem', // sizing.$regular-gap
45
- height,
46
- }: PaginationProps<T> = $props();
47
-
48
- const _uuid = generateWeakId();
49
- let pageIndex = $state(0);
50
- const pageValue = $derived(pageIndex + 1);
51
- const startIndex = $derived(pageIndex * pageSize);
52
- const pageItems = $derived(items.slice(startIndex, startIndex + pageSize));
53
-
54
- const lastPage = $derived(Math.ceil(items.length / pageSize));
55
- const lastPageIndex = $derived(lastPage - 1);
56
-
57
- // Debounced jump-to-page handler. Reads the raw event because the
58
- // debounce drives state, not the input value directly; binding to
59
- // `pageValue` would defeat the debounce.
60
- let debounceTimeout = -1;
61
- function onNumberInput(e: Event) {
62
- const value = (e.target as HTMLInputElement).value;
63
- const page = Number(value);
64
-
65
- clearTimeout(debounceTimeout);
66
- if (!isNaN(page)) {
67
- debounceTimeout = setTimeout(() => {
68
- pageIndex = Math.max(page - 1, 0);
69
- }, 400) as unknown as number;
70
- }
71
- }
72
-
73
- /**
74
- * Compute the window of up to five page numbers shown in the
75
- * control bar. Centred on the current page where possible and
76
- * clamped against both ends. Pulled into a stand-alone helper so
77
- * the windowing logic is unit-testable from outside the component.
78
- */
79
- function getPageWindow(
80
- currentIndex: number,
81
- totalPages: number,
82
- windowSize: number
83
- ): Array<number> {
84
- const start = Math.min(totalPages - 2, currentIndex - 1);
85
- const clampedStart = Math.max(1, Math.min(start, totalPages - (windowSize - 1)));
86
- const count = Math.min(totalPages, windowSize);
87
- const out = new Array<number>(count);
88
- for (let i = 0; i < count; i++) {
89
- out[i] = clampedStart + i;
90
- }
91
- return out;
92
- }
93
-
94
- const pageButtons = $derived(getPageWindow(pageIndex, lastPage, 5));
95
- </script>
96
-
97
- <div
98
- class="wrapper"
99
- class:border
100
- style:padding
101
- style:gap
102
- style:height
103
- >
104
- {#each pageItems as item, index (item[key])}
105
- {@render snippet(item, index)}
106
- {/each}
107
- <div class="spread_row bottom_row">
108
- <div class="block">
109
- <span>{items.length} {autoPluralise(itemName, items.length)}</span>
110
- </div>
111
-
112
- <div class="block records-per-page">
113
- <span>Records per Page: {pageSize}</span>
114
- </div>
115
-
116
- <div class="spacer"></div>
117
-
118
- <div
119
- class="scrollable"
120
- role="navigation"
121
- aria-label="Pagination"
122
- >
123
- <div class="block">
124
- <Icon
125
- name="paper"
126
- colour={Colour['$ui-blue-6']}
127
- />
128
- <span>{lastPage} {autoPluralise('Page', lastPage)}</span>
129
- </div>
130
-
131
- <div class="block">
132
- <label for="{_uuid}-jump-to-page"
133
- ><Icon
134
- name="arrow-move-horizontal"
135
- colour={Colour['$ui-blue-6']}
136
- /></label
137
- >
138
-
139
- <label for="{_uuid}-jump-to-page">Jump to page:</label>
140
-
141
- <NumberInput
142
- id="{_uuid}-jump-to-page"
143
- value={pageValue}
144
- oninput={onNumberInput}
145
- />
146
- </div>
147
-
148
- <div class="block nopad page-arrow">
149
- <Button
150
- variant={Variant.Toolbar}
151
- disabled={pageIndex === 0}
152
- side={Side.Bottom}
153
- onclick={() => {
154
- pageIndex = Math.max(pageIndex - 1, 0);
155
- }}
156
- size={Size.FillHeight}
157
- iconLeft={{
158
- name: 'left-close',
159
- size: Size.FillHeight,
160
- }}>Previous Page</Button
161
- >
162
- </div>
163
-
164
- {#each pageButtons as pageNumber (pageNumber)}
165
- <div class="block nopad">
166
- <Button
167
- variant={Variant.Toolbar}
168
- side={Side.Bottom}
169
- size={Size.FillHeight}
170
- toggled={pageIndex + 1 === pageNumber}
171
- label={`Go to page ${pageNumber.toString()}`}
172
- onclick={() => {
173
- pageIndex = pageNumber - 1;
174
- }}>{pageNumber}</Button
175
- >
176
- </div>
177
- {/each}
178
-
179
- <div class="block nopad page-arrow">
180
- <Button
181
- variant={Variant.Toolbar}
182
- side={Side.Bottom}
183
- size={Size.FillHeight}
184
- onclick={() => {
185
- pageIndex = Math.min(pageIndex + 1, lastPageIndex);
186
- }}
187
- disabled={pageIndex == lastPageIndex}
188
- iconRight={{
189
- name: 'right-close',
190
- size: Size.FillHeight,
191
- }}>Next Page</Button
192
- >
193
- </div>
194
- </div>
195
- </div>
196
- </div>
197
-
1
+ <svelte:options runes />
2
+
3
+ <!--
4
+ @component
5
+ Generic local-collection paginator. Renders a window of items via a
6
+ `snippet` plus a control bar with page-number buttons, a jump-to-page
7
+ input, and previous/next buttons. The component is generic over
8
+ `T extends object` with a `key: keyof T` used as the
9
+ `{#each}` key inside the rendered page.
10
+
11
+ ### Usage
12
+
13
+ ```svelte
14
+ <Pagination snippet={itemSnippet} pageSize={20} items={dataWrapper.value} key="id" />
15
+ ```
16
+
17
+ The `pageButtons` window (up to five numbered buttons) is recomputed
18
+ via `$derived`, not via an `$effect`, so the page bar diffs in a
19
+ single reactive pass and the keyed `{#each pageButtons as page ...}`
20
+ preserves button identity across page changes.
21
+ -->
22
+ <script
23
+ lang="ts"
24
+ generics="T extends object"
25
+ >
26
+ import { autoPluralise, generateWeakId } from '../../Helpers/Helpers.svelte.js';
27
+ import { Colour } from '../../scss/colours.js';
28
+ import { Side } from '../../Types/Internal/Side.js';
29
+ import { Size } from '../../Types/Internal/Size.js';
30
+ import { Variant } from '../../Types/Internal/Variant.js';
31
+ import Button from '../Button.svelte';
32
+ import Icon from '../Icon.svelte';
33
+ import NumberInput from '../NumberInput.svelte';
34
+ import type { PaginationProps } from './PaginationProps.js';
35
+
36
+ const {
37
+ items,
38
+ key,
39
+ pageSize = 20,
40
+ snippet,
41
+ itemName = 'Item',
42
+ border = false,
43
+ padding = '1.5rem', // sizing.$regular-padding
44
+ gap = '1.5rem', // sizing.$regular-gap
45
+ height,
46
+ }: PaginationProps<T> = $props();
47
+
48
+ const _uuid = generateWeakId();
49
+ let pageIndex = $state(0);
50
+ const pageValue = $derived(pageIndex + 1);
51
+ const startIndex = $derived(pageIndex * pageSize);
52
+ const pageItems = $derived(items.slice(startIndex, startIndex + pageSize));
53
+
54
+ const lastPage = $derived(Math.ceil(items.length / pageSize));
55
+ const lastPageIndex = $derived(lastPage - 1);
56
+
57
+ // Debounced jump-to-page handler. Reads the raw event because the
58
+ // debounce drives state, not the input value directly; binding to
59
+ // `pageValue` would defeat the debounce.
60
+ let debounceTimeout = -1;
61
+ function onNumberInput(e: Event) {
62
+ const value = (e.target as HTMLInputElement).value;
63
+ const page = Number(value);
64
+
65
+ clearTimeout(debounceTimeout);
66
+ if (!isNaN(page)) {
67
+ debounceTimeout = setTimeout(() => {
68
+ pageIndex = Math.max(page - 1, 0);
69
+ }, 400) as unknown as number;
70
+ }
71
+ }
72
+
73
+ /**
74
+ * Compute the window of up to five page numbers shown in the
75
+ * control bar. Centred on the current page where possible and
76
+ * clamped against both ends. Pulled into a stand-alone helper so
77
+ * the windowing logic is unit-testable from outside the component.
78
+ */
79
+ function getPageWindow(
80
+ currentIndex: number,
81
+ totalPages: number,
82
+ windowSize: number
83
+ ): Array<number> {
84
+ const start = Math.min(totalPages - 2, currentIndex - 1);
85
+ const clampedStart = Math.max(1, Math.min(start, totalPages - (windowSize - 1)));
86
+ const count = Math.min(totalPages, windowSize);
87
+ const out = new Array<number>(count);
88
+ for (let i = 0; i < count; i++) {
89
+ out[i] = clampedStart + i;
90
+ }
91
+ return out;
92
+ }
93
+
94
+ const pageButtons = $derived(getPageWindow(pageIndex, lastPage, 5));
95
+ </script>
96
+
97
+ <div
98
+ class="wrapper"
99
+ class:border
100
+ style:padding
101
+ style:gap
102
+ style:height
103
+ >
104
+ {#each pageItems as item, index (item[key])}
105
+ {@render snippet(item, index)}
106
+ {/each}
107
+ <div class="spread_row bottom_row">
108
+ <div class="block">
109
+ <span>{items.length} {autoPluralise(itemName, items.length)}</span>
110
+ </div>
111
+
112
+ <div class="block records-per-page">
113
+ <span>Records per Page: {pageSize}</span>
114
+ </div>
115
+
116
+ <div class="spacer"></div>
117
+
118
+ <div
119
+ class="scrollable"
120
+ role="navigation"
121
+ aria-label="Pagination"
122
+ >
123
+ <div class="block">
124
+ <Icon
125
+ name="paper"
126
+ colour={Colour['$ui-blue-6']}
127
+ />
128
+ <span>{lastPage} {autoPluralise('Page', lastPage)}</span>
129
+ </div>
130
+
131
+ <div class="block">
132
+ <label for="{_uuid}-jump-to-page"
133
+ ><Icon
134
+ name="arrow-move-horizontal"
135
+ colour={Colour['$ui-blue-6']}
136
+ /></label
137
+ >
138
+
139
+ <label for="{_uuid}-jump-to-page">Jump to page:</label>
140
+
141
+ <NumberInput
142
+ id="{_uuid}-jump-to-page"
143
+ value={pageValue}
144
+ oninput={onNumberInput}
145
+ />
146
+ </div>
147
+
148
+ <div class="block nopad page-arrow">
149
+ <Button
150
+ variant={Variant.Toolbar}
151
+ disabled={pageIndex === 0}
152
+ side={Side.Bottom}
153
+ onclick={() => {
154
+ pageIndex = Math.max(pageIndex - 1, 0);
155
+ }}
156
+ size={Size.FillHeight}
157
+ iconLeft={{
158
+ name: 'left-close',
159
+ size: Size.FillHeight,
160
+ }}>Previous Page</Button
161
+ >
162
+ </div>
163
+
164
+ {#each pageButtons as pageNumber (pageNumber)}
165
+ <div class="block nopad">
166
+ <Button
167
+ variant={Variant.Toolbar}
168
+ side={Side.Bottom}
169
+ size={Size.FillHeight}
170
+ toggled={pageIndex + 1 === pageNumber}
171
+ label={`Go to page ${pageNumber.toString()}`}
172
+ onclick={() => {
173
+ pageIndex = pageNumber - 1;
174
+ }}>{pageNumber}</Button
175
+ >
176
+ </div>
177
+ {/each}
178
+
179
+ <div class="block nopad page-arrow">
180
+ <Button
181
+ variant={Variant.Toolbar}
182
+ side={Side.Bottom}
183
+ size={Size.FillHeight}
184
+ onclick={() => {
185
+ pageIndex = Math.min(pageIndex + 1, lastPageIndex);
186
+ }}
187
+ disabled={pageIndex == lastPageIndex}
188
+ iconRight={{
189
+ name: 'right-close',
190
+ size: Size.FillHeight,
191
+ }}>Next Page</Button
192
+ >
193
+ </div>
194
+ </div>
195
+ </div>
196
+ </div>
197
+
198
198
  <style>.wrapper {
199
199
  display: flex;
200
200
  flex: 1;
@@ -269,4 +269,4 @@ preserves button identity across page changes.
269
269
  }
270
270
  .spread_row .spacer {
271
271
  flex-grow: 2;
272
- }</style>
272
+ }</style>
@@ -1,36 +1,36 @@
1
- <svelte:options runes />
2
-
3
- <!-- @component
4
- An empty component that only exists to export common snippets
5
- (`pending` and `failed`) for re-use by `{#await}` blocks and other
6
- async-status surfaces. The component itself renders nothing.
7
- -->
8
- <script
9
- lang="ts"
10
- module
11
- >
12
- import { getErrorMessage, loadingText } from '../../Helpers/Helpers.svelte.js';
13
- import Button from '../Button.svelte';
14
-
15
- // The local `{#snippet _pending}` / `{#snippet _failed}` declarations
16
- // must be hoistable references for `export const` to bind to them.
17
- // Svelte 5 currently requires the snippet name to differ from the
18
- // exported binding, so we use an underscore prefix on the local
19
- // declaration and expose the un-prefixed name as the public surface.
20
- export const pending = _pending;
21
- export const failed = _failed;
22
- </script>
23
-
24
- {#snippet _pending()}
25
- {loadingText}
26
- {/snippet}
27
- {#snippet _failed(e: unknown, retry?: () => void)}
28
- Error: {getErrorMessage(e)}
29
- {#if retry}
30
- <Button
31
- onclick={() => {
32
- retry();
33
- }}>Retry</Button
34
- >
35
- {/if}
36
- {/snippet}
1
+ <svelte:options runes />
2
+
3
+ <!-- @component
4
+ An empty component that only exists to export common snippets
5
+ (`pending` and `failed`) for re-use by `{#await}` blocks and other
6
+ async-status surfaces. The component itself renders nothing.
7
+ -->
8
+ <script
9
+ lang="ts"
10
+ module
11
+ >
12
+ import { getErrorMessage, loadingText } from '../../Helpers/Helpers.svelte.js';
13
+ import Button from '../Button.svelte';
14
+
15
+ // The local `{#snippet _pending}` / `{#snippet _failed}` declarations
16
+ // must be hoistable references for `export const` to bind to them.
17
+ // Svelte 5 currently requires the snippet name to differ from the
18
+ // exported binding, so we use an underscore prefix on the local
19
+ // declaration and expose the un-prefixed name as the public surface.
20
+ export const pending = _pending;
21
+ export const failed = _failed;
22
+ </script>
23
+
24
+ {#snippet _pending()}
25
+ {loadingText}
26
+ {/snippet}
27
+ {#snippet _failed(e: unknown, retry?: () => void)}
28
+ Error: {getErrorMessage(e)}
29
+ {#if retry}
30
+ <Button
31
+ onclick={() => {
32
+ retry();
33
+ }}>Retry</Button
34
+ >
35
+ {/if}
36
+ {/snippet}
@@ -1,40 +1,40 @@
1
- <svelte:options runes />
2
-
3
- <script
4
- lang="ts"
5
- generics="T"
6
- >
7
- import type { BigRadioOption } from '../Types/Internal/BigRadioOption.js';
8
- import type { BigRadioSetProps } from './BigRadioSetProps.js';
9
- let { name, options, selected = $bindable(), onchange }: BigRadioSetProps<T> = $props();
10
- </script>
11
-
12
- <div
13
- class="wrapper"
14
- role="radiogroup"
15
- >
16
- {#each options as option (option.value)}
17
- <!-- eslint-disable-next-line @typescript-eslint/no-confusing-void-expression -->
18
- {@render radio(option)}
19
- {/each}
20
- </div>
21
-
22
- {#snippet radio(option: BigRadioOption<T>)}
23
- <label class:selected={selected === option.value}>
24
- <input
25
- type="radio"
26
- {name}
27
- bind:group={selected}
28
- value={option.value}
29
- onchange={() => void onchange?.(option.value)}
30
- />
31
- <div class="text">
32
- <h5 class="title">{option.label}</h5>
33
- <p class="note">{option.info}</p>
34
- </div>
35
- </label>
36
- {/snippet}
37
-
1
+ <svelte:options runes />
2
+
3
+ <script
4
+ lang="ts"
5
+ generics="T"
6
+ >
7
+ import type { BigRadioOption } from '../Types/Internal/BigRadioOption.js';
8
+ import type { BigRadioSetProps } from './BigRadioSetProps.js';
9
+ let { name, options, selected = $bindable(), onchange }: BigRadioSetProps<T> = $props();
10
+ </script>
11
+
12
+ <div
13
+ class="wrapper"
14
+ role="radiogroup"
15
+ >
16
+ {#each options as option (option.value)}
17
+ <!-- eslint-disable-next-line @typescript-eslint/no-confusing-void-expression -->
18
+ {@render radio(option)}
19
+ {/each}
20
+ </div>
21
+
22
+ {#snippet radio(option: BigRadioOption<T>)}
23
+ <label class:selected={selected === option.value}>
24
+ <input
25
+ type="radio"
26
+ {name}
27
+ bind:group={selected}
28
+ value={option.value}
29
+ onchange={() => void onchange?.(option.value)}
30
+ />
31
+ <div class="text">
32
+ <h5 class="title">{option.label}</h5>
33
+ <p class="note">{option.info}</p>
34
+ </div>
35
+ </label>
36
+ {/snippet}
37
+
38
38
  <style>.wrapper {
39
39
  display: flex;
40
40
  flex-flow: row wrap;
@@ -87,4 +87,4 @@ label.selected {
87
87
  }
88
88
  label.selected h5 {
89
89
  color: #ffffff;
90
- }</style>
90
+ }</style>