@intellectif/lk-react 1.0.0 → 2.0.0

package/dist/chunk-V5EN3ESV.js

@@ -0,0 +1,156 @@
+import { ActivityErrorBoundary, isDevelopment, ActivityMedia, FeedbackRegion, ANONYMOUS_ACTOR, objectIdFor } from './chunk-UIGIYYGY.js';
+import { useActivityState } from './chunk-5HVUKXF3.js';
+import { validateActivity, ActivitySchemaError, countWords, evaluate, xAPIBuilder } from '@intellectif/lk-core';
+import { useMemo, useState, useEffect } from 'react';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+function WrittenResponse({
+  data,
+  onSubmitted,
+  onInteraction,
+  theme,
+  locale,
+  disabled
+}) {
+  const devError = useMemo(() => {
+    if (!isDevelopment()) {
+      return null;
+    }
+    const result = validateActivity("written-response", data);
+    return result.success ? null : new ActivitySchemaError("written-response", result.errors);
+  }, [data]);
+  const { state, start, complete, getTimeSpent, reset } = useActivityState();
+  const [text, setText] = useState("");
+  const [summary, setSummary] = useState(null);
+  useEffect(() => {
+    setText("");
+    setSummary(null);
+    reset();
+  }, [data, reset]);
+  if (devError) {
+    throw devError;
+  }
+  const submitted = state === "completed";
+  const inactive = disabled === true || submitted;
+  const wordCount = countWords(text);
+  const withinBounds = wordCount >= data.minWords && wordCount <= data.maxWords;
+  const handleChange = (value) => {
+    if (inactive) {
+      return;
+    }
+    if (state === "idle") {
+      start();
+    }
+    setText(value);
+    onInteraction?.({
+      type: "text-changed",
+      activityId: data.id,
+      timestamp: Date.now(),
+      payload: { wordCount: countWords(value) }
+    });
+  };
+  const handleSubmit = (event) => {
+    event.preventDefault();
+    if (inactive || text.trim().length === 0) {
+      return;
+    }
+    const outcome = evaluate(data, { type: "written-response", text, wordCount });
+    complete();
+    const timeSpent = getTimeSpent();
+    const partial = outcome.status === "deferred" ? outcome.partial : void 0;
+    const finalWordCount = typeof partial?.wordCount === "number" ? partial.wordCount : wordCount;
+    const finalWithinBounds = typeof partial?.withinWordBounds === "boolean" ? partial.withinWordBounds : withinBounds;
+    const xapiStatement = xAPIBuilder.buildSubmittedStatement({
+      actor: ANONYMOUS_ACTOR,
+      object: {
+        id: objectIdFor(data.id),
+        name: { [data.locale ?? "en-US"]: data.title },
+        type: "http://adlnet.gov/expapi/activities/cmi.interaction",
+        interactionType: "long-fill-in"
+      },
+      timeSpentMs: timeSpent,
+      response: text,
+      resultExtensions: {
+        "urn:learning-kit:extension:word-count": finalWordCount,
+        "urn:learning-kit:extension:within-word-bounds": finalWithinBounds
+      }
+    });
+    onSubmitted({
+      text,
+      wordCount: finalWordCount,
+      withinWordBounds: finalWithinBounds,
+      timeSpent,
+      xapiStatement
+    });
+    setSummary("Response submitted. It will be graded and your result will appear here later.");
+    onInteraction?.({
+      type: "submitted",
+      activityId: data.id,
+      timestamp: Date.now(),
+      payload: { wordCount: finalWordCount, withinWordBounds: finalWithinBounds }
+    });
+  };
+  const promptId = `${data.id}-prompt`;
+  const counterId = `${data.id}-counter`;
+  const boundsLabel = data.minWords > 0 ? `${data.minWords}\u2013${data.maxWords} words` : `up to ${data.maxWords} words`;
+  return /* @__PURE__ */ jsxs(
+    "form",
+    {
+      className: "lk-wr",
+      "aria-label": data.title,
+      lang: locale,
+      style: theme,
+      onSubmit: handleSubmit,
+      children: [
+        data.media ? /* @__PURE__ */ jsx(ActivityMedia, { media: data.media }) : null,
+        /* @__PURE__ */ jsx("p", { className: "lk-wr-prompt", id: promptId, children: data.prompt }),
+        /* @__PURE__ */ jsx(
+          "textarea",
+          {
+            className: "lk-wr-textarea",
+            "aria-labelledby": promptId,
+            "aria-describedby": counterId,
+            value: text,
+            onChange: (event) => handleChange(event.target.value),
+            disabled: inactive,
+            rows: 8
+          }
+        ),
+        /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: "lk-wr-counter",
+            id: counterId,
+            "aria-live": "polite",
+            "data-within-bounds": withinBounds,
+            children: [
+              wordCount,
+              " ",
+              wordCount === 1 ? "word" : "words",
+              " (",
+              boundsLabel,
+              ")"
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "submit",
+            className: "lk-wr-submit",
+            disabled: inactive || text.trim().length === 0,
+            children: "Submit"
+          }
+        ),
+        /* @__PURE__ */ jsx(FeedbackRegion, { id: `${data.id}-feedback`, children: summary })
+      ]
+    }
+  );
+}
+function WrittenResponse2(props) {
+  return /* @__PURE__ */ jsx(ActivityErrorBoundary, { activityTitle: props.data?.title, children: /* @__PURE__ */ jsx(WrittenResponse, { ...props }) });
+}
+
+export { WrittenResponse2 as WrittenResponse };
+//# sourceMappingURL=chunk-V5EN3ESV.js.map
+//# sourceMappingURL=chunk-V5EN3ESV.js.map

