@zhangt58/svelte-vtable 0.1.3 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/src/lib/index.js CHANGED
@@ -2,6 +2,12 @@ export { default as DataTableControls } from '../components/DataTableControls.sv
2
2
  export { default as DataTableFilters } from '../components/DataTableFilters.svelte';
3
3
  export { default as DataTable } from '../components/DataTable.svelte';
4
4
 
5
+ // Filter sub-components (individually importable)
6
+ export { default as FilterColumn } from '../components/filters/FilterColumn.svelte';
7
+ export { default as FilterValueList } from '../components/filters/FilterValueList.svelte';
8
+ export { default as FilterDateRange } from '../components/filters/FilterDateRange.svelte';
9
+ export { useFilterState } from '../components/filters/useFilterState.svelte.js';
10
+
5
11
  // Export filter utility functions
6
12
  export {
7
13
  getUniqueValuesWithCounts,
@@ -14,3 +20,30 @@ export {
14
20
  filtersToSearchParams,
15
21
  searchParamsToFilters,
16
22
  } from './filterUtils.js';
23
+
24
+ /**
25
+ * Unified column definition for DataTable.
26
+ * Pass an array of `ColumnDef` objects as the `columns` prop to configure
27
+ * visible keys, widths, sorting, filters, and custom snippets from a single place.
28
+ *
29
+ * @template {Record<string, unknown>} [T=Record<string, unknown>]
30
+ * @typedef {Object} ColumnDef
31
+ * @property {string} key - Data key. Must match a property on the row item.
32
+ * @property {string} [label] - Display label for the column header. Defaults to `key`.
33
+ * @property {number|string} [width] - Column width: a stretch weight (number) or a
34
+ * CSS width value such as `'120px'`. Defaults to `1` (equal stretch).
35
+ * @property {boolean} [sortable] - Whether clicking the column header sorts the
36
+ * table. Defaults to `true`.
37
+ * @property {'value'|'daterange'|'datetimerange'|'none'} [filterType]
38
+ * Filter UI to render for this column:
39
+ * - `'value'` — checkbox list of unique values (default)
40
+ * - `'daterange'` — date-only range picker
41
+ * - `'datetimerange'` — datetime range picker
42
+ * - `'none'` — no filter UI for this column
43
+ * @property {import('svelte').Snippet<[{key: string, label: string, sortKey: string|null, sortDir: string}]>} [headerSnippet]
44
+ * Custom Svelte 5 snippet rendered inside the `<th>`. Receives
45
+ * `{ key, label, sortKey, sortDir }`.
46
+ * @property {import('svelte').Snippet<[{item: T, value: unknown, index: number}]>} [cellSnippet]
47
+ * Custom Svelte 5 snippet rendered inside each `<td>` for this column.
48
+ * Receives `{ item, value, index }`. When omitted the raw value is rendered.
49
+ */
@@ -1,3 +1,17 @@
1
+ /* ── Theming contract — override these on :root or any wrapper element ── */
2
+ :root {
3
+ --vtable-color-accent: #16a34a; /* green-600 */
4
+ --vtable-color-accent-light: #dcfce7; /* green-100 */
5
+ --vtable-color-accent-border: #22c55e; /* green-500 */
6
+ --vtable-color-accent-text: #15803d; /* green-700 */
7
+
8
+ --vtable-color-danger: #dc2626; /* red-600 */
9
+ --vtable-color-info: #3b82f6; /* blue-500 */
10
+
11
+ --vtable-radius: 0.375rem; /* rounded-md */
12
+ --vtable-row-height: 2.25rem; /* default row height hint for virtual scroll */
13
+ }
14
+
1
15
  .virtual-data-table {
2
16
  display: block;
3
17
  min-width: 0;
@@ -220,11 +234,11 @@
220
234
  color: #fff;
221
235
  }
222
236
 
223
- /* Force the active/current page to use the green tokens (override flowbite's primary/orange).
237
+ /* Force the active/current page to use the accent tokens (override flowbite's primary/orange).
224
238
  Intentionally specific to reliably win over third-party rules. */
225
239
  :global([data-pagination-id] ul li [aria-current='page']) {
226
- background-color: #dcfce7 !important; /* bg-green-100 */
227
- color: #16a34a !important; /* text-green-600 */
240
+ background-color: var(--vtable-color-accent-light) !important;
241
+ color: var(--vtable-color-accent) !important;
228
242
  border-color: transparent !important;
229
243
  }
230
244