@serkonda7/solid-components 0.0.1 → 0.0.3

package/README.md

@@ -1,36 +1,41 @@
-# solid-components
+# @serkonda7/solid-components
+[![CI][ci-badge]][ci-status]
+[![npm version][npm-badge]][npm-link]
+[![npm updated][npm-date-badge]][npm-link]
 
 Reusable components for [SolidJS](https://www.solidjs.com/).
 
-## Installation
 
+## 📦 Installation
 ```sh
-bun add solid-components solid-js
-# or: npm install solid-components solid-js
+bun install @serkonda7/solid-components solid-js
 ```
 
-## Usage
-
-Import components from the package root:
 
+## 🚀 Usage
 ```tsx
-import { /* Component */ } from 'solid-components';
+import { DataTable } from '@serkonda7/solid-components'
+import '@serkonda7/solid-components/styles.css'
+
+<DataTable
+  rows={items}
+  getRowId={(item) => item.id}
+  columns={[{ key: 'name', label: 'Name' }]}
+/>
 ```
 
-The package is currently a foundation for the component library. Components
-will be added to `src/` and re-exported from `src/index.ts`.
+These components are available:
+- `DataTable` - generic table with optional sorting, row selection, actions, loading, empty states, and column customizer.
 
-## Development
+For the full API, examples, and agent notes, see [docs.md](docs.md).
 
-Install [Bun](https://bun.sh/), then run:
 
-```sh
-bun install
-bun run test       # type-check, build, and run tests
-bun run lint:ci    # check formatting and lint rules
-bun run build      # create the production package in dist/
-```
+## 📜 License
+This repo is licensed under the [MIT License](LICENSE.txt).
 
-## License
 
-MIT
+[ci-badge]: https://github.com/serkonda7/solid-components/actions/workflows/ci.yml/badge.svg
+[ci-status]: https://github.com/serkonda7/solid-components/actions/workflows/ci.yml
+[npm-badge]: https://nodei.co/npm/@serkonda7/solid-components.png?style=shields&data=v&color=blue
+[npm-date-badge]: https://nodei.co/npm/@serkonda7/solid-components.png?style=shields&data=u&color=blue
+[npm-link]: https://www.npmjs.com/package/@serkonda7/solid-components

package/dist/data-table.d.ts

@@ -0,0 +1,46 @@
+import type { Accessor, JSX } from 'solid-js';
+export type DataTableSortDirection = 'asc' | 'desc';
+export interface DataTableColumn<TRow> {
+    key: string;
+    label: string;
+    sortable?: boolean;
+    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[]>;
+    columns: DataTableColumn<TRow>[];
+    getRowId: (row: TRow) => string | number;
+    getCell?: (row: TRow, column: DataTableColumn<TRow>) => JSX.Element;
+    rowActions?: (row: TRow) => JSX.Element;
+    selected?: string[] | number[] | Accessor<string[] | number[]>;
+    onSelectionChange?: (ids: (string | number)[]) => void;
+    selectionLabel?: string;
+    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;
+    emptyContent?: JSX.Element;
+    class?: string;
+}
+/**
+ * Generic accessible data table. Data fetching, navigation, and cell content
+ * stay with the consuming app; this component owns table structure and the
+ * repeated selection/sort/loading states.
+ */
+export declare function DataTable<TRow>(props: DataTableProps<TRow>): JSX.Element;

package/dist/index.d.ts

@@ -4,4 +4,4 @@
  * Add components here as they are implemented so consumers can import them
  * from the package root.
  */
-export {};
+export { DataTable, type DataTableColumn, type DataTableProps, type DataTableSortDirection, } from './data-table';

package/dist/index.js

@@ -1,2 +1,188 @@
-
-//# debugId=1B152D275122871864756E2164756E21
+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, createSignal as p, createUniqueId as m, onCleanup as h } from "solid-js";
+//#region src/data-table.tsx
+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 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)));
+	}, 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(() => {
+		$ && ($.indeterminate = A().length > 0 && !F());
+	});
+	function te(e) {
+		n.onSelectionChange?.(e ? s().map(n.getRowId) : []);
+	}
+	function ne(e, t) {
+		let r = n.getRowId(e), i = A(), a = t ? [...i, r] : i.filter((e) => e !== r);
+		n.onSelectionChange?.(a);
+	}
+	function re(e) {
+		return A().includes(n.getRowId(e));
+	}
+	function ie(e) {
+		return e.toggleable === !1 || B().has(e.key);
+	}
+	function ae(e, t) {
+		return n.getCell?.(e, t) ?? t.getValue?.(e) ?? null;
+	}
+	return (() => {
+		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 P();
+			},
+			get children() {
+				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(m, t(l, {
+			get each() {
+				return V();
+			},
+			children: (s) => (() => {
+				var c = C();
+				return i(c, t(u, {
+					get when() {
+						return a(() => !!s.sortable)() && n.onSort;
+					},
+					get fallback() {
+						return s.label;
+					},
+					get children() {
+						var e = S();
+						return e.$$click = () => n.onSort?.(s.key), i(e, () => s.label, null), i(e, (() => {
+							var e = a(() => j() === s.key);
+							return () => e() ? M() === "asc" ? " ▲" : " ▼" : "";
+						})(), null), e;
+					}
+				})), r((t) => {
+					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(m, t(u, {
+			get when() {
+				return n.rowActions;
+			},
+			get children() {
+				return y();
+			}
+		}), null), i(h, t(l, {
+			get each() {
+				return s();
+			},
+			children: (a) => (() => {
+				var s = T();
+				return i(s, t(u, {
+					get when() {
+						return P();
+					},
+					get children() {
+						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 V();
+					},
+					children: (t) => (() => {
+						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 = w();
+						return i(e, () => n.rowActions?.(a)), e;
+					}
+				}), null), s;
+			})()
+		})), i(d, t(u, {
+			get when() {
+				return k();
+			},
+			get children() {
+				return n.loadingContent ?? E();
+			}
+		}), null), i(d, t(u, {
+			get when() {
+				return a(() => !k())() && (n.empty === void 0 ? s().length === 0 : O(n.empty));
+			},
+			get children() {
+				return n.emptyContent ?? D();
+			}
+		}), null), r(() => e(d, `data-table-wrap${n.class ? ` ${n.class}` : ""}`)), d;
+	})();
+}
+n(["click"]);
+//#endregion
+export { k as DataTable };

package/dist/styles.css

@@ -0,0 +1,132 @@
+.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%;
+	border-collapse: collapse;
+}
+
+.data-table-checkbox {
+	width: 2rem;
+}
+
+.data-table-sort {
+	padding: 0;
+	border: none;
+	background: transparent;
+	color: inherit;
+	font: inherit;
+	text-transform: inherit;
+	letter-spacing: inherit;
+	cursor: pointer;
+	white-space: nowrap;
+}
+
+.data-table-sort:hover {
+	background: transparent;
+	color: inherit;
+	text-decoration: underline;
+}
+
+.data-table-status {
+	color: var(--text-secondary, #616161);
+}
+
+.data-table-visually-hidden {
+	position: absolute;
+	width: 1px;
+	height: 1px;
+	overflow: hidden;
+	clip: rect(0 0 0 0);
+	white-space: nowrap;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serkonda7/solid-components",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Reusable components for SolidJS",
   "license": "MIT",
   "author": "serkonda7",
@@ -18,7 +18,8 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
-    }
+    },
+    "./styles.css": "./dist/styles.css"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -27,6 +28,7 @@
     "lint": "biome check --write",
     "lint:ci": "biome ci",
     "check": "tsc --noEmit",
+    "examples": "vite --config examples/vite.config.ts",
     "build:dev": "bun run scripts/build.ts --dev",
     "build": "bun run check && bun run scripts/build.ts --prod",
     "prepack": "bun run build"
@@ -42,6 +44,8 @@
     "@biomejs/biome": "2.5.14",
     "@types/bun": "1.4.2",
     "solid-js": "~1.9.15",
-    "typescript": "~7.0.2"
+    "typescript": "~7.0.2",
+    "vite": "~8.3.0",
+    "vite-plugin-solid": "~2.11.14"
   }
 }

package/dist/index.js.map

@@ -1,9 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [
-  ],
-  "mappings": "",
-  "debugId": "1B152D275122871864756E2164756E21",
-  "names": []
-}