@qti-components/base 3.0.0-next.3 → 3.0.0-next.5

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

@@ -8,4 +8,11 @@ export declare abstract class QtiFeedback extends LitElement {
     private get _context();
     private _computedContext?;
     checkShowFeedback(outcomeIdentifier: string): void;
+    /**
+     * Called when this feedback is about to show. Return `false` to keep it hidden: the host shows the
+     * content itself. The elements dispatch `cito-feedback-show` here.
+     */
+    protected feedbackShowing(): boolean;
+    /** Called when this feedback is about to hide. Return `false` to keep it showing: the host hides it itself. */
+    protected feedbackHiding(): boolean;
 }

package/dist/abstract/qti-feedback.js

@@ -25,6 +25,8 @@ export class QtiFeedback extends LitElement {
             subscribe: true,
             callback: context => this.#followItem(context)
         });
+        /** The host cancelled the show: it has this feedback, and is not asked again until the condition has gone. */
+        this.#hostShows = false;
     }
     /**
      * The item's variables. Feedback follows them itself: every time the item publishes a new context
@@ -71,12 +73,40 @@ export class QtiFeedback extends LitElement {
         }
         this.#showFeedback(isFound);
     }
+    /** The host cancelled the show: it has this feedback, and is not asked again until the condition has gone. */
+    #hostShows;
     #showFeedback(value) {
