From 83f76297b56611cf8ff8f7c03afff3015dabd87e Mon Sep 17 00:00:00 2001
From: Eli Ribble <eli@gleipnir.technology>
Date: Mon, 18 May 2026 15:21:01 +0000
Subject: [PATCH] Add generic layout of listing cards

This should eventually by ported to other interfaces for consistency.
---
 ts/components/ListCardContact.vue         |  57 ++++++++++++
 ts/components/ReviewContactColumnList.vue | 105 +++++++++++++++++++++-
 ts/components/layout/ListCard.vue         |  98 ++++++++++++++++++++
 ts/store/resource.ts                      |   4 +
 ts/view/review/Contact.vue                |   5 +-
 5 files changed, 267 insertions(+), 2 deletions(-)
 create mode 100644 ts/components/ListCardContact.vue
 create mode 100644 ts/components/layout/ListCard.vue

diff --git a/ts/components/ListCardContact.vue b/ts/components/ListCardContact.vue
new file mode 100644
index 00000000..b1daaf19
--- /dev/null
+++ b/ts/components/ListCardContact.vue
@@ -0,0 +1,57 @@
+<style scoped lang="scss">
+.report-card {
+	cursor: pointer;
+	transition: background-color 0.2s;
+}
+
+.report-card:hover {
+	background-color: $secondary;
+}
+
+.report-card.active {
+	background-color: $primary;
+	color: white;
+}
+.reports-list {
+	overflow-y: auto;
+	max-height: 100vh;
+}
+</style>
+
+<template>
+	<!-- First row: icon, type badge, and time -->
+	<div
+		class="align-items-center justify-content-between list-group-item p-3 report-card"
+		:class="{ active: isSelected }"
+	>
+		<div class="row">
+			<div class="d-flex align-items-center">
+				<div class="col">
+					<i
+						class="bi fs-4 me-2"
+						:class="{ 'bi-envelope': contact.emails.length != 0 }"
+					/>
+					<i
+						class="bi fs-4 me-2"
+						:class="{ 'bi-phone': contact.phones.length != 0 }"
+					/>
+				</div>
+				<div class="col-6 text-end">
+					<small>{{ contact.name }}</small>
+				</div>
+			</div>
+		</div>
+	</div>
+</template>
+
+<script setup lang="ts">
+import TimeRelative from "@/components/TimeRelative.vue";
+import Tooltip from "@/components/Tooltip.vue";
+import { formatAddress, formatDate } from "@/format";
+import { Contact } from "@/type/api";
+interface Props {
+	contact: Contact;
+	isSelected: boolean;
+}
+const props = defineProps<Props>();
+</script>
diff --git a/ts/components/ReviewContactColumnList.vue b/ts/components/ReviewContactColumnList.vue
index 37205c7c..2d491149 100644
--- a/ts/components/ReviewContactColumnList.vue
+++ b/ts/components/ReviewContactColumnList.vue
@@ -1,3 +1,106 @@
+<style scoped>
+.user-filters {
+	display: flex;
+	gap: 1rem;
+	align-items: center;
+	flex-wrap: wrap;
+}
+
+.user-filters input[type="text"],
+.user-filters select {
+	padding: 0.5rem;
+	border: 1px solid #ddd;
+	border-radius: 4px;
+}
+
+.user-filters button {
+	padding: 0.5rem 1rem;
+	background: #dc3545;
+	color: white;
+	border: none;
+	border-radius: 4px;
+	cursor: pointer;
+}
+
+.user-footer {
+	font-weight: 500;
+	color: #666;
+}
+</style>
+
 <template>
-	<p>list</p>
+	<ListCard :items="items" :loading="loading">
+		<!-- Filters Slot -->
+		<template #filters="{ applyFilter, clearFilters, activeFilters }">
+			<div class="user-filters">
+				<input
+					v-model="searchTerm"
+					type="text"
+					placeholder="Search by name..."
+					@input="handleSearch(applyFilter)"
+				/>
+
+				<button
+					@click="handleClearFilters(clearFilters)"
+					v-if="activeFilters > 0"
+				>
+					Clear Filters ({{ activeFilters }})
+				</button>
+			</div>
+		</template>
+
+		<!-- Item Slot -->
+		<template #item="{ item }">
+			<ListCardContact
+				:contact="item"
+				@click="handleContactClick(item)"
+				:isSelected="false"
+			/>
+		</template>
+	</ListCard>
 </template>
