@hydralms/components 0.2.0 → 0.3.1

package/dist/progress/types.d.ts

@@ -68,6 +68,8 @@ 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 */

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

@@ -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

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

package/dist/questions/index.d.ts

@@ -12,4 +12,6 @@ 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

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

package/dist/questions/matching.d.ts

@@ -19,4 +19,4 @@ import { QuestionProps } from './types';
  *   onAnswer={(answers) => handleAnswer(answers)}
  * />
  */
-export declare const Matching: ({ question, sessionAnswers, onAnswer, readOnly, showCorrectAnswers, disabled, }: QuestionProps) => import("react/jsx-runtime").JSX.Element;
+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

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

package/dist/questions/ordering.d.ts

@@ -9,4 +9,4 @@ import { QuestionProps } from './types';
  *   onAnswer={(answers) => handleAnswer(answers)}
  * />
  */
-export declare const Ordering: ({ question, sessionAnswers, onAnswer, readOnly, showCorrectAnswers, disabled, }: QuestionProps) => import("react/jsx-runtime").JSX.Element;
+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

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

package/dist/questions/spreadsheet.d.ts

@@ -26,4 +26,4 @@ import { QuestionProps } from './types';
  *   onAnswer={(answers) => handleAnswer(answers)}
  * />
  */
-export declare const Spreadsheet: ({ question, sessionAnswers, onAnswer, readOnly, showCorrectAnswers, disabled, }: QuestionProps) => import("react/jsx-runtime").JSX.Element;
+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/sections/AdaptiveLearningPath/AdaptiveLearningPath.d.ts

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

package/dist/sections/AdaptiveLearningPath/path-connector.d.ts

