@longsightgroup/qti3-core 0.11.0 → 0.12.0

package/dist/test-expression-validation.js.map

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

package/dist/test-expression.d.ts

@@ -0,0 +1,99 @@
+import type { QtiSourceLocation } from "./types.js";
+/** Scalar types supported by deterministic test outcome processing. */
+export type QtiTestBaseType = "integer" | "float" | "boolean" | "string" | "identifier";
+/** Test expressions form a closed language, independent of item processing. */
+export type QtiTestExpression = ({
+    readonly type: "baseValue";
+    readonly baseType: QtiTestBaseType;
+    readonly value: number | boolean | string;
+} | {
+    readonly type: "variable";
+    readonly identifier: string;
+} | {
+    readonly type: "testVariables";
+    readonly variableIdentifier: string;
+    readonly includeCategory?: string | undefined;
+} | {
+    readonly type: "sum";
+    readonly expressions: readonly QtiTestExpression[];
+} | {
+    readonly type: "and";
+    readonly expressions: readonly QtiTestExpression[];
+} | {
+    readonly type: "or";
+    readonly expressions: readonly QtiTestExpression[];
+} | {
+    readonly type: "numericCompare";
+    readonly operator: "gt" | "gte" | "lt" | "lte";
+    readonly left: QtiTestExpression;
+    readonly right: QtiTestExpression;
+} | {
+    readonly type: "not";
+    readonly expression: QtiTestExpression;
+}) & {
+    readonly source?: QtiSourceLocation | undefined;
+};
+/** XML names, AST variants, arities and attributes owned by the test language. */
+export declare const testExpressionSyntax: readonly [{
+    readonly name: "qti-base-value";
+    readonly type: "baseValue";
+    readonly arity: 0;
+    readonly attributes: readonly ["base-type"];
+}, {
+    readonly name: "qti-variable";
+    readonly type: "variable";
+    readonly arity: 0;
+    readonly attributes: readonly ["identifier"];
+}, {
+    readonly name: "qti-test-variables";
+    readonly type: "testVariables";
+    readonly arity: 0;
+    readonly attributes: readonly ["variable-identifier", "include-category"];
+}, {
+    readonly name: "qti-sum";
+    readonly type: "sum";
+    readonly arity: "oneOrMore";
+    readonly attributes: readonly [];
+}, {
+    readonly name: "qti-gt";
+    readonly type: "numericCompare";
+    readonly operator: "gt";
+    readonly arity: 2;
+    readonly attributes: readonly [];
+}, {
+    readonly name: "qti-gte";
+    readonly type: "numericCompare";
+    readonly operator: "gte";
+    readonly arity: 2;
+    readonly attributes: readonly [];
+}, {
+    readonly name: "qti-lt";
+    readonly type: "numericCompare";
+    readonly operator: "lt";
+    readonly arity: 2;
+    readonly attributes: readonly [];
+}, {
+    readonly name: "qti-lte";
+    readonly type: "numericCompare";
+    readonly operator: "lte";
+    readonly arity: 2;
+    readonly attributes: readonly [];
+}, {
+    readonly name: "qti-and";
+    readonly type: "and";
+    readonly arity: "oneOrMore";
+    readonly attributes: readonly [];
+}, {
+    readonly name: "qti-or";
+    readonly type: "or";
+    readonly arity: "oneOrMore";
+    readonly attributes: readonly [];
+}, {
+    readonly name: "qti-not";
+    readonly type: "not";
+    readonly arity: 1;
+    readonly attributes: readonly [];
+}];
+/** Refine a supported test scalar type without accepting item-only base types. */
+export declare function isTestBaseType(value: string | undefined): value is QtiTestBaseType;
+//# sourceMappingURL=test-expression.d.ts.map

package/dist/test-expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-expression.d.ts","sourceRoot":"","sources":["../src/test-expression.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,uEAAuE;AACvE,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC;AAExF,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GAAG,CAC5B;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CAC3C,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1D;IACE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/C,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAAE,GAC5E;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAAE,GAC5E;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAAE,GAC3E;IACE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;CACnC,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,CACnE,GAAG;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;CAAE,CAAC;AAExD,kFAAkF;AAClF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuB9B,CAAC;AAEJ,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,eAAe,CAQlF"}

package/dist/test-expression.js

