@citolab/qti-components 8.0.1 → 8.0.2

package/dist/qti-components-jsx.d.ts

@@ -29,8 +29,8 @@ import type { QtiTemplateDeclaration } from "./elements.js";
 import type { QtiItem } from "./item.js";
 import type { QtiAssessmentItemRef } from "./test.js";
 import type { QtiAssessmentSection } from "./test.js";
-import type { QtiAssessmentTest } from "./test.js";
 import type { QtiTestPart } from "./test.js";
+import type { QtiAssessmentTest } from "./test.js";
 import type { TestNavigation } from "./test.js";
 import type { TestContainer } from "./test.js";
 import type {
@@ -68,8 +68,6 @@ import type {
 } from "./test.js";
 import type { QtiSimpleAssociableChoice } from "./interactions.js";
 import type { QtiAssociateInteraction } from "./interactions.js";
-import type { QtiSimpleChoice } from "./interactions.js";
-import type { QtiChoiceInteraction } from "./interactions.js";
 import type { QtiAssociableHotspot } from "./interactions.js";
 import type { QtiGap } from "./interactions.js";
 import type { QtiGapImg } from "./interactions.js";
@@ -78,6 +76,8 @@ import type { QtiHotspotChoice } from "./interactions.js";
 import type { QtiHottext } from "./interactions.js";
 import type { QtiInlineChoice } from "./interactions.js";
 import type { QtiPrompt } from "./interactions.js";
+import type { QtiSimpleChoice } from "./interactions.js";
+import type { QtiChoiceInteraction } from "./interactions.js";
 import type { QtiCustomInteraction } from "./interactions.js";
 import type { QtiEndAttemptInteraction } from "./interactions.js";
 import type { QtiExtendedTextInteraction } from "./interactions.js";
@@ -234,7 +234,7 @@ type BaseProps<T extends HTMLElement> = {
   /** Contains a space-separated list of the part names of the element. Part names allows CSS to select and style specific elements in a shadow tree via the ::part pseudo-element. */
   part?: string;
   /** Use the ref attribute with a variable to assign a DOM element to the variable once the element is rendered. */
-  ref?: T | ((e: T) => void);
+  ref?: T | ((e: T) => void) | { current: T | null } | null;
   /** Adds a reference for a custom element slot */
   slot?: string;
   /** Prop for setting inline styles */
@@ -855,6 +855,14 @@ export type QtiAssessmentSectionProps = {
   /**  */
   keepTogether?: QtiAssessmentSection["keepTogether"];
   /**  */
+  "navigation-mode"?: QtiAssessmentSection["navigationMode"];
+  /**  */
+  navigationMode?: QtiAssessmentSection["navigationMode"];
+  /**  */
+  "submission-mode"?: QtiAssessmentSection["submissionMode"];
+  /**  */
+  submissionMode?: QtiAssessmentSection["submissionMode"];
+  /**  */
   title?: QtiAssessmentSection["title"];
   /**  */
   _testContext?: QtiAssessmentSection["_testContext"];
@@ -877,39 +885,19 @@ export type QtiAssessmentSectionSolidJsProps = {
   /**  */
   "prop:keepTogether"?: QtiAssessmentSection["keepTogether"];
   /**  */
-  "prop:title"?: QtiAssessmentSection["title"];
-  /**  */
-  "prop:_testContext"?: QtiAssessmentSection["_testContext"];
-  /**  */
-  "on:qti-assessment-section-connected"?: (e: Event) => void;
-
-  /** Set the innerHTML of the element */
-  innerHTML?: string;
-  /** Set the textContent of the element */
-  textContent?: string | number;
-};
-
-export type QtiAssessmentTestProps = {
-  /**  */
-  identifier?: QtiAssessmentTest["identifier"];
-  /**  */
-  title?: QtiAssessmentTest["title"];
+  "attr:navigation-mode"?: QtiAssessmentSection["navigationMode"];
   /**  */
-  _testContext?: QtiAssessmentTest["_testContext"];
-
+  "prop:navigationMode"?: QtiAssessmentSection["navigationMode"];
   /**  */
-  "onqti-assessment-test-connected"?: (e: CustomEvent) => void;
-};
-
-export type QtiAssessmentTestSolidJsProps = {
+  "attr:submission-mode"?: QtiAssessmentSection["submissionMode"];
   /**  */
-  "prop:identifier"?: QtiAssessmentTest["identifier"];
+  "prop:submissionMode"?: QtiAssessmentSection["submissionMode"];
   /**  */
-  "prop:title"?: QtiAssessmentTest["title"];
+  "prop:title"?: QtiAssessmentSection["title"];
   /**  */
-  "prop:_testContext"?: QtiAssessmentTest["_testContext"];
+  "prop:_testContext"?: QtiAssessmentSection["_testContext"];
   /**  */
-  "on:qti-assessment-test-connected"?: (e: CustomEvent) => void;
+  "on:qti-assessment-section-connected"?: (e: Event) => void;
 
   /** Set the innerHTML of the element */
   innerHTML?: string;
@@ -961,6 +949,34 @@ export type QtiTestPartSolidJsProps = {
   textContent?: string | number;
 };
 
+export type QtiAssessmentTestProps = {
+  /**  */
+  identifier?: QtiAssessmentTest["identifier"];
+  /**  */
+  title?: QtiAssessmentTest["title"];
+  /**  */
+  _testContext?: QtiAssessmentTest["_testContext"];
+
+  /**  */
+  "onqti-assessment-test-connected"?: (e: CustomEvent) => void;
+};
+
+export type QtiAssessmentTestSolidJsProps = {
+  /**  */
+  "prop:identifier"?: QtiAssessmentTest["identifier"];
+  /**  */
+  "prop:title"?: QtiAssessmentTest["title"];
+  /**  */
+  "prop:_testContext"?: QtiAssessmentTest["_testContext"];
+  /**  */
+  "on:qti-assessment-test-connected"?: (e: CustomEvent) => void;
+
+  /** Set the innerHTML of the element */
+  innerHTML?: string;
+  /** Set the textContent of the element */
+  textContent?: string | number;
+};
+
 export type TestNavigationProps = {
   /**  */
   identifier?: TestNavigation["identifier"];
@@ -1614,359 +1630,166 @@ export type QtiAssociateInteractionSolidJsProps = {
   textContent?: string | number;
 };
 
-export type QtiSimpleChoiceProps = {
-  /** Required. Value recorded in the response when this choice is selected, or its position when used for ordering. */
-  identifier?: QtiSimpleChoice["identifier"];
-  /** Pins this choice in place when the enclosing interaction is shuffled. */
-  fixed?: QtiSimpleChoice["fixed"];
-  /** Identifier of a template variable controlling this choice's visibility. */
-  "template-identifier"?: QtiSimpleChoice["templateIdentifier"];
-  /** Identifier of a template variable controlling this choice's visibility. */
-  templateIdentifier?: QtiSimpleChoice["templateIdentifier"];
-  /** How `template-identifier` controls visibility. */
-  "show-hide"?: QtiSimpleChoice["showHide"];
-  /** How `template-identifier` controls visibility. */
-  showHide?: QtiSimpleChoice["showHide"];
+export type QtiAssociableHotspotProps = {
   /**  */
-  tabindex?: QtiSimpleChoice["tabIndex"];
+  identifier?: QtiAssociableHotspot["identifier"];
+  /** Carries `:state(filled)` while the hotspot holds a chip. */
+  internals?: QtiAssociableHotspot["internals"];
+
   /**  */
-  tabIndex?: QtiSimpleChoice["tabIndex"];
+  "onqti-register-hotspot"?: (e: CustomEvent) => void;
+};
+
+export type QtiAssociableHotspotSolidJsProps = {
   /**  */
-  "aria-disabled"?: QtiSimpleChoice["disabled"];
+  "prop:identifier"?: QtiAssociableHotspot["identifier"];
+  /** Carries `:state(filled)` while the hotspot holds a chip. */
+  "prop:internals"?: QtiAssociableHotspot["internals"];
   /**  */
-  disabled?: QtiSimpleChoice["disabled"];
+  "on:qti-register-hotspot"?: (e: CustomEvent) => void;
+
+  /** Set the innerHTML of the element */
+  innerHTML?: string;
+  /** Set the textContent of the element */
+  textContent?: string | number;
+};
+
+export type QtiGapProps = {
+  /** Required. Value recorded as the gap side of the response pair. */
+  identifier?: QtiGap["identifier"];
+  /** How many tokens this gap can hold; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
+  "match-max"?: unknown;
+  /** How many tokens this gap can hold; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
+  undefined?: unknown;
+  /** Minimum tokens this gap must hold. */
+  "match-min"?: unknown;
+  /** Not implemented. Whether this gap must be filled for the response to be valid. */
+  required?: unknown;
+  /** Not implemented. Identifier of a template variable controlling this gap's visibility. */
+  "template-identifier"?: unknown;
+  /** Not implemented. How `template-identifier` controls visibility. */
+  "show-hide"?: unknown;
   /**  */
-  "aria-readonly"?: QtiSimpleChoice["readonly"];
+  tabindex?: QtiGap["tabindex"];
+  /** Carries `:state(filled)` while the gap holds a chip. */
+  internals?: QtiGap["internals"];
+};
+
+export type QtiGapSolidJsProps = {
+  /** Required. Value recorded as the gap side of the response pair. */
+  "prop:identifier"?: QtiGap["identifier"];
+  /** How many tokens this gap can hold; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
+  "attr:match-max"?: unknown;
+  /** How many tokens this gap can hold; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
+  "prop:undefined"?: unknown;
+  /** Minimum tokens this gap must hold. */
+  "attr:match-min"?: unknown;
+  /** Not implemented. Whether this gap must be filled for the response to be valid. */
+  "bool:required"?: unknown;
+  /** Not implemented. Identifier of a template variable controlling this gap's visibility. */
+  "attr:template-identifier"?: unknown;
+  /** Not implemented. How `template-identifier` controls visibility. */
+  "attr:show-hide"?: unknown;
   /**  */
-  readonly?: QtiSimpleChoice["readonly"];
+  "prop:tabindex"?: QtiGap["tabindex"];
+  /** Carries `:state(filled)` while the gap holds a chip. */
+  "prop:internals"?: QtiGap["internals"];
+
+  /** Set the innerHTML of the element */
+  innerHTML?: string;
+  /** Set the textContent of the element */
+  textContent?: string | number;
+};
+
+export type QtiGapImgProps = {
   /**  */
-  marker?: QtiSimpleChoice["marker"];
+  tabindex?: QtiGapImg["tabindex"];
+  /** `qti-gap-img` is a draggable chip, so it needs ElementInternals to carry the drag states
+(`dragging`, `placeholder`). It works without a shadow root.
+
+NOTE: this element never calls `super.connectedCallback()`, so Lit never enables updating
+and it has no shadow root — which makes `qti-gap-img.styles.ts` dead code. Fixing that means
+adding a `<slot>` to a `render()` first, otherwise the authored `<img>` child disappears. */
+  internals?: QtiGapImg["internals"];
+};
+
+export type QtiGapImgSolidJsProps = {
   /**  */
-  internals?: QtiSimpleChoice["internals"];
+  "prop:tabindex"?: QtiGapImg["tabindex"];
+  /** `qti-gap-img` is a draggable chip, so it needs ElementInternals to carry the drag states
+(`dragging`, `placeholder`). It works without a shadow root.
+
+NOTE: this element never calls `super.connectedCallback()`, so Lit never enables updating
+and it has no shadow root — which makes `qti-gap-img.styles.ts` dead code. Fixing that means
+adding a `<slot>` to a `render()` first, otherwise the authored `<img>` child disappears. */
+  "prop:internals"?: QtiGapImg["internals"];
+
+  /** Set the innerHTML of the element */
+  innerHTML?: string;
+  /** Set the textContent of the element */
+  textContent?: string | number;
 };
 
-export type QtiSimpleChoiceSolidJsProps = {
-  /** Required. Value recorded in the response when this choice is selected, or its position when used for ordering. */
-  "prop:identifier"?: QtiSimpleChoice["identifier"];
-  /** Pins this choice in place when the enclosing interaction is shuffled. */
-  "prop:fixed"?: QtiSimpleChoice["fixed"];
-  /** Identifier of a template variable controlling this choice's visibility. */
-  "attr:template-identifier"?: QtiSimpleChoice["templateIdentifier"];
-  /** Identifier of a template variable controlling this choice's visibility. */
-  "prop:templateIdentifier"?: QtiSimpleChoice["templateIdentifier"];
-  /** How `template-identifier` controls visibility. */
-  "attr:show-hide"?: QtiSimpleChoice["showHide"];
-  /** How `template-identifier` controls visibility. */
-  "prop:showHide"?: QtiSimpleChoice["showHide"];
+export type QtiGapTextProps = {
+  /** Required. Value recorded in the response pair when this token is placed into a gap. */
+  identifier?: QtiGapText["identifier"];
+  /** How many gaps this token may fill; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
+  "match-max"?: unknown;
+  /** How many gaps this token may fill; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
+  undefined?: unknown;
+  /** Minimum gaps this token must fill. */
+  "match-min"?: unknown;
+  /** Pins this token in place when the interaction is shuffled. */
+  fixed?: unknown;
+  /** Not implemented. Identifier of a template variable controlling this token's visibility. */
+  "template-identifier"?: unknown;
+  /** Not implemented. How `template-identifier` controls visibility. */
+  "show-hide"?: unknown;
   /**  */
-  "attr:tabindex"?: QtiSimpleChoice["tabIndex"];
+  tabindex?: QtiGapText["tabindex"];
   /**  */
-  "prop:tabIndex"?: QtiSimpleChoice["tabIndex"];
+  "aria-disabled"?: QtiGapText["disabled"];
   /**  */
-  "bool:aria-disabled"?: QtiSimpleChoice["disabled"];
+  disabled?: QtiGapText["disabled"];
   /**  */
-  "prop:disabled"?: QtiSimpleChoice["disabled"];
+  "aria-readonly"?: QtiGapText["readonly"];
   /**  */
-  "bool:aria-readonly"?: QtiSimpleChoice["readonly"];
+  readonly?: QtiGapText["readonly"];
   /**  */
-  "prop:readonly"?: QtiSimpleChoice["readonly"];
+  tabIndex?: QtiGapText["tabIndex"];
   /**  */
-  "prop:marker"?: QtiSimpleChoice["marker"];
+  internals?: QtiGapText["internals"];
+};
+
+export type QtiGapTextSolidJsProps = {
+  /** Required. Value recorded in the response pair when this token is placed into a gap. */
+  "prop:identifier"?: QtiGapText["identifier"];
+  /** How many gaps this token may fill; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
+  "attr:match-max"?: unknown;
+  /** How many gaps this token may fill; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
+  "prop:undefined"?: unknown;
+  /** Minimum gaps this token must fill. */
+  "attr:match-min"?: unknown;
+  /** Pins this token in place when the interaction is shuffled. */
+  "bool:fixed"?: unknown;
+  /** Not implemented. Identifier of a template variable controlling this token's visibility. */
+  "attr:template-identifier"?: unknown;
+  /** Not implemented. How `template-identifier` controls visibility. */
+  "attr:show-hide"?: unknown;
   /**  */
-  "prop:internals"?: QtiSimpleChoice["internals"];
-
-  /** Set the innerHTML of the element */
-  innerHTML?: string;
-  /** Set the textContent of the element */
-  textContent?: string | number;
-};
-
-export type QtiChoiceInteractionProps = {
-  /** Required. Identifier of the bound response variable. */
-  "response-identifier"?: QtiChoiceInteraction["responseIdentifier"];
-  /** Required. Identifier of the bound response variable. */
-  responseIdentifier?: QtiChoiceInteraction["responseIdentifier"];
-  /** Maximum selectable choices. `1` is a single-response item; `0` means unlimited and makes it a multiple-response item. */
-  "max-choices"?: QtiChoiceInteraction["maxChoices"];
-  /** Maximum selectable choices. `1` is a single-response item; `0` means unlimited and makes it a multiple-response item. */
-  maxChoices?: QtiChoiceInteraction["maxChoices"];
-  /** Minimum selectable choices for a valid response. */
-  "min-choices"?: QtiChoiceInteraction["minChoices"];
-  /** Minimum selectable choices for a valid response. */
-  minChoices?: QtiChoiceInteraction["minChoices"];
-  /** @deprecated , use 'qti-orientation-horizontal' or 'qti-orientation-vertical' instead - Deprecated by QTI in favour of the `qti-orientation-*` class vocabulary. */
-  orientation?: QtiChoiceInteraction["orientation"];
-  /** Requests choice shuffling. Applied by the transform pipeline (`qti-transformers`), not by this element. */
-  shuffle?: unknown;
-  /** Requests choice shuffling. Applied by the transform pipeline (`qti-transformers`), not by this element. */
-  undefined?: unknown;
-  /** QTI shared presentation vocabulary. Space-separated; takes precedence over `orientation`. */
-  class?: QtiChoiceInteraction["class"];
-  /**  */
-  response?: QtiChoiceInteraction["response"];
-  /**  */
-  disabled?: QtiChoiceInteraction["disabled"];
-  /**  */
-  readonly?: QtiChoiceInteraction["readonly"];
-  /**  */
-  name?: QtiChoiceInteraction["name"];
-  /**  */
-  value?: QtiChoiceInteraction["value"];
-  /** Delivery configuration, from the nearest provider — `qti-test` or `qti-item`.
-
-**Public so it can be assigned directly, which is the development-time route.** An interaction
-has to work standalone, and in a story or a spec there is usually no provider above it — so
-setting the field is all that is needed:
-
-    orderInteraction.configContext = { allowReorder: false, validationDisplayMode: 'none' };
-
-With no provider, nothing ever overwrites it. That is the whole contract, and its limit: where a
-provider DOES exist it re-emits on its next update and wins, because `@consume` writes this same
-field. There is no merging — set the value on the provider in that case.
-
-In a lit-html template, bind it as a property rather than assigning after the fact:
-
-    html`<qti-order-interaction .configContext=${{ allowReorder: false }}>…`
-
-The binding is committed on the detached template clone, before the fragment is inserted, so it
-is in place by `connectedCallback` — which matters for anything that reads config on connect.
-
-It was `protected`, which fooled nobody: every caller reached it anyway through an
-`as any` / `as { configContext?: … }` cast. Public says what was already true and removes the
-casts, rather than pretending at an encapsulation the type system was the only thing enforcing. */
-  configContext?: QtiChoiceInteraction["configContext"];
-
-  /**  */
-  "onqti-register-interaction"?: (e: CustomEvent) => void;
-  /**  */
-  "onqti-interaction-response"?: (e: CustomEvent) => void;
-};
-
-export type QtiChoiceInteractionSolidJsProps = {
-  /** Required. Identifier of the bound response variable. */
-  "attr:response-identifier"?: QtiChoiceInteraction["responseIdentifier"];
-  /** Required. Identifier of the bound response variable. */
-  "prop:responseIdentifier"?: QtiChoiceInteraction["responseIdentifier"];
-  /** Maximum selectable choices. `1` is a single-response item; `0` means unlimited and makes it a multiple-response item. */
-  "attr:max-choices"?: QtiChoiceInteraction["maxChoices"];
-  /** Maximum selectable choices. `1` is a single-response item; `0` means unlimited and makes it a multiple-response item. */
-  "prop:maxChoices"?: QtiChoiceInteraction["maxChoices"];
-  /** Minimum selectable choices for a valid response. */
-  "attr:min-choices"?: QtiChoiceInteraction["minChoices"];
-  /** Minimum selectable choices for a valid response. */
-  "prop:minChoices"?: QtiChoiceInteraction["minChoices"];
-  /** @deprecated , use 'qti-orientation-horizontal' or 'qti-orientation-vertical' instead - Deprecated by QTI in favour of the `qti-orientation-*` class vocabulary. */
-  "prop:orientation"?: QtiChoiceInteraction["orientation"];
-  /** Requests choice shuffling. Applied by the transform pipeline (`qti-transformers`), not by this element. */
-  "bool:shuffle"?: unknown;
-  /** Requests choice shuffling. Applied by the transform pipeline (`qti-transformers`), not by this element. */
-  "prop:undefined"?: unknown;
-  /** QTI shared presentation vocabulary. Space-separated; takes precedence over `orientation`. */
-  "prop:class"?: QtiChoiceInteraction["class"];
-  /**  */
-  "prop:response"?: QtiChoiceInteraction["response"];
-  /**  */
-  "prop:disabled"?: QtiChoiceInteraction["disabled"];
-  /**  */
-  "prop:readonly"?: QtiChoiceInteraction["readonly"];
-  /**  */
-  "prop:name"?: QtiChoiceInteraction["name"];
-  /**  */
-  "prop:value"?: QtiChoiceInteraction["value"];
-  /** Delivery configuration, from the nearest provider — `qti-test` or `qti-item`.
-
-**Public so it can be assigned directly, which is the development-time route.** An interaction
-has to work standalone, and in a story or a spec there is usually no provider above it — so
-setting the field is all that is needed:
-
-    orderInteraction.configContext = { allowReorder: false, validationDisplayMode: 'none' };
-
-With no provider, nothing ever overwrites it. That is the whole contract, and its limit: where a
-provider DOES exist it re-emits on its next update and wins, because `@consume` writes this same
-field. There is no merging — set the value on the provider in that case.
-
-In a lit-html template, bind it as a property rather than assigning after the fact:
-
-    html`<qti-order-interaction .configContext=${{ allowReorder: false }}>…`
-
-The binding is committed on the detached template clone, before the fragment is inserted, so it
-is in place by `connectedCallback` — which matters for anything that reads config on connect.
-
-It was `protected`, which fooled nobody: every caller reached it anyway through an
-`as any` / `as { configContext?: … }` cast. Public says what was already true and removes the
-casts, rather than pretending at an encapsulation the type system was the only thing enforcing. */
-  "prop:configContext"?: QtiChoiceInteraction["configContext"];
-  /**  */
-  "on:qti-register-interaction"?: (e: CustomEvent) => void;
-  /**  */
-  "on:qti-interaction-response"?: (e: CustomEvent) => void;
-
-  /** Set the innerHTML of the element */
-  innerHTML?: string;
-  /** Set the textContent of the element */
-  textContent?: string | number;
-};
-
-export type QtiAssociableHotspotProps = {
-  /**  */
-  identifier?: QtiAssociableHotspot["identifier"];
-  /** Carries `:state(filled)` while the hotspot holds a chip. */
-  internals?: QtiAssociableHotspot["internals"];
-
-  /**  */
-  "onqti-register-hotspot"?: (e: CustomEvent) => void;
-};
-
-export type QtiAssociableHotspotSolidJsProps = {
-  /**  */
-  "prop:identifier"?: QtiAssociableHotspot["identifier"];
-  /** Carries `:state(filled)` while the hotspot holds a chip. */
-  "prop:internals"?: QtiAssociableHotspot["internals"];
-  /**  */
-  "on:qti-register-hotspot"?: (e: CustomEvent) => void;
-
-  /** Set the innerHTML of the element */
-  innerHTML?: string;
-  /** Set the textContent of the element */
-  textContent?: string | number;
-};
-
-export type QtiGapProps = {
-  /** Required. Value recorded as the gap side of the response pair. */
-  identifier?: QtiGap["identifier"];
-  /** How many tokens this gap can hold; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
-  "match-max"?: unknown;
-  /** How many tokens this gap can hold; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
-  undefined?: unknown;
-  /** Minimum tokens this gap must hold. */
-  "match-min"?: unknown;
-  /** Not implemented. Whether this gap must be filled for the response to be valid. */
-  required?: unknown;
-  /** Not implemented. Identifier of a template variable controlling this gap's visibility. */
-  "template-identifier"?: unknown;
-  /** Not implemented. How `template-identifier` controls visibility. */
-  "show-hide"?: unknown;
-  /**  */
-  tabindex?: QtiGap["tabindex"];
-  /** Carries `:state(filled)` while the gap holds a chip. */
-  internals?: QtiGap["internals"];
-};
-
-export type QtiGapSolidJsProps = {
-  /** Required. Value recorded as the gap side of the response pair. */
-  "prop:identifier"?: QtiGap["identifier"];
-  /** How many tokens this gap can hold; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
-  "attr:match-max"?: unknown;
-  /** How many tokens this gap can hold; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
-  "prop:undefined"?: unknown;
-  /** Minimum tokens this gap must hold. */
-  "attr:match-min"?: unknown;
-  /** Not implemented. Whether this gap must be filled for the response to be valid. */
-  "bool:required"?: unknown;
-  /** Not implemented. Identifier of a template variable controlling this gap's visibility. */
-  "attr:template-identifier"?: unknown;
-  /** Not implemented. How `template-identifier` controls visibility. */
-  "attr:show-hide"?: unknown;
-  /**  */
-  "prop:tabindex"?: QtiGap["tabindex"];
-  /** Carries `:state(filled)` while the gap holds a chip. */
-  "prop:internals"?: QtiGap["internals"];
-
-  /** Set the innerHTML of the element */
-  innerHTML?: string;
-  /** Set the textContent of the element */
-  textContent?: string | number;
-};
-
-export type QtiGapImgProps = {
-  /**  */
-  tabindex?: QtiGapImg["tabindex"];
-  /** `qti-gap-img` is a draggable chip, so it needs ElementInternals to carry the drag states
-(`dragging`, `placeholder`). It works without a shadow root.
-
-NOTE: this element never calls `super.connectedCallback()`, so Lit never enables updating
-and it has no shadow root — which makes `qti-gap-img.styles.ts` dead code. Fixing that means
-adding a `<slot>` to a `render()` first, otherwise the authored `<img>` child disappears. */
-  internals?: QtiGapImg["internals"];
-};
-
-export type QtiGapImgSolidJsProps = {
-  /**  */
-  "prop:tabindex"?: QtiGapImg["tabindex"];
-  /** `qti-gap-img` is a draggable chip, so it needs ElementInternals to carry the drag states
-(`dragging`, `placeholder`). It works without a shadow root.
-
-NOTE: this element never calls `super.connectedCallback()`, so Lit never enables updating
-and it has no shadow root — which makes `qti-gap-img.styles.ts` dead code. Fixing that means
-adding a `<slot>` to a `render()` first, otherwise the authored `<img>` child disappears. */
-  "prop:internals"?: QtiGapImg["internals"];
-
-  /** Set the innerHTML of the element */
-  innerHTML?: string;
-  /** Set the textContent of the element */
-  textContent?: string | number;
-};
-
-export type QtiGapTextProps = {
-  /** Required. Value recorded in the response pair when this token is placed into a gap. */
-  identifier?: QtiGapText["identifier"];
-  /** How many gaps this token may fill; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
-  "match-max"?: unknown;
-  /** How many gaps this token may fill; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
-  undefined?: unknown;
-  /** Minimum gaps this token must fill. */
-  "match-min"?: unknown;
-  /** Pins this token in place when the interaction is shuffled. */
-  fixed?: unknown;
-  /** Not implemented. Identifier of a template variable controlling this token's visibility. */
-  "template-identifier"?: unknown;
-  /** Not implemented. How `template-identifier` controls visibility. */
-  "show-hide"?: unknown;
-  /**  */
-  tabindex?: QtiGapText["tabindex"];
-  /**  */
-  "aria-disabled"?: QtiGapText["disabled"];
-  /**  */
-  disabled?: QtiGapText["disabled"];
-  /**  */
-  "aria-readonly"?: QtiGapText["readonly"];
-  /**  */
-  readonly?: QtiGapText["readonly"];
-  /**  */
-  tabIndex?: QtiGapText["tabIndex"];
-  /**  */
-  internals?: QtiGapText["internals"];
-};
-
-export type QtiGapTextSolidJsProps = {
-  /** Required. Value recorded in the response pair when this token is placed into a gap. */
-  "prop:identifier"?: QtiGapText["identifier"];
-  /** How many gaps this token may fill; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
-  "attr:match-max"?: unknown;
-  /** How many gaps this token may fill; `0` means unlimited. Read from the DOM by the drag-drop mixin. */
-  "prop:undefined"?: unknown;
-  /** Minimum gaps this token must fill. */
-  "attr:match-min"?: unknown;
-  /** Pins this token in place when the interaction is shuffled. */
-  "bool:fixed"?: unknown;
-  /** Not implemented. Identifier of a template variable controlling this token's visibility. */
-  "attr:template-identifier"?: unknown;
-  /** Not implemented. How `template-identifier` controls visibility. */
-  "attr:show-hide"?: unknown;
-  /**  */
-  "prop:tabindex"?: QtiGapText["tabindex"];
-  /**  */
-  "bool:aria-disabled"?: QtiGapText["disabled"];
-  /**  */
-  "prop:disabled"?: QtiGapText["disabled"];
-  /**  */
-  "bool:aria-readonly"?: QtiGapText["readonly"];
-  /**  */
-  "prop:readonly"?: QtiGapText["readonly"];
-  /**  */
-  "prop:tabIndex"?: QtiGapText["tabIndex"];
-  /**  */
-  "prop:internals"?: QtiGapText["internals"];
+  "prop:tabindex"?: QtiGapText["tabindex"];
+  /**  */
+  "bool:aria-disabled"?: QtiGapText["disabled"];
+  /**  */
+  "prop:disabled"?: QtiGapText["disabled"];
+  /**  */
+  "bool:aria-readonly"?: QtiGapText["readonly"];
+  /**  */
+  "prop:readonly"?: QtiGapText["readonly"];
+  /**  */
+  "prop:tabIndex"?: QtiGapText["tabIndex"];
+  /**  */
+  "prop:internals"?: QtiGapText["internals"];
 
   /** Set the innerHTML of the element */
   innerHTML?: string;
@@ -2132,25 +1955,218 @@ export type QtiInlineChoiceSolidJsProps = {
   /**  */
   "prop:disabled"?: QtiInlineChoice["disabled"];
   /**  */
-  "bool:aria-readonly"?: QtiInlineChoice["readonly"];
+  "bool:aria-readonly"?: QtiInlineChoice["readonly"];
+  /**  */
+  "prop:readonly"?: QtiInlineChoice["readonly"];
+  /**  */
+  "prop:internals"?: QtiInlineChoice["internals"];
+  /**  */
+  "on:qti-inline-choice-register"?: (e: CustomEvent) => void;
+  /**  */
+  "on:qti-inline-choice-select"?: (e: CustomEvent) => void;
+
+  /** Set the innerHTML of the element */
+  innerHTML?: string;
+  /** Set the textContent of the element */
+  textContent?: string | number;
+};
+
+export type QtiPromptProps = {};
+
+export type QtiPromptSolidJsProps = {
+  /** Set the innerHTML of the element */
+  innerHTML?: string;
+  /** Set the textContent of the element */
+  textContent?: string | number;
+};
+
+export type QtiSimpleChoiceProps = {
+  /** Required. Value recorded in the response when this choice is selected, or its position when used for ordering. */
+  identifier?: QtiSimpleChoice["identifier"];
+  /** Pins this choice in place when the enclosing interaction is shuffled. */
+  fixed?: QtiSimpleChoice["fixed"];
+  /** Identifier of a template variable controlling this choice's visibility. */
+  "template-identifier"?: QtiSimpleChoice["templateIdentifier"];
+  /** Identifier of a template variable controlling this choice's visibility. */
+  templateIdentifier?: QtiSimpleChoice["templateIdentifier"];
+  /** How `template-identifier` controls visibility. */
+  "show-hide"?: QtiSimpleChoice["showHide"];
+  /** How `template-identifier` controls visibility. */
+  showHide?: QtiSimpleChoice["showHide"];
+  /**  */
+  tabindex?: QtiSimpleChoice["tabIndex"];
+  /**  */
+  tabIndex?: QtiSimpleChoice["tabIndex"];
+  /**  */
+  "aria-disabled"?: QtiSimpleChoice["disabled"];
+  /**  */
+  disabled?: QtiSimpleChoice["disabled"];
+  /**  */
+  "aria-readonly"?: QtiSimpleChoice["readonly"];
+  /**  */
+  readonly?: QtiSimpleChoice["readonly"];
+  /**  */
+  marker?: QtiSimpleChoice["marker"];
+  /**  */
+  internals?: QtiSimpleChoice["internals"];
+};
+
+export type QtiSimpleChoiceSolidJsProps = {
+  /** Required. Value recorded in the response when this choice is selected, or its position when used for ordering. */
+  "prop:identifier"?: QtiSimpleChoice["identifier"];
+  /** Pins this choice in place when the enclosing interaction is shuffled. */
+  "prop:fixed"?: QtiSimpleChoice["fixed"];
+  /** Identifier of a template variable controlling this choice's visibility. */
+  "attr:template-identifier"?: QtiSimpleChoice["templateIdentifier"];
+  /** Identifier of a template variable controlling this choice's visibility. */
+  "prop:templateIdentifier"?: QtiSimpleChoice["templateIdentifier"];
+  /** How `template-identifier` controls visibility. */
+  "attr:show-hide"?: QtiSimpleChoice["showHide"];
+  /** How `template-identifier` controls visibility. */
+  "prop:showHide"?: QtiSimpleChoice["showHide"];
+  /**  */
+  "attr:tabindex"?: QtiSimpleChoice["tabIndex"];
+  /**  */
+  "prop:tabIndex"?: QtiSimpleChoice["tabIndex"];
+  /**  */
+  "bool:aria-disabled"?: QtiSimpleChoice["disabled"];
+  /**  */
+  "prop:disabled"?: QtiSimpleChoice["disabled"];
+  /**  */
+  "bool:aria-readonly"?: QtiSimpleChoice["readonly"];
+  /**  */
+  "prop:readonly"?: QtiSimpleChoice["readonly"];
+  /**  */
+  "prop:marker"?: QtiSimpleChoice["marker"];
+  /**  */
+  "prop:internals"?: QtiSimpleChoice["internals"];
+
+  /** Set the innerHTML of the element */
+  innerHTML?: string;
+  /** Set the textContent of the element */
+  textContent?: string | number;
+};
+
+export type QtiChoiceInteractionProps = {
+  /** Required. Identifier of the bound response variable. */
+  "response-identifier"?: QtiChoiceInteraction["responseIdentifier"];
+  /** Required. Identifier of the bound response variable. */
+  responseIdentifier?: QtiChoiceInteraction["responseIdentifier"];
+  /** Maximum selectable choices. `1` is a single-response item; `0` means unlimited and makes it a multiple-response item. */
+  "max-choices"?: QtiChoiceInteraction["maxChoices"];
+  /** Maximum selectable choices. `1` is a single-response item; `0` means unlimited and makes it a multiple-response item. */
+  maxChoices?: QtiChoiceInteraction["maxChoices"];
+  /** Minimum selectable choices for a valid response. */
+  "min-choices"?: QtiChoiceInteraction["minChoices"];
+  /** Minimum selectable choices for a valid response. */
+  minChoices?: QtiChoiceInteraction["minChoices"];
+  /** @deprecated , use 'qti-orientation-horizontal' or 'qti-orientation-vertical' instead - Deprecated by QTI in favour of the `qti-orientation-*` class vocabulary. */
+  orientation?: QtiChoiceInteraction["orientation"];
+  /** Requests choice shuffling. Applied by the transform pipeline (`qti-transformers`), not by this element. */
+  shuffle?: unknown;
+  /** Requests choice shuffling. Applied by the transform pipeline (`qti-transformers`), not by this element. */
+  undefined?: unknown;
+  /** QTI shared presentation vocabulary. Space-separated; takes precedence over `orientation`. */
+  class?: QtiChoiceInteraction["class"];
+  /**  */
+  response?: QtiChoiceInteraction["response"];
+  /**  */
+  disabled?: QtiChoiceInteraction["disabled"];
+  /**  */
+  readonly?: QtiChoiceInteraction["readonly"];
+  /**  */
+  name?: QtiChoiceInteraction["name"];
+  /**  */
+  value?: QtiChoiceInteraction["value"];
+  /** Delivery configuration, from the nearest provider — `qti-test` or `qti-item`.
+
+**Public so it can be assigned directly, which is the development-time route.** An interaction
+has to work standalone, and in a story or a spec there is usually no provider above it — so
+setting the field is all that is needed:
+
+    orderInteraction.configContext = { allowReorder: false, validationDisplayMode: 'none' };
+
+With no provider, nothing ever overwrites it. That is the whole contract, and its limit: where a
+provider DOES exist it re-emits on its next update and wins, because `@consume` writes this same
+field. There is no merging — set the value on the provider in that case.
+
+In a lit-html template, bind it as a property rather than assigning after the fact:
+
+    html`<qti-order-interaction .configContext=${{ allowReorder: false }}>…`
+
+The binding is committed on the detached template clone, before the fragment is inserted, so it
+is in place by `connectedCallback` — which matters for anything that reads config on connect.
+
+It was `protected`, which fooled nobody: every caller reached it anyway through an
+`as any` / `as { configContext?: … }` cast. Public says what was already true and removes the
+casts, rather than pretending at an encapsulation the type system was the only thing enforcing. */
+  configContext?: QtiChoiceInteraction["configContext"];
+
+  /**  */
+  "onqti-register-interaction"?: (e: CustomEvent) => void;
+  /**  */
+  "onqti-interaction-response"?: (e: CustomEvent) => void;
+};
+
+export type QtiChoiceInteractionSolidJsProps = {
+  /** Required. Identifier of the bound response variable. */
+  "attr:response-identifier"?: QtiChoiceInteraction["responseIdentifier"];
+  /** Required. Identifier of the bound response variable. */
+  "prop:responseIdentifier"?: QtiChoiceInteraction["responseIdentifier"];
+  /** Maximum selectable choices. `1` is a single-response item; `0` means unlimited and makes it a multiple-response item. */
+  "attr:max-choices"?: QtiChoiceInteraction["maxChoices"];
+  /** Maximum selectable choices. `1` is a single-response item; `0` means unlimited and makes it a multiple-response item. */
+  "prop:maxChoices"?: QtiChoiceInteraction["maxChoices"];
+  /** Minimum selectable choices for a valid response. */
+  "attr:min-choices"?: QtiChoiceInteraction["minChoices"];
+  /** Minimum selectable choices for a valid response. */
+  "prop:minChoices"?: QtiChoiceInteraction["minChoices"];
+  /** @deprecated , use 'qti-orientation-horizontal' or 'qti-orientation-vertical' instead - Deprecated by QTI in favour of the `qti-orientation-*` class vocabulary. */
+  "prop:orientation"?: QtiChoiceInteraction["orientation"];
+  /** Requests choice shuffling. Applied by the transform pipeline (`qti-transformers`), not by this element. */
+  "bool:shuffle"?: unknown;
+  /** Requests choice shuffling. Applied by the transform pipeline (`qti-transformers`), not by this element. */
+  "prop:undefined"?: unknown;
+  /** QTI shared presentation vocabulary. Space-separated; takes precedence over `orientation`. */
+  "prop:class"?: QtiChoiceInteraction["class"];
+  /**  */
+  "prop:response"?: QtiChoiceInteraction["response"];
   /**  */
-  "prop:readonly"?: QtiInlineChoice["readonly"];
+  "prop:disabled"?: QtiChoiceInteraction["disabled"];
   /**  */
-  "prop:internals"?: QtiInlineChoice["internals"];
+  "prop:readonly"?: QtiChoiceInteraction["readonly"];
   /**  */
-  "on:qti-inline-choice-register"?: (e: CustomEvent) => void;
+  "prop:name"?: QtiChoiceInteraction["name"];
   /**  */
-  "on:qti-inline-choice-select"?: (e: CustomEvent) => void;
+  "prop:value"?: QtiChoiceInteraction["value"];
+  /** Delivery configuration, from the nearest provider — `qti-test` or `qti-item`.
 
-  /** Set the innerHTML of the element */
-  innerHTML?: string;
-  /** Set the textContent of the element */
-  textContent?: string | number;
-};
+**Public so it can be assigned directly, which is the development-time route.** An interaction
+has to work standalone, and in a story or a spec there is usually no provider above it — so
+setting the field is all that is needed:
 
-export type QtiPromptProps = {};
+    orderInteraction.configContext = { allowReorder: false, validationDisplayMode: 'none' };
+
+With no provider, nothing ever overwrites it. That is the whole contract, and its limit: where a
+provider DOES exist it re-emits on its next update and wins, because `@consume` writes this same
+field. There is no merging — set the value on the provider in that case.
+
+In a lit-html template, bind it as a property rather than assigning after the fact:
+
+    html`<qti-order-interaction .configContext=${{ allowReorder: false }}>…`
+
+The binding is committed on the detached template clone, before the fragment is inserted, so it
+is in place by `connectedCallback` — which matters for anything that reads config on connect.
+
+It was `protected`, which fooled nobody: every caller reached it anyway through an
+`as any` / `as { configContext?: … }` cast. Public says what was already true and removes the
+casts, rather than pretending at an encapsulation the type system was the only thing enforcing. */
+  "prop:configContext"?: QtiChoiceInteraction["configContext"];
+  /**  */
+  "on:qti-register-interaction"?: (e: CustomEvent) => void;
+  /**  */
+  "on:qti-interaction-response"?: (e: CustomEvent) => void;
 
-export type QtiPromptSolidJsProps = {
   /** Set the innerHTML of the element */
   innerHTML?: string;
   /** Set the textContent of the element */
@@ -6314,6 +6330,8 @@ export type CustomElements = {
    * - `fixed`: undefined
    * - `visible`: undefined
    * - `keep-together`/`keepTogether`: undefined
+   * - `navigation-mode`/`navigationMode`: undefined
+   * - `submission-mode`/`submissionMode`: undefined
    * - `title`: undefined (property only)
    * - `_testContext`: undefined (property only)
    *
@@ -6335,17 +6353,19 @@ export type CustomElements = {
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
    * - `identifier`: undefined
-   * - `title`: undefined
-   * - `_testContext`: undefined (property only)
+   * - `class`: undefined
+   * - `navigation-mode`/`navigationMode`: undefined
+   * - `submission-mode`/`submissionMode`: undefined
+   * - `title`: undefined (property only)
    *
    * ## Events
    *
    * Events that will be emitted by the component.
    *
-   * - `qti-assessment-test-connected`: undefined
+   * - `qti-test-part-connected`: undefined
    */
-  "qti-assessment-test": Partial<
-    QtiAssessmentTestProps & BaseProps<QtiAssessmentTest> & BaseEvents
+  "qti-test-part": Partial<
+    QtiTestPartProps & BaseProps<QtiTestPart> & BaseEvents
   >;
 
   /**
@@ -6356,19 +6376,17 @@ export type CustomElements = {
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
    * - `identifier`: undefined
-   * - `class`: undefined
-   * - `navigation-mode`/`navigationMode`: undefined
-   * - `submission-mode`/`submissionMode`: undefined
-   * - `title`: undefined (property only)
+   * - `title`: undefined
+   * - `_testContext`: undefined (property only)
    *
    * ## Events
    *
    * Events that will be emitted by the component.
    *
-   * - `qti-test-part-connected`: undefined
+   * - `qti-assessment-test-connected`: undefined
    */
-  "qti-test-part": Partial<
-    QtiTestPartProps & BaseProps<QtiTestPart> & BaseEvents
+  "qti-assessment-test": Partial<
+    QtiAssessmentTestProps & BaseProps<QtiAssessmentTest> & BaseEvents
   >;
 
   /**
@@ -7044,134 +7062,6 @@ export type CustomElements = {
       BaseEvents
   >;
 
-  /**
-   * A choice, used by `qti-choice-interaction` and `qti-order-interaction`.
-   *
-   * The `control` part is one box whose *role* is carried by state, not by its name: a radio
-   * circle under `:state(radio)`, a checkbox square under `:state(checkbox)`, and a drag grip
-   * when the choice is draggable. Style it as `qti-simple-choice::part(control)`.
-   *
-   * ## Attributes & Properties
-   *
-   * Component attributes and properties that can be applied to the element or by using JavaScript.
-   *
-   * - `identifier`: Required. Value recorded in the response when this choice is selected, or its position when used for ordering.
-   * - `fixed`: Pins this choice in place when the enclosing interaction is shuffled.
-   * - `template-identifier`/`templateIdentifier`: Identifier of a template variable controlling this choice's visibility.
-   * - `show-hide`/`showHide`: How `template-identifier` controls visibility.
-   * - `tabindex`/`tabIndex`: undefined
-   * - `aria-disabled`/`disabled`: undefined
-   * - `aria-readonly`/`readonly`: undefined
-   * - `marker`: undefined (property only)
-   * - `checked`: undefined (property only) (readonly)
-   * - `internals`: undefined (property only)
-   *
-   * ## Events
-   *
-   * Events that will be emitted by the component.
-   *
-   * - `undefined`: undefined
-   *
-   * ## Methods
-   *
-   * Methods that can be called to access component functionality.
-   *
-   * - `handleDisabledChange(_oldValue: boolean, disabled: boolean) => void`: undefined
-   * - `handleReadonlyChange(_oldValue: boolean, readonly: boolean) => void`: undefined
-   *
-   * ## CSS Parts
-   *
-   * Custom selectors for styling elements within the component.
-   *
-   * - `control`: The box before the label (radio / checkbox / drag grip).
-   * - `control-mark`: The mark inside the box (inner dot / checkmark).
-   * - `label`: The default slot holding the choice content.
-   * - `marker`: The order-number badge, when `marker` is set.
-   */
-  "qti-simple-choice": Partial<
-    QtiSimpleChoiceProps & BaseProps<QtiSimpleChoice> & BaseEvents
-  >;
-
-  /**
-   * A single-response or multiple-response choice interaction.
-   *
-   * ## Attributes & Properties
-   *
-   * Component attributes and properties that can be applied to the element or by using JavaScript.
-   *
-   * - `response-identifier`/`responseIdentifier`: Required. Identifier of the bound response variable.
-   * - `max-choices`/`maxChoices`: Maximum selectable choices. `1` is a single-response item; `0` means unlimited and makes it a multiple-response item.
-   * - `min-choices`/`minChoices`: Minimum selectable choices for a valid response.
-   * - `orientation`: Deprecated by QTI in favour of the `qti-orientation-*` class vocabulary.
-   * - `shuffle`/`undefined`: Requests choice shuffling. Applied by the transform pipeline (`qti-transformers`), not by this element.
-   * - `class`: QTI shared presentation vocabulary. Space-separated; takes precedence over `orientation`.
-   * - `response`: undefined
-   * - `disabled`: undefined
-   * - `readonly`: undefined
-   * - `name`: undefined
-   * - `value`: undefined (property only)
-   * - `configContext`: Delivery configuration, from the nearest provider — `qti-test` or `qti-item`.
-   *
-   * **Public so it can be assigned directly, which is the development-time route.** An interaction
-   * has to work standalone, and in a story or a spec there is usually no provider above it — so
-   * setting the field is all that is needed:
-   *
-   *     orderInteraction.configContext = { allowReorder: false, validationDisplayMode: 'none' };
-   *
-   * With no provider, nothing ever overwrites it. That is the whole contract, and its limit: where a
-   * provider DOES exist it re-emits on its next update and wins, because `@consume` writes this same
-   * field. There is no merging — set the value on the provider in that case.
-   *
-   * In a lit-html template, bind it as a property rather than assigning after the fact:
-   *
-   *     html`<qti-order-interaction .configContext=${{ allowReorder: false }}>…`
-   *
-   * The binding is committed on the detached template clone, before the fragment is inserted, so it
-   * is in place by `connectedCallback` — which matters for anything that reads config on connect.
-   *
-   * It was `protected`, which fooled nobody: every caller reached it anyway through an
-   * `as any` / `as { configContext?: … }` cast. Public says what was already true and removes the
-   * casts, rather than pretending at an encapsulation the type system was the only thing enforcing. (property only)
-   * - `internals`: undefined (property only) (readonly)
-   * - `isInline`: undefined (property only) (readonly)
-   * - `responseVariable`: undefined (property only) (readonly)
-   *
-   * ## Events
-   *
-   * Events that will be emitted by the component.
-   *
-   * - `qti-register-interaction`: undefined
-   * - `qti-interaction-response`: undefined
-   *
-   * ## Slots
-   *
-   * Areas where markup can be added to the component.
-   *
-   * - `prompt`: The prompt shown above the choices.
-   * - `(default)`: Default slot for `qti-simple-choice` elements.
-   *
-   * ## Methods
-   *
-   * Methods that can be called to access component functionality.
-   *
-   * - `validate() => boolean`: undefined
-   * - `reportValidity() => boolean`: undefined
-   * - `reset() => void`: undefined
-   * - `formResetCallback() => void`: undefined
-   * - `saveResponse(value: string | string[], state?: string | null) => void`: undefined
-   *
-   * ## CSS Parts
-   *
-   * Custom selectors for styling elements within the component.
-   *
-   * - `prompt`: Wrapper around the prompt slot.
-   * - `slot`: Wrapper around the default slot containing the choices.
-   * - `message`: Live validation message region (role="alert").
-   */
-  "qti-choice-interaction": Partial<
-    QtiChoiceInteractionProps & BaseProps<QtiChoiceInteraction> & BaseEvents
-  >;
-
   /**
    * A drop target positioned over an image. Like `qti-gap`, it renders the chips it holds from
    * `dragDropContext` rather than having them appended into it.
@@ -7315,23 +7205,100 @@ export type CustomElements = {
    * - `handleDisabledChange(_oldValue: boolean, disabled: boolean) => void`: undefined
    * - `handleReadonlyChange(_oldValue: boolean, readonly: boolean) => void`: undefined
    */
-  "qti-hotspot-choice": Partial<
-    QtiHotspotChoiceProps & BaseProps<QtiHotspotChoice> & BaseEvents
+  "qti-hotspot-choice": Partial<
+    QtiHotspotChoiceProps & BaseProps<QtiHotspotChoice> & BaseEvents
+  >;
+
+  /**
+   * A selectable span of text inside `qti-hottext-interaction`.
+   *
+   * ## Attributes & Properties
+   *
+   * Component attributes and properties that can be applied to the element or by using JavaScript.
+   *
+   * - `identifier`: Required. Value recorded in the response when this span is selected.
+   * - `template-identifier`/`undefined`: Not implemented. Identifier of a template variable controlling this span's visibility.
+   * - `show-hide`/`undefined`: Not implemented. How `template-identifier` controls visibility.
+   * - `tabindex`/`tabIndex`: undefined
+   * - `aria-disabled`/`disabled`: undefined
+   * - `aria-readonly`/`readonly`: undefined
+   * - `internals`: undefined (property only)
+   *
+   * ## Events
+   *
+   * Events that will be emitted by the component.
+   *
+   * - `undefined`: undefined
+   *
+   * ## Methods
+   *
+   * Methods that can be called to access component functionality.
+   *
+   * - `handleDisabledChange(_oldValue: boolean, disabled: boolean) => void`: undefined
+   * - `handleReadonlyChange(_oldValue: boolean, readonly: boolean) => void`: undefined
+   */
+  "qti-hottext": Partial<QtiHottextProps & BaseProps<QtiHottext> & BaseEvents>;
+
+  /**
+   * An option in the dropdown of `qti-inline-choice-interaction`.
+   *
+   * ## Attributes & Properties
+   *
+   * Component attributes and properties that can be applied to the element or by using JavaScript.
+   *
+   * - `identifier`: Required. Value recorded in the response when this option is selected.
+   * - `fixed`/`undefined`: Pins this option in place when the interaction is shuffled.
+   * - `template-identifier`/`undefined`: Not implemented. Identifier of a template variable controlling this option's visibility.
+   * - `show-hide`/`undefined`: Not implemented. How `template-identifier` controls visibility.
+   * - `tabindex`/`tabIndex`: undefined
+   * - `aria-disabled`/`disabled`: undefined
+   * - `aria-readonly`/`readonly`: undefined
+   * - `internals`: undefined (property only)
+   *
+   * ## Events
+   *
+   * Events that will be emitted by the component.
+   *
+   * - `qti-inline-choice-register`: undefined
+   * - `qti-inline-choice-select`: undefined
+   * - `undefined`: undefined
+   *
+   * ## Methods
+   *
+   * Methods that can be called to access component functionality.
+   *
+   * - `handleDisabledChange(_oldValue: boolean, disabled: boolean) => void`: undefined
+   * - `handleReadonlyChange(_oldValue: boolean, readonly: boolean) => void`: undefined
+   */
+  "qti-inline-choice": Partial<
+    QtiInlineChoiceProps & BaseProps<QtiInlineChoice> & BaseEvents
   >;
 
   /**
-   * A selectable span of text inside `qti-hottext-interaction`.
+   *
+   */
+  "qti-prompt": Partial<QtiPromptProps & BaseProps<QtiPrompt> & BaseEvents>;
+
+  /**
+   * A choice, used by `qti-choice-interaction` and `qti-order-interaction`.
+   *
+   * The `control` part is one box whose *role* is carried by state, not by its name: a radio
+   * circle under `:state(radio)`, a checkbox square under `:state(checkbox)`, and a drag grip
+   * when the choice is draggable. Style it as `qti-simple-choice::part(control)`.
    *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `identifier`: Required. Value recorded in the response when this span is selected.
-   * - `template-identifier`/`undefined`: Not implemented. Identifier of a template variable controlling this span's visibility.
-   * - `show-hide`/`undefined`: Not implemented. How `template-identifier` controls visibility.
+   * - `identifier`: Required. Value recorded in the response when this choice is selected, or its position when used for ordering.
+   * - `fixed`: Pins this choice in place when the enclosing interaction is shuffled.
+   * - `template-identifier`/`templateIdentifier`: Identifier of a template variable controlling this choice's visibility.
+   * - `show-hide`/`showHide`: How `template-identifier` controls visibility.
    * - `tabindex`/`tabIndex`: undefined
    * - `aria-disabled`/`disabled`: undefined
    * - `aria-readonly`/`readonly`: undefined
+   * - `marker`: undefined (property only)
+   * - `checked`: undefined (property only) (readonly)
    * - `internals`: undefined (property only)
    *
    * ## Events
@@ -7346,48 +7313,99 @@ export type CustomElements = {
    *
    * - `handleDisabledChange(_oldValue: boolean, disabled: boolean) => void`: undefined
    * - `handleReadonlyChange(_oldValue: boolean, readonly: boolean) => void`: undefined
+   *
+   * ## CSS Parts
+   *
+   * Custom selectors for styling elements within the component.
+   *
+   * - `control`: The box before the label (radio / checkbox / drag grip).
+   * - `control-mark`: The mark inside the box (inner dot / checkmark).
+   * - `label`: The default slot holding the choice content.
+   * - `marker`: The order-number badge, when `marker` is set.
    */
-  "qti-hottext": Partial<QtiHottextProps & BaseProps<QtiHottext> & BaseEvents>;
+  "qti-simple-choice": Partial<
+    QtiSimpleChoiceProps & BaseProps<QtiSimpleChoice> & BaseEvents
+  >;
 
   /**
-   * An option in the dropdown of `qti-inline-choice-interaction`.
+   * A single-response or multiple-response choice interaction.
    *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `identifier`: Required. Value recorded in the response when this option is selected.
-   * - `fixed`/`undefined`: Pins this option in place when the interaction is shuffled.
-   * - `template-identifier`/`undefined`: Not implemented. Identifier of a template variable controlling this option's visibility.
-   * - `show-hide`/`undefined`: Not implemented. How `template-identifier` controls visibility.
-   * - `tabindex`/`tabIndex`: undefined
-   * - `aria-disabled`/`disabled`: undefined
-   * - `aria-readonly`/`readonly`: undefined
-   * - `internals`: undefined (property only)
+   * - `response-identifier`/`responseIdentifier`: Required. Identifier of the bound response variable.
+   * - `max-choices`/`maxChoices`: Maximum selectable choices. `1` is a single-response item; `0` means unlimited and makes it a multiple-response item.
+   * - `min-choices`/`minChoices`: Minimum selectable choices for a valid response.
+   * - `orientation`: Deprecated by QTI in favour of the `qti-orientation-*` class vocabulary.
+   * - `shuffle`/`undefined`: Requests choice shuffling. Applied by the transform pipeline (`qti-transformers`), not by this element.
+   * - `class`: QTI shared presentation vocabulary. Space-separated; takes precedence over `orientation`.
+   * - `response`: undefined
+   * - `disabled`: undefined
+   * - `readonly`: undefined
+   * - `name`: undefined
+   * - `value`: undefined (property only)
+   * - `configContext`: Delivery configuration, from the nearest provider — `qti-test` or `qti-item`.
+   *
+   * **Public so it can be assigned directly, which is the development-time route.** An interaction
+   * has to work standalone, and in a story or a spec there is usually no provider above it — so
+   * setting the field is all that is needed:
+   *
+   *     orderInteraction.configContext = { allowReorder: false, validationDisplayMode: 'none' };
+   *
+   * With no provider, nothing ever overwrites it. That is the whole contract, and its limit: where a
+   * provider DOES exist it re-emits on its next update and wins, because `@consume` writes this same
+   * field. There is no merging — set the value on the provider in that case.
+   *
+   * In a lit-html template, bind it as a property rather than assigning after the fact:
+   *
+   *     html`<qti-order-interaction .configContext=${{ allowReorder: false }}>…`
+   *
+   * The binding is committed on the detached template clone, before the fragment is inserted, so it
+   * is in place by `connectedCallback` — which matters for anything that reads config on connect.
+   *
+   * It was `protected`, which fooled nobody: every caller reached it anyway through an
+   * `as any` / `as { configContext?: … }` cast. Public says what was already true and removes the
+   * casts, rather than pretending at an encapsulation the type system was the only thing enforcing. (property only)
+   * - `internals`: undefined (property only) (readonly)
+   * - `isInline`: undefined (property only) (readonly)
+   * - `responseVariable`: undefined (property only) (readonly)
    *
    * ## Events
    *
    * Events that will be emitted by the component.
    *
-   * - `qti-inline-choice-register`: undefined
-   * - `qti-inline-choice-select`: undefined
-   * - `undefined`: undefined
+   * - `qti-register-interaction`: undefined
+   * - `qti-interaction-response`: undefined
+   *
+   * ## Slots
+   *
+   * Areas where markup can be added to the component.
+   *
+   * - `prompt`: The prompt shown above the choices.
+   * - `(default)`: Default slot for `qti-simple-choice` elements.
    *
    * ## Methods
    *
    * Methods that can be called to access component functionality.
    *
-   * - `handleDisabledChange(_oldValue: boolean, disabled: boolean) => void`: undefined
-   * - `handleReadonlyChange(_oldValue: boolean, readonly: boolean) => void`: undefined
-   */
-  "qti-inline-choice": Partial<
-    QtiInlineChoiceProps & BaseProps<QtiInlineChoice> & BaseEvents
-  >;
-
-  /**
+   * - `validate() => boolean`: undefined
+   * - `reportValidity() => boolean`: undefined
+   * - `reset() => void`: undefined
+   * - `formResetCallback() => void`: undefined
+   * - `saveResponse(value: string | string[], state?: string | null) => void`: undefined
+   *
+   * ## CSS Parts
+   *
+   * Custom selectors for styling elements within the component.
    *
+   * - `prompt`: Wrapper around the prompt slot.
+   * - `slot`: Wrapper around the default slot containing the choices.
+   * - `message`: Live validation message region (role="alert").
    */
-  "qti-prompt": Partial<QtiPromptProps & BaseProps<QtiPrompt> & BaseEvents>;
+  "qti-choice-interaction": Partial<
+    QtiChoiceInteractionProps & BaseProps<QtiChoiceInteraction> & BaseEvents
+  >;
 
   /**
    * QTI Custom Interaction component for legacy CES-based interactions.
@@ -10885,6 +10903,8 @@ export type CustomElementsSolidJs = {
    * - `fixed`: undefined
    * - `visible`: undefined
    * - `keep-together`/`keepTogether`: undefined
+   * - `navigation-mode`/`navigationMode`: undefined
+   * - `submission-mode`/`submissionMode`: undefined
    * - `title`: undefined (property only)
    * - `_testContext`: undefined (property only)
    *
@@ -10909,19 +10929,21 @@ export type CustomElementsSolidJs = {
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
    * - `identifier`: undefined
-   * - `title`: undefined
-   * - `_testContext`: undefined (property only)
+   * - `class`: undefined
+   * - `navigation-mode`/`navigationMode`: undefined
+   * - `submission-mode`/`submissionMode`: undefined
+   * - `title`: undefined (property only)
    *
    * ## Events
    *
    * Events that will be emitted by the component.
    *
-   * - `qti-assessment-test-connected`: undefined
+   * - `qti-test-part-connected`: undefined
    */
-  "qti-assessment-test": Partial<
-    QtiAssessmentTestProps &
-      QtiAssessmentTestSolidJsProps &
-      BaseProps<QtiAssessmentTest> &
+  "qti-test-part": Partial<
+    QtiTestPartProps &
+      QtiTestPartSolidJsProps &
+      BaseProps<QtiTestPart> &
       BaseEvents
   >;
 
@@ -10933,21 +10955,19 @@ export type CustomElementsSolidJs = {
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
    * - `identifier`: undefined
-   * - `class`: undefined
-   * - `navigation-mode`/`navigationMode`: undefined
-   * - `submission-mode`/`submissionMode`: undefined
-   * - `title`: undefined (property only)
+   * - `title`: undefined
+   * - `_testContext`: undefined (property only)
    *
    * ## Events
    *
    * Events that will be emitted by the component.
    *
-   * - `qti-test-part-connected`: undefined
+   * - `qti-assessment-test-connected`: undefined
    */
-  "qti-test-part": Partial<
-    QtiTestPartProps &
-      QtiTestPartSolidJsProps &
-      BaseProps<QtiTestPart> &
+  "qti-assessment-test": Partial<
+    QtiAssessmentTestProps &
+      QtiAssessmentTestSolidJsProps &
+      BaseProps<QtiAssessmentTest> &
       BaseEvents
   >;
 
@@ -11606,123 +11626,24 @@ export type CustomElementsSolidJs = {
   >;
 
   /**
-   * A choice in one of the two match sets of `qti-match-interaction`, or in
-   * `qti-associate-interaction`.
-   *
-   * ## Attributes & Properties
-   *
-   * Component attributes and properties that can be applied to the element or by using JavaScript.
-   *
-   * - `identifier`: Required. Value recorded in the response pair when this choice participates in an association.
-   * - `match-max`/`matchMax`: the maximum number of selections a candidate must make, the other options will be disabled when max options is checked
-   * - `match-min`/`matchMin`: the minimal number of selections a candidate must make
-   * - `fixed`: Pins this choice in place when the enclosing interaction is shuffled.
-   * - `template-identifier`/`undefined`: Not implemented. Identifier of a template variable controlling this choice's visibility.
-   * - `show-hide`/`undefined`: Not implemented. How `template-identifier` controls visibility.
-   * - `tabindex`/`tabIndex`: undefined
-   * - `aria-disabled`/`disabled`: undefined
-   * - `aria-readonly`/`readonly`: undefined
-   * - `acceptsDeclarativeDrops`: Opt-in marker read by `DragDropSlottedMixin`; see qti-gap. (property only) (readonly)
-   * - `drags`: The chips this choice holds when it acts as a drop target (match-interaction's second set). (property only) (readonly)
-   * - `internals`: undefined (property only)
-   *
-   * ## Events
-   *
-   * Events that will be emitted by the component.
-   *
-   * - `undefined`: undefined
-   *
-   * ## Methods
-   *
-   * Methods that can be called to access component functionality.
-   *
-   * - `handleDisabledChange(_oldValue: boolean, disabled: boolean) => void`: undefined
-   * - `handleReadonlyChange(_oldValue: boolean, readonly: boolean) => void`: undefined
-   */
-  "qti-simple-associable-choice": Partial<
-    QtiSimpleAssociableChoiceProps &
-      QtiSimpleAssociableChoiceSolidJsProps &
-      BaseProps<QtiSimpleAssociableChoice> &
-      BaseEvents
-  >;
-
-  /**
-   * Drag-and-drop associate interaction: candidates pair associable choices.
-   *
-   * ## Attributes & Properties
-   *
-   * Component attributes and properties that can be applied to the element or by using JavaScript.
-   *
-   * - `allowReorder`: undefined (property only)
-   * - `sortablePlaceholderConfig`: undefined (property only)
-   * - `sortableAnimationConfig`: undefined (property only)
-   * - `isDraggingFromSlot`: undefined (property only) (readonly)
-   *
-   * ## Slots
-   *
-   * Areas where markup can be added to the component.
-   *
-   * - `prompt`: The prompt shown above the choices.
-   * - `qti-simple-associable-choice`: The associable choice sources.
-   *
-   * ## Methods
-   *
-   * Methods that can be called to access component functionality.
-   *
-   * - `totalAssociationsFromState() => number`: How many associations the candidate has made.
-   *
-   * The mixin counts placed chips, which is right for gap-match — one chip in one gap is one
-   * association — and wrong here. An association is a *pair*, so three associations are six chips,
-   * and `max-associations="3"` compared 6 against 3 and declared the item invalid the moment it was
-   * correctly filled in.
-   *
-   * A half-filled row is not an association yet, and `getResponse()` already knows that: it emits a
-   * pair only when both sides hold a chip. Counting its entries counts associations by definition,
-   * and keeps the number validation sees equal to the number the response reports.
-   * - `getValue(val: string[]) => void`: undefined
-   * - `initiateDrag(dragElement: HTMLElement, startX: number, startY: number, inputType: 'mouse' | 'touch', rest: [eventSource?: 'pointer' | 'mouse' | 'touch']) => void`: undefined
-   * - `onSortableDragMove(clientX: number, clientY: number) => void`: undefined
-   * - `allowDrop(draggable: HTMLElement, droppable: HTMLElement) => boolean`: undefined
-   * - `handleDrop(draggable: HTMLElement, droppable: HTMLElement) => void`: undefined
-   * - `handleInvalidDrop(dragSource: HTMLElement | null) => void`: undefined
-   *
-   * ## CSS Parts
-   *
-   * Custom selectors for styling elements within the component.
-   *
-   * - `drags`: Wrapper around the associable choice slot.
-   * - `drops`: The container holding all drop targets.
-   * - `drop-row`: Container for one left/right drop pair.
-   * - `drop`: Each individual drop target.
-   * - `message`: Live validation message region (role="alert").
-   */
-  "qti-associate-interaction": Partial<
-    QtiAssociateInteractionProps &
-      QtiAssociateInteractionSolidJsProps &
-      BaseProps<QtiAssociateInteraction> &
-      BaseEvents
-  >;
-
-  /**
-   * A choice, used by `qti-choice-interaction` and `qti-order-interaction`.
-   *
-   * The `control` part is one box whose *role* is carried by state, not by its name: a radio
-   * circle under `:state(radio)`, a checkbox square under `:state(checkbox)`, and a drag grip
-   * when the choice is draggable. Style it as `qti-simple-choice::part(control)`.
+   * A choice in one of the two match sets of `qti-match-interaction`, or in
+   * `qti-associate-interaction`.
    *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `identifier`: Required. Value recorded in the response when this choice is selected, or its position when used for ordering.
+   * - `identifier`: Required. Value recorded in the response pair when this choice participates in an association.
+   * - `match-max`/`matchMax`: the maximum number of selections a candidate must make, the other options will be disabled when max options is checked
+   * - `match-min`/`matchMin`: the minimal number of selections a candidate must make
    * - `fixed`: Pins this choice in place when the enclosing interaction is shuffled.
-   * - `template-identifier`/`templateIdentifier`: Identifier of a template variable controlling this choice's visibility.
-   * - `show-hide`/`showHide`: How `template-identifier` controls visibility.
+   * - `template-identifier`/`undefined`: Not implemented. Identifier of a template variable controlling this choice's visibility.
+   * - `show-hide`/`undefined`: Not implemented. How `template-identifier` controls visibility.
    * - `tabindex`/`tabIndex`: undefined
    * - `aria-disabled`/`disabled`: undefined
    * - `aria-readonly`/`readonly`: undefined
-   * - `marker`: undefined (property only)
-   * - `checked`: undefined (property only) (readonly)
+   * - `acceptsDeclarativeDrops`: Opt-in marker read by `DragDropSlottedMixin`; see qti-gap. (property only) (readonly)
+   * - `drags`: The chips this choice holds when it acts as a drop target (match-interaction's second set). (property only) (readonly)
    * - `internals`: undefined (property only)
    *
    * ## Events
@@ -11737,103 +11658,68 @@ export type CustomElementsSolidJs = {
    *
    * - `handleDisabledChange(_oldValue: boolean, disabled: boolean) => void`: undefined
    * - `handleReadonlyChange(_oldValue: boolean, readonly: boolean) => void`: undefined
-   *
-   * ## CSS Parts
-   *
-   * Custom selectors for styling elements within the component.
-   *
-   * - `control`: The box before the label (radio / checkbox / drag grip).
-   * - `control-mark`: The mark inside the box (inner dot / checkmark).
-   * - `label`: The default slot holding the choice content.
-   * - `marker`: The order-number badge, when `marker` is set.
    */
-  "qti-simple-choice": Partial<
-    QtiSimpleChoiceProps &
-      QtiSimpleChoiceSolidJsProps &
-      BaseProps<QtiSimpleChoice> &
+  "qti-simple-associable-choice": Partial<
+    QtiSimpleAssociableChoiceProps &
+      QtiSimpleAssociableChoiceSolidJsProps &
+      BaseProps<QtiSimpleAssociableChoice> &
       BaseEvents
   >;
 
   /**
-   * A single-response or multiple-response choice interaction.
+   * Drag-and-drop associate interaction: candidates pair associable choices.
    *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `response-identifier`/`responseIdentifier`: Required. Identifier of the bound response variable.
-   * - `max-choices`/`maxChoices`: Maximum selectable choices. `1` is a single-response item; `0` means unlimited and makes it a multiple-response item.
-   * - `min-choices`/`minChoices`: Minimum selectable choices for a valid response.
-   * - `orientation`: Deprecated by QTI in favour of the `qti-orientation-*` class vocabulary.
-   * - `shuffle`/`undefined`: Requests choice shuffling. Applied by the transform pipeline (`qti-transformers`), not by this element.
-   * - `class`: QTI shared presentation vocabulary. Space-separated; takes precedence over `orientation`.
-   * - `response`: undefined
-   * - `disabled`: undefined
-   * - `readonly`: undefined
-   * - `name`: undefined
-   * - `value`: undefined (property only)
-   * - `configContext`: Delivery configuration, from the nearest provider — `qti-test` or `qti-item`.
-   *
-   * **Public so it can be assigned directly, which is the development-time route.** An interaction
-   * has to work standalone, and in a story or a spec there is usually no provider above it — so
-   * setting the field is all that is needed:
-   *
-   *     orderInteraction.configContext = { allowReorder: false, validationDisplayMode: 'none' };
-   *
-   * With no provider, nothing ever overwrites it. That is the whole contract, and its limit: where a
-   * provider DOES exist it re-emits on its next update and wins, because `@consume` writes this same
-   * field. There is no merging — set the value on the provider in that case.
-   *
-   * In a lit-html template, bind it as a property rather than assigning after the fact:
-   *
-   *     html`<qti-order-interaction .configContext=${{ allowReorder: false }}>…`
-   *
-   * The binding is committed on the detached template clone, before the fragment is inserted, so it
-   * is in place by `connectedCallback` — which matters for anything that reads config on connect.
-   *
-   * It was `protected`, which fooled nobody: every caller reached it anyway through an
-   * `as any` / `as { configContext?: … }` cast. Public says what was already true and removes the
-   * casts, rather than pretending at an encapsulation the type system was the only thing enforcing. (property only)
-   * - `internals`: undefined (property only) (readonly)
-   * - `isInline`: undefined (property only) (readonly)
-   * - `responseVariable`: undefined (property only) (readonly)
-   *
-   * ## Events
-   *
-   * Events that will be emitted by the component.
-   *
-   * - `qti-register-interaction`: undefined
-   * - `qti-interaction-response`: undefined
+   * - `allowReorder`: undefined (property only)
+   * - `sortablePlaceholderConfig`: undefined (property only)
+   * - `sortableAnimationConfig`: undefined (property only)
+   * - `isDraggingFromSlot`: undefined (property only) (readonly)
    *
    * ## Slots
    *
    * Areas where markup can be added to the component.
    *
    * - `prompt`: The prompt shown above the choices.
-   * - `(default)`: Default slot for `qti-simple-choice` elements.
+   * - `qti-simple-associable-choice`: The associable choice sources.
    *
    * ## Methods
    *
    * Methods that can be called to access component functionality.
    *
-   * - `validate() => boolean`: undefined
-   * - `reportValidity() => boolean`: undefined
-   * - `reset() => void`: undefined
-   * - `formResetCallback() => void`: undefined
-   * - `saveResponse(value: string | string[], state?: string | null) => void`: undefined
+   * - `totalAssociationsFromState() => number`: How many associations the candidate has made.
+   *
+   * The mixin counts placed chips, which is right for gap-match — one chip in one gap is one
+   * association — and wrong here. An association is a *pair*, so three associations are six chips,
+   * and `max-associations="3"` compared 6 against 3 and declared the item invalid the moment it was
+   * correctly filled in.
+   *
+   * A half-filled row is not an association yet, and `getResponse()` already knows that: it emits a
+   * pair only when both sides hold a chip. Counting its entries counts associations by definition,
+   * and keeps the number validation sees equal to the number the response reports.
+   * - `getValue(val: string[]) => void`: undefined
+   * - `initiateDrag(dragElement: HTMLElement, startX: number, startY: number, inputType: 'mouse' | 'touch', rest: [eventSource?: 'pointer' | 'mouse' | 'touch']) => void`: undefined
+   * - `onSortableDragMove(clientX: number, clientY: number) => void`: undefined
+   * - `allowDrop(draggable: HTMLElement, droppable: HTMLElement) => boolean`: undefined
+   * - `handleDrop(draggable: HTMLElement, droppable: HTMLElement) => void`: undefined
+   * - `handleInvalidDrop(dragSource: HTMLElement | null) => void`: undefined
    *
    * ## CSS Parts
    *
    * Custom selectors for styling elements within the component.
    *
-   * - `prompt`: Wrapper around the prompt slot.
-   * - `slot`: Wrapper around the default slot containing the choices.
+   * - `drags`: Wrapper around the associable choice slot.
+   * - `drops`: The container holding all drop targets.
+   * - `drop-row`: Container for one left/right drop pair.
+   * - `drop`: Each individual drop target.
    * - `message`: Live validation message region (role="alert").
    */
-  "qti-choice-interaction": Partial<
-    QtiChoiceInteractionProps &
-      QtiChoiceInteractionSolidJsProps &
-      BaseProps<QtiChoiceInteraction> &
+  "qti-associate-interaction": Partial<
+    QtiAssociateInteractionProps &
+      QtiAssociateInteractionSolidJsProps &
+      BaseProps<QtiAssociateInteraction> &
       BaseEvents
   >;
 
@@ -12079,6 +11965,140 @@ export type CustomElementsSolidJs = {
     QtiPromptProps & QtiPromptSolidJsProps & BaseProps<QtiPrompt> & BaseEvents
   >;
 
+  /**
+   * A choice, used by `qti-choice-interaction` and `qti-order-interaction`.
+   *
+   * The `control` part is one box whose *role* is carried by state, not by its name: a radio
+   * circle under `:state(radio)`, a checkbox square under `:state(checkbox)`, and a drag grip
+   * when the choice is draggable. Style it as `qti-simple-choice::part(control)`.
+   *
+   * ## Attributes & Properties
+   *
+   * Component attributes and properties that can be applied to the element or by using JavaScript.
+   *
+   * - `identifier`: Required. Value recorded in the response when this choice is selected, or its position when used for ordering.
+   * - `fixed`: Pins this choice in place when the enclosing interaction is shuffled.
+   * - `template-identifier`/`templateIdentifier`: Identifier of a template variable controlling this choice's visibility.
+   * - `show-hide`/`showHide`: How `template-identifier` controls visibility.
+   * - `tabindex`/`tabIndex`: undefined
+   * - `aria-disabled`/`disabled`: undefined
+   * - `aria-readonly`/`readonly`: undefined
+   * - `marker`: undefined (property only)
+   * - `checked`: undefined (property only) (readonly)
+   * - `internals`: undefined (property only)
+   *
+   * ## Events
+   *
+   * Events that will be emitted by the component.
+   *
+   * - `undefined`: undefined
+   *
+   * ## Methods
+   *
+   * Methods that can be called to access component functionality.
+   *
+   * - `handleDisabledChange(_oldValue: boolean, disabled: boolean) => void`: undefined
+   * - `handleReadonlyChange(_oldValue: boolean, readonly: boolean) => void`: undefined
+   *
+   * ## CSS Parts
+   *
+   * Custom selectors for styling elements within the component.
+   *
+   * - `control`: The box before the label (radio / checkbox / drag grip).
+   * - `control-mark`: The mark inside the box (inner dot / checkmark).
+   * - `label`: The default slot holding the choice content.
+   * - `marker`: The order-number badge, when `marker` is set.
+   */
+  "qti-simple-choice": Partial<
+    QtiSimpleChoiceProps &
+      QtiSimpleChoiceSolidJsProps &
+      BaseProps<QtiSimpleChoice> &
+      BaseEvents
+  >;
+
+  /**
+   * A single-response or multiple-response choice interaction.
+   *
+   * ## Attributes & Properties
+   *
+   * Component attributes and properties that can be applied to the element or by using JavaScript.
+   *
+   * - `response-identifier`/`responseIdentifier`: Required. Identifier of the bound response variable.
+   * - `max-choices`/`maxChoices`: Maximum selectable choices. `1` is a single-response item; `0` means unlimited and makes it a multiple-response item.
+   * - `min-choices`/`minChoices`: Minimum selectable choices for a valid response.
+   * - `orientation`: Deprecated by QTI in favour of the `qti-orientation-*` class vocabulary.
+   * - `shuffle`/`undefined`: Requests choice shuffling. Applied by the transform pipeline (`qti-transformers`), not by this element.
+   * - `class`: QTI shared presentation vocabulary. Space-separated; takes precedence over `orientation`.
+   * - `response`: undefined
+   * - `disabled`: undefined
+   * - `readonly`: undefined
+   * - `name`: undefined
+   * - `value`: undefined (property only)
+   * - `configContext`: Delivery configuration, from the nearest provider — `qti-test` or `qti-item`.
+   *
+   * **Public so it can be assigned directly, which is the development-time route.** An interaction
+   * has to work standalone, and in a story or a spec there is usually no provider above it — so
+   * setting the field is all that is needed:
+   *
+   *     orderInteraction.configContext = { allowReorder: false, validationDisplayMode: 'none' };
+   *
+   * With no provider, nothing ever overwrites it. That is the whole contract, and its limit: where a
+   * provider DOES exist it re-emits on its next update and wins, because `@consume` writes this same
+   * field. There is no merging — set the value on the provider in that case.
+   *
+   * In a lit-html template, bind it as a property rather than assigning after the fact:
+   *
+   *     html`<qti-order-interaction .configContext=${{ allowReorder: false }}>…`
+   *
+   * The binding is committed on the detached template clone, before the fragment is inserted, so it
+   * is in place by `connectedCallback` — which matters for anything that reads config on connect.
+   *
+   * It was `protected`, which fooled nobody: every caller reached it anyway through an
+   * `as any` / `as { configContext?: … }` cast. Public says what was already true and removes the
+   * casts, rather than pretending at an encapsulation the type system was the only thing enforcing. (property only)
+   * - `internals`: undefined (property only) (readonly)
+   * - `isInline`: undefined (property only) (readonly)
+   * - `responseVariable`: undefined (property only) (readonly)
+   *
+   * ## Events
+   *
+   * Events that will be emitted by the component.
+   *
+   * - `qti-register-interaction`: undefined
+   * - `qti-interaction-response`: undefined
+   *
+   * ## Slots
+   *
+   * Areas where markup can be added to the component.
+   *
+   * - `prompt`: The prompt shown above the choices.
+   * - `(default)`: Default slot for `qti-simple-choice` elements.
+   *
+   * ## Methods
+   *
+   * Methods that can be called to access component functionality.
+   *
+   * - `validate() => boolean`: undefined
+   * - `reportValidity() => boolean`: undefined
+   * - `reset() => void`: undefined
+   * - `formResetCallback() => void`: undefined
+   * - `saveResponse(value: string | string[], state?: string | null) => void`: undefined
+   *
+   * ## CSS Parts
+   *
+   * Custom selectors for styling elements within the component.
+   *
+   * - `prompt`: Wrapper around the prompt slot.
+   * - `slot`: Wrapper around the default slot containing the choices.
+   * - `message`: Live validation message region (role="alert").
+   */
+  "qti-choice-interaction": Partial<
+    QtiChoiceInteractionProps &
+      QtiChoiceInteractionSolidJsProps &
+      BaseProps<QtiChoiceInteraction> &
+      BaseEvents
+  >;
+
   /**
    * QTI Custom Interaction component for legacy CES-based interactions.
    *