@pie-players/pie-section-player 0.3.30 → 0.3.31

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

@@ -1,10 +1,16 @@
-import { BundleType, ItemEntity, createPieLogger } from '@pie-players/pie-players-shared';
-export declare const PRELOAD_TIMEOUT_MS = 15000;
-export declare const PRELOAD_RETRY_COUNT = 1;
-export declare const PRELOAD_RETRY_DELAY_MS = 300;
+import { EsmBackendConfig, IifeBackendConfig, IifeBundleRetryStatus, ItemEntity, createPieLogger } from '@pie-players/pie-players-shared';
+export type IifeBundleRetryStatusHandler = (status: IifeBundleRetryStatus) => void;
+/**
+ * Narrow string union of section-preload pipeline stages reported on
+ * `element-preload-retry` and `element-preload-error` events. Hosts use
+ * this to disambiguate "the renderable's PIE config is invalid" from
+ * "the IIFE bundle won't load" from "the ESM module won't import" from
+ * "the host claimed strategy='preloaded' but didn't pre-register".
+ */
+export type PreloadStage = "validate-config" | "iife-load" | "esm-load" | "preloaded-assert";
 export type ElementPreloadRetryDetail = {
     componentTag: string;
-    stage: string;
+    stage: PreloadStage;
     attempt: number;
     maxRetries: number;
     error: string;
@@ -15,84 +21,95 @@ export type ElementPreloadRetryDetail = {
 };
 export type ElementPreloadErrorDetail = {
     componentTag: string;
-    stage: string;
+    stage: PreloadStage;
     error: string;
     strategy: string;
     bundleType: string | null;
     bundleHost: string;
     renderablesCount: number;
 };
-export declare function getRenderablesSignature(renderables: unknown[]): string;
+/**
+ * Carries which stage of `warmupSectionElements` rejected, so the
+ * `SectionItemsPane.svelte` `usePromise` rejection effect can surface
+ * the right `stage` on the host's `element-preload-error` event.
+ *
+ * Catastrophic adapter rejections (network freeze, bundle timeout) bubble
+ * up through `ensureRegistered` as `ElementLoaderError` and get wrapped
+ * in `PreloadStageError` with stage `"iife-load"` or `"esm-load"`
+ * depending on the requested strategy. Config-contract failures wrap
+ * with stage `"validate-config"`.
+ */
+export declare class PreloadStageError extends Error {
+    readonly name = "PreloadStageError";
+    readonly stage: PreloadStage;
+    readonly cause: unknown;
+    constructor(stage: PreloadStage, cause: unknown);
+}
+export declare function getPreloadLogger(componentTag: string): import('@pie-players/pie-players-shared').PieLogger;
 export declare function getLoaderView(env: Record<string, unknown>): "author" | "delivery";
-export declare function buildPreloadSignature(args: {
-    strategy: string;
-    iifeBundleType: BundleType | null;
-    loaderView: string;
-    esmCdnUrl: string;
-    moduleResolution: "url" | "import-map";
-    bundleHost: string;
-    renderablesSignature: string;
-}): string;
+/**
+ * Stable string signature of a list of renderables, used as a react-key
+ * hint for the composition snapshot plumbed through the layout tree.
+ *
+ * The signature is *not* used for preload dedup anymore — the deep
+ * `ElementLoader` primitive handles that internally. It is retained only
+ * because downstream template props still pass a string identifier
+ * through the customElement boundary.
+ */
+export declare function getRenderablesSignature(renderables: unknown[]): string;
 export declare function formatElementLoadError(stage: string, error: unknown): string;
-export declare function preloadPlayerElements(args: {
-    strategy: string;
-    renderables: ItemEntity[];
-    iifeBundleType: BundleType | null;
-    loaderView: "author" | "delivery";
-    esmCdnUrl: string;
-    moduleResolution: "url" | "import-map";
-    bundleHost: string;
-    onTimeout: () => void;
-    timeoutMs?: number;
-}): Promise<void>;
-export declare function preloadPlayerElementsWithRetry(args: {
-    componentTag: string;
+export declare function toErrorMessage(error: unknown): string;
+/**
+ * Translate a section-player's resolved props into an `ElementLoader`
+ * backend config. Throws when required host-supplied values (bundle host
+ * for IIFE) are missing — callers should surface this as a preload error.
+ *
+ * `onBundleRetryStatus` is wired through to `IifeBackendConfig` for IIFE
+ * strategy so hosts can render "bundle still building" UI while the
+ * adapter polls the bundle service. ESM ignores it.
+ */
+export declare function buildBackendConfigFromProps(args: {
     strategy: string;
-    renderables: ItemEntity[];
-    iifeBundleType: BundleType | null;
-    loaderView: "author" | "delivery";
-    esmCdnUrl: string;
-    moduleResolution: "url" | "import-map";
-    bundleHost: string;
-    timeoutMs?: number;
-    retryCount?: number;
-    retryDelayMs?: number;
-    logger: ReturnType<typeof createPieLogger>;
-    onRetry?: (detail: ElementPreloadRetryDetail) => void;
-    onFinalError?: (detail: ElementPreloadErrorDetail) => void;
-    loadOnce?: (args: {
-        strategy: string;
-        renderables: ItemEntity[];
-        iifeBundleType: BundleType | null;
-        loaderView: "author" | "delivery";
-        esmCdnUrl: string;
-        moduleResolution: "url" | "import-map";
-        bundleHost: string;
-        onTimeout: () => void;
-        timeoutMs?: number;
-    }) => Promise<void>;
-}): Promise<void>;
-export type PlayerPreloadState = {
-    lastPreloadSignature: string;
-    preloadRunToken: number;
-    elementsLoaded: boolean;
-};
-export declare function createPlayerPreloadStateSetter(args: {
-    setLastPreloadSignature: (value: string) => void;
-    setPreloadRunToken: (value: number) => void;
-    setElementsLoaded: (value: boolean) => void;
-}): (next: Partial<PlayerPreloadState>) => void;
-export declare function orchestratePlayerElementPreload(args: {
-    componentTag: string;
+    resolvedPlayerProps: Record<string, unknown>;
+    resolvedPlayerEnv: Record<string, unknown>;
+    iifeBundleHost?: string | null;
+    onBundleRetryStatus?: IifeBundleRetryStatusHandler;
+}): IifeBackendConfig | EsmBackendConfig;
+/**
+ * Returns the bundle type (IIFE) or `null` (ESM, preloaded, empty) that
+ * should be reported on `element-preload-error` events. Host telemetry
+ * needs this as a string to distinguish editor bundles from player bundles.
+ */
+export declare function describeBundleType(backend: IifeBackendConfig | EsmBackendConfig | null): string | null;
+/**
+ * Return the bundle host (IIFE only) for telemetry. Empty string for any
+ * other backend so the host event shape stays stable.
+ */
+export declare function describeBundleHost(backend: IifeBackendConfig | EsmBackendConfig | null): string;
+/**
+ * Pre-warm the aggregate element set for a section before items mount.
+ *
+ * Contract:
+ * - `renderables.length === 0` — no-op. Nothing to load.
+ * - `strategy === "preloaded"` — assert every aggregate tag is already
+ *   registered with `customElements`. Throws `ElementAssertionError`
+ *   (wrapped in `PreloadStageError` with stage `"preloaded-assert"`) on
+ *   any missing tag, surfacing one section-level diagnostic instead of
+ *   N small per-item rejections.
+ * - Otherwise: aggregate tags, build backend, await `ensureRegistered`.
+ *
+ * On any validation or load failure, rejects with a descriptive Error.
+ * The caller (section-player widget) is expected to surface the failure
+ * through an `element-preload-error` event; item-players then attempt
+ * their own registration and typically get a clean per-tag error.
+ */
+export declare function warmupSectionElements(args: {
     strategy: string;
     renderables: ItemEntity[];
-    renderablesSignature: string;
     resolvedPlayerProps: Record<string, unknown>;
     resolvedPlayerEnv: Record<string, unknown>;
     iifeBundleHost?: string | null;
-    getState: () => PlayerPreloadState;
-    setState: (next: Partial<PlayerPreloadState>) => void;
-    onPreloadRetry?: (detail: ElementPreloadRetryDetail) => void;
-    onPreloadError?: (detail: ElementPreloadErrorDetail) => void;
-}): void;
+    logger?: ReturnType<typeof createPieLogger>;
+    onBundleRetryStatus?: IifeBundleRetryStatusHandler;
+}): Promise<void>;
 //# sourceMappingURL=player-preload.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"player-preload.d.ts","sourceRoot":"","sources":["../../../src/components/shared/player-preload.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"player-preload.d.ts","sourceRoot":"","sources":["../../../src/components/shared/player-preload.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,72 @@
+import { RuntimeInputs } from '@pie-players/pie-assessment-toolkit/runtime/internal';
+import { ItemEntity } from '@pie-players/pie-players-shared';
+/**
+ * Resolve the player-runtime view (player tag, attributes, props,
+ * env, strategy) for the section-player host. Stays in section-player
+ * because of the `DEFAULT_PLAYER_DEFINITIONS` dependency, which
+ * side-effect-imports `@pie-players/pie-item-player`.
+ *
+ * Verbatim absorption of the pre-PR-7 `resolvePlayerRuntime` from
+ * `section-player-runtime.ts`; behavior is byte-for-byte identical
+ * (the existing `tests/section-player-runtime.test.ts` test suite
+ * pins this module's export at PR 7).
+ */
+export declare function resolvePlayerRuntime(args: {
+    effectiveRuntime: Record<string, unknown>;
+    playerType: string;
+    env: Record<string, unknown> | null;
+}): {
+    effectivePlayerType: string;
+    resolvedPlayerDefinition: import('../../component-definitions.js').ComponentDefinition;
+    resolvedPlayerTag: string;
+    resolvedPlayerAttributes: Record<string, string>;
+    resolvedPlayerProps: {
+        loaderOptions: {
+            [x: string]: unknown;
+        };
+        loaderConfig?: import('@pie-players/pie-players-shared').LoaderConfig;
+    };
+    resolvedPlayerEnv: Record<string, unknown>;
+    strategy: import('@pie-players/pie-players-shared').ItemPlayerStrategy;
+};
+/**
+ * Map the layout's `renderables` array (composition-model entries) to
+ * a flat `ItemEntity[]`. Used by `section-player-view-state.ts` to
+ * project the kernel's composition snapshot into the per-item card
+ * view. Stays in section-player because the consumer is a
+ * section-player module.
+ */
+export declare function mapRenderablesToItems(renderables: unknown[]): ItemEntity[];
+/**
+ * Section-player host orchestrator. Thin wrapper over the toolkit's
+ * `resolveSectionEngineRuntimeState`, supplying section-player's
+ * local `resolvePlayerRuntime` so the toolkit core never imports
+ * `DEFAULT_PLAYER_DEFINITIONS`.
+ *
+ * Pre-PR-7 callers used the legacy
+ * `resolveSectionPlayerRuntimeState` from `section-player-runtime.ts`;
+ * post-PR-7 the legacy file is deleted and this wrapper is the only
+ * orchestrator entry point.
+ *
+ * Behavior is byte-for-byte identical to the pre-PR-7 implementation
+ * (pinned by `tests/section-player-runtime.test.ts`).
+ */
+export declare function resolveSectionPlayerRuntimeState(args: RuntimeInputs): {
+    effectiveToolsConfig: unknown;
+    effectiveRuntime: import('@pie-players/pie-assessment-toolkit/runtime/internal').EffectiveRuntime;
+    playerRuntime: {
+        effectivePlayerType: string;
+        resolvedPlayerDefinition: import('../../component-definitions.js').ComponentDefinition;
+        resolvedPlayerTag: string;
+        resolvedPlayerAttributes: Record<string, string>;
+        resolvedPlayerProps: {
+            loaderOptions: {
+                [x: string]: unknown;
+            };
+            loaderConfig?: import('@pie-players/pie-players-shared').LoaderConfig;
+        };
+        resolvedPlayerEnv: Record<string, unknown>;
+        strategy: import('@pie-players/pie-players-shared').ItemPlayerStrategy;
+    };
+};
+//# sourceMappingURL=section-player-host-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"section-player-host-runtime.d.ts","sourceRoot":"","sources":["../../../src/components/shared/section-player-host-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAIN,KAAK,aAAa,EAClB,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EAEN,KAAK,UAAU,EACf,MAAM,iCAAiC,CAAC;AAGzC;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAC1C,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACpC;;;;;;;;;;;;;EAiDA;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,CAK1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,aAAa;;;;;;;;;;;;;;;;;EAInE"}

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

@@ -0,0 +1,33 @@
+import { LoadingCompleteHandler, StageChangeHandler } from '@pie-players/pie-assessment-toolkit/runtime/internal';
+export type RuntimeCallbackBridgeChannel = "onStageChange" | "onLoadingComplete";
+export interface RuntimeCallbackBridgeOptions {
+    /** Layout CE host element the engine dispatches DOM events on. */
+    host: HTMLElement;
+    /**
+     * Late-bound accessor for the resolved `runtime.onStageChange`. The
+     * bridge calls this on each `pie-stage-change` event so prop
+     * reassigns mid-cohort still reach the latest handler.
+     */
+    getOnStageChange: () => StageChangeHandler | undefined;
+    /**
+     * Late-bound accessor for the resolved
+     * `runtime.onLoadingComplete`. Called on each
+     * `pie-loading-complete` event for the same reason as
+     * `getOnStageChange`.
+     */
+    getOnLoadingComplete: () => LoadingCompleteHandler | undefined;
+    /**
+     * Optional error sink invoked when a host callback throws. The
+     * kernel pipes this into its logger so `runtime.on*` exceptions
+     * surface in `pie-debug` without breaking the engine's own
+     * dispatch path.
+     */
+    onError?: (channel: RuntimeCallbackBridgeChannel, error: unknown) => void;
+}
+/**
+ * Attach the lockstep callback bridge. Returns a teardown that removes
+ * both DOM listeners; the kernel runs it from its `$effect` cleanup so
+ * subsequent host swaps or unmounts release the listeners cleanly.
+ */
+export declare function attachRuntimeCallbackBridge(options: RuntimeCallbackBridgeOptions): () => void;
+//# sourceMappingURL=section-player-runtime-callbacks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"section-player-runtime-callbacks.d.ts","sourceRoot":"","sources":["../../../src/components/shared/section-player-runtime-callbacks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,KAAK,EACX,sBAAsB,EACtB,kBAAkB,EAClB,MAAM,sDAAsD,CAAC;AAE9D,MAAM,MAAM,4BAA4B,GACrC,eAAe,GACf,mBAAmB,CAAC;AAEvB,MAAM,WAAW,4BAA4B;IAC5C,kEAAkE;IAClE,IAAI,EAAE,WAAW,CAAC;IAClB;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,kBAAkB,GAAG,SAAS,CAAC;IACvD;;;;;OAKG;IACH,oBAAoB,EAAE,MAAM,sBAAsB,GAAG,SAAS,CAAC;IAC/D;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,4BAA4B,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1E;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,4BAA4B,GACnC,MAAM,IAAI,CA8BZ"}

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

@@ -1 +1 @@
-{"version":3,"file":"section-player-view-state.d.ts","sourceRoot":"","sources":["../../../src/components/shared/section-player-view-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAM1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAI9D,MAAM,MAAM,yBAAyB,GAAG;IACvC,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAC9C,KAAK,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACxC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAMF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,GAAG,uBAAuB,CAI7E;AAED,wBAAgB,+BAA+B,CAC9C,gBAAgB,EAAE,uBAAuB,GACvC,yBAAyB,CAS3B;AAED,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,KAAK,GACV,yBAAyB,CAE3B;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,GAAG,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,cAAc,EAAE,MAAM,CAAC;CACvB,GAAG,mBAAmB,CAatB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACzC,IAAI,EAAE,UAAU,CAAC;IACjB,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,cAAc,EAAE,MAAM,CAAC;CACvB,GAAG,mBAAmB,CAYtB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACxC,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,IAAI,EAAE,UAAU,CAAC;CACjB,GAAG,MAAM,CAET"}
+{"version":3,"file":"section-player-view-state.d.ts","sourceRoot":"","sources":["../../../src/components/shared/section-player-view-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAM1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAI9D,MAAM,MAAM,yBAAyB,GAAG;IACvC,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAC9C,KAAK,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACxC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,GAAG,uBAAuB,CAI7E;AAED,wBAAgB,+BAA+B,CAC9C,gBAAgB,EAAE,uBAAuB,GACvC,yBAAyB,CAS3B;AAED,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,KAAK,GACV,yBAAyB,CAE3B;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,GAAG,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,cAAc,EAAE,MAAM,CAAC;CACvB,GAAG,mBAAmB,CAiBtB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACzC,IAAI,EAAE,UAAU,CAAC;IACjB,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,cAAc,EAAE,MAAM,CAAC;CACvB,GAAG,mBAAmB,CAWtB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACxC,gBAAgB,EAAE,uBAAuB,CAAC;IAC1C,IAAI,EAAE,UAAU,CAAC;CACjB,GAAG,MAAM,CAET"}

package/dist/contracts/host-hooks.d.ts

@@ -1,4 +1,24 @@
 import { SectionPlayerCardTitleFormatter } from './card-title-formatters.js';
+/**
+ * Host-extension hook contract for the section-player layout custom elements.
+ *
+ * Hosts pass a `SectionPlayerHostHooks` value via the `host-hooks` attribute
+ * (or the `hostHooks` prop, mirroring per the two-tier policy in
+ * {@link ../../ARCHITECTURE.md}) on `<pie-section-player-*>` to override
+ * formatter / decoration behavior that the engine intentionally leaves to the
+ * host. Each hook is optional; omitted hooks fall back to documented defaults.
+ *
+ * Today the contract has a single member (`cardTitleFormatter`). The shape is
+ * intentionally a struct, not a single callback prop, so future host-supplied
+ * formatters / decorators can be added without renaming the surface.
+ *
+ * The naming/expansion of this contract is part of the
+ * "Coherent Options Surface" review; the broader expansion (additional hook
+ * fields produced as the section host runtime engine consolidates) is owned
+ * by the M7 follow-up plan in `coherent_options_surface_review_0133a7cd.plan.md`.
+ * Keeping the current name (`SectionPlayerHostHooks`) is deliberate so that
+ * additions there do not require a breaking rename across the layout CEs.
+ */
 export type SectionPlayerHostHooks = {
     cardTitleFormatter?: SectionPlayerCardTitleFormatter;
 };

package/dist/contracts/host-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-hooks.d.ts","sourceRoot":"","sources":["../../src/contracts/host-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAElF,MAAM,MAAM,sBAAsB,GAAG;IACpC,kBAAkB,CAAC,EAAE,+BAA+B,CAAC;CACrD,CAAC"}
+{"version":3,"file":"host-hooks.d.ts","sourceRoot":"","sources":["../../src/contracts/host-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAElF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACpC,kBAAkB,CAAC,EAAE,+BAA+B,CAAC;CACrD,CAAC"}

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

@@ -1,8 +1,8 @@
 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" | "splitPaneCollapseStrategy" | "enabledTools" | "itemToolbarTools" | "passageToolbarTools";
-export type SectionPlayerAdvancedPropName = "runtime" | "playerType" | "player" | "lazyInit" | "tools" | "accessibility" | "coordinator" | "createSectionController" | "isolation" | "env" | "iifeBundleHost" | "toolRegistry" | "sectionHostButtons" | "itemHostButtons" | "passageHostButtons" | "hooks";
+export type SectionPlayerBasicPropName = "assessmentId" | "section" | "sectionId" | "attemptId" | "debug" | "showToolbar" | "toolbarPosition" | "narrowLayoutBreakpoint" | "contentMaxWidthNoPassage" | "contentMaxWidthWithPassage" | "splitPaneMinRegionWidth" | "splitPaneCollapseStrategy" | "enabledTools";
+export type SectionPlayerAdvancedPropName = "runtime" | "playerType" | "player" | "lazyInit" | "tools" | "accessibility" | "coordinator" | "env" | "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 = {

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

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

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

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

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

@@ -1,15 +1,96 @@
+/**
+ * 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`.
+ *
+ * **Kernel-side Svelte forwards (not engine-routed).** The
+ * composition / session / runtime-tier family
+ * (`composition-changed`, `session-changed`, `runtime-owned`,
+ * `runtime-inherited`) is forwarded by the kernel's Svelte
+ * `createEventDispatcher` from `<pie-section-player-base>` events; it
+ * does not flow through the engine. This split is intentional: the
+ * engine owns lifecycle and error reporting, while composition /
+ * session forwarding stays in section-player because the shape is
+ * section-player-specific and the engine has no opinion on it.
+ *
+ * **`framework-error` single-emit on the layout host (compat sweep).**
+ * `<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. The single-emit contract is pinned by
+ * `tests/section-player-framework-error-dual-emit.test.ts`. The
+ * previous dual-emit was removed in the broad architecture review
+ * compat sweep.
+ *
+ * **Removed in the broad architecture review compat sweep.** The
+ * deprecated readiness aliases (`readiness-change`,
+ * `interaction-ready`, `ready`) and their `legacy-event-bridge.ts`
+ * are gone. Hosts that previously listened for them migrate to:
+ *   - `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`.
+ *
+ * The deprecated `section-controller-ready` Svelte/DOM event was
+ * also removed. Hosts that previously listened for it migrate to
+ * `waitForSectionController(timeoutMs)` / `getSectionController()`
+ * on the layout CE, or filter `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";
-    readonly runtimeError: "runtime-error";
+    /**
+     * 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";
-    readonly sectionControllerReady: "section-controller-ready";
-    readonly readinessChange: "readiness-change";
-    readonly interactionReady: "interaction-ready";
-    readonly ready: "ready";
+    /**
+     * 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 when every item in the section has finished loading
+     * (`loadedCount === itemCount`), gated by the engine's
+     * `interactive` state.
+     */
+    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 is named after the deprecated `readiness-change` event for
+ * backward compatibility with consumers that imported it via the
+ * kernel's `selectReadiness()` selector — the *event name* is gone,
+ * but the readiness payload itself is still the canonical shape.
+ */
 export type SectionPlayerReadinessPhase = "bootstrapping" | "interaction-ready" | "loading" | "ready" | "error";
 export type SectionPlayerReadinessChangeDetail = {
     phase: SectionPlayerReadinessPhase;
@@ -17,9 +98,4 @@ export type SectionPlayerReadinessChangeDetail = {
     allLoadingComplete: boolean;
     reason?: string;
 };
-export type SectionPlayerControllerReadyDetail = {
-    sectionId: string;
-    attemptId?: string;
-    controller: unknown;
-};
 //# sourceMappingURL=public-events.d.ts.map

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

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

package/dist/contracts/stages.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Re-export shim for the canonical stage vocabulary.
+ *
+ * The contract types and tracker primitive live in
+ * `@pie-players/pie-players-shared/pie` so both
+ * `<pie-section-player-*>` and `<pie-assessment-toolkit>` import the
+ * same source of truth (M6 Phase C).
+ */
+export { STAGES, applicableStages, stageOrdinal, } from '@pie-players/pie-players-shared/pie';
+export type { LoadingCompleteDetail, Stage, StageChangeDetail, StageSourceCe, StageStatus, } from '@pie-players/pie-players-shared/pie';
+//# sourceMappingURL=stages.d.ts.map

package/dist/contracts/stages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stages.d.ts","sourceRoot":"","sources":["../../src/contracts/stages.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACN,MAAM,EACN,gBAAgB,EAChB,YAAY,GACZ,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACX,qBAAqB,EACrB,KAAK,EACL,iBAAiB,EACjB,aAAa,EACb,WAAW,GACX,MAAM,qCAAqC,CAAC"}

package/dist/pie-section-player.d.ts

@@ -1,10 +1,10 @@
 export type { SectionPlayerLayoutContract, SectionPlayerLayoutName, SectionPlayerLayoutCapability, SectionPlayerBasicPropName, SectionPlayerAdvancedPropName, SectionPlayerLayoutPropName, SectionPlayerLayoutCommandName, } from './contracts/layout-contract.js';
-export type { SectionPlayerPublicEventName, SectionPlayerReadinessPhase, SectionPlayerReadinessChangeDetail, SectionPlayerControllerReadyDetail, } from './contracts/public-events.js';
+export type { SectionPlayerPublicEventName, SectionPlayerReadinessPhase, SectionPlayerReadinessChangeDetail, } from './contracts/public-events.js';
 export { SECTION_PLAYER_PUBLIC_EVENTS } from './contracts/public-events.js';
 export type { SectionPlayerRuntimeHostContract, SectionPlayerNavigationSnapshot, SectionPlayerSnapshot, } from './contracts/runtime-host-contract.js';
 export { SPLITPANE_LAYOUT_CONTRACT, TABBED_LAYOUT_CONTRACT, VERTICAL_LAYOUT_CONTRACT, } from './contracts/layout-parity-metadata.js';
 export type { ReadinessPolicyAdapter, SectionPlayerPolicies, SectionPlayerReadinessPolicy, SectionPlayerPreloadPolicy, SectionPlayerFocusPolicy, SectionPlayerAutoFocusStrategy, SectionPlayerTelemetryPolicy, } from './policies/types.js';
-export { DEFAULT_FOCUS_POLICY, DEFAULT_SECTION_PLAYER_POLICIES, resolveAutoFocusStrategy, } from './policies/index.js';
+export { DEFAULT_FOCUS_POLICY, DEFAULT_SECTION_PLAYER_POLICIES, isPreloadEnabled, isTelemetryEnabled, resolveAutoFocusStrategy, } from './policies/index.js';
 export type { SectionPlayerCardTitleContext, SectionPlayerCardTitleFormatter, SectionPlayerItemTitleContext, SectionPlayerPassageTitleContext, } from './contracts/card-title-formatters.js';
 export type { SectionPlayerHostHooks } from './contracts/host-hooks.js';
 //# sourceMappingURL=pie-section-player.d.ts.map

package/dist/pie-section-player.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pie-section-player.d.ts","sourceRoot":"","sources":["../src/pie-section-player.ts"],"names":[],"mappings":"AAAA,OAAO,+CAA+C,CAAC;AACvD,OAAO,8CAA8C,CAAC;AACtD,OAAO,4CAA4C,CAAC;AACpD,OAAO,+CAA+C,CAAC;AACvD,OAAO,kDAAkD,CAAC;AAC1D,OAAO,gDAAgD,CAAC;AACxD,OAAO,mDAAmD,CAAC;AAC3D,OAAO,2CAA2C,CAAC;AACnD,OAAO,iDAAiD,CAAC;AAEzD,YAAY,EACX,2BAA2B,EAC3B,uBAAuB,EACvB,6BAA6B,EAC7B,0BAA0B,EAC1B,6BAA6B,EAC7B,2BAA2B,EAC3B,8BAA8B,GAC9B,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACX,4BAA4B,EAC5B,2BAA2B,EAC3B,kCAAkC,EAClC,kCAAkC,GAClC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,YAAY,EACX,gCAAgC,EAChC,+BAA+B,EAC/B,qBAAqB,GACrB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACN,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,GACxB,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACX,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,0BAA0B,EAC1B,wBAAwB,EACxB,8BAA8B,EAC9B,4BAA4B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,oBAAoB,EACpB,+BAA+B,EAC/B,wBAAwB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC7B,gCAAgC,GAChC,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"pie-section-player.d.ts","sourceRoot":"","sources":["../src/pie-section-player.ts"],"names":[],"mappings":"AAAA,OAAO,+CAA+C,CAAC;AACvD,OAAO,8CAA8C,CAAC;AACtD,OAAO,4CAA4C,CAAC;AACpD,OAAO,+CAA+C,CAAC;AACvD,OAAO,kDAAkD,CAAC;AAC1D,OAAO,gDAAgD,CAAC;AACxD,OAAO,mDAAmD,CAAC;AAC3D,OAAO,2CAA2C,CAAC;AACnD,OAAO,iDAAiD,CAAC;AAEzD,YAAY,EACX,2BAA2B,EAC3B,uBAAuB,EACvB,6BAA6B,EAC7B,0BAA0B,EAC1B,6BAA6B,EAC7B,2BAA2B,EAC3B,8BAA8B,GAC9B,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACX,4BAA4B,EAC5B,2BAA2B,EAC3B,kCAAkC,GAClC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,YAAY,EACX,gCAAgC,EAChC,+BAA+B,EAC/B,qBAAqB,GACrB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACN,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,GACxB,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACX,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,0BAA0B,EAC1B,wBAAwB,EACxB,8BAA8B,EAC9B,4BAA4B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,oBAAoB,EACpB,+BAA+B,EAC/B,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,6BAA6B,EAC7B,+BAA+B,EAC/B,6BAA6B,EAC7B,gCAAgC,GAChC,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC"}