package/dist/chunk-V5EN3ESV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/WrittenResponse/WrittenResponse.tsx","../src/components/WrittenResponse/index.tsx"],"names":["WrittenResponse","jsx"],"mappings":";;;;;;AAwDO,SAAS,eAAA,CAAgB;AAAA,EAC9B,IAAA;AAAA,EACA,WAAA;AAAA,EACA,aAAA;AAAA,EACA,KAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAA,EAAyB;AAEvB,EAAA,MAAM,QAAA,GAAW,QAAQ,MAAM;AAC7B,IAAA,IAAI,CAAC,eAAc,EAAG;AACpB,MAAA,OAAO,IAAA;AAAA,IACT;AACA,IAAA,MAAM,MAAA,GAAS,gBAAA,CAAiB,kBAAA,EAAoB,IAAI,CAAA;AACxD,IAAA,OAAO,OAAO,OAAA,GAAU,IAAA,GAAO,IAAI,mBAAA,CAAoB,kBAAA,EAAoB,OAAO,MAAM,CAAA;AAAA,EAC1F,CAAA,EAAG,CAAC,IAAI,CAAC,CAAA;AAET,EAAA,MAAM,EAAE,KAAA,EAAO,KAAA,EAAO,UAAU,YAAA,EAAc,KAAA,KAAU,gBAAA,EAAiB;AACzE,EAAA,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,GAAI,SAAS,EAAE,CAAA;AACnC,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAI,SAAwB,IAAI,CAAA;AAI1D,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,OAAA,CAAQ,EAAE,CAAA;AACV,IAAA,UAAA,CAAW,IAAI,CAAA;AACf,IAAA,KAAA,EAAM;AAAA,EACR,CAAA,EAAG,CAAC,IAAA,EAAM,KAAK,CAAC,CAAA;AAEhB,EAAA,IAAI,QAAA,EAAU;AACZ,IAAA,MAAM,QAAA;AAAA,EACR;AAEA,EAAA,MAAM,YAAY,KAAA,KAAU,WAAA;AAC5B,EAAA,MAAM,QAAA,GAAW,aAAa,IAAA,IAAQ,SAAA;AACtC,EAAA,MAAM,SAAA,GAAY,WAAW,IAAI,CAAA;AACjC,EAAA,MAAM,YAAA,GAAe,SAAA,IAAa,IAAA,CAAK,QAAA,IAAY,aAAa,IAAA,CAAK,QAAA;AAErE,EAAA,MAAM,YAAA,GAAe,CAAC,KAAA,KAAwB;AAC5C,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA;AAAA,IACF;AACA,IAAA,IAAI,UAAU,MAAA,EAAQ;AACpB,MAAA,KAAA,EAAM;AAAA,IACR;AACA,IAAA,OAAA,CAAQ,KAAK,CAAA;AACb,IAAA,aAAA,GAAgB;AAAA,MACd,IAAA,EAAM,cAAA;AAAA,MACN,YAAY,IAAA,CAAK,EAAA;AAAA,MACjB,SAAA,EAAW,KAAK,GAAA,EAAI;AAAA,MACpB,OAAA,EAAS,EAAE,SAAA,EAAW,UAAA,CAAW,KAAK,CAAA;AAAE,KACzC,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,MAAM,YAAA,GAAe,CAAC,KAAA,KAAiC;AACrD,IAAA,KAAA,CAAM,cAAA,EAAe;AACrB,IAAA,IAAI,QAAA,IAAY,IAAA,CAAK,IAAA,EAAK,CAAE,WAAW,CAAA,EAAG;AACxC,MAAA;AAAA,IACF;AACA,IAAA,MAAM,OAAA,GAAU,SAAS,IAAA,EAAM,EAAE,MAAM,kBAAA,EAAoB,IAAA,EAAM,WAAW,CAAA;AAC5E,IAAA,QAAA,EAAS;AACT,IAAA,MAAM,YAAY,YAAA,EAAa;AAC/B,IAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,MAAA,KAAW,UAAA,GAAa,QAAQ,OAAA,GAAU,MAAA;AAClE,IAAA,MAAM,iBAAiB,OAAO,OAAA,EAAS,SAAA,KAAc,QAAA,GAAW,QAAQ,SAAA,GAAY,SAAA;AACpF,IAAA,MAAM,oBACJ,OAAO,OAAA,EAAS,gBAAA,KAAqB,SAAA,GAAY,QAAQ,gBAAA,GAAmB,YAAA;AAC9E,IAAA,MAAM,aAAA,GAAgB,YAAY,uBAAA,CAAwB;AAAA,MACxD,KAAA,EAAO,eAAA;AAAA,MACP,MAAA,EAAQ;AAAA,QACN,EAAA,EAAI,WAAA,CAAY,IAAA,CAAK,EAAE,CAAA;AAAA,QACvB,IAAA,EAAM,EAAE,CAAC,IAAA,CAAK,UAAU,OAAO,GAAG,KAAK,KAAA,EAAM;AAAA,QAC7C,IAAA,EAAM,qDAAA;AAAA,QACN,eAAA,EAAiB;AAAA,OACnB;AAAA,MACA,WAAA,EAAa,SAAA;AAAA,MACb,QAAA,EAAU,IAAA;AAAA,MACV,gBAAA,EAAkB;AAAA,QAChB,uCAAA,EAAyC,cAAA;AAAA,QACzC,+CAAA,EAAiD;AAAA;AACnD,KACD,CAAA;AACD,IAAA,WAAA,CAAY;AAAA,MACV,IAAA;AAAA,MACA,SAAA,EAAW,cAAA;AAAA,MACX,gBAAA,EAAkB,iBAAA;AAAA,MAClB,SAAA;AAAA,MACA;AAAA,KACD,CAAA;AACD,IAAA,UAAA,CAAW,+EAA+E,CAAA;AAC1F,IAAA,aAAA,GAAgB;AAAA,MACd,IAAA,EAAM,WAAA;AAAA,MACN,YAAY,IAAA,CAAK,EAAA;AAAA,MACjB,SAAA,EAAW,KAAK,GAAA,EAAI;AAAA,MACpB,OAAA,EAAS,EAAE,SAAA,EAAW,cAAA,EAAgB,kBAAkB,iBAAA;AAAkB,KAC3E,CAAA;AAAA,EACH,CAAA;AAEA,EAAA,MAAM,QAAA,GAAW,CAAA,EAAG,IAAA,CAAK,EAAE,CAAA,OAAA,CAAA;AAC3B,EAAA,MAAM,SAAA,GAAY,CAAA,EAAG,IAAA,CAAK,EAAE,CAAA,QAAA,CAAA;AAC5B,EAAA,MAAM,WAAA,GACJ,IAAA,CAAK,QAAA,GAAW,CAAA,GAAI,CAAA,EAAG,IAAA,CAAK,QAAQ,CAAA,MAAA,EAAI,IAAA,CAAK,QAAQ,CAAA,MAAA,CAAA,GAAW,CAAA,MAAA,EAAS,KAAK,QAAQ,CAAA,MAAA,CAAA;AAExF,EAAA,uBACE,IAAA;AAAA,IAAC,MAAA;AAAA,IAAA;AAAA,MACC,SAAA,EAAU,OAAA;AAAA,MACV,cAAY,IAAA,CAAK,KAAA;AAAA,MACjB,IAAA,EAAM,MAAA;AAAA,MACN,KAAA,EAAO,KAAA;AAAA,MACP,QAAA,EAAU,YAAA;AAAA,MAET,QAAA,EAAA;AAAA,QAAA,IAAA,CAAK,wBAAQ,GAAA,CAAC,aAAA,EAAA,EAAc,KAAA,EAAO,IAAA,CAAK,OAAO,CAAA,GAAK,IAAA;AAAA,4BACpD,GAAA,EAAA,EAAE,SAAA,EAAU,gBAAe,EAAA,EAAI,QAAA,EAC7B,eAAK,MAAA,EACR,CAAA;AAAA,wBACA,GAAA;AAAA,UAAC,UAAA;AAAA,UAAA;AAAA,YACC,SAAA,EAAU,gBAAA;AAAA,YACV,iBAAA,EAAiB,QAAA;AAAA,YACjB,kBAAA,EAAkB,SAAA;AAAA,YAClB,KAAA,EAAO,IAAA;AAAA,YACP,UAAU,CAAC,KAAA,KAAU,YAAA,CAAa,KAAA,CAAM,OAAO,KAAK,CAAA;AAAA,YACpD,QAAA,EAAU,QAAA;AAAA,YACV,IAAA,EAAM;AAAA;AAAA,SACR;AAAA,wBACA,IAAA;AAAA,UAAC,KAAA;AAAA,UAAA;AAAA,YACC,SAAA,EAAU,eAAA;AAAA,YACV,EAAA,EAAI,SAAA;AAAA,YACJ,WAAA,EAAU,QAAA;AAAA,YACV,oBAAA,EAAoB,YAAA;AAAA,YAEnB,QAAA,EAAA;AAAA,cAAA,SAAA;AAAA,cAAU,GAAA;AAAA,cAAE,SAAA,KAAc,IAAI,MAAA,GAAS,OAAA;AAAA,cAAQ,IAAA;AAAA,cAAG,WAAA;AAAA,cAAY;AAAA;AAAA;AAAA,SACjE;AAAA,wBACA,GAAA;AAAA,UAAC,QAAA;AAAA,UAAA;AAAA,YACC,IAAA,EAAK,QAAA;AAAA,YACL,SAAA,EAAU,cAAA;AAAA,YACV,QAAA,EAAU,QAAA,IAAY,IAAA,CAAK,IAAA,GAAO,MAAA,KAAW,CAAA;AAAA,YAC9C,QAAA,EAAA;AAAA;AAAA,SAED;AAAA,4BACC,cAAA,EAAA,EAAe,EAAA,EAAI,GAAG,IAAA,CAAK,EAAE,aAAc,QAAA,EAAA,OAAA,EAAQ;AAAA;AAAA;AAAA,GACtD;AAEJ;ACrLO,SAASA,iBAAgB,KAAA,EAA6B;AAC3D,EAAA,uBACEC,GAAAA,CAAC,qBAAA,EAAA,EAAsB,aAAA,EAAe,KAAA,CAAM,IAAA,EAAM,KAAA,EAChD,QAAA,kBAAAA,GAAAA,CAAC,eAAA,EAAA,EAAqB,GAAG,KAAA,EAAO,CAAA,EAClC,CAAA;AAEJ","file":"chunk-V5EN3ESV.js","sourcesContent":["'use client';\n\nimport {\n  ActivitySchemaError,\n  countWords,\n  evaluate,\n  type InteractionEvent,\n  type ThemeTokens,\n  validateActivity,\n  type WrittenResponseData,\n  type XAPIStatement,\n  xAPIBuilder,\n} from '@intellectif/lk-core';\nimport { type CSSProperties, useEffect, useMemo, 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';\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.\n */\nexport interface WrittenResponseProps {\n  data: WrittenResponseData;\n  onSubmitted: (submission: WrittenResponseSubmission) => void;\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\nexport function WrittenResponse({\n  data,\n  onSubmitted,\n  onInteraction,\n  theme,\n  locale,\n  disabled,\n}: WrittenResponseProps) {\n  // Dev-only boundary validation (Req 2.3), same convention as MC/FIB.\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 [text, setText] = useState('');\n  const [summary, setSummary] = useState<string | null>(null);\n\n  // Reset on data-prop change (Req 3.7).\n  // biome-ignore lint/correctness/useExhaustiveDependencies: data is the reset trigger (Req 3.7)\n  useEffect(() => {\n    setText('');\n    setSummary(null);\n    reset();\n  }, [data, reset]);\n\n  if (devError) {\n    throw devError;\n  }\n\n  const submitted = state === 'completed';\n  const inactive = disabled === true || submitted;\n  const wordCount = countWords(text);\n  const withinBounds = wordCount >= data.minWords && wordCount <= data.maxWords;\n\n  const handleChange = (value: string): void => {\n    if (inactive) {\n      return;\n    }\n    if (state === 'idle') {\n      start();\n    }\n    setText(value);\n    onInteraction?.({\n      type: 'text-changed',\n      activityId: data.id,\n      timestamp: Date.now(),\n      payload: { wordCount: countWords(value) },\n    });\n  };\n\n  const handleSubmit = (event: React.FormEvent): void => {\n    event.preventDefault();\n    if (inactive || text.trim().length === 0) {\n      return;\n    }\n    const outcome = evaluate(data, { type: 'written-response', text, wordCount });\n    complete();\n    const timeSpent = getTimeSpent();\n    const partial = outcome.status === 'deferred' ? outcome.partial : undefined;\n    const finalWordCount = typeof partial?.wordCount === 'number' ? partial.wordCount : wordCount;\n    const finalWithinBounds =\n      typeof partial?.withinWordBounds === 'boolean' ? partial.withinWordBounds : withinBounds;\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    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      style={theme as CSSProperties | undefined}\n      onSubmit={handleSubmit}\n    >\n      {data.media ? <ActivityMedia media={data.media} /> : null}\n      <p className=\"lk-wr-prompt\" id={promptId}>\n        {data.prompt}\n      </p>\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        disabled={inactive}\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      <button\n        type=\"submit\"\n        className=\"lk-wr-submit\"\n        disabled={inactive || text.trim().length === 0}\n      >\n        Submit\n      </button>\n      <FeedbackRegion id={`${data.id}-feedback`}>{summary}</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 { 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/components/ActivitySequence.cjs

@@ -1,16 +1,16 @@
 'use strict';
 
-var chunkRI53A36N_cjs = require('../chunk-RI53A36N.cjs');
-require('../chunk-QBA6UXMS.cjs');
-require('../chunk-O3GWWJFS.cjs');
-require('../chunk-6OBRYL4C.cjs');
+var chunkSH7BRP4M_cjs = require('../chunk-SH7BRP4M.cjs');
+require('../chunk-MKH5THDR.cjs');
+require('../chunk-73XCWYKD.cjs');
+require('../chunk-QHOV2A6M.cjs');
 require('../chunk-HD2AIQRD.cjs');
 
 
 
 Object.defineProperty(exports, "ActivitySequence", {
   enumerable: true,
-  get: function () { return chunkRI53A36N_cjs.ActivitySequence; }
+  get: function () { return chunkSH7BRP4M_cjs.ActivitySequence; }
 });
 //# sourceMappingURL=ActivitySequence.cjs.map
 //# sourceMappingURL=ActivitySequence.cjs.map

package/dist/components/ActivitySequence.js

@@ -1,7 +1,7 @@
-export { ActivitySequence } from '../chunk-ZPD7BGCF.js';
-import '../chunk-W2L66WHW.js';
-import '../chunk-5KW7TFX3.js';
-import '../chunk-L3EV5LIX.js';
+export { ActivitySequence } from '../chunk-OS7MO2OW.js';
+import '../chunk-G5ZEWJRA.js';
+import '../chunk-32WWQOG3.js';
+import '../chunk-UIGIYYGY.js';
 import '../chunk-5HVUKXF3.js';
 //# sourceMappingURL=ActivitySequence.js.map
 //# sourceMappingURL=ActivitySequence.js.map

package/dist/components/FillInTheBlanks.cjs

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

package/dist/components/FillInTheBlanks.js

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

package/dist/components/MultipleChoice.cjs

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

package/dist/components/MultipleChoice.js

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

package/dist/components/WrittenResponse.cjs

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

package/dist/components/WrittenResponse.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"WrittenResponse.cjs"}

