@examplary/qti 0.0.1 → 1.0.0

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

@@ -0,0 +1,63 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+import { appendHtmlFragment } from "../../utils/html";
+/**
+ * Presents two sets of choices for candidates to match or associate with each other.
+ * Commonly used for matching terms with definitions or pairing related concepts.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.be4ll1tm4t99
+ *
+ * @example
+ * const interaction = new MatchInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   sourceChoices: [
+ *     { identifier: "S1", content: "Paris", matchMax: 1 },
+ *     { identifier: "S2", content: "London", matchMax: 1 },
+ *   ],
+ *   targetChoices: [
+ *     { identifier: "T1", content: "France", matchMax: 1 },
+ *     { identifier: "T2", content: "England", matchMax: 1 },
+ *   ],
+ * });
+ */
+export class MatchInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-match-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            shuffle: options.shuffle ? "true" : "false",
+            "min-associations": options.minAssociations?.toString(),
+            "max-associations": options.maxAssociations?.toString(),
+        });
+        const sourceSet = this.item.ele("qti-simple-match-set");
+        for (const choice of options.sourceChoices || []) {
+            const choiceEl = sourceSet.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);
+            }
+        }
+        const targetSet = this.item.ele("qti-simple-match-set");
+        for (const choice of options.targetChoices || []) {
+            const choiceEl = targetSet.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=match-interaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"match-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/match-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAUtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,gBAAiB,SAAQ,oBAAoB;IACxD,YAAY,OAAgC;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,uBAAuB,EAAE;YAClD,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,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACxD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;YACjD,MAAM,QAAQ,GAAG,SAAS,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;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACxD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;YACjD,MAAM,QAAQ,GAAG,SAAS,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/media-interaction.d.ts

@@ -0,0 +1,31 @@
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export type MediaObjectOptions = {
+    data: string;
+    type: string;
+    width?: number;
+    height?: number;
+};
+export type MediaInteractionOptions = QtiPromptInteractionOptions & {
+    autostart?: boolean;
+    minPlays?: number;
+    maxPlays?: number;
+    loop?: boolean;
+    object: MediaObjectOptions;
+};
+/**
+ * Presents audio or video content that candidates must engage with before responding.
+ * Used for listening comprehension, video analysis, or multimedia-based questions.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.u9utgghwf8ck
+ *
+ * @example
+ * const interaction = new MediaInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   minPlays: 1,
+ *   maxPlays: 3,
+ *   object: { data: "audio.mp3", type: "audio/mpeg" },
+ * });
+ */
+export declare class MediaInteraction extends QtiPromptInteraction {
+    constructor(options: MediaInteractionOptions);
+}

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

@@ -0,0 +1,36 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+/**
+ * Presents audio or video content that candidates must engage with before responding.
+ * Used for listening comprehension, video analysis, or multimedia-based questions.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.u9utgghwf8ck
+ *
+ * @example
+ * const interaction = new MediaInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   minPlays: 1,
+ *   maxPlays: 3,
+ *   object: { data: "audio.mp3", type: "audio/mpeg" },
+ * });
+ */
+export class MediaInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-media-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            autostart: options.autostart ? "true" : undefined,
+            "min-plays": options.minPlays?.toString(),
+            "max-plays": options.maxPlays?.toString(),
+            loop: options.loop ? "true" : undefined,
+        });
+        this.item.ele("object", {
+            data: options.object.data,
+            type: options.object.type,
+            width: options.object.width?.toString(),
+            height: options.object.height?.toString(),
+        });
+    }
+}
+//# sourceMappingURL=media-interaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/media-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AAiBvB;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,gBAAiB,SAAQ,oBAAoB;IACxD,YAAY,OAAgC;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,uBAAuB,EAAE;YAClD,qBAAqB,EAAE,OAAO,CAAC,kBAAkB;YACjD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YACjD,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE;YACzC,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE;YACzC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SACxC,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/order-interaction.d.ts

