@pie-players/pie-section-player 0.3.74 → 1.0.0-beta.0

package/dist/browser/chunks/tool-host-contract-b93b482c.js

@@ -1 +0,0 @@
-import{t as r}from"./defineProperty-a20a667d.js";function d(t,e=!1){if(typeof t=="boolean")return t;if(t==null)return e;const s=String(t).trim().toLowerCase();return s===""?e:["false","0","off","no"].includes(s)?!1:["true","1","on","yes"].includes(s)?!0:!!s}function v(t){return t!==null&&d(t,!0)}var f=(t,e)=>{const s=t.$$p_d;return s?Object.entries(s).some(([n,o])=>o.type==="Boolean"&&(o.attribute??n.toLowerCase())===e):!1};function _(t){const e=t.prototype.attributeChangedCallback;return class extends t{attributeChangedCallback(s,n,o){const i=o!==null&&f(this,s)&&!v(o)?null:o;e?.call(this,s,n,i)}}}var b=class extends Event{constructor(t,e,s,n){super("context-request",{bubbles:!0,composed:!0}),r(this,"context",void 0),r(this,"contextTarget",void 0),r(this,"callback",void 0),r(this,"subscribe",void 0),this.context=t,this.contextTarget=e,this.callback=s,this.subscribe=n??!1}},A=class extends Event{constructor(t,e){super("context-provider",{bubbles:!0,composed:!0}),r(this,"context",void 0),r(this,"contextTarget",void 0),this.context=t,this.contextTarget=e}},x=class{constructor(t,e){r(this,"host",void 0),r(this,"context",void 0),r(this,"subscribe",void 0),r(this,"onValue",void 0),r(this,"isConnected",!1),r(this,"unsubscribe",void 0),r(this,"currentValue",void 0),r(this,"handleValue",(s,n)=>{n!==this.unsubscribe&&(this.unsubscribe?.(),this.unsubscribe=n),!this.subscribe&&this.unsubscribe&&(this.unsubscribe(),this.unsubscribe=void 0),this.currentValue=s,this.onValue?.(s)}),this.host=t,this.context=e.context,this.subscribe=e.subscribe??!0,this.onValue=e.onValue}connect(){this.isConnected||(this.isConnected=!0,this.requestValue())}disconnect(){this.isConnected&&(this.isConnected=!1,this.unsubscribe?.(),this.unsubscribe=void 0)}get value(){return this.currentValue}requestValue(){this.host.dispatchEvent(new b(this.context,this.host,this.handleValue,this.subscribe))}},B=(t,e)=>{let s;return t.dispatchEvent(new b(e,t,n=>{s=n},!1)),s},C=50,m=200,a=(t,e,s)=>{let n=!1;const o=new x(t,{context:e,subscribe:!0,onValue:c=>{n=!0,s(c)}});o.connect();const i=c=>{c.context===e&&o.requestValue()};t.addEventListener("context-provider",i);let l=0;const h=globalThis.setInterval(()=>{if(n||l>=m){globalThis.clearInterval(h);return}l+=1,o.requestValue()},C);return()=>{globalThis.clearInterval(h),t.removeEventListener("context-provider",i),o.disconnect()}},u=t=>t,T=u(Symbol.for("pie.assessmentToolkit.runtimeContext")),q=u(Symbol.for("pie.assessmentToolkit.hostRuntimeContext")),p=u(Symbol.for("pie.assessmentToolkit.shellContext")),R=u(Symbol.for("pie.assessmentToolkit.regionScopeContext"));function g(t,e){return a(t,T,e)}function E(t,e){return a(t,p,e)}function k(t,e){return a(t,R,e)}var V={bubbles:!0,composed:!0,cancelable:!1};function S(t,e,s={}){return new CustomEvent(t,{detail:e,...V,...s})}function I(t,e,s,n={}){return t.dispatchEvent(S(e,s,n))}function P(t,e){return g(t,e)}function L(t,e){return E(t,e)}function O(t,e){return k(t,e)}function w(t,e){let s=null;function n(){s?.coordinator.unregisterTool(s.toolId),s=null}return{sync(o,i){!o||!i||s?.coordinator===o&&s.toolId===i||(n(),o.registerTool(i,t,void 0,e),s={coordinator:o,toolId:i})},release:n}}export{d as _,I as a,E as c,u as d,a as f,_ as g,b as h,w as i,R as l,A as m,P as n,k as o,B as p,L as r,g as s,O as t,p as u};