package/dist/components/WrittenResponse.d.cts

@@ -0,0 +1,48 @@
+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;
+}
+
+/**
+ * Public Written Response activity: a labelled textarea with a live word
+ * counter for free-text writing graded asynchronously (AI or human). The core
+ * is wrapped in `ActivityErrorBoundary` so a render failure (incl. the dev
+ * schema-validation throw) degrades to an accessible fallback.
+ */
+declare function WrittenResponse(props: WrittenResponseProps): react_jsx_runtime.JSX.Element;
+
+export { WrittenResponse, type WrittenResponseProps, type WrittenResponseSubmission };

package/dist/components/WrittenResponse.d.ts

@@ -0,0 +1,48 @@
+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;
+}
+
+/**
+ * Public Written Response activity: a labelled textarea with a live word
+ * counter for free-text writing graded asynchronously (AI or human). The core
+ * is wrapped in `ActivityErrorBoundary` so a render failure (incl. the dev
+ * schema-validation throw) degrades to an accessible fallback.
+ */
+declare function WrittenResponse(props: WrittenResponseProps): react_jsx_runtime.JSX.Element;
+
+export { WrittenResponse, type WrittenResponseProps, type WrittenResponseSubmission };

package/dist/components/WrittenResponse.js

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

package/dist/components/WrittenResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"WrittenResponse.js"}

