Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

17.2 KB
Raw Blame
'use client'

import { useId, useState } from 'react'
import {
  AlertCircle,
  Brain,
  BookOpen,
  Check,
  ChevronDown,
  FileText,
  Compass,
  Database,
  FlaskConical,
  ListChecks,
  Loader2,
  MessagesSquare,
  Mountain,
  Notebook,
  Orbit,
  PenLine,
  Ruler,
  Sprout,
  Telescope,
  Users,
} from 'lucide-react'

import type { SourceChildren, SourceCandidate, SourceLibrary } from '@/hooks/useTopicSourceLibrary'

import type { Translate } from './format'
import { useTranslation } from 'react-i18next'

/**
 * The stored value is still the emoji each icon replaces — only how it's
 * *offered* changes. A raw system emoji renders at whatever the OS font
 * decides and reads as clip art (see ProgressRing's own note on why the
 * topic card dropped this); a line icon in the app's own visual language
 * reads as considered instead of decorative, and stays identical across
 * platforms and themes.
 */
const EMBLEMS: { value: string; Icon: typeof Compass }[] = [
  { value: '🧭', Icon: Compass },
  { value: '🏔️', Icon: Mountain },
  { value: '🌿', Icon: Sprout },
  { value: '🔭', Icon: Telescope },
  { value: '🧪', Icon: FlaskConical },
  { value: '🧠', Icon: Brain },
  { value: '📐', Icon: Ruler },
  { value: '🌌', Icon: Orbit },
]

export function GoalStep({
  goal,
  emoji,
  onGoal,
  onEmoji,
}: {
  goal: string
  emoji: string
  onGoal: (value: string) => void
  onEmoji: (value: string) => void
}) {
  const { t } = useTranslation()
  return (
    <div className="mx-auto max-w-xl">
      <h3 className="text-lg font-semibold text-[var(--foreground)]">
        {t('What do you want to master?')}
      </h3>
      <p className="mt-1 text-sm leading-6 text-[var(--muted-foreground)]">
        {t(
          'Say what you want to be able to do. The tutor reads your materials and designs the outline with you in the first session — you can change it there.'
        )}
      </p>
      <label className="mt-6 block text-xs font-medium text-[var(--foreground)]">
        {t('Learning goal')}
        <textarea
          autoFocus
          data-modal-initial-focus
          value={goal}
          onChange={event => onGoal(event.target.value)}
          maxLength={2000}
          rows={5}
          placeholder={t(
            'I want to build geometric intuition for vector spaces and transformations, then solve eigenvalue problems independently.'
          )}
          className="mt-2 w-full resize-none rounded-lg border border-[var(--input)] bg-[var(--background)] px-3.5 py-3 text-sm leading-6 outline-none transition focus:border-[var(--ring)] focus:ring-2 focus:ring-[var(--ring)]/15"
        />
      </label>
      <fieldset className="mt-5">
        <legend className="text-xs font-medium text-[var(--foreground)]">{t('Goal emblem')}</legend>
        <div className="mt-2 flex flex-wrap gap-2">
          {EMBLEMS.map(({ value, Icon }) => (
            <button
              key={value}
              type="button"
              onClick={() => onEmoji(value)}
              aria-pressed={emoji === value}
              aria-label={t('Choose goal emblem {{emblem}}', { emblem: value })}
              className={`flex h-10 w-10 items-center justify-center rounded-xl border transition ${
                emoji === value
                  ? 'border-[var(--primary)] bg-[var(--primary)]/10 text-[var(--primary)]'
                  : 'border-[var(--border)] text-[var(--muted-foreground)] hover:bg-[var(--accent)] hover:text-[var(--foreground)]'
              }`}
            >
              <Icon size={18} strokeWidth={1.75} aria-hidden="true" />
            </button>
          ))}
        </div>
      </fieldset>
    </div>
  )
}

