@longsightgroup/qti3-player 0.3.0 → 0.5.1

package/README.md

@@ -39,25 +39,133 @@ player?.addEventListener("qti-statechange", (event) => {
 });
 ```
 
-## Player Chrome Messages
+## Scoring Trust Boundary
 
-The player keeps authored QTI content language separate from player chrome such as
-remove buttons. Chrome language defaults to the player `languageOfInterface` property,
-the `language-of-interface` attribute, browser language, document language, then
-English. Hosts can override it when delivery settings require a fixed interface language.
+The player can score attempts locally through `@longsightgroup/qti3-core`, but browser
+scoring is a convenience for validation, feedback, previews, and response snapshots.
+High-stakes assessment systems must treat browser outcomes as untrusted and recompute
+scores server-side from authoritative QTI XML and trusted response variables.
 
-Built-in catalogs are currently available for English, Spanish (`es-MX`, `es-ES`),
-Swedish (`sv-SE`), German (`de-DE`), Portuguese (`pt-BR`, `pt-PT`), and French
-(`fr-FR`, `fr-CA`).
+## Player Chrome Messages (host-owned i18n)
+
+The player keeps **authored QTI content** (prompts, choice labels, `title` on
+end-attempt) separate from **player chrome** (remove buttons, aria labels, live-region
+status, gap labels).
+
+Only **English** ships in the package. `language-of-interface="sv-SE"` does **not**
+change chrome by itself; the host loads a locale file.
+
+### Locale files (recommended)
+
+Harbor or an LMS maintains JSON (or ICU/Fluent exported to JSON) with the shape
+`PlayerMessageCatalog`: a flat `strings` map, optional `interactionTypes`, and
+`directions`. Copy `defaultPlayerMessageCatalog` from the package as the template; omit
+keys you do not need to translate (missing keys fall back to English).
 
 ```ts
