@pie-players/pie-assessment-toolkit 0.3.43 → 0.3.45

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

@@ -18,11 +18,9 @@
  *   `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.
+ * Runtime-owned configuration flows through `runtime.<key>`. Layout-only
+ * inputs stay on the section-player host elements.
  */
-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;
@@ -49,108 +47,53 @@ export function resolveOnFrameworkError(args) {
     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 runtimeTools = (args.runtime?.tools || {});
     const placement = (runtimeTools.placement || {});
-    const overlayToolsConfig = {
-        ...runtimeTools,
-        placement: {
-            ...placement,
-            ...(sectionTools.length > 0 ? { section: sectionTools } : {}),
-        },
-    };
+    const overlayToolsConfig = { ...runtimeTools, placement: { ...placement } };
     // 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;
+    const runtimePlayer = r.player ? { ...r.player } : 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),
+        playerType: r.playerType ?? DEFAULT_PLAYER_TYPE,
+        player: runtimePlayer,
+        lazyInit: r.lazyInit ?? DEFAULT_LAZY_INIT,
+        accessibility: r.accessibility ?? null,
+        coordinator: r.coordinator ?? null,
         createSectionController: r.createSectionController,
         isolation: r.isolation ?? DEFAULT_ISOLATION,
-        env: pick(r.env, args.env) ?? DEFAULT_ENV,
+        env: r.env ?? DEFAULT_ENV,
         toolConfigStrictness: pick(r.toolConfigStrictness, args.toolConfigStrictness) ?? "error",
-        // M3 mirror absorbed via the shared helper so every layout CE wires
-        // `onFrameworkError` identically.
+        // Runtime callback wins; top-level callback remains a layout CE event
+        // convenience for hosts that do not use DOM listeners.
         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.
+        // Runtime callback wins over the top-level callback prop.
         onStageChange: pick(r.onStageChange, args.onStageChange),
-        // M6 mirror — `onLoadingComplete` follows the same precedence
-        // rule.
+        // Runtime callback wins over the top-level callback prop.
         onLoadingComplete: pick(r.onLoadingComplete, args.onLoadingComplete),
         tools: args.effectiveToolsConfig,
     };
 }
 /**
- * Engine-side orchestrator that mirrors the legacy
- * `resolveSectionPlayerRuntimeState` from section-player but takes
+ * Engine-side orchestrator that powers `resolveSectionPlayerRuntimeState`
+ * from section-player and 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,
@@ -160,8 +103,8 @@ export function resolveSectionEngineRuntimeState(args, deps) {
     });
     const playerRuntime = deps.resolvePlayerRuntime({
         effectiveRuntime: effectiveRuntime,
-        playerType,
-        env,
+        playerType: String(effectiveRuntime.playerType ?? DEFAULT_PLAYER_TYPE),
+        env: effectiveRuntime.env ?? null,
     });
     return {
         effectiveToolsConfig,

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

@@ -1 +1 @@
-{"version":3,"file":"engine-resolver.js","sourceRoot":"","sources":["../../../src/runtime/core/engine-resolver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"engine-resolver.js","sourceRoot":"","sources":["../../../src/runtime/core/engine-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Section runtime engine resolver (M7).\n *\n * Canonical home of `resolveRuntime`, `resolveToolsConfig`, and their\n * supporting helpers/types. As of M7 PR 7 the previous duplicates in\n * `packages/section-player/src/components/shared/section-player-runtime.ts`\n * have been deleted; section-player now consumes these helpers via\n * `@pie-players/pie-assessment-toolkit/runtime/internal`.\n *\n * What is NOT absorbed in this module:\n * - `resolvePlayerRuntime` stays in section-player because it depends on\n *   `DEFAULT_PLAYER_DEFINITIONS` (which side-effect-imports the\n *   item-player package). The toolkit core stays free of that\n *   dependency by exposing a parametrized orchestrator —\n *   `resolveSectionEngineRuntimeState` — that takes a `resolvePlayerRuntime`\n *   callable. The section-player wrapper\n *   (`resolveSectionPlayerRuntimeState` in\n *   `packages/section-player/src/components/shared/section-player-host-runtime.ts`)\n *   hands its local implementation in.\n *\n * Runtime-owned configuration flows through `runtime.<key>`. Layout-only\n * inputs stay on the section-player host elements.\n */\n\nimport type { LoaderConfig } from \"@pie-players/pie-players-shared/loader-config\";\nimport type {\n\tLoadingCompleteDetail,\n\tStageChangeDetail,\n} from \"@pie-players/pie-players-shared/pie\";\nimport type { FrameworkErrorModel } from \"../../services/framework-error.js\";\nimport type { ToolConfigStrictness } from \"../../services/tool-config-validation.js\";\n\nexport const DEFAULT_ASSESSMENT_ID = \"section-demo-direct\";\nexport const DEFAULT_PLAYER_TYPE = \"iife\";\nexport const DEFAULT_LAZY_INIT = true;\nexport const DEFAULT_ISOLATION = \"inherit\";\nexport const DEFAULT_ENV = { mode: \"gather\", role: \"student\" } as Record<\n\tstring,\n\tunknown\n>;\n\nexport type PlayerOverrides = {\n\tloaderConfig?: LoaderConfig;\n\tloaderOptions?: Record<string, unknown>;\n\t[key: string]: unknown;\n};\n\nexport type FrameworkErrorHandler = (model: FrameworkErrorModel) => void;\nexport type StageChangeHandler = (detail: StageChangeDetail) => void;\nexport type LoadingCompleteHandler = (detail: LoadingCompleteDetail) => void;\n\n/**\n * Section runtime config.\n *\n * Documented exceptions (no runtime mirror, by design): identity\n * (`section-id`, `attempt-id`, `section`); layout-only shell knobs\n * (`show-toolbar`, `toolbar-position`, etc.); and layout-shell host\n * data (`policies`, `hooks`, `toolRegistry`, `*HostButtons`). Those\n * surfaces are layout-shell concerns; the runtime engine does not see\n * them. See section-player's ARCHITECTURE.md for the full policy.\n */\nexport type RuntimeConfig = {\n\tassessmentId?: string;\n\tplayerType?: string;\n\tplayer?: PlayerOverrides | null;\n\tlazyInit?: boolean;\n\ttools?: Record<string, unknown> | null;\n\ttoolContextResolvers?: Record<string, unknown> | null;\n\taccessibility?: Record<string, unknown> | null;\n\tcoordinator?: unknown;\n\tcreateSectionController?: unknown;\n\tisolation?: string;\n\tenv?: Record<string, unknown>;\n\ttoolConfigStrictness?: ToolConfigStrictness;\n\n\t// Canonical framework-error callback.\n\tonFrameworkError?: FrameworkErrorHandler;\n\n\t// Canonical stage-change callback. The DOM event\n\t// `pie-stage-change` remains the primary channel; this callback is\n\t// the convenience surface that mirrors the event one-to-one.\n\tonStageChange?: StageChangeHandler;\n\n\t// Canonical loading-complete callback. Mirrors the\n\t// `pie-loading-complete` DOM event, which the engine dispatches\n\t// once per cohort when every item has finished loading.\n\tonLoadingComplete?: LoadingCompleteHandler;\n};\n\nexport type RuntimeInputs = {\n\tassessmentId?: string;\n\ttoolConfigStrictness?: ToolConfigStrictness;\n\tonFrameworkError?: FrameworkErrorHandler;\n\tonStageChange?: StageChangeHandler;\n\tonLoadingComplete?: LoadingCompleteHandler;\n\truntime: RuntimeConfig | null;\n};\n\n/**\n * Pick the runtime-tier value when defined, otherwise the prop/attribute\n * value. The strict mirror rule means every tier-1 surface is resolved\n * with this single helper; per-feature special-casing is forbidden.\n */\nfunction pick<T>(\n\truntimeVal: T | undefined,\n\tattrVal: T | undefined,\n): T | undefined {\n\treturn runtimeVal !== undefined ? runtimeVal : attrVal;\n}\n\n/**\n * Resolve the canonical `onFrameworkError` handler from the two-tier\n * surface. Precedence (highest first): `runtime.onFrameworkError`,\n * then top-level `onFrameworkError`. Layout CEs and the kernel call\n * this so every entry point converges on the same handler.\n */\nexport function resolveOnFrameworkError(args: {\n\truntime: RuntimeConfig | null;\n\tonFrameworkError?: FrameworkErrorHandler;\n}): FrameworkErrorHandler | undefined {\n\tconst r = args.runtime ?? {};\n\tif (r.onFrameworkError !== undefined) return r.onFrameworkError;\n\treturn args.onFrameworkError;\n}\n\nexport function resolveToolsConfig(args: {\n\truntime: RuntimeConfig | null;\n}) {\n\tconst runtimeTools = (args.runtime?.tools || {}) as Record<string, unknown>;\n\tconst placement = (runtimeTools.placement || {}) as Record<string, unknown>;\n\tconst overlayToolsConfig = { ...runtimeTools, placement: { ...placement } };\n\t// Keep host-provided shape intact; framework-owned validation surfaces malformed config.\n\treturn overlayToolsConfig;\n}\n\nexport function resolveRuntime(args: {\n\tassessmentId: string;\n\truntime: RuntimeConfig | null;\n\teffectiveToolsConfig: unknown;\n\ttoolConfigStrictness?: ToolConfigStrictness;\n\tonFrameworkError?: FrameworkErrorHandler;\n\tonStageChange?: StageChangeHandler;\n\tonLoadingComplete?: LoadingCompleteHandler;\n}) {\n\tconst r = args.runtime || {};\n\tconst runtimePlayer = r.player ? { ...r.player } : null;\n\treturn {\n\t\t...r,\n\t\tassessmentId: pick(r.assessmentId, args.assessmentId),\n\t\tplayerType: r.playerType ?? DEFAULT_PLAYER_TYPE,\n\t\tplayer: runtimePlayer,\n\t\tlazyInit: r.lazyInit ?? DEFAULT_LAZY_INIT,\n\t\taccessibility: r.accessibility ?? null,\n\t\tcoordinator: r.coordinator ?? null,\n\t\tcreateSectionController: r.createSectionController,\n\t\tisolation: r.isolation ?? DEFAULT_ISOLATION,\n\t\tenv: r.env ?? DEFAULT_ENV,\n\t\ttoolConfigStrictness:\n\t\t\tpick(r.toolConfigStrictness, args.toolConfigStrictness) ?? \"error\",\n\n\t\t// Runtime callback wins; top-level callback remains a layout CE event\n\t\t// convenience for hosts that do not use DOM listeners.\n\t\tonFrameworkError: resolveOnFrameworkError({\n\t\t\truntime: args.runtime,\n\t\t\tonFrameworkError: args.onFrameworkError,\n\t\t}),\n\n\t\t// Runtime callback wins over the top-level callback prop.\n\t\tonStageChange: pick(r.onStageChange, args.onStageChange),\n\n\t\t// Runtime callback wins over the top-level callback prop.\n\t\tonLoadingComplete: pick(r.onLoadingComplete, args.onLoadingComplete),\n\n\t\ttools: args.effectiveToolsConfig,\n\t};\n}\n\n/**\n * Effective runtime returned by `resolveRuntime`. The shape is exposed\n * as `unknown` at the public boundary because consumers spread it into\n * arbitrary host props; downstream call sites narrow with the specific\n * keys they need.\n */\nexport type EffectiveRuntime = ReturnType<typeof resolveRuntime>;\n\n/**\n * Engine-side orchestrator that powers `resolveSectionPlayerRuntimeState`\n * from section-player and takes\n * `resolvePlayerRuntime` as an injected callable so the toolkit core\n * stays free of host-coupled defaults (`DEFAULT_PLAYER_DEFINITIONS`).\n */\nexport function resolveSectionEngineRuntimeState<P>(\n\targs: RuntimeInputs,\n\tdeps: {\n\t\tresolvePlayerRuntime: (resolverArgs: {\n\t\t\teffectiveRuntime: Record<string, unknown>;\n\t\t\tplayerType: string;\n\t\t\tenv: Record<string, unknown> | null;\n\t\t}) => P;\n\t},\n): {\n\teffectiveToolsConfig: unknown;\n\teffectiveRuntime: EffectiveRuntime;\n\tplayerRuntime: P;\n} {\n\tconst assessmentId = args.assessmentId ?? DEFAULT_ASSESSMENT_ID;\n\n\tconst effectiveToolsConfig = resolveToolsConfig({\n\t\truntime: args.runtime,\n\t});\n\tconst effectiveRuntime = resolveRuntime({\n\t\tassessmentId,\n\t\truntime: args.runtime,\n\t\teffectiveToolsConfig,\n\t\ttoolConfigStrictness: args.toolConfigStrictness,\n\t\tonFrameworkError: args.onFrameworkError,\n\t\tonStageChange: args.onStageChange,\n\t\tonLoadingComplete: args.onLoadingComplete,\n\t});\n\tconst playerRuntime = deps.resolvePlayerRuntime({\n\t\teffectiveRuntime: effectiveRuntime as Record<string, unknown>,\n\t\tplayerType: String(effectiveRuntime.playerType ?? DEFAULT_PLAYER_TYPE),\n\t\tenv: (effectiveRuntime.env as Record<string, unknown> | null) ?? null,\n\t});\n\treturn {\n\t\teffectiveToolsConfig,\n\t\teffectiveRuntime,\n\t\tplayerRuntime,\n\t};\n}\n"]}

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

@@ -16,4 +16,3 @@
 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.js.map

@@ -1 +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"}
+{"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","sourcesContent":["/**\n * Stage derivation for the section runtime engine (M7).\n *\n * Maps the FSM phase onto the canonical M6 stage vocabulary\n * (`composed`, `engine-ready`, `interactive`, `disposed`). The phase\n * `idle` is the engine's \"no cohort yet\" state and has no stage; it\n * returns `null`.\n *\n * This module exists as a one-line indirection because:\n *   - The adapter uses it to guard `pie-stage-change` emit calls.\n *   - The transition uses it (via the pure helper below) to decide\n *     when to emit `stage-change` outputs as the phase advances.\n *   - Future shape-specific stages (e.g. layout-only `paginated`) can\n *     be wired in here without rewriting callers.\n */\n\nimport type { Stage } from \"@pie-players/pie-players-shared/pie\";\nimport type { SectionEnginePhase } from \"./engine-state.js\";\n\nexport function phaseToStage(phase: SectionEnginePhase): Stage | null {\n\tswitch (phase) {\n\t\tcase \"idle\":\n\t\t\treturn null;\n\t\tcase \"booting-section\":\n\t\t\treturn \"composed\";\n\t\tcase \"engine-ready\":\n\t\t\treturn \"engine-ready\";\n\t\tcase \"interactive\":\n\t\t\treturn \"interactive\";\n\t\tcase \"disposed\":\n\t\t\treturn \"disposed\";\n\t}\n}\n"]}

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

@@ -80,4 +80,3 @@ export type SectionEngineState = {
  * default by reference.
  */
 export declare function createInitialEngineState(): SectionEngineState;
-//# sourceMappingURL=engine-state.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"engine-state.js","sourceRoot":"","sources":["../../../src/runtime/core/engine-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAuEH;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACvC,OAAO;QACN,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,IAAI;QACZ,kBAAkB,EAAE,KAAK;QACzB,gBAAgB,EAAE;YACjB,YAAY,EAAE,KAAK;YACnB,gBAAgB,EAAE,KAAK;YACvB,kBAAkB,EAAE,KAAK;YACzB,YAAY,EAAE,KAAK;SACnB;QACD,gBAAgB,EAAE,IAAI;QACtB,oBAAoB,EAAE,IAAI;QAC1B,sBAAsB,EAAE,KAAK;QAC7B,kBAAkB,EAAE,IAAI;QACxB,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,CAAC;KACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"engine-state.js","sourceRoot":"","sources":["../../../src/runtime/core/engine-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAuEH;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACvC,OAAO;QACN,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,IAAI;QACZ,kBAAkB,EAAE,KAAK;QACzB,gBAAgB,EAAE;YACjB,YAAY,EAAE,KAAK;YACnB,gBAAgB,EAAE,KAAK;YACvB,kBAAkB,EAAE,KAAK;YACzB,YAAY,EAAE,KAAK;SACnB;QACD,gBAAgB,EAAE,IAAI;QACtB,oBAAoB,EAAE,IAAI;QAC1B,sBAAsB,EAAE,KAAK;QAC7B,kBAAkB,EAAE,IAAI;QACxB,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,CAAC;KACd,CAAC;AACH,CAAC","sourcesContent":["/**\n * Section runtime engine state (M7 — Variant C, layered core).\n *\n * The state object is the single source of truth for stage, cohort,\n * readiness signals, and the resolved coordinator/controller handles\n * across one engine instance. The transition function in\n * `engine-transition.ts` is the only legal mutator; the adapter (M7\n * PR 2) reads the state via `SectionEngineCore.getState()` and emits\n * the bundled `SectionEngineOutput[]` to its bridges.\n *\n * Phases (the FSM). Adjustment A2 of the M7 implementation plan locks\n * this list to four phases that map 1:1 onto the M6 canonical stages:\n *\n *   `idle`             → no cohort yet (before `initialize`).\n *   `booting-section`  → cohort known, controller resolution pending. Maps to stage `composed`.\n *   `engine-ready`     → controller resolved. Maps to stage `engine-ready`.\n *   `interactive`      → readiness gate satisfied. Maps to stage `interactive`.\n *   `disposed`         → engine torn down. Maps to stage `disposed`.\n *\n * `loading-complete` is intentionally **not** an FSM phase — it is a\n * `SectionEngineOutput` emitted from the `interactive` phase when the\n * readiness signals satisfy `allLoadingComplete`. See\n * `engine-output.ts` for the output shape and the implementation\n * plan's Adjustment A2 fence.\n */\n\nimport type { CohortKey } from \"./cohort.js\";\nimport type { EffectiveRuntime } from \"./engine-resolver.js\";\nimport type { EngineReadinessSignals } from \"./engine-readiness.js\";\nimport type { FrameworkErrorModel } from \"../../services/framework-error.js\";\n\nexport type SectionEnginePhase =\n\t| \"idle\"\n\t| \"booting-section\"\n\t| \"engine-ready\"\n\t| \"interactive\"\n\t| \"disposed\";\n\nexport type SectionEngineState = {\n\t/** Current FSM phase. The single source of truth for stage derivation. */\n\tphase: SectionEnginePhase;\n\n\t/**\n\t * Active cohort, or `null` when the engine is `idle` or `disposed`.\n\t * `phase === \"idle\"` always implies `cohort === null`. A non-idle,\n\t * non-disposed phase always has a cohort.\n\t */\n\tcohort: CohortKey | null;\n\n\t/**\n\t * Whether the host has reported the section controller is resolved.\n\t * Latched by the `section-controller-resolved` input; the\n\t * transition uses it (along with `phase >= booting-section`) to\n\t * advance into `engine-ready`.\n\t */\n\tcontrollerResolved: boolean;\n\n\t/**\n\t * Readiness signal snapshot. Updated by `update-readiness-signals`\n\t * inputs from the host (kernel) — the engine itself does not\n\t * compute these from scratch in PR 1. Strict-mode gating is\n\t * applied at derivation time via `createReadinessDetail`, not by\n\t * mutating the signals.\n\t */\n\treadinessSignals: EngineReadinessSignals;\n\n\t/** Last resolved effective runtime (output of `resolveRuntime`). */\n\teffectiveRuntime: EffectiveRuntime | null;\n\n\t/** Last resolved tools config. */\n\teffectiveToolsConfig: unknown;\n\n\t/**\n\t * `true` once the engine has emitted `loading-complete` for the\n\t * current cohort. Re-armed on cohort change. The single-shot\n\t * semantics of the canonical `pie-loading-complete` event are\n\t * preserved by gating emission on this flag in the transition.\n\t */\n\tloadingCompleteEmitted: boolean;\n\n\t/**\n\t * Most recent framework error, if any. The engine routes errors\n\t * through outputs, not through state — this field is kept so\n\t * subscribers asking for the latest snapshot (e.g. error banners)\n\t * can read it without replaying the output stream.\n\t */\n\tlastFrameworkError: FrameworkErrorModel | null;\n\n\t/** Number of items the host has registered for the current cohort. */\n\titemCount: number;\n\n\t/** Number of items reported as loaded. */\n\tloadedCount: number;\n};\n\n/**\n * Initial state. Kept as a function so callers cannot mutate a shared\n * default by reference.\n */\nexport function createInitialEngineState(): SectionEngineState {\n\treturn {\n\t\tphase: \"idle\",\n\t\tcohort: null,\n\t\tcontrollerResolved: false,\n\t\treadinessSignals: {\n\t\t\tsectionReady: false,\n\t\t\tinteractionReady: false,\n\t\t\tallLoadingComplete: false,\n\t\t\truntimeError: false,\n\t\t},\n\t\teffectiveRuntime: null,\n\t\teffectiveToolsConfig: null,\n\t\tloadingCompleteEmitted: false,\n\t\tlastFrameworkError: null,\n\t\titemCount: 0,\n\t\tloadedCount: 0,\n\t};\n}\n"]}

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