package/dist/hooks/useXAPI.cjs

@@ -1,12 +1,12 @@
 'use strict';
 
-var chunkTVK3SVV6_cjs = require('../chunk-TVK3SVV6.cjs');
+var chunkIYLQSNLE_cjs = require('../chunk-IYLQSNLE.cjs');
 
 
 
 Object.defineProperty(exports, "useXAPI", {
   enumerable: true,
-  get: function () { return chunkTVK3SVV6_cjs.useXAPI; }
+  get: function () { return chunkIYLQSNLE_cjs.useXAPI; }
 });
 //# sourceMappingURL=useXAPI.cjs.map
 //# sourceMappingURL=useXAPI.cjs.map

package/dist/hooks/useXAPI.js

@@ -1,3 +1,3 @@
-export { useXAPI } from '../chunk-IZNMQSQP.js';
+export { useXAPI } from '../chunk-E4MNA2IQ.js';
 //# sourceMappingURL=useXAPI.js.map
 //# sourceMappingURL=useXAPI.js.map

package/dist/index.cjs

@@ -1,26 +1,31 @@
 'use strict';
 
-var chunkRI53A36N_cjs = require('./chunk-RI53A36N.cjs');
-var chunkQBA6UXMS_cjs = require('./chunk-QBA6UXMS.cjs');
-var chunkO3GWWJFS_cjs = require('./chunk-O3GWWJFS.cjs');
-require('./chunk-6OBRYL4C.cjs');
+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');
+require('./chunk-QHOV2A6M.cjs');
 var chunkHD2AIQRD_cjs = require('./chunk-HD2AIQRD.cjs');
