vitepress-theme-pm 0.1.0

package/src/composables/useMarkdown.ts

@@ -0,0 +1,24 @@
+export function countCheckboxes(body: string): { done: number; total: number } {
+  const matches = body.match(/- \[([ x])\]/g) || []
+  return {
+    done: matches.filter(m => m.includes('[x]')).length,
+    total: matches.length,
+  }
+}
+
+export function toggleCheckbox(body: string, index: number): string {
+  let ci = -1
+  return body
+    .split('\n')
+    .map(line => {
+      const m = line.match(/^(\s*- \[)([ x])(\] .+)$/)
+      if (m) {
+        ci++
+        if (ci === index) {
+          return m[1] + (m[2] === 'x' ? ' ' : 'x') + m[3]
+        }
+      }
+      return line
+    })
+    .join('\n')
+}

package/src/composables/useTicketWriter.ts

@@ -0,0 +1,32 @@
+import { ref } from 'vue'
+
+export function useTicketWriter() {
+  const saving = ref(false)
+  const error = ref<string | null>(null)
+
+  const isDev = import.meta.env.DEV
+
+  async function writeTicket(url: string, updates: Record<string, unknown>) {
+    if (!isDev) return
+
+    saving.value = true
+    error.value = null
+
+    try {
+      const res = await fetch('/__vitepress_pm_update', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ url, updates }),
+      })
+      if (!res.ok) {
+        error.value = await res.text()
+      }
+    } catch (e) {
+      error.value = String(e)
+    } finally {
+      saving.value = false
+    }
+  }
+
+  return { saving, error, writeTicket }
+}

package/src/index.ts

@@ -0,0 +1,12 @@
+import type { Theme } from 'vitepress'
+import DefaultTheme from 'vitepress/theme'
+import Layout from './Layout.vue'
+
+export type { Ticket, Column, BoardConfig } from './types'
+
+const theme: Theme = {
+  extends: DefaultTheme,
+  Layout,
+}
+
+export default theme

package/src/plugins/markdownWriter.ts