@@ -0,0 +1,28 @@
+/** XML names, AST variants, arities and attributes owned by the test language. */
+export const testExpressionSyntax = [
+    { name: "qti-base-value", type: "baseValue", arity: 0, attributes: ["base-type"] },
+    { name: "qti-variable", type: "variable", arity: 0, attributes: ["identifier"] },
+    {
+        name: "qti-test-variables",
+        type: "testVariables",
+        arity: 0,
+        attributes: ["variable-identifier", "include-category"],
+    },
+    { name: "qti-sum", type: "sum", arity: "oneOrMore", attributes: [] },
+    { name: "qti-gt", type: "numericCompare", operator: "gt", arity: 2, attributes: [] },
+    { name: "qti-gte", type: "numericCompare", operator: "gte", arity: 2, attributes: [] },
+    { name: "qti-lt", type: "numericCompare", operator: "lt", arity: 2, attributes: [] },
+    { name: "qti-lte", type: "numericCompare", operator: "lte", arity: 2, attributes: [] },
+    { name: "qti-and", type: "and", arity: "oneOrMore", attributes: [] },
+    { name: "qti-or", type: "or", arity: "oneOrMore", attributes: [] },
+    { name: "qti-not", type: "not", arity: 1, attributes: [] },
+];
+/** Refine a supported test scalar type without accepting item-only base types. */
+export function isTestBaseType(value) {
+    return (value === "integer" ||
+        value === "float" ||
+        value === "boolean" ||
+        value === "string" ||
+        value === "identifier");
+}
+//# sourceMappingURL=test-expression.js.map

package/dist/test-expression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-expression.js","sourceRoot":"","sources":["../src/test-expression.ts"],"names":[],"mappings":"AA8BA,kFAAkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE;IAClF,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,YAAY,CAAC,EAAE;IAChF;QACE,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,CAAC;QACR,UAAU,EAAE,CAAC,qBAAqB,EAAE,kBAAkB,CAAC;KACxD;IACD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE;IACpE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;IACpF,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;IACtF,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;IACpF,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;IACtF,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE;IACpE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE;IAClE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;CAOzD,CAAC;AAEJ,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,KAAyB;IACtD,OAAO,CACL,KAAK,KAAK,SAAS;QACnB,KAAK,KAAK,OAAO;QACjB,KAAK,KAAK,SAAS;QACnB,KAAK,KAAK,QAAQ;QAClB,KAAK,KAAK,YAAY,CACvB,CAAC;AACJ,CAAC"}

package/dist/test-model.d.ts

@@ -0,0 +1,62 @@
+import type { QtiDiagnostic, QtiOutcomeDeclaration } from "./types.js";
+import type { QtiTestBaseType, QtiTestExpression } from "./test-expression.js";
+/** An ordered branch evaluated after the section's final item submission. */
+export interface QtiTestBranch {
+    readonly target: string;
+    readonly expression: QtiTestExpression;
+}
+/** A fixed item reference; categories participate in test-variable aggregation. */
+export interface QtiTestItemRef {
+    readonly identifier: string;
+    readonly href: string;
+    readonly categories: readonly string[];
+}
+/** A flat section in the supported linear, individually submitted test profile. */
+export interface QtiTestSection {
+    readonly identifier: string;
+    readonly title: string;
+    readonly items: readonly QtiTestItemRef[];
+    readonly branches: readonly QtiTestBranch[];
+}
+/** Framework-neutral QTI test definition. Validation establishes executable support. */
+export interface QtiTestDefinition {
+    readonly identifier: string;
+    readonly title: string;
+    readonly partIdentifier: string;
+    readonly sections: readonly QtiTestSection[];
+    readonly outcomeDeclarations: readonly QtiOutcomeDeclaration[];
+    readonly outcomeProcessing: readonly QtiTestOutcomeRule[];
+}
+/** Sequential assignment of a test expression to a declared test outcome. */
+export interface QtiTestOutcomeRule {
+    readonly type: "setOutcomeValue";
+    readonly identifier: string;
+    readonly expression: QtiTestExpression;
+}
+type ExecutableSection = QtiTestSection & {
+    readonly items: readonly [QtiTestItemRef, ...QtiTestItemRef[]];
+};
+type ExecutableOutcome = Readonly<QtiOutcomeDeclaration> & {
+    readonly cardinality: "single";
+    readonly baseType: QtiTestBaseType;
+    readonly defaultValue: number | boolean | string | null;
+};
+declare const executableTest: unique symbol;
+/** A test checked for supported expressions, unique identifiers and forward routing. */
+export type QtiExecutableTest = Omit<QtiTestDefinition, "sections" | "outcomeDeclarations"> & {
+    readonly [executableTest]: true;
+    readonly sections: readonly [ExecutableSection, ...ExecutableSection[]];
+    readonly outcomeDeclarations: readonly ExecutableOutcome[];
+};
+/** Typed failure channel shared by test construction, parsing and transitions. */
+export type QtiTestResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly diagnostics: readonly QtiDiagnostic[];
+};
+/** Construct a safe test diagnostic without including submitted content. */
+export declare function testFailure(code: string, message: string): QtiTestResult<never>;
+export {};
+//# sourceMappingURL=test-model.d.ts.map

