@longsightgroup/qti3-core 0.9.3 → 0.9.4

package/dist/response-validation.js

@@ -0,0 +1,157 @@
+import { assertNever } from "./assert-never.js";
+import { isNullResponse, isRecordValue } from "./processing-values.js";
+import { listNamedResponseInputs } from "./response-input.js";
+import { matchMaxDiagnostics, maximumAllowedResponses, maximumResponseDiagnostic, mediaPlayCount, minimumRequiredResponses, requiredResponseDiagnostic, responseCount, responseValidationPolicy, } from "./response-validation-policy.js";
+import { readQtiJsonValue } from "./value-format.js";
+/** Validate submitted response variables against a parsed QTI assessment item. */
+export function validateQtiResponseVariables(input) {
+    const diagnostics = [];
+    const declaredIdentifiers = new Set(input.item.responseDeclarations.map((declaration) => declaration.identifier));
+    const allowedUndeclaredIdentifiers = new Set(input.allowedUndeclaredResponseIdentifiers ?? []);
+    const responses = ingestSubmittedResponses(input.responses, declaredIdentifiers, allowedUndeclaredIdentifiers, diagnostics);
+    const scopedResponseIdentifiers = input.responseIdentifiers
+        ? new Set(input.responseIdentifiers)
+        : undefined;
+    const interactionsByResponse = indexInteractionsByResponse(input.item.interactions);
+    for (const declaration of input.item.responseDeclarations) {
+        if (scopedResponseIdentifiers !== undefined &&
+            !scopedResponseIdentifiers.has(declaration.identifier)) {
+            continue;
+        }
+        const value = responses.get(declaration.identifier);
+        if (value !== undefined) {
+            validateResponseCardinality(declaration, value, diagnostics);
+        }
+        const interactions = interactionsByResponse.get(declaration.identifier);
+        if (interactions === undefined) {
+            validateDeclarationResponse(declaration, undefined, value, input.allowIncompleteResponses, diagnostics);
+            continue;
+        }
+        for (const interaction of interactions) {
+            validateDeclarationResponse(declaration, interaction, value, input.allowIncompleteResponses, diagnostics);
+        }
+    }
+    return {
+        ok: diagnostics.every((diagnostic) => diagnostic.severity !== "error"),
+        diagnostics,
+    };
+}
+function ingestSubmittedResponses(input, declaredIdentifiers, allowedUndeclaredIdentifiers, diagnostics) {
+    const responses = new Map();
+    for (const entry of listNamedResponseInputs(input)) {
+        const identifier = entry.identifier.trim();
+        if (!identifier) {
+            diagnostics.push({
+                code: "response.identifier.required",
+                severity: "error",
+                message: "Response identifiers must be non-empty strings.",
+            });
+            continue;
+        }
+        const value = readQtiJsonValue(entry.value);
+        if (value === undefined) {
+            diagnostics.push({
+                code: "response.value.invalid",
+                severity: "error",
+                identifier,
+                message: `Response ${identifier} is not a supported QTI value.`,
+                path: identifier,
+            });
+            continue;
+        }
+        if (!declaredIdentifiers.has(identifier)) {
+            if (allowedUndeclaredIdentifiers.has(identifier))
+                continue;
+            diagnostics.push({
+                code: "response.undeclared",
+                severity: "error",
+                identifier,
+                message: `Response ${identifier} is not declared by the assessment item.`,
+                path: identifier,
+            });
+            continue;
+        }
+        responses.set(identifier, value);
+    }
+    return responses;
+}
+function indexInteractionsByResponse(interactions) {
+    const indexed = new Map();
+    for (const interaction of interactions) {
+        const identifier = interaction.responseIdentifier;
+        if (!identifier)
+            continue;
+        const bucket = indexed.get(identifier);
+        if (bucket) {
+            bucket.push(interaction);
+        }
+        else {
+            indexed.set(identifier, [interaction]);
+        }
+    }
+    return indexed;
+}
+function validateResponseCardinality(declaration, value, diagnostics) {
+    if (value === null)
+        return;
+    if (matchesCardinality(declaration.cardinality, value))
+        return;
+    diagnostics.push({
+        code: "response.cardinality",
+        severity: "error",
+        identifier: declaration.identifier,
+        message: `Response ${declaration.identifier} must match ${declaration.cardinality} cardinality.`,
+        path: declaration.identifier,
+        source: declaration.source,
+    });
+}
+function matchesCardinality(cardinality, value) {
+    switch (cardinality) {
+        case "single":
+            return !Array.isArray(value) && !isRecordValue(value);
+        case "multiple":
+        case "ordered":
+            return Array.isArray(value);
+        case "record":
+            return isRecordValue(value);
+    }
+    return assertNever(cardinality);
+}
+function validateDeclarationResponse(declaration, interaction, value, allowIncompleteResponses, diagnostics) {
+    const policy = responseValidationPolicy(declaration, interaction);
+    if (!policy.checkMinimum && !policy.checkMaximum && !policy.checkMatchMax)
+        return;
+    const effectiveValue = value ?? null;
+    const count = interaction?.type === "media" ? mediaPlayCount(effectiveValue) : responseCount(effectiveValue);
+    if (policy.checkMinimum && !allowIncompleteResponses) {
+        const minimum = minimumRequiredResponses(interaction);
+        if (count < minimum) {
+            diagnostics.push(attachResponseIdentifier(declaration.identifier, requiredResponseDiagnostic(declaration.identifier, interaction, minimum)));
+        }
+    }
+    if (policy.checkMaximum && value !== undefined && !isNullResponse(value)) {
+        const maximum = maximumAllowedResponses(interaction);
+        if (maximum !== undefined && count > maximum) {
+            diagnostics.push(attachResponseIdentifier(declaration.identifier, maximumResponseDiagnostic(declaration.identifier, interaction, maximum)));
+        }
+    }
+    if (policy.checkMatchMax && interaction && value !== undefined && !isNullResponse(value)) {
+        diagnostics.push(...matchMaxDiagnostics(declaration.identifier, interaction, value).map((diagnostic) => attachResponseIdentifier(declaration.identifier, diagnostic)));
+    }
+}
+function attachResponseIdentifier(identifier, diagnostic) {
+    if (!isResponseValidationDiagnosticCode(diagnostic.code)) {
+        throw new Error(`Unexpected response validation code: ${diagnostic.code}`);
+    }
+    return { ...diagnostic, identifier, code: diagnostic.code };
+}
+function isResponseValidationDiagnosticCode(code) {
+    return (code === "response.required" ||
+        code === "response.maximum" ||
+        code === "response.matchMax" ||
+        code === "response.cardinality" ||
+        code === "response.undeclared" ||
+        code === "response.identifier.required" ||
+        code === "response.value.invalid");
+}
+//# sourceMappingURL=response-validation.js.map

