@examplary/qti 0.0.1 → 1.0.0

package/README.md

@@ -20,9 +20,14 @@ const item = new QtiItem({
   title: "Sample Question",
 });
 
-item.addItemBodyFromHtml("<p>What is 2 + 2?</p>");
 item.addResponseDeclaration({ identifier: "RESPONSE" });
 item.addCorrectResponse("RESPONSE", ["4"]);
+
+item.addItemBodyFromHtml("<p>What is 2 + 2?</p>");
+item.addInteraction(
+  new TextEntryInteraction({ responseIdentifier: "RESPONSE" }),
+);
+
 item.addResponseProcessing(ResponseProcessingTemplate.MatchCorrect);
 
 item.addToTest(test);

package/dist/ims/ims-package.d.ts

@@ -21,7 +21,7 @@ export declare class ImsPackage {
     /**
      * Add a resource to the IMS Package, along with its associated files.
      */
-    addResource(resource: ImsManifestResourceWithoutFiles, files: ImsPackageFile[]): void;
+    addResource(resource: ImsManifestResourceWithoutFiles, files: ImsPackageFile[]): Promise<void>;
     /**
      * Add a file directly to the final ZIP, without adding it to the manifest.
      * Can fetch from URL or add from data.

package/dist/ims/ims-package.js

@@ -11,9 +11,9 @@ export class ImsPackage {
     /**
      * Add a resource to the IMS Package, along with its associated files.
      */
-    addResource(resource, files) {
+    async addResource(resource, files) {
         for (const file of files) {
-            this.addFileDirectly(file);
+            await this.addFileDirectly(file);
         }
         this.manifest.addResource({
             ...resource,

package/dist/ims/ims-package.js.map

@@ -1 +1 @@
-{"version":3,"file":"ims-package.js","sourceRoot":"","sources":["../../src/ims/ims-package.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,OAAO,CAAC;AAExB,OAAO,EACL,WAAW,GAGZ,MAAM,gBAAgB,CAAC;AA0BxB,MAAM,OAAO,UAAU;IAIrB;;OAEG;IACH,YAAY,eAAoC;QAC9C,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,eAAe,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,WAAW,CACT,QAAyC,EACzC,KAAuB;QAEvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YACxB,GAAG,QAAQ;YACX,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,IAAoB;QACxC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,iCAAiC,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,UAAU,EAAE,CACpE,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;YAE1C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE3D,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;IACzD,CAAC;CACF"}
+{"version":3,"file":"ims-package.js","sourceRoot":"","sources":["../../src/ims/ims-package.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,OAAO,CAAC;AAExB,OAAO,EACL,WAAW,GAGZ,MAAM,gBAAgB,CAAC;AA0BxB,MAAM,OAAO,UAAU;IAIrB;;OAEG;IACH,YAAY,eAAoC;QAC9C,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,eAAe,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,QAAyC,EACzC,KAAuB;QAEvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YACxB,GAAG,QAAQ;YACX,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,IAAoB;QACxC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,iCAAiC,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,UAAU,EAAE,CACpE,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;YAE1C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE3D,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export * from "./ims/ims-manifest";
 export * from "./ims/ims-package";
+export * from "./qti/qti-element";
 export * from "./qti/qti-test";
 export * from "./qti/qti-item";
+export * from "./qti/interactions";
 export * from "./qti/types";

package/dist/index.js

@@ -1,6 +1,8 @@
 export * from "./ims/ims-manifest";
 export * from "./ims/ims-package";
+export * from "./qti/qti-element";
 export * from "./qti/qti-test";
 export * from "./qti/qti-item";
+export * from "./qti/interactions";
 export * from "./qti/types";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC"}

package/dist/qti/interactions/associate-interaction.d.ts

@@ -0,0 +1,36 @@
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export type SimpleAssociableChoiceOptions = {
+    identifier: string;
+    matchMax?: number;
+    matchMin?: number;
+    matchGroup?: string;
+    fixed?: boolean;
+    templateIdentifier?: string;
+    content?: string;
+};
+export type AssociateInteractionOptions = QtiPromptInteractionOptions & {
+    shuffle?: boolean;
+    minAssociations?: number;
+    maxAssociations?: number;
+    choices?: SimpleAssociableChoiceOptions[];
+};
+/**
+ * Presents a set of choices for candidates to pair or associate with each other.
+ * Unlike MatchInteraction, choices come from a single set and can be paired freely.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.7cs7637r54vv
+ *
+ * @example
+ * const interaction = new AssociateInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   choices: [
+ *     { identifier: "A", content: "Cat", matchMax: 1 },
+ *     { identifier: "B", content: "Dog", matchMax: 1 },
+ *     { identifier: "C", content: "Meow", matchMax: 1 },
+ *     { identifier: "D", content: "Bark", matchMax: 1 },
+ *   ],
+ * });
+ */
+export declare class AssociateInteraction extends QtiPromptInteraction {
+    constructor(options: AssociateInteractionOptions);
+}

package/dist/qti/interactions/associate-interaction.js

@@ -0,0 +1,46 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+import { appendHtmlFragment } from "../../utils/html";
+/**
+ * Presents a set of choices for candidates to pair or associate with each other.
+ * Unlike MatchInteraction, choices come from a single set and can be paired freely.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.7cs7637r54vv
+ *
+ * @example
+ * const interaction = new AssociateInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   choices: [
+ *     { identifier: "A", content: "Cat", matchMax: 1 },
+ *     { identifier: "B", content: "Dog", matchMax: 1 },
+ *     { identifier: "C", content: "Meow", matchMax: 1 },
+ *     { identifier: "D", content: "Bark", matchMax: 1 },
+ *   ],
+ * });
+ */
+export class AssociateInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-associate-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            shuffle: options.shuffle ? "true" : "false",
+            "min-associations": options.minAssociations?.toString(),
+            "max-associations": options.maxAssociations?.toString(),
+        });
+        for (const choice of options.choices || []) {
+            const choiceEl = this.item.ele("qti-simple-associable-choice", {
+                identifier: choice.identifier,
+                "match-max": choice.matchMax?.toString(),
+                "match-min": choice.matchMin?.toString(),
+                "match-group": choice.matchGroup,
+                fixed: choice.fixed ? "true" : undefined,
+                "template-identifier": choice.templateIdentifier,
+            });
+            if (choice.content) {
+                appendHtmlFragment(choice.content, choiceEl);
+            }
+        }
+    }
+}
+//# sourceMappingURL=associate-interaction.js.map

package/dist/qti/interactions/associate-interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"associate-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/associate-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAmBtD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,oBAAqB,SAAQ,oBAAoB;IAC5D,YAAY,OAAoC;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,2BAA2B,EAAE;YACtD,qBAAqB,EAAE,OAAO,CAAC,kBAAkB;YACjD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;YAC3C,kBAAkB,EAAE,OAAO,CAAC,eAAe,EAAE,QAAQ,EAAE;YACvD,kBAAkB,EAAE,OAAO,CAAC,eAAe,EAAE,QAAQ,EAAE;SACxD,CAAC,CAAC;QAEH,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,8BAA8B,EAAE;gBAC7D,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE;gBACxC,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE;gBACxC,aAAa,EAAE,MAAM,CAAC,UAAU;gBAChC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBACxC,qBAAqB,EAAE,MAAM,CAAC,kBAAkB;aACjD,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,kBAAkB,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/qti/interactions/choice-interaction.d.ts

@@ -0,0 +1,36 @@
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export type SimpleChoiceOptions = {
+    identifier: string;
+    fixed?: boolean;
+    templateIdentifier?: string;
+    label?: string;
+    content?: string;
+};
+export type ChoiceInteractionOptions = QtiPromptInteractionOptions & {
+    shuffle?: boolean;
+    maxChoices?: number;
+    minChoices?: number;
+    orientation?: "horizontal" | "vertical";
+    minSelectionsMessage?: string;
+    maxSelectionsMessage?: string;
+    choices?: SimpleChoiceOptions[];
+};
+/**
+ * Presents a set of choices for candidates to select one or more options.
+ * Supports single-select (radio) or multi-select (checkbox) modes via maxChoices.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.j9nu1oa1tu3b
+ *
+ * @example
+ * const interaction = new ChoiceInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   maxChoices: 1,
+ *   choices: [
+ *     { identifier: "A", content: "Option A" },
+ *     { identifier: "B", content: "Option B" },
+ *   ],
+ * });
+ */
+export declare class ChoiceInteraction extends QtiPromptInteraction {
+    constructor(options: ChoiceInteractionOptions);
+}

package/dist/qti/interactions/choice-interaction.js

@@ -0,0 +1,43 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+import { appendHtmlFragment } from "../../utils/html";
+/**
+ * Presents a set of choices for candidates to select one or more options.
+ * Supports single-select (radio) or multi-select (checkbox) modes via maxChoices.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.j9nu1oa1tu3b
+ *
+ * @example
+ * const interaction = new ChoiceInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   maxChoices: 1,
+ *   choices: [
+ *     { identifier: "A", content: "Option A" },
+ *     { identifier: "B", content: "Option B" },
+ *   ],
+ * });
+ */
+export class ChoiceInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-choice-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            shuffle: options.shuffle ? "true" : "false",
+            "max-choices": options.maxChoices?.toString(),
+            "min-choices": options.minChoices?.toString(),
+            orientation: options.orientation,
+            "data-min-selections-message": options.minSelectionsMessage,
+            "data-max-selections-message": options.maxSelectionsMessage,
+        });
+        for (const choice of options.choices || []) {
+            appendHtmlFragment(choice.content || "", this.item.ele("qti-simple-choice", {
+                identifier: choice.identifier,
+                fixed: choice.fixed ? "true" : "false",
+                "template-identifier": choice.templateIdentifier,
+                label: choice.label,
+            }));
+        }
+    }
+}
+//# sourceMappingURL=choice-interaction.js.map