package/dist/test-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-model.d.ts","sourceRoot":"","sources":["../src/test-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;CACxC;AAED,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED,wFAAwF;AACxF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,QAAQ,CAAC,mBAAmB,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC/D,QAAQ,CAAC,iBAAiB,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC3D;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;CACxC;AAED,KAAK,iBAAiB,GAAG,cAAc,GAAG;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,cAAc,EAAE,GAAG,cAAc,EAAE,CAAC,CAAC;CAChE,CAAC;AACF,KAAK,iBAAiB,GAAG,QAAQ,CAAC,qBAAqB,CAAC,GAAG;IACzD,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;CACzD,CAAC;AAEF,OAAO,CAAC,MAAM,cAAc,EAAE,OAAO,MAAM,CAAC;AAE5C,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,qBAAqB,CAAC,GAAG;IAC5F,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAAC,CAAC;IACxE,QAAQ,CAAC,mBAAmB,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC5D,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,aAAa,CAAC,CAAC,IACvB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,aAAa,EAAE,CAAA;CAAE,CAAC;AAE3E,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAE/E"}

package/dist/test-model.js

@@ -0,0 +1,5 @@
+/** Construct a safe test diagnostic without including submitted content. */
+export function testFailure(code, message) {
+    return { ok: false, diagnostics: [{ code: `test.${code}`, severity: "error", message }] };
+}
+//# sourceMappingURL=test-model.js.map

package/dist/test-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-model.js","sourceRoot":"","sources":["../src/test-model.ts"],"names":[],"mappings":"AAgEA,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAAe;IACvD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AAC5F,CAAC"}

package/dist/test-parser.d.ts

@@ -0,0 +1,13 @@
+import { type QtiExecutableTest, type QtiTestResult } from "./test-model.js";
+/** Whether a test requires runtime selection rather than ordinary fixed navigation. */
+export type QtiTestExecution = {
+    readonly kind: "fixed";
+} | {
+    readonly kind: "sequenced";
+    readonly test: QtiExecutableTest;
+};
+/** Classify sequencing on the parsed tree and reject unsupported executable routes. */
+export declare function parseQtiTestExecution(xml: string): QtiTestResult<QtiTestExecution>;
+/** Parse the supported executable test profile; never silently ignore routing features. */
+export declare function parseQtiTest(xml: string): QtiTestResult<QtiExecutableTest>;
+//# sourceMappingURL=test-parser.d.ts.map

package/dist/test-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-parser.d.ts","sourceRoot":"","sources":["../src/test-parser.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,iBAAiB,EAGtB,KAAK,aAAa,EAEnB,MAAM,iBAAiB,CAAC;AAGzB,uFAAuF;AACvF,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAErE,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAMlF;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAG1E"}

package/dist/test-parser.js

