@longsightgroup/qti3-core 0.9.3 → 0.9.5

package/dist/qti-package-zip.js

@@ -0,0 +1,185 @@
+import { normalizePackagePath, pushPackageDiagnostic } from "./qti-package-paths.js";
+/** Read stored ZIP entries and optionally inflate raw DEFLATE entries through caller code. */
+export function readQtiPackageZipEntries(bytes, options, diagnostics) {
+    try {
+        return readZipEntriesUnsafe(bytes, options, diagnostics);
+    }
+    catch {
+        pushPackageDiagnostic(diagnostics, "package.zip.invalid", "error", "QTI package ZIP central directory is malformed.");
+        return [];
+    }
+}
+// Intentionally manual: core's TS lib is ES2023-only (no DOM/Node globals).
+// TextDecoder is available on all supported runtimes, but using it would require
+// widening lib, ambient types, or globalThis casts in this zero-runtime-dependency package.
+/** Decode UTF-8 package entry names and XML payloads. */
+export function decodeUtf8(bytes) {
+    const input = bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf ? bytes.subarray(3) : bytes;
+    let text = "";
+    for (let index = 0; index < input.length;) {
+        const first = input[index];
+        if (first === undefined)
+            break;
+        if (first < 0x80) {
+            text += String.fromCharCode(first);
+            index += 1;
+            continue;
+        }
+        const decoded = decodeUtf8CodePoint(input, index);
+        text += String.fromCodePoint(decoded.codePoint);
+        index += decoded.length;
+    }
+    return text;
+}
+function readZipEntriesUnsafe(bytes, options, diagnostics) {
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const eocdOffset = findEndOfCentralDirectory(view);
+    if (eocdOffset < 0) {
+        pushPackageDiagnostic(diagnostics, "package.zip.centralDirectory.missing", "error", "No ZIP central directory was found.");
+        return [];
+    }
+    const entryCount = view.getUint16(eocdOffset + 10, true);
+    let offset = view.getUint32(eocdOffset + 16, true);
+    const entries = [];
+    for (let index = 0; index < entryCount; index += 1) {
+        if (offset + 46 > view.byteLength) {
+            pushPackageDiagnostic(diagnostics, "package.zip.centralDirectory.truncated", "error", "ZIP central directory ended before all entries could be read.");
+            break;
+        }
+        if (view.getUint32(offset, true) !== 0x02014b50) {
+            pushPackageDiagnostic(diagnostics, "package.zip.centralDirectory.entry", "error", "ZIP central directory entry header is invalid.");
+            break;
+        }
+        const compressionMethod = view.getUint16(offset + 10, true);
+        const compressedSize = view.getUint32(offset + 20, true);
+        const uncompressedSize = view.getUint32(offset + 24, true);
+        const nameLength = view.getUint16(offset + 28, true);
+        const extraLength = view.getUint16(offset + 30, true);
+        const commentLength = view.getUint16(offset + 32, true);
+        const localHeaderOffset = view.getUint32(offset + 42, true);
+        const nameStart = offset + 46;
+        const nameEnd = nameStart + nameLength;
+        if (nameEnd > view.byteLength) {
+            pushPackageDiagnostic(diagnostics, "package.zip.centralDirectory.name", "error", "ZIP central directory entry name is truncated.");
+            break;
+        }
+        const rawName = bytes.slice(nameStart, nameEnd);
+        const decodedName = decodeUtf8(rawName).replaceAll("\\", "/");
+        offset += 46 + nameLength + extraLength + commentLength;
+        if (decodedName.endsWith("/"))
+            continue;
+        const path = normalizePackagePath(decodedName, "ZIP entry", diagnostics);
+        if (!path)
+            continue;
+        const content = zipEntryBytes(bytes, view, {
+            path,
+            compressedSize,
+            uncompressedSize,
+            compressionMethod,
+            localHeaderOffset,
+        }, options, diagnostics);
+        if (content)
+            entries.push({ path, bytes: content });
+    }
+    return entries;
+}
+function zipEntryBytes(bytes, view, entry, options, diagnostics) {
+    if (entry.localHeaderOffset + 30 > view.byteLength) {
+        pushPackageDiagnostic(diagnostics, "package.zip.localHeader.truncated", "error", `ZIP local header for ${entry.path} is truncated.`, entry.path);
+        return undefined;
+    }
+    if (view.getUint32(entry.localHeaderOffset, true) !== 0x04034b50) {
+        pushPackageDiagnostic(diagnostics, "package.zip.localHeader", "error", `ZIP local header for ${entry.path} is invalid.`, entry.path);
+        return undefined;
+    }
+    const nameLength = view.getUint16(entry.localHeaderOffset + 26, true);
+    const extraLength = view.getUint16(entry.localHeaderOffset + 28, true);
+    const dataOffset = entry.localHeaderOffset + 30 + nameLength + extraLength;
+    const dataEnd = dataOffset + entry.compressedSize;
+    if (dataEnd > view.byteLength) {
+        pushPackageDiagnostic(diagnostics, "package.zip.entry.truncated", "error", `ZIP entry ${entry.path} content is truncated.`, entry.path);
+        return undefined;
+    }
+    const compressed = bytes.slice(dataOffset, dataEnd);
+    if (entry.compressionMethod === 0)
+        return compressed;
+    if (entry.compressionMethod === 8) {
+        const inflateRaw = options.inflateRaw;
+        if (!inflateRaw) {
+            pushPackageDiagnostic(diagnostics, "package.zip.entry.compression.unsupported", "error", `ZIP entry ${entry.path} uses DEFLATE compression, but no inflateRaw option was provided.`, entry.path);
+            return undefined;
+        }
+        try {
+            return inflateRaw(compressed, {
+                path: entry.path,
+                compressedSize: entry.compressedSize,
+                uncompressedSize: entry.uncompressedSize,
+                compressionMethod: entry.compressionMethod,
+            });
+        }
+        catch {
+            pushPackageDiagnostic(diagnostics, "package.zip.entry.inflate", "error", `ZIP entry ${entry.path} could not be inflated.`, entry.path);
+            return undefined;
+        }
+    }
+    pushPackageDiagnostic(diagnostics, "package.zip.entry.compression.unsupported", "error", `ZIP entry ${entry.path} uses unsupported compression method ${entry.compressionMethod}.`, entry.path);
+    return undefined;
+}
+function findEndOfCentralDirectory(view) {
+    const minimumOffset = Math.max(0, view.byteLength - 65557);
+    for (let offset = view.byteLength - 22; offset >= minimumOffset; offset -= 1) {
+        if (view.getUint32(offset, true) === 0x06054b50)
+            return offset;
+    }
+    return -1;
+}
+function decodeUtf8CodePoint(bytes, index) {
+    const first = bytes[index];
+    if (first === undefined)
+        return { codePoint: 0xfffd, length: 1 };
+    if (first >= 0xc2 && first <= 0xdf) {
+        const second = bytes[index + 1];
+        if (isUtf8Continuation(second)) {
+            return {
+                codePoint: ((first & 0x1f) << 6) | (second & 0x3f),
+                length: 2,
+            };
+        }
+    }
+    if (first >= 0xe0 && first <= 0xef) {
+        const second = bytes[index + 1];
+        const third = bytes[index + 2];
+        if (isUtf8Continuation(second) &&
+            isUtf8Continuation(third) &&
+            !(first === 0xe0 && second < 0xa0) &&
+            !(first === 0xed && second >= 0xa0)) {
+            return {
+                codePoint: ((first & 0x0f) << 12) | ((second & 0x3f) << 6) | (third & 0x3f),
+                length: 3,
+            };
+        }
+    }
+    if (first >= 0xf0 && first <= 0xf4) {
+        const second = bytes[index + 1];
+        const third = bytes[index + 2];
+        const fourth = bytes[index + 3];
+        if (isUtf8Continuation(second) &&
+            isUtf8Continuation(third) &&
+            isUtf8Continuation(fourth) &&
+            !(first === 0xf0 && second < 0x90) &&
+            !(first === 0xf4 && second >= 0x90)) {
+            return {
+                codePoint: ((first & 0x07) << 18) |
+                    ((second & 0x3f) << 12) |
+                    ((third & 0x3f) << 6) |
+                    (fourth & 0x3f),
+                length: 4,
+            };
+        }
+    }
+    return { codePoint: 0xfffd, length: 1 };
+}
+function isUtf8Continuation(value) {
+    return value !== undefined && value >= 0x80 && value <= 0xbf;
+}
+//# sourceMappingURL=qti-package-zip.js.map

