jackherd 1.8.1 → 1.10.0

package/kit/hooks/hooks/shared/plan-open-phases.ts

@@ -1,114 +0,0 @@
-/**
- * Whether a plan still has an open phase, read the way the herd reads phases (`parsePlanPhases` in the package),
- * which a hook cannot import. A test compares both on the repository's real plans.
- */
-
-/** A task of a phase, a checkbox or a row with a ⬜/✅ cell: whether it is open, and its text without the state. */
-export type PlanTask = { open: boolean; text: string }
-
-type Phase = { id: string; items: boolean[]; deferredOpen: boolean; pointer?: string }
-
-/** A phase's id, its heading without the leading hashes, and its lines up to the next heading that ends it. */
-export type PhaseBlock = { id: string; heading: string; lines: string[] }
-
-const PHASE_HEADING = /^###\s+Phase\s+(\d+[a-z]?)\b/i
-/** `## 10 — title`, and `## P15 — title` as a board names the phase. */
-const NUMBERED_SECTION = /^##\s+P?(\d+[a-z]?)\s*[—–:-]\s*(.*)$/
-const PHASE_END = /^#{1,3}\s/
-const SECTION_HEADING = /^##\s+(.+?)\s*$/
-const TOP_HEADING = /^#\s/
-const CHECKBOX = /^\s*[-*]\s+\[([ xX])\]\s+(.*)$/
-const DEFERRED_TO = /\s→\s*P(\d+[a-z]?)\s*$/i
-const SECTION_POINTER = /`##\s+([^`]+?)\s*`/
-const STATUS = { done: '✅', open: '⬜' } as const
-
-const collapsed = (text: string): string => text.trim().replace(/\s+/g, ' ')
-
-/** The task a line holds, null for a line that is none. */
-export const taskOf = (line: string): PlanTask | null => {
-  const checkbox = line.match(CHECKBOX)
-  if (checkbox) return { open: checkbox[1] === ' ', text: collapsed(checkbox[2]) }
-  const trimmed = line.trim()
-  if (!trimmed.startsWith('|')) return null
-  const cells = trimmed.replace(/^\|/, '').replace(/\|$/, '').split('|').map((cell) => cell.trim())
-  const status = cells.find((cell) => cell === STATUS.done || cell === STATUS.open)
-  if (status === undefined) return null
-  const text = cells.filter((cell) => cell !== STATUS.done && cell !== STATUS.open).join(' | ')
-  return { open: status === STATUS.open, text: collapsed(text) }
-}
-
-/** An item of a phase: `true` while open, `false` when done, null for a line that is none. */
-const itemOf = (line: string): boolean | null => taskOf(line)?.open ?? null
-
-/** An open checkbox moved on to another phase with `→ P<n>` at its end; it stays open, in that phase. */
-const isDeferred = (line: string, phaseId: string): boolean => {
-  const checkbox = line.match(CHECKBOX)
-  const target = checkbox?.[1] === ' ' ? checkbox[2].match(DEFERRED_TO)?.[1]?.toLowerCase() : undefined
-  return target !== undefined && target !== phaseId
-}
-
-const phaseIdOf = (line: string): string | undefined =>
-  (line.match(PHASE_HEADING) ?? line.match(NUMBERED_SECTION))?.[1]?.toLowerCase()
-
-const fileLine = (phase: Phase, line: string): void => {
-  phase.pointer ??= line.match(SECTION_POINTER)?.[1]
-  if (isDeferred(line, phase.id)) {
-    phase.deferredOpen = true
-    return
-  }
-  const item = itemOf(line)
-  if (item !== null) phase.items.push(item)
-}
-
-/** The phases of a plan as they stand, `### Phase <id>` and `## <id> — title` alike. */
-export const phaseBlocksOf = (markdown: string): PhaseBlock[] => {
-  const blocks: PhaseBlock[] = []
-  let open: PhaseBlock | null = null
-  for (const line of markdown.split('\n')) {
-    const id = phaseIdOf(line)
-    if (id !== undefined) {
-      open = { id, heading: collapsed(line.replace(/^#+/, '')), lines: [] }
-      blocks.push(open)
-    } else if (PHASE_END.test(line)) open = null
-    else open?.lines.push(line)
-  }
-  return blocks
-}
-
-const phasesOf = (markdown: string): Phase[] =>
-  phaseBlocksOf(markdown).map(({ id, lines }) => {
-    const phase: Phase = { id, items: [], deferredOpen: false }
-    for (const line of lines) fileLine(phase, line)
-    return phase
-  })
-
-/** The items of every `## ` section by heading, sub-headings included; the last of equal headings wins. */
-const sectionItems = (markdown: string): Map<string, boolean[]> => {
-  const sections = new Map<string, boolean[]>()
-  let open: boolean[] | null = null
-  for (const line of markdown.split('\n')) {
-    const heading = line.match(SECTION_HEADING)
-    if (heading) {
-      open = []
-      sections.set(heading[1], open)
-    } else if (TOP_HEADING.test(line)) open = null
-    else {
-      const item = itemOf(line)
-      if (item !== null) open?.push(item)
-    }
-  }
-  return sections
-}
-
-/**
- * True when a phase (`### Phase <id>` or `## <id> — title`) holds an open checkbox or ⬜ row, a deferred one included;
- * a phase without items of its own counts the section it points at (``Siehe `## Dokumentation` ``).
- */
-export const hasOpenPhase = (markdown: string): boolean => {
-  const phases = phasesOf(markdown)
-  if (phases.some((phase) => phase.deferredOpen || phase.items.includes(true))) return true
-  const pointed = phases.filter((phase) => phase.items.length === 0 && phase.pointer !== undefined)
-  if (pointed.length === 0) return false
-  const sections = sectionItems(markdown)
-  return pointed.some((phase) => (sections.get(phase.pointer ?? '') ?? []).includes(true))
-}