export function SourcesStep({
  library,
  loading,
  selected,
  onToggle,
  childLists,
  onExpand,
}: {
  library: SourceLibrary
  loading: boolean
  selected: Set<string>
  onToggle: (key: string) => void
  /** Child lists per opened row, fetched on demand. */
  childLists: Record<string, SourceChildren>
  onExpand: (candidate: SourceCandidate) => void
}) {
  const { t } = useTranslation()
  // Which libraries are open. Local to this step: it is view state, and the
  // documents themselves are cached in the hook that fetched them.
  const [opened, setOpened] = useState<Set<string>>(new Set())
  const toggleOpen = (candidate: SourceCandidate) => {
    const next = new Set(opened)
    if (next.has(candidate.key)) next.delete(candidate.key)
    else {
      next.add(candidate.key)
      onExpand(candidate)
    }
    setOpened(next)
  }
  const groups = [
    { key: 'knowledgeBases', label: 'Knowledge bases', icon: Database },
    { key: 'notebooks', label: 'Notebooks', icon: Notebook },
    { key: 'books', label: 'Books', icon: BookOpen },
    { key: 'questionSets', label: 'Question bank', icon: ListChecks },
    { key: 'chats', label: 'Conversations', icon: MessagesSquare },
    { key: 'drafts', label: 'Co-Writer drafts', icon: PenLine },
    { key: 'partners', label: 'Partners', icon: Users },
  ] as const
  const [tab, setTab] = useState<string>('knowledgeBases')
  const tabId = useId()
  const [search, setSearch] = useState('')
  const group = groups.find(group => group.key === tab)!
  const visible = library[group.key].filter(item =>
    `${item.label} ${item.detail}`.toLowerCase().includes(search.toLowerCase())
  )
  return (
    <div className="space-y-4">
      <div className="flex flex-wrap items-center justify-between gap-3">
        <h3 className="text-sm font-semibold">{t('Knowledge sources')}</h3>
        <span className="text-xs text-muted-foreground" aria-live="polite">
          {t('{{count}} selected', { count: selected.size })}
        </span>
      </div>
      <div className="flex flex-wrap items-center gap-3">
        <input
          type="search"
          aria-label={t('Search materials')}
          placeholder={t('Search materials')}
          value={search}
          onChange={event => setSearch(event.target.value)}
          className="h-9 min-w-40 flex-1 rounded-lg border border-border bg-background px-3 text-sm outline-none focus:ring-2 focus:ring-primary/20"
        />
      </div>
      <div
        role="tablist"
        aria-label={t('Knowledge sources')}
        className="flex gap-1 overflow-x-auto border-b border-border"
      >
        {groups
          .filter(item => item.key !== 'partners' || library.partners.length)
          .map(item => (
            <button
              type="button"
              role="tab"
              id={`${tabId}-${item.key}`}
              aria-controls={`${tabId}-panel`}
              tabIndex={tab === item.key ? 0 : -1}
              aria-selected={tab === item.key}
              key={item.key}
              onClick={() => setTab(item.key)}
              onKeyDown={event => {
                if (!['ArrowLeft', 'ArrowRight', 'Home', 'End'].includes(event.key)) return
                event.preventDefault()
                const tabs = Array.from(
                  event.currentTarget.parentElement!.querySelectorAll<HTMLButtonElement>(
                    '[role="tab"]'
                  )
                )
                const current = tabs.indexOf(event.currentTarget)
                const next =
                  event.key === 'Home'
                    ? 0
                    : event.key === 'End'
                      ? tabs.length - 1
                      : (current + (event.key === 'ArrowRight' ? 1 : -1) + tabs.length) %
                        tabs.length
                tabs[next].focus()
                tabs[next].click()
              }}
              className={`inline-flex shrink-0 items-center gap-1.5 border-b-2 px-3 py-2.5 text-xs ${tab === item.key ? 'border-primary font-medium text-foreground' : 'border-transparent text-muted-foreground hover:text-foreground'}`}
            >
              <item.icon size={14} />
              {t(item.label)}
              <span className="tabular-nums opacity-60">
                {library[item.key].length}
              </span>
            </button>
          ))}
      </div>
      {library.failures.length > 0 && (
        <p role="alert" className="text-xs text-destructive">
          {t('navigation.loadError')}
        </p>
      )}
      <div
        role="tabpanel"
        id={`${tabId}-panel`}
        aria-labelledby={`${tabId}-${tab}`}
        className="max-h-[360px] min-h-40 overflow-y-auto overscroll-contain pr-1"
      >
        {loading ? (
          <div className="flex justify-center py-14">
            <Loader2 className="animate-spin" size={20} />
          </div>
        ) : (
          <SourceSection
            icon={group.icon}
            title=""
            empty={t('No matching materials')}
            items={visible}
            selected={selected}
            onToggle={onToggle}
            childLists={childLists}
            opened={opened}
            onToggleOpen={toggleOpen}
          />
        )}
      </div>
    </div>
  )
}

