Skip to content

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

15.0 KB
Raw Blame
"use client";

// Classic UI snapshot — web/components/sidebar/SidebarShell.tsx as it ships on
// dev (frozen at 3cbecb2). Do not evolve this copy; the modern shell lives
// in components/sidebar/SidebarShell.tsx.

import { navigateTask } from "@/lib/workspace-scope";
import Image from "next/image";
import dynamic from "next/dynamic";
import Link from "next/link";
import { usePathname, useRouter } from "next/navigation";
import {
  useCallback,
  useEffect,
  useRef,
  useState,
  type ReactNode,
  type CSSProperties,
} from "react";
import { useAppShell } from "@/context/AppShellContext";
import { PanelLeftClose, PanelLeftOpen } from "lucide-react";
import { useTranslation } from "react-i18next";
import { useChatWorkspaces } from "@/hooks/useChatWorkspaces";
import SessionList from "@/components/SessionList";
import { useSidebarDrawer } from "@/components/layout/AppShell";
import { useDevice } from "@/hooks/useDevice";
import { VersionBadge } from "@/components/sidebar/VersionBadge";
import type {
  SessionOrganizationPatch,
  SessionSummary,
} from "@/lib/session-api";
import type { MasteryTopicLabel } from "@/lib/learning-api";
import type { ReadingCollectionLabel } from "@/lib/reading-workspace-api";
import { useSidebarResize } from "@/hooks/useSidebarResize";
import { SidebarHome, SidebarNav } from "@/components/sidebar/SidebarNav";
import { SECONDARY_NAV, isNavActive } from "@/components/sidebar/nav-entries";
import Tooltip from "@/shared/ui/Tooltip";
import {
  mergeManualOrder,
  readSessionOrder,
  writeSessionOrder,
} from "@/lib/sidebar-layout";

// Session data arrives after mount; defer its organization UI with it so
// every workspace route does not download it as part of the initial shell.
const OrganizedSessionList = dynamic(
  () => import("@/components/sessions/OrganizedSessionList"),
  {
    ssr: false,
    loading: () => (
      <div aria-busy="true" className="space-y-1.5 px-2 py-1">
        {[1, 2, 3].map((i) => (
          <div
            key={i}
            className="h-4 w-3/4 animate-pulse rounded bg-muted/40"
          />
        ))}
      </div>
    ),
  },
);

export interface SidebarShellProps {
  sessions?: SessionSummary[];
  activeSessionId?: string | null;
  /** Conversations the caller is streaming right now; they sort to the top. */
  liveSessionIds?: ReadonlySet<string>;
  loadingSessions?: boolean;
  showSessions?: boolean;
  /** Clicking the Chat nav item resets to a fresh session via this handler. */
  onNewChat?: () => void;
  onSelectSession?: (sessionId: string) => void | Promise<void>;
  onRenameSession?: (sessionId: string, title: string) => void | Promise<void>;
  onDeleteSession?: (sessionId: string) => void | Promise<void>;
  /** Topic labels for grouping mastery study conversations under their path. */
  masteryTopics?: MasteryTopicLabel[];
  /** Collection labels for grouping reading conversations under their shelf. */
  readingCollections?: ReadingCollectionLabel[];
  onOrganizeSession?: (
    sessionId: string,
    patch: SessionOrganizationPatch,
  ) => void | Promise<void>;
  /**
   * Footer content rendered below the nav. Pass a render function to receive
   * the current ``collapsed`` state so footer items (e.g. Admin / Sign out) can
   * switch to their icon-only variant when the rail is collapsed.
   */
  footerSlot?: ReactNode | ((collapsed: boolean) => ReactNode);
}

