@examplary/qti 0.0.1 → 1.0.0

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

@@ -0,0 +1,42 @@
+import { AssociableHotspotOptions } from "./graphic-associate-interaction";
+import { ObjectOptions } from "./hotspot-interaction";
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export type GapImgOptions = {
+    identifier: string;
+    matchMax?: number;
+    matchMin?: number;
+    matchGroup?: string;
+    objectData: string;
+    objectType: string;
+    objectWidth?: number;
+    objectHeight?: number;
+    label?: string;
+};
+export type GraphicGapMatchInteractionOptions = QtiPromptInteractionOptions & {
+    minAssociations?: number;
+    maxAssociations?: number;
+    object: ObjectOptions;
+    gapImgs?: GapImgOptions[];
+    associableHotspots?: AssociableHotspotOptions[];
+};
+/**
+ * Presents an image with gap regions and a set of images/text to drag onto those regions.
+ * Used for labeling diagrams or placing items in specific locations on an image.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.ous502odpreo
+ *
+ * @example
+ * const interaction = new GraphicGapMatchInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   object: { data: "diagram.png", type: "image/png", width: 400, height: 300 },
+ *   gapImgs: [
+ *     { identifier: "img1", objectData: "label1.png", objectType: "image/png" },
+ *   ],
+ *   associableHotspots: [
+ *     { identifier: "gap1", shape: "rect", coords: "50,50,100,80", matchMax: 1 },
+ *   ],
+ * });
+ */
+export declare class GraphicGapMatchInteraction extends QtiPromptInteraction {
+    constructor(options: GraphicGapMatchInteractionOptions);
+}

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

