2026-10-13 19:55:18 +02:00
using System ;
using System.Collections.Generic ;
2026-10-13 18:17:14 +02:00
using System.Linq ;
2026-10-13 21:19:53 +02:00
using System.Reflection ;
2026-10-13 18:17:14 +02:00
using CultMath ;
using GameCult.Caching ;
using Xunit ;
using static CultMath . math ;
using float3 = CultMath . float3 ;
// Cut ew-claims-in-the-book (aetheria-ew, classify-from-belief, lie-is-own-emission, belief-one-writer): every act a ship
// makes is stamped with the class its ship claims for the item (the true item's data unless claimed otherwise), the
// observer's book keeps that claim beside the true item, and every classifying read takes the claim while aim keeps the
// truth. The fixtures drive the production path: real ships fire, ping and lock inside Zone.Update.
public sealed partial class ContactRevealTests
{
private EquippableItemData DataOf ( string name ) = > ( EquippableItemData ) _items . ItemData . GetByName < ItemData > ( name ) ;
private static PerformanceStat Span ( float min , float max ) = > new PerformanceStat { Min = min , Max = max } ;
// ---- ClaimsDefaultToTheTruth ----
[Fact]
public void ClaimsDefaultToTheTruth ( )
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" } ) ;
var o = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Eye" } ) ;
var gun = Guns ( e ) [ 0 ] ;
Fire ( e , gun ) ;
Assert . Same ( gun . Data , Assert . Single ( o . RevealsOf ( e ) ) . Claimed ) ; // a fired gun claims its own design
// The hull belief: none below the gear threshold, the true hull at it (TargetGearInfoThreshold .8).
o . EntityInfoGathered [ e ] = . 79f ;
Assert . Null ( o . ContactOf ( e ) . Profile ) ;
o . EntityInfoGathered [ e ] = . 8f ;
Assert . Same ( e . HullData , o . ContactOf ( e ) . Profile ) ;
}
[Fact]
public void AHeardPingDefaultsToTheTruth ( )
{
var p = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Shout" } ) ;
var hearer = Add ( float3 ( 149 , 0 , 0 ) , new [ ] { "Eye" } ) ; // off the beam: heard, never painted
PingAt ( p ) ;
Assert . Same ( SensorItemOf ( p ) . Data , Assert . Single ( hearer . RevealsOf ( p ) ) . Claimed ) ;
}
[Fact]
public void APaintDefaultsToTheTruth ( )
{
var ( locker , target ) = LockOn ( "Locker" ) ;
Tick ( . 5f ) ;
Tick ( . 5f ) ;
var lockItem = locker . Equipment . Single ( i = > i . Behaviors . Any ( b = > b is LockWeapon ) ) ;
Assert . Same ( lockItem . Data , Assert . Single ( target . IncomingPaints ) . EmitterClass ) ;
Assert . Same ( lockItem . Data , Assert . Single ( target . RevealsOf ( locker ) ) . Claimed ) ;
}
// ---- AnItemClaimIsWhatTheBookSays ----
// The book keeps the true item as its key and the claim beside it; RevealedWeapons lists it by the claim, and aim
// still opens on the true item. Mutation: stamp item.Data in SetSignature, or have RecordReveal store the true data.
[Fact]
public void AnItemClaimIsWhatTheBookSays ( )
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" } ) ;
var o = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Eye" } ) ;
var gun = Guns ( e ) [ 0 ] ;
var other = DataOf ( "Beam" ) ;
e . Claim ( gun , other ) ;
Fire ( e , gun ) ;
var reveal = Assert . Single ( o . RevealsOf ( e ) ) ;
Assert . Same ( gun , reveal . Item ) ;
Assert . Same ( other , reveal . Claimed ) ;
Assert . Same ( gun , Assert . Single ( o . RevealedWeapons ( e ) ) . Item ) ;
Assert . True ( FireControl . IsRevealed ( o , gun ) ) ;
}
// ---- AGunClaimedAsNonWeaponIsNotListed ----
[Fact]
public void AGunClaimedAsNonWeaponIsNotListed ( )
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" } ) ;
var o = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Eye" } ) ;
var gun = Guns ( e ) [ 0 ] ;
e . Claim ( gun , DataOf ( "Eye" ) ) ;
Fire ( e , gun ) ;
Assert . Empty ( o . RevealedWeapons ( e ) ) ;
Assert . Single ( o . RevealsOf ( e ) ) ; // the book still holds the gun, for aim
Assert . True ( FireControl . IsRevealed ( o , gun ) ) ;
}
// ---- AHullClaimIsTheProfile ----
// Mutation: ContactOf reads subject.HullData, or reads the claim below the gear threshold.
[Fact]
public void AHullClaimIsTheProfile ( )
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" } ) ;
var o = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Eye" } ) ;
var truth = e . HullData ;
var hull = e . Hull ;
var decoy = new HullData { Name = "Decoy" } ;
e . Claim ( decoy ) ;
Fire ( e , Guns ( e ) [ 0 ] ) ;
o . EntityInfoGathered [ e ] = . 79f ;
Assert . Null ( o . ContactOf ( e ) . Profile ) ;
o . EntityInfoGathered [ e ] = . 8f ;
Assert . Same ( decoy , o . ContactOf ( e ) . Profile ) ;
Assert . Same ( truth , e . HullData ) ; // the truth is untouched: damage, shape and physics keep it
Assert . Same ( hull , e . Hull ) ;
}
// ---- APaintCarriesTheClaim ----
[Fact]
public void APaintCarriesTheClaim ( )
{
var locker = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Locker" } ) ;
var target = Add ( float3 ( 0 , 0 , 200 ) ) ;
var lockItem = locker . Equipment . Single ( i = > i . Behaviors . Any ( b = > b is LockWeapon ) ) ;
var claimed = DataOf ( "Eye" ) ;
locker . Claim ( lockItem , claimed ) ;
locker . SetIff ( target , true ) ;
locker . EntityInfoGathered [ target ] = 1f ;
locker . SetTarget ( target ) ;
locker . Aim = normalize ( target . Position - locker . Position ) ;
Tick ( . 5f ) ;
Tick ( . 5f ) ;
Assert . Same ( claimed , Assert . Single ( target . IncomingPaints ) . EmitterClass ) ;
var reveal = Assert . Single ( target . RevealsOf ( locker ) ) ;
Assert . Same ( lockItem , reveal . Item ) ;
Assert . Same ( claimed , reveal . Claimed ) ;
}
2026-10-14 13:54:43 +02:00
// What a bearing marker is labelled with: the classes the subject claimed, never the item's true data; one class once.
[Fact]
public void ClaimedClassesNameTheClaim ( )
{
var locker = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Locker" , "Gun" } ) ;
2026-10-14 14:08:06 +02:00
var target = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Eye" } ) ;
2026-10-14 13:54:43 +02:00
var lockItem = locker . Equipment . Single ( i = > i . Behaviors . Any ( b = > b is LockWeapon ) ) ;
var gunItem = Guns ( locker ) [ 0 ] ;
var claimed = DataOf ( "Eye" ) ;
locker . Claim ( lockItem , claimed ) ;
locker . Claim ( gunItem , claimed ) ;
locker . SetIff ( target , true ) ;
Fire ( locker , gunItem ) ;
locker . EntityInfoGathered [ target ] = 1f ;
locker . SetTarget ( target ) ;
locker . Aim = normalize ( target . Position - locker . Position ) ;
Tick ( . 5f ) ;
Tick ( . 5f ) ;
var items = target . RevealsOf ( locker ) . Select ( r = > r . Item ) . ToArray ( ) ;
Assert . True ( items . Contains ( lockItem ) & & items . Contains ( gunItem ) , "fixture: two items revealed, both claiming Eye" ) ;
Assert . Same ( claimed , Assert . Single ( target . ClaimedClasses ( locker ) ) ) ; // two reveals of one class list it once
Assert . NotSame ( lockItem . Data , claimed ) ; // fixture: the claim is not the truth
}
2026-10-14 16:12:44 +02:00
// A lie within a category is the ordinary lie: a gun that claims another weapon class is labelled with the claim.
[Fact]
public void ClaimedClassesNameTheClaimWithinACategory ( )
{
var e = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Gun" } ) ;
var o = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Eye" } ) ;
var gun = Guns ( e ) [ 0 ] ;
var claimed = DataOf ( "Beam" ) ;
Assert . True ( gun . Data . Behaviors . Any ( b = > b is WeaponData ) & & claimed . Behaviors . Any ( b = > b is WeaponData ) , "fixture: truth and claim are both weapons" ) ;
e . Claim ( gun , claimed ) ;
Fire ( e , gun ) ;
Assert . Same ( claimed , Assert . Single ( o . ClaimedClasses ( e ) ) ) ;
Assert . NotSame ( gun . Data , claimed ) ; // fixture: the claim is not the truth
}
2026-10-14 14:11:56 +02:00
// The label's order is the claimed names', never the order the reveals were made in.
[Fact]
public void ClaimedClassesAreOrderedByName ( )
{
var locker = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Locker" , "Gun" } ) ;
var target = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Eye" } ) ;
var lockItem = locker . Equipment . Single ( i = > i . Behaviors . Any ( b = > b is LockWeapon ) ) ;
var gunItem = Guns ( locker ) [ 0 ] ;
locker . Claim ( lockItem , DataOf ( "Eye" ) ) ;
locker . Claim ( gunItem , DataOf ( "Shout" ) ) ;
locker . SetIff ( target , true ) ;
Fire ( locker , gunItem ) ; // the later name is revealed first
locker . EntityInfoGathered [ target ] = 1f ;
locker . SetTarget ( target ) ;
locker . Aim = normalize ( target . Position - locker . Position ) ;
Tick ( . 5f ) ;
Tick ( . 5f ) ;
Assert . True ( target . RevealsOf ( locker ) . Count ( ) > = 2 , "fixture: both items revealed" ) ;
Assert . Equal ( new [ ] { "Eye" , "Shout" } , target . ClaimedClasses ( locker ) . Select ( c = > c . Name ) ) ;
}
2026-10-13 18:17:14 +02:00
// The emission a ping makes is stamped by the ship that makes it. Mutation: Emit stamps item.Data.
[Fact]
public void AHeardPingCarriesTheClaim ( )
{
var p = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Shout" } ) ;
var hearer = Add ( float3 ( 149 , 0 , 0 ) , new [ ] { "Eye" } ) ; // off the beam: heard, never painted
var claimed = DataOf ( "Ear" ) ;
p . Claim ( SensorItemOf ( p ) , claimed ) ;
PingAt ( p ) ;
Assert . Same ( claimed , Assert . Single ( hearer . RevealsOf ( p ) ) . Claimed ) ;
}
// ---- AClaimEndsWithItsShip ----
[Fact]
public void AClaimEndsWithItsShip ( )
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" } ) ;
var gun = Guns ( e ) [ 0 ] ;
e . Claim ( new HullData { Name = "Decoy" } ) ;
e . Claim ( gun , DataOf ( "Eye" ) ) ;
e . Deactivate ( ) ;
Assert . Same ( e . HullData , e . ClaimedHull ) ;
Assert . Same ( gun . Data , e . ClaimOf ( gun ) ) ;
}
// ---- Rated figures (ruling ew-claim-weapon-measure-ruled) ----
2026-10-13 19:55:18 +02:00
// A hull's claim is its own item's claim: the hull's acts (a Reflector's reflection, a launch flash, the hull as the
// item of any signature) carry the class the profile reports, so the book never holds the true hull beside a decoy.
// Mutation: ClaimedHull reads a slot of its own, or Claim(HullData) writes one.
[Fact]
public void AHullClaimReachesTheHullsOwnReveal ( )
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" } ) ;
var o = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Eye" } ) ;
var decoy = new HullData { Name = "Decoy" } ;
e . Claim ( decoy ) ;
Assert . Same ( decoy , e . ClaimOf ( e . EquippedHull ) ) ;
Assert . Same ( decoy , e . ClaimedHull ) ;
2026-10-13 19:58:56 +02:00
e . SetSignature ( new object ( ) , SignatureChannel . LaunchFlash , 1000000f , e . EquippedHull ) ;
2026-10-13 19:55:18 +02:00
Tick ( . 1f ) ;
var reveal = Assert . Single ( o . RevealsOf ( e ) , r = > r . Item = = e . EquippedHull ) ;
Assert . Same ( decoy , reveal . Claimed ) ;
o . EntityInfoGathered [ e ] = . 8f ;
Assert . Same ( reveal . Claimed , o . ContactOf ( e ) . Profile ) ;
e . Claim ( null ) ;
Assert . Same ( e . HullData , e . ClaimedHull ) ;
Assert . Same ( e . HullData , e . ClaimOf ( e . EquippedHull ) ) ;
}
[Fact]
public void TheHullCanOnlyClaimToBeAHull ( )
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" } ) ;
Assert . Throws < System . ArgumentException > ( ( ) = > e . Claim ( e . EquippedHull , DataOf ( "Eye" ) ) ) ;
Assert . Same ( e . HullData , e . ClaimedHull ) ;
}
// ---- Rated figures (ruling ew-claim-weapon-measure-ruled) ----
2026-10-13 18:17:14 +02:00
// A design's rated figure is each stat's Max through the live weapon's own formula. Every stat is authored with
2026-10-13 19:55:18 +02:00
// Min below Max, a falling curve and a MinRange above 0, so reading a Min, scaling the range argument, the wrong
2026-10-14 02:16:04 +02:00
// stat or the wrong operator changes the answer. The spanned fixture falls from full damage at its effective range
// (60) to .2 at its range (120): at 90 the range factor is lerp(1, .2, (90 - 60) / (120 - 60)) = .6.
2026-10-13 19:55:18 +02:00
// Mutation: any rated override reads Range.Min or MinRange.Min or a Min, drops the burst divisor, the charge
// multiplier or the charge time; the shared formula scales its range argument.
2026-10-13 18:17:14 +02:00
[Fact]
public void ARatedFigureIsTheDesignsMaxThroughTheSharedFormula ( )
{
2026-10-14 02:16:04 +02:00
const float factor = . 6f ;
2026-10-13 19:55:18 +02:00
var instant = Spanned ( new InstantWeaponData ( ) ) ;
2026-10-14 02:16:04 +02:00
Assert . Equal ( 100f / 2 * factor / 2 , instant . RatedRangeDamagePerSecond ( 90f ) , 4 ) ; // 100 / 2 rounds, factor, / 2 s
2026-10-13 19:55:18 +02:00
Assert . Equal ( 120f , instant . RatedRange ) ;
2026-10-13 18:17:14 +02:00
2026-10-13 19:55:18 +02:00
var charged = ( ChargedWeaponData ) Spanned ( new ChargedWeaponData
2026-10-13 18:17:14 +02:00
{
2026-10-13 19:55:18 +02:00
ChargeTime = Span ( 1 , 3 ) , ChargeFiringDamageMultiplier = 2f
} ) ;
2026-10-14 02:16:04 +02:00
Assert . Equal ( 100f / 2 * 2 * factor / ( 2 + 3 ) , charged . RatedRangeDamagePerSecond ( 90f ) , 4 ) ;
2026-10-13 18:17:14 +02:00
2026-10-13 19:55:18 +02:00
var beam = Spanned ( new ConstantWeaponData ( ) ) ;
2026-10-14 02:16:04 +02:00
Assert . Equal ( 100f * factor , beam . RatedRangeDamagePerSecond ( 90f ) , 4 ) ;
2026-10-13 19:55:18 +02:00
Assert . Equal ( 120f , beam . RatedRange ) ;
2026-10-13 18:17:14 +02:00
}
2026-10-13 19:55:18 +02:00
// The rated read and the live read are one formula: a nominal weapon's live figure is its design's rated figure,
// for each kind, at ranges before, inside and past the falloff span, and equals the hand arithmetic.
// Mutation: a rated override with its own arithmetic, or a live read that drifts from the shared formula (the
// charged read's ChargeTime, the range, the curve).
2026-10-13 18:17:14 +02:00
[Fact]
public void ARatedFigureIsTheLiveFigureOfANominalWeapon ( )
{
2026-10-13 19:55:18 +02:00
var e = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "SpanGun" , "SpanCharged" , "SpanBeam" } ) ;
2026-10-13 18:17:14 +02:00
Tick ( . 1f ) ;
2026-10-14 02:16:04 +02:00
// The hand arithmetic of the fixture: 0 outside [20, 120], 1 up to 60, then a straight fall to .2 at 120.
Func < float , float > factor = at = > at < 20f | | at > 120f ? 0f : at < = 60f ? 1f : 1f - . 8f * ( at - 60f ) / 60f ;
2026-10-13 19:55:18 +02:00
var expected = new Dictionary < string , Func < float , float > >
{
2026-10-14 02:16:04 +02:00
["SpanGun"] = at = > 100f / 2 * factor ( at ) / 2 ,
["SpanCharged"] = at = > 100f / 2 * 2 * factor ( at ) / ( 2 + 3 ) ,
["SpanBeam"] = at = > 100f * factor ( at )
2026-10-13 19:55:18 +02:00
} ;
foreach ( var item in e . Equipment . Where ( i = > i . Behaviors . Any ( b = > b is Weapon ) ) )
2026-10-13 18:17:14 +02:00
{
var live = item . Behaviors . OfType < Weapon > ( ) . Single ( ) ;
var rated = item . Data . Behaviors . OfType < WeaponData > ( ) . Single ( ) ;
2026-10-14 02:16:04 +02:00
foreach ( var at in new [ ] { 10f , 40f , 90f , 500f } )
2026-10-13 19:55:18 +02:00
{
Assert . Equal ( expected [ item . Data . Name ] ( at ) , live . RangeDamagePerSecond ( at ) , 3 ) ;
Assert . Equal ( live . RangeDamagePerSecond ( at ) , rated . RatedRangeDamagePerSecond ( at ) , 3 ) ;
}
2026-10-13 18:17:14 +02:00
}
}
2026-10-13 21:19:53 +02:00
// A charged weapon at full charge reads the same rated figure: the charge multiplier is applied once, in the formula
// (UpdateStats lerps the shot's damage by charge, so the live reads start from the uncharged damage). At range 10 the
2026-10-14 02:16:04 +02:00
// range factor is 1: 100 / 2 rounds x 2 / (2 + 3) = 20. Mutation: the live reads pass the charge-lerped Damage.
2026-10-13 21:19:53 +02:00
[Fact]
public void AFullyChargedWeaponReadsItsRatedFigure ( )
{
var e = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "SpanCharged" } ) ;
Tick ( . 1f ) ;
var item = e . Equipment . Single ( i = > i . Data . Name = = "SpanCharged" ) ;
var live = ( ChargedWeapon ) item . Behaviors . Single ( b = > b is ChargedWeapon ) ;
var rated = item . Data . Behaviors . OfType < WeaponData > ( ) . Single ( ) ;
typeof ( ChargedWeapon ) . GetField ( "_charge" , BindingFlags . Instance | BindingFlags . NonPublic ) . SetValue ( live , 1f ) ;
typeof ( Weapon ) . GetMethod ( "UpdateStats" , BindingFlags . Instance | BindingFlags . NonPublic ) . Invoke ( live , null ) ;
2026-10-14 02:16:04 +02:00
foreach ( var at in new [ ] { 25f , 70f , 110f } )
2026-10-13 21:19:53 +02:00
Assert . Equal ( rated . RatedRangeDamagePerSecond ( at ) , live . RangeDamagePerSecond ( at ) , 3 ) ;
Assert . Equal ( 20f , live . DamagePerSecond , 3 ) ;
2026-10-14 02:16:04 +02:00
Assert . Equal ( 20f , live . RangeDamagePerSecond ( 25f ) , 3 ) ;
2026-10-13 21:19:53 +02:00
}
2026-10-13 20:21:15 +02:00
// ---- The schematic's rows (ruling ew-claim-weapon-measure-ruled; finding schematic-unreached) ----
2026-10-13 21:56:09 +02:00
// Wears a gun's Range to 95% (a shorter one is under the fuse arming distance and the gun is refused) so that, once it ticks, its live range (38) is not its design's rated range (40).
2026-10-13 21:19:53 +02:00
private void WearRange ( Entity ship , EquippedItem gun )
{
var data = ( InstantWeaponData ) gun . Data . Behaviors . Single ( b = > b is InstantWeaponData ) ;
2026-10-13 21:56:09 +02:00
ship . Resolver . AttachModifier ( gun , data . Range , "worn" , StatModifierType . Multiplier , . 95f ) ;
2026-10-13 21:19:53 +02:00
}
2026-10-13 21:37:23 +02:00
// The fixture's guard, read once the gun has ticked: its live range is not its design's rated range.
private static void AssertWorn ( EquippedItem gun ) = >
2026-10-13 21:56:09 +02:00
Assert . Equal ( 38f , gun . Behaviors . OfType < Weapon > ( ) . Single ( ) . Range , 2 ) ;
2026-10-13 21:37:23 +02:00
2026-10-13 21:19:53 +02:00
// The unclaimed enemy row is the true gun, with the gun's own rated range (Gun: 40) though the gun is worn to a live
2026-10-13 21:56:09 +02:00
// 38. Mutation: the row's Item.Data or the true live range stands in for the claim (also when Claimed == Data).
2026-10-13 20:21:15 +02:00
[Fact]
public void AnEnemySchematicRowDefaultsToTheTruth ( )
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" } ) ;
var o = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Eye" } ) ;
var gun = Guns ( e ) [ 0 ] ;
2026-10-13 21:19:53 +02:00
WearRange ( e , gun ) ;
2026-10-13 20:21:15 +02:00
Fire ( e , gun ) ;
2026-10-13 21:37:23 +02:00
AssertWorn ( gun ) ;
2026-10-13 20:21:15 +02:00
var row = Assert . Single ( o . SchematicRows ( e ) ) ;
Assert . Same ( gun , row . Item ) ;
Assert . Same ( gun . Data , row . Claimed ) ;
Assert . Equal ( 40f , row . Range ) ;
2026-10-13 21:19:53 +02:00
Assert . NotEqual ( gun . Behaviors . OfType < Weapon > ( ) . Single ( ) . Range , row . Range ) ;
2026-10-13 20:21:15 +02:00
}
// A weapon claimed as another weapon shows the claimed design's rated range (SpanGun: Range.Max 120), not the true
// gun's 40. Mutation: Range reads the true item, or the claimed stat's Min (50), or scales the figure.
[Fact]
public void AWeaponClaimedAsAnotherWeaponShowsTheClaimedRatedRange ( )
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" } ) ;
var o = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Eye" } ) ;
var gun = Guns ( e ) [ 0 ] ;
var other = DataOf ( "SpanGun" ) ;
e . Claim ( gun , other ) ;
Fire ( e , gun ) ;
var row = Assert . Single ( o . SchematicRows ( e ) ) ;
Assert . Same ( gun , row . Item ) ;
Assert . Same ( other , row . Claimed ) ;
Assert . Equal ( 120f , row . Range ) ;
}
2026-10-14 21:37:32 +02:00
// A gun claimed as a sensor is no weapon row: the observer believes it is a sensor, and lists it as gear of that class,
// with no range. Mutation: the rows are the book's reveals (RevealsOf) or the subject's equipment (the true class shows).
2026-10-13 20:21:15 +02:00
[Fact]
2026-10-14 21:37:32 +02:00
public void AWeaponClaimedAsANonWeaponIsAGearRowOfTheClaimedClass ( )
2026-10-13 20:21:15 +02:00
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" } ) ;
var o = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Eye" } ) ;
var gun = Guns ( e ) [ 0 ] ;
e . Claim ( gun , DataOf ( "Eye" ) ) ;
Fire ( e , gun ) ;
2026-10-14 21:37:32 +02:00
Assert . Empty ( o . RevealedWeapons ( e ) ) ;
var row = Assert . Single ( o . SchematicRows ( e ) ) ;
Assert . Same ( gun , row . Item ) ;
Assert . Same ( DataOf ( "Eye" ) , row . Claimed ) ;
Assert . Null ( row . Range ) ;
2026-10-13 20:21:15 +02:00
}
// Unrevealed gear never appears on an enemy schematic: a ship that has not fired shows no row.
[Fact]
public void AnArmedShipThatNeverFiredHasNoEnemySchematicRow ( )
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" } ) ;
var o = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Eye" } ) ;
Tick ( . 1f ) ;
Assert . Empty ( o . SchematicRows ( e ) ) ;
}
// Your own schematic is your own gear whatever you claim: the true data, the live range, weapons only.
2026-10-13 21:19:53 +02:00
// Mutation: own rows read ClaimOf, the rated range of the claim (SpanGun 120) or of the own design (40), or list non-weapons.
2026-10-13 20:21:15 +02:00
[Fact]
public void OwnSchematicRowsShowOwnTruth ( )
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" } ) ;
var gun = Guns ( e ) [ 0 ] ;
2026-10-13 21:19:53 +02:00
WearRange ( e , gun ) ;
2026-10-13 20:21:15 +02:00
e . Claim ( gun , DataOf ( "SpanGun" ) ) ;
2026-10-13 21:37:23 +02:00
Tick ( . 1f ) ;
AssertWorn ( gun ) ;
2026-10-13 20:21:15 +02:00
var row = Assert . Single ( e . SchematicRows ( e ) ) ;
Assert . Same ( gun , row . Item ) ;
Assert . Same ( gun . Data , row . Claimed ) ;
2026-10-14 21:20:25 +02:00
Assert . Equal ( 38f , row . Range . Value , 2 ) ; // the live range of the worn gun, below its rated 40
2026-10-13 20:21:15 +02:00
Assert . Equal ( gun . Behaviors . OfType < Weapon > ( ) . Single ( ) . Range , row . Range ) ;
2026-10-13 21:19:53 +02:00
Assert . NotEqual ( ( ( WeaponData ) gun . Data . Behaviors . Single ( b = > b is WeaponData ) ) . RatedRange , row . Range ) ;
2026-10-13 20:21:15 +02:00
}
// The renderer rebuilds when the key differs: a claim that changes between two acts changes the key, and an
// unchanged claim does not. Mutation: Key drops Claimed.
[Fact]
public void TheRebuildKeyChangesWhenAClaimChanges ( )
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" } ) ;
var o = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Eye" } ) ;
var gun = Guns ( e ) [ 0 ] ;
Fire ( e , gun ) ;
var before = o . SchematicRows ( e ) . Select ( r = > r . Key ) . ToArray ( ) ;
Assert . Equal ( before , o . SchematicRows ( e ) . Select ( r = > r . Key ) . ToArray ( ) ) ;
e . Claim ( gun , DataOf ( "SpanGun" ) ) ;
e . SetSignature ( new object ( ) , SignatureChannel . LaunchFlash , 1000000f , gun ) ;
Tick ( . 1f ) ;
var after = o . SchematicRows ( e ) . Select ( r = > r . Key ) . ToArray ( ) ;
Assert . Single ( after ) ;
Assert . NotEqual ( before , after ) ;
Assert . Same ( DataOf ( "SpanGun" ) , after [ 0 ] . Item2 ) ;
}
2026-10-13 21:19:53 +02:00
// Two guns of one claimed design are told apart by the key: a row set that swaps one gun for the other keeps the count and
// the claims and changes only the item, and the renderer must still rebuild (the selection mark follows the item).
// Mutation: Key drops Item.
[Fact]
public void TheRebuildKeyChangesWhenOnlyTheItemChanges ( )
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" , "Gun" } ) ;
var a = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Eye" } ) ;
var b = Add ( float3 ( 0 , 0 , 5 ) , new [ ] { "Eye" } ) ;
var guns = Guns ( e ) ;
var design = DataOf ( "SpanGun" ) ;
e . Claim ( guns [ 0 ] , design ) ;
e . Claim ( guns [ 1 ] , design ) ;
a . RecordReveal ( e , guns [ 0 ] , SignatureChannel . LaunchFlash , e . ClaimOf ( guns [ 0 ] ) ) ;
b . RecordReveal ( e , guns [ 1 ] , SignatureChannel . LaunchFlash , e . ClaimOf ( guns [ 1 ] ) ) ;
var first = Assert . Single ( a . SchematicRows ( e ) ) ;
var second = Assert . Single ( b . SchematicRows ( e ) ) ;
Assert . Same ( first . Claimed , second . Claimed ) ;
Assert . NotEqual ( first . Key , second . Key ) ;
}
// ---- One hull class in the book ----
// The guard runs both ways: a hull class can be claimed only by the hull, so no item's reveal carries a hull class that
// disagrees with Contact.Profile. Mutation: the guard checks the hull side only.
[Fact]
public void OnlyTheHullClaimsAHullClass ( )
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" } ) ;
var gun = Guns ( e ) [ 0 ] ;
Assert . Throws < System . ArgumentException > ( ( ) = > e . Claim ( gun , e . HullData ) ) ;
Assert . Same ( gun . Data , e . ClaimOf ( gun ) ) ;
}
// ---- Gear the subject no longer carries ----
// A reveal of gear the subject does not carry follows every fitted weapon, and stale gear is ordered by lot whatever
// order the observer saw it in. Mutation: the missing index sorts first (-1), or stale ties follow the book's slot order.
[Fact]
public void RevealsOfGearNoLongerCarriedFollowFittedGear ( )
{
var e = Add ( float3 ( 30 , 0 , 40 ) , new [ ] { "Gun" } ) ;
var gone = Add ( float3 ( 60 , 0 , 40 ) , new [ ] { "Gun" , "Gun" } ) ;
var o = Add ( float3 ( 0 , 0 , 0 ) , new [ ] { "Eye" } ) ;
var fitted = Guns ( e ) [ 0 ] ;
var stale = Guns ( gone ) ;
Assert . True ( stale [ 0 ] . EquippableItem . Lot < stale [ 1 ] . EquippableItem . Lot ) ;
o . RecordReveal ( e , stale [ 1 ] , SignatureChannel . LaunchFlash , stale [ 1 ] . Data ) ;
o . RecordReveal ( e , stale [ 0 ] , SignatureChannel . LaunchFlash , stale [ 0 ] . Data ) ;
o . RecordReveal ( e , fitted , SignatureChannel . LaunchFlash , fitted . Data ) ;
Assert . Equal ( new [ ] { fitted , stale [ 0 ] , stale [ 1 ] } , o . RevealedWeapons ( e ) . Select ( r = > r . Item ) . ToArray ( ) ) ;
}
2026-10-13 18:17:14 +02:00
}