@@ -0,0 +1,28 @@
+import { SimpleChoiceOptions } from "./choice-interaction";
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export type OrderInteractionOptions = QtiPromptInteractionOptions & {
+    shuffle?: boolean;
+    minChoices?: number;
+    maxChoices?: number;
+    orientation?: "horizontal" | "vertical";
+    choices?: SimpleChoiceOptions[];
+};
+/**
+ * Presents a set of choices for candidates to arrange in a specific order or sequence.
+ * Used for ranking, sequencing, or prioritization questions.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.4n8gips6tlv4
+ *
+ * @example
+ * const interaction = new OrderInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   choices: [
+ *     { identifier: "A", content: "First step" },
+ *     { identifier: "B", content: "Second step" },
+ *     { identifier: "C", content: "Third step" },
+ *   ],
+ * });
+ */
+export declare class OrderInteraction extends QtiPromptInteraction {
+    constructor(options: OrderInteractionOptions);
+}

package/dist/qti/interactions/order-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 arrange in a specific order or sequence.
+ * Used for ranking, sequencing, or prioritization questions.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.4n8gips6tlv4
+ *
+ * @example
+ * const interaction = new OrderInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   choices: [
+ *     { identifier: "A", content: "First step" },
+ *     { identifier: "B", content: "Second step" },
+ *     { identifier: "C", content: "Third step" },
+ *   ],
+ * });
+ */
+export class OrderInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-order-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            shuffle: options.shuffle ? "true" : "false",
+            "min-choices": options.minChoices?.toString(),
+            "max-choices": options.maxChoices?.toString(),
+            orientation: options.orientation,
+        });
+        for (const choice of options.choices || []) {
+            const choiceEl = this.item.ele("qti-simple-choice", {
+                identifier: choice.identifier,
+                fixed: choice.fixed ? "true" : undefined,
+                "template-identifier": choice.templateIdentifier,
+            });
+            if (choice.content) {
+                appendHtmlFragment(choice.content, choiceEl);
+            }
+        }
+    }
+}
+//# sourceMappingURL=order-interaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"order-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/order-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAUtD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,gBAAiB,SAAQ,oBAAoB;IACxD,YAAY,OAAgC;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,uBAAuB,EAAE;YAClD,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;SACjC,CAAC,CAAC;QAEH,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE;gBAClD,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,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/position-object-interaction.d.ts

@@ -0,0 +1,36 @@
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export type PositionObjectStageOptions = {
+    data: string;
+    type: string;
+    width?: number;
+    height?: number;
+};
+export type PositionObjectOptions = {
+    data: string;
+    type: string;
+    width?: number;
+    height?: number;
+};
+export type PositionObjectInteractionOptions = QtiPromptInteractionOptions & {
+    centerPoint?: string;
+    minChoices?: number;
+    maxChoices?: number;
+    object: PositionObjectOptions;
+    positionObjectStage?: PositionObjectStageOptions;
+};
+/**
+ * Presents a movable object that candidates must position on a background stage.
+ * Used for placing items at specific coordinates on a canvas or diagram.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.4jhs37jil26s
+ *
+ * @example
+ * const interaction = new PositionObjectInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   object: { data: "marker.png", type: "image/png", width: 20, height: 20 },
+ *   positionObjectStage: { data: "map.png", type: "image/png", width: 400, height: 300 },
+ * });
+ */
+export declare class PositionObjectInteraction extends QtiPromptInteraction {
+    constructor(options: PositionObjectInteractionOptions);
+}

package/dist/qti/interactions/position-object-interaction.js

@@ -0,0 +1,43 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+/**
+ * Presents a movable object that candidates must position on a background stage.
+ * Used for placing items at specific coordinates on a canvas or diagram.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.4jhs37jil26s
+ *
+ * @example
+ * const interaction = new PositionObjectInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   object: { data: "marker.png", type: "image/png", width: 20, height: 20 },
+ *   positionObjectStage: { data: "map.png", type: "image/png", width: 400, height: 300 },
+ * });
+ */
+export class PositionObjectInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-position-object-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            "center-point": options.centerPoint,
+            "min-choices": options.minChoices?.toString(),
+            "max-choices": options.maxChoices?.toString(),
+        });
+        this.item.ele("object", {
+            data: options.object.data,
+            type: options.object.type,
+            width: options.object.width?.toString(),
+            height: options.object.height?.toString(),
+        });
+        if (options.positionObjectStage) {
+            const stage = this.item.ele("qti-position-object-stage");
+            stage.ele("object", {
+                data: options.positionObjectStage.data,
+                type: options.positionObjectStage.type,
+                width: options.positionObjectStage.width?.toString(),
+                height: options.positionObjectStage.height?.toString(),
+            });
+        }
+    }
+}
+//# sourceMappingURL=position-object-interaction.js.map