@@ -0,0 +1,64 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+/**
+ * Presents an image with gap regions and a set of images/text to drag onto those regions.
+ * Used for labeling diagrams or placing items in specific locations on an image.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.ous502odpreo
+ *
+ * @example
+ * const interaction = new GraphicGapMatchInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   object: { data: "diagram.png", type: "image/png", width: 400, height: 300 },
+ *   gapImgs: [
+ *     { identifier: "img1", objectData: "label1.png", objectType: "image/png" },
+ *   ],
+ *   associableHotspots: [
+ *     { identifier: "gap1", shape: "rect", coords: "50,50,100,80", matchMax: 1 },
+ *   ],
+ * });
+ */
+export class GraphicGapMatchInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-graphic-gap-match-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 gapImg of options.gapImgs || []) {
+            const gapImgEl = this.item.ele("qti-gap-img", {
+                identifier: gapImg.identifier,
+                "match-max": gapImg.matchMax?.toString(),
+                "match-min": gapImg.matchMin?.toString(),
+                "match-group": gapImg.matchGroup,
+                label: gapImg.label,
+            });
+            gapImgEl.ele("object", {
+                data: gapImg.objectData,
+                type: gapImg.objectType,
+                width: gapImg.objectWidth?.toString(),
+                height: gapImg.objectHeight?.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-gap-match-interaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphic-gap-match-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/graphic-gap-match-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AAsBvB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,0BAA2B,SAAQ,oBAAoB;IAClE,YAAY,OAA0C;QACpD,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,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE;gBAC5C,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;aACpB,CAAC,CAAC;YAEH,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE;gBACrB,IAAI,EAAE,MAAM,CAAC,UAAU;gBACvB,IAAI,EAAE,MAAM,CAAC,UAAU;gBACvB,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE;gBACrC,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,QAAQ,EAAE;aACxC,CAAC,CAAC;QACL,CAAC;QAED,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"}

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

@@ -0,0 +1,28 @@
+import { HotspotShape, ObjectOptions, HotspotChoiceOptions } from "./hotspot-interaction";
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export { HotspotShape, ObjectOptions, HotspotChoiceOptions };
+export type GraphicOrderInteractionOptions = QtiPromptInteractionOptions & {
+    minChoices?: number;
+    maxChoices?: number;
+    object: ObjectOptions;
+    hotspotChoices?: HotspotChoiceOptions[];
+};
+/**
+ * Presents an image with hotspots for candidates to select in a specific order.
+ * Used for sequencing tasks on diagrams, maps, or other visual content.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.973pocg92wxf
+ *
+ * @example
+ * const interaction = new GraphicOrderInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   object: { data: "diagram.png", type: "image/png", width: 400, height: 300 },
+ *   hotspotChoices: [
+ *     { identifier: "A", shape: "circle", coords: "100,100,20" },
+ *     { identifier: "B", shape: "circle", coords: "200,150,20" },
+ *   ],
+ * });
+ */
+export declare class GraphicOrderInteraction extends QtiPromptInteraction {
+    constructor(options: GraphicOrderInteractionOptions);
+}

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

@@ -0,0 +1,46 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+/**
+ * Presents an image with hotspots for candidates to select in a specific order.
+ * Used for sequencing tasks on diagrams, maps, or other visual content.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.973pocg92wxf
+ *
+ * @example
+ * const interaction = new GraphicOrderInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   object: { data: "diagram.png", type: "image/png", width: 400, height: 300 },
+ *   hotspotChoices: [
+ *     { identifier: "A", shape: "circle", coords: "100,100,20" },
+ *     { identifier: "B", shape: "circle", coords: "200,150,20" },
+ *   ],
+ * });
+ */
+export class GraphicOrderInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-graphic-order-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(),
+        });
+        for (const hotspot of options.hotspotChoices || []) {
+            this.item.ele("qti-hotspot-choice", {
+                identifier: hotspot.identifier,
+                shape: hotspot.shape,
+                coords: hotspot.coords,
+                "hotspot-label": hotspot.hotspotLabel,
+                fixed: hotspot.fixed ? "true" : undefined,
+                "template-identifier": hotspot.templateIdentifier,
+            });
+        }
+    }
+}
+//# sourceMappingURL=graphic-order-interaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphic-order-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/graphic-order-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAOvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AAWvB;;;;;;;;;;;;;;;GAeG;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,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,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,cAAc,IAAI,EAAE,EAAE,CAAC;YACnD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE;gBAClC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,eAAe,EAAE,OAAO,CAAC,YAAY;gBACrC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBACzC,qBAAqB,EAAE,OAAO,CAAC,kBAAkB;aAClD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,41 @@
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export type HotspotShape = "circle" | "rect" | "poly" | "ellipse" | "default";
+export type HotspotChoiceOptions = {
+    identifier: string;
+    shape: HotspotShape;
+    coords: string;
+    hotspotLabel?: string;
+    fixed?: boolean;
+    templateIdentifier?: string;
+};
+export type ObjectOptions = {
+    data: string;
+    type: string;
+    width?: number;
+    height?: number;
+};
+export type HotspotInteractionOptions = QtiPromptInteractionOptions & {
+    minChoices?: number;
+    maxChoices?: number;
+    object: ObjectOptions;
+    hotspotChoices?: HotspotChoiceOptions[];
+};
+/**
+ * Presents an image with defined clickable regions (hotspots) for candidates to select.
+ * Used for questions where candidates identify specific areas on a diagram or map.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.y2th8rh73267
+ *
+ * @example
+ * const interaction = new HotspotInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   maxChoices: 1,
+ *   object: { data: "map.png", type: "image/png", width: 400, height: 300 },
+ *   hotspotChoices: [
+ *     { identifier: "A", shape: "circle", coords: "100,100,20" },
+ *   ],
+ * });
+ */
+export declare class HotspotInteraction extends QtiPromptInteraction {
+    constructor(options: HotspotInteractionOptions);
+}

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

