@pie-players/pie-assessment-player 1.0.0-beta.1 → 1.0.0-beta.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PIE Framework contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -31,8 +31,8 @@ Importing the package registers `pie-assessment-player-default` and
 registers the section player layouts. The entry is bundler-only and
 browser-only: it imports `@pie-players/pie-section-player` and
 `@pie-players/pie-assessment-toolkit` by bare specifier. The package has no
-browser build, so a CDN cannot serve it; its `unpkg` and `jsdelivr` fields name
-the bundler entry.
+browser build, so a CDN cannot serve it, and it has no `unpkg` or `jsdelivr`
+field.
 
 ## Elements
 
@@ -395,8 +395,8 @@ const hooks: AssessmentPlayerHooks = {
 ```
 
 The section player's [Card titles](../section-player/README.md#card-titles)
-lists the context fields; a return that is not a non-empty string keeps the
-default title.
+lists the context fields. `{ visible: false }` hides a card's title; any other
+return that is not a non-empty string keeps the default title.
 
 ## Debug logging
 
@@ -435,20 +435,11 @@ before the assessment player mounts:
 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,
-    },
-  ],
-  { math: { assetRoot: "https://assets.example.com/npm" } },
-);
+
+// The modules name their package and version; the tag defaults from the name.
+registerPreloadedElements([{ 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

package/custom-elements.json

@@ -290,8 +290,14 @@
 							"name": "assessment-progress-changed",
 							"type": {
 								"text": "CustomEvent<AssessmentProgressChangedDetail>"
+							}
+						},
+						{
+							"name": "framework-error",
+							"type": {
+								"text": "CustomEvent<{ kind: \"i18n-locale-load\"; source: string; message: string; details: string[]; recoverable: true; scope: \"runtime\"; cause?: unknown }>"
 							},
-							"description": "When the visited-section count changes."
+							"description": "When a requested interface-locale catalog fails to load for the assembly's own navigation chrome; the assembly keeps rendering through the English fallback chain. Failed loads are not cached, so a later change of `locale` back to that locale retries the load. When the visited-section count changes."
 						},
 						{
 							"name": "assessment-submission-state-changed",
@@ -309,7 +315,19 @@
 						}
 					],
 					"x-pie": {
-						"shadow": "none"
+						"shadow": "none",
+						"classes": [
+							"pie-assessment-player-announcer",
+							"pie-assessment-player-current-position",
+							"pie-assessment-player-default",
+							"pie-assessment-player-empty",
+							"pie-assessment-player-nav-btn",
+							"pie-assessment-player-nav-controls",
+							"pie-assessment-player-navigation",
+							"pie-assessment-player-retry",
+							"pie-assessment-player-section-host",
+							"pie-assessment-player-status-message"
+						]
 					}
 				},
 				{
@@ -328,7 +346,6 @@
 							"type": {
 								"text": "boolean | string | null | undefined"
 							},
-							"default": "true",
 							"attribute": "show-navigation"
 						}
 					],

package/dist/THIRD-PARTY-LICENSES.txt

@@ -0,0 +1,51 @@
+Third-party software included in this package's bundles, with the licence each is used under.
+
+========================================================================
+
+es-module-shims 2.8.4
+License: MIT
+
+MIT License
+-----------
+
+Copyright (C) 2018-2021 Guy Bedford
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+========================================================================
+
+lit (pre-bundled in the vendored NDS icon button)
+License: BSD-3-Clause
+
+BSD 3-Clause License
+
+Copyright (c) 2017 Google LLC. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/dist/components/AssessmentPlayerDefaultElement.d.ts

@@ -21,6 +21,8 @@ import { AssessmentDefinition, AssessmentPlayerHooks, AssessmentPlayerRuntimeCon
  * @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 -
+ *
+ * @fires {CustomEvent<{ kind: "i18n-locale-load"; source: string; message: string; details: string[]; recoverable: true; scope: "runtime"; cause?: unknown }>} framework-error - When a requested interface-locale catalog fails to load for the assembly's own navigation chrome; the assembly keeps rendering through the English fallback chain. Failed loads are not cached, so a later change of `locale` back to that locale retries the load.
  *   When the visited-section count changes.
  * @fires {CustomEvent<AssessmentSubmissionStateChangedDetail>} assessment-submission-state-changed -
  *   When `submit()` records the submission state.
@@ -63,8 +65,18 @@ export declare class AssessmentPlayerDefaultElement extends HTMLElement implemen
      * context above it to resolve from. Constructed with the English catalog
      * already resident, so `t` never returns a bare key.
      */
-    private readonly i18n;
+    private readonly ownedI18n;
+    /** The provider the host supplied through `sectionPlayerRuntime.i18n`, if any. */
+    private suppliedI18n;
+    private subscribedI18n;
     private unsubscribeI18n?;
+    /**
+     * The provider resolving this player's navigation chrome: the host's
+     * `sectionPlayerRuntime.i18n` when supplied, else the one built here. The
+     * section element's runtime carries the same object, so the section and
+     * everything under it resolve one provider.
+     */
+    private get i18n();
     private sectionHost;
     private sectionControllerRef;
     private sectionSessionReady;

package/dist/components/AssessmentPlayerShellElement.d.ts

@@ -10,8 +10,10 @@
  */
 export declare class AssessmentPlayerShellElement extends HTMLElement {
     static get observedAttributes(): string[];
-    showNavigation: boolean | string | null | undefined;
+    private _showNavigation;
     constructor();
+    get showNavigation(): boolean | string | null | undefined;
+    set showNavigation(value: boolean | string | null | undefined);
     connectedCallback(): void;
     attributeChangedCallback(name: string, _oldValue: string | null, value: string | null): void;
     private render;

package/dist/contracts/elements.d.ts

@@ -0,0 +1,12 @@
+import { AssessmentPlayerDefaultElement } from '../components/AssessmentPlayerDefaultElement.js';
+import { AssessmentPlayerShellElement } from '../components/AssessmentPlayerShellElement.js';
+/** Native host interface, derived from the implementation's public members. */
+export type PieAssessmentPlayerDefaultElement = Pick<AssessmentPlayerDefaultElement, keyof AssessmentPlayerDefaultElement>;
+/** Native host interface for `<pie-assessment-player-shell>`. */
+export type PieAssessmentPlayerShellElement = Pick<AssessmentPlayerShellElement, keyof AssessmentPlayerShellElement>;
+declare global {
+    interface HTMLElementTagNameMap {
+        "pie-assessment-player-default": PieAssessmentPlayerDefaultElement;
+        "pie-assessment-player-shell": PieAssessmentPlayerShellElement;
+    }
+}

package/dist/pie-assessment-player.d.ts

@@ -1,3 +1,4 @@
+export type { PieAssessmentPlayerDefaultElement, PieAssessmentPlayerShellElement, } from './contracts/elements.js';
 export { ASSESSMENT_PLAYER_PUBLIC_EVENTS, type AssessmentPlayerPublicEventName, type AssessmentPlayerReadinessPhase, type AssessmentNavigationRequestedDetail, type AssessmentRouteChangedDetail, type AssessmentProgressChangedDetail, type AssessmentSubmissionStateChangedDetail, type AssessmentReadinessChangeDetail, } from './contracts/public-events.js';
 export type { AssessmentPlayerRuntimeHostContract, AssessmentPlayerNavigationSnapshot, AssessmentPlayerProgressSnapshot, AssessmentPlayerSnapshot, } from './contracts/runtime-host-contract.js';
 export type { AssessmentDefinition, AssessmentDeliveryPlan, AssessmentSectionInstance, AssessmentDeliveryPlanContext, AssessmentDeliveryPlanFactoryDefaults, AssessmentSessionPersistenceContext, AssessmentSessionPersistenceStrategy, AssessmentSessionPersistenceFactoryDefaults, AssessmentPlayerHooks, AssessmentPlayerRuntimeConfig, } from './types.js';