@pie-players/pie-section-player 0.3.3 → 0.3.4

package/README.md

@@ -1,8 +1,9 @@
 # @pie-players/pie-section-player
 
-Section rendering package focused on the splitpane custom element:
+Section rendering package with layout custom elements:
 
 - `pie-section-player-splitpane`
+- `pie-section-player-vertical`
 
 The package no longer exposes the legacy `pie-section-player` layout orchestration API.
 
@@ -18,6 +19,9 @@ Import the custom-element registration entrypoint in consumers:
 
 ```ts
 import '@pie-players/pie-section-player/components/section-player-splitpane-element';
+import '@pie-players/pie-section-player/components/section-player-vertical-element';
+import '@pie-players/pie-section-player/components/section-player-item-card-element';
+import '@pie-players/pie-section-player/components/section-player-passage-card-element';
 ```
 
 Render in HTML/Svelte/JSX:
@@ -30,22 +34,135 @@ Set complex values (`runtime`, `section`, `env`) as JS properties.
 
 ## Runtime Inputs
 
-`pie-section-player-splitpane` supports:
+Both layout elements support:
 
-- `runtime` (object): coordinator/tools/player runtime bundle
+- `runtime` (object): primary coordinator/tools/player runtime bundle
 - `section` (object): assessment section payload
-- `env` (object): `{ mode, role }`
+- `env` (object): optional top-level override for `{ mode, role }`
 - `toolbar-position` (string): `top|right|bottom|left|none`
-- `show-toolbar` (boolean)
+- `show-toolbar` (boolean-like): accepts `true/false` and common string forms (`"true"`, `"false"`, `"1"`, `"0"`, `"yes"`, `"no"`)
+
+### API direction: CE defaults first, JS customization for advanced cases
+
+The intended usage model is:
+
+- **CE props for default/standard flows (roughly 90% use cases)**:
+  - `assessment-id`, `section`, `section-id`, `attempt-id`
+  - `show-toolbar`, `toolbar-position`, `enabled-tools`, `item-toolbar-tools`, `passage-toolbar-tools`
+- **JS API for advanced customization**:
+  - Get the controller handle via `getSectionController()` or `waitForSectionController()`
+  - Listen to `section-controller-ready`
+  - Apply custom policy/gating in host code (for example, domain-specific `canNext` based on controller events like `section-items-complete-changed`)
+  - Compose forward/backward eligibility in host code using `selectNavigation()` + host state; there is intentionally no separate parallel CE gating API for this
+
+Advanced CE props are still supported as escape hatches (`runtime`, `coordinator`, `createSectionController`, etc.), but hosts should prefer JS/controller composition for non-standard behavior.
+
+### Navigation signals
+
+- `item-selected`: item-level navigation change within the current section in the `SectionController` broadcast stream (`itemIndex`, `currentItemId`, `totalItems`).
+- `section-navigation-change`: section-level navigation/selection change in the `SectionController` broadcast stream (`previousSectionId`, `currentSectionId`, `reason`).
+
+Runtime precedence is explicit:
+
+- `runtime` values are primary for runtime fields (`assessmentId`, `playerType`, `player`, `lazyInit`, `tools`, `accessibility`, `coordinator`, `createSectionController`, `isolation`, `env`).
+- Top-level runtime-like props are treated as compatibility/override inputs when a corresponding `runtime` field is absent.
+- Toolbar placement overrides (`enabled-tools`, `item-toolbar-tools`, `passage-toolbar-tools`) are normalized on top of the runtime tools config.
 
 See `apps/section-demos/src/routes/demo/[[id]]/+page.svelte` for an end-to-end host integration.
 
