@pie-players/pie-assessment-toolkit 0.3.30 → 0.3.32

package/dist/runtime/core/engine-output.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Section runtime engine outputs (M7 — Variant C, layered core).
+ *
+ * Outputs are the closed discriminated union of effects the transition
+ * function returns. The adapter (PR 2) takes the output array, walks
+ * it in order, and dispatches each one to the right bridge (DOM
+ * events, framework-error bus, subscriber fan-out).
+ *
+ * Outputs carry only plain data so the transition table can be tested
+ * exhaustively without any DOM or coordinator wiring.
+ *
+ * Adjustment A2 from the M7 implementation plan: `loading-complete`
+ * is an output, **not** an FSM phase. The transition emits it from
+ * the `interactive` phase when the readiness signals indicate every
+ * item has finished loading. This mirrors today's
+ * `pie-loading-complete` DOM event semantics.
+ *
+ * The deprecated readiness output kinds (`readiness-change`,
+ * `interaction-ready`, `ready`) were removed in the broad
+ * architecture review compat sweep along with their DOM-event bridge
+ * (`legacy-event-bridge.ts`). Stage and readiness changes now flow
+ * through `stage-change` (with `EngineReadinessDetail` available via
+ * `SectionEngineCore.getState()` / kernel `selectReadiness()`); the
+ * "all items loaded" signal flows through `loading-complete` only.
+ */
+import type { Stage, StageStatus } from "@pie-players/pie-players-shared/pie";
+import type { CohortKey } from "./cohort.js";
+import type { FrameworkErrorModel } from "../../services/framework-error.js";
+/**
+ * Stage transition. The adapter dispatches a `pie-stage-change` DOM
+ * event with the canonical detail and forwards to subscribers /
+ * coordinator. The status indicates whether the stage was entered,
+ * skipped, or recorded as failed.
+ */
+export type EngineOutputStageChange = {
+    kind: "stage-change";
+    stage: Stage;
+    status: StageStatus;
+    cohort: CohortKey | null;
+};
+/**
+ * Canonical `pie-loading-complete` emit (M6 D1). One-shot per cohort.
+ * Fires from the `interactive` phase when loaded == items count and
+ * the readiness signals satisfy `allLoadingComplete`.
+ */
+export type EngineOutputLoadingComplete = {
+    kind: "loading-complete";
+    cohort: CohortKey;
+    itemCount: number;
+    loadedCount: number;
+};
+/**
+ * Framework error fan-out. Mirrors the M3 `framework-error` DOM event
+ * and the `subscribeFrameworkErrors` listener channel. Emitted on
+ * every `framework-error` input.
+ */
+export type EngineOutputFrameworkError = {
+    kind: "framework-error";
+    error: FrameworkErrorModel;
+};
+export type SectionEngineOutput = EngineOutputStageChange | EngineOutputLoadingComplete | EngineOutputFrameworkError;
+//# sourceMappingURL=engine-output.d.ts.map

package/dist/runtime/core/engine-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-output.d.ts","sourceRoot":"","sources":["../../../src/runtime/core/engine-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACzC,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACxC,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,mBAAmB,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC5B,uBAAuB,GACvB,2BAA2B,GAC3B,0BAA0B,CAAC"}

package/dist/runtime/core/engine-output.js

@@ -0,0 +1,27 @@
+/**
+ * Section runtime engine outputs (M7 — Variant C, layered core).
+ *
+ * Outputs are the closed discriminated union of effects the transition
+ * function returns. The adapter (PR 2) takes the output array, walks
+ * it in order, and dispatches each one to the right bridge (DOM
+ * events, framework-error bus, subscriber fan-out).
+ *
+ * Outputs carry only plain data so the transition table can be tested
+ * exhaustively without any DOM or coordinator wiring.
+ *
+ * Adjustment A2 from the M7 implementation plan: `loading-complete`
+ * is an output, **not** an FSM phase. The transition emits it from
+ * the `interactive` phase when the readiness signals indicate every
+ * item has finished loading. This mirrors today's
+ * `pie-loading-complete` DOM event semantics.
+ *
+ * The deprecated readiness output kinds (`readiness-change`,
+ * `interaction-ready`, `ready`) were removed in the broad
+ * architecture review compat sweep along with their DOM-event bridge
+ * (`legacy-event-bridge.ts`). Stage and readiness changes now flow
+ * through `stage-change` (with `EngineReadinessDetail` available via
+ * `SectionEngineCore.getState()` / kernel `selectReadiness()`); the
+ * "all items loaded" signal flows through `loading-complete` only.
+ */
+export {};
+//# sourceMappingURL=engine-output.js.map

