@puredesktop/puredesktop-ui-bridge 1.0.0-beta.1 → 2.1.0

package/src/commitments/commitments.ts

@@ -0,0 +1,358 @@
+export type CommitmentDirection = 'you_owe' | 'waiting_on'
+
+export type CommitmentStatus = 'open' | 'resolved' | 'dismissed' | 'snoozed'
+
+export type CommitmentSourceType =
+  | 'manual'
+  | 'mail'
+  | 'calendar'
+  | 'teams'
+  | 'chat'
+  | 'meeting'
+
+export type CommitmentLinkType =
+  | 'mail'
+  | 'calendar'
+  | 'teams'
+  | 'chat'
+  | 'meeting'
+  | 'contact'
+  | 'task'
+
+export interface CommitmentSource {
+  type: CommitmentSourceType
+  id: string
+  label: string
+}
+
+export interface CommitmentLink {
+  type: CommitmentLinkType
+  id: string
+  label: string
+}
+
+export interface Commitment {
+  id: string
+  direction: CommitmentDirection
+  summary: string
+  counterparty: string
+  dueAt?: string
+  status: CommitmentStatus
+  source?: CommitmentSource
+  sourceQuote?: string
+  confidence?: number
+  notes?: string
+  links?: CommitmentLink[]
+  snoozedUntil?: string
+  lastActivityAt?: string
+  createdAt: string
+  updatedAt: string
+  resolvedAt?: string
+}
+
+export interface CommitmentStore {
+  schemaVersion: 1
+  commitments: Commitment[]
+}
+
+export interface CommitmentInput {
+  direction: CommitmentDirection
+  summary: string
+  counterparty: string
+  dueAt?: string
+  notes?: string
+  source?: CommitmentSource
+  sourceQuote?: string
+  confidence?: number
+  links?: CommitmentLink[]
+}
+
+export interface CommitmentQueryOptions {
+  now?: string
+  goneQuietDays?: number
+  includeClosed?: boolean
+}
+
+export type CommitmentDueState =
+  | 'none'
+  | 'due_today'
+  | 'overdue'
+  | 'upcoming'
+  | 'snoozed'
+
+export type CommitmentFilter =
+  | 'all'
+  | 'due_today'
+  | 'overdue'
+  | 'gone_quiet'
+  | 'snoozed'
+
+export interface CommitmentBuckets {
+  youOwe: Commitment[]
+  waitingOn: Commitment[]
+  dueToday: Commitment[]
+  overdue: Commitment[]
+  goneQuiet: Commitment[]
+  snoozed: Commitment[]
+}
+
+export function createCommitmentId(): string {
+  const cryptoId =
+    typeof crypto !== 'undefined' && 'randomUUID' in crypto
+      ? crypto.randomUUID()
+      : Math.random().toString(36).slice(2)
+  return `commitment_${cryptoId}`
+}
+
+export function emptyCommitmentStore(): CommitmentStore {
+  return { schemaVersion: 1, commitments: [] }
+}
+
+export function parseCommitmentStore(value: unknown): CommitmentStore {
+  if (!value || typeof value !== 'object') return emptyCommitmentStore()
+  const raw = value as Partial<CommitmentStore>
+  if (raw.schemaVersion !== 1 || !Array.isArray(raw.commitments)) {
+    return emptyCommitmentStore()
+  }
+  return {
+    schemaVersion: 1,
+    commitments: raw.commitments.filter(isCommitmentLike),
+  }
+}
+
+export function createCommitment(
+  input: CommitmentInput,
+  now = new Date().toISOString(),
+): Commitment {
+  validateCommitmentSource(input)
+  return {
+    id: createCommitmentId(),
+    direction: input.direction,
+    summary: input.summary.trim() || 'Untitled commitment',
+    counterparty: input.counterparty.trim() || 'Unknown',
+    ...(input.dueAt ? { dueAt: input.dueAt } : {}),
+    status: 'open',
+    ...(input.source ? { source: input.source } : {}),
+    ...(input.sourceQuote ? { sourceQuote: input.sourceQuote } : {}),
+    ...(input.confidence !== undefined ? { confidence: input.confidence } : {}),
+    ...(input.notes ? { notes: input.notes } : {}),
+    ...(input.links?.length ? { links: input.links } : {}),
+    createdAt: now,
+    updatedAt: now,
+  }
+}
+
+export function updateCommitment(
+  commitment: Commitment,
+  patch: Partial<
+    Pick<
+      Commitment,
+      | 'direction'
+      | 'summary'
+      | 'counterparty'
+      | 'dueAt'
+      | 'notes'
+      | 'links'
+      | 'source'
+      | 'sourceQuote'
+      | 'confidence'
+      | 'lastActivityAt'
+    >
+  >,
+  now = new Date().toISOString(),
+): Commitment {
+  validateCommitmentSource({ ...commitment, ...patch })
+  return {
+    ...commitment,
+    ...patch,
+    summary: patch.summary?.trim() || commitment.summary,
+    counterparty: patch.counterparty?.trim() || commitment.counterparty,
+    updatedAt: now,
+  }
+}
+
+export function resolveCommitment(
+  commitment: Commitment,
+  now = new Date().toISOString(),
+): Commitment {
+  return {
+    ...commitment,
+    status: 'resolved',
+    resolvedAt: now,
+    updatedAt: now,
+    snoozedUntil: undefined,
+  }
+}
+
+export function dismissCommitment(
+  commitment: Commitment,
+  now = new Date().toISOString(),
+): Commitment {
+  return {
+    ...commitment,
+    status: 'dismissed',
+    updatedAt: now,
+    snoozedUntil: undefined,
+  }
+}
+
+export function snoozeCommitment(
+  commitment: Commitment,
+  snoozedUntil: string,
+  now = new Date().toISOString(),
+): Commitment {
+  return {
+    ...commitment,
+    status: 'snoozed',
+    snoozedUntil,
+    updatedAt: now,
+  }
+}
+
+export function reactivateSnoozedCommitments(
+  store: CommitmentStore,
+  now = new Date().toISOString(),
+): CommitmentStore {
+  return {
+    ...store,
+    commitments: store.commitments.map(commitment =>
+      commitment.status === 'snoozed' &&
+      commitment.snoozedUntil &&
+      commitment.snoozedUntil <= now
+        ? { ...commitment, status: 'open', snoozedUntil: undefined, updatedAt: now }
+        : commitment,
+    ),
+  }
+}
+
+export function commitmentDueState(
+  commitment: Commitment,
+  now = new Date().toISOString(),
+): CommitmentDueState {
+  if (commitment.status === 'snoozed') return 'snoozed'
+  if (!commitment.dueAt) return 'none'
+  const today = dayKey(now)
+  const due = dayKey(commitment.dueAt)
+  if (due < today) return 'overdue'
+  if (due === today) return 'due_today'
+  return 'upcoming'
+}
+
+export function commitmentIsGoneQuiet(
+  commitment: Commitment,
+  options: CommitmentQueryOptions = {},
+): boolean {
+  if (commitment.direction !== 'waiting_on') return false
+  if (commitment.status !== 'open') return false
+  const nowMs = Date.parse(options.now ?? new Date().toISOString())
+  const lastMs = Date.parse(
+    commitment.lastActivityAt ?? commitment.updatedAt ?? commitment.createdAt,
+  )
+  const thresholdDays = options.goneQuietDays ?? 7
+  return Number.isFinite(lastMs) && nowMs - lastMs >= thresholdDays * 86_400_000
+}
+
+export function openCommitments(
+  store: CommitmentStore,
+  options: CommitmentQueryOptions = {},
+): Commitment[] {
+  const activeStore = reactivateSnoozedCommitments(
+    store,
+    options.now ?? new Date().toISOString(),
+  )
+  return activeStore.commitments
+    .filter(commitment => options.includeClosed || commitment.status === 'open')
+    .sort(compareCommitments)
+}
+
+export function commitmentBuckets(
+  store: CommitmentStore,
+  options: CommitmentQueryOptions = {},
+): CommitmentBuckets {
+  const now = options.now ?? new Date().toISOString()
+  const commitments = openCommitments(store, { ...options, includeClosed: true })
+  const visible = commitments.filter(
+    commitment => options.includeClosed || commitment.status === 'open',
+  )
+  return {
+    youOwe: visible.filter(commitment => commitment.direction === 'you_owe'),
+    waitingOn: visible.filter(commitment => commitment.direction === 'waiting_on'),
+    dueToday: visible.filter(
+      commitment => commitmentDueState(commitment, now) === 'due_today',
+    ),
+    overdue: visible.filter(
+      commitment => commitmentDueState(commitment, now) === 'overdue',
+    ),
+    goneQuiet: visible.filter(commitment =>
+      commitmentIsGoneQuiet(commitment, { ...options, now }),
+    ),
+    snoozed: commitments.filter(commitment => commitment.status === 'snoozed'),
+  }
+}
+
+export function filterCommitments(
+  store: CommitmentStore,
+  filter: CommitmentFilter,
+  options: CommitmentQueryOptions = {},
+): Commitment[] {
+  const buckets = commitmentBuckets(store, options)
+  switch (filter) {
+    case 'due_today':
+      return buckets.dueToday
+    case 'overdue':
+      return buckets.overdue
+    case 'gone_quiet':
+      return buckets.goneQuiet
+    case 'snoozed':
+      return buckets.snoozed
+    case 'all':
+      return openCommitments(store, options)
+  }
+}
+
+export function commitmentsByCounterparty(
+  store: CommitmentStore,
+  counterparty: string,
+  options: CommitmentQueryOptions = {},
+): Commitment[] {
+  const target = counterparty.trim().toLowerCase()
+  return openCommitments(store, options).filter(
+    commitment => commitment.counterparty.toLowerCase() === target,
+  )
+}
+
+function validateCommitmentSource(input: CommitmentInput | Commitment): void {
+  if (input.source && input.source.type !== 'manual' && !input.sourceQuote?.trim()) {
+    throw new Error('Extracted commitments require a source quote.')
+  }
+}
+
+function isCommitmentLike(value: unknown): value is Commitment {
+  if (!value || typeof value !== 'object') return false
+  const item = value as Partial<Commitment>
+  return (
+    typeof item.id === 'string' &&
+    (item.direction === 'you_owe' || item.direction === 'waiting_on') &&
+    typeof item.summary === 'string' &&
+    typeof item.counterparty === 'string' &&
+    typeof item.createdAt === 'string' &&
+    typeof item.updatedAt === 'string' &&
+    ['open', 'resolved', 'dismissed', 'snoozed'].includes(item.status ?? '')
+  )
+}
+
+function compareCommitments(a: Commitment, b: Commitment): number {
+  if (a.status === 'snoozed' && b.status !== 'snoozed') return 1
+  if (b.status === 'snoozed' && a.status !== 'snoozed') return -1
+  if (a.dueAt && b.dueAt) return a.dueAt.localeCompare(b.dueAt)
+  if (a.dueAt) return -1
+  if (b.dueAt) return 1
+  return b.updatedAt.localeCompare(a.updatedAt)
+}
+
+function dayKey(iso: string): string {
+  const date = new Date(iso)
+  const month = String(date.getMonth() + 1).padStart(2, '0')
+  const day = String(date.getDate()).padStart(2, '0')
+  return `${date.getFullYear()}-${month}-${day}`
+}