+## Data flow and stability guarantees
+
+Section-player follows a unidirectional flow model:
+
+- Inputs flow downward (`runtime`, `section`, `env`, toolbar options) into base/toolkit/layout/card render paths.
+- State updates flow upward as events (`runtime-*`, `session-changed`, controller change events) and are reconciled by runtime owners.
+- Layout/card components should not create competing sources of truth for composition/session.
+
+### Stability guarantees
+
+For non-structural updates, section-player guarantees behavior stability:
+
+- Item/passage shell identity remains stable (no remount churn for response-only updates).
+- Pane-local scroll position remains stable in splitpane and vertical layouts.
+
+Non-structural updates include:
+
+- response/session updates
+- tool toggles/config updates
+- runtime config changes that do not alter composition identity
+
+Structural composition changes (new/removed/reordered entities) may legitimately re-render/remount affected nodes.
+
+## Custom layout authoring
+
+For section layout authors, `pie-section-player-shell` is the primary abstraction:
+
+- Use `pie-section-player-shell` to place the section toolbar around your layout body.
+- Keep your custom layout logic focused on passages/items and layout UI.
+- Treat `pie-section-player-base` as internal runtime plumbing that wraps the shell.
+- Use `pie-section-player-item-card` and `pie-section-player-passage-card` as reusable card primitives.
+- Prefer shared context for cross-cutting card render plumbing (resolved player tag/action) over repeated prop drilling.
+
+Minimal pattern for package layout components:
+
+```svelte
+<pie-section-player-base runtime={effectiveRuntime} {section} section-id={sectionId} attempt-id={attemptId}>
+  <pie-section-player-shell
+    show-toolbar={showToolbar}
+    toolbar-position={toolbarPosition}
+    enabled-tools={enabledTools}
+  >
+    <!-- layout-specific body -->
+    <pie-section-player-passage-card
+      passage={passage}
+      playerParams={passagePlayerParams}
+      passageToolbarTools={passageToolbarTools}
+    ></pie-section-player-passage-card>
+    <pie-section-player-item-card
+      item={item}
+      canonicalItemId={canonicalItemId}
+      playerParams={itemPlayerParams}
+      itemToolbarTools={itemToolbarTools}
+    ></pie-section-player-item-card>
+  </pie-section-player-shell>
+</pie-section-player-base>
+```
+
+### JS API example for advanced host policy
+
+```ts
+const host = document.querySelector("pie-section-player-splitpane") as any;
+const controller = await host.waitForSectionController?.(5000);
+let sectionComplete = false;
+
+const unsubscribe = controller?.subscribe?.((event: any) => {
+  if (event?.type === "section-items-complete-changed") {
+    sectionComplete = event.complete === true;
+  }
+});
+
+function canAdvance() {
+  const nav = host.selectNavigation?.();
+  return Boolean(nav?.canNext && sectionComplete);
+}
+```
+
 ## Exports
 
 Published exports are intentionally minimal:
 
 - `@pie-players/pie-section-player`
 - `@pie-players/pie-section-player/components/section-player-splitpane-element`
+- `@pie-players/pie-section-player/components/section-player-vertical-element`
+- `@pie-players/pie-section-player/components/section-player-kernel-host-element`
+- `@pie-players/pie-section-player/components/section-player-shell-element`
+- `@pie-players/pie-section-player/components/section-player-item-card-element`
+- `@pie-players/pie-section-player/components/section-player-passage-card-element`
+- `@pie-players/pie-section-player/contracts/layout-contract`
+- `@pie-players/pie-section-player/contracts/public-events`
+- `@pie-players/pie-section-player/contracts/runtime-host-contract`
+- `@pie-players/pie-section-player/contracts/layout-parity-metadata`
+- `@pie-players/pie-section-player/policies`
 
 ## Development
 

package/dist/components/section-player-item-card-element.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=section-player-item-card-element.d.ts.map

package/dist/components/section-player-item-card-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-player-item-card-element.d.ts","sourceRoot":"","sources":["../../src/components/section-player-item-card-element.ts"],"names":[],"mappings":"AAAA,OAAO,iCAAiC,CAAC;AAEzC,OAAO,EAAE,CAAC"}

package/dist/components/section-player-items-pane-element.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=section-player-items-pane-element.d.ts.map

package/dist/components/section-player-items-pane-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-player-items-pane-element.d.ts","sourceRoot":"","sources":["../../src/components/section-player-items-pane-element.ts"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAC;AAE1C,OAAO,EAAE,CAAC"}