package/dist/response-validation.js.map

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

package/dist/scoring-disposition-policy.d.ts

@@ -0,0 +1,8 @@
+import type { QtiAssessmentItem } from "./types.js";
+export type QtiItemSubmissionScoringDisposition = "scored" | "manual-scoring-required" | "unscored-reference" | "invalid";
+/** Interaction types that typically require human review even without response processing. */
+export declare function itemHasManuallyScoredInteractions(item: QtiAssessmentItem): boolean;
+export declare function itemNeedsScoringFollowUpWhenUnscored(item: QtiAssessmentItem): boolean;
+/** Default generic disposition taxonomy shipped by qti3-core for submission materialization. */
+export declare function classifyQtiItemScoringDisposition(item: QtiAssessmentItem, score: number | null): Exclude<QtiItemSubmissionScoringDisposition, "invalid">;
+//# sourceMappingURL=scoring-disposition-policy.d.ts.map

package/dist/scoring-disposition-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-disposition-policy.d.ts","sourceRoot":"","sources":["../src/scoring-disposition-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGpD,MAAM,MAAM,mCAAmC,GAC3C,QAAQ,GACR,yBAAyB,GACzB,oBAAoB,GACpB,SAAS,CAAC;AAUd,8FAA8F;AAC9F,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAIlF;AAED,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAErF;AAED,gGAAgG;AAChG,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,OAAO,CAAC,mCAAmC,EAAE,SAAS,CAAC,CAIzD"}

package/dist/scoring-disposition-policy.js

