@citolab/qti-components 7.16.0 → 7.16.1

package/dist/test.d.ts

@@ -1 +1,569 @@
-export * from '@qti-components/test';
+import * as lit from 'lit';
+import { LitElement, PropertyValues, nothing } from 'lit';
+import { QtiAssessmentItem, QtiModalFeedback } from './elements.js';
+import { TemplateFunction } from '@heximal/templates';
+import { T as TestContext, a as QtiContext } from './test.context-Bpw1HNAZ.js';
+import { S as SessionContext, a as ComputedContext, C as ComputedItem, V as View } from './computed.context-CH09_LCR.js';
+import { a as ConfigContext } from './config.context-DAdkDDf5.js';
+import { V as VariableValue, j as OutcomeVariable, h as VariableDeclaration } from './variables-CusMRnyJ.js';
+import { t as transformItemApi, a as transformTestApi } from './qti-transform-test-Bz9A3hmD.js';
+import './qti-feedback-B4cMzOcq.js';
+import './item.context-BRKXBC3m.js';
+import './computed-item.context-CiddHLPz.js';
+
+declare class QtiAssessmentTest extends LitElement {
+    identifier: string;
+    get title(): string;
+    set title(value: string);
+    _testContext?: TestContext;
+    private _title;
+    connectedCallback(): Promise<void>;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'qti-assessment-test': QtiAssessmentTest;
+    }
+}
+
+interface TestBaseInterface extends LitElement {
+    testContext: Readonly<TestContext>;
+    sessionContext: Readonly<SessionContext>;
+    _testElement: QtiAssessmentTest;
+    updateItemVariables(itemRefID: string, variables: VariableValue<string | string[] | null>[]): void;
+}
+
+type PostLoadTransformCallback = (transformer: transformItemApi, itemRef: QtiAssessmentItemRef) => transformItemApi | Promise<transformItemApi>;
+type PostLoadTestTransformCallback = (transformer: transformTestApi, testElement: QtiAssessmentTest) => transformTestApi | Promise<transformTestApi>;
+
+declare const QtiTest_base: (abstract new (...args: any[]) => {}) & (abstract new (...args: any[]) => {}) & (abstract new (...args: any[]) => {
+    updateOutcomeVariable(identifier: string, value: string | string[] | undefined): void;
+    getOutcome(identifier: string): Readonly<OutcomeVariable>;
+    getVariable(identifier: string): Readonly<VariableDeclaration<string | string[] | null>>;
+    outcomeProcessing(): boolean;
+}) & (abstract new (...args: any[]) => TestBaseInterface) & typeof LitElement;
+/**
+ * `<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-navigation>
+ *    <test-container test-url="./path/to/assessment.xml"></test-container>
+ *    <nav class="flex">
+ *      <test-prev></test-prev>
+ *      <test-next></test-next>
+ *    </nav>
+ *  </test-navigation>
+ * </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.
+     */
+    connectedCallback(): Promise<void>;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'qti-test': QtiTest;
+    }
+}
+
+declare class QtiAssessmentItemRef extends LitElement {
+    category?: string;
+    identifier?: string;
+    required?: boolean;
+    fixed?: boolean;
+    href?: string;
+    weigths: Map<string, number>;
+    xmlDoc: DocumentFragment;
+    protected createRenderRoot(): HTMLElement | DocumentFragment;
+    get assessmentItem(): QtiAssessmentItem | null;
+    myTemplate: TemplateFunction;
+    connectedCallback(): Promise<void>;
+    render(): unknown;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'qti-assessment-item-ref': QtiAssessmentItemRef;
+    }
+}
+
+declare class QtiAssessmentSection extends LitElement {
+    identifier: string;
+    required: string;
+    fixed: boolean;
+    get title(): string;
+    set title(value: string);
+    visible: boolean;
+    keepTogether: boolean;
+    _testContext?: TestContext;
+    private _title;
+    connectedCallback(): Promise<void>;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'qti-assessment-section': QtiAssessmentSection;
+    }
+}
+
+declare class QtiTestPart extends LitElement {
+    identifier: string;
+    get title(): string;
+    set title(value: string);
+    class: string;
+    navigationMode: 'linear' | 'nonlinear';
+    submissionMode: 'individual' | 'simultaneous';
+    private _title;
+    connectedCallback(): Promise<void>;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'qti-test-part': QtiTestPart;
+    }
+}
+
+declare class QtiTestFeedback extends QtiModalFeedback {
+    static styles: lit.CSSResult;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'qti-test-feedback': QtiTestFeedback;
+    }
+}
+
+type CustomEventMap = {
+    'test-end-attempt': CustomEvent;
+    'test-show-correct-response': CustomEvent<{
+        value: boolean;
+    }>;
+};
+declare global {
+    interface GlobalEventHandlersEventMap extends CustomEventMap {
+    }
+}
+declare class TestNavigation extends LitElement {
+    identifier: string | undefined;
+    initContext: {
+        identifier: string;
+        [key: string]: any;
+    }[];
+    qtiContext: QtiContext;
+    configContext: ConfigContext;
+    protected _testContext?: TestContext;
+    protected _sessionContext?: SessionContext;
+    protected computedContext: ComputedContext;
+    autoScoreItems: boolean;
+    private _testElement;
+    constructor();
+    /**
+     * Handles the 'test-end-attempt' event.
+     * @private
+     * @listens TestNavigation#test-end-attempt
+     * @param {CustomEvent} event - The custom event object.
+     */
+    private _handleTestEndAttempt;
+    /**
+     * Handles the 'test-show-correct-response' event.
+     * @private
+     * @listens TestNavigation#test-show-correct-response
+     * @param {CustomEvent} event - The custom event object.
+     */
+    private _handleTestShowCorrectResponse;
+    /**
+     * Handles the 'test-show-candidate-correction' event.
+     * @private
+     * @listens TestNavigation#test-show-candidate-correction
+     * @param {CustomEvent} event - The custom event object.
+     */
+    private _handleTestShowCandidateCorrection;
+    private _handleTestUpdateOutcomeVariable;
+    private _handleInteractionChanged;
+    render(): lit.TemplateResult<1>;
+    private _handleTestConnected;
+    /**
+     * Extract default values from a qti-context-declaration element
+     */
+    private _extractDefaultValues;
+    private _handleItemConnected;
+    protected willUpdate(_changedProperties: PropertyValues): void;
+}
+
+/**
+ * Represents a custom element for navigating to the next test item.
+ *
+ * @remarks
+ * This element provides functionality for navigating to the next test item.
+ *
+ * @example
+ * ```html
+ * <test-next></test-next>
+ * ```
+ */
+declare class TestNext extends LitElement {
+    _internalDisabled: boolean;
+    protected computedContext: ComputedContext;
+    sectionItems: ComputedItem[];
+    itemIndex: number;
+    _handleTestElementChange(_oldValue: ComputedContext, newValue: ComputedContext): void;
+    static styles: lit.CSSResult;
+    private _internals;
+    constructor();
+    connectedCallback(): void;
+    willUpdate(_changedProperties: Map<string | number | symbol, unknown>): void;
+    checkDisabled(): void;
+    protected _requestItem(identifier: string): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-next': TestNext;
+    }
+}
+
+/**
+ * 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 LitElement {
+    _internalDisabled: boolean;
+    private computedContext;
+    sectionItems: ComputedItem[];
+    itemIndex: number;
+    _handleTestElementChange(_oldValue: ComputedContext, newValue: ComputedContext): void;
+    static styles: lit.CSSResult;
+    constructor();
+    willUpdate(_changedProperties: Map<string | number | symbol, unknown>): void;
+    checkDisabled(): void;
+    protected _requestItem(identifier: string): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-previous': TestPrev;
+    }
+}
+
+declare class TestView extends LitElement {
+    static DEFAULT_VIEW_OPTIONS: string[];
+    private sessionContext;
+    /** label accompanying the select view dropdown  */
+    label: string;
+    /** The options to display in the dropdown, default: ['author', 'candidate', 'proctor', 'scorer', 'testConstructor', 'tutor'] */
+    viewOptions: string;
+    protected _handleViewOptionsChange: () => void;
+    connectedCallback(): void;
+    private _viewOptions;
+    private updateViewOptions;
+    protected _switchView(view: string): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-view': TestView;
+    }
+}
+
+declare class TestItemLink extends LitElement {
+    static styles: lit.CSSResult;
+    private itemId;
+    constructor();
+    protected _requestItem(identifier: string): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-item-link': TestItemLink;
+    }
+}
+
+declare class TestEndAttempt extends LitElement {
+    static styles: lit.CSSResult;
+    constructor();
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-end-attempt': TestEndAttempt;
+    }
+}
+
+/**
+ * @deprecated test-show-correct-response is deprecated and will be removed in the future.
+ */
+declare class TestShowCorrectResponse extends LitElement {
+    computedContext?: ComputedContext;
+    static styles: lit.CSSResult;
+    shown: boolean;
+    disabled: boolean;
+    showCorrectText: string;
+    hideCorrectText: string;
+    noCorrectResponseText: string;
+    private _previousActiveItem?;
+    willUpdate(_changedProperties: Map<string | number | symbol, unknown>): void;
+    private _toggleState;
+    private _getDisplayedText;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-show-correct-response': TestShowCorrectResponse;
+    }
+}
+
+/**
+ * @deprecated test-paging-buttons-stamp is deprecated and will be removed in the future.
+ */
+declare class TestPagingButtonsStamp extends LitElement {
+    private computedContext;
+    myTemplate: TemplateFunction;
+    private _internals;
+    protected createRenderRoot(): HTMLElement | DocumentFragment;
+    constructor();
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-paging-buttons-stamp': TestPagingButtonsStamp;
+    }
+}
+
+/**
+ * `<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-navigation>
+ *      <test-container class="m-4 bg-white" test-url="./path/to/assessmenttest.xml"></test-container>
+ *   </test-navigation>
+ * </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;
+    /** Callback function to transform the test after loading */
+    protected handleTestURLChange(): Promise<void>;
+    protected handleTestXMLChange(): void;
+    connectedCallback(): Promise<void>;
+    private initializeTemplateContent;
+    private applyStyles;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-container': TestContainer;
+    }
+}
+
+declare class TestPrintVariables extends LitElement {
+    computedContext?: ComputedContext;
+    static styles: lit.CSSResult;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-print-item-variables': TestPrintVariables;
+    }
+}
+
+/**
+ * @deprecated test-section-buttons-stamp is deprecated and will be removed in the future.
+ */
+declare class TestSectionButtonsStamp extends LitElement {
+    private computedContext;
+    myTemplate: TemplateFunction;
+    private _internals;
+    protected createRenderRoot(): HTMLElement | DocumentFragment;
+    constructor();
+    connectedCallback(): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-section-buttons-stamp': TestSectionButtonsStamp;
+    }
+}
+
+declare class TestSectionLink extends LitElement {
+    static styles: lit.CSSResult;
+    private sectionId;
+    private _requestItem;
+    constructor();
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-section-link': TestSectionLink;
+    }
+}
+
+declare class TestPrintContext extends LitElement {
+    computedContext?: ComputedContext;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-print-context': TestPrintContext;
+    }
+}
+
+/**
+ * A custom web component that renders a test stamp using the Lit framework.
+ * This component is deprecated and will be removed in the future.
+ * @customElement
+ * @extends {LitElement}
+ */
+declare class TestStamp extends LitElement {
+    /**
+     * Indicates whether the component is in debug mode.
+     * When set to `true`, the available objects and properties (i.e.: stampContext) is displayed.
+     */
+    debug: boolean;
+    private computedContext;
+    private stampContext;
+    myTemplate: TemplateFunction;
+    protected createRenderRoot(): HTMLElement | DocumentFragment;
+    connectedCallback(): void;
+    protected willUpdate(_changedProperties: PropertyValues): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-stamp': TestStamp;
+    }
+}
+
+declare class TestScoringButtons extends LitElement {
+    view: string;
+    disabled: boolean;
+    myTemplate: TemplateFunction | null;
+    protected createRenderRoot(): HTMLElement | DocumentFragment;
+    connectedCallback(): void;
+    protected computedContext?: ComputedContext;
+    private _changeOutcomeScore;
+    render(): lit.TemplateResult<1> | typeof nothing;
+    constructor();
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-scoring-buttons': TestScoringButtons;
+    }
+}
+
+declare class TestViewToggle extends LitElement {
+    myTemplate: any;
+    protected createRenderRoot(): HTMLElement | DocumentFragment;
+    private sessionContext;
+    connectedCallback(): void;
+    _switchView(view: string): void;
+    protected firstUpdated(_changedProperties: PropertyValues): void;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-view-toggle': TestViewToggle;
+    }
+}
+
+declare class TestScoringFeedback extends LitElement {
+    protected computedContext?: ComputedContext;
+    view: View;
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-scoring-feedback': TestScoringFeedback;
+    }
+}
+
+declare class TestCheckItem extends LitElement {
+    static styles: lit.CSSResult;
+    constructor();
+    render(): lit.TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'test-check-item': TestCheckItem;
+    }
+}
+
+interface IQtiTest extends LitElement, ITestNavigationMixin, ITestProcessingMixin, IMyQtiTest {
+}
+interface IMyQtiTest {
+    testContext: Readonly<TestContext>;
+    sessionContext: Readonly<SessionContext>;
+    updateItemVariables(itemRefID: string, variables: VariableValue<string | string[] | null>[]): void;
+}
+interface ITestNavigationMixin {
+    navigate: 'item' | 'section' | null;
+    cacheTransform: boolean;
+    requestTimeout: number;
+    showLoadingIndicators: boolean;
+    postLoadTransformCallback: PostLoadTransformCallback | null;
+    postLoadTestTransformCallback: PostLoadTestTransformCallback | null;
+    navigateTo(type: 'item' | 'section', id?: string): void;
+    retryNavigation(): void;
+}
+interface ITestProcessingMixin {
+    updateOutcomeVariable(identifier: string, value: string | string[] | undefined): void;
+    getOutcome(identifier: string): Readonly<OutcomeVariable>;
+    getVariable(identifier: string): Readonly<VariableDeclaration<string | string[] | null>>;
+    outcomeProcessing(): boolean;
+}
+
+export { type IMyQtiTest, type IQtiTest, type ITestNavigationMixin, type ITestProcessingMixin, QtiAssessmentItemRef, QtiAssessmentSection, QtiAssessmentTest, QtiTest, QtiTestFeedback, QtiTestPart, TestCheckItem, TestContainer, TestEndAttempt, TestItemLink, TestNavigation, TestNext, TestPagingButtonsStamp, TestPrev, TestPrintContext, TestPrintVariables, TestScoringButtons, TestScoringFeedback, TestSectionButtonsStamp, TestSectionLink, TestShowCorrectResponse, TestStamp, TestView, TestViewToggle };