package/dist/qti-package-zip.js.map

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

package/dist/qti-package.d.ts

@@ -0,0 +1,7 @@
+import type { QtiPackageParseResult } from "./qti-package-types.js";
+import { type QtiPackageParseOptions } from "./qti-package-zip.js";
+export type { QtiAssessmentTestItemRef, QtiAssessmentTestPackageModel, QtiManifestFile, QtiManifestResource, QtiPackageAsset, QtiPackageAssetSource, QtiPackageItem, QtiPackageItemSource, QtiPackageParseResult, QtiPackageShape, QtiStandardAlignment, QtiTimingMetadata, } from "./qti-package-types.js";
+export type { QtiPackageInflateContext, QtiPackageInflateRaw, QtiPackageParseOptions, } from "./qti-package-zip.js";
+/** Parse a QTI ZIP package into a neutral manifest, item, asset, and diagnostic model. */
+export declare function parseQtiPackage(bytes: Uint8Array, options?: QtiPackageParseOptions): QtiPackageParseResult;
+//# sourceMappingURL=qti-package.d.ts.map

package/dist/qti-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qti-package.d.ts","sourceRoot":"","sources":["../src/qti-package.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,wBAAwB,EACxB,6BAA6B,EAC7B,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,0FAA0F;AAC1F,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CAIvB"}