package/dist/components/item-shell-element.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/components/shared/shell-registration.d.ts

@@ -1,55 +0,0 @@
-/**
- * Registration dispatch for the item and passage shells.
- *
- * Registration is a statement of fact to the runtime, and the runtime takes it
- * literally: a `pie-register` makes the toolkit unregister and re-register the
- * content's accessibility catalogs, re-run `sectionEngine.register`, and
- * re-notify the section controller. Both shells used to dispatch it from the
- * same effect that attached their listeners, with `pie-unregister` in that
- * effect's cleanup — so every re-run announced a teardown and a rebuild of state
- * that had not moved, and between the two the content had no catalogs at all.
- *
- * Those effects re-run on prop changes, and a shell's props are re-applied
- * whenever its parent card's template updates. That made the dispatch the far
- * half of a cycle: a reader that re-renders in response to a catalog change
- * re-applies a shell's props, which re-registers, which changes catalogs again.
- * It shipped once at roughly a thousand rounds per item, ending in Svelte
- * abandoning the update at its depth limit with the DOM half-applied — and every
- * assertion about the rendered output passed while it was happening, because the
- * elements were all present.
- *
- * So the dispatcher keeps the last identity it announced and says nothing when
- * the next one matches.
- */
-export type ShellRegistrationIdentity = {
-    kind: "item" | "passage";
-    host: HTMLElement;
-    itemId: string;
-    canonicalItemId: string;
-    contentKind: string;
-    item: unknown;
-};
-export type ShellRegistrationDispatcher = {
-    /**
-     * Announce `identity` if it says anything new, and retire the live
-     * registration when there is nothing left to describe — a shell without a host
-     * or an id no longer stands for content, and leaving its registration behind
-     * would strand it in the runtime.
-     *
-     * Never dispatches `pie-unregister` before a re-register: both registration
-     * paths in the toolkit are keyed by element and replace what is there, so the
-     * unregister only ever created the gap.
-     */
-    sync: (identity: ShellRegistrationIdentity | null) => void;
-    /**
-     * Retire the live registration, replaying the identity it was made under
-     * rather than whatever the props say now — by the time a registration is
-     * retired the props may already describe its replacement, and unregistering
-     * under the new identity would leave the old one live.
-     *
-     * Belongs in a teardown that runs on teardown only. Attaching it to an effect
-     * that re-runs on prop changes is what made the churn.
-     */
-    retire: () => void;
-};
-export declare function createShellRegistrationDispatcher(): ShellRegistrationDispatcher;

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

@@ -1,17 +0,0 @@
-import { SectionPlayerPublicEventName } from './public-events.js';
-export type SectionPlayerLayoutName = "splitpane" | "vertical" | "tabbed";
-export type SectionPlayerLayoutCapability = "items-pane" | "passages-pane" | "section-toolbar" | "item-toolbar" | "passage-toolbar" | "readiness-events" | "navigation-events";
-export type SectionPlayerBasicPropName = "assessmentId" | "section" | "sectionId" | "attemptId" | "debug" | "showToolbar" | "toolbarPosition" | "narrowLayoutBreakpoint" | "contentMaxWidthNoPassage" | "contentMaxWidthWithPassage" | "splitPaneMinRegionWidth" | "splitPaneInitialPassageWidth" | "splitPaneCollapseStrategy";
-export type SectionPlayerAdvancedPropName = "runtime" | "iifeBundleHost" | "toolRegistry" | "sectionHostButtons" | "itemHostButtons" | "passageHostButtons" | "policies" | "toolConfigStrictness" | "hooks" | "onFrameworkError" | "onStageChange" | "onLoadingComplete";
-export type SectionPlayerLayoutPropName = SectionPlayerBasicPropName | SectionPlayerAdvancedPropName;
-export type SectionPlayerLayoutCommandName = "getSnapshot" | "selectComposition" | "selectNavigation" | "selectReadiness" | "navigateTo" | "navigateNext" | "navigatePrevious" | "getSectionController" | "waitForSectionController";
-export type SectionPlayerLayoutContract = {
-    version: 1;
-    layout: SectionPlayerLayoutName;
-    props: readonly SectionPlayerLayoutPropName[];
-    recommendedBasicProps: readonly SectionPlayerBasicPropName[];
-    advancedEscapeHatchProps: readonly SectionPlayerAdvancedPropName[];
-    events: readonly SectionPlayerPublicEventName[];
-    commands: readonly SectionPlayerLayoutCommandName[];
-    capabilities: readonly SectionPlayerLayoutCapability[];
-};

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