@@ -0,0 +1,24 @@
+import { itemExpectsAutomatedScore } from "./item-scoring-expectation.js";
+const MANUALLY_SCORED_INTERACTION_TYPES = new Set([
+    "custom",
+    "drawing",
+    "extendedText",
+    "portableCustom",
+    "upload",
+]);
+/** Interaction types that typically require human review even without response processing. */
+export function itemHasManuallyScoredInteractions(item) {
+    return item.interactions.some((interaction) => MANUALLY_SCORED_INTERACTION_TYPES.has(interaction.type));
+}
+export function itemNeedsScoringFollowUpWhenUnscored(item) {
+    return itemExpectsAutomatedScore(item) || itemHasManuallyScoredInteractions(item);
+}
+/** Default generic disposition taxonomy shipped by qti3-core for submission materialization. */
+export function classifyQtiItemScoringDisposition(item, score) {
+    if (score !== null)
+        return "scored";
+    if (itemNeedsScoringFollowUpWhenUnscored(item))
+        return "manual-scoring-required";
+    return "unscored-reference";
+}
+//# sourceMappingURL=scoring-disposition-policy.js.map

package/dist/scoring-disposition-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-disposition-policy.js","sourceRoot":"","sources":["../src/scoring-disposition-policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAQ1E,MAAM,iCAAiC,GAAG,IAAI,GAAG,CAAS;IACxD,QAAQ;IACR,SAAS;IACT,cAAc;IACd,gBAAgB;IAChB,QAAQ;CACT,CAAC,CAAC;AAEH,8FAA8F;AAC9F,MAAM,UAAU,iCAAiC,CAAC,IAAuB;IACvE,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAC5C,iCAAiC,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CACxD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC,CAAC,IAAuB;IAC1E,OAAO,yBAAyB,CAAC,IAAI,CAAC,IAAI,iCAAiC,CAAC,IAAI,CAAC,CAAC;AACpF,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,iCAAiC,CAC/C,IAAuB,EACvB,KAAoB;IAEpB,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC;IACpC,IAAI,oCAAoC,CAAC,IAAI,CAAC;QAAE,OAAO,yBAAyB,CAAC;IACjF,OAAO,oBAAoB,CAAC;AAC9B,CAAC"}

package/dist/template-presentation-materializer.d.ts

@@ -0,0 +1,14 @@
+import type { QtiDiagnostic, QtiValue } from "./types.js";
+export interface QtiTemplatePresentationVariables {
+    readonly outcomes: Record<string, QtiValue>;
+    readonly templateValues: Record<string, QtiValue>;
+    readonly responses?: Record<string, QtiValue> | undefined;
+}
+export declare function materializeTemplatePresentation(xml: string, variables: QtiTemplatePresentationVariables): {
+    ok: true;
+    xml: string;
+} | {
+    ok: false;
+    diagnostics: QtiDiagnostic[];
+};
+//# sourceMappingURL=template-presentation-materializer.d.ts.map

package/dist/template-presentation-materializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-presentation-materializer.d.ts","sourceRoot":"","sources":["../src/template-presentation-materializer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAU1D,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC;CAC3D;AAED,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,gCAAgC,GAC1C;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,aAAa,EAAE,CAAA;CAAE,CA4BzE"}

package/dist/template-presentation-materializer.js