package/dist/qti/interactions/choice-interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"choice-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/choice-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAoBtD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,iBAAkB,SAAQ,oBAAoB;IACzD,YAAY,OAAiC;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,wBAAwB,EAAE;YACnD,qBAAqB,EAAE,OAAO,CAAC,kBAAkB;YACjD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;YAC3C,aAAa,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;YAC7C,aAAa,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;YAC7C,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,6BAA6B,EAAE,OAAO,CAAC,oBAAoB;YAC3D,6BAA6B,EAAE,OAAO,CAAC,oBAAoB;SAC5D,CAAC,CAAC;QAEH,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YAC3C,kBAAkB,CAChB,MAAM,CAAC,OAAO,IAAI,EAAE,EACpB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE;gBACjC,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;gBACtC,qBAAqB,EAAE,MAAM,CAAC,kBAAkB;gBAChD,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/qti/interactions/drawing-interaction.d.ts

@@ -0,0 +1,25 @@
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export type DrawingObjectOptions = {
+    data: string;
+    type: string;
+    width?: number;
+    height?: number;
+};
+export type DrawingInteractionOptions = QtiPromptInteractionOptions & {
+    object: DrawingObjectOptions;
+};
+/**
+ * Presents a canvas where candidates can draw or annotate over a background image.
+ * Used for freeform drawing, labeling, or annotation tasks.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.8yrkpwgsrs4b
+ *
+ * @example
+ * const interaction = new DrawingInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   object: { data: "canvas.png", type: "image/png", width: 400, height: 300 },
+ * });
+ */
+export declare class DrawingInteraction extends QtiPromptInteraction {
+    constructor(options: DrawingInteractionOptions);
+}

