@hydralms/components 0.2.0 → 0.3.1

package/dist/sections/CourseCatalog/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * CourseCatalog section — a searchable, filterable course catalog.
+ *
+ * Displays courses in a grid or list view with search, category tabs,
+ * view mode toggling, and optional pagination.
+ *
+ * @example
+ * <CourseCatalog
+ *   courses={courses}
+ *   categories={categories}
+ *   onCourseClick={(c) => navigate(`/courses/${c.uid}`)}
+ *   onEnroll={(c) => enroll(c.uid)}
+ * />
+ */
+export interface CourseCatalogProps {
+    /** Courses to display */
+    courses: CourseInfo[];
+    /** Optional categories for tab filtering */
+    categories?: {
+        uid: string;
+        label: string;
+    }[];
+    /** Called when the user clicks a course */
+    onCourseClick: (course: CourseInfo) => void;
+    /** Called when the user clicks enroll on a course */
+    onEnroll?: (course: CourseInfo) => 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;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
+    /** Number of items per page (enables pagination when set with onPageChange) */
+    pageSize?: number;
+    /** Current page (1-indexed) */
+    currentPage?: number;
+    /** Total number of items (for server-side pagination) */
+    totalItems?: number;
+    /** Called when the user navigates to a different page */
+    onPageChange?: (page: number) => void;
+    /** CSS class name for the root element */
+    className?: string;
+    /** Inline styles for the root element */
+    style?: React.CSSProperties;
+}
+export interface CourseInfo {
+    /** Unique identifier */
+    uid: string;
+    /** Course title */
+    title: string;
+    /** Course description */
+    description?: string;
+    /** Thumbnail image URL */
+    thumbnailUrl?: string;
+    /** Instructor info */
+    instructor?: {
+        displayName: string;
+        avatarUrl?: string;
+    };
+    /** Category UID for filtering */
+    categoryUid?: string;
+    /** Progress percentage (0-100) */
+    progress?: number;
+    /** Enrollment status */
+    enrollmentStatus?: "enrolled" | "completed" | "available" | "locked";
+    /** Number of enrolled students */
+    studentCount?: number;
+    /** Estimated duration (e.g. "12 hours") */
+    duration?: string;
+}

package/dist/sections/CourseOutline/CourseOutline.d.ts

@@ -1,2 +1,2 @@
 import { CourseOutlineProps } from './types';
