@cyberart-io/engine 0.0.10 → 0.0.12

package/CHANGELOG.md

@@ -4,6 +4,29 @@ All notable changes to `@cyberart-io/engine`. Each entry links the guide in `doc
 
 ## Unreleased
 
+## 0.0.12 — 2026-09-08
+
+Loading-indicator contract and job submit payload validation. Additive: existing exports keep their signatures.
+
+### Added
+
+- **Deterministic loading indicator** — `createLoadingIndicatorController`, `parseLoadingIndicatorParams`, `parseLoadingIndicatorSnapshot`, `loadingIndicatorEventContracts`. Host-facing presentation-only contract with validated params (`schemaVersion`, `seed`, `mode`, optional `progress`/`stage`/`context`, bounded presentation), lifecycle `start → update → complete | fail | cancel`, seeded variant derivation, reduced-motion static treatment, host `statusText`, cart-init fallback to built-in indicator, snapshot/restore fail-closed, and budget diagnostics. Reference cart: `fixtures/loadingPulseCart.ts`. [docs/loading-indicator.md](docs/loading-indicator.md) · [#64](https://github.com/cyberart-io/cyberart.io/pull/64)
+
+### Fixed
+
+- **Job submit payload validation** — `createJobCoordinator.submit` validates `request` against the definition's `requestSchema` before mutation. Missing required fields and undeclared keys (unless `additionalProperties: true`) return structured `invalid-request` failures without creating jobs, emitting lifecycle events, or consuming idempotency keys. Shared helper: `validatePayloadAgainstSchema`. [docs/job-orchestration.md](docs/job-orchestration.md) · [#65](https://github.com/cyberart-io/cyberart.io/pull/65)
+
+
+## 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.

package/README.md

@@ -94,6 +94,7 @@ Full API for the event router, deterministic replay, and CI harness (so agents c
 - [Presentation adapter](docs/presentation-adapter.md) — host-owned render model, intents, loading / error / unsupported
 - [Asset resolver](docs/asset-resolver.md) — host-pluggable images/audio/fonts/spritesheets, cache, preload, fallbacks
 - [Presentation cue](docs/presentation-cue.md) — deterministic `createPresentationTimeline`, duplicate policy, reduced-motion, lifecycle events
+- [Loading indicator](docs/loading-indicator.md) — `createLoadingIndicatorController`, seeded loader carts, honest progress, snapshot/restore, fallback
 - [Capability manifest](docs/capability-manifest.md) — versioned JSON for runtime features, phases, managers, assets, events, permissions, integrations
 - [Executable modules](docs/executable-modules.md) — trusted versioned factories, host allowlists, isolation, per-module failures
 - [Remote cart manifests](docs/remote-cart-manifest.md) — signed catalogs, declared asset hashes, inspectable host grants

package/dist/headless.d.ts

@@ -1284,6 +1284,8 @@ type PayloadSchema = {
     /** Payload schema version. Bump on any field change. */
     version: number;
     fields: Record<string, PayloadFieldSpec>;
+    /** When not `true`, validation rejects undeclared payload keys. */
+    additionalProperties?: boolean;
 };
 type ContractDiagnostic = {
     code: string;
@@ -2993,6 +2995,183 @@ declare function paintingPortal(portal: PortalLifecycle): {
 };
 declare function createPortalLifecycle(options?: CreatePortalLifecycleOptions): PortalLifecycle;
 
+/**
+ * Copyright (c) 2026 Aaron Boyarsky
+ * SPDX-License-Identifier: LicenseRef-CyberArt-Engine
+ * See packages/engine/LICENSE
+ *
+ * Host-facing deterministic loading-indicator contract. Presentation-only:
+ * carts vary by seeded parameters without inventing progress or mutating
+ * authoritative host state.
+ */
+
+declare const LOADING_INDICATOR_PARAM_SCHEMA_VERSION: 1;
+declare const LOADING_INDICATOR_SNAPSHOT_SCHEMA_VERSION: 1;
+declare const LOADING_INDICATOR_MODES: readonly ["indeterminate", "determinate"];
+type LoadingIndicatorMode = (typeof LOADING_INDICATOR_MODES)[number];
+declare const LOADING_INDICATOR_CONTEXTS: readonly ["travel", "worldgen", "content", "audio"];
+type LoadingIndicatorContext = (typeof LOADING_INDICATOR_CONTEXTS)[number];
+declare const LOADING_INDICATOR_MOTIFS: readonly ["pulse", "orbit", "bars", "ripple", "static"];
+type LoadingIndicatorMotif = (typeof LOADING_INDICATOR_MOTIFS)[number];
+declare const LOADING_INDICATOR_PHASES: readonly ["idle", "active", "completed", "failed", "canceled"];
+type LoadingIndicatorPhase = (typeof LOADING_INDICATOR_PHASES)[number];
+declare const LOADING_INDICATOR_STARTED_EVENT: "loading.indicator.started";
+declare const LOADING_INDICATOR_UPDATED_EVENT: "loading.indicator.updated";
+declare const LOADING_INDICATOR_COMPLETED_EVENT: "loading.indicator.completed";
+declare const LOADING_INDICATOR_FAILED_EVENT: "loading.indicator.failed";
+declare const LOADING_INDICATOR_CANCELED_EVENT: "loading.indicator.canceled";
+declare const LOADING_INDICATOR_DIAGNOSTIC_EVENT: "loading.indicator.diagnostic";
+declare const LOADING_INDICATOR_EVENTS: readonly ["loading.indicator.started", "loading.indicator.updated", "loading.indicator.completed", "loading.indicator.failed", "loading.indicator.canceled", "loading.indicator.diagnostic"];
+type LoadingIndicatorEventType = (typeof LOADING_INDICATOR_EVENTS)[number];
+declare const LOADING_INDICATOR_DIAGNOSTIC_CODES: readonly ["invalid-params", "invalid-snapshot", "schema-mismatch", "unknown-field", "cart-init-failed", "budget-exceeded", "invalid-state", "restore-failed"];
+type LoadingIndicatorDiagnosticCode = (typeof LOADING_INDICATOR_DIAGNOSTIC_CODES)[number];
+type LoadingIndicatorPresentation = {
+    palette?: string;
+    intensity?: number;
+    motif?: LoadingIndicatorMotif;
+    variant?: number;
+};
+type LoadingIndicatorParams = {
+    schemaVersion: typeof LOADING_INDICATOR_PARAM_SCHEMA_VERSION;
+    seed: string;
+    mode: LoadingIndicatorMode;
+    progress?: number;
+    stage?: string;
+    context?: LoadingIndicatorContext | string;
+    statusText: string;
+    presentation?: LoadingIndicatorPresentation;
+    cartId?: string;
+};
+type LoadingIndicatorParamsInput = Omit<LoadingIndicatorParams, 'schemaVersion'> & {
+    schemaVersion?: number;
+};
+type LoadingIndicatorVariant = {
+    hue: number;
+    motif: LoadingIndicatorMotif;
+    variant: number;
+    intensity: number;
+    palette: string;
+};
+type LoadingIndicatorView = {
+    phase: LoadingIndicatorPhase;
+    mode: LoadingIndicatorMode;
+    /** Host-supplied progress in determinate mode; null when indeterminate. */
+    progress: number | null;
+    stage: string | null;
+    context: string | null;
+    statusText: string;
+    seed: string;
+    variant: LoadingIndicatorVariant;
+    usingFallback: boolean;
+    cartId: string;
+    frame: number;
+    /** Presentation animation phase 0..1; static under reduced motion. */
+    pulsePhase: number;
+    reducedMotion: boolean;
+};
+type LoadingIndicatorEvent = {
+    type: LoadingIndicatorEventType;
+    atFrame: number;
+    seed: string;
+    mode: LoadingIndicatorMode;
+    phase: LoadingIndicatorPhase;
+    progress: number | null;
+    stage: string | null;
+    context: string | null;
+    statusText: string;
+    usingFallback: boolean;
+    reasonCode?: string;
+};
+type LoadingIndicatorDiagnostic = {
+    code: LoadingIndicatorDiagnosticCode | string;
+    detail: string;
+    path?: string;
+    atFrame?: number;
+};
+type LoadingIndicatorSnapshot = {
+    schemaVersion: typeof LOADING_INDICATOR_SNAPSHOT_SCHEMA_VERSION;
+    frame: number;
+    reducedMotion: boolean;
+    phase: LoadingIndicatorPhase;
+    params: LoadingIndicatorParams | null;
+    variant: LoadingIndicatorVariant;
+    usingFallback: boolean;
+    fallbackReason: string | null;
+    cartId: string;
+    events: LoadingIndicatorEvent[];
+    diagnostics: LoadingIndicatorDiagnostic[];
+    /** Inspect event types in live order, including diagnostics. */
+    eventLog?: LoadingIndicatorEventType[];
+};
+type LoadingIndicatorInspect = {
+    destroyed: boolean;
+    view: LoadingIndicatorView;
+    events: LoadingIndicatorEventType[];
+    diagnostics: LoadingIndicatorDiagnostic[];
+};
+type LoadingIndicatorMutationResult = {
+    ok: true;
+    view: LoadingIndicatorView;
+} | {
+    ok: false;
+    errors: LoadingIndicatorDiagnostic[];
+};
+type RestoreLoadingIndicatorResult = {
+    ok: true;
+    snapshot: LoadingIndicatorSnapshot;
+} | {
+    ok: false;
+    errors: LoadingIndicatorDiagnostic[];
+};
+type LoadingIndicatorBudgets = {
+    maxStepFrames?: number;
+    maxIntensity?: number;
+    maxVariant?: number;
+};
+type LoadingIndicatorCartFactory = (seed: string, variant: LoadingIndicatorVariant) => LoadingIndicatorCartHandle | {
+    ok: false;
+    reason: string;
+};
+type LoadingIndicatorCartHandle = {
+    step?(frames: number, view: LoadingIndicatorView): void;
+    destroy?(): void;
+};
+type CreateLoadingIndicatorControllerOptions = {
+    carts?: Record<string, LoadingIndicatorCartFactory | AnimationCart>;
+    reducedMotion?: boolean;
+    originFrame?: number;
+    budgets?: LoadingIndicatorBudgets;
+    router?: Pick<EventRouter, 'publish'>;
+    defaultCartId?: string;
+};
+type LoadingIndicatorController = {
+    start(input: LoadingIndicatorParamsInput): LoadingIndicatorMutationResult;
+    update(input: Partial<LoadingIndicatorParamsInput>): LoadingIndicatorMutationResult;
+    complete(): LoadingIndicatorMutationResult;
+    fail(reasonCode?: string): LoadingIndicatorMutationResult;
+    cancel(): LoadingIndicatorMutationResult;
+    step(frames?: number): LoadingIndicatorEvent[];
+    snapshot(): LoadingIndicatorSnapshot;
+    restore(input: unknown): RestoreLoadingIndicatorResult;
+    inspect(): LoadingIndicatorInspect;
+    setReducedMotion(value: boolean): void;
+    destroy(): void;
+    readonly reducedMotion: boolean;
+    readonly frame: number;
+};
+declare function loadingIndicatorEventContracts(): EventContract[];
+declare function isLoadingIndicatorEventType(value: unknown): value is LoadingIndicatorEventType;
+declare function isLoadingIndicatorMode(value: unknown): value is LoadingIndicatorMode;
+declare function parseLoadingIndicatorParams(input: unknown, path?: string): {
+    ok: true;
+    params: LoadingIndicatorParams;
+} | {
+    ok: false;
+    errors: LoadingIndicatorDiagnostic[];
+};
+declare function parseLoadingIndicatorSnapshot(input: unknown): RestoreLoadingIndicatorResult;
+declare function createLoadingIndicatorController(options?: CreateLoadingIndicatorControllerOptions): LoadingIndicatorController;
+
 /**
  * Copyright (c) 2026 Aaron Boyarsky
  * SPDX-License-Identifier: LicenseRef-CyberArt-Engine
@@ -4015,7 +4194,7 @@ 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", "invalid-host-audio", "invalid-audio-sidecar", "unsupported-preference", "invalid-geometry", "ambiguous-geometry", "stale-geometry"];
+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];
@@ -4115,6 +4294,14 @@ 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[];
@@ -4131,6 +4318,16 @@ type ProductionScenarioHost = {
      * 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;
@@ -4206,6 +4403,7 @@ type ProductionScenarioObservation = {
     reducedMotion?: boolean;
     reducedMotionPropagation?: ReducedMotionPropagation | null;
     activeControlIds: string[];
+    inputHitTest?: ProductionScenarioInputHitTest;
 };
 type ProductionScenarioExpectation = {
     inputDispatched?: boolean;
@@ -4328,6 +4526,7 @@ type ProductionScenarioRunner = {
         reducedMotionPropagation: ReducedMotionPropagation | null;
         inputSurface: {
             controlIds: string[];
+            controls: readonly ProductionScenarioControl[];
             geometry: GeometryDocument | null;
         };
     };
@@ -4360,4 +4559,4 @@ type WriteComposedFrameResult = ComposedFrame & {
  */
 declare function writeComposedFrame(compositor: Compositor, path?: string): Promise<WriteComposedFrameResult>;
 
-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 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 };
+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 CreateLoadingIndicatorControllerOptions, 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, LOADING_INDICATOR_CANCELED_EVENT, LOADING_INDICATOR_COMPLETED_EVENT, LOADING_INDICATOR_CONTEXTS, LOADING_INDICATOR_DIAGNOSTIC_CODES, LOADING_INDICATOR_DIAGNOSTIC_EVENT, LOADING_INDICATOR_EVENTS, LOADING_INDICATOR_FAILED_EVENT, LOADING_INDICATOR_MODES, LOADING_INDICATOR_MOTIFS, LOADING_INDICATOR_PARAM_SCHEMA_VERSION, LOADING_INDICATOR_PHASES, LOADING_INDICATOR_SNAPSHOT_SCHEMA_VERSION, LOADING_INDICATOR_STARTED_EVENT, LOADING_INDICATOR_UPDATED_EVENT, type LoadingIndicatorBudgets, type LoadingIndicatorCartFactory, type LoadingIndicatorCartHandle, type LoadingIndicatorContext, type LoadingIndicatorController, type LoadingIndicatorDiagnostic, type LoadingIndicatorDiagnosticCode, type LoadingIndicatorEvent, type LoadingIndicatorEventType, type LoadingIndicatorInspect, type LoadingIndicatorMode, type LoadingIndicatorMotif, type LoadingIndicatorMutationResult, type LoadingIndicatorParams, type LoadingIndicatorParamsInput, type LoadingIndicatorPhase, type LoadingIndicatorPresentation, type LoadingIndicatorSnapshot, type LoadingIndicatorVariant, type LoadingIndicatorView, 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, type RestoreLoadingIndicatorResult, 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, createLoadingIndicatorController, 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, isLoadingIndicatorEventType, isLoadingIndicatorMode, isSelectionDecisionKind, isSelectionReasonCode, jobEventContracts, loadingIndicatorEventContracts, localizeProductionScenarioFailure, makeImageData, paintingPortal, parseAudioCueSnapshot, parseLoadingIndicatorParams, parseLoadingIndicatorSnapshot, presentationBindingEventContracts, presentationSequenceEventContracts, productionScenarioEventContracts, recordSelectionDecision, replayExportedTrace, setDefaultGlyphAtlas, shouldUpdateGolden, worldGraphEventContracts, worldPatchEventContracts, writeComposedFrame, writeVisualArtifacts };