@aura3d/engine 4.0.7 → 4.1.0

package/dist/engine/public/index.js

@@ -9,113 +9,118 @@
 // Lane provide() side-effects — how lane contract implementations reach ".".
 import "../lanes/index.js";
 // ── Live surface (§6.6 keep-set) ────────────────────────────────────────
-export { AnimationController, appExtensionsAll, asRuntimeCompiled, atmosphere, auditArtDirection, AuraColorParseError, AuraSceneBuilder, batched, bindGameTouchControls, bindRuntimeCompiled, blendSkyBandColor, camera, cameras, captionCueAtTime, captureFromUrl, characterAssembly, characters, charts, checkSpatialInvariants, city, clearFocus, Clock, cloneSkinned, combatFrameAdvantage, compilePromptEpisodePlan, compilePromptPlanV2, compilerSlot, compileScene, composeWorldMatrix, compute, computeLineDistances, createAnimationPerformanceCoverage, createAnimationRenderOutputPackageMetadata, createArchitectureKit, createAssetDiagnostics, createAudioStemManifest, createAuraApp, createAuraRouteHealthSnapshot, createAuraText3DGeometry, createAuraVoiceBridgePackage, createAuraVoiceVisemeTrack, createCameraPathFromPreset, createCinematicKit, createCollisionLayers, createCombatAi, createDiagnosticsPanel, createDigitalTwinKit, createEnvironment, createFightingGameKit, createFrameLoop, createGame, createGameApp, createGameArcadeVehicle, createGameAudio, createGlbBlendshapeVisemeCue, createInitialDiagnostics, createMeshSurfaceQuery, createPrimitiveMouthVisemeCues, createProductConfiguratorKit, createProductionRuntimeCollectedLights, createPromptAnimationDeterministicScreenshotFixtureMetadata, createShotPlaybackPlan, createSmartCityKit, createVehicleChassis, createVehicleDriverAi, decomposeMatrix, defineAuraAssets, defineDubMap, definePromptPlan, DIAGNOSTIC_ONLY_FIELDS, DIAGNOSTICS_SECTION_KEYS, diagnosticsSectionsAll, distanceLod, distributeInRegion, effects, enforceFrameBudget, environments, eulerToQuaternion, fat, fitSizeToRegion, focusCameraIntent, focusObject, focusSemanticRegion, game, gameFeel, games, geometry, glbVisemeBlendshapeExample, groundedFittedModelPosition, groundedRenderedAssetPlacement, group, groups, helpers, installShotPlayback, instances, interactions, labels, lights, line, lines, lookLint, looks, loop, material, model, nodeHandleExtensionFor, nodeHandleExtensionsAll, nodeHandlerFor, nodeHandlersAll, normalizeLinePositions, optionCoverageRows, parseAuraColor, parseAuraColorSrgb, particles, physics, placedBounds, placedBoundsFromAsset, planLayeredSceneComposition, planScatterInstances, planSkyBackdrop, platformerCompositionSpec, points, postPresets, prefabs, primitiveMouthVisemeExample, primitives, product, promptPlanToScene, promptRecipes, raycast, raycastFirst, registerAppExtension, registerDiagnosticsSection, registerEnvironmentSource, registerLookLintRule, registerNodeHandleExtension, registerNodeHandler, registerOptionCoverage, renderer, resolveBoundsAnchor, resolveCameraFrame, resolveChaseFraming, resolveEnvironment, resolveQrFlags, resolveSemanticRegion, sampleAuraVoiceBridgeAtTime, sampleCameraPath, sampleShotPlaybackPlan, sampleVisemeTrack, scatterWindOffset, scene, sceneKits, SCREEN_FEEL_BLACKBOARD_KEY, segments, setCompilerImpl, shadows, skyBandCountForRamp, snapshotDiagnostics, solar, solveCombatFrameData, solvePlatformerMotion, sprite, sprites, StubActorAnimationApi, StubAppAtmosphere, StubAppEffects, stubCameraRigFactories, StubFeelBus, StubLightingRuntime, StubModelMaterialHandle, StubPostSurface, StubTimeController, surfaces, text3D, timeline, tsl, ui, updateCompiledScene, validateAuraVoiceBridgePackage, validateCombatFrameData, vehicleChassisSpecFromBounds, WIND_CHUNK, workflows, worldQueriesSlot } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/renderer`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+export { AnimationController, appExtensionsAll, asRuntimeCompiled, atmosphere, auditArtDirection, AuraColorParseError, AuraSceneBuilder, batched, bindGameTouchControls, bindRuntimeCompiled, blendSkyBandColor, camera, cameras, captionCueAtTime, captureFromUrl, characterAssembly, characters, charts, checkSpatialInvariants, city, clearFocus, Clock, cloneSkinned, combatFrameAdvantage, compilePromptEpisodePlan, compilePromptPlanV2, compilerSlot, compileScene, composeWorldMatrix, compute, computeLineDistances, createAnimationPerformanceCoverage, createAnimationRenderOutputPackageMetadata, createArchitectureKit, createAssetDiagnostics, createAudioStemManifest, createAuraApp, createAuraRouteHealthSnapshot, createAuraText3DGeometry, createAuraVoiceBridgePackage, createAuraVoiceVisemeTrack, createCameraPathFromPreset, createCinematicKit, createCollisionLayers, createCombatAi, createDiagnosticsPanel, createDigitalTwinKit, createEnvironment, createFightingGameKit, createFrameLoop, createGame, createGameApp, createGameArcadeVehicle, createGameAudio, createGlbBlendshapeVisemeCue, createInitialDiagnostics, createMeshSurfaceQuery, createPrimitiveMouthVisemeCues, createProductConfiguratorKit, createProductionRuntimeCollectedLights, createPromptAnimationDeterministicScreenshotFixtureMetadata, createShotPlaybackPlan, createSmartCityKit, createVehicleChassis, createVehicleDriverAi, decomposeMatrix, defineAuraAssets, defineDubMap, defineModelAssets, definePromptPlan, DIAGNOSTIC_ONLY_FIELDS, DIAGNOSTICS_SECTION_KEYS, diagnosticsSectionsAll, distanceLod, distributeInRegion, effects, enforceFrameBudget, environments, eulerToQuaternion, fat, fitSizeToRegion, focusCameraIntent, focusObject, focusSemanticRegion, game, gameFeel, games, geometry, glbVisemeBlendshapeExample, groundedFittedModelPosition, groundedRenderedAssetPlacement, group, groups, helpers, installShotPlayback, instances, interactions, labels, lights, line, lines, lookLint, looks, loop, material, model, modelsEnabledFromUrl, nodeHandleExtensionFor, nodeHandleExtensionsAll, nodeHandlerFor, nodeHandlersAll, normalizeLinePositions, optionCoverageRows, parseAuraColor, parseAuraColorSrgb, particles, physics, placedBounds, placedBoundsFromAsset, planLayeredSceneComposition, planScatterInstances, planSkyBackdrop, platformerCompositionSpec, points, postPresets, prefabs, primitiveMouthVisemeExample, primitives, product, promptPlanToScene, promptRecipes, raycast, raycastFirst, registerAppExtension, registerDiagnosticsSection, registerEnvironmentSource, registerLookLintRule, registerNodeHandleExtension, registerNodeHandler, registerOptionCoverage, renderer, resolveBoundsAnchor, resolveCameraFrame, resolveChaseFraming, resolveEnvironment, resolveQrFlags, resolveSemanticRegion, sampleAuraVoiceBridgeAtTime, sampleCameraPath, sampleShotPlaybackPlan, sampleVisemeTrack, scatterWindOffset, scene, sceneKits, SCREEN_FEEL_BLACKBOARD_KEY, segments, setCompilerImpl, shadows, skyBandCountForRamp, snapshotDiagnostics, solar, solveCombatFrameData, solvePlatformerMotion, sprite, sprites, StubActorAnimationApi, StubAppAtmosphere, StubAppEffects, stubCameraRigFactories, StubFeelBus, StubLightingRuntime, StubModelMaterialHandle, StubPostSurface, StubTimeController, surfaces, text3D, timeline, tsl, ui, updateCompiledScene, validateAuraVoiceBridgePackage, validateCombatFrameData, vehicleChassisSpecFromBounds, WIND_CHUNK, workflows, worldQueriesSlot } from "../agent-api/index.js";
+// QA and replay kit (docs/api/qa-kit.md).
+export { createCountedRng, createFixedStepLoop, fixedStepLoop, installQaHooks, qaErrorGlobalName, qaHookGlobalName, readQaParams } from "../qa/index.js";
+// ── Deprecated union (kept at 4.0.0 per §6.6 step 3 — removes in 5.0.0; each names its destination) ──
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
+export { createScatterRandom, mergeStatic, mergeStaticByKey, scatterAlongPath, scatterInArea, scatterTransforms, splitScatterByDistance } from "../agent-api/index.js";
+/** @deprecated Use `@aura3d/engine/renderer`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { A3DRenderer } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/animation`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/animation`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { A3DAppLifecycle } from "../agent-api/index.js";
 export { AnimationAction } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/animation`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/animation`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { AnimationClip } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/animation`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/animation`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { AnimationLayer } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/animation`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/animation`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { AnimationMixer } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/animation`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/animation`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { AnimationTrack } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { AuraNodeBuilder } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { captureAuraAppScreenshot } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { captureScreenshot } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { character } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { collectAuraSceneEvidence } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { collectPromptAnimationEvidence } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { compilePromptPlan } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { compositeMetallicRoughnessPixels } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { createA3DApp } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { createAnimationController } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { createAssetCompatibilityReport } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { createAssetViewerWorkflow } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { createCaptionTimingProof } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { createExternalParityEnvironmentPipeline } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { createGameAppRuntime } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { createInteractiveSceneWorkflow } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { createProductConfiguratorWorkflow } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { createProductionPrimitiveTextureIntent } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { crowds } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { decals } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { describeProductionSpotShadow } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { editor } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { evaluatePromptAnimationPublishReadiness } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { gameAssetValidation } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/assets`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/assets`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { GLTFLoader } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { inspectAsset } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/assets`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/assets`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { inspectGLTFAsset } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { listExternalParityEnvironmentTargets } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { loadAsset } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/assets`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/assets`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { loadRenderableAsset } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { meshVehicleSurface } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { mipChainBytesCoarseToFine } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { navigation } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { normalizeSceneSnapshot } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { normalizeTextureBudgetBytes } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { quaterniusGameReadyFighterValidationContract } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/renderer`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/renderer`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { Renderer } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { resolveProductionRuntimeShadowTuning } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { resolveProductionShadowCasterIndex } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { sky } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { summarizeExternalParityGLTFCorpus } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { unsafeModelUrl } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { upgradeProductionPrimitiveTextures } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { validatePlatformerMotion } from "../agent-api/index.js";
-/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in the next minor once its blocking lane's request lands. */
+/** @deprecated Use `@aura3d/engine/devtools`. Kept at 4.0.0 — removes in 5.0.0 once its blocking lane's request lands. */
 export { validateQuaterniusGameReadyFighterAsset } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { water } from "../agent-api/index.js";
-/** @deprecated No replacement — removes next minor. Kept at 4.0.0 once its blocking lane's request lands. */
+/** @deprecated No replacement — removes in 5.0.0. Kept at 4.0.0 once its blocking lane's request lands. */
 export { weather } from "../agent-api/index.js";
 // ── Lane-facing leaves consumed by shipped tests (prd02/prd03 contract
 // impls) — these names live on leaf modules, not the agent-api barrel, so

package/dist/engine/public/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/engine/src/public/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/engine/src/public/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6EAA6E;AAC7E,OAAO,mBAAmB,CAAC;AAE3B,2EAA2E;AAC3E,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,sBAAsB,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,OAAO,EAAE,oBAAoB,EAAE,kCAAkC,EAAE,0CAA0C,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,aAAa,EAAE,6BAA6B,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,cAAc,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,eAAe,EAAE,UAAU,EAAE,aAAa,EAAE,uBAAuB,EAAE,eAAe,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,4BAA4B,EAAE,sCAAsC,EAAE,2DAA2D,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,WAAW,EAAE,kBAAkB,EAAE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,iBAAiB,EAAE,GAAG,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,mBAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,8BAA8B,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,cAAc,EAAE,eAAe,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,2BAA2B,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,0BAA0B,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,cAAc,EAAE,sBAAsB,EAAE,WAAW,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,eAAe,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEz3G,0CAA0C;AAC1C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEzJ,wGAAwG;AACxG,2GAA2G;AAC3G,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAGvK,0HAA0H;AAC1H,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,2HAA2H;AAC3H,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,2HAA2H;AAC3H,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,2HAA2H;AAC3H,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,2HAA2H;AAC3H,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,2HAA2H;AAC3H,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAevD,2GAA2G;AAC3G,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAKxD,0HAA0H;AAC1H,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,2GAA2G;AAC3G,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,2GAA2G;AAC3G,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,0HAA0H;AAC1H,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,0HAA0H;AAC1H,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,2GAA2G;AAC3G,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,2GAA2G;AAC3G,OAAO,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AACzE,2GAA2G;AAC3G,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,2GAA2G;AAC3G,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,0HAA0H;AAC1H,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,2GAA2G;AAC3G,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,0HAA0H;AAC1H,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,2GAA2G;AAC3G,OAAO,EAAE,uCAAuC,EAAE,MAAM,uBAAuB,CAAC;AAChF,2GAA2G;AAC3G,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,2GAA2G;AAC3G,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,2GAA2G;AAC3G,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAC1E,2GAA2G;AAC3G,OAAO,EAAE,sCAAsC,EAAE,MAAM,uBAAuB,CAAC;AAC/E,2GAA2G;AAC3G,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,2GAA2G;AAC3G,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,2GAA2G;AAC3G,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,2GAA2G;AAC3G,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,0HAA0H;AAC1H,OAAO,EAAE,uCAAuC,EAAE,MAAM,uBAAuB,CAAC;AAChF,0HAA0H;AAC1H,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAK5D,wHAAwH;AACxH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,2GAA2G;AAC3G,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,wHAAwH;AACxH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,2GAA2G;AAC3G,OAAO,EAAE,oCAAoC,EAAE,MAAM,uBAAuB,CAAC;AAC7E,2GAA2G;AAC3G,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,wHAAwH;AACxH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,2GAA2G;AAC3G,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,2GAA2G;AAC3G,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,2GAA2G;AAC3G,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,2GAA2G;AAC3G,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,2GAA2G;AAC3G,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,0HAA0H;AAC1H,OAAO,EAAE,4CAA4C,EAAE,MAAM,uBAAuB,CAAC;AACrF,0HAA0H;AAC1H,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,2GAA2G;AAC3G,OAAO,EAAE,oCAAoC,EAAE,MAAM,uBAAuB,CAAC;AAC7E,2GAA2G;AAC3G,OAAO,EAAE,kCAAkC,EAAE,MAAM,uBAAuB,CAAC;AAC3E,2GAA2G;AAC3G,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,2GAA2G;AAC3G,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAC1E,2GAA2G;AAC3G,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,2GAA2G;AAC3G,OAAO,EAAE,kCAAkC,EAAE,MAAM,uBAAuB,CAAC;AAC3E,2GAA2G;AAC3G,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,0HAA0H;AAC1H,OAAO,EAAE,uCAAuC,EAAE,MAAM,uBAAuB,CAAC;AAChF,2GAA2G;AAC3G,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,2GAA2G;AAC3G,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,wEAAwE;AACxE,0EAA0E;AAC1E,2EAA2E;AAC3E,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,4BAA4B,CAAC;AAMpC,OAAO,EAAE,kCAAkC,EAAE,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EACL,UAAU,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,SAAS,EACT,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAuB/B,gFAAgF;AAChF,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC/D,4CAA4C;AAC5C,OAAO,EAAE,EAAE,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/engine/qa/countedRng.d.ts

@@ -0,0 +1,16 @@
+/** Seeded random stream (mulberry32) that counts its draws, so replays can assert the exact draw count. */
+export interface QaCountedRng {
+    readonly seed: number;
+    /** Number of draws taken since the last `reset`. */
+    readonly count: number;
+    /** Uniform float in [0, 1). */
+    next(): number;
+    /** Uniform float in [min, max). */
+    range(min: number, max: number): number;
+    /** Integer in [min, maxExclusive). */
+    int(min: number, maxExclusive: number): number;
+    /** Restart the stream (optionally with a new seed) and zero the draw counter. */
+    reset(seed?: number): void;
+}
+export declare function createCountedRng(seed?: number): QaCountedRng;
+//# sourceMappingURL=countedRng.d.ts.map

package/dist/engine/qa/countedRng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"countedRng.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/qa/countedRng.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,IAAI,IAAI,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,sCAAsC;IACtC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/C,iFAAiF;IACjF,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,SAAI,GAAG,YAAY,CAoCvD"}

package/dist/engine/qa/countedRng.js

@@ -0,0 +1,40 @@
+export function createCountedRng(seed = 1) {
+    let state = seed >>> 0;
+    let currentSeed = seed;
+    let count = 0;
+    const next = () => {
+        count++;
+        state = (state + 0x6d2b79f5) >>> 0;
+        let t = state;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+    return {
+        get seed() {
+            return currentSeed;
+        },
+        get count() {
+            return count;
+        },
+        next,
+        range(min, max) {
+            if (min > max)
+                throw new RangeError("min must be <= max");
+            return min + (max - min) * next();
+        },
+        int(min, maxExclusive) {
+            if (!Number.isInteger(min) || !Number.isInteger(maxExclusive) || min >= maxExclusive) {
+                throw new RangeError("int requires integer min < maxExclusive.");
+            }
+            return min + Math.floor(next() * (maxExclusive - min));
+        },
+        reset(nextSeed) {
+            if (nextSeed !== undefined)
+                currentSeed = nextSeed;
+            state = currentSeed >>> 0;
+            count = 0;
+        }
+    };
+}
+//# sourceMappingURL=countedRng.js.map

package/dist/engine/qa/countedRng.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"countedRng.js","sourceRoot":"","sources":["../../../../../packages/engine/src/qa/countedRng.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,gBAAgB,CAAC,IAAI,GAAG,CAAC;IACvC,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC;IACvB,IAAI,WAAW,GAAG,IAAI,CAAC;IACvB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,IAAI,GAAG,GAAW,EAAE;QACxB,KAAK,EAAE,CAAC;QACR,KAAK,GAAG,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,KAAK,CAAC;QACd,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IAC/C,CAAC,CAAC;IACF,OAAO;QACL,IAAI,IAAI;YACN,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,IAAI,KAAK;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI;QACJ,KAAK,CAAC,GAAG,EAAE,GAAG;YACZ,IAAI,GAAG,GAAG,GAAG;gBAAE,MAAM,IAAI,UAAU,CAAC,oBAAoB,CAAC,CAAC;YAC1D,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;QACpC,CAAC;QACD,GAAG,CAAC,GAAG,EAAE,YAAY;YACnB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,GAAG,IAAI,YAAY,EAAE,CAAC;gBACrF,MAAM,IAAI,UAAU,CAAC,0CAA0C,CAAC,CAAC;YACnE,CAAC;YACD,OAAO,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,KAAK,CAAC,QAAQ;YACZ,IAAI,QAAQ,KAAK,SAAS;gBAAE,WAAW,GAAG,QAAQ,CAAC;YACnD,KAAK,GAAG,WAAW,KAAK,CAAC,CAAC;YAC1B,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/engine/qa/fixedStepLoop.d.ts

@@ -0,0 +1,43 @@
+export interface FixedStepLoopOptions {
+    /** Advance the simulation by one fixed step (`stepSeconds`). */
+    readonly step: (stepSeconds: number, stepIndex: number) => void;
+    /** Present the current state; called once per animation frame (after its steps) and once at the end of `advance`. */
+    readonly render?: (frameSeconds: number) => void;
+    /** Fixed step length in seconds. Default 1/60. */
+    readonly stepSeconds?: number;
+    /** Most steps one frame may run before the remaining time is dropped. Default 6. */
+    readonly maxCatchUpSteps?: number;
+    /** A frame longer than this is clamped (tab switches, debugger pauses). Default 0.1. */
+    readonly maxFrameSeconds?: number;
+    /** Shortest frame time used for the accumulator. Default 0.001. */
+    readonly minFrameSeconds?: number;
+    /** Manual mode: the loop never advances on its own; only `advance(n)` moves it (QA runs). */
+    readonly manual?: boolean;
+    /** Returning false pauses the loop (for example before the app is ready) without losing the clock. */
+    readonly isActive?: () => boolean;
+    /** Injectable clock and scheduler for tests. Default `performance.now` and `requestAnimationFrame`. */
+    readonly now?: () => number;
+    readonly schedule?: (callback: (nowMs: number) => void) => unknown;
+    readonly cancel?: (handle: unknown) => void;
+}
+export interface FixedStepLoop {
+    /** Begin scheduling frames. Idempotent. */
+    start(): void;
+    stop(): void;
+    readonly running: boolean;
+    manual: boolean;
+    /** Total simulation steps executed through this loop (live and manual). */
+    readonly steps: number;
+    /** Seconds of unsimulated time carried to the next frame. */
+    readonly accumulator: number;
+    /** Run one animation frame at `nowMs` (what the scheduler calls); returns the steps it executed. */
+    tick(nowMs: number): number;
+    /** Run exactly `count` steps now, ignoring the clock, then render once. Returns the step count. */
+    advance(count: number, beforeStep?: (indexInBatch: number) => void): number;
+}
+/**
+ * The accumulator loop every port hand-rolled: variable frame time in, fixed simulation steps out, with the
+ * same clamping and catch-up guard, a manual mode for deterministic QA, and one render per frame.
+ */
+export declare function createFixedStepLoop(options: FixedStepLoopOptions): FixedStepLoop;
+//# sourceMappingURL=fixedStepLoop.d.ts.map

package/dist/engine/qa/fixedStepLoop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixedStepLoop.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/qa/fixedStepLoop.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,qHAAqH;IACrH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,kDAAkD;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,oFAAoF;IACpF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,wFAAwF;IACxF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,mEAAmE;IACnE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,sGAAsG;IACtG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;IAClC,uGAAuG;IACvG,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oGAAoG;IACpG,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,mGAAmG;IACnG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAAC;CAC7E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA0EhF"}

package/dist/engine/qa/fixedStepLoop.js

@@ -0,0 +1,83 @@
+/**
+ * The accumulator loop every port hand-rolled: variable frame time in, fixed simulation steps out, with the
+ * same clamping and catch-up guard, a manual mode for deterministic QA, and one render per frame.
+ */
+export function createFixedStepLoop(options) {
+    const stepSeconds = options.stepSeconds ?? 1 / 60;
+    const maxCatchUp = options.maxCatchUpSteps ?? 6;
+    const maxFrame = options.maxFrameSeconds ?? 0.1;
+    const minFrame = options.minFrameSeconds ?? 0.001;
+    if (!(stepSeconds > 0))
+        throw new RangeError("stepSeconds must be > 0");
+    const now = options.now ?? (() => (typeof performance === "undefined" ? Date.now() : performance.now()));
+    const schedule = options.schedule ?? ((cb) => requestAnimationFrame(cb));
+    const cancel = options.cancel ?? ((handle) => cancelAnimationFrame(handle));
+    let running = false;
+    let handle;
+    let last = 0;
+    let accumulator = 0;
+    let steps = 0;
+    const runStep = () => {
+        options.step(stepSeconds, steps);
+        steps++;
+    };
+    const loop = {
+        manual: options.manual ?? false,
+        get running() {
+            return running;
+        },
+        get steps() {
+            return steps;
+        },
+        get accumulator() {
+            return accumulator;
+        },
+        tick(nowMs) {
+            const frameSeconds = Math.min(maxFrame, Math.max(minFrame, (nowMs - last) / 1000));
+            last = nowMs;
+            if (loop.manual || (options.isActive && !options.isActive()))
+                return 0;
+            accumulator += frameSeconds;
+            let executed = 0;
+            while (accumulator >= stepSeconds && executed < maxCatchUp) {
+                accumulator -= stepSeconds;
+                runStep();
+                executed++;
+            }
+            if (executed === maxCatchUp && accumulator >= stepSeconds)
+                accumulator = 0;
+            options.render?.(frameSeconds);
+            return executed;
+        },
+        advance(count, beforeStep) {
+            const n = Math.max(0, Math.trunc(count));
+            for (let i = 0; i < n; i++) {
+                beforeStep?.(i);
+                runStep();
+            }
+            options.render?.(stepSeconds);
+            return n;
+        },
+        start() {
+            if (running)
+                return;
+            running = true;
+            last = now();
+            const frame = (nowMs) => {
+                if (!running)
+                    return;
+                handle = schedule(frame);
+                loop.tick(nowMs);
+            };
+            handle = schedule(frame);
+        },
+        stop() {
+            running = false;
+            if (handle !== undefined)
+                cancel(handle);
+            handle = undefined;
+        }
+    };
+    return loop;
+}
+//# sourceMappingURL=fixedStepLoop.js.map

package/dist/engine/qa/fixedStepLoop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixedStepLoop.js","sourceRoot":"","sources":["../../../../../packages/engine/src/qa/fixedStepLoop.ts"],"names":[],"mappings":"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"}

package/dist/engine/qa/hooks.d.ts

@@ -0,0 +1,80 @@
+/** The slice of an `AuraApp` the generated hooks read; every member is optional so partial apps work. */
+export interface QaHookApp {
+    capture?(options: {
+        type: "png-blob";
+    }): Promise<unknown>;
+    diagnostics?(): unknown;
+    /** Renderer info: either a getter function or the info object itself (`AuraApp.info`). */
+    readonly info?: unknown;
+}
+export interface QaHooksOptions<S, I, X extends object = {}> {
+    /** True once the app finished booting. */
+    readonly ready: () => boolean;
+    /** Plain-data snapshot of the simulation (compared against recorded references). */
+    readonly state: () => S;
+    /** Advance `n` simulation steps (input applies to the first step) and present once. Default: not installed. */
+    readonly stepFrames?: (n: number, input?: Partial<I>) => void;
+    /** Rebuild the simulation, optionally with a new seed. */
+    readonly reset?: (seed?: number) => void;
+    /** Headless replay of a recorded script; returns the trace. */
+    readonly replay?: (script: string, ...rest: number[]) => unknown;
+    /** Start a run (press Start) without rendering a title flow. */
+    readonly begin?: () => void;
+    readonly seed?: number;
+    /** One compact trace row for the current step and the column names (for capture/replay tooling). */
+    readonly traceRow?: () => unknown;
+    readonly traceColumns?: readonly string[];
+    /** The mounted app (or a getter, because ports create it asynchronously). Powers `frame`, `pixels`, `info`, `diagnostics`. */
+    readonly app?: QaHookApp | null | (() => QaHookApp | null | undefined);
+    readonly routeHealth?: () => unknown;
+    readonly nodeCount?: () => number;
+    /** Game-specific hooks merged on top of the standard ones (they win on name clashes). */
+    readonly extras?: X;
+    /** Install target; defaults to `globalThis`. */
+    readonly target?: Record<string, unknown>;
+}
+export interface QaPixels {
+    readonly width: number;
+    readonly height: number;
+    readonly data: Uint8ClampedArray;
+}
+export interface QaStandardHooks<S, I> {
+    ready(): boolean;
+    readonly seed: number | undefined;
+    state(): S;
+    stepFrames(n: number, input?: Partial<I>): S;
+    reset(seed?: number): void;
+    replay(script: string, ...rest: number[]): unknown;
+    begin(): void;
+    traceRow(): unknown;
+    readonly traceColumns: readonly string[] | undefined;
+    frame(width?: number, height?: number, quality?: number): Promise<string>;
+    pixels(): Promise<QaPixels>;
+    info(): unknown;
+    diagnostics(): unknown;
+    routeHealth(): unknown;
+    nodeCount(): number;
+}
+export type QaHooks<S, I, X extends object = {}> = QaStandardHooks<S, I> & X;
+export interface InstalledQaHooks<S, I, X extends object = {}> {
+    readonly hooks: QaHooks<S, I, X>;
+    /** Name of the global the hooks live on, for example `__AURA_SPLAT_RUSH__`. */
+    readonly globalName: string;
+    /** Name of the global the first boot error is stored on, for example `__AURA_SPLAT_RUSH_ERROR__`. */
+    readonly errorGlobalName: string;
+    /** Record a boot/runtime error; the first error wins so later noise cannot hide the cause. */
+    reportError(error: unknown): void;
+    /** Remove the hooks (and the error global) from the target. */
+    uninstall(): void;
+}
+/** `splat-rush` -> `__AURA_SPLAT_RUSH__`. */
+export declare function qaHookGlobalName(name: string): string;
+/** `splat-rush` -> `__AURA_SPLAT_RUSH_ERROR__`. */
+export declare function qaErrorGlobalName(name: string): string;
+/**
+ * Install the `window.__AURA_<NAME>__` QA hooks browser specs, capture tools and the live smoke read:
+ * `ready`, `state`, `stepFrames`, `reset`, `replay`, `begin`, `traceRow`, `frame` (JPEG data URL), `pixels`
+ * (RGBA), `info`, `diagnostics`, `routeHealth` and `nodeCount`, plus any game-specific extras.
+ */
+export declare function installQaHooks<S, I = Record<string, unknown>, X extends object = {}>(name: string, options: QaHooksOptions<S, I, X>): InstalledQaHooks<S, I, X>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/engine/qa/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/qa/hooks.ts"],"names":[],"mappings":"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"}