package/dist/qti/interactions/position-object-interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"position-object-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/position-object-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AAwBvB;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,yBAA0B,SAAQ,oBAAoB;IACjE,YAAY,OAAyC;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,iCAAiC,EAAE;YAC5D,qBAAqB,EAAE,OAAO,CAAC,kBAAkB;YACjD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,cAAc,EAAE,OAAO,CAAC,WAAW;YACnC,aAAa,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;YAC7C,aAAa,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;SAC9C,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,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;YACzD,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;gBAClB,IAAI,EAAE,OAAO,CAAC,mBAAmB,CAAC,IAAI;gBACtC,IAAI,EAAE,OAAO,CAAC,mBAAmB,CAAC,IAAI;gBACtC,KAAK,EAAE,OAAO,CAAC,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE;gBACpD,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,MAAM,EAAE,QAAQ,EAAE;aACvD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/qti/interactions/select-point-interaction.d.ts

@@ -0,0 +1,28 @@
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export type SelectPointObjectOptions = {
+    data: string;
+    type: string;
+    width?: number;
+    height?: number;
+};
+export type SelectPointInteractionOptions = QtiPromptInteractionOptions & {
+    minChoices?: number;
+    maxChoices?: number;
+    object: SelectPointObjectOptions;
+};
+/**
+ * Presents an image where candidates select specific coordinate points.
+ * Used for identifying precise locations on maps, graphs, or diagrams.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.ev30y6ze263d
+ *
+ * @example
+ * const interaction = new SelectPointInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   maxChoices: 1,
+ *   object: { data: "graph.png", type: "image/png", width: 400, height: 300 },
+ * });
+ */
+export declare class SelectPointInteraction extends QtiPromptInteraction {
+    constructor(options: SelectPointInteractionOptions);
+}

package/dist/qti/interactions/select-point-interaction.js

@@ -0,0 +1,33 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+/**
+ * Presents an image where candidates select specific coordinate points.
+ * Used for identifying precise locations on maps, graphs, or diagrams.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.ev30y6ze263d
+ *
+ * @example
+ * const interaction = new SelectPointInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   maxChoices: 1,
+ *   object: { data: "graph.png", type: "image/png", width: 400, height: 300 },
+ * });
+ */
+export class SelectPointInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-select-point-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            "min-choices": options.minChoices?.toString(),
+            "max-choices": options.maxChoices?.toString(),
+        });
+        this.item.ele("object", {
+            data: options.object.data,
+            type: options.object.type,
+            width: options.object.width?.toString(),
+            height: options.object.height?.toString(),
+        });
+    }
+}
+//# sourceMappingURL=select-point-interaction.js.map

package/dist/qti/interactions/select-point-interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-point-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/select-point-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AAevB;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,sBAAuB,SAAQ,oBAAoB;IAC9D,YAAY,OAAsC;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,8BAA8B,EAAE;YACzD,qBAAqB,EAAE,OAAO,CAAC,kBAAkB;YACjD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,aAAa,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;YAC7C,aAAa,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;SAC9C,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/slider-interaction.d.ts

@@ -0,0 +1,26 @@
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export type SliderInteractionOptions = QtiPromptInteractionOptions & {
+    lowerBound: number;
+    upperBound: number;
+    step?: number;
+    stepLabel?: boolean;
+    orientation?: "horizontal" | "vertical";
+    reverse?: boolean;
+};
+/**
+ * Presents a slider control for candidates to select a numeric value within a range.
+ * Used for questions requiring numeric input, ratings, or scale-based responses.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.s61xcrj4qcyj
+ *
+ * @example
+ * const interaction = new SliderInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   lowerBound: 0,
+ *   upperBound: 100,
+ *   step: 10,
+ * });
+ */
+export declare class SliderInteraction extends QtiPromptInteraction {
+    constructor(options: SliderInteractionOptions);
+}

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

