@citolab/qti-components 7.3.18 → 7.3.20

package/dist/qti-components/index.d.ts

@@ -1,12 +1,14 @@
-import { Z as QtiRule, _ as QtiRuleBase, a9 as QtiExpressionBase, a5 as QtiExpression, aa as ResponseVariable, a6 as VariableDeclaration, a4 as ItemContext } from '../qti-response-declaration-DNXsTvKe.js';
-export { O as Orientation, V as QtiAreaMapEntry, U as QtiAreaMapping, Q as QtiAssessmentItem, a as QtiAssessmentStimulusRef, g as QtiAssociableHotspot, h as QtiAssociateInteraction, i as QtiChoiceInteraction, b as QtiCompanionMaterialsInfo, $ as QtiContentBody, j as QtiCustomInteraction, c as QtiCustomOperator, k as QtiEndAttemptInteraction, l as QtiExtendedTextInteraction, d as QtiFeedbackBlock, e as QtiFeedbackInline, p as QtiGap, m as QtiGapImg, n as QtiGapMatchInteraction, o as QtiGapText, q as QtiGraphicAssociateInteraction, r as QtiGraphicGapMatchInteraction, s as QtiGraphicOrderInteraction, t as QtiHotspotChoice, u as QtiHotspotInteraction, w as QtiHottext, v as QtiHottextInteraction, y as QtiInlineChoice, x as QtiInlineChoiceInteraction, K as QtiItemBody, R as QtiLookupOutcomeValue, T as QtiMapEntry, S as QtiMapping, z as QtiMatchInteraction, A as QtiMediaInteraction, f as QtiModalFeedback, B as QtiOrderInteraction, a2 as QtiOutcomeDeclaration, L as QtiOutcomeProcessing, M as QtiOutcomeProcessingProcessor, C as QtiPortableCustomInteraction, D as QtiPositionObjectStage, N as QtiPrompt, a3 as QtiResponseDeclaration, P as QtiResponseProcessing, a0 as QtiRubricBlock, E as QtiSelectPointInteraction, F as QtiSimpleAssociableChoice, G as QtiSimpleChoice, H as QtiSliderInteraction, a1 as QtiStylesheet, X as QtiSubtract, I as QtiTextEntryInteraction, J as QtiUploadInteraction, W as areaShape, Y as qtiSubtractMixin } from '../qti-response-declaration-DNXsTvKe.js';
+import { Z as QtiRule, _ as QtiRuleBase, a9 as QtiExpressionBase, a5 as QtiExpression, a4 as ItemContext, aa as ResponseVariable, a8 as VariableDeclaration } from '../qti-response-declaration-xVcD4HvN.js';
+export { O as Orientation, V as QtiAreaMapEntry, U as QtiAreaMapping, Q as QtiAssessmentItem, a as QtiAssessmentStimulusRef, g as QtiAssociableHotspot, h as QtiAssociateInteraction, i as QtiChoiceInteraction, b as QtiCompanionMaterialsInfo, $ as QtiContentBody, j as QtiCustomInteraction, c as QtiCustomOperator, k as QtiEndAttemptInteraction, l as QtiExtendedTextInteraction, d as QtiFeedbackBlock, e as QtiFeedbackInline, p as QtiGap, m as QtiGapImg, n as QtiGapMatchInteraction, o as QtiGapText, q as QtiGraphicAssociateInteraction, r as QtiGraphicGapMatchInteraction, s as QtiGraphicOrderInteraction, t as QtiHotspotChoice, u as QtiHotspotInteraction, w as QtiHottext, v as QtiHottextInteraction, y as QtiInlineChoice, x as QtiInlineChoiceInteraction, K as QtiItemBody, R as QtiLookupOutcomeValue, T as QtiMapEntry, S as QtiMapping, z as QtiMatchInteraction, A as QtiMediaInteraction, f as QtiModalFeedback, B as QtiOrderInteraction, a2 as QtiOutcomeDeclaration, L as QtiOutcomeProcessing, M as QtiOutcomeProcessingProcessor, C as QtiPortableCustomInteraction, D as QtiPositionObjectStage, N as QtiPrompt, a3 as QtiResponseDeclaration, P as QtiResponseProcessing, a0 as QtiRubricBlock, E as QtiSelectPointInteraction, F as QtiSimpleAssociableChoice, G as QtiSimpleChoice, H as QtiSliderInteraction, a1 as QtiStylesheet, X as QtiSubtract, I as QtiTextEntryInteraction, J as QtiUploadInteraction, W as areaShape, Y as qtiSubtractMixin } from '../qti-response-declaration-xVcD4HvN.js';
 import * as lit from 'lit';
 import { LitElement, nothing } from 'lit';
 import * as lit_html from 'lit-html';
 import { QtiConditionExpression } from '../exports/qti-condition-expression.js';
 import { BaseType } from '../exports/expression-result.js';