+<script setup lang="ts">
+import { computed, ref } from "vue";
+
+import ListCard from "@/components/layout/ListCard.vue";
+import ListCardContact from "@/components/ListCardContact.vue";
+import { Contact } from "@/type/api";
+
+interface Props {
+	contacts: Contact[] | undefined;
+	loading: boolean;
+}
+
+const loading = ref(false);
+const props = defineProps<Props>();
+const searchTerm = ref("");
+const roleFilter = ref("");
+const activeOnly = ref(false);
+
+// Filter handlers
+const handleSearch = (
+	applyFilter: (fn: (contact: Contact) => boolean) => void,
+) => {
+	applyFilter((contact: Contact) =>
+		contact.name.toLowerCase().includes(searchTerm.value.toLowerCase()),
+	);
+};
+
+const handleClearFilters = (clearFilters: () => void) => {
+	searchTerm.value = "";
+	roleFilter.value = "";
+	activeOnly.value = false;
+	clearFilters();
+};
+
+const handleContactClick = (contact: any) => {
+	console.log("Clicked contact:", contact);
+};
+
+const items = computed((): Contact[] => {
+	if (props.contacts) {
+		return props.contacts;
+	}
+	return [];
+});
+</script>
diff --git a/ts/components/layout/ListCard.vue b/ts/components/layout/ListCard.vue
new file mode 100644
index 00000000..528ea2ba
--- /dev/null
+++ b/ts/components/layout/ListCard.vue
@@ -0,0 +1,98 @@
+<style scoped>
+.filters-section {
+	font-size: 0.875rem;
+}
+</style>
+<template>
+	<div class="card shadow-sm h-100 reports-list">
+		<div class="card-header bg-light pane-header">
+			<div class="filters-section">
+				<slot
+					:active-filters="activeFilters"
+					:apply-filter="applyFilter"
+					:clear-filters="clearFilters"
+					name="filters"
+				/>
+			</div>
+		</div>
+		<div class="card-body scroll-pane">
+			<div class="list-group list-group-flush">
+				<div class="loading list-group-item" v-if="loading || items == null">
+					Loading...
+				</div>
+				<div class="list-group-item" v-else-if="items.length == 0">
+					No items
+				</div>
+				<div
+					v-else-if="items.length == 0"
+					class="list-group-item text-center text-muted p-4"
+				>
+					<i class="bi bi-inbox fs-1"></i>
+					<p class="mt-2">No items match the current filters</p>
+					<button class="btn btn-sm btn-outline-primary" @click="clearFilters">
+						Reset Filters
+					</button>
+				</div>
+				<div v-else v-for="item in filteredItems" :key="item.id">
+					<slot name="item" :item="item" :index="item.id"></slot>
+				</div>
+			</div>
+		</div>
+	</div>
+</template>
+<script setup generic="T extends Record<string, any>" lang="ts">
+import { ref, computed } from "vue";
+
+interface Props {
+	items: T[];
+	loading?: boolean;
+	itemKey?: keyof T | ((item: T) => string | number);
+}
+
+const props = withDefaults(defineProps<Props>(), {
+	loading: false,
+	itemKey: "id",
+});
+
+defineSlots<{
+	filters(props: {
+		applyFilter: (filterFn: (item: T) => boolean) => void;
+		clearFilters: () => void;
+		activeFilters: number;
+	}): any;
+	item(props: { item: T; index: number }): any;
+	footer(props: { total: number }): any;
+}>();
+
+// State
+const filterFunctions = ref<Array<(item: T) => boolean>>([]);
+
+// Computed
+const filteredItems = computed(() => {
+	if (filterFunctions.value.length === 0) {
+		return props.items;
+	}
+
+	return props.items.filter((item) =>
+		filterFunctions.value.every((fn) => fn(item)),
+	);
+});
+const activeFilters = computed(() => filterFunctions.value.length);
+
+// Methods
+const applyFilter = (filterFn: (item: T) => boolean) => {
+	// Add or replace filter (you can modify this logic as needed)
+	filterFunctions.value.push(filterFn);
+};
+
+const clearFilters = () => {
+	filterFunctions.value = [];
+};
+
+const getItemKey = (item: T): string | number => {
+	if (typeof props.itemKey === "function") {
+		return props.itemKey(item);
+	}
+	return item[props.itemKey] as string | number;
+};
+</script>
diff --git a/ts/store/resource.ts b/ts/store/resource.ts
index e0715b03..a1cdcd77 100644
--- a/ts/store/resource.ts
+++ b/ts/store/resource.ts
@@ -92,6 +92,9 @@ function createResourceStore<dto, full extends uriHaver>(
 			throw err;
 		}
 	}
+	function loadingAll(): boolean {
+		return !!_resourceFetchAll.value;
+	}
 	function loadingURI(uri: string): boolean {
 		return !!_resourceFetchByURI.value.get(uri);
 	}
@@ -105,6 +108,7 @@ function createResourceStore<dto, full extends uriHaver>(
 		fetchAll,
 		fetchByID,
 		fetchByURI,
+		loadingAll,
 		loadingURI,
 	};
 }
diff --git a/ts/view/review/Contact.vue b/ts/view/review/Contact.vue
index 862b3c24..a58e7842 100644
--- a/ts/view/review/Contact.vue
+++ b/ts/view/review/Contact.vue
@@ -1,7 +1,10 @@
 <template>
 	<ThreeColumn>
 		<template #left>
-			<ReviewContactColumnList />
+			<ReviewContactColumnList
+				:contacts="contacts"
+				:loading="storeResource.contact.loadingAll()"
+			/>
 		</template>
 		<template #center>
 			<ReviewContactColumnDetail />