@zylem/behaviors 0.8.10 → 0.8.11

package/dist/core.d.ts

@@ -1,10 +1,27 @@
-import { V as VelocityIntentMode, T as TransformState, f as BehaviorRuntime, S as StagePose, g as StageBehaviorSnapshot, h as StageThrusterOptions, i as StageTopDownOptions, j as StageShooter2DOptions, k as StageScreenWrapOptions, l as StageBoundaryDimValue, m as StageWorldBoundaryOptions, n as StageRicochetDimValue, o as StageRicochetOptions, p as StagePlatformer3DOptions, q as StagePlatformer2DOptions, r as StageFirstPersonOptions, s as StageFirstPersonInput, t as StageJumper2DOptions, u as StageJumper3DOptions, W as WasmStageRuntime, v as WasmStageRuntimeOptions, w as StageBodyKindValue, x as StageColliderShape, y as StageRenderSlot, z as StageRaycastHit, A as StageBodyInfo, C as StageDebugRender } from './behavior-descriptor-Dr8qmQ20.js';
-export { E as BaseBehaviorHandle, B as BehaviorDescriptor, F as BehaviorEntityLink, a as BehaviorHandle, b as BehaviorRef, c as BehaviorSystem, H as BehaviorSystemContext, d as BehaviorSystemFactory, I as CreateEntityFn, D as DefineBehaviorConfig, G as GameEntity, J as GameEntityOptions, K as STAGE_INPUT_BUTTON_JUMP, L as STAGE_INPUT_BUTTON_RUN, M as STAGE_INVALID_SLOT, N as StageBodyConfig, O as StageBodyKind, P as StageBoundaryDim, Q as StageColliderConfig, R as StageEvent, U as StageEventType, X as StageEventTypeValue, Y as StagePlatformerShapeSource, Z as StageRicochetDim, _ as StageRicochetReflection, $ as StageRicochetReflectionValue, a0 as StageTopDownPlane, a1 as StageTopDownPlaneValue, a2 as VelocityIntent, a3 as WasmSnapshotBackref, a4 as createTransformStore, a5 as createWasmStageRuntime, e as defineBehavior, a6 as readBehaviorSnapshot, a7 as readStageRenderSlot } from './behavior-descriptor-Dr8qmQ20.js';
-export { P as PhysicsBodyComponent, T as TransformComponent, c as createPhysicsBodyComponent, a as createTransformComponent, u as useBehavior } from './components-tct075-p.js';
-export { E as EntityWithBody, a as MoveableBodyLike, M as MoveableEntity, V as Vector, g as getPosition, b as getVelocity, m as makeMoveable, c as move, d as moveForwardXY, e as moveX, f as moveXY, h as moveXZ, i as moveY, j as moveZ, r as resetVelocity, s as setPosition, k as setPositionX, l as setPositionY, n as setPositionZ, w as wrapAround3D, o as wrapAroundXY } from './moveable-tkFsn7mE.js';
+export { ActiveBumperKickBehavior, AdjacentPanelSwapBehavior, CascadeChainCreditBehavior, ColumnCollapseBehavior, GarbageBlockConversionBehavior, MatchingEntity, MatchingPinballBehavior, PinballModeObjectivesBehavior, PoweredPinballFlipperBehavior, RisingStackPressureBehavior, SimultaneousMatchClearBehavior, SpringPlungerLaunchBehavior } from './matching-pinball.js';
+export { CalendarNpcRoutineBehavior, CropGrowthStagesBehavior, ExertionAndFatigueBehavior, FishingBiteAndHookBehavior, HarvestableFruitRegrowthBehavior, LifeEntity, LifeSimulationBehavior, LivestockDailyCareBehavior, RelationshipEventMemoryBehavior, RoomFurniturePlacementBehavior, SeasonalCropEligibilityBehavior, SoilMoistureCycleBehavior } from './life-simulation.js';
+export { ArmingProximityMineBehavior, BlockerChewTransitionBehavior, BudgetedWaveSchedulerBehavior, BurrowToBacklineBehavior, CostedGridDeploymentBehavior, DefenseEntity, LaneDefenseBehavior, LaneTargetAcquisitionBehavior, LastChanceLaneSweeperBehavior, LayeredBreakawayArmorBehavior, PeriodicResourceProductionBehavior, SingleUseObstacleVaultBehavior } from './lane-defense.js';
+export { CooperativeConstructionWorkBehavior, CooperativeObjectTransportBehavior, DayEndUnitRecallBehavior, DeliveredResourceConversionBehavior, GrowthStageMobilityBehavior, SpeciesHazardAffinityBehavior, SquadEntity, SquadFormationFollowBehavior, SquadRtsBehavior, SurfaceLatchAttackBehavior, ThrownWorkerDeploymentBehavior, WhistleRecallBehavior } from './squad-rts.js';
+export { CommanderPowerWindowBehavior, CounterattackAndFollowUpBehavior, FuelAmmunitionResupplyBehavior, MinMaxAttackRangeBehavior, PersistentUnitLossBehavior, ProgressiveBuildingCaptureBehavior, TacticalGridBehavior, TacticsEntity, TerrainDefenseModifierBehavior, TerrainMovementBudgetBehavior, TransportLoadUnloadBehavior, WeaponAdvantageCycleBehavior } from './tactical-grid.js';
+export { ActivePartnerSwapBehavior, BattleEntity, BudgetedPassiveLoadoutBehavior, CaptureAttemptResolutionBehavior, ConditionalEvolutionBehavior, EscapeAttemptBehavior, FieldFirstStrikeBehavior, PrioritySpeedTurnOrderBehavior, TimedBattleActionCommandBehavior, TurnBasedRpgBehavior, TurnDurationStatusBehavior, TypeEffectivenessMatrixBehavior } from './turn-based-rpg.js';
+export { ActionRpgBehavior, AffixBudgetGenerationBehavior, AutonomousFamiliarBehavior, ConsumableBeltSlotsBehavior, DamageToResourceLeechBehavior, DeathDropOwnershipBehavior, DurabilityAndRepairBehavior, EquipmentStatAggregationBehavior, ResourceDrainingTransformationBehavior, RpgEntity, SeededLootTableBehavior, TypedResistanceResolutionBehavior } from './action-rpg.js';
+export { ClubShotProfileBehavior, GolfRacketBehavior, LandingSpinTransferBehavior, LobAndDropPlacementBehavior, RacketContactTimingBehavior, RacketSpinShotBehavior, RallyPointAdjudicationBehavior, ServeAndFaultSequenceBehavior, SlopeAwarePuttingBehavior, SportsEntity, SwingPowerAccuracyBehavior, WindDragBallFlightBehavior } from './golf-racket.js';
+export { AirGrabTrickBehavior, LandingAlignmentBailBehavior, ManualBalanceBehavior, PrewoundSpinBehavior, RailGrindBalanceBehavior, RampLipLaunchBehavior, RepeatedTrickDevaluationBehavior, SkateEntity, SkateSnowboardBehavior, TrickEarnedBoostMeterBehavior, UnbankedTrickComboBehavior, WallRideBehavior } from './skate-snowboard.js';
+export { DriftChargeBoostBehavior, EnergyFundedRaceBoostBehavior, HoverTrackSuspensionBehavior, OrderedLapCheckpointsBehavior, PositionWeightedRaceItemsBehavior, RacingEntity, RacingVehiclesBehavior, SlipstreamDraftingBehavior, TrackFollowingHomingItemBehavior, VehicleDamageProgressionBehavior, VehicleSeatEntryExitBehavior, VehicleSideAttackBehavior } from './racing-vehicles.js';
+export { AdaptiveEncounterPressureBehavior, CompanionAbductionObjectiveBehavior, EncounterClearLockBehavior, EnvironmentalVaultActionBehavior, EscortFollowWaitBehavior, IngredientCombinationBehavior, SavePointCheckpointBehavior, SpatialInventoryPackingBehavior, StaggerFinisherOpportunityBehavior, SurvivalEntity, SurvivalResourcesBehavior, WeaponUpgradeTrackBehavior } from './survival-resources.js';
+import { cS as VelocityIntentMode, cQ as TransformState, cT as BehaviorRuntime, b8 as RhythmAbility, bc as RhythmOptions, bd as RhythmState, b9 as RhythmAction, aN as MatchingAbility, aR as MatchingOptions, aS as MatchingState, aO as MatchingAction, az as LifeAbility, aF as LifeOptions, aJ as LifeState, aA as LifeAction, a2 as DefenseAbility, a5 as DefenseOptions, a7 as DefenseState, a3 as DefenseAction, bC as SquadAbility, bF as SquadOptions, bG as SquadState, bD as SquadAction, bT as TacticsAbility, bX as TacticsOptions, bZ as TacticsState, bU as TacticsAction, q as BattleAbility, v as BattleOptions, w as BattleState, r as BattleAction, be as RpgAbility, bj as RpgOptions, bl as RpgState, bf as RpgAction, bx as SportsAbility, bz as SportsOptions, bB as SportsState, by as SportsAction, br as SkateAbility, bt as SkateOptions, bw as SkateState, bs as SkateAction, b3 as RacingAbility, b5 as RacingOptions, b7 as RacingState, b4 as RacingAction, bJ as SurvivalAbility, bN as SurvivalOptions, bP as SurvivalState, bK as SurvivalAction, M as CityAbility, R as CityOptions, T as CityState, ah as EncounterAbility, an as EncounterOptions, aq as EncounterState, al as EncounterHit, c4 as WeaponAbility, c8 as WeaponOptions, cd as WeaponState, c6 as WeaponInput, c7 as WeaponMode, ce as WeaponSurface, c9 as WeaponProjectileKind, ca as WeaponProjectileOptions, cb as WeaponProjectileState, c5 as WeaponCameraIntent, W as CombatAbility, _ as CombatOptions, $ as CombatState, Z as CombatInput, X as CombatAttack, Y as CombatHit, aU as PuzzleAbility, aW as PuzzleOptions, aY as PuzzleState, aV as PuzzleCommand, aX as PuzzleSegment, i as AdventureAbility, m as AdventureOptions, o as AdventureState, j as AdventureInput, k as AdventureObject, l as AdventureObjectState, ar as EnvironmentAbility, at as EnvironmentOptions, au as EnvironmentState, as as EnvironmentInput, aw as EnvironmentVolume, c0 as TubeRail, e as AcrobaticsAbility, g as AcrobaticsOptions, h as AcrobaticsState, cU as StagePose, cV as StageBehaviorSnapshot, cW as StageThrusterOptions, cX as StageTopDownOptions, cY as StageShooter2DOptions, cZ as StageScreenWrapOptions, c_ as StageBoundaryDimValue, c$ as StageWorldBoundaryOptions, d0 as StageRicochetDimValue, d1 as StageRicochetOptions, d2 as StagePlatformer3DOptions, d3 as StagePlatformer2DOptions, d4 as StageFirstPersonOptions, d5 as StageFirstPersonInput, d6 as StageJumper2DOptions, d7 as StageJumper3DOptions, d8 as WasmStageRuntime, d9 as WasmStageRuntimeOptions, da as StageBodyKindValue, db as StageColliderShape, bh as RpgEvent, ba as RhythmEvent, aQ as MatchingEvent, aC as LifeEvent, a4 as DefenseEvent, bE as SquadEvent, bW as TacticsEvent, t as BattleEvent, G as CITY_EVENTS, ac as ENCOUNTER_EVENTS, c2 as WEAPON_EVENTS, K as COMBAT_EVENTS, c as ADVENTURE_EVENT_KINDS, U as CityTarget, S as CityPoint, P as CityLinkKind, V as CityTraffic, Q as CityNoise, O as CityFootprint, N as CityDanger, ai as EncounterCandidate, aj as EncounterCover, ak as EncounterHazard, ap as EncounterRegion, am as EncounterLinkKind, ao as EncounterPhase, dc as StageRenderSlot, dd as StageRaycastHit, de as StageBodyInfo, df as StageDebugRender } from './behavior-descriptor-NS_qnzzp.js';
+export { A as ACROBATICS_ACTIONS, a as ADVENTURE_ABILITIES, b as ADVENTURE_BUTTONS, d as ADVENTURE_FLAGS, f as AcrobaticsInput, n as AdventureRole, B as BATTLE_ABILITIES, p as BATTLE_EVENTS, dg as BaseBehaviorHandle, s as BattleEight, u as BattleFour, x as BattleTriple, y as BehaviorDescriptor, dh as BehaviorEntityLink, z as BehaviorHandle, C as BehaviorRef, D as BehaviorSystem, di as BehaviorSystemContext, E as BehaviorSystemFactory, F as CITY_ABILITIES, H as CITY_INTENTS, I as CITY_LINKS, J as COMBAT_ABILITIES, L as COMBAT_PHASES, dj as CreateEntityFn, a0 as DEFENSE_ABILITIES, a1 as DEFENSE_EVENTS, a6 as DefenseReceipt, a8 as DefenseTarget, a9 as DefenseTile, aa as DefineBehaviorConfig, ab as ENCOUNTER_ABILITIES, ad as ENCOUNTER_INTENTS, ae as ENCOUNTER_LINKS, af as ENVIRONMENT_ABILITIES, ag as ENVIRONMENT_MODES, av as EnvironmentVector, cR as GameEntity, dk as GameEntityOptions, ax as LIFE_ABILITIES, ay as LIFE_EVENTS, aB as LifeAnimal, aD as LifeFurniture, aE as LifeMemory, aG as LifePerson, aH as LifePlot, aI as LifeSchedule, aK as LifeTree, aL as MATCHING_ABILITIES, aM as MATCHING_EVENTS, aP as MatchingCell, aT as PUZZLE_ABILITIES, aZ as PuzzleVector, a_ as RACING_ABILITIES, a$ as RHYTHM_ABILITIES, b0 as RHYTHM_EVENTS, b1 as RPG_ABILITIES, b2 as RPG_EVENTS, b6 as RacingPoint, bb as RhythmNote, bg as RpgAffix, bi as RpgItem, bk as RpgPoint, bm as SKATE_ABILITIES, bn as SPORTS_ABILITIES, bo as SQUAD_ABILITIES, bp as SQUAD_EVENTS, dl as STAGE_INPUT_BUTTON_JUMP, dm as STAGE_INPUT_BUTTON_RUN, dn as STAGE_INVALID_SLOT, bq as SURVIVAL_ABILITIES, bu as SkatePhase, bv as SkatePoint, bA as SportsPoint, bH as SquadTask, bI as SquadWorker, dp as StageBodyConfig, dq as StageBodyKind, dr as StageBoundaryDim, ds as StageColliderConfig, dt as StageEvent, du as StageEventType, dv as StageEventTypeValue, dw as StagePlatformerShapeSource, dx as StageRicochetDim, dy as StageRicochetReflection, dz as StageRicochetReflectionValue, dA as StageTopDownPlane, dB as StageTopDownPlaneValue, bL as SurvivalCheckpoint, bM as SurvivalItem, bO as SurvivalPoint, bQ as TACTICS_ABILITIES, bR as TACTICS_EVENTS, bS as TRAVERSAL_ABILITIES, bV as TacticsCell, bY as TacticsPower, b_ as TacticsStructure, b$ as TacticsUnit, dC as VelocityIntent, c1 as WEAPON_ABILITIES, c3 as WEAPON_PHASES, dD as WasmSnapshotBackref, cc as WeaponShot, cf as battleData, cg as battleOperation, ch as cityData, ci as combatAttackData, cj as combatButtons, ck as combatData, cl as combatHitData, dE as createTransformStore, dF as createWasmStageRuntime, cm as defenseData, cn as defenseOperation, co as defineBehavior, cp as encounterData, cq as lifeData, cr as lifeOperation, cs as matchingData, ct as matchingOperation, cu as puzzleCommandData, cv as puzzleData, cw as racingData, cx as racingOperation, dG as readBehaviorSnapshot, dH as readStageRenderSlot, cy as rhythmData, cz as rhythmOperation, cA as rpgData, cB as rpgOperation, cC as skateData, cD as skateOperation, cE as sportsData, cF as sportsOperation, cG as squadData, cH as squadOperation, cI as survivalData, cJ as survivalOperation, cK as tacticsData, cL as tacticsOperation, cM as weaponButtons, cN as weaponData, cO as weaponModeData, cP as weaponProjectileData } from './behavior-descriptor-NS_qnzzp.js';
+export { P as PhysicsBodyComponent, T as TransformComponent, c as createPhysicsBodyComponent, a as createTransformComponent, u as useBehavior } from './components-ClmBORMP.js';
+export { E as EntityWithBody, a as MoveableBodyLike, M as MoveableEntity, V as Vector, g as getPosition, b as getVelocity, m as makeMoveable, c as move, d as moveForwardXY, e as moveX, f as moveXY, h as moveXZ, i as moveY, j as moveZ, r as resetVelocity, s as setPosition, k as setPositionX, l as setPositionY, n as setPositionZ, w as wrapAround3D, o as wrapAroundXY } from './moveable-CXK2wEZL.js';
 export { V as VEC2_ONE, a as VEC2_ZERO, b as VEC3_ONE, c as VEC3_ZERO, d as Vec2, e as Vec2Components, f as Vec2Input, g as Vec3, h as Vec3Components, i as Vec3Input, j as isVec2Input, k as isVec3Input, n as normalizeVec2, l as normalizeVec3, t as toThreeVector2, m as toThreeVector3 } from './vector-s7GbCrVn.js';
 export { S as SyncStateMachine } from './sync-state-machine-CZyspBpj.js';
 export { F as FirstPersonPerspective } from './first-person-perspective-BxFHgFln.js';
