@qti-components/base 2.2.0 → 2.3.0

package/dist/abstract/interaction.js

@@ -84,7 +84,7 @@ export class Interaction extends LitElement {
         if (config.disableAfterIfMaxChoicesReached !== undefined) {
             if (!this.#didLogDisableAfterIfMaxChoicesReachedDeprecation) {
                 this.#didLogDisableAfterIfMaxChoicesReachedDeprecation = true;
-                console.log('[QTI Config] `disableAfterIfMaxChoicesReached` is deprecated. Use `disableAfterMaxReached` instead.');
+                console.warn('[QTI Config] `disableAfterIfMaxChoicesReached` is deprecated. Use `disableAfterMaxReached` instead.');
             }
             return config.disableAfterIfMaxChoicesReached;
         }

package/dist/abstract/interaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"interaction.js","sourceRoot":"","sources":["../../src/abstract/interaction.ts"],"names":[],"mappings":"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","sourcesContent":["import { consume, provide } from '@lit/context';\nimport { LitElement } from 'lit';\nimport { property } from 'lit/decorators.js';\n\nimport { configContext } from '../context/config.context';\nimport { interactionContext } from '../context/interaction.context';\nimport { itemContext } from '../context/item.context';\n\nimport type { PropertyValues } from 'lit';\nimport type { InteractionContext } from '../context/interaction.context';\nimport type { ConfigContext, ValidationDisplayMode } from '../context/config.context';\nimport type { ItemContext } from '../context/types/item.types';\nimport type { ValidatableInteraction } from '../lib/interaction.interface';\nimport type { ResponseVariable } from '../lib/variables';\n\n/**\n * Shared QTI interaction base. Formative correction behavior is supplied by the\n * `@qti-components/corrections` package.\n */\nexport abstract class Interaction extends LitElement implements ValidatableInteraction {\n  @consume({ context: itemContext, subscribe: true })\n  private _context: ItemContext;\n\n  /**\n   * Delivery configuration, from the nearest provider — `qti-test` or `qti-item`.\n   *\n   * **Public so it can be assigned directly, which is the development-time route.** An interaction\n   * has to work standalone, and in a story or a spec there is usually no provider above it — so\n   * setting the field is all that is needed:\n   *\n   *     orderInteraction.configContext = { allowReorder: false, validationDisplayMode: 'none' };\n   *\n   * With no provider, nothing ever overwrites it. That is the whole contract, and its limit: where a\n   * provider DOES exist it re-emits on its next update and wins, because `@consume` writes this same\n   * field. There is no merging — set the value on the provider in that case.\n   *\n   * In a lit-html template, bind it as a property rather than assigning after the fact:\n   *\n   *     html`<qti-order-interaction .configContext=${{ allowReorder: false }}>…`\n   *\n   * The binding is committed on the detached template clone, before the fragment is inserted, so it\n   * is in place by `connectedCallback` — which matters for anything that reads config on connect.\n   *\n   * It was `protected`, which fooled nobody: every caller reached it anyway through an\n   * `as any` / `as { configContext?: … }` cast. Public says what was already true and removes the\n   * casts, rather than pretending at an encapsulation the type system was the only thing enforcing.\n   */\n  @consume({ context: configContext, subscribe: true })\n  public configContext: ConfigContext;\n\n  #didLogDisableAfterIfMaxChoicesReachedDeprecation = false;\n\n  /*\n   * Published to the choice elements inside this interaction — their role, and how to tell\n   * whether they are draggable. Provided here on the base rather than in a mixin so that\n   * ChoicesMixin and the drag-drop mixins can each contribute without two providers of the same\n   * context competing on one element.\n   *\n   * Reassign, never mutate: an in-place change does not notify consumers.\n   */\n  @provide({ context: interactionContext })\n  protected _interactionContext: Readonly<InteractionContext> = { choiceRole: null, draggablesSelector: null };\n\n  static formAssociated = true;\n  protected _internals: ElementInternals;\n\n  get internals(): ElementInternals {\n    return this._internals;\n  }\n\n  @property({ type: String, attribute: 'response-identifier' }) responseIdentifier: string;\n\n  @property({ reflect: true, type: Boolean }) disabled = false;\n\n  @property({ reflect: true, type: Boolean }) readonly = false;\n\n  @property({ type: String }) name;\n\n  /** Extension point used by wrappers that should not register as candidate inputs. */\n  protected get registersWithItem(): boolean {\n    return true;\n  }\n\n  get isInline(): boolean {\n    return false;\n  }\n\n  get responseVariable(): ResponseVariable | undefined {\n    if (!this._context?.variables) {\n      return undefined;\n    }\n    const responseVariables = this._context.variables.filter(v => v.type === 'response') as ResponseVariable[];\n    const responseIdentifier = this.getAttribute('response-identifier');\n    return responseVariables.find(v => v.identifier === responseIdentifier);\n  }\n\n  abstract validate(): boolean;\n\n  get value(): string | null {\n    return JSON.stringify(this.response);\n  }\n\n  set value(val: string | null) {\n    this.response = val ? JSON.parse(val) : null;\n  }\n\n  abstract get response(): string | string[] | null;\n  abstract set response(val: string | string[] | null);\n\n  public reportValidity(): boolean {\n    const isValid = this._internals.validity.valid;\n    const mode = this.validationDisplayMode;\n\n    if (mode === 'native' || mode === 'both') {\n      this._internals.reportValidity();\n    }\n\n    if (mode === 'inline' || mode === 'both') {\n      this.updateInlineValidationMessage();\n    } else {\n      this.clearInlineValidationMessage();\n    }\n\n    if (mode === 'none') {\n      this.clearInlineValidationMessage();\n    }\n\n    return isValid;\n  }\n\n  protected get validationDisplayMode(): ValidationDisplayMode {\n    return this.configContext?.validationDisplayMode ?? 'inline';\n  }\n\n  protected resolveAllowReorder(options?: { defaultWhenUnset?: boolean }): boolean {\n    const defaultWhenUnset = options?.defaultWhenUnset ?? true;\n    const config = this.configContext;\n    if (!config) {\n      return defaultWhenUnset;\n    }\n    if (config.allowReorder !== undefined) {\n      return config.allowReorder;\n    }\n    return defaultWhenUnset;\n  }\n\n  protected resolveDisableAfterMaxReached(options?: { defaultWhenUnset?: boolean }): boolean {\n    const defaultWhenUnset = options?.defaultWhenUnset ?? false;\n    const config = this.configContext;\n\n    if (!config) {\n      return defaultWhenUnset;\n    }\n\n    if (config.disableAfterMaxReached !== undefined) {\n      return config.disableAfterMaxReached;\n    }\n\n    if (config.disableAfterIfMaxChoicesReached !== undefined) {\n      if (!this.#didLogDisableAfterIfMaxChoicesReachedDeprecation) {\n        this.#didLogDisableAfterIfMaxChoicesReachedDeprecation = true;\n        console.log(\n          '[QTI Config] `disableAfterIfMaxChoicesReached` is deprecated. Use `disableAfterMaxReached` instead.'\n        );\n      }\n      return config.disableAfterIfMaxChoicesReached;\n    }\n\n    return defaultWhenUnset;\n  }\n\n  protected setInteractionValidity(\n    isValid: boolean,\n    validityMessage = '',\n    anchor?: HTMLElement | null,\n    options?: { suppressInline?: boolean }\n  ): void {\n    const validityAnchor = anchor ?? this;\n    this._internals.setValidity(isValid ? {} : { customError: true }, validityMessage, validityAnchor);\n\n    if (\n      options?.suppressInline !== true &&\n      (this.validationDisplayMode === 'inline' || this.validationDisplayMode === 'both')\n    ) {\n      this.updateInlineValidationMessage();\n    }\n  }\n\n  protected updateInlineValidationMessage(): void {\n    const validationMessageElement = this.getValidationMessageElement();\n    if (!validationMessageElement) {\n      return;\n    }\n\n    if (!this._internals.validity.valid) {\n      validationMessageElement.textContent = this._internals.validationMessage;\n      validationMessageElement.style.setProperty('display', 'block', 'important');\n      return;\n    }\n\n    validationMessageElement.textContent = '';\n    validationMessageElement.style.display = 'none';\n  }\n\n  protected clearInlineValidationMessage(): void {\n    const validationMessageElement = this.getValidationMessageElement();\n    if (!validationMessageElement) {\n      return;\n    }\n\n    validationMessageElement.textContent = '';\n    validationMessageElement.style.display = 'none';\n  }\n\n  protected getValidationMessageElement(): HTMLElement | null {\n    return this.shadowRoot?.querySelector('#validation-message') as HTMLElement | null;\n  }\n\n  public reset(): void {\n    this.response = null;\n  }\n\n  public formResetCallback(): void {\n    this.reset();\n  }\n\n  public override connectedCallback(): void {\n    super.connectedCallback();\n\n    if (!this.registersWithItem) {\n      return;\n    }\n\n    this.dispatchEvent(\n      new CustomEvent('qti-register-interaction', {\n        bubbles: true,\n        composed: true,\n        cancelable: false,\n        detail: {\n          interactionElement: this,\n          responseIdentifier: this.responseIdentifier\n        }\n      })\n    );\n  }\n\n  public saveResponse(value: string | string[], state?: string | null): void {\n    this.dispatchEvent(\n      new CustomEvent('qti-interaction-response', {\n        bubbles: true,\n        composed: true,\n        cancelable: false,\n        detail: {\n          responseIdentifier: this.responseIdentifier,\n          response: Array.isArray(value) ? [...value] : value,\n          ...(state !== undefined ? { state } : {})\n        }\n      })\n    );\n  }\n\n  constructor() {\n    super();\n    this._internals = this.attachInternals();\n  }\n\n  /**\n   * Optional lifecycle bridge for interaction subclasses that do not need changed-property data.\n   *\n   * The parameter is `PropertyValues`, matching LitElement, and NOT `PropertyValues<this>`.\n   * The polymorphic `this` narrowed the parameter per subclass, which made every interaction\n   * class structurally incompatible with `LitElement` — so `Constructor<LitElement>`, the\n   * standard constraint for a Lit mixin, rejected all of them and consumers could not wrap an\n   * interaction in a mixin without casting. `this` buys nothing in a parameter position and\n   * costs contravariant compatibility with the base class.\n   *\n   * Still optional, so subclasses that ignore the argument can override with `firstUpdated()`.\n   */\n  protected override firstUpdated(_changedProperties?: PropertyValues): void {}\n}\n"]}
+{"version":3,"file":"interaction.js","sourceRoot":"","sources":["../../src/abstract/interaction.ts"],"names":[],"mappings":"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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"]}

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

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

