@hydralms/components 0.2.0 → 0.3.1

package/dist/license/HydraContext.d.ts

@@ -0,0 +1,16 @@
+import { ReactNode } from 'react';
+export type HydraPlan = 'pro' | 'free' | 'validating' | 'invalid';
+export interface HydraLicenseContextValue {
+    plan: HydraPlan;
+    isPro: boolean;
+}
+export declare const HydraLicenseContext: import('react').Context<HydraLicenseContextValue>;
+export interface HydraLicenseProviderProps {
+    licenseKey?: string;
+    validateUrl?: string;
+    children: ReactNode;
+}
+/** Provides license state to all HydraLMS components.
+ * When `validateUrl` is omitted or empty, all features are unlocked (dev mode).
+ */
+export declare function HydraLicenseProvider({ licenseKey, validateUrl, children }: HydraLicenseProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist/license/ProBadge.d.ts

@@ -0,0 +1,6 @@
+import { ReactNode } from 'react';
+/** Wraps children with a subtle "HydraLMS Pro" upgrade badge when the module requires a pro license. */
+export declare function ProBadge({ children, feature }: {
+    children: ReactNode;
+    feature?: string;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/license/index.d.ts

@@ -0,0 +1,7 @@
+export { HydraLicenseProvider, HydraLicenseContext } from './HydraContext';
+export type { HydraPlan, HydraLicenseContextValue, HydraLicenseProviderProps } from './HydraContext';
+export { useHydraLicense } from './useHydraLicense';
+export { isProModule, PRO_MODULES, isProSection, PRO_SECTIONS } from './tiers';
+export type { ProModuleName, ProSectionName } from './tiers';
+export { ProBadge } from './ProBadge';
+export { withProGate } from './withProGate';

package/dist/license/tiers.d.ts

@@ -0,0 +1,6 @@
+export declare const PRO_MODULES: Set<"QuizModule" | "FlashcardLab" | "CoursePlayer" | "ExamModule" | "SurveyModule" | "GradeCenterModule" | "AssignmentModule" | "CertificateModule" | "DiscussionModule" | "StudentDashboardModule" | "CourseCatalogModule" | "StudentProfileModule">;
+export type ProModuleName = typeof PRO_MODULES extends Set<infer T> ? T : never;
+export declare function isProModule(name: string): boolean;
+export declare const PRO_SECTIONS: Set<"ContentAuthoringStudio">;
+export type ProSectionName = typeof PRO_SECTIONS extends Set<infer T> ? T : never;
+export declare function isProSection(name: string): boolean;

package/dist/license/useHydraLicense.d.ts

@@ -0,0 +1,6 @@
+import { HydraLicenseContextValue } from './HydraContext';
+/** Returns the current HydraLMS license status. Pro modules render with a
+ * watermark badge when `isPro` is false. Wrap your app in `<HydraProvider>`
+ * with a valid license key to unlock all features.
+ */
+export declare function useHydraLicense(): HydraLicenseContextValue;

package/dist/license/validate.d.ts

@@ -0,0 +1,13 @@
+export type KeyResult = 'valid-pro' | 'valid-free' | 'invalid' | 'no-key' | 'skip';
+export interface ValidationResponse {
+    valid: boolean;
+    plan: 'pro' | 'enterprise' | null;
+}
+/**
+ * Validate a license key against the validation endpoint.
+ * @param rawKey - The license key string, or null if not provided.
+ * @param validateUrl - The validation endpoint URL. Empty string skips validation (dev mode).
+ */
+export declare function validateKey(rawKey: string | null, validateUrl: string): Promise<KeyResult>;
+/** Whether a watermark should be shown for the given key result. */
+export declare function shouldShowWatermark(result: KeyResult): boolean;

package/dist/license/withProGate.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+/** Higher-order component that wraps a pro-tier module with ProBadge when unlicensed. */
+export declare function withProGate<P extends object>(Component: React.ComponentType<P>, moduleName: string): {
+    (props: P): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/modules/AssignmentModule/AssignmentModule.d.ts

@@ -1,8 +1,5 @@
 import { AssignmentModuleProps } from './types';
-/**
- * AssignmentModule — a complete assignment experience with instructions,
- * submission work area, and confirmation/grade review.
- *
- * Steps: Instructions → Work (AssignmentSubmission) → Confirmation.
- */
-export declare function AssignmentModule({ title, instructions, dueDate, maxScore, submissionTypes, fileConstraints, rubric, existingSubmission, status, grade, onSubmit, onSaveDraft, className, style, }: AssignmentModuleProps): import("react/jsx-runtime").JSX.Element;
+export declare const AssignmentModule: {
+    (props: AssignmentModuleProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/modules/AssignmentModule/types.d.ts

@@ -50,8 +50,12 @@ export interface AssignmentModuleProps {
     };
     /** Called on final submission */
     onSubmit?: (submission: SubmissionData) => void;
+    /** Called when the assignment is submitted or draft-saved, with the full result */
+    onComplete?: (result: AssignmentModuleResult) => void;
     /** Called on draft save */
     onSaveDraft?: (submission: SubmissionData) => void;
+    /** When true, disables interactions for preview/demo mode. @default false */
+    readOnly?: boolean;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */
@@ -61,5 +65,5 @@ export interface AssignmentModuleResult {
     /** The submitted data */
     submission: SubmissionData;
     /** Status after submission */
-    status: string;
+    status: "not_started" | "draft" | "submitted" | "late" | "graded" | "resubmit";
 }

package/dist/modules/CertificateModule/CertificateModule.d.ts

@@ -1,9 +1,5 @@
 import { CertificateModuleProps } from './types';
-/**
- * CertificateModule — a certificate-earning flow with requirements tracking
- * and certificate display.
- *
- * Steps: Requirements (checklist + progress) → Certificate (CertificateViewer).
- * The certificate step is only accessible when all requirements are completed.
- */
-export declare function CertificateModule({ courseTitle, recipientName, organizationName, organizationLogo, signatory, completionDate, certificateVariant, requirements, overallProgress, onRequirementClick, onCertificateEarned, className, style, }: CertificateModuleProps): import("react/jsx-runtime").JSX.Element;
+export declare const CertificateModule: {
+    (props: CertificateModuleProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/modules/CertificateModule/types.d.ts

@@ -36,12 +36,14 @@ export interface CertificateModuleProps {
     certificateVariant?: CertificateVariant;
     /** Completion requirements */
     requirements: Requirement[];
-    /** Overall course progress (0-100) */
-    overallProgress: number;
+    /** Overall course progress (0-100). When omitted, derived from requirements completion. */
+    overallProgress?: number;
     /** Called when a requirement item is clicked */
     onRequirementClick?: (uid: string) => void;
-    /** Called when the certificate screen is first displayed */
-    onCertificateEarned?: () => void;
+    /** Called when the certificate is first displayed. @default undefined */
+    onComplete?: () => void;
+    /** When true, disables interactions for preview/demo mode. @default false */
+    readOnly?: boolean;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/modules/CourseCatalogModule/CourseCatalogModule.d.ts

@@ -0,0 +1,5 @@
+import { CourseCatalogModuleProps } from './types';
+export declare const CourseCatalogModule: {
+    (props: CourseCatalogModuleProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/modules/CourseCatalogModule/types.d.ts

@@ -0,0 +1,43 @@
+import { CourseInfo } from '../../sections/CourseCatalog/types';
+import { EnrollmentCourse, Prerequisite } from '../../sections/EnrollmentWizard/types';
+/**
+ * CourseCatalogModule — a browse-and-enroll course catalog module.
+ *
+ * Master-detail layout: CourseCatalog (browse) ↔ EnrollmentWizard (enroll).
+ * Clicking a course drills into the enrollment flow; a back button returns to browsing.
+ *
+ * @example
+ * <CourseCatalogModule
+ *   title="Course Catalog"
+ *   courses={courses}
+ *   categories={categories}
+ *   enrollmentData={enrollmentData}
+ *   onEnroll={(courseUid) => handleEnroll(courseUid)}
+ * />
+ */
+export interface CourseCatalogModuleProps {
+    /** Catalog title */
+    title?: string;
+    /** Courses to display */
+    courses: CourseInfo[];
+    /** Optional categories for filtering */
+    categories?: {
+        uid: string;
+        label: string;
+    }[];
+    /** Enrollment data keyed by course UID — provides course details and prerequisites for the enrollment wizard */
+    enrollmentData?: Record<string, {
+        course: EnrollmentCourse;
+        prerequisites?: Prerequisite[];
+    }>;
+    /** Called when a user confirms enrollment */
+    onEnroll: (courseUid: string) => void;
+    /** Called when a course is opened (for lazy-loading enrollment data) */
+    onCourseOpen?: (courseUid: string) => void;
+    /** When true, disables interactions for preview/demo mode. @default false */
+    readOnly?: boolean;
+    /** CSS class name for the root element */
+    className?: string;
+    /** Inline styles for the root element */
+    style?: React.CSSProperties;
+}

package/dist/modules/CoursePlayer/CoursePlayer.d.ts

@@ -1,2 +1,5 @@
 import { CoursePlayerProps } from './types';
-export declare function CoursePlayer({ courseTitle, curriculum, progress, items, initialItemUid, onItemComplete, onItemChange, sidebarCollapsed, readOnly, className, style, }: CoursePlayerProps): import("react/jsx-runtime").JSX.Element;
+export declare const CoursePlayer: {
+    (props: CoursePlayerProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/modules/DiscussionModule/DiscussionModule.d.ts

@@ -1,8 +1,5 @@
 import { DiscussionModuleProps } from './types';
-/**
- * DiscussionModule — a master-detail discussion forum with topic list and thread view.
- *
- * Panel-based layout: ForumBoard (topic listing) ↔ DiscussionThread (thread detail).
- * Clicking a topic drills into the thread; a back button returns to the board.
- */
-export declare function DiscussionModule({ forumTitle, topics, currentUser, threads, onCreateTopic, onReply, onToggleLike, onMarkAnswer, onTopicOpen, readOnly, className, style, }: DiscussionModuleProps): import("react/jsx-runtime").JSX.Element;
+export declare const DiscussionModule: {
+    (props: DiscussionModuleProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/modules/ExamModule/ExamModule.d.ts

@@ -1,8 +1,5 @@
 import { ExamModuleProps } from './types';
-/**
- * ExamModule — a complete formal exam experience.
- *
- * Steps: Intro (rules/instructions) → Exam (timed ExamSession) → Results (score + review).
- * Manages an external timer that feeds elapsed time to ExamSession.
- */
-export declare function ExamModule({ title, description, instructions, questions, timeLimitSeconds, passingScore, allowBackNavigation, autoSubmitOnTimeout, timeWarningThreshold, allowRetake, showReview, onComplete, className, style, }: ExamModuleProps): import("react/jsx-runtime").JSX.Element;
+export declare const ExamModule: {
+    (props: ExamModuleProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/modules/ExamModule/types.d.ts

@@ -1,5 +1,6 @@
 import { ReactNode } from 'react';
-import { QuestionData, SessionAnswer } from '../../questions/types';
+import { QuestionData } from '../../questions/types';
+import { AssessmentResult } from '../_shared/types';
 /**
  * ExamModule — a formal timed exam experience with intro, exam, and results steps.
  *
@@ -41,24 +42,14 @@ export interface ExamModuleProps {
     showReview?: boolean;
     /** Called when the exam is completed (submitted) */
     onComplete?: (result: ExamModuleResult) => void;
+    /** When true, disables interactions for preview/demo mode. @default false */
+    readOnly?: boolean;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */
     style?: React.CSSProperties;
 }
-export interface ExamModuleResult {
-    /** The user's submitted answers */
-    answers: SessionAnswer[];
-    /** Number of correct answers */
-    correct: number;
-    /** Total number of gradable questions */
-    total: number;
-    /** Score as a percentage (0-100) */
-    percentage: number;
-    /** Whether the user passed (only meaningful when passingScore is set) */
-    passed: boolean;
-    /** Total time taken in seconds */
-    timeElapsedSeconds: number;
+export interface ExamModuleResult extends AssessmentResult {
     /** Whether the submission was triggered by timeout */
     wasAutoSubmitted: boolean;
 }

package/dist/modules/FlashcardLab/FlashcardLab.d.ts

@@ -1,2 +1,5 @@
 import { FlashcardLabProps } from './types';
-export declare function FlashcardLab({ decks, showShuffleToggle, defaultShuffled, allowMultiSelect, onComplete, className, style, }: FlashcardLabProps): import("react/jsx-runtime").JSX.Element;
+export declare const FlashcardLab: {
+    (props: FlashcardLabProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/modules/FlashcardLab/types.d.ts

@@ -26,6 +26,8 @@ export interface FlashcardLabProps {
     allowMultiSelect?: boolean;
     /** Called when the user completes a study session */
     onComplete?: (result: FlashcardLabResult) => void;
+    /** When true, disables interactions for preview/demo mode. @default false */
+    readOnly?: boolean;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/modules/GradeCenterModule/GradeCenterModule.d.ts

@@ -1,9 +1,5 @@
 import { GradeCenterModuleProps } from './types';
-/**
- * GradeCenterModule — a tabbed grade center with gradebook, progress dashboard,
- * and drill-down into individual assessment reviews.
- *
- * Uses a panel-based layout (like CoursePlayer) with tabs for Grades and Progress,
- * and a slide-in detail panel for reviewing individual assessments.
- */
-export declare function GradeCenterModule({ courseTitle, gradeItems, categories, overallGrade, showWeights, progressData, reviewData, className, style, }: GradeCenterModuleProps): import("react/jsx-runtime").JSX.Element;
+export declare const GradeCenterModule: {
+    (props: GradeCenterModuleProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/modules/GradeCenterModule/types.d.ts

@@ -47,6 +47,8 @@ export interface GradeCenterModuleProps {
         sessionAnswers: SessionAnswer[];
         score?: AssessmentScore;
     }>;
+    /** When true, disables interactions for preview/demo mode. @default false */
+    readOnly?: boolean;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/modules/QuizModule/QuizModule.d.ts

@@ -1,2 +1,5 @@
 import { QuizModuleProps } from './types';
-export declare function QuizModule({ title, description, questions, timeLimitSeconds, passingScore, allowRetake, onComplete, showReview, questionMaterials, className, style, }: QuizModuleProps): import("react/jsx-runtime").JSX.Element;
+export declare const QuizModule: {
+    (props: QuizModuleProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/modules/QuizModule/types.d.ts

@@ -1,4 +1,5 @@
-import { QuestionData, QuestionMaterial, SessionAnswer } from '../../questions/types';
+import { QuestionData, QuestionMaterial } from '../../questions/types';
+import { AssessmentResult } from '../_shared/types';
 /**
  * QuizModule — a complete multi-step assessment experience.
  *
@@ -38,22 +39,12 @@ export interface QuizModuleProps {
      * button appears in the question header, opening a drawer with content blocks.
      */
     questionMaterials?: QuestionMaterial[];
+    /** When true, disables interactions for preview/demo mode. @default false */
+    readOnly?: boolean;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */
     style?: React.CSSProperties;
 }
-export interface QuizModuleResult {
-    /** The user's submitted answers */
-    answers: SessionAnswer[];
-    /** Number of correct answers */
-    correct: number;
-    /** Total number of questions */
-    total: number;
-    /** Score as a percentage (0-100) */
-    percentage: number;
-    /** Whether the user passed (only meaningful when passingScore is set) */
-    passed: boolean;
-    /** Total time taken in seconds */
-    timeElapsedSeconds: number;
+export interface QuizModuleResult extends AssessmentResult {
 }

package/dist/modules/StudentDashboardModule/StudentDashboardModule.d.ts

@@ -0,0 +1,5 @@
+import { StudentDashboardModuleProps } from './types';
+export declare const StudentDashboardModule: {
+    (props: StudentDashboardModuleProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/modules/StudentDashboardModule/types.d.ts

@@ -0,0 +1,54 @@
+import { CourseInfo } from '../../sections/CourseCatalog/types';
+import { Announcement } from '../../sections/AnnouncementFeed/types';
+import { ModuleProgress, ActivityItem, Achievement } from '../../sections/ProgressDashboard/types';
+/**
+ * StudentDashboardModule — a multi-tab student home page.
+ *
+ * Combines ProgressDashboard, CourseCatalog, and AnnouncementFeed in a tabbed layout
+ * to provide a complete student landing page experience.
+ *
+ * @example
+ * <StudentDashboardModule
+ *   studentName="Jane"
+ *   overallProgress={72}
+ *   totalTimeSpent={14400}
+ *   modules={[]}
+ *   enrolledCourses={courses}
+ *   onCourseClick={(uid) => navigate(`/courses/${uid}`)}
+ * />
+ */
+export interface StudentDashboardModuleProps {
+    /** Student's display name */
+    studentName: string;
+    /** Overall progress percentage (0-100) */
+    overallProgress: number;
+    /** Total time spent in seconds */
+    totalTimeSpent: number;
+    /** Per-module progress data */
+    modules: ModuleProgress[];
+    /** Recent activity items */
+    recentActivity?: ActivityItem[];
+    /** Streak data */
+    streak?: {
+        currentDays: number;
+        longestDays: number;
+    };
+    /** Achievements */
+    achievements?: Achievement[];
+    /** Enrolled courses for the courses tab */
+    enrolledCourses: CourseInfo[];
+    /** Called when a course is clicked */
+    onCourseClick: (courseUid: string) => void;
+    /** Announcements for the announcements tab */
+    announcements?: Announcement[];
+    /** Called when an announcement is selected */
+    onAnnouncementSelect?: (announcement: Announcement) => void;
+    /** Called when an announcement is marked as read */
+    onMarkRead?: (uid: string) => void;
+    /** When true, disables interactions for preview/demo mode. @default false */
+    readOnly?: boolean;
+    /** CSS class name for the root element */
+    className?: string;
+    /** Inline styles for the root element */
+    style?: React.CSSProperties;
+}

package/dist/modules/StudentProfileModule/StudentProfileModule.d.ts

@@ -0,0 +1,5 @@
+import { StudentProfileModuleProps } from './types';
+export declare const StudentProfileModule: {
+    (props: StudentProfileModuleProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/modules/StudentProfileModule/types.d.ts

@@ -0,0 +1,43 @@
+import { StudentInfo, EnrolledCourse, ProfileAchievement, ProfileCertificate } from '../../sections/StudentProfile/types';
+import { CertificateViewerProps } from '../../sections/CertificateViewer/types';
+/**
+ * StudentProfileModule — a tabbed student profile page with certificate drill-down.
+ *
+ * Combines StudentProfile, course list, achievements, and CertificateViewer
+ * in a tabbed layout with drill-down into individual certificates.
+ *
+ * @example
+ * <StudentProfileModule
+ *   student={{ uid: "s1", displayName: "Jane Doe" }}
+ *   enrolledCourses={courses}
+ *   achievements={badges}
+ *   certificates={certs}
+ *   certificateData={{ cert1: { recipientName: "Jane", courseTitle: "React 101", completionDate: "2025-01-01", organizationName: "Hydra Academy" } }}
+ * />
+ */
+export interface StudentProfileModuleProps {
+    /** Student information */
+    student: StudentInfo;
+    /** Enrolled courses */
+    enrolledCourses?: EnrolledCourse[];
+    /** Earned achievements */
+    achievements?: ProfileAchievement[];
+    /** Earned certificates */
+    certificates?: ProfileCertificate[];
+    /** Custom stat cards */
+    stats?: {
+        label: string;
+        value: string;
+        icon?: React.ReactNode;
+    }[];
+    /** Called when a course is clicked */
+    onCourseClick?: (courseUid: string) => void;
+    /** Certificate data keyed by certificate UID — enables drill-down on click */
+    certificateData?: Record<string, CertificateViewerProps>;
+    /** When true, disables interactions for preview/demo mode. @default false */
+    readOnly?: boolean;
+    /** CSS class name for the root element */
+    className?: string;
+    /** Inline styles for the root element */
+    style?: React.CSSProperties;
+}

package/dist/modules/SurveyModule/SurveyModule.d.ts

@@ -1,7 +1,5 @@
 import { SurveyModuleProps } from './types';
-/**
- * SurveyModule — a complete survey experience with intro, form, and thank-you steps.
- *
- * Steps: Intro → SurveyForm → Thank You with response stats.
- */
-export declare function SurveyModule({ title, description, questions, requireAll, showProgress, thankYouTitle, thankYouMessage, onComplete, allowRestart, className, style, }: SurveyModuleProps): import("react/jsx-runtime").JSX.Element;
+export declare const SurveyModule: {
+    (props: SurveyModuleProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/modules/SurveyModule/types.d.ts

@@ -32,6 +32,8 @@ export interface SurveyModuleProps {
     onComplete?: (result: SurveyModuleResult) => void;
     /** Allow restarting the survey from the thank-you screen. @default false */
     allowRestart?: boolean;
+    /** When true, disables interactions for preview/demo mode. @default false */
+    readOnly?: boolean;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/modules/_shared/assessment-intro.d.ts

@@ -0,0 +1,16 @@
+import { ReactNode } from 'react';
+export interface AssessmentIntroProps {
+    icon: ReactNode;
+    title: string;
+    description?: string;
+    questionCount: number;
+    timeLimitSeconds?: number;
+    passingScore?: number;
+    startLabel: string;
+    onStart: () => void;
+    /** Extra content rendered between the description and metadata badges. */
+    children?: ReactNode;
+    /** When true, disables interactions for preview/demo mode. @default false */
+    readOnly?: boolean;
+}
+export declare function AssessmentIntro({ icon, title, description, questionCount, timeLimitSeconds, passingScore, startLabel, onStart, children, readOnly, }: AssessmentIntroProps): import("react/jsx-runtime").JSX.Element;

package/dist/modules/_shared/assessment-results.d.ts

@@ -0,0 +1,23 @@
+import { ReactNode } from 'react';
+import { QuestionData, SessionAnswer } from '../../questions/types';
+export interface AssessmentResultsProps {
+    title: string;
+    percentage: number;
+    passed: boolean;
+    correct: number;
+    total: number;
+    timeElapsedSeconds: number;
+    answers: SessionAnswer[];
+    questions: QuestionData[];
+    /** Allow retaking the assessment. */
+    allowRetake?: boolean;
+    onRetake?: () => void;
+    retakeLabel?: string;
+    /** Show per-question review below the summary. */
+    showReview?: boolean;
+    /** Extra badges shown next to the pass/fail badge (e.g., "Auto-submitted"). */
+    extraBadges?: ReactNode;
+    /** When true, disables interactions for preview/demo mode. @default false */
+    readOnly?: boolean;
+}
+export declare function AssessmentResults({ title, percentage, passed, correct, total, timeElapsedSeconds, answers, questions, allowRetake, onRetake, retakeLabel, showReview, extraBadges, readOnly, }: AssessmentResultsProps): import("react/jsx-runtime").JSX.Element;

package/dist/modules/_shared/types.d.ts

@@ -0,0 +1,10 @@
+import { SessionAnswer } from '../../questions/types';
+/** Shared result shape for scored assessment modules. */
+export interface AssessmentResult {
+    answers: SessionAnswer[];
+    correct: number;
+    total: number;
+    percentage: number;
+    passed: boolean;
+    timeElapsedSeconds: number;
+}

package/dist/modules/_shared/use-timer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Manages an interval-based timer that runs while `active` is true.
+ * Returns elapsed seconds and a reset function.
+ */
+export declare function useTimer(active: boolean): {
+    timeElapsed: number;
+    getFinalElapsed: () => number;
+    reset: () => void;
+};

package/dist/modules/index.d.ts

@@ -16,3 +16,9 @@ export { CertificateModule } from './CertificateModule/CertificateModule';
 export type { CertificateModuleProps } from './CertificateModule/types';
 export { DiscussionModule } from './DiscussionModule/DiscussionModule';
 export type { DiscussionModuleProps } from './DiscussionModule/types';
+export { StudentDashboardModule } from './StudentDashboardModule/StudentDashboardModule';
+export type { StudentDashboardModuleProps } from './StudentDashboardModule/types';
+export { CourseCatalogModule } from './CourseCatalogModule/CourseCatalogModule';
+export type { CourseCatalogModuleProps } from './CourseCatalogModule/types';
+export { StudentProfileModule } from './StudentProfileModule/StudentProfileModule';
+export type { StudentProfileModuleProps } from './StudentProfileModule/types';