@@ -0,0 +1,223 @@
+import type { Plugin } from 'vite'
+import fs from 'node:fs'
+import path from 'node:path'
+import matter from 'gray-matter'
+
+interface ScannedTicket {
+  id: number
+  title: string
+  status: string
+  priority: string
+  tags: string[]
+  body: string
+  url: string
+}
+
+/** Scan a tickets directory and return all tickets as JSON-serializable objects. */
+export function scanTickets(ticketsDir: string, dirRelative: string): ScannedTicket[] {
+  if (!fs.existsSync(ticketsDir)) return []
+
+  const files = fs.readdirSync(ticketsDir).filter(f => f.endsWith('.md'))
+  return files.map(file => {
+    const raw = fs.readFileSync(path.join(ticketsDir, file), 'utf-8')
+    const parsed = matter(raw)
+    return {
+      id: Number(parsed.data.id) || 0,
+      title: parsed.data.title || path.basename(file, '.md'),
+      status: parsed.data.status || 'backlog',
+      priority: parsed.data.priority || 'medium',
+      tags: parsed.data.tags || [],
+      body: parsed.content.trim(),
+      url: `/${dirRelative}/${path.basename(file, '.md')}.html`,
+    }
+  })
+}
+
+/** Scan a tickets directory and return the highest numeric `id` found in frontmatter. */
+export function getMaxTicketId(ticketsDir: string): number {
+  if (!fs.existsSync(ticketsDir)) return 0
+  const files = fs.readdirSync(ticketsDir).filter(f => f.endsWith('.md'))
+  let max = 0
+  for (const file of files) {
+    const raw = fs.readFileSync(path.join(ticketsDir, file), 'utf-8')
+    const parsed = matter(raw)
+    const id = Number(parsed.data.id)
+    if (id > max) max = id
+  }
+  return max
+}
+
+function findMarkdownFiles(dir: string): string[] {
+  const results: string[] = []
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name)
+    if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules') {
+      results.push(...findMarkdownFiles(full))
+    } else if (entry.isFile() && entry.name.endsWith('.md')) {
+      results.push(full)
+    }
+  }
+  return results
+}
+
+export function markdownWriterPlugin(): Plugin {
+  let srcDir = ''
+  let nextId = 0
+
+  return {
+    name: 'vitepress-pm-markdown-writer',
+
+    configResolved(config) {
+      srcDir = config.root
+    },
+
+    configureServer(server) {
+      // Serve ticket data as JSON
+      server.middlewares.use('/__vitepress_pm_tickets', (req, res) => {
+        const url = new URL(req.url || '/', 'http://localhost')
+        const dir = url.searchParams.get('dir') || 'tickets'
+        const ticketsDir = path.resolve(srcDir, dir)
+
+        const tickets = scanTickets(ticketsDir, dir)
+
+        // Keep server counter in sync
+        let maxId = 0
+        for (const t of tickets) { if (t.id > maxId) maxId = t.id }
+        nextId = maxId + 1
+
+        res.setHeader('Content-Type', 'application/json')
+        res.end(JSON.stringify(tickets))
+      })
+
+      // Create a new ticket (server-assigned sequential ID)
+      server.middlewares.use('/__vitepress_pm_create', (req, res) => {
+        if (req.method !== 'POST') {
+          res.statusCode = 405
+          res.end('Method not allowed')
+          return
+        }
+
+        let body = ''
+        req.on('data', chunk => { body += chunk })
+        req.on('end', () => {
+          try {
+            const { dir, status, title, priority, tags, body: ticketBody } = JSON.parse(body)
+            const ticketsDir = path.resolve(srcDir, dir || 'tickets')
+
+            if (!fs.existsSync(ticketsDir)) {
+              fs.mkdirSync(ticketsDir, { recursive: true })
+            }
+
+            // Recalculate to be safe (another process may have created files)
+            const currentMax = getMaxTicketId(ticketsDir)
+            if (nextId <= currentMax) nextId = currentMax + 1
+
+            const id = nextId++
+            const frontmatter = {
+              id,
+              title: title || 'New ticket',
+              status: status || 'backlog',
+              priority: priority || 'medium',
+              tags: tags || [],
+            }
+
+            const bodyContent = ticketBody ? `\n${ticketBody}\n` : '\n'
+            const content = matter.stringify(bodyContent, frontmatter)
+            const filePath = path.join(ticketsDir, `${id}.md`)
+            fs.writeFileSync(filePath, content)
+
+            const ticket = {
+              ...frontmatter,
+              body: ticketBody || '',
+              url: `/${dir || 'tickets'}/${id}.html`,
+            }
+
+            res.setHeader('Content-Type', 'application/json')
+            res.end(JSON.stringify(ticket))
+          } catch (e) {
+            res.statusCode = 500
+            res.end(String(e))
+          }
+        })
+      })
+
+      // Update an existing ticket
+      server.middlewares.use('/__vitepress_pm_update', (req, res) => {
+        if (req.method !== 'POST') {
+          res.statusCode = 405
+          res.end('Method not allowed')
+          return
+        }
+
+        let body = ''
+        req.on('data', chunk => { body += chunk })
+        req.on('end', () => {
+          try {
+            const { url, updates } = JSON.parse(body)
+            if (!url || typeof url !== 'string') {
+              res.statusCode = 400
+              res.end('Missing url')
+              return
+            }
+
+            // url is like /tickets/1.html -> tickets/1.md
+            const mdPath = url.replace(/\.html$/, '.md').replace(/^\//, '')
+            const filePath = path.resolve(srcDir, mdPath)
+
+            if (!fs.existsSync(filePath)) {
+              res.statusCode = 404
+              res.end(`File not found: ${mdPath}`)
+              return
+            }
+
+            const raw = fs.readFileSync(filePath, 'utf-8')
+            const parsed = matter(raw)
+
+            // Merge updates into frontmatter
+            for (const [key, value] of Object.entries(updates)) {
+              if (key === 'body') {
+                parsed.content = '\n' + String(value) + '\n'
+              } else {
+                parsed.data[key] = value
+              }
+            }
+
+            const output = matter.stringify(parsed.content, parsed.data)
+            fs.writeFileSync(filePath, output)
+
+            res.statusCode = 200
+            res.end('ok')
+          } catch (e) {
+            res.statusCode = 500
+            res.end(String(e))
+          }
+        })
+      })
+    },
+
+    generateBundle() {
+      // Find .md files with board: true frontmatter and emit static ticket JSON
+      const mdFiles = findMarkdownFiles(srcDir)
+      const seen = new Set<string>()
+
+      for (const file of mdFiles) {
+        const raw = fs.readFileSync(file, 'utf-8')
+        const parsed = matter(raw)
+        if (!parsed.data.board) continue
+
+        const dir = parsed.data.ticketsDir || 'tickets'
+        if (seen.has(dir)) continue
+        seen.add(dir)
+
+        const ticketsDir = path.resolve(srcDir, dir)
+        const tickets = scanTickets(ticketsDir, dir)
+
+        this.emitFile({
+          type: 'asset',
+          fileName: `__vitepress_pm_tickets/${dir}.json`,
+          source: JSON.stringify(tickets),
+        })
+      }
+    },
+  }
+}

package/src/styles/board.css

@@ -0,0 +1,40 @@
+:root {
+  --board-bg: #0d1117;
+  --board-surface: #1a202c;
+  --board-surface-hover: #2d3748;
+  --board-border: #2d3748;
+  --board-text: #e2e8f0;
+  --board-text-secondary: #a0aec0;
+  --board-text-muted: #718096;
+  --board-accent: #e6a817;
+  --board-priority-critical: #f56565;
+  --board-priority-high: #ed8936;
+  --board-priority-medium: #ecc94b;
+  --board-priority-low: #68d391;
+}
+
+.board-columns::-webkit-scrollbar {
+  height: 6px;
+}
+
+.board-columns::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+.board-columns::-webkit-scrollbar-thumb {
+  background: var(--board-border);
+  border-radius: 3px;
+}
+
+.board-column-cards::-webkit-scrollbar {
+  width: 4px;
+}
+
+.board-column-cards::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+.board-column-cards::-webkit-scrollbar-thumb {
+  background: var(--board-border);
+  border-radius: 2px;
+}

package/src/types.ts

@@ -0,0 +1,21 @@
+export interface Ticket {
+  id: number
+  title: string
+  status: string
+  priority: 'critical' | 'high' | 'medium' | 'low'
+  tags: string[]
+  body: string
+  url: string
+}
+
+export interface Column {
+  key: string
+  label: string
+  color: string
+}
+
+export interface BoardConfig {
+  columns: Column[]
+  ticketsDir: string
+  ticketPrefix: string
+}