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

package/README.md

@@ -8,6 +8,9 @@ Primary entrypoint:
 
 - `@pie-players/pie-assessment-player`
 
+The entry is bundler-only: it imports the toolkit, players-shared and the
+section player by bare specifier.
+
 ## AssessmentController
 
 `AssessmentController` is the domain authority for an assessment attempt. It
@@ -100,7 +103,8 @@ change only — section-level events flow through the embedded
   `previousSectionId`, `canNext` / `canPrevious`).
 - `assessment-session-applied` — `hydrate()` loaded a persisted session.
 - `assessment-session-changed` — assessment session mutated (navigation,
-  per-section snapshot upsert).
+  per-section snapshot upsert). The active section's snapshot is upserted once
+  for each `session-changed` it emits.
 - `assessment-progress-changed` — visited-section count flipped.
 - `assessment-submission-state-changed` — `submit()` recorded the final
   state.
@@ -189,16 +193,68 @@ Toolkit tool/backend operational stream (when toolkit is mounted):
 - `pie-tool-backend-call-start|success|error`
 - `pie-tool-library-load-start|success|error`
 
+## Preloaded elements
+
+With `player-type="preloaded"` (or `playerType = "preloaded"`) the section
+players load no element code, and their pre-warm asserts that every tag the
+content names is registered. The host registers the elements with
+`registerPreloadedElements` from `@pie-players/pie-item-player/preloaded`
+before the assessment player mounts:
+
+```ts
+import { registerPreloadedElements } from "@pie-players/pie-item-player/preloaded";
+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,
+  },
+]);
+```
+
+- A tag missing at pre-warm leaves the section's items unmounted and raises a
+  non-recoverable `element-preload` framework error.
+- Install element packages with `npm install --save-exact`. npm otherwise saves
+  a caret range, which registration rejects as a `version`, and which a fresh
+  install can resolve to another release line: `^13.4.0-next.15` resolves to
+  the legacy `13.4.4`, which has no `./browser/*` modules.
+- Install every pie-elements-ng package from one release, in one install from
+  the same dist-tag, and upgrade them together. Elements whose `./browser/*`
+  builds typeset on `window.MathJax` share the MathJax the first of them loads,
+  in the build and configuration of that element's release, so in a mixed set
+  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)).
+- 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
+  `sectionPlayerRuntime.player.backend.delivery`). A player that is not hosted
+  runs `model()` in the browser and warns for each tag registered without one.
+- Only `@pie-element/*` builds from pie-elements-ng publish
+  `./browser/delivery` and `./browser/controller`.
+- Under TypeScript, the `package.json` import needs `resolveJsonModule`, and a
+  package version that ships no declarations for `./browser/*` needs a
+  `declare module` shim for those subpaths.
+
+See [`strategy="preloaded"`](../../docs/item-player/loading-strategies.md#strategypreloaded)
+for the registration contract.
+
 ## 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)
+default through DOMPurify. See the
+[pie-item-player README](../item-player/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.*`
+settings by setting `sectionPlayerRuntime.player.trustMarkup` /
+`sectionPlayerRuntime.player.sanitizeMarkup` on the assessment player; it passes
+that runtime to each section player, whose runtime flattens `runtime.player.*`
 fields onto the embedded `<pie-item-player>` (see the section-player README
 for the exact forwarding shape).

package/dist/contracts/public-events.d.ts

@@ -1,7 +1,6 @@
 export declare const ASSESSMENT_PLAYER_PUBLIC_EVENTS: {
     readonly controllerReady: "assessment-controller-ready";
     readonly navigationRequested: "assessment-navigation-requested";
-    readonly submitRequested: "assessment-submit-requested";
     readonly routeChanged: "assessment-route-changed";
     readonly sessionApplied: "assessment-session-applied";
     readonly sessionChanged: "assessment-session-changed";

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

@@ -43,6 +43,7 @@ var e = {
     items: "Vragen",
     section: "Onderdeel",
     loadingSection: "Onderdeel wordt geladen…",
+    sectionLoadError: "Het onderdeel kon niet worden geladen.",
     loadingPassage: "Tekst wordt geladen…",
     configurationError: "Configuratiefout",
     playerError: "Fout in de speler",
@@ -108,6 +109,11 @@ var e = {
       centerA11y: "Venster centreren",
       closeA11y: "Hulpmiddel sluiten"
     },
+    placement: {
+      controlsA11y: "Verplaatsen en draaien",
+      rotateClockwiseA11y: "{degrees}° rechtsom draaien",
+      rotateCounterclockwiseA11y: "{degrees}° linksom draaien"
+    },
     announce: {
       movedUp: "Omhoog verplaatst naar {position}",
       movedDown: "Omlaag verplaatst naar {position}",
@@ -135,8 +141,8 @@ var e = {
     },
     graph: {
       name: "Grafiek",
-      description: "Grafische rekenmachine en assenstelsel",
-      buttonA11y: "Grafiek, grafische rekenmachine",
+      description: "Assenstelsel",
+      buttonA11y: "Grafiek, assenstelsel",
       tooltip: "Grafiek",
       toolA11y: "Grafiekhulpmiddel — punten en lijnen tekenen in een assenstelsel",
       canvasA11y: "Tekenvlak — gebruik de hulpmiddelen om punten toe te voegen en lijnen te tekenen",