@digabi/exam-engine-mastering 16.1.3-alpha.0 → 16.2.1

package/schema/exam.xsd

@@ -49,7 +49,7 @@
         <xs:documentation>The exam language.</xs:documentation>
       </xs:annotation>
     </xs:attribute>
-    <xs:attribute name="exam-type" type="e:exam-type">
+    <xs:attribute name="exam-type" type="e:exam-type-list">
       <xs:annotation>
         <xs:documentation>
           You may want to create separate versions of the exam for students with disabilities. If not
@@ -181,6 +181,15 @@
     </xs:restriction>
   </xs:simpleType>
 
+  <xs:simpleType name="exam-type-list">
+    <xs:restriction>
+      <xs:simpleType>
+        <xs:list itemType="e:exam-type" />
+      </xs:simpleType>
+      <xs:minLength value="1"/>
+    </xs:restriction>
+  </xs:simpleType>
+
   <xs:element name="exam-versions">
     <xs:complexType>
       <xs:sequence>
@@ -450,11 +459,17 @@
   <xs:element name="text-answer">
     <xs:complexType>
       <xs:sequence>
-        <xs:element name="hint" minOccurs="0" type="e:Flow" />
+        <xs:element name="hint" minOccurs="0" type="e:LocalizableFlow" />
         <xs:element name="answer-grading-instruction" minOccurs="0" type="e:Flow" />
       </xs:sequence>
       <xs:attribute name="type" type="e:text-answer-type" default="single-line" />
       <xs:attribute name="max-score" type="xs:positiveInteger" use="required" />
+      <xs:attribute name="max-length" type="xs:positiveInteger" />
+      <xs:attribute name="use-language-of-instruction" type="xs:boolean" default="false">
+        <xs:annotation>
+          <xs:documentation>Whether the student should answer the question in the language of instruction (typically the mother tongue) instead of the subject language. This attribute controls the HTML lang attribute of the input element, so a screen reader will read the answer using the correct language. Used only in secondary language exams. </xs:documentation>
+        </xs:annotation>
+      </xs:attribute>
       <xs:attributeGroup ref="e:stylable" />
     </xs:complexType>
   </xs:element>
@@ -493,13 +508,14 @@
   <xs:element name="scored-text-answer">
     <xs:complexType>
       <xs:sequence>
-        <xs:element name="hint" minOccurs="0" type="e:Flow" />
+        <xs:element name="hint" minOccurs="0" type="e:LocalizableFlow" />
         <xs:element name="answer-grading-instruction" minOccurs="0" type="e:Flow" />
         <xs:element ref="e:accepted-answer" minOccurs="0" maxOccurs="unbounded" />
       </xs:sequence>
       <xs:attribute name="type" type="e:text-answer-type" default="single-line" />
       <xs:attribute name="max-score" type="xs:positiveInteger" />
       <xs:attributeGroup ref="e:stylable" />
+      <xs:attributeGroup ref="e:localizable" />
     </xs:complexType>
   </xs:element>
 

package/dist/mastering/createHvp.d.ts

@@ -1,2 +0,0 @@
-export function createHvp(doc: import("libxmljs2").Document, targetLanguage: string): any;
-//# sourceMappingURL=createHvp.d.ts.map

package/dist/mastering/createHvp.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createHvp.d.ts","sourceRoot":"","sources":["../../src/mastering/createHvp.js"],"names":[],"mappings":"AAUO,+BAJI,OAAO,WAAW,EAAE,QAAQ,kBAC5B,MAAM,OAkGhB"}

package/dist/mastering/createHvp.js