@@ -0,0 +1,144 @@
+import { parseOutcomeDeclaration } from "./parser-declarations.js";
+import { QTI_ASI_NAMESPACE } from "./qti-namespaces.js";
+import { parseXmlTree } from "./xml.js";
+import { validateQtiTest } from "./test-validation.js";
+import { parseTestExpressionChild } from "./test-expression-parser.js";
+import { testExpressionSyntax } from "./test-expression.js";
+import { checkTestXml, rejectTestXml } from "./test-xml.js";
+import { testFailure, } from "./test-model.js";
+/** Classify sequencing on the parsed tree and reject unsupported executable routes. */
+export function parseQtiTestExecution(xml) {
+    const parsed = parseTestRoot(xml);
+    if (!parsed.ok)
+        return parsed;
+    if (!requiresSequence(parsed.value))
+        return { ok: true, value: { kind: "fixed" } };
+    const result = parseTestDefinition(parsed.value);
+    return result.ok ? { ok: true, value: { kind: "sequenced", test: result.value } } : result;
+}
+/** Parse the supported executable test profile; never silently ignore routing features. */
+export function parseQtiTest(xml) {
+    const parsed = parseTestRoot(xml);
+    return parsed.ok ? parseTestDefinition(parsed.value) : parsed;
+}
+function parseTestRoot(xml) {
+    const { root, errors } = parseXmlTree(xml);
+    if (errors.length ||
+        !root ||
+        root.localName !== "qti-assessment-test" ||
+        root.uri !== QTI_ASI_NAMESPACE)
+        return testFailure("xml", "Expected a well-formed QTI 3 assessment test.");
+    return { ok: true, value: root };
+}
+function requiresSequence(node) {
+    return ((node.uri === QTI_ASI_NAMESPACE &&
+        [
+            "qti-branch-rule",
+            "qti-pre-condition",
+            "qti-selection",
+            "qti-ordering",
+            "qti-adaptive-selection",
+        ].includes(node.localName)) ||
+        node.children.some(requiresSequence));
+}
+function parseTestDefinition(root) {
+    const diagnostics = [];
+    checkTestXml(root, ["qti-outcome-declaration", "qti-test-part", "qti-outcome-processing"], ["identifier", "title", "tool-name", "tool-version"], diagnostics);
+    const part = parseTestPart(root, diagnostics);
+    if (!part.ok)
+        return part;
+    const declarations = root.children
+        .filter((node) => node.localName === "qti-outcome-declaration")
+        .map((node) => parseTestDeclaration(node, diagnostics));
+    const sections = part.value.children
+        .filter((node) => node.localName === "qti-assessment-section")
+        .map((node) => parseTestSection(node, diagnostics));
+    const rules = parseTestOutcomeProcessing(root, diagnostics);
+    if (diagnostics.length)
+        return { ok: false, diagnostics };
+    return validateQtiTest({
+        identifier: root.attributes.identifier ?? "",
+        title: root.attributes.title ?? "",
+        partIdentifier: part.value.attributes.identifier ?? "",
+        sections,
+        outcomeDeclarations: declarations,
+        outcomeProcessing: rules,
+    });
+}
+function parseTestPart(root, diagnostics) {
+    const parts = root.children.filter((node) => node.localName === "qti-test-part");
+    const part = parts[0];
+    if (parts.length !== 1 ||
+        !part ||
+        part.attributes["navigation-mode"] !== "linear" ||
+        part.attributes["submission-mode"] !== "individual")
+        return testFailure("mode", "Executable tests require one linear part with individual submission.");
+    checkTestXml(part, ["qti-assessment-section"], ["identifier", "navigation-mode", "submission-mode"], diagnostics);
+    return { ok: true, value: part };
+}
+function parseTestDeclaration(node, diagnostics) {
+    if (node.attributes.cardinality !== "single" || node.children.length > 1)
+        rejectTestXml(node, diagnostics);
+    checkTestXml(node, ["qti-default-value"], ["identifier", "cardinality", "base-type"], diagnostics);
+    for (const value of node.children) {
+        checkTestXml(value, ["qti-value"], [], diagnostics);
+        if (value.children.length !== 1)
+            rejectTestXml(value, diagnostics);
+        for (const scalar of value.children)
+            checkTestXml(scalar, [], [], diagnostics, true);
+    }
+    return parseOutcomeDeclaration(node, diagnostics);
+}
+function parseTestSection(section, diagnostics) {
+    checkTestXml(section, ["qti-assessment-item-ref", "qti-branch-rule"], ["identifier", "title", "visible", "keep-together"], diagnostics);
+    if (!["true", "1"].includes(section.attributes.visible ?? "") ||
+        (section.attributes["keep-together"] !== undefined &&
+            !["true", "1"].includes(section.attributes["keep-together"])))
+        rejectTestXml(section, diagnostics);
+    const branches = [];
+    for (const branch of section.children.filter((node) => node.localName === "qti-branch-rule")) {
+        checkTestXml(branch, testExpressionSyntax.map((syntax) => syntax.name), ["target"], diagnostics);
+        const expression = parseTestExpressionChild(branch, diagnostics);
+        if (expression)
+            branches.push({ target: branch.attributes.target ?? "", expression });
+    }
+    const items = section.children
+        .filter((node) => node.localName === "qti-assessment-item-ref")
+        .map((item) => {
+        checkTestXml(item, [], ["identifier", "href", "category"], diagnostics);
+        return {
+            identifier: item.attributes.identifier ?? "",
+            href: item.attributes.href ?? "",
+            categories: (item.attributes.category ?? "")
+                .split(/\s+/)
+                .filter((category) => category.length > 0),
+        };
+    });
+    return {
+        identifier: section.attributes.identifier ?? "",
+        title: section.attributes.title ?? "",
+        branches,
+        items,
+    };
+}
+function parseTestOutcomeProcessing(root, diagnostics) {
+    const processing = root.children.filter((node) => node.localName === "qti-outcome-processing");
+    if (processing.length > 1)
+        rejectTestXml(root, diagnostics);
+    const rules = [];
+    for (const node of processing) {
+        checkTestXml(node, ["qti-set-outcome-value"], [], diagnostics);
+        for (const rule of node.children) {
+            checkTestXml(rule, testExpressionSyntax.map((syntax) => syntax.name), ["identifier"], diagnostics);
+            const expression = parseTestExpressionChild(rule, diagnostics);
+            if (expression)
+                rules.push({
+                    type: "setOutcomeValue",
+                    identifier: rule.attributes.identifier ?? "",
+                    expression,
+                });
+        }
+    }
+    return rules;
+}
+//# sourceMappingURL=test-parser.js.map

