@longsightgroup/qti3-player 0.3.0 → 0.5.1

package/dist/player-types.d.ts

@@ -1,5 +1,4 @@
 import type { QtiAssessmentItem, QtiAttemptStateV1, QtiAttemptStatus, QtiDiagnostic, QtiInteraction, QtiPortableCustomDefinition, QtiPortableCustomStateValue, QtiScoreResult, QtiValue } from "@longsightgroup/qti3-core";
-import type { QtiPlayerMessages } from "./player-messages.js";
 export interface QtiPlayerSessionControl {
     validateResponses?: boolean | undefined;
     showFeedback?: boolean | undefined;
@@ -16,7 +15,6 @@ export interface QtiPlayerLoadOptions {
     fetchXml?: QtiPlayerFetchXml | undefined;
     resolveAsset?: QtiPlayerResolveAsset | undefined;
 }
-export type QtiPlayerMessageOverrides = Partial<QtiPlayerMessages>;
 export interface QtiReadyEventDetail {
     item: QtiAssessmentItem;
 }
@@ -53,6 +51,15 @@ export interface QtiSuspendEventDetail {
 export interface QtiEndAttemptEventDetail {
     state: QtiAttemptStateV1;
 }
+export interface QtiDiagnosticsEventDetail {
+    diagnostics: QtiDiagnostic[];
+}
+export interface QtiResetEventDetail {
+    state?: QtiAttemptStateV1 | undefined;
+}
+export interface QtiRestoreEventDetail {
+    state?: QtiAttemptStateV1 | undefined;
+}
 export interface QtiAssessmentItemPlayerEventDetailMap {
     "qti-ready": QtiReadyEventDetail;
     "qti-statechange": QtiStateChangeEventDetail;
@@ -62,6 +69,9 @@ export interface QtiAssessmentItemPlayerEventDetailMap {
     "qti-validation": QtiValidationEventDetail;
     "qti-suspend": QtiSuspendEventDetail;
     "qti-endattempt": QtiEndAttemptEventDetail;
+    "qti-diagnostics": QtiDiagnosticsEventDetail;
+    "qti-reset": QtiResetEventDetail;
+    "qti-restore": QtiRestoreEventDetail;
 }
 export type QtiAssessmentItemPlayerEventName = keyof QtiAssessmentItemPlayerEventDetailMap;
 export type QtiAssessmentItemPlayerEvent<T extends QtiAssessmentItemPlayerEventName = QtiAssessmentItemPlayerEventName> = CustomEvent<QtiAssessmentItemPlayerEventDetailMap[T]>;

package/dist/player-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"player-types.d.ts","sourceRoot":"","sources":["../src/player-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,2BAA2B,EAC3B,2BAA2B,EAC3B,cAAc,EACd,QAAQ,EACT,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AACjE,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACtC,MAAM,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACtC,cAAc,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACzC,YAAY,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,4BAA4B;IAC3C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,iCAAiC;IAChD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,cAAc,CAAC;IAC5B,UAAU,EAAE,2BAA2B,CAAC;IACxC,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAC;CACjD;AAED,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAEjD,MAAM,WAAW,wBAAwB;IACvC,qFAAqF;IACrF,kBAAkB,EAAE,aAAa,EAAE,CAAC;IACpC,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,qCAAqC;IACpD,WAAW,EAAE,mBAAmB,CAAC;IACjC,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,oBAAoB,EAAE,4BAA4B,CAAC;IACnD,2BAA2B,EAAE,iCAAiC,CAAC;IAC/D,WAAW,EAAE,mBAAmB,CAAC;IACjC,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,aAAa,EAAE,qBAAqB,CAAC;IACrC,gBAAgB,EAAE,wBAAwB,CAAC;CAC5C;AAED,MAAM,MAAM,gCAAgC,GAAG,MAAM,qCAAqC,CAAC;AAE3F,MAAM,MAAM,4BAA4B,CACtC,CAAC,SAAS,gCAAgC,GAAG,gCAAgC,IAC3E,WAAW,CAAC,qCAAqC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1D,MAAM,MAAM,qCAAqC,GAAG;KACjD,CAAC,IAAI,gCAAgC,GAAG,WAAW,CAAC,qCAAqC,CAAC,CAAC,CAAC,CAAC;CAC/F,CAAC"}
+{"version":3,"file":"player-types.d.ts","sourceRoot":"","sources":["../src/player-types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longsightgroup/qti3-player",
-  "version": "0.3.0",
+  "version": "0.5.1",
   "description": "Style-neutral web component player for rendering and scoring QTI 3 assessment items.",
   "keywords": [
     "assessment",
@@ -45,8 +45,8 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@longsightgroup/qti3-fixtures": "0.3.0",
-    "@longsightgroup/qti3-core": "0.3.0"
+    "@longsightgroup/qti3-core": "0.5.1",
+    "@longsightgroup/qti3-fixtures": "0.5.1"
   },
   "scripts": {}
 }

package/src/controls/remove-button.ts

@@ -1,13 +1,16 @@
 import { trashIcon } from "../icons.js";
-import type { QtiPlayerMessages } from "../player-messages.js";
+import type { PlayerMessageResolver } from "../player-message-resolver.js";
 
-export function removeButton(label: string | null, messages: QtiPlayerMessages): HTMLButtonElement {
-  const safeLabel = label?.trim() || messages.remove();
+export function removeButton(
+  label: string | null,
+  messages: PlayerMessageResolver,
+): HTMLButtonElement {
+  const safeLabel = label?.trim() || messages.message("remove");
   const button = document.createElement("button");
   button.type = "button";
   button.className = "qti3-icon-button qti3-remove-button";
-  button.title = messages.remove();
-  button.setAttribute("aria-label", messages.removePair({ label: safeLabel }));
+  button.title = messages.message("remove");
+  button.setAttribute("aria-label", messages.message("removePair", { label: safeLabel }));
   button.append(trashIcon());
   return button;
 }

package/src/index.ts

@@ -1,26 +1,82 @@
+export type { QtiPlayerMovementDirection } from "./player-messages.js";
 export type {
-  QtiPlayerAssociationPairLabelParams,
-  QtiPlayerMessages,
-  QtiPlayerRemoveMessageParams,
-} from "./player-messages.js";
+  QtiAttemptStateV1,
+  QtiCatalogSupportResolution,
+  QtiCatalogSupportResolutionOptions,
+  QtiScoreResult,
+  QtiTextToSpeechTraversal,
+} from "@longsightgroup/qti3-core";
 export type {
   QtiAssessmentItemPlayerCustomEventMap,
   QtiAssessmentItemPlayerEvent,
   QtiAssessmentItemPlayerEventDetailMap,
   QtiAssessmentItemPlayerEventName,
+  QtiDiagnosticsEventDetail,
   QtiEndAttemptEventDetail,
   QtiPlayerFetchXml,
   QtiPlayerLoadOptions,
-  QtiPlayerMessageOverrides,
   QtiPlayerResolveAsset,
   QtiPlayerSessionControl,
   QtiPortableCustomMountEventDetail,
   QtiReadyEventDetail,
   QtiResponseChangeEventDetail,
+  QtiResetEventDetail,
+  QtiRestoreEventDetail,
   QtiScoreAttemptOptions,
   QtiScoreEventDetail,
   QtiStateChangeEventDetail,
   QtiSuspendEventDetail,
   QtiValidationEventDetail,
 } from "./player-types.js";
+export type {
+  QtiAssessmentItemPlayerAdapterEventCallback,
+  QtiAssessmentItemPlayerAdapterEventHandlerProps,
+  QtiAssessmentItemPlayerAdapterEventPropName,
+  QtiAssessmentItemPlayerAdapterLoadSyncInput,
+  QtiAssessmentItemPlayerAdapterProps,
+  QtiAssessmentItemPlayerAdapterPropName,
+  QtiAssessmentItemPlayerHandle,
+  QtiAssessmentItemPlayerLoadDependencies,
+} from "./player-adapter.js";
+export {
+  bindQtiAssessmentItemPlayerAdapterEvents,
+  createQtiAssessmentItemPlayerAdapterLoadSync,
+  createQtiAssessmentItemPlayerHandle,
+  isQtiAssessmentItemPlayerAdapterPropName,
+  normalizeQtiAssessmentItemPlayerLoadError,
+  qtiAssessmentItemPlayerAdapterEventEntries,
+  qtiAssessmentItemPlayerAdapterPropNames,
+  qtiAssessmentItemPlayerLoadDependencies,
+  qtiAssessmentItemPlayerLoadStateKey,
+  syncQtiAssessmentItemPlayerAdapterChrome,
+  syncQtiAssessmentItemPlayerAdapterMessages,
+} from "./player-adapter.js";
+export type { PlayerMessageCatalog } from "./player-message-catalog.js";
+export type { PlayerMessageKey, PlayerMessageResolverKind } from "./player-message-manifest.js";
+export { PLAYER_MESSAGE_MANIFEST } from "./player-message-manifest.js";
+export {
+  createPlayerMessageResolver,
+  defaultPlayerMessageCatalog,
+  defaultPlayerMessageResolver,
+  extractMessagePlaceholders,
+  formatPlayerMessage,
+  mergePlayerMessageCatalogs,
+  type PlayerMessageOverride,
+  type PlayerMessageParams,
+  type PlayerMessageResolver,
+  type QtiPlayerMessageOverrides,
+} from "./player-message-catalog.js";
+export { PLAYER_MESSAGE_KEYS, PLAYER_MESSAGE_STRING_KEYS } from "./player-message-keys.js";
+export type {
+  PlayerMessageCatalogDiagnostic,
+  PlayerMessageCatalogDiagnosticCode,
+  PlayerMessageCatalogValidationResult,
+  ValidatePlayerMessageCatalogOptions,
+} from "./player-message-catalog-validate.js";
+export {
+  allowedCatalogPlaceholders,
+  requiredCatalogPlaceholders,
+  validatePlayerMessageCatalog,
+} from "./player-message-catalog-validate.js";
+export { resolvePlayerMessages } from "./player-locale.js";
 export { QtiAssessmentItemPlayer, defineQtiAssessmentItemPlayer } from "./player-element.js";

package/src/interactions/choice-interaction.ts

@@ -2,10 +2,10 @@ import type { QtiInteraction, QtiValue } from "@longsightgroup/qti3-core";
 import {
   interactionChoices,
   missingChoicesMessage,
-  readableType,
   responseGroup,
   valueToStrings,
 } from "../interaction-support.js";
+import type { PlayerMessageResolver } from "../player-message-resolver.js";
 
 function choicePresentationLabel(interaction: QtiInteraction, index: number): string {
   const classNames = new Set((interaction.attributes.class ?? "").split(/\s+/).filter(Boolean));
@@ -28,6 +28,7 @@ export function renderChoice(
   interaction: QtiInteraction,
   update: (value: QtiValue) => void,
   currentValue: QtiValue,
+  messages: PlayerMessageResolver,
 ): HTMLElement {
   const group = responseGroup("qti3-choice-group");
 
@@ -37,7 +38,10 @@ export function renderChoice(
   const list = document.createElement("div");
   list.className = "qti3-choice-list";
   list.role = "group";
-  list.setAttribute("aria-label", `${readableType(interaction.type)} options`);
+  list.setAttribute(
+    "aria-label",
+    messages.message("interactionOptionsList", { type: interaction.type }),
+  );
   const syncSelected = () => {
     for (const label of list.querySelectorAll<HTMLElement>(".qti3-choice-option")) {
       const identifier = label.dataset.choiceIdentifier ?? "";

package/src/interactions/drawing-interaction.ts

@@ -1,6 +1,6 @@
 import type { QtiInteraction, QtiObjectAsset, QtiValue } from "@longsightgroup/qti3-core";
-import { applyResponsiveGraphicSize, objectIsImage, readableType } from "../interaction-support.js";
-import type { QtiPlayerMessages } from "../player-messages.js";
+import { applyResponsiveGraphicSize, objectIsImage } from "../interaction-support.js";
+import type { PlayerMessageResolver } from "../player-message-resolver.js";
 
 export const DRAWING_STROKE_COLOR = "#000";
 export const DRAWING_STROKE_WIDTH = 3;
@@ -9,16 +9,19 @@ export function renderDrawingResponse(
   interaction: QtiInteraction,
   update: (value: QtiValue) => void,
   currentValue: QtiValue,
-  messages: QtiPlayerMessages,
+  messages: PlayerMessageResolver,
 ): HTMLElement {
   const group = document.createElement("div");
   group.role = "group";
-  group.setAttribute("aria-label", `${readableType(interaction.type)} response`);
+  group.setAttribute(
+    "aria-label",
+    messages.message("interactionDrawingResponse", { type: interaction.type }),
+  );
 
   const surface = document.createElementNS("http://www.w3.org/2000/svg", "svg");
   surface.classList.add("qti3-drawing-surface");
   surface.setAttribute("role", "img");
-  surface.setAttribute("aria-label", "Drawing response surface");
+  surface.setAttribute("aria-label", messages.message("drawingSurface"));
   surface.setAttribute("tabindex", "0");
   const width = drawingWidth(interaction);
   const height = drawingHeight(interaction);
@@ -68,12 +71,14 @@ export function renderDrawingResponse(
     const count = strokes.length;
     summary.value = serializeDrawingStrokes(strokes);
     summary.textContent =
-      count === 0 ? "No drawing strokes." : `${count} drawing stroke${count === 1 ? "" : "s"}.`;
+      count === 0
+        ? messages.message("drawingStatusEmpty")
+        : messages.message("drawingStatusStrokeCount", { count });
     surface.setAttribute(
       "aria-label",
       count === 0
-        ? "Drawing response surface, no strokes"
-        : `Drawing response surface, ${count} stroke${count === 1 ? "" : "s"}`,
+        ? messages.message("drawingSurfaceEmpty")
+        : messages.message("drawingSurfaceStrokeCount", { count }),
     );
   };
   for (const points of restoredStrokes) {
@@ -127,7 +132,7 @@ export function renderDrawingResponse(
 
   const clear = document.createElement("button");
   clear.type = "button";
-  clear.textContent = messages.clearDrawing();
+  clear.textContent = messages.message("clearDrawing");
   clear.addEventListener("click", () => {
     strokes.splice(0, strokes.length);
     activeStroke = undefined;

package/src/interactions/end-attempt-interaction.ts

@@ -1,16 +1,16 @@
 import type { QtiInteraction, QtiValue } from "@longsightgroup/qti3-core";
-import type { QtiPlayerMessages } from "../player-messages.js";
+import type { PlayerMessageResolver } from "../player-message-resolver.js";
 
 export function renderEndAttemptResponse(
   interaction: QtiInteraction,
   update: (value: QtiValue) => void,
   endAttempt: () => void,
-  messages: QtiPlayerMessages,
+  messages: PlayerMessageResolver,
 ): HTMLElement {
   const button = document.createElement("button");
   button.type = "button";
   button.className = "qti3-end-attempt-button";
-  button.textContent = interaction.attributes.title ?? messages.endAttempt();
+  button.textContent = interaction.attributes.title ?? messages.message("endAttempt");
   button.addEventListener("click", () => {
     if (interaction.responseIdentifier) update(true);
     endAttempt();

package/src/interactions/gap-match-interaction.ts

@@ -6,10 +6,10 @@ import {
   objectHeight,
   objectWidth,
   placeHotspotButton,
-  readableType,
   responseGroup,
   valueToStrings,
 } from "../interaction-support.js";
+import type { PlayerMessageResolver } from "../player-message-resolver.js";
 import { parseUnlimitedMaximum } from "../response-limits.js";
 import { appendGraphicContext } from "./graphic-context.js";
 import { appendInlineControl, normalizeInlineSegmentText } from "./inline-controls.js";
@@ -33,13 +33,14 @@ export function renderGapMatchResponse(
   interaction: QtiInteraction,
   update: (value: QtiValue) => void,
   currentValue: QtiValue,
+  messages: PlayerMessageResolver,
 ): HTMLElement {
   if (
     interaction.type === "graphicGapMatch" &&
     interaction.object &&
     interaction.choices.some((choice) => choice.role === "hotspot")
   ) {
-    return renderGraphicGapMatchResponse(interaction, update, currentValue);
+    return renderGraphicGapMatchResponse(interaction, update, currentValue, messages);
   }
 
   const group = responseGroup();
@@ -54,11 +55,16 @@ export function renderGapMatchResponse(
   let selectedSource: QtiChoice | undefined;
   let draggedSource: string | undefined;
 
-  const sourceRegion = tokenRegion(`${readableType(interaction.type)} choices`);
+  const sourceRegion = tokenRegion(
+    messages.message("interactionChoicesBank", { type: interaction.type }),
+  );
   const gapRegion = document.createElement("div");
   gapRegion.className = "qti3-gap-region qti3-gap-passage";
   gapRegion.role = "group";
-  gapRegion.setAttribute("aria-label", `${readableType(interaction.type)} targets`);
+  gapRegion.setAttribute(
+    "aria-label",
+    messages.message("interactionGapTargets", { type: interaction.type }),
+  );
   for (const pair of valueToStrings(currentValue)) {
     const [sourceIdentifier, gapIdentifier] = pair.split(/\s+/);
     const source = sources.find((choice) => choice.identifier === sourceIdentifier);
@@ -91,7 +97,7 @@ export function renderGapMatchResponse(
   };
   const gapControl = (gap: QtiChoice, index: number) => {
     const assigned = assignments.get(gap.identifier);
-    const gapLabel = `Gap ${index + 1}`;
+    const gapLabel = messages.message("gapLabel", { index: index + 1 });
     const target = document.createElement("span");
     target.className = "qti3-gap-target";
     target.dataset.gapIdentifier = gap.identifier;
@@ -112,7 +118,9 @@ export function renderGapMatchResponse(
     button.textContent = assigned ? assigned.text : "";
     button.setAttribute(
       "aria-label",
-      assigned ? `${gapLabel}, assigned ${assigned.text}` : `${gapLabel}, empty`,
+      assigned
+        ? messages.message("gapAssignedState", { label: gapLabel, assigned: assigned.text })
+        : messages.message("gapEmptyState", { label: gapLabel }),
     );
     button.addEventListener("click", () => assign(gap, selectedSource?.identifier));
     button.addEventListener("keydown", (event) => {
@@ -173,6 +181,7 @@ function renderGraphicGapMatchResponse(
   interaction: QtiInteraction,
   update: (value: QtiValue) => void,
   currentValue: QtiValue,
+  messages: PlayerMessageResolver,
 ): HTMLElement {
   const group = responseGroup();
   const width = objectWidth(interaction);
@@ -202,7 +211,10 @@ function renderGraphicGapMatchResponse(
     "qti3-graphic-gap-match-surface",
   );
   surface.role = "group";
-  surface.setAttribute("aria-label", `${readableType(interaction.type)} target image`);
+  surface.setAttribute(
+    "aria-label",
+    messages.message("interactionTargetImage", { type: interaction.type }),
+  );
   surface.style.overflow = "visible";
   surface.style.setProperty(
     "--qti3-graphic-gap-label-block-size",
@@ -213,11 +225,14 @@ function renderGraphicGapMatchResponse(
     appendGraphicObjectImage(
       surface,
       interaction.object,
-      interaction.object.text || `${readableType(interaction.type)} image`,
+      interaction.object.text ||
+        messages.message("interactionImageAlt", { type: interaction.type }),
     );
   }
 
-  const sourceRegion = tokenRegion(`${readableType(interaction.type)} choices`);
+  const sourceRegion = tokenRegion(
+    messages.message("interactionChoicesBank", { type: interaction.type }),
+  );
   sourceRegion.classList.add("qti3-graphic-gap-source-region");
   const choicesWidth = positivePixelValue(interaction.attributes["data-choices-container-width"]);
   if (choicesWidth !== undefined) sourceRegion.style.maxInlineSize = `${choicesWidth}px`;
@@ -260,7 +275,9 @@ function renderGraphicGapMatchResponse(
     commit();
   };
   const targetLabel = (gap: QtiChoice, index: number) =>
-    gap.attributes["aria-label"] || gap.attributes["hotspot-label"] || `Target ${index + 1}`;
+    gap.attributes["aria-label"] ||
+    gap.attributes["hotspot-label"] ||
+    messages.message("graphicGapTargetLabel", { index: index + 1 });
   const renderTargetButton = (gap: QtiChoice, index: number): HTMLButtonElement => {
     const assigned = assignments.get(gap.identifier);
     const label = targetLabel(gap, index);
@@ -271,7 +288,9 @@ function renderGraphicGapMatchResponse(
     button.dataset.selected = assigned ? "true" : "false";
     button.setAttribute(
       "aria-label",
-      assigned ? `${label}, assigned ${assigned.text}` : `${label}, empty`,
+      assigned
+        ? messages.message("gapAssignedState", { label, assigned: assigned.text })
+        : messages.message("gapEmptyState", { label }),
     );
     button.addEventListener("dragover", (event) => {
       event.preventDefault();
@@ -308,8 +327,8 @@ function renderGraphicGapMatchResponse(
     }
     summary.textContent =
       assignments.size > 0
-        ? `${assignments.size} ${assignments.size === 1 ? "label" : "labels"} placed.`
-        : "No labels placed.";
+        ? messages.message("gapLabelsPlacedCount", { count: assignments.size })
+        : messages.message("gapNoLabelsPlaced");
   };
 
   for (const source of sources) {

package/src/interactions/graphic-associate-interaction.ts

@@ -11,18 +11,17 @@ import {
   objectHeight,
   objectWidth,
   placeHotspotButton,
-  readableType,
   responseGroup,
   valueToStrings,
 } from "../interaction-support.js";
-import type { QtiPlayerMessages } from "../player-messages.js";
+import type { PlayerMessageResolver } from "../player-message-resolver.js";
 import { exceedsHotspotMatchMax, maximumAllowedResponses } from "../response-limits.js";
 
 export function renderGraphicAssociateResponse(
   interaction: QtiInteraction,
   update: (value: QtiValue) => void,
   currentValue: QtiValue,
-  messages: QtiPlayerMessages,
+  messages: PlayerMessageResolver,
 ): HTMLElement {
   const group = responseGroup();
 
@@ -47,14 +46,17 @@ export function renderGraphicAssociateResponse(
   const surface = document.createElement("div");
   applyGraphicSurfaceLayout(surface, width, height, "qti3-graphic-associate-surface");
   surface.role = "group";
-  surface.setAttribute("aria-label", `${readableType(interaction.type)} hotspots`);
+  surface.setAttribute(
+    "aria-label",
+    messages.message("interactionHotspots", { type: interaction.type }),
+  );
 
   const object = interaction.object;
   if (object) {
     appendGraphicObjectImage(
       surface,
       object,
-      object.text || `${readableType(interaction.type)} image`,
+      object.text || messages.message("interactionImageAlt", { type: interaction.type }),
     );
   }
 
@@ -69,7 +71,10 @@ export function renderGraphicAssociateResponse(
   summary.setAttribute("aria-live", "polite");
   const pairList = document.createElement("ul");
   pairList.className = "qti3-pair-list";
-  pairList.setAttribute("aria-label", `${readableType(interaction.type)} selected pairs`);
+  pairList.setAttribute(
+    "aria-label",
+    messages.message("interactionSelectedPairsList", { type: interaction.type }),
+  );
 
   const commit = () => {
     if (interaction.responseCardinality === "single") update(selectedPairs[0] ?? null);
@@ -214,18 +219,18 @@ export function renderGraphicAssociateResponse(
       button.dataset.selected = isActive || isPaired ? "true" : "false";
     }
     summary.textContent = selectedHotspot
-      ? messages.hotspotSelectedChooseAnother({
+      ? messages.message("hotspotSelectedChooseAnother", {
           label: hotspotDisplayLabel(selectedHotspot, choices),
         })
       : selectedPairs.length > 0
-        ? messages.associationsMade({ count: selectedPairs.length })
-        : messages.noAssociationsMade();
+        ? messages.message("associationsMade", { count: selectedPairs.length })
+        : messages.message("noAssociationsMade");
     pairList.replaceChildren(
       ...selectedPairs.map((pair) => {
         const [source = "", target = ""] = pair.split(" ");
         const sourceChoice = choices.find((choice) => choice.identifier === source);
         const targetChoice = choices.find((choice) => choice.identifier === target);
-        const pairLabel = messages.associationPairLabel({
+        const pairLabel = messages.message("associationPairLabel", {
           source: sourceChoice ? hotspotDisplayLabel(sourceChoice, choices) : source,
           target: targetChoice ? hotspotDisplayLabel(targetChoice, choices) : target,
         });

package/src/interactions/hotspot-interaction.ts

@@ -7,17 +7,16 @@ import {
   objectHeight,
   objectWidth,
   placeHotspotButton,
-  readableType,
   responseGroup,
   valueToStrings,
 } from "../interaction-support.js";
-import type { QtiPlayerMessages } from "../player-messages.js";
+import type { PlayerMessageResolver } from "../player-message-resolver.js";
 
 export function renderHotspotResponse(
   interaction: QtiInteraction,
   update: (value: QtiValue) => void,
   currentValue: QtiValue,
-  messages: QtiPlayerMessages,
+  messages: PlayerMessageResolver,
 ): HTMLElement {
   const group = responseGroup();
 
@@ -37,7 +36,7 @@ export function renderHotspotResponse(
     appendGraphicObjectImage(
       surface,
       object,
-      object.text || `${readableType(interaction.type)} image`,
+      object.text || messages.message("interactionImageAlt", { type: interaction.type }),
     );
   }
 
@@ -46,7 +45,7 @@ export function renderHotspotResponse(
   const selectedSummary = document.createElement("p");
   selectedSummary.className = "qti3-selection-summary";
   selectedSummary.setAttribute("aria-live", "polite");
-  selectedSummary.textContent = messages.noRegionSelected();
+  selectedSummary.textContent = messages.message("noRegionSelected");
   const syncSelected = () => {
     for (const button of surface.querySelectorAll<HTMLButtonElement>("button")) {
       const isSelected = selected.has(button.dataset.choiceIdentifier ?? "");
@@ -54,7 +53,12 @@ export function renderHotspotResponse(
       button.dataset.selected = isSelected ? "true" : "false";
     }
     selectedSummary.textContent =
-      selected.size > 0 ? `Selected ${[...selected].join(", ")}` : messages.noRegionSelected();
+      selected.size > 0
+        ? messages.message("hotspotSelectionSummary", {
+            selection: [...selected].join(", "),
+            count: selected.size,
+          })
+        : messages.message("noRegionSelected");
   };
   for (const choice of choices) {
     const button = document.createElement("button");

package/src/interactions/inline-choice-interaction.ts

@@ -4,17 +4,17 @@ import {
   missingChoicesMessage,
   valueToStrings,
 } from "../interaction-support.js";
-import type { QtiPlayerMessages } from "../player-messages.js";
+import type { PlayerMessageResolver } from "../player-message-resolver.js";
 import { interactionLabel } from "./interaction-label.js";
 
 function appendOptions(
   select: HTMLSelectElement,
   choices: QtiChoice[],
-  messages: QtiPlayerMessages,
+  messages: PlayerMessageResolver,
 ): void {
   const empty = document.createElement("option");
   empty.value = "";
-  empty.textContent = messages.inlineChoicePrompt();
+  empty.textContent = messages.message("inlineChoicePrompt");
   select.append(empty);
   for (const choice of choices) {
     const option = document.createElement("option");
@@ -28,7 +28,7 @@ export function renderSelect(
   interaction: QtiInteraction,
   update: (value: QtiValue) => void,
   currentValue: QtiValue,
-  messages: QtiPlayerMessages,
+  messages: PlayerMessageResolver,
 ): HTMLElement {
   const choices = interactionChoices(interaction);
   if (choices.length === 0) return missingChoicesMessage(interaction);

package/src/interactions/interaction-registry.ts

@@ -1,5 +1,5 @@
 import type { QtiInteraction, QtiValue } from "@longsightgroup/qti3-core";
-import type { QtiPlayerMessages } from "../player-messages.js";
+import type { PlayerMessageResolver } from "../player-message-resolver.js";
 import { renderGraphicOrderResponse } from "../reorder/graphic-order-interaction.js";
 import { renderOrderedResponse } from "../reorder/order-interaction.js";
 import { renderChoice } from "./choice-interaction.js";
@@ -24,7 +24,7 @@ export interface InteractionResponseContext {
   interaction: QtiInteraction;
   update: (value: QtiValue) => void;
   currentValue: QtiValue;
-  messages: QtiPlayerMessages;
+  messages: PlayerMessageResolver;
   isCompleted: () => boolean;
   endAttempt: () => void;
   renderPortableCustom: (
@@ -81,8 +81,8 @@ export const interactionRegistry: InteractionRegistryEntry[] = [
     id: "gapMatch",
     matches: (interaction) =>
       interaction.type === "gapMatch" || interaction.type === "graphicGapMatch",
-    render: ({ interaction, update, currentValue }) =>
-      renderGapMatchResponse(interaction, update, currentValue),
+    render: ({ interaction, update, currentValue, messages }) =>
+      renderGapMatchResponse(interaction, update, currentValue, messages),
   },
   {
     id: "graphicAssociate",
@@ -117,8 +117,8 @@ export const interactionRegistry: InteractionRegistryEntry[] = [
   {
     id: "choice",
     matches: usesChoiceSet,
-    render: ({ interaction, update, currentValue }) =>
-      renderChoice(interaction, update, currentValue),
+    render: ({ interaction, update, currentValue, messages }) =>
+      renderChoice(interaction, update, currentValue, messages),
   },
   {
     id: "inlineChoice",
@@ -129,8 +129,8 @@ export const interactionRegistry: InteractionRegistryEntry[] = [
   {
     id: "extendedText",
     matches: (interaction) => interaction.type === "extendedText",
-    render: ({ interaction, update, currentValue }) =>
-      renderTextResponse(interaction, update, "extended", currentValue),
+    render: ({ interaction, update, currentValue, messages }) =>
+      renderTextResponse(interaction, update, "extended", currentValue, messages),
   },
   {
     id: "selectPoint",
@@ -159,14 +159,14 @@ export const interactionRegistry: InteractionRegistryEntry[] = [
   {
     id: "textEntry",
     matches: (interaction) => interaction.type === "textEntry",
-    render: ({ interaction, update, currentValue }) =>
-      renderTextResponse(interaction, update, "entry", currentValue),
+    render: ({ interaction, update, currentValue, messages }) =>
+      renderTextResponse(interaction, update, "entry", currentValue, messages),
   },
   {
     id: "slider",
     matches: (interaction) => interaction.type === "slider",
-    render: ({ interaction, update, currentValue }) =>
-      renderSliderResponse(interaction, update, currentValue),
+    render: ({ interaction, update, currentValue, messages }) =>
+      renderSliderResponse(interaction, update, currentValue, messages),
   },
   {
     id: "upload",