@citolab/qti-components 7.0.4 → 7.0.6-beta.0

package/dist/qti-test/components/test-paging-buttons-stamp.d.ts

@@ -0,0 +1,21 @@
+import * as lit_html from 'lit-html';
+import { TestComponent } from './test-component.abstract.js';
+import 'lit';
+import '../../test.context-DbSTxKk_.js';
+import '../../qti-simple-choice-DxWcdKHi.js';
+import 'lit-html/directives/ref.js';
+
+declare class TestPagingButtonsStamp extends TestComponent {
+    private maxDisplayedItems;
+    private skipOnCategory;
+    protected createRenderRoot(): this;
+    constructor();
+    render(): lit_html.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-paging-buttons-stamp': TestPagingButtonsStamp;
+    }
+}
+
+export { TestPagingButtonsStamp };

package/dist/qti-test/components/test-paging-buttons-stamp.js

@@ -0,0 +1,11 @@
+import {
+  TestPagingButtonsStamp
+} from "../../chunk-F7HTXGGH.js";
+import "../../chunk-ANLIJZBL.js";
+import "../../chunk-F3NTI6TX.js";
+import "../../chunk-4YG2FPKK.js";
+import "../../chunk-44VE5POH.js";
+export {
+  TestPagingButtonsStamp
+};
+//# sourceMappingURL=test-paging-buttons-stamp.js.map

package/dist/qti-test/components/test-paging-buttons-stamp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/qti-test/components/test-prev.d.ts

@@ -0,0 +1,31 @@
+import * as lit_html from 'lit-html';
+import * as lit from 'lit';
+import { TestComponent } from './test-component.abstract.js';
+import '../../test.context-DbSTxKk_.js';
+import '../../qti-simple-choice-DxWcdKHi.js';
+import 'lit-html/directives/ref.js';
+
+/**
+ * Represents a custom element for navigating to the previous test item.
+ *
+ * @remarks
+ * This element provides functionality for navigating to the previous test item.
+ *
+ * @example
+ * ```html
+ * <test-prev></test-prev>
+ * ```
+ */
+declare class TestPrev extends TestComponent {
+    static styles: lit.CSSResult;
+    constructor();
+    willUpdate(changedProperties: Map<string | number | symbol, unknown>): void;
+    render(): lit_html.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-previous': TestPrev;
+    }
+}
+
+export { TestPrev };

package/dist/qti-test/components/test-prev.js

@@ -0,0 +1,12 @@
+import {
+  TestPrev
+} from "../../chunk-6SG3NMKU.js";
+import "../../chunk-UB5K44DB.js";
+import "../../chunk-ANLIJZBL.js";
+import "../../chunk-F3NTI6TX.js";
+import "../../chunk-4YG2FPKK.js";
+import "../../chunk-44VE5POH.js";
+export {
+  TestPrev
+};
+//# sourceMappingURL=test-prev.js.map

package/dist/qti-test/components/test-prev.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/qti-test/components/test-view.d.ts

@@ -0,0 +1,26 @@
+import * as lit_html from 'lit-html';
+import { TestComponent } from './test-component.abstract.js';
+import 'lit';
+import '../../test.context-DbSTxKk_.js';
+import '../../qti-simple-choice-DxWcdKHi.js';
+import 'lit-html/directives/ref.js';
+
+declare class TestView extends TestComponent {
+    static DEFAULT_VIEW_OPTIONS: string[];
+    /** label accompanying the select view dropdown  */
+    label: string;
+    /** The options to display in the dropdown, default: ['author', 'candidate', 'proctor', 'scorer', 'testConstructor', 'tutor'] */
+    viewOptions: any;
+    protected _handleViewOptionsChange: () => void;
+    connectedCallback(): void;
+    private _viewOptions;
+    private updateViewOptions;
+    render(): lit_html.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-view': TestView;
+    }
+}
+
+export { TestView };

package/dist/qti-test/components/test-view.js

@@ -0,0 +1,11 @@
+import {
+  TestView
+} from "../../chunk-3TFUBCJW.js";
+import "../../chunk-ANLIJZBL.js";
+import "../../chunk-F3NTI6TX.js";
+import "../../chunk-4YG2FPKK.js";
+import "../../chunk-44VE5POH.js";
+export {
+  TestView
+};
+//# sourceMappingURL=test-view.js.map

