@qti-components/base 2.2.0 → 2.4.0

package/dist/abstract/interaction.d.ts

@@ -10,7 +10,7 @@ import type { ResponseVariable } from '../lib/variables';
  */
 export declare abstract class Interaction extends LitElement implements ValidatableInteraction {
     #private;
-    private _context;
+    private get _context();
     /**
      * Delivery configuration, from the nearest provider — `qti-test` or `qti-item`.
      *

package/dist/abstract/interaction.js

@@ -4,7 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { consume, provide } from '@lit/context';
+import { ContextConsumer, consume, provide } from '@lit/context';
 import { LitElement } from 'lit';
 import { property } from 'lit/decorators.js';
 import { configContext } from '../context/config.context';
@@ -15,6 +15,86 @@ import { itemContext } from '../context/item.context';
  * `@qti-components/corrections` package.
  */
 export class Interaction extends LitElement {
+    /**
+     * The item's variables. The interaction takes its response from here as well as publishing it:
+     * when the item's value for this response changes to something other than what the interaction
+     * shows, it adopts it. That is how `item.variables = …` reaches it, with no list of interactions
+     * kept by the item. See {@link Interaction.#adoptResponse}.
+     */
+    #itemContext;
+    get _context() {
+        return this.#itemContext.value;
+    }
+    #seenReadonly;
+    #seenDisabled;
+    /**
+     * Follows the item: its `readonly` and `disabled`, and the value it holds for this response.
+     * `readonly` and `disabled` are only taken when the item says something, so an interaction
+     * authored with either stays so inside an item that does not mention it.
+     */
+    #followItem(context) {
+        if (context?.readonly !== undefined && context.readonly !== this.#seenReadonly) {
+            this.#seenReadonly = context.readonly;
+            this.readonly = context.readonly;
+        }
+        if (context?.disabled !== undefined && context.disabled !== this.#seenDisabled) {
+            this.#seenDisabled = context.disabled;
+            this.disabled = context.disabled;
+        }
+        this.#adoptResponse(context);
+    }
+    /** The item's last value for this response, serialised, to tell a change from an unrelated update. */
+    #seenResponse;
+    /**
+     * What this interaction last published or adopted, serialised. It is kept from the interaction's
+     * own `qti-interaction-response` events, which every emitter dispatches on the interaction itself,
+     * and not read back from `response`: that getter has no common shape (the drag-drop interactions
+     * return one comma-joined string where they publish an array), so it cannot be compared.
+     */
+    #lastResponse;
+    #adoptScheduled;
+    /**
+     * Adopts the item's value for this response when it changed and the interaction does not already
+     * show it.
+     *
+     * Two things keep this from fighting the candidate. It reacts to the item's value for *this*
+     * response changing, not to any context update, so a score or a timer ticking never rewrites what
+     * is being typed. And when the item's value is what the interaction itself last published (which
+     * is what happens right after it publishes an answer) it does nothing, so there is no echo.
+     *
+     * The first value is only adopted when it says something: an unanswered item must not wipe a
+     * `response` attribute the author put on the interaction.
+     *
+     * Setting `response` on an interaction that has not rendered yet is what the item used to avoid
+     * by waiting, so until the first update this waits too, then looks at the latest value.
+     */
+    #adoptResponse(context) {
+        const id = this.responseIdentifier ?? this.getAttribute('response-identifier');
+        const variable = context?.variables?.find(v => v.type === 'response' && v.identifier === id);
+        if (!variable)
+            return;
+        if (!this.hasUpdated) {
+            if (!this.#adoptScheduled) {
+                this.#adoptScheduled = true;
+                void this.updateComplete.then(() => {
+                    this.#adoptScheduled = false;
+                    this.#adoptResponse(this._context);
+                });
+            }
+            return;
+        }
+        const first = this.#seenResponse === undefined;
+        const serialised = JSON.stringify(variable.value ?? null);
+        if (serialised === this.#seenResponse)
+            return;
+        this.#seenResponse = serialised;
+        if (first && (variable.value === null || variable.value === undefined))
+            return;
+        if (serialised === this.#lastResponse)
+            return;
+        this.#lastResponse = serialised;
+        this.response = variable.value;
+    }
     #didLogDisableAfterIfMaxChoicesReachedDeprecation;
     static { this.formAssociated = true; }
     get internals() {
@@ -84,7 +164,7 @@ export class Interaction extends LitElement {
         if (config.disableAfterIfMaxChoicesReached !== undefined) {
             if (!this.#didLogDisableAfterIfMaxChoicesReachedDeprecation) {
                 this.#didLogDisableAfterIfMaxChoicesReachedDeprecation = true;
-                console.log('[QTI Config] `disableAfterIfMaxChoicesReached` is deprecated. Use `disableAfterMaxReached` instead.');
+                console.warn('[QTI Config] `disableAfterIfMaxChoicesReached` is deprecated. Use `disableAfterMaxReached` instead.');
             }
             return config.disableAfterIfMaxChoicesReached;
         }
@@ -157,6 +237,18 @@ export class Interaction extends LitElement {
     }
     constructor() {
         super();
+        /**
+         * The item's variables. The interaction takes its response from here as well as publishing it:
+         * when the item's value for this response changes to something other than what the interaction
+         * shows, it adopts it. That is how `item.variables = …` reaches it, with no list of interactions
+         * kept by the item. See {@link Interaction.#adoptResponse}.
+         */
+        this.#itemContext = new ContextConsumer(this, {
+            context: itemContext,
+            subscribe: true,
+            callback: context => this.#followItem(context)
+        });
+        this.#adoptScheduled = false;
         this.#didLogDisableAfterIfMaxChoicesReachedDeprecation = false;
         /*
          * Published to the choice elements inside this interaction — their role, and how to tell
@@ -170,6 +262,9 @@ export class Interaction extends LitElement {
         this.disabled = false;
         this.readonly = false;
         this._internals = this.attachInternals();
+        this.addEventListener('qti-interaction-response', (e) => {
+            this.#lastResponse = JSON.stringify(e.detail?.response ?? null);
+        });
     }
     /**
      * Optional lifecycle bridge for interaction subclasses that do not need changed-property data.
@@ -185,9 +280,6 @@ export class Interaction extends LitElement {
      */
     firstUpdated(_changedProperties) { }
 }
-__decorate([
-    consume({ context: itemContext, subscribe: true })
-], Interaction.prototype, "_context", void 0);
 __decorate([
     consume({ context: configContext, subscribe: true })
 ], Interaction.prototype, "configContext", void 0);

package/dist/abstract/interaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"interaction.js","sourceRoot":"","sources":["../../src/abstract/interaction.ts"],"names":[],"mappings":"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","sourcesContent":["import { consume, provide } from '@lit/context';\nimport { LitElement } from 'lit';\nimport { property } from 'lit/decorators.js';\n\nimport { configContext } from '../context/config.context';\nimport { interactionContext } from '../context/interaction.context';\nimport { itemContext } from '../context/item.context';\n\nimport type { PropertyValues } from 'lit';\nimport type { InteractionContext } from '../context/interaction.context';\nimport type { ConfigContext, ValidationDisplayMode } from '../context/config.context';\nimport type { ItemContext } from '../context/types/item.types';\nimport type { ValidatableInteraction } from '../lib/interaction.interface';\nimport type { ResponseVariable } from '../lib/variables';\n\n/**\n * Shared QTI interaction base. Formative correction behavior is supplied by the\n * `@qti-components/corrections` package.\n */\nexport abstract class Interaction extends LitElement implements ValidatableInteraction {\n  @consume({ context: itemContext, subscribe: true })\n  private _context: ItemContext;\n\n  /**\n   * Delivery configuration, from the nearest provider — `qti-test` or `qti-item`.\n   *\n   * **Public so it can be assigned directly, which is the development-time route.** An interaction\n   * has to work standalone, and in a story or a spec there is usually no provider above it — so\n   * setting the field is all that is needed:\n   *\n   *     orderInteraction.configContext = { allowReorder: false, validationDisplayMode: 'none' };\n   *\n   * With no provider, nothing ever overwrites it. That is the whole contract, and its limit: where a\n   * provider DOES exist it re-emits on its next update and wins, because `@consume` writes this same\n   * field. There is no merging — set the value on the provider in that case.\n   *\n   * In a lit-html template, bind it as a property rather than assigning after the fact:\n   *\n   *     html`<qti-order-interaction .configContext=${{ allowReorder: false }}>…`\n   *\n   * The binding is committed on the detached template clone, before the fragment is inserted, so it\n   * is in place by `connectedCallback` — which matters for anything that reads config on connect.\n   *\n   * It was `protected`, which fooled nobody: every caller reached it anyway through an\n   * `as any` / `as { configContext?: … }` cast. Public says what was already true and removes the\n   * casts, rather than pretending at an encapsulation the type system was the only thing enforcing.\n   */\n  @consume({ context: configContext, subscribe: true })\n  public configContext: ConfigContext;\n\n  #didLogDisableAfterIfMaxChoicesReachedDeprecation = false;\n\n  /*\n   * Published to the choice elements inside this interaction — their role, and how to tell\n   * whether they are draggable. Provided here on the base rather than in a mixin so that\n   * ChoicesMixin and the drag-drop mixins can each contribute without two providers of the same\n   * context competing on one element.\n   *\n   * Reassign, never mutate: an in-place change does not notify consumers.\n   */\n  @provide({ context: interactionContext })\n  protected _interactionContext: Readonly<InteractionContext> = { choiceRole: null, draggablesSelector: null };\n\n  static formAssociated = true;\n  protected _internals: ElementInternals;\n\n  get internals(): ElementInternals {\n    return this._internals;\n  }\n\n  @property({ type: String, attribute: 'response-identifier' }) responseIdentifier: string;\n\n  @property({ reflect: true, type: Boolean }) disabled = false;\n\n  @property({ reflect: true, type: Boolean }) readonly = false;\n\n  @property({ type: String }) name;\n\n  /** Extension point used by wrappers that should not register as candidate inputs. */\n  protected get registersWithItem(): boolean {\n    return true;\n  }\n\n  get isInline(): boolean {\n    return false;\n  }\n\n  get responseVariable(): ResponseVariable | undefined {\n    if (!this._context?.variables) {\n      return undefined;\n    }\n    const responseVariables = this._context.variables.filter(v => v.type === 'response') as ResponseVariable[];\n    const responseIdentifier = this.getAttribute('response-identifier');\n    return responseVariables.find(v => v.identifier === responseIdentifier);\n  }\n\n  abstract validate(): boolean;\n\n  get value(): string | null {\n    return JSON.stringify(this.response);\n  }\n\n  set value(val: string | null) {\n    this.response = val ? JSON.parse(val) : null;\n  }\n\n  abstract get response(): string | string[] | null;\n  abstract set response(val: string | string[] | null);\n\n  public reportValidity(): boolean {\n    const isValid = this._internals.validity.valid;\n    const mode = this.validationDisplayMode;\n\n    if (mode === 'native' || mode === 'both') {\n      this._internals.reportValidity();\n    }\n\n    if (mode === 'inline' || mode === 'both') {\n      this.updateInlineValidationMessage();\n    } else {\n      this.clearInlineValidationMessage();\n    }\n\n    if (mode === 'none') {\n      this.clearInlineValidationMessage();\n    }\n\n    return isValid;\n  }\n\n  protected get validationDisplayMode(): ValidationDisplayMode {\n    return this.configContext?.validationDisplayMode ?? 'inline';\n  }\n\n  protected resolveAllowReorder(options?: { defaultWhenUnset?: boolean }): boolean {\n    const defaultWhenUnset = options?.defaultWhenUnset ?? true;\n    const config = this.configContext;\n    if (!config) {\n      return defaultWhenUnset;\n    }\n    if (config.allowReorder !== undefined) {\n      return config.allowReorder;\n    }\n    return defaultWhenUnset;\n  }\n\n  protected resolveDisableAfterMaxReached(options?: { defaultWhenUnset?: boolean }): boolean {\n    const defaultWhenUnset = options?.defaultWhenUnset ?? false;\n    const config = this.configContext;\n\n    if (!config) {\n      return defaultWhenUnset;\n    }\n\n    if (config.disableAfterMaxReached !== undefined) {\n      return config.disableAfterMaxReached;\n    }\n\n    if (config.disableAfterIfMaxChoicesReached !== undefined) {\n      if (!this.#didLogDisableAfterIfMaxChoicesReachedDeprecation) {\n        this.#didLogDisableAfterIfMaxChoicesReachedDeprecation = true;\n        console.log(\n          '[QTI Config] `disableAfterIfMaxChoicesReached` is deprecated. Use `disableAfterMaxReached` instead.'\n        );\n      }\n      return config.disableAfterIfMaxChoicesReached;\n    }\n\n    return defaultWhenUnset;\n  }\n\n  protected setInteractionValidity(\n    isValid: boolean,\n    validityMessage = '',\n    anchor?: HTMLElement | null,\n    options?: { suppressInline?: boolean }\n  ): void {\n    const validityAnchor = anchor ?? this;\n    this._internals.setValidity(isValid ? {} : { customError: true }, validityMessage, validityAnchor);\n\n    if (\n      options?.suppressInline !== true &&\n      (this.validationDisplayMode === 'inline' || this.validationDisplayMode === 'both')\n    ) {\n      this.updateInlineValidationMessage();\n    }\n  }\n\n  protected updateInlineValidationMessage(): void {\n    const validationMessageElement = this.getValidationMessageElement();\n    if (!validationMessageElement) {\n      return;\n    }\n\n    if (!this._internals.validity.valid) {\n      validationMessageElement.textContent = this._internals.validationMessage;\n      validationMessageElement.style.setProperty('display', 'block', 'important');\n      return;\n    }\n\n    validationMessageElement.textContent = '';\n    validationMessageElement.style.display = 'none';\n  }\n\n  protected clearInlineValidationMessage(): void {\n    const validationMessageElement = this.getValidationMessageElement();\n    if (!validationMessageElement) {\n      return;\n    }\n\n    validationMessageElement.textContent = '';\n    validationMessageElement.style.display = 'none';\n  }\n\n  protected getValidationMessageElement(): HTMLElement | null {\n    return this.shadowRoot?.querySelector('#validation-message') as HTMLElement | null;\n  }\n\n  public reset(): void {\n    this.response = null;\n  }\n\n  public formResetCallback(): void {\n    this.reset();\n  }\n\n  public override connectedCallback(): void {\n    super.connectedCallback();\n\n    if (!this.registersWithItem) {\n      return;\n    }\n\n    this.dispatchEvent(\n      new CustomEvent('qti-register-interaction', {\n        bubbles: true,\n        composed: true,\n        cancelable: false,\n        detail: {\n          interactionElement: this,\n          responseIdentifier: this.responseIdentifier\n        }\n      })\n    );\n  }\n\n  public saveResponse(value: string | string[], state?: string | null): void {\n    this.dispatchEvent(\n      new CustomEvent('qti-interaction-response', {\n        bubbles: true,\n        composed: true,\n        cancelable: false,\n        detail: {\n          responseIdentifier: this.responseIdentifier,\n          response: Array.isArray(value) ? [...value] : value,\n          ...(state !== undefined ? { state } : {})\n        }\n      })\n    );\n  }\n\n  constructor() {\n    super();\n    this._internals = this.attachInternals();\n  }\n\n  /**\n   * Optional lifecycle bridge for interaction subclasses that do not need changed-property data.\n   *\n   * The parameter is `PropertyValues`, matching LitElement, and NOT `PropertyValues<this>`.\n   * The polymorphic `this` narrowed the parameter per subclass, which made every interaction\n   * class structurally incompatible with `LitElement` — so `Constructor<LitElement>`, the\n   * standard constraint for a Lit mixin, rejected all of them and consumers could not wrap an\n   * interaction in a mixin without casting. `this` buys nothing in a parameter position and\n   * costs contravariant compatibility with the base class.\n   *\n   * Still optional, so subclasses that ignore the argument can override with `firstUpdated()`.\n   */\n  protected override firstUpdated(_changedProperties?: PropertyValues): void {}\n}\n"]}
+{"version":3,"file":"interaction.js","sourceRoot":"","sources":["../../src/abstract/interaction.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAStD;;;GAGG;AACH,MAAM,OAAgB,WAAY,SAAQ,UAAU;IAClD;;;;;OAKG;IACH,YAAY,CAIT;IAEH,IAAY,QAAQ;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;IACjC,CAAC;IAED,aAAa,CAAW;IACxB,aAAa,CAAW;IAExB;;;;OAIG;IACH,WAAW,CAAC,OAAgC;QAC1C,IAAI,OAAO,EAAE,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;YAC/E,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;YACtC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACnC,CAAC;QACD,IAAI,OAAO,EAAE,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;YAC/E,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;YACtC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,sGAAsG;IACtG,aAAa,CAAU;IACvB;;;;;OAKG;IACH,aAAa,CAAU;IACvB,eAAe,CAAS;IAExB;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,OAAgC;QAC7C,MAAM,EAAE,GAAG,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC;QAC/E,MAAM,QAAQ,GAAG,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC1B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;gBAC5B,KAAK,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE;oBACjC,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;oBAC7B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACrC,CAAC,CAAC,CAAC;YACL,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;QAC1D,IAAI,UAAU,KAAK,IAAI,CAAC,aAAa;YAAE,OAAO;QAC9C,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC;QAChC,IAAI,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,IAAI,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC;YAAE,OAAO;QAC/E,IAAI,UAAU,KAAK,IAAI,CAAC,aAAa;YAAE,OAAO;QAC9C,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAAiC,CAAC;IAC7D,CAAC;IA6BD,iDAAiD,CAAS;aAanD,mBAAc,GAAG,IAAI,AAAP,CAAQ;IAG7B,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAUD,qFAAqF;IACrF,IAAc,iBAAiB;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,gBAAgB;QAClB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAuB,CAAC;QAC3G,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC;QACpE,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,kBAAkB,CAAC,CAAC;IAC1E,CAAC;IAID,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,KAAK,CAAC,GAAkB;QAC1B,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC;IAKM,cAAc;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,qBAAqB,CAAC;QAExC,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACzC,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC;QACnC,CAAC;QAED,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACzC,IAAI,CAAC,6BAA6B,EAAE,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,4BAA4B,EAAE,CAAC;QACtC,CAAC;QAED,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,IAAI,CAAC,4BAA4B,EAAE,CAAC;QACtC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAc,qBAAqB;QACjC,OAAO,IAAI,CAAC,aAAa,EAAE,qBAAqB,IAAI,QAAQ,CAAC;IAC/D,CAAC;IAES,mBAAmB,CAAC,OAAwC;QACpE,MAAM,gBAAgB,GAAG,OAAO,EAAE,gBAAgB,IAAI,IAAI,CAAC;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC;QAClC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QACD,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO,MAAM,CAAC,YAAY,CAAC;QAC7B,CAAC;QACD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAES,6BAA6B,CAAC,OAAwC;QAC9E,MAAM,gBAAgB,GAAG,OAAO,EAAE,gBAAgB,IAAI,KAAK,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC;QAElC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QAED,IAAI,MAAM,CAAC,sBAAsB,KAAK,SAAS,EAAE,CAAC;YAChD,OAAO,MAAM,CAAC,sBAAsB,CAAC;QACvC,CAAC;QAED,IAAI,MAAM,CAAC,+BAA+B,KAAK,SAAS,EAAE,CAAC;YACzD,IAAI,CAAC,IAAI,CAAC,iDAAiD,EAAE,CAAC;gBAC5D,IAAI,CAAC,iDAAiD,GAAG,IAAI,CAAC;gBAC9D,OAAO,CAAC,IAAI,CACV,qGAAqG,CACtG,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC,+BAA+B,CAAC;QAChD,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAES,sBAAsB,CAC9B,OAAgB,EAChB,eAAe,GAAG,EAAE,EACpB,MAA2B,EAC3B,OAAsC;QAEtC,MAAM,cAAc,GAAG,MAAM,IAAI,IAAI,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;QAEnG,IACE,OAAO,EAAE,cAAc,KAAK,IAAI;YAChC,CAAC,IAAI,CAAC,qBAAqB,KAAK,QAAQ,IAAI,IAAI,CAAC,qBAAqB,KAAK,MAAM,CAAC,EAClF,CAAC;YACD,IAAI,CAAC,6BAA6B,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAES,6BAA6B;QACrC,MAAM,wBAAwB,GAAG,IAAI,CAAC,2BAA2B,EAAE,CAAC;QACpE,IAAI,CAAC,wBAAwB,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACpC,wBAAwB,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC;YACzE,wBAAwB,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;YAC5E,OAAO;QACT,CAAC;QAED,wBAAwB,CAAC,WAAW,GAAG,EAAE,CAAC;QAC1C,wBAAwB,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;IAClD,CAAC;IAES,4BAA4B;QACpC,MAAM,wBAAwB,GAAG,IAAI,CAAC,2BAA2B,EAAE,CAAC;QACpE,IAAI,CAAC,wBAAwB,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,wBAAwB,CAAC,WAAW,GAAG,EAAE,CAAC;QAC1C,wBAAwB,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;IAClD,CAAC;IAES,2BAA2B;QACnC,OAAO,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,qBAAqB,CAAuB,CAAC;IACrF,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;IAEM,iBAAiB;QACtB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAEe,iBAAiB;QAC/B,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAE1B,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,aAAa,CAChB,IAAI,WAAW,CAAC,0BAA0B,EAAE;YAC1C,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,KAAK;YACjB,MAAM,EAAE;gBACN,kBAAkB,EAAE,IAAI;gBACxB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;aAC5C;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAEM,YAAY,CAAC,KAAwB,EAAE,KAAqB;QACjE,IAAI,CAAC,aAAa,CAChB,IAAI,WAAW,CAAC,0BAA0B,EAAE;YAC1C,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,KAAK;YACjB,MAAM,EAAE;gBACN,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;gBAC3C,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;gBACnD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1C;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED;QACE,KAAK,EAAE,CAAC;QAvUV;;;;;WAKG;QACH,iBAAY,GAAG,IAAI,eAAe,CAAC,IAAI,EAAE;YACvC,OAAO,EAAE,WAAW;YACpB,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;SAC/C,CAAC,CAAC;QAmCH,oBAAe,GAAG,KAAK,CAAC;QAsExB,sDAAiD,GAAG,KAAK,CAAC;QAE1D;;;;;;;WAOG;QAEO,wBAAmB,GAAiC,EAAE,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;QAWjE,aAAQ,GAAG,KAAK,CAAC;QAEjB,aAAQ,GAAG,KAAK,CAAC;QA6L3D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACzC,IAAI,CAAC,gBAAgB,CAAC,0BAA0B,EAAE,CAAC,CAAQ,EAAE,EAAE;YAC7D,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,CAAE,CAAiB,CAAC,MAAM,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC;QACnF,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACgB,YAAY,CAAC,kBAAmC,IAAS,CAAC;;AAzOtE;IADN,OAAO,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;kDACjB;AAa1B;IADT,OAAO,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;wDACoE;AAS/C;IAA7D,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,EAAE,CAAC;uDAA4B;AAE7C;IAA3C,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;6CAAkB;AAEjB;IAA3C,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;6CAAkB;AAEjC;IAA3B,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;yCAAM","sourcesContent":["import { ContextConsumer, consume, provide } from '@lit/context';\nimport { LitElement } from 'lit';\nimport { property } from 'lit/decorators.js';\n\nimport { configContext } from '../context/config.context';\nimport { interactionContext } from '../context/interaction.context';\nimport { itemContext } from '../context/item.context';\n\nimport type { PropertyValues } from 'lit';\nimport type { InteractionContext } from '../context/interaction.context';\nimport type { ConfigContext, ValidationDisplayMode } from '../context/config.context';\nimport type { ItemContext } from '../context/types/item.types';\nimport type { ValidatableInteraction } from '../lib/interaction.interface';\nimport type { ResponseVariable } from '../lib/variables';\n\n/**\n * Shared QTI interaction base. Formative correction behavior is supplied by the\n * `@qti-components/corrections` package.\n */\nexport abstract class Interaction extends LitElement implements ValidatableInteraction {\n  /**\n   * The item's variables. The interaction takes its response from here as well as publishing it:\n   * when the item's value for this response changes to something other than what the interaction\n   * shows, it adopts it. That is how `item.variables = …` reaches it, with no list of interactions\n   * kept by the item. See {@link Interaction.#adoptResponse}.\n   */\n  #itemContext = new ContextConsumer(this, {\n    context: itemContext,\n    subscribe: true,\n    callback: context => this.#followItem(context)\n  });\n\n  private get _context(): ItemContext | undefined {\n    return this.#itemContext.value;\n  }\n\n  #seenReadonly?: boolean;\n  #seenDisabled?: boolean;\n\n  /**\n   * Follows the item: its `readonly` and `disabled`, and the value it holds for this response.\n   * `readonly` and `disabled` are only taken when the item says something, so an interaction\n   * authored with either stays so inside an item that does not mention it.\n   */\n  #followItem(context: ItemContext | undefined) {\n    if (context?.readonly !== undefined && context.readonly !== this.#seenReadonly) {\n      this.#seenReadonly = context.readonly;\n      this.readonly = context.readonly;\n    }\n    if (context?.disabled !== undefined && context.disabled !== this.#seenDisabled) {\n      this.#seenDisabled = context.disabled;\n      this.disabled = context.disabled;\n    }\n    this.#adoptResponse(context);\n  }\n\n  /** The item's last value for this response, serialised, to tell a change from an unrelated update. */\n  #seenResponse?: string;\n  /**\n   * What this interaction last published or adopted, serialised. It is kept from the interaction's\n   * own `qti-interaction-response` events, which every emitter dispatches on the interaction itself,\n   * and not read back from `response`: that getter has no common shape (the drag-drop interactions\n   * return one comma-joined string where they publish an array), so it cannot be compared.\n   */\n  #lastResponse?: string;\n  #adoptScheduled = false;\n\n  /**\n   * Adopts the item's value for this response when it changed and the interaction does not already\n   * show it.\n   *\n   * Two things keep this from fighting the candidate. It reacts to the item's value for *this*\n   * response changing, not to any context update, so a score or a timer ticking never rewrites what\n   * is being typed. And when the item's value is what the interaction itself last published (which\n   * is what happens right after it publishes an answer) it does nothing, so there is no echo.\n   *\n   * The first value is only adopted when it says something: an unanswered item must not wipe a\n   * `response` attribute the author put on the interaction.\n   *\n   * Setting `response` on an interaction that has not rendered yet is what the item used to avoid\n   * by waiting, so until the first update this waits too, then looks at the latest value.\n   */\n  #adoptResponse(context: ItemContext | undefined) {\n    const id = this.responseIdentifier ?? this.getAttribute('response-identifier');\n    const variable = context?.variables?.find(v => v.type === 'response' && v.identifier === id);\n    if (!variable) return;\n\n    if (!this.hasUpdated) {\n      if (!this.#adoptScheduled) {\n        this.#adoptScheduled = true;\n        void this.updateComplete.then(() => {\n          this.#adoptScheduled = false;\n          this.#adoptResponse(this._context);\n        });\n      }\n      return;\n    }\n\n    const first = this.#seenResponse === undefined;\n    const serialised = JSON.stringify(variable.value ?? null);\n    if (serialised === this.#seenResponse) return;\n    this.#seenResponse = serialised;\n    if (first && (variable.value === null || variable.value === undefined)) return;\n    if (serialised === this.#lastResponse) return;\n    this.#lastResponse = serialised;\n    this.response = variable.value as string | string[] | null;\n  }\n\n  /**\n   * Delivery configuration, from the nearest provider — `qti-test` or `qti-item`.\n   *\n   * **Public so it can be assigned directly, which is the development-time route.** An interaction\n   * has to work standalone, and in a story or a spec there is usually no provider above it — so\n   * setting the field is all that is needed:\n   *\n   *     orderInteraction.configContext = { allowReorder: false, validationDisplayMode: 'none' };\n   *\n   * With no provider, nothing ever overwrites it. That is the whole contract, and its limit: where a\n   * provider DOES exist it re-emits on its next update and wins, because `@consume` writes this same\n   * field. There is no merging — set the value on the provider in that case.\n   *\n   * In a lit-html template, bind it as a property rather than assigning after the fact:\n   *\n   *     html`<qti-order-interaction .configContext=${{ allowReorder: false }}>…`\n   *\n   * The binding is committed on the detached template clone, before the fragment is inserted, so it\n   * is in place by `connectedCallback` — which matters for anything that reads config on connect.\n   *\n   * It was `protected`, which fooled nobody: every caller reached it anyway through an\n   * `as any` / `as { configContext?: … }` cast. Public says what was already true and removes the\n   * casts, rather than pretending at an encapsulation the type system was the only thing enforcing.\n   */\n  @consume({ context: configContext, subscribe: true })\n  public configContext: ConfigContext;\n\n  #didLogDisableAfterIfMaxChoicesReachedDeprecation = false;\n\n  /*\n   * Published to the choice elements inside this interaction — their role, and how to tell\n   * whether they are draggable. Provided here on the base rather than in a mixin so that\n   * ChoicesMixin and the drag-drop mixins can each contribute without two providers of the same\n   * context competing on one element.\n   *\n   * Reassign, never mutate: an in-place change does not notify consumers.\n   */\n  @provide({ context: interactionContext })\n  protected _interactionContext: Readonly<InteractionContext> = { choiceRole: null, draggablesSelector: null };\n\n  static formAssociated = true;\n  protected _internals: ElementInternals;\n\n  get internals(): ElementInternals {\n    return this._internals;\n  }\n\n  @property({ type: String, attribute: 'response-identifier' }) responseIdentifier: string;\n\n  @property({ reflect: true, type: Boolean }) disabled = false;\n\n  @property({ reflect: true, type: Boolean }) readonly = false;\n\n  @property({ type: String }) name;\n\n  /** Extension point used by wrappers that should not register as candidate inputs. */\n  protected get registersWithItem(): boolean {\n    return true;\n  }\n\n  get isInline(): boolean {\n    return false;\n  }\n\n  get responseVariable(): ResponseVariable | undefined {\n    if (!this._context?.variables) {\n      return undefined;\n    }\n    const responseVariables = this._context.variables.filter(v => v.type === 'response') as ResponseVariable[];\n    const responseIdentifier = this.getAttribute('response-identifier');\n    return responseVariables.find(v => v.identifier === responseIdentifier);\n  }\n\n  abstract validate(): boolean;\n\n  get value(): string | null {\n    return JSON.stringify(this.response);\n  }\n\n  set value(val: string | null) {\n    this.response = val ? JSON.parse(val) : null;\n  }\n\n  abstract get response(): string | string[] | null;\n  abstract set response(val: string | string[] | null);\n\n  public reportValidity(): boolean {\n    const isValid = this._internals.validity.valid;\n    const mode = this.validationDisplayMode;\n\n    if (mode === 'native' || mode === 'both') {\n      this._internals.reportValidity();\n    }\n\n    if (mode === 'inline' || mode === 'both') {\n      this.updateInlineValidationMessage();\n    } else {\n      this.clearInlineValidationMessage();\n    }\n\n    if (mode === 'none') {\n      this.clearInlineValidationMessage();\n    }\n\n    return isValid;\n  }\n\n  protected get validationDisplayMode(): ValidationDisplayMode {\n    return this.configContext?.validationDisplayMode ?? 'inline';\n  }\n\n  protected resolveAllowReorder(options?: { defaultWhenUnset?: boolean }): boolean {\n    const defaultWhenUnset = options?.defaultWhenUnset ?? true;\n    const config = this.configContext;\n    if (!config) {\n      return defaultWhenUnset;\n    }\n    if (config.allowReorder !== undefined) {\n      return config.allowReorder;\n    }\n    return defaultWhenUnset;\n  }\n\n  protected resolveDisableAfterMaxReached(options?: { defaultWhenUnset?: boolean }): boolean {\n    const defaultWhenUnset = options?.defaultWhenUnset ?? false;\n    const config = this.configContext;\n\n    if (!config) {\n      return defaultWhenUnset;\n    }\n\n    if (config.disableAfterMaxReached !== undefined) {\n      return config.disableAfterMaxReached;\n    }\n\n    if (config.disableAfterIfMaxChoicesReached !== undefined) {\n      if (!this.#didLogDisableAfterIfMaxChoicesReachedDeprecation) {\n        this.#didLogDisableAfterIfMaxChoicesReachedDeprecation = true;\n        console.warn(\n          '[QTI Config] `disableAfterIfMaxChoicesReached` is deprecated. Use `disableAfterMaxReached` instead.'\n        );\n      }\n      return config.disableAfterIfMaxChoicesReached;\n    }\n\n    return defaultWhenUnset;\n  }\n\n  protected setInteractionValidity(\n    isValid: boolean,\n    validityMessage = '',\n    anchor?: HTMLElement | null,\n    options?: { suppressInline?: boolean }\n  ): void {\n    const validityAnchor = anchor ?? this;\n    this._internals.setValidity(isValid ? {} : { customError: true }, validityMessage, validityAnchor);\n\n    if (\n      options?.suppressInline !== true &&\n      (this.validationDisplayMode === 'inline' || this.validationDisplayMode === 'both')\n    ) {\n      this.updateInlineValidationMessage();\n    }\n  }\n\n  protected updateInlineValidationMessage(): void {\n    const validationMessageElement = this.getValidationMessageElement();\n    if (!validationMessageElement) {\n      return;\n    }\n\n    if (!this._internals.validity.valid) {\n      validationMessageElement.textContent = this._internals.validationMessage;\n      validationMessageElement.style.setProperty('display', 'block', 'important');\n      return;\n    }\n\n    validationMessageElement.textContent = '';\n    validationMessageElement.style.display = 'none';\n  }\n\n  protected clearInlineValidationMessage(): void {\n    const validationMessageElement = this.getValidationMessageElement();\n    if (!validationMessageElement) {\n      return;\n    }\n\n    validationMessageElement.textContent = '';\n    validationMessageElement.style.display = 'none';\n  }\n\n  protected getValidationMessageElement(): HTMLElement | null {\n    return this.shadowRoot?.querySelector('#validation-message') as HTMLElement | null;\n  }\n\n  public reset(): void {\n    this.response = null;\n  }\n\n  public formResetCallback(): void {\n    this.reset();\n  }\n\n  public override connectedCallback(): void {\n    super.connectedCallback();\n\n    if (!this.registersWithItem) {\n      return;\n    }\n\n    this.dispatchEvent(\n      new CustomEvent('qti-register-interaction', {\n        bubbles: true,\n        composed: true,\n        cancelable: false,\n        detail: {\n          interactionElement: this,\n          responseIdentifier: this.responseIdentifier\n        }\n      })\n    );\n  }\n\n  public saveResponse(value: string | string[], state?: string | null): void {\n    this.dispatchEvent(\n      new CustomEvent('qti-interaction-response', {\n        bubbles: true,\n        composed: true,\n        cancelable: false,\n        detail: {\n          responseIdentifier: this.responseIdentifier,\n          response: Array.isArray(value) ? [...value] : value,\n          ...(state !== undefined ? { state } : {})\n        }\n      })\n    );\n  }\n\n  constructor() {\n    super();\n    this._internals = this.attachInternals();\n    this.addEventListener('qti-interaction-response', (e: Event) => {\n      this.#lastResponse = JSON.stringify((e as CustomEvent).detail?.response ?? null);\n    });\n  }\n\n  /**\n   * Optional lifecycle bridge for interaction subclasses that do not need changed-property data.\n   *\n   * The parameter is `PropertyValues`, matching LitElement, and NOT `PropertyValues<this>`.\n   * The polymorphic `this` narrowed the parameter per subclass, which made every interaction\n   * class structurally incompatible with `LitElement` — so `Constructor<LitElement>`, the\n   * standard constraint for a Lit mixin, rejected all of them and consumers could not wrap an\n   * interaction in a mixin without casting. `this` buys nothing in a parameter position and\n   * costs contravariant compatibility with the base class.\n   *\n   * Still optional, so subclasses that ignore the argument can override with `firstUpdated()`.\n   */\n  protected override firstUpdated(_changedProperties?: PropertyValues): void {}\n}\n"]}

package/dist/abstract/qti-expression.d.ts

@@ -1,17 +1,41 @@
 import { LitElement } from 'lit';
 import type { ItemContext } from '../context/types/item.types';
 import type { QtiContext, QtiContextType } from '../context/qti.context';
+import type { BaseType } from '../lib/expression-result';
 import type { ResponseVariable, VariableDeclaration } from '../lib/variables';
 import type { TestContext } from '../context/test.context';
+type ExpressionVariable = ResponseVariable | VariableDeclaration<QtiContextType>;
 export interface QtiExpressionBase<T> {
     calculate(): Readonly<T>;
 }
 export declare abstract class QtiExpression<T> extends LitElement implements QtiExpressionBase<T> {
+    #private;
     protected result: any;
+    /**
+     * What the last `calculate()` produced, or undefined if it has not run.
+     *
+     * This is the supported way to inspect a scoring run: process the responses,
+     * then walk the rule tree reading this off each expression. A tool that wants
+     * to visualise how a score came about gets the whole tree annotated with its
+     * values, without the components having to re-render to show them.
+     */
+    get lastResult(): Readonly<T> | undefined;
+    get lastVariables(): readonly ExpressionVariable[];
     static styles: import("lit").CSSResult;
     render(): import("lit").TemplateResult<1>;
+    protected shouldUpdate(): boolean;
     calculate(): Readonly<T>;
     protected getResult(): Readonly<T>;
+    /**
+     * The base type this operator always produces, when the QTI vocabulary fixes
+     * one regardless of its operands — `qti-divide` is a float even dividing two
+     * integers exactly, and `qti-round` is an integer whatever it rounds.
+     *
+     * Left undefined by operators whose result type follows their operands (a
+     * `qti-sum` of integers is an integer) and by those that return no number at
+     * all; the type is then read off the value.
+     */
+    get resultBaseType(): BaseType | undefined;
     protected context?: ItemContext;
     protected qtiContext?: QtiContext;
     protected _testContext?: TestContext;
@@ -24,5 +48,6 @@ export declare abstract class QtiExpression<T> extends LitElement implements Qti
      * throwing, so callers degrade gracefully.
      */
     protected resolveVariable(identifier: string): VariableDeclaration<string | string[] | null> | null;
-    getVariables: () => (ResponseVariable | VariableDeclaration<QtiContextType>)[];
+    getVariables: () => ExpressionVariable[];
 }
+export {};