package/dist/test.js

@@ -1,3 +1,61 @@
-// src/test.ts
-export * from "@qti-components/test";
+import {
+  QtiAssessmentItemRef,
+  QtiAssessmentSection,
+  QtiAssessmentTest,
+  QtiTest,
+  QtiTestFeedback,
+  QtiTestPart,
+  TestCheckItem,
+  TestContainer,
+  TestEndAttempt,
+  TestItemLink,
+  TestNavigation,
+  TestNext,
+  TestPagingButtonsStamp,
+  TestPrev,
+  TestPrintContext,
+  TestPrintVariables,
+  TestScoringButtons,
+  TestScoringFeedback,
+  TestSectionButtonsStamp,
+  TestSectionLink,
+  TestShowCorrectResponse,
+  TestStamp,
+  TestView,
+  TestViewToggle
+} from "./chunk-352OTVTY.js";
+import "./chunk-O4XIWHTF.js";
+import "./chunk-DWIRLYDS.js";
+import "./chunk-W4SQRNWO.js";
+import "./chunk-F44CI35W.js";
+import "./chunk-2ZEJ3RR5.js";
+import "./chunk-INKI27D5.js";
+import "./chunk-JEUY3MYB.js";
+import "./chunk-EUXUH3YW.js";
+export {
+  QtiAssessmentItemRef,
+  QtiAssessmentSection,
+  QtiAssessmentTest,
+  QtiTest,
+  QtiTestFeedback,
+  QtiTestPart,
+  TestCheckItem,
+  TestContainer,
+  TestEndAttempt,
+  TestItemLink,
+  TestNavigation,
+  TestNext,
+  TestPagingButtonsStamp,
+  TestPrev,
+  TestPrintContext,
+  TestPrintVariables,
+  TestScoringButtons,
+  TestScoringFeedback,
+  TestSectionButtonsStamp,
+  TestSectionLink,
+  TestShowCorrectResponse,
+  TestStamp,
+  TestView,
+  TestViewToggle
+};
 //# sourceMappingURL=test.js.map