package/dist/qti-test/components/test-view.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/qti-test/core/index.d.ts

@@ -0,0 +1,121 @@
+import * as lit_html from 'lit-html';
+import { LitElement } from 'lit';
+import { T as TestContext, d as TestElement } from '../../test.context-DbSTxKk_.js';
+export { Q as QtiAssessmentItemRef, a as QtiAssessmentSection, b as QtiAssessmentTest, c as QtiTestPart, t as testContext, e as testElement } from '../../test.context-DbSTxKk_.js';
+import '../../qti-simple-choice-DxWcdKHi.js';
+import 'lit-html/directives/ref.js';
+
+/**
+ * `<test-container>` is a custom element designed for hosting the qti-assessment-item.
+ * The `qti-assessment-test` will be placed inside the shadow DOM of this element.
+ * The element loads the test from the provided URL and renders it inside the shadow DOM.
+ *
+ * ```html
+ * <qti-test>
+ *   <test-container class="m-4 bg-white" test-url="./path/to/assessmenttest.xml"></test-container>
+ * </qti-test>
+ * ```
+ */
+declare class TestContainer extends LitElement {
+    /** URL of the item to load */
+    testURL: string;
+    /** A parsed HTML document */
+    testDoc: DocumentFragment;
+    /** The raw XML string */
+    testXML: string;
+    /** Template content if provided */
+    private templateContent;
+    protected handleTestURLChange(): Promise<void>;
+    protected handleTestXMLChange(): void;
+    connectedCallback(): Promise<void>;
+    private initializeTemplateContent;
+    private applyStyles;
+    render(): lit_html.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-container': TestContainer;
+    }
+}
+
+declare abstract class TestBase extends LitElement {
+    protected _testContext: Readonly<TestContext>;
+    protected testElement: TestElement;
+    constructor();
+    get context(): TestContext;
+    set context(testContext: TestContext);
+    private _updateItemVariablesInTestContext;
+    /**
+     * Updates the variables of an assessment item in the test context.
+     * - Matches the assessment item with the corresponding test context item.
+     * - If the item is not found, logs a warning.
+     * - Updates variables in the test context if exactly one variable exists.
+     * - Otherwise, syncs the assessment item's variables with the test context.
+     *
+     * @param assessmentItem - The assessment item to update.
+     */
+    private _updateItemInTestContext;
+    connectedCallback(): void;
+}
+
+declare const QtiTest_base: (abstract new (...args: any[]) => {}) & (abstract new (...args: any[]) => {}) & (abstract new (...args: any[]) => {}) & typeof TestBase;
+/**
+ * `<qti-test>` is a custom element designed for rendering and interacting with QTI (Question and Test Interoperability) tests.
+ *
+ * This component leverages several mixins to provide functionality for loading, navigating, processing, and displaying QTI test assessments.
+ *
+ * ### Example Usage
+ *
+ * Minimal example including navigation:
+ *
+ * ```html
+ * <qti-test>
+ *   <test-container test-url="./path/to/assessment.xml"></test-container>
+ *   <nav class="flex">
+ *      <test-prev></test-prev>
+ *      <test-next></test-next>
+ *   </nav>
+ * </qti-test>
+ * ```
+ *
+ * Use the following file structure
+ * A qti-test loads a QTI3.0 assessmenttest.xml file from a package folder.
+ *
+ * ```plaintext
+ * Root/
+ * ├── index.html
+ * └── /assets/api/examples/
+ *     ├── assessmenttest.xml
+ *     └── imsmanifest.xml
+ *
+ * ```
+ *
+ * ### Test components
+ *
+ * Use test components inside the qti-test component for added functionality.
+ * ### Test next
+ * `<test-next> | TestNext`
+ *
+ * ### Test prev
+ *
+ * `<test-prev> | TestPrev`
+ * ### Test components
+ *
+ * You can use normal class names to style the elements.
+ * And you can use the `test-prev` and `test-next` elements to navigate through the test.
+ *
+ */
+declare class QtiTest extends QtiTest_base {
+    /**
+     * Renders the component's template.
+     * Provides a default `<slot>` for content projection.
+     */
+    render(): lit_html.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'qti-test': QtiTest;
+    }
+}
+
+export { QtiTest, TestContainer, TestContext, TestElement };

package/dist/qti-test/core/index.js