/**
 * One selectable source: a checkbox, a name, and a line of detail.
 *
 * ``bare`` drops the row's own frame for a row that sits *inside* one — a
 * library heading a document list already has a border around the whole
 * group, and drawing a second one around the heading reads as a card inside
 * a card. The border width is kept and made transparent so selecting a row
 * cannot shift the layout by a pixel.
 */
function SourceRow({
  item,
  active,
  onToggle,
  disabled = false,
  note = '',
  bare = false,
}: {
  item: SourceCandidate
  active: boolean
  onToggle: () => void
  disabled?: boolean
  note?: string
  bare?: boolean
}) {
  const { t } = useTranslation()
  // A container holds no text of its own — a question-bank category, a study
  // partner. Showing it a checkbox would promise a selection the server has no
  // way to honour, so it renders as a plain heading and only opens.
  const selectable = item.selectable !== false
  return (
    <button
      type="button"
      onClick={onToggle}
      aria-pressed={selectable ? active : undefined}
      disabled={disabled || !item.available}
      className={`flex min-h-16 w-full items-center gap-3 border p-3 text-left transition disabled:cursor-not-allowed disabled:opacity-55 ${
        bare ? 'border-transparent' : 'rounded-xl'
      } ${
        active
          ? `bg-[color-mix(in_srgb,var(--primary)_6%,transparent)] ${bare ? '' : 'border-[var(--primary)]'}`
          : `hover:bg-[color-mix(in_srgb,var(--accent)_60%,transparent)] ${bare ? '' : 'border-[var(--border)]'}`
      }`}
    >
      {selectable && (
        <span
          className={`flex h-5 w-5 shrink-0 items-center justify-center rounded-md border ${
            active
              ? 'border-[var(--primary)] bg-[var(--primary)] text-[var(--primary-foreground)]'
              : 'border-[var(--input)]'
          }`}
        >
          {active && <Check className="h-3 w-3" />}
        </span>
      )}
      <span className="min-w-0 flex-1">
        <span className="block truncate text-sm font-medium text-[var(--foreground)]">
          {item.label}
        </span>
        <span className="mt-0.5 block truncate text-xs text-[var(--muted-foreground)]">
          {note || (item.available ? item.detail : t('Currently unavailable'))}
        </span>
      </span>
    </button>
  )
}

/**
 * What sits inside one opened row: a library's documents, a category's
 * questions, a partner's conversations.
 *
 * Taking the whole container answers "what does this say about my goal?".
 * Picking one child answers "build this around chapter 3" — a different
 * question, and the only one that can be asked by naming the thing itself.
 */
function ChildSourceList({
  parent,
  state,
  selected,
  onToggle,
  parentSelected,
}: {
  parent: SourceCandidate
  state: SourceChildren | undefined
  selected: Set<string>
  onToggle: (key: string) => void
  parentSelected: boolean
}) {
  const { t } = useTranslation()
  if (!state || state.loading) {
    return (
      <div className="flex items-center gap-2 px-3 py-3 text-xs text-[var(--muted-foreground)]">
        <Loader2 className="h-3.5 w-3.5 animate-spin" />
        {t('Loading…')}
      </div>
    )
  }
  if (state.error) {
    return (
      <div className="flex items-start gap-2 px-3 py-3 text-xs text-[var(--muted-foreground)]">
        <AlertCircle className="mt-0.5 h-3.5 w-3.5 shrink-0" />
        {state.error}
      </div>
    )
  }
  if (state.candidates.length === 0) {
    return (
      <div className="px-3 py-3 text-xs text-[var(--muted-foreground)]">
        {/* A connected external resource keeps its files where they live; the
            whole library is still selectable, one of its documents is not. */}
        {t('Nothing here to pick from.')}
      </div>
    )
  }
  return (
    <div className="max-h-56 space-y-1 overflow-y-auto px-2 pb-2">
      {state.candidates.map(child => (
        <SourceRow
          key={child.key}
          item={child}
          active={selected.has(child.key)}
          onToggle={() => onToggle(child.key)}
          disabled={parentSelected}
          note={
            parentSelected
              ? t('Already covered by the whole library')
              : `${parent.label} · ${child.path || child.detail}`
          }
        />
      ))}
    </div>
  )
}