package/dist/abstract/qti-expression.js

@@ -6,33 +6,105 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { consume } from '@lit/context';
 import { css, html, LitElement } from 'lit';
-import { state } from 'lit/decorators.js';
 import { itemContext } from '../context/item.context';
 import { qtiContext } from '../context/qti.context';
 import { testContext } from '../context/test.context';
+/**
+ * Wrap whatever an expression handed back in a variable, reading the base type
+ * off the value itself.
+ *
+ * An operator that knows its own result type says so through `resultBaseType`
+ * and that wins, because the QTI vocabulary fixes it regardless of the operands
+ * — `qti-divide` is a float even when it divides two integers exactly. Only
+ * when nothing is declared, as for a custom operator returning whatever the
+ * host computed, is the type read off the value.
+ *
+ * Everything used to be labelled `integer`, and since `compareSingleValues`
+ * parses an integer with `parseInt`, that silently truncated:
+ * `equal(divide(5, 2), 2.4)` compared 2 against 2 and answered true.
+ */
+const variableFromValue = (value, declared) => {
+    /*
+     * A NULL result is still a value: the operand exists and is NULL. Returning
+     * nothing would drop it from the list, which both hides the NULL from
+     * `qti-is-null` and shifts every operand after it — a binary operator with a
+     * NULL first argument would silently read its second as its first. The base
+     * type is moot here, since every operator tests the value before it.
+     */
+    if (value === null || value === undefined) {
+        return {
+            identifier: '',
+            baseType: 'string',
+            value: null,
+            cardinality: 'single',
+            type: 'response'
+        };
+    }
+    if (Array.isArray(value)) {
+        return {
+            identifier: '',
+            baseType: declared ?? inferBaseType(value[0]),
+            value: value.map(entry => String(entry)),
+            cardinality: 'multiple',
+            type: 'response'
+        };
+    }
+    return {
+        identifier: '',
+        baseType: declared ?? inferBaseType(value),
+        value: String(value),
+        cardinality: 'single',
+        type: 'response'
+    };
+};
+/** A JS value's QTI base type. A string stays text; it is not re-parsed. */
+const inferBaseType = (value) => {
+    if (typeof value === 'number')
+        return Number.isInteger(value) ? 'integer' : 'float';
+    if (typeof value === 'boolean')
+        return 'boolean';
+    return 'string';
+};
+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;
+};
 export class QtiExpression extends LitElement {
     constructor() {
         super(...arguments);
-        this.getVariables = () => 
-        // FIXME: if this itself is multiple, this will never enter the qti-multiple switch
-        // See this example here: https://github.com/1EdTech/qti-examples/blob/master/qtiv3-examples/packaging/items/Example05-feedbackBlock-adaptive.xml
-        Array.from(this.children)
-            .map((e) => {
-            console.debug('getVariables', e.tagName.toLowerCase());
-            switch (e.tagName.toLowerCase()) {
-                case 'qti-base-value': {
-                    return {
-                        baseType: e.getAttribute('base-type'),
-                        value: e.textContent.trim(),
-                        cardinality: 'single'
-                    };
-                }
-                case 'qti-variable': {
-                    const identifier = e.getAttribute('identifier') || '';
-                    // Special handling for QTI_CONTEXT
-                    if (identifier === 'QTI_CONTEXT') {
-                        if (!this.qtiContext?.QTI_CONTEXT) {
-                            console.warn('QTI_CONTEXT not available');
+        this.#lastVariables = [];
+        this.getVariables = () => {
+            // FIXME: if this itself is multiple, this will never enter the qti-multiple switch
+            // See this example here: https://github.com/1EdTech/qti-examples/blob/master/qtiv3-examples/packaging/items/Example05-feedbackBlock-adaptive.xml
+            const variables = Array.from(this.children)
+                .map((e) => {
+                switch (e.tagName.toLowerCase()) {
+                    case 'qti-base-value': {
+                        return {
+                            baseType: e.getAttribute('base-type'),
+                            value: e.textContent.trim(),
+                            cardinality: 'single'
+                        };
+                    }
+                    case 'qti-variable': {
+                        const identifier = e.getAttribute('identifier') || '';
+                        // Special handling for QTI_CONTEXT
+                        if (identifier === 'QTI_CONTEXT') {
+                            if (!this.qtiContext?.QTI_CONTEXT) {
+                                console.warn('QTI_CONTEXT not available');
+                                return {
+                                    identifier: 'QTI_CONTEXT',
+                                    baseType: 'record',
+                                    value: this.qtiContext.QTI_CONTEXT,
+                                    cardinality: 'record',
+                                    type: 'context'
+                                };
+                            }
                             return {
                                 identifier: 'QTI_CONTEXT',
                                 baseType: 'record',
@@ -41,82 +113,102 @@ export class QtiExpression extends LitElement {
                                 type: 'context'
                             };
                         }
-                        return {
-                            identifier: 'QTI_CONTEXT',
-                            baseType: 'record',
-                            value: this.qtiContext.QTI_CONTEXT,
-                            cardinality: 'record',
-                            type: 'context'
-                        };
+                        return this.resolveVariable(identifier);
                     }
-                    return this.resolveVariable(identifier);
-                }
-                case 'qti-multiple': {
-                    const multiple = e;
-                    const values = multiple.getResult();
-                    console.debug('values', values);
-                    if (values?.length > 0) {
-                        return {
-                            identifier: '',
-                            baseType: values[0].baseType,
-                            value: values.map(v => v.value),
-                            cardinality: 'multiple',
-                            type: 'response'
-                        };
+                    case 'qti-multiple': {
+                        const multiple = e;
+                        const values = multiple.getResult();
+                        if (values?.length > 0) {
+                            return {
+                                identifier: '',
+                                baseType: values[0].baseType,
+                                value: values.map(v => v.value),
+                                cardinality: 'multiple',
+                                type: 'response'
+                            };
+                        }
+                        return null;
                     }
-                    return null;
-                }
-                case 'qti-ordered': {
-                    const multiple = e;
-                    const values = multiple.getResult();
-                    if (values?.length > 0) {
-                        return {
-                            identifier: '',
-                            baseType: values[0].baseType,
-                            value: values.map(v => v.value),
-                            cardinality: 'ordered',
-                            type: 'response'
-                        };
+                    case 'qti-ordered': {
+                        const multiple = e;
+                        const values = multiple.getResult();
+                        if (values?.length > 0) {
+                            return {
+                                identifier: '',
+                                baseType: values[0].baseType,
+                                value: values.map(v => v.value),
+                                cardinality: 'ordered',
+                                type: 'response'
+                            };
+                        }
+                        return null;
                     }
-                    return null;
-                }
-                case 'qti-repeat': {
-                    const repeat = e;
-                    const values = repeat.getResult();
-                    if (values?.length > 0) {
-                        return values;
+                    case 'qti-repeat': {
+                        const repeat = e;
+                        const values = repeat.getResult();
+                        if (values?.length > 0) {
+                            return values;
+                        }
+                        return null;
                     }
-                    return null;
-                }
-                case 'qti-correct': {
-                    const identifier = e.getAttribute('identifier') || '';
-                    const responseVariable = this.context?.variables?.find(v => v.identifier === identifier) || null;
-                    return {
-                        baseType: responseVariable.baseType,
-                        value: responseVariable.correctResponse,
-                        cardinality: responseVariable.cardinality
-                    };
-                }
-                default: {
-                    // added for use of qti-equal-rounded
-                    try {
-                        const expression = e;
-                        const value = expression.getResult();
+                    case 'qti-custom-operator': {
+                        // Not a QtiExpression — it has `calculate` but no `getResult`, so
+                        // the default branch below throws on it and the surrounding
+                        // expression is handed nothing.
+                        return variableFromValue(e.calculate?.());
+                    }
+                    case 'qti-correct': {
+                        const identifier = e.getAttribute('identifier') || '';
+                        const responseVariable = this.context?.variables?.find(v => v.identifier === identifier);
+                        // A `qti-correct` naming a response that is not declared — a typo,
+                        // or an expression evaluated before the declaration registered —
+                        // used to dereference the null this deliberately produced and take
+                        // down the whole processing run. It is an unresolved variable, so
+                        // it is NULL.
+                        if (!responseVariable) {
+                            console.warn(`qti-correct: no response declaration for "${identifier}"`);
+                            return variableFromValue(null);
+                        }
                         return {
-                            baseType: 'integer',
-                            value: value?.toString() || null,
-                            cardinality: 'single'
+                            baseType: responseVariable.baseType,
+                            value: responseVariable.correctResponse,
+                            cardinality: responseVariable.cardinality
                         };
                     }
-                    catch (error) {
-                        console.warn('default not sufficient');
+                    default: {
+                        // Every operator without a case of its own lands here.
+                        try {
+                            const expression = e;
+                            const result = expression.getResult();
+                            return variableFromValue(result, expression.resultBaseType ?? inferContainerBaseType(expression, result));
+                        }
+                        catch (error) {
+                            console.warn(`getVariables: could not read a value from <${e.tagName.toLowerCase()}>`, error);
+                        }
+                        return null;
                     }
-                    return null;
                 }
-            }
-        })
-            .flatMap(v => (Array.isArray(v) ? v : [v]))
-            .filter(v => v !== null);
+            })
+                .flatMap(v => (Array.isArray(v) ? v : [v]))
+                .filter((v) => v !== null);
+            this.#lastVariables = variables;
+            return variables;
+        };
+    }
+    #lastVariables;
+    /**
+     * What the last `calculate()` produced, or undefined if it has not run.
+     *
+     * This is the supported way to inspect a scoring run: process the responses,
+     * then walk the rule tree reading this off each expression. A tool that wants
+     * to visualise how a score came about gets the whole tree annotated with its
+     * values, without the components having to re-render to show them.
+     */
+    get lastResult() {
+        return this.result;
+    }
+    get lastVariables() {
+        return this.#lastVariables;
     }
     /*
      * Written here rather than imported from a .css file, and that is a packaging constraint rather
@@ -145,9 +237,31 @@ export class QtiExpression extends LitElement {
       display: none;
     }
   `; }
+    /*
+     * Just the slot. This used to render `JSON.stringify(this.result, null, 2)`
+     * into a <pre> beside it — a development aid that nobody could see, because
+     * expressions live inside `qti-response-processing`, which is `display: none`.
+     * It cost a full serialisation of the result on every render.
+     */
     render() {
-        return html `<pre>${JSON.stringify(this.result, null, 2)}</pre>
-      <slot></slot>`;
+        return html `<slot></slot>`;
+    }
+    /*
+     * Render once, then never again: the template above is constant, so every
+     * later update is pure overhead.
+     *
+     * It is not the `@state()` decorators that drive those updates — `@consume`
+     * subscribes through `ContextConsumer`, which calls `host.requestUpdate()`
+     * itself on every context change, "in case this value is used in a template".
+     * Here it is not. An item with 30 response-processing rules holds ~180
+     * expression elements and the test context changes on every keystroke, so
+     * that was ~180 renders per keystroke producing identical output.
+     *
+     * The subscriptions stay, because `calculate()` reads the current values when
+     * a rule invokes it. Only the rendering stops.
+     */
+    shouldUpdate() {
+        return !this.hasUpdated;
     }
     calculate() {
         this.result = this.getResult();
@@ -156,6 +270,18 @@ export class QtiExpression extends LitElement {
     getResult() {
         throw new Error('Not implemented');
     }
+    /**
+     * The base type this operator always produces, when the QTI vocabulary fixes
+     * one regardless of its operands — `qti-divide` is a float even dividing two
+     * integers exactly, and `qti-round` is an integer whatever it rounds.
+     *
+     * Left undefined by operators whose result type follows their operands (a
+     * `qti-sum` of integers is an integer) and by those that return no number at
+     * all; the type is then read off the value.
+     */
+    get resultBaseType() {
+        return undefined;
+    }
     /**
      * Resolve a declared variable from the closest available scope: item-level
      * first, then the test-level outcome variables. So an expression used in an
@@ -171,18 +297,12 @@ export class QtiExpression extends LitElement {
     }
 }
 __decorate([
-    state()
-], QtiExpression.prototype, "result", void 0);
-__decorate([
-    consume({ context: itemContext, subscribe: true }),
-    state()
+    consume({ context: itemContext, subscribe: true })
 ], QtiExpression.prototype, "context", void 0);
 __decorate([
-    consume({ context: qtiContext, subscribe: true }),
-    state()
+    consume({ context: qtiContext, subscribe: true })
 ], QtiExpression.prototype, "qtiContext", void 0);
 __decorate([
-    consume({ context: testContext, subscribe: true }),
-    state()
+    consume({ context: testContext, subscribe: true })
 ], QtiExpression.prototype, "_testContext", void 0);
 //# sourceMappingURL=qti-expression.js.map

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';\nimport { state } from 'lit/decorators.js';\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 { ResponseVariable, VariableDeclaration } from '../lib/variables';\nimport type { TestContext } from '../context/test.context';\n\nexport interface QtiExpressionBase<T> {\n  // get assessmentItem(): QtiAssessmentItem;\n\n  // getVariables(): VariableDeclaration<number | string | (number | string)[] | null>[];\n  calculate(): Readonly<T>;\n}\n\nexport abstract class QtiExpression<T> extends LitElement implements QtiExpressionBase<T> {\n  @state()\n  protected result: any;\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  override render() {\n    return html`<pre>${JSON.stringify(this.result, null, 2)}</pre>\n      <slot></slot>`;\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  @consume({ context: itemContext, subscribe: true })\n  @state()\n  protected context?: ItemContext;\n\n  @consume({ context: qtiContext, subscribe: true })\n  @state()\n  protected qtiContext?: QtiContext;\n\n  @consume({ context: testContext, subscribe: true })\n  @state()\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 = (): (ResponseVariable | VariableDeclaration<QtiContextType>)[] =>\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    Array.from(this.children)\n      .map((e: Element) => {\n        console.debug('getVariables', e.tagName.toLowerCase());\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            console.debug('values', values);\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-correct': {\n            const identifier = e.getAttribute('identifier') || '';\n            const responseVariable: ResponseVariable =\n              this.context?.variables?.find(v => v.identifier === identifier) || null;\n            return {\n              baseType: responseVariable.baseType,\n              value: responseVariable.correctResponse,\n              cardinality: responseVariable.cardinality\n            } as ResponseVariable;\n          }\n          default: {\n            // added for use of qti-equal-rounded\n            try {\n              const expression = e as QtiExpression<number>;\n              const value = expression.getResult();\n              return {\n                baseType: 'integer',\n                value: value?.toString() || null,\n                cardinality: 'single'\n              } as ResponseVariable;\n            } catch (error) {\n              console.warn('default not sufficient');\n            }\n            return null;\n          }\n        }\n      })\n      .flatMap(v => (Array.isArray(v) ? v : [v]))\n      .filter(v => v !== null);\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\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"]}

package/dist/index.d.ts

@@ -23,6 +23,7 @@ export * from './lib/expression-result';
 export * from './lib/interaction.interface';
 export * from './lib/variables';
 export * from './lib/qti-rule-base';
+export * from './lib/custom-operators';
 export * from './utils/custom-state-set';
 export * from './utils/scoring-helper';
 export * from './utils/utils';

package/dist/index.js

@@ -23,6 +23,7 @@ export * from './lib/expression-result';
 export * from './lib/interaction.interface';
 export * from './lib/variables';
 export * from './lib/qti-rule-base';
+export * from './lib/custom-operators';
 export * from './utils/custom-state-set';
 export * from './utils/scoring-helper';
 export * from './utils/utils';

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;AAEpC,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';\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,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"]}

package/dist/lib/custom-operators.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The registry behind `<qti-custom-operator definition="…">`.
+ *
+ * A custom operator is by definition outside the QTI vocabulary, so which ones
+ * exist is a property of the delivery engine rather than of an item. An item
+ * names one in its `definition` attribute and the engine supplies it — here,
+ * through this registry.
+ *
+ * This is the second of two mechanisms on `qti-custom-operator`. The other runs
+ * inline JavaScript out of a CDATA section and is selected with
+ * `class="js.org"`; it stays as it is. `definition` is what items authored
+ * against the Citolab scoring engine use, and the two do not interact.
+ */
+export type CustomOperatorValue = string | string[] | number | boolean | null;
+/**
+ * Handed the calculated values of the element's child expressions, in document
+ * order, and returns the value of the expression.
+ */
+export type CustomOperator = (values: CustomOperatorValue[]) => CustomOperatorValue;
+/**
+ * Make an operator available to every `qti-custom-operator` that names it.
+ *
+ * The key is the `definition` attribute in full, prefix included. Registering a
+ * key a built-in already uses overrides that built-in, which is how a delivery
+ * engine replaces one it disagrees with.
+ */
+export declare const registerCustomOperator: (definition: string, operator: CustomOperator) => void;
+/** Undo a {@link registerCustomOperator}, restoring any built-in of that name. */
+export declare const unregisterCustomOperator: (definition: string) => void;
+/** The operator for a `definition`, or null when nothing provides it. */
+export declare const getCustomOperator: (definition: string) => CustomOperator | null;

package/dist/lib/custom-operators.js

@@ -0,0 +1,63 @@
+/**
+ * The registry behind `<qti-custom-operator definition="…">`.
+ *
+ * A custom operator is by definition outside the QTI vocabulary, so which ones
+ * exist is a property of the delivery engine rather than of an item. An item
+ * names one in its `definition` attribute and the engine supplies it — here,
+ * through this registry.
+ *
+ * This is the second of two mechanisms on `qti-custom-operator`. The other runs
+ * inline JavaScript out of a CDATA section and is selected with
+ * `class="js.org"`; it stays as it is. `definition` is what items authored
+ * against the Citolab scoring engine use, and the two do not interact.
+ */
+/** The value an operator most often works on: the first child, as text. */
+const firstString = (values) => {
+    const value = values[0];
+    if (value === null || value === undefined)
+        return null;
+    return Array.isArray(value) ? (value[0] ?? null) : String(value);
+};
+/** A text operator that leaves a NULL or absent first value alone. */
+const textOperator = (transform) => values => {
+    const value = firstString(values);
+    return value === null ? null : transform(value);
+};
+/**
+ * The three operators the scoring engine ships, under each of the prefixes it
+ * registers them with. The prefix is part of the key because `definition` is
+ * matched whole, exactly as the item writes it.
+ */
+const BUILT_IN_PREFIXES = ['depcp', 'questify', 'qade'];
+const BUILT_IN_OPERATORS = {
+    Trim: textOperator(value => value.trim()),
+    // Decompose, then drop the combining marks that decomposition split off, so
+    // "café" compares as "cafe".
+    ToAscii: textOperator(value => value.normalize('NFD').replace(/[̀-ͯ]/g, '')),
+    // A decimal comma written where the response processing expects a dot. Only
+    // the first comma, which is the decimal separator in the locales that use it.
+    ParseCommaDecimal: textOperator(value => value.replace(',', '.'))
+};
+const builtIns = new Map(BUILT_IN_PREFIXES.flatMap(prefix => Object.entries(BUILT_IN_OPERATORS).map(([name, operator]) => [
+    `${prefix}:${name}`,
+    operator
+])));
+/** Registered by the host application; consulted before the built-ins. */
+const registered = new Map();
+/**
+ * Make an operator available to every `qti-custom-operator` that names it.
+ *
+ * The key is the `definition` attribute in full, prefix included. Registering a
+ * key a built-in already uses overrides that built-in, which is how a delivery
+ * engine replaces one it disagrees with.
+ */
+export const registerCustomOperator = (definition, operator) => {
+    registered.set(definition, operator);
+};
+/** Undo a {@link registerCustomOperator}, restoring any built-in of that name. */
+export const unregisterCustomOperator = (definition) => {
+    registered.delete(definition);
+};
+/** The operator for a `definition`, or null when nothing provides it. */
+export const getCustomOperator = (definition) => registered.get(definition) ?? builtIns.get(definition) ?? null;
+//# sourceMappingURL=custom-operators.js.map

package/dist/lib/custom-operators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-operators.js","sourceRoot":"","sources":["../../src/lib/custom-operators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,2EAA2E;AAC3E,MAAM,WAAW,GAAG,CAAC,MAA6B,EAAiB,EAAE;IACnE,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF,sEAAsE;AACtE,MAAM,YAAY,GAChB,CAAC,SAAoC,EAAkB,EAAE,CACzD,MAAM,CAAC,EAAE;IACP,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC,CAAC;AAEJ;;;;GAIG;AACH,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAU,CAAC;AAEjE,MAAM,kBAAkB,GAAmC;IACzD,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACzC,4EAA4E;IAC5E,6BAA6B;IAC7B,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC5E,4EAA4E;IAC5E,8EAA8E;IAC9E,iBAAiB,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;CAClE,CAAC;AAEF,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CACjC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAA4B,EAAE,CAAC;IACrF,GAAG,MAAM,IAAI,IAAI,EAAE;IACnB,QAAQ;CACT,CAAC,CACH,CACF,CAAC;AAEF,0EAA0E;AAC1E,MAAM,UAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,UAAkB,EAAE,QAAwB,EAAQ,EAAE;IAC3F,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC,CAAC;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,UAAkB,EAAQ,EAAE;IACnE,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAChC,CAAC,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,UAAkB,EAAyB,EAAE,CAC7E,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC","sourcesContent":["/**\n * The registry behind `<qti-custom-operator definition=\"…\">`.\n *\n * A custom operator is by definition outside the QTI vocabulary, so which ones\n * exist is a property of the delivery engine rather than of an item. An item\n * names one in its `definition` attribute and the engine supplies it — here,\n * through this registry.\n *\n * This is the second of two mechanisms on `qti-custom-operator`. The other runs\n * inline JavaScript out of a CDATA section and is selected with\n * `class=\"js.org\"`; it stays as it is. `definition` is what items authored\n * against the Citolab scoring engine use, and the two do not interact.\n */\n\nexport type CustomOperatorValue = string | string[] | number | boolean | null;\n\n/**\n * Handed the calculated values of the element's child expressions, in document\n * order, and returns the value of the expression.\n */\nexport type CustomOperator = (values: CustomOperatorValue[]) => CustomOperatorValue;\n\n/** The value an operator most often works on: the first child, as text. */\nconst firstString = (values: CustomOperatorValue[]): string | null => {\n  const value = values[0];\n  if (value === null || value === undefined) return null;\n  return Array.isArray(value) ? (value[0] ?? null) : String(value);\n};\n\n/** A text operator that leaves a NULL or absent first value alone. */\nconst textOperator =\n  (transform: (value: string) => string): CustomOperator =>\n  values => {\n    const value = firstString(values);\n    return value === null ? null : transform(value);\n  };\n\n/**\n * The three operators the scoring engine ships, under each of the prefixes it\n * registers them with. The prefix is part of the key because `definition` is\n * matched whole, exactly as the item writes it.\n */\nconst BUILT_IN_PREFIXES = ['depcp', 'questify', 'qade'] as const;\n\nconst BUILT_IN_OPERATORS: Record<string, CustomOperator> = {\n  Trim: textOperator(value => value.trim()),\n  // Decompose, then drop the combining marks that decomposition split off, so\n  // \"café\" compares as \"cafe\".\n  ToAscii: textOperator(value => value.normalize('NFD').replace(/[̀-ͯ]/g, '')),\n  // A decimal comma written where the response processing expects a dot. Only\n  // the first comma, which is the decimal separator in the locales that use it.\n  ParseCommaDecimal: textOperator(value => value.replace(',', '.'))\n};\n\nconst builtIns = new Map<string, CustomOperator>(\n  BUILT_IN_PREFIXES.flatMap(prefix =>\n    Object.entries(BUILT_IN_OPERATORS).map(([name, operator]): [string, CustomOperator] => [\n      `${prefix}:${name}`,\n      operator\n    ])\n  )\n);\n\n/** Registered by the host application; consulted before the built-ins. */\nconst registered = new Map<string, CustomOperator>();\n\n/**\n * Make an operator available to every `qti-custom-operator` that names it.\n *\n * The key is the `definition` attribute in full, prefix included. Registering a\n * key a built-in already uses overrides that built-in, which is how a delivery\n * engine replaces one it disagrees with.\n */\nexport const registerCustomOperator = (definition: string, operator: CustomOperator): void => {\n  registered.set(definition, operator);\n};\n\n/** Undo a {@link registerCustomOperator}, restoring any built-in of that name. */\nexport const unregisterCustomOperator = (definition: string): void => {\n  registered.delete(definition);\n};\n\n/** The operator for a `definition`, or null when nothing provides it. */\nexport const getCustomOperator = (definition: string): CustomOperator | null =>\n  registered.get(definition) ?? builtIns.get(definition) ?? null;\n"]}

package/dist/lib/qti-rule-base.d.ts

@@ -11,3 +11,28 @@ export interface QtiRuleBase {
 export declare abstract class QtiRuleElement extends LitElement implements QtiRuleBase {
     abstract process(): any;
 }
+/**
+ * Thrown by `qti-exit-response` to end the response processing of an attempt.
+ *
+ * An exit can sit at any depth — inside a `qti-response-condition` branch, or
+ * inside a `qti-response-processing-fragment` — and has to stop every rule
+ * after it, not just its own siblings. Unwinding the stack is what reaches
+ * every one of those loops without each of them having to report upwards.
+ *
+ * `qti-response-processing` catches it at the top of the run. The outcomes set
+ * before the exit are kept, because each `qti-set-outcome-value` has already
+ * dispatched by the time this is thrown.
+ */
+export declare class QtiExitResponseSignal extends Error {
+    constructor();
+}
+/**
+ * Thrown by `qti-exit-test` to end the outcome processing of a test.
+ *
+ * The test-level twin of {@link QtiExitResponseSignal}, and unwinds the stack
+ * for the same reason: an exit inside a `qti-outcome-condition` branch has to
+ * stop the rules after the condition, not just its own siblings.
+ */
+export declare class QtiExitTestSignal extends Error {
+    constructor();
+}

package/dist/lib/qti-rule-base.js

@@ -4,4 +4,35 @@ import { LitElement } from 'lit';
  */
 export class QtiRuleElement extends LitElement {
 }
+/**
+ * Thrown by `qti-exit-response` to end the response processing of an attempt.
+ *
+ * An exit can sit at any depth — inside a `qti-response-condition` branch, or
+ * inside a `qti-response-processing-fragment` — and has to stop every rule
+ * after it, not just its own siblings. Unwinding the stack is what reaches
+ * every one of those loops without each of them having to report upwards.
+ *
+ * `qti-response-processing` catches it at the top of the run. The outcomes set
+ * before the exit are kept, because each `qti-set-outcome-value` has already
+ * dispatched by the time this is thrown.
+ */
+export class QtiExitResponseSignal extends Error {
+    constructor() {
+        super('qti-exit-response');
+        this.name = 'QtiExitResponseSignal';
+    }
+}
+/**
+ * Thrown by `qti-exit-test` to end the outcome processing of a test.
+ *
+ * The test-level twin of {@link QtiExitResponseSignal}, and unwinds the stack
+ * for the same reason: an exit inside a `qti-outcome-condition` branch has to
+ * stop the rules after the condition, not just its own siblings.
+ */
+export class QtiExitTestSignal extends Error {
+    constructor() {
+        super('qti-exit-test');
+        this.name = 'QtiExitTestSignal';
+    }
+}
 //# sourceMappingURL=qti-rule-base.js.map

package/dist/lib/qti-rule-base.js.map

@@ -1 +1 @@
-{"version":3,"file":"qti-rule-base.js","sourceRoot":"","sources":["../../src/lib/qti-rule-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AASjC;;GAEG;AACH,MAAM,OAAgB,cAAe,SAAQ,UAAU;CAEtD","sourcesContent":["import { LitElement } from 'lit';\n\n/**\n * Interface for any object that can process QTI rules\n */\nexport interface QtiRuleBase {\n  process(): any;\n}\n\n/**\n * Abstract base class for QTI rule DOM elements\n */\nexport abstract class QtiRuleElement extends LitElement implements QtiRuleBase {\n  abstract process(): any;\n}\n"]}
+{"version":3,"file":"qti-rule-base.js","sourceRoot":"","sources":["../../src/lib/qti-rule-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AASjC;;GAEG;AACH,MAAM,OAAgB,cAAe,SAAQ,UAAU;CAEtD;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C;QACE,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C;QACE,KAAK,CAAC,eAAe,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF","sourcesContent":["import { LitElement } from 'lit';\n\n/**\n * Interface for any object that can process QTI rules\n */\nexport interface QtiRuleBase {\n  process(): any;\n}\n\n/**\n * Abstract base class for QTI rule DOM elements\n */\nexport abstract class QtiRuleElement extends LitElement implements QtiRuleBase {\n  abstract process(): any;\n}\n\n/**\n * Thrown by `qti-exit-response` to end the response processing of an attempt.\n *\n * An exit can sit at any depth — inside a `qti-response-condition` branch, or\n * inside a `qti-response-processing-fragment` — and has to stop every rule\n * after it, not just its own siblings. Unwinding the stack is what reaches\n * every one of those loops without each of them having to report upwards.\n *\n * `qti-response-processing` catches it at the top of the run. The outcomes set\n * before the exit are kept, because each `qti-set-outcome-value` has already\n * dispatched by the time this is thrown.\n */\nexport class QtiExitResponseSignal extends Error {\n  constructor() {\n    super('qti-exit-response');\n    this.name = 'QtiExitResponseSignal';\n  }\n}\n\n/**\n * Thrown by `qti-exit-test` to end the outcome processing of a test.\n *\n * The test-level twin of {@link QtiExitResponseSignal}, and unwinds the stack\n * for the same reason: an exit inside a `qti-outcome-condition` branch has to\n * stop the rules after the condition, not just its own siblings.\n */\nexport class QtiExitTestSignal extends Error {\n  constructor() {\n    super('qti-exit-test');\n    this.name = 'QtiExitTestSignal';\n  }\n}\n"]}

package/dist/lib/variables.d.ts

@@ -33,8 +33,24 @@ export interface VariableDeclaration<T> extends VariableValue<T> {
     cardinality?: Cardinality;
     baseType?: BaseType;
 }
+/**
+ * One `qti-interpolation-table-entry`. `sourceValue` is the *lower bound* of a
+ * range rather than a value to match exactly, so the entries have to keep their
+ * document order: the first whose bound the source value clears wins.
+ */
+export interface InterpolationTableEntry {
+    sourceValue: number;
+    targetValue: number;
+    /** Whether `sourceValue` itself is in range. Defaults to true, per the spec. */
+    includeBoundary: boolean;
+}
 export interface OutcomeVariable extends VariableDeclaration<string | string[] | null> {
-    interpolationTable?: Map<number, number>;
+    interpolationTable?: InterpolationTableEntry[];
+    /**
+     * A qti-match-table's entries. Its targets are not necessarily numeric — a
+     * match table may map onto identifiers or strings — so they stay as written.
+     */
+    matchTable?: Map<number, string>;
     externalScored?: 'human' | 'externalMachine' | null;
 }
 export interface ResponseVariable extends VariableDeclaration<string | string[] | null> {

package/dist/lib/variables.js.map

@@ -1 +1 @@
-{"version":3,"file":"variables.js","sourceRoot":"","sources":["../../src/lib/variables.ts"],"names":[],"mappings":"","sourcesContent":["import type { BaseType, Cardinality } from './expression-result';\n\nexport type QtiAreaMapping = {\n  defaultValue: number;\n  lowerBound?: number;\n  upperBound?: number;\n  areaMapEntries: QtiAreaMapEntry[];\n};\n\nexport type QtiAreaMapEntry = {\n  shape: areaShape;\n  coords: string;\n  mappedValue: number;\n  defaultValue: number;\n};\n\nexport type QtiMapping = {\n  defaultValue: number;\n  lowerBound?: number;\n  upperBound?: number;\n  mapEntries: QtiMapEntry[];\n};\n\nexport type QtiMapEntry = { mapKey: string; mappedValue: number; caseSensitive: boolean };\n\nexport type areaShape = 'default' | 'circle' | 'rect' | 'ellipse' | 'poly';\nexport interface VariableValue<T> {\n  identifier: string;\n  value: Readonly<T>;\n  defaultValue?: T | null;\n  type: 'outcome' | 'response' | 'context' | 'template';\n}\n\nexport interface VariableDeclaration<T> extends VariableValue<T> {\n  cardinality?: Cardinality;\n  baseType?: BaseType;\n}\n\nexport interface OutcomeVariable extends VariableDeclaration<string | string[] | null> {\n  // specific to outcome variables\n  interpolationTable?: Map<number, number>;\n  externalScored?: 'human' | 'externalMachine' | null;\n}\n\nexport interface ResponseVariable extends VariableDeclaration<string | string[] | null> {\n  // specific to response variables\n  candidateResponse?: string | string[] | null;\n  mapping?: QtiMapping;\n  areaMapping?: QtiAreaMapping; // Optional property for area mappings\n  correctResponse?: string | string[] | null;\n}\n\nexport interface TemplateVariable extends VariableDeclaration<string | string[] | number | boolean | null> {\n  type: 'template';\n  mathVariable?: boolean;\n  paramVariable?: boolean;\n}\n"]}
+{"version":3,"file":"variables.js","sourceRoot":"","sources":["../../src/lib/variables.ts"],"names":[],"mappings":"","sourcesContent":["import type { BaseType, Cardinality } from './expression-result';\n\nexport type QtiAreaMapping = {\n  defaultValue: number;\n  lowerBound?: number;\n  upperBound?: number;\n  areaMapEntries: QtiAreaMapEntry[];\n};\n\nexport type QtiAreaMapEntry = {\n  shape: areaShape;\n  coords: string;\n  mappedValue: number;\n  defaultValue: number;\n};\n\nexport type QtiMapping = {\n  defaultValue: number;\n  lowerBound?: number;\n  upperBound?: number;\n  mapEntries: QtiMapEntry[];\n};\n\nexport type QtiMapEntry = { mapKey: string; mappedValue: number; caseSensitive: boolean };\n\nexport type areaShape = 'default' | 'circle' | 'rect' | 'ellipse' | 'poly';\nexport interface VariableValue<T> {\n  identifier: string;\n  value: Readonly<T>;\n  defaultValue?: T | null;\n  type: 'outcome' | 'response' | 'context' | 'template';\n}\n\nexport interface VariableDeclaration<T> extends VariableValue<T> {\n  cardinality?: Cardinality;\n  baseType?: BaseType;\n}\n\n/**\n * One `qti-interpolation-table-entry`. `sourceValue` is the *lower bound* of a\n * range rather than a value to match exactly, so the entries have to keep their\n * document order: the first whose bound the source value clears wins.\n */\nexport interface InterpolationTableEntry {\n  sourceValue: number;\n  targetValue: number;\n  /** Whether `sourceValue` itself is in range. Defaults to true, per the spec. */\n  includeBoundary: boolean;\n}\n\nexport interface OutcomeVariable extends VariableDeclaration<string | string[] | null> {\n  // specific to outcome variables\n  interpolationTable?: InterpolationTableEntry[];\n  /**\n   * A qti-match-table's entries. Its targets are not necessarily numeric — a\n   * match table may map onto identifiers or strings — so they stay as written.\n   */\n  matchTable?: Map<number, string>;\n  externalScored?: 'human' | 'externalMachine' | null;\n}\n\nexport interface ResponseVariable extends VariableDeclaration<string | string[] | null> {\n  // specific to response variables\n  candidateResponse?: string | string[] | null;\n  mapping?: QtiMapping;\n  areaMapping?: QtiAreaMapping; // Optional property for area mappings\n  correctResponse?: string | string[] | null;\n}\n\nexport interface TemplateVariable extends VariableDeclaration<string | string[] | number | boolean | null> {\n  type: 'template';\n  mathVariable?: boolean;\n  paramVariable?: boolean;\n}\n"]}

package/dist/utils/scoring-helper.js

@@ -17,8 +17,15 @@ export class ScoringHelper {
         const [shape, ...coords] = areaKey.split(',');
         const coordinates = coords.map(Number);
         switch (shape.toLowerCase()) {
-            case 'circle':
-            case 'default': {
+            // "The default shape refers to the entire area of the associated image" (QTI 3.0 §8.29), so
+            // every point is inside it and the coords are not read — §7.9 says none should be given, and
+            // the XSD still requires the attribute, so whatever is there is filler.
+            //
+            // This used to share the `circle` branch below, which demands exactly three coords and so
+            // rejected any real default entry as an "Invalid circle definition" (Citolab/qti-components#83).
+            case 'default':
+                return true;
+            case 'circle': {
                 const [cx, cy, radius] = coordinates;
                 if (coordinates.length !== 3) {
                     console.warn(`Invalid circle definition: ${areaKey}`);
@@ -88,6 +95,23 @@ export class ScoringHelper {
                 const int1 = parseInt(value1, 10);
                 const int2 = parseInt(value2, 10);
                 if (!isNaN(int1) && !isNaN(int2)) {
+                    /*
+                     * `parseInt` truncates, so on its own it reads "2" and "2.5" as the
+                     * same number. That matters because the base type is taken from one
+                     * operand: an expression whose result happens to be whole is an
+                     * integer, and it was then compared against a fractional value with
+                     * the fraction thrown away — `equal(divide(4, 2), 2.5)` was true.
+                     *
+                     * When either side has a fractional part the two are, by definition,
+                     * not the same number. Comparing them in full says so, while the
+                     * integer path keeps `parseInt`'s tolerance of a value like "12 euro"
+                     * for everything that really is whole.
+                     */
+                    const float1 = parseFloat(value1);
+                    const float2 = parseFloat(value2);
+                    if (!Number.isInteger(float1) || !Number.isInteger(float2)) {
+                        return float1 === float2;
+                    }
                     return int1 === int2;
                 }
                 else {
@@ -108,8 +132,17 @@ export class ScoringHelper {
             }
             case 'pair':
             case 'directedPair': {
-                const pair1 = value1.split(' ').sort();
-                const pair2 = value2.split(' ').sort();
+                /*
+                 * Only a `pair` is unordered. A `directedPair` is directed — "A B" and
+                 * "B A" are different values — so it must be compared as written.
+                 *
+                 * Both operands used to be sorted the moment they were split, which
+                 * made the `baseType === 'pair'` sort below it dead code and every
+                 * directedPair comparison order-insensitive: a candidate who matched
+                 * the right two identifiers the wrong way round scored as correct.
+                 */
+                const pair1 = value1.split(' ');
+                const pair2 = value2.split(' ');
                 if (pair1.length === 2 && pair2.length === 2) {
                     if (baseType === 'pair') {
                         pair1.sort();

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      case 'circle':\n      case 'default': {\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          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        const pair1 = value1.split(' ').sort();\n        const pair2 = value2.split(' ').sort();\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\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"]}

package/dist/utils/utils.d.ts

@@ -1,4 +1,14 @@
 export declare const decimalSeparator: () => string;
+/**
+ * Renders a number the way QTI stores one: a plain decimal string with `.` as the separator and no
+ * grouping, whatever the browser's locale is. Strings are already in that form and pass through.
+ *
+ * `Number.prototype.toString()` is exactly that format. The locale-aware versions this used to call
+ * are not: under a comma-decimal locale (nl, de, fr, ...) it ran `.replace('.', '')` over a string
+ * that always uses `.`, so a score of 0.5 was stored as "05" and 1.5 as "15" — an item's SCORE came
+ * out ten times too big for every value with a fraction. Under a dot-decimal locale
+ * `toLocaleString()` grouped thousands instead, turning 1234.5 into "1,234.5".
+ */
 export declare const convertNumberToUniversalFormat: (number: number | string) => string;
 export declare function IsNullOrUndefined(value: unknown): boolean;
 export declare function removeDoubleSlashes(str: string): string;

package/dist/utils/utils.js

@@ -1,18 +1,18 @@
 export const decimalSeparator = () => {
     return new Intl.NumberFormat().format(0.1).replace(/\d/g, '');
 };
+/**
+ * Renders a number the way QTI stores one: a plain decimal string with `.` as the separator and no
+ * grouping, whatever the browser's locale is. Strings are already in that form and pass through.
+ *
+ * `Number.prototype.toString()` is exactly that format. The locale-aware versions this used to call
+ * are not: under a comma-decimal locale (nl, de, fr, ...) it ran `.replace('.', '')` over a string
+ * that always uses `.`, so a score of 0.5 was stored as "05" and 1.5 as "15" — an item's SCORE came
+ * out ten times too big for every value with a fraction. Under a dot-decimal locale
+ * `toLocaleString()` grouped thousands instead, turning 1234.5 into "1,234.5".
+ */
 export const convertNumberToUniversalFormat = (number) => {
-    // check if type is string
-    if (typeof number === 'string') {
-        return number;
-    }
-    const dSep = decimalSeparator();
-    if (dSep === '.') {
-        return number.toLocaleString();
-    }
-    else {
-        return number.toString().replace('.', '').replace(dSep, '.');
-    }
+    return typeof number === 'string' ? number : number.toString();
 };
 export function IsNullOrUndefined(value) {
     return value === null || value === undefined;

package/dist/utils/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,EAAE;IACnC,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAChE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,MAAuB,EAAE,EAAE;IACxE,0BAA0B;IAC1B,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;IAChC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC,cAAc,EAAE,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,oBAAoB,GAAG,GAAG;SAC7B,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC;SAC7B,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC;SAC5B,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAClC,OAAO,oBAAoB,CAAC;AAC9B,CAAC","sourcesContent":["export const decimalSeparator = () => {\n  return new Intl.NumberFormat().format(0.1).replace(/\\d/g, '');\n};\n\nexport const convertNumberToUniversalFormat = (number: number | string) => {\n  // check if type is string\n  if (typeof number === 'string') {\n    return number;\n  }\n  const dSep = decimalSeparator();\n  if (dSep === '.') {\n    return number.toLocaleString();\n  } else {\n    return number.toString().replace('.', '').replace(dSep, '.');\n  }\n};\n\nexport function IsNullOrUndefined(value: unknown) {\n  return value === null || value === undefined;\n}\n\nexport function removeDoubleSlashes(str: string) {\n  const singleForwardSlashes = str\n    .replace(/([^:]\\/)\\/+/g, '$1')\n    .replace(/\\/\\//g, '/')\n    .replace('http:/', 'http://')\n    .replace('https:/', 'https://');\n  return singleForwardSlashes;\n}\n"]}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,EAAE;IACnC,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAChE,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,MAAuB,EAAE,EAAE;IACxE,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;AACjE,CAAC,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,oBAAoB,GAAG,GAAG;SAC7B,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC;SAC7B,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC;SAC5B,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAClC,OAAO,oBAAoB,CAAC;AAC9B,CAAC","sourcesContent":["export const decimalSeparator = () => {\n  return new Intl.NumberFormat().format(0.1).replace(/\\d/g, '');\n};\n\n/**\n * Renders a number the way QTI stores one: a plain decimal string with `.` as the separator and no\n * grouping, whatever the browser's locale is. Strings are already in that form and pass through.\n *\n * `Number.prototype.toString()` is exactly that format. The locale-aware versions this used to call\n * are not: under a comma-decimal locale (nl, de, fr, ...) it ran `.replace('.', '')` over a string\n * that always uses `.`, so a score of 0.5 was stored as \"05\" and 1.5 as \"15\" — an item's SCORE came\n * out ten times too big for every value with a fraction. Under a dot-decimal locale\n * `toLocaleString()` grouped thousands instead, turning 1234.5 into \"1,234.5\".\n */\nexport const convertNumberToUniversalFormat = (number: number | string) => {\n  return typeof number === 'string' ? number : number.toString();\n};\n\nexport function IsNullOrUndefined(value: unknown) {\n  return value === null || value === undefined;\n}\n\nexport function removeDoubleSlashes(str: string) {\n  const singleForwardSlashes = str\n    .replace(/([^:]\\/)\\/+/g, '$1')\n    .replace(/\\/\\//g, '/')\n    .replace('http:/', 'http://')\n    .replace('https:/', 'https://');\n  return singleForwardSlashes;\n}\n"]}

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@qti-components/base",
   "description": "QTI shared utilities",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "author": "",
   "dependencies": {
     "@qti-components/utilities": "^1.3.3"
   },
   "devDependencies": {
     "@lit/context": "^1.1.6",
-    "lit": "^3.3.3"
+    "lit": "^3.3.1"
   },
   "keywords": [
     "qti",
@@ -50,7 +50,7 @@
   },
   "scripts": {
     "attw": "attw --profile esm-only --pack",
-    "build": "tsc --paths null",
+    "build": "pnpm run clean && tsc --paths null",
     "clean": "rm -rf dist",
     "yalc": "yalc publish",
     "yalc:push": "yalc push"