@citolab/qti-components 7.28.0 → 7.28.1

package/custom-elements.json

@@ -27312,12 +27312,64 @@
       "kind": "javascript-module",
       "path": "packages/qti-base/src/context/qti.context.ts",
       "declarations": [
+        {
+          "kind": "function",
+          "name": "asSeed",
+          "return": {
+            "type": {
+              "text": "Seed | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "unknown"
+              }
+            }
+          ],
+          "description": "Validates and brands a value as a Seed, returning `undefined` when the\nvalue is missing or not in a usable seed format."
+        },
+        {
+          "kind": "function",
+          "name": "isSeed",
+          "return": {
+            "type": {
+              "text": "value is Seed"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "unknown"
+              }
+            }
+          ],
+          "description": "Runtime type guard that narrows an unknown value to a Seed.\nUse this at boundaries (e.g. values coming from XML, a host application or a\nbackend) before treating a string as a seed."
+        },
         {
           "kind": "variable",
           "name": "qtiContext"
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "asSeed",
+          "declaration": {
+            "name": "asSeed",
+            "module": "packages/qti-base/src/context/qti.context.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "isSeed",
+          "declaration": {
+            "name": "isSeed",
+            "module": "packages/qti-base/src/context/qti.context.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "qtiContext",
@@ -30457,6 +30509,15 @@
               },
               "default": "null",
               "description": "The raw XML string"
+            },
+            {
+              "kind": "field",
+              "name": "qtiContext",
+              "type": {
+                "text": "QtiContext"
+              },
+              "privacy": "protected",
+              "default": "{ QTI_CONTEXT: { testIdentifier: '', candidateIdentifier: '', environmentIdentifier: 'default' } }"
             }
           ],
           "attributes": [
@@ -31155,6 +31216,16 @@
               },
               "privacy": "public",
               "default": "{}"
+            },
+            {
+              "kind": "field",
+              "name": "qtiContext",
+              "type": {
+                "text": "QtiContext"
+              },
+              "privacy": "public",
+              "default": "{ QTI_CONTEXT: { testIdentifier: '', candidateIdentifier: '', environmentIdentifier: 'default' } }",
+              "description": "Provided so that descendants (e.g. `<item-container>`) can read the QTI runtime\ncontext for standalone item delivery, including the optional shuffle `seed`."
             }
           ],
           "superclass": {
@@ -41205,7 +41276,17 @@
           "kind": "class",
           "description": "`<qti-test>` is a custom element designed for rendering and interacting with QTI (Question and Test Interoperability) tests.\n\nThis component leverages several mixins to provide functionality for loading, navigating, processing, and displaying QTI test assessments.\n\n### Example Usage\n\nMinimal example including navigation:\n\n```html\n<qti-test>\n <test-navigation>\n   <test-container test-url=\"./path/to/assessment.xml\"></test-container>\n   <nav class=\"flex\">\n     <test-prev></test-prev>\n     <test-next></test-next>\n   </nav>\n </test-navigation>\n</qti-test>\n```\n\nUse the following file structure\nA qti-test loads a QTI3.0 assessmenttest.xml file from a package folder.\n\n```plaintext\nRoot/\n├── index.html\n└── /assets/api/examples/\n    ├── assessmenttest.xml\n    └── imsmanifest.xml\n\n```\n\n### Test components\n\nUse test components inside the qti-test component for added functionality.\n### Test next\n`<test-next> | TestNext`\n\n### Test prev\n\n`<test-prev> | TestPrev`\n### Test components\n\nYou can use normal class names to style the elements.\nAnd you can use the `test-prev` and `test-next` elements to navigate through the test.",
           "name": "QtiTest",
-          "members": [],
+          "members": [
+            {
+              "kind": "field",
+              "name": "configContext",
+              "type": {
+                "text": "ConfigContext"
+              },
+              "privacy": "public",
+              "default": "{}"
+            }
+          ],
           "events": [
             {
               "name": "qti-test-connected",
@@ -41399,6 +41480,15 @@
               "name": "handleTestXMLChange",
               "privacy": "protected"
             },
+            {
+              "kind": "field",
+              "name": "qtiContext",
+              "type": {
+                "text": "QtiContext"
+              },
+              "privacy": "protected",
+              "default": "{ QTI_CONTEXT: { testIdentifier: '', candidateIdentifier: '', environmentIdentifier: 'default' } }"
+            },
             {
               "kind": "field",
               "name": "testDoc",

package/dist/base.d.ts

@@ -3,11 +3,11 @@ export { C as ComputedContext, a as ComputedItem, I as INITIAL_SESSION_CONTEXT,
 export { C as ConfigContext, a as CorrectResponseMode, c as configContext } from './config.context-BjZ2bZSY.js';
 import { I as ItemContext } from './item.context-CkUeDcaO.js';
 export { i as itemContextVariables } from './item.context-CkUeDcaO.js';
-export { Q as QtiContext, a as QtiContextType, q as qtiContext } from './qti.context-B8PSyIWm.js';
+export { Q as QtiContext, a as QtiContextType, S as Seed, b as asSeed, i as isSeed, q as qtiContext } from './qti.context-CejJMlfZ.js';
 export { I as INITIAL_TEST_CONTEXT, T as TestContext, t as testContext } from './test.context-CByZZjkR.js';
 export { C as Correctness, I as IInteraction, a as Interaction } from './interaction-Bgzlw7Iu.js';
 export { Q as QtiFeedback, a as QtiVariableDeclaration } from './qti-feedback-ChmXhZuf.js';
-export { Q as QtiConditionExpression, a as QtiExpression, b as QtiExpressionBase } from './qti-condition-expression-B1BYmCcq.js';
+export { Q as QtiConditionExpression, a as QtiExpression, b as QtiExpressionBase } from './qti-condition-expression-Dam-RER6.js';
 import { B as BaseType } from './variables-CMYcDbyW.js';
 export { C as Calculate, a as Cardinality, M as Multiple, O as Ordered, b as OutcomeVariable, Q as QtiAreaMapEntry, c as QtiAreaMapping, d as QtiMapEntry, e as QtiMapping, R as ResponseInteraction, f as ResponseVariable, T as TemplateVariable, V as VariableDeclaration, g as VariableValue, h as areaShape, i as directedPair, j as float, k as integer } from './variables-CMYcDbyW.js';
 export { Q as QtiRuleBase, a as QtiRuleElement } from './qti-rule-base-ajOnfGXY.js';

package/dist/base.js

@@ -10,18 +10,20 @@ import {
   QtiRuleElement,
   QtiVariableDeclaration,
   ScoringHelper,
+  asSeed,
   computedContext,
   computedItemContext,
   configContext,
   convertNumberToUniversalFormat,
   decimalSeparator,
+  isSeed,
   itemContext,
   itemContextVariables,
   qtiContext,
   removeDoubleSlashes,
   sessionContext,
   testContext
-} from "./chunk-Z2SUBRH5.js";
+} from "./chunk-3XV26R5M.js";
 import "./chunk-QXBXORM3.js";
 export {
   Correctness,
@@ -35,11 +37,13 @@ export {
   QtiRuleElement,
   QtiVariableDeclaration,
   ScoringHelper,
+  asSeed,
   computedContext,
   computedItemContext,
   configContext,
   convertNumberToUniversalFormat,
   decimalSeparator,
+  isSeed,
   itemContext,
   itemContextVariables,
   qtiContext,