@@ -0,0 +1,46 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+/**
+ * Presents an image with defined clickable regions (hotspots) for candidates to select.
+ * Used for questions where candidates identify specific areas on a diagram or map.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.y2th8rh73267
+ *
+ * @example
+ * const interaction = new HotspotInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   maxChoices: 1,
+ *   object: { data: "map.png", type: "image/png", width: 400, height: 300 },
+ *   hotspotChoices: [
+ *     { identifier: "A", shape: "circle", coords: "100,100,20" },
+ *   ],
+ * });
+ */
+export class HotspotInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-hotspot-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(),
+        });
+        for (const hotspot of options.hotspotChoices || []) {
+            this.item.ele("qti-hotspot-choice", {
+                identifier: hotspot.identifier,
+                shape: hotspot.shape,
+                coords: hotspot.coords,
+                "hotspot-label": hotspot.hotspotLabel,
+                fixed: hotspot.fixed ? "true" : undefined,
+                "template-identifier": hotspot.templateIdentifier,
+            });
+        }
+    }
+}
+//# sourceMappingURL=hotspot-interaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hotspot-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/hotspot-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AA2BvB;;;;;;;;;;;;;;;GAeG;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;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;QAEH,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,cAAc,IAAI,EAAE,EAAE,CAAC;YACnD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE;gBAClC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,eAAe,EAAE,OAAO,CAAC,YAAY;gBACrC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBACzC,qBAAqB,EAAE,OAAO,CAAC,kBAAkB;aAClD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,22 @@
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export type HottextInteractionOptions = QtiPromptInteractionOptions & {
+    minChoices?: number;
+    maxChoices?: number;
+    content?: string;
+};
+/**
+ * Presents text with selectable words or phrases (hottext) for candidates to choose.
+ * Used for questions where candidates identify specific parts of a text passage.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.sbnpx830yzqu
+ *
+ * @example
+ * const interaction = new HottextInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   maxChoices: 1,
+ *   content: "<p>Select the <qti-hottext identifier='A'>noun</qti-hottext> in: The <qti-hottext identifier='B'>cat</qti-hottext> sat.</p>",
+ * });
+ */
+export declare class HottextInteraction extends QtiPromptInteraction {
+    constructor(options: HottextInteractionOptions);
+}

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

@@ -0,0 +1,31 @@
+import { fragment } from "xmlbuilder2";
+import { QtiPromptInteraction, } from "./interaction";
+import { appendHtmlFragment } from "../../utils/html";
+/**
+ * Presents text with selectable words or phrases (hottext) for candidates to choose.
+ * Used for questions where candidates identify specific parts of a text passage.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.sbnpx830yzqu
+ *
+ * @example
+ * const interaction = new HottextInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   maxChoices: 1,
+ *   content: "<p>Select the <qti-hottext identifier='A'>noun</qti-hottext> in: The <qti-hottext identifier='B'>cat</qti-hottext> sat.</p>",
+ * });
+ */
+export class HottextInteraction extends QtiPromptInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-hottext-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            "min-choices": options.minChoices?.toString(),
+            "max-choices": options.maxChoices?.toString(),
+        });
+        if (options.content) {
+            appendHtmlFragment(options.content, this.item);
+        }
+    }
+}
+//# sourceMappingURL=hottext-interaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hottext-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/hottext-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;AAQtD;;;;;;;;;;;;GAYG;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;YACpB,aAAa,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;YAC7C,aAAa,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE;SAC9C,CAAC,CAAC;QAEH,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/index.d.ts

