@luceosports/play-rendering 2.7.0 → 2.8.0

package/dist/types/models/PlayerModel.d.ts

@@ -9,6 +9,8 @@ export class PlayerModel {
     get isDefender(): boolean;
     get possession(): boolean;
     set possession(data: boolean);
+    get startBallsCount();
+    set startBallsCount(data: number);
     get position(): Position;
     get location(): CourtPoint;
     get color(): Color;

package/dist/types/types/index.d.ts

@@ -62,6 +62,7 @@ export interface Court {
 export interface Player {
     id: string;
     possession: boolean;
+    startBallsCount?: number;
     color: Color;
     position: Position;
     location: CourtPoint;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luceosports/play-rendering",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "main": "dist/play-rendering.js",
   "types": "dist/play-rendering.d.ts",
   "scripts": {

package/src/models/PlayerModel.ts

@@ -30,6 +30,19 @@ export default class PlayerModel extends Model<PlayerData, PlayerData> {
     this._setAttr('possession', data);
   }
 
+  get startBallsCount() {
+    const raw = this._getAttr('startBallsCount');
+    if (typeof raw === 'number') return raw;
+
+    // Backward-compatible fallback:
+    // legacy model encoded "starts with 1 ball" as possession=true.
+    return this.possession ? 1 : 0;
+  }
+
+  set startBallsCount(data) {
+    this._setAttr('startBallsCount', data);
+  }
+
   get position() {
     return this._getAttr('position');
   }
@@ -47,10 +60,12 @@ export default class PlayerModel extends Model<PlayerData, PlayerData> {
   }
 
   setPossession(prevPassLines: Line[]) {
-    if (!prevPassLines.length) return;
-    let possessionCount = this.possession ? 1 : 0;
-    possessionCount += prevPassLines.filter(l => l.playerPositionTerminus === this.position).length;
-    possessionCount -= prevPassLines.filter(l => l.playerPositionOrigin === this.position).length;
-    this.possession = possessionCount > 0;
+    // Support multiple balls: start from startBallsCount, then apply transfers.
+    let ballsCount = this.startBallsCount;
+
+    ballsCount += prevPassLines.filter(l => l.playerPositionTerminus === this.position).length;
+    ballsCount -= prevPassLines.filter(l => l.playerPositionOrigin === this.position).length;
+
+    this.possession = ballsCount > 0;
   }
 }

package/src/types/index.ts

@@ -136,6 +136,11 @@ export interface Court {
 export interface Player {
   id: string;
   possession: boolean;
+  /**
+   * How many balls the player starts with before applying PASS/HANDOFF/SHOT transfers.
+   * If omitted, legacy data falls back to `possession ? 1 : 0`.
+   */
+  startBallsCount?: number;
   color: Color;
   position: Position;
   location: CourtPoint;