feat: add highlight_reel (Sticker field 11), make paintwear nullable, add csfloat test vectors

Author: vlydev

cs2_inspect/inspect_link.py

@@ -106,7 +106,7 @@ def serialize(data: ItemPreviewData) -> str:
     Returns:
         Uppercase hex string, e.g. "00183C20B803..."
     """
-    if data.paintwear < 0.0 or data.paintwear > 1.0:
+    if data.paintwear is not None and (data.paintwear < 0.0 or data.paintwear > 1.0):
         raise ValueError(
             f"paintwear must be in [0.0, 1.0], got {data.paintwear}"
         )

cs2_inspect/models.py

@@ -24,6 +24,7 @@ class Sticker:
     offset_y: Optional[float] = None
     offset_z: Optional[float] = None
     pattern: int = 0
+    highlight_reel: Optional[int] = None
 
 
 @dataclass
@@ -43,7 +44,7 @@ class ItemPreviewData:
     paintindex: int = 0
     rarity: int = 0
     quality: int = 0
-    paintwear: float = 0.0
+    paintwear: Optional[float] = None
     paintseed: int = 0
     killeaterscoretype: int = 0
     killeatervalue: int = 0

cs2_inspect/proto.py

@@ -211,6 +211,8 @@ def encode_sticker(s: "Sticker") -> bytes:  # noqa: F821  (forward ref ok)
     if s.offset_z is not None:
         w.write_float32_fixed(9, s.offset_z)
     w.write_uint32(10, s.pattern)
+    if s.highlight_reel is not None:
+        w.write_uint32(11, s.highlight_reel)
     return w.to_bytes()
 
 
@@ -239,6 +241,8 @@ def decode_sticker(data: bytes) -> "Sticker":  # noqa: F821
             s.offset_z = struct.unpack("<f", value)[0]
         elif field_num == 10:
             s.pattern = value
+        elif field_num == 11:
+            s.highlight_reel = value
     return s
 
 
@@ -252,8 +256,9 @@ def encode_item(item: "ItemPreviewData") -> bytes:  # noqa: F821
     w.write_uint32(5, item.rarity)
     w.write_uint32(6, item.quality)
     # paintwear: float32 reinterpreted as uint32 varint
-    pw_uint32 = float32_to_uint32(item.paintwear)
-    w.write_uint32(7, pw_uint32)
+    if item.paintwear is not None:
+        pw_uint32 = float32_to_uint32(item.paintwear)
+        w.write_uint32(7, pw_uint32)
     w.write_uint32(8, item.paintseed)
     w.write_uint32(9, item.killeaterscoretype)
     w.write_uint32(10, item.killeatervalue)

tests/test_inspect_link.py

@@ -337,3 +337,74 @@ def test_serialize_customname_100_chars_is_valid(self):
         data = ItemPreviewData(defindex=7, customname="x" * 100)
         result = serialize(data)
         assert result.startswith("00")
+
+
+# -------------------------------------------------------------------------
+# CSFloat / gen.test.ts test vectors
+# -------------------------------------------------------------------------
+
+CSFLOAT_A = "00180720DA03280638FBEE88F90340B2026BC03C96"
+CSFLOAT_B = "00180720C80A280638A4E1F5FB03409A0562040800104C62040801104C62040802104C62040803104C6D4F5E30"
+CSFLOAT_C = "A2B2A2BA69A882A28AA192AECAA2D2B700A3A5AAA2B286FA7BA0D684BE72"
+
+
+class TestCsfloatVectors:
+    def test_vector_a_defindex(self):
+        assert deserialize(CSFLOAT_A).defindex == 7
+
+    def test_vector_a_paintindex(self):
+        assert deserialize(CSFLOAT_A).paintindex == 474
+
+    def test_vector_a_paintseed(self):
+        assert deserialize(CSFLOAT_A).paintseed == 306
+
+    def test_vector_a_rarity(self):
+        assert deserialize(CSFLOAT_A).rarity == 6
+
+    def test_vector_a_paintwear_not_none(self):
+        assert deserialize(CSFLOAT_A).paintwear is not None
+
+    def test_vector_a_paintwear(self):
+        assert abs(deserialize(CSFLOAT_A).paintwear - 0.6337) < 0.001
+
+    def test_vector_b_sticker_count(self):
+        assert len(deserialize(CSFLOAT_B).stickers) == 4
+
+    def test_vector_b_sticker_ids(self):
+        for s in deserialize(CSFLOAT_B).stickers:
+            assert s.sticker_id == 76
+
+    def test_vector_b_paintindex(self):
+        assert deserialize(CSFLOAT_B).paintindex == 1352
+
+    def test_vector_b_paintwear(self):
+        assert abs(deserialize(CSFLOAT_B).paintwear - 0.99) < 0.01
+
+    def test_vector_c_defindex(self):
+        assert deserialize(CSFLOAT_C).defindex == 1355
+
+    def test_vector_c_quality(self):
+        assert deserialize(CSFLOAT_C).quality == 12
+
+    def test_vector_c_keychain_count(self):
+        assert len(deserialize(CSFLOAT_C).keychains) == 1
+
+    def test_vector_c_keychain_highlight_reel(self):
+        assert deserialize(CSFLOAT_C).keychains[0].highlight_reel == 345
+
+    def test_vector_c_no_paintwear(self):
+        assert deserialize(CSFLOAT_C).paintwear is None
+
+
+class TestRoundtripNewFeatures:
+    def test_highlight_reel_roundtrip(self):
+        from cs2_inspect.models import Sticker as StickerModel
+        data = ItemPreviewData(defindex=7, keychains=[StickerModel(slot=0, sticker_id=36, highlight_reel=345)])
+        result = deserialize(serialize(data))
+        assert len(result.keychains) == 1
+        assert result.keychains[0].highlight_reel == 345
+
+    def test_null_paintwear_roundtrip(self):
+        data = ItemPreviewData(defindex=7, paintwear=None)
+        result = deserialize(serialize(data))
+        assert result.paintwear is None