package/dist/components/section-player-kernel-host-element.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=section-player-kernel-host-element.d.ts.map

package/dist/components/section-player-kernel-host-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-player-kernel-host-element.d.ts","sourceRoot":"","sources":["../../src/components/section-player-kernel-host-element.ts"],"names":[],"mappings":"AAAA,OAAO,4CAA4C,CAAC;AAEpD,OAAO,EAAE,CAAC"}

package/dist/components/section-player-passage-card-element.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=section-player-passage-card-element.d.ts.map

package/dist/components/section-player-passage-card-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-player-passage-card-element.d.ts","sourceRoot":"","sources":["../../src/components/section-player-passage-card-element.ts"],"names":[],"mappings":"AAAA,OAAO,oCAAoC,CAAC;AAE5C,OAAO,EAAE,CAAC"}

package/dist/components/section-player-passages-pane-element.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=section-player-passages-pane-element.d.ts.map

package/dist/components/section-player-passages-pane-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-player-passages-pane-element.d.ts","sourceRoot":"","sources":["../../src/components/section-player-passages-pane-element.ts"],"names":[],"mappings":"AAAA,OAAO,qCAAqC,CAAC;AAE7C,OAAO,EAAE,CAAC"}

package/dist/components/section-player-shell-element.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=section-player-shell-element.d.ts.map

package/dist/components/section-player-shell-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-player-shell-element.d.ts","sourceRoot":"","sources":["../../src/components/section-player-shell-element.ts"],"names":[],"mappings":"AAAA,OAAO,6BAA6B,CAAC;AAErC,OAAO,EAAE,CAAC"}

package/dist/components/shared/outer-scrollbars.d.ts

@@ -0,0 +1,6 @@
+export declare function manageOuterScrollbars(args?: {
+    managedClass?: string;
+    activeClass?: string;
+    idleTimeoutMs?: number;
+}): () => void;
+//# sourceMappingURL=outer-scrollbars.d.ts.map

package/dist/components/shared/outer-scrollbars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outer-scrollbars.d.ts","sourceRoot":"","sources":["../../../src/components/shared/outer-scrollbars.ts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,IAAI,CAkCb"}

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

@@ -13,6 +13,7 @@ type PlayerActionOptions = {
 };
 export declare function createPlayerAction(options: PlayerActionOptions): (node: HTMLElement, params: PlayerElementParams) => {
     update(nextParams: PlayerElementParams): void;
+    destroy(): void;
 };
 export {};
 //# sourceMappingURL=player-action.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"player-action.d.ts","sourceRoot":"","sources":["../../../src/components/shared/player-action.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAUF,KAAK,mBAAmB,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AAaF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,IACtD,MAAM,WAAW,EAAE,QAAQ,mBAAmB;uBAGjC,mBAAmB;EAKxC"}