@@ -1,4 +0,0 @@
-import { SectionPlayerLayoutContract } from './layout-contract.js';
-export declare const SPLITPANE_LAYOUT_CONTRACT: SectionPlayerLayoutContract;
-export declare const VERTICAL_LAYOUT_CONTRACT: SectionPlayerLayoutContract;
-export declare const TABBED_LAYOUT_CONTRACT: SectionPlayerLayoutContract;

package/dist/contracts/layout-parity-metadata.js

@@ -1,87 +0,0 @@
-import { SECTION_PLAYER_PUBLIC_EVENTS as e } from "./public-events.js";
-var a = [
-  "assessmentId",
-  "section",
-  "sectionId",
-  "attemptId",
-  "debug",
-  "showToolbar",
-  "toolbarPosition",
-  "narrowLayoutBreakpoint",
-  "contentMaxWidthNoPassage",
-  "contentMaxWidthWithPassage",
-  "splitPaneMinRegionWidth",
-  "splitPaneInitialPassageWidth",
-  "splitPaneCollapseStrategy"
-], o = [
-  "runtime",
-  "iifeBundleHost",
-  "toolRegistry",
-  "sectionHostButtons",
-  "itemHostButtons",
-  "passageHostButtons",
-  "policies",
-  "toolConfigStrictness",
-  "hooks",
-  "onFrameworkError",
-  "onStageChange",
-  "onLoadingComplete"
-], t = [...a, ...o], s = [
-  e.runtimeOwned,
-  e.runtimeInherited,
-  e.frameworkError,
-  e.compositionChanged,
-  e.sessionChanged,
-  e.stageChange,
-  e.loadingComplete
-], n = [
-  "getSnapshot",
-  "selectComposition",
-  "selectNavigation",
-  "selectReadiness",
-  "navigateTo",
-  "navigateNext",
-  "navigatePrevious",
-  "getSectionController",
-  "waitForSectionController"
-], i = [
-  "items-pane",
-  "passages-pane",
-  "section-toolbar",
-  "item-toolbar",
-  "passage-toolbar",
-  "readiness-events",
-  "navigation-events"
-], p = {
-  version: 1,
-  layout: "splitpane",
-  props: t,
-  recommendedBasicProps: a,
-  advancedEscapeHatchProps: o,
-  events: s,
-  commands: n,
-  capabilities: i
-}, c = {
-  version: 1,
-  layout: "vertical",
-  props: t,
-  recommendedBasicProps: a,
-  advancedEscapeHatchProps: o,
-  events: s,
-  commands: n,
-  capabilities: i
-}, d = {
-  version: 1,
-  layout: "tabbed",
-  props: t,
-  recommendedBasicProps: a,
-  advancedEscapeHatchProps: o,
-  events: s,
-  commands: n,
-  capabilities: i
-};
-export {
-  p as SPLITPANE_LAYOUT_CONTRACT,
-  d as TABBED_LAYOUT_CONTRACT,
-  c as VERTICAL_LAYOUT_CONTRACT
-};

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

