npm - @pie-players/pie-assessment-toolkit - Versions diffs - 0.3.44 → 0.3.46 - Mend

@pie-players/pie-assessment-toolkit 0.3.44 → 0.3.46

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (191) hide show

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

	@@ -1 +1 @@
1	- {"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 The deprecated readiness 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"]}
1	+ {"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.d.ts CHANGED Viewed

@@ -20,4 +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";
+export { sectionRuntimeEngineHostContext, connectSectionRuntimeEngineHostContext, type SectionRuntimeLifecycleHandle, type SectionRuntimeEngineHostContextValue, type SectionRuntimeEngineHostContextListener, } from "./section-runtime-engine-host-context.js";

package/dist/runtime/engine.js.map CHANGED Viewed

	@@ -1 +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","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 SectionRuntimeEngineHostContextValue,\n\ttype SectionRuntimeEngineHostContextListener,\n} from \"./section-runtime-engine-host-context.js\";\n"]}
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,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/section-runtime-engine-host-context.d.ts CHANGED Viewed

@@ -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

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

@@ -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 CHANGED Viewed

	@@ -1 +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","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 ~~the~~ ~~engine~~\n * ~~reference~~ 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 ~~engine~~ and ~~the~~ ~~toolkit~~ ~~treats~~ it as the ~~active~~ ~~engine~~\n * ~~for legacy controller-side~~ calls (`register`, `handleContent`,\n `initialize`, etc.) ~~and~~ ~~for~~ ~~FSM~~ ~~input~~ ~~dispatch~~ (e.~~g.\~~n * ~~`framework-error`). When~~ standalone, no ~~upstream~~ provider\n * responds and the toolkit keeps using ~~its locally-constructed~~\n * ~~engine~~.\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\n * ~~safe~~ to share across CE boundaries (a stable ~~engine~~ ~~reference~~).\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\";\~~nimport~~ ~~type~~ { ~~SectionRuntimeEngine~~ } ~~from~~ \~~"./SectionRuntimeEngine~~.js\";\n\n/\n Value shape published by the kernel and consumed by the wrapped\n * toolkit CE. Carries only the ~~engine~~ ~~reference~~ today; if more\n * ~~cross-CE~~ shared runtime state is needed later, fields can be added\n * ~~here~~ additively.\n /\nexport interface SectionRuntimeEngineHostContextValue {\n\tengine: ~~SectionRuntimeEngine~~;\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"]}
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;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/stage-emit-gate.d.ts CHANGED Viewed

@@ -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;

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

@@ -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.