+{"version":3,"file":"player-action.d.ts","sourceRoot":"","sources":["../../../src/components/shared/player-action.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAYF,KAAK,mBAAmB,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AA2BF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,IACtD,MAAM,WAAW,EAAE,QAAQ,mBAAmB;uBAGjC,mBAAmB;;EAQxC"}

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

@@ -23,6 +23,11 @@ export type PlayerPreloadState = {
     preloadRunToken: number;
     elementsLoaded: boolean;
 };
+export declare function createPlayerPreloadStateSetter(args: {
+    setLastPreloadSignature: (value: string) => void;
+    setPreloadRunToken: (value: number) => void;
+    setElementsLoaded: (value: boolean) => void;
+}): (next: Partial<PlayerPreloadState>) => void;
 export declare function orchestratePlayerElementPreload(args: {
     componentTag: string;
     strategy: string;

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

@@ -1 +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;AAGzC,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,CAgChB;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"}
+{"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;AAGzC,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,CAgChB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACpD,uBAAuB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,iBAAiB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC5C,IACQ,MAAM,OAAO,CAAC,kBAAkB,CAAC,UAWzC;AAED,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-card-context.d.ts

@@ -0,0 +1,15 @@
+import { PlayerElementParams } from './player-action.js';
+export type SectionPlayerCardRenderContext = {
+    resolvedPlayerTag: string;
+    playerAction: (node: HTMLElement, params: PlayerElementParams) => unknown;
+};
+export declare const sectionPlayerCardRenderContext: {
+    __context__: SectionPlayerCardRenderContext;
+};
+export declare function getHostElementFromAnchor(anchor: HTMLElement | null): HTMLElement | null;
+export declare function connectSectionPlayerCardRenderContext(host: HTMLElement, onValue: (value: SectionPlayerCardRenderContext) => void): () => void;
+export declare function createSectionPlayerCardRenderContextProvider(host: HTMLElement, initialValue: SectionPlayerCardRenderContext): {
+    setValue: (value: SectionPlayerCardRenderContext) => void;
+    disconnect: () => void;
+};
+//# sourceMappingURL=section-player-card-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"section-player-card-context.d.ts","sourceRoot":"","sources":["../../../src/components/shared/section-player-card-context.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,MAAM,8BAA8B,GAAG;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC;CAC1E,CAAC;AAEF,eAAO,MAAM,8BAA8B;;CAE1C,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI,CAOvF;AA8CD,wBAAgB,qCAAqC,CACpD,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,8BAA8B,KAAK,IAAI,GACtD,MAAM,IAAI,CAMZ;AAED,wBAAgB,4CAA4C,CAC3D,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,8BAA8B;sBAUzB,8BAA8B;;EAMjD"}

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

@@ -0,0 +1,2 @@
+export declare function coerceBooleanLike(value: boolean | string | null | undefined, defaultValue?: boolean): boolean;
+//# sourceMappingURL=section-player-props.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"section-player-props.d.ts","sourceRoot":"","sources":["../../../src/components/shared/section-player-props.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAC1C,YAAY,UAAQ,GAClB,OAAO,CAkBT"}

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

@@ -0,0 +1,14 @@
+import { SectionPlayerReadinessChangeDetail, SectionPlayerReadinessPhase } from '../../contracts/public-events.js';
+export type ReadinessSignals = {
+    sectionReady: boolean;
+    interactionReady: boolean;
+    allLoadingComplete: boolean;
+    runtimeError: boolean;
+};
+export declare function resolveReadinessPhase(signals: ReadinessSignals): SectionPlayerReadinessPhase;
+export declare function createReadinessDetail(args: {
+    mode: "progressive" | "strict";
+    signals: ReadinessSignals;
+    reason?: string;
+}): SectionPlayerReadinessChangeDetail;
+//# sourceMappingURL=section-player-readiness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"section-player-readiness.d.ts","sourceRoot":"","sources":["../../../src/components/shared/section-player-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,kCAAkC,EAClC,2BAA2B,EAC3B,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,2BAA2B,CAM5F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC3C,IAAI,EAAE,aAAa,GAAG,QAAQ,CAAC;IAC/B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,kCAAkC,CAiBrC"}

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

@@ -52,8 +52,6 @@ export declare function resolveRuntime(args: {
     runtime: RuntimeConfig | null;
     effectiveToolsConfig: unknown;
 }): {
-    env: Record<string, unknown>;
-    tools: unknown;
     assessmentId: string;
     playerType: string;
     player: Record<string, unknown> | null;
@@ -62,6 +60,8 @@ export declare function resolveRuntime(args: {
     coordinator: unknown;
     createSectionController: unknown;
     isolation: string;
+    env: Record<string, unknown>;
+    tools: unknown;
 };
 export declare function resolvePlayerRuntime(args: {
     effectiveRuntime: Record<string, unknown>;
@@ -80,8 +80,6 @@ export declare function mapRenderablesToItems(renderables: unknown[]): ItemEntit
 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;
@@ -90,6 +88,8 @@ export declare function resolveSectionPlayerRuntimeState(args: RuntimeInputs): {
         coordinator: unknown;
         createSectionController: unknown;
         isolation: string;
+        env: Record<string, unknown>;
+        tools: unknown;
     };
     playerRuntime: {
         effectivePlayerType: string;

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

@@ -1 +1 @@
-{"version":3,"file":"section-player-runtime.d.ts","sourceRoot":"","sources":["../../../src/components/shared/section-player-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"section-player-runtime.d.ts","sourceRoot":"","sources":["../../../src/components/shared/section-player-runtime.ts"],"names":[],"mappings":"AAIA,OAAO,EAEN,KAAK,UAAU,EACf,MAAM,iCAAiC,CAAC;AAGzC,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AAC3D,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAC1C,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,eAAO,MAAM,WAAW,EAA0C,MAAM,CACvE,MAAM,EACN,OAAO,CACP,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACxC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;CAC5B,sEAoBA;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB,uBAAuB,EAAE,OAAO,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,oBAAoB,EAAE,OAAO,CAAC;CAC9B;;;;;;;;;;;EAgBA;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAC1C,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACpC;;;;;;;;EAgCA;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,CAK1E;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;EA0CnE"}

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

@@ -1,7 +1,16 @@
 import { ItemEntity } from '../../../../players-shared/dist/types/index.d.ts';
 import { SectionCompositionModel } from '../../controllers/types.js';
 import { PlayerElementParams } from './player-action.js';
+export type LayoutCompositionSnapshot = {
+    compositionModel: SectionCompositionModel;
+    passages: SectionCompositionModel["passages"];
+    items: SectionCompositionModel["items"];
+    renderables: ItemEntity[];
+    renderablesSignature: string;
+};
 export declare function getCompositionFromEvent(event: Event): SectionCompositionModel;
+export declare function deriveLayoutCompositionSnapshot(compositionModel: SectionCompositionModel): LayoutCompositionSnapshot;
+export declare function getCompositionSnapshotFromEvent(event: Event): LayoutCompositionSnapshot;
 export declare function getPassagePlayerParams(args: {
     passage: any;
     resolvedPlayerEnv: Record<string, unknown>;

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

@@ -1 +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"}
+{"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;AAI9D,MAAM,MAAM,yBAAyB,GAAG;IACvC,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAC9C,KAAK,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACxC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,GAAG,uBAAuB,CAI7E;AAED,wBAAgB,+BAA+B,CAC9C,gBAAgB,EAAE,uBAAuB,GACvC,yBAAyB,CAS3B;AAED,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,KAAK,GACV,yBAAyB,CAE3B;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/contracts/layout-contract.d.ts

@@ -0,0 +1,18 @@
+import { SectionPlayerPublicEventName } from './public-events.js';
+export type SectionPlayerLayoutName = "splitpane" | "vertical";
+export type SectionPlayerLayoutCapability = "items-pane" | "passages-pane" | "section-toolbar" | "item-toolbar" | "passage-toolbar" | "readiness-events" | "navigation-events";
+export type SectionPlayerBasicPropName = "assessmentId" | "section" | "sectionId" | "attemptId" | "showToolbar" | "toolbarPosition" | "enabledTools" | "itemToolbarTools" | "passageToolbarTools";
+export type SectionPlayerAdvancedPropName = "runtime" | "playerType" | "player" | "lazyInit" | "tools" | "accessibility" | "coordinator" | "createSectionController" | "isolation" | "env" | "iifeBundleHost";
+export type SectionPlayerLayoutPropName = SectionPlayerBasicPropName | SectionPlayerAdvancedPropName;
+export type SectionPlayerLayoutCommandName = "getSnapshot" | "selectComposition" | "selectNavigation" | "selectReadiness" | "navigateTo" | "navigateNext" | "navigatePrevious" | "getSectionController" | "waitForSectionController";
+export type SectionPlayerLayoutContract = {
+    version: 1;
+    layout: SectionPlayerLayoutName;
+    props: readonly SectionPlayerLayoutPropName[];
+    recommendedBasicProps: readonly SectionPlayerBasicPropName[];
+    advancedEscapeHatchProps: readonly SectionPlayerAdvancedPropName[];
+    events: readonly SectionPlayerPublicEventName[];
+    commands: readonly SectionPlayerLayoutCommandName[];
+    capabilities: readonly SectionPlayerLayoutCapability[];
+};
+//# sourceMappingURL=layout-contract.d.ts.map

package/dist/contracts/layout-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/layout-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAEvE,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,UAAU,CAAC;AAE/D,MAAM,MAAM,6BAA6B,GACtC,YAAY,GACZ,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,mBAAmB,CAAC;AAEvB,MAAM,MAAM,0BAA0B,GACnC,cAAc,GACd,SAAS,GACT,WAAW,GACX,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,cAAc,GACd,kBAAkB,GAClB,qBAAqB,CAAC;AAEzB,MAAM,MAAM,6BAA6B,GACtC,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,UAAU,GACV,OAAO,GACP,eAAe,GACf,aAAa,GACb,yBAAyB,GACzB,WAAW,GACX,KAAK,GACL,gBAAgB,CAAC;AAEpB,MAAM,MAAM,2BAA2B,GACpC,0BAA0B,GAC1B,6BAA6B,CAAC;AAEjC,MAAM,MAAM,8BAA8B,GACvC,aAAa,GACb,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,GACjB,YAAY,GACZ,cAAc,GACd,kBAAkB,GAClB,sBAAsB,GACtB,0BAA0B,CAAC;AAE9B,MAAM,MAAM,2BAA2B,GAAG;IACzC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,uBAAuB,CAAC;IAChC,KAAK,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAC9C,qBAAqB,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC7D,wBAAwB,EAAE,SAAS,6BAA6B,EAAE,CAAC;IACnE,MAAM,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAChD,QAAQ,EAAE,SAAS,8BAA8B,EAAE,CAAC;IACpD,YAAY,EAAE,SAAS,6BAA6B,EAAE,CAAC;CACvD,CAAC"}

package/dist/contracts/layout-parity-metadata.d.ts

@@ -0,0 +1,4 @@
+import { SectionPlayerLayoutContract } from './layout-contract.js';
+export declare const SPLITPANE_LAYOUT_CONTRACT: SectionPlayerLayoutContract;
+export declare const VERTICAL_LAYOUT_CONTRACT: SectionPlayerLayoutContract;
+//# sourceMappingURL=layout-parity-metadata.d.ts.map

package/dist/contracts/layout-parity-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-parity-metadata.d.ts","sourceRoot":"","sources":["../../src/contracts/layout-parity-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAoExE,eAAO,MAAM,yBAAyB,EAAE,2BASvC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,2BAStC,CAAC"}

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

@@ -0,0 +1,25 @@
+export declare const SECTION_PLAYER_PUBLIC_EVENTS: {
+    readonly runtimeOwned: "runtime-owned";
+    readonly runtimeInherited: "runtime-inherited";
+    readonly runtimeError: "runtime-error";
+    readonly compositionChanged: "composition-changed";
+    readonly sessionChanged: "session-changed";
+    readonly sectionControllerReady: "section-controller-ready";
+    readonly readinessChange: "readiness-change";
+    readonly interactionReady: "interaction-ready";
+    readonly ready: "ready";
+};
+export type SectionPlayerPublicEventName = (typeof SECTION_PLAYER_PUBLIC_EVENTS)[keyof typeof SECTION_PLAYER_PUBLIC_EVENTS];
+export type SectionPlayerReadinessPhase = "bootstrapping" | "interaction-ready" | "loading" | "ready" | "error";
+export type SectionPlayerReadinessChangeDetail = {
+    phase: SectionPlayerReadinessPhase;
+    interactionReady: boolean;
+    allLoadingComplete: boolean;
+    reason?: string;
+};
+export type SectionPlayerControllerReadyDetail = {
+    sectionId: string;
+    attemptId?: string;
+    controller: unknown;
+};
+//# sourceMappingURL=public-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"public-events.d.ts","sourceRoot":"","sources":["../../src/contracts/public-events.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B;;;;;;;;;;CAU/B,CAAC;AAEX,MAAM,MAAM,4BAA4B,GACvC,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,OAAO,4BAA4B,CAAC,CAAC;AAElF,MAAM,MAAM,2BAA2B,GACpC,eAAe,GACf,mBAAmB,GACnB,SAAS,GACT,OAAO,GACP,OAAO,CAAC;AAEX,MAAM,MAAM,kCAAkC,GAAG;IAChD,KAAK,EAAE,2BAA2B,CAAC;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACpB,CAAC"}

package/dist/contracts/runtime-host-contract.d.ts

@@ -0,0 +1,29 @@
+import { SectionPlayerReadinessChangeDetail } from './public-events.js';
+import { SectionControllerHandle } from '@pie-players/pie-assessment-toolkit';
+export type SectionPlayerNavigationSnapshot = {
+    currentIndex: number;
+    totalItems: number;
+    canNext: boolean;
+    canPrevious: boolean;
+    currentItemId?: string;
+};
+export type SectionPlayerSnapshot = {
+    readiness: SectionPlayerReadinessChangeDetail;
+    composition: {
+        itemsCount: number;
+        passagesCount: number;
+    };
+    navigation: SectionPlayerNavigationSnapshot;
+};
+export interface SectionPlayerRuntimeHostContract {
+    getSnapshot(): SectionPlayerSnapshot;
+    selectComposition(): SectionPlayerSnapshot["composition"];
+    selectNavigation(): SectionPlayerNavigationSnapshot;
+    selectReadiness(): SectionPlayerReadinessChangeDetail;
+    navigateTo(index: number): boolean;
+    navigateNext(): boolean;
+    navigatePrevious(): boolean;
+    getSectionController(): SectionControllerHandle | null;
+    waitForSectionController(timeoutMs?: number): Promise<SectionControllerHandle | null>;
+}
+//# sourceMappingURL=runtime-host-contract.d.ts.map

package/dist/contracts/runtime-host-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-host-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/runtime-host-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,kCAAkC,EAClC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAEnF,MAAM,MAAM,+BAA+B,GAAG;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IACnC,SAAS,EAAE,kCAAkC,CAAC;IAC9C,WAAW,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,UAAU,EAAE,+BAA+B,CAAC;CAC5C,CAAC;AAEF,MAAM,WAAW,gCAAgC;IAChD,WAAW,IAAI,qBAAqB,CAAC;IACrC,iBAAiB,IAAI,qBAAqB,CAAC,aAAa,CAAC,CAAC;IAC1D,gBAAgB,IAAI,+BAA+B,CAAC;IACpD,eAAe,IAAI,kCAAkC,CAAC;IACtD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,YAAY,IAAI,OAAO,CAAC;IACxB,gBAAgB,IAAI,OAAO,CAAC;IAC5B,oBAAoB,IAAI,uBAAuB,GAAG,IAAI,CAAC;IACvD,wBAAwB,CACvB,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;CAC3C"}

package/dist/controllers/SectionController.d.ts

@@ -16,6 +16,7 @@ export declare class SectionController implements SectionControllerHandle {
     private sectionLoadingComplete;
     private sectionLoadingSnapshot;
     private sectionItemsCompleteSnapshot;
+    private sectionNavigationSnapshot;
     private lastItemSelectionSnapshot;
     private lastSectionErrorSnapshot;
     private emitChange;
@@ -109,5 +110,6 @@ export declare class SectionController implements SectionControllerHandle {
     private evaluateSectionLoadingState;
     private captureReplaySnapshot;
     private buildReplayEvents;
+    private cloneForRead;
 }
 //# 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":"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"}
+{"version":3,"file":"SectionController.d.ts","sourceRoot":"","sources":["../../src/controllers/SectionController.ts"],"names":[],"mappings":"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"}

package/dist/controllers/types.d.ts

@@ -110,12 +110,14 @@ export interface SectionNavigationState {
 }
 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;
+    type: "item-session-data-changed" | "item-session-meta-changed" | "item-selected" | "section-navigation-change" | "content-loaded" | "item-player-error" | "item-complete-changed" | "section-loading-complete" | "section-items-complete-changed" | "section-error";
     timestamp: number;
     replayed?: boolean;
 }
-export interface ItemSessionDataChangedEvent extends SectionControllerEventBase {
+interface ItemScopedControllerEventBase extends SectionControllerEventBase {
+    currentItemIndex: number;
+}
+export interface ItemSessionDataChangedEvent extends ItemScopedControllerEventBase {
     type: "item-session-data-changed";
     itemId: string;
     canonicalItemId: string;
@@ -124,53 +126,60 @@ export interface ItemSessionDataChangedEvent extends SectionControllerEventBase
     complete?: boolean;
     component?: string;
 }
-export interface ItemSessionMetaChangedEvent extends SectionControllerEventBase {
+export interface ItemSessionMetaChangedEvent extends ItemScopedControllerEventBase {
     type: "item-session-meta-changed";
     itemId: string;
     canonicalItemId: string;
     complete?: boolean;
     component?: string;
 }
-export interface ItemSelectedEvent extends SectionControllerEventBase {
+export interface ItemSelectedEvent extends ItemScopedControllerEventBase {
     type: "item-selected";
     previousItemId: string;
     currentItemId: string;
     itemIndex: number;
     totalItems: number;
 }
-export interface ContentLoadedEvent extends SectionControllerEventBase {
+export interface SectionNavigationChangeEvent extends SectionControllerEventBase {
+    type: "section-navigation-change";
+    previousSectionId?: string;
+    currentSectionId?: string;
+    attemptId?: string;
+    reason?: "input-change" | "runtime-transition";
+}
+export interface ContentLoadedEvent extends ItemScopedControllerEventBase {
     type: "content-loaded";
     contentKind: SectionContentKind;
     itemId: string;
     canonicalItemId: string;
     detail?: unknown;
 }
-export interface ItemPlayerErrorEvent extends SectionControllerEventBase {
+export interface ItemPlayerErrorEvent extends ItemScopedControllerEventBase {
     type: "item-player-error";
     contentKind: SectionContentKind;
     itemId: string;
     canonicalItemId: string;
     error: unknown;
 }
-export interface ItemCompleteChangedEvent extends SectionControllerEventBase {
+export interface ItemCompleteChangedEvent extends ItemScopedControllerEventBase {
     type: "item-complete-changed";
     itemId: string;
     canonicalItemId: string;
     complete: boolean;
     previousComplete: boolean;
 }
-export interface SectionLoadingCompleteEvent extends SectionControllerEventBase {
+export interface SectionLoadingCompleteEvent extends ItemScopedControllerEventBase {
     type: "section-loading-complete";
     totalRegistered: number;
     totalLoaded: number;
 }
-export interface SectionItemsCompleteChangedEvent extends SectionControllerEventBase {
+export interface SectionItemsCompleteChangedEvent extends ItemScopedControllerEventBase {
     type: "section-items-complete-changed";
     complete: boolean;
     completedCount: number;
     totalItems: number;
 }
-export interface SectionErrorEvent extends SectionControllerEventBase {
+export interface SectionErrorEvent extends ItemScopedControllerEventBase {
     type: "section-error";
     source: "item-player" | "section-runtime" | "toolkit" | "controller";
     error: unknown;
@@ -178,7 +187,7 @@ export interface SectionErrorEvent extends SectionControllerEventBase {
     canonicalItemId?: string;
     contentKind?: SectionContentKind;
 }
-export type SectionControllerChangeEvent = ItemSessionDataChangedEvent | ItemSessionMetaChangedEvent | ItemSelectedEvent | ContentLoadedEvent | ItemPlayerErrorEvent | ItemCompleteChangedEvent | SectionLoadingCompleteEvent | SectionItemsCompleteChangedEvent | SectionErrorEvent;
+export type SectionControllerChangeEvent = ItemSessionDataChangedEvent | ItemSessionMetaChangedEvent | ItemSelectedEvent | SectionNavigationChangeEvent | ContentLoadedEvent | ItemPlayerErrorEvent | ItemCompleteChangedEvent | SectionLoadingCompleteEvent | SectionItemsCompleteChangedEvent | SectionErrorEvent;
 export type SectionControllerChangeListener = (event: SectionControllerChangeEvent) => void;
 export {};
 //# sourceMappingURL=types.d.ts.map