package/dist/runtime/core/engine-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-output.js","sourceRoot":"","sources":["../../../src/runtime/core/engine-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG"}

package/dist/runtime/core/engine-readiness.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Readiness derivation for the section runtime engine (M7).
+ *
+ * Canonical home of `createReadinessDetail` and `resolveReadinessPhase`.
+ * As of M7 PR 7 the previous duplicates in
+ * `packages/section-player/src/components/shared/section-player-readiness.ts`
+ * have been deleted; section-player now consumes these helpers via
+ * `@pie-players/pie-assessment-toolkit/runtime/internal`.
+ *
+ * Type duplication note: the public DOM-event detail aliases
+ * (`SectionPlayerReadinessChangeDetail` /
+ * `SectionPlayerReadinessPhase`) still live in section-player's
+ * `contracts/public-events.ts` because that file is part of section-
+ * player's published custom-element contract. The toolkit core defines
+ * `EngineReadinessPhase` independently so it has zero section-player
+ * imports. The two definitions must stay structurally identical;
+ * that invariant is covered by the readiness assertions in this
+ * package's tests, which mirror the section-player suite.
+ */
+/**
+ * Coarse readiness phase label, derived from the four readiness
+ * signals. Surfaced via the kernel's `selectReadiness()` /
+ * `getSnapshot().readiness` selectors; M6 stages own the stage-level
+ * transitions on `pie-stage-change` and use this phase as a
+ * convenience label only. The deprecated `readiness-change` DOM
+ * event that used to surface this directly was removed in the broad
+ * architecture review compat sweep alongside its
+ * `legacy-event-bridge`.
+ */
+export type EngineReadinessPhase = "bootstrapping" | "interaction-ready" | "loading" | "ready" | "error";
+export type EngineReadinessSignals = {
+    sectionReady: boolean;
+    interactionReady: boolean;
+    allLoadingComplete: boolean;
+    runtimeError: boolean;
+};
+export type EngineReadinessDetail = {
+    phase: EngineReadinessPhase;
+    interactionReady: boolean;
+    allLoadingComplete: boolean;
+    reason?: string;
+};
+export declare function resolveReadinessPhase(signals: EngineReadinessSignals): EngineReadinessPhase;
+export declare function createReadinessDetail(args: {
+    mode: "progressive" | "strict";
+    signals: EngineReadinessSignals;
+    reason?: string;
+}): EngineReadinessDetail;
+//# sourceMappingURL=engine-readiness.d.ts.map

package/dist/runtime/core/engine-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-readiness.d.ts","sourceRoot":"","sources":["../../../src/runtime/core/engine-readiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;GASG;AACH,MAAM,MAAM,oBAAoB,GAC7B,eAAe,GACf,mBAAmB,GACnB,SAAS,GACT,OAAO,GACP,OAAO,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG;IACpC,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IACnC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,sBAAsB,GAC7B,oBAAoB,CAMtB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC3C,IAAI,EAAE,aAAa,GAAG,QAAQ,CAAC;IAC/B,OAAO,EAAE,sBAAsB,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,qBAAqB,CAiBxB"}

package/dist/runtime/core/engine-readiness.js