+export { BUILTIN_BEHAVIORS, BuiltinBehaviorName, getRequiredRuntimeBehaviors } from './catalog.js';
+export { AlternateWeaponModeBehavior, BeamMissileCombinationBehavior, ChargeAndReleaseShotBehavior, DelayedShieldRegenerationBehavior, InterruptibleMagazineReloadBehavior, MaterialPenetratingShotBehavior, RemoteGuidedProjectileBehavior, StationaryAimModeBehavior, StickyGrenadeAttachmentBehavior, WeaponEntity, WeaponHeatAndVentBehavior, WeaponSystemsBehavior } from './weapon-systems.js';
+export { BossPhaseControllerBehavior, CombatAIBehavior, CoverPeekCycleBehavior, EncounterEntity, GrenadeDangerEvasionBehavior, LatentAmbushActivationBehavior, LeaderLossMoraleBehavior, LocalizedWeakPointDamageBehavior, ShootableProjectileInterceptionBehavior, SquadFlankAssignmentBehavior, TacticalBurstSelectionBehavior, ThreatTargetSelectionBehavior } from './combat-ai.js';
+export { AlarmCommunicationNetworkBehavior, CityEntity, ContextualDisguiseBehavior, FootprintTrailFollowingBehavior, LastSeenSearchBehavior, NoiseInvestigationBehavior, PedestrianPanicPropagationBehavior, PursuitEvasionDecayBehavior, StealthCityBehavior, TrafficJunctionYieldBehavior, VisionConeAwarenessBehavior, WantedLevelEscalationBehavior } from './stealth-city.js';
+export { CallAndResponsePatternBehavior, FretChordStrumBehavior, HammerOnPullOffChainBehavior, HoldReleaseRhythmBehavior, PerformanceFailureMeterBehavior, PhraseEarnedScorePowerBehavior, RhythmEntity, RhythmPerformanceBehavior, RhythmSceneRemixBehavior, SustainNoteTrackingBehavior, TempoMapChartPlayerBehavior, TimestampedRhythmJudgmentBehavior } from './rhythm-performance.js';
+export { B as BehaviorMetadata } from './behavior-metadata-Drm1zxI2.js';
 export { ILogger, ITransition, SyncCallback, t } from 'typescript-fsm';
 export { STAGE_EVENT_STRIDE, STAGE_INPUT_STRIDE, STAGE_RENDER_STRIDE, STAGE_SNAPSHOT_STRIDE, StageWasmExports } from '@zylem/runtime';
 import 'three';