-player.languageOfInterface = "es-MX";
-player.messages = {
-  remove: () => "Eliminar",
-  removePair: ({ label }) => `Eliminar ${label}`,
-};
+import type { PlayerMessageCatalog } from "@longsightgroup/qti3-player";
+
+const sv = (await fetch("/locales/player/sv-SE.json")).json() as PlayerMessageCatalog;
+
+player.languageOfInterface = "sv-SE";
+player.messageCatalog = sv;
+await player.loadXml(xml);
 ```
 
+Example entries:
+
+```json
+{
+  "locale": "sv-SE",
+  "strings": {
+    "remove": "Ta bort",
+    "removePair": "Ta bort {label}",
+    "associationPairLabel": "{source} med {target}",
+    "extendedTextCounter": "{characters} tecken, {words} ord",
+    "associationsMade.one": "{count} koppling skapad.",
+    "associationsMade.other": "{count} kopplingar skapade."
+  },
+  "interactionTypes": {
+    "graphicOrder": "Grafisk ordning"
+  },
+  "directions": { "up": "upp", "down": "ner", "left": "vänster", "right": "höger" }
+}
+```
+
+Templates use `{placeholder}` names. For English-style singular/plural, use
+`messageKey.one` and `messageKey.other` (for example `associationsMade.one`). Languages
+that do not inflect by count can use a single key (for example one `extendedTextCounter`
+string for all counts).
+
+Validate locale files in CI with `validatePlayerMessageCatalog()` — pass `JSON.parse` output
+directly (`unknown`). Shape errors (non-object root, missing `strings`, numeric templates, bad
+`directions` / `interactionTypes`) return diagnostics instead of throwing:
+
+```ts
+import { validatePlayerMessageCatalog } from "@longsightgroup/qti3-player";
+
+const raw = JSON.parse(await readFile("locales/player/sv-SE.json", "utf8"));
+const result = validatePlayerMessageCatalog(raw);
+if (!result.valid) {
+  for (const issue of result.diagnostics) {
+    console.error(`${issue.code} ${issue.key}: ${issue.message}`);
+  }
+  process.exit(1);
+}
+```
+
+Use `requireAllKeys: true` only for complete locale files forked from `defaultPlayerMessageCatalog`.
+Partial delivery catalogs should omit that flag.
+
+Reference exports:
+
+- `PLAYER_MESSAGE_KEYS` — message ids from `PLAYER_MESSAGE_MANIFEST`
+- `PLAYER_MESSAGE_STRING_KEYS` — all keys in `defaultPlayerMessageCatalog.strings`
+- `defaultPlayerMessageCatalog` — English template to fork
+- `allowedCatalogPlaceholders(entry)` — placeholders a template may use
+- `requiredCatalogPlaceholders(catalogKey)` — placeholders required for that key per English default
+- `createPlayerMessageResolver(catalog)` — canonical key-driven runtime API
+- `PlayerMessageParams<K>` — typed params for `message(key, params)`
+
+Resolver kinds in the manifest (hosts only edit `strings`; behavior is fixed):
+
+| Resolver              | Meaning                                              |
+| --------------------- | ---------------------------------------------------- |
+| `plain`               | Static string                                        |
+| `template`            | `{placeholder}` interpolation from params            |
+| `plural`              | Uses `key.one` / `key.other` when `count` is present |
+| `typeLabel`           | Interaction type short name from `interactionTypes`  |
+| `typeTemplate`        | Template with `{typeName}` derived from `type`       |
+| `directionTemplate`   | Template with localized `{direction}`                |
+| `extendedTextCounter` | `{characters}`, `{words}`, and unit plural helpers   |
+
+### Runtime API
+
+Chrome resolves to a key-driven `PlayerMessageResolver`:
+
+```ts
+const messages = resolvePlayerMessages(locale, {}, catalog);
+
+messages.message("remove");
+messages.message("removePair", { label: pairLabel });
+messages.message("associationsMade", { count: 2 });
+```
+
+`createPlayerMessageResolver(catalog)` builds the same resolver directly from a locale file.
+
+### Per-message overrides
+
+`player.messages` accepts `QtiPlayerMessageOverrides` — each key uses the same param types as
+`message(key, params)` (for example `removePair: ({ label }) => ...`). Use only when a catalog
+entry is not enough; composed strings (for example `removePair` using `associationPairLabel`
+text) are easy to break.
+
+### Item language vs interface language
+
+Do not copy item `xml:lang` onto `<qti-assessment-item-player lang="...">` unless you
+intentionally want the player element's `lang` attribute to influence
+`defaultPlayerLocale()`. Prefer `player.messageCatalog` for UI chrome.
+
 ## Portable Custom Interactions
 
 For `qti-portable-custom-interaction`, the player renders a
@@ -68,11 +176,43 @@ definition. Host code can attach a PCI runtime and send response/state updates b
 Production sandboxing, CSP, origin policy, and audit logging belong to the host delivery
 system.
 
+## Framework adapters
+
+Optional React and Preact TSX wrappers ship as separate packages. They keep the web component as
+the rendering primitive and only handle framework lifecycle wiring:
+
+- `@longsightgroup/qti3-player-react`
+- `@longsightgroup/qti3-player-preact`
+
+Use the native element directly when you do not need React or Preact integration.
+
+Local manual proof for the React adapter: from the repo root run
+`pnpm dev:adapter-react` and open `/adapter-react.html` (linked from the main manual harness).
+
+## Clearing a loaded item
+
+`clearItem()` (or omitting declarative `xml` on the adapters) removes rendered content and in-memory
+session state. It does not emit `qti-statechange` or other player events because no item is loaded.
+Hosts should treat the prop transition or imperative call as the source of truth.
+
+Framework adapters treat `xml={undefined}` as a clear and `xml=""` as a load attempt. An empty
+string shows the parse error view when the XML is invalid.
+
+Restored `loadOptions.state` reload keys use JSON serialization: equivalent content with different
+object references does not reload, but key order follows construction order and in-place mutation
+without a reload key change is not detected.
+
 ## Styling
 
 The player uses light DOM and is style-neutral by design. Host applications can style
 the rendered `qti3-*` classes directly while preserving the item author's QTI shared
 vocabulary classes.
 
+Screen-reader status lines (`.qti3-selection-summary`, `aria-live="polite"`) are
+visually hidden by default so LMS shells do not show reorder or selection announcements
+to sighted users. They remain available to assistive technology. Set
+`data-show-live-regions` on `qti-assessment-item-player` only in local debug or harness
+pages when you want those messages visible on screen.
+
 See the main repository README for the support matrix and release notes:
 https://github.com/LongsightGroup/qti3

package/dist/index.d.ts

@@ -1,4 +1,15 @@
-export type { QtiPlayerAssociationPairLabelParams, QtiPlayerMessages, QtiPlayerRemoveMessageParams, } from "./player-messages.js";
-export type { QtiAssessmentItemPlayerCustomEventMap, QtiAssessmentItemPlayerEvent, QtiAssessmentItemPlayerEventDetailMap, QtiAssessmentItemPlayerEventName, QtiEndAttemptEventDetail, QtiPlayerFetchXml, QtiPlayerLoadOptions, QtiPlayerMessageOverrides, QtiPlayerResolveAsset, QtiPlayerSessionControl, QtiPortableCustomMountEventDetail, QtiReadyEventDetail, QtiResponseChangeEventDetail, QtiScoreAttemptOptions, QtiScoreEventDetail, QtiStateChangeEventDetail, QtiSuspendEventDetail, QtiValidationEventDetail, } from "./player-types.js";
+export type { QtiPlayerMovementDirection } from "./player-messages.js";
+export type { QtiAttemptStateV1, QtiCatalogSupportResolution, QtiCatalogSupportResolutionOptions, QtiScoreResult, QtiTextToSpeechTraversal, } from "@longsightgroup/qti3-core";
+export type { QtiAssessmentItemPlayerCustomEventMap, QtiAssessmentItemPlayerEvent, QtiAssessmentItemPlayerEventDetailMap, QtiAssessmentItemPlayerEventName, QtiDiagnosticsEventDetail, QtiEndAttemptEventDetail, QtiPlayerFetchXml, QtiPlayerLoadOptions, 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";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mCAAmC,EACnC,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,qCAAqC,EACrC,4BAA4B,EAC5B,qCAAqC,EACrC,gCAAgC,EAChC,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,iCAAiC,EACjC,mBAAmB,EACnB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACvE,YAAY,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,kCAAkC,EAClC,cAAc,EACd,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,qCAAqC,EACrC,4BAA4B,EAC5B,qCAAqC,EACrC,gCAAgC,EAChC,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,iCAAiC,EACjC,mBAAmB,EACnB,4BAA4B,EAC5B,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,2CAA2C,EAC3C,+CAA+C,EAC/C,2CAA2C,EAC3C,2CAA2C,EAC3C,mCAAmC,EACnC,sCAAsC,EACtC,6BAA6B,EAC7B,uCAAuC,GACxC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,wCAAwC,EACxC,4CAA4C,EAC5C,mCAAmC,EACnC,wCAAwC,EACxC,yCAAyC,EACzC,0CAA0C,EAC1C,uCAAuC,EACvC,uCAAuC,EACvC,mCAAmC,EACnC,wCAAwC,EACxC,0CAA0C,GAC3C,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAChG,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,GAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAC3F,YAAY,EACV,8BAA8B,EAC9B,kCAAkC,EAClC,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,2 +1,8 @@
+export { bindQtiAssessmentItemPlayerAdapterEvents, createQtiAssessmentItemPlayerAdapterLoadSync, createQtiAssessmentItemPlayerHandle, isQtiAssessmentItemPlayerAdapterPropName, normalizeQtiAssessmentItemPlayerLoadError, qtiAssessmentItemPlayerAdapterEventEntries, qtiAssessmentItemPlayerAdapterPropNames, qtiAssessmentItemPlayerLoadDependencies, qtiAssessmentItemPlayerLoadStateKey, syncQtiAssessmentItemPlayerAdapterChrome, syncQtiAssessmentItemPlayerAdapterMessages, } from "./player-adapter.js";
+export { PLAYER_MESSAGE_MANIFEST } from "./player-message-manifest.js";
+export { createPlayerMessageResolver, defaultPlayerMessageCatalog, defaultPlayerMessageResolver, extractMessagePlaceholders, formatPlayerMessage, mergePlayerMessageCatalogs, } from "./player-message-catalog.js";
+export { PLAYER_MESSAGE_KEYS, PLAYER_MESSAGE_STRING_KEYS } from "./player-message-keys.js";
+export { allowedCatalogPlaceholders, requiredCatalogPlaceholders, validatePlayerMessageCatalog, } from "./player-message-catalog-validate.js";
+export { resolvePlayerMessages } from "./player-locale.js";
 export { QtiAssessmentItemPlayer, defineQtiAssessmentItemPlayer } from "./player-element.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwCA,OAAO,EACL,wCAAwC,EACxC,4CAA4C,EAC5C,mCAAmC,EACnC,wCAAwC,EACxC,yCAAyC,EACzC,0CAA0C,EAC1C,uCAAuC,EACvC,uCAAuC,EACvC,mCAAmC,EACnC,wCAAwC,EACxC,0CAA0C,GAC3C,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,GAK3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAO3F,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/player-adapter.d.ts

@@ -0,0 +1,62 @@
+import type { QtiAttemptStateV1, QtiCatalogSupportResolution, QtiCatalogSupportResolutionOptions, QtiScoreResult, QtiTextToSpeechTraversal } from "@longsightgroup/qti3-core";
+import type { PlayerMessageCatalog } from "./player-message-catalog.js";
+import type { QtiAssessmentItemPlayer } from "./player-element.js";
+import type { QtiPlayerMessageOverrides } from "./player-message-resolver.js";
+import type { QtiAssessmentItemPlayerEventDetailMap, QtiAssessmentItemPlayerEventName, QtiPlayerFetchXml, QtiPlayerLoadOptions, QtiPlayerResolveAsset, QtiScoreAttemptOptions } from "./player-types.js";
+export type QtiAssessmentItemPlayerAdapterEventPropName = "onReady" | "onResponseChange" | "onStateChange" | "onScore" | "onValidation" | "onSuspend" | "onEndAttempt" | "onPortableCustomMount" | "onDiagnostics" | "onReset" | "onRestore";
+export type QtiAssessmentItemPlayerAdapterPropName = "xml" | "loadOptions" | "languageOfInterface" | "messageCatalog" | "messages" | "onLoadError" | QtiAssessmentItemPlayerAdapterEventPropName;
+export type QtiAssessmentItemPlayerAdapterEventCallback<T extends QtiAssessmentItemPlayerEventName> = (detail: QtiAssessmentItemPlayerEventDetailMap[T]) => void;
+export type QtiAssessmentItemPlayerAdapterEventHandlerProps = {
+    [K in (typeof qtiAssessmentItemPlayerAdapterEventEntries)[number] as K[1]]?: QtiAssessmentItemPlayerAdapterEventCallback<K[0]>;
+};
+export interface QtiAssessmentItemPlayerAdapterProps extends QtiAssessmentItemPlayerAdapterEventHandlerProps {
+    /** Already-prepared candidate-safe XML for delivery, or authoring/preview XML in preview tools. */
+    xml?: string | undefined;
+    loadOptions?: QtiPlayerLoadOptions | undefined;
+    languageOfInterface?: string | undefined;
+    messageCatalog?: PlayerMessageCatalog | undefined;
+    messages?: QtiPlayerMessageOverrides | undefined;
+    onLoadError?: ((error: Error) => void) | undefined;
+}
+export interface QtiAssessmentItemPlayerHandle {
+    readonly element: QtiAssessmentItemPlayer;
+    loadXml(xml: string, options?: QtiPlayerLoadOptions): Promise<void>;
+    loadUrl(url: string, options?: QtiPlayerLoadOptions): Promise<void>;
+    scoreAttempt(options?: QtiScoreAttemptOptions): QtiScoreResult | undefined;
+    restore(state: QtiAttemptStateV1): void;
+    suspend(): void;
+    endAttempt(options?: QtiScoreAttemptOptions): void;
+    reset(): void;
+    clearItem(): void;
+    serialize(): QtiAttemptStateV1 | undefined;
+    getTextToSpeechTraversal(): QtiTextToSpeechTraversal | undefined;
+    getCatalogSupportResolution(options?: QtiCatalogSupportResolutionOptions): QtiCatalogSupportResolution | undefined;
+}
+export declare const qtiAssessmentItemPlayerAdapterEventEntries: readonly [readonly ["qti-ready", "onReady"], readonly ["qti-responsechange", "onResponseChange"], readonly ["qti-statechange", "onStateChange"], readonly ["qti-score", "onScore"], readonly ["qti-validation", "onValidation"], readonly ["qti-suspend", "onSuspend"], readonly ["qti-endattempt", "onEndAttempt"], readonly ["qti-portable-custom-mount", "onPortableCustomMount"], readonly ["qti-diagnostics", "onDiagnostics"], readonly ["qti-reset", "onReset"], readonly ["qti-restore", "onRestore"]];
+export declare const qtiAssessmentItemPlayerAdapterPropNames: readonly ["xml", "loadOptions", "languageOfInterface", "messageCatalog", "messages", "onLoadError", ...("onReady" | "onResponseChange" | "onStateChange" | "onScore" | "onValidation" | "onSuspend" | "onEndAttempt" | "onPortableCustomMount" | "onDiagnostics" | "onReset" | "onRestore")[]];
+export declare function isQtiAssessmentItemPlayerAdapterPropName(name: string): boolean;
+export type QtiAssessmentItemPlayerLoadDependencies = readonly [
+    string | undefined,
+    QtiPlayerLoadOptions["status"] | undefined,
+    boolean | undefined,
+    boolean | undefined,
+    QtiPlayerFetchXml | undefined,
+    QtiPlayerResolveAsset | undefined
+];
+export declare function qtiAssessmentItemPlayerLoadStateKey(state: QtiAttemptStateV1 | undefined): string | undefined;
+export declare function qtiAssessmentItemPlayerLoadDependencies(loadOptions: QtiPlayerLoadOptions | undefined): QtiAssessmentItemPlayerLoadDependencies;
+export declare function bindQtiAssessmentItemPlayerAdapterEvents(element: QtiAssessmentItemPlayer, getProps: () => QtiAssessmentItemPlayerAdapterProps): () => void;
+export declare function syncQtiAssessmentItemPlayerAdapterChrome(element: QtiAssessmentItemPlayer, props: Pick<QtiAssessmentItemPlayerAdapterProps, "languageOfInterface" | "messageCatalog" | "messages">): void;
+/** @deprecated Use {@link syncQtiAssessmentItemPlayerAdapterChrome}. */
+export declare const syncQtiAssessmentItemPlayerAdapterMessages: typeof syncQtiAssessmentItemPlayerAdapterChrome;
+export interface QtiAssessmentItemPlayerAdapterLoadSyncInput {
+    xml?: string | undefined;
+    loadOptions?: QtiPlayerLoadOptions | undefined;
+    onLoadError?: ((error: Error) => void) | undefined;
+}
+export declare function createQtiAssessmentItemPlayerAdapterLoadSync(): {
+    run(element: QtiAssessmentItemPlayer, input: QtiAssessmentItemPlayerAdapterLoadSyncInput): () => void;
+};
+export declare function createQtiAssessmentItemPlayerHandle(getElement: () => QtiAssessmentItemPlayer | null): QtiAssessmentItemPlayerHandle;
+export declare function normalizeQtiAssessmentItemPlayerLoadError(error: unknown): Error;
+//# sourceMappingURL=player-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"player-adapter.d.ts","sourceRoot":"","sources":["../src/player-adapter.ts"],"names":[],"mappings":"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"}

package/dist/player-adapter.js

@@ -0,0 +1,119 @@
+export const qtiAssessmentItemPlayerAdapterEventEntries = [
+    ["qti-ready", "onReady"],
+    ["qti-responsechange", "onResponseChange"],
+    ["qti-statechange", "onStateChange"],
+    ["qti-score", "onScore"],
+    ["qti-validation", "onValidation"],
+    ["qti-suspend", "onSuspend"],
+    ["qti-endattempt", "onEndAttempt"],
+    ["qti-portable-custom-mount", "onPortableCustomMount"],
+    ["qti-diagnostics", "onDiagnostics"],
+    ["qti-reset", "onReset"],
+    ["qti-restore", "onRestore"],
+];
+export const qtiAssessmentItemPlayerAdapterPropNames = [
+    "xml",
+    "loadOptions",
+    "languageOfInterface",
+    "messageCatalog",
+    "messages",
+    "onLoadError",
+    ...qtiAssessmentItemPlayerAdapterEventEntries.map((entry) => entry[1]),
+];
+const qtiAssessmentItemPlayerAdapterPropNameSet = new Set(qtiAssessmentItemPlayerAdapterPropNames);
+export function isQtiAssessmentItemPlayerAdapterPropName(name) {
+    return qtiAssessmentItemPlayerAdapterPropNameSet.has(name);
+}
+export function qtiAssessmentItemPlayerLoadStateKey(state) {
+    if (!state)
+        return undefined;
+    // JSON key order follows insertion order; in-place mutation without reload is not detected.
+    return JSON.stringify(state);
+}
+export function qtiAssessmentItemPlayerLoadDependencies(loadOptions) {
+    return [
+        qtiAssessmentItemPlayerLoadStateKey(loadOptions?.state),
+        loadOptions?.status,
+        loadOptions?.sessionControl?.validateResponses,
+        loadOptions?.sessionControl?.showFeedback,
+        loadOptions?.fetchXml,
+        loadOptions?.resolveAsset,
+    ];
+}
+export function bindQtiAssessmentItemPlayerAdapterEvents(element, getProps) {
+    const removers = qtiAssessmentItemPlayerAdapterEventEntries.map(([eventName, propName]) => {
+        const listener = (event) => {
+            const callback = getProps()[propName];
+            callback?.(event.detail);
+        };
+        element.addEventListener(eventName, listener);
+        return () => element.removeEventListener(eventName, listener);
+    });
+    return () => {
+        for (const remove of removers)
+            remove();
+    };
+}
+export function syncQtiAssessmentItemPlayerAdapterChrome(element, props) {
+    element.languageOfInterface = props.languageOfInterface;
+    element.messageCatalog = props.messageCatalog;
+    element.messages = props.messages;
+}
+/** @deprecated Use {@link syncQtiAssessmentItemPlayerAdapterChrome}. */
+export const syncQtiAssessmentItemPlayerAdapterMessages = syncQtiAssessmentItemPlayerAdapterChrome;
+export function createQtiAssessmentItemPlayerAdapterLoadSync() {
+    let loadSequence = 0;
+    return {
+        run(element, input) {
+            if (input.xml === undefined) {
+                loadSequence += 1;
+                element.clearItem();
+                return () => { };
+            }
+            let active = true;
+            const sequence = (loadSequence += 1);
+            void element
+                .loadXml(input.xml, input.loadOptions)
+                .then(() => {
+                if (!active || sequence !== loadSequence)
+                    return;
+            })
+                .catch((error) => {
+                if (!active || sequence !== loadSequence)
+                    return;
+                input.onLoadError?.(normalizeQtiAssessmentItemPlayerLoadError(error));
+            });
+            return () => {
+                active = false;
+            };
+        },
+    };
+}
+export function createQtiAssessmentItemPlayerHandle(getElement) {
+    return {
+        get element() {
+            return requiredElement(getElement);
+        },
+        loadXml: (xml, options) => requiredElement(getElement).loadXml(xml, options),
+        loadUrl: (url, options) => requiredElement(getElement).loadUrl(url, options),
+        scoreAttempt: (options) => requiredElement(getElement).scoreAttempt(options),
+        restore: (state) => requiredElement(getElement).restore(state),
+        suspend: () => requiredElement(getElement).suspend(),
+        endAttempt: (options) => requiredElement(getElement).endAttempt(options),
+        reset: () => requiredElement(getElement).reset(),
+        clearItem: () => requiredElement(getElement).clearItem(),
+        serialize: () => requiredElement(getElement).serialize(),
+        getTextToSpeechTraversal: () => requiredElement(getElement).getTextToSpeechTraversal(),
+        getCatalogSupportResolution: (options) => requiredElement(getElement).getCatalogSupportResolution(options),
+    };
+}
+export function normalizeQtiAssessmentItemPlayerLoadError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+function requiredElement(getElement) {
+    const element = getElement();
+    if (!element)
+        throw new Error("QTI assessment item player element is not mounted.");
+    return element;
+}
+//# sourceMappingURL=player-adapter.js.map

package/dist/player-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"player-adapter.js","sourceRoot":"","sources":["../src/player-adapter.ts"],"names":[],"mappings":"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"}

package/dist/player-dev.d.ts

@@ -0,0 +1,4 @@
+/** True when dev warnings are enabled (non-production Node, or browser without NODE_ENV). */
+export declare function playerDevWarningsEnabled(): boolean;
+export declare function warnPlayerMessageOnce(code: string, message: string): void;
+//# sourceMappingURL=player-dev.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"player-dev.d.ts","sourceRoot":"","sources":["../src/player-dev.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,wBAAgB,wBAAwB,IAAI,OAAO,CAIlD;AAID,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAIzE"}

package/dist/player-dev.js

@@ -0,0 +1,14 @@
+/** True when dev warnings are enabled (non-production Node, or browser without NODE_ENV). */
+export function playerDevWarningsEnabled() {
+    const nodeEnv = globalThis.process?.env
+        ?.NODE_ENV;
+    return nodeEnv !== "production";
+}
+const warnedKeys = new Set();
+export function warnPlayerMessageOnce(code, message) {
+    if (!playerDevWarningsEnabled() || warnedKeys.has(code))
+        return;
+    warnedKeys.add(code);
+    console.warn(`[qti3-player] ${message}`);
+}
+//# sourceMappingURL=player-dev.js.map

package/dist/player-dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"player-dev.js","sourceRoot":"","sources":["../src/player-dev.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,MAAM,UAAU,wBAAwB;IACtC,MAAM,OAAO,GAAI,UAA4D,CAAC,OAAO,EAAE,GAAG;QACxF,EAAE,QAAQ,CAAC;IACb,OAAO,OAAO,KAAK,YAAY,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;AAErC,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,OAAe;IACjE,IAAI,CAAC,wBAAwB,EAAE,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO;IAChE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/player-element.d.ts

@@ -1,5 +1,7 @@
 import { type QtiAttemptStateV1, type QtiScoreResult, type QtiCatalogSupportResolution, type QtiCatalogSupportResolutionOptions, type QtiTextToSpeechTraversal } from "@longsightgroup/qti3-core";
-import type { QtiPlayerLoadOptions, QtiPlayerMessageOverrides, QtiScoreAttemptOptions } from "./player-types.js";
+import type { PlayerMessageCatalog } from "./player-message-catalog.js";
+import type { QtiPlayerMessageOverrides } from "./player-message-resolver.js";
+import type { QtiPlayerLoadOptions, QtiScoreAttemptOptions } from "./player-types.js";
 declare const HTMLElementBase: typeof HTMLElement;
 export declare class QtiAssessmentItemPlayer extends HTMLElementBase {
     static get observedAttributes(): string[];
@@ -9,17 +11,28 @@ export declare class QtiAssessmentItemPlayer extends HTMLElementBase {
     private validationMessages;
     private authoringDiagnostics;
     private languageOfInterfaceOverride;
+    private messageCatalogOverride;
     private messageOverrides;
+    private resolvedMessagesCache;
     private sessionControl;
+    private loadGeneration;
     get languageOfInterface(): string;
     set languageOfInterface(value: string | undefined);
     get locale(): string;
     set locale(value: string | undefined);
     get messages(): QtiPlayerMessageOverrides;
     set messages(value: QtiPlayerMessageOverrides | undefined);
+    get messageCatalog(): PlayerMessageCatalog | undefined;
+    set messageCatalog(value: PlayerMessageCatalog | undefined);
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    private invalidatePlayerMessages;
+    /** Clears the loaded item. Does not emit player events; declarative hosts control this via `xml`. */
+    clearItem(): void;
     loadXml(xml: string, options?: QtiPlayerLoadOptions): Promise<void>;
     loadUrl(url: string, options?: QtiPlayerLoadOptions): Promise<void>;
+    private beginLoad;
+    private isCurrentLoad;
+    private applyLoadedXml;
     scoreAttempt(options?: QtiScoreAttemptOptions): QtiScoreResult | undefined;
     reset(): void;
     restore(state: QtiAttemptStateV1): void;

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

@@ -1 +1 @@
-{"version":3,"file":"player-element.d.ts","sourceRoot":"","sources":["../src/player-element.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,iBAAiB,EAMtB,KAAK,cAAc,EACnB,KAAK,2BAA2B,EAChC,KAAK,kCAAkC,EACvC,KAAK,wBAAwB,EAE9B,MAAM,2BAA2B,CAAC;AA6BnC,OAAO,KAAK,EAGV,oBAAoB,EACpB,yBAAyB,EAGzB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAQ3B,QAAA,MAAM,eAAe,EAAE,OAAO,WAOO,CAAC;AAEtC,qBAAa,uBAAwB,SAAQ,eAAe;IAC1D,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAED,OAAO,CAAC,aAAa,CAAC,CAAc;IACpC,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,2BAA2B,CAAqB;IACxD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,cAAc,CAGpB;IAEF,IAAI,mBAAmB,IAAI,MAAM,CAOhC;IAED,IAAI,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAGhD;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAEnC;IAED,IAAI,QAAQ,IAAI,yBAAyB,CAExC;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,yBAAyB,GAAG,SAAS,EAGxD;IAED,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAOxF,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCvE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7E,YAAY,CAAC,OAAO,GAAE,sBAA2B,GAAG,cAAc,GAAG,SAAS;IA8B9E,KAAK,IAAI,IAAI;IAUb,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAqBvC,OAAO,IAAI,IAAI;IASf,UAAU,CAAC,OAAO,GAAE,sBAA2B,GAAG,IAAI;IAgBtD,SAAS,IAAI,iBAAiB,GAAG,SAAS;IAU1C,wBAAwB,IAAI,wBAAwB,GAAG,SAAS;IAKhE,2BAA2B,CACzB,OAAO,GAAE,kCAAuC,GAC/C,2BAA2B,GAAG,SAAS;IAK1C,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,MAAM;IAcd,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,cAAc;IAmCtB,OAAO,CAAC,4BAA4B;IAuBpC,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,yBAAyB;IAQjC,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,yBAAyB;IAiBjC,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,yBAAyB;IAIjC,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,cAAc;CASvB;AAED,wBAAgB,6BAA6B,IAAI,IAAI,CAIpD;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,4BAA4B,EAAE,uBAAuB,CAAC;KACvD;CACF"}
+{"version":3,"file":"player-element.d.ts","sourceRoot":"","sources":["../src/player-element.ts"],"names":[],"mappings":"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"}