@@ -0,0 +1,143 @@
+import { applySourceRangeEdits, parseDeliveryXml, sourceRangeFor, } from "./delivery-redaction.js";
+import { qtiValueToString } from "./value-format.js";
+import { descendants, escapeXmlText } from "./xml.js";
+export function materializeTemplatePresentation(xml, variables) {
+    const parsed = parseDeliveryXml(xml);
+    if (!parsed.root)
+        return { ok: true, xml };
+    const diagnostics = [];
+    const edits = [];
+    const nodes = [parsed.root, ...descendants(parsed.root, () => true)];
+    for (const node of nodes) {
+        if (isInsideTemplateContentNode(node))
+            continue;
+        if (node.localName === "qti-printed-variable") {
+            const edit = printedVariableEdit(node, variables, diagnostics);
+            if (edit)
+                edits.push(edit);
+            continue;
+        }
+        if (node.localName === "qti-template-block" || node.localName === "qti-template-inline") {
+            const edit = templateContentEdit(xml, node, variables, diagnostics);
+            if (edit)
+                edits.push(edit);
+        }
+    }
+    if (diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
+        return { ok: false, diagnostics };
+    }
+    return { ok: true, xml: applySourceRangeEdits(xml, edits) };
+}
+function printedVariableEdit(node, variables, diagnostics) {
+    const text = resolvePrintedVariableText(node, variables, diagnostics);
+    if (text === undefined)
+        return undefined;
+    const range = sourceRangeFor(node)[0];
+    if (!range) {
+        diagnostics.push(unsupportedTemplateMaterializationDiagnostic(node));
+        return undefined;
+    }
+    return { ...range, text };
+}
+function templateContentEdit(xml, node, variables, diagnostics) {
+    const binding = resolveTemplateBlockBinding(node, variables.templateValues, diagnostics);
+    if (!binding)
+        return undefined;
+    const range = sourceRangeFor(node)[0];
+    if (!range) {
+        diagnostics.push(unsupportedTemplateMaterializationDiagnostic(node));
+        return undefined;
+    }
+    return {
+        ...range,
+        text: isTemplateContentVisible(node, binding.value)
+            ? materializedContentXml(xml, node, variables, diagnostics)
+            : "",
+    };
+}
+function resolvePrintedVariableText(node, variables, diagnostics) {
+    const identifier = node.attributes.identifier;
+    if (!identifier) {
+        diagnostics.push(unsupportedTemplateMaterializationDiagnostic(node));
+        return undefined;
+    }
+    const value = resolvePresentationVariable(identifier, variables);
+    if (value === undefined) {
+        diagnostics.push(unsupportedTemplateMaterializationDiagnostic(node));
+        return undefined;
+    }
+    return escapeXmlText(qtiValueToString(value));
+}
+function resolvePresentationVariable(identifier, variables) {
+    return (variables.outcomes[identifier] ??
+        variables.templateValues[identifier] ??
+        variables.responses?.[identifier]);
+}
+function resolveTemplateBlockBinding(node, templateValues, diagnostics) {
+    const templateIdentifier = node.attributes["template-identifier"];
+    const identifier = node.attributes.identifier;
+    if (!templateIdentifier || !identifier || templateValues[templateIdentifier] === undefined) {
+        diagnostics.push(unsupportedTemplateMaterializationDiagnostic(node));
+        return undefined;
+    }
+    return { templateIdentifier, identifier, value: templateValues[templateIdentifier] };
+}
+function materializedContentXml(xml, node, variables, diagnostics) {
+    return node.content
+        .map((child) => {
+        if (typeof child === "string")
+            return escapeXmlText(child);
+        if (child.localName === "qti-printed-variable") {
+            return resolvePrintedVariableText(child, variables, diagnostics) ?? "";
+        }
+        if (child.localName === "qti-template-block" || child.localName === "qti-template-inline") {
+            return materializedNestedTemplateContentXml(xml, child, variables, diagnostics);
+        }
+        return materializedElementXml(xml, child, variables, diagnostics);
+    })
+        .join("");
+}
+function materializedNestedTemplateContentXml(xml, node, variables, diagnostics) {
+    const binding = resolveTemplateBlockBinding(node, variables.templateValues, diagnostics);
+    if (!binding)
+        return "";
+    return isTemplateContentVisible(node, binding.value)
+        ? materializedContentXml(xml, node, variables, diagnostics)
+        : "";
+}
+function isTemplateContentVisible(node, value) {
+    const identifier = node.attributes.identifier;
+    const hasIdentifier = Array.isArray(value)
+        ? value.map(String).includes(identifier ?? "")
+        : qtiValueToString(value) === identifier;
+    return node.attributes["show-hide"] === "hide" ? !hasIdentifier : hasIdentifier;
+}
+function materializedElementXml(xml, node, variables, diagnostics) {
+    if (node.sourceRange.endOffset === undefined || node.endSource === undefined) {
+        diagnostics.push(unsupportedTemplateMaterializationDiagnostic(node));
+        return "";
+    }
+    const startTag = xml.slice(node.sourceRange.startOffset, node.sourceRange.startTagEndOffset + 1);
+    const endTag = xml.slice(node.endSource.offset, node.sourceRange.endOffset);
+    return `${startTag}${materializedContentXml(xml, node, variables, diagnostics)}${endTag}`;
+}
+function isInsideTemplateContentNode(node) {
+    let parent = node.parent;
+    while (parent) {
+        if (parent.localName === "qti-template-block" || parent.localName === "qti-template-inline") {
+            return true;
+        }
+        parent = parent.parent;
+    }
+    return false;
+}
+function unsupportedTemplateMaterializationDiagnostic(node) {
+    return {
+        code: "adaptiveTurn.materialization.unsupported",
+        severity: "error",
+        message: `${node.name} could not be materialized from authoritative template state.`,
+        path: node.source.path,
+        source: node.source,
+    };
+}
+//# sourceMappingURL=template-presentation-materializer.js.map

