@qti-components/base 2.0.0 → 2.1.0

package/dist/abstract/interaction.d.ts

@@ -72,6 +72,17 @@ export declare abstract class Interaction extends LitElement implements Validata
     connectedCallback(): void;
     saveResponse(value: string | string[], state?: string | null): void;
     constructor();
-    /** Optional lifecycle bridge for interaction subclasses that do not need changed-property data. */
-    protected firstUpdated(_changedProperties?: PropertyValues<this>): void;
+    /**
+     * Optional lifecycle bridge for interaction subclasses that do not need changed-property data.
+     *
+     * The parameter is `PropertyValues`, matching LitElement, and NOT `PropertyValues<this>`.
+     * The polymorphic `this` narrowed the parameter per subclass, which made every interaction
+     * class structurally incompatible with `LitElement` — so `Constructor<LitElement>`, the
+     * standard constraint for a Lit mixin, rejected all of them and consumers could not wrap an
+     * interaction in a mixin without casting. `this` buys nothing in a parameter position and
+     * costs contravariant compatibility with the base class.
+     *
+     * Still optional, so subclasses that ignore the argument can override with `firstUpdated()`.
+     */
+    protected firstUpdated(_changedProperties?: PropertyValues): void;
 }

package/dist/abstract/interaction.js

@@ -171,7 +171,18 @@ export class Interaction extends LitElement {
         this.readonly = false;
         this._internals = this.attachInternals();
     }
-    /** Optional lifecycle bridge for interaction subclasses that do not need changed-property data. */
+    /**
+     * Optional lifecycle bridge for interaction subclasses that do not need changed-property data.
+     *
+     * The parameter is `PropertyValues`, matching LitElement, and NOT `PropertyValues<this>`.
+     * The polymorphic `this` narrowed the parameter per subclass, which made every interaction
+     * class structurally incompatible with `LitElement` — so `Constructor<LitElement>`, the
+     * standard constraint for a Lit mixin, rejected all of them and consumers could not wrap an
+     * interaction in a mixin without casting. `this` buys nothing in a parameter position and
+     * costs contravariant compatibility with the base class.
+     *
+     * Still optional, so subclasses that ignore the argument can override with `firstUpdated()`.
+     */
     firstUpdated(_changedProperties) { }
 }
 __decorate([

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  /** Optional lifecycle bridge for interaction subclasses that do not need changed-property data. */\n  protected override firstUpdated(_changedProperties?: PropertyValues<this>): 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.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"]}

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

@@ -21,6 +21,8 @@ export type ComputedContext = {
             title: string;
             completed?: boolean;
             items: ComputedItem[];
+            navigationMode: 'linear' | 'nonlinear';
+            submissionMode: 'individual' | 'simultaneous';
         }[];
     }[];
 };

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

@@ -1 +1 @@
-{"version":3,"file":"computed.types.js","sourceRoot":"","sources":["../../../src/context/types/computed.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { View } from '../session.context';\nimport type { ComputedItemContext } from './computed-item.types';\n\nexport type ComputedItem = ComputedItemContext & {\n  categories?: string[]; // not necessary for outside world\n  type?: 'info' | 'regular';\n  index?: number;\n  active?: boolean;\n};\n\nexport type ComputedContext = {\n  view: View;\n  identifier: string;\n  title: string;\n  testParts: {\n    active?: boolean;\n    identifier: string;\n    navigationMode: 'linear' | 'nonlinear';\n    submissionMode: 'individual' | 'simultaneous';\n    sections: {\n      active?: boolean;\n      identifier: string;\n      title: string;\n      completed?: boolean;\n      items: ComputedItem[];\n    }[];\n  }[];\n};\n"]}
+{"version":3,"file":"computed.types.js","sourceRoot":"","sources":["../../../src/context/types/computed.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { View } from '../session.context';\nimport type { ComputedItemContext } from './computed-item.types';\n\nexport type ComputedItem = ComputedItemContext & {\n  categories?: string[]; // not necessary for outside world\n  type?: 'info' | 'regular';\n  index?: number;\n  active?: boolean;\n};\n\nexport type ComputedContext = {\n  view: View;\n  identifier: string;\n  title: string;\n  testParts: {\n    active?: boolean;\n    identifier: string;\n    navigationMode: 'linear' | 'nonlinear';\n    submissionMode: 'individual' | 'simultaneous';\n    sections: {\n      active?: boolean;\n      identifier: string;\n      title: string;\n      completed?: boolean;\n      items: ComputedItem[];\n      navigationMode: 'linear' | 'nonlinear';\n      submissionMode: 'individual' | 'simultaneous';\n    }[];\n  }[];\n};\n"]}