+import { TestContext } from '../exports/test.context.js';
 import '../exports/interaction.interface.js';
 import 'lit-html/directives/ref.js';
+import '../exports/qti.context.js';
 
 declare class QtiPositionObjectInteraction extends LitElement {
     render(): lit_html.TemplateResult<1>;
@@ -84,6 +86,18 @@ declare class QtiBaseValue extends QtiExpression<string> {
     getResult(): string;
 }
 
+/**
+ * @summary The qti-container-size operator returns the number of values in a container.
+ * @documentation https://www.imsglobal.org/spec/qti/v3p0/impl#h.container-size
+ *
+ * Takes a sub-expression with any base-type and either multiple or ordered cardinality.
+ * Returns an integer giving the number of values in the container.
+ * Returns 0 if the sub-expression is NULL.
+ */
+declare class QtiContainerSize extends QtiExpression<number> {
+    getResult(): number;
+}
+
 declare class QtiContains extends QtiConditionExpression {
     getResult(): boolean;
 }
@@ -93,17 +107,87 @@ declare class QtiCorrect extends QtiExpression<string | string[]> {
     getResult(): string | string[];
 }
 
+/**
+ * @summary The qti-default expression returns the default value of a declared variable.
+ * @documentation https://www.imsglobal.org/spec/qti/v3p0/impl#h.default
+ *
+ * Looks up the declaration of an itemVariable and returns the associated defaultValue
+ * or NULL if no default value was declared. Supports item identifier prefixing
+ * for obtaining default values from individual items in outcomes processing.
+ */
+declare class QtiDefault extends QtiExpression<any> {
+    identifier: string;
+    protected context?: ItemContext;
+    protected _testContext?: TestContext;
+    getResult(): any;
+}
+
 declare class QtiEqualRounded extends QtiExpression<boolean> {
     roundingMode: 'decimalPlaces' | 'significantFigures';
     get figures(): number;
     getResult(): boolean;
 }
 
+/**
+ * @summary The qti-round operator rounds a numerical value to the nearest integer.
+ * @documentation https://www.imsglobal.org/spec/qti/v3p0/impl#h.round
+ *
+ * Takes a single sub-expression with single cardinality and numerical base-type.
+ * Returns an integer formed by rounding the value using the rule: n for all input
+ * values in the range [n-0.5, n+0.5). For example, 6.8 and 6.5 both round to 7,
+ * 6.49 rounds to 6, and -6.5 rounds to -6.
+ */
+declare class QtiRound extends QtiExpression<number | null> {
+    getResult(): number | null;
+}
+
+/**
+ * @summary The qti-round-to operator rounds a numerical value to specified precision.
+ * @documentation https://www.imsglobal.org/spec/qti/v3p0/impl#h.round-to
+ *
+ * Takes one sub-expression with single cardinality and numerical base-type.
+ * Returns a single float rounded by the specified method to the specified precision.
+ * Supports rounding to decimal places or significant figures.
+ */
+declare class QtiRoundTo extends QtiExpression<number | null> {
+    roundingMode: 'decimalPlaces' | 'significantFigures';
+    figures: number;
+    getResult(): number | null;
+    /**
+     * Round to specified number of decimal places
+     */
+    private _roundToDecimalPlaces;
+    /**
+     * Round to specified number of significant figures
+     */
+    private _roundToSignificantFigures;
+}
+
 declare class QtiEqual extends QtiExpression<boolean> {
     toleranceMode: 'exact' | 'relative' | 'absolute';
     getResult(): boolean;
 }
 
+/**
+ * @summary The qti-gcd operator calculates the greatest common divisor of integer values.
+ * @documentation https://www.imsglobal.org/spec/qti/v3p0/impl#h.gcd
+ *
+ * Takes 1 or more sub-expressions with base-type integer and any cardinality.
+ * Returns a single integer equal to the greatest common divisor of all argument values.
+ * Special cases: gcd(0,0)=0, gcd(0,n)=n if n≠0, returns NULL if any argument is NULL or non-numerical.
+ */
+declare class QtiGcd extends QtiExpression<number | null> {
+    getResult(): number | null;
+    /**
+     * Calculate the greatest common divisor of an array of integers
+     */
+    private _calculateGcd;
+    /**
+     * Calculate GCD of two numbers using Euclidean algorithm
+     */
+    private _gcdTwoNumbers;
+}
+
 declare class QtiGt extends QtiExpression<boolean> {
     getResult(): boolean;
 }
@@ -112,10 +196,25 @@ declare class QtiGte extends QtiConditionExpression {
     getResult(): boolean;
 }
 
+/**
+ * @summary The qti-null expression returns the NULL value.
+ * @documentation https://www.imsglobal.org/spec/qti/v3p0/impl#h.null
+ *
+ * A simple expression that returns the NULL value. The null value is treated
+ * as if it is of any desired base-type.
+ */
+declare class QtiNull extends QtiExpression<null> {
+    getResult(): null;
+}
+
 declare class QtiIsNull extends QtiExpression<boolean> {
     getResult(): boolean;
 }
 
+declare class QtiFieldValue extends QtiExpression<string | string[]> {
+    getResult(): any;
+}
+
 declare class QtiLt extends QtiExpression<boolean> {
     getResult(): boolean;
 }
@@ -134,6 +233,20 @@ declare class QtiMapResponsePoint extends QtiExpression<number> {
     getResult(): number;
 }
 
+/**
+ * @summary The qti-math-operator performs mathematical operations on numerical values.
+ * @documentation https://www.imsglobal.org/spec/qti/v3p0/impl#h.math-operator
+ *
+ * Takes 1 or more sub-expressions with single cardinality and numerical base-types.
+ * The result is a single float, except for signum, floor and ceil which return integers.
+ * Returns NULL if any argument is NULL or falls outside the function's natural domain.
+ */
+declare class QtiMathOperator extends QtiExpression<number | null> {
+    name: string;
+    getResult(): number | null;
+    private _performOperation;
+}
+
 declare class QtiMatch extends QtiExpression<boolean> {
     getResult(): boolean;
     static match(valueToMap: ResponseVariable, correctValueInfo: ResponseVariable): boolean;
@@ -160,6 +273,18 @@ declare class QtiOrdered extends QtiExpression<ResponseVariable[]> {
     getResult(): ResponseVariable[];
 }
 
+/**
+ * @summary The qti-power operator raises the first expression to the power of the second.
+ * @documentation https://www.imsglobal.org/spec/qti/v3p0/impl#h.power
+ *
+ * Takes 2 sub-expressions with single cardinality and numerical base-types.
+ * Returns a single float corresponding to the first expression raised to the power of the second.
+ * Returns NULL if either expression is NULL or if the result is outside the float value set.
+ */
+declare class QtiPower extends QtiExpression<number | null> {
+    getResult(): number | null;
+}
+
 declare class QtiPrintedVariable extends LitElement {
     identifier: string;
     protected context?: ItemContext;
@@ -191,6 +316,24 @@ declare class QtiVariable extends QtiExpression<string | string[]> {
     getResult(): Readonly<string | string[]>;
 }
 
+/**
+ * @summary The qti-random-integer operator selects a random integer from a specified range.
+ * @documentation https://www.imsglobal.org/spec/qti/v3p0/impl#h.random-integer
+ *
+ * Selects a random integer from the range [min,max] satisfying min + step * n for some integer n.
+ * For example, with min=2, max=11 and step=3 the values {2,5,8,11} are possible.
+ */
+declare class QtiRandomInteger extends QtiExpression<number> {
+    min: number;
+    max: number;
+    step: number;
+    getResult(): number;
+    /**
+     * Get all possible values for testing purposes
+     */
+    getPossibleValues(): number[];
+}
+
 declare class QtiRandom extends QtiExpression<string> {
     getResult(): any;
 }
@@ -205,4 +348,4 @@ declare class QtiIndex extends QtiExpression<any> {
     private lookupVariableValue;
 }
 
-export { QtiAnd, QtiBaseValue, QtiContains, QtiCorrect, QtiDelete, QtiEqual, QtiEqualRounded, QtiGt, QtiGte, QtiIndex, QtiIsNull, QtiLt, QtiLte, QtiMapResponse, QtiMapResponsePoint, QtiMatch, QtiMember, QtiMultiple, QtiNot, QtiOr, QtiOrdered, QtiPositionObjectInteraction, QtiPrintedVariable, QtiProduct, QtiRandom, QtiResponseCondition, QtiResponseElse, QtiResponseElseIf, QtiResponseIf, QtiRule, QtiRuleBase, QtiSetOutcomeValue, QtiSetOutcomeValueRule, QtiStringMatch, QtiSum, QtiSumExpression, QtiVariable, qtiAndMixin };
+export { QtiAnd, QtiBaseValue, QtiContainerSize, QtiContains, QtiCorrect, QtiDefault, QtiDelete, QtiEqual, QtiEqualRounded, QtiFieldValue, QtiGcd, QtiGt, QtiGte, QtiIndex, QtiIsNull, QtiLt, QtiLte, QtiMapResponse, QtiMapResponsePoint, QtiMatch, QtiMathOperator, QtiMember, QtiMultiple, QtiNot, QtiNull, QtiOr, QtiOrdered, QtiPositionObjectInteraction, QtiPower, QtiPrintedVariable, QtiProduct, QtiRandom, QtiRandomInteger, QtiResponseCondition, QtiResponseElse, QtiResponseElseIf, QtiResponseIf, QtiRound, QtiRoundTo, QtiRule, QtiRuleBase, QtiSetOutcomeValue, QtiSetOutcomeValueRule, QtiStringMatch, QtiSum, QtiSumExpression, QtiVariable, qtiAndMixin };

package/dist/qti-components/index.js

@@ -7,11 +7,13 @@ import {
   QtiBaseValue,
   QtiChoiceInteraction,
   QtiCompanionMaterialsInfo,
+  QtiContainerSize,
   QtiContains,
   QtiContentBody,
   QtiCorrect,
   QtiCustomInteraction,
   QtiCustomOperator,
+  QtiDefault,
   QtiDelete,
   QtiEndAttemptInteraction,
   QtiEqual,
@@ -19,10 +21,12 @@ import {
   QtiExtendedTextInteraction,
   QtiFeedbackBlock,
   QtiFeedbackInline,
+  QtiFieldValue,
   QtiGap,
   QtiGapImg,
   QtiGapMatchInteraction,
   QtiGapText,
+  QtiGcd,
   QtiGraphicAssociateInteraction,
   QtiGraphicGapMatchInteraction,
   QtiGraphicOrderInteraction,
@@ -44,11 +48,13 @@ import {
   QtiMapResponsePoint,
   QtiMatch,
   QtiMatchInteraction,
+  QtiMathOperator,
   QtiMediaInteraction,
   QtiMember,
   QtiModalFeedback,
   QtiMultiple,
   QtiNot,
+  QtiNull,
   QtiOr,
   QtiOrderInteraction,
   QtiOrdered,
@@ -58,16 +64,20 @@ import {
   QtiPortableCustomInteraction,
   QtiPositionObjectInteraction,
   QtiPositionObjectStage,
+  QtiPower,
   QtiPrintedVariable,
   QtiProduct,
   QtiPrompt,
   QtiRandom,
+  QtiRandomInteger,
   QtiResponseCondition,
   QtiResponseDeclaration,
   QtiResponseElse,
   QtiResponseElseIf,
   QtiResponseIf,
   QtiResponseProcessing,
+  QtiRound,
+  QtiRoundTo,
   QtiRubricBlock,
   QtiRule,
   QtiSelectPointInteraction,
@@ -86,15 +96,17 @@ import {
   QtiVariable,
   qtiAndMixin,
   qtiSubtractMixin
-} from "../chunks/chunk-WOCRTIKW.js";
-import "../chunks/chunk-D3RGDWKP.js";
+} from "../chunks/chunk-SRJF5RCP.js";
+import "../chunks/chunk-YWEWSQJR.js";
 import "../chunks/chunk-ELDMXTUQ.js";
-import "../chunks/chunk-VEWD22O5.js";
-import "../chunks/chunk-2GCEXNHI.js";
-import "../chunks/chunk-RVJU3T7F.js";
+import "../chunks/chunk-WFUXZ4UT.js";
+import "../chunks/chunk-DPJNXSTI.js";
+import "../chunks/chunk-GFCOR6TX.js";
 import "../chunks/chunk-NJNQOQUU.js";
-import "../chunks/chunk-OJ3KRFOY.js";
-import "../chunks/chunk-4LANPT4E.js";
+import "../chunks/chunk-H6KHXSIO.js";
+import "../chunks/chunk-CJADUWEC.js";
+import "../chunks/chunk-KJQYKXDV.js";
+import "../chunks/chunk-NRKCQIQS.js";
 import "../chunks/chunk-JQ6HWGRY.js";
 import "../chunks/chunk-H2JE6IVU.js";
 export {
@@ -106,11 +118,13 @@ export {
   QtiBaseValue,
   QtiChoiceInteraction,
   QtiCompanionMaterialsInfo,
+  QtiContainerSize,
   QtiContains,
   QtiContentBody,
   QtiCorrect,
   QtiCustomInteraction,
   QtiCustomOperator,
+  QtiDefault,
   QtiDelete,
   QtiEndAttemptInteraction,
   QtiEqual,
@@ -118,10 +132,12 @@ export {
   QtiExtendedTextInteraction,
   QtiFeedbackBlock,
   QtiFeedbackInline,
+  QtiFieldValue,
   QtiGap,
   QtiGapImg,
   QtiGapMatchInteraction,
   QtiGapText,
+  QtiGcd,
   QtiGraphicAssociateInteraction,
   QtiGraphicGapMatchInteraction,
   QtiGraphicOrderInteraction,
@@ -143,11 +159,13 @@ export {
   QtiMapResponsePoint,
   QtiMatch,
   QtiMatchInteraction,
+  QtiMathOperator,
   QtiMediaInteraction,
   QtiMember,
   QtiModalFeedback,
   QtiMultiple,
   QtiNot,
+  QtiNull,
   QtiOr,
   QtiOrderInteraction,
   QtiOrdered,
@@ -157,16 +175,20 @@ export {
   QtiPortableCustomInteraction,
   QtiPositionObjectInteraction,
   QtiPositionObjectStage,
+  QtiPower,
   QtiPrintedVariable,
   QtiProduct,
   QtiPrompt,
   QtiRandom,
+  QtiRandomInteger,
   QtiResponseCondition,
   QtiResponseDeclaration,
   QtiResponseElse,
   QtiResponseElseIf,
   QtiResponseIf,
   QtiResponseProcessing,
+  QtiRound,
+  QtiRoundTo,
   QtiRubricBlock,
   QtiRule,
   QtiSelectPointInteraction,