@lessonkit/react 1.3.0 → 1.4.0

package/dist/index.d.cts

@@ -1,11 +1,11 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import React$1 from 'react';
+import React__default from 'react';
 import * as _lessonkit_core from '@lessonkit/core';
-import { TelemetryEvent, CourseId, TelemetryUser, TrackingClient, LessonkitPlugin, ProgressState, StoragePort, LessonId, TelemetryEventName, TelemetryDataFor, PluginHost, AssessmentHandle, BlockId, AssessmentBaseProps, AssessmentBehaviour, CompoundHandle, AssessmentAnsweredData, AssessmentCompletedData, CheckId } from '@lessonkit/core';
-export { AssessmentAnsweredData, AssessmentBaseProps, AssessmentBehaviour, AssessmentCompletedData, AssessmentHandle, AssessmentInteractionType, AssessmentScoreInput, AssessmentScoreResult, AssessmentXAPIData, CompoundBaseProps, CompoundHandle, CompoundResumeState, InteractionBlockRegistration, LessonkitPlugin, LessonkitPluginContext, LessonkitPluginKind, PluginHost, PluginRegistry, TelemetryPipelineSink, buildTelemetryEvent, createLessonkitRuntime, createPluginRegistry, createTelemetryPipeline, defineAssessmentPlugin, defineLifecyclePlugin, defineTelemetryPlugin } from '@lessonkit/core';
-import { McqAssessmentDescriptor } from '@lessonkit/lxpack';
+import { TelemetryEvent, CourseId, TelemetryUser, TrackingClient, LmsBridgeMode, LessonkitPlugin, ProgressState, StoragePort, LessonId, TelemetryEventName, TelemetryDataFor, PluginHost, McqAssessmentProps, BlockId, AssessmentAnsweredData, AssessmentCompletedData, CheckId } from '@lessonkit/core';
+export { AssessmentAnsweredData, AssessmentBaseProps, AssessmentBehaviour, AssessmentCompletedData, AssessmentHandle, AssessmentInteractionType, AssessmentScoreInput, AssessmentScoreResult, AssessmentXAPIData, CompoundBaseProps, CompoundHandle, CompoundResumeState, InteractionBlockRegistration, LessonkitPlugin, LessonkitPluginContext, LessonkitPluginKind, LmsBridgeMode, McqAssessmentProps, PluginHost, PluginRegistry, TelemetryPipelineSink, buildTelemetryEvent, createLessonkitRuntime, createPluginRegistry, createTelemetryPipeline, defineAssessmentPlugin, defineLifecyclePlugin, defineTelemetryPlugin } from '@lessonkit/core';
+import * as _lessonkit_xapi from '@lessonkit/xapi';
 import { XAPITransport, XAPIClient } from '@lessonkit/xapi';
-import { LxpackBridgeMode } from '@lessonkit/lxpack/bridge';
+export { Accordion, AccordionProps, AccordionSection, ArithmeticProblem, ArithmeticQuiz, ArithmeticQuizProps, AssessmentSequence, AssessmentSequenceProps, DialogCard, DialogCards, DialogCardsProps, DragAndDrop, DragAndDropProps, DragItem, DragTheWords, DragTheWordsProps, DropTarget, Essay, EssayProps, FillInBlankSpec, FillInTheBlanks, FillInTheBlanksProps, FindHotspot, FindHotspotProps, FindMultipleHotspots, FindMultipleHotspotsProps, Flashcard, Flashcards, FlashcardsProps, Heading, HeadingProps, HotspotSpec, HotspotTarget, Image, ImageHotspots, ImageHotspotsProps, ImagePair, ImagePairing, ImagePairingProps, ImageProps, ImageSequencing, ImageSequencingProps, ImageSlide, ImageSlider, ImageSliderProps, InformationPanel, InformationWall, InformationWallProps, InteractiveBook, InteractiveBookProps, InteractiveVideo, InteractiveVideoProps, MarkTheWords, MarkTheWordsProps, MemoryGame, MemoryGameProps, MemoryPair, Page, PageProps, ParallaxSlide, ParallaxSlideshow, ParallaxSlideshowProps, Questionnaire, QuestionnaireField, QuestionnaireProps, SequencingImage, Slide, SlideDeck, SlideDeckProps, SlideProps, Summary, SummaryProps, Text, TextProps, TimedCue, TimedCueProps, TrueFalse, TrueFalseProps, Video, VideoProps } from './blocks-entry.cjs';
+export { K as KnowledgeCheck, Q as Quiz, a as QuizProps, r as resetAssessmentWarningsForTests, b as resetQuizWarningsForTests } from './AssessmentLessonGuard-D2Plzybb.cjs';
 import { LessonkitThemeV1, ThemePresetName, PartialLessonkitThemeV1 } from '@lessonkit/themes';
 export { ThemePresetName } from '@lessonkit/themes';
 