-export declare function CourseOutline({ items, progress, courseTitle, activeItemUid, onItemClick, showOverallProgress, showDuration, showIcons, readOnly, className, style, }: CourseOutlineProps): import("react/jsx-runtime").JSX.Element;
+export declare function CourseOutline({ items, progress, courseTitle, activeItemUid, onItemClick, showOverallProgress, showDuration, showIcons, readOnly, isLoading, error, onRetry, className, style, }: CourseOutlineProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/CourseOutline/types.d.ts

@@ -42,6 +42,12 @@ export interface CourseOutlineProps {
     showIcons?: boolean;
     /** When true, disables all click interactions */
     readOnly?: boolean;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/DiscussionThread/DiscussionThread.d.ts

@@ -1,2 +1,2 @@
 import { DiscussionThreadProps } from './types';
-export declare function DiscussionThread({ title, rootPost, replies, currentUser, onReply, onToggleLike, onMarkAnswer, maxDepth, allowReplies, sortOrder, readOnly, className, style, }: DiscussionThreadProps): import("react/jsx-runtime").JSX.Element;
+export declare function DiscussionThread({ title, rootPost, replies, currentUser, onReply, onToggleLike, onMarkAnswer, maxDepth, allowReplies, sortOrder, readOnly, isLoading, error, onRetry, className, style, }: DiscussionThreadProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/DiscussionThread/types.d.ts

@@ -37,6 +37,12 @@ export interface DiscussionThreadProps {
     sortOrder?: "newest" | "oldest" | "most_liked";
     /** When true, disables interactions */
     readOnly?: boolean;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/EnrollmentWizard/EnrollmentWizard.d.ts

@@ -0,0 +1,2 @@
+import { EnrollmentWizardProps } from './types';
+export declare function EnrollmentWizard({ course, prerequisites, onEnroll, onCancel, enrollLabel, isEnrolling, isLoading, error, onRetry, className, style, }: EnrollmentWizardProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/EnrollmentWizard/types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * EnrollmentWizard section — a multi-step course enrollment flow.
+ *
+ * Guides users through course details, prerequisite checks, and enrollment
+ * confirmation with visual step progress.
+ *
+ * @example
+ * <EnrollmentWizard
+ *   course={{ uid: "c1", title: "React 101", description: "Learn React" }}
+ *   prerequisites={[{ uid: "p1", label: "JavaScript Basics", isMet: true }]}
+ *   onEnroll={(courseUid) => enroll(courseUid)}
+ * />
+ */
+export interface EnrollmentWizardProps {
+    /** Course information to display */
+    course: EnrollmentCourse;
+    /** Prerequisites for enrollment */
+    prerequisites?: Prerequisite[];
+    /** Called when the user confirms enrollment */
+    onEnroll: (courseUid: string) => void;
+    /** Called when the user cancels the wizard */
+    onCancel?: () => void;
+    /** Label for the enroll button */
+    enrollLabel?: string;
+    /** Whether enrollment is in progress (shows spinner) */
+    isEnrolling?: boolean;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
+    /** CSS class name for the root element */
+    className?: string;
+    /** Inline styles for the root element */
+    style?: React.CSSProperties;
+}
+export interface EnrollmentCourse {
+    /** Course UID */
+    uid: string;
+    /** Course title */
+    title: string;
+    /** Course description */
+    description?: string;
+    /** Thumbnail image URL */
+    thumbnailUrl?: string;
+    /** Instructor info */
+    instructor?: {
+        displayName: string;
+        avatarUrl?: string;
+    };
+    /** Estimated duration */
+    duration?: string;
+    /** Syllabus bullet points */
+    syllabus?: string[];
+}
+export interface Prerequisite {
+    /** Unique identifier */
+    uid: string;
+    /** Prerequisite label */
+    label: string;
+    /** Whether this prerequisite has been met */
+    isMet: boolean;
+    /** Optional description */
+    description?: string;
+}

package/dist/sections/ExamSession/ExamSession.d.ts

@@ -1,2 +1,2 @@
 import { ExamSessionProps } from './types';
-export declare function ExamSession({ questions, initialAnswers, onSubmit, onAnswerChange, timeLimitSeconds, timeElapsedSeconds, autoSubmitOnTimeout, timeWarningThreshold, allowBackNavigation, confirmBeforeSubmit, examTitle, instructions, questionMaterials, isSubmitting, readOnly, className, style, }: ExamSessionProps): import("react/jsx-runtime").JSX.Element;
+export declare function ExamSession({ questions, initialAnswers, onSubmit, onAnswerChange, timeLimitSeconds, timeElapsedSeconds, autoSubmitOnTimeout, timeWarningThreshold, allowBackNavigation, confirmBeforeSubmit, examTitle, instructions, questionMaterials, isSubmitting, readOnly, isLoading, error, onRetry, className, style, }: ExamSessionProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/ExamSession/types.d.ts

@@ -50,6 +50,12 @@ export interface ExamSessionProps {
     questionMaterials?: QuestionMaterial[];
     /** When true, all inputs are disabled */
     readOnly?: boolean;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/FlashcardStudySession/FlashcardStudySession.d.ts

@@ -1,2 +1,2 @@
 import { FlashcardStudySessionProps } from './types';
-export declare function FlashcardStudySession({ cards, title, description, shuffled, onComplete, readOnly, className, style, }: FlashcardStudySessionProps): import("react/jsx-runtime").JSX.Element;
+export declare function FlashcardStudySession({ cards, title, description, shuffled, onComplete, readOnly, isLoading, error, onRetry, className, style, }: FlashcardStudySessionProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/FlashcardStudySession/types.d.ts

@@ -27,6 +27,12 @@ export interface FlashcardStudySessionProps {
     onComplete?: (stats: FlashcardSessionStats) => void;
     /** When true, disables card flipping */
     readOnly?: boolean;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/ForumBoard/ForumBoard.d.ts

@@ -5,4 +5,4 @@ import { ForumBoardProps } from './types';
  * Displays a searchable, sortable list of discussion topics with author info,
  * reply/like counts, timestamps, and new topic creation.
  */
-export declare function ForumBoard({ title, topics, onTopicClick, onCreateTopic, sortOrder, onSortChange, searchQuery, onSearchChange, readOnly, className, style, }: ForumBoardProps): import("react/jsx-runtime").JSX.Element;
+export declare function ForumBoard({ title, topics, onTopicClick, onCreateTopic, sortOrder, onSortChange, searchQuery, onSearchChange, readOnly, isLoading, error, onRetry, pageSize, currentPage, totalItems, onPageChange, className, style, }: ForumBoardProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/ForumBoard/types.d.ts

@@ -35,6 +35,20 @@ export interface ForumBoardProps {
     onSearchChange?: (query: string) => void;
     /** When true, disables create and interactions */
     readOnly?: boolean;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
+    /** Number of items per page (enables pagination when set with onPageChange) */
+    pageSize?: number;
+    /** Current page (1-indexed) */
+    currentPage?: number;
+    /** Total number of items (for server-side pagination) */
+    totalItems?: number;
+    /** Called when the user navigates to a different page */
+    onPageChange?: (page: number) => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/GradebookTable/GradebookTable.d.ts

@@ -1,2 +1,2 @@
 import { GradebookTableProps } from './types';
-export declare function GradebookTable({ items, categories, overallGrade, showWeights, showCategoryTotals, onItemClick, readOnly, className, style, }: GradebookTableProps): import("react/jsx-runtime").JSX.Element;
+export declare function GradebookTable({ items, categories, overallGrade, showWeights, showCategoryTotals, onItemClick, readOnly, isLoading, error, onRetry, pageSize, currentPage, totalItems, onPageChange, className, style, }: GradebookTableProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/GradebookTable/types.d.ts

@@ -26,6 +26,20 @@ export interface GradebookTableProps {
     onItemClick?: (item: GradeItem) => void;
     /** When true, disables interactions */
     readOnly?: boolean;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
+    /** Number of items per page (enables pagination when set with onPageChange) */
+    pageSize?: number;
+    /** Current page (1-indexed) */
+    currentPage?: number;
+    /** Total number of items (for server-side pagination) */
+    totalItems?: number;
+    /** Called when the user navigates to a different page */
+    onPageChange?: (page: number) => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/LecturePlayer/LecturePlayer.d.ts

@@ -1,2 +1,2 @@
 import { LecturePlayerProps } from './types';
-export declare function LecturePlayer({ video, notes, layout, notesPanelWidth, notesPanelHeight, className, style, }: LecturePlayerProps): import("react/jsx-runtime").JSX.Element;
+export declare function LecturePlayer({ video, notes, layout, notesPanelWidth, notesPanelHeight, isLoading, error, onRetry, onComplete, className, style, }: LecturePlayerProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/LecturePlayer/types.d.ts

@@ -40,6 +40,14 @@ export interface LecturePlayerProps {
      * @default "240px"
      */
     notesPanelHeight?: string | number;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
+    /** Called when the video playback ends. */
+    onComplete?: () => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/LessonPage/LessonPage.d.ts

@@ -1,2 +1,2 @@
 import { LessonPageProps } from './types';
-export declare function LessonPage({ title, blocks, isCompleted, onMarkComplete, onNextLesson, nextLessonTitle, estimatedDuration, showDuration, readOnly, className, style, }: LessonPageProps): import("react/jsx-runtime").JSX.Element;
+export declare function LessonPage({ title, blocks, isCompleted, onMarkComplete, onNextLesson, nextLessonTitle, estimatedDuration, showDuration, readOnly, isLoading, error, onRetry, className, style, }: LessonPageProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/LessonPage/types.d.ts

@@ -33,6 +33,12 @@ export interface LessonPageProps {
     showDuration?: boolean;
     /** When true, disables interactive elements */
     readOnly?: boolean;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/PracticeQuiz/PracticeQuiz.d.ts

@@ -1,2 +1,2 @@
 import { PracticeQuizProps } from './types';
-export declare function PracticeQuiz({ questions: questionsProp, instantFeedback, allowRetry, onComplete, shuffled, readOnly, className, style, }: PracticeQuizProps): import("react/jsx-runtime").JSX.Element;
+export declare function PracticeQuiz({ questions: questionsProp, instantFeedback, allowRetry, onComplete, shuffled, readOnly, isLoading, error, onRetry, className, style, }: PracticeQuizProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/PracticeQuiz/types.d.ts

@@ -27,6 +27,12 @@ export interface PracticeQuizProps {
     shuffled?: boolean;
     /** When true, all inputs are disabled */
     readOnly?: boolean;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/ProgressDashboard/ProgressDashboard.d.ts

@@ -1,2 +1,2 @@
 import { ProgressDashboardProps } from './types';
-export declare function ProgressDashboard({ overallProgress, totalTimeSpent, modules, recentActivity, streak, achievements, recentActivityLimit, onModuleClick, className, style, }: ProgressDashboardProps): import("react/jsx-runtime").JSX.Element;
+export declare function ProgressDashboard({ overallProgress, totalTimeSpent, modules, recentActivity, streak, achievements, recentActivityLimit, onModuleClick, isLoading, error, onRetry, className, style, }: ProgressDashboardProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/ProgressDashboard/types.d.ts

@@ -32,6 +32,12 @@ export interface ProgressDashboardProps {
     recentActivityLimit?: number;
     /** Called when the user clicks a module */
     onModuleClick?: (moduleUid: string) => void;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/QuizSession/QuizSession.d.ts

@@ -1,2 +1,2 @@
 import { QuizSessionProps } from './types';
-export declare function QuizSession({ questions, initialAnswers, onSubmit, onAnswerChange, timeElapsedSeconds, timeLimitSeconds, questionMaterials, isSubmitting, readOnly, className, style, }: QuizSessionProps): import("react/jsx-runtime").JSX.Element;
+export declare function QuizSession({ questions, initialAnswers, onSubmit, onAnswerChange, timeElapsedSeconds, timeLimitSeconds, questionMaterials, isSubmitting, readOnly, isLoading, error, onRetry, className, style, }: QuizSessionProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/QuizSession/types.d.ts

@@ -44,6 +44,12 @@ export interface QuizSessionProps {
     questionMaterials?: QuestionMaterial[];
     /** When true, all inputs are disabled (e.g. after submission) */
     readOnly?: boolean;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/RequirementsChecklist/RequirementsChecklist.d.ts

@@ -5,4 +5,4 @@ import { RequirementsChecklistProps } from './types';
  * Displays a vertical list of requirements with an overall progress bar.
  * Incomplete items can be clicked to navigate to the relevant content.
  */
-export declare function RequirementsChecklist({ title, requirements, onRequirementClick, className, style, }: RequirementsChecklistProps): import("react/jsx-runtime").JSX.Element;
+export declare function RequirementsChecklist({ title, requirements, onRequirementClick, isLoading, error, onRetry, className, style, }: RequirementsChecklistProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/RequirementsChecklist/types.d.ts

@@ -18,6 +18,12 @@ export interface RequirementsChecklistProps {
     requirements: Requirement[];
     /** Called when the user clicks an incomplete requirement */
     onRequirementClick?: (uid: string) => void;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/ResourceLibrary/ResourceLibrary.d.ts

@@ -1,2 +1,2 @@
 import { ResourceLibraryProps } from './types';
-export declare function ResourceLibrary({ resources, categories, onResourceClick, onDownload, viewMode: initialViewMode, allowViewToggle, showSearch, emptyMessage, readOnly, className, style, }: ResourceLibraryProps): import("react/jsx-runtime").JSX.Element;
+export declare function ResourceLibrary({ resources, categories, onResourceClick, onDownload, viewMode: initialViewMode, allowViewToggle, showSearch, emptyMessage, readOnly, isLoading, error, onRetry, pageSize, currentPage, totalItems, onPageChange, className, style, }: ResourceLibraryProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/ResourceLibrary/types.d.ts

@@ -20,7 +20,7 @@ export interface ResourceLibraryProps {
         label: string;
     }[];
     /** Called when the user clicks a resource */
-    onResourceClick: (resource: Resource) => void;
+    onResourceClick?: (resource: Resource) => void;
     /** Called when the user downloads a resource */
     onDownload?: (resource: Resource) => void;
     /** Layout view mode */
@@ -33,6 +33,20 @@ export interface ResourceLibraryProps {
     emptyMessage?: string;
     /** When true, disables interactions */
     readOnly?: boolean;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
+    /** Number of items per page (enables pagination when set with onPageChange) */
+    pageSize?: number;
+    /** Current page (1-indexed) */
+    currentPage?: number;
+    /** Total number of items (for server-side pagination) */
+    totalItems?: number;
+    /** Called when the user navigates to a different page */
+    onPageChange?: (page: number) => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/RubricView/RubricView.d.ts

@@ -6,4 +6,4 @@ import { RubricViewProps } from './types';
  * shows an overall score. Useful inside AssignmentModule for showing grading criteria
  * and results.
  */
-export declare function RubricView({ criteria, selectedLevels, totalScore, maxScore, feedback, className, style, }: RubricViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function RubricView({ criteria, selectedLevels, totalScore, maxScore, feedback, isLoading, error, onRetry, className, style, }: RubricViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/RubricView/types.d.ts

@@ -23,6 +23,12 @@ export interface RubricViewProps {
     maxScore?: number;
     /** Instructor feedback text */
     feedback?: string;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/ScrollableQuiz/ScrollableQuiz.d.ts

@@ -1,2 +1,2 @@
 import { ScrollableQuizProps } from './types';
-export declare function ScrollableQuiz({ questions, initialAnswers, onSubmit, onAnswerChange, showNavigator, showQuestionNumbers, questionGroups, isSubmitting, readOnly, className, style, }: ScrollableQuizProps): import("react/jsx-runtime").JSX.Element;
+export declare function ScrollableQuiz({ questions, initialAnswers, onSubmit, onAnswerChange, showNavigator, showQuestionNumbers, questionGroups, isSubmitting, readOnly, isLoading, error, onRetry, className, style, }: ScrollableQuizProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/ScrollableQuiz/types.d.ts

@@ -35,6 +35,12 @@ export interface ScrollableQuizProps {
     isSubmitting?: boolean;
     /** When true, all inputs are disabled */
     readOnly?: boolean;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/StudentProfile/StudentProfile.d.ts

@@ -0,0 +1,2 @@
+import { StudentProfileProps } from './types';
+export declare function StudentProfile({ student, enrolledCourses, achievements, certificates, stats, showCourses, showAchievements, onCourseClick, onCertificateClick, readOnly, isLoading, error, onRetry, className, style, }: StudentProfileProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/StudentProfile/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * StudentProfile section — a student profile overview.
+ *
+ * Displays student info header, stat cards, enrolled courses list,
+ * achievements grid, and certificates list.
+ *
+ * @example
+ * <StudentProfile
+ *   student={{ uid: "s1", displayName: "Jane Doe", email: "jane@example.com" }}
+ *   enrolledCourses={courses}
+ *   achievements={badges}
+ *   onCourseClick={(uid) => navigate(`/courses/${uid}`)}
+ * />
+ */
+export interface StudentProfileProps {
+    /** Student information */
+    student: StudentInfo;
+    /** Enrolled courses */
+    enrolledCourses?: EnrolledCourse[];
+    /** Earned achievements */
+    achievements?: ProfileAchievement[];
+    /** Earned certificates */
+    certificates?: ProfileCertificate[];
+    /** Custom stat cards to display */
+    stats?: {
+        label: string;
+        value: string;
+        icon?: React.ReactNode;
+    }[];
+    /** When false, hides the Enrolled Courses section. @default true */
+    showCourses?: boolean;
+    /** When false, hides the Achievements section. @default true */
+    showAchievements?: boolean;
+    /** Called when a course is clicked */
+    onCourseClick?: (courseUid: string) => void;
+    /** Called when a certificate is clicked */
+    onCertificateClick?: (certificateUid: string) => void;
+    /** When true, disables interactions */
+    readOnly?: boolean;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
+    /** CSS class name for the root element */
+    className?: string;
+    /** Inline styles for the root element */
+    style?: React.CSSProperties;
+}
+export interface StudentInfo {
+    /** Unique identifier */
+    uid: string;
+    /** Display name */
+    displayName: string;
+    /** Avatar URL */
+    avatarUrl?: string;
+    /** Email address */
+    email?: string;
+    /** Short bio */
+    bio?: string;
+    /** Join date as ISO string */
+    joinedAt?: string;
+    /** Role label */
+    role?: string;
+}
+export interface EnrolledCourse {
+    /** Course UID */
+    uid: string;
+    /** Course title */
+    title: string;
+    /** Progress percentage (0-100) */
+    progress: number;
+    /** Last accessed as ISO string */
+    lastAccessedAt?: string;
+}
+export interface ProfileAchievement {
+    /** Unique identifier */
+    uid: string;
+    /** Achievement name */
+    name: string;
+    /** Achievement description */
+    description: string;
+    /** Icon URL */
+    iconUrl?: string;
+    /** Date earned as ISO string */
+    earnedAt: string;
+}
+export interface ProfileCertificate {
+    /** Unique identifier */
+    uid: string;
+    /** Course name */
+    courseName: string;
+    /** Date issued as ISO string */
+    issuedAt: string;
+    /** Certificate URL */
+    certificateUrl?: string;
+}

package/dist/sections/SurveyForm/SurveyForm.d.ts

@@ -1,2 +1,2 @@
 import { SurveyFormProps } from './types';
-export declare function SurveyForm({ title, description, questions, initialAnswers, onSubmit, onAnswerChange, showProgress, requireAll, submitLabel, isSubmitting, readOnly, className, style, }: SurveyFormProps): import("react/jsx-runtime").JSX.Element;
+export declare function SurveyForm({ title, description, questions, initialAnswers, onSubmit, onAnswerChange, showProgress, requireAll, submitLabel, isSubmitting, readOnly, isLoading, error, onRetry, className, style, }: SurveyFormProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/SurveyForm/types.d.ts

@@ -37,6 +37,12 @@ export interface SurveyFormProps {
     isSubmitting?: boolean;
     /** When true, all inputs are disabled */
     readOnly?: boolean;
+    /** Render skeleton placeholders instead of content */
+    isLoading?: boolean;
+    /** Error message — renders an error state with optional retry */
+    error?: string | null;
+    /** Called when the user clicks retry in the error state */
+    onRetry?: () => void;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/sections/_shared/merge-answers.d.ts

@@ -0,0 +1,9 @@
+import { SessionAnswer } from '../../questions/types';
+/**
+ * Replaces all existing answers for `questionUid` with `rawAnswers`,
+ * then invokes an optional change callback with the merged array.
+ */
+export declare function mergeSessionAnswers(prev: SessionAnswer[], questionUid: string, rawAnswers: {
+    uid: string;
+    content?: string;
+}[], onChange?: (merged: SessionAnswer[]) => void): SessionAnswer[];

package/dist/sections/_shared/section-shell.d.ts

@@ -0,0 +1,20 @@
+import { ReactNode } from 'react';
+export interface SectionShellProps {
+    isLoading?: boolean;
+    error?: string | null;
+    onRetry?: () => void;
+    /** Skeleton placeholder rendered when `isLoading` is true. */
+    skeleton?: ReactNode;
+    /** Extra class merged into the loading wrapper (default `"space-y-4"`). */
+    loadingClassName?: string;
+    className?: string;
+    style?: React.CSSProperties;
+    children: ReactNode;
+}
+/**
+ * Shared wrapper that handles loading skeleton and error states
+ * so individual sections don't repeat the same early-return blocks.
+ *
+ * When neither loading nor error, renders children directly (no extra wrapper).
+ */
+export declare function SectionShell({ isLoading, error, onRetry, skeleton, loadingClassName, className, style, children, }: SectionShellProps): import("react/jsx-runtime").JSX.Element;