@@ -0,0 +1,32 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+/**
+ * Presents a slider control for candidates to select a numeric value within a range.
+ * Used for questions requiring numeric input, ratings, or scale-based responses.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.s61xcrj4qcyj
+ *
+ * @example
+ * const interaction = new SliderInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   lowerBound: 0,
+ *   upperBound: 100,
+ *   step: 10,
+ * });
+ */
+export class SliderInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-slider-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            "lower-bound": options.lowerBound.toString(),
+            "upper-bound": options.upperBound.toString(),
+            step: options.step?.toString(),
+            "step-label": options.stepLabel ? "true" : undefined,
+            orientation: options.orientation,
+            reverse: options.reverse ? "true" : undefined,
+        });
+    }
+}
+//# sourceMappingURL=slider-interaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slider-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/slider-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AAWvB;;;;;;;;;;;;;GAaG;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,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE;YAC5C,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE;YAC5C,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE;YAC9B,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YACpD,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,25 @@
+import { QtiInteraction, QtiInteractionOptions } from "./interaction";
+export type TextEntryInteractionOptions = QtiInteractionOptions & {
+    stringIdentifier?: string;
+    expectedLength?: number;
+    placeholderText?: string;
+    format?: string;
+    patternMask?: string;
+    patternMaskMessage?: string;
+};
+/**
+ * Presents a text input field for candidates to enter a short text response.
+ * Used for fill-in-the-blank or short answer questions embedded inline.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.5bw8rpbotrcs
+ *
+ * @example
+ * const interaction = new TextEntryInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   expectedLength: 20,
+ *   placeholderText: "Enter your answer",
+ * });
+ */
+export declare class TextEntryInteraction extends QtiInteraction {
+    constructor(options: TextEntryInteractionOptions);
+}

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

@@ -0,0 +1,31 @@
+import { fragment } from "xmlbuilder2";
+import { QtiInteraction } from "./interaction";
+/**
+ * Presents a text input field for candidates to enter a short text response.
+ * Used for fill-in-the-blank or short answer questions embedded inline.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.5bw8rpbotrcs
+ *
+ * @example
+ * const interaction = new TextEntryInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   expectedLength: 20,
+ *   placeholderText: "Enter your answer",
+ * });
+ */
+export class TextEntryInteraction extends QtiInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-text-entry-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            "string-identifier": options.stringIdentifier,
+            "expected-length": options.expectedLength?.toString(),
+            "placeholder-text": options.placeholderText,
+            format: options.format,
+            "pattern-mask": options.patternMask,
+            "data-patternmask-message": options.patternMaskMessage,
+        });
+    }
+}
+//# sourceMappingURL=text-entry-interaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text-entry-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/text-entry-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,cAAc,EAAyB,MAAM,eAAe,CAAC;AAWtE;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,oBAAqB,SAAQ,cAAc;IACtD,YAAY,OAAoC;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC,GAAG,CAAC,4BAA4B,EAAE;YACvD,qBAAqB,EAAE,OAAO,CAAC,kBAAkB;YACjD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,mBAAmB,EAAE,OAAO,CAAC,gBAAgB;YAC7C,iBAAiB,EAAE,OAAO,CAAC,cAAc,EAAE,QAAQ,EAAE;YACrD,kBAAkB,EAAE,OAAO,CAAC,eAAe;YAC3C,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,cAAc,EAAE,OAAO,CAAC,WAAW;YACnC,0BAA0B,EAAE,OAAO,CAAC,kBAAkB;SACvD,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,19 @@
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export type UploadInteractionOptions = QtiPromptInteractionOptions & {
+    type?: string;
+};
+/**
+ * Allows candidates to upload a file as their response.
+ * Used for submitting documents, images, or other file-based answers.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.qtnex0r52anx
+ *
+ * @example
+ * const interaction = new UploadInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   type: "application/pdf",
+ * });
+ */
+export declare class UploadInteraction extends QtiPromptInteraction {
+    constructor(options: UploadInteractionOptions);
+}

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