export function ClassicSidebarShell({
  sessions = [],
  activeSessionId = null,
  liveSessionIds,
  loadingSessions = false,
  showSessions = false,
  onNewChat,
  onSelectSession,
  onRenameSession,
  onDeleteSession,
  masteryTopics = [],
  readingCollections = [],
  onOrganizeSession,
  footerSlot,
}: SidebarShellProps) {
  const pathname = usePathname();
  const router = useRouter();
  const { t } = useTranslation();
  const { sidebarCollapsed, setSidebarCollapsed: setCollapsed } = useAppShell();
  const { isMobile } = useDevice();
  const drawer = useSidebarDrawer();
  const recentsScrollRef = useRef<HTMLDivElement>(null);
  // One load for the whole column: the workspace groups head their own
  // section with it and the row menus offer it as a move destination.
  const { workspaces } = useChatWorkspaces();

  // Inside the mobile drawer the icon-only rail is pointless — the panel is
  // already hidden when you don't want it, so it always opens fully expanded
  // regardless of the persisted desktop preference.
  const collapsed = sidebarCollapsed && !isMobile;
  const resize = useSidebarResize(collapsed || isMobile);

  /** Dismiss the drawer on nav clicks that actually navigate in-place. */
  const closeDrawerOnNav = (event: React.MouseEvent) => {
    if (event.metaKey || event.ctrlKey || event.shiftKey || event.button === 1)
      return;
    drawer?.close();
  };

  const renderedFooter =
    typeof footerSlot === "function" ? footerSlot(collapsed) : footerSlot;
  // The order the learner dragged the history region into — conversation ids
  // and group ids in one list, since the two are peers there. Like the
  // collapse preference above it is per-machine view state, hydrated after
  // mount.
  const [sessionOrder, setSessionOrder] = useState<string[]>([]);
  const sessionOrderRef = useRef<string[]>([]);

  useEffect(() => {
    const stored = readSessionOrder();
    sessionOrderRef.current = stored;
    // eslint-disable-next-line react-hooks/set-state-in-effect
    setSessionOrder(stored);
  }, []);

  // A drag only ever speaks for the entries on screen, so it is merged into
  // the stored order rather than replacing it.
  const handleReorderSessions = useCallback((nextIds: string[]) => {
    const merged = mergeManualOrder(sessionOrderRef.current, nextIds);
    sessionOrderRef.current = merged;
    setSessionOrder(merged);
    writeSessionOrder(merged);
  }, []);

  const handleResetSessionOrder = useCallback(() => {
    sessionOrderRef.current = [];
    setSessionOrder([]);
    writeSessionOrder([]);
  }, []);

  const handleHomeClick = (event: React.MouseEvent) => {
    // Always reset to a fresh session (mirrors the old "New Chat" affordance);
    // let modifier-clicks fall through to default Link behavior so middle-click
    // open-in-new-tab still works.
    if (event.metaKey || event.ctrlKey || event.shiftKey || event.button === 1)
      return;
    event.preventDefault();
    drawer?.close();
    onNewChat?.();
    navigateTask("/chat", router.push);
  };

  // Everything the learner has, minus the archived and minus the tutor threads
  // that render nested under the conversation that spawned them.
  //
  // Keep the complete index here. OrganizedSessionList limits the initial
  // rendering and exposes older conversations through Show more.
  const visibleSessions = sessions.filter(
    (session) =>
      !session.preferences?.archived && !session.preferences?.parent_session_id,
  );

  /* ---- Collapsed state ---- */
  if (collapsed) {
    return (
      <aside className="group/sb relative flex h-dvh w-[60px] shrink-0 flex-col items-center bg-[var(--secondary)] py-3 transition-all duration-200">
        {/* Header: logo + collapse toggle (toggle replaces logo on hover) */}
        <div className="relative mb-2 flex h-9 w-9 items-center justify-center">
          <Link
            href="/"
            prefetch={false}
            aria-label="DeepTutor"
            className="flex items-center justify-center transition-opacity duration-150 group-hover/sb:opacity-0"
          >
            <Image
              src="/brand/color-logo.png"
              alt="DeepTutor"
              width={22}
              height={22}
              className="h-[22px] w-[22px] rounded-md"
            />
          </Link>
          <button
            onClick={() => setCollapsed(false)}
            className="absolute inset-0 flex items-center justify-center rounded-lg text-[var(--muted-foreground)] opacity-0 transition-all duration-150 hover:bg-background/60 hover:text-[var(--foreground)] group-hover/sb:opacity-100"
            aria-label={t("Expand sidebar")}
          >
            <PanelLeftOpen size={16} />
          </button>
        </div>

        <SidebarHome collapsed onHomeClick={handleHomeClick} />
        <div className="min-h-0 w-full flex-1 overflow-y-auto overscroll-contain">
          <SidebarNav
            collapsed
            onHomeClick={handleHomeClick}
            onNavigate={closeDrawerOnNav}
          />
        </div>

        {/* Secondary nav + footer */}
        <div className="flex w-full shrink-0 flex-col items-center gap-1 px-1.5">
          <div className="my-1 h-px w-7 bg-border/40" />
          {SECONDARY_NAV.map((item) => {
            const active = isNavActive(pathname, item.href);
            return (
              <Tooltip key={item.href} label={t(item.label) as string} side="right">
                <Link
                  href={item.href}
                  prefetch={false}
                  aria-label={t(item.label) as string}
                  className={`relative flex h-9 w-9 items-center justify-center rounded-xl transition-all duration-150 ${
                    active
                      ? "bg-[var(--accent)] text-[var(--foreground)] shadow-sm"
                      : "text-foreground/85 hover:bg-background/60 hover:text-[var(--foreground)]"
                  }`}
                >
                  <item.icon size={18} strokeWidth={active ? 2 : 1.6} />
                </Link>
              </Tooltip>
            );
          })}
          {renderedFooter}
          <VersionBadge onNavigate={closeDrawerOnNav} />
        </div>
      </aside>
    );
  }

  /* ---- Expanded state ---- */
  return (
    <aside
      style={{ "--sidebar-width": `${resize.width}px` } as CSSProperties}
      className="relative flex h-dvh w-[var(--sidebar-width)] max-w-[45vw] shrink-0 flex-col bg-[var(--secondary)] max-md:w-[220px] max-md:max-w-[85vw]"
    >
      {/* Header: logo + collapse toggle */}
      <div className="flex h-[52px] shrink-0 items-center justify-between px-4">
        <Link href="/" prefetch={false} className="group flex items-center gap-1.5">
          <Image
            src="/brand/color-logo.png"
            alt="DeepTutor"
            width={22}
            height={22}
            className="h-[22px] w-[22px] transition-transform duration-200 group-hover:scale-105"
          />
          <Image
            src="/brand/color-word.png"
            alt="DeepTutor"
            width={1200}
            height={310}
            priority
            className="h-[22px] w-auto transition-transform duration-200 group-hover:scale-105"
          />
        </Link>
        {/* The rail is a desktop affordance; in the drawer the scrim and the
            top-bar toggle already own "make this go away". */}
        <button
          onClick={() => setCollapsed(true)}
          className="rounded-md p-1 text-[var(--muted-foreground)] transition-colors hover:text-[var(--foreground)] max-md:hidden"
          aria-label={t("Collapse sidebar")}
        >
          <PanelLeftClose size={15} />
        </button>
      </div>

      <SidebarHome onHomeClick={handleHomeClick} />

      {/* Modules and conversations share one scroll region below Home. */}
      <div
        ref={recentsScrollRef}
        className="min-h-0 flex-1 overflow-y-auto overscroll-contain pb-2"
      >
        <SidebarNav
          scrollRef={recentsScrollRef}
          collapsed={false}
          onHomeClick={handleHomeClick}
          onNavigate={closeDrawerOnNav}
        />

        {/* Conversation history follows the module entries in the same scroller. */}
        {showSessions &&
        onSelectSession &&
        onRenameSession &&
        onDeleteSession ? (
          <section className="mt-3 px-2 pt-0.5">
            {!onOrganizeSession && <div className="mb-2 px-2 text-xs text-[var(--muted-foreground)]">{t("Recent")}</div>}
            {loadingSessions ? (
              <SessionList
                sessions={[]}
                activeSessionId={activeSessionId}
                loading
                onSelect={onSelectSession}
                onRename={onRenameSession}
                onDelete={onDeleteSession}
                compact
              />
            ) : onOrganizeSession ? (
              <OrganizedSessionList
                sessions={visibleSessions}
                workspaces={workspaces}
                masteryTopics={masteryTopics}
                readingCollections={readingCollections}
                activeSessionId={activeSessionId}
                liveSessionIds={liveSessionIds}
                manualOrder={sessionOrder}
                onReorder={handleReorderSessions}
                onResetOrder={handleResetSessionOrder}
                scrollRef={recentsScrollRef}
                onSelect={(sessionId) => {
                  drawer?.close();
                  return onSelectSession(sessionId);
                }}
                onRename={onRenameSession}
                onDelete={onDeleteSession}
                onOrganize={onOrganizeSession}
              />
            ) : (
              <SessionList
                sessions={visibleSessions}
                activeSessionId={activeSessionId}
                onSelect={(sessionId) => {
                  drawer?.close();
                  return onSelectSession(sessionId);
                }}
                onRename={onRenameSession}
                onDelete={onDeleteSession}
                compact
              />
            )}
          </section>
        ) : null}
      </div>

      {/* Secondary nav + footer */}
      <div className="shrink-0 border-t border-border/40 px-2 py-2">
        {renderedFooter}
        <div className="flex items-center gap-1">
          {SECONDARY_NAV.map((item) => {
            const active = isNavActive(pathname, item.href);
            return (
              <Link
                key={item.href}
                href={item.href}
                prefetch={false}
                onClick={closeDrawerOnNav}
                className={`flex min-h-8 min-w-0 flex-1 items-center gap-2 rounded-md px-2.5 py-1.5 text-[13px] transition-colors ${
                  active
                    ? "bg-[var(--accent)] font-medium text-[var(--foreground)]"
                    : "text-foreground/85 hover:bg-background/60 hover:text-[var(--foreground)]"
                }`}
              >
                <item.icon size={15} strokeWidth={active ? 1.9 : 1.6} />
                <span>{t(item.label)}</span>
              </Link>
            );
          })}
          <VersionBadge onNavigate={closeDrawerOnNav} />
        </div>
      </div>
      {!isMobile && (
        <div
          role="separator"
          aria-label={t("Resize sidebar")}
          aria-orientation="vertical"
          aria-valuemin={resize.min}
          aria-valuemax={resize.max}
          aria-valuenow={resize.width}
          tabIndex={0}
          {...resize.handleProps}
          className="group/resize absolute inset-y-0 -right-1 z-30 w-2 touch-none cursor-col-resize outline-none max-md:hidden"
        >
          <div
            className={`mx-auto h-full w-0.5 transition-colors group-hover/resize:bg-[var(--ring)] group-focus-visible/resize:bg-[var(--ring)] ${resize.resizing ? "bg-[var(--ring)]" : "bg-transparent"}`}
          />
        </div>
      )}
    </aside>
  );
}