@pie-players/pie-assessment-player 0.3.74 → 0.3.75

package/README.md

@@ -43,10 +43,10 @@ pending or failed, and after disconnect. A waiter resolves to `null` when its
 active attempt fails or is retired, or its own timeout expires. A waiter's
 timeout does not cancel a still-active initialization.
 
-Connect the element and assign `assessmentId`, `attemptId`, `assessment`, and
-`hooks` in the same turn, or assign them before connecting. These assignments
-are batched; changing assessment, attempt, or hooks later retires the previous
-controller and starts a new one. Replace object properties to update them;
+Connect the element and assign `assessmentId`, `attemptId`, `assessment`,
+`hooks` and `session` in the same turn, or assign them before connecting. These
+assignments are batched; changing assessment, attempt, hooks or session later
+retires the previous controller and starts a new one. Replace object properties to update them;
 mutating a previously assigned object in place is not an update signal. Runtime
 props, locale, and navigation visibility do not reload the assessment.
 
@@ -71,7 +71,8 @@ controller.navigateTo("section-2");
 controller.navigateNext();
 controller.navigatePrevious();
 
-// persist on whatever cadence the host wants; submit() always persists.
+// persist on whatever cadence the host wants; saves run in call order.
+// submit() saves first and rejects, unsubmitted, if that save fails.
 await controller.persist();
 await controller.submit();
 unsubscribe();
@@ -82,10 +83,20 @@ shape the persistence strategy load/save methods exchange and the same
 shape per-section bridges roll up into via `updateSectionSession(sectionId,
 snapshot)`.
 
+The element's `session` property takes that shape too. The controller's first
+hydrate applies an assigned session in place of the strategy's `loadSession`;
+the strategy still receives every `persist()`. The value is consumed once: a
+rebuild for another reason, such as an `assessment` change, hydrates from the
+strategy. Assigning a session equal to the controller's, as writing
+`assessment-session-changed` back into the property does, is a no-op, and so is
+`null` once the controller is ready. Reading `session` returns the assigned value
+until the controller is ready and a copy of the controller's session after.
+
 The default element captures the outgoing section before navigation replaces it,
-including navigation through the controller. A returning section waits for its
-canonical `engine-ready` stage and restores its saved section snapshot before
-accepting input or session updates. The section region stays `aria-busy` during
+including navigation through the controller. A returning section receives its
+saved section snapshot as the section player's `session` property, which its
+controller applies before the canonical `engine-ready` stage; the section accepts
+input and session updates from `engine-ready` on. The section region stays `aria-busy` during
 this handoff. Failed restoration leaves the saved snapshot intact, reports
 `assessment-error` and `onError` with phase `navigation`, and offers Retry.
 Navigating away or disconnecting retires that handoff. This in-memory restoration
@@ -101,7 +112,8 @@ change only — section-level events flow through the embedded
 
 - `assessment-route-changed` — section-level navigation moved (index / id,
   `previousSectionId`, `canNext` / `canPrevious`).
-- `assessment-session-applied` — `hydrate()` loaded a persisted session.
+- `assessment-session-applied` — `hydrate()` applied a session, persisted or
+  assigned as `session`.
 - `assessment-session-changed` — assessment session mutated (navigation,
   per-section snapshot upsert). The active section's snapshot is upserted once
   for each `session-changed` it emits.
@@ -207,15 +219,18 @@ import * as delivery from "@pie-element/multiple-choice/browser/delivery";
 import * as controller from "@pie-element/multiple-choice/browser/controller";
 import manifest from "../package.json"; // pins "@pie-element/multiple-choice" exactly
 