package/dist/template-presentation-materializer.js.map

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

package/dist/trusted-item-session.d.ts

@@ -1,11 +1,9 @@
-import type { QtiAttemptStateV1, QtiAttemptStatus, QtiDiagnostic, QtiPortableCustomStateValue, QtiValue } from "./types.js";
-export type QtiTrustedInputDiagnosticPrefix = "serverScoring" | "adaptiveTurn";
-export interface QtiTrustedResponseInput {
-    identifier: string;
-    value: unknown;
-}
-export type QtiTrustedResponsesInput = Record<string, unknown> | readonly QtiTrustedResponseInput[] | undefined;
-/** Trusted candidate responses and portable custom interaction state for one application. */
+import type { QtiAttemptStateV1, QtiAttemptStatus, QtiDiagnostic, QtiDocument, QtiPortableCustomStateValue, QtiValue } from "./types.js";
+import { type QtiNamedResponseInput, type QtiNamedResponsesInput } from "./response-input.js";
+export type QtiTrustedResponseInput = QtiNamedResponseInput;
+export type QtiTrustedResponsesInput = QtiNamedResponsesInput;
+export type QtiTrustedInputDiagnosticPrefix = "serverScoring" | "adaptiveTurn" | "itemSubmission";
+export type QtiTrustedSubmissionValidation = "trusted" | "strict";
 export interface QtiTrustedResponseApplication {
     trustedResponses?: QtiTrustedResponsesInput;
     trustedInteractionStates?: Record<string, QtiPortableCustomStateValue> | undefined;
@@ -13,9 +11,15 @@ export interface QtiTrustedResponseApplication {
 export interface QtiTrustedItemParseOptions {
     allowedUndeclaredResponseIdentifiers?: readonly string[] | undefined;
 }
+export interface QtiTrustedItemDocument {
+    document: QtiDocument;
+    diagnostics: QtiDiagnostic[];
+    responseIdentifiers: Set<string>;
+}
 export type QtiTrustedItemScoringPolicy = "always" | "onSubmission";
 export interface RunTrustedItemSessionInput extends QtiTrustedItemParseOptions {
     itemXml: string;
+    parsedItem?: QtiTrustedItemDocument | undefined;
     diagnosticPrefix: QtiTrustedInputDiagnosticPrefix;
     submission: QtiTrustedResponseApplication;
     priorState?: QtiAttemptStateV1 | null | undefined;
@@ -23,6 +27,12 @@ export interface RunTrustedItemSessionInput extends QtiTrustedItemParseOptions {
     attemptStatus?: QtiAttemptStatus | undefined;
     scoring: QtiTrustedItemScoringPolicy;
     requireNumericScore: boolean;
+    /**
+     * `strict` rejects undeclared and malformed responses before trusted application.
+     * `trusted` keeps the legacy warning path for undeclared identifiers.
+     */
+    submissionValidation?: QtiTrustedSubmissionValidation | undefined;
+    allowIncompleteResponses?: boolean | undefined;
 }
 export interface RunTrustedItemSessionSuccess {
     ok: true;
@@ -45,5 +55,12 @@ export declare function readPriorAttemptState(priorState: unknown, diagnosticPre
     state: QtiAttemptStateV1 | null;
     diagnostics: QtiDiagnostic[];
 };
+export declare function parseTrustedItemDocument(itemXml: string, allowedUndeclaredResponseIdentifiers?: readonly string[]): {
+    ok: true;
+    parsed: QtiTrustedItemDocument;
+} | {
+    ok: false;
+    diagnostics: QtiDiagnostic[];
+};
 export declare function runTrustedItemSession(input: RunTrustedItemSessionInput): RunTrustedItemSessionResult;
 //# sourceMappingURL=trusted-item-session.d.ts.map

package/dist/trusted-item-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trusted-item-session.d.ts","sourceRoot":"","sources":["../src/trusted-item-session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EAEb,2BAA2B,EAC3B,QAAQ,EACT,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,+BAA+B,GAAG,eAAe,GAAG,cAAc,CAAC;AAE/E,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,wBAAwB,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,SAAS,uBAAuB,EAAE,GAClC,SAAS,CAAC;AAEd,6FAA6F;AAC7F,MAAM,WAAW,6BAA6B;IAC5C,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IAC5C,wBAAwB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,GAAG,SAAS,CAAC;CACpF;AAED,MAAM,WAAW,0BAA0B;IACzC,oCAAoC,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACtE;AAQD,MAAM,MAAM,2BAA2B,GAAG,QAAQ,GAAG,cAAc,CAAC;AAEpE,MAAM,WAAW,0BAA2B,SAAQ,0BAA0B;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,+BAA+B,CAAC;IAClD,UAAU,EAAE,6BAA6B,CAAC;IAC1C,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC;IAClD,uFAAuF;IACvF,aAAa,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC7C,OAAO,EAAE,2BAA2B,CAAC;IACrC,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,IAAI,CAAC;IACT,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,KAAK,EAAE,iBAAiB,CAAC;IACzB,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;CACtB;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,KAAK,CAAC;IACV,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;CACtB;AAED,MAAM,MAAM,2BAA2B,GACnC,4BAA4B,GAC5B,4BAA4B,CAAC;AAEjC,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,OAAO,EACnB,gBAAgB,EAAE,+BAA+B,GAChD;IAAE,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,aAAa,EAAE,CAAA;CAAE,CAanE;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAChC,2BAA2B,CAiG7B"}
+{"version":3,"file":"trusted-item-session.d.ts","sourceRoot":"","sources":["../src/trusted-item-session.ts"],"names":[],"mappings":"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"}

package/dist/trusted-item-session.js

@@ -1,6 +1,9 @@
 import { parseQtiXml } from "./parser.js";
+import { itemExpectsAutomatedScore } from "./item-scoring-expectation.js";
+import { validateQtiResponseVariables } from "./response-validation.js";
 import { createItemSession, isQtiAttemptStateV1 } from "./session.js";
 import { isQtiPortableCustomStateValue, readQtiJsonValue } from "./value-format.js";
+import { listNamedResponseInputs, } from "./response-input.js";
 export function readPriorAttemptState(priorState, diagnosticPrefix) {
     if (priorState === undefined || priorState === null)
         return { state: null, diagnostics: [] };
@@ -12,13 +15,46 @@ export function readPriorAttemptState(priorState, diagnosticPrefix) {
             {
                 code: `${diagnosticPrefix}.state.value`,
                 severity: "error",
-                message: "Prior adaptive turn state is not a valid qti3.attempt-state.v1 value.",
+                message: "Prior attempt state is not a valid qti3.attempt-state.v1 value.",
             },
         ],
     };
 }
+export function parseTrustedItemDocument(itemXml, allowedUndeclaredResponseIdentifiers = []) {
+    let parsed;
+    try {
+        parsed = parseQtiXml(itemXml);
+    }
+    catch (error) {
+        return {
+            ok: false,
+            diagnostics: [
+                {
+                    code: "xml.parse",
+                    severity: "error",
+                    message: error instanceof Error ? error.message : String(error),
+                },
+            ],
+        };
+    }
+    const allowedUndeclared = new Set(allowedUndeclaredResponseIdentifiers);
+    const diagnostics = parsed.diagnostics.filter((diagnostic) => !isAllowedUndeclaredVariableReference(diagnostic, allowedUndeclared));
+    if (!parsed.document || diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
+        return { ok: false, diagnostics };
+    }
+    return {
+        ok: true,
+        parsed: {
+            document: parsed.document,
+            diagnostics,
+            responseIdentifiers: new Set(parsed.document.item.responseDeclarations.map((declaration) => declaration.identifier)),
+        },
+    };
+}
 export function runTrustedItemSession(input) {
-    const parsedResult = parseTrustedItemXml(input.itemXml, input.allowedUndeclaredResponseIdentifiers);
+    const parsedResult = input.parsedItem
+        ? { ok: true, parsed: input.parsedItem }
+        : parseTrustedItemDocument(input.itemXml, input.allowedUndeclaredResponseIdentifiers);
     if (!parsedResult.ok) {
         return emptyTrustedItemSessionFailure(parsedResult.diagnostics);
     }
@@ -28,6 +64,17 @@ export function runTrustedItemSession(input) {
     }
     if (input.attemptStatus)
         sessionResult.session.setStatus(input.attemptStatus);
+    if (input.submissionValidation === "strict") {
+        const validation = validateQtiResponseVariables({
+            item: parsedResult.parsed.document.item,
+            responses: input.submission.trustedResponses ?? {},
+            allowIncompleteResponses: input.allowIncompleteResponses,
+            allowedUndeclaredResponseIdentifiers: input.allowedUndeclaredResponseIdentifiers,
+        });
+        if (!validation.ok) {
+            return emptyTrustedItemSessionFailure(validation.diagnostics);
+        }
+    }
     const applicationResult = applyTrustedResponseApplication(sessionResult.session, parsedResult.parsed, input.submission, input.allowedUndeclaredResponseIdentifiers, input.diagnosticPrefix);
     const diagnostics = applicationResult.diagnostics;
     if (diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
@@ -56,7 +103,7 @@ export function runTrustedItemSession(input) {
             });
         }
         if (input.requireNumericScore &&
-            shouldRequireNumericScore(parsedResult.parsed.document.item) &&
+            itemExpectsAutomatedScore(parsedResult.parsed.document.item) &&
             score === null) {
             return emptyTrustedItemSessionFailure([...scoredDiagnostics, missingNumericScoreDiagnostic(input.diagnosticPrefix)], {
                 state,
@@ -90,37 +137,6 @@ function emptyTrustedItemSessionFailure(diagnostics, partial = {}) {
         score: partial.score ?? null,
     };
 }
-function parseTrustedItemXml(itemXml, allowedUndeclaredResponseIdentifiers = []) {
-    let parsed;
-    try {
-        parsed = parseQtiXml(itemXml);
-    }
-    catch (error) {
-        return {
-            ok: false,
-            diagnostics: [
-                {
-                    code: "xml.parse",
-                    severity: "error",
-                    message: error instanceof Error ? error.message : String(error),
-                },
-            ],
-        };
-    }
-    const allowedUndeclared = new Set(allowedUndeclaredResponseIdentifiers);
-    const diagnostics = parsed.diagnostics.filter((diagnostic) => !isAllowedUndeclaredVariableReference(diagnostic, allowedUndeclared));
-    if (!parsed.document || diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
-        return { ok: false, diagnostics };
-    }
-    return {
-        ok: true,
-        parsed: {
-            document: parsed.document,
-            diagnostics,
-            responseIdentifiers: new Set(parsed.document.item.responseDeclarations.map((declaration) => declaration.identifier)),
-        },
-    };
-}
 function createTrustedItemSession(parsed, priorState, diagnosticPrefix, allowedUndeclaredResponseIdentifiers, existingDiagnostics = []) {
     try {
         return {
@@ -148,7 +164,7 @@ function applyTrustedResponseApplication(session, parsed, submission, allowedUnd
     const diagnostics = [...parsed.diagnostics];
     const allowedUndeclared = new Set(allowedUndeclaredResponseIdentifiers ?? []);
     let appliedSubmission = false;
-    for (const response of normalizeResponseInputs(submission.trustedResponses)) {
+    for (const response of listNamedResponseInputs(submission.trustedResponses)) {
         const identifier = response.identifier.trim();
         if (!identifier) {
             diagnostics.push({
@@ -219,10 +235,6 @@ function scoreTrustedItemSession(session, diagnostics, diagnosticPrefix) {
         };
     }
 }
-function shouldRequireNumericScore(item) {
-    return (Boolean(item.responseProcessing) ||
-        item.outcomeDeclarations.some((declaration) => declaration.identifier === "SCORE"));
-}
 function readNumericScore(value) {
     if (typeof value === "number" && Number.isFinite(value))
         return value;
@@ -245,13 +257,6 @@ function stripUndeclaredResponses(state, declaredResponseIdentifiers) {
         responses: Object.fromEntries(Object.entries(state.responses).filter(([identifier]) => declaredResponseIdentifiers.has(identifier))),
     };
 }
-function normalizeResponseInputs(responses) {
-    if (!responses)
-        return [];
-    if (Array.isArray(responses))
-        return [...responses];
-    return Object.entries(responses).map(([identifier, value]) => ({ identifier, value }));
-}
 function isAllowedUndeclaredVariableReference(diagnostic, allowedUndeclaredResponseIdentifiers) {
     if (diagnostic.code !== "processing.variable.reference")
         return false;