@hydralms/components 0.1.3 → 0.3.0

package/dist/progress/achievement-badge.d.ts

@@ -0,0 +1,6 @@
+import { AchievementBadgeProps } from './types';
+/**
+ * AchievementBadge displays a single achievement or badge earned by a learner,
+ * with support for locked/earned states and metal-tier variants.
+ */
+export declare function AchievementBadge({ title, description, icon, earnedDate, locked, variant, className, style, }: AchievementBadgeProps): import("react/jsx-runtime").JSX.Element;

package/dist/progress/activity-timeline.d.ts

@@ -0,0 +1,6 @@
+import { ActivityTimelineProps } from './types';
+/**
+ * ActivityTimeline renders a vertical timeline of activity events
+ * with icons, timestamps, and an optional "load more" action.
+ */
+export declare function ActivityTimeline({ events, limit, showLoadMore, onLoadMore, emptyMessage, className, style, }: ActivityTimelineProps): import("react/jsx-runtime").JSX.Element;

package/dist/progress/index.d.ts

@@ -1,4 +1,7 @@
 export { ProgressRing } from './progress-ring';
 export { GradeIndicator } from './grade-indicator';
 export { StatCard } from './stat-card';
-export type { ProgressRingProps, GradeIndicatorProps, StatCardProps, } from './types';
+export { AchievementBadge } from './achievement-badge';
+export { StreakBadge } from './streak-badge';
+export { ActivityTimeline } from './activity-timeline';
+export type { ProgressRingProps, GradeIndicatorProps, StatCardProps, AchievementBadgeProps, StreakBadgeProps, ActivityTimelineProps, TimelineEvent, } from './types';

package/dist/progress/stat-card.d.ts

@@ -1,2 +1,2 @@
 import { StatCardProps } from './types';
-export declare function StatCard({ icon, label, value, subtitle, trend, className, style, }: StatCardProps): import("react/jsx-runtime").JSX.Element;
+export declare const StatCard: import('react').NamedExoticComponent<StatCardProps>;

package/dist/progress/streak-badge.d.ts

@@ -0,0 +1,6 @@
+import { StreakBadgeProps } from './types';
+/**
+ * StreakBadge displays a compact learning streak indicator with
+ * a fire icon and day count.
+ */
+export declare function StreakBadge({ currentStreak, longestStreak, unit, showLongest, className, style, }: StreakBadgeProps): import("react/jsx-runtime").JSX.Element;

package/dist/progress/types.d.ts

