@serkonda7/solid-components 0.0.2 → 0.0.3

package/README.md

@@ -14,31 +14,21 @@ bun install @serkonda7/solid-components solid-js
 
 ## 🚀 Usage
 ```tsx
-import { /* Component */ } from 'solid-components'
+import { DataTable } from '@serkonda7/solid-components'
 import '@serkonda7/solid-components/styles.css'
-```
-
-These components are available:
-- `DataTable` - generic table with optional sorting, row selection, actions, loading, and empty states.
-
-
-## Components
-### DataTable
-The table does not fetch data or perform navigation.
-Consumers provide the rows, cell rendering, and callbacks:
 
-```tsx
 <DataTable
   rows={items}
   getRowId={(item) => item.id}
-  columns={[{ key: 'name', label: 'Name', sortable: true }]}
-  sortKey={sortKey}
-  sortDirection={sortDirection}
-  onSort={setSortKey}
-  getCell={(item, column) => column.key === 'name' ? item.name : null}
+  columns={[{ key: 'name', label: 'Name' }]}
 />
 ```
 
+These components are available:
+- `DataTable` - generic table with optional sorting, row selection, actions, loading, empty states, and column customizer.
+
+For the full API, examples, and agent notes, see [docs.md](docs.md).
+
 
 ## 📜 License
 This repo is licensed under the [MIT License](LICENSE.txt).

package/dist/data-table.d.ts

