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

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

@@ -10,15 +10,14 @@
  * the engine's DOM-event bridge dispatches `pie-stage-change`,
  * `pie-loading-complete`, and `framework-error`.
  *
- * **Kernel-side Svelte forwards (not engine-routed).** The
- * composition / session / runtime-tier family
- * (`composition-changed`, `session-changed`, `runtime-owned`,
- * `runtime-inherited`) is forwarded by the kernel's Svelte
- * `createEventDispatcher` from `<pie-section-player-base>` events; it
- * does not flow through the engine. This split is intentional: the
- * engine owns lifecycle and error reporting, while composition /
- * session forwarding stays in section-player because the shape is
- * section-player-specific and the engine has no opinion on it.
+ * **Toolkit events (not engine-routed).** The composition / session /
+ * runtime-tier family (`composition-changed`, `session-changed`,
+ * `runtime-owned`, `runtime-inherited`) is dispatched by
+ * `<pie-assessment-toolkit>` and bubbles through the layout CE host to
+ * `document`; no section-player component re-dispatches it, so each
+ * listener receives each dispatch once. It does not flow through the
+ * engine: the engine owns lifecycle and error reporting, and has no
+ * opinion on composition or session shape.
  *
  * **`framework-error` single-emit on the layout host.**
  * `<pie-assessment-toolkit>` nested inside a layout CE still
@@ -28,9 +27,9 @@
  * emit at `<pie-section-player-base>` and calls
  * `event.stopPropagation()`, leaving the engine-bridge emit on the
  * layout host as the single canonical DOM surface for