package/dist/runtime/stage-emit-gate.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"stage-emit-gate.js","sourceRoot":"","sources":["../../src/runtime/stage-emit-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAoCH,MAAM,sBAAsB,GAAG,CAAC,KAAc,EAAQ,EAAE;IACvD,OAAO,CAAC,KAAK,CAAC,sDAAsD,EAAE,KAAK,CAAC,CAAC;AAC9E,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,2BAA2B,CAC1C,OAA6B,EAC7B,MAAyB;IAEzB,IAAI,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAC3C,IAAI,OAAO,EAAE,CAAC;QACb,IAAI,CAAC;YACJ,OAAO,CAAC,MAAM,CAAC,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,CAAC,OAAO,CAAC,eAAe,IAAI,sBAAsB,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC","sourcesContent":["/*\n Stage-emit suppression gate (M7 PR 6).\n \n `PieAssessmentToolkit.svelte` builds a `createStageTracker(...)` whose\n * `emit` callback dispatches the toolkit CE's `pie-stage-change` DOM\n * event and invokes the runtime-tier `onStageChange` callback. PR 6\n * introduces the wrapped/standalone branch:\n \n - Standalone (no ~~upstream~~ ~~`SectionRuntimeEngine`~~ provider on\n * the layout CE host): emit + `onStageChange` fire as before.\n * - Wrapped (kernel publishes its ~~engine~~ via\n * `sectionRuntimeEngineHostContext` and the toolkit consumer\n * resolves it): emit + `onStageChange` are suppressed on the\n * toolkit CE, because the kernel's engine already emits the\n * canonical `pie-stage-change` chain on the layout CE host and\n * invokes the runtime-tier callback. Without suppression the\n * toolkit CE would also dispatch its own event, which bubbles\n * through `composed: true` to the layout CE host and produces a\n * duplicate emission for outside listeners.\n \n The internal `stageTracker` latch state advances before this\n * helper is reached (the latch is updated inside\n * `createStageTracker.enter` prior to `opts.emit(...)`), so suppression\n * here only short-circuits the externally-visible side effects. The\n * toolkit's own readiness path (`waitUntilReady` / `engine-ready` /\n * `interactive`) keeps working in standalone mode and degenerates into\n * a series of suppressed emits in wrapped mode without losing any\n * latch transitions.\n \n Splitting this helper out of the inline `emit:` closure in\n * `PieAssessmentToolkit.svelte` lets us pin the suppression branch in a\n * unit test without mounting the toolkit CE — see\n * `tests/runtime/stage-emit-gate.test.ts`. The closure in the toolkit\n * passes thunks for `isSuppressed` and `getOnStageChange` so the live\n * Svelte reactive variables (`~~upstreamEngine~~`, `onStageChange`) are\n * read at emit time, not captured at construction time. This keeps the\n * pre-PR-6 behavior of always reading the latest `onStageChange` prop\n * value (cohort change, host swap, etc.) intact.\n \n NOT a public surface: this helper is internal to the toolkit and is\n * not exported from `runtime/engine.ts`. It only exists to make the\n * gate testable.\n /\n\nimport type { StageChangeDetail } from \"@pie-players/pie-players-shared/pie\";\n\nexport type StageOnChangeHandler = (detail: StageChangeDetail) => void;\n\nexport interface StageEmitGateContext {\n\t/\n\t Reads the current suppression flag. Implemented as a thunk so\n\t * the reactive Svelte `$state(~~upstreamEngine~~)` is read at emit\n\t * time. Return `true` to suppress; `false` to fire.\n\t /\n\tisSuppressed: () => boolean;\n\n\t/\n\t Dispatches the `pie-stage-change` DOM event on the toolkit's\n\t * CE host. In `PieAssessmentToolkit.svelte` this is the\n\t * Svelte-generated `emit(\"pie-stage-change\", detail)` helper.\n\t /\n\tdispatchDomEvent: (detail: StageChangeDetail) => void;\n\n\t/\n\t Reads the current `onStageChange` runtime-tier callback. Thunk\n\t * so the latest reassigned handler is invoked, not whichever\n\t * handler was current at construction time.\n\t /\n\tgetOnStageChange: () => StageOnChangeHandler \| null \| undefined;\n\n\t/\n\t Optional logger for handler errors. Defaults to `console.error`\n\t * with the same prefix the toolkit used pre-PR-6 so test output\n\t * matches production logs.\n\t /\n\tlogHandlerError?: (error: unknown) => void;\n}\n\nconst defaultLogHandlerError = (error: unknown): void => {\n\tconsole.error(\"[pie-assessment-toolkit] onStageChange handler threw\", error);\n};\n\n/\n Run the toolkit's stage emit pipeline with the suppression gate\n * applied.\n \n - When `isSuppressed()` returns `true`, the helper returns\n * immediately with neither side effect.\n * - Otherwise it dispatches the `pie-stage-change` DOM event first,\n * then invokes `onStageChange(detail)` (preserving the\n * \"DOM-event-then-callback\" ordering pre-PR-6 consumers depend\n * on).\n * - A throwing `onStageChange` handler does not interrupt the DOM\n * event (already fired) and does not propagate up to\n * `stageTracker.enter` (latch state already advanced); the error\n * is logged and swallowed, matching pre-PR-6 behavior.\n \n Returns `true` if the emit pipeline ran (i.e. it was not\n * suppressed); `false` if it was suppressed. Tests use the return\n * value to assert the gate's decision in isolation from the side\n * effects.\n */\nexport function runStageEmitWithSuppression(\n\tcontext: StageEmitGateContext,\n\tdetail: StageChangeDetail,\n): boolean {\n\tif (context.isSuppressed()) {\n\t\treturn false;\n\t}\n\tcontext.dispatchDomEvent(detail);\n\tconst handler = context.getOnStageChange();\n\tif (handler) {\n\t\ttry {\n\t\t\thandler(detail);\n\t\t} catch (error) {\n\t\t\t(context.logHandlerError ?? defaultLogHandlerError)(error);\n\t\t}\n\t}\n\treturn true;\n}\n"]}
1	+ {"version":3,"file":"stage-emit-gate.js","sourceRoot":"","sources":["../../src/runtime/stage-emit-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAoCH,MAAM,sBAAsB,GAAG,CAAC,KAAc,EAAQ,EAAE;IACvD,OAAO,CAAC,KAAK,CAAC,sDAAsD,EAAE,KAAK,CAAC,CAAC;AAC9E,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,2BAA2B,CAC1C,OAA6B,EAC7B,MAAyB;IAEzB,IAAI,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAC3C,IAAI,OAAO,EAAE,CAAC;QACb,IAAI,CAAC;YACJ,OAAO,CAAC,MAAM,CAAC,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,CAAC,OAAO,CAAC,eAAe,IAAI,sBAAsB,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC","sourcesContent":["/*\n Stage-emit suppression gate (M7 PR 6).\n \n `PieAssessmentToolkit.svelte` builds a `createStageTracker(...)` whose\n * `emit` callback dispatches the toolkit CE's `pie-stage-change` DOM\n * event and invokes the runtime-tier `onStageChange` callback. PR 6\n * introduces the wrapped/standalone branch:\n \n - Standalone (no host lifecycle provider on\n * the layout CE host): emit + `onStageChange` fire as before.\n * - Wrapped (kernel publishes its lifecycle handle via\n * `sectionRuntimeEngineHostContext` and the toolkit consumer\n * resolves it): emit + `onStageChange` are suppressed on the\n * toolkit CE, because the kernel's engine already emits the\n * canonical `pie-stage-change` chain on the layout CE host and\n * invokes the runtime-tier callback. Without suppression the\n * toolkit CE would also dispatch its own event, which bubbles\n * through `composed: true` to the layout CE host and produces a\n * duplicate emission for outside listeners.\n \n The internal `stageTracker` latch state advances before this\n * helper is reached (the latch is updated inside\n * `createStageTracker.enter` prior to `opts.emit(...)`), so suppression\n * here only short-circuits the externally-visible side effects. The\n * toolkit's own readiness path (`waitUntilReady` / `engine-ready` /\n * `interactive`) keeps working in standalone mode and degenerates into\n * a series of suppressed emits in wrapped mode without losing any\n * latch transitions.\n \n Splitting this helper out of the inline `emit:` closure in\n * `PieAssessmentToolkit.svelte` lets us pin the suppression branch in a\n * unit test without mounting the toolkit CE — see\n * `tests/runtime/stage-emit-gate.test.ts`. The closure in the toolkit\n * passes thunks for `isSuppressed` and `getOnStageChange` so the live\n * Svelte reactive variables (`hostLifecycleEngine`, `onStageChange`) are\n * read at emit time, not captured at construction time. This keeps the\n * pre-PR-6 behavior of always reading the latest `onStageChange` prop\n * value (cohort change, host swap, etc.) intact.\n \n NOT a public surface: this helper is internal to the toolkit and is\n * not exported from `runtime/engine.ts`. It only exists to make the\n * gate testable.\n /\n\nimport type { StageChangeDetail } from \"@pie-players/pie-players-shared/pie\";\n\nexport type StageOnChangeHandler = (detail: StageChangeDetail) => void;\n\nexport interface StageEmitGateContext {\n\t/\n\t Reads the current suppression flag. Implemented as a thunk so\n\t * the reactive Svelte `$state(hostLifecycleEngine)` is read at emit\n\t * time. Return `true` to suppress; `false` to fire.\n\t /\n\tisSuppressed: () => boolean;\n\n\t/\n\t Dispatches the `pie-stage-change` DOM event on the toolkit's\n\t * CE host. In `PieAssessmentToolkit.svelte` this is the\n\t * Svelte-generated `emit(\"pie-stage-change\", detail)` helper.\n\t /\n\tdispatchDomEvent: (detail: StageChangeDetail) => void;\n\n\t/\n\t Reads the current `onStageChange` runtime-tier callback. Thunk\n\t * so the latest reassigned handler is invoked, not whichever\n\t * handler was current at construction time.\n\t /\n\tgetOnStageChange: () => StageOnChangeHandler \| null \| undefined;\n\n\t/\n\t Optional logger for handler errors. Defaults to `console.error`\n\t * with the same prefix the toolkit used pre-PR-6 so test output\n\t * matches production logs.\n\t /\n\tlogHandlerError?: (error: unknown) => void;\n}\n\nconst defaultLogHandlerError = (error: unknown): void => {\n\tconsole.error(\"[pie-assessment-toolkit] onStageChange handler threw\", error);\n};\n\n/\n Run the toolkit's stage emit pipeline with the suppression gate\n * applied.\n \n - When `isSuppressed()` returns `true`, the helper returns\n * immediately with neither side effect.\n * - Otherwise it dispatches the `pie-stage-change` DOM event first,\n * then invokes `onStageChange(detail)` (preserving the\n * \"DOM-event-then-callback\" ordering pre-PR-6 consumers depend\n * on).\n * - A throwing `onStageChange` handler does not interrupt the DOM\n * event (already fired) and does not propagate up to\n * `stageTracker.enter` (latch state already advanced); the error\n * is logged and swallowed, matching pre-PR-6 behavior.\n \n Returns `true` if the emit pipeline ran (i.e. it was not\n * suppressed); `false` if it was suppressed. Tests use the return\n * value to assert the gate's decision in isolation from the side\n * effects.\n */\nexport function runStageEmitWithSuppression(\n\tcontext: StageEmitGateContext,\n\tdetail: StageChangeDetail,\n): boolean {\n\tif (context.isSuppressed()) {\n\t\treturn false;\n\t}\n\tcontext.dispatchDomEvent(detail);\n\tconst handler = context.getOnStageChange();\n\tif (handler) {\n\t\ttry {\n\t\t\thandler(detail);\n\t\t} catch (error) {\n\t\t\t(context.logHandlerError ?? defaultLogHandlerError)(error);\n\t\t}\n\t}\n\treturn true;\n}\n"]}

package/dist/services/AccessibilityCatalogResolver.d.ts CHANGED Viewed

@@ -1,4 +1,15 @@
 import type { AccessibilityCatalog } from "@pie-players/pie-players-shared/types";
+export type CatalogOwnerKind = "global" | "passage" | "itemModel";
+export interface CatalogOwnerContext {
+    ownerKind: CatalogOwnerKind;
+    assessmentId?: string;
+    sectionId?: string;
+    canonicalItemId?: string;
+    itemId?: string;
+    passageId?: string;
+    modelId?: string;
+}
+export type CatalogLookupContext = CatalogOwnerContext;
 /**
  * Supported accessibility catalog types from QTI 3.0 / APIP
  */
@@ -13,6 +24,8 @@ export interface CatalogLookupOptions {
     language?: string;
     /** Fallback to default language if requested language not found */
     useFallback?: boolean;
+    /** Scope used to resolve local catalog idrefs for rendered content */
+    context?: CatalogLookupContext;
 }
 /**
  * Resolved catalog result
@@ -73,7 +86,9 @@ export interface CatalogStatistics {
 export declare class AccessibilityCatalogResolver {
     private assessmentCatalogs;
     private itemCatalogs;
+    private scopedCatalogs;
     private defaultLanguage;
+    private sanitizedSpokenCache;
     constructor(assessmentCatalogs?: AccessibilityCatalog[], defaultLanguage?: string);
     /**
      * Set the default language for fallback resolution
@@ -87,6 +102,7 @@ export declare class AccessibilityCatalogResolver {
      * Index catalogs into the appropriate map
      */
     private indexCatalogs;
+    registerCatalogs(context: CatalogOwnerContext, catalogs?: AccessibilityCatalog[]): () => void;
     /**
      * Add item-level catalogs (called when rendering a new item)
      */
@@ -105,6 +121,13 @@ export declare class AccessibilityCatalogResolver {
      * Priority: Item-level catalogs take precedence over assessment-level
      */
     getAlternative(catalogId: string, options: CatalogLookupOptions): ResolvedCatalog | null;
+    private resolveCard;
+    private ensureSpokenSanitized;
+    private getOwnerKey;
+    private scopedCatalogEntries;
+    private findScopedCandidates;
+    private isCompatibleOwnerContext;
+    private sanitizeCatalogs;
     /**
      * Find a matching catalog card based on lookup options
      */