@intellectif/lk-react 4.0.0 → 5.0.0

package/README.md

@@ -64,6 +64,7 @@ export function Demo() {
 
 - **`<MultipleChoice>`** — single / multi select, all-or-nothing or partial scoring, deterministic per-session shuffle, per-option `feedback`.
 - **`<FillInTheBlanks>`** — `{{id}}` placeholders, case/whitespace options, per-blank `hint` (Show/Hide toggle as an icon), per-blank `feedback` shown inline on submit with a learner-controlled **Hide/Show feedback** toggle, optional `showCorrectAnswers`.
+- **`<WrittenResponse>`** — free-text writing with a live word counter and bounds messaging, graded **asynchronously**: it emits an ungraded submission (never a fake zero) and a SUBMITTED-verb xAPI statement, and renders a returned `GradeRecord` in `review` mode with per-criterion scores and inline corrections.
 - **`<ActivitySequence>`** — in-place "question set" pager (Previous/Next, "Question X of N", no scrolling, focus-managed). Accepts item groups and keeps their stimulus beside every question; `onSubmit` reports every raw answer with its `slotId`, which is the only response channel an `exam` sequence has.
 - **`<StimulusPanel>`** — a shared passage / recording / image (an item group's stimulus) as a landmark region; the sequence uses it, and a custom runner can too.
 - **Media per question** — optional `image` / `audio` / `video` / `embed` (YouTube/Vimeo iframe) above the question; alt-text required for `image`/`embed` (WCAG).
@@ -82,6 +83,7 @@ export function Demo() {
 | `@intellectif/lk-react` | Everything (barrel) |
 | `@intellectif/lk-react/components/MultipleChoice` | `<MultipleChoice>` (boundary-wrapped) |
 | `@intellectif/lk-react/components/FillInTheBlanks` | `<FillInTheBlanks>` (boundary-wrapped) |
+| `@intellectif/lk-react/components/WrittenResponse` | `<WrittenResponse>` (boundary-wrapped) |
 | `@intellectif/lk-react/components/ActivitySequence` | `<ActivitySequence>` question-set pager |
 | `@intellectif/lk-react/components/StimulusPanel` | `<StimulusPanel>` shared-stimulus region |
 | `@intellectif/lk-react/hooks/useActivityState` | Lifecycle + timing |
@@ -99,12 +101,13 @@ ESM + CJS + `.d.ts` for every entry. Tree-shakeable.
 | **Scoring** | Pure & deterministic; `all-or-nothing` and `partial`. |
 | **Feedback** | Per-item (MC per-option, FIB per-blank) shown inline on submit with Hide/Show toggle, + activity-level overall. |
 | **Retry** | Pass a new `data` reference or change the React `key` → activity resets (no built-in button — retry *policy* is yours). |
-| **Persistence / resume** | Not in the SDK — capture `onInteraction` / `onComplete` and persist as you wish. No `initialResponse` prop in V1 (cannot re-hydrate a partial attempt). |
+| **Persistence / resume** | Storage is yours — capture `onSubmit` / `onChange` / `onInteraction` and persist as you wish. Re-hydration **is** supported: pass `defaultValue` to seed a component, or `value` + `onChange` to control it outright (since 2.1.0). |
 | **Authoring / content storage / CDN / auth** | Consumer responsibility — typed schemas + `validateActivity` + JSON Schema export are provided for you to build authoring on. |
 | **SSR / RSC** | Fully supported. |
 
 ## Documentation
 
+- [Upgrading](https://github.com/intellectif/learning-kit/blob/main/docs/upgrading.md) — start here if you are on 2.x.
 - [Authoring & content storage](https://github.com/intellectif/learning-kit/blob/main/docs/authoring.md)
 - [Styling](https://github.com/intellectif/learning-kit/blob/main/docs/styling.md) — tokens, the skin, overrides, dark mode, Tailwind.
 - [Project README](https://github.com/intellectif/learning-kit#readme) — full picture & monorepo layout.

package/dist/{chunk-525EWDUT.cjs → chunk-3B4ACY4K.cjs}

@@ -2,7 +2,7 @@
 
 var chunkWCVD5LVG_cjs = require('./chunk-WCVD5LVG.cjs');
 var chunk67RIIDZX_cjs = require('./chunk-67RIIDZX.cjs');
-var chunkXQJFLAMD_cjs = require('./chunk-XQJFLAMD.cjs');
+var chunk6COTYW77_cjs = require('./chunk-6COTYW77.cjs');
 var chunkPGEG7UZJ_cjs = require('./chunk-PGEG7UZJ.cjs');
 var chunkNEWGUDA5_cjs = require('./chunk-NEWGUDA5.cjs');
 var lkCore = require('@intellectif/lk-core');
@@ -170,7 +170,7 @@ function ActivitySequence({
     }
     if (activity.type === "written-response") {
       return /* @__PURE__ */ jsxRuntime.jsx(
-        chunkXQJFLAMD_cjs.WrittenResponse,
+        chunk6COTYW77_cjs.WrittenResponse,
         {
           data: activity,
           onSubmitted: (submission) => record({ kind: "submitted", index: slotIndex, slotId, activityId, submission }),
@@ -245,5 +245,5 @@ function ActivitySequence({
 }
 
 exports.ActivitySequence = ActivitySequence;
-//# sourceMappingURL=chunk-525EWDUT.cjs.map
-//# sourceMappingURL=chunk-525EWDUT.cjs.map
+//# sourceMappingURL=chunk-3B4ACY4K.cjs.map
+//# sourceMappingURL=chunk-3B4ACY4K.cjs.map

package/dist/{chunk-525EWDUT.cjs.map → chunk-3B4ACY4K.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/ActivitySequence/ActivitySequence.tsx"],"names":["useRef","useEffect","jsx","isItemGroup","randomSessionId","useMemo","flattenSequence","useState","current","MultipleChoice","FillInTheBlanks","WrittenResponse","jsxs","StimulusPanel"],"mappings":";;;;;;;;;;;AAuKA,SAAS,WAAW,IAAA,EAAgD;AAClE,EAAA,OAAO,KAAK,MAAA,CAAO,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,KAAK,IAAA,CAAK,MAAA;AAC3C;AAwBA,SAAS,YAAA,CAAa;AAAA,EACpB,SAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAA,EAIsB;AACpB,EAAA,MAAM,GAAA,GAAMA,aAAuB,IAAI,CAAA;AAEvC,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA;AAAA,IACF;AACA,IAAA,MAAM,OAAO,GAAA,CAAI,OAAA;AACjB,IAAA,IAAI,SAAS,IAAA,EAAM;AACjB,MAAA;AAAA,IACF;AACA,IAAA,KAAA,MAAW,KAAA,IAAS,IAAA,CAAK,gBAAA,CAAiB,cAAc,CAAA,EAAG;AACzD,MAAA,MAAM,OAAA,GAAU,KAAA;AAChB,MAAA,IAAI,CAAC,QAAQ,MAAA,EAAQ;AACnB,QAAA,OAAA,CAAQ,KAAA,EAAM;AAAA,MAChB;AAAA,IACF;AAAA,EACF,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,uBACEC,cAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAsB,MAAA,EAAgB,KACxC,QAAA,EACH,CAAA;AAEJ;AAcO,SAAS,gBAAA,CAAiB;AAAA,EAC/B,UAAA;AAAA,EACA,SAAA;AAAA,EACA,kBAAA;AAAA,EACA,UAAA;AAAA,EACA,UAAA;AAAA,EACA,QAAA;AAAA,EACA,aAAA;AAAA,EACA,UAAA,GAAa,UAAA;AAAA,EACb,OAAA;AAAA,EACA,WAAA;AAAA,EACA,YAAA;AAAA,EACA,KAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAA,EAA6C;AAC3C,EAAA,MAAM,YAAA,GAAeF,aAAsB,IAAI,CAAA;AAI/C,EAAA,MAAM,iBAAiB,OAAA,KAAY,SAAA;AACnC,EAAA,MAAM,SAAA,GACJ,cAAA,IACA,UAAA,CAAW,IAAA,CAAK,CAAC,KAAA,KAAUG,kBAAA,CAAY,KAAK,CAAA,IAAK,KAAA,CAAM,OAAA,KAAY,cAAc,CAAA;AAMnF,EAAA,IAAI,SAAA,IAAa,WAAA,KAAgB,MAAA,IAAa,UAAA,KAAe,UAAA,EAAY;AACvE,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,iCAAiC,UAAU,CAAA,uNAAA;AAAA,KAG7C;AAAA,EACF;AAKA,EAAA,MAAM,IAAA,GAAO,SAAA;AAAA;AAAA,IAER,WAAA,KAAgB,YAAA,CAAa,OAAA,KAAYC,iCAAA,EAAgB;AAAA,MAC1D,MAAA;AACJ,EAAA,MAAM,KAAA,GAAQC,aAAA;AAAA,IACZ,MAAMC,sBAAA,CAAgB,UAAA,EAAY,EAAE,cAAA,EAAgB,GAAI,IAAA,KAAS,MAAA,GAAY,EAAE,IAAA,EAAK,GAAI,IAAK,CAAA;AAAA,IAC7F,CAAC,UAAA,EAAY,cAAA,EAAgB,IAAI;AAAA,GACnC;AAEA,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIC,eAAS,CAAC,CAAA;AAOpC,EAAA,MAAM,WAAA,GAAcP,aAA8C,IAAI,CAAA;AACtE,EAAA,IAAI,WAAA,CAAY,YAAY,IAAA,EAAM;AAChC,IAAA,WAAA,CAAY,OAAA,GAAU,KAAA,CAAM,GAAA,CAAI,MAAM,IAAI,CAAA;AAAA,EAC5C;AACA,EAAA,MAAM,SAAA,GAAYA,aAAuB,IAAI,CAAA;AAC7C,EAAA,MAAM,UAAA,GAAaA,aAAO,KAAK,CAAA;AAS/B,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,SAAA,CAAU,KAAA,CAAM,IAAI,CAAC,IAAA,KAAS,CAAC,IAAA,CAAK,MAAA,EAAQ,IAAA,CAAK,QAAA,CAAS,EAAE,CAAC,CAAC,CAAA;AAClF,EAAA,MAAM,CAAC,UAAA,EAAY,aAAa,CAAA,GAAIO,eAAS,MAAM,CAAA;AACnD,EAAA,IAAI,eAAe,MAAA,EAAQ;AACzB,IAAA,aAAA,CAAc,MAAM,CAAA;AACpB,IAAA,QAAA,CAAS,CAAC,CAAA;AACV,IAAA,WAAA,CAAY,OAAA,GAAU,KAAA,CAAM,GAAA,CAAI,MAAM,IAAI,CAAA;AAAA,EAC5C;AAKA,EAAAN,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,WAAW,OAAA,EAAS;AACtB,MAAA,SAAA,CAAU,SAAS,KAAA,EAAM;AAAA,IAC3B,CAAA,MAAO;AACL,MAAA,UAAA,CAAW,OAAA,GAAU,IAAA;AAAA,IACvB;AAAA,EACF,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAGV,EAAA,MAAM,cAAA,GAAiBI,cAAyB,MAAM;AACpD,IAAA,MAAM,MAAA,uBAAa,GAAA,EAA2B;AAC9C,IAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,MAAA,IAAI,IAAA,CAAK,UAAU,MAAA,EAAW;AAC5B,QAAA;AAAA,MACF;AACA,MAAA,MAAM,QAAA,GAAW,WAAW,IAAI,CAAA;AAChC,MAAA,MAAM,QAAA,GAAW,MAAA,CAAO,GAAA,CAAI,QAAQ,CAAA;AACpC,MAAA,IAAI,aAAa,MAAA,EAAW;AAC1B,QAAA,MAAA,CAAO,GAAA,CAAI,QAAA,EAAU,EAAE,QAAA,EAAU,KAAA,EAAO,IAAA,CAAK,KAAA,EAAO,KAAA,EAAO,IAAA,CAAK,KAAA,EAAO,IAAA,EAAM,IAAA,CAAK,OAAO,CAAA;AAAA,MAC3F,CAAA,MAAO;AACL,QAAA,QAAA,CAAS,OAAO,IAAA,CAAK,KAAA;AAAA,MACvB;AAAA,IACF;AACA,IAAA,OAAO,CAAC,GAAG,MAAA,CAAO,MAAA,EAAQ,CAAA;AAAA,EAC5B,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,MAAM,QAAQ,KAAA,CAAM,MAAA;AACpB,EAAA,MAAM,OAAA,GAAU,MAAM,KAAK,CAAA;AAE3B,EAAA,MAAM,EAAA,GAAK,CAAC,IAAA,KAAuB;AACjC,IAAA,QAAA,CAAS,IAAI,CAAA;AAAA,EACf,CAAA;AAQA,EAAA,MAAM,MAAA,GAAS,CAAC,OAAA,KAAuC;AACrD,IAAA,MAAMG,WAAU,WAAA,CAAY,OAAA;AAC5B,IAAA,IAAIA,aAAY,IAAA,IAAQA,QAAAA,CAAQ,OAAA,CAAQ,KAAK,KAAK,IAAA,EAAM;AACtD,MAAA;AAAA,IACF;AACA,IAAA,MAAM,IAAA,GAAOA,SAAQ,KAAA,EAAM;AAC3B,IAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,CAAA,GAAI,OAAA;AAGtB,IAAA,WAAA,CAAY,OAAA,GAAU,IAAA;AAEtB,IAAA,IAAI,OAAA,CAAQ,SAAS,QAAA,EAAU;AAC7B,MAAA,kBAAA,GAAqB,OAAA,CAAQ,MAAA,EAAQ,OAAA,CAAQ,KAAA,EAAO,QAAQ,MAAM,CAAA;AAAA,IACpE;AAEA,IAAA,IAAI,CAAC,IAAA,CAAK,KAAA,CAAM,CAAC,IAAA,KAAsC,IAAA,KAAS,IAAI,CAAA,EAAG;AACrE,MAAA;AAAA,IACF;AACA,IAAA,UAAA,GAAa,IAAI,CAAA;AAKjB,IAAA,MAAM,SAA2B,EAAC;AAClC,IAAA,KAAA,MAAW,QAAQ,IAAA,EAAM;AACvB,MAAA,IAAI,IAAA,CAAK,SAAS,QAAA,EAAU;AAC1B,QAAA;AAAA,MACF;AACA,MAAA,MAAA,CAAO,IAAA,CAAK,KAAK,MAAM,CAAA;AAAA,IACzB;AACA,IAAA,UAAA,GAAa,MAAM,CAAA;AAAA,EACrB,CAAA;AAEA,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,uBAAON,cAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,QAAA,EAAS,CAAA;AAAA,EACjC;AAEA,EAAA,MAAM,SAAA,GAAY;AAAA,IAChB,GAAI,aAAA,GAAgB,EAAE,aAAA,KAAkB,EAAC;AAAA,IACzC,UAAA;AAAA,IACA,GAAI,YAAA,GAAe,EAAE,YAAA,KAAiB,EAAC;AAAA,IACvC,GAAI,KAAA,GAAQ,EAAE,KAAA,KAAU,EAAC;AAAA,IACzB,GAAI,MAAA,GAAS,EAAE,MAAA,KAAW,EAAC;AAAA,IAC3B,GAAI,QAAA,GAAW,EAAE,QAAA,KAAa;AAAC,GACjC;AAEA,EAAA,MAAM,UAAA,GAAa,CAAC,IAAA,KAA8D;AAChF,IAAA,MAAM,WAAW,IAAA,CAAK,QAAA;AACtB,IAAA,MAAM,EAAE,MAAA,EAAQ,KAAA,EAAO,SAAA,EAAU,GAAI,IAAA;AACrC,IAAA,MAAM,aAAa,QAAA,CAAS,EAAA;AAC5B,IAAA,MAAM,UAAA,GAAa;AAAA,MACjB,UAAA,EAAY,CAAC,MAAA,KACX,MAAA,CAAO,EAAE,IAAA,EAAM,QAAA,EAAU,KAAA,EAAO,SAAA,EAAW,MAAA,EAAQ,UAAA,EAAY,MAAA,EAAQ,CAAA;AAAA,MACzE,QAAA,EAAU,CAAC,QAAA,KAA8B;AACvC,QAAA,QAAA,GAAW,UAAU,EAAE,MAAA,EAAQ,KAAA,EAAO,SAAA,EAAW,YAAY,CAAA;AAM7D,QAAA,IAAI,UAAA,KAAe,UAAA,IAAc,QAAA,CAAS,IAAA,KAAS,kBAAA,EAAoB;AACrE,UAAA,MAAA,CAAO,EAAE,MAAM,WAAA,EAAa,KAAA,EAAO,WAAW,MAAA,EAAQ,UAAA,EAAY,UAAU,CAAA;AAAA,QAC9E;AAAA,MACF,CAAA;AAAA,MACA,GAAG;AAAA,KACL;AAEA,IAAA,MAAM,cAAA,GAAiB,SAAA,GAAY,QAAA,CAAS,IAAI,CAAA;AAChD,IAAA,IAAI,cAAA,EAAgB;AAClB,MAAA,uBAAOA,cAAA,CAAC,cAAA,EAAA,EAAe,IAAA,EAAM,QAAA,EAAW,GAAG,UAAA,EAAY,CAAA;AAAA,IACzD;AACA,IAAA,IAAI,QAAA,CAAS,SAAS,iBAAA,EAAmB;AACvC,MAAA,uBAAOA,cAAA,CAACO,gCAAA,EAAA,EAAe,IAAA,EAAM,QAAA,EAAW,GAAG,UAAA,EAAY,CAAA;AAAA,IACzD;AACA,IAAA,IAAI,QAAA,CAAS,SAAS,oBAAA,EAAsB;AAC1C,MAAA,uBAAOP,cAAA,CAACQ,iCAAA,EAAA,EAAgB,IAAA,EAAM,QAAA,EAAW,GAAG,UAAA,EAAY,CAAA;AAAA,IAC1D;AACA,IAAA,IAAI,QAAA,CAAS,SAAS,kBAAA,EAAoB;AACxC,MAAA,uBACER,cAAA;AAAA,QAACS,iCAAA;AAAA,QAAA;AAAA,UACC,IAAA,EAAM,QAAA;AAAA,UACN,WAAA,EAAa,CAAC,UAAA,KACZ,MAAA,CAAO,EAAE,IAAA,EAAM,WAAA,EAAa,KAAA,EAAO,SAAA,EAAW,MAAA,EAAQ,UAAA,EAAY,UAAA,EAAY,CAAA;AAAA,UAKhF,UAAU,UAAA,CAAW,QAAA;AAAA,UACpB,GAAG;AAAA;AAAA,OACN;AAAA,IAEJ;AACA,IAAA,sCACG,KAAA,EAAA,EAAI,SAAA,EAAU,oBAAA,EAAqB,IAAA,EAAK,QAAO,QAAA,EAAA,4EAAA,EAEhD,CAAA;AAAA,EAEJ,CAAA;AAEA,EAAA,MAAM,eAAA,GAAkB,WAAW,OAAO,CAAA;AAE1C,EAAA,uBACEC,eAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,QAAA,EAAS,MAAM,MAAA,EAC5B,QAAA,EAAA;AAAA,oBAAAA,eAAA,CAAC,SAAI,SAAA,EAAU,iBAAA,EAAkB,WAAA,EAAU,QAAA,EAAS,MAAK,QAAA,EAAS,QAAA,EAAA;AAAA,MAAA,WAAA;AAAA,MACtD,KAAA,GAAQ,CAAA;AAAA,MAAE,MAAA;AAAA,MAAK;AAAA,KAAA,EAC3B,CAAA;AAAA,IAiBC,cAAA,CAAe,IAAI,CAAC,EAAE,UAAU,KAAA,EAAO,KAAA,EAAO,MAAK,qBAClDV,cAAA;AAAA,MAAC,YAAA;AAAA,MAAA;AAAA,QACC,SAAA,EAAU,iBAAA;AAAA,QACV,QAAQ,QAAA,KAAa,eAAA;AAAA,QAGrB,QAAA,kBAAAA,cAAA;AAAA,UAACW,+BAAA;AAAA,UAAA;AAAA,YACC,UAAU,KAAA,CAAM,QAAA;AAAA,YAChB,OAAO,EAAE,KAAA,EAAO,QAAQ,CAAA,EAAG,IAAA,EAAM,OAAO,CAAA,EAAE;AAAA,YACzC,GAAI,YAAA,GAAe,EAAE,YAAA,KAAiB,EAAC;AAAA,YACvC,GAAI,MAAA,GAAS,EAAE,MAAA,KAAW;AAAC;AAAA;AAC9B,OAAA;AAAA,MAPK,SAAS,QAAQ,CAAA;AAAA,KASzB,CAAA;AAAA,oBAEDX,cAAA;AAAA,MAAC,SAAA;AAAA,MAAA;AAAA,QACC,SAAA,EAAU,iBAAA;AAAA,QACV,GAAA,EAAK,SAAA;AAAA,QACL,QAAA,EAAU,EAAA;AAAA,QACV,YAAA,EAAY,CAAA,SAAA,EAAY,KAAA,GAAQ,CAAC,OAAO,KAAK,CAAA,CAAA;AAAA,QAU5C,QAAA,EAAA,KAAA,CAAM,GAAA,CAAI,CAAC,IAAA,KAAS;AAcnB,UAAA,MAAM,OAAA,GAAU,GAAG,MAAM,CAAA,OAAA,EAAU,KAAK,MAAM,CAAA,CAAA,EAAI,IAAA,CAAK,QAAA,CAAS,EAAE,CAAA,CAAA;AAClE,UAAA,uBACEA,cAAA,CAAC,YAAA,EAAA,EAAa,SAAA,EAAU,aAAA,EAAc,MAAA,EAAQ,IAAA,CAAK,KAAA,KAAU,KAAA,EAC1D,QAAA,EAAA,UAAA,CAAW,IAAI,CAAA,EAAA,EADuD,OAEzE,CAAA;AAAA,QAEJ,CAAC;AAAA;AAAA,KACH;AAAA,oBAEAU,eAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,YAAA,EACb,QAAA,EAAA;AAAA,sBAAAV,cAAA;AAAA,QAAC,QAAA;AAAA,QAAA;AAAA,UACC,IAAA,EAAK,QAAA;AAAA,UACL,SAAA,EAAU,aAAA;AAAA,UACV,OAAA,EAAS,MAAM,EAAA,CAAG,KAAA,GAAQ,CAAC,CAAA;AAAA,UAC3B,UAAU,KAAA,KAAU,CAAA;AAAA,UACrB,QAAA,EAAA;AAAA;AAAA,OAED;AAAA,sBACAA,cAAA;AAAA,QAAC,QAAA;AAAA,QAAA;AAAA,UACC,IAAA,EAAK,QAAA;AAAA,UACL,SAAA,EAAU,aAAA;AAAA,UACV,OAAA,EAAS,MAAM,EAAA,CAAG,KAAA,GAAQ,CAAC,CAAA;AAAA,UAC3B,QAAA,EAAU,UAAU,KAAA,GAAQ,CAAA;AAAA,UAC7B,QAAA,EAAA;AAAA;AAAA;AAED,KAAA,EACF;AAAA,GAAA,EACF,CAAA;AAEJ","file":"chunk-525EWDUT.cjs","sourcesContent":["'use client';\n\nimport {\n  type ActivityResult,\n  flattenSequence,\n  type InteractionEvent,\n  isItemGroup,\n  type LearnerResponse,\n  type SequenceEntry,\n  type SequenceSlot,\n  type SequenceSlotGroup,\n  type ThemeTokens,\n} from '@intellectif/lk-core';\nimport { type ComponentType, useEffect, useMemo, useRef, useState } from 'react';\nimport { randomSessionId } from '../_internal.js';\nimport { FillInTheBlanks } from '../FillInTheBlanks/index.js';\nimport { MultipleChoice } from '../MultipleChoice/index.js';\nimport { StimulusPanel } from '../StimulusPanel/index.js';\nimport type { ActivityProps, HtmlSanitizer, RenderableActivity, RenderMode } from '../types.js';\nimport { WrittenResponse, type WrittenResponseSubmission } from '../WrittenResponse/index.js';\n\n/**\n * What one finished slot in a sequence produced. Two kinds, because two kinds\n * of activity exist: those the SDK scores at submit time, and those a grader\n * scores later. Collapsing them would mean inventing a score for ungraded\n * work — the exact defect the deferred outcome exists to prevent.\n */\nexport type SequenceItemOutcome =\n  | {\n      kind: 'scored';\n      /** Presented position. */\n      index: number;\n      /** Slot identity from `flattenSequence` — stable under shuffling; the `slotId` to score with. */\n      slotId: string;\n      activityId: string;\n      result: ActivityResult;\n    }\n  | {\n      kind: 'submitted';\n      index: number;\n      slotId: string;\n      activityId: string;\n      /** Ungraded submission; the grade arrives asynchronously. */\n      submission: WrittenResponseSubmission;\n    }\n  | {\n      kind: 'responded';\n      index: number;\n      slotId: string;\n      activityId: string;\n      /**\n       * The raw answer, with no grade of any kind. This is what an `exam` slot\n       * produces: the client is forbidden to score, so a response is all there\n       * is until the server grades it.\n       */\n      response: LearnerResponse;\n    };\n\n/**\n * A component that can render one activity inside a sequence. Register one per\n * activity `type` to put a consumer-defined type on screen — the React half of\n * the activity-type registry, matching `registerActivityType` in lk-core.\n */\nexport type ActivityRenderer = ComponentType<ActivityProps>;\n\nexport interface ActivitySequenceProps {\n  /**\n   * The ordered set of entries to present, one question at a time: loose\n   * activities, and item groups — a shared passage, recording or image with\n   * the questions that refer to it. A group's stimulus stays on screen\n   * alongside each of its questions.\n   *\n   * Accepts `redact()` projections. For data straight off a server, pass it\n   * through `asRenderableSequence()` — see that helper for why a cast is\n   * unavoidable there — and set `renderMode=\"exam\"`.\n   */\n  activities: readonly SequenceEntry<RenderableActivity>[];\n  /**\n   * Renderers for activity types beyond the built-ins, keyed by `data.type`.\n   * A key matching a built-in overrides it, so a consumer can replace the\n   * bundled renderer without forking the sequencer.\n   */\n  renderers?: Readonly<Record<string, ActivityRenderer>>;\n  /**\n   * Called whenever an individual activity is scored at submit time — the\n   * incremental persist hook.\n   *\n   * `slotId` is the identity to store the result against, NOT `index`.\n   * `index` is where the question was PRESENTED, which is not stable: it moves\n   * under shuffling, and it already differs from the slot identity whenever a\n   * group is present (the second entry of a sequence is presented at index 1\n   * but is slot `\"1.0\"` if it is a group's first question). `composeAssessmentScore`\n   * scores by `slotId`, so persisting `index` cannot be reconciled with it.\n   */\n  onActivityComplete?: (result: ActivityResult, index: number, slotId: string) => void;\n  /**\n   * Called on every submit with the learner's raw response and the identity of\n   * the slot that produced it — before any grading, in every render mode.\n   *\n   * **This is the only response channel an `exam` sequence has.** In `exam`\n   * mode the components never grade, so `onActivityComplete` cannot fire and\n   * `onComplete` never will; without this prop nothing a learner submitted\n   * would reach the consumer at all. Persist `response` against `slotId`.\n   */\n  onSubmit?: (\n    response: LearnerResponse,\n    slot: { slotId: string; index: number; activityId: string },\n  ) => void;\n  /**\n   * Called once every activity has been completed, with the scored results.\n   *\n   * Fires only when EVERY item produced a score. A set containing a\n   * deferred-graded activity (a written response) can never satisfy that, so\n   * use `onFinished` for mixed sets — it is the general completion signal and\n   * reports both kinds of outcome. It also carries `slotId` per item, which\n   * this callback's bare array cannot.\n   */\n  onComplete?: (results: ActivityResult[]) => void;\n  /**\n   * Called once every activity has been completed, whether it was scored at\n   * submit time or submitted for later grading. Use this for any set that\n   * mixes graded and deferred-graded activities.\n   */\n  onFinished?: (items: SequenceItemOutcome[]) => void;\n  /** Forwarded to each activity. */\n  onInteraction?: (event: InteractionEvent) => void;\n  /** Forwarded to each activity. `exam` and `review` disable local scoring. */\n  renderMode?: RenderMode;\n  /**\n   * `entries` shuffles the top-level entries; a group moves as one block, and\n   * the order INSIDE a group follows the group's own `shuffle` setting.\n   * Default `none`: authored order.\n   */\n  shuffle?: 'none' | 'entries';\n  /**\n   * Seed for every shuffle in this sequence (`shuffle: 'entries'` and any\n   * group with `shuffle: 'within-group'`). Supply the attempt id, so the\n   * server's `flattenSequence(entries, { seed })` derives the same order this\n   * pager shows.\n   *\n   * **Required in `exam` and `review` mode** — omitting it throws. An order\n   * nobody can reproduce cannot be reconciled with a recorded attempt, and\n   * failing at render is the only way that mistake surfaces before a learner\n   * sits the paper. In `practice` mode it stays optional: a random per-mount\n   * seed is used, which is stable within the mount and deliberately not\n   * reproducible. That fallback is also not SSR-safe (server and client would\n   * invent different orders and hydration would mismatch), so supply a seed\n   * for any server-rendered sequence regardless of mode.\n   */\n  shuffleSeed?: string;\n  /** Renders author-supplied rich text; forwarded to the stimulus panel and every activity. */\n  sanitizeHtml?: HtmlSanitizer;\n  theme?: Partial<ThemeTokens>;\n  locale?: string;\n  disabled?: boolean;\n}\n\n/** One stimulus panel to keep mounted: the group, and the presented span of its questions. */\ninterface StimulusMount {\n  /** Authored entry position — unique per group in the sequence even if two groups share an id. */\n  entryKey: string;\n  group: SequenceSlotGroup;\n  first: number;\n  last: number;\n}\n\n/** The authored-entry prefix of a slot id: `\"3\"` for `\"3\"` and for `\"3.1\"`. */\nfunction entryKeyOf(slot: SequenceSlot<RenderableActivity>): string {\n  return slot.slotId.split('.')[0] ?? slot.slotId;\n}\n\n/**\n * A pane that is kept MOUNTED but shown only when it is the current one, and\n * that stops any media it contains on the way out.\n *\n * `hidden` alone is not enough. It resolves to `display: none`, and CSS does\n * not touch playback: an `<audio>` or `<video>` inside a hidden subtree keeps\n * playing to the end. (The HTML spec pauses a media element when it is\n * REMOVED from the document — a different thing, and the thing this pager\n * deliberately does not do, because unmounting is what used to destroy the\n * learner's answers.) So a recording started for one question would carry on\n * underneath the next, which for a listening paper means the passage plays\n * while the learner is somewhere else entirely.\n *\n * Pausing preserves `currentTime`: coming back to a group resumes where the\n * learner left off. Nothing auto-plays on the way in — starting audio the\n * learner did not ask for is its own defect.\n *\n * `embed` media (a provider iframe) cannot be paused this way: controlling a\n * third-party player needs its own JS API, which the SDK has no reliable\n * access to because the author supplies the embed URL. Use `audio`/`video`\n * media for anything that must stop when the learner navigates.\n */\nfunction SequencePane({\n  className,\n  hidden,\n  children,\n}: {\n  className: string;\n  hidden: boolean;\n  children: React.ReactNode;\n}): React.JSX.Element {\n  const ref = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    if (!hidden) {\n      return;\n    }\n    const node = ref.current;\n    if (node === null) {\n      return;\n    }\n    for (const media of node.querySelectorAll('audio, video')) {\n      const element = media as HTMLMediaElement;\n      if (!element.paused) {\n        element.pause();\n      }\n    }\n  }, [hidden]);\n\n  return (\n    <div className={className} hidden={hidden} ref={ref}>\n      {children}\n    </div>\n  );\n}\n\n/**\n * Presents a set of activities as an in-place pager: one question visible at a\n * time, navigated with Prev/Next (no page scrolling). Linear free navigation —\n * the learner may move back and forth; activities keep their own submit and\n * scoring. On navigation, focus moves to the question region and the position\n * is announced via an aria-live region.\n *\n * Item groups are flattened into consecutive questions; the group's stimulus\n * is mounted ONCE, beside the question region rather than inside it, and shown\n * alongside every question in the group — so a passage stays put, and a\n * recording keeps its position, as the learner moves between its questions.\n */\nexport function ActivitySequence({\n  activities,\n  renderers,\n  onActivityComplete,\n  onComplete,\n  onFinished,\n  onSubmit,\n  onInteraction,\n  renderMode = 'practice',\n  shuffle,\n  shuffleSeed,\n  sanitizeHtml,\n  theme,\n  locale,\n  disabled,\n}: ActivitySequenceProps): React.JSX.Element {\n  const sessionIdRef = useRef<string | null>(null);\n\n  // The presented order comes from lk-core, never computed here: the server\n  // that records an attempt calls the same function with the same seed.\n  const shuffleEntries = shuffle === 'entries';\n  const needsSeed =\n    shuffleEntries ||\n    activities.some((entry) => isItemGroup(entry) && entry.shuffle === 'within-group');\n\n  // An unreproducible order is a practice-only affordance. Under `exam` or\n  // `review` the server has to be able to rebuild exactly what the learner\n  // saw, so a missing seed is an error rather than something to paper over —\n  // the same reason `flattenSequence` refuses to invent one.\n  if (needsSeed && shuffleSeed === undefined && renderMode !== 'practice') {\n    throw new Error(\n      `ActivitySequence: renderMode \"${renderMode}\" requires a \\`shuffleSeed\\` when shuffling ` +\n        '(shuffle=\"entries\", or a group with shuffle: \"within-group\"). Pass the attempt id, so ' +\n        \"the server's flattenSequence(entries, { seed }) reproduces the order the learner saw.\",\n    );\n  }\n\n  // Lazily created only when shuffling in practice without a caller seed (same\n  // contract as MultipleChoice.shuffleSeed): a per-mount session seed, stable\n  // across re-renders, never reproducible.\n  const seed = needsSeed\n    ? // biome-ignore lint/suspicious/noAssignInExpressions: sanctioned lazy ref initialization\n      (shuffleSeed ?? (sessionIdRef.current ??= randomSessionId()))\n    : undefined;\n  const slots = useMemo(\n    () => flattenSequence(activities, { shuffleEntries, ...(seed !== undefined ? { seed } : {}) }),\n    [activities, shuffleEntries, seed],\n  );\n\n  const [index, setIndex] = useState(0);\n  // Outcomes live in a ref, not state: nothing renders from them, and a ref is\n  // written SYNCHRONOUSLY. Reading them from a `useState` closure meant two\n  // slots completing in the same tick both saw the pre-update array — the\n  // second overwrote the first, so one answer vanished and completion never\n  // fired. Every slot is mounted at once here, so same-tick completions are\n  // reachable (a custom renderer that completes from a mount effect).\n  const outcomesRef = useRef<(SequenceItemOutcome | null)[] | null>(null);\n  if (outcomesRef.current === null) {\n    outcomesRef.current = slots.map(() => null);\n  }\n  const regionRef = useRef<HTMLDivElement>(null);\n  const mountedRef = useRef(false);\n\n  // Reset pager position and outcomes when the presented SET changes (B8):\n  // without this, results from the previous set leak into the new one and can\n  // fire completion with a mixed old/new array. Keyed on the set's CONTENT\n  // identity (ordered slot and activity ids), not the array reference — a\n  // parent that re-creates a structurally identical array on every render\n  // (inline literals, .map() in render) must not wipe in-progress answers.\n  // JSON.stringify (not join) so ids containing the separator cannot collide.\n  const setKey = JSON.stringify(slots.map((slot) => [slot.slotId, slot.activity.id]));\n  const [prevSetKey, setPrevSetKey] = useState(setKey);\n  if (prevSetKey !== setKey) {\n    setPrevSetKey(setKey);\n    setIndex(0);\n    outcomesRef.current = slots.map(() => null);\n  }\n\n  // After a navigation (not the initial mount) move focus to the question\n  // region so screen-reader / keyboard users land on the new question.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: index is the intended trigger\n  useEffect(() => {\n    if (mountedRef.current) {\n      regionRef.current?.focus();\n    } else {\n      mountedRef.current = true;\n    }\n  }, [index]);\n\n  // One panel per group, spanning the presented positions of its questions.\n  const stimulusMounts = useMemo<StimulusMount[]>(() => {\n    const mounts = new Map<string, StimulusMount>();\n    for (const slot of slots) {\n      if (slot.group === undefined) {\n        continue;\n      }\n      const entryKey = entryKeyOf(slot);\n      const existing = mounts.get(entryKey);\n      if (existing === undefined) {\n        mounts.set(entryKey, { entryKey, group: slot.group, first: slot.index, last: slot.index });\n      } else {\n        existing.last = slot.index;\n      }\n    }\n    return [...mounts.values()];\n  }, [slots]);\n\n  const total = slots.length;\n  const current = slots[index];\n\n  const go = (next: number): void => {\n    setIndex(next);\n  };\n\n  /**\n   * Records a finished slot and fires completion callbacks when the set is\n   * done. A slot that already holds an outcome is FINAL: re-recording it would\n   * fire completion a second time for one attempt, so a consumer persisting on\n   * `onFinished` would write the same attempt twice.\n   */\n  const record = (outcome: SequenceItemOutcome): void => {\n    const current = outcomesRef.current;\n    if (current === null || current[outcome.index] != null) {\n      return;\n    }\n    const next = current.slice();\n    next[outcome.index] = outcome;\n    // Commit before firing anything: a second record() in the same tick must\n    // see this one.\n    outcomesRef.current = next;\n\n    if (outcome.kind === 'scored') {\n      onActivityComplete?.(outcome.result, outcome.index, outcome.slotId);\n    }\n\n    if (!next.every((item): item is SequenceItemOutcome => item !== null)) {\n      return;\n    }\n    onFinished?.(next);\n\n    // `onComplete` predates deferred grading and promises ActivityResult[].\n    // Fire it only when every slot really was scored, rather than inventing a\n    // result for work nobody has graded.\n    const scored: ActivityResult[] = [];\n    for (const item of next) {\n      if (item.kind !== 'scored') {\n        return;\n      }\n      scored.push(item.result);\n    }\n    onComplete?.(scored);\n  };\n\n  if (!current) {\n    return <div className=\"lk-seq\" />;\n  }\n\n  const forwarded = {\n    ...(onInteraction ? { onInteraction } : {}),\n    renderMode,\n    ...(sanitizeHtml ? { sanitizeHtml } : {}),\n    ...(theme ? { theme } : {}),\n    ...(locale ? { locale } : {}),\n    ...(disabled ? { disabled } : {}),\n  };\n\n  const renderSlot = (slot: SequenceSlot<RenderableActivity>): React.JSX.Element => {\n    const activity = slot.activity;\n    const { slotId, index: slotIndex } = slot;\n    const activityId = activity.id;\n    const childProps = {\n      onComplete: (result: ActivityResult) =>\n        record({ kind: 'scored', index: slotIndex, slotId, activityId, result }),\n      onSubmit: (response: LearnerResponse) => {\n        onSubmit?.(response, { slotId, index: slotIndex, activityId });\n        // Outside `practice` the components do not grade, so a raw response is\n        // the ONLY outcome this slot will ever produce — record it, or the set\n        // could never complete and `onFinished` would be dead in exam mode.\n        // Written responses are excluded because they report something richer\n        // through `onSubmitted` a moment later, and the first outcome wins.\n        if (renderMode !== 'practice' && activity.type !== 'written-response') {\n          record({ kind: 'responded', index: slotIndex, slotId, activityId, response });\n        }\n      },\n      ...forwarded,\n    };\n\n    const CustomRenderer = renderers?.[activity.type];\n    if (CustomRenderer) {\n      return <CustomRenderer data={activity} {...childProps} />;\n    }\n    if (activity.type === 'multiple-choice') {\n      return <MultipleChoice data={activity} {...childProps} />;\n    }\n    if (activity.type === 'fill-in-the-blanks') {\n      return <FillInTheBlanks data={activity} {...childProps} />;\n    }\n    if (activity.type === 'written-response') {\n      return (\n        <WrittenResponse\n          data={activity}\n          onSubmitted={(submission) =>\n            record({ kind: 'submitted', index: slotIndex, slotId, activityId, submission })\n          }\n          // Explicit rather than spread: WrittenResponse has no `onComplete`\n          // (it never grades), so `childProps` does not fit it — but it must\n          // still report the raw response like every other slot.\n          onSubmit={childProps.onSubmit}\n          {...forwarded}\n        />\n      );\n    }\n    return (\n      <div className=\"lk-seq-unsupported\" role=\"note\">\n        This activity type has no renderer. Supply one through the renderers prop.\n      </div>\n    );\n  };\n\n  const currentEntryKey = entryKeyOf(current);\n\n  return (\n    <div className=\"lk-seq\" lang={locale}>\n      <div className=\"lk-seq-progress\" aria-live=\"polite\" role=\"status\">\n        Question {index + 1} of {total}\n      </div>\n\n      {/*\n        Each group's stimulus is mounted ONCE and only hidden while the current\n        question is outside its group. That — not re-rendering it per slot — is\n        what makes the passage the same DOM node throughout, and what lets a\n        recording keep its position between questions of one group.\n\n        It sits BESIDE the question region, not inside it. Inside, every\n        navigation dropped focus onto a container whose first content was the\n        whole passage: the region promised \"Question 3 of 5\" and then began\n        with the passage, keyboard users tabbed through the stimulus (audio\n        controls included) before reaching the question, and the passage was a\n        landmark nested inside another landmark. As a sibling it stays a\n        landmark the learner can jump back to, while focus lands on the\n        question that was actually navigated to.\n      */}\n      {stimulusMounts.map(({ entryKey, group, first, last }) => (\n        <SequencePane\n          className=\"lk-seq-stimulus\"\n          hidden={entryKey !== currentEntryKey}\n          key={`group-${entryKey}`}\n        >\n          <StimulusPanel\n            stimulus={group.stimulus}\n            range={{ first: first + 1, last: last + 1 }}\n            {...(sanitizeHtml ? { sanitizeHtml } : {})}\n            {...(locale ? { locale } : {})}\n          />\n        </SequencePane>\n      ))}\n\n      <section\n        className=\"lk-seq-question\"\n        ref={regionRef}\n        tabIndex={-1}\n        aria-label={`Question ${index + 1} of ${total}`}\n      >\n        {/*\n          Every slot stays MOUNTED; only the current one is visible. Rendering\n          just the current activity unmounted the others, so navigating back to\n          an answered question showed it blank and re-answerable — the learner\n          silently lost their answer and a second submit fired completion\n          again. `hidden` removes the inactive slots from the accessibility\n          tree and from tab order, so only the current question is reachable.\n        */}\n        {slots.map((slot) => {\n          // The slot id (authored position) plus the activity id: the same\n          // activity may legitimately fill two slots, and each must keep its\n          // own answer state; and a different activity in the same slot must\n          // remount rather than inherit the previous one's state.\n          //\n          // `setKey` leads, so a set change remounts every child. Without it a\n          // pure REORDER changed `setKey` — clearing the outcomes — while each\n          // child kept its key and therefore its `completed` state. Those\n          // slots could not be answered again and no outcome would ever refill\n          // them, so the sequence could never finish. A reset has to reset\n          // both halves or neither. A parent re-creating a structurally\n          // identical array leaves `setKey` untouched, so answers still\n          // survive that.\n          const slotKey = `${setKey}::slot-${slot.slotId}-${slot.activity.id}`;\n          return (\n            <SequencePane className=\"lk-seq-slot\" hidden={slot.index !== index} key={slotKey}>\n              {renderSlot(slot)}\n            </SequencePane>\n          );\n        })}\n      </section>\n\n      <div className=\"lk-seq-nav\">\n        <button\n          type=\"button\"\n          className=\"lk-seq-prev\"\n          onClick={() => go(index - 1)}\n          disabled={index === 0}\n        >\n          Previous\n        </button>\n        <button\n          type=\"button\"\n          className=\"lk-seq-next\"\n          onClick={() => go(index + 1)}\n          disabled={index === total - 1}\n        >\n          Next\n        </button>\n      </div>\n    </div>\n  );\n}\n"]}
+{"version":3,"sources":["../src/components/ActivitySequence/ActivitySequence.tsx"],"names":["useRef","useEffect","jsx","isItemGroup","randomSessionId","useMemo","flattenSequence","useState","current","MultipleChoice","FillInTheBlanks","WrittenResponse","jsxs","StimulusPanel"],"mappings":"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","file":"chunk-3B4ACY4K.cjs","sourcesContent":["'use client';\n\nimport {\n  type ActivityResult,\n  flattenSequence,\n  type InteractionEvent,\n  isItemGroup,\n  type LearnerResponse,\n  type SequenceEntry,\n  type SequenceSlot,\n  type SequenceSlotGroup,\n  type ThemeTokens,\n} from '@intellectif/lk-core';\nimport { type ComponentType, useEffect, useMemo, useRef, useState } from 'react';\nimport { randomSessionId } from '../_internal.js';\nimport { FillInTheBlanks } from '../FillInTheBlanks/index.js';\nimport { MultipleChoice } from '../MultipleChoice/index.js';\nimport { StimulusPanel } from '../StimulusPanel/index.js';\nimport type { ActivityProps, HtmlSanitizer, RenderableActivity, RenderMode } from '../types.js';\nimport { WrittenResponse, type WrittenResponseSubmission } from '../WrittenResponse/index.js';\n\n/**\n * What one finished slot in a sequence produced. Two kinds, because two kinds\n * of activity exist: those the SDK scores at submit time, and those a grader\n * scores later. Collapsing them would mean inventing a score for ungraded\n * work — the exact defect the deferred outcome exists to prevent.\n */\nexport type SequenceItemOutcome =\n  | {\n      kind: 'scored';\n      /** Presented position. */\n      index: number;\n      /** Slot identity from `flattenSequence` — stable under shuffling; the `slotId` to score with. */\n      slotId: string;\n      activityId: string;\n      result: ActivityResult;\n    }\n  | {\n      kind: 'submitted';\n      index: number;\n      slotId: string;\n      activityId: string;\n      /** Ungraded submission; the grade arrives asynchronously. */\n      submission: WrittenResponseSubmission;\n    }\n  | {\n      kind: 'responded';\n      index: number;\n      slotId: string;\n      activityId: string;\n      /**\n       * The raw answer, with no grade of any kind. This is what an `exam` slot\n       * produces: the client is forbidden to score, so a response is all there\n       * is until the server grades it.\n       */\n      response: LearnerResponse;\n    };\n\n/**\n * A component that can render one activity inside a sequence. Register one per\n * activity `type` to put a consumer-defined type on screen — the React half of\n * the activity-type registry, matching `registerActivityType` in lk-core.\n */\nexport type ActivityRenderer = ComponentType<ActivityProps>;\n\nexport interface ActivitySequenceProps {\n  /**\n   * The ordered set of entries to present, one question at a time: loose\n   * activities, and item groups — a shared passage, recording or image with\n   * the questions that refer to it. A group's stimulus stays on screen\n   * alongside each of its questions.\n   *\n   * Accepts `redact()` projections. For data straight off a server, pass it\n   * through `asRenderableSequence()` — see that helper for why a cast is\n   * unavoidable there — and set `renderMode=\"exam\"`.\n   */\n  activities: readonly SequenceEntry<RenderableActivity>[];\n  /**\n   * Renderers for activity types beyond the built-ins, keyed by `data.type`.\n   * A key matching a built-in overrides it, so a consumer can replace the\n   * bundled renderer without forking the sequencer.\n   */\n  renderers?: Readonly<Record<string, ActivityRenderer>>;\n  /**\n   * Called whenever an individual activity is scored at submit time — the\n   * incremental persist hook.\n   *\n   * `slotId` is the identity to store the result against, NOT `index`.\n   * `index` is where the question was PRESENTED, which is not stable: it moves\n   * under shuffling, and it already differs from the slot identity whenever a\n   * group is present (the second entry of a sequence is presented at index 1\n   * but is slot `\"1.0\"` if it is a group's first question). `composeAssessmentScore`\n   * scores by `slotId`, so persisting `index` cannot be reconciled with it.\n   */\n  onActivityComplete?: (result: ActivityResult, index: number, slotId: string) => void;\n  /**\n   * Called on every submit with the learner's raw response and the identity of\n   * the slot that produced it — before any grading, in every render mode.\n   *\n   * **This is the only response channel an `exam` sequence has.** In `exam`\n   * mode the components never grade, so `onActivityComplete` cannot fire and\n   * `onComplete` never will; without this prop nothing a learner submitted\n   * would reach the consumer at all. Persist `response` against `slotId`.\n   */\n  onSubmit?: (\n    response: LearnerResponse,\n    slot: { slotId: string; index: number; activityId: string },\n  ) => void;\n  /**\n   * Called once every activity has been completed, with the scored results.\n   *\n   * Fires only when EVERY item produced a score. A set containing a\n   * deferred-graded activity (a written response) can never satisfy that, so\n   * use `onFinished` for mixed sets — it is the general completion signal and\n   * reports both kinds of outcome. It also carries `slotId` per item, which\n   * this callback's bare array cannot.\n   */\n  onComplete?: (results: ActivityResult[]) => void;\n  /**\n   * Called once every activity has been completed, whether it was scored at\n   * submit time or submitted for later grading. Use this for any set that\n   * mixes graded and deferred-graded activities.\n   */\n  onFinished?: (items: SequenceItemOutcome[]) => void;\n  /** Forwarded to each activity. */\n  onInteraction?: (event: InteractionEvent) => void;\n  /** Forwarded to each activity. `exam` and `review` disable local scoring. */\n  renderMode?: RenderMode;\n  /**\n   * `entries` shuffles the top-level entries; a group moves as one block, and\n   * the order INSIDE a group follows the group's own `shuffle` setting.\n   * Default `none`: authored order.\n   */\n  shuffle?: 'none' | 'entries';\n  /**\n   * Seed for every shuffle in this sequence (`shuffle: 'entries'` and any\n   * group with `shuffle: 'within-group'`). Supply the attempt id, so the\n   * server's `flattenSequence(entries, { seed })` derives the same order this\n   * pager shows.\n   *\n   * **Required in `exam` and `review` mode** — omitting it throws. An order\n   * nobody can reproduce cannot be reconciled with a recorded attempt, and\n   * failing at render is the only way that mistake surfaces before a learner\n   * sits the paper. In `practice` mode it stays optional: a random per-mount\n   * seed is used, which is stable within the mount and deliberately not\n   * reproducible. That fallback is also not SSR-safe (server and client would\n   * invent different orders and hydration would mismatch), so supply a seed\n   * for any server-rendered sequence regardless of mode.\n   */\n  shuffleSeed?: string;\n  /** Renders author-supplied rich text; forwarded to the stimulus panel and every activity. */\n  sanitizeHtml?: HtmlSanitizer;\n  theme?: Partial<ThemeTokens>;\n  locale?: string;\n  disabled?: boolean;\n}\n\n/** One stimulus panel to keep mounted: the group, and the presented span of its questions. */\ninterface StimulusMount {\n  /** Authored entry position — unique per group in the sequence even if two groups share an id. */\n  entryKey: string;\n  group: SequenceSlotGroup;\n  first: number;\n  last: number;\n}\n\n/** The authored-entry prefix of a slot id: `\"3\"` for `\"3\"` and for `\"3.1\"`. */\nfunction entryKeyOf(slot: SequenceSlot<RenderableActivity>): string {\n  return slot.slotId.split('.')[0] ?? slot.slotId;\n}\n\n/**\n * A pane that is kept MOUNTED but shown only when it is the current one, and\n * that stops any media it contains on the way out.\n *\n * `hidden` alone is not enough. It resolves to `display: none`, and CSS does\n * not touch playback: an `<audio>` or `<video>` inside a hidden subtree keeps\n * playing to the end. (The HTML spec pauses a media element when it is\n * REMOVED from the document — a different thing, and the thing this pager\n * deliberately does not do, because unmounting is what used to destroy the\n * learner's answers.) So a recording started for one question would carry on\n * underneath the next, which for a listening paper means the passage plays\n * while the learner is somewhere else entirely.\n *\n * Pausing preserves `currentTime`: coming back to a group resumes where the\n * learner left off. Nothing auto-plays on the way in — starting audio the\n * learner did not ask for is its own defect.\n *\n * `embed` media (a provider iframe) cannot be paused this way: controlling a\n * third-party player needs its own JS API, which the SDK has no reliable\n * access to because the author supplies the embed URL. Use `audio`/`video`\n * media for anything that must stop when the learner navigates.\n */\nfunction SequencePane({\n  className,\n  hidden,\n  children,\n}: {\n  className: string;\n  hidden: boolean;\n  children: React.ReactNode;\n}): React.JSX.Element {\n  const ref = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    if (!hidden) {\n      return;\n    }\n    const node = ref.current;\n    if (node === null) {\n      return;\n    }\n    for (const media of node.querySelectorAll('audio, video')) {\n      const element = media as HTMLMediaElement;\n      if (!element.paused) {\n        element.pause();\n      }\n    }\n  }, [hidden]);\n\n  return (\n    <div className={className} hidden={hidden} ref={ref}>\n      {children}\n    </div>\n  );\n}\n\n/**\n * Presents a set of activities as an in-place pager: one question visible at a\n * time, navigated with Prev/Next (no page scrolling). Linear free navigation —\n * the learner may move back and forth; activities keep their own submit and\n * scoring. On navigation, focus moves to the question region and the position\n * is announced via an aria-live region.\n *\n * Item groups are flattened into consecutive questions; the group's stimulus\n * is mounted ONCE, beside the question region rather than inside it, and shown\n * alongside every question in the group — so a passage stays put, and a\n * recording keeps its position, as the learner moves between its questions.\n */\nexport function ActivitySequence({\n  activities,\n  renderers,\n  onActivityComplete,\n  onComplete,\n  onFinished,\n  onSubmit,\n  onInteraction,\n  renderMode = 'practice',\n  shuffle,\n  shuffleSeed,\n  sanitizeHtml,\n  theme,\n  locale,\n  disabled,\n}: ActivitySequenceProps): React.JSX.Element {\n  const sessionIdRef = useRef<string | null>(null);\n\n  // The presented order comes from lk-core, never computed here: the server\n  // that records an attempt calls the same function with the same seed.\n  const shuffleEntries = shuffle === 'entries';\n  const needsSeed =\n    shuffleEntries ||\n    activities.some((entry) => isItemGroup(entry) && entry.shuffle === 'within-group');\n\n  // An unreproducible order is a practice-only affordance. Under `exam` or\n  // `review` the server has to be able to rebuild exactly what the learner\n  // saw, so a missing seed is an error rather than something to paper over —\n  // the same reason `flattenSequence` refuses to invent one.\n  if (needsSeed && shuffleSeed === undefined && renderMode !== 'practice') {\n    throw new Error(\n      `ActivitySequence: renderMode \"${renderMode}\" requires a \\`shuffleSeed\\` when shuffling ` +\n        '(shuffle=\"entries\", or a group with shuffle: \"within-group\"). Pass the attempt id, so ' +\n        \"the server's flattenSequence(entries, { seed }) reproduces the order the learner saw.\",\n    );\n  }\n\n  // Lazily created only when shuffling in practice without a caller seed (same\n  // contract as MultipleChoice.shuffleSeed): a per-mount session seed, stable\n  // across re-renders, never reproducible.\n  const seed = needsSeed\n    ? // biome-ignore lint/suspicious/noAssignInExpressions: sanctioned lazy ref initialization\n      (shuffleSeed ?? (sessionIdRef.current ??= randomSessionId()))\n    : undefined;\n  const slots = useMemo(\n    () => flattenSequence(activities, { shuffleEntries, ...(seed !== undefined ? { seed } : {}) }),\n    [activities, shuffleEntries, seed],\n  );\n\n  const [index, setIndex] = useState(0);\n  // Outcomes live in a ref, not state: nothing renders from them, and a ref is\n  // written SYNCHRONOUSLY. Reading them from a `useState` closure meant two\n  // slots completing in the same tick both saw the pre-update array — the\n  // second overwrote the first, so one answer vanished and completion never\n  // fired. Every slot is mounted at once here, so same-tick completions are\n  // reachable (a custom renderer that completes from a mount effect).\n  const outcomesRef = useRef<(SequenceItemOutcome | null)[] | null>(null);\n  if (outcomesRef.current === null) {\n    outcomesRef.current = slots.map(() => null);\n  }\n  const regionRef = useRef<HTMLDivElement>(null);\n  const mountedRef = useRef(false);\n\n  // Reset pager position and outcomes when the presented SET changes (B8):\n  // without this, results from the previous set leak into the new one and can\n  // fire completion with a mixed old/new array. Keyed on the set's CONTENT\n  // identity (ordered slot and activity ids), not the array reference — a\n  // parent that re-creates a structurally identical array on every render\n  // (inline literals, .map() in render) must not wipe in-progress answers.\n  // JSON.stringify (not join) so ids containing the separator cannot collide.\n  const setKey = JSON.stringify(slots.map((slot) => [slot.slotId, slot.activity.id]));\n  const [prevSetKey, setPrevSetKey] = useState(setKey);\n  if (prevSetKey !== setKey) {\n    setPrevSetKey(setKey);\n    setIndex(0);\n    outcomesRef.current = slots.map(() => null);\n  }\n\n  // After a navigation (not the initial mount) move focus to the question\n  // region so screen-reader / keyboard users land on the new question.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: index is the intended trigger\n  useEffect(() => {\n    if (mountedRef.current) {\n      regionRef.current?.focus();\n    } else {\n      mountedRef.current = true;\n    }\n  }, [index]);\n\n  // One panel per group, spanning the presented positions of its questions.\n  const stimulusMounts = useMemo<StimulusMount[]>(() => {\n    const mounts = new Map<string, StimulusMount>();\n    for (const slot of slots) {\n      if (slot.group === undefined) {\n        continue;\n      }\n      const entryKey = entryKeyOf(slot);\n      const existing = mounts.get(entryKey);\n      if (existing === undefined) {\n        mounts.set(entryKey, { entryKey, group: slot.group, first: slot.index, last: slot.index });\n      } else {\n        existing.last = slot.index;\n      }\n    }\n    return [...mounts.values()];\n  }, [slots]);\n\n  const total = slots.length;\n  const current = slots[index];\n\n  const go = (next: number): void => {\n    setIndex(next);\n  };\n\n  /**\n   * Records a finished slot and fires completion callbacks when the set is\n   * done. A slot that already holds an outcome is FINAL: re-recording it would\n   * fire completion a second time for one attempt, so a consumer persisting on\n   * `onFinished` would write the same attempt twice.\n   */\n  const record = (outcome: SequenceItemOutcome): void => {\n    const current = outcomesRef.current;\n    if (current === null || current[outcome.index] != null) {\n      return;\n    }\n    const next = current.slice();\n    next[outcome.index] = outcome;\n    // Commit before firing anything: a second record() in the same tick must\n    // see this one.\n    outcomesRef.current = next;\n\n    if (outcome.kind === 'scored') {\n      onActivityComplete?.(outcome.result, outcome.index, outcome.slotId);\n    }\n\n    if (!next.every((item): item is SequenceItemOutcome => item !== null)) {\n      return;\n    }\n    onFinished?.(next);\n\n    // `onComplete` predates deferred grading and promises ActivityResult[].\n    // Fire it only when every slot really was scored, rather than inventing a\n    // result for work nobody has graded.\n    const scored: ActivityResult[] = [];\n    for (const item of next) {\n      if (item.kind !== 'scored') {\n        return;\n      }\n      scored.push(item.result);\n    }\n    onComplete?.(scored);\n  };\n\n  if (!current) {\n    return <div className=\"lk-seq\" />;\n  }\n\n  const forwarded = {\n    ...(onInteraction ? { onInteraction } : {}),\n    renderMode,\n    ...(sanitizeHtml ? { sanitizeHtml } : {}),\n    ...(theme ? { theme } : {}),\n    ...(locale ? { locale } : {}),\n    ...(disabled ? { disabled } : {}),\n  };\n\n  const renderSlot = (slot: SequenceSlot<RenderableActivity>): React.JSX.Element => {\n    const activity = slot.activity;\n    const { slotId, index: slotIndex } = slot;\n    const activityId = activity.id;\n    const childProps = {\n      onComplete: (result: ActivityResult) =>\n        record({ kind: 'scored', index: slotIndex, slotId, activityId, result }),\n      onSubmit: (response: LearnerResponse) => {\n        onSubmit?.(response, { slotId, index: slotIndex, activityId });\n        // Outside `practice` the components do not grade, so a raw response is\n        // the ONLY outcome this slot will ever produce — record it, or the set\n        // could never complete and `onFinished` would be dead in exam mode.\n        // Written responses are excluded because they report something richer\n        // through `onSubmitted` a moment later, and the first outcome wins.\n        if (renderMode !== 'practice' && activity.type !== 'written-response') {\n          record({ kind: 'responded', index: slotIndex, slotId, activityId, response });\n        }\n      },\n      ...forwarded,\n    };\n\n    const CustomRenderer = renderers?.[activity.type];\n    if (CustomRenderer) {\n      return <CustomRenderer data={activity} {...childProps} />;\n    }\n    if (activity.type === 'multiple-choice') {\n      return <MultipleChoice data={activity} {...childProps} />;\n    }\n    if (activity.type === 'fill-in-the-blanks') {\n      return <FillInTheBlanks data={activity} {...childProps} />;\n    }\n    if (activity.type === 'written-response') {\n      return (\n        <WrittenResponse\n          data={activity}\n          onSubmitted={(submission) =>\n            record({ kind: 'submitted', index: slotIndex, slotId, activityId, submission })\n          }\n          // Explicit rather than spread: WrittenResponse has no `onComplete`\n          // (it never grades), so `childProps` does not fit it — but it must\n          // still report the raw response like every other slot.\n          onSubmit={childProps.onSubmit}\n          {...forwarded}\n        />\n      );\n    }\n    return (\n      <div className=\"lk-seq-unsupported\" role=\"note\">\n        This activity type has no renderer. Supply one through the renderers prop.\n      </div>\n    );\n  };\n\n  const currentEntryKey = entryKeyOf(current);\n\n  return (\n    <div className=\"lk-seq\" lang={locale}>\n      <div className=\"lk-seq-progress\" aria-live=\"polite\" role=\"status\">\n        Question {index + 1} of {total}\n      </div>\n\n      {/*\n        Each group's stimulus is mounted ONCE and only hidden while the current\n        question is outside its group. That — not re-rendering it per slot — is\n        what makes the passage the same DOM node throughout, and what lets a\n        recording keep its position between questions of one group.\n\n        It sits BESIDE the question region, not inside it. Inside, every\n        navigation dropped focus onto a container whose first content was the\n        whole passage: the region promised \"Question 3 of 5\" and then began\n        with the passage, keyboard users tabbed through the stimulus (audio\n        controls included) before reaching the question, and the passage was a\n        landmark nested inside another landmark. As a sibling it stays a\n        landmark the learner can jump back to, while focus lands on the\n        question that was actually navigated to.\n      */}\n      {stimulusMounts.map(({ entryKey, group, first, last }) => (\n        <SequencePane\n          className=\"lk-seq-stimulus\"\n          hidden={entryKey !== currentEntryKey}\n          key={`group-${entryKey}`}\n        >\n          <StimulusPanel\n            stimulus={group.stimulus}\n            range={{ first: first + 1, last: last + 1 }}\n            {...(sanitizeHtml ? { sanitizeHtml } : {})}\n            {...(locale ? { locale } : {})}\n          />\n        </SequencePane>\n      ))}\n\n      <section\n        className=\"lk-seq-question\"\n        ref={regionRef}\n        tabIndex={-1}\n        aria-label={`Question ${index + 1} of ${total}`}\n      >\n        {/*\n          Every slot stays MOUNTED; only the current one is visible. Rendering\n          just the current activity unmounted the others, so navigating back to\n          an answered question showed it blank and re-answerable — the learner\n          silently lost their answer and a second submit fired completion\n          again. `hidden` removes the inactive slots from the accessibility\n          tree and from tab order, so only the current question is reachable.\n        */}\n        {slots.map((slot) => {\n          // The slot id (authored position) plus the activity id: the same\n          // activity may legitimately fill two slots, and each must keep its\n          // own answer state; and a different activity in the same slot must\n          // remount rather than inherit the previous one's state.\n          //\n          // `setKey` leads, so a set change remounts every child. Without it a\n          // pure REORDER changed `setKey` — clearing the outcomes — while each\n          // child kept its key and therefore its `completed` state. Those\n          // slots could not be answered again and no outcome would ever refill\n          // them, so the sequence could never finish. A reset has to reset\n          // both halves or neither. A parent re-creating a structurally\n          // identical array leaves `setKey` untouched, so answers still\n          // survive that.\n          const slotKey = `${setKey}::slot-${slot.slotId}-${slot.activity.id}`;\n          return (\n            <SequencePane className=\"lk-seq-slot\" hidden={slot.index !== index} key={slotKey}>\n              {renderSlot(slot)}\n            </SequencePane>\n          );\n        })}\n      </section>\n\n      <div className=\"lk-seq-nav\">\n        <button\n          type=\"button\"\n          className=\"lk-seq-prev\"\n          onClick={() => go(index - 1)}\n          disabled={index === 0}\n        >\n          Previous\n        </button>\n        <button\n          type=\"button\"\n          className=\"lk-seq-next\"\n          onClick={() => go(index + 1)}\n          disabled={index === total - 1}\n        >\n          Next\n        </button>\n      </div>\n    </div>\n  );\n}\n"]}

package/dist/{chunk-SWZRB3VY.js → chunk-67WDTQMG.js}

@@ -8,6 +8,10 @@ import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 function textOf(response) {
   return response !== void 0 && response.type === "written-response" ? response.text : "";
 }
+function criterionPercent(criterion) {
+  const max = criterion.maxScore !== void 0 && criterion.maxScore > 0 ? criterion.maxScore : 1;
+  return `${Math.round(criterion.score / max * 100)}%`;
+}
 function GradeBody({ grade }) {
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     grade.feedback ? /* @__PURE__ */ jsx("p", { className: "lk-wr-grade-feedback", children: grade.feedback }) : null,
@@ -18,7 +22,7 @@ function GradeBody({ grade }) {
         "data-na": String(criterion.notApplicable === true),
         children: [
           /* @__PURE__ */ jsx("span", { className: "lk-wr-criterion-name", children: criterion.name }),
-          criterion.notApplicable === true ? /* @__PURE__ */ jsx("span", { className: "lk-wr-criterion-score", children: "Not applicable" }) : /* @__PURE__ */ jsx("span", { className: "lk-wr-criterion-score", children: criterion.band ?? (typeof criterion.score === "number" ? `${Math.round(criterion.score * 100)}%` : "") }),
+          criterion.notApplicable === true ? /* @__PURE__ */ jsx("span", { className: "lk-wr-criterion-score", children: "Not applicable" }) : /* @__PURE__ */ jsx("span", { className: "lk-wr-criterion-score", children: criterion.band ?? (typeof criterion.score === "number" ? criterionPercent(criterion) : "") }),
           criterion.comment ? /* @__PURE__ */ jsx("span", { className: "lk-wr-criterion-comment", children: criterion.comment }) : null
         ]
       },
@@ -253,5 +257,5 @@ function WrittenResponse2(props) {
 }
 
 export { WrittenResponse2 as WrittenResponse };
-//# sourceMappingURL=chunk-SWZRB3VY.js.map
-//# sourceMappingURL=chunk-SWZRB3VY.js.map
+//# sourceMappingURL=chunk-67WDTQMG.js.map
+//# sourceMappingURL=chunk-67WDTQMG.js.map

package/dist/chunk-67WDTQMG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/WrittenResponse/WrittenResponse.tsx","../src/components/WrittenResponse/index.tsx"],"names":["WrittenResponse","jsx"],"mappings":"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","file":"chunk-67WDTQMG.js","sourcesContent":["'use client';\n\nimport {\n  ActivitySchemaError,\n  type CriterionScore,\n  countWords,\n  evaluate,\n  type GradeRecord,\n  type InteractionEvent,\n  type ItemOutcome,\n  type LearnerResponse,\n  type ThemeTokens,\n  validateActivity,\n  type WrittenResponseData,\n  type XAPIStatement,\n  xAPIBuilder,\n} from '@intellectif/lk-core';\nimport { type CSSProperties, useEffect, useMemo, useRef, useState } from 'react';\nimport { useActivityState } from '../../hooks/useActivityState.js';\nimport { ANONYMOUS_ACTOR, isDevelopment, objectIdFor } from '../_internal.js';\nimport { ActivityMedia } from '../shared/ActivityMedia.js';\nimport { FeedbackRegion } from '../shared/FeedbackRegion.js';\nimport type { HtmlSanitizer, Renderable, RenderMode } from '../types.js';\n\n/**\n * Payload delivered when the learner submits a written response. Grading is\n * DEFERRED (asynchronous AI/human grading), so there is no score here — and\n * deliberately no fake one: an ungraded submission must never be shown or\n * stored as a 0. The consumer persists `text` and grades it out-of-band.\n */\nexport interface WrittenResponseSubmission {\n  /** The submitted text, verbatim. */\n  text: string;\n  /** Word count of `text`, recomputed with the canonical `countWords()`. */\n  wordCount: number;\n  /** Whether `wordCount` falls within the activity's `[minWords, maxWords]`. */\n  withinWordBounds: boolean;\n  /** Time in milliseconds from first interaction to submission. */\n  timeSpent: number;\n  /** The SUBMITTED-verb xAPI statement built for this submission (no score fields). */\n  xapiStatement: XAPIStatement;\n}\n\n/**\n * Props for {@link WrittenResponse}. Mirrors `ActivityProps` except for the\n * completion callback: a deferred-grading activity completes with a\n * {@link WrittenResponseSubmission} (`onSubmitted`), not a scored\n * `ActivityResult` (`onComplete`) — deviation from Req 22.8 recorded in the\n * roadmap (§3.1): fabricating a score of 0 for ungraded work is the exact\n * bug this type exists to fix. Everything else — controlled value, render\n * mode, server outcome, rich text — follows the shared `ActivityProps`\n * contract verbatim.\n */\nexport interface WrittenResponseProps {\n  /** Activity content. Accepts a `redact()` projection in `exam` mode. */\n  data: Renderable<WrittenResponseData>;\n  /**\n   * Called on submit with the ungraded submission (text, recomputed word\n   * count, bounds flag, timing, xAPI statement). Fires in `practice` and\n   * `exam` mode, after `onSubmit`; never in `review`.\n   *\n   * Optional since v0.4 so a `review`-mode render (which has no submit\n   * control) and an exam runner that only wants the raw response through\n   * `onSubmit` do not have to pass a no-op. Supply it in `practice`/`exam`\n   * unless `onSubmit` already captures everything you persist.\n   */\n  onSubmitted?: (submission: WrittenResponseSubmission) => void;\n  /**\n   * Called on submit with the raw learner response and no grade, BEFORE\n   * `onSubmitted`. This is the only submit callback an exam runner needs:\n   * the server grades the text and returns an {@link ItemOutcome} later.\n   */\n  onSubmit?: (response: LearnerResponse) => void;\n  /**\n   * Controlled value: the learner's current response. When present the\n   * textarea renders from it (never from internal state) and every keystroke\n   * goes out through `onChange` — restore an in-progress attempt, autosave a\n   * delta, or drive a review render with it.\n   */\n  value?: LearnerResponse;\n  /** Initial response for an uncontrolled component (ignored when `value` is set). */\n  defaultValue?: LearnerResponse;\n  /** Fires on every change to the learner's response. Required for a controlled component. */\n  onChange?: (response: LearnerResponse) => void;\n  /**\n   * Presentation mode, default `practice`. `practice` and `exam` are nearly\n   * identical here — a written response is never graded client-side, so\n   * there is no local score to withhold; `exam` additionally never calls\n   * `evaluate()` and renders happily from a `redact()` projection.\n   * `review` is read-only and shows the server's `outcome`.\n   */\n  renderMode?: RenderMode;\n  /**\n   * Server-computed outcome, rendered by `review` mode: `deferred` shows a\n   * \"not graded yet\" affordance, `scored` shows the returned grade and\n   * feedback. Ignored in other modes — this component never manufactures an\n   * outcome of its own.\n   */\n  outcome?: ItemOutcome;\n  /** Renders `data.promptHtml` when provided. See `HtmlSanitizer`. */\n  sanitizeHtml?: HtmlSanitizer;\n  onInteraction?: (event: InteractionEvent) => void;\n  /** Per-instance token overrides, applied as inline CSS vars on the root. */\n  theme?: Partial<ThemeTokens>;\n  locale?: string;\n  disabled?: boolean;\n}\n\n/**\n * Reads the text out of a learner response. Another activity type's response\n * shape (the `value`/`defaultValue` props take the `LearnerResponse` union,\n * so a generic runner can hand any of them over) reads as empty rather than\n * throwing mid-exam.\n */\nfunction textOf(response: LearnerResponse | undefined): string {\n  return response !== undefined && response.type === 'written-response' ? response.text : '';\n}\n\n/**\n * One criterion's score as a percentage of its OWN maximum.\n *\n * `CriterionScore.maxScore` defaults to 1 — the SDK's scaled convention — but\n * a grader may work out of 100, or out of 9 for a CEFR band, and\n * `gradeFromRubric` deliberately stores those judgements verbatim so a grade\n * stays auditable in the units the grader actually used. It normalises when it\n * computes the total; anything DISPLAYING a criterion has to normalise too, or\n * a perfectly ordinary 82/100 renders as \"8200%\". This is the same guard the\n * overall score already applies against `outcome.maxScore`.\n */\nfunction criterionPercent(criterion: CriterionScore): string {\n  const max = criterion.maxScore !== undefined && criterion.maxScore > 0 ? criterion.maxScore : 1;\n  return `${Math.round(((criterion.score as number) / max) * 100)}%`;\n}\n\n/**\n * Renders the server-computed outcome in `review` mode. The grade shown here\n * always came back from the asynchronous grader — nothing on this path scores,\n * infers, or defaults a grade. A `written-response` outcome carries no\n * per-item `details` (there are no options or blanks to mark), so the render\n * is the scaled score, the pass state, and the grader's feedback.\n */\nfunction GradeBody({ grade }: { grade: GradeRecord }) {\n  return (\n    <>\n      {grade.feedback ? <p className=\"lk-wr-grade-feedback\">{grade.feedback}</p> : null}\n      {grade.criteria && grade.criteria.length > 0 ? (\n        <ul className=\"lk-wr-criteria\">\n          {grade.criteria.map((criterion) => (\n            <li\n              className=\"lk-wr-criterion\"\n              key={criterion.name}\n              data-na={String(criterion.notApplicable === true)}\n            >\n              <span className=\"lk-wr-criterion-name\">{criterion.name}</span>\n              {criterion.notApplicable === true ? (\n                <span className=\"lk-wr-criterion-score\">Not applicable</span>\n              ) : (\n                <span className=\"lk-wr-criterion-score\">\n                  {criterion.band ??\n                    (typeof criterion.score === 'number' ? criterionPercent(criterion) : '')}\n                </span>\n              )}\n              {criterion.comment ? (\n                <span className=\"lk-wr-criterion-comment\">{criterion.comment}</span>\n              ) : null}\n            </li>\n          ))}\n        </ul>\n      ) : null}\n      {grade.corrections && grade.corrections.length > 0 ? (\n        <ul className=\"lk-wr-corrections\">\n          {grade.corrections.map((correction) => (\n            <li className=\"lk-wr-correction\" key={`${correction.original}:${correction.corrected}`}>\n              <del className=\"lk-wr-correction-original\">{correction.original}</del>{' '}\n              <ins className=\"lk-wr-correction-corrected\">{correction.corrected}</ins>\n              {correction.explanation ? (\n                <span className=\"lk-wr-correction-explanation\">{correction.explanation}</span>\n              ) : null}\n            </li>\n          ))}\n        </ul>\n      ) : null}\n      {grade.requiresHumanReview === true ? (\n        <p className=\"lk-wr-review-flag\">This grade is awaiting review by a teacher.</p>\n      ) : null}\n    </>\n  );\n}\n\n/**\n * Renders the server-computed outcome in `review` mode. The grade shown here\n * always came back from the grader — nothing on this path scores, infers, or\n * defaults a grade.\n */\nfunction OutcomeSummary({ outcome }: { outcome: ItemOutcome }) {\n  if (outcome.status === 'scored' || outcome.status === 'graded') {\n    // `score` is scaled [0–1] against `maxScore`; normalising by `maxScore`\n    // is a no-op for the canonical maxScore of 1 and keeps an unscaled\n    // grader payload (8.5 / 10) from rendering as 850%.\n    const percent =\n      outcome.maxScore > 0\n        ? Math.round((outcome.score / outcome.maxScore) * 100)\n        : Math.round(outcome.score * 100);\n    return (\n      <div\n        className=\"lk-wr-outcome\"\n        data-status={outcome.status}\n        data-passed={String(outcome.passed)}\n      >\n        <p className=\"lk-wr-grade\">\n          Score {percent}%. {outcome.passed ? 'Passed.' : 'Not passed.'}\n        </p>\n        {outcome.status === 'graded' ? (\n          <GradeBody grade={outcome.grade} />\n        ) : outcome.feedback ? (\n          <p className=\"lk-wr-grade-feedback\">{outcome.feedback}</p>\n        ) : null}\n      </div>\n    );\n  }\n  if (outcome.status === 'deferred') {\n    return (\n      <div className=\"lk-wr-outcome\" data-status=\"deferred\">\n        <p className=\"lk-wr-grade\">Not graded yet. This response is waiting for its grade.</p>\n      </div>\n    );\n  }\n  // `unscorable` reasons are developer-facing strings; surface the state, not\n  // the reason, and leave it on the element for diagnostics.\n  return (\n    <div className=\"lk-wr-outcome\" data-status=\"unscorable\" data-reason={outcome.reason}>\n      <p className=\"lk-wr-grade\">This response could not be graded.</p>\n    </div>\n  );\n}\n\nexport function WrittenResponse({\n  data,\n  onSubmitted,\n  onSubmit,\n  value,\n  defaultValue,\n  onChange,\n  renderMode = 'practice',\n  outcome,\n  sanitizeHtml,\n  onInteraction,\n  theme,\n  locale,\n  disabled,\n}: WrittenResponseProps) {\n  // Dev-only boundary validation (Req 2.3), same convention as MC/FIB. The\n  // content schema is loose, so a `redact()` projection validates too.\n  const devError = useMemo(() => {\n    if (!isDevelopment()) {\n      return null;\n    }\n    const result = validateActivity('written-response', data);\n    return result.success ? null : new ActivitySchemaError('written-response', result.errors);\n  }, [data]);\n\n  const { state, start, complete, getTimeSpent, reset } = useActivityState();\n  const isControlled = value !== undefined;\n  const [innerText, setInnerText] = useState<string>(() => textOf(defaultValue));\n  const [summary, setSummary] = useState<string | null>(null);\n\n  /**\n   * Rich text is rendered ONLY through a caller-supplied sanitiser, and only\n   * when the author actually shipped the HTML sidecar. Without both, the\n   * plain-text prompt is rendered as an escaped React child.\n   */\n  const promptHtml = useMemo(() => {\n    if (sanitizeHtml === undefined || typeof data.promptHtml !== 'string') {\n      return null;\n    }\n    return sanitizeHtml(data.promptHtml);\n  }, [data.promptHtml, sanitizeHtml]);\n\n  // Latest seed text, kept in a ref so `defaultValue` is NOT a reset trigger:\n  // callers pass an object literal, whose identity changes every render.\n  const defaultTextRef = useRef<string>(textOf(defaultValue));\n  useEffect(() => {\n    defaultTextRef.current = textOf(defaultValue);\n  }, [defaultValue]);\n\n  // Reset on data-prop change (Req 3.7): back to the seed (empty when there\n  // is none — the v1 behaviour), never the previous activity's draft.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: data is the reset trigger (Req 3.7)\n  useEffect(() => {\n    setInnerText(defaultTextRef.current);\n    setSummary(null);\n    reset();\n  }, [data, reset]);\n\n  if (devError) {\n    throw devError;\n  }\n\n  const isExam = renderMode === 'exam';\n  const isReview = renderMode === 'review';\n\n  const text = isControlled ? textOf(value) : innerText;\n  const submitted = state === 'completed';\n  const inactive = disabled === true || submitted || isReview;\n  const wordCount = countWords(text);\n  const withinBounds = wordCount >= data.minWords && wordCount <= data.maxWords;\n\n  const handleChange = (next: string): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    // A controlled component renders from `props.value` only; the caller's\n    // state is the single source of truth for the text.\n    if (!isControlled) {\n      setInnerText(next);\n    }\n    const nextWordCount = countWords(next);\n    onChange?.({ type: 'written-response', text: next, wordCount: nextWordCount });\n    onInteraction?.({\n      type: 'text-changed',\n      activityId: data.id,\n      timestamp: Date.now(),\n      payload: { wordCount: nextWordCount },\n    });\n  };\n\n  const handleSubmit = (event: React.FormEvent): void => {\n    event.preventDefault();\n    if (inactive || text.trim().length === 0) {\n      return;\n    }\n    let finalWordCount = wordCount;\n    let finalWithinBounds = withinBounds;\n    // `exam` mode must not call evaluate(): the component does not grade, and\n    // a redacted projection carries no scoring input anyway. The two facts\n    // evaluate() returns for a deferred type (recomputed word count, bounds)\n    // are exactly what is computed above, so the payload is identical either\n    // way; practice keeps going through core so the numbers stay canonical.\n    if (!isExam) {\n      const itemOutcome = evaluate(data, { type: 'written-response', text, wordCount });\n      const partial = itemOutcome.status === 'deferred' ? itemOutcome.partial : undefined;\n      if (typeof partial?.wordCount === 'number') {\n        finalWordCount = partial.wordCount;\n      }\n      if (typeof partial?.withinWordBounds === 'boolean') {\n        finalWithinBounds = partial.withinWordBounds;\n      }\n    }\n    complete();\n    const timeSpent = getTimeSpent();\n    const xapiStatement = xAPIBuilder.buildSubmittedStatement({\n      actor: ANONYMOUS_ACTOR,\n      object: {\n        id: objectIdFor(data.id),\n        name: { [data.locale ?? 'en-US']: data.title },\n        type: 'http://adlnet.gov/expapi/activities/cmi.interaction',\n        interactionType: 'long-fill-in',\n      },\n      timeSpentMs: timeSpent,\n      response: text,\n      resultExtensions: {\n        'urn:learning-kit:extension:word-count': finalWordCount,\n        'urn:learning-kit:extension:within-word-bounds': finalWithinBounds,\n      },\n    });\n    // Raw response first (an exam runner persists this), then the fuller\n    // ungraded submission — mirroring `onSubmit` before `onComplete`.\n    onSubmit?.({ type: 'written-response', text, wordCount: finalWordCount });\n    onSubmitted?.({\n      text,\n      wordCount: finalWordCount,\n      withinWordBounds: finalWithinBounds,\n      timeSpent,\n      xapiStatement,\n    });\n    setSummary('Response submitted. It will be graded and your result will appear here later.');\n    onInteraction?.({\n      type: 'submitted',\n      activityId: data.id,\n      timestamp: Date.now(),\n      payload: { wordCount: finalWordCount, withinWordBounds: finalWithinBounds },\n    });\n  };\n\n  const promptId = `${data.id}-prompt`;\n  const counterId = `${data.id}-counter`;\n  const boundsLabel =\n    data.minWords > 0 ? `${data.minWords}–${data.maxWords} words` : `up to ${data.maxWords} words`;\n\n  return (\n    <form\n      className=\"lk-wr\"\n      aria-label={data.title}\n      lang={locale}\n      data-render-mode={renderMode}\n      style={theme as CSSProperties | undefined}\n      onSubmit={handleSubmit}\n    >\n      {data.media ? <ActivityMedia media={data.media} /> : null}\n      {promptHtml === null ? (\n        <p className=\"lk-wr-prompt\" id={promptId}>\n          {data.prompt}\n        </p>\n      ) : (\n        // A div, not a p: sanitised author HTML may contain block content.\n        <div\n          className=\"lk-wr-prompt\"\n          id={promptId}\n          // biome-ignore lint/security/noDangerouslySetInnerHtml: rendered only through the caller-supplied HtmlSanitizer — the SDK never injects unsanitised markup\n          dangerouslySetInnerHTML={{ __html: promptHtml }}\n        />\n      )}\n      <textarea\n        className=\"lk-wr-textarea\"\n        aria-labelledby={promptId}\n        aria-describedby={counterId}\n        value={text}\n        onChange={(event) => handleChange(event.target.value)}\n        // `review` uses readOnly rather than disabled: the submitted essay\n        // must stay focusable, selectable and scrollable for a screen reader\n        // and a keyboard, while remaining uneditable.\n        disabled={!isReview && inactive}\n        readOnly={isReview}\n        rows={8}\n      />\n      <div\n        className=\"lk-wr-counter\"\n        id={counterId}\n        aria-live=\"polite\"\n        data-within-bounds={withinBounds}\n      >\n        {wordCount} {wordCount === 1 ? 'word' : 'words'} ({boundsLabel})\n      </div>\n      {isReview ? null : (\n        <button\n          type=\"submit\"\n          className=\"lk-wr-submit\"\n          disabled={inactive || text.trim().length === 0}\n        >\n          Submit\n        </button>\n      )}\n      <FeedbackRegion id={`${data.id}-feedback`}>\n        {isReview ? outcome ? <OutcomeSummary outcome={outcome} /> : null : summary}\n      </FeedbackRegion>\n    </form>\n  );\n}\n","'use client';\n\nimport { ActivityErrorBoundary } from '../ActivityErrorBoundary.js';\nimport {\n  WrittenResponse as WrittenResponseCore,\n  type WrittenResponseProps,\n} from './WrittenResponse.js';\n\nexport type { HtmlSanitizer, Renderable, RenderMode } from '../types.js';\nexport type { WrittenResponseProps, WrittenResponseSubmission } from './WrittenResponse.js';\n\n/**\n * Public Written Response activity: a labelled textarea with a live word\n * counter for free-text writing graded asynchronously (AI or human). The core\n * is wrapped in `ActivityErrorBoundary` so a render failure (incl. the dev\n * schema-validation throw) degrades to an accessible fallback.\n */\nexport function WrittenResponse(props: WrittenResponseProps) {\n  return (\n    <ActivityErrorBoundary activityTitle={props.data?.title}>\n      <WrittenResponseCore {...props} />\n    </ActivityErrorBoundary>\n  );\n}\n"]}

package/dist/{chunk-XQJFLAMD.cjs → chunk-6COTYW77.cjs}

@@ -10,6 +10,10 @@ var jsxRuntime = require('react/jsx-runtime');
 function textOf(response) {
   return response !== void 0 && response.type === "written-response" ? response.text : "";
 }
+function criterionPercent(criterion) {
+  const max = criterion.maxScore !== void 0 && criterion.maxScore > 0 ? criterion.maxScore : 1;
+  return `${Math.round(criterion.score / max * 100)}%`;
+}
 function GradeBody({ grade }) {
   return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
     grade.feedback ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: "lk-wr-grade-feedback", children: grade.feedback }) : null,
@@ -20,7 +24,7 @@ function GradeBody({ grade }) {
         "data-na": String(criterion.notApplicable === true),
         children: [
           /* @__PURE__ */ jsxRuntime.jsx("span", { className: "lk-wr-criterion-name", children: criterion.name }),
-          criterion.notApplicable === true ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "lk-wr-criterion-score", children: "Not applicable" }) : /* @__PURE__ */ jsxRuntime.jsx("span", { className: "lk-wr-criterion-score", children: criterion.band ?? (typeof criterion.score === "number" ? `${Math.round(criterion.score * 100)}%` : "") }),
+          criterion.notApplicable === true ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "lk-wr-criterion-score", children: "Not applicable" }) : /* @__PURE__ */ jsxRuntime.jsx("span", { className: "lk-wr-criterion-score", children: criterion.band ?? (typeof criterion.score === "number" ? criterionPercent(criterion) : "") }),
           criterion.comment ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "lk-wr-criterion-comment", children: criterion.comment }) : null
         ]
       },
@@ -255,5 +259,5 @@ function WrittenResponse2(props) {
 }
 
 exports.WrittenResponse = WrittenResponse2;
-//# sourceMappingURL=chunk-XQJFLAMD.cjs.map
-//# sourceMappingURL=chunk-XQJFLAMD.cjs.map
+//# sourceMappingURL=chunk-6COTYW77.cjs.map
+//# sourceMappingURL=chunk-6COTYW77.cjs.map

package/dist/chunk-6COTYW77.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/WrittenResponse/WrittenResponse.tsx","../src/components/WrittenResponse/index.tsx"],"names":["jsxs","Fragment","jsx","useMemo","isDevelopment","validateActivity","ActivitySchemaError","useActivityState","useState","useRef","useEffect","countWords","evaluate","xAPIBuilder","ANONYMOUS_ACTOR","objectIdFor","ActivityMedia","FeedbackRegion","WrittenResponse","ActivityErrorBoundary"],"mappings":"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","file":"chunk-6COTYW77.cjs","sourcesContent":["'use client';\n\nimport {\n  ActivitySchemaError,\n  type CriterionScore,\n  countWords,\n  evaluate,\n  type GradeRecord,\n  type InteractionEvent,\n  type ItemOutcome,\n  type LearnerResponse,\n  type ThemeTokens,\n  validateActivity,\n  type WrittenResponseData,\n  type XAPIStatement,\n  xAPIBuilder,\n} from '@intellectif/lk-core';\nimport { type CSSProperties, useEffect, useMemo, useRef, useState } from 'react';\nimport { useActivityState } from '../../hooks/useActivityState.js';\nimport { ANONYMOUS_ACTOR, isDevelopment, objectIdFor } from '../_internal.js';\nimport { ActivityMedia } from '../shared/ActivityMedia.js';\nimport { FeedbackRegion } from '../shared/FeedbackRegion.js';\nimport type { HtmlSanitizer, Renderable, RenderMode } from '../types.js';\n\n/**\n * Payload delivered when the learner submits a written response. Grading is\n * DEFERRED (asynchronous AI/human grading), so there is no score here — and\n * deliberately no fake one: an ungraded submission must never be shown or\n * stored as a 0. The consumer persists `text` and grades it out-of-band.\n */\nexport interface WrittenResponseSubmission {\n  /** The submitted text, verbatim. */\n  text: string;\n  /** Word count of `text`, recomputed with the canonical `countWords()`. */\n  wordCount: number;\n  /** Whether `wordCount` falls within the activity's `[minWords, maxWords]`. */\n  withinWordBounds: boolean;\n  /** Time in milliseconds from first interaction to submission. */\n  timeSpent: number;\n  /** The SUBMITTED-verb xAPI statement built for this submission (no score fields). */\n  xapiStatement: XAPIStatement;\n}\n\n/**\n * Props for {@link WrittenResponse}. Mirrors `ActivityProps` except for the\n * completion callback: a deferred-grading activity completes with a\n * {@link WrittenResponseSubmission} (`onSubmitted`), not a scored\n * `ActivityResult` (`onComplete`) — deviation from Req 22.8 recorded in the\n * roadmap (§3.1): fabricating a score of 0 for ungraded work is the exact\n * bug this type exists to fix. Everything else — controlled value, render\n * mode, server outcome, rich text — follows the shared `ActivityProps`\n * contract verbatim.\n */\nexport interface WrittenResponseProps {\n  /** Activity content. Accepts a `redact()` projection in `exam` mode. */\n  data: Renderable<WrittenResponseData>;\n  /**\n   * Called on submit with the ungraded submission (text, recomputed word\n   * count, bounds flag, timing, xAPI statement). Fires in `practice` and\n   * `exam` mode, after `onSubmit`; never in `review`.\n   *\n   * Optional since v0.4 so a `review`-mode render (which has no submit\n   * control) and an exam runner that only wants the raw response through\n   * `onSubmit` do not have to pass a no-op. Supply it in `practice`/`exam`\n   * unless `onSubmit` already captures everything you persist.\n   */\n  onSubmitted?: (submission: WrittenResponseSubmission) => void;\n  /**\n   * Called on submit with the raw learner response and no grade, BEFORE\n   * `onSubmitted`. This is the only submit callback an exam runner needs:\n   * the server grades the text and returns an {@link ItemOutcome} later.\n   */\n  onSubmit?: (response: LearnerResponse) => void;\n  /**\n   * Controlled value: the learner's current response. When present the\n   * textarea renders from it (never from internal state) and every keystroke\n   * goes out through `onChange` — restore an in-progress attempt, autosave a\n   * delta, or drive a review render with it.\n   */\n  value?: LearnerResponse;\n  /** Initial response for an uncontrolled component (ignored when `value` is set). */\n  defaultValue?: LearnerResponse;\n  /** Fires on every change to the learner's response. Required for a controlled component. */\n  onChange?: (response: LearnerResponse) => void;\n  /**\n   * Presentation mode, default `practice`. `practice` and `exam` are nearly\n   * identical here — a written response is never graded client-side, so\n   * there is no local score to withhold; `exam` additionally never calls\n   * `evaluate()` and renders happily from a `redact()` projection.\n   * `review` is read-only and shows the server's `outcome`.\n   */\n  renderMode?: RenderMode;\n  /**\n   * Server-computed outcome, rendered by `review` mode: `deferred` shows a\n   * \"not graded yet\" affordance, `scored` shows the returned grade and\n   * feedback. Ignored in other modes — this component never manufactures an\n   * outcome of its own.\n   */\n  outcome?: ItemOutcome;\n  /** Renders `data.promptHtml` when provided. See `HtmlSanitizer`. */\n  sanitizeHtml?: HtmlSanitizer;\n  onInteraction?: (event: InteractionEvent) => void;\n  /** Per-instance token overrides, applied as inline CSS vars on the root. */\n  theme?: Partial<ThemeTokens>;\n  locale?: string;\n  disabled?: boolean;\n}\n\n/**\n * Reads the text out of a learner response. Another activity type's response\n * shape (the `value`/`defaultValue` props take the `LearnerResponse` union,\n * so a generic runner can hand any of them over) reads as empty rather than\n * throwing mid-exam.\n */\nfunction textOf(response: LearnerResponse | undefined): string {\n  return response !== undefined && response.type === 'written-response' ? response.text : '';\n}\n\n/**\n * One criterion's score as a percentage of its OWN maximum.\n *\n * `CriterionScore.maxScore` defaults to 1 — the SDK's scaled convention — but\n * a grader may work out of 100, or out of 9 for a CEFR band, and\n * `gradeFromRubric` deliberately stores those judgements verbatim so a grade\n * stays auditable in the units the grader actually used. It normalises when it\n * computes the total; anything DISPLAYING a criterion has to normalise too, or\n * a perfectly ordinary 82/100 renders as \"8200%\". This is the same guard the\n * overall score already applies against `outcome.maxScore`.\n */\nfunction criterionPercent(criterion: CriterionScore): string {\n  const max = criterion.maxScore !== undefined && criterion.maxScore > 0 ? criterion.maxScore : 1;\n  return `${Math.round(((criterion.score as number) / max) * 100)}%`;\n}\n\n/**\n * Renders the server-computed outcome in `review` mode. The grade shown here\n * always came back from the asynchronous grader — nothing on this path scores,\n * infers, or defaults a grade. A `written-response` outcome carries no\n * per-item `details` (there are no options or blanks to mark), so the render\n * is the scaled score, the pass state, and the grader's feedback.\n */\nfunction GradeBody({ grade }: { grade: GradeRecord }) {\n  return (\n    <>\n      {grade.feedback ? <p className=\"lk-wr-grade-feedback\">{grade.feedback}</p> : null}\n      {grade.criteria && grade.criteria.length > 0 ? (\n        <ul className=\"lk-wr-criteria\">\n          {grade.criteria.map((criterion) => (\n            <li\n              className=\"lk-wr-criterion\"\n              key={criterion.name}\n              data-na={String(criterion.notApplicable === true)}\n            >\n              <span className=\"lk-wr-criterion-name\">{criterion.name}</span>\n              {criterion.notApplicable === true ? (\n                <span className=\"lk-wr-criterion-score\">Not applicable</span>\n              ) : (\n                <span className=\"lk-wr-criterion-score\">\n                  {criterion.band ??\n                    (typeof criterion.score === 'number' ? criterionPercent(criterion) : '')}\n                </span>\n              )}\n              {criterion.comment ? (\n                <span className=\"lk-wr-criterion-comment\">{criterion.comment}</span>\n              ) : null}\n            </li>\n          ))}\n        </ul>\n      ) : null}\n      {grade.corrections && grade.corrections.length > 0 ? (\n        <ul className=\"lk-wr-corrections\">\n          {grade.corrections.map((correction) => (\n            <li className=\"lk-wr-correction\" key={`${correction.original}:${correction.corrected}`}>\n              <del className=\"lk-wr-correction-original\">{correction.original}</del>{' '}\n              <ins className=\"lk-wr-correction-corrected\">{correction.corrected}</ins>\n              {correction.explanation ? (\n                <span className=\"lk-wr-correction-explanation\">{correction.explanation}</span>\n              ) : null}\n            </li>\n          ))}\n        </ul>\n      ) : null}\n      {grade.requiresHumanReview === true ? (\n        <p className=\"lk-wr-review-flag\">This grade is awaiting review by a teacher.</p>\n      ) : null}\n    </>\n  );\n}\n\n/**\n * Renders the server-computed outcome in `review` mode. The grade shown here\n * always came back from the grader — nothing on this path scores, infers, or\n * defaults a grade.\n */\nfunction OutcomeSummary({ outcome }: { outcome: ItemOutcome }) {\n  if (outcome.status === 'scored' || outcome.status === 'graded') {\n    // `score` is scaled [0–1] against `maxScore`; normalising by `maxScore`\n    // is a no-op for the canonical maxScore of 1 and keeps an unscaled\n    // grader payload (8.5 / 10) from rendering as 850%.\n    const percent =\n      outcome.maxScore > 0\n        ? Math.round((outcome.score / outcome.maxScore) * 100)\n        : Math.round(outcome.score * 100);\n    return (\n      <div\n        className=\"lk-wr-outcome\"\n        data-status={outcome.status}\n        data-passed={String(outcome.passed)}\n      >\n        <p className=\"lk-wr-grade\">\n          Score {percent}%. {outcome.passed ? 'Passed.' : 'Not passed.'}\n        </p>\n        {outcome.status === 'graded' ? (\n          <GradeBody grade={outcome.grade} />\n        ) : outcome.feedback ? (\n          <p className=\"lk-wr-grade-feedback\">{outcome.feedback}</p>\n        ) : null}\n      </div>\n    );\n  }\n  if (outcome.status === 'deferred') {\n    return (\n      <div className=\"lk-wr-outcome\" data-status=\"deferred\">\n        <p className=\"lk-wr-grade\">Not graded yet. This response is waiting for its grade.</p>\n      </div>\n    );\n  }\n  // `unscorable` reasons are developer-facing strings; surface the state, not\n  // the reason, and leave it on the element for diagnostics.\n  return (\n    <div className=\"lk-wr-outcome\" data-status=\"unscorable\" data-reason={outcome.reason}>\n      <p className=\"lk-wr-grade\">This response could not be graded.</p>\n    </div>\n  );\n}\n\nexport function WrittenResponse({\n  data,\n  onSubmitted,\n  onSubmit,\n  value,\n  defaultValue,\n  onChange,\n  renderMode = 'practice',\n  outcome,\n  sanitizeHtml,\n  onInteraction,\n  theme,\n  locale,\n  disabled,\n}: WrittenResponseProps) {\n  // Dev-only boundary validation (Req 2.3), same convention as MC/FIB. The\n  // content schema is loose, so a `redact()` projection validates too.\n  const devError = useMemo(() => {\n    if (!isDevelopment()) {\n      return null;\n    }\n    const result = validateActivity('written-response', data);\n    return result.success ? null : new ActivitySchemaError('written-response', result.errors);\n  }, [data]);\n\n  const { state, start, complete, getTimeSpent, reset } = useActivityState();\n  const isControlled = value !== undefined;\n  const [innerText, setInnerText] = useState<string>(() => textOf(defaultValue));\n  const [summary, setSummary] = useState<string | null>(null);\n\n  /**\n   * Rich text is rendered ONLY through a caller-supplied sanitiser, and only\n   * when the author actually shipped the HTML sidecar. Without both, the\n   * plain-text prompt is rendered as an escaped React child.\n   */\n  const promptHtml = useMemo(() => {\n    if (sanitizeHtml === undefined || typeof data.promptHtml !== 'string') {\n      return null;\n    }\n    return sanitizeHtml(data.promptHtml);\n  }, [data.promptHtml, sanitizeHtml]);\n\n  // Latest seed text, kept in a ref so `defaultValue` is NOT a reset trigger:\n  // callers pass an object literal, whose identity changes every render.\n  const defaultTextRef = useRef<string>(textOf(defaultValue));\n  useEffect(() => {\n    defaultTextRef.current = textOf(defaultValue);\n  }, [defaultValue]);\n\n  // Reset on data-prop change (Req 3.7): back to the seed (empty when there\n  // is none — the v1 behaviour), never the previous activity's draft.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: data is the reset trigger (Req 3.7)\n  useEffect(() => {\n    setInnerText(defaultTextRef.current);\n    setSummary(null);\n    reset();\n  }, [data, reset]);\n\n  if (devError) {\n    throw devError;\n  }\n\n  const isExam = renderMode === 'exam';\n  const isReview = renderMode === 'review';\n\n  const text = isControlled ? textOf(value) : innerText;\n  const submitted = state === 'completed';\n  const inactive = disabled === true || submitted || isReview;\n  const wordCount = countWords(text);\n  const withinBounds = wordCount >= data.minWords && wordCount <= data.maxWords;\n\n  const handleChange = (next: string): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    // A controlled component renders from `props.value` only; the caller's\n    // state is the single source of truth for the text.\n    if (!isControlled) {\n      setInnerText(next);\n    }\n    const nextWordCount = countWords(next);\n    onChange?.({ type: 'written-response', text: next, wordCount: nextWordCount });\n    onInteraction?.({\n      type: 'text-changed',\n      activityId: data.id,\n      timestamp: Date.now(),\n      payload: { wordCount: nextWordCount },\n    });\n  };\n\n  const handleSubmit = (event: React.FormEvent): void => {\n    event.preventDefault();\n    if (inactive || text.trim().length === 0) {\n      return;\n    }\n    let finalWordCount = wordCount;\n    let finalWithinBounds = withinBounds;\n    // `exam` mode must not call evaluate(): the component does not grade, and\n    // a redacted projection carries no scoring input anyway. The two facts\n    // evaluate() returns for a deferred type (recomputed word count, bounds)\n    // are exactly what is computed above, so the payload is identical either\n    // way; practice keeps going through core so the numbers stay canonical.\n    if (!isExam) {\n      const itemOutcome = evaluate(data, { type: 'written-response', text, wordCount });\n      const partial = itemOutcome.status === 'deferred' ? itemOutcome.partial : undefined;\n      if (typeof partial?.wordCount === 'number') {\n        finalWordCount = partial.wordCount;\n      }\n      if (typeof partial?.withinWordBounds === 'boolean') {\n        finalWithinBounds = partial.withinWordBounds;\n      }\n    }\n    complete();\n    const timeSpent = getTimeSpent();\n    const xapiStatement = xAPIBuilder.buildSubmittedStatement({\n      actor: ANONYMOUS_ACTOR,\n      object: {\n        id: objectIdFor(data.id),\n        name: { [data.locale ?? 'en-US']: data.title },\n        type: 'http://adlnet.gov/expapi/activities/cmi.interaction',\n        interactionType: 'long-fill-in',\n      },\n      timeSpentMs: timeSpent,\n      response: text,\n      resultExtensions: {\n        'urn:learning-kit:extension:word-count': finalWordCount,\n        'urn:learning-kit:extension:within-word-bounds': finalWithinBounds,\n      },\n    });\n    // Raw response first (an exam runner persists this), then the fuller\n    // ungraded submission — mirroring `onSubmit` before `onComplete`.\n    onSubmit?.({ type: 'written-response', text, wordCount: finalWordCount });\n    onSubmitted?.({\n      text,\n      wordCount: finalWordCount,\n      withinWordBounds: finalWithinBounds,\n      timeSpent,\n      xapiStatement,\n    });\n    setSummary('Response submitted. It will be graded and your result will appear here later.');\n    onInteraction?.({\n      type: 'submitted',\n      activityId: data.id,\n      timestamp: Date.now(),\n      payload: { wordCount: finalWordCount, withinWordBounds: finalWithinBounds },\n    });\n  };\n\n  const promptId = `${data.id}-prompt`;\n  const counterId = `${data.id}-counter`;\n  const boundsLabel =\n    data.minWords > 0 ? `${data.minWords}–${data.maxWords} words` : `up to ${data.maxWords} words`;\n\n  return (\n    <form\n      className=\"lk-wr\"\n      aria-label={data.title}\n      lang={locale}\n      data-render-mode={renderMode}\n      style={theme as CSSProperties | undefined}\n      onSubmit={handleSubmit}\n    >\n      {data.media ? <ActivityMedia media={data.media} /> : null}\n      {promptHtml === null ? (\n        <p className=\"lk-wr-prompt\" id={promptId}>\n          {data.prompt}\n        </p>\n      ) : (\n        // A div, not a p: sanitised author HTML may contain block content.\n        <div\n          className=\"lk-wr-prompt\"\n          id={promptId}\n          // biome-ignore lint/security/noDangerouslySetInnerHtml: rendered only through the caller-supplied HtmlSanitizer — the SDK never injects unsanitised markup\n          dangerouslySetInnerHTML={{ __html: promptHtml }}\n        />\n      )}\n      <textarea\n        className=\"lk-wr-textarea\"\n        aria-labelledby={promptId}\n        aria-describedby={counterId}\n        value={text}\n        onChange={(event) => handleChange(event.target.value)}\n        // `review` uses readOnly rather than disabled: the submitted essay\n        // must stay focusable, selectable and scrollable for a screen reader\n        // and a keyboard, while remaining uneditable.\n        disabled={!isReview && inactive}\n        readOnly={isReview}\n        rows={8}\n      />\n      <div\n        className=\"lk-wr-counter\"\n        id={counterId}\n        aria-live=\"polite\"\n        data-within-bounds={withinBounds}\n      >\n        {wordCount} {wordCount === 1 ? 'word' : 'words'} ({boundsLabel})\n      </div>\n      {isReview ? null : (\n        <button\n          type=\"submit\"\n          className=\"lk-wr-submit\"\n          disabled={inactive || text.trim().length === 0}\n        >\n          Submit\n        </button>\n      )}\n      <FeedbackRegion id={`${data.id}-feedback`}>\n        {isReview ? outcome ? <OutcomeSummary outcome={outcome} /> : null : summary}\n      </FeedbackRegion>\n    </form>\n  );\n}\n","'use client';\n\nimport { ActivityErrorBoundary } from '../ActivityErrorBoundary.js';\nimport {\n  WrittenResponse as WrittenResponseCore,\n  type WrittenResponseProps,\n} from './WrittenResponse.js';\n\nexport type { HtmlSanitizer, Renderable, RenderMode } from '../types.js';\nexport type { WrittenResponseProps, WrittenResponseSubmission } from './WrittenResponse.js';\n\n/**\n * Public Written Response activity: a labelled textarea with a live word\n * counter for free-text writing graded asynchronously (AI or human). The core\n * is wrapped in `ActivityErrorBoundary` so a render failure (incl. the dev\n * schema-validation throw) degrades to an accessible fallback.\n */\nexport function WrittenResponse(props: WrittenResponseProps) {\n  return (\n    <ActivityErrorBoundary activityTitle={props.data?.title}>\n      <WrittenResponseCore {...props} />\n    </ActivityErrorBoundary>\n  );\n}\n"]}

package/dist/{chunk-GMU77L52.js → chunk-NBFTCGQ5.js}

@@ -1,6 +1,6 @@
 import { MultipleChoice } from './chunk-5SYL5CJ2.js';
 import { FillInTheBlanks } from './chunk-3DNJDP73.js';
-import { WrittenResponse } from './chunk-SWZRB3VY.js';
+import { WrittenResponse } from './chunk-67WDTQMG.js';
 import { randomSessionId } from './chunk-6F4X2NKL.js';
 import { StimulusPanel } from './chunk-UQ3BBEIT.js';
 import { isItemGroup, flattenSequence } from '@intellectif/lk-core';
@@ -243,5 +243,5 @@ function ActivitySequence({
 }
 
 export { ActivitySequence };
-//# sourceMappingURL=chunk-GMU77L52.js.map
-//# sourceMappingURL=chunk-GMU77L52.js.map
+//# sourceMappingURL=chunk-NBFTCGQ5.js.map
+//# sourceMappingURL=chunk-NBFTCGQ5.js.map

package/dist/{chunk-GMU77L52.js.map → chunk-NBFTCGQ5.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/ActivitySequence/ActivitySequence.tsx"],"names":["current"],"mappings":"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","file":"chunk-GMU77L52.js","sourcesContent":["'use client';\n\nimport {\n  type ActivityResult,\n  flattenSequence,\n  type InteractionEvent,\n  isItemGroup,\n  type LearnerResponse,\n  type SequenceEntry,\n  type SequenceSlot,\n  type SequenceSlotGroup,\n  type ThemeTokens,\n} from '@intellectif/lk-core';\nimport { type ComponentType, useEffect, useMemo, useRef, useState } from 'react';\nimport { randomSessionId } from '../_internal.js';\nimport { FillInTheBlanks } from '../FillInTheBlanks/index.js';\nimport { MultipleChoice } from '../MultipleChoice/index.js';\nimport { StimulusPanel } from '../StimulusPanel/index.js';\nimport type { ActivityProps, HtmlSanitizer, RenderableActivity, RenderMode } from '../types.js';\nimport { WrittenResponse, type WrittenResponseSubmission } from '../WrittenResponse/index.js';\n\n/**\n * What one finished slot in a sequence produced. Two kinds, because two kinds\n * of activity exist: those the SDK scores at submit time, and those a grader\n * scores later. Collapsing them would mean inventing a score for ungraded\n * work — the exact defect the deferred outcome exists to prevent.\n */\nexport type SequenceItemOutcome =\n  | {\n      kind: 'scored';\n      /** Presented position. */\n      index: number;\n      /** Slot identity from `flattenSequence` — stable under shuffling; the `slotId` to score with. */\n      slotId: string;\n      activityId: string;\n      result: ActivityResult;\n    }\n  | {\n      kind: 'submitted';\n      index: number;\n      slotId: string;\n      activityId: string;\n      /** Ungraded submission; the grade arrives asynchronously. */\n      submission: WrittenResponseSubmission;\n    }\n  | {\n      kind: 'responded';\n      index: number;\n      slotId: string;\n      activityId: string;\n      /**\n       * The raw answer, with no grade of any kind. This is what an `exam` slot\n       * produces: the client is forbidden to score, so a response is all there\n       * is until the server grades it.\n       */\n      response: LearnerResponse;\n    };\n\n/**\n * A component that can render one activity inside a sequence. Register one per\n * activity `type` to put a consumer-defined type on screen — the React half of\n * the activity-type registry, matching `registerActivityType` in lk-core.\n */\nexport type ActivityRenderer = ComponentType<ActivityProps>;\n\nexport interface ActivitySequenceProps {\n  /**\n   * The ordered set of entries to present, one question at a time: loose\n   * activities, and item groups — a shared passage, recording or image with\n   * the questions that refer to it. A group's stimulus stays on screen\n   * alongside each of its questions.\n   *\n   * Accepts `redact()` projections. For data straight off a server, pass it\n   * through `asRenderableSequence()` — see that helper for why a cast is\n   * unavoidable there — and set `renderMode=\"exam\"`.\n   */\n  activities: readonly SequenceEntry<RenderableActivity>[];\n  /**\n   * Renderers for activity types beyond the built-ins, keyed by `data.type`.\n   * A key matching a built-in overrides it, so a consumer can replace the\n   * bundled renderer without forking the sequencer.\n   */\n  renderers?: Readonly<Record<string, ActivityRenderer>>;\n  /**\n   * Called whenever an individual activity is scored at submit time — the\n   * incremental persist hook.\n   *\n   * `slotId` is the identity to store the result against, NOT `index`.\n   * `index` is where the question was PRESENTED, which is not stable: it moves\n   * under shuffling, and it already differs from the slot identity whenever a\n   * group is present (the second entry of a sequence is presented at index 1\n   * but is slot `\"1.0\"` if it is a group's first question). `composeAssessmentScore`\n   * scores by `slotId`, so persisting `index` cannot be reconciled with it.\n   */\n  onActivityComplete?: (result: ActivityResult, index: number, slotId: string) => void;\n  /**\n   * Called on every submit with the learner's raw response and the identity of\n   * the slot that produced it — before any grading, in every render mode.\n   *\n   * **This is the only response channel an `exam` sequence has.** In `exam`\n   * mode the components never grade, so `onActivityComplete` cannot fire and\n   * `onComplete` never will; without this prop nothing a learner submitted\n   * would reach the consumer at all. Persist `response` against `slotId`.\n   */\n  onSubmit?: (\n    response: LearnerResponse,\n    slot: { slotId: string; index: number; activityId: string },\n  ) => void;\n  /**\n   * Called once every activity has been completed, with the scored results.\n   *\n   * Fires only when EVERY item produced a score. A set containing a\n   * deferred-graded activity (a written response) can never satisfy that, so\n   * use `onFinished` for mixed sets — it is the general completion signal and\n   * reports both kinds of outcome. It also carries `slotId` per item, which\n   * this callback's bare array cannot.\n   */\n  onComplete?: (results: ActivityResult[]) => void;\n  /**\n   * Called once every activity has been completed, whether it was scored at\n   * submit time or submitted for later grading. Use this for any set that\n   * mixes graded and deferred-graded activities.\n   */\n  onFinished?: (items: SequenceItemOutcome[]) => void;\n  /** Forwarded to each activity. */\n  onInteraction?: (event: InteractionEvent) => void;\n  /** Forwarded to each activity. `exam` and `review` disable local scoring. */\n  renderMode?: RenderMode;\n  /**\n   * `entries` shuffles the top-level entries; a group moves as one block, and\n   * the order INSIDE a group follows the group's own `shuffle` setting.\n   * Default `none`: authored order.\n   */\n  shuffle?: 'none' | 'entries';\n  /**\n   * Seed for every shuffle in this sequence (`shuffle: 'entries'` and any\n   * group with `shuffle: 'within-group'`). Supply the attempt id, so the\n   * server's `flattenSequence(entries, { seed })` derives the same order this\n   * pager shows.\n   *\n   * **Required in `exam` and `review` mode** — omitting it throws. An order\n   * nobody can reproduce cannot be reconciled with a recorded attempt, and\n   * failing at render is the only way that mistake surfaces before a learner\n   * sits the paper. In `practice` mode it stays optional: a random per-mount\n   * seed is used, which is stable within the mount and deliberately not\n   * reproducible. That fallback is also not SSR-safe (server and client would\n   * invent different orders and hydration would mismatch), so supply a seed\n   * for any server-rendered sequence regardless of mode.\n   */\n  shuffleSeed?: string;\n  /** Renders author-supplied rich text; forwarded to the stimulus panel and every activity. */\n  sanitizeHtml?: HtmlSanitizer;\n  theme?: Partial<ThemeTokens>;\n  locale?: string;\n  disabled?: boolean;\n}\n\n/** One stimulus panel to keep mounted: the group, and the presented span of its questions. */\ninterface StimulusMount {\n  /** Authored entry position — unique per group in the sequence even if two groups share an id. */\n  entryKey: string;\n  group: SequenceSlotGroup;\n  first: number;\n  last: number;\n}\n\n/** The authored-entry prefix of a slot id: `\"3\"` for `\"3\"` and for `\"3.1\"`. */\nfunction entryKeyOf(slot: SequenceSlot<RenderableActivity>): string {\n  return slot.slotId.split('.')[0] ?? slot.slotId;\n}\n\n/**\n * A pane that is kept MOUNTED but shown only when it is the current one, and\n * that stops any media it contains on the way out.\n *\n * `hidden` alone is not enough. It resolves to `display: none`, and CSS does\n * not touch playback: an `<audio>` or `<video>` inside a hidden subtree keeps\n * playing to the end. (The HTML spec pauses a media element when it is\n * REMOVED from the document — a different thing, and the thing this pager\n * deliberately does not do, because unmounting is what used to destroy the\n * learner's answers.) So a recording started for one question would carry on\n * underneath the next, which for a listening paper means the passage plays\n * while the learner is somewhere else entirely.\n *\n * Pausing preserves `currentTime`: coming back to a group resumes where the\n * learner left off. Nothing auto-plays on the way in — starting audio the\n * learner did not ask for is its own defect.\n *\n * `embed` media (a provider iframe) cannot be paused this way: controlling a\n * third-party player needs its own JS API, which the SDK has no reliable\n * access to because the author supplies the embed URL. Use `audio`/`video`\n * media for anything that must stop when the learner navigates.\n */\nfunction SequencePane({\n  className,\n  hidden,\n  children,\n}: {\n  className: string;\n  hidden: boolean;\n  children: React.ReactNode;\n}): React.JSX.Element {\n  const ref = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    if (!hidden) {\n      return;\n    }\n    const node = ref.current;\n    if (node === null) {\n      return;\n    }\n    for (const media of node.querySelectorAll('audio, video')) {\n      const element = media as HTMLMediaElement;\n      if (!element.paused) {\n        element.pause();\n      }\n    }\n  }, [hidden]);\n\n  return (\n    <div className={className} hidden={hidden} ref={ref}>\n      {children}\n    </div>\n  );\n}\n\n/**\n * Presents a set of activities as an in-place pager: one question visible at a\n * time, navigated with Prev/Next (no page scrolling). Linear free navigation —\n * the learner may move back and forth; activities keep their own submit and\n * scoring. On navigation, focus moves to the question region and the position\n * is announced via an aria-live region.\n *\n * Item groups are flattened into consecutive questions; the group's stimulus\n * is mounted ONCE, beside the question region rather than inside it, and shown\n * alongside every question in the group — so a passage stays put, and a\n * recording keeps its position, as the learner moves between its questions.\n */\nexport function ActivitySequence({\n  activities,\n  renderers,\n  onActivityComplete,\n  onComplete,\n  onFinished,\n  onSubmit,\n  onInteraction,\n  renderMode = 'practice',\n  shuffle,\n  shuffleSeed,\n  sanitizeHtml,\n  theme,\n  locale,\n  disabled,\n}: ActivitySequenceProps): React.JSX.Element {\n  const sessionIdRef = useRef<string | null>(null);\n\n  // The presented order comes from lk-core, never computed here: the server\n  // that records an attempt calls the same function with the same seed.\n  const shuffleEntries = shuffle === 'entries';\n  const needsSeed =\n    shuffleEntries ||\n    activities.some((entry) => isItemGroup(entry) && entry.shuffle === 'within-group');\n\n  // An unreproducible order is a practice-only affordance. Under `exam` or\n  // `review` the server has to be able to rebuild exactly what the learner\n  // saw, so a missing seed is an error rather than something to paper over —\n  // the same reason `flattenSequence` refuses to invent one.\n  if (needsSeed && shuffleSeed === undefined && renderMode !== 'practice') {\n    throw new Error(\n      `ActivitySequence: renderMode \"${renderMode}\" requires a \\`shuffleSeed\\` when shuffling ` +\n        '(shuffle=\"entries\", or a group with shuffle: \"within-group\"). Pass the attempt id, so ' +\n        \"the server's flattenSequence(entries, { seed }) reproduces the order the learner saw.\",\n    );\n  }\n\n  // Lazily created only when shuffling in practice without a caller seed (same\n  // contract as MultipleChoice.shuffleSeed): a per-mount session seed, stable\n  // across re-renders, never reproducible.\n  const seed = needsSeed\n    ? // biome-ignore lint/suspicious/noAssignInExpressions: sanctioned lazy ref initialization\n      (shuffleSeed ?? (sessionIdRef.current ??= randomSessionId()))\n    : undefined;\n  const slots = useMemo(\n    () => flattenSequence(activities, { shuffleEntries, ...(seed !== undefined ? { seed } : {}) }),\n    [activities, shuffleEntries, seed],\n  );\n\n  const [index, setIndex] = useState(0);\n  // Outcomes live in a ref, not state: nothing renders from them, and a ref is\n  // written SYNCHRONOUSLY. Reading them from a `useState` closure meant two\n  // slots completing in the same tick both saw the pre-update array — the\n  // second overwrote the first, so one answer vanished and completion never\n  // fired. Every slot is mounted at once here, so same-tick completions are\n  // reachable (a custom renderer that completes from a mount effect).\n  const outcomesRef = useRef<(SequenceItemOutcome | null)[] | null>(null);\n  if (outcomesRef.current === null) {\n    outcomesRef.current = slots.map(() => null);\n  }\n  const regionRef = useRef<HTMLDivElement>(null);\n  const mountedRef = useRef(false);\n\n  // Reset pager position and outcomes when the presented SET changes (B8):\n  // without this, results from the previous set leak into the new one and can\n  // fire completion with a mixed old/new array. Keyed on the set's CONTENT\n  // identity (ordered slot and activity ids), not the array reference — a\n  // parent that re-creates a structurally identical array on every render\n  // (inline literals, .map() in render) must not wipe in-progress answers.\n  // JSON.stringify (not join) so ids containing the separator cannot collide.\n  const setKey = JSON.stringify(slots.map((slot) => [slot.slotId, slot.activity.id]));\n  const [prevSetKey, setPrevSetKey] = useState(setKey);\n  if (prevSetKey !== setKey) {\n    setPrevSetKey(setKey);\n    setIndex(0);\n    outcomesRef.current = slots.map(() => null);\n  }\n\n  // After a navigation (not the initial mount) move focus to the question\n  // region so screen-reader / keyboard users land on the new question.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: index is the intended trigger\n  useEffect(() => {\n    if (mountedRef.current) {\n      regionRef.current?.focus();\n    } else {\n      mountedRef.current = true;\n    }\n  }, [index]);\n\n  // One panel per group, spanning the presented positions of its questions.\n  const stimulusMounts = useMemo<StimulusMount[]>(() => {\n    const mounts = new Map<string, StimulusMount>();\n    for (const slot of slots) {\n      if (slot.group === undefined) {\n        continue;\n      }\n      const entryKey = entryKeyOf(slot);\n      const existing = mounts.get(entryKey);\n      if (existing === undefined) {\n        mounts.set(entryKey, { entryKey, group: slot.group, first: slot.index, last: slot.index });\n      } else {\n        existing.last = slot.index;\n      }\n    }\n    return [...mounts.values()];\n  }, [slots]);\n\n  const total = slots.length;\n  const current = slots[index];\n\n  const go = (next: number): void => {\n    setIndex(next);\n  };\n\n  /**\n   * Records a finished slot and fires completion callbacks when the set is\n   * done. A slot that already holds an outcome is FINAL: re-recording it would\n   * fire completion a second time for one attempt, so a consumer persisting on\n   * `onFinished` would write the same attempt twice.\n   */\n  const record = (outcome: SequenceItemOutcome): void => {\n    const current = outcomesRef.current;\n    if (current === null || current[outcome.index] != null) {\n      return;\n    }\n    const next = current.slice();\n    next[outcome.index] = outcome;\n    // Commit before firing anything: a second record() in the same tick must\n    // see this one.\n    outcomesRef.current = next;\n\n    if (outcome.kind === 'scored') {\n      onActivityComplete?.(outcome.result, outcome.index, outcome.slotId);\n    }\n\n    if (!next.every((item): item is SequenceItemOutcome => item !== null)) {\n      return;\n    }\n    onFinished?.(next);\n\n    // `onComplete` predates deferred grading and promises ActivityResult[].\n    // Fire it only when every slot really was scored, rather than inventing a\n    // result for work nobody has graded.\n    const scored: ActivityResult[] = [];\n    for (const item of next) {\n      if (item.kind !== 'scored') {\n        return;\n      }\n      scored.push(item.result);\n    }\n    onComplete?.(scored);\n  };\n\n  if (!current) {\n    return <div className=\"lk-seq\" />;\n  }\n\n  const forwarded = {\n    ...(onInteraction ? { onInteraction } : {}),\n    renderMode,\n    ...(sanitizeHtml ? { sanitizeHtml } : {}),\n    ...(theme ? { theme } : {}),\n    ...(locale ? { locale } : {}),\n    ...(disabled ? { disabled } : {}),\n  };\n\n  const renderSlot = (slot: SequenceSlot<RenderableActivity>): React.JSX.Element => {\n    const activity = slot.activity;\n    const { slotId, index: slotIndex } = slot;\n    const activityId = activity.id;\n    const childProps = {\n      onComplete: (result: ActivityResult) =>\n        record({ kind: 'scored', index: slotIndex, slotId, activityId, result }),\n      onSubmit: (response: LearnerResponse) => {\n        onSubmit?.(response, { slotId, index: slotIndex, activityId });\n        // Outside `practice` the components do not grade, so a raw response is\n        // the ONLY outcome this slot will ever produce — record it, or the set\n        // could never complete and `onFinished` would be dead in exam mode.\n        // Written responses are excluded because they report something richer\n        // through `onSubmitted` a moment later, and the first outcome wins.\n        if (renderMode !== 'practice' && activity.type !== 'written-response') {\n          record({ kind: 'responded', index: slotIndex, slotId, activityId, response });\n        }\n      },\n      ...forwarded,\n    };\n\n    const CustomRenderer = renderers?.[activity.type];\n    if (CustomRenderer) {\n      return <CustomRenderer data={activity} {...childProps} />;\n    }\n    if (activity.type === 'multiple-choice') {\n      return <MultipleChoice data={activity} {...childProps} />;\n    }\n    if (activity.type === 'fill-in-the-blanks') {\n      return <FillInTheBlanks data={activity} {...childProps} />;\n    }\n    if (activity.type === 'written-response') {\n      return (\n        <WrittenResponse\n          data={activity}\n          onSubmitted={(submission) =>\n            record({ kind: 'submitted', index: slotIndex, slotId, activityId, submission })\n          }\n          // Explicit rather than spread: WrittenResponse has no `onComplete`\n          // (it never grades), so `childProps` does not fit it — but it must\n          // still report the raw response like every other slot.\n          onSubmit={childProps.onSubmit}\n          {...forwarded}\n        />\n      );\n    }\n    return (\n      <div className=\"lk-seq-unsupported\" role=\"note\">\n        This activity type has no renderer. Supply one through the renderers prop.\n      </div>\n    );\n  };\n\n  const currentEntryKey = entryKeyOf(current);\n\n  return (\n    <div className=\"lk-seq\" lang={locale}>\n      <div className=\"lk-seq-progress\" aria-live=\"polite\" role=\"status\">\n        Question {index + 1} of {total}\n      </div>\n\n      {/*\n        Each group's stimulus is mounted ONCE and only hidden while the current\n        question is outside its group. That — not re-rendering it per slot — is\n        what makes the passage the same DOM node throughout, and what lets a\n        recording keep its position between questions of one group.\n\n        It sits BESIDE the question region, not inside it. Inside, every\n        navigation dropped focus onto a container whose first content was the\n        whole passage: the region promised \"Question 3 of 5\" and then began\n        with the passage, keyboard users tabbed through the stimulus (audio\n        controls included) before reaching the question, and the passage was a\n        landmark nested inside another landmark. As a sibling it stays a\n        landmark the learner can jump back to, while focus lands on the\n        question that was actually navigated to.\n      */}\n      {stimulusMounts.map(({ entryKey, group, first, last }) => (\n        <SequencePane\n          className=\"lk-seq-stimulus\"\n          hidden={entryKey !== currentEntryKey}\n          key={`group-${entryKey}`}\n        >\n          <StimulusPanel\n            stimulus={group.stimulus}\n            range={{ first: first + 1, last: last + 1 }}\n            {...(sanitizeHtml ? { sanitizeHtml } : {})}\n            {...(locale ? { locale } : {})}\n          />\n        </SequencePane>\n      ))}\n\n      <section\n        className=\"lk-seq-question\"\n        ref={regionRef}\n        tabIndex={-1}\n        aria-label={`Question ${index + 1} of ${total}`}\n      >\n        {/*\n          Every slot stays MOUNTED; only the current one is visible. Rendering\n          just the current activity unmounted the others, so navigating back to\n          an answered question showed it blank and re-answerable — the learner\n          silently lost their answer and a second submit fired completion\n          again. `hidden` removes the inactive slots from the accessibility\n          tree and from tab order, so only the current question is reachable.\n        */}\n        {slots.map((slot) => {\n          // The slot id (authored position) plus the activity id: the same\n          // activity may legitimately fill two slots, and each must keep its\n          // own answer state; and a different activity in the same slot must\n          // remount rather than inherit the previous one's state.\n          //\n          // `setKey` leads, so a set change remounts every child. Without it a\n          // pure REORDER changed `setKey` — clearing the outcomes — while each\n          // child kept its key and therefore its `completed` state. Those\n          // slots could not be answered again and no outcome would ever refill\n          // them, so the sequence could never finish. A reset has to reset\n          // both halves or neither. A parent re-creating a structurally\n          // identical array leaves `setKey` untouched, so answers still\n          // survive that.\n          const slotKey = `${setKey}::slot-${slot.slotId}-${slot.activity.id}`;\n          return (\n            <SequencePane className=\"lk-seq-slot\" hidden={slot.index !== index} key={slotKey}>\n              {renderSlot(slot)}\n            </SequencePane>\n          );\n        })}\n      </section>\n\n      <div className=\"lk-seq-nav\">\n        <button\n          type=\"button\"\n          className=\"lk-seq-prev\"\n          onClick={() => go(index - 1)}\n          disabled={index === 0}\n        >\n          Previous\n        </button>\n        <button\n          type=\"button\"\n          className=\"lk-seq-next\"\n          onClick={() => go(index + 1)}\n          disabled={index === total - 1}\n        >\n          Next\n        </button>\n      </div>\n    </div>\n  );\n}\n"]}
+{"version":3,"sources":["../src/components/ActivitySequence/ActivitySequence.tsx"],"names":["current"],"mappings":"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","file":"chunk-NBFTCGQ5.js","sourcesContent":["'use client';\n\nimport {\n  type ActivityResult,\n  flattenSequence,\n  type InteractionEvent,\n  isItemGroup,\n  type LearnerResponse,\n  type SequenceEntry,\n  type SequenceSlot,\n  type SequenceSlotGroup,\n  type ThemeTokens,\n} from '@intellectif/lk-core';\nimport { type ComponentType, useEffect, useMemo, useRef, useState } from 'react';\nimport { randomSessionId } from '../_internal.js';\nimport { FillInTheBlanks } from '../FillInTheBlanks/index.js';\nimport { MultipleChoice } from '../MultipleChoice/index.js';\nimport { StimulusPanel } from '../StimulusPanel/index.js';\nimport type { ActivityProps, HtmlSanitizer, RenderableActivity, RenderMode } from '../types.js';\nimport { WrittenResponse, type WrittenResponseSubmission } from '../WrittenResponse/index.js';\n\n/**\n * What one finished slot in a sequence produced. Two kinds, because two kinds\n * of activity exist: those the SDK scores at submit time, and those a grader\n * scores later. Collapsing them would mean inventing a score for ungraded\n * work — the exact defect the deferred outcome exists to prevent.\n */\nexport type SequenceItemOutcome =\n  | {\n      kind: 'scored';\n      /** Presented position. */\n      index: number;\n      /** Slot identity from `flattenSequence` — stable under shuffling; the `slotId` to score with. */\n      slotId: string;\n      activityId: string;\n      result: ActivityResult;\n    }\n  | {\n      kind: 'submitted';\n      index: number;\n      slotId: string;\n      activityId: string;\n      /** Ungraded submission; the grade arrives asynchronously. */\n      submission: WrittenResponseSubmission;\n    }\n  | {\n      kind: 'responded';\n      index: number;\n      slotId: string;\n      activityId: string;\n      /**\n       * The raw answer, with no grade of any kind. This is what an `exam` slot\n       * produces: the client is forbidden to score, so a response is all there\n       * is until the server grades it.\n       */\n      response: LearnerResponse;\n    };\n\n/**\n * A component that can render one activity inside a sequence. Register one per\n * activity `type` to put a consumer-defined type on screen — the React half of\n * the activity-type registry, matching `registerActivityType` in lk-core.\n */\nexport type ActivityRenderer = ComponentType<ActivityProps>;\n\nexport interface ActivitySequenceProps {\n  /**\n   * The ordered set of entries to present, one question at a time: loose\n   * activities, and item groups — a shared passage, recording or image with\n   * the questions that refer to it. A group's stimulus stays on screen\n   * alongside each of its questions.\n   *\n   * Accepts `redact()` projections. For data straight off a server, pass it\n   * through `asRenderableSequence()` — see that helper for why a cast is\n   * unavoidable there — and set `renderMode=\"exam\"`.\n   */\n  activities: readonly SequenceEntry<RenderableActivity>[];\n  /**\n   * Renderers for activity types beyond the built-ins, keyed by `data.type`.\n   * A key matching a built-in overrides it, so a consumer can replace the\n   * bundled renderer without forking the sequencer.\n   */\n  renderers?: Readonly<Record<string, ActivityRenderer>>;\n  /**\n   * Called whenever an individual activity is scored at submit time — the\n   * incremental persist hook.\n   *\n   * `slotId` is the identity to store the result against, NOT `index`.\n   * `index` is where the question was PRESENTED, which is not stable: it moves\n   * under shuffling, and it already differs from the slot identity whenever a\n   * group is present (the second entry of a sequence is presented at index 1\n   * but is slot `\"1.0\"` if it is a group's first question). `composeAssessmentScore`\n   * scores by `slotId`, so persisting `index` cannot be reconciled with it.\n   */\n  onActivityComplete?: (result: ActivityResult, index: number, slotId: string) => void;\n  /**\n   * Called on every submit with the learner's raw response and the identity of\n   * the slot that produced it — before any grading, in every render mode.\n   *\n   * **This is the only response channel an `exam` sequence has.** In `exam`\n   * mode the components never grade, so `onActivityComplete` cannot fire and\n   * `onComplete` never will; without this prop nothing a learner submitted\n   * would reach the consumer at all. Persist `response` against `slotId`.\n   */\n  onSubmit?: (\n    response: LearnerResponse,\n    slot: { slotId: string; index: number; activityId: string },\n  ) => void;\n  /**\n   * Called once every activity has been completed, with the scored results.\n   *\n   * Fires only when EVERY item produced a score. A set containing a\n   * deferred-graded activity (a written response) can never satisfy that, so\n   * use `onFinished` for mixed sets — it is the general completion signal and\n   * reports both kinds of outcome. It also carries `slotId` per item, which\n   * this callback's bare array cannot.\n   */\n  onComplete?: (results: ActivityResult[]) => void;\n  /**\n   * Called once every activity has been completed, whether it was scored at\n   * submit time or submitted for later grading. Use this for any set that\n   * mixes graded and deferred-graded activities.\n   */\n  onFinished?: (items: SequenceItemOutcome[]) => void;\n  /** Forwarded to each activity. */\n  onInteraction?: (event: InteractionEvent) => void;\n  /** Forwarded to each activity. `exam` and `review` disable local scoring. */\n  renderMode?: RenderMode;\n  /**\n   * `entries` shuffles the top-level entries; a group moves as one block, and\n   * the order INSIDE a group follows the group's own `shuffle` setting.\n   * Default `none`: authored order.\n   */\n  shuffle?: 'none' | 'entries';\n  /**\n   * Seed for every shuffle in this sequence (`shuffle: 'entries'` and any\n   * group with `shuffle: 'within-group'`). Supply the attempt id, so the\n   * server's `flattenSequence(entries, { seed })` derives the same order this\n   * pager shows.\n   *\n   * **Required in `exam` and `review` mode** — omitting it throws. An order\n   * nobody can reproduce cannot be reconciled with a recorded attempt, and\n   * failing at render is the only way that mistake surfaces before a learner\n   * sits the paper. In `practice` mode it stays optional: a random per-mount\n   * seed is used, which is stable within the mount and deliberately not\n   * reproducible. That fallback is also not SSR-safe (server and client would\n   * invent different orders and hydration would mismatch), so supply a seed\n   * for any server-rendered sequence regardless of mode.\n   */\n  shuffleSeed?: string;\n  /** Renders author-supplied rich text; forwarded to the stimulus panel and every activity. */\n  sanitizeHtml?: HtmlSanitizer;\n  theme?: Partial<ThemeTokens>;\n  locale?: string;\n  disabled?: boolean;\n}\n\n/** One stimulus panel to keep mounted: the group, and the presented span of its questions. */\ninterface StimulusMount {\n  /** Authored entry position — unique per group in the sequence even if two groups share an id. */\n  entryKey: string;\n  group: SequenceSlotGroup;\n  first: number;\n  last: number;\n}\n\n/** The authored-entry prefix of a slot id: `\"3\"` for `\"3\"` and for `\"3.1\"`. */\nfunction entryKeyOf(slot: SequenceSlot<RenderableActivity>): string {\n  return slot.slotId.split('.')[0] ?? slot.slotId;\n}\n\n/**\n * A pane that is kept MOUNTED but shown only when it is the current one, and\n * that stops any media it contains on the way out.\n *\n * `hidden` alone is not enough. It resolves to `display: none`, and CSS does\n * not touch playback: an `<audio>` or `<video>` inside a hidden subtree keeps\n * playing to the end. (The HTML spec pauses a media element when it is\n * REMOVED from the document — a different thing, and the thing this pager\n * deliberately does not do, because unmounting is what used to destroy the\n * learner's answers.) So a recording started for one question would carry on\n * underneath the next, which for a listening paper means the passage plays\n * while the learner is somewhere else entirely.\n *\n * Pausing preserves `currentTime`: coming back to a group resumes where the\n * learner left off. Nothing auto-plays on the way in — starting audio the\n * learner did not ask for is its own defect.\n *\n * `embed` media (a provider iframe) cannot be paused this way: controlling a\n * third-party player needs its own JS API, which the SDK has no reliable\n * access to because the author supplies the embed URL. Use `audio`/`video`\n * media for anything that must stop when the learner navigates.\n */\nfunction SequencePane({\n  className,\n  hidden,\n  children,\n}: {\n  className: string;\n  hidden: boolean;\n  children: React.ReactNode;\n}): React.JSX.Element {\n  const ref = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    if (!hidden) {\n      return;\n    }\n    const node = ref.current;\n    if (node === null) {\n      return;\n    }\n    for (const media of node.querySelectorAll('audio, video')) {\n      const element = media as HTMLMediaElement;\n      if (!element.paused) {\n        element.pause();\n      }\n    }\n  }, [hidden]);\n\n  return (\n    <div className={className} hidden={hidden} ref={ref}>\n      {children}\n    </div>\n  );\n}\n\n/**\n * Presents a set of activities as an in-place pager: one question visible at a\n * time, navigated with Prev/Next (no page scrolling). Linear free navigation —\n * the learner may move back and forth; activities keep their own submit and\n * scoring. On navigation, focus moves to the question region and the position\n * is announced via an aria-live region.\n *\n * Item groups are flattened into consecutive questions; the group's stimulus\n * is mounted ONCE, beside the question region rather than inside it, and shown\n * alongside every question in the group — so a passage stays put, and a\n * recording keeps its position, as the learner moves between its questions.\n */\nexport function ActivitySequence({\n  activities,\n  renderers,\n  onActivityComplete,\n  onComplete,\n  onFinished,\n  onSubmit,\n  onInteraction,\n  renderMode = 'practice',\n  shuffle,\n  shuffleSeed,\n  sanitizeHtml,\n  theme,\n  locale,\n  disabled,\n}: ActivitySequenceProps): React.JSX.Element {\n  const sessionIdRef = useRef<string | null>(null);\n\n  // The presented order comes from lk-core, never computed here: the server\n  // that records an attempt calls the same function with the same seed.\n  const shuffleEntries = shuffle === 'entries';\n  const needsSeed =\n    shuffleEntries ||\n    activities.some((entry) => isItemGroup(entry) && entry.shuffle === 'within-group');\n\n  // An unreproducible order is a practice-only affordance. Under `exam` or\n  // `review` the server has to be able to rebuild exactly what the learner\n  // saw, so a missing seed is an error rather than something to paper over —\n  // the same reason `flattenSequence` refuses to invent one.\n  if (needsSeed && shuffleSeed === undefined && renderMode !== 'practice') {\n    throw new Error(\n      `ActivitySequence: renderMode \"${renderMode}\" requires a \\`shuffleSeed\\` when shuffling ` +\n        '(shuffle=\"entries\", or a group with shuffle: \"within-group\"). Pass the attempt id, so ' +\n        \"the server's flattenSequence(entries, { seed }) reproduces the order the learner saw.\",\n    );\n  }\n\n  // Lazily created only when shuffling in practice without a caller seed (same\n  // contract as MultipleChoice.shuffleSeed): a per-mount session seed, stable\n  // across re-renders, never reproducible.\n  const seed = needsSeed\n    ? // biome-ignore lint/suspicious/noAssignInExpressions: sanctioned lazy ref initialization\n      (shuffleSeed ?? (sessionIdRef.current ??= randomSessionId()))\n    : undefined;\n  const slots = useMemo(\n    () => flattenSequence(activities, { shuffleEntries, ...(seed !== undefined ? { seed } : {}) }),\n    [activities, shuffleEntries, seed],\n  );\n\n  const [index, setIndex] = useState(0);\n  // Outcomes live in a ref, not state: nothing renders from them, and a ref is\n  // written SYNCHRONOUSLY. Reading them from a `useState` closure meant two\n  // slots completing in the same tick both saw the pre-update array — the\n  // second overwrote the first, so one answer vanished and completion never\n  // fired. Every slot is mounted at once here, so same-tick completions are\n  // reachable (a custom renderer that completes from a mount effect).\n  const outcomesRef = useRef<(SequenceItemOutcome | null)[] | null>(null);\n  if (outcomesRef.current === null) {\n    outcomesRef.current = slots.map(() => null);\n  }\n  const regionRef = useRef<HTMLDivElement>(null);\n  const mountedRef = useRef(false);\n\n  // Reset pager position and outcomes when the presented SET changes (B8):\n  // without this, results from the previous set leak into the new one and can\n  // fire completion with a mixed old/new array. Keyed on the set's CONTENT\n  // identity (ordered slot and activity ids), not the array reference — a\n  // parent that re-creates a structurally identical array on every render\n  // (inline literals, .map() in render) must not wipe in-progress answers.\n  // JSON.stringify (not join) so ids containing the separator cannot collide.\n  const setKey = JSON.stringify(slots.map((slot) => [slot.slotId, slot.activity.id]));\n  const [prevSetKey, setPrevSetKey] = useState(setKey);\n  if (prevSetKey !== setKey) {\n    setPrevSetKey(setKey);\n    setIndex(0);\n    outcomesRef.current = slots.map(() => null);\n  }\n\n  // After a navigation (not the initial mount) move focus to the question\n  // region so screen-reader / keyboard users land on the new question.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: index is the intended trigger\n  useEffect(() => {\n    if (mountedRef.current) {\n      regionRef.current?.focus();\n    } else {\n      mountedRef.current = true;\n    }\n  }, [index]);\n\n  // One panel per group, spanning the presented positions of its questions.\n  const stimulusMounts = useMemo<StimulusMount[]>(() => {\n    const mounts = new Map<string, StimulusMount>();\n    for (const slot of slots) {\n      if (slot.group === undefined) {\n        continue;\n      }\n      const entryKey = entryKeyOf(slot);\n      const existing = mounts.get(entryKey);\n      if (existing === undefined) {\n        mounts.set(entryKey, { entryKey, group: slot.group, first: slot.index, last: slot.index });\n      } else {\n        existing.last = slot.index;\n      }\n    }\n    return [...mounts.values()];\n  }, [slots]);\n\n  const total = slots.length;\n  const current = slots[index];\n\n  const go = (next: number): void => {\n    setIndex(next);\n  };\n\n  /**\n   * Records a finished slot and fires completion callbacks when the set is\n   * done. A slot that already holds an outcome is FINAL: re-recording it would\n   * fire completion a second time for one attempt, so a consumer persisting on\n   * `onFinished` would write the same attempt twice.\n   */\n  const record = (outcome: SequenceItemOutcome): void => {\n    const current = outcomesRef.current;\n    if (current === null || current[outcome.index] != null) {\n      return;\n    }\n    const next = current.slice();\n    next[outcome.index] = outcome;\n    // Commit before firing anything: a second record() in the same tick must\n    // see this one.\n    outcomesRef.current = next;\n\n    if (outcome.kind === 'scored') {\n      onActivityComplete?.(outcome.result, outcome.index, outcome.slotId);\n    }\n\n    if (!next.every((item): item is SequenceItemOutcome => item !== null)) {\n      return;\n    }\n    onFinished?.(next);\n\n    // `onComplete` predates deferred grading and promises ActivityResult[].\n    // Fire it only when every slot really was scored, rather than inventing a\n    // result for work nobody has graded.\n    const scored: ActivityResult[] = [];\n    for (const item of next) {\n      if (item.kind !== 'scored') {\n        return;\n      }\n      scored.push(item.result);\n    }\n    onComplete?.(scored);\n  };\n\n  if (!current) {\n    return <div className=\"lk-seq\" />;\n  }\n\n  const forwarded = {\n    ...(onInteraction ? { onInteraction } : {}),\n    renderMode,\n    ...(sanitizeHtml ? { sanitizeHtml } : {}),\n    ...(theme ? { theme } : {}),\n    ...(locale ? { locale } : {}),\n    ...(disabled ? { disabled } : {}),\n  };\n\n  const renderSlot = (slot: SequenceSlot<RenderableActivity>): React.JSX.Element => {\n    const activity = slot.activity;\n    const { slotId, index: slotIndex } = slot;\n    const activityId = activity.id;\n    const childProps = {\n      onComplete: (result: ActivityResult) =>\n        record({ kind: 'scored', index: slotIndex, slotId, activityId, result }),\n      onSubmit: (response: LearnerResponse) => {\n        onSubmit?.(response, { slotId, index: slotIndex, activityId });\n        // Outside `practice` the components do not grade, so a raw response is\n        // the ONLY outcome this slot will ever produce — record it, or the set\n        // could never complete and `onFinished` would be dead in exam mode.\n        // Written responses are excluded because they report something richer\n        // through `onSubmitted` a moment later, and the first outcome wins.\n        if (renderMode !== 'practice' && activity.type !== 'written-response') {\n          record({ kind: 'responded', index: slotIndex, slotId, activityId, response });\n        }\n      },\n      ...forwarded,\n    };\n\n    const CustomRenderer = renderers?.[activity.type];\n    if (CustomRenderer) {\n      return <CustomRenderer data={activity} {...childProps} />;\n    }\n    if (activity.type === 'multiple-choice') {\n      return <MultipleChoice data={activity} {...childProps} />;\n    }\n    if (activity.type === 'fill-in-the-blanks') {\n      return <FillInTheBlanks data={activity} {...childProps} />;\n    }\n    if (activity.type === 'written-response') {\n      return (\n        <WrittenResponse\n          data={activity}\n          onSubmitted={(submission) =>\n            record({ kind: 'submitted', index: slotIndex, slotId, activityId, submission })\n          }\n          // Explicit rather than spread: WrittenResponse has no `onComplete`\n          // (it never grades), so `childProps` does not fit it — but it must\n          // still report the raw response like every other slot.\n          onSubmit={childProps.onSubmit}\n          {...forwarded}\n        />\n      );\n    }\n    return (\n      <div className=\"lk-seq-unsupported\" role=\"note\">\n        This activity type has no renderer. Supply one through the renderers prop.\n      </div>\n    );\n  };\n\n  const currentEntryKey = entryKeyOf(current);\n\n  return (\n    <div className=\"lk-seq\" lang={locale}>\n      <div className=\"lk-seq-progress\" aria-live=\"polite\" role=\"status\">\n        Question {index + 1} of {total}\n      </div>\n\n      {/*\n        Each group's stimulus is mounted ONCE and only hidden while the current\n        question is outside its group. That — not re-rendering it per slot — is\n        what makes the passage the same DOM node throughout, and what lets a\n        recording keep its position between questions of one group.\n\n        It sits BESIDE the question region, not inside it. Inside, every\n        navigation dropped focus onto a container whose first content was the\n        whole passage: the region promised \"Question 3 of 5\" and then began\n        with the passage, keyboard users tabbed through the stimulus (audio\n        controls included) before reaching the question, and the passage was a\n        landmark nested inside another landmark. As a sibling it stays a\n        landmark the learner can jump back to, while focus lands on the\n        question that was actually navigated to.\n      */}\n      {stimulusMounts.map(({ entryKey, group, first, last }) => (\n        <SequencePane\n          className=\"lk-seq-stimulus\"\n          hidden={entryKey !== currentEntryKey}\n          key={`group-${entryKey}`}\n        >\n          <StimulusPanel\n            stimulus={group.stimulus}\n            range={{ first: first + 1, last: last + 1 }}\n            {...(sanitizeHtml ? { sanitizeHtml } : {})}\n            {...(locale ? { locale } : {})}\n          />\n        </SequencePane>\n      ))}\n\n      <section\n        className=\"lk-seq-question\"\n        ref={regionRef}\n        tabIndex={-1}\n        aria-label={`Question ${index + 1} of ${total}`}\n      >\n        {/*\n          Every slot stays MOUNTED; only the current one is visible. Rendering\n          just the current activity unmounted the others, so navigating back to\n          an answered question showed it blank and re-answerable — the learner\n          silently lost their answer and a second submit fired completion\n          again. `hidden` removes the inactive slots from the accessibility\n          tree and from tab order, so only the current question is reachable.\n        */}\n        {slots.map((slot) => {\n          // The slot id (authored position) plus the activity id: the same\n          // activity may legitimately fill two slots, and each must keep its\n          // own answer state; and a different activity in the same slot must\n          // remount rather than inherit the previous one's state.\n          //\n          // `setKey` leads, so a set change remounts every child. Without it a\n          // pure REORDER changed `setKey` — clearing the outcomes — while each\n          // child kept its key and therefore its `completed` state. Those\n          // slots could not be answered again and no outcome would ever refill\n          // them, so the sequence could never finish. A reset has to reset\n          // both halves or neither. A parent re-creating a structurally\n          // identical array leaves `setKey` untouched, so answers still\n          // survive that.\n          const slotKey = `${setKey}::slot-${slot.slotId}-${slot.activity.id}`;\n          return (\n            <SequencePane className=\"lk-seq-slot\" hidden={slot.index !== index} key={slotKey}>\n              {renderSlot(slot)}\n            </SequencePane>\n          );\n        })}\n      </section>\n\n      <div className=\"lk-seq-nav\">\n        <button\n          type=\"button\"\n          className=\"lk-seq-prev\"\n          onClick={() => go(index - 1)}\n          disabled={index === 0}\n        >\n          Previous\n        </button>\n        <button\n          type=\"button\"\n          className=\"lk-seq-next\"\n          onClick={() => go(index + 1)}\n          disabled={index === total - 1}\n        >\n          Next\n        </button>\n      </div>\n    </div>\n  );\n}\n"]}

package/dist/components/ActivitySequence.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunk525EWDUT_cjs = require('../chunk-525EWDUT.cjs');
+var chunk3B4ACY4K_cjs = require('../chunk-3B4ACY4K.cjs');
 require('../chunk-WCVD5LVG.cjs');
 require('../chunk-67RIIDZX.cjs');
-require('../chunk-XQJFLAMD.cjs');
+require('../chunk-6COTYW77.cjs');
 require('../chunk-PGEG7UZJ.cjs');
 require('../chunk-NEWGUDA5.cjs');
 require('../chunk-4HZ7LQIH.cjs');
@@ -13,7 +13,7 @@ require('../chunk-HD2AIQRD.cjs');
 
 Object.defineProperty(exports, "ActivitySequence", {
   enumerable: true,
-  get: function () { return chunk525EWDUT_cjs.ActivitySequence; }
+  get: function () { return chunk3B4ACY4K_cjs.ActivitySequence; }
 });
 //# sourceMappingURL=ActivitySequence.cjs.map
 //# sourceMappingURL=ActivitySequence.cjs.map

package/dist/components/ActivitySequence.js

@@ -1,7 +1,7 @@
-export { ActivitySequence } from '../chunk-GMU77L52.js';
+export { ActivitySequence } from '../chunk-NBFTCGQ5.js';
 import '../chunk-5SYL5CJ2.js';
 import '../chunk-3DNJDP73.js';
-import '../chunk-SWZRB3VY.js';
+import '../chunk-67WDTQMG.js';
 import '../chunk-6F4X2NKL.js';
 import '../chunk-UQ3BBEIT.js';
 import '../chunk-GB5URWM4.js';

package/dist/components/WrittenResponse.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkXQJFLAMD_cjs = require('../chunk-XQJFLAMD.cjs');
+var chunk6COTYW77_cjs = require('../chunk-6COTYW77.cjs');
 require('../chunk-PGEG7UZJ.cjs');
 require('../chunk-4HZ7LQIH.cjs');
 require('../chunk-HD2AIQRD.cjs');
@@ -9,7 +9,7 @@ require('../chunk-HD2AIQRD.cjs');
 
 Object.defineProperty(exports, "WrittenResponse", {
   enumerable: true,
-  get: function () { return chunkXQJFLAMD_cjs.WrittenResponse; }
+  get: function () { return chunk6COTYW77_cjs.WrittenResponse; }
 });
 //# sourceMappingURL=WrittenResponse.cjs.map
 //# sourceMappingURL=WrittenResponse.cjs.map

package/dist/components/WrittenResponse.js

@@ -1,4 +1,4 @@
-export { WrittenResponse } from '../chunk-SWZRB3VY.js';
+export { WrittenResponse } from '../chunk-67WDTQMG.js';
 import '../chunk-6F4X2NKL.js';
 import '../chunk-GB5URWM4.js';
 import '../chunk-5HVUKXF3.js';

package/dist/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
 var chunkCPF2JJG6_cjs = require('./chunk-CPF2JJG6.cjs');
-var chunk525EWDUT_cjs = require('./chunk-525EWDUT.cjs');
+var chunk3B4ACY4K_cjs = require('./chunk-3B4ACY4K.cjs');
 var chunkWCVD5LVG_cjs = require('./chunk-WCVD5LVG.cjs');
 var chunk67RIIDZX_cjs = require('./chunk-67RIIDZX.cjs');
-var chunkXQJFLAMD_cjs = require('./chunk-XQJFLAMD.cjs');
+var chunk6COTYW77_cjs = require('./chunk-6COTYW77.cjs');
 require('./chunk-PGEG7UZJ.cjs');
 var chunkNEWGUDA5_cjs = require('./chunk-NEWGUDA5.cjs');
 require('./chunk-4HZ7LQIH.cjs');
@@ -37,7 +37,7 @@ Object.defineProperty(exports, "useTheme", {
 });
 Object.defineProperty(exports, "ActivitySequence", {
   enumerable: true,
-  get: function () { return chunk525EWDUT_cjs.ActivitySequence; }
+  get: function () { return chunk3B4ACY4K_cjs.ActivitySequence; }
 });
 Object.defineProperty(exports, "MultipleChoice", {
   enumerable: true,
@@ -49,7 +49,7 @@ Object.defineProperty(exports, "FillInTheBlanks", {
 });
 Object.defineProperty(exports, "WrittenResponse", {
   enumerable: true,
-  get: function () { return chunkXQJFLAMD_cjs.WrittenResponse; }
+  get: function () { return chunk6COTYW77_cjs.WrittenResponse; }
 });
 Object.defineProperty(exports, "StimulusPanel", {
   enumerable: true,

package/dist/index.js

@@ -1,8 +1,8 @@
 export { ThemeProvider, darkTheme, defaultTheme, useTheme } from './chunk-B3FUUKZ2.js';
-export { ActivitySequence } from './chunk-GMU77L52.js';
+export { ActivitySequence } from './chunk-NBFTCGQ5.js';
 export { MultipleChoice } from './chunk-5SYL5CJ2.js';
 export { FillInTheBlanks } from './chunk-3DNJDP73.js';
-export { WrittenResponse } from './chunk-SWZRB3VY.js';
+export { WrittenResponse } from './chunk-67WDTQMG.js';
 import './chunk-6F4X2NKL.js';
 export { StimulusPanel } from './chunk-UQ3BBEIT.js';
 import './chunk-GB5URWM4.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intellectif/lk-react",
-  "version": "4.0.0",
+  "version": "5.0.0",
   "description": "React 19 activity components, hooks, and theming for learning-kit",
   "repository": {
     "type": "git",
@@ -115,7 +115,7 @@
   "peerDependencies": {
     "react": "^19",
     "react-dom": "^19",
-    "@intellectif/lk-core": "^0.5.0"
+    "@intellectif/lk-core": "^0.6.0"
   },
   "devDependencies": {
     "@axe-core/react": "^4.10.0",
@@ -134,7 +134,7 @@
     "tsup": "^8.3.0",
     "vitest": "^4.1.6",
     "vitest-axe": "^0.1.0",
-    "@intellectif/lk-core": "0.5.0"
+    "@intellectif/lk-core": "0.6.0"
   },
   "license": "MIT",
   "engines": {

package/dist/chunk-SWZRB3VY.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/WrittenResponse/WrittenResponse.tsx","../src/components/WrittenResponse/index.tsx"],"names":["WrittenResponse","jsx"],"mappings":"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","file":"chunk-SWZRB3VY.js","sourcesContent":["'use client';\n\nimport {\n  ActivitySchemaError,\n  countWords,\n  evaluate,\n  type GradeRecord,\n  type InteractionEvent,\n  type ItemOutcome,\n  type LearnerResponse,\n  type ThemeTokens,\n  validateActivity,\n  type WrittenResponseData,\n  type XAPIStatement,\n  xAPIBuilder,\n} from '@intellectif/lk-core';\nimport { type CSSProperties, useEffect, useMemo, useRef, useState } from 'react';\nimport { useActivityState } from '../../hooks/useActivityState.js';\nimport { ANONYMOUS_ACTOR, isDevelopment, objectIdFor } from '../_internal.js';\nimport { ActivityMedia } from '../shared/ActivityMedia.js';\nimport { FeedbackRegion } from '../shared/FeedbackRegion.js';\nimport type { HtmlSanitizer, Renderable, RenderMode } from '../types.js';\n\n/**\n * Payload delivered when the learner submits a written response. Grading is\n * DEFERRED (asynchronous AI/human grading), so there is no score here — and\n * deliberately no fake one: an ungraded submission must never be shown or\n * stored as a 0. The consumer persists `text` and grades it out-of-band.\n */\nexport interface WrittenResponseSubmission {\n  /** The submitted text, verbatim. */\n  text: string;\n  /** Word count of `text`, recomputed with the canonical `countWords()`. */\n  wordCount: number;\n  /** Whether `wordCount` falls within the activity's `[minWords, maxWords]`. */\n  withinWordBounds: boolean;\n  /** Time in milliseconds from first interaction to submission. */\n  timeSpent: number;\n  /** The SUBMITTED-verb xAPI statement built for this submission (no score fields). */\n  xapiStatement: XAPIStatement;\n}\n\n/**\n * Props for {@link WrittenResponse}. Mirrors `ActivityProps` except for the\n * completion callback: a deferred-grading activity completes with a\n * {@link WrittenResponseSubmission} (`onSubmitted`), not a scored\n * `ActivityResult` (`onComplete`) — deviation from Req 22.8 recorded in the\n * roadmap (§3.1): fabricating a score of 0 for ungraded work is the exact\n * bug this type exists to fix. Everything else — controlled value, render\n * mode, server outcome, rich text — follows the shared `ActivityProps`\n * contract verbatim.\n */\nexport interface WrittenResponseProps {\n  /** Activity content. Accepts a `redact()` projection in `exam` mode. */\n  data: Renderable<WrittenResponseData>;\n  /**\n   * Called on submit with the ungraded submission (text, recomputed word\n   * count, bounds flag, timing, xAPI statement). Fires in `practice` and\n   * `exam` mode, after `onSubmit`; never in `review`.\n   *\n   * Optional since v0.4 so a `review`-mode render (which has no submit\n   * control) and an exam runner that only wants the raw response through\n   * `onSubmit` do not have to pass a no-op. Supply it in `practice`/`exam`\n   * unless `onSubmit` already captures everything you persist.\n   */\n  onSubmitted?: (submission: WrittenResponseSubmission) => void;\n  /**\n   * Called on submit with the raw learner response and no grade, BEFORE\n   * `onSubmitted`. This is the only submit callback an exam runner needs:\n   * the server grades the text and returns an {@link ItemOutcome} later.\n   */\n  onSubmit?: (response: LearnerResponse) => void;\n  /**\n   * Controlled value: the learner's current response. When present the\n   * textarea renders from it (never from internal state) and every keystroke\n   * goes out through `onChange` — restore an in-progress attempt, autosave a\n   * delta, or drive a review render with it.\n   */\n  value?: LearnerResponse;\n  /** Initial response for an uncontrolled component (ignored when `value` is set). */\n  defaultValue?: LearnerResponse;\n  /** Fires on every change to the learner's response. Required for a controlled component. */\n  onChange?: (response: LearnerResponse) => void;\n  /**\n   * Presentation mode, default `practice`. `practice` and `exam` are nearly\n   * identical here — a written response is never graded client-side, so\n   * there is no local score to withhold; `exam` additionally never calls\n   * `evaluate()` and renders happily from a `redact()` projection.\n   * `review` is read-only and shows the server's `outcome`.\n   */\n  renderMode?: RenderMode;\n  /**\n   * Server-computed outcome, rendered by `review` mode: `deferred` shows a\n   * \"not graded yet\" affordance, `scored` shows the returned grade and\n   * feedback. Ignored in other modes — this component never manufactures an\n   * outcome of its own.\n   */\n  outcome?: ItemOutcome;\n  /** Renders `data.promptHtml` when provided. See `HtmlSanitizer`. */\n  sanitizeHtml?: HtmlSanitizer;\n  onInteraction?: (event: InteractionEvent) => void;\n  /** Per-instance token overrides, applied as inline CSS vars on the root. */\n  theme?: Partial<ThemeTokens>;\n  locale?: string;\n  disabled?: boolean;\n}\n\n/**\n * Reads the text out of a learner response. Another activity type's response\n * shape (the `value`/`defaultValue` props take the `LearnerResponse` union,\n * so a generic runner can hand any of them over) reads as empty rather than\n * throwing mid-exam.\n */\nfunction textOf(response: LearnerResponse | undefined): string {\n  return response !== undefined && response.type === 'written-response' ? response.text : '';\n}\n\n/**\n * Renders the server-computed outcome in `review` mode. The grade shown here\n * always came back from the asynchronous grader — nothing on this path scores,\n * infers, or defaults a grade. A `written-response` outcome carries no\n * per-item `details` (there are no options or blanks to mark), so the render\n * is the scaled score, the pass state, and the grader's feedback.\n */\nfunction GradeBody({ grade }: { grade: GradeRecord }) {\n  return (\n    <>\n      {grade.feedback ? <p className=\"lk-wr-grade-feedback\">{grade.feedback}</p> : null}\n      {grade.criteria && grade.criteria.length > 0 ? (\n        <ul className=\"lk-wr-criteria\">\n          {grade.criteria.map((criterion) => (\n            <li\n              className=\"lk-wr-criterion\"\n              key={criterion.name}\n              data-na={String(criterion.notApplicable === true)}\n            >\n              <span className=\"lk-wr-criterion-name\">{criterion.name}</span>\n              {criterion.notApplicable === true ? (\n                <span className=\"lk-wr-criterion-score\">Not applicable</span>\n              ) : (\n                <span className=\"lk-wr-criterion-score\">\n                  {criterion.band ??\n                    (typeof criterion.score === 'number'\n                      ? `${Math.round(criterion.score * 100)}%`\n                      : '')}\n                </span>\n              )}\n              {criterion.comment ? (\n                <span className=\"lk-wr-criterion-comment\">{criterion.comment}</span>\n              ) : null}\n            </li>\n          ))}\n        </ul>\n      ) : null}\n      {grade.corrections && grade.corrections.length > 0 ? (\n        <ul className=\"lk-wr-corrections\">\n          {grade.corrections.map((correction) => (\n            <li className=\"lk-wr-correction\" key={`${correction.original}:${correction.corrected}`}>\n              <del className=\"lk-wr-correction-original\">{correction.original}</del>{' '}\n              <ins className=\"lk-wr-correction-corrected\">{correction.corrected}</ins>\n              {correction.explanation ? (\n                <span className=\"lk-wr-correction-explanation\">{correction.explanation}</span>\n              ) : null}\n            </li>\n          ))}\n        </ul>\n      ) : null}\n      {grade.requiresHumanReview === true ? (\n        <p className=\"lk-wr-review-flag\">This grade is awaiting review by a teacher.</p>\n      ) : null}\n    </>\n  );\n}\n\n/**\n * Renders the server-computed outcome in `review` mode. The grade shown here\n * always came back from the grader — nothing on this path scores, infers, or\n * defaults a grade.\n */\nfunction OutcomeSummary({ outcome }: { outcome: ItemOutcome }) {\n  if (outcome.status === 'scored' || outcome.status === 'graded') {\n    // `score` is scaled [0–1] against `maxScore`; normalising by `maxScore`\n    // is a no-op for the canonical maxScore of 1 and keeps an unscaled\n    // grader payload (8.5 / 10) from rendering as 850%.\n    const percent =\n      outcome.maxScore > 0\n        ? Math.round((outcome.score / outcome.maxScore) * 100)\n        : Math.round(outcome.score * 100);\n    return (\n      <div\n        className=\"lk-wr-outcome\"\n        data-status={outcome.status}\n        data-passed={String(outcome.passed)}\n      >\n        <p className=\"lk-wr-grade\">\n          Score {percent}%. {outcome.passed ? 'Passed.' : 'Not passed.'}\n        </p>\n        {outcome.status === 'graded' ? (\n          <GradeBody grade={outcome.grade} />\n        ) : outcome.feedback ? (\n          <p className=\"lk-wr-grade-feedback\">{outcome.feedback}</p>\n        ) : null}\n      </div>\n    );\n  }\n  if (outcome.status === 'deferred') {\n    return (\n      <div className=\"lk-wr-outcome\" data-status=\"deferred\">\n        <p className=\"lk-wr-grade\">Not graded yet. This response is waiting for its grade.</p>\n      </div>\n    );\n  }\n  // `unscorable` reasons are developer-facing strings; surface the state, not\n  // the reason, and leave it on the element for diagnostics.\n  return (\n    <div className=\"lk-wr-outcome\" data-status=\"unscorable\" data-reason={outcome.reason}>\n      <p className=\"lk-wr-grade\">This response could not be graded.</p>\n    </div>\n  );\n}\n\nexport function WrittenResponse({\n  data,\n  onSubmitted,\n  onSubmit,\n  value,\n  defaultValue,\n  onChange,\n  renderMode = 'practice',\n  outcome,\n  sanitizeHtml,\n  onInteraction,\n  theme,\n  locale,\n  disabled,\n}: WrittenResponseProps) {\n  // Dev-only boundary validation (Req 2.3), same convention as MC/FIB. The\n  // content schema is loose, so a `redact()` projection validates too.\n  const devError = useMemo(() => {\n    if (!isDevelopment()) {\n      return null;\n    }\n    const result = validateActivity('written-response', data);\n    return result.success ? null : new ActivitySchemaError('written-response', result.errors);\n  }, [data]);\n\n  const { state, start, complete, getTimeSpent, reset } = useActivityState();\n  const isControlled = value !== undefined;\n  const [innerText, setInnerText] = useState<string>(() => textOf(defaultValue));\n  const [summary, setSummary] = useState<string | null>(null);\n\n  /**\n   * Rich text is rendered ONLY through a caller-supplied sanitiser, and only\n   * when the author actually shipped the HTML sidecar. Without both, the\n   * plain-text prompt is rendered as an escaped React child.\n   */\n  const promptHtml = useMemo(() => {\n    if (sanitizeHtml === undefined || typeof data.promptHtml !== 'string') {\n      return null;\n    }\n    return sanitizeHtml(data.promptHtml);\n  }, [data.promptHtml, sanitizeHtml]);\n\n  // Latest seed text, kept in a ref so `defaultValue` is NOT a reset trigger:\n  // callers pass an object literal, whose identity changes every render.\n  const defaultTextRef = useRef<string>(textOf(defaultValue));\n  useEffect(() => {\n    defaultTextRef.current = textOf(defaultValue);\n  }, [defaultValue]);\n\n  // Reset on data-prop change (Req 3.7): back to the seed (empty when there\n  // is none — the v1 behaviour), never the previous activity's draft.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: data is the reset trigger (Req 3.7)\n  useEffect(() => {\n    setInnerText(defaultTextRef.current);\n    setSummary(null);\n    reset();\n  }, [data, reset]);\n\n  if (devError) {\n    throw devError;\n  }\n\n  const isExam = renderMode === 'exam';\n  const isReview = renderMode === 'review';\n\n  const text = isControlled ? textOf(value) : innerText;\n  const submitted = state === 'completed';\n  const inactive = disabled === true || submitted || isReview;\n  const wordCount = countWords(text);\n  const withinBounds = wordCount >= data.minWords && wordCount <= data.maxWords;\n\n  const handleChange = (next: string): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    // A controlled component renders from `props.value` only; the caller's\n    // state is the single source of truth for the text.\n    if (!isControlled) {\n      setInnerText(next);\n    }\n    const nextWordCount = countWords(next);\n    onChange?.({ type: 'written-response', text: next, wordCount: nextWordCount });\n    onInteraction?.({\n      type: 'text-changed',\n      activityId: data.id,\n      timestamp: Date.now(),\n      payload: { wordCount: nextWordCount },\n    });\n  };\n\n  const handleSubmit = (event: React.FormEvent): void => {\n    event.preventDefault();\n    if (inactive || text.trim().length === 0) {\n      return;\n    }\n    let finalWordCount = wordCount;\n    let finalWithinBounds = withinBounds;\n    // `exam` mode must not call evaluate(): the component does not grade, and\n    // a redacted projection carries no scoring input anyway. The two facts\n    // evaluate() returns for a deferred type (recomputed word count, bounds)\n    // are exactly what is computed above, so the payload is identical either\n    // way; practice keeps going through core so the numbers stay canonical.\n    if (!isExam) {\n      const itemOutcome = evaluate(data, { type: 'written-response', text, wordCount });\n      const partial = itemOutcome.status === 'deferred' ? itemOutcome.partial : undefined;\n      if (typeof partial?.wordCount === 'number') {\n        finalWordCount = partial.wordCount;\n      }\n      if (typeof partial?.withinWordBounds === 'boolean') {\n        finalWithinBounds = partial.withinWordBounds;\n      }\n    }\n    complete();\n    const timeSpent = getTimeSpent();\n    const xapiStatement = xAPIBuilder.buildSubmittedStatement({\n      actor: ANONYMOUS_ACTOR,\n      object: {\n        id: objectIdFor(data.id),\n        name: { [data.locale ?? 'en-US']: data.title },\n        type: 'http://adlnet.gov/expapi/activities/cmi.interaction',\n        interactionType: 'long-fill-in',\n      },\n      timeSpentMs: timeSpent,\n      response: text,\n      resultExtensions: {\n        'urn:learning-kit:extension:word-count': finalWordCount,\n        'urn:learning-kit:extension:within-word-bounds': finalWithinBounds,\n      },\n    });\n    // Raw response first (an exam runner persists this), then the fuller\n    // ungraded submission — mirroring `onSubmit` before `onComplete`.\n    onSubmit?.({ type: 'written-response', text, wordCount: finalWordCount });\n    onSubmitted?.({\n      text,\n      wordCount: finalWordCount,\n      withinWordBounds: finalWithinBounds,\n      timeSpent,\n      xapiStatement,\n    });\n    setSummary('Response submitted. It will be graded and your result will appear here later.');\n    onInteraction?.({\n      type: 'submitted',\n      activityId: data.id,\n      timestamp: Date.now(),\n      payload: { wordCount: finalWordCount, withinWordBounds: finalWithinBounds },\n    });\n  };\n\n  const promptId = `${data.id}-prompt`;\n  const counterId = `${data.id}-counter`;\n  const boundsLabel =\n    data.minWords > 0 ? `${data.minWords}–${data.maxWords} words` : `up to ${data.maxWords} words`;\n\n  return (\n    <form\n      className=\"lk-wr\"\n      aria-label={data.title}\n      lang={locale}\n      data-render-mode={renderMode}\n      style={theme as CSSProperties | undefined}\n      onSubmit={handleSubmit}\n    >\n      {data.media ? <ActivityMedia media={data.media} /> : null}\n      {promptHtml === null ? (\n        <p className=\"lk-wr-prompt\" id={promptId}>\n          {data.prompt}\n        </p>\n      ) : (\n        // A div, not a p: sanitised author HTML may contain block content.\n        <div\n          className=\"lk-wr-prompt\"\n          id={promptId}\n          // biome-ignore lint/security/noDangerouslySetInnerHtml: rendered only through the caller-supplied HtmlSanitizer — the SDK never injects unsanitised markup\n          dangerouslySetInnerHTML={{ __html: promptHtml }}\n        />\n      )}\n      <textarea\n        className=\"lk-wr-textarea\"\n        aria-labelledby={promptId}\n        aria-describedby={counterId}\n        value={text}\n        onChange={(event) => handleChange(event.target.value)}\n        // `review` uses readOnly rather than disabled: the submitted essay\n        // must stay focusable, selectable and scrollable for a screen reader\n        // and a keyboard, while remaining uneditable.\n        disabled={!isReview && inactive}\n        readOnly={isReview}\n        rows={8}\n      />\n      <div\n        className=\"lk-wr-counter\"\n        id={counterId}\n        aria-live=\"polite\"\n        data-within-bounds={withinBounds}\n      >\n        {wordCount} {wordCount === 1 ? 'word' : 'words'} ({boundsLabel})\n      </div>\n      {isReview ? null : (\n        <button\n          type=\"submit\"\n          className=\"lk-wr-submit\"\n          disabled={inactive || text.trim().length === 0}\n        >\n          Submit\n        </button>\n      )}\n      <FeedbackRegion id={`${data.id}-feedback`}>\n        {isReview ? outcome ? <OutcomeSummary outcome={outcome} /> : null : summary}\n      </FeedbackRegion>\n    </form>\n  );\n}\n","'use client';\n\nimport { ActivityErrorBoundary } from '../ActivityErrorBoundary.js';\nimport {\n  WrittenResponse as WrittenResponseCore,\n  type WrittenResponseProps,\n} from './WrittenResponse.js';\n\nexport type { HtmlSanitizer, Renderable, RenderMode } from '../types.js';\nexport type { WrittenResponseProps, WrittenResponseSubmission } from './WrittenResponse.js';\n\n/**\n * Public Written Response activity: a labelled textarea with a live word\n * counter for free-text writing graded asynchronously (AI or human). The core\n * is wrapped in `ActivityErrorBoundary` so a render failure (incl. the dev\n * schema-validation throw) degrades to an accessible fallback.\n */\nexport function WrittenResponse(props: WrittenResponseProps) {\n  return (\n    <ActivityErrorBoundary activityTitle={props.data?.title}>\n      <WrittenResponseCore {...props} />\n    </ActivityErrorBoundary>\n  );\n}\n"]}

package/dist/chunk-XQJFLAMD.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/WrittenResponse/WrittenResponse.tsx","../src/components/WrittenResponse/index.tsx"],"names":["jsxs","Fragment","jsx","useMemo","isDevelopment","validateActivity","ActivitySchemaError","useActivityState","useState","useRef","useEffect","countWords","evaluate","xAPIBuilder","ANONYMOUS_ACTOR","objectIdFor","ActivityMedia","FeedbackRegion","WrittenResponse","ActivityErrorBoundary"],"mappings":"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","file":"chunk-XQJFLAMD.cjs","sourcesContent":["'use client';\n\nimport {\n  ActivitySchemaError,\n  countWords,\n  evaluate,\n  type GradeRecord,\n  type InteractionEvent,\n  type ItemOutcome,\n  type LearnerResponse,\n  type ThemeTokens,\n  validateActivity,\n  type WrittenResponseData,\n  type XAPIStatement,\n  xAPIBuilder,\n} from '@intellectif/lk-core';\nimport { type CSSProperties, useEffect, useMemo, useRef, useState } from 'react';\nimport { useActivityState } from '../../hooks/useActivityState.js';\nimport { ANONYMOUS_ACTOR, isDevelopment, objectIdFor } from '../_internal.js';\nimport { ActivityMedia } from '../shared/ActivityMedia.js';\nimport { FeedbackRegion } from '../shared/FeedbackRegion.js';\nimport type { HtmlSanitizer, Renderable, RenderMode } from '../types.js';\n\n/**\n * Payload delivered when the learner submits a written response. Grading is\n * DEFERRED (asynchronous AI/human grading), so there is no score here — and\n * deliberately no fake one: an ungraded submission must never be shown or\n * stored as a 0. The consumer persists `text` and grades it out-of-band.\n */\nexport interface WrittenResponseSubmission {\n  /** The submitted text, verbatim. */\n  text: string;\n  /** Word count of `text`, recomputed with the canonical `countWords()`. */\n  wordCount: number;\n  /** Whether `wordCount` falls within the activity's `[minWords, maxWords]`. */\n  withinWordBounds: boolean;\n  /** Time in milliseconds from first interaction to submission. */\n  timeSpent: number;\n  /** The SUBMITTED-verb xAPI statement built for this submission (no score fields). */\n  xapiStatement: XAPIStatement;\n}\n\n/**\n * Props for {@link WrittenResponse}. Mirrors `ActivityProps` except for the\n * completion callback: a deferred-grading activity completes with a\n * {@link WrittenResponseSubmission} (`onSubmitted`), not a scored\n * `ActivityResult` (`onComplete`) — deviation from Req 22.8 recorded in the\n * roadmap (§3.1): fabricating a score of 0 for ungraded work is the exact\n * bug this type exists to fix. Everything else — controlled value, render\n * mode, server outcome, rich text — follows the shared `ActivityProps`\n * contract verbatim.\n */\nexport interface WrittenResponseProps {\n  /** Activity content. Accepts a `redact()` projection in `exam` mode. */\n  data: Renderable<WrittenResponseData>;\n  /**\n   * Called on submit with the ungraded submission (text, recomputed word\n   * count, bounds flag, timing, xAPI statement). Fires in `practice` and\n   * `exam` mode, after `onSubmit`; never in `review`.\n   *\n   * Optional since v0.4 so a `review`-mode render (which has no submit\n   * control) and an exam runner that only wants the raw response through\n   * `onSubmit` do not have to pass a no-op. Supply it in `practice`/`exam`\n   * unless `onSubmit` already captures everything you persist.\n   */\n  onSubmitted?: (submission: WrittenResponseSubmission) => void;\n  /**\n   * Called on submit with the raw learner response and no grade, BEFORE\n   * `onSubmitted`. This is the only submit callback an exam runner needs:\n   * the server grades the text and returns an {@link ItemOutcome} later.\n   */\n  onSubmit?: (response: LearnerResponse) => void;\n  /**\n   * Controlled value: the learner's current response. When present the\n   * textarea renders from it (never from internal state) and every keystroke\n   * goes out through `onChange` — restore an in-progress attempt, autosave a\n   * delta, or drive a review render with it.\n   */\n  value?: LearnerResponse;\n  /** Initial response for an uncontrolled component (ignored when `value` is set). */\n  defaultValue?: LearnerResponse;\n  /** Fires on every change to the learner's response. Required for a controlled component. */\n  onChange?: (response: LearnerResponse) => void;\n  /**\n   * Presentation mode, default `practice`. `practice` and `exam` are nearly\n   * identical here — a written response is never graded client-side, so\n   * there is no local score to withhold; `exam` additionally never calls\n   * `evaluate()` and renders happily from a `redact()` projection.\n   * `review` is read-only and shows the server's `outcome`.\n   */\n  renderMode?: RenderMode;\n  /**\n   * Server-computed outcome, rendered by `review` mode: `deferred` shows a\n   * \"not graded yet\" affordance, `scored` shows the returned grade and\n   * feedback. Ignored in other modes — this component never manufactures an\n   * outcome of its own.\n   */\n  outcome?: ItemOutcome;\n  /** Renders `data.promptHtml` when provided. See `HtmlSanitizer`. */\n  sanitizeHtml?: HtmlSanitizer;\n  onInteraction?: (event: InteractionEvent) => void;\n  /** Per-instance token overrides, applied as inline CSS vars on the root. */\n  theme?: Partial<ThemeTokens>;\n  locale?: string;\n  disabled?: boolean;\n}\n\n/**\n * Reads the text out of a learner response. Another activity type's response\n * shape (the `value`/`defaultValue` props take the `LearnerResponse` union,\n * so a generic runner can hand any of them over) reads as empty rather than\n * throwing mid-exam.\n */\nfunction textOf(response: LearnerResponse | undefined): string {\n  return response !== undefined && response.type === 'written-response' ? response.text : '';\n}\n\n/**\n * Renders the server-computed outcome in `review` mode. The grade shown here\n * always came back from the asynchronous grader — nothing on this path scores,\n * infers, or defaults a grade. A `written-response` outcome carries no\n * per-item `details` (there are no options or blanks to mark), so the render\n * is the scaled score, the pass state, and the grader's feedback.\n */\nfunction GradeBody({ grade }: { grade: GradeRecord }) {\n  return (\n    <>\n      {grade.feedback ? <p className=\"lk-wr-grade-feedback\">{grade.feedback}</p> : null}\n      {grade.criteria && grade.criteria.length > 0 ? (\n        <ul className=\"lk-wr-criteria\">\n          {grade.criteria.map((criterion) => (\n            <li\n              className=\"lk-wr-criterion\"\n              key={criterion.name}\n              data-na={String(criterion.notApplicable === true)}\n            >\n              <span className=\"lk-wr-criterion-name\">{criterion.name}</span>\n              {criterion.notApplicable === true ? (\n                <span className=\"lk-wr-criterion-score\">Not applicable</span>\n              ) : (\n                <span className=\"lk-wr-criterion-score\">\n                  {criterion.band ??\n                    (typeof criterion.score === 'number'\n                      ? `${Math.round(criterion.score * 100)}%`\n                      : '')}\n                </span>\n              )}\n              {criterion.comment ? (\n                <span className=\"lk-wr-criterion-comment\">{criterion.comment}</span>\n              ) : null}\n            </li>\n          ))}\n        </ul>\n      ) : null}\n      {grade.corrections && grade.corrections.length > 0 ? (\n        <ul className=\"lk-wr-corrections\">\n          {grade.corrections.map((correction) => (\n            <li className=\"lk-wr-correction\" key={`${correction.original}:${correction.corrected}`}>\n              <del className=\"lk-wr-correction-original\">{correction.original}</del>{' '}\n              <ins className=\"lk-wr-correction-corrected\">{correction.corrected}</ins>\n              {correction.explanation ? (\n                <span className=\"lk-wr-correction-explanation\">{correction.explanation}</span>\n              ) : null}\n            </li>\n          ))}\n        </ul>\n      ) : null}\n      {grade.requiresHumanReview === true ? (\n        <p className=\"lk-wr-review-flag\">This grade is awaiting review by a teacher.</p>\n      ) : null}\n    </>\n  );\n}\n\n/**\n * Renders the server-computed outcome in `review` mode. The grade shown here\n * always came back from the grader — nothing on this path scores, infers, or\n * defaults a grade.\n */\nfunction OutcomeSummary({ outcome }: { outcome: ItemOutcome }) {\n  if (outcome.status === 'scored' || outcome.status === 'graded') {\n    // `score` is scaled [0–1] against `maxScore`; normalising by `maxScore`\n    // is a no-op for the canonical maxScore of 1 and keeps an unscaled\n    // grader payload (8.5 / 10) from rendering as 850%.\n    const percent =\n      outcome.maxScore > 0\n        ? Math.round((outcome.score / outcome.maxScore) * 100)\n        : Math.round(outcome.score * 100);\n    return (\n      <div\n        className=\"lk-wr-outcome\"\n        data-status={outcome.status}\n        data-passed={String(outcome.passed)}\n      >\n        <p className=\"lk-wr-grade\">\n          Score {percent}%. {outcome.passed ? 'Passed.' : 'Not passed.'}\n        </p>\n        {outcome.status === 'graded' ? (\n          <GradeBody grade={outcome.grade} />\n        ) : outcome.feedback ? (\n          <p className=\"lk-wr-grade-feedback\">{outcome.feedback}</p>\n        ) : null}\n      </div>\n    );\n  }\n  if (outcome.status === 'deferred') {\n    return (\n      <div className=\"lk-wr-outcome\" data-status=\"deferred\">\n        <p className=\"lk-wr-grade\">Not graded yet. This response is waiting for its grade.</p>\n      </div>\n    );\n  }\n  // `unscorable` reasons are developer-facing strings; surface the state, not\n  // the reason, and leave it on the element for diagnostics.\n  return (\n    <div className=\"lk-wr-outcome\" data-status=\"unscorable\" data-reason={outcome.reason}>\n      <p className=\"lk-wr-grade\">This response could not be graded.</p>\n    </div>\n  );\n}\n\nexport function WrittenResponse({\n  data,\n  onSubmitted,\n  onSubmit,\n  value,\n  defaultValue,\n  onChange,\n  renderMode = 'practice',\n  outcome,\n  sanitizeHtml,\n  onInteraction,\n  theme,\n  locale,\n  disabled,\n}: WrittenResponseProps) {\n  // Dev-only boundary validation (Req 2.3), same convention as MC/FIB. The\n  // content schema is loose, so a `redact()` projection validates too.\n  const devError = useMemo(() => {\n    if (!isDevelopment()) {\n      return null;\n    }\n    const result = validateActivity('written-response', data);\n    return result.success ? null : new ActivitySchemaError('written-response', result.errors);\n  }, [data]);\n\n  const { state, start, complete, getTimeSpent, reset } = useActivityState();\n  const isControlled = value !== undefined;\n  const [innerText, setInnerText] = useState<string>(() => textOf(defaultValue));\n  const [summary, setSummary] = useState<string | null>(null);\n\n  /**\n   * Rich text is rendered ONLY through a caller-supplied sanitiser, and only\n   * when the author actually shipped the HTML sidecar. Without both, the\n   * plain-text prompt is rendered as an escaped React child.\n   */\n  const promptHtml = useMemo(() => {\n    if (sanitizeHtml === undefined || typeof data.promptHtml !== 'string') {\n      return null;\n    }\n    return sanitizeHtml(data.promptHtml);\n  }, [data.promptHtml, sanitizeHtml]);\n\n  // Latest seed text, kept in a ref so `defaultValue` is NOT a reset trigger:\n  // callers pass an object literal, whose identity changes every render.\n  const defaultTextRef = useRef<string>(textOf(defaultValue));\n  useEffect(() => {\n    defaultTextRef.current = textOf(defaultValue);\n  }, [defaultValue]);\n\n  // Reset on data-prop change (Req 3.7): back to the seed (empty when there\n  // is none — the v1 behaviour), never the previous activity's draft.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: data is the reset trigger (Req 3.7)\n  useEffect(() => {\n    setInnerText(defaultTextRef.current);\n    setSummary(null);\n    reset();\n  }, [data, reset]);\n\n  if (devError) {\n    throw devError;\n  }\n\n  const isExam = renderMode === 'exam';\n  const isReview = renderMode === 'review';\n\n  const text = isControlled ? textOf(value) : innerText;\n  const submitted = state === 'completed';\n  const inactive = disabled === true || submitted || isReview;\n  const wordCount = countWords(text);\n  const withinBounds = wordCount >= data.minWords && wordCount <= data.maxWords;\n\n  const handleChange = (next: string): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    // A controlled component renders from `props.value` only; the caller's\n    // state is the single source of truth for the text.\n    if (!isControlled) {\n      setInnerText(next);\n    }\n    const nextWordCount = countWords(next);\n    onChange?.({ type: 'written-response', text: next, wordCount: nextWordCount });\n    onInteraction?.({\n      type: 'text-changed',\n      activityId: data.id,\n      timestamp: Date.now(),\n      payload: { wordCount: nextWordCount },\n    });\n  };\n\n  const handleSubmit = (event: React.FormEvent): void => {\n    event.preventDefault();\n    if (inactive || text.trim().length === 0) {\n      return;\n    }\n    let finalWordCount = wordCount;\n    let finalWithinBounds = withinBounds;\n    // `exam` mode must not call evaluate(): the component does not grade, and\n    // a redacted projection carries no scoring input anyway. The two facts\n    // evaluate() returns for a deferred type (recomputed word count, bounds)\n    // are exactly what is computed above, so the payload is identical either\n    // way; practice keeps going through core so the numbers stay canonical.\n    if (!isExam) {\n      const itemOutcome = evaluate(data, { type: 'written-response', text, wordCount });\n      const partial = itemOutcome.status === 'deferred' ? itemOutcome.partial : undefined;\n      if (typeof partial?.wordCount === 'number') {\n        finalWordCount = partial.wordCount;\n      }\n      if (typeof partial?.withinWordBounds === 'boolean') {\n        finalWithinBounds = partial.withinWordBounds;\n      }\n    }\n    complete();\n    const timeSpent = getTimeSpent();\n    const xapiStatement = xAPIBuilder.buildSubmittedStatement({\n      actor: ANONYMOUS_ACTOR,\n      object: {\n        id: objectIdFor(data.id),\n        name: { [data.locale ?? 'en-US']: data.title },\n        type: 'http://adlnet.gov/expapi/activities/cmi.interaction',\n        interactionType: 'long-fill-in',\n      },\n      timeSpentMs: timeSpent,\n      response: text,\n      resultExtensions: {\n        'urn:learning-kit:extension:word-count': finalWordCount,\n        'urn:learning-kit:extension:within-word-bounds': finalWithinBounds,\n      },\n    });\n    // Raw response first (an exam runner persists this), then the fuller\n    // ungraded submission — mirroring `onSubmit` before `onComplete`.\n    onSubmit?.({ type: 'written-response', text, wordCount: finalWordCount });\n    onSubmitted?.({\n      text,\n      wordCount: finalWordCount,\n      withinWordBounds: finalWithinBounds,\n      timeSpent,\n      xapiStatement,\n    });\n    setSummary('Response submitted. It will be graded and your result will appear here later.');\n    onInteraction?.({\n      type: 'submitted',\n      activityId: data.id,\n      timestamp: Date.now(),\n      payload: { wordCount: finalWordCount, withinWordBounds: finalWithinBounds },\n    });\n  };\n\n  const promptId = `${data.id}-prompt`;\n  const counterId = `${data.id}-counter`;\n  const boundsLabel =\n    data.minWords > 0 ? `${data.minWords}–${data.maxWords} words` : `up to ${data.maxWords} words`;\n\n  return (\n    <form\n      className=\"lk-wr\"\n      aria-label={data.title}\n      lang={locale}\n      data-render-mode={renderMode}\n      style={theme as CSSProperties | undefined}\n      onSubmit={handleSubmit}\n    >\n      {data.media ? <ActivityMedia media={data.media} /> : null}\n      {promptHtml === null ? (\n        <p className=\"lk-wr-prompt\" id={promptId}>\n          {data.prompt}\n        </p>\n      ) : (\n        // A div, not a p: sanitised author HTML may contain block content.\n        <div\n          className=\"lk-wr-prompt\"\n          id={promptId}\n          // biome-ignore lint/security/noDangerouslySetInnerHtml: rendered only through the caller-supplied HtmlSanitizer — the SDK never injects unsanitised markup\n          dangerouslySetInnerHTML={{ __html: promptHtml }}\n        />\n      )}\n      <textarea\n        className=\"lk-wr-textarea\"\n        aria-labelledby={promptId}\n        aria-describedby={counterId}\n        value={text}\n        onChange={(event) => handleChange(event.target.value)}\n        // `review` uses readOnly rather than disabled: the submitted essay\n        // must stay focusable, selectable and scrollable for a screen reader\n        // and a keyboard, while remaining uneditable.\n        disabled={!isReview && inactive}\n        readOnly={isReview}\n        rows={8}\n      />\n      <div\n        className=\"lk-wr-counter\"\n        id={counterId}\n        aria-live=\"polite\"\n        data-within-bounds={withinBounds}\n      >\n        {wordCount} {wordCount === 1 ? 'word' : 'words'} ({boundsLabel})\n      </div>\n      {isReview ? null : (\n        <button\n          type=\"submit\"\n          className=\"lk-wr-submit\"\n          disabled={inactive || text.trim().length === 0}\n        >\n          Submit\n        </button>\n      )}\n      <FeedbackRegion id={`${data.id}-feedback`}>\n        {isReview ? outcome ? <OutcomeSummary outcome={outcome} /> : null : summary}\n      </FeedbackRegion>\n    </form>\n  );\n}\n","'use client';\n\nimport { ActivityErrorBoundary } from '../ActivityErrorBoundary.js';\nimport {\n  WrittenResponse as WrittenResponseCore,\n  type WrittenResponseProps,\n} from './WrittenResponse.js';\n\nexport type { HtmlSanitizer, Renderable, RenderMode } from '../types.js';\nexport type { WrittenResponseProps, WrittenResponseSubmission } from './WrittenResponse.js';\n\n/**\n * Public Written Response activity: a labelled textarea with a live word\n * counter for free-text writing graded asynchronously (AI or human). The core\n * is wrapped in `ActivityErrorBoundary` so a render failure (incl. the dev\n * schema-validation throw) degrades to an accessible fallback.\n */\nexport function WrittenResponse(props: WrittenResponseProps) {\n  return (\n    <ActivityErrorBoundary activityTitle={props.data?.title}>\n      <WrittenResponseCore {...props} />\n    </ActivityErrorBoundary>\n  );\n}\n"]}