package/dist/test-parser.js.map

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

package/dist/test-processing.d.ts

@@ -0,0 +1,22 @@
+import type { QtiTestExpression } from "./test-expression.js";
+import type { QtiExecutableTest } from "./test-model.js";
+/** Trusted server-scored submission. Item scores are finite scalar numbers. */
+export interface QtiTestSubmission {
+    readonly itemRef: string;
+    readonly score: number;
+}
+type TestValue = number | boolean | string | number[] | null;
+/** Data used by the deterministic test interpreter; no item session state or hooks. */
+export interface TestExpressionValues {
+    readonly outcomes: Readonly<Record<string, TestValue>>;
+    readonly submissions: readonly QtiTestSubmission[];
+    readonly categories: ReadonlyMap<string, readonly string[]>;
+}
+/** Evaluate a validated test expression using QTI null and three-valued boolean semantics. */
+export declare function evaluateTestExpression(expression: QtiTestExpression, values: TestExpressionValues): TestValue;
+/** Recompute outcomes from defaults and committed scores, in assignment order. */
+export declare function processTestOutcomes(test: QtiExecutableTest, submissions: readonly QtiTestSubmission[]): {
+    readonly outcomes: Record<string, TestValue>;
+};
+export {};
+//# sourceMappingURL=test-processing.d.ts.map

package/dist/test-processing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-processing.d.ts","sourceRoot":"","sources":["../src/test-processing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,KAAK,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;AAE7D,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;CAC7D;AAED,8FAA8F;AAC9F,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,iBAAiB,EAC7B,MAAM,EAAE,oBAAoB,GAC3B,SAAS,CA+DX;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,iBAAiB,EACvB,WAAW,EAAE,SAAS,iBAAiB,EAAE,GACxC;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CAAE,CAclD"}

package/dist/test-processing.js

