@cyberart-io/engine 0.0.9 → 0.0.11

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to `@cyberart-io/engine`. Each entry links the guide in `docs/` and the pull request on [cyberart-io/cyberart.io](https://github.com/cyberart-io/cyberart.io). Versions before 0.0.9 predate this file.
 
+## Unreleased
+
+## 0.0.11 — 2026-09-06
+
+Production-scenario overlap precedence and transactional reload. Additive: existing exports keep their signatures.
+
+### Added
+
+- **Transactional production-scenario reload** — `reload` preflights the sidecar envelope, optional `host.validateRestoreState`, projected input surface, and every present module sidecar before mutation. Apply is one transaction with rollback on failure; invalid sidecars localize at subsystem boundaries (`invalid-visual-sidecar`, `invalid-semantic-sidecar`, `invalid-binding-sidecar`, `invalid-sequence-sidecar`, `invalid-audio-sidecar`, `invalid-host-sidecar`). Legacy envelopes omitting sidecar keys remain compatible. [docs/production-scenario.md](docs/production-scenario.md) · [#60](https://github.com/cyberart-io/cyberart.io/pull/60)
+
+- **Overlap precedence on production input surface** — `ProductionScenarioControl.priority` resolves intersecting regions deterministically in browser and headless. Equal or missing priority on an overlapping pair still fails closed at boundary `input` (`ambiguous-geometry`). Coordinate clicks record `observation.inputHitTest` (selected and rejected control ids). [docs/production-scenario.md](docs/production-scenario.md) · [#59](https://github.com/cyberart-io/cyberart.io/pull/59)
+
+## 0.0.10 — 2026-09-06
+
+Production-scenario follow-ups after the 0.0.9 Animation Framework cut. Additive: existing exports keep their signatures.
+
+### Added
+
+- **Dynamic host geometry and controls** — production scenarios project the active input surface from host state (`host.projectInputSurface`). Accepted reduces and reload rebuild visible/focusable controls and the geometry document together. Removed controls are not clickable or focusable. Browser harness `setGeometry` updates CSS hit-testing. Missing, overlapping, or stale geometry fails closed at boundary `input` (`invalid-geometry` / `ambiguous-geometry` / `stale-geometry`). Reload syncs the input surface without `applyPresentation()` (no sequence replay). [docs/production-scenario.md](docs/production-scenario.md) · [docs/browser-harness.md](docs/browser-harness.md) · [#49](https://github.com/cyberart-io/cyberart.io/pull/49)
+
+- **Runtime reduced-motion propagation** — a production-scenario `reducedMotion` step (and `setReducedMotion`) updates browser/a11y plus visual, sequence, and audio/reduced-sensory policy. Active sequences **continue** with compiled durations; future `playSequence` uses the new flag. Semantic layers are a declared no-op. Evidence records `observation.reducedMotion` / `reducedMotionPropagation`. Construction-time `matrix.reducedMotion` is unchanged. [docs/production-scenario.md](docs/production-scenario.md) · [#48](https://github.com/cyberart-io/cyberart.io/pull/48)
+
+- **Audio cue snapshot restore** — versioned `schemaVersion` `1` sidecar on `createAudioCueTimeline` / `createHeadlessAudioAdapter`. `restore()` validates JSON before mutation; unknown schema, unknown cue ids, or malformed state fail closed. Mute restores; unlock is observation-only. Production-scenario `reload` restores `hostState.audio` last (no second play) and reports `observation.audioRestoreOk` / `invalid-audio-sidecar`. [docs/audio.md](docs/audio.md) · [docs/production-scenario.md](docs/production-scenario.md) · [#46](https://github.com/cyberart-io/cyberart.io/pull/46)
+
+- **Production scenario host-owned audio** — optional `hostAudio` observer on `createProductionScenarioRunner`. A host that already owns a production audio controller reports invocation / completion / failure / skip / fallback (plus captions and envelope identity) without duplicating the beat as a presentation sequence. Evidence is in `traces.hostAudio`; `observation.audioInvoked` follows host `invoked` / `completed` only (same as sequence scheduled/started); `audioFailed` and captions still merge skip / fallback / failed rows. Invalid adapters fail closed at boundary `audio` (`invalid-host-audio`). [docs/production-scenario.md](docs/production-scenario.md) · [#45](https://github.com/cyberart-io/cyberart.io/pull/45)
+
 ## 0.0.9 — 2026-09-05
 
 Eleven Animation Framework modules. All are additive: no existing export changed signature, and the `@cyberart-io/engine` / `@cyberart-io/engine/headless` entries export the same new API. Every module ships a `snapshot()` / `restore()` pair that validates JSON before mutating, and typed `*.state.*` / `*.diagnostic.*` event contracts for the router.

package/dist/headless.d.ts

@@ -1678,6 +1678,7 @@ type PlayCueResult = {
  */
 
 declare const AUDIO_CUE_EVENTS: readonly ["audio.cue.scheduled", "audio.cue.started", "audio.cue.skipped", "audio.cue.failed"];
+declare const AUDIO_CUE_SNAPSHOT_SCHEMA_VERSION: 1;
 type AudioCueEventType = (typeof AUDIO_CUE_EVENTS)[number];
 type AudioCueSkipReason = 'reduced-sensory' | 'muted' | 'unauthorized';
 type AudioCueFailReason = 'asset-failed' | 'torn-down' | 'invalid';
@@ -1695,6 +1696,8 @@ type AudioCueView = CueView & {
     participantId?: string;
     priority: number;
     audioPhase: 'scheduled' | 'started' | 'skipped' | 'failed' | 'completed';
+    /** Original play spec; omitted when the cue was not repeating. */
+    repeat?: CueRepeatPolicy;
 };
 type AudioCueEvent = {
     type: AudioCueEventType;
@@ -1708,11 +1711,28 @@ type AudioCueEvent = {
     progress: number;
 };
 type AudioCueTimelineSnapshot = {
+    schemaVersion: typeof AUDIO_CUE_SNAPSHOT_SCHEMA_VERSION;
     frame: number;
     reducedSensory: boolean;
     cues: AudioCueView[];
     events: AudioCueEvent[];
 };
+type HeadlessAudioAdapterSnapshot = AudioCueTimelineSnapshot & {
+    unlock: AudioUnlockStatus;
+    muted: boolean;
+};
+type AudioCueDiagnostic = {
+    code: string;
+    detail: string;
+    path?: string;
+};
+type RestoreAudioCueResult = {
+    ok: true;
+    snapshot: AudioCueTimelineSnapshot;
+} | {
+    ok: false;
+    errors: AudioCueDiagnostic[];
+};
 type PlayAudioCueResult = {
     ok: true;
     cue: AudioCueView;
@@ -1727,8 +1747,15 @@ type AudioCueTimeline = {
     cancel(idempotencyKey: string): boolean;
     reset(): void;
     snapshot(): AudioCueTimelineSnapshot;
+    restore(input: unknown): RestoreAudioCueResult;
     get(idempotencyKey: string): AudioCueView | undefined;
     dispose(): void;
+    /**
+     * Updates skip-playback for future cue starts. Already-started cues
+     * continue; scheduled cues that have not started yet use the new flag
+     * when they start.
+     */
+    setReducedSensory(value: boolean): void;
     readonly frame: number;
     readonly reducedSensory: boolean;
 };
@@ -1739,12 +1766,13 @@ type HeadlessAudioAdapter = {
     play(spec: AudioCueSpec): PlayAudioCueResult;
     step(frames?: number): AudioCueEvent[];
     handleHostEvent(event: HostEvent): void;
-    snapshot(): AudioCueTimelineSnapshot & {
-        unlock: AudioUnlockStatus;
-        muted: boolean;
-    };
+    snapshot(): HeadlessAudioAdapterSnapshot;
+    restore(input: unknown): RestoreAudioCueResult;
     destroy(): void;
+    setReducedSensory(value: boolean): void;
+    readonly reducedSensory: boolean;
 };
+declare function parseAudioCueSnapshot(input: unknown): RestoreAudioCueResult;
 declare function createHeadlessAudioAdapter(options?: {
     reducedSensory?: boolean;
     originFrame?: number;
@@ -1893,9 +1921,15 @@ type VisualLayerController = {
     inspect(): VisualLayerInspect[];
     captureComposedFrame(): ComposedFrame;
     destroy(): void;
+    /**
+     * Updates the host flag used by future `play()` calls. In-flight
+     * transitions keep the durations they were compiled with.
+     */
+    setReducedMotion(value: boolean): void;
     readonly frame: number;
     readonly sceneId: string | null;
     readonly compositor: Compositor;
+    readonly reducedMotion: boolean;
 };
 type VisualLayerCapture = {
     frame: ComposedFrame;
@@ -2270,6 +2304,8 @@ type PresentationInvocationView = {
     completedStepIds: string[];
     activeStepIds: string[];
     selectedFallbackId: string | null;
+    /** Reduced-motion flag used to compile this invocation's step durations. */
+    compiledReducedMotion: boolean;
 };
 type PresentationSequenceSnapshot = {
     schemaVersion: typeof PRESENTATION_SEQUENCE_SNAPSHOT_SCHEMA_VERSION;
@@ -2325,6 +2361,13 @@ type PresentationSequencePlayer = {
     }): PresentationCueIntent[];
     get(sequenceId: string): PresentationSequenceDefinition | undefined;
     destroy(): void;
+    /**
+     * Updates the host flag used by future `playSequence` / cue-intent
+     * compilation. The active invocation **continues** with the durations it
+     * was compiled with. Queued plays that have not started yet use the new
+     * policy when they start.
+     */
+    setReducedMotion(value: boolean): void;
     readonly frame: number;
     readonly reducedMotion: boolean;
     readonly reducedSensory: boolean;
@@ -3937,8 +3980,10 @@ type BrowserHarness = {
     readonly compositor: Compositor | undefined;
     readonly layout: PresentationLayout;
     readonly events: readonly EventEnvelope[];
+    readonly geometry: GeometryDocument | undefined;
     goto(url?: string): void;
     setViewport(width: number, height: number, dpr?: number): void;
+    setGeometry(next?: GeometryDocument): void;
     setReducedMotion(value: boolean): void;
     setInputModality(value: BrowserInputModality): void;
     click(selectorOrX: string | number, y?: number): void;
@@ -3961,16 +4006,19 @@ type BrowserHarness = {
  *
  * End-to-end production composition scenario harness. Composes the real
  * browser host, runtime group, compositor, visual/semantic layers, bindings,
- * sequences, headless audio, snapshots, and replay inspector. Does not
- * introduce a second runtime. Authored scenarios are JSON-serializable.
+ * sequences, headless audio, optional host-owned audio observation, snapshots,
+ * and replay inspector. Does not introduce a second runtime. Authored
+ * scenarios are JSON-serializable.
  */
 
 declare const PRODUCTION_SCENARIO_SCHEMA_VERSION: 1;
 declare const PRODUCTION_SCENARIO_SNAPSHOT_SCHEMA_VERSION: 1;
 declare const PRODUCTION_SCENARIO_BOUNDARIES: readonly ["input", "reducer", "routing", "binding", "cue", "pixels", "caption", "audio", "save-replay"];
 type ProductionScenarioBoundary = (typeof PRODUCTION_SCENARIO_BOUNDARIES)[number];
-declare const PRODUCTION_SCENARIO_ERROR_CODES: readonly ["invalid-scenario", "invalid-schema", "unknown-field", "missing-field", "callbacks-forbidden", "missing-participant", "missing-layer", "destroyed", "assertion-failed"];
+declare const PRODUCTION_SCENARIO_ERROR_CODES: readonly ["invalid-scenario", "invalid-schema", "unknown-field", "missing-field", "callbacks-forbidden", "missing-participant", "missing-layer", "destroyed", "assertion-failed", "invalid-host-audio", "invalid-audio-sidecar", "invalid-visual-sidecar", "invalid-semantic-sidecar", "invalid-binding-sidecar", "invalid-sequence-sidecar", "invalid-host-sidecar", "unsupported-preference", "invalid-geometry", "ambiguous-geometry", "stale-geometry"];
 type ProductionScenarioErrorCode = (typeof PRODUCTION_SCENARIO_ERROR_CODES)[number];
+declare const HOST_OWNED_AUDIO_EVENT_KINDS: readonly ["invoked", "completed", "failed", "skipped", "fallback"];
+type HostOwnedAudioEventKind = (typeof HOST_OWNED_AUDIO_EVENT_KINDS)[number];
 declare const PRODUCTION_SCENARIO_VIEWPORT_PRESETS: readonly ["desktop", "mobile"];
 type ProductionScenarioViewportPreset = (typeof PRODUCTION_SCENARIO_VIEWPORT_PRESETS)[number];
 declare const DEFAULT_PRODUCTION_SCENARIO_VIEWPORTS: {
@@ -4063,16 +4111,93 @@ type ProductionScenarioReduceResult = {
     reason?: string;
     playSequence?: string;
 };
+type ProductionScenarioControl = {
+    id: string;
+    name?: string;
+    role?: string;
+    /** Higher priority wins normalized overlap hit-tests when regions intersect. */
+    priority?: number;
+};
+type ProductionScenarioInputHitTest = {
+    x: number;
+    y: number;
+    selectedControlId: string;
+    rejectedControlIds: readonly string[];
+};
+type ProductionScenarioInputSurface = {
+    controls: readonly ProductionScenarioControl[];
+    geometry: GeometryDocument;
+};
 type ProductionScenarioHost = {
     initialState: JsonObject;
     reduce(state: JsonObject, intent: EventInput): ProductionScenarioReduceResult;
     project?(state: JsonObject): JsonObject;
+    /**
+     * Host-generic projection of the active input surface. After an accepted
+     * reduce (and on reload) the runner rebuilds visible/focusable controls and
+     * the geometry document from this result. Omit to keep construction-time
+     * geometry and controls.
+     */
+    projectInputSurface?(state: JsonObject): ProductionScenarioInputSurface;
+    /**
+     * Optional pre-reload validator for host JSON from a saved sidecar. When
+     * supplied, reload rejects invalid host state before any live mutation.
+     */
+    validateRestoreState?(state: JsonObject): {
+        ok: true;
+    } | {
+        ok: false;
+        detail: string;
+    };
+};
+type HostOwnedAudioEvent = {
+    kind: HostOwnedAudioEventKind;
+    atFrame?: number;
+    name?: string;
+    caption?: string;
+    assetId?: string;
+    reason?: string;
+    id?: string;
+    correlationId?: string;
+    causationId?: string;
+};
+type HostOwnedAudioSnapshot = {
+    events: readonly HostOwnedAudioEvent[];
+    captions?: readonly string[];
+    muted?: boolean;
+};
+/**
+ * Host-owned audio/presentation observer. The host already drives the
+ * controller; the runner only snapshots evidence. Generic: no dialogue
+ * product semantics. At least one of `snapshot` or `collect` is required.
+ */
+type HostOwnedAudioObserver = {
+    snapshot?(): HostOwnedAudioSnapshot;
+    collect?(): HostOwnedAudioSnapshot;
+    inspect?(): unknown;
 };
 type ProductionScenarioLocalization = {
     boundary: ProductionScenarioBoundary;
     code: ProductionScenarioErrorCode;
     detail: string;
 };
+declare const REDUCED_MOTION_ACTIVE_SEQUENCE_POLICY: "continue";
+type ReducedMotionActiveSequencePolicy = typeof REDUCED_MOTION_ACTIVE_SEQUENCE_POLICY;
+declare const REDUCED_MOTION_PARTICIPANT_IDS: readonly ["browser", "visual", "sequence", "audio", "semantic"];
+type ReducedMotionParticipantId = (typeof REDUCED_MOTION_PARTICIPANT_IDS)[number];
+type ReducedMotionParticipantReport = {
+    id: ReducedMotionParticipantId;
+    applied: boolean;
+    reducedMotion?: boolean;
+    reducedSensory?: boolean;
+    reason?: string;
+};
+type ReducedMotionPropagation = {
+    from: boolean;
+    to: boolean;
+    activeSequencePolicy: ReducedMotionActiveSequencePolicy;
+    participants: ReducedMotionParticipantReport[];
+};
 type ProductionScenarioObservation = {
     inputDispatched: boolean;
     inputTarget?: string;
@@ -4095,6 +4220,11 @@ type ProductionScenarioObservation = {
     muted: boolean;
     replayMatch?: boolean;
     snapshotOk?: boolean;
+    audioRestoreOk?: boolean;
+    reducedMotion?: boolean;
+    reducedMotionPropagation?: ReducedMotionPropagation | null;
+    activeControlIds: string[];
+    inputHitTest?: ProductionScenarioInputHitTest;
 };
 type ProductionScenarioExpectation = {
     inputDispatched?: boolean;
@@ -4110,6 +4240,7 @@ type ProductionScenarioExpectation = {
     audioFailed?: boolean;
     replayMatch?: boolean;
     snapshotOk?: boolean;
+    audioRestoreOk?: boolean;
 };
 type ProductionScenarioEvidenceBundle = {
     schemaVersion: typeof PRODUCTION_SCENARIO_SNAPSHOT_SCHEMA_VERSION;
@@ -4133,6 +4264,7 @@ type ProductionScenarioEvidenceBundle = {
         envelopes: EventEnvelope[];
         inspector: InspectorRecord[];
         audio: AudioCueEvent[];
+        hostAudio: HostOwnedAudioEvent[];
         actions: ProductionScenarioStep[];
     };
     screenshot: {
@@ -4161,6 +4293,13 @@ type CreateProductionScenarioRunnerOptions = {
     bindings?: PresentationBindingManifest | unknown;
     geometry?: GeometryDocument;
     host: ProductionScenarioHost;
+    /**
+     * Optional host-owned audio observer. When supplied, the runner records
+     * invocation / completion / failure / skip / fallback evidence from this
+     * adapter without requiring a presentation sequence for the same beat.
+     * Invalid adapters fail closed at boundary `audio`.
+     */
+    hostAudio?: HostOwnedAudioObserver;
     sequenceBindings?: Readonly<Record<string, PresentationSequenceBindings>>;
     contentWidth?: number;
     contentHeight?: number;
@@ -4200,13 +4339,22 @@ type ProductionScenarioRunner = {
         visual: ReturnType<VisualLayerController['inspect']> | null;
         semantic: ReturnType<SemanticLayerController['inspect']> | null;
         audio: ReturnType<HeadlessAudioAdapter['snapshot']>;
+        hostAudio: HostOwnedAudioSnapshot | null;
         participants: string[];
         layers: string[];
         composition: ProductionScenarioLocalization | null;
+        reducedMotion: boolean;
+        reducedMotionPropagation: ReducedMotionPropagation | null;
+        inputSurface: {
+            controlIds: string[];
+            controls: readonly ProductionScenarioControl[];
+            geometry: GeometryDocument | null;
+        };
     };
     destroy(): void;
 };
 declare function productionScenarioEventContracts(): EventContract[];
+declare function isHostOwnedAudioEventKind(value: unknown): value is HostOwnedAudioEventKind;
 declare function defineProductionScenario(input: unknown): DefineProductionScenarioResult;
 declare function fnv1aHex(data: string | Uint8Array): string;
 declare function localizeProductionScenarioFailure(observed: ProductionScenarioObservation, expected?: ProductionScenarioExpectation): ProductionScenarioLocalization | null;
@@ -4232,4 +4380,4 @@ type WriteComposedFrameResult = ComposedFrame & {
  */
 declare function writeComposedFrame(compositor: Compositor, path?: string): Promise<WriteComposedFrameResult>;
 
-export { type BoundReplaySession, CONTENT_REVISION_ACTIVATED_EVENT, CONTENT_REVISION_SNAPSHOT_SCHEMA_VERSION, type CausationTreeNode, type ContentRevisionActivator, type ContentRevisionBundle, type ContentRevisionInspect, type ContentRevisionSnapshot, type CreateHeadlessHarnessOptions, type CreateHeadlessMultiCartHarnessOptions, type CreateReplayInspectorOptions, type CreateSelectionTraceOptions, DEFAULT_HEADLESS_HEIGHT, DEFAULT_HEADLESS_WIDTH, DEFAULT_MAX_SELECTION_RECORDS, DEFAULT_PRODUCTION_SCENARIO_VIEWPORTS, type FrameBenchmarkOptions, type FrameBenchmarkResult, type GlyphAtlas, HEADLESS_PNG_DATA_URL, type HeadlessAudioAdapter, type HeadlessCanvas2DSettings, type HeadlessFrameError, type HeadlessHarness, type HeadlessImageFixture, type HeadlessInspect, type HeadlessJobWorker, type HeadlessMultiCartHarness, HeadlessUnsupportedOperationError, type HostGrantSet, type InspectorRecord, type InstallHeadlessCanvasOptions, type JobCoordinator, type JobCoordinatorSnapshot, type JobInspect, PRESENTATION_BINDING_APPLIED_EVENT, PRESENTATION_BINDING_SNAPSHOT_SCHEMA_VERSION, PRODUCTION_SCENARIO_BOUNDARIES, PRODUCTION_SCENARIO_SCHEMA_VERSION, PRODUCTION_SCENARIO_SNAPSHOT_SCHEMA_VERSION, type PortalInspect, type PortalLifecycle, type PortalLifecycleSnapshot, type PresentationBindingInspect, type PresentationBindingManifest, type PresentationBindingRuntime, type PresentationBindingSnapshot, type PresentationSequenceDefinition, type PresentationSequenceInspect, type PresentationSequencePlayer, type PresentationSequenceSnapshot, type ProductionScenarioDefinition, type ProductionScenarioEvidenceBundle, type ProductionScenarioExpectation, type ProductionScenarioHost, type ProductionScenarioLocalization, type ProductionScenarioObservation, type ProductionScenarioRunner, type RemoteCartInspect, type RemoteCartSandbox, type ReplayCompareResult, type ReplayInspector, type ReplayInspectorExport, type ReplayInspectorReport, type ReplayParticipantSummary, type ReplayTapeAction, type ReplayTraceFilter, SELECTION_DECISION_KINDS, SELECTION_REASON_CODES, SELECTION_TRACE_SCHEMA_VERSION, SELECTION_TRACE_SENSITIVE_KEYS, type SelectionAssetResolution, type SelectionBindingEvaluation, type SelectionContentIdentity, type SelectionDecisionInput, type SelectionDecisionKind, type SelectionDecisionRecord, type SelectionPresentationDecision, type SelectionReasonCode, type SelectionSequenceDecision, type SelectionSnapshotProvenance, type SelectionStagingOutcome, type SelectionStagingResult, type SelectionTrace, type SelectionTraceExport, type SelectionTraceFilter, type SelectionTraceReport, type SemanticLayerController, type SemanticPublishedRegion, type SemanticRegionInspect, UPDATE_GOLDEN_ENV, type VisualArtifactPaths, type VisualArtifacts, type VisualCompareOptions, type VisualCompareResult, type VisualLayerCapture, type VisualLayerController, type VisualLayerInspect, WORLD_PATCH_ACCEPTED_EVENT, WORLD_PATCH_SNAPSHOT_SCHEMA_VERSION, type WorldGraph, type WorldGraphInspect, type WorldGraphProjection, type WorldGraphSnapshot, type WorldPatchApplier, type WorldPatchInspect, type WorldPatchSnapshot, type WorldPersistenceAdapter, type WriteComposedFrameResult, assertPixelsEqual, assertPngDataUrlsEqual, attachHeadlessCanvas2D, attachSelectionTrace, benchmarkCartFrames, cabinetPortal, captureVisualLayers, compareImageData, compareReplayTraces, contentRevisionEventContracts, createContentRevisionActivator, createDefaultGlyphAtlas, createHeadlessAudioAdapter, createHeadlessHarness, createHeadlessJobWorker, createHeadlessMultiCartHarness, createHostGrantSet, createImageFixture, createJobCoordinator, createMemoryJobPersistence, createMemoryWorldPersistence, createPortalLifecycle, createPresentationBindingRuntime, createPresentationSequencePlayer, createProductionScenarioRunner, createRemoteCartSandbox, createRemoteContentAdapter, createReplayInspector, createSelectionTrace, createSemanticLayerController, createStaticContentAdapter, createVisualLayerController, createWorldGraph, createWorldPatchApplier, decodePng, definePresentationBindings, definePresentationSequence, defineProductionScenario, encodePng, encodePngDataUrl, evaluatePresentationBindings, fnv1aHex, formatFrameBenchmarkResult, getHeadlessSurface, imageDataFromPngDataUrl, installHeadlessCanvas, isSelectionDecisionKind, isSelectionReasonCode, jobEventContracts, localizeProductionScenarioFailure, makeImageData, paintingPortal, presentationBindingEventContracts, presentationSequenceEventContracts, productionScenarioEventContracts, recordSelectionDecision, replayExportedTrace, setDefaultGlyphAtlas, shouldUpdateGolden, worldGraphEventContracts, worldPatchEventContracts, writeComposedFrame, writeVisualArtifacts };
+export { AUDIO_CUE_SNAPSHOT_SCHEMA_VERSION, type AudioCueDiagnostic, type BoundReplaySession, CONTENT_REVISION_ACTIVATED_EVENT, CONTENT_REVISION_SNAPSHOT_SCHEMA_VERSION, type CausationTreeNode, type ContentRevisionActivator, type ContentRevisionBundle, type ContentRevisionInspect, type ContentRevisionSnapshot, type CreateHeadlessHarnessOptions, type CreateHeadlessMultiCartHarnessOptions, type CreateProductionScenarioRunnerOptions, type CreateReplayInspectorOptions, type CreateSelectionTraceOptions, DEFAULT_HEADLESS_HEIGHT, DEFAULT_HEADLESS_WIDTH, DEFAULT_MAX_SELECTION_RECORDS, DEFAULT_PRODUCTION_SCENARIO_VIEWPORTS, type FrameBenchmarkOptions, type FrameBenchmarkResult, type GlyphAtlas, HEADLESS_PNG_DATA_URL, HOST_OWNED_AUDIO_EVENT_KINDS, type HeadlessAudioAdapter, type HeadlessAudioAdapterSnapshot, type HeadlessCanvas2DSettings, type HeadlessFrameError, type HeadlessHarness, type HeadlessImageFixture, type HeadlessInspect, type HeadlessJobWorker, type HeadlessMultiCartHarness, HeadlessUnsupportedOperationError, type HostGrantSet, type HostOwnedAudioEvent, type HostOwnedAudioEventKind, type HostOwnedAudioObserver, type HostOwnedAudioSnapshot, type InspectorRecord, type InstallHeadlessCanvasOptions, type JobCoordinator, type JobCoordinatorSnapshot, type JobInspect, PRESENTATION_BINDING_APPLIED_EVENT, PRESENTATION_BINDING_SNAPSHOT_SCHEMA_VERSION, PRODUCTION_SCENARIO_BOUNDARIES, PRODUCTION_SCENARIO_SCHEMA_VERSION, PRODUCTION_SCENARIO_SNAPSHOT_SCHEMA_VERSION, type PortalInspect, type PortalLifecycle, type PortalLifecycleSnapshot, type PresentationBindingInspect, type PresentationBindingManifest, type PresentationBindingRuntime, type PresentationBindingSnapshot, type PresentationSequenceDefinition, type PresentationSequenceInspect, type PresentationSequencePlayer, type PresentationSequenceSnapshot, type ProductionScenarioControl, type ProductionScenarioDefinition, type ProductionScenarioEvidenceBundle, type ProductionScenarioExpectation, type ProductionScenarioHost, type ProductionScenarioInputHitTest, type ProductionScenarioInputSurface, type ProductionScenarioLocalization, type ProductionScenarioObservation, type ProductionScenarioRunner, REDUCED_MOTION_ACTIVE_SEQUENCE_POLICY, REDUCED_MOTION_PARTICIPANT_IDS, type ReducedMotionActiveSequencePolicy, type ReducedMotionParticipantId, type ReducedMotionParticipantReport, type ReducedMotionPropagation, type RemoteCartInspect, type RemoteCartSandbox, type ReplayCompareResult, type ReplayInspector, type ReplayInspectorExport, type ReplayInspectorReport, type ReplayParticipantSummary, type ReplayTapeAction, type ReplayTraceFilter, type RestoreAudioCueResult, SELECTION_DECISION_KINDS, SELECTION_REASON_CODES, SELECTION_TRACE_SCHEMA_VERSION, SELECTION_TRACE_SENSITIVE_KEYS, type SelectionAssetResolution, type SelectionBindingEvaluation, type SelectionContentIdentity, type SelectionDecisionInput, type SelectionDecisionKind, type SelectionDecisionRecord, type SelectionPresentationDecision, type SelectionReasonCode, type SelectionSequenceDecision, type SelectionSnapshotProvenance, type SelectionStagingOutcome, type SelectionStagingResult, type SelectionTrace, type SelectionTraceExport, type SelectionTraceFilter, type SelectionTraceReport, type SemanticLayerController, type SemanticPublishedRegion, type SemanticRegionInspect, UPDATE_GOLDEN_ENV, type VisualArtifactPaths, type VisualArtifacts, type VisualCompareOptions, type VisualCompareResult, type VisualLayerCapture, type VisualLayerController, type VisualLayerInspect, WORLD_PATCH_ACCEPTED_EVENT, WORLD_PATCH_SNAPSHOT_SCHEMA_VERSION, type WorldGraph, type WorldGraphInspect, type WorldGraphProjection, type WorldGraphSnapshot, type WorldPatchApplier, type WorldPatchInspect, type WorldPatchSnapshot, type WorldPersistenceAdapter, type WriteComposedFrameResult, assertPixelsEqual, assertPngDataUrlsEqual, attachHeadlessCanvas2D, attachSelectionTrace, benchmarkCartFrames, cabinetPortal, captureVisualLayers, compareImageData, compareReplayTraces, contentRevisionEventContracts, createContentRevisionActivator, createDefaultGlyphAtlas, createHeadlessAudioAdapter, createHeadlessHarness, createHeadlessJobWorker, createHeadlessMultiCartHarness, createHostGrantSet, createImageFixture, createJobCoordinator, createMemoryJobPersistence, createMemoryWorldPersistence, createPortalLifecycle, createPresentationBindingRuntime, createPresentationSequencePlayer, createProductionScenarioRunner, createRemoteCartSandbox, createRemoteContentAdapter, createReplayInspector, createSelectionTrace, createSemanticLayerController, createStaticContentAdapter, createVisualLayerController, createWorldGraph, createWorldPatchApplier, decodePng, definePresentationBindings, definePresentationSequence, defineProductionScenario, encodePng, encodePngDataUrl, evaluatePresentationBindings, fnv1aHex, formatFrameBenchmarkResult, getHeadlessSurface, imageDataFromPngDataUrl, installHeadlessCanvas, isHostOwnedAudioEventKind, isSelectionDecisionKind, isSelectionReasonCode, jobEventContracts, localizeProductionScenarioFailure, makeImageData, paintingPortal, parseAudioCueSnapshot, presentationBindingEventContracts, presentationSequenceEventContracts, productionScenarioEventContracts, recordSelectionDecision, replayExportedTrace, setDefaultGlyphAtlas, shouldUpdateGolden, worldGraphEventContracts, worldPatchEventContracts, writeComposedFrame, writeVisualArtifacts };