package/dist/qti-package.js

@@ -0,0 +1,76 @@
+import { pushPackageDiagnostic } from "./qti-package-paths.js";
+import { collectPackageAssets } from "./qti-package-assets.js";
+import { detectPackageShape, diagnoseManifestDependencyReferences, diagnosePrimaryResourceHrefs, indexManifestResources, isQtiAssessmentTestResource, isQtiItemResource, parseManifestResources, QTI_PACKAGE_MANIFEST_PATH, } from "./qti-package-manifest.js";
+import { itemReferencesForPackageShape, parseAssessmentTestPackageModel, parsePackageItems, } from "./qti-package-items.js";
+import { packageTitle, parseStandardAlignments, primaryTiming, uniqueStandards, } from "./qti-package-metadata.js";
+import { parseXmlFiles, pushXmlDiagnostics } from "./qti-package-xml.js";
+import { readQtiPackageZipEntries, } from "./qti-package-zip.js";
+/** Parse a QTI ZIP package into a neutral manifest, item, asset, and diagnostic model. */
+export function parseQtiPackage(bytes, options = {}) {
+    const diagnostics = [];
+    const entries = readQtiPackageZipEntries(bytes, options, diagnostics);
+    return parseQtiPackageEntries(entries, diagnostics);
+}
+function parseQtiPackageEntries(entries, diagnostics) {
+    const entriesByPath = indexEntries(entries, diagnostics);
+    const xmlFilesByPath = parseXmlFiles(entriesByPath);
+    const manifestXml = xmlFilesByPath.get(QTI_PACKAGE_MANIFEST_PATH);
+    if (!manifestXml) {
+        pushPackageDiagnostic(diagnostics, "package.manifest.missing", "error", "QTI package does not contain imsmanifest.xml.", QTI_PACKAGE_MANIFEST_PATH);
+    }
+    else {
+        pushXmlDiagnostics(manifestXml, diagnostics);
+    }
+    const manifestRoot = manifestXml?.root?.localName === "manifest" ? manifestXml.root : undefined;
+    if (manifestXml?.root && !manifestRoot) {
+        pushPackageDiagnostic(diagnostics, "package.manifest.root", "error", `Expected imsmanifest.xml root manifest, found ${manifestXml.root.localName}.`, QTI_PACKAGE_MANIFEST_PATH);
+    }
+    const manifestResourceRecords = manifestRoot
+        ? parseManifestResources(manifestRoot, entriesByPath, diagnostics)
+        : [];
+    const manifestResources = manifestResourceRecords;
+    const resourcesByIdentifier = indexManifestResources(manifestResourceRecords, diagnostics);
+    diagnoseManifestDependencyReferences(manifestResourceRecords, resourcesByIdentifier, diagnostics);
+    const itemResources = manifestResourceRecords.filter((resource) => isQtiItemResource(resource.type));
+    const assessmentTestResources = manifestResourceRecords.filter((resource) => isQtiAssessmentTestResource(resource.type));
+    diagnosePrimaryResourceHrefs([...itemResources, ...assessmentTestResources], diagnostics);
+    const packageShape = detectPackageShape(itemResources, assessmentTestResources, diagnostics);
+    const assessmentTest = parseAssessmentTestPackageModel(packageShape, assessmentTestResources, entriesByPath, xmlFilesByPath, diagnostics);
+    const itemReferences = itemReferencesForPackageShape(packageShape, itemResources, assessmentTest, diagnostics);
+    const items = parsePackageItems(itemReferences, entriesByPath, xmlFilesByPath, diagnostics);
+    const assets = collectPackageAssets(resourcesByIdentifier, assessmentTest, items, entriesByPath, diagnostics);
+    const manifestStandards = manifestRoot
+        ? parseStandardAlignments(manifestRoot, QTI_PACKAGE_MANIFEST_PATH)
+        : [];
+    const standards = uniqueStandards([
+        ...manifestStandards,
+        ...(assessmentTest?.standards ?? []),
+        ...items.flatMap((item) => item.standards),
+    ]);
+    const timing = primaryTiming(assessmentTest, items);
+    const title = packageTitle(manifestRoot, assessmentTest, items);
+    return {
+        ok: diagnostics.every((diagnostic) => diagnostic.severity !== "error"),
+        title,
+        packageShape,
+        items,
+        assets,
+        manifestResources,
+        assessmentTest,
+        timing,
+        standards,
+        diagnostics,
+    };
+}
+function indexEntries(entries, diagnostics) {
+    const entriesByPath = new Map();
+    for (const entry of entries) {
+        if (entriesByPath.has(entry.path)) {
+            pushPackageDiagnostic(diagnostics, "package.entry.duplicate", "error", `QTI package contains duplicate entry ${entry.path}.`, entry.path);
+            continue;
+        }
+        entriesByPath.set(entry.path, entry);
+    }
+    return entriesByPath;
+}
+//# sourceMappingURL=qti-package.js.map