@@ -0,0 +1,84 @@
+import { assertNever } from "./assert-never.js";
+/** Evaluate a validated test expression using QTI null and three-valued boolean semantics. */
+export function evaluateTestExpression(expression, values) {
+    const evaluate = (child) => evaluateTestExpression(child, values);
+    switch (expression.type) {
+        case "baseValue":
+            return expression.value;
+        case "variable":
+            return values.outcomes[expression.identifier] ?? null;
+        case "testVariables": {
+            const scores = values.submissions
+                .filter((submission) => expression.includeCategory === undefined ||
+                values.categories.get(submission.itemRef)?.includes(expression.includeCategory))
+                .map((submission) => submission.score);
+            return scores.length ? scores : null;
+        }
+        case "sum": {
+            let sum = 0;
+            for (const child of expression.expressions) {
+                const value = evaluate(child);
+                if (value === null)
+                    return null;
+                if (typeof value === "number")
+                    sum += value;
+                else if (typeof value === "object")
+                    for (const number of value)
+                        sum += number;
+                else
+                    return null;
+            }
+            return sum;
+        }
+        case "numericCompare": {
+            const left = evaluate(expression.left);
+            const right = evaluate(expression.right);
+            if (typeof left !== "number" || typeof right !== "number")
+                return null;
+            switch (expression.operator) {
+                case "gt":
+                    return left > right;
+                case "gte":
+                    return left >= right;
+                case "lt":
+                    return left < right;
+                case "lte":
+                    return left <= right;
+                default:
+                    return assertNever(expression.operator);
+            }
+        }
+        case "and":
+        case "or": {
+            const decisive = expression.type === "or";
+            let sawNull = false;
+            for (const child of expression.expressions) {
+                const value = evaluate(child);
+                if (value === decisive)
+                    return decisive;
+                if (value === null)
+                    sawNull = true;
+            }
+            return sawNull ? null : !decisive;
+        }
+        case "not": {
+            const value = evaluate(expression.expression);
+            return value === null ? null : !value;
+        }
+        default:
+            return assertNever(expression);
+    }
+}
+/** Recompute outcomes from defaults and committed scores, in assignment order. */
+export function processTestOutcomes(test, submissions) {
+    const outcomes = Object.fromEntries(test.outcomeDeclarations.map((d) => [d.identifier, d.defaultValue]));
+    const categories = new Map(test.sections.flatMap((s) => s.items.map((i) => [i.identifier, i.categories])));
+    for (const rule of test.outcomeProcessing)
+        outcomes[rule.identifier] = evaluateTestExpression(rule.expression, {
+            outcomes,
+            submissions,
+            categories,
+        });
+    return { outcomes };
+}
+//# sourceMappingURL=test-processing.js.map

package/dist/test-processing.js.map

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

package/dist/test-session.d.ts

@@ -0,0 +1,31 @@
+import { type QtiTestSubmission } from "./test-processing.js";
+import { type QtiExecutableTest, type QtiTestResult } from "./test-model.js";
+import type { QtiValue } from "./types.js";
+interface TestSessionBase {
+    readonly testIdentifier: string;
+    readonly submissions: readonly QtiTestSubmission[];
+    readonly outcomes: Readonly<Record<string, QtiValue>>;
+}
+/** Live route state. Only an active session has a current item. */
+export type QtiTestSession = TestSessionBase & ({
+    readonly status: "active";
+    readonly currentItemRef: string;
+} | {
+    readonly status: "completed";
+});
+/** Stable JSON contract: computed frontier/outcomes are reconstructed, never trusted. */
+export interface QtiTestSessionSnapshot {
+    readonly version: 1;
+    readonly testIdentifier: string;
+    readonly submissions: readonly QtiTestSubmission[];
+}
+/** Start a validated test at its first item. */
+export declare function startQtiTest(test: QtiExecutableTest): QtiTestSession;
+/** Accept one trusted scored answer at the frontier; does not mutate input state. */
+export declare function submitQtiTestAnswer(test: QtiExecutableTest, session: QtiTestSession, submission: QtiTestSubmission): QtiTestResult<QtiTestSession>;
+/** Project session state into its minimal persisted contract. */
+export declare function snapshotQtiTestSession(session: QtiTestSession): QtiTestSessionSnapshot;
+/** Parse persisted state and replay it against the pinned test to reject impossible routes. */
+export declare function restoreQtiTestSession(test: QtiExecutableTest, input: unknown): QtiTestResult<QtiTestSession>;
+export {};
+//# sourceMappingURL=test-session.d.ts.map

package/dist/test-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-session.d.ts","sourceRoot":"","sources":["../src/test-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,iBAAiB,EAEtB,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,UAAU,eAAe;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;CACvD;AAED,mEAAmE;AACnE,MAAM,MAAM,cAAc,GAAG,eAAe,GAC1C,CACI;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CACnC,CAAC;AAEJ,yFAAyF;AACzF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACpD;AAED,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,IAAI,EAAE,iBAAiB,GAAG,cAAc,CASpE;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,iBAAiB,GAC5B,aAAa,CAAC,cAAc,CAAC,CAuC/B;AAqBD,iEAAiE;AACjE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,sBAAsB,CAMtF;AAED,+FAA+F;AAC/F,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,OAAO,GACb,aAAa,CAAC,cAAc,CAAC,CAoC/B"}