package/dist/index.d.ts

@@ -23,5 +23,6 @@ export * from './lib/expression-result';
 export * from './lib/interaction.interface';
 export * from './lib/variables';
 export * from './lib/qti-rule-base';
+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 './utils/custom-state-set';
 export * from './utils/scoring-helper';
 export * from './utils/utils';
 //# sourceMappingURL=index.js.map

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,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/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;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"]}

package/dist/register.js

@@ -1,4 +1,8 @@
 import { qtiBaseElements } from './elements';
+import { installCustomStateSetFallback } from './utils/custom-state-set';
+// Before any element is defined, so the patched `attachInternals` is in place by
+// the time the first interaction upgrades. No-op where `states` works natively.
+installCustomStateSetFallback();
 for (const { tag, ctor } of qtiBaseElements) {
     if (!customElements.get(tag)) {
         customElements.define(tag, ctor);

package/dist/register.js.map

@@ -1 +1 @@
-{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,eAAe,EAAE,CAAC;IAC5C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;AACH,CAAC","sourcesContent":["import { qtiBaseElements } from './elements';\n\nfor (const { tag, ctor } of qtiBaseElements) {\n  if (!customElements.get(tag)) {\n    customElements.define(tag, ctor);\n  }\n}\n"]}
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAEzE,iFAAiF;AACjF,gFAAgF;AAChF,6BAA6B,EAAE,CAAC;AAEhC,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,eAAe,EAAE,CAAC;IAC5C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;AACH,CAAC","sourcesContent":["import { qtiBaseElements } from './elements';\nimport { installCustomStateSetFallback } from './utils/custom-state-set';\n\n// Before any element is defined, so the patched `attachInternals` is in place by\n// the time the first interaction upgrades. No-op where `states` works natively.\ninstallCustomStateSetFallback();\n\nfor (const { tag, ctor } of qtiBaseElements) {\n  if (!customElements.get(tag)) {\n    customElements.define(tag, ctor);\n  }\n}\n"]}

package/dist/utils/custom-state-set.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Custom-state support shim for browsers this library cannot use natively.
+ *
+ * Interactions track selection and correct/incorrect marking through
+ * `internals.states`, with bare state names (`checked`, `radio`,
+ * `correct-response`, …). Two browser profiles cannot service that:
+ *
+ * - Safari 16.4–17.3 implement `ElementInternals` but not `CustomStateSet`, so
+ *   `internals.states` is `undefined` and reading it throws — "undefined is not
+ *   an object (evaluating 'internals.states.has')".
+ * - Chrome and Edge before the CSS custom-state spec change expose `states` but
+ *   reject names that do not start with `--`, so `states.add('radio')` throws
+ *   "The specified value 'radio' must start with '--'".
+ *
+ * On both, picking a choice throws rather than registering. `attachInternals`
+ * itself is unguarded throughout the interaction base classes, which puts the
+ * hard support floor at Safari 16.4 — inside the range that breaks.
+ *
+ * The shim replaces `states` with a permissive `Set` and mirrors its contents to
+ * a space-separated `data-state` attribute on the host, because these browsers'
+ * CSS parsers also drop any selector list containing `:state()`. The theme's
+ * built stylesheets pair every `:state(x)` with a `[data-state~='x']` arm (see
+ * `tools/postcss/custom-state-fallback.mjs`), so styling survives too.
+ *
+ * Support is classified by behaviour rather than by browser version, and the
+ * shim is not installed at all where `states` works.
+ */
+/** A permissive `CustomStateSet` that mirrors its contents to `data-state`. */
+export declare class CustomStateSetShim extends Set<string> {
+    #private;
+    constructor(host: HTMLElement);
+    add(state: string): this;
+    delete(state: string): boolean;
+    clear(): void;
+}
+export type CustomStateSupport = 'missing' | 'legacy' | 'modern';
+/**
+ * Classify native custom-state support by behaviour:
+ *
+ * - `missing`: `ElementInternals` carries no `states` at all.
+ * - `legacy`: `states` exists but rejects a bare name.
+ * - `modern`: `states` exists and accepts a bare name — no shim wanted.
+ *
+ * `attachInternals` only works on a custom element, so the probe registers a
+ * throwaway one. That happens solely when `states` is present, so the `missing`
+ * path never defines anything.
+ */
+export declare function classifyCustomStateSupport(attachInternals: (this: HTMLElement) => ElementInternals): CustomStateSupport;
+/**
+ * Patch `HTMLElement.prototype.attachInternals` so every element's `states` is
+ * the shim, on the two profiles that need it. Idempotent, and a no-op where
+ * native support is usable.
+ *
+ * Returns the classification that was acted on, which is what the tests assert.
+ */
+export declare function installCustomStateSetFallback(): CustomStateSupport | 'already-installed';

package/dist/utils/custom-state-set.js

@@ -0,0 +1,130 @@
+/**
+ * Custom-state support shim for browsers this library cannot use natively.
+ *
+ * Interactions track selection and correct/incorrect marking through
+ * `internals.states`, with bare state names (`checked`, `radio`,
+ * `correct-response`, …). Two browser profiles cannot service that:
+ *
+ * - Safari 16.4–17.3 implement `ElementInternals` but not `CustomStateSet`, so
+ *   `internals.states` is `undefined` and reading it throws — "undefined is not
+ *   an object (evaluating 'internals.states.has')".
+ * - Chrome and Edge before the CSS custom-state spec change expose `states` but
+ *   reject names that do not start with `--`, so `states.add('radio')` throws
+ *   "The specified value 'radio' must start with '--'".
+ *
+ * On both, picking a choice throws rather than registering. `attachInternals`
+ * itself is unguarded throughout the interaction base classes, which puts the
+ * hard support floor at Safari 16.4 — inside the range that breaks.
+ *
+ * The shim replaces `states` with a permissive `Set` and mirrors its contents to
+ * a space-separated `data-state` attribute on the host, because these browsers'
+ * CSS parsers also drop any selector list containing `:state()`. The theme's
+ * built stylesheets pair every `:state(x)` with a `[data-state~='x']` arm (see
+ * `tools/postcss/custom-state-fallback.mjs`), so styling survives too.
+ *
+ * Support is classified by behaviour rather than by browser version, and the
+ * shim is not installed at all where `states` works.
+ */
+/** A permissive `CustomStateSet` that mirrors its contents to `data-state`. */
+export class CustomStateSetShim extends Set {
+    #host;
+    constructor(host) {
+        super();
+        this.#host = host;
+    }
+    add(state) {
+        super.add(state);
+        this.#reflect();
+        return this;
+    }
+    delete(state) {
+        const deleted = super.delete(state);
+        this.#reflect();
+        return deleted;
+    }
+    clear() {
+        super.clear();
+        this.#reflect();
+    }
+    #reflect() {
+        // A custom element must not gain attributes while it is upgrading, so defer
+        // the write until the element is connected.
+        if (this.#host.isConnected)
+            this.#write();
+        else
+            queueMicrotask(() => this.#write());
+    }
+    #write() {
+        if (this.size === 0)
+            this.#host.removeAttribute('data-state');
+        else
+            this.#host.setAttribute('data-state', Array.from(this).join(' '));
+    }
+}
+const PROBE_TAG = 'custom-state-support-probe';
+/**
+ * Classify native custom-state support by behaviour:
+ *
+ * - `missing`: `ElementInternals` carries no `states` at all.
+ * - `legacy`: `states` exists but rejects a bare name.
+ * - `modern`: `states` exists and accepts a bare name — no shim wanted.
+ *
+ * `attachInternals` only works on a custom element, so the probe registers a
+ * throwaway one. That happens solely when `states` is present, so the `missing`
+ * path never defines anything.
+ */
+export function classifyCustomStateSupport(attachInternals) {
+    if (!('states' in ElementInternals.prototype))
+        return 'missing';
+    if (typeof customElements === 'undefined')
+        return 'modern';
+    try {
+        if (!customElements.get(PROBE_TAG))
+            customElements.define(PROBE_TAG, class extends HTMLElement {
+            });
+        const states = attachInternals.call(document.createElement(PROBE_TAG)).states;
+        if (!states)
+            return 'missing';
+        // A bare name throws SyntaxError under the legacy spec and never does under
+        // the current one, so classify on the throw alone — not on whether the value
+        // sticks, which some environments do not honour on a detached element.
+        states.add('probe');
+        states.delete('probe');
+        return 'modern';
+    }
+    catch {
+        return 'legacy';
+    }
+}
+let installed = false;
+/**
+ * Patch `HTMLElement.prototype.attachInternals` so every element's `states` is
+ * the shim, on the two profiles that need it. Idempotent, and a no-op where
+ * native support is usable.
+ *
+ * Returns the classification that was acted on, which is what the tests assert.
+ */
+export function installCustomStateSetFallback() {
+    if (installed)
+        return 'already-installed';
+    if (typeof HTMLElement === 'undefined' || typeof ElementInternals === 'undefined')
+        return 'modern';
+    const native = HTMLElement.prototype.attachInternals;
+    if (!native)
+        return 'modern';
+    const support = classifyCustomStateSupport(native);
+    if (support === 'modern')
+        return support;
+    installed = true;
+    HTMLElement.prototype.attachInternals = function attachInternals() {
+        const internals = native.call(this);
+        Object.defineProperty(internals, 'states', {
+            configurable: true,
+            enumerable: true,
+            value: new CustomStateSetShim(this)
+        });
+        return internals;
+    };
+    return support;
+}
+//# sourceMappingURL=custom-state-set.js.map

package/dist/utils/custom-state-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-state-set.js","sourceRoot":"","sources":["../../src/utils/custom-state-set.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Custom-state support shim for browsers this library cannot use natively.\n *\n * Interactions track selection and correct/incorrect marking through\n * `internals.states`, with bare state names (`checked`, `radio`,\n * `correct-response`, …). Two browser profiles cannot service that:\n *\n * - Safari 16.4–17.3 implement `ElementInternals` but not `CustomStateSet`, so\n *   `internals.states` is `undefined` and reading it throws — \"undefined is not\n *   an object (evaluating 'internals.states.has')\".\n * - Chrome and Edge before the CSS custom-state spec change expose `states` but\n *   reject names that do not start with `--`, so `states.add('radio')` throws\n *   \"The specified value 'radio' must start with '--'\".\n *\n * On both, picking a choice throws rather than registering. `attachInternals`\n * itself is unguarded throughout the interaction base classes, which puts the\n * hard support floor at Safari 16.4 — inside the range that breaks.\n *\n * The shim replaces `states` with a permissive `Set` and mirrors its contents to\n * a space-separated `data-state` attribute on the host, because these browsers'\n * CSS parsers also drop any selector list containing `:state()`. The theme's\n * built stylesheets pair every `:state(x)` with a `[data-state~='x']` arm (see\n * `tools/postcss/custom-state-fallback.mjs`), so styling survives too.\n *\n * Support is classified by behaviour rather than by browser version, and the\n * shim is not installed at all where `states` works.\n */\n\n/** A permissive `CustomStateSet` that mirrors its contents to `data-state`. */\nexport class CustomStateSetShim extends Set<string> {\n  readonly #host: HTMLElement;\n\n  constructor(host: HTMLElement) {\n    super();\n    this.#host = host;\n  }\n\n  override add(state: string): this {\n    super.add(state);\n    this.#reflect();\n    return this;\n  }\n\n  override delete(state: string): boolean {\n    const deleted = super.delete(state);\n    this.#reflect();\n    return deleted;\n  }\n\n  override clear(): void {\n    super.clear();\n    this.#reflect();\n  }\n\n  #reflect(): void {\n    // A custom element must not gain attributes while it is upgrading, so defer\n    // the write until the element is connected.\n    if (this.#host.isConnected) this.#write();\n    else queueMicrotask(() => this.#write());\n  }\n\n  #write(): void {\n    if (this.size === 0) this.#host.removeAttribute('data-state');\n    else this.#host.setAttribute('data-state', Array.from(this).join(' '));\n  }\n}\n\nexport type CustomStateSupport = 'missing' | 'legacy' | 'modern';\n\nconst PROBE_TAG = 'custom-state-support-probe';\n\n/**\n * Classify native custom-state support by behaviour:\n *\n * - `missing`: `ElementInternals` carries no `states` at all.\n * - `legacy`: `states` exists but rejects a bare name.\n * - `modern`: `states` exists and accepts a bare name — no shim wanted.\n *\n * `attachInternals` only works on a custom element, so the probe registers a\n * throwaway one. That happens solely when `states` is present, so the `missing`\n * path never defines anything.\n */\nexport function classifyCustomStateSupport(\n  attachInternals: (this: HTMLElement) => ElementInternals\n): CustomStateSupport {\n  if (!('states' in ElementInternals.prototype)) return 'missing';\n  if (typeof customElements === 'undefined') return 'modern';\n\n  try {\n    if (!customElements.get(PROBE_TAG)) customElements.define(PROBE_TAG, class extends HTMLElement {});\n    const states = attachInternals.call(document.createElement(PROBE_TAG)).states;\n    if (!states) return 'missing';\n    // A bare name throws SyntaxError under the legacy spec and never does under\n    // the current one, so classify on the throw alone — not on whether the value\n    // sticks, which some environments do not honour on a detached element.\n    states.add('probe');\n    states.delete('probe');\n    return 'modern';\n  } catch {\n    return 'legacy';\n  }\n}\n\nlet installed = false;\n\n/**\n * Patch `HTMLElement.prototype.attachInternals` so every element's `states` is\n * the shim, on the two profiles that need it. Idempotent, and a no-op where\n * native support is usable.\n *\n * Returns the classification that was acted on, which is what the tests assert.\n */\nexport function installCustomStateSetFallback(): CustomStateSupport | 'already-installed' {\n  if (installed) return 'already-installed';\n  if (typeof HTMLElement === 'undefined' || typeof ElementInternals === 'undefined') return 'modern';\n\n  const native = HTMLElement.prototype.attachInternals;\n  if (!native) return 'modern';\n\n  const support = classifyCustomStateSupport(native);\n  if (support === 'modern') return support;\n\n  installed = true;\n  HTMLElement.prototype.attachInternals = function attachInternals(this: HTMLElement): ElementInternals {\n    const internals = native.call(this);\n    Object.defineProperty(internals, 'states', {\n      configurable: true,\n      enumerable: true,\n      value: new CustomStateSetShim(this)\n    });\n    return internals;\n  };\n\n  return support;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qti-components/base",
   "description": "QTI shared utilities",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "author": "",
   "dependencies": {
     "@qti-components/utilities": "^1.3.3"