function SourceSection({
  icon: Icon,
  title,
  empty,
  items,
  selected,
  onToggle,
  hint = '',
  childLists,
  opened,
  onToggleOpen,
}: {
  icon: typeof BookOpen
  title: string
  empty: string
  items: SourceCandidate[]
  selected: Set<string>
  onToggle: (key: string) => void
  hint?: string
  /** Present for sections whose rows can be opened up. */
  childLists?: Record<string, SourceChildren>
  opened?: Set<string>
  onToggleOpen?: (candidate: SourceCandidate) => void
}) {
  const { t } = useTranslation()
  const expandable = Boolean(childLists && opened && onToggleOpen)
  return (
    <section>
      {title && (
        <div className="mb-2 flex items-center gap-2 text-xs font-semibold uppercase tracking-[0.13em] text-[var(--muted-foreground)]">
          <Icon className="h-3.5 w-3.5" /> {title}
        </div>
      )}
      {hint && items.length > 0 && (
        <p className="mb-2 text-xs leading-5 text-[var(--muted-foreground)]">{hint}</p>
      )}
      {items.length === 0 ? (
        <div className="rounded-xl border border-dashed border-[var(--border)] px-3 py-4 text-xs text-[var(--muted-foreground)]">
          {empty}
        </div>
      ) : expandable ? (
        // One column: a document list belongs directly under the library it
        // came from, and a file's path is too long for a half-width card.
        <div className="grid gap-2">
          {items.map(item => {
            const isOpen = Boolean(opened?.has(item.key))
            const state = childLists?.[item.key]
            const picked = state
              ? state.candidates.filter(file => selected.has(file.key)).length
              : 0
            return (
              <div
                key={item.key}
                className={`overflow-hidden rounded-xl border transition-colors ${
                  selected.has(item.key) ? 'border-[var(--primary)]' : 'border-[var(--border)]'
                }`}
              >
                <div className="flex items-stretch">
                  <div className="min-w-0 flex-1">
                    <SourceRow
                      item={item}
                      active={selected.has(item.key)}
                      onToggle={() =>
                        item.selectable === false ? onToggleOpen?.(item) : onToggle(item.key)
                      }
                      bare
                      note={picked > 0 ? `${picked} ${t('selected inside')}` : ''}
                    />
                  </div>
                  <button
                    type="button"
                    onClick={() => onToggleOpen?.(item)}
                    aria-expanded={isOpen}
                    disabled={!item.available}
                    className="flex w-11 shrink-0 items-center justify-center border-l border-[var(--border)] text-[var(--muted-foreground)] transition hover:bg-[color-mix(in_srgb,var(--accent)_60%,transparent)] hover:text-[var(--foreground)] disabled:opacity-40"
                    aria-label={t('Show what is inside')}
                  >
                    <span className="flex flex-col items-center gap-0.5">
                      <FileText className="h-3.5 w-3.5" />
                      <ChevronDown
                        className={`h-3 w-3 transition-transform ${isOpen ? 'rotate-180' : ''}`}
                      />
                    </span>
                  </button>
                </div>
                {isOpen && (
                  <div className="border-t border-[var(--border)] bg-[color-mix(in_srgb,var(--muted)_75%,transparent)]">
                    <ChildSourceList
                      parent={item}
                      state={state}
                      selected={selected}
                      onToggle={onToggle}
                      parentSelected={selected.has(item.key)}
                    />
                  </div>
                )}
              </div>
            )
          })}
        </div>
      ) : (
        <div className="grid gap-2 sm:grid-cols-2">
          {items.map(item => (
            <SourceRow
              key={item.key}
              item={item}
              active={selected.has(item.key)}
              onToggle={() => onToggle(item.key)}
            />
          ))}
        </div>
      )}
    </section>
  )
}