@lessonkit/react 1.0.0 → 1.0.1

package/block-catalog.v1.json

@@ -247,6 +247,12 @@
           "type": "string",
           "required": true,
           "description": "Correct choice value (must match one choice)."
+        },
+        {
+          "name": "passingScore",
+          "type": "number",
+          "required": false,
+          "description": "Minimum score required to pass (defaults to maxScore when omitted)."
         }
       ],
       "requiredIds": [

package/dist/index.cjs

@@ -70,8 +70,8 @@ var import_react2 = require("react");
 // src/provider/useLessonkitProviderRuntime.ts
 var import_react = require("react");
 var import_core8 = require("@lessonkit/core");
-var import_xapi3 = require("@lessonkit/xapi");
 var import_xapi4 = require("@lessonkit/xapi");
+var import_xapi5 = require("@lessonkit/xapi");
 
 // src/runtime/emitTelemetry.ts
 var import_core2 = require("@lessonkit/core");
@@ -169,6 +169,29 @@ function createXapiClientFromConfig(config, queue) {
 // src/runtime/session.ts
 var import_core5 = require("@lessonkit/core");
 
+// src/runtime/courseStartedPipeline.ts
+var import_xapi3 = require("@lessonkit/xapi");
+function emitCourseStartedNonTrackingPipeline(opts) {
+  let xapiStatementSent = false;
+  if (!opts.skipXapi && opts.xapi) {
+    const statement = (0, import_xapi3.telemetryEventToXAPIStatement)(opts.event);
+    if (statement) {
+      opts.xapi.send(statement);
+      xapiStatementSent = true;
+    }
+  }
+  forwardTelemetryToLxpack(opts.event, opts.lxpackBridge);
+  const emitCtx = {
+    courseId: opts.event.courseId,
+    sessionId: opts.event.sessionId,
+    attemptId: opts.event.attemptId
+  };
+  for (const sink of opts.extraSinks ?? []) {
+    sink.emit(opts.event, emitCtx);
+  }
+  return { xapiStatementSent };
+}
+
 // src/runtime/plugins.ts
 var import_core6 = require("@lessonkit/core");
 function createReactPluginHost(plugins) {
@@ -220,8 +243,9 @@ var defaultStorage = (0, import_core3.createSessionStoragePort)();
 function isTrackingActive(tracking) {
   return tracking?.enabled !== false;
 }
-var noopTrackingClient = { track: () => {
-} };
+function isCourseStartedSinkSettled(result) {
+  return result === "emitted";
+}
 function buildCourseStartedEvent(opts) {
   const pluginCtx = buildPluginContext({
     courseId: opts.courseId,
@@ -239,31 +263,27 @@ function buildCourseStartedEvent(opts) {
   return opts.pluginHost ? opts.pluginHost.runTelemetry(built, pluginCtx) : built;
 }
 function emitCourseStartedPipelineOnly(opts) {
-  const pluginCtx = buildPluginContext({
-    courseId: opts.courseId,
-    sessionId: opts.sessionId,
-    attemptId: opts.attemptId,
-    user: opts.user
-  });
   try {
-    emitTelemetryWithPlugins({
-      pluginHost: null,
-      tracking: noopTrackingClient,
-      xapi: opts.xapi,
+    const { xapiStatementSent } = emitCourseStartedNonTrackingPipeline({
       event: opts.event,
-      pluginCtx,
+      xapi: opts.xapi,
       lxpackBridge: opts.lxpackBridge,
-      extraSinks: opts.extraSinks
+      extraSinks: opts.extraSinks,
+      skipXapi: opts.skipXapi
     });
     (0, import_core5.markCourseStarted)(opts.storage, opts.sessionId, opts.courseId);
-    return true;
+    (0, import_core5.markCourseStartedPipelineDelivered)(opts.storage, opts.sessionId, opts.courseId);
+    if (xapiStatementSent) {
+      opts.onXapiStatementSent?.();
+    }
+    return "emitted";
   } catch {
-    return false;
+    return "failed";
   }
 }
 function emitCourseStarted(opts) {
   const event = buildCourseStartedEvent(opts);
-  if (event === null) return true;
+  if (event === null) return "filtered";
   const trackingAlreadyEmitted = (0, import_core5.hasCourseStartedEmittedToTracking)(
     opts.storage,
     opts.sessionId,
@@ -274,14 +294,19 @@ function emitCourseStarted(opts) {
       opts.tracking.track(event);
       (0, import_core5.markCourseStartedEmittedToTracking)(opts.storage, opts.sessionId, opts.courseId);
     } catch {
-      return false;
+      return "failed";
     }
   }
-  return emitCourseStartedPipelineOnly({ ...opts, event });
+  return emitCourseStartedPipelineOnly({
+    ...opts,
+    event,
+    skipXapi: opts.skipXapi,
+    onXapiStatementSent: opts.onXapiStatementSent
+  });
 }
 function emitCourseStartedToTrackingOnly(opts) {
   const event = buildCourseStartedEvent(opts);
-  if (event === null) return true;
+  if (event === null) return "filtered";
   const trackingAlreadyEmitted = (0, import_core5.hasCourseStartedEmittedToTracking)(
     opts.storage,
     opts.sessionId,
@@ -292,28 +317,21 @@ function emitCourseStartedToTrackingOnly(opts) {
       opts.tracking.track(event);
       (0, import_core5.markCourseStartedEmittedToTracking)(opts.storage, opts.sessionId, opts.courseId);
     } catch {
-      return false;
+      return "failed";
     }
   }
-  const pluginCtx = buildPluginContext({
-    courseId: opts.courseId,
-    sessionId: opts.sessionId,
-    attemptId: opts.attemptId,
-    user: opts.user
-  });
   try {
-    emitTelemetryWithPlugins({
-      pluginHost: null,
-      tracking: noopTrackingClient,
-      xapi: null,
+    emitCourseStartedNonTrackingPipeline({
       event,
-      pluginCtx,
+      xapi: null,
       lxpackBridge: opts.lxpackBridge,
-      extraSinks: opts.extraSinks
+      extraSinks: opts.extraSinks,
+      skipXapi: true
     });
-    return true;
+    (0, import_core5.markCourseStartedPipelineDelivered)(opts.storage, opts.sessionId, opts.courseId);
+    return "emitted";
   } catch {
-    return false;
+    return "failed";
   }
 }
 function emitPendingCourseStarted(opts) {
@@ -328,13 +346,28 @@ function emitPendingCourseStarted(opts) {
   }
   if (trackingEmitted && !sessionStarted) {
     const event = buildCourseStartedEvent(opts);
-    if (event === null) return true;
+    if (event === null) return "filtered";
     return emitCourseStartedPipelineOnly({ ...opts, event });
   }
   if (!trackingEmitted && !sessionStarted) {
     return emitCourseStarted(opts);
   }
-  return true;
+  const pipelineDelivered = (0, import_core5.hasCourseStartedPipelineDelivered)(
+    opts.storage,
+    opts.sessionId,
+    opts.courseId
+  );
+  if (sessionStarted && trackingEmitted && !pipelineDelivered) {
+    const event = buildCourseStartedEvent(opts);
+    if (event === null) return "filtered";
+    return emitCourseStartedPipelineOnly({
+      ...opts,
+      event,
+      skipXapi: opts.skipXapi,
+      onXapiStatementSent: opts.onXapiStatementSent
+    });
+  }
+  return "emitted";
 }
 function assertTrackingSinkConfig(tracking) {
   if (!tracking?.sink || !tracking?.batchSink) return;
@@ -421,7 +454,7 @@ function useLessonkitProviderRuntime(config) {
   }, []);
   const activeLessonIdRef = (0, import_react.useRef)(progress.activeLessonId);
   activeLessonIdRef.current = progress.activeLessonId;
-  const xapiQueueRef = (0, import_react.useRef)((0, import_xapi3.createInMemoryXAPIQueue)());
+  const xapiQueueRef = (0, import_react.useRef)((0, import_xapi4.createInMemoryXAPIQueue)());
   const xapiRef = (0, import_react.useRef)(null);
   const [xapi, setXapi] = (0, import_react.useState)(null);
   const prevXapiCourseIdRef = (0, import_react.useRef)(normalizedCourseId);
@@ -442,7 +475,7 @@ function useLessonkitProviderRuntime(config) {
         }
         void xapiRef.current?.flush();
       }
-      xapiQueueRef.current = (0, import_xapi3.createInMemoryXAPIQueue)();
+      xapiQueueRef.current = (0, import_xapi4.createInMemoryXAPIQueue)();
       prevXapiCourseIdRef.current = courseId;
       xapiCourseStartedSentOnClientRef.current = false;
     }
@@ -460,21 +493,24 @@ function useLessonkitProviderRuntime(config) {
       const needsBootstrap = !skipBootstrap && !xapiCourseStartedSentOnClientRef.current && (!alreadyStarted || clientChanged);
       if (needsBootstrap) {
         try {
-          const statement = (0, import_xapi4.telemetryEventToXAPIStatement)(
-            (0, import_core2.buildTelemetryEvent)({
-              name: "course_started",
-              courseId: cid,
-              sessionId,
-              attemptId: attemptIdRef.current,
-              user: userRef.current
-            })
-          );
-          if (statement) {
-            next.send(statement);
-            if (!alreadyStarted) {
-              (0, import_core5.markCourseStarted)(defaultStorage, sessionId, cid);
+          const event = buildCourseStartedEvent({
+            pluginHost: pluginHostRef.current,
+            courseId: cid,
+            sessionId,
+            attemptId: attemptIdRef.current,
+            user: userRef.current,
+            lxpackBridge: lxpackBridgeModeRef.current
+          });
+          if (event === null) {
+          } else {
+            const statement = (0, import_xapi5.telemetryEventToXAPIStatement)(event);
+            if (statement) {
+              next.send(statement);
+              if (!alreadyStarted) {
+                (0, import_core5.markCourseStarted)(defaultStorage, sessionId, cid);
+              }
+              xapiCourseStartedSentOnClientRef.current = true;
             }
-            xapiCourseStartedSentOnClientRef.current = true;
           }
         } catch {
         }
@@ -548,7 +584,7 @@ function useLessonkitProviderRuntime(config) {
     if (!trackingActive) {
       courseStartedEmittedToSinkRef.current = false;
     } else if (!courseStartedEmittedToSinkRef.current) {
-      const emitted = emitPendingCourseStarted({
+      const result = emitPendingCourseStarted({
         pluginHost: pluginHostRef.current,
         tracking: next,
         xapi: xapiRef.current,
@@ -558,12 +594,13 @@ function useLessonkitProviderRuntime(config) {
         attemptId: attemptIdRef.current,
         user: userRef.current,
         lxpackBridge: lxpackBridgeModeRef.current,
-        extraSinks: extraSinksRef.current
+        extraSinks: extraSinksRef.current,
+        skipXapi: xapiCourseStartedSentOnClientRef.current,
+        onXapiStatementSent: () => {
+          xapiCourseStartedSentOnClientRef.current = true;
+        }
       });
-      if (emitted) {
-        (0, import_core5.markCourseStartedEmittedToTracking)(defaultStorage, sessionId, cid);
-      }
-      courseStartedEmittedToSinkRef.current = emitted;
+      courseStartedEmittedToSinkRef.current = isCourseStartedSinkSettled(result);
     } else if (trackingActive) {
       courseStartedEmittedToSinkRef.current = true;
     }
@@ -644,7 +681,7 @@ function useLessonkitProviderRuntime(config) {
       } catch {
       }
       if (!courseStartedEmittedToSinkRef.current) {
-        const emitted = emitPendingCourseStarted({
+        const result = emitPendingCourseStarted({
           pluginHost: pluginHostRef.current,
           tracking: trackingRef.current,
           xapi: xapiRef.current,
@@ -656,7 +693,7 @@ function useLessonkitProviderRuntime(config) {
           lxpackBridge: lxpackBridgeModeRef.current,
           extraSinks: extraSinksRef.current
         });
-        courseStartedEmittedToSinkRef.current = emitted;
+        courseStartedEmittedToSinkRef.current = isCourseStartedSinkSettled(result);
       }
     })();
   }, [normalizedCourseId, normalizedConfig.tracking?.enabled, syncProgress]);
@@ -893,6 +930,10 @@ function isDevEnvironment3() {
   return typeof g.process !== "undefined" && g.process.env?.NODE_ENV !== "production";
 }
 function normalizeComponentId(id, path) {
+  if (path === "courseId") return (0, import_core9.assertValidId)(id, "courseId");
+  if (path === "lessonId") return (0, import_core9.assertValidId)(id, "lessonId");
+  if (path === "checkId") return (0, import_core9.assertValidId)(id, "checkId");
+  if (path === "blockId") return (0, import_core9.assertValidId)(id, "blockId");
   return (0, import_core9.assertValidId)(id, path);
 }
 
@@ -1386,7 +1427,13 @@ var BLOCK_CATALOG = [
       { name: "checkId", type: "CheckId", required: true, description: "Stable check identifier for telemetry and LXPack assessments." },
       { name: "question", type: "string", required: true, description: "Question text shown above choices." },
       { name: "choices", type: "string[]", required: true, description: "Radio button choice labels." },
-      { name: "answer", type: "string", required: true, description: "Correct choice value (must match one choice)." }
+      { name: "answer", type: "string", required: true, description: "Correct choice value (must match one choice)." },
+      {
+        name: "passingScore",
+        type: "number",
+        required: false,
+        description: "Minimum score required to pass (defaults to maxScore when omitted)."
+      }
     ],
     requiredIds: ["checkId"],
     parentConstraints: ["Lesson"],

package/dist/index.d.cts

@@ -1,9 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 import * as _lessonkit_core from '@lessonkit/core';
-import { CourseId, TelemetryUser, TrackingClient, LessonkitPlugin, ProgressState, LessonId, TelemetryEventName, PluginHost, CheckId, BlockId } from '@lessonkit/core';
+import { CourseId, TelemetryUser, TrackingClient, LessonkitPlugin, ProgressState, LessonId, TelemetryEventName, TelemetryDataFor, PluginHost, BlockId, CheckId } from '@lessonkit/core';
 export { AssessmentScoreInput, AssessmentScoreResult, InteractionBlockRegistration, LessonkitPlugin, LessonkitPluginContext, LessonkitPluginKind, PluginHost, PluginRegistry, TelemetryPipelineSink, buildTelemetryEvent, createLessonkitRuntime, createPluginRegistry, createTelemetryPipeline, defineAssessmentPlugin, defineLifecyclePlugin, defineTelemetryPlugin } from '@lessonkit/core';
+import { AssessmentDescriptor } from '@lessonkit/lxpack';
 import { XAPITransport, XAPIClient } from '@lessonkit/xapi';
+import { LxpackBridgeMode } from '@lessonkit/lxpack/bridge';
 import { LessonkitThemeV1, ThemePresetName, PartialLessonkitThemeV1 } from '@lessonkit/themes';
 export { ThemePresetName } from '@lessonkit/themes';
 
@@ -31,7 +33,7 @@ type LessonkitConfig = {
     };
     lxpack?: {
         /** Forward completion events to `window.parent.lxpackBridge.v1` when embedded (default `auto`). */
-        bridge?: "auto" | "off";
+        bridge?: LxpackBridgeMode;
     };
     /** Framework plugins (analytics, LMS, assessment, interaction, AI). */
     plugins?: LessonkitPlugin[];
@@ -41,6 +43,10 @@ type LessonkitConfig = {
     sinks?: _lessonkit_core.TelemetryPipelineSink[];
 };
 
+type LessonkitProviderProps = {
+    config: LessonkitConfig;
+    children: React.ReactNode;
+};
 type LessonkitRuntime = {
     config: LessonkitConfig;
     tracking: TrackingClient;
@@ -54,65 +60,57 @@ type LessonkitRuntime = {
     setActiveLesson: (lessonId: LessonId) => void;
     completeLesson: (lessonId: LessonId) => void;
     completeCourse: () => void;
-    track: (name: TelemetryEventName, data?: unknown, opts?: {
+    track: <N extends TelemetryEventName>(name: N, data?: TelemetryDataFor<N>, opts?: {
         lessonId?: LessonId;
     }) => void;
     plugins: PluginHost | null;
 };
-declare function LessonkitProvider(props: {
-    config: LessonkitConfig;
-    children: React.ReactNode;
-}): react_jsx_runtime.JSX.Element;
+declare function LessonkitProvider(props: LessonkitProviderProps): react_jsx_runtime.JSX.Element;
 
 /** @internal Reset module warnings between tests. */
 declare function resetQuizWarningsForTests(): void;
-declare function Course(props: {
+type CourseProps = {
     title: string;
     courseId: CourseId;
-    config?: Omit<React.ComponentProps<typeof LessonkitProvider>["config"], "courseId">;
+    config?: Omit<LessonkitConfig, "courseId">;
     children: React.ReactNode;
-}): react_jsx_runtime.JSX.Element;
-declare function Lesson(props: {
+};
+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.ReactNode;
-}): react_jsx_runtime.JSX.Element;
-declare function Scenario(props: {
+};
+type ScenarioProps = {
     blockId?: BlockId;
     children: React.ReactNode;
-}): react_jsx_runtime.JSX.Element;
-declare function Reflection(props: {
+};
+type ReflectionProps = {
     blockId?: BlockId;
     prompt?: string;
     hint?: string;
     value?: string;
     onChange?: (value: string) => void;
     children?: React.ReactNode;
-}): react_jsx_runtime.JSX.Element;
-declare function KnowledgeCheck(props: {
-    checkId: CheckId;
-    question: string;
-    choices: string[];
-    answer: string;
-    passingScore?: number;
-}): react_jsx_runtime.JSX.Element;
-declare function Quiz(props: {
-    checkId: CheckId;
-    question: string;
-    choices: string[];
-    answer: string;
-    passingScore?: number;
-}): react_jsx_runtime.JSX.Element;
-declare function ProgressTracker(props: {
+};
+type QuizProps = AssessmentDescriptor;
+type KnowledgeCheckProps = AssessmentDescriptor;
+type ProgressTrackerProps = {
     totalLessons?: number;
-}): react_jsx_runtime.JSX.Element;
+};
+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 KnowledgeCheck(props: KnowledgeCheckProps): react_jsx_runtime.JSX.Element;
+declare function Quiz(props: QuizProps): react_jsx_runtime.JSX.Element;
+declare function ProgressTracker(props: ProgressTrackerProps): react_jsx_runtime.JSX.Element;
 
 declare function useLessonkit(): LessonkitRuntime;
 declare function useProgress(): _lessonkit_core.ProgressState;
 declare function useTracking(): {
-    track: (name: _lessonkit_core.TelemetryEventName, data?: unknown, opts?: {
+    track: <N extends _lessonkit_core.TelemetryEventName>(name: N, data?: _lessonkit_core.TelemetryDataFor<N>, opts?: {
         lessonId?: LessonId;
     }) => void;
 };
@@ -189,8 +187,214 @@ type BlockCatalogEntry = {
         manualTracking?: string;
     };
 };
-declare const BLOCK_CATALOG: BlockCatalogEntry[];
+declare const BLOCK_CATALOG: ({
+    type: string;
+    category: "container";
+    description: string;
+    props: ({
+        name: string;
+        type: string;
+        required: true;
+        description: string;
+    } | {
+        name: string;
+        type: string;
+        required: false;
+        description: string;
+    })[];
+    requiredIds: string[];
+    a11y: {
+        element: string;
+        ariaLabel: string;
+        keyboard: string;
+        notes: string;
+        liveRegions?: undefined;
+    };
+    theming: {
+        surface: "global-inherit";
+        stylingNotes: string;
+        dataAttributes?: undefined;
+    };
+    telemetry: {
+        emits: string[];
+        manualTracking?: undefined;
+        requiresActiveLesson?: undefined;
+    };
+    parentConstraints?: undefined;
+    optionalIds?: undefined;
+    aliases?: undefined;
+} | {
+    type: string;
+    category: "container";
+    description: string;
+    props: ({
+        name: string;
+        type: string;
+        required: true;
+        description: string;
+    } | {
+        name: string;
+        type: string;
+        required: false;
+        description: string;
+    })[];
+    requiredIds: string[];
+    parentConstraints: string[];
+    a11y: {
+        element: string;
+        ariaLabel: string;
+        keyboard: string;
+        notes: string;
+        liveRegions?: undefined;
+    };
+    theming: {
+        surface: "global-inherit";
+        stylingNotes: string;
+        dataAttributes?: undefined;
+    };
+    telemetry: {
+        emits: string[];
+        manualTracking?: undefined;
+        requiresActiveLesson?: undefined;
+    };
+    optionalIds?: undefined;
+    aliases?: undefined;
+} | {
+    type: string;
+    category: "content";
+    description: string;
+    props: ({
+        name: string;
+        type: string;
+        required: false;
+        description: string;
+    } | {
+        name: string;
+        type: string;
+        required: true;
+        description: string;
+    })[];
+    requiredIds: never[];
+    optionalIds: string[];
+    parentConstraints: string[];
+    a11y: {
+        element: string;
+        ariaLabel: string;
+        keyboard: string;
+        notes: string;
+        liveRegions?: undefined;
+    };
+    theming: {
+        surface: "global-inherit";
+        dataAttributes: string[];
+        stylingNotes: string;
+    };
+    telemetry: {
+        emits: never[];
+        manualTracking: string;
+        requiresActiveLesson?: undefined;
+    };
+    aliases?: undefined;
+} | {
+    type: string;
+    category: "content";
+    description: string;
+    props: {
+        name: string;
+        type: string;
+        required: false;
+        description: string;
+    }[];
+    requiredIds: never[];
+    optionalIds: string[];
+    parentConstraints: string[];
+    a11y: {
+        element: string;
+        ariaLabel: string;
+        keyboard: string;
+        notes: string;
+        liveRegions?: undefined;
+    };
+    theming: {
+        surface: "global-inherit";
+        dataAttributes: string[];
+        stylingNotes: string;
+    };
+    telemetry: {
+        emits: never[];
+        requiresActiveLesson: true;
+        manualTracking: string;
+    };
+    aliases?: undefined;
+} | {
+    type: string;
+    aliases: string[];
+    category: "assessment";
+    description: string;
+    props: ({
+        name: string;
+        type: string;
+        required: true;
+        description: string;
+    } | {
+        name: string;
+        type: string;
+        required: false;
+        description: string;
+    })[];
+    requiredIds: string[];
+    parentConstraints: string[];
+    a11y: {
+        element: string;
+        ariaLabel: string;
+        keyboard: string;
+        liveRegions: string;
+        notes: string;
+    };
+    theming: {
+        surface: "global-inherit";
+        dataAttributes: string[];
+        stylingNotes: string;
+    };
+    telemetry: {
+        emits: string[];
+        requiresActiveLesson: true;
+        manualTracking?: undefined;
+    };
+    optionalIds?: undefined;
+} | {
+    type: string;
+    category: "chrome";
+    description: string;
+    props: {
+        name: string;
+        type: string;
+        required: false;
+        description: string;
+    }[];
+    requiredIds: never[];
+    parentConstraints: string[];
+    a11y: {
+        element: string;
+        ariaLabel: string;
+        keyboard: string;
+        notes: string;
+        liveRegions?: undefined;
+    };
+    theming: {
+        surface: "global-inherit";
+        stylingNotes: string;
+        dataAttributes?: undefined;
+    };
+    telemetry: {
+        emits: never[];
+        manualTracking?: undefined;
+        requiresActiveLesson?: undefined;
+    };
+    optionalIds?: undefined;
+    aliases?: undefined;
+})[];
 declare function buildBlockCatalog(): BlockCatalogEntry[];
 declare function getBlockCatalogEntry(type: string): BlockCatalogEntry | undefined;
 
-export { BLOCK_CATALOG, type BlockCatalogEntry, type BlockPropSpec, Course, KnowledgeCheck, Lesson, type LessonkitConfig, LessonkitProvider, type LessonkitRuntime, ProgressTracker, Quiz, Reflection, Scenario, type ThemeContextValue, type ThemeMode, ThemeProvider, type ThemeProviderProps, type ThemeResolvedMode, blockCatalogVersion, buildBlockCatalog, getBlockCatalogEntry, resetQuizWarningsForTests, useCompletion, useLessonkit, useProgress, useQuizState, useTheme, useTracking };
+export { BLOCK_CATALOG, type BlockCatalogEntry, type BlockPropSpec, Course, type CourseProps, KnowledgeCheck, type KnowledgeCheckProps, Lesson, type LessonProps, type LessonkitConfig, LessonkitProvider, type LessonkitProviderProps, type LessonkitRuntime, ProgressTracker, type ProgressTrackerProps, Quiz, type QuizProps, Reflection, type ReflectionProps, Scenario, type ScenarioProps, type ThemeContextValue, type ThemeMode, ThemeProvider, type ThemeProviderProps, type ThemeResolvedMode, blockCatalogVersion, buildBlockCatalog, getBlockCatalogEntry, resetQuizWarningsForTests, useCompletion, useLessonkit, useProgress, useQuizState, useTheme, useTracking };

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 import * as _lessonkit_core from '@lessonkit/core';
-import { CourseId, TelemetryUser, TrackingClient, LessonkitPlugin, ProgressState, LessonId, TelemetryEventName, PluginHost, CheckId, BlockId } from '@lessonkit/core';
+import { CourseId, TelemetryUser, TrackingClient, LessonkitPlugin, ProgressState, LessonId, TelemetryEventName, TelemetryDataFor, PluginHost, BlockId, CheckId } from '@lessonkit/core';
 export { AssessmentScoreInput, AssessmentScoreResult, InteractionBlockRegistration, LessonkitPlugin, LessonkitPluginContext, LessonkitPluginKind, PluginHost, PluginRegistry, TelemetryPipelineSink, buildTelemetryEvent, createLessonkitRuntime, createPluginRegistry, createTelemetryPipeline, defineAssessmentPlugin, defineLifecyclePlugin, defineTelemetryPlugin } from '@lessonkit/core';
+import { AssessmentDescriptor } from '@lessonkit/lxpack';
 import { XAPITransport, XAPIClient } from '@lessonkit/xapi';
+import { LxpackBridgeMode } from '@lessonkit/lxpack/bridge';
 import { LessonkitThemeV1, ThemePresetName, PartialLessonkitThemeV1 } from '@lessonkit/themes';
 export { ThemePresetName } from '@lessonkit/themes';
 
@@ -31,7 +33,7 @@ type LessonkitConfig = {
     };
     lxpack?: {
         /** Forward completion events to `window.parent.lxpackBridge.v1` when embedded (default `auto`). */
-        bridge?: "auto" | "off";
+        bridge?: LxpackBridgeMode;
     };
     /** Framework plugins (analytics, LMS, assessment, interaction, AI). */
     plugins?: LessonkitPlugin[];
@@ -41,6 +43,10 @@ type LessonkitConfig = {
     sinks?: _lessonkit_core.TelemetryPipelineSink[];
 };
 
+type LessonkitProviderProps = {
+    config: LessonkitConfig;
+    children: React.ReactNode;
+};
 type LessonkitRuntime = {
     config: LessonkitConfig;
     tracking: TrackingClient;
@@ -54,65 +60,57 @@ type LessonkitRuntime = {
     setActiveLesson: (lessonId: LessonId) => void;
     completeLesson: (lessonId: LessonId) => void;
     completeCourse: () => void;
-    track: (name: TelemetryEventName, data?: unknown, opts?: {
+    track: <N extends TelemetryEventName>(name: N, data?: TelemetryDataFor<N>, opts?: {
         lessonId?: LessonId;
     }) => void;
     plugins: PluginHost | null;
 };
-declare function LessonkitProvider(props: {
-    config: LessonkitConfig;
-    children: React.ReactNode;
-}): react_jsx_runtime.JSX.Element;
+declare function LessonkitProvider(props: LessonkitProviderProps): react_jsx_runtime.JSX.Element;
 
 /** @internal Reset module warnings between tests. */
 declare function resetQuizWarningsForTests(): void;
-declare function Course(props: {
+type CourseProps = {
     title: string;
     courseId: CourseId;
-    config?: Omit<React.ComponentProps<typeof LessonkitProvider>["config"], "courseId">;
+    config?: Omit<LessonkitConfig, "courseId">;
     children: React.ReactNode;
-}): react_jsx_runtime.JSX.Element;
-declare function Lesson(props: {
+};
+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.ReactNode;
-}): react_jsx_runtime.JSX.Element;
-declare function Scenario(props: {
+};
+type ScenarioProps = {
     blockId?: BlockId;
     children: React.ReactNode;
-}): react_jsx_runtime.JSX.Element;
-declare function Reflection(props: {
+};
+type ReflectionProps = {
     blockId?: BlockId;
     prompt?: string;
     hint?: string;
     value?: string;
     onChange?: (value: string) => void;
     children?: React.ReactNode;
-}): react_jsx_runtime.JSX.Element;
-declare function KnowledgeCheck(props: {
-    checkId: CheckId;
-    question: string;
-    choices: string[];
-    answer: string;
-    passingScore?: number;
-}): react_jsx_runtime.JSX.Element;
-declare function Quiz(props: {
-    checkId: CheckId;
-    question: string;
-    choices: string[];
-    answer: string;
-    passingScore?: number;
-}): react_jsx_runtime.JSX.Element;
-declare function ProgressTracker(props: {
+};
+type QuizProps = AssessmentDescriptor;
+type KnowledgeCheckProps = AssessmentDescriptor;
+type ProgressTrackerProps = {
     totalLessons?: number;
-}): react_jsx_runtime.JSX.Element;
+};
+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 KnowledgeCheck(props: KnowledgeCheckProps): react_jsx_runtime.JSX.Element;
+declare function Quiz(props: QuizProps): react_jsx_runtime.JSX.Element;
+declare function ProgressTracker(props: ProgressTrackerProps): react_jsx_runtime.JSX.Element;
 
 declare function useLessonkit(): LessonkitRuntime;
 declare function useProgress(): _lessonkit_core.ProgressState;
 declare function useTracking(): {
-    track: (name: _lessonkit_core.TelemetryEventName, data?: unknown, opts?: {
+    track: <N extends _lessonkit_core.TelemetryEventName>(name: N, data?: _lessonkit_core.TelemetryDataFor<N>, opts?: {
         lessonId?: LessonId;
     }) => void;
 };
@@ -189,8 +187,214 @@ type BlockCatalogEntry = {
         manualTracking?: string;
     };
 };
-declare const BLOCK_CATALOG: BlockCatalogEntry[];
+declare const BLOCK_CATALOG: ({
+    type: string;
+    category: "container";
+    description: string;
+    props: ({
+        name: string;
+        type: string;
+        required: true;
+        description: string;
+    } | {
+        name: string;
+        type: string;
+        required: false;
+        description: string;
+    })[];
+    requiredIds: string[];
+    a11y: {
+        element: string;
+        ariaLabel: string;
+        keyboard: string;
+        notes: string;
+        liveRegions?: undefined;
+    };
+    theming: {
+        surface: "global-inherit";
+        stylingNotes: string;
+        dataAttributes?: undefined;
+    };
+    telemetry: {
+        emits: string[];
+        manualTracking?: undefined;
+        requiresActiveLesson?: undefined;
+    };
+    parentConstraints?: undefined;
+    optionalIds?: undefined;
+    aliases?: undefined;
+} | {
+    type: string;
+    category: "container";
+    description: string;
+    props: ({
+        name: string;
+        type: string;
+        required: true;
+        description: string;
+    } | {
+        name: string;
+        type: string;
+        required: false;
+        description: string;
+    })[];
+    requiredIds: string[];
+    parentConstraints: string[];
+    a11y: {
+        element: string;
+        ariaLabel: string;
+        keyboard: string;
+        notes: string;
+        liveRegions?: undefined;
+    };
+    theming: {
+        surface: "global-inherit";
+        stylingNotes: string;
+        dataAttributes?: undefined;
+    };
+    telemetry: {
+        emits: string[];
+        manualTracking?: undefined;
+        requiresActiveLesson?: undefined;
+    };
+    optionalIds?: undefined;
+    aliases?: undefined;
+} | {
+    type: string;
+    category: "content";
+    description: string;
+    props: ({
+        name: string;
+        type: string;
+        required: false;
+        description: string;
+    } | {
+        name: string;
+        type: string;
+        required: true;
+        description: string;
+    })[];
+    requiredIds: never[];
+    optionalIds: string[];
+    parentConstraints: string[];
+    a11y: {
+        element: string;
+        ariaLabel: string;
+        keyboard: string;
+        notes: string;
+        liveRegions?: undefined;
+    };
+    theming: {
+        surface: "global-inherit";
+        dataAttributes: string[];
+        stylingNotes: string;
+    };
+    telemetry: {
+        emits: never[];
+        manualTracking: string;
+        requiresActiveLesson?: undefined;
+    };
+    aliases?: undefined;
+} | {
+    type: string;
+    category: "content";
+    description: string;
+    props: {
+        name: string;
+        type: string;
+        required: false;
+        description: string;
+    }[];
+    requiredIds: never[];
+    optionalIds: string[];
+    parentConstraints: string[];
+    a11y: {
+        element: string;
+        ariaLabel: string;
+        keyboard: string;
+        notes: string;
+        liveRegions?: undefined;
+    };
+    theming: {
+        surface: "global-inherit";
+        dataAttributes: string[];
+        stylingNotes: string;
+    };
+    telemetry: {
+        emits: never[];
+        requiresActiveLesson: true;
+        manualTracking: string;
+    };
+    aliases?: undefined;
+} | {
+    type: string;
+    aliases: string[];
+    category: "assessment";
+    description: string;
+    props: ({
+        name: string;
+        type: string;
+        required: true;
+        description: string;
+    } | {
+        name: string;
+        type: string;
+        required: false;
+        description: string;
+    })[];
+    requiredIds: string[];
+    parentConstraints: string[];
+    a11y: {
+        element: string;
+        ariaLabel: string;
+        keyboard: string;
+        liveRegions: string;
+        notes: string;
+    };
+    theming: {
+        surface: "global-inherit";
+        dataAttributes: string[];
+        stylingNotes: string;
+    };
+    telemetry: {
+        emits: string[];
+        requiresActiveLesson: true;
+        manualTracking?: undefined;
+    };
+    optionalIds?: undefined;
+} | {
+    type: string;
+    category: "chrome";
+    description: string;
+    props: {
+        name: string;
+        type: string;
+        required: false;
+        description: string;
+    }[];
+    requiredIds: never[];
+    parentConstraints: string[];
+    a11y: {
+        element: string;
+        ariaLabel: string;
+        keyboard: string;
+        notes: string;
+        liveRegions?: undefined;
+    };
+    theming: {
+        surface: "global-inherit";
+        stylingNotes: string;
+        dataAttributes?: undefined;
+    };
+    telemetry: {
+        emits: never[];
+        manualTracking?: undefined;
+        requiresActiveLesson?: undefined;
+    };
+    optionalIds?: undefined;
+    aliases?: undefined;
+})[];
 declare function buildBlockCatalog(): BlockCatalogEntry[];
 declare function getBlockCatalogEntry(type: string): BlockCatalogEntry | undefined;
 
-export { BLOCK_CATALOG, type BlockCatalogEntry, type BlockPropSpec, Course, KnowledgeCheck, Lesson, type LessonkitConfig, LessonkitProvider, type LessonkitRuntime, ProgressTracker, Quiz, Reflection, Scenario, type ThemeContextValue, type ThemeMode, ThemeProvider, type ThemeProviderProps, type ThemeResolvedMode, blockCatalogVersion, buildBlockCatalog, getBlockCatalogEntry, resetQuizWarningsForTests, useCompletion, useLessonkit, useProgress, useQuizState, useTheme, useTracking };
+export { BLOCK_CATALOG, type BlockCatalogEntry, type BlockPropSpec, Course, type CourseProps, KnowledgeCheck, type KnowledgeCheckProps, Lesson, type LessonProps, type LessonkitConfig, LessonkitProvider, type LessonkitProviderProps, type LessonkitRuntime, ProgressTracker, type ProgressTrackerProps, Quiz, type QuizProps, Reflection, type ReflectionProps, Scenario, type ScenarioProps, type ThemeContextValue, type ThemeMode, ThemeProvider, type ThemeProviderProps, type ThemeResolvedMode, blockCatalogVersion, buildBlockCatalog, getBlockCatalogEntry, resetQuizWarningsForTests, useCompletion, useLessonkit, useProgress, useQuizState, useTheme, useTracking };

package/dist/index.js

@@ -16,7 +16,7 @@ import {
 } from "react";
 import { createLessonkitRuntime, createTrackingClient as createTrackingClient2, assertValidId } from "@lessonkit/core";
 import { createInMemoryXAPIQueue } from "@lessonkit/xapi";
-import { telemetryEventToXAPIStatement as telemetryEventToXAPIStatement2 } from "@lessonkit/xapi";
+import { telemetryEventToXAPIStatement as telemetryEventToXAPIStatement3 } from "@lessonkit/xapi";
 
 // src/runtime/emitTelemetry.ts
 import { buildTelemetryEvent, tryBuildTelemetryEvent } from "@lessonkit/core";
@@ -135,9 +135,34 @@ import {
   markCourseStarted,
   hasCourseStartedEmittedToTracking,
   markCourseStartedEmittedToTracking,
+  hasCourseStartedPipelineDelivered,
+  markCourseStartedPipelineDelivered,
   migrateCourseStartedMark
 } from "@lessonkit/core";
 
+// src/runtime/courseStartedPipeline.ts
+import { telemetryEventToXAPIStatement as telemetryEventToXAPIStatement2 } from "@lessonkit/xapi";
+function emitCourseStartedNonTrackingPipeline(opts) {
+  let xapiStatementSent = false;
+  if (!opts.skipXapi && opts.xapi) {
+    const statement = telemetryEventToXAPIStatement2(opts.event);
+    if (statement) {
+      opts.xapi.send(statement);
+      xapiStatementSent = true;
+    }
+  }
+  forwardTelemetryToLxpack(opts.event, opts.lxpackBridge);
+  const emitCtx = {
+    courseId: opts.event.courseId,
+    sessionId: opts.event.sessionId,
+    attemptId: opts.event.attemptId
+  };
+  for (const sink of opts.extraSinks ?? []) {
+    sink.emit(opts.event, emitCtx);
+  }
+  return { xapiStatementSent };
+}
+
 // src/runtime/plugins.ts
 import { createPluginRegistry } from "@lessonkit/core";
 function createReactPluginHost(plugins) {
@@ -189,8 +214,9 @@ var defaultStorage = createSessionStoragePort();
 function isTrackingActive(tracking) {
   return tracking?.enabled !== false;
 }
-var noopTrackingClient = { track: () => {
-} };
+function isCourseStartedSinkSettled(result) {
+  return result === "emitted";
+}
 function buildCourseStartedEvent(opts) {
   const pluginCtx = buildPluginContext({
     courseId: opts.courseId,
@@ -208,31 +234,27 @@ function buildCourseStartedEvent(opts) {
   return opts.pluginHost ? opts.pluginHost.runTelemetry(built, pluginCtx) : built;
 }
 function emitCourseStartedPipelineOnly(opts) {
-  const pluginCtx = buildPluginContext({
-    courseId: opts.courseId,
-    sessionId: opts.sessionId,
-    attemptId: opts.attemptId,
-    user: opts.user
-  });
   try {
-    emitTelemetryWithPlugins({
-      pluginHost: null,
-      tracking: noopTrackingClient,
-      xapi: opts.xapi,
+    const { xapiStatementSent } = emitCourseStartedNonTrackingPipeline({
       event: opts.event,
-      pluginCtx,
+      xapi: opts.xapi,
       lxpackBridge: opts.lxpackBridge,
-      extraSinks: opts.extraSinks
+      extraSinks: opts.extraSinks,
+      skipXapi: opts.skipXapi
     });
     markCourseStarted(opts.storage, opts.sessionId, opts.courseId);
-    return true;
+    markCourseStartedPipelineDelivered(opts.storage, opts.sessionId, opts.courseId);
+    if (xapiStatementSent) {
+      opts.onXapiStatementSent?.();
+    }
+    return "emitted";
   } catch {
-    return false;
+    return "failed";
   }
 }
 function emitCourseStarted(opts) {
   const event = buildCourseStartedEvent(opts);
-  if (event === null) return true;
+  if (event === null) return "filtered";
   const trackingAlreadyEmitted = hasCourseStartedEmittedToTracking(
     opts.storage,
     opts.sessionId,
@@ -243,14 +265,19 @@ function emitCourseStarted(opts) {
       opts.tracking.track(event);
       markCourseStartedEmittedToTracking(opts.storage, opts.sessionId, opts.courseId);
     } catch {
-      return false;
+      return "failed";
     }
   }
-  return emitCourseStartedPipelineOnly({ ...opts, event });
+  return emitCourseStartedPipelineOnly({
+    ...opts,
+    event,
+    skipXapi: opts.skipXapi,
+    onXapiStatementSent: opts.onXapiStatementSent
+  });
 }
 function emitCourseStartedToTrackingOnly(opts) {
   const event = buildCourseStartedEvent(opts);
-  if (event === null) return true;
+  if (event === null) return "filtered";
   const trackingAlreadyEmitted = hasCourseStartedEmittedToTracking(
     opts.storage,
     opts.sessionId,
@@ -261,28 +288,21 @@ function emitCourseStartedToTrackingOnly(opts) {
       opts.tracking.track(event);
       markCourseStartedEmittedToTracking(opts.storage, opts.sessionId, opts.courseId);
     } catch {
-      return false;
+      return "failed";
     }
   }
-  const pluginCtx = buildPluginContext({
-    courseId: opts.courseId,
-    sessionId: opts.sessionId,
-    attemptId: opts.attemptId,
-    user: opts.user
-  });
   try {
-    emitTelemetryWithPlugins({
-      pluginHost: null,
-      tracking: noopTrackingClient,
-      xapi: null,
+    emitCourseStartedNonTrackingPipeline({
       event,
-      pluginCtx,
+      xapi: null,
       lxpackBridge: opts.lxpackBridge,
-      extraSinks: opts.extraSinks
+      extraSinks: opts.extraSinks,
+      skipXapi: true
     });
-    return true;
+    markCourseStartedPipelineDelivered(opts.storage, opts.sessionId, opts.courseId);
+    return "emitted";
   } catch {
-    return false;
+    return "failed";
   }
 }
 function emitPendingCourseStarted(opts) {
@@ -297,13 +317,28 @@ function emitPendingCourseStarted(opts) {
   }
   if (trackingEmitted && !sessionStarted) {
     const event = buildCourseStartedEvent(opts);
-    if (event === null) return true;
+    if (event === null) return "filtered";
     return emitCourseStartedPipelineOnly({ ...opts, event });
   }
   if (!trackingEmitted && !sessionStarted) {
     return emitCourseStarted(opts);
   }
-  return true;
+  const pipelineDelivered = hasCourseStartedPipelineDelivered(
+    opts.storage,
+    opts.sessionId,
+    opts.courseId
+  );
+  if (sessionStarted && trackingEmitted && !pipelineDelivered) {
+    const event = buildCourseStartedEvent(opts);
+    if (event === null) return "filtered";
+    return emitCourseStartedPipelineOnly({
+      ...opts,
+      event,
+      skipXapi: opts.skipXapi,
+      onXapiStatementSent: opts.onXapiStatementSent
+    });
+  }
+  return "emitted";
 }
 function assertTrackingSinkConfig(tracking) {
   if (!tracking?.sink || !tracking?.batchSink) return;
@@ -429,21 +464,24 @@ function useLessonkitProviderRuntime(config) {
       const needsBootstrap = !skipBootstrap && !xapiCourseStartedSentOnClientRef.current && (!alreadyStarted || clientChanged);
       if (needsBootstrap) {
         try {
-          const statement = telemetryEventToXAPIStatement2(
-            buildTelemetryEvent({
-              name: "course_started",
-              courseId: cid,
-              sessionId,
-              attemptId: attemptIdRef.current,
-              user: userRef.current
-            })
-          );
-          if (statement) {
-            next.send(statement);
-            if (!alreadyStarted) {
-              markCourseStarted(defaultStorage, sessionId, cid);
+          const event = buildCourseStartedEvent({
+            pluginHost: pluginHostRef.current,
+            courseId: cid,
+            sessionId,
+            attemptId: attemptIdRef.current,
+            user: userRef.current,
+            lxpackBridge: lxpackBridgeModeRef.current
+          });
+          if (event === null) {
+          } else {
+            const statement = telemetryEventToXAPIStatement3(event);
+            if (statement) {
+              next.send(statement);
+              if (!alreadyStarted) {
+                markCourseStarted(defaultStorage, sessionId, cid);
+              }
+              xapiCourseStartedSentOnClientRef.current = true;
             }
-            xapiCourseStartedSentOnClientRef.current = true;
           }
         } catch {
         }
@@ -517,7 +555,7 @@ function useLessonkitProviderRuntime(config) {
     if (!trackingActive) {
       courseStartedEmittedToSinkRef.current = false;
     } else if (!courseStartedEmittedToSinkRef.current) {
-      const emitted = emitPendingCourseStarted({
+      const result = emitPendingCourseStarted({
         pluginHost: pluginHostRef.current,
         tracking: next,
         xapi: xapiRef.current,
@@ -527,12 +565,13 @@ function useLessonkitProviderRuntime(config) {
         attemptId: attemptIdRef.current,
         user: userRef.current,
         lxpackBridge: lxpackBridgeModeRef.current,
-        extraSinks: extraSinksRef.current
+        extraSinks: extraSinksRef.current,
+        skipXapi: xapiCourseStartedSentOnClientRef.current,
+        onXapiStatementSent: () => {
+          xapiCourseStartedSentOnClientRef.current = true;
+        }
       });
-      if (emitted) {
-        markCourseStartedEmittedToTracking(defaultStorage, sessionId, cid);
-      }
-      courseStartedEmittedToSinkRef.current = emitted;
+      courseStartedEmittedToSinkRef.current = isCourseStartedSinkSettled(result);
     } else if (trackingActive) {
       courseStartedEmittedToSinkRef.current = true;
     }
@@ -613,7 +652,7 @@ function useLessonkitProviderRuntime(config) {
       } catch {
       }
       if (!courseStartedEmittedToSinkRef.current) {
-        const emitted = emitPendingCourseStarted({
+        const result = emitPendingCourseStarted({
           pluginHost: pluginHostRef.current,
           tracking: trackingRef.current,
           xapi: xapiRef.current,
@@ -625,7 +664,7 @@ function useLessonkitProviderRuntime(config) {
           lxpackBridge: lxpackBridgeModeRef.current,
           extraSinks: extraSinksRef.current
         });
-        courseStartedEmittedToSinkRef.current = emitted;
+        courseStartedEmittedToSinkRef.current = isCourseStartedSinkSettled(result);
       }
     })();
   }, [normalizedCourseId, normalizedConfig.tracking?.enabled, syncProgress]);
@@ -862,6 +901,10 @@ function isDevEnvironment3() {
   return typeof g.process !== "undefined" && g.process.env?.NODE_ENV !== "production";
 }
 function normalizeComponentId(id, path) {
+  if (path === "courseId") return assertValidId2(id, "courseId");
+  if (path === "lessonId") return assertValidId2(id, "lessonId");
+  if (path === "checkId") return assertValidId2(id, "checkId");
+  if (path === "blockId") return assertValidId2(id, "blockId");
   return assertValidId2(id, path);
 }
 
@@ -1378,7 +1421,13 @@ var BLOCK_CATALOG = [
       { name: "checkId", type: "CheckId", required: true, description: "Stable check identifier for telemetry and LXPack assessments." },
       { name: "question", type: "string", required: true, description: "Question text shown above choices." },
       { name: "choices", type: "string[]", required: true, description: "Radio button choice labels." },
-      { name: "answer", type: "string", required: true, description: "Correct choice value (must match one choice)." }
+      { name: "answer", type: "string", required: true, description: "Correct choice value (must match one choice)." },
+      {
+        name: "passingScore",
+        type: "number",
+        required: false,
+        description: "Minimum score required to pass (defaults to maxScore when omitted)."
+      }
     ],
     requiredIds: ["checkId"],
     parentConstraints: ["Lesson"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lessonkit/react",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "private": false,
   "description": "React components and hooks for building learning experiences with LessonKit.",
   "license": "Apache-2.0",
@@ -56,11 +56,11 @@
     "react-dom": ">=18"
   },
   "dependencies": {
-    "@lessonkit/accessibility": "1.0.0",
-    "@lessonkit/core": "1.0.0",
-    "@lessonkit/lxpack": "1.0.0",
-    "@lessonkit/themes": "1.0.0",
-    "@lessonkit/xapi": "1.0.0"
+    "@lessonkit/accessibility": "1.0.1",
+    "@lessonkit/core": "1.0.1",
+    "@lessonkit/lxpack": "1.0.1",
+    "@lessonkit/themes": "1.0.1",
+    "@lessonkit/xapi": "1.0.1"
   },
   "devDependencies": {
     "@storybook/addon-essentials": "8.6.18",