@pie-players/pie-section-player 0.2.12 → 0.2.14

package/dist/components/shared/player-preload.d.ts

@@ -0,0 +1,37 @@
+import { ItemEntity } from '@pie-players/pie-players-shared';
+export declare const PRELOAD_TIMEOUT_MS = 15000;
+export declare function getRenderablesSignature(renderables: unknown[]): string;
+export declare function getLoaderView(env: Record<string, unknown>): "author" | "delivery";
+export declare function buildPreloadSignature(args: {
+    strategy: string;
+    loaderView: string;
+    esmCdnUrl: string;
+    bundleHost: string;
+    renderablesSignature: string;
+}): string;
+export declare function preloadPlayerElements(args: {
+    strategy: string;
+    renderables: ItemEntity[];
+    loaderView: "author" | "delivery";
+    esmCdnUrl: string;
+    bundleHost: string;
+    onTimeout: () => void;
+    timeoutMs?: number;
+}): Promise<void>;
+export type PlayerPreloadState = {
+    lastPreloadSignature: string;
+    preloadRunToken: number;
+    elementsLoaded: boolean;
+};
+export declare function orchestratePlayerElementPreload(args: {
+    componentTag: string;
+    strategy: string;
+    renderables: ItemEntity[];
+    renderablesSignature: string;
+    resolvedPlayerProps: Record<string, unknown>;
+    resolvedPlayerEnv: Record<string, unknown>;
+    iifeBundleHost?: string | null;
+    getState: () => PlayerPreloadState;
+    setState: (next: Partial<PlayerPreloadState>) => void;
+}): void;
+//# sourceMappingURL=player-preload.d.ts.map

package/dist/components/shared/player-preload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"player-preload.d.ts","sourceRoot":"","sources":["../../../src/components/shared/player-preload.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,UAAU,EACf,MAAM,iCAAiC,CAAC;AAEzC,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,MAAM,CAmBtE;AAED,wBAAgB,aAAa,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1B,QAAQ,GAAG,UAAU,CAEvB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;CAC7B,UAOA;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,UAAU,EAAE,QAAQ,GAAG,UAAU,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,MAAM,kBAAkB,CAAC;IACnC,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAC;CACtD,QAsEA"}

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