-        if (!this.#sessionControlAllowsFeedback()) {
-            this.showStatus = 'off';
-            return;
+        const next = this.#sessionControlAllowsFeedback() && this.#conditionHolds(value) ? 'on' : 'off';
+        if (next === 'on') {
+            if (this.showStatus === 'on' || this.#hostShows)
+                return;
+            if (!this.feedbackShowing()) {
+                // The host takes over showing: this stays off and the host shows the content itself.
+                this.#hostShows = true;
+                this.showStatus = 'off';
+                return;
+            }
+        }
+        else {
+            this.#hostShows = false;
+            if (this.showStatus === 'on' && !this.feedbackHiding())
+                return;
         }
-        this.showStatus = (value && this.showHide === 'show') || (!value && this.showHide === 'hide') ? 'on' : 'off';
+        this.showStatus = next;
+    }
+    #conditionHolds(value) {
+        return (value && this.showHide === 'show') || (!value && this.showHide === 'hide');
+    }
+    /**
+     * Called when this feedback is about to show. Return `false` to keep it hidden: the host shows the
+     * content itself. The elements dispatch `cito-feedback-show` here.
+     */
+    feedbackShowing() {
+        return true;
+    }
+    /** Called when this feedback is about to hide. Return `false` to keep it showing: the host hides it itself. */
+    feedbackHiding() {
+        return true;
     }
     /**
      * The QTI `show-feedback` constraint governs exactly one state: after the end of

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

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

package/dist/context/config.context.d.ts

@@ -57,7 +57,8 @@ export interface ConfigContext {
     validationDisplayMode?: ValidationDisplayMode;
     /**
      * If true, disables further user actions when an interaction reaches its configured maximum.
-     * Applies to both choice-based and drag/drop interactions.
+     * Applies to both choice-based and drag/drop interactions. Defaults to false: QTI lets the candidate
+     * go over the maximum and reports it with the max-selections message.
      */
     disableAfterMaxReached?: boolean;
     /**

package/dist/context/config.context.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.context.js","sourceRoot":"","sources":["../../src/context/config.context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAkG7C,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAA0B,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC","sourcesContent":["import { createContext } from '@lit/context';\n\nexport type ValidationDisplayMode = 'inline' | 'native' | 'both' | 'none';\n\n/**\n * Configuration context for QTI components. Provides runtime options for assessment item and\n * interaction behavior.\n *\n * ── Three ways to set it, in the order you should reach for them ─────────────────────────────\n *\n * 1. **On a provider**, for real delivery. `qti-test` and `qti-item` both provide it, so setting\n *    `item.configContext = {…}` configures every interaction inside.\n *\n * 2. **On one interaction, directly** — the development-time route, and the reason\n *    `Interaction.configContext` is public:\n *\n *        orderInteraction.configContext = { allowReorder: false };\n *\n *    or, in a lit-html template, as a property binding — which lands before `connectedCallback`:\n *\n *        html`<qti-order-interaction .configContext=${{ allowReorder: false }}>…`\n *\n *    An interaction has to work standalone, so in a story or a spec there is usually no provider\n *    above it, and then nothing ever overwrites what you set. Where a provider DOES exist it wins on\n *    its next emit, because `@consume` writes that same field.\n *\n *    A `qti-config-test-provider` element used to exist for scoping config to a subtree. It is gone:\n *    it was test-only yet registered itself into every consumer's element registry via an unguarded\n *    `@customElement`, which threw whenever two copies of this package ended up in one module graph.\n *    Bind the property on each interaction instead, or provide from `qti-item`.\n *\n * There is no merging at any level: @lit/context resolves to the nearest provider and that object\n * replaces the ancestor's wholesale. A deeper provider therefore has to restate anything from above\n * that it still wants.\n *\n * Note what is NOT here. Options an item author chooses per question are attributes on the\n * interaction (`auto-size-dropzones`, `max-associations`, `disable-animations`); options only a\n * developer chooses are mixin factory arguments or method overrides. This context is for what a\n * delivery environment decides across items. `interactionContext` and `dragDropContext` are neither\n * — they publish derived state (what a choice IS, what a drop HOLDS), never configuration.\n */\nexport interface ConfigContext {\n  /**\n   * Optional category label for info items, used for reporting or display purposes.\n   * Example: \"General Information\", \"Instructions\".\n   */\n  infoItemCategory?: string;\n\n  /**\n   * If true, calls reportValidity() on interactions after scoring to show validation feedback.\n   * Used to trigger UI validation after a scoring event.\n   */\n  reportValidityAfterScoring?: boolean;\n\n  /**\n   * Controls how validation feedback is displayed by interactions:\n   * - 'inline': render message in #validation-message (default behavior)\n   * - 'native': use browser-native reportValidity popup behavior\n   * - 'both': show both inline and native feedback\n   * - 'none': keep validity state only, without visual feedback\n   */\n  validationDisplayMode?: ValidationDisplayMode;\n\n  /**\n   * If true, disables further user actions when an interaction reaches its configured maximum.\n   * Applies to both choice-based and drag/drop interactions.\n   */\n  disableAfterMaxReached?: boolean;\n\n  /**\n   * If false, chips already placed in a drop target cannot be reordered or moved between targets in\n   * drag/drop sortable interactions (order, match, gap-match). Defaults to true. A per-interaction\n   * `allowReorder` property overrides this.\n   */\n  allowReorder?: boolean;\n\n  /**\n   * If true, disables further selection in choice interactions after the maximum number of choices is reached.\n   * @deprecated Legacy alias for choice interactions. Prefer disableAfterMaxReached.\n   */\n  disableAfterIfMaxChoicesReached?: boolean;\n\n  /**\n   * Optional prompt text to display in inline choice interactions when no option is selected.\n   * Example: \"Select an answer...\"\n   */\n  inlineChoicePrompt?: string;\n\n  /**\n   * The inline choice interaction measures the widest option and sizes the trigger to match, so\n   * choosing an option never changes the field's width. Defaults to true; set false to size the\n   * field to the option shown.\n   * When a `qti-input-width-*` class is present on the interaction, that class width always takes\n   * precedence and autosizing is skipped regardless of this setting.\n   */\n  inlineChoiceAutosize?: boolean;\n}\n\nexport const configContext = createContext<Readonly<ConfigContext>>(Symbol('configContext'));\n"]}
+{"version":3,"file":"config.context.js","sourceRoot":"","sources":["../../src/context/config.context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAmG7C,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAA0B,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC","sourcesContent":["import { createContext } from '@lit/context';\n\nexport type ValidationDisplayMode = 'inline' | 'native' | 'both' | 'none';\n\n/**\n * Configuration context for QTI components. Provides runtime options for assessment item and\n * interaction behavior.\n *\n * ── Three ways to set it, in the order you should reach for them ─────────────────────────────\n *\n * 1. **On a provider**, for real delivery. `qti-test` and `qti-item` both provide it, so setting\n *    `item.configContext = {…}` configures every interaction inside.\n *\n * 2. **On one interaction, directly** — the development-time route, and the reason\n *    `Interaction.configContext` is public:\n *\n *        orderInteraction.configContext = { allowReorder: false };\n *\n *    or, in a lit-html template, as a property binding — which lands before `connectedCallback`:\n *\n *        html`<qti-order-interaction .configContext=${{ allowReorder: false }}>…`\n *\n *    An interaction has to work standalone, so in a story or a spec there is usually no provider\n *    above it, and then nothing ever overwrites what you set. Where a provider DOES exist it wins on\n *    its next emit, because `@consume` writes that same field.\n *\n *    A `qti-config-test-provider` element used to exist for scoping config to a subtree. It is gone:\n *    it was test-only yet registered itself into every consumer's element registry via an unguarded\n *    `@customElement`, which threw whenever two copies of this package ended up in one module graph.\n *    Bind the property on each interaction instead, or provide from `qti-item`.\n *\n * There is no merging at any level: @lit/context resolves to the nearest provider and that object\n * replaces the ancestor's wholesale. A deeper provider therefore has to restate anything from above\n * that it still wants.\n *\n * Note what is NOT here. Options an item author chooses per question are attributes on the\n * interaction (`auto-size-dropzones`, `max-associations`, `disable-animations`); options only a\n * developer chooses are mixin factory arguments or method overrides. This context is for what a\n * delivery environment decides across items. `interactionContext` and `dragDropContext` are neither\n * — they publish derived state (what a choice IS, what a drop HOLDS), never configuration.\n */\nexport interface ConfigContext {\n  /**\n   * Optional category label for info items, used for reporting or display purposes.\n   * Example: \"General Information\", \"Instructions\".\n   */\n  infoItemCategory?: string;\n\n  /**\n   * If true, calls reportValidity() on interactions after scoring to show validation feedback.\n   * Used to trigger UI validation after a scoring event.\n   */\n  reportValidityAfterScoring?: boolean;\n\n  /**\n   * Controls how validation feedback is displayed by interactions:\n   * - 'inline': render message in #validation-message (default behavior)\n   * - 'native': use browser-native reportValidity popup behavior\n   * - 'both': show both inline and native feedback\n   * - 'none': keep validity state only, without visual feedback\n   */\n  validationDisplayMode?: ValidationDisplayMode;\n\n  /**\n   * If true, disables further user actions when an interaction reaches its configured maximum.\n   * Applies to both choice-based and drag/drop interactions. Defaults to false: QTI lets the candidate\n   * go over the maximum and reports it with the max-selections message.\n   */\n  disableAfterMaxReached?: boolean;\n\n  /**\n   * If false, chips already placed in a drop target cannot be reordered or moved between targets in\n   * drag/drop sortable interactions (order, match, gap-match). Defaults to true. A per-interaction\n   * `allowReorder` property overrides this.\n   */\n  allowReorder?: boolean;\n\n  /**\n   * If true, disables further selection in choice interactions after the maximum number of choices is reached.\n   * @deprecated Legacy alias for choice interactions. Prefer disableAfterMaxReached.\n   */\n  disableAfterIfMaxChoicesReached?: boolean;\n\n  /**\n   * Optional prompt text to display in inline choice interactions when no option is selected.\n   * Example: \"Select an answer...\"\n   */\n  inlineChoicePrompt?: string;\n\n  /**\n   * The inline choice interaction measures the widest option and sizes the trigger to match, so\n   * choosing an option never changes the field's width. Defaults to true; set false to size the\n   * field to the option shown.\n   * When a `qti-input-width-*` class is present on the interaction, that class width always takes\n   * precedence and autosizing is skipped regardless of this setting.\n   */\n  inlineChoiceAutosize?: boolean;\n}\n\nexport const configContext = createContext<Readonly<ConfigContext>>(Symbol('configContext'));\n"]}

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

@@ -3,7 +3,8 @@ export const itemContextVariables = [
         identifier: 'completionStatus',
         cardinality: 'single',
         baseType: 'string',
-        value: 'unknown',
+        // QTI info model §2.2.2; the item makes it `unknown` once it is presented.
+        value: 'not_attempted',
         type: 'outcome'
     },
     {

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

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

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

@@ -20,8 +20,8 @@ export declare abstract class QtiRuleElement extends LitElement implements QtiRu
  * every one of those loops without each of them having to report upwards.
  *
  * `qti-response-processing` catches it at the top of the run. The outcomes set
- * before the exit are kept, because each `qti-set-outcome-value` has already
- * dispatched by the time this is thrown.
+ * before the exit are kept: they are already on the run's working copy, which
+ * the item applies once the run ends.
  */
 export declare class QtiExitResponseSignal extends Error {
     constructor();

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

@@ -13,8 +13,8 @@ export class QtiRuleElement extends LitElement {
  * every one of those loops without each of them having to report upwards.
  *
  * `qti-response-processing` catches it at the top of the run. The outcomes set
- * before the exit are kept, because each `qti-set-outcome-value` has already
- * dispatched by the time this is thrown.
+ * before the exit are kept: they are already on the run's working copy, which
+ * the item applies once the run ends.
  */
 export class QtiExitResponseSignal extends Error {
     constructor() {

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

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

package/package.json

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