@@ -0,0 +1,8 @@
+import { PathNodeStatus } from './types';
+interface PathConnectorProps {
+    /** Status of the node above this connector */
+    fromStatus: PathNodeStatus;
+    className?: string;
+}
+export declare function PathConnector({ fromStatus, className }: PathConnectorProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/sections/AdaptiveLearningPath/path-milestone-marker.d.ts

@@ -0,0 +1,7 @@
+import { PathMilestone } from './types';
+interface PathMilestoneMarkerProps {
+    milestone: PathMilestone;
+    className?: string;
+}
+export declare function PathMilestoneMarker({ milestone, className, }: PathMilestoneMarkerProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/sections/AdaptiveLearningPath/path-node-card.d.ts

@@ -0,0 +1,10 @@
+import { PathNode } from './types';
+interface PathNodeCardProps {
+    node: PathNode;
+    onClick?: (uid: string) => void;
+    onStart?: (uid: string) => void;
+    readOnly?: boolean;
+    className?: string;
+}
+export declare const PathNodeCard: import('react').NamedExoticComponent<PathNodeCardProps>;
+export {};

package/dist/sections/AdaptiveLearningPath/path-skill-bar.d.ts

@@ -0,0 +1,8 @@
+import { PathSkill } from './types';
+interface PathSkillBarProps {
+    skill: PathSkill;
+    onClick?: (uid: string) => void;
+    className?: string;
+}
+export declare const PathSkillBar: import('react').NamedExoticComponent<PathSkillBarProps>;
+export {};

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

@@ -0,0 +1,136 @@
+import { ReactNode } from 'react';
+/**
+ * Status of a single node in the learning path.
+ * - `locked` — prerequisites not met, node is inaccessible
+ * - `available` — prerequisites met, learner can start
+ * - `in_progress` — learner is currently working on this node
+ * - `completed` — learner finished but below mastery threshold
+ * - `mastered` — learner finished and reached the mastery threshold
+ * - `skipped` — node was bypassed by the adaptive engine
+ */
+export type PathNodeStatus = "locked" | "available" | "in_progress" | "completed" | "mastered" | "skipped";
+/**
+ * The type of learning activity a path node represents.
+ * Aligns with LearningObjectIcon type strings.
+ */
+export type PathNodeType = "lesson" | "quiz" | "assignment" | "video" | "discussion" | "document" | "assessment" | "audio" | "link";
+/** A skill or competency area that the learning path develops. */
+export interface PathSkill {
+    uid: string;
+    name: string;
+    /** Current proficiency level 0–100 */
+    proficiency: number;
+    /** Target proficiency level 0–100 */
+    targetProficiency?: number;
+}
+/** A milestone marker along the learning path. */
+export interface PathMilestone {
+    uid: string;
+    title: string;
+    description?: string;
+    /** Whether the milestone has been reached */
+    reached: boolean;
+    /** Index of the node after which this milestone appears (zero-based) */
+    afterNodeIndex: number;
+    variant?: "default" | "gold" | "silver" | "bronze";
+}
+/** A single node in the adaptive learning path. */
+export interface PathNode {
+    uid: string;
+    title: string;
+    description?: string;
+    /** Learning activity type — used for icon selection via LearningObjectIcon */
+    type: PathNodeType;
+    status: PathNodeStatus;
+    /** Estimated duration in seconds */
+    estimatedDuration?: number;
+    /** Performance score if completed (0–100) */
+    score?: number;
+    /** Whether this node is recommended as the next step */
+    recommended?: boolean;
+    /** Skill UIDs that this node develops */
+    skillUids?: string[];
+    /** UIDs of prerequisite nodes */
+    prerequisites?: string[];
+    /** Optional custom icon (overrides type-based icon) */
+    icon?: ReactNode;
+}
+/** A branch point where the adaptive engine may redirect the learner. */
+export interface PathBranch {
+    uid: string;
+    /** UID of the node where the branch originates */
+    fromNodeUid: string;
+    /** Label for this branch (e.g., "Review Fundamentals") */
+    label: string;
+    /** UIDs of nodes in this branch path */
+    nodeUids: string[];
+    /** Whether this branch is the active/chosen branch */
+    active?: boolean;
+    /** Condition description (e.g., "Score below 70%") */
+    condition?: string;
+}
+/** Overall progress summary for the path. */
+export interface PathProgress {
+    /** Percentage of path completed (0–100) */
+    completionPercentage: number;
+    completedNodes: number;
+    totalNodes: number;
+    /** Total time spent in seconds */
+    totalTimeSpent: number;
+    /** Average score across completed nodes (0–100) */
+    averageScore?: number;
+    /** Current streak in days */
+    currentStreak?: number;
+}
+/**
+ * AdaptiveLearningPath section — a premium visualization of a personalized
+ * learning sequence that adapts based on learner performance.
+ *
+ * Shows a visual path map with nodes, connectors, milestones, skill bars,
+ * and summary stats. Each node represents a learning activity with status,
+ * score, and recommended-next indicators.
+ *
+ * @example
+ * <AdaptiveLearningPath
+ *   title="React Mastery Path"
+ *   description="A personalized journey for mastering React"
+ *   nodes={pathNodes}
+ *   progress={pathProgress}
+ *   onNodeClick={(uid) => navigate(`/activity/${uid}`)}
+ *   onNodeStart={(uid) => startActivity(uid)}
+ * />
+ */
+export interface AdaptiveLearningPathProps {
+    /** Path title */
+    title: string;
+    /** Optional path description */
+    description?: string;
+    /** Difficulty level displayed in the header */
+    difficulty?: "beginner" | "intermediate" | "advanced";
+    /** Ordered list of learning path nodes */
+    nodes: PathNode[];
+    /** Overall path progress data */
+    progress: PathProgress;
+    /** Skill/competency areas covered by this path */
+    skills?: PathSkill[];
+    /** Milestones along the path */
+    milestones?: PathMilestone[];
+    /** Branch points for adaptive routing */
+    branches?: PathBranch[];
+    /** Called when the user clicks a node */
+    onNodeClick?: (nodeUid: string) => void;
+    /** Called when the user starts a recommended or available activity */
+    onNodeStart?: (nodeUid: string) => void;
+    /** Called when the user clicks a skill */
+    onSkillClick?: (skillUid: string) => void;
+    /** When true, disables all interactive elements. @default false */
+    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;
+    className?: string;
+    style?: React.CSSProperties;
+}

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;

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

@@ -50,6 +50,12 @@ export interface AssignmentSubmissionProps {
     isSubmitting?: boolean;
     /** When true, disables all 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/CertificateViewer/CertificateViewer.d.ts

@@ -1,2 +1,2 @@
 import { CertificateViewerProps } from './types';
-export declare function CertificateViewer({ recipientName, courseTitle, completionDate, organizationName, organizationLogo, signatory, certificateId, variant, showActions, onPrint, onDownload, className, style, }: CertificateViewerProps): import("react/jsx-runtime").JSX.Element;
+export declare function CertificateViewer({ recipientName, courseTitle, completionDate, organizationName, organizationLogo, signatory, certificateId, variant, showActions, onPrint, onDownload, isLoading, error, onRetry, className, style, }: CertificateViewerProps): import("react/jsx-runtime").JSX.Element;

package/dist/sections/CertificateViewer/certificate-variants.d.ts

@@ -0,0 +1,42 @@
+import { CertificateVariant } from './types';
+export interface CornerConfig {
+    size: number;
+    paths: {
+        d: string;
+        strokeWidth: number;
+    }[];
+    dots?: {
+        cx: number;
+        cy: number;
+        r: number;
+    }[];
+    color: string;
+}
+export declare const CORNER_CONFIGS: Record<CertificateVariant, CornerConfig | null>;
+export declare const CORNER_POSITIONS: readonly [{
+    readonly key: "tl";
+    readonly pos: "top-3 left-3";
+    readonly transform: undefined;
+}, {
+    readonly key: "tr";
+    readonly pos: "top-3 right-3";
+    readonly transform: "scaleX(-1)";
+}, {
+    readonly key: "bl";
+    readonly pos: "bottom-3 left-3";
+    readonly transform: "scaleY(-1)";
+}, {
+    readonly key: "br";
+    readonly pos: "bottom-3 right-3";
+    readonly transform: "scale(-1)";
+}];
+export interface DividerConfig {
+    lineColor: string;
+    motif: React.ReactNode;
+}
+export declare const DIVIDER_CONFIGS: Record<CertificateVariant, DividerConfig>;
+export declare const BACKGROUND_GLOW: Record<CertificateVariant, React.CSSProperties | null>;
+export declare const ICON_COLORS: Record<CertificateVariant, string>;
+export declare const HEADING_STYLES: Record<CertificateVariant, string>;
+export declare const COURSE_TITLE_COLORS: Record<CertificateVariant, string>;
+export declare const SERIF_VARIANTS: ReadonlySet<CertificateVariant>;

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

@@ -42,6 +42,12 @@ export interface CertificateViewerProps {
     onPrint?: () => void;
     /** Called when download is triggered */
     onDownload?: () => 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/ContentAuthoringStudio/ContentAuthoringStudio.d.ts

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

package/dist/sections/ContentAuthoringStudio/block-editor-item.d.ts

@@ -0,0 +1,14 @@
+import { LessonBlock } from '../../content/types';
+import { AuthoringBlock } from './types';
+interface BlockEditorItemProps {
+    item: AuthoringBlock;
+    onChange: (id: string, block: LessonBlock) => void;
+    onRemove: (id: string) => void;
+    onDuplicate: (id: string) => void;
+    onToggleCollapse: (id: string) => void;
+    dragProps: Record<string, unknown>;
+    isDragging: boolean;
+    isDragOver: boolean;
+}
+export declare const BlockEditorItem: import('react').NamedExoticComponent<BlockEditorItemProps>;
+export {};

package/dist/sections/ContentAuthoringStudio/block-type-picker.d.ts

@@ -0,0 +1,12 @@
+import { LessonBlock } from '../../content/types';
+export declare function getBlockIcon(type: string): import('react').ComponentType<{
+    className?: string;
+}>;
+export declare function getBlockLabel(type: string): string;
+interface BlockTypePickerProps {
+    onSelect: (type: LessonBlock["type"]) => void;
+    allowedTypes?: LessonBlock["type"][];
+    className?: string;
+}
+export declare function BlockTypePicker({ onSelect, allowedTypes, className, }: BlockTypePickerProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,67 @@
+import { LessonBlock } from '../../content/types';
+/**
+ * A single authoring block wrapping a LessonBlock with editor metadata.
+ */
+export interface AuthoringBlock {
+    /** Unique identifier for keying and drag operations */
+    id: string;
+    /** The underlying content block data */
+    block: LessonBlock;
+    /** Whether this block is collapsed in the editor UI */
+    collapsed?: boolean;
+}
+/**
+ * Metadata for a block type option in the picker.
+ */
+export interface BlockTypeOption {
+    type: LessonBlock["type"];
+    label: string;
+    description: string;
+}
+/**
+ * ContentAuthoringStudio is a premium block-based content editor
+ * for creating lessons. It produces the same `LessonBlock[]` data
+ * model that `LessonPage` renders, providing a WYSIWYG authoring
+ * experience with drag-and-drop reordering, per-block editors,
+ * and live preview.
+ *
+ * @example
+ * <ContentAuthoringStudio
+ *   title="React Hooks Deep Dive"
+ *   blocks={lessonBlocks}
+ *   onBlocksChange={setLessonBlocks}
+ *   onTitleChange={setTitle}
+ *   onSave={({ title, blocks }) => api.saveLesson(title, blocks)}
+ * />
+ */
+export interface ContentAuthoringStudioProps {
+    /** Lesson title (editable in edit mode) */
+    title?: string;
+    /** Initial content blocks */
+    blocks?: LessonBlock[];
+    /** Called when blocks change (add, edit, remove, reorder) */
+    onBlocksChange?: (blocks: LessonBlock[]) => void;
+    /** Called when the title changes */
+    onTitleChange?: (title: string) => void;
+    /** Called when the user clicks Save */
+    onSave?: (data: {
+        title: string;
+        blocks: LessonBlock[];
+    }) => void;
+    /** Show the edit/preview toggle. @default true */
+    showPreviewToggle?: boolean;
+    /** Restrict available block types. Defaults to all types. */
+    allowedBlockTypes?: LessonBlock["type"][];
+    /** When true, shows preview only (no editing controls). @default false */
+    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;
+}

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

@@ -0,0 +1,2 @@
+import { CourseCatalogProps } from './types';
+export declare function CourseCatalog({ courses, categories, onCourseClick, onEnroll, viewMode: initialViewMode, allowViewToggle, showSearch, emptyMessage, readOnly, isLoading, error, onRetry, pageSize, currentPage, totalItems, onPageChange, className, style, }: CourseCatalogProps): import("react/jsx-runtime").JSX.Element;