@longsightgroup/qti3-core 0.9.2 → 0.9.4

package/README.md

@@ -34,24 +34,42 @@ console.log(result.outcomes);
 console.log(result.state);
 ```
 
+### Randomized template items
+
+QTI template processing can generate deterministic item variants with expressions such
+as `qti-random-integer`, printed variables, and `qti-set-correct-response`:
+
+```ts
+const session = createItemSession(parsed.document, undefined, { randomSeed: "attempt-123" });
+const state = session.serialize();
+
+store(state);
+
+const resumed = createItemSession(parsed.document, state, { randomSeed: "different-seed" });
+```
+
+Persist the returned `qti3.attempt-state.v1` state for resume. Once an attempt exists,
+saved `templateValues` are authoritative; they are restored before generated correct
+responses are derived, so resuming does not depend on the original seed.
+
 ### Candidate-safe delivery XML
 
 High-stakes delivery systems can redact answer-bearing item XML before sending it to
 a browser:
 
 ```ts
-import { buildQtiDeliverySafeXml } from "@longsightgroup/qti3-core";
+import { prepareQtiDeliveryXml } from "@longsightgroup/qti3-core";
 
-const delivery = buildQtiDeliverySafeXml(authoritativeItemXml);
+const delivery = prepareQtiDeliveryXml(authoritativeItemXml, { mode: "static" });
 
 if (!delivery.ok) {
   throw new Error(delivery.diagnostics.map((item) => item.message).join("; "));
 }
 