package/dist/test.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/test.ts"],"sourcesContent":["export * from '@qti-components/test';\n"],"mappings":";AAAA,cAAc;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/transformers.d.ts

@@ -1 +1,18 @@
-export * from '@qti-components/transformers';
+export { M as ModuleResolutionConfig, q as qtiTransformItem, b as qtiTransformTest, t as transformItemApi, a as transformTestApi } from './qti-transform-test-Bz9A3hmD.js';
+
+declare const qtiTransformManifest: () => {
+    load: (uri: string, signal?: AbortSignal) => Promise<{
+        load(uri: string, signal: AbortSignal): Promise</*elided*/ any>;
+        parse(xmlString: string): void;
+        assessmentTest(): {
+            href: string;
+            identifier: string;
+        };
+    }>;
+    assessmentTest: () => {
+        href: string;
+        identifier: string;
+    };
+};
+
+export { qtiTransformManifest };

package/dist/transformers.js

@@ -1,3 +1,12 @@
-// src/transformers.ts
-export * from "@qti-components/transformers";
+import {
+  qtiTransformItem,
+  qtiTransformManifest,
+  qtiTransformTest
+} from "./chunk-INKI27D5.js";
+import "./chunk-EUXUH3YW.js";
+export {
+  qtiTransformItem,
+  qtiTransformManifest,
+  qtiTransformTest
+};
 //# sourceMappingURL=transformers.js.map

package/dist/transformers.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/transformers.ts"],"sourcesContent":["export * from '@qti-components/transformers';\n"],"mappings":";AAAA,cAAc;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}