@zhangt58/svelte-vtable 0.4.0 → 0.4.2

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.
package/README.md CHANGED
@@ -157,7 +157,8 @@ A virtualized table component for efficient rendering of large datasets. The com
157
157
  | `onselect` | `function` | `undefined` | Callback when a row is selected: `({item, index}) => void` |
158
158
  | `onsort` | `function` | `undefined` | Callback when sort changes: `({key, dir}) => void`. When provided, local sorting is skipped (server-side sort pattern). Omit entirely (do not pass `() => {}`) to enable local sorting. |
159
159
  | `inlineFilters` | `boolean` | `false` | Renders column filter buttons in table headers. Without `onfilter`, filters are applied locally to `items`. |
160
- | `columnFilters` | `Array \| null` | `null` | Optional filter configurations, usually from `buildColumnFilters(allRows, columns)`. When omitted, inline filters derive options from `items`. |
160
+ | `columnFilters` | `Array \| null` | `null` | Optional explicit filter configurations, usually from `buildColumnFilters(rows, columns)`. Overrides derived filter options. |
161
+ | `filterItems` | `Array \| null` | `null` | Base data source used to derive inline filter options when `columnFilters` is omitted. Defaults to `items`; pass the unpaged/search-scoped rows when `items` is paged. |
161
162
  | `activeFilters` | `Object` | `{}` | Controlled filter state for inline header filters. |
162
163
  | `onfilter` | `function` | `undefined` | Callback when inline filters change: `({key, values, allFilters}) => void`. When provided, parent code is responsible for applying filters. |