package/dist/qti/interactions/drawing-interaction.js

@@ -0,0 +1,30 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+/**
+ * Presents a canvas where candidates can draw or annotate over a background image.
+ * Used for freeform drawing, labeling, or annotation tasks.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.8yrkpwgsrs4b
+ *
+ * @example
+ * const interaction = new DrawingInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   object: { data: "canvas.png", type: "image/png", width: 400, height: 300 },
+ * });
+ */
+export class DrawingInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-drawing-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+        });
+        this.item.ele("object", {
+            data: options.object.data,
+            type: options.object.type,
+            width: options.object.width?.toString(),
+            height: options.object.height?.toString(),
+        });
+    }
+}
+//# sourceMappingURL=drawing-interaction.js.map

package/dist/qti/interactions/drawing-interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawing-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/drawing-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AAavB;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,kBAAmB,SAAQ,oBAAoB;IAC1D,YAAY,OAAkC;QAC5C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,yBAAyB,EAAE;YACpD,qBAAqB,EAAE,OAAO,CAAC,kBAAkB;YACjD,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE;YACtB,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;YACzB,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;YACzB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE;YACvC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE;SAC1C,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/qti/interactions/end-attempt-interaction.d.ts

@@ -0,0 +1,21 @@
+import { QtiInteraction, QtiInteractionOptions } from "./interaction";
+export type EndAttemptInteractionOptions = QtiInteractionOptions & {
+    title: string;
+    countAttempt?: boolean;
+};
+/**
+ * Presents a button that allows candidates to voluntarily end their assessment attempt.
+ * Used for "give up" or "submit early" functionality in adaptive testing scenarios.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.b3g8rgbtuwqp
+ *
+ * @example
+ * const interaction = new EndAttemptInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   title: "Give Up",
+ *   countAttempt: true,
+ * });
+ */
+export declare class EndAttemptInteraction extends QtiInteraction {
+    constructor(options: EndAttemptInteractionOptions);
+}