@@ -26,7 +26,7 @@
  *   3. `framework-error` outputs are independent of the stage chain
  *      and do not move the phase.
  *
- * The deprecated readiness output kinds (`readiness-change`,
+ * Readiness alias output kinds (`readiness-change`,
  * `interaction-ready`, `ready`) and their DOM-event bridge were
  * removed in the broad architecture review compat sweep. Hosts that
  * need the readiness detail read it via the kernel's `selectReadiness`
@@ -46,4 +46,3 @@ export interface TransitionResult {
  * core stays safe by design).
  */
 export declare function transition(state: SectionEngineState, input: SectionEngineInput): TransitionResult;
-//# sourceMappingURL=engine-transition.d.ts.map

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

@@ -26,7 +26,7 @@
  *   3. `framework-error` outputs are independent of the stage chain
  *      and do not move the phase.
  *
- * The deprecated readiness output kinds (`readiness-change`,
+ * Readiness alias output kinds (`readiness-change`,
  * `interaction-ready`, `ready`) and their DOM-event bridge were
  * removed in the broad architecture review compat sweep. Hosts that
  * need the readiness detail read it via the kernel's `selectReadiness`

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

@@ -1 +1 @@
-{"version":3,"file":"engine-transition.js","sourceRoot":"","sources":["../../../src/runtime/core/engine-transition.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"engine-transition.js","sourceRoot":"","sources":["../../../src/runtime/core/engine-transition.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Pure transition function for the section runtime engine (M7 — Variant\n * C, layered core).\n *\n * `transition(state, input)` is total over `(state, input)` pairs and\n * returns:\n *   - the next `SectionEngineState` (immutable; the input state object\n *     is never mutated);\n *   - the ordered list of `SectionEngineOutput`s the adapter must\n *     dispatch (DOM events, framework-error fan-out, etc.).\n *\n * The function imports nothing from Svelte, the DOM, or the\n * coordinator. The `core/` constraint is enforced by the per-PR audit\n * step in the M7 implementation plan.\n *\n * Phase machine (per `engine-state.ts`):\n *   idle → booting-section → engine-ready → interactive → disposed\n *   (cohort-change rolls back to booting-section for the new cohort\n *    after emitting `disposed` for the outgoing cohort)\n *\n * Output ordering invariants:\n *   1. `stage-change` for stage advancement fires before any\n *      `loading-complete` triggered by the same input.\n *   2. `loading-complete` fires once per cohort, gated on\n *      `state.loadingCompleteEmitted`.\n *   3. `framework-error` outputs are independent of the stage chain\n *      and do not move the phase.\n *\n * Readiness alias output kinds (`readiness-change`,\n * `interaction-ready`, `ready`) and their DOM-event bridge were\n * removed in the broad architecture review compat sweep. Hosts that\n * need the readiness detail read it via the kernel's `selectReadiness`\n * / `getSnapshot` selectors or via `SectionEngineCore.getState()`.\n */\n\nimport { cohortsEqual, type CohortKey } from \"./cohort.js\";\nimport type { SectionEngineInput } from \"./engine-input.js\";\nimport type { SectionEngineOutput } from \"./engine-output.js\";\nimport {\n\tcreateReadinessDetail,\n\ttype EngineReadinessSignals,\n} from \"./engine-readiness.js\";\nimport { phaseToStage } from \"./engine-stage-derivation.js\";\nimport {\n\tcreateInitialEngineState,\n\ttype SectionEnginePhase,\n\ttype SectionEngineState,\n} from \"./engine-state.js\";\n\nexport interface TransitionResult {\n\tstate: SectionEngineState;\n\toutputs: SectionEngineOutput[];\n}\n\nfunction emitStageChange(\n\toutputs: SectionEngineOutput[],\n\tphase: SectionEnginePhase,\n\tcohort: CohortKey | null,\n\tstatus: \"entered\" | \"skipped\" | \"failed\" = \"entered\",\n): void {\n\tconst stage = phaseToStage(phase);\n\tif (!stage) return;\n\toutputs.push({ kind: \"stage-change\", stage, status, cohort });\n}\n\n/**\n * Transition the engine after `initialize` / `cohort-change`. Sets\n * the new cohort, resets latches, stores the resolved runtime/tools,\n * and emits the `composed` stage.\n */\nfunction startCohort(args: {\n\tstate: SectionEngineState;\n\tcohort: CohortKey;\n\teffectiveRuntime: SectionEngineState[\"effectiveRuntime\"];\n\teffectiveToolsConfig: unknown;\n\titemCount: number;\n}): { state: SectionEngineState; outputs: SectionEngineOutput[] } {\n\tconst next: SectionEngineState = {\n\t\t...createInitialEngineState(),\n\t\tphase: \"booting-section\",\n\t\tcohort: args.cohort,\n\t\teffectiveRuntime: args.effectiveRuntime,\n\t\teffectiveToolsConfig: args.effectiveToolsConfig,\n\t\titemCount: args.itemCount,\n\t};\n\tconst outputs: SectionEngineOutput[] = [];\n\temitStageChange(outputs, \"booting-section\", args.cohort);\n\treturn { state: next, outputs };\n}\n\n/**\n * Apply a readiness update: store new signals, derive the detail in\n * the requested mode, advance the phase to `interactive` when gated,\n * and emit `loading-complete` once per cohort.\n */\nfunction applyReadinessUpdate(\n\tstate: SectionEngineState,\n\targs: {\n\t\tsignals: EngineReadinessSignals;\n\t\tmode: \"progressive\" | \"strict\";\n\t\tloadedCount: number;\n\t\titemCount: number;\n\t},\n): TransitionResult {\n\tif (state.phase === \"idle\" || state.phase === \"disposed\") {\n\t\t// No cohort to update; ignore.\n\t\treturn { state, outputs: [] };\n\t}\n\n\tconst detail = createReadinessDetail({\n\t\tmode: args.mode,\n\t\tsignals: args.signals,\n\t});\n\tconst outputs: SectionEngineOutput[] = [];\n\n\tlet phase = state.phase;\n\tlet loadingCompleteEmitted = state.loadingCompleteEmitted;\n\n\t// Stage advancement: engine-ready → interactive when readiness\n\t// satisfies `interactionReady` (mode-aware via `createReadinessDetail`).\n\tif (phase === \"engine-ready\" && detail.interactionReady) {\n\t\tphase = \"interactive\";\n\t\temitStageChange(outputs, phase, state.cohort);\n\t}\n\n\t// Canonical `loading-complete` emission. One-shot per cohort, gated\n\t// on the readiness signals indicating every item has finished\n\t// loading.\n\tif (\n\t\tdetail.allLoadingComplete &&\n\t\tstate.cohort &&\n\t\t!loadingCompleteEmitted\n\t) {\n\t\tloadingCompleteEmitted = true;\n\t\toutputs.push({\n\t\t\tkind: \"loading-complete\",\n\t\t\tcohort: state.cohort,\n\t\t\titemCount: args.itemCount,\n\t\t\tloadedCount: args.loadedCount,\n\t\t});\n\t}\n\n\tconst nextState: SectionEngineState = {\n\t\t...state,\n\t\tphase,\n\t\treadinessSignals: args.signals,\n\t\tloadedCount: args.loadedCount,\n\t\titemCount: args.itemCount,\n\t\tloadingCompleteEmitted,\n\t};\n\treturn { state: nextState, outputs };\n}\n\n/**\n * Pure transition. Total over `(state, input)`; never mutates inputs;\n * never throws. Unhandled inputs after `disposed` fall through to a\n * no-op (the adapter is responsible for not feeding them in, but the\n * core stays safe by design).\n */\nexport function transition(\n\tstate: SectionEngineState,\n\tinput: SectionEngineInput,\n): TransitionResult {\n\tswitch (input.kind) {\n\t\tcase \"initialize\": {\n\t\t\tif (state.phase === \"disposed\") {\n\t\t\t\t// The engine has been disposed; ignore.\n\t\t\t\treturn { state, outputs: [] };\n\t\t\t}\n\t\t\tif (state.phase !== \"idle\") {\n\t\t\t\t// Already initialized. Treat as `update-runtime` for the\n\t\t\t\t// current cohort if the cohort matches; otherwise treat as\n\t\t\t\t// a `cohort-change`.\n\t\t\t\tif (cohortsEqual(state.cohort, input.cohort)) {\n\t\t\t\t\treturn transition(state, {\n\t\t\t\t\t\tkind: \"update-runtime\",\n\t\t\t\t\t\teffectiveRuntime: input.effectiveRuntime,\n\t\t\t\t\t\teffectiveToolsConfig: input.effectiveToolsConfig,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\treturn transition(state, {\n\t\t\t\t\tkind: \"cohort-change\",\n\t\t\t\t\tcohort: input.cohort,\n\t\t\t\t\teffectiveRuntime: input.effectiveRuntime,\n\t\t\t\t\teffectiveToolsConfig: input.effectiveToolsConfig,\n\t\t\t\t\titemCount: input.itemCount,\n\t\t\t\t});\n\t\t\t}\n\t\t\treturn startCohort({\n\t\t\t\tstate,\n\t\t\t\tcohort: input.cohort,\n\t\t\t\teffectiveRuntime: input.effectiveRuntime,\n\t\t\t\teffectiveToolsConfig: input.effectiveToolsConfig,\n\t\t\t\titemCount: input.itemCount,\n\t\t\t});\n\t\t}\n\n\t\tcase \"update-runtime\": {\n\t\t\tif (state.phase === \"idle\" || state.phase === \"disposed\") {\n\t\t\t\treturn { state, outputs: [] };\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tstate: {\n\t\t\t\t\t...state,\n\t\t\t\t\teffectiveRuntime: input.effectiveRuntime,\n\t\t\t\t\teffectiveToolsConfig: input.effectiveToolsConfig,\n\t\t\t\t},\n\t\t\t\toutputs: [],\n\t\t\t};\n\t\t}\n\n\t\tcase \"cohort-change\": {\n\t\t\tif (state.phase === \"disposed\") {\n\t\t\t\treturn { state, outputs: [] };\n\t\t\t}\n\t\t\tif (cohortsEqual(state.cohort, input.cohort)) {\n\t\t\t\t// No-op cohort change; fall back to a runtime update.\n\t\t\t\treturn transition(state, {\n\t\t\t\t\tkind: \"update-runtime\",\n\t\t\t\t\teffectiveRuntime: input.effectiveRuntime,\n\t\t\t\t\teffectiveToolsConfig: input.effectiveToolsConfig,\n\t\t\t\t});\n\t\t\t}\n\t\t\tconst outputs: SectionEngineOutput[] = [];\n\t\t\tif (state.phase !== \"idle\") {\n\t\t\t\t// Emit `disposed` for the outgoing cohort before we wipe state.\n\t\t\t\toutputs.push({\n\t\t\t\t\tkind: \"stage-change\",\n\t\t\t\t\tstage: \"disposed\",\n\t\t\t\t\tstatus: \"entered\",\n\t\t\t\t\tcohort: state.cohort,\n\t\t\t\t});\n\t\t\t}\n\t\t\tconst started = startCohort({\n\t\t\t\tstate,\n\t\t\t\tcohort: input.cohort,\n\t\t\t\teffectiveRuntime: input.effectiveRuntime,\n\t\t\t\teffectiveToolsConfig: input.effectiveToolsConfig,\n\t\t\t\titemCount: input.itemCount,\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tstate: started.state,\n\t\t\t\toutputs: [...outputs, ...started.outputs],\n\t\t\t};\n\t\t}\n\n\t\tcase \"section-controller-resolved\": {\n\t\t\tif (state.phase !== \"booting-section\") {\n\t\t\t\t// Either too early (idle), too late (interactive / disposed),\n\t\t\t\t// or a duplicate notification; the FSM is monotonic.\n\t\t\t\treturn {\n\t\t\t\t\tstate: { ...state, controllerResolved: true },\n\t\t\t\t\toutputs: [],\n\t\t\t\t};\n\t\t\t}\n\t\t\tconst outputs: SectionEngineOutput[] = [];\n\t\t\temitStageChange(outputs, \"engine-ready\", state.cohort);\n\t\t\treturn {\n\t\t\t\tstate: {\n\t\t\t\t\t...state,\n\t\t\t\t\tphase: \"engine-ready\",\n\t\t\t\t\tcontrollerResolved: true,\n\t\t\t\t},\n\t\t\t\toutputs,\n\t\t\t};\n\t\t}\n\n\t\tcase \"update-readiness-signals\": {\n\t\t\treturn applyReadinessUpdate(state, {\n\t\t\t\tsignals: input.signals,\n\t\t\t\tmode: input.mode,\n\t\t\t\tloadedCount: input.loadedCount,\n\t\t\t\titemCount: input.itemCount,\n\t\t\t});\n\t\t}\n\n\t\tcase \"framework-error\": {\n\t\t\treturn {\n\t\t\t\tstate: {\n\t\t\t\t\t...state,\n\t\t\t\t\tlastFrameworkError: input.error,\n\t\t\t\t\treadinessSignals: {\n\t\t\t\t\t\t...state.readinessSignals,\n\t\t\t\t\t\truntimeError: true,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\toutputs: [{ kind: \"framework-error\", error: input.error }],\n\t\t\t};\n\t\t}\n\n\t\tcase \"dispose\": {\n\t\t\tif (state.phase === \"disposed\") {\n\t\t\t\treturn { state, outputs: [] };\n\t\t\t}\n\t\t\tconst outputs: SectionEngineOutput[] = [];\n\t\t\tif (state.phase !== \"idle\") {\n\t\t\t\temitStageChange(outputs, \"disposed\", state.cohort);\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tstate: {\n\t\t\t\t\t...state,\n\t\t\t\t\tphase: \"disposed\",\n\t\t\t\t},\n\t\t\t\toutputs,\n\t\t\t};\n\t\t}\n\n\t\tdefault: {\n\t\t\tconst exhaustive: never = input;\n\t\t\tvoid exhaustive;\n\t\t\treturn { state, outputs: [] };\n\t\t}\n\t}\n}\n"]}

package/dist/runtime/engine-context.d.ts

@@ -37,4 +37,3 @@ export declare const SECTION_RUNTIME_ENGINE_KEY: unique symbol;
  * class directly.
  */
 export type SectionRuntimeEngineContext = SectionRuntimeEngine;
-//# sourceMappingURL=engine-context.d.ts.map

package/dist/runtime/engine-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine-context.js","sourceRoot":"","sources":["../../src/runtime/engine-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAkB,MAAM,CAC9D,qCAAqC,CACrC,CAAC"}
+{"version":3,"file":"engine-context.js","sourceRoot":"","sources":["../../src/runtime/engine-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAkB,MAAM,CAC9D,qCAAqC,CACrC,CAAC","sourcesContent":["/**\n * Svelte context key for the section runtime engine (M7 PR 5).\n *\n * Components inside a section player layout consume the engine through\n * Svelte's native `getContext(SECTION_RUNTIME_ENGINE_KEY)`. The kernel\n * (`SectionPlayerLayoutKernel.svelte`) is the canonical provider — it\n * constructs the engine, attaches it to the layout CE host, and exposes\n * it to descendants via `setContext(SECTION_RUNTIME_ENGINE_KEY, engine)`.\n *\n * The contract is one-directional:\n *   - Provider: the component that owns engine lifetime (kernel today;\n *     in M7 PR 6 the toolkit CE will fall back to constructing its own\n *     engine when no upstream provider is present).\n *   - Consumers: any descendant Svelte component that needs to read\n *     state, subscribe to outputs, or feed inputs (e.g. the toolkit CE\n *     reaching the engine through the wrapping kernel).\n *\n * The key is a `Symbol` so it cannot collide with userland context keys\n * and so descendants are forced to import this module rather than\n * guess a string id.\n *\n * **Stability.** This export is part of the stable runtime/engine\n * surface; renaming or replacing the symbol is a major breaking\n * change. Adding adjacent context keys (e.g. for dedicated read-only\n * snapshots) is allowed.\n */\n\nimport type { SectionRuntimeEngine } from \"./SectionRuntimeEngine.js\";\n\n/**\n * Svelte context key under which a `SectionRuntimeEngine` instance is\n * provided to descendants.\n */\nexport const SECTION_RUNTIME_ENGINE_KEY: unique symbol = Symbol(\n\t\"@pie-players/section-runtime-engine\",\n);\n\n/**\n * Type-level alias for the value stored under\n * `SECTION_RUNTIME_ENGINE_KEY`. Exposed as a separate alias so\n * consumers can spell the type without importing the implementing\n * class directly.\n */\nexport type SectionRuntimeEngineContext = SectionRuntimeEngine;\n"]}

package/dist/runtime/engine.d.ts

@@ -20,5 +20,4 @@
  */
 export { SectionRuntimeEngine, type SectionRuntimeEngineHostArgs, } from "./SectionRuntimeEngine.js";
 export { SECTION_RUNTIME_ENGINE_KEY, type SectionRuntimeEngineContext, } from "./engine-context.js";
-export { sectionRuntimeEngineHostContext, connectSectionRuntimeEngineHostContext, type SectionRuntimeEngineHostContextValue, type SectionRuntimeEngineHostContextListener, } from "./section-runtime-engine-host-context.js";
-//# sourceMappingURL=engine.d.ts.map
+export { sectionRuntimeEngineHostContext, connectSectionRuntimeEngineHostContext, type SectionRuntimeLifecycleHandle, type SectionRuntimeEngineHostContextValue, type SectionRuntimeEngineHostContextListener, } from "./section-runtime-engine-host-context.js";

package/dist/runtime/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/runtime/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACN,oBAAoB,GAEpB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACN,0BAA0B,GAE1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACN,+BAA+B,EAC/B,sCAAsC,GAGtC,MAAM,0CAA0C,CAAC"}
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/runtime/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACN,oBAAoB,GAEpB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACN,0BAA0B,GAE1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACN,+BAA+B,EAC/B,sCAAsC,GAItC,MAAM,0CAA0C,CAAC","sourcesContent":["/**\n * Section runtime engine — facade entry point (M7 — Variant C).\n *\n * Narrow, stable public surface for hosts that want to mount, drive,\n * or dispose a section runtime via the layered engine. Re-exports the\n * `SectionRuntimeEngine` facade and its `attachHost` arg shape.\n *\n * **Pairing.** This module is the stable counterpart to\n * `./runtime/internal`, which exposes the wider, evolving surface\n * (core types, adapter bridges, cohort helpers) for advanced hosts and\n * for the engine's own tests / benchmarks. Consumers that only need to\n * mount + drive a section runtime should import from here. Consumers\n * that need to reach past the facade (e.g. construct an adapter\n * manually, inspect FSM state types, build alternate fan-out paths)\n * should import from `./runtime/internal` and accept the documented\n * stability disclaimer there.\n *\n * The package's `exports` map adds `./runtime/engine` in M7 PR 3\n * alongside the facade refactor.\n */\n\nexport {\n\tSectionRuntimeEngine,\n\ttype SectionRuntimeEngineHostArgs,\n} from \"./SectionRuntimeEngine.js\";\n\nexport {\n\tSECTION_RUNTIME_ENGINE_KEY,\n\ttype SectionRuntimeEngineContext,\n} from \"./engine-context.js\";\n\nexport {\n\tsectionRuntimeEngineHostContext,\n\tconnectSectionRuntimeEngineHostContext,\n\ttype SectionRuntimeLifecycleHandle,\n\ttype SectionRuntimeEngineHostContextValue,\n\ttype SectionRuntimeEngineHostContextListener,\n} from \"./section-runtime-engine-host-context.js\";\n"]}

package/dist/runtime/internal.d.ts

@@ -41,4 +41,3 @@ export { DEFAULT_ASSESSMENT_ID, DEFAULT_ENV, DEFAULT_ISOLATION, DEFAULT_LAZY_INI
 export { createReadinessDetail, resolveReadinessPhase, } from "./core/engine-readiness.js";
 export { transition } from "./core/engine-transition.js";
 export type { TransitionResult } from "./core/engine-transition.js";
-//# sourceMappingURL=internal.d.ts.map

package/dist/runtime/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/runtime/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAGzE,uEAAuE;AACvE,uEAAuE;AACvE,sEAAsE;AACtE,sEAAsE;AACtE,sEAAsE;AACtE,qEAAqE;AACrE,sEAAsE;AACtE,2DAA2D;AAC3D,0DAA0D;AAC1D,OAAO,EACN,iBAAiB,GAIjB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACN,uBAAuB,GAKvB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACN,oBAAoB,GAGpB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACN,0BAA0B,GAG1B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACN,2BAA2B,GAI3B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACN,sBAAsB,GAGtB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE,OAAO,EACN,SAAS,EACT,YAAY,EACZ,UAAU,GAEV,MAAM,kBAAkB,CAAC;AAa1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EACN,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,gCAAgC,EAChC,kBAAkB,GAQlB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACN,qBAAqB,EACrB,qBAAqB,GACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/runtime/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAGzE,uEAAuE;AACvE,uEAAuE;AACvE,sEAAsE;AACtE,sEAAsE;AACtE,sEAAsE;AACtE,qEAAqE;AACrE,sEAAsE;AACtE,2DAA2D;AAC3D,0DAA0D;AAC1D,OAAO,EACN,iBAAiB,GAIjB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACN,uBAAuB,GAKvB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACN,oBAAoB,GAGpB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACN,0BAA0B,GAG1B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACN,2BAA2B,GAI3B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACN,sBAAsB,GAGtB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE,OAAO,EACN,SAAS,EACT,YAAY,EACZ,UAAU,GAEV,MAAM,kBAAkB,CAAC;AAa1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EACN,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,gCAAgC,EAChC,kBAAkB,GAQlB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACN,qBAAqB,EACrB,qBAAqB,GACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC","sourcesContent":["/**\n * Section runtime engine — **internal** entry point (M7 — Variant C).\n *\n * Re-exports the layered core + adapter surface for advanced hosts that\n * want to construct or inspect engines directly, and for the engine's\n * own tests / benchmarks.\n *\n * **Stability posture.** This module is **not** part of the stable\n * public API. Symbols here are subject to change between minor versions\n * with only a changeset note. Hosts that need long-term stability\n * should depend on the facade (`SectionRuntimeEngine` exported from\n * `./runtime/engine`) instead.\n *\n * The split is intentional:\n *   - `./runtime/engine` (PR 3) — narrow, stable facade for common\n *     host wiring.\n *   - `./runtime/internal` — wide, evolving surface for the kernel,\n *     adapter tests, and any host that wants to reach past the facade.\n *\n * The `runtime/engine` and `runtime/internal` package `exports` map\n * entries are added in PR 3 alongside the facade refactor.\n */\n\nexport { SectionEngineAdapter } from \"./adapter/SectionEngineAdapter.js\";\nexport type { SectionEngineAdapterOptions } from \"./adapter/SectionEngineAdapter.js\";\n\n// `FrameworkErrorBus` is the package-internal multi-subscriber bus the\n// engine adapter consumes via the `FrameworkErrorReporter` write port.\n// It is re-exported here (alongside the read/write ports) so advanced\n// hosts that construct an engine instance directly — including the M7\n// PR 5 section-player kernel — can wire a bus without reaching into a\n// deep relative path. The class itself remains \"package-internal\" in\n// posture (the doc comment on the class explains why); this export is\n// a deliberate, advanced-host escape hatch on the evolving\n// `runtime/internal` surface, never on the stable facade.\nexport {\n\tFrameworkErrorBus,\n\ttype FrameworkErrorListener,\n\ttype FrameworkErrorPort,\n\ttype FrameworkErrorReporter,\n} from \"../services/framework-error-bus.js\";\n\nexport {\n\tcreateCoordinatorBridge,\n\ttype CoordinatorBridgeHandle,\n\ttype CoordinatorBridgeOptions,\n\ttype CoordinatorPort,\n\ttype ResolveSectionControllerArgs,\n} from \"./adapter/coordinator-bridge.js\";\n\nexport {\n\tcreateDomEventBridge,\n\ttype DomEventBridgeHandle,\n\ttype DomEventBridgeOptions,\n} from \"./adapter/dom-event-bridge.js\";\n\nexport {\n\tcreateFrameworkErrorBridge,\n\ttype FrameworkErrorBridgeHandle,\n\ttype FrameworkErrorBridgeOptions,\n} from \"./adapter/framework-error-bridge.js\";\n\nexport {\n\tcreateInstrumentationBridge,\n\ttype InstrumentationBridgeHandle,\n\ttype InstrumentationBridgeOptions,\n\ttype InstrumentationHook,\n} from \"./adapter/instrumentation-bridge.js\";\n\nexport {\n\tcreateSubscriberFanout,\n\ttype EngineOutputListener,\n\ttype SubscriberFanoutHandle,\n} from \"./adapter/subscriber-fanout.js\";\n\nexport { SectionEngineCore } from \"./core/SectionEngineCore.js\";\nexport type { SectionEngineCoreListener } from \"./core/SectionEngineCore.js\";\n\nexport {\n\tcohortKey,\n\tcohortsEqual,\n\tmakeCohort,\n\ttype CohortKey,\n} from \"./core/cohort.js\";\n\nexport type { SectionEngineInput } from \"./core/engine-input.js\";\nexport type { SectionEngineOutput } from \"./core/engine-output.js\";\nexport type {\n\tEngineReadinessDetail,\n\tEngineReadinessPhase,\n\tEngineReadinessSignals,\n} from \"./core/engine-readiness.js\";\nexport type {\n\tSectionEnginePhase,\n\tSectionEngineState,\n} from \"./core/engine-state.js\";\nexport { createInitialEngineState } from \"./core/engine-state.js\";\nexport { phaseToStage } from \"./core/engine-stage-derivation.js\";\nexport {\n\tDEFAULT_ASSESSMENT_ID,\n\tDEFAULT_ENV,\n\tDEFAULT_ISOLATION,\n\tDEFAULT_LAZY_INIT,\n\tDEFAULT_PLAYER_TYPE,\n\tresolveOnFrameworkError,\n\tresolveRuntime,\n\tresolveSectionEngineRuntimeState,\n\tresolveToolsConfig,\n\ttype EffectiveRuntime,\n\ttype FrameworkErrorHandler,\n\ttype LoadingCompleteHandler,\n\ttype PlayerOverrides,\n\ttype RuntimeConfig,\n\ttype RuntimeInputs,\n\ttype StageChangeHandler,\n} from \"./core/engine-resolver.js\";\nexport {\n\tcreateReadinessDetail,\n\tresolveReadinessPhase,\n} from \"./core/engine-readiness.js\";\nexport { transition } from \"./core/engine-transition.js\";\nexport type { TransitionResult } from \"./core/engine-transition.js\";\n"]}

package/dist/runtime/registration-events.d.ts

@@ -35,4 +35,3 @@ export interface InternalItemPlayerErrorDetail {
     contentKind?: string;
     error: unknown;
 }
-//# sourceMappingURL=registration-events.d.ts.map

package/dist/runtime/registration-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"registration-events.js","sourceRoot":"","sources":["../../src/runtime/registration-events.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AACjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AACrD,MAAM,CAAC,MAAM,uCAAuC,GAAG,0BAA0B,CAAC;AAClF,MAAM,CAAC,MAAM,8BAA8B,GAAG,sBAAsB,CAAC;AACrE,MAAM,CAAC,MAAM,iCAAiC,GAAG,oBAAoB,CAAC;AACtE,MAAM,CAAC,MAAM,oCAAoC,GAAG,uBAAuB,CAAC"}
+{"version":3,"file":"registration-events.js","sourceRoot":"","sources":["../../src/runtime/registration-events.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AACjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AACrD,MAAM,CAAC,MAAM,uCAAuC,GAAG,0BAA0B,CAAC;AAClF,MAAM,CAAC,MAAM,8BAA8B,GAAG,sBAAsB,CAAC;AACrE,MAAM,CAAC,MAAM,iCAAiC,GAAG,oBAAoB,CAAC;AACtE,MAAM,CAAC,MAAM,oCAAoC,GAAG,uBAAuB,CAAC","sourcesContent":["export const PIE_REGISTER_EVENT = \"pie-register\";\nexport const PIE_UNREGISTER_EVENT = \"pie-unregister\";\nexport const PIE_INTERNAL_ITEM_SESSION_CHANGED_EVENT = \"pie-item-session-changed\";\nexport const PIE_ITEM_SESSION_CHANGED_EVENT = \"item-session-changed\";\nexport const PIE_INTERNAL_CONTENT_LOADED_EVENT = \"pie-content-loaded\";\nexport const PIE_INTERNAL_ITEM_PLAYER_ERROR_EVENT = \"pie-item-player-error\";\n\nexport type RuntimeRegistrationKind = \"item\" | \"passage\";\n\nexport interface RuntimeRegistrationDetail {\n\tkind: RuntimeRegistrationKind;\n\titemId: string;\n\tcanonicalItemId?: string;\n\tcontentKind?: string;\n\titem?: unknown;\n\telement: HTMLElement;\n}\n\nexport interface ItemSessionChangedDetail {\n\titemId: string;\n\tcanonicalItemId?: string;\n\tsession: unknown;\n\tsourceRuntimeId?: string;\n}\n\nexport interface InternalItemSessionChangedDetail {\n\titemId: string;\n\tsession: unknown;\n}\n\nexport interface InternalContentLoadedDetail {\n\titemId: string;\n\tcanonicalItemId?: string;\n\tcontentKind?: string;\n\tdetail?: unknown;\n}\n\nexport interface InternalItemPlayerErrorDetail {\n\titemId: string;\n\tcanonicalItemId?: string;\n\tcontentKind?: string;\n\terror: unknown;\n}\n"]}

package/dist/runtime/runtime-id.d.ts

@@ -5,4 +5,3 @@
  * telemetry tags. Single export by design — not a "guards" module.
  */
 export declare function createRuntimeId(prefix?: string): string;
-//# sourceMappingURL=runtime-id.d.ts.map

package/dist/runtime/runtime-id.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-id.js","sourceRoot":"","sources":["../../src/runtime/runtime-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAM,GAAG,SAAS;IACjD,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AACzE,CAAC"}
+{"version":3,"file":"runtime-id.js","sourceRoot":"","sources":["../../src/runtime/runtime-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAM,GAAG,SAAS;IACjD,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AACzE,CAAC","sourcesContent":["/**\n * Stable runtime-instance id generator.\n *\n * Produces a per-runtime id used to scope DOM attribute names and\n * telemetry tags. Single export by design — not a \"guards\" module.\n */\nexport function createRuntimeId(prefix = \"runtime\"): string {\n\treturn `${prefix}-${Math.random().toString(16).slice(2)}-${Date.now()}`;\n}\n"]}

package/dist/runtime/section-runtime-engine-host-context.d.ts

@@ -9,16 +9,16 @@
  *
  *   - The kernel (`SectionPlayerLayoutKernel.svelte`) installs a
  *     `ContextProvider` for `sectionRuntimeEngineHostContext` on its
- *     `host` (the layout CE). The provider value carries the engine
- *     reference owned by that kernel mount.
+ *     `host` (the layout CE). The provider value carries a narrow
+ *     lifecycle handle for the engine owned by that kernel mount.
  *   - The toolkit CE installs a `ContextConsumer` on its own host. When
  *     wrapped by a section player layout, the consumer resolves to the
- *     kernel's engine and the toolkit treats it as the active engine
- *     for legacy controller-side calls (`register`, `handleContent*`,
- *     `initialize`, etc.) and for FSM input dispatch (e.g.
- *     `framework-error`). When standalone, no upstream provider
- *     responds and the toolkit keeps using its locally-constructed
- *     engine.
+ *     kernel's lifecycle handle and suppresses its standalone lifecycle
+ *     DOM emits in favor of the section-player host. Controller-side
+ *     calls (`register`, `handleContent*`, `initialize`, etc.) remain
+ *     owned by the toolkit's locally-constructed engine. When
+ *     standalone, no host provider responds and the toolkit keeps using
+ *     its standalone lifecycle path.
  *
  * The two engine-context surfaces (`SECTION_RUNTIME_ENGINE_KEY` and
  * this one) are deliberately distinct:
@@ -26,8 +26,8 @@
  *     single component tree (kernel + descendants in the same shadow
  *     root) and is the right hook for in-tree consumers.
  *   - `sectionRuntimeEngineHostContext` (DOM-event context) is the
- *     bridge for cross-CE consumers and only carries data that is
- *     safe to share across CE boundaries (a stable engine reference).
+ *     bridge for cross-CE consumers and only carries data that is safe
+ *     to share across CE boundaries (a stable lifecycle handle).
  *
  * **Stability.** This export is part of the stable runtime/engine
  * surface; the symbol identity and value shape are part of the
@@ -35,15 +35,22 @@
  * breaking change. Adding optional fields to the value shape is
  * allowed; required fields are not.
  */
-import type { SectionRuntimeEngine } from "./SectionRuntimeEngine.js";
+/**
+ * Narrow cross-CE handle published by section-player. Deliberately omits
+ * controller-facing methods (`initialize`, `register`, `handleContent*`,
+ * etc.) so the package seam cannot grow an accidental controller contract.
+ */
+export interface SectionRuntimeLifecycleHandle {
+    getRuntimeId(): string;
+}
 /**
  * Value shape published by the kernel and consumed by the wrapped
- * toolkit CE. Carries only the engine reference today; if more
- * cross-CE shared runtime state is needed later, fields can be added
- * here additively.
+ * toolkit CE. Carries only the lifecycle handle today; if more cross-CE
+ * shared runtime state is needed later, fields can be added here
+ * additively.
  */
 export interface SectionRuntimeEngineHostContextValue {
-    engine: SectionRuntimeEngine;
+    engine: SectionRuntimeLifecycleHandle;
 }
 /**
  * `pie-context` context key for the cross-CE engine bridge. Uses a
@@ -71,4 +78,3 @@ export type SectionRuntimeEngineHostContextListener = (value: SectionRuntimeEngi
  * engine — that is by design and is not an error.
  */
 export declare function connectSectionRuntimeEngineHostContext(host: HTMLElement, onValue: SectionRuntimeEngineHostContextListener): () => void;
-//# sourceMappingURL=section-runtime-engine-host-context.d.ts.map

package/dist/runtime/section-runtime-engine-host-context.js

@@ -9,16 +9,16 @@
  *
  *   - The kernel (`SectionPlayerLayoutKernel.svelte`) installs a
  *     `ContextProvider` for `sectionRuntimeEngineHostContext` on its
- *     `host` (the layout CE). The provider value carries the engine
- *     reference owned by that kernel mount.
+ *     `host` (the layout CE). The provider value carries a narrow
+ *     lifecycle handle for the engine owned by that kernel mount.
  *   - The toolkit CE installs a `ContextConsumer` on its own host. When
  *     wrapped by a section player layout, the consumer resolves to the
- *     kernel's engine and the toolkit treats it as the active engine
- *     for legacy controller-side calls (`register`, `handleContent*`,
- *     `initialize`, etc.) and for FSM input dispatch (e.g.
- *     `framework-error`). When standalone, no upstream provider
- *     responds and the toolkit keeps using its locally-constructed
- *     engine.
+ *     kernel's lifecycle handle and suppresses its standalone lifecycle
+ *     DOM emits in favor of the section-player host. Controller-side
+ *     calls (`register`, `handleContent*`, `initialize`, etc.) remain
+ *     owned by the toolkit's locally-constructed engine. When
+ *     standalone, no host provider responds and the toolkit keeps using
+ *     its standalone lifecycle path.
  *
  * The two engine-context surfaces (`SECTION_RUNTIME_ENGINE_KEY` and
  * this one) are deliberately distinct:
@@ -26,8 +26,8 @@
  *     single component tree (kernel + descendants in the same shadow
  *     root) and is the right hook for in-tree consumers.
  *   - `sectionRuntimeEngineHostContext` (DOM-event context) is the
- *     bridge for cross-CE consumers and only carries data that is
- *     safe to share across CE boundaries (a stable engine reference).
+ *     bridge for cross-CE consumers and only carries data that is safe
+ *     to share across CE boundaries (a stable lifecycle handle).
  *
  * **Stability.** This export is part of the stable runtime/engine
  * surface; the symbol identity and value shape are part of the

package/dist/runtime/section-runtime-engine-host-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"section-runtime-engine-host-context.js","sourceRoot":"","sources":["../../src/runtime/section-runtime-engine-host-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EACN,eAAe,EACf,aAAa,GAEb,MAAM,0BAA0B,CAAC;AAalC;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAC3C,aAAa,CACZ,MAAM,CAAC,GAAG,CAAC,qCAAqC,CAAC,CACjD,CAAC;AAUH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sCAAsC,CACrD,IAAiB,EACjB,OAAgD;IAEhD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,IAAI,EAAE;QAC1C,OAAO,EAAE,+BAA+B;QACxC,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;KACD,CAAC,CAAC;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC;IAEnB,MAAM,iBAAiB,GAAG,CAAC,KAA+B,EAAE,EAAE;QAC7D,IACC,KAAK,CAAC,OAAO;YACZ,+BAA6D,EAC7D,CAAC;YACF,OAAO;QACR,CAAC;QACD,QAAQ,CAAC,YAAY,EAAE,CAAC;IACzB,CAAC,CAAC;IACF,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;IAE7D,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,WAAW,GAAG,GAAG,CAAC;IACxB,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,EAAE;QAC9C,IAAI,QAAQ,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;YACzC,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YACrC,OAAO;QACR,CAAC;QACD,QAAQ,IAAI,CAAC,CAAC;QACd,QAAQ,CAAC,YAAY,EAAE,CAAC;IACzB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,GAAG,EAAE;QACX,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;QAChE,QAAQ,CAAC,UAAU,EAAE,CAAC;IACvB,CAAC,CAAC;AACH,CAAC"}
+{"version":3,"file":"section-runtime-engine-host-context.js","sourceRoot":"","sources":["../../src/runtime/section-runtime-engine-host-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EACN,eAAe,EACf,aAAa,GAEb,MAAM,0BAA0B,CAAC;AAqBlC;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAC3C,aAAa,CACZ,MAAM,CAAC,GAAG,CAAC,qCAAqC,CAAC,CACjD,CAAC;AAUH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sCAAsC,CACrD,IAAiB,EACjB,OAAgD;IAEhD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,IAAI,EAAE;QAC1C,OAAO,EAAE,+BAA+B;QACxC,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;KACD,CAAC,CAAC;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC;IAEnB,MAAM,iBAAiB,GAAG,CAAC,KAA+B,EAAE,EAAE;QAC7D,IACC,KAAK,CAAC,OAAO;YACZ,+BAA6D,EAC7D,CAAC;YACF,OAAO;QACR,CAAC;QACD,QAAQ,CAAC,YAAY,EAAE,CAAC;IACzB,CAAC,CAAC;IACF,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;IAE7D,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,WAAW,GAAG,GAAG,CAAC;IACxB,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,EAAE;QAC9C,IAAI,QAAQ,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;YACzC,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YACrC,OAAO;QACR,CAAC;QACD,QAAQ,IAAI,CAAC,CAAC;QACd,QAAQ,CAAC,YAAY,EAAE,CAAC;IACzB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,GAAG,EAAE;QACX,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;QAChE,QAAQ,CAAC,UAAU,EAAE,CAAC;IACvB,CAAC,CAAC;AACH,CAAC","sourcesContent":["/**\n * Cross-Custom-Element context for the section runtime engine (M7 PR 6).\n *\n * The toolkit CE renders inside its own Shadow DOM, so Svelte's native\n * `setContext`/`getContext` (used by `engine-context.ts`) cannot bridge\n * the kernel-provided engine reference to the toolkit's component tree.\n * This module exposes a `@pie-players/pie-context` based context that\n * does cross the CE boundary via DOM events:\n *\n *   - The kernel (`SectionPlayerLayoutKernel.svelte`) installs a\n *     `ContextProvider` for `sectionRuntimeEngineHostContext` on its\n *     `host` (the layout CE). The provider value carries a narrow\n *     lifecycle handle for the engine owned by that kernel mount.\n *   - The toolkit CE installs a `ContextConsumer` on its own host. When\n *     wrapped by a section player layout, the consumer resolves to the\n *     kernel's lifecycle handle and suppresses its standalone lifecycle\n *     DOM emits in favor of the section-player host. Controller-side\n *     calls (`register`, `handleContent*`, `initialize`, etc.) remain\n *     owned by the toolkit's locally-constructed engine. When\n *     standalone, no host provider responds and the toolkit keeps using\n *     its standalone lifecycle path.\n *\n * The two engine-context surfaces (`SECTION_RUNTIME_ENGINE_KEY` and\n * this one) are deliberately distinct:\n *   - `SECTION_RUNTIME_ENGINE_KEY` (Svelte context) stays scoped to a\n *     single component tree (kernel + descendants in the same shadow\n *     root) and is the right hook for in-tree consumers.\n *   - `sectionRuntimeEngineHostContext` (DOM-event context) is the\n *     bridge for cross-CE consumers and only carries data that is safe\n *     to share across CE boundaries (a stable lifecycle handle).\n *\n * **Stability.** This export is part of the stable runtime/engine\n * surface; the symbol identity and value shape are part of the\n * cross-CE contract. Renaming or replacing the symbol is a major\n * breaking change. Adding optional fields to the value shape is\n * allowed; required fields are not.\n */\n\nimport {\n\tContextConsumer,\n\tcreateContext,\n\ttype UnknownContext,\n} from \"@pie-players/pie-context\";\n\n/**\n * Narrow cross-CE handle published by section-player. Deliberately omits\n * controller-facing methods (`initialize`, `register`, `handleContent*`,\n * etc.) so the package seam cannot grow an accidental controller contract.\n */\nexport interface SectionRuntimeLifecycleHandle {\n\tgetRuntimeId(): string;\n}\n\n/**\n * Value shape published by the kernel and consumed by the wrapped\n * toolkit CE. Carries only the lifecycle handle today; if more cross-CE\n * shared runtime state is needed later, fields can be added here\n * additively.\n */\nexport interface SectionRuntimeEngineHostContextValue {\n\tengine: SectionRuntimeLifecycleHandle;\n}\n\n/**\n * `pie-context` context key for the cross-CE engine bridge. Uses a\n * `Symbol.for(...)` registry key so providers and consumers in\n * separately-bundled CEs see the same identity.\n */\nexport const sectionRuntimeEngineHostContext =\n\tcreateContext<SectionRuntimeEngineHostContextValue>(\n\t\tSymbol.for(\"pie.sectionRuntimeEngineHostContext\"),\n\t);\n\nexport type SectionRuntimeEngineHostContextListener = (\n\tvalue: SectionRuntimeEngineHostContextValue,\n) => void;\n\ntype ContextProviderLikeEvent = Event & {\n\tcontext?: unknown;\n};\n\n/**\n * Connect a DOM host to the cross-CE engine context with the same\n * provider-retry semantics used elsewhere in the toolkit (initial\n * synchronous request + `context-provider` re-request + 50 ms polling\n * fallback up to 200 attempts ≈ 10 s).\n *\n * The retry mirrors the existing\n * `connectAssessmentToolkitHostRuntimeContext` infrastructure so the\n * timing characteristics of cross-CE handshakes stay consistent across\n * the toolkit's contexts.\n *\n * Returns a cleanup function that disconnects the consumer and clears\n * the retry interval. Standalone toolkits naturally exhaust the retry\n * window without ever resolving and continue using their local\n * engine — that is by design and is not an error.\n */\nexport function connectSectionRuntimeEngineHostContext(\n\thost: HTMLElement,\n\tonValue: SectionRuntimeEngineHostContextListener,\n): () => void {\n\tlet hasValue = false;\n\tconst consumer = new ContextConsumer(host, {\n\t\tcontext: sectionRuntimeEngineHostContext,\n\t\tsubscribe: true,\n\t\tonValue: (value) => {\n\t\t\thasValue = true;\n\t\t\tonValue(value);\n\t\t},\n\t});\n\tconsumer.connect();\n\n\tconst onContextProvider = (event: ContextProviderLikeEvent) => {\n\t\tif (\n\t\t\tevent.context !==\n\t\t\t(sectionRuntimeEngineHostContext as unknown as UnknownContext)\n\t\t) {\n\t\t\treturn;\n\t\t}\n\t\tconsumer.requestValue();\n\t};\n\thost.addEventListener(\"context-provider\", onContextProvider);\n\n\tlet attempts = 0;\n\tconst maxAttempts = 200;\n\tconst retryTimer = globalThis.setInterval(() => {\n\t\tif (hasValue || attempts >= maxAttempts) {\n\t\t\tglobalThis.clearInterval(retryTimer);\n\t\t\treturn;\n\t\t}\n\t\tattempts += 1;\n\t\tconsumer.requestValue();\n\t}, 50);\n\n\treturn () => {\n\t\tglobalThis.clearInterval(retryTimer);\n\t\thost.removeEventListener(\"context-provider\", onContextProvider);\n\t\tconsumer.disconnect();\n\t};\n}\n"]}

package/dist/runtime/session-event-emitter-policy.d.ts

@@ -9,4 +9,3 @@ export declare function shouldEmitCanonicalSessionEvent(args: {
     itemId: string;
     payload: Record<string, unknown>;
 }): boolean;
-//# sourceMappingURL=session-event-emitter-policy.d.ts.map

package/dist/runtime/session-event-emitter-policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-event-emitter-policy.js","sourceRoot":"","sources":["../../src/runtime/session-event-emitter-policy.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,4BAA4B;IAC3C,OAAO;QACN,iCAAiC,EAAE,IAAI,GAAG,EAAkB;QAC5D,6BAA6B,EAAE,IAAI,GAAG,EAAkB;KACxD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAA6B;IACxE,KAAK,CAAC,iCAAiC,CAAC,KAAK,EAAE,CAAC;IAChD,KAAK,CAAC,6BAA6B,CAAC,KAAK,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,IAI/C;IACA,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACxC,IAAI,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;QAC5D,MAAM,yBAAyB,GAAG,KAAK,CAAC,6BAA6B,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClF,IAAI,yBAAyB,KAAK,iBAAiB,EAAE,CAAC;YACrD,OAAO,KAAK,CAAC;QACd,CAAC;QACD,KAAK,CAAC,6BAA6B,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,SAAS,GAAG,gCAAgC,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,iBAAiB,GAAG,KAAK,CAAC,iCAAiC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACd,CAAC;IACD,KAAK,CAAC,iCAAiC,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,gCAAgC,CAAC,OAAgC;IACzE,MAAM,eAAe,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IACvC,OAAO,eAAe,CAAC,SAAS,CAAC;IACjC,OAAO,eAAe,CAAC,eAAe,CAAC;IACvC,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,MAAM,CAAC,eAAe,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACF,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAgC;IAC5D,OAAO,OAAO,CAAC,MAAM,KAAK,eAAe,CAAC;AAC3C,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAgC;IACjE,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC;YACrB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;YAClC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;SACpC,CAAC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;AACF,CAAC"}
+{"version":3,"file":"session-event-emitter-policy.js","sourceRoot":"","sources":["../../src/runtime/session-event-emitter-policy.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,4BAA4B;IAC3C,OAAO;QACN,iCAAiC,EAAE,IAAI,GAAG,EAAkB;QAC5D,6BAA6B,EAAE,IAAI,GAAG,EAAkB;KACxD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAA6B;IACxE,KAAK,CAAC,iCAAiC,CAAC,KAAK,EAAE,CAAC;IAChD,KAAK,CAAC,6BAA6B,CAAC,KAAK,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,IAI/C;IACA,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACxC,IAAI,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;QAC5D,MAAM,yBAAyB,GAAG,KAAK,CAAC,6BAA6B,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClF,IAAI,yBAAyB,KAAK,iBAAiB,EAAE,CAAC;YACrD,OAAO,KAAK,CAAC;QACd,CAAC;QACD,KAAK,CAAC,6BAA6B,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,SAAS,GAAG,gCAAgC,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,iBAAiB,GAAG,KAAK,CAAC,iCAAiC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACd,CAAC;IACD,KAAK,CAAC,iCAAiC,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,gCAAgC,CAAC,OAAgC;IACzE,MAAM,eAAe,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IACvC,OAAO,eAAe,CAAC,SAAS,CAAC;IACjC,OAAO,eAAe,CAAC,eAAe,CAAC;IACvC,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,MAAM,CAAC,eAAe,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACF,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAgC;IAC5D,OAAO,OAAO,CAAC,MAAM,KAAK,eAAe,CAAC;AAC3C,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAgC;IACjE,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC;YACrB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;YAClC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI;SACpC,CAAC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;AACF,CAAC","sourcesContent":["export type SessionEmitPolicyState = {\n\tlastSessionEventSignatureByItemId: Map<string, string>;\n\tlastMetadataSignatureByItemId: Map<string, string>;\n};\n\nexport function createSessionEmitPolicyState(): SessionEmitPolicyState {\n\treturn {\n\t\tlastSessionEventSignatureByItemId: new Map<string, string>(),\n\t\tlastMetadataSignatureByItemId: new Map<string, string>(),\n\t};\n}\n\nexport function resetSessionEmitPolicyState(state: SessionEmitPolicyState): void {\n\tstate.lastSessionEventSignatureByItemId.clear();\n\tstate.lastMetadataSignatureByItemId.clear();\n}\n\nexport function shouldEmitCanonicalSessionEvent(args: {\n\tstate: SessionEmitPolicyState;\n\titemId: string;\n\tpayload: Record<string, unknown>;\n}): boolean {\n\tconst { state, itemId, payload } = args;\n\tif (isMetadataOnlyEvent(payload)) {\n\t\tconst metadataSignature = getMetadataOnlySignature(payload);\n\t\tconst previousMetadataSignature = state.lastMetadataSignatureByItemId.get(itemId);\n\t\tif (previousMetadataSignature === metadataSignature) {\n\t\t\treturn false;\n\t\t}\n\t\tstate.lastMetadataSignatureByItemId.set(itemId, metadataSignature);\n\t}\n\tconst signature = getSessionEventSemanticSignature(payload);\n\tconst previousSignature = state.lastSessionEventSignatureByItemId.get(itemId);\n\tif (previousSignature === signature) {\n\t\treturn false;\n\t}\n\tstate.lastSessionEventSignatureByItemId.set(itemId, signature);\n\treturn true;\n}\n\nfunction getSessionEventSemanticSignature(payload: Record<string, unknown>): string {\n\tconst semanticPayload = { ...payload };\n\tdelete semanticPayload.timestamp;\n\tdelete semanticPayload.sourceRuntimeId;\n\ttry {\n\t\treturn JSON.stringify(semanticPayload);\n\t} catch {\n\t\treturn String(semanticPayload.itemId || \"\");\n\t}\n}\n\nfunction isMetadataOnlyEvent(payload: Record<string, unknown>): boolean {\n\treturn payload.intent === \"metadata-only\";\n}\n\nfunction getMetadataOnlySignature(payload: Record<string, unknown>): string {\n\ttry {\n\t\treturn JSON.stringify({\n\t\t\titemId: payload.itemId,\n\t\t\tcanonicalItemId: payload.canonicalItemId,\n\t\t\tintent: payload.intent,\n\t\t\tcomplete: payload.complete ?? null,\n\t\t\tcomponent: payload.component ?? null,\n\t\t});\n\t} catch {\n\t\treturn String(payload.itemId || \"\");\n\t}\n}\n"]}

package/dist/runtime/stage-emit-gate.d.ts

@@ -6,9 +6,9 @@
  * event and invokes the runtime-tier `onStageChange` callback. PR 6
  * introduces the wrapped/standalone branch:
  *
- *   - **Standalone** (no upstream `SectionRuntimeEngine` provider on
+ *   - **Standalone** (no host lifecycle provider on
  *     the layout CE host): emit + `onStageChange` fire as before.
- *   - **Wrapped** (kernel publishes its engine via
+ *   - **Wrapped** (kernel publishes its lifecycle handle via
  *     `sectionRuntimeEngineHostContext` and the toolkit consumer
  *     resolves it): emit + `onStageChange` are suppressed on the
  *     toolkit CE, because the kernel's engine already emits the
@@ -32,7 +32,7 @@
  * unit test without mounting the toolkit CE — see
  * `tests/runtime/stage-emit-gate.test.ts`. The closure in the toolkit
  * passes thunks for `isSuppressed` and `getOnStageChange` so the live
- * Svelte reactive variables (`upstreamEngine`, `onStageChange`) are
+ * Svelte reactive variables (`hostLifecycleEngine`, `onStageChange`) are
  * read at emit time, not captured at construction time. This keeps the
  * pre-PR-6 behavior of always reading the latest `onStageChange` prop
  * value (cohort change, host swap, etc.) intact.
@@ -46,7 +46,7 @@ export type StageOnChangeHandler = (detail: StageChangeDetail) => void;
 export interface StageEmitGateContext {
     /**
      * Reads the current suppression flag. Implemented as a thunk so
-     * the reactive Svelte `$state(upstreamEngine)` is read at emit
+     * the reactive Svelte `$state(hostLifecycleEngine)` is read at emit
      * time. Return `true` to suppress; `false` to fire.
      */
     isSuppressed: () => boolean;
@@ -90,4 +90,3 @@ export interface StageEmitGateContext {
  * effects.
  */
 export declare function runStageEmitWithSuppression(context: StageEmitGateContext, detail: StageChangeDetail): boolean;
-//# sourceMappingURL=stage-emit-gate.d.ts.map

package/dist/runtime/stage-emit-gate.js

@@ -6,9 +6,9 @@
  * event and invokes the runtime-tier `onStageChange` callback. PR 6
  * introduces the wrapped/standalone branch:
  *
- *   - **Standalone** (no upstream `SectionRuntimeEngine` provider on
+ *   - **Standalone** (no host lifecycle provider on
  *     the layout CE host): emit + `onStageChange` fire as before.
- *   - **Wrapped** (kernel publishes its engine via
+ *   - **Wrapped** (kernel publishes its lifecycle handle via
  *     `sectionRuntimeEngineHostContext` and the toolkit consumer
  *     resolves it): emit + `onStageChange` are suppressed on the
  *     toolkit CE, because the kernel's engine already emits the
@@ -32,7 +32,7 @@
  * unit test without mounting the toolkit CE — see
  * `tests/runtime/stage-emit-gate.test.ts`. The closure in the toolkit
  * passes thunks for `isSuppressed` and `getOnStageChange` so the live
- * Svelte reactive variables (`upstreamEngine`, `onStageChange`) are
+ * Svelte reactive variables (`hostLifecycleEngine`, `onStageChange`) are
  * read at emit time, not captured at construction time. This keeps the
  * pre-PR-6 behavior of always reading the latest `onStageChange` prop
  * value (cohort change, host swap, etc.) intact.