@@ -0,0 +1,47 @@
+/**
+ * Readiness derivation for the section runtime engine (M7).
+ *
+ * Canonical home of `createReadinessDetail` and `resolveReadinessPhase`.
+ * As of M7 PR 7 the previous duplicates in
+ * `packages/section-player/src/components/shared/section-player-readiness.ts`
+ * have been deleted; section-player now consumes these helpers via
+ * `@pie-players/pie-assessment-toolkit/runtime/internal`.
+ *
+ * Type duplication note: the public DOM-event detail aliases
+ * (`SectionPlayerReadinessChangeDetail` /
+ * `SectionPlayerReadinessPhase`) still live in section-player's
+ * `contracts/public-events.ts` because that file is part of section-
+ * player's published custom-element contract. The toolkit core defines
+ * `EngineReadinessPhase` independently so it has zero section-player
+ * imports. The two definitions must stay structurally identical;
+ * that invariant is covered by the readiness assertions in this
+ * package's tests, which mirror the section-player suite.
+ */
+export function resolveReadinessPhase(signals) {
+    if (signals.runtimeError)
+        return "error";
+    if (signals.allLoadingComplete)
+        return "ready";
+    if (signals.interactionReady)
+        return "interaction-ready";
+    if (signals.sectionReady)
+        return "loading";
+    return "bootstrapping";
+}
+export function createReadinessDetail(args) {
+    // Final ready must always be gated by section lifecycle and complete loading.
+    const finalReady = args.signals.sectionReady && args.signals.allLoadingComplete;
+    const interactionReady = args.mode === "strict" ? finalReady : args.signals.interactionReady;
+    const phase = resolveReadinessPhase({
+        ...args.signals,
+        allLoadingComplete: finalReady,
+        interactionReady,
+    });
+    return {
+        phase,
+        interactionReady,
+        allLoadingComplete: finalReady,
+        reason: args.reason,
+    };
+}
+//# sourceMappingURL=engine-readiness.js.map

package/dist/runtime/core/engine-readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-readiness.js","sourceRoot":"","sources":["../../../src/runtime/core/engine-readiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAiCH,MAAM,UAAU,qBAAqB,CACpC,OAA+B;IAE/B,IAAI,OAAO,CAAC,YAAY;QAAE,OAAO,OAAO,CAAC;IACzC,IAAI,OAAO,CAAC,kBAAkB;QAAE,OAAO,OAAO,CAAC;IAC/C,IAAI,OAAO,CAAC,gBAAgB;QAAE,OAAO,mBAAmB,CAAC;IACzD,IAAI,OAAO,CAAC,YAAY;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,eAAe,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAIrC;IACA,8EAA8E;IAC9E,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC;IAChF,MAAM,gBAAgB,GACrB,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACrE,MAAM,KAAK,GAAG,qBAAqB,CAAC;QACnC,GAAG,IAAI,CAAC,OAAO;QACf,kBAAkB,EAAE,UAAU;QAC9B,gBAAgB;KAChB,CAAC,CAAC;IAEH,OAAO;QACN,KAAK;QACL,gBAAgB;QAChB,kBAAkB,EAAE,UAAU;QAC9B,MAAM,EAAE,IAAI,CAAC,MAAM;KACnB,CAAC;AACH,CAAC"}