package/dist/qti/interactions/end-attempt-interaction.js

@@ -0,0 +1,27 @@
+import { fragment } from "xmlbuilder2";
+import { QtiInteraction } from "./interaction";
+/**
+ * Presents a button that allows candidates to voluntarily end their assessment attempt.
+ * Used for "give up" or "submit early" functionality in adaptive testing scenarios.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.b3g8rgbtuwqp
+ *
+ * @example
+ * const interaction = new EndAttemptInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   title: "Give Up",
+ *   countAttempt: true,
+ * });
+ */
+export class EndAttemptInteraction extends QtiInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-end-attempt-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            title: options.title,
+            "count-attempt": options.countAttempt ? "true" : undefined,
+        });
+    }
+}
+//# sourceMappingURL=end-attempt-interaction.js.map

package/dist/qti/interactions/end-attempt-interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"end-attempt-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/end-attempt-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,cAAc,EAAyB,MAAM,eAAe,CAAC;AAOtE;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,qBAAsB,SAAQ,cAAc;IACvD,YAAY,OAAqC;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,6BAA6B,EAAE;YACxD,qBAAqB,EAAE,OAAO,CAAC,kBAAkB;YACjD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,eAAe,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SAC3D,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/qti/interactions/extended-text-interaction.d.ts

@@ -0,0 +1,28 @@
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export type ExtendedTextInteractionOptions = QtiPromptInteractionOptions & {
+    base?: number;
+    stringIdentifier?: string;
+    expectedLength?: number;
+    patternMask?: string;
+    placeholderText?: string;
+    maxStrings?: number;
+    minStrings?: number;
+    expectedLines?: number;
+    format?: "plain" | "pre-formatted" | "xhtml";
+};
+/**
+ * Allows candidates to enter extended text responses, such as essays or paragraphs.
+ * Supports configurable length constraints, formatting options, and input validation.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.omuxci3o5dmg
+ *
+ * @example
+ * const interaction = new ExtendedTextInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   expectedLines: 10,
+ *   format: "plain",
+ * });
+ */
+export declare class ExtendedTextInteraction extends QtiPromptInteraction {
+    constructor(options: ExtendedTextInteractionOptions);
+}

package/dist/qti/interactions/extended-text-interaction.js

@@ -0,0 +1,34 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+/**
+ * Allows candidates to enter extended text responses, such as essays or paragraphs.
+ * Supports configurable length constraints, formatting options, and input validation.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.omuxci3o5dmg
+ *
+ * @example
+ * const interaction = new ExtendedTextInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   expectedLines: 10,
+ *   format: "plain",
+ * });
+ */
+export class ExtendedTextInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-extended-text-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            base: options.base?.toString(),
+            "string-identifier": options.stringIdentifier,
+            "expected-length": options.expectedLength?.toString(),
+            "pattern-mask": options.patternMask,
+            "placeholder-text": options.placeholderText,
+            "max-strings": options.maxStrings?.toString(),
+            "min-strings": options.minStrings?.toString(),
+            "expected-lines": options.expectedLines?.toString(),
+            format: options.format,
+        });
+    }
+}
+//# sourceMappingURL=extended-text-interaction.js.map