-var chunkTVK3SVV6_cjs = require('./chunk-TVK3SVV6.cjs');
+var chunkIYLQSNLE_cjs = require('./chunk-IYLQSNLE.cjs');
 var chunkCPF2JJG6_cjs = require('./chunk-CPF2JJG6.cjs');
 
 
 
 Object.defineProperty(exports, "ActivitySequence", {
   enumerable: true,
-  get: function () { return chunkRI53A36N_cjs.ActivitySequence; }
+  get: function () { return chunkSH7BRP4M_cjs.ActivitySequence; }
 });
 Object.defineProperty(exports, "MultipleChoice", {
   enumerable: true,
-  get: function () { return chunkQBA6UXMS_cjs.MultipleChoice; }
+  get: function () { return chunkMKH5THDR_cjs.MultipleChoice; }
 });
 Object.defineProperty(exports, "FillInTheBlanks", {
   enumerable: true,
-  get: function () { return chunkO3GWWJFS_cjs.FillInTheBlanks; }
+  get: function () { return chunk73XCWYKD_cjs.FillInTheBlanks; }
+});
+Object.defineProperty(exports, "WrittenResponse", {
+  enumerable: true,
+  get: function () { return chunkKJNQLAB5_cjs.WrittenResponse; }
 });
 Object.defineProperty(exports, "useActivityState", {
   enumerable: true,
@@ -28,7 +33,7 @@ Object.defineProperty(exports, "useActivityState", {
 });
 Object.defineProperty(exports, "useXAPI", {
   enumerable: true,
-  get: function () { return chunkTVK3SVV6_cjs.useXAPI; }
+  get: function () { return chunkIYLQSNLE_cjs.useXAPI; }
 });
 Object.defineProperty(exports, "ThemeProvider", {
   enumerable: true,

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 export { ActivitySequence, ActivitySequenceProps } 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 { ActivityState, UseActivityStateResult, useActivityState } from './hooks/useActivityState.cjs';
 export { UseXAPIResult, useXAPI } from './hooks/useXAPI.cjs';
 export { ThemeProvider, ThemeProviderProps, darkTheme, defaultTheme, useTheme } from './theme/ThemeProvider.cjs';

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { ActivitySequence, ActivitySequenceProps } 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 { ActivityState, UseActivityStateResult, useActivityState } from './hooks/useActivityState.js';
 export { UseXAPIResult, useXAPI } from './hooks/useXAPI.js';
 export { ThemeProvider, ThemeProviderProps, darkTheme, defaultTheme, useTheme } from './theme/ThemeProvider.js';

package/dist/index.js

@@ -1,9 +1,10 @@
-export { ActivitySequence } from './chunk-ZPD7BGCF.js';
-export { MultipleChoice } from './chunk-W2L66WHW.js';
-export { FillInTheBlanks } from './chunk-5KW7TFX3.js';
-import './chunk-L3EV5LIX.js';
+export { ActivitySequence } from './chunk-OS7MO2OW.js';
+export { MultipleChoice } from './chunk-G5ZEWJRA.js';
+export { FillInTheBlanks } from './chunk-32WWQOG3.js';
+export { WrittenResponse } from './chunk-V5EN3ESV.js';
+import './chunk-UIGIYYGY.js';
 export { useActivityState } from './chunk-5HVUKXF3.js';
-export { useXAPI } from './chunk-IZNMQSQP.js';
+export { useXAPI } from './chunk-E4MNA2IQ.js';
 export { ThemeProvider, darkTheme, defaultTheme, useTheme } from './chunk-B3FUUKZ2.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/theme/skin.css

@@ -349,4 +349,89 @@
     color: var(--lk-color-text-muted);
     font-size: var(--lk-font-size-sm);
   }
+
+  /* ── Written Response ────────────────────────────────────────────────── */
+  .lk-wr {
+    display: flex;
+    flex-direction: column;
+    gap: var(--lk-spacing-md);
+  }
+
+  .lk-wr-prompt {
+    margin: 0;
+    color: var(--lk-color-text);
+    font-family: var(--lk-font-family);
+    font-size: var(--lk-font-size-base);
+    line-height: 1.6;
+  }
+
+  .lk-wr-textarea {
+    width: 100%;
+    padding: var(--lk-spacing-sm) var(--lk-spacing-md);
+    border: 1px solid var(--lk-color-border);
+    border-radius: var(--lk-border-radius-md);
+    background: var(--lk-color-surface);
+    color: var(--lk-color-text);
+    font-family: var(--lk-font-family);
+    font-size: var(--lk-font-size-base);
+    line-height: 1.5;
+    resize: vertical;
+    transition: var(--lk-transition-fast);
+  }
+
+  .lk-wr-textarea:disabled {
+    opacity: 0.7;
+  }
+
+  .lk-wr-counter {
+    color: var(--lk-color-text-muted);
+    font-size: var(--lk-font-size-sm);
+  }
+
+  .lk-wr-counter[data-within-bounds="true"] {
+    color: var(--lk-color-success);
+  }
+
+  .lk-wr button[type="submit"] {
+    align-self: flex-start;
+    padding: var(--lk-spacing-sm) var(--lk-spacing-lg);
+    border: none;
+    border-radius: var(--lk-border-radius-md);
+    background: var(--lk-color-primary);
+    color: var(--lk-color-on-primary);
+    font-family: var(--lk-font-family);
+    font-size: var(--lk-font-size-base);
+    cursor: pointer;
+    transition: var(--lk-transition-fast);
+  }
+
+  .lk-wr button[type="submit"]:hover:not(:disabled) {
+    background: var(--lk-color-primary-hover);
+  }
+
+  .lk-wr button[type="submit"]:disabled {
+    opacity: 0.55;
+    cursor: default;
+  }
+
+  .lk-wr :focus-visible {
+    outline: 2px solid var(--lk-color-focus-ring);
+    outline-offset: 2px;
+  }
+
+  .lk-wr > [aria-live] {
+    color: var(--lk-color-text-muted);
+    font-size: var(--lk-font-size-sm);
+  }
+
+  /* ── Reduced motion (WCAG 2.3.3) ─────────────────────────────────────── */
+  @media (prefers-reduced-motion: reduce) {
+    .lk-mc *,
+    .lk-fib *,
+    .lk-wr *,
+    .lk-seq * {
+      transition: none;
+      animation: none;
+    }
+  }
 }

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@intellectif/lk-react",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "React 19 activity components, hooks, and theming for learning-kit",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/intellectif/learning-kit.git",
+    "directory": "packages/lk-react"
+  },
   "type": "module",
   "sideEffects": [
     "**/*.css"
@@ -27,6 +32,11 @@
       "import": "./dist/components/FillInTheBlanks.js",
       "require": "./dist/components/FillInTheBlanks.cjs"
     },
+    "./components/WrittenResponse": {
+      "types": "./dist/components/WrittenResponse.d.ts",
+      "import": "./dist/components/WrittenResponse.js",
+      "require": "./dist/components/WrittenResponse.cjs"
+    },
     "./hooks/useActivityState": {
       "types": "./dist/hooks/useActivityState.d.ts",
       "import": "./dist/hooks/useActivityState.js",
@@ -49,12 +59,13 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "LICENSE"
   ],
   "peerDependencies": {
     "react": "^19",
     "react-dom": "^19",
-    "@intellectif/lk-core": "^0.2.0"
+    "@intellectif/lk-core": "^0.3.0"
   },
   "devDependencies": {
     "@axe-core/react": "^4.10.0",
@@ -73,9 +84,12 @@
     "tsup": "^8.3.0",
     "vitest": "^4.1.6",
     "vitest-axe": "^0.1.0",
-    "@intellectif/lk-core": "0.2.0"
+    "@intellectif/lk-core": "0.3.0"
   },
   "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
   "scripts": {
     "build": "tsup",
     "test": "vitest run",