@@ -0,0 +1,104 @@
+import { ItemEntity } from '@pie-players/pie-players-shared';
+export declare const DEFAULT_ASSESSMENT_ID = "section-demo-direct";
+export declare const DEFAULT_PLAYER_TYPE = "iife";
+export declare const DEFAULT_LAZY_INIT = true;
+export declare const DEFAULT_ISOLATION = "inherit";
+export declare const DEFAULT_ENV: Record<string, unknown>;
+export type RuntimeConfig = {
+    assessmentId?: string;
+    playerType?: string;
+    player?: Record<string, unknown> | null;
+    lazyInit?: boolean;
+    tools?: Record<string, unknown> | null;
+    accessibility?: Record<string, unknown> | null;
+    coordinator?: unknown;
+    createSectionController?: unknown;
+    isolation?: string;
+    env?: Record<string, unknown>;
+};
+export type RuntimeInputs = {
+    assessmentId?: string;
+    playerType?: string;
+    player?: Record<string, unknown> | null;
+    lazyInit?: boolean;
+    tools?: Record<string, unknown> | null;
+    accessibility?: Record<string, unknown> | null;
+    coordinator?: unknown;
+    createSectionController?: unknown;
+    isolation?: string;
+    env?: Record<string, unknown> | null;
+    runtime: RuntimeConfig | null;
+    enabledTools: string;
+    itemToolbarTools: string;
+    passageToolbarTools: string;
+};
+export declare function resolveToolsConfig(args: {
+    runtime: RuntimeConfig | null;
+    tools: Record<string, unknown> | null;
+    enabledTools: string;
+    itemToolbarTools: string;
+    passageToolbarTools: string;
+}): import('@pie-players/pie-assessment-toolkit').CanonicalToolsConfig;
+export declare function resolveRuntime(args: {
+    assessmentId: string;
+    playerType: string;
+    player: Record<string, unknown> | null;
+    lazyInit: boolean;
+    accessibility: Record<string, unknown> | null;
+    coordinator: unknown;
+    createSectionController: unknown;
+    isolation: string;
+    env: Record<string, unknown> | null;
+    runtime: RuntimeConfig | null;
+    effectiveToolsConfig: unknown;
+}): {
+    env: Record<string, unknown>;
+    tools: unknown;
+    assessmentId: string;
+    playerType: string;
+    player: Record<string, unknown> | null;
+    lazyInit: boolean;
+    accessibility: Record<string, unknown> | null;
+    coordinator: unknown;
+    createSectionController: unknown;
+    isolation: string;
+};
+export declare function resolvePlayerRuntime(args: {
+    effectiveRuntime: Record<string, unknown>;
+    playerType: string;
+    env: Record<string, unknown> | null;
+}): {
+    effectivePlayerType: string;
+    resolvedPlayerDefinition: import('../../component-definitions.js').ComponentDefinition;
+    resolvedPlayerTag: string;
+    resolvedPlayerAttributes: Record<string, string>;
+    resolvedPlayerProps: Record<string, unknown>;
+    resolvedPlayerEnv: Record<string, unknown>;
+    strategy: import('@pie-players/pie-players-shared').ItemPlayerStrategy;
+};
+export declare function mapRenderablesToItems(renderables: unknown[]): ItemEntity[];
+export declare function resolveSectionPlayerRuntimeState(args: RuntimeInputs): {
+    effectiveToolsConfig: import('@pie-players/pie-assessment-toolkit').CanonicalToolsConfig;
+    effectiveRuntime: {
+        env: Record<string, unknown>;
+        tools: unknown;
+        assessmentId: string;
+        playerType: string;
+        player: Record<string, unknown> | null;
+        lazyInit: boolean;
+        accessibility: Record<string, unknown> | null;
+        coordinator: unknown;
+        createSectionController: unknown;
+        isolation: string;
+    };
+    playerRuntime: {
+        effectivePlayerType: string;
+        resolvedPlayerDefinition: import('../../component-definitions.js').ComponentDefinition;
+        resolvedPlayerTag: string;
+        resolvedPlayerAttributes: Record<string, string>;
+        resolvedPlayerProps: Record<string, unknown>;
+        resolvedPlayerEnv: Record<string, unknown>;
+        strategy: import('@pie-players/pie-players-shared').ItemPlayerStrategy;
+    };
+};
+//# sourceMappingURL=section-player-runtime.d.ts.map

package/dist/components/shared/section-player-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-player-runtime.d.ts","sourceRoot":"","sources":["../../../src/components/shared/section-player-runtime.ts"],"names":[],"mappings":"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"}

package/dist/components/shared/section-player-view-state.d.ts

@@ -0,0 +1,24 @@
+import { ItemEntity } from '../../../../players-shared/dist/types/index.d.ts';
+import { SectionCompositionModel } from '../../controllers/types.js';
+import { PlayerElementParams } from './player-action.js';
+export declare function getCompositionFromEvent(event: Event): SectionCompositionModel;
+export declare function getPassagePlayerParams(args: {
+    passage: any;
+    resolvedPlayerEnv: Record<string, unknown>;
+    resolvedPlayerAttributes: Record<string, string>;
+    resolvedPlayerProps: Record<string, unknown>;
+    playerStrategy: string;
+}): PlayerElementParams;
+export declare function getItemPlayerParams(args: {
+    item: ItemEntity;
+    compositionModel: SectionCompositionModel;
+    resolvedPlayerEnv: Record<string, unknown>;
+    resolvedPlayerAttributes: Record<string, string>;
+    resolvedPlayerProps: Record<string, unknown>;
+    playerStrategy: string;
+}): PlayerElementParams;
+export declare function getCanonicalItemId(args: {
+    compositionModel: SectionCompositionModel;
+    item: ItemEntity;
+}): string;
+//# sourceMappingURL=section-player-view-state.d.ts.map

package/dist/components/shared/section-player-view-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-player-view-state.d.ts","sourceRoot":"","sources":["../../../src/components/shared/section-player-view-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAM1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,GAAG,uBAAuB,CAI7E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,GAAG,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,cAAc,EAAE,MAAM,CAAC;CACvB,GAAG,mBAAmB,CAUtB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACzC,IAAI,EAAE,UAAU,CAAC;IACjB,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,cAAc,EAAE,MAAM,CAAC;CACvB,GAAG,mBAAmB,CAStB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACxC,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,IAAI,EAAE,UAAU,CAAC;CACjB,GAAG,MAAM,CAET"}