-registerPreloadedElements([
-  {
-    tag: "pie-element-multiple-choice",
-    package: "@pie-element/multiple-choice",
-    version: manifest.dependencies["@pie-element/multiple-choice"],
-    element: delivery,
-    controller,
-  },
-]);
+registerPreloadedElements(
+  [
+    {
+      tag: "pie-element-multiple-choice",
+      package: "@pie-element/multiple-choice",
+      version: manifest.dependencies["@pie-element/multiple-choice"],
+      element: delivery,
+      controller,
+    },
+  ],
+  { math: { assetRoot: "https://assets.example.com/npm" } },
+);
 ```
 
 - A tag missing at pre-warm leaves the section's items unmounted and raises a
@@ -231,6 +246,10 @@ registerPreloadedElements([
   an element can typeset with a MathJax it was not built for. Elements that
   bundle their own MathJax share none
   ([One MathJax version per page](../../docs/item-player/loading-strategies.md#one-mathjax-version-per-page)).
+- Pass `math.assetRoot`, an npm root serving the fonts and speech the elements'
+  bundled MathJax loads, or `math.assetUrls`, each file's URL; without either,
+  elements on adapter 0.1.3 or later render without web fonts and speech
+  ([MathJax assets](../../docs/item-player/loading-strategies.md#mathjax-assets)).
 - Register one version per package; registering a second version throws.
 - Register each package's `controller` unless the item players are hosted
   (`sectionPlayerRuntime.player.hosted`, or an enabled

package/dist/components/AssessmentPlayerDefaultElement.d.ts

@@ -1,7 +1,7 @@
 import { Env } from '@pie-players/pie-players-shared/types';
 import { AssessmentControllerHandle } from '../controller/AssessmentController.js';
 import { AssessmentPlayerProgressSnapshot, AssessmentPlayerRuntimeHostContract, AssessmentPlayerSnapshot } from '../contracts/runtime-host-contract.js';
-import { AssessmentDefinition, AssessmentPlayerHooks, AssessmentPlayerRuntimeConfig } from '../types.js';
+import { AssessmentDefinition, AssessmentPlayerHooks, AssessmentPlayerRuntimeConfig, AssessmentSession } from '../types.js';
 export declare class AssessmentPlayerDefaultElement extends HTMLElement implements AssessmentPlayerRuntimeHostContract {
     static get observedAttributes(): string[];
     private _assessmentId;
@@ -16,6 +16,13 @@ export declare class AssessmentPlayerDefaultElement extends HTMLElement implemen
     private _env;
     private _coordinator;
     private _hooks;
+    /**
+     * The assigned session until a controller initializes from it. A later
+     * rebuild, such as one an `assessment` change causes, hydrates from the
+     * persistence strategy rather than reapplying a value the learner has since
+     * moved past.
+     */
+    private pendingSession;
     private _showNavigation;
     private _sectionPlayerLayout;
     private _playerType;
@@ -63,6 +70,12 @@ export declare class AssessmentPlayerDefaultElement extends HTMLElement implemen
     set assessment(value: AssessmentDefinition | null);
     get hooks(): AssessmentPlayerHooks | null;
     set hooks(value: AssessmentPlayerHooks | null);
+    /**
+     * Before a controller is ready, the assigned session; after, a copy of the
+     * controller's.
+     */
+    get session(): AssessmentSession | null;
+    set session(value: AssessmentSession | null);
     get locale(): string;
     set locale(value: string);
     get env(): Env | null;
@@ -133,6 +146,10 @@ export declare class AssessmentPlayerDefaultElement extends HTMLElement implemen
     private updateCurrentSectionRuntime;
     private cleanupTtsForSectionNavigation;
     private syncCurrentSectionSessionIntoAssessment;
+    /**
+     * `restoring` is whether the section was handed a saved session, which it
+     * applies while it creates its controller, before `engine-ready`.
+     */
     private attachSectionControllerReadyListener;
     private render;
     /** Locale and chrome changes must not remount a section or reload its attempt. */

package/dist/components/assessment-section-player-runtime.d.ts

@@ -3,6 +3,7 @@ import { AssessmentPlayerRuntimeConfig } from '../types.js';
 export type ResolveAssessmentSectionPlayerRuntimeArgs = {
     sectionPlayerRuntime?: AssessmentPlayerRuntimeConfig["sectionPlayerRuntime"];
     playerType: "iife" | "esm" | "preloaded";
+    assessmentId?: string;
     attemptId?: string;
     env?: Record<string, unknown> | null;
     coordinator?: unknown;

package/dist/controller/AssessmentController.d.ts

@@ -83,8 +83,8 @@ export interface AssessmentControllerHandle {
      * persistence strategy.
      *
      * Hosts call this on whatever cadence they choose (debounced on
-     * change, on visibility change, on submit). `submit()` always
-     * `persist()`s as its final step.
+     * change, on visibility change, on submit). Saves run in call order.
+     * A failed save goes to `onError` and the returned promise resolves.
      */
     persist(): Promise<void>;
     /**
@@ -123,9 +123,9 @@ export interface AssessmentControllerHandle {
      */
     navigatePrevious(): boolean;
     /**
-     * Mark the assessment as submitted, emit
-     * `assessment-submission-state-changed`, and `persist()` the final
-     * snapshot.
+     * Save the final snapshot, then mark the assessment as submitted and
+     * emit `assessment-submission-state-changed`. A failed save goes to
+     * `onError` and rejects, and the assessment stays unsubmitted.
      */
     submit(): Promise<void>;
     /**
@@ -174,16 +174,25 @@ export declare class AssessmentController implements AssessmentControllerHandle
     private session;
     private readiness;
     private submitted;
+    private saveQueue;
     private persistenceStrategy?;
     private initializationPromise?;
     private disposalPromise?;
     private disposed;
     private readonly storageContext;
+    /** Taken by the first hydrate; a later `hydrate()` loads from the strategy. */
+    private initialSession;
     constructor(args: {
         assessmentId: string;
         attemptId?: string;
         assessment: AssessmentDefinition | null;
         hooks?: AssessmentPlayerHooks;
+        /**
+         * A host-supplied session, applied by the first hydrate in place of the
+         * persistence strategy's `loadSession` result. The controller keeps a
+         * copy, so later updates never write into the host's object.
+         */
+        initialSession?: AssessmentSession | null;
     });
     private emit;
     private assertActive;
@@ -196,6 +205,11 @@ export declare class AssessmentController implements AssessmentControllerHandle
     hydrate(): Promise<void>;
     dispose(): Promise<void>;
     persist(): Promise<void>;
+    /**
+     * Saves run one at a time, in call order, so a slow older write can never
+     * land after a newer one. A failed save rejects only its own caller.
+     */
+    private save;
     getSession(): AssessmentSession | null;
     getRuntimeState(): AssessmentControllerRuntimeState;
     private buildNavigationSnapshot;

package/dist/{nl-NL-BVlv1TF9.js → nl-NL-CfezB59b.js}

@@ -306,30 +306,6 @@ var e = {
     textToSpeech: {
       name: "Voorlezen",
       description: "Inhoud laten voorlezen",
-      toolA11y: "Voorleeshulp",
-      title: "Voorlezen",
-      initializing: "Wordt gestart…",
-      initFailed: "Voorlezen kon niet worden gestart.",
-      selectText: "Selecteer tekst op de pagina om die te laten voorlezen.",
-      speed: "Snelheid:",
-      play: "Voorlezen",
-      pause: "Pauzeren",
-      resume: "Hervatten",
-      stop: "Stoppen",
-      speaking: "Aan het voorlezen…",
-      paused: "Gepauzeerd",
-      charactersSelected: {
-        one: "{count} teken geselecteerd",
-        other: "{count} tekens geselecteerd"
-      },
-      rate: {
-        slow: "Langzaam",
-        slower: "Langzamer",
-        normal: "Normaal",
-        faster: "Sneller",
-        fast: "Snel",
-        veryFast: "Zeer snel"
-      },
       inline: {
         controlsA11y: "Voorleesknoppen",
         playbackSpeedA11y: "Voorleessnelheid",
@@ -435,6 +411,7 @@ var e = {
       resolvedTools: "Toegekende hulpmiddelen (toolkit)",
       provenanceSummary: "Overzicht van herkomst van het hulpmiddelenbeleid",
       perToolDecisions: "Beslissingen per hulpmiddel",
+      policyDiagnostics: "Diagnose van het hulpmiddelenbeleid",
       profileReadOnly: "PNP-profiel (alleen lezen)"
     },
     tts: {

package/dist/pie-assessment-player.js

@@ -1,46 +1,44 @@
-import "@pie-players/pie-section-player/components/section-player-splitpane-element";
-import "@pie-players/pie-section-player/components/section-player-vertical-element";
-import { SECTION_PLAYER_PUBLIC_EVENTS as N } from "@pie-players/pie-section-player/contracts/public-events";
-import { coerceBooleanLike as R, defineCustomElementSafely as B } from "@pie-players/pie-players-shared";
-import { createNewAssessmentSession as V, frameworkErrorFromUnknown as Q, setCurrentSectionPosition as J, upsertSectionSession as K } from "@pie-players/pie-assessment-toolkit";
-var b = (e) => {
+import "@pie-players/pie-section-player";
+import { coerceBooleanLike as R, defineCustomElementSafely as O } from "@pie-players/pie-players-shared";
+import { createNewAssessmentSession as Q, frameworkErrorFromUnknown as J, setCurrentSectionPosition as K, upsertSectionSession as Y } from "@pie-players/pie-assessment-toolkit";
+var y = (e) => {
   if (e === null || typeof e != "object") return e;
-  if (Array.isArray(e)) return e.map(b);
+  if (Array.isArray(e)) return e.map(y);
   const t = {};
-  for (const i in e) Object.hasOwn(e, i) && (t[i] = b(e[i]));
+  for (const i in e) Object.hasOwn(e, i) && (t[i] = y(e[i]));
   return t;
 };
-function S(e) {
+function w(e) {
   "@babel/helpers - typeof";
-  return S = typeof Symbol == "function" && typeof Symbol.iterator == "symbol" ? function(t) {
+  return w = typeof Symbol == "function" && typeof Symbol.iterator == "symbol" ? function(t) {
     return typeof t;
   } : function(t) {
     return t && typeof Symbol == "function" && t.constructor === Symbol && t !== Symbol.prototype ? "symbol" : typeof t;
-  }, S(e);
+  }, w(e);
 }
-function Y(e, t) {
-  if (S(e) != "object" || !e) return e;
+function Z(e, t) {
+  if (w(e) != "object" || !e) return e;
   var i = e[Symbol.toPrimitive];
   if (i !== void 0) {
     var s = i.call(e, t || "default");
-    if (S(s) != "object") return s;
+    if (w(s) != "object") return s;
     throw new TypeError("@@toPrimitive must return a primitive value.");
   }
   return (t === "string" ? String : Number)(e);
 }
-function Z(e) {
-  var t = Y(e, "string");
-  return S(t) == "symbol" ? t : t + "";
+function X(e) {
+  var t = Z(e, "string");
+  return w(t) == "symbol" ? t : t + "";
 }
-function g(e, t, i) {
-  return (t = Z(t)) in e ? Object.defineProperty(e, t, {
+function f(e, t, i) {
+  return (t = X(t)) in e ? Object.defineProperty(e, t, {
     value: i,
     enumerable: !0,
     configurable: !0,
     writable: !0
   }) : e[t] = i, e;
 }
-function O(e, t) {
+function H(e, t) {
   const i = `[${e}]`;
   return {
     debug: (s, ...n) => {
@@ -51,22 +49,35 @@ function O(e, t) {
     error: (s, ...n) => console.error(i, s, ...n)
   };
 }
-function H() {
+function q() {
   return typeof window < "u" && window.PIE_DEBUG === !0;
 }
-function q(e) {
+function G(e) {
   if (!e || typeof e != "object") return !1;
   const t = e;
   return typeof t.providerId == "string" && typeof t.providerName == "string" && typeof t.initialize == "function" && typeof t.trackError == "function" && typeof t.trackEvent == "function" && typeof t.destroy == "function" && typeof t.isReady == "function";
 }
-var X = O("instrumentation-event-bridge", () => H());
-function ee(e) {
-  return e && typeof e == "object" ? e : typeof e > "u" ? {} : { value: e };
-}
+var ee = H("instrumentation-event-bridge", () => q());
 function te(e) {
-  X.warn(`[InstrumentationEventBridge:${e}] Ignoring invalid instrumentation provider; expected InstrumentationProvider contract`);
+  if (e === null) return !0;
+  const t = typeof e;
+  if (t === "function" || t === "symbol") return !1;
+  if (t !== "object" || Array.isArray(e)) return !0;
+  const i = Object.getPrototypeOf(e);
+  return i === Object.prototype || i === null;
 }
 function ie(e) {
+  if (e && typeof e == "object") {
+    const t = {};
+    for (const [i, s] of Object.entries(e)) te(s) && (t[i] = s);
+    return t;
+  }
+  return typeof e > "u" ? {} : { value: e };
+}
+function se(e) {
+  ee.warn(`[InstrumentationEventBridge:${e}] Ignoring invalid instrumentation provider; expected InstrumentationProvider contract`);
+}
+function ne(e) {
   try {
     e.provider.trackError(e.error instanceof Error ? e.error : new Error(String(e.error ?? "Unknown instrumentation bridge error")), {
       component: e.component,
@@ -76,13 +87,13 @@ function ie(e) {
   } catch {
   }
 }
-function se(e) {
+function oe(e) {
   if (!e.host || !e.eventMap.length) return () => {
   };
   if (!e.instrumentationProvider) return () => {
   };
-  if (!q(e.instrumentationProvider))
-    return e.debug && te(e.component), () => {
+  if (!G(e.instrumentationProvider))
+    return e.debug && se(e.component), () => {
     };
   const t = e.instrumentationProvider, i = [], s = Math.max(0, e.dedupeWindowMs ?? 0), n = /* @__PURE__ */ new Map(), o = (r, a) => {
     const h = [
@@ -99,7 +110,7 @@ function se(e) {
     const a = (h) => {
       try {
         if (!t.isReady() || e.shouldTrackEvent && !e.shouldTrackEvent(h)) return;
-        const d = ee(h.detail), c = (/* @__PURE__ */ new Date()).toISOString(), m = {
+        const d = ie(h.detail), c = (/* @__PURE__ */ new Date()).toISOString(), p = {
           ...d,
           ...e.staticAttributes,
           component: e.component,
@@ -107,13 +118,13 @@ function se(e) {
           timestamp: c
         };
         if (s > 0) {
-          const u = Date.now(), l = o(r, m), f = n.get(l);
-          if (typeof f == "number" && u - f < s) return;
+          const u = Date.now(), l = o(r, p), m = n.get(l);
+          if (typeof m == "number" && u - m < s) return;
           n.set(l, u);
         }
-        t.trackEvent(r.instrumentationEventName, { ...m });
+        t.trackEvent(r.instrumentationEventName, { ...p });
       } catch (d) {
-        ie({
+        ne({
           provider: t,
           component: e.component,
           error: d,
@@ -133,15 +144,15 @@ function T(e) {
   const t = e;
   return typeof t?.noticeError == "function" && typeof t.addPageAction == "function";
 }
-function y() {
+function b() {
   if (typeof window > "u") return;
   const { newrelic: e, NREUM: t } = window;
   if (T(e)) return e;
   if (T(t)) return t;
 }
-var ne = class {
+var re = class {
   constructor() {
-    g(this, "initialized", !1), g(this, "config", void 0);
+    f(this, "initialized", !1), f(this, "config", void 0);
   }
   trackError(e, t) {
     if (!this.guardedOperation("trackError", e, t) || !this.applyErrorFilter(e, t)) return;
@@ -203,31 +214,31 @@ var ne = class {
   transformAttributes(e) {
     return this.config?.attributeTransformer ? this.config.attributeTransformer(e) : e;
   }
-}, oe = class extends ne {
+}, ae = class extends re {
   constructor(...e) {
-    super(...e), g(this, "providerId", "newrelic"), g(this, "providerName", "New Relic");
+    super(...e), f(this, "providerId", "newrelic"), f(this, "providerName", "New Relic");
   }
   async initialize(e) {
-    this.config = e, this.initialized = !0, this.config?.debug && console.log(y() ? "[NewRelicProvider] Initialized successfully" : "[NewRelicProvider] Initialized; sends once the New Relic agent is on the page");
+    this.config = e, this.initialized = !0, this.config?.debug && console.log(b() ? "[NewRelicProvider] Initialized successfully" : "[NewRelicProvider] Initialized; sends once the New Relic agent is on the page");
   }
   isReady() {
-    return this.initialized && y() !== void 0;
+    return this.initialized && b() !== void 0;
   }
   destroy() {
     this.initialized = !1, this.config?.debug && console.log("[NewRelicProvider] Destroyed");
   }
   doTrackError(e, t) {
-    y()?.noticeError(e, t);
+    b()?.noticeError(e, t);
   }
   doTrackEvent(e, t) {
-    y()?.addPageAction(e, t);
+    b()?.addPageAction(e, t);
   }
   doSetUserContext(e, t) {
-    const i = y();
+    const i = b();
     if (typeof i?.setUserId == "function" && i.setUserId(e), t && typeof i?.setCustomAttribute == "function") for (const [s, n] of Object.entries(t)) i.setCustomAttribute(s, n);
   }
   doSetGlobalAttributes(e) {
-    const t = y();
+    const t = b();
     if (typeof t?.setCustomAttribute == "function") for (const [i, s] of Object.entries(e)) t.setCustomAttribute(i, s);
   }
 };
@@ -251,25 +262,25 @@ function F(e) {
   const t = e.trackPageActions;
   return typeof t == "boolean" ? t : void 0;
 }
-function re(e, t) {
+function le(e, t) {
   return e.kind === "value" || e.kind === "null" ? e : t;
 }
-var I, ae = O("instrumentation-provider-resolution", () => H());
-function le() {
-  return I || (I = new oe(), I.initialize()), I;
+var I, ce = H("instrumentation-provider-resolution", () => q());
+function de() {
+  return I || (I = new ae(), I.initialize()), I;
 }
-function ce(e) {
-  const t = D(e.runtimePlayer), i = D(e.player), s = F(t), n = F(i), o = s ?? n ?? !1, r = re(M(t), M(i));
+function ue(e) {
+  const t = D(e.runtimePlayer), i = D(e.player), s = F(t), n = F(i), o = s ?? n ?? !1, r = le(M(t), M(i));
   if (r.kind !== "null") {
-    if (r.kind === "unset") return o ? le() : void 0;
-    if (q(r.value)) return r.value;
+    if (r.kind === "unset") return o ? de() : void 0;
+    if (G(r.value)) return r.value;
     if (e.debug) {
       const a = e.component ? `[${e.component}] ` : "";
-      ae.warn(`${a}Ignoring invalid instrumentation provider; expected InstrumentationProvider contract`);
+      ce.warn(`${a}Ignoring invalid instrumentation provider; expected InstrumentationProvider contract`);
     }
   }
 }
-var de = [
+var he = [
   {
     sourceEventName: "assessment-controller-ready",
     instrumentationEventName: "pie-assessment-controller-ready"
@@ -302,17 +313,17 @@ var de = [
     sourceEventName: "assessment-error",
     instrumentationEventName: "pie-assessment-error"
   }
-], ue = { "nl-NL": () => import("./nl-NL-BVlv1TF9.js") }, he = ["en-US", "nl-NL"];
-async function pe(e) {
-  const t = ue[e];
+], pe = { "nl-NL": () => import("./nl-NL-CfezB59b.js") }, me = ["en-US", "nl-NL"];
+async function ge(e) {
+  const t = pe[e];
   if (!t) throw new Error(`No bundled i18n catalog for locale: ${e}`);
   return (await t()).default;
 }
-function w(e) {
+function A(e) {
   return e ? e.trim().replace(/_/g, "-").split(/[.@]/)[0].toLowerCase() : "";
 }
-function me(e) {
-  const t = w(e);
+function fe(e) {
+  const t = A(e);
   if (!t) return [];
   const i = t.split("-"), s = [];
   for (let n = i.length; n > 0; n--) {
@@ -321,13 +332,13 @@ function me(e) {
   }
   return s;
 }
-function ge(e, t) {
-  for (const i of me(e)) {
-    const s = t.find((n) => w(n) === i);
+function ye(e, t) {
+  for (const i of fe(e)) {
+    const s = t.find((n) => A(n) === i);
     if (s != null) return s;
   }
 }
-var fe = {
+var ve = {
   common: {
     close: "Close",
     cancel: "Cancel",
@@ -635,30 +646,6 @@ var fe = {
     textToSpeech: {
       name: "Text to Speech",
       description: "Read content aloud",
-      toolA11y: "Text-to-speech tool",
-      title: "Text-to-Speech",
-      initializing: "Initializing…",
-      initFailed: "Failed to initialize text-to-speech.",
-      selectText: "Select text on the page to read it aloud.",
-      speed: "Speed:",
-      play: "Play",
-      pause: "Pause",
-      resume: "Resume",
-      stop: "Stop",
-      speaking: "Speaking…",
-      paused: "Paused",
-      charactersSelected: {
-        one: "{count} character selected",
-        other: "{count} characters selected"
-      },
-      rate: {
-        slow: "Slow",
-        slower: "Slower",
-        normal: "Normal",
-        faster: "Faster",
-        fast: "Fast",
-        veryFast: "Very Fast"
-      },
       inline: {
         controlsA11y: "Reading controls",
         playbackSpeedA11y: "Playback speed",
@@ -764,6 +751,7 @@ var fe = {
       resolvedTools: "Resolved Tools (toolkit)",
       provenanceSummary: "Tool Policy Provenance Summary",
       perToolDecisions: "Per-Tool Decisions",
+      policyDiagnostics: "Policy Diagnostics",
       profileReadOnly: "PNP Profile (read-only)"
     },
     tts: {
@@ -834,7 +822,7 @@ var fe = {
       coordinatorUnavailable: "Toolkit coordinator is not available for text-to-speech updates."
     }
   }
-}, k = "en-US", ye = /* @__PURE__ */ new Set([
+}, k = "en-US", be = /* @__PURE__ */ new Set([
   "ar",
   "ckb",
   "dv",
@@ -850,7 +838,7 @@ var fe = {
   "ug",
   "ur",
   "yi"
-]), ve = /* @__PURE__ */ new Set([
+]), Se = /* @__PURE__ */ new Set([
   "zero",
   "one",
   "two",
@@ -861,7 +849,7 @@ var fe = {
 function _(e) {
   if (typeof e != "object" || e === null) return !1;
   const t = Object.keys(e);
-  return t.length > 0 && t.every((i) => ve.has(i));
+  return t.length > 0 && t.every((i) => Se.has(i));
 }
 function z(e) {
   try {
@@ -869,12 +857,12 @@ function z(e) {
     if (i?.direction === "rtl" || i?.direction === "ltr") return i.direction;
   } catch {
   }
-  const t = w(e).split("-")[0] ?? "";
-  return ye.has(t) ? "rtl" : "ltr";
+  const t = A(e).split("-")[0] ?? "";
+  return be.has(t) ? "rtl" : "ltr";
 }
-var G = class E {
+var $ = class E {
   constructor(t = {}) {
-    g(this, "locale", void 0), g(this, "fallbackLocale", void 0), g(this, "catalogs", void 0), g(this, "customMessages", void 0), g(this, "loading", void 0), g(this, "listeners", /* @__PURE__ */ new Set()), g(this, "config", void 0), this.config = { ...t }, this.fallbackLocale = C(t.fallbackLocale) || "en-US", this.catalogs = /* @__PURE__ */ new Map([[k, fe]]), this.customMessages = { ...t.customMessages ?? {} }, this.loading = /* @__PURE__ */ new Map(), this.locale = this.resolveLocaleTag(t.locale) ?? "en-US";
+    f(this, "locale", void 0), f(this, "fallbackLocale", void 0), f(this, "catalogs", void 0), f(this, "customMessages", void 0), f(this, "loading", void 0), f(this, "listeners", /* @__PURE__ */ new Set()), f(this, "config", void 0), this.config = { ...t }, this.fallbackLocale = P(t.fallbackLocale) || "en-US", this.catalogs = /* @__PURE__ */ new Map([[k, ve]]), this.customMessages = { ...t.customMessages ?? {} }, this.loading = /* @__PURE__ */ new Map(), this.locale = this.resolveLocaleTag(t.locale) ?? "en-US";
   }
   async initialize(t) {
     if (this.config = {
@@ -889,7 +877,7 @@ var G = class E {
   async setLocale(t) {
     const i = this.resolveLocaleTag(t);
     if (!i) {
-      this.locale = C(t) || "en-US", this.notify();
+      this.locale = P(t) || "en-US", this.notify();
       return;
     }
     if (!this.catalogs.has(i)) {
@@ -938,11 +926,11 @@ var G = class E {
     return this.lookup(t) !== void 0;
   }
   addCustomMessages(t, i) {
-    const s = C(t);
-    this.customMessages[s] = $(this.customMessages[s] ?? {}, i), this.notify();
+    const s = P(t);
+    this.customMessages[s] = j(this.customMessages[s] ?? {}, i), this.notify();
   }
   withLocale(t) {
-    const i = this.resolveLocaleTag(t) ?? C(t);
+    const i = this.resolveLocaleTag(t) ?? P(t);
     if (i === this.locale) return this;
     const s = new E({
       ...this.config,
@@ -977,11 +965,11 @@ var G = class E {
   }
   resolveLocaleTag(t) {
     if (!t) return;
-    const i = this.getAvailableLocales(), s = ge(t, i);
+    const i = this.getAvailableLocales(), s = ye(t, i);
     if (s) return s;
-    const n = w(t).split("-")[0];
+    const n = A(t).split("-")[0];
     if (n)
-      return i.find((o) => w(o).split("-")[0] === n);
+      return i.find((o) => A(o).split("-")[0] === n);
   }
   async loadCatalog(t) {
     const i = this.config.loadCatalog;
@@ -1000,7 +988,7 @@ var G = class E {
       this.catalogs.get(this.fallbackLocale)
     ];
     for (const s of i) {
-      const n = be(s, t);
+      const n = we(s, t);
       if (n !== void 0) return n;
     }
   }
@@ -1025,11 +1013,11 @@ var G = class E {
     for (const t of this.listeners) t();
   }
 };
-g(G, "pluralRules", /* @__PURE__ */ new Map());
-function C(e) {
+f($, "pluralRules", /* @__PURE__ */ new Map());
+function P(e) {
   return e ? e.trim().replace(/_/g, "-") : "";
 }
-function be(e, t) {
+function we(e, t) {
   if (!e) return;
   let i = e;
   for (const s of t.split("."))
@@ -1042,46 +1030,46 @@ function U(e, t) {
     return n == null ? i : String(n);
   }) : e;
 }
-function $(e, t) {
+function j(e, t) {
   const i = { ...e };
   for (const [s, n] of Object.entries(t)) {
     const o = i[s];
-    n && typeof n == "object" && o && typeof o == "object" ? i[s] = $(o, n) : i[s] = n;
+    n && typeof n == "object" && o && typeof o == "object" ? i[s] = j(o, n) : i[s] = n;
   }
   return i;
 }
-function Se(e = {}) {
-  return new G({
-    loadCatalog: pe,
-    availableLocales: he,
+function Ae(e = {}) {
+  return new $({
+    loadCatalog: ge,
+    availableLocales: me,
     ...e
   });
 }
-function v() {
+function S() {
   return Date.now();
 }
-function P(e) {
+function C(e) {
   return e.replace(/[^a-zA-Z0-9_-]/g, "-");
 }
-function we(e) {
-  if (e.attemptId) return `aas_v1_${P(e.assessmentId)}_${P(e.attemptId)}`;
-  const t = j(), i = t ? Ae(t) : "anon";
-  return `aas_v1_${P(e.assessmentId)}_${P(i)}`;
+function Ie(e) {
+  if (e.attemptId) return `aas_v1_${C(e.assessmentId)}_${C(e.attemptId)}`;
+  const t = W(), i = t ? Pe(t) : "anon";
+  return `aas_v1_${C(e.assessmentId)}_${C(i)}`;
 }
-function j() {
+function W() {
   try {
     return typeof window > "u" ? null : window.localStorage;
   } catch {
     return null;
   }
 }
-function Ae(e) {
+function Pe(e) {
   const t = "pie:assessment-player:anonymous-device-id", i = e.getItem(t);
   if (i) return i;
   const s = `anon-${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;
   return e.setItem(t, s), s;
 }