@@ -0,0 +1,63 @@
+import { AssociateInteraction } from "./associate-interaction";
+import { ChoiceInteraction } from "./choice-interaction";
+import { DrawingInteraction } from "./drawing-interaction";
+import { EndAttemptInteraction } from "./end-attempt-interaction";
+import { ExtendedTextInteraction } from "./extended-text-interaction";
+import { GapMatchInteraction } from "./gap-match-interaction";
+import { GraphicAssociateInteraction } from "./graphic-associate-interaction";
+import { GraphicGapMatchInteraction } from "./graphic-gap-match-interaction";
+import { GraphicOrderInteraction } from "./graphic-order-interaction";
+import { HotspotInteraction } from "./hotspot-interaction";
+import { HottextInteraction } from "./hottext-interaction";
+import { InlineChoiceInteraction } from "./inline-choice-interaction";
+import { MatchInteraction } from "./match-interaction";
+import { MediaInteraction } from "./media-interaction";
+import { OrderInteraction } from "./order-interaction";
+import { PositionObjectInteraction } from "./position-object-interaction";
+import { SelectPointInteraction } from "./select-point-interaction";
+import { SliderInteraction } from "./slider-interaction";
+import { TextEntryInteraction } from "./text-entry-interaction";
+import { UploadInteraction } from "./upload-interaction";
+export * from "./associate-interaction";
+export * from "./choice-interaction";
+export * from "./drawing-interaction";
+export * from "./end-attempt-interaction";
+export * from "./extended-text-interaction";
+export * from "./gap-match-interaction";
+export * from "./graphic-associate-interaction";
+export * from "./graphic-gap-match-interaction";
+export * from "./graphic-order-interaction";
+export * from "./hotspot-interaction";
+export * from "./hottext-interaction";
+export * from "./inline-choice-interaction";
+export * from "./interaction";
+export * from "./match-interaction";
+export * from "./media-interaction";
+export * from "./order-interaction";
+export * from "./position-object-interaction";
+export * from "./select-point-interaction";
+export * from "./slider-interaction";
+export * from "./text-entry-interaction";
+export * from "./upload-interaction";
+export declare const qtiInteractionTypes: {
+    AssociateInteraction: typeof AssociateInteraction;
+    ChoiceInteraction: typeof ChoiceInteraction;
+    DrawingInteraction: typeof DrawingInteraction;
+    EndAttemptInteraction: typeof EndAttemptInteraction;
+    ExtendedTextInteraction: typeof ExtendedTextInteraction;
+    GapMatchInteraction: typeof GapMatchInteraction;
+    GraphicAssociateInteraction: typeof GraphicAssociateInteraction;
+    GraphicGapMatchInteraction: typeof GraphicGapMatchInteraction;
+    GraphicOrderInteraction: typeof GraphicOrderInteraction;
+    HotspotInteraction: typeof HotspotInteraction;
+    HottextInteraction: typeof HottextInteraction;
+    InlineChoiceInteraction: typeof InlineChoiceInteraction;
+    MatchInteraction: typeof MatchInteraction;
+    MediaInteraction: typeof MediaInteraction;
+    OrderInteraction: typeof OrderInteraction;
+    PositionObjectInteraction: typeof PositionObjectInteraction;
+    SelectPointInteraction: typeof SelectPointInteraction;
+    SliderInteraction: typeof SliderInteraction;
+    TextEntryInteraction: typeof TextEntryInteraction;
+    UploadInteraction: typeof UploadInteraction;
+};

package/dist/qti/interactions/index.js