package/dist/qti-package.js.map

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

package/dist/response-input.d.ts

@@ -0,0 +1,9 @@
+/** One named response variable in record or array wire form. */
+export interface QtiNamedResponseInput {
+    identifier: string;
+    value: unknown;
+}
+export type QtiNamedResponsesInput = Record<string, unknown> | readonly QtiNamedResponseInput[] | undefined;
+/** Normalize record or array response payloads into a stable entry list. */
+export declare function listNamedResponseInputs(responses: QtiNamedResponsesInput): readonly QtiNamedResponseInput[];
+//# sourceMappingURL=response-input.d.ts.map

package/dist/response-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-input.d.ts","sourceRoot":"","sources":["../src/response-input.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,sBAAsB,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,SAAS,qBAAqB,EAAE,GAChC,SAAS,CAAC;AAEd,4EAA4E;AAC5E,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,sBAAsB,GAChC,SAAS,qBAAqB,EAAE,CAIlC"}

package/dist/response-input.js

@@ -0,0 +1,9 @@
+/** Normalize record or array response payloads into a stable entry list. */
+export function listNamedResponseInputs(responses) {
+    if (!responses)
+        return [];
+    if (Array.isArray(responses))
+        return responses;
+    return Object.entries(responses).map(([identifier, value]) => ({ identifier, value }));
+}
+//# sourceMappingURL=response-input.js.map