package/dist/runtime/core/engine-resolver.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Section runtime engine resolver (M7).
+ *
+ * Canonical home of `resolveRuntime`, `resolveToolsConfig`, and their
+ * supporting helpers/types. As of M7 PR 7 the previous duplicates in
+ * `packages/section-player/src/components/shared/section-player-runtime.ts`
+ * have been deleted; section-player now consumes these helpers via
+ * `@pie-players/pie-assessment-toolkit/runtime/internal`.
+ *
+ * What is NOT absorbed in this module:
+ * - `resolvePlayerRuntime` stays in section-player because it depends on
+ *   `DEFAULT_PLAYER_DEFINITIONS` (which side-effect-imports the
+ *   item-player package). The toolkit core stays free of that
+ *   dependency by exposing a parametrized orchestrator —
+ *   `resolveSectionEngineRuntimeState` — that takes a `resolvePlayerRuntime`
+ *   callable. The section-player wrapper
+ *   (`resolveSectionPlayerRuntimeState` in
+ *   `packages/section-player/src/components/shared/section-player-host-runtime.ts`)
+ *   hands its local implementation in.
+ *
+ * The strict mirror rule (M5) and the `runtime.<key>` precedence rule
+ * are preserved bit-for-bit; the per-key precedence test in
+ * `engine-resolver.test.ts` is the guardrail.
+ */
+import type { LoaderConfig } from "@pie-players/pie-players-shared/loader-config";
+import type { LoadingCompleteDetail, StageChangeDetail } from "@pie-players/pie-players-shared/pie";
+import type { FrameworkErrorModel } from "../../services/framework-error.js";
+import type { ToolConfigStrictness } from "../../services/tool-config-validation.js";
+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 PlayerOverrides = {
+    loaderConfig?: LoaderConfig;
+    loaderOptions?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+export type FrameworkErrorHandler = (model: FrameworkErrorModel) => void;
+export type StageChangeHandler = (detail: StageChangeDetail) => void;
+export type LoadingCompleteHandler = (detail: LoadingCompleteDetail) => void;
+/**
+ * Two-tier section runtime config (M5 strict mirror, post-trim).
+ *
+ * Mirror rule: `kebab-attribute ↔ camelCaseProp ↔ runtime.<sameCamelCaseKey>`.
+ * `runtime.<key>` always wins over the equivalent prop/attribute.
+ *
+ * Documented exceptions (no runtime mirror, by design): identity
+ * (`section-id`, `attempt-id`, `section`); layout-only shell knobs
+ * (`show-toolbar`, `toolbar-position`, etc.); and layout-shell host
+ * data (`policies`, `hooks`, `toolRegistry`, `*HostButtons`). Those
+ * surfaces are layout-shell concerns; the runtime engine does not see
+ * them. See section-player's ARCHITECTURE.md for the full policy.
+ */
+export type RuntimeConfig = {
+    assessmentId?: string;
+    playerType?: string;
+    player?: PlayerOverrides | null;
+    lazyInit?: boolean;
+    tools?: Record<string, unknown> | null;
+    accessibility?: Record<string, unknown> | null;
+    coordinator?: unknown;
+    createSectionController?: unknown;
+    isolation?: string;
+    env?: Record<string, unknown>;
+    toolConfigStrictness?: ToolConfigStrictness;
+    onFrameworkError?: FrameworkErrorHandler;
+    enabledTools?: string;
+    onStageChange?: StageChangeHandler;
+    onLoadingComplete?: LoadingCompleteHandler;
+};
+export type RuntimeInputs = {
+    assessmentId?: string;
+    playerType?: string;
+    player?: PlayerOverrides | null;
+    lazyInit?: boolean;
+    tools?: Record<string, unknown> | null;
+    accessibility?: Record<string, unknown> | null;
+    coordinator?: unknown;
+    env?: Record<string, unknown> | null;
+    toolConfigStrictness?: ToolConfigStrictness;
+    onFrameworkError?: FrameworkErrorHandler;
+    onStageChange?: StageChangeHandler;
+    onLoadingComplete?: LoadingCompleteHandler;
+    runtime: RuntimeConfig | null;
+    enabledTools: string;
+};
+/**
+ * Resolve the canonical `onFrameworkError` handler from the two-tier
+ * surface. Precedence (highest first): `runtime.onFrameworkError`,
+ * then top-level `onFrameworkError`. Layout CEs and the kernel call
+ * this so every entry point converges on the same handler.
+ */
+export declare function resolveOnFrameworkError(args: {
+    runtime: RuntimeConfig | null;
+    onFrameworkError?: FrameworkErrorHandler;
+}): FrameworkErrorHandler | undefined;
+export declare function resolveToolsConfig(args: {
+    runtime: RuntimeConfig | null;
+    tools: Record<string, unknown> | null;
+    enabledTools: string;
+}): {
+    placement: {
+        section?: string[] | undefined;
+    };
+};
+export declare function resolveRuntime(args: {
+    assessmentId: string;
+    playerType: string;
+    player: PlayerOverrides | null;
+    lazyInit: boolean;
+    accessibility: Record<string, unknown> | null;
+    coordinator: unknown;
+    env: Record<string, unknown> | null;
+    runtime: RuntimeConfig | null;
+    effectiveToolsConfig: unknown;
+    toolConfigStrictness?: ToolConfigStrictness;
+    onFrameworkError?: FrameworkErrorHandler;
+    onStageChange?: StageChangeHandler;
+    onLoadingComplete?: LoadingCompleteHandler;
+}): {
+    assessmentId: string | undefined;
+    playerType: string | undefined;
+    player: {
+        loaderOptions: {
+            [x: string]: unknown;
+        };
+        loaderConfig: {
+            [x: string]: unknown;
+        };
+    } | null;
+    lazyInit: boolean | undefined;
+    accessibility: Record<string, unknown> | null | undefined;
+    coordinator: unknown;
+    createSectionController: unknown;
+    isolation: string;
+    env: Record<string, unknown>;
+    toolConfigStrictness: "off" | "error" | "warn";
+    onFrameworkError: FrameworkErrorHandler | undefined;
+    onStageChange: StageChangeHandler | undefined;
+    onLoadingComplete: LoadingCompleteHandler | undefined;
+    tools: unknown;
+    enabledTools?: string;
+};
+/**
+ * Effective runtime returned by `resolveRuntime`. The shape is exposed
+ * as `unknown` at the public boundary because consumers spread it into
+ * arbitrary host props; downstream call sites narrow with the specific
+ * keys they need.
+ */
+export type EffectiveRuntime = ReturnType<typeof resolveRuntime>;
+/**
+ * Engine-side orchestrator that mirrors the legacy
+ * `resolveSectionPlayerRuntimeState` from section-player but takes
+ * `resolvePlayerRuntime` as an injected callable so the toolkit core
+ * stays free of host-coupled defaults (`DEFAULT_PLAYER_DEFINITIONS`).
+ *
+ * The legacy section-player wrapper passes its local `resolvePlayerRuntime`
+ * here in M7 PR 5 when the kernel switches onto the engine.
+ */
+export declare function resolveSectionEngineRuntimeState<P>(args: RuntimeInputs, deps: {
+    resolvePlayerRuntime: (resolverArgs: {
+        effectiveRuntime: Record<string, unknown>;
+        playerType: string;
+        env: Record<string, unknown> | null;
+    }) => P;
+}): {
+    effectiveToolsConfig: unknown;
+    effectiveRuntime: EffectiveRuntime;
+    playerRuntime: P;
+};
+//# sourceMappingURL=engine-resolver.d.ts.map

package/dist/runtime/core/engine-resolver.d.ts.map

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

package/dist/runtime/core/engine-resolver.js

@@ -0,0 +1,170 @@
+/**
+ * Section runtime engine resolver (M7).
+ *
+ * Canonical home of `resolveRuntime`, `resolveToolsConfig`, and their
+ * supporting helpers/types. As of M7 PR 7 the previous duplicates in
+ * `packages/section-player/src/components/shared/section-player-runtime.ts`
+ * have been deleted; section-player now consumes these helpers via
+ * `@pie-players/pie-assessment-toolkit/runtime/internal`.
+ *
+ * What is NOT absorbed in this module:
+ * - `resolvePlayerRuntime` stays in section-player because it depends on
+ *   `DEFAULT_PLAYER_DEFINITIONS` (which side-effect-imports the
+ *   item-player package). The toolkit core stays free of that
+ *   dependency by exposing a parametrized orchestrator —
+ *   `resolveSectionEngineRuntimeState` — that takes a `resolvePlayerRuntime`
+ *   callable. The section-player wrapper
+ *   (`resolveSectionPlayerRuntimeState` in
+ *   `packages/section-player/src/components/shared/section-player-host-runtime.ts`)
+ *   hands its local implementation in.
+ *
+ * The strict mirror rule (M5) and the `runtime.<key>` precedence rule
+ * are preserved bit-for-bit; the per-key precedence test in
+ * `engine-resolver.test.ts` is the guardrail.
+ */
+import { parseToolList } from "../../services/tools-config-normalizer.js";
+export const DEFAULT_ASSESSMENT_ID = "section-demo-direct";
+export const DEFAULT_PLAYER_TYPE = "iife";
+export const DEFAULT_LAZY_INIT = true;
+export const DEFAULT_ISOLATION = "inherit";
+export const DEFAULT_ENV = { mode: "gather", role: "student" };
+/**
+ * Pick the runtime-tier value when defined, otherwise the prop/attribute
+ * value. The strict mirror rule means every tier-1 surface is resolved
+ * with this single helper; per-feature special-casing is forbidden.
+ */
+function pick(runtimeVal, attrVal) {
+    return runtimeVal !== undefined ? runtimeVal : attrVal;
+}
+/**
+ * Resolve the canonical `onFrameworkError` handler from the two-tier
+ * surface. Precedence (highest first): `runtime.onFrameworkError`,
+ * then top-level `onFrameworkError`. Layout CEs and the kernel call
+ * this so every entry point converges on the same handler.
+ */
+export function resolveOnFrameworkError(args) {
+    const r = args.runtime ?? {};
+    if (r.onFrameworkError !== undefined)
+        return r.onFrameworkError;
+    return args.onFrameworkError;
+}
+export function resolveToolsConfig(args) {
+    const runtimeTools = (args.runtime?.tools || args.tools || {});
+    // `runtime.enabledTools` is the canonical mirror; the kebab attribute is
+    // the easy-tier alias. Per Decision B1, it merges into
+    // `tools.placement.section`. The object form (`runtime.tools`) keeps
+    // precedence over both — that lock lives in the merge below.
+    //
+    // The deprecated `item-toolbar-tools` / `passage-toolbar-tools`
+    // per-region aliases were removed in the broad architecture review
+    // compat sweep; hosts must populate `tools.placement.item` /
+    // `tools.placement.passage` (object form) or
+    // `runtime.tools.placement.{item,passage}` directly.
+    const effectiveEnabledTools = pick(args.runtime?.enabledTools, args.enabledTools) ?? "";
+    const sectionTools = parseToolList(effectiveEnabledTools);
+    const placement = (runtimeTools.placement || {});
+    const overlayToolsConfig = {
+        ...runtimeTools,
+        placement: {
+            ...placement,
+            ...(sectionTools.length > 0 ? { section: sectionTools } : {}),
+        },
+    };
+    // Keep host-provided shape intact; framework-owned validation surfaces malformed config.
+    return overlayToolsConfig;
+}
+export function resolveRuntime(args) {
+    const r = args.runtime || {};
+    const topLevelPlayer = (args.player || {});
+    const runtimePlayer = (r.player || {});
+    const mergedPlayerCandidate = {
+        ...topLevelPlayer,
+        ...runtimePlayer,
+        loaderOptions: {
+            ...(topLevelPlayer.loaderOptions || {}),
+            ...(runtimePlayer.loaderOptions || {}),
+        },
+        loaderConfig: {
+            ...(topLevelPlayer.loaderConfig || {}),
+            ...(runtimePlayer.loaderConfig || {}),
+        },
+    };
+    const mergedPlayer = Object.keys(mergedPlayerCandidate).length > 0 ? mergedPlayerCandidate : null;
+    return {
+        ...r,
+        assessmentId: pick(r.assessmentId, args.assessmentId),
+        playerType: pick(r.playerType, args.playerType),
+        player: mergedPlayer,
+        lazyInit: pick(r.lazyInit, args.lazyInit),
+        accessibility: pick(r.accessibility, args.accessibility),
+        coordinator: pick(r.coordinator, args.coordinator),
+        createSectionController: r.createSectionController,
+        isolation: r.isolation ?? DEFAULT_ISOLATION,
+        env: pick(r.env, args.env) ?? DEFAULT_ENV,
+        toolConfigStrictness: pick(r.toolConfigStrictness, args.toolConfigStrictness) ?? "error",
+        // M3 mirror absorbed via the shared helper so every layout CE wires
+        // `onFrameworkError` identically.
+        onFrameworkError: resolveOnFrameworkError({
+            runtime: args.runtime,
+            onFrameworkError: args.onFrameworkError,
+        }),
+        // M6 mirror — `onStageChange` follows the same precedence as every
+        // other tier-1 surface: `runtime.onStageChange` wins over the
+        // top-level prop.
+        onStageChange: pick(r.onStageChange, args.onStageChange),
+        // M6 mirror — `onLoadingComplete` follows the same precedence
+        // rule.
+        onLoadingComplete: pick(r.onLoadingComplete, args.onLoadingComplete),
+        tools: args.effectiveToolsConfig,
+    };
+}
+/**
+ * Engine-side orchestrator that mirrors the legacy
+ * `resolveSectionPlayerRuntimeState` from section-player but takes
+ * `resolvePlayerRuntime` as an injected callable so the toolkit core
+ * stays free of host-coupled defaults (`DEFAULT_PLAYER_DEFINITIONS`).
+ *
+ * The legacy section-player wrapper passes its local `resolvePlayerRuntime`
+ * here in M7 PR 5 when the kernel switches onto the engine.
+ */
+export function resolveSectionEngineRuntimeState(args, deps) {
+    const assessmentId = args.assessmentId ?? DEFAULT_ASSESSMENT_ID;
+    const playerType = args.playerType ?? DEFAULT_PLAYER_TYPE;
+    const player = args.player ?? null;
+    const lazyInit = args.lazyInit ?? DEFAULT_LAZY_INIT;
+    const accessibility = args.accessibility ?? null;
+    const coordinator = args.coordinator ?? null;
+    const env = args.env ?? null;
+    const tools = args.tools ?? null;
+    const effectiveToolsConfig = resolveToolsConfig({
+        runtime: args.runtime,
+        tools,
+        enabledTools: args.enabledTools,
+    });
+    const effectiveRuntime = resolveRuntime({
+        assessmentId,
+        playerType,
+        player,
+        lazyInit,
+        accessibility,
+        coordinator,
+        env,
+        runtime: args.runtime,
+        effectiveToolsConfig,
+        toolConfigStrictness: args.toolConfigStrictness,
+        onFrameworkError: args.onFrameworkError,
+        onStageChange: args.onStageChange,
+        onLoadingComplete: args.onLoadingComplete,
+    });
+    const playerRuntime = deps.resolvePlayerRuntime({
+        effectiveRuntime: effectiveRuntime,
+        playerType,
+        env,
+    });
+    return {
+        effectiveToolsConfig,
+        effectiveRuntime,
+        playerRuntime,
+    };
+}
+//# sourceMappingURL=engine-resolver.js.map

package/dist/runtime/core/engine-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-resolver.js","sourceRoot":"","sources":["../../../src/runtime/core/engine-resolver.ts"],"names":[],"mappings":"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"}

package/dist/runtime/core/engine-stage-derivation.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Stage derivation for the section runtime engine (M7).
+ *
+ * Maps the FSM phase onto the canonical M6 stage vocabulary
+ * (`composed`, `engine-ready`, `interactive`, `disposed`). The phase
+ * `idle` is the engine's "no cohort yet" state and has no stage; it
+ * returns `null`.
+ *
+ * This module exists as a one-line indirection because:
+ *   - The adapter uses it to guard `pie-stage-change` emit calls.
+ *   - The transition uses it (via the pure helper below) to decide
+ *     when to emit `stage-change` outputs as the phase advances.
+ *   - Future shape-specific stages (e.g. layout-only `paginated`) can
+ *     be wired in here without rewriting callers.
+ */
+import type { Stage } from "@pie-players/pie-players-shared/pie";
+import type { SectionEnginePhase } from "./engine-state.js";
+export declare function phaseToStage(phase: SectionEnginePhase): Stage | null;
+//# sourceMappingURL=engine-stage-derivation.d.ts.map

package/dist/runtime/core/engine-stage-derivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-stage-derivation.d.ts","sourceRoot":"","sources":["../../../src/runtime/core/engine-stage-derivation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,wBAAgB,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,KAAK,GAAG,IAAI,CAapE"}

package/dist/runtime/core/engine-stage-derivation.js

@@ -0,0 +1,30 @@
+/**
+ * Stage derivation for the section runtime engine (M7).
+ *
+ * Maps the FSM phase onto the canonical M6 stage vocabulary
+ * (`composed`, `engine-ready`, `interactive`, `disposed`). The phase
+ * `idle` is the engine's "no cohort yet" state and has no stage; it
+ * returns `null`.
+ *
+ * This module exists as a one-line indirection because:
+ *   - The adapter uses it to guard `pie-stage-change` emit calls.
+ *   - The transition uses it (via the pure helper below) to decide
+ *     when to emit `stage-change` outputs as the phase advances.
+ *   - Future shape-specific stages (e.g. layout-only `paginated`) can
+ *     be wired in here without rewriting callers.
+ */
+export function phaseToStage(phase) {
+    switch (phase) {
+        case "idle":
+            return null;
+        case "booting-section":
+            return "composed";
+        case "engine-ready":
+            return "engine-ready";
+        case "interactive":
+            return "interactive";
+        case "disposed":
+            return "disposed";
+    }
+}
+//# sourceMappingURL=engine-stage-derivation.js.map

package/dist/runtime/core/engine-stage-derivation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-stage-derivation.js","sourceRoot":"","sources":["../../../src/runtime/core/engine-stage-derivation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,UAAU,YAAY,CAAC,KAAyB;IACrD,QAAQ,KAAK,EAAE,CAAC;QACf,KAAK,MAAM;YACV,OAAO,IAAI,CAAC;QACb,KAAK,iBAAiB;YACrB,OAAO,UAAU,CAAC;QACnB,KAAK,cAAc;YAClB,OAAO,cAAc,CAAC;QACvB,KAAK,aAAa;YACjB,OAAO,aAAa,CAAC;QACtB,KAAK,UAAU;YACd,OAAO,UAAU,CAAC;IACpB,CAAC;AACF,CAAC"}