@pie-players/pie-assessment-player 0.3.29 → 0.3.31

package/README.md

@@ -86,3 +86,17 @@ Toolkit tool/backend operational stream (when toolkit is mounted):
 - `pie-tool-init-start|success|error`
 - `pie-tool-backend-call-start|success|error`
 - `pie-tool-library-load-start|success|error`
+
+## Content trust boundary
+
+Assessment markup reaches the DOM via the underlying
+`<pie-item-player>` element, which now sanitizes item / passage markup by
+default through DOMPurify. See
+[pie-item-player README](./README.md#content-trust-boundary)
+for the allow-list, opt-out mechanics (`trust-markup`), and the
+`sanitizeMarkup` property override. Assessment-player hosts forward these
+settings by setting `runtime.player.trustMarkup` /
+`runtime.player.sanitizeMarkup` on the shared runtime they pass into the
+section-player instances; the section-player runtime flattens `runtime.player.*`
+fields onto the embedded `<pie-item-player>` (see the section-player README
+for the exact forwarding shape).

package/dist/components/AssessmentPlayerDefaultElement.d.ts

@@ -37,6 +37,7 @@ export declare class AssessmentPlayerDefaultElement extends HTMLElement implemen
     private attachInstrumentationBridge;
     private renderEmptyState;
     private buildSectionPlayerTag;
+    private cleanupTtsForSectionNavigation;
     private syncCurrentSectionSessionIntoAssessment;
     private attachSectionControllerReadyListener;
     private render;

package/dist/components/AssessmentPlayerDefaultElement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssessmentPlayerDefaultElement.d.ts","sourceRoot":"","sources":["../../src/components/AssessmentPlayerDefaultElement.ts"],"names":[],"mappings":"AAAA,OAAO,6EAA6E,CAAC;AACrF,OAAO,4EAA4E,CAAC;AAMpF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,uCAAuC,CAAC;AAEjE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAQxF,OAAO,KAAK,EACX,gCAAgC,EAChC,mCAAmC,EACnC,wBAAwB,EACxB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EACX,oBAAoB,EACpB,qBAAqB,EACrB,6BAA6B,EAC7B,MAAM,aAAa,CAAC;AAuBrB,qBAAa,8BACZ,SAAQ,WACR,YAAW,mCAAmC;IAE9C,MAAM,KAAK,kBAAkB,aAS5B;IAED,YAAY,SAAM;IAClB,SAAS,SAAM;IACf,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAAQ;IAC/C,GAAG,EAAE,GAAG,GAAG,IAAI,CAAQ;IACvB,WAAW,EAAE,OAAO,CAAQ;IAC5B,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAQ;IAC3C,cAAc,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAQ;IAC3D,mBAAmB,EAAE,WAAW,GAAG,UAAU,CAAe;IAC5D,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,CAAU;IAClD,OAAO,CAAC,MAAM,CAAkD;IAEhE,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,sBAAsB,CACxB;IACN,OAAO,CAAC,sBAAsB,CAEf;IACf,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,oBAAoB,CAAwC;IACpE,OAAO,CAAC,qBAAqB,CAAC,CAAa;IAC3C,OAAO,CAAC,2BAA2B,CAAC,CAAa;IACjD,OAAO,CAAC,qBAAqB,CACvB;IACN,OAAO,CAAC,SAAS,CAEf;;IASF,wBAAwB,CACvB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,KAAK,EAAE,MAAM,GAAG,IAAI;IAoBrB,IAAI,KAAK,IAAI,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAE/C;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAGnD;IAED,IAAI,oBAAoB,IAAI,6BAA6B,CAAC,sBAAsB,CAAC,CAEhF;IAED,IAAI,oBAAoB,CAAC,KAAK,EAAE,6BAA6B,CAAC,sBAAsB,CAAC,EAKpF;IAED,iBAAiB;IAmBjB,oBAAoB;IAOpB,OAAO,CAAC,QAAQ;YAeF,mBAAmB;IAgEjC,OAAO,CAAC,8BAA8B;IAOtC,OAAO,CAAC,2BAA2B;IAenC,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,uCAAuC;IAe/C,OAAO,CAAC,oCAAoC;IA2B5C,OAAO,CAAC,MAAM;IA6Hd,OAAO,CAAC,cAAc;IActB,WAAW,IAAI,wBAAwB;IA6BvC,gBAAgB;IAIhB,eAAe;;;IAIf,cAAc,IAAI,gCAAgC;IAIlD,UAAU,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAiCvD,YAAY,IAAI,OAAO;IAqBvB,gBAAgB,IAAI,OAAO;IAqB3B,uBAAuB,IAAI,0BAA0B,GAAG,IAAI;IAItD,2BAA2B,CAAC,SAAS,SAAO;CAUlD"}
+{"version":3,"file":"AssessmentPlayerDefaultElement.d.ts","sourceRoot":"","sources":["../../src/components/AssessmentPlayerDefaultElement.ts"],"names":[],"mappings":"AAAA,OAAO,6EAA6E,CAAC;AACrF,OAAO,4EAA4E,CAAC;AAMpF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,uCAAuC,CAAC;AAEjE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAQxF,OAAO,KAAK,EACX,gCAAgC,EAChC,mCAAmC,EACnC,wBAAwB,EACxB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EACX,oBAAoB,EACpB,qBAAqB,EACrB,6BAA6B,EAC7B,MAAM,aAAa,CAAC;AAuCrB,qBAAa,8BACZ,SAAQ,WACR,YAAW,mCAAmC;IAE9C,MAAM,KAAK,kBAAkB,aAS5B;IAED,YAAY,SAAM;IAClB,SAAS,SAAM;IACf,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAAQ;IAC/C,GAAG,EAAE,GAAG,GAAG,IAAI,CAAQ;IACvB,WAAW,EAAE,OAAO,CAAQ;IAC5B,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAQ;IAC3C,cAAc,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAQ;IAC3D,mBAAmB,EAAE,WAAW,GAAG,UAAU,CAAe;IAC5D,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,CAAU;IAClD,OAAO,CAAC,MAAM,CAAkD;IAEhE,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,sBAAsB,CACxB;IACN,OAAO,CAAC,sBAAsB,CAEf;IACf,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,oBAAoB,CAAwC;IACpE,OAAO,CAAC,qBAAqB,CAAC,CAAa;IAC3C,OAAO,CAAC,2BAA2B,CAAC,CAAa;IACjD,OAAO,CAAC,qBAAqB,CACvB;IACN,OAAO,CAAC,SAAS,CAEf;;IASF,wBAAwB,CACvB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,KAAK,EAAE,MAAM,GAAG,IAAI;IAoBrB,IAAI,KAAK,IAAI,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAE/C;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAGnD;IAED,IAAI,oBAAoB,IAAI,6BAA6B,CAAC,sBAAsB,CAAC,CAEhF;IAED,IAAI,oBAAoB,CAAC,KAAK,EAAE,6BAA6B,CAAC,sBAAsB,CAAC,EAKpF;IAED,iBAAiB;IAmBjB,oBAAoB;IAOpB,OAAO,CAAC,QAAQ;YAeF,mBAAmB;IAmEjC,OAAO,CAAC,8BAA8B;IAOtC,OAAO,CAAC,2BAA2B;IAenC,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,8BAA8B;IAqBtC,OAAO,CAAC,uCAAuC;IAe/C,OAAO,CAAC,oCAAoC;IAmC5C,OAAO,CAAC,MAAM;IA8Hd,OAAO,CAAC,cAAc;IActB,WAAW,IAAI,wBAAwB;IA6BvC,gBAAgB;IAIhB,eAAe;;;IAIf,cAAc,IAAI,gCAAgC;IAIlD,UAAU,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAiCvD,YAAY,IAAI,OAAO;IAqBvB,gBAAgB,IAAI,OAAO;IAqB3B,uBAAuB,IAAI,0BAA0B,GAAG,IAAI;IAItD,2BAA2B,CAAC,SAAS,SAAO;CAUlD"}

package/dist/pie-assessment-player.js

@@ -1,28 +1,21 @@
 import "@pie-players/pie-section-player/components/section-player-splitpane-element";
 import "@pie-players/pie-section-player/components/section-player-vertical-element";
 import { defineCustomElementSafely as _ } from "@pie-players/pie-players-shared";
-function p(e, t) {
-  const s = `[${e}]`;
-  return {
-    debug: (n, ...i) => {
-      t() && console.debug(s, n, ...i);
-    },
-    info: (n, ...i) => console.info(s, n, ...i),
-    warn: (n, ...i) => console.warn(s, n, ...i),
-    error: (n, ...i) => console.error(s, n, ...i)
-  };
-}
-function f() {
-  return typeof window < "u" && window.PIE_DEBUG === !0;
+var U = "https://proxy.pie-api.com", H = `${U}/bundles/`;
+function $(e) {
+  try {
+    const t = {
+      BASE_URL: "/",
+      DEV: !1,
+      MODE: "production",
+      PROD: !0,
+      SSR: !1
+    }[e];
+    if (typeof t == "string" && t.length > 0) return t;
+  } catch {
+  }
 }
-var S;
-(function(e) {
-  e.player = "player.js", e.clientPlayer = "client-player.js", e.editor = "editor.js";
-})(S || (S = {}));
-var P;
-(function(e) {
-  e.loading = "loading", e.loaded = "loaded";
-})(P || (P = {}));
+var Le = typeof window < "u" && window.PIE_BUILDER_ORIGIN_URL || $("PUBLIC_BUILDER_ORIGIN_URL") || U, V = typeof window < "u" && window.PIE_BUILDER_BUNDLE_URL || $("PUBLIC_BUILDER_BUNDLE_URL") || H;
 function g(e) {
   "@babel/helpers - typeof";
   return g = typeof Symbol == "function" && typeof Symbol.iterator == "symbol" ? function(t) {
@@ -31,7 +24,7 @@ function g(e) {
     return t && typeof Symbol == "function" && t.constructor === Symbol && t !== Symbol.prototype ? "symbol" : typeof t;
   }, g(e);
 }
-function V(e, t) {
+function J(e, t) {
   if (g(e) != "object" || !e) return e;
   var s = e[Symbol.toPrimitive];
   if (s !== void 0) {
@@ -41,57 +34,37 @@ function V(e, t) {
   }
   return (t === "string" ? String : Number)(e);
 }
-function q(e) {
-  var t = V(e, "string");
+function K(e) {
+  var t = J(e, "string");
   return g(t) == "symbol" ? t : t + "";
 }
 function a(e, t, s) {
-  return (t = q(t)) in e ? Object.defineProperty(e, t, {
+  return (t = K(t)) in e ? Object.defineProperty(e, t, {
     value: s,
     enumerable: !0,
     configurable: !0,
     writable: !0
   }) : e[t] = s, e;
 }
-typeof window < "u" && !window.pieHelpers && (window.pieHelpers = {
-  loadingScripts: {},
-  loadingPromises: {},
-  globalLoadQueue: Promise.resolve(),
-  activeBundleUrl: null
-});
-var U = "https://proxy.pie-api.com", J = `${U}/bundles/`;
-function B(e) {
-  try {
-    const t = {
-      BASE_URL: "/",
-      DEV: !1,
-      MODE: "production",
-      PROD: !0,
-      SSR: !1
-    }[e];
-    if (typeof t == "string" && t.length > 0) return t;
-  } catch {
-  }
-}
-var Le = typeof window < "u" && window.PIE_BUILDER_ORIGIN_URL || B("PUBLIC_BUILDER_ORIGIN_URL") || U, K = typeof window < "u" && window.PIE_BUILDER_BUNDLE_URL || B("PUBLIC_BUILDER_BUNDLE_URL") || J, N;
+var P;
 (function(e) {
   e.SAVE = "save", e.MODEL = "model", e.SCORE = "score", e.MANUAL_SCORE = "manual-score";
+})(P || (P = {}));
+var N;
+(function(e) {
+  e.AUTO = "auto", e.MANUAL = "manual";
 })(N || (N = {}));
 var C;
 (function(e) {
-  e.AUTO = "auto", e.MANUAL = "manual";
+  e.GATHER = "gather", e.VIEW = "view", e.EVALUATE = "evaluate";
 })(C || (C = {}));
 var A;
-(function(e) {
-  e.GATHER = "gather", e.VIEW = "view", e.EVALUATE = "evaluate";
-})(A || (A = {}));
-var x;
 (function(e) {
   e.PENDING = "pending", e.IN_PROGRESS = "in_progress", e.COMPLETED = "completed", e.FAILED = "failed";
-})(x || (x = {}));
-var W = class $ extends CustomEvent {
+})(A || (A = {}));
+var W = class B extends CustomEvent {
   constructor(t, s = !1) {
-    super($.TYPE, {
+    super(B.TYPE, {
       bubbles: !0,
       detail: {
         update: t,
@@ -101,7 +74,7 @@ var W = class $ extends CustomEvent {
   }
 };
 a(W, "TYPE", "model.updated");
-var Q = class O extends CustomEvent {
+var Z = class O extends CustomEvent {
   constructor(t, s) {
     super(O.TYPE, {
       bubbles: !0,
@@ -112,8 +85,8 @@ var Q = class O extends CustomEvent {
     }), a(this, "src", void 0), a(this, "done", void 0), this.src = t, this.done = s;
   }
 };
-a(Q, "TYPE", "delete.image");
-var Z = class M extends CustomEvent {
+a(Z, "TYPE", "delete.image");
+var Q = class M extends CustomEvent {
   constructor(t) {
     super(M.TYPE, {
       bubbles: !0,
@@ -121,7 +94,7 @@ var Z = class M extends CustomEvent {
     }), a(this, "handler", void 0), this.handler = t;
   }
 };
-a(Z, "TYPE", "insert.image");
+a(Q, "TYPE", "insert.image");
 var X = class F extends CustomEvent {
   constructor(t, s) {
     super(F.TYPE, {
@@ -156,12 +129,34 @@ var te = class G extends CustomEvent {
   }
 };
 a(te, "TYPE", "session-changed");
-var R;
+var x;
 (function(e) {
   e[e.ROOT = 0] = "ROOT", e[e.SUBJECT = 1] = "SUBJECT", e[e.LEVEL = 2] = "LEVEL", e[e.STANDARD = 3] = "STANDARD";
+})(x || (x = {}));
+function m(e, t) {
+  const s = `[${e}]`;
+  return {
+    debug: (n, ...i) => {
+      t() && console.debug(s, n, ...i);
+    },
+    info: (n, ...i) => console.info(s, n, ...i),
+    warn: (n, ...i) => console.warn(s, n, ...i),
+    error: (n, ...i) => console.error(s, n, ...i)
+  };
+}
+function p() {
+  return typeof window < "u" && window.PIE_DEBUG === !0;
+}
+var ke = m("math-rendering", () => p()), S;
+(function(e) {
+  e.player = "player.js", e.clientPlayer = "client-player.js", e.editor = "editor.js";
+})(S || (S = {}));
+var R;
+(function(e) {
+  e.loading = "loading", e.loaded = "loaded";
 })(R || (R = {}));
-var ke = p("math-rendering", () => f()), Te = p("pie-scoring", () => f()), De = p("pie-updates", () => f()), _e = p("pie-initialization", () => f()), Ue = {
-  buildServiceBase: K,
+var Te = m("pie-scoring", () => p()), De = m("pie-updates", () => p()), _e = m("pie-initialization", () => p()), Ue = {
+  buildServiceBase: V,
   bundleType: S.player,
   env: {
     mode: "gather",
@@ -173,7 +168,7 @@ function j(e) {
   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 se = p("instrumentation-event-bridge", () => f());
+var se = m("instrumentation-event-bridge", () => p());
 function ne(e) {
   return e && typeof e == "object" ? e : typeof e > "u" ? {} : { value: e };
 }
@@ -358,7 +353,7 @@ function D(e) {
 function de(e, t) {
   return e.kind === "value" || e.kind === "null" ? e : t;
 }
-var v, le = p("instrumentation-provider-resolution", () => f());
+var v, le = m("instrumentation-provider-resolution", () => p());
 function ue() {
   return v || (v = new ce(), v.initialize()), v;
 }
@@ -373,7 +368,12 @@ function he(e) {
     }
   }
 }
-var me = [
+var $e = Object.freeze([
+  "composed",
+  "engine-ready",
+  "interactive",
+  "disposed"
+]), me = [
   {
     sourceEventName: "assessment-controller-ready",
     instrumentationEventName: "pie-assessment-controller-ready"
@@ -406,8 +406,8 @@ var me = [
     sourceEventName: "assessment-error",
     instrumentationEventName: "pie-assessment-error"
   }
-];
-function m() {
+], Be = m("pie-overrides", () => p());
+function f() {
   return Date.now();
 }
 function y(e) {
@@ -415,10 +415,10 @@ function y(e) {
 }
 function pe(e) {
   if (e.attemptId) return `aas_v1_${y(e.assessmentId)}_${y(e.attemptId)}`;
-  const t = H(), s = t ? fe(t) : "anon";
+  const t = Y(), s = t ? fe(t) : "anon";
   return `aas_v1_${y(e.assessmentId)}_${y(s)}`;
 }
-function H() {
+function Y() {
   try {
     return typeof window > "u" ? null : window.localStorage;
   } catch {
@@ -431,11 +431,11 @@ function fe(e) {
   const n = `anon-${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;
   return e.setItem(t, n), n;
 }
-function Y() {
+function q() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
 function ge(e) {
-  const t = Y(), s = e.sectionIdentifiers[0];
+  const t = q(), s = e.sectionIdentifiers[0];
   return {
     version: 1,
     assessmentAttemptSessionIdentifier: e.assessmentAttemptSessionIdentifier,
@@ -455,7 +455,7 @@ function ge(e) {
   };
 }
 function ve(e, t) {
-  const s = Y();
+  const s = q();
   return {
     ...e,
     updatedAt: s,
@@ -524,7 +524,7 @@ var Ie = class {
   async getPersistenceStrategy() {
     if (this.persistenceStrategy) return this.persistenceStrategy;
     const e = { createDefaultPersistence: () => {
-      const t = H(), s = `pie:assessment-controller:v1:${this.storageContext.assessmentId}:${this.storageContext.attemptId || "default"}`;
+      const t = Y(), s = `pie:assessment-controller:v1:${this.storageContext.assessmentId}:${this.storageContext.attemptId || "default"}`;
       return {
         async loadSession() {
           if (!t) return null;
@@ -581,7 +581,7 @@ var Ie = class {
       const e = await (await this.getPersistenceStrategy()).loadSession(this.storageContext);
       e && (this.session = e, this.emit({
         type: "assessment-session-applied",
-        timestamp: m()
+        timestamp: f()
       })), this.ensureSession(), this.readiness = "ready";
     } catch (e) {
       this.readiness = "error", this.handleError(e, "session-load");
@@ -632,7 +632,7 @@ var Ie = class {
     const i = this.buildNavigationSnapshot();
     return this.emit({
       type: "assessment-route-changed",
-      timestamp: m(),
+      timestamp: f(),
       currentSectionIndex: i.currentSectionIndex,
       totalSections: i.totalSections,
       currentSectionId: i.currentSectionId,
@@ -641,10 +641,10 @@ var Ie = class {
       canPrevious: i.canPrevious
     }), this.emit({
       type: "assessment-session-changed",
-      timestamp: m()
+      timestamp: f()
     }), this.emit({
       type: "assessment-progress-changed",
-      timestamp: m(),
+      timestamp: f(),
       visitedSectionCount: this.ensureSession().navigationState.visitedSectionIdentifiers.length,
       totalSections: i.totalSections
     }), !0;
@@ -665,7 +665,7 @@ var Ie = class {
   async submit() {
     this.submitted = !0, this.emit({
       type: "assessment-submission-state-changed",
-      timestamp: m(),
+      timestamp: f(),
       submitted: !0
     }), await this.persist();
   }
@@ -688,7 +688,7 @@ var Ie = class {
       sectionSession: t
     }), this.emit({
       type: "assessment-session-changed",
-      timestamp: m()
+      timestamp: f()
     });
   }
 }, u = {
@@ -740,9 +740,11 @@ var Pe = class extends HTMLElement {
     this._sectionPlayerRuntime = e, this.isConnected && this.attachInstrumentationBridge();
   }
   connectedCallback() {
-    this.assessmentId || (this.assessmentId = this.getAttribute("assessment-id") || ""), this.attemptId || (this.attemptId = this.getAttribute("attempt-id") || ""), this.showNavigation = this.getAttribute("show-navigation") ?? this.showNavigation, this.sectionPlayerLayout = this.getAttribute("section-player-layout") === "vertical" ? "vertical" : this.sectionPlayerLayout;
-    const e = this.getAttribute("player-type");
-    e && (this.playerType = e), this.debug = this.getAttribute("debug") ?? this.debug, this.attachInstrumentationBridge(), this.bootstrapController();
+    this.assessmentId || (this.assessmentId = this.getAttribute("assessment-id") || ""), this.attemptId || (this.attemptId = this.getAttribute("attempt-id") || ""), this.showNavigation = this.getAttribute("show-navigation") ?? this.showNavigation;
+    const e = this.getAttribute("section-player-layout");
+    this.sectionPlayerLayout = e === "vertical" ? "vertical" : this.sectionPlayerLayout;
+    const t = this.getAttribute("player-type");
+    t && (this.playerType = t), this.debug = this.getAttribute("debug") ?? this.debug, this.attachInstrumentationBridge(), this.bootstrapController();
   }
   disconnectedCallback() {
     this.unsubscribeController?.(), this.detachInstrumentationBridge?.(), this.detachInstrumentationBridge = void 0, this.hooks?.onAssessmentControllerDispose?.(this.controller || void 0);
@@ -768,7 +770,7 @@ var Pe = class extends HTMLElement {
       hooks: this.hooks || void 0
     });
     this.unsubscribeController?.(), this.controller = e, this.unsubscribeController = e.subscribe((t) => {
-      t.type === "assessment-route-changed" && (this.dispatch(u.routeChanged, t), this.render()), t.type === "assessment-session-applied" && this.dispatch(u.sessionApplied, t), t.type === "assessment-session-changed" && this.dispatch(u.sessionChanged, t), t.type === "assessment-progress-changed" && this.dispatch(u.progressChanged, t), t.type === "assessment-submission-state-changed" && this.dispatch(u.submissionStateChanged, t);
+      t.type === "assessment-route-changed" && (this.cleanupTtsForSectionNavigation(t), this.dispatch(u.routeChanged, t), this.render()), t.type === "assessment-session-applied" && this.dispatch(u.sessionApplied, t), t.type === "assessment-session-changed" && this.dispatch(u.sessionChanged, t), t.type === "assessment-progress-changed" && this.dispatch(u.progressChanged, t), t.type === "assessment-submission-state-changed" && this.dispatch(u.submissionStateChanged, t);
     });
     try {
       await e.initialize(), this.readiness = { phase: "ready" }, this.controllerReadyResolve?.(e), this.dispatch(u.controllerReady, { controller: e }), this.hooks?.onAssessmentControllerReady?.(e), this.render();
@@ -803,24 +805,42 @@ var Pe = class extends HTMLElement {
   buildSectionPlayerTag() {
     return this.sectionPlayerLayout === "vertical" ? Ee : be;
   }
+  cleanupTtsForSectionNavigation(e) {
+    if (e.currentSectionId && e.previousSectionId && e.currentSectionId === e.previousSectionId) return;
+    const t = this.coordinator?.ttsService;
+    if (t) {
+      try {
+        t.stop?.();
+      } catch {
+      }
+      try {
+        t.requestControlHandoff?.();
+      } catch {
+      }
+    }
+  }
   syncCurrentSectionSessionIntoAssessment() {
     const e = this.controller;
     if (!e) return;
-    const t = this.sectionControllerRef || this.sectionHost?.firstElementChild?.getSectionController?.();
+    const t = this.sectionHost?.firstElementChild?.getSectionController?.() || this.sectionControllerRef;
     if (!t?.getSession) return;
     const s = e.getCurrentSection();
     s && e.updateSectionSession(s.sectionIdentifier, t.getSession());
   }
   attachSectionControllerReadyListener(e, t) {
-    e.addEventListener("section-controller-ready", async (s) => {
-      this.sectionControllerRef = s.detail?.controller || null;
-      const n = this.controller?.getSectionSession(t);
-      n && this.sectionControllerRef?.applySession && await this.sectionControllerRef.applySession(n, { mode: "replace" });
+    const s = e;
+    queueMicrotask(() => {
+      (async () => {
+        const n = await s.waitForSectionController?.(5e3) || null;
+        if (this.sectionControllerRef = n, !n) return;
+        const i = this.controller?.getSectionSession(t);
+        i && n.applySession && await n.applySession(i, { mode: "replace" });
+      })();
     }), e.addEventListener("session-changed", () => this.syncCurrentSectionSessionIntoAssessment()), e.addEventListener("item-session-changed", () => this.syncCurrentSectionSessionIntoAssessment());
   }
   render() {
     const e = this.controller;
-    this.attachInstrumentationBridge(), this.innerHTML = "";
+    this.attachInstrumentationBridge(), this.innerHTML = "", this.sectionControllerRef = null;
     const t = document.createElement("div");
     t.className = "pie-assessment-player-default";
     const s = document.createElement("style");
@@ -894,7 +914,7 @@ var Pe = class extends HTMLElement {
         const d = typeof this.debug == "boolean" ? String(this.debug) : this.debug;
         r.setAttribute("debug", d);
       }
-      r.section = c.section, this.env && (r.env = this.env), this.coordinator && (r.coordinator = this.coordinator), this.sectionPlayerRuntime && (r.runtime = this.sectionPlayerRuntime), r.hooks = { cardTitleFormatter: this.hooks?.cardTitleFormatter }, this.attachSectionControllerReadyListener(r, c.sectionIdentifier), i.appendChild(r);
+      r.section = c.section, this.env && (r.env = this.env), this.coordinator && (r.coordinator = this.coordinator), this.sectionPlayerRuntime && (r.runtime = this.sectionPlayerRuntime), r.hooks = { cardTitleFormatter: this.hooks?.cardTitleFormatter }, i.appendChild(r), this.attachSectionControllerReadyListener(r, c.sectionIdentifier);
     }
     t.appendChild(i), this.appendChild(t);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pie-players/pie-assessment-player",
-	"version": "0.3.29",
+	"version": "0.3.31",
 	"type": "module",
 	"description": "Assessment-level coordinator custom elements for orchestrating section-player instances",
 	"license": "MIT",
@@ -49,16 +49,16 @@
 		"lint": "biome check ."
 	},
 	"dependencies": {
-		"@pie-players/pie-assessment-toolkit": "0.3.29",
-		"@pie-players/pie-players-shared": "0.3.29",
-		"@pie-players/pie-section-player": "0.3.29"
+		"@pie-players/pie-assessment-toolkit": "0.3.31",
+		"@pie-players/pie-players-shared": "0.3.31",
+		"@pie-players/pie-section-player": "0.3.31"
 	},
 	"devDependencies": {
 		"@axe-core/playwright": "^4.11.1",
-		"@playwright/test": "^1.58.2",
-		"@biomejs/biome": "^2.3.13",
+		"@playwright/test": "^1.59.1",
+		"@biomejs/biome": "^2.4.12",
 		"typescript": "^5.9.3",
-		"vite": "^8.0.1",
+		"vite": "^8.0.10",
 		"vite-plugin-dts": "^4.5.4"
 	},
 	"homepage": "https://github.com/pie-framework/pie-players/tree/master/packages/assessment-player#readme",