@@ -0,0 +1,64 @@
+import { AssociateInteraction } from "./associate-interaction";
+import { ChoiceInteraction } from "./choice-interaction";
+import { DrawingInteraction } from "./drawing-interaction";
+import { EndAttemptInteraction } from "./end-attempt-interaction";
+import { ExtendedTextInteraction } from "./extended-text-interaction";
+import { GapMatchInteraction } from "./gap-match-interaction";
+import { GraphicAssociateInteraction } from "./graphic-associate-interaction";
+import { GraphicGapMatchInteraction } from "./graphic-gap-match-interaction";
+import { GraphicOrderInteraction } from "./graphic-order-interaction";
+import { HotspotInteraction } from "./hotspot-interaction";
+import { HottextInteraction } from "./hottext-interaction";
+import { InlineChoiceInteraction } from "./inline-choice-interaction";
+import { MatchInteraction } from "./match-interaction";
+import { MediaInteraction } from "./media-interaction";
+import { OrderInteraction } from "./order-interaction";
+import { PositionObjectInteraction } from "./position-object-interaction";
+import { SelectPointInteraction } from "./select-point-interaction";
+import { SliderInteraction } from "./slider-interaction";
+import { TextEntryInteraction } from "./text-entry-interaction";
+import { UploadInteraction } from "./upload-interaction";
+export * from "./associate-interaction";
+export * from "./choice-interaction";
+export * from "./drawing-interaction";
+export * from "./end-attempt-interaction";
+export * from "./extended-text-interaction";
+export * from "./gap-match-interaction";
+export * from "./graphic-associate-interaction";
+export * from "./graphic-gap-match-interaction";
+export * from "./graphic-order-interaction";
+export * from "./hotspot-interaction";
+export * from "./hottext-interaction";
+export * from "./inline-choice-interaction";
+export * from "./interaction";
+export * from "./match-interaction";
+export * from "./media-interaction";
+export * from "./order-interaction";
+export * from "./position-object-interaction";
+export * from "./select-point-interaction";
+export * from "./slider-interaction";
+export * from "./text-entry-interaction";
+export * from "./upload-interaction";
+export const qtiInteractionTypes = {
+    AssociateInteraction,
+    ChoiceInteraction,
+    DrawingInteraction,
+    EndAttemptInteraction,
+    ExtendedTextInteraction,
+    GapMatchInteraction,
+    GraphicAssociateInteraction,
+    GraphicGapMatchInteraction,
+    GraphicOrderInteraction,
+    HotspotInteraction,
+    HottextInteraction,
+    InlineChoiceInteraction,
+    MatchInteraction,
+    MediaInteraction,
+    OrderInteraction,
+    PositionObjectInteraction,
+    SelectPointInteraction,
+    SliderInteraction,
+    TextEntryInteraction,
+    UploadInteraction,
+};
+//# sourceMappingURL=index.js.map

package/dist/qti/interactions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/qti/interactions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AAErC,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,oBAAoB;IACpB,iBAAiB;IACjB,kBAAkB;IAClB,qBAAqB;IACrB,uBAAuB;IACvB,mBAAmB;IACnB,2BAA2B;IAC3B,0BAA0B;IAC1B,uBAAuB;IACvB,kBAAkB;IAClB,kBAAkB;IAClB,uBAAuB;IACvB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,yBAAyB;IACzB,sBAAsB;IACtB,iBAAiB;IACjB,oBAAoB;IACpB,iBAAiB;CAClB,CAAC"}

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

@@ -0,0 +1,30 @@
+import { QtiInteraction, QtiInteractionOptions } from "./interaction";
+export type InlineChoiceOptions = {
+    identifier: string;
+    fixed?: boolean;
+    templateIdentifier?: string;
+    content?: string;
+};
+export type InlineChoiceInteractionOptions = QtiInteractionOptions & {
+    shuffle?: boolean;
+    required?: boolean;
+    inlineChoices?: InlineChoiceOptions[];
+};
+/**
+ * Presents a dropdown menu embedded within text content for candidates to select an option.
+ * Used for fill-in-the-blank style questions with predefined choices.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.8zaq47h31112
+ *
+ * @example
+ * const interaction = new InlineChoiceInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   inlineChoices: [
+ *     { identifier: "A", content: "is" },
+ *     { identifier: "B", content: "are" },
+ *   ],
+ * });
+ */
+export declare class InlineChoiceInteraction extends QtiInteraction {
+    constructor(options: InlineChoiceInteractionOptions);
+}

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

