@qti-components/base 2.3.0 → 2.4.1-next.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() {
@@ -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.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  }\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":"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","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

@@ -48,6 +48,13 @@ export declare abstract class QtiExpression<T> extends LitElement implements Qti
      * throwing, so callers degrade gracefully.
      */
     protected resolveVariable(identifier: string): VariableDeclaration<string | string[] | null> | null;
+    /**
+     * `ITEMREF.VAR`: a variable of an individual item session, looked up by prefixing the variable
+     * with the identifier the item ref gave the item (QTI 3 `qti-variable`), e.g. `Q01.SCORE`. An
+     * item that was never presented has no variables, which resolves to NULL. Instances of a cloned
+     * item (`Q01.2.SCORE`) are not supported: the item itself is used.
+     */
+    private resolveItemVariable;
     getVariables: () => ExpressionVariable[];
 }
 export {};

package/dist/abstract/qti-expression.js

@@ -69,10 +69,7 @@ const inferContainerBaseType = (expression, value) => {
     if (!Array.isArray(value) || value.length > 0) {
         return undefined;
     }
-    return expression
-        .lastVariables
-        .find(variable => variable?.baseType && variable.baseType !== 'record' && variable.cardinality !== 'record')
-        ?.baseType;
+    return expression.lastVariables.find(variable => variable?.baseType && variable.baseType !== 'record' && variable.cardinality !== 'record')?.baseType;
 };
 export class QtiExpression extends LitElement {
     constructor() {
@@ -293,7 +290,20 @@ export class QtiExpression extends LitElement {
     resolveVariable(identifier) {
         return (this.context?.variables.find(v => v.identifier === identifier) ??
             this._testContext?.testOutcomeVariables?.find(v => v.identifier === identifier) ??
-            null);
+            this.resolveItemVariable(identifier));
+    }
+    /**
+     * `ITEMREF.VAR`: a variable of an individual item session, looked up by prefixing the variable
+     * with the identifier the item ref gave the item (QTI 3 `qti-variable`), e.g. `Q01.SCORE`. An
+     * item that was never presented has no variables, which resolves to NULL. Instances of a cloned
+     * item (`Q01.2.SCORE`) are not supported: the item itself is used.
+     */
+    resolveItemVariable(identifier) {
+        if (!identifier?.includes('.'))
+            return null;
+        const parts = identifier.split('.');
+        const item = this._testContext?.items?.find(i => i.identifier === parts[0]);
+        return item?.variables?.find(v => v.identifier === parts[parts.length - 1]) ?? null;
     }
 }
 __decorate([

package/dist/abstract/qti-expression.js.map

@@ -1 +1 @@
-{"version":3,"file":"qti-expression.js","sourceRoot":"","sources":["../../src/abstract/qti-expression.ts"],"names":[],"mappings":"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","sourcesContent":["import { consume } from '@lit/context';\nimport { css, html, LitElement } from 'lit';\n\nimport { itemContext } from '../context/item.context';\nimport { qtiContext } from '../context/qti.context';\nimport { testContext } from '../context/test.context';\n\nimport type { ItemContext } from '../context/types/item.types';\nimport type { QtiContext, QtiContextType } from '../context/qti.context';\nimport type { Calculate } from '../lib/expression-result';\nimport type { BaseType } from '../lib/expression-result';\nimport type { ResponseVariable, VariableDeclaration } from '../lib/variables';\nimport type { TestContext } from '../context/test.context';\n\ntype ExpressionVariable = ResponseVariable | VariableDeclaration<QtiContextType>;\n\nexport interface QtiExpressionBase<T> {\n  // get assessmentItem(): QtiAssessmentItem;\n\n  // getVariables(): VariableDeclaration<number | string | (number | string)[] | null>[];\n  calculate(): Readonly<T>;\n}\n\n/**\n * Wrap whatever an expression handed back in a variable, reading the base type\n * off the value itself.\n *\n * An operator that knows its own result type says so through `resultBaseType`\n * and that wins, because the QTI vocabulary fixes it regardless of the operands\n * — `qti-divide` is a float even when it divides two integers exactly. Only\n * when nothing is declared, as for a custom operator returning whatever the\n * host computed, is the type read off the value.\n *\n * Everything used to be labelled `integer`, and since `compareSingleValues`\n * parses an integer with `parseInt`, that silently truncated:\n * `equal(divide(5, 2), 2.4)` compared 2 against 2 and answered true.\n */\nconst variableFromValue = (value: unknown, declared?: BaseType): ResponseVariable => {\n  /*\n   * A NULL result is still a value: the operand exists and is NULL. Returning\n   * nothing would drop it from the list, which both hides the NULL from\n   * `qti-is-null` and shifts every operand after it — a binary operator with a\n   * NULL first argument would silently read its second as its first. The base\n   * type is moot here, since every operator tests the value before it.\n   */\n  if (value === null || value === undefined) {\n    return {\n      identifier: '',\n      baseType: 'string',\n      value: null,\n      cardinality: 'single',\n      type: 'response'\n    } as ResponseVariable;\n  }\n\n  if (Array.isArray(value)) {\n    return {\n      identifier: '',\n      baseType: declared ?? inferBaseType(value[0]),\n      value: value.map(entry => String(entry)),\n      cardinality: 'multiple',\n      type: 'response'\n    } as ResponseVariable;\n  }\n\n  return {\n    identifier: '',\n    baseType: declared ?? inferBaseType(value),\n    value: String(value),\n    cardinality: 'single',\n    type: 'response'\n  } as ResponseVariable;\n};\n\n/** A JS value's QTI base type. A string stays text; it is not re-parsed. */\nconst inferBaseType = (value: unknown): BaseType => {\n  if (typeof value === 'number') return Number.isInteger(value) ? 'integer' : 'float';\n  if (typeof value === 'boolean') return 'boolean';\n  return 'string';\n};\n\nconst inferContainerBaseType = (expression: QtiExpression<unknown>, value: unknown): BaseType | undefined => {\n  if (!Array.isArray(value) || value.length > 0) {\n    return undefined;\n  }\n\n  return expression\n    .lastVariables\n    .find(variable => variable?.baseType && variable.baseType !== 'record' && variable.cardinality !== 'record')\n    ?.baseType as BaseType | undefined;\n};\n\nexport abstract class QtiExpression<T> extends LitElement implements QtiExpressionBase<T> {\n  /*\n   * Not `@state()`. Nothing renders it any more (see `render` below), so making\n   * it reactive only scheduled an update per `calculate()` — and response\n   * processing calls that on every expression of every rule it walks.\n   */\n  protected result: any;\n  #lastVariables: ExpressionVariable[] = [];\n\n  /**\n   * What the last `calculate()` produced, or undefined if it has not run.\n   *\n   * This is the supported way to inspect a scoring run: process the responses,\n   * then walk the rule tree reading this off each expression. A tool that wants\n   * to visualise how a score came about gets the whole tree annotated with its\n   * values, without the components having to re-render to show them.\n   */\n  public get lastResult(): Readonly<T> | undefined {\n    return this.result;\n  }\n\n  public get lastVariables(): readonly ExpressionVariable[] {\n    return this.#lastVariables;\n  }\n\n  /*\n   * Written here rather than imported from a .css file, and that is a packaging constraint rather\n   * than a style preference.\n   *\n   * The rule used to live in qti-expression.css, imported with Vite's inline-stylesheet query so\n   * DevTools could show source-file provenance. That query is a VITE specifier, and tsc copies it\n   * verbatim into dist — so the published package shipped an import only a Vite-based consumer\n   * could resolve. Every other consumer broke on it: plain Node, tsx, any non-Vite bundler. It was\n   * the single such specifier reachable from this package, and it took down QTI-Editor's schema\n   * check, which loads the components under tsx to build the real ProseMirror schema\n   * (ERR_UNKNOWN_FILE_EXTENSION on a file that has nothing to do with schemas).\n   *\n   * A `build:assets` step used to copy the .css into dist beside it. That went too — it existed\n   * only to give the unresolvable import something to point at.\n   *\n   * Two lines of CSS are not worth a dist that only one bundler can consume. If this ever grows\n   * into a real stylesheet, give it a `.styles.ts` exporting a `css` template — the house pattern\n   * everywhere else in this repo — rather than reintroducing a bundler-specific import.\n   *\n   * The element renders a debug <pre> of its computed result plus a <slot>; hiding the slot is all\n   * the styling it has ever had.\n   */\n  static override styles = css`\n    slot {\n      display: none;\n    }\n  `;\n\n  /*\n   * Just the slot. This used to render `JSON.stringify(this.result, null, 2)`\n   * into a <pre> beside it — a development aid that nobody could see, because\n   * expressions live inside `qti-response-processing`, which is `display: none`.\n   * It cost a full serialisation of the result on every render.\n   */\n  override render() {\n    return html`<slot></slot>`;\n  }\n\n  /*\n   * Render once, then never again: the template above is constant, so every\n   * later update is pure overhead.\n   *\n   * It is not the `@state()` decorators that drive those updates — `@consume`\n   * subscribes through `ContextConsumer`, which calls `host.requestUpdate()`\n   * itself on every context change, \"in case this value is used in a template\".\n   * Here it is not. An item with 30 response-processing rules holds ~180\n   * expression elements and the test context changes on every keystroke, so\n   * that was ~180 renders per keystroke producing identical output.\n   *\n   * The subscriptions stay, because `calculate()` reads the current values when\n   * a rule invokes it. Only the rendering stops.\n   */\n  protected override shouldUpdate(): boolean {\n    return !this.hasUpdated;\n  }\n\n  public calculate(): Readonly<T> {\n    this.result = this.getResult();\n    return this.result;\n  }\n\n  protected getResult(): Readonly<T> {\n    throw new Error('Not implemented');\n  }\n\n  /**\n   * The base type this operator always produces, when the QTI vocabulary fixes\n   * one regardless of its operands — `qti-divide` is a float even dividing two\n   * integers exactly, and `qti-round` is an integer whatever it rounds.\n   *\n   * Left undefined by operators whose result type follows their operands (a\n   * `qti-sum` of integers is an integer) and by those that return no number at\n   * all; the type is then read off the value.\n   */\n  public get resultBaseType(): BaseType | undefined {\n    return undefined;\n  }\n\n  /*\n   * Subscribed but deliberately NOT `@state()`.\n   *\n   * An expression is pull-based: nothing reads these until a rule calls\n   * `calculate()`, which reads whatever the consumer has by then. Marking them\n   * reactive made every context change schedule a render of every expression\n   * element in the document — an item with 30 response-processing rules holds\n   * ~180 of them, and the test context changes on every keystroke. The\n   * subscription still keeps the properties current; it just no longer asks\n   * for a render nothing depends on.\n   */\n  @consume({ context: itemContext, subscribe: true })\n  protected context?: ItemContext;\n\n  @consume({ context: qtiContext, subscribe: true })\n  protected qtiContext?: QtiContext;\n\n  @consume({ context: testContext, subscribe: true })\n  protected _testContext?: TestContext;\n\n  /**\n   * Resolve a declared variable from the closest available scope: item-level\n   * first, then the test-level outcome variables. So an expression used in an\n   * assessmentTest's outcome processing can reference a test-level outcome\n   * (e.g. a total set earlier in the same run) — which the QTI variable\n   * expression is specified to do. Returns null when unresolved rather than\n   * throwing, so callers degrade gracefully.\n   */\n  protected resolveVariable(identifier: string): VariableDeclaration<string | string[] | null> | null {\n    return (\n      this.context?.variables.find(v => v.identifier === identifier) ??\n      this._testContext?.testOutcomeVariables?.find(v => v.identifier === identifier) ??\n      null\n    );\n  }\n\n  getVariables = (): ExpressionVariable[] => {\n    // FIXME: if this itself is multiple, this will never enter the qti-multiple switch\n    // See this example here: https://github.com/1EdTech/qti-examples/blob/master/qtiv3-examples/packaging/items/Example05-feedbackBlock-adaptive.xml\n\n    const variables = Array.from(this.children)\n      .map((e: Element) => {\n        switch (e.tagName.toLowerCase()) {\n          case 'qti-base-value': {\n            return {\n              baseType: e.getAttribute('base-type'),\n              value: e.textContent.trim(),\n              cardinality: 'single'\n            } as ResponseVariable;\n          }\n          case 'qti-variable': {\n            const identifier = e.getAttribute('identifier') || '';\n\n            // Special handling for QTI_CONTEXT\n            if (identifier === 'QTI_CONTEXT') {\n              if (!this.qtiContext?.QTI_CONTEXT) {\n                console.warn('QTI_CONTEXT not available');\n                return {\n                  identifier: 'QTI_CONTEXT',\n                  baseType: 'record',\n                  value: this.qtiContext.QTI_CONTEXT,\n                  cardinality: 'record',\n                  type: 'context'\n                } as VariableDeclaration<QtiContextType>;\n              }\n              return {\n                identifier: 'QTI_CONTEXT',\n                baseType: 'record',\n                value: this.qtiContext.QTI_CONTEXT,\n                cardinality: 'record',\n                type: 'context'\n              } as VariableDeclaration<QtiContextType>;\n            }\n\n            return this.resolveVariable(identifier);\n          }\n          case 'qti-multiple': {\n            const multiple = e as QtiExpression<ResponseVariable[]>;\n\n            const values = multiple.getResult();\n            if (values?.length > 0) {\n              return {\n                identifier: '',\n                baseType: values[0].baseType,\n                value: values.map(v => v.value),\n                cardinality: 'multiple',\n                type: 'response'\n              } as ResponseVariable;\n            }\n            return null;\n          }\n          case 'qti-ordered': {\n            const multiple = e as QtiExpression<ResponseVariable[]>;\n            const values = multiple.getResult();\n            if (values?.length > 0) {\n              return {\n                identifier: '',\n                baseType: values[0].baseType,\n                value: values.map(v => v.value),\n                cardinality: 'ordered',\n                type: 'response'\n              } as ResponseVariable;\n            }\n            return null;\n          }\n          case 'qti-repeat': {\n            const repeat = e as QtiExpression<ResponseVariable[]>;\n            const values = repeat.getResult();\n            if (values?.length > 0) {\n              return values;\n            }\n            return null;\n          }\n          case 'qti-custom-operator': {\n            // Not a QtiExpression — it has `calculate` but no `getResult`, so\n            // the default branch below throws on it and the surrounding\n            // expression is handed nothing.\n            return variableFromValue((e as unknown as Calculate).calculate?.());\n          }\n          case 'qti-correct': {\n            const identifier = e.getAttribute('identifier') || '';\n            const responseVariable = this.context?.variables?.find(v => v.identifier === identifier) as\n              | ResponseVariable\n              | undefined;\n\n            // A `qti-correct` naming a response that is not declared — a typo,\n            // or an expression evaluated before the declaration registered —\n            // used to dereference the null this deliberately produced and take\n            // down the whole processing run. It is an unresolved variable, so\n            // it is NULL.\n            if (!responseVariable) {\n              console.warn(`qti-correct: no response declaration for \"${identifier}\"`);\n              return variableFromValue(null);\n            }\n\n            return {\n              baseType: responseVariable.baseType,\n              value: responseVariable.correctResponse,\n              cardinality: responseVariable.cardinality\n            } as ResponseVariable;\n          }\n          default: {\n            // Every operator without a case of its own lands here.\n            try {\n              const expression = e as QtiExpression<unknown>;\n              const result = expression.getResult();\n              return variableFromValue(result, expression.resultBaseType ?? inferContainerBaseType(expression, result));\n            } catch (error) {\n              console.warn(`getVariables: could not read a value from <${e.tagName.toLowerCase()}>`, error);\n            }\n            return null;\n          }\n        }\n      })\n      .flatMap(v => (Array.isArray(v) ? v : [v]))\n      .filter((v): v is ExpressionVariable => v !== null);\n\n    this.#lastVariables = variables;\n    return variables;\n  };\n}\n"]}
+{"version":3,"file":"qti-expression.js","sourceRoot":"","sources":["../../src/abstract/qti-expression.ts"],"names":[],"mappings":"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","sourcesContent":["import { consume } from '@lit/context';\nimport { css, html, LitElement } from 'lit';\n\nimport { itemContext } from '../context/item.context';\nimport { qtiContext } from '../context/qti.context';\nimport { testContext } from '../context/test.context';\n\nimport type { ItemContext } from '../context/types/item.types';\nimport type { QtiContext, QtiContextType } from '../context/qti.context';\nimport type { Calculate } from '../lib/expression-result';\nimport type { BaseType } from '../lib/expression-result';\nimport type { ResponseVariable, VariableDeclaration } from '../lib/variables';\nimport type { TestContext } from '../context/test.context';\n\ntype ExpressionVariable = ResponseVariable | VariableDeclaration<QtiContextType>;\n\nexport interface QtiExpressionBase<T> {\n  // get assessmentItem(): QtiAssessmentItem;\n\n  // getVariables(): VariableDeclaration<number | string | (number | string)[] | null>[];\n  calculate(): Readonly<T>;\n}\n\n/**\n * Wrap whatever an expression handed back in a variable, reading the base type\n * off the value itself.\n *\n * An operator that knows its own result type says so through `resultBaseType`\n * and that wins, because the QTI vocabulary fixes it regardless of the operands\n * — `qti-divide` is a float even when it divides two integers exactly. Only\n * when nothing is declared, as for a custom operator returning whatever the\n * host computed, is the type read off the value.\n *\n * Everything used to be labelled `integer`, and since `compareSingleValues`\n * parses an integer with `parseInt`, that silently truncated:\n * `equal(divide(5, 2), 2.4)` compared 2 against 2 and answered true.\n */\nconst variableFromValue = (value: unknown, declared?: BaseType): ResponseVariable => {\n  /*\n   * A NULL result is still a value: the operand exists and is NULL. Returning\n   * nothing would drop it from the list, which both hides the NULL from\n   * `qti-is-null` and shifts every operand after it — a binary operator with a\n   * NULL first argument would silently read its second as its first. The base\n   * type is moot here, since every operator tests the value before it.\n   */\n  if (value === null || value === undefined) {\n    return {\n      identifier: '',\n      baseType: 'string',\n      value: null,\n      cardinality: 'single',\n      type: 'response'\n    } as ResponseVariable;\n  }\n\n  if (Array.isArray(value)) {\n    return {\n      identifier: '',\n      baseType: declared ?? inferBaseType(value[0]),\n      value: value.map(entry => String(entry)),\n      cardinality: 'multiple',\n      type: 'response'\n    } as ResponseVariable;\n  }\n\n  return {\n    identifier: '',\n    baseType: declared ?? inferBaseType(value),\n    value: String(value),\n    cardinality: 'single',\n    type: 'response'\n  } as ResponseVariable;\n};\n\n/** A JS value's QTI base type. A string stays text; it is not re-parsed. */\nconst inferBaseType = (value: unknown): BaseType => {\n  if (typeof value === 'number') return Number.isInteger(value) ? 'integer' : 'float';\n  if (typeof value === 'boolean') return 'boolean';\n  return 'string';\n};\n\nconst inferContainerBaseType = (expression: QtiExpression<unknown>, value: unknown): BaseType | undefined => {\n  if (!Array.isArray(value) || value.length > 0) {\n    return undefined;\n  }\n\n  return expression.lastVariables.find(\n    variable => variable?.baseType && variable.baseType !== 'record' && variable.cardinality !== 'record'\n  )?.baseType as BaseType | undefined;\n};\n\nexport abstract class QtiExpression<T> extends LitElement implements QtiExpressionBase<T> {\n  /*\n   * Not `@state()`. Nothing renders it any more (see `render` below), so making\n   * it reactive only scheduled an update per `calculate()` — and response\n   * processing calls that on every expression of every rule it walks.\n   */\n  protected result: any;\n  #lastVariables: ExpressionVariable[] = [];\n\n  /**\n   * What the last `calculate()` produced, or undefined if it has not run.\n   *\n   * This is the supported way to inspect a scoring run: process the responses,\n   * then walk the rule tree reading this off each expression. A tool that wants\n   * to visualise how a score came about gets the whole tree annotated with its\n   * values, without the components having to re-render to show them.\n   */\n  public get lastResult(): Readonly<T> | undefined {\n    return this.result;\n  }\n\n  public get lastVariables(): readonly ExpressionVariable[] {\n    return this.#lastVariables;\n  }\n\n  /*\n   * Written here rather than imported from a .css file, and that is a packaging constraint rather\n   * than a style preference.\n   *\n   * The rule used to live in qti-expression.css, imported with Vite's inline-stylesheet query so\n   * DevTools could show source-file provenance. That query is a VITE specifier, and tsc copies it\n   * verbatim into dist — so the published package shipped an import only a Vite-based consumer\n   * could resolve. Every other consumer broke on it: plain Node, tsx, any non-Vite bundler. It was\n   * the single such specifier reachable from this package, and it took down QTI-Editor's schema\n   * check, which loads the components under tsx to build the real ProseMirror schema\n   * (ERR_UNKNOWN_FILE_EXTENSION on a file that has nothing to do with schemas).\n   *\n   * A `build:assets` step used to copy the .css into dist beside it. That went too — it existed\n   * only to give the unresolvable import something to point at.\n   *\n   * Two lines of CSS are not worth a dist that only one bundler can consume. If this ever grows\n   * into a real stylesheet, give it a `.styles.ts` exporting a `css` template — the house pattern\n   * everywhere else in this repo — rather than reintroducing a bundler-specific import.\n   *\n   * The element renders a debug <pre> of its computed result plus a <slot>; hiding the slot is all\n   * the styling it has ever had.\n   */\n  static override styles = css`\n    slot {\n      display: none;\n    }\n  `;\n\n  /*\n   * Just the slot. This used to render `JSON.stringify(this.result, null, 2)`\n   * into a <pre> beside it — a development aid that nobody could see, because\n   * expressions live inside `qti-response-processing`, which is `display: none`.\n   * It cost a full serialisation of the result on every render.\n   */\n  override render() {\n    return html`<slot></slot>`;\n  }\n\n  /*\n   * Render once, then never again: the template above is constant, so every\n   * later update is pure overhead.\n   *\n   * It is not the `@state()` decorators that drive those updates — `@consume`\n   * subscribes through `ContextConsumer`, which calls `host.requestUpdate()`\n   * itself on every context change, \"in case this value is used in a template\".\n   * Here it is not. An item with 30 response-processing rules holds ~180\n   * expression elements and the test context changes on every keystroke, so\n   * that was ~180 renders per keystroke producing identical output.\n   *\n   * The subscriptions stay, because `calculate()` reads the current values when\n   * a rule invokes it. Only the rendering stops.\n   */\n  protected override shouldUpdate(): boolean {\n    return !this.hasUpdated;\n  }\n\n  public calculate(): Readonly<T> {\n    this.result = this.getResult();\n    return this.result;\n  }\n\n  protected getResult(): Readonly<T> {\n    throw new Error('Not implemented');\n  }\n\n  /**\n   * The base type this operator always produces, when the QTI vocabulary fixes\n   * one regardless of its operands — `qti-divide` is a float even dividing two\n   * integers exactly, and `qti-round` is an integer whatever it rounds.\n   *\n   * Left undefined by operators whose result type follows their operands (a\n   * `qti-sum` of integers is an integer) and by those that return no number at\n   * all; the type is then read off the value.\n   */\n  public get resultBaseType(): BaseType | undefined {\n    return undefined;\n  }\n\n  /*\n   * Subscribed but deliberately NOT `@state()`.\n   *\n   * An expression is pull-based: nothing reads these until a rule calls\n   * `calculate()`, which reads whatever the consumer has by then. Marking them\n   * reactive made every context change schedule a render of every expression\n   * element in the document — an item with 30 response-processing rules holds\n   * ~180 of them, and the test context changes on every keystroke. The\n   * subscription still keeps the properties current; it just no longer asks\n   * for a render nothing depends on.\n   */\n  @consume({ context: itemContext, subscribe: true })\n  protected context?: ItemContext;\n\n  @consume({ context: qtiContext, subscribe: true })\n  protected qtiContext?: QtiContext;\n\n  @consume({ context: testContext, subscribe: true })\n  protected _testContext?: TestContext;\n\n  /**\n   * Resolve a declared variable from the closest available scope: item-level\n   * first, then the test-level outcome variables. So an expression used in an\n   * assessmentTest's outcome processing can reference a test-level outcome\n   * (e.g. a total set earlier in the same run) — which the QTI variable\n   * expression is specified to do. Returns null when unresolved rather than\n   * throwing, so callers degrade gracefully.\n   */\n  protected resolveVariable(identifier: string): VariableDeclaration<string | string[] | null> | null {\n    return (\n      this.context?.variables.find(v => v.identifier === identifier) ??\n      this._testContext?.testOutcomeVariables?.find(v => v.identifier === identifier) ??\n      this.resolveItemVariable(identifier)\n    );\n  }\n\n  /**\n   * `ITEMREF.VAR`: a variable of an individual item session, looked up by prefixing the variable\n   * with the identifier the item ref gave the item (QTI 3 `qti-variable`), e.g. `Q01.SCORE`. An\n   * item that was never presented has no variables, which resolves to NULL. Instances of a cloned\n   * item (`Q01.2.SCORE`) are not supported: the item itself is used.\n   */\n  private resolveItemVariable(identifier: string): VariableDeclaration<string | string[] | null> | null {\n    if (!identifier?.includes('.')) return null;\n    const parts = identifier.split('.');\n    const item = this._testContext?.items?.find(i => i.identifier === parts[0]);\n    return item?.variables?.find(v => v.identifier === parts[parts.length - 1]) ?? null;\n  }\n\n  getVariables = (): ExpressionVariable[] => {\n    // FIXME: if this itself is multiple, this will never enter the qti-multiple switch\n    // See this example here: https://github.com/1EdTech/qti-examples/blob/master/qtiv3-examples/packaging/items/Example05-feedbackBlock-adaptive.xml\n\n    const variables = Array.from(this.children)\n      .map((e: Element) => {\n        switch (e.tagName.toLowerCase()) {\n          case 'qti-base-value': {\n            return {\n              baseType: e.getAttribute('base-type'),\n              value: e.textContent.trim(),\n              cardinality: 'single'\n            } as ResponseVariable;\n          }\n          case 'qti-variable': {\n            const identifier = e.getAttribute('identifier') || '';\n\n            // Special handling for QTI_CONTEXT\n            if (identifier === 'QTI_CONTEXT') {\n              if (!this.qtiContext?.QTI_CONTEXT) {\n                console.warn('QTI_CONTEXT not available');\n                return {\n                  identifier: 'QTI_CONTEXT',\n                  baseType: 'record',\n                  value: this.qtiContext.QTI_CONTEXT,\n                  cardinality: 'record',\n                  type: 'context'\n                } as VariableDeclaration<QtiContextType>;\n              }\n              return {\n                identifier: 'QTI_CONTEXT',\n                baseType: 'record',\n                value: this.qtiContext.QTI_CONTEXT,\n                cardinality: 'record',\n                type: 'context'\n              } as VariableDeclaration<QtiContextType>;\n            }\n\n            return this.resolveVariable(identifier);\n          }\n          case 'qti-multiple': {\n            const multiple = e as QtiExpression<ResponseVariable[]>;\n\n            const values = multiple.getResult();\n            if (values?.length > 0) {\n              return {\n                identifier: '',\n                baseType: values[0].baseType,\n                value: values.map(v => v.value),\n                cardinality: 'multiple',\n                type: 'response'\n              } as ResponseVariable;\n            }\n            return null;\n          }\n          case 'qti-ordered': {\n            const multiple = e as QtiExpression<ResponseVariable[]>;\n            const values = multiple.getResult();\n            if (values?.length > 0) {\n              return {\n                identifier: '',\n                baseType: values[0].baseType,\n                value: values.map(v => v.value),\n                cardinality: 'ordered',\n                type: 'response'\n              } as ResponseVariable;\n            }\n            return null;\n          }\n          case 'qti-repeat': {\n            const repeat = e as QtiExpression<ResponseVariable[]>;\n            const values = repeat.getResult();\n            if (values?.length > 0) {\n              return values;\n            }\n            return null;\n          }\n          case 'qti-custom-operator': {\n            // Not a QtiExpression — it has `calculate` but no `getResult`, so\n            // the default branch below throws on it and the surrounding\n            // expression is handed nothing.\n            return variableFromValue((e as unknown as Calculate).calculate?.());\n          }\n          case 'qti-correct': {\n            const identifier = e.getAttribute('identifier') || '';\n            const responseVariable = this.context?.variables?.find(v => v.identifier === identifier) as\n              | ResponseVariable\n              | undefined;\n\n            // A `qti-correct` naming a response that is not declared — a typo,\n            // or an expression evaluated before the declaration registered —\n            // used to dereference the null this deliberately produced and take\n            // down the whole processing run. It is an unresolved variable, so\n            // it is NULL.\n            if (!responseVariable) {\n              console.warn(`qti-correct: no response declaration for \"${identifier}\"`);\n              return variableFromValue(null);\n            }\n\n            return {\n              baseType: responseVariable.baseType,\n              value: responseVariable.correctResponse,\n              cardinality: responseVariable.cardinality\n            } as ResponseVariable;\n          }\n          default: {\n            // Every operator without a case of its own lands here.\n            try {\n              const expression = e as QtiExpression<unknown>;\n              const result = expression.getResult();\n              return variableFromValue(result, expression.resultBaseType ?? inferContainerBaseType(expression, result));\n            } catch (error) {\n              console.warn(`getVariables: could not read a value from <${e.tagName.toLowerCase()}>`, error);\n            }\n            return null;\n          }\n        }\n      })\n      .flatMap(v => (Array.isArray(v) ? v : [v]))\n      .filter((v): v is ExpressionVariable => v !== null);\n\n    this.#lastVariables = variables;\n    return variables;\n  };\n}\n"]}

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

@@ -5,8 +5,7 @@ export declare abstract class QtiFeedback extends LitElement {
     outcomeIdentifier: string;
     protected identifier: string;
     showStatus: string;
-    private _context?;
+    private get _context();
     private _computedContext?;
-    connectedCallback(): void;
     checkShowFeedback(outcomeIdentifier: string): void;
 }

package/dist/abstract/qti-feedback.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 } from '@lit/context';
+import { ContextConsumer, consume } from '@lit/context';
 import { LitElement } from 'lit';
 import { property, state } from 'lit/decorators.js';
 import { computedContext } from '../context/computed.context';
@@ -14,14 +14,45 @@ export class QtiFeedback extends LitElement {
     constructor() {
         super(...arguments);
         this.showHide = 'show';
+        /**
+         * The item's variables. Feedback follows them itself: every time the item publishes a new context
+         * this decides, synchronously, whether its own outcome now calls for showing it, so the item has
+         * no list of feedback elements to push to. Synchronous matters. A host that sets an outcome
+         * reads `showStatus` straight after, with no await in between.
+         */
+        this.#itemContext = new ContextConsumer(this, {
+            context: itemContext,
+            subscribe: true,
+            callback: context => this.#followItem(context)
+        });
     }
-    connectedCallback() {
-        super.connectedCallback();
-        this.dispatchEvent(new CustomEvent('qti-register-feedback', {
-            bubbles: true,
-            composed: true,
-            detail: this
-        }));
+    /**
+     * The item's variables. Feedback follows them itself: every time the item publishes a new context
+     * this decides, synchronously, whether its own outcome now calls for showing it, so the item has
+     * no list of feedback elements to push to. Synchronous matters. A host that sets an outcome
+     * reads `showStatus` straight after, with no await in between.
+     */
+    #itemContext;
+    get _context() {
+        return this.#itemContext.value;
+    }
+    /** What the last context carried that decides this feedback, to tell a relevant update from noise. */
+    #seen;
+    /**
+     * Re-decide when this feedback's outcome changed, or once an attempt has been made. Before the
+     * first attempt an unchanged outcome says nothing yet: a `hide` feedback would otherwise switch
+     * on for an item nobody has answered.
+     */
+    #followItem(context) {
+        const variables = context?.variables;
+        if (!variables || !this.outcomeIdentifier)
+            return;
+        const outcome = JSON.stringify(variables.find(v => v.identifier === this.outcomeIdentifier)?.value ?? null);
+        const numAttempts = Number(variables.find(v => v.identifier === 'numAttempts')?.value) || 0;
+        const relevant = this.#seen === undefined ? numAttempts > 0 : this.#seen !== outcome || numAttempts > 0;
+        this.#seen = outcome;
+        if (relevant)
+            this.checkShowFeedback(this.outcomeIdentifier);
     }
     checkShowFeedback(outcomeIdentifier) {
         const outcomeVariable = this._context.variables.find(v => v.identifier === outcomeIdentifier) || null;
@@ -95,10 +126,6 @@ __decorate([
 __decorate([
     property({ type: String, attribute: false })
 ], QtiFeedback.prototype, "showStatus", void 0);
-__decorate([
-    consume({ context: itemContext, subscribe: true }),
-    state()
-], QtiFeedback.prototype, "_context", void 0);
 __decorate([
     consume({ context: computedContext, subscribe: true }),
     state()

package/dist/abstract/qti-feedback.js.map

@@ -1 +1 @@
-{"version":3,"file":"qti-feedback.js","sourceRoot":"","sources":["../../src/abstract/qti-feedback.ts"],"names":[],"mappings":"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","sourcesContent":["import { consume } from '@lit/context';\nimport { LitElement } from 'lit';\nimport { property, state } from 'lit/decorators.js';\n\nimport { computedContext } from '../context/computed.context';\nimport { itemContext } from '../context/item.context';\nimport { IsNullOrUndefined } from '../utils/utils';\n\nimport type { ComputedContext } from '../context/types/computed.types';\nimport type { ItemContext } from '../context/types/item.types';\n\nexport abstract class QtiFeedback extends LitElement {\n  @property({ type: String, attribute: 'show-hide' })\n  protected showHide: 'show' | 'hide' = 'show';\n\n  @property({ type: String, attribute: 'outcome-identifier' })\n  public outcomeIdentifier: string;\n\n  @property({ type: String })\n  protected identifier: string;\n\n  @property({ type: String, attribute: false })\n  public showStatus: string;\n\n  @consume({ context: itemContext, subscribe: true })\n  @state()\n  private _context?: ItemContext;\n\n  @consume({ context: computedContext, subscribe: true })\n  @state()\n  private _computedContext?: ComputedContext;\n\n  public override connectedCallback() {\n    super.connectedCallback();\n    this.dispatchEvent(\n      new CustomEvent<QtiFeedback>('qti-register-feedback', {\n        bubbles: true,\n        composed: true,\n        detail: this\n      })\n    );\n  }\n\n  public checkShowFeedback(outcomeIdentifier: string) {\n    const outcomeVariable = this._context.variables.find(v => v.identifier === outcomeIdentifier) || null;\n    if (this.outcomeIdentifier !== outcomeIdentifier || !outcomeVariable) return;\n    let isFound = false;\n    if (Array.isArray(outcomeVariable.value)) {\n      isFound = outcomeVariable.value.includes(this.identifier);\n    } else {\n      isFound =\n        (!IsNullOrUndefined(this.identifier) &&\n          !IsNullOrUndefined(outcomeVariable?.value) &&\n          this.identifier === outcomeVariable.value) ||\n        false;\n    }\n\n    this.#showFeedback(isFound);\n  }\n\n  #showFeedback(value: boolean) {\n    if (!this.#sessionControlAllowsFeedback()) {\n      this.showStatus = 'off';\n      return;\n    }\n    this.showStatus = (value && this.showHide === 'show') || (!value && this.showHide === 'hide') ? 'on' : 'off';\n  }\n\n  /**\n   * The QTI `show-feedback` constraint governs exactly one state: after the end of\n   * the last attempt. Up to that point the spec requires any applicable feedback to\n   * be shown — \"a value of max-attempts greater than 1, by definition, indicates\n   * that any applicable feedback must be shown\" — and only \"once the maximum number\n   * of allowed attempts have been used (or for adaptive items, completionStatus has\n   * been set to completed)\" does `show-feedback` decide.\n   *\n   * This only ever forces feedback off, so `show-feedback` being true settles it:\n   * there is no state in which the constraint hides feedback. It defaults to\n   * false, and an absent value suppresses once the attempts are gone.\n   *\n   * That leaves one question — is the item out of attempts? — and the two item\n   * kinds answer it from different variables, so each reads only its own.\n   */\n  #sessionControlAllowsFeedback(): boolean {\n    if (!this._computedContext) return true;\n    const activeItem = this._computedContext.testParts\n      ?.find(tp => tp.active)\n      ?.sections.flatMap(s => s.items)\n      .find(i => i.active);\n    if (!activeItem || activeItem.showFeedback) return true;\n\n    // Adaptive items ignore max-attempts: \"the number of attempts is limited by\n    // the value of the completionStatus built-in outcome variable\".\n    if (activeItem.adaptive) return activeItem.completionStatus !== 'completed';\n\n    // `max-attempts=\"0\"` is \"no limit\", so the last attempt never arrives.\n    const maxAttempts = activeItem.maxAttempts ?? 1;\n    if (maxAttempts <= 0) return true;\n\n    const numAttempts = Number(this._context?.variables?.find(v => v.identifier === 'numAttempts')?.value) || 0;\n    return numAttempts < maxAttempts;\n  }\n}\n"]}
+{"version":3,"file":"qti-feedback.js","sourceRoot":"","sources":["../../src/abstract/qti-feedback.ts"],"names":[],"mappings":"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","sourcesContent":["import { ContextConsumer, consume } from '@lit/context';\nimport { LitElement } from 'lit';\nimport { property, state } from 'lit/decorators.js';\n\nimport { computedContext } from '../context/computed.context';\nimport { itemContext } from '../context/item.context';\nimport { IsNullOrUndefined } from '../utils/utils';\n\nimport type { ComputedContext } from '../context/types/computed.types';\nimport type { ItemContext } from '../context/types/item.types';\n\nexport abstract class QtiFeedback extends LitElement {\n  @property({ type: String, attribute: 'show-hide' })\n  protected showHide: 'show' | 'hide' = 'show';\n\n  @property({ type: String, attribute: 'outcome-identifier' })\n  public outcomeIdentifier: string;\n\n  @property({ type: String })\n  protected identifier: string;\n\n  @property({ type: String, attribute: false })\n  public showStatus: string;\n\n  /**\n   * The item's variables. Feedback follows them itself: every time the item publishes a new context\n   * this decides, synchronously, whether its own outcome now calls for showing it, so the item has\n   * no list of feedback elements to push to. Synchronous matters. A host that sets an outcome\n   * reads `showStatus` straight after, with no await in between.\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  /** What the last context carried that decides this feedback, to tell a relevant update from noise. */\n  #seen?: string;\n\n  @consume({ context: computedContext, subscribe: true })\n  @state()\n  private _computedContext?: ComputedContext;\n\n  /**\n   * Re-decide when this feedback's outcome changed, or once an attempt has been made. Before the\n   * first attempt an unchanged outcome says nothing yet: a `hide` feedback would otherwise switch\n   * on for an item nobody has answered.\n   */\n  #followItem(context: ItemContext | undefined) {\n    const variables = context?.variables;\n    if (!variables || !this.outcomeIdentifier) return;\n    const outcome = JSON.stringify(variables.find(v => v.identifier === this.outcomeIdentifier)?.value ?? null);\n    const numAttempts = Number(variables.find(v => v.identifier === 'numAttempts')?.value) || 0;\n    const relevant = this.#seen === undefined ? numAttempts > 0 : this.#seen !== outcome || numAttempts > 0;\n    this.#seen = outcome;\n    if (relevant) this.checkShowFeedback(this.outcomeIdentifier);\n  }\n\n  public checkShowFeedback(outcomeIdentifier: string) {\n    const outcomeVariable = this._context.variables.find(v => v.identifier === outcomeIdentifier) || null;\n    if (this.outcomeIdentifier !== outcomeIdentifier || !outcomeVariable) return;\n    let isFound = false;\n    if (Array.isArray(outcomeVariable.value)) {\n      isFound = outcomeVariable.value.includes(this.identifier);\n    } else {\n      isFound =\n        (!IsNullOrUndefined(this.identifier) &&\n          !IsNullOrUndefined(outcomeVariable?.value) &&\n          this.identifier === outcomeVariable.value) ||\n        false;\n    }\n\n    this.#showFeedback(isFound);\n  }\n\n  #showFeedback(value: boolean) {\n    if (!this.#sessionControlAllowsFeedback()) {\n      this.showStatus = 'off';\n      return;\n    }\n    this.showStatus = (value && this.showHide === 'show') || (!value && this.showHide === 'hide') ? 'on' : 'off';\n  }\n\n  /**\n   * The QTI `show-feedback` constraint governs exactly one state: after the end of\n   * the last attempt. Up to that point the spec requires any applicable feedback to\n   * be shown — \"a value of max-attempts greater than 1, by definition, indicates\n   * that any applicable feedback must be shown\" — and only \"once the maximum number\n   * of allowed attempts have been used (or for adaptive items, completionStatus has\n   * been set to completed)\" does `show-feedback` decide.\n   *\n   * This only ever forces feedback off, so `show-feedback` being true settles it:\n   * there is no state in which the constraint hides feedback. It defaults to\n   * false, and an absent value suppresses once the attempts are gone.\n   *\n   * That leaves one question — is the item out of attempts? — and the two item\n   * kinds answer it from different variables, so each reads only its own.\n   */\n  #sessionControlAllowsFeedback(): boolean {\n    if (!this._computedContext) return true;\n    const activeItem = this._computedContext.testParts\n      ?.find(tp => tp.active)\n      ?.sections.flatMap(s => s.items)\n      .find(i => i.active);\n    if (!activeItem || activeItem.showFeedback) return true;\n\n    // Adaptive items ignore max-attempts: \"the number of attempts is limited by\n    // the value of the completionStatus built-in outcome variable\".\n    if (activeItem.adaptive) return activeItem.completionStatus !== 'completed';\n\n    // `max-attempts=\"0\"` is \"no limit\", so the last attempt never arrives.\n    const maxAttempts = activeItem.maxAttempts ?? 1;\n    if (maxAttempts <= 0) return true;\n\n    const numAttempts = Number(this._context?.variables?.find(v => v.identifier === 'numAttempts')?.value) || 0;\n    return numAttempts < maxAttempts;\n  }\n}\n"]}

package/dist/context/context-root.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Catches context requests nobody answered and asks again when a provider connects, so a component
+ * that upgrades before the element providing its context still gets the value.
+ *
+ * It has to live on the document and not on one of our elements: the case it exists for is the
+ * providing element not having upgraded yet, so there is nothing of ours to attach it to. It holds
+ * only requests that subscribe, which every `@consume` in this library does, and it holds them
+ * weakly, so nothing is kept alive that would not be anyway.
+ *
+ * Once per page, however many copies of the package the page ends up with.
+ */
+export declare const installContextRoot: () => void;

package/dist/context/context-root.js

@@ -0,0 +1,24 @@
+import { ContextRoot } from '@lit/context';
+const INSTALLED = Symbol.for('qti-components.context-root');
+/**
+ * Catches context requests nobody answered and asks again when a provider connects, so a component
+ * that upgrades before the element providing its context still gets the value.
+ *
+ * It has to live on the document and not on one of our elements: the case it exists for is the
+ * providing element not having upgraded yet, so there is nothing of ours to attach it to. It holds
+ * only requests that subscribe, which every `@consume` in this library does, and it holds them
+ * weakly, so nothing is kept alive that would not be anyway.
+ *
+ * Once per page, however many copies of the package the page ends up with.
+ */
+export const installContextRoot = () => {
+    if (typeof document === 'undefined')
+        return;
+    const page = globalThis;
+    if (page[INSTALLED])
+        return;
+    page[INSTALLED] = new ContextRoot();
+    page[INSTALLED].attach(document.documentElement);
+};
+installContextRoot();
+//# sourceMappingURL=context-root.js.map

package/dist/context/context-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-root.js","sourceRoot":"","sources":["../../src/context/context-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAS,EAAE;IAC3C,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO;IAC5C,MAAM,IAAI,GAAG,UAAgE,CAAC;IAC9E,IAAI,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO;IAC5B,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,WAAW,EAAE,CAAC;IACpC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF,kBAAkB,EAAE,CAAC","sourcesContent":["import { ContextRoot } from '@lit/context';\n\nconst INSTALLED = Symbol.for('qti-components.context-root');\n\n/**\n * Catches context requests nobody answered and asks again when a provider connects, so a component\n * that upgrades before the element providing its context still gets the value.\n *\n * It has to live on the document and not on one of our elements: the case it exists for is the\n * providing element not having upgraded yet, so there is nothing of ours to attach it to. It holds\n * only requests that subscribe, which every `@consume` in this library does, and it holds them\n * weakly, so nothing is kept alive that would not be anyway.\n *\n * Once per page, however many copies of the package the page ends up with.\n */\nexport const installContextRoot = (): void => {\n  if (typeof document === 'undefined') return;\n  const page = globalThis as unknown as Record<symbol, ContextRoot | undefined>;\n  if (page[INSTALLED]) return;\n  page[INSTALLED] = new ContextRoot();\n  page[INSTALLED].attach(document.documentElement);\n};\n\ninstallContextRoot();\n"]}

package/dist/context/session.context.d.ts

@@ -3,7 +3,9 @@ export interface SessionContext {
     navPartId?: string | null;
     navSectionId?: string | null;
     navItemRefId?: string | null;
+    /** @deprecated Never set by the library. Removed in the next major. */
     navItemLoading?: boolean;
+    /** @deprecated Never set by the library. Removed in the next major. */
     navTestLoading?: boolean;
     view?: View;
 }

package/dist/context/session.context.js

@@ -1,4 +1,4 @@
 import { createContext } from '@lit/context';
 export const INITIAL_SESSION_CONTEXT = { view: 'candidate' };
-export const sessionContext = createContext(Symbol('testContext'));
+export const sessionContext = createContext(Symbol('sessionContext'));
 //# sourceMappingURL=session.context.js.map

package/dist/context/session.context.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.context.js","sourceRoot":"","sources":["../../src/context/session.context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAa7C,MAAM,CAAC,MAAM,uBAAuB,GAA6B,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAEvF,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAA2B,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC","sourcesContent":["import { createContext } from '@lit/context';\n\nexport type View = 'author' | 'candidate' | 'proctor' | 'scorer' | 'testConstructor' | 'tutor' | '';\n\nexport interface SessionContext {\n  navPartId?: string | null;\n  navSectionId?: string | null;\n  navItemRefId?: string | null;\n  navItemLoading?: boolean;\n  navTestLoading?: boolean;\n  view?: View;\n}\n\nexport const INITIAL_SESSION_CONTEXT: Readonly<SessionContext> = { view: 'candidate' };\n\nexport const sessionContext = createContext<Readonly<SessionContext>>(Symbol('testContext'));\n"]}
+{"version":3,"file":"session.context.js","sourceRoot":"","sources":["../../src/context/session.context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAe7C,MAAM,CAAC,MAAM,uBAAuB,GAA6B,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAEvF,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAA2B,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC","sourcesContent":["import { createContext } from '@lit/context';\n\nexport type View = 'author' | 'candidate' | 'proctor' | 'scorer' | 'testConstructor' | 'tutor' | '';\n\nexport interface SessionContext {\n  navPartId?: string | null;\n  navSectionId?: string | null;\n  navItemRefId?: string | null;\n  /** @deprecated Never set by the library. Removed in the next major. */\n  navItemLoading?: boolean;\n  /** @deprecated Never set by the library. Removed in the next major. */\n  navTestLoading?: boolean;\n  view?: View;\n}\n\nexport const INITIAL_SESSION_CONTEXT: Readonly<SessionContext> = { view: 'candidate' };\n\nexport const sessionContext = createContext<Readonly<SessionContext>>(Symbol('sessionContext'));\n"]}

package/dist/context/types/item.types.d.ts

@@ -8,5 +8,15 @@ export interface ItemContext {
      * Used for interactions that support state save/restore (e.g. PCI).
      */
     state?: Record<string, string | null>;
+    /** The item is shown for reading only. Interactions follow it; see `qti-assessment-item`'s `readonly`. */
+    readonly?: boolean;
+    /** The item is locked, for example after it was submitted. Interactions follow it; see `qti-assessment-item`'s `disabled`. */
+    disabled?: boolean;
+    /**
+     * Whether the interactions in the item are valid right now (a required answer is given, a limit is
+     * respected). Published by the item whenever it checks, so a reader never has to ask the item.
+     * Unset until the item has checked once.
+     */
+    valid?: boolean;
 }
 export declare const itemContextVariables: VariableDeclaration<string | string[]>[];

package/dist/context/types/item.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"item.types.js","sourceRoot":"","sources":["../../../src/context/types/item.types.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC;QACE,UAAU,EAAE,kBAAkB;QAC9B,WAAW,EAAE,QAAQ;QACrB,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;KAChB;IACD;QACE,UAAU,EAAE,aAAa;QACzB,WAAW,EAAE,QAAQ;QACrB,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,UAAU;KACjB;CAC0C,CAAC","sourcesContent":["import type { VariableDeclaration } from '../../lib/variables';\n\nexport interface ItemContext {\n  identifier?: string;\n  href?: string;\n  variables?: ReadonlyArray<VariableDeclaration<string | string[] | null>>;\n  /**\n   * Optional per-interaction opaque state, keyed by responseIdentifier.\n   * Used for interactions that support state save/restore (e.g. PCI).\n   */\n  state?: Record<string, string | null>;\n}\n\nexport const itemContextVariables = [\n  {\n    identifier: 'completionStatus',\n    cardinality: 'single',\n    baseType: 'string',\n    value: 'unknown',\n    type: 'outcome'\n  },\n  {\n    identifier: 'numAttempts',\n    cardinality: 'single',\n    baseType: 'integer',\n    value: '0',\n    type: 'response'\n  }\n] as VariableDeclaration<string | string[]>[];\n"]}
+{"version":3,"file":"item.types.js","sourceRoot":"","sources":["../../../src/context/types/item.types.ts"],"names":[],"mappings":"AAuBA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC;QACE,UAAU,EAAE,kBAAkB;QAC9B,WAAW,EAAE,QAAQ;QACrB,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;KAChB;IACD;QACE,UAAU,EAAE,aAAa;QACzB,WAAW,EAAE,QAAQ;QACrB,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,UAAU;KACjB;CAC0C,CAAC","sourcesContent":["import type { VariableDeclaration } from '../../lib/variables';\n\nexport interface ItemContext {\n  identifier?: string;\n  href?: string;\n  variables?: ReadonlyArray<VariableDeclaration<string | string[] | null>>;\n  /**\n   * Optional per-interaction opaque state, keyed by responseIdentifier.\n   * Used for interactions that support state save/restore (e.g. PCI).\n   */\n  state?: Record<string, string | null>;\n  /** The item is shown for reading only. Interactions follow it; see `qti-assessment-item`'s `readonly`. */\n  readonly?: boolean;\n  /** The item is locked, for example after it was submitted. Interactions follow it; see `qti-assessment-item`'s `disabled`. */\n  disabled?: boolean;\n  /**\n   * Whether the interactions in the item are valid right now (a required answer is given, a limit is\n   * respected). Published by the item whenever it checks, so a reader never has to ask the item.\n   * Unset until the item has checked once.\n   */\n  valid?: boolean;\n}\n\nexport const itemContextVariables = [\n  {\n    identifier: 'completionStatus',\n    cardinality: 'single',\n    baseType: 'string',\n    value: 'unknown',\n    type: 'outcome'\n  },\n  {\n    identifier: 'numAttempts',\n    cardinality: 'single',\n    baseType: 'integer',\n    value: '0',\n    type: 'response'\n  }\n] as VariableDeclaration<string | string[]>[];\n"]}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import './context/context-root';
 import './register';
 export * from './context/computed-item.context';
 export * from './context/types/computed-item.types';

package/dist/index.js

@@ -1,3 +1,4 @@
+import './context/context-root';
 import './register';
 export * from './context/computed-item.context';
 export * from './context/types/computed-item.types';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,CAAC;AAEpB,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AAEvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AAEnD,cAAc,wBAAwB,CAAC;AACvC,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAE1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC","sourcesContent":["import './register';\n\nexport * from './context/computed-item.context';\nexport * from './context/types/computed-item.types';\nexport * from './context/computed.context';\nexport * from './context/types/computed.types';\nexport * from './context/config.context';\nexport * from './context/interaction.context';\nexport * from './context/item.context';\nexport * from './context/types/item.types';\nexport * from './context/qti.context';\nexport * from './context/session.context';\nexport * from './context/test.context';\n\nexport * from './styles/box-sizing.styles';\nexport * from './styles/drop-region.styles';\nexport * from './styles/validation-message.styles';\n\nexport * from './abstract/interaction';\nexport * from './abstract/qti-variable-declaration';\nexport * from './abstract/qti-condition-expression';\nexport * from './abstract/qti-feedback';\nexport * from './abstract/qti-expression';\n\nexport * from './lib/response';\nexport * from './lib/expression-result';\nexport * from './lib/interaction.interface';\nexport * from './lib/variables';\nexport * from './lib/qti-rule-base';\nexport * from './lib/custom-operators';\n\nexport * from './utils/custom-state-set';\nexport * from './utils/scoring-helper';\nexport * from './utils/utils';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,wBAAwB,CAAC;AAChC,OAAO,YAAY,CAAC;AAEpB,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AAEvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AAEnD,cAAc,wBAAwB,CAAC;AACvC,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAE1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC","sourcesContent":["import './context/context-root';\nimport './register';\n\nexport * from './context/computed-item.context';\nexport * from './context/types/computed-item.types';\nexport * from './context/computed.context';\nexport * from './context/types/computed.types';\nexport * from './context/config.context';\nexport * from './context/interaction.context';\nexport * from './context/item.context';\nexport * from './context/types/item.types';\nexport * from './context/qti.context';\nexport * from './context/session.context';\nexport * from './context/test.context';\n\nexport * from './styles/box-sizing.styles';\nexport * from './styles/drop-region.styles';\nexport * from './styles/validation-message.styles';\n\nexport * from './abstract/interaction';\nexport * from './abstract/qti-variable-declaration';\nexport * from './abstract/qti-condition-expression';\nexport * from './abstract/qti-feedback';\nexport * from './abstract/qti-expression';\n\nexport * from './lib/response';\nexport * from './lib/expression-result';\nexport * from './lib/interaction.interface';\nexport * from './lib/variables';\nexport * from './lib/qti-rule-base';\nexport * from './lib/custom-operators';\n\nexport * from './utils/custom-state-set';\nexport * from './utils/scoring-helper';\nexport * from './utils/utils';\n"]}

package/dist/utils/scoring-helper.js

@@ -1,3 +1,4 @@
+const SCORING_BOOLEANS = { true: true, '1': true, false: false, '0': false };
 export class ScoringHelper {
     /**
      * Checks if a given point is within a specified area.
@@ -91,6 +92,11 @@ export class ScoringHelper {
             case 'identifier':
             case 'string':
                 return value1 === value2;
+            case 'boolean': {
+                // XML Schema booleans: "true" / "1" and "false" / "0"
+                const bool1 = SCORING_BOOLEANS[value1.trim().toLowerCase()];
+                return bool1 !== undefined && bool1 === SCORING_BOOLEANS[value2.trim().toLowerCase()];
+            }
             case 'integer': {
                 const int1 = parseInt(value1, 10);
                 const int2 = parseInt(value2, 10);

package/dist/utils/scoring-helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"scoring-helper.js","sourceRoot":"","sources":["../../src/utils/scoring-helper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BaseType } from '../lib/expression-result';\n\nexport class ScoringHelper {\n  /**\n   * Checks if a given point is within a specified area.\n   * @param point The point to test, represented as a string \"x y\" (e.g., \"102 113\").\n   * @param areaKey The area definition, including shape and coordinates (e.g., \"circle,102,113,16\").\n   * @param baseType The base type of the response, must be \"point\" for this method to proceed.\n   * @returns True if the point is within the area; false otherwise.\n   */\n  public static isPointInArea(point: string, areaKey: string, baseType: string): boolean {\n    if (baseType !== 'point') {\n      console.warn(`Base type ${baseType} is not supported for point area mapping.`);\n      return false;\n    }\n\n    // Parse the point as x and y coordinates\n    const [px, py] = point.split(' ').map(Number);\n\n    // Parse the area definition\n    const [shape, ...coords] = areaKey.split(',');\n    const coordinates = coords.map(Number);\n\n    switch (shape.toLowerCase()) {\n      // \"The default shape refers to the entire area of the associated image\" (QTI 3.0 §8.29), so\n      // every point is inside it and the coords are not read — §7.9 says none should be given, and\n      // the XSD still requires the attribute, so whatever is there is filler.\n      //\n      // This used to share the `circle` branch below, which demands exactly three coords and so\n      // rejected any real default entry as an \"Invalid circle definition\" (Citolab/qti-components#83).\n      case 'default':\n        return true;\n\n      case 'circle': {\n        const [cx, cy, radius] = coordinates;\n        if (coordinates.length !== 3) {\n          console.warn(`Invalid circle definition: ${areaKey}`);\n          return false;\n        }\n        const distance = Math.sqrt((px - cx) ** 2 + (py - cy) ** 2);\n        return distance <= radius;\n      }\n\n      case 'rect': {\n        const [x1, y1, x2, y2] = coordinates;\n        if (coordinates.length !== 4) {\n          console.warn(`Invalid rectangle definition: ${areaKey}`);\n          return false;\n        }\n        return px >= x1 && px <= x2 && py >= y1 && py <= y2;\n      }\n\n      case 'ellipse': {\n        const [cx, cy, rx, ry] = coordinates;\n        if (coordinates.length !== 4) {\n          console.warn(`Invalid ellipse definition: ${areaKey}`);\n          return false;\n        }\n        // Ellipse equation: ((px - cx)² / rx²) + ((py - cy)² / ry²) <= 1\n        const normalizedX = (px - cx) ** 2 / rx ** 2;\n        const normalizedY = (py - cy) ** 2 / ry ** 2;\n        return normalizedX + normalizedY <= 1;\n      }\n\n      case 'poly': {\n        if (coordinates.length < 6 || coordinates.length % 2 !== 0) {\n          console.warn(`Invalid polygon definition: ${areaKey}`);\n          return false;\n        }\n        const vertices = [];\n        for (let i = 0; i < coordinates.length; i += 2) {\n          vertices.push({ x: coordinates[i], y: coordinates[i + 1] });\n        }\n        return this.isPointInPolygon({ x: px, y: py }, vertices);\n      }\n\n      default:\n        console.warn(`Unsupported shape type: ${shape}`);\n        return false;\n    }\n  }\n\n  /**\n   * Checks if a point is inside a polygon using the ray-casting algorithm.\n   * @param point The point to test.\n   * @param vertices The vertices of the polygon in order (array of {x, y} objects).\n   * @returns True if the point is inside the polygon; false otherwise.\n   */\n  static isPointInPolygon(point: { x: number; y: number }, vertices: { x: number; y: number }[]): boolean {\n    let inside = false;\n    for (let i = 0, j = vertices.length - 1; i < vertices.length; j = i++) {\n      const xi = vertices[i].x,\n        yi = vertices[i].y;\n      const xj = vertices[j].x,\n        yj = vertices[j].y;\n\n      const intersect = yi > point.y !== yj > point.y && point.x < ((xj - xi) * (point.y - yi)) / (yj - yi) + xi;\n\n      if (intersect) inside = !inside;\n    }\n    return inside;\n  }\n\n  public static compareSingleValues(value1: Readonly<string>, value2: Readonly<string>, baseType: BaseType): boolean {\n    switch (baseType) {\n      case 'identifier':\n      case 'string':\n        return value1 === value2;\n      case 'integer': {\n        const int1 = parseInt(value1, 10);\n        const int2 = parseInt(value2, 10);\n        if (!isNaN(int1) && !isNaN(int2)) {\n          /*\n           * `parseInt` truncates, so on its own it reads \"2\" and \"2.5\" as the\n           * same number. That matters because the base type is taken from one\n           * operand: an expression whose result happens to be whole is an\n           * integer, and it was then compared against a fractional value with\n           * the fraction thrown away — `equal(divide(4, 2), 2.5)` was true.\n           *\n           * When either side has a fractional part the two are, by definition,\n           * not the same number. Comparing them in full says so, while the\n           * integer path keeps `parseInt`'s tolerance of a value like \"12 euro\"\n           * for everything that really is whole.\n           */\n          const float1 = parseFloat(value1);\n          const float2 = parseFloat(value2);\n          if (!Number.isInteger(float1) || !Number.isInteger(float2)) {\n            return float1 === float2;\n          }\n          return int1 === int2;\n        } else {\n          console.error(`Cannot convert ${value1} and/or ${value2} to int.`);\n        }\n        break;\n      }\n      case 'float': {\n        const float1 = parseFloat(value1);\n        const float2 = parseFloat(value2);\n        if (!isNaN(float1) && !isNaN(float2)) {\n          return float1 === float2;\n        } else {\n          console.error(`couldn't convert ${value1} and/or ${value2} to float.`);\n        }\n        break;\n      }\n      case 'pair':\n      case 'directedPair': {\n        /*\n         * Only a `pair` is unordered. A `directedPair` is directed — \"A B\" and\n         * \"B A\" are different values — so it must be compared as written.\n         *\n         * Both operands used to be sorted the moment they were split, which\n         * made the `baseType === 'pair'` sort below it dead code and every\n         * directedPair comparison order-insensitive: a candidate who matched\n         * the right two identifiers the wrong way round scored as correct.\n         */\n        const pair1 = value1.split(' ');\n        const pair2 = value2.split(' ');\n        if (pair1.length === 2 && pair2.length === 2) {\n          if (baseType === 'pair') {\n            pair1.sort();\n            pair2.sort();\n          }\n          return pair1.join(' ') === pair2.join(' ');\n        } else {\n          console.error(`compared two pair but one of the values does not have 2 values: 1: ${value1} 2: ${value2}`);\n        }\n        break;\n      }\n    }\n\n    return false;\n  }\n}\n"]}
+{"version":3,"file":"scoring-helper.js","sourceRoot":"","sources":["../../src/utils/scoring-helper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BaseType } from '../lib/expression-result';\n\nconst SCORING_BOOLEANS: Record<string, boolean | undefined> = { true: true, '1': true, false: false, '0': false };\n\nexport class ScoringHelper {\n  /**\n   * Checks if a given point is within a specified area.\n   * @param point The point to test, represented as a string \"x y\" (e.g., \"102 113\").\n   * @param areaKey The area definition, including shape and coordinates (e.g., \"circle,102,113,16\").\n   * @param baseType The base type of the response, must be \"point\" for this method to proceed.\n   * @returns True if the point is within the area; false otherwise.\n   */\n  public static isPointInArea(point: string, areaKey: string, baseType: string): boolean {\n    if (baseType !== 'point') {\n      console.warn(`Base type ${baseType} is not supported for point area mapping.`);\n      return false;\n    }\n\n    // Parse the point as x and y coordinates\n    const [px, py] = point.split(' ').map(Number);\n\n    // Parse the area definition\n    const [shape, ...coords] = areaKey.split(',');\n    const coordinates = coords.map(Number);\n\n    switch (shape.toLowerCase()) {\n      // \"The default shape refers to the entire area of the associated image\" (QTI 3.0 §8.29), so\n      // every point is inside it and the coords are not read — §7.9 says none should be given, and\n      // the XSD still requires the attribute, so whatever is there is filler.\n      //\n      // This used to share the `circle` branch below, which demands exactly three coords and so\n      // rejected any real default entry as an \"Invalid circle definition\" (Citolab/qti-components#83).\n      case 'default':\n        return true;\n\n      case 'circle': {\n        const [cx, cy, radius] = coordinates;\n        if (coordinates.length !== 3) {\n          console.warn(`Invalid circle definition: ${areaKey}`);\n          return false;\n        }\n        const distance = Math.sqrt((px - cx) ** 2 + (py - cy) ** 2);\n        return distance <= radius;\n      }\n\n      case 'rect': {\n        const [x1, y1, x2, y2] = coordinates;\n        if (coordinates.length !== 4) {\n          console.warn(`Invalid rectangle definition: ${areaKey}`);\n          return false;\n        }\n        return px >= x1 && px <= x2 && py >= y1 && py <= y2;\n      }\n\n      case 'ellipse': {\n        const [cx, cy, rx, ry] = coordinates;\n        if (coordinates.length !== 4) {\n          console.warn(`Invalid ellipse definition: ${areaKey}`);\n          return false;\n        }\n        // Ellipse equation: ((px - cx)² / rx²) + ((py - cy)² / ry²) <= 1\n        const normalizedX = (px - cx) ** 2 / rx ** 2;\n        const normalizedY = (py - cy) ** 2 / ry ** 2;\n        return normalizedX + normalizedY <= 1;\n      }\n\n      case 'poly': {\n        if (coordinates.length < 6 || coordinates.length % 2 !== 0) {\n          console.warn(`Invalid polygon definition: ${areaKey}`);\n          return false;\n        }\n        const vertices = [];\n        for (let i = 0; i < coordinates.length; i += 2) {\n          vertices.push({ x: coordinates[i], y: coordinates[i + 1] });\n        }\n        return this.isPointInPolygon({ x: px, y: py }, vertices);\n      }\n\n      default:\n        console.warn(`Unsupported shape type: ${shape}`);\n        return false;\n    }\n  }\n\n  /**\n   * Checks if a point is inside a polygon using the ray-casting algorithm.\n   * @param point The point to test.\n   * @param vertices The vertices of the polygon in order (array of {x, y} objects).\n   * @returns True if the point is inside the polygon; false otherwise.\n   */\n  static isPointInPolygon(point: { x: number; y: number }, vertices: { x: number; y: number }[]): boolean {\n    let inside = false;\n    for (let i = 0, j = vertices.length - 1; i < vertices.length; j = i++) {\n      const xi = vertices[i].x,\n        yi = vertices[i].y;\n      const xj = vertices[j].x,\n        yj = vertices[j].y;\n\n      const intersect = yi > point.y !== yj > point.y && point.x < ((xj - xi) * (point.y - yi)) / (yj - yi) + xi;\n\n      if (intersect) inside = !inside;\n    }\n    return inside;\n  }\n\n  public static compareSingleValues(value1: Readonly<string>, value2: Readonly<string>, baseType: BaseType): boolean {\n    switch (baseType) {\n      case 'identifier':\n      case 'string':\n        return value1 === value2;\n      case 'boolean': {\n        // XML Schema booleans: \"true\" / \"1\" and \"false\" / \"0\"\n        const bool1 = SCORING_BOOLEANS[value1.trim().toLowerCase()];\n        return bool1 !== undefined && bool1 === SCORING_BOOLEANS[value2.trim().toLowerCase()];\n      }\n      case 'integer': {\n        const int1 = parseInt(value1, 10);\n        const int2 = parseInt(value2, 10);\n        if (!isNaN(int1) && !isNaN(int2)) {\n          /*\n           * `parseInt` truncates, so on its own it reads \"2\" and \"2.5\" as the\n           * same number. That matters because the base type is taken from one\n           * operand: an expression whose result happens to be whole is an\n           * integer, and it was then compared against a fractional value with\n           * the fraction thrown away — `equal(divide(4, 2), 2.5)` was true.\n           *\n           * When either side has a fractional part the two are, by definition,\n           * not the same number. Comparing them in full says so, while the\n           * integer path keeps `parseInt`'s tolerance of a value like \"12 euro\"\n           * for everything that really is whole.\n           */\n          const float1 = parseFloat(value1);\n          const float2 = parseFloat(value2);\n          if (!Number.isInteger(float1) || !Number.isInteger(float2)) {\n            return float1 === float2;\n          }\n          return int1 === int2;\n        } else {\n          console.error(`Cannot convert ${value1} and/or ${value2} to int.`);\n        }\n        break;\n      }\n      case 'float': {\n        const float1 = parseFloat(value1);\n        const float2 = parseFloat(value2);\n        if (!isNaN(float1) && !isNaN(float2)) {\n          return float1 === float2;\n        } else {\n          console.error(`couldn't convert ${value1} and/or ${value2} to float.`);\n        }\n        break;\n      }\n      case 'pair':\n      case 'directedPair': {\n        /*\n         * Only a `pair` is unordered. A `directedPair` is directed — \"A B\" and\n         * \"B A\" are different values — so it must be compared as written.\n         *\n         * Both operands used to be sorted the moment they were split, which\n         * made the `baseType === 'pair'` sort below it dead code and every\n         * directedPair comparison order-insensitive: a candidate who matched\n         * the right two identifiers the wrong way round scored as correct.\n         */\n        const pair1 = value1.split(' ');\n        const pair2 = value2.split(' ');\n        if (pair1.length === 2 && pair2.length === 2) {\n          if (baseType === 'pair') {\n            pair1.sort();\n            pair2.sort();\n          }\n          return pair1.join(' ') === pair2.join(' ');\n        } else {\n          console.error(`compared two pair but one of the values does not have 2 values: 1: ${value1} 2: ${value2}`);\n        }\n        break;\n      }\n    }\n\n    return false;\n  }\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qti-components/base",
   "description": "QTI shared utilities",
-  "version": "2.3.0",
+  "version": "2.4.1-next.0",
   "author": "",
   "dependencies": {
     "@qti-components/utilities": "^1.3.3"