-sendToCandidate(delivery.xml);
+sendToCandidate(delivery.candidateSafeXml);
 ```
 
-Use `buildQtiDeliverySafeXml().ok` for deliverability. The
+Use `prepareQtiDeliveryXml().ok` for deliverability. The
 `analyzeQtiDeliverySecurity().deliverySafe` flag describes the exact XML being analyzed,
 so it is normally `false` for an authoritative scorable item before redaction and `true`
 only for the redacted output.
@@ -64,10 +82,34 @@ template processing, set-correct-response, and adaptive response processing.
 String-range redaction uses the same dependency-free XML parser as `parseQtiXml`, with
 source ranges recorded during parsing. XML parse failures are reported as `xml.parse`
 error diagnostics; hosts must treat those diagnostics, `parseQtiXml().ok === false`,
-and `buildQtiDeliverySafeXml().ok === false` as non-deliverable. The redacted output is
+and `prepareQtiDeliveryXml().ok === false` as non-deliverable. The redacted output is
 re-analyzed before `ok` is returned, but hosts should still treat redacted XML as
 untrusted presentation input.
 
+`prepareQtiDeliveryXml()` is the high-level host API. Use `mode: "static"` for
+non-adaptive delivery where all response processing and feedback are removed. Use
+`mode: "server-materialized-adaptive"` only after the server has authoritative outcomes
+for the current adaptive view; pass those outcomes so visible feedback can be retained.
+Pass `templateValues` when the item uses template-derived presentation (`qti-printed-variable`,
+`qti-template-block`, or `qti-template-inline`). Adaptive turn processing supplies these
+from session state automatically; hosts calling `prepareQtiDeliveryXml()` directly must
+provide the same authoritative template snapshot. Generated answer keys, template and response
+processing, mappings, lookup tables, declaration defaults, and hidden feedback are
+stripped from candidate XML. Static delivery fails closed for adaptive response or
+template processing where server materialization is required.
+
+Use `analyzeQtiDeliverySecurity()` when a host only needs diagnostics about a specific
+XML string, and `buildQtiDeliverySafeXml()` when a host explicitly wants the lower-level
+static redaction primitive. Most delivery services should call `prepareQtiDeliveryXml()`
+instead.
+
+`prepareQtiDeliveryXml()` returns normalized `delivery.preparation.*` diagnostic codes
+for delivery preparation failures across both modes. Hosts can key on
+`result.diagnostics[].code` for logging, i18n, HTTP mapping, or telemetry when using the
+facade. `result.analysis.findings[].kind` remains available as the structured semantic
+contract for hosts that prefer mode-independent finding data. Lower-level APIs keep
+their own diagnostic namespaces for callers that intentionally use those primitives.
+
 The parser does not resolve external entities, process DTD entity declarations, or access
 the network or filesystem. Unknown named entities are preserved verbatim, and numeric
 character references expand to at most one valid XML character.
@@ -105,9 +147,63 @@ then runs response processing. It does not run candidate response-validation pol
 as required interactions, cardinality limits, or min/max response counts; delivery hosts
 should enforce that policy before accepting a submission or finalizing an attempt.
 
-The delivery redaction and server-scoring APIs are library APIs in `0.5.x`. CLI commands
-for delivery-safe XML generation and server-style scoring are not part of this release
-line yet.
+For the same response-validation policy the browser player uses, call
+`validateQtiResponseVariables()` against a parsed assessment item before scoring or
+persisting a submission:
+
+```ts
+import { parseQtiXml, validateQtiResponseVariables } from "@longsightgroup/qti3-core";
+
+const parsed = parseQtiXml(authoritativeItemXml);
+if (!parsed.ok) throw new Error("invalid item");
+
+const validation = validateQtiResponseVariables({
+  item: parsed.document.item,
+  responses: { RESPONSE: "A" },
+  allowedUndeclaredResponseIdentifiers: ["duration"],
+});
+
+if (!validation.ok) {
+  throw new Error(validation.diagnostics.map((item) => item.message).join("; "));
+}
+```
+
+`validateQtiResponseVariables()` uses the same runtime diagnostic codes as the player
+(`response.required`, `response.maximum`, `response.matchMax`, and related codes). It
+checks cardinality shape, required responses, min/max choice and association bounds, and
+per-choice `match-max` limits. It does not render custom validation messages in the DOM
+or validate media play counts beyond what the item model exposes.
+
+Use `materializeQtiItemSubmission()` when a server needs the reusable QTI mechanics behind
+finalization: response validation, trusted response application, response processing,
+adaptive turn materialization, normalized response/outcome snapshots, and a generic scoring
+disposition:
+
+```ts
+import { materializeQtiItemSubmission } from "@longsightgroup/qti3-core";
+
+const materialized = materializeQtiItemSubmission({
+  itemXml: authoritativeItemXml,
+  existingState: priorAttemptState,
+  trustedResponses: { RESPONSE: "A" },
+});
+
+if (!materialized.ok) {
+  throw new Error(materialized.diagnostics.map((item) => item.message).join("; "));
+}
+
+console.log(materialized.scoringDisposition);
+console.log(materialized.responseVariables);
+console.log(materialized.outcomeVariables);
+```
+
+`scoringDisposition` uses a default generic taxonomy from `qti3-core`: `scored`,
+`manual-scoring-required`, `unscored-reference`, or `invalid`. Host applications can map
+these dispositions to product-specific finalization statuses, grading queues, result
+aggregation, and external exports.
+
+Delivery redaction, server-style scoring, and secure adaptive turn handling are library
+APIs. Dedicated CLI commands for those operations are planned separately.
 
 ### Secure adaptive turns
 
@@ -144,9 +240,10 @@ player.restore(turn.state);
 Refresh turns with no new submission still return updated materialized XML derived from restored outcomes, so a resume flow should load both values again even when the candidate does not submit a new response.
 
 The static delivery redactor still fails closed for adaptive response processing. Use
-`processQtiAdaptiveItemTurn()` when a host needs a server-materialized candidate view
-and updated authoritative outcomes for the next adaptive turn. The low-level adaptive-turn
-redactor is internal to the core package; hosts should not call it directly.
+`processQtiAdaptiveItemTurn()` when a host needs both a server-materialized candidate
+view and updated authoritative outcomes for the next adaptive turn. Use
+`prepareQtiDeliveryXml(..., { mode: "server-materialized-adaptive", outcomes })` only
+when the host already owns the authoritative outcomes and needs to prepare candidate XML.
 
 ## Scope
 

package/dist/adaptive-turn-materializer.d.ts

@@ -3,6 +3,8 @@ import type { QtiDiagnostic, QtiValue } from "./types.js";
 export interface QtiAdaptiveCandidateMaterializationInput {
     itemXml: string;
     outcomes: Record<string, QtiValue>;
+    templateValues?: Record<string, QtiValue>;
+    responses?: Record<string, QtiValue>;
 }
 export interface QtiAdaptiveCandidateMaterializationResult {
     ok: boolean;

package/dist/adaptive-turn-materializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adaptive-turn-materializer.d.ts","sourceRoot":"","sources":["../src/adaptive-turn-materializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,2BAA2B,EAEjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAW1D,MAAM,WAAW,wCAAwC;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,yCAAyC;IACxD,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,QAAQ,EAAE,2BAA2B,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,wCAAwC,GAC9C,yCAAyC,CAE3C"}
+{"version":3,"file":"adaptive-turn-materializer.d.ts","sourceRoot":"","sources":["../src/adaptive-turn-materializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,2BAA2B,EAEjC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQ1D,MAAM,WAAW,wCAAwC;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,yCAAyC;IACxD,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,QAAQ,EAAE,2BAA2B,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,wCAAwC,GAC9C,yCAAyC,CAiB3C"}

package/dist/adaptive-turn-materializer.js

@@ -1,12 +1,25 @@
-import { FORBIDDEN_DELIVERY_SECRET_ELEMENT_NAMES, isDeclarationDefaultValue, redactDeliveryXml, } from "./delivery-redaction.js";
+import { FORBIDDEN_DELIVERY_SECRET_ELEMENT_NAMES, analyzeDeliveryXml, isDeclarationDefaultValue, parseDeliveryXml, redactDeliveryXml, } from "./delivery-redaction.js";
+import { materializeTemplatePresentation } from "./template-presentation-materializer.js";
 import { qtiValueToString } from "./value-format.js";
-const UNSUPPORTED_MATERIALIZATION_ELEMENT_NAMES = new Set([
-    "template-processing",
-    "set-correct-response",
-]);
+const TEMPLATE_PROCESSING_ELEMENT_NAMES = new Set(["template-processing", "set-correct-response"]);
 const FEEDBACK_ELEMENT_NAMES = new Set(["feedback-inline", "feedback-block", "modal-feedback"]);
 export function materializeAdaptiveCandidateView(input) {
-    return redactDeliveryXml(input.itemXml, adaptiveMaterializationPolicy(input.outcomes));
+    const policy = adaptiveMaterializationPolicy(input.outcomes);
+    const templateMaterialization = materializeTemplatePresentation(input.itemXml, {
+        outcomes: input.outcomes,
+        templateValues: input.templateValues ?? {},
+        responses: input.responses,
+    });
+    if (!templateMaterialization.ok) {
+        const analysis = analyzeDeliveryXml(parseDeliveryXml(input.itemXml), policy);
+        const diagnostics = [...templateMaterialization.diagnostics, ...analysis.diagnostics];
+        return {
+            ok: false,
+            diagnostics,
+            analysis,
+        };
+    }
+    return redactDeliveryXml(templateMaterialization.xml, policy);
 }
 function shouldPreserveFeedback(node, outcomes) {
     if (node.attributes["show-hide"] === "hide")
@@ -28,27 +41,20 @@ function adaptiveMaterializationPolicy(outcomes) {
         isForbiddenElement(node, normalizedName) {
             if (isFeedbackElement(normalizedName))
                 return !shouldPreserveFeedback(node, outcomes);
-            return (FORBIDDEN_DELIVERY_SECRET_ELEMENT_NAMES.has(normalizedName) ||
+            return (TEMPLATE_PROCESSING_ELEMENT_NAMES.has(normalizedName) ||
+                FORBIDDEN_DELIVERY_SECRET_ELEMENT_NAMES.has(normalizedName) ||
                 isDeclarationDefaultValue(node, normalizedName));
         },
-        unsupportedFinding(node, normalizedName) {
-            if (!UNSUPPORTED_MATERIALIZATION_ELEMENT_NAMES.has(normalizedName))
-                return null;
-            return {
-                kind: "unsupported-secure-delivery-element",
-                qtiName: node.name,
-                localName: node.localName,
-                message: `${node.name} is not supported by adaptive candidate materialization v1.`,
-                source: node.source,
-            };
+        unsupportedFinding() {
+            return null;
         },
-        diagnosticCodeForFinding,
+        diagnosticCodeForFinding: adaptiveMaterializationDiagnosticCodeForFinding,
         forbiddenElementMessage(node) {
             return `${node.name} exposes answer keys, scoring, mapping, feedback, or solution information during adaptive delivery.`;
         },
     };
 }
-function diagnosticCodeForFinding(kind) {
+function adaptiveMaterializationDiagnosticCodeForFinding(kind) {
     return kind === "unsupported-secure-delivery-element"
         ? "adaptiveTurn.materialization.unsupported"
         : "adaptiveTurn.materialization.forbiddenElement";

package/dist/adaptive-turn-materializer.js.map

@@ -1 +1 @@
-{"version":3,"file":"adaptive-turn-materializer.js","sourceRoot":"","sources":["../src/adaptive-turn-materializer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uCAAuC,EACvC,yBAAyB,EACzB,iBAAiB,GAIlB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGrD,MAAM,yCAAyC,GAAG,IAAI,GAAG,CAAC;IACxD,qBAAqB;IACrB,sBAAsB;CACvB,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAchG,MAAM,UAAU,gCAAgC,CAC9C,KAA+C;IAE/C,OAAO,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,6BAA6B,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAa,EAAE,QAAkC;IAC/E,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;IAC9C,MAAM,iBAAiB,GAAG,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAChE,IAAI,CAAC,UAAU,IAAI,CAAC,iBAAiB;QAAE,OAAO,KAAK,CAAC;IAEpD,MAAM,OAAO,GAAG,QAAQ,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC;IACpD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAChE,OAAO,gBAAgB,CAAC,OAAO,CAAC,KAAK,UAAU,CAAC;AAClD,CAAC;AAED,SAAS,iBAAiB,CAAC,cAAsB;IAC/C,OAAO,sBAAsB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,6BAA6B,CACpC,QAAkC;IAElC,OAAO;QACL,kBAAkB,CAAC,IAAI,EAAE,cAAc;YACrC,IAAI,iBAAiB,CAAC,cAAc,CAAC;gBAAE,OAAO,CAAC,sBAAsB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACtF,OAAO,CACL,uCAAuC,CAAC,GAAG,CAAC,cAAc,CAAC;gBAC3D,yBAAyB,CAAC,IAAI,EAAE,cAAc,CAAC,CAChD,CAAC;QACJ,CAAC;QACD,kBAAkB,CAAC,IAAI,EAAE,cAAc;YACrC,IAAI,CAAC,yCAAyC,CAAC,GAAG,CAAC,cAAc,CAAC;gBAAE,OAAO,IAAI,CAAC;YAChF,OAAO;gBACL,IAAI,EAAE,qCAAqC;gBAC3C,OAAO,EAAE,IAAI,CAAC,IAAI;gBAClB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,6DAA6D;gBAClF,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC;QACJ,CAAC;QACD,wBAAwB;QACxB,uBAAuB,CAAC,IAAI;YAC1B,OAAO,GAAG,IAAI,CAAC,IAAI,qGAAqG,CAAC;QAC3H,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAoC;IACpE,OAAO,IAAI,KAAK,qCAAqC;QACnD,CAAC,CAAC,0CAA0C;QAC5C,CAAC,CAAC,+CAA+C,CAAC;AACtD,CAAC"}
+{"version":3,"file":"adaptive-turn-materializer.js","sourceRoot":"","sources":["../src/adaptive-turn-materializer.ts"],"names":[],"mappings":"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"}

package/dist/adaptive-turn.d.ts

@@ -1,5 +1,5 @@
 import type { QtiAttemptStateV1, QtiDiagnostic, QtiValue } from "./types.js";
-import { type QtiTrustedItemParseOptions, type QtiTrustedResponseApplication, type QtiTrustedResponseInput } from "./trusted-item-session.js";
+import { type QtiTrustedInputDiagnosticPrefix, type QtiTrustedItemDocument, type QtiTrustedItemParseOptions, type QtiTrustedResponseInput, type QtiTrustedResponseApplication, type QtiTrustedSubmissionValidation } from "./trusted-item-session.js";
 export type QtiAdaptiveTurnResponseInput = QtiTrustedResponseInput;
 export interface QtiAdaptiveTurnInput extends QtiTrustedItemParseOptions, QtiTrustedResponseApplication {
     itemXml: string;
@@ -9,6 +9,12 @@ export interface QtiAdaptiveTurnInput extends QtiTrustedItemParseOptions, QtiTru
      */
     priorState?: unknown;
 }
+export interface TrustedAdaptiveItemTurnInput extends QtiAdaptiveTurnInput {
+    parsedItem?: QtiTrustedItemDocument | undefined;
+    diagnosticPrefix: QtiTrustedInputDiagnosticPrefix;
+    submissionValidation?: QtiTrustedSubmissionValidation | undefined;
+    allowIncompleteResponses?: boolean | undefined;
+}
 export interface QtiAdaptiveTurnResult {
     ok: boolean;
     diagnostics: QtiDiagnostic[];
@@ -20,4 +26,5 @@ export interface QtiAdaptiveTurnResult {
     candidateSafeXml?: string | undefined;
 }
 export declare function processQtiAdaptiveItemTurn(input: QtiAdaptiveTurnInput): QtiAdaptiveTurnResult;
+export declare function runTrustedAdaptiveItemTurn(input: TrustedAdaptiveItemTurnInput): QtiAdaptiveTurnResult;
 //# sourceMappingURL=adaptive-turn.d.ts.map

package/dist/adaptive-turn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adaptive-turn.d.ts","sourceRoot":"","sources":["../src/adaptive-turn.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC7B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,4BAA4B,GAAG,uBAAuB,CAAC;AAEnE,MAAM,WAAW,oBACf,SAAQ,0BAA0B,EAAE,6BAA6B;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gBAAgB,EAAE,QAAQ,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CA0D7F"}
+{"version":3,"file":"adaptive-turn.d.ts","sourceRoot":"","sources":["../src/adaptive-turn.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAGL,KAAK,+BAA+B,EACpC,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,EACpC,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,4BAA4B,GAAG,uBAAuB,CAAC;AAEnE,MAAM,WAAW,oBACf,SAAQ,0BAA0B,EAAE,6BAA6B;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,4BAA6B,SAAQ,oBAAoB;IACxE,UAAU,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAChD,gBAAgB,EAAE,+BAA+B,CAAC;IAClD,oBAAoB,CAAC,EAAE,8BAA8B,GAAG,SAAS,CAAC;IAClE,wBAAwB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gBAAgB,EAAE,QAAQ,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAE7F;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,4BAA4B,GAClC,qBAAqB,CAiEvB"}

package/dist/adaptive-turn.js

@@ -1,13 +1,18 @@
 import { materializeAdaptiveCandidateView } from "./adaptive-turn-materializer.js";
 import { readPriorAttemptState, runTrustedItemSession, } from "./trusted-item-session.js";
 export function processQtiAdaptiveItemTurn(input) {
-    const priorStateResult = readPriorAttemptState(input.priorState, "adaptiveTurn");
+    return runTrustedAdaptiveItemTurn({ ...input, diagnosticPrefix: "adaptiveTurn" });
+}
+export function runTrustedAdaptiveItemTurn(input) {
+    const diagnosticPrefix = input.diagnosticPrefix;
+    const priorStateResult = readPriorAttemptState(input.priorState, diagnosticPrefix);
     if (priorStateResult.diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
         return failed(priorStateResult.diagnostics);
     }
     const sessionResult = runTrustedItemSession({
         itemXml: input.itemXml,
-        diagnosticPrefix: "adaptiveTurn",
+        parsedItem: input.parsedItem,
+        diagnosticPrefix,
         allowedUndeclaredResponseIdentifiers: input.allowedUndeclaredResponseIdentifiers,
         priorState: priorStateResult.state,
         submission: {
@@ -16,6 +21,8 @@ export function processQtiAdaptiveItemTurn(input) {
         },
         scoring: "onSubmission",
         requireNumericScore: true,
+        submissionValidation: input.submissionValidation,
+        allowIncompleteResponses: input.allowIncompleteResponses,
     });
     if (!sessionResult.ok) {
         return failed(sessionResult.diagnostics, sessionResult.state, sessionResult.outcomes, sessionResult.score);
@@ -23,13 +30,16 @@ export function processQtiAdaptiveItemTurn(input) {
     const delivery = materializeAdaptiveCandidateView({
         itemXml: input.itemXml,
         outcomes: sessionResult.outcomes,
+        responses: sessionResult.responses,
+        templateValues: sessionResult.state.templateValues ?? {},
     });
     const deliveryDiagnostics = [...sessionResult.diagnostics, ...delivery.diagnostics];
-    if (!delivery.ok || !delivery.xml) {
+    const candidateSafeXml = delivery.xml;
+    if (!delivery.ok || !candidateSafeXml) {
         return failed([
             ...deliveryDiagnostics,
             {
-                code: "adaptiveTurn.delivery.materialization",
+                code: `${diagnosticPrefix}.delivery.materialization`,
                 severity: "error",
                 message: "Adaptive turn did not produce candidate-safe item XML.",
             },
@@ -43,7 +53,7 @@ export function processQtiAdaptiveItemTurn(input) {
         outcomes: sessionResult.outcomes,
         score: sessionResult.score,
         completionStatus: sessionResult.outcomes.completionStatus ?? null,
-        candidateSafeXml: delivery.xml,
+        candidateSafeXml,
     };
 }
 function failed(diagnostics, state = null, outcomes = {}, score = null) {

package/dist/adaptive-turn.js.map

@@ -1 +1 @@
-{"version":3,"file":"adaptive-turn.js","sourceRoot":"","sources":["../src/adaptive-turn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,iCAAiC,CAAC;AAEnF,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GAItB,MAAM,2BAA2B,CAAC;AAyBnC,MAAM,UAAU,0BAA0B,CAAC,KAA2B;IACpE,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,KAAK,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACjF,IAAI,gBAAgB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,OAAO,CAAC,EAAE,CAAC;QACvF,OAAO,MAAM,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,aAAa,GAAG,qBAAqB,CAAC;QAC1C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,gBAAgB,EAAE,cAAc;QAChC,oCAAoC,EAAE,KAAK,CAAC,oCAAoC;QAChF,UAAU,EAAE,gBAAgB,CAAC,KAAK;QAClC,UAAU,EAAE;YACV,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,wBAAwB,EAAE,KAAK,CAAC,wBAAwB;SACzD;QACD,OAAO,EAAE,cAAc;QACvB,mBAAmB,EAAE,IAAI;KAC1B,CAAC,CAAC;IACH,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC;QACtB,OAAO,MAAM,CACX,aAAa,CAAC,WAAW,EACzB,aAAa,CAAC,KAAK,EACnB,aAAa,CAAC,QAAQ,EACtB,aAAa,CAAC,KAAK,CACpB,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,gCAAgC,CAAC;QAChD,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,aAAa,CAAC,QAAQ;KACjC,CAAC,CAAC;IACH,MAAM,mBAAmB,GAAG,CAAC,GAAG,aAAa,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IACpF,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QAClC,OAAO,MAAM,CACX;YACE,GAAG,mBAAmB;YACtB;gBACE,IAAI,EAAE,uCAAuC;gBAC7C,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,wDAAwD;aAClE;SACF,EACD,aAAa,CAAC,KAAK,EACnB,aAAa,CAAC,QAAQ,EACtB,aAAa,CAAC,KAAK,CACpB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,WAAW,EAAE,mBAAmB;QAChC,KAAK,EAAE,aAAa,CAAC,KAAK;QAC1B,SAAS,EAAE,aAAa,CAAC,SAAS;QAClC,QAAQ,EAAE,aAAa,CAAC,QAAQ;QAChC,KAAK,EAAE,aAAa,CAAC,KAAK;QAC1B,gBAAgB,EAAE,aAAa,CAAC,QAAQ,CAAC,gBAAgB,IAAI,IAAI;QACjE,gBAAgB,EAAE,QAAQ,CAAC,GAAG;KAC/B,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CACb,WAA4B,EAC5B,QAAkC,IAAI,EACtC,WAAqC,EAAE,EACvC,QAAuB,IAAI;IAE3B,OAAO;QACL,EAAE,EAAE,KAAK;QACT,WAAW;QACX,KAAK;QACL,SAAS,EAAE,KAAK,EAAE,SAAS,IAAI,EAAE;QACjC,QAAQ;QACR,KAAK;QACL,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,IAAI,IAAI;KACpD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"adaptive-turn.js","sourceRoot":"","sources":["../src/adaptive-turn.ts"],"names":[],"mappings":"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"}

package/dist/assert-never.d.ts

@@ -0,0 +1,3 @@
+/** Fail loudly when a value should be unreachable after exhaustive union handling. */
+export declare function assertNever(value: never, message?: string): never;
+//# sourceMappingURL=assert-never.d.ts.map

package/dist/assert-never.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-never.d.ts","sourceRoot":"","sources":["../src/assert-never.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAEjE"}

package/dist/assert-never.js

@@ -0,0 +1,5 @@
+/** Fail loudly when a value should be unreachable after exhaustive union handling. */
+export function assertNever(value, message) {
+    throw new Error(message ?? `Unexpected value: ${String(value)}`);
+}
+//# sourceMappingURL=assert-never.js.map

package/dist/assert-never.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-never.js","sourceRoot":"","sources":["../src/assert-never.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,OAAgB;IACxD,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,qBAAqB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/dist/attempt-state-constants.d.ts

@@ -0,0 +1,6 @@
+export declare const ATTEMPT_STATE_SCHEMA = "qti3.attempt-state.v1";
+export declare const COMPLETION_STATUS = "completionStatus";
+export declare const COMPLETION_NOT_ATTEMPTED = "not_attempted";
+export declare const COMPLETION_UNKNOWN = "unknown";
+export declare const COMPLETION_COMPLETED = "completed";
+//# sourceMappingURL=attempt-state-constants.d.ts.map

package/dist/attempt-state-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt-state-constants.d.ts","sourceRoot":"","sources":["../src/attempt-state-constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,0BAA0B,CAAC;AAC5D,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AACpD,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AACxD,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAC5C,eAAO,MAAM,oBAAoB,cAAc,CAAC"}

package/dist/attempt-state-constants.js

@@ -0,0 +1,6 @@
+export const ATTEMPT_STATE_SCHEMA = "qti3.attempt-state.v1";
+export const COMPLETION_STATUS = "completionStatus";
+export const COMPLETION_NOT_ATTEMPTED = "not_attempted";
+export const COMPLETION_UNKNOWN = "unknown";
+export const COMPLETION_COMPLETED = "completed";
+//# sourceMappingURL=attempt-state-constants.js.map

package/dist/attempt-state-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt-state-constants.js","sourceRoot":"","sources":["../src/attempt-state-constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAC5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AACpD,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAC5C,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC"}

package/dist/attempt-state.d.ts

@@ -0,0 +1,5 @@
+import type { QtiAttemptStateV1, QtiDocument } from "./types.js";
+export declare function isQtiAttemptStateV1(value: unknown): value is QtiAttemptStateV1;
+export declare function assertQtiAttemptStateV1(value: unknown): asserts value is QtiAttemptStateV1;
+export declare function assertCompatiblePriorState(document: QtiDocument, priorState: QtiAttemptStateV1 | undefined): void;
+//# sourceMappingURL=attempt-state.d.ts.map

package/dist/attempt-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt-state.d.ts","sourceRoot":"","sources":["../src/attempt-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAGjB,WAAW,EAKZ,MAAM,YAAY,CAAC;AAYpB,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,iBAAiB,CAG1F;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,iBAAiB,GAAG,SAAS,GACxC,IAAI,CAyDN"}

package/dist/attempt-state.js

@@ -0,0 +1,190 @@
+import { ATTEMPT_STATE_SCHEMA, COMPLETION_COMPLETED, COMPLETION_NOT_ATTEMPTED, COMPLETION_STATUS, COMPLETION_UNKNOWN, } from "./attempt-state-constants.js";
+import { isQtiPortableCustomStateValue, isQtiValue, qtiValueToString } from "./value-format.js";
+import { isRecordValue } from "./processing-values.js";
+import { isPair, isPoint } from "./validation-primitives.js";
+export function isQtiAttemptStateV1(value) {
+    return attemptStateErrors(value).length === 0;
+}
+export function assertQtiAttemptStateV1(value) {
+    const [firstError] = attemptStateErrors(value);
+    if (firstError)
+        throw new Error(firstError);
+}
+export function assertCompatiblePriorState(document, priorState) {
+    if (!priorState)
+        return;
+    assertQtiAttemptStateV1(priorState);
+    if (priorState.itemIdentifier !== document.item.identifier) {
+        throw new Error(`Cannot restore state for ${priorState.itemIdentifier} into ${document.item.identifier}.`);
+    }
+    const responseIdentifiers = new Set(document.item.responseDeclarations.map((declaration) => declaration.identifier));
+    const outcomeIdentifiers = new Set([
+        ...document.item.outcomeDeclarations.map((declaration) => declaration.identifier),
+        COMPLETION_STATUS,
+    ]);
+    const templateIdentifiers = new Set(document.item.templateDeclarations.map((declaration) => declaration.identifier));
+    const interactionStateIdentifiers = new Set(document.item.interactions
+        .filter((interaction) => interaction.type === "portableCustom")
+        .map((interaction) => interaction.responseIdentifier)
+        .filter((identifier) => Boolean(identifier)));
+    assertKnownStateIdentifiers("response", priorState.responses, responseIdentifiers);
+    assertKnownStateIdentifiers("outcome", priorState.outcomes, outcomeIdentifiers);
+    assertKnownStateIdentifiers("template", priorState.templateValues ?? {}, templateIdentifiers);
+    assertKnownPortableCustomStateIdentifiers(priorState.interactionStates ?? {}, interactionStateIdentifiers);
+    for (const message of priorState.validationMessages) {
+        if (message.path && !responseIdentifiers.has(message.path)) {
+            throw new Error(`Cannot restore validation message for unknown response ${message.path}.`);
+        }
+    }
+    for (const declaration of document.item.responseDeclarations) {
+        assertRestoredValueMatchesDeclaration("response", declaration, priorState.responses);
+    }
+    for (const declaration of document.item.outcomeDeclarations) {
+        assertRestoredValueMatchesDeclaration("outcome", declaration, priorState.outcomes);
+    }
+    for (const declaration of document.item.templateDeclarations) {
+        assertRestoredValueMatchesDeclaration("template", declaration, priorState.templateValues ?? {});
+    }
+    const completionStatus = priorState.outcomes[COMPLETION_STATUS];
+    if (completionStatus !== undefined &&
+        completionStatus !== COMPLETION_NOT_ATTEMPTED &&
+        completionStatus !== COMPLETION_UNKNOWN &&
+        completionStatus !== COMPLETION_COMPLETED &&
+        completionStatus !== "incomplete") {
+        throw new Error(`Cannot restore unsupported completionStatus ${qtiValueToString(completionStatus)}.`);
+    }
+}
+function assertKnownStateIdentifiers(kind, record, allowed) {
+    const unknown = Object.keys(record).find((identifier) => !allowed.has(identifier));
+    if (unknown)
+        throw new Error(`Cannot restore unknown ${kind} identifier ${unknown}.`);
+}
+function assertKnownPortableCustomStateIdentifiers(record, allowed) {
+    const unknown = Object.keys(record).find((identifier) => !allowed.has(identifier));
+    if (unknown)
+        throw new Error(`Cannot restore unknown interaction state identifier ${unknown}.`);
+}
+function assertRestoredValueMatchesDeclaration(kind, declaration, record) {
+    if (!(declaration.identifier in record))
+        return;
+    const value = record[declaration.identifier] ?? null;
+    const error = restoredValueError(declaration, value);
+    if (error)
+        throw new Error(`Cannot restore ${kind} ${declaration.identifier}: ${error}.`);
+}
+function restoredValueError(declaration, value) {
+    if (value === null)
+        return undefined;
+    if (declaration.cardinality === "record") {
+        return isRecordValue(value) ? undefined : "expected record value";
+    }
+    if (isRecordValue(value))
+        return "expected scalar value";
+    if (declaration.cardinality === "single" && Array.isArray(value)) {
+        return "expected single value";
+    }
+    if ((declaration.cardinality === "multiple" || declaration.cardinality === "ordered") &&
+        !Array.isArray(value)) {
+        return `expected ${declaration.cardinality} value container`;
+    }
+    if (!declaration.baseType)
+        return undefined;
+    for (const entry of restoredValueEntries(value)) {
+        if (!restoredScalarMatchesBaseType(entry, declaration.baseType)) {
+            return `value ${String(entry)} is not valid for base-type ${declaration.baseType}`;
+        }
+    }
+    return undefined;
+}
+function restoredValueEntries(value) {
+    if (value === null || isRecordValue(value))
+        return [];
+    return Array.isArray(value) ? value : [value];
+}
+function restoredScalarMatchesBaseType(value, baseType) {
+    if (!baseType)
+        return true;
+    if (baseType === "integer") {
+        return typeof value === "number" ? Number.isInteger(value) : /^-?\d+$/.test(String(value));
+    }
+    if (baseType === "float") {
+        return typeof value === "number" ? Number.isFinite(value) : Number.isFinite(Number(value));
+    }
+    if (baseType === "boolean")
+        return typeof value === "boolean" || value === "true" || value === "false";
+    if (baseType === "point")
+        return isPoint(String(value));
+    if (baseType === "pair" || baseType === "directedPair")
+        return isPair(String(value));
+    if (baseType === "identifier")
+        return typeof value === "string" && value.trim().length > 0 && !/\s/.test(value);
+    return typeof value === "string";
+}
+function isAttemptStatus(value) {
+    return (value === "initialized" ||
+        value === "interacting" ||
+        value === "suspended" ||
+        value === "completed");
+}
+function attemptStateErrors(value) {
+    if (!isRecord(value))
+        return ["QTI attempt state must be an object."];
+    const schema = value.schema;
+    if (schema !== ATTEMPT_STATE_SCHEMA) {
+        return [`Unsupported QTI attempt state schema ${String(schema)}.`];
+    }
+    const errors = [];
+    if (typeof value.itemIdentifier !== "string" || value.itemIdentifier.length === 0) {
+        errors.push("QTI attempt state itemIdentifier must be a non-empty string.");
+    }
+    if (typeof value.status !== "string" || !isAttemptStatus(value.status)) {
+        errors.push(`QTI attempt state status ${String(value.status)} is not supported.`);
+    }
+    if (!isQtiValueRecord(value.responses)) {
+        errors.push("QTI attempt state responses must be a record of QTI values.");
+    }
+    if (!isQtiValueRecord(value.outcomes)) {
+        errors.push("QTI attempt state outcomes must be a record of QTI values.");
+    }
+    if (value.templateValues !== undefined && !isQtiValueRecord(value.templateValues)) {
+        errors.push("QTI attempt state templateValues must be a record of QTI values.");
+    }
+    if (value.interactionStates !== undefined &&
+        !isPortableCustomStateRecord(value.interactionStates)) {
+        errors.push("QTI attempt state interactionStates must be a record of JSON values.");
+    }
+    if (!isDiagnosticArray(value.validationMessages)) {
+        errors.push("QTI attempt state validationMessages must be an array of diagnostics.");
+    }
+    return errors;
+}
+function isQtiValueRecord(value) {
+    if (!isRecord(value))
+        return false;
+    return Object.values(value).every(isQtiValue);
+}
+function isPortableCustomStateRecord(value) {
+    if (!isRecord(value))
+        return false;
+    return Object.values(value).every(isQtiPortableCustomStateValue);
+}
+function isDiagnosticArray(value) {
+    if (!Array.isArray(value))
+        return false;
+    return value.every((item) => {
+        if (!isRecord(item))
+            return false;
+        if (typeof item.code !== "string" || item.code.length === 0)
+            return false;
+        if (item.severity !== "info" && item.severity !== "warning" && item.severity !== "error") {
+            return false;
+        }
+        if (typeof item.message !== "string" || item.message.length === 0)
+            return false;
+        return item.path === undefined || typeof item.path === "string";
+    });
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=attempt-state.js.map

package/dist/attempt-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt-state.js","sourceRoot":"","sources":["../src/attempt-state.ts"],"names":[],"mappings":"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"}

package/dist/catalog.js

@@ -39,7 +39,7 @@ function selectedCandidates(card, languages, options) {
         rank: languageMatchRank(candidate.language, languages),
     }))
         .filter((entry) => Number.isInteger(entry.rank))
-        .sort((a, b) => a.rank - b.rank || a.index - b.index);
+        .toSorted((a, b) => a.rank - b.rank || a.index - b.index);
     if (languageMatches.length > 0)
         return languageMatches.map((entry) => entry.candidate);
     if (options.includeDefaultFallback === false)