-function Ie(e) {
+function Ce(e) {
   if (!e) return [];
   const t = [], i = e.testParts || [];
   return i.length > 0 ? (i.forEach((s, n) => {
@@ -1104,12 +1092,12 @@ function Ie(e) {
     });
   }), t);
 }
-var Ce = class {
+var Ee = class {
   constructor(e) {
-    this.args = e, this.listeners = /* @__PURE__ */ new Set(), this.deliveryPlan = { sections: [] }, this.session = null, this.readiness = "bootstrapping", this.submitted = !1, this.disposed = !1, this.storageContext = {
+    this.args = e, this.listeners = /* @__PURE__ */ new Set(), this.deliveryPlan = { sections: [] }, this.session = null, this.readiness = "bootstrapping", this.submitted = !1, this.saveQueue = Promise.resolve(), this.disposed = !1, this.storageContext = {
       assessmentId: e.assessmentId,
       attemptId: e.attemptId
-    };
+    }, this.initialSession = e.initialSession ? y(e.initialSession) : null;
   }
   emit(e) {
     if (!this.disposed)
@@ -1130,30 +1118,30 @@ var Ce = class {
   async getPersistenceStrategy() {
     if (this.persistenceStrategy) return this.persistenceStrategy;
     const e = { createDefaultPersistence: () => {
-      const t = j(), i = `pie:assessment-controller:v1:${this.storageContext.assessmentId}:${this.storageContext.attemptId || "default"}`;
+      const t = W(), { assessmentId: i, attemptId: s } = this.storageContext, n = s ? `pie:assessment-controller:v1:${i}:${s}` : null;
       return {
         async loadSession() {
-          if (!t) return null;
-          const s = t.getItem(i);
-          if (!s) return null;
+          if (!t || !n) return null;
+          const o = t.getItem(n);
+          if (!o) return null;
           try {
-            return JSON.parse(s);
+            return JSON.parse(o);
           } catch {
             return null;
           }
         },
-        async saveSession(s, n) {
-          t && t.setItem(i, JSON.stringify(n));
+        async saveSession(o, r) {
+          !t || !n || t.setItem(n, JSON.stringify(r));
         },
         async clearSession() {
-          t && t.removeItem(i);
+          !t || !n || t.removeItem(n);
         }
       };
     } };
     return this.persistenceStrategy = await this.args.hooks?.createAssessmentSessionPersistence?.(this.storageContext, e) ?? await e.createDefaultPersistence(), this.persistenceStrategy;
   }
   async createDeliveryPlan() {
-    const e = { createDefaultDeliveryPlan: () => ({ sections: Ie(this.args.assessment) }) }, t = {
+    const e = { createDefaultDeliveryPlan: () => ({ sections: Ce(this.args.assessment) }) }, t = {
       assessmentId: this.args.assessmentId,
       attemptId: this.args.attemptId,
       assessment: this.args.assessment
@@ -1163,8 +1151,8 @@ var Ce = class {
   ensureSession() {
     if (this.session) return this.session;
     const e = this.deliveryPlan.sections.map((t) => t.sectionIdentifier);
-    return this.session = V({
-      assessmentAttemptSessionIdentifier: we({
+    return this.session = Q({
+      assessmentAttemptSessionIdentifier: Ie({
         assessmentId: this.args.assessmentId,
         attemptId: this.args.attemptId
       }),
@@ -1197,10 +1185,12 @@ var Ce = class {
       await this.args.hooks?.onBeforeAssessmentHydrate?.(this.storageContext), this.assertActive();
       const e = await this.getPersistenceStrategy();
       this.assertActive();
-      const t = await e.loadSession(this.storageContext);
-      this.assertActive(), t && (this.session = t), this.ensureSession(), this.readiness = "ready", t && this.emit({
+      const t = this.initialSession;
+      this.initialSession = null;
+      const i = t ?? await e.loadSession(this.storageContext);
+      this.assertActive(), i && (this.session = i), this.ensureSession(), this.readiness = "ready", i && this.emit({
         type: "assessment-session-applied",
-        timestamp: v()
+        timestamp: S()
       }), this.assertActive();
     } catch (e) {
       try {
@@ -1223,13 +1213,19 @@ var Ce = class {
   async persist() {
     this.assertActive();
     try {
-      const e = await this.getPersistenceStrategy();
-      if (this.disposed || (await this.args.hooks?.onBeforeAssessmentPersist?.(this.storageContext, this.session), this.disposed)) return;
-      await e.saveSession(this.storageContext, this.session);
+      await this.save();
     } catch (e) {
       this.disposed || this.handleError(e, "session-save");
     }
   }
+  save() {
+    const e = this.saveQueue.then(async () => {
+      const t = await this.getPersistenceStrategy();
+      this.disposed || (await this.args.hooks?.onBeforeAssessmentPersist?.(this.storageContext, this.session), !this.disposed && await t.saveSession(this.storageContext, this.session));
+    });
+    return this.saveQueue = e.catch(() => {
+    }), e;
+  }
   getSession() {
     return this.session;
   }
@@ -1261,14 +1257,14 @@ var Ce = class {
     const t = this.buildNavigationSnapshot();
     if (e < 0 || e >= t.totalSections) return !1;
     const i = t.currentSectionId, s = this.deliveryPlan.sections[e];
-    this.session = J(this.ensureSession(), {
+    this.session = K(this.ensureSession(), {
       currentSectionIndex: e,
       currentSectionIdentifier: s?.sectionIdentifier
     });
     const n = this.buildNavigationSnapshot();
     return this.emit({
       type: "assessment-route-changed",
-      timestamp: v(),
+      timestamp: S(),
       currentSectionIndex: n.currentSectionIndex,
       totalSections: n.totalSections,
       currentSectionId: n.currentSectionId,
@@ -1277,10 +1273,10 @@ var Ce = class {
       canPrevious: n.canPrevious
     }), this.disposed || (this.emit({
       type: "assessment-session-changed",
-      timestamp: v()
+      timestamp: S()
     }), this.disposed) ? !1 : (this.emit({
       type: "assessment-progress-changed",
-      timestamp: v(),
+      timestamp: S(),
       visitedSectionCount: this.ensureSession().navigationState.visitedSectionIdentifiers.length,
       totalSections: n.totalSections
     }), !0);
@@ -1299,11 +1295,17 @@ var Ce = class {
     return this.setIndex(e.currentSectionIndex - 1);
   }
   async submit() {
-    this.assertActive(), this.submitted = !0, this.emit({
+    this.assertActive();
+    try {
+      await this.save();
+    } catch (e) {
+      throw this.disposed || this.handleError(e, "session-save"), e;
+    }
+    this.disposed || (this.submitted = !0, this.emit({
       type: "assessment-submission-state-changed",
-      timestamp: v(),
+      timestamp: S(),
       submitted: !0
-    }), await this.persist();
+    }));
   }
   subscribe(e) {
     return this.disposed ? () => {
@@ -1320,15 +1322,15 @@ var Ce = class {
     return this.disposed ? null : this.ensureSession().sectionSessions[e]?.session || null;
   }
   updateSectionSession(e, t) {
-    this.disposed || (this.session = K(this.ensureSession(), {
+    this.disposed || (this.session = Y(this.ensureSession(), {
       sectionIdentifier: e,
       sectionSession: t
     }), this.emit({
       type: "assessment-session-changed",
-      timestamp: v()
+      timestamp: S()
     }));
   }
-}, p = {
+}, g = {
   controllerReady: "assessment-controller-ready",
   navigationRequested: "assessment-navigation-requested",
   routeChanged: "assessment-route-changed",
@@ -1338,7 +1340,7 @@ var Ce = class {
   submissionStateChanged: "assessment-submission-state-changed",
   error: "assessment-error"
 };
-function Pe(e, t) {
+function ke(e, t) {
   return !e?.delivery || e.delivery.enabled === !1 || !t || e.delivery.assignmentId !== void 0 ? e : {
     ...e,
     delivery: {
@@ -1347,22 +1349,35 @@ function Pe(e, t) {
     }
   };
 }
-function Ee(e) {
-  const { sectionPlayerRuntime: t, playerType: i, attemptId: s, env: n, coordinator: o } = e, r = t?.player && typeof t.player == "object" ? {
+function Re(e) {
+  const { sectionPlayerRuntime: t, playerType: i, assessmentId: s, attemptId: n, env: o, coordinator: r } = e, a = t?.player && typeof t.player == "object" ? {
     ...t.player,
-    backend: Pe(t.player.backend ? b(t.player.backend) : void 0, s)
+    backend: ke(t.player.backend ? y(t.player.backend) : void 0, n)
   } : t?.player;
   return {
     playerType: i,
-    ...n ? { env: n } : {},
-    ...o ? { coordinator: o } : {},
+    ...s ? { assessmentId: s } : {},
+    ...o ? { env: o } : {},
+    ...r ? { coordinator: r } : {},
     ...t || {},
-    ...r !== void 0 ? { player: r } : {}
+    ...a !== void 0 ? { player: a } : {}
   };
 }
-var ke = "pie-section-player-splitpane", Re = "pie-section-player-vertical", xe = class extends HTMLElement {
+function B(e) {
+  return !!e && typeof e == "object";
+}
+function N(e, t) {
+  if (Object.is(e, t)) return !0;
+  if (Array.isArray(e) || Array.isArray(t))
+    return !Array.isArray(e) || !Array.isArray(t) || e.length !== t.length ? !1 : e.every((s, n) => N(s, t[n]));
+  if (!B(e) || !B(t)) return !1;
+  const i = /* @__PURE__ */ new Set([...Object.keys(e), ...Object.keys(t)]);
+  for (const s of i) if (!N(e[s], t[s])) return !1;
+  return !0;
+}
+var Ne = "pie-section-player-splitpane", xe = "pie-section-player-vertical", Te = class extends HTMLElement {
   constructor(...e) {
-    super(...e), this._assessmentId = "", this._attemptId = "", this._locale = "", this._assessment = null, this._env = null, this._coordinator = null, this._hooks = null, this._showNavigation = !0, this._sectionPlayerLayout = "splitpane", this._playerType = "iife", this._debug = void 0, this.controller = null, this.initializingController = null, this.generation = 0, this.reconcileQueued = !1, this.controllerWaiters = /* @__PURE__ */ new Set(), this.i18n = Se(), this.sectionHost = null, this.sectionControllerRef = null, this.sectionSessionReady = !1, this.containerRef = null, this.announcer = null, this.restoreFocusOnRender = !1, this._sectionPlayerRuntime = null, this.readiness = { phase: "bootstrapping" };
+    super(...e), this._assessmentId = "", this._attemptId = "", this._locale = "", this._assessment = null, this._env = null, this._coordinator = null, this._hooks = null, this.pendingSession = null, this._showNavigation = !0, this._sectionPlayerLayout = "splitpane", this._playerType = "iife", this._debug = void 0, this.controller = null, this.initializingController = null, this.generation = 0, this.reconcileQueued = !1, this.controllerWaiters = /* @__PURE__ */ new Set(), this.i18n = Ae(), this.sectionHost = null, this.sectionControllerRef = null, this.sectionSessionReady = !1, this.containerRef = null, this.announcer = null, this.restoreFocusOnRender = !1, this._sectionPlayerRuntime = null, this.readiness = { phase: "bootstrapping" };
   }
   static get observedAttributes() {
     return [
@@ -1399,6 +1414,13 @@ var ke = "pie-section-player-splitpane", Re = "pie-section-player-vertical", xe
   set hooks(e) {
     this._hooks !== e && (this._hooks = e, this.queueReconciliation());
   }
+  get session() {
+    return this.controller ? y(this.controller.getSession()) : this.pendingSession;
+  }
+  set session(e) {
+    const t = e ?? null;
+    t !== this.pendingSession && (t && this.controller && N(t, this.controller.getSession()) || (this.pendingSession = t, this.queueReconciliation()));
+  }
   get locale() {
     return this._locale;
   }
@@ -1498,67 +1520,68 @@ var ke = "pie-section-player-splitpane", Re = "pie-section-player-vertical", xe
       return;
     }
     this.readiness = { phase: "bootstrapping" }, this.renderEmptyState();
-    const e = this.generation, t = this.hooks, i = () => this.isConnected && this.generation === e, s = new Ce({
+    const e = this.generation, t = this.hooks, i = () => this.isConnected && this.generation === e, s = this.pendingSession, n = new Ee({
       assessmentId: this.assessmentId,
       attemptId: this.attemptId || void 0,
       assessment: this.assessment,
+      initialSession: s,
       hooks: {
         ...t,
-        onError: (n, o) => {
+        onError: (o, r) => {
           if (i())
             try {
-              t?.onError?.(n, o);
+              t?.onError?.(o, r);
             } finally {
-              i() && o.phase === "session-load" && this.controller === s && (this.retireController(), this.readiness = { phase: "error" }, this.renderEmptyState(), this.dispatch(p.error, { error: n }));
+              i() && r.phase === "session-load" && this.controller === n && (this.retireController(), this.readiness = { phase: "error" }, this.renderEmptyState(), this.dispatch(g.error, { error: o }));
             }
         }
       }
     });
-    this.initializingController = s, this.unsubscribeController = s.subscribe((n) => {
+    this.initializingController = n, this.unsubscribeController = n.subscribe((o) => {
       if (i()) {
-        if (n.type === "assessment-route-changed") {
-          if (this.syncCurrentSectionSessionIntoAssessment(), !i() || (this.cleanupTtsForSectionNavigation(n), !i()) || (this.dispatch(p.routeChanged, n), !i())) return;
+        if (o.type === "assessment-route-changed") {
+          if (this.syncCurrentSectionSessionIntoAssessment(), !i() || (this.cleanupTtsForSectionNavigation(o), !i()) || (this.dispatch(g.routeChanged, o), !i())) return;
           this.restoreFocusOnRender = !0, this.render(!1);
         }
-        n.type === "assessment-session-applied" && this.dispatch(p.sessionApplied, n), n.type === "assessment-session-changed" && this.dispatch(p.sessionChanged, n), n.type === "assessment-progress-changed" && this.dispatch(p.progressChanged, n), n.type === "assessment-submission-state-changed" && this.dispatch(p.submissionStateChanged, n);
+        o.type === "assessment-session-applied" && this.dispatch(g.sessionApplied, o), o.type === "assessment-session-changed" && this.dispatch(g.sessionChanged, o), o.type === "assessment-progress-changed" && this.dispatch(g.progressChanged, o), o.type === "assessment-submission-state-changed" && this.dispatch(g.submissionStateChanged, o);
       }
     });
     try {
-      if (await s.initialize(), !i()) return;
-      this.initializingController = null, this.controller = s, this.readiness = { phase: "ready" }, this.render(), this.settleControllerWaiters(s);
-      const n = (o) => {
+      if (await n.initialize(), !i()) return;
+      this.pendingSession === s && (this.pendingSession = null), this.initializingController = null, this.controller = n, this.readiness = { phase: "ready" }, this.render(), this.settleControllerWaiters(n);
+      const o = (r) => {
         if (i()) {
           try {
-            t?.onError?.(o instanceof Error ? o : new Error(String(o)), { phase: "controller-init" });
-          } catch (r) {
-            console.error("Assessment error hook failed", r);
+            t?.onError?.(r instanceof Error ? r : new Error(String(r)), { phase: "controller-init" });
+          } catch (a) {
+            console.error("Assessment error hook failed", a);
           }
-          i() && this.dispatch(p.error, { error: o });
+          i() && this.dispatch(g.error, { error: r });
         }
       };
       try {
-        Promise.resolve(t?.onAssessmentControllerReady?.(s)).catch(n);
-      } catch (o) {
-        n(o);
+        Promise.resolve(t?.onAssessmentControllerReady?.(n)).catch(o);
+      } catch (r) {
+        o(r);
       }
-      i() && this.dispatch(p.controllerReady, { controller: s });
-    } catch (n) {
+      i() && this.dispatch(g.controllerReady, { controller: n });
+    } catch (o) {
       if (!i()) return;
-      this.retireController(), this.readiness = { phase: "error" }, this.renderEmptyState(), this.dispatch(p.error, { error: n });
+      this.retireController(), this.readiness = { phase: "error" }, this.renderEmptyState(), this.dispatch(g.error, { error: o });
     }
   }
   resolveInstrumentationProvider() {
-    return ce({
+    return ue({
       runtimePlayer: this.sectionPlayerRuntime?.player,
       component: "pie-assessment-player-default"
     });
   }
   attachInstrumentationBridge() {
-    this.detachInstrumentationBridge?.(), this.detachInstrumentationBridge = se({
+    this.detachInstrumentationBridge?.(), this.detachInstrumentationBridge = oe({
       host: this,
       instrumentationProvider: this.resolveInstrumentationProvider(),
       component: "pie-assessment-player-default",
-      eventMap: de,
+      eventMap: he,
       staticAttributes: {
         instrumentationLayer: "assessment",
         assessmentId: this.assessmentId,
@@ -1631,12 +1654,13 @@ var ke = "pie-section-player-splitpane", Re = "pie-section-player-vertical", xe
         return;
   }
   buildSectionPlayerTag() {
-    return this.sectionPlayerLayout === "vertical" ? Re : ke;
+    return this.sectionPlayerLayout === "vertical" ? xe : Ne;
   }
   buildSectionRuntime() {
-    return Ee({
+    return Re({
       sectionPlayerRuntime: this.sectionPlayerRuntime,
       playerType: this.playerType,
+      assessmentId: this.assessmentId || void 0,
       attemptId: this.attemptId || void 0,
       env: this.env,
       coordinator: this.coordinator
@@ -1651,7 +1675,7 @@ var ke = "pie-section-player-splitpane", Re = "pie-section-player-vertical", xe
     const t = this.coordinator, i = t?.ttsService;
     if (!i) return;
     const s = (n) => {
-      t?.reportFrameworkError?.(Q({
+      t?.reportFrameworkError?.(J({
         kind: "tts-init",
         source: "AssessmentPlayerDefaultElement.cleanupTtsForSectionNavigation",
         error: n,
@@ -1675,38 +1699,34 @@ var ke = "pie-section-player-splitpane", Re = "pie-section-player-vertical", xe
     const t = this.sectionControllerRef;
     if (!t?.getSession) return;
     const i = this.sectionHost?.firstElementChild?.getAttribute("section-id");
-    i && e.updateSectionSession(i, b(t.getSession()));
+    i && e.updateSectionSession(i, y(t.getSession()));
   }
-  attachSectionControllerReadyListener(e, t) {
-    const i = e, s = this.generation, n = this.sectionHost, o = this.controller, r = b(o.getSectionSession(t)), a = () => this.isConnected && this.generation === s && this.sectionHost === n && this.controller === o;
-    n.setAttribute("aria-busy", "true"), i.inert = !0;
+  attachSectionControllerReadyListener(e, t, i) {
+    const s = e, n = this.generation, o = this.sectionHost, r = this.controller, a = () => this.isConnected && this.generation === n && this.sectionHost === o && this.controller === r;
+    o.setAttribute("aria-busy", "true"), s.inert = !0;
     let h;
     new Promise((c) => {
-      let m = !1;
-      const u = (A) => {
-        m || (m = !0, clearTimeout(f), i.removeEventListener(N.stageChange, l), c(A));
-      }, l = (A) => {
-        if (A.target !== i) return;
-        const { stage: x, status: W } = A.detail;
-        W === "failed" || x === "disposed" ? u(null) : x === "engine-ready" && u(i.getSectionController?.() || null);
-      }, f = setTimeout(() => u(null), 5e3);
-      i.addEventListener(N.stageChange, l), h = () => u(null);
+      let p = !1;
+      const u = (v) => {
+        p || (p = !0, clearTimeout(m), s.removeEventListener("pie-stage-change", l), c(v));
+      }, l = (v) => {
+        if (v.target !== s) return;
+        const { stage: x, status: V } = v.detail;
+        V === "failed" || x === "disposed" ? u(null) : x === "engine-ready" && u(s.getSectionController?.() || null);
+      }, m = setTimeout(() => u(null), 5e3);
+      s.addEventListener("pie-stage-change", l), h = () => u(null);
     }).then(async (c) => {
       if (a()) {
         if (!c) throw new Error("Section controller did not become ready");
-        if (r) {
-          if (!c.applySession) throw new Error("Section controller cannot restore its saved session");
-          await c.applySession(r, { mode: "replace" });
-        }
-        a() && (this.sectionControllerRef = c, this.sectionSessionReady = !0, i.inert = !1, n.setAttribute("aria-busy", "false"));
+        a() && (this.sectionControllerRef = c, this.sectionSessionReady = !0, s.inert = !1, o.setAttribute("aria-busy", "false"));
       }
     }).catch((c) => {
       if (!a()) return;
       this.detachSectionListeners?.(), this.detachSectionListeners = void 0, this.sectionControllerRef = null, this.sectionSessionReady = !1;
-      const m = n.contains(document.activeElement), u = this.createStatusContent(r ? "player.assessment.restoreFailed" : "player.assessment.loadFailed", () => {
+      const p = o.contains(document.activeElement), u = this.createStatusContent(i ? "player.assessment.restoreFailed" : "player.assessment.loadFailed", () => {
         this.restoreFocusOnRender = this.contains(document.activeElement), this.render();
       });
-      n.replaceChildren(u), n.setAttribute("aria-busy", "false"), m && u.focus();
+      o.replaceChildren(u), o.setAttribute("aria-busy", "false"), p && u.focus();
       try {
         this.hooks?.onError?.(c instanceof Error ? c : new Error(String(c)), {
           phase: "navigation",
@@ -1715,7 +1735,7 @@ var ke = "pie-section-player-splitpane", Re = "pie-section-player-vertical", xe
       } catch (l) {
         console.error("Assessment error hook failed", l);
       }
-      a() && this.dispatch(p.error, { error: c });
+      a() && this.dispatch(g.error, { error: c });
     });
     const d = () => {
       a() && this.syncCurrentSectionSessionIntoAssessment();
@@ -1757,7 +1777,7 @@ var ke = "pie-section-player-splitpane", Re = "pie-section-player-vertical", xe
 				padding: 0.5rem;
 				border: 1px solid var(--pie-border-light, #e5e7eb);
 				border-radius: 0.375rem;
-				background: var(--pie-background-light, var(--pie-background, #fff));
+				background: var(--pie-background, #fff);
 			}
 			.pie-assessment-player-navigation[hidden] { display: none; }
 			.pie-assessment-player-current-position {
@@ -1772,7 +1792,7 @@ var ke = "pie-section-player-splitpane", Re = "pie-section-player-vertical", xe
 				padding: 0.35rem 0.75rem;
 				border: 1px solid var(--pie-border-light, #e5e7eb);
 				border-radius: 0.375rem;
-				background: var(--pie-background-light, var(--pie-background, #fff));
+				background: var(--pie-background, #fff);
 				cursor: pointer;
 			}
 			.pie-assessment-player-nav-btn:disabled {
@@ -1795,23 +1815,24 @@ var ke = "pie-section-player-splitpane", Re = "pie-section-player-vertical", xe
       u.className = "pie-assessment-player-navigation", u.hidden = !R(this.showNavigation, !0);
       const l = document.createElement("div");
       l.className = "pie-assessment-player-current-position", l.textContent = a;
-      const f = document.createElement("div");
-      f.className = "pie-assessment-player-nav-controls", h = document.createElement("button"), h.type = "button", h.className = "pie-assessment-player-nav-btn", h.setAttribute("data-pie-navigation", "previous"), h.textContent = this.i18n.t("common.back"), h.disabled = !r.navigation.canPrevious, h.addEventListener("click", () => {
+      const m = document.createElement("div");
+      m.className = "pie-assessment-player-nav-controls", h = document.createElement("button"), h.type = "button", h.className = "pie-assessment-player-nav-btn", h.setAttribute("data-pie-navigation", "previous"), h.textContent = this.i18n.t("common.back"), h.disabled = !r.navigation.canPrevious, h.addEventListener("click", () => {
         this.navigatePrevious();
       }), d = document.createElement("button"), d.type = "button", d.className = "pie-assessment-player-nav-btn", d.setAttribute("data-pie-navigation", "next"), d.textContent = this.i18n.t("common.next"), d.disabled = !r.navigation.canNext, d.addEventListener("click", () => {
         this.navigateNext();
-      }), f.appendChild(h), f.appendChild(d), u.appendChild(l), u.appendChild(f), n.appendChild(u);
+      }), m.appendChild(h), m.appendChild(d), u.appendChild(l), u.appendChild(m), n.appendChild(u);
     }
     const c = document.createElement("div");
     c.className = "pie-assessment-player-section-host", c.setAttribute("role", "region"), c.setAttribute("aria-label", a), c.tabIndex = -1, this.sectionHost = c;
-    const m = i?.getCurrentSection() || null;
-    if (m) {
+    const p = i?.getCurrentSection() || null;
+    if (p) {
       const u = this.buildSectionPlayerTag(), l = document.createElement(u);
-      if (l.setAttribute("assessment-id", this.assessmentId), l.setAttribute("section-id", m.sectionIdentifier), this.attemptId && l.setAttribute("attempt-id", this.attemptId), this.locale && l.setAttribute("locale", this.locale), this.debug !== void 0 && this.debug !== null) {
-        const f = typeof this.debug == "boolean" ? String(this.debug) : this.debug;
-        l.setAttribute("debug", f);
+      if (l.setAttribute("section-id", p.sectionIdentifier), this.attemptId && l.setAttribute("attempt-id", this.attemptId), this.locale && l.setAttribute("locale", this.locale), this.debug !== void 0 && this.debug !== null) {
+        const v = typeof this.debug == "boolean" ? String(this.debug) : this.debug;
+        l.setAttribute("debug", v);
       }
-      l.section = m.section, l.runtime = this.buildSectionRuntime(), l.hooks = { cardTitleFormatter: this.hooks?.cardTitleFormatter }, c.appendChild(l), this.attachSectionControllerReadyListener(l, m.sectionIdentifier);
+      const m = y(i.getSectionSession(p.sectionIdentifier));
+      l.section = p.section, m && (l.session = m), l.runtime = this.buildSectionRuntime(), l.hooks = { cardTitleFormatter: this.hooks?.cardTitleFormatter }, c.appendChild(l), this.attachSectionControllerReadyListener(l, p.sectionIdentifier, !!m);
     }
     n.appendChild(c), this.swapContent(n), s && (this.applyFocusIntent(s, {
       previous: h,
@@ -1886,7 +1907,7 @@ var ke = "pie-section-player-splitpane", Re = "pie-section-player-vertical", xe
     if (typeof e == "number")
       n = e, o = this.controller?.getSectionAt(n)?.sectionIdentifier;
     else if (o = e, this.controller?.getCurrentSection()?.sectionIdentifier === o) return !0;
-    if (!this.dispatch(p.navigationRequested, {
+    if (!this.dispatch(g.navigationRequested, {
       fromIndex: i,
       toIndex: n,
       fromSectionId: s,
@@ -1898,7 +1919,7 @@ var ke = "pie-section-player-splitpane", Re = "pie-section-player-vertical", xe
   }
   navigateNext() {
     const e = this.selectNavigation(), t = this.controller?.getSectionAt(e.currentIndex + 1);
-    if (!this.dispatch(p.navigationRequested, {
+    if (!this.dispatch(g.navigationRequested, {
       fromIndex: e.currentIndex,
       toIndex: e.currentIndex + 1,
       fromSectionId: e.currentSectionId,
@@ -1910,7 +1931,7 @@ var ke = "pie-section-player-splitpane", Re = "pie-section-player-vertical", xe
   }
   navigatePrevious() {
     const e = this.selectNavigation(), t = this.controller?.getSectionAt(e.currentIndex - 1);
-    if (!this.dispatch(p.navigationRequested, {
+    if (!this.dispatch(g.navigationRequested, {
       fromIndex: e.currentIndex,
       toIndex: e.currentIndex - 1,
       fromSectionId: e.currentSectionId,
@@ -1933,8 +1954,8 @@ var ke = "pie-section-player-splitpane", Re = "pie-section-player-vertical", xe
     }));
   }
 };
-B("pie-assessment-player-default", xe, "assessment player default tag");
-var Ne = class extends HTMLElement {
+O("pie-assessment-player-default", Te, "assessment player default tag");
+var Le = class extends HTMLElement {
   constructor(...e) {
     super(...e), this.showNavigation = !0;
   }
@@ -1980,7 +2001,7 @@ var Ne = class extends HTMLElement {
     s.appendChild(n), i.appendChild(s), this.appendChild(t), this.appendChild(i);
   }
 };
-B("pie-assessment-player-shell", Ne, "assessment player shell tag");
+O("pie-assessment-player-shell", Le, "assessment player shell tag");
 export {
-  p as ASSESSMENT_PLAYER_PUBLIC_EVENTS
+  g as ASSESSMENT_PLAYER_PUBLIC_EVENTS
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pie-players/pie-assessment-player",
-	"version": "0.3.74",
+	"version": "0.3.75",
 	"type": "module",
 	"description": "Assessment-level coordinator custom elements for orchestrating section-player instances",
 	"license": "MIT",
@@ -45,14 +45,14 @@
 		"build": "vite build",
 		"dev": "vite build --watch",
 		"test": "bun test",
-		"typecheck": "tsc --noEmit",
+		"typecheck": "tsc --noEmit && tsc -p tsconfig.tests.json",
 		"check": "tsc --noEmit",
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@pie-players/pie-assessment-toolkit": "0.3.74",
-		"@pie-players/pie-players-shared": "0.3.74",
-		"@pie-players/pie-section-player": "0.3.74"
+		"@pie-players/pie-assessment-toolkit": "0.3.75",
+		"@pie-players/pie-players-shared": "0.3.75",
+		"@pie-players/pie-section-player": "0.3.75"
 	},
 	"devDependencies": {
 		"@axe-core/playwright": "^4.13.0",
@@ -60,7 +60,7 @@
 		"@biomejs/biome": "^2.5.15",
 		"typescript": "^5.9.3",
 		"vite": "^8.3.2",
-		"vite-plugin-dts": "^5.1.1"
+		"vite-plugin-dts": "^5.1.2"
 	},
 	"homepage": "https://github.com/pie-framework/pie-players/tree/master/packages/assessment-player#readme",
 	"bugs": {