- * section-player consumers. The single-emit contract is pinned by
- * `tests/section-player-framework-error-dual-emit.test.ts`. The
- * layout host does not receive duplicate framework-error events.
+ * section-player consumers. `tests/section-player-event-delivery.spec.ts`
+ * pins one delivery per error on the layout host and none on
+ * `document`.
  *
  * Lifecycle should be consumed through canonical events:
  *   - `readiness-change` → `pie-stage-change` (the readiness phase
@@ -72,9 +71,9 @@ export declare const SECTION_PLAYER_PUBLIC_EVENTS: {
     readonly stageChange: "pie-stage-change";
     /**
      * Engine-routed (M7). Companion to `stageChange`. Fires once per
-     * cohort when every item in the section has finished loading
-     * (`loadedCount === itemCount`), gated by the engine's
-     * `interactive` state.
+     * cohort, once the section controller is ready and the section's
+     * element pre-warm has resolved for the current items: the same
+     * condition that moves a layout element to `interactive`.
      */
     readonly loadingComplete: "pie-loading-complete";
 };

package/dist/contracts/public-events.js

@@ -0,0 +1,12 @@
+var e = {
+  runtimeOwned: "runtime-owned",
+  runtimeInherited: "runtime-inherited",
+  frameworkError: "framework-error",
+  compositionChanged: "composition-changed",
+  sessionChanged: "session-changed",
+  stageChange: "pie-stage-change",
+  loadingComplete: "pie-loading-complete"
+};
+export {
+  e as SECTION_PLAYER_PUBLIC_EVENTS
+};

package/dist/controllers/SectionController.d.ts

@@ -15,6 +15,8 @@ export declare class SectionController implements SectionControllerHandle {
     private readonly trackedRenderables;
     private readonly loadedRenderableKeys;
     private readonly itemCompletionByCanonicalId;
+    private readonly elementCompletionByCanonicalId;
+    private readonly reportedCompletionIds;
     private sectionLoadingComplete;
     private totalRegistered;
     private totalLoaded;
@@ -254,6 +256,7 @@ export declare class SectionController implements SectionControllerHandle {
     applySession(session: SectionControllerSessionState | null, options?: {
         mode?: "replace" | "merge";
     }): Promise<void>;
+    private applySessionState;
     /**
      * Move between items inside the current section only.
      * Cross-section navigation belongs to the higher-level assessment player.
@@ -295,7 +298,17 @@ export declare class SectionController implements SectionControllerHandle {
     private toSectionContentKind;
     private getRenderableKey;
     private readCompleteFromSession;
+    private sessionHoldsResponse;
+    /**
+     * `restored` names the items a host session was just applied to: what their
+     * elements reported before it describes the session the restore replaced.
+     */
     private bootstrapCompletionFromSessions;
+    /**
+     * The item's completion after one element reports its own. A report that
+     * names no element is the item's completion itself.
+     */
+    private recordElementCompletion;
     private updateItemCompleteState;
     private emitSectionItemsCompleteIfChanged;
     private evaluateSectionLoadingState;

package/dist/controllers/toolkit-section-contracts.d.ts

@@ -1,17 +1 @@
-import { ToolkitCoordinator, SectionControllerHandle } from '@pie-players/pie-assessment-toolkit';
-export type { SectionControllerContext, SectionControllerEvent, SectionControllerEventType, SectionControllerHandle, SectionControllerKey, SectionControllerLoadedRenderable, SectionSessionPersistenceConfig, SectionSessionPersistenceStrategy, SectionControllerRuntimeState, SectionControllerSessionState, } from '@pie-players/pie-assessment-toolkit';
-export type CoordinatorWithSectionControllers = ToolkitCoordinator & {
-    getOrCreateSectionController(args: {
-        sectionId: string;
-        attemptId?: string;
-        input?: unknown;
-        updateExisting?: boolean;
-        createDefaultController: () => SectionControllerHandle | Promise<SectionControllerHandle>;
-    }): Promise<SectionControllerHandle>;
-    disposeSectionController(args: {
-        sectionId: string;
-        attemptId?: string;
-        persistBeforeDispose?: boolean;
-        clearPersistence?: boolean;
-    }): Promise<void>;
-};
+export type { SectionControllerHandle, SectionSessionPersistenceConfig, SectionControllerRuntimeState, SectionControllerSessionState, } from '@pie-players/pie-assessment-toolkit';

package/dist/controllers/types.d.ts

@@ -1,5 +1,5 @@
 import { TestAttemptSession } from '@pie-players/pie-assessment-toolkit';
-import { ItemSessionUpdateIntent, AssessmentItemRef, AssessmentSection, ItemEntity, PassageEntity, RubricBlock } from '@pie-players/pie-players-shared';
+import { ItemSessionUpdateIntent, SessionCommitReason, AssessmentItemRef, AssessmentSection, ItemEntity, PassageEntity, RubricBlock } from '@pie-players/pie-players-shared';
 import { ConfigContainerEntity } from '@pie-players/pie-players-shared/types';
 import { FormativeFeedbackReveal, FormativeItemPolicy, FormativeMasteryRollup, FormativeSectionProjection, FormativeSectionSlice, FormativeTryOutcome } from '@pie-players/pie-players-shared/formative';
 import { TimedMediaDegradation, TimedMediaSectionProjection, TimedMediaSectionSessionSlice, TimedMediaValidationError } from '@pie-players/pie-players-shared/timed-media';
@@ -120,15 +120,6 @@ export interface SectionCanonicalItemViewModel {
     isCurrent: boolean;
     session: unknown;
 }
-export interface SectionCanonicalSectionViewModel {
-    sectionId: string;
-    currentItemIndex: number;
-    items: SectionCanonicalItemViewModel[];
-}
-export interface SectionCanonicalSessionViewModel {
-    currentItemIndex: number;
-    itemSessionsByCanonicalId: Record<string, unknown>;
-}
 export interface SectionAttemptSessionSliceLoadedRenderable {
     itemId: string;
     canonicalItemId: string;
@@ -160,6 +151,8 @@ export interface SessionChangedResult {
         intent?: ItemSessionUpdateIntent;
         complete?: boolean;
         component?: string;
+        elementId?: string;
+        sessionCommitReason?: SessionCommitReason;
         timestamp: number;
     };
 }
@@ -197,15 +190,29 @@ export interface ItemSessionDataChangedEvent extends ItemScopedControllerEventBa
     canonicalItemId: string;
     session: unknown;
     intent?: ItemSessionUpdateIntent;
+    /** The reported completion: the element's own when `elementId` is set. */
     complete?: boolean;
     component?: string;
+    /** The id of the element that reported, when the change names one. */
+    elementId?: string;
+    /** The controller input's `sectionId`. */
+    sectionId?: string;
+    /** Set when the change is a commit at a teardown, navigation or page-hidden seam. */
+    sessionCommitReason?: SessionCommitReason;
 }
 export interface ItemSessionMetaChangedEvent extends ItemScopedControllerEventBase {
     type: "item-session-meta-changed";
     itemId: string;
     canonicalItemId: string;
+    /** The reported completion: the element's own when `elementId` is set. */
     complete?: boolean;
     component?: string;
+    /** The id of the element that reported, when the change names one. */
+    elementId?: string;
+    /** The controller input's `sectionId`. */
+    sectionId?: string;
+    /** Set when the change is a commit at a teardown, navigation or page-hidden seam. */
+    sessionCommitReason?: SessionCommitReason;
 }
 export interface ItemSelectedEvent extends ItemScopedControllerEventBase {
     type: "item-selected";