package/dist/qti/interactions/extended-text-interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extended-text-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/extended-text-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AAcvB;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,uBAAwB,SAAQ,oBAAoB;IAC/D,YAAY,OAAuC;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,+BAA+B,EAAE;YAC1D,qBAAqB,EAAE,OAAO,CAAC,kBAAkB;YACjD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE;YAC9B,mBAAmB,EAAE,OAAO,CAAC,gBAAgB;YAC7C,iBAAiB,EAAE,OAAO,CAAC,cAAc,EAAE,QAAQ,EAAE;YACrD,cAAc,EAAE,OAAO,CAAC,WAAW;YACnC,kBAAkB,EAAE,OAAO,CAAC,eAAe;YAC3C,aAAa,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;YAC7C,aAAa,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;YAC7C,gBAAgB,EAAE,OAAO,CAAC,aAAa,EAAE,QAAQ,EAAE;YACnD,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/qti/interactions/gap-match-interaction.d.ts

@@ -0,0 +1,34 @@
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export type GapTextOptions = {
+    identifier: string;
+    matchMax?: number;
+    matchMin?: number;
+    matchGroup?: string;
+    content?: string;
+};
+export type GapMatchInteractionOptions = QtiPromptInteractionOptions & {
+    shuffle?: boolean;
+    minAssociations?: number;
+    maxAssociations?: number;
+    gapTexts?: GapTextOptions[];
+    content?: string;
+};
+/**
+ * Presents candidates with a set of gaps within content and a set of choices to fill them.
+ * Candidates drag or select choices to match them with the appropriate gaps.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.7sroqk3xl8e1
+ *
+ * @example
+ * const interaction = new GapMatchInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   gapTexts: [
+ *     { identifier: "gap-1", content: "Paris" },
+ *     { identifier: "gap-2", content: "London" },
+ *   ],
+ *   content: "<p>The capital of France is <qti-gap identifier='G1'/>.</p>",
+ * });
+ */
+export declare class GapMatchInteraction extends QtiPromptInteraction {
+    constructor(options: GapMatchInteractionOptions);
+}

package/dist/qti/interactions/gap-match-interaction.js

@@ -0,0 +1,46 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+import { appendHtmlFragment } from "../../utils/html";
+/**
+ * Presents candidates with a set of gaps within content and a set of choices to fill them.
+ * Candidates drag or select choices to match them with the appropriate gaps.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.7sroqk3xl8e1
+ *
+ * @example
+ * const interaction = new GapMatchInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   gapTexts: [
+ *     { identifier: "gap-1", content: "Paris" },
+ *     { identifier: "gap-2", content: "London" },
+ *   ],
+ *   content: "<p>The capital of France is <qti-gap identifier='G1'/>.</p>",
+ * });
+ */
+export class GapMatchInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-gap-match-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            shuffle: options.shuffle ? "true" : "false",
+            "min-associations": options.minAssociations?.toString(),
+            "max-associations": options.maxAssociations?.toString(),
+        });
+        for (const gapText of options.gapTexts || []) {
+            const gapTextEl = this.item.ele("qti-gap-text", {
+                identifier: gapText.identifier,
+                "match-max": gapText.matchMax?.toString(),
+                "match-min": gapText.matchMin?.toString(),
+                "match-group": gapText.matchGroup,
+            });
+            if (gapText.content) {
+                appendHtmlFragment(gapText.content, gapTextEl);
+            }
+        }
+        if (options.content) {
+            appendHtmlFragment(options.content, this.item);
+        }
+    }
+}
+//# sourceMappingURL=gap-match-interaction.js.map

package/dist/qti/interactions/gap-match-interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gap-match-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/gap-match-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAkBtD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,mBAAoB,SAAQ,oBAAoB;IAC3D,YAAY,OAAmC;QAC7C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,2BAA2B,EAAE;YACtD,qBAAqB,EAAE,OAAO,CAAC,kBAAkB;YACjD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;YAC3C,kBAAkB,EAAE,OAAO,CAAC,eAAe,EAAE,QAAQ,EAAE;YACvD,kBAAkB,EAAE,OAAO,CAAC,eAAe,EAAE,QAAQ,EAAE;SACxD,CAAC,CAAC;QAEH,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE;gBAC9C,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE;gBACzC,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE;gBACzC,aAAa,EAAE,OAAO,CAAC,UAAU;aAClC,CAAC,CAAC;YAEH,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;CACF"}