package/dist/response-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-input.js","sourceRoot":"","sources":["../src/response-input.ts"],"names":[],"mappings":"AAWA,4EAA4E;AAC5E,MAAM,UAAU,uBAAuB,CACrC,SAAiC;IAEjC,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AACzF,CAAC"}

package/dist/response-validation-policy.d.ts

@@ -0,0 +1,31 @@
+import type { QtiChoice, QtiDiagnostic, QtiInteraction, QtiValue } from "./types.js";
+export interface QtiResponseValidationPolicy {
+    checkMinimum: boolean;
+    checkMaximum: boolean;
+    checkMatchMax: boolean;
+}
+export declare function responseIsEmpty(value: QtiValue): boolean;
+export declare function responseCount(value: QtiValue): number;
+/** Order and graphic order ignore max-choices unless min-choices is authored. */
+export declare function orderSubsetLimitsActive(interaction: QtiInteraction): boolean;
+export declare function responseLimitAttribute(interaction: QtiInteraction, choiceKey: "min-choices" | "max-choices", associationKey: "min-associations" | "max-associations"): string | undefined;
+export declare function minimumRequiredResponses(interaction: QtiInteraction | undefined): number;
+export declare function maximumAllowedResponses(interaction: QtiInteraction | undefined): number | undefined;
+export declare function associationMaximumResponses(interaction: QtiInteraction): number | undefined;
+export declare function mediaPlayCount(value: QtiValue): number;
+declare function minimumMediaPlays(interaction: QtiInteraction): number;
+declare function maximumMediaPlays(interaction: QtiInteraction): number | undefined;
+export { maximumMediaPlays, minimumMediaPlays };
+export declare function responseValidationPolicy(declaration: {
+    readonly correctResponse: QtiValue | null;
+}, interaction: QtiInteraction | undefined): QtiResponseValidationPolicy;
+export declare function requiredResponseDiagnostic(responseIdentifier: string, interaction: QtiInteraction | undefined, minimum: number): QtiDiagnostic;
+export declare function maximumResponseDiagnostic(responseIdentifier: string, interaction: QtiInteraction | undefined, maximum: number): QtiDiagnostic;
+export declare function parseUnlimitedMaximum(value: string | undefined): number | undefined;
+export declare function choiceMatchMaximum(choice: QtiChoice): number | undefined;
+export type DirectedPairUseSide = "source" | "target" | "either";
+export declare function directedPairChoiceUseCount(choice: QtiChoice, selectedPairs: string[], side?: DirectedPairUseSide): number;
+export declare function choiceMatchLimitExceeded(choice: QtiChoice, useCount: number): boolean;
+export declare function wouldExceedChoiceMatchMaximum(choice: QtiChoice, selectedPairs: string[], side?: DirectedPairUseSide): boolean;
+export declare function matchMaxDiagnostics(responseIdentifier: string, interaction: QtiInteraction, response: QtiValue): QtiDiagnostic[];
+//# sourceMappingURL=response-validation-policy.d.ts.map

