Add stage 5: list detail page with items UI and drag reorder

API: new PUT /api/lists/{id}/items/order takes the full ordered id set and
rewrites positions 0..n-1 in a transaction (422 unless the set matches the
list exactly). TodoItemRepository gains idsForList() and reorder().

Frontend: lists on the home page are now links to /lists/:id (ListView).
ListView shows the list title, a "M of N done" summary, and each item as a
drag handle + checkbox + inline-editable text (saved on blur) + delete
button, with a create-item form at the bottom. Drag-and-drop uses
vuedraggable; on drop the whole order is persisted via the new endpoint and
the response replaces local state, with a resync-on-error fallback. New
items store; items store is also reset on logout.

Tests: reorder happy path, incomplete-set rejection, owner scoping. Backend
suite: 23 passing.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
2026-09-03 18:59:51 +01:00
co-authored by Claude Sonnet 5
parent dd2ab5b7d3
commit b506b83b1e
16 changed files with 568 additions and 15 deletions
+7 -1
View File
@@ -11,7 +11,7 @@ SQLite file, plus a Vue 3 + TypeScript PWA frontend in [web/](web/).
| 2 | Frontend shell — Vite PWA, auth-gated routing, register/login pages | ✅ done |
| 3 | Todo list + item CRUD API | ✅ done |
| 4 | Frontend lists view — list index + create form | ✅ done |
| 5 | Frontend list detail — items UI | planned |
| 5 | Frontend list detail — items UI with drag-and-drop reorder | ✅ done |
Registration signs the user in immediately, with the account's email marked
unverified (`user.email_verified` is `false` until a future stage adds a
@@ -221,6 +221,7 @@ Scoped to a list; the parent list's ownership is checked first (`404` otherwise)
|--------|------|---------|
| `GET` | `/api/lists/{id}/items` | items, ordered by `position` then `id` |
| `POST` | `/api/lists/{id}/items` | add an item |
| `PUT` | `/api/lists/{id}/items/order` | reorder all items in one shot |
| `GET` | `/api/lists/{id}/items/{itemId}` | one item |
| `PATCH` | `/api/lists/{id}/items/{itemId}` | update `text`, `complete`, and/or `position` |
| `DELETE` | `/api/lists/{id}/items/{itemId}` | delete the item (`204`) |
@@ -231,6 +232,11 @@ appended after the current highest position). `PATCH` needs at least one field.
`position` is a plain sort key the client manages — updating one item never
renumbers its siblings.
`PUT …/items/order` takes `{ "item_ids": [3, 1, 2] }` — every item in the list,
each exactly once (`422` otherwise). It rewrites positions to `0..n-1` in one
transaction and returns `{ "items": [ … ] }` in the new order. This is what the
drag-and-drop reorder in the UI calls.
Item representation:
```json
@@ -108,6 +108,37 @@ final class TodoItemController extends Controller
return $response->withStatus(204);
}
/**
* PUT /api/lists/{listId}/items/order
*
* Body: { "item_ids": [3, 1, 2] } — every item in the list, exactly once,
* in the desired order. Positions are rewritten to 0..n-1.
*/
public function reorder(Request $request, Response $response, array $args): Response
{
$listId = $this->requireOwnedListId($request, $args);
$order = $this->body($request)['item_ids'] ?? null;
if (!is_array($order) || array_filter($order, static fn ($id) => !is_int($id)) !== []) {
throw new ApiException('item_ids must be an array of item IDs.', 422);
}
/** @var int[] $order */
$expected = $this->items->idsForList($listId);
$given = $order;
sort($given);
sort($expected);
if ($given !== $expected) {
throw new ApiException('item_ids must contain every item in the list exactly once.', 422);
}
$items = $this->items->reorder($listId, $order);
$this->lists->touch($listId);
return $this->json($response, ['items' => array_map($this->present(...), $items)]);
}
/**
* @param array<string, string> $args
*/
+43
View File
@@ -106,6 +106,49 @@ final class TodoItemRepository
$this->pdo->prepare('DELETE FROM todo_items WHERE id = :id')->execute(['id' => $id]);
}
/**
* IDs of every item in the list, in current position order.
*
* @return int[]
*/
public function idsForList(int $listId): array
{
$stmt = $this->pdo->prepare(
'SELECT id FROM todo_items WHERE list_id = :list ORDER BY position ASC, id ASC'
);
$stmt->execute(['list' => $listId]);
return array_map(intval(...), $stmt->fetchAll(PDO::FETCH_COLUMN));
}
/**
* Assign positions 0..n-1 to the given items in one transaction.
*
* @param int[] $orderedIds every item id in the list, exactly once
* @return TodoItemRow[] the list's items in their new order
*/
public function reorder(int $listId, array $orderedIds): array
{
$stmt = $this->pdo->prepare(
'UPDATE todo_items SET position = :position,
updated_at = ' . "strftime('%Y-%m-%dT%H:%M:%SZ', 'now')" . '
WHERE id = :id AND list_id = :list'
);
$this->pdo->beginTransaction();
try {
foreach (array_values($orderedIds) as $position => $id) {
$stmt->execute(['position' => $position, 'id' => $id, 'list' => $listId]);
}
$this->pdo->commit();
} catch (\Throwable $e) {
$this->pdo->rollBack();
throw $e;
}
return $this->allForList($listId);
}
private function nextPosition(int $listId): int
{
$stmt = $this->pdo->prepare(
+1
View File
@@ -70,6 +70,7 @@ $app->group('/api', function (RouteCollectorProxy $group) use (
$lists->get('/{listId:[0-9]+}/items', [$itemController, 'index']);
$lists->post('/{listId:[0-9]+}/items', [$itemController, 'store']);
$lists->put('/{listId:[0-9]+}/items/order', [$itemController, 'reorder']);
$lists->get('/{listId:[0-9]+}/items/{itemId:[0-9]+}', [$itemController, 'show']);
$lists->patch('/{listId:[0-9]+}/items/{itemId:[0-9]+}', [$itemController, 'update']);
$lists->delete('/{listId:[0-9]+}/items/{itemId:[0-9]+}', [$itemController, 'destroy']);
+62
View File
@@ -143,6 +143,68 @@ final class TodoTest extends ApiTestCase
self::assertArrayHasKey('text', $this->decode($bad)['error']['details']);
}
public function test_items_can_be_reordered_in_bulk(): void
{
$auth = $this->authHeader();
$listId = $this->decode(
$this->request('POST', '/api/lists', ['title' => 'Reorder'], $auth),
)['list']['id'];
$ids = [];
foreach (['A', 'B', 'C'] as $text) {
$ids[$text] = $this->decode(
$this->request('POST', "/api/lists/{$listId}/items", ['text' => $text], $auth),
)['item']['id'];
}
$response = $this->request('PUT', "/api/lists/{$listId}/items/order", [
'item_ids' => [$ids['C'], $ids['A'], $ids['B']],
], $auth);
self::assertSame(200, $response->getStatusCode());
$items = $this->decode($response)['items'];
self::assertSame(['C', 'A', 'B'], array_column($items, 'text'));
self::assertSame([0, 1, 2], array_column($items, 'position'));
// Order persists on a fresh read.
$reread = $this->decode($this->request('GET', "/api/lists/{$listId}/items", null, $auth))['items'];
self::assertSame(['C', 'A', 'B'], array_column($reread, 'text'));
}
public function test_reorder_rejects_an_incomplete_id_set(): void
{
$auth = $this->authHeader();
$listId = $this->decode(
$this->request('POST', '/api/lists', ['title' => 'Reorder'], $auth),
)['list']['id'];
$first = $this->decode(
$this->request('POST', "/api/lists/{$listId}/items", ['text' => 'one'], $auth),
)['item']['id'];
$this->request('POST', "/api/lists/{$listId}/items", ['text' => 'two'], $auth);
$response = $this->request('PUT', "/api/lists/{$listId}/items/order", [
'item_ids' => [$first],
], $auth);
self::assertSame(422, $response->getStatusCode());
}
public function test_reorder_is_scoped_to_the_owner(): void
{
$owner = $this->authHeader('ro@example.com');
$other = $this->authHeader('rx@example.com');
$listId = $this->decode(
$this->request('POST', '/api/lists', ['title' => 'Mine'], $owner),
)['list']['id'];
$itemId = $this->decode(
$this->request('POST', "/api/lists/{$listId}/items", ['text' => 'x'], $owner),
)['item']['id'];
self::assertSame(404, $this->request('PUT', "/api/lists/{$listId}/items/order", [
'item_ids' => [$itemId],
], $other)->getStatusCode());
}
public function test_deleting_a_list_cascades_to_its_items(): void
{
$auth = $this->authHeader();
+15 -6
View File
@@ -35,14 +35,23 @@ npm run preview
## Layout
```
src/main.ts App bootstrap; resolves the stored session before mount
src/router/index.ts Routes + guard (redirects to /login when unauthenticated)
src/stores/auth.ts Pinia store: token in localStorage, register/login/fetchMe
src/stores/lists.ts Pinia store: the user's lists (fetch + create)
src/lib/api.ts fetch wrapper, bearer token, typed ApiError
src/views/ HomeView (lists + create form), LoginView, RegisterView
src/main.ts App bootstrap; resolves the stored session before mount
src/router/index.ts Routes + guard (redirects to /login when unauthenticated)
src/stores/auth.ts Pinia store: token in localStorage, register/login/fetchMe
src/stores/lists.ts Pinia store: the user's lists (fetch + create)
src/stores/items.ts Pinia store: one list's items (CRUD + drag reorder)
src/lib/api.ts fetch wrapper, bearer token, typed ApiError
src/components/TodoItemRow.vue checkbox + editable text + delete, one item
src/views/ HomeView (lists), ListView (items), LoginView, RegisterView
```
## List detail
`/lists/:id` shows one list's items. Each row is a checkbox, an inline-editable
text field (saved on blur), a delete button, and a drag handle. Reordering uses
`vuedraggable`; on drop the whole new order is persisted via
`PUT /api/lists/:id/items/order`, and the server response replaces local state.
## Auth flow
- The token from `POST /api/auth/register` or `/login` is kept in `localStorage`
+20 -1
View File
@@ -10,7 +10,8 @@
"dependencies": {
"pinia": "^4.0.3",
"vue": "^3.5.41",
"vue-router": "^4.6.4"
"vue-router": "^4.6.4",
"vuedraggable": "^4.1.0"
},
"devDependencies": {
"@types/node": "^24.13.3",
@@ -6134,6 +6135,24 @@
"typescript": ">=5.0.0"
}
},
"node_modules/vuedraggable": {
"version": "4.1.0",
"resolved": "https://registry.npmjs.org/vuedraggable/-/vuedraggable-4.1.0.tgz",
"integrity": "sha512-FU5HCWBmsf20GpP3eudURW3WdWTKIbEIQxh9/8GE806hydR9qZqRRxRE3RjqX7PkuLuMQG/A7n3cfj9rCEchww==",
"license": "MIT",
"dependencies": {
"sortablejs": "1.14.0"
},
"peerDependencies": {
"vue": "^3.0.1"
}
},
"node_modules/vuedraggable/node_modules/sortablejs": {
"version": "1.14.0",
"resolved": "https://registry.npmjs.org/sortablejs/-/sortablejs-1.14.0.tgz",
"integrity": "sha512-pBXvQCs5/33fdN1/39pPL0NZF20LeRbLQ5jtnheIPN9JQAaufGjKdWduZn4U7wCtVuzKhmRkI0DFYHYRbB2H1w==",
"license": "MIT"
},
"node_modules/which": {
"version": "2.0.2",
"resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+2 -1
View File
@@ -11,7 +11,8 @@
"dependencies": {
"pinia": "^4.0.3",
"vue": "^3.5.41",
"vue-router": "^4.6.4"
"vue-router": "^4.6.4",
"vuedraggable": "^4.1.0"
},
"devDependencies": {
"@types/node": "^24.13.3",
+3
View File
@@ -1,15 +1,18 @@
<script setup lang="ts">
import { RouterView, useRouter } from 'vue-router'
import { useAuthStore } from './stores/auth'
import { useItemsStore } from './stores/items'
import { useListsStore } from './stores/lists'
const auth = useAuthStore()
const lists = useListsStore()
const items = useItemsStore()
const router = useRouter()
async function onLogout() {
auth.logout()
lists.reset()
items.reset()
await router.push({ name: 'login' })
}
</script>
+56
View File
@@ -0,0 +1,56 @@
<script setup lang="ts">
import { ref, watch } from 'vue'
import type { TodoItem } from '../types'
const props = defineProps<{ item: TodoItem }>()
const emit = defineEmits<{
toggle: [complete: boolean]
'save-text': [text: string]
delete: []
}>()
const text = ref(props.item.text)
watch(
() => props.item.text,
(value) => {
text.value = value
},
)
function commit() {
const next = text.value.trim()
if (next === '') {
text.value = props.item.text // the API requires a non-empty text
return
}
if (next !== props.item.text) emit('save-text', next)
}
</script>
<template>
<li class="item" :class="{ 'item--done': item.complete }">
<span class="item__handle" aria-hidden="true" title="Drag to reorder"></span>
<input
class="item__check"
type="checkbox"
:checked="item.complete"
:aria-label="item.complete ? 'Mark as not done' : 'Mark as done'"
@change="emit('toggle', ($event.target as HTMLInputElement).checked)"
/>
<input
v-model="text"
class="item__text"
type="text"
maxlength="1000"
aria-label="Item text"
@blur="commit"
@keyup.enter="($event.target as HTMLInputElement).blur()"
/>
<button type="button" class="item__delete" aria-label="Delete item" @click="emit('delete')">
</button>
</li>
</template>
+6
View File
@@ -10,6 +10,12 @@ const router = createRouter({
component: () => import('../views/HomeView.vue'),
meta: { requiresAuth: true },
},
{
path: '/lists/:id(\\d+)',
name: 'list',
component: () => import('../views/ListView.vue'),
meta: { requiresAuth: true },
},
{
path: '/login',
name: 'login',
+88
View File
@@ -0,0 +1,88 @@
import { defineStore } from 'pinia'
import { ref } from 'vue'
import { apiRequest } from '../lib/api'
import type { TodoItem } from '../types'
type ItemPatch = Partial<Pick<TodoItem, 'text' | 'complete' | 'position'>>
export const useItemsStore = defineStore('items', () => {
// Held in list order (by position); mutated in place by drag-and-drop.
const items = ref<TodoItem[]>([])
const listId = ref<number | null>(null)
const loading = ref(false)
const loaded = ref(false)
const completedCount = () => items.value.filter((i) => i.complete).length
async function load(id: number): Promise<void> {
listId.value = id
loaded.value = false
loading.value = true
try {
const { items: fetched } = await apiRequest<{ items: TodoItem[] }>(`/lists/${id}/items`, {
auth: true,
})
items.value = fetched
loaded.value = true
} finally {
loading.value = false
}
}
async function add(text: string): Promise<void> {
const { item } = await apiRequest<{ item: TodoItem }>(`/lists/${listId.value}/items`, {
method: 'POST',
auth: true,
body: { text },
})
// The API appends the item, so the end of the array is its correct place.
items.value.push(item)
}
async function patch(item: TodoItem, fields: ItemPatch): Promise<void> {
const { item: updated } = await apiRequest<{ item: TodoItem }>(
`/lists/${listId.value}/items/${item.id}`,
{ method: 'PATCH', auth: true, body: fields },
)
const i = items.value.findIndex((x) => x.id === updated.id)
if (i !== -1) items.value[i] = updated
}
const setComplete = (item: TodoItem, complete: boolean) => patch(item, { complete })
const setText = (item: TodoItem, text: string) => patch(item, { text })
async function remove(item: TodoItem): Promise<void> {
await apiRequest(`/lists/${listId.value}/items/${item.id}`, { method: 'DELETE', auth: true })
items.value = items.value.filter((i) => i.id !== item.id)
}
/** Persist the current array order (call after a drag ends). */
async function persistOrder(): Promise<void> {
const { items: fresh } = await apiRequest<{ items: TodoItem[] }>(
`/lists/${listId.value}/items/order`,
{ method: 'PUT', auth: true, body: { item_ids: items.value.map((i) => i.id) } },
)
items.value = fresh
}
function reset(): void {
items.value = []
listId.value = null
loaded.value = false
}
return {
items,
listId,
loading,
loaded,
completedCount,
load,
add,
setComplete,
setText,
remove,
persistOrder,
reset,
}
})
+92 -1
View File
@@ -123,7 +123,18 @@ h1 {
.lists__item {
border: 1px solid var(--border);
border-radius: 8px;
}
.lists__link {
display: block;
padding: 0.75rem 0.9rem;
color: inherit;
text-decoration: none;
border-radius: 8px;
}
.lists__link:hover {
background: var(--bg);
}
.lists__head {
@@ -138,10 +149,90 @@ h1 {
word-break: break-word;
}
.lists__item .muted {
.lists__link .muted {
margin: 0.35rem 0 0;
}
/* --- list detail: items ------------------------------------------------- */
.items {
list-style: none;
margin: 1rem 0 0;
padding: 0;
display: grid;
gap: 0.4rem;
}
.item {
display: flex;
align-items: center;
gap: 0.5rem;
border: 1px solid var(--border);
border-radius: 8px;
padding: 0.4rem 0.55rem;
background: var(--surface);
}
.item--ghost {
opacity: 0.5;
}
.item__handle {
cursor: grab;
color: var(--muted);
user-select: none;
padding: 0 0.15rem;
line-height: 1;
}
.item__check {
flex: none;
width: 1.1rem;
height: 1.1rem;
}
.item__text {
flex: 1;
min-width: 0;
border: 1px solid transparent;
border-radius: 6px;
background: transparent;
color: var(--text);
font-size: 1rem;
padding: 0.3rem 0.4rem;
}
.item__text:hover {
border-color: var(--border);
}
.item__text:focus {
outline: none;
border-color: var(--accent);
background: var(--bg);
}
.item--done .item__text {
text-decoration: line-through;
color: var(--muted);
}
.item__delete {
flex: none;
border: none;
background: none;
color: var(--muted);
cursor: pointer;
font-size: 1rem;
padding: 0.2rem 0.4rem;
border-radius: 6px;
}
.item__delete:hover {
color: var(--error);
background: var(--bg);
}
.form {
display: grid;
gap: 1rem;
+10
View File
@@ -23,6 +23,16 @@ export interface TodoList {
updated_at: string
}
export interface TodoItem {
id: number
list_id: number
text: string
complete: boolean
position: number
created_at: string
updated_at: string
}
/** Shape of every error body returned by the API. */
export interface ApiErrorBody {
error: {
+7 -5
View File
@@ -65,11 +65,13 @@ async function onCreate() {
<ul v-else class="lists">
<li v-for="list in lists.lists" :key="list.id" class="lists__item">
<div class="lists__head">
<span class="lists__title">{{ list.title }}</span>
<span class="badge">{{ list.completed_count }} / {{ list.item_count }} done</span>
</div>
<p v-if="list.description" class="muted">{{ list.description }}</p>
<RouterLink :to="{ name: 'list', params: { id: list.id } }" class="lists__link">
<div class="lists__head">
<span class="lists__title">{{ list.title }}</span>
<span class="badge">{{ list.completed_count }} / {{ list.item_count }} done</span>
</div>
<p v-if="list.description" class="muted">{{ list.description }}</p>
</RouterLink>
</li>
</ul>
+125
View File
@@ -0,0 +1,125 @@
<script setup lang="ts">
import { computed, onMounted, ref } from 'vue'
import { useRoute } from 'vue-router'
import draggable from 'vuedraggable'
import TodoItemRow from '../components/TodoItemRow.vue'
import { ApiError, apiRequest } from '../lib/api'
import { useItemsStore } from '../stores/items'
import type { TodoItem, TodoList } from '../types'
const route = useRoute()
const items = useItemsStore()
const listId = Number(route.params.id)
const list = ref<TodoList | null>(null)
const loadError = ref<string | null>(null)
const actionError = ref<string | null>(null)
const newText = ref('')
const submitting = ref(false)
const summary = computed(() => {
const total = items.items.length
if (total === 0) return 'No items yet.'
return `${items.completedCount()} of ${total} done.`
})
onMounted(load)
async function load() {
loadError.value = null
try {
const [{ list: fetched }] = await Promise.all([
apiRequest<{ list: TodoList }>(`/lists/${listId}`, { auth: true }),
items.load(listId),
])
list.value = fetched
} catch (e) {
if (e instanceof ApiError && e.status === 404) {
loadError.value = 'That list does not exist.'
} else {
loadError.value = e instanceof ApiError ? e.message : 'Could not load the list.'
}
}
}
/** Run a store mutation, surfacing failures and resyncing from the server. */
async function run(op: Promise<unknown>) {
actionError.value = null
try {
await op
} catch (e) {
actionError.value = e instanceof ApiError ? e.message : 'Something went wrong.'
await items.load(listId)
}
}
function onReorder(event: { oldIndex?: number; newIndex?: number }) {
if (event.oldIndex === event.newIndex) return
void run(items.persistOrder())
}
async function onCreate() {
submitting.value = true
actionError.value = null
try {
await items.add(newText.value)
newText.value = ''
} catch (e) {
actionError.value = e instanceof ApiError ? e.message : 'Could not add the item.'
} finally {
submitting.value = false
}
}
</script>
<template>
<section class="card">
<p><RouterLink to="/">&larr; All lists</RouterLink></p>
<p v-if="loadError" class="form-error">{{ loadError }}</p>
<template v-else-if="list">
<h1>{{ list.title }}</h1>
<p v-if="list.description" class="muted">{{ list.description }}</p>
<p class="muted">{{ summary }}</p>
<p v-if="actionError" class="form-error">{{ actionError }}</p>
<p v-if="items.loading && !items.loaded" class="muted">Loading</p>
<draggable
v-else-if="items.items.length"
:list="items.items"
item-key="id"
tag="ul"
class="items"
handle=".item__handle"
ghost-class="item--ghost"
:animation="150"
@end="onReorder"
>
<template #item="{ element }: { element: TodoItem }">
<TodoItemRow
:item="element"
@toggle="(v) => run(items.setComplete(element, v))"
@save-text="(v) => run(items.setText(element, v))"
@delete="run(items.remove(element))"
/>
</template>
</draggable>
<p v-else class="muted">No items yet &mdash; add one below.</p>
<form class="form form--new-list" @submit.prevent="onCreate">
<label>
<span>New item</span>
<input v-model="newText" type="text" maxlength="1000" required />
</label>
<button type="submit" :disabled="submitting">
{{ submitting ? 'Adding…' : 'Add item' }}
</button>
</form>
</template>
</section>
</template>