@lavalogic/scoria 0.37.44 → 0.37.46

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 (239) 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 +86 -83
  22. package/dist/Components/Contexts/Toast.svelte.d.ts +8 -5
  23. package/dist/Components/Contexts/ToastContainer.svelte +65 -65
  24. package/dist/Components/Contexts/Tooltip.svelte +37 -37
  25. package/dist/Components/DataMatrixIcon.svelte +112 -112
  26. package/dist/Components/DataMatrixIconProps.d.ts +3 -13
  27. package/dist/Components/DateInput.svelte +148 -148
  28. package/dist/Components/DatePicker.svelte +300 -300
  29. package/dist/Components/DesktopModal.svelte +90 -90
  30. package/dist/Components/Dial.svelte +204 -204
  31. package/dist/Components/DialProps.d.ts +1 -18
  32. package/dist/Components/DimensionInput.svelte +170 -170
  33. package/dist/Components/DragMenu/DragMenuHolder.svelte +119 -119
  34. package/dist/Components/DragMenu/DraggableCard.svelte +77 -77
  35. package/dist/Components/FileCard.svelte +24 -24
  36. package/dist/Components/FileUpload.svelte +236 -236
  37. package/dist/Components/GridInput.svelte +196 -200
  38. package/dist/Components/GridInputSet.svelte +29 -29
  39. package/dist/Components/HorizontalTabGroup.svelte +82 -82
  40. package/dist/Components/HorizontalTabGroupButton.svelte +44 -44
  41. package/dist/Components/Icon.svelte +128 -128
  42. package/dist/Components/IconProps.d.ts +2 -7
  43. package/dist/Components/Icons.js +357 -357
  44. package/dist/Components/LoadingAnimation.svelte +29 -29
  45. package/dist/Components/LoadingModal.svelte +45 -45
  46. package/dist/Components/LoadingOverlay.svelte +25 -25
  47. package/dist/Components/LoadingOverlayProps.d.ts +3 -7
  48. package/dist/Components/Modal.svelte +258 -258
  49. package/dist/Components/ModalProps.d.ts +0 -3
  50. package/dist/Components/MultiSelect.svelte +220 -220
  51. package/dist/Components/MultiSelectCommonProps.d.ts +6 -17
  52. package/dist/Components/Nav/Nav.svelte +110 -99
  53. package/dist/Components/Nav/NavProps.d.ts +4 -11
  54. package/dist/Components/Nav/NavServiceMenuList.svelte +43 -43
  55. package/dist/Components/Nav/NavTab.svelte +62 -62
  56. package/dist/Components/Nav/ServiceMenuItem.svelte +100 -100
  57. package/dist/Components/Nav/ServicesNav.svelte +80 -80
  58. package/dist/Components/NumberInput.svelte +157 -157
  59. package/dist/Components/PageHeading.svelte +25 -25
  60. package/dist/Components/PasswordInput.svelte +88 -88
  61. package/dist/Components/Portal.svelte +36 -36
  62. package/dist/Components/ProgressBubble.svelte +107 -108
  63. package/dist/Components/ProgressBubbleProps.d.ts +3 -3
  64. package/dist/Components/QuerySelect.svelte +366 -366
  65. package/dist/Components/QuerySelectProps.d.ts +4 -14
  66. package/dist/Components/SingleSelect.svelte +250 -250
  67. package/dist/Components/SingleSelectCommonProps.d.ts +3 -19
  68. package/dist/Components/StepButton.svelte +70 -70
  69. package/dist/Components/StepForm.svelte +140 -140
  70. package/dist/Components/Switch.svelte +69 -69
  71. package/dist/Components/Table/ARCHITECTURE.md +298 -0
  72. package/dist/Components/Table/Body/QuickSearchCell.svelte +683 -694
  73. package/dist/Components/Table/Body/Rows/ColumnHighlight.svelte +51 -51
  74. package/dist/Components/Table/Body/Rows/ColumnList.svelte +59 -59
  75. package/dist/Components/Table/Body/Rows/ColumnListRow.svelte +456 -478
  76. package/dist/Components/Table/Body/Rows/Columns/AccessorComponent.svelte +79 -79
  77. package/dist/Components/Table/Body/Rows/Columns/ActionsCell.svelte +185 -188
  78. package/dist/Components/Table/Body/Rows/Columns/BubbleCell.svelte +124 -124
  79. package/dist/Components/Table/Body/Rows/Columns/ExpandCell.svelte +120 -120
  80. package/dist/Components/Table/Body/Rows/Columns/FocusableImmutableCell.svelte +230 -230
  81. package/dist/Components/Table/Body/Rows/Columns/ProgressCell.svelte +105 -105
  82. package/dist/Components/Table/Body/Rows/Columns/SelectColumn.d.ts +12 -9
  83. package/dist/Components/Table/Body/Rows/Columns/SelectTableCell.d.ts +5 -5
  84. package/dist/Components/Table/Body/Rows/Columns/TableAction.svelte +87 -87
  85. package/dist/Components/Table/Body/Rows/Columns/TableCheckbox.svelte +126 -126
  86. package/dist/Components/Table/Body/Rows/Columns/TableColumn.svelte +159 -159
  87. package/dist/Components/Table/Body/Rows/Columns/TableDatePicker.svelte +246 -246
  88. package/dist/Components/Table/Body/Rows/Columns/TableDatePickerProps.d.ts +4 -4
  89. package/dist/Components/Table/Body/Rows/Columns/TableNumberInput.svelte +216 -216
  90. package/dist/Components/Table/Body/Rows/Columns/TableQueryCell.d.ts +6 -5
  91. package/dist/Components/Table/Body/Rows/Columns/TableQueryColumn.d.ts +7 -6
  92. package/dist/Components/Table/Body/Rows/Columns/TableQuerySelect.svelte +252 -257
  93. package/dist/Components/Table/Body/Rows/Columns/TableRowSelectionCheckbox.svelte +179 -179
  94. package/dist/Components/Table/Body/Rows/Columns/TableSelect.svelte +221 -229
  95. package/dist/Components/Table/Body/Rows/Columns/TableSelect.svelte.d.ts +11 -11
  96. package/dist/Components/Table/Body/Rows/Columns/TableTextInput.svelte +197 -197
  97. package/dist/Components/Table/Body/Rows/Columns/ValidityCell.svelte +190 -190
  98. package/dist/Components/Table/Body/Rows/TableRow.svelte +290 -290
  99. package/dist/Components/Table/Body/TableBody.svelte +155 -155
  100. package/dist/Components/Table/ColumnDefinitions/ExampleItemColumnDefRepository.svelte.js +2 -3
  101. package/dist/Components/Table/ColumnFactory.svelte.d.ts +9 -11
  102. package/dist/Components/Table/ColumnFactory.svelte.js +110 -143
  103. package/dist/Components/Table/ColumnKindRegistry.d.ts +112 -0
  104. package/dist/Components/Table/ColumnKindRegistry.js +63 -0
  105. package/dist/Components/Table/Headers/HighlightAllHeader.svelte +41 -41
  106. package/dist/Components/Table/Headers/SelectAllHeader.svelte +30 -30
  107. package/dist/Components/Table/Headers/TableHead.svelte +415 -413
  108. package/dist/Components/Table/Misc/ColumnPanel.svelte +94 -94
  109. package/dist/Components/Table/Misc/ColumnPanelModal.svelte +112 -112
  110. package/dist/Components/Table/Misc/FilterInput.svelte +620 -644
  111. package/dist/Components/Table/Misc/FilterInput.svelte.d.ts +12 -12
  112. package/dist/Components/Table/Misc/FilterInputProps.d.ts +2 -2
  113. package/dist/Components/Table/Misc/FilterPanel.svelte +257 -257
  114. package/dist/Components/Table/Misc/FilterPanelModal.svelte +30 -30
  115. package/dist/Components/Table/Misc/SidePanel.svelte +35 -35
  116. package/dist/Components/Table/Misc/TableFooter.svelte +311 -311
  117. package/dist/Components/Table/Misc/TableHorizontalBar.svelte +125 -125
  118. package/dist/Components/Table/Misc/TableSidebar.svelte +157 -157
  119. package/dist/Components/Table/Misc/ToolboxPanel.svelte +100 -100
  120. package/dist/Components/Table/Misc/ToolboxPanelModal.svelte +107 -107
  121. package/dist/Components/Table/NestedTable.svelte +130 -133
  122. package/dist/Components/Table/SubApis.svelte.d.ts +1 -5
  123. package/dist/Components/Table/SubApis.svelte.js +33 -32
  124. package/dist/Components/Table/Table.svelte +692 -745
  125. package/dist/Components/Table/TableHelpers.svelte.d.ts +6 -19
  126. package/dist/Components/Table/TableHelpers.svelte.js +6 -14
  127. package/dist/Components/Table/Types/Columns/Column.d.ts +2 -2
  128. package/dist/Components/Table/Types/Columns/DateColumn.d.ts +3 -3
  129. package/dist/Components/Table/Types/Columns/DateTableCell.d.ts +7 -7
  130. package/dist/Components/Table/Types/Columns/Definitions/Accessors/AccessorDef.svelte.d.ts +7 -8
  131. package/dist/Components/Table/Types/Columns/Definitions/Accessors/AccessorDef.svelte.js +4 -5
  132. package/dist/Components/Table/Types/Columns/Definitions/Accessors/CheckboxDef.svelte.d.ts +11 -14
  133. package/dist/Components/Table/Types/Columns/Definitions/Accessors/CheckboxDef.svelte.js +3 -4
  134. package/dist/Components/Table/Types/Columns/Definitions/Accessors/DateInputDef.svelte.d.ts +7 -11
  135. package/dist/Components/Table/Types/Columns/Definitions/Accessors/DateInputDef.svelte.js +3 -3
  136. package/dist/Components/Table/Types/Columns/Definitions/Accessors/NumberInputDef.svelte.d.ts +13 -18
  137. package/dist/Components/Table/Types/Columns/Definitions/Accessors/NumberInputDef.svelte.js +4 -5
  138. package/dist/Components/Table/Types/Columns/Definitions/Accessors/QueryDef.svelte.d.ts +5 -5
  139. package/dist/Components/Table/Types/Columns/Definitions/Accessors/QueryDef.svelte.js +2 -2
  140. package/dist/Components/Table/Types/Columns/Definitions/Accessors/SelectDef.svelte.d.ts +15 -12
  141. package/dist/Components/Table/Types/Columns/Definitions/Accessors/SelectDef.svelte.js +4 -5
  142. package/dist/Components/Table/Types/Columns/Definitions/Accessors/TextInputDef.svelte.d.ts +8 -12
  143. package/dist/Components/Table/Types/Columns/Definitions/Accessors/TextInputDef.svelte.js +3 -3
  144. package/dist/Components/Table/Types/Columns/Definitions/Actions/ActionsDef.svelte.d.ts +6 -6
  145. package/dist/Components/Table/Types/Columns/Definitions/Actions/ActionsDef.svelte.js +3 -3
  146. package/dist/Components/Table/Types/Columns/Definitions/ColumnDef.svelte.d.ts +49 -16
  147. package/dist/Components/Table/Types/Columns/Definitions/ColumnDef.svelte.js +27 -5
  148. package/dist/Components/Table/Types/Columns/Definitions/Display/AbstractDisplayDef.svelte.d.ts +7 -7
  149. package/dist/Components/Table/Types/Columns/Definitions/Display/AbstractDisplayDef.svelte.js +4 -4
  150. package/dist/Components/Table/Types/Columns/Definitions/Display/BubbleDef.svelte.d.ts +5 -5
  151. package/dist/Components/Table/Types/Columns/Definitions/Display/BubbleDef.svelte.js +2 -2
  152. package/dist/Components/Table/Types/Columns/Definitions/Display/DisplayDef.svelte.d.ts +5 -5
  153. package/dist/Components/Table/Types/Columns/Definitions/Display/DisplayDef.svelte.js +2 -2
  154. package/dist/Components/Table/Types/Columns/Definitions/Display/ProgressBarDef.svelte.d.ts +5 -5
  155. package/dist/Components/Table/Types/Columns/Definitions/Display/ProgressBarDef.svelte.js +2 -2
  156. package/dist/Components/Table/Types/Columns/Definitions/Display/ValidityDef.svelte.d.ts +5 -5
  157. package/dist/Components/Table/Types/Columns/Definitions/Display/ValidityDef.svelte.js +2 -2
  158. package/dist/Components/Table/Types/Columns/Definitions/Expand/ExpandDef.svelte.d.ts +11 -19
  159. package/dist/Components/Table/Types/Columns/Definitions/Expand/ExpandDef.svelte.js +4 -8
  160. package/dist/Components/Table/Types/Columns/Definitions/FilterOnly/FilterOnlyDef.svelte.d.ts +6 -7
  161. package/dist/Components/Table/Types/Columns/Definitions/FilterOnly/FilterOnlyDef.svelte.js +3 -4
  162. package/dist/Components/Table/Types/Columns/Definitions/RowSelection/RowSelectionDef.svelte.d.ts +9 -9
  163. package/dist/Components/Table/Types/Columns/Definitions/RowSelection/RowSelectionDef.svelte.js +4 -4
  164. package/dist/Components/Table/Types/Columns/ExpandTableCell.d.ts +5 -5
  165. package/dist/Components/Table/Types/Columns/ProgressBarTableCell.d.ts +6 -6
  166. package/dist/Components/Table/Types/Columns/TableCell.d.ts +7 -6
  167. package/dist/Components/Table/Types/Context/ClipboardState.svelte.d.ts +98 -0
  168. package/dist/Components/Table/Types/Context/ClipboardState.svelte.js +290 -0
  169. package/dist/Components/Table/Types/Context/ColumnLayoutState.svelte.d.ts +17 -45
  170. package/dist/Components/Table/Types/Context/ColumnLayoutState.svelte.js +17 -45
  171. package/dist/Components/Table/Types/Context/FilteringState.svelte.d.ts +9 -20
  172. package/dist/Components/Table/Types/Context/FilteringState.svelte.js +9 -20
  173. package/dist/Components/Table/Types/Context/FocusState.svelte.d.ts +23 -42
  174. package/dist/Components/Table/Types/Context/FocusState.svelte.js +32 -59
  175. package/dist/Components/Table/Types/Context/ITable.d.ts +5 -8
  176. package/dist/Components/Table/Types/Context/PreferencesState.svelte.d.ts +29 -56
  177. package/dist/Components/Table/Types/Context/PreferencesState.svelte.js +28 -55
  178. package/dist/Components/Table/Types/Context/QueryValuesState.svelte.d.ts +50 -0
  179. package/dist/Components/Table/Types/Context/QueryValuesState.svelte.js +62 -0
  180. package/dist/Components/Table/Types/Context/SelectionState.svelte.d.ts +17 -28
  181. package/dist/Components/Table/Types/Context/SelectionState.svelte.js +17 -28
  182. package/dist/Components/Table/Types/Context/SortingState.svelte.d.ts +15 -29
  183. package/dist/Components/Table/Types/Context/SortingState.svelte.js +17 -31
  184. package/dist/Components/Table/Types/Context/TableContext.svelte.d.ts +212 -325
  185. package/dist/Components/Table/Types/Context/TableContext.svelte.js +292 -706
  186. package/dist/Components/Table/Types/Context/VirtualisationState.svelte.d.ts +62 -79
  187. package/dist/Components/Table/Types/Context/VirtualisationState.svelte.js +54 -73
  188. package/dist/Components/Table/Types/DataRepository/BuiltInRemoteRepository.svelte.d.ts +16 -27
  189. package/dist/Components/Table/Types/DataRepository/BuiltInRemoteRepository.svelte.js +16 -27
  190. package/dist/Components/Table/Types/DataRepository/IDataRepository.d.ts +12 -15
  191. package/dist/Components/Table/Types/DataRepository/TableDataRepository.svelte.d.ts +15 -30
  192. package/dist/Components/Table/Types/DataRepository/TableDataRepository.svelte.js +16 -28
  193. package/dist/Components/Table/Types/Header.d.ts +4 -4
  194. package/dist/Components/Table/Types/HeaderGroup.d.ts +5 -5
  195. package/dist/Components/Table/Types/Public/index.d.ts +2 -4
  196. package/dist/Components/Table/Types/Public/index.js +2 -4
  197. package/dist/Components/Table/clipboardEscape.d.ts +32 -0
  198. package/dist/Components/Table/clipboardEscape.js +45 -0
  199. package/dist/Components/Table/createTable.svelte.d.ts +8 -18
  200. package/dist/Components/Table/createTable.svelte.js +19 -47
  201. package/dist/Components/Test/TestContextConsumer.svelte +13 -13
  202. package/dist/Components/TextArea.svelte +130 -130
  203. package/dist/Components/TextInput.svelte +176 -176
  204. package/dist/Components/ThreeStateRadio.svelte +131 -131
  205. package/dist/Components/Touch/BoolCard.svelte +45 -45
  206. package/dist/Components/Touch/DateModal.svelte +209 -209
  207. package/dist/Components/Touch/EditCard.svelte +59 -59
  208. package/dist/Components/Touch/InfoCard.svelte +31 -31
  209. package/dist/Components/Touch/InfoTextCard.svelte +28 -28
  210. package/dist/Components/Touch/ModalExplanation.svelte +17 -17
  211. package/dist/Components/Touch/NumberKeyboard.svelte +225 -225
  212. package/dist/Components/Touch/NumberModal.svelte +79 -79
  213. package/dist/Components/Touch/PlusMinusCard.svelte +46 -46
  214. package/dist/Components/Touch/SelectModal.svelte +123 -123
  215. package/dist/Components/Touch/SummaryCard.svelte +93 -93
  216. package/dist/Components/Touch/TextAreaModal.svelte +95 -95
  217. package/dist/Components/Touch/TextModal.svelte +106 -106
  218. package/dist/Components/Touch/TouchCard.svelte +33 -33
  219. package/dist/Components/Touch/TouchModal.svelte +274 -274
  220. package/dist/Components/Touch/UtilityButton.svelte +109 -109
  221. package/dist/Components/VerticalTabGroup.svelte +79 -79
  222. package/dist/Components/VerticalTabGroupButton.svelte +58 -58
  223. package/dist/Contexts/ToastContext.svelte.js +3 -4
  224. package/dist/Helpers/Datamatrix.d.ts +19 -19
  225. package/dist/Helpers/Datamatrix.js +291 -291
  226. package/dist/Helpers/Helpers.svelte.d.ts +47 -4
  227. package/dist/Helpers/Helpers.svelte.js +97 -4
  228. package/dist/Helpers/dropdownPortal.d.ts +26 -41
  229. package/dist/Helpers/dropdownPortal.js +62 -116
  230. package/dist/Types/Examples/ExampleModal.svelte +35 -35
  231. package/dist/index.d.ts +1 -2
  232. package/dist/index.js +1 -1
  233. package/dist/scss/_basics.scss +12 -12
  234. package/dist/scss/_colours.scss +134 -134
  235. package/dist/scss/_mixins.scss +3358 -3360
  236. package/dist/scss/_motion.scss +57 -57
  237. package/dist/scss/_sizing.scss +85 -85
  238. package/dist/scss/_transitions.scss +8 -8
  239. package/package.json +8 -6
@@ -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>