@lessonkit/react 0.8.0 → 0.9.0

package/README.md

@@ -59,7 +59,7 @@ export default function App() {
 }
 ```
 
-## API (0.8.0)
+## API (0.9.0)
 
 ### Block catalog
 

package/dist/index.cjs

@@ -42,6 +42,8 @@ __export(index_exports, {
   ThemeProvider: () => ThemeProvider,
   blockCatalogVersion: () => blockCatalogVersion,
   buildBlockCatalog: () => buildBlockCatalog,
+  createPluginHost: () => import_core7.createPluginHost,
+  defineLessonkitPlugin: () => import_core7.defineLessonkitPlugin,
   getBlockCatalogEntry: () => getBlockCatalogEntry,
   useCompletion: () => useCompletion,
   useLessonkit: () => useLessonkit,
@@ -58,7 +60,7 @@ var import_accessibility = require("@lessonkit/accessibility");
 
 // src/context.tsx
 var import_react = require("react");
-var import_core3 = require("@lessonkit/core");
+var import_core5 = require("@lessonkit/core");
 var import_xapi3 = require("@lessonkit/xapi");
 var import_xapi4 = require("@lessonkit/xapi");
 
@@ -69,43 +71,55 @@ var import_xapi = require("@lessonkit/xapi");
 // src/runtime/lxpackBridge.ts
 var import_bridge = require("@lessonkit/lxpack/bridge");
 function getBridge() {
+  const fromSdk = (0, import_bridge.getLxpackBridge)();
+  if (fromSdk) return fromSdk;
   if (typeof window === "undefined") return null;
   const parent = window.parent;
   if (!parent || parent === window) return null;
-  return parent.lxpackBridge?.v1 ?? parent.lxpack ?? null;
+  return parent.lxpack ?? null;
 }
-function forwardTelemetryToLxpack(event, mode = "auto") {
-  if (mode === "off") return;
-  const bridge = getBridge();
-  if (!bridge) return;
-  switch (event.name) {
-    case "lesson_completed": {
-      const lessonId = event.lessonId;
-      if (lessonId) bridge.completeLesson?.(lessonId);
+function applyBridgeAction(bridge, action) {
+  if (!action) return;
+  switch (action.kind) {
+    case "completeLesson":
+      bridge.completeLesson?.(action.lessonId);
       return;
-    }
-    case "course_completed":
+    case "completeCourse":
       bridge.completeCourse?.();
       return;
-    case "quiz_completed": {
-      const data = event.data;
-      if (!data?.checkId) return;
-      const scaled = (0, import_bridge.normalizeAssessmentScore)({
-        score: data.score,
-        maxScore: data.maxScore
+    case "submitAssessment": {
+      const scaled = (0, import_bridge.normalizeScore)({
+        score: action.score,
+        maxScore: action.maxScore
       });
       if (scaled === null) return;
       bridge.submitAssessment?.({
-        id: data.checkId,
+        id: action.id,
         score: scaled,
-        passingScore: (0, import_bridge.normalizeAssessmentPassingScore)(data.passingScore)
+        passingScore: (0, import_bridge.normalizePassingThreshold)({
+          passingScore: action.passingScore,
+          maxScore: action.maxScore
+        }),
+        maxScore: action.maxScore
       });
       return;
     }
+    case "track":
+      bridge.track?.(action.event);
+      return;
     default:
       return;
   }
 }
+function forwardTelemetryToLxpack(event, mode = "auto") {
+  if (mode === "off") return;
+  const bridge = getBridge();
+  if (!bridge) return;
+  const lessonkitEvent = (0, import_bridge.telemetryEventToLessonkit)(event);
+  if (!lessonkitEvent) return;
+  const action = (0, import_bridge.mapLessonkitTelemetryToBridgeAction)(lessonkitEvent);
+  applyBridgeAction(bridge, action);
+}
 
 // src/runtime/emitTelemetry.ts
 var warnedMissingCourseId = false;
@@ -229,6 +243,12 @@ function createSessionStoragePort() {
         sessionStorage.setItem(key, value);
       } catch {
       }
+    },
+    removeItem: (key) => {
+      try {
+        sessionStorage.removeItem(key);
+      } catch {
+      }
     }
   };
 }
@@ -276,6 +296,8 @@ function createXapiClientFromConfig(config, queue) {
   if (config.xapi?.enabled === false) return null;
   if (config.xapi?.client) return config.xapi.client;
   if (!config.courseId) return null;
+  const hasTransport = typeof config.xapi?.transport === "function";
+  if (!hasTransport && config.xapi?.enabled !== true) return null;
   return (0, import_xapi2.createXAPIClient)({
     courseId: config.courseId,
     transport: config.xapi?.transport,
@@ -286,6 +308,9 @@ function createXapiClientFromConfig(config, queue) {
 // src/runtime/session.ts
 var import_core2 = require("@lessonkit/core");
 var SESSION_STORAGE_KEY = "lessonkit:sessionId";
+function getTabSessionId(storage) {
+  return storage.getItem(SESSION_STORAGE_KEY);
+}
 var COURSE_STARTED_PREFIX = "lessonkit:course_started:";
 function resolveSessionId(storage, provided) {
   if (provided) return provided;
@@ -306,30 +331,66 @@ function markCourseStarted(storage, sessionId, courseId) {
   if (!courseId) return;
   storage.setItem(courseStartedStorageKey(sessionId, courseId), "1");
 }
+function migrateCourseStartedMark(storage, fromSessionId, toSessionId, courseId) {
+  if (!courseId || fromSessionId === toSessionId) return;
+  if (hasCourseStarted(storage, fromSessionId, courseId)) {
+    markCourseStarted(storage, toSessionId, courseId);
+    storage.removeItem?.(courseStartedStorageKey(fromSessionId, courseId));
+  }
+}
 
-// src/context.tsx
-var import_jsx_runtime = require("react/jsx-runtime");
-var LessonkitContext = (0, import_react.createContext)(null);
-var useIsoLayoutEffect = typeof window !== "undefined" ? import_react.useLayoutEffect : import_react.useEffect;
-function disposeTrackingClient(client) {
-  client?.flush?.();
-  client?.dispose?.();
+// src/runtime/plugins.ts
+var import_core3 = require("@lessonkit/core");
+function createReactPluginHost(plugins) {
+  if (!plugins?.length) return null;
+  return (0, import_core3.createPluginHost)(plugins);
 }
-var defaultStorage = createSessionStoragePort();
+function buildPluginContext(opts) {
+  return {
+    courseId: opts.courseId,
+    sessionId: opts.sessionId,
+    attemptId: opts.attemptId
+  };
+}
+function emitTelemetryWithPlugins(opts) {
+  const next = opts.pluginHost ? opts.pluginHost.runTelemetry(opts.event, opts.pluginCtx) : opts.event;
+  if (next === null) return;
+  emitTelemetry(opts.tracking, opts.xapi, next, { lxpackBridge: opts.lxpackBridge ?? "auto" });
+}
+
+// src/runtime/telemetry.ts
+var import_core4 = require("@lessonkit/core");
 function createTrackingClientFromConfig(config) {
-  if (config.tracking?.enabled === false) {
-    return (0, import_core3.createTrackingClient)();
-  }
-  return (0, import_core3.createTrackingClient)({
+  if (config.tracking?.enabled === false) return (0, import_core4.createTrackingClient)();
+  if (config.tracking?.createClient) return config.tracking.createClient();
+  return (0, import_core4.createTrackingClient)({
     sink: config.tracking?.sink,
     batchSink: config.tracking?.batchSink,
     batch: config.tracking?.batch
   });
 }
+function disposeTrackingClient(client) {
+  client?.flush?.();
+  client?.dispose?.();
+}
+
+// src/context.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var LessonkitContext = (0, import_react.createContext)(null);
+var useIsoLayoutEffect = typeof window !== "undefined" ? import_react.useLayoutEffect : import_react.useEffect;
+var defaultStorage = createSessionStoragePort();
+function isTrackingActive(tracking) {
+  return tracking?.enabled !== false;
+}
 function LessonkitProvider(props) {
   const config = props.config;
   const sessionIdRef = (0, import_react.useRef)(resolveSessionId(defaultStorage, config.session?.sessionId));
-  if (config.session?.sessionId) sessionIdRef.current = config.session.sessionId;
+  const prevConfiguredSessionIdRef = (0, import_react.useRef)(config.session?.sessionId);
+  if (config.session?.sessionId) {
+    sessionIdRef.current = config.session.sessionId;
+  } else if (prevConfiguredSessionIdRef.current) {
+    sessionIdRef.current = resolveSessionId(defaultStorage, void 0);
+  }
   const attemptIdRef = (0, import_react.useRef)(config.session?.attemptId);
   const userRef = (0, import_react.useRef)(config.session?.user);
   attemptIdRef.current = config.session?.attemptId;
@@ -338,7 +399,19 @@ function LessonkitProvider(props) {
   courseIdRef.current = config.courseId;
   const lxpackBridgeModeRef = (0, import_react.useRef)(config.lxpack?.bridge ?? "auto");
   lxpackBridgeModeRef.current = config.lxpack?.bridge ?? "auto";
+  const pluginHost = (0, import_react.useMemo)(() => createReactPluginHost(config.plugins), [config.plugins]);
+  const pluginHostRef = (0, import_react.useRef)(pluginHost);
+  pluginHostRef.current = pluginHost;
   const progressRef = (0, import_react.useRef)(createProgressController());
+  const courseStartedEmittedToSinkRef = (0, import_react.useRef)(false);
+  const prevCourseIdForProgressRef = (0, import_react.useRef)(config.courseId);
+  const pendingCourseIdResetRef = (0, import_react.useRef)(false);
+  if (prevCourseIdForProgressRef.current !== config.courseId) {
+    prevCourseIdForProgressRef.current = config.courseId;
+    progressRef.current = createProgressController();
+    pendingCourseIdResetRef.current = true;
+    courseStartedEmittedToSinkRef.current = false;
+  }
   const [progress, setProgress] = (0, import_react.useState)(() => progressRef.current.getState());
   const syncProgress = (0, import_react.useCallback)(() => {
     setProgress(progressRef.current.getState());
@@ -348,11 +421,17 @@ function LessonkitProvider(props) {
   const xapiQueueRef = (0, import_react.useRef)((0, import_xapi3.createInMemoryXAPIQueue)());
   const xapiRef = (0, import_react.useRef)(null);
   const [xapi, setXapi] = (0, import_react.useState)(null);
+  const prevXapiCourseIdRef = (0, import_react.useRef)(config.courseId);
   const xapiEnabled = config.xapi?.enabled;
   const xapiClient = config.xapi?.client;
   const xapiTransport = config.xapi?.transport;
   const courseId = config.courseId;
+  const trackingEnabled = config.tracking?.enabled;
   useIsoLayoutEffect(() => {
+    if (prevXapiCourseIdRef.current !== courseId) {
+      xapiQueueRef.current = (0, import_xapi3.createInMemoryXAPIQueue)();
+      prevXapiCourseIdRef.current = courseId;
+    }
     const prev = xapiRef.current;
     const next = createXapiClientFromConfig(config, xapiQueueRef.current);
     xapiRef.current = next;
@@ -360,7 +439,9 @@ function LessonkitProvider(props) {
     if (next && !prev) {
       const sessionId = sessionIdRef.current;
       const cid = courseIdRef.current;
-      if (hasCourseStarted(defaultStorage, sessionId, cid)) {
+      const trackingActive = isTrackingActive(config.tracking);
+      const alreadyStarted = hasCourseStarted(defaultStorage, sessionId, cid);
+      if (!trackingActive || alreadyStarted) {
         try {
           const statement = (0, import_xapi4.telemetryEventToXAPIStatement)(
             buildTrackEvent({
@@ -376,6 +457,7 @@ function LessonkitProvider(props) {
         }
       }
     }
+    let cancelled = false;
     void (async () => {
       if (prev) {
         try {
@@ -383,18 +465,20 @@ function LessonkitProvider(props) {
         } catch {
         }
       }
+      if (cancelled) return;
       try {
         await next?.flush();
       } catch {
       }
     })();
     return () => {
+      cancelled = true;
       void prev?.flush();
     };
-  }, [xapiEnabled, xapiClient, xapiTransport, courseId]);
-  const trackingRef = (0, import_react.useRef)((0, import_core3.createTrackingClient)());
+  }, [xapiEnabled, xapiClient, xapiTransport, courseId, trackingEnabled]);
+  const trackingRef = (0, import_react.useRef)((0, import_core5.createTrackingClient)());
+  const trackingClientForUnmountRef = (0, import_react.useRef)(trackingRef.current);
   const [tracking, setTracking] = (0, import_react.useState)(() => trackingRef.current);
-  const trackingEnabled = config.tracking?.enabled;
   const trackingSink = config.tracking?.sink;
   const trackingBatchSink = config.tracking?.batchSink;
   const batchEnabled = config.tracking?.batch?.enabled;
@@ -402,25 +486,50 @@ function LessonkitProvider(props) {
   const batchMaxBatchSize = config.tracking?.batch?.maxBatchSize;
   useIsoLayoutEffect(() => {
     const prev = trackingRef.current;
-    const next = createTrackingClientFromConfig(config);
+    const pluginCtx = buildPluginContext({
+      courseId: courseIdRef.current,
+      sessionId: sessionIdRef.current,
+      attemptId: attemptIdRef.current
+    });
+    const sink = pluginHostRef.current?.composeTrackingSink(config.tracking?.sink, pluginCtx) ?? config.tracking?.sink;
+    const batchSink = pluginHostRef.current && config.tracking?.batchSink ? (events) => {
+      const filtered = pluginHostRef.current.runTelemetryBatch(events, pluginCtx);
+      return config.tracking.batchSink(filtered);
+    } : config.tracking?.batchSink;
+    const next = createTrackingClientFromConfig({
+      tracking: { ...config.tracking, sink, batchSink }
+    });
     trackingRef.current = next;
+    trackingClientForUnmountRef.current = next;
     setTracking(next);
     const sessionId = sessionIdRef.current;
     const cid = courseIdRef.current;
-    if (!hasCourseStarted(defaultStorage, sessionId, cid)) {
+    const trackingActive = isTrackingActive(config.tracking);
+    if (!trackingActive) {
+      courseStartedEmittedToSinkRef.current = false;
+    } else if (!courseStartedEmittedToSinkRef.current && !hasCourseStarted(defaultStorage, sessionId, cid)) {
       markCourseStarted(defaultStorage, sessionId, cid);
-      emitTelemetry(
-        next,
-        xapiRef.current,
-        buildTrackEvent({
+      emitTelemetryWithPlugins({
+        pluginHost: pluginHostRef.current,
+        tracking: next,
+        xapi: xapiRef.current,
+        event: buildTrackEvent({
           name: "course_started",
           courseId: cid,
           sessionId,
           attemptId: attemptIdRef.current,
           user: userRef.current
         }),
-        { lxpackBridge: lxpackBridgeModeRef.current }
-      );
+        pluginCtx: buildPluginContext({
+          courseId: cid,
+          sessionId,
+          attemptId: attemptIdRef.current
+        }),
+        lxpackBridge: lxpackBridgeModeRef.current
+      });
+      courseStartedEmittedToSinkRef.current = true;
+    } else if (trackingActive) {
+      courseStartedEmittedToSinkRef.current = true;
     }
     return () => {
       if (prev !== trackingRef.current) {
@@ -433,16 +542,23 @@ function LessonkitProvider(props) {
     trackingBatchSink,
     batchEnabled,
     batchFlushIntervalMs,
-    batchMaxBatchSize
+    batchMaxBatchSize,
+    config.plugins
   ]);
-  const emitWithBridge = (0, import_react.useCallback)(
-    (trackingClient, event) => {
-      emitTelemetry(trackingClient, xapiRef.current, event, {
-        lxpackBridge: lxpackBridgeModeRef.current
-      });
-    },
-    []
-  );
+  const emitWithBridge = (0, import_react.useCallback)((trackingClient, event) => {
+    emitTelemetryWithPlugins({
+      pluginHost: pluginHostRef.current,
+      tracking: trackingClient,
+      xapi: xapiRef.current,
+      event,
+      pluginCtx: buildPluginContext({
+        courseId: courseIdRef.current,
+        sessionId: sessionIdRef.current,
+        attemptId: attemptIdRef.current
+      }),
+      lxpackBridge: lxpackBridgeModeRef.current
+    });
+  }, []);
   const track = (0, import_react.useCallback)(
     (name, data, opts) => {
       const event = tryBuildTrackEvent({
@@ -459,36 +575,36 @@ function LessonkitProvider(props) {
     },
     [emitWithBridge]
   );
-  const prevCourseIdRef = (0, import_react.useRef)(config.courseId);
-  (0, import_react.useEffect)(() => {
-    if (prevCourseIdRef.current === config.courseId) return;
-    const previousActiveLesson = progressRef.current.getState().activeLessonId;
-    prevCourseIdRef.current = config.courseId;
-    progressRef.current = createProgressController();
+  (0, import_react.useLayoutEffect)(() => {
+    if (!pendingCourseIdResetRef.current) return;
+    pendingCourseIdResetRef.current = false;
     syncProgress();
-    if (previousActiveLesson) {
-      progressRef.current.setActiveLesson(previousActiveLesson, Date.now());
-      syncProgress();
-      track("lesson_started", { lessonId: previousActiveLesson }, { lessonId: previousActiveLesson });
-    }
+    if (!isTrackingActive(config.tracking)) return;
     const sessionId = sessionIdRef.current;
-    const cid = config.courseId;
-    if (!hasCourseStarted(defaultStorage, sessionId, cid)) {
+    const cid = courseIdRef.current;
+    if (!courseStartedEmittedToSinkRef.current && !hasCourseStarted(defaultStorage, sessionId, cid)) {
       markCourseStarted(defaultStorage, sessionId, cid);
-      emitTelemetry(
-        trackingRef.current,
-        xapiRef.current,
-        buildTrackEvent({
+      emitTelemetryWithPlugins({
+        pluginHost: pluginHostRef.current,
+        tracking: trackingRef.current,
+        xapi: xapiRef.current,
+        event: buildTrackEvent({
           name: "course_started",
           courseId: cid,
           sessionId,
           attemptId: attemptIdRef.current,
           user: userRef.current
         }),
-        { lxpackBridge: lxpackBridgeModeRef.current }
-      );
+        pluginCtx: buildPluginContext({
+          courseId: cid,
+          sessionId,
+          attemptId: attemptIdRef.current
+        }),
+        lxpackBridge: lxpackBridgeModeRef.current
+      });
+      courseStartedEmittedToSinkRef.current = true;
     }
-  }, [config.courseId, syncProgress, track]);
+  }, [config.courseId, config.tracking?.enabled, syncProgress]);
   const emitLessonCompleted = (0, import_react.useCallback)(
     (lessonId, durationMs) => {
       track("lesson_completed", { lessonId, durationMs }, { lessonId });
@@ -508,16 +624,21 @@ function LessonkitProvider(props) {
     },
     [syncProgress, emitLessonCompleted]
   );
+  const unmountTimerIdsRef = (0, import_react.useRef)([]);
   (0, import_react.useEffect)(() => {
     return () => {
-      const client = trackingRef.current;
+      for (const id of unmountTimerIdsRef.current) clearTimeout(id);
+      unmountTimerIdsRef.current = [];
+      const client = trackingClientForUnmountRef.current;
       void xapiRef.current?.flush();
-      setTimeout(() => {
+      const flushTimer = setTimeout(() => {
         client?.flush?.();
-        setTimeout(() => {
+        const disposeTimer = setTimeout(() => {
           client?.dispose?.();
         }, 0);
+        unmountTimerIdsRef.current.push(disposeTimer);
       }, 0);
+      unmountTimerIdsRef.current.push(flushTimer);
     };
   }, []);
   const setActiveLesson = (0, import_react.useCallback)(
@@ -542,10 +663,46 @@ function LessonkitProvider(props) {
     if (!result.didComplete) return;
     syncProgress();
     track("course_completed");
+    void trackingRef.current?.flush?.();
   }, [track, syncProgress]);
   const sessionUser = config.session?.user;
   const sessionAttemptId = config.session?.attemptId;
   const sessionConfiguredId = config.session?.sessionId;
+  (0, import_react.useEffect)(() => {
+    if (!pluginHost) return;
+    const ctx = buildPluginContext({
+      courseId: courseIdRef.current,
+      sessionId: sessionIdRef.current,
+      attemptId: attemptIdRef.current
+    });
+    pluginHost.setupAll(ctx);
+    return () => {
+      pluginHost.disposeAll();
+    };
+  }, [pluginHost, config.courseId, sessionAttemptId, sessionConfiguredId]);
+  (0, import_react.useEffect)(() => {
+    const nextConfigured = config.session?.sessionId;
+    const prevConfigured = prevConfiguredSessionIdRef.current;
+    if (nextConfigured === prevConfigured) return;
+    prevConfiguredSessionIdRef.current = nextConfigured;
+    const cid = courseIdRef.current;
+    if (nextConfigured) {
+      const fromIds = /* @__PURE__ */ new Set();
+      if (prevConfigured) fromIds.add(prevConfigured);
+      const tabId = getTabSessionId(defaultStorage);
+      if (tabId) fromIds.add(tabId);
+      for (const fromId of fromIds) {
+        if (fromId !== nextConfigured) {
+          migrateCourseStartedMark(defaultStorage, fromId, nextConfigured, cid);
+        }
+      }
+      sessionIdRef.current = nextConfigured;
+    } else if (prevConfigured) {
+      const nextAuto = resolveSessionId(defaultStorage, void 0);
+      migrateCourseStartedMark(defaultStorage, prevConfigured, nextAuto, cid);
+      sessionIdRef.current = nextAuto;
+    }
+  }, [sessionConfiguredId, config.courseId]);
   const runtime = (0, import_react.useMemo)(
     () => ({
       config,
@@ -556,7 +713,8 @@ function LessonkitProvider(props) {
       setActiveLesson,
       completeLesson,
       completeCourse,
-      track
+      track,
+      plugins: pluginHost
     }),
     [
       config,
@@ -567,6 +725,7 @@ function LessonkitProvider(props) {
       completeLesson,
       completeCourse,
       track,
+      pluginHost,
       sessionUser,
       sessionAttemptId,
       sessionConfiguredId
@@ -610,7 +769,7 @@ function useQuizState() {
 }
 
 // src/runtime/validateComponentId.ts
-var import_core4 = require("@lessonkit/core");
+var import_core6 = require("@lessonkit/core");
 var warnedPaths = /* @__PURE__ */ new Set();
 function isDevEnvironment2() {
   const g = globalThis;
@@ -620,7 +779,7 @@ function warnInvalidComponentId(id, path) {
   if (!isDevEnvironment2()) return;
   const key = `${path}:${String(id)}`;
   if (warnedPaths.has(key)) return;
-  const result = (0, import_core4.validateId)(id, path);
+  const result = (0, import_core6.validateId)(id, path);
   if (result.ok) return;
   warnedPaths.add(key);
   const detail = result.issues.map((i) => `${i.path}: ${i.message}`).join("; ");
@@ -698,6 +857,10 @@ function Quiz(props) {
   const [selected, setSelected] = (0, import_react3.useState)(null);
   const completedRef = (0, import_react3.useRef)(false);
   const questionId = (0, import_react3.useId)();
+  (0, import_react3.useEffect)(() => {
+    completedRef.current = false;
+    setSelected(null);
+  }, [props.checkId, props.answer, props.question]);
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("section", { "aria-label": "Quiz", "data-lk-check-id": props.checkId, children: [
     /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { id: questionId, children: props.question }),
     /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("fieldset", { "aria-labelledby": questionId, children: [
@@ -741,6 +904,9 @@ function ProgressTracker() {
   ] }) });
 }
 
+// src/index.tsx
+var import_core7 = require("@lessonkit/core");
+
 // src/theme/ThemeProvider.tsx
 var import_react4 = __toESM(require("react"), 1);
 var import_themes = require("@lessonkit/themes");
@@ -1049,6 +1215,8 @@ function getBlockCatalogEntry(type) {
   ThemeProvider,
   blockCatalogVersion,
   buildBlockCatalog,
+  createPluginHost,
+  defineLessonkitPlugin,
   getBlockCatalogEntry,
   useCompletion,
   useLessonkit,

package/dist/index.d.cts

@@ -1,7 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 import * as _lessonkit_core from '@lessonkit/core';
-import { LessonId, CourseId, TelemetryUser, TrackingClient, TelemetryEventName, CheckId, BlockId } from '@lessonkit/core';
+import { LessonId, CourseId, TelemetryUser, TrackingClient, LessonkitPlugin, TelemetryEventName, PluginHost, CheckId, BlockId } from '@lessonkit/core';
+export { AssessmentScoreInput, AssessmentScoreResult, InteractionBlockRegistration, LessonkitPlugin, LessonkitPluginContext, LessonkitPluginKind, PluginHost, createPluginHost, defineLessonkitPlugin } from '@lessonkit/core';
 import { XAPITransport, XAPIClient } from '@lessonkit/xapi';
 import { LessonkitThemeV1, ThemePresetName, PartialLessonkitThemeV1 } from '@lessonkit/themes';
 export { ThemePresetName } from '@lessonkit/themes';
@@ -38,6 +39,8 @@ type LessonkitConfig = {
         /** Forward completion events to `window.parent.lxpackBridge.v1` when embedded (default `auto`). */
         bridge?: "auto" | "off";
     };
+    /** Framework plugins (analytics, LMS, assessment, interaction, AI). */
+    plugins?: LessonkitPlugin[];
 };
 
 type LessonkitRuntime = {
@@ -56,6 +59,7 @@ type LessonkitRuntime = {
     track: (name: TelemetryEventName, data?: unknown, opts?: {
         lessonId?: LessonId;
     }) => void;
+    plugins: PluginHost | null;
 };
 declare function LessonkitProvider(props: {
     config: LessonkitConfig;

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 import * as _lessonkit_core from '@lessonkit/core';
-import { LessonId, CourseId, TelemetryUser, TrackingClient, TelemetryEventName, CheckId, BlockId } from '@lessonkit/core';
+import { LessonId, CourseId, TelemetryUser, TrackingClient, LessonkitPlugin, TelemetryEventName, PluginHost, CheckId, BlockId } from '@lessonkit/core';
+export { AssessmentScoreInput, AssessmentScoreResult, InteractionBlockRegistration, LessonkitPlugin, LessonkitPluginContext, LessonkitPluginKind, PluginHost, createPluginHost, defineLessonkitPlugin } from '@lessonkit/core';
 import { XAPITransport, XAPIClient } from '@lessonkit/xapi';
 import { LessonkitThemeV1, ThemePresetName, PartialLessonkitThemeV1 } from '@lessonkit/themes';
 export { ThemePresetName } from '@lessonkit/themes';
@@ -38,6 +39,8 @@ type LessonkitConfig = {
         /** Forward completion events to `window.parent.lxpackBridge.v1` when embedded (default `auto`). */
         bridge?: "auto" | "off";
     };
+    /** Framework plugins (analytics, LMS, assessment, interaction, AI). */
+    plugins?: LessonkitPlugin[];
 };
 
 type LessonkitRuntime = {
@@ -56,6 +59,7 @@ type LessonkitRuntime = {
     track: (name: TelemetryEventName, data?: unknown, opts?: {
         lessonId?: LessonId;
     }) => void;
+    plugins: PluginHost | null;
 };
 declare function LessonkitProvider(props: {
     config: LessonkitConfig;

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   useRef,
   useState
 } from "react";
-import { createTrackingClient } from "@lessonkit/core";
+import { createTrackingClient as createTrackingClient2 } from "@lessonkit/core";
 import { createInMemoryXAPIQueue } from "@lessonkit/xapi";
 import { telemetryEventToXAPIStatement as telemetryEventToXAPIStatement2 } from "@lessonkit/xapi";
 
@@ -22,47 +22,62 @@ import { telemetryEventToXAPIStatement } from "@lessonkit/xapi";
 
 // src/runtime/lxpackBridge.ts
 import {
-  normalizeAssessmentPassingScore,
-  normalizeAssessmentScore
+  getLxpackBridge as getLxpackBridgeFromSdk,
+  mapLessonkitTelemetryToBridgeAction,
+  normalizePassingThreshold,
+  normalizeScore,
+  telemetryEventToLessonkit
 } from "@lessonkit/lxpack/bridge";
 function getBridge() {
+  const fromSdk = getLxpackBridgeFromSdk();
+  if (fromSdk) return fromSdk;
   if (typeof window === "undefined") return null;
   const parent = window.parent;
   if (!parent || parent === window) return null;
-  return parent.lxpackBridge?.v1 ?? parent.lxpack ?? null;
+  return parent.lxpack ?? null;
 }
-function forwardTelemetryToLxpack(event, mode = "auto") {
-  if (mode === "off") return;
-  const bridge = getBridge();
-  if (!bridge) return;
-  switch (event.name) {
-    case "lesson_completed": {
-      const lessonId = event.lessonId;
-      if (lessonId) bridge.completeLesson?.(lessonId);
+function applyBridgeAction(bridge, action) {
+  if (!action) return;
+  switch (action.kind) {
+    case "completeLesson":
+      bridge.completeLesson?.(action.lessonId);
       return;
-    }
-    case "course_completed":
+    case "completeCourse":
       bridge.completeCourse?.();
       return;
-    case "quiz_completed": {
-      const data = event.data;
-      if (!data?.checkId) return;
-      const scaled = normalizeAssessmentScore({
-        score: data.score,
-        maxScore: data.maxScore
+    case "submitAssessment": {
+      const scaled = normalizeScore({
+        score: action.score,
+        maxScore: action.maxScore
       });
       if (scaled === null) return;
       bridge.submitAssessment?.({
-        id: data.checkId,
+        id: action.id,
         score: scaled,
-        passingScore: normalizeAssessmentPassingScore(data.passingScore)
+        passingScore: normalizePassingThreshold({
+          passingScore: action.passingScore,
+          maxScore: action.maxScore
+        }),
+        maxScore: action.maxScore
       });
       return;
     }
+    case "track":
+      bridge.track?.(action.event);
+      return;
     default:
       return;
   }
 }
+function forwardTelemetryToLxpack(event, mode = "auto") {
+  if (mode === "off") return;
+  const bridge = getBridge();
+  if (!bridge) return;
+  const lessonkitEvent = telemetryEventToLessonkit(event);
+  if (!lessonkitEvent) return;
+  const action = mapLessonkitTelemetryToBridgeAction(lessonkitEvent);
+  applyBridgeAction(bridge, action);
+}
 
 // src/runtime/emitTelemetry.ts
 var warnedMissingCourseId = false;
@@ -186,6 +201,12 @@ function createSessionStoragePort() {
         sessionStorage.setItem(key, value);
       } catch {
       }
+    },
+    removeItem: (key) => {
+      try {
+        sessionStorage.removeItem(key);
+      } catch {
+      }
     }
   };
 }
@@ -233,6 +254,8 @@ function createXapiClientFromConfig(config, queue) {
   if (config.xapi?.enabled === false) return null;
   if (config.xapi?.client) return config.xapi.client;
   if (!config.courseId) return null;
+  const hasTransport = typeof config.xapi?.transport === "function";
+  if (!hasTransport && config.xapi?.enabled !== true) return null;
   return createXAPIClient({
     courseId: config.courseId,
     transport: config.xapi?.transport,
@@ -243,6 +266,9 @@ function createXapiClientFromConfig(config, queue) {
 // src/runtime/session.ts
 import { createSessionId } from "@lessonkit/core";
 var SESSION_STORAGE_KEY = "lessonkit:sessionId";
+function getTabSessionId(storage) {
+  return storage.getItem(SESSION_STORAGE_KEY);
+}
 var COURSE_STARTED_PREFIX = "lessonkit:course_started:";
 function resolveSessionId(storage, provided) {
   if (provided) return provided;
@@ -263,30 +289,66 @@ function markCourseStarted(storage, sessionId, courseId) {
   if (!courseId) return;
   storage.setItem(courseStartedStorageKey(sessionId, courseId), "1");
 }
+function migrateCourseStartedMark(storage, fromSessionId, toSessionId, courseId) {
+  if (!courseId || fromSessionId === toSessionId) return;
+  if (hasCourseStarted(storage, fromSessionId, courseId)) {
+    markCourseStarted(storage, toSessionId, courseId);
+    storage.removeItem?.(courseStartedStorageKey(fromSessionId, courseId));
+  }
+}
 
-// src/context.tsx
-import { jsx } from "react/jsx-runtime";
-var LessonkitContext = createContext(null);
-var useIsoLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;
-function disposeTrackingClient(client) {
-  client?.flush?.();
-  client?.dispose?.();
+// src/runtime/plugins.ts
+import { createPluginHost } from "@lessonkit/core";
+function createReactPluginHost(plugins) {
+  if (!plugins?.length) return null;
+  return createPluginHost(plugins);
 }
-var defaultStorage = createSessionStoragePort();
+function buildPluginContext(opts) {
+  return {
+    courseId: opts.courseId,
+    sessionId: opts.sessionId,
+    attemptId: opts.attemptId
+  };
+}
+function emitTelemetryWithPlugins(opts) {
+  const next = opts.pluginHost ? opts.pluginHost.runTelemetry(opts.event, opts.pluginCtx) : opts.event;
+  if (next === null) return;
+  emitTelemetry(opts.tracking, opts.xapi, next, { lxpackBridge: opts.lxpackBridge ?? "auto" });
+}
+
+// src/runtime/telemetry.ts
+import { createTrackingClient } from "@lessonkit/core";
 function createTrackingClientFromConfig(config) {
-  if (config.tracking?.enabled === false) {
-    return createTrackingClient();
-  }
+  if (config.tracking?.enabled === false) return createTrackingClient();
+  if (config.tracking?.createClient) return config.tracking.createClient();
   return createTrackingClient({
     sink: config.tracking?.sink,
     batchSink: config.tracking?.batchSink,
     batch: config.tracking?.batch
   });
 }
+function disposeTrackingClient(client) {
+  client?.flush?.();
+  client?.dispose?.();
+}
+
+// src/context.tsx
+import { jsx } from "react/jsx-runtime";
+var LessonkitContext = createContext(null);
+var useIsoLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;
+var defaultStorage = createSessionStoragePort();
+function isTrackingActive(tracking) {
+  return tracking?.enabled !== false;
+}
 function LessonkitProvider(props) {
   const config = props.config;
   const sessionIdRef = useRef(resolveSessionId(defaultStorage, config.session?.sessionId));
-  if (config.session?.sessionId) sessionIdRef.current = config.session.sessionId;
+  const prevConfiguredSessionIdRef = useRef(config.session?.sessionId);
+  if (config.session?.sessionId) {
+    sessionIdRef.current = config.session.sessionId;
+  } else if (prevConfiguredSessionIdRef.current) {
+    sessionIdRef.current = resolveSessionId(defaultStorage, void 0);
+  }
   const attemptIdRef = useRef(config.session?.attemptId);
   const userRef = useRef(config.session?.user);
   attemptIdRef.current = config.session?.attemptId;
@@ -295,7 +357,19 @@ function LessonkitProvider(props) {
   courseIdRef.current = config.courseId;
   const lxpackBridgeModeRef = useRef(config.lxpack?.bridge ?? "auto");
   lxpackBridgeModeRef.current = config.lxpack?.bridge ?? "auto";
+  const pluginHost = useMemo(() => createReactPluginHost(config.plugins), [config.plugins]);
+  const pluginHostRef = useRef(pluginHost);
+  pluginHostRef.current = pluginHost;
   const progressRef = useRef(createProgressController());
+  const courseStartedEmittedToSinkRef = useRef(false);
+  const prevCourseIdForProgressRef = useRef(config.courseId);
+  const pendingCourseIdResetRef = useRef(false);
+  if (prevCourseIdForProgressRef.current !== config.courseId) {
+    prevCourseIdForProgressRef.current = config.courseId;
+    progressRef.current = createProgressController();
+    pendingCourseIdResetRef.current = true;
+    courseStartedEmittedToSinkRef.current = false;
+  }
   const [progress, setProgress] = useState(() => progressRef.current.getState());
   const syncProgress = useCallback(() => {
     setProgress(progressRef.current.getState());
@@ -305,11 +379,17 @@ function LessonkitProvider(props) {
   const xapiQueueRef = useRef(createInMemoryXAPIQueue());
   const xapiRef = useRef(null);
   const [xapi, setXapi] = useState(null);
+  const prevXapiCourseIdRef = useRef(config.courseId);
   const xapiEnabled = config.xapi?.enabled;
   const xapiClient = config.xapi?.client;
   const xapiTransport = config.xapi?.transport;
   const courseId = config.courseId;
+  const trackingEnabled = config.tracking?.enabled;
   useIsoLayoutEffect(() => {
+    if (prevXapiCourseIdRef.current !== courseId) {
+      xapiQueueRef.current = createInMemoryXAPIQueue();
+      prevXapiCourseIdRef.current = courseId;
+    }
     const prev = xapiRef.current;
     const next = createXapiClientFromConfig(config, xapiQueueRef.current);
     xapiRef.current = next;
@@ -317,7 +397,9 @@ function LessonkitProvider(props) {
     if (next && !prev) {
       const sessionId = sessionIdRef.current;
       const cid = courseIdRef.current;
-      if (hasCourseStarted(defaultStorage, sessionId, cid)) {
+      const trackingActive = isTrackingActive(config.tracking);
+      const alreadyStarted = hasCourseStarted(defaultStorage, sessionId, cid);
+      if (!trackingActive || alreadyStarted) {
         try {
           const statement = telemetryEventToXAPIStatement2(
             buildTrackEvent({
@@ -333,6 +415,7 @@ function LessonkitProvider(props) {
         }
       }
     }
+    let cancelled = false;
     void (async () => {
       if (prev) {
         try {
@@ -340,18 +423,20 @@ function LessonkitProvider(props) {
         } catch {
         }
       }
+      if (cancelled) return;
       try {
         await next?.flush();
       } catch {
       }
     })();
     return () => {
+      cancelled = true;
       void prev?.flush();
     };
-  }, [xapiEnabled, xapiClient, xapiTransport, courseId]);
-  const trackingRef = useRef(createTrackingClient());
+  }, [xapiEnabled, xapiClient, xapiTransport, courseId, trackingEnabled]);
+  const trackingRef = useRef(createTrackingClient2());
+  const trackingClientForUnmountRef = useRef(trackingRef.current);
   const [tracking, setTracking] = useState(() => trackingRef.current);
-  const trackingEnabled = config.tracking?.enabled;
   const trackingSink = config.tracking?.sink;
   const trackingBatchSink = config.tracking?.batchSink;
   const batchEnabled = config.tracking?.batch?.enabled;
@@ -359,25 +444,50 @@ function LessonkitProvider(props) {
   const batchMaxBatchSize = config.tracking?.batch?.maxBatchSize;
   useIsoLayoutEffect(() => {
     const prev = trackingRef.current;
-    const next = createTrackingClientFromConfig(config);
+    const pluginCtx = buildPluginContext({
+      courseId: courseIdRef.current,
+      sessionId: sessionIdRef.current,
+      attemptId: attemptIdRef.current
+    });
+    const sink = pluginHostRef.current?.composeTrackingSink(config.tracking?.sink, pluginCtx) ?? config.tracking?.sink;
+    const batchSink = pluginHostRef.current && config.tracking?.batchSink ? (events) => {
+      const filtered = pluginHostRef.current.runTelemetryBatch(events, pluginCtx);
+      return config.tracking.batchSink(filtered);
+    } : config.tracking?.batchSink;
+    const next = createTrackingClientFromConfig({
+      tracking: { ...config.tracking, sink, batchSink }
+    });
     trackingRef.current = next;
+    trackingClientForUnmountRef.current = next;
     setTracking(next);
     const sessionId = sessionIdRef.current;
     const cid = courseIdRef.current;
-    if (!hasCourseStarted(defaultStorage, sessionId, cid)) {
+    const trackingActive = isTrackingActive(config.tracking);
+    if (!trackingActive) {
+      courseStartedEmittedToSinkRef.current = false;
+    } else if (!courseStartedEmittedToSinkRef.current && !hasCourseStarted(defaultStorage, sessionId, cid)) {
       markCourseStarted(defaultStorage, sessionId, cid);
-      emitTelemetry(
-        next,
-        xapiRef.current,
-        buildTrackEvent({
+      emitTelemetryWithPlugins({
+        pluginHost: pluginHostRef.current,
+        tracking: next,
+        xapi: xapiRef.current,
+        event: buildTrackEvent({
           name: "course_started",
           courseId: cid,
           sessionId,
           attemptId: attemptIdRef.current,
           user: userRef.current
         }),
-        { lxpackBridge: lxpackBridgeModeRef.current }
-      );
+        pluginCtx: buildPluginContext({
+          courseId: cid,
+          sessionId,
+          attemptId: attemptIdRef.current
+        }),
+        lxpackBridge: lxpackBridgeModeRef.current
+      });
+      courseStartedEmittedToSinkRef.current = true;
+    } else if (trackingActive) {
+      courseStartedEmittedToSinkRef.current = true;
     }
     return () => {
       if (prev !== trackingRef.current) {
@@ -390,16 +500,23 @@ function LessonkitProvider(props) {
     trackingBatchSink,
     batchEnabled,
     batchFlushIntervalMs,
-    batchMaxBatchSize
+    batchMaxBatchSize,
+    config.plugins
   ]);
-  const emitWithBridge = useCallback(
-    (trackingClient, event) => {
-      emitTelemetry(trackingClient, xapiRef.current, event, {
-        lxpackBridge: lxpackBridgeModeRef.current
-      });
-    },
-    []
-  );
+  const emitWithBridge = useCallback((trackingClient, event) => {
+    emitTelemetryWithPlugins({
+      pluginHost: pluginHostRef.current,
+      tracking: trackingClient,
+      xapi: xapiRef.current,
+      event,
+      pluginCtx: buildPluginContext({
+        courseId: courseIdRef.current,
+        sessionId: sessionIdRef.current,
+        attemptId: attemptIdRef.current
+      }),
+      lxpackBridge: lxpackBridgeModeRef.current
+    });
+  }, []);
   const track = useCallback(
     (name, data, opts) => {
       const event = tryBuildTrackEvent({
@@ -416,36 +533,36 @@ function LessonkitProvider(props) {
     },
     [emitWithBridge]
   );
-  const prevCourseIdRef = useRef(config.courseId);
-  useEffect(() => {
-    if (prevCourseIdRef.current === config.courseId) return;
-    const previousActiveLesson = progressRef.current.getState().activeLessonId;
-    prevCourseIdRef.current = config.courseId;
-    progressRef.current = createProgressController();
+  useLayoutEffect(() => {
+    if (!pendingCourseIdResetRef.current) return;
+    pendingCourseIdResetRef.current = false;
     syncProgress();
-    if (previousActiveLesson) {
-      progressRef.current.setActiveLesson(previousActiveLesson, Date.now());
-      syncProgress();
-      track("lesson_started", { lessonId: previousActiveLesson }, { lessonId: previousActiveLesson });
-    }
+    if (!isTrackingActive(config.tracking)) return;
     const sessionId = sessionIdRef.current;
-    const cid = config.courseId;
-    if (!hasCourseStarted(defaultStorage, sessionId, cid)) {
+    const cid = courseIdRef.current;
+    if (!courseStartedEmittedToSinkRef.current && !hasCourseStarted(defaultStorage, sessionId, cid)) {
       markCourseStarted(defaultStorage, sessionId, cid);
-      emitTelemetry(
-        trackingRef.current,
-        xapiRef.current,
-        buildTrackEvent({
+      emitTelemetryWithPlugins({
+        pluginHost: pluginHostRef.current,
+        tracking: trackingRef.current,
+        xapi: xapiRef.current,
+        event: buildTrackEvent({
           name: "course_started",
           courseId: cid,
           sessionId,
           attemptId: attemptIdRef.current,
           user: userRef.current
         }),
-        { lxpackBridge: lxpackBridgeModeRef.current }
-      );
+        pluginCtx: buildPluginContext({
+          courseId: cid,
+          sessionId,
+          attemptId: attemptIdRef.current
+        }),
+        lxpackBridge: lxpackBridgeModeRef.current
+      });
+      courseStartedEmittedToSinkRef.current = true;
     }
-  }, [config.courseId, syncProgress, track]);
+  }, [config.courseId, config.tracking?.enabled, syncProgress]);
   const emitLessonCompleted = useCallback(
     (lessonId, durationMs) => {
       track("lesson_completed", { lessonId, durationMs }, { lessonId });
@@ -465,16 +582,21 @@ function LessonkitProvider(props) {
     },
     [syncProgress, emitLessonCompleted]
   );
+  const unmountTimerIdsRef = useRef([]);
   useEffect(() => {
     return () => {
-      const client = trackingRef.current;
+      for (const id of unmountTimerIdsRef.current) clearTimeout(id);
+      unmountTimerIdsRef.current = [];
+      const client = trackingClientForUnmountRef.current;
       void xapiRef.current?.flush();
-      setTimeout(() => {
+      const flushTimer = setTimeout(() => {
         client?.flush?.();
-        setTimeout(() => {
+        const disposeTimer = setTimeout(() => {
           client?.dispose?.();
         }, 0);
+        unmountTimerIdsRef.current.push(disposeTimer);
       }, 0);
+      unmountTimerIdsRef.current.push(flushTimer);
     };
   }, []);
   const setActiveLesson = useCallback(
@@ -499,10 +621,46 @@ function LessonkitProvider(props) {
     if (!result.didComplete) return;
     syncProgress();
     track("course_completed");
+    void trackingRef.current?.flush?.();
   }, [track, syncProgress]);
   const sessionUser = config.session?.user;
   const sessionAttemptId = config.session?.attemptId;
   const sessionConfiguredId = config.session?.sessionId;
+  useEffect(() => {
+    if (!pluginHost) return;
+    const ctx = buildPluginContext({
+      courseId: courseIdRef.current,
+      sessionId: sessionIdRef.current,
+      attemptId: attemptIdRef.current
+    });
+    pluginHost.setupAll(ctx);
+    return () => {
+      pluginHost.disposeAll();
+    };
+  }, [pluginHost, config.courseId, sessionAttemptId, sessionConfiguredId]);
+  useEffect(() => {
+    const nextConfigured = config.session?.sessionId;
+    const prevConfigured = prevConfiguredSessionIdRef.current;
+    if (nextConfigured === prevConfigured) return;
+    prevConfiguredSessionIdRef.current = nextConfigured;
+    const cid = courseIdRef.current;
+    if (nextConfigured) {
+      const fromIds = /* @__PURE__ */ new Set();
+      if (prevConfigured) fromIds.add(prevConfigured);
+      const tabId = getTabSessionId(defaultStorage);
+      if (tabId) fromIds.add(tabId);
+      for (const fromId of fromIds) {
+        if (fromId !== nextConfigured) {
+          migrateCourseStartedMark(defaultStorage, fromId, nextConfigured, cid);
+        }
+      }
+      sessionIdRef.current = nextConfigured;
+    } else if (prevConfigured) {
+      const nextAuto = resolveSessionId(defaultStorage, void 0);
+      migrateCourseStartedMark(defaultStorage, prevConfigured, nextAuto, cid);
+      sessionIdRef.current = nextAuto;
+    }
+  }, [sessionConfiguredId, config.courseId]);
   const runtime = useMemo(
     () => ({
       config,
@@ -513,7 +671,8 @@ function LessonkitProvider(props) {
       setActiveLesson,
       completeLesson,
       completeCourse,
-      track
+      track,
+      plugins: pluginHost
     }),
     [
       config,
@@ -524,6 +683,7 @@ function LessonkitProvider(props) {
       completeLesson,
       completeCourse,
       track,
+      pluginHost,
       sessionUser,
       sessionAttemptId,
       sessionConfiguredId
@@ -655,6 +815,10 @@ function Quiz(props) {
   const [selected, setSelected] = useState2(null);
   const completedRef = useRef2(false);
   const questionId = useId();
+  useEffect2(() => {
+    completedRef.current = false;
+    setSelected(null);
+  }, [props.checkId, props.answer, props.question]);
   return /* @__PURE__ */ jsxs("section", { "aria-label": "Quiz", "data-lk-check-id": props.checkId, children: [
     /* @__PURE__ */ jsx2("p", { id: questionId, children: props.question }),
     /* @__PURE__ */ jsxs("fieldset", { "aria-labelledby": questionId, children: [
@@ -698,6 +862,9 @@ function ProgressTracker() {
   ] }) });
 }
 
+// src/index.tsx
+import { createPluginHost as createPluginHost2, defineLessonkitPlugin } from "@lessonkit/core";
+
 // src/theme/ThemeProvider.tsx
 import React3, {
   createContext as createContext2,
@@ -1020,6 +1187,8 @@ export {
   ThemeProvider,
   blockCatalogVersion,
   buildBlockCatalog,
+  createPluginHost2 as createPluginHost,
+  defineLessonkitPlugin,
   getBlockCatalogEntry,
   useCompletion,
   useLessonkit,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lessonkit/react",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "private": false,
   "description": "React components and hooks for building learning experiences with LessonKit.",
   "license": "Apache-2.0",
@@ -54,11 +54,11 @@
     "react-dom": ">=18"
   },
   "dependencies": {
-    "@lessonkit/accessibility": "0.8.0",
-    "@lessonkit/core": "0.8.0",
-    "@lessonkit/lxpack": "0.8.0",
-    "@lessonkit/themes": "0.8.0",
-    "@lessonkit/xapi": "0.8.0"
+    "@lessonkit/accessibility": "0.9.0",
+    "@lessonkit/core": "0.9.0",
+    "@lessonkit/lxpack": "0.9.0",
+    "@lessonkit/themes": "0.9.0",
+    "@lessonkit/xapi": "0.9.0"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.0",