issue-map 0.3.1 → 0.4.0

package/scripts/issue-map-page.ts

@@ -2,9 +2,10 @@
  * 開發地圖的畫面。`issue-map.ts` 用 `Bun.build` 把這支打包成一段 script 塞進樣板，所以它
  * **只能碰瀏覽器的東西**，不能 import Bun 的 API。
  *
- * 形狀與純推導在 `issue-map-model.ts`：狀態的五個值、票的形狀、分群、關鍵路徑、線路圖的排版
- * 都在那邊，兩側共用同一份定義。文案全部在 `issue-map-i18n.ts`，這一支不寫死任何一句給人看的
- * 話。剩下的是 DOM、事件、收合與語言狀態。
+ * 標記全部在 `issue-map-view.ts`，而且建置時就已經用同一批函式畫過一次寫進檔案了——這一支只在
+ * 換語言、換篩選、選取、收合時重畫。所以沒有 JS 的環境看到的是同一份頁面，只是不能互動。
+ *
+ * 這裡剩下的是 DOM 與事件：讀寫 localStorage 的兩個偏好（語言、收合）、事件代理、選取狀態。
  */
 
 import {
@@ -17,23 +18,8 @@ import {
   setLocale,
   t,
 } from './issue-map-i18n.ts'
-import {
-  layoutOf,
-  MAP,
-  type Edge,
-  type Group,
-  type Layout,
-  type MapIssue,
-  type NextStep,
-  type Point,
-  type Snapshot,
-  STATUS_ORDER,
-  type Status,
-} from './issue-map-model.ts'
-
-// ---- 資料 ----
-
-const SVG_NS = 'http://www.w3.org/2000/svg'
+import { type Snapshot } from './issue-map-model.ts'
+import { esc, type Filter, viewOf } from './issue-map-view.ts'
 
 /** 樣板保證這些節點存在。找不到就是樣板被改壞了，早點喊比畫出半張圖好。 */
 function pick(id: string): HTMLElement {
@@ -42,56 +28,17 @@ function pick(id: string): HTMLElement {
   return node
 }
 
-const raw = JSON.parse(pick('issue-map-data').textContent || '{}') as Partial<Snapshot>
-const issues: readonly MapIssue[] = raw.issues ?? []
-const byNumber = new Map(issues.map((issue) => [issue.number, issue]))
-const work = issues.filter((issue) => !issue.isParent)
-const criticalPath = raw.criticalPath ?? 0
-const repo = raw.repo ?? ''
-
-const counts = Object.fromEntries(
-  STATUS_ORDER.map((status) => [status, work.filter((i) => i.status === status).length]),
-) as Record<Status, number>
-const openCount = work.length - counts.done
-
-/** 誰擋著誰的反向索引。亮鏈與「關掉後解鎖」都用它。 */
-const unlocks = new Map<number, number[]>()
-for (const issue of issues) {
-  for (const blocker of issue.blockedBy) {
-    const dependents = unlocks.get(blocker) ?? []
-    dependents.push(issue.number)
-    unlocks.set(blocker, dependents)
-  }
-}
-
-function byStatusThenNumber(a: MapIssue, b: MapIssue): number {
-  return STATUS_ORDER.indexOf(a.status) - STATUS_ORDER.indexOf(b.status) || a.number - b.number
-}
-
-const ESCAPES: Readonly<Record<string, string>> = {
-  '&': '&amp;',
-  '<': '&lt;',
-  '>': '&gt;',
-  '"': '&quot;',
-}
-
-function esc(text: string): string {
-  return text.replace(/[&<>"]/g, (c) => ESCAPES[c] ?? c)
-}
+const snapshot = JSON.parse(pick('issue-map-data').textContent || '{}') as Partial<Snapshot>
+const view = viewOf(snapshot)
+const repo = snapshot.repo ?? ''
 
-/**
- * 站名就是標題開頭。刻意不另設一個「短名」欄位——那要每張票靠人維護，而且會變成票名的第二個
- * 來源，改了標題不會跟著改。截到讀不通的時候，滑鼠停留與下面的清單都有完整標題。
- */
-const HEAD_CHARS = 7
-
-function head(title: string): string {
-  return title.length > HEAD_CHARS ? `${title.slice(0, HEAD_CHARS)}…` : title
-}
+const detail = pick('detail')
+const rowsEl = pick('rows')
+const groupsEl = pick('groups')
+const tabsEl = pick('tabs')
 
-function issueAt(number: number): MapIssue | undefined {
-  return byNumber.get(number)
-}
+let selected: number | null = null
+let filter: Filter = 'all'
 
 // ---- 語言 ----
 
@@ -113,29 +60,13 @@ function readLocale(): Locale {
   return DEFAULT_LOCALE
 }
 
-function statusLabel(status: Status): string {
-  return t(`status.${status}`)
-}
-
-/** 日期一律照當下語言排。快照裡存的是 ISO 字串，格式化是畫面的事。 */
-function dateTime(iso: string): string {
-  return new Date(iso).toLocaleString(locale(), { hour12: false })
-}
-
-function dateOnly(iso: string): string {
-  return new Date(iso).toLocaleDateString(locale())
-}
-
 /** 語言選單只做一次；換語言是整頁重畫，選單自己不重建，不然焦點會掉。 */
 function mountLangPicker(): void {
   const picker = pick('lang')
   if (!(picker instanceof HTMLSelectElement)) throw new Error('#lang 不是 select')
-  for (const option of LOCALES) {
-    const node = document.createElement('option')
-    node.value = option
-    node.textContent = LOCALE_NAME[option]
-    picker.appendChild(node)
-  }
+  picker.innerHTML = LOCALES.map(
+    (option) => `<option value="${option}">${esc(LOCALE_NAME[option])}</option>`,
+  ).join('')
   picker.value = locale()
   picker.addEventListener('change', () => {
     if (!isLocale(picker.value)) return
@@ -157,9 +88,6 @@ function mountLangPicker(): void {
  */
 const COLLAPSE_KEY = `issue-map:collapsed:${repo}`
 
-/** 每顆收合鈕重畫自己的樣子。整頁重畫時要清掉，不然會留著指向已被移除的鈕的函式。 */
-const onFold: (() => void)[] = []
-
 function readFolded(): Set<string> {
   try {
     return new Set(JSON.parse(localStorage.getItem(COLLAPSE_KEY) || '[]') as string[])
@@ -182,31 +110,13 @@ function setFolded(parent: number, shut: boolean): void {
   } catch {
     // 存不了就只在這一次有效，畫面照樣能開合。
   }
-  for (const repaint of onFold) repaint()
   paintFolded()
 }
 
-/** 做一顆收合鈕。`parent` 是主票號碼，同一個號碼的鈕與清單列連動。 */
-function foldButton(parent: number): HTMLButtonElement {
-  const button = document.createElement('button')
-  button.type = 'button'
-  button.className = 'fold'
-  const paint = () => {
-    const open = !isFolded(parent)
-    button.setAttribute('aria-expanded', String(open))
-    button.setAttribute(
-      'aria-label',
-      open ? t('fold.collapse', { n: parent }) : t('fold.expand', { n: parent }),
-    )
-    button.textContent = open ? '−' : '+'
-  }
-  paint()
-  onFold.push(paint)
-  button.addEventListener('click', () => setFolded(parent, !isFolded(parent)))
-  return button
-}
-
-/** 收合只在這裡畫一次：列、就地展開的細節、地圖本體，凡是掛了 data-parent 的都聽它。 */
+/**
+ * 收合只在這裡畫一次：列、就地展開的細節、地圖本體，凡是掛了 data-parent 的都聽它。收合鈕的
+ * 樣子也在這裡補上——建置時畫出來的鈕是空的，因為那時還不知道這個瀏覽器記了什麼。
+ */
 function paintFolded(): void {
   for (const node of document.querySelectorAll<HTMLElement>('[data-parent]')) {
     node.hidden = isFolded(Number(node.dataset.parent))
@@ -214,490 +124,20 @@ function paintFolded(): void {
   for (const section of document.querySelectorAll<HTMLElement>('section.group[data-fold]')) {
     section.dataset.folded = String(isFolded(Number(section.dataset.fold)))
   }
-}
-
-// ---- 抬頭 ----
-
-function renderHeader(): void {
-  const stats = pick('stats')
-  stats.innerHTML = ''
-  const tiles: { label: string; value: number; unit?: string; tone?: string }[] = [
-    { label: t('stat.ready'), value: counts.ready, tone: 'ready' },
-    { label: t('stat.active'), value: counts.active, tone: 'active' },
-    { label: t('stat.blocked'), value: counts.blocked, unit: `/ ${openCount}`, tone: 'blocked' },
-    { label: t('stat.triage'), value: counts.triage, tone: 'triage' },
-    {
-      label: t('stat.critical'),
-      value: criticalPath,
-      unit: t('stat.critical.unit', { n: criticalPath }),
-    },
-  ]
-  for (const tile of tiles) {
-    const box = document.createElement('div')
-    box.className = 'stat'
-    if (tile.tone) box.dataset.tone = tile.tone
-    const unit = tile.unit ? `<small>${esc(tile.unit)}</small>` : ''
-    box.innerHTML = `<b>${tile.value}${unit}</b><span>${esc(tile.label)}</span>`
-    stats.appendChild(box)
-  }
-
-  // 抬頭全部照資料寫，換 repo 或換標籤字彙才不會留著上一個專案的字。
-  const name = repo.split('/').pop()
-  const heading = name ? t('title.withRepo', { repo: name }) : t('title.plain')
-  pick('page-title').textContent = heading
-  document.title = heading
-  document.documentElement.lang = locale()
-  pick('lang').setAttribute('aria-label', t('lang.label'))
-  const when = raw.generatedAt ? ` · ${dateTime(raw.generatedAt)}` : ''
-  pick('eyebrow').textContent = repo + when
-
-  pick('lede').innerHTML = lede()
-  renderFooter()
-}
-
-function renderFooter(): void {
-  pick('foot-truth').textContent = t('foot.truth')
-  const code = (command: string) => `<code>${esc(command)}</code>`
-  pick('foot-refresh').innerHTML = t('foot.refresh', {
-    build: code('bun run issue-map'),
-    serve: code('bun run issue-map:serve'),
-  })
-
-  const vocab = raw.labels ?? { ready: [], unready: [] }
-  // textContent：標籤名是 repo 給的字，不經過 innerHTML 就不必逃脫。
-  pick('foot-config').textContent = vocab.ready.length
-    ? t('foot.vocab', {
-        ready: vocab.ready.join(t('join.or')),
-        unready: vocab.unready.join(t('join.slash')),
-      })
-    : t('foot.noVocab')
-}
-
-/** 導言只講數得出來的事實。沒有可動的票、或整批都關完了，句子跟著換。 */
-function lede(): string {
-  if (!openCount) return t('lede.allDone')
-  const frontline = work.filter((i) => i.status === 'ready').sort(byStatusThenNumber)
-  const parts = [t('lede.open', { n: openCount })]
-  if (frontline.length) {
-    const first = frontline
-      .slice(0, 3)
-      .map((i) => `<a href="${esc(i.url)}" target="_blank" rel="noopener">#${i.number}</a>`)
-      .join(t('join.items'))
-    parts.push(t('lede.ready', { n: frontline.length, issues: first }))
-  } else {
-    parts.push(t('lede.none'))
-  }
-  if (counts.blocked) parts.push(t('lede.blocked', { n: counts.blocked }))
-  if (counts.triage) parts.push(t('lede.triage', { n: counts.triage }))
-  if (criticalPath > 1) parts.push(t('lede.critical', { n: criticalPath }))
-  return parts.join(' ')
-}
-
-// ---- 線路圖 ----
-
-/**
- * 同一條線就是一橫。跨線走「向右、轉、向下、轉、向右」，而垂直那一段刻意走在站與站之間的
- * 間隙裡——走中點的話會壓到中間那幾條線的站名。同一個終點有多條邊時各自錯開一點，不然它們
- * 會完全重疊成一條。
- */
-function railPath(a: Point, b: Point, nudge: number): string {
-  const x1 = a.x + MAP.dot + 3
-  const x2 = b.x - MAP.dot - 5
-  if (a.y === b.y) return `M${x1} ${a.y} H${x2}`
-  const gap = Math.max(x1 + MAP.bend + 2, b.x - MAP.step * 0.44 + nudge * 7)
-  const turn = Math.min(gap, x2 - MAP.bend - 2)
-  const dir = b.y > a.y ? 1 : -1
-  return (
-    `M${x1} ${a.y} H${turn - MAP.bend}` +
-    ` Q${turn} ${a.y} ${turn} ${a.y + dir * MAP.bend}` +
-    ` V${b.y - dir * MAP.bend}` +
-    ` Q${turn} ${b.y} ${turn + MAP.bend} ${b.y}` +
-    ` H${x2}`
-  )
-}
-
-function svgTag(tag: string, attrs: Readonly<Record<string, string | number>>): string {
-  const pairs = Object.entries(attrs)
-    .map(([key, value]) => `${key}="${value}"`)
-    .join(' ')
-  return `<${tag} ${pairs}/>`
-}
-
-/**
- * 站點用形狀分辨，不只靠線條粗細——粗細在 7px 的圓點上分不出來。
- *
- * 圓是流程上的票（實心已關、空心等前置、靶心加光暈是現在可動），三角是有人在做，菱形是規格
- * 還沒定案。兩個例外各給一個形狀，掃一眼就分得開。
- */
-function stationShape(status: Status, q: Point): string {
-  if (status === 'active') {
-    // 往右指的三角形：這一站正在往下一站走。
-    const r = MAP.dot + 1.5
-    const d = `M${q.x - r * 0.72} ${q.y - r} L${q.x + r * 0.86} ${q.y} L${q.x - r * 0.72} ${q.y + r} Z`
-    return svgTag('path', { class: 'mark', d })
-  }
-  if (status === 'triage') {
-    const d = MAP.dot + 1
-    return svgTag('rect', {
-      class: 'mark',
-      x: q.x - d,
-      y: q.y - d,
-      width: d * 2,
-      height: d * 2,
-      rx: 1,
-      transform: `rotate(45 ${q.x} ${q.y})`,
-    })
-  }
-  const dot = svgTag('circle', {
-    class: 'mark',
-    cx: q.x,
-    cy: q.y,
-    r: status === 'ready' ? MAP.dot + 2 : MAP.dot,
-  })
-  if (status !== 'ready') return dot
-  return (
-    svgTag('circle', { class: 'halo', cx: q.x, cy: q.y, r: MAP.dot + 7 }) +
-    dot +
-    svgTag('circle', { class: 'core', cx: q.x, cy: q.y, r: 3 })
-  )
-}
-
-/** 一群票對應的一張圖。`members` 是票，`track` 是這一組的線色。 */
-type Shown = { group: Group; members: readonly MapIssue[]; track: string }
-
-function trackLabel(svg: SVGSVGElement, y: number, name: string, sub: string): void {
-  const main = document.createElementNS(SVG_NS, 'text')
-  main.setAttribute('class', 'tname')
-  main.setAttribute('x', '8')
-  main.setAttribute('y', String(y - 3))
-  main.textContent = name
-  svg.appendChild(main)
-  const note = document.createElementNS(SVG_NS, 'text')
-  note.setAttribute('class', 'tsub')
-  note.setAttribute('x', '8')
-  note.setAttribute('y', String(y + 12))
-  note.textContent = sub
-  svg.appendChild(note)
-}
-
-function railFor(edge: Edge, layout: Layout, nudge: number): SVGPathElement | null {
-  const a = layout.xy.get(edge.from)
-  const b = layout.xy.get(edge.to)
-  if (!a || !b) return null
-  const rail = document.createElementNS(SVG_NS, 'path')
-  rail.setAttribute('class', 'edge')
-  rail.setAttribute('d', railPath(a, b, nudge))
-  rail.dataset.from = String(edge.from)
-  rail.dataset.to = String(edge.to)
-  rail.dataset.done = String(issueAt(edge.from)?.status === 'done')
-  return rail
-}
-
-function stationFor(issue: MapIssue, q: Point): SVGAElement {
-  const station = document.createElementNS(SVG_NS, 'a')
-  station.setAttribute('class', 'node')
-  station.setAttribute('href', issue.url)
-  station.setAttribute('target', '_blank')
-  station.setAttribute('rel', 'noopener')
-  station.setAttribute(
-    'aria-label',
-    t('node.aria', { n: issue.number, title: issue.title, status: statusLabel(issue.status) }),
-  )
-  station.dataset.status = issue.status
-  station.dataset.number = String(issue.number)
-  station.innerHTML =
-    stationShape(issue.status, q) +
-    `<text class="sid" x="${q.x}" y="${q.y - 15}" text-anchor="middle">#${issue.number}</text>` +
-    `<text class="sdesc" x="${q.x}" y="${q.y + 24}" text-anchor="middle">${esc(head(issue.title))}</text>` +
-    `<title>#${issue.number} ${esc(issue.title)}</title>`
-  // 點站看詳細；要開 GitHub 用 ⌘／Ctrl 點，或詳細面板裡的連結。
-  station.addEventListener('click', (ev) => {
-    if (ev.metaKey || ev.ctrlKey || ev.shiftKey) return
-    ev.preventDefault()
-    ev.stopPropagation()
-    // 再點同一站就取消，跟點空白處一樣——不然亮起來之後只剩 Esc 能收，那沒人找得到。
-    if (selected === issue.number) clearSelection()
-    else select(issue.number)
-  })
-  return station
-}
-
-function mapFor(shown: Shown): HTMLDivElement {
-  const layout = layoutOf(shown.members)
-  const wrap = document.createElement('div')
-  wrap.className = 'map-wrap'
-  const svg = document.createElementNS(SVG_NS, 'svg')
-  svg.setAttribute('width', String(layout.width))
-  svg.setAttribute('height', String(layout.height))
-  svg.setAttribute('viewBox', `0 0 ${layout.width} ${layout.height}`)
-  svg.setAttribute('role', 'img')
-  svg.style.setProperty('--track', shown.track)
-
-  // 線名就是終點站的票號。單站線沒有「這條線在做什麼」可講，不標。
-  layout.tracks.forEach((chain, index) => {
-    const terminus = chain[chain.length - 1]
-    if (chain.length < 2 || terminus === undefined) return
-    trackLabel(
-      svg,
-      MAP.top + index * MAP.row,
-      `→ #${terminus}`,
-      t('map.stations', { n: chain.length }),
+  for (const button of document.querySelectorAll<HTMLElement>('.fold[data-fold-for]')) {
+    const parent = Number(button.dataset.foldFor)
+    const open = !isFolded(parent)
+    button.setAttribute('aria-expanded', String(open))
+    button.setAttribute(
+      'aria-label',
+      open ? t('fold.collapse', { n: parent }) : t('fold.expand', { n: parent }),
     )
-  })
-  if (layout.islandRows) {
-    trackLabel(svg, MAP.top + layout.islandFrom * MAP.row, t('map.islandName'), t('map.islandSub'))
-  }
-
-  const seenTo = new Map<number, number>()
-  for (const edge of layout.edges) {
-    const nth = seenTo.get(edge.to) ?? 0
-    seenTo.set(edge.to, nth + 1)
-    const rail = railFor(edge, layout, nth)
-    if (rail) svg.appendChild(rail)
-  }
-
-  for (const member of shown.members) {
-    const q = layout.xy.get(member.number)
-    if (q) svg.appendChild(stationFor(member, q))
-  }
-
-  // 點圖上的空白處就取消亮線。
-  svg.addEventListener('click', (ev) => {
-    const target = ev.target
-    if (target instanceof Element && target.closest('.node')) return
-    clearSelection()
-  })
-  wrap.appendChild(svg)
-  return wrap
-}
-
-/** 每張圖底下重複一份 key。圖可以收起來，key 跟著收，不會留一段沒有圖的說明。 */
-function mapKey(): HTMLDivElement {
-  const key = document.createElement('div')
-  key.className = 'map-key'
-  const shapes: readonly [string, string][] = [
-    ['k-ready', t('legend.ready')],
-    ['k-active', t('legend.active')],
-    ['k-blocked', t('legend.blocked')],
-    ['k-triage', t('legend.triage')],
-    ['k-done', t('legend.done')],
-  ]
-  key.innerHTML =
-    shapes.map(([mark, label]) => `<span><i class="${mark}"></i>${esc(label)}</span>`).join('') +
-    `<span>${esc(t('legend.solid'))}</span>` +
-    `<span>${esc(t('legend.dashed'))}</span>`
-  return key
-}
-
-const TRACK_COLOURS = ['--t1', '--t2', '--t3', '--t4']
-
-function renderGroups(): void {
-  const groupsEl = pick('groups')
-  groupsEl.innerHTML = ''
-  const shownGroups: Shown[] = (raw.groups ?? []).map((group, index) => ({
-    group,
-    members: group.members.map(issueAt).filter((issue): issue is MapIssue => issue !== undefined),
-    track: `var(${TRACK_COLOURS[index % TRACK_COLOURS.length]})`,
-  }))
-
-  for (const shown of shownGroups) {
-    const section = document.createElement('section')
-    section.className = 'group'
-    section.style.setProperty('--track', shown.track)
-
-    const header = document.createElement('div')
-    header.className = 'group-head'
-    header.innerHTML = `<h2>${esc(groupTitle(shown.group))}</h2><span class="sub">${groupSub(shown)}</span>`
-    section.appendChild(header)
-
-    const body = mapFor(shown)
-    section.appendChild(body)
-    section.appendChild(mapKey())
-
-    // 主票的子票群可以收起來。獨立票沒有主票，不給收合。
-    const parent = shown.group.parent
-    if (parent !== null) {
-      header.insertBefore(foldButton(parent), header.firstChild)
-      section.dataset.fold = String(parent)
-      body.dataset.parent = String(parent)
-    }
-    groupsEl.appendChild(section)
-  }
-}
-
-/** 一群票的標題。主票那一群用主票標題（真資料），其他三種是頁面自己的分類。 */
-function groupTitle(group: Group): string {
-  switch (group.name.kind) {
-    case 'spec':
-      return group.name.title
-    case 'orphan':
-      return t('group.orphan', { n: group.name.parent })
-    case 'linked':
-      return t('group.linked')
-    case 'island':
-      return t('group.island')
-  }
-}
-
-function groupSub(shown: Shown): string {
-  const parent = shown.group.parent
-  // 「其他依賴鏈」與「獨立票」都沒有主票，但只有後者互不阻擋——同一句話蓋兩種群會說謊。
-  if (shown.group.name.kind === 'linked') return esc(t('group.linkedSub'))
-  if (parent === null) return esc(t('group.islandSub'))
-  const done = shown.members.filter((m) => m.status === 'done').length
-  const spec = issueAt(parent)
-  const specLink = spec
-    ? `<a href="${esc(spec.url)}" target="_blank" rel="noopener">${esc(
-        t('group.spec', { n: parent }),
-      )}</a> · `
-    : ''
-  return specLink + esc(t('group.progress', { done, total: shown.members.length }))
-}
-
-// ---- 詳細 ----
-
-/**
- * 等誰那一欄只列前幾張。一張主票可以等十幾張子票，全列出來會把整欄撐到把標題壓扁——完整
- * 清單放 title，看得到也不爆版。
- */
-const BLOCKERS_SHOWN = 4
-
-function hash(n: number): string {
-  return `#${n}`
-}
-
-function blockers(list: readonly number[]): string {
-  if (!list.length) return '—'
-  if (list.length <= BLOCKERS_SHOWN) return list.map(hash).join(' ')
-  const rest = list.length - BLOCKERS_SHOWN
-  return `${list.slice(0, BLOCKERS_SHOWN).map(hash).join(' ')} <span class="more">+${rest}</span>`
-}
-
-function link(n: number): string {
-  const issue = issueAt(n)
-  return issue ? `<a href="${esc(issue.url)}" target="_blank" rel="noopener">#${n}</a>` : `#${n}`
-}
-
-function pill(issue: MapIssue): string {
-  return `<span class="pill" data-status="${issue.status}">${esc(statusLabel(issue.status))}</span>`
-}
-
-/** 下一步的句子。模型只說是哪一種，話在這裡才組出來。 */
-function stepText(step: NextStep): string {
-  switch (step.kind) {
-    case 'none':
-      return '—'
-    case 'command':
-      return step.command
-    case 'manual':
-      return t('step.manual')
-    case 'active':
-      return step.who.length ? step.who.join(t('join.slash')) : t('step.active')
-    case 'waitIssues':
-      return t('step.waitIssues', { issues: step.issues.map(hash).join(' ') })
-    case 'waitChildren':
-      return t('step.waitChildren', { n: step.count })
-    case 'parentReady':
-      return t('step.parentReady')
-  }
-}
-
-/**
- * 是指令的時候做成按鈕，按了把「指令 ＋ 票號」整句複製走——真正要貼進去的是那一整句，只顯示
- * 指令的話還得自己補票號。其他的（接手的人、等哪幾張）就純文字。
- */
-function stepCell(issue: MapIssue): string {
-  const step = issue.nextStep
-  const text = stepText(step)
-  if (step.kind !== 'command') return `<span class="next">${esc(text)}</span>`
-  const command = `${step.command} #${issue.number}`
-  const title = esc(t('copy.title', { command }))
-  return (
-    `<button type="button" class="copy" data-copy="${esc(command)}" title="${title}">` +
-    `<span class="copy-text">${esc(step.command)}</span></button>`
-  )
-}
-
-/** 一張票的細節。上面的面板與清單裡展開的那一列共用同一份標記。 */
-function detailHTML(number: number): string {
-  const issue = issueAt(number)
-  if (!issue) return ''
-  const settled = issue.blockedBy.filter((b) => !issue.waitingFor.includes(b))
-  const opens = (unlocks.get(number) ?? []).filter((n) => issueAt(n)?.status !== 'done')
-  const closed = issue.closedAt ? esc(t('detail.closedAt', { date: dateOnly(issue.closedAt) })) : ''
-  const rows: [string, string][] = [
-    [t('detail.status'), pill(issue) + closed],
-    [t('detail.next'), stepCell(issue)],
-  ]
-  if (issue.author) rows.push([t('detail.author'), esc(issue.author)])
-  if (issue.parent !== null) rows.push([t('detail.parent'), link(issue.parent)])
-  if (issue.waitingFor.length) {
-    rows.push([t('detail.waiting'), issue.waitingFor.map(link).join(' ')])
-  }
-  if (settled.length) rows.push([t('detail.settled'), settled.map(link).join(' ')])
-  if (opens.length) rows.push([t('detail.unlocks'), opens.map(link).join(' ')])
-  if (issue.labels.length) {
-    rows.push([
-      t('detail.labels'),
-      issue.labels.map((l) => `<span class="label">${esc(l)}</span>`).join(''),
-    ])
-  }
-  if (issue.assignees.length) {
-    rows.push([t('detail.assignees'), esc(issue.assignees.join(', '))])
-  }
-  return (
-    `<h3><span class="num">#${issue.number}</span>${esc(issue.title)}</h3>` +
-    `<a class="open" href="${esc(issue.url)}" target="_blank" rel="noopener">${esc(
-      t('detail.open'),
-    )}</a>` +
-    `<dl class="rows">${rows.map(([dt, dd]) => `<dt>${esc(dt)}</dt><dd>${dd}</dd>`).join('')}</dl>`
-  )
-}
-
-const detail = pick('detail')
-
-function renderDetail(number: number | undefined): void {
-  const issue = number === undefined ? undefined : issueAt(number)
-  if (!issue) {
-    detail.dataset.status = ''
-    detail.innerHTML = `<h3>${esc(t('detail.empty'))}</h3>`
-    return
+    button.textContent = open ? '−' : '+'
   }
-  detail.dataset.status = issue.status
-  detail.innerHTML = detailHTML(issue.number)
 }
 
 // ---- 選取 ----
 
-let selected: number | null = null
-
-/** 一張票的整條上下游，用來在選取時把鏈亮起來。 */
-function chainOf(start: number): Set<number> {
-  const out = new Set([start])
-  const walks: ((n: number) => readonly number[])[] = [
-    (n) => issueAt(n)?.blockedBy ?? [],
-    (n) => unlocks.get(n) ?? [],
-  ]
-  for (const neighboursOf of walks) {
-    const stack = [start]
-    while (stack.length) {
-      const at = stack.pop()
-      if (at === undefined) break
-      for (const next of neighboursOf(at)) {
-        if (out.has(next)) continue
-        out.add(next)
-        stack.push(next)
-      }
-    }
-  }
-  return out
-}
-
-function defaultPick(): number | undefined {
-  const first = work.filter((i) => i.status === 'ready').sort(byStatusThenNumber)[0]
-  return (first ?? issues[0])?.number
-}
-
 /**
  * 選一張票。再點同一張不會取消——在清單上你往往只是想再看一次，取消掉反而要重新找。要清掉
  * 按 Esc。
@@ -714,15 +154,15 @@ function clearSelection(): void {
 }
 
 function paintSelection(): void {
-  const lit = selected === null ? null : chainOf(selected)
+  const lit = selected === null ? null : view.chainOf(selected)
   for (const svg of document.querySelectorAll<SVGSVGElement>('svg')) {
     svg.classList.toggle('has-selection', selected !== null)
-    for (const node of svg.querySelectorAll<SVGAElement>('.node')) {
+    for (const node of svg.querySelectorAll<SVGElement>('.node')) {
       const number = Number(node.dataset.number)
       node.classList.toggle('lit', lit !== null && lit.has(number))
       node.classList.toggle('selected', number === selected)
     }
-    for (const edge of svg.querySelectorAll<SVGPathElement>('.edge')) {
+    for (const edge of svg.querySelectorAll<SVGElement>('.edge')) {
       const from = Number(edge.dataset.from)
       const to = Number(edge.dataset.to)
       edge.classList.toggle('lit', lit !== null && lit.has(from) && lit.has(to))
@@ -731,117 +171,13 @@ function paintSelection(): void {
   for (const row of rowsEl.querySelectorAll<HTMLElement>('.row[data-number]')) {
     row.classList.toggle('selected', Number(row.dataset.number) === selected)
   }
-  renderDetail(selected ?? defaultPick())
-}
-
-// ---- 清單 ----
-
-type Row = { issue: MapIssue; parent: number | null; hasKids: boolean }
-
-const rowsEl = pick('rows')
-let filter: Status | 'all' = 'all'
-
-/** 主票在前、它的子票跟在後面。篩選時主票只要有子票入選就留著當標頭。 */
-function rowOrder(): Row[] {
-  const pass = new Set(
-    issues.filter((i) => filter === 'all' || i.status === filter).map((i) => i.number),
-  )
-  const kids = new Map<number, MapIssue[]>()
-  const roots: MapIssue[] = []
-  for (const issue of issues) {
-    const parent = issue.parent !== null && byNumber.has(issue.parent) ? issue.parent : null
-    if (parent === null) {
-      if (pass.has(issue.number)) roots.push(issue)
-      continue
-    }
-    if (!pass.has(issue.number)) continue
-    const siblings = kids.get(parent) ?? []
-    siblings.push(issue)
-    kids.set(parent, siblings)
-  }
-  // 有子票入選但自己沒入選的主票，仍要出現，否則子票就沒了歸屬。
-  for (const parent of kids.keys()) {
-    const issue = issueAt(parent)
-    if (issue && !roots.includes(issue)) roots.push(issue)
-  }
-
-  const rows: Row[] = []
-  for (const root of roots.sort(byStatusThenNumber)) {
-    const children = (kids.get(root.number) ?? []).sort(byStatusThenNumber)
-    rows.push({ issue: root, parent: null, hasKids: children.length > 0 })
-    for (const child of children) rows.push({ issue: child, parent: root.number, hasKids: false })
-  }
-  return rows
-}
-
-function rowHTML(row: Row): string {
-  const issue = row.issue
-  const parent = row.parent === null ? '' : ` data-parent="${row.parent}"`
-  const kids = row.hasKids ? ' data-haskids="true"' : ''
-  const slot = row.hasKids ? '<span class="fold-slot"></span>' : ''
-  const waitsTitle =
-    issue.waitingFor.length > BLOCKERS_SHOWN
-      ? ` title="${esc(issue.waitingFor.map(hash).join(' '))}"`
-      : ''
-  const waits = issue.waitingFor.length
-    ? `<span class="waits"${waitsTitle}>${t('row.waits', {
-        list: blockers(issue.waitingFor),
-      })}</span>`
-    : ''
-  return (
-    `<div class="row" tabindex="0" data-status="${issue.status}" data-number="${issue.number}"${parent}${kids}>` +
-    `<div class="id">${slot}` +
-    `<a class="no" href="${esc(issue.url)}" target="_blank" rel="noopener">#${issue.number}</a>` +
-    `<span class="who">${issue.author ? esc(issue.author) : '—'}</span></div>` +
-    `<div class="what"><span class="title">${esc(issue.title)}</span>${waits}</div>` +
-    `<div class="step">${stepCell(issue)}</div>` +
-    `<div class="gate">${pill(issue)}</div>` +
-    '</div>'
-  )
-}
-
-function renderRows(): void {
-  const rows = rowOrder()
-  const shown = rows.filter((r) => !r.issue.isParent).length
-  pick('list-title').textContent = t('list.title')
-  pick('list-sub').textContent = t('list.count', { n: shown })
-  rowsEl.innerHTML = rows.map(rowHTML).join('')
-  // 主票的收合鈕：innerHTML 重建過，鈕要重新放進去。
-  for (const row of rowsEl.querySelectorAll<HTMLElement>('.row[data-haskids="true"]')) {
-    row.querySelector('.fold-slot')?.appendChild(foldButton(Number(row.dataset.number)))
-  }
+  renderDetail(selected ?? view.defaultPick())
 }
 
-function renderTabs(): void {
-  const tabs = pick('tabs')
-  tabs.innerHTML = ''
-  tabs.setAttribute('aria-label', t('tabs.aria'))
-  const defs: [Status | 'all', string, number][] = [
-    ['all', t('tabs.all'), work.length],
-    ...STATUS_ORDER.map((s) => [s, statusLabel(s), counts[s]] as [Status, string, number]),
-  ]
-  for (const [key, label, count] of defs) {
-    const tab = document.createElement('button')
-    tab.type = 'button'
-    tab.className = 'tab'
-    tab.dataset.filter = key
-    tab.setAttribute('aria-pressed', String(key === filter))
-    tab.innerHTML = `${esc(label)}<span class="n">${count}</span>`
-    tab.addEventListener('click', () => {
-      filter = key
-      for (const other of tabs.querySelectorAll<HTMLElement>('.tab')) {
-        other.setAttribute('aria-pressed', String(other.dataset.filter === filter))
-      }
-      renderRows()
-      paintSelection()
-      const back =
-        selected === null
-          ? null
-          : rowsEl.querySelector<HTMLElement>(`.row[data-number="${selected}"]`)
-      if (back && selected !== null) openExpander(back, selected)
-    })
-    tabs.appendChild(tab)
-  }
+function renderDetail(number: number | undefined): void {
+  const panel = view.detailPanelHTML(number)
+  detail.dataset.status = panel.status
+  detail.innerHTML = panel.html
 }
 
 // ---- 就地展開 ----
@@ -856,7 +192,7 @@ function closeExpander(): void {
 
 function openExpander(row: HTMLElement, number: number): void {
   closeExpander()
-  const issue = issueAt(number)
+  const issue = view.issueAt(number)
   if (!issue) return
   const panel = document.createElement('div')
   panel.className = 'detail expand'
@@ -864,7 +200,7 @@ function openExpander(row: HTMLElement, number: number): void {
   panel.dataset.forNumber = String(number)
   // 掛上 data-parent，主票收起來時 paintFolded 會一起把它藏掉。
   if (row.dataset.parent) panel.dataset.parent = row.dataset.parent
-  panel.innerHTML = detailHTML(number)
+  panel.innerHTML = view.detailHTML(number)
   row.insertAdjacentElement('afterend', panel)
   paintFolded()
 }
@@ -933,10 +269,18 @@ function elementAt(ev: Event): Element | null {
   return ev.target instanceof Element ? ev.target : null
 }
 
-// 一個委派聽事件，換分頁不用重掛。
-rowsEl.addEventListener('click', (ev) => {
+// 全部走委派：標記是建置時畫好的，重畫也只是換 innerHTML，沒有可以逐一掛監聽的時機。
+document.addEventListener('click', (ev) => {
   const target = elementAt(ev)
   if (!target) return
+
+  const fold = target.closest<HTMLElement>('.fold[data-fold-for]')
+  if (fold) {
+    const parent = Number(fold.dataset.foldFor)
+    setFolded(parent, !isFolded(parent))
+    return
+  }
+
   const copy = target.closest<HTMLElement>('.copy')
   if (copy) {
     // 複製是自己一件事，不要順手把那一列也選起來。
@@ -944,7 +288,39 @@ rowsEl.addEventListener('click', (ev) => {
     handleCopy(copy)
     return
   }
-  if (target.closest('a') || target.closest('.fold')) return
+
+  const tab = target.closest<HTMLElement>('.tab[data-filter]')
+  if (tab) {
+    filter = (tab.dataset.filter ?? 'all') as Filter
+    renderRows()
+    paintSelection()
+    const back =
+      selected === null
+        ? null
+        : rowsEl.querySelector<HTMLElement>(`.row[data-number="${selected}"]`)
+    if (back && selected !== null) openExpander(back, selected)
+    return
+  }
+
+  // 點站看詳細；要開 GitHub 用 ⌘／Ctrl 點，或詳細面板裡的連結。
+  const node = target.closest<HTMLElement>('.node[data-number]')
+  if (node) {
+    if (ev.metaKey || ev.ctrlKey || ev.shiftKey) return
+    ev.preventDefault()
+    const number = Number(node.dataset.number)
+    // 再點同一站就取消，跟點空白處一樣——不然亮起來之後只剩 Esc 能收，那沒人找得到。
+    if (selected === number) clearSelection()
+    else select(number)
+    return
+  }
+
+  // 點圖上的空白處就取消亮線。
+  if (target.closest('.map-wrap')) {
+    clearSelection()
+    return
+  }
+
+  if (target.closest('a')) return
   const row = target.closest<HTMLElement>('.row[data-number]')
   if (row) pickRow(row)
 })
@@ -969,19 +345,39 @@ document.addEventListener('keydown', (ev) => {
   if (ev.key === 'Escape') clearSelection()
 })
 
-// ---- 起動 ----
+// ---- 重畫 ----
+
+function renderRows(): void {
+  const rows = view.rowsHTML(filter)
+  pick('list-title').textContent = t('list.title')
+  pick('list-sub').textContent = t('list.count', { n: rows.shown })
+  rowsEl.innerHTML = rows.html
+  tabsEl.innerHTML = view.tabsHTML(filter)
+  paintFolded()
+}
 
 /**
  * 整頁重畫。換語言就是走這裡——每一段都會先清掉自己那一塊，所以重畫一次不會留下上一種語言的
  * 殘骸。選取與收合是狀態不是文字，重畫時保留。
  */
 function render(): void {
-  onFold.length = 0
-  renderHeader()
-  renderGroups()
-  renderTabs()
+  const heading = view.title()
+  pick('page-title').textContent = heading
+  document.title = heading
+  document.documentElement.lang = locale()
+  pick('lang').setAttribute('aria-label', t('lang.label'))
+  pick('eyebrow').textContent = view.eyebrow()
+  pick('lede').innerHTML = view.lede()
+  pick('stats').innerHTML = view.statsHTML()
+
+  const foot = view.footerHTML()
+  pick('foot-truth').textContent = foot.truth
+  pick('foot-refresh').innerHTML = foot.refresh
+  pick('foot-config').textContent = foot.config
+
+  groupsEl.innerHTML = view.groupsHTML()
+  tabsEl.setAttribute('aria-label', t('tabs.aria'))
   renderRows()
-  paintFolded()
   // paintSelection 收尾會畫詳細，沒有選取時它自己退回預設那一張。
   paintSelection()
 }