@@ -0,0 +1,27 @@
+import {
+  QtiAssessmentItemRef,
+  QtiAssessmentSection,
+  QtiAssessmentTest,
+  QtiTest,
+  QtiTestPart,
+  TestContainer
+} from "../../chunk-CNQYM52B.js";
+import "../../chunk-2CHF3TMY.js";
+import "../../chunk-2OA7E3E7.js";
+import {
+  testContext,
+  testElement
+} from "../../chunk-F3NTI6TX.js";
+import "../../chunk-4YG2FPKK.js";
+import "../../chunk-44VE5POH.js";
+export {
+  QtiAssessmentItemRef,
+  QtiAssessmentSection,
+  QtiAssessmentTest,
+  QtiTest,
+  QtiTestPart,
+  TestContainer,
+  testContext,
+  testElement
+};
+//# sourceMappingURL=index.js.map

package/dist/qti-test/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/qti-transformers/index.js

@@ -0,0 +1,12 @@
+import {
+  qtiTransformItem,
+  qtiTransformManifest,
+  qtiTransformTest
+} from "../chunk-2OA7E3E7.js";
+import "../chunk-44VE5POH.js";
+export {
+  qtiTransformItem,
+  qtiTransformManifest,
+  qtiTransformTest
+};
+//# sourceMappingURL=index.js.map

package/dist/qti-transformers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/test.context-DbSTxKk_.d.ts

@@ -0,0 +1,99 @@
+import * as lit_html from 'lit-html';
+import { LitElement } from 'lit';
+import { j as QtiAssessmentItem, af as ItemContext, e as VariableDeclaration } from './qti-simple-choice-DxWcdKHi.js';
+
+declare class QtiAssessmentItemRef extends LitElement {
+    category?: string;
+    identifier?: string;
+    required?: boolean;
+    fixed?: boolean;
+    href?: string;
+    _testContext?: TestContext;
+    weigths: Map<string, number>;
+    xmlDoc: DocumentFragment;
+    protected createRenderRoot(): HTMLElement | DocumentFragment;
+    get assessmentItem(): QtiAssessmentItem | null;
+    connectedCallback(): Promise<void>;
+    render(): lit_html.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'qti-assessment-item-ref': QtiAssessmentItemRef;
+    }
+}
+
+declare class QtiAssessmentSection extends LitElement {
+    identifier: string;
+    required: string;
+    fixed: boolean;
+    title: string;
+    visible: boolean;
+    keepTogether: boolean;
+    _testContext?: TestContext;
+    connectedCallback(): Promise<void>;
+    render(): lit_html.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'qti-assessment-section': QtiAssessmentSection;
+    }
+}
+
+declare class QtiAssessmentTest extends LitElement {
+    identifier: string;
+    title: string;
+    _testContext?: TestContext;
+    connectedCallback(): Promise<void>;
+    render(): lit_html.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'qti-assessment-test': QtiAssessmentTest;
+    }
+}
+
+declare class QtiTestPart extends LitElement {
+    identifier: string;
+    title: string;
+    class: string;
+    NavigationMode: 'linear' | 'nonlinear';
+    submissionMode: 'individual' | 'simultaneous';
+    connectedCallback(): Promise<void>;
+    render(): lit_html.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'qti-test-part': QtiTestPart;
+    }
+}
+
+type View = 'author' | 'candidate' | 'proctor' | 'scorer' | 'testConstructor' | 'tutor' | '';
+declare module '../context/test.context' {
+    interface TestContext {
+        view?: View;
+    }
+}
+
+interface TestContext {
+    items: (ItemContext & {
+        category?: string;
+    })[];
+    testOutcomeVariables: VariableDeclaration<string | string[]>[];
+    navPartId?: string | null;
+    navSectionId?: string | null;
+    navItemId?: string | null;
+    navItemLoading?: boolean;
+    navTestLoading?: boolean;
+    view?: View;
+}
+declare const testContext: {
+    __context__: Readonly<TestContext>;
+};
+type TestElement = {
+    el: QtiAssessmentTest;
+};
+declare const testElement: {
+    __context__: Readonly<TestElement>;
+};
+
+export { QtiAssessmentItemRef as Q, type TestContext as T, QtiAssessmentSection as a, QtiAssessmentTest as b, QtiTestPart as c, type TestElement as d, testElement as e, testContext as t };