package/dist/response-validation-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-validation-policy.d.ts","sourceRoot":"","sources":["../src/response-validation-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAIrF,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAExD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAErD;AAED,iFAAiF;AACjF,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,cAAc,GAAG,OAAO,CAK5E;AAED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,cAAc,EAC3B,SAAS,EAAE,aAAa,GAAG,aAAa,EACxC,cAAc,EAAE,kBAAkB,GAAG,kBAAkB,GACtD,MAAM,GAAG,SAAS,CAKpB;AAMD,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,CAMxF;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,cAAc,GAAG,SAAS,GACtC,MAAM,GAAG,SAAS,CAapB;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAE3F;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAGtD;AAED,iBAAS,iBAAiB,CAAC,WAAW,EAAE,cAAc,GAAG,MAAM,CAI9D;AAED,iBAAS,iBAAiB,CAAC,WAAW,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAG1E;AAED,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC;AAEhD,wBAAgB,wBAAwB,CACtC,WAAW,EAAE;IAAE,QAAQ,CAAC,eAAe,EAAE,QAAQ,GAAG,IAAI,CAAA;CAAE,EAC1D,WAAW,EAAE,cAAc,GAAG,SAAS,GACtC,2BAA2B,CAyB7B;AAED,wBAAgB,0BAA0B,CACxC,kBAAkB,EAAE,MAAM,EAC1B,WAAW,EAAE,cAAc,GAAG,SAAS,EACvC,OAAO,EAAE,MAAM,GACd,aAAa,CAaf;AAED,wBAAgB,yBAAyB,CACvC,kBAAkB,EAAE,MAAM,EAC1B,WAAW,EAAE,cAAc,GAAG,SAAS,EACvC,OAAO,EAAE,MAAM,GACd,aAAa,CAWf;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAInF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAExE;AAED,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjE,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,MAAM,EAAE,EACvB,IAAI,GAAE,mBAA8B,GACnC,MAAM,CAOR;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGrF;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,MAAM,EAAE,EACvB,IAAI,GAAE,mBAA8B,GACnC,OAAO,CAKT;AAMD,wBAAgB,mBAAmB,CACjC,kBAAkB,EAAE,MAAM,EAC1B,WAAW,EAAE,cAAc,EAC3B,QAAQ,EAAE,QAAQ,GACjB,aAAa,EAAE,CAsBjB"}

package/dist/response-validation-policy.js

