@lessonkit/react 1.4.0 → 1.5.0

package/dist/testing.cjs

@@ -186,9 +186,6 @@ var import_core10 = require("@lessonkit/core");
 // src/runtime/observability.ts
 var import_xapi = require("@lessonkit/xapi");
 
-// src/provider/useLessonkitProviderRuntime.ts
-var import_xapi5 = require("@lessonkit/xapi");
-
 // src/runtime/emitTelemetry.ts
 var import_core4 = require("@lessonkit/core");
 
@@ -199,45 +196,56 @@ var import_xapi2 = require("@lessonkit/xapi");
 // src/runtime/lxpackBridge.ts
 var import_bridge = require("@lessonkit/lxpack/bridge");
 
-// src/runtime/ports.ts
-var import_core5 = require("@lessonkit/core");
+// src/runtime/courseStartedPipeline.ts
+var import_xapi3 = require("@lessonkit/xapi");
 
-// src/provider/useLessonkitProviderRuntime.ts
-var import_core11 = require("@lessonkit/core");
+// src/runtime/plugins.ts
+var import_core5 = require("@lessonkit/core");
+function buildPluginContext(opts) {
+  return (0, import_core5.buildPluginContext)(opts);
+}
 
-// src/runtime/progress.ts
+// src/runtime/session.ts
 var import_core6 = require("@lessonkit/core");
 
-// src/runtime/xapi.ts
-var import_xapi3 = require("@lessonkit/xapi");
+// src/provider/courseStarted/emit.ts
+function createCourseStartedFlightScope() {
+  return {
+    trackingFlights: /* @__PURE__ */ new Map(),
+    emitFlights: /* @__PURE__ */ new Map()
+  };
+}
+var defaultFlightScope = createCourseStartedFlightScope();
+function resetCourseStartedTrackingFlightForTests() {
+  defaultFlightScope.trackingFlights.clear();
+  defaultFlightScope.emitFlights.clear();
+}
 
-// src/runtime/session.ts
+// src/provider/useLessonkitProviderRuntime.ts
+var import_xapi5 = require("@lessonkit/xapi");
+
+// src/runtime/ports.ts
 var import_core7 = require("@lessonkit/core");
 
-// src/runtime/courseStartedPipeline.ts
-var import_xapi4 = require("@lessonkit/xapi");
+// src/provider/useLessonkitProviderRuntime.ts
+var import_core11 = require("@lessonkit/core");
 
-// src/runtime/plugins.ts
+// src/runtime/progress.ts
 var import_core8 = require("@lessonkit/core");
-function buildPluginContext(opts) {
-  return (0, import_core8.buildPluginContext)(opts);
-}
 
-// src/provider/courseStarted/emit.ts
-var courseStartedTrackingFlights = /* @__PURE__ */ new Map();
-var courseStartedEmitFlights = /* @__PURE__ */ new Map();
-function resetCourseStartedTrackingFlightForTests() {
-  courseStartedTrackingFlights.clear();
-  courseStartedEmitFlights.clear();
-}
+// src/runtime/xapi.ts
+var import_xapi4 = require("@lessonkit/xapi");
 
 // src/runtime/telemetry.ts
 var import_core9 = require("@lessonkit/core");
 
 // src/provider/useLessonkitProviderRuntime.ts
-var defaultStorage = (0, import_core5.createSessionStoragePort)();
+var providerStoragesForTests = /* @__PURE__ */ new Set();
 function resetLessonkitProviderStorageForTests() {
-  (0, import_core5.resetStoragePortForTests)(defaultStorage);
+  for (const storage of providerStoragesForTests) {
+    (0, import_core7.resetStoragePortForTests)(storage);
+  }
+  providerStoragesForTests.clear();
   (0, import_core11.resetSharedVolatileSessionIdForTests)();
 }
 