163
164
  | `rowSnippet` | `Snippet` | `undefined` | Svelte 5 snippet for rendering rows. Optional when `columns` is provided (a default row is rendered using each column's `cellSnippet` or raw value). |
@@ -219,7 +220,7 @@ For pagination, server requests, or shared filter controls, keep filters in the
219
220
 
220
221
  ```svelte
221
222
  <script>
222
- import { DataTable, buildColumnFilters, applyFilters } from '@zhangt58/svelte-vtable';
223
+ import { DataTable, applyFilters } from '@zhangt58/svelte-vtable';
223
224
 
224
225
  const rows = [
225
226
  { department: 'Engineering', hireDate: '2024-01-15' },
@@ -230,9 +231,10 @@ For pagination, server requests, or shared filter controls, keep filters in the
230
231
  { key: 'hireDate', label: 'Hire Date', filterType: 'daterange' },
231
232
  ];
232
233
 
233
- const columnFilters = buildColumnFilters(rows, columns);
234
234
  let activeFilters = $state({});
235
- const filteredRows = $derived(applyFilters(rows, activeFilters));
235
+ const optionRows = $derived(rows); // Apply search or server scoping here when needed.
236
+ const filteredRows = $derived(applyFilters(optionRows, activeFilters));
237
+ const pagedRows = $derived(filteredRows.slice(0, 25));
236
238
 
237
239
  function handleFilter({ allFilters }) {
238
240
  activeFilters = { ...allFilters };
@@ -240,15 +242,19 @@ For pagination, server requests, or shared filter controls, keep filters in the
240
242
  </script>
241
243
 
242
244
  <DataTable
243
- items={filteredRows}
245
+ items={pagedRows}
244
246
  {columns}
245
247
  inlineFilters
246
- {columnFilters}
248
+ filterItems={optionRows}
247
249
  {activeFilters}
248
250
  onfilter={handleFilter}
249
251
  />
250
252
  ```
251
253
 
254
+ When `filterItems` and `activeFilters` are provided, derived filter options are faceted per column: each column is built from `filterItems` after applying the other active filters, but not that column's own filter. This keeps date range bounds and value choices available when the current column filter temporarily matches zero rows.
255
+
256
+ Date range quick presets such as `Last 7d` are relative to the current wall-clock date/time. Presets that would match no rows in the current option source are disabled.
257
+
252
258
  #### Column Widths
253
259
 
254
260
  Column widths can be specified as:
@@ -271,17 +277,21 @@ Controls component for search and pagination.
271
277
 
272
278
  #### Props
273
279
 
274
- | Prop | Type | Default | Description |
275
- | ----------------- | ---------- | ----------- | -------------------------------------------------------------------------------------------------------- |
276
- | `search` | `string` | `''` | Current search query |
277
- | `currentPage` | `number` | `1` | Current page number |
278
- | `perPage` | `number` | `25` | Items per page |
279
- | `totalItems` | `number` | `0` | Total number of items |
280
- | `onpage` | `function` | `undefined` | Callback for page changes: `({page}) => void` |
281
- | `onsearch` | `function` | `undefined` | Callback for search changes: `({search}) => void` |
282
- | `onfilterstoggle` | `function` | `undefined` | Callback when filters panel toggled: `({visible}) => void` |
283
- | `onperpage` | `function` | `undefined` | Callback when per-page changes: `({perPage}) => void` |
284
- | `onfilter` | `function` | `undefined` | Callback when filters change (passed through to DataTableFilters): `({key, values, allFilters}) => void` |
280
+ | Prop | Type | Default | Description |
281
+ | ----------------- | --------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------- |
282
+ | `search` | `string` | `''` | Current search query |
283
+ | `currentPage` | `number` | `1` | Current page number |
284
+ | `perPage` | `number` | `25` | Items per page |
285
+ | `totalItems` | `number` | `0` | Total number of items |
286
+ | `onpage` | `function` | `undefined` | Callback for page changes: `({page}) => void` |
287
+ | `onsearch` | `function` | `undefined` | Callback for search changes: `({search}) => void` |
288
+ | `onfilterstoggle` | `function` | `undefined` | Callback when filters panel toggled: `({visible}) => void` |
289
+ | `onperpage` | `function` | `undefined` | Callback when per-page changes: `({perPage}) => void` |
290
+ | `columnFilters` | `Array \| null` | `null` | Optional explicit modal filter configurations. Overrides derived filter options. |
291
+ | `columns` | `ColumnDef[]` | `[]` | Column definitions used with `filterItems` to derive modal filter options. |
292
+ | `filterItems` | `Array \| null` | `null` | Base data source used to derive modal filter options. Pass unpaged/search-scoped rows; active peer filters are applied per column. |
293
+ | `activeFilters` | `Object` | `{}` | Current active filters used for the modal state and faceted option derivation. |
294
+ | `onfilter` | `function` | `undefined` | Callback when filters change (passed through to DataTableFilters): `({key, values, allFilters}) => void` |
285
295
 
286
296
  ### DataTableFilters
287
297
 
@@ -5,8 +5,8 @@
5
5
  import {
6
6
  DEFAULT_RELATIVE_RANGE_PRESETS,
7
7
  applyFilters,
8
- buildColumnFilters,
9
8
  hasActiveFilterValue,
9
+ resolveColumnFilters,
10
10
  } from '../filterUtils.js';
11
11
 
12
12
  // Runic props: accept props via $props() so the component matches the
@@ -31,8 +31,10 @@
31
31
  // Render per-column filter controls in table headers.
32
32
  inlineFilters = false,
33
33
  // Filter configs can be provided from all source rows. When omitted and
34
- // inlineFilters is true, configs are derived from this component's items.
34
+ // inlineFilters is true, configs are derived from filterItems or this component's items.
35
35
  columnFilters = null,
36
+ // Base data source used to build inline filter option lists when columnFilters is omitted.
37
+ filterItems = null,
36
38
  activeFilters = {},
37
39
  // onfilter({ key, values, allFilters }) makes filtering parent-managed.
38
40
  // When omitted, inline filters are applied locally to this table's items.
@@ -65,9 +67,13 @@
65
67
  const colDefMap = $derived(Object.fromEntries(columns.map((c) => [c.key, c])));
66
68
 
67
69
  const effectiveColumnFilters = $derived.by(() => {
68
- if (Array.isArray(columnFilters)) return columnFilters;
69
- if (!inlineFilters) return [];
70
- return buildColumnFilters(items, columns);
70
+ return resolveColumnFilters({
71
+ columnFilters,
72
+ columns,
73
+ filterItems: Array.isArray(filterItems) ? filterItems : items,
74
+ activeFilters,
75
+ enabled: inlineFilters,
76
+ });
71
77
  });
72
78
 
73
79
  const filterDefMap = $derived(
@@ -233,12 +239,12 @@
233
239
  <svelte:window onclick={closeFilter} onkeydown={handleKeydown} />
234
240
 
235
241
  <section class="virtual-data-table {className}" {style}>
236
- {#if sortedItems && sortedItems.length > 0}
242
+ {#if columns.length > 0}
237
243
  <!-- When `virtualize` is false we instruct VirtualList to render as a normal list/table
238
244
  by setting `isDisabled`. This ensures pagination based on item counts shows the
239
245
  exact number of rows expected (useful when rows have variable height). -->
240
246
  <VirtualList
241
- items={sortedItems}
247
+ items={Array.isArray(sortedItems) ? sortedItems : []}
242
248
  isTable
243
249
  isDisabled={!virtualize}
244
250
  class="datatable-table max-w-full max-h-full overflow-auto"
@@ -334,6 +340,9 @@
334
340
  </tr>
335
341
  {/snippet}
336
342
  </VirtualList>
343
+ {#if !sortedItems || sortedItems.length === 0}
344
+ <div class="p-4 text-center text-slate-500">{emptyMessage}</div>
345
+ {/if}
337
346
  {:else}
338
347
  <div class="p-4 text-center text-slate-500">{emptyMessage}</div>
339
348
  {/if}
@@ -16,6 +16,7 @@ declare const DataTable: import("svelte").Component<{
16
16
  onsort?: any;
17
17
  inlineFilters?: boolean;
18
18
  columnFilters?: any;
19
+ filterItems?: any;
19
20
  activeFilters?: Record<string, any>;
20
21
  onfilter?: any;
21
22
  oncolumnsort?: any;
@@ -41,6 +42,7 @@ type $$ComponentProps = {
41
42
  onsort?: any;
42
43
  inlineFilters?: boolean;
43
44
  columnFilters?: any;
45
+ filterItems?: any;
44
46
  activeFilters?: Record<string, any>;
45
47
  onfilter?: any;
46
48
  oncolumnsort?: any;
@@ -1,7 +1,7 @@
1
1
  <script>
2
2
  import FiltersModal from './FiltersModal.svelte';
3
3
  import PaginationBar from './PaginationBar.svelte';
4
- import { countActiveFilters } from '../filterUtils.js';
4
+ import { countActiveFilters, resolveColumnFilters } from '../filterUtils.js';
5
5
 
6
6
  // Props for search, pagination (perPage made bindable using Svelte 5 rune $bindable)
7
7
  let {
@@ -15,8 +15,11 @@
15
15
  filtersVisible = false,
16
16
  // callback when toggle changes: onfilterstoggle({ visible })
17
17
  onfilterstoggle = undefined,
18
- // optional DataTableFilters inputs - when provided, this component will render the filters
19
- columnFilters = [],
18
+ // optional DataTableFilters inputs - explicit configs override derived configs
19
+ columnFilters = null,
20
+ // optional column definitions + base row source used to derive modal filter options
21
+ columns = [],
22
+ filterItems = null,
20
23
  activeFilters = {},
21
24
  // onfilter({ key, values, allFilters }) — passed through to DataTableFilters
22
25
  /** @type {((..._args: any[]) => void) | undefined} */
@@ -26,6 +29,8 @@
26
29
  className = '',
27
30
  // callback when perPage changes: onperpage({ perPage })
28
31
  onperpage = undefined,
32
+ // set false to hide the Filters button (e.g. when inline column filters are in use)
33
+ showFilters = true,
29
34
  } = $props();
30
35
 
31
36
  const perPageOptions = [
@@ -37,6 +42,15 @@
37
42
 
38
43
  const activeFilterCount = $derived(countActiveFilters(activeFilters));
39
44
 
45
+ const effectiveColumnFilters = $derived.by(() =>
46
+ resolveColumnFilters({
47
+ columnFilters,
48
+ columns,
49
+ filterItems,
50
+ activeFilters,
51
+ }),
52
+ );
53
+
40
54
  // totalPages derived from totalItems and perPage
41
55
  const totalPages = $derived(Math.max(1, Math.ceil(totalItems / perPage)));
42
56
 
@@ -184,6 +198,7 @@
184
198
  <div class="flex-1">
185
199
  <div class="flex items-center gap-2">
186
200
  <!-- Styled button to open/close filters modal -->
201
+ {#if showFilters}
187
202
  <div class="flex items-center gap-1 relative">
188
203
  <button
189
204
  type="button"
@@ -225,6 +240,7 @@
225
240
  >
226
241
  {/if}
227
242
  </div>
243
+ {/if}
228
244
 
229
245
  <div class="vtable-search-wrapper relative flex items-center">
230
246
  <svg
@@ -308,15 +324,17 @@
308
324
  </div>
309
325
  </div>
310
326
 
327
+ {#if showFilters}
311
328
  <FiltersModal
312
329
  bind:open={filtersVisible}
313
- {columnFilters}
330
+ columnFilters={effectiveColumnFilters}
314
331
  {activeFilters}
315
332
  {onfilter}
316
333
  {direction}
317
334
  {showCounts}
318
335
  {className}
319
336
  />
337
+ {/if}
320
338
 
321
339
  <style>/* ── Theming contract — override these on :root or any wrapper element ── */
322
340
  :root {
@@ -12,13 +12,16 @@ declare const DataTableControls: import("svelte").Component<{
12
12
  onsearch?: any;
13
13
  filtersVisible?: boolean;
14
14
  onfilterstoggle?: any;
15
- columnFilters?: any[];
15
+ columnFilters?: any;
16
+ columns?: any[];
17
+ filterItems?: any;
16
18
  activeFilters?: Record<string, any>;
17
19
  onfilter?: any;
18
20
  direction?: string;
19
21
  showCounts?: boolean;
20
22
  className?: string;
21
23
  onperpage?: any;
24
+ showFilters?: boolean;
22
25
  }, {}, "perPage">;
23
26
  type $$ComponentProps = {
24
27
  search?: string;
@@ -29,11 +32,14 @@ type $$ComponentProps = {
29
32
  onsearch?: any;
30
33
  filtersVisible?: boolean;
31
34
  onfilterstoggle?: any;
32
- columnFilters?: any[];
35
+ columnFilters?: any;
36
+ columns?: any[];
37
+ filterItems?: any;
33
38
  activeFilters?: Record<string, any>;
34
39
  onfilter?: any;
35
40
  direction?: string;
36
41
  showCounts?: boolean;
37
42
  className?: string;
38
43
  onperpage?: any;
44
+ showFilters?: boolean;
39
45
  };
@@ -7,7 +7,7 @@
7
7
  * - Clear button
8
8
  *
9
9
  * Props:
10
- * column — column config { key, label, type, minValue, maxValue }
10
+ * column — column config { key, label, type, minValue, maxValue, dateValues }
11
11
  * selection — current range selection { from?: string, to?: string }
12
12
  * relativeRangePresets — array of { label, value, unit } presets
13
13
  * onchange — callback({ from?, to? }) called with the updated selection
@@ -29,6 +29,13 @@
29
29
  : new Date(str).getTime();
30
30
  }
31
31
 
32
+ function parseFilterDateEnd(str) {
33
+ if (!str) return NaN;
34
+ return /^\d{4}-\d{2}-\d{2}$/.test(str)
35
+ ? new Date(str + 'T23:59:59.999').getTime()
36
+ : new Date(str).getTime();
37
+ }
38
+
32
39
  function formatAsInputValue(ms, type) {
33
40
  const d = new Date(ms);
34
41
  const pad = (n) => String(n).padStart(2, '0');
@@ -44,6 +51,11 @@
44
51
  const totalMs = $derived(maxMs - minMs);
45
52
  const fromMs = $derived(parseFilterDate(selection.from));
46
53
  const toMs = $derived(parseFilterDate(selection.to));
54
+ const dateValueMs = $derived(
55
+ Array.isArray(column.dateValues)
56
+ ? column.dateValues.map(Number).filter((ms) => Number.isFinite(ms))
57
+ : [],
58
+ );
47
59
 
48
60
  const fromPct = $derived(
49
61
  totalMs > 0 && !isNaN(fromMs)
@@ -72,7 +84,7 @@
72
84
  if (onchange) onchange({ ...selection, to: formatAsInputValue(newToMs, inputType) });
73
85
  }
74
86
 
75
- function setRelativeRange(value, unit) {
87
+ function createRelativeRange(value, unit) {
76
88
  const now = new Date();
77
89
  const from = new Date(now);
78
90
  switch (unit) {
@@ -80,10 +92,12 @@
80
92
  from.setHours(from.getHours() - value);
81
93
  break;
82
94
  case 'day':
83
- from.setDate(from.getDate() - value);
95
+ from.setDate(from.getDate() - (inputType === 'date' ? Math.max(value - 1, 0) : value));
84
96
  break;
85
97
  case 'week':
86
- from.setDate(from.getDate() - value * 7);
98
+ from.setDate(
99
+ from.getDate() - (inputType === 'date' ? Math.max(value * 7 - 1, 0) : value * 7),
100
+ );
87
101
  break;
88
102
  case 'month':
89
103
  from.setMonth(from.getMonth() - value);
@@ -92,13 +106,40 @@
92
106
  from.setFullYear(from.getFullYear() - value);
93
107
  break;
94
108
  }
95
- if (onchange) {
96
- onchange({
97
- from: formatAsInputValue(from.getTime(), inputType),
98
- to: formatAsInputValue(now.getTime(), inputType),
99
- });
109
+ return {
110
+ from: formatAsInputValue(from.getTime(), inputType),
111
+ to: formatAsInputValue(now.getTime(), inputType),
112
+ };
113
+ }
114
+
115
+ function relativeRangeHasMatches(range) {
116
+ const rangeFromMs = parseFilterDate(range.from);
117
+ const rangeToMs = parseFilterDateEnd(range.to);
118
+ if (isNaN(rangeFromMs) || isNaN(rangeToMs)) return true;
119
+
120
+ if (dateValueMs.length > 0) {
121
+ return dateValueMs.some((ms) => ms >= rangeFromMs && ms <= rangeToMs);
122
+ }
123
+
124
+ if (!isNaN(minMs) && !isNaN(maxMs)) {
125
+ return maxMs >= rangeFromMs && minMs <= rangeToMs;
100
126
  }
127
+
128
+ return column.minValue === undefined && column.maxValue === undefined;
101
129
  }
130
+
131
+ function setRelativeRange(value, unit) {
132
+ const range = createRelativeRange(value, unit);
133
+ if (!relativeRangeHasMatches(range)) return;
134
+ if (onchange) onchange(range);
135
+ }
136
+
137
+ const presetStates = $derived(
138
+ applicablePresets.map((preset) => ({
139
+ ...preset,
140
+ disabled: !relativeRangeHasMatches(createRelativeRange(preset.value, preset.unit)),
141
+ })),
142
+ );
102
143
  </script>
103
144
 
104
145
  <div class="p-3 flex flex-col gap-2">
@@ -233,13 +274,16 @@
233
274
  {/if}
234
275
 
235
276
  <!-- Relative-range quick buttons -->
236
- {#if applicablePresets.length > 0}
277
+ {#if presetStates.length > 0}
237
278
  <div class="flex flex-wrap gap-1 pt-1 border-t border-gray-100 dark:border-gray-600">
238
- {#each applicablePresets as preset (preset.label)}
279
+ {#each presetStates as preset (preset.label)}
239
280
  <button
240
281
  type="button"
241
- class="px-2 py-0.5 text-xs rounded border border-blue-400 text-blue-700 dark:text-blue-300 hover:bg-blue-50 dark:hover:bg-blue-900/20 transition-colors"
242
- title="Last {preset.value} {preset.unit}{preset.value !== 1 ? 's' : ''}"
282
+ class="px-2 py-0.5 text-xs rounded border border-blue-400 text-blue-700 dark:text-blue-300 hover:bg-blue-50 dark:hover:bg-blue-900/20 transition-colors disabled:opacity-50 disabled:cursor-not-allowed disabled:hover:bg-transparent dark:disabled:hover:bg-transparent"
283
+ title={preset.disabled
284
+ ? `No matching rows in the last ${preset.value} ${preset.unit}${preset.value !== 1 ? 's' : ''}`
285
+ : `Last ${preset.value} ${preset.unit}${preset.value !== 1 ? 's' : ''}`}
286
+ disabled={preset.disabled}
243
287
  onclick={() => setRelativeRange(preset.value, preset.unit)}
244
288
  >
245
289
  Last {preset.label}
@@ -2,7 +2,7 @@
2
2
  import { Search, Badge, Select } from 'flowbite-svelte';
3
3
  import FiltersModal from './FiltersModal.svelte';
4
4
  import PaginationBar from '../PaginationBar.svelte';
5
- import { countActiveFilters } from '../../filterUtils.js';
5
+ import { countActiveFilters, resolveColumnFilters } from '../../filterUtils.js';
6
6
 
7
7
  // Props for search, pagination (perPage made bindable using Svelte 5 rune $bindable)
8
8
  let {
@@ -16,8 +16,11 @@
16
16
  filtersVisible = false,
17
17
  // callback when toggle changes: onfilterstoggle({ visible })
18
18
  onfilterstoggle = undefined,
19
- // optional DataTableFilters inputs - when provided, this component will render the filters
20
- columnFilters = [],
19
+ // optional DataTableFilters inputs - explicit configs override derived configs
20
+ columnFilters = null,
21
+ // optional column definitions + base row source used to derive modal filter options
22
+ columns = [],
23
+ filterItems = null,
21
24
  activeFilters = {},
22
25
  // onfilter({ key, values, allFilters }) — passed through to DataTableFilters
23
26
  /** @type {((..._args: any[]) => void) | undefined} */
@@ -27,6 +30,8 @@
27
30
  className = '',
28
31
  // callback when perPage changes: onperpage({ perPage })
29
32
  onperpage = undefined,
33
+ // set false to hide the Filters button (e.g. when inline column filters are in use)
34
+ showFilters = true,
30
35
  } = $props();
31
36
 
32
37
  const perPageOptions = [
@@ -38,6 +43,15 @@
38
43
 
39
44
  const activeFilterCount = $derived(countActiveFilters(activeFilters));
40
45
 
46
+ const effectiveColumnFilters = $derived.by(() =>
47
+ resolveColumnFilters({
48
+ columnFilters,
49
+ columns,
50
+ filterItems,
51
+ activeFilters,
52
+ }),
53
+ );
54
+
41
55
  // totalPages derived from totalItems and perPage
42
56
  const totalPages = $derived(Math.max(1, Math.ceil(totalItems / perPage)));
43
57
 
@@ -185,6 +199,7 @@
185
199
  <div class="flex-1">
186
200
  <div class="flex items-center gap-2">
187
201
  <!-- Styled button to open/close filters modal -->
202
+ {#if showFilters}
188
203
  <div class="flex items-center gap-1 relative">
189
204
  <button
190
205
  type="button"
@@ -226,6 +241,7 @@
226
241
  >
227
242
  {/if}
228
243
  </div>
244
+ {/if}
229
245
 
230
246
  <Search
231
247
  size="sm"
@@ -259,15 +275,17 @@
259
275
  </div>
260
276
  </div>
261
277
 
278
+ {#if showFilters}
262
279
  <FiltersModal
263
280
  bind:open={filtersVisible}
264
- {columnFilters}
281
+ columnFilters={effectiveColumnFilters}
265
282
  {activeFilters}
266
283
  {onfilter}
267
284
  {direction}
268
285
  {showCounts}
269
286
  {className}
270
287
  />
288
+ {/if}
271
289
 
272
290
  <style>/* ── Theming contract — override these on :root or any wrapper element ── */
273
291
  :root {
@@ -12,13 +12,16 @@ declare const DataTableControls: import("svelte").Component<{
12
12
  onsearch?: any;
13
13
  filtersVisible?: boolean;
14
14
  onfilterstoggle?: any;
15
- columnFilters?: any[];
15
+ columnFilters?: any;
16
+ columns?: any[];
17
+ filterItems?: any;
16
18
  activeFilters?: Record<string, any>;
17
19
  onfilter?: any;
18
20
  direction?: string;
19
21
  showCounts?: boolean;
20
22
  className?: string;
21
23
  onperpage?: any;
24
+ showFilters?: boolean;
22
25
  }, {}, "perPage">;
23
26
  type $$ComponentProps = {
24
27
  search?: string;
@@ -29,11 +32,14 @@ type $$ComponentProps = {
29
32
  onsearch?: any;
30
33
  filtersVisible?: boolean;
31
34
  onfilterstoggle?: any;
32
- columnFilters?: any[];
35
+ columnFilters?: any;
36
+ columns?: any[];
37
+ filterItems?: any;
33
38
  activeFilters?: Record<string, any>;
34
39
  onfilter?: any;
35
40
  direction?: string;
36
41
  showCounts?: boolean;
37
42
  className?: string;
38
43
  onperpage?: any;
44
+ showFilters?: boolean;
39
45
  };
@@ -10,6 +10,37 @@ export function getFilterType(column: object | string | undefined | null): strin
10
10
  * @returns {boolean}
11
11
  */
12
12
  export function isDateRangeColumn(column: object | string | undefined | null): boolean;
13
+ /**
14
+ * Return active filters excluding one column key.
15
+ * This is used by faceted option builders so a column's own active filter
16
+ * cannot remove the choices needed to change or clear that filter.
17
+ * @param {Object|null|undefined} activeFilters
18
+ * @param {string} excludedKey
19
+ * @returns {Object}
20
+ */
21
+ export function filtersWithoutKey(activeFilters: any | null | undefined, excludedKey: string): any;
22
+ /**
23
+ * Resolve column filter configs from either explicit configs or a row source + columns.
24
+ * Explicit `columnFilters` always wins; otherwise `filterItems` is treated as the
25
+ * base source for derived option lists. In faceted mode, each column is built from
26
+ * rows filtered by the other active filters, but not by that column's own filter.
27
+ * @param {object} opts
28
+ * @param {Array|null|undefined} opts.columnFilters - Explicit filter configs.
29
+ * @param {Array} [opts.columns] - Column definitions used for derived filter configs.
30
+ * @param {Array|null|undefined} [opts.filterItems] - Base row source used to derive filter options.
31
+ * @param {Object|null|undefined} [opts.activeFilters] - Current active filter state.
32
+ * @param {boolean} [opts.enabled] - Whether derived filters should be built.
33
+ * @param {boolean} [opts.faceted] - Whether to derive each column from rows filtered by peer columns.
34
+ * @returns {Array}
35
+ */
36
+ export function resolveColumnFilters({ columnFilters, columns, filterItems, activeFilters, enabled, faceted, }: {
37
+ columnFilters: any[] | null | undefined;
38
+ columns?: any[];
39
+ filterItems?: any[] | null | undefined;
40
+ activeFilters?: any | null | undefined;
41
+ enabled?: boolean;
42
+ faceted?: boolean;
43
+ }): any[];
13
44
  /**
14
45
  * Check whether a single filter value is active.
15
46
  * @param {unknown} value
@@ -32,6 +32,65 @@ export function isDateRangeColumn(column) {
32
32
  return type === 'daterange' || type === 'datetimerange';
33
33
  }
34
34
 
35
+ /**
36
+ * Return active filters excluding one column key.
37
+ * This is used by faceted option builders so a column's own active filter
38
+ * cannot remove the choices needed to change or clear that filter.
39
+ * @param {Object|null|undefined} activeFilters
40
+ * @param {string} excludedKey
41
+ * @returns {Object}
42
+ */
43
+ export function filtersWithoutKey(activeFilters, excludedKey) {
44
+ if (!activeFilters || typeof activeFilters !== 'object') return {};
45
+ const filters = {};
46
+ for (const [key, value] of Object.entries(activeFilters)) {
47
+ if (key !== excludedKey && hasActiveFilterValue(value)) filters[key] = value;
48
+ }
49
+ return filters;
50
+ }
51
+
52
+ /**
53
+ * Resolve column filter configs from either explicit configs or a row source + columns.
54
+ * Explicit `columnFilters` always wins; otherwise `filterItems` is treated as the
55
+ * base source for derived option lists. In faceted mode, each column is built from
56
+ * rows filtered by the other active filters, but not by that column's own filter.
57
+ * @param {object} opts
58
+ * @param {Array|null|undefined} opts.columnFilters - Explicit filter configs.
59
+ * @param {Array} [opts.columns] - Column definitions used for derived filter configs.
60
+ * @param {Array|null|undefined} [opts.filterItems] - Base row source used to derive filter options.
61
+ * @param {Object|null|undefined} [opts.activeFilters] - Current active filter state.
62
+ * @param {boolean} [opts.enabled] - Whether derived filters should be built.
63
+ * @param {boolean} [opts.faceted] - Whether to derive each column from rows filtered by peer columns.
64
+ * @returns {Array}
65
+ */
66
+ export function resolveColumnFilters({
67
+ columnFilters,
68
+ columns = [],
69
+ filterItems = [],
70
+ activeFilters = null,
71
+ enabled = true,
72
+ faceted = true,
73
+ }) {
74
+ if (Array.isArray(columnFilters)) return columnFilters;
75
+ if (!enabled || !Array.isArray(columns) || columns.length === 0) return [];
76
+ const sourceItems = Array.isArray(filterItems) ? filterItems : [];
77
+
78
+ if (!faceted || !hasActiveFilters(activeFilters)) {
79
+ return buildColumnFilters(sourceItems, columns);
80
+ }
81
+
82
+ return columns
83
+ .filter((col) => col.filterType !== 'none')
84
+ .map((col) => {
85
+ const peerFilters = filtersWithoutKey(activeFilters, col.key);
86
+ const filteredItems = hasActiveFilters(peerFilters)
87
+ ? applyFilters(sourceItems, peerFilters)
88
+ : sourceItems;
89
+ return buildColumnFilters(filteredItems, [col])[0];
90
+ })
91
+ .filter(Boolean);
92
+ }
93
+
35
94
  /**
36
95
  * Check whether a single filter value is active.
37
96
  * @param {unknown} value
@@ -93,14 +152,17 @@ export function buildColumnFilters(data, columns) {
93
152
  // offer a dual-range slider and Earliest/Latest shortcut buttons.
94
153
  let minMs = Infinity;
95
154
  let maxMs = -Infinity;
155
+ const dateValueSet = new Set();
96
156
  for (const item of data) {
97
157
  const v = item[col.key];
98
158
  if (v === null || v === undefined || v === '') continue;
99
159
  const str = String(v);
100
160
  const d = /^\d{4}-\d{2}-\d{2}$/.test(str) ? new Date(str + 'T00:00:00') : new Date(str);
101
161
  if (!isNaN(d.getTime())) {
102
- if (d.getTime() < minMs) minMs = d.getTime();
103
- if (d.getTime() > maxMs) maxMs = d.getTime();
162
+ const ms = d.getTime();
163
+ dateValueSet.add(ms);
164
+ if (ms < minMs) minMs = ms;
165
+ if (ms > maxMs) maxMs = ms;
104
166
  }
105
167
  }
106
168
 
@@ -126,6 +188,7 @@ export function buildColumnFilters(data, columns) {
126
188
  counts: {},
127
189
  minValue: hasRange ? fmt(minMs) : null,
128
190
  maxValue: hasRange ? fmt(maxMs) : null,
191
+ dateValues: hasRange ? [...dateValueSet].sort((a, b) => a - b) : [],
129
192
  };
130
193
  }
131
194
  const { uniqueValues, counts } = getUniqueValuesWithCounts(data, col.key);
package/dist/index.d.ts CHANGED
@@ -58,4 +58,4 @@ export type ColumnDef<T extends Record<string, unknown> = Record<string, unknown
58
58
  index: number;
59
59
  }]>;
60
60
  };
61
- export { DEFAULT_RELATIVE_RANGE_PRESETS, getFilterType, getUniqueValuesWithCounts, buildColumnFilters, applyFilters, matchesDateRange, isDateRangeColumn, hasActiveFilterValue, countActiveFilterValue, hasActiveFilters, countActiveFilters, clearAllFilters, filtersToSearchParams, searchParamsToFilters } from "./filterUtils.js";
61
+ export { DEFAULT_RELATIVE_RANGE_PRESETS, getFilterType, filtersWithoutKey, resolveColumnFilters, getUniqueValuesWithCounts, buildColumnFilters, applyFilters, matchesDateRange, isDateRangeColumn, hasActiveFilterValue, countActiveFilterValue, hasActiveFilters, countActiveFilters, clearAllFilters, filtersToSearchParams, searchParamsToFilters } from "./filterUtils.js";
package/dist/index.js CHANGED
@@ -13,6 +13,8 @@ export { useFilterState } from './components/filters/useFilterState.svelte.js';
13
13
  export {
14
14
  DEFAULT_RELATIVE_RANGE_PRESETS,
15
15
  getFilterType,
16
+ filtersWithoutKey,
17
+ resolveColumnFilters,
16
18
  getUniqueValuesWithCounts,
17
19
  buildColumnFilters,
18
20
  applyFilters,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zhangt58/svelte-vtable",
3
- "version": "0.4.0",
3
+ "version": "0.4.2",
4
4
  "description": "A Svelte 5 library for virtualized data tables with sorting, selection, and pagination controls.",
5
5
  "type": "module",
6
6
  "sideEffects": [