@@ -0,0 +1,166 @@
+import { parseNonNegativeInteger } from "./validation-primitives.js";
+import { qtiValueToIdentifierList } from "./value-format.js";
+export function responseIsEmpty(value) {
+    return value === null || value === "" || (Array.isArray(value) && value.length === 0);
+}
+export function responseCount(value) {
+    return responseIsEmpty(value) ? 0 : Array.isArray(value) ? value.length : 1;
+}
+/** Order and graphic order ignore max-choices unless min-choices is authored. */
+export function orderSubsetLimitsActive(interaction) {
+    return ((interaction.type === "order" || interaction.type === "graphicOrder") &&
+        interaction.attributes["min-choices"] !== undefined);
+}
+export function responseLimitAttribute(interaction, choiceKey, associationKey) {
+    if (interaction.type === "order" || interaction.type === "graphicOrder") {
+        return interaction.attributes[choiceKey];
+    }
+    return interaction.attributes[choiceKey] ?? interaction.attributes[associationKey];
+}
+function interactionRequiresResponse(interaction) {
+    return interaction.attributes.required === "true";
+}
+export function minimumRequiredResponses(interaction) {
+    if (!interaction)
+        return 1;
+    if (interaction.type === "media")
+        return minimumMediaPlays(interaction);
+    const explicit = responseLimitAttribute(interaction, "min-choices", "min-associations");
+    if (explicit === undefined)
+        return interactionRequiresResponse(interaction) ? 1 : 0;
+    return parseNonNegativeInteger(explicit) ?? 1;
+}
+export function maximumAllowedResponses(interaction) {
+    if (!interaction)
+        return undefined;
+    if (interaction.type === "media")
+        return maximumMediaPlays(interaction);
+    if ((interaction.type === "order" || interaction.type === "graphicOrder") &&
+        !orderSubsetLimitsActive(interaction)) {
+        return undefined;
+    }
+    const explicit = responseLimitAttribute(interaction, "max-choices", "max-associations");
+    if (explicit === undefined)
+        return undefined;
+    const parsed = parseNonNegativeInteger(explicit);
+    return parsed === undefined || parsed <= 0 ? undefined : parsed;
+}
+export function associationMaximumResponses(interaction) {
+    return interaction.responseCardinality === "single" ? 1 : maximumAllowedResponses(interaction);
+}
+export function mediaPlayCount(value) {
+    const parsed = typeof value === "number" ? value : typeof value === "string" ? Number(value) : 0;
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : 0;
+}
+function minimumMediaPlays(interaction) {
+    const parsed = parseNonNegativeInteger(interaction.attributes["min-plays"]);
+    if (parsed !== undefined)
+        return parsed;
+    return interactionRequiresResponse(interaction) ? 1 : 0;
+}
+function maximumMediaPlays(interaction) {
+    const parsed = parseNonNegativeInteger(interaction.attributes["max-plays"]);
+    return parsed === undefined || parsed <= 0 ? undefined : parsed;
+}
+export { maximumMediaPlays, minimumMediaPlays };
+export function responseValidationPolicy(declaration, interaction) {
+    const authoredMinimum = interaction === undefined
+        ? undefined
+        : responseLimitAttribute(interaction, "min-choices", "min-associations");
+    const minimum = interaction === undefined ? undefined : minimumRequiredResponses(interaction);
+    const validatesMinimum = declaration.correctResponse !== null ||
+        interaction?.type === "media" ||
+        authoredMinimum !== undefined ||
+        (minimum !== undefined && minimum > 0);
+    const maximum = maximumAllowedResponses(interaction);
+    if (declaration.correctResponse === null &&
+        interaction?.type !== "media" &&
+        !validatesMinimum &&
+        maximum === undefined) {
+        return { checkMinimum: false, checkMaximum: false, checkMatchMax: false };
+    }
+    return {
+        checkMinimum: validatesMinimum,
+        checkMaximum: maximum !== undefined,
+        checkMatchMax: interaction !== undefined,
+    };
+}
+export function requiredResponseDiagnostic(responseIdentifier, interaction, minimum) {
+    return {
+        code: "response.required",
+        severity: "error",
+        message: interaction?.attributes["data-min-selections-message"] ??
+            (interaction?.type === "media"
+                ? `${responseIdentifier} requires at least ${minimum} play${minimum === 1 ? "" : "s"}.`
+                : minimum === 1
+                    ? `${responseIdentifier} requires a response.`
+                    : `${responseIdentifier} requires at least ${minimum} responses.`),
+        path: responseIdentifier,
+    };
+}
+export function maximumResponseDiagnostic(responseIdentifier, interaction, maximum) {
+    return {
+        code: "response.maximum",
+        severity: "error",
+        message: interaction?.attributes["data-max-selections-message"] ??
+            (interaction?.type === "media"
+                ? `${responseIdentifier} allows at most ${maximum} play${maximum === 1 ? "" : "s"}.`
+                : `${responseIdentifier} allows at most ${maximum} response${maximum === 1 ? "" : "s"}.`),
+        path: responseIdentifier,
+    };
+}
+export function parseUnlimitedMaximum(value) {
+    if (value === undefined)
+        return undefined;
+    const parsed = parseNonNegativeInteger(value);
+    return parsed === undefined || parsed <= 0 ? undefined : parsed;
+}
+export function choiceMatchMaximum(choice) {
+    return parseUnlimitedMaximum(choice.attributes["match-max"]);
+}
+export function directedPairChoiceUseCount(choice, selectedPairs, side = "either") {
+    return selectedPairs.reduce((count, pair) => {
+        const [source = "", target = ""] = pair.split(/\s+/);
+        if (side === "source")
+            return source === choice.identifier ? count + 1 : count;
+        if (side === "target")
+            return target === choice.identifier ? count + 1 : count;
+        return count + (source === choice.identifier ? 1 : 0) + (target === choice.identifier ? 1 : 0);
+    }, 0);
+}
+export function choiceMatchLimitExceeded(choice, useCount) {
+    const maximum = choiceMatchMaximum(choice);
+    return maximum !== undefined && useCount > maximum;
+}
+export function wouldExceedChoiceMatchMaximum(choice, selectedPairs, side = "either") {
+    return choiceMatchLimitExceeded(choice, directedPairChoiceUseCount(choice, selectedPairs, side) + 1);
+}
+function responseChoiceIdentifiers(response) {
+    return qtiValueToIdentifierList(response).flatMap((value) => value.split(/\s+/).filter(Boolean));
+}
+export function matchMaxDiagnostics(responseIdentifier, interaction, response) {
+    const identifiers = responseChoiceIdentifiers(response);
+    if (identifiers.length === 0)
+        return [];
+    const counts = new Map();
+    for (const identifier of identifiers) {
+        counts.set(identifier, (counts.get(identifier) ?? 0) + 1);
+    }
+    const diagnostics = [];
+    for (const choice of interaction.choices) {
+        const maximum = choiceMatchMaximum(choice);
+        if (maximum === undefined)
+            continue;
+        const count = counts.get(choice.identifier) ?? 0;
+        if (count <= maximum)
+            continue;
+        diagnostics.push({
+            code: "response.matchMax",
+            severity: "error",
+            message: `${choice.text || choice.identifier} may be used at most ${maximum} time${maximum === 1 ? "" : "s"}.`,
+            path: responseIdentifier,
+        });
+    }
+    return diagnostics;
+}
+//# sourceMappingURL=response-validation-policy.js.map