@@ -1,92 +0,0 @@
-/**
- * Section-player layout-CE public DOM event vocabulary.
- *
- * **Engine routing (M7).** The *stage / loading-complete /
- * framework-error* family is dispatched on the layout CE host by the
- * section runtime engine
- * (`@pie-players/pie-assessment-toolkit/runtime/engine`) — not by an
- * in-CE `$effect` cluster. The kernel attaches the engine to the host
- * (`engine.attachHost({ host, sourceCe, frameworkErrorBus })`), and
- * the engine's DOM-event bridge dispatches `pie-stage-change`,
- * `pie-loading-complete`, and `framework-error`.
- *
- * **Toolkit events (not engine-routed).** The composition / session /
- * runtime-tier family (`composition-changed`, `session-changed`,
- * `runtime-owned`, `runtime-inherited`) is dispatched by
- * `<pie-assessment-toolkit>` and bubbles through the layout CE host to
- * `document`; no section-player component re-dispatches it, so each
- * listener receives each dispatch once. It does not flow through the
- * engine: the engine owns lifecycle and error reporting, and has no
- * opinion on composition or session shape.
- *
- * **`framework-error` single-emit on the layout host.**
- * `<pie-assessment-toolkit>` nested inside a layout CE still
- * dispatches its own `framework-error` (with `bubbles: true,
- * composed: true`) so direct toolkit consumers keep working. The
- * kernel's `handleFrameworkError` listener intercepts that bubbled
- * emit at `<pie-section-player-base>` and calls
- * `event.stopPropagation()`, leaving the engine-bridge emit on the
- * layout host as the single canonical DOM surface for
- * section-player consumers. `tests/section-player-event-delivery.spec.ts`
- * pins one delivery per error on the layout host and none on
- * `document`.
- *
- * Lifecycle should be consumed through canonical events:
- *   - `readiness-change` → `pie-stage-change` (the readiness phase
- *     is also reachable via `selectReadiness()` /
- *     `getSnapshot().readiness`).
- *   - `interaction-ready` → `pie-stage-change` filtered on
- *     `detail.stage === "interactive"`.
- *   - `ready` → `pie-loading-complete`.
- *
- * Controller readiness is available through
- * `waitForSectionController(timeoutMs)` / `getSectionController()` on the
- * layout CE, or by filtering `pie-stage-change` for
- * `detail.stage === "engine-ready"`.
- *
- * Source of truth for the names: `players-shared/src/pie/stages.ts`
- * and the `SectionEngineOutput` discriminator in
- * `assessment-toolkit/src/runtime/core/engine-output.ts`.
- */
-export declare const SECTION_PLAYER_PUBLIC_EVENTS: {
-    readonly runtimeOwned: "runtime-owned";
-    readonly runtimeInherited: "runtime-inherited";
-    /**
-     * Engine-routed (M7). Dispatched by
-     * `framework-error-bridge.ts` on the layout CE host whenever the
-     * engine receives a `framework-error` input. See class doc on
-     * `FrameworkErrorBus` for the back-pressure / fan-out semantics.
-     */
-    readonly frameworkError: "framework-error";
-    readonly compositionChanged: "composition-changed";
-    readonly sessionChanged: "session-changed";
-    /**
-     * Engine-routed (M7). One DOM event family carries every stage
-     * transition (`composed` → `engine-ready` → `interactive` →
-     * `disposed`) with the discriminator in `event.detail.stage`.
-     * Dispatched by the engine's `dom-event-bridge.ts` on each
-     * `SectionEngineOutput` of kind `stage-change`. See
-     * `packages/players-shared/src/pie/stages.ts`.
-     */
-    readonly stageChange: "pie-stage-change";
-    /**
-     * Engine-routed (M7). Companion to `stageChange`. Fires once per
-     * cohort, once the section controller is ready and the section's
-     * element pre-warm has resolved for the current items: the same
-     * condition that moves a layout element to `interactive`.
-     */
-    readonly loadingComplete: "pie-loading-complete";
-};
-export type SectionPlayerPublicEventName = (typeof SECTION_PLAYER_PUBLIC_EVENTS)[keyof typeof SECTION_PLAYER_PUBLIC_EVENTS];
-/**
- * Readiness phase reported by the engine's readiness derivation. The
- * type preserves the readiness payload shape used by
- * `selectReadiness()`.
- */
-export type SectionPlayerReadinessPhase = "bootstrapping" | "interaction-ready" | "loading" | "ready" | "error";
-export type SectionPlayerReadinessChangeDetail = {
-    phase: SectionPlayerReadinessPhase;
-    interactionReady: boolean;
-    allLoadingComplete: boolean;
-    reason?: string;
-};

package/dist/contracts/public-events.js

@@ -1,12 +0,0 @@
-var e = {
-  runtimeOwned: "runtime-owned",
-  runtimeInherited: "runtime-inherited",
-  frameworkError: "framework-error",
-  compositionChanged: "composition-changed",
-  sessionChanged: "session-changed",
-  stageChange: "pie-stage-change",
-  loadingComplete: "pie-loading-complete"
-};
-export {
-  e as SECTION_PLAYER_PUBLIC_EVENTS
-};

package/dist/policies/guards.d.ts

@@ -1,2 +0,0 @@
-import { SectionPlayerPublicEventName } from '../contracts/public-events.js';
-export declare function assertPublicEventName(eventName: string): asserts eventName is SectionPlayerPublicEventName;