feat(M14): 3-pane backlog — generic SplitPane, BacklogStore, SSE realtime, card-grid TaskPanel (#22)

* feat(split-pane): refactor to generic n-pane SplitPane with cookie persistence

New API: panes[], defaultSplit[], cookieKey, tabLabels. Supports arbitrary
number of panes with n-1 draggable dividers and JSON cookie persistence.
Replaces TriplePane; mobile renders tabs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(split-pane): migrate callers to new panes[] API

Backlog page and sprint board now use generic SplitPane.
TriplePane removed; sprint board uses 3-pane with defaultSplit=[28,35,37].

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* test(split-pane): add unit tests for 2/3-pane, cookie-restore, mobile tabs

Added jsdom + @testing-library/react devDeps for component testing.
7 cases: render, divider count, cookie restore, invalid cookie fallback,
mobile tab render/switch, and no-dividers-on-mobile.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(backlog): add BacklogStore Zustand store with applyChange reducer

State: pbis, storiesByPbi, tasksByStory. setInitialData for server
hydration; applyChange(entity, op, data) handles I/U/D for SSE events.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(backlog): server-fetch tasks + hydrate BacklogStore on page load

Page now fetches tasks parallel to stories and groups by story_id.
BacklogHydrationWrapper calls setInitialData on mount so the store
is ready for downstream SSE consumers.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(backlog): add EmptyPanel shared component, replace inline empty states

EmptyPanel takes title?, message, and optional action with DemoTooltip.
Replaces duplicate inline empty-state markup in pbi-list and story-panel.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(backlog): add TaskPanel with sortable rows and TaskDialog wiring

Reads selectedStoryId + tasksByStory from stores. DnD reorder via
reorderTasksAction. Row click → ?editTask, + button → ?newTask&storyId.
DemoTooltip on drag handles and + button.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(backlog): wire TaskPanel + TaskDialog into backlog page

3-pane SplitPane [20,45,35]. searchParams for newTask/editTask.
TaskDialog and EditTaskLoader render on ?newTask and ?editTask.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* test(backlog): add TaskPanel tests for render states and click handlers

7 cases: no-story empty, no-tasks empty+action, tasks render, + button
router.push, row click router.push, demo disabled button, demo disabled handles.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(backlog): migrate PbiList to store-driven via useBacklogStore

Removes pbis prop; reads from useBacklogStore(s => s.pbis) so SSE
updates reflect in real-time without prop drilling.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(backlog): migrate StoryPanel to store-driven + selectStory on click

Removes storiesByPbi prop; reads from useBacklogStore. Card click now
dispatches selectStory(id) + shows isSelected highlight. Edit moved to
inline pencil button. page.tsx drops pbis/storiesByPbi props.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* test(backlog): add 3-pane integration tests for click-cascade flow

Covers: empty states, PBI→stories, story→tasks, cascade-reset,
isSelected highlight. localStorage mocked for sort-mode persistence.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(ST-1115): SSE backlog realtime — endpoint, hook, hydration mount, tests

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(ST-1116): mobile auto-switch tabs + back button in BacklogSplitPane

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(ST-1116): update functional-spec (3-pane backlog + mobile) and architecture (backlog SSE + backlog-store)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(ST-1117): TaskPanel card-grid — BacklogCard + rectSortingStrategy, tests updated

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix(tests): correct PbiStatusApi type and remove duplicate mock keys

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Janpeter Visser 2026-04-30 18:16:07 +02:00 committed by GitHub
parent 6cd98129f2
commit 8877ea469d
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
22 changed files with 2474 additions and 305 deletions

View file

@ -0,0 +1,227 @@
// @vitest-environment jsdom
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
import { render, screen, fireEvent } from '@testing-library/react'
import { SplitPane } from '@/components/split-pane/split-pane'
// Helper to set a cookie
function setCookie(key: string, value: string) {
Object.defineProperty(document, 'cookie', {
writable: true,
configurable: true,
value: `sp:${key}=${encodeURIComponent(value)}`,
})
}
function clearCookies() {
Object.defineProperty(document, 'cookie', {
writable: true,
configurable: true,
value: '',
})
}
describe('SplitPane', () => {
beforeEach(() => {
clearCookies()
// Default: desktop viewport
Object.defineProperty(window, 'innerWidth', { writable: true, configurable: true, value: 1440 })
window.dispatchEvent(new Event('resize'))
})
afterEach(() => {
vi.restoreAllMocks()
})
it('renders 2 panes', () => {
render(
<SplitPane
panes={[<div key="a">Pane A</div>, <div key="b">Pane B</div>]}
defaultSplit={[30, 70]}
cookieKey="test-2pane"
/>
)
expect(screen.getByText('Pane A')).toBeTruthy()
expect(screen.getByText('Pane B')).toBeTruthy()
})
it('renders 3 panes with 2 dividers', () => {
const { container } = render(
<SplitPane
panes={[
<div key="a">Left</div>,
<div key="b">Middle</div>,
<div key="c">Right</div>,
]}
defaultSplit={[28, 35, 37]}
cookieKey="test-3pane"
/>
)
expect(screen.getByText('Left')).toBeTruthy()
expect(screen.getByText('Middle')).toBeTruthy()
expect(screen.getByText('Right')).toBeTruthy()
// 2 dividers: cursor-col-resize elements
const dividers = container.querySelectorAll('.cursor-col-resize')
expect(dividers).toHaveLength(2)
})
it('restores splits from cookie on mount', () => {
const stored = JSON.stringify([40, 60])
setCookie('test-restore', stored)
const { container } = render(
<SplitPane
panes={[<div key="a">A</div>, <div key="b">B</div>]}
defaultSplit={[20, 80]}
cookieKey="test-restore"
/>
)
// Left pane should have width 40%, not the default 20%
const paneDiv = container.querySelector<HTMLElement>('[style*="40%"]')
expect(paneDiv).toBeTruthy()
})
it('falls back to defaultSplit when cookie is invalid', () => {
setCookie('test-invalid', 'not-valid-json')
const { container } = render(
<SplitPane
panes={[<div key="a">A</div>, <div key="b">B</div>]}
defaultSplit={[25, 75]}
cookieKey="test-invalid"
/>
)
const paneDiv = container.querySelector<HTMLElement>('[style*="25%"]')
expect(paneDiv).toBeTruthy()
})
it('renders tabs on mobile viewport', () => {
Object.defineProperty(window, 'innerWidth', { writable: true, configurable: true, value: 768 })
window.dispatchEvent(new Event('resize'))
render(
<SplitPane
panes={[<div key="a">Content A</div>, <div key="b">Content B</div>]}
defaultSplit={[50, 50]}
cookieKey="test-mobile"
tabLabels={['Tab A', 'Tab B']}
/>
)
expect(screen.getByText('Tab A')).toBeTruthy()
expect(screen.getByText('Tab B')).toBeTruthy()
// Only first tab content visible by default
expect(screen.getByText('Content A')).toBeTruthy()
expect(screen.queryByText('Content B')).toBeNull()
})
it('switches tab content on mobile', () => {
Object.defineProperty(window, 'innerWidth', { writable: true, configurable: true, value: 600 })
window.dispatchEvent(new Event('resize'))
render(
<SplitPane
panes={[<div key="a">Content A</div>, <div key="b">Content B</div>]}
defaultSplit={[50, 50]}
cookieKey="test-mobile-switch"
tabLabels={['Tab A', 'Tab B']}
/>
)
// Click second tab
fireEvent.click(screen.getByText('Tab B'))
expect(screen.queryByText('Content A')).toBeNull()
expect(screen.getByText('Content B')).toBeTruthy()
})
it('back button not visible on tab 0 in mobile', () => {
Object.defineProperty(window, 'innerWidth', { writable: true, configurable: true, value: 600 })
window.dispatchEvent(new Event('resize'))
render(
<SplitPane
panes={[<div key="a">A</div>, <div key="b">B</div>, <div key="c">C</div>]}
defaultSplit={[33, 33, 34]}
cookieKey="test-back-hidden"
tabLabels={['T1', 'T2', 'T3']}
/>
)
// On tab 0, no back button
expect(screen.queryByLabelText('Terug')).toBeNull()
})
it('back button visible on tab > 0 and navigates back', () => {
Object.defineProperty(window, 'innerWidth', { writable: true, configurable: true, value: 600 })
window.dispatchEvent(new Event('resize'))
render(
<SplitPane
panes={[<div key="a">A</div>, <div key="b">B</div>, <div key="c">C</div>]}
defaultSplit={[33, 33, 34]}
cookieKey="test-back-nav"
tabLabels={['T1', 'T2', 'T3']}
/>
)
// Switch to tab 2
fireEvent.click(screen.getByText('T3'))
expect(screen.getByText('C')).toBeTruthy()
expect(screen.getByLabelText('Terug')).toBeTruthy()
// Click back → tab 1
fireEvent.click(screen.getByLabelText('Terug'))
expect(screen.getByText('B')).toBeTruthy()
// Click back again → tab 0, no back button
fireEvent.click(screen.getByLabelText('Terug'))
expect(screen.getByText('A')).toBeTruthy()
expect(screen.queryByLabelText('Terug')).toBeNull()
})
it('controlled activeTab prop switches the active pane', () => {
Object.defineProperty(window, 'innerWidth', { writable: true, configurable: true, value: 600 })
window.dispatchEvent(new Event('resize'))
const { rerender } = render(
<SplitPane
panes={[<div key="a">A</div>, <div key="b">B</div>, <div key="c">C</div>]}
defaultSplit={[33, 33, 34]}
cookieKey="test-controlled"
tabLabels={['T1', 'T2', 'T3']}
activeTab={0}
onActiveTabChange={vi.fn()}
/>
)
expect(screen.getByText('A')).toBeTruthy()
rerender(
<SplitPane
panes={[<div key="a">A</div>, <div key="b">B</div>, <div key="c">C</div>]}
defaultSplit={[33, 33, 34]}
cookieKey="test-controlled"
tabLabels={['T1', 'T2', 'T3']}
activeTab={2}
onActiveTabChange={vi.fn()}
/>
)
expect(screen.getByText('C')).toBeTruthy()
})
it('does not render dividers on mobile', () => {
Object.defineProperty(window, 'innerWidth', { writable: true, configurable: true, value: 600 })
window.dispatchEvent(new Event('resize'))
const { container } = render(
<SplitPane
panes={[<div key="a">A</div>, <div key="b">B</div>]}
defaultSplit={[50, 50]}
cookieKey="test-no-dividers"
/>
)
const dividers = container.querySelectorAll('.cursor-col-resize')
expect(dividers).toHaveLength(0)
})
})