@@ -0,0 +1,40 @@
+import { fragment } from "xmlbuilder2";
+import { QtiInteraction } from "./interaction";
+import { appendHtmlFragment } from "../../utils/html";
+/**
+ * Presents a dropdown menu embedded within text content for candidates to select an option.
+ * Used for fill-in-the-blank style questions with predefined choices.
+ *
+ * @see https://www.imsglobal.org/spec/qti/v3p0/impl#h.8zaq47h31112
+ *
+ * @example
+ * const interaction = new InlineChoiceInteraction({
+ *   responseIdentifier: "RESPONSE",
+ *   inlineChoices: [
+ *     { identifier: "A", content: "is" },
+ *     { identifier: "B", content: "are" },
+ *   ],
+ * });
+ */
+export class InlineChoiceInteraction extends QtiInteraction {
+    constructor(options) {
+        super(options);
+        this.item = fragment().ele("qti-inline-choice-interaction", {
+            "response-identifier": options.responseIdentifier,
+            label: options.label,
+            shuffle: options.shuffle ? "true" : "false",
+            required: options.required ? "true" : undefined,
+        });
+        for (const choice of options.inlineChoices || []) {
+            const choiceEl = this.item.ele("qti-inline-choice", {
+                identifier: choice.identifier,
+                fixed: choice.fixed ? "true" : undefined,
+                "template-identifier": choice.templateIdentifier,
+            });
+            if (choice.content) {
+                appendHtmlFragment(choice.content, choiceEl);
+            }
+        }
+    }
+}
+//# sourceMappingURL=inline-choice-interaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inline-choice-interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/inline-choice-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,cAAc,EAAyB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAetD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,uBAAwB,SAAQ,cAAc;IACzD,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,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;YAC3C,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SAChD,CAAC,CAAC;QAEH,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,aAAa,IAAI,EAAE,EAAE,CAAC;YACjD,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/interaction.d.ts

@@ -0,0 +1,20 @@
+import { XMLBuilder } from "xmlbuilder2/lib/interfaces";
+export type QtiInteractionOptions = {
+    responseIdentifier: string;
+    label?: string;
+};
+export type QtiPromptInteractionOptions = QtiInteractionOptions & {
+    prompt?: string;
+};
+export declare abstract class QtiInteraction {
+    responseIdentifier: string;
+    protected item: XMLBuilder;
+    constructor(options: QtiInteractionOptions);
+    buildXml(): string;
+    getXmlBuilder(): XMLBuilder;
+}
+export declare abstract class QtiPromptInteraction extends QtiInteraction {
+    prompt: string;
+    constructor(options: QtiPromptInteractionOptions);
+    buildXml(): string;
+}

package/dist/qti/interactions/interaction.js

@@ -0,0 +1,24 @@
+import { fragment } from "xmlbuilder2";
+export class QtiInteraction {
+    constructor(options) {
+        this.responseIdentifier = options.responseIdentifier;
+        this.item = fragment();
+    }
+    buildXml() {
+        return this.item.end({ prettyPrint: true });
+    }
+    getXmlBuilder() {
+        return this.item;
+    }
+}
+export class QtiPromptInteraction extends QtiInteraction {
+    constructor(options) {
+        super({ responseIdentifier: options.responseIdentifier });
+        this.prompt = options.prompt || "";
+    }
+    buildXml() {
+        this.item.ele("qti-prompt").txt(this.prompt);
+        return super.buildXml();
+    }
+}
+//# sourceMappingURL=interaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.js","sourceRoot":"","sources":["../../../src/qti/interactions/interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAWvC,MAAM,OAAgB,cAAc;IAIlC,YAAY,OAA8B;QACxC,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;QAErD,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;IACzB,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAEM,aAAa;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAgB,oBAAqB,SAAQ,cAAc;IAG/D,YAAY,OAAoC;QAC9C,KAAK,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAE1D,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACrC,CAAC;IAEM,QAAQ;QACb,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE7C,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;CACF"}

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

@@ -0,0 +1,31 @@
+import { SimpleAssociableChoiceOptions } from "./associate-interaction";
+import { QtiPromptInteraction, QtiPromptInteractionOptions } from "./interaction";
+export type MatchInteractionOptions = QtiPromptInteractionOptions & {
+    shuffle?: boolean;
+    minAssociations?: number;
+    maxAssociations?: number;
+    sourceChoices?: SimpleAssociableChoiceOptions[];
+    targetChoices?: SimpleAssociableChoiceOptions[];
+};
+/**
+ * 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 declare class MatchInteraction extends QtiPromptInteraction {
+    constructor(options: MatchInteractionOptions);
+}