package/dist/qti/interactions/graphic-associate-interaction.d.ts

@@ -0,0 +1,37 @@
+import { HotspotShape, ObjectOptions } from "./hotspot-interaction";
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export { HotspotShape, ObjectOptions };
+export type AssociableHotspotOptions = {
+    identifier: string;
+    shape: HotspotShape;
+    coords: string;
+    matchMax?: number;
+    matchMin?: number;
+    matchGroup?: string;
+    hotspotLabel?: string;
+};
+export type GraphicAssociateInteractionOptions = QtiPromptInteractionOptions & {
+    minAssociations?: number;
+    maxAssociations?: number;
+    object: ObjectOptions;
+    associableHotspots?: AssociableHotspotOptions[];
+};
+/**
+ * Presents an image with hotspots for candidates to associate or connect with each other.
+ * Used for drawing connections between points on a diagram or map.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.acwq9g2z1cwt
+ *
+ * @example
+ * const interaction = new GraphicAssociateInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   object: { data: "circuit.png", type: "image/png", width: 400, height: 300 },
+ *   associableHotspots: [
+ *     { identifier: "A", shape: "circle", coords: "100,100,15", matchMax: 1 },
+ *     { identifier: "B", shape: "circle", coords: "200,100,15", matchMax: 1 },
+ *   ],
+ * });
+ */
+export declare class GraphicAssociateInteraction extends QtiPromptInteraction {
+    constructor(options: GraphicAssociateInteractionOptions);
+}

package/dist/qti/interactions/graphic-associate-interaction.js

@@ -0,0 +1,47 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+/**
+ * Presents an image with hotspots for candidates to associate or connect with each other.
+ * Used for drawing connections between points on a diagram or map.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.acwq9g2z1cwt
+ *
+ * @example
+ * const interaction = new GraphicAssociateInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   object: { data: "circuit.png", type: "image/png", width: 400, height: 300 },
+ *   associableHotspots: [
+ *     { identifier: "A", shape: "circle", coords: "100,100,15", matchMax: 1 },
+ *     { identifier: "B", shape: "circle", coords: "200,100,15", matchMax: 1 },
+ *   ],
+ * });
+ */
+export class GraphicAssociateInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-graphic-associate-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            "min-associations": options.minAssociations?.toString(),
+            "max-associations": options.maxAssociations?.toString(),
+        });
+        this.item.ele("object", {
+            data: options.object.data,
+            type: options.object.type,
+            width: options.object.width?.toString(),
+            height: options.object.height?.toString(),
+        });
+        for (const hotspot of options.associableHotspots || []) {
+            this.item.ele("qti-associable-hotspot", {
+                identifier: hotspot.identifier,
+                shape: hotspot.shape,
+                coords: hotspot.coords,
+                "match-max": hotspot.matchMax?.toString(),
+                "match-min": hotspot.matchMin?.toString(),
+                "match-group": hotspot.matchGroup,
+                "hotspot-label": hotspot.hotspotLabel,
+            });
+        }
+    }
+}
+//# sourceMappingURL=graphic-associate-interaction.js.map

package/dist/qti/interactions/graphic-associate-interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphic-associate-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/graphic-associate-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AAqBvB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,2BAA4B,SAAQ,oBAAoB;IACnE,YAAY,OAA2C;QACrD,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,mCAAmC,EAAE;YAC9D,qBAAqB,EAAE,OAAO,CAAC,kBAAkB;YACjD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,kBAAkB,EAAE,OAAO,CAAC,eAAe,EAAE,QAAQ,EAAE;YACvD,kBAAkB,EAAE,OAAO,CAAC,eAAe,EAAE,QAAQ,EAAE;SACxD,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE;YACtB,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;YACzB,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;YACzB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE;YACvC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE;SAC1C,CAAC,CAAC;QAEH,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,kBAAkB,IAAI,EAAE,EAAE,CAAC;YACvD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,wBAAwB,EAAE;gBACtC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE;gBACzC,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE;gBACzC,aAAa,EAAE,OAAO,CAAC,UAAU;gBACjC,eAAe,EAAE,OAAO,CAAC,YAAY;aACtC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}