git-trace 0.1.0

package/src/shared.ts

@@ -0,0 +1,108 @@
+// Shared utilities for git adapters — parse diffs, detect AI authors, format dates
+
+import { DEFAULT_PATTERNS } from './patterns'
+import type { Commit } from './types'
+
+// Parse unified diff format into lines
+export function parseDiff(diffText: string): Commit['lines'] {
+  const lines: Commit['lines'] = []
+
+  for (const line of diffText.split('\n')) {
+    // Skip diff headers
+    if (line.startsWith('@@')) continue
+    if (line.startsWith('+++') || line.startsWith('---')) continue
+    if (line.startsWith('index') || line.startsWith('diff')) continue
+    if (line.startsWith('new file') || line.startsWith('deleted file')) continue
+
+    if (line.startsWith('+')) {
+      lines.push({ type: 'add', content: line.slice(1) })
+    } else if (line.startsWith('-')) {
+      lines.push({ type: 'remove', content: line.slice(1) })
+    } else {
+      lines.push({ type: 'ctx', content: line.slice(1) || '' })
+    }
+  }
+
+  return lines
+}
+
+// Compile string arrays to lowercase Sets for fast O(1) lookup
+function compilePatterns(patterns: typeof DEFAULT_PATTERNS) {
+  return {
+    emails: new Set(patterns.emails.map(p => p.toLowerCase())),
+    messages: new Set(patterns.messages.map(p => p.toLowerCase()))
+  }
+}
+
+// Cached compiled defaults
+const CACHED_DEFAULTS = compilePatterns(DEFAULT_PATTERNS)
+
+// Detect if author is AI based on patterns
+export function detectAI(
+  login?: string,
+  email?: string,
+  message?: string,
+  patterns?: typeof DEFAULT_PATTERNS
+): 'human' | 'ai' {
+  const compiled = patterns ? compilePatterns(patterns) : CACHED_DEFAULTS
+  const toCheck = [login, email, message].filter(Boolean)
+
+  for (const str of toCheck) {
+    const lower = str!.toLowerCase()
+    for (const pattern of compiled.emails) {
+      if (lower === pattern || lower.includes(pattern)) return 'ai'
+    }
+    for (const pattern of compiled.messages) {
+      if (lower.includes(pattern)) return 'ai'
+    }
+  }
+
+  return 'human'
+}
+
+// Format date to relative time string
+export function formatRelativeTime(dateStr: string): string {
+  const date = new Date(dateStr)
+  const diff = Date.now() - date.getTime()
+  const days = Math.floor(diff / 86400000)
+
+  if (days > 30) {
+    return date.toLocaleDateString('en-US', { month: 'short', day: 'numeric' })
+  }
+  if (days > 0) return `${days}d ago`
+
+  const hours = Math.floor(diff / 3600000)
+  if (hours > 0) return `${hours}h ago`
+
+  const minutes = Math.floor(diff / 60000)
+  if (minutes > 0) return `${minutes}m ago`
+
+  return 'just now'
+}
+
+// Extract short hash from full SHA (7 characters)
+export function shortHash(sha: string): string {
+  return sha.slice(0, 7)
+}
+
+// Get first line of commit message
+export function firstLine(message: string): string {
+  return message.split('\n')[0]
+}
+
+// Filter Promise.allSettled results to non-null Commit array
+export function filterSettledCommits(results: PromiseSettledResult<Commit | null>[]): Commit[] {
+  return results
+    .map(r => r.status === 'fulfilled' ? r.value : null)
+    .filter((c): c is Commit => c !== null)
+}
+
+// Escape HTML to prevent XSS attacks
+export function escapeHtml(unsafe: string): string {
+  return unsafe
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#039;')
+}

package/src/themes.ts