@@ -280,14 +288,15 @@ function meetsPassingThreshold(score, maxScore, passingScore) {
 }
 function scoreFromCustom(custom, fallbackCorrect, fallbackMax = 1, passingScore) {
   const maxScore = custom?.maxScore ?? fallbackMax;
+  const hasNumericScore = custom?.score != null && Number.isFinite(custom.score);
+  if (hasNumericScore) {
+    const passed2 = custom.passed !== void 0 ? custom.passed : meetsPassingThreshold(custom.score, maxScore, passingScore);
+    return { score: custom.score, maxScore, passed: passed2 };
+  }
   if (custom?.passed !== void 0) {
-    const score2 = custom.passed ? custom.score ?? maxScore : custom.score ?? 0;
+    const score2 = custom.passed ? maxScore : 0;
     return { score: score2, maxScore, passed: custom.passed };
   }
-  if (custom?.maxScore != null && custom.maxScore > 0 && custom.score != null) {
-    const passed2 = meetsPassingThreshold(custom.score, custom.maxScore, passingScore);
-    return { score: custom.score, maxScore: custom.maxScore, passed: passed2 };
-  }
   const score = fallbackCorrect ? maxScore : 0;
   const passed = meetsPassingThreshold(score, maxScore, passingScore);
   return { score, maxScore, passed };
@@ -332,7 +341,8 @@ function QuizInner(props, ref) {
   const { enclosingLessonId } = props;
   const checkId = (0, import_react12.useMemo)(() => normalizeComponentId(props.checkId, "checkId"), [props.checkId]);
   const quiz = useQuizState(enclosingLessonId);
-  const { getPluginScore, isChoiceCorrect } = usePluginScoring(checkId, enclosingLessonId);
+  const { config } = useLessonkit();
+  const { scoreResponse } = usePluginScoring(checkId, enclosingLessonId);
   const [selected, setSelected] = (0, import_react12.useState)(null);
   const [selectionCorrect, setSelectionCorrect] = (0, import_react12.useState)(null);
   const [quizPassed, setQuizPassed] = (0, import_react12.useState)(false);
@@ -430,9 +440,9 @@ function QuizInner(props, ref) {
         if (nextPassed === true || nextPassed === false) {
           setQuizPassed(nextPassed);
           completedRef.current = nextPassed;
-          if (nextPassed) {
-            const maxScore = nextCompletedMaxScore ?? completedMaxScore ?? 1;
-            const score = nextCompletedScore ?? completedScore ?? maxScore;
+          if (nextPassed && config.tracking?.replayResumeEvents === true) {
+            const maxScore = nextCompletedMaxScore ?? 1;
+            const score = nextCompletedScore ?? (nextPassed ? maxScore : 0);
             replayTelemetry(
               nextSelected ?? null,
               nextCorrect ?? null,
@@ -448,6 +458,7 @@ function QuizInner(props, ref) {
       checkId,
       completedMaxScore,
       completedScore,
+      config.tracking?.replayResumeEvents,
       props.passingScore,
       props.question,
       quiz,
@@ -469,32 +480,40 @@ function QuizInner(props, ref) {
             name: questionId,
             value: c,
             checked: selected === c,
-            disabled: passed,
+            disabled: passed && !props.enableRetry,
             "aria-invalid": selected === c && selectionCorrect === false ? true : void 0,
             onChange: () => {
-              if (passed) return;
+              if (passed && !props.enableRetry) return;
               setSelected(c);
-              const custom = getPluginScore(c);
-              const correct = isChoiceCorrect(c, props.answer, custom, props.passingScore);
-              setSelectionCorrect(correct);
+              const defaultCorrect = c === props.answer;
+              const scored = scoreResponse(c, defaultCorrect, 1, props.passingScore);
+              setSelectionCorrect(scored.passed);
               quiz.answer({
                 checkId,
                 question: props.question,
                 choice: c,
-                correct
+                correct: scored.passed
               });
-              if (correct && !completedRef.current) {
+              if (scored.passed && !completedRef.current) {
                 completedRef.current = true;
                 setQuizPassed(true);
-                const maxScore = custom?.maxScore ?? 1;
-                const score = custom?.score ?? maxScore;
-                setCompletedScore(score);
-                setCompletedMaxScore(maxScore);
+                setCompletedScore(scored.score);
+                setCompletedMaxScore(scored.maxScore);
+                quiz.complete({
+                  checkId,
+                  score: scored.score,
+                  maxScore: scored.maxScore,
+                  passingScore: props.passingScore ?? scored.maxScore
+                });
+              } else if (!scored.passed && props.enableRetry === false && !completedRef.current) {
+                completedRef.current = true;
+                setCompletedScore(scored.score);
+                setCompletedMaxScore(scored.maxScore);
                 quiz.complete({
                   checkId,
-                  score,
-                  maxScore,
-                  passingScore: props.passingScore ?? maxScore
+                  score: scored.score,
+                  maxScore: scored.maxScore,
+                  passingScore: props.passingScore ?? scored.maxScore
                 });
               }
             }
@@ -503,7 +522,24 @@ function QuizInner(props, ref) {
         c
       ] }, `${questionId}-${i}`))
     ] }),
-    selected && selectionCorrect !== null ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("p", { role: "status", "aria-live": "polite", children: selectionCorrect ? "Correct" : "Try again" }) : null
+    selected && selectionCorrect !== null ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("p", { role: "status", "aria-live": "polite", children: selectionCorrect ? "Correct" : "Try again" }) : null,
+    props.enableRetry && passed ? /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(
+      "button",
+      {
+        type: "button",
+        "data-testid": "quiz-retry",
+        onClick: () => {
+          completedRef.current = false;
+          telemetryReplayedRef.current = false;
+          setQuizPassed(false);
+          setSelected(null);
+          setSelectionCorrect(null);
+          setCompletedScore(null);
+          setCompletedMaxScore(null);
+        },
+        children: "Try again"
+      }
+    ) : null
   ] });
 }
 var QuizInnerForwarded = (0, import_react12.forwardRef)(QuizInner);