@@ -22,6 +22,8 @@ type LessonkitObservabilityConfig = {
     onTelemetryBufferDrop?: () => void;
     /** LMS bridge missing for a completion-related telemetry event (`bridge: auto`). */
     onLxpackBridgeMiss?: (event: TelemetryEvent) => void;
+    /** xAPI transport failure after retries (statement re-queued). */
+    onXapiTransportError?: (err: unknown) => void;
 };
 
 type LessonkitConfig = {
@@ -37,6 +39,8 @@ type LessonkitConfig = {
         enabled?: boolean;
         sink?: (event: Parameters<TrackingClient["track"]>[0]) => void | Promise<void>;
         batchSink?: (events: Parameters<TrackingClient["track"]>[0][]) => void | Promise<void>;
+        /** Keepalive batch delivery for pagehide (e.g. from createFetchBatchSink). */
+        exitBatchSink?: (events: Parameters<TrackingClient["track"]>[0][]) => void | Promise<void>;
         batch?: {
             enabled?: boolean;
             flushIntervalMs?: number;
@@ -46,11 +50,15 @@ type LessonkitConfig = {
     xapi?: {
         enabled?: boolean;
         transport?: XAPITransport;
+        /** Keepalive transport for pagehide (e.g. from createFetchTransport). */
+        exitTransport?: _lessonkit_xapi.XAPIExitTransport;
+        /** Abort in-flight transport by statement id (e.g. from createFetchTransport). */
+        abortInFlight?: (statementId: string) => void;
         client?: XAPIClient;
     };
     lxpack?: {
         /** Forward completion events to `window.parent.lxpackBridge.v1` when embedded (default `auto`). */
-        bridge?: LxpackBridgeMode;
+        bridge?: LmsBridgeMode;
     };
     /** Framework plugins (analytics, LMS, assessment, interaction, AI). */
     plugins?: LessonkitPlugin[];
@@ -64,7 +72,7 @@ type LessonkitConfig = {
 
 type LessonkitProviderProps = {
     config: LessonkitConfig;
-    children: React$1.ReactNode;
+    children: React__default.ReactNode;
 };
 type LessonkitRuntime = {
     config: LessonkitConfig;
@@ -87,30 +95,24 @@ type LessonkitRuntime = {
     }) => void;
     plugins: PluginHost | null;
 };
-declare function LessonkitProvider(props: LessonkitProviderProps): react_jsx_runtime.JSX.Element;
-
-type QuizProps = McqAssessmentDescriptor;
-declare const Quiz: React$1.ForwardRefExoticComponent<McqAssessmentDescriptor & React$1.RefAttributes<AssessmentHandle>>;
-declare function KnowledgeCheck(props: QuizProps): react_jsx_runtime.JSX.Element;
-/** @internal Reset module warnings between tests. */
-declare function resetQuizWarningsForTests(): void;
+declare function LessonkitProvider(props: LessonkitProviderProps): React__default.JSX.Element;
 
 type CourseProps = {
     title: string;
     courseId: CourseId;
     config?: Omit<LessonkitConfig, "courseId">;
-    children: React$1.ReactNode;
+    children: React__default.ReactNode;
 };
 type LessonProps = {
     title: string;
     lessonId: LessonId;
     /** When false, unmount does not emit lesson_completed (for routed multi-pane layouts). Default true. */
     autoCompleteOnUnmount?: boolean;
-    children: React$1.ReactNode;
+    children: React__default.ReactNode;
 };
 type ScenarioProps = {
     blockId?: BlockId;
-    children: React$1.ReactNode;
+    children: React__default.ReactNode;
 };
 type ReflectionProps = {
     blockId?: BlockId;
@@ -118,270 +120,17 @@ type ReflectionProps = {
     hint?: string;
     value?: string;
     onChange?: (value: string) => void;
-    children?: React$1.ReactNode;
+    children?: React__default.ReactNode;
 };
-type KnowledgeCheckProps = McqAssessmentDescriptor;
+type KnowledgeCheckProps = McqAssessmentProps;
 type ProgressTrackerProps = {
     totalLessons?: number;
 };
-declare function Course(props: CourseProps): react_jsx_runtime.JSX.Element;
-declare function Lesson(props: LessonProps): react_jsx_runtime.JSX.Element;
-declare function Scenario(props: ScenarioProps): react_jsx_runtime.JSX.Element;
-declare function Reflection(props: ReflectionProps): react_jsx_runtime.JSX.Element;
-declare function ProgressTracker(props: ProgressTrackerProps): react_jsx_runtime.JSX.Element;
-
-type TrueFalseProps = AssessmentBaseProps & {
-    question: string;
-    answer: boolean;
-};
-declare const TrueFalse: React$1.ForwardRefExoticComponent<_lessonkit_core.AssessmentBehaviour & {
-    checkId: _lessonkit_core.CheckId;
-    passingScore?: number;
-} & {
-    question: string;
-    answer: boolean;
-} & React$1.RefAttributes<AssessmentHandle>>;
-
-type MarkTheWordsProps = AssessmentBaseProps & {
-    /** Plain text; words listed in `correctWords` are selectable targets. */
-    text: string;
-    correctWords: string[];
-};
-declare const MarkTheWords: React$1.ForwardRefExoticComponent<_lessonkit_core.AssessmentBehaviour & {
-    checkId: _lessonkit_core.CheckId;
-    passingScore?: number;
-} & {
-    /** Plain text; words listed in `correctWords` are selectable targets. */
-    text: string;
-    correctWords: string[];
-} & React$1.RefAttributes<AssessmentHandle>>;
-
-type FillInBlankSpec = {
-    id: string;
-    answer: string;
-};
-type FillInTheBlanksProps = AssessmentBaseProps & {
-    /** Text with `*` wrapping each blank answer, e.g. "The *capital* of France is *Paris*." */
-    template: string;
-    /** Optional explicit blanks (overrides parsing from template). */
-    blanks?: FillInBlankSpec[];
-};
-declare const FillInTheBlanks: React$1.ForwardRefExoticComponent<_lessonkit_core.AssessmentBehaviour & {
-    checkId: _lessonkit_core.CheckId;
-    passingScore?: number;
-} & {
-    /** Text with `*` wrapping each blank answer, e.g. "The *capital* of France is *Paris*." */
-    template: string;
-    /** Optional explicit blanks (overrides parsing from template). */
-    blanks?: FillInBlankSpec[];
-} & React$1.RefAttributes<AssessmentHandle>>;
-
-type DragTheWordsProps = AssessmentBaseProps & {
-    /** Sentence with `*` around drop zones; `words` are draggable options. */
-    template: string;
-    words: string[];
-};
-declare const DragTheWords: React$1.ForwardRefExoticComponent<_lessonkit_core.AssessmentBehaviour & {
-    checkId: _lessonkit_core.CheckId;
-    passingScore?: number;
-} & {
-    /** Sentence with `*` around drop zones; `words` are draggable options. */
-    template: string;
-    words: string[];
-} & React$1.RefAttributes<AssessmentHandle>>;
-
-type DragItem = {
-    id: string;
-    label: string;
-};
-type DropTarget = {
-    id: string;
-    label: string;
-    accepts: string;
-};
-type DragAndDropProps = AssessmentBaseProps & {
-    items: DragItem[];
-    targets: DropTarget[];
-};
-declare const DragAndDrop: React$1.ForwardRefExoticComponent<_lessonkit_core.AssessmentBehaviour & {
-    checkId: _lessonkit_core.CheckId;
-    passingScore?: number;
-} & {
-    items: DragItem[];
-    targets: DropTarget[];
-} & React$1.RefAttributes<AssessmentHandle>>;
-
-type AssessmentSequenceProps = AssessmentBehaviour & {
-    children: React$1.ReactNode;
-    /** Show one child assessment at a time (Question Set). */
-    sequential?: boolean;
-    blockId?: BlockId;
-};
-declare const AssessmentSequence: React$1.ForwardRefExoticComponent<AssessmentBehaviour & {
-    children: React$1.ReactNode;
-    /** Show one child assessment at a time (Question Set). */
-    sequential?: boolean;
-    blockId?: BlockId;
-} & React$1.RefAttributes<CompoundHandle>>;
-
-type TextProps = {
-    blockId?: BlockId;
-    children: React$1.ReactNode;
-};
-declare function Text(props: TextProps): react_jsx_runtime.JSX.Element;
-
-type HeadingProps = {
-    blockId?: BlockId;
-    level: 1 | 2 | 3;
-    children: React.ReactNode;
-};
-declare function Heading(props: HeadingProps): react_jsx_runtime.JSX.Element;
-
-type ImageProps = {
-    blockId?: BlockId;
-    src: string;
-    alt: string;
-};
-declare function Image(props: ImageProps): react_jsx_runtime.JSX.Element;
-
-type PageProps = {
-    blockId: BlockId;
-    title?: string;
-    /** When true, page is used as a book chapter but hidden until navigated (InteractiveBook). */
-    hidden?: boolean;
-    /** Index within a compound parent (set by InteractiveBook). */
-    pageIndex?: number;
-    /** Compound parent type for telemetry (e.g. InteractiveBook). */
-    parentType?: string;
-    children: React$1.ReactNode;
-};
-declare function Page(props: PageProps): react_jsx_runtime.JSX.Element;
-
-type InteractiveBookProps = {
-    blockId: BlockId;
-    title: string;
-    showBookScore?: boolean;
-    children: React$1.ReactElement<PageProps> | React$1.ReactElement<PageProps>[];
-};
-declare const InteractiveBook: React$1.ForwardRefExoticComponent<InteractiveBookProps & React$1.RefAttributes<CompoundHandle>>;
-
-type SlideProps = {
-    blockId: BlockId;
-    title?: string;
-    /** When true, slide is used in a deck but hidden until navigated (SlideDeck). */
-    hidden?: boolean;
-    /** Index within a compound parent (set by SlideDeck). */
-    slideIndex?: number;
-    /** Compound parent type for telemetry (e.g. SlideDeck). */
-    parentType?: string;
-    children: React$1.ReactNode;
-};
-declare function Slide(props: SlideProps): react_jsx_runtime.JSX.Element;
-
-type SlideDeckProps = {
-    blockId: BlockId;
-    title: string;
-    showDeckScore?: boolean;
-    children: React$1.ReactElement<SlideProps> | React$1.ReactElement<SlideProps>[];
-};
-declare const SlideDeck: React$1.ForwardRefExoticComponent<SlideDeckProps & React$1.RefAttributes<CompoundHandle>>;
-
-type AccordionSection = {
-    id: string;
-    title: string;
-    content: React$1.ReactNode;
-};
-type AccordionProps = {
-    blockId: BlockId;
-    sections: AccordionSection[];
-};
-declare function Accordion(props: AccordionProps): react_jsx_runtime.JSX.Element;
-
-type DialogCard = {
-    front: string;
-    back: string;
-};
-type DialogCardsProps = {
-    blockId: BlockId;
-    cards: DialogCard[];
-};
-declare function DialogCards(props: DialogCardsProps): react_jsx_runtime.JSX.Element | null;
-
-type Flashcard = {
-    front: string;
-    back: string;
-};
-type FlashcardsProps = {
-    blockId: BlockId;
-    cards: Flashcard[];
-    /** Optional self-score mode (not LMS-scored). */
-    selfScore?: boolean;
-};
-declare function Flashcards(props: FlashcardsProps): react_jsx_runtime.JSX.Element | null;
-
-type HotspotSpec = {
-    id: string;
-    label: string;
-    x: number;
-    y: number;
-    content: React$1.ReactNode;
-};
-type ImageHotspotsProps = {
-    blockId: BlockId;
-    src: string;
-    alt: string;
-    hotspots: HotspotSpec[];
-};
-declare function ImageHotspots(props: ImageHotspotsProps): react_jsx_runtime.JSX.Element;
-
-type ImageSlide = {
-    src: string;
-    alt: string;
-    caption?: string;
-};
-type ImageSliderProps = {
-    blockId: BlockId;
-    slides: ImageSlide[];
-};
-declare function ImageSlider(props: ImageSliderProps): react_jsx_runtime.JSX.Element | null;
-
-type HotspotTarget = {
-    id: string;
-    label: string;
-    x: number;
-    y: number;
-};
-type FindHotspotProps = AssessmentBaseProps & {
-    src: string;
-    alt: string;
-    targets: HotspotTarget[];
-    correctTargetId: string;
-};
-declare const FindHotspot: React$1.ForwardRefExoticComponent<_lessonkit_core.AssessmentBehaviour & {
-    checkId: _lessonkit_core.CheckId;
-    passingScore?: number;
-} & {
-    src: string;
-    alt: string;
-    targets: HotspotTarget[];
-    correctTargetId: string;
-} & React$1.RefAttributes<AssessmentHandle>>;
-
-type FindMultipleHotspotsProps = AssessmentBaseProps & {
-    src: string;
-    alt: string;
-    targets: HotspotTarget[];
-    correctTargetIds: string[];
-};
-declare const FindMultipleHotspots: React$1.ForwardRefExoticComponent<_lessonkit_core.AssessmentBehaviour & {
-    checkId: _lessonkit_core.CheckId;
-    passingScore?: number;
-} & {
-    src: string;
-    alt: string;
-    targets: HotspotTarget[];
-    correctTargetIds: string[];
-} & React$1.RefAttributes<AssessmentHandle>>;
+declare function Course(props: CourseProps): React__default.JSX.Element;
+declare function Lesson(props: LessonProps): React__default.JSX.Element;
+declare function Scenario(props: ScenarioProps): React__default.JSX.Element;
+declare function Reflection(props: ReflectionProps): React__default.JSX.Element;
+declare function ProgressTracker(props: ProgressTrackerProps): React__default.JSX.Element;
 
 declare function useAssessmentState(enclosingLessonId?: LessonId): {
     answer: (data: AssessmentAnsweredData) => void;
@@ -417,12 +166,17 @@ declare function useQuizState(enclosingLessonId?: LessonId): {
     }) => void;
 };
 
-declare function resetAssessmentWarningsForTests(): void;
+declare function shouldEnforceProductionGuard(): boolean;
+/**
+ * Throws in production when course config still uses dev-only console sinks or
+ * omits observability hooks while telemetry/xAPI are enabled.
+ */
+declare function assertProductionCourseConfig(config: Pick<LessonkitConfig, "tracking" | "xapi" | "observability" | "lxpack">): void;
 
 type ThemeMode = "light" | "dark" | "system";
 type ThemeResolvedMode = "light" | "dark";
 type ThemeProviderProps = {
-    children: React$1.ReactNode;
+    children: React__default.ReactNode;
     /** Partial theme merged on top of the resolved preset (last writer wins). */
     theme?: PartialLessonkitThemeV1;
     preset?: ThemePresetName;
@@ -436,7 +190,7 @@ type ThemeContextValue = {
     mode: ThemeMode;
     resolvedMode: ThemeResolvedMode;
 };
-declare function ThemeProvider(props: ThemeProviderProps): react_jsx_runtime.JSX.Element;
+declare function ThemeProvider(props: ThemeProviderProps): React__default.JSX.Element;
 declare function useTheme(): ThemeContextValue;
 
 declare const blockCatalogVersion: 1;
@@ -700,4 +454,4 @@ type BuildBlockCatalogOptions = {
 declare function buildBlockCatalog(opts?: BuildBlockCatalogOptions): BlockCatalogEntry[] | BlockCatalogEntryV2[] | BlockCatalogEntryV3[];
 declare function getBlockCatalogEntry(type: string, opts?: BuildBlockCatalogOptions): BlockCatalogEntry | BlockCatalogEntryV2 | BlockCatalogEntryV3 | undefined;
 
-export { Accordion, type AccordionProps, type AccordionSection, AssessmentSequence, type AssessmentSequenceProps, BLOCK_CATALOG, BLOCK_CATALOG_V2, BLOCK_CATALOG_V3, type BlockCatalogEntry, type BlockCatalogEntryV2, type BlockCatalogEntryV3, type BlockPropSpec, Course, type CourseProps, type DialogCard, DialogCards, type DialogCardsProps, DragAndDrop, type DragAndDropProps, type DragItem, DragTheWords, type DragTheWordsProps, type DropTarget, type FillInBlankSpec, FillInTheBlanks, type FillInTheBlanksProps, FindHotspot, type FindHotspotProps, FindMultipleHotspots, type FindMultipleHotspotsProps, type Flashcard, Flashcards, type FlashcardsProps, Heading, type HeadingProps, type HotspotSpec, type HotspotTarget, Image, ImageHotspots, type ImageHotspotsProps, type ImageProps, type ImageSlide, ImageSlider, type ImageSliderProps, InteractiveBook, type InteractiveBookProps, KnowledgeCheck, type KnowledgeCheckProps, Lesson, type LessonProps, type LessonkitConfig, type LessonkitObservabilityConfig, LessonkitProvider, type LessonkitProviderProps, type LessonkitRuntime, MarkTheWords, type MarkTheWordsProps, Page, type PageProps, ProgressTracker, type ProgressTrackerProps, Quiz, type QuizProps, Reflection, type ReflectionProps, Scenario, type ScenarioProps, Slide, SlideDeck, type SlideDeckProps, type SlideProps, Text, type TextProps, type ThemeContextValue, type ThemeMode, ThemeProvider, type ThemeProviderProps, type ThemeResolvedMode, TrueFalse, type TrueFalseProps, blockCatalogV2Version, blockCatalogV3Version, blockCatalogVersion, buildBlockCatalog, getBlockCatalogEntry, resetAssessmentWarningsForTests, resetQuizWarningsForTests, useAssessmentState, useCompletion, useLessonkit, useProgress, useQuizState, useTheme, useTracking };
+export { BLOCK_CATALOG, BLOCK_CATALOG_V2, BLOCK_CATALOG_V3, type BlockCatalogEntry, type BlockCatalogEntryV2, type BlockCatalogEntryV3, type BlockPropSpec, Course, type CourseProps, type KnowledgeCheckProps, Lesson, type LessonProps, type LessonkitConfig, type LessonkitObservabilityConfig, LessonkitProvider, type LessonkitProviderProps, type LessonkitRuntime, ProgressTracker, type ProgressTrackerProps, Reflection, type ReflectionProps, Scenario, type ScenarioProps, type ThemeContextValue, type ThemeMode, ThemeProvider, type ThemeProviderProps, type ThemeResolvedMode, assertProductionCourseConfig, blockCatalogV2Version, blockCatalogV3Version, blockCatalogVersion, buildBlockCatalog, getBlockCatalogEntry, shouldEnforceProductionGuard, useAssessmentState, useCompletion, useLessonkit, useProgress, useQuizState, useTheme, useTracking };