@@ -7,6 +7,10 @@ export interface DataTableColumn<TRow> {
     class?: string;
     ariaLabel?: string;
     getValue?: (row: TRow) => JSX.Element;
+    /** Whether the column is visible by default when the column customizer is used. Defaults to `true`. */
+    defaultVisible?: boolean;
+    /** Whether the column can be hidden via the column customizer. Defaults to `true`. Non-toggleable columns are always shown. */
+    toggleable?: boolean;
 }
 export interface DataTableProps<TRow> {
     rows: TRow[] | Accessor<TRow[]>;
@@ -20,6 +24,14 @@ export interface DataTableProps<TRow> {
     sortKey?: string | Accessor<string | undefined>;
     sortDirection?: DataTableSortDirection | Accessor<DataTableSortDirection>;
     onSort?: (key: string) => void;
+    visibleColumns?: string[] | Accessor<string[]>;
+    defaultVisibleColumns?: string[];
+    onVisibleColumnsChange?: (visibleKeys: string[]) => void;
+    showColumnCustomizer?: boolean | Accessor<boolean>;
+    columnCustomizerLabel?: string;
+    columnCustomizerTitle?: string;
+    columnCustomizerShowAllLabel?: string;
+    columnCustomizerResetLabel?: string;
     loading?: boolean | Accessor<boolean>;
     empty?: boolean | Accessor<boolean>;
     loadingContent?: JSX.Element;

package/dist/index.js

@@ -1,49 +1,110 @@
 import { className as e, createComponent as t, delegateEvents as n, effect as r, insert as i, memo as a, setAttribute as o, template as s, use as c } from "solid-js/web";
-import { For as l, Show as u, createEffect as d, createMemo as f } from "solid-js";
+import { For as l, Show as u, createEffect as d, createMemo as f, createSignal as p, createUniqueId as m, onCleanup as h } from "solid-js";
 //#region src/data-table.tsx
-var p = /*#__PURE__*/ s("<th class=data-table-checkbox><span class=data-table-visually-hidden>Select rows</span><input type=checkbox>"), m = /*#__PURE__*/ s("<th>Actions"), h = /*#__PURE__*/ s("<div><table class=data-table><thead><tr></tr></thead><tbody>"), g = /*#__PURE__*/ s("<button type=button class=data-table-sort>"), _ = /*#__PURE__*/ s("<th>"), v = /*#__PURE__*/ s("<td class=data-table-checkbox><input type=checkbox>"), y = /*#__PURE__*/ s("<td>"), b = /*#__PURE__*/ s("<tr>"), x = /*#__PURE__*/ s("<p class=data-table-status>Loading…"), S = /*#__PURE__*/ s("<p class=data-table-status>No results.");
-function C(e) {
+var g = /*#__PURE__*/ s("<div role=dialog class=data-table-customizer-panel><p class=data-table-customizer-title></p><ul class=data-table-customizer-list></ul><div class=data-table-customizer-actions><button type=button></button><button type=button>"), _ = /*#__PURE__*/ s("<div class=data-table-toolbar><div class=data-table-customizer><button type=button class=data-table-customizer-button aria-haspopup=dialog><span aria-hidden=true>⚙</span> "), v = /*#__PURE__*/ s("<th class=data-table-checkbox><span class=data-table-visually-hidden>Select rows</span><input type=checkbox>"), y = /*#__PURE__*/ s("<th>Actions"), b = /*#__PURE__*/ s("<div><div class=data-table-scroll><table class=data-table><thead><tr></tr></thead><tbody>"), x = /*#__PURE__*/ s("<li><label class=data-table-customizer-option><input type=checkbox>"), S = /*#__PURE__*/ s("<button type=button class=data-table-sort>"), C = /*#__PURE__*/ s("<th>"), ee = /*#__PURE__*/ s("<td class=data-table-checkbox><input type=checkbox>"), w = /*#__PURE__*/ s("<td>"), T = /*#__PURE__*/ s("<tr>"), E = /*#__PURE__*/ s("<p class=data-table-status>Loading…"), D = /*#__PURE__*/ s("<p class=data-table-status>No results.");
+function O(e) {
 	return typeof e == "function" ? e() : e;
 }
-function w(n) {
-	let s = f(() => C(n.rows)), w = () => C(n.loading ?? !1), T = () => C(n.selected ?? []), E = () => C(n.sortKey ?? void 0), D = () => C(n.sortDirection ?? "asc"), O = () => n.selected !== void 0 && n.onSelectionChange !== void 0, k = () => {
-		let e = T();
+function k(n) {
+	let s = f(() => O(n.rows)), k = () => O(n.loading ?? !1), A = () => O(n.selected ?? []), j = () => O(n.sortKey ?? void 0), M = () => O(n.sortDirection ?? "asc"), N = () => O(n.showColumnCustomizer ?? !1), P = () => n.selected !== void 0 && n.onSelectionChange !== void 0, F = () => {
+		let e = A();
 		return s().length > 0 && s().every((t) => e.includes(n.getRowId(t)));
-	}, A;
+	}, I = f(() => n.defaultVisibleColumns ?? n.columns.filter((e) => e.defaultVisible !== !1).map((e) => e.key)), [L, R] = p(void 0), z = () => n.visibleColumns === void 0 ? L() ?? I() : O(n.visibleColumns), B = f(() => new Set(z())), V = f(() => n.columns.filter((e) => e.toggleable === !1 || B().has(e.key))), H = f(() => n.columns.filter((e) => e.toggleable !== !1)), U = f(() => H().map((e) => e.key));
+	function W(e) {
+		let t = new Map(n.columns.map((e, t) => [e.key, t]));
+		return [...e].sort((e, n) => (t.get(e) ?? 0) - (t.get(n) ?? 0));
+	}
+	function G(e) {
+		let t = W(e);
+		n.visibleColumns === void 0 && R(t), n.onVisibleColumnsChange?.(t);
+	}
+	function K(e, t) {
+		let n = new Set(z());
+		t ? n.add(e) : n.delete(e), G(U().filter((e) => n.has(e)));
+	}
+	function q() {
+		G(U());
+	}
+	function J() {
+		G(I());
+	}
+	let Y = `${m()}-panel`, [X, Z] = p(!1), Q;
+	d(() => {
+		if (!X() || !N()) return;
+		function e(e) {
+			Q && !Q.contains(e.target) && Z(!1);
+		}
+		function t(e) {
+			e.key === "Escape" && Z(!1);
+		}
+		document.addEventListener("pointerdown", e), document.addEventListener("keydown", t), h(() => {
+			document.removeEventListener("pointerdown", e), document.removeEventListener("keydown", t);
+		});
+	});
+	let $;
 	d(() => {
-		A && (A.indeterminate = T().length > 0 && !k());
+		$ && ($.indeterminate = A().length > 0 && !F());
 	});
-	function j(e) {
+	function te(e) {
 		n.onSelectionChange?.(e ? s().map(n.getRowId) : []);
 	}
-	function M(e, t) {
-		let r = n.getRowId(e), i = T(), a = t ? [...i, r] : i.filter((e) => e !== r);
+	function ne(e, t) {
+		let r = n.getRowId(e), i = A(), a = t ? [...i, r] : i.filter((e) => e !== r);
 		n.onSelectionChange?.(a);
 	}
-	function N(e) {
-		return T().includes(n.getRowId(e));
+	function re(e) {
+		return A().includes(n.getRowId(e));
+	}
+	function ie(e) {
+		return e.toggleable === !1 || B().has(e.key);
 	}
-	function P(e, t) {
+	function ae(e, t) {
 		return n.getCell?.(e, t) ?? t.getValue?.(e) ?? null;
 	}
 	return (() => {
-		var d = h(), f = d.firstChild.firstChild, T = f.firstChild, F = f.nextSibling;
-		return i(T, t(u, {
+		var d = b(), f = d.firstChild, p = f.firstChild.firstChild, m = p.firstChild, h = p.nextSibling;
+		return i(d, t(u, {
+			get when() {
+				return N();
+			},
+			get children() {
+				var e = _(), a = e.firstChild, s = a.firstChild;
+				s.firstChild.nextSibling;
+				var d = Q;
+				return typeof d == "function" ? c(d, a) : Q = a, s.$$click = () => Z((e) => !e), o(s, "aria-controls", Y), i(s, () => n.columnCustomizerLabel ?? "Columns", null), i(a, t(u, {
+					get when() {
+						return X();
+					},
+					get children() {
+						var e = g(), a = e.firstChild, s = a.nextSibling, c = s.nextSibling.firstChild, u = c.nextSibling;
+						return o(e, "id", Y), i(a, () => n.columnCustomizerTitle ?? "Shown columns"), i(s, t(l, {
+							get each() {
+								return n.columns;
+							},
+							children: (e) => (() => {
+								var t = x(), n = t.firstChild, a = n.firstChild;
+								return a.addEventListener("change", (t) => K(e.key, t.currentTarget.checked)), i(n, () => e.ariaLabel ?? e.label, null), r(() => a.disabled = e.toggleable === !1), r(() => a.checked = ie(e)), t;
+							})()
+						})), c.$$click = q, i(c, () => n.columnCustomizerShowAllLabel ?? "Show all"), u.$$click = J, i(u, () => n.columnCustomizerResetLabel ?? "Reset"), r(() => o(e, "aria-label", n.columnCustomizerTitle ?? "Customize columns")), e;
+					}
+				}), null), r(() => o(s, "aria-expanded", X())), e;
+			}
+		}), f), i(m, t(u, {
 			get when() {
-				return O();
+				return P();
 			},
 			get children() {
-				var e = p(), t = e.firstChild.nextSibling;
-				t.addEventListener("change", (e) => j(e.currentTarget.checked));
-				var i = A;
-				return typeof i == "function" ? c(i, t) : A = t, r(() => o(t, "aria-label", n.selectionLabel ?? "Select all rows")), r(() => t.checked = k()), e;
+				var e = v(), t = e.firstChild.nextSibling;
+				t.addEventListener("change", (e) => te(e.currentTarget.checked));
+				var i = $;
+				return typeof i == "function" ? c(i, t) : $ = t, r(() => o(t, "aria-label", n.selectionLabel ?? "Select all rows")), r(() => t.checked = F()), e;
 			}
-		}), null), i(T, t(l, {
+		}), null), i(m, t(l, {
 			get each() {
-				return n.columns;
+				return V();
 			},
 			children: (s) => (() => {
-				var c = _();
+				var c = C();
 				return i(c, t(u, {
 					get when() {
 						return a(() => !!s.sortable)() && n.onSort;
@@ -52,76 +113,76 @@ function w(n) {
 						return s.label;
 					},
 					get children() {
-						var e = g();
+						var e = S();
 						return e.$$click = () => n.onSort?.(s.key), i(e, () => s.label, null), i(e, (() => {
-							var e = a(() => E() === s.key);
-							return () => e() ? D() === "asc" ? " ▲" : " ▼" : "";
+							var e = a(() => j() === s.key);
+							return () => e() ? M() === "asc" ? " ▲" : " ▼" : "";
 						})(), null), e;
 					}
 				})), r((t) => {
-					var n = s.class, r = s.sortable ? E() === s.key ? D() === "asc" ? "ascending" : "descending" : "none" : void 0;
+					var n = s.class, r = s.sortable ? j() === s.key ? M() === "asc" ? "ascending" : "descending" : "none" : void 0;
 					return n !== t.e && e(c, t.e = n), r !== t.t && o(c, "aria-sort", t.t = r), t;
 				}, {
 					e: void 0,
 					t: void 0
 				}), c;
 			})()
-		}), null), i(T, t(u, {
+		}), null), i(m, t(u, {
 			get when() {
 				return n.rowActions;
 			},
 			get children() {
-				return m();
+				return y();
 			}
-		}), null), i(F, t(l, {
+		}), null), i(h, t(l, {
 			get each() {
 				return s();
 			},
 			children: (a) => (() => {
-				var s = b();
+				var s = T();
 				return i(s, t(u, {
 					get when() {
-						return O();
+						return P();
 					},
 					get children() {
-						var e = v(), t = e.firstChild;
-						return t.addEventListener("change", (e) => M(a, e.currentTarget.checked)), r(() => o(t, "aria-label", `Select row ${n.getRowId(a)}`)), r(() => t.checked = N(a)), e;
+						var e = ee(), t = e.firstChild;
+						return t.addEventListener("change", (e) => ne(a, e.currentTarget.checked)), r(() => o(t, "aria-label", `Select row ${n.getRowId(a)}`)), r(() => t.checked = re(a)), e;
 					}
 				}), null), i(s, t(l, {
 					get each() {
-						return n.columns;
+						return V();
 					},
 					children: (t) => (() => {
-						var n = y();
-						return i(n, () => P(a, t)), r(() => e(n, t.class)), n;
+						var n = w();
+						return i(n, () => ae(a, t)), r(() => e(n, t.class)), n;
 					})()
 				}), null), i(s, t(u, {
 					get when() {
 						return n.rowActions;
 					},
 					get children() {
-						var e = y();
+						var e = w();
 						return i(e, () => n.rowActions?.(a)), e;
 					}
 				}), null), s;
 			})()
 		})), i(d, t(u, {
 			get when() {
-				return w();
+				return k();
 			},
 			get children() {
-				return n.loadingContent ?? x();
+				return n.loadingContent ?? E();
 			}
 		}), null), i(d, t(u, {
 			get when() {
-				return a(() => !w())() && (n.empty === void 0 ? s().length === 0 : C(n.empty));
+				return a(() => !k())() && (n.empty === void 0 ? s().length === 0 : O(n.empty));
 			},
 			get children() {
-				return n.emptyContent ?? S();
+				return n.emptyContent ?? D();
 			}
 		}), null), r(() => e(d, `data-table-wrap${n.class ? ` ${n.class}` : ""}`)), d;
 	})();
 }
 n(["click"]);
 //#endregion
-export { w as DataTable };
+export { k as DataTable };

package/dist/styles.css

@@ -1,7 +1,95 @@
 .data-table-wrap {
+	/* `color-scheme` is intentionally inherited so `light-dark()` below follows
+	the consumer's theme (e.g. the dark example). */
+}
+
+.data-table-scroll {
 	overflow-x: auto;
 }
 
+.data-table-toolbar {
+	display: flex;
+	justify-content: flex-end;
+	margin-bottom: 0.5rem;
+}
+
+.data-table-customizer {
+	position: relative;
+}
+
+.data-table-customizer-button {
+	display: inline-flex;
+	align-items: center;
+	gap: 0.375rem;
+	padding: 0.375rem 0.625rem;
+	border: 1px solid
+		var(--data-table-border, var(--border, light-dark(#d0d0d0, #3a3e45)));
+	border-radius: 0.375rem;
+	background: var(
+		--data-table-customizer-bg,
+		var(--surface, light-dark(#ffffff, #1d2024))
+	);
+	color: inherit;
+	font: inherit;
+	cursor: pointer;
+	white-space: nowrap;
+}
+
+.data-table-customizer-button:hover {
+	background: var(
+		--data-table-customizer-hover-bg,
+		var(--surface-hover, light-dark(#f5f5f5, #292d33))
+	);
+}
+
+.data-table-customizer-panel {
+	position: absolute;
+	top: calc(100% + 0.375rem);
+	right: 0;
+	z-index: 20;
+	min-width: 12rem;
+	padding: 0.75rem;
+	border: 1px solid
+		var(--data-table-border, var(--border, light-dark(#d0d0d0, #30343a)));
+	border-radius: 0.5rem;
+	background: var(
+		--data-table-panel-bg,
+		var(--surface, light-dark(#ffffff, #1d2024))
+	);
+	box-shadow: 0 8px 24px rgb(0 0 0 / 12%);
+}
+
+.data-table-customizer-title {
+	margin: 0 0 0.5rem;
+	font-weight: 600;
+}
+
+.data-table-customizer-list {
+	margin: 0;
+	padding: 0;
+	list-style: none;
+	display: grid;
+	gap: 0.375rem;
+}
+
+.data-table-customizer-option {
+	display: flex;
+	align-items: center;
+	gap: 0.5rem;
+	cursor: pointer;
+}
+
+.data-table-customizer-option:has(input:disabled) {
+	opacity: 0.6;
+	cursor: not-allowed;
+}
+
+.data-table-customizer-actions {
+	display: flex;
+	gap: 0.5rem;
+	margin-top: 0.75rem;
+}
+
 .data-table {
 	width: 100%;
 	max-width: 100%;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serkonda7/solid-components",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Reusable components for SolidJS",
   "license": "MIT",
   "author": "serkonda7",