package/dist/controllers/SectionContentService.d.ts

@@ -1,6 +1,9 @@
 import { AssessmentSection } from '@pie-players/pie-players-shared';
 import { SectionContentModel, SectionView } from './types.js';
 export declare class SectionContentService {
+    private createUniqueId;
+    private resolvePassageBaseId;
+    private normalizePassageEntity;
     build(section: AssessmentSection | null, view: SectionView): SectionContentModel;
 }
 //# sourceMappingURL=SectionContentService.d.ts.map

package/dist/controllers/SectionContentService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SectionContentService.d.ts","sourceRoot":"","sources":["../../src/controllers/SectionContentService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iCAAiC,CAAC;AACxF,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEnE,qBAAa,qBAAqB;IAC1B,KAAK,CACX,OAAO,EAAE,iBAAiB,GAAG,IAAI,EACjC,IAAI,EAAE,WAAW,GACf,mBAAmB;CAqDtB"}
+{"version":3,"file":"SectionContentService.d.ts","sourceRoot":"","sources":["../../src/controllers/SectionContentService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iCAAiC,CAAC;AACxF,OAAO,KAAK,EACX,mBAAmB,EAEnB,WAAW,EACX,MAAM,YAAY,CAAC;AAIpB,qBAAa,qBAAqB;IACjC,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,sBAAsB;IAavB,KAAK,CACX,OAAO,EAAE,iBAAiB,GAAG,IAAI,EACjC,IAAI,EAAE,WAAW,GACf,mBAAmB;CA+HtB"}

package/dist/controllers/SectionController.d.ts

@@ -1,7 +1,7 @@
 import { TestAttemptSession } from '@pie-players/pie-assessment-toolkit';
 import { SectionControllerContext, SectionControllerHandle, SectionControllerPersistenceStrategy } from './toolkit-section-contracts.js';
 import { ItemEntity } from '@pie-players/pie-players-shared';
-import { NavigationResult, SectionControllerChangeListener, SectionCompositionModel, SectionAttemptSessionSlice, SectionNavigationState, SectionSessionState, SectionViewModel, SessionChangedResult } from './types.js';
+import { NavigationResult, SectionCanonicalItemViewModel, SectionCanonicalSectionViewModel, SectionCanonicalSessionViewModel, SectionControllerChangeListener, SectionCompositionModel, SectionAttemptSessionSlice, SectionNavigationState, SectionSessionState, SectionViewModel, SessionChangedResult } from './types.js';
 export declare class SectionController implements SectionControllerHandle {
     private readonly contentService;
     private readonly sessionService;
@@ -10,6 +10,14 @@ export declare class SectionController implements SectionControllerHandle {
     private persistenceContext;
     private state;
     private readonly listeners;
+    private readonly trackedRenderables;
+    private readonly loadedRenderableKeys;
+    private readonly itemCompletionByCanonicalId;
+    private sectionLoadingComplete;
+    private sectionLoadingSnapshot;
+    private sectionItemsCompleteSnapshot;
+    private lastItemSelectionSnapshot;
+    private lastSectionErrorSnapshot;
     private emitChange;
     subscribe(listener: SectionControllerChangeListener): () => void;
     initialize(input?: unknown): Promise<void>;
@@ -22,6 +30,9 @@ export declare class SectionController implements SectionControllerHandle {
     getSnapshot(): unknown;
     getViewModel(): SectionViewModel;
     getCompositionModel(): SectionCompositionModel;
+    getCanonicalItemViewModel(itemId: string): SectionCanonicalItemViewModel | null;
+    getCanonicalSectionViewModel(): SectionCanonicalSectionViewModel;
+    getCanonicalSessionViewModel(): SectionCanonicalSessionViewModel;
     getInstructions(): import('@pie-players/pie-players-shared').RubricBlock[];
     getSectionLoadedEventDetail(): {
         sectionId: string;
@@ -32,6 +43,7 @@ export declare class SectionController implements SectionControllerHandle {
     getResolvedItemSessions(): Record<string, any>;
     getResolvedTestAttemptSession(): TestAttemptSession | null;
     getCanonicalItemId(itemId: string): string;
+    private getItemViewModels;
     getItemSessionsByItemId(): Record<string, any>;
     /**
      * Host-facing persistence shape.
@@ -55,5 +67,47 @@ export declare class SectionController implements SectionControllerHandle {
      * Cross-section navigation belongs to the higher-level assessment player.
      */
     navigateToItem(index: number): NavigationResult | null;
+    handleContentRegistered(args: {
+        itemId: string;
+        canonicalItemId?: string;
+        contentKind?: string;
+    }): void;
+    handleContentUnregistered(args: {
+        itemId: string;
+        canonicalItemId?: string;
+        contentKind?: string;
+    }): void;
+    handleContentLoaded(args: {
+        itemId: string;
+        canonicalItemId?: string;
+        contentKind?: string;
+        detail?: unknown;
+        timestamp?: number;
+    }): void;
+    handleItemPlayerError(args: {
+        itemId: string;
+        canonicalItemId?: string;
+        contentKind?: string;
+        error: unknown;
+        timestamp?: number;
+    }): void;
+    reportSectionError(args: {
+        source: "item-player" | "section-runtime" | "toolkit" | "controller";
+        error: unknown;
+        itemId?: string;
+        canonicalItemId?: string;
+        contentKind?: string;
+        timestamp?: number;
+    }): void;
+    private resetLifecycleTracking;
+    private toSectionContentKind;
+    private getRenderableKey;
+    private readCompleteFromSession;
+    private bootstrapCompletionFromSessions;
+    private updateItemCompleteState;
+    private emitSectionItemsCompleteIfChanged;
+    private evaluateSectionLoadingState;
+    private captureReplaySnapshot;
+    private buildReplayEvents;
 }
 //# sourceMappingURL=SectionController.d.ts.map

package/dist/controllers/SectionController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SectionController.d.ts","sourceRoot":"","sources":["../../src/controllers/SectionController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E,OAAO,KAAK,EACX,wBAAwB,EACxB,uBAAuB,EACvB,oCAAoC,EACpC,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAIlE,OAAO,KAAK,EACX,gBAAgB,EAEhB,+BAA+B,EAC/B,uBAAuB,EACvB,0BAA0B,EAE1B,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,MAAM,YAAY,CAAC;AAQpB,qBAAa,iBAAkB,YAAW,uBAAuB;IAChE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+B;IAC9D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+B;IAC9D,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAsC;IAC5E,OAAO,CAAC,mBAAmB,CAAqD;IAChF,OAAO,CAAC,kBAAkB,CAAyC;IACnE,OAAO,CAAC,KAAK,CAYX;IACF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8C;IAExE,OAAO,CAAC,UAAU;IAmBX,SAAS,CAAC,QAAQ,EAAE,+BAA+B,GAAG,MAAM,IAAI;IAO1D,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B1C,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,sBAAsB,CAClC,QAAQ,EAAE,oCAAoC,GAC5C,OAAO,CAAC,IAAI,CAAC;IAIT,qBAAqB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAIxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,OAAO,IAAI,IAAI;IAIf,WAAW,IAAI,OAAO;IAOtB,YAAY,IAAI,gBAAgB;IAIhC,mBAAmB,IAAI,uBAAuB;IAgB9C,eAAe;IAIf,2BAA2B,IAAI;QACrC,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,OAAO,CAAC;KACpB;IASM,uBAAuB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAK9C,6BAA6B,IAAI,kBAAkB,GAAG,IAAI;IAI1D,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAQ1C,uBAAuB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IA0BrD;;;;OAIG;IACI,eAAe,IAAI,mBAAmB,GAAG,IAAI;IAKpD,OAAO,CAAC,yBAAyB;IAUjC;;;;OAIG;IACI,6BAA6B,IAAI,0BAA0B,GAAG,IAAI;IA6BlE,cAAc,IAAI,UAAU,GAAG,IAAI;IAKnC,qBAAqB,IAAI,OAAO;IAMhC,kBAAkB,CAAC,SAAS,UAAQ,GAAG,sBAAsB;IAa7D,wBAAwB,CAC9B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,GAAG,GAChB,oBAAoB,GAAG,IAAI;IA+B9B;;;OAGG;IACI,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;CAqB7D"}
+{"version":3,"file":"SectionController.d.ts","sourceRoot":"","sources":["../../src/controllers/SectionController.ts"],"names":[],"mappings":"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"}

package/dist/controllers/SectionSessionService.d.ts

@@ -7,7 +7,6 @@ export declare class SectionSessionService {
         visitedItemIdentifiers: string[];
         itemSessions: Record<string, unknown>;
     };
-    private normalizeToItemSession;
     resolve(input: SectionControllerInput & {
         adapterItemRefs: any[];
     }): {

package/dist/controllers/SectionSessionService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SectionSessionService.d.ts","sourceRoot":"","sources":["../../src/controllers/SectionSessionService.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,KAAK,kBAAkB,EACvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE/E,qBAAa,qBAAqB;IACjC,OAAO,CAAC,2BAA2B;IAc5B,cAAc,CAAC,kBAAkB,EAAE,kBAAkB,GAAG;QAC9D,gBAAgB,EAAE,MAAM,CAAC;QACzB,sBAAsB,EAAE,MAAM,EAAE,CAAC;QACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC;IAUD,OAAO,CAAC,sBAAsB;IA6DvB,OAAO,CAAC,KAAK,EAAE,sBAAsB,GAAG;QAAE,eAAe,EAAE,GAAG,EAAE,CAAA;KAAE,GAAG;QAC3E,kBAAkB,EAAE,kBAAkB,CAAC;QACvC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAClC;IASM,uBAAuB,CAAC,IAAI,EAAE;QACpC,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,GAAG,CAAC;QACnB,kBAAkB,EAAE,kBAAkB,CAAC;QACvC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAClC,GAAG,oBAAoB;CA4ExB"}
+{"version":3,"file":"SectionSessionService.d.ts","sourceRoot":"","sources":["../../src/controllers/SectionSessionService.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,KAAK,kBAAkB,EACvB,MAAM,qCAAqC,CAAC;AAK7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE/E,qBAAa,qBAAqB;IACjC,OAAO,CAAC,2BAA2B;IAc5B,cAAc,CAAC,kBAAkB,EAAE,kBAAkB,GAAG;QAC9D,gBAAgB,EAAE,MAAM,CAAC;QACzB,sBAAsB,EAAE,MAAM,EAAE,CAAC;QACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC;IAUM,OAAO,CAAC,KAAK,EAAE,sBAAsB,GAAG;QAAE,eAAe,EAAE,GAAG,EAAE,CAAA;KAAE,GAAG;QAC3E,kBAAkB,EAAE,kBAAkB,CAAC;QACvC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAClC;IASM,uBAAuB,CAAC,IAAI,EAAE;QACpC,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,GAAG,CAAC;QACnB,kBAAkB,EAAE,kBAAkB,CAAC;QACvC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAClC,GAAG,oBAAoB;CAkDxB"}

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

@@ -1,31 +1,5 @@
-import { ToolkitCoordinator } from '@pie-players/pie-assessment-toolkit';
-export interface SectionControllerKey {
-    assessmentId: string;
-    sectionId: string;
-    attemptId?: string;
-}
-export interface SectionControllerContext {
-    key: SectionControllerKey;
-    coordinator: unknown;
-    input?: unknown;
-}
-export interface SectionControllerPersistenceStrategy {
-    load(context: SectionControllerContext): unknown | Promise<unknown>;
-    save(context: SectionControllerContext, snapshot: unknown): void | Promise<void>;
-    clear?(context: SectionControllerContext): void | Promise<void>;
-}
-export interface SectionControllerHandle {
-    initialize?(input?: unknown): void | Promise<void>;
-    updateInput?(input?: unknown): void | Promise<void>;
-    hydrate?(): void | Promise<void>;
-    persist?(): void | Promise<void>;
-    dispose?(): void | Promise<void>;
-    subscribe?(listener: (event: unknown) => void): () => void;
-    getSnapshot?(): unknown;
-    getCurrentSectionAttemptSlice?(): unknown;
-    setPersistenceContext?(context: SectionControllerContext): void | Promise<void>;
-    setPersistenceStrategy?(strategy: SectionControllerPersistenceStrategy): void | Promise<void>;
-}
+import { ToolkitCoordinator, SectionControllerHandle } from '@pie-players/pie-assessment-toolkit';
+export type { SectionControllerContext, SectionControllerHandle, SectionControllerKey, SectionControllerPersistenceStrategy, } from '@pie-players/pie-assessment-toolkit';
 export type CoordinatorWithSectionControllers = ToolkitCoordinator & {
     getOrCreateSectionController(args: {
         sectionId: string;

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

@@ -1 +1 @@
-{"version":3,"file":"toolkit-section-contracts.d.ts","sourceRoot":"","sources":["../../src/controllers/toolkit-section-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E,MAAM,WAAW,oBAAoB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACxC,GAAG,EAAE,oBAAoB,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,oCAAoC;IACpD,IAAI,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpE,IAAI,CAAC,OAAO,EAAE,wBAAwB,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,KAAK,CAAC,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,uBAAuB;IACvC,UAAU,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,WAAW,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC3D,WAAW,CAAC,IAAI,OAAO,CAAC;IAExB,6BAA6B,CAAC,IAAI,OAAO,CAAC;IAC1C,qBAAqB,CAAC,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,sBAAsB,CAAC,CACtB,QAAQ,EAAE,oCAAoC,GAC5C,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,MAAM,iCAAiC,GAAG,kBAAkB,GAAG;IACpE,4BAA4B,CAAC,IAAI,EAAE;QAClC,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,uBAAuB,EAAE,MACtB,uBAAuB,GACvB,OAAO,CAAC,uBAAuB,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACrC,wBAAwB,CAAC,IAAI,EAAE;QAC9B,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC3B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB,CAAC"}
+{"version":3,"file":"toolkit-section-contracts.d.ts","sourceRoot":"","sources":["../../src/controllers/toolkit-section-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,YAAY,EACX,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,oCAAoC,GACpC,MAAM,qCAAqC,CAAC;AAE7C,MAAM,MAAM,iCAAiC,GAAG,kBAAkB,GAAG;IACpE,4BAA4B,CAAC,IAAI,EAAE;QAClC,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,uBAAuB,EAAE,MACtB,uBAAuB,GACvB,OAAO,CAAC,uBAAuB,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACrC,wBAAwB,CAAC,IAAI,EAAE;QAC9B,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC3B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB,CAAC"}

package/dist/controllers/types.d.ts

@@ -1,11 +1,13 @@
 import { TestAttemptSession } from '@pie-players/pie-assessment-toolkit';
-import { AssessmentItemRef, AssessmentSection, ItemEntity, PassageEntity, RubricBlock } from '@pie-players/pie-players-shared';
+import { ItemSessionUpdateIntent, AssessmentItemRef, AssessmentSection, ItemEntity, PassageEntity, RubricBlock } from '@pie-players/pie-players-shared';
+import { ConfigContainerEntity } from '../../../players-shared/dist/types/index.d.ts';
 export type SectionView = "candidate" | "scorer" | "author" | "proctor" | "testConstructor" | "tutor";
 export interface SectionContentModel {
     passages: PassageEntity[];
     items: ItemEntity[];
     rubricBlocks: RubricBlock[];
     instructions: RubricBlock[];
+    renderables: SectionRenderable[];
     adapterItemRefs: Array<{
         identifier: string;
         item: {
@@ -14,6 +16,11 @@ export interface SectionContentModel {
         };
     }>;
 }
+export type SectionRenderableFlavor = "item" | "passage" | "rubric";
+export interface SectionRenderable {
+    flavor: SectionRenderableFlavor;
+    entity: ConfigContainerEntity;
+}
 export interface SectionControllerInput {
     section: AssessmentSection | null;
     view: SectionView;
@@ -36,11 +43,30 @@ export interface SectionCompositionModel {
     items: ItemEntity[];
     rubricBlocks: RubricBlock[];
     instructions: RubricBlock[];
+    renderables: SectionRenderable[];
     currentItemIndex: number;
     currentItem: ItemEntity | null;
     isPageMode: boolean;
     itemSessionsByItemId: Record<string, unknown>;
     testAttemptSession: TestAttemptSession | null;
+    itemViewModels: SectionCanonicalItemViewModel[];
+}
+export interface SectionCanonicalItemViewModel {
+    item: ItemEntity;
+    itemId: string;
+    canonicalItemId: string;
+    index: number;
+    isCurrent: boolean;
+    session: unknown;
+}
+export interface SectionCanonicalSectionViewModel {
+    sectionId: string;
+    currentItemIndex: number;
+    items: SectionCanonicalItemViewModel[];
+}
+export interface SectionCanonicalSessionViewModel {
+    currentItemIndex: number;
+    itemSessionsByCanonicalId: Record<string, unknown>;
 }
 export interface SectionAttemptSessionSlice {
     sectionId: string;
@@ -58,8 +84,7 @@ export interface SessionChangedResult {
     eventDetail: {
         itemId: string;
         session: unknown;
-        sessionState: SectionSessionState;
-        itemSessions: Record<string, unknown>;
+        intent?: ItemSessionUpdateIntent;
         complete?: boolean;
         component?: string;
         timestamp: number;
@@ -83,11 +108,77 @@ export interface SectionNavigationState {
     canPrevious: boolean;
     isLoading: boolean;
 }
-export interface SectionControllerChangeEvent {
-    reason: "initialize" | "hydrate" | "session-change" | "navigation-change";
-    itemId?: string;
+export type SectionContentKind = "item" | "passage" | "rubric" | "unknown";
+interface SectionControllerEventBase {
+    type: "item-session-data-changed" | "item-session-meta-changed" | "item-selected" | "content-loaded" | "item-player-error" | "item-complete-changed" | "section-loading-complete" | "section-items-complete-changed" | "section-error";
     currentItemIndex: number;
     timestamp: number;
+    replayed?: boolean;
+}
+export interface ItemSessionDataChangedEvent extends SectionControllerEventBase {
+    type: "item-session-data-changed";
+    itemId: string;
+    canonicalItemId: string;
+    session: unknown;
+    intent?: ItemSessionUpdateIntent;
+    complete?: boolean;
+    component?: string;
+}
+export interface ItemSessionMetaChangedEvent extends SectionControllerEventBase {
+    type: "item-session-meta-changed";
+    itemId: string;
+    canonicalItemId: string;
+    complete?: boolean;
+    component?: string;
+}
+export interface ItemSelectedEvent extends SectionControllerEventBase {
+    type: "item-selected";
+    previousItemId: string;
+    currentItemId: string;
+    itemIndex: number;
+    totalItems: number;
+}
+export interface ContentLoadedEvent extends SectionControllerEventBase {
+    type: "content-loaded";
+    contentKind: SectionContentKind;
+    itemId: string;
+    canonicalItemId: string;
+    detail?: unknown;
+}
+export interface ItemPlayerErrorEvent extends SectionControllerEventBase {
+    type: "item-player-error";
+    contentKind: SectionContentKind;
+    itemId: string;
+    canonicalItemId: string;
+    error: unknown;
+}
+export interface ItemCompleteChangedEvent extends SectionControllerEventBase {
+    type: "item-complete-changed";
+    itemId: string;
+    canonicalItemId: string;
+    complete: boolean;
+    previousComplete: boolean;
+}
+export interface SectionLoadingCompleteEvent extends SectionControllerEventBase {
+    type: "section-loading-complete";
+    totalRegistered: number;
+    totalLoaded: number;
+}
+export interface SectionItemsCompleteChangedEvent extends SectionControllerEventBase {
+    type: "section-items-complete-changed";
+    complete: boolean;
+    completedCount: number;
+    totalItems: number;
+}
+export interface SectionErrorEvent extends SectionControllerEventBase {
+    type: "section-error";
+    source: "item-player" | "section-runtime" | "toolkit" | "controller";
+    error: unknown;
+    itemId?: string;
+    canonicalItemId?: string;
+    contentKind?: SectionContentKind;
 }
+export type SectionControllerChangeEvent = ItemSessionDataChangedEvent | ItemSessionMetaChangedEvent | ItemSelectedEvent | ContentLoadedEvent | ItemPlayerErrorEvent | ItemCompleteChangedEvent | SectionLoadingCompleteEvent | SectionItemsCompleteChangedEvent | SectionErrorEvent;
 export type SectionControllerChangeListener = (event: SectionControllerChangeEvent) => void;
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/controllers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/controllers/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/controllers/types.ts"],"names":[],"mappings":"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"}