package/dist/testing.d.cts

@@ -1,4 +1,4 @@
-export { r as resetAssessmentWarningsForTests, b as resetQuizWarningsForTests } from './AssessmentLessonGuard-D2Plzybb.cjs';
+export { r as resetAssessmentWarningsForTests, a as resetQuizWarningsForTests } from './AssessmentLessonGuard-BzNPbjaV.cjs';
 import '@lessonkit/core';
 import 'react';
 

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-export { r as resetAssessmentWarningsForTests, b as resetQuizWarningsForTests } from './AssessmentLessonGuard-D2Plzybb.js';
+export { r as resetAssessmentWarningsForTests, a as resetQuizWarningsForTests } from './AssessmentLessonGuard-BzNPbjaV.js';
 import '@lessonkit/core';
 import 'react';
 

package/dist/testing.js

@@ -1,13 +1,13 @@
 import {
   resetLessonMountRegistryForTests,
   resetQuizWarningsForTests
-} from "./chunk-UUTXECVW.js";
+} from "./chunk-ELGQ4XI3.js";
 import {
   resetAssessmentWarningsForTests,
   resetCompoundValidationWarningsForTests,
   resetCourseStartedTrackingFlightForTests,
   resetLessonkitProviderStorageForTests
-} from "./chunk-TDM3ARE7.js";
+} from "./chunk-7TJQJFYR.js";
 export {
   resetAssessmentWarningsForTests,
   resetCompoundValidationWarningsForTests,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lessonkit/react",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "private": false,
   "description": "React components and hooks for building learning experiences with LessonKit.",
   "license": "Apache-2.0",
@@ -61,16 +61,16 @@
   "scripts": {
     "build": "tsup src/index.tsx src/testing.ts src/blocks-entry.ts --format esm,cjs --dts --external react --external react-dom --external @lessonkit/accessibility --external @lessonkit/lxpack --external @lessonkit/themes",
     "dev": "tsup src/index.tsx src/testing.ts src/blocks-entry.ts --format esm,cjs --dts --watch --external react --external react-dom --external @lessonkit/accessibility --external @lessonkit/lxpack --external @lessonkit/themes",
-    "storybook": "NODE_PATH=./node_modules:../../node_modules node ../../node_modules/storybook/bin/index.cjs dev -c .storybook -p 6006 --disable-telemetry",
-    "build-storybook": "NODE_PATH=./node_modules:../../node_modules node ../../node_modules/storybook/bin/index.cjs build -c .storybook --disable-telemetry",
+    "storybook": "storybook dev -c .storybook -p 6006 --disable-telemetry",
+    "build-storybook": "storybook build -c .storybook --disable-telemetry",
     "prepublishOnly": "npm run build",
     "typecheck": "tsc -p tsconfig.json",
     "test": "vitest run --passWithNoTests",
     "test:coverage": "vitest run --coverage --passWithNoTests=false",
-    "lint": "echo \"(no lint configured yet)\""
+    "lint": "eslint --max-warnings 0 \"src/**/*.{ts,tsx}\" \"test/**/*.{ts,tsx}\" \"stories/**/*.{ts,tsx}\""
   },
   "peerDependencies": {
-    "@lessonkit/lxpack": "1.4.0",
+    "@lessonkit/lxpack": "1.5.0",
     "react": ">=18",
     "react-dom": ">=18"
   },
@@ -80,19 +80,16 @@
     }
   },
   "dependencies": {
-    "@lessonkit/accessibility": "1.4.0",
-    "@lessonkit/core": "1.4.0",
-    "@lessonkit/lxpack": "1.4.0",
-    "@lessonkit/themes": "1.4.0",
-    "@lessonkit/xapi": "1.4.0"
+    "@lessonkit/accessibility": "1.5.0",
+    "@lessonkit/core": "1.5.0",
+    "@lessonkit/lxpack": "1.5.0",
+    "@lessonkit/themes": "1.5.0",
+    "@lessonkit/xapi": "1.5.0"
   },
   "devDependencies": {
-    "@storybook/addon-essentials": "8.6.18",
-    "@storybook/addon-interactions": "8.6.18",
-    "@storybook/builder-vite": "8.6.18",
-    "@storybook/react": "8.6.18",
-    "@storybook/react-vite": "8.6.18",
-    "@storybook/test": "8.6.18",
+    "@storybook/builder-vite": "10.4.2",
+    "@storybook/react": "10.4.2",
+    "@storybook/react-vite": "10.4.2",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
@@ -100,9 +97,9 @@
     "jsdom": "^29.1.1",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
-    "storybook": "8.6.18",
+    "storybook": "10.4.2",
     "tsup": "^8.5.0",
-    "typescript": "^5.8.3",
+    "typescript": "^6.0.3",
     "vite": "^8.0.11",
     "vitest": "^4.1.8",
     "@testing-library/dom": "^10.4.1"