@@ -1,100 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createHvp = void 0;
-const ramda_1 = __importDefault(require("ramda"));
-const schema_1 = require("./schema");
-/**
- * Generates HVP.
- *
- * @param {import("libxmljs2").Document} doc
- * @param {string} targetLanguage
- * @returns string
- */
-const createHvp = (doc, targetLanguage) => {
-    const cleanString = (input) => input.trim().replace(/\s+/g, ' ');
-    const nodeContains = (elementName, node) => {
-        return node.find(`.//${elementName}`, schema_1.ns).length > 0;
-    };
-    const findQuestionTypes = (node) => {
-        const elementNamesToTypes = {
-            'fi-FI': {
-                'e:scored-text-answer': 'keskitetysti arvosteltava tekstivastaus',
-                'e:choice-answer': 'monivalintavastaus',
-                'e:dropdown-answer': 'monivalintavastaus',
-                'e:text-answer': 'tekstivastaus',
-            },
-            'sv-FI': {
-                'e:scored-text-answer': 'centraliserat bedömt textsvar',
-                'e:choice-answer': 'flervalssvar',
-                'e:dropdown-answer': 'flervalssvar',
-                'e:text-answer': 'textsvar',
-            },
-        };
-        const elementNamesToTypesInTargetLanguage = elementNamesToTypes[targetLanguage];
-        return Object.keys(elementNamesToTypesInTargetLanguage)
-            .map((elementName) => (nodeContains(elementName, node) ? elementNamesToTypesInTargetLanguage[elementName] : null))
-            .filter((x) => x !== null);
-    };
-    const optionsWithScoresString = function (node, optionElementName) {
-        const prefix = optionElementName === 'e:choice-answer-option' ? '-' : ramda_1.default.last(getDisplayNumber(node).split('.')) + '.';
-        return node
-            .find(`.//${optionElementName}[@score]`, schema_1.ns)
-            .map((o) => `${prefix} ${cleanString(o.text())} (${o.attr('score').value()} p.)`)
-            .join('\n');
-    };
-    const getAttributeValue = (attributeName) => (node) => node.attr(attributeName).value();
-    const getMaxScore = getAttributeValue('max-score');
-    const getScore = getAttributeValue('score');
-    const getDisplayNumber = getAttributeValue('display-number');
-    const nodeToStrings = function (node) {
-        var _a, _b;
-        switch (node.name()) {
-            case 'exam-title':
-                return [cleanString(node.text())];
-            case 'section': {
-                const sectionTitle = cleanString(node.get('./e:section-title', schema_1.ns).text());
-                return [
-                    `\n### ${targetLanguage === 'sv-FI' ? 'Del' : 'Osa'} ${getDisplayNumber(node)}: ${sectionTitle} (${getMaxScore(node)} p.)`,
-                ];
-            }
-            case 'question': {
-                const displayNumber = getDisplayNumber(node);
-                const isTopLevelQuestion = !displayNumber.includes('.');
-                const answerTypesInQuestion = findQuestionTypes(node);
-                const questionTitle = cleanString(node.find('e:question-title', schema_1.ns)[0].text());
-                return [
-                    `\n${isTopLevelQuestion ? '#### ' : ''}${displayNumber}. ${questionTitle} (${getMaxScore(node)} p.) ${isTopLevelQuestion ? '' : '(' + answerTypesInQuestion.join(', ') + ')'}\n`,
-                ];
-            }
-            case 'choice-answer': {
-                return [optionsWithScoresString(node, 'e:choice-answer-option')];
-            }
-            case 'scored-text-answer': {
-                return [
-                    `- ${getDisplayNumber(node)}. ${(_b = (_a = node.get('./e:hint', schema_1.ns)) === null || _a === void 0 ? void 0 : _a.text().trim()) !== null && _b !== void 0 ? _b : ''}\n${node
-                        .find('.//e:accepted-answer[@score]', schema_1.ns)
-                        .map((elem) => `    - ${cleanString(elem.text())} (${getScore(elem)} p.)`)
-                        .join('\n')}`,
-                ];
-            }
-            case 'dropdown-answer': {
-                return [optionsWithScoresString(node, 'e:dropdown-answer-option')];
-            }
-            default:
-                return [];
-        }
-    };
-    const processNode = (node) => {
-        if (node.type() !== 'element') {
-            return [];
-        }
-        const childNodes = node.childNodes();
-        return childNodes.length !== 0 ? [...nodeToStrings(node), ...childNodes.map(processNode)] : [];
-    };
-    return ramda_1.default.flatten(doc.childNodes().map(processNode)).join('\n').trim();
-};
-exports.createHvp = createHvp;
-//# sourceMappingURL=createHvp.js.map

package/dist/mastering/createHvp.js.map

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