package/dist/response-validation-policy.js.map

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

package/dist/response-validation.d.ts

@@ -0,0 +1,23 @@
+import type { QtiAssessmentItem, QtiDiagnostic } from "./types.js";
+import { type QtiNamedResponseInput } from "./response-input.js";
+export type { QtiNamedResponseInput as QtiResponseVariableInput } from "./response-input.js";
+export type QtiResponseVariablesInput = Record<string, unknown> | readonly QtiNamedResponseInput[];
+export type QtiResponseValidationDiagnosticCode = "response.required" | "response.maximum" | "response.matchMax" | "response.cardinality" | "response.undeclared" | "response.identifier.required" | "response.value.invalid";
+export interface QtiResponseValidationDiagnostic extends QtiDiagnostic {
+    code: QtiResponseValidationDiagnosticCode;
+    identifier?: string | undefined;
+}
+export interface QtiResponseValidationResult {
+    ok: boolean;
+    diagnostics: QtiResponseValidationDiagnostic[];
+}
+export interface QtiResponseValidationInput {
+    item: QtiAssessmentItem;
+    responses: QtiResponseVariablesInput;
+    allowIncompleteResponses?: boolean | undefined;
+    allowedUndeclaredResponseIdentifiers?: readonly string[] | undefined;
+    responseIdentifiers?: Iterable<string> | undefined;
+}
+/** Validate submitted response variables against a parsed QTI assessment item. */
+export declare function validateQtiResponseVariables(input: QtiResponseValidationInput): QtiResponseValidationResult;
+//# sourceMappingURL=response-validation.d.ts.map

package/dist/response-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-validation.d.ts","sourceRoot":"","sources":["../src/response-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAEjB,aAAa,EAId,MAAM,YAAY,CAAC;AAGpB,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAc1F,YAAY,EAAE,qBAAqB,IAAI,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,qBAAqB,EAAE,CAAC;AAEnG,MAAM,MAAM,mCAAmC,GAC3C,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,GACnB,sBAAsB,GACtB,qBAAqB,GACrB,8BAA8B,GAC9B,wBAAwB,CAAC;AAE7B,MAAM,WAAW,+BAAgC,SAAQ,aAAa;IACpE,IAAI,EAAE,mCAAmC,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,+BAA+B,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,yBAAyB,CAAC;IACrC,wBAAwB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/C,oCAAoC,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACrE,mBAAmB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;CACpD;AAED,kFAAkF;AAClF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,0BAA0B,GAChC,2BAA2B,CAyD7B"}