package/dist/vscode.html-custom-data.json

@@ -416,7 +416,7 @@
     },
     {
       "name": "qti-hottext-interaction",
-      "description": "\n---\n\n\n### **Events:**\n - **qti-register-interaction**\n- **qti-interaction-response**",
+      "description": "\n---\n\n\n### **Events:**\n - **qti-register-interaction**\n- **qti-interaction-response**\n\n### **Methods:**\n ",
       "attributes": [
         { "name": "min-choices", "values": [] },
         { "name": "max-choices", "values": [] },
@@ -450,7 +450,7 @@
     },
     {
       "name": "qti-choice-interaction",
-      "description": "An sample element.\n---\n\n\n### **Events:**\n - **qti-register-interaction**\n- **qti-interaction-response**\n\n### **Slots:**\n - _default_ - default slot of the choices\n- **prompt** - slot of the prompt\n\n### **CSS Properties:**\n - **--qti-bg-active** - The active background color _(default: #ffecec)_\n- **--qti-border-active** - The active border color _(default: #f86d70)_\n- **--qti-padding-horizontal** - The option horizontal padding _(default: 1px)_\n- **--qti-padding-vertical** - The option vertical padding _(default: solid)_\n- **--qti-border-radius** - The option border radius _(default: 8px)_\n\n### **CSS Parts:**\n - **slot** - The choice elements\n- **prompt** - The prompt\n- **message** - The validation message",
+      "description": "An sample element.\n---\n\n\n### **Events:**\n - **qti-register-interaction**\n- **qti-interaction-response**\n\n### **Methods:**\n \n\n### **Slots:**\n - _default_ - default slot of the choices\n- **prompt** - slot of the prompt\n\n### **CSS Properties:**\n - **--qti-bg-active** - The active background color _(default: #ffecec)_\n- **--qti-border-active** - The active border color _(default: #f86d70)_\n- **--qti-padding-horizontal** - The option horizontal padding _(default: 1px)_\n- **--qti-padding-vertical** - The option vertical padding _(default: solid)_\n- **--qti-border-radius** - The option border radius _(default: 8px)_\n\n### **CSS Parts:**\n - **slot** - The choice elements\n- **prompt** - The prompt\n- **message** - The validation message",
       "attributes": [
         { "name": "orientation", "values": [{ "name": "Orientation" }] },
         { "name": "class", "values": [] },
@@ -519,12 +519,12 @@
     },
     {
       "name": "qti-associate-interaction",
-      "description": "\n---\n\n\n### **Events:**\n - **qti-register-interaction**\n- **qti-interaction-response**",
+      "description": "\n---\n\n\n### **Events:**\n - **qti-interaction-response**\n- **qti-register-interaction**",
       "attributes": [
         { "name": "min-associations", "values": [] },
         { "name": "max-associations", "values": [] },
-        { "name": "disabled", "values": [] },
         { "name": "response-identifier", "values": [] },
+        { "name": "disabled", "values": [] },
         { "name": "readonly", "values": [] }
       ],
       "references": []
@@ -545,24 +545,27 @@
     },
     {
       "name": "qti-end-attempt-interaction",
-      "description": "\n---\n\n\n### **Events:**\n - **end-attempt**\n- **qti-register-interaction**\n- **qti-interaction-response**",
+      "description": "\n---\n\n\n### **Events:**\n - **end-attempt**",
       "attributes": [
-        { "name": "count-attempt", "values": [] },
-        { "name": "title", "values": [{ "name": "end attempt" }] },
         { "name": "response-identifier", "values": [] },
         { "name": "disabled", "values": [] },
-        { "name": "readonly", "values": [] }
+        {
+          "name": "count-attempt",
+          "description": "Defines the number of attempts that a user can make using the 'endAttemptInteraction' mechanism (this can be used to limit the number of hints, etc.). [More information](https://www.imsglobal.org/sites/default/files/spec/qti/v3/info/index.html#DataCharacteristic_EndAttemptInteraction.Attr_count-attempt)",
+          "values": [{ "name": "true" }, { "name": "false" }]
+        },
+        { "name": "title", "values": [] }
       ],
       "references": []
     },
     {
       "name": "qti-gap-match-interaction",
-      "description": "\n---\n\n\n### **Events:**\n - **qti-register-interaction**\n- **qti-interaction-response**",
+      "description": "\n---\n\n\n### **Events:**\n - **qti-interaction-response**\n- **qti-register-interaction**",
       "attributes": [
         { "name": "min-associations", "values": [] },
         { "name": "max-associations", "values": [] },
-        { "name": "disabled", "values": [] },
         { "name": "response-identifier", "values": [] },
+        { "name": "disabled", "values": [] },
         { "name": "readonly", "values": [] }
       ],
       "references": []
@@ -591,19 +594,19 @@
     },
     {
       "name": "qti-graphic-gap-match-interaction",
-      "description": "\n---\n\n\n### **Events:**\n - **qti-register-interaction**\n- **qti-interaction-response**",
+      "description": "\n---\n\n\n### **Events:**\n - **qti-interaction-response**\n- **qti-register-interaction**",
       "attributes": [
         { "name": "min-associations", "values": [] },
         { "name": "max-associations", "values": [] },
-        { "name": "disabled", "values": [] },
         { "name": "response-identifier", "values": [] },
+        { "name": "disabled", "values": [] },
         { "name": "readonly", "values": [] }
       ],
       "references": []
     },
     {
       "name": "qti-graphic-order-interaction",
-      "description": "\n---\n\n\n### **Events:**\n - **qti-register-interaction**\n- **qti-interaction-response**",
+      "description": "\n---\n\n\n### **Events:**\n - **qti-register-interaction**\n- **qti-interaction-response**\n\n### **Methods:**\n ",
       "attributes": [
         { "name": "min-choices", "values": [] },
         { "name": "max-choices", "values": [] },
@@ -615,7 +618,7 @@
     },
     {
       "name": "qti-hotspot-interaction",
-      "description": "\n---\n\n\n### **Events:**\n - **qti-register-interaction**\n- **qti-interaction-response**",
+      "description": "\n---\n\n\n### **Events:**\n - **qti-register-interaction**\n- **qti-interaction-response**\n\n### **Methods:**\n ",
       "attributes": [
         { "name": "min-choices", "values": [] },
         { "name": "max-choices", "values": [] },
@@ -627,7 +630,7 @@
     },
     {
       "name": "qti-match-interaction",
-      "description": "\n---\n\n\n### **Events:**\n - **qti-register-interaction**\n- **qti-interaction-response**",
+      "description": "\n---\n\n\n### **Events:**\n - **qti-interaction-response**\n- **qti-register-interaction**",
       "attributes": [
         { "name": "class", "values": [] },
         { "name": "response-identifier", "values": [] },
@@ -650,7 +653,7 @@
     },
     {
       "name": "qti-order-interaction",
-      "description": "\n---\n\n\n### **Events:**\n - **qti-register-interaction**\n- **qti-interaction-response**",
+      "description": "\n---\n\n\n### **Events:**\n - **qti-interaction-response**\n- **qti-register-interaction**",
       "attributes": [
         {
           "name": "orientation",
@@ -664,8 +667,8 @@
         },
         { "name": "min-associations", "values": [] },
         { "name": "max-associations", "values": [] },
-        { "name": "disabled", "values": [] },
         { "name": "response-identifier", "values": [] },
+        { "name": "disabled", "values": [] },
         { "name": "readonly", "values": [] }
       ],
       "references": []
@@ -804,6 +807,24 @@
       ],
       "references": []
     },
+    {
+      "name": "item-container",
+      "description": "`<item-container>` is a custom element designed for hosting the qti-assessment-item.\nThe `qti-assessment-item` will be placed inside the shadow DOM of this element.\nThe element loads the item from the provided URL and renders it inside the shadow DOM.\n\n### Styling\nAdd a class to the element for styling.\n\n```html\n<qti-item>\n  <item-container class=\"m-4 bg-white\" item-url=\"./path/to/item.xml\"></item-container>\n</qti-item>\n```\n---\n",
+      "attributes": [
+        {
+          "name": "item-url",
+          "description": "URL of the item to load",
+          "values": []
+        }
+      ],
+      "references": []
+    },
+    {
+      "name": "qti-item",
+      "description": "`<qti-item>` is a custom element designed for rendering a single `qti-assessment-item`.\nIt can also host some functionalities to interact with the item like scoring, showing feedback, etc.\nPlacing a mandatory `<item-container>` inside '<qti-item>' will load or parse the item and render it.\nSee `<item-container>` for more details.\n\n```html\n<qti-item>\n  <item-container class=\"m-4 bg-white\" item-url=\"./path/to/item.xml\"></item-container>\n</qti-item>\n```\n---\n",
+      "attributes": [],
+      "references": []
+    },
     {
       "name": "qti-assessment-item-ref",
       "description": "\n---\n\n\n### **Events:**\n - **qti-assessment-item-ref-connected**",
@@ -856,12 +877,6 @@
       ],
       "references": []
     },
-    {
-      "name": "qti-test",
-      "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-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</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.\n---\n",
-      "attributes": [],
-      "references": []
-    },
     {
       "name": "test-next",
       "description": "Represents a custom element for navigating to the next test item.\n---\n\n\n### **Events:**\n - **on-test-switch-view**\n- **qti-request-test-item**",
@@ -878,8 +893,16 @@
       "name": "test-view",
       "description": "\n---\n\n\n### **Events:**\n - **on-test-switch-view**\n- **qti-request-test-item**",
       "attributes": [
-        { "name": "label", "values": [] },
-        { "name": "view-options", "values": [] }
+        {
+          "name": "label",
+          "description": "label accompanying the select view dropdown",
+          "values": []
+        },
+        {
+          "name": "view-options",
+          "description": "The options to display in the dropdown, default: ['author', 'candidate', 'proctor', 'scorer', 'testConstructor', 'tutor']",
+          "values": []
+        }
       ],
       "references": []
     },
@@ -889,18 +912,6 @@
       "attributes": [{ "name": "item-id", "values": [] }],
       "references": []
     },
-    {
-      "name": "test-container",
-      "description": "`<test-container>` is a custom element designed for hosting the qti-assessment-item.\nThe `qti-assessment-test` will be placed inside the shadow DOM of this element.\nThe element loads the item from the provided URL and renders it inside the shadow DOM.\n\n### Styling\nAdd a class to the element for styling.\n\n```html\n<qti-test>\n  <test-container class=\"m-4 bg-white\" test-url=\"./path/to/item.xml\"></test-container>\n</qti-test>\n```\n---\n",
-      "attributes": [
-        {
-          "name": "test-url",
-          "description": "URL of the item to load",
-          "values": []
-        }
-      ],
-      "references": []
-    },
     {
       "name": "test-paging-buttons-stamp",
       "description": "\n---\n\n\n### **Events:**\n - **on-test-switch-view**\n- **qti-request-test-item**",
@@ -911,17 +922,17 @@
       "references": []
     },
     {
-      "name": "qti-item",
-      "description": "`<qti-item>` is a custom element designed for rendering a single `qti-assessment-item`.\nIt can also host some functionalities to interact with the item like scoring, showing feedback, etc.\nPlacing a mandatory `<item-container>` inside '<qti-item>' will load or parse the item and render it.\nSee `<item-container>` for more details.\n\n```html\n<qti-item>\n  <item-container class=\"m-4 bg-white\" item-url=\"./path/to/item.xml\"></item-container>\n</qti-item>\n```\n---\n",
+      "name": "qti-test",
+      "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-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</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.\n---\n",
       "attributes": [],
       "references": []
     },
     {
-      "name": "item-container",
-      "description": "`<item-container>` is a custom element designed for hosting the qti-assessment-item.\nThe `qti-assessment-item` will be placed inside the shadow DOM of this element.\nThe element loads the item from the provided URL and renders it inside the shadow DOM.\n\n### Styling\nAdd a class to the element for styling.\n\n```html\n<qti-item>\n  <item-container class=\"m-4 bg-white\" item-url=\"./path/to/item.xml\"></item-container>\n</qti-item>\n```\n---\n",
+      "name": "test-container",
+      "description": "`<test-container>` is a custom element designed for hosting the qti-assessment-item.\nThe `qti-assessment-test` will be placed inside the shadow DOM of this element.\nThe element loads the test from the provided URL and renders it inside the shadow DOM.\n\n```html\n<qti-test>\n  <test-container class=\"m-4 bg-white\" test-url=\"./path/to/assessmenttest.xml\"></test-container>\n</qti-test>\n```\n---\n",
       "attributes": [
         {
-          "name": "item-url",
+          "name": "test-url",
           "description": "URL of the item to load",
           "values": []
         }