@@ -57,6 +57,8 @@ export interface StatCardProps {
     icon?: ReactNode;
     /** Stat label */
     label: string;
+    /** Short description displayed below the label */
+    description?: string;
     /** Stat value */
     value: string | number;
     /** Secondary text below the value */
@@ -66,6 +68,103 @@ export interface StatCardProps {
         value: number;
         direction: "up" | "down" | "flat";
     };
+    /** Accent color CSS value for the icon background. Defaults to primary. */
+    accent?: string;
+    /** CSS class name for the root element */
+    className?: string;
+    /** Inline styles for the root element */
+    style?: React.CSSProperties;
+}
+/**
+ * AchievementBadge displays a single achievement or badge earned by a learner,
+ * with support for locked/earned states and metal-tier variants.
+ *
+ * @example
+ * <AchievementBadge
+ *   title="Quiz Master"
+ *   description="Pass 10 quizzes with 90%+ score"
+ *   variant="gold"
+ *   earnedDate="2025-12-01T00:00:00Z"
+ * />
+ */
+export interface AchievementBadgeProps {
+    /** Achievement title */
+    title: string;
+    /** Optional description of how to earn the achievement */
+    description?: string;
+    /** Custom icon to display. Falls back to Trophy icon */
+    icon?: ReactNode;
+    /** ISO date string of when the achievement was earned */
+    earnedDate?: string;
+    /** Whether the achievement is locked (not yet earned). @default false */
+    locked?: boolean;
+    /** Visual tier variant. @default 'default' */
+    variant?: "default" | "gold" | "silver" | "bronze";
+    /** CSS class name for the root element */
+    className?: string;
+    /** Inline styles for the root element */
+    style?: React.CSSProperties;
+}
+/**
+ * StreakBadge displays a compact learning streak indicator with
+ * a fire icon and day count.
+ *
+ * @example
+ * <StreakBadge currentStreak={7} longestStreak={14} showLongest />
+ */
+export interface StreakBadgeProps {
+    /** Current active streak count */
+    currentStreak: number;
+    /** All-time longest streak count */
+    longestStreak?: number;
+    /** Unit label for the streak count. @default "days" */
+    unit?: string;
+    /** Whether to show the longest streak subtitle. @default false */
+    showLongest?: boolean;
+    /** CSS class name for the root element */
+    className?: string;
+    /** Inline styles for the root element */
+    style?: React.CSSProperties;
+}
+/**
+ * A single event in an ActivityTimeline.
+ */
+export interface TimelineEvent {
+    /** Unique identifier */
+    uid: string;
+    /** Event type — used for default icon selection */
+    type: string;
+    /** Event title */
+    title: string;
+    /** Optional longer description */
+    description?: string;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Optional custom icon (overrides type-based default) */
+    icon?: ReactNode;
+}
+/**
+ * ActivityTimeline renders a vertical timeline of activity events
+ * with icons, timestamps, and an optional "load more" action.
+ *
+ * @example
+ * <ActivityTimeline
+ *   events={[
+ *     { uid: "1", type: "lesson_completed", title: "Completed Lesson 3", timestamp: "2025-03-01T12:00:00Z" },
+ *   ]}
+ * />
+ */
+export interface ActivityTimelineProps {
+    /** List of activity events to display */
+    events: TimelineEvent[];
+    /** Maximum number of events to display. When set, truncates the list. */
+    limit?: number;
+    /** Whether to show a "Load more" button at the bottom. @default false */
+    showLoadMore?: boolean;
+    /** Called when the user clicks "Load more" */
+    onLoadMore?: () => void;
+    /** Message displayed when the events list is empty. @default "No recent activity" */
+    emptyMessage?: string;
     /** CSS class name for the root element */
     className?: string;
     /** Inline styles for the root element */

package/dist/provider/HydraProvider.d.ts

@@ -3,7 +3,11 @@ export interface HydraProviderProps {
     children: ReactNode;
     /** Controls color mode. Defaults to `"dark"`. Set to `"light"` to use the light theme. */
     colorMode?: "light" | "dark";
+    /** HydraLMS Pro license key. Omit for free tier. */
+    licenseKey?: string;
+    /** Validation endpoint URL. When empty (default), all features are unlocked (dev mode). */
+    validateUrl?: string;
     className?: string;
     style?: React.CSSProperties;
 }
-export declare function HydraProvider({ children, colorMode, className, style, }: HydraProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function HydraProvider({ children, colorMode, licenseKey, validateUrl, className, style, }: HydraProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist/questions/choice.d.ts

@@ -8,4 +8,4 @@ import { QuestionProps } from './types';
  *   onAnswer={(answers) => handleAnswer(answers)}
  * />
  */
-export declare const Choice: ({ question, sessionAnswers, onAnswer, readOnly, showCorrectAnswers, disabled, }: QuestionProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Choice: import('react').NamedExoticComponent<QuestionProps>;

package/dist/questions/confidence-indicator.d.ts

@@ -0,0 +1,37 @@
+import { ReactNode } from 'react';
+/** A single confidence level option. */
+export interface ConfidenceLevel {
+    /** Value stored in SessionAnswer.confidence */
+    value: string;
+    /** Display label */
+    label: string;
+    /** Optional icon */
+    icon?: ReactNode;
+}
+/**
+ * ConfidenceIndicator lets learners self-report their answer confidence,
+ * supporting metacognitive assessment strategies.
+ *
+ * @example
+ * <ConfidenceIndicator
+ *   value={answer.confidence}
+ *   onChange={(level) => updateConfidence(level)}
+ * />
+ */
+export interface ConfidenceIndicatorProps {
+    /** Currently selected confidence level value */
+    value: string | null;
+    /** Called when the user selects a confidence level */
+    onChange: (level: string) => void;
+    /** Custom confidence levels (defaults to 3 levels) */
+    levels?: ConfidenceLevel[];
+    /** When true, disables interaction */
+    disabled?: boolean;
+    /** When true, shows selected state but disables interaction */
+    readOnly?: boolean;
+    /** CSS class name for the root element */
+    className?: string;
+    /** Inline styles for the root element */
+    style?: React.CSSProperties;
+}
+export declare const ConfidenceIndicator: import('react').NamedExoticComponent<ConfidenceIndicatorProps>;

package/dist/questions/essay.d.ts

@@ -1,6 +1,6 @@
 import { QuestionProps } from './types';
 /**
- * Essay renders a long-form text input question with a multiline textarea.
+ * Essay renders a long-form rich text input question.
  *
  * @example
  * <Essay
@@ -8,4 +8,4 @@ import { QuestionProps } from './types';
  *   onAnswer={(answers) => handleAnswer(answers)}
  * />
  */
-export declare const Essay: ({ question, sessionAnswers, onAnswer, readOnly, disabled, }: QuestionProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Essay: import('react').NamedExoticComponent<QuestionProps>;

package/dist/questions/fill-in-the-blank.d.ts

@@ -8,4 +8,4 @@ import { QuestionProps } from './types';
  *   onAnswer={(answers) => handleAnswer(answers)}
  * />
  */
-export declare const FillInTheBlank: ({ question, sessionAnswers, onAnswer, readOnly, showCorrectAnswers, disabled, }: QuestionProps) => import("react/jsx-runtime").JSX.Element;
+export declare const FillInTheBlank: import('react').NamedExoticComponent<QuestionProps>;

package/dist/questions/hotspot.d.ts

@@ -0,0 +1,21 @@
+import { QuestionProps } from './types';
+/**
+ * Hotspot renders an image with clickable regions for selection.
+ *
+ * Regions are positioned using percentage-based coordinates so they scale with the image.
+ *
+ * @example
+ * <Hotspot
+ *   question={{
+ *     uid: "q1",
+ *     type: "hotspot",
+ *     content: "Click on the heart.",
+ *     hotspotImageUrl: "/anatomy.png",
+ *     hotspotRegions: [
+ *       { uid: "r1", shape: "circle", coords: [50, 40, 8], isCorrect: true, label: "Heart" },
+ *     ],
+ *   }}
+ *   onAnswer={(answers) => handleAnswer(answers)}
+ * />
+ */
+export declare const Hotspot: import('react').NamedExoticComponent<QuestionProps>;

package/dist/questions/index.d.ts

@@ -4,4 +4,14 @@ export { Choice } from './choice';
 export { TrueFalse } from './true-false';
 export { FillInTheBlank } from './fill-in-the-blank';
 export { Essay } from './essay';
-export type { QuestionProps, QuestionData, QuestionTypeEnum, AnswerOption, SessionAnswer, } from './types';
+export { Numeric } from './numeric';
+export { Ordering } from './ordering';
+export { Matching } from './matching';
+export { Hotspot } from './hotspot';
+export { InlineChoice } from './inline-choice';
+export { Scenario } from './scenario';
+export { Spreadsheet } from './spreadsheet';
+export { scoreQuestion, scoreScenarioSubQuestions } from './scoring';
+export { ConfidenceIndicator } from './confidence-indicator';
+export type { ConfidenceIndicatorProps, ConfidenceLevel } from './confidence-indicator';
+export type { QuestionProps, QuestionData, QuestionTypeEnum, QuestionMaterial, AnswerOption, SessionAnswer, MatchingPair, HotspotRegion, InlineBlank, ScenarioScoringMode, SpreadsheetColumn, SpreadsheetCell, SpreadsheetRow, } from './types';

package/dist/questions/inline-choice.d.ts

@@ -0,0 +1,21 @@
+import { QuestionProps } from './types';
+/**
+ * InlineChoice renders a cloze-style passage with embedded dropdown blanks.
+ *
+ * Content should contain `{{blank:uid}}` markers that correspond to entries in `question.inlineBlanks`.
+ *
+ * @example
+ * <InlineChoice
+ *   question={{
+ *     uid: "q1",
+ *     type: "inline_choice",
+ *     content: "The capital of France is {{blank:b1}}.",
+ *     inlineBlanks: [{ uid: "b1", sequence: 0, options: [
+ *       { uid: "o1", content: "Paris", isCorrect: true },
+ *       { uid: "o2", content: "London" },
+ *     ]}],
+ *   }}
+ *   onAnswer={(answers) => handleAnswer(answers)}
+ * />
+ */
+export declare const InlineChoice: import('react').NamedExoticComponent<QuestionProps>;

package/dist/questions/matching.d.ts

@@ -0,0 +1,22 @@
+import { QuestionProps } from './types';
+/**
+ * Matching renders a two-column matching question with dropdown selects and optional drag-and-drop.
+ *
+ * Each item (left column) must be matched to its correct target (right column).
+ * The dropdown is the primary accessible interaction; drag-and-drop is progressive enhancement.
+ *
+ * @example
+ * <Matching
+ *   question={{
+ *     uid: "q1",
+ *     type: "matching",
+ *     content: "Match each country to its capital.",
+ *     matchingPairs: [
+ *       { uid: "p1", item: "France", target: "Paris", sequence: 0 },
+ *       { uid: "p2", item: "Germany", target: "Berlin", sequence: 1 },
+ *     ],
+ *   }}
+ *   onAnswer={(answers) => handleAnswer(answers)}
+ * />
+ */
+export declare const Matching: import('react').NamedExoticComponent<QuestionProps>;

package/dist/questions/multiple-choice.d.ts

@@ -8,4 +8,4 @@ import { QuestionProps } from './types';
  *   onAnswer={(answers) => handleAnswer(answers)}
  * />
  */
-export declare const MultipleChoice: ({ question, sessionAnswers, onAnswer, readOnly, showCorrectAnswers, disabled, }: QuestionProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MultipleChoice: import('react').NamedExoticComponent<QuestionProps>;

package/dist/questions/numeric.d.ts

@@ -0,0 +1,11 @@
+import { QuestionProps } from './types';
+/**
+ * Numeric renders a number input question with optional tolerance and unit display.
+ *
+ * @example
+ * <Numeric
+ *   question={{ uid: "q1", type: "numeric", content: "What is pi to 2 decimal places?", numericAnswer: 3.14, numericTolerance: 0.01 }}
+ *   onAnswer={(answers) => handleAnswer(answers)}
+ * />
+ */
+export declare const Numeric: import('react').NamedExoticComponent<QuestionProps>;

package/dist/questions/ordering.d.ts

@@ -0,0 +1,12 @@
+import { QuestionProps } from './types';
+/**
+ * Ordering renders a drag-and-drop reorderable list of items.
+ * The correct order is determined by each answer's `sequence` field.
+ *
+ * @example
+ * <Ordering
+ *   question={question}
+ *   onAnswer={(answers) => handleAnswer(answers)}
+ * />
+ */
+export declare const Ordering: import('react').NamedExoticComponent<QuestionProps>;

package/dist/questions/question-renderer.d.ts

@@ -9,4 +9,4 @@ import { QuestionProps } from './types';
  *   onAnswer={handleAnswer}
  * />
  */
-export declare const QuestionRenderer: (props: QuestionProps) => import("react/jsx-runtime").JSX.Element;
+export declare const QuestionRenderer: import('react').NamedExoticComponent<QuestionProps>;

package/dist/questions/scenario.d.ts

@@ -0,0 +1,23 @@
+import { QuestionProps } from './types';
+/**
+ * Scenario renders a shared context/stimulus with multiple sub-questions.
+ *
+ * Sub-questions can be any existing question type (choice, numeric, matching, etc.).
+ * The shared context is displayed prominently above all sub-questions.
+ *
+ * @example
+ * <Scenario
+ *   question={{
+ *     uid: "s1",
+ *     type: "scenario",
+ *     content: "<p>Read the following passage and answer the questions below.</p>",
+ *     scenarioQuestions: [
+ *       { uid: "sq1", type: "choice", content: "What is the main idea?", answers: [...] },
+ *       { uid: "sq2", type: "true_false", content: "The author agrees.", answers: [...] },
+ *     ],
+ *     scenarioScoringMode: "per_question",
+ *   }}
+ *   onAnswer={(answers) => handleAnswer(answers)}
+ * />
+ */
+export declare const Scenario: import('react').NamedExoticComponent<QuestionProps>;

package/dist/questions/scoring.d.ts

@@ -0,0 +1,22 @@
+import { QuestionData, SessionAnswer } from './types';
+/**
+ * Scores a single question against the user's answers.
+ *
+ * @returns `true` if correct, `false` if incorrect, `null` if the question is not auto-gradable.
+ */
+export declare function scoreQuestion(question: QuestionData, userAnswers: SessionAnswer[]): boolean | null;
+/**
+ * Scores an entire set of questions against user answers.
+ *
+ * @returns An object with correct count, total gradable, and percentage.
+ */
+export declare function scoreAssessment(questions: QuestionData[], answers: SessionAnswer[]): {
+    correct: number;
+    total: number;
+    percentage: number;
+};
+/**
+ * Scores individual sub-questions within a scenario.
+ * Returns a Map of sub-question UID to score (`true`/`false`/`null`).
+ */
+export declare function scoreScenarioSubQuestions(question: QuestionData, userAnswers: SessionAnswer[]): Map<string, boolean | null>;

package/dist/questions/spreadsheet.d.ts

@@ -0,0 +1,29 @@
+import { QuestionProps } from './types';
+/**
+ * Spreadsheet renders a grid-based question for accounting and tabular data entry.
+ * Students fill in editable cells while locked cells display pre-filled values.
+ * Each cell is graded independently with support for numeric tolerance.
+ *
+ * @example
+ * <Spreadsheet
+ *   question={{
+ *     uid: "q1",
+ *     type: "spreadsheet",
+ *     content: "Complete the trial balance:",
+ *     spreadsheetColumns: [
+ *       { uid: "col-acct", label: "Account", type: "text", width: 14 },
+ *       { uid: "col-dr", label: "Debit ($)", type: "currency", width: 9 },
+ *       { uid: "col-cr", label: "Credit ($)", type: "currency", width: 9 },
+ *     ],
+ *     spreadsheetRows: [
+ *       { uid: "r1", cells: [
+ *         { uid: "r1-acct", columnUid: "col-acct", locked: true, value: "Cash" },
+ *         { uid: "r1-dr", columnUid: "col-dr", locked: false, correctAnswer: "5000" },
+ *         { uid: "r1-cr", columnUid: "col-cr", locked: true, value: "" },
+ *       ]},
+ *     ],
+ *   }}
+ *   onAnswer={(answers) => handleAnswer(answers)}
+ * />
+ */
+export declare const Spreadsheet: import('react').NamedExoticComponent<QuestionProps>;

package/dist/questions/true-false.d.ts

@@ -8,4 +8,4 @@ import { QuestionProps } from './types';
  *   onAnswer={(answers) => handleAnswer(answers)}
  * />
  */
-export declare const TrueFalse: ({ question, sessionAnswers, onAnswer, readOnly, showCorrectAnswers, disabled, }: QuestionProps) => import("react/jsx-runtime").JSX.Element;
+export declare const TrueFalse: import('react').NamedExoticComponent<QuestionProps>;

package/dist/questions/types.d.ts

@@ -1,4 +1,6 @@
-export type QuestionTypeEnum = "multiple_choice" | "choice" | "true_false" | "fill_in_the_blank" | "essay";
+export type QuestionTypeEnum = "multiple_choice" | "choice" | "true_false" | "fill_in_the_blank" | "essay" | "matching" | "ordering" | "numeric" | "hotspot" | "inline_choice" | "scenario" | "spreadsheet";
+/** Scoring strategy for scenario questions. */
+export type ScenarioScoringMode = "per_question" | "all_or_nothing";
 export interface AnswerOption {
     uid: string;
     content: string;
@@ -12,12 +14,115 @@ export interface SessionAnswer {
     content?: string;
     confidence?: string;
 }
+/** A pair linking a left-side item to its correct right-side target. */
+export interface MatchingPair {
+    uid: string;
+    /** Left-side item content (HTML) */
+    item: string;
+    /** Right-side target content (HTML) */
+    target: string;
+    sequence: number;
+}
+/** A clickable region on a hotspot image. Coordinates are percentages (0–100). */
+export interface HotspotRegion {
+    uid: string;
+    shape: "rect" | "circle";
+    /** rect: [x, y, width, height]; circle: [centerX, centerY, radius] */
+    coords: number[];
+    isCorrect?: boolean;
+    label?: string;
+}
+/** A dropdown blank embedded in an inline-choice (cloze) passage. */
+export interface InlineBlank {
+    uid: string;
+    options: {
+        uid: string;
+        content: string;
+        isCorrect?: boolean;
+    }[];
+    sequence: number;
+}
+/** A column definition for a spreadsheet question. */
+export interface SpreadsheetColumn {
+    uid: string;
+    /** Column header text */
+    label: string;
+    /** Data type hint for input rendering and scoring */
+    type: "text" | "numeric" | "currency";
+    /** Column width in rems (default 8) */
+    width?: number;
+}
+/** A single cell in a spreadsheet row. */
+export interface SpreadsheetCell {
+    /** Unique identifier — becomes the answerUid in SessionAnswer */
+    uid: string;
+    /** Which column this cell belongs to */
+    columnUid: string;
+    /** When true, cell is pre-filled and not editable */
+    locked: boolean;
+    /** Display value for locked cells, or pre-fill for editable cells */
+    value?: string;
+    /** Expected answer for grading (editable cells only) */
+    correctAnswer?: string;
+    /** Acceptable numeric deviation (default 0 = exact match) */
+    tolerance?: number;
+    /** Hint shown in review mode (e.g., "= Revenue – Expenses") */
+    formula?: string;
+}
+/** A row in a spreadsheet question grid. */
+export interface SpreadsheetRow {
+    uid: string;
+    /** Optional row header label (e.g., "Cash", "Accounts Receivable") */
+    label?: string;
+    /** Ordered cells — one per column */
+    cells: SpreadsheetCell[];
+    /** Renders as a bold section divider row */
+    isHeader?: boolean;
+    /** Renders in table footer with top border */
+    isTotals?: boolean;
+}
+/** Content blocks associated with a question for open-book reference. */
+export interface QuestionMaterial {
+    /** UID of the question this material is linked to */
+    questionUid: string;
+    /** Display label for the material group (e.g., "Chapter 3: Bonds") */
+    label?: string;
+    /** Content blocks to render in the materials drawer */
+    blocks: import('../content/types').LessonBlock[];
+}
 export interface QuestionData {
     uid: string;
     type: QuestionTypeEnum;
+    /** Question prompt (HTML) */
     content: string;
+    /** Explanation shown in review mode (HTML) */
     explanation?: string;
+    /** Answer options for choice / multiple_choice / true_false / ordering */
     answers?: AnswerOption[];
+    /** Matching-specific: pairs of items and targets */
+    matchingPairs?: MatchingPair[];
+    /** Numeric-specific: correct answer */
+    numericAnswer?: number;
+    /** Numeric-specific: acceptable deviation (default 0 = exact) */
+    numericTolerance?: number;
+    /** Numeric-specific: unit label displayed after input */
+    numericUnit?: string;
+    /** Hotspot-specific: image URL */
+    hotspotImageUrl?: string;
+    /** Hotspot-specific: clickable regions */
+    hotspotRegions?: HotspotRegion[];
+    /** Hotspot-specific: allow selecting multiple regions */
+    hotspotMultiSelect?: boolean;
+    /** InlineChoice-specific: dropdown blanks embedded in content */
+    inlineBlanks?: InlineBlank[];
+    /** Scenario-specific: sub-questions grouped under this scenario's shared context */
+    scenarioQuestions?: QuestionData[];
+    /** Scenario-specific: how the scenario is scored (default "per_question") */
+    scenarioScoringMode?: ScenarioScoringMode;
+    /** Spreadsheet-specific: column definitions */
+    spreadsheetColumns?: SpreadsheetColumn[];
+    /** Spreadsheet-specific: row data with cells */
+    spreadsheetRows?: SpreadsheetRow[];
 }
 /**
  * Shared props interface for all question type components.

package/dist/questions/use-drag-reorder.d.ts

@@ -0,0 +1,17 @@
+interface UseDragReorderOptions<T> {
+    items: T[];
+    onReorder: (items: T[]) => void;
+    disabled?: boolean;
+}
+export declare function useDragReorder<T>({ items, onReorder, disabled, }: UseDragReorderOptions<T>): {
+    getDragProps: (index: number) => {
+        draggable: boolean;
+        onDragStart: (e: React.DragEvent) => void;
+        onDragOver: (e: React.DragEvent) => void;
+        onDrop: (e: React.DragEvent) => void;
+        onDragEnd: () => void;
+    };
+    dragIndex: number | null;
+    dragOverIndex: number | null;
+};
+export {};

package/dist/sections/AnnouncementFeed/AnnouncementFeed.d.ts

@@ -1,2 +1,2 @@
 import { AnnouncementFeedProps } from './types';
-export declare function AnnouncementFeed({ announcements, onMarkRead, onSelect, showAvatars, previewLines, emptyMessage, readOnly, className, style, }: AnnouncementFeedProps): import("react/jsx-runtime").JSX.Element;
+export declare function AnnouncementFeed({ announcements, onMarkRead, onSelect, showAvatars, previewLines, emptyMessage, readOnly, isLoading, error, onRetry, pageSize, currentPage, totalItems, onPageChange, className, style, }: AnnouncementFeedProps): import("react/jsx-runtime").JSX.Element;

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

@@ -25,6 +25,20 @@ export interface AnnouncementFeedProps {
     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 */
@@ -35,7 +49,7 @@ export interface Announcement {
     uid: string;
     /** Announcement title */
     title: string;
-    /** Announcement body content */
+    /** Announcement body content. May contain HTML from a rich-text editor. */
     content: string;
     /** Author information */
     author: {

package/dist/sections/AssessmentReview/AssessmentReview.d.ts

@@ -1,2 +1,2 @@
 import { AssessmentReviewProps } from './types';
-export declare function AssessmentReview({ questions, sessionAnswers, score, questionGroups, showCorrectAnswers, className, style, }: AssessmentReviewProps): import("react/jsx-runtime").JSX.Element;
+export declare function AssessmentReview({ questions, sessionAnswers, score, questionGroups, showCorrectAnswers, isLoading, error, onRetry, className, style, }: AssessmentReviewProps): import("react/jsx-runtime").JSX.Element;

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

@@ -33,6 +33,12 @@ export interface AssessmentReviewProps {
      * @default true
      */
     showCorrectAnswers?: 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/AssignmentSubmission/AssignmentSubmission.d.ts

@@ -1,2 +1,2 @@
 import { AssignmentSubmissionProps } from './types';
-export declare function AssignmentSubmission({ title, instructions, dueDate, maxScore, status, submissionTypes, existingSubmission, fileConstraints, onSubmit, onSaveDraft, grade, isSubmitting, readOnly, className, style, }: AssignmentSubmissionProps): import("react/jsx-runtime").JSX.Element;
+export declare function AssignmentSubmission({ title, instructions, dueDate, maxScore, status, submissionTypes, existingSubmission, fileConstraints, onSubmit, onSaveDraft, grade, isSubmitting, readOnly, isLoading, error, onRetry, className, style, }: AssignmentSubmissionProps): import("react/jsx-runtime").JSX.Element;