@@ -0,0 +1,25 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+/**
+ * Allows candidates to upload a file as their response.
+ * Used for submitting documents, images, or other file-based answers.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.qtnex0r52anx
+ *
+ * @example
+ * const interaction = new UploadInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   type: "application/pdf",
+ * });
+ */
+export class UploadInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-upload-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            type: options.type,
+        });
+    }
+}
+//# sourceMappingURL=upload-interaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upload-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/upload-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AAMvB;;;;;;;;;;;GAWG;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,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,11 @@
+import { XMLBuilder } from "xmlbuilder2/lib/interfaces";
+export type NamespacedElementContent = string | {
+    [key: string]: NamespacedElementContent;
+} | NamespacedElementContent[];
+export declare abstract class QtiElement {
+    protected abstract getRootElement(): XMLBuilder;
+    buildXml(): string;
+    registerNamespace(prefix: string, uri: string): void;
+    addNamespacedElement(namespace: string, elementName: string, content: NamespacedElementContent, attributes?: Record<string, string>): void;
+    private appendContent;
+}

package/dist/qti/qti-element.js

@@ -0,0 +1,29 @@
+export class QtiElement {
+    buildXml() {
+        return this.getRootElement().end({ prettyPrint: true });
+    }
+    registerNamespace(prefix, uri) {
+        this.getRootElement().att(`xmlns:${prefix}`, uri);
+    }
+    addNamespacedElement(namespace, elementName, content, attributes) {
+        const element = this.getRootElement().ele(`${namespace}:${elementName}`, attributes);
+        this.appendContent(element, namespace, content);
+    }
+    appendContent(element, namespace, content) {
+        if (typeof content === "string") {
+            element.txt(content);
+        }
+        else if (Array.isArray(content)) {
+            for (const item of content) {
+                this.appendContent(element, namespace, item);
+            }
+        }
+        else {
+            for (const [key, value] of Object.entries(content)) {
+                const child = element.ele(`${namespace}:${key}`);
+                this.appendContent(child, namespace, value);
+            }
+        }
+    }
+}
+//# sourceMappingURL=qti-element.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qti-element.js","sourceRoot":"","sources":["../../src/qti/qti-element.ts"],"names":[],"mappings":"AAOA,MAAM,OAAgB,UAAU;IAGvB,QAAQ;QACb,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAEM,iBAAiB,CAAC,MAAc,EAAE,GAAW;QAClD,IAAI,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,SAAS,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC;IAEM,oBAAoB,CACzB,SAAiB,EACjB,WAAmB,EACnB,OAAiC,EACjC,UAAmC;QAEnC,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,GAAG,CACvC,GAAG,SAAS,IAAI,WAAW,EAAE,EAC7B,UAAU,CACX,CAAC;QACF,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAEO,aAAa,CACnB,OAAmB,EACnB,SAAiB,EACjB,OAAiC;QAEjC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;gBAC3B,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC,CAAC;gBACjD,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

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

@@ -1,3 +1,6 @@
+import { XMLBuilder } from "xmlbuilder2/lib/interfaces";
+import { QtiInteraction } from "./interactions/interaction";
+import { QtiElement } from "./qti-element";
 import { QtiTest } from "./qti-test";
 import { QtiCardinality, QtiBaseType, QtiAudience } from "./types";
 import { ImsPackage } from "../ims/ims-package";
@@ -35,7 +38,7 @@ export declare enum ResponseProcessingTemplate {
     MapResponse = "https://purl.imsglobal.org/spec/qti/v3p0/rptemplates/map_response.xml",
     MapResponsePoint = "https://purl.imsglobal.org/spec/qti/v3p0/rptemplates/map_response_point.xml"
 }
-export declare class QtiItem {
+export declare class QtiItem extends QtiElement {
     identifier: string;
     adaptive?: boolean;
     timeDependent?: boolean;
@@ -48,14 +51,15 @@ export declare class QtiItem {
     private itemBody?;
     private responseDeclarations;
     constructor(options?: QtiItemOptions);
-    buildXml(): string;
-    addToPackage(pkg: ImsPackage): void;
+    addToPackage(pkg: ImsPackage): Promise<void>;
     addToTest(test: QtiTest): void;
     private getOrCreateItemBody;
     addItemBodyFromHtml(html: string): void;
+    addInteraction(interaction: QtiInteraction): void;
     addPciInteraction(interaction: PciInteraction, externalModules?: boolean): void;
     addResponseDeclaration(responseDeclaration?: ResponseDeclaration): void;
     addCorrectResponse(identifier: string, values: string[]): void;
     addResponseProcessing(template: ResponseProcessingTemplate): void;
     addOutcomeDeclaration(outcomeDeclaration?: OutcomeDeclaration): void;
+    protected getRootElement(): XMLBuilder;
 }