@hydralms/components 0.1.1 → 0.1.3

package/src/sections/ResourceLibrary/ResourceLibrary.tsx

@@ -0,0 +1,218 @@
+import { useMemo, useState } from "react";
+import { Download, Grid, List as ListIcon } from "lucide-react";
+import { LearningObjectIcon } from "../../curriculum";
+import { SearchInput, EmptyState } from "../../common";
+import { Button } from "../../ui/button";
+import { Card, CardContent } from "../../ui/card";
+import { Tabs, TabsList, TabsTrigger } from "../../ui/tabs";
+import { Tooltip, TooltipTrigger, TooltipContent } from "../../ui/tooltip";
+import type { ResourceLibraryProps, Resource } from "./types";
+import { cn } from "../../lib/utils";
+
+function formatBytes(bytes: number): string {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+
+const TYPE_TO_ICON: Record<string, string> = {
+  pdf: "document",
+  document: "document",
+  video: "video",
+  link: "link",
+  image: "document",
+  archive: "document",
+  other: "document",
+};
+
+export function ResourceLibrary({
+  resources,
+  categories,
+  onResourceClick,
+  onDownload,
+  viewMode: initialViewMode = "list",
+  allowViewToggle = true,
+  showSearch = true,
+  emptyMessage = "No resources found",
+  readOnly = false,
+  className,
+  style,
+}: ResourceLibraryProps) {
+  const [searchQuery, setSearchQuery] = useState("");
+  const [activeCategoryUid, setActiveCategoryUid] = useState<string | null>(null);
+  const [viewMode, setViewMode] = useState(initialViewMode);
+
+  const filtered = useMemo(() => {
+    let result = resources;
+    if (activeCategoryUid) {
+      result = result.filter((r) => r.categoryUid === activeCategoryUid);
+    }
+    if (searchQuery.trim()) {
+      const q = searchQuery.toLowerCase();
+      result = result.filter(
+        (r) =>
+          r.name.toLowerCase().includes(q) ||
+          r.description?.toLowerCase().includes(q),
+      );
+    }
+    return result;
+  }, [resources, activeCategoryUid, searchQuery]);
+
+  function renderResource(resource: Resource) {
+    const iconType = TYPE_TO_ICON[resource.type] ?? "document";
+
+    return (
+      <div
+        key={resource.uid}
+        className={cn(
+          "flex items-center gap-3 px-3 py-2",
+          !readOnly && "cursor-pointer hover:bg-muted",
+          readOnly && "opacity-70",
+        )}
+        onClick={() => !readOnly && onResourceClick(resource)}
+      >
+        <div className="min-w-10">
+          <LearningObjectIcon type={iconType} size={20} />
+        </div>
+        <div className="flex-1 min-w-0">
+          <span className="text-sm text-foreground">{resource.name}</span>
+          {(resource.description || resource.fileSize != null) && (
+            <span className="text-sm text-muted-foreground">
+              {[
+                resource.description,
+                resource.fileSize != null && formatBytes(resource.fileSize),
+              ]
+                .filter(Boolean)
+                .join(" \u00b7 ")}
+            </span>
+          )}
+        </div>
+        {onDownload && (
+          <Tooltip>
+            <TooltipTrigger>
+              <Button
+                variant="ghost"
+                size="icon-xs"
+                aria-label="Download"
+                onClick={(e) => {
+                  e.stopPropagation();
+                  onDownload(resource);
+                }}
+              >
+                <Download size={16} />
+              </Button>
+            </TooltipTrigger>
+            <TooltipContent>Download</TooltipContent>
+          </Tooltip>
+        )}
+      </div>
+    );
+  }
+
+  return (
+    <div className={className} style={style}>
+      {/* Toolbar */}
+      <div className="flex gap-2 items-center mb-2">
+        {showSearch && (
+          <div className="flex-1 max-w-80">
+            <SearchInput
+              value={searchQuery}
+              onChange={setSearchQuery}
+              placeholder="Search resources..."
+              size="small"
+            />
+          </div>
+        )}
+        {allowViewToggle && (
+          <div className="flex gap-0.5">
+            <Tooltip>
+              <TooltipTrigger>
+                <Button
+                  variant="ghost"
+                  size="icon-xs"
+                  aria-label="List view"
+                  className={cn(viewMode === "list" && "text-primary")}
+                  onClick={() => setViewMode("list")}
+                >
+                  <ListIcon size={18} />
+                </Button>
+              </TooltipTrigger>
+              <TooltipContent>List view</TooltipContent>
+            </Tooltip>
+            <Tooltip>
+              <TooltipTrigger>
+                <Button
+                  variant="ghost"
+                  size="icon-xs"
+                  aria-label="Grid view"
+                  className={cn(viewMode === "grid" && "text-primary")}
+                  onClick={() => setViewMode("grid")}
+                >
+                  <Grid size={18} />
+                </Button>
+              </TooltipTrigger>
+              <TooltipContent>Grid view</TooltipContent>
+            </Tooltip>
+          </div>
+        )}
+      </div>
+
+      {/* Category tabs */}
+      {categories && categories.length > 0 && (
+        <Tabs
+          value={activeCategoryUid ?? "all"}
+          onValueChange={(v) => setActiveCategoryUid(v === "all" ? null : v)}
+          className="mb-2"
+        >
+          <TabsList>
+            <TabsTrigger value="all">All</TabsTrigger>
+            {categories.map((cat) => (
+              <TabsTrigger key={cat.uid} value={cat.uid}>{cat.label}</TabsTrigger>
+            ))}
+          </TabsList>
+        </Tabs>
+      )}
+
+      {/* Resource list */}
+      {filtered.length === 0 ? (
+        <EmptyState title={emptyMessage} description="Try adjusting your search or filter." />
+      ) : viewMode === "list" ? (
+        <Card>
+          {filtered.map(renderResource)}
+        </Card>
+      ) : (
+        <div className="grid grid-cols-[repeat(auto-fill,minmax(240px,1fr))] gap-2">
+          {filtered.map((resource) => (
+            <Card
+              key={resource.uid}
+              className={cn(
+                "transition-colors",
+                !readOnly && "cursor-pointer hover:border-primary",
+              )}
+              onClick={() => !readOnly && onResourceClick(resource)}
+            >
+              <CardContent className="pt-4 pb-4">
+                <div className="flex gap-1 items-center mb-1">
+                  <LearningObjectIcon type={TYPE_TO_ICON[resource.type] ?? "document"} size={20} />
+                  <span className="font-semibold text-sm text-foreground truncate">
+                    {resource.name}
+                  </span>
+                </div>
+                {resource.description && (
+                  <p className="text-sm text-muted-foreground mb-1 truncate">
+                    {resource.description}
+                  </p>
+                )}
+                {resource.fileSize != null && (
+                  <span className="text-xs text-muted-foreground">
+                    {formatBytes(resource.fileSize)}
+                  </span>
+                )}
+              </CardContent>
+            </Card>
+          ))}
+        </div>
+      )}
+    </div>
+  );
+}

package/src/sections/ResourceLibrary/types.ts

@@ -0,0 +1,57 @@
+
+/**
+ * ResourceLibrary section — a searchable resource catalog.
+ *
+ * Displays downloadable course resources in a grid or list view with
+ * search, category tabs, and view mode toggling.
+ *
+ * @example
+ * <ResourceLibrary
+ *   resources={resources}
+ *   categories={categories}
+ *   onResourceClick={(r) => download(r)}
+ * />
+ */
+export interface ResourceLibraryProps {
+  /** Resources to display */
+  resources: Resource[];
+  /** Optional categories for tab filtering */
+  categories?: { uid: string; label: string }[];
+  /** Called when the user clicks a resource */
+  onResourceClick: (resource: Resource) => void;
+  /** Called when the user downloads a resource */
+  onDownload?: (resource: Resource) => void;
+  /** Layout view mode */
+  viewMode?: "grid" | "list";
+  /** Whether the user can toggle between grid and list */
+  allowViewToggle?: boolean;
+  /** Whether to show search */
+  showSearch?: boolean;
+  /** Empty state message */
+  emptyMessage?: string;
+  /** When true, disables interactions */
+  readOnly?: boolean;
+  /** CSS class name for the root element */
+  className?: string;
+  /** Inline styles for the root element */
+  style?: React.CSSProperties;
+}
+
+export interface Resource {
+  /** Unique identifier */
+  uid: string;
+  /** Resource name */
+  name: string;
+  /** Optional description */
+  description?: string;
+  /** Resource type */
+  type: "pdf" | "document" | "video" | "link" | "image" | "archive" | "other";
+  /** Resource URL */
+  url: string;
+  /** File size in bytes */
+  fileSize?: number;
+  /** Category UID for filtering */
+  categoryUid?: string;
+  /** Date added as ISO string */
+  addedAt?: string;
+}

package/src/sections/ScrollableQuiz/ScrollableQuiz.tsx

@@ -0,0 +1,170 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { QuestionRenderer } from "../../questions";
+import type { SessionAnswer } from "../../questions/types";
+import { Button } from "../../ui/button";
+import { Card, CardContent } from "../../ui/card";
+import { cn } from "../../lib/utils";
+import type { ScrollableQuizProps } from "./types";
+
+export function ScrollableQuiz({
+  questions,
+  initialAnswers = [],
+  onSubmit,
+  onAnswerChange,
+  showNavigator = true,
+  showQuestionNumbers = true,
+  questionGroups,
+  isSubmitting = false,
+  readOnly = false,
+  className,
+  style,
+}: ScrollableQuizProps) {
+  const [sessionAnswers, setSessionAnswers] = useState<SessionAnswer[]>(initialAnswers);
+  const [activeUid, setActiveUid] = useState<string | null>(questions[0]?.uid ?? null);
+  const questionRefs = useRef<Map<string, HTMLElement>>(new Map());
+
+  const answeredCount = useMemo(() => {
+    const answered = new Set(sessionAnswers.map((a) => a.uid));
+    return questions.filter((q) => answered.has(q.uid)).length;
+  }, [questions, sessionAnswers]);
+
+  useEffect(() => {
+    const observer = new IntersectionObserver(
+      (entries) => {
+        for (const entry of entries) {
+          if (entry.isIntersecting) {
+            setActiveUid(entry.target.getAttribute("data-question-uid"));
+          }
+        }
+      },
+      { rootMargin: "-20% 0px -60% 0px" },
+    );
+
+    questionRefs.current.forEach((el) => observer.observe(el));
+    return () => observer.disconnect();
+  }, [questions]);
+
+  const setRef = useCallback((uid: string, el: HTMLElement | null) => {
+    if (el) questionRefs.current.set(uid, el);
+    else questionRefs.current.delete(uid);
+  }, []);
+
+  function handleAnswer(questionUid: string, rawAnswers: { uid: string; content?: string }[]) {
+    const newAnswers: SessionAnswer[] = rawAnswers.map((a) => ({
+      uid: questionUid,
+      answerUid: a.uid,
+      content: a.content,
+    }));
+    setSessionAnswers((prev) => {
+      const filtered = prev.filter((a) => a.uid !== questionUid);
+      const merged = [...filtered, ...newAnswers];
+      onAnswerChange?.(merged);
+      return merged;
+    });
+  }
+
+  function scrollToQuestion(uid: string) {
+    questionRefs.current.get(uid)?.scrollIntoView({ behavior: "smooth", block: "center" });
+  }
+
+  const orderedQuestions = useMemo(() => {
+    if (!questionGroups) return [{ label: null, questions }];
+    const grouped: { label: string | null; questions: typeof questions }[] = questionGroups.map(
+      (g) => ({
+        label: g.label,
+        questions: g.questionUids
+          .map((uid) => questions.find((q) => q.uid === uid))
+          .filter(Boolean) as typeof questions,
+      }),
+    );
+    const groupedUids = new Set(questionGroups.flatMap((g) => g.questionUids));
+    const ungrouped = questions.filter((q) => !groupedUids.has(q.uid));
+    if (ungrouped.length > 0) grouped.push({ label: null, questions: ungrouped });
+    return grouped;
+  }, [questions, questionGroups]);
+
+  let globalIndex = 0;
+
+  return (
+    <div className={cn("flex gap-3", className)} style={style}>
+      {/* Main content */}
+      <div className="flex-1 min-w-0">
+        {orderedQuestions.map((group, gi) => (
+          <div key={gi}>
+            {group.label && (
+              <p className={cn("text-lg font-semibold mb-2 text-foreground", gi > 0 && "mt-4")}>
+                {group.label}
+              </p>
+            )}
+            {group.questions.map((q) => {
+              const qIndex = globalIndex++;
+              return (
+                <Card
+                  key={q.uid}
+                  ref={(el: HTMLElement | null) => setRef(q.uid, el)}
+                  data-question-uid={q.uid}
+                  className="mb-2"
+                >
+                  <CardContent className="pt-6">
+                    {showQuestionNumbers && (
+                      <p className="font-semibold text-sm text-muted-foreground mb-1">
+                        Question {qIndex + 1}
+                      </p>
+                    )}
+                    <QuestionRenderer
+                      question={q}
+                      sessionAnswers={sessionAnswers.filter((a) => a.uid === q.uid)}
+                      onAnswer={(answers) => handleAnswer(q.uid, answers)}
+                      readOnly={readOnly}
+                    />
+                  </CardContent>
+                </Card>
+              );
+            })}
+          </div>
+        ))}
+        <div className="mt-3 flex justify-between items-center">
+          <span className="text-sm text-muted-foreground">
+            {answeredCount} of {questions.length} answered
+          </span>
+          <Button
+            onClick={() => onSubmit(sessionAnswers)}
+            disabled={isSubmitting || readOnly}
+          >
+            {isSubmitting ? "Submitting..." : "Submit"}
+          </Button>
+        </div>
+      </div>
+
+      {/* Sidebar navigator */}
+      {showNavigator && (
+        <Card className="hidden md:block w-50 shrink-0 sticky top-4 self-start p-3">
+          <p className="font-semibold text-sm mb-1 text-foreground">Questions</p>
+          <div className="flex flex-wrap gap-1">
+            {questions.map((q, i) => {
+              const isAnswered = sessionAnswers.some((a) => a.uid === q.uid);
+              const isActive = activeUid === q.uid;
+              return (
+                <button
+                  type="button"
+                  key={q.uid}
+                  className={cn(
+                    "inline-flex items-center justify-center text-xs font-medium min-w-9 px-1 py-0.5 rounded-full cursor-pointer border transition-colors",
+                    isActive
+                      ? "bg-primary border-primary text-primary-foreground"
+                      : isAnswered
+                        ? "border-success text-success bg-transparent"
+                        : "border-border text-foreground bg-transparent hover:bg-muted",
+                  )}
+                  onClick={() => scrollToQuestion(q.uid)}
+                >
+                  {i + 1}
+                </button>
+              );
+            })}
+          </div>
+        </Card>
+      )}
+    </div>
+  );
+}

package/src/sections/ScrollableQuiz/types.ts

@@ -0,0 +1,40 @@
+import type { QuestionData, SessionAnswer } from "../../questions/types";
+
+/**
+ * ScrollableQuiz section — all questions on a single scrollable page.
+ *
+ * Renders every question in a vertical list with a sticky sidebar navigator
+ * that highlights the currently visible question. Supports optional question
+ * grouping by section labels.
+ *
+ * @example
+ * <ScrollableQuiz
+ *   questions={questions}
+ *   onSubmit={(answers) => submit(answers)}
+ *   showNavigator
+ * />
+ */
+export interface ScrollableQuizProps {
+  /** Ordered list of questions to present */
+  questions: QuestionData[];
+  /** Pre-populated answers for resuming */
+  initialAnswers?: SessionAnswer[];
+  /** Called when the user clicks Submit with the full answers array */
+  onSubmit: (answers: SessionAnswer[]) => void;
+  /** Called whenever the user changes any answer (useful for auto-save) */
+  onAnswerChange?: (answers: SessionAnswer[]) => void;
+  /** Whether to show the sticky sidebar navigator */
+  showNavigator?: boolean;
+  /** Whether to show question numbers beside each question */
+  showQuestionNumbers?: boolean;
+  /** Optional grouping of questions into labeled sections */
+  questionGroups?: { label: string; questionUids: string[] }[];
+  /** Whether the submit action is in flight */
+  isSubmitting?: boolean;
+  /** When true, all inputs are disabled */
+  readOnly?: boolean;
+  /** CSS class name for the root element */
+  className?: string;
+  /** Inline styles for the root element */
+  style?: React.CSSProperties;
+}

package/src/sections/SurveyForm/SurveyForm.tsx

@@ -0,0 +1,180 @@
+import { useState, useMemo } from "react";
+import { LikertScale, StarRating } from "../../feedback";
+import { Button } from "../../ui/button";
+import { Card, CardContent } from "../../ui/card";
+import { Progress } from "../../ui/progress";
+import { Textarea } from "../../ui/textarea";
+import type { SurveyFormProps, SurveyAnswer } from "./types";
+
+export function SurveyForm({
+  title,
+  description,
+  questions,
+  initialAnswers = [],
+  onSubmit,
+  onAnswerChange,
+  showProgress = true,
+  requireAll = false,
+  submitLabel = "Submit Survey",
+  isSubmitting = false,
+  readOnly = false,
+  className,
+  style,
+}: SurveyFormProps) {
+  const [answers, setAnswers] = useState<SurveyAnswer[]>(initialAnswers);
+
+  const answeredCount = useMemo(() => {
+    const answered = new Set(answers.map((a) => a.questionUid));
+    return questions.filter((q) => answered.has(q.uid)).length;
+  }, [questions, answers]);
+
+  const canSubmit = !requireAll || answeredCount === questions.length;
+
+  function setAnswer(questionUid: string, value: string | number) {
+    setAnswers((prev) => {
+      const filtered = prev.filter((a) => a.questionUid !== questionUid);
+      const next = [...filtered, { questionUid, value }];
+      onAnswerChange?.(next);
+      return next;
+    });
+  }
+
+  function getAnswer(questionUid: string): SurveyAnswer | undefined {
+    return answers.find((a) => a.questionUid === questionUid);
+  }
+
+  return (
+    <div className={className} style={style}>
+      <p className="text-xl font-bold text-foreground mb-2">{title}</p>
+      {description && (
+        <div className="mb-2 text-muted-foreground text-sm">
+          {typeof description === "string" ? (
+            <span>{description}</span>
+          ) : (
+            description
+          )}
+        </div>
+      )}
+      {showProgress && (
+        <div className="mb-3">
+          <Progress value={(answeredCount / questions.length) * 100} />
+          <span className="block text-xs text-muted-foreground mt-0.5">
+            {answeredCount} of {questions.length} answered
+          </span>
+        </div>
+      )}
+
+      {questions.map((q, index) => {
+        const answer = getAnswer(q.uid);
+        return (
+          <Card key={q.uid} className="mb-2"><CardContent className="pt-6">
+            <p className="font-medium text-foreground mb-2">
+              {index + 1}. {q.content}
+              {q.required && (
+                <span className="text-destructive ml-0.5">*</span>
+              )}
+            </p>
+
+            {q.type === "likert" && (
+              <LikertScale
+                value={answer ? Number(answer.value) : null}
+                onChange={(v) => setAnswer(q.uid, v)}
+                points={q.scalePoints}
+                lowLabel={q.scaleLabels?.low}
+                highLabel={q.scaleLabels?.high}
+                readOnly={readOnly}
+              />
+            )}
+
+            {q.type === "rating" && (
+              <StarRating
+                value={answer ? Number(answer.value) : 0}
+                onChange={(v) => setAnswer(q.uid, v)}
+                readOnly={readOnly}
+              />
+            )}
+
+            {q.type === "open_text" && (
+              <Textarea
+                placeholder="Type your response..."
+                value={(answer?.value as string) ?? ""}
+                onChange={(e) => setAnswer(q.uid, e.target.value)}
+                disabled={readOnly}
+                className="min-h-24"
+              />
+            )}
+
+            {q.type === "choice" && q.answers && (
+              <div className="flex flex-col gap-2">
+                {q.answers.map((opt) => (
+                  <label key={opt.uid} className="flex items-center gap-2 cursor-pointer py-1 text-sm text-foreground has-[input:disabled]:cursor-default has-[input:disabled]:opacity-60">
+                    <input
+                      type="radio"
+                      className="accent-primary m-0 shrink-0"
+                      name={`survey-q-${q.uid}`}
+                      value={opt.uid}
+                      checked={(answer?.value as string) === opt.uid}
+                      onChange={() => setAnswer(q.uid, opt.uid)}
+                      disabled={readOnly}
+                    />
+                    <span>{opt.content}</span>
+                  </label>
+                ))}
+              </div>
+            )}
+
+            {q.type === "multiple_choice" && q.answers && (
+              <div className="flex flex-col gap-2">
+                {q.answers.map((opt) => {
+                  const selected = answers
+                    .filter((a) => a.questionUid === q.uid)
+                    .map((a) => String(a.value));
+                  return (
+                    <label key={opt.uid} className="flex items-center gap-2 cursor-pointer py-1 text-sm text-foreground has-[input:disabled]:cursor-default has-[input:disabled]:opacity-60">
+                      <input
+                        type="checkbox"
+                        className="accent-primary m-0 shrink-0"
+                        checked={selected.includes(opt.uid)}
+                        disabled={readOnly}
+                        onChange={(e) => {
+                          const prev = answers.filter((a) => a.questionUid === q.uid);
+                          let next: SurveyAnswer[];
+                          if (e.target.checked) {
+                            next = [...prev, { questionUid: q.uid, value: opt.uid }];
+                          } else {
+                            next = prev.filter((a) => String(a.value) !== opt.uid);
+                          }
+                          setAnswers((all) => [
+                            ...all.filter((a) => a.questionUid !== q.uid),
+                            ...next,
+                          ]);
+                          onAnswerChange?.([
+                            ...answers.filter((a) => a.questionUid !== q.uid),
+                            ...next,
+                          ]);
+                        }}
+                      />
+                      <span>{opt.content}</span>
+                    </label>
+                  );
+                })}
+              </div>
+            )}
+          </CardContent></Card>
+        );
+      })}
+
+      <div className="flex justify-between items-center mt-3">
+        <span className="text-sm text-muted-foreground">
+          {answeredCount} of {questions.length} answered
+        </span>
+        <Button
+          onClick={() => onSubmit(answers)}
+          disabled={!canSubmit || isSubmitting || readOnly}
+        >
+          {isSubmitting ? "Submitting..." : submitLabel}
+        </Button>
+      </div>
+    </div>
+  );
+}