env-doctor

  on('ui.render', { component: 'AbovePrompt' }, async ($, e, next) => {
    const warnings = (await read($, findings)).filter(f => f.severity === 'warn')
    if (e.props.hasSurvey || warnings.length === 0 || (await read($, isDismissed))) return next(e)
    const { Box, Text, Button } = $.ui.resolve(e)
    const below = await next(e)
    const make = { Box, Text, Button } as unknown as BandMake
    const mode = e.surface === 'terminal' ? glyphMode : 'full'
    return band(
      make,
      [
        {
          key: 'env-doctor-warnings',
          tone: 'warn',
          icon: GLYPHS.stethoscope,
          title: 'Environment',
          text: warnings.map(f => f.short).join(' · '),
          maxLines: 3,
          actions: [
            { key: 'env-details', label: 'Details', isQuiet: true, onPress: () => void $.ui.open({ id: PANE, title: 'Environment' }) },
            { key: 'env-dismiss', label: 'Dismiss', isQuiet: true, isDismiss: true, onPress: () => void update($, isDismissed, () => true) },
          ],
        },
      ],
      e.props.bodyColumns,
      below,
      mode,
    )
  })

export function band(make: BandMake, rows: readonly BandRow[], columns: number, below?: RenderElement | null, glyphs: BandGlyphs = 'full'): RenderElement {
  const drawn = rows.map(r => bandRow(make, r, columns, glyphs))
  return make.Box({ flexDirection: 'column', children: isNothing(below) ? drawn : [...drawn, below as RenderElement] })
}

export function bandRow(make: BandMake, row: BandRow, columns: number, glyphs: BandGlyphs = 'full'): RenderElement {
  const tone = TONES[row.tone]
  const mark = glyphs === 'full' && row.icon ? row.icon[0] : tone.glyph
  const actions = row.actions ?? []
  const buttons = actions.reduce((n, a) => n + buttonWidth(a) + 1, 0)
  // a full icon (an emoji, say) may take two cells
  const markWidth = glyphs === 'full' && row.icon ? 3 : 2
  const head = row.title ? row.title.length + 3 : 0
  const tail = row.note ? row.note.length + 3 : 0
  const isStacked = actions.length > 0 && columns - markWidth - buttons - head - tail < 24
  const lines = Math.max(1, row.maxLines ?? 2)
  // the first line shares its width with the glyph, the title, the note and (beside it) the buttons; the others have it all
  const firstLine = Math.max(10, columns - markWidth - (isStacked ? 0 : buttons) - head - tail)
  const room = firstLine + (lines - 1) * Math.max(10, columns - markWidth)
  const children: RenderElement[] = []
  if (row.title) children.push(make.Text({ bold: true, children: [row.title] }), make.Text({ dimColor: true, children: [' · '] }))
  children.push(make.Text({ children: [clipText(row.text, room)] }))
  if (row.note) children.push(make.Text({ dimColor: true, children: [` · ${row.note}`] }))
  const glyph = make.Text({ color: tone.color, bold: true, children: [mark] })
  const text = make.Box({ flexShrink: 1, flexGrow: 1, children: [make.Text({ wrap: 'wrap', children })] })
  const drawn = actions.map(a =>
    make.Button({
      key: a.key,
      label: a.label,
      ...(a.hotkey ? { hotkey: a.hotkey } : {}),
      ...(a.isPrimary ? { variant: 'primary' } : {}),
      ...(a.isQuiet ? { dimColor: true } : {}),
      ...(a.isDismiss ? { role: 'dismiss' } : {}),
      onPress: a.onPress,
    }),
  )
  if (!isStacked) return make.Box({ key: row.key, flexDirection: 'row', columnGap: 1, children: [glyph, text, ...drawn] })
  return make.Box({
    key: row.key,
    flexDirection: 'column',
    children: [
      make.Box({ flexDirection: 'row', columnGap: 1, children: [glyph, text] }),
      make.Box({ flexDirection: 'row', flexWrap: 'wrap', columnGap: 1, paddingLeft: 2, children: drawn }),
    ],
  })
}

  on('ui.render', { component: 'Pane', requestId: PANE }, async ($, e) => {
    const { Box, Text, Button } = $.ui.resolve(e)
    const found = await read($, findings)
    const at = await read($, checkedAt)
    const now = await $.clock.now()
    const mode = e.surface === 'terminal' ? glyphMode : 'full'
    return (
      <Box flexDirection="column">
        <Text bold>Environment</Text>
        <Text dimColor>Checked {at === 0 ? 'not yet' : ago(now - at)}</Text>
        {found.length === 0 && (
          <Text color="green" wrap="wrap">
            {glyphOf('check', mode)} Nothing to report: toolchains, dependencies, .env and git look fine.
          </Text>
        )}
        {found.map(f => (
          <Box key={`env-doctor-${f.id}`} flexDirection="column" marginTop={1}>
            {f.severity === 'warn' ? (
              <Text color="yellow" wrap="wrap">
                {glyphOf('warn', mode)} {f.detail}
              </Text>
            ) : (
              <Text wrap="wrap">
                <Text color="cyan">{glyphOf('info', mode)}</Text> {f.detail}
              </Text>
            )}
            {f.fix && (
              <Text dimColor wrap="wrap">
                {'  '}fix: {f.fix}
              </Text>
            )}
          </Box>
        ))}
        <Box flexDirection="row" columnGap={1} marginTop={1}>
          <Button key="env-recheck" hotkey="r" label="Re-check" onPress={() => void check($)} />
          <Button key="close" hotkey="x" role="dismiss" label="Close" onPress={() => void $.ui.close({ id: PANE })} />
        </Box>
      </Box>
    )
  })