@qti-editor/core 1.2.0 → 1.3.1

package/dist/composer/index.d.ts

@@ -34,6 +34,7 @@ export interface ResponseDeclaration {
         }>;
     };
     sourceTag: string;
+    score?: number;
 }
 export declare function extractResponseDeclarations(itemBodyRoot?: Element | null): ResponseDeclaration[];
 export declare function buildAssessmentItemXml(itemContext?: ComposerItemContext): string;
@@ -47,5 +48,25 @@ export declare function buildAssessmentItemXml(itemContext?: ComposerItemContext
  *          or a single assessment item if no dividers are found.
  */
 export declare function buildMultipleAssessmentItemsXml(itemContext?: ComposerItemContext): string;
+/**
+ * Build a single QTI assessment item, converting any dividers to <hr /> elements.
+ * Use this when you want to export the entire editor content as one item.
+ */
+export declare function buildSingleAssessmentItemXml(itemContext?: ComposerItemContext): string;
+/**
+ * Count how many items would be generated from an item body document.
+ * Returns 1 if no dividers, or dividers.length + 1 otherwise.
+ */
+export declare function countItemFragments(itemContext?: ComposerItemContext): number;
+/**
+ * Get an array of individual assessment item XMLs.
+ * Each item is generated from a segment between dividers.
+ * Returns an array with identifier and XML for each item.
+ */
+export declare function getItemFragmentXmls(itemContext?: ComposerItemContext): Array<{
+    identifier: string;
+    title: string;
+    xml: string;
+}>;
 export declare function formatXml(xml: string): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/composer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composer/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAC/C,QAAQ,EAAE,YAAY,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,KAAK,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;YACf,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,OAAO,CAAC;SACxB,CAAC,CAAC;KACJ,CAAC;IACF,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,WAAW,CAAC,EAAE;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,KAAK,CAAC;YACb,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;YACzB,MAAM,EAAE,MAAM,CAAC;YACf,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;KACJ,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAoCD,wBAAgB,2BAA2B,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,mBAAmB,EAAE,CAOhG;AAsDD,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAqHhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAkCzF;AAgLD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA4B7C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composer/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAC/C,QAAQ,EAAE,YAAY,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,KAAK,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;YACf,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,OAAO,CAAC;SACxB,CAAC,CAAC;KACJ,CAAC;IACF,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,WAAW,CAAC,EAAE;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,KAAK,CAAC;YACb,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;YACzB,MAAM,EAAE,MAAM,CAAC;YACf,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;KACJ,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAoCD,wBAAgB,2BAA2B,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,mBAAmB,EAAE,CAOhG;AAkFD,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAqHhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAkCzF;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAUtF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAK5E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAyChI;AAgMD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA4B7C"}

package/dist/composer/index.js

@@ -40,6 +40,29 @@ export function extractResponseDeclarations(itemBodyRoot) {
     const { declarations } = composeAndNormalizeItemBody(tempRoot, tempDoc);
     return declarations;
 }
+/**
+ * Convert qti-item-divider elements to <hr /> elements.
+ * Used when composing a single item that should preserve dividers as visual separators.
+ */
+function convertDividersToHr(itemBodyDoc) {
+    const itemBodyRoot = itemBodyDoc.querySelector('qti-item-body') ??
+        (itemBodyDoc.documentElement?.tagName.toLowerCase() === 'qti-item-body'
+            ? itemBodyDoc.documentElement
+            : null);
+    if (!itemBodyRoot)
+        return itemBodyDoc;
+    // Clone the document to avoid mutating the original
+    const clonedDoc = document.implementation.createDocument(QTI_NS, 'qti-item-body', null);
+    const clonedRoot = clonedDoc.importNode(itemBodyRoot, true);
+    clonedDoc.replaceChild(clonedRoot, clonedDoc.documentElement);
+    // Find and replace all dividers with <hr />
+    const dividers = Array.from(clonedRoot.querySelectorAll('qti-item-divider'));
+    for (const divider of dividers) {
+        const hr = clonedDoc.createElementNS(QTI_NS, 'hr');
+        divider.parentNode?.replaceChild(hr, divider);
+    }
+    return clonedDoc;
+}
 /**
  * Split an item body document at qti-item-divider elements.
  * Returns an array of item body fragments, one for each item.
@@ -220,6 +243,71 @@ export function buildMultipleAssessmentItemsXml(itemContext) {
     const separator = '\n\n<!-- Next Assessment Item -->\n\n';
     return itemXmls.join(separator);
 }
+/**
+ * Build a single QTI assessment item, converting any dividers to <hr /> elements.
+ * Use this when you want to export the entire editor content as one item.
+ */
+export function buildSingleAssessmentItemXml(itemContext) {
+    if (!itemContext?.itemBody)
+        return '';
+    // Convert dividers to <hr /> elements
+    const convertedDoc = convertDividersToHr(itemContext.itemBody);
+    return buildAssessmentItemXml({
+        ...itemContext,
+        itemBody: convertedDoc,
+    });
+}
+/**
+ * Count how many items would be generated from an item body document.
+ * Returns 1 if no dividers, or dividers.length + 1 otherwise.
+ */
+export function countItemFragments(itemContext) {
+    if (!itemContext?.itemBody)
+        return 0;
+    const fragments = splitItemBodyAtDividers(itemContext.itemBody);
+    return fragments.length;
+}
+/**
+ * Get an array of individual assessment item XMLs.
+ * Each item is generated from a segment between dividers.
+ * Returns an array with identifier and XML for each item.
+ */
+export function getItemFragmentXmls(itemContext) {
+    if (!itemContext?.itemBody)
+        return [];
+    const fragments = splitItemBodyAtDividers(itemContext.itemBody);
+    // If only one fragment (no dividers), return single item
+    if (fragments.length <= 1) {
+        const xml = buildAssessmentItemXml(itemContext);
+        return [{
+                identifier: itemContext.identifier?.trim() || 'item-1',
+                title: itemContext.title?.trim() || 'Untitled Item',
+                xml,
+            }];
+    }
+    const baseIdentifier = itemContext.identifier?.trim() || 'item';
+    const baseTitle = itemContext.title?.trim() || 'Untitled Item';
+    const lang = itemContext.lang?.trim() || 'en';
+    return fragments.map((fragmentBody, index) => {
+        const itemNumber = index + 1;
+        const fragmentDoc = document.implementation.createDocument(QTI_NS, 'qti-item-body', null);
+        const importedFragment = fragmentDoc.importNode(fragmentBody, true);
+        fragmentDoc.replaceChild(importedFragment, fragmentDoc.documentElement);
+        const identifier = `${baseIdentifier}-${itemNumber}`;
+        const title = `${baseTitle} ${itemNumber}`;
+        const fragmentContext = {
+            identifier,
+            title,
+            lang,
+            itemBody: fragmentDoc,
+        };
+        return {
+            identifier,
+            title,
+            xml: buildAssessmentItemXml(fragmentContext),
+        };
+    });
+}
 function composeAndNormalizeItemBody(itemBody, xmlDoc) {
     const declarations = [];
     const seenIdentifiers = new Set();
@@ -238,9 +326,21 @@ function composeAndNormalizeItemBody(itemBody, xmlDoc) {
             const parent = element.parentNode;
             if (parent) {
                 parent.replaceChild(composeResult.normalizedElement, element);
+                // Insert any additional elements (like rubric blocks) after the interaction
+                if (composeResult.additionalElements?.length) {
+                    const nextSibling = composeResult.normalizedElement.nextSibling;
+                    for (const additionalElement of composeResult.additionalElements) {
+                        if (nextSibling) {
+                            parent.insertBefore(additionalElement, nextSibling);
+                        }
+                        else {
+                            parent.appendChild(additionalElement);
+                        }
+                    }
+                }
             }
             if (composeResult.responseDeclaration) {
-                maxScore += 1;
+                maxScore += composeResult.responseDeclaration.score ?? 1;
             }
             if (composeResult.responseDeclaration && !seenIdentifiers.has(composeResult.responseDeclaration.identifier)) {
                 const responseProcessingKind = composeResult
@@ -263,6 +363,9 @@ function composeAndNormalizeItemBody(itemBody, xmlDoc) {
     itemBody.querySelectorAll('[correct-response]').forEach(interaction => {
         interaction.removeAttribute('correct-response');
     });
+    itemBody.querySelectorAll('[score]').forEach(element => {
+        element.removeAttribute('score');
+    });
     normalizeResponseIdentifiers(itemBody, declarations);
     if (declarations.length === 1 && templateCandidates.size === 1) {
         return { declarations, responseTemplate: Array.from(templateCandidates)[0], maxScore };
@@ -274,7 +377,7 @@ function buildMultiInteractionResponseProcessing(xmlDoc, declarations) {
     declarations.forEach(declaration => {
         const kind = declaration.responseProcessingKind ?? 'match_correct';
         if (kind === 'match_correct') {
-            responseProcessing.appendChild(createMatchCorrectContribution(xmlDoc, declaration.identifier));
+            responseProcessing.appendChild(createMatchCorrectContribution(xmlDoc, declaration.identifier, declaration.score ?? 1));
             return;
         }
         if (kind === 'map_response') {
@@ -285,7 +388,7 @@ function buildMultiInteractionResponseProcessing(xmlDoc, declarations) {
     });
     return responseProcessing;
 }
-function createMatchCorrectContribution(xmlDoc, responseIdentifier) {
+function createMatchCorrectContribution(xmlDoc, responseIdentifier, score = 1) {
     const responseCondition = xmlDoc.createElementNS(QTI_NS, 'qti-response-condition');
     const responseIf = xmlDoc.createElementNS(QTI_NS, 'qti-response-if');
     const match = xmlDoc.createElementNS(QTI_NS, 'qti-match');
@@ -298,7 +401,7 @@ function createMatchCorrectContribution(xmlDoc, responseIdentifier) {
     responseIf.appendChild(match);
     const incrementValue = xmlDoc.createElementNS(QTI_NS, 'qti-base-value');
     incrementValue.setAttribute('base-type', 'float');
-    incrementValue.textContent = '1';
+    incrementValue.textContent = String(score);
     responseIf.appendChild(createScoreIncrement(xmlDoc, incrementValue));
     responseCondition.appendChild(responseIf);
     return responseCondition;

package/dist/interactions/composer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composer.d.ts","sourceRoot":"","sources":["../../src/interactions/composer.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,wBAAwB,CAAC;AAmChC,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS,CAEvG;AAED,wBAAgB,4CAA4C,CAC1D,YAAY,EAAE,MAAM,GACnB,2BAA2B,GAAG,SAAS,CAEzC;AAED,wBAAgB,2CAA2C,CACzD,YAAY,EAAE,MAAM,GACnB,0BAA0B,GAAG,SAAS,CAExC;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS,CAErG;AAED,wBAAgB,+BAA+B,IAAI,aAAa,CAAC,0BAA0B,CAAC,CAE3F;AAED,wBAAgB,0BAA0B,IAAI,aAAa,CAAC,qBAAqB,CAAC,CAEjF;AAED,wBAAgB,8BAA8B,IAAI,aAAa,CAC7D,WAAW,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,CAC9D,CAEA"}
+{"version":3,"file":"composer.d.ts","sourceRoot":"","sources":["../../src/interactions/composer.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,wBAAwB,CAAC;AAoChC,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS,CAEvG;AAED,wBAAgB,4CAA4C,CAC1D,YAAY,EAAE,MAAM,GACnB,2BAA2B,GAAG,SAAS,CAEzC;AAED,wBAAgB,2CAA2C,CACzD,YAAY,EAAE,MAAM,GACnB,0BAA0B,GAAG,SAAS,CAExC;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS,CAErG;AAED,wBAAgB,+BAA+B,IAAI,aAAa,CAAC,0BAA0B,CAAC,CAE3F;AAED,wBAAgB,0BAA0B,IAAI,aAAa,CAAC,qBAAqB,CAAC,CAEjF;AAED,wBAAgB,8BAA8B,IAAI,aAAa,CAC7D,WAAW,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,CAC9D,CAEA"}

package/dist/interactions/composer.js

@@ -1,6 +1,7 @@
 import { associateInteractionDescriptor } from '@qti-editor/interaction-associate';
 import { choiceInteractionDescriptor } from '@qti-editor/interaction-choice';
 import { extendedTextInteractionDescriptor } from '@qti-editor/interaction-extended-text';
+import { gapMatchInteractionDescriptor } from '@qti-editor/interaction-gap-match';
 import { hottextInteractionDescriptor } from '@qti-editor/interaction-hottext';
 import { inlineChoiceInteractionDescriptor } from '@qti-editor/interaction-inline-choice';
 import { matchInteractionDescriptor } from '@qti-editor/interaction-match';
@@ -12,6 +13,7 @@ const registeredDescriptors = [
     associateInteractionDescriptor,
     choiceInteractionDescriptor,
     extendedTextInteractionDescriptor,
+    gapMatchInteractionDescriptor,
     hottextInteractionDescriptor,
     inlineChoiceInteractionDescriptor,
     matchInteractionDescriptor,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qti-editor/core",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "QTI semantics, composer registry, and XML export orchestration for QTI Editor",
   "repository": {
     "type": "git",
@@ -24,18 +24,19 @@
     }
   },
   "dependencies": {
-    "@qti-editor/interfaces": "1.1.0",
-    "@qti-editor/interaction-associate": "1.1.3",
-    "@qti-editor/interaction-choice": "1.1.3",
-    "@qti-editor/interaction-extended-text": "1.1.3",
-    "@qti-editor/interaction-hottext": "1.1.3",
-    "@qti-editor/interaction-inline-choice": "1.1.1",
-    "@qti-editor/interaction-match": "1.1.1",
-    "@qti-editor/interaction-order": "0.5.1",
-    "@qti-editor/interaction-select-point": "1.1.1",
-    "@qti-editor/interaction-shared": "1.2.0",
-    "@qti-editor/interaction-text-entry": "1.1.2",
-    "@qti-editor/qti-item-divider": "1.0.0"
+    "@qti-editor/interfaces": "1.2.0",
+    "@qti-editor/interaction-associate": "1.2.1",
+    "@qti-editor/interaction-choice": "1.2.1",
+    "@qti-editor/interaction-extended-text": "1.2.1",
+    "@qti-editor/interaction-gap-match": "1.1.0",
+    "@qti-editor/interaction-hottext": "1.2.2",
+    "@qti-editor/interaction-inline-choice": "1.2.1",
+    "@qti-editor/interaction-match": "1.2.0",
+    "@qti-editor/interaction-order": "0.6.0",
+    "@qti-editor/interaction-select-point": "1.2.0",
+    "@qti-editor/interaction-shared": "1.3.0",
+    "@qti-editor/interaction-text-entry": "1.2.0",
+    "@qti-editor/qti-item-divider": "1.1.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",