@@ -21,12 +38,6 @@ interface VelocityIntentVector {
 declare function setVelocityIntent(store: TransformState, sourceId: string, vector: VelocityIntentVector, options?: VelocityIntentOptions): void;
 declare function clearVelocityIntent(store: TransformState, sourceId: string): void;
 
-/**
- * In-memory implementation of the {@link BehaviorRuntime} contract for unit
- * tests. Records every attach / input call per handle and lets tests seed
- * poses and behavior snapshots without instantiating the wasm runtime.
- */
-
 interface MockSlotState {
     pose: StagePose;
     snapshot: StageBehaviorSnapshot | null;
@@ -54,6 +65,114 @@ interface MockSlotState {
     } | null;
 }
 declare class MockBehaviorRuntime implements BehaviorRuntime {
+    attachRhythm(slot: number, abilities: readonly RhythmAbility[], options?: RhythmOptions): boolean;
+    detachRhythm(slot: number): boolean;
+    queryRhythm(_slot: number): RhythmState | null;
+    rhythmAction(slot: number, action: RhythmAction): boolean;
+    attachMatching(slot: number, abilities: readonly MatchingAbility[], options?: MatchingOptions): boolean;
+    detachMatching(slot: number): boolean;
+    queryMatching(_slot: number): MatchingState | null;
+    matchingAction(slot: number, action: MatchingAction): boolean;
+    attachLife(slot: number, abilities: readonly LifeAbility[], options?: LifeOptions): boolean;
+    detachLife(slot: number): boolean;
+    queryLife(_slot: number): LifeState | null;
+    lifeAction(slot: number, action: LifeAction): boolean;
+    attachDefense(slot: number, abilities: readonly DefenseAbility[], options?: DefenseOptions): boolean;
+    detachDefense(slot: number): boolean;
+    queryDefense(_slot: number): DefenseState | null;
+    defenseAction(slot: number, action: DefenseAction): boolean;
+    attachSquad(slot: number, abilities: readonly SquadAbility[], options?: SquadOptions): boolean;
+    detachSquad(slot: number): boolean;
+    querySquad(_slot: number): SquadState | null;
+    squadAction(slot: number, action: SquadAction): boolean;
+    attachTactics(slot: number, abilities: readonly TacticsAbility[], options?: TacticsOptions): boolean;
+    detachTactics(slot: number): boolean;
+    queryTactics(_slot: number): TacticsState | null;
+    tacticsAction(slot: number, action: TacticsAction): boolean;
+    attachBattle(slot: number, abilities: readonly BattleAbility[], options?: BattleOptions): boolean;
+    detachBattle(slot: number): boolean;
+    queryBattle(_slot: number): BattleState | null;
+    battleAction(slot: number, action: BattleAction): boolean;
+    attachRpg(slot: number, abilities: readonly RpgAbility[], options?: RpgOptions): boolean;
+    detachRpg(slot: number): boolean;
+    queryRpg(_slot: number): RpgState | null;
+    rpgAction(slot: number, action: RpgAction): boolean;
+    attachSports(slot: number, abilities: readonly SportsAbility[], options?: SportsOptions): boolean;
+    detachSports(slot: number): boolean;
+    querySports(_slot: number): SportsState | null;
+    sportsAction(slot: number, action: SportsAction): boolean;
+    attachSkate(slot: number, abilities: readonly SkateAbility[], options?: SkateOptions): boolean;
+    detachSkate(slot: number): boolean;
+    querySkate(_slot: number): SkateState | null;
+    skateAction(slot: number, action: SkateAction): boolean;
+    attachRacing(slot: number, abilities: readonly RacingAbility[], options?: RacingOptions): boolean;
+    detachRacing(slot: number): boolean;
+    queryRacing(_slot: number): RacingState | null;
+    racingAction(slot: number, action: RacingAction): boolean;
+    attachSurvival(slot: number, abilities: readonly SurvivalAbility[], options?: SurvivalOptions): boolean;
+    detachSurvival(slot: number): boolean;
+    querySurvival(_slot: number): SurvivalState | null;
+    survivalAction(slot: number, action: SurvivalAction): boolean;
+    attachCity(slot: number, abilities: readonly CityAbility[], options?: CityOptions): boolean;
+    detachCity(slot: number): boolean;
+    queryCity(slot: number): CityState | null;
+    cityLink(slot: number, other: number, kind: number, data: readonly number[]): boolean;
+    cityUnlink(slot: number, other: number, kind: number): boolean;
+    cityCommand(slot: number, kind: number, data: readonly number[]): boolean;
+    citySignal(slot: number, source: number, kind: number, sequence: number, data: readonly number[]): boolean;
+    attachEncounters(slot: number, abilities: readonly EncounterAbility[], options?: EncounterOptions): boolean;
+    detachEncounters(slot: number): boolean;
+    queryEncounters(slot: number): EncounterState | null;
+    encounterLink(slot: number, other: number, kind: number, data: readonly number[]): boolean;
+    encounterUnlink(slot: number, other: number, kind: number): boolean;
+    encounterCommand(slot: number, kind: number, value: number, data?: readonly number[]): boolean;
+    encounterHit(slot: number, source: number, region: number | null, hit: EncounterHit): boolean;
+    attachWeapons(slot: number, abilities: readonly WeaponAbility[], options?: WeaponOptions): boolean;
+    detachWeapons(slot: number): boolean;
+    queryWeapons(_slot: number): WeaponState | null;
+    weaponInput(slot: number, input: WeaponInput): boolean;
+    weaponMode(slot: number, index: 0 | 1, mode: WeaponMode): boolean;
+    weaponDamage(slot: number, amount: number, source: number | null): boolean;
+    weaponSurface(slot: number, surface: WeaponSurface): boolean;
+    launchWeaponProjectile(owner: number, slot: number, kind: WeaponProjectileKind, options?: WeaponProjectileOptions): boolean;
+    queryWeaponProjectile(_slot: number): WeaponProjectileState | null;
+    weaponCameraIntent(_slot: number): WeaponCameraIntent | null;
+    attachCombat(slot: number, abilities: readonly CombatAbility[], options?: CombatOptions): boolean;
+    detachCombat(slot: number): boolean;
+    queryCombat(_slot: number): CombatState | null;
+    combatInput(slot: number, input: CombatInput): boolean;
+    combatAttack(slot: number, index: number, attack: CombatAttack): boolean;
+    combatHit(slot: number, hit: CombatHit, source: number | null): boolean;
+    attachPuzzle(slot: number, ability: PuzzleAbility, options?: PuzzleOptions): boolean;
+    detachPuzzle(slot: number): boolean;
+    queryPuzzle(_slot: number): PuzzleState | null;
+    puzzleCommand(slot: number, command: PuzzleCommand): boolean;
+    puzzleLink(_slot: number, _other: number | null): boolean;
+    puzzleSegments(_slot: number): PuzzleSegment[];
+    attachAdventure(slot: number, abilities: readonly AdventureAbility[], options?: AdventureOptions): boolean;
+    detachAdventure(slot: number): boolean;
+    queryAdventure(_slot: number): AdventureState | null;
+    writeAdventureInput(slot: number, input: AdventureInput): void;
+    setAdventureObject(slot: number, object: AdventureObject | null): boolean;
+    queryAdventureObject(_slot: number): AdventureObjectState | null;
+    adventureProgress(_slot: number, _kind: number, _key: number, _value?: number): number;
+    attachEnvironment(slot: number, abilities: readonly EnvironmentAbility[], options?: EnvironmentOptions): boolean;
+    detachEnvironment(slot: number): boolean;
+    queryEnvironment(_slot: number): EnvironmentState | null;
+    writeEnvironmentInput(slot: number, input: EnvironmentInput): void;
+    setEnvironmentVolume(slot: number, volume: EnvironmentVolume | null): boolean;
+    setTubeRail(slot: number, rail: TubeRail | null): boolean;
+    attachAcrobatics(slot: number, abilities: readonly AcrobaticsAbility[], options?: AcrobaticsOptions): boolean;
+    setTraversalSurface(slot: number, kind: 'pole' | 'ceiling' | null): boolean;
+    setPossessable(slot: number, enabled: boolean): boolean;
+    startPossession(_owner: number, _target: number, _seconds?: number): boolean;
+    endPossession(_owner: number): boolean;
+    queryPossession(_owner: number): {
+        targetSlot: number;
+        remaining: number;
+    } | null;
+    queryAcrobatics(_slot: number): AcrobaticsState | null;
+    detachAcrobatics(slot: number): boolean;
     private slots;
     private slot;
     /** Seed the pose returned by {@link getPose} for a handle. */
@@ -119,20 +238,6 @@ declare class MockBehaviorRuntime implements BehaviorRuntime {
     setJumper3DInput(handle: number, jumpPressed: boolean): void;
 }
 
-/**
- * `Simulation` (a.k.a. `BehaviorWorld`) — the primary public abstraction of
- * `@zylem/behaviors`. It owns the wasm runtime lifecycle (one
- * `WebAssembly.Instance` of `@zylem/runtime` per simulation), the fixed
- * timestep accumulator, an entity registry mapping opaque
- * {@link EntityHandle}s to runtime slots, and per-step event translation
- * from raw stage events into typed {@link SimulationEvent}s.
- *
- * Hosts (e.g. `@zylem/game-lib`) call {@link createSimulation} once per
- * stage, `spawn()`/`despawn()` entities, call `update(delta)` once per
- * render frame, and read poses for rendering from the returned
- * {@link SimulationFrame}.
- */
-
 /**
  * Opaque, stable identifier for a simulation entity. `slot` is the raw
  * runtime slot index — treat it as an implementation detail owned by the
@@ -209,6 +314,125 @@ type SimulationEvent = {
     type: 'cooldownFired';
     entity: EntityHandle | null;
     cooldownId: number;
+} | {
+    type: 'survival';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: SurvivalAbility;
+    value: number;
+} | {
+    type: 'racing';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: RacingAbility;
+    value: number;
+} | {
+    type: 'skate';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: SkateAbility;
+    value: number;
+} | {
+    type: 'sports';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: SportsAbility;
+    value: number;
+} | {
+    type: 'rpg';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: RpgEvent;
+    value: number;
+} | {
+    type: 'rhythm';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: RhythmEvent;
+    value: number;
+} | {
+    type: 'matching';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: MatchingEvent;
+    value: number;
+} | {
+    type: 'life';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: LifeEvent;
+    value: number;
+} | {
+    type: 'defense';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: DefenseEvent;
+    value: number;
+} | {
+    type: 'squad';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: SquadEvent;
+    value: number;
+} | {
+    type: 'tactics';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: TacticsEvent;
+    value: number;
+} | {
+    type: 'battle';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: BattleEvent;
+    value: number;
+} | {
+    type: 'city';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: typeof CITY_EVENTS[number];
+    value: number;
+} | {
+    type: 'encounter';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: typeof ENCOUNTER_EVENTS[number];
+    value: number;
+} | {
+    type: 'weapon';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: typeof WEAPON_EVENTS[number];
+    value: number;
+} | {
+    type: 'combat';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: typeof COMBAT_EVENTS[number];
+    value: number;
+} | {
+    type: 'puzzle';
+    entity: EntityHandle | null;
+    ability: PuzzleAbility;
+    active: boolean;
+    value: number;
+} | {
+    type: 'adventure';
+    entity: EntityHandle | null;
+    target: EntityHandle | null;
+    kind: typeof ADVENTURE_EVENT_KINDS[number];
+    value: number;
+} | {
+    type: 'drowningDamage';
+    entity: EntityHandle | null;
+    amount: number;
+    total: number;
+    severity: number;
+} | {
+    type: 'groundPoundImpact';
+    entity: EntityHandle | null;
+    speed: number;
+    count: number;
 };
 /**
  * Snapshot of one `update()` call: how many fixed steps ran, the live render
@@ -295,6 +519,143 @@ declare class Simulation {
     private capturePreviousRender;
     private translateEvents;
     getPose(handle: EntityHandle, out?: StagePose): StagePose | null;
+    /** These ownership APIs require live handles from this Simulation. */
+    private live;
+    attachRhythm(handle: EntityHandle, abilities: readonly RhythmAbility[], options?: RhythmOptions): boolean;
+    detachRhythm(handle: EntityHandle): boolean;
+    getRhythmState(handle: EntityHandle): RhythmState | null;
+    rhythmAction(handle: EntityHandle, action: RhythmAction): boolean;
+    attachMatching(handle: EntityHandle, abilities: readonly MatchingAbility[], options?: MatchingOptions): boolean;
+    detachMatching(handle: EntityHandle): boolean;
+    getMatchingState(handle: EntityHandle): MatchingState | null;
+    matchingAction(handle: EntityHandle, action: MatchingAction<EntityHandle>): boolean;
+    attachLife(handle: EntityHandle, abilities: readonly LifeAbility[], options?: LifeOptions): boolean;
+    detachLife(handle: EntityHandle): boolean;
+    getLifeState(handle: EntityHandle): LifeState | null;
+    lifeAction(handle: EntityHandle, action: LifeAction<EntityHandle>): boolean;
+    attachDefense(handle: EntityHandle, abilities: readonly DefenseAbility[], options?: DefenseOptions): boolean;
+    detachDefense(handle: EntityHandle): boolean;
+    getDefenseState(handle: EntityHandle): DefenseState | null;
+    defenseAction(handle: EntityHandle, action: DefenseAction<EntityHandle>): boolean;
+    attachSquad(handle: EntityHandle, abilities: readonly SquadAbility[], options?: SquadOptions): boolean;
+    detachSquad(handle: EntityHandle): boolean;
+    getSquadState(handle: EntityHandle): SquadState | null;
+    squadAction(handle: EntityHandle, action: SquadAction<EntityHandle>): boolean;
+    attachTactics(handle: EntityHandle, abilities: readonly TacticsAbility[], options?: TacticsOptions): boolean;
+    detachTactics(handle: EntityHandle): boolean;
+    getTacticsState(handle: EntityHandle): TacticsState | null;
+    tacticsAction(handle: EntityHandle, action: TacticsAction<EntityHandle>): boolean;
+    attachBattle(handle: EntityHandle, abilities: readonly BattleAbility[], options?: BattleOptions): boolean;
+    detachBattle(handle: EntityHandle): boolean;
+    getBattleState(handle: EntityHandle): BattleState | null;
+    battleAction(handle: EntityHandle, action: BattleAction<EntityHandle>): boolean;
+    attachRpg(handle: EntityHandle, abilities: readonly RpgAbility[], options?: RpgOptions): boolean;
+    detachRpg(handle: EntityHandle): boolean;
+    getRpgState(handle: EntityHandle): RpgState | null;
+    rpgAction(handle: EntityHandle, action: RpgAction<EntityHandle>): boolean;
+    attachSports(handle: EntityHandle, abilities: readonly SportsAbility[], options?: SportsOptions): boolean;
+    detachSports(handle: EntityHandle): boolean;
+    getSportsState(handle: EntityHandle): SportsState | null;
+    sportsAction(handle: EntityHandle, action: SportsAction<EntityHandle>): boolean;
+    attachSkate(handle: EntityHandle, abilities: readonly SkateAbility[], options?: SkateOptions): boolean;
+    detachSkate(handle: EntityHandle): boolean;
+    getSkateState(handle: EntityHandle): SkateState | null;
+    skateAction(handle: EntityHandle, action: SkateAction<EntityHandle>): boolean;
+    attachRacing(handle: EntityHandle, abilities: readonly RacingAbility[], options?: RacingOptions): boolean;
+    detachRacing(handle: EntityHandle): boolean;
+    getRacingState(handle: EntityHandle): RacingState | null;
+    racingAction(handle: EntityHandle, action: RacingAction<EntityHandle>): boolean;
+    attachSurvival(handle: EntityHandle, abilities: readonly SurvivalAbility[], options?: SurvivalOptions): boolean;
+    detachSurvival(handle: EntityHandle): boolean;
+    getSurvivalState(handle: EntityHandle): SurvivalState | null;
+    survivalAction(handle: EntityHandle, action: SurvivalAction<EntityHandle>): boolean;
+    attachCity(handle: EntityHandle, abilities: readonly CityAbility[], options?: CityOptions): boolean;
+    detachCity(handle: EntityHandle): boolean;
+    getCityState(handle: EntityHandle): CityState | null;
+    private cityLink;
+    setCityTarget(handle: EntityHandle, target: EntityHandle, o?: CityTarget): boolean;
+    connectCityRadio(handle: EntityHandle, receiver: EntityHandle, channel?: number): boolean;
+    addCityNeighbor(handle: EntityHandle, neighbor: EntityHandle): boolean;
+    setCityJunction(handle: EntityHandle, junction: EntityHandle, exit: CityPoint, priority?: number): boolean;
+    addCityObserver(handle: EntityHandle, observer: EntityHandle): boolean;
+    removeCityLink(handle: EntityHandle, other: EntityHandle, kind: CityLinkKind): boolean;
+    private cityCommand;
+    setCityFacing(handle: EntityHandle, direction: CityPoint): boolean;
+    interruptCityReport(handle: EntityHandle): boolean;
+    setCityPursuitConditions(handle: EntityHandle, observed: boolean, inSearchZone: boolean): boolean;
+    /** Initialization only: seed B078 without needing B077. */
+    setCityPursuitScore(handle: EntityHandle, score: number): boolean;
+    setCityTraffic(handle: EntityHandle, input: CityTraffic): boolean;
+    setCityHearingMask(handle: EntityHandle, mask: number): boolean;
+    /** Initialization only, six strictly ascending thresholds, zero-based index. */
+    setCityResponseTier(handle: EntityHandle, index: number, threshold: number, responseMask: number): boolean;
+    private citySignal;
+    emitCityNoise(handle: EntityHandle, source: EntityHandle, o: CityNoise): boolean;
+    addCityFootprint(handle: EntityHandle, source: EntityHandle, o: CityFootprint): boolean;
+    startCityReport(handle: EntityHandle, sequence: number, channel?: number): boolean;
+    reportCityOffense(handle: EntityHandle, witness: EntityHandle, sequence: number, severity: number): boolean;
+    emitCityDanger(handle: EntityHandle, source: EntityHandle, o: CityDanger): boolean;
+    attachEncounters(handle: EntityHandle, abilities: readonly EncounterAbility[], options?: EncounterOptions): boolean;
+    detachEncounters(handle: EntityHandle): boolean;
+    getEncounterState(handle: EntityHandle): EncounterState | null;
+    private encounterLink;
+    setEncounterCandidate(handle: EntityHandle, other: EntityHandle, options?: EncounterCandidate): boolean;
+    setEncounterLeader(handle: EntityHandle, leader: EntityHandle): boolean;
+    addEncounterAlly(handle: EntityHandle, ally: EntityHandle): boolean;
+    setEncounterCover(handle: EntityHandle, anchor: EntityHandle, options: EncounterCover): boolean;
+    setEncounterHazard(handle: EntityHandle, source: EntityHandle, options: EncounterHazard): boolean;
+    setEncounterRegion(handle: EntityHandle, region: EntityHandle, options?: EncounterRegion): boolean;
+    removeEncounterLink(handle: EntityHandle, other: EntityHandle, kind: EncounterLinkKind): boolean;
+    triggerEncounter(handle: EntityHandle): boolean;
+    advanceEncounterPhase(handle: EntityHandle, phase: number): boolean;
+    setEncounterShotBudget(handle: EntityHandle, count: number): boolean;
+    setEncounterPhase(handle: EntityHandle, index: number, phase: EncounterPhase): boolean;
+    applyEncounterHit(handle: EntityHandle, source: EntityHandle, hit: EncounterHit, region?: EntityHandle | null): boolean;
+    attachWeapons(handle: EntityHandle, abilities: readonly WeaponAbility[], options?: WeaponOptions): boolean;
+    detachWeapons(handle: EntityHandle): boolean;
+    setWeaponInput(handle: EntityHandle, input: WeaponInput): boolean;
+    setWeaponMode(handle: EntityHandle, index: 0 | 1, mode: WeaponMode): boolean;
+    applyWeaponDamage(handle: EntityHandle, amount: number, source?: EntityHandle | null): boolean;
+    setWeaponSurface(handle: EntityHandle, surface: WeaponSurface): boolean;
+    launchWeaponProjectile(owner: EntityHandle, projectile: EntityHandle, kind: WeaponProjectileKind, options?: WeaponProjectileOptions): boolean;
+    getWeaponState(handle: EntityHandle): WeaponState | null;
+    getWeaponProjectileState(handle: EntityHandle): WeaponProjectileState | null;
+    getWeaponCameraIntent(handle: EntityHandle): WeaponCameraIntent | null;
+    attachCombat(handle: EntityHandle, abilities: readonly CombatAbility[], options?: CombatOptions): boolean;
+    detachCombat(handle: EntityHandle): boolean;
+    setCombatInput(handle: EntityHandle, input: CombatInput): boolean;
+    setCombatAttack(handle: EntityHandle, index: number, attack: CombatAttack): boolean;
+    applyCombatHit(handle: EntityHandle, hit?: CombatHit, source?: EntityHandle | null): boolean;
+    getCombatState(handle: EntityHandle): CombatState | null;
+    attachPuzzle(handle: EntityHandle, ability: PuzzleAbility, options?: PuzzleOptions): boolean;
+    detachPuzzle(handle: EntityHandle): boolean;
+    getPuzzleState(handle: EntityHandle): PuzzleState | null;
+    sendPuzzleCommand(handle: EntityHandle, command: PuzzleCommand): boolean;
+    setPuzzleLink(handle: EntityHandle, other: EntityHandle | null): boolean;
+    getPuzzleSegments(handle: EntityHandle): PuzzleSegment[];
+    attachAdventure(handle: EntityHandle, abilities: readonly AdventureAbility[], options?: AdventureOptions): boolean;
+    detachAdventure(handle: EntityHandle): boolean;
+    getAdventureState(handle: EntityHandle): AdventureState | null;
+    setAdventureInput(handle: EntityHandle, input: AdventureInput): boolean;
+    setAdventureObject(handle: EntityHandle, object: AdventureObject | null): boolean;
+    getAdventureObjectState(handle: EntityHandle): AdventureObjectState | null;
+    grantAdventureToken(handle: EntityHandle, key: number, count?: number): number;
+    getAdventureToken(handle: EntityHandle, key: number): number;
+    hasAdventureDiscovery(handle: EntityHandle, key: number): boolean;
+    attachEnvironment(handle: EntityHandle, abilities: readonly EnvironmentAbility[], options?: EnvironmentOptions): boolean;
+    detachEnvironment(handle: EntityHandle): boolean;
+    getEnvironmentState(handle: EntityHandle): EnvironmentState | null;
+    setEnvironmentInput(handle: EntityHandle, input: EnvironmentInput): boolean;
+    setEnvironmentVolume(handle: EntityHandle, volume: EnvironmentVolume | null): boolean;
+    setTubeRail(handle: EntityHandle, rail: TubeRail | null): boolean;
+    setTraversalSurface(handle: EntityHandle, kind: 'pole' | 'ceiling' | null): boolean;
+    setPossessable(handle: EntityHandle, enabled: boolean): boolean;
+    startPossession(owner: EntityHandle, target: EntityHandle, seconds?: number): boolean;
+    endPossession(owner: EntityHandle): boolean;
+    getPossession(owner: EntityHandle): {
+        target: EntityHandle;
+        remaining: number;
+    } | null;
     setPosition(handle: EntityHandle, x: number, y: number, z: number): boolean;
     setRotation(handle: EntityHandle, x: number, y: number, z: number, w: number): boolean;
     setLinearVelocity(handle: EntityHandle, x: number, y: number, z: number): boolean;
@@ -327,4 +688,4 @@ type BehaviorWorld = Simulation;
  */
 declare function createSimulation(options?: SimulationOptions): Promise<Simulation>;
 
-export { BehaviorRuntime, type BehaviorWorld, type EntityDefinition, type EntityHandle, MockBehaviorRuntime, Simulation, type SimulationBodyDefinition, type SimulationColliderDefinition, type SimulationEvent, type SimulationFrame, type SimulationOptions, StageBehaviorSnapshot, StageBodyInfo, StageBodyKindValue, StageBoundaryDimValue, StageColliderShape, StageDebugRender, StageFirstPersonInput, StageFirstPersonOptions, StageJumper2DOptions, StageJumper3DOptions, StagePlatformer2DOptions, StagePlatformer3DOptions, StagePose, StageRaycastHit, StageRenderSlot, StageRicochetDimValue, StageRicochetOptions, StageScreenWrapOptions, StageShooter2DOptions, StageThrusterOptions, StageTopDownOptions, StageWorldBoundaryOptions, TransformState, VelocityIntentMode, type VelocityIntentOptions, type VelocityIntentVector, WasmStageRuntime, WasmStageRuntimeOptions, clearVelocityIntent, createSimulation, setVelocityIntent };
+export { ADVENTURE_EVENT_KINDS, AcrobaticsAbility, AcrobaticsOptions, AcrobaticsState, AdventureAbility, AdventureInput, AdventureObject, AdventureObjectState, AdventureOptions, AdventureState, BattleAbility, BattleAction, BattleEvent, BattleOptions, BattleState, BehaviorRuntime, type BehaviorWorld, CITY_EVENTS, COMBAT_EVENTS, CityAbility, CityDanger, CityFootprint, CityLinkKind, CityNoise, CityOptions, CityPoint, CityState, CityTarget, CityTraffic, CombatAbility, CombatAttack, CombatHit, CombatInput, CombatOptions, CombatState, DefenseAbility, DefenseAction, DefenseEvent, DefenseOptions, DefenseState, ENCOUNTER_EVENTS, EncounterAbility, EncounterCandidate, EncounterCover, EncounterHazard, EncounterHit, EncounterLinkKind, EncounterOptions, EncounterPhase, EncounterRegion, EncounterState, type EntityDefinition, type EntityHandle, EnvironmentAbility, EnvironmentInput, EnvironmentOptions, EnvironmentState, EnvironmentVolume, LifeAbility, LifeAction, LifeEvent, LifeOptions, LifeState, MatchingAbility, MatchingAction, MatchingEvent, MatchingOptions, MatchingState, MockBehaviorRuntime, PuzzleAbility, PuzzleCommand, PuzzleOptions, PuzzleSegment, PuzzleState, RacingAbility, RacingAction, RacingOptions, RacingState, RhythmAbility, RhythmAction, RhythmEvent, RhythmOptions, RhythmState, RpgAbility, RpgAction, RpgEvent, RpgOptions, RpgState, Simulation, type SimulationBodyDefinition, type SimulationColliderDefinition, type SimulationEvent, type SimulationFrame, type SimulationOptions, SkateAbility, SkateAction, SkateOptions, SkateState, SportsAbility, SportsAction, SportsOptions, SportsState, SquadAbility, SquadAction, SquadEvent, SquadOptions, SquadState, StageBehaviorSnapshot, StageBodyInfo, StageBodyKindValue, StageBoundaryDimValue, StageColliderShape, StageDebugRender, StageFirstPersonInput, StageFirstPersonOptions, StageJumper2DOptions, StageJumper3DOptions, StagePlatformer2DOptions, StagePlatformer3DOptions, StagePose, StageRaycastHit, StageRenderSlot, StageRicochetDimValue, StageRicochetOptions, StageScreenWrapOptions, StageShooter2DOptions, StageThrusterOptions, StageTopDownOptions, StageWorldBoundaryOptions, SurvivalAbility, SurvivalAction, SurvivalOptions, SurvivalState, TacticsAbility, TacticsAction, TacticsEvent, TacticsOptions, TacticsState, TransformState, TubeRail, VelocityIntentMode, type VelocityIntentOptions, type VelocityIntentVector, WEAPON_EVENTS, WasmStageRuntime, WasmStageRuntimeOptions, WeaponAbility, WeaponCameraIntent, WeaponInput, WeaponMode, WeaponOptions, WeaponProjectileKind, WeaponProjectileOptions, WeaponProjectileState, WeaponState, WeaponSurface, clearVelocityIntent, createSimulation, setVelocityIntent };