@intellectif/lk-react 2.0.0 → 3.0.0

package/dist/chunk-ZVFWJTT4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/MultipleChoice/MultipleChoice.tsx","../src/components/MultipleChoice/index.tsx"],"names":["MultipleChoice","jsx"],"mappings":"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","file":"chunk-ZVFWJTT4.js","sourcesContent":["'use client';\n\nimport {\n  ActivitySchemaError,\n  type ItemOutcome,\n  type LearnerResponse,\n  type MultipleChoiceData,\n  type MultipleChoiceLearnerResponse,\n  type MultipleChoiceOption,\n  type ScoringDetail,\n  score,\n  validateActivity,\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, randomSessionId } from '../_internal.js';\nimport { ActivityMedia } from '../shared/ActivityMedia.js';\nimport { FeedbackRegion } from '../shared/FeedbackRegion.js';\nimport type { ActivityProps } from '../types.js';\n\n/** FNV-1a hash → 32-bit seed. */\nfunction hashSeed(input: string): number {\n  let h = 2166136261 >>> 0;\n  for (let i = 0; i < input.length; i += 1) {\n    h ^= input.charCodeAt(i);\n    h = Math.imul(h, 16777619) >>> 0;\n  }\n  return h;\n}\n\n/** Deterministic LCG Fisher–Yates; returns a permutation (no loss/dupe). */\nfunction seededShuffle<T>(items: readonly T[], seed: number): T[] {\n  const out = [...items];\n  let s = seed >>> 0 || 1;\n  for (let i = out.length - 1; i > 0; i -= 1) {\n    s = (Math.imul(s, 1664525) + 1013904223) >>> 0;\n    const j = s % (i + 1);\n    [out[i], out[j]] = [out[j] as T, out[i] as T];\n  }\n  return out;\n}\n\n/**\n * Selected option ids carried by a learner response. Any other response shape\n * (a caller wiring the wrong item's state through `value`) reads as \"nothing\n * selected\" rather than throwing mid-exam.\n */\nfunction selectionOf(response: LearnerResponse | undefined): string[] {\n  return response?.type === 'multiple-choice' ? response.selectedOptionIds : [];\n}\n\n/**\n * Whether an option is part of the correct answer, derived from the SERVER's\n * outcome — review mode never holds an answer key of its own.\n * {@link ScoringDetail.outcome} states this unambiguously. For 0.2-era details\n * that carry only the deprecated `correct` flag (which means \"the learner\n * ACTED correctly on this option\", not \"this option is the answer\") the fact\n * is still recoverable, because we know whether the learner selected it:\n * `isCorrect = wasSelected ? correct : !correct`.\n */\nfunction isAnswerOption(detail: ScoringDetail, wasSelected: boolean): boolean {\n  switch (detail.outcome) {\n    case 'correct':\n    case 'incorrect-omission':\n      return true;\n    case 'incorrect':\n    case 'correct-omission':\n      return false;\n    default:\n      return wasSelected ? detail.correct : !detail.correct;\n  }\n}\n\n/** Announcement for `review` mode, built only from the server-supplied outcome. */\nfunction reviewAnnouncement(outcome: ItemOutcome | undefined): string | null {\n  if (outcome === undefined) {\n    return null;\n  }\n  if (outcome.status === 'scored') {\n    const overall = outcome.feedback;\n    return `Score ${Math.round(outcome.score * 100)}%. ${\n      outcome.passed ? 'Passed.' : 'Not passed.'\n    }${overall ? ` ${overall}` : ''}`;\n  }\n  if (outcome.status === 'deferred') {\n    // Never \"0%\": ungraded is not the same as wrong.\n    return 'Not graded yet.';\n  }\n  return null;\n}\n\nexport interface MultipleChoiceProps extends ActivityProps<MultipleChoiceData> {\n  /**\n   * Seed for the deterministic option shuffle. Supply one (e.g. the attempt\n   * id) to make the shuffled order reproducible server-side, stable across\n   * page reloads, and identical between SSR and hydration. When absent, a\n   * random per-mount session seed is used (order stable within the mount\n   * only — the v1 behaviour).\n   */\n  shuffleSeed?: string;\n}\n\nexport function MultipleChoice({\n  data,\n  onComplete,\n  onSubmit,\n  value,\n  defaultValue,\n  onChange,\n  renderMode = 'practice',\n  outcome,\n  sanitizeHtml,\n  onInteraction,\n  theme,\n  locale,\n  disabled,\n  shuffleSeed,\n}: MultipleChoiceProps) {\n  // Dev-only boundary validation (Req 2.3). Throwing during render lets\n  // ActivityErrorBoundary catch it. Memoised so it only re-runs on data change.\n  const devError = useMemo(() => {\n    if (!isDevelopment()) {\n      return null;\n    }\n    // A `redact()` projection cannot satisfy the full content schema — the\n    // answer key is gone by design — and must not be checked against the\n    // strict redacted schema either, since a `reveal: 'after-submit'`\n    // projection legitimately carries answer-key fields for review renders.\n    if (data.redacted === true) {\n      return null;\n    }\n    const result = validateActivity('multiple-choice', data);\n    return result.success ? null : new ActivitySchemaError('multiple-choice', result.errors);\n  }, [data]);\n\n  // Lazily created only when shuffling without a caller seed: avoids calling\n  // crypto.randomUUID (absent on non-secure http origins) unless needed.\n  const sessionIdRef = useRef<string | null>(null);\n  const { state, start, complete, getTimeSpent, reset } = useActivityState();\n  // Uncontrolled state. `defaultValue` seeds the mount only (React convention);\n  // to re-seed later, remount with a `key` or drive the component with `value`.\n  const [internalSelection, setInternalSelection] = useState<string[]>(() =>\n    selectionOf(defaultValue),\n  );\n  const [summary, setSummary] = useState<string | null>(null);\n\n  // Reset on data-prop CHANGE (Req 3.7). The identity guard makes the mount\n  // run a no-op, which it always was before `defaultValue` existed — without\n  // it this effect would wipe the seed immediately after the first render.\n  // (It also makes the reset StrictMode-safe: a remount with unchanged data\n  // no longer discards the learner's selection.)\n  // Clears to empty rather than back to `defaultValue`: carrying a stale\n  // answer into a different question is the one failure mode a summative\n  // component must never have.\n  const lastDataRef = useRef(data);\n  useEffect(() => {\n    if (lastDataRef.current === data) {\n      return;\n    }\n    lastDataRef.current = data;\n    setInternalSelection([]);\n    setSummary(null);\n    reset();\n  }, [data, reset]);\n\n  const displayedOptions = useMemo<MultipleChoiceOption[]>(() => {\n    if (!data.shuffle) {\n      return [...data.options];\n    }\n    // biome-ignore lint/suspicious/noAssignInExpressions: sanctioned lazy ref initialization\n    const seedSource = shuffleSeed ?? (sessionIdRef.current ??= randomSessionId());\n    return seededShuffle(data.options, hashSeed(`${seedSource}:${data.id}`));\n  }, [data, shuffleSeed]);\n\n  // Per-option correctness for `review`, indexed by option id. Null unless the\n  // caller supplied a SCORED outcome — the only source of truth this mode has.\n  const reviewDetails = useMemo(() => {\n    if (renderMode !== 'review' || outcome === undefined || outcome.status !== 'scored') {\n      return null;\n    }\n    return new Map(outcome.details.map((detail) => [detail.itemId, detail]));\n  }, [renderMode, outcome]);\n\n  // All hooks are called before these throws, so hook order stays stable.\n  if (devError) {\n    throw devError;\n  }\n  // Practice grades locally, which a redacted projection cannot support:\n  // `score()` would throw from the submit handler — where no error boundary\n  // can catch it — AFTER the learner has answered. Fail loudly at render\n  // instead, in production too. Wiring an exam item into the self-grading\n  // mode is precisely the accident `renderMode` exists to prevent.\n  if (data.redacted === true && renderMode === 'practice') {\n    throw new Error(\n      `Multiple Choice \"${data.id}\" received redacted activity data in renderMode \"practice\", ` +\n        'which grades locally and has no answer key to grade against. ' +\n        'Render redacted data with renderMode=\"exam\" (server grades) or \"review\" (pass `outcome`).',\n    );\n  }\n\n  const isSingle = data.mode === 'single';\n  const isExam = renderMode === 'exam';\n  const isReview = renderMode === 'review';\n  const submitted = state === 'completed';\n  const inactive = disabled === true || submitted || isReview;\n  const isControlled = value !== undefined;\n  const selected = isControlled ? selectionOf(value) : internalSelection;\n  /**\n   * Whether correctness and authored feedback may be shown. Practice earns it\n   * by grading locally after submit; review shows what the server already\n   * graded. Exam never reveals anything — not before, not after submit.\n   */\n  const reveal = isReview || (renderMode === 'practice' && submitted);\n\n  const fireInteraction = (\n    type: 'option-selected' | 'option-deselected' | 'submitted',\n    payload: Record<string, unknown>,\n  ): void => {\n    onInteraction?.({ type, activityId: data.id, timestamp: Date.now(), payload });\n  };\n\n  /** Single funnel for every response change: owns state only when uncontrolled. */\n  const emitChange = (selectedOptionIds: string[]): void => {\n    if (!isControlled) {\n      setInternalSelection(selectedOptionIds);\n    }\n    onChange?.({ type: 'multiple-choice', selectedOptionIds });\n  };\n\n  const selectSingle = (optionId: string): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    emitChange([optionId]);\n    fireInteraction('option-selected', { optionId });\n  };\n\n  const toggleMulti = (optionId: string, checked: boolean): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    emitChange(checked ? [...selected, optionId] : selected.filter((id) => id !== optionId));\n    fireInteraction(checked ? 'option-selected' : 'option-deselected', { optionId });\n  };\n\n  const handleSubmit = (event: React.FormEvent): void => {\n    event.preventDefault();\n    if (inactive) {\n      return;\n    }\n    const response: MultipleChoiceLearnerResponse = {\n      type: 'multiple-choice',\n      selectedOptionIds: selected,\n    };\n    // Always first, and before anything that can throw: an exam runner must be\n    // able to persist the raw response no matter what happens after.\n    onSubmit?.(response);\n\n    if (isExam) {\n      // No score(), no answer key read, no onComplete, no xAPI — the server\n      // grades. The announcement deliberately carries no correctness signal.\n      complete();\n      setSummary('Answer submitted.');\n      fireInteraction('submitted', { selectedOptionIds: selected });\n      return;\n    }\n\n    const scoringResult = score('multiple-choice', data as MultipleChoiceData, response);\n    complete();\n    const timeSpent = getTimeSpent();\n    const xapiStatement = xAPIBuilder.buildAnsweredStatement({\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: 'choice',\n        correctResponsesPattern: [\n          data.options\n            .filter((option) => option.isCorrect)\n            .map((option) => option.id)\n            .join('[,]'),\n        ],\n        choices: data.options.map((option) => ({\n          id: option.id,\n          description: { [data.locale ?? 'en-US']: option.text },\n        })),\n      },\n      scoringResult,\n      timeSpentMs: timeSpent,\n      response: selected.join(','),\n    });\n    onComplete?.({\n      score: scoringResult.score,\n      maxScore: scoringResult.maxScore,\n      passed: scoringResult.passed,\n      timeSpent,\n      xapiStatement,\n    });\n    // Core selects the authored overall feedback on `passed` (B3 fix).\n    const overall = scoringResult.feedback;\n    setSummary(\n      `Answer submitted. Score ${Math.round(scoringResult.score * 100)}%. ${\n        scoringResult.passed ? 'Passed.' : 'Not passed.'\n      }${overall ? ` ${overall}` : ''}`,\n    );\n    fireInteraction('submitted', {\n      selectedOptionIds: selected,\n      score: scoringResult.score,\n    });\n  };\n\n  const questionId = `${data.id}-question`;\n  // Rich text renders ONLY through a caller-supplied sanitiser; without one we\n  // fall back to the plain-text field, escaped by React (types.ts HtmlSanitizer).\n  const questionHtml =\n    sanitizeHtml !== undefined && data.questionHtml !== undefined\n      ? sanitizeHtml(data.questionHtml)\n      : null;\n\n  const optionList = displayedOptions.map((option) => {\n    const checked = selected.includes(option.id);\n    // `data-correct` means \"this option is part of the correct answer\".\n    let correctness: string | undefined;\n    if (isReview) {\n      const detail = reviewDetails?.get(option.id);\n      correctness = detail === undefined ? undefined : String(isAnswerOption(detail, checked));\n    } else if (reveal) {\n      correctness = String(option.isCorrect);\n    }\n    return (\n      <label key={option.id} className=\"lk-mc-option\" data-correct={correctness}>\n        <input\n          type={isSingle ? 'radio' : 'checkbox'}\n          name={isSingle ? `${data.id}-options` : undefined}\n          value={option.id}\n          checked={checked}\n          disabled={inactive}\n          aria-disabled={inactive || undefined}\n          onChange={(e) =>\n            isSingle ? selectSingle(option.id) : toggleMulti(option.id, e.target.checked)\n          }\n        />\n        <span>{option.text}</span>\n        {reveal && option.feedback ? (\n          <span className=\"lk-mc-option-feedback\" role=\"note\">\n            {option.feedback}\n          </span>\n        ) : null}\n      </label>\n    );\n  });\n\n  return (\n    <div className=\"lk-mc\" lang={locale} style={theme as CSSProperties | undefined}>\n      {data.media ? <ActivityMedia media={data.media} /> : null}\n      <form onSubmit={handleSubmit}>\n        <fieldset disabled={inactive}>\n          {questionHtml === null ? (\n            <legend id={questionId}>{data.question}</legend>\n          ) : (\n            <legend\n              id={questionId}\n              // biome-ignore lint/security/noDangerouslySetInnerHtml: HTML is the output of the caller-supplied sanitizeHtml (types.ts HtmlSanitizer contract)\n              dangerouslySetInnerHTML={{ __html: questionHtml }}\n            />\n          )}\n          {/*\n            single: an explicit radiogroup is meaningful (fieldset's implicit\n            role is `group`, not `radiogroup`). multi: the fieldset + legend\n            already provide a named group — an explicit role=\"group\" here would\n            be a redundant, duplicate same-named group in the a11y tree, so we\n            use a plain layout div. (Refines the design ARIA sketch.)\n          */}\n          {isSingle ? (\n            <div role=\"radiogroup\" aria-labelledby={questionId}>\n              {optionList}\n            </div>\n          ) : (\n            <div>{optionList}</div>\n          )}\n          {/* review is read-only: there is nothing left to submit. */}\n          {isReview ? null : (\n            <button type=\"submit\" disabled={inactive}>\n              Submit\n            </button>\n          )}\n        </fieldset>\n      </form>\n      <FeedbackRegion id={`${data.id}-feedback`}>\n        {isReview ? reviewAnnouncement(outcome) : summary}\n      </FeedbackRegion>\n    </div>\n  );\n}\n","'use client';\n\nimport { ActivityErrorBoundary } from '../ActivityErrorBoundary.js';\nimport {\n  MultipleChoice as MultipleChoiceCore,\n  type MultipleChoiceProps,\n} from './MultipleChoice.js';\n\nexport type { MultipleChoiceProps } from './MultipleChoice.js';\n\n/**\n * Public Multiple Choice activity: the core component wrapped in\n * `ActivityErrorBoundary` so a render failure (incl. the dev schema-validation\n * throw) degrades to an accessible fallback instead of crashing the host.\n */\nexport function MultipleChoice(props: MultipleChoiceProps) {\n  return (\n    <ActivityErrorBoundary activityTitle={props.data?.title}>\n      <MultipleChoiceCore {...props} />\n    </ActivityErrorBoundary>\n  );\n}\n"]}

package/dist/components/ActivitySequence.cjs

@@ -1,8 +1,9 @@
 'use strict';
 
-var chunkSH7BRP4M_cjs = require('../chunk-SH7BRP4M.cjs');
-require('../chunk-MKH5THDR.cjs');
-require('../chunk-73XCWYKD.cjs');
+var chunkHO3AC3WQ_cjs = require('../chunk-HO3AC3WQ.cjs');
+require('../chunk-W6BH2YMZ.cjs');
+require('../chunk-UXO6KYSZ.cjs');
+require('../chunk-7MW7HGOA.cjs');
 require('../chunk-QHOV2A6M.cjs');
 require('../chunk-HD2AIQRD.cjs');
 
@@ -10,7 +11,7 @@ require('../chunk-HD2AIQRD.cjs');
 
 Object.defineProperty(exports, "ActivitySequence", {
   enumerable: true,
-  get: function () { return chunkSH7BRP4M_cjs.ActivitySequence; }
+  get: function () { return chunkHO3AC3WQ_cjs.ActivitySequence; }
 });
 //# sourceMappingURL=ActivitySequence.cjs.map
 //# sourceMappingURL=ActivitySequence.cjs.map

package/dist/components/ActivitySequence.d.cts

@@ -1,14 +1,62 @@
 import { ActivityData, ActivityResult, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
+import { ComponentType } from 'react';
+import { A as ActivityProps, R as RenderMode } from '../types-CNmjqD6M.cjs';
+import { a as WrittenResponseSubmission } from '../WrittenResponse-B50EjVR0.cjs';
 
+/**
+ * What one finished slot in a sequence produced. Two kinds, because two kinds
+ * of activity exist: those the SDK scores at submit time, and those a grader
+ * scores later. Collapsing them would mean inventing a score for ungraded
+ * work — the exact defect the deferred outcome exists to prevent.
+ */
+type SequenceItemOutcome = {
+    kind: 'scored';
+    index: number;
+    activityId: string;
+    result: ActivityResult;
+} | {
+    kind: 'submitted';
+    index: number;
+    activityId: string;
+    /** Ungraded submission; the grade arrives asynchronously. */
+    submission: WrittenResponseSubmission;
+};
+/**
+ * A component that can render one activity inside a sequence. Register one per
+ * activity `type` to put a consumer-defined type on screen — the React half of
+ * the activity-type registry, matching `registerActivityType` in lk-core.
+ */
+type ActivityRenderer = ComponentType<ActivityProps>;
 interface ActivitySequenceProps {
     /** The ordered set of activities to present, one at a time. */
     activities: ActivityData[];
-    /** Called whenever an individual activity is completed. */
+    /**
+     * Renderers for activity types beyond the built-ins, keyed by `data.type`.
+     * A key matching a built-in overrides it, so a consumer can replace the
+     * bundled renderer without forking the sequencer.
+     */
+    renderers?: Readonly<Record<string, ActivityRenderer>>;
+    /** Called whenever an individual activity is scored at submit time. */
     onActivityComplete?: (result: ActivityResult, index: number) => void;
-    /** Called once every activity in the set has been completed. */
+    /**
+     * Called once every activity has been completed, with the scored results.
+     *
+     * Fires only when EVERY item produced a score. A set containing a
+     * deferred-graded activity (a written response) can never satisfy that, so
+     * use `onFinished` for mixed sets — it is the general completion signal and
+     * reports both kinds of outcome.
+     */
     onComplete?: (results: ActivityResult[]) => void;
+    /**
+     * Called once every activity has been completed, whether it was scored at
+     * submit time or submitted for later grading. Use this for any set that
+     * mixes graded and deferred-graded activities.
+     */
+    onFinished?: (items: SequenceItemOutcome[]) => void;
     /** Forwarded to each activity. */
     onInteraction?: (event: InteractionEvent) => void;
+    /** Forwarded to each activity. `exam` and `review` disable local scoring. */
+    renderMode?: RenderMode;
     theme?: Partial<ThemeTokens>;
     locale?: string;
     disabled?: boolean;
@@ -20,6 +68,6 @@ interface ActivitySequenceProps {
  * scoring. On navigation, focus moves to the question region and the position
  * is announced via an aria-live region.
  */
-declare function ActivitySequence({ activities, onActivityComplete, onComplete, onInteraction, theme, locale, disabled, }: ActivitySequenceProps): React.JSX.Element;
+declare function ActivitySequence({ activities, renderers, onActivityComplete, onComplete, onFinished, onInteraction, renderMode, theme, locale, disabled, }: ActivitySequenceProps): React.JSX.Element;
 
-export { ActivitySequence, type ActivitySequenceProps };
+export { type ActivityRenderer, ActivitySequence, type ActivitySequenceProps, type SequenceItemOutcome };

package/dist/components/ActivitySequence.d.ts

@@ -1,14 +1,62 @@
 import { ActivityData, ActivityResult, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
+import { ComponentType } from 'react';
+import { A as ActivityProps, R as RenderMode } from '../types-CNmjqD6M.js';
+import { a as WrittenResponseSubmission } from '../WrittenResponse-BHhP936i.js';
 
+/**
+ * What one finished slot in a sequence produced. Two kinds, because two kinds
+ * of activity exist: those the SDK scores at submit time, and those a grader
+ * scores later. Collapsing them would mean inventing a score for ungraded
+ * work — the exact defect the deferred outcome exists to prevent.
+ */
+type SequenceItemOutcome = {
+    kind: 'scored';
+    index: number;
+    activityId: string;
+    result: ActivityResult;
+} | {
+    kind: 'submitted';
+    index: number;
+    activityId: string;
+    /** Ungraded submission; the grade arrives asynchronously. */
+    submission: WrittenResponseSubmission;
+};
+/**
+ * A component that can render one activity inside a sequence. Register one per
+ * activity `type` to put a consumer-defined type on screen — the React half of
+ * the activity-type registry, matching `registerActivityType` in lk-core.
+ */
+type ActivityRenderer = ComponentType<ActivityProps>;
 interface ActivitySequenceProps {
     /** The ordered set of activities to present, one at a time. */
     activities: ActivityData[];
-    /** Called whenever an individual activity is completed. */
+    /**
+     * Renderers for activity types beyond the built-ins, keyed by `data.type`.
+     * A key matching a built-in overrides it, so a consumer can replace the
+     * bundled renderer without forking the sequencer.
+     */
+    renderers?: Readonly<Record<string, ActivityRenderer>>;
+    /** Called whenever an individual activity is scored at submit time. */
     onActivityComplete?: (result: ActivityResult, index: number) => void;
-    /** Called once every activity in the set has been completed. */
+    /**
+     * Called once every activity has been completed, with the scored results.
+     *
+     * Fires only when EVERY item produced a score. A set containing a
+     * deferred-graded activity (a written response) can never satisfy that, so
+     * use `onFinished` for mixed sets — it is the general completion signal and
+     * reports both kinds of outcome.
+     */
     onComplete?: (results: ActivityResult[]) => void;
+    /**
+     * Called once every activity has been completed, whether it was scored at
+     * submit time or submitted for later grading. Use this for any set that
+     * mixes graded and deferred-graded activities.
+     */
+    onFinished?: (items: SequenceItemOutcome[]) => void;
     /** Forwarded to each activity. */
     onInteraction?: (event: InteractionEvent) => void;
+    /** Forwarded to each activity. `exam` and `review` disable local scoring. */
+    renderMode?: RenderMode;
     theme?: Partial<ThemeTokens>;
     locale?: string;
     disabled?: boolean;
@@ -20,6 +68,6 @@ interface ActivitySequenceProps {
  * scoring. On navigation, focus moves to the question region and the position
  * is announced via an aria-live region.
  */
-declare function ActivitySequence({ activities, onActivityComplete, onComplete, onInteraction, theme, locale, disabled, }: ActivitySequenceProps): React.JSX.Element;
+declare function ActivitySequence({ activities, renderers, onActivityComplete, onComplete, onFinished, onInteraction, renderMode, theme, locale, disabled, }: ActivitySequenceProps): React.JSX.Element;
 
-export { ActivitySequence, type ActivitySequenceProps };
+export { type ActivityRenderer, ActivitySequence, type ActivitySequenceProps, type SequenceItemOutcome };

package/dist/components/ActivitySequence.js

@@ -1,6 +1,7 @@
-export { ActivitySequence } from '../chunk-OS7MO2OW.js';
-import '../chunk-G5ZEWJRA.js';
-import '../chunk-32WWQOG3.js';
+export { ActivitySequence } from '../chunk-BGWXN44S.js';
+import '../chunk-ZVFWJTT4.js';
+import '../chunk-3X7MYAFT.js';
+import '../chunk-AEQQ7VPF.js';
 import '../chunk-UIGIYYGY.js';
 import '../chunk-5HVUKXF3.js';
 //# sourceMappingURL=ActivitySequence.js.map

package/dist/components/FillInTheBlanks.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk73XCWYKD_cjs = require('../chunk-73XCWYKD.cjs');
+var chunkUXO6KYSZ_cjs = require('../chunk-UXO6KYSZ.cjs');
 require('../chunk-QHOV2A6M.cjs');
 require('../chunk-HD2AIQRD.cjs');
 
@@ -8,7 +8,7 @@ require('../chunk-HD2AIQRD.cjs');
 
 Object.defineProperty(exports, "FillInTheBlanks", {
   enumerable: true,
-  get: function () { return chunk73XCWYKD_cjs.FillInTheBlanks; }
+  get: function () { return chunkUXO6KYSZ_cjs.FillInTheBlanks; }
 });
 //# sourceMappingURL=FillInTheBlanks.cjs.map
 //# sourceMappingURL=FillInTheBlanks.cjs.map

package/dist/components/FillInTheBlanks.d.cts

@@ -1,12 +1,18 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FillInTheBlanksData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../types-iknDq5tf.cjs';
+import { A as ActivityProps } from '../types-CNmjqD6M.cjs';
 
 interface FillInTheBlanksProps extends ActivityProps<FillInTheBlanksData> {
     /**
      * After submission, replace each incorrectly-answered blank with its first
      * accepted answer, styled distinctly (Req 5.7). Component-specific prop: it
      * is presentation, not activity data, and is outside the fixed Req-3.1 set.
+     *
+     * Ignored in `exam` mode — revealing the key is precisely what an exam must
+     * not do, and on a `redact()` projection there is no key to reveal. In
+     * `review` mode it applies only to blanks the supplied `outcome` marks
+     * incorrect, and only when the caller passed data that still carries the key
+     * (e.g. `redact(data, { reveal: 'after-submit' })`).
      */
     showCorrectAnswers?: boolean;
 }

package/dist/components/FillInTheBlanks.d.ts

@@ -1,12 +1,18 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { FillInTheBlanksData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../types-iknDq5tf.js';
+import { A as ActivityProps } from '../types-CNmjqD6M.js';
 
 interface FillInTheBlanksProps extends ActivityProps<FillInTheBlanksData> {
     /**
      * After submission, replace each incorrectly-answered blank with its first
      * accepted answer, styled distinctly (Req 5.7). Component-specific prop: it
      * is presentation, not activity data, and is outside the fixed Req-3.1 set.
+     *
+     * Ignored in `exam` mode — revealing the key is precisely what an exam must
+     * not do, and on a `redact()` projection there is no key to reveal. In
+     * `review` mode it applies only to blanks the supplied `outcome` marks
+     * incorrect, and only when the caller passed data that still carries the key
+     * (e.g. `redact(data, { reveal: 'after-submit' })`).
      */
     showCorrectAnswers?: boolean;
 }

package/dist/components/FillInTheBlanks.js

@@ -1,4 +1,4 @@
-export { FillInTheBlanks } from '../chunk-32WWQOG3.js';
+export { FillInTheBlanks } from '../chunk-3X7MYAFT.js';
 import '../chunk-UIGIYYGY.js';
 import '../chunk-5HVUKXF3.js';
 //# sourceMappingURL=FillInTheBlanks.js.map

package/dist/components/MultipleChoice.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkMKH5THDR_cjs = require('../chunk-MKH5THDR.cjs');
+var chunkW6BH2YMZ_cjs = require('../chunk-W6BH2YMZ.cjs');
 require('../chunk-QHOV2A6M.cjs');
 require('../chunk-HD2AIQRD.cjs');
 
@@ -8,7 +8,7 @@ require('../chunk-HD2AIQRD.cjs');
 
 Object.defineProperty(exports, "MultipleChoice", {
   enumerable: true,
-  get: function () { return chunkMKH5THDR_cjs.MultipleChoice; }
+  get: function () { return chunkW6BH2YMZ_cjs.MultipleChoice; }
 });
 //# sourceMappingURL=MultipleChoice.cjs.map
 //# sourceMappingURL=MultipleChoice.cjs.map

package/dist/components/MultipleChoice.d.cts

@@ -1,12 +1,23 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { MultipleChoiceData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../types-iknDq5tf.cjs';
+import { A as ActivityProps } from '../types-CNmjqD6M.cjs';
+
+interface MultipleChoiceProps extends ActivityProps<MultipleChoiceData> {
+    /**
+     * Seed for the deterministic option shuffle. Supply one (e.g. the attempt
+     * id) to make the shuffled order reproducible server-side, stable across
+     * page reloads, and identical between SSR and hydration. When absent, a
+     * random per-mount session seed is used (order stable within the mount
+     * only — the v1 behaviour).
+     */
+    shuffleSeed?: string;
+}
 
 /**
  * Public Multiple Choice activity: the core component wrapped in
  * `ActivityErrorBoundary` so a render failure (incl. the dev schema-validation
  * throw) degrades to an accessible fallback instead of crashing the host.
  */
-declare function MultipleChoice(props: ActivityProps<MultipleChoiceData>): react_jsx_runtime.JSX.Element;
+declare function MultipleChoice(props: MultipleChoiceProps): react_jsx_runtime.JSX.Element;
 
-export { ActivityProps, MultipleChoice };
+export { MultipleChoice, type MultipleChoiceProps };

package/dist/components/MultipleChoice.d.ts

@@ -1,12 +1,23 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { MultipleChoiceData } from '@intellectif/lk-core';
-import { A as ActivityProps } from '../types-iknDq5tf.js';
+import { A as ActivityProps } from '../types-CNmjqD6M.js';
+
+interface MultipleChoiceProps extends ActivityProps<MultipleChoiceData> {
+    /**
+     * Seed for the deterministic option shuffle. Supply one (e.g. the attempt
+     * id) to make the shuffled order reproducible server-side, stable across
+     * page reloads, and identical between SSR and hydration. When absent, a
+     * random per-mount session seed is used (order stable within the mount
+     * only — the v1 behaviour).
+     */
+    shuffleSeed?: string;
+}
 
 /**
  * Public Multiple Choice activity: the core component wrapped in
  * `ActivityErrorBoundary` so a render failure (incl. the dev schema-validation
  * throw) degrades to an accessible fallback instead of crashing the host.
  */
-declare function MultipleChoice(props: ActivityProps<MultipleChoiceData>): react_jsx_runtime.JSX.Element;
+declare function MultipleChoice(props: MultipleChoiceProps): react_jsx_runtime.JSX.Element;
 
-export { ActivityProps, MultipleChoice };
+export { MultipleChoice, type MultipleChoiceProps };

package/dist/components/MultipleChoice.js

@@ -1,4 +1,4 @@
-export { MultipleChoice } from '../chunk-G5ZEWJRA.js';
+export { MultipleChoice } from '../chunk-ZVFWJTT4.js';
 import '../chunk-UIGIYYGY.js';
 import '../chunk-5HVUKXF3.js';
 //# sourceMappingURL=MultipleChoice.js.map

package/dist/components/WrittenResponse.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkKJNQLAB5_cjs = require('../chunk-KJNQLAB5.cjs');
+var chunk7MW7HGOA_cjs = require('../chunk-7MW7HGOA.cjs');
 require('../chunk-QHOV2A6M.cjs');
 require('../chunk-HD2AIQRD.cjs');
 
@@ -8,7 +8,7 @@ require('../chunk-HD2AIQRD.cjs');
 
 Object.defineProperty(exports, "WrittenResponse", {
   enumerable: true,
-  get: function () { return chunkKJNQLAB5_cjs.WrittenResponse; }
+  get: function () { return chunk7MW7HGOA_cjs.WrittenResponse; }
 });
 //# sourceMappingURL=WrittenResponse.cjs.map
 //# sourceMappingURL=WrittenResponse.cjs.map

package/dist/components/WrittenResponse.d.cts

@@ -1,41 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { WrittenResponseData, XAPIStatement, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
-
-/**
- * Payload delivered when the learner submits a written response. Grading is
- * DEFERRED (asynchronous AI/human grading), so there is no score here — and
- * deliberately no fake one: an ungraded submission must never be shown or
- * stored as a 0. The consumer persists `text` and grades it out-of-band.
- */
-interface WrittenResponseSubmission {
-    /** The submitted text, verbatim. */
-    text: string;
-    /** Word count of `text`, recomputed with the canonical `countWords()`. */
-    wordCount: number;
-    /** Whether `wordCount` falls within the activity's `[minWords, maxWords]`. */
-    withinWordBounds: boolean;
-    /** Time in milliseconds from first interaction to submission. */
-    timeSpent: number;
-    /** The SUBMITTED-verb xAPI statement built for this submission (no score fields). */
-    xapiStatement: XAPIStatement;
-}
-/**
- * Props for {@link WrittenResponse}. Mirrors `ActivityProps` except for the
- * completion callback: a deferred-grading activity completes with a
- * {@link WrittenResponseSubmission} (`onSubmitted`), not a scored
- * `ActivityResult` (`onComplete`) — deviation from Req 22.8 recorded in the
- * roadmap (§3.1): fabricating a score of 0 for ungraded work is the exact
- * bug this type exists to fix.
- */
-interface WrittenResponseProps {
-    data: WrittenResponseData;
-    onSubmitted: (submission: WrittenResponseSubmission) => void;
-    onInteraction?: (event: InteractionEvent) => void;
-    /** Per-instance token overrides, applied as inline CSS vars on the root. */
-    theme?: Partial<ThemeTokens>;
-    locale?: string;
-    disabled?: boolean;
-}
+import { W as WrittenResponseProps } from '../WrittenResponse-B50EjVR0.cjs';
+export { a as WrittenResponseSubmission } from '../WrittenResponse-B50EjVR0.cjs';
+export { H as HtmlSanitizer, R as RenderMode, a as Renderable } from '../types-CNmjqD6M.cjs';
+import '@intellectif/lk-core';
 
 /**
  * Public Written Response activity: a labelled textarea with a live word
@@ -45,4 +12,4 @@ interface WrittenResponseProps {
  */
 declare function WrittenResponse(props: WrittenResponseProps): react_jsx_runtime.JSX.Element;
 
-export { WrittenResponse, type WrittenResponseProps, type WrittenResponseSubmission };
+export { WrittenResponse, WrittenResponseProps };

package/dist/components/WrittenResponse.d.ts

@@ -1,41 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { WrittenResponseData, XAPIStatement, InteractionEvent, ThemeTokens } from '@intellectif/lk-core';
-
-/**
- * Payload delivered when the learner submits a written response. Grading is
- * DEFERRED (asynchronous AI/human grading), so there is no score here — and
- * deliberately no fake one: an ungraded submission must never be shown or
- * stored as a 0. The consumer persists `text` and grades it out-of-band.
- */
-interface WrittenResponseSubmission {
-    /** The submitted text, verbatim. */
-    text: string;
-    /** Word count of `text`, recomputed with the canonical `countWords()`. */
-    wordCount: number;
-    /** Whether `wordCount` falls within the activity's `[minWords, maxWords]`. */
-    withinWordBounds: boolean;
-    /** Time in milliseconds from first interaction to submission. */
-    timeSpent: number;
-    /** The SUBMITTED-verb xAPI statement built for this submission (no score fields). */
-    xapiStatement: XAPIStatement;
-}
-/**
- * Props for {@link WrittenResponse}. Mirrors `ActivityProps` except for the
- * completion callback: a deferred-grading activity completes with a
- * {@link WrittenResponseSubmission} (`onSubmitted`), not a scored
- * `ActivityResult` (`onComplete`) — deviation from Req 22.8 recorded in the
- * roadmap (§3.1): fabricating a score of 0 for ungraded work is the exact
- * bug this type exists to fix.
- */
-interface WrittenResponseProps {
-    data: WrittenResponseData;
-    onSubmitted: (submission: WrittenResponseSubmission) => void;
-    onInteraction?: (event: InteractionEvent) => void;
-    /** Per-instance token overrides, applied as inline CSS vars on the root. */
-    theme?: Partial<ThemeTokens>;
-    locale?: string;
-    disabled?: boolean;
-}
+import { W as WrittenResponseProps } from '../WrittenResponse-BHhP936i.js';
+export { a as WrittenResponseSubmission } from '../WrittenResponse-BHhP936i.js';
+export { H as HtmlSanitizer, R as RenderMode, a as Renderable } from '../types-CNmjqD6M.js';
+import '@intellectif/lk-core';
 
 /**
  * Public Written Response activity: a labelled textarea with a live word
@@ -45,4 +12,4 @@ interface WrittenResponseProps {
  */
 declare function WrittenResponse(props: WrittenResponseProps): react_jsx_runtime.JSX.Element;
 
-export { WrittenResponse, type WrittenResponseProps, type WrittenResponseSubmission };
+export { WrittenResponse, WrittenResponseProps };

package/dist/components/WrittenResponse.js

@@ -1,4 +1,4 @@
-export { WrittenResponse } from '../chunk-V5EN3ESV.js';
+export { WrittenResponse } from '../chunk-AEQQ7VPF.js';
 import '../chunk-UIGIYYGY.js';
 import '../chunk-5HVUKXF3.js';
 //# sourceMappingURL=WrittenResponse.js.map

package/dist/index.cjs

@@ -1,31 +1,34 @@
 'use strict';
 
-var chunkSH7BRP4M_cjs = require('./chunk-SH7BRP4M.cjs');
-var chunkMKH5THDR_cjs = require('./chunk-MKH5THDR.cjs');
-var chunk73XCWYKD_cjs = require('./chunk-73XCWYKD.cjs');
-var chunkKJNQLAB5_cjs = require('./chunk-KJNQLAB5.cjs');
+var chunkHO3AC3WQ_cjs = require('./chunk-HO3AC3WQ.cjs');
+var chunkW6BH2YMZ_cjs = require('./chunk-W6BH2YMZ.cjs');
+var chunkUXO6KYSZ_cjs = require('./chunk-UXO6KYSZ.cjs');
+var chunk7MW7HGOA_cjs = require('./chunk-7MW7HGOA.cjs');
 require('./chunk-QHOV2A6M.cjs');
 var chunkHD2AIQRD_cjs = require('./chunk-HD2AIQRD.cjs');
 var chunkIYLQSNLE_cjs = require('./chunk-IYLQSNLE.cjs');
 var chunkCPF2JJG6_cjs = require('./chunk-CPF2JJG6.cjs');
 
-
+// src/components/types.ts
+function asRenderable(redacted) {
+  return redacted;
+}
 
 Object.defineProperty(exports, "ActivitySequence", {
   enumerable: true,
-  get: function () { return chunkSH7BRP4M_cjs.ActivitySequence; }
+  get: function () { return chunkHO3AC3WQ_cjs.ActivitySequence; }
 });
 Object.defineProperty(exports, "MultipleChoice", {
   enumerable: true,
-  get: function () { return chunkMKH5THDR_cjs.MultipleChoice; }
+  get: function () { return chunkW6BH2YMZ_cjs.MultipleChoice; }
 });
 Object.defineProperty(exports, "FillInTheBlanks", {
   enumerable: true,
-  get: function () { return chunk73XCWYKD_cjs.FillInTheBlanks; }
+  get: function () { return chunkUXO6KYSZ_cjs.FillInTheBlanks; }
 });
 Object.defineProperty(exports, "WrittenResponse", {
   enumerable: true,
-  get: function () { return chunkKJNQLAB5_cjs.WrittenResponse; }
+  get: function () { return chunk7MW7HGOA_cjs.WrittenResponse; }
 });
 Object.defineProperty(exports, "useActivityState", {
   enumerable: true,
@@ -51,5 +54,6 @@ Object.defineProperty(exports, "useTheme", {
   enumerable: true,
   get: function () { return chunkCPF2JJG6_cjs.useTheme; }
 });
+exports.asRenderable = asRenderable;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"version":3,"sources":["../src/components/types.ts"],"names":[],"mappings":";;;;;;;;;;;;AAqHO,SAAS,aACd,QAAA,EACmB;AACnB,EAAA,OAAO,QAAA;AACT","file":"index.cjs","sourcesContent":["import type {\n  ActivityData,\n  ActivityResult,\n  InteractionEvent,\n  ItemOutcome,\n  LearnerResponse,\n  RedactedActivityData,\n  ThemeTokens,\n} from '@intellectif/lk-core';\n\n/**\n * How an activity is being presented. This is the single switch that decides\n * whether the component may grade, reveal, or submit — the three things a\n * summative exam must take away from the client.\n *\n * - `practice` (default, v1 behaviour): the component owns the attempt. It\n *   scores locally on submit, reveals correctness and feedback, and calls\n *   `onComplete` with a full {@link ActivityResult}.\n * - `exam`: the component NEVER scores and NEVER reveals correctness. Submit\n *   emits the raw learner response through `onSubmit`; the server grades it.\n *   Safe to render redacted data, because nothing here needs the answer key.\n * - `review`: read-only. Renders the learner's submitted answer, and marks\n *   correctness only from an `outcome` the caller supplies (which the server\n *   computed). Nothing is submittable.\n */\nexport type RenderMode = 'practice' | 'exam' | 'review';\n\n/**\n * Makes the answer-key-bearing parts of an activity optional, so a component\n * can render either full activity data OR a `redact()` projection with the\n * same props. Fields the SDK classifies `answer-key` become optional here;\n * a component in `exam` mode must not read them at all.\n */\nexport type Renderable<TData> = Omit<TData, 'scoringStrategy'> & {\n  scoringStrategy?: unknown;\n  /** Present on a `redact()` projection. */\n  redacted?: true;\n};\n\n/**\n * Sanitiser for author-supplied rich text (`questionHtml`, `passageHtml`,\n * `promptHtml`). The SDK deliberately ships NO sanitiser — that would add a\n * dependency and, worse, a false promise. Rich text is rendered only when you\n * supply this function; without it the component falls back to the plain-text\n * field, which is always escaped. Fail-safe by construction: the SDK never\n * injects HTML it was not explicitly given a sanitiser for.\n */\nexport type HtmlSanitizer = (html: string) => string;\n\n/**\n * The prop contract shared by every activity component (Req 3.1). Defined\n * here (React-specific) rather than in lk-core, which is React-free.\n *\n * Controlled / uncontrolled follows the React convention: pass `value` +\n * `onChange` to own the learner's answer (restore an in-progress attempt,\n * autosave a delta, drive a review); pass `defaultValue` to seed an\n * uncontrolled component; pass neither for the v1 behaviour.\n */\nexport interface ActivityProps<TData extends ActivityData = ActivityData> {\n  /** Activity content. Accepts a `redact()` projection in `exam` mode. */\n  data: Renderable<TData>;\n  /**\n   * Called when the component scored the attempt itself. Only ever fires in\n   * `practice` mode — in `exam` mode the client does not grade, so there is\n   * no `ActivityResult` to give you; use `onSubmit`.\n   */\n  onComplete?: (result: ActivityResult) => void;\n  /**\n   * Called on submit with the raw learner response and no grade. Fires in\n   * every mode, before `onComplete`, so an exam runner can persist the\n   * response and let the server score it.\n   */\n  onSubmit?: (response: LearnerResponse) => void;\n  /** Controlled value: the learner's current response. */\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  /** Presentation mode. Defaults to `practice`. */\n  renderMode?: RenderMode;\n  /**\n   * Server-computed outcome, used by `review` mode to mark correctness\n   * without the client ever scoring. Ignored in other modes.\n   */\n  outcome?: ItemOutcome;\n  /** Renders author-supplied rich text when provided. See {@link 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 * Bridges a server-produced `redact()` projection into the `data` prop.\n *\n * `RedactedActivityData` is deliberately index-signature typed in lk-core — it\n * proves a payload is learner-safe, not what shape it has — so TypeScript\n * cannot know it still carries the public fields a renderer needs. This is the\n * SDK's single, documented crossing of that gap, so an exam runner does not\n * have to write `as unknown as` at every call site:\n *\n * ```tsx\n * <MultipleChoice\n *   data={asRenderable<MultipleChoiceData>(redactedFromServer)}\n *   renderMode=\"exam\"\n *   onSubmit={persist}\n * />\n * ```\n *\n * Safe because `exam` mode reads only public fields; the answer-key fields the\n * type claims are exactly the ones the component is forbidden to touch there.\n * A future release will derive per-type redacted interfaces so this becomes\n * unnecessary.\n */\nexport function asRenderable<TData extends ActivityData>(\n  redacted: RedactedActivityData,\n): Renderable<TData> {\n  return redacted as unknown as Renderable<TData>;\n}\n"]}

package/dist/index.d.cts

@@ -1,11 +1,12 @@
-export { ActivitySequence, ActivitySequenceProps } from './components/ActivitySequence.cjs';
+export { ActivityRenderer, ActivitySequence, ActivitySequenceProps, SequenceItemOutcome } from './components/ActivitySequence.cjs';
 export { FillInTheBlanks, FillInTheBlanksProps } from './components/FillInTheBlanks.cjs';
-export { MultipleChoice } from './components/MultipleChoice.cjs';
-export { WrittenResponse, WrittenResponseProps, WrittenResponseSubmission } from './components/WrittenResponse.cjs';
+export { MultipleChoice, MultipleChoiceProps } from './components/MultipleChoice.cjs';
+export { A as ActivityProps, H as HtmlSanitizer, R as RenderMode, a as Renderable, b as asRenderable } from './types-CNmjqD6M.cjs';
+export { WrittenResponse } from './components/WrittenResponse.cjs';
 export { ActivityState, UseActivityStateResult, useActivityState } from './hooks/useActivityState.cjs';
 export { UseXAPIResult, useXAPI } from './hooks/useXAPI.cjs';
 export { ThemeProvider, ThemeProviderProps, darkTheme, defaultTheme, useTheme } from './theme/ThemeProvider.cjs';
-export { A as ActivityProps } from './types-iknDq5tf.cjs';
+export { W as WrittenResponseProps, a as WrittenResponseSubmission } from './WrittenResponse-B50EjVR0.cjs';
 import '@intellectif/lk-core';
-import 'react/jsx-runtime';
 import 'react';
+import 'react/jsx-runtime';

package/dist/index.d.ts

@@ -1,11 +1,12 @@
-export { ActivitySequence, ActivitySequenceProps } from './components/ActivitySequence.js';
+export { ActivityRenderer, ActivitySequence, ActivitySequenceProps, SequenceItemOutcome } from './components/ActivitySequence.js';
 export { FillInTheBlanks, FillInTheBlanksProps } from './components/FillInTheBlanks.js';
-export { MultipleChoice } from './components/MultipleChoice.js';
-export { WrittenResponse, WrittenResponseProps, WrittenResponseSubmission } from './components/WrittenResponse.js';
+export { MultipleChoice, MultipleChoiceProps } from './components/MultipleChoice.js';
+export { A as ActivityProps, H as HtmlSanitizer, R as RenderMode, a as Renderable, b as asRenderable } from './types-CNmjqD6M.js';
+export { WrittenResponse } from './components/WrittenResponse.js';
 export { ActivityState, UseActivityStateResult, useActivityState } from './hooks/useActivityState.js';
 export { UseXAPIResult, useXAPI } from './hooks/useXAPI.js';
 export { ThemeProvider, ThemeProviderProps, darkTheme, defaultTheme, useTheme } from './theme/ThemeProvider.js';
-export { A as ActivityProps } from './types-iknDq5tf.js';
+export { W as WrittenResponseProps, a as WrittenResponseSubmission } from './WrittenResponse-BHhP936i.js';
 import '@intellectif/lk-core';
-import 'react/jsx-runtime';
 import 'react';
+import 'react/jsx-runtime';