@pie-players/pie-assessment-player 0.3.75 → 1.0.0-beta.0

package/custom-elements.json

@@ -0,0 +1,521 @@
+{
+	"schemaVersion": "2.1.0",
+	"modules": [
+		{
+			"kind": "javascript-module",
+			"path": "dist/pie-assessment-player.js",
+			"declarations": [
+				{
+					"kind": "class",
+					"description": "Reference multi-section assessment player. A host gives it an `assessment` definition and `assessment-id`, optionally with `attempt-id`, `session` and `hooks`; it creates an `AssessmentController` for the attempt, mounts the current section in a split-pane or vertical section player, and renders the section position with Back and Next controls.",
+					"name": "AssessmentPlayerDefaultElement",
+					"tagName": "pie-assessment-player-default",
+					"customElement": true,
+					"superclass": {
+						"name": "HTMLElement"
+					},
+					"members": [
+						{
+							"kind": "field",
+							"name": "assessmentId",
+							"type": {
+								"text": "string"
+							},
+							"attribute": "assessment-id"
+						},
+						{
+							"kind": "field",
+							"name": "attemptId",
+							"type": {
+								"text": "string"
+							},
+							"attribute": "attempt-id"
+						},
+						{
+							"kind": "field",
+							"name": "assessment",
+							"type": {
+								"text": "AssessmentDefinition | null"
+							}
+						},
+						{
+							"kind": "field",
+							"name": "hooks",
+							"type": {
+								"text": "AssessmentPlayerHooks | null"
+							}
+						},
+						{
+							"kind": "field",
+							"name": "session",
+							"type": {
+								"text": "AssessmentSession | null"
+							},
+							"description": "Before a controller is ready, the assigned session; after, a copy of the controller's."
+						},
+						{
+							"kind": "field",
+							"name": "locale",
+							"type": {
+								"text": "string"
+							},
+							"attribute": "locale"
+						},
+						{
+							"kind": "field",
+							"name": "env",
+							"type": {
+								"text": "Env | null"
+							}
+						},
+						{
+							"kind": "field",
+							"name": "coordinator",
+							"type": {
+								"text": "unknown"
+							}
+						},
+						{
+							"kind": "field",
+							"name": "showNavigation",
+							"type": {
+								"text": "boolean | string | null | undefined"
+							},
+							"attribute": "show-navigation"
+						},
+						{
+							"kind": "field",
+							"name": "sectionPlayerLayout",
+							"type": {
+								"text": "\"splitpane\" | \"vertical\""
+							},
+							"attribute": "section-player-layout"
+						},
+						{
+							"kind": "field",
+							"name": "playerType",
+							"type": {
+								"text": "\"iife\" | \"esm\" | \"preloaded\""
+							},
+							"attribute": "player-type"
+						},
+						{
+							"kind": "field",
+							"name": "debug",
+							"type": {
+								"text": "boolean | string | null | undefined"
+							},
+							"attribute": "debug"
+						},
+						{
+							"kind": "field",
+							"name": "sectionPlayerRuntime",
+							"type": {
+								"text": "AssessmentPlayerRuntimeConfig[\"sectionPlayerRuntime\"]"
+							}
+						},
+						{
+							"kind": "method",
+							"name": "getSnapshot",
+							"return": {
+								"type": {
+									"text": "AssessmentPlayerSnapshot"
+								}
+							}
+						},
+						{
+							"kind": "method",
+							"name": "selectNavigation"
+						},
+						{
+							"kind": "method",
+							"name": "selectReadiness"
+						},
+						{
+							"kind": "method",
+							"name": "selectProgress",
+							"return": {
+								"type": {
+									"text": "AssessmentPlayerProgressSnapshot"
+								}
+							}
+						},
+						{
+							"kind": "method",
+							"name": "navigateTo",
+							"parameters": [
+								{
+									"name": "indexOrIdentifier",
+									"type": {
+										"text": "number | string"
+									}
+								}
+							],
+							"return": {
+								"type": {
+									"text": "boolean"
+								}
+							}
+						},
+						{
+							"kind": "method",
+							"name": "navigateNext",
+							"return": {
+								"type": {
+									"text": "boolean"
+								}
+							}
+						},
+						{
+							"kind": "method",
+							"name": "navigatePrevious",
+							"return": {
+								"type": {
+									"text": "boolean"
+								}
+							}
+						},
+						{
+							"kind": "method",
+							"name": "getAssessmentController",
+							"return": {
+								"type": {
+									"text": "AssessmentControllerHandle | null"
+								}
+							}
+						},
+						{
+							"kind": "method",
+							"name": "waitForAssessmentController",
+							"parameters": [
+								{
+									"name": "timeoutMs",
+									"type": {
+										"text": "number"
+									},
+									"optional": true,
+									"default": "5000"
+								}
+							]
+						}
+					],
+					"attributes": [
+						{
+							"name": "assessment-id",
+							"type": {
+								"text": "string"
+							},
+							"fieldName": "assessmentId"
+						},
+						{
+							"name": "attempt-id",
+							"type": {
+								"text": "string"
+							},
+							"fieldName": "attemptId"
+						},
+						{
+							"name": "show-navigation",
+							"type": {
+								"text": "boolean | string | null | undefined"
+							},
+							"fieldName": "showNavigation"
+						},
+						{
+							"name": "section-player-layout",
+							"type": {
+								"text": "\"splitpane\" | \"vertical\""
+							},
+							"fieldName": "sectionPlayerLayout"
+						},
+						{
+							"name": "player-type",
+							"type": {
+								"text": "\"iife\" | \"esm\" | \"preloaded\""
+							},
+							"fieldName": "playerType"
+						},
+						{
+							"name": "debug",
+							"type": {
+								"text": "boolean | string | null | undefined"
+							},
+							"fieldName": "debug"
+						},
+						{
+							"name": "locale",
+							"type": {
+								"text": "string"
+							},
+							"fieldName": "locale"
+						}
+					],
+					"events": [
+						{
+							"name": "assessment-controller-ready",
+							"type": {
+								"text": "CustomEvent<{ controller: AssessmentControllerHandle }>"
+							},
+							"description": "When the controller has initialized and hydrated the attempt."
+						},
+						{
+							"name": "assessment-navigation-requested",
+							"type": {
+								"text": "CustomEvent<AssessmentNavigationRequestedDetail>"
+							},
+							"description": "Before Back, Next or a navigate method moves to another section, cancelable to stay."
+						},
+						{
+							"name": "assessment-route-changed",
+							"type": {
+								"text": "CustomEvent<AssessmentRouteChangedDetail>"
+							},
+							"description": "When the current section changes."
+						},
+						{
+							"name": "assessment-session-applied",
+							"type": {
+								"text": "CustomEvent<{ type: \"assessment-session-applied\"; timestamp: number }>"
+							},
+							"description": "When hydration applies a persisted or assigned session."
+						},
+						{
+							"name": "assessment-session-changed",
+							"type": {
+								"text": "CustomEvent<{ type: \"assessment-session-changed\"; timestamp: number }>"
+							},
+							"description": "When navigation or a section snapshot changes the assessment session."
+						},
+						{
+							"name": "assessment-progress-changed",
+							"type": {
+								"text": "CustomEvent<AssessmentProgressChangedDetail>"
+							},
+							"description": "When the visited-section count changes."
+						},
+						{
+							"name": "assessment-submission-state-changed",
+							"type": {
+								"text": "CustomEvent<AssessmentSubmissionStateChangedDetail>"
+							},
+							"description": "When `submit()` records the submission state."
+						},
+						{
+							"name": "assessment-error",
+							"type": {
+								"text": "CustomEvent<{ error: unknown }>"
+							},
+							"description": "When the attempt fails to load, a ready hook rejects, or a section fails to load or restore."
+						}
+					],
+					"x-pie": {
+						"shadow": "none"
+					}
+				},
+				{
+					"kind": "class",
+					"description": "Layout scaffold for a host-composed assessment: host navigation above a body that fills the remaining height. The scaffold renders in an open shadow root and the host's children stay in its light DOM, where document styles reach them, projecting into the slots.",
+					"name": "AssessmentPlayerShellElement",
+					"tagName": "pie-assessment-player-shell",
+					"customElement": true,
+					"superclass": {
+						"name": "HTMLElement"
+					},
+					"members": [
+						{
+							"kind": "field",
+							"name": "showNavigation",
+							"type": {
+								"text": "boolean | string | null | undefined"
+							},
+							"default": "true",
+							"attribute": "show-navigation"
+						}
+					],
+					"attributes": [
+						{
+							"name": "show-navigation",
+							"type": {
+								"text": "boolean | string | null | undefined"
+							},
+							"fieldName": "showNavigation"
+						}
+					],
+					"slots": [
+						{
+							"name": "",
+							"description": "The body: the host's section player and any other assessment UI."
+						},
+						{
+							"name": "navigation",
+							"description": "Assessment navigation above the body; not rendered while `show-navigation` is false."
+						}
+					],
+					"x-pie": {
+						"shadow": "open"
+					}
+				}
+			],
+			"exports": [
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-assessment-player-default",
+					"declaration": {
+						"name": "AssessmentPlayerDefaultElement"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-assessment-player-shell",
+					"declaration": {
+						"name": "AssessmentPlayerShellElement"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-assessment-toolkit",
+					"declaration": {
+						"name": "PieAssessmentToolkit",
+						"module": "dist/components/pie-assessment-toolkit-element.js",
+						"package": "@pie-players/pie-assessment-toolkit"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-item-player",
+					"declaration": {
+						"name": "PieItemPlayer",
+						"module": "dist/pie-item-player.js",
+						"package": "@pie-players/pie-item-player"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-item-scope",
+					"declaration": {
+						"name": "ItemScope",
+						"module": "dist/components/item-scope-element.js",
+						"package": "@pie-players/pie-assessment-toolkit"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-item-toolbar",
+					"declaration": {
+						"name": "ItemToolBar",
+						"module": "dist/components/item-toolbar-element.js",
+						"package": "@pie-players/pie-assessment-toolkit"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-passage-shell",
+					"declaration": {
+						"name": "PassageShellElement",
+						"module": "dist/pie-section-player.js",
+						"package": "@pie-players/pie-section-player"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-section-player-base",
+					"declaration": {
+						"name": "PieSectionPlayerBaseElement",
+						"module": "dist/pie-section-player.js",
+						"package": "@pie-players/pie-section-player"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-section-player-item-card",
+					"declaration": {
+						"name": "SectionItemCard",
+						"module": "dist/pie-section-player.js",
+						"package": "@pie-players/pie-section-player"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-section-player-items-pane",
+					"declaration": {
+						"name": "SectionItemsPane",
+						"module": "dist/pie-section-player.js",
+						"package": "@pie-players/pie-section-player"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-section-player-kernel-host",
+					"declaration": {
+						"name": "PieSectionPlayerKernelHostElement",
+						"module": "dist/pie-section-player.js",
+						"package": "@pie-players/pie-section-player"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-section-player-passage-card",
+					"declaration": {
+						"name": "SectionPassageCard",
+						"module": "dist/pie-section-player.js",
+						"package": "@pie-players/pie-section-player"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-section-player-passages-pane",
+					"declaration": {
+						"name": "SectionPassagesPane",
+						"module": "dist/pie-section-player.js",
+						"package": "@pie-players/pie-section-player"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-section-player-shell",
+					"declaration": {
+						"name": "SectionPlayerShell",
+						"module": "dist/pie-section-player.js",
+						"package": "@pie-players/pie-section-player"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-section-player-splitpane",
+					"declaration": {
+						"name": "PieSectionPlayerSplitPaneElement",
+						"module": "dist/pie-section-player.js",
+						"package": "@pie-players/pie-section-player"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-section-player-tabbed",
+					"declaration": {
+						"name": "PieSectionPlayerTabbedElement",
+						"module": "dist/pie-section-player.js",
+						"package": "@pie-players/pie-section-player"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-section-player-vertical",
+					"declaration": {
+						"name": "PieSectionPlayerVerticalElement",
+						"module": "dist/pie-section-player.js",
+						"package": "@pie-players/pie-section-player"
+					}
+				},
+				{
+					"kind": "custom-element-definition",
+					"name": "pie-section-toolbar",
+					"declaration": {
+						"name": "SectionToolBar",
+						"module": "dist/components/section-toolbar-element.js",
+						"package": "@pie-players/pie-assessment-toolkit"
+					}
+				}
+			]
+		}
+	]
+}

package/dist/components/AssessmentPlayerDefaultElement.d.ts

@@ -2,6 +2,31 @@ 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, AssessmentSession } from '../types.js';
+/**
+ * Reference multi-section assessment player. A host gives it an `assessment`
+ * definition and `assessment-id`, optionally with `attempt-id`, `session` and
+ * `hooks`; it creates an `AssessmentController` for the attempt, mounts the
+ * current section in a split-pane or vertical section player, and renders the
+ * section position with Back and Next controls.
+ *
+ * @fires {CustomEvent<{ controller: AssessmentControllerHandle }>} assessment-controller-ready -
+ *   When the controller has initialized and hydrated the attempt.
+ * @fires {CustomEvent<AssessmentNavigationRequestedDetail>} assessment-navigation-requested -
+ *   Before Back, Next or a navigate method moves to another section, cancelable
+ *   to stay.
+ * @fires {CustomEvent<AssessmentRouteChangedDetail>} assessment-route-changed -
+ *   When the current section changes.
+ * @fires {CustomEvent<{ type: "assessment-session-applied"; timestamp: number }>} assessment-session-applied -
+ *   When hydration applies a persisted or assigned session.
+ * @fires {CustomEvent<{ type: "assessment-session-changed"; timestamp: number }>} assessment-session-changed -
+ *   When navigation or a section snapshot changes the assessment session.
+ * @fires {CustomEvent<AssessmentProgressChangedDetail>} assessment-progress-changed -
+ *   When the visited-section count changes.
+ * @fires {CustomEvent<AssessmentSubmissionStateChangedDetail>} assessment-submission-state-changed -
+ *   When `submit()` records the submission state.
+ * @fires {CustomEvent<{ error: unknown }>} assessment-error - When the attempt
+ *   fails to load, a ready hook rejects, or a section fails to load or restore.
+ */
 export declare class AssessmentPlayerDefaultElement extends HTMLElement implements AssessmentPlayerRuntimeHostContract {
     static get observedAttributes(): string[];
     private _assessmentId;

package/dist/components/AssessmentPlayerShellElement.d.ts

@@ -1,6 +1,17 @@
+/**
+ * Layout scaffold for a host-composed assessment: host navigation above a body
+ * that fills the remaining height. The scaffold renders in an open shadow root
+ * and the host's children stay in its light DOM, where document styles reach
+ * them, projecting into the slots.
+ *
+ * @slot navigation - Assessment navigation above the body; not rendered while
+ *   `show-navigation` is false.
+ * @slot - The body: the host's section player and any other assessment UI.
+ */
 export declare class AssessmentPlayerShellElement extends HTMLElement {
     static get observedAttributes(): string[];
     showNavigation: boolean | string | null | undefined;
+    constructor();
     connectedCallback(): void;
     attributeChangedCallback(name: string, _oldValue: string | null, value: string | null): void;
     private render;

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

@@ -4,7 +4,6 @@ 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

@@ -197,6 +197,11 @@ export declare class AssessmentController implements AssessmentControllerHandle
     private emit;
     private assertActive;
     private handleError;
+    /**
+     * Marks a live controller failed and reports through `onError` when a phase is
+     * given. A throwing hook is logged so the caller still rethrows the original.
+     */
+    private reportFailure;
     private getPersistenceStrategy;
     private createDeliveryPlan;
     private ensureSession;

package/dist/{nl-NL-CfezB59b.js → nl-NL-DqnT-1mq.js}

@@ -306,20 +306,20 @@ var e = {
     textToSpeech: {
       name: "Voorlezen",
       description: "Inhoud laten voorlezen",
+      initFailed: "Voorlezen kon niet worden gestart. Probeer het opnieuw.",
       inline: {
         controlsA11y: "Voorleesknoppen",
         playbackSpeedA11y: "Voorleessnelheid",
         rewindA11y: "Terugspoelen",
         fastForwardA11y: "Vooruitspoelen",
         stopA11y: "Voorlezen stoppen",
-        initializing: "Voorlezen wordt gestart",
-        initFailed: "Voorlezen kon niet worden gestart. Probeer het opnieuw.",
         starting: "Voorlezen wordt gestart",
         started: "Voorlezen gestart",
         resumed: "Voorlezen hervat",
         pausedAnnouncement: "Voorlezen gepauzeerd",
         stopped: "Voorlezen gestopt",
         switchedSection: "Het voorlezen is naar een ander onderdeel gegaan",
+        nothingToRead: "Hier is niets om voor te lezen",
         startFailed: "Voorlezen kon niet worden gestart",
         skippedForward: "Vooruitgespoeld",
         skipForwardFailed: "Vooruitspoelen is niet gelukt",
@@ -399,6 +399,7 @@ var e = {
     pnp: {
       title: "PNP-profiel",
       noAssessmentBound: "Geen toets gekoppeld",
+      noAssessmentBoundBody: "Profiel-, district- en afnamebeleid hebben niets om te lezen, dus alleen de requiredTools van een item kunnen een voorziening toekennen. Geef de toets door aan de assessment-eigenschap van de toolkit, of roep updateAssessment(...) aan op de toolkit-coordinator.",
       determinationReadOnly: "Vaststelling (alleen lezen)",
       toolsEditor: "Hulpmiddelen bewerken",
       enforcement: "PNP-handhaving",
@@ -474,12 +475,39 @@ var e = {
       previewEnterText: "Voer eerst voorbeeldtekst in.",
       previewUnavailable: "Een voorbeeld is niet mogelijk zolang deze dienst niet beschikbaar is.",
       browserSynthesisUnavailable: "Spraaksynthese van de browser is niet beschikbaar.",
-      browserSynthesisEndedEarly: "De spraaksynthese van de browser stopte voordat de audio begon. Start de browser opnieuw en probeer het nog eens.",
-      browserSynthesisQueueFailed: "De spraaksynthese van de browser kon het voorbeeldfragment niet in de wachtrij zetten.",
-      browserPreviewFailed: "Het voorbeeld van de browserstem kon niet worden afgespeeld.",
       ssmlWordTrackingDisabled: "Bij een Google SSML-voorbeeld blijft de SSML uit de bron intact, waardoor woordmarkering is uitgeschakeld.",
       applyUnavailable: "Instellingen toepassen is niet mogelijk zolang deze dienst niet beschikbaar is.",
-      coordinatorUnavailable: "De toolkitcoördinator is niet beschikbaar voor voorleesinstellingen."
+      coordinatorUnavailable: "De toolkitcoördinator is niet beschikbaar voor voorleesinstellingen.",
+      customProviderNotRegistered: "Aangepaste provider '{id}' is niet geregistreerd.",
+      customProviderNoConfig: "Aangepaste provider '{id}' gaf geen configuratie om toe te passen.",
+      httpError: "HTTP {status}: {message}",
+      unknownError: "Onbekende fout",
+      previewRequestFailed: "Het voorbeeldverzoek is mislukt ({status}).",
+      notAvailable: "n.v.t.",
+      voiceLocal: "lokaal",
+      voiceRemote: "extern",
+      voiceBrowserDefault: "browserstandaard",
+      browserAvailable: {
+        one: "Browserspraak beschikbaar ({count} stem gevonden).",
+        other: "Browserspraak beschikbaar ({count} stemmen gevonden)."
+      },
+      pollyAvailable: {
+        one: "AWS Polly beschikbaar ({count} passende stem, engine {engine}).",
+        other: "AWS Polly beschikbaar ({count} passende stemmen, engine {engine})."
+      },
+      googleAvailable: {
+        one: "Google Cloud TTS beschikbaar ({count} passende stem).",
+        other: "Google Cloud TTS beschikbaar ({count} passende stemmen)."
+      },
+      headerRowReservation: "Rij in de itemkop gereserveerd: {state}",
+      speedOptionsHelp: "Vermenigvuldigers, gescheiden door komma's of puntkomma's. Neem 1 op voor Normaal; laat leeg om de snelheidsknoppen te verbergen.",
+      usingSelectedVoice: "Gekozen stem: {voice}",
+      autoVoice: "Beste beschikbare stem (automatisch): {voice}",
+      autoVoiceWaiting: "Beste beschikbare stem (automatisch): wachten op de stemmen van de browser.",
+      previewHintBrowserSsml: "SSML wordt niet ondersteund in het browservoorbeeld.",
+      previewHintGoogleSsml: "SSML blijft intact. Markering uitgeschakeld.",
+      previewHintCustom: "Markering actief wanneer de provider spraakmarkeringen teruggeeft.",
+      previewHintTracking: "Markering actief tijdens het afspelen van het voorbeeld."
     }
   }
 };