@@ -0,0 +1,98 @@
+// 2026 preset themes — modern, accessible, trend-aligned color schemes
+
+import type { Theme, ThemeColors } from './types'
+
+export const themes: Record<Theme, ThemeColors> = {
+  // Dark theme (default) — classic developer dark mode
+  dark: {
+    bg: '#09090b',
+    fg: '#e4e4e7',
+    dim: '#71717a',
+    human: '#22c55e',
+    ai: '#a855f7',
+    add: 'rgba(34, 102, 68, 0.25)',
+    remove: 'rgba(185, 28, 28, 0.2)',
+    border: '#27272a',
+    borderSubtle: '#18181b'
+  },
+
+  // Light theme — clean, minimal
+  light: {
+    bg: '#ffffff',
+    fg: '#18181b',
+    dim: '#71717a',
+    human: '#16a34a',
+    ai: '#9333ea',
+    add: 'rgba(22, 163, 74, 0.15)',
+    remove: 'rgba(220, 38, 38, 0.12)',
+    border: '#e4e4e7',
+    borderSubtle: '#f4f4f5'
+  },
+
+  // Midnight — deep blue-black, cyberpunk adjacent
+  midnight: {
+    bg: '#030712',
+    fg: '#e2e8f0',
+    dim: '#64748b',
+    human: '#06b6d4',
+    ai: '#f472b6',
+    add: 'rgba(6, 182, 212, 0.2)',
+    remove: 'rgba(244, 114, 182, 0.15)',
+    border: '#1e293b',
+    borderSubtle: '#0f172a'
+  },
+
+  // Cyber — neon accents on near-black
+  cyber: {
+    bg: '#050505',
+    fg: '#f0f0f0',
+    dim: '#6b6b6b',
+    human: '#00ff9f',
+    ai: '#ff00ff',
+    add: 'rgba(0, 255, 159, 0.2)',
+    remove: 'rgba(255, 0, 255, 0.15)',
+    border: '#2a2a2a',
+    borderSubtle: '#0a0a0a'
+  },
+
+  // Forest — nature-inspired greens
+  forest: {
+    bg: '#0a1208',
+    fg: '#d4e5d4',
+    dim: '#5a6a5a',
+    human: '#4ade80',
+    ai: '#2dd4bf',
+    add: 'rgba(74, 222, 128, 0.2)',
+    remove: 'rgba(248, 113, 113, 0.15)',
+    border: '#1a2a1a',
+    borderSubtle: '#0a180a'
+  },
+
+  // Sunset — warm tones, easy on eyes
+  sunset: {
+    bg: '#0f0808',
+    fg: '#f5e6e6',
+    dim: '#7a5a5a',
+    human: '#fb923c',
+    ai: '#f43f5e',
+    add: 'rgba(251, 146, 60, 0.2)',
+    remove: 'rgba(244, 63, 94, 0.15)',
+    border: '#2a1a1a',
+    borderSubtle: '#1a0a0a'
+  }
+}
+
+// Generate CSS variables from theme colors
+export function themeToVars(theme: ThemeColors): Record<string, string> {
+  return {
+    '--trace-bg': theme.bg,
+    '--trace-fg': theme.fg,
+    '--trace-dim': theme.dim,
+    '--trace-human': theme.human,
+    '--trace-ai': theme.ai,
+    '--trace-add': theme.add,
+    '--trace-remove': theme.remove,
+    '--trace-border': theme.border,
+    '--trace-border-subtle': theme.borderSubtle
+  }
+}

package/src/types.ts

@@ -0,0 +1,72 @@
+// Type definitions for Trace component and commit data
+
+export type Theme = 'dark' | 'light' | 'midnight' | 'cyber' | 'forest' | 'sunset'
+
+export interface ThemeColors {
+  bg: string
+  fg: string
+  dim: string
+  human: string
+  ai: string
+  add: string
+  remove: string
+  border: string
+  borderSubtle: string
+}
+
+export type Commit = {
+  hash: string
+  message: string
+  author: string
+  authorType: 'human' | 'ai'
+  time: string
+  lines: DiffLine[]
+}
+
+export type DiffLine = {
+  type: 'add' | 'remove' | 'ctx'
+  content: string
+}
+
+export type AuthorTypeFilter = 'all' | 'human' | 'ai'
+
+export type FilterOptions = {
+  search?: string
+  authorType?: AuthorTypeFilter
+  dateFrom?: string
+  dateTo?: string
+}
+
+export type TraceProps = {
+  commits?: Commit[]
+  autoPlay?: boolean
+  interval?: number
+  onCommit?: (commit: Commit) => void
+  className?: string
+  theme?: Theme
+  filterable?: boolean
+  defaultFilter?: FilterOptions
+  onFilterChange?: (filter: FilterOptions) => void
+}
+
+// GitHub API response types
+export interface GitHubCommit {
+  sha: string
+  commit: {
+    message: string
+    author: {
+      name: string
+      email: string
+      date: string
+    }
+  }
+  author?: {
+    login: string
+  }
+  files?: GitHubFile[]
+}
+
+export interface GitHubFile {
+  patch?: string
+  filename: string
+}