package/src/components/accessibility/AccessibilityReviewDialog.test.tsx

@@ -1,104 +1,104 @@
-import { act } from 'react'
-import { createRoot, type Root } from 'react-dom/client'
-import { afterEach, describe, expect, it, vi } from 'vitest'
-import { AccessibilityReviewDialog } from './AccessibilityReviewDialog.js'
-
-function render(ui: React.ReactElement): {
-  container: HTMLDivElement
-  root: Root
-} {
-  const container = document.createElement('div')
-  document.body.appendChild(container)
-  const root = createRoot(container)
-  act(() => {
-    root.render(ui)
-  })
-  return { container, root }
-}
-
-function buttonNamed(name: string): HTMLButtonElement {
-  const buttons = Array.from(document.querySelectorAll('button'))
-  const button = buttons.find(item => item.textContent?.trim() === name)
-  if (!(button instanceof HTMLButtonElement)) {
-    throw new Error(`Button not found: ${name}`)
-  }
-  return button
-}
-
-function changeTextarea(value: string): void {
-  const textarea = document.querySelector('textarea')
-  if (!(textarea instanceof HTMLTextAreaElement)) {
-    throw new Error('Draft textarea not found')
-  }
-  const valueSetter = Object.getOwnPropertyDescriptor(
-    HTMLTextAreaElement.prototype,
-    'value',
-  )?.set
-  act(() => {
-    valueSetter?.call(textarea, value)
-    textarea.dispatchEvent(new InputEvent('input', { bubbles: true }))
-  })
-}
-
-afterEach(() => {
-  document.body.innerHTML = ''
-})
-
-describe('AccessibilityReviewDialog', () => {
-  it('lets a reviewer draft, edit, and apply an image alt text fix', () => {
-    const onChange = vi.fn()
-    const html =
-      '<figure><img src="revenue-chart.png"><figcaption>Revenue by quarter</figcaption></figure>'
-
-    render(
-      <AccessibilityReviewDialog
-        open
-        html={html}
-        onClose={() => undefined}
-        onChange={onChange}
-      />,
-    )
-
-    expect(document.body.textContent).toContain('1 findings')
-    expect(document.body.textContent).toContain('Image needs alt text')
-
-    act(() => {
-      buttonNamed('Draft fix').click()
-    })
-
-    const textarea = document.querySelector('textarea')
-    expect(textarea).toBeInstanceOf(HTMLTextAreaElement)
-    expect((textarea as HTMLTextAreaElement).value).toBe('Revenue by quarter')
-
-    changeTextarea('Quarterly revenue chart')
-
-    act(() => {
-      buttonNamed('Use alt text').click()
-    })
-
-    expect(onChange).toHaveBeenCalledWith(
-      expect.stringContaining('alt="Quarterly revenue chart"'),
-    )
-  })
-
-  it('applies safe mechanical fixes without opening a draft editor', () => {
-    const onChange = vi.fn()
-    const html = '<figure><img src="separator.png"></figure>'
-
-    render(
-      <AccessibilityReviewDialog
-        open
-        html={html}
-        onClose={() => undefined}
-        onChange={onChange}
-      />,
-    )
-
-    act(() => {
-      buttonNamed('Apply fix').click()
-    })
-
-    expect(onChange).toHaveBeenCalledWith(expect.stringContaining('alt=""'))
-    expect(document.querySelector('textarea')).toBeNull()
-  })
-})
+import { act } from 'react'
+import { createRoot, type Root } from 'react-dom/client'
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { AccessibilityReviewDialog } from './AccessibilityReviewDialog.js'
+
+function render(ui: React.ReactElement): {
+  container: HTMLDivElement
+  root: Root
+} {
+  const container = document.createElement('div')
+  document.body.appendChild(container)
+  const root = createRoot(container)
+  act(() => {
+    root.render(ui)
+  })
+  return { container, root }
+}
+
+function buttonNamed(name: string): HTMLButtonElement {
+  const buttons = Array.from(document.querySelectorAll('button'))
+  const button = buttons.find(item => item.textContent?.trim() === name)
+  if (!(button instanceof HTMLButtonElement)) {
+    throw new Error(`Button not found: ${name}`)
+  }
+  return button
+}
+
+function changeTextarea(value: string): void {
+  const textarea = document.querySelector('textarea')
+  if (!(textarea instanceof HTMLTextAreaElement)) {
+    throw new Error('Draft textarea not found')
+  }
+  const valueSetter = Object.getOwnPropertyDescriptor(
+    HTMLTextAreaElement.prototype,
+    'value',
+  )?.set
+  act(() => {
+    valueSetter?.call(textarea, value)
+    textarea.dispatchEvent(new InputEvent('input', { bubbles: true }))
+  })
+}
+
+afterEach(() => {
+  document.body.innerHTML = ''
+})
+
+describe('AccessibilityReviewDialog', () => {
+  it('lets a reviewer draft, edit, and apply an image alt text fix', () => {
+    const onChange = vi.fn()
+    const html =
+      '<figure><img src="revenue-chart.png"><figcaption>Revenue by quarter</figcaption></figure>'
+
+    render(
+      <AccessibilityReviewDialog
+        open
+        html={html}
+        onClose={() => undefined}
+        onChange={onChange}
+      />,
+    )
+
+    expect(document.body.textContent).toContain('1 findings')
+    expect(document.body.textContent).toContain('Image needs alt text')
+
+    act(() => {
+      buttonNamed('Draft fix').click()
+    })
+
+    const textarea = document.querySelector('textarea')
+    expect(textarea).toBeInstanceOf(HTMLTextAreaElement)
+    expect((textarea as HTMLTextAreaElement).value).toBe('Revenue by quarter')
+
+    changeTextarea('Quarterly revenue chart')
+
+    act(() => {
+      buttonNamed('Use alt text').click()
+    })
+
+    expect(onChange).toHaveBeenCalledWith(
+      expect.stringContaining('alt="Quarterly revenue chart"'),
+    )
+  })
+
+  it('applies safe mechanical fixes without opening a draft editor', () => {
+    const onChange = vi.fn()
+    const html = '<figure><img src="separator.png"></figure>'
+
+    render(
+      <AccessibilityReviewDialog
+        open
+        html={html}
+        onClose={() => undefined}
+        onChange={onChange}
+      />,
+    )
+
+    act(() => {
+      buttonNamed('Apply fix').click()
+    })
+
+    expect(onChange).toHaveBeenCalledWith(expect.stringContaining('alt=""'))
+    expect(document.querySelector('textarea')).toBeNull()
+  })
+})